@vielzeug/codex 2.3.0 → 2.3.1

package/data/refine.json

@@ -4,24 +4,6 @@
     "description": "Base class for all refine errors. Use `instanceof RefineError` to catch any refine-originated error.",
     "name": "RefineError",
     "members": [
-      {
-        "kind": "method",
-        "name": "is",
-        "static": true,
-        "return": {
-          "type": {
-            "text": "err is RefineError"
-          }
-        },
-        "parameters": [
-          {
-            "name": "err",
-            "type": {
-              "text": "unknown"
-            }
-          }
-        ]
-      },
       {
         "kind": "field",
         "name": "name"
@@ -41,28 +23,6 @@
       "module": "src/errors.ts"
     },
     "members": [
-      {
-        "kind": "method",
-        "name": "is",
-        "static": true,
-        "return": {
-          "type": {
-            "text": "err is RefineError"
-          }
-        },
-        "parameters": [
-          {
-            "name": "err",
-            "type": {
-              "text": "unknown"
-            }
-          }
-        ],
-        "inheritedFrom": {
-          "name": "RefineError",
-          "module": "src/errors.ts"
-        }
-      },
       {
         "kind": "field",
         "name": "name",
@@ -932,133 +892,6 @@
     "default": "{ lg: { '--_min-height': 'var(--size-40)', fontSize: 'var(--text-base)', }, md: { '--_min-height': 'var(--size-32)', fontSize: 'var(--text-sm)', }, sm: { '--_min-height': 'var(--size-28)', fontSize: 'var(--text-xs)', }, } satisfies FullSizePreset",
     "description": "Shared size preset for the file-input dropzone."
   },
-  {
-    "kind": "variable",
-    "name": "BREADCRUMB_ITEM_TAG",
-    "type": {
-      "text": "'ore-breadcrumb-item'"
-    },
-    "default": "'ore-breadcrumb-item'",
-    "description": "A single breadcrumb entry rendered inside `<ore-breadcrumb>`."
-  },
-  {
-    "kind": "class",
-    "name": "OreBreadcrumbItemElement",
-    "tagName": "ore-breadcrumb-item",
-    "customElement": true,
-    "description": "A single breadcrumb entry rendered inside `<ore-breadcrumb>`.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "active",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Marks this item as the current page (`aria-current=\"page\"`)"
-      },
-      {
-        "name": "href",
-        "type": {
-          "text": "string"
-        },
-        "description": "Link target for this breadcrumb item"
-      },
-      {
-        "name": "separator",
-        "type": {
-          "text": "string"
-        },
-        "description": "Separator text shown before the item (except first item)"
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Item label/content"
-      },
-      {
-        "name": "icon",
-        "description": "Optional leading icon for the crumb"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "separator",
-        "description": "Separator element before the item label"
-      },
-      {
-        "name": "link",
-        "description": "The interactive anchor element"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-breadcrumb-item href=\"/\">Home</ore-breadcrumb-item>\n<ore-breadcrumb-item active>Current Page</ore-breadcrumb-item>\n```"
-      }
-    ]
-  },
-  {
-    "kind": "variable",
-    "name": "BREADCRUMB_TAG",
-    "type": {
-      "text": "'ore-breadcrumb'"
-    },
-    "default": "'ore-breadcrumb'",
-    "description": "Accessible breadcrumb navigation container."
-  },
-  {
-    "kind": "class",
-    "name": "OreBreadcrumbElement",
-    "tagName": "ore-breadcrumb",
-    "customElement": true,
-    "description": "Accessible breadcrumb navigation container.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "label",
-        "type": {
-          "text": "string"
-        },
-        "description": "Accessible label for the internal `<nav>` landmark"
-      },
-      {
-        "name": "separator",
-        "type": {
-          "text": "string"
-        },
-        "description": "Separator text propagated to child `<ore-breadcrumb-item>` elements"
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "One or more `<ore-breadcrumb-item>` children"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "nav",
-        "description": "Internal navigation landmark element"
-      },
-      {
-        "name": "list",
-        "description": "Internal ordered list container"
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--breadcrumb-separator",
-        "description": "Optional custom separator text synced to child items"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-breadcrumb label=\"Page breadcrumb\">\n  <ore-breadcrumb-item href=\"/\">Home</ore-breadcrumb-item>\n  <ore-breadcrumb-item href=\"/blog\">Blog</ore-breadcrumb-item>\n  <ore-breadcrumb-item active>My Post</ore-breadcrumb-item>\n</ore-breadcrumb>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "AVATAR_GROUP_TAG",
@@ -1251,183 +1084,128 @@
   },
   {
     "kind": "variable",
-    "name": "CAROUSEL_SLIDE_TAG",
-    "type": {
-      "text": "'ore-carousel-slide'"
-    },
-    "default": "'ore-carousel-slide'"
-  },
-  {
-    "kind": "variable",
-    "name": "CAROUSEL_TAG",
+    "name": "BREADCRUMB_ITEM_TAG",
     "type": {
-      "text": "'ore-carousel'"
+      "text": "'ore-breadcrumb-item'"
     },
-    "default": "'ore-carousel'",
-    "description": "An accessible, keyboard-navigable carousel / slideshow with optional\nautoplay, swipe support, and indicator dots.\n\nPlace `<ore-carousel-slide>` elements as direct children."
+    "default": "'ore-breadcrumb-item'",
+    "description": "A single breadcrumb entry rendered inside `<ore-breadcrumb>`."
   },
   {
     "kind": "class",
-    "name": "OreCarouselElement",
-    "tagName": "ore-carousel",
+    "name": "OreBreadcrumbItemElement",
+    "tagName": "ore-breadcrumb-item",
     "customElement": true,
-    "description": "An accessible, keyboard-navigable carousel / slideshow with optional\nautoplay, swipe support, and indicator dots.\nPlace `<ore-carousel-slide>` elements as direct children.",
+    "description": "A single breadcrumb entry rendered inside `<ore-breadcrumb>`.",
     "summary": "",
     "attributes": [
       {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-        },
-        "description": "Theme color for navigation buttons: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-      },
-      {
-        "name": "autoplay",
+        "name": "active",
         "type": {
           "text": "boolean"
         },
-        "description": "Advance slides automatically (default false)"
+        "description": "Marks this item as the current page (`aria-current=\"page\"`)"
       },
       {
-        "name": "autoplay-interval",
+        "name": "href",
         "type": {
-          "text": "number"
+          "text": "string"
         },
-        "description": "Milliseconds between automatic advances (default 5000)"
+        "description": "Link target for this breadcrumb item"
       },
       {
-        "name": "label",
+        "name": "separator",
         "type": {
           "text": "string"
         },
-        "description": "Accessible label for the carousel region"
-      },
+        "description": "Separator text shown before the item (except first item)"
+      }
+    ],
+    "slots": [
       {
-        "name": "loop",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Loop from last slide to first (default true)"
+        "name": "",
+        "description": "Item label/content"
       },
       {
-        "name": "orientation",
-        "type": {
-          "text": "string"
-        },
-        "description": "'horizontal' (default) | 'vertical'"
-      },
+        "name": "icon",
+        "description": "Optional leading icon for the crumb"
+      }
+    ],
+    "cssParts": [
       {
-        "name": "variant",
-        "type": {
-          "text": "'default' | 'fade' | 'filmstrip' | 'gallery'"
-        },
-        "description": "'default' | 'fade' | 'filmstrip' | 'gallery'"
+        "name": "separator",
+        "description": "Separator element before the item label"
       },
       {
-        "name": "show-controls",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Show prev/next buttons (default true)"
-      },
+        "name": "link",
+        "description": "The interactive anchor element"
+      }
+    ],
+    "demos": [
       {
-        "name": "show-indicators",
+        "url": "",
+        "description": "```html\n<ore-breadcrumb-item href=\"/\">Home</ore-breadcrumb-item>\n<ore-breadcrumb-item active>Current Page</ore-breadcrumb-item>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "BREADCRUMB_TAG",
+    "type": {
+      "text": "'ore-breadcrumb'"
+    },
+    "default": "'ore-breadcrumb'",
+    "description": "Accessible breadcrumb navigation container."
+  },
+  {
+    "kind": "class",
+    "name": "OreBreadcrumbElement",
+    "tagName": "ore-breadcrumb",
+    "customElement": true,
+    "description": "Accessible breadcrumb navigation container.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "label",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "Show indicator dots (default true)"
+        "description": "Accessible label for the internal `<nav>` landmark"
       },
       {
-        "name": "slide-index",
+        "name": "separator",
         "type": {
-          "text": "number"
+          "text": "string"
         },
-        "description": "Active slide index (zero-based, default 0)"
+        "description": "Separator text propagated to child `<ore-breadcrumb-item>` elements"
       }
     ],
-    "events": [
-      {
-        "name": "change",
-        "description": "Fires when the active slide changes. detail: { index: number }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
+    "slots": [
       {
         "name": "",
-        "description": "Place `<ore-carousel-slide>` elements here"
+        "description": "One or more `<ore-breadcrumb-item>` children"
       }
     ],
     "cssParts": [
       {
-        "name": "track",
-        "description": "The scrolling slide track element"
-      },
-      {
-        "name": "controls",
-        "description": "The prev/next button container"
-      },
-      {
-        "name": "indicators",
-        "description": "The indicator dots container"
-      },
-      {
-        "name": "prev-btn",
-        "description": "The previous-slide button"
+        "name": "nav",
+        "description": "Internal navigation landmark element"
       },
       {
-        "name": "next-btn",
-        "description": "The next-slide button"
+        "name": "list",
+        "description": "Internal ordered list container"
       }
     ],
     "cssProperties": [
       {
-        "name": "--carousel-bg",
-        "description": "Slide area background"
-      },
-      {
-        "name": "--carousel-radius",
-        "description": "Border radius of the carousel"
-      },
-      {
-        "name": "--carousel-dot-bg",
-        "description": "Inactive indicator color (default: var(--color-contrast-300))"
-      },
-      {
-        "name": "--carousel-dot-active-bg",
-        "description": "Active indicator / fill color (default: var(--color-contrast-700))"
-      },
-      {
-        "name": "--carousel-transition-duration",
-        "description": "Slide transition duration (default 0.35s; 0s under prefers-reduced-motion)."
-      },
-      {
-        "name": "--carousel-min-height",
-        "description": "Minimum height when no explicit height is set (default 240px)"
-      },
-      {
-        "name": "--carousel-filmstrip-inactive",
-        "description": "Width (horizontal) or height (vertical) of inactive slides in filmstrip mode"
-      },
-      {
-        "name": "--carousel-filmstrip-gap",
-        "description": "Gap between slides in filmstrip mode"
-      },
-      {
-        "name": "--carousel-gallery-thumbnail",
-        "description": "Width (horizontal) or height (vertical) of thumbnail slides in gallery mode (default var(--size-24))"
-      },
-      {
-        "name": "--carousel-gallery-gap",
-        "description": "Gap between slides in gallery mode (default var(--size-2))"
+        "name": "--breadcrumb-separator",
+        "description": "Optional custom separator text synced to child items"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-carousel label=\"Product highlights\" loop>\n  <ore-carousel-slide>Slide 1</ore-carousel-slide>\n  <ore-carousel-slide>Slide 2</ore-carousel-slide>\n  <ore-carousel-slide>Slide 3</ore-carousel-slide>\n</ore-carousel>\n```"
+        "description": "```html\n<ore-breadcrumb label=\"Page breadcrumb\">\n  <ore-breadcrumb-item href=\"/\">Home</ore-breadcrumb-item>\n  <ore-breadcrumb-item href=\"/blog\">Blog</ore-breadcrumb-item>\n  <ore-breadcrumb-item active>My Post</ore-breadcrumb-item>\n</ore-breadcrumb>\n```"
       }
     ]
   },
@@ -1611,6 +1389,188 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "CAROUSEL_SLIDE_TAG",
+    "type": {
+      "text": "'ore-carousel-slide'"
+    },
+    "default": "'ore-carousel-slide'"
+  },
+  {
+    "kind": "variable",
+    "name": "CAROUSEL_TAG",
+    "type": {
+      "text": "'ore-carousel'"
+    },
+    "default": "'ore-carousel'",
+    "description": "An accessible, keyboard-navigable carousel / slideshow with optional\nautoplay, swipe support, and indicator dots.\n\nPlace `<ore-carousel-slide>` elements as direct children."
+  },
+  {
+    "kind": "class",
+    "name": "OreCarouselElement",
+    "tagName": "ore-carousel",
+    "customElement": true,
+    "description": "An accessible, keyboard-navigable carousel / slideshow with optional\nautoplay, swipe support, and indicator dots.\nPlace `<ore-carousel-slide>` elements as direct children.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "color",
+        "type": {
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        },
+        "description": "Theme color for navigation buttons: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+      },
+      {
+        "name": "autoplay",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Advance slides automatically (default false)"
+      },
+      {
+        "name": "autoplay-interval",
+        "type": {
+          "text": "number"
+        },
+        "description": "Milliseconds between automatic advances (default 5000)"
+      },
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Accessible label for the carousel region"
+      },
+      {
+        "name": "loop",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Loop from last slide to first (default true)"
+      },
+      {
+        "name": "orientation",
+        "type": {
+          "text": "string"
+        },
+        "description": "'horizontal' (default) | 'vertical'"
+      },
+      {
+        "name": "variant",
+        "type": {
+          "text": "'default' | 'fade' | 'filmstrip' | 'gallery'"
+        },
+        "description": "'default' | 'fade' | 'filmstrip' | 'gallery'"
+      },
+      {
+        "name": "show-controls",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Show prev/next buttons (default true)"
+      },
+      {
+        "name": "show-indicators",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Show indicator dots (default true)"
+      },
+      {
+        "name": "slide-index",
+        "type": {
+          "text": "number"
+        },
+        "description": "Active slide index (zero-based, default 0)"
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "description": "Fires when the active slide changes. detail: { index: number }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Place `<ore-carousel-slide>` elements here"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "track",
+        "description": "The scrolling slide track element"
+      },
+      {
+        "name": "controls",
+        "description": "The prev/next button container"
+      },
+      {
+        "name": "indicators",
+        "description": "The indicator dots container"
+      },
+      {
+        "name": "prev-btn",
+        "description": "The previous-slide button"
+      },
+      {
+        "name": "next-btn",
+        "description": "The next-slide button"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--carousel-bg",
+        "description": "Slide area background"
+      },
+      {
+        "name": "--carousel-radius",
+        "description": "Border radius of the carousel"
+      },
+      {
+        "name": "--carousel-dot-bg",
+        "description": "Inactive indicator color (default: var(--color-contrast-300))"
+      },
+      {
+        "name": "--carousel-dot-active-bg",
+        "description": "Active indicator / fill color (default: var(--color-contrast-700))"
+      },
+      {
+        "name": "--carousel-transition-duration",
+        "description": "Slide transition duration (default 0.35s; 0s under prefers-reduced-motion)."
+      },
+      {
+        "name": "--carousel-min-height",
+        "description": "Minimum height when no explicit height is set (default 240px)"
+      },
+      {
+        "name": "--carousel-filmstrip-inactive",
+        "description": "Width (horizontal) or height (vertical) of inactive slides in filmstrip mode"
+      },
+      {
+        "name": "--carousel-filmstrip-gap",
+        "description": "Gap between slides in filmstrip mode"
+      },
+      {
+        "name": "--carousel-gallery-thumbnail",
+        "description": "Width (horizontal) or height (vertical) of thumbnail slides in gallery mode (default var(--size-24))"
+      },
+      {
+        "name": "--carousel-gallery-gap",
+        "description": "Gap between slides in gallery mode (default var(--size-2))"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-carousel label=\"Product highlights\" loop>\n  <ore-carousel-slide>Slide 1</ore-carousel-slide>\n  <ore-carousel-slide>Slide 2</ore-carousel-slide>\n  <ore-carousel-slide>Slide 3</ore-carousel-slide>\n</ore-carousel>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "CHAT_MESSAGE_TAG",
@@ -3651,7 +3611,75 @@
   },
   {
     "kind": "variable",
-    "name": "TAB_ITEM_TAG",
+    "name": "TAB_PANEL_TAG",
+    "type": {
+      "text": "'ore-tab-panel'"
+    },
+    "default": "'ore-tab-panel'",
+    "description": "Content panel for a tab. Shown when its `value` matches the selected tab."
+  },
+  {
+    "kind": "class",
+    "name": "OreTabPanelElement",
+    "tagName": "ore-tab-panel",
+    "customElement": true,
+    "description": "Content panel for a tab. Shown when its `value` matches the selected tab.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Must match the corresponding ore-tab-item value"
+      },
+      {
+        "name": "active",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Toggled by the parent ore-tabs"
+      },
+      {
+        "name": "padding",
+        "type": {
+          "text": "'none' | 'xs' | 'sm' | 'md'"
+        },
+        "description": "Panel padding: 'none' | 'xs' | 'sm' | 'md' (default) | 'lg' | 'xl' | '2xl'"
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Panel content"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "panel",
+        "description": "Panel container."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--tab-panel-padding",
+        "description": "Inner padding of the panel content area"
+      },
+      {
+        "name": "--tab-panel-font-size",
+        "description": "Font size of the panel content"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-tab-panel value=\"overview\"><p>Overview content here</p></ore-tab-panel>\n<ore-tab-panel value=\"settings\" padding=\"lg\"><p>Large padding</p></ore-tab-panel>\n<ore-tab-panel value=\"code\" padding=\"none\"><pre>No padding for code</pre></ore-tab-panel>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "TAB_ITEM_TAG",
     "type": {
       "text": "'ore-tab-item'"
     },
@@ -3774,74 +3802,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "TAB_PANEL_TAG",
-    "type": {
-      "text": "'ore-tab-panel'"
-    },
-    "default": "'ore-tab-panel'",
-    "description": "Content panel for a tab. Shown when its `value` matches the selected tab."
-  },
-  {
-    "kind": "class",
-    "name": "OreTabPanelElement",
-    "tagName": "ore-tab-panel",
-    "customElement": true,
-    "description": "Content panel for a tab. Shown when its `value` matches the selected tab.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "value",
-        "type": {
-          "text": "string"
-        },
-        "description": "Must match the corresponding ore-tab-item value"
-      },
-      {
-        "name": "active",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Toggled by the parent ore-tabs"
-      },
-      {
-        "name": "padding",
-        "type": {
-          "text": "'none' | 'xs' | 'sm' | 'md'"
-        },
-        "description": "Panel padding: 'none' | 'xs' | 'sm' | 'md' (default) | 'lg' | 'xl' | '2xl'"
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Panel content"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "panel",
-        "description": "Panel container."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--tab-panel-padding",
-        "description": "Inner padding of the panel content area"
-      },
-      {
-        "name": "--tab-panel-font-size",
-        "description": "Font size of the panel content"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-tab-panel value=\"overview\"><p>Overview content here</p></ore-tab-panel>\n<ore-tab-panel value=\"settings\" padding=\"lg\"><p>Large padding</p></ore-tab-panel>\n<ore-tab-panel value=\"code\" padding=\"none\"><pre>No padding for code</pre></ore-tab-panel>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "TABS_CTX",
@@ -4597,239 +4557,170 @@
   },
   {
     "kind": "variable",
-    "name": "PROGRESS_TAG",
+    "name": "PASSWORD_STRENGTH_TAG",
     "type": {
-      "text": "'ore-progress'"
+      "text": "'ore-password-strength'"
     },
-    "default": "'ore-progress'",
-    "description": "A linear progress bar for conveying operation progress.\nSupports determinate (known value) and indeterminate (unknown duration) modes."
+    "default": "'ore-password-strength'",
+    "description": "Strong password meter with segmented progress visualization.\n\nBuilt-in scoring is heuristic and conservative:\n- length < 6 => weak\n- length >= 8 with mixed case => fair\n- + digit or symbol => good\n- length >= 12 with mixed case, digit and symbol => strong"
   },
   {
     "kind": "class",
-    "name": "OreProgressElement",
-    "tagName": "ore-progress",
+    "name": "OrePasswordStrengthElement",
+    "tagName": "ore-password-strength",
     "customElement": true,
-    "description": "A linear progress bar for conveying operation progress.\nSupports determinate (known value) and indeterminate (unknown duration) modes.",
+    "description": "Strong password meter with segmented progress visualization.\nBuilt-in scoring is heuristic and conservative:\n- length < 6 => weak\n- length >= 8 with mixed case => fair\n- + digit or symbol => good\n- length >= 12 with mixed case, digit and symbol => strong",
     "summary": "",
     "attributes": [
       {
         "name": "value",
         "type": {
-          "text": "number"
+          "text": "string"
         },
-        "description": "Current value (0–max). Defaults to 0."
+        "description": "Password string to evaluate"
       },
       {
-        "name": "max",
+        "name": "score",
         "type": {
           "text": "number"
         },
-        "description": "Maximum value. Defaults to 100."
+        "description": "Optional score override (0..4). Use -1 for no override (default: -1)",
+        "default": "-1"
       },
       {
-        "name": "indeterminate",
+        "name": "show-label",
         "type": {
           "text": "boolean"
         },
-        "description": "Show infinite animation (ignores value/max)."
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'success' | 'warning' | 'error'"
-        },
-        "description": "Theme color: 'primary' | 'success' | 'warning' | 'error' | …"
-      },
-      {
-        "name": "size",
-        "type": {
-          "text": "'sm' | 'md' | 'lg'"
-        },
-        "description": "Bar height/width: 'sm' | 'md' | 'lg'"
-      },
-      {
-        "name": "type",
-        "type": {
-          "text": "'circular' | 'vertical'"
-        },
-        "description": "'linear' (default) | 'circular' | 'vertical'"
+        "description": "Show visible feedback label (default: true)",
+        "default": "true"
       },
       {
         "name": "label",
         "type": {
           "text": "string"
         },
-        "description": "Visible text label + accessible name. Linear: at bar end (or header row with title). Circular: large text centered inside the ring."
-      },
-      {
-        "name": "title",
-        "type": {
-          "text": "string"
-        },
-        "description": "Title text. Linear: header above the bar (moves label to header row). Circular: smaller text below the label inside the ring."
-      },
-      {
-        "name": "floating-label",
-        "type": {
-          "text": "string"
-        },
-        "description": "Floating chip centered above the fill endpoint (linear only); hidden when indeterminate."
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "fill",
-        "description": "Progress fill element."
+        "description": "Accessible name (default: 'Password strength')",
+        "default": "'Password strength'"
       }
     ],
     "cssProperties": [
       {
-        "name": "--progress-width",
-        "description": "Bar width override (vertical only)"
-      },
-      {
-        "name": "--progress-height",
-        "description": "Bar height override"
+        "name": "--password-strength-height       Segment bar height",
+        "description": ""
       },
       {
-        "name": "--progress-track-bg",
-        "description": "Track background color"
+        "name": "--password-strength-gap          Gap between segments",
+        "description": ""
       },
       {
-        "name": "--progress-fill",
-        "description": "Fill bar color"
+        "name": "--password-strength-radius       Segment corner radius",
+        "description": ""
       },
       {
-        "name": "--progress-radius",
-        "description": "Border radius"
+        "name": "--password-strength-track-bg     Inactive segment color",
+        "description": ""
       },
       {
-        "name": "--progress-label-gap",
-        "description": "Gap between header/bar row and between bar and trailing label (default 0.25 rem)"
+        "name": "--password-strength-label-size   Visible label font size",
+        "description": ""
       },
       {
-        "name": "--progress-title-color",
-        "description": "Title text color (defaults to currentColor)"
+        "name": "--password-strength-label-color  Visible label color",
+        "description": ""
       },
       {
-        "name": "--progress-label-color",
-        "description": "Label text color (defaults to currentColor)"
+        "name": "--password-strength-weak-color   Weak state segment color",
+        "description": ""
       },
       {
-        "name": "--progress-circle-size",
-        "description": "Circular indicator diameter (default 6rem)"
+        "name": "--password-strength-fair-color   Fair state segment color",
+        "description": ""
       },
       {
-        "name": "--progress-circular-label-size",
-        "description": "Font size of the label inside the ring (default --text-xl)"
+        "name": "--password-strength-good-color   Good state segment color",
+        "description": ""
       },
       {
-        "name": "--progress-circular-title-size",
-        "description": "Font size of the title inside the ring (default --text-xs)"
+        "name": "--password-strength-strong-color Strong state segment color",
+        "description": ""
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-progress value=\"45\"></ore-progress>\n<ore-progress value=\"75\" max=\"100\" color=\"success\" size=\"lg\"></ore-progress>\n<ore-progress indeterminate color=\"primary\" label=\"Loading…\"></ore-progress>\n```"
+        "description": "```html\n<!-- Pair with an ore-input to evaluate in real time -->\n<ore-input type=\"password\" label=\"Password\" name=\"password\" id=\"pwd\"></ore-input>\n<ore-password-strength id=\"meter\"></ore-password-strength>\n<script type=\"module\">\n  document.getElementById('pwd').addEventListener('input', (e) => {\n    document.getElementById('meter').value = e.target.value;\n  });\n</script>\n<!-- Fixed score display (e.g. from a server-side score) -->\n<ore-password-strength score=\"3\"></ore-password-strength>\n```"
       }
     ]
   },
   {
     "kind": "variable",
-    "name": "PASSWORD_STRENGTH_TAG",
+    "name": "TYPING_INDICATOR_TAG",
     "type": {
-      "text": "'ore-password-strength'"
+      "text": "'ore-typing-indicator'"
     },
-    "default": "'ore-password-strength'",
-    "description": "Strong password meter with segmented progress visualization.\n\nBuilt-in scoring is heuristic and conservative:\n- length < 6 => weak\n- length >= 8 with mixed case => fair\n- + digit or symbol => good\n- length >= 12 with mixed case, digit and symbol => strong"
+    "default": "'ore-typing-indicator'",
+    "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply —\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\n\nThe dots are decorative (`aria-hidden`) — `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set) is the same pattern already used for other\ntransient status messages across this package."
   },
   {
     "kind": "class",
-    "name": "OrePasswordStrengthElement",
-    "tagName": "ore-password-strength",
+    "name": "OreTypingIndicatorElement",
+    "tagName": "ore-typing-indicator",
     "customElement": true,
-    "description": "Strong password meter with segmented progress visualization.\nBuilt-in scoring is heuristic and conservative:\n- length < 6 => weak\n- length >= 8 with mixed case => fair\n- + digit or symbol => good\n- length >= 12 with mixed case, digit and symbol => strong",
+    "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply —\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\nThe dots are decorative (`aria-hidden`) — `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set) is the same pattern already used for other\ntransient status messages across this package.",
     "summary": "",
     "attributes": [
       {
-        "name": "value",
+        "name": "label",
         "type": {
           "text": "string"
         },
-        "description": "Password string to evaluate"
-      },
-      {
-        "name": "score",
-        "type": {
-          "text": "number"
-        },
-        "description": "Optional score override (0..4). Use -1 for no override (default: -1)",
-        "default": "-1"
+        "description": "Accessible label announced once via a polite live region (default: \"Typing…\")",
+        "default": "\"Typing…\""
       },
       {
-        "name": "show-label",
+        "name": "color",
         "type": {
-          "text": "boolean"
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
         },
-        "description": "Show visible feedback label (default: true)",
-        "default": "true"
+        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
       {
-        "name": "label",
+        "name": "size",
         "type": {
-          "text": "string"
+          "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "Accessible name (default: 'Password strength')",
-        "default": "'Password strength'"
+        "description": "'sm' | 'md' | 'lg'"
       }
     ],
-    "cssProperties": [
-      {
-        "name": "--password-strength-height       Segment bar height",
-        "description": ""
-      },
-      {
-        "name": "--password-strength-gap          Gap between segments",
-        "description": ""
-      },
-      {
-        "name": "--password-strength-radius       Segment corner radius",
-        "description": ""
-      },
-      {
-        "name": "--password-strength-track-bg     Inactive segment color",
-        "description": ""
-      },
-      {
-        "name": "--password-strength-label-size   Visible label font size",
-        "description": ""
-      },
+    "cssParts": [
       {
-        "name": "--password-strength-label-color  Visible label color",
-        "description": ""
+        "name": "dots",
+        "description": "Dots container."
       },
       {
-        "name": "--password-strength-weak-color   Weak state segment color",
-        "description": ""
-      },
+        "name": "dot",
+        "description": "Individual dot element."
+      }
+    ],
+    "cssProperties": [
       {
-        "name": "--password-strength-fair-color   Fair state segment color",
-        "description": ""
+        "name": "--typing-indicator-color",
+        "description": "Dot color"
       },
       {
-        "name": "--password-strength-good-color   Good state segment color",
-        "description": ""
+        "name": "--typing-indicator-size",
+        "description": "Dot diameter"
       },
       {
-        "name": "--password-strength-strong-color Strong state segment color",
-        "description": ""
+        "name": "--typing-indicator-gap",
+        "description": "Gap between dots"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<!-- Pair with an ore-input to evaluate in real time -->\n<ore-input type=\"password\" label=\"Password\" name=\"password\" id=\"pwd\"></ore-input>\n<ore-password-strength id=\"meter\"></ore-password-strength>\n<script type=\"module\">\n  document.getElementById('pwd').addEventListener('input', (e) => {\n    document.getElementById('meter').value = e.target.value;\n  });\n</script>\n<!-- Fixed score display (e.g. from a server-side score) -->\n<ore-password-strength score=\"3\"></ore-password-strength>\n```"
+        "description": "```html\n<ore-typing-indicator></ore-typing-indicator>\n<ore-typing-indicator label=\"Assistant is typing…\" color=\"primary\"></ore-typing-indicator>\n```"
       }
     ]
   },
@@ -5032,245 +4923,384 @@
   },
   {
     "kind": "variable",
-    "name": "TYPING_INDICATOR_TAG",
+    "name": "PROGRESS_TAG",
     "type": {
-      "text": "'ore-typing-indicator'"
+      "text": "'ore-progress'"
     },
-    "default": "'ore-typing-indicator'",
-    "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply —\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\n\nThe dots are decorative (`aria-hidden`) — `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set) is the same pattern already used for other\ntransient status messages across this package."
+    "default": "'ore-progress'",
+    "description": "A linear progress bar for conveying operation progress.\nSupports determinate (known value) and indeterminate (unknown duration) modes."
   },
   {
     "kind": "class",
-    "name": "OreTypingIndicatorElement",
-    "tagName": "ore-typing-indicator",
+    "name": "OreProgressElement",
+    "tagName": "ore-progress",
     "customElement": true,
-    "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply —\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\nThe dots are decorative (`aria-hidden`) — `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set) is the same pattern already used for other\ntransient status messages across this package.",
+    "description": "A linear progress bar for conveying operation progress.\nSupports determinate (known value) and indeterminate (unknown duration) modes.",
     "summary": "",
     "attributes": [
       {
-        "name": "label",
+        "name": "value",
         "type": {
-          "text": "string"
+          "text": "number"
         },
-        "description": "Accessible label announced once via a polite live region (default: \"Typing…\")",
-        "default": "\"Typing…\""
+        "description": "Current value (0–max). Defaults to 0."
+      },
+      {
+        "name": "max",
+        "type": {
+          "text": "number"
+        },
+        "description": "Maximum value. Defaults to 100."
+      },
+      {
+        "name": "indeterminate",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Show infinite animation (ignores value/max)."
       },
       {
         "name": "color",
         "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+          "text": "'primary' | 'success' | 'warning' | 'error'"
         },
-        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        "description": "Theme color: 'primary' | 'success' | 'warning' | 'error' | …"
       },
       {
         "name": "size",
         "type": {
           "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "'sm' | 'md' | 'lg'"
+        "description": "Bar height/width: 'sm' | 'md' | 'lg'"
+      },
+      {
+        "name": "type",
+        "type": {
+          "text": "'circular' | 'vertical'"
+        },
+        "description": "'linear' (default) | 'circular' | 'vertical'"
+      },
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Visible text label + accessible name. Linear: at bar end (or header row with title). Circular: large text centered inside the ring."
+      },
+      {
+        "name": "title",
+        "type": {
+          "text": "string"
+        },
+        "description": "Title text. Linear: header above the bar (moves label to header row). Circular: smaller text below the label inside the ring."
+      },
+      {
+        "name": "floating-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Floating chip centered above the fill endpoint (linear only); hidden when indeterminate."
       }
     ],
     "cssParts": [
       {
-        "name": "dots",
-        "description": "Dots container."
-      },
-      {
-        "name": "dot",
-        "description": "Individual dot element."
+        "name": "fill",
+        "description": "Progress fill element."
       }
     ],
     "cssProperties": [
       {
-        "name": "--typing-indicator-color",
-        "description": "Dot color"
+        "name": "--progress-width",
+        "description": "Bar width override (vertical only)"
       },
       {
-        "name": "--typing-indicator-size",
-        "description": "Dot diameter"
+        "name": "--progress-height",
+        "description": "Bar height override"
       },
       {
-        "name": "--typing-indicator-gap",
-        "description": "Gap between dots"
+        "name": "--progress-track-bg",
+        "description": "Track background color"
+      },
+      {
+        "name": "--progress-fill",
+        "description": "Fill bar color"
+      },
+      {
+        "name": "--progress-radius",
+        "description": "Border radius"
+      },
+      {
+        "name": "--progress-label-gap",
+        "description": "Gap between header/bar row and between bar and trailing label (default 0.25 rem)"
+      },
+      {
+        "name": "--progress-title-color",
+        "description": "Title text color (defaults to currentColor)"
+      },
+      {
+        "name": "--progress-label-color",
+        "description": "Label text color (defaults to currentColor)"
+      },
+      {
+        "name": "--progress-circle-size",
+        "description": "Circular indicator diameter (default 6rem)"
+      },
+      {
+        "name": "--progress-circular-label-size",
+        "description": "Font size of the label inside the ring (default --text-xl)"
+      },
+      {
+        "name": "--progress-circular-title-size",
+        "description": "Font size of the title inside the ring (default --text-xs)"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-typing-indicator></ore-typing-indicator>\n<ore-typing-indicator label=\"Assistant is typing…\" color=\"primary\"></ore-typing-indicator>\n```"
+        "description": "```html\n<ore-progress value=\"45\"></ore-progress>\n<ore-progress value=\"75\" max=\"100\" color=\"success\" size=\"lg\"></ore-progress>\n<ore-progress indeterminate color=\"primary\" label=\"Loading…\"></ore-progress>\n```"
       }
     ]
   },
   {
     "kind": "variable",
-    "name": "BUTTON_GROUP_CTX"
+    "name": "BUTTON_VARIANTS",
+    "type": {
+      "text": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text', 'frost']"
+    },
+    "default": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text', 'frost']"
   },
   {
     "kind": "variable",
-    "name": "BUTTON_GROUP_TAG",
+    "name": "BUTTON_TAG",
     "type": {
-      "text": "'ore-button-group'"
+      "text": "'ore-button'"
     },
-    "default": "'ore-button-group'",
-    "description": "A container for grouping related buttons.\nChild `ore-button` components automatically inherit the group's color, size, and variant."
+    "default": "'ore-button'",
+    "description": "A customizable button component with multiple variants, sizes, and states.\nSupports icons, loading states, and animated border effects."
   },
   {
     "kind": "class",
-    "name": "OreButtonGroupElement",
-    "tagName": "ore-button-group",
+    "name": "OreButtonElement",
+    "tagName": "ore-button",
     "customElement": true,
-    "description": "A container for grouping related buttons.\nChild `ore-button` components automatically inherit the group's color, size, and variant.",
+    "description": "A customizable button component with multiple variants, sizes, and states.\nSupports icons, loading states, and animated border effects.",
     "summary": "",
     "attributes": [
       {
-        "name": "attached",
+        "name": "type",
         "type": {
-          "text": "boolean"
+          "text": "'button' | 'submit' | 'reset'"
         },
-        "description": "Join buttons together into a unit"
+        "description": "HTML button type: 'button' | 'submit' | 'reset'"
       },
       {
-        "name": "color",
+        "name": "disabled",
         "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+          "text": "boolean"
         },
-        "description": "Shared color tint: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        "description": "Disable button interaction"
       },
       {
-        "name": "fullwidth",
+        "name": "loading",
         "type": {
           "text": "boolean"
         },
-        "description": "Group spans full width"
+        "description": "Show loading state with spinner"
       },
       {
-        "name": "label",
+        "name": "color",
         "type": {
-          "text": "string"
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
         },
-        "description": "Accessible label"
+        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
       {
-        "name": "orientation",
+        "name": "variant",
         "type": {
-          "text": "'horizontal' | 'vertical'"
+          "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text' | 'frost'"
         },
-        "description": "'horizontal' | 'vertical'"
+        "description": "Visual variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text' | 'frost'"
+      },
+      {
+        "name": "size",
+        "type": {
+          "text": "'sm' | 'md' | 'lg'"
+        },
+        "description": "Button size: 'sm' | 'md' | 'lg'"
       },
       {
         "name": "rounded",
         "type": {
           "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
         },
-        "description": "Corner radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full' (bare attribute defaults to 'full')"
+        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
       },
       {
-        "name": "size",
+        "name": "effect",
         "type": {
-          "text": "'sm' | 'md' | 'lg'"
+          "text": "'shine' | 'rainbow'"
         },
-        "description": "Shared size: 'sm' | 'md' | 'lg'"
+        "description": "Animated border effect: 'shine' | 'rainbow'"
       },
       {
-        "name": "variant",
+        "name": "icon-only",
         "type": {
-          "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
+          "text": "boolean"
         },
-        "description": "Shared visual variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
+        "description": "Icon-only mode (square aspect ratio, no padding)"
+      },
+      {
+        "name": "fullwidth",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Full width button (100% of container)"
+      },
+      {
+        "name": "fullheight",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Full height button (100% of container)"
+      }
+    ],
+    "events": [
+      {
+        "name": "click",
+        "description": "Emitted when button is clicked (unless disabled/loading)",
+        "type": {
+          "text": "CustomEvent"
+        }
       }
     ],
     "slots": [
       {
         "name": "",
-        "description": "Place ore-button elements here"
+        "description": "Button content (text, icons, etc.)"
+      },
+      {
+        "name": "prefix",
+        "description": "Content before the button text (e.g., icons)"
+      },
+      {
+        "name": "suffix",
+        "description": "Content after the button text (e.g., icons, badges)"
       }
     ],
     "cssParts": [
       {
-        "name": "group",
-        "description": "Group container."
+        "name": "button",
+        "description": "The inner button or anchor element"
+      },
+      {
+        "name": "loader",
+        "description": "The loading spinner element"
+      },
+      {
+        "name": "content",
+        "description": "The button content wrapper"
       }
     ],
     "cssProperties": [
       {
-        "name": "--group-gap",
-        "description": "Gap between buttons (non-attached mode)"
+        "name": "--button-bg",
+        "description": "Background color override"
       },
       {
-        "name": "--group-radius",
-        "description": "Border radius of the group container, defaults to the `rounded` attribute's token"
+        "name": "--button-color",
+        "description": "Text color override"
+      },
+      {
+        "name": "--button-border",
+        "description": "Border width override"
+      },
+      {
+        "name": "--button-border-color",
+        "description": "Border color override"
       },
       {
         "name": "--button-radius",
-        "description": "Passed through to child buttons to control corner radius"
+        "description": "Border radius override"
       },
       {
-        "name": "--button-border-start",
-        "description": "Passed through to suppress start borders in attached mode"
+        "name": "--button-padding",
+        "description": "Inner padding override"
       },
       {
-        "name": "--button-border-top",
-        "description": "Passed through to suppress top borders in vertical attached mode"
+        "name": "--button-gap",
+        "description": "Gap between icon and text override"
+      },
+      {
+        "name": "--button-font-size",
+        "description": "Font size override"
+      },
+      {
+        "name": "--button-frost-active-bg",
+        "description": "Background when pressed (frost variant)"
+      },
+      {
+        "name": "--button-frost-active-border-color",
+        "description": "Border color when pressed (frost variant)"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-button-group attached rounded=\"full\">\n  <ore-button variant=\"solid\" color=\"primary\">Save</ore-button>\n  <ore-button variant=\"solid\" color=\"primary\">Save &amp; Continue</ore-button>\n</ore-button-group>\n<ore-button-group orientation=\"vertical\" size=\"sm\">\n  <ore-button>Top</ore-button>\n  <ore-button>Middle</ore-button>\n  <ore-button>Bottom</ore-button>\n</ore-button-group>\n```"
+        "description": "```html\n<ore-button variant=\"solid\" color=\"primary\">Click me</ore-button>\n<ore-button loading color=\"success\">Processing...</ore-button>\n<ore-button effect=\"shine\" color=\"primary\">Shine</ore-button>\n<ore-button effect=\"rainbow\" variant=\"frost\">Rainbow</ore-button>\n```"
       }
     ]
   },
   {
     "kind": "variable",
-    "name": "CALENDAR_TAG",
+    "name": "CHECKBOX_TAG",
     "type": {
-      "text": "'ore-calendar'"
+      "text": "'ore-checkbox'"
     },
-    "default": "'ore-calendar'",
-    "description": "An accessible, keyboard-navigable inline calendar component.\nSupports day/month/year drill-down views, min/max bounds, disabled weekend\ndays, and optional form association."
+    "default": "'ore-checkbox'",
+    "description": "A customizable checkbox component with theme colors, sizes, and indeterminate state support."
   },
   {
     "kind": "class",
-    "name": "OreCalendarElement",
-    "tagName": "ore-calendar",
+    "name": "OreCheckboxElement",
+    "tagName": "ore-checkbox",
     "customElement": true,
-    "description": "An accessible, keyboard-navigable inline calendar component.\nSupports day/month/year drill-down views, min/max bounds, disabled weekend\ndays, and optional form association.",
+    "description": "A customizable checkbox component with theme colors, sizes, and indeterminate state support.",
     "summary": "",
     "attributes": [
       {
-        "name": "value",
+        "name": "checked",
         "type": {
-          "text": "string"
+          "text": "boolean"
         },
-        "description": "Selected date in ISO 8601 format (yyyy-MM-dd)"
+        "description": "Checked state"
       },
       {
-        "name": "min",
+        "name": "disabled",
         "type": {
-          "text": "string"
+          "text": "boolean"
         },
-        "description": "Minimum selectable date (yyyy-MM-dd)"
+        "description": "Disable checkbox interaction"
       },
       {
-        "name": "max",
+        "name": "indeterminate",
         "type": {
-          "text": "string"
+          "text": "boolean"
         },
-        "description": "Maximum selectable date (yyyy-MM-dd)"
+        "description": "Indeterminate (partially checked) state"
       },
       {
-        "name": "disabled",
+        "name": "required",
         "type": {
           "text": "boolean"
         },
-        "description": "Disable all interaction"
+        "description": "Require this checkbox to be checked for native form validation"
       },
       {
-        "name": "required",
+        "name": "value",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "Required field (form association)"
+        "description": "Field value submitted with forms"
       },
       {
         "name": "name",
@@ -5291,348 +5321,270 @@
         "type": {
           "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "Component size: 'sm' | 'md' | 'lg'"
-      },
-      {
-        "name": "rounded",
-        "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
-        },
-        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+        "description": "Checkbox size: 'sm' | 'md' | 'lg'"
       },
       {
-        "name": "locale",
+        "name": "error",
         "type": {
           "text": "string"
         },
-        "description": "BCP 47 locale string"
+        "description": "Error message (marks field as invalid)"
       },
       {
-        "name": "weekend-days",
+        "name": "helper",
         "type": {
           "text": "string"
         },
-        "description": "JSON array of day indices to disable (0=Sun…6=Sat)"
-      },
-      {
-        "name": "fullwidth",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Expand to full container width"
-      },
-      {
-        "name": "expanded",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Large-cell calendar-app layout with top-aligned day numbers"
+        "description": "Helper text displayed below the checkbox"
       }
     ],
     "events": [
+      {
+        "name": "input",
+        "description": "Emitted when checkbox is toggled.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
       {
         "name": "change",
-        "description": "Fired when a date is selected. detail: { isoValue: string | null }",
+        "description": "Emitted when checkbox is toggled.",
         "type": {
           "text": "CustomEvent"
         }
       }
     ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Checkbox label text"
+      }
+    ],
     "cssParts": [
       {
-        "name": "calendar",
-        "description": "The root calendar panel"
+        "name": "checkbox",
+        "description": "The checkbox wrapper element"
       },
       {
-        "name": "header",
-        "description": "Calendar header (nav + label)"
+        "name": "box",
+        "description": "The visual checkbox box"
       },
       {
-        "name": "grid",
-        "description": "Day grid"
+        "name": "label",
+        "description": "The label element"
       },
       {
-        "name": "day",
-        "description": "Individual day cell"
+        "name": "helper-text",
+        "description": "The helper/error text element"
       }
     ],
     "cssProperties": [
       {
-        "name": "--calendar-bg",
-        "description": "Calendar background"
+        "name": "--checkbox-size",
+        "description": "Control size (width and height)"
       },
       {
-        "name": "--calendar-border-color",
-        "description": "Calendar border color"
+        "name": "--checkbox-radius",
+        "description": "Control border radius"
       },
       {
-        "name": "--calendar-radius",
-        "description": "Calendar border radius"
+        "name": "--checkbox-bg",
+        "description": "Unchecked background color"
       },
       {
-        "name": "--calendar-shadow",
-        "description": "Calendar drop shadow"
+        "name": "--checkbox-border-color",
+        "description": "Unchecked border color"
       },
       {
-        "name": "--calendar-day-selected-bg",
-        "description": "Background of selected day cell"
+        "name": "--checkbox-checked-bg",
+        "description": "Checked/indeterminate background color"
       },
       {
-        "name": "--calendar-day-today-color",
-        "description": "Colour of today's date number"
+        "name": "--checkbox-color",
+        "description": "Checkmark icon color"
       },
       {
-        "name": "--calendar-day-outside-opacity",
-        "description": "Opacity of days outside visible month"
+        "name": "--checkbox-font-size",
+        "description": "Label font size"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<!-- Single date with bounds -->\n<ore-calendar value=\"2025-06-15\" min=\"2025-01-01\" max=\"2025-12-31\" color=\"primary\"></ore-calendar>\n<!-- Expanded calendar-app layout -->\n<ore-calendar expanded fullwidth color=\"primary\"></ore-calendar>\n```"
+        "description": "```html\n<ore-checkbox name=\"agree\" required>I agree to the terms</ore-checkbox>\n<ore-checkbox checked color=\"primary\" size=\"lg\">Enabled by default</ore-checkbox>\n<ore-checkbox error=\"This field is required\" helper=\"Check to continue\">Accept</ore-checkbox>\n```"
       }
     ]
   },
   {
     "kind": "variable",
-    "name": "BUTTON_VARIANTS",
-    "type": {
-      "text": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text', 'frost']"
-    },
-    "default": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text', 'frost']"
+    "name": "BUTTON_GROUP_CTX"
   },
   {
     "kind": "variable",
-    "name": "BUTTON_TAG",
+    "name": "BUTTON_GROUP_TAG",
     "type": {
-      "text": "'ore-button'"
+      "text": "'ore-button-group'"
     },
-    "default": "'ore-button'",
-    "description": "A customizable button component with multiple variants, sizes, and states.\nSupports icons, loading states, and animated border effects."
+    "default": "'ore-button-group'",
+    "description": "A container for grouping related buttons.\nChild `ore-button` components automatically inherit the group's color, size, and variant."
   },
   {
     "kind": "class",
-    "name": "OreButtonElement",
-    "tagName": "ore-button",
+    "name": "OreButtonGroupElement",
+    "tagName": "ore-button-group",
     "customElement": true,
-    "description": "A customizable button component with multiple variants, sizes, and states.\nSupports icons, loading states, and animated border effects.",
+    "description": "A container for grouping related buttons.\nChild `ore-button` components automatically inherit the group's color, size, and variant.",
     "summary": "",
     "attributes": [
       {
-        "name": "type",
-        "type": {
-          "text": "'button' | 'submit' | 'reset'"
-        },
-        "description": "HTML button type: 'button' | 'submit' | 'reset'"
-      },
-      {
-        "name": "disabled",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Disable button interaction"
-      },
-      {
-        "name": "loading",
+        "name": "attached",
         "type": {
           "text": "boolean"
         },
-        "description": "Show loading state with spinner"
+        "description": "Join buttons together into a unit"
       },
       {
         "name": "color",
         "type": {
           "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
         },
-        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-      },
-      {
-        "name": "variant",
-        "type": {
-          "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text' | 'frost'"
-        },
-        "description": "Visual variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text' | 'frost'"
+        "description": "Shared color tint: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
       {
-        "name": "size",
+        "name": "fullwidth",
         "type": {
-          "text": "'sm' | 'md' | 'lg'"
+          "text": "boolean"
         },
-        "description": "Button size: 'sm' | 'md' | 'lg'"
+        "description": "Group spans full width"
       },
       {
-        "name": "rounded",
+        "name": "label",
         "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+          "text": "string"
         },
-        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+        "description": "Accessible label"
       },
       {
-        "name": "effect",
+        "name": "orientation",
         "type": {
-          "text": "'shine' | 'rainbow'"
+          "text": "'horizontal' | 'vertical'"
         },
-        "description": "Animated border effect: 'shine' | 'rainbow'"
+        "description": "'horizontal' | 'vertical'"
       },
       {
-        "name": "icon-only",
+        "name": "rounded",
         "type": {
-          "text": "boolean"
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
         },
-        "description": "Icon-only mode (square aspect ratio, no padding)"
+        "description": "Corner radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full' (bare attribute defaults to 'full')"
       },
       {
-        "name": "fullwidth",
+        "name": "size",
         "type": {
-          "text": "boolean"
+          "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "Full width button (100% of container)"
+        "description": "Shared size: 'sm' | 'md' | 'lg'"
       },
       {
-        "name": "fullheight",
+        "name": "variant",
         "type": {
-          "text": "boolean"
+          "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
         },
-        "description": "Full height button (100% of container)"
-      }
-    ],
-    "events": [
-      {
-        "name": "click",
-        "description": "Emitted when button is clicked (unless disabled/loading)",
-        "type": {
-          "text": "CustomEvent"
-        }
+        "description": "Shared visual variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
       }
     ],
     "slots": [
       {
         "name": "",
-        "description": "Button content (text, icons, etc.)"
-      },
-      {
-        "name": "prefix",
-        "description": "Content before the button text (e.g., icons)"
-      },
-      {
-        "name": "suffix",
-        "description": "Content after the button text (e.g., icons, badges)"
+        "description": "Place ore-button elements here"
       }
     ],
     "cssParts": [
       {
-        "name": "button",
-        "description": "The inner button or anchor element"
-      },
-      {
-        "name": "loader",
-        "description": "The loading spinner element"
-      },
-      {
-        "name": "content",
-        "description": "The button content wrapper"
+        "name": "group",
+        "description": "Group container."
       }
     ],
     "cssProperties": [
       {
-        "name": "--button-bg",
-        "description": "Background color override"
-      },
-      {
-        "name": "--button-color",
-        "description": "Text color override"
-      },
-      {
-        "name": "--button-border",
-        "description": "Border width override"
+        "name": "--group-gap",
+        "description": "Gap between buttons (non-attached mode)"
       },
       {
-        "name": "--button-border-color",
-        "description": "Border color override"
+        "name": "--group-radius",
+        "description": "Border radius of the group container, defaults to the `rounded` attribute's token"
       },
       {
         "name": "--button-radius",
-        "description": "Border radius override"
-      },
-      {
-        "name": "--button-padding",
-        "description": "Inner padding override"
-      },
-      {
-        "name": "--button-gap",
-        "description": "Gap between icon and text override"
-      },
-      {
-        "name": "--button-font-size",
-        "description": "Font size override"
+        "description": "Passed through to child buttons to control corner radius"
       },
       {
-        "name": "--button-frost-active-bg",
-        "description": "Background when pressed (frost variant)"
+        "name": "--button-border-start",
+        "description": "Passed through to suppress start borders in attached mode"
       },
       {
-        "name": "--button-frost-active-border-color",
-        "description": "Border color when pressed (frost variant)"
+        "name": "--button-border-top",
+        "description": "Passed through to suppress top borders in vertical attached mode"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-button variant=\"solid\" color=\"primary\">Click me</ore-button>\n<ore-button loading color=\"success\">Processing...</ore-button>\n<ore-button effect=\"shine\" color=\"primary\">Shine</ore-button>\n<ore-button effect=\"rainbow\" variant=\"frost\">Rainbow</ore-button>\n```"
+        "description": "```html\n<ore-button-group attached rounded=\"full\">\n  <ore-button variant=\"solid\" color=\"primary\">Save</ore-button>\n  <ore-button variant=\"solid\" color=\"primary\">Save &amp; Continue</ore-button>\n</ore-button-group>\n<ore-button-group orientation=\"vertical\" size=\"sm\">\n  <ore-button>Top</ore-button>\n  <ore-button>Middle</ore-button>\n  <ore-button>Bottom</ore-button>\n</ore-button-group>\n```"
       }
     ]
   },
   {
     "kind": "variable",
-    "name": "CHECKBOX_TAG",
+    "name": "CALENDAR_TAG",
     "type": {
-      "text": "'ore-checkbox'"
+      "text": "'ore-calendar'"
     },
-    "default": "'ore-checkbox'",
-    "description": "A customizable checkbox component with theme colors, sizes, and indeterminate state support."
+    "default": "'ore-calendar'",
+    "description": "An accessible, keyboard-navigable inline calendar component.\nSupports day/month/year drill-down views, min/max bounds, disabled weekend\ndays, and optional form association."
   },
   {
     "kind": "class",
-    "name": "OreCheckboxElement",
-    "tagName": "ore-checkbox",
+    "name": "OreCalendarElement",
+    "tagName": "ore-calendar",
     "customElement": true,
-    "description": "A customizable checkbox component with theme colors, sizes, and indeterminate state support.",
+    "description": "An accessible, keyboard-navigable inline calendar component.\nSupports day/month/year drill-down views, min/max bounds, disabled weekend\ndays, and optional form association.",
     "summary": "",
     "attributes": [
       {
-        "name": "checked",
+        "name": "value",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "Checked state"
+        "description": "Selected date in ISO 8601 format (yyyy-MM-dd)"
       },
       {
-        "name": "disabled",
+        "name": "min",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "Disable checkbox interaction"
+        "description": "Minimum selectable date (yyyy-MM-dd)"
       },
       {
-        "name": "indeterminate",
+        "name": "max",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "Indeterminate (partially checked) state"
+        "description": "Maximum selectable date (yyyy-MM-dd)"
       },
       {
-        "name": "required",
+        "name": "disabled",
         "type": {
           "text": "boolean"
         },
-        "description": "Require this checkbox to be checked for native form validation"
+        "description": "Disable all interaction"
       },
       {
-        "name": "value",
+        "name": "required",
         "type": {
-          "text": "string"
+          "text": "boolean"
         },
-        "description": "Field value submitted with forms"
+        "description": "Required field (form association)"
       },
       {
         "name": "name",
@@ -5653,97 +5605,105 @@
         "type": {
           "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "Checkbox size: 'sm' | 'md' | 'lg'"
+        "description": "Component size: 'sm' | 'md' | 'lg'"
       },
       {
-        "name": "error",
+        "name": "rounded",
+        "type": {
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+        },
+        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+      },
+      {
+        "name": "locale",
         "type": {
           "text": "string"
         },
-        "description": "Error message (marks field as invalid)"
+        "description": "BCP 47 locale string"
       },
       {
-        "name": "helper",
+        "name": "weekend-days",
         "type": {
           "text": "string"
         },
-        "description": "Helper text displayed below the checkbox"
-      }
-    ],
-    "events": [
+        "description": "JSON array of day indices to disable (0=Sun…6=Sat)"
+      },
       {
-        "name": "input",
-        "description": "Emitted when checkbox is toggled.",
+        "name": "fullwidth",
         "type": {
-          "text": "CustomEvent"
-        }
+          "text": "boolean"
+        },
+        "description": "Expand to full container width"
       },
       {
-        "name": "change",
-        "description": "Emitted when checkbox is toggled.",
+        "name": "expanded",
         "type": {
-          "text": "CustomEvent"
-        }
+          "text": "boolean"
+        },
+        "description": "Large-cell calendar-app layout with top-aligned day numbers"
       }
     ],
-    "slots": [
+    "events": [
       {
-        "name": "",
-        "description": "Checkbox label text"
+        "name": "change",
+        "description": "Fired when a date is selected. detail: { isoValue: string | null }",
+        "type": {
+          "text": "CustomEvent"
+        }
       }
     ],
     "cssParts": [
       {
-        "name": "checkbox",
-        "description": "The checkbox wrapper element"
+        "name": "calendar",
+        "description": "The root calendar panel"
       },
       {
-        "name": "box",
-        "description": "The visual checkbox box"
+        "name": "header",
+        "description": "Calendar header (nav + label)"
       },
       {
-        "name": "label",
-        "description": "The label element"
+        "name": "grid",
+        "description": "Day grid"
       },
       {
-        "name": "helper-text",
-        "description": "The helper/error text element"
+        "name": "day",
+        "description": "Individual day cell"
       }
     ],
     "cssProperties": [
       {
-        "name": "--checkbox-size",
-        "description": "Control size (width and height)"
+        "name": "--calendar-bg",
+        "description": "Calendar background"
       },
       {
-        "name": "--checkbox-radius",
-        "description": "Control border radius"
+        "name": "--calendar-border-color",
+        "description": "Calendar border color"
       },
       {
-        "name": "--checkbox-bg",
-        "description": "Unchecked background color"
+        "name": "--calendar-radius",
+        "description": "Calendar border radius"
       },
       {
-        "name": "--checkbox-border-color",
-        "description": "Unchecked border color"
+        "name": "--calendar-shadow",
+        "description": "Calendar drop shadow"
       },
       {
-        "name": "--checkbox-checked-bg",
-        "description": "Checked/indeterminate background color"
+        "name": "--calendar-day-selected-bg",
+        "description": "Background of selected day cell"
       },
       {
-        "name": "--checkbox-color",
-        "description": "Checkmark icon color"
+        "name": "--calendar-day-today-color",
+        "description": "Colour of today's date number"
       },
       {
-        "name": "--checkbox-font-size",
-        "description": "Label font size"
+        "name": "--calendar-day-outside-opacity",
+        "description": "Opacity of days outside visible month"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-checkbox name=\"agree\" required>I agree to the terms</ore-checkbox>\n<ore-checkbox checked color=\"primary\" size=\"lg\">Enabled by default</ore-checkbox>\n<ore-checkbox error=\"This field is required\" helper=\"Check to continue\">Accept</ore-checkbox>\n```"
+        "description": "```html\n<!-- Single date with bounds -->\n<ore-calendar value=\"2025-06-15\" min=\"2025-01-01\" max=\"2025-12-31\" color=\"primary\"></ore-calendar>\n<!-- Expanded calendar-app layout -->\n<ore-calendar expanded fullwidth color=\"primary\"></ore-calendar>\n```"
       }
     ]
   },
@@ -5877,6 +5837,111 @@
       }
     ]
   },
+  {
+    "kind": "function",
+    "name": "parseSlottedOptions",
+    "return": {
+      "type": {
+        "text": "ComboboxOptionItem[]"
+      }
+    },
+    "parameters": [
+      {
+        "name": "elements",
+        "type": {
+          "text": "Element[]"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "filterOptions",
+    "return": {
+      "type": {
+        "text": "ComboboxOptionItem[]"
+      }
+    },
+    "parameters": [
+      {
+        "name": "options",
+        "type": {
+          "text": "ComboboxOptionItem[]"
+        }
+      },
+      {
+        "name": "query",
+        "type": {
+          "text": "string"
+        }
+      },
+      {
+        "name": "noFilter",
+        "type": {
+          "text": "boolean"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "getCreatableLabel",
+    "return": {
+      "type": {
+        "text": "string"
+      }
+    },
+    "parameters": [
+      {
+        "name": "query",
+        "type": {
+          "text": "string"
+        }
+      },
+      {
+        "name": "creatable",
+        "type": {
+          "text": "boolean"
+        }
+      },
+      {
+        "name": "filteredOptions",
+        "type": {
+          "text": "ComboboxOptionItem[]"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "makeCreatableValue",
+    "return": {
+      "type": {
+        "text": "string"
+      }
+    },
+    "parameters": [
+      {
+        "name": "query",
+        "type": {
+          "text": "string"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "COMBOBOX_TAG",
+    "type": {
+      "text": "'ore-combobox'"
+    },
+    "default": "'ore-combobox'",
+    "description": "A searchable select field with multiple selection, custom option creation, and large-list support."
+  },
+  {
+    "kind": "variable",
+    "name": "value"
+  },
   {
     "kind": "class",
     "description": "Light-DOM row marker consumed by `<ore-table>`.",
@@ -6270,117 +6335,12 @@
         "description": "Opacity of days outside visible month"
       }
     ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<!-- Single date with constraints -->\n<ore-date-picker label=\"Appointment date\" name=\"date\" min=\"2025-01-01\" max=\"2025-12-31\" color=\"primary\"></ore-date-picker>\n<!-- Outside label, bordered variant -->\n<ore-date-picker label=\"Start date\" label-placement=\"outside\" variant=\"bordered\"></ore-date-picker>\n```"
-      }
-    ]
-  },
-  {
-    "kind": "function",
-    "name": "parseSlottedOptions",
-    "return": {
-      "type": {
-        "text": "ComboboxOptionItem[]"
-      }
-    },
-    "parameters": [
-      {
-        "name": "elements",
-        "type": {
-          "text": "Element[]"
-        }
-      }
-    ]
-  },
-  {
-    "kind": "function",
-    "name": "filterOptions",
-    "return": {
-      "type": {
-        "text": "ComboboxOptionItem[]"
-      }
-    },
-    "parameters": [
-      {
-        "name": "options",
-        "type": {
-          "text": "ComboboxOptionItem[]"
-        }
-      },
-      {
-        "name": "query",
-        "type": {
-          "text": "string"
-        }
-      },
-      {
-        "name": "noFilter",
-        "type": {
-          "text": "boolean"
-        }
-      }
-    ]
-  },
-  {
-    "kind": "function",
-    "name": "getCreatableLabel",
-    "return": {
-      "type": {
-        "text": "string"
-      }
-    },
-    "parameters": [
-      {
-        "name": "query",
-        "type": {
-          "text": "string"
-        }
-      },
-      {
-        "name": "creatable",
-        "type": {
-          "text": "boolean"
-        }
-      },
-      {
-        "name": "filteredOptions",
-        "type": {
-          "text": "ComboboxOptionItem[]"
-        }
-      }
-    ]
-  },
-  {
-    "kind": "function",
-    "name": "makeCreatableValue",
-    "return": {
-      "type": {
-        "text": "string"
-      }
-    },
-    "parameters": [
-      {
-        "name": "query",
-        "type": {
-          "text": "string"
-        }
-      }
-    ]
-  },
-  {
-    "kind": "variable",
-    "name": "COMBOBOX_TAG",
-    "type": {
-      "text": "'ore-combobox'"
-    },
-    "default": "'ore-combobox'",
-    "description": "A searchable select field with multiple selection, custom option creation, and large-list support."
-  },
-  {
-    "kind": "variable",
-    "name": "value"
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<!-- Single date with constraints -->\n<ore-date-picker label=\"Appointment date\" name=\"date\" min=\"2025-01-01\" max=\"2025-12-31\" color=\"primary\"></ore-date-picker>\n<!-- Outside label, bordered variant -->\n<ore-date-picker label=\"Start date\" label-placement=\"outside\" variant=\"bordered\"></ore-date-picker>\n```"
+      }
+    ]
   },
   {
     "kind": "function",
@@ -7171,6 +7131,153 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "RADIO_TAG",
+    "type": {
+      "text": "'ore-radio'"
+    },
+    "default": "'ore-radio'",
+    "description": "A customizable radio button component for mutually exclusive selections."
+  },
+  {
+    "kind": "class",
+    "name": "OreRadioElement",
+    "tagName": "ore-radio",
+    "customElement": true,
+    "description": "A customizable radio button component for mutually exclusive selections.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "checked",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Checked state"
+      },
+      {
+        "name": "disabled",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Disable radio interaction"
+      },
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Field value (required for radio groups)"
+      },
+      {
+        "name": "name",
+        "type": {
+          "text": "string"
+        },
+        "description": "Form field name (required for radio groups)"
+      },
+      {
+        "name": "color",
+        "type": {
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        },
+        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+      },
+      {
+        "name": "size",
+        "type": {
+          "text": "'sm' | 'md' | 'lg'"
+        },
+        "description": "Radio size: 'sm' | 'md' | 'lg'"
+      },
+      {
+        "name": "error",
+        "type": {
+          "text": "string"
+        },
+        "description": "Error message (marks field as invalid)"
+      },
+      {
+        "name": "helper",
+        "type": {
+          "text": "string"
+        },
+        "description": "Helper text displayed below the radio"
+      }
+    ],
+    "events": [
+      {
+        "name": "input",
+        "description": "Emitted when radio is selected.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "change",
+        "description": "Emitted when radio is selected.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Radio button label text"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "radio",
+        "description": "The radio wrapper element"
+      },
+      {
+        "name": "circle",
+        "description": "The visual radio circle"
+      },
+      {
+        "name": "label",
+        "description": "The label element"
+      },
+      {
+        "name": "helper-text",
+        "description": "The helper/error text element"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--radio-size",
+        "description": "Control size (width and height)"
+      },
+      {
+        "name": "--radio-bg",
+        "description": "Unchecked background color"
+      },
+      {
+        "name": "--radio-border-color",
+        "description": "Unchecked border color"
+      },
+      {
+        "name": "--radio-checked-bg",
+        "description": "Selected indicator background color"
+      },
+      {
+        "name": "--radio-color",
+        "description": "Selected indicator dot color"
+      },
+      {
+        "name": "--radio-font-size",
+        "description": "Label font size"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-radio name=\"plan\" value=\"free\">Free</ore-radio>\n<ore-radio name=\"plan\" value=\"pro\" checked color=\"primary\">Pro</ore-radio>\n<ore-radio name=\"plan\" value=\"enterprise\" disabled>Enterprise</ore-radio>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "NUMBER_INPUT_TAG",
@@ -7341,36 +7448,131 @@
         "description": "Input element."
       },
       {
-        "name": "increment-btn",
-        "description": "Increment stepper button."
+        "name": "increment-btn",
+        "description": "Increment stepper button."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--number-input-height",
+        "description": "Control height"
+      },
+      {
+        "name": "--number-input-border-color",
+        "description": "Border color"
+      },
+      {
+        "name": "--number-input-radius",
+        "description": "Border radius"
+      },
+      {
+        "name": "--number-input-bg",
+        "description": "Background"
+      },
+      {
+        "name": "--number-input-btn-bg",
+        "description": "Spin button background"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-number-input label=\"Quantity\" value=\"1\" min=\"1\" max=\"99\" step=\"1\"></ore-number-input>\n<ore-number-input label=\"Quantity\" success></ore-number-input>\n<ore-number-input label=\"Quantity\" loading></ore-number-input>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "RADIO_GROUP_CTX"
+  },
+  {
+    "kind": "variable",
+    "name": "RADIO_GROUP_TAG",
+    "type": {
+      "text": "'ore-radio-group'"
+    },
+    "default": "'ore-radio-group'",
+    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management."
+  },
+  {
+    "kind": "class",
+    "name": "OreRadioGroupElement",
+    "tagName": "ore-radio-group",
+    "customElement": true,
+    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Selected value"
+      },
+      {
+        "name": "name",
+        "type": {
+          "text": "string"
+        },
+        "description": "Form field name"
+      },
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Group label"
+      },
+      {
+        "name": "orientation",
+        "type": {
+          "text": "'vertical' | 'horizontal'"
+        },
+        "description": "Layout: 'vertical' | 'horizontal'"
+      },
+      {
+        "name": "required",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Required field"
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "description": "Emitted when a radio is selected. detail: { values: string[], labels: string[], originalEvent?: Event }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Place `ore-radio` elements here"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "items",
+        "description": "Items container."
       }
     ],
     "cssProperties": [
       {
-        "name": "--number-input-height",
-        "description": "Control height"
-      },
-      {
-        "name": "--number-input-border-color",
-        "description": "Border color"
-      },
-      {
-        "name": "--number-input-radius",
-        "description": "Border radius"
-      },
-      {
-        "name": "--number-input-bg",
-        "description": "Background"
+        "name": "--radio-group-direction",
+        "description": "Flex direction of the items list ('row' | 'column')"
       },
       {
-        "name": "--number-input-btn-bg",
-        "description": "Spin button background"
+        "name": "--radio-group-gap",
+        "description": "Gap between radio items"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-number-input label=\"Quantity\" value=\"1\" min=\"1\" max=\"99\" step=\"1\"></ore-number-input>\n<ore-number-input label=\"Quantity\" success></ore-number-input>\n<ore-number-input label=\"Quantity\" loading></ore-number-input>\n```"
+        "description": "```html\n<ore-radio-group name=\"plan\" label=\"Choose a plan\" value=\"free\" required>\n  <ore-radio value=\"free\">Free</ore-radio>\n  <ore-radio value=\"pro\">Pro</ore-radio>\n  <ore-radio value=\"enterprise\">Enterprise</ore-radio>\n</ore-radio-group>\n<ore-radio-group name=\"direction\" orientation=\"horizontal\" color=\"primary\">\n  <ore-radio value=\"left\">Left</ore-radio>\n  <ore-radio value=\"right\">Right</ore-radio>\n</ore-radio-group>\n```"
       }
     ]
   },
@@ -7565,396 +7767,356 @@
   },
   {
     "kind": "variable",
-    "name": "RADIO_GROUP_CTX"
-  },
-  {
-    "kind": "variable",
-    "name": "RADIO_GROUP_TAG",
+    "name": "RATING_TAG",
     "type": {
-      "text": "'ore-radio-group'"
+      "text": "'ore-rating'"
     },
-    "default": "'ore-radio-group'",
-    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management."
+    "default": "'ore-rating'",
+    "description": "A star rating input."
   },
   {
     "kind": "class",
-    "name": "OreRadioGroupElement",
-    "tagName": "ore-radio-group",
+    "name": "OreRatingElement",
+    "tagName": "ore-rating",
     "customElement": true,
-    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management.",
+    "description": "A star rating input.",
     "summary": "",
     "attributes": [
       {
         "name": "value",
         "type": {
-          "text": "string"
-        },
-        "description": "Selected value"
-      },
-      {
-        "name": "name",
-        "type": {
-          "text": "string"
+          "text": "number"
         },
-        "description": "Form field name"
+        "description": "Current rating value (default: 0)",
+        "default": "0"
       },
       {
-        "name": "label",
+        "name": "max",
         "type": {
-          "text": "string"
+          "text": "number"
         },
-        "description": "Group label"
+        "description": "Maximum number of stars (default: 5)",
+        "default": "5"
       },
       {
-        "name": "orientation",
+        "name": "readonly",
         "type": {
-          "text": "'vertical' | 'horizontal'"
+          "text": "boolean"
         },
-        "description": "Layout: 'vertical' | 'horizontal'"
+        "description": "Read-only display mode"
       },
       {
-        "name": "required",
+        "name": "disabled",
         "type": {
           "text": "boolean"
         },
-        "description": "Required field"
-      }
-    ],
-    "events": [
-      {
-        "name": "change",
-        "description": "Emitted when a radio is selected. detail: { values: string[], labels: string[], originalEvent?: Event }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Place `ore-radio` elements here"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "items",
-        "description": "Items container."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--radio-group-direction",
-        "description": "Flex direction of the items list ('row' | 'column')"
+        "description": "Disabled state"
       },
       {
-        "name": "--radio-group-gap",
-        "description": "Gap between radio items"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-radio-group name=\"plan\" label=\"Choose a plan\" value=\"free\" required>\n  <ore-radio value=\"free\">Free</ore-radio>\n  <ore-radio value=\"pro\">Pro</ore-radio>\n  <ore-radio value=\"enterprise\">Enterprise</ore-radio>\n</ore-radio-group>\n<ore-radio-group name=\"direction\" orientation=\"horizontal\" color=\"primary\">\n  <ore-radio value=\"left\">Left</ore-radio>\n  <ore-radio value=\"right\">Right</ore-radio>\n</ore-radio-group>\n```"
-      }
-    ]
-  },
-  {
-    "kind": "variable",
-    "name": "RADIO_TAG",
-    "type": {
-      "text": "'ore-radio'"
-    },
-    "default": "'ore-radio'",
-    "description": "A customizable radio button component for mutually exclusive selections."
-  },
-  {
-    "kind": "class",
-    "name": "OreRadioElement",
-    "tagName": "ore-radio",
-    "customElement": true,
-    "description": "A customizable radio button component for mutually exclusive selections.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "checked",
+        "name": "label",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "Checked state"
+        "description": "aria-label for the group (default: 'Rating')",
+        "default": "'Rating'"
       },
       {
-        "name": "disabled",
+        "name": "color",
         "type": {
-          "text": "boolean"
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
         },
-        "description": "Disable radio interaction"
+        "description": "Theme color for filled stars: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
       {
-        "name": "value",
+        "name": "size",
         "type": {
-          "text": "string"
+          "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "Field value (required for radio groups)"
+        "description": "'sm' | 'md' | 'lg'"
       },
       {
         "name": "name",
         "type": {
           "text": "string"
         },
-        "description": "Form field name (required for radio groups)"
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-        },
-        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        "description": "Form field name"
       },
       {
-        "name": "size",
+        "name": "solid",
         "type": {
-          "text": "'sm' | 'md' | 'lg'"
+          "text": "boolean"
         },
-        "description": "Radio size: 'sm' | 'md' | 'lg'"
+        "description": "Fill selected stars (outline remains default when omitted)"
       },
       {
-        "name": "error",
+        "name": "helper",
         "type": {
           "text": "string"
         },
-        "description": "Error message (marks field as invalid)"
+        "description": "Helper text below the stars"
       },
       {
-        "name": "helper",
+        "name": "error",
         "type": {
           "text": "string"
         },
-        "description": "Helper text displayed below the radio"
+        "description": "Error message below the stars"
       }
     ],
     "events": [
       {
         "name": "input",
-        "description": "Emitted when radio is selected.",
+        "description": "Emitted when the rating changes.",
         "type": {
           "text": "CustomEvent"
         }
       },
       {
         "name": "change",
-        "description": "Emitted when radio is selected.",
+        "description": "Emitted when the rating changes.",
         "type": {
           "text": "CustomEvent"
         }
       }
     ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Radio button label text"
-      }
-    ],
     "cssParts": [
       {
-        "name": "radio",
-        "description": "The radio wrapper element"
-      },
-      {
-        "name": "circle",
-        "description": "The visual radio circle"
+        "name": "stars",
+        "description": "Stars container."
       },
       {
-        "name": "label",
-        "description": "The label element"
+        "name": "star",
+        "description": "Star item element."
       },
       {
         "name": "helper-text",
-        "description": "The helper/error text element"
+        "description": "The helper/error text element."
       }
     ],
     "cssProperties": [
       {
-        "name": "--radio-size",
-        "description": "Control size (width and height)"
-      },
-      {
-        "name": "--radio-bg",
-        "description": "Unchecked background color"
-      },
-      {
-        "name": "--radio-border-color",
-        "description": "Unchecked border color"
+        "name": "--rating-star-size",
+        "description": "Star diameter"
       },
       {
-        "name": "--radio-checked-bg",
-        "description": "Selected indicator background color"
+        "name": "--rating-color-empty",
+        "description": "Empty star color"
       },
       {
-        "name": "--radio-color",
-        "description": "Selected indicator dot color"
+        "name": "--rating-color-filled",
+        "description": "Filled star color"
       },
       {
-        "name": "--radio-font-size",
-        "description": "Label font size"
+        "name": "--rating-gap",
+        "description": "Gap between stars"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-radio name=\"plan\" value=\"free\">Free</ore-radio>\n<ore-radio name=\"plan\" value=\"pro\" checked color=\"primary\">Pro</ore-radio>\n<ore-radio name=\"plan\" value=\"enterprise\" disabled>Enterprise</ore-radio>\n```"
+        "description": "```html\n<ore-rating value=\"3\" max=\"5\" color=\"warning\"></ore-rating>\n<ore-rating value=\"4\" solid></ore-rating>\n```"
       }
     ]
   },
   {
     "kind": "variable",
-    "name": "RATING_TAG",
+    "name": "SELECT_TAG",
     "type": {
-      "text": "'ore-rating'"
+      "text": "'ore-select'"
     },
-    "default": "'ore-rating'",
-    "description": "A star rating input."
+    "default": "'ore-select'",
+    "description": "A fully custom form-associated select dropdown with keyboard navigation and ARIA support.\nReads `<option>` and `<optgroup>` children from the default slot."
   },
   {
     "kind": "class",
-    "name": "OreRatingElement",
-    "tagName": "ore-rating",
+    "name": "OreSelectElement",
+    "tagName": "ore-select",
     "customElement": true,
-    "description": "A star rating input.",
+    "description": "A fully custom form-associated select dropdown with keyboard navigation and ARIA support.\nReads `<option>` and `<optgroup>` children from the default slot.",
     "summary": "",
     "attributes": [
       {
-        "name": "value",
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Label text"
+      },
+      {
+        "name": "label-placement",
+        "type": {
+          "text": "'inset' | 'outside'"
+        },
+        "description": "'inset' | 'outside'"
+      },
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Current selected value(s) (comma-separated for multiple)"
+      },
+      {
+        "name": "placeholder",
         "type": {
-          "text": "number"
+          "text": "string"
         },
-        "description": "Current rating value (default: 0)",
-        "default": "0"
+        "description": "Placeholder when no option selected"
       },
       {
-        "name": "max",
+        "name": "name",
         "type": {
-          "text": "number"
+          "text": "string"
         },
-        "description": "Maximum number of stars (default: 5)",
-        "default": "5"
+        "description": "Form field name"
       },
       {
-        "name": "readonly",
+        "name": "multiple",
         "type": {
           "text": "boolean"
         },
-        "description": "Read-only display mode"
+        "description": "Enable multi-select"
       },
       {
         "name": "disabled",
         "type": {
           "text": "boolean"
         },
-        "description": "Disabled state"
+        "description": "Disable the select"
       },
       {
-        "name": "label",
+        "name": "required",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Required field"
+      },
+      {
+        "name": "helper",
         "type": {
           "text": "string"
         },
-        "description": "aria-label for the group (default: 'Rating')",
-        "default": "'Rating'"
+        "description": "Helper text below the select"
       },
       {
-        "name": "color",
+        "name": "error",
         "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+          "text": "string"
         },
-        "description": "Theme color for filled stars: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        "description": "Error message"
       },
       {
-        "name": "size",
+        "name": "success",
         "type": {
-          "text": "'sm' | 'md' | 'lg'"
+          "text": "boolean"
         },
-        "description": "'sm' | 'md' | 'lg'"
+        "description": "Show an inline success check icon (suppressed while `error` is set)"
       },
       {
-        "name": "name",
+        "name": "color",
         "type": {
-          "text": "string"
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
         },
-        "description": "Form field name"
+        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
       {
-        "name": "solid",
+        "name": "variant",
         "type": {
-          "text": "boolean"
+          "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text'"
         },
-        "description": "Fill selected stars (outline remains default when omitted)"
+        "description": "Visual variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text'"
       },
       {
-        "name": "helper",
+        "name": "size",
         "type": {
-          "text": "string"
+          "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "Helper text below the stars"
+        "description": "Component size: 'sm' | 'md' | 'lg'"
       },
       {
-        "name": "error",
+        "name": "rounded",
         "type": {
-          "text": "string"
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
         },
-        "description": "Error message below the stars"
+        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+      },
+      {
+        "name": "fullwidth",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Expand to full width"
       }
     ],
     "events": [
       {
         "name": "input",
-        "description": "Emitted when the rating changes.",
+        "description": "Fired when selection changes.",
         "type": {
           "text": "CustomEvent"
         }
       },
       {
         "name": "change",
-        "description": "Emitted when the rating changes.",
+        "description": "Fired when selection changes.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "open-change",
+        "description": "Fired when the dropdown state changes. detail: { open, reason }",
         "type": {
           "text": "CustomEvent"
         }
       }
     ],
-    "cssParts": [
+    "slots": [
       {
-        "name": "stars",
-        "description": "Stars container."
-      },
+        "name": "",
+        "description": "`<option>` and `<optgroup>` elements"
+      }
+    ],
+    "cssParts": [
       {
-        "name": "star",
-        "description": "Star item element."
+        "name": "trigger",
+        "description": "The `ore-input` trigger element that opens the dropdown."
       },
       {
-        "name": "helper-text",
-        "description": "The helper/error text element."
+        "name": "dropdown",
+        "description": "The dropdown listbox panel container."
       }
     ],
     "cssProperties": [
       {
-        "name": "--rating-star-size",
-        "description": "Star diameter"
+        "name": "--select-bg",
+        "description": "Background"
       },
       {
-        "name": "--rating-color-empty",
-        "description": "Empty star color"
+        "name": "--select-border-color",
+        "description": "Border color"
       },
       {
-        "name": "--rating-color-filled",
-        "description": "Filled star color"
+        "name": "--select-radius",
+        "description": "Border radius"
       },
       {
-        "name": "--rating-gap",
-        "description": "Gap between stars"
+        "name": "--select-padding",
+        "description": "Padding"
+      },
+      {
+        "name": "--select-font-size",
+        "description": "Font size"
+      },
+      {
+        "name": "--select-placeholder-color",
+        "description": "Placeholder text color"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-rating value=\"3\" max=\"5\" color=\"warning\"></ore-rating>\n<ore-rating value=\"4\" solid></ore-rating>\n```"
+        "description": "```html\n<ore-select label=\"Role\" value=\"admin\">\n  <option value=\"admin\">Administrator</option>\n  <option value=\"editor\">Editor</option>\n  <option value=\"viewer\">Viewer</option>\n</ore-select>\n<ore-select label=\"Tags\" multiple color=\"primary\">\n  <optgroup label=\"Frontend\">\n    <option value=\"react\">React</option>\n    <option value=\"vue\">Vue</option>\n  </optgroup>\n  <optgroup label=\"Backend\">\n    <option value=\"node\">Node.js</option>\n  </optgroup>\n</ore-select>\n```"
       }
     ]
   },
@@ -8444,97 +8606,48 @@
   },
   {
     "kind": "variable",
-    "name": "SELECT_TAG",
+    "name": "SWITCH_TAG",
     "type": {
-      "text": "'ore-select'"
+      "text": "'ore-switch'"
     },
-    "default": "'ore-select'",
-    "description": "A fully custom form-associated select dropdown with keyboard navigation and ARIA support.\nReads `<option>` and `<optgroup>` children from the default slot."
+    "default": "'ore-switch'",
+    "description": "A toggle switch component for binary on/off states."
   },
   {
     "kind": "class",
-    "name": "OreSelectElement",
-    "tagName": "ore-select",
+    "name": "OreSwitchElement",
+    "tagName": "ore-switch",
     "customElement": true,
-    "description": "A fully custom form-associated select dropdown with keyboard navigation and ARIA support.\nReads `<option>` and `<optgroup>` children from the default slot.",
+    "description": "A toggle switch component for binary on/off states.",
     "summary": "",
     "attributes": [
       {
-        "name": "label",
-        "type": {
-          "text": "string"
-        },
-        "description": "Label text"
-      },
-      {
-        "name": "label-placement",
-        "type": {
-          "text": "'inset' | 'outside'"
-        },
-        "description": "'inset' | 'outside'"
-      },
-      {
-        "name": "value",
-        "type": {
-          "text": "string"
-        },
-        "description": "Current selected value(s) (comma-separated for multiple)"
-      },
-      {
-        "name": "placeholder",
-        "type": {
-          "text": "string"
-        },
-        "description": "Placeholder when no option selected"
-      },
-      {
-        "name": "name",
-        "type": {
-          "text": "string"
-        },
-        "description": "Form field name"
-      },
-      {
-        "name": "multiple",
+        "name": "checked",
         "type": {
           "text": "boolean"
         },
-        "description": "Enable multi-select"
+        "description": "Checked/on state"
       },
       {
         "name": "disabled",
         "type": {
           "text": "boolean"
         },
-        "description": "Disable the select"
-      },
-      {
-        "name": "required",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Required field"
+        "description": "Disable switch interaction"
       },
       {
-        "name": "helper",
+        "name": "value",
         "type": {
           "text": "string"
         },
-        "description": "Helper text below the select"
+        "description": "Field value"
       },
       {
-        "name": "error",
+        "name": "name",
         "type": {
           "text": "string"
         },
-        "description": "Error message"
-      },
-      {
-        "name": "success",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Show an inline success check icon (suppressed while `error` is set)"
+        "description": "Form field name"
       },
       {
         "name": "color",
@@ -8543,53 +8656,39 @@
         },
         "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
-      {
-        "name": "variant",
-        "type": {
-          "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text'"
-        },
-        "description": "Visual variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'text'"
-      },
       {
         "name": "size",
         "type": {
           "text": "'sm' | 'md' | 'lg'"
         },
-        "description": "Component size: 'sm' | 'md' | 'lg'"
+        "description": "Switch size: 'sm' | 'md' | 'lg'"
       },
       {
-        "name": "rounded",
+        "name": "error",
         "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+          "text": "string"
         },
-        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+        "description": "Error message (marks field as invalid)"
       },
       {
-        "name": "fullwidth",
+        "name": "helper",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "Expand to full width"
+        "description": "Helper text displayed below the switch"
       }
     ],
     "events": [
       {
         "name": "input",
-        "description": "Fired when selection changes.",
+        "description": "Emitted when switch is toggled.",
         "type": {
           "text": "CustomEvent"
         }
       },
       {
         "name": "change",
-        "description": "Fired when selection changes.",
-        "type": {
-          "text": "CustomEvent"
-        }
-      },
-      {
-        "name": "open-change",
-        "description": "Fired when the dropdown state changes. detail: { open, reason }",
+        "description": "Emitted when switch is toggled.",
         "type": {
           "text": "CustomEvent"
         }
@@ -8597,50 +8696,62 @@
     ],
     "slots": [
       {
-        "name": "",
-        "description": "`<option>` and `<optgroup>` elements"
-      }
-    ],
-    "cssParts": [
+        "name": "",
+        "description": "Switch label text"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "switch",
+        "description": "The switch wrapper element"
+      },
+      {
+        "name": "track",
+        "description": "The switch track element"
+      },
+      {
+        "name": "thumb",
+        "description": "The switch thumb element"
+      },
       {
-        "name": "trigger",
-        "description": "The `ore-input` trigger element that opens the dropdown."
+        "name": "label",
+        "description": "The label element"
       },
       {
-        "name": "dropdown",
-        "description": "The dropdown listbox panel container."
+        "name": "helper-text",
+        "description": "The helper/error text element"
       }
     ],
     "cssProperties": [
       {
-        "name": "--select-bg",
-        "description": "Background"
+        "name": "--switch-width",
+        "description": "Track width"
       },
       {
-        "name": "--select-border-color",
-        "description": "Border color"
+        "name": "--switch-height",
+        "description": "Track height"
       },
       {
-        "name": "--select-radius",
-        "description": "Border radius"
+        "name": "--switch-track-bg",
+        "description": "Inactive track background color"
       },
       {
-        "name": "--select-padding",
-        "description": "Padding"
+        "name": "--switch-checked-bg",
+        "description": "Active/checked track background color"
       },
       {
-        "name": "--select-font-size",
-        "description": "Font size"
+        "name": "--switch-thumb-bg",
+        "description": "Thumb background color"
       },
       {
-        "name": "--select-placeholder-color",
-        "description": "Placeholder text color"
+        "name": "--switch-font-size",
+        "description": "Label font size"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-select label=\"Role\" value=\"admin\">\n  <option value=\"admin\">Administrator</option>\n  <option value=\"editor\">Editor</option>\n  <option value=\"viewer\">Viewer</option>\n</ore-select>\n<ore-select label=\"Tags\" multiple color=\"primary\">\n  <optgroup label=\"Frontend\">\n    <option value=\"react\">React</option>\n    <option value=\"vue\">Vue</option>\n  </optgroup>\n  <optgroup label=\"Backend\">\n    <option value=\"node\">Node.js</option>\n  </optgroup>\n</ore-select>\n```"
+        "description": "```html\n<ore-switch name=\"notifications\" checked color=\"primary\">Enable notifications</ore-switch>\n<ore-switch name=\"darkMode\" size=\"sm\">Dark mode</ore-switch>\n<ore-switch disabled helper=\"Contact admin to change\">Admin only</ore-switch>\n```"
       }
     ]
   },
@@ -8930,122 +9041,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "BOX_TAG",
-    "type": {
-      "text": "'ore-box'"
-    },
-    "default": "'ore-box'",
-    "description": "ore-box — A foundational layout primitive with theming support."
-  },
-  {
-    "kind": "class",
-    "name": "OreBoxElement",
-    "tagName": "ore-box",
-    "customElement": true,
-    "description": "ore-box — A foundational layout primitive with theming support.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "variant",
-        "type": {
-          "text": "'solid' | 'flat' | 'glass' | 'frost'"
-        },
-        "description": "Style variant: 'solid' | 'flat' | 'glass' | 'frost'"
-      },
-      {
-        "name": "color",
-        "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-        },
-        "description": "Color theme: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-      },
-      {
-        "name": "padding",
-        "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
-        },
-        "description": "Padding size: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
-      },
-      {
-        "name": "elevation",
-        "type": {
-          "text": "'0' | '1' | '2' | '3' | '4' | '5'"
-        },
-        "description": "Shadow elevation: '0' | '1' | '2' | '3' | '4' | '5'"
-      },
-      {
-        "name": "rounded",
-        "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
-        },
-        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
-      },
-      {
-        "name": "effect",
-        "type": {
-          "text": "string"
-        },
-        "description": "Animated border effect: 'rainbow'"
-      },
-      {
-        "name": "fullwidth",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Expand to full width"
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Default slot for content"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "box",
-        "description": "The inner box element"
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--box-bg",
-        "description": "Background color"
-      },
-      {
-        "name": "--box-color",
-        "description": "Text color"
-      },
-      {
-        "name": "--box-border",
-        "description": "Border width"
-      },
-      {
-        "name": "--box-border-color",
-        "description": "Border color"
-      },
-      {
-        "name": "--box-radius",
-        "description": "Border radius"
-      },
-      {
-        "name": "--box-padding",
-        "description": "Inner padding"
-      },
-      {
-        "name": "--box-shadow",
-        "description": "Box shadow"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-box padding=\"lg\" elevation=\"2\">Simple content</ore-box>\n<ore-box variant=\"glass\" color=\"primary\">Glass effect</ore-box>\n<ore-box variant=\"frost\" effect=\"rainbow\">Frosted glass</ore-box>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "TIME_PICKER_TAG",
@@ -9279,152 +9274,117 @@
   },
   {
     "kind": "variable",
-    "name": "SWITCH_TAG",
+    "name": "BOX_TAG",
     "type": {
-      "text": "'ore-switch'"
+      "text": "'ore-box'"
     },
-    "default": "'ore-switch'",
-    "description": "A toggle switch component for binary on/off states."
+    "default": "'ore-box'",
+    "description": "ore-box — A foundational layout primitive with theming support."
   },
   {
     "kind": "class",
-    "name": "OreSwitchElement",
-    "tagName": "ore-switch",
+    "name": "OreBoxElement",
+    "tagName": "ore-box",
     "customElement": true,
-    "description": "A toggle switch component for binary on/off states.",
+    "description": "ore-box — A foundational layout primitive with theming support.",
     "summary": "",
     "attributes": [
       {
-        "name": "checked",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Checked/on state"
-      },
-      {
-        "name": "disabled",
+        "name": "variant",
         "type": {
-          "text": "boolean"
+          "text": "'solid' | 'flat' | 'glass' | 'frost'"
         },
-        "description": "Disable switch interaction"
+        "description": "Style variant: 'solid' | 'flat' | 'glass' | 'frost'"
       },
       {
-        "name": "value",
+        "name": "color",
         "type": {
-          "text": "string"
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
         },
-        "description": "Field value"
+        "description": "Color theme: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
       },
       {
-        "name": "name",
+        "name": "padding",
         "type": {
-          "text": "string"
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
         },
-        "description": "Form field name"
+        "description": "Padding size: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
       },
       {
-        "name": "color",
+        "name": "elevation",
         "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+          "text": "'0' | '1' | '2' | '3' | '4' | '5'"
         },
-        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        "description": "Shadow elevation: '0' | '1' | '2' | '3' | '4' | '5'"
       },
       {
-        "name": "size",
+        "name": "rounded",
         "type": {
-          "text": "'sm' | 'md' | 'lg'"
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
         },
-        "description": "Switch size: 'sm' | 'md' | 'lg'"
+        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
       },
       {
-        "name": "error",
+        "name": "effect",
         "type": {
           "text": "string"
         },
-        "description": "Error message (marks field as invalid)"
+        "description": "Animated border effect: 'rainbow'"
       },
       {
-        "name": "helper",
+        "name": "fullwidth",
         "type": {
-          "text": "string"
+          "text": "boolean"
         },
-        "description": "Helper text displayed below the switch"
-      }
-    ],
-    "events": [
-      {
-        "name": "input",
-        "description": "Emitted when switch is toggled.",
-        "type": {
-          "text": "CustomEvent"
-        }
-      },
-      {
-        "name": "change",
-        "description": "Emitted when switch is toggled.",
-        "type": {
-          "text": "CustomEvent"
-        }
+        "description": "Expand to full width"
       }
     ],
     "slots": [
       {
         "name": "",
-        "description": "Switch label text"
+        "description": "Default slot for content"
       }
     ],
     "cssParts": [
       {
-        "name": "switch",
-        "description": "The switch wrapper element"
-      },
-      {
-        "name": "track",
-        "description": "The switch track element"
-      },
-      {
-        "name": "thumb",
-        "description": "The switch thumb element"
-      },
-      {
-        "name": "label",
-        "description": "The label element"
-      },
-      {
-        "name": "helper-text",
-        "description": "The helper/error text element"
+        "name": "box",
+        "description": "The inner box element"
       }
     ],
     "cssProperties": [
       {
-        "name": "--switch-width",
-        "description": "Track width"
+        "name": "--box-bg",
+        "description": "Background color"
       },
       {
-        "name": "--switch-height",
-        "description": "Track height"
+        "name": "--box-color",
+        "description": "Text color"
       },
       {
-        "name": "--switch-track-bg",
-        "description": "Inactive track background color"
+        "name": "--box-border",
+        "description": "Border width"
       },
       {
-        "name": "--switch-checked-bg",
-        "description": "Active/checked track background color"
+        "name": "--box-border-color",
+        "description": "Border color"
       },
       {
-        "name": "--switch-thumb-bg",
-        "description": "Thumb background color"
+        "name": "--box-radius",
+        "description": "Border radius"
       },
       {
-        "name": "--switch-font-size",
-        "description": "Label font size"
+        "name": "--box-padding",
+        "description": "Inner padding"
+      },
+      {
+        "name": "--box-shadow",
+        "description": "Box shadow"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-switch name=\"notifications\" checked color=\"primary\">Enable notifications</ore-switch>\n<ore-switch name=\"darkMode\" size=\"sm\">Dark mode</ore-switch>\n<ore-switch disabled helper=\"Contact admin to change\">Admin only</ore-switch>\n```"
+        "description": "```html\n<ore-box padding=\"lg\" elevation=\"2\">Simple content</ore-box>\n<ore-box variant=\"glass\" color=\"primary\">Glass effect</ore-box>\n<ore-box variant=\"frost\" effect=\"rainbow\">Frosted glass</ore-box>\n```"
       }
     ]
   },
@@ -9630,98 +9590,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "GRID_ITEM_TAG",
-    "type": {
-      "text": "'ore-grid-item'"
-    },
-    "default": "'ore-grid-item'",
-    "description": "ore-grid-item — A grid cell with declarative placement and span control.\n\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines)."
-  },
-  {
-    "kind": "class",
-    "name": "OreGridItemElement",
-    "tagName": "ore-grid-item",
-    "customElement": true,
-    "description": "ore-grid-item — A grid cell with declarative placement and span control.\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines).",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "area",
-        "type": {
-          "text": "string"
-        },
-        "description": "CSS grid-area value for named-area placement"
-      },
-      {
-        "name": "col-span",
-        "type": {
-          "text": "'12' | 'full'"
-        },
-        "description": "Columns to span: '1'–'12' | 'full'"
-      },
-      {
-        "name": "row-span",
-        "type": {
-          "text": "'6' | 'full'"
-        },
-        "description": "Rows to span: '1'–'6' | 'full'"
-      },
-      {
-        "name": "col",
-        "type": {
-          "text": "string"
-        },
-        "description": "CSS grid-column value (overrides col-span)"
-      },
-      {
-        "name": "row",
-        "type": {
-          "text": "string"
-        },
-        "description": "CSS grid-row value (overrides row-span)"
-      },
-      {
-        "name": "align",
-        "type": {
-          "text": "'start' | 'center' | 'end' | 'stretch'"
-        },
-        "description": "align-self: 'start' | 'center' | 'end' | 'stretch'"
-      },
-      {
-        "name": "justify",
-        "type": {
-          "text": "'start' | 'center' | 'end' | 'stretch'"
-        },
-        "description": "justify-self: 'start' | 'center' | 'end' | 'stretch'"
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Grid item content"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "<!-- Span 2 columns -->\n<ore-grid-item col-span=\"2\">Wide</ore-grid-item>"
-      },
-      {
-        "url": "",
-        "description": "<!-- Full-width row -->\n<ore-grid-item col-span=\"full\">Banner</ore-grid-item>"
-      },
-      {
-        "url": "",
-        "description": "<!-- Named area placement -->\n<ore-grid-item area=\"sidebar\">Nav</ore-grid-item>"
-      },
-      {
-        "url": "",
-        "description": "<!-- Explicit placement -->\n<ore-grid-item col=\"2 / 5\" row=\"1 / 3\">Placed</ore-grid-item>"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "NAVBAR_CTX",
@@ -10353,75 +10221,167 @@
         "description": "Anchor `rel` attribute (links only)"
       },
       {
-        "name": "target",
+        "name": "target",
+        "type": {
+          "text": "string"
+        },
+        "description": "Anchor `target` attribute (links only)"
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Label text"
+      },
+      {
+        "name": "icon",
+        "description": "Leading icon"
+      },
+      {
+        "name": "end",
+        "description": "Trailing content (badge, shortcut, arrow, etc.)"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "item",
+        "description": "The inner anchor or button element"
+      },
+      {
+        "name": "item-icon",
+        "description": "The icon wrapper"
+      },
+      {
+        "name": "item-label",
+        "description": "The label wrapper"
+      },
+      {
+        "name": "item-end",
+        "description": "The trailing content wrapper"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--sidebar-item-color",
+        "description": "Default text color"
+      },
+      {
+        "name": "--sidebar-item-hover-bg",
+        "description": "Hover background"
+      },
+      {
+        "name": "--sidebar-item-hover-color",
+        "description": "Hover text color"
+      },
+      {
+        "name": "--sidebar-item-active-bg",
+        "description": "Active background"
+      },
+      {
+        "name": "--sidebar-item-active-color",
+        "description": "Active text color"
+      },
+      {
+        "name": "--sidebar-item-indicator",
+        "description": "Active indicator bar color"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-sidebar-item href=\"/dashboard\" active>\n  <span slot=\"icon\">🏠</span>\n  Dashboard\n</ore-sidebar-item>\n<ore-sidebar-item href=\"/users\">\n  <span slot=\"icon\">👤</span>\n  Users\n  <ore-badge slot=\"end\" color=\"primary\">3</ore-badge>\n</ore-sidebar-item>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "GRID_ITEM_TAG",
+    "type": {
+      "text": "'ore-grid-item'"
+    },
+    "default": "'ore-grid-item'",
+    "description": "ore-grid-item — A grid cell with declarative placement and span control.\n\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines)."
+  },
+  {
+    "kind": "class",
+    "name": "OreGridItemElement",
+    "tagName": "ore-grid-item",
+    "customElement": true,
+    "description": "ore-grid-item — A grid cell with declarative placement and span control.\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines).",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "area",
+        "type": {
+          "text": "string"
+        },
+        "description": "CSS grid-area value for named-area placement"
+      },
+      {
+        "name": "col-span",
+        "type": {
+          "text": "'12' | 'full'"
+        },
+        "description": "Columns to span: '1'–'12' | 'full'"
+      },
+      {
+        "name": "row-span",
+        "type": {
+          "text": "'6' | 'full'"
+        },
+        "description": "Rows to span: '1'–'6' | 'full'"
+      },
+      {
+        "name": "col",
+        "type": {
+          "text": "string"
+        },
+        "description": "CSS grid-column value (overrides col-span)"
+      },
+      {
+        "name": "row",
+        "type": {
+          "text": "string"
+        },
+        "description": "CSS grid-row value (overrides row-span)"
+      },
+      {
+        "name": "align",
+        "type": {
+          "text": "'start' | 'center' | 'end' | 'stretch'"
+        },
+        "description": "align-self: 'start' | 'center' | 'end' | 'stretch'"
+      },
+      {
+        "name": "justify",
         "type": {
-          "text": "string"
+          "text": "'start' | 'center' | 'end' | 'stretch'"
         },
-        "description": "Anchor `target` attribute (links only)"
+        "description": "justify-self: 'start' | 'center' | 'end' | 'stretch'"
       }
     ],
     "slots": [
       {
         "name": "",
-        "description": "Label text"
-      },
-      {
-        "name": "icon",
-        "description": "Leading icon"
-      },
-      {
-        "name": "end",
-        "description": "Trailing content (badge, shortcut, arrow, etc.)"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "item",
-        "description": "The inner anchor or button element"
-      },
-      {
-        "name": "item-icon",
-        "description": "The icon wrapper"
-      },
-      {
-        "name": "item-label",
-        "description": "The label wrapper"
-      },
-      {
-        "name": "item-end",
-        "description": "The trailing content wrapper"
+        "description": "Grid item content"
       }
     ],
-    "cssProperties": [
-      {
-        "name": "--sidebar-item-color",
-        "description": "Default text color"
-      },
-      {
-        "name": "--sidebar-item-hover-bg",
-        "description": "Hover background"
-      },
+    "demos": [
       {
-        "name": "--sidebar-item-hover-color",
-        "description": "Hover text color"
+        "url": "",
+        "description": "<!-- Span 2 columns -->\n<ore-grid-item col-span=\"2\">Wide</ore-grid-item>"
       },
       {
-        "name": "--sidebar-item-active-bg",
-        "description": "Active background"
+        "url": "",
+        "description": "<!-- Full-width row -->\n<ore-grid-item col-span=\"full\">Banner</ore-grid-item>"
       },
       {
-        "name": "--sidebar-item-active-color",
-        "description": "Active text color"
+        "url": "",
+        "description": "<!-- Named area placement -->\n<ore-grid-item area=\"sidebar\">Nav</ore-grid-item>"
       },
-      {
-        "name": "--sidebar-item-indicator",
-        "description": "Active indicator bar color"
-      }
-    ],
-    "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-sidebar-item href=\"/dashboard\" active>\n  <span slot=\"icon\">🏠</span>\n  Dashboard\n</ore-sidebar-item>\n<ore-sidebar-item href=\"/users\">\n  <span slot=\"icon\">👤</span>\n  Users\n  <ore-badge slot=\"end\" color=\"primary\">3</ore-badge>\n</ore-sidebar-item>\n```"
+        "description": "<!-- Explicit placement -->\n<ore-grid-item col=\"2 / 5\" row=\"1 / 3\">Placed</ore-grid-item>"
       }
     ]
   },
@@ -10812,18 +10772,212 @@
         "description": "Show a close (×) button in the header"
       },
       {
-        "name": "persistent",
+        "name": "persistent",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Prevent backdrop-click from closing"
+      },
+      {
+        "name": "rounded",
+        "type": {
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+        },
+        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+      },
+      {
+        "name": "backdrop",
+        "type": {
+          "text": "'blur' | 'transparent'"
+        },
+        "description": "Backdrop style: 'opaque' (default) | 'blur' | 'transparent'"
+      },
+      {
+        "name": "elevation",
+        "type": {
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'"
+        },
+        "description": "Panel shadow: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'"
+      },
+      {
+        "name": "padding",
+        "type": {
+          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
+        },
+        "description": "Padding: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
+      }
+    ],
+    "events": [
+      {
+        "name": "open-change",
+        "description": "Fired when the dialog state changes. detail: { open, reason }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Dialog body content"
+      },
+      {
+        "name": "header",
+        "description": "Custom header content (replaces the default title + close layout)"
+      },
+      {
+        "name": "footer",
+        "description": "Action buttons or additional content at the bottom"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "dialog",
+        "description": "Dialog root container."
+      },
+      {
+        "name": "overlay",
+        "description": "Overlay backdrop element."
+      },
+      {
+        "name": "panel",
+        "description": "Panel container."
+      },
+      {
+        "name": "header",
+        "description": "Header container."
+      },
+      {
+        "name": "title",
+        "description": "Title text element."
+      },
+      {
+        "name": "close",
+        "description": "Close action control."
+      },
+      {
+        "name": "body",
+        "description": "Body content container."
+      },
+      {
+        "name": "footer",
+        "description": "Footer container."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--dialog-bg",
+        "description": "Panel background color"
+      },
+      {
+        "name": "--dialog-border-color",
+        "description": "Panel border color"
+      },
+      {
+        "name": "--dialog-radius",
+        "description": "Panel border radius"
+      },
+      {
+        "name": "--dialog-shadow",
+        "description": "Panel drop shadow"
+      },
+      {
+        "name": "--dialog-padding",
+        "description": "Padding for header, body, and footer sections"
+      },
+      {
+        "name": "--dialog-gap",
+        "description": "Gap between footer action buttons"
+      },
+      {
+        "name": "--dialog-backdrop",
+        "description": "Backdrop overlay color"
+      },
+      {
+        "name": "--dialog-max-width",
+        "description": "Maximum panel width (overridden by size prop)"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-dialog label=\"Confirm action\" dismissible>\n  <p>Are you sure you want to delete this item?</p>\n  <div slot=\"footer\">\n    <ore-button variant=\"ghost\" id=\"cancel\">Cancel</ore-button>\n    <ore-button color=\"error\" id=\"confirm\">Delete</ore-button>\n  </div>\n</ore-dialog>\n<script type=\"module\">\n  import '@vielzeug/refine/dialog';\n  const dialog = document.querySelector('ore-dialog');\n  document.querySelector('#open-btn').addEventListener('click', () => {\n    dialog.setAttribute('open', '');\n  });\n  document.querySelector('#cancel').addEventListener('click', () => {\n    dialog.removeAttribute('open');\n  });\n</script>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "DRAWER_TAG",
+    "type": {
+      "text": "'ore-drawer'"
+    },
+    "default": "'ore-drawer'",
+    "description": "A panel that slides in from any edge of the screen, built on the native `<dialog>` element."
+  },
+  {
+    "kind": "class",
+    "name": "OreDrawerElement",
+    "tagName": "ore-drawer",
+    "customElement": true,
+    "description": "A panel that slides in from any edge of the screen, built on the native `<dialog>` element.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "open",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Controlled open state"
+      },
+      {
+        "name": "default-open",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Initial uncontrolled open state"
+      },
+      {
+        "name": "placement",
+        "type": {
+          "text": "'left' | 'right'"
+        },
+        "description": "'left' | 'right' (default) | 'top' | 'bottom'"
+      },
+      {
+        "name": "size",
+        "type": {
+          "text": "'sm' | 'lg' | 'full'"
+        },
+        "description": "'sm' | 'lg' | 'full'"
+      },
+      {
+        "name": "title",
+        "type": {
+          "text": "string"
+        },
+        "description": "Visible header title text"
+      },
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Invisible aria-label (for drawers without a visible title)"
+      },
+      {
+        "name": "dismissible",
         "type": {
           "text": "boolean"
         },
-        "description": "Prevent backdrop-click from closing"
+        "description": "Show the close (×) button (default: true)",
+        "default": "true"
       },
       {
-        "name": "rounded",
+        "name": "drag-handle-placement",
         "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+          "text": "string"
         },
-        "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+        "description": "'outside' (default) | 'inset'"
       },
       {
         "name": "backdrop",
@@ -10833,24 +10987,18 @@
         "description": "Backdrop style: 'opaque' (default) | 'blur' | 'transparent'"
       },
       {
-        "name": "elevation",
-        "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'"
-        },
-        "description": "Panel shadow: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl'"
-      },
-      {
-        "name": "padding",
+        "name": "persistent",
         "type": {
-          "text": "'none' | 'sm' | 'md' | 'lg' | 'xl'"
+          "text": "boolean"
         },
-        "description": "Padding: 'none' | 'sm' | 'md' | 'lg' | 'xl'"
+        "description": "Prevent backdrop-click from closing (default: false)",
+        "default": "false"
       }
     ],
     "events": [
       {
         "name": "open-change",
-        "description": "Fired when the dialog state changes. detail: { open, reason }",
+        "description": "When the drawer state changes. detail: { open, reason }",
         "type": {
           "text": "CustomEvent"
         }
@@ -10858,26 +11006,22 @@
     ],
     "slots": [
       {
-        "name": "",
-        "description": "Dialog body content"
+        "name": "header",
+        "description": "Drawer header content"
       },
       {
-        "name": "header",
-        "description": "Custom header content (replaces the default title + close layout)"
+        "name": "",
+        "description": "Main body content"
       },
       {
         "name": "footer",
-        "description": "Action buttons or additional content at the bottom"
+        "description": "Drawer footer content"
       }
     ],
     "cssParts": [
       {
-        "name": "dialog",
-        "description": "Dialog root container."
-      },
-      {
-        "name": "overlay",
-        "description": "Overlay backdrop element."
+        "name": "drag-handle",
+        "description": "Drawer drag handle."
       },
       {
         "name": "panel",
@@ -10888,12 +11032,8 @@
         "description": "Header container."
       },
       {
-        "name": "title",
-        "description": "Title text element."
-      },
-      {
-        "name": "close",
-        "description": "Close action control."
+        "name": "close-btn",
+        "description": "Close button."
       },
       {
         "name": "body",
@@ -10906,42 +11046,30 @@
     ],
     "cssProperties": [
       {
-        "name": "--dialog-bg",
-        "description": "Panel background color"
-      },
-      {
-        "name": "--dialog-border-color",
-        "description": "Panel border color"
-      },
-      {
-        "name": "--dialog-radius",
-        "description": "Panel border radius"
-      },
-      {
-        "name": "--dialog-shadow",
-        "description": "Panel drop shadow"
+        "name": "--drawer-backdrop-bg",
+        "description": "Backdrop background color"
       },
       {
-        "name": "--dialog-padding",
-        "description": "Padding for header, body, and footer sections"
+        "name": "--drawer-bg",
+        "description": "Panel background color"
       },
       {
-        "name": "--dialog-gap",
-        "description": "Gap between footer action buttons"
+        "name": "--drawer-size",
+        "description": "Panel width (horizontal) or height (vertical)"
       },
       {
-        "name": "--dialog-backdrop",
-        "description": "Backdrop overlay color"
+        "name": "--drawer-shadow",
+        "description": "Panel box-shadow"
       },
       {
-        "name": "--dialog-max-width",
-        "description": "Maximum panel width (overridden by size prop)"
+        "name": "--drawer-panel-blur",
+        "description": "Panel backdrop blur amount"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-dialog label=\"Confirm action\" dismissible>\n  <p>Are you sure you want to delete this item?</p>\n  <div slot=\"footer\">\n    <ore-button variant=\"ghost\" id=\"cancel\">Cancel</ore-button>\n    <ore-button color=\"error\" id=\"confirm\">Delete</ore-button>\n  </div>\n</ore-dialog>\n<script type=\"module\">\n  import '@vielzeug/refine/dialog';\n  const dialog = document.querySelector('ore-dialog');\n  document.querySelector('#open-btn').addEventListener('click', () => {\n    dialog.setAttribute('open', '');\n  });\n  document.querySelector('#cancel').addEventListener('click', () => {\n    dialog.removeAttribute('open');\n  });\n</script>\n```"
+        "description": "```html\n<!-- With visible title -->\n<ore-drawer open title=\"Settings\" placement=\"right\">\n  <p>Settings content here.</p>\n</ore-drawer>\n<!-- With custom header slot -->\n<ore-drawer open placement=\"right\">\n  <span slot=\"header\">Settings</span>\n  <p>Settings content here.</p>\n</ore-drawer>\n```"
       }
     ]
   },
@@ -11194,174 +11322,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "DRAWER_TAG",
-    "type": {
-      "text": "'ore-drawer'"
-    },
-    "default": "'ore-drawer'",
-    "description": "A panel that slides in from any edge of the screen, built on the native `<dialog>` element."
-  },
-  {
-    "kind": "class",
-    "name": "OreDrawerElement",
-    "tagName": "ore-drawer",
-    "customElement": true,
-    "description": "A panel that slides in from any edge of the screen, built on the native `<dialog>` element.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "open",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Controlled open state"
-      },
-      {
-        "name": "default-open",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Initial uncontrolled open state"
-      },
-      {
-        "name": "placement",
-        "type": {
-          "text": "'left' | 'right'"
-        },
-        "description": "'left' | 'right' (default) | 'top' | 'bottom'"
-      },
-      {
-        "name": "size",
-        "type": {
-          "text": "'sm' | 'lg' | 'full'"
-        },
-        "description": "'sm' | 'lg' | 'full'"
-      },
-      {
-        "name": "title",
-        "type": {
-          "text": "string"
-        },
-        "description": "Visible header title text"
-      },
-      {
-        "name": "label",
-        "type": {
-          "text": "string"
-        },
-        "description": "Invisible aria-label (for drawers without a visible title)"
-      },
-      {
-        "name": "dismissible",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Show the close (×) button (default: true)",
-        "default": "true"
-      },
-      {
-        "name": "drag-handle-placement",
-        "type": {
-          "text": "string"
-        },
-        "description": "'outside' (default) | 'inset'"
-      },
-      {
-        "name": "backdrop",
-        "type": {
-          "text": "'blur' | 'transparent'"
-        },
-        "description": "Backdrop style: 'opaque' (default) | 'blur' | 'transparent'"
-      },
-      {
-        "name": "persistent",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Prevent backdrop-click from closing (default: false)",
-        "default": "false"
-      }
-    ],
-    "events": [
-      {
-        "name": "open-change",
-        "description": "When the drawer state changes. detail: { open, reason }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "header",
-        "description": "Drawer header content"
-      },
-      {
-        "name": "",
-        "description": "Main body content"
-      },
-      {
-        "name": "footer",
-        "description": "Drawer footer content"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "drag-handle",
-        "description": "Drawer drag handle."
-      },
-      {
-        "name": "panel",
-        "description": "Panel container."
-      },
-      {
-        "name": "header",
-        "description": "Header container."
-      },
-      {
-        "name": "close-btn",
-        "description": "Close button."
-      },
-      {
-        "name": "body",
-        "description": "Body content container."
-      },
-      {
-        "name": "footer",
-        "description": "Footer container."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--drawer-backdrop-bg",
-        "description": "Backdrop background color"
-      },
-      {
-        "name": "--drawer-bg",
-        "description": "Panel background color"
-      },
-      {
-        "name": "--drawer-size",
-        "description": "Panel width (horizontal) or height (vertical)"
-      },
-      {
-        "name": "--drawer-shadow",
-        "description": "Panel box-shadow"
-      },
-      {
-        "name": "--drawer-panel-blur",
-        "description": "Panel backdrop blur amount"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<!-- With visible title -->\n<ore-drawer open title=\"Settings\" placement=\"right\">\n  <p>Settings content here.</p>\n</ore-drawer>\n<!-- With custom header slot -->\n<ore-drawer open placement=\"right\">\n  <span slot=\"header\">Settings</span>\n  <p>Settings content here.</p>\n</ore-drawer>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "NAVIGATION_MENU_ITEM_TAG",