@zeyos/zx 4.3.0 → 4.4.0

package/docs/api.json

@@ -106,6 +106,248 @@
       }
     ]
   },
+  "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": "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": [
       {
@@ -817,6 +1059,12 @@
         "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 +1635,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 +1661,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",
@@ -1468,7 +1722,7 @@
       {
         "name": "minCardWidth",
         "type": "number|string",
-        "default": "'18rem'",
+        "default": "'15rem'",
         "description": "Responsive minimum card width."
       },
       {
@@ -1901,6 +2155,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": [
       {
@@ -3195,29 +3545,149 @@
     "events": [],
     "methods": []
   },
-  "EntitySelect": {
+  "EntityRef": {
     "options": [
       {
-        "name": "recent",
-        "type": "SelectItem[]",
-        "default": "[]",
-        "description": "Choices pinned above ordinary results."
+        "name": "id",
+        "type": "unknown",
+        "default": "null",
+        "description": "Application-owned entity identifier included in events."
       },
       {
-        "name": "recentLabel",
+        "name": "title",
         "type": "string",
-        "default": "'Recent'",
-        "description": "Heading above recent choices."
+        "default": "''",
+        "description": "Primary identity text."
       },
       {
-        "name": "create",
-        "type": "boolean|SelectAction",
-        "default": "false",
-        "description": "Optional create command at the bottom."
+        "name": "subtitle",
+        "type": "EntityRefContent",
+        "default": "null",
+        "description": "Secondary identity text or safe caller-supplied content."
       },
       {
-        "name": "iconKey",
-        "type": "string|((item: SelectItem)=>unknown)",
+        "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": "Density-independent identity size."
+      },
+      {
+        "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": [
+      {
+        "name": "recent",
+        "type": "SelectItem[]",
+        "default": "[]",
+        "description": "Choices pinned above ordinary results."
+      },
+      {
+        "name": "recentLabel",
+        "type": "string",
+        "default": "'Recent'",
+        "description": "Heading above recent choices."
+      },
+      {
+        "name": "create",
+        "type": "boolean|SelectAction",
+        "default": "false",
+        "description": "Optional create command at the bottom."
+      },
+      {
+        "name": "iconKey",
+        "type": "string|((item: SelectItem)=>unknown)",
         "default": "'icon'",
         "description": "Item icon reader."
       },
@@ -3619,177 +4089,566 @@
       }
     ]
   },
-  "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."
       },
       {
-        "name": "maxDepth",
-        "type": "number",
-        "default": "3",
-        "description": "Maximum nested group depth."
+        "name": "subtitle",
+        "type": "EntityRefContent",
+        "default": "null",
+        "description": "Optional supporting text before generated metadata."
       },
       {
-        "name": "maxConditions",
-        "type": "number",
-        "default": "50",
-        "description": "Maximum condition count."
+        "name": "icon",
+        "type": "EntityRefIcon",
+        "default": "'file'",
+        "description": "File icon name, node, component, or lazy renderer."
       },
       {
-        "name": "autoApply",
-        "type": "boolean",
-        "default": "false",
-        "description": "Emit apply after every valid mutation."
+        "name": "metadata",
+        "type": "EntityRefMetadata[]",
+        "default": "[]",
+        "description": "Additional labelled metadata."
       },
       {
-        "name": "readonly",
-        "type": "boolean",
-        "default": "false",
-        "description": "Prevent mutations while keeping values readable."
+        "name": "link",
+        "type": "EntityRefLinkValue",
+        "default": "null",
+        "description": "Optional safe native file/download link."
       },
       {
-        "name": "disabled",
-        "type": "boolean",
-        "default": "false",
-        "description": "Disable all controls."
+        "name": "actions",
+        "type": "EntityRefActionEntry[]",
+        "default": "[]",
+        "description": "File actions; application policy stays external."
       },
       {
-        "name": "applyLabel",
-        "type": "string",
-        "default": "'Apply filters'",
-        "description": "Apply button label."
+        "name": "status",
+        "type": "FileStatus",
+        "default": "'ready'",
+        "description": "Durable or transient presentation state."
       },
       {
-        "name": "clearLabel",
-        "type": "string",
-        "default": "'Clear'",
-        "description": "Clear button label."
-      }
-    ],
-    "events": [
+        "name": "statusLabel",
+        "type": "string|null",
+        "default": "null",
+        "description": "Overrides the generated state label; an empty string hides it."
+      },
       {
-        "name": "change",
-        "payload": "Record<string,unknown>",
-        "description": "Draft-change listener."
+        "name": "progress",
+        "type": "number|null",
+        "default": "null",
+        "description": "Completed percentage, clamped to 0–100."
       },
       {
-        "name": "apply",
-        "payload": "Record<string,unknown>",
-        "description": "Valid-apply listener."
+        "name": "indeterminate",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether active progress has no known amount."
       },
       {
-        "name": "invalid",
-        "payload": "Record<string,unknown>",
-        "description": "Invalid-apply listener."
+        "name": "density",
+        "type": "'sm'|'md'|'lg'",
+        "default": "'md'",
+        "description": "File-identity presentation size."
       },
       {
-        "name": "query",
-        "payload": "Record<string,unknown>",
-        "description": "Async query listener."
+        "name": "wrap",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether long identity text may wrap."
       },
       {
-        "name": "loaded",
-        "payload": "Record<string,unknown>",
-        "description": "Async loaded listener."
+        "name": "actionsLabel",
+        "type": "string",
+        "default": "'File actions'",
+        "description": "Accessible name for secondary actions."
       },
       {
-        "name": "error",
-        "payload": "Record<string,unknown>",
-        "description": "Async failure listener."
+        "name": "locale",
+        "type": "string",
+        "default": null,
+        "description": "Locale passed to `formatFileSize`."
       }
     ],
-    "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."
-      },
+    "events": [
       {
-        "name": "addCondition",
-        "signature": "addCondition([parentId], [initial])",
-        "returns": "string|null",
-        "description": "Adds a condition to a group."
+        "name": "activate",
+        "payload": "{id: unknown, file: Readonly<FileItemState>, href: string, event: MouseEvent}",
+        "description": "Preventable native-link listener."
       },
       {
-        "name": "addGroup",
-        "signature": "addGroup([parentId], [logic])",
-        "returns": "string|null",
-        "description": "Adds a nested group."
-      },
+        "name": "action",
+        "payload": "{id: string, fileId: unknown, action: object, file: Readonly<FileItemState>, event: MouseEvent}",
+        "description": "Preventable file-action listener."
+      }
+    ],
+    "methods": [
       {
-        "name": "update",
-        "signature": "update(id, patch)",
+        "name": "set",
+        "signature": "set(values)",
         "returns": "this",
-        "description": "Updates a node by stable ID."
+        "description": "Updates any subset of the file without replacing the row root."
       },
       {
-        "name": "remove",
-        "signature": "remove(id)",
+        "name": "setStatus",
+        "signature": "setStatus(status, [statusLabel])",
         "returns": "this",
-        "description": "Removes a non-root node."
+        "description": "Updates the file lifecycle state and, optionally, its visible label."
       },
       {
-        "name": "move",
-        "signature": "move(id, parentId, index)",
+        "name": "setProgress",
+        "signature": "setProgress(progress, [options])",
         "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."
+        "description": "Updates the progress meter."
       },
       {
-        "name": "apply",
-        "signature": "apply()",
-        "returns": "FilterAst|null",
-        "description": "Applies only a valid AST."
+        "name": "getFile",
+        "signature": "getFile()",
+        "returns": "Readonly<FileItemState>",
+        "description": "Returns a defensive file snapshot."
       },
       {
-        "name": "clear",
-        "signature": "clear([options])",
+        "name": "focus",
+        "signature": "focus()",
         "returns": "this",
-        "description": "Clears all conditions."
+        "description": "Focuses the native destination or first enabled action."
       },
       {
-        "name": "focus",
-        "signature": "focus([id])",
-        "returns": "this",
-        "description": "Focuses a condition's field or the Add button."
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned row."
       }
     ]
   },
-  "Finder": {
+  "FileList": {
+    "options": [
+      {
+        "name": "items",
+        "type": "FileItemOptions[]",
+        "default": "[]",
+        "description": "Initial files in host-supplied order."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Files'",
+        "description": "Accessible collection name."
+      },
+      {
+        "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."
+      },
+      {
+        "name": "apply",
+        "signature": "apply()",
+        "returns": "FilterAst|null",
+        "description": "Applies only a valid AST."
+      },
+      {
+        "name": "clear",
+        "signature": "clear([options])",
+        "returns": "this",
+        "description": "Clears all conditions."
+      },
+      {
+        "name": "focus",
+        "signature": "focus([id])",
+        "returns": "this",
+        "description": "Focuses a condition's field or the Add button."
+      }
+    ]
+  },
+  "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": [
       {
         "name": "items",
@@ -4234,6 +5093,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 +5119,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",
@@ -4271,64 +5136,256 @@
         "description": "Column accessor."
       },
       {
-        "name": "columns",
-        "type": "KanbanColumn[]|null",
-        "default": "null",
-        "description": "Explicit columns, or null to derive them."
+        "name": "columns",
+        "type": "KanbanColumn[]|null",
+        "default": "null",
+        "description": "Explicit columns, or null to derive them."
+      },
+      {
+        "name": "swimlaneBy",
+        "type": "KanbanAccessor",
+        "default": "null",
+        "description": "Optional swim-lane accessor."
+      },
+      {
+        "name": "swimlanes",
+        "type": "KanbanSwimlane[]|null",
+        "default": "null",
+        "description": "Explicit lanes, or null to derive them."
+      },
+      {
+        "name": "titleField",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Card title field or reader."
+      },
+      {
+        "name": "subtitleField",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Card subtitle field or reader."
+      },
+      {
+        "name": "preview",
+        "type": "string|((record:KanbanRecord,index:number)=>RecordCardPreview)|null",
+        "default": "null",
+        "description": "Preview field or reader."
+      },
+      {
+        "name": "previewAlt",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Preview alternative-text field or reader."
+      },
+      {
+        "name": "link",
+        "type": "RecordCardLink|((record:KanbanRecord,index:number)=>RecordCardLink)|null",
+        "default": "null",
+        "description": "Record-card primary link descriptor or reader."
+      },
+      {
+        "name": "actions",
+        "type": "RecordCardAction[]|((record:KanbanRecord,index:number)=>RecordCardAction[])",
+        "default": "[]",
+        "description": "Card actions."
+      },
+      {
+        "name": "moveMode",
+        "type": "'local'|'external'",
+        "default": "'local'",
+        "description": "Whether accepted moves update local data."
+      },
+      {
+        "name": "dragFrom",
+        "type": "'card'|'handle'",
+        "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",
+        "default": "true",
+        "description": "Move the whole selection when a selected card is picked up."
+      },
+      {
+        "name": "autoScroll",
+        "type": "boolean",
+        "default": "true",
+        "description": "Scroll the board and columns while dragging near an edge."
+      },
+      {
+        "name": "wipPolicy",
+        "type": "'warn'|'block'",
+        "default": "'warn'",
+        "description": "Whether exceeding a limit warns or refuses."
+      },
+      {
+        "name": "rules",
+        "type": "KanbanRule[]",
+        "default": "[]",
+        "description": "Ordered visual card rules."
+      },
+      {
+        "name": "search",
+        "type": "string",
+        "default": "''",
+        "description": "Board search text."
+      },
+      {
+        "name": "searchFields",
+        "type": "string[]|null",
+        "default": "null",
+        "description": "Field ids searched; null searches visible fields plus the title and subtitle sources."
+      },
+      {
+        "name": "filter",
+        "type": "((record:KanbanRecord,index:number)=>boolean)|null",
+        "default": "null",
+        "description": "Extra card predicate."
+      },
+      {
+        "name": "searchControl",
+        "type": "boolean",
+        "default": "false",
+        "description": "Render the built-in board search control."
+      },
+      {
+        "name": "history",
+        "type": "boolean",
+        "default": "true",
+        "description": "Record committed local moves for undo and redo."
+      },
+      {
+        "name": "historyLimit",
+        "type": "number",
+        "default": "50",
+        "description": "Maximum remembered move steps."
+      },
+      {
+        "name": "historyControls",
+        "type": "boolean",
+        "default": "false",
+        "description": "Render built-in undo and redo controls."
       },
       {
-        "name": "swimlaneBy",
-        "type": "KanbanAccessor",
+        "name": "columnHeight",
+        "type": "string|null",
         "default": "null",
-        "description": "Optional swim-lane accessor."
+        "description": "CSS length turning each column into a scroll region."
       },
       {
-        "name": "swimlanes",
-        "type": "KanbanSwimlane[]|null",
-        "default": "null",
-        "description": "Explicit lanes, or null to derive them."
+        "name": "allowAdd",
+        "type": "boolean|((column:KanbanColumn,swimlane:KanbanSwimlane|null)=>boolean)",
+        "default": "false",
+        "description": "Render a per-column add control that emits `recordadd`."
       },
       {
-        "name": "titleField",
-        "type": "KanbanCardField",
-        "default": "null",
-        "description": "Card title field or reader."
+        "name": "contextMenu",
+        "type": "boolean|MenuItem[]|((context:KanbanCardContext)=>MenuItem[])",
+        "default": "false",
+        "description": "Card context menu. `true` offers move commands; an array or function appends application items."
       },
       {
-        "name": "subtitleField",
-        "type": "KanbanCardField",
+        "name": "renderCard",
+        "type": "((context:KanbanCardContext)=>Node|null|undefined)|null",
         "default": "null",
-        "description": "Card subtitle field or reader."
+        "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": "preview",
-        "type": "string|((record:KanbanRecord,index:number)=>RecordCardPreview)|null",
+        "name": "renderColumnHeader",
+        "type": "((context:KanbanHeaderContext)=>Node|null|undefined)|null",
         "default": "null",
-        "description": "Preview field or reader."
+        "description": "Replaces column header content."
       },
       {
-        "name": "previewAlt",
-        "type": "KanbanCardField",
+        "name": "renderSwimlaneHeader",
+        "type": "((context:KanbanHeaderContext)=>Node|null|undefined)|null",
         "default": "null",
-        "description": "Preview alternative-text field or reader."
+        "description": "Replaces lane header content."
       },
       {
-        "name": "link",
-        "type": "RecordCardLink|((record:KanbanRecord,index:number)=>RecordCardLink)|null",
+        "name": "renderColumnEmpty",
+        "type": "((context:KanbanHeaderContext)=>Node|null|undefined)|null",
         "default": "null",
-        "description": "Record-card primary link descriptor or reader."
+        "description": "Empty-column placeholder."
       },
       {
-        "name": "actions",
-        "type": "RecordCardAction[]|((record:KanbanRecord,index:number)=>RecordCardAction[])",
-        "default": "[]",
-        "description": "Card actions."
+        "name": "renderDragPreview",
+        "type": "((context:{records:KanbanRecord[],ids:unknown[],count:number})=>Node|null|undefined)|null",
+        "default": "null",
+        "description": "Replaces the floating drag preview."
       },
       {
-        "name": "moveMode",
-        "type": "'local'|'external'",
-        "default": "'local'",
-        "description": "Whether accepted moves update local data."
+        "name": "labels",
+        "type": "Record<string,string>",
+        "default": "{}",
+        "description": "Overrides for every visible and announced string."
       },
       {
         "name": "columnOrder",
@@ -4385,10 +5442,30 @@
         "payload": "Record<string,unknown>",
         "description": ""
       },
+      {
+        "name": "movereject",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      },
       {
         "name": "recordaction",
         "payload": "Record<string,unknown>",
         "description": ""
+      },
+      {
+        "name": "recordadd",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      },
+      {
+        "name": "searchchange",
+        "payload": "{search:string}",
+        "description": ""
+      },
+      {
+        "name": "historychange",
+        "payload": "{canUndo:boolean,canRedo:boolean,depth:{undo:number,redo:number}}",
+        "description": ""
       }
     ],
     "methods": [
@@ -4492,7 +5569,73 @@
         "name": "moveRecord",
         "signature": "moveRecord(id, destination)",
         "returns": "this",
-        "description": "Proposes and, in local mode, commits a record move. Destination acceptance is checked before a cancelable `recordmove` event. WIP limits are reported but remain advisory."
+        "description": "Proposes and, in local mode, commits a record move. Equivalent to `moveRecords([id], …)`."
+      },
+      {
+        "name": "moveRecords",
+        "signature": "moveRecords(ids, destination)",
+        "returns": "this",
+        "description": "Proposes and, in local mode, commits an atomic move of one or more records. Destination eligibility, transition rules, and work-in-progress policy are all checked before a single cancelable `recordmove` event; the move commits completely or not at all, and the moving records keep their relative order at the destination."
+      },
+      {
+        "name": "canUndo",
+        "signature": "canUndo()",
+        "returns": "boolean",
+        "description": "Whether a committed local move can be reverted."
+      },
+      {
+        "name": "canRedo",
+        "signature": "canRedo()",
+        "returns": "boolean",
+        "description": "Whether a reverted local move can be reapplied."
+      },
+      {
+        "name": "undo",
+        "signature": "undo()",
+        "returns": "this",
+        "description": "Reverts the last committed local move, restoring the exact record order and selection."
+      },
+      {
+        "name": "redo",
+        "signature": "redo()",
+        "returns": "this",
+        "description": "Reapplies the last reverted local move."
+      },
+      {
+        "name": "clearHistory",
+        "signature": "clearHistory()",
+        "returns": "this",
+        "description": "Empties both history stacks."
+      },
+      {
+        "name": "getSearch",
+        "signature": "getSearch()",
+        "returns": "string",
+        "description": "Returns the current board search text."
+      },
+      {
+        "name": "setSearch",
+        "signature": "setSearch(search, [options])",
+        "returns": "this",
+        "description": "Narrows visible cards to those matching a search. Hidden records keep their position in the data, so a card dropped between two visible cards still lands between them."
+      },
+      {
+        "name": "setFilter",
+        "signature": "setFilter(filter)",
+        "returns": "this",
+        "description": "Replaces the extra card predicate. Pass null to clear it."
+      },
+      {
+        "name": "getVisibleRecords",
+        "signature": "getVisibleRecords()",
+        "returns": "KanbanRecord[]",
+        "description": "Returns the records currently rendered, in board order."
+      },
+      {
+        "name": "setData",
+        "signature": "setData(records)",
+        "returns": "this",
+        "description": "Replaces every record. History is dropped because its snapshots describe records the host has just replaced, and reinstating them would resurrect data the application no longer owns."
       },
       {
         "name": "getViewState",
@@ -4555,38 +5698,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",
@@ -4648,96 +5791,269 @@
         "description": "Closes the launcher."
       },
       {
-        "name": "toggle",
-        "signature": "toggle()",
+        "name": "toggle",
+        "signature": "toggle()",
+        "returns": "this",
+        "description": "Toggles the launcher."
+      },
+      {
+        "name": "isOpen",
+        "signature": "isOpen()",
+        "returns": "boolean",
+        "description": "Reports whether the launcher is open."
+      },
+      {
+        "name": "focus",
+        "signature": "focus()",
+        "returns": "this",
+        "description": "Focuses and selects the query field."
+      },
+      {
+        "name": "setQuery",
+        "signature": "setQuery(query)",
+        "returns": "this",
+        "description": "Replaces the query and refreshes local and remote results."
+      },
+      {
+        "name": "getQuery",
+        "signature": "getQuery()",
+        "returns": "string",
+        "description": "Returns the untrimmed query."
+      },
+      {
+        "name": "setItems",
+        "signature": "setItems(items)",
+        "returns": "this",
+        "description": "Replaces local catalogue items."
+      },
+      {
+        "name": "setCurrent",
+        "signature": "setCurrent(id)",
+        "returns": "this",
+        "description": "Marks one local item as the current destination."
+      },
+      {
+        "name": "setSources",
+        "signature": "setSources(sources)",
+        "returns": "this",
+        "description": "Replaces asynchronous sources and aborts work from the old set."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Aborts sources and removes the owned dialog."
+      }
+    ]
+  },
+  "LayoutGrid": {
+    "options": [
+      {
+        "name": "columns",
+        "type": "number|null",
+        "default": "null",
+        "description": "Column count at full width. Null fills the row with as many tracks of `min` width as fit."
+      },
+      {
+        "name": "min",
+        "type": "number|string",
+        "default": "'16rem'",
+        "description": "Narrowest a track may get before the grid drops a column. A number is read as pixels."
+      },
+      {
+        "name": "gap",
+        "type": "number|string",
+        "default": "4",
+        "description": "Space between cells, as in `stack`."
+      },
+      {
+        "name": "align",
+        "type": "'start'|'center'|'end'|'stretch'",
+        "default": null,
+        "description": "Block-axis alignment of each cell."
+      },
+      {
+        "name": "class",
+        "type": "string",
+        "default": "''",
+        "description": "Extra class names."
+      }
+    ],
+    "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": "Toggles the launcher."
+        "description": "Sets the pressed state of a toggle tool. A tool declared without `pressed` is a plain button and is left alone."
       },
       {
-        "name": "isOpen",
-        "signature": "isOpen()",
-        "returns": "boolean",
-        "description": "Reports whether the launcher is open."
+        "name": "setToolDisabled",
+        "signature": "setToolDisabled(id, [disabled])",
+        "returns": "this",
+        "description": "Enables or disables a tool, for instance while its panel is loading."
       },
       {
-        "name": "focus",
-        "signature": "focus()",
+        "name": "setTools",
+        "signature": "setTools(tools)",
         "returns": "this",
-        "description": "Focuses and selects the query field."
+        "description": "Replaces every tool. Elements adopted with `addTool()` and a chooser mounted by `bind()` stay where they are."
       },
       {
-        "name": "setQuery",
-        "signature": "setQuery(query)",
-        "returns": "this",
-        "description": "Replaces the query and refreshes local and remote results."
+        "name": "getTool",
+        "signature": "getTool(id)",
+        "returns": "HTMLButtonElement|null",
+        "description": "Returns a tool's button element."
       },
       {
-        "name": "getQuery",
-        "signature": "getQuery()",
-        "returns": "string",
-        "description": "Returns the untrimmed query."
+        "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": "setItems",
-        "signature": "setItems(items)",
+        "name": "addTool",
+        "signature": "addTool(element)",
         "returns": "this",
-        "description": "Replaces local catalogue items."
+        "description": "Adopts a ready-made control into the tools slot. The element's original position is recorded, and `destroy()` puts it back."
       },
       {
-        "name": "setCurrent",
-        "signature": "setCurrent(id)",
+        "name": "setView",
+        "signature": "setView(view, [options])",
         "returns": "this",
-        "description": "Marks one local item as the current destination."
+        "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": "setSources",
-        "signature": "setSources(sources)",
-        "returns": "this",
-        "description": "Replaces asynchronous sources and aborts work from the old set."
+        "name": "getView",
+        "signature": "getView()",
+        "returns": "string|null",
+        "description": "Returns the selected view shape, or null when no shape switch is configured."
       },
       {
-        "name": "destroy",
-        "signature": "destroy()",
-        "returns": "void",
-        "description": "Aborts sources and removes the owned dialog."
-      }
-    ]
-  },
-  "LayoutGrid": {
-    "options": [
+        "name": "getSearch",
+        "signature": "getSearch()",
+        "returns": "string",
+        "description": "Returns the current query, or an empty string when the field is omitted."
+      },
       {
-        "name": "columns",
-        "type": "number|null",
-        "default": "null",
-        "description": "Column count at full width. Null fills the row with as many tracks of `min` width as fit."
+        "name": "setSearch",
+        "signature": "setSearch(value, [options])",
+        "returns": "this",
+        "description": "Sets the query."
       },
       {
-        "name": "min",
-        "type": "number|string",
-        "default": "'16rem'",
-        "description": "Narrowest a track may get before the grid drops a column. A number is read as pixels."
+        "name": "focusSearch",
+        "signature": "focusSearch()",
+        "returns": "this",
+        "description": "Focuses the search field, for a host that binds a \"/\" shortcut."
       },
       {
-        "name": "gap",
-        "type": "number|string",
-        "default": "4",
-        "description": "Space between cells, as in `stack`."
+        "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": "align",
-        "type": "'start'|'center'|'end'|'stretch'",
-        "default": null,
-        "description": "Block-axis alignment of each cell."
+        "name": "unbind",
+        "signature": "unbind()",
+        "returns": "this",
+        "description": "Releases a bound view and returns its field chooser to where it was found."
       },
       {
-        "name": "class",
-        "type": "string",
-        "default": "''",
-        "description": "Extra class names."
+        "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."
       }
-    ],
-    "events": [],
-    "methods": []
+    ]
   },
   "MasterPanel": {
     "options": [
@@ -5210,6 +6526,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": [
@@ -6289,6 +7623,12 @@
         "default": "false",
         "description": "Selection presentation."
       },
+      {
+        "name": "selectionTrigger",
+        "type": "'checkbox'|'card'",
+        "default": "'checkbox'",
+        "description": "Selection affordance for owning views."
+      },
       {
         "name": "selected",
         "type": "boolean",
@@ -6375,9 +7715,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",
@@ -6744,6 +8084,12 @@
         "default": "''",
         "description": "Empty control text."
       },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "''",
+        "description": "Accessible combobox name; falls back to the placeholder."
+      },
       {
         "name": "clearable",
         "type": "boolean",
@@ -7473,6 +8819,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": [
       {
@@ -7723,6 +9148,133 @@
     "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": "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 beside the label."
+      },
+      {
+        "name": "kind",
+        "type": "StatTileKind",
+        "default": "'neutral'",
+        "description": "Semantic intent. It tints the icon and 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."
+      }
+    ]
+  },
   "Stepper": {
     "options": [
       {
@@ -8032,6 +9584,18 @@
         "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",
@@ -8271,7 +9835,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",
@@ -8483,9 +10047,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",