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

package/dist/content/extensions/menu/radio-item.extension.class.js

@@ -0,0 +1,10 @@
+import { MENU_RADIO_GROUP_ELEVATOR } from "./keys.js";
+//#region content/extensions/menu/radio-item.extension.class.ts
+var TMenuRadioItemExtension = class {
+	constructor(context, options) {
+		const group = options.elevator(MENU_RADIO_GROUP_ELEVATOR).up();
+		if (group) context.instance.group = group;
+	}
+};
+//#endregion
+export { TMenuRadioItemExtension };

package/dist/content/extensions/menu/types.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Опции проводки группы переключателей меню и её переключателей.
+ */
+import type { TElevatorFactory } from '../../../protected/adapter/elevator';
+export interface IMenuRadioGroupExtensionOptions {
+    elevator: TElevatorFactory;
+}
+export interface IMenuRadioItemExtensionOptions {
+    elevator: TElevatorFactory;
+}

package/dist/content/extensions/tabs/index.d.ts

@@ -0,0 +1,2 @@
+export { TTabsContentBindingExtension } from './tabs-content-binding.extension.class';
+export type { ITabsContentBindingOptions } from './types';

package/dist/content/extensions/tabs/tabs-content-binding.extension.class.d.ts

@@ -0,0 +1,69 @@
+/**
+ * TTabsContentBindingExtension — binds a panel to its tab.
+ *
+ * The panel does not register in the collection: it is not in `items`. It
+ * finds the existing tab with the same `value` and takes that tab's item
+ * context (`TItemContext`) of its own, for the mount: the same adapters as
+ * `TTabsItemCollectionFacade` has, but the panel releases them itself — on
+ * rebinding and on teardown. A context shared with the tab and released by
+ * one of them would break the other. A panel without a tab has no context at
+ * all, or its `active` would answer for the previous tab. The facade reports
+ * the change of activity that comes with the context; the binding only swaps
+ * it.
+ *
+ * The panel's side of the tab link — `id` and `aria-labelledby` — is written
+ * here into the panel's `aria`: this is the only place that knows the panel
+ * found its tab. The panel has no `id` formula of its own: the tab
+ * (`TTabsItemIdsPlugin`) wrote the panel's `id` into its `aria-controls`, and
+ * the panel takes exactly that, so the two halves cannot diverge. When the tab
+ * remounts or its `TIdPlugin` changes, its ids change (`change:aria`) and the
+ * panel follows.
+ *
+ * An `id` the application gave the panel (its `TIdPlugin`) wins over the
+ * formula: it goes on the panel from the first render, tab or no tab, and the
+ * tab's `aria-controls` points to it. Only the tab's plugin writes
+ * `aria-controls`, so an accepted panel hands it its `TIdPlugin`
+ * (`bindPanel`) and takes it back on unbinding and teardown (`unbindPanel`).
+ * The plugin of the tab's current mount is found in the collection's bundle
+ * registry (`COLLECTION_BUNDLES_ELEVATOR`). A tab's bundle enters the registry
+ * on the tab's entry — sometimes after the panel, and again on a remount — so
+ * the panel hands its `id` over on every registration (`bundle:registered`)
+ * too.
+ *
+ * The tab is looked up only in a Tabs engine (one with `TTabsExtension`). The
+ * lift gives the nearest collection's engine, and it may be foreign: a panel
+ * outside its tabs under an app-wide `<Toasts>`. A foreign collection is
+ * treated as absent, as for `TCollectionItemExtension`: otherwise the panel
+ * would bind to a foreign item with a matching `value` — silently under
+ * RadioGroup, with a failing assembly where there is no activation.
+ *
+ * The work follows the context's phases, as in `TCollectionItemExtension`:
+ *
+ * - **assembly** — the first binding, writing only the panel's own: its
+ *   facade and its `aria`. A data tab is already in the collection and the tab
+ *   list renders before the panels, so the panel is bound from the first
+ *   render, the server's included;
+ * - **entry** (`attach`) — binding again, the tab's side, and the
+ *   subscriptions: the engine's `item:added`, the registry's
+ *   `bundle:registered`, the panel's `change:value`, its `TIdPlugin`'s
+ *   `change:id` and the bound tab's `change:aria`. Markup tabs enter on their
+ *   own `attach`, and a panel after them finds them on this second lookup.
+ *   Subscriptions and the write to the tab wait for entry because those buses
+ *   and the tab are not the panel's: React assembles on render, and a
+ *   discarded render would leave an extra subscriber on them and the `id` of
+ *   a panel that does not exist on the tab. A tab found on assembly is reread
+ *   after subscribing, so what it wrote in between (React: the tab's `id` set
+ *   by an effect) reaches the panel. From entry to teardown the panel is a
+ *   member of the collection (`TCollectionMembers`), as an item is: the
+ *   owner's `detach` detaches its own context and the facade's, and the panel
+ *   does not hear the tabs go;
+ * - **teardown** (`destroy`) — unsubscribing, the panel's attributes, its `id`
+ *   at the tab and the tab's context. A context assembled but never accepted
+ *   is torn down too: it has no subscriptions, but what assembly took goes.
+ */
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { TCollectionItemFacade } from '../collection';
+import type { ITabsContentBindingOptions } from './types';
+export declare class TTabsContentBindingExtension {
+    constructor(context: TInstanceContext<TCollectionItemFacade>, options: ITabsContentBindingOptions);
+}

package/dist/content/extensions/tabs/tabs-content-binding.extension.class.js

@@ -0,0 +1,184 @@
+import { ITEM_CONTEXT_ELEVATOR } from "../../../protected/adapter/elevator/keys.js";
+import { COLLECTION_BUNDLES_ELEVATOR, COLLECTION_MEMBERS_ELEVATOR } from "../collection/keys.js";
+import { TItemContext, TTabsExtension } from "@soxa-ui/core";
+import { TIdPlugin, TTabsItemIdsPlugin } from "@soxa-ui/plugins";
+//#region content/extensions/tabs/tabs-content-binding.extension.class.ts
+/**
+* TTabsContentBindingExtension — binds a panel to its tab.
+*
+* The panel does not register in the collection: it is not in `items`. It
+* finds the existing tab with the same `value` and takes that tab's item
+* context (`TItemContext`) of its own, for the mount: the same adapters as
+* `TTabsItemCollectionFacade` has, but the panel releases them itself — on
+* rebinding and on teardown. A context shared with the tab and released by
+* one of them would break the other. A panel without a tab has no context at
+* all, or its `active` would answer for the previous tab. The facade reports
+* the change of activity that comes with the context; the binding only swaps
+* it.
+*
+* The panel's side of the tab link — `id` and `aria-labelledby` — is written
+* here into the panel's `aria`: this is the only place that knows the panel
+* found its tab. The panel has no `id` formula of its own: the tab
+* (`TTabsItemIdsPlugin`) wrote the panel's `id` into its `aria-controls`, and
+* the panel takes exactly that, so the two halves cannot diverge. When the tab
+* remounts or its `TIdPlugin` changes, its ids change (`change:aria`) and the
+* panel follows.
+*
+* An `id` the application gave the panel (its `TIdPlugin`) wins over the
+* formula: it goes on the panel from the first render, tab or no tab, and the
+* tab's `aria-controls` points to it. Only the tab's plugin writes
+* `aria-controls`, so an accepted panel hands it its `TIdPlugin`
+* (`bindPanel`) and takes it back on unbinding and teardown (`unbindPanel`).
+* The plugin of the tab's current mount is found in the collection's bundle
+* registry (`COLLECTION_BUNDLES_ELEVATOR`). A tab's bundle enters the registry
+* on the tab's entry — sometimes after the panel, and again on a remount — so
+* the panel hands its `id` over on every registration (`bundle:registered`)
+* too.
+*
+* The tab is looked up only in a Tabs engine (one with `TTabsExtension`). The
+* lift gives the nearest collection's engine, and it may be foreign: a panel
+* outside its tabs under an app-wide `<Toasts>`. A foreign collection is
+* treated as absent, as for `TCollectionItemExtension`: otherwise the panel
+* would bind to a foreign item with a matching `value` — silently under
+* RadioGroup, with a failing assembly where there is no activation.
+*
+* The work follows the context's phases, as in `TCollectionItemExtension`:
+*
+* - **assembly** — the first binding, writing only the panel's own: its
+*   facade and its `aria`. A data tab is already in the collection and the tab
+*   list renders before the panels, so the panel is bound from the first
+*   render, the server's included;
+* - **entry** (`attach`) — binding again, the tab's side, and the
+*   subscriptions: the engine's `item:added`, the registry's
+*   `bundle:registered`, the panel's `change:value`, its `TIdPlugin`'s
+*   `change:id` and the bound tab's `change:aria`. Markup tabs enter on their
+*   own `attach`, and a panel after them finds them on this second lookup.
+*   Subscriptions and the write to the tab wait for entry because those buses
+*   and the tab are not the panel's: React assembles on render, and a
+*   discarded render would leave an extra subscriber on them and the `id` of
+*   a panel that does not exist on the tab. A tab found on assembly is reread
+*   after subscribing, so what it wrote in between (React: the tab's `id` set
+*   by an effect) reaches the panel. From entry to teardown the panel is a
+*   member of the collection (`TCollectionMembers`), as an item is: the
+*   owner's `detach` detaches its own context and the facade's, and the panel
+*   does not hear the tabs go;
+* - **teardown** (`destroy`) — unsubscribing, the panel's attributes, its `id`
+*   at the tab and the tab's context. A context assembled but never accepted
+*   is torn down too: it has no subscriptions, but what assembly took goes.
+*/
+/** A Tabs engine: the tabs extension is in it. Any other collection's engine is foreign to a panel. */
+function isTabsEngine(engine) {
+	return engine?.extensions.tabs instanceof TTabsExtension;
+}
+/** The bundle registry of the panel's collection: another's is foreign. */
+function registryOf(bundles, engine) {
+	return bundles?.engine === engine ? bundles : void 0;
+}
+/** The tab whose value matches the panel's. */
+function findByValue(engine, value) {
+	for (const item of engine.extensions.batch.items) if (item.value === value) return item;
+}
+var TTabsContentBindingExtension = class {
+	constructor(context, options) {
+		const { adapter, elevator } = options;
+		const content = adapter.instance;
+		const engine = elevator(ITEM_CONTEXT_ELEVATOR).up();
+		if (!isTabsEngine(engine)) return;
+		const extensions = engine.extensions;
+		/** The tabs' bundles: there the panel finds its tab's link plugin. */
+		const bundles = registryOf(elevator(COLLECTION_BUNDLES_ELEVATOR).up(), engine);
+		/** The collection's members, lowered beside the engine as the registry is. */
+		const members = elevator(COLLECTION_MEMBERS_ELEVATOR).up();
+		/** The `id` the application gave the panel. */
+		const idPlugin = context.bundle?.get(TIdPlugin);
+		/** The tab bound now. */
+		let boundItem;
+		/** The tab's context at the panel's facade; unbinding releases it. */
+		let boundContext;
+		/** The tab's link plugin the panel handed its `TIdPlugin` to. */
+		let boundIds;
+		/** The context is accepted: subscribing to foreign buses is allowed. */
+		let attached = false;
+		/**
+		* The panel's side: the application's `id`, else the one the tab wrote,
+		* and the link to the tab. Without a tab only the own `id` stays.
+		*/
+		const linkPanel = () => {
+			content.aria.add("id", idPlugin?.id ?? boundItem?.aria.get("aria-controls"));
+			content.aria.add("aria-labelledby", boundItem?.aria.get("id"));
+		};
+		/** The tab's `aria-controls` no longer follows this panel: back to the formula. */
+		const unlinkTab = () => {
+			if (idPlugin) boundIds?.unbindPanel(idPlugin);
+			boundIds = void 0;
+		};
+		/**
+		* The tab's side: its link plugin points `aria-controls` to the panel's
+		* `id`. Only for an accepted panel, and only the plugin of the tab's
+		* current mount: a remounted tab has a new one.
+		*/
+		const linkTab = () => {
+			const ids = idPlugin && attached && boundItem ? bundles?.getByItem(boundItem)?.get(TTabsItemIdsPlugin) : void 0;
+			if (ids === boundIds) return;
+			unlinkTab();
+			if (!idPlugin || !ids) return;
+			boundIds = ids;
+			ids.bindPanel(idPlugin);
+		};
+		/**
+		* The panel is bound to no tab. The facade is cleared before the context
+		* is released: the facade is read after teardown too, and reading a
+		* released context would recreate the adapters.
+		*/
+		const unbind = () => {
+			if (attached) boundItem?.events.off("change:aria", linkPanel);
+			unlinkTab();
+			context.instance.clearContext();
+			boundContext?.release();
+			boundContext = void 0;
+			boundItem = void 0;
+		};
+		/** Bind to a tab or to none: both write the panel's side. */
+		const bind = (item) => {
+			unbind();
+			if (item) {
+				boundContext = new TItemContext(item, extensions);
+				boundItem = item;
+				if (attached) item.events.on("change:aria", linkPanel);
+			}
+			linkPanel();
+			linkTab();
+			if (boundContext) context.instance.setContext(boundContext);
+		};
+		const resolve = () => {
+			const item = findByValue(engine, content.value);
+			if (item !== boundItem) bind(item);
+		};
+		bind(findByValue(engine, content.value));
+		context.events.on("attach", () => {
+			attached = true;
+			members?.add(adapter, context);
+			boundItem?.events.on("change:aria", linkPanel);
+			idPlugin?.events.on("change:id", linkPanel);
+			linkPanel();
+			linkTab();
+			resolve();
+			engine.extensions.plain.events.on("item:added", resolve);
+			bundles?.events.on("bundle:registered", linkTab);
+			content.events.on("change:value", resolve);
+		});
+		context.events.on("destroy", () => {
+			engine.extensions.plain.events.off("item:added", resolve);
+			bundles?.events.off("bundle:registered", linkTab);
+			content.events.off("change:value", resolve);
+			idPlugin?.events.off("change:id", linkPanel);
+			members?.delete(adapter, context);
+			unbind();
+			attached = false;
+			content.aria.remove("id");
+			content.aria.remove("aria-labelledby");
+		});
+	}
+};
+//#endregion
+export { TTabsContentBindingExtension };

package/dist/content/extensions/tabs/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Options of the Tabs panel's binding to its tab: the panel's adapter and the lift to the owner's engine.
+ */
+import type { ITabsContent } from '@soxa-ui/core';
+import type { TElevatorFactory } from '../../../protected/adapter/elevator';
+import type { TMemberAdapter } from '../collection';
+export interface ITabsContentBindingOptions {
+    /** The panel's own context: its instance (TTabsContent) is the source of `value`. */
+    adapter: TMemberAdapter<ITabsContent>;
+    elevator: TElevatorFactory;
+}

package/dist/content/extensions/toasts/index.d.ts

@@ -0,0 +1,3 @@
+export { TToastsApiExtension } from './toasts-api.extension.class';
+export { TOASTS_ELEVATOR } from './keys';
+export type { IToastsApiExtensionOptions, TToastsApiOwner } from './types';

package/dist/content/extensions/toasts/keys.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Ключ лифта тостов: менеджер `Toasts` опускает по нему API тостов своему поддереву.
+ *
+ * Лежит отдельно от проводки менеджера, как ключ окна (`VIRTUAL_ELEVATOR`):
+ * адаптеру, чтобы взять API (`useToasts()`), нужен только ключ. Лифт берёт
+ * любой ключ, поэтому ключ — в наполнении, а не в механике лифта.
+ */
+import type { IToastsApi } from '@soxa-ui/core';
+import type { IElevatorKey } from '../../../protected/adapter/elevator';
+/** API тостов ближайшего `Toasts` выше по дереву: `show` и тост в ответ. */
+export declare const TOASTS_ELEVATOR: IElevatorKey<IToastsApi>;

package/dist/content/extensions/toasts/keys.js

@@ -0,0 +1,5 @@
+//#region content/extensions/toasts/keys.ts
+/** API тостов ближайшего `Toasts` выше по дереву: `show` и тост в ответ. */
+var TOASTS_ELEVATOR = { name: "soxa:toasts" };
+//#endregion
+export { TOASTS_ELEVATOR };

package/dist/content/extensions/toasts/toasts-api.extension.class.d.ts

@@ -0,0 +1,23 @@
+/**
+ * TToastsApiExtension — менеджер `Toasts` отдаёт API тостов вниз по дереву.
+ *
+ * Приложение показывает тост из любого места под менеджером, не ставя
+ * разметку на месте: `const { show } = useToasts()`. API — очередь движка
+ * (`engine.extensions.toasts`): тот же объект, которым показывает тосты код
+ * вне компонентов, получивший движок пропом `engine`. Второго пути к тостам
+ * нет — опускается сама очередь, а не обёртка над ней.
+ *
+ * Расширение только опускает значение по лифту (`TOASTS_ELEVATOR`), а берёт
+ * его адаптер — своим механизмом контекста: во Vue — `inject`. Ни
+ * регистрации, ни подписок у него нет, поэтому фаз контекста оно не ждёт.
+ *
+ * Использование:
+ *   collectionAdapter
+ *     .use(TCollectionExtension, { elevator: VueElevatorFactory })
+ *     .use(TToastsApiExtension, { elevator: VueElevatorFactory })
+ */
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { IToastsApiExtensionOptions, TToastsApiOwner } from './types';
+export declare class TToastsApiExtension {
+    constructor(context: TInstanceContext<TToastsApiOwner>, options: IToastsApiExtensionOptions);
+}

package/dist/content/extensions/toasts/toasts-api.extension.class.js

@@ -0,0 +1,9 @@
+import { TOASTS_ELEVATOR } from "./keys.js";
+//#region content/extensions/toasts/toasts-api.extension.class.ts
+var TToastsApiExtension = class {
+	constructor(context, options) {
+		options.elevator(TOASTS_ELEVATOR).down(context.instance.engine.extensions.toasts);
+	}
+};
+//#endregion
+export { TToastsApiExtension };

package/dist/content/extensions/toasts/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Контракты проводки тостов: фасад, у которого берут API, и опции расширения.
+ */
+import type { IToastsApi } from '@soxa-ui/core';
+import type { TElevatorFactory } from '../../../protected/adapter/elevator';
+/**
+ * Инстанс, к которому подключается расширение: фасад коллекции, в движке
+ * которого стоит очередь тостов (`toasts`).
+ */
+export type TToastsApiOwner = {
+    readonly engine: {
+        readonly extensions: {
+            readonly toasts: IToastsApi;
+        };
+    };
+};
+export interface IToastsApiExtensionOptions {
+    elevator: TElevatorFactory;
+}

package/dist/content/extensions/virtual/index.d.ts

@@ -0,0 +1,3 @@
+export { TVirtualExtension } from './virtual.extension.class';
+export { TVirtualCollectionExtension } from './virtual-collection.extension.class';
+export type { IVirtualCollectionExtensionOptions, IVirtualConnection, IVirtualExtensionOptions, TVirtualConnect, } from './types';

package/dist/content/extensions/virtual/keys.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Ключ лифта окна: обёртка `Virtual` опускает по нему коллекциям внутри себя подключение к окну.
+ *
+ * Лежит отдельно от проводки обёртки: коллекция импортирует только ключ и
+ * типы, и код окна — стратегия и плагин замера — в сборку приложения без
+ * обёртки не попадает. Лифт берёт любой ключ, поэтому ключ — в наполнении, а
+ * не в механике лифта.
+ */
+import type { IElevatorKey } from '../../../protected/adapter/elevator';
+import type { TVirtualConnect } from './types';
+/**
+ * Подключение к окну. Пустое значение опускает своему поддереву сама
+ * коллекция: списки в слотах её элементов окна не наследуют.
+ */
+export declare const VIRTUAL_ELEVATOR: IElevatorKey<TVirtualConnect | null>;

package/dist/content/extensions/virtual/keys.js

@@ -0,0 +1,8 @@
+//#region content/extensions/virtual/keys.ts
+/**
+* Подключение к окну. Пустое значение опускает своему поддереву сама
+* коллекция: списки в слотах её элементов окна не наследуют.
+*/
+var VIRTUAL_ELEVATOR = { name: "soxa:virtual" };
+//#endregion
+export { VIRTUAL_ELEVATOR };

package/dist/content/extensions/virtual/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Контракты окна: подключение коллекции к окну обёртки `Virtual` и опции расширений.
+ */
+import type { TCollectionEngine } from '@soxa-ui/core';
+import type { IPluginBundle } from '@soxa-ui/plugins';
+import type { TElevatorFactory } from '../../../protected/adapter/elevator';
+/**
+ * Подключить коллекцию к окну обёртки: её движок и набор плагинов. Зовёт его
+ * сборка коллекции, и сразу подключение делает только то, что принадлежит
+ * коллекции, — плагин замера в её набор и стратегию в её рисование по
+ * текущему `enabled`. Остальное коллекция ведёт по фазам своего контекста —
+ * через подключение, которое получила.
+ */
+export type TVirtualConnect = (engine: TCollectionEngine<any, any>, bundle: IPluginBundle | null) => IVirtualConnection;
+/**
+ * Подключение коллекции к окну — по фазам её контекста. Шина обёртки для
+ * коллекции чужая, поэтому на выключатель подписывается только принятая
+ * коллекция: собранную фреймворк вправе выбросить, так и не приняв, и
+ * подписка сборки осталась бы на живой обёртке.
+ */
+export interface IVirtualConnection {
+    /**
+     * Коллекцию приняли (`attach` контекста): окно идёт за выключателем обёртки
+     * и применяет его ещё раз — выключатель мог смениться между сборкой и
+     * приёмом.
+     */
+    attach(): void;
+    /**
+     * Коллекцию уничтожили (`destroy` контекста), принятую или нет: отписка от
+     * выключателя, если подписка была, и рисование всех элементов — движок мог
+     * прийти снаружи и пережить компонент.
+     */
+    destroy(): void;
+}
+export interface IVirtualExtensionOptions {
+    elevator: TElevatorFactory;
+}
+export interface IVirtualCollectionExtensionOptions {
+    elevator: TElevatorFactory;
+}

package/dist/content/extensions/virtual/virtual-collection.extension.class.d.ts

@@ -0,0 +1,33 @@
+/**
+ * TVirtualCollectionExtension — коллекция подхватывает окно обёртки `Virtual` над собой.
+ *
+ * Фазы — как у связки панели Tabs (`TTabsContentBindingExtension`):
+ *
+ * - **сборка** — подхват: подключение ставит то, что принадлежит коллекции, —
+ *   плагин замера в её набор и стратегию в её рисование по текущему
+ *   `enabled`. Сервер и первый кадр рисуют уже окно, а не весь список;
+ * - **вход** (`attach` контекста) — подписка на выключатель обёртки. Шина
+ *   обёртки чужая, а собранную коллекцию фреймворк вправе выбросить, так и не
+ *   приняв: подписка сборки осталась бы на живой обёртке;
+ * - **снятие** (`destroy` контекста) — отписка от обёртки, если подписка была,
+ *   и рисование всех элементов, ведь движок мог прийти снаружи и пережить
+ *   компонент. Контекст, собранный, но так и не принятый, снимается тоже.
+ *
+ * Обёртки выше нет — коллекция рисует все показанные элементы, как без окна.
+ *
+ * Своему поддереву коллекция опускает пустое подключение: списки в слотах её
+ * элементов окна не наследуют.
+ *
+ * Код окна здесь не импортируется — только ключ лифта и типы: коллекция без
+ * обёртки стратегию окна и плагин замера в сборку приложения не тянет.
+ *
+ * Использование:
+ *   adapter.use(TCollectionExtension, { elevator: VueElevatorFactory })
+ *     .use(TVirtualCollectionExtension, { elevator: VueElevatorFactory })
+ */
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { TCollectionOwner } from '../collection';
+import type { IVirtualCollectionExtensionOptions } from './types';
+export declare class TVirtualCollectionExtension {
+    constructor(context: TInstanceContext<TCollectionOwner>, options: IVirtualCollectionExtensionOptions);
+}

package/dist/content/extensions/virtual/virtual-collection.extension.class.js

@@ -0,0 +1,15 @@
+import { VIRTUAL_ELEVATOR } from "./keys.js";
+//#region content/extensions/virtual/virtual-collection.extension.class.ts
+var TVirtualCollectionExtension = class {
+	constructor(context, options) {
+		const elevator = options.elevator(VIRTUAL_ELEVATOR);
+		const connect = elevator.up();
+		elevator.down(null);
+		if (!connect) return;
+		const connection = connect(context.instance.engine, context.bundle);
+		context.events.on("attach", () => connection.attach());
+		context.events.on("destroy", () => connection.destroy());
+	}
+};
+//#endregion
+export { TVirtualCollectionExtension };

package/dist/content/extensions/virtual/virtual.extension.class.d.ts

@@ -0,0 +1,36 @@
+/**
+ * TVirtualExtension — проводка обёртки `Virtual`: окно коллекциям внутри неё.
+ *
+ * Обёртка опускает по лифту подключение к окну, а коллекция внутри
+ * подхватывает его при сборке (`TVirtualCollectionExtension`). Подключение
+ * делает со своей коллекцией две вещи:
+ *
+ * - ставит в её набор плагинов `TVirtualPlugin` — замер видимой полосы и шага
+ *   элементов и элемент с DOM-фокусом; движок к этому времени привязан к
+ *   реестру bundles, и плагин берёт его оттуда;
+ * - держит в её рисовании (`draw`) стратегию окна, пока обёртка включена
+ *   (`enabled`), и снимает её, когда выключена.
+ *
+ * Работа разделена по фазам контекста коллекции, как у связки панели Tabs
+ * (`TTabsContentBindingExtension`):
+ *
+ * - **сборка** — плагин в набор и стратегия по текущему `enabled`: то и
+ *   другое принадлежит коллекции, поэтому сервер и первый кадр уже в окне;
+ * - **вход** (`attach`) — подписка на выключатель обёртки и его повторное
+ *   применение. Шина обёртки для коллекции чужая, а собранную коллекцию
+ *   фреймворк вправе выбросить, так и не приняв: подписка сборки осталась бы
+ *   на живой обёртке, и снять её было бы некому — у списка из `items` нет ни
+ *   `ctrl`, ни движка снаружи, по которым узнают выброшенную сборку;
+ * - **снятие** (`destroy`) — отписка, если подписка была, и рисование всех
+ *   элементов: движок мог прийти снаружи и пережить компонент. Плагин уходит
+ *   вместе с набором компонента.
+ *
+ * Использование:
+ *   adapter.use(TVirtualExtension, { elevator: VueElevatorFactory })
+ */
+import type { IVirtual } from '@soxa-ui/core';
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { IVirtualExtensionOptions } from './types';
+export declare class TVirtualExtension {
+    constructor(context: TInstanceContext<IVirtual>, options: IVirtualExtensionOptions);
+}

package/dist/content/extensions/virtual/virtual.extension.class.js

@@ -0,0 +1,74 @@
+import { VIRTUAL_ELEVATOR } from "./keys.js";
+import { TWindowStrategy, drawOf } from "@soxa-ui/core";
+import { TVirtualPlugin } from "@soxa-ui/plugins";
+//#region content/extensions/virtual/virtual.extension.class.ts
+/**
+* TVirtualExtension — проводка обёртки `Virtual`: окно коллекциям внутри неё.
+*
+* Обёртка опускает по лифту подключение к окну, а коллекция внутри
+* подхватывает его при сборке (`TVirtualCollectionExtension`). Подключение
+* делает со своей коллекцией две вещи:
+*
+* - ставит в её набор плагинов `TVirtualPlugin` — замер видимой полосы и шага
+*   элементов и элемент с DOM-фокусом; движок к этому времени привязан к
+*   реестру bundles, и плагин берёт его оттуда;
+* - держит в её рисовании (`draw`) стратегию окна, пока обёртка включена
+*   (`enabled`), и снимает её, когда выключена.
+*
+* Работа разделена по фазам контекста коллекции, как у связки панели Tabs
+* (`TTabsContentBindingExtension`):
+*
+* - **сборка** — плагин в набор и стратегия по текущему `enabled`: то и
+*   другое принадлежит коллекции, поэтому сервер и первый кадр уже в окне;
+* - **вход** (`attach`) — подписка на выключатель обёртки и его повторное
+*   применение. Шина обёртки для коллекции чужая, а собранную коллекцию
+*   фреймворк вправе выбросить, так и не приняв: подписка сборки осталась бы
+*   на живой обёртке, и снять её было бы некому — у списка из `items` нет ни
+*   `ctrl`, ни движка снаружи, по которым узнают выброшенную сборку;
+* - **снятие** (`destroy`) — отписка, если подписка была, и рисование всех
+*   элементов: движок мог прийти снаружи и пережить компонент. Плагин уходит
+*   вместе с набором компонента.
+*
+* Использование:
+*   adapter.use(TVirtualExtension, { elevator: VueElevatorFactory })
+*/
+/** Подключение коллекции без рисования: окну у неё нечего держать. */
+var NO_WINDOW = {
+	attach: () => {},
+	destroy: () => {}
+};
+var TVirtualExtension = class {
+	constructor(context, options) {
+		const virtual = context.instance;
+		options.elevator(VIRTUAL_ELEVATOR).down((engine, bundle) => connectWindow(virtual, engine, bundle));
+	}
+};
+/**
+* Подключить коллекцию к окну обёртки: своё коллекции — сразу, подписка на
+* обёртку — с приёмом коллекции.
+*/
+function connectWindow(virtual, engine, bundle) {
+	const draw = drawOf(engine);
+	if (!draw) return NO_WINDOW;
+	if (bundle && !bundle.get(TVirtualPlugin)) bundle.use(TVirtualPlugin);
+	const strategy = new TWindowStrategy();
+	const apply = (enabled) => draw.useStrategy(enabled ? strategy : null);
+	const changed = ({ newValue }) => apply(newValue);
+	/** Коллекцию приняли: на выключатель обёртки подписаны. */
+	let listening = false;
+	apply(virtual.enabled);
+	return {
+		attach: () => {
+			listening = true;
+			virtual.events.on("change:enabled", changed);
+			apply(virtual.enabled);
+		},
+		destroy: () => {
+			if (listening) virtual.events.off("change:enabled", changed);
+			listening = false;
+			draw.useStrategy(null);
+		}
+	};
+}
+//#endregion
+export { TVirtualExtension };

package/dist/content/icons/index.d.ts

@@ -0,0 +1,2 @@
+export { ICON_ROLES, missingIconRoles } from './roles';
+export type { TIconPack, TIconRole } from './roles';

package/dist/content/icons/roles.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Роли, которые компоненты библиотеки требуют от пакета иконок.
+ *
+ * Пакет иконок — не мешок SVG, а **реализация контракта**: список ролей,
+ * которые нужны компонентам. Ровно как тема реализует те классы, которые
+ * soxa выпускает в разметку. Поэтому роли перечислены явно, а
+ * conformance-тест проверяет, что пакет закрывает их все.
+ *
+ * Список — наполнение, а не механика: появилась иконка в новом компоненте —
+ * роль дописывается сюда. Реестр (`protected/registry/icons.ts`) о списке не
+ * знает и работает с любой строкой, поэтому новая роль не трогает движок.
+ */
+import type { TIconSource } from '../../protected/registry';
+/**
+ * Список закрытый: он и есть контракт. Появилась иконка в новом компоненте —
+ * роль добавляется сюда, и conformance-тест сразу покажет, какие пакеты её
+ * ещё не закрыли.
+ */
+export declare const ICON_ROLES: readonly ["check", "checkIndeterminate", "close", "arrowDown", "arrowRight", "arrowsOutward", "arrowsInward", "calendar", "arrowUpward", "star", "minus", "plus", "error", "notification", "info", "success", "warning"];
+export type TIconRole = (typeof ICON_ROLES)[number];
+/** Пакет иконок: все обязательные роли плюс любые собственные. */
+export type TIconPack = Record<TIconRole, TIconSource> & Record<string, TIconSource>;
+/**
+ * Каких обязательных ролей не хватает в наборе.
+ *
+ * Основа conformance-теста пакета: пустой массив означает, что контракт
+ * закрыт целиком.
+ */
+export declare function missingIconRoles(pack: Partial<Record<string, TIconSource>>): TIconRole[];