@alfadocs/ui-kit 0.1.8 → 0.1.10

package/dist/agent-catalog.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "packageVersion": "0.1.8",
+  "packageVersion": "0.1.9",
   "components": [
     {
       "kind": "component",
@@ -10,19 +10,226 @@
         "select_single",
         "select_multiple"
       ],
-      "state": [],
-      "actions": [],
+      "state": [
+        {
+          "name": "openItems",
+          "type": "string[]",
+          "description": "Ids (values) of currently-expanded items. Single-mode accordions return an array with 0 or 1 entries."
+        }
+      ],
+      "actions": [
+        {
+          "name": "expand",
+          "safety": "read",
+          "argsType": "{ itemId: string }",
+          "description": "Expand the item with the given value."
+        },
+        {
+          "name": "collapse",
+          "safety": "read",
+          "argsType": "{ itemId: string }",
+          "description": "Collapse the item with the given value."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Collapse all items. Only meaningful for multi-mode accordions; single-mode equivalent to collapsing the active item."
+        }
+      ],
       "domHooks": {
         "root": {
           "attr": "data-component",
           "value": "accordion"
         },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
         "item": {
           "attr": "data-item-id",
           "description": "Each Accordion.Item emits its value as data-item-id."
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "agenda-card",
+      "capabilities": [
+        "pick",
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "agenda-card",
+          "description": "Marks the element as a kit AgendaCard. The card root also emits data-component-id sourced from item.id and data-status with the appointment lifecycle."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable appointment identifier."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "agenda-tray",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; status: string }>",
+          "description": "Currently-displayed appointments. Ids + status only — never patient identity."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the appointment with the given id."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "agenda-tray",
+          "description": "Marks the AgendaTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
+        },
+        "item": {
+          "attr": "data-appointment-id",
+          "description": "Stable appointment id emitted on each rendered AgendaCard inside the tray."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "ai-prompt-input",
+      "capabilities": [
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current text in the composer (no PHI processing)."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the composer has no text and no attachments."
+        },
+        {
+          "name": "isSubmitting",
+          "type": "boolean",
+          "description": "True while an onSubmit invocation is in flight (best-effort)."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the composer text with the given value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear text and attachments. Irreversible from the same UI."
+        },
+        {
+          "name": "submit",
+          "safety": "write",
+          "description": "Submit the current composer state via onSubmit."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus into the textarea."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "ai-prompt-input",
+          "description": "Marks the AIPromptInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop; addresses a specific composer instance."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "audio-recorder",
+      "capabilities": [
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "isRecording",
+          "type": "boolean",
+          "description": "True while actively capturing audio (not paused)."
+        },
+        {
+          "name": "duration",
+          "type": "number",
+          "description": "Elapsed recording time in milliseconds (paused time excluded)."
+        },
+        {
+          "name": "hasRecording",
+          "type": "boolean",
+          "description": "True when a completed recording is available for submission."
+        }
+      ],
+      "actions": [
+        {
+          "name": "start_recording",
+          "safety": "write",
+          "description": "Request microphone permission and begin recording."
+        },
+        {
+          "name": "stop_recording",
+          "safety": "write",
+          "description": "Stop the current recording and finalise the blob."
+        },
+        {
+          "name": "discard",
+          "safety": "destructive",
+          "description": "Cancel the recording. Irreversible — the captured audio is dropped."
+        },
+        {
+          "name": "submit",
+          "safety": "write",
+          "description": "Stop the active recording, finalising it via onRecordingComplete."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "audio-recorder",
+          "description": "Marks the AudioRecorder wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "autocomplete",
@@ -32,19 +239,106 @@
         "open",
         "close"
       ],
-      "state": [],
-      "actions": [],
+      "state": [
+        {
+          "name": "value",
+          "type": "string | null",
+          "description": "Currently-selected option value, or null when nothing is committed."
+        },
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current free-text query in the input."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the suggestion list is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "read",
+          "argsType": "{ value: string | null }",
+          "description": "Set the committed value programmatically."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the input query, which filters the suggestion list."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Clear the value and the query."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the suggestion list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the suggestion list."
+        }
+      ],
       "domHooks": {
         "root": {
           "attr": "data-component",
           "value": "autocomplete"
         },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
         "item": {
           "attr": "data-option-id",
           "description": "Each suggestion emits its value as data-option-id."
         }
       }
     },
+    {
+      "kind": "component",
+      "id": "breadcrumb",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string, href?: string }>",
+          "description": "Ordered list of crumb ids + hrefs in display order. Labels are intentionally excluded — they may contain PHI."
+        }
+      ],
+      "actions": [
+        {
+          "name": "navigate_to",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the crumb with the given id — equivalent to clicking the link."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "breadcrumb",
+          "description": "Marks the Breadcrumb root `<nav>`."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-crumb-id",
+          "description": "Stable opaque id of a crumb. Labels are NEVER carried in data-* — they may contain PHI."
+        }
+      }
+    },
     {
       "kind": "component",
       "id": "button",
@@ -158,6 +452,11 @@
         "root": {
           "attr": "data-component",
           "value": "chart"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
@@ -180,505 +479,2828 @@
         "root": {
           "attr": "data-component",
           "value": "chat-container"
-        }
-      }
-    },
-    {
-      "kind": "component",
-      "id": "combobox",
-      "capabilities": [
-        "select_single",
-        "pick",
-        "filter",
-        "open",
-        "close"
-      ],
-      "state": [],
-      "actions": [],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "combobox"
         },
-        "item": {
-          "attr": "data-option-id",
-          "description": "Each option emits its value as data-option-id."
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "command-palette",
+      "id": "chat-input",
       "capabilities": [
-        "open",
-        "close",
-        "filter",
-        "pick",
+        "edit_inline",
         "submit"
       ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current text in the composer."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the composer has no text."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the composer text."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the composer. Irreversible from the same UI."
+        },
+        {
+          "name": "submit",
+          "safety": "write",
+          "description": "Submit the current composer state via onSubmit."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus into the textarea."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "chat-input",
+          "description": "Marks the ChatInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "checkbox",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "checked",
+          "type": "boolean | \"indeterminate\"",
+          "description": "Current checked state."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_checked",
+          "safety": "write",
+          "argsType": "{ checked: boolean | \"indeterminate\" }",
+          "description": "Set the checked state to a specific value."
+        },
+        {
+          "name": "toggle",
+          "safety": "write",
+          "description": "Flip the checked state between checked and unchecked."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "checkbox",
+          "description": "Marks the Checkbox wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "checkbox-group",
+      "capabilities": [
+        "select_multiple"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Values of currently-checked options."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_selection",
+          "safety": "write",
+          "argsType": "{ ids: string[] }",
+          "description": "Replace the current selection with the given option values."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "destructive",
+          "description": "Uncheck every option in the group."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "checkbox-group",
+          "description": "Marks the CheckboxGroup fieldset."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Stable opaque value emitted on each rendered Checkbox child within the group."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "collapsible",
+      "capabilities": [
+        "expand"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the content panel is expanded."
+        }
+      ],
+      "actions": [
+        {
+          "name": "toggle",
+          "safety": "write",
+          "description": "Toggle between open and closed."
+        },
+        {
+          "name": "open",
+          "safety": "write",
+          "description": "Expand the content panel."
+        },
+        {
+          "name": "close",
+          "safety": "write",
+          "description": "Collapse the content panel."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "collapsible",
+          "description": "Marks the Collapsible root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "color-picker",
+      "capabilities": [
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Currently picked colour as a hex string (e.g. \"#3b82f6\")."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ hex: string }",
+          "description": "Set the picked colour from a hex string."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "color-picker",
+          "description": "Marks the ColorPicker wrapper (inline) or trigger (popover variant)."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "combobox",
+      "capabilities": [
+        "select_single",
+        "pick",
+        "filter",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string | null",
+          "description": "Currently-selected option value, or null when nothing is selected."
+        },
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current filter query in the combobox input."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the option list is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "read",
+          "argsType": "{ value: string | null }",
+          "description": "Set the selected value programmatically."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the filter query for the option list."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Clear the current selection."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the option list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the option list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "combobox"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each option emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "command-palette",
+      "capabilities": [
+        "open",
+        "close",
+        "filter",
+        "pick",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current filter query in the command palette input."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the palette is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the command palette."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the command palette."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the filter query."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "command-palette"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-command-id",
+          "description": "Each command item emits its key as data-command-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "data-table",
+      "capabilities": [
+        "select_single",
+        "select_multiple",
+        "range_pick",
+        "filter",
+        "sort",
+        "paginate"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Row ids of currently-selected rows."
+        },
+        {
+          "name": "filter",
+          "type": "object",
+          "description": "Current ag-grid filter model, keyed by column id."
+        },
+        {
+          "name": "sort",
+          "type": "Array<{ colId, sort }>",
+          "description": "Active sort, in priority order."
+        },
+        {
+          "name": "currentPage",
+          "type": "number",
+          "description": "Zero-indexed page number."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_rows",
+          "safety": "read",
+          "argsType": "{ ids: string[] }",
+          "description": "Replace the current selection with the given row ids."
+        },
+        {
+          "name": "select_range",
+          "safety": "read",
+          "argsType": "{ fromId: string, toId: string }",
+          "description": "Select every row between fromId and toId, inclusive, in current sort order."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Deselect all rows."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ model: Record<string, unknown> }",
+          "description": "Replace the filter model with the given object."
+        },
+        {
+          "name": "sort_by",
+          "safety": "read",
+          "argsType": "{ model: DataTableSortEntry[] }",
+          "description": "Replace the active sort with the given list (priority order)."
+        },
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to the given zero-indexed page."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "data-table",
+          "description": "Marks the DataTable wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "gridId",
+          "description": "Sourced from the gridId prop. Required to address a specific table from the agent."
+        },
+        "item": {
+          "attr": "row-id",
+          "description": "Native ag-grid row-id attribute on each rendered row. Selection is performed via the curated handle, not by DOM mutation."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "date-picker",
+      "capabilities": [
+        "pick",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "iso-date",
+          "description": "Currently-selected ISO date, or null."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the calendar popover is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_date",
+          "safety": "write",
+          "argsType": "{ date: string }",
+          "description": "Select a specific date (ISO yyyy-mm-dd)."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the selected date."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the calendar popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the calendar popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "date-picker",
+          "description": "Marks the DatePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "date-range-picker",
+      "capabilities": [
+        "range_pick",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "range",
+          "type": "{ from: iso-date | null, to: iso-date | null }",
+          "description": "Currently-selected ISO date range endpoints, each possibly null."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the range calendar popover is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_range",
+          "safety": "write",
+          "argsType": "{ from: string, to: string }",
+          "description": "Replace the selected range with the given ISO endpoints."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the selected range."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the range calendar popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the range calendar popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "date-range-picker",
+          "description": "Marks the DateRangePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "date-time-picker",
+      "capabilities": [
+        "pick",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "iso-datetime",
+          "description": "Currently-selected ISO datetime, or null."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the datetime popover is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_datetime",
+          "safety": "write",
+          "argsType": "{ datetime: string }",
+          "description": "Select a specific datetime (ISO string)."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the selected datetime."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the datetime popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the datetime popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "date-time-picker",
+          "description": "Marks the DateTimePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "dialog",
+      "capabilities": [
+        "open",
+        "close",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the dialog is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the dialog."
+        },
+        {
+          "name": "close",
+          "safety": "write",
+          "description": "Close the dialog. Reversible by reopening."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Dismiss the dialog. Loses any in-progress input that has not been committed."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dialog"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Dialog.Root."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "dropdown-menu",
+      "capabilities": [
+        "open",
+        "close",
+        "pick"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the menu is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the menu."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the menu."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "dropdown-menu"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on DropdownMenu.Root."
+        },
+        "item": {
+          "attr": "data-item-id",
+          "description": "Each menu item emits its value as data-item-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "file-upload",
+      "capabilities": [
+        "submit",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "files",
+          "type": "Array<{ id, name, size, status }>",
+          "description": "Files currently tracked by the uploader. Identifiers and metadata only — never file content."
+        }
+      ],
+      "actions": [
+        {
+          "name": "remove_file",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Remove the file with the given id from the upload list."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Remove all files from the upload list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "file-upload"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-file-id",
+          "description": "Each tracked file emits its id as data-file-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "freemium-paywall",
+      "capabilities": [
+        "submit",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the paywall dialog is open."
+        },
+        {
+          "name": "selectedPlanId",
+          "type": "string | null",
+          "description": "Opaque id of the currently-selected plan."
+        }
+      ],
+      "actions": [
+        {
+          "name": "upgrade",
+          "safety": "write",
+          "description": "Fire onUpgrade with the currently-selected plan id."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Dismiss the paywall via the Not Now action. Irreversible from the same UI."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "freemium-paywall",
+          "description": "Marks the FreemiumPaywall dialog content."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "list",
+      "capabilities": [
+        "select_single",
+        "select_multiple"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Ids of currently-selected list items. Empty array when none selected or list is presentational."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_selection",
+          "safety": "read",
+          "argsType": "{ ids: string[] }",
+          "description": "Replace the current selection with the given item ids. No-op on presentational lists."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Deselect all items."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "list",
+          "description": "Marks the List root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-item-id",
+          "description": "Opaque item id; sourced from each ListItem `value` prop. Emitted only when `value` is set."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "message-card",
+      "capabilities": [
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "message-card",
+          "description": "Marks the element as a kit MessageCard. The card root also emits data-component-id sourced from item.id and data-read with the current read flag."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable message identifier."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "message-tray",
+      "capabilities": [
+        "open",
+        "close",
+        "select_single",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; read: boolean }>",
+          "description": "Currently-displayed messages. Ids + read flag only — no PHI / no sender names."
+        },
+        {
+          "name": "unreadCount",
+          "type": "number",
+          "description": "Badge unread count surfaced by the host."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the dropdown panel is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the message panel."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the message panel."
+        },
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the message with the given id."
+        },
+        {
+          "name": "mark_read",
+          "safety": "write",
+          "argsType": "{ id: string }",
+          "description": "Request the host to mark a message as read."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Request the host to dismiss / archive the message with the given id."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "message-tray",
+          "description": "Marks the MessageTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
+        },
+        "item": {
+          "attr": "data-message-id",
+          "description": "Stable message id emitted on each rendered MessageCard inside the tray."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "multi-select",
+      "capabilities": [
+        "select_multiple",
+        "filter",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "selection",
+          "type": "string[]",
+          "description": "Values of currently-selected options."
+        },
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current filter query."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the option list is visible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_selection",
+          "safety": "read",
+          "argsType": "{ values: string[] }",
+          "description": "Replace the current selection with the given list of values."
+        },
+        {
+          "name": "clear_selection",
+          "safety": "read",
+          "description": "Clear the current selection."
+        },
+        {
+          "name": "apply_filter",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Set the filter query for the option list."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the option list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the option list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "multi-select"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Each option emits its value as data-option-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "navigation-menu",
+      "capabilities": [
+        "select_single",
+        "navigate",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "activeItem",
+          "type": "string | null",
+          "description": "Id of the currently-active top-level navigation item, or null when none is active."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether a dropdown / mega-menu panel is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate (open) the top-level item with the given id."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Open the dropdown / mega-menu panel for the given top-level item id."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close any open dropdown / mega-menu panel."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "navigation-menu",
+          "description": "Marks the NavigationMenu root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific menu from the agent."
+        },
+        "item": {
+          "attr": "data-nav-id",
+          "description": "Stable opaque id of a top-level navigation item. Selection / open targets this attribute."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "notification-card",
+      "capabilities": [
+        "dismiss"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "notification-card",
+          "description": "Marks the element as a kit NotificationCard. The card root also emits data-component-id sourced from item.id and data-read with the current read flag."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable notification identifier."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "notification-tray",
+      "capabilities": [
+        "open",
+        "close",
+        "select_single",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; read: boolean }>",
+          "description": "Currently-displayed notifications. Ids + read flag only — no PHI."
+        },
+        {
+          "name": "unreadCount",
+          "type": "number",
+          "description": "Badge unread count surfaced by the host."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the dropdown panel is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the notification panel."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the notification panel."
+        },
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the notification with the given id."
+        },
+        {
+          "name": "mark_read",
+          "safety": "write",
+          "argsType": "{ id: string }",
+          "description": "Request the host to mark a notification as read."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Request the host to dismiss the notification with the given id."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "notification-tray",
+          "description": "Marks the NotificationTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
+        },
+        "item": {
+          "attr": "data-notification-id",
+          "description": "Stable notification id emitted on each rendered NotificationCard inside the tray."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "number-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "number | null",
+          "description": "Current numeric value, or null when empty."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: number | null }",
+          "description": "Replace the numeric value, or pass null to clear."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the input."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "number-input",
+          "description": "Marks the NumberInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "otp-input",
+      "capabilities": [
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current digits entered, packed into a single string."
+        },
+        {
+          "name": "isComplete",
+          "type": "boolean",
+          "description": "Whether all required digits have been entered."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the entered digits."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty all digit cells. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the active digit cell."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "otp-input",
+          "description": "Marks the OTPInput wrapper. Completion is observable via state.isComplete; the host onComplete callback fires once when all digits are filled."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "pagination",
+      "capabilities": [
+        "paginate",
+        "range_navigate"
+      ],
+      "state": [
+        {
+          "name": "currentPage",
+          "type": "number",
+          "description": "Current page index (1-based)."
+        },
+        {
+          "name": "totalPages",
+          "type": "number",
+          "description": "Total number of pages."
+        }
+      ],
+      "actions": [
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to a specific 1-indexed page."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Advance to the next page."
+        },
+        {
+          "name": "previous",
+          "safety": "read",
+          "description": "Step back to the previous page."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "pagination"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "password-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current password value. Never log or persist this off-device."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        },
+        {
+          "name": "isRevealed",
+          "type": "boolean",
+          "description": "Whether the password is currently shown in plain text."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the password value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the input."
+        },
+        {
+          "name": "toggle_visibility",
+          "safety": "read",
+          "description": "Toggle between masked and plain-text display."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "password-input",
+          "description": "Marks the PasswordInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "payment-form",
+      "capabilities": [
+        "submit"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "submit",
+          "safety": "destructive",
+          "description": "Submit the payment. Charges the configured payment method — irreversible."
+        },
+        {
+          "name": "reset",
+          "safety": "destructive",
+          "description": "Reset the form to its initial state. Loses any in-progress input."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "payment-form"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "pdf-viewer",
+      "capabilities": [
+        "paginate",
+        "view_change",
+        "filter"
+      ],
+      "state": [],
+      "actions": [
+        {
+          "name": "go_to_page",
+          "safety": "read",
+          "argsType": "{ page: number }",
+          "description": "Navigate to a specific 1-indexed page."
+        },
+        {
+          "name": "set_zoom",
+          "safety": "read",
+          "argsType": "{ zoom: PDFZoomPreset }",
+          "description": "Apply a zoom preset."
+        },
+        {
+          "name": "search",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Search the document for the given query and highlight matches."
+        },
+        {
+          "name": "print",
+          "safety": "read",
+          "description": "Open the browser print dialog for the document."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "pdf-viewer"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "phone-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current E.164 phone number, or empty string when not yet valid."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the phone number (E.164 or national format; parser will infer country)."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the phone-number input."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "phone-input",
+          "description": "Marks the PhoneInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "popover",
+      "capabilities": [
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the popover is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the popover."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the popover."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "popover"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Popover.Root."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "privacy-lock",
+      "capabilities": [
+        "submit",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isLocked",
+          "type": "boolean",
+          "description": "True when the privacy overlay is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "lock",
+          "safety": "write",
+          "description": "Open the privacy overlay."
+        },
+        {
+          "name": "unlock",
+          "safety": "write",
+          "description": "Close the privacy overlay (consumer-confirmed action)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "privacy-lock",
+          "description": "Marks the PrivacyLock trigger."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "progress",
+      "capabilities": [],
+      "state": [],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "read",
+          "argsType": "{ value: number }",
+          "description": "Set the displayed progress value (0–100)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "progress"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "radio-group",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Currently selected radio value, or empty string when none."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Select the radio with the given value."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "radio-group",
+          "description": "Marks the RadioGroup root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Stable opaque value emitted on each rendered Radio child."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "recaptcha-widget",
+      "capabilities": [
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "hasToken",
+          "type": "boolean",
+          "description": "True when the widget currently holds a valid verification token."
+        }
+      ],
+      "actions": [
+        {
+          "name": "execute",
+          "safety": "write",
+          "description": "Programmatically trigger the captcha challenge. Issues a token via the callback."
+        },
+        {
+          "name": "reset",
+          "safety": "destructive",
+          "description": "Clear the current token and re-roll the captcha. Irreversible."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "recaptcha-widget",
+          "description": "Marks the RecaptchaWidget wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop (or the surrounding FormField id)."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "resizable",
+      "capabilities": [
+        "range_navigate"
+      ],
+      "state": [
+        {
+          "name": "sizes",
+          "type": "number[]",
+          "description": "Current per-panel sizes as percentages of the group."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_sizes",
+          "safety": "read",
+          "argsType": "{ sizes: number[] }",
+          "description": "Replace the panel sizes (percentages, summing to 100)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "resizable"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on PanelGroup."
+        },
+        "item": {
+          "attr": "data-panel-id",
+          "description": "Each Panel forwards its `id` to react-resizable-panels which emits it as `data-panel-id`."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "rich-text-editor",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "html",
+          "type": "string",
+          "description": "Sanitised HTML representation of the editor content."
+        },
+        {
+          "name": "markdown",
+          "type": "string",
+          "description": "Markdown representation of the editor content."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_content",
+          "safety": "destructive",
+          "argsType": "{ html: string }",
+          "description": "Replace the editor content. Loses unsaved input."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the editor. Loses unsaved input."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the editor surface."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "rich-text-editor"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "search-bar",
+      "capabilities": [
+        "filter",
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current raw query string (inline mode). Empty in launcher mode."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the query is empty."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_query",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Replace the current query (inline mode only). No-op in launcher mode."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Clear the query and close the result popover."
+        },
+        {
+          "name": "submit",
+          "safety": "read",
+          "description": "In launcher mode opens the CommandPalette; in inline mode commits the highlighted option."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the SearchBar."
+        },
+        {
+          "name": "apply_saved_search",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Apply a saved-search by id. The host wires the actual query lookup; the adapter routes the id to its onApplySavedSearch handler. No-op when no handler is wired."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "search-bar",
+          "description": "Marks the SearchBar root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "search-input",
+      "capabilities": [
+        "filter",
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "query",
+          "type": "string",
+          "description": "Current raw query string (not debounced)."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when the query is empty."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_query",
+          "safety": "read",
+          "argsType": "{ query: string }",
+          "description": "Replace the current query with the given string and fire onChange immediately."
+        },
+        {
+          "name": "clear",
+          "safety": "read",
+          "description": "Clear the query and return focus to the input."
+        },
+        {
+          "name": "submit",
+          "safety": "read",
+          "description": "Fire the current query without waiting for debounce."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the input (expanding it first if `variant=\"expandable\"`)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "search-input",
+          "description": "Marks the SearchInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "select",
+      "capabilities": [
+        "select_single",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Currently selected option value, or empty string when none."
+        },
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the option list is open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Select the option with the given value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Clear the current selection."
+        },
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the option list."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "Close the option list."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "select",
+          "description": "Marks the Select trigger."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-option-id",
+          "description": "Stable opaque option value emitted on each rendered option."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sheet",
+      "capabilities": [
+        "open",
+        "close",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "True when the sheet is currently open."
+        }
+      ],
+      "actions": [
+        {
+          "name": "open",
+          "safety": "read",
+          "description": "Open the sheet."
+        },
+        {
+          "name": "close",
+          "safety": "write",
+          "description": "Close the sheet. Reversible by reopening."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Dismiss the sheet. Loses any in-progress input that has not been committed."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sheet"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Sheet.Root."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sidebar",
+      "capabilities": [
+        "expand",
+        "select_single",
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "isCollapsed",
+          "type": "boolean",
+          "description": "True when the sidebar is in its collapsed (rail) state."
+        },
+        {
+          "name": "activeItem",
+          "type": "string | null",
+          "description": "Id of the currently-active navigation item, or null."
+        }
+      ],
+      "actions": [
+        {
+          "name": "toggle_collapsed",
+          "safety": "read",
+          "description": "Toggle the sidebar between collapsed and expanded."
+        },
+        {
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Mark the navigation item with the given id as active."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "sidebar"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-nav-id",
+          "description": "Each Sidebar.Item emits its key as data-nav-id."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "signature-capture",
+      "capabilities": [
+        "edit_inline",
+        "submit"
+      ],
+      "state": [
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "True when no signature has been drawn or typed."
+        }
+      ],
+      "actions": [
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Erase the current signature. Loses unsaved input."
+        },
+        {
+          "name": "undo",
+          "safety": "write",
+          "description": "Undo the last stroke."
+        },
+        {
+          "name": "confirm",
+          "safety": "write",
+          "description": "Commit the signature and return its serialised payload."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "signature-capture"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "slider",
+      "capabilities": [
+        "pick",
+        "range_pick"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "number[]",
+          "description": "Current thumb values; length 1 for a single slider, length 2 for a range."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: number[] }",
+          "description": "Replace the thumb value(s). Pass a 1-tuple for single, 2-tuple for range."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "slider",
+          "description": "Marks the Slider root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "sparkline",
+      "capabilities": [],
       "state": [],
-      "actions": [],
+      "actions": [
+        {
+          "name": "update_series",
+          "safety": "read",
+          "argsType": "{ data: number[] }",
+          "description": "Replace the sparkline data without remounting."
+        },
+        {
+          "name": "export_png",
+          "safety": "read",
+          "description": "Return a PNG data URI of the sparkline."
+        }
+      ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "command-palette"
+          "value": "sparkline"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "stepper-accordion",
+      "capabilities": [
+        "expand",
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "currentStep",
+          "type": "number",
+          "description": "Zero-indexed active step."
+        },
+        {
+          "name": "totalSteps",
+          "type": "number",
+          "description": "Total number of steps in the flow."
+        },
+        {
+          "name": "openSteps",
+          "type": "number[]",
+          "description": "Indices of currently-open step panels (singleton under Radix single mode)."
+        }
+      ],
+      "actions": [
+        {
+          "name": "goto_step",
+          "safety": "read",
+          "argsType": "{ step: number }",
+          "description": "Activate the given step. Upcoming steps are gated by the consumer’s validation in onStepChange."
+        },
+        {
+          "name": "next",
+          "safety": "read",
+          "description": "Advance to the next step. Subject to the consumer’s onStepChange validation."
+        },
+        {
+          "name": "previous",
+          "safety": "read",
+          "description": "Return to the previous step (re-opens a completed step in edit mode)."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "stepper-accordion",
+          "description": "Marks the StepperAccordion root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         },
         "item": {
-          "attr": "data-command-id",
-          "description": "Each command item emits its key as data-command-id."
+          "attr": "data-step-id",
+          "description": "Stable opaque id of a step (the zero-indexed step number as a string)."
         }
       }
     },
     {
       "kind": "component",
-      "id": "data-table",
+      "id": "stepper-calendar",
       "capabilities": [
-        "select_single",
-        "select_multiple",
-        "range_pick",
-        "filter",
-        "sort",
-        "paginate"
+        "navigate",
+        "view_change"
       ],
       "state": [
         {
-          "name": "selection",
-          "type": "string[]",
-          "description": "Row ids of currently-selected rows."
-        },
-        {
-          "name": "filter",
-          "type": "object",
-          "description": "Current ag-grid filter model, keyed by column id."
-        },
-        {
-          "name": "sort",
-          "type": "Array<{ colId, sort }>",
-          "description": "Active sort, in priority order."
+          "name": "currentStep",
+          "type": "number",
+          "description": "Zero-indexed active step (0 = service, 1 = date, 2 = time, 3 = details)."
         },
         {
-          "name": "currentPage",
+          "name": "totalSteps",
           "type": "number",
-          "description": "Zero-indexed page number."
+          "description": "Total number of steps in the booking flow (always 4)."
         }
       ],
       "actions": [
         {
-          "name": "select_rows",
+          "name": "goto_step",
           "safety": "read",
-          "argsType": "{ ids: string[] }",
-          "description": "Replace the current selection with the given row ids."
+          "argsType": "{ step: number }",
+          "description": "Jump to the given step. Steps beyond the first-incomplete are gated internally."
         },
         {
-          "name": "select_range",
+          "name": "next",
           "safety": "read",
-          "argsType": "{ fromId: string, toId: string }",
-          "description": "Select every row between fromId and toId, inclusive, in current sort order."
+          "description": "Advance to the next step when the current step has a valid value."
         },
         {
-          "name": "clear_selection",
+          "name": "previous",
           "safety": "read",
-          "description": "Deselect all rows."
+          "description": "Return to the previous step."
+        }
+      ],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "stepper-calendar",
+          "description": "Marks the StepperCalendar root region."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "stepper-progress",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "currentStep",
+          "type": "number",
+          "description": "Zero-indexed active step."
         },
         {
-          "name": "apply_filter",
+          "name": "totalSteps",
+          "type": "number",
+          "description": "Total number of steps in the flow."
+        }
+      ],
+      "actions": [
+        {
+          "name": "goto_step",
           "safety": "read",
-          "argsType": "{ model: Record<string, unknown> }",
-          "description": "Replace the filter model with the given object."
+          "argsType": "{ step: number }",
+          "description": "Request the host to activate the given step via onStepChange. No-op when no handler is wired."
         },
         {
-          "name": "sort_by",
+          "name": "next",
           "safety": "read",
-          "argsType": "{ model: DataTableSortEntry[] }",
-          "description": "Replace the active sort with the given list (priority order)."
+          "description": "Request the host to advance one step via onStepChange."
         },
         {
-          "name": "go_to_page",
+          "name": "previous",
           "safety": "read",
-          "argsType": "{ page: number }",
-          "description": "Navigate to the given zero-indexed page."
+          "description": "Request the host to retreat one step via onStepChange."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "data-table",
-          "description": "Marks the DataTable wrapper."
+          "value": "stepper-progress",
+          "description": "Marks the StepperProgress root."
         },
         "instanceId": {
           "attr": "data-component-id",
-          "sourceProp": "gridId",
-          "description": "Sourced from the gridId prop. Required to address a specific table from the agent."
-        },
-        "item": {
-          "attr": "row-id",
-          "description": "Native ag-grid row-id attribute on each rendered row. Selection is performed via the curated handle, not by DOM mutation."
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "dialog",
+      "id": "suggestion-chip",
       "capabilities": [
-        "open",
-        "close",
+        "pick",
         "dismiss"
       ],
-      "state": [],
-      "actions": [],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "dialog"
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "The chip's emitted value (its `value` prop or string child)."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select",
+          "safety": "write",
+          "description": "Activate the chip — fires onSelect and (by default) self-removes."
+        },
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "description": "Remove the chip without activating it."
         }
-      }
-    },
-    {
-      "kind": "component",
-      "id": "dropdown-menu",
-      "capabilities": [
-        "open",
-        "close",
-        "pick"
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "dropdown-menu"
+          "value": "suggestion-chip",
+          "description": "Marks the chip button. Per chip — a parent rendering many chips ships its own item hook."
         },
-        "item": {
-          "attr": "data-item-id",
-          "description": "Each menu item emits its value as data-item-id."
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "file-upload",
+      "id": "switch",
       "capabilities": [
-        "submit",
-        "dismiss"
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "checked",
+          "type": "boolean",
+          "description": "Whether the switch is on."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_checked",
+          "safety": "write",
+          "argsType": "{ checked: boolean }",
+          "description": "Set the on/off state to a specific value."
+        },
+        {
+          "name": "toggle",
+          "safety": "write",
+          "description": "Flip the on/off state."
+        }
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "file-upload"
+          "value": "switch",
+          "description": "Marks the Switch root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "multi-select",
+      "id": "tabs",
       "capabilities": [
-        "select_multiple",
-        "filter",
-        "open",
-        "close"
+        "select_single",
+        "navigate"
+      ],
+      "state": [
+        {
+          "name": "activeTab",
+          "type": "string | null",
+          "description": "Value of the currently-active tab."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_tab",
+          "safety": "read",
+          "argsType": "{ value: string }",
+          "description": "Activate the tab with the given value."
+        }
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "multi-select"
+          "value": "tabs"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop on Tabs.Root."
         },
         "item": {
-          "attr": "data-option-id",
-          "description": "Each option emits its value as data-option-id."
+          "attr": "data-tab-id",
+          "description": "Each Tab.Trigger emits its value as data-tab-id."
         }
       }
     },
     {
       "kind": "component",
-      "id": "pagination",
+      "id": "task-card",
       "capabilities": [
-        "paginate",
-        "range_navigate"
+        "dismiss"
       ],
       "state": [],
       "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "pagination"
+          "value": "task-card",
+          "description": "Marks the element as a kit TaskCard. The card root also emits data-component-id sourced from item.id and data-status with the current lifecycle."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "item.id",
+          "description": "Sourced from item.id — the stable task identifier."
         }
       }
     },
     {
       "kind": "component",
-      "id": "payment-form",
+      "id": "task-tray",
       "capabilities": [
-        "submit"
+        "select_single",
+        "dismiss"
+      ],
+      "state": [
+        {
+          "name": "items",
+          "type": "Array<{ id: string; status: string }>",
+          "description": "Currently-displayed tasks. Ids + status only — never task title / patient."
+        }
       ],
-      "state": [],
       "actions": [
         {
-          "name": "submit",
-          "safety": "destructive",
-          "description": "Submit the payment. Charges the configured payment method — irreversible."
+          "name": "select_item",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Activate the task with the given id."
         },
         {
-          "name": "reset",
+          "name": "toggle_done",
+          "safety": "write",
+          "argsType": "{ id: string }",
+          "description": "Request the host to toggle the done state of a task."
+        },
+        {
+          "name": "dismiss",
           "safety": "destructive",
-          "description": "Reset the form to its initial state. Loses any in-progress input."
+          "argsType": "{ id: string }",
+          "description": "Request the host to dismiss / remove the task with the given id."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "payment-form"
+          "value": "task-tray",
+          "description": "Marks the TaskTray wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop. Required to address a specific tray from the agent."
+        },
+        "item": {
+          "attr": "data-task-id",
+          "description": "Stable task id emitted on each rendered TaskCard inside the tray."
         }
       }
     },
     {
       "kind": "component",
-      "id": "pdf-viewer",
+      "id": "text-area",
       "capabilities": [
-        "paginate",
-        "view_change",
-        "filter"
+        "edit_inline"
       ],
-      "state": [],
-      "actions": [
+      "state": [
         {
-          "name": "go_to_page",
-          "safety": "read",
-          "argsType": "{ page: number }",
-          "description": "Navigate to a specific 1-indexed page."
+          "name": "value",
+          "type": "string",
+          "description": "Current value of the textarea."
         },
         {
-          "name": "set_zoom",
-          "safety": "read",
-          "argsType": "{ zoom: PDFZoomPreset }",
-          "description": "Apply a zoom preset."
-        },
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the textarea has no value."
+        }
+      ],
+      "actions": [
         {
-          "name": "search",
-          "safety": "read",
-          "argsType": "{ query: string }",
-          "description": "Search the document for the given query and highlight matches."
+          "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the textarea value."
         },
         {
-          "name": "print",
-          "safety": "read",
-          "description": "Open the browser print dialog for the document."
-        }
-      ],
-      "domHooks": {
-        "root": {
-          "attr": "data-component",
-          "value": "pdf-viewer"
-        }
-      }
-    },
-    {
-      "kind": "component",
-      "id": "popover",
-      "capabilities": [
-        "open",
-        "close"
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the textarea. Loses any typed value."
+        },
+        {
+          "name": "focus",
+          "safety": "read",
+          "description": "Move keyboard focus to the textarea."
+        }
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "popover"
+          "value": "text-area",
+          "description": "Marks the TextArea wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "progress",
-      "capabilities": [],
-      "state": [],
+      "id": "text-input",
+      "capabilities": [
+        "edit_inline"
+      ],
+      "state": [
+        {
+          "name": "value",
+          "type": "string",
+          "description": "Current value of the text input."
+        },
+        {
+          "name": "isEmpty",
+          "type": "boolean",
+          "description": "Whether the input has no value."
+        }
+      ],
       "actions": [
         {
           "name": "set_value",
+          "safety": "write",
+          "argsType": "{ value: string }",
+          "description": "Replace the input value."
+        },
+        {
+          "name": "clear",
+          "safety": "destructive",
+          "description": "Empty the input. Loses any typed value."
+        },
+        {
+          "name": "focus",
           "safety": "read",
-          "argsType": "{ value: number }",
-          "description": "Set the displayed progress value (0–100)."
+          "description": "Move keyboard focus to the input."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "progress"
+          "value": "text-input",
+          "description": "Marks the TextInput wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "resizable",
+      "id": "theme-toggle",
       "capabilities": [
-        "range_navigate"
+        "view_change"
+      ],
+      "state": [
+        {
+          "name": "currentTheme",
+          "type": "ThemePreference",
+          "description": "Active theme preference: light, dark, or system."
+        },
+        {
+          "name": "currentAccessibility",
+          "type": "AccessibilityPreference",
+          "description": "Active accessibility preference: default or accessible."
+        }
+      ],
+      "actions": [
+        {
+          "name": "set_theme",
+          "safety": "write",
+          "argsType": "{ theme: \"light\" | \"dark\" | \"system\" }",
+          "description": "Switch the theme preference."
+        },
+        {
+          "name": "set_accessibility",
+          "safety": "write",
+          "argsType": "{ accessibility: \"default\" | \"accessible\" }",
+          "description": "Switch the accessibility preference."
+        }
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "resizable"
+          "value": "theme-toggle",
+          "description": "Marks the ThemeToggle wrapper."
         },
-        "item": {
-          "attr": "data-panel-id",
-          "description": "Each Panel forwards its `id` to react-resizable-panels which emits it as `data-panel-id`."
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "rich-text-editor",
+      "id": "time-picker",
       "capabilities": [
-        "edit_inline"
+        "pick",
+        "open",
+        "close"
       ],
       "state": [
         {
-          "name": "html",
-          "type": "string",
-          "description": "Sanitised HTML representation of the editor content."
+          "name": "value",
+          "type": "HH:MM",
+          "description": "Currently-selected time as 24h HH:MM (always present — defaults to 00:00 when unset)."
         },
         {
-          "name": "markdown",
-          "type": "string",
-          "description": "Markdown representation of the editor content."
+          "name": "isOpen",
+          "type": "boolean",
+          "description": "Whether the time popover is open. TimePicker has no popover of its own; always false."
         }
       ],
       "actions": [
         {
-          "name": "set_content",
-          "safety": "destructive",
-          "argsType": "{ html: string }",
-          "description": "Replace the editor content. Loses unsaved input."
+          "name": "set_time",
+          "safety": "write",
+          "argsType": "{ time: string }",
+          "description": "Set the time using a 24h HH:MM string."
         },
         {
           "name": "clear",
           "safety": "destructive",
-          "description": "Empty the editor. Loses unsaved input."
+          "description": "Clear the time (resets to 00:00)."
         },
         {
-          "name": "focus",
+          "name": "open",
           "safety": "read",
-          "description": "Move keyboard focus to the editor surface."
+          "description": "No-op: TimePicker has no popover of its own."
+        },
+        {
+          "name": "close",
+          "safety": "read",
+          "description": "No-op: TimePicker has no popover of its own."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "rich-text-editor"
+          "value": "time-picker",
+          "description": "Marks the TimePicker wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "sheet",
+      "id": "timeline",
       "capabilities": [
-        "open",
-        "close",
-        "dismiss"
+        "pick",
+        "range_navigate"
+      ],
+      "state": [
+        {
+          "name": "selectedEvent",
+          "type": "string | null",
+          "description": "Opaque event id of the currently-active event, or null."
+        }
+      ],
+      "actions": [
+        {
+          "name": "select_event",
+          "safety": "read",
+          "argsType": "{ id: string }",
+          "description": "Scroll the given event into view and mark it as selected."
+        }
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "sheet"
+          "value": "timeline",
+          "description": "Marks the Timeline root."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-event-id",
+          "description": "Opaque event id emitted on each Timeline.Event when the `eventId` prop is provided."
         }
       }
     },
     {
       "kind": "component",
-      "id": "sidebar",
+      "id": "toast",
       "capabilities": [
-        "expand",
-        "select_single",
-        "navigate"
+        "dismiss",
+        "open",
+        "close"
+      ],
+      "state": [
+        {
+          "name": "visibleToasts",
+          "type": "Array<{ id: string }>",
+          "description": "Snapshot of currently-visible toasts by opaque id. Never carries the toast body text."
+        }
+      ],
+      "actions": [
+        {
+          "name": "dismiss",
+          "safety": "destructive",
+          "argsType": "{ id: string }",
+          "description": "Dismiss the toast with the given id. Irreversible from the same UI."
+        },
+        {
+          "name": "dismiss_all",
+          "safety": "destructive",
+          "description": "Dismiss every visible toast."
+        }
       ],
-      "state": [],
-      "actions": [],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "sidebar"
+          "value": "toast",
+          "description": "Marks the Toaster region wrapper. Toast is imperatively created; the registry addresses individual toasts by id, not by per-instance root."
         },
         "item": {
-          "attr": "data-nav-id",
-          "description": "Each Sidebar.Item emits its key as data-nav-id."
+          "attr": "data-toast-id",
+          "description": "Stable opaque toast id assigned at creation. Used by `dismiss({id})`."
         }
       }
     },
     {
       "kind": "component",
-      "id": "signature-capture",
+      "id": "tooth-scheme",
       "capabilities": [
-        "edit_inline",
-        "submit"
+        "pick"
       ],
       "state": [
         {
-          "name": "isEmpty",
-          "type": "boolean",
-          "description": "True when no signature has been drawn or typed."
+          "name": "chart",
+          "type": "object",
+          "description": "Current dental chart state — tooth conditions keyed by FDI id."
         }
       ],
       "actions": [
         {
-          "name": "clear",
-          "safety": "destructive",
-          "description": "Erase the current signature. Loses unsaved input."
-        },
-        {
-          "name": "undo",
-          "safety": "write",
-          "description": "Undo the last stroke."
-        },
-        {
-          "name": "confirm",
-          "safety": "write",
-          "description": "Commit the signature and return its serialised payload."
+          "name": "focus_tooth",
+          "safety": "read",
+          "argsType": "{ id: FdiId }",
+          "description": "Move focus to a specific tooth by FDI id."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "signature-capture"
+          "value": "tooth-scheme"
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-fdi",
+          "description": "Each rendered tooth `<g>` carries its FDI id as `data-fdi`. Tests still use `data-testid=\"tooth-<fdi>\"` separately."
         }
       }
     },
     {
       "kind": "component",
-      "id": "sparkline",
-      "capabilities": [],
-      "state": [],
+      "id": "transcript-panel",
+      "capabilities": [
+        "select_single"
+      ],
+      "state": [
+        {
+          "name": "selectedTurn",
+          "type": "string | null",
+          "description": "Opaque id (line index) of the currently-active turn, or null when none is active."
+        }
+      ],
       "actions": [
         {
-          "name": "update_series",
+          "name": "focus_turn",
           "safety": "read",
-          "argsType": "{ data: number[] }",
-          "description": "Replace the sparkline data without remounting."
+          "argsType": "{ id: string }",
+          "description": "Scroll the given turn into view and focus its seek button."
         },
         {
-          "name": "export_png",
+          "name": "copy_turn",
           "safety": "read",
-          "description": "Return a PNG data URI of the sparkline."
+          "argsType": "{ id: string }",
+          "description": "Copy the given turn's text to the clipboard."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "sparkline"
+          "value": "transcript-panel",
+          "description": "Marks the TranscriptPanel wrapper."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-turn-id",
+          "description": "Stable opaque turn id (line index). Never carries the turn's dictated text."
         }
       }
     },
     {
       "kind": "component",
-      "id": "tabs",
+      "id": "workflow-card",
       "capabilities": [
-        "select_single",
         "navigate"
       ],
       "state": [],
@@ -686,43 +3308,82 @@
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "tabs"
+          "value": "workflow-card",
+          "description": "Marks a Workflow summary card. Presentational — actions are owned by the host pattern."
         },
-        "item": {
-          "attr": "data-tab-id",
-          "description": "Each Tab.Trigger emits its value as data-tab-id. The agent reads this to identify the active tab via the DOM."
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         }
       }
     },
     {
       "kind": "component",
-      "id": "tooth-scheme",
+      "id": "workflow-editor",
       "capabilities": [
-        "pick"
+        "navigate",
+        "expand"
       ],
       "state": [
         {
-          "name": "chart",
-          "type": "object",
-          "description": "Current dental chart state — tooth conditions keyed by FDI id."
+          "name": "totalSteps",
+          "type": "number",
+          "description": "Total number of nodes currently in the workflow graph."
+        },
+        {
+          "name": "currentStep",
+          "type": "string | null",
+          "description": "Opaque node id of the currently-focused step, or null."
         }
       ],
       "actions": [
         {
-          "name": "focus_tooth",
+          "name": "goto_step",
           "safety": "read",
-          "argsType": "{ id: FdiId }",
-          "description": "Move focus to a specific tooth by FDI id."
+          "argsType": "{ id: string }",
+          "description": "Focus a node by its opaque id."
         }
       ],
       "domHooks": {
         "root": {
           "attr": "data-component",
-          "value": "tooth-scheme"
+          "value": "workflow-editor",
+          "description": "Marks the WorkflowEditor surface."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
         },
         "item": {
-          "attr": "data-fdi",
-          "description": "Each rendered tooth `<g>` carries its FDI id as `data-fdi`. Tests still use `data-testid=\"tooth-<fdi>\"` separately."
+          "attr": "data-node-id",
+          "description": "Stable opaque workflow node id emitted on each node card."
+        }
+      }
+    },
+    {
+      "kind": "component",
+      "id": "workflow-map",
+      "capabilities": [
+        "navigate"
+      ],
+      "state": [],
+      "actions": [],
+      "domHooks": {
+        "root": {
+          "attr": "data-component",
+          "value": "workflow-map",
+          "description": "Marks a Workflow map (linear visualisation). Presentational."
+        },
+        "instanceId": {
+          "attr": "data-component-id",
+          "sourceProp": "id",
+          "description": "Sourced from the id prop."
+        },
+        "item": {
+          "attr": "data-node-id",
+          "description": "Stable opaque workflow node id emitted on each step."
         }
       }
     }