@aceshooting/lyra-ui 4.1.0 → 4.2.0

package/custom-elements.json

@@ -703,7 +703,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lr-agent-run>` — the top-level shell for one `AgentRun`: lifecycle-status badge, elapsed\ntime, current step, model/cost summary, and built-in Cancel/Retry controls in a header, plus\nfour named composition slots (`tasks`/`tools`/`reasoning`/`output`) for the run's actual\ncontent. This is deliberately a SHELL, not a new step-rendering surface — every piece of\nper-step or per-invocation rendering routes through an existing primitive:\n\n- **Elapsed time**: composes `<lr-generation-status>` (`active`/`started-at`, its own built-in\n  Stop button hidden via `show-stop=\"false\"` since this component renders its own Cancel/Retry\n  pair instead) for the *live, ticking* readout while the run is genuinely in progress\n  (`running`/`waiting-input`/`waiting-approval`). `<lr-stream-status>` was considered too (per\n  this family's own composition brief) but doesn't fit: its `phase` vocabulary\n  (`idle`/`connecting`/`streaming`/`stalled`) models transport/connection health, not an agent\n  run's seven-state lifecycle, and it exposes no elapsed-time readout at all — exactly the\n  distinction `<lr-generation-status>`'s own class doc already draws between the two. Once the\n  run reaches a terminal state (`done`/`error`/`cancelled`) with both a `startedAt` and an\n  `endedAt`, this component instead renders a small locally-formatted static duration\n  (`endedAt - startedAt`): `<lr-generation-status>`'s freeze-on-`active=false` semantics only\n  ever freeze at whatever it last computed *live*, so mounting it directly against a completed\n  run loaded from history (e.g. `startedAt` yesterday, `endedAt` five minutes later, loaded\n  today) would either show a stale zero or the wrong multi-hour span — it has no way to render a\n  fixed historical span on demand. That static fallback reuses the same small `formatDuration()`\n  algorithm `<lr-usage-badge>` and `<lr-tool-call-chip>` already duplicate locally for the same\n  reason (see this file's own copy).\n- **Model + cost summary**: composes `<lr-usage-badge>`, fed `run.costEstimate` (formatted via\n  `formatCost`, or a plain `Intl.NumberFormat` by default — this library never assumes a\n  currency, see `<lr-format-number>`'s own explicit `currency` prop) as its `cost-text`.\n  `run.model` (a plain string with no analogous `<lr-usage-badge>` property) renders alongside\n  as plain text.\n- **Current step**: a single-line summary of whichever `run.steps` entry currently has\n  `status.kind === 'running'` (the last such entry, if more than one) — a plain text line, not a\n  list, so it doesn't duplicate `<lr-task-list>`'s own per-item rendering.\n- **Tasks slot default content**: when the host doesn't slot anything into `tasks` and\n  `run.steps` is non-empty, this component's own `<slot>` fallback renders a `<lr-task-list>`\n  populated by mapping every `AgentStep` to a `TaskItem` (see `toTaskItem()`) — a plain data\n  adapter between the two existing shapes, not new rendering.\n- **Status badge**: composes `<lr-badge>`. **Empty state**: composes `<lr-empty>` when `run` is\n  `null`.\n\n`tools`/`reasoning`/`output` are plain named slots with no default content — entirely the\nhost's own composition (typically `<lr-tool-call-chip>`/`<lr-tool-result-view>` rows,\nreasoning/streaming text, and final output respectively). An `actions` slot adds extra header\ncontrols alongside the built-in Cancel/Retry pair.\n\nThe built-in Cancel button renders while `showCancel` is true and the run's status is one of\n`TICKING_KINDS` (still genuinely in progress); Retry renders while `showRetry` is true and the\nstatus is `error` or `cancelled`. Clicking either fires `lr-cancel`/`lr-retry` with\n`CancelEventDetail`/`RetryEventDetail` from `src/ai/types.ts` — this component never cancels or\nretries anything itself, it only requests. `RetryEventDetail.attempt` is a 1-based counter\nlocal to this component, incremented on every `lr-retry` click and reset to `0` whenever\n`run.id` changes (a genuinely new run replacing the old one, as opposed to the same run's status\nmerely updating in place).\n\nLifecycle transitions into an attention-needing or terminal state (`waiting-input`,\n`waiting-approval`, `done`, `error`, `cancelled`) are announced through an internal\n`<lr-live-region>`, mirroring `<lr-stream-status>`'s own stall/recover announcements —\n`running`/`idle` transitions are frequent and not independently actionable, so they stay\nsilent, and whatever status a freshly-assigned `run` (a new `run.id`) happens to already carry\nis never itself treated as an eventful transition, only a later in-place change is.",
+          "description": "`<lr-agent-run>` — the top-level shell for one `AgentRun`: lifecycle-status badge, elapsed\ntime, current step, model/cost summary, and built-in Cancel/Retry controls in a header, plus\nfour named composition slots (`tasks`/`tools`/`reasoning`/`output`) for the run's actual\ncontent. This is deliberately a SHELL, not a new step-rendering surface — every piece of\nper-step or per-invocation rendering routes through an existing primitive:\n\n- **Elapsed time**: composes `<lr-generation-status>` (`active`/`started-at`, its own built-in\n  Stop button hidden via `show-stop=\"false\"` since this component renders its own Cancel/Retry\n  pair instead) for the *live, ticking* readout while the run is genuinely in progress\n  (`running`/`waiting-input`/`waiting-approval`). `<lr-stream-status>` was considered too (per\n  this family's own composition brief) but doesn't fit: its `phase` vocabulary\n  (`idle`/`connecting`/`streaming`/`stalled`) models transport/connection health, not an agent\n  run's seven-state lifecycle, and it exposes no elapsed-time readout at all — exactly the\n  distinction `<lr-generation-status>`'s own class doc already draws between the two. Once the\n  run reaches a terminal state (`done`/`error`/`cancelled`) with both a `startedAt` and an\n  `endedAt`, this component instead renders a small locally-formatted static duration\n  (`endedAt - startedAt`): `<lr-generation-status>`'s freeze-on-`active=false` semantics only\n  ever freeze at whatever it last computed *live*, so mounting it directly against a completed\n  run loaded from history (e.g. `startedAt` yesterday, `endedAt` five minutes later, loaded\n  today) would either show a stale zero or the wrong multi-hour span — it has no way to render a\n  fixed historical span on demand. That static fallback reuses the same small `formatDuration()`\n  algorithm `<lr-usage-badge>` and `<lr-tool-call-chip>` already duplicate locally for the same\n  reason (see this file's own copy).\n- **Model + cost summary**: composes `<lr-usage-badge>`, fed `run.costEstimate` (formatted via\n  `formatCost`, or a plain `Intl.NumberFormat` by default — this library never assumes a\n  currency, see `<lr-format-number>`'s own explicit `currency` prop) as its `cost-text`.\n  `run.model` (a plain string with no analogous `<lr-usage-badge>` property) renders alongside\n  as plain text.\n- **Current step**: a single-line summary of whichever `run.steps` entry currently has\n  `status.kind === 'running'` (the last such entry, if more than one) — a plain text line, not a\n  list, so it doesn't duplicate `<lr-task-list>`'s own per-item rendering.\n- **Tasks slot default content**: when the host doesn't slot anything into `tasks` and\n  `run.steps` is non-empty, this component's own `<slot>` fallback renders a `<lr-task-list>`\n  populated by mapping every `AgentStep` to a `TaskItem` (see `toTaskItem()`) — a plain data\n  adapter between the two existing shapes, not new rendering.\n- **Status badge**: composes `<lr-badge>`. **Empty state**: composes `<lr-empty>` when `run` is\n  `null`.\n\n`tools`/`reasoning`/`output` are plain named slots with no default content — entirely the\nhost's own composition (typically `<lr-tool-call-chip>`/`<lr-tool-result-view>` rows,\nreasoning/streaming text, and final output respectively). An `actions` slot adds extra header\ncontrols alongside the built-in Cancel/Retry pair. The `header` and `summary` slots replace the\nbuilt-in lifecycle header and model/usage/metrics summary respectively. `statusLabels` and\n`statusVariants` make application-defined lifecycle kinds first-class, while `metrics` renders\narbitrary labeled values such as prompt and completion token counts.\n\nThe built-in Cancel button renders while `showCancel` is true and the run's status is one of\n`TICKING_KINDS` (still genuinely in progress); Retry renders while `showRetry` is true and the\nstatus is `error` or `cancelled`. Clicking either fires `lr-cancel`/`lr-retry` with\n`CancelEventDetail`/`RetryEventDetail` from `src/ai/types.ts` — this component never cancels or\nretries anything itself, it only requests. `RetryEventDetail.attempt` is a 1-based counter\nlocal to this component, incremented on every `lr-retry` click and reset to `0` whenever\n`run.id` changes (a genuinely new run replacing the old one, as opposed to the same run's status\nmerely updating in place).\n\nLifecycle transitions into an attention-needing or terminal state (`waiting-input`,\n`waiting-approval`, `done`, `error`, `cancelled`) are announced through an internal\n`<lr-live-region>`, mirroring `<lr-stream-status>`'s own stall/recover announcements —\n`running`/`idle` transitions are frequent and not independently actionable, so they stay\nsilent, and whatever status a freshly-assigned `run` (a new `run.id`) happens to already carry\nis never itself treated as an eventful transition, only a later in-place change is.",
           "name": "LyraAgentRun",
           "cssParts": [
             {
@@ -750,6 +750,18 @@
               "description": "The header row wrapping status, elapsed time, current step, summary, and actions.",
               "name": "header"
             },
+            {
+              "description": "One arbitrary metric in the built-in summary.",
+              "name": "metric"
+            },
+            {
+              "description": "The metric's label.",
+              "name": "metric-label"
+            },
+            {
+              "description": "The metric's value.",
+              "name": "metric-value"
+            },
             {
               "description": "`run.model`, when set.",
               "name": "model"
@@ -800,6 +812,10 @@
               "description": "Extra header actions alongside the built-in Cancel/Retry buttons.",
               "name": "actions"
             },
+            {
+              "description": "Replaces the built-in lifecycle header and its built-in actions.",
+              "name": "header"
+            },
             {
               "description": "The run's final output content. No default content.",
               "name": "output"
@@ -808,6 +824,10 @@
               "description": "Reasoning/thinking content. No default content.",
               "name": "reasoning"
             },
+            {
+              "description": "Replaces the built-in model, usage, and metrics summary.",
+              "name": "summary"
+            },
             {
               "description": "Task/plan content. Falls back to a `<lr-task-list>` built from `run.steps` when nothing is slotted and `run.steps` is non-empty.",
               "name": "tasks"
@@ -902,6 +922,24 @@
               },
               "description": "Overrides the default plain `Intl.NumberFormat` rendering of `run.costEstimate` fed to the\ncomposed `<lr-usage-badge>`'s `cost-text` -- e.g. to add a currency symbol/code, which this\nlibrary never assumes on a host's behalf."
             },
+            {
+              "kind": "field",
+              "name": "hasHeaderSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hasSummarySlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "isTicking",
@@ -947,16 +985,35 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "metrics",
+              "type": {
+                "text": "AgentRunMetric[]"
+              },
+              "default": "[]",
+              "description": "Additional run metrics such as prompt/completion token counts."
+            },
             {
               "kind": "field",
               "name": "onCancelClick",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "onHeaderSlotChange",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "onRetryClick",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "onSummarySlotChange",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "pendingLoadController",
@@ -1033,6 +1090,24 @@
               "description": "The static formatted duration for a terminal run with both `startedAt` and `endedAt` --\n`undefined` while ticking, not yet terminal, or missing either timestamp (see the class\ndoc's \"elapsed time\" section for why a terminal run doesn't reuse the live ticker).",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "statusLabels",
+              "type": {
+                "text": "Record<string, string>"
+              },
+              "default": "{}",
+              "description": "Labels for application-defined lifecycle kinds. Built-in kinds remain localized by Lyra."
+            },
+            {
+              "kind": "field",
+              "name": "statusVariants",
+              "type": {
+                "text": "Record<string, BadgeVariant>"
+              },
+              "default": "{}",
+              "description": "Badge variants for application-defined lifecycle kinds. Unknown kinds default to `neutral`."
+            },
             {
               "kind": "field",
               "name": "stopLocaleSubscription",
@@ -1172,6 +1247,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "hasSlotted",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "isAttentionKind",
@@ -2039,95 +2132,179 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/animated-image/animated-image.class.ts",
+      "path": "src/components/agent-workspace/agent-workspace.class.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lr-animated-image>` -- displays an animated GIF/APNG/WebP with a\nplay/pause control, defaulting to a frozen first frame both at rest and\nautomatically under `prefers-reduced-motion: reduce` (unless the page\nauthor explicitly opts back in via `respect-reduced-motion=\"false\"`), so\nmotion is never forced on a user who asked for less of it.\n\n**Freeze-frame mechanism.** The live `<img>`'s `load` event handler\nsynchronously draws the just-loaded image to `[part=\"canvas\"]` (a\nDPR-aware `drawImage()`, the same pattern `<lr-heatmap>` uses for its own\ncanvas sizing) before any animation frames have had a chance to advance.\nThat captured frame is what pausing always reverts to -- it is not\nre-captured on every pause, only once per successful `src` load. Both\n`[part=\"image\"]` and `[part=\"canvas\"]` stay mounted at all times (never\n`display: none`/removed) so the browser's native decode loop keeps running\neven while visually covered by the frozen canvas; only opacity and\n`aria-hidden` swap between them, driven by the effective `playing` state.\n\n**`play` vs. `playing`.** `play` is the caller's intent (settable,\nreflects nothing on its own). `playing` is the read-only, reflected effect\nafter reduced-motion arbitration: `play && !(respectReducedMotion &&\n<OS prefers-reduced-motion: reduce>)`. A page can set `.play = true` while\nreduced motion still keeps the visual frozen -- `lr-play`/`lr-pause`\nonly fire on a real transition of the resolved `playing` value, never on a\n`play` assignment that reduced motion blocks from taking visible effect.\n\n**Safety.** `src` is re-validated through `safeMediaSrc()` (the same\nallowlist `<lr-media-card>` uses) before it is ever assigned to the real\n`<img src>`. An empty `src` renders no `src` attribute and is not an\nerror; a non-empty `src` that fails the check is treated exactly like a\nnative image decode failure -- `lr-error` fires and no request is ever\nattempted.\n\n**Decorative-only is not supported.** An explicit `alt=\"\"` still falls\nback to the localized `animatedImageDefaultAlt` string rather than staying\nempty/presentational -- the same deliberate tradeoff `<lr-media-card>`'s\n`imgAlt` getter already makes for its own `alt`/`filename` fallback chain.\n\nDeliberately no label/hint/error chrome -- this is not a form-associated\ncontrol (nothing resembling a value the user submits).",
-          "name": "LyraAnimatedImage",
-          "cssProperties": [
+          "description": "`<lr-agent-workspace>` — a responsive, controlled shell for an AI conversation and its\nsupporting agent state. It renders the transcript and composer in the main pane, and composes\nexisting run, tool, retrieval, grounding, and context primitives in an optional details pane.\n\nThe component performs no network requests, model calls, retrieval, or persistence. Assign new\ndata to the public properties as the host application receives updates. The `messages` fallback\nrenders sanitized Markdown from each message's `text`; applications needing richer message\ncontent can replace that entire region with the `messages` slot. The `details` slot similarly\nreplaces the built-in details pane while keeping the responsive shell.",
+          "name": "LyraAgentWorkspace",
+          "cssParts": [
             {
-              "description": "The size of `control-box`. Defaults to `var(--lr-icon-button-size)`.",
-              "name": "--lr-animated-image-control-box-size"
+              "description": "The root workspace wrapper.",
+              "name": "base"
             },
             {
-              "description": "The size of the play/pause icons. Defaults to `calc(var(--lr-icon-button-size) * 0.35)`.",
-              "name": "--lr-animated-image-icon-size"
+              "description": "The main conversation/details layout.",
+              "name": "body"
             },
             {
-              "description": "Caps the rendered media's block-size. Defaults to `var(--lr-size-20rem)`.",
-              "name": "--lr-animated-image-max-height"
-            }
-          ],
-          "cssParts": [
+              "description": "The composer region.",
+              "name": "composer"
+            },
             {
-              "description": "Root wrapper; positioning context for `control-box`.",
-              "name": "base"
+              "description": "The built-in `<lr-chat-composer>`.",
+              "name": "composer-input"
             },
             {
-              "description": "The frozen-frame `<canvas>`, shown in place of `image` while not playing.",
-              "name": "canvas"
+              "description": "The main transcript pane.",
+              "name": "conversation"
             },
             {
-              "description": "The container that surrounds and backgrounds the play/pause button. Only rendered once loaded and error-free.",
-              "name": "control-box"
+              "description": "The responsive details pane.",
+              "name": "details"
             },
             {
-              "description": "The live `<img>`.",
-              "name": "image"
+              "description": "The built-in details content wrapper.",
+              "name": "details-content"
             },
             {
-              "description": "The `<button type=\"button\">` inside `control-box` that toggles `play`.",
-              "name": "play-button"
+              "description": "The workspace heading and header-actions slot.",
+              "name": "header"
+            },
+            {
+              "description": "The header-actions slot wrapper.",
+              "name": "header-actions"
+            },
+            {
+              "description": "The visible workspace heading.",
+              "name": "heading"
+            },
+            {
+              "description": "The transcript message wrapper.",
+              "name": "messages"
+            },
+            {
+              "description": "The empty transcript state.",
+              "name": "messages-empty"
+            },
+            {
+              "description": "A built-in run, tools, retrieval, grounding, or context section.",
+              "name": "section"
+            },
+            {
+              "description": "A built-in details section heading.",
+              "name": "section-heading"
+            },
+            {
+              "description": "The composed `<lr-chat-viewport>`.",
+              "name": "viewport"
             }
           ],
           "slots": [
             {
-              "description": "Custom icon shown on `[part=\"play-button\"]` while playing. Defaults to a pause glyph.",
-              "name": "pause-icon"
+              "description": "Replaces the built-in `<lr-chat-composer>`.",
+              "name": "composer"
             },
             {
-              "description": "Custom icon shown on `[part=\"play-button\"]` while frozen/paused. Defaults to a play glyph.",
-              "name": "play-icon"
+              "description": "Replaces the built-in run/tool/retrieval/grounding/context details pane.",
+              "name": "details"
+            },
+            {
+              "description": "Header actions such as model selection, settings, or export controls.",
+              "name": "header-actions"
+            },
+            {
+              "description": "Replaces the data-driven transcript message list.",
+              "name": "messages"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "_playing",
+              "name": "accessibleLabel",
               "type": {
-                "text": "boolean"
+                "text": "string | null"
               },
-              "privacy": "private",
-              "default": "false"
+              "default": "null",
+              "description": "Host-level accessible-name override for the internal `role=\"region\"` root.",
+              "attribute": "aria-label"
             },
             {
               "kind": "field",
-              "name": "accessibleLabel",
+              "name": "citations",
+              "type": {
+                "text": "Citation[]"
+              },
+              "default": "[]",
+              "description": "Citations displayed with the grounding summary."
+            },
+            {
+              "kind": "field",
+              "name": "composerMaxRows",
+              "type": {
+                "text": "number"
+              },
+              "default": "8",
+              "attribute": "composer-max-rows"
+            },
+            {
+              "kind": "field",
+              "name": "composerMinRows",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Minimum and maximum rows for the built-in composer.",
+              "attribute": "composer-min-rows"
+            },
+            {
+              "kind": "field",
+              "name": "composerPlaceholder",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "Accessible-name override for `[part=\"play-button\"]`. Maps to the\nhost's `aria-label` attribute and, once set, wins verbatim over the\ncomputed per-state Play/Pause label in both play and pause states --\nit does not itself vary by state. Never touches `[part=\"image\"]`'s\n`alt` / `[part=\"canvas\"]`'s `aria-label`, which stay independently\nsourced from `alt`. A consumer wanting state-sensitive custom wording\nwithout losing the Play/Pause distinction should override the\n`playWithContext`/`pauseWithContext`/`animatedImageDefaultAlt` strings\ninstead.",
-              "attribute": "aria-label"
+              "description": "Placeholder for the built-in composer.",
+              "attribute": "composer-placeholder"
             },
             {
               "kind": "field",
-              "name": "alt",
+              "name": "composerStatus",
+              "type": {
+                "text": "ChatComposerStatus"
+              },
+              "default": "'idle'",
+              "description": "Status of the built-in composer.",
+              "attribute": "composer-status"
+            },
+            {
+              "kind": "field",
+              "name": "composerValue",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "description": "A description of the image used by assistive devices. Falls back to\nthe localized `animatedImageDefaultAlt` when empty -- see the class doc.",
-              "attribute": "alt"
+              "description": "Controlled value of the built-in composer.",
+              "attribute": "composer-value"
             },
             {
               "kind": "field",
-              "name": "canvasEl",
+              "name": "contextSegments",
               "type": {
-                "text": "HTMLCanvasElement | undefined"
+                "text": "ContextInspectorSegment[]"
               },
-              "privacy": "private"
+              "default": "[]",
+              "description": "Final model-call context segments."
+            },
+            {
+              "kind": "field",
+              "name": "contextTotal",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Overall context-window token total.",
+              "attribute": "context-total"
             },
             {
               "kind": "field",
@@ -2141,15 +2318,6 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
-            {
-              "kind": "field",
-              "name": "effectiveAlt",
-              "type": {
-                "text": "string"
-              },
-              "privacy": "private",
-              "readonly": true
-            },
             {
               "kind": "field",
               "name": "effectiveDirection",
@@ -2180,29 +2348,42 @@
             },
             {
               "kind": "field",
-              "name": "hasError",
+              "name": "follow",
               "type": {
                 "text": "boolean"
               },
-              "privacy": "private",
-              "default": "false"
+              "default": "true",
+              "description": "Whether the transcript follows the latest message.",
+              "attribute": "follow",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "hasLoaded",
+              "name": "groundingAssessment",
+              "type": {
+                "text": "GroundingAssessment | null"
+              },
+              "default": "null",
+              "description": "Grounding assessment for the current assistant answer."
+            },
+            {
+              "kind": "field",
+              "name": "hasBuiltInDetails",
               "type": {
                 "text": "boolean"
               },
               "privacy": "private",
-              "default": "false"
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "imageEl",
+              "name": "label",
               "type": {
-                "text": "HTMLImageElement | undefined"
+                "text": "string"
               },
-              "privacy": "private"
+              "default": "''",
+              "description": "Accessible name and visible heading for the workspace.",
+              "attribute": "label"
             },
             {
               "kind": "field",
@@ -2234,40 +2415,40 @@
             },
             {
               "kind": "field",
-              "name": "mediaQuery",
+              "name": "messages",
               "type": {
-                "text": "MediaQueryList | undefined"
+                "text": "ChatMessage[]"
               },
-              "privacy": "private"
-            },
-            {
-              "kind": "field",
-              "name": "onControlBlur",
-              "privacy": "private"
+              "default": "[]",
+              "description": "Conversation messages. The host owns ordering, updates, and persistence."
             },
             {
               "kind": "field",
-              "name": "onControlFocus",
-              "privacy": "private"
+              "name": "metrics",
+              "type": {
+                "text": "AgentRunMetric[]"
+              },
+              "default": "[]",
+              "description": "Additional metrics forwarded to `<lr-agent-run>`, such as token counts or latency."
             },
             {
               "kind": "field",
-              "name": "onImageError",
+              "name": "onComposerInput",
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "onImageLoad",
+              "name": "onFollowChange",
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "onMotionPreferenceChange",
+              "name": "onMessageRetry",
               "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "onToggleClick",
+              "name": "onRetrievalSelect",
               "privacy": "private"
             },
             {
@@ -2284,50 +2465,888 @@
             },
             {
               "kind": "field",
-              "name": "play",
+              "name": "retrievalChunks",
+              "type": {
+                "text": "RetrievalChunk[]"
+              },
+              "default": "[]",
+              "description": "Retrieval chunks for the current answer or query."
+            },
+            {
+              "kind": "field",
+              "name": "retrievalError",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Caller-supplied retrieval error text.",
+              "attribute": "retrieval-error"
+            },
+            {
+              "kind": "field",
+              "name": "retrievalHasMore",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Requests animated playback. Distinct from the read-only `playing`\neffect -- see the class doc's \"`play` vs. `playing`\" section.",
-              "attribute": "play"
+              "description": "Whether more retrieval results can be requested.",
+              "attribute": "retrieval-has-more"
             },
             {
               "kind": "field",
-              "name": "playButtonEl",
+              "name": "retrievalLoading",
               "type": {
-                "text": "HTMLButtonElement | undefined"
+                "text": "boolean"
               },
-              "privacy": "private"
+              "default": "false",
+              "description": "Loading state for the built-in retrieval result list.",
+              "attribute": "retrieval-loading"
             },
             {
               "kind": "field",
-              "name": "playing",
+              "name": "run",
               "type": {
-                "text": "boolean"
+                "text": "AgentRun | null"
               },
-              "description": "The effective playing state after reduced-motion arbitration -- also\nreflected as a `playing` host attribute. Read-only; control playback\nvia `play`."
+              "default": "null",
+              "description": "Current agent run, rendered in the details pane when set."
             },
             {
               "kind": "field",
-              "name": "respectReducedMotion",
+              "name": "selectedRetrievalIds",
+              "type": {
+                "text": "string[]"
+              },
+              "default": "[]",
+              "description": "Controlled retrieval selection, forwarded to `<lr-retrieval-results>`."
+            },
+            {
+              "kind": "field",
+              "name": "showComposer",
               "type": {
                 "text": "boolean"
               },
               "default": "true",
-              "description": "When `true` (default) and the platform reports\n`prefers-reduced-motion: reduce`, playback stays frozen and\n`[part=\"play-button\"]` is disabled regardless of `play`. Set to `false`\nto let `play` take effect even under a reduced-motion preference -- a\ndeliberate, page-author-level override.",
-              "attribute": "respect-reduced-motion",
+              "description": "Whether the built-in composer is available when no `composer` slot is supplied.",
+              "attribute": "show-composer",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "src",
+              "name": "showDetails",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "default": "''",
-              "description": "The path to the image to load. Always re-validated against a\nsafe-scheme allowlist before use -- see the class doc.",
-              "attribute": "src"
+              "default": "true",
+              "description": "Whether the built-in details pane is available when data is present.",
+              "attribute": "show-details",
+              "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": "tools",
+              "type": {
+                "text": "ToolTimelineEntry[]"
+              },
+              "default": "[]",
+              "description": "Tool calls for the current run, rendered through `<lr-tool-timeline>`."
+            },
+            {
+              "kind": "field",
+              "name": "unreadStartIndex",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "First unread message index, forwarded to the transcript viewport.",
+              "attribute": "unread-start-index"
+            },
+            {
+              "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": "beginAbortableLoad",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "AbortSignal | undefined"
+                }
+              },
+              "description": "Starts a component-owned cancellable load and aborts the previous one.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "CustomEvent<T>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "detail",
+                  "optional": true,
+                  "type": {
+                    "text": "T"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "LyraEmitOptions"
+                  }
+                }
+              ],
+              "description": "Dispatch a composed, bubbling custom event; notifications are not veto points by default.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "hasSlotted",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "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": "renderDetails",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderMessage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "ChatMessage"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderMessages",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "scheduleAfterUpdate",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "callback",
+                  "type": {
+                    "text": "() => void"
+                  }
+                }
+              ],
+              "description": "Runs one coalesced load callback after the current update completes.\nLit still runs the update cycle while detached, so a load scheduled then is\nheld and replayed on reconnect rather than dropped.",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "description": "Forwarded from the built-in agent run.",
+              "name": "lr-cancel"
+            },
+            {
+              "description": "Forwarded from the built-in grounding summary. `detail: { citation }`.",
+              "name": "lr-citation-select"
+            },
+            {
+              "description": "Forwarded from the transcript viewport. `detail: { following }`.",
+              "name": "lr-follow-change"
+            },
+            {
+              "description": "Forwarded from the built-in composer. `detail: { value }`.",
+              "name": "lr-input"
+            },
+            {
+              "description": "A data-driven message's retry action was activated. `detail: { messageId }`.",
+              "name": "lr-message-retry"
+            },
+            {
+              "description": "Forwarded from the built-in retrieval results. `detail: { ids, chunks }`.",
+              "name": "lr-retrieval-select"
+            },
+            {
+              "description": "Forwarded from the built-in agent run.",
+              "name": "lr-retry"
+            },
+            {
+              "description": "Forwarded from the built-in composer.",
+              "name": "lr-stop"
+            },
+            {
+              "description": "Forwarded from the built-in composer. `detail: { value }`.",
+              "name": "lr-submit"
+            },
+            {
+              "description": "Forwarded from the built-in tool timeline.",
+              "name": "lr-tool-approval-decide"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "aria-label",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "Host-level accessible-name override for the internal `role=\"region\"` root.",
+              "fieldName": "accessibleLabel"
+            },
+            {
+              "name": "composer-max-rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "8",
+              "fieldName": "composerMaxRows"
+            },
+            {
+              "name": "composer-min-rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Minimum and maximum rows for the built-in composer.",
+              "fieldName": "composerMinRows"
+            },
+            {
+              "name": "composer-placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Placeholder for the built-in composer.",
+              "fieldName": "composerPlaceholder"
+            },
+            {
+              "name": "composer-status",
+              "type": {
+                "text": "ChatComposerStatus"
+              },
+              "default": "'idle'",
+              "description": "Status of the built-in composer.",
+              "fieldName": "composerStatus"
+            },
+            {
+              "name": "composer-value",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Controlled value of the built-in composer.",
+              "fieldName": "composerValue"
+            },
+            {
+              "name": "context-total",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Overall context-window token total.",
+              "fieldName": "contextTotal"
+            },
+            {
+              "name": "follow",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the transcript follows the latest message.",
+              "fieldName": "follow"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible name and visible heading for the workspace.",
+              "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": "retrieval-error",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Caller-supplied retrieval error text.",
+              "fieldName": "retrievalError"
+            },
+            {
+              "name": "retrieval-has-more",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether more retrieval results can be requested.",
+              "fieldName": "retrievalHasMore"
+            },
+            {
+              "name": "retrieval-loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Loading state for the built-in retrieval result list.",
+              "fieldName": "retrievalLoading"
+            },
+            {
+              "name": "show-composer",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the built-in composer is available when no `composer` slot is supplied.",
+              "fieldName": "showComposer"
+            },
+            {
+              "name": "show-details",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Whether the built-in details pane is available when data is present.",
+              "fieldName": "showDetails"
+            },
+            {
+              "name": "unread-start-index",
+              "type": {
+                "text": "number | null"
+              },
+              "default": "null",
+              "description": "First unread message index, forwarded to the transcript viewport.",
+              "fieldName": "unreadStartIndex"
+            }
+          ],
+          "superclass": {
+            "name": "LyraElement",
+            "module": "/src/internal/lyra-element.js"
+          },
+          "tagName": "lr-agent-workspace",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "LyraAgentWorkspace",
+          "declaration": {
+            "name": "LyraAgentWorkspace",
+            "module": "src/components/agent-workspace/agent-workspace.class.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/agent-workspace/agent-workspace.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "lr-agent-workspace",
+          "declaration": {
+            "name": "LyraAgentWorkspace",
+            "module": "src/components/agent-workspace/agent-workspace.class.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "module": "src/components/agent-workspace/agent-workspace.class.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/animated-image/animated-image.class.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "`<lr-animated-image>` -- displays an animated GIF/APNG/WebP with a\nplay/pause control, defaulting to a frozen first frame both at rest and\nautomatically under `prefers-reduced-motion: reduce` (unless the page\nauthor explicitly opts back in via `respect-reduced-motion=\"false\"`), so\nmotion is never forced on a user who asked for less of it.\n\n**Freeze-frame mechanism.** The live `<img>`'s `load` event handler\nsynchronously draws the just-loaded image to `[part=\"canvas\"]` (a\nDPR-aware `drawImage()`, the same pattern `<lr-heatmap>` uses for its own\ncanvas sizing) before any animation frames have had a chance to advance.\nThat captured frame is what pausing always reverts to -- it is not\nre-captured on every pause, only once per successful `src` load. Both\n`[part=\"image\"]` and `[part=\"canvas\"]` stay mounted at all times (never\n`display: none`/removed) so the browser's native decode loop keeps running\neven while visually covered by the frozen canvas; only opacity and\n`aria-hidden` swap between them, driven by the effective `playing` state.\n\n**`play` vs. `playing`.** `play` is the caller's intent (settable,\nreflects nothing on its own). `playing` is the read-only, reflected effect\nafter reduced-motion arbitration: `play && !(respectReducedMotion &&\n<OS prefers-reduced-motion: reduce>)`. A page can set `.play = true` while\nreduced motion still keeps the visual frozen -- `lr-play`/`lr-pause`\nonly fire on a real transition of the resolved `playing` value, never on a\n`play` assignment that reduced motion blocks from taking visible effect.\n\n**Safety.** `src` is re-validated through `safeMediaSrc()` (the same\nallowlist `<lr-media-card>` uses) before it is ever assigned to the real\n`<img src>`. An empty `src` renders no `src` attribute and is not an\nerror; a non-empty `src` that fails the check is treated exactly like a\nnative image decode failure -- `lr-error` fires and no request is ever\nattempted.\n\n**Decorative-only is not supported.** An explicit `alt=\"\"` still falls\nback to the localized `animatedImageDefaultAlt` string rather than staying\nempty/presentational -- the same deliberate tradeoff `<lr-media-card>`'s\n`imgAlt` getter already makes for its own `alt`/`filename` fallback chain.\n\nDeliberately no label/hint/error chrome -- this is not a form-associated\ncontrol (nothing resembling a value the user submits).",
+          "name": "LyraAnimatedImage",
+          "cssProperties": [
+            {
+              "description": "The size of `control-box`. Defaults to `var(--lr-icon-button-size)`.",
+              "name": "--lr-animated-image-control-box-size"
+            },
+            {
+              "description": "The size of the play/pause icons. Defaults to `calc(var(--lr-icon-button-size) * 0.35)`.",
+              "name": "--lr-animated-image-icon-size"
+            },
+            {
+              "description": "Caps the rendered media's block-size. Defaults to `var(--lr-size-20rem)`.",
+              "name": "--lr-animated-image-max-height"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "Root wrapper; positioning context for `control-box`.",
+              "name": "base"
+            },
+            {
+              "description": "The frozen-frame `<canvas>`, shown in place of `image` while not playing.",
+              "name": "canvas"
+            },
+            {
+              "description": "The container that surrounds and backgrounds the play/pause button. Only rendered once loaded and error-free.",
+              "name": "control-box"
+            },
+            {
+              "description": "The live `<img>`.",
+              "name": "image"
+            },
+            {
+              "description": "The `<button type=\"button\">` inside `control-box` that toggles `play`.",
+              "name": "play-button"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Custom icon shown on `[part=\"play-button\"]` while playing. Defaults to a pause glyph.",
+              "name": "pause-icon"
+            },
+            {
+              "description": "Custom icon shown on `[part=\"play-button\"]` while frozen/paused. Defaults to a play glyph.",
+              "name": "play-icon"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "_playing",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "accessibleLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Accessible-name override for `[part=\"play-button\"]`. Maps to the\nhost's `aria-label` attribute and, once set, wins verbatim over the\ncomputed per-state Play/Pause label in both play and pause states --\nit does not itself vary by state. Never touches `[part=\"image\"]`'s\n`alt` / `[part=\"canvas\"]`'s `aria-label`, which stay independently\nsourced from `alt`. A consumer wanting state-sensitive custom wording\nwithout losing the Play/Pause distinction should override the\n`playWithContext`/`pauseWithContext`/`animatedImageDefaultAlt` strings\ninstead.",
+              "attribute": "aria-label"
+            },
+            {
+              "kind": "field",
+              "name": "alt",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A description of the image used by assistive devices. Falls back to\nthe localized `animatedImageDefaultAlt` when empty -- see the class doc.",
+              "attribute": "alt"
+            },
+            {
+              "kind": "field",
+              "name": "canvasEl",
+              "type": {
+                "text": "HTMLCanvasElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "deferredLoad",
+              "type": {
+                "text": "() => void | undefined"
+              },
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "effectiveAlt",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "readonly": 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": "hasError",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "hasLoaded",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "imageEl",
+              "type": {
+                "text": "HTMLImageElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "loadSchedulePending",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "locale",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional locale override. Otherwise the nearest `locale`/`lang` ancestor is used.",
+              "attribute": "locale",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "mediaQuery",
+              "type": {
+                "text": "MediaQueryList | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onControlBlur",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onControlFocus",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onImageError",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onImageLoad",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onMotionPreferenceChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "onToggleClick",
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "pendingLoadController",
+              "type": {
+                "text": "AbortController | undefined"
+              },
+              "privacy": "private",
+              "inheritedFrom": {
+                "name": "LyraElement",
+                "module": "src/internal/lyra-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "play",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Requests animated playback. Distinct from the read-only `playing`\neffect -- see the class doc's \"`play` vs. `playing`\" section.",
+              "attribute": "play"
+            },
+            {
+              "kind": "field",
+              "name": "playButtonEl",
+              "type": {
+                "text": "HTMLButtonElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "playing",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "The effective playing state after reduced-motion arbitration -- also\nreflected as a `playing` host attribute. Read-only; control playback\nvia `play`."
+            },
+            {
+              "kind": "field",
+              "name": "respectReducedMotion",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "When `true` (default) and the platform reports\n`prefers-reduced-motion: reduce`, playback stays frozen and\n`[part=\"play-button\"]` is disabled regardless of `play`. Set to `false`\nto let `play` take effect even under a reduced-motion preference -- a\ndeliberate, page-author-level override.",
+              "attribute": "respect-reduced-motion",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "src",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The path to the image to load. Always re-validated against a\nsafe-scheme allowlist before use -- see the class doc.",
+              "attribute": "src"
             },
             {
               "kind": "field",
@@ -10510,16 +11529,15 @@
             },
             {
               "kind": "field",
-              "name": "hasIcon",
+              "name": "failedSrc",
               "type": {
-                "text": "boolean"
+                "text": "string | undefined"
               },
-              "privacy": "private",
-              "default": "false"
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "imageFailed",
+              "name": "hasIcon",
               "type": {
                 "text": "boolean"
               },
@@ -18133,6 +19151,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -20291,6 +21322,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -21870,6 +22914,15 @@
               "description": "The current Chart.js chart-area geometry in canvas-local coordinates.",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -23066,6 +24119,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -24645,6 +25711,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -26193,6 +27272,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -29001,6 +30093,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -30489,6 +31594,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -31977,6 +33095,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -33465,6 +34596,19 @@
                 "module": "src/components/chart/chart.class.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "chartAreaUpdateQueued",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "inheritedFrom": {
+                "name": "LyraChart",
+                "module": "src/components/chart/chart.class.ts"
+              }
+            },
             {
               "kind": "field",
               "name": "chartJsModule",
@@ -36191,6 +37335,17 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "messageId",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional stable application-defined identifier for this message. Included in `lr-retry`\ndetail when set.",
+              "attribute": "message-id",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "normalizedTimestamp",
@@ -36555,7 +37710,7 @@
               "name": "lr-collapse-toggle"
             },
             {
-              "description": "Fired by the built-in retry button, only rendered when `status=\"failed\"` and the `failure` slot is empty. A host using the `failure` slot owns its own retry control and is not required to use this event at all — but nothing stops that control from dispatching its own `new CustomEvent('lr-retry', { bubbles: true, composed: true })` to stay consistent with the same event contract a listener further up a conversation surface already relies on for every other message.",
+              "description": "Fired by the built-in retry button, only rendered when `status=\"failed\"` and the `failure` slot is empty. `detail: { messageId?: string }` includes this element's stable `messageId` when supplied, so a conversation surface can identify the message without a closure around each row. A host using the `failure` slot owns its own retry control and is not required to use this event at all — but nothing stops that control from dispatching its own `new CustomEvent('lr-retry', { bubbles: true, composed: true })` to stay consistent with the same event contract a listener further up a conversation surface already relies on for every other message.",
               "name": "lr-retry"
             }
           ],
@@ -36618,6 +37773,15 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "name": "message-id",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional stable application-defined identifier for this message. Included in `lr-retry`\ndetail when set.",
+              "fieldName": "messageId"
+            },
             {
               "name": "status",
               "type": {
@@ -53144,10 +54308,18 @@
               "description": "Overflow/icon-button controls (for example a pin/delete button or a `lr-menu` trigger) rendered at the trailing edge of the row.",
               "name": "actions"
             },
+            {
+              "description": "Replaces the built-in title, excerpt, and meta content area with host-supplied non-interactive row content.",
+              "name": "content"
+            },
             {
               "description": "Full override of the excerpt presentation (e.g. a search-hit snippet with `<mark>` highlighting). Wins over the `excerpt` property whenever it has assigned content, even if `excerpt` is also set. Only non-focusable content should be slotted here — see the `excerpt` property's own doc for why.",
               "name": "excerpt"
             },
+            {
+              "description": "Non-interactive leading content such as an avatar, purpose icon, or status indicator. It is rendered inside the selectable region before the title/excerpt content.",
+              "name": "leading"
+            },
             {
               "description": "Small, non-focusable structured fields for the row (e.g. a day label, cost, request count) rendered below the title/excerpt. Entirely app-supplied; this component computes none of it. Only non-focusable content should be slotted here, for the same `nested-interactive` reason as `excerpt`.",
               "name": "meta"
@@ -53272,6 +54444,15 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "hasContentSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "hasExcerptSlot",
@@ -53281,6 +54462,15 @@
               "privacy": "private",
               "default": "false"
             },
+            {
+              "kind": "field",
+              "name": "hasLeadingSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "hasMetaSlot",
@@ -53332,11 +54522,21 @@
               "name": "onActionsSlotChange",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "onContentSlotChange",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "onExcerptSlotChange",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "onLeadingSlotChange",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "onMetaSlotChange",
@@ -62980,7 +64180,7 @@
               "name": "copy-button"
             },
             {
-              "description": "A single line. Carries `data-type=\"equal\"|\"add\"|\"remove\"|\"empty\"` (`\"empty\"` is an unbalanced-replace placeholder cell in `layout=\"split\"` and never carries a `+`/`-` prefix).",
+              "description": "A single line. Carries `data-type=\"equal\"|\"add\"|\"remove\"|\"empty\"|\"fold\"` (`\"empty\"` is an unbalanced-replace placeholder cell in `layout=\"split\"` and never carries a `+`/`-` prefix; `\"fold\"` is the collapsed-unchanged-lines marker `contextLines` produces).",
               "name": "line"
             },
             {
@@ -62989,6 +64189,15 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "contextLines",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "How many unchanged lines to keep visible immediately before/after each change. Default\n`undefined` renders every line unconditionally, exactly like before this property existed. Set\nto a finite number `>= 0` to collapse a longer run of unchanged lines behind a single fold\nmarker reporting how many lines it hides -- the same context-window convention unified diffs\nand `git diff`'s `-U<n>` use. A negative or non-finite value is treated as unset (no folding).",
+              "attribute": "context-lines"
+            },
             {
               "kind": "field",
               "name": "copyTimeoutId",
@@ -63276,6 +64485,17 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "computeFolds",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{ visible: Set<DiffOp>; foldBefore: Map<DiffOp, number>; trailingFold: number }"
+                }
+              },
+              "description": "Computes which `equal` ops a fold marker should hide, keyed by object identity (not array\nindex) so the same result works for both `renderUnified()`'s flat op sequence and\n`renderSplit()`'s `pairOpsForSplit()` rows -- an equal op's `DiffOp` object is the exact same\nreference in both places. `foldBefore` maps the first visible op *after* a hidden run to how\nmany lines that run hid (the marker renders immediately before that op); a run hidden all the\nway to the end of the diff has no \"next op\" to key off, so its count surfaces separately as\n`trailingFold`. Only maximal `equal` runs are ever folded -- `add`/`remove` ops are always\nvisible. A run that is both the very first and very last thing in the diff (i.e. `oldText` and\n`newText` are identical) is never folded: there is no adjacent change to give context around."
+            },
             {
               "kind": "method",
               "name": "emit",
@@ -63313,6 +64533,24 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "foldMarker",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "count",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "localize",
@@ -63506,6 +64744,14 @@
             }
           ],
           "attributes": [
+            {
+              "name": "context-lines",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "How many unchanged lines to keep visible immediately before/after each change. Default\n`undefined` renders every line unconditionally, exactly like before this property existed. Set\nto a finite number `>= 0` to collapse a longer run of unchanged lines behind a single fold\nmarker reporting how many lines it hides -- the same context-window convention unified diffs\nand `git diff`'s `-U<n>` use. A negative or non-finite value is treated as unset (no folding).",
+              "fieldName": "contextLines"
+            },
             {
               "name": "copyable",
               "type": {
@@ -72025,7 +73271,7 @@
           "parameters": [
             {
               "name": "importData",
-              "default": "() =>\n    import('emoji-picker-element-data/en/emojibase/data.json') as Promise<OptionalPeerApi>",
+              "default": "() =>\n    import('emoji-picker-element-data/en/emojibase/data.json', { with: { type: 'json' } }) as Promise<OptionalPeerApi>",
               "type": {
                 "text": "() => Promise<OptionalPeerApi>"
               }
@@ -72069,7 +73315,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lr-emoji-picker>` — a searchable, keyboard-navigable, form-associated emoji picker. In the\nsame \"zero/optional-peer dependency\" spirit as `<lr-lite-chart>`/`<lr-heatmap>`: `groups` is\nfully consumer-suppliable (this component ships no emoji data of its own), with an *optional*\nconvenience auto-loader for a default set — see `emoji-data-loader.ts` and the class doc there for\nexactly what that covers.\n\nKeyboard model: the grid is a roving-tabindex listbox (a single Tab stop — only the active emoji\nis tabbable). Arrow keys move the active option (Left/Right follow reading direction and swap\nunder RTL; Up/Down move by one visual row, measured from the live wrap layout), Home/End jump to\nthe first/last option, and Enter/Space picks. The search input doubles as a `role=\"combobox\"`\nover the same listbox: the arrow keys and Enter also work there while focus stays in the input,\nwith `aria-activedescendant` tracking the active option.",
+          "description": "`<lr-emoji-picker>` — a searchable, keyboard-navigable, form-associated emoji picker. In the\nsame \"zero/optional-peer dependency\" spirit as `<lr-lite-chart>`/`<lr-heatmap>`: `groups` is\nfully consumer-suppliable (this component ships no emoji data of its own), with an *optional*\nconvenience auto-loader for a default set — see `emoji-data-loader.ts` and the class doc there for\nexactly what that covers.\n\nKeyboard model: the grid is a roving-tabindex listbox (a single Tab stop — only the active emoji\nis tabbable). Arrow keys move the active option (Left/Right follow reading direction and swap\nunder RTL; Up/Down move by one visual row, measured from the live wrap layout), Home/End jump to\nthe first/last option, and Enter/Space picks. The search input doubles as a `role=\"combobox\"`\nover the same listbox: the arrow keys and Enter also work there while focus stays in the input,\nwith `aria-activedescendant` tracking the active option. Large data sets automatically window\ntheir visible rows so scrolling does not create one button per supplied emoji in the DOM.",
           "name": "LyraEmojiPicker",
           "cssParts": [
             {
@@ -72181,6 +73427,14 @@
               "privacy": "private",
               "readonly": true
             },
+            {
+              "kind": "field",
+              "name": "gridResizeObserver",
+              "type": {
+                "text": "ResizeObserver | undefined"
+              },
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "groups",
@@ -72197,6 +73451,15 @@
               "readonly": true,
               "default": "new WeakMap<EmojiPickerItem, string>()"
             },
+            {
+              "kind": "field",
+              "name": "isVirtualized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "loadGroups",
@@ -72235,11 +73498,33 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "observedGrid",
+              "type": {
+                "text": "HTMLElement | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "observedGridVirtualized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "onGridFocusIn",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "onGridScroll",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "onNavigationKeyDown",
@@ -72304,6 +73589,24 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "field",
+              "name": "virtualScrollRaf",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "virtualScrollTop",
+              "type": {
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0",
+              "description": "The large-data path keeps only visible rows in the DOM. The regular path remains unchanged\nfor small sets so consumers keep the simple grouped light-DOM shape they already receive."
+            },
             {
               "kind": "method",
               "name": "addEventListener",
@@ -72364,6 +73667,30 @@
               },
               "description": "Options in the first rendered row. Measured from live layout at call time because the\nflex-wrap column count is fluid (container width, emoji font metrics)."
             },
+            {
+              "kind": "method",
+              "name": "cssPixelValue",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "fallback",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "emit",
@@ -72518,6 +73845,46 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "renderEmojiButton",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "item",
+                  "type": {
+                    "text": "EmojiPickerItem"
+                  }
+                },
+                {
+                  "name": "itemIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "total",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderVirtualRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "scheduleAfterUpdate",
@@ -72565,6 +73932,36 @@
                 }
               ],
               "description": "Moves the active option (clamped), updating only the affected buttons plus the combobox's\n`aria-activedescendant` — no re-render. `focusTarget` distinguishes the grid's roving-focus\nidiom (focus follows the active option) from the search input's combobox idiom (focus stays\nin the input)."
+            },
+            {
+              "kind": "method",
+              "name": "syncGridObserver",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "virtualRowHeight",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "virtualRows",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "VirtualEmojiRow[]"
+                }
+              }
             }
           ],
           "events": [
@@ -95783,6 +97180,16 @@
               "default": "new Map<string, string>()",
               "description": "Cache of resolved colors for the current draw pass, cleared at the top\nof drawCalendar()/drawMatrix() so a theme change is always picked up on\nthe very next full redraw, while repeated identical cellColor() outputs\nwithin the same pass resolve only once."
             },
+            {
+              "kind": "field",
+              "name": "canvasHasContent",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false",
+              "description": "Set after a complete canvas pass. Focus movement can then repaint only the old/new cell\nrectangles instead of clearing and repainting an entire dense heatmap."
+            },
             {
               "kind": "field",
               "name": "cellColor",
@@ -97029,6 +98436,198 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "paintCalendarCell",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "ctx",
+                  "type": {
+                    "text": "CanvasRenderingContext2D"
+                  }
+                },
+                {
+                  "name": "week",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "weekday",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cellSize",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cs",
+                  "type": {
+                    "text": "CSSStyleDeclaration"
+                  }
+                },
+                {
+                  "name": "ramp",
+                  "type": {
+                    "text": "string[]"
+                  }
+                },
+                {
+                  "name": "noDataFill",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "paintCalendarFocusOverlays",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "ctx",
+                  "type": {
+                    "text": "CanvasRenderingContext2D"
+                  }
+                },
+                {
+                  "name": "week",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "weekday",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cellSize",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cs",
+                  "type": {
+                    "text": "CSSStyleDeclaration"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "paintMatrixCell",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "ctx",
+                  "type": {
+                    "text": "CanvasRenderingContext2D"
+                  }
+                },
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "col",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cellSize",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cs",
+                  "type": {
+                    "text": "CSSStyleDeclaration"
+                  }
+                },
+                {
+                  "name": "rampData",
+                  "type": {
+                    "text": "ReturnType<LyraHeatmap['colorRamp']>"
+                  }
+                },
+                {
+                  "name": "noDataFill",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "paintMatrixFocusOverlays",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "ctx",
+                  "type": {
+                    "text": "CanvasRenderingContext2D"
+                  }
+                },
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "col",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cellSize",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "cs",
+                  "type": {
+                    "text": "CSSStyleDeclaration"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "refreshTheme",
@@ -97083,6 +98682,61 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "repaintCalendarFocusCell",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pos",
+                  "type": {
+                    "text": "CalendarCellPos | null"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "repaintFocusRing",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "previous",
+                  "type": {
+                    "text": "CellPos | null | undefined"
+                  }
+                }
+              ],
+              "description": "Repaints the old and new focus-ring cells after keyboard/click navigation. The underlying\ncell fill plus annotation/selection rings are restored before the new focus ring is stroked,\nso clearing a dirty rectangle never erases persistent data. Returns false when a complete draw\nis still required (for example before the first canvas pass or after a mode change)."
+            },
+            {
+              "kind": "method",
+              "name": "repaintMatrixFocusCell",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "pos",
+                  "type": {
+                    "text": "MatrixCellPos | null"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "resolveCanvasColor",
@@ -112132,10 +113786,19 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Signals that `content` is still arriving incrementally. Content changes\ncontinue to render immediately; while this is `true`, the host remains\n`aria-busy=\"true\"` so assistive technology knows the rendered document\nis not final. Set it back to `false` with the final content update.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
+              "description": "Signals that `content` is still arriving incrementally. Content changes\nare coalesced to at most one parse per animation frame while this is\n`true`; the host remains `aria-busy=\"true\"` so assistive technology knows\nthe rendered document is not final. Set it back to `false` with the final\ncontent update to flush the latest content immediately.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
               "attribute": "streaming",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "streamingRenderRaf",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "description": "Coalesces rapid streaming content assignments so a token burst cannot start one full\nMarkdown parse per assignment. The final `streaming = false` update cancels this frame and\nrenders synchronously, so consumers never lose the last chunk."
+            },
             {
               "kind": "field",
               "name": "strings",
@@ -112412,6 +114075,16 @@
               },
               "description": "A document-ordered, flattened heading outline -- computed on every parse regardless of\n`headingAnchors` (see that property's own doc). A caller building a table of contents can rely\non this even while `heading-anchors` is off."
             },
+            {
+              "kind": "method",
+              "name": "getUpdateComplete",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "highlightPending",
@@ -112642,6 +114315,16 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "scheduleStreamingRender",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "setCachedHighlight",
@@ -112808,7 +114491,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Signals that `content` is still arriving incrementally. Content changes\ncontinue to render immediately; while this is `true`, the host remains\n`aria-busy=\"true\"` so assistive technology knows the rendered document\nis not final. Set it back to `false` with the final content update.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
+              "description": "Signals that `content` is still arriving incrementally. Content changes\nare coalesced to at most one parse per animation frame while this is\n`true`; the host remains `aria-busy=\"true\"` so assistive technology knows\nthe rendered document is not final. Set it back to `false` with the final\ncontent update to flush the latest content immediately.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
               "fieldName": "streaming"
             }
           ],
@@ -113315,10 +114998,19 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Signals that `content` is still arriving incrementally. Content changes\ncontinue to render immediately; while this is `true`, the host remains\n`aria-busy=\"true\"` so assistive technology knows the rendered document\nis not final. Set it back to `false` with the final content update.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
+              "description": "Signals that `content` is still arriving incrementally. Content changes\nare coalesced to at most one parse per animation frame while this is\n`true`; the host remains `aria-busy=\"true\"` so assistive technology knows\nthe rendered document is not final. Set it back to `false` with the final\ncontent update to flush the latest content immediately.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
               "attribute": "streaming",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "streamingRenderRaf",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private",
+              "description": "Coalesces rapid streaming content assignments so a token burst cannot start one full\nMarkdown parse per assignment. The final `streaming = false` update cancels this frame and\nrenders synchronously, so consumers never lose the last chunk."
+            },
             {
               "kind": "field",
               "name": "strings",
@@ -113595,6 +115287,16 @@
               },
               "description": "A document-ordered, flattened heading outline -- computed on every parse regardless of\n`headingAnchors` (see that property's own doc). A caller building a table of contents can rely\non this even while `heading-anchors` is off."
             },
+            {
+              "kind": "method",
+              "name": "getUpdateComplete",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "highlightPending",
@@ -113825,6 +115527,16 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "scheduleStreamingRender",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "setCachedHighlight",
@@ -114000,7 +115712,7 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Signals that `content` is still arriving incrementally. Content changes\ncontinue to render immediately; while this is `true`, the host remains\n`aria-busy=\"true\"` so assistive technology knows the rendered document\nis not final. Set it back to `false` with the final content update.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
+              "description": "Signals that `content` is still arriving incrementally. Content changes\nare coalesced to at most one parse per animation frame while this is\n`true`; the host remains `aria-busy=\"true\"` so assistive technology knows\nthe rendered document is not final. Set it back to `false` with the final\ncontent update to flush the latest content immediately.\nReflects so a consumer can also target `lr-markdown[streaming]`.",
               "fieldName": "streaming"
             }
           ],
@@ -123901,7 +125613,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lr-notebook-viewer>` — read-only Jupyter notebook (nbformat 4.x) renderer, composing existing\ncomponents per cell. Execution is a hard non-goal.\n\nMarkdown cells render through `<lr-markdown>`, code cells through `<lr-code-block>` (using the\nnotebook's kernel language for syntax highlighting), and raw cells as plain preformatted text. A\ncode cell's `execute_result`/`display_data` outputs prefer, in order, `image/png`, `image/jpeg`,\n`image/svg+xml` (sanitized), `text/html` (sanitized), `application/json` (via `<lr-json-viewer>`),\nthen `text/plain`. Stream/error outputs render as plain preformatted text this round (tinted\n`danger` for stderr/tracebacks) rather than interpreting ANSI escapes. Sanitizing raw HTML/SVG\noutput markup lazy-loads the optional peer dependency `dompurify` via `dompurify-loader.ts`; when\nthat peer isn't installed, the output renders a localized notice instead of raw markup.\n\nCells are virtualized through `<lr-virtual-list>` so a notebook with many cells stays cheap to\nscroll. `node-path` anchors resolve `path[0]` as a cell index; `fragment` anchors resolve a cell's\nown `id`.",
+          "description": "`<lr-notebook-viewer>` — read-only Jupyter notebook (nbformat 4.x) renderer, composing existing\ncomponents per cell. Execution is a hard non-goal.\n\nMarkdown cells render through `<lr-markdown>`, code cells through `<lr-code-block>` (using the\nnotebook's kernel language for syntax highlighting), and raw cells as plain preformatted text. A\ncode cell's `execute_result`/`display_data` outputs prefer, in order, `image/png`, `image/jpeg`,\n`image/svg+xml` (sanitized), `text/html` (sanitized), `application/json` (via `<lr-json-viewer>`),\nthen `text/plain`. Stream/error outputs (tinted `danger` for stderr/tracebacks) interpret embedded\nANSI SGR color/style escapes via the shared `internal/ansi.ts` parser, same as `<lr-terminal>`.\nSanitizing raw HTML/SVG\noutput markup lazy-loads the optional peer dependency `dompurify` via `dompurify-loader.ts`; when\nthat peer isn't installed, the output renders a localized notice instead of raw markup.\n\nCells are virtualized through `<lr-virtual-list>` so a notebook with many cells stays cheap to\nscroll. `node-path` anchors resolve `path[0]` as a cell index; `fragment` anchors resolve a cell's\nown `id`.",
           "name": "LyraNotebookViewer",
           "cssProperties": [
             {
@@ -124450,6 +126162,25 @@
                 "module": "src/internal/lyra-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "renderAnsiText",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "TemplateResult"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "text",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Feeds `text` through a fresh, one-shot ANSI parser (this is always a complete, already-final\nstring -- never a live stream chunk -- so there is no parser state to persist across renders,\nunlike `<lr-terminal>`'s incremental `push()` usage) and renders the resulting segments as\nstyled spans, same color/style token mapping `<lr-terminal>` uses."
+            },
             {
               "kind": "method",
               "name": "renderOutput",
@@ -124594,6 +126325,24 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "segmentStyle",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Record<string, string>"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "s",
+                  "type": {
+                    "text": "AnsiStyles"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "setDoc",
@@ -166861,7 +168610,7 @@
       "declarations": [
         {
           "kind": "class",
-          "description": "`<lr-thread-list>` — the conversation sidebar: a grouped, searchable list of chat sessions with\npin/archive/delete/rename affordances. *Data mode* (non-empty `threads`, or empty `threads` with\nnothing slotted) renders every row as a `<lr-conversation-item>` inside an internal\n`<lr-virtual-list>` — virtualized by construction, scroll position and per-row state survive a\n`threads` replacement; zero rows renders the built-in empty state. *Slotted mode* (empty `threads`\n*and* real slotted content) renders host-supplied `<lr-conversation-item>`s from the default slot\nas-is: no grouping, virtualization, or row actions in that mode — those are data-mode-only by design\n(shadow DOM cannot inject group headers between slotted children).\n\nNo thread CRUD or persistence: every mutation (`lr-thread-pin`/`-archive`/`-delete`/`-rename`) is\na controlled event carrying the *requested* new state — the host mutates `threads`.\n\nData mode: a host needing content with no home in `lr-conversation-item`'s own\n`title`/`excerpt`/`meta`/`actions` surface (e.g. a leading purpose icon — the item has no default\nslot to receive one) sets `wrapRow` to wrap the already-built row. A host needing a fully custom\n`actions` surface itself — beyond `rowActions`'s closed `pin | archive | delete` set, e.g. a\n`<lr-menu>` with Rename/Delete — sets `renderActions` instead; its content is appended after any\nbuilt-in `rowActions` output in the same slot, and `wrapRow` continues to compose around the result.",
+          "description": "`<lr-thread-list>` — the conversation sidebar: a grouped, searchable list of chat sessions with\npin/archive/delete/rename affordances. *Data mode* (non-empty `threads`, or empty `threads` with\nnothing slotted) renders every row as a `<lr-conversation-item>` inside an internal\n`<lr-virtual-list>` — virtualized by construction, scroll position and per-row state survive a\n`threads` replacement; zero rows renders the built-in empty state. *Slotted mode* (empty `threads`\n*and* real slotted content) renders host-supplied `<lr-conversation-item>`s from the default slot\nas-is: no grouping, virtualization, or row actions in that mode — those are data-mode-only by design\n(shadow DOM cannot inject group headers between slotted children).\n\nNo thread CRUD or persistence: every mutation (`lr-thread-pin`/`-archive`/`-delete`/`-rename`) is\na controlled event carrying the *requested* new state — the host mutates `threads`.\n\nData mode: a host needing content with no home in `lr-conversation-item`'s own\n`title`/`excerpt`/`meta`/`actions` surface sets `wrapRow` to wrap the already-built row. For\ncommon row composition, `renderLeading`, `renderMeta`, and `renderRowContent` provide focused\nvirtualized render hooks. A host needing a fully custom\n`actions` surface itself — beyond `rowActions`'s closed `pin | archive | delete` set, e.g. a\n`<lr-menu>` with Rename/Delete — sets `renderActions` instead; its content is appended after any\nbuilt-in `rowActions` output in the same slot, and `wrapRow` continues to compose around the result.",
           "name": "LyraThreadList",
           "cssParts": [
             {
@@ -166990,6 +168739,22 @@
               },
               "description": "Overrides the default case-insensitive `title` + `excerpt` substring match."
             },
+            {
+              "kind": "field",
+              "name": "formatDate",
+              "type": {
+                "text": "(date: Date) => string | undefined"
+              },
+              "description": "Overrides the default locale-aware formatting used for month group dates."
+            },
+            {
+              "kind": "field",
+              "name": "formatGroupLabel",
+              "type": {
+                "text": "(key: ThreadBucketKey, date?: Date) => string | undefined"
+              },
+              "description": "Overrides the localized label for a date group. The date argument is present for month\ngroups and omitted for semantic groups such as `today` or `archived`."
+            },
             {
               "kind": "field",
               "name": "grouping",
@@ -167109,11 +168874,35 @@
               },
               "description": "Data mode only: appended after any built-in `rowActions` buttons in the same row's `actions`\nslot -- the escape hatch for a fully custom per-row action surface (e.g. a `<lr-menu>` with\nRename/Delete, mirroring an app's own richer row-action menu) that `rowActions`'s closed\n`pin | archive | delete` set can't express. Additive, not a replacement: both render together\nwhen `rowActions` is also non-empty, the same composition direction `wrapRow` already takes\nelsewhere on the row (it only ever adds content, never removes built-in output) -- set\n`rowActions` to `[]` (its default) to omit the built-in buttons and use only the callback's\ncontent. Receives the *current* thread on every render, re-invoked per row through the\nvirtualized `renderItem` path exactly like `wrapRow` -- never memoized or stale. Rendered as a\nDOM sibling of the row's own selectable region (`lr-conversation-item`'s `[part=\"option\"]`),\nthe same structural reason the built-in `rowActions` buttons don't also trigger `lr-select` --\nso ordinary Lyra controls returned here (`lr-menu`, `lr-icon-button`, etc.) fire their own\nevents normally without also selecting the row. Unset (the default) leaves `rowActions`'\noutput byte-for-byte unchanged."
             },
+            {
+              "kind": "field",
+              "name": "renderLeading",
+              "type": {
+                "text": "(thread: ChatThread) => TemplateResult | undefined"
+              },
+              "description": "Data mode only: renders non-interactive content in the row's leading slot, before its title\nand excerpt. The callback runs during the virtualized row render."
+            },
+            {
+              "kind": "field",
+              "name": "renderMeta",
+              "type": {
+                "text": "(thread: ChatThread) => TemplateResult | undefined"
+              },
+              "description": "Data mode only: renders the row's meta content. Built-in pin metadata remains available when\npresent, and this result is appended in the same meta region."
+            },
             {
               "kind": "field",
               "name": "renderRow",
               "privacy": "private"
             },
+            {
+              "kind": "field",
+              "name": "renderRowContent",
+              "type": {
+                "text": "(thread: ChatThread) => TemplateResult | undefined"
+              },
+              "description": "Data mode only: replaces the conversation item's title/excerpt/meta content area with a\nhost-rendered row body. Use this for structured, non-interactive row content while keeping\nthe selectable row and timestamp semantics supplied by `<lr-conversation-item>`."
+            },
             {
               "kind": "field",
               "name": "rowActionButtonStyle",
@@ -167346,6 +169135,24 @@
                 }
               ]
             },
+            {
+              "kind": "method",
+              "name": "dateForBucket",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Date | undefined"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "ThreadBucketKey"
+                  }
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "emit",