@zeyos/zx 4.4.0 → 5.2.0

package/docs/api.json

@@ -80,6 +80,12 @@
         "returns": "this",
         "description": "Replaces account presentation without touching session state."
       },
+      {
+        "name": "setCompact",
+        "signature": "setCompact(compact)",
+        "returns": "this",
+        "description": "Shows the avatar alone or the avatar with the name and secondary line — for a navigation column that narrows to icons and widens again. The trigger keeps its full accessible name either way."
+      },
       {
         "name": "setItems",
         "signature": "setItems(items)",
@@ -247,6 +253,12 @@
         "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",
@@ -384,7 +396,13 @@
         "name": "color",
         "type": "string|null",
         "default": "null",
-        "description": "Identity colour; falls back to the accent colour."
+        "description": "Identity colour, any CSS colour; takes precedence over `tone`."
+      },
+      {
+        "name": "tone",
+        "type": "AppIconTone|null",
+        "default": "null",
+        "description": "Categorical identity colour from the theme's tone palette, drawn with its `--zx-color-tone-<tone>-solid` fill. Without `color` or `tone` the icon takes the accent."
       },
       {
         "name": "size",
@@ -455,9 +473,9 @@
     "options": [
       {
         "name": "items",
-        "type": "AppNavItem[]",
+        "type": "AppNavItem[]|AppSidebarModule[]",
         "default": "[]",
-        "description": "Application navigation tree."
+        "description": "Application navigation tree; in the modules layout its top level is the modules."
       },
       {
         "name": "active",
@@ -495,6 +513,42 @@
         "default": "'left'",
         "description": "Workspace edge occupied by navigation."
       },
+      {
+        "name": "layout",
+        "type": "'tree'|'modules'",
+        "default": "'tree'",
+        "description": "`'modules'` draws the top level as a module strip beside a panel showing one module's menu; minimized, the strip remains and menus open as flyouts."
+      },
+      {
+        "name": "module",
+        "type": "string|number|null",
+        "default": "null",
+        "description": "Modules layout: the module the panel shows first. Defaults to the module containing `active`, else the first module with a panel."
+      },
+      {
+        "name": "moduleBar",
+        "type": "AppSidebarModuleBarOptions",
+        "default": "{}",
+        "description": "Modules layout: strip presentation."
+      },
+      {
+        "name": "presentation",
+        "type": "'expanded'|'compact'|'collapsed'|null",
+        "default": "null",
+        "description": "Modules layout: how much of the navigation shows — both menus expanded (module names beside the side menu), the module menu collapsed to icons beside the side menu, or both collapsed to the icon strip. Defaults to `collapsed` ? `'collapsed'` : `'expanded'`."
+      },
+      {
+        "name": "presentations",
+        "type": "Array<'expanded'|'compact'|'collapsed'>",
+        "default": "['expanded','compact','collapsed']",
+        "description": "Modules layout: the presentations offered, widest first."
+      },
+      {
+        "name": "presentationSwitch",
+        "type": "boolean",
+        "default": "true",
+        "description": "Modules layout: whether the strip's foot carries the switch between presentations. Turn it off when the choice lives elsewhere — an account menu, through `presentationChoice()`."
+      },
       {
         "name": "label",
         "type": "string",
@@ -505,7 +559,7 @@
         "name": "header",
         "type": "Node|string|number|{toElement: () => Node|null}|null",
         "default": "null",
-        "description": "Expanded header content."
+        "description": "Expanded header content; in the modules layout, content above every module's menu."
       },
       {
         "name": "footer",
@@ -517,13 +571,13 @@
         "name": "railHeader",
         "type": "Node|string|number|{toElement: () => Node|null}|null",
         "default": "null",
-        "description": "Minimized leading content."
+        "description": "Minimized leading content; in the modules layout, the strip's leading content in both states."
       },
       {
         "name": "railFooter",
         "type": "Node|string|number|{toElement: () => Node|null}|null",
         "default": "null",
-        "description": "Minimized trailing content."
+        "description": "Minimized trailing content; in the modules layout, the strip's trailing content in both states."
       },
       {
         "name": "openDelay",
@@ -564,6 +618,16 @@
         "name": "flyoutchange",
         "payload": "{item: AppNavItem, id: string|number, open: boolean}",
         "description": "Minimized flyout-state listener."
+      },
+      {
+        "name": "modulechange",
+        "payload": "{item: AppNavItem, id: string|number, previous: string|number|null}",
+        "description": "Preventable module-switch listener."
+      },
+      {
+        "name": "presentationchange",
+        "payload": "{presentation: 'expanded'|'compact'|'collapsed', previous: 'expanded'|'compact'|'collapsed'}",
+        "description": "Presentation listener."
       }
     ],
     "methods": [
@@ -577,13 +641,55 @@
         "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",
         "signature": "setActive(id)",
         "returns": "this",
-        "description": "Sets the active id without routing."
+        "description": "Sets the active id without routing. In the modules layout the panel follows the active route into its module."
+      },
+      {
+        "name": "setBadge",
+        "signature": "setBadge(id, badge)",
+        "returns": "this",
+        "description": "Updates one badge — a module's, or any destination's — without rebuilding the navigation."
+      },
+      {
+        "name": "setModule",
+        "signature": "setModule(id, [options])",
+        "returns": "this",
+        "description": "Modules layout: shows a module's menu in the panel. Fires a preventable `modulechange` unless silent."
+      },
+      {
+        "name": "getModule",
+        "signature": "getModule()",
+        "returns": "string|number|null",
+        "description": "Modules layout: the module whose menu the panel shows."
+      },
+      {
+        "name": "setModuleLabels",
+        "signature": "setModuleLabels(labels)",
+        "returns": "this",
+        "description": "Modules layout: whether the strip prints module names — `'auto'` (beside the tiles while expanded, none while collapsed), `'beside'`, `'below'`, or `'hidden'`. A narrow drawer that has no room for a labelled strip beside the panel sets `'hidden'`."
+      },
+      {
+        "name": "getPresentation",
+        "signature": "getPresentation()",
+        "returns": "'expanded'|'compact'|'collapsed'",
+        "description": "How much of the navigation shows: `'expanded'` (in the modules layout, both menus), `'compact'` (the module menu collapsed to icons beside the side menu), or `'collapsed'`."
+      },
+      {
+        "name": "setPresentation",
+        "signature": "setPresentation(presentation, [options])",
+        "returns": "this",
+        "description": "Shows the navigation as `'expanded'`, `'compact'` (modules layout), or `'collapsed'`."
+      },
+      {
+        "name": "togglePresentation",
+        "signature": "togglePresentation()",
+        "returns": "this",
+        "description": "Moves to the next presentation the strip's switch offers, wrapping (Mod+B in an application)."
       },
       {
         "name": "setExpanded",
@@ -661,16 +767,52 @@
         "name": "focus",
         "signature": "focus()",
         "returns": "this",
-        "description": "Focuses the first navigation action."
+        "description": "Focuses the first navigation action: the module strip's Tab stop in the modules layout."
       },
       {
         "name": "destroy",
         "signature": "destroy()",
         "returns": "void",
         "description": "Destroys flyouts and restores/removes the host."
+      },
+      {
+        "name": "presentationChoice",
+        "signature": "presentationChoice([options])",
+        "returns": "import('../../internal/menu-items.js').MenuChoice",
+        "description": "The choice between presentations as a menu entry, for an account or settings menu that holds it instead of the strip: `account.setItems([sidebar.presentationChoice(), …])`. It reads the current presentation when called, so rebuild it after `presentationchange`."
       }
     ]
   },
+  "AppSidebarModuleBar": {
+    "options": [
+      {
+        "name": "appearance",
+        "type": "'tint'|'solid'|'plain'",
+        "default": "'tint'",
+        "description": "Tile treatment."
+      },
+      {
+        "name": "labels",
+        "type": "'auto'|'beside'|'below'|'hidden'",
+        "default": "'auto'",
+        "description": "Module names on the strip: `'auto'` prints them beside the tiles while expanded and leaves the icons alone while collapsed; `'hidden'` keeps the icon strip beside the panel; `'below'` prints them under the tiles."
+      },
+      {
+        "name": "allModules",
+        "type": "'auto'|'always'|'never'",
+        "default": "'auto'",
+        "description": "The \"All modules\" button."
+      },
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Strip accessible label; omitted resolves `moduleBar.label`."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
   "Aspect": {
     "options": [
       {
@@ -756,7 +898,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",
@@ -774,7 +916,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",
@@ -782,6 +924,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",
@@ -843,6 +991,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'",
@@ -1054,6 +1208,12 @@
         "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",
@@ -1274,7 +1434,7 @@
         "name": "msg",
         "type": "Record<string, string>",
         "default": null,
-        "description": "Localized component messages."
+        "description": "Per-instance messages, keyed `calendar.*` (`calendar.today`, `calendar.next`, …). The bare keys of earlier versions (`today`, `next`) are still read, after the namespaced key, until the next major version."
       },
       {
         "name": "renderEvent",
@@ -1751,9 +1911,9 @@
       },
       {
         "name": "label",
-        "type": "string",
-        "default": "'Card view'",
-        "description": "Accessible collection label."
+        "type": "string|null",
+        "default": "null",
+        "description": "Accessible collection label; null resolves message `cardView.label`, \"Card view\"."
       }
     ],
     "events": [
@@ -2079,6 +2239,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",
@@ -2282,6 +2448,12 @@
         "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": [],
@@ -2515,7 +2687,7 @@
         "name": "clearLabel",
         "type": "string|null",
         "default": "null",
-        "description": "Clear button label; null resolves `dataFilter.clear`."
+        "description": "Clear button label; null resolves message `dataFilter.clear`, \"Clear\"."
       }
     ],
     "events": [
@@ -2678,7 +2850,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",
@@ -2987,7 +3159,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",
@@ -3105,7 +3277,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": [
@@ -3178,7 +3350,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",
@@ -3443,7 +3615,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": [
@@ -3593,7 +3765,7 @@
         "name": "size",
         "type": "'sm'|'md'|'lg'",
         "default": "'md'",
-        "description": "Density-independent identity size."
+        "description": "Size of the icon and the identity text."
       },
       {
         "name": "wrap",
@@ -3695,7 +3867,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",
@@ -3719,7 +3891,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",
@@ -3763,6 +3941,12 @@
         "default": "false",
         "description": "Whether the control is disabled."
       },
+      {
+        "name": "readonly",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether the value is read-only: shown and focusable, not editable. Types whose control has no read-only state (`checkbox`, `select`, `optionlist`, `zxselect`, `date`, `time`, …) ignore it."
+      },
       {
         "name": "options",
         "type": "string[]|Record<string, string>|null",
@@ -3843,6 +4027,12 @@
         "returns": "this",
         "description": "Enables or disables the adapter control."
       },
+      {
+        "name": "setReadonly",
+        "signature": "setReadonly(readonly)",
+        "returns": "this",
+        "description": "Makes the value read-only or editable again, where the control has a read-only state (see the `readonly` option); reflected as `data-readonly` on the root either way."
+      },
       {
         "name": "setHighlight",
         "signature": "setHighlight(message, [kind])",
@@ -4005,6 +4195,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": [],
@@ -4013,7 +4209,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. An element or a component that is not a registered field type is wrapped in a `custom` field that reads and writes it through its own API — `getValue`/`setValue`, `get`/`set`, `getValues`/`setValues`, `isChecked`/`setChecked`, or a `value` property — disables it through `setDisabled(bool)` or `enable()`/`disable()`, and makes it read-only through `setReadonly(bool)`, falling back to the element's native properties only when the component has none of these. The component's own `change` becomes the field's `change`, once per edit."
       },
       {
         "name": "getField",
@@ -4113,7 +4309,13 @@
         "name": "mime",
         "type": "string",
         "default": "''",
-        "description": "MIME type."
+        "description": "MIME type. Shown as a readable type (\"PDF\", \"Image\"), never as the raw string, and used to pick the icon."
+      },
+      {
+        "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": "subtitle",
@@ -4125,7 +4327,7 @@
         "name": "icon",
         "type": "EntityRefIcon",
         "default": "'file'",
-        "description": "File icon name, node, component, or lazy renderer."
+        "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": "metadata",
@@ -4170,10 +4372,10 @@
         "description": "Whether active progress has no known amount."
       },
       {
-        "name": "density",
+        "name": "identitySize",
         "type": "'sm'|'md'|'lg'",
         "default": "'md'",
-        "description": "File-identity presentation size."
+        "description": "Size of the file's icon and name."
       },
       {
         "name": "wrap",
@@ -4394,13 +4596,13 @@
         "name": "searchable",
         "type": "boolean",
         "default": "false",
-        "description": "Searchable field, operator and single-choice controls."
+        "description": "Searchable field, operator and single-choice controls; a many-valued operator on a field with static choices gets a `TagPicker`."
       },
       {
         "name": "layout",
         "type": "'standard'|'compact'",
         "default": "'standard'",
-        "description": "Condition layout; compact rows adapt to container width."
+        "description": "Condition layout; compact rows adapt to container width and show the group's \"and\"/\"or\" between them, a click on it switching the group's logic."
       },
       {
         "name": "rootLogic",
@@ -4584,6 +4786,12 @@
         "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": "timeZone",
+        "type": "string|null",
+        "default": "null",
+        "description": "IANA zone the calendar days are counted in, such as the ZeyOS instance's `Europe/Vienna`. A day serializes as the first (or last) instant of that day in this zone, and an incoming instant shows as the day it falls on there — the same rule `zeyosForm()` and `zeyosTable()` apply to date-only fields. Null uses the runtime's own zone. An unknown zone throws a `RangeError`."
+      },
       {
         "name": "emptyText",
         "type": "string|null",
@@ -4822,6 +5030,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": [
@@ -4846,7 +5060,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",
@@ -5739,7 +5953,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."
       },
@@ -5753,7 +5967,7 @@
     "events": [
       {
         "name": "select",
-        "payload": "{item, value, source, query}",
+        "payload": "{item, value, source, query, page}",
         "description": "Preventable selection listener."
       },
       {
@@ -5761,6 +5975,11 @@
         "payload": "{query: string}",
         "description": "Query-change listener."
       },
+      {
+        "name": "page",
+        "payload": "{page, path}",
+        "description": "Page-navigation listener."
+      },
       {
         "name": "open",
         "payload": "Record<string, never>",
@@ -5773,16 +5992,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."
+        "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": "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",
@@ -5824,7 +6055,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",
@@ -5836,7 +6067,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",
@@ -5846,6 +6077,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": [
       {
@@ -6039,7 +6282,7 @@
         "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."
+        "description": "Optional sugar for a `TableView`, `CardView`, or `KanbanView`: it wires the shape switch to the view and mounts the view's field chooser into this bar — through the view's public `mountFieldControls()` when it has one, which every `RecordView` does. A `TableView` with the default `fieldControls: true` contributes its Table's column chooser. 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",
@@ -6175,7 +6418,7 @@
       },
       {
         "name": "open",
-        "signature": "open()",
+        "signature": "open([options])",
         "returns": "this",
         "description": "Opens the menu."
       },
@@ -6185,6 +6428,12 @@
         "returns": "this",
         "description": "Closes the menu."
       },
+      {
+        "name": "toggle",
+        "signature": "toggle()",
+        "returns": "this",
+        "description": "Opens the menu when it is closed, and closes it when it is open. Opening this way moves no focus; `focusFirst()` opens with focus on the first item."
+      },
       {
         "name": "isOpen",
         "signature": "isOpen()",
@@ -6205,13 +6454,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."
       },
@@ -6229,6 +6478,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": [
       {
@@ -6296,7 +6557,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",
@@ -6304,6 +6565,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",
@@ -6350,7 +6623,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": [
@@ -6409,92 +6682,312 @@
       }
     ]
   },
-  "MonthPicker": {
+  "ModuleBar": {
     "options": [
       {
-        "name": "value",
-        "type": "Date|null",
-        "default": "null",
-        "description": "Initially selected month."
+        "name": "items",
+        "type": "ModuleItem[]",
+        "default": "[]",
+        "description": "Modules, in bar order."
       },
       {
-        "name": "min",
-        "type": "Date|null",
+        "name": "active",
+        "type": "string|number|null",
         "default": "null",
-        "description": "Earliest selectable month."
+        "description": "Active destination id: a module, or any item in a module's menu."
       },
       {
-        "name": "max",
-        "type": "Date|null",
-        "default": "null",
-        "description": "Latest selectable month."
-      }
-    ],
-    "events": [
+        "name": "orientation",
+        "type": "'vertical'|'horizontal'",
+        "default": "'vertical'",
+        "description": "Bar flow."
+      },
       {
-        "name": "change",
-        "payload": "{date: Date|null}",
-        "description": "Change listener."
-      }
-    ],
-    "methods": [
+        "name": "side",
+        "type": "'left'|'right'|'top'|'bottom'",
+        "default": "'left'",
+        "description": "Workspace edge the bar occupies."
+      },
       {
-        "name": "set",
-        "signature": "set(date, [options])",
-        "returns": "this",
-        "description": "Selects the first day of a month."
+        "name": "appearance",
+        "type": "'tint'|'solid'|'plain'",
+        "default": "'tint'",
+        "description": "Tile treatment: the glyph in the module colour on a tint of it, the solid identity tile, or monochrome glyphs."
       },
       {
-        "name": "destroy",
-        "signature": "destroy()",
-        "returns": "void",
-        "description": "Removes generated content from an enhanced target."
-      }
-    ]
-  },
-  "MultiValueEditor": {
-    "options": [
+        "name": "labels",
+        "type": "'hidden'|'below'|'beside'",
+        "default": "'hidden'",
+        "description": "Whether a vertical bar prints each module's name: under its tile (a narrow strip), beside it (a full navigation column, with the count at the end of the row), or not at all — the name then stays the accessible name and the tooltip. Horizontal bars never print names."
+      },
       {
-        "name": "values",
-        "type": "unknown[]",
-        "default": "[]",
-        "description": "Initial ordered values."
+        "name": "menus",
+        "type": "'flyout'|'none'",
+        "default": "'flyout'",
+        "description": "How a module's children are presented: in a flyout, or by an adjacent panel the application owns, in which case activating the module emits `select`."
       },
       {
-        "name": "options",
-        "type": "unknown[]|Record<string, string>|null",
+        "name": "expanded",
+        "type": "string|number|null",
         "default": "null",
-        "description": "Allowed values; null uses text inputs."
+        "description": "With `menus: 'none'`, the module whose menu the adjacent panel shows."
       },
       {
-        "name": "addLabel",
-        "type": "string",
-        "default": "'Add value'",
-        "description": "Add-row button text."
+        "name": "controls",
+        "type": "string|null",
+        "default": "null",
+        "description": "With `menus: 'none'`, the id of that panel."
       },
       {
-        "name": "reorder",
-        "type": "'both'|'buttons'|'drag'|'none'",
-        "default": "'both'",
-        "description": "Reordering affordances each row gets: a drag handle, the up/down buttons, both, or neither."
-      }
-    ],
-    "events": [
-      {
-        "name": "change",
-        "payload": "{values: string[]}",
-        "description": "Values change listener."
-      }
-    ],
-    "methods": [
+        "name": "allModules",
+        "type": "'auto'|'always'|'never'",
+        "default": "'auto'",
+        "description": "The \"All modules\" button: shown when a module does not fit or is unpinned, always, or never (the bar then scrolls)."
+      },
       {
-        "name": "getValues",
-        "signature": "getValues()",
-        "returns": "string[]",
-        "description": "Returns a copy of the ordered values."
+        "name": "header",
+        "type": "Node|string|number|{toElement: () => Node|null}|null",
+        "default": "null",
+        "description": "Leading content, such as a product mark."
       },
       {
-        "name": "setValues",
+        "name": "footer",
+        "type": "Node|string|number|{toElement: () => Node|null}|null",
+        "default": "null",
+        "description": "Trailing content, such as an account menu."
+      },
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Navigation accessible label. Omitted resolves `moduleBar.label`, English `Modules`."
+      },
+      {
+        "name": "openDelay",
+        "type": "number",
+        "default": "80",
+        "description": "Flyout hover-open delay in milliseconds."
+      },
+      {
+        "name": "closeDelay",
+        "type": "number",
+        "default": "160",
+        "description": "Flyout pointer and focus crossing grace in milliseconds."
+      },
+      {
+        "name": "renderIcon",
+        "type": "(item: AppNavItem, context: Record<string, any>) => Node|null",
+        "default": null,
+        "description": "Optional host icon renderer."
+      }
+    ],
+    "events": [
+      {
+        "name": "select",
+        "payload": "AppNavSelectDetail",
+        "description": "Preventable activation listener."
+      },
+      {
+        "name": "flyoutchange",
+        "payload": "{item: AppNavItem, id: string|number, open: boolean}",
+        "description": "Flyout-state listener."
+      },
+      {
+        "name": "overflowchange",
+        "payload": "{visible: Array<string|number>, overflow: Array<string|number>}",
+        "description": "Overflow listener."
+      },
+      {
+        "name": "allmodules",
+        "payload": "{open: boolean}",
+        "description": "\"All modules\" catalogue open-state listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "setItems",
+        "signature": "setItems(items)",
+        "returns": "this",
+        "description": "Replaces the modules and rebuilds the bar."
+      },
+      {
+        "name": "getItems",
+        "signature": "getItems()",
+        "returns": "ModuleItem[]",
+        "description": "Returns a copy of the normalized modules."
+      },
+      {
+        "name": "setActive",
+        "signature": "setActive(id)",
+        "returns": "this",
+        "description": "Marks the active destination — a module, or anything in a module's menu — without routing. The module holding it becomes current and stays on the bar."
+      },
+      {
+        "name": "openFlyout",
+        "signature": "openFlyout(id, [options])",
+        "returns": "this",
+        "description": "Opens a module's menu flyout."
+      },
+      {
+        "name": "closeFlyout",
+        "signature": "closeFlyout(id)",
+        "returns": "this",
+        "description": "Closes a module's menu flyout."
+      },
+      {
+        "name": "closeAllFlyouts",
+        "signature": "closeAllFlyouts()",
+        "returns": "this",
+        "description": "Closes every menu flyout."
+      },
+      {
+        "name": "isFlyoutOpen",
+        "signature": "isFlyoutOpen(id)",
+        "returns": "boolean",
+        "description": "Reports whether a module's menu flyout is open."
+      },
+      {
+        "name": "setExpanded",
+        "signature": "setExpanded(id)",
+        "returns": "this",
+        "description": "With `menus: 'none'`, names the module whose menu the adjacent panel now shows."
+      },
+      {
+        "name": "setBadge",
+        "signature": "setBadge(id, badge)",
+        "returns": "this",
+        "description": "Updates one badge in place — on the tile, in a flyout, and in the catalogue — without rebuilding the bar. `null` removes it."
+      },
+      {
+        "name": "setLayout",
+        "signature": "setLayout(layout)",
+        "returns": "this",
+        "description": "Changes flow or edge, keeping items, the active destination, and the expanded module."
+      },
+      {
+        "name": "setLabels",
+        "signature": "setLabels(labels)",
+        "returns": "this",
+        "description": "Changes whether module names are printed — the expanded and collapsed states of a vertical navigation column — keeping items, the active destination, and the expanded module."
+      },
+      {
+        "name": "openAllModules",
+        "signature": "openAllModules()",
+        "returns": "this",
+        "description": "Opens the \"All modules\" catalogue and focuses its filter or first entry."
+      },
+      {
+        "name": "closeAllModules",
+        "signature": "closeAllModules()",
+        "returns": "this",
+        "description": "Closes the \"All modules\" catalogue."
+      },
+      {
+        "name": "isAllModulesOpen",
+        "signature": "isAllModulesOpen()",
+        "returns": "boolean",
+        "description": "Reports whether the \"All modules\" catalogue is open."
+      },
+      {
+        "name": "focus",
+        "signature": "focus()",
+        "returns": "this",
+        "description": "Focuses the bar's Tab stop: the current module, else the first tile."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Destroys flyouts, tooltips, and the catalogue, and restores or removes the root."
+      }
+    ]
+  },
+  "MonthPicker": {
+    "options": [
+      {
+        "name": "value",
+        "type": "Date|null",
+        "default": "null",
+        "description": "Initially selected month."
+      },
+      {
+        "name": "min",
+        "type": "Date|null",
+        "default": "null",
+        "description": "Earliest selectable month."
+      },
+      {
+        "name": "max",
+        "type": "Date|null",
+        "default": "null",
+        "description": "Latest selectable month."
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "payload": "{date: Date|null}",
+        "description": "Change listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "set",
+        "signature": "set(date, [options])",
+        "returns": "this",
+        "description": "Selects the first day of a month."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Removes generated content from an enhanced target."
+      }
+    ]
+  },
+  "MultiValueEditor": {
+    "options": [
+      {
+        "name": "values",
+        "type": "unknown[]",
+        "default": "[]",
+        "description": "Initial ordered values."
+      },
+      {
+        "name": "options",
+        "type": "unknown[]|Record<string, string>|null",
+        "default": "null",
+        "description": "Allowed values; null uses text inputs."
+      },
+      {
+        "name": "addLabel",
+        "type": "string",
+        "default": "'Add value'",
+        "description": "Add-row button text."
+      },
+      {
+        "name": "reorder",
+        "type": "'both'|'buttons'|'drag'|'none'",
+        "default": "'both'",
+        "description": "Reordering affordances each row gets: a drag handle, the up/down buttons, both, or neither."
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "payload": "{values: string[]}",
+        "description": "Values change listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "getValues",
+        "signature": "getValues()",
+        "returns": "string[]",
+        "description": "Returns a copy of the ordered values."
+      },
+      {
+        "name": "setValues",
         "signature": "setValues(values, [options])",
         "returns": "this",
         "description": "Replaces all rows."
@@ -7049,6 +7542,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": [
       {
@@ -7206,6 +7711,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": [],
@@ -7652,6 +8169,12 @@
         "type": "Node[]",
         "default": "[]",
         "description": "Listener-free, owner-created controls such as a move handle."
+      },
+      {
+        "name": "message",
+        "type": "(key: string, ...args: unknown[]) => string",
+        "default": null,
+        "description": "Resolves the card's built-in strings (`recordCard.select`, `recordCard.actions`, `recordCard.untitled`, `recordCard.selected`, `recordCard.notSelected`). An owning component passes its own `msg()`; omitted, the host translator and then the default English catalogue answer."
       }
     ],
     "events": [],
@@ -7841,6 +8364,18 @@
         "returns": "string[]",
         "description": "Returns the complete field id order."
       },
+      {
+        "name": "getFieldControls",
+        "signature": "getFieldControls()",
+        "returns": "HTMLElement|null",
+        "description": "Returns the element that lets a reader show, hide, and reorder this view's fields: the shared field chooser, or — for a `TableView` with `fieldControls: true` — the column chooser of its composed `Table`. Null when the view renders none (`fieldControls: false`). The element stays owned by the view: move it with {@link RecordView#mountFieldControls} rather than appending it elsewhere yourself, so `destroy()` can still find and remove it."
+      },
+      {
+        "name": "mountFieldControls",
+        "signature": "mountFieldControls(target)",
+        "returns": "HTMLElement|null",
+        "description": "Moves the view's field chooser into a host element — a list toolbar, a pane header — or, with `null`, back to where the view first rendered it. It keeps driving this view wherever it sits, and `destroy()` removes it from the host. `ListToolbar.bind()` calls this for every record view, which is how its field chooser ends up in the bar."
+      },
       {
         "name": "setFieldVisible",
         "signature": "setFieldVisible(id, [visible], [options])",
@@ -8172,6 +8707,12 @@
       }
     ],
     "methods": [
+      {
+        "name": "get",
+        "signature": "get()",
+        "returns": "unknown",
+        "description": "Returns the selected item ID, or null: the same as reading `value`, under the `get()`/`set()` pair the other value components share."
+      },
       {
         "name": "set",
         "signature": "set(idOrItem, [options])",
@@ -8236,7 +8777,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",
@@ -9174,6 +9715,12 @@
         "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",
@@ -9214,13 +9761,13 @@
         "name": "icon",
         "type": "string|null",
         "default": "null",
-        "description": "Icon name from `icons.js`, shown beside the label."
+        "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 icon and the sparkline and never the value, which stays at full text contrast whatever intent a record carries."
+        "description": "Semantic intent. It tints the sparkline and never the value, which stays at full text contrast whatever intent a record carries."
       },
       {
         "name": "href",
@@ -9275,6 +9822,30 @@
       }
     ]
   },
+  "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": [
       {
@@ -9439,9 +10010,15 @@
         "type": "boolean",
         "default": "true",
         "description": "Keep inactive panel elements mounted."
-      }
-    ],
-    "events": [
+      },
+      {
+        "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": [
       {
         "name": "change",
         "payload": "{name: string, previous: string|null}",
@@ -9602,6 +10179,12 @@
         "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",
@@ -9643,6 +10226,24 @@
         "type": "false|TableHierarchyOptions",
         "default": "false",
         "description": "Flat parent references projected as an expandable treegrid. Row data and mutation APIs remain flat."
+      },
+      {
+        "name": "interactive",
+        "type": "boolean",
+        "default": "false",
+        "description": "Makes the table an APG grid — row focus, Enter firing `rowclick` — even without selection, editing, or hierarchy, which already imply it. Attaching a `rowclick` or `rowdblclick` listener through `on()` or an `on…` option sets it too; pass it when the host listens for the bubbling `zx-rowclick` DOM event instead."
+      },
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Accessible name of the table. A grid must have one; null resolves the `table.label` message (English \"Table\") for a grid and leaves a plain table unnamed, so name it after what it lists."
+      },
+      {
+        "name": "labelledBy",
+        "type": "string|null",
+        "default": "null",
+        "description": "Id of an element that names the grid — the heading above it, say. Wins over `label`."
       }
     ],
     "events": [
@@ -9951,6 +10552,12 @@
         "returns": "number",
         "description": "How many rows are currently rendered."
       },
+      {
+        "name": "addEventListener",
+        "signature": "addEventListener(type, listener, [options])",
+        "returns": "void",
+        "description": "Registers a listener, and turns the table into a grid when the listener is for a row click: a host that reacts to the row needs the row reachable by keyboard."
+      },
       {
         "name": "isStacked",
         "signature": "isStacked()",
@@ -10157,7 +10764,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",
@@ -10223,7 +10836,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",
@@ -11235,5 +11848,354 @@
         "description": "Disables editing, removal, and reordering."
       }
     ]
+  },
+  "ViewSettings": {
+    "options": [
+      {
+        "name": "fields",
+        "type": "ViewSettingsField[]",
+        "default": "[]",
+        "description": "Field descriptors, in their default order. Bound to a view, a non-empty list is also the allow-list: the view's other fields are neither listed nor touched. An empty list takes every field the view has."
+      },
+      {
+        "name": "fieldOrder",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Preferred field order; missing fields append."
+      },
+      {
+        "name": "hiddenFields",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Hidden field ids. A field with `visible: false` starts hidden too; a locked field never does."
+      },
+      {
+        "name": "groupBy",
+        "type": "string|null",
+        "default": "null",
+        "description": "Initial grouping field."
+      },
+      {
+        "name": "grouping",
+        "type": "boolean|ViewSettingsGrouping",
+        "default": "true",
+        "description": "The Group section. `false` omits it; an object restricts the fields it offers."
+      },
+      {
+        "name": "board",
+        "type": "ViewSettingsBoardOptions|false",
+        "default": "false",
+        "description": "The Board section (column field, swim-lane field, show empty columns) with its initial values and, in `fields`, the fields it offers; `false` omits it."
+      },
+      {
+        "name": "sections",
+        "type": "ViewSettingsSection[]",
+        "default": null,
+        "description": "Order and presence of the sections. Defaults to `['fields', 'grouping', 'board']`; a section whose option is `false` is always left out."
+      },
+      {
+        "name": "types",
+        "type": "Record<string, {icon?: string, label?: string}>",
+        "default": "{}",
+        "description": "Extends or overrides the built-in type map, keyed by type name."
+      },
+      {
+        "name": "searchThreshold",
+        "type": "number",
+        "default": "8",
+        "description": "Field count above which the field search is shown."
+      },
+      {
+        "name": "headingLevel",
+        "type": "2|3|4|5|6",
+        "default": "3",
+        "description": "Heading level of the section headings."
+      },
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Accessible name of the region; omitted uses the `viewSettings.label` message (\"View settings\")."
+      },
+      {
+        "name": "msg",
+        "type": "Record<string, string>|Record<string, Record<string, string>>",
+        "default": null,
+        "description": "Localized messages."
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "payload": "{state: ViewSettingsState, reason: ViewSettingsChangeReason}",
+        "description": "Any change the reader made."
+      },
+      {
+        "name": "fieldorderchange",
+        "payload": "{order: string[]}",
+        "description": "Field order changed."
+      },
+      {
+        "name": "fieldvisibilitychange",
+        "payload": "{visible: string[], hidden: string[]}",
+        "description": "A field was added or hidden."
+      },
+      {
+        "name": "groupchange",
+        "payload": "{field: string|null}",
+        "description": "Grouping field changed."
+      },
+      {
+        "name": "boardchange",
+        "payload": "{board: ViewSettingsBoard}",
+        "description": "Board settings changed."
+      }
+    ],
+    "methods": [
+      {
+        "name": "getState",
+        "signature": "getState()",
+        "returns": "ViewSettingsState",
+        "description": "Returns the current settings as a JSON-safe snapshot."
+      },
+      {
+        "name": "setState",
+        "signature": "setState(partial, [options])",
+        "returns": "this",
+        "description": "Applies part of a state. Unknown field ids are ignored, missing ones append, and a locked field stays shown. Each part that actually changes emits its own event unless `silent`. A keyboard pick-up or pointer drag in progress is canceled first."
+      },
+      {
+        "name": "setFields",
+        "signature": "setFields(fields)",
+        "returns": "this",
+        "description": "Replaces the field descriptors, keeping order, visibility, grouping, and board settings for every id that still exists. While a view is bound, the view owns the field list: change it with the view's own `setFields()` and the panel follows through `statechange`. A `setFields()` here is not pushed to the view and lasts only until the view's next change."
+      },
+      {
+        "name": "getFields",
+        "signature": "getFields()",
+        "returns": "ViewSettingsField[]",
+        "description": "Returns the field descriptors in their current order."
+      },
+      {
+        "name": "showField",
+        "signature": "showField(id)",
+        "returns": "this",
+        "description": "Shows a hidden field at the end of the shown list."
+      },
+      {
+        "name": "hideField",
+        "signature": "hideField(id)",
+        "returns": "this",
+        "description": "Hides a shown field. A locked field and the last shown field cannot be hidden."
+      },
+      {
+        "name": "moveField",
+        "signature": "moveField(id, index)",
+        "returns": "this",
+        "description": "Moves a shown field to a position among the movable shown fields (locked ones keep theirs)."
+      },
+      {
+        "name": "bind",
+        "signature": "bind(view, [options])",
+        "returns": "this",
+        "description": "Connects a record view (`TableView`, `CardView`, `KanbanView`, or anything exposing the `RecordView` state surface). The view's fields and state are read now; order and visibility changes made here are pushed through `setFieldOrder()` and `setFieldVisible()`; and the view's own `statechange` is followed, so a column hidden from a table header disappears here too. The view's labels and types win over the panel's own descriptors, which supply only what the view lacks (`locked`, `groupable`, a type the view leaves at its `'text'` default). While bound, the view owns the field list; see `setFields()`. Grouping and board settings are never applied to the view — they are emitted, and the host decides (a `CardView` is re-created or given a new `groupBy`, a `KanbanView` its axes). A view's own `groupBy`, `columnBy`, and `swimlaneBy` options are adopted when they name fields."
+      },
+      {
+        "name": "unbind",
+        "signature": "unbind()",
+        "returns": "this",
+        "description": "Releases a bound view. The settings keep their current state."
+      },
+      {
+        "name": "focus",
+        "signature": "focus()",
+        "returns": "this",
+        "description": "Focuses the field search, or the first control of the shown list when there is no search."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Destroys the nested controls, releases a bound view, and restores an enhanced target."
+      }
+    ]
+  },
+  "ViewSettingsBoard": {
+    "options": [
+      {
+        "name": "columnBy",
+        "type": "string|null",
+        "default": "null",
+        "description": "Initial column field."
+      },
+      {
+        "name": "swimlaneBy",
+        "type": "string|null",
+        "default": "null",
+        "description": "Initial swim-lane field, or null for none."
+      },
+      {
+        "name": "showEmptyColumns",
+        "type": "boolean",
+        "default": "true",
+        "description": "Whether columns without cards stay visible."
+      },
+      {
+        "name": "fields",
+        "type": "string[]",
+        "default": null,
+        "description": "The field ids offered for columns and swim lanes, in this order. Omitted offers the same fields as the Group section."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
+  "WorkspaceSwitcher": {
+    "options": [
+      {
+        "name": "workspaces",
+        "type": "WorkspaceItem[]",
+        "default": "[]",
+        "description": "Workspaces in menu order. Entries without an id are skipped, and a repeated id keeps its first entry."
+      },
+      {
+        "name": "active",
+        "type": "string|number|null",
+        "default": "null",
+        "description": "Active workspace id. Defaults to the first enabled workspace, which also stands in for an id that is not listed or is disabled."
+      },
+      {
+        "name": "items",
+        "type": "MenuButtonItem[]",
+        "default": "[]",
+        "description": "Extra actions listed after the workspaces — \"Create workspace\", \"Workspace settings\", `'-'` separators, \"Sign out\". A separator is inserted between the workspaces and the actions automatically."
+      },
+      {
+        "name": "compact",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether the trigger shows the tile alone."
+      },
+      {
+        "name": "heading",
+        "type": "string|null",
+        "default": "null",
+        "description": "Group label above the workspaces; null resolves message `workspaceSwitcher.heading` (\"Workspaces\"), and an empty string leaves the label out."
+      },
+      {
+        "name": "label",
+        "type": "string|null",
+        "default": "null",
+        "description": "Trigger accessible name, in which `%1` is the active workspace's name and is filled in again after every switch. Null resolves message `workspaceSwitcher.label` (\"Switch workspace: %1\"), or `workspaceSwitcher.labelEmpty` (\"Switch workspace\") while no workspace is active."
+      },
+      {
+        "name": "placement",
+        "type": "'bottom-start'|'bottom-end'|'top-start'|'top-end'|'bottom'|'top'|'right-start'|'right-end'|'left-start'|'left-end'|'right'|'left'",
+        "default": "'bottom-start'",
+        "description": "Popup placement."
+      },
+      {
+        "name": "msg",
+        "type": "Record<string, unknown>",
+        "default": null,
+        "description": "Component-local message overrides, by key: `workspaceSwitcher.heading` (\"Workspaces\"), `workspaceSwitcher.label` (\"Switch workspace: %1\", `%1` the active workspace's name), and `workspaceSwitcher.labelEmpty` (\"Switch workspace\", the trigger's name while no workspace is active)."
+      }
+    ],
+    "events": [
+      {
+        "name": "select",
+        "payload": "{workspace, id, previous}",
+        "description": "Preventable workspace switch; `preventDefault()` keeps the previous workspace active and the menu open."
+      },
+      {
+        "name": "action",
+        "payload": "{value: unknown, item: object}",
+        "description": "Preventable extra action; `preventDefault()` skips the item's own callback and keeps the menu open."
+      },
+      {
+        "name": "open",
+        "payload": "Record<string, never>",
+        "description": "Open listener."
+      },
+      {
+        "name": "close",
+        "payload": "Record<string, never>",
+        "description": "Close listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "getActive",
+        "signature": "getActive()",
+        "returns": "WorkspaceItem|null",
+        "description": "Returns the active workspace, or null when no workspace is enabled."
+      },
+      {
+        "name": "setActive",
+        "signature": "setActive(id, [options])",
+        "returns": "this",
+        "description": "Makes another workspace active. An unknown or disabled id changes nothing."
+      },
+      {
+        "name": "setWorkspaces",
+        "signature": "setWorkspaces(workspaces)",
+        "returns": "this",
+        "description": "Replaces the workspaces. The active workspace stays active while it is still listed and enabled; otherwise the first enabled workspace becomes active, silently."
+      },
+      {
+        "name": "setItems",
+        "signature": "setItems(items)",
+        "returns": "this",
+        "description": "Replaces the extra actions after the workspaces."
+      },
+      {
+        "name": "setCompact",
+        "signature": "setCompact(compact)",
+        "returns": "this",
+        "description": "Shows the tile alone, or the tile with the name, secondary line, and chevron — for a navigation column that narrows to icons and widens again. The trigger keeps its full accessible name and gains the workspace name as a tooltip while compact."
+      },
+      {
+        "name": "open",
+        "signature": "open()",
+        "returns": "this",
+        "description": "Opens the menu."
+      },
+      {
+        "name": "close",
+        "signature": "close()",
+        "returns": "this",
+        "description": "Closes the menu."
+      },
+      {
+        "name": "toggle",
+        "signature": "toggle()",
+        "returns": "this",
+        "description": "Toggles the menu."
+      },
+      {
+        "name": "isOpen",
+        "signature": "isOpen()",
+        "returns": "boolean",
+        "description": "Reports whether the menu is open."
+      },
+      {
+        "name": "focus",
+        "signature": "focus()",
+        "returns": "this",
+        "description": "Focuses the trigger."
+      },
+      {
+        "name": "getPanel",
+        "signature": "getPanel()",
+        "returns": "HTMLElement",
+        "description": "Returns the menu panel for shell hover and focus coordination."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Destroys the menu and restores or removes the host."
+      }
+    ]
   }
 }