@aceshooting/lyra-ui 2.9.0 → 2.11.0

package/custom-elements.json

@@ -3139,6 +3139,472 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/button/button.class.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<lyra-button>` — a generic action-button primitive, the `lyra-*` equivalent of a plain\n`wa-button`. Renders an internal native `<button part=\"base\">` (never a real `<wa-button>` —\nthis library has no runtime dependency on Web Awesome, matching `<lyra-copy-button>`/\n`<lyra-export-button>`'s own clean-room, API-mirroring approach). `type=\"submit\"`/`type=\"reset\"`\nare handled by this component itself via the host's own `closest('form')` — a shadow-internal\nnative `<button type=\"submit\">` does not participate in an ancestor light-DOM form's submission\non its own, since form-submitter semantics don't cross the shadow boundary.\n\nA host `aria-label` is forwarded to the internal button as a literal string (for an icon-only\nbutton with no visible label); external `aria-labelledby`/`aria-describedby` idrefs are not\ncopied across the shadow boundary.",
+          "name": "LyraButton",
+          "cssParts": [
+            {
+              "description": "The internal native `<button>`.",
+              "name": "base"
+            },
+            {
+              "description": "The `end` slot wrapper.",
+              "name": "end"
+            },
+            {
+              "description": "The default-slot label wrapper.",
+              "name": "label"
+            },
+            {
+              "description": "The loading spinner, present only while `loading` is `true`.",
+              "name": "spinner"
+            },
+            {
+              "description": "The `start` slot wrapper.",
+              "name": "start"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Default slot: the button's label content.",
+              "name": ""
+            },
+            {
+              "description": "Trailing icon/content, rendered after the label.",
+              "name": "end"
+            },
+            {
+              "description": "Leading icon/content, rendered before the label.",
+              "name": "start"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "appearance",
+              "type": {
+                "text": "ButtonAppearance"
+              },
+              "default": "'filled'",
+              "attribute": "appearance",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "buttonEl",
+              "type": {
+                "text": "HTMLButtonElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "effectiveDirection",
+              "type": {
+                "text": "'ltr' | 'rtl'"
+              },
+              "privacy": "protected",
+              "description": "The effective text direction, including inherited CSS direction.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "effectiveLocale",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "The effective locale used by this component.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows an internal spinner in place of interaction affordance and disables the button, without\nclearing `disabled` — a consumer's own `disabled` state and a transient `loading` state are\nindependent (mirrors `<lyra-export-button>`'s own `loading`/`disabled` pair).",
+              "attribute": "loading",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.",
+              "attribute": "locale",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "onClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "ButtonSize"
+              },
+              "default": "'m'",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "stopLocaleSubscription",
+              "type": {
+                "text": "() => void | undefined"
+              },
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "strings",
+              "type": {
+                "text": "LyraLocaleStrings"
+              },
+              "default": "{}",
+              "description": "Per-instance message overrides, useful for application-specific wording.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "ButtonType"
+              },
+              "default": "'button'",
+              "description": "Forwarded to this component's own submit/reset handling — see the class doc comment above\nfor why this component (not the shadow-internal `<button>`) owns that behavior.",
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "ButtonVariant"
+              },
+              "default": "'neutral'",
+              "description": "Tone vocabulary shared with `<lyra-chip>`/`<lyra-avatar>`'s own `tone` property, named\n`variant` here (not `tone`) to mirror `wa-button`'s own attribute name for a mechanical\nmigration off a plain `wa-button`.",
+              "attribute": "variant",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "addEventListener",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: this, event: Events[K]) => unknown"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "blur",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "CustomEvent<T>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "LyraEmitOptions"
+                  }
+                }
+              ],
+              "description": "Dispatch a composed, bubbling custom event; notifications are not veto points by default.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "localize",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "fallback",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "values",
+                  "optional": true,
+                  "type": {
+                    "text": "Record<string, string | number>"
+                  }
+                }
+              ],
+              "description": "Resolve a localized message using this component's overrides and locale.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "removeEventListener",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: this, event: Events[K]) => unknown"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | EventListenerOptions"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "appearance",
+              "type": {
+                "text": "ButtonAppearance"
+              },
+              "default": "'filled'",
+              "fieldName": "appearance"
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows an internal spinner in place of interaction affordance and disables the button, without\nclearing `disabled` — a consumer's own `disabled` state and a transient `loading` state are\nindependent (mirrors `<lyra-export-button>`'s own `loading`/`disabled` pair).",
+              "fieldName": "loading"
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.",
+              "fieldName": "locale",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "ButtonSize"
+              },
+              "default": "'m'",
+              "fieldName": "size"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "ButtonType"
+              },
+              "default": "'button'",
+              "description": "Forwarded to this component's own submit/reset handling — see the class doc comment above\nfor why this component (not the shadow-internal `<button>`) owns that behavior.",
+              "fieldName": "type"
+            },
+            {
+              "name": "variant",
+              "type": {
+                "text": "ButtonVariant"
+              },
+              "default": "'neutral'",
+              "description": "Tone vocabulary shared with `<lyra-chip>`/`<lyra-avatar>`'s own `tone` property, named\n`variant` here (not `tone`) to mirror `wa-button`'s own attribute name for a mechanical\nmigration off a plain `wa-button`.",
+              "fieldName": "variant"
+            }
+          ],
+          "superclass": {
+            "name": "LyraElement",
+            "module": "/src/internal/lyra-element.js"
+          },
+          "tagName": "lyra-button",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LyraButton",
+          "declaration": {
+            "name": "LyraButton",
+            "module": "src/components/button/button.class.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/button/button.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "lyra-button",
+          "declaration": {
+            "name": "LyraButton",
+            "module": "src/components/button/button.class.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/components/button/button.class.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/card/card.class.ts",
@@ -34385,6 +34851,15 @@
               "name": "scheduleDraw",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "selectedCell",
+              "type": {
+                "text": "HeatmapSelectedCell | null"
+              },
+              "default": "null",
+              "description": "The single cell to mark as persistently selected -- `row`/`col` in matrix mode, `date` in\ncalendar mode. Purely a controlled, consumer-owned visual/accessibility marker, mirroring\n`<lyra-lite-chart>`'s `selectedIndex` -- this component never mutates it itself; a consumer\nwires it up from `lyra-cell-click` (or any other source) to build a toggle-select\ninteraction. Unset (the default, `null`) draws no selection ring, adds no selected-cell text\nto the host's `aria-label`, and adds no \"(selected)\" suffix to the live-region announcement,\nreproducing today's exact output."
+            },
             {
               "kind": "field",
               "name": "stopLocaleSubscription",
@@ -34882,6 +35357,25 @@
               ],
               "description": "Dispatches to the host-provided `cellInteractive` predicate when set, otherwise `true`\n(every cell interactive, today's unchanged default)."
             },
+            {
+              "kind": "method",
+              "name": "isSelectedPos",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pos",
+                  "type": {
+                    "text": "CellPos"
+                  }
+                }
+              ],
+              "description": "Whether `selectedCell` refers to the given grid position, in whichever mode is active --\n`row`/`col` equality in matrix mode, resolved-date equality in calendar mode (looking the\nposition's actual date up via `calendarCellAt()`, the same way the annotation ring resolves\n`ann.date` against `cells`). Shared by the live-region announcement, which needs to know\nwhether the just-announced cell *is* the selection."
+            },
             {
               "kind": "method",
               "name": "labelColor",
@@ -35254,6 +35748,28 @@
               },
               "description": "Reads the customizable ramp endpoints off the host's computed style."
             },
+            {
+              "kind": "method",
+              "name": "selectedCellDescription",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "The localized \"Selected: <cell>.\" description appended to the host `aria-label`, or `''` when\n`selectedCell` is unset or doesn't resolve to a real cell in the current grid."
+            },
+            {
+              "kind": "method",
+              "name": "selectedColor",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "description": "Reads the customizable canvas-drawn selected-cell-ring stroke color off the host's computed style."
+            },
             {
               "kind": "method",
               "name": "tooltipStyle",
@@ -35646,74 +36162,75 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/json-viewer/json-viewer.class.ts",
+      "path": "src/components/input/input.class.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-json-viewer>` — a collapsible, copyable tree view for an arbitrary\nJSON-serializable value (object/array/string/number/boolean/null/\nundefined). Serves as the fallback renderer wherever a raw payload (tool\ncall arguments, a tool result, an API response) needs inspecting without a\nbespoke view.\n\nExpand/collapse state is keyed by structural path (not by object identity),\nso it survives a `data` reassignment that keeps the same shape -- e.g. a\nstreaming tool result being patched in place.",
-          "name": "LyraJsonViewer",
+          "description": "`<lyra-input>` — a single-line plain-text input primitive, the `lyra-*` equivalent of a plain\n`wa-input`, form-associated via the `FormAssociated` mixin (same shape as `<lyra-textarea>`).\n\nShips the same opt-in `label`/`hint`/`errorText` form-control chrome as `<lyra-textarea>`/\n`<lyra-select>` (props + matching named slots + `form-control`/`form-control-label`/`hint`/`error`\nparts) — left unset, the chrome stays hidden. `size` uses the same `xs`–`xl` scale as\n`<lyra-select>`/`<lyra-combobox>`. `type=\"password\"` always renders a\n`password-toggle` eye-icon button that flips the internal native input between\n`type=\"password\"`/`type=\"text\"` and tracks `passwordVisible`. `type=\"email\"`/`type=\"number\"`\n(with `min`/`max`/`step`) delegate constraint validation to the internal native `<input>`'s own\nbrowser-computed `validity`, bridged into this element's `ElementInternals` by `updateValidity()`.\n\nA host `aria-label` is forwarded to the internal textbox via the typed `accessibleLabel` property;\nexternal `aria-labelledby`/`aria-describedby` idrefs are not copied across the shadow boundary.",
+          "name": "LyraInput",
           "cssParts": [
             {
-              "description": "The root scroll container; respects `max-height`.",
-              "name": "base"
+              "description": "The error message.",
+              "name": "error"
             },
             {
-              "description": "A `{`, `}`, `[`, or `]` delimiter.",
-              "name": "bracket"
+              "description": "The outer wrapper around label, input, error and hint.",
+              "name": "form-control"
             },
             {
-              "description": "A copy-to-clipboard button -- the top-level one (in `toolbar`, labelled \"Copy JSON to clipboard\") or a per-node one (only rendered when `copyable`; labelled with its own key/type, e.g. \"Copy age\", so assistive tech can tell rows apart).",
-              "name": "copy-button"
+              "description": "The `<label>` element.",
+              "name": "form-control-label"
             },
             {
-              "description": "An object property key or array index label.",
-              "name": "key"
+              "description": "The hint message.",
+              "name": "hint"
             },
             {
-              "description": "A container node's expand/collapse button (hidden, but present for row alignment, on leaf/empty nodes).",
-              "name": "toggle"
+              "description": "The native `<input>` element.",
+              "name": "input"
             },
             {
-              "description": "The wrapper around the top-level copy button (only rendered when `copyable`).",
-              "name": "toolbar"
+              "description": "The row wrapping the native input and the password-toggle button.",
+              "name": "input-wrapper"
             },
             {
-              "description": "The wrapper around the rendered node tree.",
-              "name": "tree"
+              "description": "The show/hide-password button, present only when `type=\"password\"`.",
+              "name": "password-toggle"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Custom error content.",
+              "name": "error"
             },
             {
-              "description": "A primitive value's text -- carries `data-type` (`string`/`number`/`boolean`/`null`/`undefined`, or `circular` for a self-reference marker in place of a re-visited container's subtree) for per-type coloring, and `data-match` while it matches `search`.",
-              "name": "value"
+              "description": "Custom hint content.",
+              "name": "hint"
+            },
+            {
+              "description": "Custom label content.",
+              "name": "label"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "collapsedDepth",
-              "type": {
-                "text": "number | undefined"
-              },
-              "description": "Nodes at or beyond this nesting depth (root = 0) start collapsed. Omit/undefined: nothing auto-collapses.",
-              "attribute": "collapsed-depth"
-            },
-            {
-              "kind": "field",
-              "name": "copyable",
+              "name": "accessibleLabel",
               "type": {
-                "text": "boolean"
+                "text": "string | null"
               },
-              "default": "false",
-              "description": "Shows copy-to-clipboard affordances: one for the whole value, plus one per node.",
-              "attribute": "copyable",
-              "reflects": true
+              "default": "null",
+              "description": "Accessible name overriding the label/placeholder-derived default. Takes precedence over both\n`label` and `placeholder` when set, matching `<lyra-textarea>`'s `accessibleLabel`.",
+              "attribute": "aria-label"
             },
             {
               "kind": "field",
-              "name": "data",
+              "name": "autocomplete",
               "type": {
-                "text": "unknown"
+                "text": "string"
               },
-              "description": "The value to render. Any JSON-serializable value, plus `undefined`."
+              "default": "''",
+              "attribute": "autocomplete"
             },
             {
               "kind": "field",
@@ -35745,10 +36262,74 @@
             },
             {
               "kind": "field",
-              "name": "expandedOverrides",
+              "name": "errorText",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "error-text"
+            },
+            {
+              "kind": "field",
+              "name": "hasErrorSlot",
+              "type": {
+                "text": "boolean"
+              },
               "privacy": "private",
-              "default": "new Map<string, boolean>()",
-              "description": "Per-path (`JSON.stringify(path)`) explicit expand/collapse, overriding\nthe `collapsedDepth`/search defaults once a node's toggle has been used.\nPruned in `willUpdate()` (to the paths still reachable in the tree)\nwhenever `data` changes, so a long-lived instance bound to reshaping\ndata -- this component's own stated streaming use case -- doesn't\naccumulate one entry per path ever toggled for the life of the instance."
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hasHintSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hasLabelSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hint",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "hint"
+            },
+            {
+              "kind": "field",
+              "name": "input",
+              "type": {
+                "text": "HTMLInputElement | null"
+              },
+              "description": "The internal native `<input>` element, for direct DOM access — mirrors `<lyra-textarea>`'s own `input` getter.",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "inputEl",
+              "type": {
+                "text": "HTMLInputElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "label"
             },
             {
               "kind": "field",
@@ -35767,33 +36348,660 @@
             },
             {
               "kind": "field",
-              "name": "maxHeight",
+              "name": "max",
               "type": {
-                "text": "string"
+                "text": "number | undefined"
               },
-              "default": "''",
-              "description": "A CSS length (e.g. `\"20rem\"`); once set, the viewer scrolls internally past this height instead of growing the page.",
-              "attribute": "max-height"
+              "attribute": "max"
             },
             {
               "kind": "field",
-              "name": "search",
+              "name": "min",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "`type=\"number\"` only — forwarded to the internal native `<input>`'s own `min`/`max`/`step`\nand consulted by that same native input's constraint validation (see `updateValidity()`).",
+              "attribute": "min"
+            },
+            {
+              "kind": "field",
+              "name": "onBlur",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onErrorSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onFocus",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onHintSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onInput",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onLabelSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onTogglePasswordVisible",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "passwordVisible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "`type=\"password\"` only — whether the field currently reveals its raw text. Toggled by the\nbuilt-in `password-toggle` button; also settable by a consumer up front.",
+              "attribute": "password-visible"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Case-insensitive substring match against keys/values; matches are highlighted and their ancestors auto-expanded.",
-              "attribute": "search"
+              "attribute": "placeholder"
             },
             {
               "kind": "field",
-              "name": "searchState",
+              "name": "size",
               "type": {
-                "text": "SearchState"
+                "text": "LyraInputSize"
               },
-              "privacy": "private",
-              "default": "{ keyMatches: new Set(), valueMatches: new Set(), forceExpand: new Set(), paths: new Set(), }",
-              "description": "Memoized result of the last `computeSearch()` walk -- see `willUpdate()`."
+              "default": "'m'",
+              "description": "Visual size — same `xs`–`xl` scale as `lyra-select`/`lyra-combobox`'s own `size`.",
+              "attribute": "size",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "step",
+              "type": {
+                "text": "number | undefined"
+              },
+              "attribute": "step"
+            },
+            {
+              "kind": "field",
+              "name": "stopLocaleSubscription",
+              "type": {
+                "text": "() => void | undefined"
+              },
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "strings",
+              "type": {
+                "text": "LyraLocaleStrings"
+              },
+              "default": "{}",
+              "description": "Per-instance message overrides, useful for application-specific wording.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "touched",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "LyraInputType"
+              },
+              "default": "'text'",
+              "attribute": "type"
+            },
+            {
+              "kind": "method",
+              "name": "addEventListener",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: this, event: Events[K]) => unknown"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | AddEventListenerOptions"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "blur",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "CustomEvent<T>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "LyraEmitOptions"
+                  }
+                }
+              ],
+              "description": "Dispatch a composed, bubbling custom event; notifications are not veto points by default.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "focus",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "FocusOptions"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "localize",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "fallback",
+                  "optional": true,
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "values",
+                  "optional": true,
+                  "type": {
+                    "text": "Record<string, string | number>"
+                  }
+                }
+              ],
+              "description": "Resolve a localized message using this component's overrides and locale.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "removeEventListener",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "type",
+                  "type": {
+                    "text": "K"
+                  }
+                },
+                {
+                  "name": "listener",
+                  "type": {
+                    "text": "(this: this, event: Events[K]) => unknown"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "boolean | EventListenerOptions"
+                  }
+                }
+              ],
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "select",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "updateValidity",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Bridges the internal native `<input>`'s own browser-computed constraint validation (format for\n`type=\"email\"`, range/step for `type=\"number\"`) into this element's `ElementInternals`, instead\nof hand-rolling a second regex-based check — a real native input of the right `type` already\ncomputes `typeMismatch`/`rangeUnderflow`/`rangeOverflow`/`stepMismatch` correctly. Falls back to\nthe base mixin's plain required-and-empty check before the first render (`inputEl` unset).\n\nA typed native input (`number`, `email`, …) also runs its own value-sanitization algorithm on\nassignment, which silently rewrites an unparseable non-empty value to `''` without setting any\n`ValidityState` flag — left unchecked, `native.validity.valid` would then read `true` (empty is\nfine when not required) while `this.value`/the bridged form value still held the literal invalid\nstring. Detect that mismatch and report it as `badInput` instead of trusting native blindly."
+            }
+          ],
+          "events": [
+            {
+              "description": "Re-dispatched from the internal native `<input>`'s own `blur` — bubbling and composed (unlike the native event, which is neither).",
+              "name": "blur"
+            },
+            {
+              "description": "Re-dispatched from the internal native `<input>`'s own `focus`, for the same reason as `blur`.",
+              "name": "focus"
+            },
+            {
+              "description": "Fired on the native `change` timing (control loses focus after a committed edit). `detail: { value }`.",
+              "name": "lyra-change"
+            },
+            {
+              "description": "Fired on every user-driven edit (not a programmatic `.value` assignment). `detail: { value }`.",
+              "name": "lyra-input"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "aria-label",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Accessible name overriding the label/placeholder-derived default. Takes precedence over both\n`label` and `placeholder` when set, matching `<lyra-textarea>`'s `accessibleLabel`.",
+              "fieldName": "accessibleLabel"
+            },
+            {
+              "name": "autocomplete",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "autocomplete"
+            },
+            {
+              "name": "error-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "errorText"
+            },
+            {
+              "name": "hint",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "hint"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "label"
+            },
+            {
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.",
+              "fieldName": "locale",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "name": "max",
+              "type": {
+                "text": "number | undefined"
+              },
+              "fieldName": "max"
+            },
+            {
+              "name": "min",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "`type=\"number\"` only — forwarded to the internal native `<input>`'s own `min`/`max`/`step`\nand consulted by that same native input's constraint validation (see `updateValidity()`).",
+              "fieldName": "min"
+            },
+            {
+              "name": "password-visible",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "`type=\"password\"` only — whether the field currently reveals its raw text. Toggled by the\nbuilt-in `password-toggle` button; also settable by a consumer up front.",
+              "fieldName": "passwordVisible"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "placeholder"
+            },
+            {
+              "name": "size",
+              "type": {
+                "text": "LyraInputSize"
+              },
+              "default": "'m'",
+              "description": "Visual size — same `xs`–`xl` scale as `lyra-select`/`lyra-combobox`'s own `size`.",
+              "fieldName": "size"
+            },
+            {
+              "name": "step",
+              "type": {
+                "text": "number | undefined"
+              },
+              "fieldName": "step"
+            },
+            {
+              "name": "type",
+              "type": {
+                "text": "LyraInputType"
+              },
+              "default": "'text'",
+              "fieldName": "type"
+            }
+          ],
+          "mixins": [
+            {
+              "name": "FormAssociated",
+              "module": "/src/internal/form-associated.js"
+            }
+          ],
+          "superclass": {
+            "name": "LyraInputBase",
+            "module": "src/components/input/input.class.ts"
+          },
+          "tagName": "lyra-input",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LyraInput",
+          "declaration": {
+            "name": "LyraInput",
+            "module": "src/components/input/input.class.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/input/input.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "lyra-input",
+          "declaration": {
+            "name": "LyraInput",
+            "module": "src/components/input/input.class.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/components/input/input.class.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/json-viewer/json-viewer.class.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<lyra-json-viewer>` — a collapsible, copyable tree view for an arbitrary\nJSON-serializable value (object/array/string/number/boolean/null/\nundefined). Serves as the fallback renderer wherever a raw payload (tool\ncall arguments, a tool result, an API response) needs inspecting without a\nbespoke view.\n\nExpand/collapse state is keyed by structural path (not by object identity),\nso it survives a `data` reassignment that keeps the same shape -- e.g. a\nstreaming tool result being patched in place.",
+          "name": "LyraJsonViewer",
+          "cssParts": [
+            {
+              "description": "The root scroll container; respects `max-height`.",
+              "name": "base"
+            },
+            {
+              "description": "A `{`, `}`, `[`, or `]` delimiter.",
+              "name": "bracket"
+            },
+            {
+              "description": "A copy-to-clipboard button -- the top-level one (in `toolbar`, labelled \"Copy JSON to clipboard\") or a per-node one (only rendered when `copyable`; labelled with its own key/type, e.g. \"Copy age\", so assistive tech can tell rows apart).",
+              "name": "copy-button"
+            },
+            {
+              "description": "An object property key or array index label.",
+              "name": "key"
+            },
+            {
+              "description": "A container node's expand/collapse button (hidden, but present for row alignment, on leaf/empty nodes).",
+              "name": "toggle"
+            },
+            {
+              "description": "The wrapper around the top-level copy button (only rendered when `copyable`).",
+              "name": "toolbar"
+            },
+            {
+              "description": "The wrapper around the rendered node tree.",
+              "name": "tree"
+            },
+            {
+              "description": "A primitive value's text -- carries `data-type` (`string`/`number`/`boolean`/`null`/`undefined`, or `circular` for a self-reference marker in place of a re-visited container's subtree) for per-type coloring, and `data-match` while it matches `search`.",
+              "name": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "collapsedDepth",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Nodes at or beyond this nesting depth (root = 0) start collapsed. Omit/undefined: nothing auto-collapses.",
+              "attribute": "collapsed-depth"
+            },
+            {
+              "kind": "field",
+              "name": "copyable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows copy-to-clipboard affordances: one for the whole value, plus one per node.",
+              "attribute": "copyable",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "data",
+              "type": {
+                "text": "unknown"
+              },
+              "description": "The value to render. Any JSON-serializable value, plus `undefined`."
+            },
+            {
+              "kind": "field",
+              "name": "effectiveDirection",
+              "type": {
+                "text": "'ltr' | 'rtl'"
+              },
+              "privacy": "protected",
+              "description": "The effective text direction, including inherited CSS direction.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "effectiveLocale",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "protected",
+              "description": "The effective locale used by this component.",
+              "readonly": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "expandedOverrides",
+              "privacy": "private",
+              "default": "new Map<string, boolean>()",
+              "description": "Per-path (`JSON.stringify(path)`) explicit expand/collapse, overriding\nthe `collapsedDepth`/search defaults once a node's toggle has been used.\nPruned in `willUpdate()` (to the paths still reachable in the tree)\nwhenever `data` changes, so a long-lived instance bound to reshaping\ndata -- this component's own stated streaming use case -- doesn't\naccumulate one entry per path ever toggled for the life of the instance."
+            },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.",
+              "attribute": "locale",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "maxHeight",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A CSS length (e.g. `\"20rem\"`); once set, the viewer scrolls internally past this height instead of growing the page.",
+              "attribute": "max-height"
+            },
+            {
+              "kind": "field",
+              "name": "search",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Case-insensitive substring match against keys/values; matches are highlighted and their ancestors auto-expanded.",
+              "attribute": "search"
+            },
+            {
+              "kind": "field",
+              "name": "searchState",
+              "type": {
+                "text": "SearchState"
+              },
+              "privacy": "private",
+              "default": "{ keyMatches: new Set(), valueMatches: new Set(), forceExpand: new Set(), paths: new Set(), }",
+              "description": "Memoized result of the last `computeSearch()` walk -- see `willUpdate()`."
             },
             {
               "kind": "field",
@@ -61139,12 +62347,20 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lyra-tool-result-view>` — renders a tool call's result via whichever\ncustom renderer a host app has registered for it (see `registerToolRenderer()`\nin `registry.ts`), falling back to `<lyra-json-viewer>` whenever no\nrenderer matches, a candidate renderer's `matches()` predicate throws during\ndispatch, a renderer's optional `load()` rejects, or its `render()` throws.\nThis component owns none of the actual visual weight of a\npopulated tool result — that's entirely whatever the registered renderer\nreturns; this is just the dispatch + fallback + loading-state shell.\n\nDispatch runs against `registry` when set, otherwise against the\nmodule-level default registry `registerToolRenderer()` writes to — see\n`findToolRenderer()`'s two-step (exact name, then shape-based `matches()`)\nlookup order for the full rule.\n\n`fallback` only implements `\"json\"` today (an unconditional\n`<lyra-json-viewer>`) but is still accepted/reflected as an attribute so a\nconsumer's markup that already sets `fallback=\"…\"` for some future value\ndoesn't need to change again once more fallback kinds land.",
+          "description": "`<lyra-tool-result-view>` — renders a tool call's result via whichever\ncustom renderer a host app has registered for it (see `registerToolRenderer()`\nin `registry.ts`), falling back to `<lyra-json-viewer>` whenever no\nrenderer matches, a candidate renderer's `matches()` predicate throws during\ndispatch, a renderer's optional `load()` rejects, or its `render()` throws.\nThis component owns none of the actual visual weight of a\npopulated tool result — that's entirely whatever the registered renderer\nreturns; this is just the dispatch + fallback + loading-state shell.\n\nDispatch runs against `registry` when set, otherwise against the\nmodule-level default registry `registerToolRenderer()` writes to — see\n`findToolRenderer()`'s two-step (exact name, then shape-based `matches()`)\nlookup order for the full rule.\n\n`fallback` implements two kinds: `\"json\"` (the default, an unconditional `<lyra-json-viewer>`)\nand `\"text\"`, which renders a *string* `result` as preformatted text instead — falling back to\nthe `\"json\"` behavior when `result` isn't a string, so setting `fallback=\"text\"` defensively\nagainst an unpredictable result shape never renders broken output. `copyable` adds a\ncopy-to-clipboard affordance to either fallback kind (forwarded to `<lyra-json-viewer>`'s own\n`copyable` for `\"json\"`; a `<lyra-copy-button>` alongside the text for `\"text\"`).",
           "name": "LyraToolResultView",
           "cssParts": [
             {
               "description": "The root wrapper around the resolved renderer's output (or the loading/fallback view).",
               "name": "base"
+            },
+            {
+              "description": "The `<lyra-copy-button>` shown when `copyable` is set alongside the `fallback=\"text\"` kind (only present when both are set).",
+              "name": "fallback-copy"
+            },
+            {
+              "description": "The `<pre>` element for the `fallback=\"text\"` kind's preformatted result text (only present in that mode).",
+              "name": "fallback-text"
             }
           ],
           "members": [
@@ -61156,6 +62372,17 @@
               },
               "description": "The tool call's original arguments, if available — handed to the matched renderer's `render()` alongside `result`."
             },
+            {
+              "kind": "field",
+              "name": "copyable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows a copy-to-clipboard affordance alongside the fallback view (both `\"json\"` and `\"text\"` kinds) — forwarded to `<lyra-json-viewer>`'s own `copyable`, or renders a `<lyra-copy-button>` next to the text fallback.",
+              "attribute": "copyable",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "effectiveDirection",
@@ -61191,7 +62418,7 @@
                 "text": "string"
               },
               "default": "'json'",
-              "description": "Forward-compatible fallback-kind selector — see the class doc; only `\"json\"` is implemented today.",
+              "description": "Fallback-kind selector — see the class doc's `fallback` paragraph for the full \"json\" vs \"text\" behavior.",
               "attribute": "fallback",
               "reflects": true
             },
@@ -61447,6 +62674,16 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "renderFallback",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "unknown"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "renderWith",
@@ -61483,13 +62720,22 @@
             }
           ],
           "attributes": [
+            {
+              "name": "copyable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows a copy-to-clipboard affordance alongside the fallback view (both `\"json\"` and `\"text\"` kinds) — forwarded to `<lyra-json-viewer>`'s own `copyable`, or renders a `<lyra-copy-button>` next to the text fallback.",
+              "fieldName": "copyable"
+            },
             {
               "name": "fallback",
               "type": {
                 "text": "string"
               },
               "default": "'json'",
-              "description": "Forward-compatible fallback-kind selector — see the class doc; only `\"json\"` is implemented today.",
+              "description": "Fallback-kind selector — see the class doc's `fallback` paragraph for the full \"json\" vs \"text\" behavior.",
               "fieldName": "fallback"
             },
             {