@exponential-at/ui 0.0.0-stage → 0.1.0

package/catalog/core.catalog.json

@@ -0,0 +1,4752 @@
+{
+  "$comment": "VAPP-85: THE source of the Exponential UI core catalog. Everything else is generated from it (core.schema.json, src/catalog.generated.ts, the Swift/Kotlin/Rust constants, docs/components.generated.json, fixtures/catalog-components.json). Canonical names = shadcn's; the A2UI basic catalog maps onto them (basic-map.json). `kind`: `native` = a renderer paints it, `macro` = macros.json expands it into natives before painting. `lite`: the core-lite subset (the app-shaped vocabulary: no overlays, media, Chart, data tables or the rarer controls) for small prompts. Round 3 (VAPP-102, docs/round-3-contract.md) folded the app vocabulary onto Row, Section, Chip, Segmented and Menu; round 4 (VAPP-103) REMOVED the old names: there are no aliases: an old name reduces to the `unknownComponent` placeholder with an `unknown component <name>` issue. `children`: none | one | many; `slots` = named child slots. Prop `type`: string | markdown | number | boolean | enum (`enum` names a shared list) | icon (an icons.json name) | color (a `$color.*` token ONLY: a literal `#hex`/`rgb()` in a node is refused so light and dark themes both apply; themes keep literals) | style (a Box style object) | array (`items`) | object (`shape` names a `defs` entry) | date (ISO yyyy-mm-dd) | url. `bindable` props take an A2UI data binding `{path}` or function call instead of a literal. Round 1 (docs/round-1-contract.md): `responsive` props ALSO take `{base, sm?, md?, lg?, xl?}` keyed by the `$breakpoint` token names (on a macro the expander turns them into `@media (min-width: $breakpoint.<bp>)` blocks; on a native the RENDERER picks the value of the active breakpoint, src/macros.ts responsiveAt + src/style.ts activeBreakpoint); EVERY component takes the common `visible` (a boolean or a binding; false = not rendered, no layout), `style` and `accessibility`; `slots: [\"*\"]` = any slot name (Table cell templates); a string default or value of the form `$string.<id>` is a built-in UI string (catalog/strings.json) the renderer shows in the surface locale; `object` props without a `shape` take any object. Descriptions are MODEL-FACING: one sentence, what and when. Variant/size LOOKS come from the theme's recipes (VAPP-92), never from here. EXP-1259 (the UI batch) adds the low-level feedback and search pieces the app settled on: `SearchList`, Spinner `xs`, Button `pendingLabel`, Skeleton rows, Tabs `closable`/`addable`, searchable Menu submenus.",
+  "id": "https://ui.exponential.at/catalogs/core/v1",
+  "liteId": "https://ui.exponential.at/catalogs/core-lite/v1",
+  "name": "Exponential UI core",
+  "version": "1",
+  "unknownComponent": "Unknown",
+  "enums": {
+    "variant": [
+      "default",
+      "secondary",
+      "outline",
+      "ghost",
+      "destructive",
+      "link"
+    ],
+    "size": [
+      "sm",
+      "default",
+      "lg",
+      "icon"
+    ],
+    "tone": [
+      "neutral",
+      "primary",
+      "success",
+      "warning",
+      "danger",
+      "info"
+    ],
+    "gap": [
+      "none",
+      "xs",
+      "sm",
+      "md",
+      "lg",
+      "xl"
+    ],
+    "align": [
+      "start",
+      "center",
+      "end",
+      "stretch"
+    ],
+    "justify": [
+      "start",
+      "center",
+      "end",
+      "between",
+      "around",
+      "evenly"
+    ],
+    "textVariant": [
+      "body",
+      "caption",
+      "muted",
+      "lead",
+      "code",
+      "label",
+      "title"
+    ],
+    "headingLevel": [
+      "h1",
+      "h2",
+      "h3",
+      "h4"
+    ],
+    "imageFit": [
+      "contain",
+      "cover",
+      "fill",
+      "none",
+      "scaleDown"
+    ],
+    "orientation": [
+      "horizontal",
+      "vertical"
+    ],
+    "side": [
+      "top",
+      "right",
+      "bottom",
+      "left"
+    ],
+    "inputType": [
+      "text",
+      "email",
+      "password",
+      "number",
+      "search",
+      "url",
+      "tel"
+    ],
+    "validateOn": [
+      "change",
+      "blur",
+      "submit"
+    ],
+    "alertType": [
+      "info",
+      "success",
+      "warning",
+      "error"
+    ],
+    "controlSize": [
+      "sm",
+      "default",
+      "lg"
+    ],
+    "spinnerSize": [
+      "xs",
+      "sm",
+      "default",
+      "lg"
+    ],
+    "tabClosable": [
+      "none",
+      "hover",
+      "always"
+    ],
+    "groupType": [
+      "single",
+      "multiple"
+    ],
+    "rowChevron": [
+      "none",
+      "right",
+      "selector"
+    ],
+    "rowSurface": [
+      "flat",
+      "card"
+    ],
+    "chipShape": [
+      "pill",
+      "rect"
+    ],
+    "density": [
+      "default",
+      "compact"
+    ],
+    "listDirection": [
+      "vertical",
+      "horizontal"
+    ],
+    "chartKind": [
+      "bar",
+      "stackedBar",
+      "line",
+      "area",
+      "pie",
+      "donut",
+      "sparkline"
+    ],
+    "segmentedVariant": [
+      "segmented",
+      "toggles",
+      "outline",
+      "bar"
+    ],
+    "liveTone": [
+      "live",
+      "attention",
+      "done",
+      "unread",
+      "idle",
+      "muted"
+    ],
+    "menuItemKind": [
+      "item",
+      "checkbox",
+      "separator",
+      "label",
+      "submenu"
+    ],
+    "openOn": [
+      "press",
+      "hover"
+    ],
+    "menuOpenOn": [
+      "press",
+      "contextmenu"
+    ],
+    "live": [
+      "off",
+      "polite",
+      "assertive"
+    ],
+    "selectable": [
+      "none",
+      "single",
+      "multiple"
+    ],
+    "cellType": [
+      "text",
+      "number",
+      "date",
+      "boolean",
+      "badge",
+      "slot",
+      "currency",
+      "percent",
+      "relativeTime"
+    ],
+    "sortDirection": [
+      "asc",
+      "desc"
+    ],
+    "imageLoading": [
+      "lazy",
+      "eager"
+    ],
+    "scrollDirection": [
+      "vertical",
+      "horizontal",
+      "both"
+    ],
+    "collapseBelow": [
+      "never",
+      "sm",
+      "md",
+      "lg",
+      "xl"
+    ],
+    "codeLanguage": [
+      "plain",
+      "json",
+      "js",
+      "ts",
+      "tsx",
+      "rust",
+      "swift",
+      "kotlin",
+      "python",
+      "bash",
+      "html",
+      "css",
+      "sql",
+      "yaml",
+      "markdown",
+      "ansi"
+    ],
+    "codeToken": [
+      "plain",
+      "keyword",
+      "string",
+      "number",
+      "comment",
+      "punctuation",
+      "operator",
+      "type",
+      "function",
+      "property",
+      "tag",
+      "attribute",
+      "success",
+      "warning",
+      "error"
+    ],
+    "codeBlockVariant": [
+      "default",
+      "destructive"
+    ],
+    "codeBlockSize": [
+      "default",
+      "sm"
+    ],
+    "traceStatus": [
+      "running",
+      "error",
+      "pending"
+    ],
+    "traceSize": [
+      "default",
+      "sm"
+    ]
+  },
+  "defs": {
+    "option": {
+      "description": "One selectable option.",
+      "properties": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The text shown for the option."
+        },
+        "value": {
+          "type": "string",
+          "required": true,
+          "description": "The stable value the selection reports."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "An icon shown before the label."
+        },
+        "disabled": {
+          "type": "boolean",
+          "description": "Shows the option but refuses it."
+        },
+        "description": {
+          "type": "string",
+          "description": "A second line."
+        },
+        "image": {
+          "type": "url",
+          "description": "A tile picture."
+        }
+      }
+    },
+    "check": {
+      "description": "A client-side validation rule.",
+      "properties": {
+        "condition": {
+          "type": "boolean",
+          "required": true,
+          "bindable": true,
+          "description": "A function call or binding that must be true for the input to be valid."
+        },
+        "message": {
+          "type": "string",
+          "required": true,
+          "description": "The error shown when the condition is false."
+        }
+      }
+    },
+    "tab": {
+      "description": "One tab header.",
+      "properties": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The tab title."
+        },
+        "value": {
+          "type": "string",
+          "required": true,
+          "description": "The value reported when the tab is active."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "An icon before the title."
+        },
+        "count": {
+          "type": "number",
+          "description": "A count badge after the title."
+        }
+      }
+    },
+    "menuItem": {
+      "description": "One menu entry: an action, a checkbox, a separator, a group label or a submenu.",
+      "properties": {
+        "label": {
+          "type": "string",
+          "description": "The entry text (a separator has none)."
+        },
+        "value": {
+          "type": "string",
+          "description": "The value reported on select (actions and checkboxes)."
+        },
+        "kind": {
+          "type": "enum",
+          "enum": "menuItemKind",
+          "default": "item",
+          "description": "What the entry is."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "An icon before the text."
+        },
+        "shortcut": {
+          "type": "string",
+          "description": "A key-cap hint after the text (`⌘K`)."
+        },
+        "checked": {
+          "type": "boolean",
+          "bindable": true,
+          "description": "A checkbox entry's state; bind it."
+        },
+        "destructive": {
+          "type": "boolean",
+          "description": "Styles the entry as a destructive action."
+        },
+        "disabled": {
+          "type": "boolean",
+          "description": "Shows the entry greyed and inert."
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "menuItem"
+          },
+          "bindable": true,
+          "description": "A submenu's entries (one level deep); bind it to rows a host source feeds (statuses, members, labels)."
+        },
+        "searchable": {
+          "type": "boolean",
+          "description": "Filters the submenu in a search list."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "A searchable submenu's placeholder."
+        }
+      }
+    },
+    "searchItem": {
+      "description": "One row of a search list.",
+      "properties": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The row title."
+        },
+        "value": {
+          "type": "string",
+          "required": true,
+          "description": "The value a pick reports."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "A leading glyph."
+        },
+        "identifier": {
+          "type": "string",
+          "description": "A mono id before the title (`EXP-12`)."
+        },
+        "disabled": {
+          "type": "boolean",
+          "description": "Refuses the row."
+        }
+      }
+    },
+    "accordionItem": {
+      "description": "One collapsible section header; its body is the child at the same index.",
+      "properties": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The section title."
+        },
+        "value": {
+          "type": "string",
+          "required": true,
+          "description": "The value reported when the section is open."
+        },
+        "count": {
+          "type": "number",
+          "description": "A count shown in the header."
+        }
+      }
+    },
+    "segment": {
+      "description": "One slice of a meter.",
+      "properties": {
+        "value": {
+          "type": "number",
+          "required": true,
+          "description": "The slice's share of max."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "description": "The slice's colour tone."
+        },
+        "label": {
+          "type": "string",
+          "description": "What the slice stands for."
+        }
+      }
+    },
+    "series": {
+      "description": "One chart series.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The legend label."
+        },
+        "values": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "required": true,
+          "description": "One number per category."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "description": "The series' colour tone; charts default to the chart hues in order."
+        }
+      }
+    },
+    "pageItem": {
+      "description": "One page of a carousel.",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "A caption over the page."
+        }
+      }
+    },
+    "step": {
+      "description": "One wizard step.",
+      "properties": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "description": "The step name."
+        },
+        "description": {
+          "type": "string",
+          "description": "A muted line under the name."
+        }
+      }
+    },
+    "column": {
+      "description": "One table column.",
+      "properties": {
+        "key": {
+          "type": "string",
+          "required": true,
+          "description": "The row field it shows."
+        },
+        "label": {
+          "type": "string",
+          "required": true,
+          "description": "The header text."
+        },
+        "type": {
+          "type": "enum",
+          "enum": "cellType",
+          "default": "text",
+          "description": "How cells render: text, a locale number/currency/percent, a date, a relative time, a tick, a badge, or the named slot's component once per row."
+        },
+        "slot": {
+          "type": "string",
+          "description": "For `type: slot`: the Table slot whose component renders each cell with the row as its data scope."
+        },
+        "width": {
+          "type": "number",
+          "description": "A fixed width in px; otherwise columns share the width."
+        },
+        "align": {
+          "type": "enum",
+          "values": [
+            "start",
+            "center",
+            "end"
+          ],
+          "default": "start",
+          "description": "Cell alignment (numbers read best at `end`)."
+        },
+        "sortable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Lets the header toggle the sort."
+        },
+        "currency": {
+          "type": "string",
+          "description": "ISO 4217 code of a currency column (USD)."
+        },
+        "decimals": {
+          "type": "number",
+          "description": "Fixed fraction digits of a number, currency or percent column."
+        }
+      }
+    },
+    "sort": {
+      "description": "A table sort.",
+      "properties": {
+        "key": {
+          "type": "string",
+          "required": true,
+          "description": "The sorted column's key."
+        },
+        "direction": {
+          "type": "enum",
+          "enum": "sortDirection",
+          "required": true,
+          "description": "Ascending or descending."
+        }
+      }
+    },
+    "panel": {
+      "description": "One Resizable panel's limits, percent of the group.",
+      "properties": {
+        "min": {
+          "type": "number",
+          "description": "Smallest size (10)."
+        },
+        "max": {
+          "type": "number",
+          "description": "Largest size (100)."
+        },
+        "collapsible": {
+          "type": "boolean",
+          "description": "Drags to 0 below half its min; Enter on the handle toggles."
+        }
+      }
+    },
+    "file": {
+      "description": "One attached file.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The file name."
+        },
+        "size": {
+          "type": "number",
+          "description": "Bytes."
+        },
+        "type": {
+          "type": "string",
+          "description": "The MIME type."
+        },
+        "url": {
+          "type": "url",
+          "description": "Where it was stored, for a preview link."
+        }
+      }
+    }
+  },
+  "functions": {
+    "$comment": "The core catalog exposes the A2UI basic catalog's 14 client-side functions, same names and arguments (vendor/a2ui/v0_9/basic_catalog.json#/functions; a basic surface calls them unchanged; the format* functions format in the SURFACE locale, docs/round-1-contract.md §4), plus the 15 CORE functions of round 1 (and round 4's `filter`) (`core` below: named args, what they return) so a macro whose input is a data binding expands into a value the renderer computes at bind time (docs/round-1-contract.md §1; the expander emits them, an author may call them too). Round 2 (docs/round-2-contract.md §3): `formatPercent` and `formatRelativeTime` join them, and EVERY format function (the basic formatNumber/formatCurrency/formatDate/pluralize too) runs through the surface's host-supplied Formatter (locale + timeZone from SurfaceSettings; the English fallback = Intl en-US). Truthiness everywhere = src/expr.ts `truthy`: undefined, null, false and \"\" are false, 0 is TRUE. Arguments are resolved at ANY depth (an array or object argument may hold bindings and calls). `basic` = the basic functions' signatures (vendor/a2ui, flattened) so the prompt lists every function with its arguments. `set` is the one ACTION function: in an Action's `functionCall` it writes `value` to the data model at `path` (two-way binding for macros; an Action may carry `functionCall` AND `event`: every argument and the event context are evaluated FIRST, then the write, then the event).",
+    "names": [
+      "required",
+      "regex",
+      "length",
+      "numeric",
+      "email",
+      "formatString",
+      "formatNumber",
+      "formatCurrency",
+      "formatDate",
+      "pluralize",
+      "openUrl",
+      "and",
+      "or",
+      "not",
+      "percent",
+      "add",
+      "sub",
+      "eq",
+      "lt",
+      "clamp",
+      "cond",
+      "fallback",
+      "concat",
+      "coalesce",
+      "text",
+      "map",
+      "len",
+      "fill",
+      "set",
+      "formatPercent",
+      "formatRelativeTime",
+      "filter"
+    ],
+    "core": {
+      "percent": {
+        "description": "The share of max as \"N%\", clamped to 0..100, two decimals; 0% when max is not positive.",
+        "args": {
+          "value": "number",
+          "max": "number"
+        },
+        "returns": "string"
+      },
+      "add": {
+        "description": "a + b; non-numbers count as 0.",
+        "args": {
+          "a": "number",
+          "b": "number"
+        },
+        "returns": "number"
+      },
+      "sub": {
+        "description": "a - b; non-numbers count as 0.",
+        "args": {
+          "a": "number",
+          "b": "number"
+        },
+        "returns": "number"
+      },
+      "eq": {
+        "description": "Strict equality of two values, except that a number equals a string spelling it (5 and \"5\"); nothing else coerces.",
+        "args": {
+          "a": "any",
+          "b": "any"
+        },
+        "returns": "boolean"
+      },
+      "lt": {
+        "description": "a < b as numbers.",
+        "args": {
+          "a": "number",
+          "b": "number"
+        },
+        "returns": "boolean"
+      },
+      "clamp": {
+        "description": "value as a number held inside [min, max]; a missing bound does not clamp; min wins when max < min.",
+        "args": {
+          "value": "number",
+          "min": "number",
+          "max": "number"
+        },
+        "returns": "number"
+      },
+      "cond": {
+        "description": "`then` when `if` is truthy, else `else`.",
+        "args": {
+          "if": "any",
+          "then": "any",
+          "else": "any"
+        },
+        "returns": "any"
+      },
+      "fallback": {
+        "description": "value unless it is missing (undefined or null), else default; a template's `{x|default}` over a bound x.",
+        "args": {
+          "value": "any",
+          "default": "any"
+        },
+        "returns": "any"
+      },
+      "concat": {
+        "description": "The values joined into one string (undefined and null as empty).",
+        "args": {
+          "values": "array"
+        },
+        "returns": "string"
+      },
+      "coalesce": {
+        "description": "The first truthy value.",
+        "args": {
+          "values": "array"
+        },
+        "returns": "any"
+      },
+      "text": {
+        "description": "The value as a string; no value when it is missing.",
+        "args": {
+          "value": "any"
+        },
+        "returns": "string"
+      },
+      "map": {
+        "description": "cases[String(value)] when that case exists, else default.",
+        "args": {
+          "value": "any",
+          "cases": "object",
+          "default": "any"
+        },
+        "returns": "any"
+      },
+      "len": {
+        "description": "An array's or a string's length, else 0.",
+        "args": {
+          "value": "any"
+        },
+        "returns": "number"
+      },
+      "fill": {
+        "description": "template with its {name} placeholders filled from params (unknown ones stay); a `$string.<id>` template resolves through the surface's string table first.",
+        "args": {
+          "template": "string",
+          "params": "object"
+        },
+        "returns": "string"
+      },
+      "set": {
+        "description": "Action only: writes value into the data model at path (a JSON pointer, relative to the node's data scope like a binding).",
+        "args": {
+          "path": "string",
+          "value": "any"
+        },
+        "returns": "void"
+      },
+      "formatPercent": {
+        "description": "A ratio as a locale percent through the surface Formatter (0.256 → 26%); decimals = fixed fraction digits.",
+        "args": {
+          "value": "number",
+          "decimals": "number"
+        },
+        "returns": "string"
+      },
+      "formatRelativeTime": {
+        "description": "A date (yyyy-mm-dd, ISO date-time or epoch ms) relative to now (epoch ms or a date; default the clock) through the surface Formatter: 3 minutes ago, yesterday, in 2 hours.",
+        "args": {
+          "value": "any",
+          "now": "any"
+        },
+        "returns": "string"
+      },
+      "filter": {
+        "description": "The items that match, in order: every `where` field equals its value (an empty value matches all) and `query` is a case-insensitive substring of one of `fields` (default every text field); bind a List or Table to it.",
+        "args": {
+          "items": "array",
+          "query": "string",
+          "fields": "array",
+          "where": "object"
+        },
+        "returns": "array"
+      }
+    },
+    "basic": {
+      "required": {
+        "args": {
+          "value": "any"
+        },
+        "returns": "boolean"
+      },
+      "regex": {
+        "args": {
+          "value": "string",
+          "pattern": "string"
+        },
+        "returns": "boolean"
+      },
+      "length": {
+        "args": {
+          "value": "string",
+          "min": "number",
+          "max": "number"
+        },
+        "returns": "boolean"
+      },
+      "numeric": {
+        "args": {
+          "value": "number",
+          "min": "number",
+          "max": "number"
+        },
+        "returns": "boolean"
+      },
+      "email": {
+        "args": {
+          "value": "string"
+        },
+        "returns": "boolean"
+      },
+      "formatString": {
+        "args": {
+          "value": "string"
+        },
+        "returns": "string"
+      },
+      "formatNumber": {
+        "args": {
+          "value": "number",
+          "decimals": "number",
+          "grouping": "boolean"
+        },
+        "returns": "string"
+      },
+      "formatCurrency": {
+        "args": {
+          "value": "number",
+          "currency": "string",
+          "decimals": "number",
+          "grouping": "boolean"
+        },
+        "returns": "string"
+      },
+      "formatDate": {
+        "args": {
+          "value": "any",
+          "format": "string"
+        },
+        "returns": "string"
+      },
+      "pluralize": {
+        "args": {
+          "value": "number",
+          "zero": "string",
+          "one": "string",
+          "two": "string",
+          "few": "string",
+          "many": "string",
+          "other": "string"
+        },
+        "returns": "string"
+      },
+      "openUrl": {
+        "args": {
+          "url": "string"
+        },
+        "returns": "void"
+      },
+      "and": {
+        "args": {
+          "values": "array"
+        },
+        "returns": "boolean"
+      },
+      "or": {
+        "args": {
+          "values": "array"
+        },
+        "returns": "boolean"
+      },
+      "not": {
+        "args": {
+          "value": "any"
+        },
+        "returns": "boolean"
+      }
+    }
+  },
+  "builtinIcons": {
+    "$comment": "Round 1: the glyph every renderer draws for a part it owns (`<Component>.<part>[.<variant>]` → an icons.json name, generated as builtinIconSlots/builtinIconNames), so a copy button, a drop zone or a sort arrow is the same icon on every platform. Append-only.",
+    "Accordion.trigger": "ui-chevron-down",
+    "Carousel.previous": "ui-chevron-left",
+    "Carousel.next": "ui-chevron-right",
+    "Checkbox.check": "ui-check",
+    "ChipInput.remove": "ui-close",
+    "CodeBlock.copy": "ui-copy",
+    "CodeBlock.copied": "ui-check",
+    "Composer.attachment": "ui-attach",
+    "Composer.send": "ui-send",
+    "Composer.stop": "ui-stop",
+    "DatePicker.trigger": "calendar",
+    "DatePicker.previousMonth": "ui-chevron-left",
+    "DatePicker.nextMonth": "ui-chevron-right",
+    "DateRangePicker.trigger": "calendar",
+    "Dialog.close": "ui-close",
+    "Menu.check": "ui-check",
+    "Menu.submenuIndicator": "ui-chevron-right",
+    "FileUpload.icon": "upload",
+    "FileUpload.file": "ui-file",
+    "FileUpload.remove": "ui-close",
+    "Image.fallback": "ui-icon-placeholder",
+    "NumberField.decrement": "ui-minus",
+    "NumberField.increment": "ui-add",
+    "Select.trigger": "ui-selector",
+    "Select.search": "search",
+    "Select.check": "ui-check",
+    "SearchList.search": "search",
+    "SearchList.check": "ui-check",
+    "Table.sortIcon.asc": "ui-chevron-up",
+    "Table.sortIcon.desc": "ui-chevron-down",
+    "Tabs.close": "ui-close",
+    "Tabs.new": "ui-add",
+    "TimePicker.trigger": "ui-clock",
+    "Toast.close": "ui-close",
+    "Toast.icon.info": "ui-info",
+    "Toast.icon.success": "ui-success",
+    "Toast.icon.warning": "ui-warning",
+    "Toast.icon.error": "ui-error",
+    "Unknown.root": "ui-warning"
+  },
+  "components": {
+    "Box": {
+      "kind": "native",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "description": "A styled container laid out by the whitelisted style object; what every macro expands into.",
+      "props": {
+        "style": {
+          "type": "style",
+          "description": "Layout and visual properties from the Box whitelist (flex, grid, sizes, spacing, colours)."
+        },
+        "pressable": {
+          "type": "boolean",
+          "description": "Makes the box a press target that fires `press`."
+        }
+      },
+      "events": [
+        "press"
+      ],
+      "example": {
+        "style": {
+          "display": "flex",
+          "flexDirection": "column",
+          "gap": "$spacing.md",
+          "padding": "$spacing.lg"
+        }
+      }
+    },
+    "Stack": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "description": "A flex container that lays its children out in one direction with a gap.",
+      "props": {
+        "direction": {
+          "type": "enum",
+          "enum": "orientation",
+          "default": "vertical",
+          "responsive": true,
+          "bindable": true,
+          "description": "A row or a column (`{base: \"vertical\", md: \"horizontal\"}`)."
+        },
+        "gap": {
+          "type": "enum",
+          "enum": "gap",
+          "default": "md",
+          "responsive": true,
+          "description": "The space between children."
+        },
+        "align": {
+          "type": "enum",
+          "enum": "align",
+          "responsive": true,
+          "bindable": true,
+          "description": "Unset: `center` in a row, `stretch` in a column."
+        },
+        "justify": {
+          "type": "enum",
+          "enum": "justify",
+          "default": "start",
+          "responsive": true,
+          "bindable": true,
+          "description": "Main-axis distribution."
+        },
+        "wrap": {
+          "type": "boolean",
+          "default": false,
+          "responsive": true,
+          "description": "Lets children wrap onto new lines."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles merged over the stack's own."
+        }
+      },
+      "example": {
+        "direction": "horizontal",
+        "gap": "sm"
+      }
+    },
+    "Grid": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "description": "An equal-column grid for cards and tiles.",
+      "props": {
+        "columns": {
+          "type": "number",
+          "default": 2,
+          "responsive": true,
+          "description": "Equal columns 1–6 (`{base: 1, md: 2, lg: 3}`)."
+        },
+        "gap": {
+          "type": "enum",
+          "enum": "gap",
+          "default": "md",
+          "responsive": true,
+          "description": "The space between cells."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles merged over the grid's own."
+        }
+      },
+      "example": {
+        "columns": 3,
+        "gap": "md"
+      }
+    },
+    "Card": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "description": "A bordered card with an optional title and description, for grouped content, not page headers.",
+      "props": {
+        "title": {
+          "type": "string",
+          "description": "The card heading."
+        },
+        "description": {
+          "type": "string",
+          "description": "A muted line under the heading."
+        },
+        "padded": {
+          "type": "boolean",
+          "default": true,
+          "description": "Pads the body; off for edge-to-edge rows."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles merged over the card's own."
+        }
+      },
+      "example": {
+        "title": "Overview",
+        "description": "Your account summary"
+      }
+    },
+    "Separator": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "none",
+      "description": "A hairline that divides content.",
+      "props": {
+        "orientation": {
+          "type": "enum",
+          "enum": "orientation",
+          "default": "horizontal",
+          "description": "A horizontal rule or a vertical bar."
+        }
+      },
+      "example": {
+        "orientation": "horizontal"
+      }
+    },
+    "List": {
+      "kind": "native",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "slots": [
+        "section"
+      ],
+      "slotScope": "row",
+      "description": "A windowed scrolling list for anything longer than a screen; children may come from a data template.",
+      "props": {
+        "direction": {
+          "type": "enum",
+          "enum": "listDirection",
+          "default": "vertical",
+          "description": "Scroll axis."
+        },
+        "gap": {
+          "type": "enum",
+          "enum": "gap",
+          "default": "none",
+          "description": "The space between items."
+        },
+        "divided": {
+          "type": "boolean",
+          "default": false,
+          "description": "Draws a hairline between items."
+        },
+        "sectionBy": {
+          "type": "string",
+          "description": "Groups consecutive items by this field; slot `section` = each header ({value, count})."
+        },
+        "stickyHeaders": {
+          "type": "boolean",
+          "default": false,
+          "description": "Pins the current section header."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles for the list frame."
+        }
+      },
+      "example": {
+        "direction": "vertical",
+        "divided": true
+      }
+    },
+    "Resizable": {
+      "kind": "native",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "description": "Panels split by draggable handles; each child is one panel.",
+      "props": {
+        "direction": {
+          "type": "enum",
+          "enum": "orientation",
+          "default": "horizontal",
+          "responsive": true,
+          "description": "Side by side or stacked."
+        },
+        "sizes": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "bindable": true,
+          "description": "Percent per panel; bind it."
+        },
+        "panels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "panel"
+          },
+          "description": "Per-panel limits, by index."
+        },
+        "handle": {
+          "type": "boolean",
+          "default": false,
+          "description": "Draws a grip on each handle."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles for the group box (give it a height)."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "direction": "horizontal",
+        "sizes": [
+          30,
+          70
+        ],
+        "handle": true
+      }
+    },
+    "ScrollArea": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "description": "A scrolling region of bounded height or width.",
+      "props": {
+        "direction": {
+          "type": "enum",
+          "enum": "scrollDirection",
+          "default": "vertical",
+          "description": "Which axis scrolls."
+        },
+        "maxHeight": {
+          "type": "number",
+          "description": "Px it scrolls within; omit to fill the parent."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles merged over the region's own."
+        }
+      },
+      "example": {
+        "direction": "vertical",
+        "maxHeight": 240
+      }
+    },
+    "Sidebar": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "slots": [
+        "sidebar"
+      ],
+      "description": "A two-column shell: a navigation column (`sidebar` slot) beside the children, hidden narrow or `collapsed`.",
+      "props": {
+        "side": {
+          "type": "enum",
+          "values": [
+            "left",
+            "right"
+          ],
+          "default": "left",
+          "description": "Which edge the column sits on."
+        },
+        "width": {
+          "type": "number",
+          "default": 240,
+          "description": "The column width in px."
+        },
+        "collapseBelow": {
+          "type": "enum",
+          "enum": "collapseBelow",
+          "default": "md",
+          "description": "Hides the column below this breakpoint."
+        },
+        "collapsed": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Hides the column at any width; bind it to a toggle."
+        }
+      },
+      "example": {
+        "side": "left",
+        "width": 240,
+        "collapseBelow": "md"
+      }
+    },
+    "SplitView": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "slots": [
+        "list"
+      ],
+      "description": "List (`list` slot) + detail (children); phones show one at a time, the detail with a back button.",
+      "props": {
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "On phones, the detail shows instead of the list; bind it to the open item."
+        },
+        "width": {
+          "type": "number",
+          "default": 320,
+          "description": "The list column width in px."
+        }
+      },
+      "events": [
+        "back"
+      ],
+      "example": {
+        "open": true,
+        "width": 320
+      }
+    },
+    "AppBar": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "none",
+      "slots": [
+        "leading",
+        "trailing"
+      ],
+      "description": "A top bar: title, optional subtitle and back button, `leading`/`trailing` slots.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The screen title."
+        },
+        "subtitle": {
+          "type": "string",
+          "bindable": true,
+          "description": "A muted line under the title."
+        },
+        "back": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows a back button that fires `back`."
+        }
+      },
+      "events": [
+        "back"
+      ],
+      "example": {
+        "title": "Settings",
+        "back": true
+      }
+    },
+    "Page": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "slots": [
+        "leading",
+        "trailing"
+      ],
+      "description": "A screen: an AppBar row (back, title, trailing actions) over a padded scrolling body.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The screen title."
+        },
+        "subtitle": {
+          "type": "string",
+          "bindable": true,
+          "description": "A muted line under the title."
+        },
+        "back": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows a back button that fires `back`."
+        },
+        "padded": {
+          "type": "boolean",
+          "default": true,
+          "description": "Pads the body; off for edge-to-edge lists."
+        }
+      },
+      "events": [
+        "back"
+      ],
+      "example": {
+        "title": "Settings",
+        "back": true
+      }
+    },
+    "Toolbar": {
+      "kind": "macro",
+      "group": "layout",
+      "lite": true,
+      "children": "many",
+      "slots": [
+        "trailing"
+      ],
+      "description": "Controls in one row, bottoms aligned, wrapping on phones; `trailing` = the end action.",
+      "props": {
+        "gap": {
+          "type": "enum",
+          "enum": "gap",
+          "default": "sm",
+          "description": "The space between controls."
+        }
+      },
+      "example": {
+        "gap": "sm"
+      }
+    },
+    "Section": {
+      "kind": "macro",
+      "group": "list",
+      "lite": true,
+      "children": "many",
+      "slots": [
+        "leading",
+        "trailing"
+      ],
+      "description": "A band header over hairline-divided rows: title, caption, count and glyph, foldable, tinted; no title = just the rows.",
+      "props": {
+        "title": {
+          "type": "string",
+          "bindable": true,
+          "description": "The band's label; omit it for a bare run of rows."
+        },
+        "caption": {
+          "type": "string",
+          "bindable": true,
+          "description": "Muted text after the title."
+        },
+        "count": {
+          "type": "number",
+          "bindable": true,
+          "description": "A count after the title; off unless given."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "A glyph before the title (the `leading` slot replaces it)."
+        },
+        "collapsible": {
+          "type": "boolean",
+          "default": false,
+          "description": "The header folds the rows (chevron, press)."
+        },
+        "open": {
+          "type": "boolean",
+          "default": true,
+          "bindable": true,
+          "description": "Whether the rows show; bind it."
+        },
+        "tint": {
+          "type": "enum",
+          "enum": "tone",
+          "default": "neutral",
+          "description": "The band's colour tone."
+        },
+        "tree": {
+          "type": "boolean",
+          "default": false,
+          "description": "The rows form a tree: each `Row.depth` indents and draws its guides."
+        },
+        "loading": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "A refetch is running: a small spinner before the count. The first load is a Skeleton instead."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles for the frame."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "title": "In progress",
+        "icon": "nav-issues"
+      }
+    },
+    "Group": {
+      "kind": "macro",
+      "group": "list",
+      "lite": true,
+      "children": "many",
+      "description": "A form-field container: a rounded group of rows with an optional title and footnote.",
+      "props": {
+        "title": {
+          "type": "string",
+          "description": "A caption above the group."
+        },
+        "footer": {
+          "type": "string",
+          "description": "A muted note under the group."
+        }
+      },
+      "example": {
+        "title": "Notifications"
+      }
+    },
+    "Text": {
+      "kind": "native",
+      "group": "text",
+      "lite": true,
+      "children": "none",
+      "description": "A run of text in one of the type styles; prefer dedicated components over inline markdown.",
+      "props": {
+        "text": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The text to show."
+        },
+        "variant": {
+          "type": "enum",
+          "enum": "textVariant",
+          "default": "body",
+          "description": "The type style."
+        },
+        "align": {
+          "type": "enum",
+          "values": [
+            "start",
+            "center",
+            "end"
+          ],
+          "description": "Horizontal alignment inside its box."
+        },
+        "lines": {
+          "type": "number",
+          "description": "Truncates to this many lines with an ellipsis."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "description": "A colour tone instead of the default foreground."
+        },
+        "shimmer": {
+          "type": "boolean",
+          "default": false,
+          "description": "Animates a highlight across the text while work runs."
+        },
+        "live": {
+          "type": "enum",
+          "enum": "live",
+          "default": "off",
+          "description": "Announces changes (`assertive` interrupts)."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles for the text box."
+        }
+      },
+      "example": {
+        "text": "Hello, world!",
+        "variant": "body"
+      }
+    },
+    "Heading": {
+      "kind": "macro",
+      "group": "text",
+      "lite": true,
+      "children": "none",
+      "description": "A section or page heading at one of four levels.",
+      "props": {
+        "text": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The heading text."
+        },
+        "level": {
+          "type": "enum",
+          "enum": "headingLevel",
+          "default": "h2",
+          "description": "h1 is the page title, h4 the smallest."
+        }
+      },
+      "example": {
+        "text": "Welcome",
+        "level": "h1"
+      }
+    },
+    "Markdown": {
+      "kind": "native",
+      "group": "text",
+      "lite": true,
+      "children": "none",
+      "description": "Rendered GitHub-flavoured markdown, for prose.",
+      "props": {
+        "text": {
+          "type": "markdown",
+          "required": true,
+          "bindable": true,
+          "description": "The GFM source."
+        },
+        "lines": {
+          "type": "number",
+          "description": "Truncates the rendered body to this many lines with an ellipsis."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles for the markdown box."
+        }
+      },
+      "example": {
+        "text": "**Bold** and a list:\n\n- one\n- two"
+      }
+    },
+    "CodeBlock": {
+      "kind": "native",
+      "group": "text",
+      "lite": true,
+      "children": "none",
+      "description": "Source code in a mono block: syntax colouring, optional line numbers, a copy button.",
+      "props": {
+        "code": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The source text."
+        },
+        "language": {
+          "type": "enum",
+          "enum": "codeLanguage",
+          "default": "plain",
+          "description": "The syntax colouring."
+        },
+        "title": {
+          "type": "string",
+          "description": "A header line (a file name)."
+        },
+        "lineNumbers": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows a line-number gutter."
+        },
+        "wrap": {
+          "type": "boolean",
+          "default": false,
+          "description": "Wraps long lines instead of scrolling sideways."
+        },
+        "copyable": {
+          "type": "boolean",
+          "default": true,
+          "description": "Shows the copy-to-clipboard button."
+        },
+        "highlight": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "description": "1-based line numbers to emphasise."
+        },
+        "maxLines": {
+          "type": "number",
+          "description": "Lines shown before the block scrolls."
+        },
+        "variant": {
+          "type": "enum",
+          "enum": "codeBlockVariant",
+          "default": "default",
+          "bindable": true,
+          "description": "destructive = failed output."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "codeBlockSize",
+          "default": "default",
+          "description": "sm = compact."
+        }
+      },
+      "example": {
+        "code": "const answer = 42 // the answer",
+        "language": "ts",
+        "lineNumbers": true
+      }
+    },
+    "Kbd": {
+      "kind": "macro",
+      "group": "text",
+      "lite": true,
+      "children": "none",
+      "description": "A keyboard shortcut drawn as a key cap.",
+      "props": {
+        "keys": {
+          "type": "string",
+          "required": true,
+          "description": "The shortcut text (`⌘K`, `Ctrl+Shift+P`)."
+        }
+      },
+      "example": {
+        "keys": "⌘K"
+      }
+    },
+    "Label": {
+      "kind": "macro",
+      "group": "text",
+      "lite": true,
+      "children": "none",
+      "description": "A caption for a control that has no label of its own, with an optional required mark.",
+      "props": {
+        "text": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The caption."
+        },
+        "for": {
+          "type": "string",
+          "description": "The id of the control it labels."
+        },
+        "required": {
+          "type": "boolean",
+          "default": false,
+          "description": "Adds the required mark."
+        }
+      },
+      "example": {
+        "text": "Visibility",
+        "for": "visibility"
+      }
+    },
+    "Image": {
+      "kind": "native",
+      "group": "media",
+      "lite": false,
+      "children": "none",
+      "description": "A picture from a URL, or a placeholder box when it has none.",
+      "props": {
+        "src": {
+          "type": "url",
+          "bindable": true,
+          "description": "The image URL; omit for a placeholder."
+        },
+        "alt": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The accessibility description."
+        },
+        "fit": {
+          "type": "enum",
+          "enum": "imageFit",
+          "default": "cover",
+          "description": "How the picture fills its box."
+        },
+        "width": {
+          "type": "number",
+          "description": "Fixed width in px; otherwise the box decides."
+        },
+        "height": {
+          "type": "number",
+          "description": "Fixed height in px."
+        },
+        "aspectRatio": {
+          "type": "number",
+          "description": "Width over height (16:9 when unset and no height); the box never waits for the picture."
+        },
+        "fallback": {
+          "type": "icon",
+          "description": "An icon shown when the picture fails or is missing."
+        },
+        "loading": {
+          "type": "enum",
+          "enum": "imageLoading",
+          "default": "lazy",
+          "description": "Defer loading until near the viewport, or load at once."
+        },
+        "focalX": {
+          "type": "number",
+          "description": "Horizontal focal point 0..1 kept when cropped (0.5)."
+        },
+        "focalY": {
+          "type": "number",
+          "description": "Vertical focal point 0..1 kept when cropped (0.5)."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles for the image box."
+        }
+      },
+      "example": {
+        "src": "https://example.com/cover.jpg",
+        "alt": "Cover",
+        "fit": "cover",
+        "aspectRatio": 1.7777778
+      }
+    },
+    "Icon": {
+      "kind": "native",
+      "group": "media",
+      "lite": true,
+      "children": "none",
+      "description": "One icon from the shared Lucide registry, by name.",
+      "props": {
+        "name": {
+          "type": "icon",
+          "required": true,
+          "bindable": true,
+          "description": "The icon name (an icons.json concept or Lucide name)."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "controlSize",
+          "default": "default",
+          "description": "Glyph size."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "bindable": true,
+          "description": "A colour tone instead of the current text colour."
+        },
+        "label": {
+          "type": "string",
+          "description": "An accessibility label when the icon stands alone."
+        }
+      },
+      "example": {
+        "name": "ui-check",
+        "size": "default"
+      }
+    },
+    "Video": {
+      "kind": "native",
+      "group": "media",
+      "lite": false,
+      "children": "none",
+      "description": "A video player: the poster until play, then the platform player with its controls.",
+      "props": {
+        "src": {
+          "type": "url",
+          "required": true,
+          "bindable": true,
+          "description": "The video URL (H.264 + AAC MP4 plays everywhere)."
+        },
+        "poster": {
+          "type": "url",
+          "description": "A still shown before playback."
+        },
+        "durationMs": {
+          "type": "number",
+          "description": "Known length for the scrubber."
+        },
+        "autoplay": {
+          "type": "boolean",
+          "default": false,
+          "description": "Starts muted playback on appear."
+        },
+        "aspectRatio": {
+          "type": "number",
+          "default": 1.7777778,
+          "description": "Width over height of the player box."
+        },
+        "style": {
+          "type": "style",
+          "description": "Extra Box styles for the player box."
+        }
+      },
+      "example": {
+        "src": "https://example.com/clip.mp4",
+        "durationMs": 12000
+      }
+    },
+    "AudioPlayer": {
+      "kind": "native",
+      "group": "media",
+      "lite": false,
+      "children": "none",
+      "description": "An audio player with a title and a play control.",
+      "props": {
+        "src": {
+          "type": "url",
+          "required": true,
+          "bindable": true,
+          "description": "The audio URL."
+        },
+        "title": {
+          "type": "string",
+          "description": "What is playing."
+        },
+        "durationMs": {
+          "type": "number",
+          "description": "Known length for the scrubber."
+        }
+      },
+      "example": {
+        "src": "https://example.com/track.mp3",
+        "title": "Episode 12"
+      }
+    },
+    "Avatar": {
+      "kind": "native",
+      "group": "media",
+      "lite": true,
+      "children": "none",
+      "description": "A round user picture that falls back to initials on a stable hue.",
+      "props": {
+        "name": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The person's name; initials come from it."
+        },
+        "src": {
+          "type": "url",
+          "bindable": true,
+          "description": "The picture URL."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "controlSize",
+          "default": "default",
+          "description": "Diameter class."
+        },
+        "seed": {
+          "type": "string",
+          "description": "Hashes the fallback hue; defaults to the name."
+        }
+      },
+      "example": {
+        "name": "Jane Doe",
+        "size": "default"
+      }
+    },
+    "Carousel": {
+      "kind": "native",
+      "group": "media",
+      "lite": false,
+      "children": "many",
+      "description": "A horizontally paging scroller; each child is one page.",
+      "props": {
+        "page": {
+          "type": "number",
+          "default": 0,
+          "bindable": true,
+          "description": "The active page index."
+        },
+        "loop": {
+          "type": "boolean",
+          "default": false,
+          "description": "Wraps from the last page to the first."
+        },
+        "indicators": {
+          "type": "boolean",
+          "default": true,
+          "description": "Shows the page dots."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "page": 0,
+        "indicators": true
+      }
+    },
+    "Tabs": {
+      "kind": "native",
+      "group": "navigation",
+      "lite": true,
+      "children": "many",
+      "description": "Tab navigation; the child at index i is the panel of tab i.",
+      "props": {
+        "tabs": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "tab"
+          },
+          "required": true,
+          "description": "The tab headers in order."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The active tab's value; bind it for two-way state."
+        },
+        "fill": {
+          "type": "boolean",
+          "default": false,
+          "description": "Stretches the headers across the width."
+        },
+        "closable": {
+          "type": "enum",
+          "enum": "tabClosable",
+          "default": "none",
+          "description": "Close glyphs firing `close`; `hover` = on hover."
+        },
+        "addable": {
+          "type": "boolean",
+          "default": false,
+          "description": "A + button firing `new`."
+        }
+      },
+      "events": [
+        "change",
+        "close",
+        "new"
+      ],
+      "example": {
+        "tabs": [
+          {
+            "label": "Issue",
+            "value": "issue"
+          },
+          {
+            "label": "Run",
+            "value": "run"
+          }
+        ],
+        "value": "issue"
+      }
+    },
+    "Segmented": {
+      "kind": "native",
+      "group": "navigation",
+      "lite": true,
+      "children": "none",
+      "description": "ONE row of segments picking one or many values: a pill track, toggles, joined outline buttons or a bottom bar.",
+      "props": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "option"
+          },
+          "required": true,
+          "description": "The segments in order."
+        },
+        "type": {
+          "type": "enum",
+          "enum": "groupType",
+          "default": "single",
+          "description": "One active value or several."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The selected value (comma-joined when multiple); bind it."
+        },
+        "variant": {
+          "type": "enum",
+          "enum": "segmentedVariant",
+          "default": "segmented",
+          "description": "Pill track, bare toggles, joined outline buttons, or a full-width icon `bar`."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "controlSize",
+          "default": "default",
+          "description": "Control height class."
+        },
+        "fill": {
+          "type": "boolean",
+          "default": false,
+          "description": "Stretches the segments across the width (a `bar` always does)."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "items": [
+          {
+            "label": "List",
+            "value": "list"
+          },
+          {
+            "label": "Board",
+            "value": "board"
+          }
+        ],
+        "value": "list"
+      }
+    },
+    "Accordion": {
+      "kind": "native",
+      "group": "navigation",
+      "lite": false,
+      "children": "many",
+      "description": "Collapsible sections; the child at index i is the body of item i.",
+      "props": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "accordionItem"
+          },
+          "required": true,
+          "description": "The section headers in order."
+        },
+        "type": {
+          "type": "enum",
+          "enum": "groupType",
+          "default": "single",
+          "description": "One section open at a time, or any number."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The open section's value (comma-joined when multiple); bind it."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "items": [
+          {
+            "title": "Details",
+            "value": "details"
+          }
+        ],
+        "type": "single",
+        "value": "details"
+      }
+    },
+    "Collapsible": {
+      "kind": "macro",
+      "group": "navigation",
+      "lite": true,
+      "children": "many",
+      "description": "One disclosure section with a title row that shows or hides its children.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "description": "The header text."
+        },
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Whether the body shows; bind it."
+        },
+        "count": {
+          "type": "number",
+          "description": "A count shown in the header."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "title": "Advanced",
+        "open": false
+      }
+    },
+    "Trace": {
+      "kind": "macro",
+      "group": "list",
+      "lite": true,
+      "children": "many",
+      "description": "A column of TraceItem lines (an agent's steps).",
+      "props": {
+        "size": {
+          "type": "enum",
+          "enum": "traceSize",
+          "default": "default",
+          "description": "Line spacing; match the items."
+        }
+      },
+      "example": {
+        "size": "default"
+      }
+    },
+    "TraceItem": {
+      "kind": "macro",
+      "group": "list",
+      "lite": true,
+      "children": "many",
+      "description": "One step line: icon, title, muted detail; may expand to show its children.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "What happened."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "The lead glyph."
+        },
+        "description": {
+          "type": "string",
+          "description": "A muted detail (a duration)."
+        },
+        "status": {
+          "type": "enum",
+          "enum": "traceStatus",
+          "description": "running shimmers, error tints, pending dims."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "traceSize",
+          "default": "default",
+          "description": "sm = compact."
+        },
+        "collapsible": {
+          "type": "boolean",
+          "default": false,
+          "description": "The line toggles its children."
+        },
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Whether the children show; bind it."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "title": "Ran bun test",
+        "icon": "trace-terminal",
+        "description": "4s",
+        "collapsible": true,
+        "open": true
+      }
+    },
+    "Pagination": {
+      "kind": "macro",
+      "group": "navigation",
+      "lite": false,
+      "children": "none",
+      "description": "Previous, next and the current page out of a total.",
+      "props": {
+        "totalPages": {
+          "type": "number",
+          "required": true,
+          "description": "How many pages there are."
+        },
+        "page": {
+          "type": "number",
+          "default": 1,
+          "bindable": true,
+          "description": "The current 1-based page; bind it."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "totalPages": 5,
+        "page": 2
+      }
+    },
+    "Breadcrumb": {
+      "kind": "macro",
+      "group": "navigation",
+      "lite": true,
+      "children": "none",
+      "description": "The path to the current page; every item but the last is a link firing `select`.",
+      "props": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "option"
+          },
+          "required": true,
+          "description": "The path from the root to the current page."
+        }
+      },
+      "events": [
+        "select"
+      ],
+      "example": {
+        "items": [
+          {
+            "label": "Boards",
+            "value": "boards"
+          },
+          {
+            "label": "Sprint 12",
+            "value": "sprint-12"
+          },
+          {
+            "label": "EXP-42",
+            "value": "exp-42"
+          }
+        ]
+      }
+    },
+    "Stepper": {
+      "kind": "macro",
+      "group": "navigation",
+      "lite": true,
+      "children": "none",
+      "description": "Wizard progress: numbered steps, finished ones ticked.",
+      "props": {
+        "steps": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "step"
+          },
+          "required": true,
+          "description": "The steps in order."
+        },
+        "current": {
+          "type": "number",
+          "default": 0,
+          "bindable": true,
+          "description": "The 0-based index of the active step."
+        },
+        "orientation": {
+          "type": "enum",
+          "enum": "orientation",
+          "default": "horizontal",
+          "description": "In a row or stacked."
+        }
+      },
+      "example": {
+        "steps": [
+          {
+            "label": "Account"
+          },
+          {
+            "label": "Team"
+          },
+          {
+            "label": "Done"
+          }
+        ],
+        "current": 1
+      }
+    },
+    "Dialog": {
+      "kind": "native",
+      "group": "overlay",
+      "lite": false,
+      "children": "many",
+      "slots": [
+        "trigger",
+        "footer"
+      ],
+      "description": "A centred modal over the surface, opened by its trigger slot or by binding `open`.",
+      "props": {
+        "title": {
+          "type": "string",
+          "description": "The dialog heading."
+        },
+        "description": {
+          "type": "string",
+          "description": "A muted line under the heading."
+        },
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Whether it shows; bind it to a boolean path."
+        },
+        "dismissible": {
+          "type": "boolean",
+          "default": true,
+          "description": "Closes on the backdrop or Escape."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "title": "Delete board?",
+        "description": "This cannot be undone.",
+        "open": false
+      }
+    },
+    "Drawer": {
+      "kind": "native",
+      "group": "overlay",
+      "lite": false,
+      "children": "many",
+      "slots": [
+        "trigger",
+        "footer"
+      ],
+      "description": "A panel sliding in from an edge (a bottom sheet on phones).",
+      "props": {
+        "title": {
+          "type": "string",
+          "description": "The drawer heading."
+        },
+        "description": {
+          "type": "string",
+          "description": "A muted line under the heading."
+        },
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Whether it shows; bind it to a boolean path."
+        },
+        "side": {
+          "type": "enum",
+          "enum": "side",
+          "default": "bottom",
+          "responsive": true,
+          "description": "The edge it slides from; `{base: \"bottom\", md: \"right\"}` turns the phone sheet into a side panel on wide surfaces."
+        },
+        "dismissible": {
+          "type": "boolean",
+          "default": true,
+          "description": "Closes on the backdrop or Escape."
+        },
+        "dragToDismiss": {
+          "type": "boolean",
+          "default": true,
+          "description": "Lets a swipe toward its edge close it."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "title": "Filters",
+        "side": "bottom",
+        "open": false
+      }
+    },
+    "DockCard": {
+      "kind": "macro",
+      "group": "overlay",
+      "lite": false,
+      "children": "many",
+      "slots": [
+        "footer"
+      ],
+      "description": "A floating one-row card whose children open in a bottom sheet with a pinned footer.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The tinted header word."
+        },
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The one line under the header."
+        },
+        "caption": {
+          "type": "string",
+          "bindable": true,
+          "description": "Muted text after the label."
+        },
+        "meta": {
+          "type": "string",
+          "bindable": true,
+          "description": "Muted text at the header's end."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "The glyph before the label."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "default": "neutral",
+          "description": "The glyph's and the label's tone."
+        },
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Whether the sheet shows; bind it."
+        }
+      },
+      "events": [
+        "press",
+        "change"
+      ],
+      "example": {
+        "label": "Plan ready",
+        "caption": "Ask dock",
+        "meta": "3 questions",
+        "title": "Fold the composer into the Dock",
+        "icon": "coding-plan",
+        "tone": "primary"
+      }
+    },
+    "AlertDialog": {
+      "kind": "macro",
+      "group": "overlay",
+      "lite": false,
+      "children": "many",
+      "slots": [
+        "trigger"
+      ],
+      "description": "A modal that asks for a confirmation and ignores clicks outside; fires `confirm` or `cancel`.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "description": "The question."
+        },
+        "description": {
+          "type": "string",
+          "description": "What will happen."
+        },
+        "confirmLabel": {
+          "type": "string",
+          "default": "$string.confirm",
+          "description": "The confirming button's text."
+        },
+        "cancelLabel": {
+          "type": "string",
+          "default": "$string.cancel",
+          "description": "The cancelling button's text."
+        },
+        "destructive": {
+          "type": "boolean",
+          "default": false,
+          "description": "Styles the confirming button as dangerous."
+        },
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Whether it shows; bind it."
+        }
+      },
+      "events": [
+        "confirm",
+        "cancel",
+        "change"
+      ],
+      "example": {
+        "title": "Delete board?",
+        "description": "This cannot be undone.",
+        "destructive": true
+      }
+    },
+    "Popover": {
+      "kind": "native",
+      "group": "overlay",
+      "lite": false,
+      "children": "many",
+      "slots": [
+        "trigger"
+      ],
+      "description": "A small panel anchored to its trigger, opened on press.",
+      "props": {
+        "open": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Whether it shows; bind it."
+        },
+        "side": {
+          "type": "enum",
+          "enum": "side",
+          "default": "bottom",
+          "description": "Preferred side of the trigger."
+        },
+        "openOn": {
+          "type": "enum",
+          "enum": "openOn",
+          "default": "press",
+          "description": "Press, or hover over the trigger (press on touch)."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "side": "bottom"
+      }
+    },
+    "Tooltip": {
+      "kind": "native",
+      "group": "overlay",
+      "lite": false,
+      "children": "many",
+      "description": "A short hint shown on hover or long-press over its children.",
+      "props": {
+        "content": {
+          "type": "string",
+          "required": true,
+          "description": "The hint text."
+        },
+        "side": {
+          "type": "enum",
+          "enum": "side",
+          "default": "top",
+          "description": "Preferred side of the anchor."
+        }
+      },
+      "example": {
+        "content": "Copy link"
+      }
+    },
+    "Menu": {
+      "kind": "native",
+      "group": "overlay",
+      "lite": false,
+      "children": "one",
+      "description": "A menu of actions, checkboxes, groups and submenus, opened by pressing its child or right-click / long-press.",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The default trigger's text when no child is given."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "The default trigger's icon."
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "menuItem"
+          },
+          "required": true,
+          "description": "The entries in order."
+        },
+        "openOn": {
+          "type": "enum",
+          "enum": "menuOpenOn",
+          "default": "press",
+          "description": "A press on the child, or the context gesture over it."
+        }
+      },
+      "events": [
+        "select"
+      ],
+      "example": {
+        "label": "More",
+        "items": [
+          {
+            "label": "Rename",
+            "value": "rename"
+          },
+          {
+            "label": "Delete",
+            "value": "delete",
+            "destructive": true
+          }
+        ]
+      }
+    },
+    "Toast": {
+      "kind": "native",
+      "group": "overlay",
+      "lite": false,
+      "children": "none",
+      "description": "A transient notice in the toast layer; render one per notice with `open` bound.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The notice."
+        },
+        "description": {
+          "type": "string",
+          "bindable": true,
+          "description": "Detail under the notice."
+        },
+        "type": {
+          "type": "enum",
+          "enum": "alertType",
+          "default": "info",
+          "description": "Severity: icon and tone (`error` interrupts readers)."
+        },
+        "open": {
+          "type": "boolean",
+          "default": true,
+          "bindable": true,
+          "description": "Whether it shows; bind it so the host learns of a dismissal."
+        },
+        "duration": {
+          "type": "number",
+          "default": 5000,
+          "description": "Ms until it dismisses itself; 0 = never."
+        },
+        "actionLabel": {
+          "type": "string",
+          "description": "A button label; pressing it fires `action`."
+        },
+        "dismissible": {
+          "type": "boolean",
+          "default": true,
+          "description": "Shows the close control."
+        }
+      },
+      "events": [
+        "dismiss",
+        "action",
+        "change"
+      ],
+      "example": {
+        "title": "Couldn't save the board",
+        "description": "The server did not answer.",
+        "type": "error",
+        "actionLabel": "Retry"
+      }
+    },
+    "Badge": {
+      "kind": "macro",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "description": "A small count or status label.",
+      "props": {
+        "text": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The label or number."
+        },
+        "variant": {
+          "type": "enum",
+          "enum": "variant",
+          "default": "default",
+          "bindable": true,
+          "description": "Filled, secondary, outlined or destructive."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "An icon before the text."
+        }
+      },
+      "example": {
+        "text": "Active",
+        "variant": "default"
+      }
+    },
+    "Alert": {
+      "kind": "macro",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "description": "An inline banner with an icon, a title and a message.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "description": "The banner heading."
+        },
+        "message": {
+          "type": "string",
+          "description": "The detail under the heading."
+        },
+        "type": {
+          "type": "enum",
+          "enum": "alertType",
+          "default": "info",
+          "description": "The severity, which picks the icon and tone."
+        }
+      },
+      "example": {
+        "title": "Saved",
+        "message": "Your changes have been saved.",
+        "type": "success"
+      }
+    },
+    "Chip": {
+      "kind": "macro",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "slots": [
+        "leading"
+      ],
+      "description": "A small token: a pill (filter, label, state) or a rect naming an entity with a glyph or image; removable.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The chip text."
+        },
+        "shape": {
+          "type": "enum",
+          "enum": "chipShape",
+          "default": "pill",
+          "description": "A rounded pill or a squarer entity chip."
+        },
+        "selected": {
+          "type": "boolean",
+          "default": false,
+          "description": "Draws it as the active choice."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "default": "neutral",
+          "bindable": true,
+          "description": "Colour tone of the chip."
+        },
+        "dot": {
+          "type": "color",
+          "description": "A colour dot before the text (a label chip)."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "An icon before the text."
+        },
+        "image": {
+          "type": "url",
+          "description": "A round picture instead of the icon."
+        },
+        "detail": {
+          "type": "string",
+          "description": "Muted text after the label."
+        },
+        "removable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows a remove control that fires `remove`."
+        },
+        "pressable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Makes it a press target that fires `press`."
+        }
+      },
+      "events": [
+        "press",
+        "remove"
+      ],
+      "example": {
+        "label": "Drafts",
+        "selected": true
+      }
+    },
+    "EmptyState": {
+      "kind": "macro",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "description": "What an empty screen or list says: a short title; `page` adds the icon disc, a sentence and an action, `list` one muted line.",
+      "props": {
+        "icon": {
+          "type": "icon",
+          "required": true,
+          "description": "The glyph: in the disc on `page`, bare on `list`."
+        },
+        "title": {
+          "type": "string",
+          "required": true,
+          "description": "What is empty."
+        },
+        "description": {
+          "type": "string",
+          "description": "The next step, `page` only."
+        },
+        "actionLabel": {
+          "type": "string",
+          "description": "A button label, `page` only; pressing it fires `press`."
+        },
+        "size": {
+          "type": "enum",
+          "values": [
+            "page",
+            "list"
+          ],
+          "default": "page",
+          "description": "page = a whole screen's empty state with disc, sentence and action; list = one muted line under a bare glyph, no description, no action."
+        }
+      },
+      "events": [
+        "press"
+      ],
+      "example": {
+        "icon": "nav-inbox",
+        "title": "No notifications",
+        "description": "You are all caught up."
+      }
+    },
+    "Progress": {
+      "kind": "macro",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "description": "A horizontal progress bar with an optional label.",
+      "props": {
+        "value": {
+          "type": "number",
+          "required": true,
+          "bindable": true,
+          "description": "The current amount, 0 to max."
+        },
+        "max": {
+          "type": "number",
+          "default": 100,
+          "description": "The full amount."
+        },
+        "label": {
+          "type": "string",
+          "description": "A caption above the bar."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "default": "primary",
+          "description": "The fill colour tone."
+        }
+      },
+      "example": {
+        "value": 65,
+        "max": 100,
+        "label": "Upload"
+      }
+    },
+    "Meter": {
+      "kind": "macro",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "description": "A usage track: a bar of coloured segments against a maximum, with a caption and a value.",
+      "props": {
+        "segments": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "segment"
+          },
+          "required": true,
+          "description": "The slices in order."
+        },
+        "max": {
+          "type": "number",
+          "default": 100,
+          "description": "The full amount."
+        },
+        "label": {
+          "type": "string",
+          "description": "A caption before the track."
+        },
+        "value": {
+          "type": "string",
+          "description": "A formatted value after the track."
+        }
+      },
+      "example": {
+        "segments": [
+          {
+            "value": 40,
+            "tone": "primary"
+          },
+          {
+            "value": 25,
+            "tone": "warning"
+          }
+        ],
+        "max": 100,
+        "label": "Storage",
+        "value": "650 MB of 1 GB"
+      }
+    },
+    "Ring": {
+      "kind": "native",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "description": "A circular progress ring for a fraction, sized like an icon.",
+      "props": {
+        "value": {
+          "type": "number",
+          "required": true,
+          "bindable": true,
+          "description": "The fraction 0 to 1."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "controlSize",
+          "default": "default",
+          "description": "Diameter class."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "default": "primary",
+          "description": "The arc colour tone."
+        },
+        "label": {
+          "type": "string",
+          "description": "An accessibility label."
+        }
+      },
+      "example": {
+        "value": 0.62,
+        "tone": "primary"
+      }
+    },
+    "Spinner": {
+      "kind": "native",
+      "group": "feedback",
+      "lite": false,
+      "children": "none",
+      "description": "An indeterminate activity indicator.",
+      "props": {
+        "size": {
+          "type": "enum",
+          "enum": "spinnerSize",
+          "default": "default",
+          "description": "Diameter class; `xs` = inline in a header."
+        },
+        "label": {
+          "type": "string",
+          "description": "A caption or accessibility label."
+        }
+      },
+      "example": {
+        "size": "default"
+      }
+    },
+    "Skeleton": {
+      "kind": "native",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "description": "A pulsing placeholder: a block, or `rows` rows.",
+      "props": {
+        "width": {
+          "type": "string",
+          "description": "A length (px or %); defaults to the full width."
+        },
+        "height": {
+          "type": "string",
+          "description": "A length (px); defaults to one text line."
+        },
+        "rounded": {
+          "type": "boolean",
+          "default": false,
+          "description": "A circle instead of a bar."
+        },
+        "rows": {
+          "type": "number",
+          "description": "Rows instead of a block."
+        },
+        "rowHeight": {
+          "type": "number",
+          "description": "A row's height in px."
+        },
+        "dot": {
+          "type": "boolean",
+          "default": true,
+          "description": "A dot per row."
+        }
+      },
+      "example": {
+        "width": "60%",
+        "height": "16px"
+      }
+    },
+    "Table": {
+      "kind": "native",
+      "group": "data",
+      "lite": false,
+      "children": "none",
+      "slots": [
+        "*"
+      ],
+      "slotScope": "row",
+      "description": "A data table of typed columns: sorting, selection, widths, alignment, windowed; `slot` columns render components.",
+      "props": {
+        "columns": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "column"
+          },
+          "required": true,
+          "description": "The columns in order."
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "object"
+          },
+          "required": true,
+          "bindable": true,
+          "description": "One object per row keyed by column key; bind it for live data."
+        },
+        "rowKey": {
+          "type": "string",
+          "default": "id",
+          "description": "The row field that identifies a row."
+        },
+        "sort": {
+          "type": "object",
+          "shape": "sort",
+          "bindable": true,
+          "description": "The active sort; bound = you order `rows`, unbound = sorted locally."
+        },
+        "selectable": {
+          "type": "enum",
+          "enum": "selectable",
+          "default": "none",
+          "description": "Row selection (many = a checkbox column)."
+        },
+        "selected": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "bindable": true,
+          "description": "The selected row keys; bind them."
+        },
+        "caption": {
+          "type": "string",
+          "description": "A caption under the table."
+        },
+        "emptyText": {
+          "type": "string",
+          "default": "$string.noResults",
+          "description": "Shown when there are no rows."
+        },
+        "striped": {
+          "type": "boolean",
+          "default": false,
+          "description": "Alternates row fills."
+        },
+        "density": {
+          "type": "enum",
+          "enum": "density",
+          "default": "default",
+          "description": "Row height class."
+        },
+        "stickyHeader": {
+          "type": "boolean",
+          "default": false,
+          "description": "Keeps the header visible while the rows scroll."
+        }
+      },
+      "events": [
+        "sort",
+        "select",
+        "rowPress"
+      ],
+      "example": {
+        "columns": [
+          {
+            "key": "name",
+            "label": "Name"
+          },
+          {
+            "key": "role",
+            "label": "Role"
+          },
+          {
+            "key": "runs",
+            "label": "Runs",
+            "type": "number",
+            "sortable": true,
+            "align": "end"
+          }
+        ],
+        "rows": [
+          {
+            "id": "a",
+            "name": "Alice",
+            "role": "Owner",
+            "runs": 12
+          },
+          {
+            "id": "b",
+            "name": "Bob",
+            "role": "Member",
+            "runs": 3
+          }
+        ]
+      }
+    },
+    "Chart": {
+      "kind": "native",
+      "group": "data",
+      "lite": false,
+      "children": "none",
+      "description": "A bar, stacked-bar, line, area, pie, donut or sparkline chart with axes, legend and tooltip.",
+      "props": {
+        "kind": {
+          "type": "enum",
+          "enum": "chartKind",
+          "required": true,
+          "description": "The chart form."
+        },
+        "categories": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "bindable": true,
+          "description": "The x-axis labels, or the pie slices; omit for a sparkline."
+        },
+        "series": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "series"
+          },
+          "required": true,
+          "bindable": true,
+          "description": "One per line, bar group or pie ring."
+        },
+        "title": {
+          "type": "string",
+          "description": "A title above the chart."
+        },
+        "height": {
+          "type": "number",
+          "default": 200,
+          "description": "The whole chart's height in px (title, legend, axes inside); the width is the box's."
+        },
+        "xLabel": {
+          "type": "string",
+          "description": "A caption under the x axis."
+        },
+        "yLabel": {
+          "type": "string",
+          "description": "A caption beside the y axis."
+        },
+        "min": {
+          "type": "number",
+          "description": "The y-axis floor; defaults to 0."
+        },
+        "max": {
+          "type": "number",
+          "description": "The y-axis ceiling; defaults to the largest value."
+        },
+        "showAxes": {
+          "type": "boolean",
+          "default": true,
+          "description": "Draws the axes with tick labels."
+        },
+        "showGrid": {
+          "type": "boolean",
+          "default": true,
+          "description": "Draws horizontal grid lines at the ticks."
+        },
+        "showLegend": {
+          "type": "boolean",
+          "default": true,
+          "description": "Draws the legend (2+ series or slices)."
+        },
+        "showValues": {
+          "type": "boolean",
+          "default": false,
+          "description": "Writes each value on its bar, point or slice."
+        }
+      },
+      "example": {
+        "kind": "bar",
+        "categories": [
+          "Mon",
+          "Tue"
+        ],
+        "series": [
+          {
+            "name": "Runs",
+            "values": [
+              3,
+              5
+            ]
+          }
+        ]
+      }
+    },
+    "Sparkline": {
+      "kind": "macro",
+      "group": "data",
+      "lite": false,
+      "children": "none",
+      "description": "A tiny inline trend line of recent values, no axes or legend.",
+      "props": {
+        "values": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "required": true,
+          "bindable": true,
+          "description": "The points, oldest first."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "default": "primary",
+          "description": "The line colour tone."
+        },
+        "height": {
+          "type": "number",
+          "default": 24,
+          "description": "The height in px."
+        }
+      },
+      "example": {
+        "values": [
+          1,
+          3,
+          2,
+          5,
+          4
+        ]
+      }
+    },
+    "StatTile": {
+      "kind": "macro",
+      "group": "data",
+      "lite": true,
+      "children": "none",
+      "description": "A dashboard tile: label, big value, toned change, trend sparkline.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "What is measured."
+        },
+        "value": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The formatted value."
+        },
+        "delta": {
+          "type": "string",
+          "bindable": true,
+          "description": "The change (`+12 %`)."
+        },
+        "tone": {
+          "type": "enum",
+          "enum": "tone",
+          "default": "neutral",
+          "bindable": true,
+          "description": "The change's tone."
+        },
+        "trend": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "bindable": true,
+          "description": "Recent values (sparkline)."
+        }
+      },
+      "example": {
+        "label": "Active users",
+        "value": "1,284",
+        "delta": "+12 %",
+        "tone": "success",
+        "trend": [
+          3,
+          4,
+          3,
+          5,
+          6,
+          8
+        ]
+      }
+    },
+    "Button": {
+      "kind": "native",
+      "group": "action",
+      "lite": true,
+      "children": "one",
+      "description": "A press target with a label and optional icon (or one custom child).",
+      "props": {
+        "label": {
+          "type": "string",
+          "bindable": true,
+          "description": "The button text (omit for an icon-only button)."
+        },
+        "icon": {
+          "type": "icon",
+          "bindable": true,
+          "description": "An icon before the label, or alone with size `icon`."
+        },
+        "variant": {
+          "type": "enum",
+          "enum": "variant",
+          "default": "default",
+          "description": "`default` = the primary action, `destructive` = dangerous, `ghost`/`link` = quiet."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "size",
+          "default": "default",
+          "description": "Control height class; `icon` is a square icon-only button."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Shows it inert."
+        },
+        "loading": {
+          "type": "boolean",
+          "default": false,
+          "description": "Pending: refuses presses, then shows a spinner."
+        },
+        "pendingLabel": {
+          "type": "string",
+          "description": "Label while loading."
+        },
+        "submit": {
+          "type": "boolean",
+          "default": false,
+          "description": "Submits the enclosing Form on press."
+        }
+      },
+      "events": [
+        "press"
+      ],
+      "example": {
+        "label": "Submit",
+        "variant": "default"
+      }
+    },
+    "Link": {
+      "kind": "native",
+      "group": "action",
+      "lite": true,
+      "children": "none",
+      "description": "Inline link text that opens a URL or fires `press`.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The link text."
+        },
+        "href": {
+          "type": "url",
+          "description": "The URL to open; omit to handle `press` yourself."
+        },
+        "external": {
+          "type": "boolean",
+          "default": false,
+          "description": "Marks it as leaving the app."
+        }
+      },
+      "events": [
+        "press"
+      ],
+      "example": {
+        "label": "Open docs",
+        "href": "https://ui.exponential.at"
+      }
+    },
+    "Toggle": {
+      "kind": "native",
+      "group": "action",
+      "lite": false,
+      "children": "none",
+      "description": "A two-state button that stays pressed.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "description": "The button text or accessibility label."
+        },
+        "icon": {
+          "type": "icon",
+          "description": "An icon before or instead of the label."
+        },
+        "pressed": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "The state; bind it."
+        },
+        "variant": {
+          "type": "enum",
+          "values": [
+            "default",
+            "outline"
+          ],
+          "default": "default",
+          "description": "Plain or outlined."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "controlSize",
+          "default": "default",
+          "description": "Control height class."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "Bold",
+        "icon": "editor-bold",
+        "pressed": false
+      }
+    },
+    "Form": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "many",
+      "description": "Collects its fields by `name` and fires `submit` with their values once every check passes.",
+      "props": {
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The form's key in the submit payload."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Makes every field inert."
+        },
+        "busy": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Shows the submit pending and refuses another submit."
+        },
+        "summary": {
+          "type": "boolean",
+          "default": false,
+          "description": "Also lists every failed check above the fields."
+        }
+      },
+      "events": [
+        "submit",
+        "invalid",
+        "change"
+      ],
+      "example": {
+        "name": "profile"
+      }
+    },
+    "FieldGroup": {
+      "kind": "macro",
+      "group": "input",
+      "lite": true,
+      "children": "many",
+      "description": "Fields side by side (Starts / Ends) that stack on phones.",
+      "props": {
+        "columns": {
+          "type": "number",
+          "default": 2,
+          "description": "Columns from md up (1-4)."
+        }
+      },
+      "example": {
+        "columns": 2
+      }
+    },
+    "FormActions": {
+      "kind": "macro",
+      "group": "input",
+      "lite": true,
+      "children": "many",
+      "description": "The end-aligned button row: children, Cancel, then THE submit (the one primary).",
+      "props": {
+        "submit": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The submit label."
+        },
+        "cancel": {
+          "type": "boolean",
+          "default": false,
+          "description": "An outline Cancel firing `cancel`."
+        },
+        "destructive": {
+          "type": "boolean",
+          "default": false,
+          "description": "A dangerous submit."
+        }
+      },
+      "events": [
+        "cancel"
+      ],
+      "example": {
+        "submit": "Save",
+        "cancel": true
+      }
+    },
+    "Input": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A single-line text field.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "type": {
+          "type": "enum",
+          "enum": "inputType",
+          "default": "text",
+          "description": "The keyboard and masking kind."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Hint text while empty."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The text; bind it to a data path."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules (required, email, length, regex, numeric)."
+        },
+        "validateOn": {
+          "type": "enum",
+          "enum": "validateOn",
+          "default": "blur",
+          "description": "When the checks run."
+        }
+      },
+      "events": [
+        "change",
+        "submit",
+        "focus",
+        "blur"
+      ],
+      "example": {
+        "label": "Email",
+        "name": "email",
+        "type": "email",
+        "placeholder": "you@example.com"
+      }
+    },
+    "Textarea": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A multi-line text field.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Hint text while empty."
+        },
+        "rows": {
+          "type": "number",
+          "default": 3,
+          "description": "Visible lines (the minimum when autosizing)."
+        },
+        "autosize": {
+          "type": "boolean",
+          "default": false,
+          "description": "Grows with the text from `rows` up to `maxRows`."
+        },
+        "maxRows": {
+          "type": "number",
+          "description": "Autosize stops growing here and scrolls."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The text; bind it to a data path."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules."
+        },
+        "validateOn": {
+          "type": "enum",
+          "enum": "validateOn",
+          "default": "blur",
+          "description": "When the checks run."
+        }
+      },
+      "events": [
+        "change",
+        "focus",
+        "blur"
+      ],
+      "example": {
+        "label": "Notes",
+        "name": "notes",
+        "rows": 4
+      }
+    },
+    "NumberField": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A numeric field with steppers, min/max/step clamping and locale formatting.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "value": {
+          "type": "number",
+          "bindable": true,
+          "description": "The number; bind it."
+        },
+        "min": {
+          "type": "number",
+          "description": "The lowest value."
+        },
+        "max": {
+          "type": "number",
+          "description": "The highest value."
+        },
+        "step": {
+          "type": "number",
+          "default": 1,
+          "description": "What the steppers and arrow keys add; Shift multiplies by 10."
+        },
+        "precision": {
+          "type": "number",
+          "description": "Decimal places shown; defaults to the step's."
+        },
+        "unit": {
+          "type": "string",
+          "description": "A suffix after the number (`kg`, `%`)."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Hint text while empty."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules."
+        },
+        "validateOn": {
+          "type": "enum",
+          "enum": "validateOn",
+          "default": "blur",
+          "description": "When the checks run."
+        }
+      },
+      "events": [
+        "change",
+        "submit",
+        "focus",
+        "blur"
+      ],
+      "example": {
+        "label": "Seats",
+        "name": "seats",
+        "value": 3,
+        "min": 1,
+        "max": 50
+      }
+    },
+    "Checkbox": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A labelled checkbox; bind `checked`.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The text beside the box."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "checked": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "The state; bind it."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "I agree",
+        "name": "agree",
+        "checked": false
+      }
+    },
+    "Radio": {
+      "kind": "native",
+      "group": "input",
+      "lite": false,
+      "children": "none",
+      "description": "A labelled group of radio options choosing one value; bind `value`.",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The group label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "options": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "option"
+          },
+          "required": true,
+          "description": "The choices in order."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The chosen value; bind it."
+        },
+        "orientation": {
+          "type": "enum",
+          "enum": "orientation",
+          "default": "vertical",
+          "description": "Stacked or in a row."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "Plan",
+        "name": "plan",
+        "options": [
+          {
+            "label": "Free",
+            "value": "free"
+          },
+          {
+            "label": "Team",
+            "value": "team"
+          }
+        ],
+        "value": "free"
+      }
+    },
+    "ChoiceTiles": {
+      "kind": "native",
+      "group": "input",
+      "lite": false,
+      "children": "none",
+      "description": "Picture tiles picking one or many values; options show `image` and `description`.",
+      "props": {
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "options": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "option"
+          },
+          "required": true,
+          "description": "The choices in order."
+        },
+        "type": {
+          "type": "enum",
+          "enum": "groupType",
+          "default": "single",
+          "description": "One pick or several."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The pick (comma-joined when multiple); bind it."
+        },
+        "columns": {
+          "type": "number",
+          "default": 2,
+          "description": "Tiles per row."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Inert."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "name": "design",
+        "options": [
+          {
+            "label": "Two columns",
+            "value": "two",
+            "description": "Pictures beside the text",
+            "image": "https://example.com/two.png"
+          },
+          {
+            "label": "One column",
+            "value": "one",
+            "description": "Pictures under the text",
+            "image": "https://example.com/one.png"
+          }
+        ],
+        "value": "two"
+      }
+    },
+    "Switch": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A labelled on/off switch; bind `checked`.",
+      "props": {
+        "label": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The text beside the switch."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "checked": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "The state; bind it."
+        },
+        "description": {
+          "type": "string",
+          "description": "A muted line under the label."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "Auto-scan",
+        "name": "autoScan",
+        "checked": true
+      }
+    },
+    "Slider": {
+      "kind": "native",
+      "group": "input",
+      "lite": false,
+      "children": "none",
+      "description": "A range slider between min and max; bind `value`.",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The field label."
+        },
+        "min": {
+          "type": "number",
+          "default": 0,
+          "bindable": true,
+          "description": "The lowest value."
+        },
+        "max": {
+          "type": "number",
+          "required": true,
+          "bindable": true,
+          "description": "The highest value."
+        },
+        "step": {
+          "type": "number",
+          "default": 1,
+          "description": "The increment."
+        },
+        "value": {
+          "type": "number",
+          "bindable": true,
+          "description": "The current value; bind it."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "Volume",
+        "min": 0,
+        "max": 100,
+        "value": 40
+      }
+    },
+    "Rating": {
+      "kind": "macro",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A row of stars scoring out of `max`; `readOnly` only displays.",
+      "props": {
+        "value": {
+          "type": "number",
+          "default": 0,
+          "bindable": true,
+          "description": "The score, 0 to max."
+        },
+        "max": {
+          "type": "number",
+          "default": 5,
+          "minimum": 1,
+          "maximum": 100,
+          "description": "How many stars (1 to 100)."
+        },
+        "readOnly": {
+          "type": "boolean",
+          "default": false,
+          "description": "Display only; no presses."
+        },
+        "size": {
+          "type": "enum",
+          "enum": "controlSize",
+          "default": "default",
+          "description": "Star size."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "value": 3,
+        "max": 5
+      }
+    },
+    "Select": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A dropdown picker of one or many options; `searchable` = a filtering combobox, `source` = a host list.",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "options": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "option"
+          },
+          "bindable": true,
+          "description": "Inline choices, or a path the host refills on `search`; omit with `source`."
+        },
+        "source": {
+          "type": "string",
+          "description": "A host list id (e.g. `exp:statuses`) that supplies the options."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Shown while nothing is chosen."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The chosen value (comma-joined when multiple); bind it."
+        },
+        "multiple": {
+          "type": "boolean",
+          "default": false,
+          "description": "Allows several values."
+        },
+        "searchable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Adds a filter field; typing fires `search`."
+        },
+        "emptyText": {
+          "type": "string",
+          "default": "$string.noResults",
+          "description": "Shown when the search matches nothing."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules."
+        },
+        "validateOn": {
+          "type": "enum",
+          "enum": "validateOn",
+          "default": "change",
+          "description": "When the checks run."
+        }
+      },
+      "events": [
+        "change",
+        "search"
+      ],
+      "example": {
+        "label": "Board",
+        "name": "board",
+        "options": [
+          {
+            "label": "Backlog",
+            "value": "backlog"
+          },
+          {
+            "label": "Sprint",
+            "value": "sprint"
+          }
+        ],
+        "value": "sprint"
+      }
+    },
+    "SearchList": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A search field over rows: typing filters, arrows move, Enter picks.",
+      "props": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "searchItem"
+          },
+          "required": true,
+          "bindable": true,
+          "description": "The rows; refill on `search`."
+        },
+        "query": {
+          "type": "string",
+          "bindable": true,
+          "description": "The input text."
+        },
+        "placeholder": {
+          "type": "string",
+          "default": "$string.search",
+          "description": "The placeholder."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The picked value (a check)."
+        },
+        "emptyText": {
+          "type": "string",
+          "default": "$string.noResults",
+          "description": "Shown on no match."
+        },
+        "maxRows": {
+          "type": "number",
+          "default": 8,
+          "description": "Rows before it scrolls."
+        },
+        "showCount": {
+          "type": "boolean",
+          "default": true,
+          "description": "A count while typing."
+        }
+      },
+      "events": [
+        "search",
+        "select"
+      ],
+      "example": {
+        "placeholder": "Search issues",
+        "items": [
+          {
+            "label": "Ship the search list",
+            "value": "exp-12",
+            "identifier": "EXP-12",
+            "icon": "status-in-progress"
+          },
+          {
+            "label": "Close tabs on hover",
+            "value": "exp-15",
+            "identifier": "EXP-15",
+            "icon": "status-done"
+          }
+        ]
+      }
+    },
+    "ChipInput": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A multi-value field of removable chips (Enter or comma adds); bind `values`.",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "values": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "bindable": true,
+          "description": "The entries; bind them."
+        },
+        "suggestions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "option"
+          },
+          "bindable": true,
+          "description": "Completions offered while typing."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Hint text while empty."
+        },
+        "max": {
+          "type": "number",
+          "description": "The most entries allowed."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        },
+        "checks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "check"
+          },
+          "description": "Validation rules."
+        }
+      },
+      "events": [
+        "change",
+        "add",
+        "remove"
+      ],
+      "example": {
+        "label": "Labels",
+        "name": "labels",
+        "values": [
+          "bug",
+          "ios"
+        ]
+      }
+    },
+    "DatePicker": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A calendar date field (ISO yyyy-mm-dd).",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "value": {
+          "type": "date",
+          "bindable": true,
+          "description": "The chosen day as yyyy-mm-dd, or empty."
+        },
+        "min": {
+          "type": "date",
+          "description": "The earliest allowed day."
+        },
+        "max": {
+          "type": "date",
+          "description": "The latest allowed day."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Shown while empty."
+        },
+        "firstDayOfWeek": {
+          "type": "number",
+          "description": "0 (Sunday) to 6; else the locale's."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "Due",
+        "name": "due",
+        "value": "2026-10-14"
+      }
+    },
+    "DateRangePicker": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A two-date range field with one calendar (ISO dates).",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data (`{start, end}`)."
+        },
+        "start": {
+          "type": "date",
+          "bindable": true,
+          "description": "The first day as yyyy-mm-dd, or empty."
+        },
+        "end": {
+          "type": "date",
+          "bindable": true,
+          "description": "The last day as yyyy-mm-dd, or empty."
+        },
+        "min": {
+          "type": "date",
+          "description": "The earliest allowed day."
+        },
+        "max": {
+          "type": "date",
+          "description": "The latest allowed day."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Shown while empty."
+        },
+        "firstDayOfWeek": {
+          "type": "number",
+          "description": "0 (Sunday) to 6; else the locale's."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "Sprint",
+        "name": "sprint",
+        "start": "2026-10-07",
+        "end": "2026-10-21"
+      }
+    },
+    "TimePicker": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A time-of-day field (`HH:mm`) picked from a list every `step` minutes, or typed.",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The time as `HH:mm`, or empty."
+        },
+        "min": {
+          "type": "string",
+          "description": "The earliest time, `HH:mm`."
+        },
+        "max": {
+          "type": "string",
+          "description": "The latest time, `HH:mm`."
+        },
+        "step": {
+          "type": "number",
+          "default": 15,
+          "description": "Minutes between list entries."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Shown while empty."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        }
+      },
+      "events": [
+        "change"
+      ],
+      "example": {
+        "label": "Starts",
+        "name": "startsAt",
+        "value": "09:30"
+      }
+    },
+    "FileUpload": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "A drop zone with a browse button; files reach the host via `upload`, listed back in `files`.",
+      "props": {
+        "label": {
+          "type": "string",
+          "description": "The field label."
+        },
+        "name": {
+          "type": "string",
+          "required": true,
+          "description": "The field's key in the submitted data."
+        },
+        "accept": {
+          "type": "string",
+          "description": "Accepted types, comma-separated (`image/*,.pdf`)."
+        },
+        "multiple": {
+          "type": "boolean",
+          "default": false,
+          "description": "Allows more than one file."
+        },
+        "maxSize": {
+          "type": "number",
+          "description": "Max bytes per file; bigger ones are refused."
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "shape": "file"
+          },
+          "bindable": true,
+          "description": "The attached files, each removable."
+        },
+        "hint": {
+          "type": "string",
+          "description": "Text under the drop zone's title."
+        },
+        "disabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows it inert."
+        }
+      },
+      "events": [
+        "upload",
+        "remove"
+      ],
+      "example": {
+        "label": "Attachments",
+        "name": "attachments",
+        "accept": "image/*",
+        "multiple": true
+      }
+    },
+    "Composer": {
+      "kind": "native",
+      "group": "input",
+      "lite": true,
+      "children": "none",
+      "description": "The chat input box: a growing text field with a submit button and optional attachments.",
+      "props": {
+        "placeholder": {
+          "type": "string",
+          "description": "Hint text while empty."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "The draft text; bind it."
+        },
+        "submitLabel": {
+          "type": "string",
+          "default": "$string.send",
+          "description": "The submit button's accessibility label."
+        },
+        "attachments": {
+          "type": "boolean",
+          "default": false,
+          "description": "Shows the attach control."
+        },
+        "busy": {
+          "type": "boolean",
+          "default": false,
+          "description": "Turns submit into a stop while a reply streams."
+        }
+      },
+      "events": [
+        "submit",
+        "change",
+        "stop"
+      ],
+      "example": {
+        "placeholder": "Ask anything"
+      }
+    },
+    "Row": {
+      "kind": "macro",
+      "group": "list",
+      "lite": true,
+      "children": "none",
+      "slots": [
+        "leading",
+        "trailing"
+      ],
+      "description": "THE list row: a lead glyph or slot, a mono identifier, title and subtitle, trailing meta or value, a slot and a chevron; flat or card, nestable.",
+      "props": {
+        "title": {
+          "type": "string",
+          "required": true,
+          "bindable": true,
+          "description": "The main text."
+        },
+        "identifier": {
+          "type": "string",
+          "bindable": true,
+          "description": "A mono identifier before the title (`EXP-12`)."
+        },
+        "subtitle": {
+          "type": "string",
+          "bindable": true,
+          "description": "A muted second line."
+        },
+        "meta": {
+          "type": "string",
+          "bindable": true,
+          "description": "Trailing muted text (a count, a time)."
+        },
+        "value": {
+          "type": "string",
+          "bindable": true,
+          "description": "A trailing readable value (a property, a pick)."
+        },
+        "placeholder": {
+          "type": "string",
+          "description": "Muted trailing text while `value` is empty."
+        },
+        "icon": {
+          "type": "icon",
+          "bindable": true,
+          "description": "The lead glyph (the `leading` slot replaces it)."
+        },
+        "chevron": {
+          "type": "enum",
+          "enum": "rowChevron",
+          "default": "none",
+          "bindable": true,
+          "description": "Trailing disclosure or picker glyph."
+        },
+        "selected": {
+          "type": "boolean",
+          "default": false,
+          "bindable": true,
+          "description": "Draws it as the active row."
+        },
+        "density": {
+          "type": "enum",
+          "enum": "density",
+          "default": "default",
+          "description": "Row height class."
+        },
+        "surface": {
+          "type": "enum",
+          "enum": "rowSurface",
+          "default": "flat",
+          "description": "A flat row, or a padded card with its own fill and border."
+        },
+        "pressable": {
+          "type": "boolean",
+          "default": false,
+          "description": "Makes it a press target that fires `press` (an `on.press` implies it)."
+        },
+        "depth": {
+          "type": "number",
+          "default": 0,
+          "description": "Depth under a tree Section (0 = root)."
+        }
+      },
+      "events": [
+        "press"
+      ],
+      "example": {
+        "title": "r/selfhosted",
+        "meta": "312 posts",
+        "pressable": true
+      }
+    },
+    "TreeGuides": {
+      "kind": "native",
+      "group": "list",
+      "lite": true,
+      "children": "none",
+      "hidden": true,
+      "description": "The tree gutter a nested Row draws (filled by the core); never authored directly.",
+      "props": {
+        "depth": {
+          "type": "number",
+          "required": true,
+          "description": "The row's nesting depth (0 = root)."
+        },
+        "elbowAt": {
+          "type": "number",
+          "description": "The gutter index that draws the elbow into this row; omit for a root."
+        },
+        "tee": {
+          "type": "boolean",
+          "default": false,
+          "description": "Continues the line past this row to a later sibling."
+        },
+        "passThrough": {
+          "type": "array",
+          "items": {
+            "type": "number"
+          },
+          "description": "Gutter indexes whose ancestor line continues straight through."
+        }
+      },
+      "example": {
+        "depth": 1,
+        "elbowAt": 0,
+        "tee": true,
+        "passThrough": []
+      }
+    },
+    "Unknown": {
+      "kind": "native",
+      "group": "feedback",
+      "lite": true,
+      "children": "none",
+      "hidden": true,
+      "description": "A renderer's placeholder for an undefined component; never authored directly.",
+      "props": {
+        "component": {
+          "type": "string",
+          "required": true,
+          "description": "The unmapped component's name."
+        },
+        "catalogId": {
+          "type": "string",
+          "description": "The catalog the component was authored against."
+        }
+      },
+      "example": {
+        "component": "Gauge"
+      }
+    }
+  }
+}