@kitn.ai/ui 0.25.2 → 0.27.0

package/src/elements/element-meta.json

@@ -378,7 +378,7 @@
         "type": "undefined | { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[]",
         "optional": true,
         "scalar": false,
-        "description": "The attachments to render. Omit (or pass an empty array) for the empty state, which shows `emptyText` if set and nothing otherwise. Set as a JS property (array).",
+        "description": "The attachments to render. Omit (or pass an empty array) for the empty state, which shows `emptyText` if set and nothing otherwise. Set as a JS property (array). Each item's `url` must be a `data:` URI or an https URL, never `URL.createObjectURL`: a `blob:` URL previews here but the wire encoders (`toOpenAIMessages`/`toAnthropicMessages`) refuse it.",
         "typeName": "AttachmentData[]",
         "typeShape": "{ id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[]",
         "default": "[]",
@@ -492,6 +492,16 @@
         "name": "preview",
         "doc": "The image shown in an attachment’s hover-card preview. Bounded by default (max ~320×256, aspect preserved) so a large image never blows up the card. Raise or lower the cap from outside.",
         "recipe": "kai-attachments::part(preview) { max-width: 32rem; max-height: 24rem }"
+      },
+      {
+        "name": "attachment",
+        "doc": "One attachment item: the chip, row or tile, whichever variant is rendering. Restyle its background, radius or border from outside without caring which layout it is.",
+        "recipe": "kai-chat::part(attachment) { border-radius: 0.25rem }"
+      },
+      {
+        "name": "attachment-name",
+        "doc": "The attachment’s filename label. Present in every variant that shows one (a grid tile omits it for an image, which is its own label). Retune its type or hide it entirely.",
+        "recipe": "kai-chat::part(attachment-name) { font-size: 0.75rem }"
       }
     ]
   },
@@ -606,7 +616,7 @@
         "type": "undefined | MediaStream",
         "optional": true,
         "scalar": false,
-        "description": "Live microphone or WebRTC audio to analyze. JS property only.",
+        "description": "Live microphone or WebRTC audio to analyze. JS property only. NOTE: amplitude renders only while state is \"speaking\" unless listening-amplitude is set; every other state plays its scripted animation and ignores the audio.",
         "displayType": "undefined | MediaStream"
       },
       {
@@ -614,7 +624,7 @@
         "type": "undefined | HTMLMediaElement",
         "optional": true,
         "scalar": false,
-        "description": "An `<audio>` or `<video>` element to tap for its audio. JS property only.",
+        "description": "An `<audio>` or `<video>` element to tap for its audio. JS property only. NOTE: amplitude renders only while state is \"speaking\" unless listening-amplitude is set; every other state plays its scripted animation and ignores the audio.",
         "displayType": "undefined | HTMLMediaElement"
       },
       {
@@ -622,9 +632,17 @@
         "type": "undefined | number[]",
         "optional": true,
         "scalar": false,
-        "description": "Pre-computed levels, 0..1. Set this and no AudioContext is ever built, which is what keeps headless/SSR rendering and browser-speech-synthesis playback (which exposes no audio node) free of Web Audio entirely. JS property only. A new array reference is required for each update; mutating the existing array in place will not re-render.",
+        "description": "Pre-computed levels, 0..1. Set this and no AudioContext is ever built, which is what keeps headless/SSR rendering and browser-speech-synthesis playback (which exposes no audio node) free of Web Audio entirely. JS property only. A new array reference is required for each update; mutating the existing array in place will not re-render. NOTE: amplitude renders only while state is \"speaking\" unless listening-amplitude is set; every other state plays its scripted animation and ignores the audio.",
         "displayType": "undefined | number[]"
       },
+      {
+        "name": "listeningAmplitude",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Render live amplitude during the listening state as well, using the same presentation as speaking. Off by default, which keeps LiveKit parity: amplitude from stream, audio-element or bands renders only while state is \"speaking\". Set it to show a real mic-level picture while the user is the one talking. Boolean. Attribute: `listening-amplitude` (a bare attribute means true; reflected, so the property reads back what the attribute set).",
+        "displayType": "undefined | false | true"
+      },
       {
         "name": "shader",
         "type": "undefined | { fragment: string; uniforms?: undefined | Record<string, { type: \"1f\" | \"1i\" | \"1fv\" | \"2f\" | \"3f\" | \"3fv\" | \"4f\" | \"4fv\" | \"Matrix2fv\" | \"Matrix3fv\" | \"Matrix4fv\"; value: number | number[] }> }",
@@ -1165,14 +1183,14 @@
       },
       {
         "name": "policy",
-        "type": "undefined | { onSubmit?: undefined | (cardId: string, data: unknown) => void; onAction?: undefined | (cardId: string, action: string, payload?: unknown) => void; onSendPrompt?: undefined | (text: string, opts: { mode: \"compose\" | \"send\"; context?: unknown; }) => void; onOpen?: undefined | (url: string, target: \"tab\" | \"artifact\") => void; onState?: undefined | (cardId: string, patch: unknown) => void; onDismiss?: undefined | (cardId: string) => void; onReopen?: undefined | (cardId: string) => void; onError?: undefined | (cardId: string, message: string) => void; maxSendPromptMode?: undefined | \"compose\" | \"send\" }",
+        "type": "undefined | { onSubmit?: undefined | ((cardId: string, data: unknown) => void); onAction?: undefined | ((cardId: string, action: string, payload?: unknown) => void); onSendPrompt?: undefined | ((text: string, opts: { mode: \"compose\" | \"send\"; context?: unknown; }) => void); onOpen?: undefined | ((url: string, target: \"tab\" | \"artifact\") => void); onState?: undefined | ((cardId: string, patch: unknown) => void); onDismiss?: undefined | ((cardId: string) => void); onReopen?: undefined | ((cardId: string) => void); onError?: undefined | ((cardId: string, message: string) => void); maxSendPromptMode?: undefined | \"compose\" | \"send\" }",
         "optional": true,
         "scalar": false,
         "description": "Optional CardPolicy handling child events. Property: `el.policy`.",
         "typeName": "CardPolicy",
-        "typeShape": "{ onSubmit?: undefined | (cardId: string, data: unknown) => void; onAction?: undefined | (cardId: string, action: string, payload?: unknown) => void; onSendPrompt?: undefined | (text: string, opts: { mode: \"compose\" | \"send\"; context?: unknown; }) => void; onOpen?: undefined | (url: string, target: \"tab\" | \"artifact\") => void; onState?: undefined | (cardId: string, patch: unknown) => void; onDismiss?: undefined | (cardId: string) => void; onReopen?: undefined | (cardId: string) => void; onError?: undefined | (cardId: string, message: string) => void; maxSendPromptMode?: undefined | \"compose\" | \"send\" }",
+        "typeShape": "{ onSubmit?: undefined | ((cardId: string, data: unknown) => void); onAction?: undefined | ((cardId: string, action: string, payload?: unknown) => void); onSendPrompt?: undefined | ((text: string, opts: { mode: \"compose\" | \"send\"; context?: unknown; }) => void); onOpen?: undefined | ((url: string, target: \"tab\" | \"artifact\") => void); onState?: undefined | ((cardId: string, patch: unknown) => void); onDismiss?: undefined | ((cardId: string) => void); onReopen?: undefined | ((cardId: string) => void); onError?: undefined | ((cardId: string, message: string) => void); maxSendPromptMode?: undefined | \"compose\" | \"send\" }",
         "typeImport": "CardPolicy",
-        "displayType": "undefined | { onSubmit?: undefined | (cardId: string, data: unknown) => void; onAction?: undefined | (cardId: string, action: string, payload?: unknown) => void; onSendPrompt?: undefined | (text: string, opts: { mode: \"compose\" | \"send\"; context?: unknown; }) => void; onOpen?: undefined | (url: string, target: \"tab\" | \"artifact\") => void; onState?: undefined | (cardId: string, patch: unknown) => void; onDismiss?: undefined | (cardId: string) => void; onReopen?: undefined | (cardId: string) => void; onError?: undefined | (cardId: string, message: string) => void; maxSendPromptMode?: undefined | \"compose\" | \"send\" }"
+        "displayType": "undefined | { onSubmit?: undefined | ((cardId: string, data: unknown) => void); onAction?: undefined | ((cardId: string, action: string, payload?: unknown) => void); onSendPrompt?: undefined | ((text: string, opts: { mode: \"compose\" | \"send\"; context?: unknown; }) => void); onOpen?: undefined | ((url: string, target: \"tab\" | \"artifact\") => void); onState?: undefined | ((cardId: string, patch: unknown) => void); onDismiss?: undefined | ((cardId: string) => void); onReopen?: undefined | ((cardId: string) => void); onError?: undefined | ((cardId: string, message: string) => void); maxSendPromptMode?: undefined | \"compose\" | \"send\" }"
       },
       {
         "name": "validateCards",
@@ -1336,15 +1354,6 @@
         "universal": true,
         "displayType": "\"light\" | \"dark\" | \"auto\""
       },
-      {
-        "name": "search",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "Show a Search (Globe) button in the input toolbar; fires a `search` event.",
-        "default": "false",
-        "displayType": "undefined | false | true"
-      },
       {
         "name": "value",
         "type": "undefined | string | ({ type: \"text\"; text: string } | { type: \"entity\"; entity: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> } })[]",
@@ -1424,6 +1433,22 @@
         "default": "true",
         "displayType": "undefined | false | true"
       },
+      {
+        "name": "reasoning",
+        "type": "undefined | \"full\" | \"compact\" | \"off\"",
+        "optional": true,
+        "scalar": true,
+        "description": "How `reasoning` parts render across the thread. `'full'` (default) is the current collapsible-disclosure behavior; `'compact'` shows only a shimmer loader while a reasoning part streams and nothing once it settles (no expandable detail); `'off'` renders reasoning parts not at all. Forwarded to every `MessageBody` as `reasoningMode`.",
+        "displayType": "undefined | \"full\" | \"compact\" | \"off\""
+      },
+      {
+        "name": "reasoningOpen",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Seeds the reasoning disclosure open AND keeps it tracking the stream (open while streaming, closes when it settles): the pre-Task-19f `full` behavior. Default false/absent: the panel starts closed (just the \"Thinking\" shimmer chip) and only opens on click, the current default (owner ruling, 2026-08-26). Meaningless when `reasoning` is `'compact'` or `'off'`. Forwarded to every `MessageBody` as `reasoningDefaultOpen`.",
+        "displayType": "undefined | false | true"
+      },
       {
         "name": "chatTitle",
         "type": "undefined | string",
@@ -1535,6 +1560,24 @@
         "description": "INJECT: footer row below the composer (disclaimers, token meter, …).",
         "displayType": "undefined | false | true"
       },
+      {
+        "name": "attach",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "When `false`, hides the built-in paperclip attach button. Defaults to `true` (undeclared keeps today's behavior: attach visible), matching `DefaultPromptInput`'s own default: only an explicit `false` hides it.",
+        "default": "true",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "webSearch",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Show a web-search (Globe) button in the input toolbar; calls `onWebSearch`.",
+        "default": "false",
+        "displayType": "undefined | false | true"
+      },
       {
         "name": "voice",
         "type": "undefined | false | true",
@@ -1634,12 +1677,6 @@
         "description": "The header model switcher changed.",
         "displayDetail": "{ modelId: string }"
       },
-      {
-        "name": "kai-search",
-        "detail": "Record<string, never>",
-        "description": "The Search button was clicked.",
-        "displayDetail": "Record<string, never>"
-      },
       {
         "name": "kai-submit",
         "detail": "{ value: string; attachments: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[] }",
@@ -1663,6 +1700,12 @@
         "detail": "Record<string, never>",
         "description": "The Mic / voice button was clicked.",
         "displayDetail": "Record<string, never>"
+      },
+      {
+        "name": "kai-web-search",
+        "detail": "Record<string, never>",
+        "description": "The web-search (Globe) toolbar button was clicked.",
+        "displayDetail": "Record<string, never>"
       }
     ],
     "methods": [
@@ -1770,6 +1813,202 @@
       }
     ]
   },
+  {
+    "tag": "kai-checkbox",
+    "className": "KaiCheckboxElement",
+    "displayName": "Checkbox",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "checked",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Controlled checked state. Settable and reflected to the `checked` attribute. `el.checked = true` (or `<kai-checkbox checked>`) drives it; ticking the box updates it and fires `kai-change`. Read `el.checked` for live state.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "defaultChecked",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Initial checked state on mount (uncontrolled seed). Bare attribute (`<kai-checkbox default-checked>`) turns it on.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "indeterminate",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "The mixed state, for a parent box whose children are partly ticked. Visual plus an accessibility hint: the box still reports `checked === false`.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "disabled",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Disable interaction.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "required",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Set the native `required` attribute, and nothing more. Whether an unticked box is an error is the application's rule, not the kit's.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Accessible label. The visible text beside the box is the consumer's to render.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "name",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Form-control name (paired with `value`).",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "value",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Submitted value when checked (paired with `name`). Defaults to `'on'`.",
+        "displayType": "undefined | string"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-change",
+        "detail": "{ checked: false | true }",
+        "description": "The box was ticked or unticked.",
+        "displayDetail": "{ checked: false | true }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "toggle",
+        "params": "",
+        "returns": "void",
+        "description": "Flip the box and fire `kai-change` (no-op while disabled)."
+      },
+      {
+        "name": "focus",
+        "params": "options?: FocusOptions",
+        "returns": "void",
+        "description": "Focus the inner input (the host element can't reach it)."
+      }
+    ],
+    "composedFrom": [
+      {
+        "name": "Checkbox",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-checkbox--docs"
+      }
+    ],
+    "tokens": []
+  },
+  {
+    "tag": "kai-checkbox-group",
+    "className": "KaiCheckboxGroupElement",
+    "displayName": "CheckboxGroup",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "options",
+        "type": "{ value: string; label: string; description?: undefined | string; disabled?: undefined | false | true }[]",
+        "optional": false,
+        "scalar": false,
+        "description": "The choices, top to bottom. Set as a JS PROPERTY (array), never an attribute. Rendered in full: the kit never truncates, re-orders or de-duplicates them.",
+        "typeName": "KaiCheckboxOption[]",
+        "typeShape": "{ value: string; label: string; description?: undefined | string; disabled?: undefined | false | true }[]",
+        "default": "[]",
+        "typeImport": "KaiCheckboxOption",
+        "displayType": "{ value: string; label: string; description?: undefined | string; disabled?: undefined | false | true }[]"
+      },
+      {
+        "name": "value",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "The FIRST selected value. Settable and reflected to the `value` attribute, so `:host([value])` and `el.value` see live state, and a seed can be written in markup. Writing it makes that the whole selection; to read or drive the rest, use `el.values`.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "name",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "The shared form-control name every box carries, so `FormData.getAll(name)` reads the whole selection back under one key. NO DEFAULT, unlike `<kai-radio-group>`. A radio set needs a shared `name` for the browser to make it exclusive and arrow-navigable, so one is generated when none is given; checkboxes are independent controls and behave correctly with no name at all. Generating one here would submit the selection under a random key, which is worse than submitting nothing. The element is NOT form-associated (no `ElementInternals`, no `setFormValue()`), the same known gap `<kai-input>` records: the boxes live in a shadow root, so a surrounding `<form>` collects nothing from them whether or not `name` is set. Read `el.values`. The name still lands on every inner input, so it is right the day form association arrives.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "disabled",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Disable every row. Individual rows carry their own `disabled`.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Accessible name for the group.",
+        "displayType": "undefined | string"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-change",
+        "detail": "{ value: string; values: string[] }",
+        "description": "A row was ticked or unticked. `values` is the whole selection after the change, which is what a multi-select control needs; `value` is the first of them (empty when nothing is selected). Both are always present, so neither shape silently loses the other. This is `<kai-select>`'s detail, deliberately.",
+        "displayDetail": "{ value: string; values: string[] }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "focus",
+        "params": "options?: FocusOptions",
+        "returns": "void",
+        "description": "Focus the group's first box. Not \"the first ticked one\", which is `<kai-radio-group>`'s rule: a radio group is ONE tab stop that lands on the selection, while every checkbox here is its own tab stop, so the entry point is simply the top of the list."
+      }
+    ],
+    "composedFrom": [
+      {
+        "name": "CheckboxGroup",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-checkboxgroup--docs"
+      }
+    ],
+    "tokens": []
+  },
   {
     "tag": "kai-checkpoint",
     "className": "KaiCheckpointElement",
@@ -2177,6 +2416,15 @@
         "default": "true",
         "displayType": "undefined | false | true"
       },
+      {
+        "name": "copy",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Show the copy button. **Defaults to ON**, because this element is documented as shipping one. Opt out with `copy=\"false\"` or `el.copy = false`.",
+        "default": "true",
+        "displayType": "undefined | false | true"
+      },
       {
         "name": "proseSize",
         "type": "undefined | \"xs\" | \"sm\" | \"base\" | \"lg\"",
@@ -2203,6 +2451,13 @@
     ],
     "tokens": [
       "--color-code-foreground"
+    ],
+    "parts": [
+      {
+        "name": "copy",
+        "doc": "The copy-to-clipboard button in the header row. Hide it with `copy=\"false\"` rather than CSS.",
+        "recipe": "kai-code-block::part(copy) { color: var(--color-primary) }"
+      }
     ]
   },
   {
@@ -2543,7 +2798,7 @@
       {
         "name": "kai-submit",
         "detail": "{ doc: ({ type: \"text\"; text: string } | { type: \"entity\"; entity: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> } })[]; text: string; entities: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> }[] }",
-        "description": "The user submitted the composer (Enter or programmatic submit).",
+        "description": "The user submitted the composer (Enter or programmatic submit). Note the detail carries no `attachments`; `<kai-composer>` is the bare editing surface: no send button, toolbar, or attachments. For a drop-in composer row with all three, reach for `<kai-prompt-input>`, which is built on this.",
         "displayDetail": "{ doc: ({ type: \"text\"; text: string } | { type: \"entity\"; entity: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> } })[]; text: string; entities: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> }[] }"
       },
       {
@@ -2821,9 +3076,9 @@
     ]
   },
   {
-    "tag": "kai-conversations",
-    "className": "KaiConversationsElement",
-    "displayName": "Conversations",
+    "tag": "kai-conversation-item",
+    "className": "KaiConversationItemElement",
+    "displayName": "ConversationItem",
     "props": [
       {
         "name": "theme",
@@ -2836,52 +3091,172 @@
         "displayType": "\"light\" | \"dark\" | \"auto\""
       },
       {
-        "name": "groups",
-        "type": "undefined | { id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]",
-        "optional": true,
-        "scalar": false,
-        "description": "The list's section headers (`{ id, name, sortOrder, createdAt }`), rendered in array order. A group carries no conversations of its own; it is matched against `conversations` by id, so the two props are complementary rather than alternatives. Omit for an ungrouped list. Set as a JS property.",
-        "typeName": "ConversationGroup[]",
-        "typeShape": "{ id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]",
-        "default": "[]",
-        "typeImport": "ConversationGroup",
-        "displayType": "undefined | { id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]"
-      },
-      {
-        "name": "conversations",
-        "type": "undefined | { id: string; title: string; groupId?: undefined | string; scope: { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt: string; updatedAt: string; trailing?: undefined | string }[]",
-        "optional": true,
-        "scalar": false,
-        "description": "Every conversation the list renders, flat. Each one is filed under the group whose `id` equals its `groupId`; one with no `groupId`, or with a `groupId` matching no entry in `groups`, falls into a trailing \"Ungrouped\" section, so nothing you pass in is ever dropped. There is no recency bucketing. Set as a JS property. Omit to supply them as `<kai-conversation>` light-DOM children instead, or for the empty state.",
-        "typeName": "ConversationSummary[]",
-        "typeShape": "{ id: string; title: string; groupId?: undefined | string; scope: { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt: string; updatedAt: string; trailing?: undefined | string }[]",
-        "default": "[]",
-        "typeImport": "ConversationSummary",
-        "displayType": "undefined | { id: string; title: string; groupId?: undefined | string; scope: { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt: string; updatedAt: string; trailing?: undefined | string }[]"
-      },
-      {
-        "name": "activeId",
+        "name": "conversationId",
         "type": "undefined | string",
         "optional": true,
         "scalar": true,
-        "description": "The id of the currently-open conversation, highlighted in the list.",
+        "description": "The row's identity: the `conversation-id` attribute (host `id` is the fallback). Inside `<kai-conversations>` it is handed to the container's selection contract (`kai-conversation-select`); standalone it is the `id` in this element's own `kai-select` detail.",
         "displayType": "undefined | string"
       },
       {
-        "name": "collapsed",
+        "name": "active",
         "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "Controlled collapsed state. Set as a JS property (`el.collapsed = true`) to drive the rail from your app, updating it in response to `kai-collapse-toggle`. Omit for uncontrolled (the element manages it). Collapsed shrinks the rail to a floating reopen button.",
+        "description": "Selected state. Reflected as `aria-current` on the row body and a `data-active` styling hook on the row; inside a container the container drives it from its `activeId`, standalone you set it yourself.",
         "displayType": "undefined | false | true"
       },
       {
-        "name": "defaultCollapsed",
+        "name": "compact",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Dense single-line row padding.",
+        "displayType": "undefined | false | true"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-select",
+        "detail": "{ id: string }",
+        "description": "STANDALONE activation only: the row was activated (click, Enter or Space on its body) while the item is NOT a direct child of `<kai-conversations>`. `id` is the row's identity: the `conversation-id` attribute, else the host `id`. Inside a container this never fires: activation surfaces once, as `kai-conversation-select` on the container.",
+        "displayDetail": "{ id: string }"
+      }
+    ],
+    "methods": [],
+    "composedFrom": [
+      {
+        "name": "SlottedConversationItem",
+        "group": "Components",
+        "storyId": "solid-advanced-elements-slottedconversationitem--docs"
+      }
+    ],
+    "tokens": [],
+    "slots": [
+      {
+        "name": "",
+        "mode": "inject",
+        "doc": "The row title. `leading`, `meta` and `menu` are the named regions around it."
+      },
+      {
+        "name": "leading",
+        "mode": "inject",
+        "part": true,
+        "doc": "Leading region before the title (an icon or avatar)."
+      },
+      {
+        "name": "meta",
+        "mode": "inject",
+        "part": true,
+        "doc": "Meta region under the title (a timestamp or status line)."
+      },
+      {
+        "name": "menu",
+        "mode": "inject",
+        "part": true,
+        "doc": "Your own row menu (a popover trigger). Never selects the row."
+      }
+    ],
+    "parts": [
+      {
+        "name": "body",
+        "doc": "The activation surface inside the row (button role; carries aria-current and the roving tabindex). The focus ring paints here.",
+        "recipe": "kai-conversation-item::part(body) { outline-offset: 2px }"
+      },
+      {
+        "name": "row",
+        "doc": "The whole row surface. Carries `data-active` while selected.",
+        "recipe": "kai-conversation-item::part(row) { border-radius: 0.5rem }"
+      },
+      {
+        "name": "title",
+        "doc": "The title line (the default slot renders inside it).",
+        "recipe": "kai-conversation-item::part(title) { font-weight: 600 }"
+      },
+      {
+        "name": "leading",
+        "doc": "Leading region before the title (an icon or avatar)."
+      },
+      {
+        "name": "meta",
+        "doc": "Meta region under the title (a timestamp or status line)."
+      },
+      {
+        "name": "menu",
+        "doc": "Your own row menu (a popover trigger). Never selects the row."
+      }
+    ]
+  },
+  {
+    "tag": "kai-conversations",
+    "className": "KaiConversationsElement",
+    "displayName": "Conversations",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "groups",
+        "type": "undefined | { id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]",
+        "optional": true,
+        "scalar": false,
+        "description": "The list's section headers (`{ id, name, sortOrder, createdAt }`), rendered in array order. A group carries no conversations of its own; it is matched against `conversations` by id, so the two props are complementary rather than alternatives. Omit for an ungrouped list. Set as a JS property.",
+        "typeName": "ConversationGroup[]",
+        "typeShape": "{ id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]",
+        "default": "[]",
+        "typeImport": "ConversationGroup",
+        "displayType": "undefined | { id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]"
+      },
+      {
+        "name": "conversations",
+        "type": "undefined | { id: string; title: string; groupId?: undefined | string; scope?: undefined | { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt?: undefined | string; updatedAt: string; trailing?: undefined | string }[]",
+        "optional": true,
+        "scalar": false,
+        "description": "Every conversation the list renders, flat. Each one is filed under the group whose `id` equals its `groupId`; one with no `groupId`, or with a `groupId` matching no entry in `groups`, falls into a trailing \"Ungrouped\" section, so nothing you pass in is ever dropped. There is no recency bucketing. Set as a JS property. Omit to supply them as `<kai-conversation>` light-DOM children instead, or for the empty state. A search query that matches nothing shows a visible \"No conversations match your search\" state, distinct from the zero-conversations empty state. Slotted `<kai-conversation-item>` children switch the list into item mode instead: your own rows win and this array is not rendered.",
+        "typeName": "ConversationSummary[]",
+        "typeShape": "{ id: string; title: string; groupId?: undefined | string; scope?: undefined | { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt?: undefined | string; updatedAt: string; trailing?: undefined | string }[]",
+        "default": "[]",
+        "typeImport": "ConversationSummary",
+        "displayType": "undefined | { id: string; title: string; groupId?: undefined | string; scope?: undefined | { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt?: undefined | string; updatedAt: string; trailing?: undefined | string }[]"
+      },
+      {
+        "name": "activeId",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "The id of the currently-open conversation, highlighted in the list.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "collapsed",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Controlled collapsed state. Set as a JS property (`el.collapsed = true`) to drive the rail from your app, updating it in response to `kai-collapse-toggle`. Omit for uncontrolled (the element manages it). Collapsed shrinks the rail to a floating reopen button.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "defaultCollapsed",
         "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
         "description": "Initial collapsed state when uncontrolled (default false). Use the `default-collapsed` attribute to start collapsed in plain HTML.",
         "displayType": "undefined | false | true"
+      },
+      {
+        "name": "compact",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Dense single-line rows (a leading dot + title, no message count).",
+        "displayType": "undefined | false | true"
       }
     ],
     "events": [
@@ -2894,7 +3269,7 @@
       {
         "name": "kai-conversation-select",
         "detail": "{ id: string }",
-        "description": "A conversation was selected.",
+        "description": "A conversation was selected. The selection event in BOTH modes: a batteries data row, or an activated `<kai-conversation-item>` child (click, Enter or Space).",
         "displayDetail": "{ id: string }"
       },
       {
@@ -2978,10 +3353,15 @@
           "id"
         ],
         "text": true,
-        "description": "Parse a single light-DOM `<kai-conversation>` element into a `ConversationSummary`. Attribute mapping: - `id` → ConversationSummary.id - `group-id` → ConversationSummary.groupId (optional) - textContent → ConversationSummary.title Required fields not expressible as HTML attributes (`scope`, `messageCount`, `lastMessageAt`, `updatedAt`) receive safe defaults so the rendered list item is fully functional with just `id` + title text."
+        "description": "Parse a single light-DOM `<kai-conversation>` element into a `ConversationSummary`. Attribute mapping: - `id` → ConversationSummary.id - `group-id` → ConversationSummary.groupId (optional) - textContent → ConversationSummary.title Fields not expressible as HTML attributes are NOT fabricated: the optional `scope` and `lastMessageAt` stay absent, and the required `messageCount`/`updatedAt` get honest defaults — zero messages, and an empty `updatedAt` from which no trailing relative time is derived (the epoch it used to fabricate rendered a bogus \"many days ago\" on every declarative row)."
       }
     ],
     "slots": [
+      {
+        "name": "",
+        "mode": "inject",
+        "doc": "Your own `<kai-conversation-item>` rows (item mode: the consumer-owned loop). Data rows do not render while any are present."
+      },
       {
         "name": "header",
         "mode": "replace",
@@ -3003,6 +3383,11 @@
         "name": "trailing",
         "doc": "The right-aligned trailing text on each conversation row (a count, status, or relative time). Set it per item via the `trailing` field; otherwise a short auto relative time is derived from `updatedAt`. Recolor or resize it from outside.",
         "recipe": "kai-conversations::part(trailing) { color: var(--color-primary); font-variant-numeric: tabular-nums }"
+      },
+      {
+        "name": "items",
+        "doc": "The item-mode listbox region wrapping your slotted `<kai-conversation-item>` children.",
+        "recipe": "kai-conversations::part(items) { gap: 2px }"
       }
     ]
   },
@@ -3036,6 +3421,15 @@
         "scalar": true,
         "description": "Initial open state on mount (uncontrolled seed).",
         "displayType": "undefined | false | true"
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Accessible name for the modal, used when no `header` slot is projected: `<kai-dialog label=\"Delete workspace\">`. A projected `header` WINS over this (it becomes `aria-labelledby`), because ARIA resolves `aria-labelledby` ahead of `aria-label` and the visible heading is the name both a sighted and a screen-reader user can be talked through. Defaults to `Dialog` so a modal is never nameless.",
+        "default": "DEFAULT_LABEL",
+        "displayType": "undefined | string"
       }
     ],
     "events": [
@@ -3126,9 +3520,9 @@
     ]
   },
   {
-    "tag": "kai-editable-label",
-    "className": "KaiEditableLabelElement",
-    "displayName": "EditableLabel",
+    "tag": "kai-dock",
+    "className": "KaiDockElement",
+    "displayName": "Dock",
     "props": [
       {
         "name": "theme",
@@ -3141,97 +3535,428 @@
         "displayType": "\"light\" | \"dark\" | \"auto\""
       },
       {
-        "name": "value",
-        "type": "undefined | string",
+        "name": "open",
+        "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "The label text. Settable and reflected to the `value` attribute. Read `el.value` for live state.",
-        "displayType": "undefined | string"
+        "description": "Drive/observe open state (Shoelace-style: settable + reflected to the `open` attribute; the element still self-manages on the launcher and Escape). Set `el.open = true`, or `<kai-dock open>`; listen for `kai-open-change`.",
+        "displayType": "undefined | false | true"
       },
       {
-        "name": "editing",
+        "name": "defaultOpen",
         "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "Controlled edit state. `el.editing = true` opens the field; reflected to the `editing` attribute.",
-        "default": "false",
+        "description": "Initial open state on mount (uncontrolled seed).",
         "displayType": "undefined | false | true"
       },
       {
-        "name": "placeholder",
+        "name": "position",
+        "type": "undefined | \"bottom-end\" | \"bottom-start\" | \"top-end\" | \"top-start\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Which corner the dock sits in. Logical, so `-end` follows the writing direction and an RTL page docks on the left. Attribute: `position`.",
+        "default": "'bottom-end'",
+        "displayType": "undefined | \"bottom-end\" | \"bottom-start\" | \"top-end\" | \"top-start\""
+      },
+      {
+        "name": "label",
         "type": "undefined | string",
         "optional": true,
         "scalar": true,
-        "description": "Placeholder shown while editing / when the value is empty.",
+        "description": "The widget's NAME. Derives the panel's accessible name and both launcher names (`Open ${label}` / `Close ${label}`). Defaults to `Chat`.",
+        "default": "'Chat'",
         "displayType": "undefined | string"
       },
+      {
+        "name": "openLabel",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "i18n override for the launcher's name while closed (default `Open ${label}`).",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "closeLabel",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "i18n override for the launcher's name while open (default `Close ${label}`).",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "unread",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Show the unread dot. YOURS: it renders only while closed, and the dock never writes it back. Clear it in your `kai-open-change` handler.",
+        "displayType": "undefined | false | true"
+      },
       {
         "name": "disabled",
         "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "Disable entering edit mode.",
-        "default": "false",
+        "description": "Disable the launcher; `show()` and `toggle()` are gated on it.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "hideClose",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Suppress the dock's own built-in mobile close X. Set this when your slotted panel content supplies its own close affordance (e.g. a `<kai-chat slot=\"header-end\">` close button), otherwise the two stack. TRADEOFF: the mobile panel reserves a padding band above its content so the built-in X never paints over slotted content; that band stays reserved unless you set this true, so only set it once your own control is actually in place. Attribute: `hide-close`.",
         "displayType": "undefined | false | true"
+      },
+      {
+        "name": "focusOnOpen",
+        "type": "undefined | \"content\" | \"panel\" | \"none\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Where focus lands on open: `content` (default, the first element you slotted), `panel`, or `none`. Attribute: `focus-on-open`.",
+        "default": "'content'",
+        "displayType": "undefined | \"content\" | \"panel\" | \"none\""
       }
     ],
     "events": [
       {
-        "name": "kai-cancel",
-        "detail": "Record<string, never>",
-        "description": "Edit was cancelled (Esc); the text is restored.",
-        "displayDetail": "Record<string, never>"
-      },
-      {
-        "name": "kai-rename",
-        "detail": "{ value: string }",
-        "description": "Committed a changed value (Enter / blur).",
-        "displayDetail": "{ value: string }"
+        "name": "kai-open-change",
+        "detail": "{ open: false | true }",
+        "description": "The dock opened or closed (the launcher, Escape, a driven `open`, or a method).",
+        "displayDetail": "{ open: false | true }"
       }
     ],
     "methods": [
       {
-        "name": "edit",
+        "name": "show",
         "params": "",
         "returns": "void",
-        "description": "Switch the label into its editing field, which autofocuses and selects the current text. Same entry point as a user double-click, and a no-op while `disabled`. Commit with `commit()` or by blurring, abandon with `cancel()` or Escape."
+        "description": "Open it programmatically (no-op while disabled)."
       },
       {
-        "name": "commit",
+        "name": "hide",
         "params": "",
         "returns": "void",
-        "description": "Close the field and keep what was typed, exactly as blurring it does. `kai-rename` fires only when the text actually changed, so committing an untouched field is silent. A no-op while the field is closed."
+        "description": "Close it programmatically."
       },
       {
-        "name": "cancel",
+        "name": "toggle",
         "params": "",
         "returns": "void",
-        "description": "Abandon the edit, exactly as Escape does: the original text is restored, the field closes and `kai-cancel` fires. `kai-rename` never fires, even if the field was edited. Also works when `editing` was set programmatically and the field has not rendered yet."
+        "description": "Flip the open state (closes while disabled)."
+      },
+      {
+        "name": "focus",
+        "params": "options?: FocusOptions",
+        "returns": "void",
+        "description": "Move focus to the panel while open, or to the launcher while closed."
       }
     ],
     "composedFrom": [
       {
-        "name": "EditableLabel",
+        "name": "Dock",
         "group": "UI",
-        "storyId": "solid-advanced-primitives-editablelabel--docs"
+        "storyId": "solid-advanced-primitives-dock--docs"
+      },
+      {
+        "name": "DockCloseGlyph",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-dockcloseglyph--docs"
+      },
+      {
+        "name": "DockLauncherGlyph",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-docklauncherglyph--docs"
       }
     ],
     "tokens": [],
+    "slots": [
+      {
+        "name": "",
+        "mode": "inject",
+        "doc": "The panel body, the same region as `slot=\"panel\"`."
+      },
+      {
+        "name": "panel",
+        "mode": "replace",
+        "part": true,
+        "doc": "The panel body. ANY element: a `<kai-chat>`, a form, your own component. The dock never reads or types it, and the default slot is the same region."
+      },
+      {
+        "name": "launcher",
+        "mode": "inject",
+        "doc": "Content inside the built-in button while CLOSED; defaults to a chat glyph. Text works as well as an icon: the button keeps its height and grows sideways into a pill, so a label like \"Support\" is not clipped. The BUTTON is never slotted away, because it owns aria-expanded, aria-controls, the toggle wiring and the focus return."
+      },
+      {
+        "name": "launcher-open",
+        "mode": "inject",
+        "doc": "Content inside the button while OPEN; defaults to a ✕. Fill only `launcher` and that glyph stays while open rather than morphing into a built-in that clashes with it."
+      }
+    ],
     "parts": [
       {
-        "name": "text",
-        "doc": "The read-mode label text. Restyle its typography; it swaps to the input on edit.",
-        "recipe": "kai-editable-label::part(text) { font-weight: 600 }"
+        "name": "launcher",
+        "doc": "The launcher button pinned to the corner: a disc by default, a pill once you slot a text label. Restyle its surface or shadow; --kai-dock-launcher-size sets its height and its minimum width.",
+        "recipe": "kai-dock::part(launcher) { background: var(--color-info) }"
       },
       {
-        "name": "input",
-        "doc": "The edit-mode input (the composed kai-input field).",
-        "recipe": "kai-editable-label::part(input) { font: inherit }"
+        "name": "badge",
+        "doc": "The unread dot on the launcher, rendered only while closed and only when `unread` is set. Restyle its color or size.",
+        "recipe": "kai-dock::part(badge) { background: var(--color-success) }"
+      },
+      {
+        "name": "panel",
+        "doc": "The panel body. ANY element: a `<kai-chat>`, a form, your own component. The dock never reads or types it, and the default slot is the same region."
       }
     ]
   },
   {
-    "tag": "kai-embed",
+    "tag": "kai-dropdown",
+    "className": "KaiDropdownElement",
+    "displayName": "Dropdown",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "triggerIcon",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Built-in trigger: leading icon (a named icon like `\"plus\"`, an image URL/data-URI, or text). A slotted `slot=\"trigger\"` overrides it.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "triggerLabel",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Built-in trigger: a text label. This is the trigger's VISIBLE text, so it is also its accessible name, and `label` does not override it: an accessible name that does not contain the visible text is unreachable by speech input (WCAG 2.5.3, Label in Name). Same rule `kai-menu` follows.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "triggerIconTrailing",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Built-in trigger: a trailing icon (e.g. `\"chevron-down\"` for a select look).",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Accessible name for a trigger with no visible label. Ignored when `triggerLabel` is set, which is already the visible name. It DOES name a slotted `slot=\"trigger\"`, which is VISUAL content with the name supplied separately: the same two-slot distinction `kai-menu` documents.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "full",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Stretch the trigger to the full width of its container (a block row). Attribute: `full`.",
+        "default": "false",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "open",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Drive/observe open state (Shoelace-style: settable + reflected to the `open` attribute, the menu still self-manages on click/keyboard). Set `el.open = true`, or `<kai-dropdown open>`; listen for `kai-open-change`.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "defaultOpen",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Initial open state on mount (uncontrolled seed).",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "disabled",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Disable the trigger: click/keyboard and `show()` no longer open the menu.",
+        "displayType": "undefined | false | true"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-open-change",
+        "detail": "{ open: false | true }",
+        "description": "The menu opened or closed (click, keyboard, Escape, outside-click, or a method).",
+        "displayDetail": "{ open: false | true }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "show",
+        "params": "",
+        "returns": "void",
+        "description": "Open it programmatically (no-op while disabled)."
+      },
+      {
+        "name": "hide",
+        "params": "",
+        "returns": "void",
+        "description": "Close it programmatically."
+      },
+      {
+        "name": "toggle",
+        "params": "",
+        "returns": "void",
+        "description": "Flip the open state (closes while disabled)."
+      }
+    ],
+    "composedFrom": [
+      {
+        "name": "Dropdown",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-dropdown--docs"
+      },
+      {
+        "name": "DropdownTrigger",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-dropdowntrigger--docs"
+      },
+      {
+        "name": "DropdownContent",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-dropdowncontent--docs"
+      }
+    ],
+    "tokens": [],
+    "slots": [
+      {
+        "name": "",
+        "mode": "inject",
+        "doc": "The menu body: your own rows. Give each `role=\"menuitem\"`. The control that opens it is the `trigger` slot."
+      },
+      {
+        "name": "trigger",
+        "mode": "replace",
+        "doc": "Visual content of the trigger button (an icon, text, an `<svg>`). Replaces the built-in trigger* content; name it with `label`."
+      }
+    ]
+  },
+  {
+    "tag": "kai-editable-label",
+    "className": "KaiEditableLabelElement",
+    "displayName": "EditableLabel",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "value",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "The label text. Settable and reflected to the `value` attribute. Read `el.value` for live state.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "editing",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Controlled edit state. `el.editing = true` opens the field; reflected to the `editing` attribute.",
+        "default": "false",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "placeholder",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Placeholder shown while editing / when the value is empty.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "disabled",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Disable entering edit mode.",
+        "default": "false",
+        "displayType": "undefined | false | true"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-cancel",
+        "detail": "Record<string, never>",
+        "description": "Edit was cancelled (Esc); the text is restored.",
+        "displayDetail": "Record<string, never>"
+      },
+      {
+        "name": "kai-rename",
+        "detail": "{ value: string }",
+        "description": "Committed a changed value (Enter / blur).",
+        "displayDetail": "{ value: string }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "edit",
+        "params": "",
+        "returns": "void",
+        "description": "Switch the label into its editing field, which autofocuses and selects the current text. Same entry point as a user double-click, and a no-op while `disabled`. Commit with `commit()` or by blurring, abandon with `cancel()` or Escape."
+      },
+      {
+        "name": "commit",
+        "params": "",
+        "returns": "void",
+        "description": "Close the field and keep what was typed, exactly as blurring it does. `kai-rename` fires only when the text actually changed, so committing an untouched field is silent. A no-op while the field is closed."
+      },
+      {
+        "name": "cancel",
+        "params": "",
+        "returns": "void",
+        "description": "Abandon the edit, exactly as Escape does: the original text is restored, the field closes and `kai-cancel` fires. `kai-rename` never fires, even if the field was edited. Also works when `editing` was set programmatically and the field has not rendered yet."
+      }
+    ],
+    "composedFrom": [
+      {
+        "name": "EditableLabel",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-editablelabel--docs"
+      }
+    ],
+    "tokens": [],
+    "parts": [
+      {
+        "name": "text",
+        "doc": "The read-mode label text. Restyle its typography; it swaps to the input on edit.",
+        "recipe": "kai-editable-label::part(text) { font-weight: 600 }"
+      },
+      {
+        "name": "input",
+        "doc": "The edit-mode input (the composed kai-input field).",
+        "recipe": "kai-editable-label::part(input) { font: inherit }"
+      }
+    ]
+  },
+  {
+    "tag": "kai-embed",
     "className": "KaiEmbedElement",
     "displayName": "Embed",
     "props": [
@@ -3652,14 +4377,14 @@
       },
       {
         "name": "data",
-        "type": "undefined | { type: \"object\"; title?: undefined | string; description?: undefined | string; required?: undefined | string[]; properties: Record<string, { type: \"string\" | \"number\" | \"integer\" | \"boolean\" | \"array\" | \"object\"; title?: undefined | string; description?: undefined | string; default?: unknown; enum?: undefined | unknown[]; format?: undefined | \"email\" | \"uri\" | \"url\" | \"date\" | \"date-time\" | \"time\"; minimum?: undefined | number; maximum?: undefined | number; minLength?: undefined | number; maxLength?: undefined | number; pattern?: undefined | string; minItems?: undefined | number; maxItems?: undefined | number; items?: undefined | Record<string, unknown> | { enum: unknown[] }; properties?: undefined | Record<string, Record<string, unknown>>; required?: undefined | string[]; readOnly?: undefined | false | true; \"x-kai-widget\"?: undefined | \"textarea\" | \"slider\" | \"rating\" | \"radio\" | \"select\" | \"checkbox\" | \"password\" | \"switch\"; \"x-kai-placeholder\"?: undefined | string; \"x-kai-step\"?: undefined | number }>; \"x-kai-order\"?: undefined | string[]; \"x-kai-inlineMax\"?: undefined | number; \"x-kai-submitLabel\"?: undefined | string; \"x-kai-dismissible\"?: undefined | false | true; \"x-kai-actions\"?: undefined | { id: string; label: string; variant?: undefined | \"default\" | \"ghost\" | \"outline\" }[] }",
+        "type": "undefined | { type: \"object\"; title?: undefined | string; description?: undefined | string; required?: undefined | string[]; properties: Record<string, { type: \"string\" | \"number\" | \"integer\" | \"boolean\" | \"array\" | \"object\"; title?: undefined | string; description?: undefined | string; default?: unknown; enum?: undefined | unknown[]; format?: undefined | \"email\" | \"uri\" | \"url\" | \"date\" | \"date-time\" | \"time\"; minimum?: undefined | number; maximum?: undefined | number; minLength?: undefined | number; maxLength?: undefined | number; pattern?: undefined | string; minItems?: undefined | number; maxItems?: undefined | number; items?: undefined | Record<string, unknown> | { enum: unknown[] }; properties?: undefined | Record<string, Record<string, unknown>>; required?: undefined | string[]; readOnly?: undefined | false | true; \"x-kai-widget\"?: undefined | \"textarea\" | \"slider\" | \"rating\" | \"radio\" | \"select\" | \"checkbox\" | \"password\" | \"switch\"; \"x-kai-placeholder\"?: undefined | string; \"x-kai-step\"?: undefined | number; \"x-kai-format\"?: undefined | \"tel\" | \"ssn\" | \"credit-card\" | \"custom\"; \"x-kai-mask\"?: undefined | string; \"x-kai-mask-guide\"?: undefined | string }>; \"x-kai-order\"?: undefined | string[]; \"x-kai-inlineMax\"?: undefined | number; \"x-kai-submitLabel\"?: undefined | string; \"x-kai-dismissible\"?: undefined | false | true; \"x-kai-actions\"?: undefined | { id: string; label: string; variant?: undefined | \"default\" | \"ghost\" | \"outline\" }[] }",
         "optional": true,
         "scalar": false,
         "description": "The form definition: a JSON Schema (`type:'object'`) + `x-kai-*` UI hints (the CardEnvelope.data). Set as a JS PROPERTY: `el.data = { type:'object', properties:{…} }`. Import the `FormDefinition` type from `@kitn.ai/ui` for the full shape. It IS self-referential (`FormField.properties` is another `FormField` map), and the generated `element-types.d.ts` inlines every named type, so the shipped declaration bottoms out in a `Record<string, unknown>` placeholder one level down rather than carrying the recursion. That is why `FormDefinition` is a `type` alias: an interface gets no implicit index signature, so it would not be assignable to that placeholder.",
         "typeName": "FormDefinition",
-        "typeShape": "{ type: \"object\"; title?: undefined | string; description?: undefined | string; required?: undefined | string[]; properties: Record<string, { type: \"string\" | \"number\" | \"integer\" | \"boolean\" | \"array\" | \"object\"; title?: undefined | string; description?: undefined | string; default?: unknown; enum?: undefined | unknown[]; format?: undefined | \"email\" | \"uri\" | \"url\" | \"date\" | \"date-time\" | \"time\"; minimum?: undefined | number; maximum?: undefined | number; minLength?: undefined | number; maxLength?: undefined | number; pattern?: undefined | string; minItems?: undefined | number; maxItems?: undefined | number; items?: undefined | Record<string, unknown> | { enum: unknown[] }; properties?: undefined | Record<string, Record<string, unknown>>; required?: undefined | string[]; readOnly?: undefined | false | true; \"x-kai-widget\"?: undefined | \"textarea\" | \"slider\" | \"rating\" | \"radio\" | \"select\" | \"checkbox\" | \"password\" | \"switch\"; \"x-kai-placeholder\"?: undefined | string; \"x-kai-step\"?: undefined | number }>; \"x-kai-order\"?: undefined | string[]; \"x-kai-inlineMax\"?: undefined | number; \"x-kai-submitLabel\"?: undefined | string; \"x-kai-dismissible\"?: undefined | false | true; \"x-kai-actions\"?: undefined | { id: string; label: string; variant?: undefined | \"default\" | \"ghost\" | \"outline\" }[] }",
+        "typeShape": "{ type: \"object\"; title?: undefined | string; description?: undefined | string; required?: undefined | string[]; properties: Record<string, { type: \"string\" | \"number\" | \"integer\" | \"boolean\" | \"array\" | \"object\"; title?: undefined | string; description?: undefined | string; default?: unknown; enum?: undefined | unknown[]; format?: undefined | \"email\" | \"uri\" | \"url\" | \"date\" | \"date-time\" | \"time\"; minimum?: undefined | number; maximum?: undefined | number; minLength?: undefined | number; maxLength?: undefined | number; pattern?: undefined | string; minItems?: undefined | number; maxItems?: undefined | number; items?: undefined | Record<string, unknown> | { enum: unknown[] }; properties?: undefined | Record<string, Record<string, unknown>>; required?: undefined | string[]; readOnly?: undefined | false | true; \"x-kai-widget\"?: undefined | \"textarea\" | \"slider\" | \"rating\" | \"radio\" | \"select\" | \"checkbox\" | \"password\" | \"switch\"; \"x-kai-placeholder\"?: undefined | string; \"x-kai-step\"?: undefined | number; \"x-kai-format\"?: undefined | \"tel\" | \"ssn\" | \"credit-card\" | \"custom\"; \"x-kai-mask\"?: undefined | string; \"x-kai-mask-guide\"?: undefined | string }>; \"x-kai-order\"?: undefined | string[]; \"x-kai-inlineMax\"?: undefined | number; \"x-kai-submitLabel\"?: undefined | string; \"x-kai-dismissible\"?: undefined | false | true; \"x-kai-actions\"?: undefined | { id: string; label: string; variant?: undefined | \"default\" | \"ghost\" | \"outline\" }[] }",
         "typeImport": "FormDefinition",
-        "displayType": "undefined | { type: \"object\"; title?: undefined | string; description?: undefined | string; required?: undefined | string[]; properties: Record<string, { type: \"string\" | \"number\" | \"integer\" | \"boolean\" | \"array\" | \"object\"; title?: undefined | string; description?: undefined | string; default?: unknown; enum?: undefined | unknown[]; format?: undefined | \"email\" | \"uri\" | \"url\" | \"date\" | \"date-time\" | \"time\"; minimum?: undefined | number; maximum?: undefined | number; minLength?: undefined | number; maxLength?: undefined | number; pattern?: undefined | string; minItems?: undefined | number; maxItems?: undefined | number; items?: undefined | Record<string, unknown> | { enum: unknown[] }; properties?: undefined | Record<string, Record<string, unknown>>; required?: undefined | string[]; readOnly?: undefined | false | true; \"x-kai-widget\"?: undefined | \"textarea\" | \"slider\" | \"rating\" | \"radio\" | \"select\" | \"checkbox\" | \"password\" | \"switch\"; \"x-kai-placeholder\"?: undefined | string; \"x-kai-step\"?: undefined | number }>; \"x-kai-order\"?: undefined | string[]; \"x-kai-inlineMax\"?: undefined | number; \"x-kai-submitLabel\"?: undefined | string; \"x-kai-dismissible\"?: undefined | false | true; \"x-kai-actions\"?: undefined | { id: string; label: string; variant?: undefined | \"default\" | \"ghost\" | \"outline\" }[] }"
+        "displayType": "undefined | { type: \"object\"; title?: undefined | string; description?: undefined | string; required?: undefined | string[]; properties: Record<string, { type: \"string\" | \"number\" | \"integer\" | \"boolean\" | \"array\" | \"object\"; title?: undefined | string; description?: undefined | string; default?: unknown; enum?: undefined | unknown[]; format?: undefined | \"email\" | \"uri\" | \"url\" | \"date\" | \"date-time\" | \"time\"; minimum?: undefined | number; maximum?: undefined | number; minLength?: undefined | number; maxLength?: undefined | number; pattern?: undefined | string; minItems?: undefined | number; maxItems?: undefined | number; items?: undefined | Record<string, unknown> | { enum: unknown[] }; properties?: undefined | Record<string, Record<string, unknown>>; required?: undefined | string[]; readOnly?: undefined | false | true; \"x-kai-widget\"?: undefined | \"textarea\" | \"slider\" | \"rating\" | \"radio\" | \"select\" | \"checkbox\" | \"password\" | \"switch\"; \"x-kai-placeholder\"?: undefined | string; \"x-kai-step\"?: undefined | number; \"x-kai-format\"?: undefined | \"tel\" | \"ssn\" | \"credit-card\" | \"custom\"; \"x-kai-mask\"?: undefined | string; \"x-kai-mask-guide\"?: undefined | string }>; \"x-kai-order\"?: undefined | string[]; \"x-kai-inlineMax\"?: undefined | number; \"x-kai-submitLabel\"?: undefined | string; \"x-kai-dismissible\"?: undefined | false | true; \"x-kai-actions\"?: undefined | { id: string; label: string; variant?: undefined | \"default\" | \"ghost\" | \"outline\" }[] }"
       },
       {
         "name": "cardId",
@@ -4024,7 +4749,7 @@
         "type": "undefined | string",
         "optional": true,
         "scalar": true,
-        "description": "Controlled value. Settable and reflected to the `value` attribute. `el.value = 'hi'` drives it (no event); typing updates it and fires `kai-input`. Read `el.value` for live state.",
+        "description": "Controlled value, and always the CANONICAL one when a mask is active: digits for `tel` / `ssn` / `credit-card`, the formatted text for `custom`. Settable and reflected to the `value` attribute. `el.value = '5551234567'` drives it (no event) and is re-fitted to the mask on the way in, so the field shows `555-123-4567`. Read `el.value` for live state; the formatted text rides along on every `kai-input` / `kai-change` detail as `formattedValue`.",
         "displayType": "undefined | string"
       },
       {
@@ -4123,27 +4848,73 @@
         "scalar": true,
         "description": "Virtual-keyboard hint forwarded to the inner input (e.g. `numeric`, `email`).",
         "displayType": "undefined | string"
-      }
-    ],
-    "events": [
-      {
-        "name": "kai-change",
-        "detail": "{ value: string }",
-        "description": "The value was committed (blur).",
-        "displayDetail": "{ value: string }"
       },
       {
-        "name": "kai-input",
-        "detail": "{ value: string }",
-        "description": "The value changed per keystroke.",
-        "displayDetail": "{ value: string }"
-      }
-    ],
-    "methods": [
+        "name": "format",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Mask pattern: `#` a digit, `@` a letter or digit, `*` an obscurable letter or digit, and every other character a positional literal (`@@@-####` → `CHG-4821`). The literal `default` is the opt-in sentinel: it resolves to the default format of `semantic` (`tel` → `###-###-####`). A bare `semantic` never starts masking on its own, so an opt-in token is what turns tier 2 on.",
+        "displayType": "undefined | string"
+      },
       {
-        "name": "focus",
-        "params": "options?: FocusOptions",
-        "returns": "void",
+        "name": "guide",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Placeholder guide shown at unfilled positions, aligned position for position with `format`: `mm/dd/yyyy` against `##/##/####`. Spaces are a valid guide character, so a guide of blanks and separators is how a phone field shows its shape without showing letters. Without a guide the field shows only up to the last typed character. A guide is a visual aid, never an accessible name: keep the `hint` text as well.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "semantic",
+        "type": "undefined | \"credit-card\" | \"custom\" | \"ssn\" | \"tel\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Semantic field type: `tel` · `ssn` · `credit-card` · `custom`. On its own it sets `inputmode` / `autocomplete` / `spellcheck` / `autocorrect` / `autocapitalize` and decides the canonical value; it never starts masking by itself.",
+        "displayType": "undefined | \"credit-card\" | \"custom\" | \"ssn\" | \"tel\""
+      },
+      {
+        "name": "caseMode",
+        "type": "undefined | \"preserve\" | \"upper\" | \"lower\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Case folding applied to typed and pasted text: `preserve` (default) · `upper` · `lower`. Attribute: `case-mode`.",
+        "displayType": "undefined | \"preserve\" | \"upper\" | \"lower\""
+      },
+      {
+        "name": "copyPolicy",
+        "type": "undefined | \"formatted\" | \"canonical\" | \"obscured\" | \"blocked\"",
+        "optional": true,
+        "scalar": true,
+        "description": "What a copy or cut of a masked field puts on the clipboard: `canonical` (default) · `formatted` · `obscured` · `blocked`. Attribute: `copy-policy`.",
+        "displayType": "undefined | \"formatted\" | \"canonical\" | \"obscured\" | \"blocked\""
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-change",
+        "detail": "{ value: string; formattedValue: string }",
+        "description": "The value was committed (blur). Same detail shape as `kai-input`.",
+        "displayDetail": "{ value: string; formattedValue: string }"
+      },
+      {
+        "name": "kai-input",
+        "detail": "{ value: string; formattedValue: string }",
+        "description": "The value changed per keystroke. `value` is the canonical value (what a backend wants); `formattedValue` is the text on screen. With no mask the two are equal.",
+        "displayDetail": "{ value: string; formattedValue: string }"
+      },
+      {
+        "name": "kai-input-rejected",
+        "detail": "{ reason: \"full\" | \"wrong-class\" | \"over-capacity\" | \"format-change-clipped\"; data: string }",
+        "description": "A mask refused, or partly refused, some content. The reasons are `full` (no free position left), `wrong-class` (a letter into a digit position), `over-capacity` (a paste longer than the mask holds; what fits was kept), and `format-change-clipped` (the `format` changed under a value that no longer fits). `data` is the content that was refused. The first three are USER-INPUT errors, and are the ones worth announcing in a polite live region. `format-change-clipped` is not one: it follows the app changing its own configuration, so it reports and nothing more. None of the four touches validity, so `invalid` and `error` stay the consumer decision.",
+        "displayDetail": "{ reason: \"full\" | \"wrong-class\" | \"over-capacity\" | \"format-change-clipped\"; data: string }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "focus",
+        "params": "options?: FocusOptions",
+        "returns": "void",
         "description": "Focus the inner input (the host can't reach into the shadow root)."
       },
       {
@@ -4152,11 +4923,23 @@
         "returns": "void",
         "description": "Select the inner input's text."
       },
+      {
+        "name": "getRawValue",
+        "params": "",
+        "returns": "string",
+        "description": "The canonical value: digits for `tel` / `ssn` / `credit-card`, the formatted text for `custom`, and the field text when no mask is on. Identical to reading `el.value`, under the name backends use for the submitted form of a masked field. The mask engine has a third, narrower notion of raw (the fill characters with no literals at all) and that one is internal: it is not what any backend wants and it is not exposed here."
+      },
+      {
+        "name": "getFormattedValue",
+        "params": "",
+        "returns": "string",
+        "description": "The text on screen, literals and guide included. The counterpart to `formattedValue` on the `kai-input` / `kai-change` details, for a consumer that needs it outside an event."
+      },
       {
         "name": "clear",
         "params": "",
         "returns": "void",
-        "description": "Empty the value and fire `kai-change` with `''`."
+        "description": "Empty the value and fire `kai-change` with `''`. On a masked field this resets the mask itself, not just the text on screen, so the next character starts over."
       }
     ],
     "composedFrom": [
@@ -4502,6 +5285,15 @@
         "description": "Accessible name for a trigger with no visible label. Ignored when `triggerLabel` is set, which is already the visible name. It DOES name a slotted `slot=\"trigger\"`, and that is a difference in what the two slots MEAN, not a limitation. `<kai-button>`'s slot IS the button's label, so text slotted there is the name and `label` steps aside. This slot is VISUAL content, a `+` or an `<svg>`, with the name supplied separately: decoration beside a name, never a second name competing with one. So `label` names the trigger here by design. Slotting a real WORD rather than a glyph makes that word a visible label, and an accessible name has to contain the visible text. Then either drop `label` or make it contain the word you slotted.",
         "displayType": "undefined | string"
       },
+      {
+        "name": "full",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Stretch the trigger to the full width of the menu's container (a block row), e.g. a sidebar-footer account row. Same affordance as `<kai-button full>`. Attribute: `full`.",
+        "default": "false",
+        "displayType": "undefined | false | true"
+      },
       {
         "name": "open",
         "type": "undefined | false | true",
@@ -4850,6 +5642,16 @@
         "doc": "The citation row rendered from the message’s `source` parts: a wrapped row of chips below the bubble, never inside it. Restyle its spacing or hide it entirely from outside.",
         "recipe": "kai-message::part(citations) { gap: 0.5rem }"
       },
+      {
+        "name": "attachment",
+        "doc": "One attachment item: the chip, row or tile, whichever variant is rendering. Restyle its background, radius or border from outside without caring which layout it is.",
+        "recipe": "kai-chat::part(attachment) { border-radius: 0.25rem }"
+      },
+      {
+        "name": "attachment-name",
+        "doc": "The attachment’s filename label. Present in every variant that shows one (a grid tile omits it for an image, which is its own label). Retune its type or hide it entirely.",
+        "recipe": "kai-chat::part(attachment-name) { font-size: 0.75rem }"
+      },
       {
         "name": "avatar",
         "doc": "Replaces the built-in avatar rail with your own node. Use `avatar=\"none\"` to omit the rail and let the body span the full row."
@@ -5334,6 +6136,73 @@
       }
     ]
   },
+  {
+    "tag": "kai-pane-grid",
+    "className": "KaiPaneGridElement",
+    "displayName": "PaneGrid",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "minPaneWidth",
+        "type": "undefined | number",
+        "optional": true,
+        "scalar": true,
+        "description": "Minimum width of every pane, in px, before columns drop / the grid scrolls. Defaults to `280`. Attribute: `min-pane-width`.",
+        "displayType": "undefined | number"
+      },
+      {
+        "name": "minPaneHeight",
+        "type": "undefined | number",
+        "optional": true,
+        "scalar": true,
+        "description": "Minimum height of every pane, in px, before the grid scrolls vertically. Defaults to `200`. Attribute: `min-pane-height`.",
+        "displayType": "undefined | number"
+      },
+      {
+        "name": "maxColumns",
+        "type": "undefined | number",
+        "optional": true,
+        "scalar": true,
+        "description": "Column cap when the container is wide (default `3`). Attribute: `max-columns`.",
+        "displayType": "undefined | number"
+      },
+      {
+        "name": "gap",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Gap between panes, any CSS length. Defaults to the kit gap (`var(--kai-pane-grid-gap, 0.5rem)`). Attribute: `gap`.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "maximizedIndex",
+        "type": "undefined | number | null",
+        "optional": true,
+        "scalar": false,
+        "description": "When set to a valid child index, render ONLY that pane full-bleed: a simple maximize hook the consumer drives (pair it with `<kai-pane>`'s `kai-maximize` event). Clear it (or point out of range) for the full tiled grid. Attribute: `maximized-index`.",
+        "displayType": "undefined | number | null"
+      }
+    ],
+    "events": [],
+    "methods": [],
+    "composedFrom": [
+      {
+        "name": "PaneGrid",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-panegrid--docs"
+      }
+    ],
+    "tokens": []
+  },
   {
     "tag": "kai-pane-group",
     "className": "KaiPaneGroupElement",
@@ -5781,11 +6650,11 @@
         "displayType": "undefined | \"submit\" | \"fill\""
       },
       {
-        "name": "search",
+        "name": "webSearch",
         "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "Show a Search (Globe) button in the left toolbar; clicking it fires a `search` event.",
+        "description": "Show a web-search (Globe) button in the left toolbar; clicking it fires a `kai-web-search` event. Attribute: `web-search`.",
         "default": "false",
         "displayType": "undefined | false | true"
       },
@@ -5830,7 +6699,7 @@
         "type": "undefined | { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[]",
         "optional": true,
         "scalar": false,
-        "description": "Attachments to seed the input with (so a consumer can pre-populate staged files without an upload). Set as a JS property; the element then manages its own attachment state from there (add via the paperclip, remove per chip).",
+        "description": "Attachments to seed the input with (so a consumer can pre-populate staged files without an upload). Set as a JS property; the element then manages its own attachment state from there (add via the paperclip, remove per chip). Each item's `url` must be a `data:` URI or an https URL, never `URL.createObjectURL`: a `blob:` URL previews perfectly and is meaningless outside this tab, so `toOpenAIMessages`/`toAnthropicMessages` refuse it. (The built-in paperclip already stages files as `data:` URIs.)",
         "typeName": "AttachmentData[]",
         "typeShape": "{ id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[]",
         "typeImport": "AttachmentData",
@@ -5863,12 +6732,6 @@
         "description": "The staged attachments changed: a file was added (via the paperclip) or removed (per-chip ×). Carries the full current list so a consumer can react in real time (validate, show upload progress, toggle the send button).",
         "displayDetail": "{ attachments: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[] }"
       },
-      {
-        "name": "kai-search",
-        "detail": "Record<string, never>",
-        "description": "The Search (Globe) toolbar button was clicked.",
-        "displayDetail": "Record<string, never>"
-      },
       {
         "name": "kai-stop",
         "detail": "Record<string, never>",
@@ -5878,7 +6741,7 @@
       {
         "name": "kai-submit",
         "detail": "{ value: string; doc: ({ type: \"text\"; text: string } | { type: \"entity\"; entity: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> } })[]; entities: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> }[]; attachments: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[] }",
-        "description": "The user submitted the prompt (Enter or send button). `value` is the flattened text (back-compat); `doc` is the structured document and `entities` the inserted pills (skills/agents) for downstream expansion.",
+        "description": "The user submitted the prompt (Enter or send button). `value` is the flattened text (back-compat); `doc` is the structured document and `entities` the inserted pills (skills/agents) for downstream expansion. `<kai-prompt-input>` is the batteries-included composer row (send button, toolbar, attachment staging) built on `<kai-composer>`, the bare editor.",
         "displayDetail": "{ value: string; doc: ({ type: \"text\"; text: string } | { type: \"entity\"; entity: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> } })[]; entities: { kind: string; id: string; label: string; icon?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> }[]; attachments: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[] }"
       },
       {
@@ -5904,6 +6767,12 @@
         "detail": "Record<string, never>",
         "description": "The Voice (Mic) toolbar button was clicked.",
         "displayDetail": "Record<string, never>"
+      },
+      {
+        "name": "kai-web-search",
+        "detail": "Record<string, never>",
+        "description": "The web-search (Globe) toolbar button was clicked.",
+        "displayDetail": "Record<string, never>"
       }
     ],
     "methods": [
@@ -6028,6 +6897,91 @@
       }
     ]
   },
+  {
+    "tag": "kai-radio-group",
+    "className": "KaiRadioGroupElement",
+    "displayName": "RadioGroup",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "options",
+        "type": "{ value: string; label: string; description?: undefined | string; disabled?: undefined | false | true }[]",
+        "optional": false,
+        "scalar": false,
+        "description": "The choices, top to bottom. Set as a JS PROPERTY (array), never an attribute.",
+        "typeName": "KaiRadioOption[]",
+        "typeShape": "{ value: string; label: string; description?: undefined | string; disabled?: undefined | false | true }[]",
+        "default": "[]",
+        "typeImport": "KaiRadioOption",
+        "displayType": "{ value: string; label: string; description?: undefined | string; disabled?: undefined | false | true }[]"
+      },
+      {
+        "name": "value",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Controlled selected `value`. Settable and reflected to the `value` attribute. `el.value = 'degraded'` drives it; choosing a row updates it and fires `kai-change`. Read `el.value` for live state.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "name",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Shared form-control name for every radio in the group. Defaults to a generated id, so the group is exclusive and keyboard-navigable even when nothing is submitted.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "disabled",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Disable every row. Individual rows carry their own `disabled`.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Accessible name for the group.",
+        "displayType": "undefined | string"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-change",
+        "detail": "{ value: string }",
+        "description": "A row was chosen.",
+        "displayDetail": "{ value: string }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "focus",
+        "params": "options?: FocusOptions",
+        "returns": "void",
+        "description": "Focus the group's tab stop. That is the selected radio, or the first row when nothing is selected yet."
+      }
+    ],
+    "composedFrom": [
+      {
+        "name": "RadioGroup",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-radiogroup--docs"
+      }
+    ],
+    "tokens": []
+  },
   {
     "tag": "kai-reasoning",
     "className": "KaiReasoningElement",
@@ -6814,6 +7768,22 @@
         "description": "Button size token. Defaults to `'icon'` (square).",
         "default": "'icon'",
         "displayType": "undefined | \"sm\" | \"md\" | \"lg\" | \"icon\" | \"icon-sm\""
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "The button's accessible name. It is announced whether or not the label is visible, so the text is always localisable. Defaults to `'Scroll to bottom'`.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "showLabel",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Also render `label` visibly beside the icon. Defaults to `false`, which is the icon-only button. When the text is visible it IS the accessible name, so nothing gets announced twice.",
+        "displayType": "undefined | false | true"
       }
     ],
     "events": [
@@ -7048,9 +8018,9 @@
     ]
   },
   {
-    "tag": "kai-separator",
-    "className": "KaiSeparatorElement",
-    "displayName": "Separator",
+    "tag": "kai-select",
+    "className": "KaiSelectElement",
+    "displayName": "Select",
     "props": [
       {
         "name": "theme",
@@ -7063,71 +8033,188 @@
         "displayType": "\"light\" | \"dark\" | \"auto\""
       },
       {
-        "name": "orientation",
-        "type": "undefined | \"horizontal\" | \"vertical\"",
-        "optional": true,
-        "scalar": true,
-        "description": "`horizontal` (default, block + full-width) or `vertical` (a rule inside a flex/grid row, stretching to the row height).",
-        "default": "'horizontal'",
-        "displayType": "undefined | \"horizontal\" | \"vertical\""
-      }
-    ],
-    "events": [],
-    "methods": [],
-    "composedFrom": [
-      {
-        "name": "Separator",
-        "group": "UI",
-        "storyId": "solid-advanced-primitives-separator--docs"
-      }
-    ],
-    "tokens": [],
-    "parts": [
-      {
-        "name": "separator",
-        "doc": "The divider line. Restyle its color, thickness, or inset from outside.",
-        "recipe": "kai-separator::part(separator) { background: var(--color-border) }"
-      }
-    ]
-  },
-  {
-    "tag": "kai-setting-item",
-    "className": "KaiSettingItemElement",
-    "displayName": "SettingItem",
-    "props": [
-      {
-        "name": "theme",
-        "type": "\"light\" | \"dark\" | \"auto\"",
-        "optional": true,
-        "scalar": true,
-        "description": "Color mode (`auto` follows prefers-color-scheme).",
-        "default": "'auto'",
-        "universal": true,
-        "displayType": "\"light\" | \"dark\" | \"auto\""
+        "name": "options",
+        "type": "{ value: string; label?: undefined | string; disabled?: undefined | false | true }[]",
+        "optional": false,
+        "scalar": false,
+        "description": "The choices, in display order. Set as a JS PROPERTY (array), never an attribute. Rendered in full: the kit never truncates, re-orders or de-duplicates them.",
+        "typeName": "KaiSelectOption[]",
+        "typeShape": "{ value: string; label?: undefined | string; disabled?: undefined | false | true }[]",
+        "default": "[]",
+        "typeImport": "KaiSelectOption",
+        "displayType": "{ value: string; label?: undefined | string; disabled?: undefined | false | true }[]"
       },
       {
-        "name": "label",
+        "name": "value",
         "type": "undefined | string",
         "optional": true,
         "scalar": true,
-        "description": "Row label (primary text). Attribute: `label`.",
-        "default": "''",
+        "description": "Controlled selected value. Settable and reflected to the `value` attribute. `el.value = 'high'` drives it; choosing an option updates it and fires `kai-change`. Read `el.value` for live state; for a `multiple` select read `el.values` instead.",
         "displayType": "undefined | string"
       },
       {
-        "name": "description",
+        "name": "placeholder",
         "type": "undefined | string",
         "optional": true,
         "scalar": true,
-        "description": "Optional secondary description under the label. Attribute: `description`.",
+        "description": "Text for a leading, disabled, empty option: the \"nothing chosen yet\" row. Omitted means no such row at all; there is no default wording, because inventing one would put words in your UI.",
         "displayType": "undefined | string"
-      }
-    ],
-    "events": [],
-    "methods": [],
-    "composedFrom": [
+      },
       {
-        "name": "SettingItem",
+        "name": "multiple",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Allow more than one selection. Turns the control into the platform's list box, so the kit's chevron is not drawn.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "invalid",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Force the invalid (destructive-border) state.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "disabled",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Disable interaction.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "required",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Set the native `required` attribute, and nothing more. Whether an empty select is an error is the application's rule, not the kit's.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Accessible label for the control.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "name",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Form-control name, for a native form submit.",
+        "displayType": "undefined | string"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-change",
+        "detail": "{ value: string; values: string[] }",
+        "description": "A choice was made. `value` is the first selected option (empty when nothing is selected); `values` is every selected option, which is what a `multiple` select needs. Both are always present, so neither shape silently loses the other.",
+        "displayDetail": "{ value: string; values: string[] }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "focus",
+        "params": "options?: FocusOptions",
+        "returns": "void",
+        "description": "Focus the inner select (the host element can't reach it)."
+      }
+    ],
+    "composedFrom": [
+      {
+        "name": "Select",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-select--docs"
+      }
+    ],
+    "tokens": []
+  },
+  {
+    "tag": "kai-separator",
+    "className": "KaiSeparatorElement",
+    "displayName": "Separator",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "orientation",
+        "type": "undefined | \"horizontal\" | \"vertical\"",
+        "optional": true,
+        "scalar": true,
+        "description": "`horizontal` (default, block + full-width) or `vertical` (a rule inside a flex/grid row, stretching to the row height).",
+        "default": "'horizontal'",
+        "displayType": "undefined | \"horizontal\" | \"vertical\""
+      }
+    ],
+    "events": [],
+    "methods": [],
+    "composedFrom": [
+      {
+        "name": "Separator",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-separator--docs"
+      }
+    ],
+    "tokens": [],
+    "parts": [
+      {
+        "name": "separator",
+        "doc": "The divider line. Restyle its color, thickness, or inset from outside.",
+        "recipe": "kai-separator::part(separator) { background: var(--color-border) }"
+      }
+    ]
+  },
+  {
+    "tag": "kai-setting-item",
+    "className": "KaiSettingItemElement",
+    "displayName": "SettingItem",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Row label (primary text). Attribute: `label`.",
+        "default": "''",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "description",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Optional secondary description under the label. Attribute: `description`.",
+        "displayType": "undefined | string"
+      }
+    ],
+    "events": [],
+    "methods": [],
+    "composedFrom": [
+      {
+        "name": "SettingItem",
         "group": "UI",
         "storyId": "solid-advanced-primitives-settingitem--docs"
       }
@@ -7332,6 +8419,117 @@
       }
     ]
   },
+  {
+    "tag": "kai-slider",
+    "className": "KaiSliderElement",
+    "displayName": "Slider",
+    "props": [
+      {
+        "name": "theme",
+        "type": "\"light\" | \"dark\" | \"auto\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Color mode (`auto` follows prefers-color-scheme).",
+        "default": "'auto'",
+        "universal": true,
+        "displayType": "\"light\" | \"dark\" | \"auto\""
+      },
+      {
+        "name": "min",
+        "type": "undefined | number",
+        "optional": true,
+        "scalar": true,
+        "description": "Lowest selectable value. Required: a range with no bounds is a guess, and the guess belongs to whoever knows what the number means.",
+        "displayType": "undefined | number"
+      },
+      {
+        "name": "max",
+        "type": "undefined | number",
+        "optional": true,
+        "scalar": true,
+        "description": "Highest selectable value. Required, for the same reason as `min`.",
+        "displayType": "undefined | number"
+      },
+      {
+        "name": "step",
+        "type": "undefined | number | \"any\"",
+        "optional": true,
+        "scalar": true,
+        "description": "Granularity. Omitted means the native default of 1; `any` means continuous.",
+        "displayType": "undefined | number | \"any\""
+      },
+      {
+        "name": "value",
+        "type": "undefined | number",
+        "optional": true,
+        "scalar": true,
+        "description": "Controlled value. Settable and reflected to the `value` attribute. `el.value = 40` drives it; dragging updates it and fires `kai-input` per step, `kai-change` on release. Read `el.value` for live state.",
+        "displayType": "undefined | number"
+      },
+      {
+        "name": "disabled",
+        "type": "undefined | false | true",
+        "optional": true,
+        "scalar": true,
+        "description": "Disable interaction.",
+        "displayType": "undefined | false | true"
+      },
+      {
+        "name": "label",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Accessible label for the slider.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "name",
+        "type": "undefined | string",
+        "optional": true,
+        "scalar": true,
+        "description": "Form-control name, for a native form submit.",
+        "displayType": "undefined | string"
+      },
+      {
+        "name": "valueLabel",
+        "type": "undefined | false | true | ((value: number) => string)",
+        "optional": true,
+        "scalar": false,
+        "description": "Show the current value beside the track. Off by default. Two ways in, because one of them is not a scalar. As a bare ATTRIBUTE (`<kai-slider value-label>`) it renders the raw number. As a JS PROPERTY it also accepts a formatter function (`el.valueLabel = (v) => v + '%'`), for a slider that is not counting bare numbers. A function cannot survive an attribute, so that half is property-only. The readout is hidden from assistive tech: the slider already reports the same number, and an exposed copy would be announced twice.",
+        "displayType": "undefined | false | true | ((value: number) => string)"
+      }
+    ],
+    "events": [
+      {
+        "name": "kai-change",
+        "detail": "{ value: number }",
+        "description": "The value was committed: pointer released, or a key press finished.",
+        "displayDetail": "{ value: number }"
+      },
+      {
+        "name": "kai-input",
+        "detail": "{ value: number }",
+        "description": "The thumb moved. Fires per step during a drag or a key press.",
+        "displayDetail": "{ value: number }"
+      }
+    ],
+    "methods": [
+      {
+        "name": "focus",
+        "params": "options?: FocusOptions",
+        "returns": "void",
+        "description": "Focus the inner range input (the host element can't reach it)."
+      }
+    ],
+    "composedFrom": [
+      {
+        "name": "Slider",
+        "group": "UI",
+        "storyId": "solid-advanced-primitives-slider--docs"
+      }
+    ],
+    "tokens": []
+  },
   {
     "tag": "kai-source",
     "className": "KaiSourceElement",
@@ -8298,7 +9496,7 @@
         "type": "undefined | { id: string; message: string; variant?: undefined | \"neutral\" | \"success\" | \"warning\" | \"error\" | \"info\"; appearance?: undefined | \"pill\" | \"card\"; inverse?: undefined | false | true; description?: undefined | string; action?: undefined | { label: string; onAction: () => void | false }; duration?: undefined | number; dismissible?: undefined | false | true; target?: undefined | HTMLElement }[]",
         "optional": true,
         "scalar": false,
-        "description": "The toasts to render. Newest is shown on top. Set as a JS property (array); pass a new array reference to update. Omit for an empty region, which is the normal resting state and how the imperative `toast()` API starts.",
+        "description": "The toasts to render. Newest is shown on top. Set as a JS property (array); pass a new array reference to update. Omit for an empty region, which is the normal resting state and how the imperative `toast()` API starts. Note the handover: the first `toast()` call ADOPTS a region you placed in markup (no second region mounts) and binds the imperative store to this property, replacing any array you set. Drive a region as data OR via `toast()`, not both at once.",
         "typeName": "ToastItem[]",
         "typeShape": "{ id: string; message: string; variant?: undefined | \"neutral\" | \"success\" | \"warning\" | \"error\" | \"info\"; appearance?: undefined | \"pill\" | \"card\"; inverse?: undefined | false | true; description?: undefined | string; action?: undefined | { label: string; onAction: () => void | false }; duration?: undefined | number; dismissible?: undefined | false | true; target?: undefined | HTMLElement }[]",
         "default": "[]",
@@ -8610,11 +9808,11 @@
       },
       {
         "name": "transcribe",
-        "type": "undefined | (audio: Blob) => Promise<string>",
+        "type": "undefined | ((audio: Blob) => Promise<string>)",
         "optional": true,
         "scalar": false,
         "description": "Transcriber the host supplies: records audio, returns the text. This is a **function-valued property** (`el.transcribe = async blob => '...'`) because a value-returning callback can't be modelled as a fire-and-forget event.",
-        "displayType": "undefined | (audio: Blob) => Promise<string>"
+        "displayType": "undefined | ((audio: Blob) => Promise<string>)"
       },
       {
         "name": "disabled",
@@ -8667,6 +9865,12 @@
         "detail": "{ text: string }",
         "description": "Final transcript: the `transcribe` property resolved, OR native `SpeechRecognition` produced final text (no `transcribe` set).",
         "displayDetail": "{ text: string }"
+      },
+      {
+        "name": "kai-voice-error",
+        "detail": "{ source: \"recognition\"; error: string; message: string }",
+        "description": "A voice session failed, so no failure is ever silent. `detail.source` names the failing side (`recognition` on `<kai-voice-input>`, `synthesis` on `<kai-voice-output>`), `detail.error` carries the platform error code, the thrown exception's name, or `no-result` when recognition ended with no error and no text (the user said nothing), and `detail.message` is human-readable. Deliberate cancellation does not fire.",
+        "displayDetail": "{ source: \"recognition\"; error: string; message: string }"
       }
     ],
     "methods": [
@@ -8727,11 +9931,11 @@
       },
       {
         "name": "synthesize",
-        "type": "undefined | (text: string) => Promise<Blob>",
+        "type": "undefined | ((text: string) => Promise<Blob>)",
         "optional": true,
         "scalar": false,
         "description": "TTS model seam the host supplies: given text, returns an audio `Blob` to play. This is a **function-valued property** (`el.synthesize = async text => blob`); when set, the native `speechSynthesis` path is bypassed. Mirrors `<kai-voice-input>`'s `transcribe`. A value-returning callback can't be modelled as a fire-and-forget event, hence a property.",
-        "displayType": "undefined | (text: string) => Promise<Blob>"
+        "displayType": "undefined | ((text: string) => Promise<Blob>)"
       },
       {
         "name": "disabled",
@@ -8747,7 +9951,7 @@
       {
         "name": "kai-speaking-change",
         "detail": "{ speaking: false | true }",
-        "description": "Playback started or stopped. Drive your own UI in sync. Fires on real transitions only (manual click and programmatic speak()/stop()), never on mount.",
+        "description": "Playback started or stopped. Drive your own UI in sync. `speaking: true` fires when audio actually starts (utterance.onstart natively; audio playback beginning on the `synthesize` path), not when speak() is called; earlier releases fired it optimistically inside speak() itself. Fires on real transitions only (manual click and programmatic speak()/stop()), never on mount.",
         "displayDetail": "{ speaking: false | true }"
       },
       {
@@ -8755,6 +9959,12 @@
         "detail": "{ blob: Blob }",
         "description": "The model path (`synthesize`) resolved audio: the raw `Blob` before playback.",
         "displayDetail": "{ blob: Blob }"
+      },
+      {
+        "name": "kai-voice-error",
+        "detail": "{ source: \"synthesis\"; error: string; message: string }",
+        "description": "A voice session failed, so no failure is ever silent. `detail.source` names the failing side (`recognition` on `<kai-voice-input>`, `synthesis` on `<kai-voice-output>`), `detail.error` carries the platform error code, the thrown exception's name, or `no-result` when recognition ended with no error and no text (the user said nothing), and `detail.message` is human-readable. Deliberate cancellation does not fire.",
+        "displayDetail": "{ source: \"synthesis\"; error: string; message: string }"
       }
     ],
     "methods": [
@@ -8815,252 +10025,51 @@
         "displayType": "\"light\" | \"dark\" | \"auto\""
       },
       {
-        "name": "groups",
-        "type": "undefined | { id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]",
+        "name": "startCollapsed",
+        "type": "undefined | false | true",
         "optional": true,
-        "scalar": false,
-        "description": "The sidebar's section headers, rendered in array order. A group carries no conversations of its own; it is matched against `conversations` by id, so the two props are complementary rather than alternatives. Omit for an ungrouped sidebar. Set as a JS property.",
-        "typeName": "ConversationGroup[]",
-        "typeShape": "{ id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]",
-        "default": "[]",
-        "typeImport": "ConversationGroup",
-        "displayType": "undefined | { id: string; userId?: undefined | string; teamId?: undefined | string; name: string; sortOrder: number; createdAt: string }[]"
+        "scalar": true,
+        "description": "Controlled collapsed state of the start aside. Set this as a JS property (`el.startCollapsed = true`) to drive the aside from your app, updating it in response to the `kai-aside-toggle` event. Omit for uncontrolled (the element manages it).",
+        "displayType": "undefined | false | true"
       },
       {
-        "name": "conversations",
-        "type": "undefined | { id: string; title: string; groupId?: undefined | string; scope: { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt: string; updatedAt: string; trailing?: undefined | string }[]",
+        "name": "defaultStartCollapsed",
+        "type": "undefined | false | true",
         "optional": true,
-        "scalar": false,
-        "description": "Every conversation in the sidebar, flat. Each one is filed under the group whose `id` equals its `groupId`; one with no `groupId`, or with a `groupId` matching no entry in `groups`, falls into a trailing ungrouped section (headerless when `compact`), so nothing you pass in is ever dropped. There is no recency bucketing. Set as a JS property. Omit for an empty sidebar, or when `no-conversations` replaces the built-in list with your own `sidebar-header` content.",
-        "typeName": "ConversationSummary[]",
-        "typeShape": "{ id: string; title: string; groupId?: undefined | string; scope: { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt: string; updatedAt: string; trailing?: undefined | string }[]",
-        "default": "[]",
-        "typeImport": "ConversationSummary",
-        "displayType": "undefined | { id: string; title: string; groupId?: undefined | string; scope: { type: \"document\" | \"collection\"; documentId?: undefined | string; filters?: undefined | { tags?: undefined | string[]; authors?: undefined | string[]; contentType?: undefined | \"transcript\" | \"markdown\"; dateRange?: undefined | { from: string; to: string } } }; messageCount: number; lastMessageAt: string; updatedAt: string; trailing?: undefined | string }[]"
+        "scalar": true,
+        "description": "Initial collapsed state of the start aside when uncontrolled (default false). Use the `default-start-collapsed` attribute to start collapsed in plain HTML.",
+        "displayType": "undefined | false | true"
       },
       {
-        "name": "activeId",
-        "type": "undefined | string",
+        "name": "endCollapsed",
+        "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "Id of the open conversation, highlighted in the sidebar.",
-        "displayType": "undefined | string"
-      },
-      {
-        "name": "messages",
-        "type": "undefined | { id: string; role: \"user\" | \"assistant\"; parts: ({ type: \"text\"; text: string; raw?: undefined | { source: string; payload: unknown } } | { type: \"reasoning\"; text: string; label?: undefined | string; index?: undefined | number; streamId?: undefined | string; signature?: undefined | string; raw?: undefined | { source: string; payload: unknown } } | { type: \"tool\"; tool: { type: string; kind?: undefined | \"command\" | \"file-change\" | \"search\" | \"fetch\" | \"mcp\" | \"image\" | \"generic\"; state: \"input-streaming\" | \"input-available\" | \"output-available\" | \"output-error\"; input?: undefined | Record<string, unknown>; rawInput?: undefined | string; output?: undefined | Record<string, unknown>; toolCallId?: undefined | string; errorText?: undefined | string; raw?: undefined | { source: string; payload: unknown } }; raw?: undefined | { source: string; payload: unknown } } | { type: \"card\"; envelope: { type: string; id: string; data: unknown; title?: undefined | string; resolution?: undefined | { kind: \"action\"; action: string; payload?: unknown; at?: undefined | string } | { kind: \"submit\"; data: unknown; at?: undefined | string } | { kind: \"dismissed\"; at?: undefined | string } | { kind: \"expired\"; reason?: undefined | string; at?: undefined | string } }; raw?: undefined | { source: string; payload: unknown } } | { type: \"source\"; source: { id?: undefined | string; url?: undefined | string; title?: undefined | string; snippet?: undefined | string; index?: undefined | number }; raw?: undefined | { source: string; payload: unknown } } | { type: \"file\"; attachment: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }; raw?: undefined | { source: string; payload: unknown } })[]; actions?: undefined | (\"copy\" | \"like\" | \"dislike\" | \"regenerate\" | \"edit\" | { id: string; label: string; icon?: undefined | string; tooltip?: undefined | string })[]; avatar?: undefined | { src?: undefined | string; fallback?: undefined | string; alt?: undefined | string }; feedback?: undefined | \"like\" | \"dislike\" }[]",
-        "optional": true,
-        "scalar": false,
-        "description": "The active conversation's message thread, newest last. Set as a JS property (`el.messages = [...]`); a NEW array reference per streaming chunk re-renders (mutating in place does not). Omit for an empty thread.",
-        "typeName": "ChatMessage[]",
-        "typeShape": "{ id: string; role: \"user\" | \"assistant\"; parts: ({ type: \"text\"; text: string; raw?: undefined | { source: string; payload: unknown } } | { type: \"reasoning\"; text: string; label?: undefined | string; index?: undefined | number; streamId?: undefined | string; signature?: undefined | string; raw?: undefined | { source: string; payload: unknown } } | { type: \"tool\"; tool: { type: string; kind?: undefined | \"command\" | \"file-change\" | \"search\" | \"fetch\" | \"mcp\" | \"image\" | \"generic\"; state: \"input-streaming\" | \"input-available\" | \"output-available\" | \"output-error\"; input?: undefined | Record<string, unknown>; rawInput?: undefined | string; output?: undefined | Record<string, unknown>; toolCallId?: undefined | string; errorText?: undefined | string; raw?: undefined | { source: string; payload: unknown } }; raw?: undefined | { source: string; payload: unknown } } | { type: \"card\"; envelope: { type: string; id: string; data: unknown; title?: undefined | string; resolution?: undefined | { kind: \"action\"; action: string; payload?: unknown; at?: undefined | string } | { kind: \"submit\"; data: unknown; at?: undefined | string } | { kind: \"dismissed\"; at?: undefined | string } | { kind: \"expired\"; reason?: undefined | string; at?: undefined | string } }; raw?: undefined | { source: string; payload: unknown } } | { type: \"source\"; source: { id?: undefined | string; url?: undefined | string; title?: undefined | string; snippet?: undefined | string; index?: undefined | number }; raw?: undefined | { source: string; payload: unknown } } | { type: \"file\"; attachment: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }; raw?: undefined | { source: string; payload: unknown } })[]; actions?: undefined | (\"copy\" | \"like\" | \"dislike\" | \"regenerate\" | \"edit\" | { id: string; label: string; icon?: undefined | string; tooltip?: undefined | string })[]; avatar?: undefined | { src?: undefined | string; fallback?: undefined | string; alt?: undefined | string }; feedback?: undefined | \"like\" | \"dislike\" }[]",
-        "default": "[]",
-        "typeImport": "ChatMessage",
-        "displayType": "undefined | { id: string; role: \"user\" | \"assistant\"; parts: ({ type: \"text\"; text: string; raw?: undefined | { source: string; payload: unknown } } | { type: \"reasoning\"; text: string; label?: undefined | string; index?: undefined | number; streamId?: undefined | string; signature?: undefined | string; raw?: undefined | { source: string; payload: unknown } } | { type: \"tool\"; tool: { type: string; kind?: undefined | \"command\" | \"file-change\" | \"search\" | \"fetch\" | \"mcp\" | \"image\" | \"generic\"; state: \"input-streaming\" | \"input-available\" | \"output-available\" | \"output-error\"; input?: undefined | Record<string, unknown>; rawInput?: undefined | string; output?: undefined | Record<string, unknown>; toolCallId?: undefined | string; errorText?: undefined | string; raw?: undefined | { source: string; payload: unknown } }; raw?: undefined | { source: string; payload: unknown } } | { type: \"card\"; envelope: { type: string; id: string; data: unknown; title?: undefined | string; resolution?: undefined | { kind: \"action\"; action: string; payload?: unknown; at?: undefined | string } | { kind: \"submit\"; data: unknown; at?: undefined | string } | { kind: \"dismissed\"; at?: undefined | string } | { kind: \"expired\"; reason?: undefined | string; at?: undefined | string } }; raw?: undefined | { source: string; payload: unknown } } | { type: \"source\"; source: { id?: undefined | string; url?: undefined | string; title?: undefined | string; snippet?: undefined | string; index?: undefined | number }; raw?: undefined | { source: string; payload: unknown } } | { type: \"file\"; attachment: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }; raw?: undefined | { source: string; payload: unknown } })[]; actions?: undefined | (\"copy\" | \"like\" | \"dislike\" | \"regenerate\" | \"edit\" | { id: string; label: string; icon?: undefined | string; tooltip?: undefined | string })[]; avatar?: undefined | { src?: undefined | string; fallback?: undefined | string; alt?: undefined | string }; feedback?: undefined | \"like\" | \"dislike\" }[]"
-      },
-      {
-        "name": "value",
-        "type": "undefined | string",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "displayType": "undefined | string"
-      },
-      {
-        "name": "placeholder",
-        "type": "undefined | string",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "'Send a message...'",
-        "displayType": "undefined | string"
-      },
-      {
-        "name": "loading",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "false",
+        "description": "Controlled collapsed state of the end aside. Set this as a JS property (`el.endCollapsed = true`) to drive the aside from your app, updating it in response to the `kai-aside-toggle` event. Omit for uncontrolled (the element manages it).",
         "displayType": "undefined | false | true"
       },
       {
-        "name": "suggestions",
-        "type": "undefined | string[]",
-        "optional": true,
-        "scalar": false,
-        "description": "",
-        "displayType": "undefined | string[]"
-      },
-      {
-        "name": "suggestionMode",
-        "type": "undefined | \"submit\" | \"fill\"",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "'submit'",
-        "displayType": "undefined | \"submit\" | \"fill\""
-      },
-      {
-        "name": "proseSize",
-        "type": "undefined | \"xs\" | \"sm\" | \"base\" | \"lg\"",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "'sm'",
-        "displayType": "undefined | \"xs\" | \"sm\" | \"base\" | \"lg\""
-      },
-      {
-        "name": "codeTheme",
-        "type": "undefined | string",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "'github-dark-dimmed'",
-        "displayType": "undefined | string"
-      },
-      {
-        "name": "codeHighlight",
+        "name": "defaultEndCollapsed",
         "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "",
-        "default": "true",
+        "description": "Initial collapsed state of the end aside when uncontrolled (default false). Use the `default-end-collapsed` attribute to start collapsed in plain HTML.",
         "displayType": "undefined | false | true"
       },
       {
-        "name": "chatTitle",
-        "type": "undefined | string",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "displayType": "undefined | string"
-      },
-      {
-        "name": "models",
-        "type": "undefined | { id: string; name: string; provider?: undefined | string; description?: undefined | string; group?: undefined | string }[]",
-        "optional": true,
-        "scalar": false,
-        "description": "",
-        "typeName": "ModelOption[]",
-        "typeShape": "{ id: string; name: string; provider?: undefined | string; description?: undefined | string; group?: undefined | string }[]",
-        "typeImport": "ModelOption",
-        "displayType": "undefined | { id: string; name: string; provider?: undefined | string; description?: undefined | string; group?: undefined | string }[]"
-      },
-      {
-        "name": "currentModel",
-        "type": "undefined | string",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "displayType": "undefined | string"
-      },
-      {
-        "name": "context",
-        "type": "undefined | { usedTokens: number; maxTokens: number; inputTokens?: undefined | number; outputTokens?: undefined | number; estimatedCost?: undefined | number }",
-        "optional": true,
-        "scalar": false,
-        "description": "",
-        "typeName": "ChatThreadContextUsage",
-        "typeShape": "{ usedTokens: number; maxTokens: number; inputTokens?: undefined | number; outputTokens?: undefined | number; estimatedCost?: undefined | number }",
-        "typeImport": "ChatThreadContextUsage",
-        "displayType": "ContextData | undefined"
-      },
-      {
-        "name": "scrollButton",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "true",
-        "displayType": "undefined | false | true"
-      },
-      {
-        "name": "search",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "false",
-        "displayType": "undefined | false | true"
-      },
-      {
-        "name": "voice",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "",
-        "default": "false",
-        "displayType": "undefined | false | true"
-      },
-      {
-        "name": "triggers",
-        "type": "undefined | { char: string; kind: string; items?: undefined | { id: string; label: string; icon?: undefined | string; description?: undefined | string; group?: undefined | string; kind?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> }[] }[]",
-        "optional": true,
-        "scalar": false,
-        "description": "Rich entity triggers (`/` skills, `@` agents/plugins) forwarded to the input.",
-        "typeName": "TriggerDef[]",
-        "typeShape": "{ char: string; kind: string; items?: undefined | { id: string; label: string; icon?: undefined | string; description?: undefined | string; group?: undefined | string; kind?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> }[] }[]",
-        "typeImport": "TriggerDef",
-        "displayType": "undefined | { char: string; kind: string; items?: undefined | { id: string; label: string; icon?: undefined | string; description?: undefined | string; group?: undefined | string; kind?: undefined | string; promptText?: undefined | string; data?: undefined | Record<string, unknown> }[] }[]"
-      },
-      {
-        "name": "kindIcons",
-        "type": "undefined | Record<string, string>",
-        "optional": true,
-        "scalar": false,
-        "description": "Default icon per entity kind (kind → image src) forwarded to the input.",
-        "displayType": "undefined | Record<string, string>"
-      },
-      {
-        "name": "sidebarWidth",
-        "type": "undefined | number",
-        "optional": true,
-        "scalar": true,
-        "description": "Sidebar default width as a percent of the workspace (default 26).",
-        "default": "26",
-        "displayType": "undefined | number"
-      },
-      {
-        "name": "sidebarMinWidth",
-        "type": "undefined | number",
-        "optional": true,
-        "scalar": true,
-        "description": "Sidebar min width in px (default 240).",
-        "default": "240",
-        "displayType": "undefined | number"
-      },
-      {
-        "name": "sidebarMaxWidth",
+        "name": "collapseBelow",
         "type": "undefined | number",
         "optional": true,
         "scalar": true,
-        "description": "Sidebar max width in px (default 420).",
-        "default": "420",
+        "description": "Auto-collapse both asides when the shell's own width drops below this many px, and re-expand when it grows back above. Applies to uncontrolled asides only (it never fights an app-driven collapsed prop); omit to disable. Fires `kai-aside-toggle`. Attribute: `collapse-below`.",
         "displayType": "undefined | number"
       },
       {
-        "name": "sidebarCollapsed",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "Controlled collapsed state. Set this as a JS property (`el.sidebarCollapsed = true`) to drive the sidebar from your app, updating it in response to the `kai-sidebar-toggle` event. Omit for uncontrolled (the element manages it).",
-        "displayType": "undefined | false | true"
-      },
-      {
-        "name": "defaultSidebarCollapsed",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "Initial collapsed state when uncontrolled (default false). Use the `default-sidebar-collapsed` attribute to start collapsed in plain HTML.",
-        "displayType": "undefined | false | true"
-      },
-      {
-        "name": "collapseBelow",
+        "name": "drawerBelow",
         "type": "undefined | number",
         "optional": true,
         "scalar": true,
-        "description": "Auto-collapse the rail when the workspace's own width drops below this many px, and re-expand when it grows back above. Uncontrolled only (it never fights an app-driven `sidebarCollapsed`); omit to disable. Fires `kai-sidebar-toggle`. Attribute: `collapse-below`.",
+        "description": "Below this shell width in px, an expanded aside renders as an overlay drawer over the main region instead of a column beside it. Escape inside the drawer closes it and returns focus to the element focused before it opened. Omit to disable. Attribute: `drawer-below`.",
         "displayType": "undefined | number"
       },
       {
@@ -9068,200 +10077,114 @@
         "type": "undefined | false | true",
         "optional": true,
         "scalar": true,
-        "description": "Render Recents as dense single-line rows (a leading dot + title, no count).",
+        "description": "Density hint. Reflected as a `data-compact` hook on the root (and as the `compact` attribute on the element) for your CSS and slotted content; the shell itself keeps no other opinion about density.",
         "displayType": "undefined | false | true"
-      },
-      {
-        "name": "noConversations",
-        "type": "undefined | false | true",
-        "optional": true,
-        "scalar": true,
-        "description": "Suppress the built-in ConversationList so the `sidebar-header` slot owns the whole rail flex region (for apps that supply their own rail nav). Default false. Attribute: `no-conversations`.",
-        "displayType": "undefined | false | true"
-      },
-      {
-        "name": "cardTypes",
-        "type": "undefined | Record<string, string>",
-        "optional": true,
-        "scalar": false,
-        "description": "Optional card type -> custom-element tag overrides/additions for `card` parts (merged over the built-ins). Property: `el.cardTypes`. Typed as a plain string map (not the `CardTagMap` alias) so the generated React wrapper inlines it instead of emitting an unresolved named type.",
-        "displayType": "undefined | Record<string, string>"
-      },
-      {
-        "name": "cardSchemas",
-        "type": "undefined | Record<string, object>",
-        "optional": true,
-        "scalar": false,
-        "description": "JSON Schemas for the card types this app renders, keyed by envelope type. The companion of `cardTypes`, which says what DRAWS a card while this says what a VALID one looks like. An OBJECT, so it is a JS property only: `el.cardSchemas = { 'pricing-table': pricingSchema }`, never an attribute. `createCardRegistry(...).validationSchemas` is exactly this shape. Without it the kit validates its own seven built-ins and leaves your own card type, the one your app actually cares about, as the only unchecked thing on screen. A schema here WINS over a built-in of the same name. Typed `Record<string, object>` rather than `Record<string, JsonSchema>` deliberately: an imported `.json` schema widens `\"type\"` to `string`, and an authored one carries `$schema`/`title`/`description`/`additionalProperties`, so the tighter type would reject both of the normal ways to supply one.",
-        "displayType": "undefined | Record<string, object>"
       }
     ],
     "events": [
       {
-        "name": "kai-conversation-select",
-        "detail": "{ id: string }",
-        "description": "A conversation was selected in the sidebar.",
-        "displayDetail": "{ id: string }"
-      },
-      {
-        "name": "kai-message-action",
-        "detail": "{ messageId: string; action: string; state?: undefined | \"on\" | \"off\" }",
-        "description": "An action button on a message was clicked. `state` is present only for the toggleable feedback votes: `'on'` when a like/dislike is set, `'off'` when re-tapped to clear.",
-        "displayDetail": "{ messageId: string; action: string; state?: undefined | \"on\" | \"off\" }"
-      },
-      {
-        "name": "kai-model-change",
-        "detail": "{ modelId: string }",
-        "description": "The header model switcher changed.",
-        "displayDetail": "{ modelId: string }"
-      },
-      {
-        "name": "kai-new-chat",
-        "detail": "Record<string, never>",
-        "description": "The \"New chat\" button was clicked.",
-        "displayDetail": "Record<string, never>"
-      },
-      {
-        "name": "kai-search",
-        "detail": "Record<string, never>",
-        "description": "The Search button was clicked.",
-        "displayDetail": "Record<string, never>"
-      },
-      {
-        "name": "kai-sidebar-toggle",
-        "detail": "{ collapsed: false | true }",
-        "description": "The sidebar was collapsed or expanded.",
-        "displayDetail": "{ collapsed: false | true }"
-      },
-      {
-        "name": "kai-submit",
-        "detail": "{ value: string; attachments: { id: string; type: \"file\" | \"source-document\"; filename?: undefined | string; mediaType?: undefined | string; url?: undefined | string; title?: undefined | string }[] }",
-        "description": "User submitted a message.",
-        "displayDetail": "{ value: string; attachments: AttachmentData[] }"
-      },
-      {
-        "name": "kai-suggestion-click",
-        "detail": "{ value: string }",
-        "description": "A suggestion chip was clicked (only in `suggestion-mode=\"fill\"`).",
-        "displayDetail": "{ value: string }"
-      },
-      {
-        "name": "kai-value-change",
-        "detail": "{ value: string }",
-        "description": "Fired on every input change.",
-        "displayDetail": "{ value: string }"
+        "name": "kai-aside-resize",
+        "detail": "{ side: \"start\" | \"end\"; width: number }",
+        "description": "The aside was resized (fires per drag step, keyboard nudge, or a handle double-click reset), width in px.",
+        "displayDetail": "{ side: \"start\" | \"end\"; width: number }"
       },
       {
-        "name": "kai-voice",
-        "detail": "Record<string, never>",
-        "description": "The Mic / voice button was clicked.",
-        "displayDetail": "Record<string, never>"
+        "name": "kai-aside-toggle",
+        "detail": "{ side: \"start\" | \"end\"; collapsed: false | true }",
+        "description": "An aside collapsed or expanded (a method, the breakpoint, the drawer's Escape).",
+        "displayDetail": "{ side: \"start\" | \"end\"; collapsed: false | true }"
       }
     ],
     "methods": [
       {
-        "name": "toggleSidebar",
-        "params": "",
+        "name": "toggleAside",
+        "params": "side: WorkspaceAsideSide",
         "returns": "void",
-        "description": "Collapse/expand the conversation sidebar and fire `kai-sidebar-toggle`."
+        "description": "Collapse/expand one aside (fires `kai-aside-toggle`)."
       },
       {
-        "name": "collapseSidebar",
-        "params": "",
+        "name": "collapseAside",
+        "params": "side: WorkspaceAsideSide",
         "returns": "void",
-        "description": "Force the conversation sidebar collapsed (fires `kai-sidebar-toggle`)."
+        "description": "Force one aside collapsed (fires `kai-aside-toggle`)."
       },
       {
-        "name": "expandSidebar",
-        "params": "",
-        "returns": "void",
-        "description": "Force the conversation sidebar expanded (fires `kai-sidebar-toggle`)."
-      },
-      {
-        "name": "focus",
-        "params": "options?: FocusOptions",
-        "returns": "void",
-        "description": "Focus the thread's composer."
-      },
-      {
-        "name": "clear",
-        "params": "",
+        "name": "expandAside",
+        "params": "side: WorkspaceAsideSide",
         "returns": "void",
-        "description": "Clear the thread draft + staged attachments."
-      },
-      {
-        "name": "send",
-        "params": "",
-        "returns": "void",
-        "description": "Submit the current thread draft programmatically (fires `kai-submit`)."
-      },
-      {
-        "name": "scrollToBottom",
-        "params": "behavior?: ScrollBehavior",
-        "returns": "void",
-        "description": "Scroll the thread to the newest message."
+        "description": "Force one aside expanded (fires `kai-aside-toggle`)."
       }
     ],
     "composedFrom": [
       {
-        "name": "ChatThread",
+        "name": "WorkspaceShell",
         "group": "Components",
-        "storyId": "solid-advanced-elements-chatthread--docs"
+        "storyId": "solid-advanced-elements-workspaceshell--docs"
+      }
+    ],
+    "tokens": [],
+    "slots": [
+      {
+        "name": "",
+        "mode": "inject",
+        "doc": "The main region content (same region as the `main` slot): your `<kai-chat>`, or any app view."
       },
       {
-        "name": "ConversationList",
-        "group": "Components",
-        "storyId": "solid-advanced-elements-conversationlist--docs"
+        "name": "header",
+        "mode": "inject",
+        "part": true,
+        "doc": "The top band across the full shell width (app bar, tabs, breadcrumbs)."
       },
       {
-        "name": "CollapsedRail",
-        "group": "Components",
-        "storyId": "solid-advanced-elements-collapsedrail--docs"
+        "name": "start",
+        "mode": "inject",
+        "part": true,
+        "doc": "The inline-start aside column (a conversation rail, a nav, a file tree). Resizable and collapsible."
       },
       {
-        "name": "ResizablePanelGroup",
-        "group": "UI",
-        "storyId": "solid-advanced-primitives-resizablepanelgroup--docs"
+        "name": "main",
+        "mode": "inject",
+        "part": true,
+        "doc": "The main region. Unnamed children project here too, via the default slot."
       },
       {
-        "name": "ResizablePanel",
-        "group": "UI",
-        "storyId": "solid-advanced-primitives-resizablepanel--docs"
+        "name": "end",
+        "mode": "inject",
+        "part": true,
+        "doc": "The inline-end aside column (inspector, notes, preview). Resizable and collapsible."
       },
       {
-        "name": "ResizableHandle",
-        "group": "UI",
-        "storyId": "solid-advanced-primitives-resizablehandle--docs"
+        "name": "footer",
+        "mode": "inject",
+        "part": true,
+        "doc": "The bottom band across the full shell width (status bar, disclaimers)."
       }
     ],
-    "tokens": [],
-    "slots": [
+    "parts": [
       {
-        "name": "sidebar-header",
-        "mode": "inject",
-        "doc": "Top of the conversation rail (brand, a kai-tabs strip)."
+        "name": "aside",
+        "doc": "Both aside columns match this part (each also matches its own start/end part). Restyle the shared aside surface or border from outside; the --kai-workspace-start-* and --kai-workspace-end-* custom properties set the widths.",
+        "recipe": "kai-workspace::part(aside) { background: var(--color-card) }"
       },
       {
-        "name": "sidebar-footer",
-        "mode": "inject",
-        "doc": "Bottom of the rail: an upgrade card, a Design trigger, a user-menu cluster."
+        "name": "header",
+        "doc": "The top band across the full shell width (app bar, tabs, breadcrumbs)."
       },
       {
-        "name": "main-header",
-        "mode": "inject",
-        "doc": "Top of the main region (a top-placed banner or a corner action)."
+        "name": "start",
+        "doc": "The inline-start aside column (a conversation rail, a nav, a file tree). Resizable and collapsible."
       },
       {
         "name": "main",
-        "mode": "replace",
-        "doc": "Replace the built-in chat thread with your own main view (a home or dashboard screen). Omit to keep the thread."
-      }
-    ],
-    "parts": [
+        "doc": "The main region. Unnamed children project here too, via the default slot."
+      },
       {
-        "name": "sidebar",
-        "doc": "The conversation rail. Carries a subtle, theme-aware default background (bg-surface); override its background, border, or width from outside. `sidebar-min-width` sets its min px width and `collapse-below` auto-collapses it under a width.",
-        "recipe": "kai-workspace::part(sidebar) { background: var(--color-card); border-right: 1px solid var(--color-border) }"
+        "name": "end",
+        "doc": "The inline-end aside column (inspector, notes, preview). Resizable and collapsible."
+      },
+      {
+        "name": "footer",
+        "doc": "The bottom band across the full shell width (status bar, disclaimers)."
       }
     ]
   }