@aceshooting/lyra-ui 7.6.0 → 7.8.0

package/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/web-types",
   "name": "@aceshooting/lyra-ui",
-  "version": "7.6.0",
+  "version": "7.8.0",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -822,6 +822,9 @@
                 ]
               }
             },
+            {
+              "name": "icon-only"
+            },
             {
               "name": "locale",
               "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.\n\nType: `string`  \nDefault: `''`",
@@ -904,17 +907,8 @@
         },
         {
           "name": "lr-archive-viewer",
-          "description": "Lists names and uncompressed sizes in a ZIP archive without rendering entry contents. Sizes use\narchive metadata when available; file entries without size metadata are inflated sequentially\nonce for measurement. The combined declared and measured uncompressed size is capped at 100 MB.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. |\n| `body` | The archive listing body. |\n| `entry` | An archive entry row. |\n| `entry-icon` | The decorative folder or file icon. |\n| `entry-name` | The entry path. |\n| `entry-name-dir` | The entry path of a directory row (also carries `entry-name`). |\n| `entry-size` | The human-readable file size. |\n| `error` | The error region. |\n| `spinner` | The loading region. |",
+          "description": "Lists names and uncompressed sizes in a ZIP archive without rendering entry contents. Sizes use\narchive metadata when available; file entries without size metadata are inflated sequentially\nonce for measurement. The combined declared and measured uncompressed size is capped at 100 MB.\nFragment anchors use the exact ZIP entry path as their `id`; text-quote anchors resolve against\neach complete entry path before the matching virtual row is scrolled into view. Text selections\nand painted highlights are likewise scoped to entry paths rendered in the nested virtual list.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. |\n| `body` | The archive listing body. |\n| `entry` | An archive entry row. |\n| `entry-icon` | The decorative folder or file icon. |\n| `entry-name` | The entry path. |\n| `entry-name-dir` | The entry path of a directory row (also carries `entry-name`). |\n| `entry-size` | The human-readable file size. |\n| `error` | The error region. |\n| `highlight` | A painted entry-path highlight (`<mark>` fallback path only). |\n| `spinner` | The loading region. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-archive-viewer-highlight-accent-background` — Accent highlight background.\n- `--lr-archive-viewer-highlight-success-background` — Success highlight background.\n- `--lr-archive-viewer-highlight-warning-background` — Warning highlight background.\n- `--lr-archive-viewer-highlight-danger-background` — Danger highlight background.\n- `--lr-archive-viewer-highlight-neutral-background` — Neutral highlight background.\n- `--lr-archive-viewer-highlight-active-background` — Active highlight background.\n- `--lr-archive-viewer-highlight-active-outline` — Active fallback-highlight outline.",
           "attributes": [
-            {
-              "name": "locale",
-              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.\n\nType: `string`  \nDefault: `''`",
-              "value": {
-                "type": [
-                  "string"
-                ]
-              }
-            },
             {
               "name": "name",
               "description": "Display name used as the archive listing's accessible label.\n\nType: `string`  \nDefault: `''`",
@@ -1178,7 +1172,7 @@
         },
         {
           "name": "lr-attachment-trigger",
-          "description": "`<lr-attachment-trigger>` — a compact attach affordance designed for a\nchat composer's leading slot (see `<lr-chat-composer>`'s own `leading`\nslot, which this drops straight into, though this component has no code\ndependency on it). Its shape adapts to how many attachment `capabilities`\nare configured:\n - Exactly one capability: a single plain icon button ([part='trigger']).\n   Activating it performs that capability's action directly.\n - More than one: a small anchored menu ([part='menu'], composed from\n   `<lr-menu>`/`<lr-menu-item>`) listing each capability as a row.\n\nTwo of the four capabilities (`files`, `image`) are file-picker-backed:\nactivating them opens a hidden native `<input type=\"file\">` via a\nsynthetic `.click()`, and the resulting selection is re-emitted as\n`lr-pick`. `accept` is shared across both — `image` defaults it to\n`'image/*'` unless the `accept` prop overrides it, `files` always uses\n`accept` as-is (empty means \"any file type\", matching a bare native\n`<input type=\"file\">` with no `accept` attribute).\n\n**`camera`/`audio` are scope-limited by design.** This component does not\nimplement any camera or microphone capture UI itself — no `getUserMedia`,\nno `<input capture>` — because that's entirely a host/browser concern with\nno single right answer (a desktop web app, a mobile PWA, and a native\nwrapper all want different things here). Activating `camera` fires\n`lr-camera-request`; activating `audio` fires `lr-audio-request`. The\nhost owns everything from that point on — typically opening\n`<lr-push-to-talk>` in a `<lr-overlay>`/popover for `audio`, then\nhanding the resulting blob to something like `<lr-attachment-chip>`.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `expand-icon` | The disclosure chevron inside the multi-capability trigger button. Only rendered when `capabilities.length > 1`. |\n| `hidden-input` | The internal native `<input type=\"file\">` that actually opens the OS file picker. Hidden (`display: none`) by default; exposed as a part only so a consumer can override that with `::part(hidden-input)` in the unlikely case their integration needs to. `triggerLabel` lets a host override the single-capability trigger button's `aria-label` (i18n) — see that property's own doc for exactly what it does and doesn't affect. |\n| `menu` | The `<lr-menu>` wrapper. Only rendered when `capabilities.length > 1`. |\n| `menu-trigger` | The multi-capability button slotted into `<lr-menu>`'s own `trigger` slot. Only rendered when `capabilities.length > 1`. |\n| `trigger` | The single-capability icon button. Only rendered when `capabilities.length === 1`. |",
+          "description": "`<lr-attachment-trigger>` — a compact attach affordance designed for a\nchat composer's leading slot (see `<lr-chat-composer>`'s own `leading`\nslot, which this drops straight into, though this component has no code\ndependency on it). Its shape adapts to how many attachment `capabilities`\nare configured:\n - Exactly one capability: a single plain icon button ([part='trigger']).\n   Activating it performs that capability's action directly.\n - More than one: a small anchored menu ([part='menu'], composed from\n   `<lr-menu>`/`<lr-menu-item>`) listing each capability as a row.\n\nTwo of the four capabilities (`files`, `image`) are file-picker-backed:\nactivating them opens a hidden native `<input type=\"file\">` via a\nsynthetic `.click()`, and the resulting selection is re-emitted as\n`lr-pick`. `accept` is shared across both — `image` defaults it to\n`'image/*'` unless the `accept` prop overrides it, `files` always uses\n`accept` as-is (empty means \"any file type\", matching a bare native\n`<input type=\"file\">` with no `accept` attribute).\n\n**`camera`/`audio` are scope-limited by design.** This component does not\nimplement any camera or microphone capture UI itself — no `getUserMedia`,\nno `<input capture>` — because that's entirely a host/browser concern with\nno single right answer (a desktop web app, a mobile PWA, and a native\nwrapper all want different things here). Activating `camera` fires\n`lr-camera-request`; activating `audio` fires `lr-audio-request`. The\nhost owns everything from that point on — typically opening\n`<lr-push-to-talk>` in a `<lr-overlay>`/popover for `audio`, then\nhanding the resulting blob to something like `<lr-attachment-chip>`.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `expand-icon` | The disclosure chevron inside the multi-capability trigger button. Only rendered when `capabilities.length > 1`. |\n| `hidden-input` | The internal native `<input type=\"file\">` that actually opens the OS file picker. Hidden (`display: none`) by default; exposed as a part only so a consumer can override that with `::part(hidden-input)` in the unlikely case their integration needs to. `triggerLabel` supplies a fallback for the single-capability trigger button's accessible name (i18n) — see that property's own doc for exactly what it does and doesn't affect. A host `aria-label` wins on either trigger shape. |\n| `menu` | The `<lr-menu>` wrapper. Only rendered when `capabilities.length > 1`. |\n| `menu-trigger` | The multi-capability button slotted into `<lr-menu>`'s own `trigger` slot. Only rendered when `capabilities.length > 1`. |\n| `trigger` | The single-capability icon button. Only rendered when `capabilities.length === 1`. |",
           "attributes": [
             {
               "name": "accept",
@@ -1218,7 +1212,7 @@
             },
             {
               "name": "trigger-label",
-              "description": "Overrides the single-capability trigger button's `aria-label`, which\notherwise comes from `this.localize()` (e.g. `'Attach files'`, localizable\nvia `.strings`/`registerLyraLocale()`). Set this for a one-off override;\nleave it unset to keep the localized default. Only affects the\nsingle-capability button ([part='trigger']) — the multi-capability\nmenu's own trigger keeps its own `'Add attachment'` label regardless.\n\nType: `string | undefined`"
+              "description": "Accessible-name fallback for the single-capability trigger button when the host has no\n`aria-label`; otherwise the name comes from `this.localize()` (e.g. `'Attach files'`,\nlocalizable via `.strings`/`registerLyraLocale()`). Only affects the single-capability button\n(`[part='trigger']`) — the multi-capability menu uses its own localized `'Add attachment'`\nfallback.\n\nType: `string | undefined`"
             },
             {
               "name": "trigger-title",
@@ -1530,7 +1524,7 @@
         },
         {
           "name": "lr-bar-chart",
-          "description": "`<lr-bar-chart>` — `<lr-chart>` with `type` locked to `\"bar\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-bar-chart>` — `<lr-chart>` with `type` locked to `\"bar\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -1698,7 +1692,7 @@
         },
         {
           "name": "lr-box-plot",
-          "description": "`<lr-box-plot>` — a box-and-whisker chart from precomputed five-number\nsummaries (no raw sample data is shipped to the browser). Beyond Web\nAwesome's chart set — useful for summarizing distributions.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The box-plot canvas. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible box-plot summary. |\n| `error` | `role=\"alert\"` message shown instead of the canvas when the optional box-plot peer dependency fails to load. |",
+          "description": "`<lr-box-plot>` — a box-and-whisker chart from precomputed five-number\nsummaries (no raw sample data is shipped to the browser). Beyond Web\nAwesome's chart set — useful for summarizing distributions.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The box-plot canvas. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible box-plot summary. |\n| `error` | `role=\"alert\"` message shown instead of the canvas when the optional box-plot peer dependency fails to load. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas region. |",
           "attributes": [
             {
               "name": "accessible-description",
@@ -1897,7 +1891,7 @@
             },
             {
               "name": "frame-src",
-              "description": "Type: `string`  \nDefault: `''`",
+              "description": "Type: `string`",
               "value": {
                 "type": [
                   "string"
@@ -1935,7 +1929,7 @@
         },
         {
           "name": "lr-bubble-chart",
-          "description": "`<lr-bubble-chart>` — `<lr-chart>` with `type` locked to `\"bubble\"`. Feed\npoints via `Series.points`, each needing an `x`/`y`/`r` (radius) triple —\ncast the array through `as unknown as Series['points']` (or a local\n`BubblePoint` type) when constructing it, since `Series.points` itself is\ntyped as `{ x; y; label? }[]` with no `r` field.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-bubble-chart>` — `<lr-chart>` with `type` locked to `\"bubble\"`. Feed\npoints via `Series.points`, whose exported `ChartPoint` type carries\n`x`/`y`, optional bubble `r` (radius), and an optional per-point `label`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -2304,7 +2298,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable event body.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -2535,7 +2529,7 @@
         },
         {
           "name": "lr-chart",
-          "description": "`<lr-chart>` — the core Chart.js wrapper every other `lr-*-chart` tag\nsubclasses. Requires the optional peer dep `chart.js`; `chartjs-plugin-zoom`\n(for `zoom`) and `chartjs-plugin-datalabels` (for `data-labels`/`stack-totals`)\nare further optional peers loaded only on demand.\n\n**API mirror note:** the real `wa-chart` docs page\n(https://webawesome.com/docs/components/chart/) documents a `config:\nChartJS['config']` property alongside its simplified attributes — \"a\nflexible wrapper around Chart.js\" supporting *both* simplified attributes\nand full Chart.js configuration passthrough, not a `data`/`options` prop\npair. `lr-chart` mirrors that dual surface: the `Series`-based\n`datasets`/`labels`/`type`/`legend`/`xLabel`/`yLabel`/`zoom` attributes\nbelow are the simplified surface (compatible with WA's `type`, `xLabel`,\n`yLabel`, `withoutLegend`-equivalent `legend`, etc.), and the additional\n`config` property is the raw-passthrough escape hatch — a\n`Partial<ChartConfiguration>` deep-merged over the generated config in\n`buildConfig()`, mirroring WA's `config` property without discarding the\n`Series` shape the rest of this component family (subclasses, box-plot,\nhistogram) is built on.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-chart>` — the core Chart.js wrapper every other `lr-*-chart` tag\nsubclasses. Requires the optional peer dep `chart.js`; `chartjs-plugin-zoom`\n(for `zoom`) and `chartjs-plugin-datalabels` (for `data-labels`/`stack-totals`)\nare further optional peers loaded only on demand.\n\n**API mirror note:** the real `wa-chart` docs page\n(https://webawesome.com/docs/components/chart/) documents a `config:\nChartJS['config']` property alongside its simplified attributes — \"a\nflexible wrapper around Chart.js\" supporting *both* simplified attributes\nand full Chart.js configuration passthrough, not a `data`/`options` prop\npair. `lr-chart` mirrors that dual surface: the `Series`-based\n`datasets`/`labels`/`type`/`legend`/`xLabel`/`yLabel`/`zoom` attributes\nbelow are the simplified surface (compatible with WA's `type`, `xLabel`,\n`yLabel`, `withoutLegend`-equivalent `legend`, etc.), and the additional\n`config` property is the raw-passthrough escape hatch — a\n`Partial<ChartConfiguration>` deep-merged over the generated config in\n`buildConfig()`, mirroring WA's `config` property without discarding the\n`Series` shape the rest of this component family (subclasses, box-plot,\nhistogram) is built on.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -3016,7 +3010,7 @@
         },
         {
           "name": "lr-checkbox",
-          "description": "`<lr-checkbox>` — a boolean form control. Structurally the same idea as\n`<lr-switch>` (form-associated via `ElementInternals`, click and\nSpace both toggle) but with checkbox semantics: `role=\"checkbox\"` +\nan `aria-checked` that can also be `\"mixed\"`, and a visual box/checkmark\ninstead of a track/thumb.\n\n`checked` is not a plain string, so this attaches `ElementInternals`\ndirectly and implements its own `updateValidity()` rather than using the\n`FormAssociated` mixin — see `<lr-combobox>` for the same\ndirect-`ElementInternals` shape with a non-string value.\n\nDeliberately no hint/error chrome of its own -- the default slot already carries real, visible\nlabel text (see `@slot` below), so a labeled-field frame built around `label`/`hint`/`errorText`\nprops has nothing to add here. A consumer needing hint/error messaging composes it in their own\nwrapper (e.g. `<lr-tool-param-form>` folds a boolean field's validation error into adjacent\ndescription text / `aria-label` rather than a `<lr-checkbox>`-owned slot), the same way a\nnative `<input type=\"checkbox\">` plus `<label>` pairs with an externally-owned error node.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Label text, rendered next to the box. Clicking it toggles the checkbox, the same as clicking a native checkbox's associated `<label>`. If left empty, set `aria-label` on the host so the control still has an accessible name. A host `aria-describedby` attribute is resolved onto the internal `role=\"checkbox\"` through `ariaDescribedByElements` so externally-owned descriptions remain valid across the shadow boundary. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The whole interactive control (`role=\"checkbox\"`); wraps the box and label. |\n| `box` | The small square that shows the checkmark/indeterminate dash. |\n| `checkmark` | The checkmark (or indeterminate dash) glyph inside the box. |\n| `label` | The wrapper around the default slot. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-checkbox-label-indent` (default: `calc(min(var(--lr-icon-button-size), 1.75rem) + var(--lr-space-s))`) — The inline distance from the control's start edge to the start of the label text, i.e. the box's own floor plus the gap next to it. Published so a consumer composing per-option hint text under the label can align it without re-deriving that formula from the shadow styles, and used as the source of the real gap so the two cannot drift. Setting it on the element (or on `lr-checkbox` in your own stylesheet) moves the label; because custom properties inherit down and not sideways, it is *not* readable from a sibling node in your tree — align a sibling by computing the same formula from `--lr-theme-icon-button-size` and `--lr-theme-space-s`, which you control.\n- `--lr-checkbox-checked-bg` (default: `var(--lr-color-brand)`) — Background of `[part='box']` while `checked` or `indeterminate`. Retint just this control's checked fill without touching the shared `--lr-color-brand` token every other component also reads.\n- `--lr-checkbox-checked-border` (default: `var(--lr-color-brand)`) — Border color of `[part='box']` while `checked` or `indeterminate`.",
+          "description": "`<lr-checkbox>` — a boolean form control. Structurally the same idea as\n`<lr-switch>` (form-associated via `ElementInternals`, click and\nSpace both toggle) but with checkbox semantics: `role=\"checkbox\"` +\nan `aria-checked` that can also be `\"mixed\"`, and a visual box/checkmark\ninstead of a track/thumb.\n\n`checked` is not a plain string, so this attaches `ElementInternals`\ndirectly and implements its own `updateValidity()` rather than using the\n`FormAssociated` mixin — see `<lr-combobox>` for the same\ndirect-`ElementInternals` shape with a non-string value.\n\nDeliberately no hint/error chrome of its own -- the default slot already carries real, visible\nlabel text (see `@slot` below), so a labeled-field frame built around `label`/`hint`/`errorText`\nprops has nothing to add here. A consumer needing hint/error messaging composes it in their own\nwrapper (e.g. `<lr-tool-param-form>` supplies adjacent description/error nodes through this\ncomponent's `aria-describedby` bridge rather than a `<lr-checkbox>`-owned slot), the same way a\nnative `<input type=\"checkbox\">` plus `<label>` pairs with an externally-owned error node.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Label text, rendered next to the box. Clicking it toggles the checkbox, the same as clicking a native checkbox's associated `<label>`. If left empty, set `aria-label` on the host so the control still has an accessible name. A host `aria-describedby` attribute is resolved onto the internal `role=\"checkbox\"` through `ariaDescribedByElements` so externally-owned descriptions remain valid across the shadow boundary. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The whole interactive control (`role=\"checkbox\"`); wraps the box and label. |\n| `box` | The small square that shows the checkmark/indeterminate dash. |\n| `checkmark` | The checkmark (or indeterminate dash) glyph inside the box. |\n| `label` | The wrapper around the default slot. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-checkbox-label-indent` (default: `calc(min(var(--lr-icon-button-size), 1.75rem) + var(--lr-space-s))`) — The inline distance from the control's start edge to the start of the label text, i.e. the box's own floor plus the gap next to it. Published so a consumer composing per-option hint text under the label can align it without re-deriving that formula from the shadow styles, and used as the source of the real gap so the two cannot drift. Setting it on the element (or on `lr-checkbox` in your own stylesheet) moves the label; because custom properties inherit down and not sideways, it is *not* readable from a sibling node in your tree — align a sibling by computing the same formula from `--lr-theme-icon-button-size` and `--lr-theme-space-s`, which you control.\n- `--lr-checkbox-checked-bg` (default: `var(--lr-color-brand)`) — Background of `[part='box']` while `checked` or `indeterminate`. Retint just this control's checked fill without touching the shared `--lr-color-brand` token every other component also reads.\n- `--lr-checkbox-checked-border` (default: `var(--lr-color-brand)`) — Border color of `[part='box']` while `checked` or `indeterminate`.",
           "attributes": [
             {
               "name": "checked",
@@ -3245,7 +3239,7 @@
             },
             {
               "name": "selected",
-              "description": "Opt-in toggle/pressed mode -- the current pressed value. Setting `selected` (to `true`, the\ncommon way to start a chip already pressed) opts the chip into toggle mode automatically, so\n`<lr-chip selected>` alone is enough: `[part='toggle-button']` renders as a native,\nkeyboard-activatable button and reflects\n`aria-pressed`, and toggles on click/activation, emitting `lr-chip-select`. That opt-in\n(tracked by `toggleable`, see below) persists once made, so toggling `selected` back to\n`false` never strips the chip's interactivity -- a chip a user has clicked \"off\" must stay\nclickable to turn it back \"on\". Has no effect when combined with `removable`, since that\nmode already owns the chip's one native action. The label slot is inert in toggle mode, so\nunrestricted slotted descendants can never nest inside or double-activate the real button.\nThis component's two real use cases (a chart-series visibility\ntoggle, a category filter chip) never need both at once. `false` (the default, with\n`toggleable` also left at its default) reproduces today's exact passive-label-pill output.\n\nType: `boolean`  \nDefault: `false`",
+              "description": "Type: `boolean`",
               "value": {
                 "type": [
                   "boolean"
@@ -3287,7 +3281,7 @@
         },
         {
           "name": "lr-chip-group",
-          "description": "`<lr-chip-group>` — a flex-wrap container for a set of `<lr-chip>`\nchildren (plain light-DOM composition — direct children are the chips,\nthe same shape `<lr-split>`'s panels / `<lr-source-list>`'s cards\ntake — no `.items` array prop).\n\n`max-visible` is entirely optional. When unset, every child is always\nshown and this component does nothing beyond flex-wrap layout. When set\nand the group has more chip children than that, the excess children are\nhidden (via their own `hidden` property — CSS alone can't parameterize\n`:nth-child` on a runtime prop, so this reaches into the light DOM the\nsame way `<lr-split>` sets each panel's inline `flex`/`order`) and a\n\"+N\" overflow-indicator pill takes their place. Clicking it is a toggle:\nit reveals the rest (and relabels itself \"Show less\"); clicking again\nre-collapses back to `max-visible`. `lr-overflow-toggle` fires only from\nthat click — i.e. only when `max-visible` is actually causing an overflow\nstate — never as a side effect of `max-visible`/children changing on\ntheir own.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | `<lr-chip>` elements (or any content, though the chip pairing is the intended usage). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The flex-wrap container (holds both the slot and the overflow indicator). |\n| `overflow-indicator` | The \"+N\" / \"Show less\" toggle button. Only rendered while `max-visible` is actively causing an overflow. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chip-group-overflow-expanded-color` (default: `var(--lr-color-text)`) — Text color of `[part=\"overflow-indicator\"]` while expanded (`aria-expanded=\"true\"`). `::part(overflow-indicator)[aria-expanded='true']` is invalid CSS, so this is the only way to retint the expanded state without re-pointing the shared `--lr-color-text` token.",
+          "description": "`<lr-chip-group>` — a flex-wrap container for a set of `<lr-chip>`\nchildren (plain light-DOM composition — direct children are the chips,\nthe same shape `<lr-split>`'s panels / `<lr-source-list>`'s cards\ntake — no `.items` array prop).\n\n`max-visible` is entirely optional. When unset, every child is always\nshown and this component does nothing beyond flex-wrap layout. When set\nand the group has more chip children than that, the excess children are\nhidden (via their own `hidden` property — CSS alone can't parameterize\n`:nth-child` on a runtime prop, so this reaches into the light DOM the\nsame way `<lr-split>` sets each panel's inline `flex`/`order`) and a\n\"+N\" overflow-indicator pill takes their place. Clicking it is a toggle:\nit reveals the rest (and relabels itself \"Show less\"); clicking again\nre-collapses back to `max-visible`. `lr-overflow-toggle` fires only from\nthat click — i.e. only when `max-visible` is actually causing an overflow\nstate — never as a side effect of `max-visible`/children changing on\ntheir own.\n\nAuthor-owned `hidden` changes remain live while collapse management is active. The latest author\nstate is restored when a child leaves or the group disconnects, and reconnecting reapplies the\ncurrent collapsed state.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | `<lr-chip>` elements (or any content, though the chip pairing is the intended usage). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The flex-wrap container (holds both the slot and the overflow indicator). |\n| `overflow-indicator` | The \"+N\" / \"Show less\" toggle button. Only rendered while `max-visible` is actively causing an overflow. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chip-group-overflow-expanded-color` (default: `var(--lr-color-text)`) — Text color of `[part=\"overflow-indicator\"]` while expanded (`aria-expanded=\"true\"`). `::part(overflow-indicator)[aria-expanded='true']` is invalid CSS, so this is the only way to retint the expanded state without re-pointing the shared `--lr-color-text` token.",
           "attributes": [
             {
               "name": "locale",
@@ -3383,7 +3377,7 @@
             },
             {
               "name": "label",
-              "description": "Overrides the computed accessible name (`\"Citation {index}[, {status}]\"`).\n\nType: `string`  \nDefault: `''`",
+              "description": "Adds source context to the accessible name while retaining the visible citation index\n(`\"Citation {index}, {label}\"`).\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -3829,7 +3823,7 @@
             },
             {
               "name": "resize",
-              "description": "Type: `'none' | 'both' | 'horizontal' | 'vertical'`  \nDefault: `'both'`"
+              "description": "Native CSS `resize` behavior. An invalid runtime value falls back to `'both'`.\n\nType: `'none' | 'both' | 'horizontal' | 'vertical'`  \nDefault: `'both'`"
             },
             {
               "name": "spellcheck",
@@ -4341,7 +4335,7 @@
         },
         {
           "name": "lr-compare-panel",
-          "description": "`<lr-compare-panel>` — side-by-side A/B output comparison with a winner\nvote (LMSYS-arena / LangSmith-pairwise style): two slotted panes, a vote\nbar, synchronized reading.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `a` | The first output (any content — a chat message, markdown, a viewer). |\n| `b` | The second output. |\n| `prompt` | Optional shared-input header above both panes. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer wrapper. |\n| `live-region` | The internal vote-announcement live region. |\n| `pane-a` | The first pane's labeled scroll region. |\n| `pane-b` | The second pane's labeled scroll region. |\n| `pane-header` | A pane's visible heading. |\n| `panes` | The row (or, under 640px, column) wrapping both panes. |\n| `prompt` | The optional prompt header, hidden when the `prompt` slot is empty. |\n| `vote-bar` | The `role=\"group\"` row of vote buttons. |\n| `vote-button` | One vote button. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-compare-panel-max-height` (default: `var(--lr-size-24rem)`) — Cap on how tall each pane's scroll region grows before it scrolls internally.",
+          "description": "`<lr-compare-panel>` — side-by-side A/B output comparison with a winner\nvote (LMSYS-arena / LangSmith-pairwise style): two slotted panes, a vote\nbar, synchronized reading.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `a` | The first output (any content — a chat message, markdown, a viewer). |\n| `b` | The second output. |\n| `prompt` | Optional shared-input header above both panes. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer wrapper. |\n| `live-region` | The internal vote-announcement live region. |\n| `pane-a` | The first pane's labeled scroll region. |\n| `pane-b` | The second pane's labeled scroll region. |\n| `pane-header` | A pane's visible heading. |\n| `panes` | The row (or, under 640px, column) wrapping both panes. |\n| `prompt` | The optional prompt header, hidden when the `prompt` slot is empty. |\n| `vote-bar` | The `role=\"group\"` row of vote buttons. |\n| `vote-button` | One vote button. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-compare-panel-max-height` (default: `var(--lr-size-24rem)`) — Cap on how tall each pane's scroll region grows before it scrolls internally.\n- `--lr-compare-panel-selected-background` (default: `var(--lr-color-brand-quiet)`) — Selected vote button background.\n- `--lr-compare-panel-selected-border-color` (default: `var(--lr-color-brand)`) — Selected vote button border color.\n- `--lr-compare-panel-selected-color` (default: `var(--lr-color-brand)`) — Selected vote button text color.",
           "attributes": [
             {
               "name": "disabled",
@@ -4423,7 +4417,7 @@
         },
         {
           "name": "lr-confirm-bar",
-          "description": "`<lr-confirm-bar>` — an inline, non-modal approve/deny block for one proposed action: the\nin-flow sibling of `<lr-tool-approval-dialog>` for confirmations that should sit in the\ntranscript instead of hijacking focus. Same `lr-approve`/`lr-deny` event shapes as the dialog,\nand the same `toolApprovalHeading`/`toolApprovalArgsLabel`/`deny`/`approve` localization keys, so\nthe two always translate in lockstep.\n\nNon-modal by contract: no focus trap, no scroll lock, no Escape/backdrop semantics, and it never\nsteals focus when it appears in the transcript. DOM and tab order put Deny before Approve (the\ndialog's safe-action-first rationale). On activation, focus moves synchronously to `[part=\"status\"]`\n(an always-rendered, `tabindex=\"-1\"` element) *before* the Deny/Approve buttons unmount, so focus\nnever has a gap where it would otherwise fall back to `<body>`.\n\nNo argument editing (escalate to `<lr-tool-approval-dialog>`'s `editable` when edit-before-approve\nmatters); no blocking/modality guarantee (a user can scroll past); no decision persistence or\n\"remember choice\" logic (the `footer` slot + host own that).\n\nDeny/Approve are `<lr-button>`s (`variant=\"neutral\"`/`\"brand\"`, `\"danger\"` under `tone=\"danger\"`),\nre-exporting `lr-button`'s own `base`/`label`/`start`/`end`/`spinner` parts under\n`{deny,approve}-button-{base,label,start,end,spinner}` so `--lr-button-*` theming and a consumer's\nexisting `lr-button` style fragments reach them like every other button in an app. An\n`lr-approve`/`lr-deny` listener can call `preventDefault()` to keep the decision open while its own\nasync work (e.g. a network call) is in flight: `pending` is set to the decision being made, showing\n`loading` on that button and `disabled` on the other, until the host finalizes by setting `.decision`\nor bounces back by clearing `.pending` to `null`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Supplementary body content between the heading and the actions (e.g. a `lr-diff-view` of the proposed change). |\n| `footer` | Extra content at the start of the action row (e.g. a \"remember this choice\" checkbox), mirroring `lr-tool-approval-dialog`'s own `footer` slot. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `approve-button` | The built-in Approve `<lr-button>`. Named identically to the dialog's part. |\n| `approve-button-base` | Forwarded from the internal Approve `<lr-button>`'s own `base` part. |\n| `approve-button-end` | Forwarded from the internal Approve `<lr-button>`'s own `end` part. |\n| `approve-button-label` | Forwarded from the internal Approve `<lr-button>`'s own `label` part. |\n| `approve-button-spinner` | Forwarded from the internal Approve `<lr-button>`'s own `spinner` part, present only while `pending` is `'approved'`. |\n| `approve-button-start` | Forwarded from the internal Approve `<lr-button>`'s own `start` part. |\n| `args` | The `lr-details` + `lr-json-viewer` wrapper. Only rendered when `args` is defined. |\n| `base` | The root (`role=\"group\"`). |\n| `body` | The default-slot wrapper. |\n| `deny-button` | The built-in Deny `<lr-button>`. Named identically to the dialog's part. |\n| `deny-button-base` | Forwarded from the internal Deny `<lr-button>`'s own `base` part. |\n| `deny-button-end` | Forwarded from the internal Deny `<lr-button>`'s own `end` part. |\n| `deny-button-label` | Forwarded from the internal Deny `<lr-button>`'s own `label` part. |\n| `deny-button-spinner` | Forwarded from the internal Deny `<lr-button>`'s own `spinner` part, present only while `pending` is `'denied'`. |\n| `deny-button-start` | Forwarded from the internal Deny `<lr-button>`'s own `start` part. |\n| `footer` | The action row. |\n| `heading` | The heading. |\n| `status` | The decided-state text. Always present in the DOM (`tabindex=\"-1\"`) so focus has a stable, synchronous landing spot on activation. |\n| `tool-name` | The tool-name span within the heading. Only rendered when `heading` is unset. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-confirm-bar-compact-padding` (default: `0`) — Padding of `[part='base']` while `compact`. Accepts any padding shorthand.\n- `--lr-confirm-bar-compact-gap` (default: `var(--lr-space-s)`) — Gap between the row's items while `compact`.\n- `--lr-confirm-bar-compact-border` (default: `none`) — Border of `[part='base']` while `compact`. Accepts any `border` shorthand.\n- `--lr-confirm-bar-compact-radius` (default: `0`) — Border radius of `[part='base']` while `compact` (only visible once `--lr-confirm-bar-compact-border`/`-background` are set).\n- `--lr-confirm-bar-compact-background` (default: `transparent`) — Background of `[part='base']` while `compact`.\n- `--lr-confirm-bar-approved-color` (default: `var(--lr-color-success)`) — `[part='status']` text/icon color once `decision` is `'approved'`.\n- `--lr-confirm-bar-denied-color` (default: `var(--lr-color-danger)`) — `[part='status']` text/icon color once `decision` is `'denied'`.",
+          "description": "`<lr-confirm-bar>` — an inline, non-modal approve/deny block for one proposed action: the\nin-flow sibling of `<lr-tool-approval-dialog>` for confirmations that should sit in the\ntranscript instead of hijacking focus. Same `lr-approve`/`lr-deny` event shapes as the dialog,\nand the same `toolApprovalHeading`/`toolApprovalArgsLabel`/`deny`/`approve` localization keys, so\nthe two always translate in lockstep.\n\nNon-modal by contract: no focus trap, no scroll lock, no Escape/backdrop semantics, and it never\nsteals focus when it appears in the transcript. DOM and tab order put Deny before Approve (the\ndialog's safe-action-first rationale). On activation, focus moves synchronously to `[part=\"status\"]`\n(an always-rendered, `tabindex=\"-1\"` element) *before* the Deny/Approve buttons unmount, so focus\nnever has a gap where it would otherwise fall back to `<body>`.\n\n\"Never steals focus\" and \"no Escape semantics\" describe what *this element* does on its own. A\nhost that swaps a focused control out for this bar is expected to move focus into it and to bind\nEscape to its own cancel path (`<lr-memory-panel>` does both), since otherwise focus would fall\nto `<body>` when the control it replaced unmounts. That stays a host decision: nothing here traps\nfocus, locks scrolling, or handles Escape.\n\nNo argument editing (escalate to `<lr-tool-approval-dialog>`'s `editable` when edit-before-approve\nmatters); no blocking/modality guarantee (a user can scroll past); no decision persistence or\n\"remember choice\" logic (the `footer` slot + host own that).\n\nDeny/Approve are `<lr-button>`s (`variant=\"neutral\"`/`\"brand\"`, `\"danger\"` under `tone=\"danger\"`),\nre-exporting `lr-button`'s own `base`/`label`/`start`/`end`/`spinner` parts under\n`{deny,approve}-button-{base,label,start,end,spinner}` so `--lr-button-*` theming and a consumer's\nexisting `lr-button` style fragments reach them like every other button in an app. An\n`lr-approve`/`lr-deny` listener can call `preventDefault()` to keep the decision open while its own\nasync work (e.g. a network call) is in flight: `pending` is set to the decision being made, showing\n`loading` on that button and `disabled` on the other, until the host finalizes by setting `.decision`\nor bounces back by clearing `.pending` to `null`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Supplementary body content between the heading and the actions (e.g. a `lr-diff-view` of the proposed change). |\n| `footer` | Extra content at the start of the action row (e.g. a \"remember this choice\" checkbox), mirroring `lr-tool-approval-dialog`'s own `footer` slot. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `approve-button` | The built-in Approve `<lr-button>`. Named identically to the dialog's part. |\n| `approve-button-base` | Forwarded from the internal Approve `<lr-button>`'s own `base` part. |\n| `approve-button-end` | Forwarded from the internal Approve `<lr-button>`'s own `end` part. |\n| `approve-button-label` | Forwarded from the internal Approve `<lr-button>`'s own `label` part. |\n| `approve-button-spinner` | Forwarded from the internal Approve `<lr-button>`'s own `spinner` part, present only while `pending` is `'approved'`. |\n| `approve-button-start` | Forwarded from the internal Approve `<lr-button>`'s own `start` part. |\n| `args` | The `lr-details` + `lr-json-viewer` wrapper. Only rendered when `args` is defined. |\n| `base` | The root (`role=\"group\"`). |\n| `body` | The default-slot wrapper. |\n| `deny-button` | The built-in Deny `<lr-button>`. Named identically to the dialog's part. |\n| `deny-button-base` | Forwarded from the internal Deny `<lr-button>`'s own `base` part. |\n| `deny-button-end` | Forwarded from the internal Deny `<lr-button>`'s own `end` part. |\n| `deny-button-label` | Forwarded from the internal Deny `<lr-button>`'s own `label` part. |\n| `deny-button-spinner` | Forwarded from the internal Deny `<lr-button>`'s own `spinner` part, present only while `pending` is `'denied'`. |\n| `deny-button-start` | Forwarded from the internal Deny `<lr-button>`'s own `start` part. |\n| `footer` | The action row. |\n| `heading` | The heading. |\n| `status` | The decided-state text. Always present in the DOM (`tabindex=\"-1\"`) so focus has a stable, synchronous landing spot on activation. |\n| `tool-name` | The tool-name span within the heading. Only rendered when `heading` is unset. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-confirm-bar-compact-padding` (default: `0`) — Padding of `[part='base']` while `compact`. Accepts any padding shorthand.\n- `--lr-confirm-bar-compact-gap` (default: `var(--lr-space-s)`) — Gap between the row's items while `compact`.\n- `--lr-confirm-bar-compact-border` (default: `none`) — Border of `[part='base']` while `compact`. Accepts any `border` shorthand.\n- `--lr-confirm-bar-compact-radius` (default: `0`) — Border radius of `[part='base']` while `compact` (only visible once `--lr-confirm-bar-compact-border`/`-background` are set).\n- `--lr-confirm-bar-compact-background` (default: `transparent`) — Background of `[part='base']` while `compact`.\n- `--lr-confirm-bar-approved-color` (default: `var(--lr-color-success)`) — `[part='status']` text/icon color once `decision` is `'approved'`.\n- `--lr-confirm-bar-denied-color` (default: `var(--lr-color-danger)`) — `[part='status']` text/icon color once `decision` is `'denied'`.",
           "attributes": [
             {
               "name": "compact",
@@ -4505,7 +4499,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable body.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -4622,7 +4616,7 @@
           "attributes": [
             {
               "name": "label",
-              "description": "Accessible name for the group, set as `aria-label` on the internal\n`role=\"group\"` element. A plain `aria-label` attribute on the host itself is\nhonored as a fallback when this is left unset, matching `<lr-button-group>`.\n\nType: `string`  \nDefault: `''`",
+              "description": "Accessible-name fallback for the internal `role=\"group\"` element when the host has no\n`aria-label`, matching `<lr-button-group>`.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -4801,7 +4795,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable body.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -4830,7 +4824,7 @@
         },
         {
           "name": "lr-dashboard-grid",
-          "description": "`<lr-dashboard-grid>` — a responsive, keyboard-accessible widget grid: positions `layout`\nentries (`DashboardCell`: `x`/`y`/`w`/`h` grid units + a widget descriptor) on a CSS Grid,\ncomposing `<lr-widget>` + `<lr-widget-renderer>` for each cell's default content, and owns all\ndrag/resize/collision interaction as controlled events -- it never mutates `layout` itself, nor\never touches `localStorage`/network; the host applies (or ignores) every emitted event and owns\npersistence entirely, mirroring `lr-flow-canvas`/`lr-table`'s own controlled-component\nconvention. Readonly (viewer) by default; opt into editor gestures individually via\n`cells-draggable`/`cells-resizable`, or lock the whole grid via `locked`.\n\nCell content: a `layout` entry with no matching light-DOM child (matched by `cell-id`) gets a\ndefault `<lr-widget label=\"...\">` wrapping an `<lr-widget-renderer .tree=${cell.widget}>`\nauto-created and adopted into `slot=\"cell-{id}\"` -- this component's own job is the grid\nlayout/drag/resize/collision/persistence-event mechanics *around* that content, not widget\nrendering itself (see `lr-widget-renderer`'s own doc for its declarative-tree contract). A\nconsumer wanting full control over one cell's markup can instead author\n`<div cell-id=\"...\">...</div>` as a direct child; it is adopted in place of the default cell.\n\nKeyboard: cells share one roving tabindex, in row-major (`sortSpatial`) order. Arrow\nkeys/Home/End move the roving focus (RTL-aware: physical Left/Right always match what the\ncursor visually does, matching `lr-flow-canvas`'s own convention). While a cell has focus,\nCtrl/Cmd+Arrow moves it by one grid unit and Ctrl/Cmd+Shift+Arrow resizes it by one grid unit\n(Right/Down grow, Left/Up shrink) -- the full keyboard-operable equivalent of the pointer\ndrag/resize gestures below, per this library's accessibility bar (no pointer-only interaction).\n\nCollision: every move/resize request -- pointer or keyboard -- is resolved through `collision`\n(`'reject'` the default, `'push'`, or `'overlap'`; see `resolvePlacement()` in `layout.ts` for\nthe exact rule). A rejected request leaves `layout` untouched and only announces; an accepted\none emits `lr-cell-move`/`lr-cell-resize` plus a `lr-layout-change` snapshot of the full\nproposed layout (including any `'push'` cascade) -- the host's one persistence hook: listen for\nit and persist `event.detail.layout` however it likes (`localStorage`, a network call, neither).\n\nResponsive: below a ~40rem container allocation (`@container`, not the viewport -- a dashboard\ngrid is commonly embedded in a panel of varying width), cells stack into a single flowing\ncolumn in the same row-major order the grid itself renders them in, instead of overflowing or\nshrinking columns unreadably.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `cell-{id}` | A `layout` entry's cell content; auto-populated by a default composed `<lr-widget>`/`<lr-widget-renderer>` pair unless a light-DOM `[cell-id=\"{id}\"]` child is authored instead. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The grid root. |\n| `cell` | A single cell's positioned wrapper. |\n| `empty` | The `lr-empty` shown when `layout` is empty. |\n| `live-region` | The current move/resize/collision announcement. |\n| `resize-handle` | The pointer resize grip in a cell's trailing/bottom corner (only rendered while `cells-resizable`); the Ctrl/Cmd+Shift+Arrow keyboard path is the resize handle's full accessible equivalent, so the handle itself is `aria-hidden`. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-dashboard-grid-columns` (default: `12`) — Column count of the underlying CSS Grid. Written inline on `[part=\"base\"]` from the `columns` property on every render, so the fallback only applies to a `[part=\"base\"]` this component has not rendered yet.\n- `--lr-dashboard-grid-row-height` (default: `var(--lr-size-5rem)`) — Row track height. Written inline on `[part=\"base\"]` from the `rowHeight` property (in px) on every render.\n- `--lr-dashboard-grid-gap` (default: `var(--lr-space-m)`) — Gap between cells on both axes. Written inline on `[part=\"base\"]` from the `gap` property (in px) on every render.\n- `--lr-dashboard-grid-cell-hover-outline-color` (default: `var(--lr-color-border-strong)`) — Outline color of a cell's mouse-hover preview of its own `:focus-visible` ring (shown because every cell is a real focusable, draggable/resizable target). Set to `transparent` to opt out.\n- `--lr-dashboard-grid-collision-outline-color` (default: `var(--lr-color-danger)`) — Outline color of a cell whose current drag/resize preview collides with another cell.",
+          "description": "`<lr-dashboard-grid>` — a responsive, keyboard-accessible widget grid: positions `layout`\nentries (`DashboardCell`: `x`/`y`/`w`/`h` grid units + a widget descriptor) on a CSS Grid,\ncomposing `<lr-widget>` + `<lr-widget-renderer>` for each cell's default content, and owns all\ndrag/resize/collision interaction as controlled events -- it never mutates `layout` itself, nor\never touches `localStorage`/network; the host applies (or ignores) every emitted event and owns\npersistence entirely, mirroring `lr-flow-canvas`/`lr-table`'s own controlled-component\nconvention. Readonly (viewer) by default; opt into editor gestures individually via\n`cells-draggable`/`cells-resizable`, or lock the whole grid via `locked`.\n\nCell content: a `layout` entry with no matching light-DOM child (matched by `cell-id`) gets a\ndefault `<lr-widget label=\"...\">` wrapping an `<lr-widget-renderer .tree=${cell.widget}>`\nauto-created and adopted into `slot=\"cell-{id}\"` -- this component's own job is the grid\nlayout/drag/resize/collision/persistence-event mechanics *around* that content, not widget\nrendering itself (see `lr-widget-renderer`'s own doc for its declarative-tree contract). A\nconsumer wanting full control over one cell's markup can instead author\n`<div cell-id=\"...\">...</div>` as a direct child; it is adopted in place of the default cell.\n\nKeyboard: cells share one roving tabindex, in row-major (`sortSpatial`) order. Arrow\nkeys/Home/End move the roving focus (RTL-aware: physical Left/Right always match what the\ncursor visually does, matching `lr-flow-canvas`'s own convention). While a cell has focus,\nCtrl/Cmd+Arrow moves it by one grid unit and Ctrl/Cmd+Shift+Arrow resizes it by one grid unit\n(Right/Down grow, Left/Up shrink) -- the full keyboard-operable equivalent of the pointer\ndrag/resize gestures below, per this library's accessibility bar (no pointer-only interaction).\n\nCollision: every move/resize request -- pointer or keyboard -- is resolved through `collision`\n(`'reject'` the default, `'push'`, or `'overlap'`; see `resolvePlacement()` in `layout.ts` for\nthe exact rule). A rejected request leaves `layout` untouched and only announces; an accepted\none emits `lr-cell-move`/`lr-cell-resize` plus a `lr-layout-change` snapshot of the full\nproposed layout (including any `'push'` cascade) -- the host's one persistence hook: listen for\nit and persist `event.detail.layout` however it likes (`localStorage`, a network call, neither).\n\nResponsive: below a ~40rem container allocation (`@container`, not the viewport -- a dashboard\ngrid is commonly embedded in a panel of varying width), cells stack into a single flowing\ncolumn in the same row-major order the grid itself renders them in, instead of overflowing or\nshrinking columns unreadably.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `cell-{id}` | A `layout` entry's cell content; auto-populated by a default composed `<lr-widget>`/`<lr-widget-renderer>` pair unless a light-DOM `[cell-id=\"{id}\"]` child is authored instead. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The grid root. |\n| `cell` | A single cell's positioned wrapper. |\n| `empty` | The `lr-empty` shown when `layout` is empty. |\n| `live-region` | The current move/resize/collision announcement. |\n| `resize-handle` | The pointer resize grip in a cell's trailing/bottom corner (only rendered while `cells-resizable`); the Ctrl/Cmd+Shift+Arrow keyboard path is the resize handle's full accessible equivalent, so the handle itself is `aria-hidden`. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-dashboard-grid-columns` (default: `12`) — Column count of the underlying CSS Grid. Written inline on `[part=\"base\"]` from the `columns` property on every render, so the fallback only applies to a `[part=\"base\"]` this component has not rendered yet.\n- `--lr-dashboard-grid-row-height` (default: `var(--lr-size-5rem)`) — Row track height. Written inline on `[part=\"base\"]` from the `rowHeight` property (in px) on every render.\n- `--lr-dashboard-grid-gap` (default: `var(--lr-space-m)`) — Gap between cells on both axes. Written inline on `[part=\"base\"]` from the `gap` property (in px) on every render.\n- `--lr-dashboard-grid-cell-hover-outline-color` (default: `var(--lr-color-border-strong)`) — Outline color of a cell's mouse-hover preview of its own `:focus-visible` ring (shown because every cell is a real focusable, draggable/resizable target). Set to `transparent` to opt out.\n- `--lr-dashboard-grid-collision-outline-color` (default: `var(--lr-color-danger)`) — Outline color of a cell whose current drag/resize preview collides with another cell.\n- `--lr-dashboard-grid-interaction-shadow` (default: `var(--lr-shadow)`) — Box shadow applied to a cell for the duration of its pointer drag or resize interaction.",
           "attributes": [
             {
               "name": "aria-label",
@@ -4925,7 +4919,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable body.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -5023,15 +5017,6 @@
                 ]
               }
             },
-            {
-              "name": "disabled",
-              "description": "Type: `boolean`",
-              "value": {
-                "type": [
-                  "boolean"
-                ]
-              }
-            },
             {
               "name": "enterkeyhint",
               "description": "Type: `string`  \nDefault: `''`",
@@ -5411,11 +5396,11 @@
         },
         {
           "name": "lr-dialog",
-          "description": "`<lr-dialog>` — a general-purpose modal/overlay. `role=\"dialog\"`,\nfocus-trapped while open, dismissible via Escape or a backdrop click, and\nscroll-locks the document for as long as it's open. Chrome stays minimal by\ndefault — no built-in title bar or close button; a consumer supplies a\nheading and any close affordance itself via the default/`footer` slots.\n`heading`/`closable` are an opt-in convenience for the common case where\nhand-building that chrome isn't worth it (see below).\n\nAccessible name / visible header, in priority order:\n0. If the host element itself has an `aria-label` attribute set, its value\n   becomes `aria-label` on the panel outright, overriding every source\n   below (including a slotted heading) — the standard ARIA convention for\n   a consumer that wants full control over the announced name regardless\n   of whatever `heading`/`label` props are also set. Also suppresses the\n   visible header/`heading` row and the sr-only `label` element from\n   rendering at all, same as case 1 already does to cases 2/3 below.\n1. Otherwise, if a heading element (`h1`–`h6` or `[role=\"heading\"]`) is a *direct\n   child* (not inside `slot=\"footer\"`), its text content becomes\n   `aria-label` on the panel — unchanged, and takes priority over `heading`\n   below so an existing consumer that already slots its own heading keeps\n   rendering it exactly as before.\n2. Otherwise, when `heading` is set, a visible header row (`part=\"header\"`)\n   renders containing that text (`part=\"heading\"`), which becomes the\n   `aria-labelledby` target.\n3. Otherwise, when `label` is set, an invisible (`.sr-only`, exposed as the\n   `label` part) element carrying that text is rendered inside the panel\n   and `aria-labelledby` points at it instead.\nOnly one of cases 2/3 ever renders at a time, so exactly one element ever\nclaims `aria-labelledby`. `label` itself never renders visible chrome on\nits own — `::part(label)` can be restyled to make the sr-only text visible,\nor `heading` can be set instead, if a consumer wants visible chrome without\nslotting a real heading element.\n\nThe slotted-heading case deliberately uses `aria-label` (a copied string)\nrather than `aria-labelledby` pointing at the heading's `id`: the heading is\n*light-DOM* content while `[part=\"panel\"]` lives in this element's\n*shadow* tree, and an ID-reference attribute can't resolve across that\nboundary (verified against axe's `aria-dialog-name` rule) — unlike the\n`heading`/`label`-prop cases above, where the target element is rendered\ninside the same shadow root it labels, so `aria-labelledby` there is safe.\n\n`closable` renders a close (X) button in the header row (creating one, with\nno heading text, if `heading` is unset) that closes the dialog via the same\n`close()` path as Escape/backdrop-dismiss, with reason `'close-button'`.\n\nStacking: opening one `<lr-dialog>` while another is already open (e.g. a\n`confirm()` launched from within an already-open dialog) is supported --\nEscape and the Tab focus trap only ever act on the topmost open dialog, so\ndialogs beneath it stay open and untouched until the one on top closes.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | The dialog body. |\n| `footer` | Action buttons, rendered in a bottom row. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `backdrop` | The full-viewport scrim behind the panel. |\n| `body` | The wrapper around the default slot. |\n| `close-button` | The built-in close button, rendered inside `header` only when `closable` is `true`. |\n| `footer` | The wrapper around the `footer` slot. |\n| `header` | The header row, rendered when `heading` is set (and no heading is slotted) and/or `closable` is `true`. |\n| `heading` | The visible `heading`-text element inside `header`, rendered only when `heading` is set and no heading is slotted. |\n| `label` | The invisible `label`-text element used for `aria-labelledby` when no heading is slotted and `heading` is unset. |\n| `panel` | The dialog panel itself (`role=\"dialog\"` while open). Shrink-wraps to its content by default, capped at `--lr-dialog-max-width` (default `32rem`); set `--lr-dialog-width` for an assertive width instead of only a cap. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-dialog-overlay-color` (default: `var(--lr-color-overlay)`) — Backdrop scrim color.\n- `--lr-dialog-width` (default: `auto`) — Assertive inline size for the panel. Left at `auto` the panel shrink-wraps to its content.\n- `--lr-dialog-max-width` (default: `var(--lr-dialog-width, var(--lr-size-32rem))`) — Cap on the panel's inline size. Falls back to `--lr-dialog-width` when that is set, so an assertive width is not clipped by the 32rem default; the viewport (`100%`) is always a hard limit on top.",
+          "description": "`<lr-dialog>` — a general-purpose modal/overlay. `role=\"dialog\"`,\nfocus-trapped while open, dismissible via Escape or a backdrop click, and\nscroll-locks the document for as long as it's open. Chrome stays minimal by\ndefault — no built-in title bar or close button; a consumer supplies a\nheading and any close affordance itself via the default/`footer` slots.\n`heading`/`closable` are an opt-in convenience for the common case where\nhand-building that chrome isn't worth it (see below).\n\nAccessible name / visible header, in priority order:\n0. If the host element itself has an `aria-label` attribute set, its value\n   becomes `aria-label` on the panel outright, overriding every source\n   below (including a slotted heading) — the standard ARIA convention for\n   a consumer that wants full control over the announced name regardless\n   of whatever `heading`/`label` props are also set. This naming override\n   does not suppress visible `heading` chrome; sighted users still receive\n   the heading text the consumer supplied.\n1. Otherwise, if a heading element (`h1`–`h6` or `[role=\"heading\"]`) is a *direct\n   child* (not inside `slot=\"footer\"`), its text content becomes\n   `aria-label` on the panel — unchanged, and takes priority over `heading`\n   below so an existing consumer that already slots its own heading keeps\n   rendering it exactly as before.\n2. Otherwise, when `heading` is set, a visible header row (`part=\"header\"`)\n   renders containing that text (`part=\"heading\"`), which becomes the\n   `aria-labelledby` target.\n3. Otherwise, when `label` is set, an invisible (`.sr-only`, exposed as the\n   `label` part) element carrying that text is rendered inside the panel\n   and `aria-labelledby` points at it instead.\nOnly one of cases 2/3 ever names the panel at a time, so exactly one element ever\nclaims `aria-labelledby`. `label` itself never renders visible chrome on\nits own — `::part(label)` can be restyled to make the sr-only text visible,\nor `heading` can be set instead, if a consumer wants visible chrome without\nslotting a real heading element.\n\nThe slotted-heading case deliberately uses `aria-label` (a copied string)\nrather than `aria-labelledby` pointing at the heading's `id`: the heading is\n*light-DOM* content while `[part=\"panel\"]` lives in this element's\n*shadow* tree, and an ID-reference attribute can't resolve across that\nboundary (verified against axe's `aria-dialog-name` rule) — unlike the\n`heading`/`label`-prop cases above, where the target element is rendered\ninside the same shadow root it labels, so `aria-labelledby` there is safe.\n\n`closable` renders a close (X) button in the header row (creating one, with\nno heading text, if `heading` is unset) that closes the dialog via the same\n`close()` path as Escape/backdrop-dismiss, with reason `'close-button'`.\n\nStacking: opening one `<lr-dialog>` while another is already open (e.g. a\n`confirm()` launched from within an already-open dialog) is supported --\nEscape and the Tab focus trap only ever act on the topmost open dialog, so\ndialogs beneath it stay open and untouched until the one on top closes.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | The dialog body. |\n| `footer` | Action buttons, rendered in a bottom row. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `backdrop` | The full-viewport scrim behind the panel. |\n| `body` | The wrapper around the default slot. |\n| `close-button` | The built-in close button, rendered inside `header` only when `closable` is `true`. |\n| `footer` | The wrapper around the `footer` slot. |\n| `header` | The header row, rendered when `heading` is set (and no heading is slotted) and/or `closable` is `true`. |\n| `heading` | The visible `heading`-text element inside `header`, rendered only when `heading` is set and no heading is slotted. |\n| `label` | The invisible `label`-text element used for `aria-labelledby` when no heading is slotted and `heading` is unset. |\n| `panel` | The dialog panel itself (`role=\"dialog\"` while open). Shrink-wraps to its content by default, capped at `--lr-dialog-max-width` (default `32rem`); set `--lr-dialog-width` for an assertive width instead of only a cap. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-dialog-overlay-color` (default: `var(--lr-color-overlay)`) — Backdrop scrim color.\n- `--lr-dialog-width` (default: `auto`) — Assertive inline size for the panel. Left at `auto` the panel shrink-wraps to its content.\n- `--lr-dialog-max-width` (default: `var(--lr-dialog-width, var(--lr-size-32rem))`) — Cap on the panel's inline size. Falls back to `--lr-dialog-width` when that is set, so an assertive width is not clipped by the 32rem default; the viewport (`100%`) is always a hard limit on top.",
           "attributes": [
             {
               "name": "aria-label",
-              "description": "Host-level `aria-label` override for the panel's accessible name — wins over every other\nsource (a slotted heading, `heading`, `label`), matching `<lr-date-input>`'s\n`accessibleLabel` pattern. See the class doc for the full precedence order. Set as a plain\n`aria-label` attribute on `<lr-dialog>` itself, not a public JS property.\n\nType: `string | null`  \nDefault: `null`"
+              "description": "Host-level `aria-label` override for the panel's accessible name — wins over every other\nnaming source (a slotted heading, `heading`, `label`) without suppressing visible heading\nchrome, matching `<lr-date-input>`'s `accessibleLabel` pattern. See the class doc for the\nfull precedence order. Set as a plain `aria-label` attribute on `<lr-dialog>` itself, not a\npublic JS property.\n\nType: `string | null`  \nDefault: `null`"
             },
             {
               "name": "closable",
@@ -5687,7 +5672,7 @@
         },
         {
           "name": "lr-document-library",
-          "description": "`<lr-document-library>` — a searchable, filterable inventory of documents with versions, tags,\nowners, freshness, and bulk selection. A controlled data view: it performs no upload, sync, or\nmutation of its own, only presents `documents` and emits request/notification events, mirroring\nthis package's other orchestration-level list surfaces (`<lr-thread-list>`'s\n`lr-thread-pin`/`-archive`/`-delete` convention).\n\nComposes `<lr-table>` for the inventory grid itself, since bulk selection, tags, and per-row\ntype icons all need arbitrary cell content rather than a stringified value.\n`<lr-table>` supports arbitrary `cell()`/`headerCell()` content and `priority`-driven responsive\ncolumn hiding, which this component relies on for its 320px-allocation behavior. Search\n(`<lr-input type=\"search\">`) and the tag facet (`<lr-combobox multiple>`) are both self-managed\n(client-side filtering against `documents`, like `<lr-thread-list>`'s own `searchable` field) —\noverride matching entirely via `filter`. Row selection uses `<lr-checkbox>` per cell rather than\n`<lr-table>`'s own built-in `selectionMode`, since that mode's click-anywhere-in-the-row toggle\nwould conflict with the row's own name button opening the document; `<lr-table>`'s\n`selectedKeys` is still fed from `selectedIds` purely for its `aria-selected` row styling.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root region. |\n| `cell` | Exported from `<lr-table>`'s own `cell` part. |\n| `clear-selection` | The \"Clear selection\" button inside `selection-bar`. |\n| `document-name` | Each row's clickable document-name button. |\n| `header-cell` | Exported from `<lr-table>`'s own `header-cell` part. |\n| `row` | Exported from `<lr-table>`'s own `row` part. |\n| `search` | The `<lr-input>` search field. |\n| `selection-bar` | The \"N selected\" / \"Clear selection\" bar. Only rendered while `selectedIds` is non-empty. |\n| `selection-count` | The selected-count text inside `selection-bar`. |\n| `table` | The `<lr-table>` inventory grid. |\n| `tag-filter` | The `<lr-combobox>` tag facet filter. Only rendered while at least one document declares a `tags` entry. |\n| `toolbar` | Wraps the search field and tag filter. |",
+          "description": "`<lr-document-library>` — a searchable, filterable inventory of documents with versions, tags,\nowners, freshness, and bulk selection. A controlled data view: it performs no upload, sync, or\nmutation of its own, only presents `documents` and emits request/notification events, mirroring\nthis package's other orchestration-level list surfaces (`<lr-thread-list>`'s\n`lr-thread-pin`/`-archive`/`-delete` convention).\n\nComposes `<lr-table>` for the inventory grid itself, since bulk selection, tags, and per-row\ntype icons all need arbitrary cell content rather than a stringified value.\n`<lr-table>` supports arbitrary `cell()`/`headerCell()` content and `priority`-driven responsive\ncolumn hiding, which this component relies on for its 320px-allocation behavior. Search\n(`<lr-input type=\"search\">`) and the tag facet (`<lr-combobox multiple>`) are both self-managed\n(client-side filtering against `documents`, like `<lr-thread-list>`'s own `searchable` field) —\noverride matching entirely via `filter`. Row selection uses `<lr-checkbox>` per cell rather than\n`<lr-table>`'s own built-in `selectionMode`, since that mode's click-anywhere-in-the-row toggle\nwould conflict with the row's own name button opening the document; `<lr-table>`'s\n`selectedKeys` is still fed from `selectedIds` purely for its `aria-selected` row styling.\n`<lr-table>` is set to `sort-mode=\"server\"` because this component owns ordering:\n`visibleDocuments` already sorts against real values (timestamps for `updatedAt`, a rank for\n`freshness`). Client mode would order the rows a second time from `String(cell(row))`, and these\n`cell()`s render formatted dates and templates — which made the Updated column come out\nalphabetical by month name rather than chronological. `sortKey`/`sortDir` are still passed\ndown: they drive the header's sort affordance, not the order.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root region. |\n| `cell` | Exported from `<lr-table>`'s own `cell` part. |\n| `clear-selection` | The \"Clear selection\" button inside `selection-bar`. |\n| `document-name` | Each row's clickable document-name button. |\n| `header-cell` | Exported from `<lr-table>`'s own `header-cell` part. |\n| `row` | Exported from `<lr-table>`'s own `row` part. |\n| `search` | The `<lr-input>` search field. |\n| `selection-bar` | The \"N selected\" / \"Clear selection\" bar. Only rendered while `selectedIds` is non-empty. |\n| `selection-count` | The selected-count text inside `selection-bar`. |\n| `table` | The `<lr-table>` inventory grid. |\n| `tag-filter` | The `<lr-combobox>` tag facet filter. Only rendered while at least one document declares a `tags` entry. |\n| `toolbar` | Wraps the search field and tag filter. |",
           "attributes": [
             {
               "name": "label",
@@ -5777,7 +5762,7 @@
             },
             {
               "name": "max-height",
-              "description": "A CSS length (e.g. `\"24rem\"`); once set, `[part=\"body\"]` scrolls\ninternally past this height instead of growing the page — same\ncontract as `<lr-json-viewer>`'s identically-named prop.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS length (e.g. `\"24rem\"`); once set, `[part=\"body\"]` scrolls\ninternally past this height instead of growing the page — same\ncontract as `<lr-json-viewer>`'s identically-named prop. Invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -5832,12 +5817,7 @@
           "attributes": [
             {
               "name": "alt",
-              "description": "Media alt text forwarded to the resolved renderer, for image-like renderers.\n\nType: `string`  \nDefault: `''`",
-              "value": {
-                "type": [
-                  "string"
-                ]
-              }
+              "description": "Media alt text forwarded to the resolved renderer, for image-like renderers. Unset lets the\nrenderer derive a fallback name; an explicit empty string marks decorative media.\n\nType: `string | undefined`"
             },
             {
               "name": "locale",
@@ -5888,7 +5868,7 @@
         },
         {
           "name": "lr-docx-viewer",
-          "description": "Renders a DOCX document as sanitized semantic HTML using the optional\n`mammoth` converter and `dompurify` sanitizer peers. DOCX content is always\nsanitized; there is no unsanitized rendering mode for uploaded documents.\n\nEvery rendered heading's slug (computed via the shared GitHub-slugger-style `Slugger` -- the same\nalgorithm and shared class `<lr-markdown>` uses, so identical heading text slugs identically\nacross both viewers) is stamped as its `id` and cached into `getHeadingTree()`'s document-ordered\noutline -- unconditional, unlike `<lr-markdown>`'s opt-in `heading-anchors`, since this\ncomponent's rendered HTML is always internal (mammoth's own conversion output), never a raw string\na consumer might serialize verbatim. Adopts `DocumentAnchorTarget`: `fragment` anchors resolve\nagainst that outline, `text-quote` anchors via `internal/text-quote.ts`'s shared scope/resolve\nhelpers; `highlights` re-resolve by quote after every render (never by node identity), so a\nhighlight painted before its quote is in the rendered markup yet simply paints once a later load\ncontains it. Highlight painting uses `internal/text-highlights.ts`'s `acquireHighlightHandle()` --\nthe CSS Custom Highlight API where the browser supports it (no DOM mutation at all), a `<mark>`-wrap\nfallback otherwise. `search()`/`searchNext()`/`searchPrevious()`/`clearSearch()` do a\ncase-insensitive substring search over the rendered content's text and paint every match as a\n`<mark part=\"search-match\">` (the active one also carrying `search-match-active`) -- a separate,\nalways-real-DOM-element mechanism from the tone-based highlight painting above, since search needs\nmany simultaneously-visible matches rather than one set of themed spans.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. |\n| `body` | The scrollable document body. |\n| `content` | The semantic document content. |\n| `error` | The error message region. |\n| `highlight` | A painted `text-quote` highlight (`<mark>`, `<mark>`-wrap fallback path only). |\n| `search-match` | A painted in-document search match. |\n| `search-match-active` | The currently active search match (also carries `search-match`). |\n| `spinner` | The loading status region. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-docx-viewer-max-height` (default: `none`) — Maximum block size of the scrollable document body before it scrolls internally. Also settable via the `max-height` property.\n- `--lr-docx-viewer-highlight-accent-background` — Accent highlight background.\n- `--lr-docx-viewer-highlight-success-background` — Success highlight background.\n- `--lr-docx-viewer-highlight-warning-background` — Warning highlight background.\n- `--lr-docx-viewer-highlight-danger-background` — Danger highlight background.\n- `--lr-docx-viewer-highlight-neutral-background` — Neutral highlight background.\n- `--lr-docx-viewer-highlight-active-background` — Active highlight background.\n- `--lr-docx-viewer-highlight-active-outline` — Active fallback-highlight outline.\n- `--lr-docx-viewer-search-match-background` — Search-match background.\n- `--lr-docx-viewer-search-match-active-background` — Active search-match background.\n- `--lr-docx-viewer-search-match-active-foreground` — Active search-match foreground.",
+          "description": "Renders a DOCX document as sanitized semantic HTML using the optional\n`mammoth` converter and `dompurify` sanitizer peers. DOCX content is always\nsanitized; there is no unsanitized rendering mode for uploaded documents.\n\nEvery rendered heading's slug (computed via the shared GitHub-slugger-style `Slugger` -- the same\nalgorithm and shared class `<lr-markdown>` uses, so identical heading text slugs identically\nacross both viewers) is stamped as its `id` and cached into `getHeadingTree()`'s document-ordered\noutline -- unconditional, unlike `<lr-markdown>`'s opt-in `heading-anchors`, since this\ncomponent's rendered HTML is always internal (mammoth's own conversion output), never a raw string\na consumer might serialize verbatim. Adopts `DocumentAnchorTarget`: `fragment` anchors resolve\nagainst that outline, `text-quote` anchors via `internal/text-quote.ts`'s shared scope/resolve\nhelpers; `highlights` re-resolve by quote after every render (never by node identity), so a\nhighlight painted before its quote is in the rendered markup yet simply paints once a later load\ncontains it. Keyboard-accessible highlight actions are rendered only for quotes that resolved\nagainst the currently loaded document, so an action never presents an enabled no-op. Highlight\npainting uses `internal/text-highlights.ts`'s `acquireHighlightHandle()` --\nthe CSS Custom Highlight API where the browser supports it (no DOM mutation at all), a `<mark>`-wrap\nfallback otherwise. `search()`/`searchNext()`/`searchPrevious()`/`clearSearch()` do a\ncase-insensitive substring search over the rendered content's text and paint every match as a\n`<mark part=\"search-match\">` (the active one also carrying `search-match-active`) -- a separate,\nalways-real-DOM-element mechanism from the tone-based highlight painting above, since search needs\nmany simultaneously-visible matches rather than one set of themed spans.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. |\n| `body` | The scrollable document body. |\n| `content` | The semantic document content. |\n| `error` | The error message region. |\n| `highlight` | A painted `text-quote` highlight (`<mark>`, `<mark>`-wrap fallback path only). |\n| `highlight-action` | One native highlight activation button. |\n| `highlight-actions` | Keyboard-accessible actions for the resolved text highlights. |\n| `search-match` | A painted in-document search match. |\n| `search-match-active` | The currently active search match (also carries `search-match`). |\n| `spinner` | The loading status region. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-docx-viewer-max-height` (default: `none`) — Maximum block size of the scrollable document body before it scrolls internally. Also settable via the `max-height` property.\n- `--lr-docx-viewer-highlight-accent-background` — Accent highlight background.\n- `--lr-docx-viewer-highlight-success-background` — Success highlight background.\n- `--lr-docx-viewer-highlight-warning-background` — Warning highlight background.\n- `--lr-docx-viewer-highlight-danger-background` — Danger highlight background.\n- `--lr-docx-viewer-highlight-neutral-background` — Neutral highlight background.\n- `--lr-docx-viewer-highlight-active-background` — Active highlight background.\n- `--lr-docx-viewer-highlight-active-outline` — Active fallback-highlight outline.\n- `--lr-docx-viewer-search-match-background` — Search-match background.\n- `--lr-docx-viewer-search-match-active-background` — Active search-match background.\n- `--lr-docx-viewer-search-match-active-foreground` — Active search-match foreground.",
           "attributes": [
             {
               "name": "locale",
@@ -5901,7 +5881,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable document body.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height` that caps the scrollable document body; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -5930,7 +5910,7 @@
         },
         {
           "name": "lr-doughnut-chart",
-          "description": "`<lr-doughnut-chart>` — `<lr-chart>` with `type` locked to `\"doughnut\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-doughnut-chart>` — `<lr-chart>` with `type` locked to `\"doughnut\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -6102,7 +6082,7 @@
           "attributes": [
             {
               "name": "aria-label",
-              "description": "Host-level `aria-label` override for the panel's accessible name — wins over every other\nsource (a slotted heading, `heading`, `label`), matching `<lr-date-input>`'s\n`accessibleLabel` pattern. See the class doc for the full precedence order. Set as a plain\n`aria-label` attribute on `<lr-dialog>` itself, not a public JS property.\n\nType: `string | null`  \nDefault: `null`"
+              "description": "Host-level `aria-label` override for the panel's accessible name — wins over every other\nnaming source (a slotted heading, `heading`, `label`) without suppressing visible heading\nchrome, matching `<lr-date-input>`'s `accessibleLabel` pattern. See the class doc for the\nfull precedence order. Set as a plain `aria-label` attribute on `<lr-dialog>` itself, not a\npublic JS property.\n\nType: `string | null`  \nDefault: `null`"
             },
             {
               "name": "closable",
@@ -6369,7 +6349,7 @@
         },
         {
           "name": "lr-email-viewer",
-          "description": "Parses `.eml` messages with the optional `postal-mime` peer and renders\ntheir HTML body only after DOMPurify sanitization. Plain-text messages remain\nuseful without DOMPurify. Attachment rows are real buttons that emit\n`lr-attachment-open` with the attachment's decoded bytes -- this component itself never\nopens, downloads, or object-URLs the content; a host routes the event into e.g.\n`URL.createObjectURL(new Blob([content], { type: mimeType }))` -> `lr-document-viewer` ->\nrevoke on `lr-close`. `fold-quotes` collapses trailing quoted-reply text/HTML behind a\nlocalized toggle.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `attachment-button` | An attachment's open button. |\n| `attachment-item` | An attachment metadata item. |\n| `attachment-list` | The attachment list. |\n| `attachment-name` | An attachment's filename, inside `attachment-button`. |\n| `attachment-size` | An attachment's formatted file size, inside `attachment-button`. |\n| `attachments` | The attachment region. |\n| `attachments-label` | The localized attachment heading. |\n| `base` | The root container. |\n| `body` | The scrollable message body. |\n| `body-html` | The sanitized HTML body. |\n| `body-text` | The plain-text body. |\n| `date` | The message date. |\n| `date-label` | The localized date label. |\n| `error` | The error region. |\n| `from` | The sender address. |\n| `from-label` | The localized sender label. |\n| `headers` | Message metadata. |\n| `quote-toggle` | The show/hide-quoted-text toggle button. |\n| `quoted` | A folded quoted-text block (hidden until expanded). |\n| `spinner` | The loading region. |\n| `subject` | The message subject. |\n| `subject-label` | The localized subject label. |\n| `to` | The recipient addresses. |\n| `to-label` | The localized recipient label. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-email-viewer-max-height` (default: `none`) — Maximum block size of `[part=\"body\"]` before it scrolls internally. The `maxHeight` property sets this token inline on `[part=\"base\"]`.",
+          "description": "Parses `.eml` messages with the optional `postal-mime` peer and renders\ntheir HTML body only after DOMPurify sanitization and inside a paint-contained surface.\nPlain-text messages remain useful without DOMPurify. Attachment rows are real buttons that emit\n`lr-attachment-open` with the attachment's decoded bytes -- this component itself never\nopens, downloads, or object-URLs the content; a host routes the event into e.g.\n`URL.createObjectURL(new Blob([content], { type: mimeType }))` -> `lr-document-viewer` ->\nrevoke on `lr-close`. `fold-quotes` collapses trailing quoted-reply text/HTML behind a\nlocalized toggle.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `attachment-button` | An attachment's open button. |\n| `attachment-item` | An attachment metadata item. |\n| `attachment-list` | The attachment list. |\n| `attachment-name` | An attachment's filename, inside `attachment-button`. |\n| `attachment-size` | An attachment's formatted file size, inside `attachment-button`. |\n| `attachments` | The attachment region. |\n| `attachments-label` | The localized attachment heading. |\n| `base` | The root container. |\n| `body` | The scrollable message body. |\n| `body-html` | The sanitized HTML body. |\n| `body-text` | The plain-text body. |\n| `date` | The message date. |\n| `date-label` | The localized date label. |\n| `error` | The error region. |\n| `from` | The sender address. |\n| `from-label` | The localized sender label. |\n| `headers` | Message metadata. |\n| `quote-toggle` | The show/hide-quoted-text toggle button. |\n| `quoted` | A folded quoted-text block (hidden until expanded). |\n| `spinner` | The loading region. |\n| `subject` | The message subject. |\n| `subject-label` | The localized subject label. |\n| `to` | The recipient addresses. |\n| `to-label` | The localized recipient label. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-email-viewer-max-height` (default: `none`) — Maximum block size of `[part=\"body\"]` before it scrolls internally. The `maxHeight` property sets this token inline on `[part=\"base\"]`.",
           "attributes": [
             {
               "name": "fold-quotes",
@@ -6391,7 +6371,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable body.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -6420,7 +6400,7 @@
         },
         {
           "name": "lr-embedding-explorer",
-          "description": "`<lr-embedding-explorer>` — a dependency-free, accessible 2D embedding projection viewer. It\nnormalizes host-provided coordinates into an SVG plot, colors optional clusters, and exposes\nclick/keyboard selection. It does not run PCA/UMAP/t-SNE, fetch chunks, or mutate points.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. |\n| `empty` | The empty state. |\n| `plot` | The SVG projection plot. |\n| `point` | One focusable embedding point. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-embedding-explorer-selected-stroke` (default: `var(--lr-color-brand)`) — Stroke color of the selected point.",
+          "description": "`<lr-embedding-explorer>` — a dependency-free, accessible 2D embedding projection viewer. It\nnormalizes host-provided coordinates into an SVG plot, colors optional clusters, and exposes\nclick/keyboard selection. Pointer, script, and assistive-technology focus all synchronize the\nsingle roving tab stop. It does not run PCA/UMAP/t-SNE, fetch chunks, or mutate points.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. |\n| `empty` | The empty state. |\n| `plot` | The SVG projection plot. |\n| `point` | One focusable embedding point. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-embedding-explorer-selected-stroke` (default: `var(--lr-color-brand)`) — Stroke color of the selected point.\n- `--lr-embedding-explorer-height` (default: `360px`) — The plot's `block-size`. Set on the host from the `height` property, whose default supplies the `360px`; a value the browser cannot parse as a `block-size` is dropped, leaving the `viewBox`-derived aspect-ratio size. A consumer's own `::part(plot) { block-size: ... }` rule still overrides it, and the narrow-allocation `min-block-size` floor still raises it.",
           "attributes": [
             {
               "name": "aria-label",
@@ -6428,7 +6408,7 @@
             },
             {
               "name": "height",
-              "description": "SVG block size.\n\nType: `string`  \nDefault: `'360px'`",
+              "description": "The plot's block size, as any CSS length the browser accepts for `block-size` — including\n`auto`, which restores the aspect-ratio-preserved size derived from the `viewBox`. It is\napplied through `--lr-embedding-explorer-height`; an unparseable value leaves that property\nunset, so the plot falls back to `auto` rather than collapsing.\n\nType: `string`  \nDefault: `'360px'`",
               "value": {
                 "type": [
                   "string"
@@ -6683,7 +6663,7 @@
         },
         {
           "name": "lr-entity-dossier",
-          "description": "`<lr-entity-dossier>` — a full entity detail surface: a persistent header (`lr-entity-card` plus\nan optional confidence `lr-stat`) above a `lr-tabs` strip for Relationships (`lr-neighbor-list`),\nSupporting chunks (`lr-chunk-inspector`), and Provenance (`lr-provenance-panel`). Pure layout —\nit never fetches, ranks, or mutates graph/document state, and never re-renders what any of those\nfive composed components already render themselves; every one of their own events (`\nlr-entity-activate`, `lr-node-expand`, `lr-chunk-open`, `lr-expand`, `lr-toggle`, `lr-tabs-change`)\nbubbles through unmodified (`composed: true` crosses this component's own shadow boundary with no\nre-dispatch needed) rather than being re-declared as this component's own event.\n\n`chunks`/`thresholds` (the \"supporting chunks\" tab) and `provenance` (the \"Provenance\" tab) are\ndeliberately separate inputs even though `lr-provenance-panel` can itself also show a chunks\nsection: the \"Supporting chunks\" tab is the evidence for *this entity's own* summary/properties,\nwhile `provenance` is the broader grounding chain (which may span other entities, relationships,\nand communities, and may or may not reuse the same chunk set) — a host is free to pass the same\narray to both when the two concepts genuinely coincide.\n\nTab labels reuse the exact `localize()` keys the composed child already uses for its own\naccessible name (`neighborListLabel`, `chunkInspectorLabel`, `provenancePanelLabel`) rather than\nnew dossier-specific keys, so a translated locale only has to cover each string once and the tab\nstrip and the panel underneath it always agree.\n\nThis component declares no events of its own -- `lr-tabs-change` (`detail: { tabId:\nLyraEntityDossierTab }`) and every composed child's own event bubble through unmodified, the\nsame \"pure projection + event conduit\" convention `lr-provenance-panel` and\n`lr-spreadsheet-viewer`'s internal `lr-tabs` already establish.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper, or the empty state's wrapper when `entity` is `null`. |\n| `chunk-inspector` | The nested `lr-chunk-inspector`, inside the Supporting chunks tab. |\n| `confidence` | The nested confidence `lr-stat`, only rendered when `confidence` is set. |\n| `empty` | The empty state shown when `entity` is `null`. |\n| `entity-card` | The nested `lr-entity-card`. |\n| `header` | The wrapper around the entity summary and the confidence stat. |\n| `neighbor-list` | The nested `lr-neighbor-list`, inside the Relationships tab. |\n| `provenance-panel` | The nested `lr-provenance-panel`, inside the Provenance tab. |\n| `tabs` | The nested `lr-tabs` strip. |",
+          "description": "`<lr-entity-dossier>` — a full entity detail surface: a persistent header (`lr-entity-card` plus\nan optional confidence `lr-stat`) above a `lr-tabs` strip for Relationships (`lr-neighbor-list`),\nSupporting chunks (`lr-chunk-inspector`), and Provenance (`lr-provenance-panel`). Pure layout —\nit never fetches, ranks, or mutates graph/document state, and never re-renders what any of those\nfive composed components already render themselves; every one of their own events (`\nlr-entity-activate`, `lr-node-expand`, `lr-chunk-open`, `lr-expand`, `lr-toggle`, `lr-tabs-change`)\nbubbles through unmodified (`composed: true` crosses this component's own shadow boundary with no\nre-dispatch needed).\n\n`chunks`/`thresholds` (the \"supporting chunks\" tab) and `provenance` (the \"Provenance\" tab) are\ndeliberately separate inputs even though `lr-provenance-panel` can itself also show a chunks\nsection: the \"Supporting chunks\" tab is the evidence for *this entity's own* summary/properties,\nwhile `provenance` is the broader grounding chain (which may span other entities, relationships,\nand communities, and may or may not reuse the same chunk set) — a host is free to pass the same\narray to both when the two concepts genuinely coincide.\n\nTab labels reuse the exact `localize()` keys the composed child already uses for its own\naccessible name (`neighborListLabel`, `chunkInspectorLabel`, `provenancePanelLabel`) rather than\nnew dossier-specific keys, so a translated locale only has to cover each string once and the tab\nstrip and the panel underneath it always agree.\n\nThis component emits no events of its own. Its EventMap and `@event` documentation name the\ncomposed events that bubble through so host listeners remain typed and discoverable;\n`lr-tabs-change` carries `detail: { tabId: LyraEntityDossierTab }`. This is the same \"pure\nprojection + event conduit\" convention `lr-provenance-panel` and `lr-spreadsheet-viewer`'s\ninternal `lr-tabs` already establish.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper, or the empty state's wrapper when `entity` is `null`. |\n| `chunk-inspector` | The nested `lr-chunk-inspector`, inside the Supporting chunks tab. |\n| `confidence` | The nested confidence `lr-stat`, only rendered when `confidence` is set. |\n| `empty` | The empty state shown when `entity` is `null`. |\n| `entity-card` | The nested `lr-entity-card`. |\n| `header` | The wrapper around the entity summary and the confidence stat. |\n| `neighbor-list` | The nested `lr-neighbor-list`, inside the Relationships tab. |\n| `provenance-panel` | The nested `lr-provenance-panel`, inside the Provenance tab. |\n| `tabs` | The nested `lr-tabs` strip. |",
           "attributes": [
             {
               "name": "aria-label",
@@ -7048,7 +7028,7 @@
         },
         {
           "name": "lr-file-input",
-          "description": "`<lr-file-input>` — a drag-drop + click-to-browse file dropzone. Emits\nraw `File[]`; parsing (CSV/XLSX/etc.) is left to the host, since that's\nwhere files ultimately get uploaded and processed anyway.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Custom drop-zone content, overrides the visible `label` text. The accessible name comes from a host `aria-label` when present, then falls back to `label`, so icon-only slot content remains announced correctly. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The dropzone's root, clickable/focusable container. |\n| `input` | The visually-hidden native `<input type=\"file\">`. |\n| `rejection` | The visible `role=\"alert\"` region listing each currently-rejected file alongside its reason, rendered in addition to (never in place of) the sr-only `status` summary. |\n| `status` | The visually-hidden live region announcing drag accept/reject state and accepted/rejected selection counts. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-file-input-compact-padding` (default: `var(--lr-space-s)`) — `[part=\"base\"]` padding while `compact`.\n- `--lr-file-input-compact-gap` (default: `var(--lr-space-2xs)`) — Gap between the dropzone's slotted children while `compact`.\n- `--lr-file-input-compact-font-size` (default: `var(--lr-font-size-sm)`) — Label font size while `compact`.\n- `--lr-file-input-accept-border-color` (default: `var(--lr-color-success)`) — Border color of `[part=\"base\"][data-drag-state=\"accept\"]`.\n- `--lr-file-input-accept-bg` (default: `color-mix(in srgb, var(--lr-color-success) 8%, transparent)`) — Background of `[part=\"base\"][data-drag-state=\"accept\"]`.\n- `--lr-file-input-reject-border-color` (default: `var(--lr-color-danger)`) — Border color of `[part=\"base\"][data-drag-state=\"reject\"]`.\n- `--lr-file-input-reject-bg` (default: `color-mix(in srgb, var(--lr-color-danger) 8%, transparent)`) — Background of `[part=\"base\"][data-drag-state=\"reject\"]`.",
+          "description": "`<lr-file-input>` — a drag-drop + click-to-browse file dropzone. Emits\nraw `File[]`; parsing (CSV/XLSX/etc.) is left to the host, since that's\nwhere files ultimately get uploaded and processed anyway.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Custom drop-zone content, overrides the visible `label` text. The accessible name comes from a host `aria-label` when present, then falls back to `label`, so icon-only slot content remains announced correctly. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The native dropzone button, visually backing the slotted content while remaining its sibling in the accessibility tree so arbitrary slotted controls are never nested in it. |\n| `input` | The visually-hidden native `<input type=\"file\">`. |\n| `rejection` | The visible `role=\"alert\"` region listing each currently-rejected file alongside its reason, rendered in addition to (never in place of) the sr-only `status` summary. |\n| `status` | The visually-hidden live region announcing drag accept/reject state and accepted/rejected selection counts. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-file-input-compact-padding` (default: `var(--lr-space-s)`) — `[part=\"base\"]` padding while `compact`.\n- `--lr-file-input-compact-gap` (default: `var(--lr-space-2xs)`) — Gap between the dropzone's slotted children while `compact`.\n- `--lr-file-input-compact-font-size` (default: `var(--lr-font-size-sm)`) — Label font size while `compact`.\n- `--lr-file-input-accept-border-color` (default: `var(--lr-color-success)`) — Border color of `[part=\"base\"][data-drag-state=\"accept\"]`.\n- `--lr-file-input-accept-bg` (default: `color-mix(in srgb, var(--lr-color-success) 8%, transparent)`) — Background of `[part=\"base\"][data-drag-state=\"accept\"]`.\n- `--lr-file-input-reject-border-color` (default: `var(--lr-color-danger)`) — Border color of `[part=\"base\"][data-drag-state=\"reject\"]`.\n- `--lr-file-input-reject-bg` (default: `color-mix(in srgb, var(--lr-color-danger) 8%, transparent)`) — Background of `[part=\"base\"][data-drag-state=\"reject\"]`.",
           "attributes": [
             {
               "name": "accept",
@@ -7203,7 +7183,7 @@
             },
             {
               "name": "label",
-              "description": "Accessible name for the root `role=\"group\"` wrapper. A plain `aria-label` attribute on the\nhost itself is honored as a fallback when this is left unset, matching `<lr-control-group>`.\n\nType: `string`  \nDefault: `\"\"`",
+              "description": "Accessible-name fallback for the root `role=\"group\"` wrapper when the host has no\n`aria-label`, matching `<lr-control-group>`.\n\nType: `string`  \nDefault: `\"\"`",
               "value": {
                 "type": [
                   "string"
@@ -7439,7 +7419,7 @@
         },
         {
           "name": "lr-flow-minimap",
-          "description": "`<lr-flow-minimap>` — a corner overview map of a `lr-flow-canvas`: scaled node rectangles plus\na draggable viewport rectangle, for orientation and fast navigation on canvases larger than the\nscreen. Draws no edges (nodes only, matching the React Flow/n8n minimap convention) and never\nreads `nodes` itself — geometry always comes from the canvas's `registerCompanion()` snapshots, so\nthe two can never disagree.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. |\n| `instructions` | Visually hidden keyboard instructions for the viewport. |\n| `live-region` | Visually hidden viewport-change announcements. |\n| `map` | The scaled SVG. |\n| `node` | One rect per node. |\n| `viewport` | The draggable, focusable view rectangle. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-flow-minimap-inline-size` (default: `var(--lr-size-12rem)`) — Map inline size.\n- `--lr-flow-minimap-block-size` (default: `var(--lr-size-8rem)`) — Map block size.",
+          "description": "`<lr-flow-minimap>` — a corner overview map of a `lr-flow-canvas`: scaled node rectangles plus\na draggable viewport rectangle, for orientation and fast navigation on canvases larger than the\nscreen. Draws no edges (nodes only, matching the React Flow/n8n minimap convention) and never\nreads `nodes` itself — geometry always comes from the canvas's `registerCompanion()` snapshots, so\nthe two can never disagree.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. |\n| `instructions` | Visually hidden keyboard instructions for the viewport. |\n| `live-region` | Visually hidden viewport-change announcements. |\n| `map` | The scaled SVG. |\n| `node` | One rect per node. |\n| `viewport` | The draggable, focusable view rectangle. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-flow-minimap-inline-size` (default: `var(--lr-size-12rem)`) — Map inline size.\n- `--lr-flow-minimap-block-size` (default: `var(--lr-size-8rem)`) — Map block size.\n- `--lr-flow-minimap-node-color` (default: `var(--lr-color-border-strong)`) — Fill of nodes without an execution status.\n- `--lr-flow-minimap-node-pending-color` (default: `var(--lr-color-border-strong)`) — Pending-node fill.\n- `--lr-flow-minimap-node-running-color` (default: `var(--lr-color-brand)`) — Running-node fill.\n- `--lr-flow-minimap-node-success-color` (default: `var(--lr-color-success)`) — Successful-node fill.\n- `--lr-flow-minimap-node-error-color` (default: `var(--lr-color-danger)`) — Failed-node fill.\n- `--lr-flow-minimap-node-denied-color` (default: `var(--lr-color-warning)`) — Denied-node fill.",
           "attributes": [
             {
               "name": "for",
@@ -7472,7 +7452,7 @@
         },
         {
           "name": "lr-flow-node",
-          "description": "`<lr-flow-node>` — the card a workflow node renders as: header/body/toolbar chrome,\ntool-lifecycle status tones, and the named connection-handle elements edges anchor to. Used as\n`lr-flow-canvas`'s default card and as a slotted override; also renders standalone (palette\npreviews, docs). Purely presentational — activation, selection, movement, and connection are all\n`lr-flow-canvas` events; this component owns none of that.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Body content. |\n| `header` | Replaces the built-in heading row entirely. |\n| `icon` | Leading header glyph. |\n| `toolbar` | Action row at the block-end edge. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The row wrapping the input handles, the card, and the output handles. Carries no card chrome of its own — style the card itself through the `card` part. |\n| `body` | The default-slot body wrapper. |\n| `card` | The bordered, filled node card. |\n| `handle` | Every handle dot (input or output). |\n| `handle-input` | An input handle dot (also carries the shared `handle` part). |\n| `handle-output` | An output handle dot (also carries the shared `handle` part). |\n| `header` | The built-in header row (omitted when the `header` slot has content). |\n| `heading` | The heading text. |\n| `icon` | The wrapper around the `icon` slot. |\n| `progress` | The determinate progress bar. |\n| `status` | The visible status chip (status is never color-only). |\n| `toolbar` | The toolbar row wrapper. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-flow-node-min-inline-size` (default: `calc(var(--lr-size-10rem) + var(--lr-size-1rem))`) — Minimum card inline size.\n- `--lr-flow-node-compact-padding` (default: `var(--lr-space-xs)`) — `[part=\"card\"]` padding while `compact`.\n- `--lr-flow-node-compact-gap` (default: `var(--lr-space-2xs)`) — Gap between `[part=\"card\"]`'s rows while `compact`.\n- `--lr-flow-node-selected-border` (default: `var(--lr-color-brand)`) — Border color of the card while `selected`. Overriding the selection color otherwise requires hijacking the library-wide `--lr-color-brand` token.\n- `--lr-flow-node-running-border` (default: `var(--lr-color-brand)`) — Border color of the card while `status=\"running\"`. Independent from `--lr-flow-node-selected-border` so a consumer can retint just one of the two states without the other following along.\n- `--lr-flow-node-running-glow` (default: `var(--lr-color-brand-quiet)`) — Box-shadow color of the running-state ring around the card, and the pulse keyframes' peak color.",
+          "description": "`<lr-flow-node>` — the card a workflow node renders as: header/body/toolbar chrome,\ntool-lifecycle status tones, and the named connection-handle elements edges anchor to. Used as\n`lr-flow-canvas`'s default card and as a slotted override; also renders standalone (palette\npreviews, docs). Purely presentational — activation, selection, movement, and connection are all\n`lr-flow-canvas` events; this component owns none of that.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Body content. |\n| `header` | Replaces the built-in heading row entirely. |\n| `icon` | Leading header glyph. |\n| `toolbar` | Action row at the block-end edge. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The row wrapping the input handles, the card, and the output handles. Carries no card chrome of its own — style the card itself through the `card` part. |\n| `body` | The default-slot body wrapper. |\n| `card` | The bordered, filled node card. |\n| `handle` | Every handle dot (input or output). |\n| `handle-input` | An input handle dot (also carries the shared `handle` part). |\n| `handle-output` | An output handle dot (also carries the shared `handle` part). |\n| `header` | The built-in header row (omitted when the `header` slot has content). |\n| `heading` | The heading text. |\n| `icon` | The wrapper around the `icon` slot. |\n| `progress` | The determinate progress bar. |\n| `status` | The visible status chip (status is never color-only). |\n| `toolbar` | The toolbar row wrapper. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-flow-node-min-inline-size` (default: `calc(var(--lr-size-10rem) + var(--lr-size-1rem))`) — Minimum card inline size.\n- `--lr-flow-node-compact-padding` (default: `var(--lr-space-xs)`) — `[part=\"card\"]` padding while `compact`.\n- `--lr-flow-node-compact-gap` (default: `var(--lr-space-2xs)`) — Gap between `[part=\"card\"]`'s rows while `compact`.\n- `--lr-flow-node-selected-border` (default: `var(--lr-color-brand)`) — Border color of the card while `selected`. Overriding the selection color otherwise requires hijacking the library-wide `--lr-color-brand` token.\n- `--lr-flow-node-running-border` (default: `var(--lr-color-brand)`) — Border color of the card while `status=\"running\"`. Independent from `--lr-flow-node-selected-border` so a consumer can retint just one of the two states without the other following along.\n- `--lr-flow-node-running-glow` (default: `var(--lr-color-brand-quiet)`) — Box-shadow color of the running-state ring around the card, and the pulse keyframes' peak color.\n- `--lr-flow-node-status-color` (default: `var(--lr-color-border-strong)`) — Status-dot color when no execution status is set.\n- `--lr-flow-node-status-pending-color` (default: `var(--lr-color-border-strong)`) — Pending status-dot color.\n- `--lr-flow-node-status-running-color` (default: `var(--lr-color-brand)`) — Running status-dot color.\n- `--lr-flow-node-status-success-color` (default: `var(--lr-color-success)`) — Success status-dot color.\n- `--lr-flow-node-status-error-color` (default: `var(--lr-color-danger)`) — Error status-dot color.\n- `--lr-flow-node-status-denied-color` (default: `var(--lr-color-warning)`) — Denied status-dot color.",
           "attributes": [
             {
               "name": "compact",
@@ -7548,7 +7528,7 @@
         },
         {
           "name": "lr-flow-run-overlay",
-          "description": "`<lr-flow-run-overlay>` — execution-state presentation for a `lr-flow-canvas`: pushes a\n`FlowRunDecorations` map into the resolved canvas (the canvas itself renders the node/edge paint)\nand renders a compact run-summary strip. Does not execute, poll, or time anything — pure pushed\nstate; `durationMs` is host-computed.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Extra host chrome appended to the strip (e.g. a cancel button or a usage badge). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. Drops its floating-surface chrome under `appearance=\"plain\"`. |\n| `count` | One per status present (text + tone dot, never color-only). |\n| `live-region` | The step-transition announcement. |\n| `summary` | The \"{done} of {total} steps complete\" line. |",
+          "description": "`<lr-flow-run-overlay>` — execution-state presentation for a `lr-flow-canvas`: pushes a\n`FlowRunDecorations` map into the resolved canvas (the canvas itself renders the node/edge paint)\nand renders a compact run-summary strip. Does not execute, poll, or time anything — pure pushed\nstate; `durationMs` is host-computed.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Extra host chrome appended to the strip (e.g. a cancel button or a usage badge). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. Drops its floating-surface chrome under `appearance=\"plain\"`. |\n| `count` | One per status present (text + tone dot, never color-only). |\n| `live-region` | The step-transition announcement. |\n| `summary` | The \"{done} of {total} steps complete\" line. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-flow-run-overlay-status-color` (default: `var(--lr-color-border-strong)`) — Count-dot color when no execution status is set.\n- `--lr-flow-run-overlay-status-pending-color` (default: `var(--lr-color-border-strong)`) — Pending count-dot color.\n- `--lr-flow-run-overlay-status-running-color` (default: `var(--lr-color-brand)`) — Running count-dot color.\n- `--lr-flow-run-overlay-status-success-color` (default: `var(--lr-color-success)`) — Success count-dot color.\n- `--lr-flow-run-overlay-status-error-color` (default: `var(--lr-color-danger)`) — Error count-dot color.\n- `--lr-flow-run-overlay-status-denied-color` (default: `var(--lr-color-warning)`) — Denied count-dot color.",
           "attributes": [
             {
               "name": "appearance",
@@ -7824,7 +7804,7 @@
         },
         {
           "name": "lr-geojson-view",
-          "description": "`<lr-geojson-view>` — internal document-registry bridge rendering a fetched GeoJSON file through\n`<lr-map>`'s `dataLayers`. Not a documented public tag: excluded from README/llms family tables,\npresent in the generated manifest since a defined custom element is technically reachable.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. |\n| `error` | The error region. |\n| `missing-library` | The missing-maplibre-gl callout shown alongside the json-viewer fallback. |\n| `spinner` | The loading status region. |\n| `status` | The feature-count status line. |",
+          "description": "`<lr-geojson-view>` — internal document-registry bridge rendering a fetched GeoJSON file through\n`<lr-map>`'s `dataLayers`. Not a documented public tag: excluded from README/llms family tables,\npresent in the generated manifest since a defined custom element is technically reachable.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. It owns the named region in non-map states, the missing-peer fallback, and while a lazy map initializes; the loaded map canvas then owns that landmark. |\n| `error` | The error region. |\n| `metadata` | Searchable, selectable serialized GeoJSON metadata; scrolls inline rather than widening a narrow allocation. |\n| `missing-library` | The missing-maplibre-gl callout shown alongside the json-viewer fallback. |\n| `spinner` | The loading status region. |\n| `status` | The feature-count status line. |",
           "attributes": [
             {
               "name": "locale",
@@ -7837,7 +7817,7 @@
             },
             {
               "name": "name",
-              "description": "Type: `string`  \nDefault: `''`",
+              "description": "Accessible-name fallback for the current region owner: the root in non-map states, or the\nloaded map canvas when the optional peer is available.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -7983,7 +7963,7 @@
         },
         {
           "name": "lr-graph-legend",
-          "description": "`<lr-graph-legend>` — a node-type legend for a paired `lr-graph`: one swatch + label + count\nrow per `lr-graph` node type, doubling as visibility filters. Never reads or writes a graph directly —\nthe host forwards `types` in from `graph.nodeTypes` and `hiddenTypes` back out to\n`graph.hiddenTypes` on `lr-visibility-change`, the same event-decoupled contract every sibling\nin this family follows.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The `role=\"group\"` wrapper. |\n| `count` | The optional per-type count. |\n| `item` | One row per type — a `<button>` when `interactive`, a plain `<div>` otherwise. |\n| `label` | The type's label text. |\n| `live-region` | The visually hidden filter-toggle announcement. |\n| `swatch` | The type's shape glyph. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-graph-legend-hidden-color` (default: `var(--lr-color-text-quiet)`) — Text color for a filtered-out (hidden) legend row's label/count, independent of the shared quiet-text token.",
+          "description": "`<lr-graph-legend>` — a node-type legend for a paired `lr-graph`: one swatch + label + count\nrow per `lr-graph` node type, doubling as visibility filters. Never reads or writes a graph directly —\nthe host forwards `types` in from `graph.nodeTypes` and `hiddenTypes` back out to\n`graph.hiddenTypes` on `lr-visibility-change`, the same event-decoupled contract every sibling\nin this family follows.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The `role=\"group\"` wrapper. |\n| `count` | The optional per-type count. |\n| `item` | One row per type — a `<button>` when `interactive`, a plain `<div>` otherwise. |\n| `label` | The type's label text. |\n| `live-region` | The visually hidden filter-toggle announcement. |\n| `swatch` | The type's shape glyph. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-graph-legend-hidden-color` (default: `var(--lr-color-text-quiet)`) — Text color for a filtered-out (hidden) legend row's label/count, independent of the shared quiet-text token.\n- `--lr-graph-legend-hidden-swatch-opacity` (default: `0.5`) — Opacity of a filtered-out row's decorative swatch.",
           "attributes": [
             {
               "name": "interactive",
@@ -8283,7 +8263,7 @@
         },
         {
           "name": "lr-histogram",
-          "description": "`<lr-histogram>` — bins `values` into `bins` equal-width buckets and\nrenders them as a bar chart. Chart.js has no built-in histogram\ncontroller; this composes `binValues()` with the plain `bar` type.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-histogram>` — bins `values` into `bins` equal-width buckets and\nrenders them as a bar chart. Chart.js has no built-in histogram\ncontroller; this composes `binValues()` with the plain `bar` type.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -8469,7 +8449,7 @@
         },
         {
           "name": "lr-html-viewer",
-          "description": "Fetches and safely renders an inline HTML document.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. |\n| `body` | The wrapper around the fetched-state content. |\n| `error` | The error region. |\n| `html` | The sanitized HTML document, once loaded. |\n| `spinner` | The loading region. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-html-viewer-max-height` (default: `none`) — Maximum block size of `[part=\"body\"]` before it scrolls internally. The `maxHeight` property sets this token inline on `[part=\"base\"]`.",
+          "description": "Fetches and safely renders an inline HTML document. The sanitized surface establishes paint\ncontainment so retained author styles cannot position content over the surrounding application.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root container. |\n| `body` | The wrapper around the fetched-state content. |\n| `error` | The error region. |\n| `html` | The sanitized HTML document, once loaded. |\n| `spinner` | The loading region. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-html-viewer-max-height` (default: `none`) — Maximum block size of `[part=\"body\"]` before it scrolls internally. The `maxHeight` property sets this token inline on `[part=\"base\"]`.",
           "attributes": [
             {
               "name": "locale",
@@ -8482,7 +8462,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable body.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -8779,7 +8759,7 @@
         },
         {
           "name": "lr-include",
-          "description": "`<lr-include>` fetches an HTML fragment from `src` and transcludes it into\nthe page as sanitized light-DOM content, so the fragment participates in\nthe surrounding page's CSS cascade exactly like a native server-side\ninclude — unlike `<lr-html-viewer>`, which renders a foreign document\ninside an isolated preview card.\n\nThe fetched markup always passes through the shared DOMPurify-backed\nsanitizer (`loadHtmlSanitizer()`, the same loader `<lr-html-viewer>`\nuses) before it ever touches `innerHTML` — there is no `allow-scripts`\nescape hatch here, unlike the Web Awesome/Shoelace components this element\notherwise mirrors: their raw, unsanitized injection (with an opt-in to\nactually re-execute embedded `<script>` tags) is incompatible with this\nlibrary's sanitize-always contract, so that option is simply omitted\nrather than shipped as a documented no-op.\n\n`mode` deliberately defaults to `'same-origin'` rather than the `'cors'`\ndefault those upstream components document — a same-origin-only fetch\nfails closed unless a consumer explicitly opts in to cross-origin fetching\nwith `mode=\"cors\"` (and the remote server cooperates via CORS headers).\n`'no-cors'` is accepted for enum completeness but is rarely useful: it\nalways yields an opaque response (`status` `0`, unreadable body), a Fetch\nAPI platform limitation rather than a bug here.\n\nThis is a deliberately bare transclusion primitive with no label/hint/\nerror chrome — its interaction idiom (silently swapping light-DOM content)\nis incompatible with a generic label/hint/error frame. Listen for\n`lr-include-error` to build your own error UI, and author meaningful\nfallback content inside `<lr-include>` for when the fetch never\nsucceeds; that fallback (and any previously successful include) is left\nuntouched on failure. No `aria-live` region wraps the slot either: the\nfragment can contain its own landmarks and nested content, and forcing the\nwhole host into a live region would re-announce all of it on every load.\n\nNo implicit ARIA role and no computed accessible name are applied around\nthe transcluded content — the fragment's own semantics (headings,\nlandmarks, its own `role`/`aria-*` attributes) surface directly and\nunmodified, exactly as they would in a native include. `aria-busy=\"true\"`\nis set on the host while a fetch is in flight and removed once it settles,\nwhether it succeeds or fails.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Fallback content shown until (or unless) a fetch succeeds; overwritten with the sanitized fragment once one does. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The non-layout (`display: contents`) wrapper around the default slot. |",
+          "description": "`<lr-include>` fetches an HTML fragment from `src` and transcludes it into\nthe page as sanitized light-DOM content, so the fragment participates in\nthe surrounding page's CSS cascade exactly like a native server-side\ninclude — unlike `<lr-html-viewer>`, which renders a foreign document\ninside an isolated preview card.\n\nThe fetched markup always passes through the shared DOMPurify-backed\nsanitizer (`loadHtmlSanitizer()`, the same loader `<lr-html-viewer>`\nuses) before it ever touches `innerHTML` — there is no `allow-scripts`\nescape hatch here, unlike the Web Awesome/Shoelace components this element\notherwise mirrors: their raw, unsanitized injection (with an opt-in to\nactually re-execute embedded `<script>` tags) is incompatible with this\nlibrary's sanitize-always contract, so that option is simply omitted\nrather than shipped as a documented no-op.\n\n`mode` deliberately defaults to `'same-origin'` rather than the `'cors'`\ndefault those upstream components document — a same-origin-only fetch\nfails closed unless a consumer explicitly opts in to cross-origin fetching\nwith `mode=\"cors\"` (and the remote server cooperates via CORS headers).\n`'no-cors'` is accepted for enum completeness but is rarely useful: it\nalways yields an opaque response (`status` `0`, unreadable body), a Fetch\nAPI platform limitation rather than a bug here.\n\nThis is a deliberately bare transclusion primitive with no label/hint/\nerror chrome — its interaction idiom (silently swapping light-DOM content)\nis incompatible with a generic label/hint/error frame. Listen for\n`lr-include-error` to build your own error UI, and author meaningful\nfallback content inside `<lr-include>` for when the fetch never\nsucceeds; that fallback (and any previously successful include) is left\nuntouched on failure. No `aria-live` region wraps the slot either: the\nfragment can contain its own landmarks and nested content, and forcing the\nwhole host into a live region would re-announce all of it on every load.\n\nNo implicit ARIA role and no computed accessible name are applied around\nthe transcluded content — the fragment's own semantics (headings,\nlandmarks, its own `role`/`aria-*` attributes) surface directly and\nunmodified, exactly as they would in a native include. The host carries an\nexplicit `aria-busy` state: `\"true\"` while a fetch is in flight and\n`\"false\"` otherwise.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Fallback content shown until (or unless) a fetch succeeds; overwritten with the sanitized fragment once one does. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The non-layout (`display: contents`) wrapper around the default slot. |",
           "attributes": [
             {
               "name": "locale",
@@ -9078,7 +9058,7 @@
         },
         {
           "name": "lr-json-viewer",
-          "description": "`<lr-json-viewer>` — a collapsible, copyable tree view for an arbitrary\nJSON-serializable value (object/array/string/number/boolean/null/\nundefined). Serves as the fallback renderer wherever a raw payload (tool\ncall arguments, a tool result, an API response) needs inspecting without a\nbespoke view.\n\nExpand/collapse state is keyed by structural path (not by object identity),\nso it survives a `data` reassignment that keeps the same shape -- e.g. a\nstreaming tool result being patched in place.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root scroll container; respects `max-height`. |\n| `bracket` | A `{`, `}`, `[`, or `]` delimiter. |\n| `copy-button` | A copy-to-clipboard button -- the top-level one (in `toolbar`, labelled \"Copy JSON to clipboard\") or a per-node one (only rendered when `copyable`; labelled with its own key/type, e.g. \"Copy age\", so assistive tech can tell rows apart). |\n| `key` | An object property key or array index label. |\n| `limit` | Localized notice shown when the depth/node traversal budget truncates rendering or search. |\n| `toggle` | A container node's expand/collapse button (hidden, but present for row alignment, on leaf/empty nodes). |\n| `toolbar` | The wrapper around the top-level copy button (only rendered when `copyable`). |\n| `tree` | The wrapper around the rendered node tree. |\n| `value` | A primitive value's text -- carries `data-type` (`string`/`number`/`boolean`/`null`/`undefined`, or `circular` for a self-reference marker in place of a re-visited container's subtree) for per-type coloring, `data-match` while it matches `search`, and `data-active` while it is the current `searchNext()`/`searchPrevious()` cursor position. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-json-viewer-max-height` (default: `none`) — Cap on `[part=\"base\"]`'s block size, past which the viewer scrolls internally. The `maxHeight` property sets this token inline on `[part=\"base\"]`.\n- `--lr-json-viewer-font` (default: `var(--lr-font-mono)`) — Font family used for the rendered tree.\n- `--lr-json-viewer-match-bg` (default: `var(--lr-color-warning-quiet)`) — Background (and surrounding box-shadow) of a key/value that currently matches `search`.\n- `--lr-json-viewer-active-outline` (default: `var(--lr-focus-ring-color)`) — Outline color for the current imperative search match.\n- `--lr-json-viewer-string-color` (default: `var(--lr-color-success)`) — String value color.\n- `--lr-json-viewer-number-color` (default: `var(--lr-color-brand)`) — Number value color.\n- `--lr-json-viewer-boolean-color` (default: `var(--lr-color-warning)`) — Boolean value color.\n- `--lr-json-viewer-null-color` (default: `var(--lr-color-text-quiet)`) — Null, undefined, and circular-reference marker color.",
+          "description": "`<lr-json-viewer>` — a collapsible, copyable tree view for an arbitrary\nJSON-serializable value (object/array/string/number/boolean/null/\nundefined). Serves as the fallback renderer wherever a raw payload (tool\ncall arguments, a tool result, an API response) needs inspecting without a\nbespoke view.\n\nExpand/collapse state is keyed by structural path (not by object identity),\nso it survives a `data` reassignment that keeps the same shape -- e.g. a\nstreaming tool result being patched in place.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root scroll container; respects `max-height`. |\n| `bracket` | A `{`, `}`, `[`, or `]` delimiter. |\n| `copy-button` | A copy-to-clipboard button -- the top-level one (in `toolbar`, labelled \"Copy JSON to clipboard\") or a per-node one (only rendered when `copyable`; labelled with its own key/type, e.g. \"Copy age\", so assistive tech can tell rows apart). |\n| `key` | An object property key or array index label. |\n| `limit` | Localized notice shown when the depth/node traversal budget truncates rendering or search. |\n| `row` | A single structural JSON row (opening/value rows and closing-delimiter rows). |\n| `toggle` | A container node's expand/collapse button (hidden, but present for row alignment, on leaf/empty nodes). |\n| `toolbar` | The wrapper around the top-level copy button (only rendered when `copyable`). |\n| `tree` | The wrapper around the rendered node tree. |\n| `value` | A primitive value's text -- carries `data-type` (`string`/`number`/`boolean`/`null`/`undefined`, or `circular` for a self-reference marker in place of a re-visited container's subtree) for per-type coloring, `data-match` while it matches `search`, and `data-active` while it is the current `searchNext()`/`searchPrevious()` cursor position. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-json-viewer-max-height` (default: `none`) — Cap on `[part=\"base\"]`'s block size, past which the viewer scrolls internally. The `maxHeight` property sets this token inline on `[part=\"base\"]`.\n- `--lr-json-viewer-font` (default: `var(--lr-font-mono)`) — Font family used for the rendered tree.\n- `--lr-json-viewer-match-bg` (default: `var(--lr-color-warning-quiet)`) — Background (and surrounding box-shadow) of a key/value that currently matches `search`.\n- `--lr-json-viewer-row-hover-bg` (default: `var(--lr-color-brand-quiet)`) — Hover background for a structural row.\n- `--lr-json-viewer-active-outline` (default: `var(--lr-focus-ring-color)`) — Outline color for the current imperative search match.\n- `--lr-json-viewer-string-color` (default: `var(--lr-color-success)`) — String value color.\n- `--lr-json-viewer-number-color` (default: `var(--lr-color-brand)`) — Number value color.\n- `--lr-json-viewer-boolean-color` (default: `var(--lr-color-warning)`) — Boolean value color.\n- `--lr-json-viewer-null-color` (default: `var(--lr-color-text-quiet)`) — Null, undefined, and circular-reference marker color.",
           "attributes": [
             {
               "name": "collapsed-depth",
@@ -9104,7 +9084,7 @@
             },
             {
               "name": "max-height",
-              "description": "A CSS length (e.g. `\"20rem\"`); once set, the viewer scrolls internally past this height instead of growing the page.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS length (e.g. `\"20rem\"`); once set, the viewer scrolls internally past this height\ninstead of growing the page. Invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -9124,7 +9104,7 @@
         },
         {
           "name": "lr-kbd",
-          "description": "`<lr-kbd>` — a small chip representing a keyboard shortcut, rendering\nthe platform-appropriate glyph for cross-platform modifier keys (⌘ on\nmacOS, \"Ctrl\" elsewhere) from a single platform-neutral `keys` string.\n\n`keys` is a `+`-separated sequence of tokens, e.g. `\"mod+k\"` or\n`\"mod+shift+p\"`. Recognized modifier tokens: `mod` (the platform-neutral\nprimary modifier — ⌘ on macOS, \"Ctrl\" elsewhere), `alt` (⌥ / \"Alt\"),\n`shift` (⇧ on every platform), and `ctrl` (always the literal Control\nkey, distinct from `mod`, for a shortcut that's specifically Ctrl even on\nmacOS). Any other token renders as typed, except a bare single\nletter/digit which is upper-cased, with a small built-in map of friendly\nlabels for common named keys (`enter` → `↵`, `esc` → \"Esc\", the four\narrow keys → arrow glyphs, plus `tab`/`space`/`backspace`/`delete`/`home`/\n`end`/`pageup`/`pagedown`/`plus`/`minus`). `enter` renders as its `↵`\nglyph (not the word \"Enter\") to match the other single-glyph modifier/\narrow keys visually — its spelled-out word form still appears in the\ncomputed `aria-label`.\n\nEach token renders as its own key cap (`part=\"key\"`); consecutive caps\nare joined by a small \"+\" separator between them, matching how most\ncross-platform shortcut documentation (including on macOS, despite the\nOS's own native shortcut hints usually running the glyphs together with\nno separator) reads unambiguously regardless of how many/which glyphs are\ninvolved.\n\nThe default slot is not used for the normal glyph rendering above — it's\nan escape hatch for fully custom content (e.g. an icon instead of a text\nglyph) that, when non-empty, replaces the `keys`-driven rendering\nentirely and stops this component from asserting its own `aria-label`,\nleaving the slotted content to carry its own accessible name.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Optional override for fully custom key-cap content, replacing the `keys`-driven rendering. Leave empty to use `keys`. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chip's root element. |\n| `key` | Each rendered key cap (one per token in `keys`). |",
+          "description": "`<lr-kbd>` — a small chip representing a keyboard shortcut, rendering\nthe platform-appropriate glyph for cross-platform modifier keys (⌘ on\nmacOS, \"Ctrl\" elsewhere) from a single platform-neutral `keys` string.\n\n`keys` is a `+`-separated sequence of tokens, e.g. `\"mod+k\"` or\n`\"mod+shift+p\"`. Recognized modifier tokens: `mod` (the platform-neutral\nprimary modifier — ⌘ on macOS, \"Ctrl\" elsewhere), `alt` (⌥ / \"Alt\"),\n`shift` (⇧ on every platform), and `ctrl` (always the literal Control\nkey, distinct from `mod`, for a shortcut that's specifically Ctrl even on\nmacOS). Any other token renders as typed, except a bare single\nletter/digit which is upper-cased, with a small built-in map of friendly\nlabels for common named keys (`enter` → `↵`, `esc` → \"Esc\", the four\narrow keys → arrow glyphs, plus `tab`/`space`/`backspace`/`delete`/`home`/\n`end`/`pageup`/`pagedown`/`plus`/`minus`). `enter` renders as its `↵`\nglyph (not the word \"Enter\") to match the other single-glyph modifier/\narrow keys visually — its spelled-out word form still appears in the\ncomputed `aria-label`.\n\nEach token renders as its own key cap (`part=\"key\"`); consecutive caps\nare joined by a small \"+\" separator between them, matching how most\ncross-platform shortcut documentation (including on macOS, despite the\nOS's own native shortcut hints usually running the glyphs together with\nno separator) reads unambiguously regardless of how many/which glyphs are\ninvolved.\n\nThe default slot is not used for the normal glyph rendering above — it's\nan escape hatch for fully custom content (e.g. an icon instead of a text\nglyph) that, when non-empty, replaces the `keys`-driven rendering.\nA host `aria-label` names that custom shortcut as one `role=\"img\"` unit;\nwithout one, the slotted content continues to own its own semantics.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Optional override for fully custom key-cap content, replacing the `keys`-driven rendering. Leave empty to use `keys`. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chip's root element. |\n| `key` | Each rendered key cap (one per token in `keys`). |",
           "attributes": [
             {
               "name": "keys",
@@ -9194,7 +9174,7 @@
           "attributes": [
             {
               "name": "active-tab",
-              "description": "Active tab. Controlled by the host after `lr-tab-change` if desired.\n\nType: `KnowledgeBaseAdminTab`  \nDefault: `'sources'`",
+              "description": "Active tab. Controlled by the host after `lr-tab-change` if desired. If the ingestion tab\nbecomes unavailable, this normalizes to `'sources'` through the same event contract.\n\nType: `KnowledgeBaseAdminTab`  \nDefault: `'sources'`",
               "value": {
                 "type": [
                   "KnowledgeBaseAdminTab"
@@ -9203,7 +9183,7 @@
             },
             {
               "name": "hide-ingestion",
-              "description": "Hides the ingestion tab and queue.\n\nType: `boolean`  \nDefault: `false`",
+              "description": "Hides the ingestion tab and queue. An active/focused ingestion tab moves to Sources.\n\nType: `boolean`  \nDefault: `false`",
               "value": {
                 "type": [
                   "boolean"
@@ -9232,7 +9212,7 @@
         },
         {
           "name": "lr-knowledge-graph-explorer",
-          "description": "`<lr-knowledge-graph-explorer>` — an orchestration-level surface for exploring a knowledge\ngraph: the `lr-graph` canvas plus entity search, type filters, neighborhood expansion, pinned\nnodes, path finding between pins, node selection, and a details overlay. Composes existing\nprimitives rather than re-implementing graph rendering: `lr-graph` (canvas/pan-zoom/selection),\n`lr-graph-legend` (type filters), `lr-entity-card` (the details popover's default content),\n`lr-neighbor-list` (the selected entity's relationships), `lr-path-strip` (a found path), and\n`lr-popover.showAt()` (the details overlay itself).\n\n**How the details popover finds its viewport position.** `lr-graph.getNodePosition()` and the\n`lr-node-click` event's `{ x, y }` are in the graph's own *local drawing space* (pre pan/zoom),\nnever viewport pixels -- passing them straight to `showAt()` would anchor the popover at the\nwrong place as soon as the graph has panned or zoomed even once. A direct node click resolves\nthe correct viewport rect the way this library's own documented `lr-graph` + `lr-popover.showAt()`\ncomposition does: for `renderer=\"svg\"` (the default), `event.composedPath()` (the native `click`\nthat bubbles out of `lr-graph`'s shadow root) locates the actual clicked `[part=\"node\"]` element,\nwhose `getBoundingClientRect()` is already viewport-relative; for `renderer=\"canvas\"` (no\nper-node DOM element to find), the click event's own `clientX`/`clientY` are used directly, since\ncanvas hit-testing already treats those as viewport coordinates internally. While the popover\nstays open after an `renderer=\"svg\"` click, this component re-reads that same resolved node\nelement's `getBoundingClientRect()` and re-calls `showAt()` every time the composed `lr-graph`\nemits its own `lr-viewport-change` (a frame-coalesced pan/zoom/simulation-tick signal) --\nschedules no `requestAnimationFrame` loop of its own, unlike an idle popover polling the DOM on\nevery frame regardless of whether anything actually moved. Selecting a node any other\nway -- a search result, a neighbor row, a path-strip element, keyboard Enter/Space on a graph\nnode (which never dispatches a native `click`) -- has no click event to read a rect from, so it\ninstead calls the public `lr-graph.focusNode(id)` (which centers that node in the viewport) and\nthen anchors the popover at the graph element's own `getBoundingClientRect()` center once that\nsettles; no continuous tracking applies to that path.\n\n**Controlled vs. self-managed state.** `nodes`/`links`/`nodeTypes`/`communities`/`entityDetails`/\n`path` are purely host-supplied data, rendered as given. `hiddenTypes`/`selectedNodeId`/\n`searchQuery`/`pinnedNodeIds` are this component's own genuinely new contribution: it wires them\ninto `lr-graph`'s existing controlled props (`hiddenTypes`, `selectedNodeIds`, `dimmedNodeIds`,\n`dimmedLinkIds`) itself, toggling its own copy on interaction (the same self-toggle-then-emit\ncontract `lr-graph-legend` already uses) so every feature works with zero host wiring, while\nstill being presettable/observable properties and emitting events (`lr-selection-change`,\n`lr-pin-change`, `lr-path-request`, plus every composed primitive's own event bubbling straight through\nunmodified) for a host that wants to persist or react to them.\n\n`highlight` controls what drives that dimming, on top of the always-active search-match\ndimming: `'selection'` (the default) dims by the selected node's immediate neighborhood;\n`'hover'` also dims by whichever node is currently pointer-hovered (falling back to the selected\nnode's neighborhood while nothing is hovered); `'none'` turns this component's own dimming off\nentirely, forwarding empty `dimmedNodeIds`/`dimmedLinkIds` regardless of search/selection state\n-- for a host that wants to drive `lr-graph`'s dimming through a different composition instead.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `details` | Overrides the details popover's default content (an `lr-entity-card` with a nested `lr-neighbor-list` and a pin toggle). Receives no data -- a consumer overriding this slot reads the selected entity from `selectedNodeId`/`nodes` itself. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root `role=\"group\"` wrapper. |\n| `detail-card` | The default-content `lr-entity-card`, only present while `selectedNodeId` resolves to a node. |\n| `detail-popover` | The composed `lr-popover` hosting the details overlay. |\n| `graph` | The composed `lr-graph`. |\n| `legend` | The composed `lr-graph-legend`. |\n| `path` | The composed `lr-path-strip`, only rendered while `path` is non-empty. |\n| `pinned` | The pinned-nodes row, only rendered while `pinnedNodeIds` is non-empty. |\n| `pinned-heading` | The pinned-nodes row's leading label. |\n| `search` | The composed `lr-entity-card` search `lr-input`. |\n| `search-empty` | The \"no matches\" message, shown when `searchQuery` is non-empty but no node matches. |\n| `search-result` | One search-match row (`role=\"listitem\"`, wrapping a `<button>`). |\n| `search-results` | The search-match list, only rendered while `searchQuery` is non-empty. |\n| `toolbar` | The row wrapping the search input and the type-filter legend. |",
+          "description": "`<lr-knowledge-graph-explorer>` — an orchestration-level surface for exploring a knowledge\ngraph: the `lr-graph` canvas plus entity search, type filters, neighborhood expansion, pinned\nnodes, path finding between pins, node selection, and a details overlay. Composes existing\nprimitives rather than re-implementing graph rendering: `lr-graph` (canvas/pan-zoom/selection),\n`lr-graph-legend` (type filters), `lr-entity-card` (the details popover's default content),\n`lr-neighbor-list` (the selected entity's relationships), `lr-path-strip` (a found path), and\n`lr-popover.showAt()` (the details overlay itself).\n\n**How the details popover finds its viewport position.** `lr-graph.getNodePosition()` and the\n`lr-node-click` event's `{ x, y }` are in the graph's own *local drawing space* (pre pan/zoom),\nnever viewport pixels -- passing them straight to `showAt()` would anchor the popover at the\nwrong place as soon as the graph has panned or zoomed even once. A direct node click resolves\nthe correct viewport rect the way this library's own documented `lr-graph` + `lr-popover.showAt()`\ncomposition does: for `renderer=\"svg\"` (the default), `event.composedPath()` (the native `click`\nthat bubbles out of `lr-graph`'s shadow root) locates the actual clicked `[part=\"node\"]` element,\nwhose `getBoundingClientRect()` is already viewport-relative; for `renderer=\"canvas\"` (no\nper-node DOM element to find), the click event's own `clientX`/`clientY` are used directly, since\ncanvas hit-testing already treats those as viewport coordinates internally. While the popover\nstays open after an `renderer=\"svg\"` click, this component re-reads that same resolved node\nelement's `getBoundingClientRect()` and re-calls `showAt()` every time the composed `lr-graph`\nemits its own `lr-viewport-change` (a frame-coalesced pan/zoom/simulation-tick signal) --\nschedules no `requestAnimationFrame` loop of its own, unlike an idle popover polling the DOM on\nevery frame regardless of whether anything actually moved. Selecting a node any other\nway -- a search result, a neighbor row, a path-strip element, keyboard Enter/Space on a graph\nnode (which never dispatches a native `click`) -- has no click event to read a rect from, so it\ninstead calls the public `lr-graph.focusNode(id)` (which centers that node in the viewport) and\nthen anchors the popover at the graph element's own `getBoundingClientRect()` center once that\nsettles; no continuous tracking applies to that path.\n\n**Controlled vs. self-managed state.** `nodes`/`links`/`nodeTypes`/`communities`/`entityDetails`/\n`path` are purely host-supplied data, rendered as given. `hiddenTypes`/`selectedNodeId`/\n`searchQuery`/`pinnedNodeIds` are this component's own genuinely new contribution: it wires them\ninto `lr-graph`'s existing controlled props (`hiddenTypes`, `selectedNodeIds`, `dimmedNodeIds`,\n`dimmedLinkIds`) itself, toggling its own copy on interaction (the same self-toggle-then-emit\ncontract `lr-graph-legend` already uses) so every feature works with zero host wiring, while\nstill being presettable/observable properties and emitting events (`lr-selection-change`,\n`lr-pin-change`, `lr-path-request`, plus every composed primitive's own event bubbling straight through\nunmodified) for a host that wants to persist or react to them.\nHidden node types are excluded from both search matches and selected-entity neighbor rows, and\nactivation requests for a hidden node are ignored before selection changes.\n\n`highlight` controls what drives that dimming, on top of the always-active search-match\ndimming: `'selection'` (the default) dims by the selected node's immediate neighborhood;\n`'hover'` also dims by whichever node is currently pointer-hovered (falling back to the selected\nnode's neighborhood while nothing is hovered); `'none'` turns this component's own dimming off\nentirely, forwarding empty `dimmedNodeIds`/`dimmedLinkIds` regardless of search/selection state\n-- for a host that wants to drive `lr-graph`'s dimming through a different composition instead.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `details` | Overrides the details popover's default content (an `lr-entity-card` with a nested `lr-neighbor-list` and a pin toggle). Receives no data -- a consumer overriding this slot reads the selected entity from `selectedNodeId`/`nodes` itself. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root `role=\"group\"` wrapper. |\n| `detail-card` | The default-content `lr-entity-card`, only present while `selectedNodeId` resolves to a node. |\n| `detail-popover` | The composed `lr-popover` hosting the details overlay. |\n| `graph` | The composed `lr-graph`. |\n| `legend` | The composed `lr-graph-legend`. |\n| `path` | The composed `lr-path-strip`, only rendered while `path` is non-empty. |\n| `pinned` | The pinned-nodes row, only rendered while `pinnedNodeIds` is non-empty. |\n| `pinned-heading` | The pinned-nodes row's leading label. |\n| `search` | The composed `lr-entity-card` search `lr-input`. |\n| `search-empty` | The \"no matches\" message, shown when `searchQuery` is non-empty but no node matches. |\n| `search-result` | One search-match row (`role=\"listitem\"`, wrapping a `<button>`). |\n| `search-results` | The search-match list, only rendered while `searchQuery` is non-empty. |\n| `toolbar` | The row wrapping the search input and the type-filter legend. |",
           "attributes": [
             {
               "name": "height",
@@ -9512,7 +9492,7 @@
             },
             {
               "name": "show-counter",
-              "description": "Shows/hides `part=\"counter\"` (and its `part=\"live-region\"` announcement). Mirrors\n`<lr-carousel>`'s `showIndicators` (name shape, no reflect). Uses\nshowCounterConverter rather than Lit's default presence-based `type: Boolean`\nhandling, so a plain-HTML consumer with no way to write a `.showCounter` property binding\ncan still turn this off with `show-counter=\"false\"`.\n\nType: `boolean`  \nDefault: `true`",
+              "description": "Shows/hides only the visible `part=\"counter\"`. The accessibility `part=\"live-region\"`\nannouncement remains active so navigation is still conveyed when visual chrome is hidden.\nMirrors `<lr-carousel>`'s `showIndicators` (name shape, no reflect). Uses\nshowCounterConverter rather than Lit's default presence-based `type: Boolean`\nhandling, so a plain-HTML consumer with no way to write a `.showCounter` property binding\ncan still turn this off with `show-counter=\"false\"`.\n\nType: `boolean`  \nDefault: `true`",
               "value": {
                 "type": [
                   "boolean"
@@ -9532,7 +9512,7 @@
         },
         {
           "name": "lr-line-chart",
-          "description": "`<lr-line-chart>` — `<lr-chart>` with `type` locked to `\"line\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-line-chart>` — `<lr-chart>` with `type` locked to `\"line\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -9700,7 +9680,7 @@
         },
         {
           "name": "lr-lite-chart",
-          "description": "`<lr-lite-chart>` — a dependency-free bar/line chart, plain SVG/DOM\nrendering with zero peer dependencies (unlike `lr-chart`, which wraps\n`chart.js`). For a project whose architecture forbids a charting\ndependency outright, this covers the common bar/line case: grouped or\nstacked bars, multi-series lines, per-point click, and hover tooltips\n(native SVG `<title>`, no positioning JS needed) — not a full `lr-chart`\nreplacement (no zoom/pan, no pie/doughnut/radar/scatter/bubble types, no\nhorizontal/dual-y-axis, no raw-config passthrough).\n\nBecause this renders real DOM (not canvas), it reuses `lr-chart`'s\n`--lr-chart-*` theme tokens directly via CSS `var()` — no\n`getComputedStyle()`-based re-theming step is needed the way `chart.ts`\nneeds one for its canvas.\n\nBy default (`layout=\"fit\"`) the plot always squeezes to the measured host\nwidth. Three independent, opt-in escape hatches for dense/aligned data:\n`layout=\"scroll\"` (+ `barWidth`) gives every bar a fixed pixel width and\nlets the plot overflow the host horizontally (scrollable) instead of\nsqueezing; `maxLabels` decimates which x-axis text labels render (bars\nalways still render) once there are more categories than that; and\n`barX` lets a consumer hand in its own per-category x-coordinate function\n— e.g. to pixel-align this chart's bars with a sibling `lr-heatmap`'s\ncalendar columns — overriding the internal slot math for both bars and\ntheir labels. All three are additive and no-ops when left unset.\n\nSeven further additive, opt-in properties: `pointText` overrides the\nper-bar/per-point `<title>`/`aria-label` tooltip text (mirrors\n`lr-heatmap`'s `cellText` hook), falling back to the built-in raw-value\ntemplate when unset; `roundedBars` draws bars as a rounded-top path\ninstead of a square-cornered rect; `skipZero` omits a bar entirely (not\njust zero-height) for an exactly-`0` value; `padLeft`/`barGapRatio`\noverride the internal `PAD_LEFT`/`BAR_GROUP_GAP` layout constants; `scale`\n(`type=\"bar\"` only) switches the bar-height mapping from the default\nlinear `niceDomain` fraction to a `Math.sqrt(value / domainMax)`\ncompression (mirroring `lr-heatmap`'s matrix-mode `sqrt` scale) so a\nskewed dataset's smaller bars don't get washed out by one dominant value\n— gridlines/tick labels stay on the linear domain regardless, only the bar\nmarks' own height changes, and `type=\"line\"` ignores `scale` entirely; and\n`hideAxis` suppresses `renderGrid()`'s gridlines/tick labels altogether\n(x-axis category labels, rendered separately, are unaffected). An eighth,\n`legendText`, appends a formatter-supplied string after each series' label in the\nbuilt-in legend row (e.g. a value or share) — no-op while `legend` is unset, matching the same\nfallback-to-unchanged convention as every other hook here. The built-in multi-series accessible\ntable can independently format its finite numeric cells through `tableCellFormatter`; for a\nstacked bar chart, `tableTotals` adds an opt-in localized total column. Both are no-ops when\nunset.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `axis-label` | Each axis tick label. |\n| `axis-title` | The x/y axis title text, when set. |\n| `bar` | Each bar rect (type=\"bar\"). Carries `data-selected` and `aria-pressed=\"true\"` when its category index is in `selectedIndex`. |\n| `base` | The host's flex layout wrapper. |\n| `data-list` | A visually hidden list of all plotted data points (single-series only). |\n| `data-table` | A visually hidden category×series data table, rendered instead of `data-list` when there is more than one dataset so a screen-reader user hears series grouping rather than one flattened N×M sequence. |\n| `grid-line` | Each horizontal gridline. |\n| `legend` | The legend row, when `legend` is set. |\n| `legend-item` | Each legend entry. |\n| `legend-swatch` | Each legend entry's color swatch. |\n| `legend-text` | Extra per-item text after the series label, rendered only when `legendText` is set. |\n| `line` | Each series' stroked line path (type=\"line\"). |\n| `live-region` | The current mark announcement for keyboard users. |\n| `point` | Each series' per-point keyboard target (type=\"line\"). Carries `data-selected` and explicit `aria-pressed` state. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-lite-chart-selected-outline-color` (default: `var(--lr-color-brand)`) — Stroke for a bar/point whose category index is in `selectedIndex`.",
+          "description": "`<lr-lite-chart>` — a dependency-free bar/line chart, plain SVG/DOM\nrendering with zero peer dependencies (unlike `lr-chart`, which wraps\n`chart.js`). For a project whose architecture forbids a charting\ndependency outright, this covers the common bar/line case: grouped or\nstacked bars, multi-series lines, per-point click, and hover tooltips\n(native SVG `<title>`, no positioning JS needed) — not a full `lr-chart`\nreplacement (no zoom/pan, no pie/doughnut/radar/scatter/bubble types, no\nhorizontal/dual-y-axis, no raw-config passthrough).\n\nBecause this renders real DOM (not canvas), it reuses `lr-chart`'s\n`--lr-chart-*` theme tokens directly via CSS `var()` — no\n`getComputedStyle()`-based re-theming step is needed the way `chart.ts`\nneeds one for its canvas.\n\nBy default (`layout=\"fit\"`) the plot always squeezes to the measured host\nwidth. Three independent, opt-in escape hatches for dense/aligned data:\n`layout=\"scroll\"` (+ `barWidth`) gives every bar a fixed pixel width and\nlets the plot overflow the host horizontally (scrollable) instead of\nsqueezing; `maxLabels` decimates which x-axis text labels render (bars\nalways still render) once there are more categories than that; and\n`barX` lets a consumer hand in its own per-category x-coordinate function\n— e.g. to pixel-align this chart's bars with a sibling `lr-heatmap`'s\ncalendar columns — overriding the internal slot math for both bars and\ntheir labels. All three are additive and no-ops when left unset.\n\nSeven further additive, opt-in properties: `pointText` overrides the\nper-bar/per-point `<title>` tooltip and accessible-name text (mirrors\n`lr-heatmap`'s `cellText` hook), falling back to the built-in raw-value\ntemplate when unset; `roundedBars` draws bars as a rounded-top path\ninstead of a square-cornered rect; `skipZero` omits a bar entirely (not\njust zero-height) for an exactly-`0` value; `padLeft`/`barGapRatio`\noverride the internal `PAD_LEFT`/`BAR_GROUP_GAP` layout constants; `scale`\n(`type=\"bar\"` only) switches the bar-height mapping from the default\nlinear `niceDomain` fraction to a `Math.sqrt(value / domainMax)`\ncompression (mirroring `lr-heatmap`'s matrix-mode `sqrt` scale) so a\nskewed dataset's smaller bars don't get washed out by one dominant value\n— gridlines/tick labels stay on the linear domain regardless, only the bar\nmarks' own height changes, and `type=\"line\"` ignores `scale` entirely; and\n`hideAxis` suppresses `renderGrid()`'s gridlines/tick labels altogether\n(x-axis category labels, rendered separately, are unaffected). An eighth,\n`legendText`, appends a formatter-supplied string after each series' label in the\nbuilt-in legend row (e.g. a value or share) — no-op while `legend` is unset, matching the same\nfallback-to-unchanged convention as every other hook here. The built-in multi-series accessible\ntable can independently format its finite numeric cells through `tableCellFormatter`; for a\nstacked bar chart, `tableTotals` adds an opt-in localized total column. Both are no-ops when\nunset.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `axis-label` | Each axis tick label. |\n| `axis-title` | The x/y axis title text, when set. |\n| `bar` | Each bar rect (type=\"bar\"). Carries `data-selected` and `aria-pressed=\"true\"` when its category index is in `selectedIndex`. |\n| `base` | The host's flex layout wrapper. |\n| `data-list` | A visually hidden list of all plotted data points (single-series only). |\n| `data-table` | A visually hidden category×series data table, rendered instead of `data-list` when there is more than one dataset so a screen-reader user hears series grouping rather than one flattened N×M sequence. |\n| `grid-line` | Each horizontal gridline. |\n| `legend` | The legend row, when `legend` is set. |\n| `legend-item` | Each legend entry. |\n| `legend-swatch` | Each legend entry's color swatch. |\n| `legend-text` | Extra per-item text after the series label, rendered only when `legendText` is set. |\n| `line` | Each series' stroked line path (type=\"line\"). |\n| `live-region` | The current mark announcement for keyboard users. |\n| `point` | Each series' per-point keyboard target (type=\"line\"). Carries `data-selected` and explicit `aria-pressed` state. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-lite-chart-selected-outline-color` (default: `var(--lr-color-brand)`) — Stroke for a bar/point whose category index is in `selectedIndex`.",
           "attributes": [
             {
               "name": "accessible-label",
@@ -9730,7 +9710,7 @@
             },
             {
               "name": "height",
-              "description": "Type: `string`  \nDefault: `'280px'`",
+              "description": "A CSS `height`; invalid values leave the default height token in control.\n\nType: `string`  \nDefault: `'280px'`",
               "value": {
                 "type": [
                   "string"
@@ -9999,7 +9979,7 @@
         },
         {
           "name": "lr-map",
-          "description": "`<lr-map>` — a maplibre-gl wrapper with a declarative legend, choropleth\nGeoJSON layer, markers, and additive `dataLayers` GeoJSON overlays\n(arbitrary shapes rendered as a source plus fill/line/circle layers,\nindependent of `choropleth`'s field/stops color-interpolation), plus a raw\n`map` escape hatch. Requires the optional peer dep `maplibre-gl`\nv5 or v6 (consumers also import its CSS). MapLibre v6 is ESM-only, requires WebGL2, and needs\nits module-worker URL configured once; v5's standard build includes its worker.\n\nThe underlying `maplibregl.Map` — and the WebGL context it opens — isn't\nconstructed until this element is first visible in the viewport (tracked\nvia `IntersectionObserver`), even once the `maplibre-gl` peer dependency\nhas finished loading. Browsers hard-cap concurrent WebGL contexts per\npage, so a grid/dashboard of many `<lr-map>` instances only constructs\nthe ones actually on-screen instead of racing to exhaust that budget the\ninstant each one mounts. `map` stays `undefined` (and `lr-map-load`\ndoesn't fire) until construction actually happens.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The map wrapper. |\n| `container` | The maplibre container. |\n| `error` | `role=\"alert\"` message shown instead of `container` if the optional `maplibre-gl` peer dependency fails to load (e.g. not installed). ⚠️ The default `mapStyle` (when unset) uses OpenStreetMap's demo tile server, which is not suitable for production traffic — see the `DEFAULT_STYLE` doc comment above. Always pass an explicit `mapStyle` in production. |\n| `legend` | The map legend. |\n| `legend-swatch` | A legend color swatch. |",
+          "description": "`<lr-map>` — a maplibre-gl wrapper with a declarative legend, choropleth\nGeoJSON layer, markers, and additive `dataLayers` GeoJSON overlays\n(arbitrary shapes rendered as a source plus fill/line/circle layers,\nindependent of `choropleth`'s field/stops color-interpolation), plus a raw\n`map` escape hatch. Requires the optional peer dep `maplibre-gl`\nv5 or v6 (consumers also import its CSS). MapLibre v6 is ESM-only, requires WebGL2, and needs\nits module-worker URL configured once; v5's standard build includes its worker.\n\nThe underlying `maplibregl.Map` — and the WebGL context it opens — isn't\nconstructed until this element is first visible in the viewport (tracked\nvia `IntersectionObserver`), even once the `maplibre-gl` peer dependency\nhas finished loading. Browsers hard-cap concurrent WebGL contexts per\npage, so a grid/dashboard of many `<lr-map>` instances only constructs\nthe ones actually on-screen instead of racing to exhaust that budget the\ninstant each one mounts. `map` stays `undefined` (and `lr-map-load`\ndoesn't fire) until construction actually happens.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The non-semantic map wrapper. |\n| `container` | The MapLibre container. Its generated canvas is the actual focusable map region and receives the host-first accessible name and effective locale. |\n| `error` | `role=\"alert\"` message shown instead of `container` if the optional `maplibre-gl` peer dependency fails to load (e.g. not installed). ⚠️ The default `mapStyle` (when unset) uses OpenStreetMap's demo tile server, which is not suitable for production traffic — see the `DEFAULT_STYLE` doc comment above. Always pass an explicit `mapStyle` in production. |\n| `legend` | The map legend. |\n| `legend-swatch` | A legend color swatch. |",
           "attributes": [
             {
               "name": "center",
@@ -10007,7 +9987,7 @@
             },
             {
               "name": "label",
-              "description": "Accessible name fallback for the map group. A host `aria-label` takes\nprecedence when both are set; when neither is present, the group uses\nthe localized `map` message.\n\nType: `string`  \nDefault: `''`",
+              "description": "Accessible-name fallback for MapLibre's focusable canvas. A host `aria-label` takes\nprecedence when both are set; when neither is present, the canvas uses the localized `map`\nmessage.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -10380,7 +10360,7 @@
             },
             {
               "name": "max-height",
-              "description": "A CSS length (e.g. `\"16rem\"`); once set, overrides the\n`--lr-media-card-max-height` custom property for this instance only —\nsame contract as `<lr-document-preview>`'s identically-named prop.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS length (e.g. `\"16rem\"`); once set, overrides the\n`--lr-media-card-max-height` custom property for this instance only —\nsame contract as `<lr-document-preview>`'s identically-named prop. Invalid values are\nignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -10409,7 +10389,7 @@
         },
         {
           "name": "lr-memory-panel",
-          "description": "`<lr-memory-panel>` — an agent's working memory surface: short-term context and long-term\nmemories, each item's confidence and (optional) grounding provenance, and add/remove/forget\nactions gated behind an explicit confirmation step before anything is reported as decided.\n\nComposes `lr-provenance-panel` for a per-item's provenance breakdown (revealed behind a\ndisclosure toggle, only rendered when `item.provenance` is set) and `lr-confirm-bar` for every\nadd/remove/forget confirmation -- this component never re-implements a new inline-confirmation\npattern of its own. A memory item's confidence reuses `lr-citation-badge`'s own confidence\nvocabulary (`citationHighConfidence`/`citationMediumConfidence`/`citationLowConfidence`), tiered\nagainst `thresholds` the same way `lr-chunk-inspector` tiers a chunk's relevance score.\n\n`shortTerm`/`longTerm` are controlled and never mutated by this component -- approving a pending\naction only fires the matching event; the host applies the resulting state change (adding to\n`longTerm`, removing an item, clearing `longTerm`) and passes new arrays back down. At most one\nconfirmation is ever pending at a time: starting a new action (on the same item or a different\none) silently cancels whichever confirmation was already open, the same way only one row can be\nmid-edit in a list at once.\n\nThree distinct, non-overlapping actions: `add` promotes a short-term item into long-term memory\n(only offered on short-term items -- long-term items are already there); `remove` deletes one\nspecific item from whichever list it's in (offered on every item); `forget` is deliberately\nscoped to the whole long-term list at once (a single \"Forget all\" control in that section's\nheader, only rendered while `longTerm` is non-empty) -- a bulk, more consequential action kept\ndistinct from the per-item `remove`.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `add-button` | The \"Add to long-term memory\" action. Only rendered on short-term items. |\n| `base` | The root wrapper. |\n| `confidence` | The item's confidence tier text, carrying `data-tone`. Omitted when `confidence` is unset. |\n| `empty` | The all-empty `lr-empty` state, shown when both lists are empty. |\n| `expand-toggle` | The provenance disclosure toggle. Omitted when `provenance` is unset. |\n| `forget-all-button` | The long-term section's bulk \"Forget all\" action. Only rendered while `longTerm` is non-empty. |\n| `heading` | A section's visible heading text. |\n| `item` | One memory item row (`role=\"listitem\"`); carries `data-id`/`data-scope` and a stable `tabindex=\"-1\"` so focus has somewhere to land after a pending confirmation on this row resolves. |\n| `item-actions` | The wrapper around an item's action row (or its pending `lr-confirm-bar`). |\n| `item-body` | The disclosed `lr-provenance-panel` wrapper, `hidden` while collapsed. Omitted when `provenance` is unset. |\n| `item-row` | The wrapper around an item's text and confidence indicator. |\n| `item-text` | The item's `text`. |\n| `list` | A section's `role=\"list\"` wrapper, omitted while that section is empty. |\n| `remove-button` | The \"Remove\" action. Rendered on every item. |\n| `section` | One of the two (short-term/long-term) sections; carries `data-scope`. |\n| `section-empty` | A section's \"no items\" text, shown when that section's own list is empty. |\n| `section-header` | A section's heading + (long-term only) \"Forget all\" control row. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-memory-panel-confidence-success-color` (default: `var(--lr-color-success)`) — Text color for a high-confidence item's confidence indicator.\n- `--lr-memory-panel-confidence-warning-color` (default: `var(--lr-color-warning)`) — Text color for a medium-confidence item's confidence indicator.\n- `--lr-memory-panel-confidence-danger-color` (default: `var(--lr-color-danger)`) — Text color for a low-confidence item's confidence indicator.",
+          "description": "`<lr-memory-panel>` — an agent's working memory surface: short-term context and long-term\nmemories, each item's confidence and (optional) grounding provenance, and add/remove/forget\nactions gated behind an explicit confirmation step before anything is reported as decided.\n\nComposes `lr-provenance-panel` for a per-item's provenance breakdown (revealed behind a\ndisclosure toggle, only rendered when `item.provenance` is set) and `lr-confirm-bar` for every\nadd/remove/forget confirmation -- this component never re-implements a new inline-confirmation\npattern of its own. A memory item's confidence reuses `lr-citation-badge`'s own confidence\nvocabulary (`citationHighConfidence`/`citationMediumConfidence`/`citationLowConfidence`), tiered\nagainst `thresholds` the same way `lr-chunk-inspector` tiers a chunk's relevance score.\n\n`shortTerm`/`longTerm` are controlled and never mutated by this component -- approving a pending\naction only fires the matching event; the host applies the resulting state change (adding to\n`longTerm`, removing an item, clearing `longTerm`) and passes new arrays back down. At most one\nconfirmation is ever pending at a time: starting a new action (on the same item or a different\none) silently cancels whichever confirmation was already open, the same way only one row can be\nmid-edit in a list at once.\nIf a controlled collection replacement removes the row containing focus, focus moves to the\nclosest surviving memory row, or to the stable root when no row survives.\n\nFocus follows the confirmation rather than being dropped: activating an action replaces the\nbutton that had focus, so focus moves into the freshly rendered `lr-confirm-bar` (its Deny\ncontrol -- the safe action -- or the bar's own status element) instead of falling back to\n`<body>`. Resolving or cancelling hands focus back: to the row for a per-item decision, to the\n\"Forget all\" control for the bulk one. Escape while the confirmation holds focus cancels it\nexactly like Deny -- no event, same focus return -- and does not propagate, so an enclosing\ndialog or popover still sees its own Escape when no confirmation is open.\n\nThree distinct, non-overlapping actions: `add` promotes a short-term item into long-term memory\n(only offered on short-term items -- long-term items are already there); `remove` deletes one\nspecific item from whichever list it's in (offered on every item); `forget` is deliberately\nscoped to the whole long-term list at once (a single \"Forget all\" control in that section's\nheader, only rendered while `longTerm` is non-empty) -- a bulk, more consequential action kept\ndistinct from the per-item `remove`.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `add-button` | The \"Add to long-term memory\" action. Only rendered on short-term items. |\n| `base` | The root wrapper. |\n| `confidence` | The item's confidence tier text, carrying `data-tone`. Omitted when `confidence` is unset. |\n| `empty` | The all-empty `lr-empty` state, shown when both lists are empty. |\n| `expand-toggle` | The provenance disclosure toggle. Omitted when `provenance` is unset. |\n| `forget-all-button` | The long-term section's bulk \"Forget all\" action. Only rendered while `longTerm` is non-empty. |\n| `forget-all-confirm` | The `<lr-confirm-bar>` shown in place of the \"Forget all\" action while that bulk confirmation is pending. |\n| `heading` | A section's visible heading text. |\n| `item` | One memory item row (`role=\"listitem\"`); carries `data-id`/`data-scope` and a stable `tabindex=\"-1\"` so focus has somewhere to land after a pending confirmation on this row resolves. |\n| `item-actions` | The wrapper around an item's action row (or its pending `lr-confirm-bar`). |\n| `item-body` | The disclosed `lr-provenance-panel` wrapper, `hidden` while collapsed. Omitted when `provenance` is unset. |\n| `item-row` | The wrapper around an item's text and confidence indicator. |\n| `item-text` | The item's `text`. |\n| `list` | A section's `role=\"list\"` wrapper, omitted while that section is empty. |\n| `remove-button` | The \"Remove\" action. Rendered on every item. |\n| `section` | One of the two (short-term/long-term) sections; carries `data-scope`. |\n| `section-empty` | A section's \"no items\" text, shown when that section's own list is empty. |\n| `section-header` | A section's heading + (long-term only) \"Forget all\" control row. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-memory-panel-confidence-success-color` (default: `var(--lr-color-success)`) — Text color for a high-confidence item's confidence indicator.\n- `--lr-memory-panel-confidence-warning-color` (default: `var(--lr-color-warning)`) — Text color for a medium-confidence item's confidence indicator.\n- `--lr-memory-panel-confidence-danger-color` (default: `var(--lr-color-danger)`) — Text color for a low-confidence item's confidence indicator.",
           "attributes": [
             {
               "name": "label",
@@ -10590,7 +10570,7 @@
         },
         {
           "name": "lr-message-actions",
-          "description": "`<lr-message-actions>` — the per-message action toolbar for `<lr-chat-message>`'s `actions`\nslot: opt-in built-ins (copy / regenerate / edit / feedback) that emit intent events, plus a\ndefault slot for custom controls (e.g. a slotted `<lr-branch-picker>`). It performs nothing\nitself except the copy.\n\n`[part=\"base\"]` is `role=\"toolbar\"` with the WAI-ARIA APG roving-tabindex pattern applied to the\nplain `<button>` elements this component renders itself (`regenerate`/`edit`); ArrowLeft/ArrowRight\n(swapped under `effectiveDirection === 'rtl'`) plus Home/End move focus across *every* stop --\nbuilt-ins and slotted controls alike -- via `.focus()`, including composite children\n(`lr-copy-button`, the `feedback` built-in, any slotted custom element) that expose their own\n`focus()` delegation. See the class-level \"Known limitation\" note for why only the plain-button\nstops get their `tabindex` toggled by this component (composite children's internal focusable\nelements live in their own shadow root, unreachable from here).\n\n**Known limitation.** A byte-perfect APG toolbar keeps exactly one Tab stop for the entire\ntoolbar. This component only achieves that for its own plain-button built-ins; a composite child\n(the `feedback` built-in, `lr-copy-button`, any slotted custom element) remains independently\nreachable via the page's native Tab order alongside the toolbar's single roving stop, since this\ncomponent cannot suppress an element living inside another component's shadow root from the\ndocument's Tab order. Arrow-key navigation is unaffected by this and reaches every stop.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Additional controls (e.g. `lr-copy-button`, `lr-icon-button`, `lr-branch-picker`) appended after the built-ins; they participate in the toolbar's arrow-key navigation. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The toolbar (`role=\"toolbar\"`). |\n| `copy-button` | The embedded `lr-copy-button`. |\n| `edit-button` | The built-in edit icon button. |\n| `feedback` | The embedded `lr-message-feedback`. |\n| `regenerate-button` | The built-in regenerate icon button. |",
+          "description": "`<lr-message-actions>` — the per-message action toolbar for `<lr-chat-message>`'s `actions`\nslot: opt-in built-ins (copy / regenerate / edit / feedback) that emit intent events, plus a\ndefault slot for custom controls (e.g. a slotted `<lr-branch-picker>`). It performs nothing\nitself except the copy.\n\n`[part=\"base\"]` is `role=\"toolbar\"` with the WAI-ARIA APG roving-tabindex pattern applied to the\nplain `<button>` elements this component renders itself (`regenerate`/`edit`); ArrowLeft/ArrowRight\n(swapped under `effectiveDirection === 'rtl'`) plus Home/End move focus across *every* stop --\nbuilt-ins and slotted controls alike -- via `.focus()`, including composite children\n(`lr-copy-button`, the `feedback` built-in, any slotted custom element) that expose their own\n`focus()` delegation. Composite children are reconciled after their own Lit updates so the\ntoolbar retains exactly one sequential Tab stop.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Additional controls (e.g. `lr-copy-button`, `lr-icon-button`, `lr-branch-picker`) appended after the built-ins; they participate in the toolbar's arrow-key navigation. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The toolbar (`role=\"toolbar\"`). |\n| `copy-button` | The embedded `lr-copy-button`. |\n| `edit-button` | The built-in edit icon button. |\n| `feedback` | The embedded `lr-message-feedback`. |\n| `regenerate-button` | The built-in regenerate icon button. |",
           "attributes": [
             {
               "name": "aria-label",
@@ -11157,7 +11137,7 @@
         },
         {
           "name": "lr-notebook-viewer",
-          "description": "`<lr-notebook-viewer>` — read-only Jupyter notebook (nbformat 4.x) renderer, composing existing\ncomponents per cell. Execution is a hard non-goal.\n\nMarkdown cells render through `<lr-markdown>`, code cells through `<lr-code-block>` (using the\nnotebook's kernel language for syntax highlighting), and raw cells as plain preformatted text. A\ncode cell's `execute_result`/`display_data` outputs prefer, in order, `image/png`, `image/jpeg`,\n`image/svg+xml` (sanitized), `text/html` (sanitized), `application/json` (via `<lr-json-viewer>`),\nthen `text/plain`. Stream/error outputs (tinted `danger` for stderr/tracebacks) interpret embedded\nANSI SGR color/style escapes via the shared `internal/ansi.ts` parser, same as `<lr-terminal>`.\nSanitizing raw HTML/SVG\noutput markup lazy-loads the optional peer dependency `dompurify` via `dompurify-loader.ts`; when\nthat peer isn't installed, the output renders a localized notice instead of raw markup.\n\nCells are virtualized through `<lr-virtual-list>` so a notebook with many cells stays cheap to\nscroll. `node-path` anchors resolve `path[0]` as a cell index; `fragment` anchors resolve a cell's\nown `id`.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root scroll container. |\n| `cell` | One cell row (`data-cell-type`, `data-active`). |\n| `cell-active` | Added alongside `cell` on the cell currently targeted by an anchor or the active search match. A second part name rather than an attribute selector, because Shadow Parts forbids an attribute selector after `::part()`. |\n| `cell-gutter` | The `In [n]`/`Out [n]` label column. |\n| `cell-source` | A cell's source content. |\n| `error` | The error region. |\n| `error-output-label` | The label introducing an error output's traceback. |\n| `output` | One output (`data-output-type`, `data-stream`). |\n| `output-error` | Added alongside `output` on a stderr stream or an error output. |\n| `output-toggle` | Expands/collapses a long text output. |\n| `outputs` | The wrapper around a code cell's outputs. |\n| `raw-source` | A horizontally scrollable raw-cell source surface. |\n| `spinner` | The loading status region. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-notebook-viewer-max-height` (default: `none`) — Maximum block size of the scrollable body before it scrolls internally. Also settable via the `max-height` property.\n- `--lr-notebook-viewer-active-bg` (default: `var(--lr-color-brand-quiet)`) — Background of the `[part=\"cell\"]` currently targeted by an anchor or the active search match.",
+          "description": "`<lr-notebook-viewer>` — read-only Jupyter notebook (nbformat 4.x) renderer, composing existing\ncomponents per cell. Execution is a hard non-goal.\n\nMarkdown cells render through `<lr-markdown>`, code cells through `<lr-code-block>` (using the\nnotebook's kernel language for syntax highlighting), and raw cells as plain preformatted text. A\ncode cell's `execute_result`/`display_data` outputs prefer, in order, `image/png`, `image/jpeg`,\n`image/svg+xml` (sanitized), `text/html` (sanitized), `application/json` (via `<lr-json-viewer>`),\nthen `text/plain`. Stream/error outputs (tinted `danger` for stderr/tracebacks) interpret embedded\nANSI SGR color/style escapes via the shared `internal/ansi.ts` parser, same as `<lr-terminal>`.\nSanitizing raw HTML/SVG\noutput markup lazy-loads the optional peer dependency `dompurify` via `dompurify-loader.ts`; when\nthat peer isn't installed, the output renders a localized notice instead of raw markup.\n\nCells are virtualized through `<lr-virtual-list>` so a notebook with many cells stays cheap to\nscroll. `node-path` anchors resolve `path[0]` as a cell index; `fragment` anchors resolve a cell's\nown `id`.\n\n`search()`/`searchNext()`/`searchPrevious()`/`clearSearch()` follow the shared viewer search\ncontract (`internal/text-viewer-target.ts`'s `LyraTextViewerTarget`): `search()` resolves the\nmatch count and the two navigation methods resolve `true` once the active match moved, `false`\nwhen there is nothing to move to. A find-in-page host can therefore drive this viewer through the\nsame typed surface as every other one.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root scroll container. |\n| `cell` | One cell row (`data-cell-type`, `data-active`). |\n| `cell-active` | Added alongside `cell` on the cell currently targeted by an anchor or the active search match. A second part name rather than an attribute selector, because Shadow Parts forbids an attribute selector after `::part()`. |\n| `cell-gutter` | The `In [n]`/`Out [n]` label column. |\n| `cell-source` | A cell's source content. |\n| `error` | The error region. |\n| `error-output-label` | The label introducing an error output's traceback. |\n| `output` | One output (`data-output-type`, `data-stream`). |\n| `output-error` | Added alongside `output` on a stderr stream or an error output. |\n| `output-toggle` | Expands/collapses a long text output. |\n| `outputs` | The wrapper around a code cell's outputs. |\n| `raw-source` | A horizontally scrollable raw-cell source surface. |\n| `spinner` | The loading status region. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-notebook-viewer-max-height` (default: `none`) — Maximum block size of the scrollable body before it scrolls internally. Also settable via the `max-height` property.\n- `--lr-notebook-viewer-active-bg` (default: `var(--lr-color-brand-quiet)`) — Background of the `[part=\"cell\"]` currently targeted by an anchor or the active search match.",
           "attributes": [
             {
               "name": "locale",
@@ -11170,7 +11150,7 @@
             },
             {
               "name": "max-height",
-              "description": "A CSS length (e.g. `\"30rem\"`); once set, the notebook scrolls internally past this height\ninstead of growing the page.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -11655,7 +11635,7 @@
           "attributes": [
             {
               "name": "label",
-              "description": "Accessible name; falls back to the localized `pathStripLabel`.\n\nType: `string`  \nDefault: `''`",
+              "description": "Accessible-name fallback when the host has no `aria-label`; otherwise falls back to the\nlocalized `pathStripLabel`.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -11675,7 +11655,7 @@
         },
         {
           "name": "lr-pdf-viewer",
-          "description": "Fetches PDF bytes and renders their pages with the optional `pdfjs-dist` peer. Pages are composed\nthrough `lr-virtual-list`, while a PDF.js text layer keeps rendered text selectable and copyable.\nAdopts `DocumentAnchorTarget`: `page`, `text-quote`, and `region` anchors resolve; highlights paint\nvia one `<lr-highlight-layer>` per page, stacked beneath the text layer (canvas -> highlights ->\ntext layer) so starting a text selection over a cited passage keeps working. Pointer activation of\na highlight is hit-tested at the page-wrapper level (`onPageClick`) since the text layer sitting on\ntop intercepts most direct pointer events; keyboard activation reaches the highlight layer's own\nroving-tabindex rects directly, since z-stacking doesn't affect tab order. Accepted residual: a\nclick that ends a text-selection drag over a highlighted passage never activates it (the\nselection-in-progress check in `onPageClick` exists precisely to distinguish that case from a\ngenuine activation click).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root viewer container. |\n| `error` | The error message region. |\n| `next-button` | The next-page button. |\n| `page` | One rendered page wrapper. |\n| `page-canvas` | The canvas a page's content is painted onto. |\n| `page-indicator` | The current page text. |\n| `pages` | The virtualized page list. |\n| `previous-button` | The previous-page button. |\n| `search-match` | A painted in-document search match. |\n| `search-match-active` | The currently active search match (also carries `search-match`). |\n| `spinner` | The loading status region. |\n| `text-layer` | Selectable text positioned over a page canvas. |\n| `text-span` | One generated text run inside a page's text layer. |\n| `toolbar` | Pagination and zoom controls. |\n| `zoom-in-button` | The zoom-in button. |\n| `zoom-indicator` | The current zoom percentage. |\n| `zoom-out-button` | The zoom-out button. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-pdf-viewer-height` (default: `var(--lr-size-24rem)`) — Block size of the virtualized page list. Also settable via the `max-height` property.",
+          "description": "Fetches PDF bytes and renders their pages with the optional `pdfjs-dist` peer. Pages are composed\nthrough `lr-virtual-list`, while a PDF.js text layer keeps rendered text selectable and copyable.\nAdopts `DocumentAnchorTarget`: `page`, `text-quote`, and `region` anchors resolve; highlights paint\nvia one `<lr-highlight-layer>` per page, stacked beneath the text layer (canvas -> highlights ->\ntext layer) so starting a text selection over a cited passage keeps working. Pointer activation of\na highlight is hit-tested at the page-wrapper level (`onPageClick`) since the text layer sitting on\ntop intercepts most direct pointer events; keyboard activation reaches the highlight layer's own\nroving-tabindex rects directly, since z-stacking doesn't affect tab order. Accepted residual: a\nclick that ends a text-selection drag over a highlighted passage never activates it (the\nselection-in-progress check in `onPageClick` exists precisely to distinguish that case from a\ngenuine activation click).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root viewer container. |\n| `error` | The error message region. |\n| `next-button` | The next-page button. |\n| `page` | One rendered page wrapper. |\n| `page-canvas` | The canvas a page's content is painted onto. |\n| `page-indicator` | The current page text. |\n| `pages` | The virtualized page list. |\n| `previous-button` | The previous-page button. |\n| `search-match` | A painted in-document search match. |\n| `search-match-active` | The currently active search match (also carries `search-match`). |\n| `spinner` | The loading status region. |\n| `text-layer` | Selectable text positioned over a page canvas. |\n| `text-span` | One generated text run inside a page's text layer. |\n| `toolbar` | Pagination and zoom controls. |\n| `zoom-in-button` | The zoom-in button. |\n| `zoom-indicator` | The current zoom percentage. |\n| `zoom-out-button` | The zoom-out button. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-pdf-viewer-height` (default: `var(--lr-size-24rem)`) — Block size of the virtualized page list.\n- `--lr-pdf-viewer-toolbar-button-hover-bg` (default: `var(--lr-color-surface)`) — Hover fill of the toolbar buttons. Defaults to the surface fill rather than the toolbar's own tint so the hover state is actually visible against it. Also settable via the `max-height` property.",
           "attributes": [
             {
               "name": "locale",
@@ -11688,7 +11668,7 @@
             },
             {
               "name": "max-height",
-              "description": "A CSS length (e.g. `\"30rem\"`); once set, overrides `--lr-pdf-viewer-height` -- the block size\nof the virtualized page list -- declaratively, the same `max-height` attribute\n`<lr-notebook-viewer>`/`<lr-svg-viewer>`/`<lr-xml-viewer>` expose, rather than requiring a\nconsumer to set the differently-named CSS custom property inline.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS length (e.g. `\"30rem\"`); once set, overrides `--lr-pdf-viewer-height` -- the block size\nof the virtualized page list -- declaratively, the same `max-height` attribute\n`<lr-notebook-viewer>`/`<lr-svg-viewer>`/`<lr-xml-viewer>` expose, rather than requiring a\nconsumer to set the differently-named CSS custom property inline. Invalid values are\nignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -11938,7 +11918,7 @@
         },
         {
           "name": "lr-pie-chart",
-          "description": "`<lr-pie-chart>` — `<lr-chart>` with `type` locked to `\"pie\"`. Single-series:\none `Series` with `data: number[]` and `color: string[]` as the slice palette.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-pie-chart>` — `<lr-chart>` with `type` locked to `\"pie\"`. Single-series:\none `Series` with `data: number[]` and `color: string[]` as the slice palette.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -12175,7 +12155,7 @@
         },
         {
           "name": "lr-polar-area-chart",
-          "description": "`<lr-polar-area-chart>` — `<lr-chart>` with `type` locked to `\"polarArea\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-polar-area-chart>` — `<lr-chart>` with `type` locked to `\"polarArea\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -12395,7 +12375,7 @@
         },
         {
           "name": "lr-popover",
-          "description": "`<lr-popover>` — a click-triggered, light-dismiss floating surface.\n\nThe slotted trigger receives `aria-haspopup`, `aria-expanded`, and `aria-controls`.\n`aria-controls` targets this public host (which receives a stable generated `id` when the\nconsumer did not supply one), not the shadow-private popup. That keeps the relationship\nresolvable for native triggers and lets `<lr-button>`/`<lr-icon-button>` reflect the host onto\ntheir focused shadow-internal controls through `ariaControlsElements`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Popover content. |\n| `trigger` | The interactive element that toggles the popover. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `content` | The content wrapper. |\n| `popup` | The positioned popup. |\n| `trigger` | The trigger wrapper. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-overlay-max-inline-size` — Maximum inline size of the popup (default `--lr-size-20rem`).",
+          "description": "`<lr-popover>` — a click-triggered, light-dismiss floating surface.\n\nThe slotted trigger receives `aria-haspopup`, `aria-expanded`, and `aria-controls`.\n`aria-controls` targets this public host (which receives a stable generated `id` when the\nconsumer did not supply one), not the shadow-private popup. That keeps the relationship\nresolvable for native triggers and lets `<lr-button>`/`<lr-icon-button>` reflect the host onto\ntheir focused shadow-internal controls through `ariaControlsElements`.\nLive `popupRole` and host-id changes keep those trigger relationships synchronized. Removing the\ntrigger closes a trigger-anchored popover; a deliberate `showAt()` virtual anchor remains open.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Popover content. |\n| `trigger` | The interactive element that toggles the popover. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `content` | The content wrapper. |\n| `popup` | The positioned popup. |\n| `trigger` | The trigger wrapper. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-overlay-max-inline-size` — Maximum inline size of the popup (default `--lr-size-20rem`).",
           "attributes": [
             {
               "name": "aria-label",
@@ -12492,7 +12472,7 @@
         },
         {
           "name": "lr-progress-bar",
-          "description": "`<lr-progress-bar>` — a determinate or indeterminate progress indicator.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `label` | Optional label content. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The progress wrapper. |\n| `indicator` | The filled progress indicator. |\n| `label` | The label row. |\n| `track` | The track. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-progress-height` (default: `var(--lr-size-0-5rem)`) — Block size of the progress track.\n- `--lr-progress-duration` (default: `var(--lr-transition-ambient)`) — Indeterminate sweep timing.",
+          "description": "`<lr-progress-bar>` — a determinate or indeterminate progress indicator.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `label` | Optional label content. While `show-value` makes it visible, its text names the progressbar unless an explicit accessible label overrides it; live text mutations stay synced. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The progress wrapper. |\n| `indicator` | The filled progress indicator. |\n| `label` | The label row. |\n| `track` | The track. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-progress-height` (default: `var(--lr-size-0-5rem)`) — Block size of the progress track.\n- `--lr-progress-duration` (default: `var(--lr-transition-ambient)`) — Indeterminate sweep timing.",
           "attributes": [
             {
               "name": "accessible-label",
@@ -12561,7 +12541,7 @@
         },
         {
           "name": "lr-progress-ring",
-          "description": "`<lr-progress-ring>` — a circular determinate or indeterminate progress indicator.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Optional center label. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The progress wrapper. |\n| `indicator` | The SVG indicator. |\n| `label` | The center label. |\n| `track` | The SVG track. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-progress-ring-size` (default: `var(--lr-size-2-5rem)`) — Outer diameter of the ring.\n- `--lr-progress-duration` (default: `var(--lr-transition-ambient)`) — Indeterminate rotation timing.",
+          "description": "`<lr-progress-ring>` — a circular determinate or indeterminate progress indicator.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Optional center label whose text names the progressbar unless an explicit accessible label overrides it; live text mutations stay synchronized. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The progress wrapper. |\n| `indicator` | The SVG indicator. |\n| `label` | The center label. |\n| `track` | The SVG track. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-progress-ring-size` (default: `var(--lr-size-2-5rem)`) — Outer diameter of the ring.\n- `--lr-progress-duration` (default: `var(--lr-transition-ambient)`) — Indeterminate rotation timing.",
           "attributes": [
             {
               "name": "accessible-label",
@@ -12911,7 +12891,7 @@
         },
         {
           "name": "lr-qr-code",
-          "description": "`<lr-qr-code>` -- encodes `value` as a QR symbol with the optional\n`qrcode` peer dependency (Reed-Solomon error correction and every other\nalgorithmic step of the QR spec is delegated to that library, never\nhand-rolled) and draws the resulting module matrix onto a canvas itself,\none square (optionally rounded) cell per module, with a light quiet-zone\nmargin baked in around the symbol so it stays scannable out of the box\nwith zero consumer configuration. Extra host CSS `padding` around the\nelement adds further breathing room on top of that baked-in margin, but is\nnot required for baseline scannability.\n\nThe canvas -- not the host -- owns `role=\"img\"` and the accessible name,\nsince it is the one meaningful descendant here (mirrors\n`lr-file-icon`'s single-image pattern rather than the composite-group\npattern used by `lr-heatmap`/`lr-word-cloud`). The accessible name\nresolves, in order: `label`, then a host `aria-label` attribute (forwarded\nonto the canvas), then `value` itself. An empty `value` renders\n`[part=\"empty\"]` instead of an `img`-role element -- there is nothing to\nencode or name.\n\n`--lr-qr-code-fill`/`--lr-qr-code-background` (dark/light modules)\ndefault to `--lr-color-text`/`--lr-color-surface`, which -- like every\nsemantic token in this library -- flip under a dark theme. That means the\n*default* rendering under a dark theme is a polarity-inverted QR code\n(light modules on a dark background) rather than the conventional\ndark-on-light. Contrast itself stays strong in both themes (these are the\napp's own high-contrast text/surface pair), so human legibility is\nunaffected -- only third-party barcode *scanner* robustness across\nless-tolerant scanning apps is the residual, consumer-overridable risk. A\nconsumer needing guaranteed cross-scanner compatibility regardless of page\ntheme should pin `--lr-qr-code-fill: #000` / `--lr-qr-code-background:\n#fff` explicitly at the point of use.\n\nDeliberately out of scope for this component, not oversights: logo/image\nembedding; a finder-pattern-corner accent color; auto-shrinking to fit a\nnarrow container (this component's `size` is a direct request for a\nspecific rendered pixel density, like `<img width height>` -- the consumer\npicks a size that fits their layout, this component never second-guesses\nit, though it still renders correctly at its default size inside a narrow\nallocation); form association (`value` is caller-supplied display data the\nuser doesn't edit through this component -- no `FormAssociated` mixin, no\nlabel/hint/error chrome, no `ElementInternals`); and any\nmotion/`prefers-reduced-motion` branch (nothing here animates). Keyboard\nfocus is likewise intentionally absent -- the canvas is a static image\nstanding in for `value`, structurally like `<img>`, not an interactive\ngrid.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer wrapper, sized to `size`×`size` CSS px in every state. |\n| `canvas` | The rendered QR code canvas. |\n| `empty` | Shown when `value` is empty. |\n| `error` | Shown when the peer is missing, or `value` failed to encode. |\n| `loading` | Shown while the optional `qrcode` peer is loading, the first time it's needed. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-qr-code-fill` (default: `var(--lr-color-text)`) — Dark/foreground module color.\n- `--lr-qr-code-background` (default: `var(--lr-color-surface)`) — Light/background module color, including the quiet zone.",
+          "description": "`<lr-qr-code>` -- encodes `value` as a QR symbol with the optional\n`qrcode` peer dependency (Reed-Solomon error correction and every other\nalgorithmic step of the QR spec is delegated to that library, never\nhand-rolled) and draws the resulting module matrix onto a canvas itself,\none square (optionally rounded) cell per module, with a light quiet-zone\nmargin baked in around the symbol so it stays scannable out of the box\nwith zero consumer configuration. Extra host CSS `padding` around the\nelement adds further breathing room on top of that baked-in margin, but is\nnot required for baseline scannability.\n\nThe canvas -- not the host -- owns `role=\"img\"` and the accessible name,\nsince it is the one meaningful descendant here (mirrors\n`lr-file-icon`'s single-image pattern rather than the composite-group\npattern used by `lr-heatmap`/`lr-word-cloud`). The accessible name\nresolves, in order: a host `aria-label` attribute (forwarded onto the canvas),\nthen `label`, then `value` itself. An empty `value` renders\n`[part=\"empty\"]` instead of an `img`-role element -- there is nothing to\nencode or name.\n\n`--lr-qr-code-fill`/`--lr-qr-code-background` (dark/light modules)\ndefault to `--lr-color-text`/`--lr-color-surface`, which -- like every\nsemantic token in this library -- flip under a dark theme. That means the\n*default* rendering under a dark theme is a polarity-inverted QR code\n(light modules on a dark background) rather than the conventional\ndark-on-light. Contrast itself stays strong in both themes (these are the\napp's own high-contrast text/surface pair), so human legibility is\nunaffected -- only third-party barcode *scanner* robustness across\nless-tolerant scanning apps is the residual, consumer-overridable risk. A\nconsumer needing guaranteed cross-scanner compatibility regardless of page\ntheme should pin `--lr-qr-code-fill: #000` / `--lr-qr-code-background:\n#fff` explicitly at the point of use.\n\nDeliberately out of scope for this component, not oversights: logo/image\nembedding; a finder-pattern-corner accent color; auto-shrinking to fit a\nnarrow container (this component's `size` is a direct request for a\nspecific rendered pixel density, like `<img width height>` -- the consumer\npicks a size that fits their layout, this component never second-guesses\nit, though it still renders correctly at its default size inside a narrow\nallocation); form association (`value` is caller-supplied display data the\nuser doesn't edit through this component -- no `FormAssociated` mixin, no\nlabel/hint/error chrome, no `ElementInternals`); and any\nmotion/`prefers-reduced-motion` branch (nothing here animates). Keyboard\nfocus is likewise intentionally absent -- the canvas is a static image\nstanding in for `value`, structurally like `<img>`, not an interactive\ngrid.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer wrapper, sized to `size`×`size` CSS px in every state. |\n| `canvas` | The rendered QR code canvas. |\n| `empty` | Shown when `value` is empty. |\n| `error` | Shown when the peer is missing, or `value` failed to encode. |\n| `loading` | Shown while the optional `qrcode` peer is loading, the first time it's needed. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-qr-code-fill` (default: `var(--lr-color-text)`) — Dark/foreground module color.\n- `--lr-qr-code-background` (default: `var(--lr-color-surface)`) — Light/background module color, including the quiet zone.",
           "attributes": [
             {
               "name": "error-correction",
@@ -12924,7 +12904,7 @@
             },
             {
               "name": "label",
-              "description": "Accessible-name override. Falls back through `aria-label` then `value` -- see the class doc\ncomment for the full precedence order. Caller-supplied data, not routed through `localize()`.\n\nType: `string`  \nDefault: `''`",
+              "description": "Accessible-name fallback when the host has no `aria-label`; otherwise falls back to `value`\n-- see the class doc\ncomment for the full precedence order. Caller-supplied data, not routed through `localize()`.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -12995,7 +12975,7 @@
         },
         {
           "name": "lr-radar-chart",
-          "description": "`<lr-radar-chart>` — `<lr-chart>` with `type` locked to `\"radar\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-radar-chart>` — `<lr-chart>` with `type` locked to `\"radar\"`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -13374,7 +13354,7 @@
         },
         {
           "name": "lr-rag-eval-dashboard",
-          "description": "`<lr-rag-eval-dashboard>` — a controlled RAG quality overview with current metric cards,\nper-metric trends, evaluation slices, and run history. It displays host-computed metrics and\nnever executes datasets, retrieval, judges, or model calls.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The named dashboard region. |\n| `chart` | The active metric trend. |\n| `empty` | The empty state. |\n| `heading` | The visible dashboard heading. |\n| `metric` | One metric control. |\n| `metric-selected` | The controlled active metric. |\n| `metrics` | Metric-card controls. |\n| `run` | One evaluation run. |\n| `runs` | Evaluation run history. |\n| `runs-heading` | Run-history heading. |\n| `slice` | One slice filter. |\n| `slice-selected` | The controlled active slice. |\n| `slices` | Slice filter controls. |",
+          "description": "`<lr-rag-eval-dashboard>` — a controlled RAG quality overview with current metric cards,\nper-metric trends, evaluation slices, and run history. It displays host-computed metrics and\nnever executes datasets, retrieval, judges, or model calls. A controlled `slice` absent from\nthe current runs is preserved and renders an explicit localized unavailable-filter state;\nthe component never silently switches it to All.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The named dashboard region. |\n| `chart` | The active metric trend. |\n| `empty` | The no-runs or unavailable-controlled-slice state. |\n| `heading` | The visible dashboard heading. |\n| `metric` | One metric control. |\n| `metric-selected` | The controlled active metric. |\n| `metrics` | Metric-card controls. |\n| `run` | One evaluation run. |\n| `runs` | Evaluation run history. |\n| `runs-heading` | Run-history heading. |\n| `slice` | One slice filter. |\n| `slice-selected` | The controlled active slice. |\n| `slices` | Slice filter controls. |",
           "attributes": [
             {
               "name": "chart-height",
@@ -13423,7 +13403,7 @@
             },
             {
               "name": "slice",
-              "description": "Type: `string`  \nDefault: `''`",
+              "description": "Controlled evaluation slice. An unavailable value is preserved and renders an explicit\nlocalized state until the host changes it or supplies a matching run.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -13503,7 +13483,7 @@
         },
         {
           "name": "lr-rating",
-          "description": "`<lr-rating>` — a keyboard-accessible star rating control.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The slider-like rating control. |\n| `star` | Each visual star. |\n| `star-fill` | The filled overlay inside each star, clipped to that star's filled fraction (0%, a partial percentage under a fractional `precision`, or 100%). |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-rating-fill` (default: `var(--lr-color-warning)`) — Filled-star color.\n- `--lr-rating-empty-color` (default: `var(--lr-color-border)`) — Unfilled-star color.\n- `--lr-rating-size` (default: `var(--lr-font-size-xl)`) — Star size.",
+          "description": "`<lr-rating>` — a keyboard-accessible star rating control. Pointer position within a star is\nmirrored under RTL and snapped to `precision`, matching keyboard/value fractional selection.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The slider-like rating control. |\n| `star` | Each visual star. |\n| `star-fill` | The filled overlay inside each star, clipped to that star's filled fraction (0%, a partial percentage under a fractional `precision`, or 100%). |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-rating-fill` (default: `var(--lr-color-warning)`) — Filled-star color.\n- `--lr-rating-empty-color` (default: `var(--lr-color-border)`) — Unfilled-star color, retained during hover preview.\n- `--lr-rating-size` (default: `var(--lr-font-size-xl)`) — Star size.",
           "attributes": [
             {
               "name": "aria-label",
@@ -13731,7 +13711,7 @@
             },
             {
               "name": "label",
-              "description": "Accessible name for the list, set as `aria-label` on the internal `role=\"list\"` element. A\nplain `aria-label` attribute on the host itself is honored as a fallback when this is left\nunset, matching `<lr-control-group>`. Native lists don't require an accessible name, so this\nhas no forced fallback string when both are left unset.\n\nType: `string`  \nDefault: `\"\"`",
+              "description": "Accessible-name fallback for the internal `role=\"list\"` element when the host has no\n`aria-label`, matching `<lr-control-group>`. Native lists don't require an accessible name,\nso this has no forced fallback string when both are left unset.\n\nType: `string`  \nDefault: `\"\"`",
               "value": {
                 "type": [
                   "string"
@@ -13965,7 +13945,7 @@
         },
         {
           "name": "lr-retrieval-results",
-          "description": "`<lr-retrieval-results>` — the orchestration-level ranked-chunk-list surface: takes raw\n`RetrievalChunk[]` (the shared retrieval-and-grounding type from `src/ai/types.ts`) and adds\neverything a single retrieval call's result set needs beyond what one chunk's own rendering\nprovides -- deduplication, optional grouping by source, multi-selection, pagination/infinite\nloading, and a compact/expanded presentation switch -- while composing existing primitives for\nevery part that already has one, never re-implementing chunk/score/source rendering itself.\n\n**Composition, not reinvention.** Each rendered row wraps exactly one chunk in an internal\n`<lr-chunk-inspector>` (fed a single-element `chunks` array), reusing its score bar/tier\ncoloring, title+page rendering, expandable text, and `compact` mode verbatim -- this component\nnever hand-rolls chunk-card markup. `metadata` (arbitrary `Record<string, unknown>`, which no\nexisting primitive renders) is the one genuinely new bit of presentation here, shown as a plain\nkey/value list in `expanded` presentation only. Large result sets are windowed through an\ninternal `<lr-virtual-list>`, exactly like `<lr-thread-list>`'s own data-mode rendering -- each\nrow's rendered content therefore lives inside `<lr-virtual-list>`'s own shadow root, not this\ncomponent's, whenever virtualization is active (see that component's own doc for why).\n\n**Controlled component.** `chunks`/`selectedIds`/`loading`/`error`/`hasMore` are all host-owned;\nthis component never fetches, retries, or mutates its own copy of `chunks`. Selecting a row\nupdates `selectedIds` locally *then* emits `lr-select` (the same \"update own copy, then emit;\nreassign to control\" convention `<lr-source-picker>` already uses) so a host can either accept\nthe update as-is or override it before the next render.\n\n**Deduplication** keeps, per duplicate `id`, whichever chunk has the higher `score` -- set\n`dedupe=\"false\"` to see every raw entry `chunks` contains, duplicates included. **Grouping**\n(`grouping=\"source\"`) buckets the deduplicated, score-sorted list by `source.id`, each bucket\nordered by its own best-scoring chunk first, and always renders through the internal\n`<lr-virtual-list>` (regardless of `virtualize-at`) so group headers have a single rendering path\n— `<lr-thread-list>`'s own date-bucket grouping takes the identical approach.\n\n**Pagination.** While virtualized, `has-more`/`loading` are forwarded straight to the internal\n`<lr-virtual-list>`, which fires `lr-load-more` itself on scroll-near-bottom (re-emitted here\nunchanged). Below the virtualization threshold (a short, non-grouped list), scrolling near the\nbottom isn't a meaningful gesture, so a `[part=\"load-more\"]` button takes its place instead,\nshowing a spinner in place of the button while `loading` is true.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container. |\n| `chunk` | The per-row `<lr-chunk-inspector>`'s own `chunk` row. |\n| `chunk-current` | The row `<lr-chunk-inspector>`'s current-chunk state part. |\n| `chunk-open-button` | The row chunk's title/open `<button>`. |\n| `chunk-score` | The row chunk's percent-score line. |\n| `chunk-score-bar` | The row chunk's score bar track. |\n| `chunk-score-current` | The current row chunk's score line. |\n| `chunk-score-fill` | The row chunk's score bar fill. |\n| `chunk-score-fill-danger` | The row chunk's score fill in the low-score tier. |\n| `chunk-score-fill-success` | The row chunk's score fill in the high-score tier. |\n| `chunk-score-fill-warning` | The row chunk's score fill in the medium-score tier. |\n| `chunk-text` | The row chunk's text preview (`presentation=\"expanded\"` only). |\n| `chunk-text-clamped` | The row chunk's text preview while still collapsed. |\n| `chunk-title` | The row chunk's visible title text. |\n| `chunk-toggle` | The row chunk's \"Show more\"/\"Show less\" button. |\n| `empty` | The `<lr-empty>` wrapper, shown when `chunks` is empty and neither `error` nor `loading` is set. |\n| `error` | The error message region (`role=\"alert\"`), shown while `error` is non-empty. |\n| `group-header` | Exported from the internal `<lr-virtual-list>`'s `group` part — grouped/virtualized mode only. |\n| `load-more` | The \"Load more\" button itself (non-virtualized mode, `loading` false). |\n| `load-more-row` | The wrapper around the non-virtualized-mode pagination footer. |\n| `metadata` | The `<dl>` of a chunk's `metadata` entries — omitted entirely when a chunk has no `metadata`, or while `presentation=\"compact\"`. |\n| `metadata-entry` | One metadata key/value pair's wrapper. |\n| `metadata-term` | The `<dt>` carrying a metadata key. Named separately because `::part()` matches one element and cannot be followed into its subtree. |\n| `metadata-value` | The `<dd>` carrying a metadata value. |\n| `row` | One result row's wrapper. Below the virtualization threshold this is a plain, directly-styleable element in this component's own shadow root; while virtualized it is exported from the internal `<lr-virtual-list>`'s own `row` part instead (`::part(row)` still reaches it either way). |\n| `row-body` | The wrapper around a row's `<lr-chunk-inspector>` plus its optional metadata list; carries `data-selected` while that row is selected. |\n| `row-body-selected` | Additional part on a selected `row-body`. State is exposed as a second part name because Shadow Parts forbids an attribute selector after `::part()` — `::part(row-body)[data-selected]` is invalid CSS, and while virtualized `::part()` is the only way in. A state part is a second token in the same `part` attribute, so a `[part~=\"…\"]` (not `[part=\"…\"]`) selector is the one that matches inside a tree. |\n| `select` | The per-row `<lr-checkbox>`, omitted entirely when `selectable` is false. |\n| `spinner` | The initial-load `<lr-spinner>`, shown while `loading` is true and `chunks` is still empty. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-retrieval-results-selected-border` (default: `var(--lr-color-brand)`) — Inline-start border color marking a selected `[part=\"row-body\"]`. A border rather than a fill by design (see the styles file), so recoloring it carries no contrast risk for the row's own text.",
+          "description": "`<lr-retrieval-results>` — the orchestration-level ranked-chunk-list surface: takes raw\n`RetrievalChunk[]` (the shared retrieval-and-grounding type from `src/ai/types.ts`) and adds\neverything a single retrieval call's result set needs beyond what one chunk's own rendering\nprovides -- deduplication, optional grouping by source, multi-selection, pagination/infinite\nloading, and a compact/expanded presentation switch -- while composing existing primitives for\nevery part that already has one, never re-implementing chunk/score/source rendering itself.\n\n**Composition, not reinvention.** Each rendered row wraps exactly one chunk in an internal\n`<lr-chunk-inspector>` (fed a single-element `chunks` array), reusing its score bar/tier\ncoloring, title+page rendering, expandable text, and `compact` mode verbatim -- this component\nnever hand-rolls chunk-card markup. `metadata` (arbitrary `Record<string, unknown>`, which no\nexisting primitive renders) is the one genuinely new bit of presentation here, shown as a plain\nkey/value list in `expanded` presentation only. Large result sets are windowed through an\ninternal `<lr-virtual-list>`, exactly like `<lr-thread-list>`'s own data-mode rendering -- each\nrow's rendered content therefore lives inside `<lr-virtual-list>`'s own shadow root, not this\ncomponent's, whenever virtualization is active (see that component's own doc for why).\n\n**Controlled component.** `chunks`/`selectedIds`/`loading`/`error`/`hasMore` are all host-owned;\nthis component never fetches, retries, or mutates its own copy of `chunks`. Selecting a row\nupdates `selectedIds` locally *then* emits `lr-select` (the same \"update own copy, then emit;\nreassign to control\" convention `<lr-source-picker>` already uses) so a host can either accept\nthe update as-is or override it before the next render.\n\n**Deduplication** keeps, per duplicate `id`, whichever chunk has the higher `score` -- set\n`dedupe=\"false\"` to see every raw entry `chunks` contains, duplicates included. **Grouping**\n(`grouping=\"source\"`) buckets the deduplicated, score-sorted list by `source.id`, each bucket\nordered by its own best-scoring chunk first, and always renders through the internal\n`<lr-virtual-list>` (regardless of `virtualize-at`) so group headers have a single rendering path\n— `<lr-thread-list>`'s own date-bucket grouping takes the identical approach.\n\n**Pagination.** While virtualized, `has-more`/`loading` are forwarded straight to the internal\n`<lr-virtual-list>`, which fires `lr-load-more` itself on scroll-near-bottom (re-emitted here\nunchanged). Below the virtualization threshold (a short, non-grouped list), scrolling near the\nbottom isn't a meaningful gesture, so a `[part=\"load-more\"]` button takes its place instead,\nshowing a spinner in place of the button while `loading` is true.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container and programmatic focus fallback when a controlled collection/state transition removes every focused result action. |\n| `chunk` | The per-row `<lr-chunk-inspector>`'s own `chunk` row. |\n| `chunk-current` | The row `<lr-chunk-inspector>`'s current-chunk state part. |\n| `chunk-open-button` | The row chunk's title/open `<button>`. |\n| `chunk-score` | The row chunk's percent-score line. |\n| `chunk-score-bar` | The row chunk's score bar track. |\n| `chunk-score-current` | The current row chunk's score line. |\n| `chunk-score-fill` | The row chunk's score bar fill. |\n| `chunk-score-fill-danger` | The row chunk's score fill in the low-score tier. |\n| `chunk-score-fill-success` | The row chunk's score fill in the high-score tier. |\n| `chunk-score-fill-warning` | The row chunk's score fill in the medium-score tier. |\n| `chunk-text` | The row chunk's text preview (`presentation=\"expanded\"` only). |\n| `chunk-text-clamped` | The row chunk's text preview while still collapsed. |\n| `chunk-title` | The row chunk's visible title text. |\n| `chunk-toggle` | The row chunk's \"Show more\"/\"Show less\" button. |\n| `empty` | The `<lr-empty>` wrapper, shown when `chunks` is empty and neither `error` nor `loading` is set. |\n| `error` | The error message region (`role=\"alert\"`), shown while `error` is non-empty. |\n| `group-header` | Exported from the internal `<lr-virtual-list>`'s `group` part — grouped/virtualized mode only. |\n| `load-more` | The \"Load more\" button itself (non-virtualized mode, `loading` false). |\n| `load-more-row` | The wrapper around the non-virtualized-mode pagination footer. |\n| `metadata` | The `<dl>` of a chunk's `metadata` entries — omitted entirely when a chunk has no `metadata`, or while `presentation=\"compact\"`. |\n| `metadata-entry` | One metadata key/value pair's wrapper. |\n| `metadata-term` | The `<dt>` carrying a metadata key. Named separately because `::part()` matches one element and cannot be followed into its subtree. |\n| `metadata-value` | The `<dd>` carrying a metadata value. |\n| `row` | One result row's wrapper. Below the virtualization threshold this is a plain, directly-styleable element in this component's own shadow root; while virtualized it is exported from the internal `<lr-virtual-list>`'s own `row` part instead (`::part(row)` still reaches it either way). |\n| `row-body` | The wrapper around a row's `<lr-chunk-inspector>` plus its optional metadata list; carries `data-selected` while that row is selected. |\n| `row-body-selected` | Additional part on a selected `row-body`. State is exposed as a second part name because Shadow Parts forbids an attribute selector after `::part()` — `::part(row-body)[data-selected]` is invalid CSS, and while virtualized `::part()` is the only way in. A state part is a second token in the same `part` attribute, so a `[part~=\"…\"]` (not `[part=\"…\"]`) selector is the one that matches inside a tree. |\n| `select` | The per-row `<lr-checkbox>`, omitted entirely when `selectable` is false. |\n| `spinner` | The initial-load `<lr-spinner>`, shown while `loading` is true and `chunks` is still empty. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-retrieval-results-selected-border` (default: `var(--lr-color-brand)`) — Inline-start border color marking a selected `[part=\"row-body\"]`. A border rather than a fill by design (see the styles file), so recoloring it carries no contrast risk for the row's own text.",
           "attributes": [
             {
               "name": "active-id",
@@ -14244,7 +14224,7 @@
         },
         {
           "name": "lr-scatter-chart",
-          "description": "`<lr-scatter-chart>` — `<lr-chart>` with `type` locked to `\"scatter\"`. Feed\npoints via `Series.points`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
+          "description": "`<lr-scatter-chart>` — `<lr-chart>` with `type` locked to `\"scatter\"`. Feed\npoints via `Series.points`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `center` | Optional overlay content positioned at the chart area's center. Useful for doughnut and pie totals. |\n| `data-table` | An optional consumer-provided accessible table alternative. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The chart wrapper. |\n| `canvas` | The Chart.js canvas. |\n| `center` | The chart-area-centered overlay wrapper for the `center` slot. |\n| `data-table` | The optional generated or slotted data table. |\n| `description` | The accessible chart summary. |\n| `error` | `role=\"alert\"` message shown instead of `canvas` when the optional `chart.js` peer dependency is not installed. |\n| `legend` | The wrapping DOM legend rendered when `legend` is set. |\n| `legend-item` | A keyboard-operable series visibility toggle. |\n| `legend-swatch` | The resolved series-color swatch in a legend item. |\n| `plot` | The fixed-height canvas/overlay region. |\n| `reset-zoom-button` | The reset-zoom control when zoom is active. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-chart-height` (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`.\n- `--lr-chart-grid-color` (default: `var(--lr-color-border)`) — Grid-line color. Resolved via `getComputedStyle` on every draw (Chart.js paints to canvas and cannot consume `var()`).\n- `--lr-chart-tick-color` (default: `var(--lr-color-text-quiet)`) — Axis tick-label color; also used for the `xLabel`/`yLabel`/`y2Label` axis-title text (there is no separate title-color token). Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-legend-color` (default: `var(--lr-color-text)`) — Legend label color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-bg` (default: `var(--lr-color-surface)`) — Tooltip background color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-tooltip-text` (default: `var(--lr-color-text)`) — Tooltip text color. Resolved via `getComputedStyle` on every draw.\n- `--lr-chart-canvas-hover-outline-width` (default: `var(--lr-border-width-thin)`) — Width of the `[part='canvas']` hover-state outline (its color is `--lr-chart-grid-color`, above).",
           "attributes": [
             {
               "name": "accessible-description",
@@ -14412,7 +14392,7 @@
         },
         {
           "name": "lr-schema-viewer",
-          "description": "`<lr-schema-viewer>` — a recursive, selectable JSON Schema inspector with required-state,\nconstraints, composition branches, `$ref` display, validation issues, cycle protection, and a\nconfigurable depth ceiling. It does not resolve remote references or validate values.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The named schema region. |\n| `constraints` | Recognized schema constraints. |\n| `description` | Caller-supplied schema description. |\n| `empty` | The empty state. |\n| `issue` | One caller-supplied validation issue. |\n| `limit` | Resource-ceiling status shown when additional nodes are omitted. |\n| `name` | Property/branch name. |\n| `node` | One schema node. |\n| `node-selected` | The selected schema node. |\n| `node-trigger` | A schema-node activation button. |\n| `required` | Required badge. |\n| `tree` | The recursive schema tree. |\n| `type` | Schema type badge. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-schema-viewer-selected-border` (default: `var(--lr-color-brand)`) — Selected node branch.\n- `--lr-schema-viewer-error-border` (default: `var(--lr-color-danger)`) — Error issue border.\n- `--lr-schema-viewer-error-bg` (default: `var(--lr-color-danger-quiet)`) — Error issue background.\n- `--lr-schema-viewer-warning-border` (default: `var(--lr-color-warning)`) — Warning issue border.\n- `--lr-schema-viewer-warning-bg` (default: `var(--lr-color-warning-quiet)`) — Warning issue background.\n- `--lr-schema-viewer-info-border` (default: `var(--lr-color-brand)`) — Info issue border.\n- `--lr-schema-viewer-info-bg` (default: `var(--lr-color-brand-quiet)`) — Info issue background.",
+          "description": "`<lr-schema-viewer>` — a recursive, selectable JSON Schema inspector with required-state,\nconstraints, composition branches, `$ref` display, validation issues, cycle protection, and a\nconfigurable depth ceiling. It does not resolve remote references or validate values.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The named schema region. |\n| `constraints` | Recognized schema constraints. |\n| `description` | Caller-supplied schema description. |\n| `empty` | The empty state. |\n| `issue` | One caller-supplied validation issue. |\n| `issue-limit` | Resource-ceiling status shown when additional validation issues are omitted. |\n| `limit` | Resource-ceiling status shown when additional nodes are omitted. |\n| `name` | Property/branch name. |\n| `node` | One schema node. |\n| `node-selected` | The selected schema node. |\n| `node-trigger` | A schema-node activation button. |\n| `required` | Required badge. |\n| `tree` | The recursive schema tree. |\n| `type` | Schema type badge. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-schema-viewer-selected-border` (default: `var(--lr-color-brand)`) — Selected node branch.\n- `--lr-schema-viewer-error-border` (default: `var(--lr-color-danger)`) — Error issue border.\n- `--lr-schema-viewer-error-bg` (default: `var(--lr-color-danger-quiet)`) — Error issue background.\n- `--lr-schema-viewer-warning-border` (default: `var(--lr-color-warning)`) — Warning issue border.\n- `--lr-schema-viewer-warning-bg` (default: `var(--lr-color-warning-quiet)`) — Warning issue background.\n- `--lr-schema-viewer-info-border` (default: `var(--lr-color-brand)`) — Info issue border.\n- `--lr-schema-viewer-info-bg` (default: `var(--lr-color-brand-quiet)`) — Info issue background.",
           "attributes": [
             {
               "name": "label",
@@ -14518,7 +14498,7 @@
           "attributes": [
             {
               "name": "label",
-              "description": "Accessible name for the radiogroup, used when no visible label context\nexists around it (e.g. no wrapping `<label>` or adjacent heading). Set\nas `aria-label` on the `role=\"radiogroup\"` element. A plain `aria-label`\nattribute on the host itself is honored as a fallback when this is left\nunset, matching `<lr-slider>`.\n\nType: `string`  \nDefault: `\"\"`",
+              "description": "Accessible-name fallback for the radiogroup when the host has no `aria-label`, used when no\nvisible label context exists around it (e.g. no wrapping `<label>` or adjacent heading).\nThe resolved name is set on the `role=\"radiogroup\"` element.\n\nType: `string`  \nDefault: `\"\"`",
               "value": {
                 "type": [
                   "string"
@@ -14813,18 +14793,9 @@
           "name": "lr-slider",
           "description": "`<lr-slider>` — a numeric range control (e.g. an LLM \"temperature\"\nsetting), form-associated. Mirrors native `<input type=\"range\">`\nsemantics: `value` is the string form-submitted via `FormAssociated`,\n`valueAsNumber` is the ergonomic numeric accessor (mirroring the native\n`<input type=range>` IDL attribute of the same name) kept in sync with it\nin both directions — reads parse `value`, writes stringify back to it.\n\nUnlike the mixin's other consumers, an unset `value` is eagerly defaulted\n— on connect, and again after `form.reset()` — to the midpoint of\n`[min, max]` snapped to `step`, the same \"range sanitization algorithm\"\ndefault a native range input applies. A slider always represents *some*\nnumber, so `required` (inherited from `FormAssociated`) only has a window\nto block submission before that default lands, matching how `required`\nisn't a meaningful constraint on a native range input either.\n\nClicking anywhere on the track (not just the 16px thumb) jumps the thumb\nto that point and continues the same gesture as a drag, matching native\n`<input type=range>` click-to-seek.\n\nDeliberately no label/hint/error chrome -- `label` here is an accessible-name override, not\nvisible label text; a labeled-field consumer wraps this element in their own layout.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The row wrapping the track and the optional value readout. |\n| `fill` | The filled portion of the track from `min` up to the current value. |\n| `thumb` | The draggable handle (`role=\"slider\"`). |\n| `track` | The full-width background line. |\n| `value` | The visible numeric readout, rendered when `show-value` is true. |",
           "attributes": [
-            {
-              "name": "disabled",
-              "description": "Type: `boolean`",
-              "value": {
-                "type": [
-                  "boolean"
-                ]
-              }
-            },
             {
               "name": "label",
-              "description": "Accessible name for the slider, used when no visible label context\nexists around it (e.g. no wrapping `<label>` or adjacent heading). Set\nas `aria-label` on the interactive `role=\"slider\"` element. A plain\n`aria-label` attribute on the host itself is honored as a fallback when\nthis is left unset, matching `<lr-checkbox>`/`<lr-switch>`; with\nneither, the localized generic `sliderLabel` message applies so the\nfocusable thumb is never nameless (the same pattern as\n`<lr-input>`/`<lr-textarea>`'s built-in generic labels).\n\nType: `string`  \nDefault: `''`",
+              "description": "Accessible-name fallback for the slider when the host has no `aria-label`, used when no\nvisible label context exists around it (e.g. no wrapping `<label>` or adjacent heading).\nThe resolved name is set on the interactive `role=\"slider\"` element. With neither a host\n`aria-label` nor this property, the localized generic `sliderLabel` message applies so the\nfocusable thumb is never nameless (the same pattern as `<lr-input>`/`<lr-textarea>`'s\nbuilt-in generic labels).\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -14957,7 +14928,7 @@
         },
         {
           "name": "lr-source-list",
-          "description": "`<lr-source-list>` — a collapsible \"Sources\" panel for one chat message,\ngrouping a set of `<lr-source-card>` children (its default-slot light-DOM\nchildren, plain composition — no `.items` array prop, the same shape\n`<lr-split>`'s panels take) behind a single clickable header.\n\nThis library has no built-in pluralization (see `<lr-empty>`'s plain\n`description` prop for a similar stance), so anything beyond the final\nfallback is entirely consumer-supplied: `label-plural` (e.g. `\"3 sources\"`)\nwins when set, falling back to `label`, falling back to a localized\n`\"Sources\"` (via `this.localize()`) — see each property's own doc.\n`sourceCount` (a read-only, live-updated count of the currently-slotted\nchildren) is exposed for a consumer who wants to build that string\nreactively instead of hand-counting DOM children.\n\nThe card list is removed from the accessibility tree (not just visually\nhidden) while collapsed, via the native `hidden` attribute on\n`[part=\"list\"]` — a screen reader user tabbing past the header never lands\non off-screen source cards they can't currently see.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | `<lr-source-card>` elements (or any content, though the card pairing is the intended usage). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container. |\n| `header` | The clickable header (`<button>`) toggling `expanded`. |\n| `list` | The wrapper around the default slot, `hidden` while collapsed. |\n| `toggle` | The chevron indicator inside the header. |",
+          "description": "`<lr-source-list>` — a collapsible \"Sources\" panel for one chat message,\ngrouping a set of `<lr-source-card>` children (its default-slot light-DOM\nchildren, plain composition — no `.items` array prop, the same shape\n`<lr-split>`'s panels take) behind a single clickable header.\n\nThis library has no built-in pluralization (see `<lr-empty>`'s plain\n`description` prop for a similar stance), so anything beyond the final\nfallback is entirely consumer-supplied: `label-plural` (e.g. `\"3 sources\"`)\nwins when set, falling back to `label`, falling back to a localized\n`\"Sources\"` (via `this.localize()`) — see each property's own doc.\n`sourceCount` (a read-only, live-updated count of the currently-slotted\nchildren) is exposed for a consumer who wants to build that string\nreactively instead of hand-counting DOM children.\n\nThe card list is removed from the accessibility tree (not just visually\nhidden) while collapsed, via the native `hidden` attribute on\n`[part=\"list\"]` — a screen reader user tabbing past the header never lands\non off-screen source cards they can't currently see.\nWhile connected, assigned children temporarily receive `role=\"listitem\"`.\nLive author role changes are retained and restored when a child is removed or the list detaches;\nreconnecting reapplies list ownership.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | `<lr-source-card>` elements (or any content, though the card pairing is the intended usage). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container. |\n| `header` | The clickable header (`<button>`) toggling `expanded`. |\n| `list` | The wrapper around the default slot, `hidden` while collapsed. |\n| `toggle` | The chevron indicator inside the header. |",
           "attributes": [
             {
               "name": "expanded",
@@ -14999,7 +14970,7 @@
         },
         {
           "name": "lr-source-picker",
-          "description": "`<lr-source-picker>` — a checkbox tree/list scoping which sources ground the next answer:\ntri-state folders, select-all, type icons, search. **Not `FormAssociated`, deliberately**: this\nis a scoping panel, not a form control — the selection is immediate app state consumed by the\nnext retrieval call, exactly the stance `lr-tool-select-dialog` already takes.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. |\n| `checkbox` | The tri-state checkbox glyph. |\n| `disclosure` | A folder row's expand/collapse button. |\n| `empty` | The empty state (`noData` when `sources` is empty, `noMatches` when a filter empties the tree). |\n| `icon` | The `lr-file-icon` type badge. |\n| `item` | One `role=\"treeitem\"` row. |\n| `label` | The entry's label text. |\n| `search` | The built-in filter `lr-input`, only rendered when `searchable`. |\n| `select-all` | The header select-all row, only rendered when `showSelectAll`. |\n| `summary` | The \"{selected} of {total} selected\" text. |\n| `tree` | The `role=\"tree\"` container. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-source-picker-checked-bg` — Background of a fully-checked selection control: the `select-all` pill (defaults to `var(--lr-color-brand-quiet)`) and a fully-selected entry's `[part=\"checkbox\"]` (defaults to `var(--lr-color-brand)`). The two keep their distinct resting defaults; setting this prop unifies both.\n- `--lr-source-picker-checked-border` (default: `var(--lr-color-brand)`) — Border color of every checked or mixed selection control.\n- `--lr-source-picker-mixed-bg` (default: `color-mix(in srgb, var(--lr-color-brand) 50%, var(--lr-color-surface))`) — Background of a partially-selected entry's `[part=\"checkbox\"]`.",
+          "description": "`<lr-source-picker>` — a checkbox tree/list scoping which sources ground the next answer:\ntri-state folders, select-all, type icons, search. **Not `FormAssociated`, deliberately**: this\nis a scoping panel, not a form control — the selection is immediate app state consumed by the\nnext retrieval call, exactly the stance `lr-tool-select-dialog` already takes.\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper. |\n| `checkbox` | The tri-state checkbox glyph. |\n| `disclosure` | A folder row's pointer-only expand/collapse indicator. Keyboard expansion remains owned by the surrounding treeitem. |\n| `empty` | The empty state (`noData` when `sources` is empty, `noMatches` when a filter empties the tree). |\n| `icon` | The `lr-file-icon` type badge. |\n| `item` | One `role=\"treeitem\"` row. |\n| `label` | The entry's label text. |\n| `search` | The built-in filter `lr-input`, only rendered when `searchable`. |\n| `select-all` | The header select-all row, only rendered when `showSelectAll`. |\n| `summary` | The \"{selected} of {total} selected\" text. |\n| `tree` | The `role=\"tree\"` container. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-source-picker-checked-bg` — Background of a fully-checked selection control: the `select-all` pill (defaults to `var(--lr-color-brand-quiet)`) and a fully-selected entry's `[part=\"checkbox\"]` (defaults to `var(--lr-color-brand)`). The two keep their distinct resting defaults; setting this prop unifies both.\n- `--lr-source-picker-checked-border` (default: `var(--lr-color-brand)`) — Border color of every checked or mixed selection control.\n- `--lr-source-picker-mixed-bg` (default: `color-mix(in srgb, var(--lr-color-brand) 50%, var(--lr-color-surface))`) — Background of a partially-selected entry's `[part=\"checkbox\"]`.",
           "attributes": [
             {
               "name": "aria-label",
@@ -15045,7 +15016,7 @@
         },
         {
           "name": "lr-span-waterfall",
-          "description": "`<lr-span-waterfall>` — the horizontal-timeline projection of the same\n`LyraSpan[]` `<lr-trace-tree>` consumes: a time axis, one row per span\nin start order, status-toned bars (Langfuse timeline / Temporal\nevent-history style).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `axis` | The time-ruler row, hidden when `hideAxis`. |\n| `bar` | The interactive, focusable status-toned bar (`role` via `<button>`). |\n| `bar-track` | The bar's positioning track. |\n| `base` | The root wrapper. |\n| `duration` | The formatted duration text. |\n| `empty` | The empty-state message shown when `spans` is empty. |\n| `live-region` | The internal focus/status-announcement live region. |\n| `meta` | Secondary row info (status/duration), shown inline under 480px. |\n| `name` | The span's name (the row's name gutter). |\n| `row` | One span's row. |\n| `status-text` | The visible status label. |\n| `tick` | One axis tick mark. |\n| `tick-label` | An axis tick's formatted duration label. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-span-waterfall-name-width` (default: `8rem`) — Width of the name gutter column.\n- `--lr-span-waterfall-stripe-speed` — Animation duration for a `running` span's striped bar; defaults to `--lr-transition-ambient`.\n- `--lr-span-waterfall-row-active-bg` (default: `var(--lr-color-brand-quiet)`) — Background of the active (`activeSpanId`) row. Shadow Parts forbids an attribute selector after `::part()`, so the active row could otherwise only be restyled by hijacking the library-wide `--lr-color-brand-quiet` token.",
+          "description": "`<lr-span-waterfall>` — the horizontal-timeline projection of the same\n`LyraSpan[]` `<lr-trace-tree>` consumes: a time axis, one row per span\nin start order, status-toned bars (Langfuse timeline / Temporal\nevent-history style).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `axis` | The time-ruler row, hidden when `hideAxis`. |\n| `bar` | The interactive, focusable status-toned bar (`role` via `<button>`). |\n| `bar-track` | The bar's positioning track. |\n| `base` | The root wrapper. |\n| `duration` | The formatted duration text. |\n| `empty` | The empty-state message shown when `spans` is empty. |\n| `live-region` | The internal focus/status-announcement live region. |\n| `meta` | Secondary row info (status/duration), shown inline under 480px. |\n| `name` | The span's name (the row's name gutter). |\n| `row` | One span's row. |\n| `status-text` | The visible status label. |\n| `tick` | One axis tick mark. |\n| `tick-label` | An axis tick's formatted duration label. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-span-waterfall-name-width` (default: `8rem`) — Width of the name gutter column.\n- `--lr-span-waterfall-stripe-speed` — Animation duration for a `running` span's striped bar; defaults to `--lr-transition-ambient`.\n- `--lr-span-waterfall-row-active-bg` (default: `var(--lr-color-brand-quiet)`) — Background of the active (`activeSpanId`) row. Shadow Parts forbids an attribute selector after `::part()`, so the active row could otherwise only be restyled by hijacking the library-wide `--lr-color-brand-quiet` token.\n- `--lr-span-waterfall-success-color` (default: `var(--lr-color-success)`) — Success bar fill.\n- `--lr-span-waterfall-error-color` (default: `var(--lr-color-danger)`) — Error bar fill.\n- `--lr-span-waterfall-denied-color` (default: `var(--lr-color-warning)`) — Denied bar fill.\n- `--lr-span-waterfall-running-color` (default: `var(--lr-color-brand)`) — Running stripe foreground.\n- `--lr-span-waterfall-running-stripe-color` (default: `var(--lr-color-brand-quiet)`) — Running stripe background.\n- `--lr-span-waterfall-pending-border-color` (default: `var(--lr-color-border-strong)`) — Pending bar border.",
           "attributes": [
             {
               "name": "active-span-id",
@@ -15125,11 +15096,11 @@
         },
         {
           "name": "lr-spinner",
-          "description": "`<lr-spinner>` — an indeterminate busy indicator.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Optional visible label. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The wrapper. |\n| `label` | The accessible/visible label wrapper. |\n| `spinner` | The animated indicator. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-spinner-size` (default: `var(--lr-size-1-25rem)`) — Outer diameter of the indicator.\n- `--lr-spinner-track-width` (default: `var(--lr-border-width-medium)`) — Thickness of the ring track.\n- `--lr-spinner-duration` (default: `var(--lr-transition-ambient)`) — Duration/easing of one rotation. Not read under `prefers-reduced-motion: reduce`, where the animation is disabled entirely.",
+          "description": "`<lr-spinner>` — an indeterminate busy indicator.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Optional label. `label-placement=\"after\"` renders it and uses its text as the status name; `none` hides it from both rendering and the accessibility tree. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The wrapper. |\n| `label` | The accessible/visible label wrapper. |\n| `spinner` | The animated indicator. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-spinner-size` (default: `var(--lr-size-1-25rem)`) — Outer diameter of the indicator.\n- `--lr-spinner-track-width` (default: `var(--lr-border-width-medium)`) — Thickness of the ring track.\n- `--lr-spinner-duration` (default: `var(--lr-transition-ambient)`) — Duration/easing of one rotation. Not read under `prefers-reduced-motion: reduce`, where the animation is disabled entirely.",
           "attributes": [
             {
               "name": "aria-label",
-              "description": "Accessible name for the busy status, forwarded from a host `aria-label`. When unset, the\nlocalized \"Loading…\" default provides the name.\n\nType: `string | null`  \nDefault: `null`"
+              "description": "Accessible name for the busy status, forwarded from a host `aria-label`. When unset, a\nvisible `label-placement=\"after\"` label names it, then the localized \"Loading…\" fallback.\n\nType: `string | null`  \nDefault: `null`"
             },
             {
               "name": "label-placement",
@@ -15153,7 +15124,7 @@
         },
         {
           "name": "lr-split",
-          "description": "`<lr-split>` — resizable panels for dashboard layouts. Direct light-DOM\nchildren are the panels; a divider is auto-inserted between each pair.\n\nOptionally, one pane can opt in to responsive collapse via `collapse`\n(`\"start\"`/`\"end\"`, default `\"none\"` — no behavior change when unset): as\nthe split's own container narrows past `railBreakpoint` that pane clamps\nto a fixed `railWidth`, and past the narrower `floatBreakpoint` it instead\nbecomes an absolutely-positioned overlay \"floating card\" above the other\npane. Both breakpoints accept a bare pixel number or a CSS length\n(`px`/`rem`/`em`), and `collapseBreakpointBasis=\"viewport\"` measures them\nagainst the viewport via `matchMedia` instead of this component's own\nallocation. This component only handles the width-collapse mechanics and\nsignals the current state — via the `collapseState`-derived\n`data-collapse-state` attribute (set on both the host and the collapsing\npanel itself) and the `lr-split-collapse-change` event — it renders no\nicon-only/collapsed UI of its own; slotted content is expected to adapt to\nits own clamped width (e.g. via its own container query).\n\n`collapseState` is a public accessor with force/auto semantics mirroring\n`<lr-app-rail>`'s `mode`: it's normally derived automatically from the\nmeasured container width (via a `ResizeObserver` on `[part=\"base\"]`)\nwhenever it crosses `railBreakpoint`/`floatBreakpoint`, but assigning it a\nconcrete `'wide'`/`'rail'`/`'floating'` value pins it there and stops that\nautomatic tracking — useful for a consumer-driven toggle (e.g. a button\nthat forces `'floating'` regardless of width). Assigning the write-only\n`'auto'` sentinel releases the pin and immediately re-derives the state\nfrom the current measured width, resuming automatic tracking. `'auto'` is\nnever a value this getter returns.\n\nThe `'floating'` state is a hidden-by-default drawer, gated by `open`\n(mirrors `<lr-app-rail>`'s mobile overlay): while `collapseState` is\n`'floating'` and `open` is `false` (the default), the collapsing panel\nrenders nothing — `hidden`, out of the accessibility tree, not just\nvisually hidden — instead of the always-visible overlay card this state\nrendered before `open` existed. Setting `open = true` reveals it as a\nfocus-trapped floating panel with a `[part=\"backdrop\"]` scrim; Escape or a\nbackdrop click set `open` back to `false`. `open` is preserved (not reset)\nwhile `collapseState` isn't `'floating'`, but no drawer chrome renders\nuntil it is again — except that leaving `'floating'` while `open` is\n`true` (a breakpoint crossing back to `'wide'`/`'rail'`, or a forced\nreassignment) also closes it, the same way `<lr-app-rail>` closes its\nmobile overlay when leaving `'mobile'` while open.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Panels to arrange side by side (or stacked, when `orientation=\"vertical\"`); each direct child becomes one resizable panel. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `backdrop` | The `'floating'` drawer's scrim. Only rendered while `collapseState === 'floating'` and `open`. |\n| `base` | The flex layout wrapper (`position: relative`, so the `'floating'` collapse state can anchor to it). |\n| `divider` | Each divider between two panels; carries `aria-disabled=\"true\"` and is drag/keyboard-inert while its adjacent panel is collapsed (`'rail'`/`'floating'`). |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-split-overlay-color` (default: `var(--lr-color-overlay)`) — The `'floating'` drawer scrim's color, applied to `[part=\"backdrop\"]`.\n- `--lr-split-divider-hit-slop` (default: `calc((var(--lr-size-3px) - var(--lr-icon-button-size)) / 2)`) — Per-side inset of `[part=\"divider\"]`'s invisible `::before` hit area, along the resize axis. Negative, so the `::before` box extends past the divider's own edges; derived from the shared `--lr-icon-button-size` WCAG 2.5.8 floor minus the divider's visible thickness, split evenly across both sides, so the effective target reaches the floor without widening the 3px divider anyone can see. Declared on `:host`, so an override must target the element itself (not an ancestor). Setting it by hand is rarely right -- retheme `--lr-size-3px`/`--lr-icon-button-size` instead and the slop recomputes.",
+          "description": "`<lr-split>` — resizable panels for dashboard layouts. Direct light-DOM\nchildren are the panels; a divider is auto-inserted between each pair.\n\nOptionally, one pane can opt in to responsive collapse via `collapse`\n(`\"start\"`/`\"end\"`, default `\"none\"` — no behavior change when unset): as\nthe split's own container narrows past `railBreakpoint` that pane clamps\nto a fixed `railWidth`, and past the narrower `floatBreakpoint` it instead\nbecomes an absolutely-positioned overlay \"floating card\" above the other\npane. Both breakpoints accept a bare pixel number or a CSS length\n(`px`/`rem`/`em`), and `collapseBreakpointBasis=\"viewport\"` measures them\nagainst the viewport via `matchMedia` instead of this component's own\nallocation. This component only handles the width-collapse mechanics and\nsignals the current state — via the `collapseState`-derived\n`data-collapse-state` attribute (set on both the host and the collapsing\npanel itself) and the `lr-split-collapse-change` event — it renders no\nicon-only/collapsed UI of its own; slotted content is expected to adapt to\nits own clamped width (e.g. via its own container query).\n\n`collapseState` is a public accessor with force/auto semantics mirroring\n`<lr-app-rail>`'s `mode`: it's normally derived automatically from the\nmeasured container width (via a `ResizeObserver` on `[part=\"base\"]`)\nwhenever it crosses `railBreakpoint`/`floatBreakpoint`, but assigning it a\nconcrete `'wide'`/`'rail'`/`'floating'` value pins it there and stops that\nautomatic tracking — useful for a consumer-driven toggle (e.g. a button\nthat forces `'floating'` regardless of width). Assigning the write-only\n`'auto'` sentinel releases the pin and immediately re-derives the state\nfrom the current measured width, resuming automatic tracking. `'auto'` is\nnever a value this getter returns.\n\nThe `'floating'` state is a hidden-by-default drawer, gated by `open`\n(mirrors `<lr-app-rail>`'s mobile overlay): while `collapseState` is\n`'floating'` and `open` is `false` (the default), the collapsing panel\nrenders nothing — `hidden`, out of the accessibility tree, not just\nvisually hidden — instead of the always-visible overlay card this state\nrendered before `open` existed. Setting `open = true` reveals it as a\nfocus-trapped floating panel with a `[part=\"backdrop\"]` scrim; Escape or a\nbackdrop click set `open` back to `false`. `open` is preserved (not reset)\nwhile `collapseState` isn't `'floating'`, but no drawer chrome renders\nuntil it is again — except that leaving `'floating'` while `open` is\n`true` (a breakpoint crossing back to `'wide'`/`'rail'`, or a forced\nreassignment) also closes it, the same way `<lr-app-rail>` closes its\nmobile overlay when leaving `'mobile'` while open.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Panels to arrange side by side (or stacked, when `orientation=\"vertical\"`); each direct child becomes one resizable panel. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `backdrop` | The `'floating'` drawer's scrim. Only rendered while `collapseState === 'floating'` and `open`. |\n| `base` | The flex layout wrapper (`position: relative`, so the `'floating'` collapse state can anchor to it). |\n| `divider` | Each `role=\"separator\"` between two panels. `aria-valuenow` is the leading panel's percentage; `aria-valuemin`/`aria-valuemax` are that divider's currently achievable range, bounded by both adjacent panels' effective constraints and their current combined share (not whole-track bounds). Carries `aria-disabled=\"true\"` and is drag/keyboard-inert while its adjacent panel is collapsed (`'rail'`/`'floating'`). |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-split-overlay-color` (default: `var(--lr-color-overlay)`) — The `'floating'` drawer scrim's color, applied to `[part=\"backdrop\"]`.\n- `--lr-split-divider-hit-slop` (default: `calc((var(--lr-size-3px) - var(--lr-icon-button-size)) / 2)`) — Per-side inset of `[part=\"divider\"]`'s invisible `::before` hit area, along the resize axis. Negative, so the `::before` box extends past the divider's own edges; derived from the shared `--lr-icon-button-size` WCAG 2.5.8 floor minus the divider's visible thickness, split evenly across both sides, so the effective target reaches the floor without widening the 3px divider anyone can see. Declared on `:host`, so an override must target the element itself (not an ancestor). Setting it by hand is rarely right -- retheme `--lr-size-3px`/`--lr-icon-button-size` instead and the slop recomputes.",
           "attributes": [
             {
               "name": "collapse",
@@ -15298,7 +15269,7 @@
         },
         {
           "name": "lr-stack-trace",
-          "description": "`<lr-stack-trace>` — parses common V8/JS-TS, Firefox/Safari, and Python stack traces into a\nleading message plus activatable frames, splitting chained/caused-by errors into separate\ngroups. Frames matching `internalPatterns` (`node_modules/`, `node:internal`,\n`site-packages/`, ... by default) fold behind a count-labeled toggle. Falls back to verbatim\nraw text when nothing parses. First-party invention (no Web Awesome equivalent).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper; respects `max-height`. Drops its card chrome under `appearance=\"plain\"`. |\n| `copy-button` | The copy-to-clipboard button, only rendered while `copyable`. |\n| `frame` | A single frame button; carries `data-internal` for internal frames. |\n| `frame-function` | The frame's function name. |\n| `frame-location` | The frame's `file:line:col` text. |\n| `group` | One chained-error group of frames. |\n| `internal-toggle` | The collapse/expand toggle for a run of internal frames. |\n| `message` | The leading error message text for a group. |\n| `raw` | The verbatim `<pre>` fallback when zero structured frames parsed. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-stack-trace-max-height` (default: `none`) — Cap on how tall `[part=\"base\"]` grows before it scrolls internally. `none` lets the component grow with its content; the `max-height` attribute sets this token.\n- `--lr-stack-trace-font` (default: `var(--lr-font-mono)`) — Font family for the parsed frames and the verbatim raw fallback.",
+          "description": "`<lr-stack-trace>` — parses common V8/JS-TS, Firefox/Safari, and Python stack traces into a\nleading message plus activatable frames, splitting chained/caused-by errors into separate\ngroups. Frames matching `internalPatterns` (`node_modules/`, `node:internal`,\n`site-packages/`, ... by default) fold behind a count-labeled toggle. Falls back to verbatim\nraw text when nothing parses. First-party invention (no Web Awesome equivalent).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper; respects `max-height`. Drops its card chrome under `appearance=\"plain\"`. |\n| `copy-button` | The copy-to-clipboard button, only rendered while `copyable`. |\n| `frame` | A single frame button; carries `data-internal` for internal frames. |\n| `frame-function` | The frame's function name. |\n| `frame-location` | The frame's `file:line:col` text. |\n| `group` | One chained-error group of frames. |\n| `internal-toggle` | The collapse/expand toggle for a run of internal frames. |\n| `message` | The leading error message text for a group. |\n| `raw` | The verbatim `<pre>` fallback when zero structured frames parsed. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-stack-trace-max-height` (default: `none`) — Cap on how tall `[part=\"base\"]` grows before it scrolls internally. `none` lets the component grow with its content; the `max-height` attribute sets this token.\n- `--lr-stack-trace-font` (default: `var(--lr-font-mono)`) — Font family for the parsed frames and the verbatim raw fallback.\n- `--lr-stack-trace-internal-frame-color` (default: `var(--lr-color-text-quiet)`) — Internal frame foreground.\n- `--lr-stack-trace-interactive-color` (default: `var(--lr-color-brand)`) — Interactive frame/toggle accent.",
           "attributes": [
             {
               "name": "appearance",
@@ -15358,7 +15329,7 @@
         },
         {
           "name": "lr-stat",
-          "description": "`<lr-stat>` — a KPI/stat card. First-party invention consolidating the\n\"metric row\" / \"KPI card\" pattern common to dashboard UIs.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Leading icon. |\n| `caption` | Rich caption content (overrides the `caption` attribute). |\n| `spark` | A sparkline (e.g. `<lr-sparkline>`) or other compact trend visual. `lr-stat` only reserves the slot; it doesn't render one itself. |\n| `sub` | Rich sub-line content (overrides the `sub` attribute). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The component's root wrapper (`<div>`, or a real `<a>` when `href` is safe). |\n| `caption` | Container for the caption attribute/slot. |\n| `icon` | Container for the leading icon slot. |\n| `label` | The label text. Hidden (and collapsed) whenever `label` is empty, so a label-less stat doesn't leave a blank line above the value. |\n| `row` | A single breakdown row (one per `rows` entry). |\n| `row-label` | The label text of a breakdown row. |\n| `row-value` | The value text of a breakdown row. Shows the row's `exactValue` (if any) as a hover/focus tooltip, same as the headline `value`, and is accessibly labelled by its `row-label` (via `aria-labelledby`) the same way the headline `value` is. |\n| `rows` | Container for the `rows` breakdown list. |\n| `spark` | Container for the `spark` slot. |\n| `sub` | Container for the `sub` attribute/slot. |\n| `trend` | The trend pill. |\n| `unit` | The unit text. |\n| `value` | The value text. Accessibly labelled by the `label` part (via `aria-labelledby`) whenever `label` is set, so tabbing directly to this (focusable when `exactValue` is set) control still announces which metric it is. |\n| `value-row` | Wrapper around the value and unit. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-stat-trend-good-color` (default: `var(--lr-color-success)`) — Text color of the trend pill when its polarity is \"good\". Independent of the headline value's `variant=\"success\"` tint, which reads the shared `--lr-color-success` token directly.\n- `--lr-stat-trend-good-bg` (default: `color-mix(in srgb, var(--lr-color-success) 8%, transparent)`) — Background of the trend pill when its polarity is \"good\".\n- `--lr-stat-trend-bad-color` (default: `var(--lr-color-danger)`) — Text color of the trend pill when its polarity is \"bad\". Independent of the headline value's `variant=\"danger\"` tint, which reads the shared `--lr-color-danger` token directly.\n- `--lr-stat-trend-bad-bg` (default: `color-mix(in srgb, var(--lr-color-danger) 8%, transparent)`) — Background of the trend pill when its polarity is \"bad\".",
+          "description": "`<lr-stat>` — a KPI/stat card. First-party invention consolidating the\n\"metric row\" / \"KPI card\" pattern common to dashboard UIs.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Leading icon. |\n| `caption` | Rich caption content (overrides the `caption` attribute). |\n| `spark` | A sparkline (e.g. `<lr-sparkline>`) or other compact trend visual. `lr-stat` only reserves the slot; it doesn't render one itself. |\n| `sub` | Rich sub-line content (overrides the `sub` attribute). |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The component's root wrapper (`<div>`, or a real `<a>` when `href` is safe). |\n| `caption` | Container for the caption attribute/slot. |\n| `icon` | Container for the leading icon slot. |\n| `label` | The label text. Hidden (and collapsed) whenever `label` is empty, so a label-less stat doesn't leave a blank line above the value. |\n| `row` | A single breakdown row (one per `rows` entry). |\n| `row-label` | The label text of a breakdown row. |\n| `row-value` | The value text of a breakdown row. Shows the row's `exactValue` (if any) as a hover/focus tooltip, same as the headline `value`, and is accessibly labelled by its `row-label` (via `aria-labelledby`) the same way the headline `value` is. |\n| `rows` | Container for the `rows` breakdown list. |\n| `spark` | Container for the `spark` slot. |\n| `sub` | Container for the `sub` attribute/slot. |\n| `trend` | The trend pill. |\n| `unit` | The unit text. |\n| `value` | The value text. Accessibly labelled by the `label` part (via `aria-labelledby`) whenever `label` is set, so tabbing directly to this (focusable when `exactValue` is set) control still announces which metric it is. |\n| `value-row` | Wrapper around the value and unit. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-stat-trend-good-color` (default: `var(--lr-color-success)`) — Text color of the trend pill when its polarity is \"good\". Independent of the headline value's `variant=\"success\"` tint, which reads the shared `--lr-color-success` token directly.\n- `--lr-stat-trend-good-bg` (default: `color-mix(in srgb, var(--lr-color-success) 8%, transparent)`) — Background of the trend pill when its polarity is \"good\".\n- `--lr-stat-trend-bad-color` (default: `var(--lr-color-danger)`) — Text color of the trend pill when its polarity is \"bad\". Independent of the headline value's `variant=\"danger\"` tint, which reads the shared `--lr-color-danger` token directly.\n- `--lr-stat-trend-bad-bg` (default: `color-mix(in srgb, var(--lr-color-danger) 8%, transparent)`) — Background of the trend pill when its polarity is \"bad\".\n- `--lr-stat-value-success-color` (default: `var(--lr-color-success)`) — Headline value color for the `success` variant.\n- `--lr-stat-value-warning-color` (default: `var(--lr-color-warning)`) — Headline value color for the `warning` variant.\n- `--lr-stat-value-danger-color` (default: `var(--lr-color-danger)`) — Headline value color for the `danger` variant.",
           "attributes": [
             {
               "name": "appearance",
@@ -15719,7 +15690,7 @@
             },
             {
               "name": "max-height",
-              "description": "CSS length that caps the scrollable body.\n\nType: `string`  \nDefault: `''`",
+              "description": "CSS length that caps the scrollable body. Invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -15761,7 +15732,7 @@
           "attributes": [
             {
               "name": "label",
-              "description": "Accessible name for the radiogroup, used when no visible label context\nexists around it (e.g. no wrapping `<label>` or adjacent heading). Set\nas `aria-label` on the `role=\"radiogroup\"` element. A plain `aria-label`\nattribute on the host itself is honored as a fallback when this is left\nunset, matching `<lr-segmented>`.\n\nType: `string`  \nDefault: `''`",
+              "description": "Accessible-name fallback for the radiogroup when the host has no `aria-label`, used when no\nvisible label context exists around it (e.g. no wrapping `<label>` or adjacent heading).\nThe resolved name is set on the `role=\"radiogroup\"` element.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -16242,7 +16213,7 @@
         },
         {
           "name": "lr-task-list",
-          "description": "`<lr-task-list>` — a live, collapsible tracker for an agent's plan: ordered steps with\nper-step lifecycle status and one level of nested sub-steps, embedded in the transcript.\n`items` is controlled and never mutated by this component, mirroring `<lr-stepper>`'s `steps`\ncontract -- but unlike stepper's single-`current` navigation control, task-list is a read-only\nstatus report: several steps may be `running` at once, there is no selection, and status changes\nare announced through an internal `<lr-live-region>`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `detail-<id>` | Dynamic, one per item id (e.g. `slot=\"detail-step-3\"`). Rich detail under that item's label, after its `detail` text -- typically a `<lr-tool-call-chip>` or file `<lr-chip>`. Plain-HTML friendly, no render props. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container. |\n| `body` | The list of items, `hidden` while collapsed. |\n| `header` | The clickable header (a `<button>` when `collapsible`, a plain heading otherwise). |\n| `item` | One item row (`role=\"listitem\"`); carries `data-status`, `data-id`, `data-depth` (`\"0\"` for a top-level item, `\"1\"` for a child). |\n| `item-children` | The nested `role=\"list\"` wrapper around a top-level item's children. |\n| `item-detail` | The item's optional `detail` text. |\n| `item-label` | The item's `label` text. |\n| `label` | The `label` text. |\n| `status-icon` | The per-item status glyph. |\n| `summary` | The visible \"N of M completed\" summary, counting only top-level items. |\n| `toggle` | The chevron indicator inside the header. Only rendered when `collapsible`. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-task-list-spin` (default: `var(--lr-transition-ambient)`) — Running-status icon spin animation duration/timing.\n- `--lr-task-list-compact-header-padding` (default: `var(--lr-space-2xs) var(--lr-space-s)`) — `[part=\"header\"]` padding while `compact`.\n- `--lr-task-list-compact-header-gap` (default: `var(--lr-space-2xs)`) — Gap between `[part=\"header\"]`'s toggle/label/summary while `compact`.\n- `--lr-task-list-compact-gap` (default: `var(--lr-space-2xs)`) — Gap between `[part=\"body\"]`'s item rows while `compact`.\n- `--lr-task-list-compact-body-padding` (default: `var(--lr-space-2xs) var(--lr-space-s) var(--lr-space-s)`) — `[part=\"body\"]` padding while `compact`.",
+          "description": "`<lr-task-list>` — a live, collapsible tracker for an agent's plan: ordered steps with\nper-step lifecycle status and one level of nested sub-steps, embedded in the transcript.\n`items` is controlled and never mutated by this component, mirroring `<lr-stepper>`'s `steps`\ncontract -- but unlike stepper's single-`current` navigation control, task-list is a read-only\nstatus report: several steps may be `running` at once, there is no selection, and status changes\nare announced through an internal `<lr-live-region>`.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `detail-<id>` | Dynamic, one per item id (e.g. `slot=\"detail-step-3\"`). Rich detail under that item's label, after its `detail` text -- typically a `<lr-tool-call-chip>` or file `<lr-chip>`. Plain-HTML friendly, no render props. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container. |\n| `body` | The list of items, `hidden` while collapsed. |\n| `header` | The clickable header (a `<button>` when `collapsible`, a plain heading otherwise). |\n| `item` | One item row (`role=\"listitem\"`); carries `data-status`, `data-id`, `data-depth` (`\"0\"` for a top-level item, `\"1\"` for a child). |\n| `item-children` | The nested `role=\"list\"` wrapper around a top-level item's children. |\n| `item-detail` | The item's optional `detail` text. |\n| `item-label` | The item's `label` text. |\n| `label` | The `label` text. |\n| `status-icon` | The per-item status glyph. |\n| `summary` | The visible \"N of M completed\" summary, counting only top-level items. |\n| `toggle` | The chevron indicator inside the header. Only rendered when `collapsible`. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-task-list-spin` (default: `var(--lr-transition-ambient)`) — Running-status icon spin animation duration/timing.\n- `--lr-task-list-compact-header-padding` (default: `var(--lr-space-2xs) var(--lr-space-s)`) — `[part=\"header\"]` padding while `compact`.\n- `--lr-task-list-compact-header-gap` (default: `var(--lr-space-2xs)`) — Gap between `[part=\"header\"]`'s toggle/label/summary while `compact`.\n- `--lr-task-list-compact-gap` (default: `var(--lr-space-2xs)`) — Gap between `[part=\"body\"]`'s item rows while `compact`.\n- `--lr-task-list-compact-body-padding` (default: `var(--lr-space-2xs) var(--lr-space-s) var(--lr-space-s)`) — `[part=\"body\"]` padding while `compact`.\n- `--lr-task-list-pending-color` (default: `var(--lr-color-text-quiet)`) — Pending status icon color.\n- `--lr-task-list-running-color` (default: `var(--lr-color-brand)`) — Running status icon color.\n- `--lr-task-list-success-color` (default: `var(--lr-color-success)`) — Success status icon color.\n- `--lr-task-list-error-color` (default: `var(--lr-color-danger)`) — Error status icon color.",
           "attributes": [
             {
               "name": "appearance",
@@ -16398,7 +16369,7 @@
         },
         {
           "name": "lr-test-results",
-          "description": "`<lr-test-results>` — a pass/fail suite summary with per-status counts, status filter\ntoggles, and per-test rows whose failures auto-expand by default and can host rich slotted\ndetail (e.g. a diff or code block) alongside the plain failure message.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `detail-{testId}` | Rich failure detail for that test, rendered after its plain message text once the row is expanded. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper; carries `role=\"group\"`. Its `aria-label` defaults to the localized \"Test results\", but a host `aria-label` on `<lr-test-results>` itself wins over that default. |\n| `count` | One status count; carries `data-status`. |\n| `failure` | The failure-detail wrapper; hidden while collapsed. |\n| `failure-message` | The failure's plain message text. |\n| `filter` | The filter-toggle row. |\n| `filter-toggle` | One status filter toggle; carries `data-status` and `aria-pressed`. |\n| `suite` | One suite section. |\n| `suite-header` | The suite's name row. |\n| `summary` | The status-count strip. |\n| `test` | One test row; carries `data-status`. |\n| `test-duration` | The duration text. |\n| `test-expand-toggle` | The expand/collapse button for a row's failure detail. Rendered for any failed test, or any test with slotted `detail-{testId}` content. |\n| `test-name` | The activatable test-name button. |\n| `test-status` | The status glyph and its visible status-word text; carries `data-status`. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-test-results-filter-active-bg` (default: `var(--lr-color-brand-quiet)`) — Background of a pressed (active) status filter toggle.\n- `--lr-test-results-filter-active-border` (default: `var(--lr-color-brand)`) — Border color of a pressed (active) status filter toggle.\n- `--lr-test-results-filter-active-color` (default: `var(--lr-color-brand)`) — Text color of a pressed (active) status filter toggle. Restyling the pressed state otherwise requires overriding the library-wide brand tokens, since `::part(filter-toggle)[aria-pressed]` is invalid CSS.",
+          "description": "`<lr-test-results>` — a pass/fail suite summary with per-status counts, status filter\ntoggles, and per-test rows whose failures auto-expand by default and can host rich slotted\ndetail (e.g. a diff or code block) alongside the plain failure message.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| `detail-{encodedSuiteId}:{encodedTestId}` | Collision-free suite-scoped rich detail for a test. Encode each id with `encodeURIComponent`; this form takes precedence over legacy slots. |\n| `detail-{suiteId}-{testId}` | Legacy suite-scoped detail, supported only when its name maps unambiguously to one suite/test pair and does not collide with another pair's canonical name. |\n| `detail-{testId}` | Legacy rich detail for a test whose id is globally unique across all suites. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The root wrapper; carries `role=\"group\"`. Its `aria-label` defaults to the localized \"Test results\", but a host `aria-label` on `<lr-test-results>` itself wins over that default. |\n| `count` | One status count; carries `data-status`. |\n| `failure` | The failure-detail wrapper; hidden while collapsed. |\n| `failure-message` | The failure's plain message text. |\n| `filter` | The filter-toggle row. |\n| `filter-toggle` | One status filter toggle; carries `data-status` and `aria-pressed`. |\n| `suite` | One suite section. |\n| `suite-header` | The suite's name row. |\n| `summary` | The status-count strip. |\n| `test` | One test row; carries `data-status`. |\n| `test-duration` | The duration text. |\n| `test-expand-toggle` | The expand/collapse button for a row's failure detail. Rendered for any failed test, or any test with suite-scoped detail content (or the eligible globally unique legacy `detail-{testId}` form). |\n| `test-name` | The activatable test-name button. |\n| `test-status` | The status glyph and its visible status-word text; carries `data-status`. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-test-results-filter-active-bg` (default: `var(--lr-color-brand-quiet)`) — Background of a pressed (active) status filter toggle.\n- `--lr-test-results-filter-active-border` (default: `var(--lr-color-brand)`) — Border color of a pressed (active) status filter toggle.\n- `--lr-test-results-filter-active-color` (default: `var(--lr-color-brand)`) — Text color of a pressed (active) status filter toggle. Restyling the pressed state otherwise requires overriding the library-wide brand tokens, since `::part(filter-toggle)[aria-pressed]` is invalid CSS.\n- `--lr-test-results-passed-color` (default: `var(--lr-color-success)`) — Passed-state foreground.\n- `--lr-test-results-failed-color` (default: `var(--lr-color-danger)`) — Failed-state foreground.\n- `--lr-test-results-skipped-color` (default: `var(--lr-color-text-quiet)`) — Skipped-state foreground.\n- `--lr-test-results-running-color` (default: `var(--lr-color-brand)`) — Running-state foreground.",
           "attributes": [
             {
               "name": "auto-expand-failures",
@@ -16564,7 +16535,7 @@
             },
             {
               "name": "resize",
-              "description": "Native CSS `resize` behavior for the textarea, plus `'auto'`: a `ResizeObserver`-driven\ngrow-to-content mode with no manual drag handle (mirrors `wa-textarea`'s `resize=\"auto\"`).\n\nType: `TextareaResize`  \nDefault: `'vertical'`",
+              "description": "Native CSS `resize` behavior for the textarea, plus `'auto'`: a `ResizeObserver`-driven\ngrow-to-content mode with no manual drag handle (mirrors `wa-textarea`'s `resize=\"auto\"`).\nAn invalid runtime value falls back to `'vertical'`.\n\nType: `TextareaResize`  \nDefault: `'vertical'`",
               "value": {
                 "type": [
                   "TextareaResize"
@@ -16602,7 +16573,7 @@
         },
         {
           "name": "lr-thinking-panel",
-          "description": "`<lr-thinking-panel>` — a collapsible panel for an AI agent's\nintermediate reasoning/\"thinking\" transcript, kept visually and\nsemantically distinct from its final response. Same collapsible\nheader-button-plus-region shape as `<lr-source-list>`; the default slot\nis entirely free-form (a consumer-composed `<lr-streaming-text>`,\n`<lr-markdown>`, or plain text) — this component has no dependency on\neither and imposes no structure on what's slotted.\n\n`mode` (`'live'` while reasoning is actively streaming in, `'post-hoc'`\nonce it's complete and being reviewed after the fact) drives two concrete\nbehavior differences, not just a styling hook:\n- **Header hint.** While `duration-ms` is unset, `'live'` shows a pulsing\n  \"Thinking…\" placeholder in `[part=\"duration\"]`; `'post-hoc'` shows\n  nothing there instead (a finished review with no known duration has\n  nothing useful to say in that slot). Once `duration-ms` is set, both\n  modes show the same static `\"Thought for …\"` text — a `'post-hoc'`\n  consumer that captured a duration is free to supply it too.\n- **Auto-scroll.** Only `'live'` mode auto-follows new content appended to\n  the default slot while `expanded` (see below); `'post-hoc'` never\n  scrolls on its own, since reviewing finished reasoning is expected to\n  start from the top like reading any other completed document. This\n  library otherwise defaults to *not* editorializing about a host's data\n  (see `<lr-empty>`'s plain-`description` stance), but scroll position\n  is presentation, not data, so this one behavior difference earns its\n  keep rather than being left as a bare visual/semantic hint the host\n  would have to reimplement identically itself.\n\nLive-mode auto-scroll (\"stick to bottom\") is the classic chat-transcript\nconvention: while `mode=\"live\"` and `expanded`, new content keeps the\npanel scrolled to its latest line — *unless* the user has manually\nscrolled up to (re-)read earlier content, in which case their position is\nnever yanked away from them. This is tracked continuously via a `scroll`\nlistener on `[part=\"body\"]` (not recomputed from the mutation itself,\nwhich necessarily observes the DOM only *after* it has already changed):\nevery user-driven scroll records whether the body was left within\n`NEAR_BOTTOM_PX` of its own max scroll position, and only a mutation that\narrives while that's still true triggers a follow-up scroll-to-bottom.\nOpening an already-`'live'` panel (or one that later becomes `'live'`)\nalways resets this to \"anchored\" and jumps to the latest content, the same\nway a chat app's own transcript does when you re-open it.\n\nNew content is detected via a `MutationObserver` on this element's own\nlight DOM (`childList`+`subtree`+`characterData`) rather than the default\nslot's `slotchange` event, because `slotchange` only fires when the set of\ntop-level assigned nodes changes — never for a text node mutating *inside*\nan already-slotted element, which is the more likely shape for streamed\nreasoning (a consumer appending chunks to an existing node's `textContent`\nrather than re-slotting a whole new element per token). The one thing this\ncan't see is a mutation entirely inside a slotted custom element's own\nshadow root (e.g. a `<lr-markdown>` re-rendering its shadow tree after a\n`content` property change) — Shadow DOM encapsulation blocks that by\ndesign, and there is no way for this component to reach across that\nboundary. A slotted element whose *own* internal updates should drive this\npanel's auto-scroll needs to append/mutate visible light-DOM text itself\n(as `<lr-streaming-text>` is expected to), or the host can call this\npanel's own `scrollToBottom()` directly.\n\n`aria-controls` linking the header to the body region uses `nextId()`\n(`../../internal/a11y.js`) for a collision-safe id, the same convention\n`<lr-source-list>` and `<lr-widget>` already establish for every\ntoggle-controls-region pairing in this library.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | The reasoning/thinking content. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container. |\n| `body` | The wrapper around the default slot, `hidden` while collapsed. Independently keyboard-focusable (`tabindex=\"0\"`, `role=\"group\"` named from `label`) since it's its own capped-height scrollable region. |\n| `duration` | The formatted duration / \"Thinking…\" placeholder, when shown. |\n| `header` | The clickable header (`<button>`) toggling `expanded`. |\n| `label` | The `label` text. |\n| `toggle` | The chevron indicator inside the header. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-thinking-panel-max-block-size` (default: `var(--lr-size-16rem)`) — Cap on how tall the expanded reasoning transcript grows before `[part=\"body\"]` scrolls internally.",
+          "description": "`<lr-thinking-panel>` — a collapsible panel for an AI agent's\nintermediate reasoning/\"thinking\" transcript, kept visually and\nsemantically distinct from its final response. Same collapsible\nheader-button-plus-region shape as `<lr-source-list>`; the default slot\nis entirely free-form (a consumer-composed `<lr-streaming-text>`,\n`<lr-markdown>`, or plain text) — this component has no dependency on\neither and imposes no structure on what's slotted.\n\n`mode` (`'live'` while reasoning is actively streaming in, `'post-hoc'`\nonce it's complete and being reviewed after the fact) drives two concrete\nbehavior differences, not just a styling hook:\n- **Header hint.** While `duration-ms` is unset, `'live'` shows a pulsing\n  \"Thinking…\" placeholder in `[part=\"duration\"]`; `'post-hoc'` shows\n  nothing there instead (a finished review with no known duration has\n  nothing useful to say in that slot). Once `duration-ms` is set, both\n  modes show the same static `\"Thought for …\"` text — a `'post-hoc'`\n  consumer that captured a duration is free to supply it too.\n- **Auto-scroll.** Only `'live'` mode auto-follows new content appended to\n  the default slot while `expanded` (see below); `'post-hoc'` never\n  scrolls on its own, since reviewing finished reasoning is expected to\n  start from the top like reading any other completed document. This\n  library otherwise defaults to *not* editorializing about a host's data\n  (see `<lr-empty>`'s plain-`description` stance), but scroll position\n  is presentation, not data, so this one behavior difference earns its\n  keep rather than being left as a bare visual/semantic hint the host\n  would have to reimplement identically itself.\n\nLive-mode auto-scroll (\"stick to bottom\") is the classic chat-transcript\nconvention: while `mode=\"live\"` and `expanded`, new content keeps the\npanel scrolled to its latest line — *unless* the user has manually\nscrolled up to (re-)read earlier content, in which case their position is\nnever yanked away from them. This is tracked continuously via a `scroll`\nlistener on `[part=\"body\"]` (not recomputed from the mutation itself,\nwhich necessarily observes the DOM only *after* it has already changed):\nevery user-driven scroll records whether the body was left within\n`NEAR_BOTTOM_PX` of its own max scroll position, and only a mutation that\narrives while that's still true triggers a follow-up scroll-to-bottom.\nOpening an already-`'live'` panel (or one that later becomes `'live'`)\nalways resets this to \"anchored\" and jumps to the latest content, the same\nway a chat app's own transcript does when you re-open it.\n\nNew content is detected via a `MutationObserver` on this element's own\nlight DOM (`childList`+`subtree`+`characterData`) rather than the default\nslot's `slotchange` event, because `slotchange` only fires when the set of\ntop-level assigned nodes changes — never for a text node mutating *inside*\nan already-slotted element, which is the more likely shape for streamed\nreasoning (a consumer appending chunks to an existing node's `textContent`\nrather than re-slotting a whole new element per token). The one thing this\ncan't see is a mutation entirely inside a slotted custom element's own\nshadow root (e.g. a `<lr-markdown>` re-rendering its shadow tree after a\n`content` property change) — Shadow DOM encapsulation blocks that by\ndesign, and there is no way for this component to reach across that\nboundary. A slotted element whose *own* internal updates should drive this\npanel's auto-scroll needs to append/mutate visible light-DOM text itself\n(as `<lr-streaming-text>` is expected to), or the host can call this\npanel's own `scrollToBottom()` directly.\n\n`aria-controls` linking the header to the body region uses `nextId()`\n(`../../internal/a11y.js`) for a collision-safe id, the same convention\n`<lr-source-list>` and `<lr-widget>` already establish for every\ntoggle-controls-region pairing in this library.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | The reasoning/thinking content. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `base` | The outer container. |\n| `body` | The wrapper around the default slot, `hidden` while collapsed. Independently keyboard-focusable (`tabindex=\"0\"`, `role=\"group\"` named from `label`) since it's its own capped-height scrollable region. |\n| `duration` | The formatted duration / \"Thinking…\" placeholder, when shown. |\n| `header` | The clickable header (`<button>`) toggling `expanded`. |\n| `label` | The `label` text. |\n| `toggle` | The chevron indicator inside the header. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-thinking-panel-max-block-size` (default: `var(--lr-size-16rem)`) — Cap on how tall the expanded reasoning transcript grows before `[part=\"body\"]` scrolls internally.\n- `--lr-thinking-panel-pending-color` (default: `var(--lr-color-brand)`) — Live pending-state color.",
           "attributes": [
             {
               "name": "duration-ms",
@@ -17046,7 +17017,7 @@
           "attributes": [
             {
               "name": "active",
-              "description": "Marks this as the current/in-progress item (e.g. \"the agent is executing this step right now\"),\nas opposed to a resolved past entry. Drives a pulsing marker (disabled under\n`prefers-reduced-motion: reduce`) and `aria-current=\"true\"` on the host -- omitted entirely\n(not `\"false\"`) while inactive, matching `<lr-stepper>`'s identical `aria-current` handling.\n\nType: `boolean`  \nDefault: `false`",
+              "description": "Marks this as the current/in-progress item (e.g. \"the agent is executing this step right now\"),\nas opposed to a resolved past entry. Drives a pulsing marker (disabled under\n`prefers-reduced-motion: reduce`) and an explicit `aria-current` state on the host.\n\nType: `boolean`  \nDefault: `false`",
               "value": {
                 "type": [
                   "boolean"
@@ -17108,7 +17079,7 @@
         },
         {
           "name": "lr-toast-item",
-          "description": "`<lr-toast-item>` — a single toast notification.\nMirrors the Web Awesome `<wa-toast-item>` API under the `lr-` prefix.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | The message content. |\n| `icon` | Optional icon shown at the start. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `accent` | The colored accent bar. |\n| `close-button` | The dismiss button. |\n| `content` | The message wrapper. |\n| `icon` | The icon wrapper. |\n| `toast-item` | The outer container. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-toast-accent-width` (default: `var(--lr-size-4px)`) — Width of the accent bar, and the extra inline-start padding reserved for it.\n- `--lr-toast-accent-color` (default: `var(--lr-color-border)`) — Color of the accent bar and the icon, auto-swapped per `variant`.\n- `--lr-toast-padding` (default: `var(--lr-space-m)`) — Padding of the item, auto-swapped per `size`.\n- `--lr-toast-font-size` (default: `var(--lr-font-size-md)`) — Font size of the item, auto-swapped per `size`.\n- `--lr-toast-show-duration` (default: `var(--lr-transition-base, 180ms ease-out)`) — Opacity/transform transition used while showing.\n- `--lr-toast-hide-duration` (default: `var(--lr-transition-base, 180ms ease-out)`) — Opacity/transform transition used while hiding.",
+          "description": "`<lr-toast-item>` — a single toast notification. Contextual close names include rich\nnon-interactive message markup and update with its text. When a focused toast finishes hiding,\nfocus moves to an adjacent toast or back to the pre-toast control. A hide interrupted by\ndisconnect resumes to one terminal completion if the same item reconnects.\nMirrors the Web Awesome `<wa-toast-item>` API under the `lr-` prefix.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | The message content. |\n| `icon` | Optional icon shown at the start. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `accent` | The colored accent bar. |\n| `close-button` | The dismiss button. |\n| `content` | The message wrapper. |\n| `icon` | The icon wrapper. |\n| `toast-item` | The outer container. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-toast-accent-width` (default: `var(--lr-size-4px)`) — Width of the accent bar, and the extra inline-start padding reserved for it.\n- `--lr-toast-accent-color` (default: `var(--lr-color-border)`) — Color of the accent bar and the icon, auto-swapped per `variant`.\n- `--lr-toast-padding` (default: `var(--lr-space-m)`) — Padding of the item, auto-swapped per `size`.\n- `--lr-toast-font-size` (default: `var(--lr-font-size-md)`) — Font size of the item, auto-swapped per `size`.\n- `--lr-toast-show-duration` (default: `var(--lr-transition-base, 180ms ease-out)`) — Opacity/transform transition used while showing.\n- `--lr-toast-hide-duration` (default: `var(--lr-transition-base, 180ms ease-out)`) — Opacity/transform transition used while hiding.",
           "attributes": [
             {
               "name": "duration",
@@ -17179,6 +17150,24 @@
                 ]
               }
             },
+            {
+              "name": "autocapitalize",
+              "description": "Forwarded to both native text inputs. Empty preserves the browser default.\n\nType: `string`  \nDefault: `''`",
+              "value": {
+                "type": [
+                  "string"
+                ]
+              }
+            },
+            {
+              "name": "autocorrect",
+              "description": "Forwarded to both native text inputs through the lowercase `autocorrect` attribute.\nThe camel-cased property avoids the boolean `HTMLElement.autocorrect` DOM typing.\n\nType: `string`  \nDefault: `''`",
+              "value": {
+                "type": [
+                  "string"
+                ]
+              }
+            },
             {
               "name": "delimiter",
               "description": "Character(s) that split a typed draft into several tokens, and (when a single character) the\nkeystroke that commits the draft. `null` — from the property, or from `delimiter=\"none\"` /\n`delimiter=\"\"` — disables both, so a token may contain the delimiter verbatim. Defaults to `,`.\n\nType: `string | null`  \nDefault: `','`"
@@ -17194,7 +17183,7 @@
             },
             {
               "name": "editable",
-              "description": "Allow editing an existing token in place: each token becomes a roving tab stop that opens an\ninline editor on click, Enter, or F2. Defaults to `false`, in which case the token row renders\nexactly as it does without this feature and stays non-focusable.\n\nType: `boolean`  \nDefault: `false`",
+              "description": "Type: `boolean`",
               "value": {
                 "type": [
                   "boolean"
@@ -17272,6 +17261,15 @@
                   "LyraTokenInputSize"
                 ]
               }
+            },
+            {
+              "name": "spellcheck",
+              "description": "Forwarded to both native text inputs using the native explicit `\"true\"`/`\"false\"`\nattribute vocabulary.\n\nType: `boolean`  \nDefault: `true`",
+              "value": {
+                "type": [
+                  "boolean"
+                ]
+              }
             }
           ]
         },
@@ -17744,7 +17742,7 @@
         },
         {
           "name": "lr-tooltip",
-          "description": "`<lr-tooltip>` — a localized, hover/focus tooltip for a consumer-owned trigger.\nPlain content uses tooltip semantics. When the default slot contains an actionable descendant,\nthe popup promotes to a named dialog and remains open while pointer or focus is inside so its\ncontrols can be reached. Prefer `<lr-popover>` when click-to-open ownership is desired.\n\nWhile open, the trigger's `aria-describedby` targets a hidden text proxy in this component's\nlight DOM rather than the shadow-private popup. Native triggers can resolve that ID directly;\n`<lr-button>` and `<lr-icon-button>` reflect it onto their focused internal controls through\n`ariaDescribedByElements`, where the serialized internal attribute is intentionally empty.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Tooltip content. |\n| `trigger` | The element that receives hover/focus listeners. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `popup` | The tooltip popup. |\n| `trigger` | The trigger wrapper. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-tooltip-max-inline-size` — Maximum inline size of the tooltip (default `--lr-size-20rem`).\n- `--lr-tooltip-background` — Tooltip background color (default `--lr-color-neutral`).\n- `--lr-tooltip-color` — Tooltip text color (default `--lr-color-on-neutral`).",
+          "description": "`<lr-tooltip>` — a localized, hover/focus tooltip for a consumer-owned trigger.\nPlain content uses tooltip semantics. When the default slot contains an actionable descendant\n(including inside a nested custom element's open shadow root), the popup promotes to a named\ndialog and remains open while pointer or focus is inside so its controls can be reached. Escape\nfrom popup content closes it and restores focus to the trigger. Prefer `<lr-popover>` when\nclick-to-open ownership is desired.\n\nWhile open, the trigger's `aria-describedby` targets a hidden text proxy in this component's\nlight DOM rather than the shadow-private popup. Native triggers can resolve that ID directly;\n`<lr-button>` and `<lr-icon-button>` reflect it onto their focused internal controls through\n`ariaDescribedByElements`, where the serialized internal attribute is intentionally empty.\n\n---\n\n**Slots**\n\n| Name | Description |\n| --- | --- |\n| (default) | Tooltip content. |\n| `trigger` | The element that receives hover/focus listeners. |\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `popup` | The tooltip popup. |\n| `trigger` | The trigger wrapper. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-tooltip-max-inline-size` — Maximum inline size of the tooltip (default `--lr-size-20rem`).\n- `--lr-tooltip-background` — Tooltip background color (default `--lr-color-neutral`).\n- `--lr-tooltip-color` — Tooltip text color (default `--lr-color-on-neutral`).",
           "attributes": [
             {
               "name": "aria-label",
@@ -18027,7 +18025,7 @@
         },
         {
           "name": "lr-tree-node",
-          "description": "`<lr-tree-node>` — internal recursive renderer for `<lr-tree>`.\n\n`role=\"treeitem\"` (plus `aria-expanded`/`aria-level`/`aria-setsize`/\n`aria-posinset` and the roving `tabindex`, driven by `<lr-tree>`) live on\nthe *host* element, not the internal `[part=\"row\"]` div — that makes this\nnode's own nested children (rendered in *its own* shadow root as further\n`role=\"group\"` content) genuine DOM descendants of the treeitem, which is\nwhat the WAI-ARIA treeitem pattern requires (previously a shadow-root\nsibling).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `badge` | The optional node badge (the legacy `item.badge`, and/or one chip per `item.badges` entry, tone-mapped via `data-tone`). |\n| `content` | The primary and secondary text wrapper. |\n| `description` | The optional secondary description. |\n| `group` | The wrapper around a node's expanded child items. |\n| `icon` | The optional decorative leading icon. |\n| `label` | The node label. |\n| `row` | The tree row. |\n| `toggle` | The expand/collapse button. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-tree-depth` (default: `0`) — Internal indent plumbing, not a retheming knob: this node's `depth`, written inline onto `[part=\"row\"]` by the component and multiplied by `--lr-space-l` (capped at `--lr-size-8rem`) to produce the row's `padding-inline-start`.\n- `--lr-tree-selected-bg` (default: `var(--lr-color-brand-quiet)`) — Background of the selected row.\n- `--lr-tree-selected-color` (default: `var(--lr-color-brand)`) — Text color of the selected row.",
+          "description": "`<lr-tree-node>` — internal recursive renderer for `<lr-tree>`.\n\n`role=\"treeitem\"` (plus `aria-expanded`/`aria-level`/`aria-setsize`/\n`aria-posinset` and the roving `tabindex`, driven by `<lr-tree>`) live on\nthe *host* element, not the internal `[part=\"row\"]` div — that makes this\nnode's own nested children (rendered in *its own* shadow root as further\n`role=\"group\"` content) genuine DOM descendants of the treeitem, which is\nwhat the WAI-ARIA treeitem pattern requires (previously a shadow-root\nsibling).\n\n---\n\n**CSS Shadow Parts**\n\n| Name | Description |\n| --- | --- |\n| `badge` | The optional node badge (the legacy `item.badge`, and/or one chip per `item.badges` entry, tone-mapped via `data-tone`). |\n| `content` | The primary and secondary text wrapper. |\n| `description` | The optional secondary description. |\n| `group` | The wrapper around a node's expanded child items. |\n| `icon` | The optional decorative leading icon. |\n| `label` | The node label. |\n| `row` | The tree row. |\n| `toggle` | The expand/collapse button. |\n\n---\n\n**CSS Custom Properties**\n\n- `--lr-tree-depth` (default: `0`) — Internal indent plumbing, not a retheming knob: this node's `depth`, written inline onto `[part=\"row\"]` by the component and multiplied by `--lr-space-l` (capped at `--lr-size-8rem`) to produce the row's `padding-inline-start`.\n- `--lr-tree-selected-bg` (default: `var(--lr-color-brand-quiet)`) — Background of the selected row.\n- `--lr-tree-selected-color` (default: `var(--lr-color-brand)`) — Text color of the selected row.\n- `--lr-tree-badge-neutral-color` (default: `var(--lr-color-text-quiet)`) — Neutral badge text color.\n- `--lr-tree-badge-neutral-bg` (default: `var(--lr-color-surface)`) — Neutral badge background.\n- `--lr-tree-badge-brand-color` (default: `var(--lr-color-brand)`) — Brand badge text color.\n- `--lr-tree-badge-brand-bg` (default: `var(--lr-color-brand-quiet)`) — Brand badge background.\n- `--lr-tree-badge-success-color` (default: `var(--lr-color-success)`) — Success badge text color.\n- `--lr-tree-badge-success-bg` (default: `var(--lr-color-success-quiet)`) — Success badge background.\n- `--lr-tree-badge-warning-color` (default: `var(--lr-color-warning)`) — Warning badge text color.\n- `--lr-tree-badge-warning-bg` (default: `var(--lr-color-warning-quiet)`) — Warning badge background.\n- `--lr-tree-badge-danger-color` (default: `var(--lr-color-danger)`) — Danger badge text color.\n- `--lr-tree-badge-danger-bg` (default: `var(--lr-color-danger-quiet)`) — Danger badge background.",
           "attributes": [
             {
               "name": "depth",
@@ -18400,7 +18398,7 @@
             },
             {
               "name": "backdrop-inset",
-              "description": "Overrides the fullscreen *backdrop*'s own inset independent of `fullscreen-inset` -- e.g.\n`\"0\"` to dim the full viewport-to-panel-edge region while the panel itself keeps a narrower\n`fullscreen-inset`. Unset (the default) falls back to `fullscreen-inset`, i.e. today's exact\ncoupled behavior.\n\nType: `string`  \nDefault: `\"\"`",
+              "description": "Overrides the fullscreen *backdrop*'s own inset independent of `fullscreen-inset` -- e.g.\n`\"0\"` to dim the full viewport-to-panel-edge region while the panel itself keeps a narrower\n`fullscreen-inset`. Unset (the default) falls back to `fullscreen-inset`, i.e. today's exact\ncoupled behavior. Invalid values fall back to a valid `fullscreen-inset`, if present.\n\nType: `string`  \nDefault: `\"\"`",
               "value": {
                 "type": [
                   "string"
@@ -18454,7 +18452,7 @@
             },
             {
               "name": "fullscreen-inset",
-              "description": "Raw CSS `inset` shorthand applied to the fullscreen panel and backdrop instead of the default\n`var(--lr-space-l)` on every side — e.g. `\"0 0 0 240px\"` to leave a 240px persistent sidebar\nvisible while fullscreen.\n\nType: `string`  \nDefault: `\"\"`",
+              "description": "CSS `inset` shorthand applied to the fullscreen panel and backdrop instead of the default\n`var(--lr-space-l)` on every side — e.g. `\"0 0 0 240px\"` to leave a 240px persistent sidebar\nvisible while fullscreen. Invalid values are ignored.\n\nType: `string`  \nDefault: `\"\"`",
               "value": {
                 "type": [
                   "string"
@@ -18587,7 +18585,7 @@
             },
             {
               "name": "max-height",
-              "description": "A CSS length (e.g. `\"20rem\"`); once set, the viewer scrolls internally past this height\ninstead of growing the page.\n\nType: `string`  \nDefault: `''`",
+              "description": "A CSS `max-height`; invalid values are ignored.\n\nType: `string`  \nDefault: `''`",
               "value": {
                 "type": [
                   "string"
@@ -18787,6 +18785,34 @@
           "name": "--lr-approval-queue-selected-border",
           "description": "**`<lr-approval-queue>`** (default: `var(--lr-color-brand)`) — Selected request border."
         },
+        {
+          "name": "--lr-archive-viewer-highlight-accent-background",
+          "description": "**`<lr-archive-viewer>`** — Accent highlight background."
+        },
+        {
+          "name": "--lr-archive-viewer-highlight-active-background",
+          "description": "**`<lr-archive-viewer>`** — Active highlight background."
+        },
+        {
+          "name": "--lr-archive-viewer-highlight-active-outline",
+          "description": "**`<lr-archive-viewer>`** — Active fallback-highlight outline."
+        },
+        {
+          "name": "--lr-archive-viewer-highlight-danger-background",
+          "description": "**`<lr-archive-viewer>`** — Danger highlight background."
+        },
+        {
+          "name": "--lr-archive-viewer-highlight-neutral-background",
+          "description": "**`<lr-archive-viewer>`** — Neutral highlight background."
+        },
+        {
+          "name": "--lr-archive-viewer-highlight-success-background",
+          "description": "**`<lr-archive-viewer>`** — Success highlight background."
+        },
+        {
+          "name": "--lr-archive-viewer-highlight-warning-background",
+          "description": "**`<lr-archive-viewer>`** — Warning highlight background."
+        },
         {
           "name": "--lr-artifact-panel-view-active-bg",
           "description": "**`<lr-artifact-panel>`** (default: `var(--lr-color-brand-quiet)`) — Background of the pressed (active) preview/code toggle button."
@@ -19141,7 +19167,7 @@
         },
         {
           "name": "--lr-chart-height",
-          "description": "**`<lr-bar-chart>`, `<lr-bubble-chart>`, `<lr-chart>`, `<lr-doughnut-chart>`, `<lr-histogram>`, `<lr-line-chart>`, `<lr-pie-chart>`, `<lr-polar-area-chart>`, `<lr-radar-chart>`, `<lr-scatter-chart>`** (default: `var(--lr-size-280px)`) — The host's `block-size`. Set on the host element from the `height` property on every change (custom properties only cascade downward, so it cannot be set from inside the shadow root); a host-level override is overwritten the next time `height` changes."
+          "description": "**`<lr-bar-chart>`, `<lr-bubble-chart>`, `<lr-chart>`, `<lr-doughnut-chart>`, `<lr-histogram>`, `<lr-line-chart>`, `<lr-pie-chart>`, `<lr-polar-area-chart>`, `<lr-radar-chart>`, `<lr-scatter-chart>`** (default: `var(--lr-size-280px)`) — The plot region's `block-size` and the host's minimum block size. A visible data table or wrapping DOM legend grows the host in normal flow instead of overlapping following content. Set on the host from `height`."
         },
         {
           "name": "--lr-chart-legend-color",
@@ -19467,6 +19493,18 @@
           "name": "--lr-compare-panel-max-height",
           "description": "**`<lr-compare-panel>`** (default: `var(--lr-size-24rem)`) — Cap on how tall each pane's scroll region grows before it scrolls internally."
         },
+        {
+          "name": "--lr-compare-panel-selected-background",
+          "description": "**`<lr-compare-panel>`** (default: `var(--lr-color-brand-quiet)`) — Selected vote button background."
+        },
+        {
+          "name": "--lr-compare-panel-selected-border-color",
+          "description": "**`<lr-compare-panel>`** (default: `var(--lr-color-brand)`) — Selected vote button border color."
+        },
+        {
+          "name": "--lr-compare-panel-selected-color",
+          "description": "**`<lr-compare-panel>`** (default: `var(--lr-color-brand)`) — Selected vote button text color."
+        },
         {
           "name": "--lr-confirm-bar-approved-color",
           "description": "**`<lr-confirm-bar>`** (default: `var(--lr-color-success)`) — `[part='status']` text/icon color once `decision` is `'approved'`."
@@ -19559,6 +19597,10 @@
           "name": "--lr-dashboard-grid-gap",
           "description": "**`<lr-dashboard-grid>`** (default: `var(--lr-space-m)`) — Gap between cells on both axes. Written inline on `[part=\"base\"]` from the `gap` property (in px) on every render."
         },
+        {
+          "name": "--lr-dashboard-grid-interaction-shadow",
+          "description": "**`<lr-dashboard-grid>`** (default: `var(--lr-shadow)`) — Box shadow applied to a cell for the duration of its pointer drag or resize interaction."
+        },
         {
           "name": "--lr-dashboard-grid-row-height",
           "description": "**`<lr-dashboard-grid>`** (default: `var(--lr-size-5rem)`) — Row track height. Written inline on `[part=\"base\"]` from the `rowHeight` property (in px) on every render."
@@ -19779,6 +19821,10 @@
           "name": "--lr-email-viewer-max-height",
           "description": "**`<lr-email-viewer>`** (default: `none`) — Maximum block size of `[part=\"body\"]` before it scrolls internally. The `maxHeight` property sets this token inline on `[part=\"base\"]`."
         },
+        {
+          "name": "--lr-embedding-explorer-height",
+          "description": "**`<lr-embedding-explorer>`** (default: `360px`) — The plot's `block-size`. Set on the host from the `height` property, whose default supplies the `360px`; a value the browser cannot parse as a `block-size` is dropped, leaving the `viewBox`-derived aspect-ratio size. A consumer's own `::part(plot) { block-size: ... }` rule still overrides it, and the narrow-allocation `min-block-size` floor still raises it."
+        },
         {
           "name": "--lr-embedding-explorer-selected-stroke",
           "description": "**`<lr-embedding-explorer>`** (default: `var(--lr-color-brand)`) — Stroke color of the selected point."
@@ -19947,6 +19993,30 @@
           "name": "--lr-flow-minimap-inline-size",
           "description": "**`<lr-flow-minimap>`** (default: `var(--lr-size-12rem)`) — Map inline size."
         },
+        {
+          "name": "--lr-flow-minimap-node-color",
+          "description": "**`<lr-flow-minimap>`** (default: `var(--lr-color-border-strong)`) — Fill of nodes without an execution status."
+        },
+        {
+          "name": "--lr-flow-minimap-node-denied-color",
+          "description": "**`<lr-flow-minimap>`** (default: `var(--lr-color-warning)`) — Denied-node fill."
+        },
+        {
+          "name": "--lr-flow-minimap-node-error-color",
+          "description": "**`<lr-flow-minimap>`** (default: `var(--lr-color-danger)`) — Failed-node fill."
+        },
+        {
+          "name": "--lr-flow-minimap-node-pending-color",
+          "description": "**`<lr-flow-minimap>`** (default: `var(--lr-color-border-strong)`) — Pending-node fill."
+        },
+        {
+          "name": "--lr-flow-minimap-node-running-color",
+          "description": "**`<lr-flow-minimap>`** (default: `var(--lr-color-brand)`) — Running-node fill."
+        },
+        {
+          "name": "--lr-flow-minimap-node-success-color",
+          "description": "**`<lr-flow-minimap>`** (default: `var(--lr-color-success)`) — Successful-node fill."
+        },
         {
           "name": "--lr-flow-node-compact-gap",
           "description": "**`<lr-flow-node>`** (default: `var(--lr-space-2xs)`) — Gap between `[part=\"card\"]`'s rows while `compact`."
@@ -19971,6 +20041,54 @@
           "name": "--lr-flow-node-selected-border",
           "description": "**`<lr-flow-node>`** (default: `var(--lr-color-brand)`) — Border color of the card while `selected`. Overriding the selection color otherwise requires hijacking the library-wide `--lr-color-brand` token."
         },
+        {
+          "name": "--lr-flow-node-status-color",
+          "description": "**`<lr-flow-node>`** (default: `var(--lr-color-border-strong)`) — Status-dot color when no execution status is set."
+        },
+        {
+          "name": "--lr-flow-node-status-denied-color",
+          "description": "**`<lr-flow-node>`** (default: `var(--lr-color-warning)`) — Denied status-dot color."
+        },
+        {
+          "name": "--lr-flow-node-status-error-color",
+          "description": "**`<lr-flow-node>`** (default: `var(--lr-color-danger)`) — Error status-dot color."
+        },
+        {
+          "name": "--lr-flow-node-status-pending-color",
+          "description": "**`<lr-flow-node>`** (default: `var(--lr-color-border-strong)`) — Pending status-dot color."
+        },
+        {
+          "name": "--lr-flow-node-status-running-color",
+          "description": "**`<lr-flow-node>`** (default: `var(--lr-color-brand)`) — Running status-dot color."
+        },
+        {
+          "name": "--lr-flow-node-status-success-color",
+          "description": "**`<lr-flow-node>`** (default: `var(--lr-color-success)`) — Success status-dot color."
+        },
+        {
+          "name": "--lr-flow-run-overlay-status-color",
+          "description": "**`<lr-flow-run-overlay>`** (default: `var(--lr-color-border-strong)`) — Count-dot color when no execution status is set."
+        },
+        {
+          "name": "--lr-flow-run-overlay-status-denied-color",
+          "description": "**`<lr-flow-run-overlay>`** (default: `var(--lr-color-warning)`) — Denied count-dot color."
+        },
+        {
+          "name": "--lr-flow-run-overlay-status-error-color",
+          "description": "**`<lr-flow-run-overlay>`** (default: `var(--lr-color-danger)`) — Error count-dot color."
+        },
+        {
+          "name": "--lr-flow-run-overlay-status-pending-color",
+          "description": "**`<lr-flow-run-overlay>`** (default: `var(--lr-color-border-strong)`) — Pending count-dot color."
+        },
+        {
+          "name": "--lr-flow-run-overlay-status-running-color",
+          "description": "**`<lr-flow-run-overlay>`** (default: `var(--lr-color-brand)`) — Running count-dot color."
+        },
+        {
+          "name": "--lr-flow-run-overlay-status-success-color",
+          "description": "**`<lr-flow-run-overlay>`** (default: `var(--lr-color-success)`) — Success count-dot color."
+        },
         {
           "name": "--lr-gauge-fill",
           "description": "**`<lr-gauge>`** (default: `var(--lr-color-brand)`) — Fill stroke for radial, ring, and linear gauges."
@@ -20003,6 +20121,10 @@
           "name": "--lr-graph-legend-hidden-color",
           "description": "**`<lr-graph-legend>`** (default: `var(--lr-color-text-quiet)`) — Text color for a filtered-out (hidden) legend row's label/count, independent of the shared quiet-text token."
         },
+        {
+          "name": "--lr-graph-legend-hidden-swatch-opacity",
+          "description": "**`<lr-graph-legend>`** (default: `0.5`) — Opacity of a filtered-out row's decorative swatch."
+        },
         {
           "name": "--lr-graph-selected-color",
           "description": "**`<lr-graph>`** (default: `var(--lr-color-success)`) — Selected node/link stroke."
@@ -20243,6 +20365,10 @@
           "name": "--lr-json-viewer-number-color",
           "description": "**`<lr-json-viewer>`** (default: `var(--lr-color-brand)`) — Number value color."
         },
+        {
+          "name": "--lr-json-viewer-row-hover-bg",
+          "description": "**`<lr-json-viewer>`** (default: `var(--lr-color-brand-quiet)`) — Hover background for a structural row."
+        },
         {
           "name": "--lr-json-viewer-string-color",
           "description": "**`<lr-json-viewer>`** (default: `var(--lr-color-success)`) — String value color."
@@ -20529,7 +20655,11 @@
         },
         {
           "name": "--lr-pdf-viewer-height",
-          "description": "**`<lr-pdf-viewer>`** (default: `var(--lr-size-24rem)`) — Block size of the virtualized page list. Also settable via the `max-height` property."
+          "description": "**`<lr-pdf-viewer>`** (default: `var(--lr-size-24rem)`) — Block size of the virtualized page list."
+        },
+        {
+          "name": "--lr-pdf-viewer-toolbar-button-hover-bg",
+          "description": "**`<lr-pdf-viewer>`** (default: `var(--lr-color-surface)`) — Hover fill of the toolbar buttons. Defaults to the surface fill rather than the toolbar's own tint so the hover state is actually visible against it. Also settable via the `max-height` property."
         },
         {
           "name": "--lr-phone-input-control-height",
@@ -20669,7 +20799,7 @@
         },
         {
           "name": "--lr-rating-empty-color",
-          "description": "**`<lr-rating>`** (default: `var(--lr-color-border)`) — Unfilled-star color."
+          "description": "**`<lr-rating>`** (default: `var(--lr-color-border)`) — Unfilled-star color, retained during hover preview."
         },
         {
           "name": "--lr-rating-fill",
@@ -20915,18 +21045,42 @@
           "name": "--lr-source-picker-mixed-bg",
           "description": "**`<lr-source-picker>`** (default: `color-mix(in srgb, var(--lr-color-brand) 50%, var(--lr-color-surface))`) — Background of a partially-selected entry's `[part=\"checkbox\"]`."
         },
+        {
+          "name": "--lr-span-waterfall-denied-color",
+          "description": "**`<lr-span-waterfall>`** (default: `var(--lr-color-warning)`) — Denied bar fill."
+        },
+        {
+          "name": "--lr-span-waterfall-error-color",
+          "description": "**`<lr-span-waterfall>`** (default: `var(--lr-color-danger)`) — Error bar fill."
+        },
         {
           "name": "--lr-span-waterfall-name-width",
           "description": "**`<lr-span-waterfall>`** (default: `8rem`) — Width of the name gutter column."
         },
+        {
+          "name": "--lr-span-waterfall-pending-border-color",
+          "description": "**`<lr-span-waterfall>`** (default: `var(--lr-color-border-strong)`) — Pending bar border."
+        },
         {
           "name": "--lr-span-waterfall-row-active-bg",
           "description": "**`<lr-span-waterfall>`** (default: `var(--lr-color-brand-quiet)`) — Background of the active (`activeSpanId`) row. Shadow Parts forbids an attribute selector after `::part()`, so the active row could otherwise only be restyled by hijacking the library-wide `--lr-color-brand-quiet` token."
         },
+        {
+          "name": "--lr-span-waterfall-running-color",
+          "description": "**`<lr-span-waterfall>`** (default: `var(--lr-color-brand)`) — Running stripe foreground."
+        },
+        {
+          "name": "--lr-span-waterfall-running-stripe-color",
+          "description": "**`<lr-span-waterfall>`** (default: `var(--lr-color-brand-quiet)`) — Running stripe background."
+        },
         {
           "name": "--lr-span-waterfall-stripe-speed",
           "description": "**`<lr-span-waterfall>`** — Animation duration for a `running` span's striped bar; defaults to `--lr-transition-ambient`."
         },
+        {
+          "name": "--lr-span-waterfall-success-color",
+          "description": "**`<lr-span-waterfall>`** (default: `var(--lr-color-success)`) — Success bar fill."
+        },
         {
           "name": "--lr-sparkline-area-opacity",
           "description": "**`<lr-sparkline>`** (default: `0.15`) — Fill opacity of the area under the line (type=\"area\")."
@@ -20963,6 +21117,14 @@
           "name": "--lr-stack-trace-font",
           "description": "**`<lr-stack-trace>`** (default: `var(--lr-font-mono)`) — Font family for the parsed frames and the verbatim raw fallback."
         },
+        {
+          "name": "--lr-stack-trace-interactive-color",
+          "description": "**`<lr-stack-trace>`** (default: `var(--lr-color-brand)`) — Interactive frame/toggle accent."
+        },
+        {
+          "name": "--lr-stack-trace-internal-frame-color",
+          "description": "**`<lr-stack-trace>`** (default: `var(--lr-color-text-quiet)`) — Internal frame foreground."
+        },
         {
           "name": "--lr-stack-trace-max-height",
           "description": "**`<lr-stack-trace>`** (default: `none`) — Cap on how tall `[part=\"base\"]` grows before it scrolls internally. `none` lets the component grow with its content; the `max-height` attribute sets this token."
@@ -20983,6 +21145,18 @@
           "name": "--lr-stat-trend-good-color",
           "description": "**`<lr-stat>`** (default: `var(--lr-color-success)`) — Text color of the trend pill when its polarity is \"good\". Independent of the headline value's `variant=\"success\"` tint, which reads the shared `--lr-color-success` token directly."
         },
+        {
+          "name": "--lr-stat-value-danger-color",
+          "description": "**`<lr-stat>`** (default: `var(--lr-color-danger)`) — Headline value color for the `danger` variant."
+        },
+        {
+          "name": "--lr-stat-value-success-color",
+          "description": "**`<lr-stat>`** (default: `var(--lr-color-success)`) — Headline value color for the `success` variant."
+        },
+        {
+          "name": "--lr-stat-value-warning-color",
+          "description": "**`<lr-stat>`** (default: `var(--lr-color-warning)`) — Headline value color for the `warning` variant."
+        },
         {
           "name": "--lr-stepper-current-color",
           "description": "**`<lr-stepper>`** (default: `var(--lr-color-text)`) — Text color of the `current` step. Declared as an inline `var()` fallback (never on `:host`), so setting it on the element or an ancestor recolors only the current step without hijacking the library-wide `--lr-color-text` token."
@@ -21183,10 +21357,26 @@
           "name": "--lr-task-list-compact-header-padding",
           "description": "**`<lr-task-list>`** (default: `var(--lr-space-2xs) var(--lr-space-s)`) — `[part=\"header\"]` padding while `compact`."
         },
+        {
+          "name": "--lr-task-list-error-color",
+          "description": "**`<lr-task-list>`** (default: `var(--lr-color-danger)`) — Error status icon color."
+        },
+        {
+          "name": "--lr-task-list-pending-color",
+          "description": "**`<lr-task-list>`** (default: `var(--lr-color-text-quiet)`) — Pending status icon color."
+        },
+        {
+          "name": "--lr-task-list-running-color",
+          "description": "**`<lr-task-list>`** (default: `var(--lr-color-brand)`) — Running status icon color."
+        },
         {
           "name": "--lr-task-list-spin",
           "description": "**`<lr-task-list>`** (default: `var(--lr-transition-ambient)`) — Running-status icon spin animation duration/timing."
         },
+        {
+          "name": "--lr-task-list-success-color",
+          "description": "**`<lr-task-list>`** (default: `var(--lr-color-success)`) — Success status icon color."
+        },
         {
           "name": "--lr-terminal-height",
           "description": "**`<lr-terminal>`** (default: `var(--lr-size-20rem)`) — Block size of `[part=\"viewport\"]`, the scrollable log region. Not declared on `:host`, so it is inherited — set it on the host or any ancestor."
@@ -21219,6 +21409,10 @@
           "name": "--lr-terminal-search-outline-color",
           "description": "**`<lr-terminal>`** (default: `var(--lr-color-warning)`) — Outline color for a line containing a non-active search match."
         },
+        {
+          "name": "--lr-test-results-failed-color",
+          "description": "**`<lr-test-results>`** (default: `var(--lr-color-danger)`) — Failed-state foreground."
+        },
         {
           "name": "--lr-test-results-filter-active-bg",
           "description": "**`<lr-test-results>`** (default: `var(--lr-color-brand-quiet)`) — Background of a pressed (active) status filter toggle."
@@ -21231,6 +21425,18 @@
           "name": "--lr-test-results-filter-active-color",
           "description": "**`<lr-test-results>`** (default: `var(--lr-color-brand)`) — Text color of a pressed (active) status filter toggle. Restyling the pressed state otherwise requires overriding the library-wide brand tokens, since `::part(filter-toggle)[aria-pressed]` is invalid CSS."
         },
+        {
+          "name": "--lr-test-results-passed-color",
+          "description": "**`<lr-test-results>`** (default: `var(--lr-color-success)`) — Passed-state foreground."
+        },
+        {
+          "name": "--lr-test-results-running-color",
+          "description": "**`<lr-test-results>`** (default: `var(--lr-color-brand)`) — Running-state foreground."
+        },
+        {
+          "name": "--lr-test-results-skipped-color",
+          "description": "**`<lr-test-results>`** (default: `var(--lr-color-text-quiet)`) — Skipped-state foreground."
+        },
         {
           "name": "--lr-textarea-max-block-size",
           "description": "**`<lr-textarea>`** (default: `none`) — Maximum auto-grown block size before the textarea scrolls."
@@ -21239,6 +21445,10 @@
           "name": "--lr-thinking-panel-max-block-size",
           "description": "**`<lr-thinking-panel>`** (default: `var(--lr-size-16rem)`) — Cap on how tall the expanded reasoning transcript grows before `[part=\"body\"]` scrolls internally."
         },
+        {
+          "name": "--lr-thinking-panel-pending-color",
+          "description": "**`<lr-thinking-panel>`** (default: `var(--lr-color-brand)`) — Live pending-state color."
+        },
         {
           "name": "--lr-thread-list-excerpt-highlight-background",
           "description": "**`<lr-thread-list>`** (default: `var(--lr-color-warning-quiet)`) — Background of `<mark>` descendants returned by `renderExcerpt`."
@@ -21639,6 +21849,46 @@
           "name": "--lr-transition-ambient",
           "description": "**`<lr-chat-message>`** (default: `1.8s ease-in-out`) — Streaming-indicator animation duration and timing function.\n\n**`<lr-skeleton>`** (default: `1.8s ease-in-out`) — Animation duration and timing function shared by the pulse and sheen effects.\n\n**`<lr-tool-call-chip>`** (default: `1.8s ease-in-out`) — Pending-icon pulse duration and timing."
         },
+        {
+          "name": "--lr-tree-badge-brand-bg",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-brand-quiet)`) — Brand badge background."
+        },
+        {
+          "name": "--lr-tree-badge-brand-color",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-brand)`) — Brand badge text color."
+        },
+        {
+          "name": "--lr-tree-badge-danger-bg",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-danger-quiet)`) — Danger badge background."
+        },
+        {
+          "name": "--lr-tree-badge-danger-color",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-danger)`) — Danger badge text color."
+        },
+        {
+          "name": "--lr-tree-badge-neutral-bg",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-surface)`) — Neutral badge background."
+        },
+        {
+          "name": "--lr-tree-badge-neutral-color",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-text-quiet)`) — Neutral badge text color."
+        },
+        {
+          "name": "--lr-tree-badge-success-bg",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-success-quiet)`) — Success badge background."
+        },
+        {
+          "name": "--lr-tree-badge-success-color",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-success)`) — Success badge text color."
+        },
+        {
+          "name": "--lr-tree-badge-warning-bg",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-warning-quiet)`) — Warning badge background."
+        },
+        {
+          "name": "--lr-tree-badge-warning-color",
+          "description": "**`<lr-tree-node>`** (default: `var(--lr-color-warning)`) — Warning badge text color."
+        },
         {
           "name": "--lr-tree-depth",
           "description": "**`<lr-tree-node>`** (default: `0`) — Internal indent plumbing, not a retheming knob: this node's `depth`, written inline onto `[part=\"row\"]` by the component and multiplied by `--lr-space-l` (capped at `--lr-size-8rem`) to produce the row's `padding-inline-start`."