@vielzeug/codex 3.1.1 → 26.10.0

package/data/refine.json

@@ -41,6 +41,25 @@
     },
     "default": "{ content, disclosure, feedback, inputs, layout, overlay }"
   },
+  {
+    "kind": "function",
+    "name": "createThemeController",
+    "return": {
+      "type": {
+        "text": "ThemeController"
+      }
+    },
+    "parameters": [
+      {
+        "name": "options",
+        "default": "{}",
+        "type": {
+          "text": "ThemeControllerOptions"
+        }
+      }
+    ],
+    "description": "Creates a document theme controller. Call once at app startup."
+  },
   {
     "kind": "function",
     "name": "announce",
@@ -245,6 +264,42 @@
     ],
     "description": "Pure, framework-agnostic date-picker state machine backed by `Temporal.PlainDate`.\n\nAll state is held in plain mutable variables — suitable for wrapping in any\nreactive layer (ore `signal`, Vue ref, etc.). The factory returns a stable\nhandle object; callers are responsible for reactivity.\n\nOptions with getter-based live bindings (e.g. `get min() { ... }`) are read\non every call so the control always reflects the latest reactive state."
   },
+  {
+    "kind": "function",
+    "name": "handleCalendarGridKeydown",
+    "return": {
+      "type": {
+        "text": "void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "event",
+        "type": {
+          "text": "KeyboardEvent"
+        }
+      },
+      {
+        "name": "cellSelector",
+        "type": {
+          "text": "string"
+        }
+      },
+      {
+        "name": "columns",
+        "type": {
+          "text": "number"
+        }
+      },
+      {
+        "name": "onSelect",
+        "type": {
+          "text": "(cell: HTMLElement) => void"
+        }
+      }
+    ],
+    "description": "Roving-arrow keyboard navigation for a calendar grid, implementing the ARIA `grid` cell pattern:\nArrow keys move by one cell / one row (`columns` wide), Home/End jump to the row's first/last\ncell, and Enter/Space activate the focused cell. Every calendar grid — days (7 columns) and\nmonths/years (4 columns) — carries the base `.cal-grid` class, so `closest('.cal-grid')` scopes\nthe movement to the grid the event fired in regardless of view.\n\n`onSelect` receives the activated cell element so the day view can read its `data-iso` while the\nmonth/year views ignore the argument and use their own closure value."
+  },
   {
     "kind": "function",
     "name": "elementDirection",
@@ -398,6 +453,41 @@
     ],
     "description": "Encapsulates the three-step focus lifecycle used by dialogs and drawers:\n1. Capture the element that triggered the open.\n2. Move focus inside the overlay (optionally to a specific element).\n3. Restore focus when the overlay closes."
   },
+  {
+    "kind": "function",
+    "name": "registerIcons",
+    "return": {
+      "type": {
+        "text": "void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Record<string, IconNode>"
+        }
+      }
+    ],
+    "description": "Register icons (or override existing ones) by name. Keys may be kebab-case or\nPascalCase — both resolve."
+  },
+  {
+    "kind": "function",
+    "name": "resolveIcon",
+    "return": {
+      "type": {
+        "text": "IconNode | undefined"
+      }
+    },
+    "parameters": [
+      {
+        "name": "name",
+        "type": {
+          "text": "string"
+        }
+      }
+    ]
+  },
   {
     "kind": "function",
     "name": "dispatchKeyboardAction",
@@ -652,6 +742,24 @@
     ],
     "description": "Parses a comma-separated trigger string into a typed array, filtering against\na valid set and falling back to `defaults` when the input is empty or invalid.\n\nUsed by tooltip and popover to normalise their `trigger` prop values."
   },
+  {
+    "kind": "function",
+    "name": "parseOptionalBool",
+    "return": {
+      "type": {
+        "text": "boolean | undefined"
+      }
+    },
+    "parameters": [
+      {
+        "name": "value",
+        "type": {
+          "text": "string | null"
+        }
+      }
+    ],
+    "description": "Parses a boolean HTML attribute value into `true | false | undefined`, where\n`undefined` means \"attribute absent\" — the signal controlled components (`open`)\nuse to distinguish uncontrolled from controlled mode.\n\nThe grammar is the standard attribute one: presence with no value (`open`) or\nthe literal `\"true\"` is true; anything else, including `\"false\"`, is false.\nEvery controlled overlay (dialog, drawer, menu, popover, tooltip,\ncommand-palette) parses its `open` prop with this exact contract."
+  },
   {
     "kind": "function",
     "name": "createDropdownPositioner",
@@ -662,7 +770,7 @@
     },
     "parameters": [
       {
-        "name": "{\n  boundary,\n  getDir,\n  getFloating,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  offsetPx = 0,\n  padding = 6,\n  useClippingAncestor = true,\n}",
+        "name": "{\n  boundary,\n  getDir,\n  getFloating,\n  getOffsetPx = () => 0,\n  getPlacement,\n  getReference,\n  matchWidth = true,\n  onPlacementChange,\n  padding = 6,\n  useClippingAncestor = true,\n}",
         "type": {
           "text": "DropdownPositionerOptions"
         }
@@ -777,6 +885,60 @@
       }
     ]
   },
+  {
+    "kind": "function",
+    "name": "parseMaxWidthPx",
+    "return": {
+      "type": {
+        "text": "number | undefined"
+      }
+    },
+    "parameters": [
+      {
+        "name": "query",
+        "type": {
+          "text": "string | undefined"
+        }
+      }
+    ],
+    "description": "Parses the px value out of a container-query string like `(max-width: 768px)`."
+  },
+  {
+    "kind": "function",
+    "name": "resolveContainerElement",
+    "return": {
+      "type": {
+        "text": "HTMLElement | null"
+      }
+    },
+    "parameters": [
+      {
+        "name": "el",
+        "type": {
+          "text": "HTMLElement"
+        }
+      }
+    ],
+    "description": "The element whose width the component measures against, skipping transparent\n`ore-grid-item` wrappers so a component inside a grid still sees its real container."
+  },
+  {
+    "kind": "function",
+    "name": "readContainerWidth",
+    "return": {
+      "type": {
+        "text": "number"
+      }
+    },
+    "parameters": [
+      {
+        "name": "el",
+        "type": {
+          "text": "HTMLElement"
+        }
+      }
+    ],
+    "description": "The container width to test against a breakpoint, falling back to the element itself."
+  },
   {
     "kind": "variable",
     "name": "themableBundle",
@@ -1750,6 +1912,139 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "CHAT_PANEL_TAG",
+    "type": {
+      "text": "'ore-chat-panel'"
+    },
+    "default": "'ore-chat-panel'",
+    "description": "A self-contained assistant chat surface — the fixed corner window a demo or support\nflow needs: header with title, status, Start over and close; a live-region message\ntranscript built from `ore-chat-message`; suggested questions while the transcript\nholds only the greeting; and an `ore-message-composer` footer.\n\nThe panel owns presentation and interaction only. Reply generation, persistence, and\naction semantics stay with the consumer: listen for `send`, append the assistant reply\nto `messages`, and reassign the array; handle `action` for whatever a message's action\npayload means in your app."
+  },
+  {
+    "kind": "class",
+    "name": "OreChatPanelElement",
+    "tagName": "ore-chat-panel",
+    "customElement": true,
+    "description": "A self-contained assistant chat surface — the fixed corner window a demo or support\nflow needs: header with title, status, Start over and close; a live-region message\ntranscript built from `ore-chat-message`; suggested questions while the transcript\nholds only the greeting; and an `ore-message-composer` footer.\nThe panel owns presentation and interaction only. Reply generation, persistence, and\naction semantics stay with the consumer: listen for `send`, append the assistant reply\nto `messages`, and reassign the array; handle `action` for whatever a message's action\npayload means in your app.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Accessible name for the panel region"
+      },
+      {
+        "name": "open",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Open state"
+      },
+      {
+        "name": "initials",
+        "type": {
+          "text": "string"
+        },
+        "description": "Assistant avatar initials (default 'V')"
+      },
+      {
+        "name": "maxlength",
+        "type": {
+          "text": "number"
+        },
+        "description": "Composer character limit (default 240)"
+      }
+    ],
+    "events": [
+      {
+        "name": "send",
+        "description": "A send or suggestion was submitted. detail: { text }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "action",
+        "description": "A message action button was activated. detail: { payload }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "reset",
+        "description": "The transcript was cleared via Start over.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "open-change",
+        "description": "Open state changed. detail: { open, reason }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "header",
+        "description": "Replaces the default title/status header content"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "window",
+        "description": "The fixed panel window"
+      },
+      {
+        "name": "header",
+        "description": "Header row"
+      },
+      {
+        "name": "body",
+        "description": "Scrollable transcript area"
+      },
+      {
+        "name": "messages",
+        "description": "Message list (role=log)"
+      },
+      {
+        "name": "suggestions",
+        "description": "Suggestion chips row"
+      },
+      {
+        "name": "composer",
+        "description": "Composer footer"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--chat-panel-width",
+        "description": "Panel width (default min(420px, viewport-fit))"
+      },
+      {
+        "name": "--chat-panel-height",
+        "description": "Panel height (default min(640px, viewport-fit))"
+      },
+      {
+        "name": "--chat-panel-inset",
+        "description": "Distance from the viewport corner (default --size-6)"
+      },
+      {
+        "name": "--chat-panel-z-index",
+        "description": "Stacking order (default --z-fixed)"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-chat-panel id=\"advisor\" label=\"Model advisor\"></ore-chat-panel>\n<script type=\"module\">\n  import '@vielzeug/refine/chat-panel';\n  const panel = document.getElementById('advisor');\n  panel.messages = [{ sender: 'assistant', text: 'Hi! What can I help with?' }];\n  panel.addEventListener('send', (event) => {\n    panel.messages = [\n      ...panel.messages,\n      { sender: 'user', text: event.detail.text },\n      { sender: 'assistant', text: 'Let me look into that.' },\n    ];\n  });\n  panel.show();\n</script>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "CODE_WINDOW_TAG",
@@ -1993,24 +2288,6 @@
       }
     ]
   },
-  {
-    "kind": "function",
-    "name": "registerIcons",
-    "return": {
-      "type": {
-        "text": "void"
-      }
-    },
-    "parameters": [
-      {
-        "name": "icons",
-        "type": {
-          "text": "Record<string, IconNode>"
-        }
-      }
-    ],
-    "description": "Register additional icons (or override existing ones) by name.\nKeys may be kebab-case or PascalCase — both are accepted by `ore-icon`."
-  },
   {
     "kind": "variable",
     "name": "ICON_TAG",
@@ -2018,14 +2295,14 @@
       "text": "'ore-icon'"
     },
     "default": "'ore-icon'",
-    "description": "Icon wrapper for consistent Lucide rendering across Block."
+    "description": "Icon wrapper for consistent Lucide rendering across Block.\n\nNames resolve from a synchronous registry: refine's own component icons are\nalways registered; apps register their set with `registerIcons()` or import\n`@vielzeug/refine/icon-lucide` for the complete library."
   },
   {
     "kind": "class",
     "name": "OreIconElement",
     "tagName": "ore-icon",
     "customElement": true,
-    "description": "Icon wrapper for consistent Lucide rendering across Block.",
+    "description": "Icon wrapper for consistent Lucide rendering across Block.\nNames resolve from a synchronous registry: refine's own component icons are\nalways registered; apps register their set with `registerIcons()` or import\n`@vielzeug/refine/icon-lucide` for the complete library.",
     "summary": "",
     "attributes": [
       {
@@ -2033,7 +2310,7 @@
         "type": {
           "text": "string"
         },
-        "description": "Lucide icon name, e.g. `search` or `chevron-right`"
+        "description": "Lucide icon name, e.g. `search` or `chevron-right`, resolved from the registered set"
       },
       {
         "name": "size",
@@ -2151,14 +2428,14 @@
       "text": "'ore-list-item'"
     },
     "default": "'ore-list-item'",
-    "description": "A single row inside `ore-list`. Renders `leading`/default (title)/`description`/`trailing`\ncontent plus two off-canvas action panels (`actions-left`, `actions-right`) that a horizontal\npointer/touch swipe reveals — useful for mobile-style row actions (archive, delete, …). An\naction panel only opens if it actually has slotted content; swiping the other direction is a\nno-op. Revealed actions stay reachable from the keyboard (Tab focus on a slotted action button\nreveals its panel via `:focus-within`, independent of any gesture).\n\nSwiping past the reveal distance snaps the panel fully open on release; swiping further still —\npast the full-swipe-through distance — auto-confirms that side's action immediately (fires\n`confirm` and clicks the slot's first element), the same \"swipe all the way\" shortcut as iOS\nMail's delete gesture.\n\nClosing a revealed panel is deliberately one-directional: tap/click the row itself, tap outside\nthe item, or open a different item's panel. Reverse-swiping an already-open item is not\nsupported — see `ore-list`'s docs for the reasoning."
+    "description": "A single row inside `ore-list`. Renders `leading`/default (title)/`description`/`trailing`\ncontent plus two off-canvas action panels (`actions-left`, `actions-right`) that a horizontal\npointer/touch swipe reveals — useful for mobile-style row actions (archive, delete, …). An\naction panel only opens if it actually has slotted content; swiping the other direction is a\nno-op. Revealed actions stay reachable from the keyboard (Tab focus on a slotted action button\nreveals its panel via `:focus-within`, independent of any gesture).\n\nSwiping past the reveal distance snaps the panel fully open on release; swiping further still —\npast the full-swipe-through distance — auto-confirms that side's action immediately (fires\n`confirm` and clicks the slot's first element), the same \"swipe all the way\" shortcut as iOS\nMail's delete gesture.\n\nClosing a revealed panel is deliberately one-directional: tap/click the row itself, tap outside\nthe item, or open a different item's panel. Reverse-swiping an already-open item is not\nsupported — see `ore-list`'s docs for the reasoning.\n\nOn hover-capable fine pointers, a hovered row peeks a few pixels of its first action panel\n(`--list-item-peek`, a fraction of the panel width) so the swipe affordance is discoverable\nwithout a gesture; touch discovers the swipe natively."
   },
   {
     "kind": "class",
     "name": "OreListItemElement",
     "tagName": "ore-list-item",
     "customElement": true,
-    "description": "A single row inside `ore-list`. Renders `leading`/default (title)/`description`/`trailing`\ncontent plus two off-canvas action panels (`actions-left`, `actions-right`) that a horizontal\npointer/touch swipe reveals — useful for mobile-style row actions (archive, delete, …). An\naction panel only opens if it actually has slotted content; swiping the other direction is a\nno-op. Revealed actions stay reachable from the keyboard (Tab focus on a slotted action button\nreveals its panel via `:focus-within`, independent of any gesture).\nSwiping past the reveal distance snaps the panel fully open on release; swiping further still —\npast the full-swipe-through distance — auto-confirms that side's action immediately (fires\n`confirm` and clicks the slot's first element), the same \"swipe all the way\" shortcut as iOS\nMail's delete gesture.\nClosing a revealed panel is deliberately one-directional: tap/click the row itself, tap outside\nthe item, or open a different item's panel. Reverse-swiping an already-open item is not\nsupported — see `ore-list`'s docs for the reasoning.",
+    "description": "A single row inside `ore-list`. Renders `leading`/default (title)/`description`/`trailing`\ncontent plus two off-canvas action panels (`actions-left`, `actions-right`) that a horizontal\npointer/touch swipe reveals — useful for mobile-style row actions (archive, delete, …). An\naction panel only opens if it actually has slotted content; swiping the other direction is a\nno-op. Revealed actions stay reachable from the keyboard (Tab focus on a slotted action button\nreveals its panel via `:focus-within`, independent of any gesture).\nSwiping past the reveal distance snaps the panel fully open on release; swiping further still —\npast the full-swipe-through distance — auto-confirms that side's action immediately (fires\n`confirm` and clicks the slot's first element), the same \"swipe all the way\" shortcut as iOS\nMail's delete gesture.\nClosing a revealed panel is deliberately one-directional: tap/click the row itself, tap outside\nthe item, or open a different item's panel. Reverse-swiping an already-open item is not\nsupported — see `ore-list`'s docs for the reasoning.\nOn hover-capable fine pointers, a hovered row peeks a few pixels of its first action panel\n(`--list-item-peek`, a fraction of the panel width) so the swipe affordance is discoverable\nwithout a gesture; touch discovers the swipe natively.",
     "summary": "",
     "attributes": [
       {
@@ -2306,6 +2583,10 @@
         "name": "--list-item-actions-width",
         "description": "Width of each action panel (default 6rem)"
       },
+      {
+        "name": "--list-item-peek",
+        "description": "Hover-peek distance as a fraction of the action panel width (default 0.08; 0 disables the peek)"
+      },
       {
         "name": "--list-item-bg",
         "description": "Row background color"
@@ -2775,92 +3056,263 @@
         "name": "--qr-code-error-color",
         "description": "Error-state text color"
       }
-    ],
-    "demos": [
+    ],
+    "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```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "SEPARATOR_TAG",
+    "type": {
+      "text": "'ore-separator'"
+    },
+    "default": "'ore-separator'",
+    "description": "A simple visual divider between sections of content."
+  },
+  {
+    "kind": "class",
+    "name": "OreSeparatorElement",
+    "tagName": "ore-separator",
+    "customElement": true,
+    "description": "A simple visual divider between sections of content.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "orientation",
+        "type": {
+          "text": "string"
+        },
+        "description": "'horizontal' (default) | 'vertical'"
+      },
+      {
+        "name": "decorative",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "When true (default), aria-hidden is applied"
+      },
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Optional centered label text"
+      },
+      {
+        "name": "color",
+        "type": {
+          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        },
+        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "wrapper",
+        "description": "Root wrapper container."
+      },
+      {
+        "name": "separator",
+        "description": "Separator element."
+      },
+      {
+        "name": "label",
+        "description": "Label element."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--separator-color",
+        "description": "Line color"
+      },
+      {
+        "name": "--separator-size",
+        "description": "Line thickness"
+      },
+      {
+        "name": "--separator-spacing",
+        "description": "Vertical margin"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-separator></ore-separator>\n<ore-separator label=\"or\"></ore-separator>\n<ore-separator orientation=\"vertical\"></ore-separator>\n```"
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "SPEECH_RATES",
+    "type": {
+      "text": "[1, 0.85, 1.15]"
+    },
+    "default": "[1, 0.85, 1.15]",
+    "description": "The rate steps the speed control cycles through — normal, slow, fast."
+  },
+  {
+    "kind": "function",
+    "name": "speechSentences",
+    "return": {
+      "type": {
+        "text": "string[]"
+      }
+    },
+    "parameters": [
       {
-        "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```"
+        "name": "text",
+        "type": {
+          "text": "string"
+        }
       }
-    ]
+    ],
+    "description": "The entry's sentences — prose ends . ! or ?, closing quotes belong to the sentence\nthey end, and an unterminated tail is still a sentence. Consumers that highlight what\nis being read build their display from this same list, so `progress` sentence indexes\nmap onto their own."
   },
   {
     "kind": "variable",
-    "name": "SEPARATOR_TAG",
+    "name": "SPEECH_PLAYER_TAG",
     "type": {
-      "text": "'ore-separator'"
+      "text": "'ore-speech-player'"
     },
-    "default": "'ore-separator'",
-    "description": "A simple visual divider between sections of content."
+    "default": "'ore-speech-player'",
+    "description": "A text-to-speech player control — reads its `text` aloud through the Web Speech API.\n\nRenders a labeled play/pause toggle (the label folds away once engaged), a stop\ncontrol beside it that appears while reading, and a speed control cycling\nnormal/slow/fast. The text is spoken sentence by sentence (long sentences split into pieces under the\nengine's truncation window), the `state` attribute reflects playback, a\n`role=\"status\"` live region announces transitions, and `progress` events name the\nsentence being read so a consumer can highlight it. Only one player speaks at a\ntime: starting one stops any other. `resume-at` names the sentence to begin from,\nso a persisted position makes resume mean it."
   },
   {
     "kind": "class",
-    "name": "OreSeparatorElement",
-    "tagName": "ore-separator",
+    "name": "OreSpeechPlayerElement",
+    "tagName": "ore-speech-player",
     "customElement": true,
-    "description": "A simple visual divider between sections of content.",
+    "description": "A text-to-speech player control — reads its `text` aloud through the Web Speech API.\nRenders a labeled play/pause toggle (the label folds away once engaged), a stop\ncontrol beside it that appears while reading, and a speed control cycling\nnormal/slow/fast. The text is spoken sentence by sentence (long sentences split into pieces under the\nengine's truncation window), the `state` attribute reflects playback, a\n`role=\"status\"` live region announces transitions, and `progress` events name the\nsentence being read so a consumer can highlight it. Only one player speaks at a\ntime: starting one stops any other. `resume-at` names the sentence to begin from,\nso a persisted position makes resume mean it.",
     "summary": "",
     "attributes": [
       {
-        "name": "orientation",
+        "name": "text",
         "type": {
           "text": "string"
         },
-        "description": "'horizontal' (default) | 'vertical'"
+        "description": "The text to read aloud (also settable as a JavaScript property)"
       },
       {
-        "name": "decorative",
+        "name": "lang",
         "type": {
-          "text": "boolean"
+          "text": "string"
         },
-        "description": "When true (default), aria-hidden is applied"
+        "description": "BCP-47 tag of `text`'s language, e.g. `en` or `de-DE`"
       },
       {
-        "name": "label",
+        "name": "state",
         "type": {
-          "text": "string"
+          "text": "'idle' | 'playing' | 'paused' | 'unsupported'"
         },
-        "description": "Optional centered label text"
+        "description": "Reflected playback state: 'idle' | 'playing' | 'paused' | 'unsupported'"
       },
       {
-        "name": "color",
+        "name": "rate",
         "type": {
-          "text": "'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+          "text": "number"
         },
-        "description": "Theme color: 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error'"
+        "description": "Playback rate; the speed control cycles 1 → 0.85 → 1.15"
+      },
+      {
+        "name": "resume-at",
+        "type": {
+          "text": "number"
+        },
+        "description": "The sentence index playback begins from"
+      }
+    ],
+    "events": [
+      {
+        "name": "play",
+        "description": "Reading started. No detail.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "progress",
+        "description": "A sentence began. detail: { sentence, total }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "stop",
+        "description": "Reading stopped before finishing. No detail.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "end",
+        "description": "Reading finished on its own. No detail.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "error",
+        "description": "The engine failed mid-read. No detail.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
+      {
+        "name": "rate-change",
+        "description": "The speed control moved to a new step. detail: { rate }",
+        "type": {
+          "text": "CustomEvent"
+        }
       }
     ],
     "cssParts": [
       {
-        "name": "wrapper",
-        "description": "Root wrapper container."
+        "name": "player",
+        "description": "Outer control group"
       },
       {
-        "name": "separator",
-        "description": "Separator element."
+        "name": "play",
+        "description": "The play/pause toggle button"
       },
       {
-        "name": "label",
-        "description": "Label element."
+        "name": "rate",
+        "description": "The speed control"
+      },
+      {
+        "name": "stop",
+        "description": "The stop button (hidden while idle)"
       }
     ],
     "cssProperties": [
       {
-        "name": "--separator-color",
-        "description": "Line color"
+        "name": "--speech-player-gap",
+        "description": "Gap between the controls"
       },
       {
-        "name": "--separator-size",
-        "description": "Line thickness"
+        "name": "--speech-player-control-size",
+        "description": "Each control's hit-area size (the toggle grows with its label)"
       },
       {
-        "name": "--separator-spacing",
-        "description": "Vertical margin"
+        "name": "--speech-player-icon-color",
+        "description": "Control icon color at rest"
+      },
+      {
+        "name": "--speech-player-active-color",
+        "description": "Toggle color while reading (playing or paused)"
+      },
+      {
+        "name": "--speech-player-hover-bg",
+        "description": "Control background on hover"
       }
     ],
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-separator></ore-separator>\n<ore-separator label=\"or\"></ore-separator>\n<ore-separator orientation=\"vertical\"></ore-separator>\n```"
+        "description": "```html\n<ore-speech-player text=\"The valley sleeps under ash.\"></ore-speech-player>\n<ore-speech-player lang=\"de\" text=\"Das Tal schläft unter Asche.\"></ore-speech-player>\n```"
       }
     ]
   },
@@ -4022,6 +4474,22 @@
       {
         "name": "--accordion-item-summary-padding",
         "description": "Content padding"
+      },
+      {
+        "name": "--accordion-item-row-duration",
+        "description": "Expand/collapse row transition duration (default 200ms)"
+      },
+      {
+        "name": "--accordion-item-fade-duration",
+        "description": "Content fade duration (default 200ms)"
+      },
+      {
+        "name": "--accordion-item-fade-delay",
+        "description": "Content fade delay after the row starts (default 60ms)"
+      },
+      {
+        "name": "--accordion-item-collapse-delay",
+        "description": "Delay before the row collapses after the close fade (default 120ms)"
       }
     ],
     "demos": [
@@ -5009,6 +5477,96 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "COOKIE_BANNER_TAG",
+    "type": {
+      "text": "'ore-cookie-banner'"
+    },
+    "default": "'ore-cookie-banner'",
+    "description": "A fixed-position consent banner for cookie/tracker opt-in: a short policy text\n(default slot, links included), optional per-category opt-in checkboxes with\ndescriptions, and accept-all / reject / save actions.\n\nThe layout is a single column — heading, policy text, a scrollable category\npanel, and actions — that scales linearly from one to many categories. Each\ncategory renders as a checkbox row; its optional `description` passes through\nthe checkbox's `helper` mechanism, so it is both visible below the label and\nlinked to the control via `aria-describedby`. The category panel scrolls\ninternally when it exceeds `--cookie-banner-categories-max-height`, so the\nbanner itself never grows past the viewport.\n\nThe banner owns presentation only. It never stores anything: listen for `decide`,\npersist the emitted record yourself (localStorage, a CMP, your own backend), and\ngate third-party embeds on it. The banner hides itself after `decide` unless\n`hide-on-decide` is set to false. Call `show()` again to let the user revise\ntheir choice.\n\nThe banner is a non-modal `role=\"dialog\"`: screen readers announce it when it\nappears, focus moves to the dialog card itself on `show()` — a neutral target,\nso no action is preselected for keyboard users — and returns to the previously\nfocused element on `hide()`. A banner that is simply present at page load (never\nshown via `show()`) does not steal focus and is not announced; consumers that\nwant a load-time announcement should call `show()` from a user gesture.\n\nThe `decide` record contains exactly the currently configured category ids\n(plus `essential`, always true). Replace — do not merge — the stored record\nwith it, so categories removed between sessions drop their stale keys."
+  },
+  {
+    "kind": "class",
+    "name": "OreCookieBannerElement",
+    "tagName": "ore-cookie-banner",
+    "customElement": true,
+    "description": "A fixed-position consent banner for cookie/tracker opt-in: a short policy text\n(default slot, links included), optional per-category opt-in checkboxes with\ndescriptions, and accept-all / reject / save actions.\nThe layout is a single column — heading, policy text, a scrollable category\npanel, and actions — that scales linearly from one to many categories. Each\ncategory renders as a checkbox row; its optional `description` passes through\nthe checkbox's `helper` mechanism, so it is both visible below the label and\nlinked to the control via `aria-describedby`. The category panel scrolls\ninternally when it exceeds `--cookie-banner-categories-max-height`, so the\nbanner itself never grows past the viewport.\nThe banner owns presentation only. It never stores anything: listen for `decide`,\npersist the emitted record yourself (localStorage, a CMP, your own backend), and\ngate third-party embeds on it. The banner hides itself after `decide` unless\n`hide-on-decide` is set to false. Call `show()` again to let the user revise\ntheir choice.\nThe banner is a non-modal `role=\"dialog\"`: screen readers announce it when it\nappears, focus moves to the dialog card itself on `show()` — a neutral target,\nso no action is preselected for keyboard users — and returns to the previously\nfocused element on `hide()`. A banner that is simply present at page load (never\nshown via `show()`) does not steal focus and is not announced; consumers that\nwant a load-time announcement should call `show()` from a user gesture.\nThe `decide` record contains exactly the currently configured category ids\n(plus `essential`, always true). Replace — do not merge — the stored record\nwith it, so categories removed between sessions drop their stale keys.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "position",
+        "type": {
+          "text": "string"
+        },
+        "description": "Viewport edge: 'bottom' (default) | 'top'"
+      },
+      {
+        "name": "hide-on-decide",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Hides the banner after `decide` (default true)"
+      }
+    ],
+    "events": [
+      {
+        "name": "decide",
+        "description": "A decision was made. detail: { consent } — every category id plus `essential`, always true.",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Policy text, including links to the privacy policy and imprint"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "banner",
+        "description": "The banner card"
+      },
+      {
+        "name": "text",
+        "description": "The slot wrapper for the policy text"
+      },
+      {
+        "name": "categories",
+        "description": "The scrollable category panel"
+      },
+      {
+        "name": "actions",
+        "description": "The action buttons"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--cookie-banner-width",
+        "description": "Maximum width of the banner card (default min(560px, viewport-fit))"
+      },
+      {
+        "name": "--cookie-banner-inset",
+        "description": "Distance from the viewport edges (default --size-4)"
+      },
+      {
+        "name": "--cookie-banner-z-index",
+        "description": "Stacking order (default --z-modal)"
+      },
+      {
+        "name": "--cookie-banner-categories-max-height",
+        "description": "Category panel scroll threshold (default 16rem)"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-cookie-banner>\n  We use cookies to keep you logged in and, with your consent, to embed music\n  from YouTube. <a href=\"/privacy\">Privacy policy</a>.\n</ore-cookie-banner>\n<script type=\"module\">\n  import '@vielzeug/refine/cookie-banner';\n  const banner = document.querySelector('ore-cookie-banner');\n  banner.categories = [\n    { id: 'music', label: 'Music embeds', description: 'Embed music from YouTube' },\n    { id: 'stats', label: 'Statistics', description: 'Anonymous usage analytics' },\n  ];\n  banner.addEventListener('decide', (event) => {\n    localStorage.setItem('consent', JSON.stringify(event.detail.consent));\n  });\n</script>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "PASSWORD_STRENGTH_TAG",
@@ -6634,6 +7192,13 @@
           "text": "'sm' | 'md' | 'lg'"
         },
         "description": "'sm' | 'md' | 'lg'"
+      },
+      {
+        "name": "variant",
+        "type": {
+          "text": "'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
+        },
+        "description": "Surface variant: 'solid' | 'flat' | 'bordered' | 'outline' | 'ghost' | 'frost'"
       }
     ],
     "events": [
@@ -6730,7 +7295,7 @@
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-counter label=\"Stamina\" value=\"3\" hint=\"Pay for actions\">\n  <ore-icon slot=\"icon\" name=\"zap\"></ore-icon>\n</ore-counter>\n<ore-counter label=\"Score\" value=\"10\" min=\"0\" max=\"99\" size=\"lg\" color=\"primary\"></ore-counter>\n<ore-counter label=\"Damage\" value=\"12\" large-step=\"5\" quick-steps></ore-counter>\n```"
+        "description": "```html\n<ore-counter label=\"Stamina\" value=\"3\" hint=\"Pay for actions\">\n  <ore-icon slot=\"icon\" name=\"zap\"></ore-icon>\n</ore-counter>\n<ore-counter label=\"Score\" value=\"10\" min=\"0\" max=\"99\" size=\"lg\" color=\"primary\"></ore-counter>\n<ore-counter label=\"Damage\" value=\"12\" large-step=\"5\" quick-steps></ore-counter>\n<ore-counter label=\"Wounds\" value=\"1\" max=\"3\" variant=\"frost\" color=\"error\"></ore-counter>\n```"
       }
     ]
   },
@@ -6839,6 +7404,14 @@
     ],
     "members": []
   },
+  {
+    "kind": "variable",
+    "name": "DEFAULT_LABELS",
+    "type": {
+      "text": "DataGridLabels"
+    },
+    "default": "{ activeFilters: (count) => `${count} active filter${count === 1 ? '' : 's'}`, addFilter: 'Add filter…', ascending: 'A → Z', clearAllFilters: 'Clear all filters', clearFiltersAndSearch: 'Clear all filters & search', clearSort: 'Clear sort', closeSearch: 'Close search', collapseRow: 'Collapse row', columnOptions: 'Column options', columnVisibility: 'Column visibility', comfortableDensity: 'Density: Comfortable', compactDensity: 'Density: Compact', contains: 'Contains', cozyDensity: 'Density: Cozy', data: 'Data', descending: 'Z → A', emptyValue: '(empty)', equals: 'Equals', expandRow: 'Expand row', filter: 'Filter', filterBy: 'Filter by', filterOperator: (field) => `${field} operator`, greaterThan: 'Greater than', hiddenColumns: (count) => `${count} hidden column${count === 1 ? '' : 's'}`, lessThan: 'Less than', nextPage: 'Next page', numericAscending: '0 → 9', numericDescending: '9 → 0', pageNavigation: 'Page navigation', pagination: 'Pagination', previousPage: 'Previous page', property: 'Property', range: (start, end, total) => `${start} to ${end} of ${total}`, removeFilter: 'Remove filter', resetColumns: 'Reset', rowDetails: 'Row details', rows: (count) => `${count} row${count === 1 ? '' : 's'}`, rowsPerPage: 'Rows per page', search: 'Search', selectAllRows: 'Select all rows on this page', selectRow: 'Select row', sort: 'Sort', sortBy: 'Sort by', views: 'Views', visibleColumns: (count, total) => `${count} of ${total} visible`, }"
+  },
   {
     "kind": "function",
     "name": "createDataGridModel",
@@ -7288,6 +7861,41 @@
           "text": "string"
         },
         "description": "Provide helper context below the dropzone"
+      },
+      {
+        "name": "browse-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Action half of the dropzone line (default 'click to browse')"
+      },
+      {
+        "name": "dropzone-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Main half of the dropzone line (default 'Drop files here or')"
+      },
+      {
+        "name": "dropzone-active-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Dropzone line while a drag is active (default 'Release to upload')"
+      },
+      {
+        "name": "dropzone-hint",
+        "type": {
+          "text": "string"
+        },
+        "description": "Replace the auto-generated accept/max-size hint with this text"
+      },
+      {
+        "name": "files-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Accessible name of the selected-files list (default 'Selected files')"
       }
     ],
     "events": [
@@ -7305,6 +7913,13 @@
           "text": "CustomEvent"
         }
       },
+      {
+        "name": "reject",
+        "description": "detail: { files: File[], reasons: ('size' | 'type')[] } — nothing was added",
+        "type": {
+          "text": "CustomEvent"
+        }
+      },
       {
         "name": "upload-progress",
         "description": "detail: { file: File, loaded: number, total: number }",
@@ -9112,6 +9727,10 @@
         "name": "--select-border-color",
         "description": "Border color"
       },
+      {
+        "name": "--select-min-width",
+        "description": "Minimum width of the select; the trigger floors at it too, so the control never renders wider than its host"
+      },
       {
         "name": "--select-radius",
         "description": "Border radius"
@@ -9311,6 +9930,42 @@
       }
     ]
   },
+  {
+    "kind": "function",
+    "name": "eventFieldValue",
+    "return": {
+      "type": {
+        "text": "string | undefined"
+      }
+    },
+    "parameters": [
+      {
+        "name": "event",
+        "type": {
+          "text": "Event"
+        }
+      }
+    ],
+    "description": "Reads the `value` off the element an event fired from (`event.currentTarget`), guarding the\ncast: `undefined` when the target is missing or carries no string `value`. The read-side\ncompanion to setFieldValue — consumers wiring a native `change`/`input` handler to a\nfield no longer re-derive the `(currentTarget as HTMLElement & { value: string }).value` cast."
+  },
+  {
+    "kind": "function",
+    "name": "eventFieldChecked",
+    "return": {
+      "type": {
+        "text": "boolean"
+      }
+    },
+    "parameters": [
+      {
+        "name": "event",
+        "type": {
+          "text": "Event"
+        }
+      }
+    ],
+    "description": "Reads the `checked` flag off the element an event fired from (`event.currentTarget`), guarding\nthe cast: `false` when the target is missing or carries no boolean `checked`. The read-side\ncompanion to setFieldChecked."
+  },
   {
     "kind": "function",
     "name": "renderHelperRegion",
@@ -10831,6 +11486,10 @@
         "name": "end",
         "description": "Content rendered in the right/end region"
       },
+      {
+        "name": "persistent",
+        "description": "Trailing content that stays in the bar through the mobile collapse (global actions and status icons)"
+      },
       {
         "name": "mobile-menu",
         "description": "Controls and links rendered inside the mobile overflow panel"
@@ -10861,6 +11520,10 @@
         "name": "end",
         "description": "Trailing action/content region"
       },
+      {
+        "name": "persistent",
+        "description": "Trailing region that survives the mobile collapse"
+      },
       {
         "name": "mobile-toggle",
         "description": "Mobile menu toggle button"
@@ -10968,6 +11631,13 @@
     "description": "`ore-navbar-item` — Navigation item for navbar slots.\nRenders as an anchor when `href` is provided and item is not disabled.",
     "summary": "",
     "attributes": [
+      {
+        "name": "aria-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Accessible name for icon-only items, forwarded to the internal control"
+      },
       {
         "name": "active",
         "type": {
@@ -11089,6 +11759,13 @@
         },
         "description": "Show the collapse toggle button"
       },
+      {
+        "name": "drawer",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Drawer-only mode: no inline panel and no bottom bar, just the navbar/API-driven drawer"
+      },
       {
         "name": "variant",
         "type": {
@@ -11113,8 +11790,8 @@
         }
       },
       {
-        "name": "mobile-open-change",
-        "description": "Fired when mobile overlay open state changes. detail: { open: boolean; source: string }",
+        "name": "drawer-change",
+        "description": "Fired when the drawer open state changes. detail: { open: boolean; source: string }",
         "type": {
           "text": "CustomEvent"
         }
@@ -11136,8 +11813,8 @@
     ],
     "cssParts": [
       {
-        "name": "mobile-backdrop",
-        "description": "Backdrop shown for mobile overlays."
+        "name": "drawer-backdrop",
+        "description": "Backdrop shown behind the open drawer."
       },
       {
         "name": "nav",
@@ -11209,6 +11886,10 @@
         "name": "--sidebar-collapsed-width",
         "description": "Collapsed sidebar width (default: 3.5rem)"
       },
+      {
+        "name": "--sidebar-drawer-width",
+        "description": "Drawer panel width (default: min(--sidebar-width, 85vw))"
+      },
       {
         "name": "--sidebar-bg",
         "description": "Sidebar background color"