@pgcorp/ui-kit 0.9.0 → 0.10.0

package/README.md

@@ -6,7 +6,7 @@
 **A typed PGCorp design system for Vue 3, spanning foundational controls and
 complete workbench interfaces.**
 
-`Vue 3` · `TypeScript` · `122 exact exports` · `6 themes` · `MIT`
+`Vue 3` · `TypeScript` · `exact public exports` · `6 themes` · `MIT`
 
 ## Что входит / What is included
 
@@ -26,22 +26,23 @@ complete workbench interfaces.**
 ## Установка / Installation
 
 ```bash
-npm install @pgcorp/ui-kit vue pinia vue-router
+npm install @pgcorp/ui-kit @vue/devtools-api vue pinia vue-router
 ```
 
 | Требование / Requirement | Версия / Version |
 | --- | --- |
-| Node.js | `>=20.19.0` |
+| Node.js | `^22.22.2 \|\| ^24.15.0 \|\| ^26.0.0` |
 | npm | `>=10.9.2 <12` |
-| Vue | `^3.5.0` |
-| Pinia | `^3.0.4` |
-| Vue Router | `^5.0.0` |
+| Vue | `^3.5.43` |
+| Pinia | `^4.0.3` |
+| Vue Devtools API | `^8.2.1` |
+| Vue Router | `^5.3.1` |
 | Build tool | Vite with Vue SFC support |
 
-`vue`, `pinia` и `vue-router` являются peer dependencies. Consumer-приложение
+`vue`, `pinia`, `@vue/devtools-api` и `vue-router` являются peer dependencies. Consumer-приложение
 владеет их единственными runtime-экземплярами.
 
-`vue`, `pinia`, and `vue-router` are peer dependencies. The consumer application
+`vue`, `pinia`, `@vue/devtools-api`, and `vue-router` are peer dependencies. The consumer application
 owns their single runtime instances.
 
 ## Быстрый старт / Quick start
@@ -113,6 +114,120 @@ Production build должен разрешать package exports напряму
 The production build must resolve package exports directly, without a source
 monorepo alias or copied UI-kit files.
 
+### Локализация / Localization
+
+UI-kit поддерживает `en`, `ru`, `zh-CN` и `zh-TW`. Без provider используется
+`ru`; `SUiKitLocaleProvider` задаёт локаль для одного Vue subtree и не создаёт
+дополнительный DOM-элемент. / The UI kit supports `en`, `ru`, `zh-CN`, and
+`zh-TW`. Without a provider it uses `ru`; `SUiKitLocaleProvider` selects a
+locale for one Vue subtree without adding a DOM element.
+
+```vue
+<script setup lang="ts">
+import SUiKitLocaleProvider from '@pgcorp/ui-kit/shared/containers/SUiKitLocaleProvider.vue'
+import type { UiKitLocale } from '@pgcorp/ui-kit/composables/useUiKitLocale'
+
+const locale: UiKitLocale = 'en'
+</script>
+
+<template>
+  <SUiKitLocaleProvider :locale="locale">
+    <AppWorkspace />
+  </SUiKitLocaleProvider>
+</template>
+```
+
+Provider переводит только kit-owned visible/assistive copy. Доменные данные и
+пользовательский контент остаются ответственностью consumer. Вложенные provider
+наследуют ближайший context и принимают типизированный `messages` override. /
+The provider translates kit-owned visible and assistive copy only. Domain data
+and user content remain consumer-owned. Nested providers inherit the nearest
+context and accept a typed `messages` override.
+
+### Уведомления / Notifications
+
+`SControlledToastViewport` отображает readonly application records и возвращает
+serializable `dismiss`, `action` и `lifetime-expired` intents. Consumer остаётся
+владельцем массива, порядка, ID и durable history. Режим `consumer` не создаёт
+таймеры; режим `viewport` управляет только presentation lifetime и ставит его на
+паузу при hover/focus. / `SControlledToastViewport` renders readonly application
+records and emits serializable `dismiss`, `action`, and `lifetime-expired`
+intents. The consumer owns the array, ordering, IDs, and durable history. The
+`consumer` mode creates no timers; the `viewport` mode owns presentation
+lifetime only and pauses it on hover/focus.
+
+```ts
+import type { SToastPresentation } from '@pgcorp/ui-kit/shared/data-display/toast'
+import SControlledToastViewport from '@pgcorp/ui-kit/shared/data-display/SControlledToastViewport.vue'
+```
+
+`SToastContainer` и `useNotifier` образуют автономный convenience-контракт для
+одного Pinia root. Store хранит не более 100 history records и освобождает свои
+таймеры через `$dispose()`/`$reset()`. / `SToastContainer` and `useNotifier`
+provide the autonomous convenience contract for one Pinia root. The store keeps
+at most 100 history records and releases its timers through `$dispose()`/`$reset()`.
+
+### Безопасные rich documents / Safe rich documents
+
+`SRichDocument` отображает закрытую versioned `SRichDocumentV1` AST без raw
+HTML, VNodes, callbacks и trust flags. Внешний JSON проверяется через
+`validateRichDocument` и `validateRichDocumentResources`; ошибки содержат
+stable code и точный node path. Consumer-owned resources связываются по ID, а
+link/resource/action effects возвращаются как typed intents. Link-node с
+`current: true` выражает текущее назначение через `aria-current="page"`.
+
+`SRichDocument` renders the closed, versioned `SRichDocumentV1` AST without raw
+HTML, VNodes, callbacks, or trust flags. External JSON is checked with
+`validateRichDocument` and `validateRichDocumentResources`; failures include a
+stable code and exact node path. Consumer-owned resources are joined by ID, and
+link/resource/action effects are emitted as typed intents. A link node with
+`current: true` exposes the current destination through `aria-current="page"`.
+
+```ts
+import SRichDocument from '@pgcorp/ui-kit/shared/data-display/SRichDocument.vue'
+import {
+  validateRichDocument,
+  validateRichDocumentResources,
+  type SRichDocumentV1,
+} from '@pgcorp/ui-kit/shared/data-display/richDocument'
+```
+
+Code highlighting and KaTeX load through local lazy chunks; SSR uses safe text
+fallbacks. Полный security, resource, event и versioning contract описан в
+[`docs/rich-document.md`](https://github.com/pglyanenko/sputnig/blob/master/packages/ui-kit/docs/rich-document.md). / The complete security,
+resource, event, and versioning contract is documented in
+[`docs/rich-document.md`](https://github.com/pglyanenko/sputnig/blob/master/packages/ui-kit/docs/rich-document.md).
+
+### Области прокрутки / Scroll viewports
+
+`SScrollViewport` владеет именованной scroll region, осями `x`/`y`/`both`,
+semantic block size, overscroll policy и root-only keyboard navigation.
+Событие `scroll-state` возвращает normalized physical и writing-mode-aware
+semantic offsets. Exposed API предоставляет `focus`, `scrollToBoundary` и
+`reveal`, но не открывает DOM owner.
+
+`SScrollViewport` owns a named scroll region, `x`/`y`/`both` axes, semantic
+block size, overscroll policy, and root-only keyboard navigation. The
+`scroll-state` event provides normalized physical and writing-mode-aware
+semantic offsets. Its exposed API provides `focus`, `scrollToBoundary`, and
+`reveal` without exposing the DOM owner.
+
+```ts
+import SScrollViewport from '@pgcorp/ui-kit/shared/data-display/SScrollViewport.vue'
+import type {
+  SScrollViewportApi,
+  SScrollViewportState,
+} from '@pgcorp/ui-kit/shared/data-display/scrollViewport'
+```
+
+Вложенные inputs, editors и terminals сохраняют собственную клавиатуру,
+selection и native copy. Полный axes, state, API и lifecycle contract описан в
+[`docs/scroll-viewport.md`](https://github.com/pglyanenko/sputnig/blob/master/packages/ui-kit/docs/scroll-viewport.md). /
+Nested inputs, editors, and terminals retain their keyboard behavior,
+selection, and native copy. The complete axes, state, API, and lifecycle
+contract is documented in
+[`docs/scroll-viewport.md`](https://github.com/pglyanenko/sputnig/blob/master/packages/ui-kit/docs/scroll-viewport.md).
+
 ## Карта компонентов / Component map
 
 | Группа / Group | Назначение / Purpose | Примеры exports / Example exports |
@@ -120,7 +235,7 @@ monorepo alias or copied UI-kit files.
 | Layout | App shell, dock regions, stacks, workbench layout | `layout/SAppShell.vue`, `layout/SStack.vue`, `layout/SWorkbenchLayout.vue` |
 | Controls | Buttons, fields, inputs, switches, selects, comboboxes, menus | `shared/controls/SButton.vue`, `shared/controls/SSwitch.vue`, `shared/controls/SCombobox.vue` |
 | Containers | Panels, modal, drawer, popover, sidebars | `shared/containers/SPanel.vue`, `shared/containers/SModal.vue`, `shared/containers/SPopover.vue` |
-| Data display | Tables, charts, metric cards, chips, status, progress, code, JSON, tooltips | `shared/data-display/STable.vue`, `shared/data-display/SChart.vue`, `shared/data-display/SMetricCard.vue` |
+| Data display | Tables, charts, metric cards, scroll regions, chips, status, progress, code, JSON, tooltips | `shared/data-display/STable.vue`, `shared/data-display/SChart.vue`, `shared/data-display/SScrollViewport.vue` |
 | Navigation | Tabs, breadcrumbs, catalog navigation, wizard | `shared/navigation/STabs.vue`, `shared/navigation/SBreadcrumbs.vue`, `shared/navigation/SWizardSteps.vue` |
 | Complex surfaces | Tree, Kanban, data grid, SQL editor, graph | `shared/complex/STree.vue`, `shared/database/SDataGrid.vue`, `shared/graph/SGraphViewport.vue` |
 | Runtime | Themes, variants, icons, composables, stores | `theme`, `variants`, `icons`, `composables/useNotifier`, `stores/useNotifierStore` |
@@ -264,6 +379,70 @@ already labelled card uses `accessibility.mode="decorative"` with
 `data-table-presentation="none"`; a meaningful standalone chart keeps the
 default assistive data table.
 
+### Сравнение исходников / Source diff
+
+`SDiffViewer` является semantic owner для exact-text diff. `before.text` и
+`after.text` сравниваются без нормализации переводов строк или содержимого;
+`label`, `revision` и `language` являются metadata. `layout="unified"` сохраняет
+единый горизонтальный scroll для длинных строк, `layout="split"` показывает
+равные колонки с переносом кода. `viewport` использует те же semantic размеры,
+что и code surfaces.
+
+`SDiffViewer` is the semantic owner for exact-text diff. `before.text` and
+`after.text` are compared without newline or payload normalization; `label`,
+`revision`, and `language` are metadata. `layout="unified"` preserves one
+horizontal scroll surface for long lines, while `layout="split"` renders equal
+columns with wrapped code. `viewport` uses the same semantic sizes as the code
+surfaces.
+
+```ts
+import type {
+  SDiffResult,
+  SDiffSource,
+} from '@pgcorp/ui-kit/shared/data-display/diff'
+import SDiffViewer from '@pgcorp/ui-kit/shared/data-display/SDiffViewer.vue'
+```
+
+```vue
+<SDiffViewer
+  v-model:expanded-gap-ids="expandedGapIds"
+  :before="baseSource"
+  :after="currentSource"
+  :context-lines="3"
+  layout="split"
+  viewport="expanded"
+  aria-label="Изменения конфигурации"
+  @computed="handleComputed"
+  @retry="handleRetry"
+/>
+```
+
+`contextLines` задаёт число видимых неизменённых строк вокруг каждого hunk.
+Без `expandedGapIds` компонент владеет раскрытием gap; с
+`v-model:expanded-gap-ids` consumer применяет intent как controlled state.
+`computed` передаёт валидированный `SDiffResult`, `retry` сообщает о повторном
+запуске после ошибки. Для синхронного вычисления вне интерактивной поверхности
+экспортируется `computeDiff(before, after, options)`.
+
+`contextLines` selects the unchanged lines around each hunk. Without
+`expandedGapIds`, the component owns gap expansion; with
+`v-model:expanded-gap-ids`, the consumer applies expansion intents as controlled
+state. `computed` provides a validated `SDiffResult`, and `retry` reports a
+retry after an error. `computeDiff(before, after, options)` is exported for
+synchronous computation outside an interactive surface.
+
+Строки виртуализируются независимо от размера source. Дорогие интерактивные
+вычисления выполняются через управляемый worker: смена source отменяет и
+освобождает прежнюю работу, unmount освобождает активный worker, а результат
+неактуального поколения не попадает в UI. Consumer не создаёт worker и не
+управляет его жизненным циклом.
+
+Lines are virtualized independently of source size. Expensive interactive
+computations use a managed worker: source replacement cancels and releases the
+previous job, unmount releases the active worker, and stale-generation results
+never reach the UI. Consumers neither create the worker nor manage its
+lifecycle.
+
 ### Действия chip и адаптивный header панели / Chip actions and responsive panel header
 
 `SChip` принимает typed `surface` contract для статичного, action и link

package/docs/getting-started.md

@@ -39,6 +39,94 @@ import App from './App.vue'
 createApp(App).use(createPinia()).use(router).mount('#app')
 ```
 
+### Локаль UI-kit
+
+Без provider UI-kit использует `ru`. Для локали конкретного Vue subtree
+оберните его в DOM-less `SUiKitLocaleProvider`. Поддерживаются `en`, `ru`,
+`zh-CN` и `zh-TW`:
+
+```vue
+<script setup lang="ts">
+import SUiKitLocaleProvider from '@pgcorp/ui-kit/shared/containers/SUiKitLocaleProvider.vue'
+import type { UiKitLocale } from '@pgcorp/ui-kit/composables/useUiKitLocale'
+
+const locale: UiKitLocale = 'en'
+</script>
+
+<template>
+  <SUiKitLocaleProvider :locale="locale">
+    <AppWorkspace />
+  </SUiKitLocaleProvider>
+</template>
+```
+
+Provider локализует только текст, принадлежащий UI-kit: labels controls,
+assistive names, loading/empty copy и системные UI-сообщения. Доменные данные,
+заголовки экранов и пользовательский контент передаются consumer-ом уже на
+нужном языке. Вложенный provider наследует locale и messages ближайшего
+родителя; prop `messages` принимает типизированный deep-partial override для
+своего subtree. Неизвестная locale, неизвестный ключ override или неверные
+параметры интерполяции завершаются явной диагностикой.
+
+### Controlled-уведомления
+
+`SControlledToastViewport` принимает readonly-массив сериализуемых records.
+Consumer владеет ID, порядком, application state и durable history; viewport не
+изменяет входной массив. Действия records содержат только ID, label и appearance,
+без callback-полей.
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import SControlledToastViewport from '@pgcorp/ui-kit/shared/data-display/SControlledToastViewport.vue'
+import type {
+  SToastActionIntent,
+  SToastDismissIntent,
+  SToastPresentation,
+} from '@pgcorp/ui-kit/shared/data-display/toast'
+
+const notifications = ref<readonly SToastPresentation[]>([
+  {
+    id: 'sync-ready',
+    severity: 'success',
+    title: 'Синхронизация завершена',
+    message: 'Данные рабочего пространства обновлены.',
+    actions: [{ id: 'open', label: 'Открыть', appearance: 'outline' }],
+  },
+])
+const selectedAction = ref<SToastActionIntent | null>(null)
+
+function dismiss(intent: SToastDismissIntent): void {
+  notifications.value = notifications.value.filter(({ id }) => id !== intent.id)
+}
+
+function act(intent: SToastActionIntent): void {
+  selectedAction.value = intent
+}
+</script>
+
+<template>
+  <SControlledToastViewport
+    :notifications="notifications"
+    accessible-label="Системные уведомления"
+    lifetime-owner="consumer"
+    position="top-end"
+    @dismiss="dismiss"
+    @action="act"
+  />
+</template>
+```
+
+`lifetime-owner="consumer"` не создаёт auto-dismiss timers. В режиме
+`viewport` record задаёт `durationMs`; истечение эмитит `lifetime-expired`, а
+consumer удаляет record. Hover и focus приостанавливают оставшееся время.
+Удаление record и unmount очищают связанные timers.
+
+Для автономного сценария разместите `SToastContainer` один раз в app root и
+вызывайте `useNotifier`. Его store принадлежит конкретному Pinia root, хранит
+100 последних history records и очищает timers при `$dispose()` или `$reset()`.
+Не создавайте локальную копию notifier store с тем же Pinia ID.
+
 Каждый компонент импортируется через точный публичный subpath:
 
 ```ts
@@ -94,6 +182,53 @@ import App from './App.vue'
 createApp(App).use(createPinia()).use(router).mount('#app')
 ```
 
+### UI-kit locale
+
+Without a provider, the UI kit uses `ru`. Wrap a Vue subtree in the DOM-less
+`SUiKitLocaleProvider` to select its locale. Supported locales are `en`, `ru`,
+`zh-CN`, and `zh-TW`:
+
+```vue
+<script setup lang="ts">
+import SUiKitLocaleProvider from '@pgcorp/ui-kit/shared/containers/SUiKitLocaleProvider.vue'
+import type { UiKitLocale } from '@pgcorp/ui-kit/composables/useUiKitLocale'
+
+const locale: UiKitLocale = 'en'
+</script>
+
+<template>
+  <SUiKitLocaleProvider :locale="locale">
+    <AppWorkspace />
+  </SUiKitLocaleProvider>
+</template>
+```
+
+The provider localizes UI-kit-owned copy only: control labels, assistive names,
+loading and empty copy, and system UI messages. Domain data, screen titles, and
+user content are supplied by the consumer in the required language. A nested
+provider inherits the nearest parent's locale and messages; the `messages` prop
+accepts a typed deep-partial override for that subtree. An unknown locale,
+unknown override key, or invalid interpolation parameters fail with an explicit
+diagnostic.
+
+### Controlled notifications
+
+`SControlledToastViewport` accepts a readonly array of serializable records.
+The consumer owns IDs, ordering, application state, and durable history; the
+viewport never mutates the input array. Record actions contain IDs, labels, and
+an optional appearance without callback fields.
+
+Use `lifetime-owner="consumer"` when the application owns expiry; this mode
+creates no auto-dismiss timers. In `viewport` mode, a record supplies
+`durationMs`, expiry emits `lifetime-expired`, and the consumer removes the
+record. Hover and focus pause the remaining duration. Record removal and
+component unmount release associated timers.
+
+For the autonomous path, mount `SToastContainer` once at the application root
+and call `useNotifier`. Its store belongs to one Pinia root, retains 100 history
+records, and clears timers on `$dispose()` or `$reset()`. Do not create a local
+notifier store with the same Pinia ID.
+
 Import every component through an exact public subpath:
 
 ```ts

package/docs/public-api.md

@@ -13,7 +13,7 @@
 - `shared/data-display/*` — badges, tables, code, JSON, progress, status и tooltips;
 - `shared/navigation/*` — tabs, breadcrumbs, catalog navigation и wizard steps;
 - `shared/database/*`, `shared/graph/*`, `shared/persona/*` — доменные сложные поверхности;
-- `composables/*`, `stores/*`, `theme`, `variants`, `icons` — typed runtime modules;
+- `composables/*`, `stores/*`, `theme`, `variants`, `icons` — typed runtime modules, включая locale context;
 - `tailwind.css` — полный Tailwind 4 integration entrypoint;
 - `style.css`, `tokens.css`, `reference.css` — global styles, token-only и compile-time reference entrypoints.
 
@@ -27,7 +27,12 @@ compiler регистрирует их без межфайлового filesyste
 Публикуемый production-source компилируется с `target/lib: ES2020`, совпадающим
 с baseline `@vue/tsconfig/tsconfig.dom.json`, и не требует скрытых полифиллов.
 Типы таблицы импортируются из `shared/data-display/table`, типы графиков — из
-`shared/data-display/chart`. `SChart` объединяет line/area/bar/pie/donut,
+`shared/data-display/chart`, типы и чистая функция diff — из
+`shared/data-display/diff`. `SDiffViewer` принимает exact-text snapshots,
+показывает unified/split представление, виртуализирует строки и управляет
+вычислением в worker для больших входов. Смена source и unmount отменяют
+неактуальную работу; завершившийся устаревший результат не публикуется.
+`SChart` объединяет line/area/bar/pie/donut,
 responsive geometry, semantic palette и доступную таблицу данных. `SMetricCard`
 принимает компактный график через `#chart`. `SCodeBlock` сохраняет CodeMirror за
 async boundary; `presentation="plain"` является lightweight read-only контрактом
@@ -37,6 +42,25 @@ async boundary; `presentation="plain"` является lightweight read-only к
 `SActionListItem` держат primary activation и дополнительные controls
 sibling-элементами внутри одного chrome; `actionsLayout`/`trailingLayout`
 управляют inline, stacked и container-responsive раскладкой.
+`SUiKitLocaleProvider` задаёт `en | ru | zh-CN | zh-TW` для одного Vue subtree,
+а `composables/useUiKitLocale` экспортирует readonly context, полный список
+локалей и типы messages/overrides/ключей. Provider не создаёт DOM owner и
+поддерживает независимые локали в соседних app roots.
+`shared/data-display/SControlledToastViewport.vue` является controlled owner
+стека уведомлений; `shared/data-display/toast` экспортирует presentation records,
+action/dismiss/lifetime intents, position и lifetime types. `SToastContainer`
+является adapter над `stores/useNotifierStore`, а не вторым layout owner.
+`shared/data-display/SRichDocument.vue` отображает только валидированную
+`SRichDocumentV1` AST. `shared/data-display/richDocument` экспортирует закрытую
+модель, consumer-owned resource records, typed intents и validators со stable
+error code/path. Link-node поддерживает `current: true` для
+`aria-current="page"`. Raw HTML, VNodes, callbacks и trust flags не входят в
+API.
+`shared/data-display/SScrollViewport.vue` владеет accessible scroll region,
+разрешёнными осями, semantic block size, root-only keyboard navigation и
+ResizeObserver lifecycle. `shared/data-display/scrollViewport` экспортирует
+сериализуемое physical/semantic state и exposed API `focus`,
+`scrollToBoundary`, `reveal` без доступа к внутреннему DOM.
 
 ## English
 
@@ -51,7 +75,7 @@ Primary groups:
 - `shared/data-display/*` — badges, tables, code, JSON, progress, status, and tooltips;
 - `shared/navigation/*` — tabs, breadcrumbs, catalog navigation, and wizard steps;
 - `shared/database/*`, `shared/graph/*`, `shared/persona/*` — complex domain surfaces;
-- `composables/*`, `stores/*`, `theme`, `variants`, `icons` — typed runtime modules;
+- `composables/*`, `stores/*`, `theme`, `variants`, `icons` — typed runtime modules, including locale context;
 - `tailwind.css` — the complete Tailwind 4 integration entrypoint;
 - `style.css`, `tokens.css`, `reference.css` — global styles, token-only, and compile-time reference entrypoints.
 
@@ -65,7 +89,12 @@ compiler registers them without a cross-file filesystem type resolver.
 Published production source compiles with the `target/lib: ES2020` baseline from
 `@vue/tsconfig/tsconfig.dom.json` and does not require implicit polyfills.
 Table types are imported from `shared/data-display/table`; chart types are
-imported from `shared/data-display/chart`. `SChart` unifies
+imported from `shared/data-display/chart`; diff types and its pure computation
+function are imported from `shared/data-display/diff`. `SDiffViewer` accepts
+exact-text snapshots, renders unified or split presentation, virtualizes lines,
+and manages worker computation for large inputs. Source replacement and unmount
+cancel obsolete work, and a completed stale result is never published.
+`SChart` unifies
 line/area/bar/pie/donut charts, responsive geometry, the semantic palette, and
 an accessible data table. `SMetricCard` accepts a compact chart through
 `#chart`. `SCodeBlock` keeps CodeMirror behind an async boundary;
@@ -76,3 +105,23 @@ the editor runtime. `SChip.surface` owns action/link semantics, while
 compositions keep primary activation and additional controls as siblings inside
 one chrome; `actionsLayout`/`trailingLayout` control inline, stacked, and
 container-responsive layout.
+`SUiKitLocaleProvider` selects `en | ru | zh-CN | zh-TW` for one Vue subtree,
+while `composables/useUiKitLocale` exports the readonly context, the complete
+locale list, and message/override/key types. The provider renders no DOM owner
+and supports independent locales in adjacent application roots.
+`shared/data-display/SControlledToastViewport.vue` is the controlled owner of
+the notification stack; `shared/data-display/toast` exports presentation
+records, action/dismiss/lifetime intents, positions, and lifetime types.
+`SToastContainer` is an adapter over `stores/useNotifierStore`, not a second
+layout owner.
+`shared/data-display/SRichDocument.vue` renders validated `SRichDocumentV1` AST
+only. `shared/data-display/richDocument` exports the closed model,
+consumer-owned resource records, typed intents, and validators with stable
+error code/path diagnostics. Link nodes support `current: true` for
+`aria-current="page"`. Raw HTML, VNodes, callbacks, and trust flags are not part
+of the API.
+`shared/data-display/SScrollViewport.vue` owns the accessible scroll region,
+enabled axes, semantic block size, root-only keyboard navigation, and
+ResizeObserver lifecycle. `shared/data-display/scrollViewport` exports
+serializable physical and semantic state plus the `focus`, `scrollToBoundary`,
+and `reveal` exposed API without access to internal DOM.