@soxa-ui/vue 0.0.0-stage → 0.3.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuri Soldatov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,153 @@
-# Temporary Holding Version
+# @soxa-ui/vue
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**The Vue adapter: Soxa UI components rendered on the headless models of the core.**
+
+Part of [Soxa UI](https://github.com/youra-h/soxa-ui) — UI components with the logic written once: a
+framework-agnostic core and thin adapters that render it in Vue, React, Angular, Svelte, Solid and
+Web Components.
+
+The adapter is wiring, not behavior: it connects a core model to Vue's reactivity and renders the
+markup — BEM classes `so-*` and `data-*` state attributes. Props, events and slots come from the
+component descriptor, so they match the other five adapters; only the spelling is Vue's.
+
+## Install
+
+```bash
+npm install @soxa-ui/vue @soxa-ui/setup @soxa-ui/theme-oren @soxa-ui/icons-material
+```
+
+Install `@soxa-ui/setup` as a direct dependency for the `useIcons` and `useTheme` imports below.
+Keep it on the same version as `@soxa-ui/vue`.
+
+Vue `^3.5` is a peer dependency. A theme and an icon pack are separate packages — pick the ones you
+want.
+
+## Usage
+
+Compound components name their parts with a dot:
+
+```vue
+<script setup lang="ts">
+import { Accordion } from '@soxa-ui/vue'
+</script>
+
+<template>
+  <Accordion mode="multiple">
+    <Accordion.Item text="First" value="a" :selected="true">
+      <p>Content A</p>
+    </Accordion.Item>
+    <Accordion.Item text="Second" value="b">
+      <p>Content B</p>
+    </Accordion.Item>
+  </Accordion>
+</template>
+```
+
+The same component can be driven from code — pass a core instance as `ctrl`, and both sides see the
+same state and events:
+
+```vue
+<script setup lang="ts">
+import { TButton } from '@soxa-ui/core'
+import { Button } from '@soxa-ui/vue'
+
+const btn = new TButton({ text: 'Save' })
+</script>
+
+<template>
+  <Button :ctrl="btn" @action:press="btn.disabled = true" />
+</template>
+```
+
+The application plugs in a theme and an icon pack once:
+
+```ts
+import { createApp } from 'vue'
+import { useIcons, useTheme } from '@soxa-ui/setup'
+import * as material from '@soxa-ui/icons-material'
+import oren from '@soxa-ui/theme-oren/setup'
+import App from './App.vue'
+
+import '@soxa-ui/theme-oren'
+
+useIcons(material)
+useTheme(oren)
+
+createApp(App).mount('#app')
+```
+
+`@soxa-ui/theme-oren` is the stylesheet of every component. To take only the components your
+pages use, import their stylesheets instead — `@soxa-ui/theme-oren/button.css`,
+`@soxa-ui/theme-oren/select.css`, one per component, each with the shared part of the theme
+(the theme's README, [Only the components you use](https://github.com/youra-h/soxa-ui/tree/main/packages/themes/oren#only-the-components-you-use)).
+
+## Two-way binding
+
+Use named `v-model` bindings with the property you want to control: `v-model:value` for a field's
+value, `v-model:open` for a panel's open state, or `v-model:selected` for an item's selection.
+A component can have several bindings at once:
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { Input, Select } from '@soxa-ui/vue'
+
+const text = ref('')
+const selection = ref('a')
+const opened = ref(false)
+const options = [
+  { value: 'a', text: 'First' },
+  { value: 'b', text: 'Second' },
+]
+</script>
+
+<template>
+  <Input v-model:value="text" />
+  <Select v-model:value="selection" v-model:open="opened" :items="options" />
+</template>
+```
+
+`v-model:value="text"` is shorthand for `:value="text"` and `@update:value="text = $event"`.
+The same rule applies to other writable properties with change notifications: each uses
+`update:<property>` with the new value as its payload.
+
+Bare `v-model` is unsupported: Vue expands it to `modelValue` and `update:modelValue`, which
+Soxa components do not expose. Always specify the property name.
+
+## Several Vue apps on one page
+
+Soxa builds the `id`s of component parts and the owner marks of panels (`data-owner`) on Vue's
+`useId`, so that the server and the browser render the same markup. `useId` numbers ids within an
+app, and when a page runs several Vue apps — islands, micro-frontends — their ids coincide: a menu,
+popover or dialog of one app then finds the panel of another. Give each app a prefix of its own
+before it mounts — on the server too, if the app is rendered there:
+
+```ts
+app.config.idPrefix = 'cart'
+```
+
+## Documentation
+
+- [Soxa UI README](https://github.com/youra-h/soxa-ui#readme) — the component set and what each
+  adapter implements so far.
+- [Architecture overview](https://github.com/youra-h/soxa-ui/blob/main/docs/architecture.md) —
+  layers, descriptors, plugins, collections, adapters.
+
+## Public API
+
+The package entry exports application components, their consumer types, the locale provider,
+and the supported icon and toast helpers. Component props, slots, events, refs and core models
+passed through `ctrl` remain the supported ways to customize the UI. Models come from
+`@soxa-ui/core`; theme, icon and external-plugin registration comes from `@soxa-ui/setup`.
+
+Assembly functions, adapter profiles, bindings, generated metadata and rendering templates
+are private implementation details. They are no longer exported from the package entry, and
+there is no public `/internal` entry. Code that imported them must use the component contract
+instead. Building a new adapter component from Soxa's assembly helpers is not a supported
+public SDK.
+
+Component props types, including `ButtonProps`, are available from the package entry.
+
+## License
+
+[MIT](https://github.com/youra-h/soxa-ui/blob/main/LICENSE)

package/dist/_virtual/_plugin-vue_export-helper.js

@@ -0,0 +1,8 @@
+//#region \0plugin-vue:export-helper
+var _plugin_vue_export_helper_default = (sfc, props) => {
+	const target = sfc.__vccOpts || sfc;
+	for (const [key, val] of props) target[key] = val;
+	return target;
+};
+//#endregion
+export { _plugin_vue_export_helper_default as default };

package/dist/adapter/common/createVueAdapterContext.d.ts

@@ -0,0 +1,36 @@
+import { createAdapterContext, type IAdapterContextConfig, type IAdapterContextOptions } from '@soxa-ui/setup';
+/**
+ * Опции и конфиг — те же, что у `createAdapterContext`: setup их экспортирует,
+ * и копии здесь больше нет. Имена оставлены прежними — их ждут компоненты.
+ */
+export type IVueAdapterContextOptions<TInstance extends object> = IAdapterContextOptions<TInstance>;
+export type IVueAdapterContextConfig = IAdapterContextConfig;
+/**
+ * Обёртка над `createAdapterContext` из `@soxa-ui/setup`, единственное место,
+ * где Vue-компонентам нужен `toRaw`. Снимает прокси с `ctrl` и со значений
+ * верхнего уровня `options` (в частности, `engine` коллекционного контекста)
+ * перед тем, как отдать их ядру, которое `vue` не импортирует и о прокси не
+ * знает. Имя `engine` обёртке знать не нужно: `toRaw` на значении без прокси
+ * ничего не меняет.
+ *
+ * Цепочка `.use(...)` остаётся на месте вызова, как и раньше — набора
+ * расширений по умолчанию обёртка не собирает (см. AGENTS.md, «Vue collection
+ * setup»).
+ *
+ * Здесь же — id монтирования (`mountId`) от `useId`: от него плагины строят
+ * `id` частей. Счётчик процесса на сервере общий для всех запросов, и `id` от
+ * него расходились бы при гидратации, а `useId` Vue выводит из места
+ * компонента в дереве. Обёртку зовёт `setup()` компонента, поэтому у `useId`
+ * есть текущий компонент. Id монтирования, заданный опцией явно, остаётся за
+ * тем, кто его задал.
+ *
+ * Там же — локаль поддерева (`locale`): источник ближайшего `LocaleProvider`
+ * выше по дереву (`inject`). Провайдера нет — опция не задана, и у набора
+ * своя английская. Локаль, заданная опцией явно, тоже остаётся за тем, кто её
+ * задал.
+ *
+ * Сигнатура — сама `createAdapterContext`: своих параметров типа у обёртки
+ * нет, контракт контекста выводится из дескриптора там же, где и у остальных
+ * адаптеров.
+ */
+export declare const createVueAdapterContext: typeof createAdapterContext;

package/dist/adapter/common/createVueAdapterContext.js

@@ -0,0 +1,45 @@
+import { LOCALE_KEY } from "../locale/key.js";
+import { createAdapterContext } from "@soxa-ui/setup";
+import { inject, toRaw, useId } from "vue";
+//#region src/adapter/common/createVueAdapterContext.ts
+/** Снимает Vue-прокси со значений верхнего уровня объекта, не заглядывая внутрь. */
+function stripTopLevelProxies(value) {
+	return Object.fromEntries(Object.entries(value).map(([key, v]) => [key, toRaw(v)]));
+}
+/**
+* Обёртка над `createAdapterContext` из `@soxa-ui/setup`, единственное место,
+* где Vue-компонентам нужен `toRaw`. Снимает прокси с `ctrl` и со значений
+* верхнего уровня `options` (в частности, `engine` коллекционного контекста)
+* перед тем, как отдать их ядру, которое `vue` не импортирует и о прокси не
+* знает. Имя `engine` обёртке знать не нужно: `toRaw` на значении без прокси
+* ничего не меняет.
+*
+* Цепочка `.use(...)` остаётся на месте вызова, как и раньше — набора
+* расширений по умолчанию обёртка не собирает (см. AGENTS.md, «Vue collection
+* setup»).
+*
+* Здесь же — id монтирования (`mountId`) от `useId`: от него плагины строят
+* `id` частей. Счётчик процесса на сервере общий для всех запросов, и `id` от
+* него расходились бы при гидратации, а `useId` Vue выводит из места
+* компонента в дереве. Обёртку зовёт `setup()` компонента, поэтому у `useId`
+* есть текущий компонент. Id монтирования, заданный опцией явно, остаётся за
+* тем, кто его задал.
+*
+* Там же — локаль поддерева (`locale`): источник ближайшего `LocaleProvider`
+* выше по дереву (`inject`). Провайдера нет — опция не задана, и у набора
+* своя английская. Локаль, заданная опцией явно, тоже остаётся за тем, кто её
+* задал.
+*
+* Сигнатура — сама `createAdapterContext`: своих параметров типа у обёртки
+* нет, контракт контекста выводится из дескриптора там же, где и у остальных
+* адаптеров.
+*/
+var createVueAdapterContext = (descriptor, options, config) => createAdapterContext(descriptor, {
+	...options,
+	ctrl: options.ctrl !== void 0 ? toRaw(options.ctrl) : void 0,
+	options: options.options !== void 0 ? stripTopLevelProxies(options.options) : void 0,
+	mountId: options.mountId ?? useId(),
+	locale: options.locale ?? inject(LOCALE_KEY, void 0)
+}, config);
+//#endregion
+export { createVueAdapterContext };

package/dist/adapter/common/icon.d.ts

@@ -0,0 +1,2 @@
+import { type Component } from 'vue';
+export declare function roleIcon(role: string): Component;

package/dist/adapter/common/icon.js

@@ -0,0 +1,45 @@
+import { getIcon } from "@soxa-ui/setup";
+import { defineComponent, h, markRaw } from "vue";
+//#region src/adapter/common/icon.ts
+/**
+* Компонент иконки по роли из реестра.
+*
+* Иконка приходит данными (`{ viewBox, body }`), а разметку строит адаптер —
+* поэтому здесь `h()`, а не `template`. Разница не косметическая: `template`
+* требует рантайм-компилятор Vue, из-за чего в конфиге стоял алиас на полный
+* билд (`vue/dist/vue.esm-bundler.js`). То есть иконки навязывали лишний вес
+* каждому приложению и ломались при CSP без `unsafe-eval`.
+*
+* `innerHTML` вместо разбора `body` на узлы: содержимое иконки произвольно —
+* группы, маски, несколько путей. Источник доверенный (пакет из зависимостей),
+* пользовательский ввод сюда не попадает.
+*
+* Роль резолвится **на отрисовке**, а не при вызове: `useIcons()` может быть
+* вызван после того, как компонент уже создан.
+*
+* Компонент на роль один на модуль, как `roleIcon` у React: роль читается на
+* отрисовке, и определению нечего помнить о вызове. Новое определение на
+* каждый вызов умножалось бы на экземпляры — у чекбоксов таблицы на 5000
+* строк это 10 000 одинаковых компонентов. Это не composable: контекста
+* `setup()` он не требует и состояния не заводит, поэтому зовётся где угодно,
+* в том числе на уровне модуля.
+*/
+var icons = /* @__PURE__ */ new Map();
+function roleIcon(role) {
+	const known = icons.get(role);
+	if (known) return known;
+	const icon = markRaw(defineComponent({
+		name: `Icon_${role}`,
+		render() {
+			const source = getIcon(role);
+			return h("svg", {
+				viewBox: source.viewBox,
+				innerHTML: source.body
+			});
+		}
+	}));
+	icons.set(role, icon);
+	return icon;
+}
+//#endregion
+export { roleIcon };

package/dist/adapter/common/index.d.ts

@@ -0,0 +1,6 @@
+export { VueProfile } from './profile';
+export { VueNaming } from './naming';
+export * from './icon';
+export * from './useSplitAttrs';
+export * from './createVueAdapterContext';
+export type { SetupContext } from 'vue';

package/dist/adapter/common/naming.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Vue-стратегия именования props и событий.
+ *
+ * - props:  `styles` @ ns `icon-styles` → `iconStyles_styles` (общее правило)
+ * - events: `element:ready`             → `element:ready` (как в ядре)
+ *
+ * Имя события — `TName.getName()` без преобразований: двоеточия в emit
+ * допустимы. Своей копии формата `namespace:name` здесь нет — её пришлось бы
+ * менять вместе с `getName()`. То же решение, что в Web Components.
+ */
+import type { INamingStrategy } from '@soxa-ui/setup';
+export declare const VueNaming: INamingStrategy;

package/dist/adapter/common/naming.js

@@ -0,0 +1,8 @@
+import { underscorePropNaming } from "@soxa-ui/setup";
+//#region src/adapter/common/naming.ts
+var VueNaming = {
+	prop: underscorePropNaming,
+	event: (name) => name.getName()
+};
+//#endregion
+export { VueNaming };

package/dist/adapter/common/profile.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Профиль Vue: имена поверхности и событие `v-model`.
+ *
+ * Поверхность нужна компоненту дважды: при импорте модуля (`props` и `emits`
+ * Options API — `useProps`, `useEmits`) и на монтировании (связка
+ * `adapter.connect()`). Один профиль — одна поверхность на оба случая.
+ *
+ * `v-model` держится на `update:<prop>`: его объявляет поверхность, а
+ * эмитит связка, — у каждого записываемого пропа с триггерами, плагинные
+ * включительно (`update:anchor_anchor` у Frame).
+ */
+import type { IAdapterProfile } from '@soxa-ui/setup';
+export declare const VueProfile: IAdapterProfile;

package/dist/adapter/common/profile.js

@@ -0,0 +1,8 @@
+import { VueNaming } from "./naming.js";
+//#region src/adapter/common/profile.ts
+var VueProfile = {
+	naming: VueNaming,
+	model: (exportName) => `update:${exportName}`
+};
+//#endregion
+export { VueProfile };

package/dist/adapter/common/useSplitAttrs.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Разделяет fallthrough-атрибуты на две группы:
+ * - `containerAttrs` — class, style (на корневой контейнер)
+ * - `controlAttrs`  — всё остальное: события, aria-*, data-* (на интерактивный контрол)
+ */
+export declare function useSplitAttrs(): {
+    containerAttrs: import("vue").ComputedRef<Record<string, unknown>>;
+    controlAttrs: import("vue").ComputedRef<{
+        [x: string]: unknown;
+    }>;
+};

package/dist/adapter/common/useSplitAttrs.js

@@ -0,0 +1,24 @@
+import { computed, useAttrs } from "vue";
+//#region src/adapter/common/useSplitAttrs.ts
+/**
+* Разделяет fallthrough-атрибуты на две группы:
+* - `containerAttrs` — class, style (на корневой контейнер)
+* - `controlAttrs`  — всё остальное: события, aria-*, data-* (на интерактивный контрол)
+*/
+function useSplitAttrs() {
+	const attrs = useAttrs();
+	return {
+		containerAttrs: computed(() => {
+			const result = {};
+			if (attrs.class) result.class = attrs.class;
+			if (attrs.style) result.style = attrs.style;
+			return result;
+		}),
+		controlAttrs: computed(() => {
+			const { class: _, style: __, ...rest } = attrs;
+			return rest;
+		})
+	};
+}
+//#endregion
+export { useSplitAttrs };

package/dist/adapter/elevator/elevator.class.d.ts

@@ -0,0 +1,12 @@
+/**
+ * TVueElevator — реализация IContextElevator через Vue provide/inject.
+ *
+ * Наследует TElevator из @soxa-ui/setup (кэширование ключей).
+ * Ключевое ограничение: up()/down() должны вызываться синхронно
+ * внутри setup() UI-компонента.
+ */
+import { TElevator } from '@soxa-ui/setup';
+export declare class TVueElevator<T = any> extends TElevator<T> {
+    down(value: T): void;
+    up(): T | undefined;
+}

package/dist/adapter/elevator/elevator.class.js

@@ -0,0 +1,20 @@
+import { TElevator } from "@soxa-ui/setup";
+import { inject, provide } from "vue";
+//#region src/adapter/elevator/elevator.class.ts
+/**
+* TVueElevator — реализация IContextElevator через Vue provide/inject.
+*
+* Наследует TElevator из @soxa-ui/setup (кэширование ключей).
+* Ключевое ограничение: up()/down() должны вызываться синхронно
+* внутри setup() UI-компонента.
+*/
+var TVueElevator = class extends TElevator {
+	down(value) {
+		provide(this._key, value);
+	}
+	up() {
+		return inject(this._key, void 0);
+	}
+};
+//#endregion
+export { TVueElevator };

package/dist/adapter/elevator/factory.d.ts

@@ -0,0 +1,2 @@
+import type { TElevatorFactory } from '@soxa-ui/setup';
+export declare const VueElevatorFactory: TElevatorFactory;

package/dist/adapter/elevator/factory.js

@@ -0,0 +1,5 @@
+import { TVueElevator } from "./elevator.class.js";
+//#region src/adapter/elevator/factory.ts
+var VueElevatorFactory = (key) => new TVueElevator(key.name);
+//#endregion
+export { VueElevatorFactory };

package/dist/adapter/elevator/index.d.ts

@@ -0,0 +1,2 @@
+export { TVueElevator } from './elevator.class';
+export { VueElevatorFactory } from './factory';

package/dist/adapter/index.d.ts

@@ -0,0 +1,6 @@
+export * from './common';
+export * from './static';
+export * from './runtime';
+export * from './elevator';
+export * from './locale';
+export * from './toasts';

package/dist/adapter/locale/LocaleProvider.d.ts

@@ -0,0 +1,38 @@
+import type { TLocale } from '@soxa-ui/plugins';
+import { type TClosedComponent } from '../static';
+/** Пропсы провайдера: локаль поддерева. */
+export type LocaleProviderProps = {
+    /** Локаль поддерева: тег для Intl и строки библиотеки (`ruRU`, `extendLocale(...)`) */
+    locale: TLocale;
+};
+/**
+ * Объектом опций, а не функцией `setup`: опции `expose` форма с функцией не
+ * принимает, а она у провайдера та же, что у компонентов (`useExpose`). Тип
+ * пропсов — аргументом `defineComponent`: опция `props` — список имён, и тип
+ * из неё был бы `any`.
+ */
+declare const LocaleProviderComponent: import("vue").DefineComponent<LocaleProviderProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<LocaleProviderProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+/**
+ * LocaleProvider — локаль поддерева: язык и строки библиотеки компонентам
+ * внутри.
+ *
+ * ```vue
+ * <LocaleProvider :locale="current">
+ * 	<RouterView />
+ * </LocaleProvider>
+ * ```
+ *
+ * Источник локали (`TLocaleSource`) у провайдера свой: он создаётся с
+ * провайдером и уходит детям через `provide`, а сборка каждого компонента
+ * отдаёт его набору плагинов. Сменили проп — провайдер пишет новую локаль в
+ * источник, и плагины языка и имён переписывают компонентам тег и имена на
+ * лету, без перемонтирования. Источник один на провайдер, а не на процесс:
+ * сервер рисует параллельные запросы каждый на своём языке, а вложенный
+ * провайдер даёт поддереву свой. Без провайдера компоненты — на английском.
+ *
+ * Провайдер — механизм фреймворка (`provide`, `watch`), поэтому он в
+ * адаптерном слое, а не среди компонентов. Своей разметки у него нет:
+ * рисует он только содержимое. Экземпляр снаружи закрыт, как у компонентов.
+ */
+export declare const LocaleProvider: TClosedComponent<typeof LocaleProviderComponent>;
+export {};

package/dist/adapter/locale/LocaleProvider.js

@@ -0,0 +1,41 @@
+import { LOCALE_KEY } from "./key.js";
+import { useExpose } from "../static/useExpose.js";
+import { defineComponent, provide, watch } from "vue";
+import { TLocaleSource } from "@soxa-ui/plugins";
+/**
+* LocaleProvider — локаль поддерева: язык и строки библиотеки компонентам
+* внутри.
+*
+* ```vue
+* <LocaleProvider :locale="current">
+* 	<RouterView />
+* </LocaleProvider>
+* ```
+*
+* Источник локали (`TLocaleSource`) у провайдера свой: он создаётся с
+* провайдером и уходит детям через `provide`, а сборка каждого компонента
+* отдаёт его набору плагинов. Сменили проп — провайдер пишет новую локаль в
+* источник, и плагины языка и имён переписывают компонентам тег и имена на
+* лету, без перемонтирования. Источник один на провайдер, а не на процесс:
+* сервер рисует параллельные запросы каждый на своём языке, а вложенный
+* провайдер даёт поддереву свой. Без провайдера компоненты — на английском.
+*
+* Провайдер — механизм фреймворка (`provide`, `watch`), поэтому он в
+* адаптерном слое, а не среди компонентов. Своей разметки у него нет:
+* рисует он только содержимое. Экземпляр снаружи закрыт, как у компонентов.
+*/
+var LocaleProvider = defineComponent({
+	name: "LocaleProvider",
+	props: ["locale"],
+	expose: useExpose(),
+	setup(props, { slots }) {
+		const source = new TLocaleSource(props.locale);
+		provide(LOCALE_KEY, source);
+		watch(() => props.locale, (locale) => {
+			source.locale = locale;
+		});
+		return () => slots.default?.();
+	}
+});
+//#endregion
+export { LocaleProvider };

package/dist/adapter/locale/index.d.ts

@@ -0,0 +1,2 @@
+export { LocaleProvider } from './LocaleProvider';
+export type { LocaleProviderProps } from './LocaleProvider';

package/dist/adapter/locale/key.d.ts

@@ -0,0 +1,7 @@
+import type { InjectionKey } from 'vue';
+import type { ILocaleSource } from '@soxa-ui/plugins';
+/**
+ * Ключ локали поддерева: под ним `LocaleProvider` отдаёт детям свой источник,
+ * а сборка компонента (`createVueAdapterContext`) берёт ближайший.
+ */
+export declare const LOCALE_KEY: InjectionKey<ILocaleSource>;

package/dist/adapter/locale/key.js

@@ -0,0 +1,8 @@
+//#region src/adapter/locale/key.ts
+/**
+* Ключ локали поддерева: под ним `LocaleProvider` отдаёт детям свой источник,
+* а сборка компонента (`createVueAdapterContext`) берёт ближайший.
+*/
+var LOCALE_KEY = Symbol("soxa:locale");
+//#endregion
+export { LOCALE_KEY };

package/dist/adapter/runtime/exposeRoot.d.ts

@@ -0,0 +1,21 @@
+import type { Ref, SetupContext } from 'vue';
+/**
+ * `$el` экземпляра — корень компонента, когда корень шаблона не он.
+ *
+ * Путь потребителя к корню во Vue — `$el` экземпляра из `ref`, и даёт его сам
+ * Vue: первый узел шаблона. У Frame, Dialog и Drawer первый узел шаблона —
+ * `<teleport>`, и `$el` — его якорь в разметке родителя, узел-комментарий, а
+ * панель телепортирована в другое место. Переопределить `$el` можно только
+ * через `expose`: прокси экземпляра читает открытый ключ раньше свойств Vue.
+ * Больше экземпляр ничего не открывает (`useExpose`).
+ *
+ * Узел — из ссылки адаптера на корень, той, что привязана к `TElementPlugin`.
+ * Читается он через ссылку: сменился `tag` — `$el` отдаёт новый узел, корень
+ * не отрисован — `null`.
+ *
+ * Отдельная функция, а не флаг `useAdapter`: `expose()` зовётся один раз на
+ * `setup()`, а `useAdapter` у элемента коллекции зовётся дважды. Корень, который
+ * Vue и так отдаёт верно, через неё не открывают: у Table `$el` — окно, внешний
+ * узел, а к `TElementPlugin` привязана `table` внутри него.
+ */
+export declare function exposeRoot(expose: SetupContext['expose'], rootElement: Ref<Element | null> | undefined): void;

package/dist/adapter/runtime/exposeRoot.js

@@ -0,0 +1,25 @@
+//#region src/adapter/runtime/exposeRoot.ts
+/**
+* `$el` экземпляра — корень компонента, когда корень шаблона не он.
+*
+* Путь потребителя к корню во Vue — `$el` экземпляра из `ref`, и даёт его сам
+* Vue: первый узел шаблона. У Frame, Dialog и Drawer первый узел шаблона —
+* `<teleport>`, и `$el` — его якорь в разметке родителя, узел-комментарий, а
+* панель телепортирована в другое место. Переопределить `$el` можно только
+* через `expose`: прокси экземпляра читает открытый ключ раньше свойств Vue.
+* Больше экземпляр ничего не открывает (`useExpose`).
+*
+* Узел — из ссылки адаптера на корень, той, что привязана к `TElementPlugin`.
+* Читается он через ссылку: сменился `tag` — `$el` отдаёт новый узел, корень
+* не отрисован — `null`.
+*
+* Отдельная функция, а не флаг `useAdapter`: `expose()` зовётся один раз на
+* `setup()`, а `useAdapter` у элемента коллекции зовётся дважды. Корень, который
+* Vue и так отдаёт верно, через неё не открывают: у Table `$el` — окно, внешний
+* узел, а к `TElementPlugin` привязана `table` внутри него.
+*/
+function exposeRoot(expose, rootElement) {
+	expose({ $el: rootElement ?? null });
+}
+//#endregion
+export { exposeRoot };

package/dist/adapter/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export { useAdapter } from './useAdapter';
+export { useCollectionAdapter } from './useCollectionAdapter';
+export { joinBindings, extendBinding } from './view';
+export { exposeRoot } from './exposeRoot';