@aceshooting/lyra-ui 2.3.0 → 2.5.0

package/custom-elements.json

@@ -2080,12 +2080,36 @@
               "type": {
                 "text": "number"
               }
+            },
+            {
+              "name": "unitLabel",
+              "default": "(unit) => unit",
+              "type": {
+                "text": "(unit: (typeof BYTE_UNITS)[number]) => string"
+              }
             }
           ],
-          "description": "`512` -> `\"512 B\"`; `2415919` -> `\"2.3 MB\"`. Whole bytes never get a\ndecimal (there's no meaningful fraction of a byte); every unit past that\ngets exactly one decimal place. Returns `\"\"` for a negative/non-finite\ninput so a missing/unknown size renders nothing instead of `\"NaN B\"`."
+          "description": "`512` -> `\"512 B\"`; `2415919` -> `\"2.3 MB\"`. Whole bytes never get a\ndecimal (there's no meaningful fraction of a byte); every unit past that\ngets exactly one decimal place. Returns `\"\"` for a negative/non-finite\ninput so a missing/unknown size renders nothing instead of `\"NaN B\"`.\n`unitLabel` resolves each abbreviation to its displayed label -- defaults\nto the identity function (today's plain English abbreviations), so every\nexisting single-argument call site/test is unaffected."
+        },
+        {
+          "kind": "variable",
+          "name": "FILE_SIZE_UNIT_KEYS",
+          "type": {
+            "text": "Record<(typeof BYTE_UNITS)[number], string>"
+          },
+          "default": "{ B: 'fileSizeUnitB', KB: 'fileSizeUnitKb', MB: 'fileSizeUnitMb', GB: 'fileSizeUnitGb', TB: 'fileSizeUnitTb', }",
+          "description": "Maps each BYTE_UNITS abbreviation to its LyraMessageKey, for callers that\nwant a localized unit label (see formatFileSize's unitLabel parameter)."
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "FILE_SIZE_UNIT_KEYS",
+          "declaration": {
+            "name": "FILE_SIZE_UNIT_KEYS",
+            "module": "src/components/attachment-chip/attachment-chip.class.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "LyraAttachmentChip",
@@ -2313,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"
             },
             {
@@ -2597,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"
             },
             {
@@ -2657,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": [
             {
@@ -2665,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",
@@ -2681,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"
             },
             {
@@ -2712,6 +2746,15 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "hasIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "imageFailed",
@@ -2728,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"
             },
             {
@@ -2746,6 +2789,11 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "onIconSlotChange",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "onImageError",
@@ -2769,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
             },
@@ -2779,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"
             },
             {
@@ -2968,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"
             },
             {
@@ -2977,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"
             },
             {
@@ -3008,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"
             },
             {
@@ -3016,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"
             },
             {
@@ -8567,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"
             },
             {
@@ -9232,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"
             },
             {
@@ -10619,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",
@@ -10665,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",
@@ -10767,12 +10817,11 @@
             },
             {
               "kind": "field",
-              "name": "liveText",
+              "name": "liveRegion",
               "type": {
-                "text": "string"
+                "text": "LyraLiveRegion | undefined"
               },
-              "privacy": "private",
-              "default": "''"
+              "privacy": "private"
             },
             {
               "kind": "field",
@@ -11586,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": {
@@ -11611,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": {
@@ -16304,6 +16353,17 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "stoppable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When `false`, the built-in button never renders as a Stop/cancel control\nwhile busy -- instead it stays a (disabled) Send button, since there is\nno cancellation operation to offer. Defaults to `true`, reproducing\ntoday's Stop-button behavior for every `status` other than `'idle'`.",
+              "attribute": "stoppable",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "strings",
@@ -16578,7 +16638,7 @@
               "name": "lyra-input"
             },
             {
-              "description": "Fired by the built-in button while `status` is `\"sending\"` or `\"streaming\"`. No detail.",
+              "description": "Fired by the built-in button while `status` is `\"sending\"` or `\"streaming\"` and `stoppable` is `true` (the default). No detail.",
               "name": "lyra-stop"
             },
             {
@@ -16632,6 +16692,15 @@
               "default": "'idle'",
               "fieldName": "status"
             },
+            {
+              "name": "stoppable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When `false`, the built-in button never renders as a Stop/cancel control\nwhile busy -- instead it stays a (disabled) Send button, since there is\nno cancellation operation to offer. Defaults to `true`, reproducing\ntoday's Stop-button behavior for every `status` other than `'idle'`.",
+              "fieldName": "stoppable"
+            },
             {
               "name": "submit-on-enter",
               "type": {
@@ -18557,7 +18626,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
             },
@@ -18586,6 +18655,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",
@@ -18751,7 +18831,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"
             },
             {
@@ -18788,9 +18868,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": {
@@ -20031,6 +20120,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",
@@ -21104,7 +21303,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"
             },
             {
@@ -21236,8 +21436,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"
             },
             {
@@ -21373,8 +21573,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"
             },
             {
@@ -21946,7 +22146,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"
             },
             {
@@ -21978,8 +22179,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"
             },
             {
@@ -22038,8 +22239,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"
             },
             {
@@ -22571,6 +22772,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",
@@ -24452,7 +24663,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"
             },
             {
@@ -25247,7 +25458,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"
             },
             {
@@ -25694,7 +25905,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"
             },
             {
@@ -25709,7 +25920,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"
             },
             {
@@ -26471,7 +26682,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"
             },
             {
@@ -26480,7 +26691,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"
             },
             {
@@ -27191,6 +27402,14 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "copyTimeoutId",
+              "type": {
+                "text": "ReturnType<typeof setTimeout> | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "copyable",
@@ -27229,6 +27448,15 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "justCopied",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "locale",
@@ -29353,6 +29581,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "_isFirstUpdate",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "true"
+            },
             {
               "kind": "field",
               "name": "cleanup",
@@ -29394,6 +29631,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",
@@ -29432,7 +29679,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"
             },
             {
@@ -29804,6 +30051,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": [
@@ -29829,7 +30084,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"
             },
             {
@@ -30038,6 +30293,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",
@@ -32153,6 +32418,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"
@@ -32727,7 +32996,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",
@@ -34570,7 +34840,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": [
@@ -35766,6 +36036,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."
@@ -35790,9 +36067,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": [
@@ -36446,6 +36730,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",
@@ -36747,6 +37041,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": {
@@ -36918,10 +37221,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"
@@ -38146,6 +38461,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",
@@ -39108,7 +39443,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": [
             {
@@ -39161,6 +39496,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",
@@ -39175,6 +39520,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",
@@ -39213,7 +39568,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"
             },
             {
@@ -39664,13 +40019,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"
             },
             {
@@ -40342,6 +40706,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",
@@ -40625,6 +41000,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"
@@ -41361,6 +41750,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "The current step, in `[0, length)`.",
               "attribute": "index"
             },
             {
@@ -41370,6 +41760,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"
             },
             {
@@ -41379,6 +41770,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Total number of steps to play through; the index range is `[0, length)`.",
               "attribute": "length"
             },
             {
@@ -41738,6 +42130,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "The current step, in `[0, length)`.",
               "fieldName": "index"
             },
             {
@@ -41746,6 +42139,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"
             },
             {
@@ -41754,6 +42148,7 @@
                 "text": "number"
               },
               "default": "0",
+              "description": "Total number of steps to play through; the index range is `[0, length)`.",
               "fieldName": "length"
             },
             {
@@ -41833,7 +42228,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": [
             {
@@ -41841,7 +42236,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"
             },
             {
@@ -43702,6 +44097,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",
@@ -43943,6 +44348,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": {
@@ -44033,6 +44447,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"
@@ -44891,7 +45309,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"
             },
             {
@@ -46570,7 +46988,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": [
             {
@@ -47456,7 +47874,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",
@@ -49036,7 +49454,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",
@@ -50907,7 +51325,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-table>` — a presentational, sort/select-aware data table.\n\nHeader/row activation is delegated: one `click` and one `keydown`\nlistener on `<table>` resolve the target via `closest('[data-col-key]'\n| '[data-row-key]')` and a key→object lookup map, instead of allocating\nfresh per-column/per-row closures on every render. Both listeners guard\nagainst nested interactive `cell()` content first (see\n`INTERACTIVE_SELECTOR`) so a button/link/input inside a cell owns its own\nactivation instead of triggering `lyra-row-click`.\n\nKeyboard focus follows a roving-tabindex pattern (one `tabindex=\"0\"` stop\namong the header cells, one among the body rows — see `focusedColKey()` /\n`focusedRowKey()`), matching this repo's other `role=\"grid\"`/composite\nwidgets. Left/Right/Home/End move within the header row; Up/Down/Home/End\nmove within the body; Down from the header enters the body's roving stop,\nand Up from the body's first row returns to the header's roving stop.\nEnter/Space still only sort/activate (see `activateColumn()` /\n`activateRow()`).\n\nSet `aria-label` on the host to give the `role=\"grid\"` element an\naccessible name; it's forwarded into the shadow DOM's `<table>`.\n\n`columns[].priority` ('medium' | 'low') hides that column under\n`[part='base']`'s `@container` breakpoints; `[part='reveal-columns-button']`\nforces them all back into view. Rather than a *static* check of whether any\ncolumn merely declares a `priority`, the button (and the public\n`columnsHidden` property, see below) reflects whether a `priority` column\nis *actually* hidden right now — measured via `ResizeObserver` on\n`[part='base']` plus a post-render DOM check — or `showAllColumns`\nforce-visible mode is currently active (so there's still a way to toggle\nit back off). `columns[].sticky` pins a column's header/cells to the\ninline-start edge while the table scrolls horizontally.",
+          "description": "`<lyra-table>` — a presentational, sort/select-aware data table.\n\nHeader/row activation is delegated: one `click` and one `keydown`\nlistener on `<table>` resolve the target via `closest('[data-col-key]'\n| '[data-row-key]')` and a key→object lookup map, instead of allocating\nfresh per-column/per-row closures on every render. Both listeners guard\nagainst nested interactive `cell()` content first (see\n`INTERACTIVE_SELECTOR`) so a button/link/input inside a cell owns its own\nactivation instead of triggering `lyra-row-click`.\n\nKeyboard focus follows a roving-tabindex pattern (one `tabindex=\"0\"` stop\namong the header cells, one among the body rows — see `focusedColKey()` /\n`focusedRowKey()`), matching this repo's other `role=\"grid\"`/composite\nwidgets. Left/Right/Home/End move within the header row; Up/Down/Home/End\nmove within the body; Down from the header enters the body's roving stop,\nand Up from the body's first row returns to the header's roving stop.\nEnter/Space still only sort/activate (see `activateColumn()` /\n`activateRow()`).\n\nSet `aria-label` on the host to give the `role=\"grid\"` element an\naccessible name; it's forwarded into the shadow DOM's `<table>`.\n\n`columns[].priority` ('medium' | 'low') hides that column under\n`[part='base']`'s `@container` breakpoints; `[part='reveal-columns-button']`\nforces them all back into view. Rather than a *static* check of whether any\ncolumn merely declares a `priority`, the button (and the public\n`columnsHidden` property, see below) reflects whether a `priority` column\nis *actually* hidden right now — measured via `ResizeObserver` on\n`[part='base']` plus a post-render DOM check — or `showAllColumns`\nforce-visible mode is currently active (so there's still a way to toggle\nit back off). `columns[].sticky` pins a column's header/cells to the\ninline-start (default/`true`) or inline-end (`'end'`) edge while the table scrolls horizontally.",
           "name": "LyraTable",
           "cssParts": [
             {
@@ -52448,7 +52866,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"
             },
             {
@@ -52717,7 +53135,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"
             },
             {
@@ -52791,7 +53209,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": [
             {
@@ -54978,7 +55396,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": [
             {
@@ -55049,7 +55467,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"
             },
             {
@@ -55440,6 +55858,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"
             }
           ],
@@ -55450,7 +55872,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"
             },
             {
@@ -55579,6 +56001,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"
@@ -55590,6 +56016,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": [
@@ -56709,7 +57139,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
             },
@@ -56847,7 +57277,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",
@@ -56971,7 +57401,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.",
@@ -57015,7 +57445,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"
             },
             {
@@ -58323,6 +58753,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"
@@ -58747,7 +59181,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": [
@@ -59254,7 +59693,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": [
             {
@@ -59282,7 +59721,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
             },
             {
@@ -59320,7 +59759,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"
             },
             {
@@ -59545,7 +59984,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"
             },
             {
@@ -60538,6 +60977,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"
@@ -60549,6 +60996,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": [
@@ -60826,7 +61277,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",
@@ -60993,15 +61444,15 @@
           ],
           "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"
             }
           ],
@@ -61603,6 +62054,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",