@zeyos/zx 4.3.4 → 5.0.0

package/docs/api.json

@@ -106,6 +106,254 @@
       }
     ]
   },
+  "ActivityItem": {
+    "options": [
+      {
+        "name": "id",
+        "type": "unknown",
+        "default": "null",
+        "description": "Host-owned activity identifier."
+      },
+      {
+        "name": "actor",
+        "type": "ActivityContent",
+        "default": "''",
+        "description": "Actor identity text or presentation slot."
+      },
+      {
+        "name": "avatar",
+        "type": "ActivityAvatar",
+        "default": "null",
+        "description": "Avatar descriptor or host-owned avatar element."
+      },
+      {
+        "name": "title",
+        "type": "ActivityContent",
+        "default": "''",
+        "description": "Activity summary."
+      },
+      {
+        "name": "content",
+        "type": "ActivityContent",
+        "default": "null",
+        "description": "Optional body slot."
+      },
+      {
+        "name": "timestamp",
+        "type": "Date|string|number|null",
+        "default": "null",
+        "description": "Date, parseable date string, or epoch milliseconds."
+      },
+      {
+        "name": "timeLabel",
+        "type": "string|null",
+        "default": "null",
+        "description": "Explicit human-readable timestamp."
+      },
+      {
+        "name": "metadata",
+        "type": "ActivityContent[]",
+        "default": "[]",
+        "description": "Compact metadata slots."
+      },
+      {
+        "name": "attachments",
+        "type": "ActivityContent[]",
+        "default": "[]",
+        "description": "Attachment presentation slots, commonly FileItem elements."
+      },
+      {
+        "name": "actions",
+        "type": "ActivityActionSlot[]",
+        "default": "[]",
+        "description": "Native action descriptors or host-owned controls."
+      },
+      {
+        "name": "kind",
+        "type": "string",
+        "default": "'default'",
+        "description": "Product-neutral activity kind exposed as `data-kind`."
+      },
+      {
+        "name": "state",
+        "type": "ActivityState",
+        "default": "'default'",
+        "description": "Delivery state exposed as `data-state`."
+      },
+      {
+        "name": "stateLabel",
+        "type": "string|null",
+        "default": "null",
+        "description": "Word shown in the state badge instead of the built-in one."
+      },
+      {
+        "name": "headingLevel",
+        "type": "1|2|3|4|5|6",
+        "default": "3",
+        "description": "Semantic heading level for the activity summary."
+      }
+    ],
+    "events": [
+      {
+        "name": "action",
+        "payload": "{id:string,action:NormalizedActivityAction,event:MouseEvent}",
+        "description": ""
+      }
+    ],
+    "methods": [
+      {
+        "name": "setActivity",
+        "signature": "setActivity(values)",
+        "returns": "this",
+        "description": "Replaces any subset of the activity presentation."
+      },
+      {
+        "name": "getActivity",
+        "signature": "getActivity()",
+        "returns": "ActivityItemOptions",
+        "description": "Returns a shallow, host-safe copy of the current descriptor."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned item."
+      }
+    ]
+  },
+  "ActivityList": {
+    "options": [
+      {
+        "name": "items",
+        "type": "ActivityItemOptions[]",
+        "default": "[]",
+        "description": "Initial activities in host-supplied chronological order."
+      },
+      {
+        "name": "groupBy",
+        "type": "ActivityGroupReader",
+        "default": "null",
+        "description": "Property or resolver used for stable grouping."
+      },
+      {
+        "name": "groupLabel",
+        "type": "ActivityGroupLabel|null",
+        "default": "null",
+        "description": "Group-heading renderer."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Activity'",
+        "description": "Accessible collection name."
+      },
+      {
+        "name": "variant",
+        "type": "ActivityListVariant",
+        "default": "'default'",
+        "description": "Entry layout, reflected as `data-variant` on the root. `'compact'` also makes an avatar descriptor without a `size` small."
+      },
+      {
+        "name": "loading",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether initial or incremental activity is loading."
+      },
+      {
+        "name": "loadingCount",
+        "type": "number",
+        "default": "3",
+        "description": "Placeholder rows shown for an empty loading list."
+      },
+      {
+        "name": "loadingText",
+        "type": "string",
+        "default": "'Loading activity'",
+        "description": "Loading status text."
+      },
+      {
+        "name": "emptyText",
+        "type": "ActivityListContent",
+        "default": "'No activity yet'",
+        "description": "Empty-state content."
+      },
+      {
+        "name": "groupHeadingLevel",
+        "type": "1|2|3|4|5|6",
+        "default": "2",
+        "description": "Semantic group-heading level."
+      },
+      {
+        "name": "itemHeadingLevel",
+        "type": "1|2|3|4|5|6",
+        "default": "3",
+        "description": "Default item-heading level."
+      }
+    ],
+    "events": [
+      {
+        "name": "datachange",
+        "payload": "{items:ActivityItemOptions[]}",
+        "description": ""
+      }
+    ],
+    "methods": [
+      {
+        "name": "setItems",
+        "signature": "setItems(items, [options])",
+        "returns": "this",
+        "description": "Replaces all activities."
+      },
+      {
+        "name": "getItems",
+        "signature": "getItems()",
+        "returns": "ActivityItemOptions[]",
+        "description": "Returns shallow descriptor copies in current display order."
+      },
+      {
+        "name": "getItem",
+        "signature": "getItem(id)",
+        "returns": "ActivityItemOptions|null",
+        "description": "Returns a shallow descriptor copy by stable host ID."
+      },
+      {
+        "name": "appendItems",
+        "signature": "appendItems(items, [options])",
+        "returns": "this",
+        "description": "Adds activities after the current source order for older-page or forward-stream updates."
+      },
+      {
+        "name": "prependItems",
+        "signature": "prependItems(items, [options])",
+        "returns": "this",
+        "description": "Adds activities before the current source order for newest-first live updates."
+      },
+      {
+        "name": "updateItem",
+        "signature": "updateItem(id, values, [options])",
+        "returns": "this",
+        "description": "Patches the first activity whose ID is `Object.is`-equal to the requested ID."
+      },
+      {
+        "name": "removeItem",
+        "signature": "removeItem(id, [options])",
+        "returns": "this",
+        "description": "Removes the first activity whose ID is `Object.is`-equal to the requested ID."
+      },
+      {
+        "name": "setLoading",
+        "signature": "setLoading(loading)",
+        "returns": "this",
+        "description": "Sets initial/incremental loading presentation."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned list."
+      }
+    ]
+  },
   "Alert": {
     "options": [
       {
@@ -335,7 +583,7 @@
         "name": "getItems",
         "signature": "getItems()",
         "returns": "AppNavItem[]",
-        "description": "Returns a shallow copy of normalized items."
+        "description": "Returns a copy of the normalized items. A leaf has no `children` property, as it was written, rather than the empty list normalization gives it."
       },
       {
         "name": "setActive",
@@ -514,7 +762,7 @@
         "name": "name",
         "type": "string",
         "default": "''",
-        "description": "Name used to derive fallback initials."
+        "description": "Name used to derive the fallback initials and tone."
       },
       {
         "name": "initials",
@@ -532,7 +780,7 @@
         "name": "size",
         "type": "string|number",
         "default": "'md'",
-        "description": "Preset (`sm`, `md`, `lg`) or pixel size."
+        "description": "Preset — `sm` 24px, `md` 32px, `lg` 40px at the default spacing unit — or a pixel size. Below 24px the fallback shows a single initial."
       },
       {
         "name": "shape",
@@ -540,6 +788,12 @@
         "default": "'circle'",
         "description": "Avatar shape."
       },
+      {
+        "name": "tone",
+        "type": "AvatarTone|null",
+        "default": "null",
+        "description": "Fallback colour from the tone palette. `null` derives a stable tone from the name (or the initials when there is no name), so the same person gets the same colour on every screen; see {@link avatarTone}."
+      },
       {
         "name": "status",
         "type": "'online'|'away'|'busy'|'offline'|null",
@@ -601,6 +855,12 @@
         "default": "'neutral'",
         "description": "Semantic intent."
       },
+      {
+        "name": "tone",
+        "type": "BadgeTone|null",
+        "default": "null",
+        "description": "Categorical colour — a project, a label, a module — from the tone palette rather than the status set, so a tag never reads as a warning. When set it decides the colour and `kind` is ignored for it; `variant` still applies. Unknown names are ignored."
+      },
       {
         "name": "variant",
         "type": "'soft'|'solid'|'outline'",
@@ -812,11 +1072,23 @@
         "default": "false",
         "description": "Whether the button is disabled."
       },
+      {
+        "name": "busy",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether the button is working on its action — see `setButtonBusy()`."
+      },
       {
         "name": "title",
         "type": "string",
         "default": null,
         "description": "Native title text."
+      },
+      {
+        "name": "shortcut",
+        "type": "ButtonShortcut",
+        "default": null,
+        "description": "Keyboard hint; does not register a keyboard handler."
       }
     ],
     "events": [
@@ -1387,6 +1659,12 @@
         "default": "false",
         "description": "Record selection behavior."
       },
+      {
+        "name": "selectionTrigger",
+        "type": "'checkbox'|'card'",
+        "default": "'checkbox'",
+        "description": "Select through a checkbox or the non-interactive card surface."
+      },
       {
         "name": "selection",
         "type": "unknown[]",
@@ -1407,9 +1685,9 @@
       },
       {
         "name": "fieldControls",
-        "type": "boolean",
+        "type": "boolean|import('../view/record-view.js').ViewFieldControlsConfig",
         "default": "true",
-        "description": "Whether to expose shared field controls."
+        "description": "Whether to expose shared field controls. `true` renders the chooser in the card toolbar and `false` omits it; an object customises its `label` and mounts it into `target`."
       },
       {
         "name": "emptyText",
@@ -1825,6 +2103,12 @@
         "default": "false",
         "description": "Fallback initial checked state."
       },
+      {
+        "name": "hideLabel",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether the heading is left out. The group keeps the heading text as its accessible name (`aria-label`); a Field labelling the checklist names it instead, which is why the `checklist` field type sets this."
+      },
       {
         "name": "load",
         "type": "(() => Promise<ChecklistItem[]>|ChecklistItem[])|null",
@@ -1901,6 +2185,102 @@
       }
     ]
   },
+  "CodeEditor": {
+    "options": [
+      {
+        "name": "value",
+        "type": "unknown",
+        "default": "''",
+        "description": "Initial text."
+      },
+      {
+        "name": "name",
+        "type": "string",
+        "default": "''",
+        "description": "Form field name."
+      },
+      {
+        "name": "language",
+        "type": "string",
+        "default": "'text'",
+        "description": "Language identifier shown to the user and exposed as data."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Code editor'",
+        "description": "Accessible editor label."
+      },
+      {
+        "name": "placeholder",
+        "type": "string",
+        "default": "''",
+        "description": "Placeholder text."
+      },
+      {
+        "name": "rows",
+        "type": "number",
+        "default": "12",
+        "description": "Visible textarea rows."
+      },
+      {
+        "name": "indent",
+        "type": "string",
+        "default": "'\\t'",
+        "description": "Text inserted by Tab and removed by Shift+Tab."
+      },
+      {
+        "name": "wrap",
+        "type": "'off'|'soft'|'hard'",
+        "default": "'off'",
+        "description": "Textarea wrapping behavior."
+      },
+      {
+        "name": "spellcheck",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether browser spellcheck is enabled."
+      },
+      {
+        "name": "readOnly",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether content can be selected but not changed."
+      },
+      {
+        "name": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether the editor is disabled."
+      },
+      {
+        "name": "status",
+        "type": "boolean",
+        "default": "true",
+        "description": "Whether the line/column status is visible."
+      }
+    ],
+    "events": [
+      {
+        "name": "input",
+        "payload": "{value:string}",
+        "description": "Input listener."
+      },
+      {
+        "name": "change",
+        "payload": "{value:string}",
+        "description": "Change listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "setValue",
+        "signature": "setValue(value, [options])",
+        "returns": "this",
+        "description": "Replaces the editor text."
+      }
+    ]
+  },
   "Confirm": {
     "options": [
       {
@@ -1932,7 +2312,13 @@
         "type": "boolean",
         "default": "false",
         "description": "Whether the confirmation action is dangerous."
-      }
+      },
+      {
+        "name": "confirmText",
+        "type": "string|null",
+        "default": "null",
+        "description": "Text the reader must type before the confirm button enables — the name of what is about to be deleted, say. The dialog adds an input labelled \"Type <confirmText> to confirm\" (message `dialog.typeToConfirm`, `%1` standing for the text), focuses it, and enables the confirm button, and Enter, only while its value matches exactly, ignoring surrounding spaces."
+      }
     ],
     "events": [],
     "methods": []
@@ -2328,7 +2714,7 @@
         "name": "clearable",
         "type": "boolean",
         "default": "true",
-        "description": "Show a clear button while a range is present."
+        "description": "Show a clear button while a range is present and the box is enabled; without it the input keeps no room for one."
       },
       {
         "name": "min",
@@ -2637,7 +3023,7 @@
         "name": "clearable",
         "type": "boolean",
         "default": "true",
-        "description": "Show a clear button when a value is present."
+        "description": "Show a clear button while a value is present and the box is enabled; without it the input keeps no room for one."
       },
       {
         "name": "disabled",
@@ -2755,7 +3141,7 @@
         "name": "scope",
         "type": "Element|string|null",
         "default": "null",
-        "description": "Element whose nearest Zx theme scope owns the overlay; defaults to the opener."
+        "description": "Element whose nearest Zx theme scope owns the overlay; defaults to the opener. Resolved on every open, so a scope connected after construction still owns it."
       }
     ],
     "events": [
@@ -2828,7 +3214,7 @@
         "name": "confirm",
         "signature": "confirm([options])",
         "returns": "Promise<boolean>",
-        "description": "Opens a confirmation dialog."
+        "description": "Opens a confirmation dialog. With `confirmText` it becomes a type-to-confirm dialog: the confirm button stays disabled until the reader has typed that text."
       },
       {
         "name": "prompt",
@@ -3093,7 +3479,7 @@
         "name": "scope",
         "type": "Element|string|null",
         "default": "null",
-        "description": "Element whose nearest Zx theme scope owns the panel; defaults to the anchor."
+        "description": "Element whose nearest Zx theme scope owns the panel; defaults to the anchor. Resolved on every open, so an anchor connected after construction still gets its scope."
       }
     ],
     "events": [
@@ -3195,6 +3581,126 @@
     "events": [],
     "methods": []
   },
+  "EntityRef": {
+    "options": [
+      {
+        "name": "id",
+        "type": "unknown",
+        "default": "null",
+        "description": "Application-owned entity identifier included in events."
+      },
+      {
+        "name": "title",
+        "type": "string",
+        "default": "''",
+        "description": "Primary identity text."
+      },
+      {
+        "name": "subtitle",
+        "type": "EntityRefContent",
+        "default": "null",
+        "description": "Secondary identity text or safe caller-supplied content."
+      },
+      {
+        "name": "icon",
+        "type": "EntityRefIcon",
+        "default": "null",
+        "description": "Icon name, node, component, or lazy renderer."
+      },
+      {
+        "name": "metadata",
+        "type": "EntityRefMetadata[]",
+        "default": "[]",
+        "description": "Labelled dense metadata."
+      },
+      {
+        "name": "link",
+        "type": "EntityRefLinkValue",
+        "default": "null",
+        "description": "Optional native primary link."
+      },
+      {
+        "name": "actions",
+        "type": "EntityRefActionEntry[]",
+        "default": "[]",
+        "description": "Secondary controls; element actions keep their own behavior."
+      },
+      {
+        "name": "size",
+        "type": "'sm'|'md'|'lg'",
+        "default": "'md'",
+        "description": "Size of the icon and the identity text."
+      },
+      {
+        "name": "wrap",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether long identity text may wrap instead of truncating."
+      },
+      {
+        "name": "actionsLabel",
+        "type": "string",
+        "default": "'Entity actions'",
+        "description": "Accessible name for secondary actions."
+      }
+    ],
+    "events": [
+      {
+        "name": "activate",
+        "payload": "{id: unknown, entity: Readonly<EntityRefState>, href: string, event: MouseEvent}",
+        "description": "Preventable primary-link listener."
+      },
+      {
+        "name": "action",
+        "payload": "{id: string, action: Readonly<EntityRefAction>, entity: Readonly<EntityRefState>, event: MouseEvent}",
+        "description": "Preventable delegated-action listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "set",
+        "signature": "set(values)",
+        "returns": "this",
+        "description": "Updates any subset of the identity without replacing the root."
+      },
+      {
+        "name": "setMetadata",
+        "signature": "setMetadata(metadata)",
+        "returns": "this",
+        "description": "Replaces the metadata collection."
+      },
+      {
+        "name": "setActions",
+        "signature": "setActions(actions)",
+        "returns": "this",
+        "description": "Replaces the secondary action controls."
+      },
+      {
+        "name": "setLink",
+        "signature": "setLink(link)",
+        "returns": "this",
+        "description": "Sets or clears the primary link."
+      },
+      {
+        "name": "getEntity",
+        "signature": "getEntity()",
+        "returns": "Readonly<EntityRefState>",
+        "description": "Returns a defensive presentation snapshot. Caller-supplied Nodes and Components retain their identity; arrays and descriptors are copied."
+      },
+      {
+        "name": "focus",
+        "signature": "focus()",
+        "returns": "this",
+        "description": "Focuses the primary link or the first enabled action."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned reference."
+      }
+    ]
+  },
   "EntitySelect": {
     "options": [
       {
@@ -3225,7 +3731,7 @@
         "name": "colorKey",
         "type": "string|((item: SelectItem)=>unknown)",
         "default": "'color'",
-        "description": "Optional icon colour reader."
+        "description": "Optional icon colour reader: a CSS colour or a token reference such as `var(--zx-color-tone-blue-fg)`. Without one the glyph is a neutral tile in muted ink."
       },
       {
         "name": "subtitleKey",
@@ -3249,7 +3755,13 @@
         "name": "id",
         "type": "string|null",
         "default": "null",
-        "description": "Control ID and logical field identifier."
+        "description": "DOM id of the control. Generated when omitted; a Fieldset derives it from its `idPrefix` and the field key, so a key never becomes a DOM id by itself."
+      },
+      {
+        "name": "name",
+        "type": "string|null",
+        "default": "null",
+        "description": "Field name: the `name` of a native control and the key the field is filed under. A Fieldset sets it to the field key; a standalone field falls back to `id`."
       },
       {
         "name": "type",
@@ -3535,6 +4047,12 @@
         "type": "Record<string, FieldOptions|Field|Element|Component>",
         "default": "{}",
         "description": "Initial fields."
+      },
+      {
+        "name": "idPrefix",
+        "type": "string|null",
+        "default": "null",
+        "description": "Prefix of the DOM ids generated for the fields, as `<idPrefix>-<key>`. Null generates one per instance, so the same fieldset mounted twice never repeats an id and a field key never collides with an element id elsewhere on the page."
       }
     ],
     "events": [],
@@ -3543,7 +4061,7 @@
         "name": "addField",
         "signature": "addField(id, field)",
         "returns": "Field",
-        "description": "Adds a field from options, an existing field, an element, or a component."
+        "description": "Adds a field from options, an existing field, an element, or a component. The key becomes the field's `name` and its `data-field-id`; the control's DOM id is `<idPrefix>-<key>`, unless the field options give an `id` of their own that differs from the key."
       },
       {
         "name": "getField",
@@ -3619,153 +4137,452 @@
       }
     ]
   },
-  "Filter": {
+  "FileItem": {
     "options": [
       {
-        "name": "fields",
-        "type": "FilterField[]",
-        "default": null,
-        "description": "Field definitions."
+        "name": "id",
+        "type": "unknown",
+        "default": "null",
+        "description": "Application-owned file identifier included in events."
       },
       {
-        "name": "value",
-        "type": "FilterAst",
-        "default": null,
-        "description": "Initial expression."
+        "name": "name",
+        "type": "string",
+        "default": "''",
+        "description": "File name."
       },
       {
-        "name": "operators",
-        "type": "Array<{id:string,label:string,arity:'none'|'single'|'pair'|'many',types:string[]}>",
-        "default": null,
-        "description": "Additional/overridden operators."
+        "name": "size",
+        "type": "number|string|null",
+        "default": "null",
+        "description": "Byte count; invalid and negative values are omitted."
       },
       {
-        "name": "allowGroups",
-        "type": "boolean",
-        "default": "true",
-        "description": "Whether nested groups may be authored."
+        "name": "mime",
+        "type": "string",
+        "default": "''",
+        "description": "MIME type. Shown as a readable type (\"PDF\", \"Image\"), never as the raw string, and used to pick the icon."
       },
       {
-        "name": "maxDepth",
-        "type": "number",
-        "default": "3",
-        "description": "Maximum nested group depth."
+        "name": "typeLabel",
+        "type": "string|null",
+        "default": "null",
+        "description": "Type shown beside the size; null derives it from the MIME type (or the name's extension when the MIME type is unfamiliar), an empty string hides it."
       },
       {
-        "name": "maxConditions",
-        "type": "number",
-        "default": "50",
-        "description": "Maximum condition count."
+        "name": "subtitle",
+        "type": "EntityRefContent",
+        "default": "null",
+        "description": "Optional supporting text before generated metadata."
       },
       {
-        "name": "autoApply",
-        "type": "boolean",
-        "default": "false",
-        "description": "Emit apply after every valid mutation."
+        "name": "icon",
+        "type": "EntityRefIcon",
+        "default": "'file'",
+        "description": "File icon name, node, component, or lazy renderer. The generic `'file'` glyph gives way to one for the MIME type when the active icon set has it."
       },
       {
-        "name": "readonly",
+        "name": "metadata",
+        "type": "EntityRefMetadata[]",
+        "default": "[]",
+        "description": "Additional labelled metadata."
+      },
+      {
+        "name": "link",
+        "type": "EntityRefLinkValue",
+        "default": "null",
+        "description": "Optional safe native file/download link."
+      },
+      {
+        "name": "actions",
+        "type": "EntityRefActionEntry[]",
+        "default": "[]",
+        "description": "File actions; application policy stays external."
+      },
+      {
+        "name": "status",
+        "type": "FileStatus",
+        "default": "'ready'",
+        "description": "Durable or transient presentation state."
+      },
+      {
+        "name": "statusLabel",
+        "type": "string|null",
+        "default": "null",
+        "description": "Overrides the generated state label; an empty string hides it."
+      },
+      {
+        "name": "progress",
+        "type": "number|null",
+        "default": "null",
+        "description": "Completed percentage, clamped to 0–100."
+      },
+      {
+        "name": "indeterminate",
         "type": "boolean",
         "default": "false",
-        "description": "Prevent mutations while keeping values readable."
+        "description": "Whether active progress has no known amount."
       },
       {
-        "name": "disabled",
+        "name": "identitySize",
+        "type": "'sm'|'md'|'lg'",
+        "default": "'md'",
+        "description": "Size of the file's icon and name."
+      },
+      {
+        "name": "wrap",
         "type": "boolean",
         "default": "false",
-        "description": "Disable all controls."
+        "description": "Whether long identity text may wrap."
       },
       {
-        "name": "applyLabel",
+        "name": "actionsLabel",
         "type": "string",
-        "default": "'Apply filters'",
-        "description": "Apply button label."
+        "default": "'File actions'",
+        "description": "Accessible name for secondary actions."
       },
       {
-        "name": "clearLabel",
+        "name": "locale",
         "type": "string",
-        "default": "'Clear'",
-        "description": "Clear button label."
+        "default": null,
+        "description": "Locale passed to `formatFileSize`."
       }
     ],
     "events": [
       {
-        "name": "change",
-        "payload": "Record<string,unknown>",
-        "description": "Draft-change listener."
-      },
-      {
-        "name": "apply",
-        "payload": "Record<string,unknown>",
-        "description": "Valid-apply listener."
-      },
-      {
-        "name": "invalid",
-        "payload": "Record<string,unknown>",
-        "description": "Invalid-apply listener."
-      },
-      {
-        "name": "query",
-        "payload": "Record<string,unknown>",
-        "description": "Async query listener."
-      },
-      {
-        "name": "loaded",
-        "payload": "Record<string,unknown>",
-        "description": "Async loaded listener."
+        "name": "activate",
+        "payload": "{id: unknown, file: Readonly<FileItemState>, href: string, event: MouseEvent}",
+        "description": "Preventable native-link listener."
       },
       {
-        "name": "error",
-        "payload": "Record<string,unknown>",
-        "description": "Async failure listener."
+        "name": "action",
+        "payload": "{id: string, fileId: unknown, action: object, file: Readonly<FileItemState>, event: MouseEvent}",
+        "description": "Preventable file-action listener."
       }
     ],
     "methods": [
       {
-        "name": "getValue",
-        "signature": "getValue()",
-        "returns": "FilterAst",
-        "description": "Returns a defensive AST copy."
+        "name": "set",
+        "signature": "set(values)",
+        "returns": "this",
+        "description": "Updates any subset of the file without replacing the row root."
       },
       {
-        "name": "setValue",
-        "signature": "setValue(value, [options])",
+        "name": "setStatus",
+        "signature": "setStatus(status, [statusLabel])",
         "returns": "this",
-        "description": "Atomically replaces the AST."
+        "description": "Updates the file lifecycle state and, optionally, its visible label."
       },
       {
-        "name": "addCondition",
-        "signature": "addCondition([parentId], [initial])",
-        "returns": "string|null",
-        "description": "Adds a condition to a group."
+        "name": "setProgress",
+        "signature": "setProgress(progress, [options])",
+        "returns": "this",
+        "description": "Updates the progress meter."
       },
       {
-        "name": "addGroup",
-        "signature": "addGroup([parentId], [logic])",
-        "returns": "string|null",
-        "description": "Adds a nested group."
+        "name": "getFile",
+        "signature": "getFile()",
+        "returns": "Readonly<FileItemState>",
+        "description": "Returns a defensive file snapshot."
       },
       {
-        "name": "update",
-        "signature": "update(id, patch)",
+        "name": "focus",
+        "signature": "focus()",
         "returns": "this",
-        "description": "Updates a node by stable ID."
+        "description": "Focuses the native destination or first enabled action."
       },
       {
-        "name": "remove",
-        "signature": "remove(id)",
-        "returns": "this",
-        "description": "Removes a non-root node."
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned row."
+      }
+    ]
+  },
+  "FileList": {
+    "options": [
+      {
+        "name": "items",
+        "type": "FileItemOptions[]",
+        "default": "[]",
+        "description": "Initial files in host-supplied order."
       },
       {
-        "name": "move",
-        "signature": "move(id, parentId, index)",
-        "returns": "this",
-        "description": "Moves a node into a group while preserving its identity."
+        "name": "label",
+        "type": "string",
+        "default": "'Files'",
+        "description": "Accessible collection name."
       },
       {
-        "name": "validate",
-        "signature": "validate()",
+        "name": "loading",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether initial or incremental files are loading."
+      },
+      {
+        "name": "loadingCount",
+        "type": "number",
+        "default": "3",
+        "description": "Placeholder rows shown for an empty loading list."
+      },
+      {
+        "name": "loadingText",
+        "type": "string",
+        "default": "'Loading files'",
+        "description": "Loading status text."
+      },
+      {
+        "name": "emptyText",
+        "type": "string|number|Node|Component|null",
+        "default": "'No files'",
+        "description": "Empty-state content."
+      }
+    ],
+    "events": [
+      {
+        "name": "activate",
+        "payload": "{id: unknown, index: number, file: Readonly<FileItemState>, href: string, event: MouseEvent}",
+        "description": "Preventable native-file-link listener."
+      },
+      {
+        "name": "action",
+        "payload": "{id: string, fileId: unknown, index: number, action: object, file: Readonly<FileItemState>, event: MouseEvent}",
+        "description": "Preventable file-action listener."
+      },
+      {
+        "name": "datachange",
+        "payload": "{items: Readonly<FileItemState>[]}",
+        "description": "Collection mutation listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "setItems",
+        "signature": "setItems(items, [options])",
+        "returns": "this",
+        "description": "Replaces every file."
+      },
+      {
+        "name": "getItems",
+        "signature": "getItems()",
+        "returns": "Readonly<FileItemState>[]",
+        "description": "Returns defensive snapshots in display order."
+      },
+      {
+        "name": "getItem",
+        "signature": "getItem(id)",
+        "returns": "Readonly<FileItemState>|null",
+        "description": "Returns a defensive snapshot by stable ID."
+      },
+      {
+        "name": "addItem",
+        "signature": "addItem(item, [index], [options])",
+        "returns": "this",
+        "description": "Adds one file at a bounded index."
+      },
+      {
+        "name": "updateItem",
+        "signature": "updateItem(id, values, [options])",
+        "returns": "this",
+        "description": "Patches the first file whose ID is `Object.is`-equal to `id`."
+      },
+      {
+        "name": "removeItem",
+        "signature": "removeItem(id, [options])",
+        "returns": "this",
+        "description": "Removes the first file whose ID is `Object.is`-equal to `id`."
+      },
+      {
+        "name": "setLoading",
+        "signature": "setLoading(loading)",
+        "returns": "this",
+        "description": "Sets initial/incremental loading presentation."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned collection."
+      }
+    ]
+  },
+  "Filter": {
+    "options": [
+      {
+        "name": "fields",
+        "type": "FilterField[]",
+        "default": null,
+        "description": "Field definitions."
+      },
+      {
+        "name": "value",
+        "type": "FilterAst",
+        "default": null,
+        "description": "Initial expression."
+      },
+      {
+        "name": "operators",
+        "type": "Array<{id:string,label:string,arity:'none'|'single'|'pair'|'many',types:string[]}>",
+        "default": null,
+        "description": "Additional/overridden operators."
+      },
+      {
+        "name": "allowGroups",
+        "type": "boolean",
+        "default": "true",
+        "description": "Whether nested groups may be authored."
+      },
+      {
+        "name": "maxDepth",
+        "type": "number",
+        "default": "3",
+        "description": "Maximum nested group depth."
+      },
+      {
+        "name": "maxConditions",
+        "type": "number",
+        "default": "50",
+        "description": "Maximum condition count."
+      },
+      {
+        "name": "searchable",
+        "type": "boolean",
+        "default": "false",
+        "description": "Searchable field, operator and single-choice controls."
+      },
+      {
+        "name": "layout",
+        "type": "'standard'|'compact'",
+        "default": "'standard'",
+        "description": "Condition layout; compact rows adapt to container width."
+      },
+      {
+        "name": "rootLogic",
+        "type": "'and'|'or'|null",
+        "default": "null",
+        "description": "Restrict root logic without rewriting incompatible saved expressions."
+      },
+      {
+        "name": "showApply",
+        "type": "boolean",
+        "default": "true",
+        "description": "Show the internal Apply button."
+      },
+      {
+        "name": "showRootActions",
+        "type": "boolean",
+        "default": "true",
+        "description": "Show Add controls inside the root group as well as the footer."
+      },
+      {
+        "name": "autoApply",
+        "type": "boolean",
+        "default": "false",
+        "description": "Emit apply after every valid mutation."
+      },
+      {
+        "name": "readonly",
+        "type": "boolean",
+        "default": "false",
+        "description": "Prevent mutations while keeping values readable."
+      },
+      {
+        "name": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "description": "Disable all controls."
+      },
+      {
+        "name": "applyLabel",
+        "type": "string",
+        "default": null,
+        "description": "Apply button label. Omitted resolves `filter.apply`, English `Apply filters`."
+      },
+      {
+        "name": "clearLabel",
+        "type": "string",
+        "default": null,
+        "description": "Clear button label. Omitted resolves `filter.clear`, English `Clear`."
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "payload": "Record<string,unknown>",
+        "description": "Draft-change listener."
+      },
+      {
+        "name": "apply",
+        "payload": "Record<string,unknown>",
+        "description": "Valid-apply listener."
+      },
+      {
+        "name": "invalid",
+        "payload": "Record<string,unknown>",
+        "description": "Invalid-apply listener."
+      },
+      {
+        "name": "query",
+        "payload": "Record<string,unknown>",
+        "description": "Async query listener."
+      },
+      {
+        "name": "loaded",
+        "payload": "Record<string,unknown>",
+        "description": "Async loaded listener."
+      },
+      {
+        "name": "error",
+        "payload": "Record<string,unknown>",
+        "description": "Async failure listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "getValue",
+        "signature": "getValue()",
+        "returns": "FilterAst",
+        "description": "Returns a defensive AST copy."
+      },
+      {
+        "name": "setValue",
+        "signature": "setValue(value, [options])",
+        "returns": "this",
+        "description": "Atomically replaces the AST."
+      },
+      {
+        "name": "addCondition",
+        "signature": "addCondition([parentId], [initial])",
+        "returns": "string|null",
+        "description": "Adds a condition to a group."
+      },
+      {
+        "name": "addGroup",
+        "signature": "addGroup([parentId], [logic])",
+        "returns": "string|null",
+        "description": "Adds a nested group."
+      },
+      {
+        "name": "update",
+        "signature": "update(id, patch)",
+        "returns": "this",
+        "description": "Updates a node by stable ID."
+      },
+      {
+        "name": "remove",
+        "signature": "remove(id)",
+        "returns": "this",
+        "description": "Removes a non-root node."
+      },
+      {
+        "name": "move",
+        "signature": "move(id, parentId, index)",
+        "returns": "this",
+        "description": "Moves a node into a group while preserving its identity."
+      },
+      {
+        "name": "validate",
+        "signature": "validate()",
         "returns": "{valid:boolean,errors:Array<Record<string,string>>}",
         "description": "Returns semantic validity and errors."
       },
@@ -3789,6 +4606,102 @@
       }
     ]
   },
+  "FilterPanel": {
+    "options": [
+      {
+        "name": "fields",
+        "type": "Record<string, FilterPanelField>",
+        "default": "{}",
+        "description": "Field metadata exactly as a list response publishes it. An empty map is the ordinary case, not an error: it renders `emptyText`."
+      },
+      {
+        "name": "order",
+        "type": "string[]|null",
+        "default": "null",
+        "description": "Display order by field key; omitted keeps object order. Keys the map does not declare are ignored, and fields the order omits follow in map order."
+      },
+      {
+        "name": "value",
+        "type": "Record<string, unknown>",
+        "default": "{}",
+        "description": "Applied filters. The draft starts as a copy."
+      },
+      {
+        "name": "mode",
+        "type": "FilterPanelMode",
+        "default": "'draft'",
+        "description": "`'draft'` collects edits until `apply()`; `'live'` applies every committed edit."
+      },
+      {
+        "name": "serialize",
+        "type": "FilterPanelSerialize",
+        "default": "'seconds'",
+        "description": "How a date leaves the component. A range's lower bound takes the start of its day and its upper bound the end, so a one-day range matches."
+      },
+      {
+        "name": "emptyText",
+        "type": "string|null",
+        "default": "null",
+        "description": "Text shown when `fields` is empty; null resolves `filterPanel.empty`."
+      },
+      {
+        "name": "msg",
+        "type": "Record<string, string>|Record<string, Record<string, string>>",
+        "default": null,
+        "description": "Localized messages."
+      }
+    ],
+    "events": [
+      {
+        "name": "apply",
+        "payload": "{value}",
+        "description": "Apply listener."
+      },
+      {
+        "name": "change",
+        "payload": "{value, field}",
+        "description": "Change listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "getValue",
+        "signature": "getValue()",
+        "returns": "Record<string, unknown>",
+        "description": "Returns the applied value: only the constraints that are set, with dates serialized through `serialize`. Unknown field types are never part of it."
+      },
+      {
+        "name": "setValue",
+        "signature": "setValue(value)",
+        "returns": "this",
+        "description": "Replaces both the applied value and the draft the controls show. Accepts what `getValue()` returns as well as raw input values, so a value that survived a URL round-trip goes back in."
+      },
+      {
+        "name": "apply",
+        "signature": "apply()",
+        "returns": "this",
+        "description": "Commits the draft. In live mode every committed edit already does this; calling it directly is how a host forces a reload with the values that are on screen."
+      },
+      {
+        "name": "reset",
+        "signature": "reset()",
+        "returns": "this",
+        "description": "Restores the controls to the `value` the panel was constructed with **without committing**, so the filters in force stay in force. This is the Cancel half of a sheet: the panel goes back to showing what is being filtered by. Contrast `clear()`, which commits. In live mode there is no uncommitted draft to hold back, so there it applies like any other edit."
+      },
+      {
+        "name": "clear",
+        "signature": "clear()",
+        "returns": "this",
+        "description": "Empties every control **and commits**, in both modes. \"Clear the filters\" has one meaning, and leaving a list filtered behind a panel showing no filters is not it — the records look missing and nothing on screen explains why. Contrast `reset()`, which restores the controls without committing. The price is one unfiltered load at the moment the button is pressed, which is also the feedback that says the filters are gone."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Destroys the composed controls and puts an enhanced target back as found."
+      }
+    ]
+  },
   "Finder": {
     "options": [
       {
@@ -3963,6 +4876,12 @@
         "type": "boolean",
         "default": "true",
         "description": "Native `novalidate` state."
+      },
+      {
+        "name": "idPrefix",
+        "type": "string|null",
+        "default": "null",
+        "description": "Prefix of the DOM ids generated for the fields of the fieldsets this form builds, as `<idPrefix>-<key>`. Null generates one per form instance, so a form mounted twice never repeats an id. A fieldset's own `idPrefix` wins."
       }
     ],
     "events": [
@@ -3987,7 +4906,7 @@
         "name": "addFieldset",
         "signature": "addFieldset(fieldset)",
         "returns": "Fieldset",
-        "description": "Adds an existing fieldset or constructs one from options."
+        "description": "Adds an existing fieldset or constructs one from options. A constructed fieldset generates its field ids from the form's `idPrefix` unless its options carry their own."
       },
       {
         "name": "setActions",
@@ -4234,6 +5153,12 @@
         "default": "false",
         "description": "Shared selection mode."
       },
+      {
+        "name": "selectionTrigger",
+        "type": "'checkbox'|'card'",
+        "default": "'checkbox'",
+        "description": "Select through a checkbox or the non-interactive card surface."
+      },
       {
         "name": "selection",
         "type": "unknown[]",
@@ -4254,9 +5179,9 @@
       },
       {
         "name": "fieldControls",
-        "type": "boolean",
+        "type": "boolean|import('../view/record-view.js').ViewFieldControlsConfig",
         "default": "true",
-        "description": "Show shared field controls."
+        "description": "Show shared field controls. Redeclared narrower than `RecordViewOptions` it fails declaration emit, because the two option types are intersected."
       },
       {
         "name": "emptyText",
@@ -4336,6 +5261,72 @@
         "default": "'card'",
         "description": "Whether the whole card or only its handle starts a pointer drag. Touch drags from the card body require a long press so the board still scrolls."
       },
+      {
+        "name": "moveHandle",
+        "type": "'keyboard'|'always'",
+        "default": "'keyboard'",
+        "description": "Move-handle presentation. `keyboard` keeps it announced and tabbable but out of sight until it takes focus, because the card itself is already the pointer drag source; `always` shows it alongside the card's other controls. `dragFrom:'handle'` overrides this — a drag source a pointer user cannot see is not a control."
+      },
+      {
+        "name": "entityIcon",
+        "type": "string|((record:KanbanRecord,index:number)=>string|null)|null",
+        "default": "null",
+        "description": "Icon naming what the record is, drawn before the identifier."
+      },
+      {
+        "name": "identifier",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Stable record key shown on the card head."
+      },
+      {
+        "name": "status",
+        "type": "KanbanIndicatorSource",
+        "default": "null",
+        "description": "Status indicator source."
+      },
+      {
+        "name": "statusTones",
+        "type": "Record<string,string>",
+        "default": "{}",
+        "description": "Maps a status value to a semantic tone."
+      },
+      {
+        "name": "priority",
+        "type": "KanbanIndicatorSource",
+        "default": "null",
+        "description": "Priority indicator source."
+      },
+      {
+        "name": "priorityTones",
+        "type": "Record<string,string>",
+        "default": "{}",
+        "description": "Maps a priority value to a semantic tone."
+      },
+      {
+        "name": "progress",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Completion source; a number or `{value,max,label}`."
+      },
+      {
+        "name": "progressMax",
+        "type": "number",
+        "default": "100",
+        "description": "Amount that counts as finished."
+      },
+      {
+        "name": "assignees",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Responsible people; a name, a list, or descriptors."
+      },
+      {
+        "name": "maxAvatars",
+        "type": "number",
+        "default": "3",
+        "description": "Faces drawn before the overflow chip."
+      },
       {
         "name": "multiMove",
         "type": "boolean",
@@ -4424,7 +5415,7 @@
         "name": "renderCard",
         "type": "((context:KanbanCardContext)=>Node|null|undefined)|null",
         "default": "null",
-        "description": "Replaces card content."
+        "description": "Replaces the shared record-card content — eyebrow, titles, and metadata. The preview, selection control, action group, move handle, rule badges, and any configured card head and footer still render, because each of those answers to its own option; clear those options to remove them."
       },
       {
         "name": "renderColumnHeader",
@@ -4767,38 +5758,38 @@
       {
         "name": "placeholder",
         "type": "string",
-        "default": "'Search applications and records'",
-        "description": "Search-field placeholder."
+        "default": null,
+        "description": "Search-field placeholder. Omitted resolves `launcher.placeholder`, English `Search applications and records`."
       },
       {
         "name": "label",
         "type": "string",
-        "default": "'Launcher'",
-        "description": "Dialog and field label."
+        "default": null,
+        "description": "Dialog and field label. Omitted resolves `launcher.label`, English `Launcher`."
       },
       {
         "name": "closeLabel",
         "type": "string",
-        "default": "'Close launcher'",
-        "description": "Close-button accessible label."
+        "default": null,
+        "description": "Close-button accessible label. Omitted resolves `launcher.close`, English `Close launcher`."
       },
       {
         "name": "resultsLabel",
         "type": "string",
-        "default": "'Launcher results'",
-        "description": "Results-region accessible label."
+        "default": null,
+        "description": "Results-region accessible label. Omitted resolves `launcher.results`, English `Launcher results`."
       },
       {
         "name": "emptyText",
         "type": "string",
-        "default": "'No results'",
-        "description": "Empty-state text."
+        "default": null,
+        "description": "Empty-state text. Omitted resolves `launcher.empty`, English `No results`."
       },
       {
         "name": "loadingText",
         "type": "string",
-        "default": "'Searching…'",
-        "description": "Loading-state text."
+        "default": null,
+        "description": "Loading-state text. Omitted resolves `launcher.loading`, English `Searching…`."
       },
       {
         "name": "shortcut",
@@ -4808,7 +5799,7 @@
       },
       {
         "name": "hints",
-        "type": "false|{move?: string, open?: string, close?: string}",
+        "type": "false|{move?: string, open?: string, back?: string, close?: string}",
         "default": null,
         "description": "Visible keyboard hints, or false."
       },
@@ -4822,7 +5813,7 @@
     "events": [
       {
         "name": "select",
-        "payload": "{item, value, source, query}",
+        "payload": "{item, value, source, query, page}",
         "description": "Preventable selection listener."
       },
       {
@@ -4830,6 +5821,11 @@
         "payload": "{query: string}",
         "description": "Query-change listener."
       },
+      {
+        "name": "page",
+        "payload": "{page, path}",
+        "description": "Page-navigation listener."
+      },
       {
         "name": "open",
         "payload": "Record<string, never>",
@@ -4842,16 +5838,28 @@
       },
       {
         "name": "error",
-        "payload": "{source: LauncherSource, error: unknown}",
+        "payload": "{source, error, page}",
         "description": "Source error listener."
       }
     ],
     "methods": [
       {
         "name": "open",
-        "signature": "open()",
+        "signature": "open([options])",
+        "returns": "this",
+        "description": "Opens the launcher and focuses/selects its query. It opens on the root unless `page` names one; already open, `page` navigates there."
+      },
+      {
+        "name": "back",
+        "signature": "back()",
         "returns": "this",
-        "description": "Opens the launcher and focuses/selects its query."
+        "description": "Goes back one page, restoring the level beneath with its query and highlighted option. Does nothing on the root."
+      },
+      {
+        "name": "getPage",
+        "signature": "getPage()",
+        "returns": "LauncherItem|null",
+        "description": "Returns the page shown, or null on the root."
       },
       {
         "name": "close",
@@ -4893,7 +5901,7 @@
         "name": "setItems",
         "signature": "setItems(items)",
         "returns": "this",
-        "description": "Replaces local catalogue items."
+        "description": "Replaces the root's local catalogue items; an open page keeps its own."
       },
       {
         "name": "setCurrent",
@@ -4905,7 +5913,7 @@
         "name": "setSources",
         "signature": "setSources(sources)",
         "returns": "this",
-        "description": "Replaces asynchronous sources and aborts work from the old set."
+        "description": "Replaces the root's asynchronous sources and aborts work from the old set; on a page they load once the root is back."
       },
       {
         "name": "destroy",
@@ -4915,6 +5923,18 @@
       }
     ]
   },
+  "LauncherOpen": {
+    "options": [
+      {
+        "name": "page",
+        "type": "string|number|LauncherItem",
+        "default": null,
+        "description": "Opens straight into a page: the id of a local item with `items` (at any depth of array pages, whose path becomes the back stack), or a page item."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
   "LayoutGrid": {
     "options": [
       {
@@ -4947,9 +5967,182 @@
         "default": "''",
         "description": "Extra class names."
       }
-    ],
-    "events": [],
-    "methods": []
+    ],
+    "events": [],
+    "methods": []
+  },
+  "ListToolbar": {
+    "options": [
+      {
+        "name": "search",
+        "type": "ListToolbarSearch|boolean",
+        "default": "{}",
+        "description": "Search field configuration; `false` omits it."
+      },
+      {
+        "name": "count",
+        "type": "number|null",
+        "default": "null",
+        "description": "Initial result count shown in the live status line."
+      },
+      {
+        "name": "countText",
+        "type": "((count: number) => string)|null",
+        "default": "null",
+        "description": "Formats the count line; omitted uses the `listToolbar.results` message (`'%1 results'`)."
+      },
+      {
+        "name": "views",
+        "type": "Array<string|ListToolbarView>",
+        "default": "[]",
+        "description": "Shape switch entries; `[]` omits the switch."
+      },
+      {
+        "name": "view",
+        "type": "string|null",
+        "default": "null",
+        "description": "Initially selected shape; omitted selects the first entry."
+      },
+      {
+        "name": "tools",
+        "type": "ListToolbarTool[]",
+        "default": "[]",
+        "description": "Tool buttons, in display order."
+      },
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Accessible name of the bar; omitted uses the `listToolbar.label` message."
+      },
+      {
+        "name": "msg",
+        "type": "Record<string, string>|Record<string, Record<string, string>>",
+        "default": null,
+        "description": "Localized messages."
+      }
+    ],
+    "events": [
+      {
+        "name": "search",
+        "payload": "{value: string}",
+        "description": "Search listener."
+      },
+      {
+        "name": "viewchange",
+        "payload": "{view: string, previous: string|null}",
+        "description": "Shape listener."
+      },
+      {
+        "name": "action",
+        "payload": "{id: string, pressed: boolean|null, tool: Element}",
+        "description": "Tool listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "setCount",
+        "signature": "setCount(count)",
+        "returns": "this",
+        "description": "Replaces the count line. `null` clears it, which is the right answer while a request is in flight: the number on screen describes the filters the reader has just changed."
+      },
+      {
+        "name": "getCount",
+        "signature": "getCount()",
+        "returns": "number|null",
+        "description": "Returns the count currently shown, or null when the line is empty."
+      },
+      {
+        "name": "setBadge",
+        "signature": "setBadge(id, value)",
+        "returns": "this",
+        "description": "Replaces a tool's badge and its accessible name with it. `null` removes the badge."
+      },
+      {
+        "name": "setPressed",
+        "signature": "setPressed(id, [pressed])",
+        "returns": "this",
+        "description": "Sets the pressed state of a toggle tool. A tool declared without `pressed` is a plain button and is left alone."
+      },
+      {
+        "name": "setToolDisabled",
+        "signature": "setToolDisabled(id, [disabled])",
+        "returns": "this",
+        "description": "Enables or disables a tool, for instance while its panel is loading."
+      },
+      {
+        "name": "setTools",
+        "signature": "setTools(tools)",
+        "returns": "this",
+        "description": "Replaces every tool. Elements adopted with `addTool()` and a chooser mounted by `bind()` stay where they are."
+      },
+      {
+        "name": "getTool",
+        "signature": "getTool(id)",
+        "returns": "HTMLButtonElement|null",
+        "description": "Returns a tool's button element."
+      },
+      {
+        "name": "getToolsElement",
+        "signature": "getToolsElement()",
+        "returns": "HTMLElement",
+        "description": "The element tools are mounted into. Hand it to a view as `fieldControls: {target}` to place that view's field chooser in this bar without calling `bind()`. A control mounted here by somebody else stays theirs: the toolbar puts back what it adopted through `addTool()` or `bind()`, and everything else goes wherever this slot goes. Use `addTool()` instead to hand the toolbar an element it should return on `destroy()`."
+      },
+      {
+        "name": "addTool",
+        "signature": "addTool(element)",
+        "returns": "this",
+        "description": "Adopts a ready-made control into the tools slot. The element's original position is recorded, and `destroy()` puts it back."
+      },
+      {
+        "name": "setView",
+        "signature": "setView(view, [options])",
+        "returns": "this",
+        "description": "Selects a view shape. A value outside `views` is ignored, so the switch can only ever report one of the shapes it was configured with."
+      },
+      {
+        "name": "getView",
+        "signature": "getView()",
+        "returns": "string|null",
+        "description": "Returns the selected view shape, or null when no shape switch is configured."
+      },
+      {
+        "name": "getSearch",
+        "signature": "getSearch()",
+        "returns": "string",
+        "description": "Returns the current query, or an empty string when the field is omitted."
+      },
+      {
+        "name": "setSearch",
+        "signature": "setSearch(value, [options])",
+        "returns": "this",
+        "description": "Sets the query."
+      },
+      {
+        "name": "focusSearch",
+        "signature": "focusSearch()",
+        "returns": "this",
+        "description": "Focuses the search field, for a host that binds a \"/\" shortcut."
+      },
+      {
+        "name": "bind",
+        "signature": "bind(view)",
+        "returns": "this",
+        "description": "Optional sugar for a `TableView` or `CardView`: it wires the shape switch to the view and mounts the view's field chooser into this bar. Nothing is imported and nothing is required — every capability is feature-detected, so a view that offers none of them still works and still gets `viewchange`, and the host swaps the view itself. See `recordViewCapabilities()` for what is looked for."
+      },
+      {
+        "name": "unbind",
+        "signature": "unbind()",
+        "returns": "this",
+        "description": "Releases a bound view and returns its field chooser to where it was found."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Destroys the search field, returns every adopted control to where it came from, and restores an enhanced target to the markup it had before the takeover."
+      }
+    ]
   },
   "MasterPanel": {
     "options": [
@@ -5071,7 +6264,7 @@
       },
       {
         "name": "open",
-        "signature": "open()",
+        "signature": "open([options])",
         "returns": "this",
         "description": "Opens the menu."
       },
@@ -5101,13 +6294,13 @@
       },
       {
         "name": "focusFirst",
-        "signature": "focusFirst()",
+        "signature": "focusFirst([options])",
         "returns": "this",
         "description": "Opens the menu and focuses its first enabled item."
       },
       {
         "name": "focusLast",
-        "signature": "focusLast()",
+        "signature": "focusLast([options])",
         "returns": "this",
         "description": "Opens the menu and focuses its last enabled item."
       },
@@ -5125,6 +6318,18 @@
       }
     ]
   },
+  "MenuButtonOpen": {
+    "options": [
+      {
+        "name": "returnFocus",
+        "type": "boolean|HTMLElement",
+        "default": "true",
+        "description": "Where focus goes when this opening ends with a selection or Escape: `true` is the trigger, an element is that element (the trigger again if it has left the document), and `false` leaves focus alone."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
   "Message": {
     "options": [
       {
@@ -5192,7 +6397,7 @@
         "name": "timeout",
         "type": "number",
         "default": "4000",
-        "description": "Auto-dismiss delay in milliseconds; zero persists."
+        "description": "Auto-dismiss delay in milliseconds; zero persists. A message with an `action` stays at least 8000ms."
       },
       {
         "name": "closable",
@@ -5200,6 +6405,18 @@
         "default": "true",
         "description": "Whether to render a close button."
       },
+      {
+        "name": "action",
+        "type": "MessageAction|null",
+        "default": "null",
+        "description": "A command button inside the message. The message never times out while the pointer is over it or focus is inside it."
+      },
+      {
+        "name": "leading",
+        "type": "Node|{toElement: () => Node|null}|null",
+        "default": "null",
+        "description": "Visual shown in place of the kind icon, such as an Avatar's element. It is decorative — the message text must say what it shows."
+      },
       {
         "name": "scope",
         "type": "Element|string|null",
@@ -5246,7 +6463,7 @@
         "name": "scope",
         "type": "Element|string|null",
         "default": "null",
-        "description": "Element whose nearest Zx theme scope owns the overlay; defaults to the opener."
+        "description": "Element whose nearest Zx theme scope owns the overlay; defaults to the opener. Resolved on every open, so a scope connected after construction still owns it."
       }
     ],
     "events": [
@@ -5422,6 +6639,24 @@
         "type": "NavigationAction[]",
         "default": "[]",
         "description": "Right-aligned action elements or descriptors."
+      },
+      {
+        "name": "overflow",
+        "type": "boolean",
+        "default": "true",
+        "description": "Whether items collapse into the overflow menu at all. `false` keeps every item in the bar at every width and never shows the More button."
+      },
+      {
+        "name": "overflowBelow",
+        "type": "string|number|false",
+        "default": "'44rem'",
+        "description": "Container inline size at or below which items collapse, as a `px` or `rem` length (a number is read as `px`); `false` disables collapsing exactly as `overflow: false` does. The default is the threshold the stylesheet's own container query carries, and a bar that keeps it collapses in CSS without measuring itself; any other value is watched with a `ResizeObserver`."
+      },
+      {
+        "name": "minVisible",
+        "type": "number",
+        "default": "0",
+        "description": "How many items, counted from the start, never collapse. The default collapses all of them, which is right for a top app bar and wrong for a phone bottom bar — `minVisible: 4` is what makes that bar usable."
       }
     ],
     "events": [
@@ -5927,6 +7162,18 @@
       }
     ]
   },
+  "PriorityIcon": {
+    "options": [
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Accessible name. Without one the glyph is decorative (`aria-hidden`) and must sit beside text, or inside a control with a tooltip, that says the priority."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
   "ProgressBar": {
     "options": [
       {
@@ -6084,6 +7331,18 @@
         "type": "string",
         "default": "''",
         "description": "Input placeholder."
+      },
+      {
+        "name": "okLabel",
+        "type": "string",
+        "default": "'OK'",
+        "description": "Confirmation label."
+      },
+      {
+        "name": "cancelLabel",
+        "type": "string",
+        "default": "'Cancel'",
+        "description": "Cancellation label."
       }
     ],
     "events": [],
@@ -6501,6 +7760,12 @@
         "default": "false",
         "description": "Selection presentation."
       },
+      {
+        "name": "selectionTrigger",
+        "type": "'checkbox'|'card'",
+        "default": "'checkbox'",
+        "description": "Selection affordance for owning views."
+      },
       {
         "name": "selected",
         "type": "boolean",
@@ -6587,9 +7852,9 @@
       },
       {
         "name": "fieldControls",
-        "type": "boolean",
+        "type": "boolean|ViewFieldControlsConfig",
         "default": "true",
-        "description": "Whether concrete views show the shared field chooser."
+        "description": "Whether concrete views show the shared field chooser. `true` renders it in the view's own toolbar and `false` omits it; a `ViewFieldControlsConfig` object renders the same control with a translated `label` and, with `target`, mounts it into a host element such as a list toolbar."
       },
       {
         "name": "emptyText",
@@ -6956,6 +8221,12 @@
         "default": "''",
         "description": "Empty control text."
       },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "''",
+        "description": "Accessible combobox name; falls back to the placeholder."
+      },
       {
         "name": "clearable",
         "type": "boolean",
@@ -7102,7 +8373,7 @@
         "name": "priority",
         "signature": "priority(target, [options])",
         "returns": "Select",
-        "description": "Creates the five-level priority preset."
+        "description": "Creates the five-level priority preset: values 0 (lowest) to 4 (highest), each drawn as grey signal bars filled to its level, except the highest, which is the one coloured level — a danger square with an exclamation mark. A \"No priority\" row (value null, a row of dashes) heads the list and labels the empty control; `clearable: false` removes it."
       },
       {
         "name": "status",
@@ -7685,6 +8956,85 @@
       }
     ]
   },
+  "SortControl": {
+    "options": [
+      {
+        "name": "fields",
+        "type": "SortField[]",
+        "default": "[]",
+        "description": "Available sort fields, in display order."
+      },
+      {
+        "name": "value",
+        "type": "SortValue|null",
+        "default": "null",
+        "description": "Initial sort; null chooses the first field ascending."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Sort by'",
+        "description": "Accessible field label and direction-name prefix."
+      },
+      {
+        "name": "labels",
+        "type": "{asc?:string,desc?:string}",
+        "default": "{}",
+        "description": "Current/next direction labels, defaulting to Ascending/Descending."
+      },
+      {
+        "name": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether interaction is disabled."
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "payload": "{value:SortValue}",
+        "description": "Atomic field/direction change."
+      }
+    ],
+    "methods": [
+      {
+        "name": "getValue",
+        "signature": "getValue()",
+        "returns": "SortValue|null",
+        "description": "Returns a defensive copy of the current sort."
+      },
+      {
+        "name": "setValue",
+        "signature": "setValue(value, [options])",
+        "returns": "this",
+        "description": "Replaces the field and direction atomically; rejects unavailable fields and directions."
+      },
+      {
+        "name": "enable",
+        "signature": "enable()",
+        "returns": "this",
+        "description": "Enables both controls when fields are available."
+      },
+      {
+        "name": "disable",
+        "signature": "disable()",
+        "returns": "this",
+        "description": "Disables both controls and closes the option panel."
+      },
+      {
+        "name": "focus",
+        "signature": "focus()",
+        "returns": "this",
+        "description": "Focuses the searchable control."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Releases the owned Select and restores an enhanced target."
+      }
+    ]
+  },
   "Spinner": {
     "options": [
       {
@@ -7935,6 +9285,163 @@
     "events": [],
     "methods": []
   },
+  "StatTile": {
+    "options": [
+      {
+        "name": "label",
+        "type": "string",
+        "default": "''",
+        "description": "The metric's name, set small above the value."
+      },
+      {
+        "name": "value",
+        "type": "number|string|null",
+        "default": "null",
+        "description": "The metric. A string is rendered as given."
+      },
+      {
+        "name": "format",
+        "type": "StatTileFormat",
+        "default": "'number'",
+        "description": "How a numeric value is rendered: a named mode, a callback receiving the raw value, or null to print the value unformatted."
+      },
+      {
+        "name": "currency",
+        "type": "string|null",
+        "default": "null",
+        "description": "ISO 4217 code used by `format: 'currency'`."
+      },
+      {
+        "name": "caption",
+        "type": "string",
+        "default": "''",
+        "description": "A muted context line under the value — what the number is out of or measured in, e.g. `'of 13,184'` or `'open tickets'`. Part of the accessible name."
+      },
+      {
+        "name": "locale",
+        "type": "string",
+        "default": null,
+        "description": "BCP 47 tag for every formatter; defaults to the active language."
+      },
+      {
+        "name": "delta",
+        "type": "number|string|null",
+        "default": "null",
+        "description": "Change against the previous period. Rendered with its own sign and an arrow, never with colour alone."
+      },
+      {
+        "name": "deltaKind",
+        "type": "StatTileDeltaKind",
+        "default": "'neutral'",
+        "description": "Whether the change is good, bad, or merely a change. This — not the sign's direction — picks the delta colour: a rising ticket count is not a success, so \"up is good\" is never assumed."
+      },
+      {
+        "name": "deltaFormat",
+        "type": "StatTileFormat",
+        "default": null,
+        "description": "How the delta is rendered; defaults to `format`."
+      },
+      {
+        "name": "deltaLabel",
+        "type": "string",
+        "default": "''",
+        "description": "What the change is measured against, e.g. `'vs. last week'`."
+      },
+      {
+        "name": "trend",
+        "type": "number[]",
+        "default": "[]",
+        "description": "Values for a decorative sparkline. Fewer than two usable numbers render nothing."
+      },
+      {
+        "name": "icon",
+        "type": "string|null",
+        "default": "null",
+        "description": "Icon name from `icons.js`, shown muted beside the label — a glyph, not a coloured chip."
+      },
+      {
+        "name": "kind",
+        "type": "StatTileKind",
+        "default": "'neutral'",
+        "description": "Semantic intent. It tints the sparkline and never the value, which stays at full text contrast whatever intent a record carries."
+      },
+      {
+        "name": "href",
+        "type": "string|null",
+        "default": "null",
+        "description": "Destination. A tile with an href is an `<a>`."
+      },
+      {
+        "name": "clickable",
+        "type": "boolean",
+        "default": "false",
+        "description": "Renders a `<button>` without an href. Passing `onclick` sets this implicitly; set it directly to subscribe with `on('click', …)` instead."
+      },
+      {
+        "name": "loading",
+        "type": "boolean",
+        "default": "false",
+        "description": "Renders a skeleton shaped like the tile."
+      },
+      {
+        "name": "msg",
+        "type": "Record<string, unknown>",
+        "default": null,
+        "description": "Message overrides, keyed as `statTile.*`."
+      }
+    ],
+    "events": [
+      {
+        "name": "click",
+        "payload": "{event: MouseEvent}",
+        "description": "Activation listener; its presence is what turns a tile with no href into a button. It is the tile's `click` event, as every Zx component's `on*` option is, so it receives the `CustomEvent` carrying the native event in `detail.event`."
+      }
+    ],
+    "methods": [
+      {
+        "name": "update",
+        "signature": "update(options)",
+        "returns": "this",
+        "description": "Replaces any subset of the tile's content and redraws it. This is how a tile leaves `loading: true` behind once the server answers."
+      },
+      {
+        "name": "getAccessibleName",
+        "signature": "getAccessibleName()",
+        "returns": "string",
+        "description": "Reports the tile's own accessible name, which is what assistive technology announces."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Aborts listeners and restores an adopted target to the state it was found in."
+      }
+    ]
+  },
+  "StatusIcon": {
+    "options": [
+      {
+        "name": "indicator",
+        "type": "StatusIndicator",
+        "default": null,
+        "description": "Shape, overriding the status's own."
+      },
+      {
+        "name": "tone",
+        "type": "StatusTone",
+        "default": null,
+        "description": "Colour, overriding the status's own."
+      },
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Accessible name. Without one the glyph is decorative (`aria-hidden`) and must sit beside text, or inside a control with a tooltip, that says the status."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
   "Stepper": {
     "options": [
       {
@@ -8099,6 +9606,12 @@
         "type": "boolean",
         "default": "true",
         "description": "Keep inactive panel elements mounted."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": null,
+        "description": "Accessible name of the tab list — what the tabs switch between (\"Record sections\"). A tab list needs one whenever the page has more than one, and screen readers announce it on entry."
       }
     ],
     "events": [
@@ -8244,12 +9757,30 @@
         "default": "null",
         "description": "Additional row class callback."
       },
+      {
+        "name": "rowKind",
+        "type": "string|((row: TableRow) => unknown)|null",
+        "default": "null",
+        "description": "Row property or callback naming each row's kind — the `type` on a ZeyOS transaction line, where one value is a position carrying quantities and amounts and another is a section heading that groups the positions under it. `null`, the default, renders every row exactly as before."
+      },
+      {
+        "name": "rowKinds",
+        "type": "Record<string, TableRowKind>|null",
+        "default": "null",
+        "description": "Presentation per kind, keyed by the resolved kind coerced to a string. A kind with no entry here renders as an ordinary row. While any row in the current data resolves to a `span` kind the header sort controls are withheld and `setSort()` is inert: sorting a grouped table scatters the positions out of their sections, and doing that silently is worse than not offering it. `sortMode: 'server'` still owns its own order."
+      },
       {
         "name": "zebra",
         "type": "boolean",
         "default": "true",
         "description": "Whether alternate rows use the zebra background."
       },
+      {
+        "name": "variant",
+        "type": "TableVariant",
+        "default": "'default'",
+        "description": "Frame treatment. `'default'` draws the table's own bordered box; `'plain'` is for a table inside a card or panel that already draws one — no outer frame, no header band, no zebra, hairline row dividers. Reflected as `data-variant` on the root."
+      },
       {
         "name": "editMode",
         "type": "TableEditMode",
@@ -8483,7 +10014,7 @@
         "name": "setSort",
         "signature": "setSort(id, [dir], [options])",
         "returns": "this",
-        "description": "Activates a column sort. Local mode stably reorders data; server mode only updates the header state and emits the request event."
+        "description": "Activates a column sort. Local mode stably reorders data; server mode only updates the header state and emits the request event. Inert while the data holds a spanning row: a sort would scatter the positions out of the sections that group them, in either sort mode. The header withholds its controls for the same reason, so nothing on screen invites the call."
       },
       {
         "name": "getSort",
@@ -8695,9 +10226,9 @@
       },
       {
         "name": "fieldControls",
-        "type": "boolean",
+        "type": "boolean|import('../view/record-view.js').ViewFieldControlsConfig",
         "default": "true",
-        "description": "Show the accessible visibility and reorder disclosure."
+        "description": "Show the accessible visibility and reorder disclosure. `true` keeps the composed Table's own column chooser and `false` omits it; an object renders the shared record-view chooser instead, with a translated `label` and, with `target`, mounted into a host element."
       },
       {
         "name": "emptyText",
@@ -8805,7 +10336,13 @@
         "name": "colorKey",
         "type": "TagValueReader",
         "default": "'color'",
-        "description": "Optional item colour property or reader."
+        "description": "Optional item colour property or reader: a CSS colour or a token reference such as `var(--zx-color-tone-blue-fg)`."
+      },
+      {
+        "name": "toneKey",
+        "type": "TagValueReader",
+        "default": "'tone'",
+        "description": "Optional item tone property or reader: a categorical tone name from the Badge palette (`blue`, `teal`, `green`, `amber`, `orange`, `red`, `pink`, `violet`, `slate`). A toned tag takes the palette's fill and ink, as a Badge with that `tone` does; a tone wins over a colour, and unknown names are ignored."
       },
       {
         "name": "searchKeys",
@@ -8871,7 +10408,7 @@
         "name": "readonly",
         "type": "boolean",
         "default": "false",
-        "description": "Whether tags may be added or removed."
+        "description": "When true the picker shows only its tags — no input, chevron, or remove buttons."
       },
       {
         "name": "renderItem",