@aceshooting/lyra-ui 2.4.0 → 2.6.0

package/custom-elements.json

@@ -2337,7 +2337,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Overrides the single-capability trigger button's `aria-label`, which\notherwise comes from `CAPABILITY_META[capability].triggerLabel` (e.g.\n`'Attach files'`). Set this to localize the accessible name; leave it\nunset to keep the built-in English default. Only affects the\nsingle-capability button ([part='trigger']) — the multi-capability\nmenu's own trigger keeps its fixed `'Add attachment'` label regardless.",
+              "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.",
               "attribute": "trigger-label"
             },
             {
@@ -2621,7 +2621,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Overrides the single-capability trigger button's `aria-label`, which\notherwise comes from `CAPABILITY_META[capability].triggerLabel` (e.g.\n`'Attach files'`). Set this to localize the accessible name; leave it\nunset to keep the built-in English default. Only affects the\nsingle-capability button ([part='trigger']) — the multi-capability\nmenu's own trigger keeps its fixed `'Add attachment'` label regardless.",
+              "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.",
               "fieldName": "triggerLabel"
             },
             {
@@ -2681,7 +2681,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-avatar>` — a small, fixed-size identity marker: an image, or an initials fallback when\nno image is set (or the image fails to load). First-party invention (no Web Awesome\nequivalent) -- purely presentational, no built-in interactivity; a consumer wraps it in their\nown `<button>`/`<lyra-menu>` trigger for a user-menu affordance.",
+          "description": "`<lyra-avatar>` — a small, fixed-size identity marker: default-slotted icon/glyph content, an\nimage, or an initials fallback, in that priority order (whichever's set takes over from the\nnext). First-party invention (no Web Awesome equivalent) -- purely presentational, no built-in\ninteractivity; a consumer wraps it in their own `<button>`/`<lyra-menu>` trigger for a\nuser-menu affordance.",
           "name": "LyraAvatar",
           "cssParts": [
             {
@@ -2689,14 +2689,24 @@
               "name": "base"
             },
             {
-              "description": "The `<img>`, only rendered while `src` is set and has not failed to load.",
+              "description": "Wrapper around the default-slotted icon/glyph content. Only rendered while the slot has assigned content.",
+              "name": "icon"
+            },
+            {
+              "description": "The `<img>`, only rendered while `src` is set and has not failed to load (and no icon content is slotted).",
               "name": "image"
             },
             {
-              "description": "The fallback initials text, rendered whenever `image` isn't.",
+              "description": "The fallback initials text, rendered whenever neither slotted content nor `image` is.",
               "name": "initials"
             }
           ],
+          "slots": [
+            {
+              "description": "Icon/glyph content (e.g. an inline SVG) shown in place of the image/initials, e.g. to mark a chat message avatar as \"AI\" vs. \"user\" with a role glyph instead of a photo or initials. Takes priority over both `src` and `initials`. The glyph itself is treated as decorative (`aria-hidden`); set `alt` alongside it for an accessible name.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
@@ -2705,7 +2715,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Image alt text -- required alongside `src` for accessibility.",
+              "description": "Alt text -- required alongside `src` for accessibility, and also used as the accessible\nname (via `aria-label`) when showing icon-only slotted content, since a decorative glyph\nhas no text of its own for a screen reader to read.",
               "attribute": "alt"
             },
             {
@@ -2736,6 +2746,15 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "hasIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "imageFailed",
@@ -2752,7 +2771,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Fallback text (typically 1-2 characters) shown when no image is set, or the image fails to\nload.",
+              "description": "Fallback text (typically 1-2 characters) shown when no icon/image is set, or the image\nfails to load.",
               "attribute": "initials"
             },
             {
@@ -2770,6 +2789,11 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "onIconSlotChange",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "onImageError",
@@ -2793,7 +2817,7 @@
                 "text": "AvatarSize"
               },
               "default": "'md'",
-              "description": "Visual size. `'md'` (the default) matches `--lyra-icon-button-size` (2.5rem).",
+              "description": "Visual size. `'lg'` matches `--lyra-icon-button-size` (2.5rem); `'md'` (the default) is 2rem.",
               "attribute": "size",
               "reflects": true
             },
@@ -2803,7 +2827,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Image URL. Takes priority over `initials` when set and loads successfully; falls back to\n`initials` on a load error.",
+              "description": "Image URL. Takes priority over `initials` when set and loads successfully (but not over\nslotted icon content); falls back to `initials` on a load error.",
               "attribute": "src"
             },
             {
@@ -2992,7 +3016,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Image alt text -- required alongside `src` for accessibility.",
+              "description": "Alt text -- required alongside `src` for accessibility, and also used as the accessible\nname (via `aria-label`) when showing icon-only slotted content, since a decorative glyph\nhas no text of its own for a screen reader to read.",
               "fieldName": "alt"
             },
             {
@@ -3001,7 +3025,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Fallback text (typically 1-2 characters) shown when no image is set, or the image fails to\nload.",
+              "description": "Fallback text (typically 1-2 characters) shown when no icon/image is set, or the image\nfails to load.",
               "fieldName": "initials"
             },
             {
@@ -3032,7 +3056,7 @@
                 "text": "AvatarSize"
               },
               "default": "'md'",
-              "description": "Visual size. `'md'` (the default) matches `--lyra-icon-button-size` (2.5rem).",
+              "description": "Visual size. `'lg'` matches `--lyra-icon-button-size` (2.5rem); `'md'` (the default) is 2rem.",
               "fieldName": "size"
             },
             {
@@ -3040,7 +3064,7 @@
               "type": {
                 "text": "string | undefined"
               },
-              "description": "Image URL. Takes priority over `initials` when set and loads successfully; falls back to\n`initials` on a load error.",
+              "description": "Image URL. Takes priority over `initials` when set and loads successfully (but not over\nslotted icon content); falls back to `initials` on a load error.",
               "fieldName": "src"
             },
             {
@@ -8591,7 +8615,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'Frequency'",
+              "default": "''",
+              "description": "Dataset label used for the legend/tooltip/accessible summary. Falls back to a localized \"Frequency\" when unset.",
               "attribute": "label"
             },
             {
@@ -9256,7 +9281,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'Frequency'",
+              "default": "''",
+              "description": "Dataset label used for the legend/tooltip/accessible summary. Falls back to a localized \"Frequency\" when unset.",
               "fieldName": "label"
             },
             {
@@ -10643,6 +10669,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "accessibleLabel",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Overrides the `<svg>`'s auto-derived `aria-label` (`datasets.map(d => d.label).join(', ') ||\n'Chart'`) — for a consumer with a real, localized chart description. Unset (the default)\nkeeps today's auto-derived (English-fallback) label exactly. Named `accessible-label` to\nmatch the same override on `lyra-chart`/`lyra-box-plot`.",
+              "attribute": "accessible-label"
+            },
             {
               "kind": "field",
               "name": "activeMarkIndex",
@@ -10689,15 +10724,6 @@
               "default": "true",
               "attribute": "begin-at-zero"
             },
-            {
-              "kind": "field",
-              "name": "chartLabel",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Overrides the `<svg>`'s auto-derived `aria-label` (`datasets.map(d => d.label).join(', ') ||\n'Chart'`) — for a consumer with a real, localized chart description. Unset (the default)\nkeeps today's auto-derived (English-fallback) label exactly.",
-              "attribute": "chart-label"
-            },
             {
               "kind": "field",
               "name": "datasets",
@@ -10791,12 +10817,11 @@
             },
             {
               "kind": "field",
-              "name": "liveText",
+              "name": "liveRegion",
               "type": {
-                "text": "string"
+                "text": "LyraLiveRegion | undefined"
               },
-              "privacy": "private",
-              "default": "''"
+              "privacy": "private"
             },
             {
               "kind": "field",
@@ -11610,6 +11635,14 @@
             }
           ],
           "attributes": [
+            {
+              "name": "accessible-label",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Overrides the `<svg>`'s auto-derived `aria-label` (`datasets.map(d => d.label).join(', ') ||\n'Chart'`) — for a consumer with a real, localized chart description. Unset (the default)\nkeeps today's auto-derived (English-fallback) label exactly. Named `accessible-label` to\nmatch the same override on `lyra-chart`/`lyra-box-plot`.",
+              "fieldName": "accessibleLabel"
+            },
             {
               "name": "bar-gap-ratio",
               "type": {
@@ -11635,14 +11668,6 @@
               "default": "true",
               "fieldName": "beginAtZero"
             },
-            {
-              "name": "chart-label",
-              "type": {
-                "text": "string | undefined"
-              },
-              "description": "Overrides the `<svg>`'s auto-derived `aria-label` (`datasets.map(d => d.label).join(', ') ||\n'Chart'`) — for a consumer with a real, localized chart description. Unset (the default)\nkeeps today's auto-derived (English-fallback) label exactly.",
-              "fieldName": "chartLabel"
-            },
             {
               "name": "height",
               "type": {
@@ -16805,7 +16830,7 @@
               "name": "actions"
             },
             {
-              "description": "File/image attachment chips, rendered below the message body.",
+              "description": "File/image attachment chips, rendered below the message body by default; see `attachments-position`.",
               "name": "attachments"
             },
             {
@@ -16827,6 +16852,16 @@
               "privacy": "private",
               "default": "'sent'"
             },
+            {
+              "kind": "field",
+              "name": "attachmentsPosition",
+              "type": {
+                "text": "'before' | 'after'"
+              },
+              "default": "'after'",
+              "description": "Where the `attachments` slot renders relative to the message body.\n`'after'` (the default) reproduces today's exact DOM order. `'before'`\nrenders attachments immediately above the body -- both DOM and visual\norder move together (no CSS `order` trick), so reading/focus order\nalways matches what's on screen.",
+              "attribute": "attachments-position"
+            },
             {
               "kind": "field",
               "name": "bodyId",
@@ -17271,6 +17306,15 @@
             }
           ],
           "attributes": [
+            {
+              "name": "attachments-position",
+              "type": {
+                "text": "'before' | 'after'"
+              },
+              "default": "'after'",
+              "description": "Where the `attachments` slot renders relative to the message body.\n`'after'` (the default) reproduces today's exact DOM order. `'before'`\nrenders attachments immediately above the body -- both DOM and visual\norder move together (no CSS `order` trick), so reading/focus order\nalways matches what's on screen.",
+              "fieldName": "attachmentsPosition"
+            },
             {
               "name": "collapsed",
               "type": {
@@ -18601,7 +18645,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Opt-in toggle/pressed mode -- when set, `[part='base']` itself becomes focusable and\nkeyboard-activatable (Enter/Space, mirroring native `<button>` behavior), reflects\n`aria-pressed`, and toggles on click/activation, emitting `lyra-chip-select`. Has no effect\n(no interactive semantics added to `[part='base']`) when combined with `removable`, since the\nremove button already nests inside `[part='base']` -- axe-core's `nested-interactive` rule\nforbids a focusable descendant of a `role=\"button\"` ancestor, and this component's two real\nuse cases (a chart-series visibility toggle, a category filter chip) never need both at once.\n`false` (the default) reproduces today's exact passive-label-pill output.",
+              "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`<lyra-chip selected>` alone is enough: `[part='base']` becomes focusable and\nkeyboard-activatable (Enter/Space, mirroring native `<button>` behavior), reflects\n`aria-pressed`, and toggles on click/activation, emitting `lyra-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 (no interactive semantics added to\n`[part='base']`) when combined with `removable`, since the remove button already nests inside\n`[part='base']` -- axe-core's `nested-interactive` rule forbids a focusable descendant of a\n`role=\"button\"` ancestor, and this 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.",
               "attribute": "selected",
               "reflects": true
             },
@@ -18630,6 +18674,17 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "toggleable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Explicit opt-in into `selected`'s toggle/pressed interactive mode, independent of the\n*current* value of `selected`. Setting `selected` to `true` at any point opts in\nautomatically (see its doc comment) and keeps this `true` from then on, which is enough for\na chip that starts already pressed. Set `toggleable` directly for a chip that must be\nclickable from the outset while starting **unselected** -- e.g. an initially-inactive\ncategory filter chip -- since `selected`'s own default (`false`) can't be distinguished from\n\"never opted in\" on its own.",
+              "attribute": "toggleable",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "tone",
@@ -18795,7 +18850,7 @@
           ],
           "events": [
             {
-              "description": "Fired on click, or Enter/Space while focused, when `selected` mode is active (and `removable` is not set). `detail: { value, selected }` -- the chip has already toggled its own `selected` state by the time this fires.",
+              "description": "Fired on click, or Enter/Space while focused, once the chip has opted into toggle mode (via `selected` or `toggleable`) and `removable` is not set. `detail: { value, selected }` -- the chip has already toggled its own `selected` state by the time this fires.",
               "name": "lyra-chip-select"
             },
             {
@@ -18832,9 +18887,18 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Opt-in toggle/pressed mode -- when set, `[part='base']` itself becomes focusable and\nkeyboard-activatable (Enter/Space, mirroring native `<button>` behavior), reflects\n`aria-pressed`, and toggles on click/activation, emitting `lyra-chip-select`. Has no effect\n(no interactive semantics added to `[part='base']`) when combined with `removable`, since the\nremove button already nests inside `[part='base']` -- axe-core's `nested-interactive` rule\nforbids a focusable descendant of a `role=\"button\"` ancestor, and this component's two real\nuse cases (a chart-series visibility toggle, a category filter chip) never need both at once.\n`false` (the default) reproduces today's exact passive-label-pill output.",
+              "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`<lyra-chip selected>` alone is enough: `[part='base']` becomes focusable and\nkeyboard-activatable (Enter/Space, mirroring native `<button>` behavior), reflects\n`aria-pressed`, and toggles on click/activation, emitting `lyra-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 (no interactive semantics added to\n`[part='base']`) when combined with `removable`, since the remove button already nests inside\n`[part='base']` -- axe-core's `nested-interactive` rule forbids a focusable descendant of a\n`role=\"button\"` ancestor, and this 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.",
               "fieldName": "selected"
             },
+            {
+              "name": "toggleable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Explicit opt-in into `selected`'s toggle/pressed interactive mode, independent of the\n*current* value of `selected`. Setting `selected` to `true` at any point opts in\nautomatically (see its doc comment) and keeps this `true` from then on, which is enough for\na chip that starts already pressed. Set `toggleable` directly for a chip that must be\nclickable from the outset while starting **unselected** -- e.g. an initially-inactive\ncategory filter chip -- since `selected`'s own default (`false`) can't be distinguished from\n\"never opted in\" on its own.",
+              "fieldName": "toggleable"
+            },
             {
               "name": "tone",
               "type": {
@@ -20075,6 +20139,116 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/code-block/code-block-shared.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "codeBlockBodyLabel",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "localize",
+              "type": {
+                "text": "LyraLocalizeFn"
+              }
+            },
+            {
+              "name": "filename",
+              "type": {
+                "text": "string"
+              }
+            },
+            {
+              "name": "language",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "The `[part=\"body\"]` region's `aria-label`: the filename when set, else a\nlanguage-aware \"Code\" region label."
+        },
+        {
+          "kind": "function",
+          "name": "codeBlockCopyLabel",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "localize",
+              "type": {
+                "text": "LyraLocalizeFn"
+              }
+            },
+            {
+              "name": "justCopied",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "description": "The copy-to-clipboard header button's `aria-label`."
+        },
+        {
+          "kind": "function",
+          "name": "codeBlockToggleLabel",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "localize",
+              "type": {
+                "text": "LyraLocalizeFn"
+              }
+            },
+            {
+              "name": "collapsed",
+              "type": {
+                "text": "boolean"
+              }
+            }
+          ],
+          "description": "The collapse/expand header toggle button's `aria-label`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "codeBlockBodyLabel",
+          "declaration": {
+            "name": "codeBlockBodyLabel",
+            "module": "src/components/code-block/code-block-shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "codeBlockCopyLabel",
+          "declaration": {
+            "name": "codeBlockCopyLabel",
+            "module": "src/components/code-block/code-block-shared.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "codeBlockToggleLabel",
+          "declaration": {
+            "name": "codeBlockToggleLabel",
+            "module": "src/components/code-block/code-block-shared.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/code-block/code-block.class.ts",
@@ -21148,7 +21322,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'No results'",
+              "default": "''",
+              "description": "Status copy shown in the listbox when no rows match. Empty string falls back to a localized message.",
               "attribute": "empty-text"
             },
             {
@@ -21280,8 +21455,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'Loading…'",
-              "description": "Status copy shown in the listbox while a `source` fetch is in flight.",
+              "default": "''",
+              "description": "Status copy shown in the listbox while a `source` fetch is in flight. Empty string falls back to a localized message.",
               "attribute": "loading-text"
             },
             {
@@ -21417,8 +21592,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'+{n} more — refine your search'",
-              "description": "Status copy shown when `maxRender` caps the row list; `{n}` is replaced with the hidden count.",
+              "default": "''",
+              "description": "Status copy shown when `maxRender` caps the row list; `{n}` is replaced with the hidden count. Empty string falls back to a localized message.",
               "attribute": "overflow-text"
             },
             {
@@ -21990,7 +22165,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'No results'",
+              "default": "''",
+              "description": "Status copy shown in the listbox when no rows match. Empty string falls back to a localized message.",
               "fieldName": "emptyText"
             },
             {
@@ -22022,8 +22198,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'Loading…'",
-              "description": "Status copy shown in the listbox while a `source` fetch is in flight.",
+              "default": "''",
+              "description": "Status copy shown in the listbox while a `source` fetch is in flight. Empty string falls back to a localized message.",
               "fieldName": "loadingText"
             },
             {
@@ -22082,8 +22258,8 @@
               "type": {
                 "text": "string"
               },
-              "default": "'+{n} more — refine your search'",
-              "description": "Status copy shown when `maxRender` caps the row list; `{n}` is replaced with the hidden count.",
+              "default": "''",
+              "description": "Status copy shown when `maxRender` caps the row list; `{n}` is replaced with the hidden count. Empty string falls back to a localized message.",
               "fieldName": "overflowText"
             },
             {
@@ -22615,6 +22791,16 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "clampedUsedTotal",
+              "type": {
+                "text": "{ used: number; total: number }"
+              },
+              "privacy": "private",
+              "description": "`usedTotal` and `total`, both clamped the same way ratios() clamps the\nvisual fill -- a segments array that sums past total must not report an\nimpossible \"160 of 100 used\"/aria-valuenow > aria-valuemax while the\nbar/ring visibly caps at 100%. Shared by `summary` and `willUpdate`'s\naria-value* trio so the announced text and the queryable numeric value\ncan never diverge.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "effectiveDirection",
@@ -24496,7 +24682,7 @@
                 "text": "string"
               },
               "default": "'Choose date'",
-              "description": "Accessible name for the calendar popover dialog. Override for a non-English `locale`.",
+              "description": "Accessible name for the calendar popover dialog. Left at the built-in default it\nroutes through `this.localize()` so a locale/`.strings` override applies without\nrequiring this to be set; an explicit override wins verbatim.",
               "attribute": "dialog-label"
             },
             {
@@ -25291,7 +25477,7 @@
                 "text": "string"
               },
               "default": "'Choose date'",
-              "description": "Accessible name for the calendar popover dialog. Override for a non-English `locale`.",
+              "description": "Accessible name for the calendar popover dialog. Left at the built-in default it\nroutes through `this.localize()` so a locale/`.strings` override applies without\nrequiring this to be set; an explicit override wins verbatim.",
               "fieldName": "dialogLabel"
             },
             {
@@ -25738,7 +25924,7 @@
                 "text": "string"
               },
               "default": "'Next month'",
-              "description": "Accessible label for the next-month button. Override for a non-English `locale`.",
+              "description": "Accessible label for the next-month button. Left at the built-in default it\nroutes through `this.localize()` so a locale/`.strings` override applies without\nrequiring this to be set; an explicit override wins verbatim.",
               "attribute": "next-label"
             },
             {
@@ -25753,7 +25939,7 @@
                 "text": "string"
               },
               "default": "'Previous month'",
-              "description": "Accessible label for the previous-month button. Override for a non-English `locale`.",
+              "description": "Accessible label for the previous-month button. Left at the built-in default it\nroutes through `this.localize()` so a locale/`.strings` override applies without\nrequiring this to be set; an explicit override wins verbatim.",
               "attribute": "previous-label"
             },
             {
@@ -26515,7 +26701,7 @@
                 "text": "string"
               },
               "default": "'Next month'",
-              "description": "Accessible label for the next-month button. Override for a non-English `locale`.",
+              "description": "Accessible label for the next-month button. Left at the built-in default it\nroutes through `this.localize()` so a locale/`.strings` override applies without\nrequiring this to be set; an explicit override wins verbatim.",
               "fieldName": "nextLabel"
             },
             {
@@ -26524,7 +26710,7 @@
                 "text": "string"
               },
               "default": "'Previous month'",
-              "description": "Accessible label for the previous-month button. Override for a non-English `locale`.",
+              "description": "Accessible label for the previous-month button. Left at the built-in default it\nroutes through `this.localize()` so a locale/`.strings` override applies without\nrequiring this to be set; an explicit override wins verbatim.",
               "fieldName": "previousLabel"
             },
             {
@@ -27235,6 +27421,14 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "copyTimeoutId",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "copyable",
@@ -27273,6 +27467,15 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "justCopied",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "locale",
@@ -29397,6 +29600,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "_isFirstUpdate",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "true"
+            },
             {
               "kind": "field",
               "name": "cleanup",
@@ -29438,6 +29650,16 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "effectiveLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Resolves `label`'s effective text: an explicit override wins verbatim; left at the\nbuilt-in default it instead routes through `this.localize()` so a locale/`.strings`\noverride applies without requiring `label` itself to be set.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "effectiveLocale",
@@ -29476,7 +29698,7 @@
                 "text": "string"
               },
               "default": "'Export'",
-              "description": "Trigger button text, also feeds the format menu's `aria-label` (as\n\"`${label} format`\") so assistive tech gets an accessible name for it.",
+              "description": "Trigger button text, also feeds the format menu's `aria-label` (as\n\"`${label} format`\") so assistive tech gets an accessible name for it.\nLeft at its default English `'Export'`, the rendered text instead\ncomes from `this.localize('exportButtonLabel', ...)` -- override-able\nvia `.strings`/`registerLyraLocale()` -- same convention as\n`lyra-attachment-chip`'s `removeLabel`/`retryLabel`. Set this\nattribute explicitly for a one-off override that always wins.",
               "attribute": "label"
             },
             {
@@ -29848,6 +30070,14 @@
             {
               "description": "Fired after a non-cancelled download completes.",
               "name": "lyra-export-complete"
+            },
+            {
+              "description": "The format menu closed. Same first-render guard as `lyra-show`.",
+              "name": "lyra-hide"
+            },
+            {
+              "description": "The format menu opened. Not fired for markup that renders open from the start.",
+              "name": "lyra-show"
             }
           ],
           "attributes": [
@@ -29873,7 +30103,7 @@
                 "text": "string"
               },
               "default": "'Export'",
-              "description": "Trigger button text, also feeds the format menu's `aria-label` (as\n\"`${label} format`\") so assistive tech gets an accessible name for it.",
+              "description": "Trigger button text, also feeds the format menu's `aria-label` (as\n\"`${label} format`\") so assistive tech gets an accessible name for it.\nLeft at its default English `'Export'`, the rendered text instead\ncomes from `this.localize('exportButtonLabel', ...)` -- override-able\nvia `.strings`/`registerLyraLocale()` -- same convention as\n`lyra-attachment-chip`'s `removeLabel`/`retryLabel`. Set this\nattribute explicitly for a one-off override that always wins.",
               "fieldName": "label"
             },
             {
@@ -30082,6 +30312,16 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "effectiveLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Resolves `label`'s effective text: an explicit override wins verbatim; left at the\nbuilt-in default it instead routes through `this.localize()` so a locale/`.strings`\noverride applies without requiring `label` itself to be set.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "effectiveLocale",
@@ -32197,6 +32437,10 @@
               "description": "A visually hidden list alternative for graph data.",
               "name": "data-list"
             },
+            {
+              "description": "The empty-state message, shown when `nodes` is empty.",
+              "name": "empty"
+            },
             {
               "description": "A node label.",
               "name": "label"
@@ -32771,7 +33015,8 @@
                     "text": "() => void"
                   }
                 }
-              ]
+              ],
+              "description": "The forward physical arrow key (`ArrowRight` in LTR, `ArrowLeft` under\n`dir=\"rtl\"` — see `isRtl()`) moves to the next roving-tabindex item, the\nbackward one to the previous, in flat array order (`simNodes` then\n`simLinks`) — the same `forwardKey`/`backwardKey` swap this library's\nother \"physical arrow key drives sequential previous/next\" components\n(`<lyra-tabs>`, `<lyra-slider>`, `<lyra-segmented>`) apply under RTL.\n`ArrowDown`/`ArrowUp` always mean next/previous regardless of direction."
             },
             {
               "kind": "method",
@@ -33388,13 +33633,20 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "canvasColorCache",
+              "privacy": "private",
+              "default": "new Map<string, string>()",
+              "description": "Cache of resolved colors for the current draw pass, cleared at the top\nof drawCalendar()/drawMatrix() so a theme change is always picked up on\nthe very next full redraw, while repeated identical cellColor() outputs\nwithin the same pass resolve only once."
+            },
             {
               "kind": "field",
               "name": "cellColor",
               "type": {
                 "text": "(pos: MatrixCellPos | CalendarCellPos, value: number) => string | undefined | undefined"
               },
-              "description": "Overrides a cell's computed ramp/no-data color entirely for an exact value -- receives the\ncell position (`MatrixCellPos` in matrix mode, `CalendarCellPos` in calendar mode) and its\nvalue, return a CSS color string to force that cell to it, or `undefined` to fall back to the\nnormal `colorSteps`/ramp math unchanged. Lets a consumer designate a value as categorically\noutside the ramp (e.g. a real zero-count day rendered as a neutral hairline, distinct from\nboth \"no data\" and the ramp's own lightest step) without a prepended synthetic ramp color,\nwhich can't safely reserve an exact value on a skewed dataset (the bucket selectors round by\ncontinuous ratio, with no equality-based reservation). Unset (the default) reproduces today's\nexact ramp/no-data behavior for every cell."
+              "description": "Overrides a cell's computed ramp/no-data color entirely for an exact value -- receives the\ncell position (`MatrixCellPos` in matrix mode, `CalendarCellPos` in calendar mode) and its\nvalue, return a CSS color string to force that cell to it, or `undefined` to fall back to the\nnormal `colorSteps`/ramp math unchanged. Lets a consumer designate a value as categorically\noutside the ramp (e.g. a real zero-count day rendered as a neutral hairline, distinct from\nboth \"no data\" and the ramp's own lightest step) without a prepended synthetic ramp color,\nwhich can't safely reserve an exact value on a skewed dataset (the bucket selectors round by\ncontinuous ratio, with no equality-based reservation). Unset (the default) reproduces today's\nexact ramp/no-data behavior for every cell. A returned value containing a CSS custom property\n(e.g. `var(--x)`) or other browser-resolvable color syntax (e.g. `color-mix(...)`) is\nautomatically resolved before being used as a canvas fill color."
             },
             {
               "kind": "field",
@@ -33429,6 +33681,14 @@
               },
               "default": "[]"
             },
+            {
+              "kind": "field",
+              "name": "colorProbe",
+              "type": {
+                "text": "HTMLSpanElement | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "colorSchemeQuery",
@@ -33712,6 +33972,14 @@
               },
               "default": "[]"
             },
+            {
+              "kind": "field",
+              "name": "weekdayLabelText",
+              "type": {
+                "text": "(jsWeekday: number) => string | undefined | undefined"
+              },
+              "description": "Overrides the weekday-axis label text in calendar mode -- receives the real JS weekday index\n(`0` Sunday .. `6` Saturday) for a row that would otherwise render a label (today, only rows\n1/3/5 relative to `firstDayOfWeek` ever do) and, when it returns a string, uses it instead of\nthe built-in `Intl.DateTimeFormat`-derived short weekday name. Unset (the default) reproduces\ntoday's exact locale-derived output."
+            },
             {
               "kind": "method",
               "name": "addEventListener",
@@ -34421,6 +34689,25 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "resolveCanvasColor",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Resolves a cellColor() return value that may contain a CSS custom\nproperty (or any other CSS color syntax the browser understands, e.g.\ncolor-mix()) into a literal color canvas's fillStyle can actually use --\nfillStyle silently no-ops on an unparseable string, per the Canvas 2D\nspec, leaving whatever the previous cell painted. Falls back to\nnoDataFill() for a genuinely invalid color."
+            },
             {
               "kind": "method",
               "name": "resolveCellText",
@@ -34614,7 +34901,7 @@
                   }
                 }
               ],
-              "description": "Locale-derived weekday-axis labels for the 7 rows drawn down the left of\nthe calendar grid. Only indices 1, 3, and 5 (relative to `firstWeekStart`)\nare filled in — matching today's sparse every-other-day label density —\nthe rest stay blank. `firstWeekStart` is always the UTC\n`firstDayOfWeek`-weekday by construction (see `buildCalendarGrid()`), so\nweekday index 0..6 is a fixed positional mapping relative to it (with the\ndefault `firstDayOfWeek` of 0, that's the original Sun..Sat mapping,\nunchanged); only the label *text* for indices 1/3/5 is derived here, via\n`Intl.DateTimeFormat` on a real UTC date that actually falls on that\nweekday, so it follows the runtime locale instead of a hardcoded English\narray (see `calendarCellText()`'s tooltip text for the same pattern)."
+              "description": "Locale-derived weekday-axis labels for the 7 rows drawn down the left of\nthe calendar grid. The labeled weekdays are always Monday, Wednesday, and\nFriday — matching today's sparse every-other-day label density — the\nrest stay blank. Which *row* each one lands on depends on\n`firstDayOfWeek`, since `buildCalendarGrid()` anchors `firstWeekStart`\n(and therefore row 0) at that weekday. For each target weekday (using\nthe standard JS convention, Sunday=0..Saturday=6, so Monday=1,\nWednesday=3, Friday=5), the row is `(weekday - firstDayOfWeek + 7) % 7`;\nwith the default `firstDayOfWeek` of 0 this reduces to rows 1/3/5,\nunchanged. The label *text* for each computed row is derived via\n`Intl.DateTimeFormat` on a real UTC date that actually falls on that row,\nso it follows the runtime locale instead of a hardcoded English array\n(see `calendarCellText()`'s tooltip text for the same pattern)."
             }
           ],
           "events": [
@@ -35810,6 +36097,13 @@
               "type": {
                 "text": "boolean"
               }
+            },
+            {
+              "name": "localize",
+              "optional": true,
+              "type": {
+                "text": "KbdLocalize"
+              }
             }
           ],
           "description": "Splits a `keys` string (e.g. `'mod+shift+p'`) into its resolved token\nlabels, dropping empty segments from stray/leading/trailing `+`s."
@@ -35834,9 +36128,16 @@
               "type": {
                 "text": "boolean"
               }
+            },
+            {
+              "name": "localize",
+              "optional": true,
+              "type": {
+                "text": "KbdLocalize"
+              }
             }
           ],
-          "description": "Resolves one `+`-separated token of a `keys` string to its rendered glyph\nand spelled-out word, given whether the shortcut is being shown on macOS.\n\nExported as a pure function (parameterized on `isMac` rather than reading\nthe module-scope platform constant directly) so both the macOS and\nnon-macOS branches are directly unit-testable without having to spoof\n`navigator` in a browser test environment that only ever runs as one\nplatform."
+          "description": "Resolves one `+`-separated token of a `keys` string to its rendered glyph\nand spelled-out word, given whether the shortcut is being shown on macOS.\n\nExported as a pure function (parameterized on `isMac` rather than reading\nthe module-scope platform constant directly) so both the macOS and\nnon-macOS branches are directly unit-testable without having to spoof\n`navigator` in a browser test environment that only ever runs as one\nplatform. `localize`, likewise, is an optional parameter (rather than this\nfunction reaching for a component instance's `this.localize()` itself) for\nthe same reason -- every existing 2-arg call keeps returning the literal\nbuilt-in English defaults unchanged; only `<lyra-kbd>`'s own `render()`\npasses one, bound to `this.localize()`."
         }
       ],
       "exports": [
@@ -36490,6 +36791,16 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the map region, applied as `[part=\"base\"]`'s `aria-label` so\nscreen-reader users get a description of an otherwise purely visual control.\nEmpty (the default) falls back to the localized `'map'` message.",
+              "attribute": "label"
+            },
             {
               "kind": "field",
               "name": "legend",
@@ -36791,6 +37102,15 @@
               "default": "[0, 0]",
               "fieldName": "center"
             },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name for the map region, applied as `[part=\"base\"]`'s `aria-label` so\nscreen-reader users get a description of an otherwise purely visual control.\nEmpty (the default) falls back to the localized `'map'` message.",
+              "fieldName": "label"
+            },
             {
               "name": "locale",
               "type": {
@@ -36962,10 +37282,22 @@
               "description": "Every rendered `<img>`.",
               "name": "img"
             },
+            {
+              "description": "Every rendered inline `<code>` span (backtick spans, not fenced blocks).",
+              "name": "inline-code"
+            },
             {
               "description": "Every rendered `<a>`.",
               "name": "link"
             },
+            {
+              "description": "Every rendered `<ul>`/`<ol>`.",
+              "name": "list"
+            },
+            {
+              "description": "Every rendered `<p>`.",
+              "name": "paragraph"
+            },
             {
               "description": "Every rendered `<table>`.",
               "name": "table"
@@ -38190,6 +38522,26 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "effectiveEmptyText",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Resolves `emptyText`'s effective text: an explicit override wins verbatim; left at the\nbuilt-in default it instead routes through `this.localize()` so a locale/`.strings`\noverride applies without requiring `emptyText` itself to be set.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "effectiveLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Resolves `label`'s effective text: an explicit override wins verbatim; left at the\nbuilt-in default it instead routes through `this.localize()` so a locale/`.strings`\noverride applies without requiring `label` itself to be set.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "effectiveLocale",
@@ -39152,7 +39504,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-menu>` — an anchored dropdown of `<lyra-menu-item>` actions, opened\nfrom a consumer-supplied trigger (typically an icon button). A close, drop-\nin-shaped replacement for reaching outside this library for a third-party\ndropdown to build a gear menu, an avatar menu, or a history row's overflow\nmenu: click the trigger, a positioned menu appears, clicking an item both\nperforms the action *and* closes the menu.\n\n**ARIA pattern — `role=\"menu\"`/`role=\"menuitem\"` with real roving DOM\nfocus, not a listbox.** Two coherent, mutually-exclusive shapes were\navailable here: (a) `role=\"listbox\"`/`role=\"option\"` with\n`aria-activedescendant`, the pattern `<lyra-select>`'s trigger-button +\npopup listbox uses, where DOM focus never leaves the trigger; or (b)\n`role=\"menu\"`/`role=\"menuitem\"` with real focus moving between actual\nfocusable rows, the WAI-ARIA \"menu button\" pattern. This picks (b):\n`<lyra-menu-item>` rows are real, independently-focusable elements (see\nthat class's own doc), which is the more natural fit for a menu\nspecifically — unlike a listbox's rows, a menu's rows are conventionally\nbutton-/link-shaped, and every well-known native/OS menu (and this\nfamily's own `<lyra-tree>`/`<lyra-tree-node>` pair, which this component's\nroving-tabindex plumbing directly mirrors) already moves real focus rather\nthan merely a virtual `aria-activedescendant` pointer. `role`/`tabIndex`\nare consistently the menu-button shape throughout — never mixed with\nlistbox/option.\n\nInteraction contract (mirrors the WAI-ARIA APG \"menu button\" pattern):\n- Click the trigger (or Enter/Space on it, via the trigger's own native\n  `click` activation) toggles the menu, moving focus to the first\n  non-disabled item on open.\n- ArrowDown/ArrowUp on the trigger while closed also open it, focusing the\n  first/last non-disabled item respectively.\n- Once open, ArrowDown/ArrowUp move the roving focus among non-disabled\n  items (wrapping past either end — the recommended, and more common,\n  menu-widget behavior, unlike `<lyra-select>`'s clamped listbox nav).\n  Home/End jump to the first/last non-disabled item. Enter/Space activate\n  the focused item. Escape closes and returns focus to the trigger. Tab\n  closes the menu without trapping focus (the browser's own default Tab\n  behavior proceeds untouched). A printable keypress runs type-ahead:\n  roving focus jumps to the next non-disabled item whose text starts with\n  the accumulated buffer, cycling from just after the active item (mirrors\n  `<lyra-select>`'s identical listbox type-ahead).\n- A click outside both the trigger and the open popup closes it (mirrors\n  `<lyra-select>`'s `onDocPointer` exactly) — this does *not* refocus the\n  trigger, since the outside click itself already moved focus somewhere\n  the user chose; Escape and a committed selection *do* refocus the\n  trigger, since those are dismissals with nowhere else for focus to go.\n\nThe trigger element itself is read from the `trigger` slot's assigned\nelement (first one, if several are assigned) and enhanced imperatively\nwith `aria-haspopup=\"menu\"`/`aria-expanded`/`aria-controls` — the same\n\"reach into a consumer-owned light-DOM element to complete its a11y\nwiring\" approach `<lyra-dialog>` documents for its own heading detection,\nnecessary here because those attributes belong on the actual interactive\ntrigger, which lives outside this component's own shadow root.\n\nThe popup is always rendered (never `display:none`) so `.focus()` calls on\nits content work synchronously the instant it opens — visually hidden via\n`visibility`/`opacity` instead (identical to `<lyra-select>`'s own\n`[part=\"listbox\"]`). `visibility` is an inherited CSS property that\npierces the `<slot>` projection boundary, so every closed-state\n`<lyra-menu-item>` is automatically excluded from sequential (Tab-key)\nnavigation with no separate JS bookkeeping.",
+          "description": "`<lyra-menu>` — an anchored dropdown of `<lyra-menu-item>` actions, opened\nfrom a consumer-supplied trigger (typically an icon button). A close, drop-\nin-shaped replacement for reaching outside this library for a third-party\ndropdown to build a gear menu, an avatar menu, or a history row's overflow\nmenu: click the trigger, a positioned menu appears, clicking an item both\nperforms the action *and* closes the menu.\n\n**ARIA pattern — `role=\"menu\"`/`role=\"menuitem\"` with real roving DOM\nfocus, not a listbox.** Two coherent, mutually-exclusive shapes were\navailable here: (a) `role=\"listbox\"`/`role=\"option\"` with\n`aria-activedescendant`, the pattern `<lyra-select>`'s trigger-button +\npopup listbox uses, where DOM focus never leaves the trigger; or (b)\n`role=\"menu\"`/`role=\"menuitem\"` with real focus moving between actual\nfocusable rows, the WAI-ARIA \"menu button\" pattern. This picks (b):\n`<lyra-menu-item>` rows are real, independently-focusable elements (see\nthat class's own doc), which is the more natural fit for a menu\nspecifically — unlike a listbox's rows, a menu's rows are conventionally\nbutton-/link-shaped, and every well-known native/OS menu (and this\nfamily's own `<lyra-tree>`/`<lyra-tree-node>` pair, which this component's\nroving-tabindex plumbing directly mirrors) already moves real focus rather\nthan merely a virtual `aria-activedescendant` pointer. `role`/`tabIndex`\nare consistently the menu-button shape throughout — never mixed with\nlistbox/option.\n\nInteraction contract (mirrors the WAI-ARIA APG \"menu button\" pattern):\n- Click the trigger (or Enter/Space on it, via the trigger's own native\n  `click` activation) toggles the menu, moving focus to the first\n  non-disabled item on open.\n- ArrowDown/ArrowUp on the trigger while closed also open it, focusing the\n  first/last non-disabled item respectively.\n- Once open, ArrowDown/ArrowUp move the roving focus among non-disabled\n  items (wrapping past either end — the recommended, and more common,\n  menu-widget behavior, unlike `<lyra-select>`'s clamped listbox nav).\n  Home/End jump to the first/last non-disabled item. Enter/Space activate\n  the focused item. Escape closes and returns focus to the trigger. Tab\n  closes the menu without trapping focus (the browser's own default Tab\n  behavior proceeds untouched). A printable keypress runs type-ahead:\n  roving focus jumps to the next non-disabled item whose text starts with\n  the accumulated buffer, cycling from just after the active item (mirrors\n  `<lyra-select>`'s identical listbox type-ahead). All of the above (except\n  Escape) only respond to keydowns from a real `<lyra-menu-item>` target,\n  so a slotted non-item control (e.g. a date input) keeps its own full\n  default keyboard behavior. Escape from such a slotted control closes the\n  menu too, but only when `closeOnEscapeAnywhere` is set — it defaults to\n  `false`, so existing consumers keep today's behavior unchanged.\n- A click outside both the trigger and the open popup closes it (mirrors\n  `<lyra-select>`'s `onDocPointer` exactly) — this does *not* refocus the\n  trigger, since the outside click itself already moved focus somewhere\n  the user chose; Escape and a committed selection *do* refocus the\n  trigger, since those are dismissals with nowhere else for focus to go.\n\nThe trigger element itself is read from the `trigger` slot's assigned\nelement (first one, if several are assigned) and enhanced imperatively\nwith `aria-haspopup=\"menu\"`/`aria-expanded`/`aria-controls` — the same\n\"reach into a consumer-owned light-DOM element to complete its a11y\nwiring\" approach `<lyra-dialog>` documents for its own heading detection,\nnecessary here because those attributes belong on the actual interactive\ntrigger, which lives outside this component's own shadow root.\n\nThe popup is always rendered (never `display:none`) so `.focus()` calls on\nits content work synchronously the instant it opens — visually hidden via\n`visibility`/`opacity` instead (identical to `<lyra-select>`'s own\n`[part=\"listbox\"]`). `visibility` is an inherited CSS property that\npierces the `<slot>` projection boundary, so every closed-state\n`<lyra-menu-item>` is automatically excluded from sequential (Tab-key)\nnavigation with no separate JS bookkeeping.",
           "name": "LyraMenu",
           "cssParts": [
             {
@@ -39205,6 +39557,16 @@
               },
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "closeOnEscapeAnywhere",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Extends the Escape-closes-and-refocuses-trigger behavior to keydown\nevents originating from slotted non-item content within `[part=\"list\"]`\n(e.g. a date input or a custom section slotted alongside\n`<lyra-menu-item>`s), not just from a real `<lyra-menu-item>`. Default\n`false` leaves Escape from slotted non-item content with full default\nkeyboard behavior, matching every existing consumer. Arrow/Home/End/\nEnter/Space stay scoped to real `<lyra-menu-item>` targets regardless of\nthis property — only Escape is affected.",
+              "attribute": "close-on-escape-anywhere"
+            },
             {
               "kind": "field",
               "name": "effectiveDirection",
@@ -39219,6 +39581,16 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "effectiveLabel",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "description": "Resolves `label`'s effective text: an explicit override wins verbatim; left at the\nbuilt-in default it instead routes through `this.localize()` so a locale/`.strings`\noverride applies without requiring `label` itself to be set.",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "effectiveLocale",
@@ -39257,7 +39629,7 @@
                 "text": "string"
               },
               "default": "'Menu'",
-              "description": "Accessible name for the `role=\"menu\"` popup — override with something\nspecific (e.g. \"Row actions\") when a page has more than one menu.",
+              "description": "Accessible name for the `role=\"menu\"` popup — override with something\nspecific (e.g. \"Row actions\") when a page has more than one menu.\nLocalized (`menuLabel`) when left at its default.",
               "attribute": "label"
             },
             {
@@ -39708,13 +40080,22 @@
             }
           ],
           "attributes": [
+            {
+              "name": "close-on-escape-anywhere",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Extends the Escape-closes-and-refocuses-trigger behavior to keydown\nevents originating from slotted non-item content within `[part=\"list\"]`\n(e.g. a date input or a custom section slotted alongside\n`<lyra-menu-item>`s), not just from a real `<lyra-menu-item>`. Default\n`false` leaves Escape from slotted non-item content with full default\nkeyboard behavior, matching every existing consumer. Arrow/Home/End/\nEnter/Space stay scoped to real `<lyra-menu-item>` targets regardless of\nthis property — only Escape is affected.",
+              "fieldName": "closeOnEscapeAnywhere"
+            },
             {
               "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "'Menu'",
-              "description": "Accessible name for the `role=\"menu\"` popup — override with something\nspecific (e.g. \"Row actions\") when a page has more than one menu.",
+              "description": "Accessible name for the `role=\"menu\"` popup — override with something\nspecific (e.g. \"Row actions\") when a page has more than one menu.\nLocalized (`menuLabel`) when left at its default.",
               "fieldName": "label"
             },
             {
@@ -40386,6 +40767,17 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "emitValueEvents",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Dispatches the platform-style value-event pair alongside `lyra-change`,\nmirroring `<lyra-select>`/`<lyra-combobox>` so native form bindings and\nframework `v-model` handlers behave consistently across the picker\nfamily."
+            },
             {
               "kind": "method",
               "name": "formDisabledCallback",
@@ -40669,6 +41061,20 @@
             }
           ],
           "events": [
+            {
+              "name": "change",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired alongside `lyra-change`, mirroring `<lyra-select>`/`<lyra-combobox>`'s native-style value-change pair so native form bindings/framework `v-model` handlers behave consistently across the picker family."
+            },
+            {
+              "name": "input",
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired alongside `change`/`lyra-change` (see `change`)."
+            },
             {
               "description": "The selected/typed value changed. `detail: { value: string; inCatalog: boolean }`.",
               "name": "lyra-change"
@@ -41405,6 +41811,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "The current step, in `[0, length)`.",
               "attribute": "index"
             },
             {
@@ -41414,6 +41821,7 @@
                 "text": "number"
               },
               "default": "900",
+              "description": "Delay between ticks, in milliseconds, while playing. Clamped to\n`[MIN_INTERVAL_MS, MAX_TIMEOUT_MS]` — see `scheduleTick()`.",
               "attribute": "interval-ms"
             },
             {
@@ -41423,6 +41831,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Total number of steps to play through; the index range is `[0, length)`.",
               "attribute": "length"
             },
             {
@@ -41782,6 +42191,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "The current step, in `[0, length)`.",
               "fieldName": "index"
             },
             {
@@ -41790,6 +42200,7 @@
                 "text": "number"
               },
               "default": "900",
+              "description": "Delay between ticks, in milliseconds, while playing. Clamped to\n`[MIN_INTERVAL_MS, MAX_TIMEOUT_MS]` — see `scheduleTick()`.",
               "fieldName": "intervalMs"
             },
             {
@@ -41798,6 +42209,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Total number of steps to play through; the index range is `[0, length)`.",
               "fieldName": "length"
             },
             {
@@ -41877,7 +42289,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-poll-status>` — a \"next scheduled refresh\" countdown with a built-in pause control: a\nticking `M:SS` display counting down to the next scheduled action, a \"Refreshing…\" state at\nzero, and a pause/resume toggle. First-party invention (no Web Awesome equivalent); the\nclosest existing component, `lyra-stream-status`, is scoped to transport/connection-health\nphases, a different concern from a scheduled-interval countdown -- this mirrors its internal\n`<lyra-live-region>` composition for accessible phase-transition announcements.",
+          "description": "`<lyra-poll-status>` — a \"next scheduled refresh\" countdown with a built-in pause control: a\nticking `M:SS` display counting down to the next scheduled action, a \"Refreshing…\" state at\nzero, a \"Paused\" state while `paused` (instead of freezing on a stale value), and a\npause/resume toggle. First-party invention (no Web Awesome equivalent); the\nclosest existing component, `lyra-stream-status`, is scoped to transport/connection-health\nphases, a different concern from a scheduled-interval countdown -- this mirrors its internal\n`<lyra-live-region>` composition for accessible phase-transition announcements.",
           "name": "LyraPollStatus",
           "cssParts": [
             {
@@ -41885,7 +42297,7 @@
               "name": "base"
             },
             {
-              "description": "The `M:SS` (or \"Refreshing…\") text.",
+              "description": "The `M:SS` text (or \"Refreshing…\" once due, or \"Paused\" while `paused`).",
               "name": "countdown"
             },
             {
@@ -43746,6 +44158,16 @@
               "default": "[]",
               "description": "The button row's items."
             },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "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 `<lyra-slider>`.",
+              "attribute": "label"
+            },
             {
               "kind": "field",
               "name": "locale",
@@ -43987,6 +44409,15 @@
             }
           ],
           "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "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 `<lyra-slider>`.",
+              "fieldName": "label"
+            },
             {
               "name": "locale",
               "type": {
@@ -44077,6 +44508,10 @@
               "description": "The `<label>` element.",
               "name": "form-control-label"
             },
+            {
+              "description": "An option group's heading row (shown when any option declares a `group`).",
+              "name": "group-label"
+            },
             {
               "description": "The hint message.",
               "name": "hint"
@@ -44935,7 +45370,7 @@
           ],
           "events": [
             {
-              "description": "The selection changed.",
+              "description": "The selection changed. Deliberately unprefixed, mirroring native `<select>`'s own event name -- contrast `<lyra-slider>`, which uses `lyra-input`/`lyra-change` for its analogous value-change pair. Which form controls mirror native unprefixed DOM event names (this one, matching `<select>`) versus which use the `lyra-` prefix (`<lyra-slider>`, matching `<input type=\"range\">` via a custom name) is a deliberate per-control choice, not an incidental divergence.",
               "name": "change"
             },
             {
@@ -46614,7 +47049,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-source-list>` — a collapsible \"Sources\" panel for one chat message,\ngrouping a set of `<lyra-source-card>` children (its default-slot light-DOM\nchildren, plain composition — no `.items` array prop, the same shape\n`<lyra-split>`'s panels take) behind a single clickable header.\n\nThis library has no built-in i18n/pluralization (see `<lyra-empty>`'s plain\n`description` prop for the same stance), so the header text is entirely\nconsumer-supplied: `label-plural` (e.g. `\"3 sources\"`) wins when set,\nfalling back to `label`, falling back to the literal word `\"Sources\"` — see\neach property's own doc. `sourceCount` (a read-only, live-updated count of\nthe currently-slotted children) is exposed for a consumer who wants to\nbuild that string reactively 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.",
+          "description": "`<lyra-source-list>` — a collapsible \"Sources\" panel for one chat message,\ngrouping a set of `<lyra-source-card>` children (its default-slot light-DOM\nchildren, plain composition — no `.items` array prop, the same shape\n`<lyra-split>`'s panels take) behind a single clickable header.\n\nThis library has no built-in pluralization (see `<lyra-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.",
           "name": "LyraSourceList",
           "cssParts": [
             {
@@ -47500,7 +47935,7 @@
               "type": {
                 "text": "(index: number, panelCount: number) => string | undefined"
               },
-              "description": "Overrides the auto-inserted divider's `aria-label` — receives the divider's 0-based index\nand the total panel count (`lyra-split` supports N panels, so a single fixed string can't\nexpress every divider's label; a function can). Unset (the default) keeps today's exact\n`` `Resize divider between panel ${i + 1} and panel ${i + 2}` `` template."
+              "description": "Overrides the auto-inserted divider's `aria-label` — receives the divider's 0-based index\nand the total panel count (`lyra-split` supports N panels, so a single fixed string can't\nexpress every divider's label; a function can). Unset (the default) keeps today's exact\nlocalized `Resize divider between panel {a} and panel {b}` template (see `this.localize()`)."
             },
             {
               "kind": "field",
@@ -49080,7 +49515,7 @@
                 "text": "StepItem[]"
               },
               "default": "[]",
-              "description": "Ordered step data. Never mutated by this component -- see the class doc's controlled-\ncomponent contract. Empty (the default) renders nothing."
+              "description": "Ordered step data. Never mutated by this component -- see the class doc's controlled-\ncomponent contract. Empty (the default) renders nothing. Each step's optional `title`\nrenders as a native `title` tooltip on that step's button -- e.g. to explain why a\n`disabled` step is locked."
             },
             {
               "kind": "field",
@@ -52373,6 +52808,378 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/textarea/textarea.class.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<lyra-textarea>` — a bare, multiline plain-text input primitive. Form-associated via the\n`FormAssociated` mixin (see `<lyra-chat-composer>`/`<lyra-date-input>` for the same shape), so it\nparticipates in native `<form>` submission/validation/reset like any other text control --\n`name`/`value`/`disabled`/`required`/`checkValidity()`/`reportValidity()` all come from that mixin.\n\nDeliberately no auto-resize and no label/hint/error chrome -- the thin `lyra-*` equivalent of a\nplain `wa-textarea`, not a rebuild of `<lyra-chat-composer>`. A consumer wanting a labeled field\nwraps this element in whatever form-field layout it already uses.",
+          "name": "LyraTextarea",
+          "cssParts": [
+            {
+              "description": "The native `<textarea>` element.",
+              "name": "textarea"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "effectiveDirection",
+              "type": {
+                "text": "'ltr' | 'rtl'"
+              },
+              "privacy": "protected",
+              "description": "The effective text direction, including inherited CSS direction.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "effectiveLocale",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "The effective locale used by this component.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.",
+              "attribute": "locale",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "onChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onInput",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "field",
+              "name": "resize",
+              "type": {
+                "text": "TextareaResize"
+              },
+              "default": "'vertical'",
+              "description": "Native CSS `resize` behavior for the textarea.",
+              "attribute": "resize"
+            },
+            {
+              "kind": "field",
+              "name": "rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "3",
+              "description": "Visible text rows.",
+              "attribute": "rows"
+            },
+            {
+              "kind": "field",
+              "name": "stopLocaleSubscription",
+              "type": {
+                "text": "() => void | undefined"
+              },
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "strings",
+              "type": {
+                "text": "LyraLocaleStrings"
+              },
+              "default": "{}",
+              "description": "Per-instance message overrides, useful for application-specific wording.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "textareaEl",
+              "type": {
+                "text": "HTMLTextAreaElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "addEventListener",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: this, event: Events[K]) => unknown"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "CustomEvent<T>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "LyraEmitOptions"
+                  }
+                }
+              ],
+              "description": "Dispatch a composed, bubbling custom event; notifications are not veto points by default.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "localize",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "fallback",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "values",
+                  "optional": true,
+                  "type": {
+                    "text": "Record<string, string | number>"
+                  }
+                }
+              ],
+              "description": "Resolve a localized message using this component's overrides and locale.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "removeEventListener",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: this, event: Events[K]) => unknown"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | EventListenerOptions"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "description": "Fired on the native `change` timing (control loses focus after a committed edit). `detail: { value }`.",
+              "name": "lyra-change"
+            },
+            {
+              "description": "Fired on every user-driven edit (not a programmatic `.value` assignment). `detail: { value }`.",
+              "name": "lyra-input"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.",
+              "fieldName": "locale",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "placeholder"
+            },
+            {
+              "name": "resize",
+              "type": {
+                "text": "TextareaResize"
+              },
+              "default": "'vertical'",
+              "description": "Native CSS `resize` behavior for the textarea.",
+              "fieldName": "resize"
+            },
+            {
+              "name": "rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "3",
+              "description": "Visible text rows.",
+              "fieldName": "rows"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "FormAssociated",
+              "module": "/src/internal/form-associated.js"
+            }
+          ],
+          "superclass": {
+            "name": "LyraTextareaBase",
+            "module": "src/components/textarea/textarea.class.ts"
+          },
+          "tagName": "lyra-textarea",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LyraTextarea",
+          "declaration": {
+            "name": "LyraTextarea",
+            "module": "src/components/textarea/textarea.class.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/textarea/textarea.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "lyra-textarea",
+          "declaration": {
+            "name": "LyraTextarea",
+            "module": "src/components/textarea/textarea.class.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/components/textarea/textarea.class.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/thinking-panel/thinking-panel.class.ts",
@@ -52492,7 +53299,7 @@
                 "text": "string"
               },
               "default": "'Thinking'",
-              "description": "Header text.",
+              "description": "Header text. Localized (`thinkingPanelLabel`) when left at its default\n`'Thinking'`; any other value is shown as-is.",
               "attribute": "label"
             },
             {
@@ -52761,7 +53568,7 @@
                 "text": "string"
               },
               "default": "'Thinking'",
-              "description": "Header text.",
+              "description": "Header text. Localized (`thinkingPanelLabel`) when left at its default\n`'Thinking'`; any other value is shown as-is.",
               "fieldName": "label"
             },
             {
@@ -52835,7 +53642,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-time-range>` — a two-handle brush/scrubber over a numeric domain.\nCallers map their own time axis to `[min, max]`; no date logic lives here\n(matches the no-date-library constraint used elsewhere in this library).\n\nOptionally paired with a row of discrete presets (`presets`) — e.g. \"Last\n7 days\" / \"Last 30 days\" — rendered above the track; picking one is just a\nshortcut that sets both handles at once, the continuous brush underneath\nis unaffected and both interaction modes coexist.\n\nForm-associated (via a directly-attached `ElementInternals`, mirroring\n`<lyra-combobox>`'s minimal pattern rather than the single-string-value\n`FormAssociated` mixin, which doesn't fit a two-handle range): an ancestor\n`<fieldset disabled>` disables both handles and every preset button\nthrough `effectiveDisabled`, the same way it would a native `<input>`,\nwithout touching the consumer-facing `disabled` property/attribute itself.",
+          "description": "`<lyra-time-range>` — a two-handle brush/scrubber over a numeric domain.\nCallers map their own time axis to `[min, max]`; no date logic lives here\n(matches the no-date-library constraint used elsewhere in this library).\n\nOptionally paired with a row of discrete presets (`presets`) — e.g. \"Last\n7 days\" / \"Last 30 days\" — rendered above the track; picking one is just a\nshortcut that sets both handles at once, the continuous brush underneath\nis unaffected and both interaction modes coexist.\n\nForm-associated only for the `<fieldset disabled>` cascade, not for a\nsubmitted value: it attaches `ElementInternals` (like `<lyra-combobox>`'s\nminimal pattern, rather than the single-string-value `FormAssociated`\nmixin, which doesn't fit a two-handle range) purely so an ancestor\n`<fieldset disabled>` disables both handles and every preset button\nthrough `effectiveDisabled`, the same way it would a native `<input>`,\nwithout touching the consumer-facing `disabled` property/attribute itself.\nUnlike `<lyra-combobox>`, it never calls `internals.setFormValue()` and\nhas no `name` — the selected range is not included in the owning form's\n`FormData` on submit; read `start`/`end` directly (e.g. from `lyra-change`)\ninstead of relying on native form submission.",
           "name": "LyraTimeRange",
           "cssParts": [
             {
@@ -55022,7 +55829,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-tool-call-chip>` — a compact inline pill representing one tool/\nfunction call an agent made mid-conversation, e.g.\n`web_search: Searching web…` with a `running` spinner. It owns no detail\nsurface of its own: clicking (or Enter/Space-activating) it only fires\n`lyra-tool-chip-select` — a consumer wires that to opening a\n`<lyra-tool-result-dialog>` (or anything else) at the call site. Keeping\nthe two decoupled means a chip can be reused wherever a compact call\nsummary is useful, with or without a detail surface behind it.\n\nThe default slot is *not* the chip's visible content — the chip's own\nlabel is always built from `name`/`summary`/`status`/`duration-ms`. It's\nreserved for optional rich detail content (e.g. the tool's raw arguments,\na short preview) shown in a floating tooltip on hover/focus, positioned\nwith `internal/positioner.js`'s `place()` the same way `<lyra-combobox>`\npositions its listbox. No tooltip is shown at all when the slot carries no\ncontent — hovering an empty chip does nothing. Hover and keyboard focus are\ntracked as independent reasons to keep the tooltip open (mirrors\n`<lyra-citation-badge>`'s popover), so releasing one modality while the\nother is still active doesn't close it, and the trigger button's\n`aria-describedby` points at the tooltip's id whenever it's open and has\ncontent, so the association reaches assistive tech too.\n\nThe `icon` slot overrides the built-in per-status glyph entirely via the\nplatform's own slot-fallback-content mechanism (`<slot\nname=\"icon\">${fallback}</slot>` — the same pattern `<lyra-stat>`'s\n`caption` slot and `<lyra-file-input>`'s default slot already use):\nwhatever is assigned to `slot=\"icon\"` wins; otherwise the `icon` prop is\nrendered as a literal hint (e.g. an emoji); otherwise the built-in glyph\nfor the current `status` is used.",
+          "description": "`<lyra-tool-call-chip>` — a compact inline pill representing one tool/\nfunction call an agent made mid-conversation, e.g.\n`web_search: Searching web…` with a `running` spinner. It owns no detail\nsurface of its own: clicking (or Enter/Space-activating) it only fires\n`lyra-tool-call-chip-select` (plus, for one minor cycle, the deprecated\n`lyra-tool-chip-select` alias) — a consumer wires that to opening a\n`<lyra-tool-result-dialog>` (or anything else) at the call site. Keeping\nthe two decoupled means a chip can be reused wherever a compact call\nsummary is useful, with or without a detail surface behind it.\n\nThe default slot is *not* the chip's visible content — the chip's own\nlabel is always built from `name`/`summary`/`status`/`duration-ms`. It's\nreserved for optional rich detail content (e.g. the tool's raw arguments,\na short preview) shown in a floating tooltip on hover/focus, positioned\nwith `internal/positioner.js`'s `place()` the same way `<lyra-combobox>`\npositions its listbox. No tooltip is shown at all when the slot carries no\ncontent — hovering an empty chip does nothing. Hover and keyboard focus are\ntracked as independent reasons to keep the tooltip open (mirrors\n`<lyra-citation-badge>`'s popover), so releasing one modality while the\nother is still active doesn't close it, and the trigger button's\n`aria-describedby` points at the tooltip's id whenever it's open and has\ncontent, so the association reaches assistive tech too.\n\nThe `icon` slot overrides the built-in per-status glyph entirely via the\nplatform's own slot-fallback-content mechanism (`<slot\nname=\"icon\">${fallback}</slot>` — the same pattern `<lyra-stat>`'s\n`caption` slot and `<lyra-file-input>`'s default slot already use):\nwhatever is assigned to `slot=\"icon\"` wins; otherwise the `icon` prop is\nrendered as a literal hint (e.g. an emoji); otherwise the built-in glyph\nfor the current `status` is used.",
           "name": "LyraToolCallChip",
           "cssParts": [
             {
@@ -55093,7 +55900,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Unique identifier for this specific invocation — echoed back in `lyra-tool-chip-select`'s\ndetail so a listener can correlate the click with the call it fired for.",
+              "description": "Unique identifier for this specific invocation — echoed back in `lyra-tool-call-chip-select`'s\ndetail so a listener can correlate the click with the call it fired for.",
               "attribute": "call-id"
             },
             {
@@ -55484,6 +56291,10 @@
           "events": [
             {
               "description": "The chip was activated (click or Enter/Space while focused). `detail: { name, callId }`.",
+              "name": "lyra-tool-call-chip-select"
+            },
+            {
+              "description": "Deprecated alias for `lyra-tool-call-chip-select`, fired alongside it for one minor cycle so existing listeners keep working. Removed in the next major.",
               "name": "lyra-tool-chip-select"
             }
           ],
@@ -55494,7 +56305,7 @@
                 "text": "string"
               },
               "default": "''",
-              "description": "Unique identifier for this specific invocation — echoed back in `lyra-tool-chip-select`'s\ndetail so a listener can correlate the click with the call it fired for.",
+              "description": "Unique identifier for this specific invocation — echoed back in `lyra-tool-call-chip-select`'s\ndetail so a listener can correlate the click with the call it fired for.",
               "fieldName": "callId"
             },
             {
@@ -55623,6 +56434,10 @@
               "description": "A field's helper text, from `schema.description`.",
               "name": "description"
             },
+            {
+              "description": "The message shown when `schema.properties` has no entries.",
+              "name": "empty"
+            },
             {
               "description": "A field-level or form-level validation message.",
               "name": "error"
@@ -55634,6 +56449,10 @@
             {
               "description": "A field's label.",
               "name": "label"
+            },
+            {
+              "description": "The fallback note rendered in place of a control for a property whose `type` is outside this renderer's scope.",
+              "name": "unsupported"
             }
           ],
           "members": [
@@ -56753,7 +57572,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the dialog is open. Set this (or call `close()`) — there is no\nseparate `show()`/`hide()` pair. Both paths restore focus to the trigger\nelement identically; only `close()` additionally fires\n`lyra-dialog-close`, since a direct assignment carries no reason string\nto attach to that event.",
+              "description": "Whether the dialog is open. Set this (or call `close()`) — there is no\nseparate `show()`/`hide()` pair. Both paths restore focus to the trigger\nelement identically; only `close()` additionally fires\n`lyra-close`, since a direct assignment carries no reason string\nto attach to that event.",
               "attribute": "open",
               "reflects": true
             },
@@ -56891,7 +57710,7 @@
                   }
                 }
               ],
-              "description": "Close the dialog and return focus to whatever had it before the dialog\nopened. `reason` is forwarded as the `lyra-dialog-close` detail --\nbuilt-in triggers pass `'escape'`/`'backdrop'`/`'close-button'`; a\nconsumer's own close affordance (e.g. a footer action button) should\ncall this directly with its own reason string, so every dismissal path\nfunnels through the same event instead of the consumer having to also\ntoggle `open` itself.\n\nFocus restoration follows the `open` lifecycle, so a direct `.open =\nfalse` assignment restores focus identically to calling `close()` -- the\none thing a direct assignment still can't do is fire\n`lyra-dialog-close`, since there's no reason string to attach without\ngoing through this method."
+              "description": "Close the dialog and return focus to whatever had it before the dialog\nopened. `reason` is forwarded as the `lyra-close` detail --\nbuilt-in triggers pass `'escape'`/`'backdrop'`/`'close-button'`; a\nconsumer's own close affordance (e.g. a footer action button) should\ncall this directly with its own reason string, so every dismissal path\nfunnels through the same event instead of the consumer having to also\ntoggle `open` itself.\n\nFocus restoration follows the `open` lifecycle, so a direct `.open =\nfalse` assignment restores focus identically to calling `close()` -- the\none thing a direct assignment still can't do is fire\n`lyra-close`, since there's no reason string to attach without\ngoing through this method."
             },
             {
               "kind": "method",
@@ -57015,7 +57834,7 @@
           "events": [
             {
               "description": "`detail: ToolResultDialogCloseReason`. Fired exactly once per dismissal, via Escape, a backdrop click, the built-in close button, or a `close()` call.",
-              "name": "lyra-dialog-close"
+              "name": "lyra-close"
             },
             {
               "description": "`detail: boolean` (the new `maximized` state), fired when the header's maximize/restore toggle is clicked.",
@@ -57059,7 +57878,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Whether the dialog is open. Set this (or call `close()`) — there is no\nseparate `show()`/`hide()` pair. Both paths restore focus to the trigger\nelement identically; only `close()` additionally fires\n`lyra-dialog-close`, since a direct assignment carries no reason string\nto attach to that event.",
+              "description": "Whether the dialog is open. Set this (or call `close()`) — there is no\nseparate `show()`/`hide()` pair. Both paths restore focus to the trigger\nelement identically; only `close()` additionally fires\n`lyra-close`, since a direct assignment carries no reason string\nto attach to that event.",
               "fieldName": "open"
             },
             {
@@ -58367,6 +59186,10 @@
               "description": "The optional node badge.",
               "name": "badge"
             },
+            {
+              "description": "The wrapper around a node's expanded child items.",
+              "name": "group"
+            },
             {
               "description": "The node label.",
               "name": "label"
@@ -58791,7 +59614,12 @@
           "name": "LyraTree",
           "cssParts": [
             {
+              "description": "The tree's root wrapper (role=\"tree\").",
               "name": "base"
+            },
+            {
+              "description": "The empty-state message shown when `data` is empty.",
+              "name": "empty"
             }
           ],
           "slots": [
@@ -59298,7 +60126,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-typing-indicator>` — a purely presentational \"assistant is\nresponding\" presence cue. No events, no interactivity: a consumer mounts\nit while a response is being generated and removes it (or hides it) once\nreal content has arrived.\n\nThree visual variants share one component rather than three separate tags\nbecause callers pick between them along a single axis — how the\nsurrounding surface wants the cue to read — and nothing else about the\ncomponent differs:\n- `dots` (default) — three dots with a staggered bounce, the classic\n  \"typing…\" affordance for a standalone status line.\n- `pulse` — a single breathing dot, a quieter cue for a tighter space\n  (e.g. next to an avatar).\n- `cursor` — a blinking vertical bar, meant to sit inline at the tail end\n  of streamed text that is still being appended to.\n\nAccessibility: this indicator typically mounts and unmounts around a real\ngeneration lifecycle (appears when a response starts, disappears once one\narrives) rather than emitting a stream of updates of its own, so it does\n*not* route through `<lyra-live-region>`/`Announcer`\n(`../../internal/announcer.js`) — that machinery exists to coalesce many\nrapidly-changing announcements into one, and there is only ever a single\nannouncement here: the mount itself. A plain `role=\"status\"` plus an\naccessible name derived from `label` is sufficient, set both as an\n`aria-label` on the host *and* as a visually-hidden text node in the\nshadow tree, so the name survives even if only one of the two is picked up\nby a given assistive-tech/browser pairing. An empty or whitespace-only\n`label` falls back to the default \"Thinking…\" copy in both places, rather\nthan leaving the component with no accessible name at all. The animated dots/pulse/cursor\nshape is `aria-hidden=\"true\"` — it's decorative; `label` is the entire\naccessible content, so nothing narrates individual animation frames.",
+          "description": "`<lyra-typing-indicator>` — a purely presentational \"assistant is\nresponding\" presence cue. No events, no interactivity: a consumer mounts\nit while a response is being generated and removes it (or hides it) once\nreal content has arrived.\n\nThree visual variants share one component rather than three separate tags\nbecause callers pick between them along a single axis — how the\nsurrounding surface wants the cue to read — and nothing else about the\ncomponent differs:\n- `dots` (default) — three dots with a staggered bounce, the classic\n  \"typing…\" affordance for a standalone status line.\n- `pulse` — a single breathing dot, a quieter cue for a tighter space\n  (e.g. next to an avatar).\n- `cursor` — a blinking vertical bar, meant to sit inline at the tail end\n  of streamed text that is still being appended to.\n\nAccessibility: this indicator typically mounts and unmounts around a real\ngeneration lifecycle (appears when a response starts, disappears once one\narrives) rather than emitting a stream of updates of its own, so it does\n*not* route through `<lyra-live-region>`/`Announcer`\n(`../../internal/announcer.js`) — that machinery exists to coalesce many\nrapidly-changing announcements into one, and there is only ever a single\nannouncement here: the mount itself. A plain `role=\"status\"` plus an\naccessible name derived from `label` is sufficient, set both as an\n`aria-label` on the host *and* as a visually-hidden text node in the\nshadow tree, so the name survives even if only one of the two is picked up\nby a given assistive-tech/browser pairing. An untouched-default, empty, or\nwhitespace-only `label` falls back to the localized \"Thinking…\" copy in\nboth places, rather than leaving the component with no accessible name at\nall. The animated dots/pulse/cursor\nshape is `aria-hidden=\"true\"` — it's decorative; `label` is the entire\naccessible content, so nothing narrates individual animation frames.",
           "name": "LyraTypingIndicator",
           "cssParts": [
             {
@@ -59326,7 +60154,7 @@
                 "text": "string"
               },
               "privacy": "private",
-              "description": "The accessible name actually used, falling back to the default\n\"Thinking…\" copy when `label` is set to an empty or whitespace-only\nstring -- otherwise both the `aria-label` and the sr-only text node\nwould go blank, leaving this purely-decorative component with no\naccessible name at all.",
+              "description": "The accessible name actually used, falling back to the localized\n`'thinking'` message (`\"Thinking…\"` in English) when `label` is left at\nits untouched default or set to an empty/whitespace-only string --\notherwise both the `aria-label` and the sr-only text node would go\nblank, leaving this purely-decorative component with no accessible name\nat all. A caller-customized `label` is used verbatim (not a translation\nconcern), same convention as `<lyra-date-picker>`'s `previousLabel`.",
               "readonly": true
             },
             {
@@ -59364,7 +60192,7 @@
                 "text": "string"
               },
               "default": "'Thinking…'",
-              "description": "Accessible name, exposed via `role=\"status\"`. Not re-announced on every\nanimation frame — only mount (and any later change to this property)\nproduces a new announcement. An empty or whitespace-only value falls\nback to the default \"Thinking…\" copy (see `accessibleLabel`) so the\ncomponent never loses its accessible name.",
+              "description": "Accessible name, exposed via `role=\"status\"`. Not re-announced on every\nanimation frame — only mount (and any later change to this property)\nproduces a new announcement. An untouched-default, empty, or\nwhitespace-only value falls back to the localized \"Thinking…\" copy (see\n`accessibleLabel`) so the component never loses its accessible name.",
               "attribute": "label"
             },
             {
@@ -59589,7 +60417,7 @@
                 "text": "string"
               },
               "default": "'Thinking…'",
-              "description": "Accessible name, exposed via `role=\"status\"`. Not re-announced on every\nanimation frame — only mount (and any later change to this property)\nproduces a new announcement. An empty or whitespace-only value falls\nback to the default \"Thinking…\" copy (see `accessibleLabel`) so the\ncomponent never loses its accessible name.",
+              "description": "Accessible name, exposed via `role=\"status\"`. Not re-announced on every\nanimation frame — only mount (and any later change to this property)\nproduces a new announcement. An untouched-default, empty, or\nwhitespace-only value falls back to the localized \"Thinking…\" copy (see\n`accessibleLabel`) so the component never loses its accessible name.",
               "fieldName": "label"
             },
             {
@@ -60582,6 +61410,14 @@
               "description": "Header action controls, rendered before the collapse/expand buttons.",
               "name": "actions"
             },
+            {
+              "description": "Overrides the built-in chevron glyph inside the collapse/expand toggle button entirely, via the platform's own slot-fallback-content mechanism (same convention as `<lyra-tool-call-chip>`'s `icon` slot): whatever is assigned wins, otherwise the default chevron renders. Only meaningful while `collapsible`.",
+              "name": "collapse-icon"
+            },
+            {
+              "description": "Overrides the built-in expand/close glyph inside the fullscreen toggle button entirely, using the same mechanism -- the override replaces *both* the \"expand\" and \"exit fullscreen\" default icons, so a consumer supplying one is responsible for its own expand/exit distinction (e.g. by reading the `fullscreen` attribute). Only meaningful while `expandable`.",
+              "name": "fullscreen-icon"
+            },
             {
               "description": "Optional leading icon in the title row.",
               "name": "icon"
@@ -60593,6 +61429,10 @@
             {
               "description": "Rich sublabel content (overrides the `sublabel` attribute).",
               "name": "sublabel"
+            },
+            {
+              "description": "Content for the view whose `WidgetView.id` matches `{id}`, rendered when `views` is non-empty.",
+              "name": "view-{id}"
             }
           ],
           "members": [
@@ -60605,6 +61445,16 @@
               "default": "''",
               "description": "The currently active view's `id` -- defaults to the first entry of `views` (or `''` when\n`views` is empty). Settable directly by a consumer wanting to control the active view\nexternally; also updated internally when a view toggle is clicked."
             },
+            {
+              "kind": "field",
+              "name": "backdropInset",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "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.",
+              "attribute": "backdrop-inset"
+            },
             {
               "kind": "field",
               "name": "bodyId",
@@ -60870,7 +61720,7 @@
                 "text": "WidgetView[]"
               },
               "default": "[]",
-              "description": "Named alternate views for the panel body -- e.g. a chart/table toggle inside the same card\nchrome. Each entry gets a header toggle button and a `<slot name=\"view-${id}\">`. Empty (the\ndefault) renders today's single unnamed default slot as the sole view, unchanged."
+              "description": "Named alternate views for the panel body -- e.g. a chart/table toggle inside the same card\nchrome. Each entry gets a header toggle button and a `<slot name=\"view-${id}\">`. Empty (the\ndefault) renders today's single unnamed default slot as the sole view, unchanged. An entry's\n`label` is optional -- see `WidgetView`'s own doc for the icon-only (`ariaLabel`) case."
             },
             {
               "kind": "method",
@@ -61037,19 +61887,28 @@
           ],
           "events": [
             {
-              "description": "`detail: boolean` (the new `collapsed` state).",
+              "description": "`detail: { collapsed }` (the new `collapsed` state).",
               "name": "lyra-collapse-change"
             },
             {
-              "description": "`detail: boolean` (the new `fullscreen` state).",
+              "description": "`detail: { fullscreen }` (the new `fullscreen` state).",
               "name": "lyra-fullscreen-change"
             },
             {
-              "description": "Fired when the active view changes via a header toggle click. `detail: string` (the new view's `id`).",
+              "description": "Fired when the active view changes via a header toggle click. `detail: { viewId }` (the new view's `id`).",
               "name": "lyra-view-change"
             }
           ],
           "attributes": [
+            {
+              "name": "backdrop-inset",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "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.",
+              "fieldName": "backdropInset"
+            },
             {
               "name": "collapsed",
               "type": {
@@ -61647,6 +62506,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "fontWeight",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Reads the actual `--lyra-font-weight-semibold` value the same way\n`fontFamily()` reads `--lyra-font` -- must match `[part='word']`'s\n`font-weight` in word-cloud.styles.ts, so a theme/consumer override of\nthat token can't silently desync canvas text measurement (used for the\nspiral layout's collision boxes) from the actually rendered glyph width."
+            },
             {
               "kind": "method",
               "name": "localize",