@simai-studio/view 0.0.0-stage → 1.1.0

package/dist/smart/view/component.json

@@ -0,0 +1,1628 @@
+{
+  "$comment": "sf-data-view from its component.json (standard simai.smart-component 1.3.8, vocabulary 1.1.5), migrated from ui-control control/smart-architecture/migration/out/data-view; every x-todo decided in x-decisions.",
+  "id": "smart.view",
+  "tag": "sf-view",
+  "version": "1.8.1",
+  "kind": "leaf",
+  "family": "table",
+  "settings": {
+    "chrome": {
+      "type": "string",
+      "default": "toolbar pagination select settings",
+      "summary": "Which chrome this list renders, as a space-separated list. `toolbar` and `pagination` are this element own parts; `select` and `settings` are the table two chrome columns, named here because they are furniture of the same kind -- a checkbox column exists to feed a bulk band and a gear column exists to reach column settings, and an embedded list has neither. Empty renders none of them, for a list inside something that already carries a heading. Named explicitly rather than inferred from the toolbar, so a consumer who wants a selection in an embedded list can ask for it alone. `status` is not in the list and cannot be switched off: a list that could not say a load failed would look empty when it is broken."
+    },
+    "row-cap": {
+      "type": "number",
+      "default": 0,
+      "summary": "How many rows an embedded list draws at most, with a show-all action under it when it is hiding some. Zero is no cap, which is what a page list is. Named apart from `page-size`, which is the host paging, because a cap is what this element shows of a page it already has.",
+      "integer": true,
+      "min": 0
+    },
+    "expected-columns": {
+      "type": "number",
+      "default": 4,
+      "summary": "How many columns the skeleton draws before the host first answers: the skeleton's shape, never a limit -- the answer brings its own columns. The page or server that renders a collection knows them; with the right number the list does not move when the data arrives.",
+      "integer": true,
+      "min": 1
+    },
+    "port-owner": {
+      "type": "string",
+      "default": "",
+      "summary": "Which composite this list is embedded in, sent with the host-port request so a host knows which exchange it is answering. Names the composite rather than the element, so a list embedded somewhere else later needs no new value."
+    },
+    "port-record": {
+      "type": "string",
+      "default": "",
+      "summary": "The record the embedding composite is showing, sent with the host-port request."
+    },
+    "port-group": {
+      "type": "string",
+      "default": "",
+      "summary": "The group inside that composite this list stands in, sent with the host-port request."
+    },
+    "size": {
+      "type": "enum",
+      "values": [
+        "1/2",
+        "1"
+      ],
+      "default": "1",
+      "summary": "The step of the size ladder the view's controls take, handed to its table, its page row and its selection band: 1, or the dense 1/2 of an admin."
+    },
+    "column-search-placeholder": {
+      "type": "string",
+      "summary": "Passed on as column-search-placeholder to the table the view draws; absent, the table's own word for the page language applies."
+    },
+    "column-search-empty-text": {
+      "type": "string",
+      "summary": "Passed on as column-search-empty-text to the table the view draws; absent, the table's own word for the page language applies."
+    },
+    "column-move-label": {
+      "type": "string",
+      "summary": "Passed on as column-move-label to the table the view draws; absent, the table's own word for the page language applies."
+    },
+    "filter-apply-text": {
+      "type": "string",
+      "summary": "Passed on as filter-apply-text to the table the view draws; absent, the table's own word for the page language applies."
+    },
+    "show-more-text": {
+      "type": "string",
+      "summary": "Passed on as show-more-text to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "selected-label": {
+      "type": "string",
+      "summary": "Passed on as selected-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "total-label": {
+      "type": "string",
+      "summary": "Passed on as total-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "pages-label": {
+      "type": "string",
+      "summary": "Passed on as pages-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "first-label": {
+      "type": "string",
+      "summary": "Passed on as first-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "previous-label": {
+      "type": "string",
+      "summary": "Passed on as previous-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "page-label": {
+      "type": "string",
+      "summary": "Passed on as page-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "next-label": {
+      "type": "string",
+      "summary": "Passed on as next-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "last-label": {
+      "type": "string",
+      "summary": "Passed on as last-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "page-field-label": {
+      "type": "string",
+      "summary": "Passed on as page-field-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "action-choose-label": {
+      "type": "string",
+      "summary": "Passed on as action-choose-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "actions-label": {
+      "type": "string",
+      "summary": "Passed on as actions-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "actions-region-label": {
+      "type": "string",
+      "summary": "Passed on as actions-region-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "clear-selection-label": {
+      "type": "string",
+      "summary": "Passed on as clear-selection-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "page-size-label": {
+      "type": "string",
+      "summary": "Passed on as page-size-label to the pagination the view draws; absent, the pagination's own word for the page language applies."
+    },
+    "pagination-aria-label": {
+      "type": "string",
+      "summary": "Passed on as aria-label to the pagination the view draws (the view's own aria-label names the view)."
+    },
+    "preferences-key": {
+      "type": "string",
+      "default": "",
+      "summary": "The key the person's view of this list is kept under (SF.Preferences, sf-table/<key>): the table's arrangement, the sort and the page size, applied before the first paint and the first query. Usually the collection."
+    },
+    "accept-files": {
+      "type": "boolean",
+      "default": false,
+      "summary": "Files dropped from the computer on the view are the host's to upload: a drop zone shows while they are over it, and sf-data-view-files-drop {files} says they were dropped."
+    },
+    "collection": {
+      "type": "string",
+      "default": "",
+      "x-shape": "the host's collection id; the view's preference key falls back to it",
+      "summary": "The host's collection id; the view's preference key falls back to it (component.json settings.collection)."
+    },
+    "current": {
+      "type": "string",
+      "default": "",
+      "x-shape": "the id of the record the page has open; its row carries aria-current",
+      "summary": "The id of the record the page has open: its row carries aria-current. Writing it sends nothing (component.json settings.current)."
+    },
+    "bulk-actions": {
+      "type": "list",
+      "of": {
+        "id": "string",
+        "label": "string"
+      },
+      "x-shape": "the actions offered for the marked rows; an assembly gives the ids, their words are its language file's roles.<role>.items.<id> (§11.3); a page may write them on its page row instead"
+    },
+    "first-answer": {
+      "type": "object",
+      "optional": true,
+      "x-shape": "the host's first answer printed with the page, the applied data of query.change: records (each with its revision), total or has_next, echo, columns; optionally capabilities (the port's, known before the port) and query (the query it answers, which the revalidation asks). A server that already has the first page prints it in the view's data-sf-settings island; the view draws it at once, as if the host had answered, and the port answers the same query in the background without a loading state. Taken once"
+    }
+  },
+  "values": {
+    "state": {
+      "type": "state",
+      "summary": "the list's data state (vocabulary §3): ready, empty, error, refused, unavailable, loading"
+    },
+    "total": {
+      "type": "number",
+      "nullable": true,
+      "summary": "the host's total; null while not counted"
+    },
+    "selected": {
+      "type": "id",
+      "optional": true,
+      "summary": "the open record's id"
+    },
+    "selection": {
+      "type": "list",
+      "summary": "the marked rows' ids"
+    }
+  },
+  "events": {
+    "open": {
+      "carries": {
+        "id": "id"
+      },
+      "cancelable": true,
+      "summary": "A row's view action asks to open its record, vocabulary §5 open {id}: a cancelable request; the host's record.open follows unless a listener refused it."
+    },
+    "deleted": {
+      "carries": {
+        "ids": "list"
+      },
+      "summary": "The fact after an applied delete, vocabulary §4: {ids}."
+    },
+    "answer": {
+      "carries": {
+        "intent": {
+          "type": "string",
+          "summary": "The port intent answered, e.g. query.change, view.save, settings.save_personal, record.mutate."
+        },
+        "answer": {
+          "type": "enum",
+          "values": [
+            "applied",
+            "conflict",
+            "refused",
+            "unavailable"
+          ],
+          "summary": "The port answer.",
+          "schema": {
+            "type": "string"
+          }
+        },
+        "reason": {
+          "type": "string",
+          "optional": true,
+          "summary": "Why, when the answer is not applied: the host's reason, or the view's own (port-not-connected, capability-not-provided, action-not-allowed, no-base-revision). A refused query.change is «no access» (rows, toolbar, selection and create withdrawn) only for an access reason: none, forbidden, access_denied, scope_denied, or one ending in _access_denied or _scope_denied; any other reason (query_invalid) is a query error that keeps the toolbar and the query."
+        },
+        "message": {
+          "type": "string",
+          "optional": true,
+          "summary": "The host's own sentence for a person, as the port answer carries it. On a refused or unavailable query.change a non-empty message is what the view shows: the title of its empty or error state and the line its live region announces, drawn as text, never markup; an unavailable list with a message raises no error notice. Without one the view's own words, as before."
+        },
+        "data": {
+          "type": "object",
+          "optional": true,
+          "summary": "The host's data, copied as it answered."
+        },
+        "sequence": {
+          "type": "number",
+          "integer": true,
+          "optional": true,
+          "summary": "The query sequence the host echoed, when it did."
+        },
+        "effects": {
+          "type": "list",
+          "optional": true,
+          "summary": "Effects the host reported for the rest of the page."
+        },
+        "instance_id": {
+          "type": "string",
+          "summary": "The view's instance id, sf-data-view-<n>."
+        }
+      },
+      "own-verb": true,
+      "summary": "Fires after every port answer the view acts on, including the ones it makes itself (port not connected, capability not provided, action not allowed), so a page can watch outcomes without wrapping the port. The host's answer object is spread in full; any further fields it carries pass through."
+    },
+    "state": {
+      "carries": {
+        "state": {
+          "type": "enum",
+          "values": [
+            "loading",
+            "populated",
+            "empty",
+            "error",
+            "no-access"
+          ],
+          "summary": "The new state, also written to data-state.",
+          "schema": {
+            "type": "string"
+          }
+        },
+        "message": {
+          "type": "string",
+          "summary": "The announced status text; empty when there is none."
+        },
+        "instance_id": {
+          "type": "string",
+          "summary": "The view's instance id, sf-data-view-<n>."
+        }
+      },
+      "own-verb": true,
+      "summary": "Fires whenever the view's data state changes (loading, populated, empty, error), with the line it announces in its live region; for a page that mirrors the state elsewhere."
+    },
+    "tree": {
+      "carries": {
+        "intent": "string",
+        "payload": {
+          "type": "object",
+          "optional": true
+        }
+      },
+      "own-verb": true,
+      "summary": "The tree's port intents announced, {intent, payload}; the old sf-table-tree-intent follows once until 2026-12-01 (aliases.json)."
+    },
+    "files-drop": {
+      "carries": {
+        "files": {
+          "type": "list",
+          "summary": "The dropped File objects, at least one.",
+          "schema": {
+            "items": {
+              "type": "object"
+            },
+            "minItems": 1
+          }
+        }
+      },
+      "own-verb": true,
+      "summary": "Files from the computer were dropped on a view that has accept-files. The view uploads nothing and the files do not go through the port; the host uploads them."
+    },
+    "pagination-count": {
+      "shared": "count-on-request@1",
+      "carries": {
+        "component": {
+          "type": "object",
+          "summary": "The pagination element that asked."
+        },
+        "tagName": {
+          "type": "string",
+          "summary": "Its tag name."
+        },
+        "template": {
+          "type": "string",
+          "summary": "Its template name."
+        },
+        "reason": {
+          "type": "enum",
+          "values": [
+            "total",
+            "last-page",
+            "action-for-all"
+          ],
+          "summary": "What the number is for.",
+          "schema": {
+            "type": "string"
+          }
+        },
+        "current": {
+          "type": "number",
+          "integer": true,
+          "summary": "The current page."
+        },
+        "pageSize": {
+          "type": "number",
+          "integer": true,
+          "summary": "The page size."
+        }
+      },
+      "summary": "Raised by the view's pagination when the person asks for the total, the last page or an action under the filter while the count is unknown. The view answers it with the query.count intent; a host does not need to listen."
+    },
+    "saved-view-intent": {
+      "carries": {
+        "key": {
+          "type": "string",
+          "summary": "The saved view's key."
+        },
+        "label": {
+          "type": "string",
+          "summary": "Its name as shown."
+        },
+        "revision": {
+          "type": "string",
+          "summary": "The revision it is written against, when it exists.",
+          "schema": {
+            "type": [
+              "string",
+              "integer"
+            ]
+          },
+          "optional": true
+        },
+        "roles": {
+          "type": "object",
+          "summary": "Who may open it, as the host names roles.",
+          "optional": true
+        }
+      },
+      "summary": "An event a page raises on the view to save a shared saved view (port 1.1.0 or later): the view raises view.save_shared with the detail's key and label."
+    },
+    "table-action-intent": {
+      "shared": "table-intents@1",
+      "carries": {
+        "action_id": {
+          "type": "string",
+          "summary": "The opaque id of the row or bulk action chosen.",
+          "schema": {
+            "minLength": 1
+          }
+        },
+        "record_ids": {
+          "type": "list",
+          "summary": "The records it applies to: the row's own id, or the selected ids for a bulk action.",
+          "schema": {
+            "items": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            },
+            "minItems": 1
+          }
+        }
+      },
+      "summary": "A table event the view listens to: a row or bulk action chosen in its table. The view checks the row allows it and raises record.open (view), record.mutate (one row) or bulk.apply_selected, with the records' revisions; move and create on a tree open the move dialog or view.create_record."
+    },
+    "table-column-settings-change": {
+      "shared": "table-intents@1",
+      "carries": {
+        "reason": {
+          "type": "string",
+          "summary": "What changed: column-resize, column-resize-reset, column-drag, column-order, column-pin, column-visibility, column-settings-restore, column-settings."
+        },
+        "columnSettings": {
+          "type": "object",
+          "summary": "The whole column-preference delta after the change, keyed by column key (width, order, hidden, pinned)."
+        },
+        "tableSettingsKey": {
+          "type": "string",
+          "summary": "The table's settings key, so a host can tell several tables apart."
+        },
+        "target": {
+          "type": "enum",
+          "values": [
+            "personal",
+            "shared"
+          ],
+          "summary": "Not sent by the table. Another source may send shared to write the shared layer.",
+          "schema": {
+            "type": "string"
+          },
+          "optional": true
+        },
+        "base_revision": {
+          "type": "string",
+          "summary": "Not sent by the table. Another source may name the base revision; otherwise the view uses the layer's.",
+          "schema": {
+            "type": [
+              "string",
+              "number"
+            ]
+          },
+          "optional": true
+        }
+      },
+      "summary": "A table event the view listens to: the person resized, moved, pinned or hid a column. The view writes it to the person's layer (settings.save_personal): the table offers no choice of layer, and the table it draws sends no target. The shared layer is written from page code with saveColumnSettings(settings, {shared: true})."
+    },
+    "table-column-settings-reset": {
+      "shared": "table-intents@1",
+      "carries": {
+        "target": {
+          "type": "enum",
+          "values": [
+            "personal"
+          ],
+          "summary": "The layer to reset. The table only resets the person's own layer.",
+          "schema": {
+            "type": "string"
+          }
+        },
+        "tableSettingsKey": {
+          "type": "string",
+          "summary": "The table's settings key, or null when it has none.",
+          "schema": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
+      "summary": "A table event the view listens to: the person asked for the default columns back. The view calls resetColumnSettings, an empty personal layer written against its revision; the host supplies the defaults."
+    },
+    "table-create-intent": {
+      "shared": "table-intents@1",
+      "carries": {
+        "item": {
+          "type": "string",
+          "summary": "null for the main create button; the declared create item's id when one was chosen from its menu.",
+          "schema": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
+      "summary": "A table event the view listens to: the create button or one of its menu items was pressed. The view raises view.create_record with the detail as it came."
+    },
+    "table-query-intent": {
+      "shared": "table-intents@1",
+      "carries": {
+        "reason": {
+          "type": "enum",
+          "values": [
+            "context"
+          ],
+          "summary": "Always context: the context input port changed."
+        },
+        "context": {
+          "type": "object",
+          "summary": "The immutable context last received through the context input port."
+        },
+        "sequence": {
+          "type": "number",
+          "integer": true,
+          "summary": "The pending query's sequence; only the newest is applied.",
+          "schema": {
+            "minimum": 1
+          }
+        }
+      },
+      "summary": "A table event the view listens to: its table's context input port changed. The view ignores the table's sequence and re-reads the list with its own query.change."
+    },
+    "table-template-delete": {
+      "shared": "table-intents@1",
+      "carries": {
+        "key": {
+          "type": "string",
+          "summary": "The saved template's key.",
+          "schema": {
+            "minLength": 1
+          }
+        }
+      },
+      "summary": "A table event the view listens to: a saved template was deleted on the Templates tab, one event per template. The view raises view.delete with the key."
+    },
+    "table-template-save": {
+      "shared": "table-intents@1",
+      "carries": {},
+      "summary": "A table event the view listens to: a filter template was saved. The view turns it into saveView (view.save) with key, label, revision, level, roles, layout and settings; an array detail is saved template by template, each one its own view.save, entries without a key skipped.",
+      "x-comment": "The detail is one template object or an array of them: a carries map cannot say that, so the payload schema is x-registry/event-fields until 1.4 has a home for a detail that is not a flat object."
+    },
+    "table-template-select": {
+      "shared": "table-intents@1",
+      "carries": {
+        "key": {
+          "type": "string",
+          "summary": "The saved template's key.",
+          "schema": {
+            "minLength": 1
+          }
+        }
+      },
+      "summary": "A table event the view listens to: a different saved template was applied on the Templates tab. The view raises view.open with the key and restores the filter fields the view was saved with."
+    },
+    "host-port-request": {
+      "shared": "host-port@1",
+      "carries": {
+        "component": {
+          "type": "object",
+          "summary": "The element asking, so a host can answer it directly.",
+          "optional": true
+        },
+        "context": {
+          "type": "object",
+          "summary": "Which composite is asking and about what: owner, record, group. All null on a page list, which is asking about nothing but itself.",
+          "optional": true
+        }
+      },
+      "summary": "Asks the page for a host port, once per connection and only while this element has none. The shared convention for every component that takes `setHostPort`, so a consumer composing one inside something else does not have to find the element and call a method on it. Answered by calling `setHostPort` on the event target, at once or later."
+    },
+    "list-open": {
+      "carries": {
+        "reason": {
+          "type": "id",
+          "schema": {
+            "enum": [
+              "row-cap"
+            ]
+          }
+        },
+        "query": {
+          "type": "object"
+        }
+      },
+      "summary": "The person asked to see the whole list a row cap is showing part of. Carries the query so the host opens the full view on the same records; the component builds no address of its own."
+    },
+    "table-cell-set": {
+      "shared": "table-intents@1",
+      "carries": {
+        "id": {
+          "type": "string",
+          "summary": "The record's id.",
+          "schema": {
+            "type": [
+              "string",
+              "integer"
+            ]
+          }
+        },
+        "key": {
+          "type": "string",
+          "summary": "The column (field) key of the cell."
+        },
+        "value": {
+          "type": "id",
+          "summary": "The value the cell now asks for (a checkbox: true or false)."
+        },
+        "revision": {
+          "type": "string",
+          "summary": "The record's _revision or revision, or null.",
+          "schema": {
+            "type": [
+              "string",
+              "integer",
+              "null"
+            ]
+          }
+        }
+      },
+      "summary": "A table event the view listens to: a checkable cell was pressed. The view raises record.set of simai.dataview-port 1.11.0 (capability inline-edit) with record_id, key, value and revision, and resets the box when the answer is not applied."
+    },
+    "table-rows-reorder": {
+      "shared": "table-intents@1",
+      "carries": {
+        "ids": {
+          "type": "list",
+          "summary": "The ids of the rows that moved.",
+          "schema": {
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1
+          }
+        },
+        "before": {
+          "type": "string",
+          "summary": "The id of the row they now stand before; null for the end of the list.",
+          "schema": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "order": {
+          "type": "list",
+          "summary": "Every row id shown, in the new order.",
+          "schema": {
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "summary": "A table event the view listens to: rows were dragged into another order. The view shows the new order at once and raises record.reorder of simai.dataview-port 1.11.0 (capability row-reorder); a refusal or conflict puts the old order back."
+    }
+  },
+  "actions": {
+    "refresh": {
+      "with": {
+        "reason": {
+          "type": "string",
+          "optional": true
+        }
+      },
+      "summary": "Request current query with a new sequence.",
+      "x-returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "change-query": {
+      "with": {
+        "patch": "object",
+        "reason": {
+          "type": "string",
+          "optional": true
+        }
+      },
+      "concurrency": "latest",
+      "summary": "Change search, filters, sort or window.",
+      "x-returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "open-view": {
+      "with": {
+        "key": "string"
+      },
+      "summary": "Open a saved view.",
+      "x-returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "save-view": {
+      "with": {
+        "view": {
+          "type": "object",
+          "summary": "{key, label, level?: personal|shared, revision?, roles?, layout?, settings?}. layout defaults to the current columns, settings to the current column settings; the current query is always saved."
+        }
+      },
+      "concurrency": "drop",
+      "summary": "Save a personal or shared view: view.save, or view.save_shared on a port of 1.1.0 or later. Throws TypeError without key and label, or for another level.",
+      "x-returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it. A shared level on a port older than 1.1.0 resolves to {answer: 'unavailable', reason: 'saved-view-levels-require-port-1.1.0'}."
+      }
+    },
+    "delete-view": {
+      "with": {
+        "key": "string"
+      },
+      "concurrency": "drop",
+      "summary": "Delete a saved view.",
+      "x-returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "apply-under-filter": {
+      "with": {
+        "action-id": "string",
+        "confirmed-total": "number"
+      },
+      "concurrency": "drop",
+      "summary": "Raise a confirmed filter-wide action (bulk.apply_under_filter) over the current filters. Throws TypeError when confirmedTotal is not the current total.",
+      "x-returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "reset-column-settings": {
+      "summary": "Reset the person's column layout: an empty personal layer written against its revision, which is the port's reset (a write, never a deletion). The host supplies the defaults.",
+      "x-returns": {
+        "type": "object",
+        "description": "A promise of the port answer, as saveColumnSettings returns it, including {answer: 'unavailable', reason: 'no-base-revision'}."
+      }
+    },
+    "clear-selection": {},
+    "notify": {
+      "with": {
+        "text": "string",
+        "options": {
+          "type": "object",
+          "optional": true,
+          "summary": "{kind?: 'error'|'warning', code?: string}. kind defaults to error; code is the reason the notice carries."
+        }
+      },
+      "summary": "Show one notice over the card, or clear it with an empty text. A refusal, a conflict and an unreachable host raise it by themselves.",
+      "x-returns": {
+        "type": "object",
+        "description": "The element, for chaining."
+      }
+    }
+  },
+  "slots": {
+    "toolbar": {},
+    "content": {
+      "default": true
+    },
+    "pagination": {}
+  },
+  "side-effects": [],
+  "keyboard": {
+    "host": {
+      "Tab": "reach"
+    }
+  },
+  "port": {
+    "id": "simai.dataview-port",
+    "version": "1.13.0",
+    "contract": "src/core/contracts/ports/simai.dataview-port/1.13.0/port.json"
+  },
+  "relations": [
+    {
+      "name": "icons"
+    },
+    {
+      "name": "cl-view-table"
+    },
+    {
+      "name": "cl-pagination"
+    },
+    {
+      "name": "cl-toast",
+      "lazy": true
+    },
+    {
+      "name": "cl-button"
+    },
+    {
+      "name": "cl-checkbox"
+    },
+    {
+      "name": "cl-dropdown"
+    },
+    {
+      "name": "cl-button-icon"
+    }
+  ],
+  "templates": {
+    "default": {
+      "file": "index.js",
+      "$comment": "the shadow layout is written in index.js (the migration form, §16); the rows are sf-table's template"
+    }
+  },
+  "presentation": {
+    "skeleton": {
+      "$comment": "The data comes through the port, or first from the page (first-answer, drawn at once, the port revalidating behind it): until the host first answers, the view is its skeleton (index.js _startFirstPaint) -- the shape the answer will have: the toolbar, the table's head and a row per row it will draw (the page size the list asks for -- a kept one, else the printed page row's page-size -- capped by row-cap; else row-cap; else a page of 10) with a cell per expected column (expected-columns) and the chrome columns, the compact list a phone gets (a container query at sf-table's list-below, 600 px), and the page row -- in its light DOM, slotted as first-paint, so its static markup (static/default/<example>.html) is that skeleton and the view adopts it (standard 1.3.8 §5.4). Its lengths are in sf-table's sheet.",
+      "late": []
+    }
+  },
+  "examples": "examples.json",
+  "docs": "docs.md",
+  "lang": "lang/",
+  "accessibility": {
+    "role": "region",
+    "name": {
+      "from": [
+        "aria-label"
+      ]
+    },
+    "keys": {
+      "Tab": "reach"
+    },
+    "announces": {
+      "total": "polite"
+    }
+  },
+  "css-variables": {
+    "--sf-data-view-gap": {
+      "type": "length",
+      "state": "default"
+    },
+    "--sf-data-view-drop-border-color": {
+      "type": "color",
+      "state": "dragged-over"
+    },
+    "--sf-data-view-drop-background-color": {
+      "type": "color",
+      "state": "dragged-over"
+    },
+    "--sf-data-view-drop-color": {
+      "type": "color",
+      "state": "dragged-over"
+    },
+    "--sf-data-view-toolbar-gap": {
+      "type": "length",
+      "state": "default"
+    }
+  },
+  "host-states": {
+    "data-state": "string",
+    "aria-busy": "string"
+  },
+  "aliases": {
+    "$comment": "Dated aliases of sf-view for the shim (core/js/aliases.js, standard §16 item 20).",
+    "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-tree-intent",
+        "to": "sf-data-view-tree",
+        "kind": "event",
+        "mode": "same-detail",
+        "cancelable": false,
+        "section": "§8, vocabulary §9",
+        "note": "the view's announcement of the tree's port intents carried a table name; the detail {intent, payload} is unchanged",
+        "summary": "A tree intent of simai.dataview-port 1.8.0 -- tree.expand, node.targets or node.move -- announced as the view raises it. The host answers through the port."
+      },
+      {
+        "from": "sf-data-view",
+        "to": "sf-view",
+        "kind": "tag",
+        "since": "2026-11-03",
+        "remove_after": "2027-01-01",
+        "since-version": "1.8.0",
+        "section": "rename plan R2 (ui-control RENAME-PLAN-2026-11-03), naming decision 2026-11-02",
+        "note": "the element is sf-view; sf-data-view is a subclass defined beside it until the date"
+      },
+      {
+        "from": "sf-data-view-open",
+        "to": "sf-view-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-data-view-deleted",
+        "to": "sf-view-deleted",
+        "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-data-view-answer",
+        "to": "sf-view-answer",
+        "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-data-view-state",
+        "to": "sf-view-state",
+        "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-data-view-tree",
+        "to": "sf-view-tree",
+        "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-data-view-files-drop",
+        "to": "sf-view-files-drop",
+        "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-data-view-saved-view-intent",
+        "to": "sf-view-saved-view-intent",
+        "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-data-view-list-open",
+        "to": "sf-view-list-open",
+        "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": "Host-driven data view that composes toolbar, content and pagination around a separate data port.",
+  "x-source": {
+    "package": "ui-pro",
+    "folder": "view",
+    "manifest": "simai/ui-pro@9cbe061 components/src/smart/data-view/smart.manifest.json",
+    "converted": "control/smart-architecture/stands/17-ports-migration/out/data-view.component.json"
+  },
+  "x-words": [
+    "column-search-placeholder",
+    "column-search-empty-text",
+    "column-move-label",
+    "filter-apply-text",
+    "show-more-text",
+    "selected-label",
+    "total-label",
+    "pages-label",
+    "first-label",
+    "previous-label",
+    "page-label",
+    "next-label",
+    "last-label",
+    "page-field-label",
+    "action-choose-label",
+    "actions-label",
+    "actions-region-label",
+    "clear-selection-label",
+    "page-size-label",
+    "pagination-aria-label"
+  ],
+  "x-port": {
+    "sha256": "6b6fa1e500b531c2db5cf296c7f3cf09cff991c9d86551f3a6e712ef0e3aad5c",
+    "supports": [
+      "1.0.0",
+      "1.1.0",
+      "1.2.0",
+      "1.3.0",
+      "1.4.0",
+      "1.5.0",
+      "1.6.0",
+      "1.7.0",
+      "1.8.0",
+      "1.9.0",
+      "1.10.0",
+      "1.11.0",
+      "1.12.0",
+      "1.13.0"
+    ]
+  },
+  "x-renamed": [
+    "settings.aria-label: a host attribute, read by the base, never a setting (§3.1)",
+    "events.count: 3 carried field(s) held the element, not data (§8)",
+    "events.sf-count-request → count (vocabulary §5 count)",
+    "events.sf-data-view-answer → answer (the DOM name without sf-<tag>-)",
+    "events.sf-data-view-saved-view → save (vocabulary §5.1)",
+    "events.sf-data-view-state → state (the DOM name without sf-<tag>-)",
+    "events.sf-table-action → apply (vocabulary §5 apply)",
+    "events.column-settings-change: 1 carried field(s) held the element, not data (§8)",
+    "events.sf-table-column-settings-change → column-settings-change (the DOM name without sf-<tag>-)",
+    "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-query → query (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-host-port-request: retires — the runtime hands the port to the parts that declare it (§4.9, 1.3.7); the page answers no request",
+    "events.sf-data-view-list-open → open (vocabulary §5 open)",
+    "events.sf-table-tree → tree (the DOM name without sf-<tag>-)",
+    "events.sf-data-view-files-drop → files-drop (the DOM name without sf-<tag>-)",
+    "events.sf-table-cell-set → cell-set (the DOM name without sf-<tag>-)",
+    "events.sf-table-rows-reorder → move (vocabulary §5 move)",
+    "slots.toolbar.accepts names components (smart.button, smart.input, smart.dropdown), not an interface <name>@<major> (§4.5.1); kept as x-accepts",
+    "slots.content.accepts names components (smart.data-view), not an interface <name>@<major> (§4.5.1); kept as x-accepts",
+    "slots.pagination.accepts names components (smart.pagination), not an interface <name>@<major> (§4.5.1); kept as x-accepts"
+  ],
+  "x-decisions": {
+    "shape": "leaf, with reasons (§7, the smaller mechanism). Stand 24 is the measured assembly of this screen (sf-record-browser: sf-source, sf-table, sf-pagination, sf-modal, sf-toast; 35/35 scenarios), and the view keeps its interface: collection, current, total, open {id}, deleted {ids}, refresh. It does not become that assembly now: its source part is a stand-in with no real component (sf-source, real: false in the parts catalogue), its confirm part (sf-change-confirm) moves in another branch, and §7.4 would stop the table's events at the frame, which ui-admin listens to on the page today (sf-table-action-intent, onSearchEnd …, vocabulary §9.2). Stand 24 on these real parts places this leaf where it placed the assembly (CC 0: the part tag).",
+    "version": "1.0.0 → 1.1.0, a minor while sf-table-tree-intent holds a dated alias (§4.10).",
+    "events": "open {id} is a cancelable request (vocabulary §5 open): sent when a row's view action is chosen, and the host's record.open follows unless a listener refused it; deleted {ids} is the fact after an applied delete (vocabulary §4). The tree's port intents are announced as tree {intent, payload}, sf-data-view-tree; the old sf-table-tree-intent follows once. answer and state keep their DOM names and details (instance_id stays snake_case until the next major).",
+    "re-emit": "simai/ui-pro#1 item 3: the view sends none of the table's events as its own; the sf-table-* events a page hears are the inner table's, once each (§8: an element never re-emits a part's event). The converter's apply, save, create, query, template-*, column-settings-*, cell-set and move are the table's and are not declared here.",
+    "alias-conflict": "sf-data-view-saved-view-intent is not this view's event but a page's request to it (a shared save); it stays listened to and is not renamed. The table's names are the table's (its aliases.json).",
+    "carries": "a carried field is one the detail holds under that very name (SF.Assembly checks it on every event); the rest is named in x-detail.",
+    "own-verb-words": "answer, state, tree and files-drop are verbs of this view alone; their words are lang events.<verb>.label.",
+    "bulk-actions": "a page gives the marked rows' actions on its page row's markup (ui-admin: actions=\"publish:…|delete:…\"); a view placed by an assembly makes its own table and page row (light DOM, where the page's sheets reach them) and takes the actions as the list setting bulk-actions [{id, label}], the label from the assembly's language file (§11.3). Stand 24 on the real parts measured the gap.",
+    "values": "state is the vocabulary's (populated → ready, no-access → refused); total, selected (the open record) and selection (the table's marked rows) are read-only.",
+    "actions": "refresh, change-query (concurrency latest: the newest answer wins, by the view's sequence), open-view, save-view, delete-view, apply-under-filter, reset-column-settings, clear-selection and notify answer outcomes (../table/js/manifest-actions.js: the port's {answer, reason, message} is the outcome) and take one object or positional parameters (§4.4). apply-projection, update-record and the tree helpers stay the element's helpers.",
+    "persistence": "the person's sort and page size are kept in SF.Preferences under preferences-key (or collection); nothing is an assembly key (§7.5).",
+    "item-shape": "the projection's records are the table's rows {id, revision, …}; page and page-size are numbers (vocabulary 1.1.5).",
+    "slot-interface": "toolbar, content and pagination take page content as it is; they name no interface (§4.5.1) until a trait exists for them — the x-accepts the converter found are component lists, not interfaces.",
+    "host-port": "connect-port (setHostPort its alias) hands the port; sf-host-port-request is still sent once per connection to a page that answers it, and is not part of this interface (the runtime hands ports down, §4.9).",
+    "listened-names": "the view listens to the table's and the page row's names of standard 1.3.8 (sf-table-apply, -select, -save, -refresh, -expand, -load-more, -move, -query, -create; sf-pagination-change, -size-change, -apply, -load-more, -selection-clear, -count, -action-change, -action-for-all-change), not to their dated aliases, so it keeps working after 2026-12-01 and takes each act once. Another page size reads from the first page.",
+    "own-parts": "a view placed by an assembly (the bare tag, data-sf-instance) makes its sf-table and sf-pagination as light-DOM children in its content and pagination slots, where the page's stylesheets reach them; the fallbacks inside the shadow root are drawn without the table's sheet. A page that writes the documented markup gives them itself and nothing is made. Since 1.6.0 the fallbacks and the made parts are the elements the Loader defines from their own bundles (the rule's relations cl-table, cl-pagination, cl-toast lazy); the view asks the Loader for any not defined yet (SF.Loader.ensure since 1.6.5) and projects again when it is. The fallbacks stay.",
+    "parts-by-tag": "1.6.0: index.js no longer imports ../table, ../pagination or ../toast (a package carries no element layer of its own, ui-source docs/developer/shared-runtime.md); data-view.min.js held a second copy of each (431 KB min, stand 25). Only the table's manifest-actions helpers are imported. The view's own sheet is its first paint (js/first-paint.css -> data-view.css, rule css true): the skeleton rules moved there from sf-table's sheet. A page that links data-view.css by hand keeps a sheet that exists; a page that relies on the Loader gets it from the rule.",
+    "conflict-total": "a filter-wide action whose count moved is a conflict carrying the current total (vocabulary §3.1); the page row shows that total at once.",
+    "access-codes": "a refusal for access is read in both spellings, access_denied (Larena) and access-denied (ui-admin's reference host, stand 24 U2); the value state is refused then.",
+    "lang-ru": "the title is «Представление данных» in Russian.",
+    "template": "the shadow layout is in index.js, the migration form; the rows are sf-table's template; the first paint is the view's own skeleton in its light DOM (presentation.skeleton).",
+    "css-variables": "five public variables: the gap, the drop zone's border, fill and words, the toolbar's gap; they are read with the role tokens as fallbacks.",
+    "skeleton": "index.js _startFirstPaint: the toolbar, the head and a row per row of the page the list asks for (kept page size, else the printed page row's page-size, which the first query also asks for; capped by row-cap; else row-cap, else 10) of expected-columns cells, the compact list below 600 px, and the page row, until the host first answers; printed as the static markup and adopted. expected-columns is the skeleton's shape, never a limit: the answer brings its own columns.",
+    "source-drift": "carried by hand: the estimated total «~N» (ui-pro 71ebff1) is the view's behaviour, not a member.",
+    "docs": "docs.md, where the folder keeps it.",
+    "loader-ensure": "version 1.6.5: the parts, the move dialog's elements and sf-table for the row-action catalogue are asked for through SF.Loader.ensure (core.runtime 1.19.0), 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.",
+    "layer-stack-dialog": "version 1.7.0: the move dialog and the host's confirmation (confirm_required) are sf-modal, not a native <dialog> shown with showModal() (reuse audit 2026-11-02, findings 1 and 2): a modal layer of the one document stack, so a drawer or a modal opened over it or under it is ordered with it, Escape and a press outside close the top one only, focus returns by the stack's rule, the page lock is the stack's. The window is made in slot dialog and drawn in sf-modal's portal; open() asked with a signal answers when it closes (§19.4), accepted only through the apply button (sf-modal confirm()); Escape, the scrim, the close button and «Отмена» answer null as Escape and «Отмена» did. sf-modal, sf-button and sf-radio are asked for through SF.Loader.ensure before it opens; without sf-modal the view says unavailable and writes nothing. Visible: the shared scrim (black at 60) in place of the browser's light backdrop, the title in sf-modal's header with its close button, sf-modal's panel and footer. Needs core.runtime >= 1.19.0.",
+    "framework-tag-renames": "version 1.7.1: 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 bulk clear button is sf-button-icon. 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.8.0: the tag is sf-view (naming decision 2026-11-02: sf-[set]-<block>[-<variant>]; rename plan R2); the folder view, the id smart.view and the bundle cl-view follow it. sf-data-view 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, sf-data-view), its events named after the tag followed by their former names (ui-source change journal tag-sf-data-view-to-sf-view, path-smart-data-view-to-view).",
+    "host-chrome": "version 1.8.1: a table the host wrote selectable=\"false\" or settings=\"false\" on keeps it. The view wrote its own chrome (select, settings) over both on every projection, so a list the host had turned them off on came back with a box in every row and the settings column (Larena, the sites list, 2026-11-05). What the table carried before the view first touched it is kept in data-sf-host-selectable and data-sf-host-settings, as data-sf-host-row-actions already was, and the first-paint skeleton draws the same columns."
+  },
+  "x-rule": {
+    "$comment": [
+      "sf-view had no rule either, so its tag loaded nothing and every consumer",
+      "added the script by hand. Found while fixing the same gap in sf-view-properties.",
+      "The relations are what the composite itself composes; the table brings its own",
+      "through cl-view-table."
+    ]
+  },
+  "x-registry": {
+    "kind": "composite",
+    "capabilities": [
+      "data-view",
+      "search",
+      "filtering",
+      "sorting",
+      "saved-views",
+      "pagination",
+      "responsive"
+    ],
+    "persistence": {
+      "mode": "external-host",
+      "source_of_truth": "host",
+      "network_owner": "host",
+      "revision_field": "revision"
+    },
+    "readiness": {
+      "level": "host-required",
+      "required_checks": [
+        "host-port-reference",
+        "data-view-composite",
+        "responsive-table",
+        "generated-pair"
+      ]
+    },
+    "tags": [
+      "admin",
+      "collection",
+      "data",
+      "table"
+    ],
+    "composition-declarative": {
+      "standard": "simai.composition.document.v1",
+      "type": "smart.view",
+      "mode": "leaf",
+      "profiles": [
+        "ui-layout"
+      ],
+      "props": [
+        "aria-label"
+      ],
+      "data": {},
+      "events": [
+        "sf-view-answer",
+        "sf-view-saved-view-intent",
+        "sf-view-state",
+        "sf-pagination-count",
+        "sf-table-action-intent",
+        "sf-table-column-settings-change",
+        "sf-view-table-column-settings-reset",
+        "sf-table-create-intent",
+        "sf-table-query-intent",
+        "sf-view-table-template-delete",
+        "sf-view-table-template-save",
+        "sf-view-table-template-select",
+        "sf-table-tree-intent"
+      ],
+      "persistence": {
+        "settings_key_prop": null,
+        "revision_prop": null
+      },
+      "presentation": {
+        "views": [
+          "default"
+        ],
+        "presets": [],
+        "modifiers": []
+      },
+      "slots": {
+        "toolbar": {
+          "accepts": [
+            "smart.button",
+            "smart.input",
+            "smart.dropdown"
+          ]
+        },
+        "content": {
+          "accepts": [
+            "smart.view-table"
+          ]
+        },
+        "pagination": {
+          "accepts": [
+            "smart.pagination"
+          ]
+        }
+      },
+      "renderer": {
+        "kind": "custom-element",
+        "name": "sf-view"
+      },
+      "assets": [
+        "smart/view"
+      ],
+      "host_port": {
+        "port": "simai.dataview-port",
+        "version": "1.13.0",
+        "path": "src/core/contracts/ports/simai.dataview-port/1.13.0/port.json",
+        "sha256": "6b6fa1e500b531c2db5cf296c7f3cf09cff991c9d86551f3a6e712ef0e3aad5c",
+        "supported_versions": [
+          "1.0.0",
+          "1.1.0",
+          "1.2.0",
+          "1.3.0",
+          "1.4.0",
+          "1.5.0",
+          "1.6.0",
+          "1.7.0",
+          "1.8.0",
+          "1.9.0",
+          "1.10.0",
+          "1.11.0",
+          "1.12.0",
+          "1.13.0"
+        ]
+      }
+    },
+    "item_contract": {
+      "page": "Positive one-based page number bounded by total and page-size.",
+      "ellipsis": "Non-interactive indicator for omitted pages."
+    },
+    "contracts": {
+      "navigation": {
+        "const": "The visible root is a named nav; page actions are native buttons because the component emits state events instead of owning URLs."
+      },
+      "current": {
+        "const": "Exactly one rendered page exposes aria-current=page when total is greater than zero."
+      },
+      "empty": {
+        "const": "A zero-sized collection renders no page controls and emits no page-change."
+      },
+      "responsive": {
+        "const": "A long desktop range keeps edge pages and static ellipses; a narrow range keeps the current page, adjacent pages and directional actions on one line."
+      },
+      "composition": {
+        "const": "Show-more, page-size and batch-action sections remain compatible optional compositions; data loading and host actions stay outside the component."
+      }
+    },
+    "state": {
+      "machines": {
+        "data": [
+          "loading",
+          "populated",
+          "empty",
+          "error"
+        ]
+      },
+      "visual_states": [
+        "default",
+        "loading",
+        "empty",
+        "error"
+      ]
+    },
+    "artifacts": {
+      "fixtures": [],
+      "scenarios": []
+    },
+    "ownership": {
+      "source": "simai/ui-admin",
+      "data": "host",
+      "effects": "host",
+      "forbidden_client_responsibilities": [
+        "access decisions",
+        "database writes",
+        "unspecified transport"
+      ]
+    },
+    "security": {
+      "permissions_owner": "host",
+      "untrusted_inputs": [
+        "query",
+        "records",
+        "saved_views",
+        "answer messages"
+      ],
+      "network_policy": "deny"
+    },
+    "presentation": {
+      "skeleton": {
+        "shape": "rows",
+        "while_loading": "template"
+      },
+      "themes": [
+        "light",
+        "dark"
+      ],
+      "locales": [
+        "ru",
+        "en"
+      ],
+      "responsive": [
+        "Slots and child components own responsive behaviour"
+      ]
+    },
+    "ai_guidance": {
+      "use_when": "Use for a host-driven CMS collection with toolbar, table and pagination.",
+      "do_not": [
+        "Do not embed rows in the composition recipe",
+        "Do not infer permissions from visible buttons"
+      ],
+      "required_reads": [
+        "host_port",
+        "events",
+        "ownership",
+        "compatibility",
+        "docs"
+      ],
+      "minimal_example": "<sf-view aria-label=\"Записи\"><sf-view-table slot=\"content\" aria-label=\"Записи\"></sf-view-table><sf-pagination slot=\"pagination\"></sf-pagination></sf-view>",
+      "owner_commands": [
+        "node scripts/test.mjs",
+        "node scripts/run-browser-probes.mjs <free output> <package output>"
+      ]
+    },
+    "accessibility": {
+      "accessible_name": "required",
+      "keyboard": [
+        "Native controls and child Smart components"
+      ],
+      "focus": "No focus movement on data refresh"
+    },
+    "compatibility": {
+      "migrations": [
+        {
+          "from": "1.0.0",
+          "to": "1.1.0",
+          "changes": [
+            "From component.json (standard simai.smart-component 1.3.8): sf-data-view-open {id} (cancelable) before the host's record.open, sf-data-view-deleted {ids} after an applied delete, sf-data-view-tree with sf-table-tree-intent as its dated alias; values state (vocabulary), total, selected, selection; settings collection and current; the actions answer outcomes."
+          ]
+        },
+        {
+          "from": "1.4.2",
+          "to": "1.4.3",
+          "changes": [
+            "The first-paint snapshot's sheets.json lists the utility sheets its markup uses (retaken on ui-source 5ba9399); no behaviour changed. Nothing to change for a host."
+          ]
+        },
+        {
+          "from": "1.6.4",
+          "to": "1.6.5",
+          "changes": [
+            "Parts 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.6.5",
+          "to": "1.7.0",
+          "changes": [
+            "The move dialog and the confirmation are sf-modal on the layer stack, not a native <dialog>; needs core.runtime >= 1.19.0 and sf-modal on the page's pair. Visible: the shared scrim (black at 60) instead of the browser's backdrop, sf-modal's header with a close button and its footer. Same answers: applied only through the apply button. Nothing to change for a host."
+          ]
+        },
+        {
+          "from": "1.7.0",
+          "to": "1.7.1",
+          "changes": [
+            "Draws and finds the renamed Framework elements by their new tags (the bulk clear button is sf-button-icon); 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.7.1",
+          "to": "1.8.0",
+          "changes": [
+            "The tag is sf-view (rename plan R2, naming decision 2026-11-02: sf-[set]-<block>); the folder view, the id smart.view and the bundle cl-view follow it (were data-view, smart.data-view-composite, cl-data-view). sf-data-view stays a dated alias until 2027-01-01: old markup upgrades as this element, the Loader forwards cl-data-view, and every event fires under its former name as well, with the same detail. Public CSS variables and classes keep their names; the opaque instance_id of the state and answer events reads sf-view-<n> (was sf-data-view-<n>). 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."
+          ]
+        },
+        {
+          "from": "1.8.0",
+          "to": "1.8.1",
+          "changes": [
+            "A table the host wrote selectable=\"false\" or settings=\"false\" on keeps it inside the view (no row boxes, no settings column); before, the view's chrome overwrote both. Nothing to change for a host; a host that wanted the view's boxes on such a table removes its own attribute."
+          ]
+        }
+      ]
+    },
+    "alias-events": {
+      "sf-table-tree-intent": {
+        "summary": "A tree intent of simai.dataview-port 1.8.0 -- tree.expand, node.targets or node.move -- announced as the view raises it. The host answers through the port.",
+        "payload": {
+          "type": "object",
+          "required": [
+            "intent",
+            "payload"
+          ],
+          "additionalProperties": false,
+          "properties": {
+            "intent": {
+              "type": "string"
+            },
+            "payload": {
+              "type": "object"
+            }
+          }
+        }
+      }
+    },
+    "event-fields": {
+      "sf-table-template-save": {
+        "payload": {
+          "description": "One template object when a single template is saved from the form, or an array of them when Apply on the Templates tab changed several (order, pin, default, selected).",
+          "oneOf": [
+            {
+              "type": "object",
+              "required": [
+                "key",
+                "label",
+                "settings"
+              ],
+              "properties": {
+                "key": {
+                  "type": "string",
+                  "description": "The template's key; a new template gets filter_template_<n>."
+                },
+                "label": {
+                  "type": "string",
+                  "description": "The name the person gave it."
+                },
+                "selected": {
+                  "type": "boolean",
+                  "description": "Whether it is the applied template."
+                },
+                "data": {
+                  "type": "object",
+                  "description": "The filter draft it keeps: the form values, `values` and `tags`."
+                },
+                "settings": {
+                  "type": "object",
+                  "properties": {
+                    "filter_fields": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      },
+                      "description": "The filter fields it was showing, so opening it shows them again."
+                    }
+                  },
+                  "description": "Passed through by the port as it is."
+                }
+              }
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "key",
+                  "label",
+                  "settings"
+                ],
+                "properties": {
+                  "key": {
+                    "type": "string",
+                    "description": "The template's key; a new template gets filter_template_<n>."
+                  },
+                  "label": {
+                    "type": "string",
+                    "description": "The name the person gave it."
+                  },
+                  "selected": {
+                    "type": "boolean",
+                    "description": "Whether it is the applied template."
+                  },
+                  "data": {
+                    "type": "object",
+                    "description": "The filter draft it keeps: the form values, `values` and `tags`."
+                  },
+                  "settings": {
+                    "type": "object",
+                    "properties": {
+                      "filter_fields": {
+                        "type": "array",
+                        "items": {
+                          "type": "string"
+                        },
+                        "description": "The filter fields it was showing, so opening it shows them again."
+                      }
+                    },
+                    "description": "Passed through by the port as it is."
+                  }
+                }
+              },
+              "minItems": 1
+            }
+          ]
+        }
+      }
+    },
+    "methods": {
+      "applyProjection": {
+        "summary": "Render a host answer in all three slots.",
+        "arguments": [
+          {
+            "name": "data",
+            "type": "object",
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "null"
+        }
+      },
+      "saveColumnSettings": {
+        "summary": "Write a column-settings layer, personal or shared, against its revision: settings.save_personal or settings.save_shared. The base revision is the one given, else the layer's, else the port target's. After a conflict the view takes the current_revision (and the layer's columns) the answer carries beside answer, as simai.dataview-port 1.12.0 states; it still reads data.current_revision and data.column_settings from a host that followed 1.10.0's words, and re-reads the list when the conflict names no revision.",
+        "arguments": [
+          {
+            "name": "columnSettings",
+            "type": "object",
+            "required": true,
+            "description": "The column-preference delta to write, keyed by column key."
+          },
+          {
+            "name": "options",
+            "type": "object",
+            "required": false,
+            "description": "{shared?: boolean, base_revision?: string|number}. shared writes the shared layer (default false); base_revision overrides the revision the view holds.",
+            "properties": {
+              "shared": {
+                "type": "boolean",
+                "default": false
+              },
+              "base_revision": {
+                "type": [
+                  "string",
+                  "number"
+                ]
+              }
+            }
+          }
+        ],
+        "returns": {
+          "type": "object",
+          "description": "A promise of the port answer {answer: applied|conflict|refused|unavailable, …}, or of null when superseded. Resolves to {answer: 'unavailable', reason: 'no-base-revision'} without asking the host when no revision is known."
+        }
+      },
+      "setHostPort": {
+        "summary": "Bind an exact host adapter.",
+        "arguments": [
+          {
+            "name": "host",
+            "type": "object",
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "object",
+          "description": "The element, for chaining."
+        }
+      },
+      "updateRecord": {
+        "summary": "Write one record in place: that row is rewritten and nothing is asked of the host. A write answered with records alone takes this path by itself.",
+        "arguments": [
+          {
+            "name": "id",
+            "type": [
+              "string",
+              "integer"
+            ],
+            "required": true
+          },
+          {
+            "name": "patch",
+            "type": "object",
+            "required": false
+          }
+        ],
+        "returns": {
+          "type": "boolean",
+          "description": "Whether a shown record was rewritten."
+        }
+      },
+      "expandNode": {
+        "summary": "Open a node the host said has children: from what the view holds, or by asking the host with tree.expand.",
+        "arguments": [
+          {
+            "name": "id",
+            "type": [
+              "string",
+              "integer"
+            ],
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "object",
+          "description": "A promise of the host answer, or of null when superseded; null at once when the node is unknown, has no children, or its children are already held."
+        }
+      },
+      "collapseNode": {
+        "summary": "Close an open node. The view's own business; the host is not asked.",
+        "arguments": [
+          {
+            "name": "id",
+            "type": [
+              "string",
+              "integer"
+            ],
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "null"
+        }
+      },
+      "loadMoreNodes": {
+        "summary": "The next page of one level: the roots through the query, a node's children through tree.expand with its cursor.",
+        "arguments": [
+          {
+            "name": "parent",
+            "type": [
+              "string",
+              "integer",
+              "null"
+            ],
+            "required": true
+          },
+          {
+            "name": "cursor",
+            "type": [
+              "string",
+              "null"
+            ],
+            "required": false
+          }
+        ],
+        "returns": {
+          "type": "object",
+          "description": "A promise of the host answer, or of null when superseded."
+        }
+      },
+      "openMoveDialog": {
+        "summary": "Ask the host where a record may go (node.targets), let the person choose among exactly those places, and move it there (node.move).",
+        "arguments": [
+          {
+            "name": "record",
+            "type": "object",
+            "required": true
+          }
+        ],
+        "returns": {
+          "type": "object",
+          "description": "A promise of the host answer, or of null when superseded."
+        }
+      }
+    },
+    "inputs": {
+      "aria-label": {
+        "default": "Представление данных"
+      }
+    }
+  }
+}