@vielzeug/refine 26.10.7 → 26.10.10

package/dist/custom-elements.json

@@ -1618,7 +1618,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ color: prop.string<ThemeColor>(), }",
+          "default": "{ color: prop.oneOf(THEME_COLORS), }",
           "description": "Prop bundle for components that support a theme colour."
         },
         {
@@ -1627,7 +1627,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ size: prop.string<ComponentSize>(), }",
+          "default": "{ size: prop.oneOf(COMPONENT_SIZES), }",
           "description": "Prop bundle for components with discrete size variants."
         },
         {
@@ -1654,7 +1654,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ rounded: prop.string<RoundedSize>(), }",
+          "default": "{ rounded: prop.oneOf(ROUNDED_SIZES), }",
           "description": "Prop bundle for components with configurable border-radius."
         },
         {
@@ -1663,7 +1663,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ elevation: prop.number<ElevationLevel>(), }",
+          "default": "{ elevation: prop.oneOf(ELEVATION_LEVELS), }",
           "description": "Prop bundle for components with an elevation / box-shadow."
         },
         {
@@ -1870,7 +1870,116 @@
     {
       "kind": "javascript-module",
       "path": "src/shared/types.ts",
-      "declarations": [],
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "COMPONENT_SIZES",
+          "type": {
+            "text": "['sm', 'md', 'lg']"
+          },
+          "default": "['sm', 'md', 'lg']",
+          "description": "Component size variants"
+        },
+        {
+          "kind": "variable",
+          "name": "THEME_COLORS",
+          "type": {
+            "text": "['primary', 'secondary', 'info', 'success', 'warning', 'error']"
+          },
+          "default": "['primary', 'secondary', 'info', 'success', 'warning', 'error']",
+          "description": "Semantic theme colors"
+        },
+        {
+          "kind": "variable",
+          "name": "VISUAL_VARIANTS",
+          "type": {
+            "text": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text', 'frost']"
+          },
+          "default": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text', 'frost']",
+          "description": "Visual variant styles"
+        },
+        {
+          "kind": "variable",
+          "name": "FIELD_VARIANTS",
+          "type": {
+            "text": "['flat', 'solid', 'bordered', 'outline', 'ghost']"
+          },
+          "default": "['flat', 'solid', 'bordered', 'outline', 'ghost']",
+          "description": "Variant set accepted by text-field-style inputs (everything except `text` and `frost`)."
+        },
+        {
+          "kind": "variable",
+          "name": "INPUT_VARIANTS",
+          "type": {
+            "text": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text']"
+          },
+          "default": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text']",
+          "description": "Variant set accepted by input/select-style fields (everything except `frost`)."
+        },
+        {
+          "kind": "variable",
+          "name": "DENSITY_LEVELS",
+          "type": {
+            "text": "['compact', 'cozy', 'comfortable']"
+          },
+          "default": "['compact', 'cozy', 'comfortable']",
+          "description": "Table/grid density levels"
+        },
+        {
+          "kind": "variable",
+          "name": "ROUNDED_SIZES",
+          "type": {
+            "text": "['none', 'sm', 'md', 'lg', 'xl', '2xl', '3xl', 'full']"
+          },
+          "default": "['none', 'sm', 'md', 'lg', 'xl', '2xl', '3xl', 'full']",
+          "description": "Border radius variants"
+        },
+        {
+          "kind": "variable",
+          "name": "ELEVATION_LEVELS",
+          "type": {
+            "text": "[0, 1, 2, 3, 4, 5]"
+          },
+          "default": "[0, 1, 2, 3, 4, 5]",
+          "description": "Elevation/shadow depth levels"
+        },
+        {
+          "kind": "variable",
+          "name": "PADDING_SIZES",
+          "type": {
+            "text": "['none', 'sm', 'md', 'lg', 'xl']"
+          },
+          "default": "['none', 'sm', 'md', 'lg', 'xl']",
+          "description": "Internal spacing variants"
+        },
+        {
+          "kind": "variable",
+          "name": "BUTTON_TYPES",
+          "type": {
+            "text": "['button', 'submit', 'reset']"
+          },
+          "default": "['button', 'submit', 'reset']",
+          "description": "Button form-submission types"
+        },
+        {
+          "kind": "variable",
+          "name": "LINK_TARGETS",
+          "type": {
+            "text": "['_blank', '_self', '_parent', '_top']"
+          },
+          "default": "['_blank', '_self', '_parent', '_top']",
+          "description": "Anchor browsing-context values"
+        },
+        {
+          "kind": "variable",
+          "name": "INPUT_TYPES",
+          "type": {
+            "text": "[\n  'text',\n  'email',\n  'password',\n  'number',\n  'tel',\n  'url',\n  'search',\n  'date',\n  'time',\n  'datetime-local',\n  'month',\n  'week',\n]"
+          },
+          "default": "[ 'text', 'email', 'password', 'number', 'tel', 'url', 'search', 'date', 'time', 'datetime-local', 'month', 'week', ]",
+          "description": "Allowed HTML5 input type values for `<ore-input>`"
+        }
+      ],
       "exports": [
         {
           "kind": "js",
@@ -1879,6 +1988,102 @@
             "name": "PropsDef",
             "package": "@vielzeug/ore"
           }
+        },
+        {
+          "kind": "js",
+          "name": "COMPONENT_SIZES",
+          "declaration": {
+            "name": "COMPONENT_SIZES",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "THEME_COLORS",
+          "declaration": {
+            "name": "THEME_COLORS",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "VISUAL_VARIANTS",
+          "declaration": {
+            "name": "VISUAL_VARIANTS",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FIELD_VARIANTS",
+          "declaration": {
+            "name": "FIELD_VARIANTS",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "INPUT_VARIANTS",
+          "declaration": {
+            "name": "INPUT_VARIANTS",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "DENSITY_LEVELS",
+          "declaration": {
+            "name": "DENSITY_LEVELS",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ROUNDED_SIZES",
+          "declaration": {
+            "name": "ROUNDED_SIZES",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ELEVATION_LEVELS",
+          "declaration": {
+            "name": "ELEVATION_LEVELS",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "PADDING_SIZES",
+          "declaration": {
+            "name": "PADDING_SIZES",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BUTTON_TYPES",
+          "declaration": {
+            "name": "BUTTON_TYPES",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "LINK_TARGETS",
+          "declaration": {
+            "name": "LINK_TARGETS",
+            "module": "src/shared/types.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "INPUT_TYPES",
+          "declaration": {
+            "name": "INPUT_TYPES",
+            "module": "src/shared/types.ts"
+          }
         }
       ]
     },
@@ -1968,6 +2173,14 @@
       "kind": "javascript-module",
       "path": "src/content/avatar/avatar.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "AVATAR_STATUSES",
+          "type": {
+            "text": "['online', 'offline', 'busy', 'away']"
+          },
+          "default": "['online', 'offline', 'busy', 'away']"
+        },
         {
           "kind": "variable",
           "name": "AVATAR_TAG",
@@ -2110,6 +2323,14 @@
             "module": "../icon/icon"
           }
         },
+        {
+          "kind": "js",
+          "name": "AVATAR_STATUSES",
+          "declaration": {
+            "name": "AVATAR_STATUSES",
+            "module": "src/content/avatar/avatar.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "AVATAR_TAG",
@@ -2544,6 +2765,22 @@
       "kind": "javascript-module",
       "path": "src/content/carousel/carousel.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "CAROUSEL_ORIENTATIONS",
+          "type": {
+            "text": "['horizontal', 'vertical']"
+          },
+          "default": "['horizontal', 'vertical']"
+        },
+        {
+          "kind": "variable",
+          "name": "CAROUSEL_VARIANTS",
+          "type": {
+            "text": "['default', 'fade', 'filmstrip', 'gallery']"
+          },
+          "default": "['default', 'fade', 'filmstrip', 'gallery']"
+        },
         {
           "kind": "variable",
           "name": "CAROUSEL_TAG",
@@ -2744,6 +2981,22 @@
             "module": "./carousel-slide"
           }
         },
+        {
+          "kind": "js",
+          "name": "CAROUSEL_ORIENTATIONS",
+          "declaration": {
+            "name": "CAROUSEL_ORIENTATIONS",
+            "module": "src/content/carousel/carousel.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "CAROUSEL_VARIANTS",
+          "declaration": {
+            "name": "CAROUSEL_VARIANTS",
+            "module": "src/content/carousel/carousel.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "CAROUSEL_TAG",
@@ -2766,6 +3019,14 @@
       "kind": "javascript-module",
       "path": "src/content/chat-message/chat-message.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "CHAT_MESSAGE_STATUSES",
+          "type": {
+            "text": "['error', 'sending', 'sent']"
+          },
+          "default": "['error', 'sending', 'sent']"
+        },
         {
           "kind": "variable",
           "name": "CHAT_MESSAGE_TAG",
@@ -2946,6 +3207,14 @@
             "module": "../icon/icon"
           }
         },
+        {
+          "kind": "js",
+          "name": "CHAT_MESSAGE_STATUSES",
+          "declaration": {
+            "name": "CHAT_MESSAGE_STATUSES",
+            "module": "src/content/chat-message/chat-message.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "CHAT_MESSAGE_TAG",
@@ -3581,6 +3850,14 @@
       "kind": "javascript-module",
       "path": "src/content/keyboard-key/keyboard-key.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "KEYBOARD_KEY_SIZES",
+          "type": {
+            "text": "['sm', 'lg']"
+          },
+          "default": "['sm', 'lg']"
+        },
         {
           "kind": "variable",
           "name": "KEYBOARD_SHORTCUT_TAG",
@@ -3617,6 +3894,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "KEYBOARD_KEY_SIZES",
+          "declaration": {
+            "name": "KEYBOARD_KEY_SIZES",
+            "module": "src/content/keyboard-key/keyboard-key.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "KEYBOARD_SHORTCUT_TAG",
@@ -3911,6 +4196,15 @@
       "kind": "javascript-module",
       "path": "src/content/list/list.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "LIST_VARIANTS",
+          "type": {
+            "text": "['bordered', 'plain', 'separated']"
+          },
+          "default": "['bordered', 'plain', 'separated']",
+          "description": "Visual variant for `ore-list`."
+        },
         {
           "kind": "variable",
           "name": "LIST_CTX",
@@ -3999,6 +4293,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "LIST_VARIANTS",
+          "declaration": {
+            "name": "LIST_VARIANTS",
+            "module": "src/content/list/list.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "LIST_CTX",
@@ -4029,6 +4331,14 @@
       "kind": "javascript-module",
       "path": "src/content/marquee/marquee.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "MARQUEE_DIRECTIONS",
+          "type": {
+            "text": "['left', 'right']"
+          },
+          "default": "['left', 'right']"
+        },
         {
           "kind": "variable",
           "name": "MARQUEE_TAG",
@@ -4122,6 +4432,14 @@
             "module": "../icon/icon"
           }
         },
+        {
+          "kind": "js",
+          "name": "MARQUEE_DIRECTIONS",
+          "declaration": {
+            "name": "MARQUEE_DIRECTIONS",
+            "module": "src/content/marquee/marquee.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "MARQUEE_TAG",
@@ -4337,206 +4655,74 @@
           "type": {
             "text": "'ore-qr-code'"
           },
-          "default": "'ore-qr-code'",
-          "description": "Renders a QR code for `value` as inline SVG: themeable via `currentColor`,\ncrisp at any scale, no canvas. On capacity errors the component shows an\nerror state and emits `error` rather than throwing."
+          "default": "'ore-qr-code'"
         },
         {
           "kind": "class",
           "name": "OreQrCodeElement",
           "tagName": "ore-qr-code",
           "customElement": true,
-          "description": "Renders a QR code for `value` as inline SVG: themeable via `currentColor`,\ncrisp at any scale, no canvas. On capacity errors the component shows an\nerror state and emits `error` rather than throwing.",
+          "description": "",
+          "summary": "",
+          "demos": []
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "QR_CODE_TAG",
+          "declaration": {
+            "name": "QR_CODE_TAG",
+            "module": "src/content/qr-code/qr-code.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "OreQrCodeElement",
+          "declaration": {
+            "name": "OreQrCodeElement",
+            "module": "src/content/qr-code/qr-code.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/content/rank-list/rank-item.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "RANK_ITEM_TAG",
+          "type": {
+            "text": "'ore-rank-item'"
+          },
+          "default": "'ore-rank-item'",
+          "description": "A single ranked row inside `ore-rank-list`: a rank numeral, an optional `leading` slot\n(avatar, icon), the label, a secondary `description` line, and a right-aligned `trailing`\nvalue, with a proportional bar under the row sized against the largest sibling `value`.\nThe row is the whole visualization: the label and value stay text, so the ranking is\nreadable and accessible with the bar treated as reinforcement, never as the only carrier."
+        },
+        {
+          "kind": "class",
+          "name": "OreRankItemElement",
+          "tagName": "ore-rank-item",
+          "customElement": true,
+          "description": "A single ranked row inside `ore-rank-list`: a rank numeral, an optional `leading` slot\n(avatar, icon), the label, a secondary `description` line, and a right-aligned `trailing`\nvalue, with a proportional bar under the row sized against the largest sibling `value`.\nThe row is the whole visualization: the label and value stay text, so the ranking is\nreadable and accessible with the bar treated as reinforcement, never as the only carrier.",
           "summary": "",
           "attributes": [
             {
-              "name": "value",
+              "name": "bar",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "The payload to encode"
+              "description": "Show the proportional bar (default). Disable with `bar=\"false\"` for non-count rows."
             },
             {
-              "name": "error-correction",
+              "name": "rank",
               "type": {
-                "text": "'L' | 'M' | 'Q' | 'H'"
+                "text": "number"
               },
-              "description": "'L' | 'M' | 'Q' | 'H' (default 'M')"
+              "description": "Rank position: assigned automatically by the parent list in DOM order; manual values are overwritten."
             },
             {
-              "name": "margin",
-              "type": {
-                "text": "number"
-              },
-              "description": "Quiet-zone modules (default 4)"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "description": "'sm' | 'md' | 'lg', or a pixel value"
-            },
-            {
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "description": "Accessible label (default \"QR code\")"
-            },
-            {
-              "name": "rounded",
-              "type": {
-                "text": "string"
-              },
-              "description": "Border radius for the card variant"
-            }
-          ],
-          "events": [
-            {
-              "name": "render",
-              "description": "detail: `{ version, size }` after each successful render",
-              "type": {
-                "text": "CustomEvent"
-              }
-            },
-            {
-              "name": "error",
-              "description": "detail: `{ error }` when encoding fails",
-              "type": {
-                "text": "CustomEvent"
-              }
-            }
-          ],
-          "slots": [
-            {
-              "name": "caption",
-              "description": "Optional caption rendered below the code"
-            }
-          ],
-          "cssParts": [
-            {
-              "name": "wrapper",
-              "description": "Outer container"
-            },
-            {
-              "name": "svg",
-              "description": "The rendered `<svg>` element"
-            },
-            {
-              "name": "caption",
-              "description": "Caption slot container"
-            },
-            {
-              "name": "error",
-              "description": "Error-state container"
-            }
-          ],
-          "cssProperties": [
-            {
-              "name": "--qr-code-dark",
-              "description": "Module color (default `currentColor`)"
-            },
-            {
-              "name": "--qr-code-light",
-              "description": "Background color (default `transparent`)"
-            },
-            {
-              "name": "--qr-code-size",
-              "description": "Rendered size in px (overrides `size`)"
-            },
-            {
-              "name": "--qr-code-radius",
-              "description": "Border radius"
-            },
-            {
-              "name": "--qr-code-padding",
-              "description": "Inner padding"
-            },
-            {
-              "name": "--qr-code-bg",
-              "description": "Card background (variant=\"card\")"
-            },
-            {
-              "name": "--qr-code-border",
-              "description": "Card border width (variant=\"card\")"
-            },
-            {
-              "name": "--qr-code-border-color",
-              "description": "Card border color (variant=\"card\")"
-            },
-            {
-              "name": "--qr-code-shadow",
-              "description": "Card box shadow (variant=\"card\")"
-            },
-            {
-              "name": "--qr-code-error-color",
-              "description": "Error-state text color"
-            }
-          ],
-          "demos": [
-            {
-              "url": "",
-              "description": "```html\n<ore-qr-code value=\"https://example.com\"></ore-qr-code>\n<ore-qr-code value=\"otpauth://…\" error-correction=\"H\" size=\"256\"></ore-qr-code>\n```"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "QR_CODE_TAG",
-          "declaration": {
-            "name": "QR_CODE_TAG",
-            "module": "src/content/qr-code/qr-code.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "OreQrCodeElement",
-          "declaration": {
-            "name": "OreQrCodeElement",
-            "module": "src/content/qr-code/qr-code.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/content/rank-list/rank-item.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "RANK_ITEM_TAG",
-          "type": {
-            "text": "'ore-rank-item'"
-          },
-          "default": "'ore-rank-item'",
-          "description": "A single ranked row inside `ore-rank-list`: a rank numeral, an optional `leading` slot\n(avatar, icon), the label, a secondary `description` line, and a right-aligned `trailing`\nvalue, with a proportional bar under the row sized against the largest sibling `value`.\nThe row is the whole visualization: the label and value stay text, so the ranking is\nreadable and accessible with the bar treated as reinforcement, never as the only carrier."
-        },
-        {
-          "kind": "class",
-          "name": "OreRankItemElement",
-          "tagName": "ore-rank-item",
-          "customElement": true,
-          "description": "A single ranked row inside `ore-rank-list`: a rank numeral, an optional `leading` slot\n(avatar, icon), the label, a secondary `description` line, and a right-aligned `trailing`\nvalue, with a proportional bar under the row sized against the largest sibling `value`.\nThe row is the whole visualization: the label and value stay text, so the ranking is\nreadable and accessible with the bar treated as reinforcement, never as the only carrier.",
-          "summary": "",
-          "attributes": [
-            {
-              "name": "bar",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Show the proportional bar (default). Disable with `bar=\"false\"` for non-count rows."
-            },
-            {
-              "name": "rank",
-              "type": {
-                "text": "number"
-              },
-              "description": "Rank position: assigned automatically by the parent list in DOM order; manual values are overwritten."
-            },
-            {
-              "name": "value",
+              "name": "value",
               "type": {
                 "text": "number"
               },
@@ -6873,93 +7059,76 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/feedback/alert/alert.ts",
+      "path": "src/feedback/async/async.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "ALERT_TAG",
+          "name": "ASYNC_TAG",
           "type": {
-            "text": "'ore-alert'"
+            "text": "'ore-async'"
           },
-          "default": "'ore-alert'",
-          "description": "A status/feedback banner with optional heading, icon slot, and dismiss button."
+          "default": "'ore-async'",
+          "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks."
         },
         {
           "kind": "class",
-          "name": "OreAlertElement",
-          "tagName": "ore-alert",
+          "name": "OreAsyncElement",
+          "tagName": "ore-async",
           "customElement": true,
-          "description": "A status/feedback banner with optional heading, icon slot, and dismiss button.",
+          "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks.",
           "summary": "",
           "attributes": [
             {
-              "name": "color",
-              "type": {
-                "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-              },
-              "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "'flat' | 'solid' | 'bordered'"
-              },
-              "description": "Visual style: 'flat' | 'solid' | 'bordered'"
-            },
-            {
-              "name": "size",
+              "name": "status",
               "type": {
-                "text": "'sm' | 'md' | 'lg'"
+                "text": "'idle' | 'loading' | 'empty' | 'error' | 'success'"
               },
-              "description": "Size: 'sm' | 'md' | 'lg'"
+              "description": "current state: 'idle' | 'loading' | 'empty' | 'error' | 'success' (default: 'success')",
+              "default": "'success'"
             },
             {
-              "name": "rounded",
+              "name": "retryable",
               "type": {
-                "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+                "text": "boolean"
               },
-              "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
+              "description": "show retry button in error state (default: false)",
+              "default": "false"
             },
             {
-              "name": "heading",
+              "name": "empty-label",
               "type": {
                 "text": "string"
               },
-              "description": "Bold heading text above the content"
-            },
-            {
-              "name": "dismissible",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Show a close (×) button"
+              "description": "title for empty state (default: 'No content yet')",
+              "default": "'No content yet'"
             },
             {
-              "name": "embedded",
+              "name": "empty-description",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Passive surface for a host that owns lifecycle and announcements; the close button only emits `dismiss`"
+              "description": "optional text for empty state"
             },
             {
-              "name": "accented",
+              "name": "error-label",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Add a left accent border (flat/bordered only)"
+              "description": "title for error state (default: 'Something went wrong')",
+              "default": "'Something went wrong'"
             },
             {
-              "name": "horizontal",
+              "name": "error-description",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Position action buttons to the right instead of below"
+              "description": "optional text for error state"
             }
           ],
           "events": [
             {
-              "name": "dismiss",
-              "description": "Fired when the alert is dismissed (after the exit animation, or immediately when `embedded`). detail: { originalEvent: MouseEvent }",
+              "name": "retry",
+              "description": "Emitted when the retry button is clicked (no detail payload)",
               "type": {
                 "text": "CustomEvent"
               }
@@ -6968,97 +7137,39 @@
           "slots": [
             {
               "name": "",
-              "description": "Default slot for the alert message content"
+              "description": "default content shown in 'success' state"
             },
             {
-              "name": "icon",
-              "description": "Icon on the left side"
+              "name": "loading",
+              "description": "custom loading UI (overrides default skeletons)"
             },
             {
-              "name": "meta",
-              "description": "Metadata displayed alongside the heading (lighter, right-aligned)"
+              "name": "empty",
+              "description": "custom empty UI (overrides default icon/label)"
             },
             {
-              "name": "actions",
-              "description": "Action buttons shown below the message"
+              "name": "error",
+              "description": "custom error UI (overrides default icon/label)"
             }
           ],
-          "cssParts": [
-            {
-              "name": "alert",
-              "description": "Alert root container."
-            },
+          "cssProperties": [
             {
-              "name": "icon",
-              "description": "Icon container."
+              "name": "--async-color",
+              "description": "Text/icon color used by default async state content"
             },
             {
-              "name": "header",
-              "description": "Header container."
+              "name": "--async-gap",
+              "description": "Vertical spacing between icon, title, description, and actions"
             },
             {
-              "name": "heading",
-              "description": "Heading text element."
-            },
-            {
-              "name": "meta",
-              "description": "Meta text container."
-            },
-            {
-              "name": "body",
-              "description": "Body content container."
-            },
-            {
-              "name": "content",
-              "description": "Content container."
-            },
-            {
-              "name": "actions",
-              "description": "Actions slot container."
-            },
-            {
-              "name": "close",
-              "description": "Close action control."
-            }
-          ],
-          "cssProperties": [
-            {
-              "name": "--alert-bg",
-              "description": "Background color"
-            },
-            {
-              "name": "--alert-color",
-              "description": "Text/icon color"
-            },
-            {
-              "name": "--alert-border-color",
-              "description": "Border color"
-            },
-            {
-              "name": "--alert-shadow",
-              "description": "Box shadow"
-            },
-            {
-              "name": "--alert-radius",
-              "description": "Border radius"
-            },
-            {
-              "name": "--alert-padding",
-              "description": "Padding"
-            },
-            {
-              "name": "--alert-gap",
-              "description": "Gap between icon, body, and close button"
-            },
-            {
-              "name": "--alert-font-size",
-              "description": "Font size"
-            }
-          ],
-          "demos": [
+              "name": "--async-icon-size",
+              "description": "Icon size for built-in loading/empty/error visuals"
+            }
+          ],
+          "demos": [
             {
               "url": "",
-              "description": "```html\n<ore-alert color=\"success\">Your changes have been saved.</ore-alert>\n<ore-alert color=\"error\" variant=\"solid\" dismissible heading=\"Something went wrong\">\n  Please try again later.\n</ore-alert>\n```"
+              "description": "```html\n<!-- Success state: default slot is shown -->\n<ore-async status=\"success\">\n  <ul><li>Item one</li><li>Item two</li></ul>\n</ore-async>\n<!-- Loading state: shows skeleton placeholders -->\n<ore-async status=\"loading\"></ore-async>\n<!-- Empty state with custom message -->\n<ore-async status=\"empty\" empty-label=\"No results\" empty-description=\"Try adjusting your filters.\"></ore-async>\n<!-- Error state with retry button -->\n<ore-async status=\"error\" retryable error-label=\"Failed to load\" error-description=\"Check your connection.\"></ore-async>\n```"
             }
           ]
         }
@@ -7066,102 +7177,111 @@
       "exports": [
         {
           "kind": "js",
-          "name": "ICON_TAG",
-          "declaration": {
-            "name": "ICON_TAG",
-            "module": "../../content/icon/icon"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "ALERT_TAG",
+          "name": "ASYNC_TAG",
           "declaration": {
-            "name": "ALERT_TAG",
-            "module": "src/feedback/alert/alert.ts"
+            "name": "ASYNC_TAG",
+            "module": "src/feedback/async/async.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "OreAlertElement",
+          "name": "OreAsyncElement",
           "declaration": {
-            "name": "OreAlertElement",
-            "module": "src/feedback/alert/alert.ts"
+            "name": "OreAsyncElement",
+            "module": "src/feedback/async/async.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/feedback/async/async.ts",
+      "path": "src/feedback/alert/alert.ts",
       "declarations": [
         {
           "kind": "variable",
-          "name": "ASYNC_TAG",
+          "name": "ALERT_TAG",
           "type": {
-            "text": "'ore-async'"
+            "text": "'ore-alert'"
           },
-          "default": "'ore-async'",
-          "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks."
+          "default": "'ore-alert'",
+          "description": "A status/feedback banner with optional heading, icon slot, and dismiss button."
         },
         {
           "kind": "class",
-          "name": "OreAsyncElement",
-          "tagName": "ore-async",
+          "name": "OreAlertElement",
+          "tagName": "ore-alert",
           "customElement": true,
-          "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks.",
+          "description": "A status/feedback banner with optional heading, icon slot, and dismiss button.",
           "summary": "",
           "attributes": [
             {
-              "name": "status",
+              "name": "color",
               "type": {
-                "text": "'idle' | 'loading' | 'empty' | 'error' | 'success'"
+                "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
               },
-              "description": "current state: 'idle' | 'loading' | 'empty' | 'error' | 'success' (default: 'success')",
-              "default": "'success'"
+              "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
             },
             {
-              "name": "retryable",
+              "name": "variant",
               "type": {
-                "text": "boolean"
+                "text": "'flat' | 'solid' | 'bordered'"
               },
-              "description": "show retry button in error state (default: false)",
-              "default": "false"
+              "description": "Visual style: 'flat' | 'solid' | 'bordered'"
             },
             {
-              "name": "empty-label",
+              "name": "size",
               "type": {
-                "text": "string"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "description": "title for empty state (default: 'No content yet')",
-              "default": "'No content yet'"
+              "description": "Size: 'sm' | 'md' | 'lg'"
             },
             {
-              "name": "empty-description",
+              "name": "rounded",
               "type": {
-                "text": "string"
+                "text": "'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
               },
-              "description": "optional text for empty state"
+              "description": "Border radius: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full'"
             },
             {
-              "name": "error-label",
+              "name": "heading",
               "type": {
                 "text": "string"
               },
-              "description": "title for error state (default: 'Something went wrong')",
-              "default": "'Something went wrong'"
+              "description": "Bold heading text above the content"
             },
             {
-              "name": "error-description",
+              "name": "dismissible",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "optional text for error state"
+              "description": "Show a close (×) button"
+            },
+            {
+              "name": "embedded",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Passive surface for a host that owns lifecycle and announcements; the close button only emits `dismiss`"
+            },
+            {
+              "name": "accented",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Add a left accent border (flat/bordered only)"
+            },
+            {
+              "name": "horizontal",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Position action buttons to the right instead of below"
             }
           ],
           "events": [
             {
-              "name": "retry",
-              "description": "Emitted when the retry button is clicked (no detail payload)",
+              "name": "dismiss",
+              "description": "Fired when the alert is dismissed (after the exit animation, or immediately when `embedded`). detail: { originalEvent: MouseEvent }",
               "type": {
                 "text": "CustomEvent"
               }
@@ -7170,39 +7290,97 @@
           "slots": [
             {
               "name": "",
-              "description": "default content shown in 'success' state"
+              "description": "Default slot for the alert message content"
             },
             {
-              "name": "loading",
-              "description": "custom loading UI (overrides default skeletons)"
+              "name": "icon",
+              "description": "Icon on the left side"
             },
             {
-              "name": "empty",
-              "description": "custom empty UI (overrides default icon/label)"
+              "name": "meta",
+              "description": "Metadata displayed alongside the heading (lighter, right-aligned)"
             },
             {
-              "name": "error",
-              "description": "custom error UI (overrides default icon/label)"
+              "name": "actions",
+              "description": "Action buttons shown below the message"
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "alert",
+              "description": "Alert root container."
+            },
+            {
+              "name": "icon",
+              "description": "Icon container."
+            },
+            {
+              "name": "header",
+              "description": "Header container."
+            },
+            {
+              "name": "heading",
+              "description": "Heading text element."
+            },
+            {
+              "name": "meta",
+              "description": "Meta text container."
+            },
+            {
+              "name": "body",
+              "description": "Body content container."
+            },
+            {
+              "name": "content",
+              "description": "Content container."
+            },
+            {
+              "name": "actions",
+              "description": "Actions slot container."
+            },
+            {
+              "name": "close",
+              "description": "Close action control."
             }
           ],
           "cssProperties": [
             {
-              "name": "--async-color",
-              "description": "Text/icon color used by default async state content"
+              "name": "--alert-bg",
+              "description": "Background color"
             },
             {
-              "name": "--async-gap",
-              "description": "Vertical spacing between icon, title, description, and actions"
+              "name": "--alert-color",
+              "description": "Text/icon color"
             },
             {
-              "name": "--async-icon-size",
-              "description": "Icon size for built-in loading/empty/error visuals"
+              "name": "--alert-border-color",
+              "description": "Border color"
+            },
+            {
+              "name": "--alert-shadow",
+              "description": "Box shadow"
+            },
+            {
+              "name": "--alert-radius",
+              "description": "Border radius"
+            },
+            {
+              "name": "--alert-padding",
+              "description": "Padding"
+            },
+            {
+              "name": "--alert-gap",
+              "description": "Gap between icon, body, and close button"
+            },
+            {
+              "name": "--alert-font-size",
+              "description": "Font size"
             }
           ],
           "demos": [
             {
               "url": "",
-              "description": "```html\n<!-- Success state: default slot is shown -->\n<ore-async status=\"success\">\n  <ul><li>Item one</li><li>Item two</li></ul>\n</ore-async>\n<!-- Loading state: shows skeleton placeholders -->\n<ore-async status=\"loading\"></ore-async>\n<!-- Empty state with custom message -->\n<ore-async status=\"empty\" empty-label=\"No results\" empty-description=\"Try adjusting your filters.\"></ore-async>\n<!-- Error state with retry button -->\n<ore-async status=\"error\" retryable error-label=\"Failed to load\" error-description=\"Check your connection.\"></ore-async>\n```"
+              "description": "```html\n<ore-alert color=\"success\">Your changes have been saved.</ore-alert>\n<ore-alert color=\"error\" variant=\"solid\" dismissible heading=\"Something went wrong\">\n  Please try again later.\n</ore-alert>\n```"
             }
           ]
         }
@@ -7210,18 +7388,26 @@
       "exports": [
         {
           "kind": "js",
-          "name": "ASYNC_TAG",
+          "name": "ICON_TAG",
           "declaration": {
-            "name": "ASYNC_TAG",
-            "module": "src/feedback/async/async.ts"
+            "name": "ICON_TAG",
+            "module": "../../content/icon/icon"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "ALERT_TAG",
+          "declaration": {
+            "name": "ALERT_TAG",
+            "module": "src/feedback/alert/alert.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "OreAsyncElement",
+          "name": "OreAlertElement",
           "declaration": {
-            "name": "OreAsyncElement",
-            "module": "src/feedback/async/async.ts"
+            "name": "OreAlertElement",
+            "module": "src/feedback/alert/alert.ts"
           }
         }
       ]
@@ -8496,6 +8682,15 @@
           },
           "default": "['solid', 'flat', 'bordered', 'outline', 'ghost', 'text', 'frost']"
         },
+        {
+          "kind": "variable",
+          "name": "BUTTON_EFFECTS",
+          "type": {
+            "text": "['shine', 'rainbow']"
+          },
+          "default": "['shine', 'rainbow']",
+          "description": "Animated border effect for ore-button."
+        },
         {
           "kind": "variable",
           "name": "BUTTON_TAG",
@@ -8650,185 +8845,95 @@
               "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"
-            },
-            {
-              "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 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```"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "BUTTON_VARIANTS",
-          "declaration": {
-            "name": "BUTTON_VARIANTS",
-            "module": "src/inputs/button/button.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "BUTTON_TAG",
-          "declaration": {
-            "name": "BUTTON_TAG",
-            "module": "src/inputs/button/button.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "OreButtonElement",
-          "declaration": {
-            "name": "OreButtonElement",
-            "module": "src/inputs/button/button.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/inputs/button-group/button-group.ts",
-      "declarations": [
-        {
-          "kind": "variable",
-          "name": "BUTTON_GROUP_CTX"
-        },
-        {
-          "kind": "variable",
-          "name": "BUTTON_GROUP_TAG",
-          "type": {
-            "text": "'ore-button-group'"
-          },
-          "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": "OreButtonGroupElement",
-          "tagName": "ore-button-group",
-          "customElement": true,
-          "description": "A container for grouping related buttons.\nChild `ore-button` components automatically inherit the group's color, size, and variant.",
-          "summary": "",
-          "attributes": [
-            {
-              "name": "attached",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Join buttons together into a unit"
-            },
-            {
-              "name": "color",
-              "type": {
-                "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-              },
-              "description": "Shared color tint: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
-            },
-            {
-              "name": "fullwidth",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Group spans full width"
-            },
-            {
-              "name": "label",
-              "type": {
-                "text": "string"
-              },
-              "description": "Accessible label"
-            },
-            {
-              "name": "orientation",
-              "type": {
-                "text": "'horizontal' | 'vertical'"
-              },
-              "description": "'horizontal' | 'vertical'"
-            },
-            {
-              "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')"
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "'sm' | 'md' | 'lg'"
-              },
-              "description": "Shared size: 'sm' | 'md' | 'lg'"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
-              },
-              "description": "Shared visual variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Place ore-button elements here"
-            }
-          ],
-          "cssParts": [
-            {
-              "name": "group",
-              "description": "Group container."
-            }
-          ],
-          "cssProperties": [
-            {
-              "name": "--group-gap",
-              "description": "Gap between buttons (non-attached mode)"
+              "name": "--button-padding",
+              "description": "Inner padding override"
             },
             {
-              "name": "--group-radius",
-              "description": "Border radius of the group container, defaults to the `rounded` attribute's token"
+              "name": "--button-gap",
+              "description": "Gap between icon and text override"
             },
             {
-              "name": "--button-radius",
-              "description": "Passed through to child buttons to control corner radius"
+              "name": "--button-font-size",
+              "description": "Font size override"
             },
             {
-              "name": "--button-border-start",
-              "description": "Passed through to suppress start borders in attached mode"
+              "name": "--button-frost-active-bg",
+              "description": "Background when pressed (frost variant)"
             },
             {
-              "name": "--button-border-top",
-              "description": "Passed through to suppress top borders in vertical attached mode"
+              "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```"
             }
           ]
         }
       ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BUTTON_VARIANTS",
+          "declaration": {
+            "name": "BUTTON_VARIANTS",
+            "module": "src/inputs/button/button.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BUTTON_EFFECTS",
+          "declaration": {
+            "name": "BUTTON_EFFECTS",
+            "module": "src/inputs/button/button.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "BUTTON_TAG",
+          "declaration": {
+            "name": "BUTTON_TAG",
+            "module": "src/inputs/button/button.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "OreButtonElement",
+          "declaration": {
+            "name": "OreButtonElement",
+            "module": "src/inputs/button/button.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/inputs/button-group/button-group.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "BUTTON_GROUP_CTX"
+        },
+        {
+          "kind": "variable",
+          "name": "BUTTON_GROUP_TAG",
+          "type": {
+            "text": "'ore-button-group'"
+          },
+          "default": "'ore-button-group'"
+        },
+        {
+          "kind": "class",
+          "name": "OreButtonGroupElement",
+          "tagName": "ore-button-group",
+          "customElement": true,
+          "description": "",
+          "summary": "",
+          "demos": []
+        }
+      ],
       "exports": [
         {
           "kind": "js",
@@ -10206,6 +10311,14 @@
       "kind": "javascript-module",
       "path": "src/inputs/datagrid/datagrid-model.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "SELECTION_MODES",
+          "type": {
+            "text": "['multi', 'none', 'single']"
+          },
+          "default": "['multi', 'none', 'single']"
+        },
         {
           "kind": "function",
           "name": "createDataGridModel",
@@ -10226,6 +10339,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "SELECTION_MODES",
+          "declaration": {
+            "name": "SELECTION_MODES",
+            "module": "src/inputs/datagrid/datagrid-model.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "createDataGridModel",
@@ -12736,224 +12857,77 @@
           "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```"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "RADIO_TAG",
-          "declaration": {
-            "name": "RADIO_TAG",
-            "module": "src/inputs/radio/radio.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "OreRadioElement",
-          "declaration": {
-            "name": "OreRadioElement",
-            "module": "src/inputs/radio/radio.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/inputs/radio-group/radio-group.ts",
-      "declarations": [
-        {
-          "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.",
+          "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": "Selected value"
+              "description": "Field value (required for radio groups)"
             },
             {
               "name": "name",
               "type": {
                 "text": "string"
               },
-              "description": "Form field name"
+              "description": "Form field name (required for radio groups)"
             },
             {
-              "name": "label",
+              "name": "color",
               "type": {
-                "text": "string"
+                "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
               },
-              "description": "Group label"
+              "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
             },
             {
-              "name": "orientation",
+              "name": "size",
               "type": {
-                "text": "'vertical' | 'horizontal'"
+                "text": "'sm' | 'md' | 'lg'"
               },
-              "description": "Layout: 'vertical' | 'horizontal'"
+              "description": "Radio size: 'sm' | 'md' | 'lg'"
             },
             {
-              "name": "required",
+              "name": "error",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "Required field"
+              "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 a radio is selected. detail: { values: string[], labels: string[], originalEvent?: Event }",
+              "description": "Emitted when radio is selected.",
               "type": {
                 "text": "CustomEvent"
               }
@@ -12962,29 +12936,57 @@
           "slots": [
             {
               "name": "",
-              "description": "Place `ore-radio` elements here"
+              "description": "Radio button label text"
             }
           ],
           "cssParts": [
             {
-              "name": "items",
-              "description": "Items container."
+              "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-group-direction",
-              "description": "Flex direction of the items list ('row' | 'column')"
+              "name": "--radio-size",
+              "description": "Control size (width and height)"
             },
             {
-              "name": "--radio-group-gap",
-              "description": "Gap between radio items"
+              "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-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```"
+              "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```"
             }
           ]
         }
@@ -12992,26 +12994,18 @@
       "exports": [
         {
           "kind": "js",
-          "name": "RADIO_GROUP_CTX",
-          "declaration": {
-            "name": "RADIO_GROUP_CTX",
-            "module": "src/inputs/radio-group/radio-group.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "RADIO_GROUP_TAG",
+          "name": "RADIO_TAG",
           "declaration": {
-            "name": "RADIO_GROUP_TAG",
-            "module": "src/inputs/radio-group/radio-group.ts"
+            "name": "RADIO_TAG",
+            "module": "src/inputs/radio/radio.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "OreRadioGroupElement",
+          "name": "OreRadioElement",
           "declaration": {
-            "name": "OreRadioGroupElement",
-            "module": "src/inputs/radio-group/radio-group.ts"
+            "name": "OreRadioElement",
+            "module": "src/inputs/radio/radio.ts"
           }
         }
       ]
@@ -13201,6 +13195,133 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/inputs/radio-group/radio-group.ts",
+      "declarations": [
+        {
+          "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": "--radio-group-direction",
+              "description": "Flex direction of the items list ('row' | 'column')"
+            },
+            {
+              "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```"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RADIO_GROUP_CTX",
+          "declaration": {
+            "name": "RADIO_GROUP_CTX",
+            "module": "src/inputs/radio-group/radio-group.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RADIO_GROUP_TAG",
+          "declaration": {
+            "name": "RADIO_GROUP_TAG",
+            "module": "src/inputs/radio-group/radio-group.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "OreRadioGroupElement",
+          "declaration": {
+            "name": "OreRadioGroupElement",
+            "module": "src/inputs/radio-group/radio-group.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/inputs/select/select.ts",
@@ -17160,6 +17281,14 @@
       "kind": "javascript-module",
       "path": "src/overlay/menu/menu.ts",
       "declarations": [
+        {
+          "kind": "variable",
+          "name": "ORE_MENU_ITEM_TYPES",
+          "type": {
+            "text": "['checkbox', 'radio']"
+          },
+          "default": "['checkbox', 'radio']"
+        },
         {
           "kind": "variable",
           "name": "MENU_ITEM_TAG",
@@ -17411,6 +17540,14 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "ORE_MENU_ITEM_TYPES",
+          "declaration": {
+            "name": "ORE_MENU_ITEM_TYPES",
+            "module": "src/overlay/menu/menu.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "MENU_ITEM_TAG",