@simai-studio/view 0.0.0-stage → 1.1.0

package/dist/smart/view/smart.manifest.json

@@ -0,0 +1,1577 @@
+{
+  "schema_version": 2,
+  "id": "smart.view",
+  "version": "1.8.1",
+  "title": "Data view",
+  "summary": "Host-driven data view that composes toolbar, content and pagination around a separate data port.",
+  "kind": "composite",
+  "reuse_mode": "whole",
+  "lifecycle": "experimental",
+  "tags": [
+    "admin",
+    "collection",
+    "data",
+    "table"
+  ],
+  "capabilities": [
+    "data-view",
+    "search",
+    "filtering",
+    "sorting",
+    "saved-views",
+    "pagination",
+    "responsive"
+  ],
+  "custom_element": "sf-view",
+  "templates": [
+    "default"
+  ],
+  "exported_parts": [],
+  "composition": {
+    "uses": [
+      "component.icons",
+      "smart.button",
+      "smart.button-icon",
+      "smart.checkbox",
+      "smart.dropdown",
+      "smart.pagination",
+      "smart.toast",
+      "smart.view-table"
+    ],
+    "public_parts": [],
+    "declarative": {
+      "standard": "simai.composition.document.v1",
+      "type": "smart.view",
+      "mode": "leaf",
+      "profiles": [
+        "ui-layout"
+      ],
+      "props": [
+        "template",
+        "chrome",
+        "row-cap",
+        "expected-columns",
+        "port-owner",
+        "port-record",
+        "port-group",
+        "size",
+        "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",
+        "preferences-key",
+        "accept-files",
+        "collection",
+        "current",
+        "aria-label"
+      ],
+      "data": {},
+      "events": [
+        "sf-view-open",
+        "sf-view-deleted",
+        "sf-view-answer",
+        "sf-view-state",
+        "sf-view-tree",
+        "sf-view-files-drop",
+        "sf-pagination-count",
+        "sf-view-saved-view-intent",
+        "sf-table-action-intent",
+        "sf-table-column-settings-change",
+        "sf-table-column-settings-reset",
+        "sf-table-create-intent",
+        "sf-table-query-intent",
+        "sf-table-template-delete",
+        "sf-table-template-save",
+        "sf-table-template-select",
+        "sf-host-port-request",
+        "sf-view-list-open",
+        "sf-table-cell-set",
+        "sf-table-rows-reorder"
+      ],
+      "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"
+        ]
+      }
+    }
+  },
+  "inputs": {
+    "type": "object",
+    "properties": {
+      "template": {
+        "type": "string",
+        "default": "default",
+        "description": "Template variant name for SfBaseElement external templates."
+      },
+      "root-class": {
+        "type": "string",
+        "default": "",
+        "description": "Classes added to the root element the component draws."
+      },
+      "root-style": {
+        "type": "string",
+        "default": "",
+        "description": "Inline style declarations set on the root element the component draws, custom properties included."
+      },
+      "chrome": {
+        "type": "string",
+        "default": "toolbar pagination select settings",
+        "description": "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": "integer",
+        "default": 0,
+        "description": "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.",
+        "minimum": 0
+      },
+      "expected-columns": {
+        "type": "integer",
+        "default": 4,
+        "description": "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.",
+        "minimum": 1
+      },
+      "port-owner": {
+        "type": "string",
+        "default": "",
+        "description": "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": "",
+        "description": "The record the embedding composite is showing, sent with the host-port request."
+      },
+      "port-group": {
+        "type": "string",
+        "default": "",
+        "description": "The group inside that composite this list stands in, sent with the host-port request."
+      },
+      "size": {
+        "type": "string",
+        "default": "1",
+        "description": "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.",
+        "enum": [
+          "1/2",
+          "1"
+        ]
+      },
+      "column-search-placeholder": {
+        "type": "string",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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",
+        "default": "",
+        "description": "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": "",
+        "description": "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,
+        "description": "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": "",
+        "description": "The host's collection id; the view's preference key falls back to it (component.json settings.collection)."
+      },
+      "current": {
+        "type": "string",
+        "default": "",
+        "description": "The id of the record the page has open: its row carries aria-current. Writing it sends nothing (component.json settings.current)."
+      },
+      "aria-label": {
+        "type": "string",
+        "default": "Представление данных"
+      },
+      "bulk-actions": {
+        "type": "array"
+      },
+      "first-answer": {
+        "type": "object"
+      }
+    },
+    "additionalProperties": false
+  },
+  "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."
+    }
+  },
+  "methods": {
+    "refresh": {
+      "summary": "Request current query with a new sequence.",
+      "arguments": [
+        {
+          "name": "reason",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "changeQuery": {
+      "summary": "Change search, filters, sort or window.",
+      "arguments": [
+        {
+          "name": "patch",
+          "schema": {
+            "type": "object"
+          }
+        },
+        {
+          "name": "reason",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "openView": {
+      "summary": "Open a saved view.",
+      "arguments": [
+        {
+          "name": "key",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "saveView": {
+      "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.",
+      "arguments": [
+        {
+          "name": "view",
+          "schema": {
+            "type": "object",
+            "description": "{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."
+          }
+        }
+      ],
+      "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'}."
+      }
+    },
+    "deleteView": {
+      "summary": "Delete a saved view.",
+      "arguments": [
+        {
+          "name": "key",
+          "schema": {
+            "type": "string"
+          }
+        }
+      ],
+      "returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "applyUnderFilter": {
+      "summary": "Raise a confirmed filter-wide action (bulk.apply_under_filter) over the current filters. Throws TypeError when confirmedTotal is not the current total.",
+      "arguments": [
+        {
+          "name": "actionId",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "confirmedTotal",
+          "schema": {
+            "type": "number"
+          }
+        }
+      ],
+      "returns": {
+        "type": "object",
+        "description": "A promise of the host answer: {answer: applied|conflict|refused|unavailable, …}, or of null when a newer request superseded it."
+      }
+    },
+    "resetColumnSettings": {
+      "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.",
+      "arguments": [],
+      "returns": {
+        "type": "object",
+        "description": "A promise of the port answer, as saveColumnSettings returns it, including {answer: 'unavailable', reason: 'no-base-revision'}."
+      }
+    },
+    "clearSelection": {
+      "summary": "The action clear-selection.",
+      "arguments": [],
+      "returns": {
+        "type": "object"
+      }
+    },
+    "notify": {
+      "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.",
+      "arguments": [
+        {
+          "name": "text",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "options",
+          "schema": {
+            "type": "object",
+            "description": "{kind?: 'error'|'warning', code?: string}. kind defaults to error; code is the reason the notice carries."
+          }
+        }
+      ],
+      "returns": {
+        "type": "object",
+        "description": "The element, for chaining."
+      }
+    },
+    "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."
+      }
+    }
+  },
+  "events": {
+    "sf-view-open": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {}
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-view-deleted": {
+      "summary": "The fact after an applied delete, vocabulary §4: {ids}.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "ids"
+        ],
+        "properties": {
+          "ids": {
+            "type": "array"
+          }
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-view-answer": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "intent",
+          "answer",
+          "instance_id"
+        ],
+        "properties": {
+          "intent": {
+            "type": "string",
+            "description": "The port intent answered, e.g. query.change, view.save, settings.save_personal, record.mutate."
+          },
+          "answer": {
+            "enum": [
+              "applied",
+              "conflict",
+              "refused",
+              "unavailable"
+            ],
+            "description": "The port answer.",
+            "type": "string"
+          },
+          "reason": {
+            "type": "string",
+            "description": "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",
+            "description": "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",
+            "description": "The host's data, copied as it answered."
+          },
+          "sequence": {
+            "type": "integer",
+            "description": "The query sequence the host echoed, when it did."
+          },
+          "effects": {
+            "type": "array",
+            "description": "Effects the host reported for the rest of the page."
+          },
+          "instance_id": {
+            "type": "string",
+            "description": "The view's instance id, sf-data-view-<n>."
+          }
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-view-state": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "state",
+          "message",
+          "instance_id"
+        ],
+        "properties": {
+          "state": {
+            "enum": [
+              "loading",
+              "populated",
+              "empty",
+              "error",
+              "no-access"
+            ],
+            "description": "The new state, also written to data-state.",
+            "type": "string"
+          },
+          "message": {
+            "type": "string",
+            "description": "The announced status text; empty when there is none."
+          },
+          "instance_id": {
+            "type": "string",
+            "description": "The view's instance id, sf-data-view-<n>."
+          }
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-view-tree": {
+      "summary": "The tree's port intents announced, {intent, payload}; the old sf-table-tree-intent follows once until 2026-12-01 (aliases.json).",
+      "payload": {
+        "type": "object",
+        "required": [
+          "intent"
+        ],
+        "properties": {
+          "intent": {
+            "type": "string"
+          },
+          "payload": {
+            "type": "object"
+          }
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-view-files-drop": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "files"
+        ],
+        "properties": {
+          "files": {
+            "type": "array",
+            "description": "The dropped File objects, at least one.",
+            "items": {
+              "type": "object"
+            },
+            "minItems": 1
+          }
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-pagination-count": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "component",
+          "tagName",
+          "template",
+          "reason",
+          "current",
+          "pageSize"
+        ],
+        "properties": {
+          "component": {
+            "type": "object",
+            "description": "The pagination element that asked."
+          },
+          "tagName": {
+            "type": "string",
+            "description": "Its tag name."
+          },
+          "template": {
+            "type": "string",
+            "description": "Its template name."
+          },
+          "reason": {
+            "enum": [
+              "total",
+              "last-page",
+              "action-for-all"
+            ],
+            "description": "What the number is for.",
+            "type": "string"
+          },
+          "current": {
+            "type": "integer",
+            "description": "The current page."
+          },
+          "pageSize": {
+            "type": "integer",
+            "description": "The page size."
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-view-saved-view-intent": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "key",
+          "label"
+        ],
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "The saved view's key."
+          },
+          "label": {
+            "type": "string",
+            "description": "Its name as shown."
+          },
+          "revision": {
+            "type": [
+              "string",
+              "integer"
+            ],
+            "description": "The revision it is written against, when it exists."
+          },
+          "roles": {
+            "type": "object",
+            "description": "Who may open it, as the host names roles."
+          }
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-table-action-intent": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "action_id",
+          "record_ids"
+        ],
+        "properties": {
+          "action_id": {
+            "type": "string",
+            "description": "The opaque id of the row or bulk action chosen.",
+            "minLength": 1
+          },
+          "record_ids": {
+            "type": "array",
+            "description": "The records it applies to: the row's own id, or the selected ids for a bulk action.",
+            "items": {
+              "type": [
+                "string",
+                "integer"
+              ]
+            },
+            "minItems": 1
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-table-column-settings-change": {
+      "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}).",
+      "payload": {
+        "type": "object",
+        "required": [
+          "reason",
+          "columnSettings",
+          "tableSettingsKey"
+        ],
+        "properties": {
+          "reason": {
+            "type": "string",
+            "description": "What changed: column-resize, column-resize-reset, column-drag, column-order, column-pin, column-visibility, column-settings-restore, column-settings."
+          },
+          "columnSettings": {
+            "type": "object",
+            "description": "The whole column-preference delta after the change, keyed by column key (width, order, hidden, pinned)."
+          },
+          "tableSettingsKey": {
+            "type": "string",
+            "description": "The table's settings key, so a host can tell several tables apart."
+          },
+          "target": {
+            "enum": [
+              "personal",
+              "shared"
+            ],
+            "description": "Not sent by the table. Another source may send shared to write the shared layer.",
+            "type": "string"
+          },
+          "base_revision": {
+            "type": [
+              "string",
+              "number"
+            ],
+            "description": "Not sent by the table. Another source may name the base revision; otherwise the view uses the layer's."
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-table-column-settings-reset": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "target",
+          "tableSettingsKey"
+        ],
+        "properties": {
+          "target": {
+            "const": "personal",
+            "description": "The layer to reset. The table only resets the person's own layer.",
+            "type": "string"
+          },
+          "tableSettingsKey": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The table's settings key, or null when it has none."
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-table-create-intent": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "item"
+        ],
+        "properties": {
+          "item": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "null for the main create button; the declared create item's id when one was chosen from its menu."
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-table-query-intent": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "reason",
+          "context",
+          "sequence"
+        ],
+        "properties": {
+          "reason": {
+            "const": "context",
+            "description": "Always context: the context input port changed."
+          },
+          "context": {
+            "type": "object",
+            "description": "The immutable context last received through the context input port."
+          },
+          "sequence": {
+            "type": "integer",
+            "description": "The pending query's sequence; only the newest is applied.",
+            "minimum": 1
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-table-template-delete": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "key"
+        ],
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "The saved template's key.",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-table-template-save": {
+      "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.",
+      "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
+          }
+        ]
+      }
+    },
+    "sf-table-template-select": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "key"
+        ],
+        "properties": {
+          "key": {
+            "type": "string",
+            "description": "The saved template's key.",
+            "minLength": 1
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-host-port-request": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [],
+        "properties": {
+          "component": {
+            "type": "object",
+            "description": "The element asking, so a host can answer it directly."
+          },
+          "context": {
+            "type": "object",
+            "description": "Which composite is asking and about what: owner, record, group. All null on a page list, which is asking about nothing but itself."
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-view-list-open": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "reason",
+          "query"
+        ],
+        "properties": {
+          "reason": {
+            "enum": [
+              "row-cap"
+            ]
+          },
+          "query": {
+            "type": "object"
+          }
+        },
+        "additionalProperties": true
+      },
+      "canonical": true
+    },
+    "sf-table-cell-set": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "id",
+          "key",
+          "value",
+          "revision"
+        ],
+        "properties": {
+          "id": {
+            "type": [
+              "string",
+              "integer"
+            ],
+            "description": "The record's id."
+          },
+          "key": {
+            "type": "string",
+            "description": "The column (field) key of the cell."
+          },
+          "value": {
+            "description": "The value the cell now asks for (a checkbox: true or false)."
+          },
+          "revision": {
+            "type": [
+              "string",
+              "integer",
+              "null"
+            ],
+            "description": "The record's _revision or revision, or null."
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "sf-table-rows-reorder": {
+      "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.",
+      "payload": {
+        "type": "object",
+        "required": [
+          "ids",
+          "before",
+          "order"
+        ],
+        "properties": {
+          "ids": {
+            "type": "array",
+            "description": "The ids of the rows that moved.",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1
+          },
+          "before": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The id of the row they now stand before; null for the end of the list."
+          },
+          "order": {
+            "type": "array",
+            "description": "Every row id shown, in the new order.",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "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"
+          }
+        }
+      },
+      "alias_of": "sf-view-tree"
+    },
+    "sf-data-view-open": {
+      "summary": "Dated alias of sf-view-open until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-open"
+    },
+    "sf-data-view-deleted": {
+      "summary": "Dated alias of sf-view-deleted until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-deleted"
+    },
+    "sf-data-view-answer": {
+      "summary": "Dated alias of sf-view-answer until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-answer"
+    },
+    "sf-data-view-state": {
+      "summary": "Dated alias of sf-view-state until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-state"
+    },
+    "sf-data-view-tree": {
+      "summary": "Dated alias of sf-view-tree until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-tree"
+    },
+    "sf-data-view-files-drop": {
+      "summary": "Dated alias of sf-view-files-drop until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-files-drop"
+    },
+    "sf-data-view-saved-view-intent": {
+      "summary": "Dated alias of sf-view-saved-view-intent until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-saved-view-intent"
+    },
+    "sf-data-view-list-open": {
+      "summary": "Dated alias of sf-view-list-open until 2027-01-01 (same-detail).",
+      "payload": {
+        "type": "object"
+      },
+      "alias_of": "sf-view-list-open"
+    }
+  },
+  "state": {
+    "machines": {
+      "data": [
+        "loading",
+        "populated",
+        "empty",
+        "error"
+      ]
+    },
+    "visual_states": [
+      "default",
+      "loading",
+      "empty",
+      "error"
+    ]
+  },
+  "persistence": {
+    "mode": "external-host",
+    "source_of_truth": "host",
+    "network_owner": "host",
+    "revision_field": "revision"
+  },
+  "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"
+  },
+  "accessibility": {
+    "role": "region",
+    "accessible_name": "required",
+    "keyboard": [
+      "Native controls and child Smart components"
+    ],
+    "focus": "No focus movement on data refresh"
+  },
+  "presentation": {
+    "skeleton": {
+      "shape": "rows",
+      "while_loading": "template"
+    },
+    "themes": [
+      "light",
+      "dark"
+    ],
+    "locales": [
+      "ru",
+      "en"
+    ],
+    "responsive": [
+      "Slots and child components own responsive behaviour"
+    ]
+  },
+  "adapter": {
+    "kind": "generic",
+    "protocol": "simai.smart-studio-adapter.v1",
+    "module": null
+  },
+  "artifacts": {
+    "fixtures": [],
+    "scenarios": []
+  },
+  "readiness": {
+    "level": "host-required",
+    "required_checks": [
+      "host-port-reference",
+      "data-view-composite",
+      "responsive-table",
+      "generated-pair"
+    ]
+  },
+  "compatibility": {
+    "contract_schema": {
+      "id": "https://simai.io/contracts/smart-component-manifest.v2.schema.json",
+      "version": 2
+    },
+    "runtime_pair": {
+      "ui_revision": "89834691fb9dce692be5353f3214df7aee3a7e27",
+      "ui_smart_revision": "89834691fb9dce692be5353f3214df7aee3a7e27"
+    },
+    "aliases": [
+      "<sf-data-view>"
+    ],
+    "deprecations": [
+      {
+        "path": "<sf-data-view>",
+        "since": "1.8.0",
+        "replacement": "<sf-view>"
+      }
+    ],
+    "replacement": null,
+    "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."
+        ]
+      }
+    ]
+  },
+  "provenance": {
+    "source_repository": "simai/ui-pro",
+    "source_revision": "a5ac53753d95b49e2e70078c94fd89ccd3045993",
+    "source_artifacts": [
+      {
+        "path": "src/smart/view/index.js",
+        "sha256": "1ea30c79b3935c00ede4d82f563699baba315e833488c63ddbc7c2f3462a7a36"
+      },
+      {
+        "path": "src/core/contracts/ports/simai.dataview-port/1.5.0/port.json",
+        "sha256": "14f3396aaa0fb7500d2f65c8be70d8239c92f098c88d3d3cdf14b295ddeb0a18"
+      },
+      {
+        "path": "src/smart/view/docs.md",
+        "sha256": "6fbe4b18a496ce87e6c65f0bab96e1aa657718929a0b29796ef5c0232ceb4fd5"
+      },
+      {
+        "path": "tests/fixtures/data-view-composite-lab.html",
+        "sha256": "59537317fe4742778c5987ec1f305e85fd6a003293032777d1bbd0b61992a0d8"
+      },
+      {
+        "path": "src/smart/view/js/tree.js",
+        "sha256": "800ce7a5fe2ca9681b4dc4cd283055bf815b0346aec4bb5e9df40189c682e2c4"
+      },
+      {
+        "path": "src/smart/view/js/first-paint.css",
+        "sha256": "059abccc0b441cc33602d9677efc57d7cf372e7f94b76ca3421f17cf60accccc"
+      }
+    ],
+    "generated_runtime": []
+  },
+  "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>"
+    ]
+  }
+}