feat(clipboard): add clipboard widget with validation schema

- Add clipboard widget integrating with Windows Clipboard History
- Add pydantic validation schema for clipboard configuration
- Support text and image clipboard history with search
- Add popup menu with blur, rounded corners, and customization
- Add documentation for widget options and styling

Author: stylebending

docs/widgets/(Widget)-Clipboard.md

@@ -2,44 +2,57 @@
 
 A lightweight clipboard manager for YASB that integrates directly with the native Windows Clipboard History (Win + V). This widget provides real-time access to your system's clip buffer without the need for heavy local storage or complex background monitoring.
 
-**Note for Users:** This widget requires the following Python packages to interact with Windows APIs:
-`pip install winrt-Windows.ApplicationModel.DataTransfer winrt-Windows.Foundation`
-
 ## Features
 - **Native Windows Sync**: Syncs in real-time with your official Windows Clipboard History.
 - **Search**: Built-in real-time search bar to filter through your text-based history.
 - **History**: View your Clipboard history and delete a single history item or your entire history.
 - **Image Support**: Full support for previewing and re-copying images directly from the history list.
 - **Long text preview**: Hover over a copied long piece of text to display complete text preview.
+- **Feedback**: Visual feedback when content is copied.
 
 ## Options
 
 | Option | Type | Default | Description |
 | :--- | :--- | :--- | :--- |
 | `type` | `string` | `yasb.clipboard.ClipboardWidget` | The widget class identifier. |
-| `label` | `string` | `<span>\udb80\udd4d</span> {clipboard}` | Primary label format. Supports `{clipboard}` token. |
-| `label_alt` | `string` | `{clipboard}` | Alternative label format (swapped on right-click). |
-| `max_length` | `integer` | `30` | Max characters to display in the bar before truncation. |
+| `label` | `string` | `<span>\udb80\udd4d</span>` | Primary label format. |
+| `label_alt` | `string` | `CLIPBOARD` | Alternative label format (swapped on right-click). |
 | `max_history` | `integer` | `50` | Maximum number of history items to fetch from Windows. |
 | `class_name` | `string` | `""` | Additional CSS class for the widget container. |
-| `menu` | `dict` | (See Schema) | Configuration for the popup menu (blur, corners, alignment). |
-| `icons` | `dict` | (See Schema) | Custom icons for clipboard, clear, and search. |
+| `copied_feedback` | `string` | `\uf00c` | Feedback message when copying. |
+| `menu` | `dict` | (See Schema) | Configuration for the popup menu. |
+| `icons` | `dict` | (See Schema) | Custom icons for clipboard actions. |
+| `animation` | `dict` | (See Schema) | Animation configuration for label toggling. |
+| `label_shadow` | `dict` | (See Schema) | Shadow configuration for the label. |
+| `container_shadow` | `dict` | (See Schema) | Shadow configuration for the widget container. |
 
 ## Icons Configuration Defaults
 
 | Key | Default | Description |
 | :--- | :--- | :--- |
-| `clipboard` | `\udb80\udd4d` | Main widget icon used on the bar and in the "Copied!" flash. |
-| `clear` | `\uf1f8` | Global clear icon (Clears the system's unpinned history). |
-| `search_clear` | `\uf00d` | Icon used for general UI elements. |
+| `clear_icon` | `\uf1f8` | Clear all history icon. |
+| `delete_icon` | `\uf1f8` | Delete item icon. |
+
+## Menu Configuration Defaults
+
+| Key | Default | Description |
+| :--- | :--- | :--- |
+| `blur` | `true` | Enable blur effect on popup. |
+| `round_corners` | `true` | Enable rounded corners on popup. |
+| `round_corners_type` | `"normal"` | Corner radius style (`"normal"` or `"small"`). |
+| `border_color` | `"System"` | Border color for the popup. |
+| `alignment` | `"right"` | Horizontal alignment relative to widget (`"left"`, `"right"`, `"center"`). |
+| `direction` | `"down"` | Vertical direction for popup (`"up"` or `"down"`). |
+| `offset_top` | `6` | Top offset in pixels. |
+| `offset_left` | `0` | Left offset in pixels. |
+| `max_item_length` | `50` | Max characters to display for text items (10-200). |
 
 ## Callbacks
 
 | Function | Description |
 | :--- | :--- |
 | `toggle_menu` | Opens/closes the clipboard history popup (Scheduled asynchronously). |
 | `toggle_label` | Switches display between `label` and `label_alt` on the bar. |
-| `do_nothing` | No action. |
 
 ---
 
@@ -50,17 +63,19 @@ A lightweight clipboard manager for YASB that integrates directly with the nativ
   clipboard:
     type: "yasb.clipboard.ClipboardWidget"
     options:
-      label: "<span>\udb80\udd4d</span> {clipboard}"
-      label_alt: "<span>CLIPBOARD:</span> {clipboard}"
-      max_length: 25
+      label: "<span>\uf0ea</span>"
+      label_alt: "<span>CLIPBOARD</span>"
+      icons:
+        delete_icon: "\uf1f8"
+        clear_icon: "\uf1f8"
+      copied_feedback: "\uf00c"
       menu:
         blur: false
         round_corners: false
         alignment: "right"
         direction: "down"
       callbacks:
         on_left: "toggle_menu"
-        on_middle: "do_nothing"
         on_right: "toggle_label"
 ```
 
@@ -69,19 +84,19 @@ A lightweight clipboard manager for YASB that integrates directly with the nativ
 ### Example CSS
 
 ```css
+/* Widget on the bar */
 .clipboard-widget {
     font-family: "JetBrainsMono Nerd Font", "Segoe UI Variable";
 }
-/* Widget on the bar */
+
 .clipboard-widget .label {
-    padding: 0 6px;
-    color: var(--mauve);
+    color: #89b4fa;
 }
 
 /* Main Popup Container */
 .clipboard-menu {
-    background-color: var(--bg-color1);
-    border: 1px solid var(--bg-color2);
+    background-color: #1e1e2e;
+    border: 1px solid #11111b;
     border-radius: 10px;
     padding: 8px;
 }
@@ -93,18 +108,18 @@ A lightweight clipboard manager for YASB that integrates directly with the nativ
     border-radius: 6px;
     padding: 6px 10px;
     margin-bottom: 6px;
-    color: var(--text1);
+    color: #cdd6f4;
     font-size: 13px;
 }
 
 .clipboard-menu .search-input:focus {
-    border: 1px solid var(--blue);
+    border: 1px solid #89b4fa;
 }
 
 /* Global Clear Button */
 .clipboard-menu .clear-button {
     background-color: rgba(243, 139, 168, 0.1);
-    color: var(--red);
+    color: #f38ba8;
     border-radius: 6px;
     padding: 5px;
     margin-bottom: 8px;
@@ -116,48 +131,28 @@ A lightweight clipboard manager for YASB that integrates directly with the nativ
     background-color: rgba(243, 139, 168, 0.2);
 }
 
-/* Scroll Area Styling */
-.clipboard-menu .scroll-area {
-    background: transparent;
-    border: none;
-}
-
-/* Individual Clipboard Items (Buttons) */
+/* Clipboard Items */
 .clipboard-menu .clipboard-item {
     background-color: rgba(255, 255, 255, 0.03);
     border: 1px solid transparent;
     border-radius: 5px;
     padding: 8px;
     margin-bottom: 4px;
     text-align: left;
-    color: var(--text1);
+    color: #cdd6f4;
     font-size: 12px;
 }
 
 .clipboard-menu .clipboard-item:hover {
     background-color: rgba(255, 255, 255, 0.08);
-    border: 1px solid var(--bg-color2);
-}
-
-/* Image Item Specifics (if needed) */
-.clipboard-menu .clipboard-item [icon] {
-    margin-right: 8px;
-}
-
-/* Scrollbar Styling (Optional but looks better) */
-QScrollBar:vertical {
-    border: none;
-    background: transparent;
-    width: 4px;
+    border: 1px solid #11111b;
 }
 
-QScrollBar::handle:vertical {
-    background: var(--bg-color2);
-    border-radius: 2px;
+/* Delete Button */
+.clipboard-menu .delete-button {
+    background: rgba(243, 139, 168, 0.1);
 }
-
-/* Styling for the temporary 'Copied!' flash */
-.clipboard-widget .label {
-    transition: all 0.2s ease-in-out;
+.clipboard-menu .delete-button:hover {
+    background-color: rgba(243, 139, 168, 0.2);
 }
 ```

src/core/validation/widgets/yasb/clipboard.py

@@ -1,95 +1,56 @@
-DEFAULTS = {
-    "label": "<span>\udb80\udd4d</span> {clipboard}",
-    "label_alt": "{clipboard}",
-    "class_name": "",
-    "max_length": 30,
-    "max_history": 50,
-    "container_padding": {"top": 0, "left": 0, "bottom": 0, "right": 0},
-    "animation": {"enabled": True, "type": "fadeInOut", "duration": 200},
-    "menu": {
-        "blur": True,
-        "round_corners": True,
-        "round_corners_type": "normal",
-        "border_color": "System",
-        "alignment": "right",
-        "direction": "down",
-        "offset_top": 6,
-        "offset_left": 0,
-        "max_item_length": 50,
-    },
-    "icons": {
-        "clipboard": "\udb80\udd4d",
-        "clear": "\uf1f8",
-        "search_clear": "\uf00d",
-    },
-    "callbacks": {"on_left": "toggle_menu", "on_middle": "do_nothing", "on_right": "toggle_label"},
-}
+from typing import Literal
 
-VALIDATION_SCHEMA = {
-    "label": {"type": "string", "default": DEFAULTS["label"]},
-    "label_alt": {"type": "string", "default": DEFAULTS["label_alt"]},
-    "class_name": {"type": "string", "required": False, "default": DEFAULTS["class_name"]},
-    "max_length": {"type": "integer", "required": False, "default": DEFAULTS["max_length"], "min": 5, "max": 100},
-    "max_history": {"type": "integer", "required": False, "default": DEFAULTS["max_history"], "min": 10, "max": 500},
-    "container_padding": {
-        "type": "dict",
-        "required": False,
-        "schema": {
-            "top": {"type": "integer", "default": DEFAULTS["container_padding"]["top"]},
-            "left": {"type": "integer", "default": DEFAULTS["container_padding"]["left"]},
-            "bottom": {"type": "integer", "default": DEFAULTS["container_padding"]["bottom"]},
-            "right": {"type": "integer", "default": DEFAULTS["container_padding"]["right"]},
-        },
-        "default": DEFAULTS["container_padding"],
-    },
-    "animation": {
-        "type": "dict",
-        "required": False,
-        "schema": {
-            "enabled": {"type": "boolean", "default": DEFAULTS["animation"]["enabled"]},
-            "type": {"type": "string", "default": DEFAULTS["animation"]["type"]},
-            "duration": {"type": "integer", "default": DEFAULTS["animation"]["duration"]},
-        },
-        "default": DEFAULTS["animation"],
-    },
-    "menu": {
-        "type": "dict",
-        "required": False,
-        "schema": {
-            "blur": {"type": "boolean", "default": DEFAULTS["menu"]["blur"]},
-            "round_corners": {"type": "boolean", "default": DEFAULTS["menu"]["round_corners"]},
-            "round_corners_type": {
-                "type": "string",
-                "default": DEFAULTS["menu"]["round_corners_type"],
-                "allowed": ["normal", "small"],
-            },
-            "border_color": {"type": "string", "default": DEFAULTS["menu"]["border_color"]},
-            "alignment": {"type": "string", "default": DEFAULTS["menu"]["alignment"]},
-            "direction": {"type": "string", "default": DEFAULTS["menu"]["direction"]},
-            "offset_top": {"type": "integer", "default": DEFAULTS["menu"]["offset_top"]},
-            "offset_left": {"type": "integer", "default": DEFAULTS["menu"]["offset_left"]},
-            "max_item_length": {"type": "integer", "default": DEFAULTS["menu"]["max_item_length"]},
-        },
-        "default": DEFAULTS["menu"],
-    },
-    "icons": {
-        "type": "dict",
-        "required": False,
-        "schema": {
-            "clipboard": {"type": "string", "default": DEFAULTS["icons"]["clipboard"]},
-            "clear": {"type": "string", "default": DEFAULTS["icons"]["clear"]},
-            "search_clear": {"type": "string", "default": DEFAULTS["icons"]["search_clear"]},
-        },
-        "default": DEFAULTS["icons"],
-    },
-    "callbacks": {
-        "type": "dict",
-        "required": False,
-        "schema": {
-            "on_left": {"type": "string", "default": DEFAULTS["callbacks"]["on_left"]},
-            "on_middle": {"type": "string", "default": DEFAULTS["callbacks"]["on_middle"]},
-            "on_right": {"type": "string", "default": DEFAULTS["callbacks"]["on_right"]},
-        },
-        "default": DEFAULTS["callbacks"],
-    },
-}
+from pydantic import Field
+
+from core.validation.widgets.base_model import (
+    AnimationConfig,
+    CallbacksConfig,
+    CustomBaseModel,
+    KeybindingConfig,
+    ShadowConfig,
+)
+
+
+class ClipboardMenuConfig(CustomBaseModel):
+    """Configuration for the clipboard popup menu."""
+
+    blur: bool = True
+    round_corners: bool = True
+    round_corners_type: Literal["normal", "small"] = "normal"
+    border_color: str = "System"
+    alignment: Literal["left", "right", "center"] = "right"
+    direction: Literal["up", "down"] = "down"
+    offset_top: int = 6
+    offset_left: int = 0
+    max_item_length: int = Field(default=50, ge=10, le=200)
+
+
+class ClipboardIconsConfig(CustomBaseModel):
+    """Configuration for clipboard widget icons."""
+
+    clear_icon: str = "\uf1f8"
+    delete_icon: str = "\uf1f8"
+
+
+class ClipboardCallbacksConfig(CallbacksConfig):
+    """Callbacks configuration with clipboard-specific defaults."""
+
+    on_left: str = "toggle_menu"
+    on_right: str = "toggle_label"
+
+
+class ClipboardConfig(CustomBaseModel):
+    """Main configuration model for the Clipboard widget."""
+
+    label: str = "<span>\udb80\udd4d</span>"
+    label_alt: str = "CLIPBOARD"
+    class_name: str = ""
+    copied_feedback: str = "\uf00c"
+    max_history: int = Field(default=50, ge=10, le=500)
+    menu: ClipboardMenuConfig = ClipboardMenuConfig()
+    icons: ClipboardIconsConfig = ClipboardIconsConfig()
+    animation: AnimationConfig = AnimationConfig()
+    label_shadow: ShadowConfig = ShadowConfig()
+    container_shadow: ShadowConfig = ShadowConfig()
+    keybindings: list[KeybindingConfig] = []
+    callbacks: ClipboardCallbacksConfig = ClipboardCallbacksConfig()