@vielzeug/refine 26.10.0 → 26.10.5

package/dist/custom-elements.json

@@ -239,7 +239,7 @@
               }
             }
           ],
-          "description": "Grows a `<textarea>`'s height to fit its content, shared by every component that offers\nauto-resize (`ore-textarea`, `ore-message-composer`) instead of each reimplementing it.\n\nOwns only height — manual-resize cursor/direction is a per-component styling concern, not\nshared behavior, so it stays local to whichever component renders a resize handle."
+          "description": "Grows a `<textarea>`'s height to fit its content, shared by every component that offers\nauto-resize (`ore-textarea`, `ore-message-composer`) instead of each reimplementing it.\n\nOwns only height: manual-resize cursor/direction is a per-component styling concern, not\nshared behavior, so it stays local to whichever component renders a resize handle."
         }
       ],
       "exports": [
@@ -339,7 +339,7 @@
               }
             }
           ],
-          "description": "Send-gesture logic for a message/comment composer — decides *when* a send is allowed\nand *whether* a given keydown counts as one. Owns no DOM, value state, or event dispatch;\nthe component wires `handleKeydown`/`send` and decides what a send actually does."
+          "description": "Send-gesture logic for a message/comment composer: decides *when* a send is allowed\nand *whether* a given keydown counts as one. Owns no DOM, value state, or event dispatch;\nthe component wires `handleKeydown`/`send` and decides what a send actually does."
         }
       ],
       "exports": [
@@ -373,7 +373,7 @@
               }
             }
           ],
-          "description": "Parses an ISO 8601 date string (`yyyy-MM-dd`) into a `Temporal.PlainDate`.\nReturns `null` for any invalid / empty input — never throws."
+          "description": "Parses an ISO 8601 date string (`yyyy-MM-dd`) into a `Temporal.PlainDate`.\nReturns `null` for any invalid / empty input: never throws."
         },
         {
           "kind": "function",
@@ -433,7 +433,7 @@
               }
             }
           ],
-          "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."
+          "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",
@@ -469,7 +469,7 @@
               }
             }
           ],
-          "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."
+          "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."
         }
       ],
       "exports": [
@@ -535,7 +535,7 @@
               }
             }
           ],
-          "description": "Resolves the effective text direction for an element.\n\nThe closest ancestor with an explicit `dir=\"ltr\"` or `dir=\"rtl\"` attribute wins — this\nsupports locally-scoped RTL sections (e.g. a single `dir=\"rtl\"` panel inside an otherwise\nLTR page). When no explicit `dir` attribute is found up the tree, falls back to the\ncomputed `direction` CSS property (e.g. set via a `direction: rtl` style rule with no\n`dir` attribute). Defaults to `'ltr'` when `el` is `null`."
+          "description": "Resolves the effective text direction for an element.\n\nThe closest ancestor with an explicit `dir=\"ltr\"` or `dir=\"rtl\"` attribute wins: this\nsupports locally-scoped RTL sections (e.g. a single `dir=\"rtl\"` panel inside an otherwise\nLTR page). When no explicit `dir` attribute is found up the tree, falls back to the\ncomputed `direction` CSS property (e.g. set via a `direction: rtl` style rule with no\n`dir` attribute). Defaults to `'ltr'` when `el` is `null`."
         }
       ],
       "exports": [
@@ -586,7 +586,7 @@
               }
             }
           ],
-          "description": "Creates a reactive counter state signal for text fields with `maxLength`.\nOnly call this when `maxLength` may be set — the state is genuinely opt-in."
+          "description": "Creates a reactive counter state signal for text fields with `maxLength`.\nOnly call this when `maxLength` may be set: the state is genuinely opt-in."
         },
         {
           "kind": "function",
@@ -608,7 +608,7 @@
               "default": "'counter'"
             }
           ],
-          "description": "The single implementation of \"which modifier class does this counter state map to\" —\nevery field with a character counter (`ore-input`, `ore-textarea`, `ore-message-composer`)\nrenders the identical near-limit/at-limit styling, so this is the one place that decides it."
+          "description": "The single implementation of \"which modifier class does this counter state map to\" :\nevery field with a character counter (`ore-input`, `ore-textarea`, `ore-message-composer`)\nrenders the identical near-limit/at-limit styling, so this is the one place that decides it."
         },
         {
           "kind": "function",
@@ -784,7 +784,7 @@
               }
             }
           ],
-          "description": "Register icons (or override existing ones) by name. Keys may be kebab-case or\nPascalCase — both resolve."
+          "description": "Register icons (or override existing ones) by name. Keys may be kebab-case or\nPascalCase: both resolve."
         },
         {
           "kind": "function",
@@ -1051,7 +1051,7 @@
               }
             }
           ],
-          "description": "Coerces `value` via `Number()` and returns it when finite, `undefined` otherwise.\n\nCaveat: `null` and `''` both coerce to `0` in JavaScript (`Number(null) === 0`,\n`Number('') === 0`) and are therefore returned as the finite number `0`, not\n`undefined` — this function does not treat \"absent\" values specially. Only\ngenuinely non-numeric input (`undefined`, `NaN`, non-numeric strings) yields\n`undefined`. Callers that mean \"no bound set\" should pass `undefined`\nexplicitly rather than `null` or `''`."
+          "description": "Coerces `value` via `Number()` and returns it when finite, `undefined` otherwise.\n\nCaveat: `null` and `''` both coerce to `0` in JavaScript (`Number(null) === 0`,\n`Number('') === 0`) and are therefore returned as the finite number `0`, not\n`undefined`: this function does not treat \"absent\" values specially. Only\ngenuinely non-numeric input (`undefined`, `NaN`, non-numeric strings) yields\n`undefined`. Callers that mean \"no bound set\" should pass `undefined`\nexplicitly rather than `null` or `''`."
         },
         {
           "kind": "function",
@@ -1279,7 +1279,7 @@
               }
             }
           ],
-          "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."
+          "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."
         }
       ],
       "exports": [
@@ -1361,7 +1361,7 @@
               }
             }
           ],
-          "description": "Forwards a mounted element to a JS-only `ref` callback prop, and keeps forwarding to a\n*new* callback if the prop is set again after mount (e.g. a parent sets it via a ref\ncallback after render, rather than at initial mount). Every text-entry-style component\nwith a `ref` escape-hatch prop (`ore-input`, `ore-textarea`, `ore-message-composer`,\n`ore-file-input`) wires this identically — call it once from inside `onElement()`, alongside\nwhatever else that element needs wired."
+          "description": "Forwards a mounted element to a JS-only `ref` callback prop, and keeps forwarding to a\n*new* callback if the prop is set again after mount (e.g. a parent sets it via a ref\ncallback after render, rather than at initial mount). Every text-entry-style component\nwith a `ref` escape-hatch prop (`ore-input`, `ore-textarea`, `ore-message-composer`,\n`ore-file-input`) wires this identically: call it once from inside `onElement()`, alongside\nwhatever else that element needs wired."
         }
       ],
       "exports": [
@@ -1771,19 +1771,19 @@
           "kind": "variable",
           "name": "MESSAGE_COMPOSER_SIZE_PRESET",
           "default": "{ lg: { '--_padding': 'var(--size-4)', fontSize: 'var(--text-base)', gap: 'var(--size-2-5)', }, md: { '--_padding': 'var(--size-3)', fontSize: 'var(--text-sm)', gap: 'var(--size-2)', }, sm: { '--_padding': 'var(--size-2)', fontSize: 'var(--text-xs)', gap: 'var(--size-1-5)', }, } satisfies FullSizePreset",
-          "description": "Size preset for the message composer card. Padding is symmetric (unlike\n`TEXTAREA_SIZE_PRESET`'s field-shaped padding) since this scales a card that wraps a field\n*and* a toolbar row, not a bare field — `md`'s padding matches the value the card used before\n`size` scaled anything, so the default look is unchanged."
+          "description": "Size preset for the message composer card. Padding is symmetric (unlike\n`TEXTAREA_SIZE_PRESET`'s field-shaped padding) since this scales a card that wraps a field\n*and* a toolbar row, not a bare field: `md`'s padding matches the value the card used before\n`size` scaled anything, so the default look is unchanged."
         },
         {
           "kind": "variable",
           "name": "MENU_SIZE_PRESET",
           "default": "{ lg: { '--_item-padding': 'var(--size-2) var(--size-3-5)', '--_panel-padding': 'var(--size-1-5)', '--_separator-margin': 'var(--size-1-5)', fontSize: 'var(--text-base)', gap: 'var(--size-2-5)', }, md: { '--_item-padding': 'var(--size-1-5) var(--size-3)', '--_panel-padding': 'var(--size-1)', '--_separator-margin': 'var(--size-1)', fontSize: 'var(--text-sm)', gap: 'var(--size-2)', }, sm: { '--_item-padding': 'var(--size-1) var(--size-2-5)', '--_panel-padding': 'var(--size-0-5)', '--_separator-margin': 'var(--size-0-5)', fontSize: 'var(--text-xs)', gap: 'var(--size-1-5)', }, } satisfies FullSizePreset",
-          "description": "Size preset for `ore-menu`'s floating panel, `ore-menu-item`'s row, and `ore-menu-separator`'s\nmargin. `--_panel-padding`, `--_item-padding`, and `--_separator-margin` are custom pass-through\nkeys (not one of `SizeConfig`'s named slots) since the panel, its items, and its separators each\nneed independently-scaling spacing; `md`'s values match what `menu.css`/`menu-item.css`/\n`menu-separator.css` hardcoded before `size` was wired up, so the default look is unchanged.\n`--_font-size`/`--_gap` are inherited by `ore-menu-item` from `ore-menu`'s own host — custom\nproperties cascade down through light-DOM children the same way they cascade into a shadow root."
+          "description": "Size preset for `ore-menu`'s floating panel, `ore-menu-item`'s row, and `ore-menu-separator`'s\nmargin. `--_panel-padding`, `--_item-padding`, and `--_separator-margin` are custom pass-through\nkeys (not one of `SizeConfig`'s named slots) since the panel, its items, and its separators each\nneed independently-scaling spacing; `md`'s values match what `menu.css`/`menu-item.css`/\n`menu-separator.css` hardcoded before `size` was wired up, so the default look is unchanged.\n`--_font-size`/`--_gap` are inherited by `ore-menu-item` from `ore-menu`'s own host: custom\nproperties cascade down through light-DOM children the same way they cascade into a shadow root."
         },
         {
           "kind": "variable",
           "name": "LIST_SIZE_PRESET",
           "default": "{ lg: { '--_min-height': 'var(--size-14)', '--_min-height-two-line': 'calc(var(--size-16) + var(--size-2))', '--_padding-inline-end': 'var(--size-6)', fontSize: 'var(--text-base)', gap: 'var(--size-4)', padding: 'var(--size-3) var(--size-4)', }, md: { '--_min-height': 'var(--size-14)', '--_min-height-two-line': 'calc(var(--size-16) + var(--size-2))', '--_padding-inline-end': 'var(--size-6)', fontSize: 'var(--text-sm)', gap: 'var(--size-4)', padding: 'var(--size-2-5) var(--size-4)', }, sm: { '--_min-height': 'var(--size-12)', '--_min-height-two-line': 'var(--size-16)', '--_padding-inline-end': 'var(--size-4)', fontSize: 'var(--text-xs)', gap: 'var(--size-2)', padding: 'var(--size-1-5) var(--size-2)', }, } satisfies FullSizePreset",
-          "description": "Size preset for `ore-list`'s own host. `ore-list-item` has no `sizeVariantMixin` call of its\nown — it reads `--_gap`/`--_padding`/`--_padding-inline-end`/`--_font-size`/`--_min-height`/\n`--_min-height-two-line` inherited straight from its parent `ore-list`'s shadow host (custom\nproperties cascade through light-DOM children the same way `MENU_SIZE_PRESET` cascades from\n`ore-menu` into `ore-menu-item`), with fallback defaults for standalone use outside an\n`ore-list`.\n\nFollows Material 3's list-item spacing at `md`/`lg`: 16dp between leading/content/trailing\n(`gap`), 16dp inline-start (`padding`), 24dp inline-end (`--_padding-inline-end` — the trailing\nedge sits 8dp further out than the other three sides in the M3 spec), 56dp one-line / 72dp\ntwo-line row height (`--_min-height`/`--_min-height-two-line`, applied in `list-item.css`).\n`sm` keeps the same asymmetry and the M3/WCAG 48dp touch-target floor proportionally, for a\ndenser list that still reads as \"M3-like\" rather than hitting the exact dp values M3 doesn't\nitself define an alternate density for."
+          "description": "Size preset for `ore-list`'s own host. `ore-list-item` has no `sizeVariantMixin` call of its\nown: it reads `--_gap`/`--_padding`/`--_padding-inline-end`/`--_font-size`/`--_min-height`/\n`--_min-height-two-line` inherited straight from its parent `ore-list`'s shadow host (custom\nproperties cascade through light-DOM children the same way `MENU_SIZE_PRESET` cascades from\n`ore-menu` into `ore-menu-item`), with fallback defaults for standalone use outside an\n`ore-list`.\n\nFollows Material 3's list-item spacing at `md`/`lg`: 16dp between leading/content/trailing\n(`gap`), 16dp inline-start (`padding`), 24dp inline-end (`--_padding-inline-end`: the trailing\nedge sits 8dp further out than the other three sides in the M3 spec), 56dp one-line / 72dp\ntwo-line row height (`--_min-height`/`--_min-height-two-line`, applied in `list-item.css`).\n`sm` keeps the same asymmetry and the M3/WCAG 48dp touch-target floor proportionally, for a\ndenser list that still reads as \"M3-like\" rather than hitting the exact dp values M3 doesn't\nitself define an alternate density for."
         },
         {
           "kind": "variable",
@@ -2773,14 +2773,14 @@
             "text": "'ore-chat-message'"
           },
           "default": "'ore-chat-message'",
-          "description": "A single message bubble for chat/conversation UIs — sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\n\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`) — pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time."
+          "description": "A single message bubble for chat/conversation UIs: sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\n\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`): pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time."
         },
         {
           "kind": "class",
           "name": "OreChatMessageElement",
           "tagName": "ore-chat-message",
           "customElement": true,
-          "description": "A single message bubble for chat/conversation UIs — sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`) — pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time.",
+          "description": "A single message bubble for chat/conversation UIs: sender-aware alignment, an optional\navatar slot, delivery status (sending/sent/error with retry), and a streaming cursor for\nassistant messages still generating. Content is provided via the default slot, so any\nmarkdown-to-HTML rendering stays the consumer's choice.\nThe default slot's leading/trailing whitespace-only text nodes are trimmed in place once\nper slot assignment (mount, and again on `slotchange`): pretty-printed HTML's\nindentation would otherwise render as blank lines, since the bubble preserves line breaks\n(`white-space: pre-wrap`) for genuine multi-paragraph replies. This mutates those specific\ntext nodes' `textContent` directly; it never touches nodes appended afterward (e.g. by\n`el.textContent += token` while streaming), only the ones present at assignment time.",
           "summary": "",
           "attributes": [
             {
@@ -2975,14 +2975,14 @@
             "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."
+          "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.",
+          "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": [
             {
@@ -3180,14 +3180,14 @@
             "text": "'ore-code-window'"
           },
           "default": "'ore-code-window'",
-          "description": "A styled window chrome for code blocks and AI/MCP conversation flows.\n\nTwo variants:\n- `variant=\"code\"` (default) — language badge + optional filename header.\n- `variant=\"chat\"` — traffic-light dots + title header."
+          "description": "A styled window chrome for code blocks and AI/MCP conversation flows.\n\nTwo variants:\n- `variant=\"code\"` (default): language badge + optional filename header.\n- `variant=\"chat\"`: traffic-light dots + title header."
         },
         {
           "kind": "class",
           "name": "OreCodeWindowElement",
           "tagName": "ore-code-window",
           "customElement": true,
-          "description": "A styled window chrome for code blocks and AI/MCP conversation flows.\nTwo variants:\n- `variant=\"code\"` (default) — language badge + optional filename header.\n- `variant=\"chat\"` — traffic-light dots + title header.",
+          "description": "A styled window chrome for code blocks and AI/MCP conversation flows.\nTwo variants:\n- `variant=\"code\"` (default): language badge + optional filename header.\n- `variant=\"chat\"`: traffic-light dots + title header.",
           "summary": "",
           "attributes": [
             {
@@ -3683,7 +3683,7 @@
               }
             }
           ],
-          "description": "The swipe-reveal-confirm gesture behind `ore-list-item`'s `actions-left`/`actions-right` slots\n— isolated here since it's the one genuinely tricky part of the component (three distance\nthresholds, inline style/attribute choreography during an active drag). Deliberately *not* a\nshared primitive: `createPanGesture` itself already is one (shared with `ore-toast`),\nbut this two-stage reveal/confirm layer on top of it has exactly one consumer today —\ngeneralizing it further would be speculative, not reusable.\n\nOnly sets/clears the `revealed`/`data-dragging`/`data-confirming` attributes and `--_swipe-x`\nstyle — it does not itself emit `reveal`/`conceal`. `ore-list-item` already watches `revealed`\nfor transitions (to cover *both* this gesture and a directly-set attribute uniformly), so this\nmodule setting the attribute is enough to drive both that watcher and `list.css`'s\n`[revealed]` styling."
+          "description": "The swipe-reveal-confirm gesture behind `ore-list-item`'s `actions-left`/`actions-right` slots\n: isolated here since it's the one genuinely tricky part of the component (three distance\nthresholds, inline style/attribute choreography during an active drag). Deliberately *not* a\nshared primitive: `createPanGesture` itself already is one (shared with `ore-toast`),\nbut this two-stage reveal/confirm layer on top of it has exactly one consumer today :\ngeneralizing it further would be speculative, not reusable.\n\nOnly sets/clears the `revealed`/`data-dragging`/`data-confirming` attributes and `--_swipe-x`\nstyle: it does not itself emit `reveal`/`conceal`. `ore-list-item` already watches `revealed`\nfor transitions (to cover *both* this gesture and a directly-set attribute uniformly), so this\nmodule setting the attribute is enough to drive both that watcher and `list.css`'s\n`[revealed]` styling."
         }
       ],
       "exports": [
@@ -3708,14 +3708,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.\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."
+          "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.\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.",
+          "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": [
             {
@@ -3792,7 +3792,7 @@
             },
             {
               "name": "confirm",
-              "description": "Swiped all the way through — fires before the slotted action's own click. detail: { item: HTMLElement, side: 'left' | 'right' }",
+              "description": "Swiped all the way through: fires before the slotted action's own click. detail: { item: HTMLElement, side: 'left' | 'right' }",
               "type": {
                 "text": "CustomEvent"
               }
@@ -3923,14 +3923,14 @@
             "text": "'ore-list'"
           },
           "default": "'ore-list'",
-          "description": "A vertical list container for `ore-list-item` children — plain display list by default, or a\nkeyboard-navigable single-select listbox via `selectable`. Each item can independently reveal\na left/right action panel via touch/pointer swipe (see `ore-list-item`'s `actions-left`/\n`actions-right` slots) — useful for mobile-style row actions (archive, delete, …)."
+          "description": "A vertical list container for `ore-list-item` children: plain display list by default, or a\nkeyboard-navigable single-select listbox via `selectable`. Each item can independently reveal\na left/right action panel via touch/pointer swipe (see `ore-list-item`'s `actions-left`/\n`actions-right` slots): useful for mobile-style row actions (archive, delete, …)."
         },
         {
           "kind": "class",
           "name": "OreListElement",
           "tagName": "ore-list",
           "customElement": true,
-          "description": "A vertical list container for `ore-list-item` children — plain display list by default, or a\nkeyboard-navigable single-select listbox via `selectable`. Each item can independently reveal\na left/right action panel via touch/pointer swipe (see `ore-list-item`'s `actions-left`/\n`actions-right` slots) — useful for mobile-style row actions (archive, delete, …).",
+          "description": "A vertical list container for `ore-list-item` children: plain display list by default, or a\nkeyboard-navigable single-select listbox via `selectable`. Each item can independently reveal\na left/right action panel via touch/pointer swipe (see `ore-list-item`'s `actions-left`/\n`actions-right` slots): useful for mobile-style row actions (archive, delete, …).",
           "summary": "",
           "attributes": [
             {
@@ -3959,7 +3959,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Selected item's value (only meaningful when `selectable`) — the single source of truth for selection"
+              "description": "Selected item's value (only meaningful when `selectable`): the single source of truth for selection"
             },
             {
               "name": "variant",
@@ -4338,14 +4338,14 @@
             "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."
+          "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."
         },
         {
           "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": "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.",
           "summary": "",
           "attributes": [
             {
@@ -4500,6 +4500,226 @@
         }
       ]
     },
+    {
+      "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",
+              "type": {
+                "text": "number"
+              },
+              "description": "The row's numeric value: sizes the bar against the largest sibling, and is the formatted display when no `trailing` slot is present."
+            }
+          ],
+          "slots": [
+            {
+              "name": "leading",
+              "description": "Content before the label (e.g. avatar, icon)"
+            },
+            {
+              "name": "",
+              "description": "Item label"
+            },
+            {
+              "name": "description",
+              "description": "Secondary line below the label (e.g. sample count)"
+            },
+            {
+              "name": "trailing",
+              "description": "Right-aligned value display; replaces the formatted `value`"
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "row",
+              "description": "The text row (rank, leading, label, trailing)"
+            },
+            {
+              "name": "rank",
+              "description": "The rank numeral (aria-hidden: the list order carries it)"
+            },
+            {
+              "name": "leading",
+              "description": "The leading slot container"
+            },
+            {
+              "name": "content",
+              "description": "The label + description container"
+            },
+            {
+              "name": "label",
+              "description": "The label slot container"
+            },
+            {
+              "name": "description",
+              "description": "The description slot container"
+            },
+            {
+              "name": "trailing",
+              "description": "The trailing value container"
+            },
+            {
+              "name": "bar",
+              "description": "The bar track"
+            },
+            {
+              "name": "bar-fill",
+              "description": "The bar fill"
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--rank-number-color",
+              "description": "Rank numeral color (default --color-contrast-500)"
+            },
+            {
+              "name": "--rank-number-width",
+              "description": "Rank numeral column width (default --size-6)"
+            },
+            {
+              "name": "--rank-bar-color",
+              "description": "Bar fill color (default --color-primary)"
+            },
+            {
+              "name": "--rank-track-color",
+              "description": "Bar track color (default --color-contrast-100)"
+            },
+            {
+              "name": "--rank-bar-height",
+              "description": "Bar height (default --size-1)"
+            }
+          ],
+          "demos": [
+            {
+              "url": "",
+              "description": "```html\n<ore-rank-item value=\"8\">\n  <ore-avatar slot=\"leading\" src=\"alex.png\" alt=\"\" rounded=\"full\" size=\"sm\"></ore-avatar>\n  Alex\n</ore-rank-item>\n<ore-rank-item value=\"6\" bar=\"false\">\n  Overview\n  <span slot=\"description\">4 timed sessions</span>\n  <span slot=\"trailing\">24m 11s</span>\n</ore-rank-item>\n```"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RANK_ITEM_TAG",
+          "declaration": {
+            "name": "RANK_ITEM_TAG",
+            "module": "src/content/rank-list/rank-item.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "OreRankItemElement",
+          "declaration": {
+            "name": "OreRankItemElement",
+            "module": "src/content/rank-list/rank-item.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/content/rank-list/rank-list.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "RANK_CTX",
+          "description": "Injection key for the rank context."
+        },
+        {
+          "kind": "variable",
+          "name": "RANK_LIST_TAG",
+          "type": {
+            "text": "'ore-rank-list'"
+          },
+          "default": "'ore-rank-list'",
+          "description": "A ranked display list: an ordered set of `ore-rank-item` rows where each row's proportional\nbar makes the ranking scannable without a separate chart. The list itself owns the two\nfacts an item cannot know on its own: the position of each row (assigned back to the item\nas its `rank` prop, in DOM order) and the scale every bar is measured against (the largest\nchild `value`, shared through context).\n\nThis is a read-only data display, not a selection control: rows never receive interactive\nstate. Order the items yourself before rendering: the list numbers them, it does not sort\nthem."
+        },
+        {
+          "kind": "class",
+          "name": "OreRankListElement",
+          "tagName": "ore-rank-list",
+          "customElement": true,
+          "description": "A ranked display list: an ordered set of `ore-rank-item` rows where each row's proportional\nbar makes the ranking scannable without a separate chart. The list itself owns the two\nfacts an item cannot know on its own: the position of each row (assigned back to the item\nas its `rank` prop, in DOM order) and the scale every bar is measured against (the largest\nchild `value`, shared through context).\nThis is a read-only data display, not a selection control: rows never receive interactive\nstate. Order the items yourself before rendering: the list numbers them, it does not sort\nthem.",
+          "summary": "",
+          "slots": [
+            {
+              "name": "",
+              "description": "`ore-rank-item` elements as direct children"
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--rank-list-gap",
+              "description": "Vertical gap between rows (default --size-1)"
+            }
+          ],
+          "demos": [
+            {
+              "url": "",
+              "description": "```html\n<ore-rank-list aria-label=\"Most visited pages\">\n  <ore-rank-item value=\"8\">Documentation</ore-rank-item>\n  <ore-rank-item value=\"6\">Pricing</ore-rank-item>\n  <ore-rank-item value=\"2\" bar=\"false\">Blog<span slot=\"trailing\">18m 24s</span></ore-rank-item>\n</ore-rank-list>\n```"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RANK_CTX",
+          "declaration": {
+            "name": "RANK_CTX",
+            "module": "src/content/rank-list/rank-list.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RANK_LIST_TAG",
+          "declaration": {
+            "name": "RANK_LIST_TAG",
+            "module": "src/content/rank-list/rank-list.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "OreRankListElement",
+          "declaration": {
+            "name": "OreRankListElement",
+            "module": "src/content/rank-list/rank-list.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/content/separator/separator.ts",
@@ -4616,7 +4836,7 @@
             "text": "[1, 0.85, 1.15]"
           },
           "default": "[1, 0.85, 1.15]",
-          "description": "The rate steps the speed control cycles through — normal, slow, fast."
+          "description": "The rate steps the speed control cycles through: normal, slow, fast."
         },
         {
           "kind": "function",
@@ -4634,7 +4854,7 @@
               }
             }
           ],
-          "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."
+          "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",
@@ -4643,14 +4863,14 @@
             "text": "'ore-speech-player'"
           },
           "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."
+          "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": "OreSpeechPlayerElement",
           "tagName": "ore-speech-player",
           "customElement": true,
-          "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.",
+          "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": [
             {
@@ -5109,14 +5329,14 @@
             "text": "'ore-step'"
           },
           "default": "'ore-step'",
-          "description": "A single step trigger. Must be placed as a direct child of `ore-stepper`, which provides\nthis step's current/completed/navigable/index/total state via context — those are derived,\nread-only attributes on this element, not settable props."
+          "description": "A single step trigger. Must be placed as a direct child of `ore-stepper`, which provides\nthis step's current/completed/navigable/index/total state via context: those are derived,\nread-only attributes on this element, not settable props."
         },
         {
           "kind": "class",
           "name": "OreStepElement",
           "tagName": "ore-step",
           "customElement": true,
-          "description": "A single step trigger. Must be placed as a direct child of `ore-stepper`, which provides\nthis step's current/completed/navigable/index/total state via context — those are derived,\nread-only attributes on this element, not settable props.",
+          "description": "A single step trigger. Must be placed as a direct child of `ore-stepper`, which provides\nthis step's current/completed/navigable/index/total state via context: those are derived,\nread-only attributes on this element, not settable props.",
           "summary": "",
           "attributes": [
             {
@@ -5565,14 +5785,14 @@
             "text": "'ore-table'"
           },
           "default": "'ore-table'",
-          "description": "Data table component.\n\nReads light-DOM `<ore-tr>`/`<ore-th>`/`<ore-td>` markers and projects them\ninto a fully-native shadow `<table>`. Cell attributes (`colspan`, `rowspan`,\n`scope`, etc.) are mirrored. Changes are observed and synced incrementally.\n\nNative table features — sticky headers, colspan/rowspan, the table layout\nalgorithm — all work because the shadow tree contains real table elements."
+          "description": "Data table component.\n\nReads light-DOM `<ore-tr>`/`<ore-th>`/`<ore-td>` markers and projects them\ninto a fully-native shadow `<table>`. Cell attributes (`colspan`, `rowspan`,\n`scope`, etc.) are mirrored. Changes are observed and synced incrementally.\n\nNative table features: sticky headers, colspan/rowspan, the table layout\nalgorithm: all work because the shadow tree contains real table elements."
         },
         {
           "kind": "class",
           "name": "OreTableElement",
           "tagName": "ore-table",
           "customElement": true,
-          "description": "Data table component.\nReads light-DOM `<ore-tr>`/`<ore-th>`/`<ore-td>` markers and projects them\ninto a fully-native shadow `<table>`. Cell attributes (`colspan`, `rowspan`,\n`scope`, etc.) are mirrored. Changes are observed and synced incrementally.\nNative table features — sticky headers, colspan/rowspan, the table layout\nalgorithm — all work because the shadow tree contains real table elements.",
+          "description": "Data table component.\nReads light-DOM `<ore-tr>`/`<ore-th>`/`<ore-td>` markers and projects them\ninto a fully-native shadow `<table>`. Cell attributes (`colspan`, `rowspan`,\n`scope`, etc.) are mirrored. Changes are observed and synced incrementally.\nNative table features: sticky headers, colspan/rowspan, the table layout\nalgorithm: all work because the shadow tree contains real table elements.",
           "summary": "",
           "attributes": [
             {
@@ -7230,7 +7450,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Content layout: 'inline' (default) | 'stacked' — stacked places the icon above a wrapping label, for tile-like selectable chips"
+              "description": "Content layout: 'inline' (default) | 'stacked': stacked places the icon above a wrapping label, for tile-like selectable chips"
             },
             {
               "name": "disabled",
@@ -7428,14 +7648,14 @@
             "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."
+          "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.",
+          "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": [
             {
@@ -7456,7 +7676,7 @@
           "events": [
             {
               "name": "decide",
-              "description": "A decision was made. detail: { consent } — every category id plus `essential`, always true.",
+              "description": "A decision was made. detail: { consent }: every category id plus `essential`, always true.",
               "type": {
                 "text": "CustomEvent"
               }
@@ -8026,7 +8246,7 @@
           "name": "OreToastElement",
           "tagName": "ore-toast",
           "customElement": true,
-          "description": "Declarative toast host. It subscribes to the service for its scope and\nrenders notifications, but has no imperative mutation API of its own.\nNotifications render as a vertical list (newest nearest the anchored edge)\ninside polite and assertive live regions. Entries are keyed by id, so store\nupdates (timer pauses, message updates, phase changes) patch the existing\nDOM instead of re-creating it — focus, in-flight gestures, and CSS\ntransitions all survive.",
+          "description": "Declarative toast host. It subscribes to the service for its scope and\nrenders notifications, but has no imperative mutation API of its own.\nNotifications render as a vertical list (newest nearest the anchored edge)\ninside polite and assertive live regions. Entries are keyed by id, so store\nupdates (timer pauses, message updates, phase changes) patch the existing\nDOM instead of re-creating it: focus, in-flight gestures, and CSS\ntransitions all survive.",
           "summary": "",
           "attributes": [
             {
@@ -8087,6 +8307,10 @@
               "name": "--toast-progress-height",
               "description": "Height of the auto-dismiss progress bar."
             },
+            {
+              "name": "--toast-snackbar-height",
+              "description": "Snackbar message row height, action or not (default --size-8)."
+            },
             {
               "name": "--toast-inset-top / --toast-inset-bottom / --toast-inset-left / --toast-inset-right",
               "description": "Viewport insets."
@@ -8176,14 +8400,14 @@
             "text": "'ore-typing-indicator'"
           },
           "default": "'ore-typing-indicator'",
-          "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply —\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\n\nThe dots are decorative (`aria-hidden`) — `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set, document-scoped) is the same pattern\nalready used for other transient status messages across this package."
+          "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply :\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\n\nThe dots are decorative (`aria-hidden`): `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set, document-scoped) is the same pattern\nalready used for other transient status messages across this package."
         },
         {
           "kind": "class",
           "name": "OreTypingIndicatorElement",
           "tagName": "ore-typing-indicator",
           "customElement": true,
-          "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply —\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\nThe dots are decorative (`aria-hidden`) — `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set, document-scoped) is the same pattern\nalready used for other transient status messages across this package.",
+          "description": "Three bouncing dots signaling that the other side of a conversation is composing a reply :\nthe moment before any content exists. For a message whose content is already streaming in,\nuse `ore-chat-message`'s `streaming` attribute (a blinking cursor) instead.\nThe dots are decorative (`aria-hidden`): `label` is the entire accessibility contract,\nannounced through the shared singleton live region (`core/announcer.ts`) rather than a\nstatic `aria-live` element in the template. A live region populated in the same paint as\nits own insertion is unreliable across browsers/screen readers; routing through the shared\nannouncer (pre-existing region, clear-then-set, document-scoped) is the same pattern\nalready used for other transient status messages across this package.",
           "summary": "",
           "attributes": [
             {
@@ -9517,14 +9741,14 @@
             "text": "'ore-counter'"
           },
           "default": "'ore-counter'",
-          "description": "A large-target tally control for counting things at a glance: `−` / value / `+` with an\noptional icon, label and hint. Designed for touch and arm's-length use (tabletop trackers,\ninventories, scoreboards) rather than typed form entry — use `ore-number-input` for that.\n\nHolding any button auto-repeats. The value is announced through a live region and is\nkeyboard-operable as a spinbutton (Arrow keys, Home/End, Page Up/Down). Set `quick-steps` to add an\nouter pair of buttons that move by `large-step`, for values that change in chunks (damage, scores)."
+          "description": "A large-target tally control for counting things at a glance: `−` / value / `+` with an\noptional icon, label and hint. Designed for touch and arm's-length use (tabletop trackers,\ninventories, scoreboards) rather than typed form entry: use `ore-number-input` for that.\n\nHolding any button auto-repeats. The value is announced through a live region and is\nkeyboard-operable as a spinbutton (Arrow keys, Home/End, Page Up/Down). Set `quick-steps` to add an\nouter pair of buttons that move by `large-step`, for values that change in chunks (damage, scores)."
         },
         {
           "kind": "class",
           "name": "OreCounterElement",
           "tagName": "ore-counter",
           "customElement": true,
-          "description": "A large-target tally control for counting things at a glance: `−` / value / `+` with an\noptional icon, label and hint. Designed for touch and arm's-length use (tabletop trackers,\ninventories, scoreboards) rather than typed form entry — use `ore-number-input` for that.\nHolding any button auto-repeats. The value is announced through a live region and is\nkeyboard-operable as a spinbutton (Arrow keys, Home/End, Page Up/Down). Set `quick-steps` to add an\nouter pair of buttons that move by `large-step`, for values that change in chunks (damage, scores).",
+          "description": "A large-target tally control for counting things at a glance: `−` / value / `+` with an\noptional icon, label and hint. Designed for touch and arm's-length use (tabletop trackers,\ninventories, scoreboards) rather than typed form entry: use `ore-number-input` for that.\nHolding any button auto-repeats. The value is announced through a live region and is\nkeyboard-operable as a spinbutton (Arrow keys, Home/End, Page Up/Down). Set `quick-steps` to add an\nouter pair of buttons that move by `large-step`, for values that change in chunks (damage, scores).",
           "summary": "",
           "attributes": [
             {
@@ -9637,6 +9861,10 @@
               "name": "icon",
               "description": "Leading icon or token artwork shown before the label"
             },
+            {
+              "name": "header-end",
+              "description": "Trailing header action beside the label"
+            },
             {
               "name": "hint",
               "description": "Custom hint content (replaces the `hint` attribute)"
@@ -10076,7 +10304,7 @@
               }
             }
           ],
-          "description": "Returns the Lucide icon name for a column's sort state.\nPure function — no closure dependency on the grid model."
+          "description": "Returns the Lucide icon name for a column's sort state.\nPure function: no closure dependency on the grid model."
         },
         {
           "kind": "function",
@@ -10100,7 +10328,7 @@
               }
             }
           ],
-          "description": "Returns the WAI-ARIA `aria-sort` value for a column.\nPure function — independently unit-testable."
+          "description": "Returns the WAI-ARIA `aria-sort` value for a column.\nPure function: independently unit-testable."
         },
         {
           "kind": "variable",
@@ -10561,7 +10789,7 @@
               }
             }
           ],
-          "description": "Owns file selection *and* the opt-in upload lifecycle together — they were never really\nseparable (adding a file starts its upload; removing one must abort it; replacing one is both\nat once). Independent of `html`/rendering, following the same shape as `datagrid`'s\n`createDataGridControls` and `combobox`'s `combobox-options.ts`: a factory `file-input.ts`\nwires into drag/drop/native-input events and the template, directly unit-testable without\nmounting a component.\n\nEvery file-level rule (accept, max-size, max-files, disabled) and every upload-lifecycle rule\n(progress, retry-from-offset, per-file isolation) lives here in one place."
+          "description": "Owns file selection *and* the opt-in upload lifecycle together: they were never really\nseparable (adding a file starts its upload; removing one must abort it; replacing one is both\nat once). Independent of `html`/rendering, following the same shape as `datagrid`'s\n`createDataGridControls` and `combobox`'s `combobox-options.ts`: a factory `file-input.ts`\nwires into drag/drop/native-input events and the template, directly unit-testable without\nmounting a component.\n\nEvery file-level rule (accept, max-size, max-files, disabled) and every upload-lifecycle rule\n(progress, retry-from-offset, per-file isolation) lives here in one place."
         }
       ],
       "exports": [
@@ -10594,14 +10822,14 @@
             "text": "'ore-file-input'"
           },
           "default": "'ore-file-input'",
-          "description": "A file upload field with drag-and-drop support, built-in validation messaging, and — once a\n`upload` transport is wired up — a full per-file upload lifecycle: live progress/speed/ETA,\nretry-on-failure, a success confirmation card, and fully independent handling of concurrent\nfiles (one failing never blocks or cancels the others). Picking files with no `upload` set\nkeeps the original, upload-free selection-only behavior."
+          "description": "A file upload field with drag-and-drop support, built-in validation messaging, and: once a\n`upload` transport is wired up: a full per-file upload lifecycle: live progress/speed/ETA,\nretry-on-failure, a success confirmation card, and fully independent handling of concurrent\nfiles (one failing never blocks or cancels the others). Picking files with no `upload` set\nkeeps the original, upload-free selection-only behavior."
         },
         {
           "kind": "class",
           "name": "OreFileInputElement",
           "tagName": "ore-file-input",
           "customElement": true,
-          "description": "A file upload field with drag-and-drop support, built-in validation messaging, and — once a\n`upload` transport is wired up — a full per-file upload lifecycle: live progress/speed/ETA,\nretry-on-failure, a success confirmation card, and fully independent handling of concurrent\nfiles (one failing never blocks or cancels the others). Picking files with no `upload` set\nkeeps the original, upload-free selection-only behavior.",
+          "description": "A file upload field with drag-and-drop support, built-in validation messaging, and: once a\n`upload` transport is wired up: a full per-file upload lifecycle: live progress/speed/ETA,\nretry-on-failure, a success confirmation card, and fully independent handling of concurrent\nfiles (one failing never blocks or cancels the others). Picking files with no `upload` set\nkeeps the original, upload-free selection-only behavior.",
           "summary": "",
           "attributes": [
             {
@@ -10713,7 +10941,7 @@
             },
             {
               "name": "reject",
-              "description": "detail: { files: File[], reasons: ('size' | 'type')[] } — nothing was added",
+              "description": "detail: { files: File[], reasons: ('size' | 'type')[] }: nothing was added",
               "type": {
                 "text": "CustomEvent"
               }
@@ -10815,7 +11043,7 @@
           "demos": [
             {
               "url": "",
-              "description": "```html\n<ore-file-input label=\"Upload files\" accept=\"image/*\" multiple />\n<ore-file-input label=\"Photos\" accept=\"image/*\" multiple gallery />\n<ore-file-input label=\"Resume\" accept=\".pdf,.doc,.docx\" max-size=\"5242880\" />\n<ore-file-input variant=\"bordered\" color=\"primary\" />\n```\n```ts\n// Wire up a real upload transport — progress/retry/success are then handled automatically.\n// `XMLHttpRequest` is used here (not `fetch`) because it's the only browser API that reports\n// upload progress; swap in whatever transport the app already uses.\nconst input = document.querySelector('ore-file-input');\ninput.upload = (file, { onProgress, signal, resumeFrom }) =>\n  new Promise((resolve, reject) => {\n    const xhr = new XMLHttpRequest();\n    xhr.upload.addEventListener('progress', (e) => onProgress(resumeFrom + e.loaded, file.size));\n    xhr.addEventListener('load', () => (xhr.status < 400 ? resolve() : reject(new Error(xhr.statusText))));\n    xhr.addEventListener('error', () => reject(new Error('Network error')));\n    signal.addEventListener('abort', () => xhr.abort());\n    xhr.open('PUT', '/uploads');\n    if (resumeFrom > 0) xhr.setRequestHeader('Content-Range', `bytes ${resumeFrom}-/${file.size}`);\n    xhr.send(file);\n  });\n```"
+              "description": "```html\n<ore-file-input label=\"Upload files\" accept=\"image/*\" multiple />\n<ore-file-input label=\"Photos\" accept=\"image/*\" multiple gallery />\n<ore-file-input label=\"Resume\" accept=\".pdf,.doc,.docx\" max-size=\"5242880\" />\n<ore-file-input variant=\"bordered\" color=\"primary\" />\n```\n```ts\n// Wire up a real upload transport: progress/retry/success are then handled automatically.\n// `XMLHttpRequest` is used here (not `fetch`) because it's the only browser API that reports\n// upload progress; swap in whatever transport the app already uses.\nconst input = document.querySelector('ore-file-input');\ninput.upload = (file, { onProgress, signal, resumeFrom }) =>\n  new Promise((resolve, reject) => {\n    const xhr = new XMLHttpRequest();\n    xhr.upload.addEventListener('progress', (e) => onProgress(resumeFrom + e.loaded, file.size));\n    xhr.addEventListener('load', () => (xhr.status < 400 ? resolve() : reject(new Error(xhr.statusText))));\n    xhr.addEventListener('error', () => reject(new Error('Network error')));\n    signal.addEventListener('abort', () => xhr.abort());\n    xhr.open('PUT', '/uploads');\n    if (resumeFrom > 0) xhr.setRequestHeader('Content-Range', `bytes ${resumeFrom}-/${file.size}`);\n    xhr.send(file);\n  });\n```"
             }
           ]
         }
@@ -10969,7 +11197,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Error message — marks the field as invalid (fallback when the `error` slot is empty)"
+              "description": "Error message: marks the field as invalid (fallback when the `error` slot is empty)"
             },
             {
               "name": "disabled",
@@ -11062,15 +11290,15 @@
             },
             {
               "name": "label",
-              "description": "Replaces the label text — slotted content takes precedence over the `label` prop"
+              "description": "Replaces the label text: slotted content takes precedence over the `label` prop"
             },
             {
               "name": "helper",
-              "description": "Replaces the helper text — slotted content takes precedence over the `helper` prop"
+              "description": "Replaces the helper text: slotted content takes precedence over the `helper` prop"
             },
             {
               "name": "error",
-              "description": "Replaces the error text — slotted content takes precedence over the `error` prop"
+              "description": "Replaces the error text: slotted content takes precedence over the `error` prop"
             }
           ],
           "cssParts": [
@@ -11215,14 +11443,14 @@
             "text": "'ore-message-composer'"
           },
           "default": "'ore-message-composer'",
-          "description": "A message/comment composer — a card with an auto-resizing field on top and a toolbar row\nbelow it, built directly on the same core primitives as `ore-textarea` (`createTextField`,\n`createAutoResize`) rather than composing `ore-textarea` itself. Nesting a fully-styled sibling\ncomponent and suppressing most of its chrome (as an earlier version of this component did) is\na leaky composition — this owns its single `<textarea>` outright, so there's exactly one\nimplementation of the field's appearance to reason about, not two fighting each other.\n\nHandles the send gesture (Enter to send, Shift+Enter for a newline, or a Ctrl/Cmd+Enter\nalternative), IME-safe composition, and clear-and-refocus after sending."
+          "description": "A message/comment composer: a card with an auto-resizing field on top and a toolbar row\nbelow it, built directly on the same core primitives as `ore-textarea` (`createTextField`,\n`createAutoResize`) rather than composing `ore-textarea` itself. Nesting a fully-styled sibling\ncomponent and suppressing most of its chrome (as an earlier version of this component did) is\na leaky composition: this owns its single `<textarea>` outright, so there's exactly one\nimplementation of the field's appearance to reason about, not two fighting each other.\n\nHandles the send gesture (Enter to send, Shift+Enter for a newline, or a Ctrl/Cmd+Enter\nalternative), IME-safe composition, and clear-and-refocus after sending."
         },
         {
           "kind": "class",
           "name": "OreMessageComposerElement",
           "tagName": "ore-message-composer",
           "customElement": true,
-          "description": "A message/comment composer — a card with an auto-resizing field on top and a toolbar row\nbelow it, built directly on the same core primitives as `ore-textarea` (`createTextField`,\n`createAutoResize`) rather than composing `ore-textarea` itself. Nesting a fully-styled sibling\ncomponent and suppressing most of its chrome (as an earlier version of this component did) is\na leaky composition — this owns its single `<textarea>` outright, so there's exactly one\nimplementation of the field's appearance to reason about, not two fighting each other.\nHandles the send gesture (Enter to send, Shift+Enter for a newline, or a Ctrl/Cmd+Enter\nalternative), IME-safe composition, and clear-and-refocus after sending.",
+          "description": "A message/comment composer: a card with an auto-resizing field on top and a toolbar row\nbelow it, built directly on the same core primitives as `ore-textarea` (`createTextField`,\n`createAutoResize`) rather than composing `ore-textarea` itself. Nesting a fully-styled sibling\ncomponent and suppressing most of its chrome (as an earlier version of this component did) is\na leaky composition: this owns its single `<textarea>` outright, so there's exactly one\nimplementation of the field's appearance to reason about, not two fighting each other.\nHandles the send gesture (Enter to send, Shift+Enter for a newline, or a Ctrl/Cmd+Enter\nalternative), IME-safe composition, and clear-and-refocus after sending.",
           "summary": "",
           "attributes": [
             {
@@ -11400,7 +11628,7 @@
             },
             {
               "name": "send",
-              "description": "Replaces the default send button entirely — the only supported way to customize it"
+              "description": "Replaces the default send button entirely: the only supported way to customize it"
             }
           ],
           "cssParts": [
@@ -12961,7 +13189,7 @@
               }
             }
           ],
-          "description": "`prop.string()` already reflects `error`'s raw value as an attribute, but that leaves the\nattribute present-but-empty (`error=\"\"`) once set instead of removing it — this normalizes\nan empty error back to \"no attribute at all\". Shared by every text-field component\n(`ore-input`, `ore-textarea`, `ore-message-composer`) since `bind()`'s own `error` writer\nneeds a derived getter, not the raw prop, to get that behavior."
+          "description": "`prop.string()` already reflects `error`'s raw value as an attribute, but that leaves the\nattribute present-but-empty (`error=\"\"`) once set instead of removing it: this normalizes\nan empty error back to \"no attribute at all\". Shared by every text-field component\n(`ore-input`, `ore-textarea`, `ore-message-composer`) since `bind()`'s own `error` writer\nneeds a derived getter, not the raw prop, to get that behavior."
         },
         {
           "kind": "function",
@@ -13160,7 +13388,7 @@
               }
             }
           ],
-          "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."
+          "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",
@@ -13291,7 +13519,7 @@
               }
             }
           ],
-          "description": "Inline error/success status icon shown inside a field — identical markup across\n`ore-input`, `ore-textarea`, and `ore-message-composer` (previously hand-duplicated in all\nthree, down to the same derived-signal names)."
+          "description": "Inline error/success status icon shown inside a field: identical markup across\n`ore-input`, `ore-textarea`, and `ore-message-composer` (previously hand-duplicated in all\nthree, down to the same derived-signal names)."
         },
         {
           "kind": "function",
@@ -13304,7 +13532,7 @@
               }
             }
           ],
-          "description": "Character counter + separate helper/error text regions below a field — identical across\n`ore-textarea` and `ore-message-composer` (kept out of `ore-input`, which slots its\nhelper/error content and drives its counter off a different data-attribute scheme via its\nown `char-counter` part — a genuinely different shape, not worth forcing into this one)."
+          "description": "Character counter + separate helper/error text regions below a field: identical across\n`ore-textarea` and `ore-message-composer` (kept out of `ore-input`, which slots its\nhelper/error content and drives its counter off a different data-attribute scheme via its\nown `char-counter` part: a genuinely different shape, not worth forcing into this one)."
         }
       ],
       "exports": [
@@ -14396,14 +14624,14 @@
             "text": "'ore-box'"
           },
           "default": "'ore-box'",
-          "description": "ore-box — A foundational layout primitive with theming support."
+          "description": "ore-box: A foundational layout primitive with theming support."
         },
         {
           "kind": "class",
           "name": "OreBoxElement",
           "tagName": "ore-box",
           "customElement": true,
-          "description": "ore-box — A foundational layout primitive with theming support.",
+          "description": "ore-box: A foundational layout primitive with theming support.",
           "summary": "",
           "attributes": [
             {
@@ -14536,14 +14764,14 @@
             "text": "'ore-grid'"
           },
           "default": "'ore-grid'",
-          "description": "ore-grid — Flexible grid layout with responsive column control.\n\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set."
+          "description": "ore-grid: Flexible grid layout with responsive column control.\n\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set."
         },
         {
           "kind": "class",
           "name": "OreGridElement",
           "tagName": "ore-grid",
           "customElement": true,
-          "description": "ore-grid — Flexible grid layout with responsive column control.\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set.",
+          "description": "ore-grid: Flexible grid layout with responsive column control.\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set.",
           "summary": "",
           "attributes": [
             {
@@ -14762,14 +14990,14 @@
             "text": "'ore-grid-item'"
           },
           "default": "'ore-grid-item'",
-          "description": "ore-grid-item — A grid cell with declarative placement and span control.\n\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines)."
+          "description": "ore-grid-item: A grid cell with declarative placement and span control.\n\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines)."
         },
         {
           "kind": "class",
           "name": "OreGridItemElement",
           "tagName": "ore-grid-item",
           "customElement": true,
-          "description": "ore-grid-item — A grid cell with declarative placement and span control.\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines).",
+          "description": "ore-grid-item: A grid cell with declarative placement and span control.\nUse `col-span` / `row-span` for the common case of spanning columns/rows.\nUse `col` / `row` for full CSS grid-column / grid-row shorthand power\n(e.g. explicit placement, mixed span + start, negative lines).",
           "summary": "",
           "attributes": [
             {
@@ -14883,14 +15111,14 @@
             "text": "'ore-navbar'"
           },
           "default": "'ore-navbar'",
-          "description": "`ore-navbar` — Responsive navigation with sticky/floating modes and a mobile overflow panel."
+          "description": "`ore-navbar`: Responsive navigation with sticky/floating modes and a mobile overflow panel."
         },
         {
           "kind": "class",
           "name": "OreNavbarElement",
           "tagName": "ore-navbar",
           "customElement": true,
-          "description": "`ore-navbar` — Responsive navigation with sticky/floating modes and a mobile overflow panel.",
+          "description": "`ore-navbar`: Responsive navigation with sticky/floating modes and a mobile overflow panel.",
           "summary": "",
           "attributes": [
             {
@@ -15139,14 +15367,14 @@
             "text": "'ore-navbar-item'"
           },
           "default": "'ore-navbar-item'",
-          "description": "`ore-navbar-item` — Navigation item for navbar slots.\n\nRenders as an anchor when `href` is provided and item is not disabled."
+          "description": "`ore-navbar-item`: Navigation item for navbar slots.\n\nRenders as an anchor when `href` is provided and item is not disabled."
         },
         {
           "kind": "class",
           "name": "OreNavbarItemElement",
           "tagName": "ore-navbar-item",
           "customElement": true,
-          "description": "`ore-navbar-item` — Navigation item for navbar slots.\nRenders as an anchor when `href` is provided and item is not disabled.",
+          "description": "`ore-navbar-item`: Navigation item for navbar slots.\nRenders as an anchor when `href` is provided and item is not disabled.",
           "summary": "",
           "attributes": [
             {
@@ -15302,14 +15530,14 @@
             "text": "'ore-sidebar'"
           },
           "default": "'ore-sidebar'",
-          "description": "`ore-sidebar` — A collapsible navigation sidebar with group and item support."
+          "description": "`ore-sidebar`: A collapsible navigation sidebar with group and item support."
         },
         {
           "kind": "class",
           "name": "OreSidebarElement",
           "tagName": "ore-sidebar",
           "customElement": true,
-          "description": "`ore-sidebar` — A collapsible navigation sidebar with group and item support.",
+          "description": "`ore-sidebar`: A collapsible navigation sidebar with group and item support.",
           "summary": "",
           "attributes": [
             {
@@ -15487,14 +15715,14 @@
             "text": "'ore-sidebar-group'"
           },
           "default": "'ore-sidebar-group'",
-          "description": "`ore-sidebar-group` — A labelled section within `ore-sidebar`."
+          "description": "`ore-sidebar-group`: A labelled section within `ore-sidebar`."
         },
         {
           "kind": "class",
           "name": "OreSidebarGroupElement",
           "tagName": "ore-sidebar-group",
           "customElement": true,
-          "description": "`ore-sidebar-group` — A labelled section within `ore-sidebar`.",
+          "description": "`ore-sidebar-group`: A labelled section within `ore-sidebar`.",
           "summary": "",
           "attributes": [
             {
@@ -15559,14 +15787,14 @@
             "text": "'ore-sidebar-item'"
           },
           "default": "'ore-sidebar-item'",
-          "description": "`ore-sidebar-item` — An individual navigation item in a `ore-sidebar`.\n\nRenders as an `<a>` when `href` is provided, otherwise as a `<button>`.\nMarks the active page via `aria-current=\"page\"` when the `active` attribute is set."
+          "description": "`ore-sidebar-item`: An individual navigation item in a `ore-sidebar`.\n\nRenders as an `<a>` when `href` is provided, otherwise as a `<button>`.\nMarks the active page via `aria-current=\"page\"` when the `active` attribute is set."
         },
         {
           "kind": "class",
           "name": "OreSidebarItemElement",
           "tagName": "ore-sidebar-item",
           "customElement": true,
-          "description": "`ore-sidebar-item` — An individual navigation item in a `ore-sidebar`.\nRenders as an `<a>` when `href` is provided, otherwise as a `<button>`.\nMarks the active page via `aria-current=\"page\"` when the `active` attribute is set.",
+          "description": "`ore-sidebar-item`: An individual navigation item in a `ore-sidebar`.\nRenders as an `<a>` when `href` is provided, otherwise as a `<button>`.\nMarks the active page via `aria-current=\"page\"` when the `active` attribute is set.",
           "summary": "",
           "attributes": [
             {
@@ -15775,7 +16003,7 @@
               }
             }
           ],
-          "description": "Splits a display-only shortcut hint into individual keys so each can be rendered in its\nown `<kbd>`. Keys are separated with `+` (e.g. `\"⌘+N\"` → `[\"⌘\", \"N\"]`); a shortcut with no\n`+` renders as a single key, unchanged. A literal `+` key can't be represented this way —\nspell it out instead (e.g. `\"Ctrl+Plus\"`)."
+          "description": "Splits a display-only shortcut hint into individual keys so each can be rendered in its\nown `<kbd>`. Keys are separated with `+` (e.g. `\"⌘+N\"` → `[\"⌘\", \"N\"]`); a shortcut with no\n`+` renders as a single key, unchanged. A literal `+` key can't be represented this way :\nspell it out instead (e.g. `\"Ctrl+Plus\"`)."
         },
         {
           "kind": "function",
@@ -15896,14 +16124,14 @@
             "text": "'ore-command-palette-item'"
           },
           "default": "'ore-command-palette-item'",
-          "description": "A pure data node describing one command. Never rendered directly — `ore-command-palette`\nreads its attributes/text content and renders the visible row itself."
+          "description": "A pure data node describing one command. Never rendered directly: `ore-command-palette`\nreads its attributes/text content and renders the visible row itself."
         },
         {
           "kind": "class",
           "name": "OreCommandPaletteItemElement",
           "tagName": "ore-command-palette-item",
           "customElement": true,
-          "description": "A pure data node describing one command. Never rendered directly — `ore-command-palette`\nreads its attributes/text content and renders the visible row itself.",
+          "description": "A pure data node describing one command. Never rendered directly: `ore-command-palette`\nreads its attributes/text content and renders the visible row itself.",
           "summary": "",
           "attributes": [
             {
@@ -15932,7 +16160,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Display-only keyboard hint rendered at the end of the row, one `<kbd>` per `+`-separated key (e.g. `\"⌘+S\"` renders two keycaps; a literal `+` key isn't representable — spell it out, e.g. `\"Ctrl+Plus\"`)"
+              "description": "Display-only keyboard hint rendered at the end of the row, one `<kbd>` per `+`-separated key (e.g. `\"⌘+S\"` renders two keycaps; a literal `+` key isn't representable: spell it out, e.g. `\"Ctrl+Plus\"`)"
             },
             {
               "name": "disabled",
@@ -15962,14 +16190,14 @@
             "text": "'ore-command-palette'"
           },
           "default": "'ore-command-palette'",
-          "description": "A searchable, keyboard-driven list of commands presented in a centered modal —\nthe \"⌘K\" pattern popularized by editors and productivity apps. Built on the\nnative `<dialog>` element (focus trap, top-layer stacking, `Escape`-to-close)\nand `@vielzeug/keymap` for the global shortcut that opens it."
+          "description": "A searchable, keyboard-driven list of commands presented in a centered modal :\nthe \"⌘K\" pattern popularized by editors and productivity apps. Built on the\nnative `<dialog>` element (focus trap, top-layer stacking, `Escape`-to-close)\nand `@vielzeug/keymap` for the global shortcut that opens it."
         },
         {
           "kind": "class",
           "name": "OreCommandPaletteElement",
           "tagName": "ore-command-palette",
           "customElement": true,
-          "description": "A searchable, keyboard-driven list of commands presented in a centered modal —\nthe \"⌘K\" pattern popularized by editors and productivity apps. Built on the\nnative `<dialog>` element (focus trap, top-layer stacking, `Escape`-to-close)\nand `@vielzeug/keymap` for the global shortcut that opens it.",
+          "description": "A searchable, keyboard-driven list of commands presented in a centered modal :\nthe \"⌘K\" pattern popularized by editors and productivity apps. Built on the\nnative `<dialog>` element (focus trap, top-layer stacking, `Escape`-to-close)\nand `@vielzeug/keymap` for the global shortcut that opens it.",
           "summary": "",
           "attributes": [
             {
@@ -16037,6 +16265,13 @@
             }
           ],
           "events": [
+            {
+              "name": "active-change",
+              "description": "Fired when the focused row changes (keyboard, hover, typing, open, close). detail: `{ value, label, item }`; `item` is `undefined` and `value` empty when no row is active",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
             {
               "name": "open-change",
               "description": "Fired when the palette state changes. detail: `{ open, reason }`",
@@ -16063,6 +16298,10 @@
             {
               "name": "",
               "description": "`<ore-command-palette-item>` elements (alternative/supplement to the `items` prop)"
+            },
+            {
+              "name": "preview",
+              "description": "Optional detail panel rendered beside the list, shown while it has content. Pair it with `active-change` to preview the focused row"
             }
           ],
           "cssParts": [
@@ -16081,6 +16320,10 @@
             {
               "name": "listbox",
               "description": "Listbox of matching commands"
+            },
+            {
+              "name": "preview",
+              "description": "Preview panel shown beside the list"
             }
           ],
           "cssProperties": [
@@ -16115,6 +16358,10 @@
             {
               "name": "--command-palette-option-focus-bg",
               "description": "Item background when keyboard-focused"
+            },
+            {
+              "name": "--command-palette-preview-width",
+              "description": "Preview panel width when the `preview` slot has content"
             }
           ],
           "demos": [