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

package/dist/content/extensions/field/field-control.extension.class.d.ts

@@ -0,0 +1,63 @@
+/**
+ * TFieldControlExtension — контрол берёт связку поля формы `Field` над собой.
+ *
+ * Поле даёт контролу три вещи: ошибку (`invalid` — `data-invalid` и
+ * `aria-invalid` контрола), ссылки на видимые части (`aria-describedby` на
+ * подсказку или ошибку, у группы — `aria-labelledby` на подпись) и, у
+ * labelable-контрола без своего `id`, `id` поля — на него ведёт `for`
+ * подписи. Ссылки пишет `TAriaPlugin` контрола — вторым входом рядом с
+ * пропсами `aria_*`, и своё имя контрола главнее подписи поля. Labelable-
+ * контролу (Input, NumberInput, Select, CheckBox, Switch, Rating, ползунок с
+ * одной ручкой) имя даёт `for`, а не ссылка: `aria-labelledby` перекрыл бы
+ * подпись `Label` у флажка в поле.
+ *
+ * `id` поле задаёт каналом самого контрола. У контрола с `TIdPlugin`
+ * (`TInputControl`: Input, NumberInput, Select, CheckBox, Switch, Rating) —
+ * значением `id` плагина, а не записью в `aria`: этот `id` каждый такой
+ * контрол уже ведёт до своего `<input>`, и у Select — до поля внутри. Набор
+ * `aria` Select разметка кладёт атрибутами на вложенный Input, а `id` там —
+ * проп Input, и снятый `id` из набора вернул бы `id` поля Select к умолчанию
+ * поверх своего. `id` приложения главнее: поле задаёт `id`, только пока его
+ * нет, и снимает свой, когда контрол уходит из поля. У labelable-контрола без
+ * `TIdPlugin` (ползунок) канала, кроме `aria`, нет — `id` ложится туда, как
+ * `id` панели Tabs.
+ *
+ * Сам о себе контрол сообщает полю — `id` и labelable ли он: только он их
+ * знает. По ним плагин связок поля решает `for` подписи — `id` контрола или
+ * ничего у группы.
+ *
+ * Labelable контрол может сменить по ходу жизни: ползунок labelable, пока
+ * ручка одна, а у нескольких ручек он — группа, и имя подписи ложится на его
+ * корень, а не на поля ручек. Сменился (`change:labelable`) — подпись за ним:
+ * labelable-контрол получает `id` поля и `for`, группа — ссылку на подпись,
+ * а `id` от поля с неё снят.
+ *
+ * Фазы — как у связки панели Tabs (`TTabsContentBindingExtension`):
+ *
+ * - **сборка** — ошибка, ссылки и `id`: всё это контрола, поэтому сервер и
+ *   первый кадр рисуют его уже в поле;
+ * - **вход** (`attach` контекста) — связка его: подписки на ошибку поля, его
+ *   ссылки, `change:id` его `TIdPlugin`, свой `change:labelable` и сообщение
+ *   полю о себе.
+ *   Шины поля контролу чужие, а собранный контрол фреймворк вправе выбросить,
+ *   так и не приняв; связку к этому времени мог взять контрол, принятый
+ *   раньше, — тогда собранное снимается;
+ * - **снятие** (`destroy` контекста) — отписка, связка свободна, записанное
+ *   контролу — назад. Контекст, собранный, но так и не принятый, снимается
+ *   тоже.
+ *
+ * Поле — одно на контрол, контрол — один на поле: связку берёт первый, и
+ * занятую не берёт никто. Деталь чужой разметки (`embedded`: поле Select,
+ * поля DatePicker) связку не берёт — её взял владелец детали. Своему поддереву
+ * контрол опускает пустую связку: контролы в его слотах — его содержимое.
+ *
+ * Поля выше нет — контрол ведёт себя так, будто связки нет вовсе.
+ *
+ * Использование:
+ *   adapter.use(TFieldControlExtension, { elevator: VueElevatorFactory })
+ */
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { IFieldControl, IFieldControlExtensionOptions } from './types';
+export declare class TFieldControlExtension {
+    constructor(context: TInstanceContext<IFieldControl>, options: IFieldControlExtensionOptions);
+}

package/dist/content/extensions/field/field-control.extension.class.js

@@ -0,0 +1,172 @@
+import { FIELD_ELEVATOR } from "./keys.js";
+import { TAriaPlugin, TIdPlugin } from "@soxa-ui/plugins";
+//#region content/extensions/field/field-control.extension.class.ts
+/**
+* TFieldControlExtension — контрол берёт связку поля формы `Field` над собой.
+*
+* Поле даёт контролу три вещи: ошибку (`invalid` — `data-invalid` и
+* `aria-invalid` контрола), ссылки на видимые части (`aria-describedby` на
+* подсказку или ошибку, у группы — `aria-labelledby` на подпись) и, у
+* labelable-контрола без своего `id`, `id` поля — на него ведёт `for`
+* подписи. Ссылки пишет `TAriaPlugin` контрола — вторым входом рядом с
+* пропсами `aria_*`, и своё имя контрола главнее подписи поля. Labelable-
+* контролу (Input, NumberInput, Select, CheckBox, Switch, Rating, ползунок с
+* одной ручкой) имя даёт `for`, а не ссылка: `aria-labelledby` перекрыл бы
+* подпись `Label` у флажка в поле.
+*
+* `id` поле задаёт каналом самого контрола. У контрола с `TIdPlugin`
+* (`TInputControl`: Input, NumberInput, Select, CheckBox, Switch, Rating) —
+* значением `id` плагина, а не записью в `aria`: этот `id` каждый такой
+* контрол уже ведёт до своего `<input>`, и у Select — до поля внутри. Набор
+* `aria` Select разметка кладёт атрибутами на вложенный Input, а `id` там —
+* проп Input, и снятый `id` из набора вернул бы `id` поля Select к умолчанию
+* поверх своего. `id` приложения главнее: поле задаёт `id`, только пока его
+* нет, и снимает свой, когда контрол уходит из поля. У labelable-контрола без
+* `TIdPlugin` (ползунок) канала, кроме `aria`, нет — `id` ложится туда, как
+* `id` панели Tabs.
+*
+* Сам о себе контрол сообщает полю — `id` и labelable ли он: только он их
+* знает. По ним плагин связок поля решает `for` подписи — `id` контрола или
+* ничего у группы.
+*
+* Labelable контрол может сменить по ходу жизни: ползунок labelable, пока
+* ручка одна, а у нескольких ручек он — группа, и имя подписи ложится на его
+* корень, а не на поля ручек. Сменился (`change:labelable`) — подпись за ним:
+* labelable-контрол получает `id` поля и `for`, группа — ссылку на подпись,
+* а `id` от поля с неё снят.
+*
+* Фазы — как у связки панели Tabs (`TTabsContentBindingExtension`):
+*
+* - **сборка** — ошибка, ссылки и `id`: всё это контрола, поэтому сервер и
+*   первый кадр рисуют его уже в поле;
+* - **вход** (`attach` контекста) — связка его: подписки на ошибку поля, его
+*   ссылки, `change:id` его `TIdPlugin`, свой `change:labelable` и сообщение
+*   полю о себе.
+*   Шины поля контролу чужие, а собранный контрол фреймворк вправе выбросить,
+*   так и не приняв; связку к этому времени мог взять контрол, принятый
+*   раньше, — тогда собранное снимается;
+* - **снятие** (`destroy` контекста) — отписка, связка свободна, записанное
+*   контролу — назад. Контекст, собранный, но так и не принятый, снимается
+*   тоже.
+*
+* Поле — одно на контрол, контрол — один на поле: связку берёт первый, и
+* занятую не берёт никто. Деталь чужой разметки (`embedded`: поле Select,
+* поля DatePicker) связку не берёт — её взял владелец детали. Своему поддереву
+* контрол опускает пустую связку: контролы в его слотах — его содержимое.
+*
+* Поля выше нет — контрол ведёт себя так, будто связки нет вовсе.
+*
+* Использование:
+*   adapter.use(TFieldControlExtension, { elevator: VueElevatorFactory })
+*/
+var TFieldControlExtension = class {
+	constructor(context, options) {
+		const elevator = options.elevator(FIELD_ELEVATOR);
+		const link = elevator.up();
+		if (!link) return;
+		elevator.down(null);
+		if (context.embedded !== void 0 || link.ids.bound) return;
+		const { field, ids } = link;
+		const control = context.instance;
+		const aria = context.bundle?.get(TAriaPlugin);
+		/** Канал `id` контрола: у контрола без него (ползунок) `id` от поля — в `aria`. */
+		const idPlugin = context.bundle?.get(TIdPlugin);
+		/** Контрол принят: связка его, на шины поля и контрола подписаны. */
+		let attached = false;
+		const syncInvalid = () => {
+			control.invalid = field.invalid;
+		};
+		const syncLinks = () => {
+			if (!aria) return;
+			const { labelledBy, describedBy } = ids.links;
+			aria.links = {
+				labelledBy: control.labelable ? void 0 : labelledBy,
+				describedBy
+			};
+		};
+		/** `id` от поля — назад; `id` приложения не трогается. */
+		const releaseId = () => {
+			if (!idPlugin) {
+				if (control.aria.get("id") === ids.controlId) control.aria.remove("id");
+				return;
+			}
+			if (idPlugin.id === ids.controlId) idPlugin.id = void 0;
+		};
+		/**
+		* `id` поля — labelable-контролу без `id` приложения, каналом контрола:
+		* значением его `TIdPlugin`, а у контрола без плагина — в его `aria`.
+		* Группе `id` от поля не нужен: подпись называет её ссылкой, — и снят,
+		* если контрол перестал быть labelable.
+		*/
+		const syncId = () => {
+			if (!control.labelable) {
+				releaseId();
+				return;
+			}
+			if (!idPlugin) {
+				control.aria.add("id", ids.controlId);
+				return;
+			}
+			if (idPlugin.id === void 0) idPlugin.id = ids.controlId;
+		};
+		const apply = () => {
+			syncInvalid();
+			syncLinks();
+			syncId();
+		};
+		/** Сообщить полю о себе: по `id` и labelable оно решает `for` подписи. */
+		const bind = () => {
+			ids.bindControl({
+				id: idPlugin?.id,
+				labelable: control.labelable
+			});
+		};
+		/** `id` сменился: сняли свой — снова `id` поля, и `for` подписи — за ним. */
+		const rebind = () => {
+			syncId();
+			bind();
+		};
+		/**
+		* Labelable сменился (у ползунка — число ручек): `id` поля, ссылка на
+		* подпись и `for` — за ним.
+		*/
+		const relabel = () => {
+			syncId();
+			syncLinks();
+			bind();
+		};
+		/** Всё, что связка записала контролу, — назад. */
+		const release = () => {
+			control.invalid = false;
+			if (aria) aria.links = {};
+			releaseId();
+		};
+		apply();
+		context.events.on("attach", () => {
+			if (ids.bound) {
+				release();
+				return;
+			}
+			attached = true;
+			field.events.on("change:invalid", syncInvalid);
+			ids.events.on("change:links", syncLinks);
+			control.events.on("change:labelable", relabel);
+			idPlugin?.events.on("change:id", rebind);
+			apply();
+			bind();
+		});
+		context.events.on("destroy", () => {
+			if (attached) {
+				field.events.off("change:invalid", syncInvalid);
+				ids.events.off("change:links", syncLinks);
+				control.events.off("change:labelable", relabel);
+				idPlugin?.events.off("change:id", rebind);
+				ids.unbindControl();
+			}
+			attached = false;
+			release();
+		});
+	}
+};
+//#endregion
+export { TFieldControlExtension };

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

@@ -0,0 +1,21 @@
+/**
+ * TFieldExtension — проводка поля формы `Field`: связка контролу внутри.
+ *
+ * Поле опускает по лифту (`FIELD_ELEVATOR`) себя и свой плагин связок
+ * (`TFieldIdsPlugin`), а контрол внутри подхватывает их своим расширением
+ * (`TFieldControlExtension`) — при сборке, поэтому ошибка, `id` поля и ссылки
+ * на части есть уже в первой и серверной отрисовке. Ни регистрации, ни
+ * подписок у поля нет, поэтому фаз контекста оно не ждёт: их ведёт контрол.
+ *
+ * Плагина связок у набора нет (чужой набор без него) — опускается пустая
+ * связка: контрол ведёт себя так, будто поля нет.
+ *
+ * Использование:
+ *   adapter.use(TFieldExtension, { elevator: VueElevatorFactory })
+ */
+import type { IField } from '@soxa-ui/core';
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { IFieldExtensionOptions } from './types';
+export declare class TFieldExtension {
+    constructor(context: TInstanceContext<IField>, options: IFieldExtensionOptions);
+}

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

@@ -0,0 +1,14 @@
+import { FIELD_ELEVATOR } from "./keys.js";
+import { TFieldIdsPlugin } from "@soxa-ui/plugins";
+//#region content/extensions/field/field.extension.class.ts
+var TFieldExtension = class {
+	constructor(context, options) {
+		const ids = context.bundle?.get(TFieldIdsPlugin);
+		options.elevator(FIELD_ELEVATOR).down(ids ? {
+			field: context.instance,
+			ids
+		} : null);
+	}
+};
+//#endregion
+export { TFieldExtension };

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

@@ -0,0 +1,3 @@
+export { TFieldExtension } from './field.extension.class';
+export { TFieldControlExtension } from './field-control.extension.class';
+export type { IFieldControl, IFieldControlExtensionOptions, IFieldExtensionOptions, IFieldLink, } from './types';

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

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

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

@@ -0,0 +1,8 @@
+//#region content/extensions/field/keys.ts
+/**
+* Связка ближайшего поля выше по дереву. Пустое значение опускает своему
+* поддереву сам контрол: контролы в его слотах связку его поля не берут.
+*/
+var FIELD_ELEVATOR = { name: "soxa:field" };
+//#endregion
+export { FIELD_ELEVATOR };

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

@@ -0,0 +1,36 @@
+/**
+ * Контракты связки поля формы с контролом: что поле опускает по лифту, каким
+ * связка видит контрол, и опции расширений.
+ */
+import type { IField, TAria, TControlEvents } from '@soxa-ui/core';
+import type { IListenable, TFieldIdsPlugin } from '@soxa-ui/plugins';
+import type { TElevatorFactory } from '../../../protected/adapter/elevator';
+/**
+ * Связка поля: само поле — его ошибка и событие её смены — и его плагин
+ * связок: `id` поля, ссылки на видимые части и приём контрола.
+ */
+export interface IFieldLink {
+    readonly field: IField;
+    readonly ids: TFieldIdsPlugin;
+}
+/**
+ * Контрол поля глазами связки: ошибка, которую ему пишет поле, признак
+ * labelable — называет ли подпись его своим `for` или, как группу, ссылкой, —
+ * с событием его смены и набор элемента, который она называет: у
+ * labelable-контрола без `TIdPlugin` (ползунок) `id` от поля ложится туда.
+ *
+ * Labelable меняется по ходу жизни не у всякого контрола: у ползунка — с
+ * числом ручек, а подпись — за ним.
+ */
+export interface IFieldControl {
+    invalid: boolean;
+    readonly labelable: boolean;
+    readonly aria: TAria;
+    readonly events: IListenable<Pick<TControlEvents, 'change:labelable'>>;
+}
+export interface IFieldExtensionOptions {
+    elevator: TElevatorFactory;
+}
+export interface IFieldControlExtensionOptions {
+    elevator: TElevatorFactory;
+}

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

@@ -0,0 +1,8 @@
+export * from './collection';
+export * from './drag-and-drop';
+export * from './field';
+export * from './item-group';
+export * from './menu';
+export * from './tabs';
+export * from './toasts';
+export * from './virtual';

package/dist/content/extensions/item-group/index.d.ts

@@ -0,0 +1,2 @@
+export { TItemGroupExtension } from './item-group.extension.class';
+export type { IItemGroupExtensionOptions, IItemGroupLink, TItemGroupPart } from './types';

package/dist/content/extensions/item-group/item-group.extension.class.d.ts

@@ -0,0 +1,49 @@
+/**
+ * TItemGroupExtension — a group part enters the collection's grouping: the key to the items inside, the label to the grouping.
+ *
+ * A markup group (`Menu.Group`, `Menu.RadioGroup`, `ListBox.Group`,
+ * `Select.Group`) goes the same channel as the `_.group` mark in data: it
+ * lowers its key along with its collection's engine down the elevator
+ * (`ITEM_GROUP_ELEVATOR`), and an item inside puts the key into its marks
+ * when it joins the collection (`TCollectionItemExtension`). There is no
+ * second membership storage — `meta` remembers the key, as the mark from
+ * data.
+ *
+ * The key comes from the group's instance (`uid`): the consumer has no reason
+ * to address a markup group by key, and there is no prop for it. The key does
+ * not go into the document, so the server and the browser do not compare it.
+ *
+ * The group registers its label in the grouping (`register`): the sections
+ * get it when `groups` has no label. The registration is separate from
+ * `groups` — resetting the prop does not erase the markup group's — and sets
+ * no order. The label changed — the group registers the new one over the old.
+ *
+ * Phases — as the field link's (`TFieldControlExtension`):
+ *
+ * - **assembly** — the link for the items: they read it at their assembly;
+ * - **entry** — the label's registration and the subscription to its change.
+ *   The grouping is someone else's storage, and the framework may throw an
+ *   assembled group away without accepting it. The entry is the context's
+ *   `attach` or the entry of the group's first item (`enter` of the link),
+ *   whichever comes first: React accepts the children before their parent,
+ *   and the items joined a group without its label — the sections came
+ *   unlabelled first (benchmarks/parity/README.md). An accepted item has an
+ *   accepted group above it, so the early entry registers no thrown-away
+ *   group;
+ * - **removal** (the context's `destroy`) — the unsubscription and the
+ *   registration removed.
+ *
+ * No collection above or it has no grouping — the group lowers an empty
+ * link: the items need no key, and a group link from above does not reach
+ * them. A group the owner draws for a section from data is the same part: no
+ * item has its key — an item from data takes no group key — and the
+ * registration does not change the sections.
+ *
+ * Usage:
+ *   adapter.use(TItemGroupExtension, { elevator: VueElevatorFactory })
+ */
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { IItemGroupExtensionOptions, TItemGroupPart } from './types';
+export declare class TItemGroupExtension {
+    constructor(context: TInstanceContext<TItemGroupPart>, options: IItemGroupExtensionOptions);
+}

package/dist/content/extensions/item-group/item-group.extension.class.js

@@ -0,0 +1,91 @@
+import { ITEM_CONTEXT_ELEVATOR } from "../../../protected/adapter/elevator/keys.js";
+import { ITEM_GROUP_ELEVATOR } from "./keys.js";
+import { groupOf } from "@soxa-ui/core";
+//#region content/extensions/item-group/item-group.extension.class.ts
+/**
+* TItemGroupExtension — a group part enters the collection's grouping: the key to the items inside, the label to the grouping.
+*
+* A markup group (`Menu.Group`, `Menu.RadioGroup`, `ListBox.Group`,
+* `Select.Group`) goes the same channel as the `_.group` mark in data: it
+* lowers its key along with its collection's engine down the elevator
+* (`ITEM_GROUP_ELEVATOR`), and an item inside puts the key into its marks
+* when it joins the collection (`TCollectionItemExtension`). There is no
+* second membership storage — `meta` remembers the key, as the mark from
+* data.
+*
+* The key comes from the group's instance (`uid`): the consumer has no reason
+* to address a markup group by key, and there is no prop for it. The key does
+* not go into the document, so the server and the browser do not compare it.
+*
+* The group registers its label in the grouping (`register`): the sections
+* get it when `groups` has no label. The registration is separate from
+* `groups` — resetting the prop does not erase the markup group's — and sets
+* no order. The label changed — the group registers the new one over the old.
+*
+* Phases — as the field link's (`TFieldControlExtension`):
+*
+* - **assembly** — the link for the items: they read it at their assembly;
+* - **entry** — the label's registration and the subscription to its change.
+*   The grouping is someone else's storage, and the framework may throw an
+*   assembled group away without accepting it. The entry is the context's
+*   `attach` or the entry of the group's first item (`enter` of the link),
+*   whichever comes first: React accepts the children before their parent,
+*   and the items joined a group without its label — the sections came
+*   unlabelled first (benchmarks/parity/README.md). An accepted item has an
+*   accepted group above it, so the early entry registers no thrown-away
+*   group;
+* - **removal** (the context's `destroy`) — the unsubscription and the
+*   registration removed.
+*
+* No collection above or it has no grouping — the group lowers an empty
+* link: the items need no key, and a group link from above does not reach
+* them. A group the owner draws for a section from data is the same part: no
+* item has its key — an item from data takes no group key — and the
+* registration does not change the sections.
+*
+* Usage:
+*   adapter.use(TItemGroupExtension, { elevator: VueElevatorFactory })
+*/
+var TItemGroupExtension = class {
+	constructor(context, options) {
+		const link = options.elevator(ITEM_GROUP_ELEVATOR);
+		const engine = options.elevator(ITEM_CONTEXT_ELEVATOR).up();
+		const grouping = groupOf(engine);
+		if (!engine || !grouping) {
+			link.down(null);
+			return;
+		}
+		const group = context.instance;
+		const key = `item-group:${group.uid}`;
+		/** Снятие последней регистрации: новая подпись регистрируется поверх прежней. */
+		let release;
+		/** Whether the group has entered the grouping — see «entry» above. */
+		let entered = false;
+		const register = () => {
+			release = grouping.register({
+				key,
+				label: group.label
+			});
+		};
+		const enter = () => {
+			if (entered) return;
+			entered = true;
+			register();
+			group.events.on("change:label", register);
+		};
+		link.down({
+			key,
+			engine,
+			enter
+		});
+		context.events.on("attach", enter);
+		context.events.on("destroy", () => {
+			entered = false;
+			group.events.off("change:label", register);
+			release?.();
+			release = void 0;
+		});
+	}
+};
+//#endregion
+export { TItemGroupExtension };

package/dist/content/extensions/item-group/keys.d.ts

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

package/dist/content/extensions/item-group/keys.js

@@ -0,0 +1,9 @@
+//#region content/extensions/item-group/keys.ts
+/**
+* Связка ближайшей группы выше по дереву. Пустое значение опускает группа
+* коллекции без группировки: элементам внутри ключ не нужен, и связка группы
+* выше до них не доходит.
+*/
+var ITEM_GROUP_ELEVATOR = { name: "soxa:item-group" };
+//#endregion
+export { ITEM_GROUP_ELEVATOR };

package/dist/content/extensions/item-group/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Контракты проводки группы элементов: что группа опускает по лифту, какой её видит проводка, и опции расширения.
+ */
+import type { TCollectionEngine, TItemGroupEvents } from '@soxa-ui/core';
+import type { IListenable } from '@soxa-ui/plugins';
+import type { TElevatorFactory } from '../../../protected/adapter/elevator';
+/**
+ * The link of a group with the items inside: the group's key in the
+ * collection's grouping and the engine of that collection. An item takes the
+ * key only if it is an item of the same engine: the items of a submenu in a
+ * menu group are items of their own collection.
+ *
+ * `enter` — the group enters the grouping, at the latest before its first
+ * item does (see `TItemGroupExtension`); a repeat does nothing.
+ */
+export interface IItemGroupLink {
+    readonly key: string;
+    readonly engine: TCollectionEngine<any, any>;
+    enter(): void;
+}
+/**
+ * Инстанс, к которому подключается расширение: часть группы — `Menu.Group`,
+ * `Menu.RadioGroup`, `ListBox.Group`, `Select.Group`. Ключ в группировке —
+ * от экземпляра (`uid`), подпись — с событием её смены: карта событий у форм
+ * разная, а смена подписи есть у всех.
+ */
+export type TItemGroupPart = {
+    readonly uid: number;
+    readonly label: string;
+    readonly events: IListenable<Pick<TItemGroupEvents, 'change:label'>>;
+};
+export interface IItemGroupExtensionOptions {
+    elevator: TElevatorFactory;
+}

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

@@ -0,0 +1,3 @@
+export { TMenuRadioGroupExtension } from './radio-group.extension.class';
+export { TMenuRadioItemExtension } from './radio-item.extension.class';
+export type { IMenuRadioGroupExtensionOptions, IMenuRadioItemExtensionOptions } from './types';

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

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

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

@@ -0,0 +1,5 @@
+//#region content/extensions/menu/keys.ts
+/** Ближайшая группа переключателей выше по дереву. */
+var MENU_RADIO_GROUP_ELEVATOR = { name: "soxa:menu-radio-group" };
+//#endregion
+export { MENU_RADIO_GROUP_ELEVATOR };

package/dist/content/extensions/menu/radio-group.extension.class.d.ts

@@ -0,0 +1,22 @@
+/**
+ * TMenuRadioGroupExtension — проводка группы переключателей `Menu.RadioGroup`: группа переключателям внутри себя.
+ *
+ * Группа опускает по лифту (`MENU_RADIO_GROUP_ELEVATOR`) себя, а переключатель
+ * внутри подхватывает её своим расширением (`TMenuRadioItemExtension`) — при
+ * сборке, до входа в коллекцию меню: меню отмечает его по значению группы уже
+ * на входе. Ни регистрации, ни подписок у группы нет, поэтому фаз контекста
+ * она не ждёт: правило «в группе отмечен один» и значение группы за отметкой
+ * держит расширение коллекции меню, пока переключатель группы в ней.
+ *
+ * Своей коллекции у группы нет: её переключатели — пункты меню, и навигация
+ * ходит по ним сквозь группу.
+ *
+ * Использование:
+ *   adapter.use(TMenuRadioGroupExtension, { elevator: VueElevatorFactory })
+ */
+import type { IMenuRadioGroup } from '@soxa-ui/core';
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { IMenuRadioGroupExtensionOptions } from './types';
+export declare class TMenuRadioGroupExtension {
+    constructor(context: TInstanceContext<IMenuRadioGroup>, options: IMenuRadioGroupExtensionOptions);
+}

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * TMenuRadioItemExtension — переключатель `Menu.RadioItem` берёт группу переключателей над собой.
+ *
+ * Группу опускает по лифту `Menu.RadioGroup` (`TMenuRadioGroupExtension`), и
+ * переключатель пишет её себе в `group` при сборке: это его свойство, а в
+ * коллекцию меню он входит позже, с приёмом (`attach`), — и меню застаёт его
+ * уже в группе. Лифт отдаёт ближайшую группу.
+ *
+ * Группы выше нет — переключатель остаётся со своей: вне разметки группы
+ * `null`, а у `ctrl`, которому группу дал код, — она.
+ *
+ * Использование:
+ *   adapter.use(TMenuRadioItemExtension, { elevator: VueElevatorFactory })
+ */
+import type { IMenuRadioItem } from '@soxa-ui/core';
+import type { TInstanceContext } from '../../../protected/adapter/context';
+import type { IMenuRadioItemExtensionOptions } from './types';
+export declare class TMenuRadioItemExtension {
+    constructor(context: TInstanceContext<IMenuRadioItem>, options: IMenuRadioItemExtensionOptions);
+}