@zeyos/zx 4.1.1 → 4.3.0

package/docs/api.json

@@ -174,6 +174,12 @@
         "default": "false",
         "description": "Whether the icon represents the active application."
       },
+      {
+        "name": "shape",
+        "type": "'tile'|'circle'",
+        "default": "'tile'",
+        "description": "Identity vessel geometry."
+      },
       {
         "name": "glass",
         "type": "false|'subtle'|'strong'",
@@ -447,6 +453,55 @@
     "events": [],
     "methods": []
   },
+  "Aurora": {
+    "options": [
+      {
+        "name": "preset",
+        "type": "'source'|'confluence'|'horizon'|'diagonal'|'edge'|'curtain'",
+        "default": "'source'",
+        "description": "Geometry of the ambient light field."
+      },
+      {
+        "name": "colors",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Zero to four concrete CSS colours. An empty list uses semantic Zx colours; shorter palettes repeat across the four gradient fields."
+      },
+      {
+        "name": "intensity",
+        "type": "'subtle'|'balanced'|'vivid'",
+        "default": "'subtle'",
+        "description": "Strength of the light field."
+      }
+    ],
+    "events": [],
+    "methods": [
+      {
+        "name": "setPreset",
+        "signature": "setPreset(preset)",
+        "returns": "this",
+        "description": "Sets the light-field geometry without replacing surface content."
+      },
+      {
+        "name": "setColors",
+        "signature": "setColors(colors)",
+        "returns": "this",
+        "description": "Sets zero to four concrete colours without replacing surface content."
+      },
+      {
+        "name": "setIntensity",
+        "signature": "setIntensity(intensity)",
+        "returns": "this",
+        "description": "Sets the light-field strength without replacing surface content."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned surface."
+      }
+    ]
+  },
   "Avatar": {
     "options": [
       {
@@ -773,6 +828,424 @@
     ],
     "methods": []
   },
+  "Calendar": {
+    "options": [
+      {
+        "name": "events",
+        "type": "Record<string, any>[]",
+        "default": "[]",
+        "description": "Event records."
+      },
+      {
+        "name": "date",
+        "type": "Date|string|number|null",
+        "default": "null",
+        "description": "Initial local anchor date; null uses today."
+      },
+      {
+        "name": "view",
+        "type": "CalendarView",
+        "default": "'month'",
+        "description": "Initial view."
+      },
+      {
+        "name": "views",
+        "type": "CalendarView[]",
+        "default": "['agenda','day','week','month','year']",
+        "description": "Allowed views."
+      },
+      {
+        "name": "locale",
+        "type": "string|string[]",
+        "default": null,
+        "description": "Intl locale override."
+      },
+      {
+        "name": "weekStart",
+        "type": "number",
+        "default": "1",
+        "description": "First weekday, 0 (Sunday) through 6 (Saturday)."
+      },
+      {
+        "name": "weekNumbers",
+        "type": "boolean",
+        "default": "true",
+        "description": "Show ISO week numbers in month view."
+      },
+      {
+        "name": "workweek",
+        "type": "boolean",
+        "default": "false",
+        "description": "Show Monday–Friday in the week time grid."
+      },
+      {
+        "name": "agendaDays",
+        "type": "number",
+        "default": "14",
+        "description": "Number of days in agenda view."
+      },
+      {
+        "name": "slotDuration",
+        "type": "number",
+        "default": "30",
+        "description": "Time-grid snap interval in minutes."
+      },
+      {
+        "name": "slotMinTime",
+        "type": "number",
+        "default": "0",
+        "description": "First visible minute of the day."
+      },
+      {
+        "name": "slotMaxTime",
+        "type": "number",
+        "default": "1440",
+        "description": "Exclusive last visible minute of the day."
+      },
+      {
+        "name": "scrollTime",
+        "type": "number",
+        "default": "480",
+        "description": "Minute initially scrolled into view."
+      },
+      {
+        "name": "eventLimit",
+        "type": "number",
+        "default": "3",
+        "description": "Maximum visible month lanes before a More button."
+      },
+      {
+        "name": "selectable",
+        "type": "boolean",
+        "default": "false",
+        "description": "Enable pointer time-range selection."
+      },
+      {
+        "name": "editable",
+        "type": "boolean",
+        "default": "false",
+        "description": "Enable event moving and resizing."
+      },
+      {
+        "name": "eventStartEditable",
+        "type": "boolean|null",
+        "default": "null",
+        "description": "Global move override; null inherits editable."
+      },
+      {
+        "name": "eventDurationEditable",
+        "type": "boolean|null",
+        "default": "null",
+        "description": "Global resize override; null inherits editable."
+      },
+      {
+        "name": "optimistic",
+        "type": "boolean",
+        "default": "true",
+        "description": "Apply event proposals locally before persistence confirms."
+      },
+      {
+        "name": "nowIndicator",
+        "type": "boolean",
+        "default": "true",
+        "description": "Show the current-time line in day/week views."
+      },
+      {
+        "name": "now",
+        "type": "Date|(() => Date)|null",
+        "default": "null",
+        "description": "Current-time override for deterministic rendering."
+      },
+      {
+        "name": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "description": "Disable toolbar, date, selection, and editing controls."
+      },
+      {
+        "name": "eventId",
+        "type": "CalendarReader",
+        "default": "'id'",
+        "description": "Event ID reader."
+      },
+      {
+        "name": "eventTitle",
+        "type": "CalendarReader",
+        "default": "'title'",
+        "description": "Event title reader."
+      },
+      {
+        "name": "eventStart",
+        "type": "CalendarReader",
+        "default": "'start'",
+        "description": "Event start reader."
+      },
+      {
+        "name": "eventEnd",
+        "type": "CalendarReader",
+        "default": "'end'",
+        "description": "Event end reader."
+      },
+      {
+        "name": "eventAllDay",
+        "type": "CalendarReader",
+        "default": "'allDay'",
+        "description": "Event all-day reader."
+      },
+      {
+        "name": "eventColor",
+        "type": "CalendarReader",
+        "default": "'color'",
+        "description": "Event colour reader."
+      },
+      {
+        "name": "eventLocation",
+        "type": "CalendarReader",
+        "default": "'location'",
+        "description": "Event location reader."
+      },
+      {
+        "name": "eventEditable",
+        "type": "CalendarReader",
+        "default": "'editable'",
+        "description": "Per-event move reader."
+      },
+      {
+        "name": "eventDurationEditable",
+        "type": "CalendarReader",
+        "default": "'durationEditable'",
+        "description": "Per-event resize reader."
+      },
+      {
+        "name": "dateUnit",
+        "type": "'milliseconds'|'seconds'",
+        "default": "'milliseconds'",
+        "description": "Unit for numeric event dates."
+      },
+      {
+        "name": "msg",
+        "type": "Record<string, string>",
+        "default": null,
+        "description": "Localized component messages."
+      },
+      {
+        "name": "renderEvent",
+        "type": "(event: CalendarEvent) => Node|string|null",
+        "default": null,
+        "description": "Optional safe event-content renderer."
+      }
+    ],
+    "events": [
+      {
+        "name": "eventschange",
+        "payload": "{events: CalendarEvent[]}",
+        "description": "Programmatic event-data listener."
+      },
+      {
+        "name": "viewchange",
+        "payload": "{view: CalendarView, oldView: CalendarView}",
+        "description": "View listener."
+      },
+      {
+        "name": "dateschange",
+        "payload": "{view: CalendarView, start: Date, end: Date}",
+        "description": "Visible-range listener."
+      },
+      {
+        "name": "eventclick",
+        "payload": "{event: CalendarEvent, jsEvent: Event}",
+        "description": "Event activation listener."
+      },
+      {
+        "name": "eventdblclick",
+        "payload": "{event: CalendarEvent, jsEvent: Event}",
+        "description": "Event double-activation listener."
+      },
+      {
+        "name": "dateclick",
+        "payload": "{date: Date, allDay: boolean, view: CalendarView, jsEvent: Event}",
+        "description": "Date/time activation listener."
+      },
+      {
+        "name": "select",
+        "payload": "{start: Date, end: Date, allDay: boolean, view: CalendarView, jsEvent: Event}",
+        "description": "Range-selection listener."
+      },
+      {
+        "name": "eventchange",
+        "payload": "{event, oldEvent, action, delta, jsEvent, revert}",
+        "description": "Move/resize proposal listener."
+      },
+      {
+        "name": "new",
+        "payload": "{date: Date, view: CalendarView, jsEvent: Event}",
+        "description": "New-event command listener."
+      },
+      {
+        "name": "moreclick",
+        "payload": "{date: Date, count: number, jsEvent: Event}",
+        "description": "Month-overflow listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "getEvents",
+        "signature": "getEvents()",
+        "returns": "CalendarEvent[]",
+        "description": "Returns defensive copies of every normalized event."
+      },
+      {
+        "name": "setEvents",
+        "signature": "setEvents(events, [options])",
+        "returns": "this",
+        "description": "Replaces all source records atomically."
+      },
+      {
+        "name": "addEvent",
+        "signature": "addEvent(event, [options])",
+        "returns": "this",
+        "description": "Adds one source event."
+      },
+      {
+        "name": "updateEvent",
+        "signature": "updateEvent(id, changes, [options])",
+        "returns": "this",
+        "description": "Updates one normalized event. Date changes accept valid Date objects, ISO strings, or numeric values in the configured date unit."
+      },
+      {
+        "name": "removeEvent",
+        "signature": "removeEvent(id, [options])",
+        "returns": "this",
+        "description": "Removes one event when present."
+      },
+      {
+        "name": "getDate",
+        "signature": "getDate()",
+        "returns": "Date",
+        "description": "Returns a copy of the current anchor date."
+      },
+      {
+        "name": "setDate",
+        "signature": "setDate(date, [options])",
+        "returns": "this",
+        "description": "Sets the anchor date and visible period."
+      },
+      {
+        "name": "getView",
+        "signature": "getView()",
+        "returns": "CalendarView",
+        "description": "Returns the current view."
+      },
+      {
+        "name": "setView",
+        "signature": "setView(view, [options])",
+        "returns": "this",
+        "description": "Changes view while retaining the anchor date."
+      },
+      {
+        "name": "prev",
+        "signature": "prev()",
+        "returns": "this",
+        "description": "Moves to the previous visible period."
+      },
+      {
+        "name": "next",
+        "signature": "next()",
+        "returns": "this",
+        "description": "Moves to the next visible period."
+      },
+      {
+        "name": "today",
+        "signature": "today()",
+        "returns": "this",
+        "description": "Moves to today."
+      },
+      {
+        "name": "setLoading",
+        "signature": "setLoading([loading])",
+        "returns": "this",
+        "description": "Toggles loading state without discarding the rendered calendar."
+      },
+      {
+        "name": "focusEvent",
+        "signature": "focusEvent(id)",
+        "returns": "this",
+        "description": "Focuses an event in the current view when rendered."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target or removes the owned root and releases timers."
+      }
+    ]
+  },
+  "CalendarNormalize": {
+    "options": [
+      {
+        "name": "eventId",
+        "type": "CalendarReader",
+        "default": "'id'",
+        "description": "ID reader."
+      },
+      {
+        "name": "eventTitle",
+        "type": "CalendarReader",
+        "default": "'title'",
+        "description": "Title reader."
+      },
+      {
+        "name": "eventStart",
+        "type": "CalendarReader",
+        "default": "'start'",
+        "description": "Start reader."
+      },
+      {
+        "name": "eventEnd",
+        "type": "CalendarReader",
+        "default": "'end'",
+        "description": "End reader."
+      },
+      {
+        "name": "eventAllDay",
+        "type": "CalendarReader",
+        "default": "'allDay'",
+        "description": "All-day reader."
+      },
+      {
+        "name": "eventColor",
+        "type": "CalendarReader",
+        "default": "'color'",
+        "description": "Colour reader."
+      },
+      {
+        "name": "eventLocation",
+        "type": "CalendarReader",
+        "default": "'location'",
+        "description": "Location reader."
+      },
+      {
+        "name": "eventEditable",
+        "type": "CalendarReader",
+        "default": "'editable'",
+        "description": "Move-policy reader."
+      },
+      {
+        "name": "eventDurationEditable",
+        "type": "CalendarReader",
+        "default": "'durationEditable'",
+        "description": "Resize-policy reader."
+      },
+      {
+        "name": "dateUnit",
+        "type": "'milliseconds'|'seconds'",
+        "default": "'milliseconds'",
+        "description": "Unit used for numeric dates."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
   "Card": {
     "options": [
       {
@@ -876,17 +1349,198 @@
       }
     ]
   },
-  "Chart": {
+  "CardView": {
     "options": [
       {
-        "name": "adapter",
-        "type": "ChartAdapter|null",
-        "default": "null",
-        "description": "Injected engine adapter."
+        "name": "fields",
+        "type": "ViewField[]",
+        "default": "[]",
+        "description": "Shared ordered field descriptors."
       },
       {
-        "name": "type",
-        "type": "string",
+        "name": "data",
+        "type": "ViewRecord[]",
+        "default": "[]",
+        "description": "Initial records."
+      },
+      {
+        "name": "recordId",
+        "type": "string|((record:ViewRecord)=>unknown)",
+        "default": "'ID'",
+        "description": "Stable record id accessor."
+      },
+      {
+        "name": "sort",
+        "type": "import('../view/record-view.js').ViewSort|null",
+        "default": "null",
+        "description": "Initial shared sort."
+      },
+      {
+        "name": "sortMode",
+        "type": "'local'|'server'",
+        "default": "'local'",
+        "description": "Local sorting or event-only server sorting."
+      },
+      {
+        "name": "selectable",
+        "type": "false|'single'|'multi'",
+        "default": "false",
+        "description": "Record selection behavior."
+      },
+      {
+        "name": "selection",
+        "type": "unknown[]",
+        "default": "[]",
+        "description": "Initially selected record ids."
+      },
+      {
+        "name": "fieldOrder",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Preferred shared field order."
+      },
+      {
+        "name": "hiddenFields",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Initially hidden metadata fields."
+      },
+      {
+        "name": "fieldControls",
+        "type": "boolean",
+        "default": "true",
+        "description": "Whether to expose shared field controls."
+      },
+      {
+        "name": "emptyText",
+        "type": "string|Node|(()=>string|Node)|null",
+        "default": "null",
+        "description": "Empty-result content."
+      },
+      {
+        "name": "titleField",
+        "type": "RecordCardValueSource",
+        "default": "null",
+        "description": "Title field id or explicit resolver."
+      },
+      {
+        "name": "subtitleField",
+        "type": "RecordCardValueSource",
+        "default": "null",
+        "description": "Subtitle field id or explicit resolver."
+      },
+      {
+        "name": "preview",
+        "type": "string|((record:ViewRecord,index:number)=>RecordCardPreview)",
+        "default": null,
+        "description": "Preview field id or explicit resolver."
+      },
+      {
+        "name": "previewAlt",
+        "type": "string|((record:ViewRecord,index:number)=>unknown)|null",
+        "default": "null",
+        "description": "Preview alt field, literal, or resolver."
+      },
+      {
+        "name": "link",
+        "type": "RecordCardLink|((record:ViewRecord,index:number)=>RecordCardLink)",
+        "default": null,
+        "description": "Safe native title link or resolver."
+      },
+      {
+        "name": "actions",
+        "type": "RecordCardAction[]|((record:ViewRecord,index:number)=>RecordCardAction[])",
+        "default": "[]",
+        "description": "Listener-free action descriptors or resolver."
+      },
+      {
+        "name": "groupBy",
+        "type": "string|((record:ViewRecord,index:number)=>unknown)|null",
+        "default": "null",
+        "description": "Field id or local group resolver."
+      },
+      {
+        "name": "groupOrder",
+        "type": "unknown[]",
+        "default": "[]",
+        "description": "Preferred group ids; missing ids render as empty groups."
+      },
+      {
+        "name": "minCardWidth",
+        "type": "number|string",
+        "default": "'18rem'",
+        "description": "Responsive minimum card width."
+      },
+      {
+        "name": "maxColumns",
+        "type": "number|null",
+        "default": "null",
+        "description": "Maximum cards per row; null is unconstrained."
+      },
+      {
+        "name": "variant",
+        "type": "'outlined'|'raised'|'filled'",
+        "default": "'outlined'",
+        "description": "Card surface treatment."
+      },
+      {
+        "name": "loadingCount",
+        "type": "number",
+        "default": "6",
+        "description": "Skeleton cards shown while loading."
+      },
+      {
+        "name": "headingLevel",
+        "type": "1|2|3|4|5|6",
+        "default": "3",
+        "description": "Per-card title heading level."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Card view'",
+        "description": "Accessible collection label."
+      }
+    ],
+    "events": [
+      {
+        "name": "recordaction",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      }
+    ],
+    "methods": [
+      {
+        "name": "getViewState",
+        "signature": "getViewState()",
+        "returns": "CardViewState",
+        "description": "Returns shared plus CardView configuration, never records or rendered values."
+      },
+      {
+        "name": "setViewState",
+        "signature": "setViewState(state, [options])",
+        "returns": "this",
+        "description": "Restores shared and CardView configuration. Unknown shared fields reconcile in RecordView."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target exactly, or removes an owned root."
+      }
+    ]
+  },
+  "Chart": {
+    "options": [
+      {
+        "name": "adapter",
+        "type": "ChartAdapter|null",
+        "default": "null",
+        "description": "Injected engine adapter."
+      },
+      {
+        "name": "type",
+        "type": "string",
         "default": "'bar'",
         "description": "Chart type passed to the adapter."
       },
@@ -2096,6 +2750,12 @@
         "type": "Node|string|number|{toElement: () => Node|null}|null",
         "default": "null",
         "description": "Body content."
+      },
+      {
+        "name": "scope",
+        "type": "Element|string|null",
+        "default": "null",
+        "description": "Element whose nearest Zx theme scope owns the overlay; defaults to the opener."
       }
     ],
     "events": [
@@ -2428,6 +3088,12 @@
         "type": "boolean",
         "default": "false",
         "description": "Whether a click within the panel closes it."
+      },
+      {
+        "name": "scope",
+        "type": "Element|string|null",
+        "default": "null",
+        "description": "Element whose nearest Zx theme scope owns the panel; defaults to the anchor."
       }
     ],
     "events": [
@@ -3530,138 +4196,462 @@
       }
     ]
   },
-  "Launcher": {
+  "KanbanView": {
     "options": [
       {
-        "name": "items",
-        "type": "LauncherItem[]",
+        "name": "fields",
+        "type": "import('../view/record-view.js').ViewField[]",
         "default": "[]",
-        "description": "Local application/action catalogue."
+        "description": "Shared field descriptors."
       },
       {
-        "name": "sources",
-        "type": "LauncherSource[]",
+        "name": "data",
+        "type": "KanbanRecord[]",
         "default": "[]",
-        "description": "Abortable asynchronous result sources."
+        "description": "Records."
       },
       {
-        "name": "query",
-        "type": "string",
-        "default": "''",
-        "description": "Initial query."
+        "name": "recordId",
+        "type": "string|((record:KanbanRecord)=>unknown)",
+        "default": "'ID'",
+        "description": "Stable record id accessor."
       },
       {
-        "name": "debounce",
-        "type": "number",
-        "default": "250",
-        "description": "Source-query delay in milliseconds."
+        "name": "sort",
+        "type": "{id:string,dir:'asc'|'desc'}|null",
+        "default": "null",
+        "description": "Shared initial sort."
       },
       {
-        "name": "minQuery",
-        "type": "number",
-        "default": "0",
-        "description": "Global source minimum query length."
+        "name": "sortMode",
+        "type": "'local'|'server'",
+        "default": "'local'",
+        "description": "Shared sort mode."
       },
       {
-        "name": "maxResults",
-        "type": "number",
-        "default": "100",
-        "description": "Maximum combined results."
+        "name": "selectable",
+        "type": "false|'single'|'multi'",
+        "default": "false",
+        "description": "Shared selection mode."
       },
       {
-        "name": "placeholder",
-        "type": "string",
-        "default": "'Search applications and records'",
-        "description": "Search-field placeholder."
+        "name": "selection",
+        "type": "unknown[]",
+        "default": "[]",
+        "description": "Initial record ids."
       },
       {
-        "name": "label",
-        "type": "string",
-        "default": "'Launcher'",
-        "description": "Dialog and field label."
+        "name": "fieldOrder",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Shared field order."
       },
       {
-        "name": "closeLabel",
-        "type": "string",
-        "default": "'Close launcher'",
-        "description": "Close-button accessible label."
+        "name": "hiddenFields",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Shared hidden fields."
       },
       {
-        "name": "resultsLabel",
-        "type": "string",
-        "default": "'Launcher results'",
-        "description": "Results-region accessible label."
+        "name": "fieldControls",
+        "type": "boolean",
+        "default": "true",
+        "description": "Show shared field controls."
       },
       {
         "name": "emptyText",
-        "type": "string",
-        "default": "'No results'",
-        "description": "Empty-state text."
+        "type": "string|Node|(() => string|Node)|null",
+        "default": "null",
+        "description": "Empty-board content."
       },
       {
-        "name": "loadingText",
-        "type": "string",
-        "default": "'Searching…'",
-        "description": "Loading-state text."
+        "name": "columnBy",
+        "type": "KanbanAccessor",
+        "default": "'status'",
+        "description": "Column accessor."
       },
       {
-        "name": "shortcut",
-        "type": "'mod+k'|false",
-        "default": "'mod+k'",
-        "description": "Optional global keyboard shortcut."
+        "name": "columns",
+        "type": "KanbanColumn[]|null",
+        "default": "null",
+        "description": "Explicit columns, or null to derive them."
       },
       {
-        "name": "hints",
-        "type": "false|{move?: string, open?: string, close?: string}",
-        "default": null,
-        "description": "Visible keyboard hints, or false."
-      }
-    ],
-    "events": [
+        "name": "swimlaneBy",
+        "type": "KanbanAccessor",
+        "default": "null",
+        "description": "Optional swim-lane accessor."
+      },
       {
-        "name": "select",
-        "payload": "{item, value, source, query}",
-        "description": "Preventable selection listener."
+        "name": "swimlanes",
+        "type": "KanbanSwimlane[]|null",
+        "default": "null",
+        "description": "Explicit lanes, or null to derive them."
       },
       {
-        "name": "query",
-        "payload": "{query: string}",
-        "description": "Query-change listener."
+        "name": "titleField",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Card title field or reader."
       },
       {
-        "name": "open",
-        "payload": "Record<string, never>",
-        "description": "Open listener."
+        "name": "subtitleField",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Card subtitle field or reader."
       },
       {
-        "name": "close",
-        "payload": "Record<string, never>",
-        "description": "Close listener."
+        "name": "preview",
+        "type": "string|((record:KanbanRecord,index:number)=>RecordCardPreview)|null",
+        "default": "null",
+        "description": "Preview field or reader."
       },
       {
-        "name": "error",
-        "payload": "{source: LauncherSource, error: unknown}",
-        "description": "Source error listener."
-      }
-    ],
-    "methods": [
+        "name": "previewAlt",
+        "type": "KanbanCardField",
+        "default": "null",
+        "description": "Preview alternative-text field or reader."
+      },
       {
-        "name": "open",
-        "signature": "open()",
-        "returns": "this",
-        "description": "Opens the launcher and focuses/selects its query."
+        "name": "link",
+        "type": "RecordCardLink|((record:KanbanRecord,index:number)=>RecordCardLink)|null",
+        "default": "null",
+        "description": "Record-card primary link descriptor or reader."
       },
       {
-        "name": "close",
-        "signature": "close()",
-        "returns": "this",
-        "description": "Closes the launcher."
+        "name": "actions",
+        "type": "RecordCardAction[]|((record:KanbanRecord,index:number)=>RecordCardAction[])",
+        "default": "[]",
+        "description": "Card actions."
       },
       {
-        "name": "toggle",
-        "signature": "toggle()",
-        "returns": "this",
-        "description": "Toggles the launcher."
+        "name": "moveMode",
+        "type": "'local'|'external'",
+        "default": "'local'",
+        "description": "Whether accepted moves update local data."
+      },
+      {
+        "name": "columnOrder",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Preferred column order."
+      },
+      {
+        "name": "swimlaneOrder",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Preferred swim-lane order."
+      },
+      {
+        "name": "collapsedColumns",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Initially collapsed columns."
+      },
+      {
+        "name": "collapsedSwimlanes",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Initially collapsed lanes."
+      },
+      {
+        "name": "showCounts",
+        "type": "boolean",
+        "default": "true",
+        "description": "Show record counts and WIP indicators."
+      },
+      {
+        "name": "showEmptyColumns",
+        "type": "boolean",
+        "default": "true",
+        "description": "Keep configured empty columns visible."
+      },
+      {
+        "name": "variant",
+        "type": "'outlined'|'raised'|'filled'",
+        "default": "'outlined'",
+        "description": "Shared record-card treatment."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Kanban board'",
+        "description": "Accessible board label."
+      }
+    ],
+    "events": [
+      {
+        "name": "recordmove",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      },
+      {
+        "name": "recordaction",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      }
+    ],
+    "methods": [
+      {
+        "name": "getColumns",
+        "signature": "getColumns()",
+        "returns": "KanbanColumn[]",
+        "description": "Returns resolved columns in visual order."
+      },
+      {
+        "name": "setColumns",
+        "signature": "setColumns(columns)",
+        "returns": "this",
+        "description": "Replaces configured columns. Pass null to derive them from current data."
+      },
+      {
+        "name": "getSwimlanes",
+        "signature": "getSwimlanes()",
+        "returns": "KanbanSwimlane[]",
+        "description": "Returns resolved lane descriptors in visual order."
+      },
+      {
+        "name": "setSwimlanes",
+        "signature": "setSwimlanes(lanes)",
+        "returns": "this",
+        "description": "Replaces configured lanes. Pass null to derive them from current data."
+      },
+      {
+        "name": "getColumnOrder",
+        "signature": "getColumnOrder()",
+        "returns": "string[]",
+        "description": "Returns the current resolved column order."
+      },
+      {
+        "name": "setColumnOrder",
+        "signature": "setColumnOrder(order, [options])",
+        "returns": "this",
+        "description": "Reconciles and applies a preferred column order."
+      },
+      {
+        "name": "moveColumn",
+        "signature": "moveColumn(id, targetId, [position])",
+        "returns": "this",
+        "description": "Moves a column relative to another."
+      },
+      {
+        "name": "getSwimlaneOrder",
+        "signature": "getSwimlaneOrder()",
+        "returns": "string[]",
+        "description": "Returns the current resolved lane order."
+      },
+      {
+        "name": "setSwimlaneOrder",
+        "signature": "setSwimlaneOrder(order, [options])",
+        "returns": "this",
+        "description": "Reconciles and applies a preferred lane order."
+      },
+      {
+        "name": "moveSwimlane",
+        "signature": "moveSwimlane(id, targetId, [position])",
+        "returns": "this",
+        "description": "Moves a lane relative to another."
+      },
+      {
+        "name": "getCollapsedColumns",
+        "signature": "getCollapsedColumns()",
+        "returns": "string[]",
+        "description": "Returns collapsed column ids."
+      },
+      {
+        "name": "setColumnCollapsed",
+        "signature": "setColumnCollapsed(id, [collapsed], [options])",
+        "returns": "this",
+        "description": "Expands or collapses one column across every lane."
+      },
+      {
+        "name": "toggleColumn",
+        "signature": "toggleColumn(id)",
+        "returns": "this",
+        "description": "Toggles a column."
+      },
+      {
+        "name": "getCollapsedSwimlanes",
+        "signature": "getCollapsedSwimlanes()",
+        "returns": "string[]",
+        "description": "Returns collapsed lane ids."
+      },
+      {
+        "name": "setSwimlaneCollapsed",
+        "signature": "setSwimlaneCollapsed(id, [collapsed], [options])",
+        "returns": "this",
+        "description": "Expands or collapses one lane."
+      },
+      {
+        "name": "toggleSwimlane",
+        "signature": "toggleSwimlane(id)",
+        "returns": "this",
+        "description": "Toggles a lane."
+      },
+      {
+        "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."
+      },
+      {
+        "name": "getViewState",
+        "signature": "getViewState()",
+        "returns": "KanbanViewState",
+        "description": "Returns common plus board-specific serializable configuration."
+      },
+      {
+        "name": "setViewState",
+        "signature": "setViewState(state, [options])",
+        "returns": "this",
+        "description": "Restores common and Kanban configuration. State from another record view is accepted safely."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores enhanced targets after base lifecycle cleanup."
+      }
+    ]
+  },
+  "Launcher": {
+    "options": [
+      {
+        "name": "items",
+        "type": "LauncherItem[]",
+        "default": "[]",
+        "description": "Local application/action catalogue."
+      },
+      {
+        "name": "sources",
+        "type": "LauncherSource[]",
+        "default": "[]",
+        "description": "Abortable asynchronous result sources."
+      },
+      {
+        "name": "query",
+        "type": "string",
+        "default": "''",
+        "description": "Initial query."
+      },
+      {
+        "name": "debounce",
+        "type": "number",
+        "default": "250",
+        "description": "Source-query delay in milliseconds."
+      },
+      {
+        "name": "minQuery",
+        "type": "number",
+        "default": "0",
+        "description": "Global source minimum query length."
+      },
+      {
+        "name": "maxResults",
+        "type": "number",
+        "default": "100",
+        "description": "Maximum combined results."
+      },
+      {
+        "name": "placeholder",
+        "type": "string",
+        "default": "'Search applications and records'",
+        "description": "Search-field placeholder."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Launcher'",
+        "description": "Dialog and field label."
+      },
+      {
+        "name": "closeLabel",
+        "type": "string",
+        "default": "'Close launcher'",
+        "description": "Close-button accessible label."
+      },
+      {
+        "name": "resultsLabel",
+        "type": "string",
+        "default": "'Launcher results'",
+        "description": "Results-region accessible label."
+      },
+      {
+        "name": "emptyText",
+        "type": "string",
+        "default": "'No results'",
+        "description": "Empty-state text."
+      },
+      {
+        "name": "loadingText",
+        "type": "string",
+        "default": "'Searching…'",
+        "description": "Loading-state text."
+      },
+      {
+        "name": "shortcut",
+        "type": "'mod+k'|false",
+        "default": "'mod+k'",
+        "description": "Optional global keyboard shortcut."
+      },
+      {
+        "name": "hints",
+        "type": "false|{move?: string, open?: string, close?: string}",
+        "default": null,
+        "description": "Visible keyboard hints, or false."
+      },
+      {
+        "name": "scope",
+        "type": "Element|string|null",
+        "default": "null",
+        "description": "Element whose nearest Zx theme scope owns an internally created launcher; defaults to the opener."
+      }
+    ],
+    "events": [
+      {
+        "name": "select",
+        "payload": "{item, value, source, query}",
+        "description": "Preventable selection listener."
+      },
+      {
+        "name": "query",
+        "payload": "{query: string}",
+        "description": "Query-change listener."
+      },
+      {
+        "name": "open",
+        "payload": "Record<string, never>",
+        "description": "Open listener."
+      },
+      {
+        "name": "close",
+        "payload": "Record<string, never>",
+        "description": "Close listener."
+      },
+      {
+        "name": "error",
+        "payload": "{source: LauncherSource, error: unknown}",
+        "description": "Source error listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "open",
+        "signature": "open()",
+        "returns": "this",
+        "description": "Opens the launcher and focuses/selects its query."
+      },
+      {
+        "name": "close",
+        "signature": "close()",
+        "returns": "this",
+        "description": "Closes the launcher."
+      },
+      {
+        "name": "toggle",
+        "signature": "toggle()",
+        "returns": "this",
+        "description": "Toggles the launcher."
       },
       {
         "name": "isOpen",
@@ -3997,6 +4987,12 @@
         "type": "boolean",
         "default": "true",
         "description": "Whether to render a close button."
+      },
+      {
+        "name": "scope",
+        "type": "Element|string|null",
+        "default": "null",
+        "description": "Element whose nearest Zx theme scope owns a floating toast."
       }
     ],
     "events": [],
@@ -4033,6 +5029,12 @@
         "type": "boolean",
         "default": "false",
         "description": "Whether to destroy the modal after it closes."
+      },
+      {
+        "name": "scope",
+        "type": "Element|string|null",
+        "default": "null",
+        "description": "Element whose nearest Zx theme scope owns the overlay; defaults to the opener."
       }
     ],
     "events": [
@@ -5090,144 +6092,498 @@
         "description": "Number of symbols."
       },
       {
-        "name": "allowHalf",
-        "type": "boolean",
-        "default": "false",
-        "description": "Whether half steps are selectable."
+        "name": "allowHalf",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether half steps are selectable."
+      },
+      {
+        "name": "clearable",
+        "type": "boolean",
+        "default": "true",
+        "description": "Whether re-selecting the current value clears it."
+      },
+      {
+        "name": "readonly",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether the rating is display-only."
+      },
+      {
+        "name": "disabled",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether interaction is disabled."
+      },
+      {
+        "name": "label",
+        "type": "string",
+        "default": "'Rating'",
+        "description": "Accessible name of the group."
+      },
+      {
+        "name": "icon",
+        "type": "string",
+        "default": "'star'",
+        "description": "Icon name used for each symbol."
+      },
+      {
+        "name": "labels",
+        "type": "string[]|null",
+        "default": "null",
+        "description": "Per-step accessible names, lowest first."
+      },
+      {
+        "name": "showValue",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether to render the numeric value beside the symbols."
+      },
+      {
+        "name": "count",
+        "type": "number|null",
+        "default": "null",
+        "description": "Optional rating count rendered beside the value."
+      },
+      {
+        "name": "size",
+        "type": "'sm'|'md'|'lg'",
+        "default": "'md'",
+        "description": "Symbol size."
+      },
+      {
+        "name": "msg",
+        "type": "Record<string, string>|Record<string, Record<string, string>>",
+        "default": null,
+        "description": "Localized messages."
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "payload": "{value: number}",
+        "description": "Change listener."
+      },
+      {
+        "name": "hover",
+        "payload": "{value: number|null}",
+        "description": "Hover-preview listener."
+      }
+    ],
+    "methods": [
+      {
+        "name": "get",
+        "signature": "get()",
+        "returns": "number",
+        "description": "Returns the current rating."
+      },
+      {
+        "name": "set",
+        "signature": "set(next, [options])",
+        "returns": "this",
+        "description": "Sets the rating, snapped to the configured step and clamped to `[0, max]`."
+      },
+      {
+        "name": "clear",
+        "signature": "clear([options])",
+        "returns": "this",
+        "description": "Clears the rating."
+      },
+      {
+        "name": "reset",
+        "signature": "reset([options])",
+        "returns": "this",
+        "description": "Restores the configured initial value."
+      },
+      {
+        "name": "setCount",
+        "signature": "setCount(count)",
+        "returns": "this",
+        "description": "Replaces the rating count shown beside the value."
+      },
+      {
+        "name": "focus",
+        "signature": "focus()",
+        "returns": "this",
+        "description": "Focuses the selected step, or the first one when unrated."
+      },
+      {
+        "name": "enable",
+        "signature": "enable()",
+        "returns": "this",
+        "description": "Enables user interaction."
+      },
+      {
+        "name": "disable",
+        "signature": "disable()",
+        "returns": "this",
+        "description": "Disables user interaction."
+      },
+      {
+        "name": "setReadonly",
+        "signature": "setReadonly(readonly)",
+        "returns": "this",
+        "description": "Sets the read-only state."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Restores an enhanced target to the markup it had before the takeover."
+      }
+    ]
+  },
+  "RecordCard": {
+    "options": [
+      {
+        "name": "fields",
+        "type": "ViewField[]",
+        "default": "[]",
+        "description": "Complete fields, used to resolve title and subtitle sources."
+      },
+      {
+        "name": "visibleFields",
+        "type": "ViewField[]",
+        "default": "fields",
+        "description": "Ordered fields rendered as labelled metadata."
+      },
+      {
+        "name": "titleField",
+        "type": "RecordCardValueSource",
+        "default": "null",
+        "description": "Field id or explicit value resolver."
+      },
+      {
+        "name": "subtitleField",
+        "type": "RecordCardValueSource",
+        "default": "null",
+        "description": "Field id or explicit value resolver."
+      },
+      {
+        "name": "preview",
+        "type": "string|((record:ViewRecord,index:number)=>RecordCardPreview)",
+        "default": null,
+        "description": "Preview field id or explicit resolver."
+      },
+      {
+        "name": "previewAlt",
+        "type": "string|((record:ViewRecord,index:number)=>unknown)|null",
+        "default": "null",
+        "description": "Alternative-text field, literal text, or resolver."
+      },
+      {
+        "name": "link",
+        "type": "RecordCardLink|((record:ViewRecord,index:number)=>RecordCardLink)",
+        "default": null,
+        "description": ""
+      },
+      {
+        "name": "actions",
+        "type": "RecordCardAction[]|((record:ViewRecord,index:number)=>RecordCardAction[])",
+        "default": "[]",
+        "description": ""
+      },
+      {
+        "name": "selectable",
+        "type": "false|'single'|'multi'",
+        "default": "false",
+        "description": "Selection presentation."
+      },
+      {
+        "name": "selected",
+        "type": "boolean",
+        "default": "false",
+        "description": "Current selection state."
+      },
+      {
+        "name": "variant",
+        "type": "'outlined'|'raised'|'filled'",
+        "default": "'outlined'",
+        "description": "Surface treatment."
+      },
+      {
+        "name": "headingLevel",
+        "type": "1|2|3|4|5|6",
+        "default": "3",
+        "description": "Card title heading level."
+      },
+      {
+        "name": "controls",
+        "type": "Node[]",
+        "default": "[]",
+        "description": "Listener-free, owner-created controls such as a move handle."
+      }
+    ],
+    "events": [],
+    "methods": []
+  },
+  "RecordView": {
+    "options": [
+      {
+        "name": "fields",
+        "type": "ViewField[]",
+        "default": "[]",
+        "description": "Shared ordered field descriptors."
+      },
+      {
+        "name": "data",
+        "type": "ViewRecord[]",
+        "default": "[]",
+        "description": "Initial records."
+      },
+      {
+        "name": "recordId",
+        "type": "string|((record: ViewRecord) => unknown)",
+        "default": "'ID'",
+        "description": "Record id accessor."
+      },
+      {
+        "name": "sort",
+        "type": "ViewSort|null",
+        "default": "null",
+        "description": "Initial sort."
+      },
+      {
+        "name": "sortMode",
+        "type": "'local'|'server'",
+        "default": "'local'",
+        "description": "Whether Zx reorders local records."
+      },
+      {
+        "name": "selectable",
+        "type": "ViewSelectionMode",
+        "default": "false",
+        "description": "Record selection behavior."
+      },
+      {
+        "name": "selection",
+        "type": "unknown[]",
+        "default": "[]",
+        "description": "Initially selected record ids."
+      },
+      {
+        "name": "fieldOrder",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Field ids in preferred order."
+      },
+      {
+        "name": "hiddenFields",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Initially hidden field ids."
+      },
+      {
+        "name": "fieldControls",
+        "type": "boolean",
+        "default": "true",
+        "description": "Whether concrete views show the shared field chooser."
+      },
+      {
+        "name": "emptyText",
+        "type": "string|Node|(() => string|Node)|null",
+        "default": "null",
+        "description": "Empty-result content."
+      }
+    ],
+    "events": [
+      {
+        "name": "recordclick",
+        "payload": "Record<string, unknown>",
+        "description": ""
+      },
+      {
+        "name": "recorddblclick",
+        "payload": "Record<string, unknown>",
+        "description": ""
+      },
+      {
+        "name": "datachange",
+        "payload": "{records:ViewRecord[]}",
+        "description": ""
+      },
+      {
+        "name": "selectionchange",
+        "payload": "{records:ViewRecord[],ids:unknown[]}",
+        "description": ""
+      },
+      {
+        "name": "sortchange",
+        "payload": "{id:string|null,dir:ViewSortDirection|null}",
+        "description": ""
+      },
+      {
+        "name": "fieldvisibilitychange",
+        "payload": "{visible:string[],hidden:string[]}",
+        "description": ""
+      },
+      {
+        "name": "fieldorderchange",
+        "payload": "{order:string[]}",
+        "description": ""
       },
       {
-        "name": "clearable",
-        "type": "boolean",
-        "default": "true",
-        "description": "Whether re-selecting the current value clears it."
+        "name": "statechange",
+        "payload": "{state:RecordViewState,reason:string}",
+        "description": ""
+      }
+    ],
+    "methods": [
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Cleans up a directly instantiated base view and restores an enhanced target."
       },
       {
-        "name": "readonly",
-        "type": "boolean",
-        "default": "false",
-        "description": "Whether the rating is display-only."
+        "name": "setData",
+        "signature": "setData(records)",
+        "returns": "this",
+        "description": "Replaces every record and clears selections whose ids disappeared."
       },
       {
-        "name": "disabled",
-        "type": "boolean",
-        "default": "false",
-        "description": "Whether interaction is disabled."
+        "name": "addData",
+        "signature": "addData(records)",
+        "returns": "this",
+        "description": "Appends records without mutating the supplied array."
       },
       {
-        "name": "label",
-        "type": "string",
-        "default": "'Rating'",
-        "description": "Accessible name of the group."
+        "name": "updateRecord",
+        "signature": "updateRecord(id, record)",
+        "returns": "this",
+        "description": "Replaces the record currently identified by `id`."
       },
       {
-        "name": "icon",
-        "type": "string",
-        "default": "'star'",
-        "description": "Icon name used for each symbol."
+        "name": "removeRecord",
+        "signature": "removeRecord(id)",
+        "returns": "this",
+        "description": "Removes one record by id."
       },
       {
-        "name": "labels",
-        "type": "string[]|null",
-        "default": "null",
-        "description": "Per-step accessible names, lowest first."
+        "name": "getRecord",
+        "signature": "getRecord(id)",
+        "returns": "ViewRecord|null",
+        "description": "Returns a record by id."
       },
       {
-        "name": "showValue",
-        "type": "boolean",
-        "default": "false",
-        "description": "Whether to render the numeric value beside the symbols."
+        "name": "getData",
+        "signature": "getData()",
+        "returns": "ViewRecord[]",
+        "description": "Returns a shallow copy in current display order."
       },
       {
-        "name": "count",
-        "type": "number|null",
-        "default": "null",
-        "description": "Optional rating count rendered beside the value."
+        "name": "setFields",
+        "signature": "setFields(fields)",
+        "returns": "this",
+        "description": "Replaces field descriptors while reconciling order, visibility, and sort by stable id."
       },
       {
-        "name": "size",
-        "type": "'sm'|'md'|'lg'",
-        "default": "'md'",
-        "description": "Symbol size."
+        "name": "getFields",
+        "signature": "getFields()",
+        "returns": "ViewField[]",
+        "description": "Returns cloned field descriptors in configured order."
       },
       {
-        "name": "msg",
-        "type": "Record<string, string>|Record<string, Record<string, string>>",
-        "default": null,
-        "description": "Localized messages."
-      }
-    ],
-    "events": [
+        "name": "getVisibleFields",
+        "signature": "getVisibleFields()",
+        "returns": "ViewField[]",
+        "description": "Returns visible cloned descriptors in configured order."
+      },
       {
-        "name": "change",
-        "payload": "{value: number}",
-        "description": "Change listener."
+        "name": "getHiddenFields",
+        "signature": "getHiddenFields()",
+        "returns": "string[]",
+        "description": "Returns hidden field ids in configured order."
       },
       {
-        "name": "hover",
-        "payload": "{value: number|null}",
-        "description": "Hover-preview listener."
-      }
-    ],
-    "methods": [
+        "name": "getFieldOrder",
+        "signature": "getFieldOrder()",
+        "returns": "string[]",
+        "description": "Returns the complete field id order."
+      },
       {
-        "name": "get",
-        "signature": "get()",
-        "returns": "number",
-        "description": "Returns the current rating."
+        "name": "setFieldVisible",
+        "signature": "setFieldVisible(id, [visible], [options])",
+        "returns": "this",
+        "description": "Shows or hides one field. The final visible field cannot be hidden."
       },
       {
-        "name": "set",
-        "signature": "set(next, [options])",
+        "name": "toggleField",
+        "signature": "toggleField(id, [options])",
         "returns": "this",
-        "description": "Sets the rating, snapped to the configured step and clamped to `[0, max]`."
+        "description": "Toggles one field."
       },
       {
-        "name": "clear",
-        "signature": "clear([options])",
+        "name": "moveField",
+        "signature": "moveField(id, targetId, [position], [options])",
         "returns": "this",
-        "description": "Clears the rating."
+        "description": "Moves one field relative to another."
       },
       {
-        "name": "reset",
-        "signature": "reset([options])",
+        "name": "setFieldOrder",
+        "signature": "setFieldOrder(order, [options])",
         "returns": "this",
-        "description": "Restores the configured initial value."
+        "description": "Reconciles a preferred field order with every current field."
       },
       {
-        "name": "setCount",
-        "signature": "setCount(count)",
+        "name": "setSort",
+        "signature": "setSort(id, [dir], [options])",
         "returns": "this",
-        "description": "Replaces the rating count shown beside the value."
+        "description": "Changes or clears the active sort."
       },
       {
-        "name": "focus",
-        "signature": "focus()",
+        "name": "getSort",
+        "signature": "getSort()",
+        "returns": "ViewSort|null",
+        "description": "Returns a copy of the active sort."
+      },
+      {
+        "name": "getSelection",
+        "signature": "getSelection()",
+        "returns": "ViewRecord[]",
+        "description": "Returns selected records in display order."
+      },
+      {
+        "name": "getSelectionIds",
+        "signature": "getSelectionIds()",
+        "returns": "unknown[]",
+        "description": "Returns selected record ids in display order."
+      },
+      {
+        "name": "setSelection",
+        "signature": "setSelection(ids, [options])",
         "returns": "this",
-        "description": "Focuses the selected step, or the first one when unrated."
+        "description": "Replaces selection from record ids."
       },
       {
-        "name": "enable",
-        "signature": "enable()",
+        "name": "clearSelection",
+        "signature": "clearSelection([options])",
         "returns": "this",
-        "description": "Enables user interaction."
+        "description": "Clears selection."
       },
       {
-        "name": "disable",
-        "signature": "disable()",
+        "name": "toggleSelection",
+        "signature": "toggleSelection(id, [options])",
         "returns": "this",
-        "description": "Disables user interaction."
+        "description": "Toggles a record selection, with optional multi-select range behavior."
       },
       {
-        "name": "setReadonly",
-        "signature": "setReadonly(readonly)",
+        "name": "setLoading",
+        "signature": "setLoading([loading])",
         "returns": "this",
-        "description": "Sets the read-only state."
+        "description": "Marks the whole view busy without imposing a loading presentation."
       },
       {
-        "name": "destroy",
-        "signature": "destroy()",
-        "returns": "void",
-        "description": "Restores an enhanced target to the markup it had before the takeover."
+        "name": "getViewState",
+        "signature": "getViewState()",
+        "returns": "RecordViewState",
+        "description": "Returns JSON-safe, persistence-neutral view configuration."
+      },
+      {
+        "name": "setViewState",
+        "signature": "setViewState(state, [options])",
+        "returns": "this",
+        "description": "Restores common configuration. Unknown fields are ignored and newly introduced fields append."
       }
     ]
   },
@@ -5659,6 +7015,12 @@
         "type": "boolean",
         "default": "false",
         "description": "Whether to destroy the sheet after it closes."
+      },
+      {
+        "name": "scope",
+        "type": "Element|string|null",
+        "default": "null",
+        "description": "Element whose nearest Zx theme scope owns a floating sheet; defaults to the opener."
       }
     ],
     "events": [
@@ -6700,6 +8062,12 @@
         "default": "false",
         "description": "Whether a column visibility chooser is rendered."
       },
+      {
+        "name": "columnReorder",
+        "type": "boolean",
+        "default": "false",
+        "description": "Whether the column chooser also exposes accessible earlier/later controls. Column headers never become draggable."
+      },
       {
         "name": "hiddenColumns",
         "type": "string[]",
@@ -6783,6 +8151,11 @@
         "name": "columnvisibilitychange",
         "payload": "{visible:string[],hidden:string[]}",
         "description": ""
+      },
+      {
+        "name": "columnorderchange",
+        "payload": "{order:string[]}",
+        "description": ""
       }
     ],
     "methods": [
@@ -6828,6 +8201,36 @@
         "returns": "TableRow[]",
         "description": "Returns a shallow copy of the current rows in display order."
       },
+      {
+        "name": "getColumns",
+        "signature": "getColumns()",
+        "returns": "TableColumn[]",
+        "description": "Returns shallow-cloned column descriptors in their current display order."
+      },
+      {
+        "name": "setColumns",
+        "signature": "setColumns(columns, [options])",
+        "returns": "this",
+        "description": "Replaces all column descriptors. Hidden state and the active sort follow retained stable IDs; an edit is canceled before cells are rebuilt."
+      },
+      {
+        "name": "getColumnOrder",
+        "signature": "getColumnOrder()",
+        "returns": "string[]",
+        "description": "Returns every stable column ID in current display order."
+      },
+      {
+        "name": "setColumnOrder",
+        "signature": "setColumnOrder(order, [options])",
+        "returns": "this",
+        "description": "Reconciles a partial or stale preferred order with every current column."
+      },
+      {
+        "name": "moveColumn",
+        "signature": "moveColumn(id, targetId, [position], [options])",
+        "returns": "this",
+        "description": "Moves one column to an edge of another column. Unknown IDs are a safe no-op."
+      },
       {
         "name": "getVisibleColumns",
         "signature": "getVisibleColumns()",
@@ -6870,6 +8273,18 @@
         "returns": "this",
         "description": "Activates a column sort. Local mode stably reorders data; server mode only updates the header state and emits the request event."
       },
+      {
+        "name": "getSort",
+        "signature": "getSort()",
+        "returns": "{id:string,dir:TableSortDirection}|null",
+        "description": "Returns a defensive copy of the active sort."
+      },
+      {
+        "name": "clearSort",
+        "signature": "clearSort([options])",
+        "returns": "this",
+        "description": "Clears the active sort indicator without attempting to reconstruct the caller's original row order. The current display order becomes the unsorted order until data is replaced."
+      },
       {
         "name": "getSelection",
         "signature": "getSelection()",
@@ -7010,6 +8425,138 @@
     "events": [],
     "methods": []
   },
+  "TableView": {
+    "options": [
+      {
+        "name": "fields",
+        "type": "ViewField[]",
+        "default": "[]",
+        "description": "Shared ordered field descriptors. These win over `table.columns`."
+      },
+      {
+        "name": "data",
+        "type": "TableViewRecord[]",
+        "default": "[]",
+        "description": "Initial records. These win over `table.data`."
+      },
+      {
+        "name": "recordId",
+        "type": "string|((record:TableViewRecord)=>unknown)",
+        "default": "'ID'",
+        "description": "Stable record id accessor."
+      },
+      {
+        "name": "sort",
+        "type": "ViewSort|null",
+        "default": "null",
+        "description": "Initial shared sort."
+      },
+      {
+        "name": "sortMode",
+        "type": "'local'|'server'",
+        "default": "'local'",
+        "description": "Local or server-controlled sorting."
+      },
+      {
+        "name": "selectable",
+        "type": "false|'single'|'multi'",
+        "default": "false",
+        "description": "Shared selection behavior."
+      },
+      {
+        "name": "selection",
+        "type": "unknown[]",
+        "default": "[]",
+        "description": "Initially selected record ids."
+      },
+      {
+        "name": "fieldOrder",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Preferred stable field order."
+      },
+      {
+        "name": "hiddenFields",
+        "type": "string[]",
+        "default": "[]",
+        "description": "Initially hidden field ids."
+      },
+      {
+        "name": "fieldControls",
+        "type": "boolean",
+        "default": "true",
+        "description": "Show the accessible visibility and reorder disclosure."
+      },
+      {
+        "name": "emptyText",
+        "type": "string|Node|(()=>string|Node)|null",
+        "default": "null",
+        "description": "Empty-result content."
+      },
+      {
+        "name": "table",
+        "type": "TableOptions",
+        "default": "{}",
+        "description": "Advanced low-level Table options. Shared options win where their contracts overlap; all other options and callbacks are forwarded unchanged."
+      }
+    ],
+    "events": [
+      {
+        "name": "recordclick",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      },
+      {
+        "name": "recorddblclick",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      },
+      {
+        "name": "datachange",
+        "payload": "{records:TableViewRecord[]}",
+        "description": ""
+      },
+      {
+        "name": "selectionchange",
+        "payload": "{records:TableViewRecord[],ids:unknown[]}",
+        "description": ""
+      },
+      {
+        "name": "sortchange",
+        "payload": "{id:string|null,dir:'asc'|'desc'|null}",
+        "description": ""
+      },
+      {
+        "name": "fieldvisibilitychange",
+        "payload": "{visible:string[],hidden:string[]}",
+        "description": ""
+      },
+      {
+        "name": "fieldorderchange",
+        "payload": "{order:string[]}",
+        "description": ""
+      },
+      {
+        "name": "statechange",
+        "payload": "Record<string,unknown>",
+        "description": ""
+      }
+    ],
+    "methods": [
+      {
+        "name": "getTable",
+        "signature": "getTable()",
+        "returns": "Table",
+        "description": "Returns the composed Table for advanced methods and Table-specific events."
+      },
+      {
+        "name": "destroy",
+        "signature": "destroy()",
+        "returns": "void",
+        "description": "Destroys the inner Table and restores an enhanced target exactly once."
+      }
+    ]
+  },
   "TagPicker": {
     "options": [
       {