@simai-studio/view 0.0.0-stage → 1.0.0

package/dist/smart/view-table/component.json

@@ -0,0 +1,2738 @@
+{
+  "$comment": "sf-table from its component.json (standard simai.smart-component 1.3.8, vocabulary 1.1.5), migrated from ui-control control/smart-architecture/migration/out/table (convert-1.3.8.mjs over ui-pro 9cbe061); every x-todo decided in x-decisions.",
+  "id": "smart.view-table",
+  "tag": "sf-view-table",
+  "version": "1.14.0",
+  "kind": "leaf",
+  "family": "table",
+  "settings": {
+    "selectable": {
+      "type": "boolean",
+      "default": true
+    },
+    "settings": {
+      "type": "boolean",
+      "default": true
+    },
+    "actions": {
+      "type": "boolean",
+      "default": true
+    },
+    "row-actions": {
+      "type": "boolean",
+      "default": true
+    },
+    "creatable": {
+      "type": "boolean",
+      "default": true,
+      "summary": "The create button and its menu of kinds, inside actions. A data view turns it off for a host on port 1.10.0 that does not announce create-record."
+    },
+    "filter-templates": {
+      "type": "boolean",
+      "default": true,
+      "summary": "The button that saves the filter as a template. A data view turns it off when the host keeps no saved views."
+    },
+    "settings-menu": {
+      "type": "boolean",
+      "default": true,
+      "summary": "The gear in the head of the settings column, which opens the column settings. Off, the column still carries each row's menu. A data view turns it off for a host on port 1.10.0 that does not announce personal-column-settings."
+    },
+    "pagin": {
+      "type": "boolean",
+      "default": false
+    },
+    "filter-text": {
+      "type": "string",
+      "default-from": "runtime.filter-text"
+    },
+    "clear-text": {
+      "type": "string",
+      "default-from": "runtime.clear-text"
+    },
+    "search-placeholder": {
+      "type": "string",
+      "default-from": "runtime.search-placeholder"
+    },
+    "create-text": {
+      "type": "string",
+      "default-from": "runtime.create-text"
+    },
+    "pagination-total": {
+      "type": "number",
+      "default": 10,
+      "integer": true,
+      "min": 0
+    },
+    "pagination-page-size": {
+      "type": "number",
+      "default": 10,
+      "integer": true,
+      "min": 1,
+      "max": 100
+    },
+    "page-sizes": {
+      "type": "string",
+      "default": "10,20,30,40"
+    },
+    "context-menu-columns": {
+      "type": "number",
+      "default": 1,
+      "summary": "How many columns the settings menu splits its items into. One until a host asks for more: the read was bare for the whole life of this input, so neither its declared default nor a value a host passed ever reached the menu.",
+      "integer": true,
+      "min": 1,
+      "max": 4
+    },
+    "remember-widths": {
+      "type": "boolean",
+      "default": false,
+      "summary": "Remember the column widths as a view preference (SF.Preferences, under preferences-key or table-settings-key) for a table no host keeps settings for; a double click on a column's edge forgets that column's width."
+    },
+    "table-settings-key": {
+      "type": "string",
+      "default": "",
+      "summary": "Which stored settings this table uses. Empty means the element's own id, and then its instance id, so each table on a page keeps its own. A real default here would make every table share one key and overwrite the others."
+    },
+    "data-state": {
+      "type": "enum",
+      "values": [
+        "auto",
+        "loading",
+        "ready",
+        "populated",
+        "empty",
+        "error"
+      ],
+      "default": "auto",
+      "x-alias": {
+        "populated": "ready"
+      }
+    },
+    "loading-text": {
+      "type": "string",
+      "default-from": "runtime.loading-text"
+    },
+    "empty-text": {
+      "type": "string",
+      "default-from": "runtime.empty-text"
+    },
+    "empty-description": {
+      "type": "string"
+    },
+    "error-text": {
+      "type": "string",
+      "default-from": "runtime.error-text"
+    },
+    "retry-text": {
+      "type": "string",
+      "default-from": "runtime.retry-text"
+    },
+    "toolbar": {
+      "type": "boolean",
+      "default": true,
+      "summary": "Show the built-in toolbar; a composite can provide its own toolbar slot."
+    },
+    "pin-column-label": {
+      "type": "string",
+      "default-from": "runtime.pin-column-label",
+      "summary": "Accessible name and tooltip of the control that pins a column."
+    },
+    "unpin-column-label": {
+      "type": "string",
+      "default-from": "runtime.unpin-column-label",
+      "summary": "Accessible name and tooltip of the control that unpins a column."
+    },
+    "column-move-label": {
+      "type": "string",
+      "default-from": "runtime.column-move-label",
+      "summary": "Accessible name of the handle that moves a column in the settings list; the column label is appended to it."
+    },
+    "column-search-placeholder": {
+      "type": "string",
+      "default-from": "runtime.column-search-placeholder",
+      "summary": "Placeholder and accessible name of the search field above the column settings list."
+    },
+    "column-search-empty-text": {
+      "type": "string",
+      "default-from": "runtime.column-search-empty-text",
+      "summary": "Shown in place of the column settings list when the search matches no field."
+    },
+    "vertical-scroll": {
+      "type": "enum",
+      "values": [
+        "self",
+        "page"
+      ],
+      "default": "self",
+      "summary": "Whether the table scrolls within itself or lets the page scroll. Declared as a string with two values; the manifest previously said boolean true, which was wrong in both the type and the default."
+    },
+    "filter-apply-text": {
+      "type": "string",
+      "default-from": "runtime.filter-apply-text",
+      "summary": "Label of the filter window’s commit button; the number of conditions a press would change is appended to it while a draft is pending."
+    },
+    "layout": {
+      "type": "enum",
+      "values": [
+        "auto",
+        "table",
+        "list"
+      ],
+      "default": "table",
+      "summary": "How the records are drawn: a table, a compact list of records, or auto -- a table while the table's container is at least list-below pixels wide, the list below that. sf-view asks for auto on a page's list."
+    },
+    "list-below": {
+      "type": "number",
+      "default": 600,
+      "summary": "The container width, in pixels, below which layout auto draws the compact list."
+    },
+    "list-fields": {
+      "type": "number",
+      "default": 3,
+      "summary": "How many fields a record shows under its title in the compact list, chosen by the columns' priority."
+    },
+    "size": {
+      "type": "enum",
+      "values": [
+        "1/2",
+        "1"
+      ],
+      "default": "1",
+      "summary": "The step of the size ladder the table's controls and rows take: 1, or the dense 1/2 -- 32px controls, 14/20 text, rows of the step's height. A size of 1 written on an element the table draws becomes the table's."
+    },
+    "preferences-key": {
+      "type": "string",
+      "default": "",
+      "summary": "The key this table's arrangement -- order, visibility, pinning, widths -- is kept under as a view preference (SF.Preferences, sf-table/<key>); a data view passes its own. Without it table-settings-key is used, and without either nothing is kept."
+    },
+    "row-actions-visible": {
+      "type": "enum",
+      "values": [
+        "hover",
+        "always"
+      ],
+      "default": "hover",
+      "summary": "Where a row's action buttons are drawn: in the row under the pointer, with the focus or current (hover, the default), or in every row (always)."
+    },
+    "drag-rows": {
+      "type": "boolean",
+      "default": false,
+      "summary": "Rows may be dragged out of the list as records (application/x-sf-records+json): the row's record, or every selected record when it is one of them."
+    },
+    "row-reorder": {
+      "type": "boolean",
+      "default": false,
+      "summary": "Rows can be put in another order by dragging them inside the list; a drop emits sf-table-rows-reorder {ids, before, order}. A data view sets it when the host offers row-reorder."
+    },
+    "inline-edit": {
+      "type": "boolean",
+      "default": false,
+      "summary": "A boolean cell the record names in `editable` is a checkbox; pressing it emits sf-table-cell-set {id, key, value, revision} and the cell waits for the host. A data view sets it when the host offers inline-edit."
+    },
+    "active-filter-fields": {
+      "type": "list",
+      "entries": {
+        "key": "id"
+      }
+    },
+    "bulk-actions": {
+      "type": "list"
+    },
+    "columns": {
+      "type": "list",
+      "of": {
+        "key": "string",
+        "label": "string"
+      },
+      "x-shape": "columns[].key and columns[].label are the package's (ui-pro 9cbe061 table/smart.manifest.json item_contract.package_owned); width, order, visibility and pinning are a person's column settings; constant columns in a manifest give only the key, the label lives in lang roles.<role>.columns.<key> (standard 1.3.8 §11.3)"
+    },
+    "create-items": {
+      "type": "list"
+    },
+    "filter-fields": {
+      "type": "list"
+    },
+    "rows": {
+      "type": "list",
+      "entries": {
+        "key": "id",
+        "changes": "revision"
+      },
+      "of": {
+        "id": "id",
+        "revision": {
+          "type": "string",
+          "optional": true
+        }
+      },
+      "x-shape": "one entry per row: its id, its revision, and one field per column key; the vocabulary's items (§2.1), written by the host or the data view"
+    },
+    "table-data": {
+      "type": "object"
+    },
+    "table-settings": {
+      "type": "object"
+    },
+    "templates": {
+      "type": "list"
+    },
+    "toolbar-actions": {
+      "type": "list"
+    },
+    "sort": {
+      "type": "list",
+      "of": {
+        "key": "string",
+        "direction": {
+          "type": "enum",
+          "values": [
+            "asc",
+            "desc"
+          ]
+        }
+      },
+      "controlled": true,
+      "x-shape": "vocabulary 1.1.5 §2.1 sort: [{key, direction}], the host's echo; a person's click is the event sort-change"
+    },
+    "current": {
+      "type": "string",
+      "default": "",
+      "x-shape": "the id of the row the page has open; the row carries aria-current",
+      "summary": "The id of the row the page has open: that row carries aria-current and data-current. Writing it marks the row; it does not focus it and sends no event (component.json settings.current)."
+    }
+  },
+  "values": {
+    "selected": {
+      "type": "id",
+      "optional": true,
+      "summary": "the current row's id"
+    },
+    "selection": {
+      "type": "list",
+      "default": [],
+      "summary": "the marked rows' ids, in row order"
+    }
+  },
+  "events": {
+    "select": {
+      "carries": {
+        "ids": "list"
+      },
+      "summary": "The marked rows changed, vocabulary §5 select {ids}: once per change of the explicit selection, clearing included. The old name sf-port-output follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "apply": {
+      "carries": {
+        "action": "string",
+        "scope": {
+          "type": "enum",
+          "values": [
+            "entry",
+            "selection",
+            "filter"
+          ]
+        },
+        "ids": "list",
+        "revisions": {
+          "type": "object",
+          "optional": true
+        }
+      },
+      "summary": "A row's or the selection's action, vocabulary §5 apply: {action, scope: entry | selection, ids, revisions}. The host decides; emission is not success. The old name sf-table-action-intent follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "save": {
+      "carries": {
+        "kind": {
+          "type": "enum",
+          "values": [
+            "columns"
+          ]
+        },
+        "reason": "string",
+        "column-settings": {
+          "type": "object",
+          "summary": "The column settings now in force (order, widths, pinned, hidden)."
+        },
+        "table-settings-key": {
+          "type": "string",
+          "summary": "The table's settings key."
+        }
+      },
+      "summary": "The person's column settings, vocabulary §5 save {kind: columns, reason, columnSettings, tableSettingsKey}. The old name sf-table-column-settings-change follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "column-settings-reset": {
+      "carries": {
+        "target": {
+          "type": "enum",
+          "values": [
+            "personal"
+          ],
+          "summary": "The layer to reset. The table only resets the person's own layer."
+        },
+        "table-settings-key": {
+          "type": "string",
+          "nullable": true,
+          "summary": "The table's settings key, or null when it has none."
+        }
+      },
+      "own-verb": true,
+      "summary": "The person asked for the default columns back. The table drops its own stored arrangement and names no defaults: the host (or a data view) resets the person's layer and answers with its defaults."
+    },
+    "create": {
+      "carries": {
+        "item": {
+          "type": "string",
+          "nullable": true,
+          "optional": true
+        }
+      },
+      "summary": "The create button or one of its kinds, vocabulary §5 create {item}. The old name sf-table-create-intent follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "filter-change": {
+      "carries": {
+        "template-key": {
+          "type": "string",
+          "summary": "The selected template's key, or an empty string."
+        },
+        "template-label": {
+          "type": "string",
+          "summary": "The selected template's label, or an empty string."
+        },
+        "values": {
+          "type": "object",
+          "summary": "The filter values now in force, keyed by filter field."
+        },
+        "tags": {
+          "type": "object",
+          "summary": "The active filter chips, keyed by filter field."
+        }
+      },
+      "own-verb": true,
+      "summary": "Request a host-side query after the active filter changes: Apply in the filter window, a chip removed, or the filter cleared. A data view turns it into query.change with filters from values. The detail is the table's getFilterPayload(): the selected template's own data fields spread first, then these four.",
+      "x-detail": "also the selected template's data"
+    },
+    "query": {
+      "carries": {
+        "reason": "string",
+        "context": "object",
+        "sequence": {
+          "type": "number",
+          "integer": true
+        }
+      },
+      "summary": "A context query of the composition input port, vocabulary §5.1 query {reason, context, sequence}. The old name sf-table-query-intent follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "refresh": {
+      "carries": {},
+      "summary": "The retry button of a failed list, vocabulary §5 refresh. The old name sf-table-retry follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "search-change": {
+      "carries": {
+        "search": "string"
+      },
+      "own-verb": true,
+      "summary": "Request a host-side query after the debounced search value changes."
+    },
+    "sort-change": {
+      "carries": {
+        "key": {
+          "type": "string",
+          "schema": {
+            "minLength": 1
+          }
+        },
+        "direction": {
+          "type": "enum",
+          "values": [
+            "asc",
+            "desc",
+            null
+          ],
+          "nullable": true
+        }
+      },
+      "own-verb": true,
+      "summary": "The user activated a sortable header. Direction cycles asc, desc, null (unsorted). Intent only: the table marks the header but does not reorder rows; the host reorders or reloads."
+    },
+    "template-delete": {
+      "carries": {
+        "key": {
+          "type": "string",
+          "schema": {
+            "minLength": 1
+          }
+        }
+      },
+      "own-verb": true,
+      "summary": "The user deleted saved templates on the Templates tab and pressed Apply. Intent only: the host removes the saved view. One event per deleted template."
+    },
+    "template-save": {
+      "carries": {},
+      "own-verb": true,
+      "summary": "Request persistence of one or more filter templates (order, pin, delete, default, selected flags or data). Loading a saved view is reported by sf-table-template-select."
+    },
+    "template-select": {
+      "carries": {
+        "key": {
+          "type": "string",
+          "schema": {
+            "minLength": 1
+          }
+        }
+      },
+      "own-verb": true,
+      "summary": "The user applied a different saved template on the Templates tab. Intent only: the host loads that saved view."
+    },
+    "toolbar-action": {
+      "carries": {
+        "action": "string",
+        "href": {
+          "type": "string",
+          "nullable": true,
+          "optional": true
+        }
+      },
+      "cancelable": true,
+      "own-verb": true,
+      "summary": "The user chose one of the view's own actions from the toolbar menu. Intent only, and cancelable: the component follows an item's same-site href unless the host takes the navigation over with preventDefault."
+    },
+    "reference-open": {
+      "carries": {
+        "field": "string",
+        "value": "object",
+        "href": "string"
+      },
+      "cancelable": true,
+      "own-verb": true,
+      "x-detail": "also recordId, the row's id"
+    },
+    "expand": {
+      "carries": {
+        "id": "id",
+        "expanded": {
+          "type": "boolean",
+          "optional": true
+        }
+      },
+      "summary": "A tree row opened or closed, vocabulary §5 expand {id, expanded}. The old name sf-table-tree-toggle follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "load-more": {
+      "carries": {
+        "direction": {
+          "type": "enum",
+          "values": [
+            "after"
+          ]
+        },
+        "parent": {
+          "type": "id",
+          "nullable": true
+        },
+        "cursor": {
+          "type": "string",
+          "nullable": true
+        }
+      },
+      "summary": "The next page of a tree level, vocabulary §5 load-more {direction: after, parent, cursor}. The old name sf-table-tree-more follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "rows-drag": {
+      "carries": {
+        "ids": {
+          "type": "list",
+          "summary": "The ids dragged: every selected id when the dragged row is selected, otherwise that row's id alone.",
+          "schema": {
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1
+          }
+        },
+        "source": {
+          "type": "string",
+          "nullable": true,
+          "summary": "Where the rows come from: the table's preferences-key, table-settings-key or id, or null."
+        }
+      },
+      "own-verb": true,
+      "summary": "Rows began to be dragged out of a list with drag-rows, for a drop target such as a tree; the same {ids, source} rides in the drag data as application/x-sf-records+json."
+    },
+    "move": {
+      "carries": {
+        "ids": "list",
+        "before": {
+          "type": "id",
+          "nullable": true
+        },
+        "order": "list"
+      },
+      "summary": "Rows put in another order, vocabulary §5 move {ids, before, order}. The old name sf-table-rows-reorder follows once with its old detail until 2026-12-01 (aliases.json)."
+    },
+    "cell-set": {
+      "carries": {
+        "id": "object",
+        "key": "string",
+        "value": "object",
+        "revision": "object"
+      },
+      "own-verb": true,
+      "summary": "A checkable cell was pressed: the record, the field, the new value and the record's revision."
+    },
+    "view-change": {
+      "carries": {
+        "view": "object",
+        "everywhere": "boolean"
+      },
+      "own-verb": true
+    },
+    "window": {
+      "carries": {
+        "first": {
+          "type": "number",
+          "integer": true
+        },
+        "last": {
+          "type": "number",
+          "integer": true
+        }
+      },
+      "own-verb": true,
+      "summary": "The rows drawn of a long list changed (standard 1.3.8 §18.4): {first, last}, row indexes in the list."
+    }
+  },
+  "actions": {
+    "add-rows": {
+      "with": {
+        "rows": "list"
+      },
+      "summary": "Append another backend page for show-more mode."
+    },
+    "apply-query-result": {
+      "with": {
+        "sequence": {
+          "type": "number",
+          "integer": true,
+          "schema": {
+            "minimum": 1
+          }
+        },
+        "rows": "list"
+      },
+      "summary": "Apply rows answering the newest pending context query. Returns false and changes nothing for a stale, repeated or unknown sequence.",
+      "x-returns": {
+        "type": "boolean"
+      }
+    },
+    "clear-selection": {
+      "summary": "Clear the explicit selection of this instance; emits the selection port once when it changes."
+    },
+    "request-action-intent": {
+      "with": {
+        "action-id": {
+          "type": "string",
+          "schema": {
+            "minLength": 1
+          }
+        },
+        "record-ids": {
+          "type": "list",
+          "schema": {
+            "items": {
+              "type": [
+                "string",
+                "integer"
+              ],
+              "minLength": 1
+            },
+            "minItems": 1
+          }
+        }
+      },
+      "emits": "apply",
+      "summary": "Emit a typed row or bulk action request; the host owns execution and authorization. Invalid arguments throw TypeError before emission."
+    },
+    "request-create-intent": {
+      "with": {
+        "item-id": {
+          "type": "string",
+          "optional": true,
+          "nullable": true
+        }
+      },
+      "emits": "create",
+      "summary": "Emit sf-table-create-intent for the main button (null) or a declared create item id."
+    },
+    "request-retry": {
+      "emits": "refresh",
+      "summary": "Emit a retry intent after a failed data request."
+    },
+    "set-sort": {
+      "with": {
+        "key": {
+          "type": "string",
+          "nullable": true
+        },
+        "direction": {
+          "type": "enum",
+          "values": [
+            "asc",
+            "desc"
+          ],
+          "nullable": true
+        }
+      },
+      "summary": "Show the host's current sort on the headers without emitting an event; (null, null) clears it."
+    },
+    "toggle-tree-row": {
+      "with": {
+        "row": "object"
+      },
+      "emits": "expand",
+      "summary": "Say that a tree row was opened or closed (sf-table-tree-toggle).",
+      "x-returns": {
+        "type": "object",
+        "description": "The element."
+      }
+    },
+    "request-tree-more": {
+      "with": {
+        "row": "object"
+      },
+      "emits": "load-more",
+      "summary": "Ask for the next page of a tree level (sf-table-tree-more).",
+      "x-returns": {
+        "type": "object",
+        "description": "The element."
+      }
+    },
+    "focus-row": {
+      "with": {
+        "id": "id"
+      }
+    }
+  },
+  "selection": "many",
+  "window": true,
+  "side-effects": [
+    "network"
+  ],
+  "keyboard": {
+    "host": {
+      "Tab": "reach",
+      "Shift+Tab": "reach",
+      "Escape": "close"
+    },
+    "row": {
+      "ArrowDown": "focus:next",
+      "ArrowUp": "focus:prev",
+      "Home": "focus:first",
+      "End": "focus:last",
+      "Enter": "open",
+      "Space": "toggle:selected"
+    }
+  },
+  "port": {
+    "id": "simai.dataview-port",
+    "version": "1.0.0",
+    "contract": "src/core/contracts/ports/simai.dataview-port/1.0.0/port.json"
+  },
+  "relations": [
+    {
+      "name": "cl-checkbox"
+    },
+    {
+      "name": "cl-reference-link",
+      "$comment": [
+        "The cells drawn with another Smart element come with the table, not",
+        "after the rows: a reference (sf-reference-link), a file",
+        "(sf-file-preview) and a colour (sf-input-color, in a cell as well as in a",
+        "card). Fetched lazily, each upgraded some 600 ms after the rows had",
+        "drawn and moved the row (stand 24: CLS 0.0145 at 1280 when the data",
+        "arrived)."
+      ]
+    },
+    {
+      "name": "cl-file-preview"
+    },
+    {
+      "name": "cl-input-color"
+    },
+    {
+      "name": "cl-input-country",
+      "lazy": true,
+      "$comment": [
+        "A string whose variant is a phone draws sf-input-country. The rule fence",
+        "reads a component's own templates, and this element comes from the shared",
+        "renderer set instead -- so nothing would have caught its absence until a",
+        "page showed an element that never upgraded."
+      ]
+    },
+    {
+      "name": "cl-button"
+    },
+    {
+      "name": "cl-button-icon"
+    },
+    {
+      "name": "icons"
+    },
+    {
+      "name": "cl-input"
+    },
+    {
+      "name": "cl-tag"
+    },
+    {
+      "name": "cl-pagination"
+    },
+    {
+      "name": "cl-spinner"
+    },
+    {
+      "name": "cl-empty-state",
+      "$comment": [
+        "A table without rows says why in sf-empty-state (owner, 2026-10-14)."
+      ]
+    },
+    {
+      "name": "cl-input-date",
+      "lazy": true
+    },
+    {
+      "name": "cl-dropdown"
+    },
+    {
+      "name": "cl-tabs",
+      "lazy": true,
+      "$comment": [
+        "The gear's tabs, «Поля» and «Вид» (owner, 2026-10-14)."
+      ]
+    },
+    {
+      "name": "cl-menu-context",
+      "lazy": true
+    },
+    {
+      "name": "cl-sortable",
+      "lazy": true,
+      "$comment": [
+        "The windows' lists are reordered with sf-sortable (owner, 2026-10-13)."
+      ]
+    },
+    {
+      "name": "cl-radio",
+      "lazy": true,
+      "$comment": [
+        "The filter window's templates are a radio list: a page with nothing else",
+        "using sf-radio drew its rows empty (owner, 2026-10-14)."
+      ]
+    },
+    {
+      "name": "cl-resizer",
+      "lazy": true,
+      "$comment": [
+        "A column's edge is the Framework's resize gesture (owner, 2026-10-14)."
+      ]
+    },
+    {
+      "name": "cl-avatar"
+    },
+    {
+      "name": "cl-badge"
+    },
+    {
+      "name": "cl-list-item"
+    },
+    {
+      "name": "cl-modal",
+      "lazy": true
+    },
+    {
+      "name": "cl-slider-range",
+      "lazy": true
+    }
+  ],
+  "templates": {
+    "default": {
+      "file": "js/templates/default.js",
+      "$comment": "The Lit template in JavaScript, the migration form of §5.2 (§16)."
+    }
+  },
+  "presentation": {
+    "skeleton": {
+      "$comment": "The rows arrive after the first paint (the data view, or the host, sets them): the derived skeleton (static/default/<example>.skeleton.html) holds their box until they do, and the element keeps it until rows are set (standard 1.3.8 §5.4). Derived rather than skeleton.html: a row is a cell per column, and the template syntax repeats one level (first-paint-skeleton.mjs).",
+      "late": [
+        "rows"
+      ]
+    }
+  },
+  "styles": "js/templates/default.css",
+  "examples": "examples.json",
+  "docs": "docs/docs.md",
+  "lang": "lang/",
+  "accessibility": {
+    "role": "grid",
+    "name": {
+      "from": [
+        "aria-label"
+      ]
+    },
+    "keys": {
+      "Tab": "reach",
+      "Escape": "close",
+      "ArrowDown": "focus:next",
+      "ArrowUp": "focus:prev",
+      "Home": "focus:first",
+      "End": "focus:last",
+      "Enter": "open",
+      "Space": "toggle:selected"
+    },
+    "announces": {}
+  },
+  "host-states": {
+    "data-sf-view-stripes": "boolean",
+    "data-sf-page-scroll": "boolean"
+  },
+  "css-variables": {
+    "--sf-table-row-block-size-1/2": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: a one-line row at the step, size 1/2 (docs.md, the list's box)"
+    },
+    "--sf-table-row-block-size-1": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: a one-line row at the step, size 1 (docs.md, the list's box)"
+    },
+    "--sf-table-row-2-lines-block-size-1/2": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: a row whose text takes two lines, size 1/2 (docs.md, the list's box)"
+    },
+    "--sf-table-row-2-lines-block-size-1": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: a row whose text takes two lines, size 1 (docs.md, the list's box)"
+    },
+    "--sf-table-head-block-size-1/2": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: the head row, size 1/2 (docs.md, the list's box)"
+    },
+    "--sf-table-head-block-size-1": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: the head row, size 1 (docs.md, the list's box)"
+    },
+    "--sf-table-toolbar-block-size-1/2": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: the toolbar on one line, size 1/2 (docs.md, the list's box)"
+    },
+    "--sf-table-toolbar-block-size-1": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: the toolbar on one line, size 1 (docs.md, the list's box)"
+    },
+    "--sf-table-toolbar-gap": {
+      "type": "length",
+      "state": "default",
+      "x-summary": "published on :root, set by the sheet, read by a page: the gap between the toolbar and the head (docs.md, the list's box)"
+    },
+    "--sf-table-head--background-color": {
+      "type": "color",
+      "state": "default"
+    },
+    "--sf-table-row--background-color": {
+      "type": "color",
+      "state": "default"
+    },
+    "--sf-table--cell-spacing": {
+      "type": "length",
+      "state": "default"
+    },
+    "--sf-table-cell--line-clamp": {
+      "type": "number",
+      "state": "default"
+    },
+    "--sf-table-context-menu--z-index": {
+      "type": "number",
+      "state": "open"
+    },
+    "--sf-table-context-menu--max-width": {
+      "type": "length",
+      "state": "open"
+    }
+  },
+  "aliases": {
+    "$comment": "Dated aliases of sf-view-table for the shim (core/js/aliases.js, standard §16 item 20, vocabulary §9). mode: same-detail (the shim sends the new and the old name), detail-adds (the old name gets the larger new detail), split (the old detail from the element's adapter, sfAliasAdapters), host-attribute (no shim).",
+    "since": "2026-10-27",
+    "remove-after": "2026-12-01",
+    "rows": [
+      {
+        "from": "aria-label",
+        "to": null,
+        "kind": "attribute",
+        "mode": "host-attribute",
+        "section": "§3.1, §4.8",
+        "note": "stays a host attribute, read for the accessible name; no shim"
+      },
+      {
+        "from": "sf-table-action-intent",
+        "to": "sf-table-apply",
+        "kind": "event",
+        "mode": "split",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 apply {action, scope, ids, revisions}; the old detail {action_id, record_ids} is made by the element's adapter (vocabulary §9: sf-table-action-intent → sf-table-apply)",
+        "summary": "Request one host-resolved row or bulk operation. Event source is the owning table instance; emission is not operation success."
+      },
+      {
+        "from": "sf-table-create-intent",
+        "to": "sf-table-create",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 create; the detail {item} is unchanged",
+        "summary": "The user pressed the create button (item null) or chose an item from its menu (item id). Intent only: the host opens its create form."
+      },
+      {
+        "from": "sf-port-output",
+        "to": "sf-table-select",
+        "kind": "event",
+        "mode": "split",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 select {ids}; the composition port's old detail {port: selection, value} is made by the element's adapter",
+        "summary": "Composition port output. The table emits port selection (record-ids.v1) once per change of its explicit selection, including clearing; a common sf-composition-scope routes it."
+      },
+      {
+        "from": "sf-table-query-intent",
+        "to": "sf-table-query",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5.1: sf-table-query-intent → sf-table-query; the detail {reason, context, sequence} is unchanged",
+        "summary": "Request a host-side query after the context input port changed. The host resolves the relation and access, then answers with applyQueryResult(sequence, rows); older sequences are ignored."
+      },
+      {
+        "from": "sf-table-retry",
+        "to": "sf-table-refresh",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 refresh (table-retry)",
+        "summary": "Request another host-side load after the error state."
+      },
+      {
+        "from": "sf-table-tree-toggle",
+        "to": "sf-table-expand",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 expand; the detail {id, expanded} is unchanged",
+        "summary": "The person opened or closed a tree row. The data view answers it; the table only says which row and whether it was open."
+      },
+      {
+        "from": "sf-table-tree-more",
+        "to": "sf-table-load-more",
+        "kind": "event",
+        "mode": "detail-adds",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 load-more; the new detail adds direction: after to {parent, cursor}",
+        "summary": "The person asked for the next page of one tree level."
+      },
+      {
+        "from": "sf-table-rows-reorder",
+        "to": "sf-table-move",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 move; the detail {ids, before, order} is unchanged",
+        "summary": "Rows were dragged into another order inside the list: the ids that moved, the row they now stand before (null: the end) and the whole order shown."
+      },
+      {
+        "from": "sf-table-column-settings-change",
+        "to": "sf-table-save",
+        "kind": "event",
+        "mode": "detail-adds",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5 save {kind: columns}; the new detail adds kind to {reason, columnSettings, tableSettingsKey}",
+        "when": {
+          "kind": "columns"
+        },
+        "summary": "Request persistence of a column preference delta after resize, reorder or visibility changes."
+      },
+      {
+        "from": "sf-table:column-settings-change",
+        "to": "sf-table-save",
+        "kind": "event",
+        "mode": "detail-adds",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "vocabulary §5.1: sf-table:column-settings-change → sf-table-save {kind: columns}; a colon name (§8)",
+        "when": {
+          "kind": "columns"
+        }
+      },
+      {
+        "from": "onColumnSettingsChange",
+        "to": "sf-table-save",
+        "kind": "event",
+        "mode": "detail-adds",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "a camelCase name outside §8 (simai/ui-pro#1); ui-admin listens to it (src/main.ts, src/smart-component-catalog.ts)",
+        "when": {
+          "kind": "columns"
+        }
+      },
+      {
+        "from": "onSearchEnd",
+        "to": "sf-table-search-change",
+        "kind": "event",
+        "mode": "split",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "a camelCase name outside §8 (simai/ui-pro#1); its detail was the search text itself, made by the element's adapter; ui-admin listens to it (src/main.ts, src/smart-component-catalog.ts)"
+      },
+      {
+        "from": "onTemplateSave",
+        "to": "sf-table-template-save",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "a camelCase name outside §8 (simai/ui-pro#1); ui-admin listens to it"
+      },
+      {
+        "from": "onFilterUpdate",
+        "to": "sf-table-filter-change",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, §16 item 20, vocabulary §9",
+        "note": "a camelCase name outside §8 (simai/ui-pro#1); ui-admin listens to it"
+      },
+      {
+        "from": "sf-table",
+        "to": "sf-view-table",
+        "kind": "tag",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "since-version": "1.14.0",
+        "section": "rename plan R2 (ui-control RENAME-PLAN-2026-11-03), naming decision 2026-11-02",
+        "note": "the element is sf-view-table; sf-table is a subclass defined beside it until the date"
+      },
+      {
+        "from": "sf-table-select",
+        "to": "sf-view-table-select",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-apply",
+        "to": "sf-view-table-apply",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-save",
+        "to": "sf-view-table-save",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-column-settings-reset",
+        "to": "sf-view-table-column-settings-reset",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-create",
+        "to": "sf-view-table-create",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-filter-change",
+        "to": "sf-view-table-filter-change",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-query",
+        "to": "sf-view-table-query",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-refresh",
+        "to": "sf-view-table-refresh",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-search-change",
+        "to": "sf-view-table-search-change",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-sort-change",
+        "to": "sf-view-table-sort-change",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-template-delete",
+        "to": "sf-view-table-template-delete",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-template-save",
+        "to": "sf-view-table-template-save",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-template-select",
+        "to": "sf-view-table-template-select",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-toolbar-action",
+        "to": "sf-view-table-toolbar-action",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-reference-open",
+        "to": "sf-view-table-reference-open",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-expand",
+        "to": "sf-view-table-expand",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-load-more",
+        "to": "sf-view-table-load-more",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-rows-drag",
+        "to": "sf-view-table-rows-drag",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-move",
+        "to": "sf-view-table-move",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-cell-set",
+        "to": "sf-view-table-cell-set",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-view-change",
+        "to": "sf-view-table-view-change",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      },
+      {
+        "from": "sf-table-window",
+        "to": "sf-view-table-window",
+        "kind": "event",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "mode": "same-detail",
+        "section": "§8",
+        "note": "the event name carries the tag"
+      }
+    ]
+  },
+  "x-summary": "Complete server-backed collection view with search, filters, table preferences, row and bulk actions, and pagination.",
+  "x-source": {
+    "package": "ui-pro",
+    "folder": "view-table",
+    "manifest": "simai/ui-pro@9cbe061 components/src/smart/table/smart.manifest.json",
+    "converted": "control/smart-architecture/stands/17-ports-migration/out/table.component.json"
+  },
+  "x-words": [
+    "filter-text",
+    "clear-text",
+    "search-placeholder",
+    "create-text",
+    "loading-text",
+    "empty-text",
+    "error-text",
+    "retry-text",
+    "pin-column-label",
+    "unpin-column-label",
+    "column-move-label",
+    "column-search-placeholder",
+    "column-search-empty-text",
+    "filter-apply-text"
+  ],
+  "x-port": {
+    "sha256": "208db0e9709639c46f25830cac255f35d7d8c50ea4dfb1c578adc0055798c46e",
+    "supports": [
+      "1.0.0"
+    ]
+  },
+  "x-renamed": [
+    "settings.aria-label: a host attribute, read by the base, never a setting (§3.1)",
+    "events.sf-port-output → port-output (the DOM name without sf-<tag>-)",
+    "events.sf-table-action → apply (vocabulary §5 apply)",
+    "events.sf-table-column-settings-change → save (vocabulary §5.1)",
+    "events.column-settings-reset: 1 carried field(s) held the element, not data (§8)",
+    "events.sf-table-column-settings-reset → column-settings-reset (the DOM name without sf-<tag>-)",
+    "events.sf-table-create → create (vocabulary §5 create)",
+    "events.sf-table-filter-change → filter-change (the DOM name without sf-<tag>-)",
+    "events.sf-table-query → query (vocabulary §5.1)",
+    "events.sf-table-retry → refresh (vocabulary §5 refresh)",
+    "events.sf-table-search-change → search-change (the DOM name without sf-<tag>-)",
+    "events.sf-table-sort-change → sort-change (the DOM name without sf-<tag>-)",
+    "events.sf-table-template-delete → template-delete (the DOM name without sf-<tag>-)",
+    "events.sf-table-template-save → template-save (the DOM name without sf-<tag>-)",
+    "events.sf-table-template-select → template-select (the DOM name without sf-<tag>-)",
+    "events.sf-table-toolbar-action → toolbar-action (the DOM name without sf-<tag>-)",
+    "events.sf-table-tree-toggle → expand (vocabulary §5 expand)",
+    "events.sf-table-tree-more → load-more (vocabulary §5 load-more)",
+    "events.sf-table-rows-drag → rows-drag (the DOM name without sf-<tag>-)",
+    "events.sf-table-rows-reorder → move (vocabulary §5 move)",
+    "events.sf-table-cell-set → cell-set (the DOM name without sf-<tag>-)",
+    "settings.filter-text: its default words move to lang/en.json runtime.filter-text (§11, §16 item 44)",
+    "settings.clear-text: its default words move to lang/en.json runtime.clear-text (§11, §16 item 44)",
+    "settings.search-placeholder: its default words move to lang/en.json runtime.search-placeholder (§11, §16 item 44)",
+    "settings.create-text: its default words move to lang/en.json runtime.create-text (§11, §16 item 44)",
+    "settings.loading-text: its default words move to lang/en.json runtime.loading-text (§11, §16 item 44)",
+    "settings.empty-text: its default words move to lang/en.json runtime.empty-text (§11, §16 item 44)",
+    "settings.error-text: its default words move to lang/en.json runtime.error-text (§11, §16 item 44)",
+    "settings.retry-text: its default words move to lang/en.json runtime.retry-text (§11, §16 item 44)",
+    "settings.pin-column-label: its default words move to lang/en.json runtime.pin-column-label (§11, §16 item 44)",
+    "settings.unpin-column-label: its default words move to lang/en.json runtime.unpin-column-label (§11, §16 item 44)",
+    "settings.column-move-label: its default words move to lang/en.json runtime.column-move-label (§11, §16 item 44)",
+    "settings.column-search-placeholder: its default words move to lang/en.json runtime.column-search-placeholder (§11, §16 item 44)",
+    "settings.column-search-empty-text: its default words move to lang/en.json runtime.column-search-empty-text (§11, §16 item 44)",
+    "settings.filter-apply-text: its default words move to lang/en.json runtime.filter-apply-text (§11, §16 item 44)"
+  ],
+  "x-decisions": {
+    "shape": "leaf, with reasons (§7, the smaller mechanism). Its toolbar, filter, column settings and row menus are controls of its own state with no rule between them, and §18.4 asks the opposite of parts for its cells: a cell that only shows a value is class markup, a Smart element only while edited. Its rows are entries (§18), not roles. Stand 24 placed a table of this interface as a leaf inside the record browser; nothing it measured needs the table to be an assembly.",
+    "version": "1.9.0 → 1.10.0, a minor while the old event names hold dated aliases (§4.10); the major when they expire on 2026-12-01.",
+    "events": "named by vocabulary 1.1.5: select {ids} (was sf-port-output {port, value}), apply {action, scope, ids, revisions} (was sf-table-action-intent {action_id, record_ids}), save {kind: columns, …} (was sf-table-column-settings-change, sf-table:column-settings-change, onColumnSettingsChange), create (was -create-intent), query (was -query-intent), refresh (was -retry), expand (was -tree-toggle), load-more (was -tree-more), move (was -rows-reorder). Each old name follows once through aliases.json, split rows through sfAliasAdapters with their old detail, and is noted in SF.deprecations when a listener reads it. The alias table's sf-table-action-intent → sf-table-apply is taken (vocabulary §9); the converter's sf-port-output → sf-table-port-output is not: the selection is the vocabulary's select.",
+    "own-verb-words": "search-change, sort-change, filter-change, template-save, template-select, template-delete, column-settings-reset, toolbar-action, reference-open, rows-drag, cell-set, view-change and window keep their DOM names and are verbs of the table alone; their words are lang events.<verb>.label.",
+    "camelCase-events": "simai/ui-pro#1: onSearchEnd, onTemplateSave, onFilterUpdate and onColumnSettingsChange are no longer sent by the table; they are dated aliases of search-change, template-save, filter-change and save (ui-admin src/main.ts and src/smart-component-catalog.ts listen to them until 2026-12-01). search-change carries {search} now (§8: detail is an object); onSearchEnd keeps the bare text through its adapter.",
+    "column-settings": "simai/ui-pro#1: getColumnSettings() merges the host's and the person's settings once per change of either and answers from the memo while drawing; the system columns and the column a box is named by are read once per list, not per row.",
+    "window": "§18.4, simai/ui-pro#2: window: true. From 300 rows (quality profile 1.3.6-1 window_from_entries) the table draws the rows in view and 20 more on each side, between two spacer rows of the rest's height; aria-rowcount and aria-rowindex keep the whole count. The range follows any scroll box and the page, and is reported as the fact window {first, last}. The arrows, Home and End move between all rows, drawing an undrawn one first. One changed row (updateRowByKey) is drawn again in place and measures no width.",
+    "cells": "§18.4: a cell that only shows a value is class markup: the row's box is the checkbox's class markup over a native input, the row menu the icon button's class markup over a native button, a value a span. A row's template is composed once per arrangement of its cells, so a drawn row holds no Lit marker per cell: 27 nodes a row where it held 108. Host components, typed values, links, trees and editable cells keep the full renderer.",
+    "item-shape": "rows is the vocabulary's items: {id, revision, <column key>…} with entries {key: id, changes: revision}; columns names key and label; sort is [{key, direction}] (vocabulary 1.1.5 §2.1), the host's echo, controlled. The other list settings (bulk-actions, create-items, filter-fields, active-filter-fields, templates, toolbar-actions, table-data, table-settings) are the properties their set-<name> helpers always wrote (x-todo setter).",
+    "settings-not-taken": "items, message, search, filters, views and saved-view of the converter's x-target are not added: the data view holds the query and the host's words, and rows already is the list. A table placed by an assembly binds rows, columns, sort and current.",
+    "carries": "a carried field is one the detail holds under that very name (SF.Assembly checks it at load and on every event, §4.10); camelCase fields beside them are named in x-detail.",
+    "state": "the data state is the setting data-state with the vocabulary's ready (populated read as its alias, gate 26); the value state is not declared, because the Smart base's public state is its render store until §16.7 renames it.",
+    "reserved-name": "sfPortInput stays the composition router's entry and is not part of this interface (§3.1: no sf names).",
+    "actions": "the actions answer outcomes and take their parameters as one object or positionally (§4.4); focus-row {id} is new. tree-column-key, a reader, is not an action. setters stay helpers.",
+    "persistence": "the person's column settings and view are kept by the host (save) and, without one, in SF.Preferences under preferences-key or table-settings-key; nothing is a persisted key of an assembly (§7.5).",
+    "key-effects": "the host: Tab reaches the table, Escape closes its open menu; a row: ArrowDown, ArrowUp, Home, End move the focus, Enter opens the record, Space marks the row.",
+    "a11y": "role grid named by aria-label; a windowed table keeps aria-rowcount and each row's aria-rowindex; the open row carries aria-current.",
+    "template": "templates.default names the Lit template js/templates/default.js, the migration form §5.2 allows; the first paint is the static snapshot, and the skeleton is derived from it (presentation.skeleton.late rows).",
+    "css-variables": "the six public variables the sheet already reads; per-state colours of a selected and a current row are a later look pass (§6).",
+    "examples": "examples.json from studio.fixture.json plus loading, empty, current and many; probe.json drives the window, the box, apply, the keys, the search alias, current and one changed row (gate 16, gate 17).",
+    "side-effects": "network: a filter field whose options come from an endpoint is read page by page with fetch (same origin, the field's own URL, aborted with the menu); nothing else leaves the page.",
+    "docs": "docs/docs.md, where the folder keeps it.",
+    "loader-ensure": "version 1.13.5: the windows' portal is read by the Loader as the page (SF.Loader.watch, core.runtime 1.19.0), so the lazy elements a window draws need no list by name; the window's elements, sf-resizer, sf-sortable and the row menu's sf-context-menu are asked for through SF.Loader.ensure, not ensureSmartElementLoaded or a race of whenDefined against 3 s of its own (reuse audit 2026-11-02, finding 4). Needs core.runtime >= 1.19.0: over an older Loader the calls are no-ops and the table falls back as before where it checks customElements.get.",
+    "framework-tag-renames": "version 1.13.6: the Framework elements it draws, finds and listens to are named by their new tags (Smart component naming of 2026-11-02, sf-[set]-<block>): the row and column menus are sf-menu-context (its sf-menu-context-* events), the icon buttons sf-button-icon, the typed cells and editors sf-input-color, sf-input-country, sf-input-date and sf-slider-range; a component type that names a former tag (a host's {type: 'icon-button'}) draws the element under its current tag (canonicalTag of the Smart base). The rule relations and the registry ids follow (cl-<new>, smart.<new>; the package reference pro.package.json of the pair). The former tags stay dated aliases of the Framework until 2027-01-01; public CSS variables and classes keep their names. No visible change. Needs the SIMAI Framework pair with the tag renames (core.runtime 1.21.0).",
+    "tag-rename": "version 1.14.0: the tag is sf-view-table (naming decision 2026-11-02: sf-[set]-<block>[-<variant>]; rename plan R2); the folder view-table, the id smart.view-table and the bundle cl-view-table follow it. sf-table stays a dated alias until 2027-01-01: a subclass the Smart base defines beside the new tag, listed in the package rule, in sheets as :is(sf-view-table, sf-table), its events named after the tag followed by their former names (ui-source change journal tag-sf-table-to-sf-view-table, path-smart-table-to-view-table)."
+  },
+  "x-registry": {
+    "kind": "composite",
+    "capabilities": [
+      "data-view",
+      "search",
+      "filtering",
+      "sorting",
+      "selection",
+      "preferences",
+      "pagination",
+      "responsive"
+    ],
+    "persistence": {
+      "mode": "external-host",
+      "source_of_truth": "host",
+      "network_owner": "host",
+      "revision_field": "base_revision",
+      "view_preference": {
+        "key": "sf-table/<preferences-key>",
+        "general_key": "sf-table/*",
+        "v": 1,
+        "fields": {
+          "columnSettings": {
+            "type": "object",
+            "description": "The person's column arrangement, per column key: visible (boolean), width (CSS length), order (number), pinned (start or end). Merged onto the host's column settings, so a column it does not name keeps the host's.",
+            "seed": true,
+            "written_by": [
+              "sf-view-table"
+            ],
+            "schema": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "object",
+                "properties": {
+                  "visible": {
+                    "type": "boolean"
+                  },
+                  "width": {
+                    "type": "string"
+                  },
+                  "order": {
+                    "type": "number"
+                  },
+                  "pinned": {
+                    "enum": [
+                      "start",
+                      "end",
+                      null
+                    ]
+                  }
+                }
+              }
+            }
+          },
+          "widths": {
+            "type": "object",
+            "description": "Column widths the person dragged, per column key, as \"<N>px\". Kept also without a preferences-key when the table has remember-widths (then under the table's own key).",
+            "seed": true,
+            "written_by": [
+              "sf-view-table"
+            ],
+            "schema": {
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              }
+            }
+          },
+          "view": {
+            "type": "object",
+            "description": "The table's look: density (compact, normal, spacious), stripes, lines, singleLine, stickyHead. Under sf-table/* it is the person's look for every table, read under this table's own.",
+            "seed": true,
+            "written_by": [
+              "sf-view-table"
+            ],
+            "schema": {
+              "type": "object",
+              "properties": {
+                "density": {
+                  "enum": [
+                    "compact",
+                    "normal",
+                    "spacious"
+                  ]
+                },
+                "stripes": {
+                  "type": "boolean"
+                },
+                "lines": {
+                  "type": "boolean"
+                },
+                "singleLine": {
+                  "type": "boolean"
+                },
+                "stickyHead": {
+                  "type": "boolean"
+                }
+              }
+            }
+          },
+          "sort": {
+            "type": "array",
+            "description": "The sort the person chose: [{key, direction}]. Written and read by the data view the table is in, so the first query comes in this order.",
+            "seed": true,
+            "written_by": [
+              "sf-view"
+            ],
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "key",
+                  "direction"
+                ],
+                "properties": {
+                  "key": {
+                    "type": "string"
+                  },
+                  "direction": {
+                    "enum": [
+                      "asc",
+                      "desc"
+                    ]
+                  }
+                }
+              }
+            }
+          },
+          "pageSize": {
+            "type": "integer",
+            "description": "The page size the person chose. Written and read by the data view, so the first query asks for it.",
+            "seed": true,
+            "written_by": [
+              "sf-view"
+            ]
+          }
+        }
+      }
+    },
+    "adapter": {
+      "kind": "owner",
+      "protocol": "simai.smart-studio-adapter.v1",
+      "module": null
+    },
+    "readiness": {
+      "level": "host-required",
+      "required_checks": [
+        "manifest",
+        "fixture",
+        "runtime-upgrade",
+        "scenario-smoke",
+        "host-query-bridge"
+      ]
+    },
+    "tags": [
+      "admin",
+      "collection",
+      "data",
+      "filter",
+      "table"
+    ],
+    "composition-declarative": {
+      "standard": "simai.composition.document.v1",
+      "type": "smart.view-table",
+      "mode": "leaf",
+      "profiles": [
+        "ui-layout"
+      ],
+      "props": [
+        "aria-label",
+        "table-settings-key",
+        "selectable",
+        "toolbar",
+        "settings",
+        "actions",
+        "row-actions",
+        "pagin",
+        "pagination-total",
+        "pagination-page-size",
+        "page-sizes",
+        "filter-text",
+        "clear-text",
+        "search-placeholder",
+        "create-text",
+        "loading-text",
+        "empty-text",
+        "empty-description",
+        "error-text",
+        "retry-text",
+        "context-menu-columns",
+        "data-state"
+      ],
+      "data": {
+        "columns": {
+          "contract": "columns"
+        },
+        "rows": {
+          "contract": "rows"
+        }
+      },
+      "events": [
+        "sf-view-table-search-change",
+        "sf-view-table-filter-change",
+        "sf-view-table-sort-change",
+        "sf-table-create-intent",
+        "sf-view-table-template-save",
+        "sf-view-table-template-select",
+        "sf-view-table-template-delete",
+        "sf-table-column-settings-change",
+        "sf-table-action-intent",
+        "sf-table-query-intent",
+        "sf-table-retry",
+        "sf-view-table-toolbar-action"
+      ],
+      "persistence": {
+        "settings_key_prop": "table-settings-key",
+        "revision_prop": null
+      },
+      "presentation": {
+        "views": [
+          "default"
+        ],
+        "presets": [],
+        "modifiers": []
+      },
+      "slots": {},
+      "renderer": {
+        "kind": "custom-element",
+        "name": "sf-view-table"
+      },
+      "assets": [
+        "smart/view-table"
+      ],
+      "host_port": {
+        "port": "simai.dataview-port",
+        "version": "1.0.0",
+        "path": "src/core/contracts/ports/simai.dataview-port/1.0.0/port.json",
+        "sha256": "208db0e9709639c46f25830cac255f35d7d8c50ea4dfb1c578adc0055798c46e",
+        "supported_versions": [
+          "1.0.0"
+        ]
+      }
+    },
+    "item_contract": {
+      "stable_id_attribute": "row.id",
+      "package_owned": [
+        "columns[].key",
+        "columns[].label",
+        "filter_fields[].key",
+        "filter_fields[].operators",
+        "actions[].id"
+      ],
+      "preference_fields": [
+        "column_settings.*.order",
+        "column_settings.*.width",
+        "column_settings.*.visible",
+        "column_settings.*.pinned",
+        "query.page_size"
+      ],
+      "supports": [
+        "structured-cells",
+        "row-selection",
+        "bulk-selection",
+        "column-resize",
+        "column-reorder",
+        "column-visibility",
+        "filter-templates",
+        "row-actions"
+      ]
+    },
+    "contracts": {
+      "query_intent": {
+        "type": "object",
+        "required": [
+          "search",
+          "filters",
+          "sort",
+          "page",
+          "page_size"
+        ],
+        "properties": {
+          "search": {
+            "type": "string"
+          },
+          "filters": {
+            "type": "object"
+          },
+          "sort": {
+            "type": "array"
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "page_size": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100
+          }
+        },
+        "additionalProperties": false
+      },
+      "column_settings": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "object",
+          "properties": {
+            "order": {
+              "type": "number"
+            },
+            "width": {
+              "type": "string"
+            },
+            "visible": {
+              "type": "boolean"
+            },
+            "pinned": {
+              "type": "boolean"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "action_intent": {
+        "type": "object",
+        "required": [
+          "action_id",
+          "record_ids"
+        ],
+        "properties": {
+          "action_id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "record_ids": {
+            "type": "array",
+            "items": {
+              "type": [
+                "string",
+                "integer"
+              ],
+              "minLength": 1
+            },
+            "minItems": 1
+          }
+        },
+        "additionalProperties": false
+      },
+      "query_context": {
+        "type": "object",
+        "required": [
+          "record_ids"
+        ],
+        "properties": {
+          "record_ids": {
+            "type": "array",
+            "maxItems": 1000,
+            "uniqueItems": true,
+            "items": {
+              "type": [
+                "string",
+                "integer"
+              ],
+              "minLength": 1,
+              "maxLength": 256
+            }
+          }
+        },
+        "additionalProperties": false
+      },
+      "composition_ports": {
+        "manifest": "simai.composition.port-manifest.v1",
+        "element": "sf-view-table",
+        "version": "1.0.0",
+        "outputs": {
+          "selection": "record-ids.v1"
+        },
+        "inputs": {
+          "context": "record-ids.v1"
+        }
+      },
+      "columns": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "key"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "key": {
+              "type": "string",
+              "minLength": 1
+            },
+            "label": {
+              "type": "string"
+            },
+            "visible": {
+              "type": "boolean"
+            },
+            "order": {
+              "type": [
+                "number",
+                "string",
+                "null"
+              ]
+            },
+            "width": {
+              "type": [
+                "string",
+                "number",
+                "null"
+              ]
+            },
+            "colWidth": {
+              "type": [
+                "string",
+                "number",
+                "null"
+              ]
+            },
+            "size": {
+              "type": [
+                "string",
+                "number",
+                "null"
+              ]
+            },
+            "minWidth": {
+              "type": [
+                "string",
+                "number",
+                "null"
+              ]
+            },
+            "maxWidth": {
+              "type": [
+                "string",
+                "number",
+                "null"
+              ]
+            },
+            "sortable": {
+              "type": "boolean"
+            },
+            "resizable": {
+              "type": "boolean"
+            },
+            "draggable": {
+              "type": "boolean"
+            },
+            "renderer": {
+              "enum": [
+                "link"
+              ]
+            },
+            "system": {
+              "type": "boolean"
+            },
+            "component": {
+              "type": "object"
+            },
+            "rowComponent": {
+              "type": "object"
+            }
+          }
+        }
+      },
+      "rows": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": [
+            "id"
+          ],
+          "properties": {
+            "id": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            }
+          },
+          "additionalProperties": true
+        }
+      }
+    },
+    "state": {
+      "machines": {
+        "data": [
+          "idle",
+          "loading",
+          "populated",
+          "empty",
+          "error"
+        ],
+        "query": [
+          "clean",
+          "searching",
+          "filtered",
+          "sorting",
+          "paging"
+        ],
+        "preferences": [
+          "idle",
+          "editing",
+          "saving",
+          "success",
+          "error",
+          "conflict"
+        ]
+      },
+      "visual_states": [
+        "default",
+        "loading",
+        "empty",
+        "error",
+        "selected",
+        "active",
+        "open"
+      ]
+    },
+    "backend": {
+      "adapters": [
+        "larena:ui.dataview"
+      ],
+      "integration_examples": {
+        "larena_php": "Smart::renderView('dataview.table', ['props' => ['title' => $title], 'children' => $resolvedChildren]);",
+        "event_bridge": "Normalize SF runtime events to Data View intents, validate them in larena/dataview, then return a fresh access-filtered projection."
+      }
+    },
+    "ownership": {
+      "source": "simai/ui-admin",
+      "data": "host",
+      "effects": "host",
+      "forbidden_client_responsibilities": [
+        "query authorization",
+        "field/operator invention",
+        "record access decisions",
+        "domain mutations",
+        "cross-user preference selection",
+        "HTTP endpoint invention"
+      ]
+    },
+    "security": {
+      "permissions_owner": "host",
+      "untrusted_inputs": [
+        "Reject unknown columns, filters, sorts and action IDs",
+        "Treat every row and structured cell as untrusted render data",
+        "Never accept record ownership or access flags from the browser"
+      ],
+      "network_policy": "host-only"
+    },
+    "presentation": {
+      "skeleton": {
+        "shape": "rows",
+        "while_loading": "template"
+      },
+      "themes": [
+        "light",
+        "dark"
+      ],
+      "locales": [
+        "en",
+        "ru"
+      ],
+      "responsive": [
+        "desktop-wide",
+        "desktop-local-scroll",
+        "mobile-stacked-toolbar",
+        "mobile-horizontal-table-scroll",
+        "viewport-bounded-overlays"
+      ]
+    },
+    "ai_guidance": {
+      "use_when": "Use the whole Data View for an admin collection that needs server search, filters, table preferences, actions or pagination.",
+      "do_not": [
+        "Do not rebuild the toolbar, table and pagination from unrelated primitives",
+        "Do not let the browser own query or access semantics",
+        "Do not send arbitrary field, operator, route or action identifiers to the backend"
+      ],
+      "required_reads": [
+        "contracts",
+        "events",
+        "persistence",
+        "ownership",
+        "backend",
+        "scenarios"
+      ],
+      "minimal_example": "<sf-view-table aria-label=\"Записи\" table-settings-key=\"package.records\"></sf-view-table>",
+      "owner_commands": [
+        "node scripts/test.mjs",
+        "node scripts/run-browser-probes.mjs <free output> <package output>"
+      ]
+    },
+    "accessibility": {
+      "accessible_name": "required",
+      "keyboard": [
+        "Tab",
+        "Shift+Tab",
+        "Enter",
+        "Space",
+        "Escape",
+        "Arrow keys",
+        "ArrowLeft and ArrowRight resize a focused resizable column"
+      ],
+      "focus": "Every icon-only action and contextual surface has an accessible name. Per-instance overlays stay inside the visual viewport, close on Escape and restore focus to their trigger. Column resize keeps focus on its native button."
+    },
+    "compatibility": {
+      "aliases": [
+        "smart.table"
+      ],
+      "migrations": [
+        {
+          "from": "1.0.0",
+          "to": "1.1.0",
+          "changes": [
+            "Add sf-table-action-intent and requestActionIntent for row, context and bulk operations.",
+            "Replace the placeholder View modal with a host-resolved intent; preserve explicit trusted callback overrides.",
+            "Selection preserves complete typed IDs; bulk controls use the current-result selection only."
+          ]
+        },
+        {
+          "from": "1.1.0",
+          "to": "1.2.0",
+          "changes": [
+            "Publish Composition ports: output selection and input context, both record-ids.v1.",
+            "Add sf-table-query-intent, applyQueryResult (latest result wins), getQueryContext and clearSelection.",
+            "Emit sf-port-output once per explicit selection change; no endpoint, action or query text is emitted.",
+            "After remount, a table whose context query was left unanswered requests the same context once with a new sequence."
+          ]
+        },
+        {
+          "from": "1.2.0",
+          "to": "1.3.0",
+          "changes": [
+            "Add sf-table-create-intent: the create button emits {item: null}; setCreateItems adds an arrow menu whose items emit {item: id}. Without items the arrow is not rendered.",
+            "Add sf-table-template-select {key} when Apply on the Templates tab changes the selected template; sf-table-template-save is unchanged.",
+            "Columns with sortable: true render a header button with aria-sort and emit sf-table-sort-change {key, direction}; setSort and getSort mirror the host's sort. Rows are never reordered by the table.",
+            "Filter fields with filter.optionRenderer 'badge' render options as tonal sf-badge labels coloured by option.color (a badge scheme or a hex colour) with optional option.icon.",
+            "The actions column is a system column: not resizable or draggable and no longer frozen into column settings.",
+            "Fix: dropping a dragged column no longer duplicates header and body cells; ending a column drag or pointer resize does not sort.",
+            "Context menus are anchored to their opener with SF.Position: they flip and shift at the viewport edge and follow the opener on scroll; the filter chip menu opens under the chip instead of the viewport corner."
+          ]
+        },
+        {
+          "from": "1.3.0",
+          "to": "1.4.0",
+          "changes": [
+            "Filter chips are keyboard operable: each chip label is a button (sf-tag interactive) beside its remove action; Enter or Space opens the chip menu, anchored to the chip, and Escape returns focus to the chip.",
+            "The built-in record modal ignores modal:after-close events of nested modals now that modal events bubble."
+          ]
+        },
+        {
+          "from": "1.4.0",
+          "to": "1.5.0",
+          "changes": [
+            "The manifest moves to smart-component-manifest v2: persistence, ownership, security, accessibility and state use the v2 shape, and adapter, artifacts and readiness are declared.",
+            "The five conformance scenarios left the manifest (v2 keeps scenarios in artifacts) and are documented in docs/smart-table-guide.md; studio.fixture.json and studio.scenario.json are the declared artifacts.",
+            "No runtime behaviour changes."
+          ]
+        },
+        {
+          "from": "1.5.0",
+          "to": "1.6.0",
+          "changes": [
+            "Add sf-table-template-delete {key}: deleting a saved template on the Templates tab is its own intent, one event per template; sf-table-template-save keeps reporting the other flags.",
+            "Instance isolation: the column resize handles carry per-instance ids (<instance>--column-resizer--<column>), the portal records data-sf-instance, and a table without table-settings-key and without an id falls back to its own instance id instead of the shared key \"users\".",
+            "The region declares its resolved data state: data-state and aria-busy are set on the sf-view-table region, not only on tbody."
+          ]
+        },
+        {
+          "from": "1.6.0",
+          "to": "1.7.0",
+          "changes": [
+            "Declare the data view as a composition type (smart.view-table): the projection now carries the intents it raises, the data it accepts and where its settings key lives, instead of dropping them.",
+            "Add the columns and rows contracts: closed column descriptions and rows with a stable id. They are the data half of the type and the base of the future host port.",
+            "No runtime behaviour changes."
+          ]
+        },
+        {
+          "from": "1.7.0",
+          "to": "1.8.0",
+          "changes": [
+            "Add responsive priority/min_width/sticky projection for declared columns; existing columns keep their previous order and scroll behavior.",
+            "Add toolbar=false for a parent composite that supplies a toolbar slot."
+          ]
+        },
+        {
+          "from": "1.8.0",
+          "to": "1.9.0",
+          "changes": [
+            "Add row-actions: row-actions=\"false\" hides the row action column while actions keeps the create button, for hosts whose row menu is the only entry to a row's actions."
+          ]
+        },
+        {
+          "from": "1.9.0",
+          "to": "1.9.1",
+          "changes": [
+            "Follows SIMAI Framework release ui-92b4661762ca (standard 1.3.8 display groups A and B): the Loader relations and the composition name the renamed bundles and registry ids (cl-button, cl-icon-button, cl-input, cl-tag, cl-badge; smart.button, smart.icon-button, smart.input, smart.tag, smart.badge).",
+            "The empty brick takes heading and the filter's avatars heading, the names sf-empty-state and sf-avatar read since 1.3.8. No public attribute, property or event of sf-view-table changes."
+          ]
+        },
+        {
+          "from": "1.9.1",
+          "to": "1.10.0",
+          "changes": [
+            "From component.json (standard simai.smart-component 1.3.8): events by the vocabulary's verbs -- sf-table-apply, -select, -save, -create, -query, -refresh, -expand, -load-more, -move -- with the old names as dated aliases until 2026-12-01 (aliases.json); onSearchEnd, onTemplateSave, onFilterUpdate, onColumnSettingsChange and sf-table:column-settings-change follow once each, noted in SF.deprecations.",
+            "Many entries (§18.4, simai/ui-pro#2): from 300 rows only the rows in view and a margin are drawn, reported as sf-table-window {first, last}; a plain cell is class markup; one changed row is redrawn in place.",
+            "The data state ready, populated its alias; current marks the open row (aria-current); actions answer outcomes."
+          ]
+        },
+        {
+          "from": "1.13.4",
+          "to": "1.13.5",
+          "changes": [
+            "The windows' portal is watched by the Loader (SF.Loader.watch) and lazy elements are asked for through SF.Loader.ensure; needs core.runtime >= 1.19.0. Nothing to change for a host on a pair from core.runtime 1.19.0 on."
+          ]
+        },
+        {
+          "from": "1.13.5",
+          "to": "1.13.6",
+          "changes": [
+            "Draws and finds the renamed Framework elements by their new tags (the row and column menus are sf-menu-context (its sf-menu-context-* events), the icon buttons sf-button-icon, the typed cells and editors sf-input-color, sf-input-country, sf-input-date and sf-slider-range; a component type that names a former tag (a host's {type: 'icon-button'}) draws the element under its current tag (canonicalTag of the Smart base)); the rule relations name cl-<new>. Needs the SIMAI Framework pair with the tag renames (core.runtime 1.21.0). No visible change. Nothing to change for a host on that pair; a host that writes the former tags keeps working until 2027-01-01."
+          ]
+        },
+        {
+          "from": "1.13.6",
+          "to": "1.14.0",
+          "changes": [
+            "The tag is sf-view-table (rename plan R2, naming decision 2026-11-02: sf-[set]-<block>); the folder view-table, the id smart.view-table and the bundle cl-view-table follow it (were table, smart.data-view, cl-table). sf-table stays a dated alias until 2027-01-01: old markup upgrades as this element, the Loader forwards cl-table, and every event fires under its former name as well, with the same detail. Public CSS variables and classes keep their names. Needs the SIMAI Framework pair whose package reference lists the former tag (core.runtime 1.22.0). Nothing to change for a host until 2027-01-01; new markup writes sf-view-table."
+          ]
+        }
+      ]
+    },
+    "alias-events": {
+      "sf-port-output": {
+        "summary": "Composition port output. The table emits port selection (record-ids.v1) once per change of its explicit selection, including clearing; a common sf-composition-scope routes it.",
+        "payload": {
+          "type": "object",
+          "required": [
+            "port",
+            "value"
+          ],
+          "properties": {
+            "port": {
+              "const": "selection"
+            },
+            "value": {
+              "type": "array",
+              "maxItems": 1000,
+              "uniqueItems": true,
+              "items": {
+                "type": [
+                  "string",
+                  "integer"
+                ],
+                "minLength": 1,
+                "maxLength": 256
+              }
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "sf-table-action-intent": {
+        "summary": "Request one host-resolved row or bulk operation. Event source is the owning table instance; emission is not operation success.",
+        "payload": {
+          "type": "object",
+          "required": [
+            "action_id",
+            "record_ids"
+          ],
+          "properties": {
+            "action_id": {
+              "type": "string",
+              "minLength": 1
+            },
+            "record_ids": {
+              "type": "array",
+              "items": {
+                "type": [
+                  "string",
+                  "integer"
+                ],
+                "minLength": 1
+              },
+              "minItems": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "sf-table-column-settings-change": {
+        "summary": "Request persistence of a column preference delta after resize, reorder or visibility changes.",
+        "payload": {
+          "type": "object",
+          "required": [
+            "reason",
+            "tableSettingsKey",
+            "columnSettings"
+          ],
+          "properties": {
+            "reason": {
+              "type": "string"
+            },
+            "tableSettingsKey": {
+              "type": "string"
+            },
+            "columnSettings": {
+              "$ref": "#/contracts/column_settings"
+            }
+          }
+        }
+      },
+      "sf-table-create-intent": {
+        "summary": "The user pressed the create button (item null) or chose an item from its menu (item id). Intent only: the host opens its create form.",
+        "payload": {
+          "type": "object",
+          "required": [
+            "item"
+          ],
+          "properties": {
+            "item": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "sf-table-query-intent": {
+        "summary": "Request a host-side query after the context input port changed. The host resolves the relation and access, then answers with applyQueryResult(sequence, rows); older sequences are ignored.",
+        "payload": {
+          "type": "object",
+          "required": [
+            "reason",
+            "context",
+            "sequence"
+          ],
+          "properties": {
+            "reason": {
+              "const": "context"
+            },
+            "context": {
+              "$ref": "#/contracts/query_context"
+            },
+            "sequence": {
+              "type": "integer",
+              "minimum": 1
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "sf-table-retry": {
+        "summary": "Request another host-side load after the error state.",
+        "payload": {
+          "type": "null"
+        }
+      },
+      "sf-table-tree-toggle": {
+        "summary": "The person opened or closed a tree row. The data view answers it; the table only says which row and whether it was open.",
+        "payload": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "id": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            },
+            "expanded": {
+              "type": "boolean"
+            }
+          }
+        }
+      },
+      "sf-table-tree-more": {
+        "summary": "The person asked for the next page of one tree level.",
+        "payload": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "parent": {
+              "type": [
+                "string",
+                "integer",
+                "null"
+              ]
+            },
+            "cursor": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          }
+        }
+      },
+      "sf-table-rows-reorder": {
+        "summary": "Rows were dragged into another order inside the list: the ids that moved, the row they now stand before (null: the end) and the whole order shown.",
+        "payload": {
+          "type": "object",
+          "properties": {
+            "ids": {
+              "type": "array"
+            },
+            "before": {},
+            "order": {
+              "type": "array"
+            }
+          }
+        }
+      }
+    },
+    "methods": {
+      "getActiveFilterFieldKeys": {
+        "summary": "Which filter fields the filter is showing, in the host's field order.",
+        "arguments": [],
+        "returns": {
+          "type": "array"
+        }
+      },
+      "getColumnSettings": {
+        "summary": "Read the current column-preference delta.",
+        "arguments": [],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "getFilterPayload": {
+        "summary": "Read the current filter draft for host-side query validation.",
+        "arguments": [],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "getInstanceId": {
+        "summary": "Identity of this instance: the author's id when there is one, an own counter otherwise. Ids, the settings key fallback and the portal derive from it.",
+        "arguments": [],
+        "returns": {
+          "type": "string"
+        }
+      },
+      "getQueryContext": {
+        "summary": "Read the immutable context last received through the context input port, or null.",
+        "arguments": [],
+        "returns": {
+          "type": [
+            "object",
+            "null"
+          ]
+        }
+      },
+      "getSelectedRecordIds": {
+        "summary": "Read the typed record identities selected in this table result, without DOM parsing.",
+        "arguments": [],
+        "returns": {
+          "type": "array",
+          "items": {
+            "type": [
+              "string",
+              "integer"
+            ]
+          }
+        }
+      },
+      "getSort": {
+        "summary": "Read the sort shown on the headers.",
+        "arguments": [],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "getToolbarActions": {
+        "summary": "The toolbar actions as declared, copied.",
+        "arguments": [],
+        "returns": {
+          "type": "array"
+        }
+      },
+      "requestContextQuery": {
+        "summary": "Internal to the context port: emit sf-table-query-intent for the current context with a new pending sequence.",
+        "arguments": [
+          {
+            "name": "sequence",
+            "schema": {
+              "type": "integer",
+              "minimum": 1
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setActiveFilterFields": {
+        "summary": "Show exactly these filter fields in the selected filter template. Used when a saved view is opened: settings.filter_fields names the fields it was showing.",
+        "arguments": [
+          {
+            "name": "keys",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setBulkActions": {
+        "summary": "Register labeled opaque actions for the current selection. Empty selection disables their controls.",
+        "arguments": [
+          {
+            "name": "actions",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "id",
+                  "name"
+                ],
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "name": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setColumns": {
+        "summary": "Replace canonical backend-provided columns.",
+        "arguments": [
+          {
+            "name": "columns",
+            "schema": {
+              "type": "array"
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setCreateItems": {
+        "summary": "Set the create split-button menu items ({id, name} only). Without items the create button has no arrow.",
+        "arguments": [
+          {
+            "name": "items",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "id",
+                  "name"
+                ],
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "minLength": 1
+                  },
+                  "name": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "additionalProperties": false
+              }
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setDataState": {
+        "summary": "Switch between automatic, loading, populated, empty and error presentation states.",
+        "arguments": [
+          {
+            "name": "state",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "auto",
+                "loading",
+                "populated",
+                "empty",
+                "error"
+              ]
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setFilterFields": {
+        "summary": "Register backend-allowlisted filter fields and controls.",
+        "arguments": [
+          {
+            "name": "fields",
+            "schema": {
+              "type": "array"
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setRows": {
+        "summary": "Replace the current backend result rows.",
+        "arguments": [
+          {
+            "name": "rows",
+            "schema": {
+              "type": "array"
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setTableData": {
+        "summary": "Patch columns, rows or related table state supplied by the host.",
+        "arguments": [
+          {
+            "name": "patch",
+            "schema": {
+              "type": "object"
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setTableSettings": {
+        "summary": "Apply a column-preference delta without emitting a save request.",
+        "arguments": [
+          {
+            "name": "settings",
+            "schema": {
+              "type": "object"
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setTemplates": {
+        "summary": "Apply saved filter/view templates.",
+        "arguments": [
+          {
+            "name": "templates",
+            "schema": {
+              "type": "array"
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "setToolbarActions": {
+        "summary": "Declare the view's own actions for the toolbar menu: {id, label, icon?, href?}. An href must name this same site. Without actions the control is not rendered.",
+        "arguments": [
+          {
+            "name": "items",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "object"
+              }
+            }
+          }
+        ],
+        "returns": {
+          "type": "object"
+        }
+      },
+      "sfPortInput": {
+        "summary": "Composition input port entry used by sf-composition-scope. Accepts only the declared context port with record-ids.v1; invalid ports or values throw TypeError before any state change.",
+        "arguments": [
+          {
+            "name": "port",
+            "schema": {
+              "const": "context"
+            }
+          },
+          {
+            "name": "value",
+            "schema": {
+              "type": "array",
+              "maxItems": 1000,
+              "uniqueItems": true,
+              "items": {
+                "type": [
+                  "string",
+                  "integer"
+                ],
+                "minLength": 1,
+                "maxLength": 256
+              }
+            }
+          },
+          {
+            "name": "meta",
+            "schema": {
+              "type": "object"
+            }
+          }
+        ],
+        "returns": {
+          "type": "null"
+        }
+      },
+      "isTree": {
+        "summary": "Whether the rows are a tree: some row carries __tree, written by the data view from the host's levels.",
+        "arguments": [],
+        "returns": {
+          "type": "boolean"
+        }
+      },
+      "treeColumnKey": {
+        "summary": "The column a tree hangs from: the title column, or the first data column.",
+        "arguments": [
+          {
+            "name": "columns",
+            "type": "array",
+            "required": false
+          }
+        ],
+        "returns": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      }
+    },
+    "inputs": {
+      "template": {
+        "const": "default"
+      },
+      "aria-label": {
+        "minLength": 1,
+        "default": "Data table",
+        "description": "The table's accessible name. Read it from the props context and never from the element: `aria-label` is reflected by the platform, so element.ariaLabel returns null with no attribute set and shadows what the component resolves. Whether an English default belongs in a family whose other fourteen text inputs default to Russian is the owner's open question about the Framework's default language."
+      },
+      "table-settings-key": {
+        "minLength": 1
+      }
+    },
+    "inputs-required": [
+      "aria-label",
+      "table-settings-key"
+    ],
+    "event-fields": {
+      "sf-table-template-save": {
+        "payload": {
+          "type": [
+            "object",
+            "array"
+          ]
+        }
+      }
+    }
+  }
+}