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

package/dist/custom/calendar/parts.js

@@ -0,0 +1,119 @@
+import { listOf } from "../list/row.js";
+//#region src/custom/calendar/parts.ts
+/** Кнопки листания — по частям разметки владельца (`__prev`, `__next`). */
+var PAGERS = ["prev", "next"];
+/** Кнопки шапки панели выбора — `__picker-prev`, `__picker-next`, `__picker-heading`. */
+var PICKER_PARTS = [
+	"prev",
+	"next",
+	"heading"
+];
+/**
+* День календаря, в узле которого лежит `target`, — один поиск на оба плагина
+* календаря: клавиша, фокус, нажатие и наведение находят день одинаково.
+*
+* Узел дня — его корень, ячейка сетки; внутри неё плитка и содержимое слота,
+* и событие с них — тоже событие дня. Кому нужна сама ячейка (клавиши берутся
+* только с неё), сверяет `element` с целью события. Заполнитель соседнего
+* месяца днём не бывает: элемента коллекции у него нет, и узла среди узлов
+* дней — тоже.
+*/
+function dayOf(engine, elements, target) {
+	if (!elements || !(target instanceof Node)) return void 0;
+	for (const item of engine.extensions.batch.items) {
+		const element = elements.getElementByItem(item);
+		if (element?.contains(target)) return {
+			item,
+			element
+		};
+	}
+}
+/** Узел дня с такой датой, пока он в документе. */
+function dayElementOf(engine, elements, date) {
+	const item = engine.extensions.batch.items.find((candidate) => candidate.date === date);
+	const element = item ? elements?.getElementByItem(item) ?? null : null;
+	return element?.isConnected ? element : null;
+}
+/**
+* Лежит ли в узле шапка места `picker` — по ней панель выбора и узнаётся своей.
+*
+* Своей и своего места панель делает не место в DOM, а шапка: `id` шапки
+* места пишет плагин связок календаря, и панель, в которой его нет, чужая —
+* например, панель календаря, вложенного в этот.
+*/
+function holdsHeading(node, { labelledBy }) {
+	const heading = labelledBy ? node.ownerDocument.getElementById(labelledBy) : null;
+	return heading !== null && node.contains(heading);
+}
+/**
+* Кнопка шапки панели выбора месяца и года, в которой лежит `target`, панель
+* этой кнопки и место панели среди `pickers` — один поиск на оба плагина
+* календаря.
+*
+* Своей панель делает шапка места (`holdsHeading`). Части находят по классам
+* владельца (`classes.resolve`), как кнопки листания.
+*/
+function pickerPartOf(owner, pickers, target) {
+	if (!(target instanceof Element)) return void 0;
+	for (const part of PICKER_PARTS) {
+		const panel = target.closest(owner.classes.resolve(`__picker-${part}`, { point: true }))?.closest(owner.classes.resolve("__picker", { point: true }));
+		if (!panel) continue;
+		const index = pickers.findIndex((picker) => holdsHeading(panel, picker));
+		return index === -1 ? void 0 : {
+			part,
+			index,
+			panel
+		};
+	}
+}
+/**
+* Карточка панели выбора места `picker` в корне — ту же карточку отдаёт
+* `pickerPartOf` от кнопки её шапки. Своей её делает шапка места
+* (`holdsHeading`), часть находят по классу владельца (`classes.resolve`).
+* `null` — карточки в документе нет: содержимое поповера не смонтировано до
+* первого открытия.
+*/
+function pickerPanelOf(owner, root, picker) {
+	for (const panel of root.querySelectorAll(owner.classes.resolve("__picker", { point: true }))) if (holdsHeading(panel, picker)) return panel;
+	return null;
+}
+/**
+* Список карточки панели выбора — узел списка ListBox (`listOf`): остановка
+* Tab у списка — он, а не корень ListBox с классом части календаря. `null` —
+* карточки или списка в ней нет.
+*
+* Один на клавиатуру календаря (кому отдать фокус со стрелки, погасшей у
+* границы лет) и остановку календаря, пока панель открыта (`gridStopOf`).
+*/
+function pickerListOf(owner, panel) {
+	const list = panel?.querySelector(owner.classes.resolve("__picker-list", { point: true }));
+	return listOf(list ?? null);
+}
+/**
+* Место, чья подложка — `target`; `target` не подложка — `undefined`.
+*
+* Подложка — сама панель поповера места, а не узел в ней: панель накрывает
+* календарь, а выбирают в её содержимом, и у нажатия мимо содержимого цель —
+* панель. Псевдоэлемент панели — тоже панель: у нажатия по нему та же цель.
+* Панель находят по классу её поповера (`classes.resolve`), своей её делает
+* шапка места (`holdsHeading`).
+*/
+function pickerBackdropOf(pickers, target) {
+	if (!(target instanceof Element)) return void 0;
+	const index = pickers.findIndex((picker) => target.matches(picker.popover.classes.resolve("__panel", { point: true })) && holdsHeading(target, picker));
+	return index === -1 ? void 0 : index;
+}
+/**
+* Кнопка листания, в которой лежит `target`. Кнопки находят по классам
+* владельца (`classes.resolve`), а не строкой в плагине, и только внутри его
+* корня.
+*/
+function pagerOf(owner, root, target) {
+	if (!(target instanceof Element)) return void 0;
+	return PAGERS.find((pager) => {
+		const button = target.closest(owner.classes.resolve(`__${pager}`, { point: true }));
+		return button !== null && root.contains(button);
+	});
+}
+//#endregion
+export { dayElementOf, dayOf, pagerOf, pickerBackdropOf, pickerListOf, pickerPanelOf, pickerPartOf };

package/dist/custom/calendar/pointer/index.d.ts

@@ -0,0 +1,2 @@
+export { TCalendarPointerPlugin } from './pointer.plugin';
+export type { TCalendarPointerPluginEvents } from './types';

package/dist/custom/calendar/pointer/pointer.plugin.d.ts

@@ -0,0 +1,58 @@
+import type { ICalendar } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TCalendarPointerPluginEvents } from './types';
+/**
+ * TCalendarPointerPlugin — указатель календаря: нажатия по дням и кнопкам
+ * листания и наведение для предпросмотра диапазона.
+ *
+ * Слушатели — на корне, в разметке обработчиков нет: связка «нажали ⇄
+ * выбрали» и «нажали ⇄ листаем» повторялась бы в каждом из шести адаптеров
+ * (приём ленты Scroller). Дат плагин не считает, только зовёт команды
+ * расширений коллекции.
+ *
+ * - Нажатие по кнопке листания — `showPrev`/`showNext` вида. Enter и пробел на
+ *   кнопке дают тот же `click` — браузер делает его у `<button>` сам.
+ * - Нажатие по кнопке шапки панели выбора месяца и года — команда расширения
+ *   `picker` для места панели: стрелки листают год или страницу лет, кнопка
+ *   года меняет уровень. Панель — поповер внутри календаря (`contained`), и
+ *   её нажатия всплывают до корня; выбор в её списке ловит само расширение.
+ * - Нажатие по подложке панели выбора — по самой панели вокруг её
+ *   содержимого — `close` расширения `picker` для места; фокус на заголовок
+ *   возвращает плагин фокуса поповера. В счёт идёт только нажатие, которое
+ *   началось и кончилось на подложке, и только `click`, который никто не
+ *   погасил. `click` с целью «панель» дают и протяжка из содержимого за его
+ *   край — панель общий предок нажатия и отпускания, — и жест за полосу:
+ *   панель захватила указатель, а свой `click` жест гасит. Закрывает `click`,
+ *   а не `pointerdown`: иначе действие `mousedown` того же нажатия унесло бы
+ *   фокус, возвращённый на заголовок, на `body`.
+ * - Нажатие по дню — где угодно в ячейке, с плиткой и содержимым слота, —
+ *   `chooseDate` выбора. Недоступный и выключенный день выбор отклоняет сам,
+ *   по заполнителю соседнего месяца не происходит ничего: дня у него нет.
+ * - Наведение (не касание: палец над днём — это уже нажатие) — день под
+ *   указателем для предпросмотра (`notifyHover`); указатель на не-дне или
+ *   ушёл с корня — `undefined`.
+ */
+export declare class TCalendarPointerPlugin extends TBasePlugin<ICalendar, TCalendarPointerPluginEvents> {
+    private _owner;
+    private _root;
+    private _elements;
+    private _engine;
+    /**
+     * Место, по подложке которого нажали и не отпустили мимо неё, — до `click`
+     * этого нажатия; нажали не по подложке — `undefined`.
+     */
+    private _pressedBackdrop;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    /** Корень сменился — вместе с ним переезжают слушатели. */
+    private _bind;
+    private readonly _onClick;
+    /** Нажатие началось — по подложке ли: в счёт идёт только начатое на ней. */
+    private readonly _onPointerDown;
+    /** Отпустили не на той подложке, где нажали, — это уже не нажатие по ней. */
+    private readonly _onPointerUp;
+    private _backdropOf;
+    private readonly _onPointerOver;
+    private readonly _onPointerLeave;
+}

package/dist/custom/calendar/pointer/pointer.plugin.js

@@ -0,0 +1,144 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TCollectionBundlesPlugin } from "../../collection/bundles.plugin.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { TCollectionElements } from "../../collection/collection-elements.plugin.js";
+import { dayOf, pagerOf, pickerBackdropOf, pickerPartOf } from "../parts.js";
+//#region src/custom/calendar/pointer/pointer.plugin.ts
+/** Листание по кнопке — команда вида коллекции. */
+var PAGE = {
+	prev: (view) => view.showPrev(),
+	next: (view) => view.showNext()
+};
+/** Кнопки шапки панели выбора месяца и года — команды расширения `picker` для места. */
+var PICK = {
+	prev: (picker, index) => picker.showPrev(index),
+	next: (picker, index) => picker.showNext(index),
+	heading: (picker, index) => picker.toggleLevel(index)
+};
+/**
+* TCalendarPointerPlugin — указатель календаря: нажатия по дням и кнопкам
+* листания и наведение для предпросмотра диапазона.
+*
+* Слушатели — на корне, в разметке обработчиков нет: связка «нажали ⇄
+* выбрали» и «нажали ⇄ листаем» повторялась бы в каждом из шести адаптеров
+* (приём ленты Scroller). Дат плагин не считает, только зовёт команды
+* расширений коллекции.
+*
+* - Нажатие по кнопке листания — `showPrev`/`showNext` вида. Enter и пробел на
+*   кнопке дают тот же `click` — браузер делает его у `<button>` сам.
+* - Нажатие по кнопке шапки панели выбора месяца и года — команда расширения
+*   `picker` для места панели: стрелки листают год или страницу лет, кнопка
+*   года меняет уровень. Панель — поповер внутри календаря (`contained`), и
+*   её нажатия всплывают до корня; выбор в её списке ловит само расширение.
+* - Нажатие по подложке панели выбора — по самой панели вокруг её
+*   содержимого — `close` расширения `picker` для места; фокус на заголовок
+*   возвращает плагин фокуса поповера. В счёт идёт только нажатие, которое
+*   началось и кончилось на подложке, и только `click`, который никто не
+*   погасил. `click` с целью «панель» дают и протяжка из содержимого за его
+*   край — панель общий предок нажатия и отпускания, — и жест за полосу:
+*   панель захватила указатель, а свой `click` жест гасит. Закрывает `click`,
+*   а не `pointerdown`: иначе действие `mousedown` того же нажатия унесло бы
+*   фокус, возвращённый на заголовок, на `body`.
+* - Нажатие по дню — где угодно в ячейке, с плиткой и содержимым слота, —
+*   `chooseDate` выбора. Недоступный и выключенный день выбор отклоняет сам,
+*   по заполнителю соседнего месяца не происходит ничего: дня у него нет.
+* - Наведение (не касание: палец над днём — это уже нажатие) — день под
+*   указателем для предпросмотра (`notifyHover`); указатель на не-дне или
+*   ушёл с корня — `undefined`.
+*/
+var TCalendarPointerPlugin = class extends TBasePlugin {
+	_owner = null;
+	_root = null;
+	_elements = null;
+	_engine = null;
+	/**
+	* Место, по подложке которого нажали и не отпустили мимо неё, — до `click`
+	* этого нажатия; нажали не по подложке — `undefined`.
+	*/
+	_pressedBackdrop = void 0;
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance() ?? null;
+		this._elements = ctx.get(TCollectionElements) ?? null;
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => this._bind(element));
+		elementPlugin?.events.on("removed", () => this._bind(null));
+		ctx.get(TCollectionBundlesPlugin)?.events.on("engine:bound", (engine) => {
+			this._engine = engine;
+		});
+	}
+	destroy() {
+		this._bind(null);
+		this._owner = null;
+		this._elements = null;
+		this._engine = null;
+		super.destroy();
+	}
+	/** Корень сменился — вместе с ним переезжают слушатели. */
+	_bind(root) {
+		const previous = this._root;
+		previous?.removeEventListener("click", this._onClick);
+		previous?.removeEventListener("pointerdown", this._onPointerDown);
+		previous?.removeEventListener("pointerup", this._onPointerUp);
+		previous?.removeEventListener("pointerover", this._onPointerOver);
+		previous?.removeEventListener("pointerleave", this._onPointerLeave);
+		this._root = root;
+		this._pressedBackdrop = void 0;
+		const target = root;
+		target?.addEventListener("click", this._onClick);
+		target?.addEventListener("pointerdown", this._onPointerDown);
+		target?.addEventListener("pointerup", this._onPointerUp);
+		target?.addEventListener("pointerover", this._onPointerOver);
+		target?.addEventListener("pointerleave", this._onPointerLeave);
+	}
+	_onClick = (event) => {
+		const engine = this._engine;
+		const owner = this._owner;
+		const root = this._root;
+		const pressed = this._pressedBackdrop;
+		this._pressedBackdrop = void 0;
+		if (!engine || !owner || !root) return;
+		const picker = engine.extensions.picker;
+		const pickers = picker.pickers;
+		const hit = pickerPartOf(owner, pickers, event.target);
+		if (hit) {
+			PICK[hit.part](picker, hit.index);
+			return;
+		}
+		const backdrop = pickerBackdropOf(pickers, event.target);
+		if (backdrop !== void 0) {
+			if (backdrop === pressed && !event.defaultPrevented) picker.close(backdrop);
+			return;
+		}
+		const pager = pagerOf(owner, root, event.target);
+		if (pager) {
+			PAGE[pager](engine.extensions.view);
+			return;
+		}
+		const day = dayOf(engine, this._elements, event.target);
+		if (day) engine.extensions.selection.chooseDate(day.item.date);
+	};
+	/** Нажатие началось — по подложке ли: в счёт идёт только начатое на ней. */
+	_onPointerDown = (event) => {
+		this._pressedBackdrop = this._backdropOf(event.target);
+	};
+	/** Отпустили не на той подложке, где нажали, — это уже не нажатие по ней. */
+	_onPointerUp = (event) => {
+		if (this._backdropOf(event.target) !== this._pressedBackdrop) this._pressedBackdrop = void 0;
+	};
+	_backdropOf(target) {
+		const engine = this._engine;
+		return engine ? pickerBackdropOf(engine.extensions.picker.pickers, target) : void 0;
+	}
+	_onPointerOver = (event) => {
+		const engine = this._engine;
+		if (!engine || event.pointerType === "touch") return;
+		const day = dayOf(engine, this._elements, event.target);
+		engine.extensions.selection.notifyHover(day?.item.date);
+	};
+	_onPointerLeave = () => {
+		this._engine?.extensions.selection.notifyHover(void 0);
+	};
+};
+//#endregion
+export { TCalendarPointerPlugin };

package/dist/custom/calendar/pointer/types.d.ts

@@ -0,0 +1,6 @@
+import type { TPluginEvents } from '../../../base';
+/**
+ * Своих событий у плагина нет: нажатие и наведение видны в расширениях
+ * коллекции — выборе, якоре, дне под указателем и месяцах сеток.
+ */
+export type TCalendarPointerPluginEvents = TPluginEvents;

package/dist/custom/calendar/stop.d.ts

@@ -0,0 +1,20 @@
+import type { IPluginContext } from '../../base';
+/**
+ * Остановка календаря — узел фокуса Calendar (`focusTarget` плагина
+ * действия): запись `focused = true` ставит фокус туда же, куда ведёт Tab.
+ *
+ * Все сетки — одна остановка, день с фокусом коллекции (`focusedDate`), и
+ * узел дня — тот же, на который фокус переносит клавиатура календаря
+ * (`dayElementOf`). День берётся по модели, а не по `[tabindex="0"]`: в такте
+ * смены фокуса коллекции разметка ещё старая, и фокус ушёл бы на прежний день.
+ * Пока открыта панель выбора месяца и года, сетка под её подложкой, а
+ * остановка — список панели (`pickerListOf`), как у стрелки панели, погасшей
+ * под фокусом.
+ *
+ * `null` — узла нет в документе: день нового месяца в такте листания ещё не
+ * нарисован, содержимое панели не смонтировано до первого открытия. День
+ * запись `focused` дождётся: его узел приносит элемент коллекции календаря, и
+ * плагин действия зовёт правило снова. Список панели — нет: он не элемент
+ * этой коллекции, и о его узле календарь не узнаёт.
+ */
+export declare function gridStopOf(root: Element, ctx: IPluginContext): Element | null;

package/dist/custom/calendar/stop.js

@@ -0,0 +1,32 @@
+import { TCollectionElements } from "../collection/collection-elements.plugin.js";
+import { dayElementOf, pickerListOf, pickerPanelOf } from "./parts.js";
+//#region src/custom/calendar/stop.ts
+/**
+* Остановка календаря — узел фокуса Calendar (`focusTarget` плагина
+* действия): запись `focused = true` ставит фокус туда же, куда ведёт Tab.
+*
+* Все сетки — одна остановка, день с фокусом коллекции (`focusedDate`), и
+* узел дня — тот же, на который фокус переносит клавиатура календаря
+* (`dayElementOf`). День берётся по модели, а не по `[tabindex="0"]`: в такте
+* смены фокуса коллекции разметка ещё старая, и фокус ушёл бы на прежний день.
+* Пока открыта панель выбора месяца и года, сетка под её подложкой, а
+* остановка — список панели (`pickerListOf`), как у стрелки панели, погасшей
+* под фокусом.
+*
+* `null` — узла нет в документе: день нового месяца в такте листания ещё не
+* нарисован, содержимое панели не смонтировано до первого открытия. День
+* запись `focused` дождётся: его узел приносит элемент коллекции календаря, и
+* плагин действия зовёт правило снова. Список панели — нет: он не элемент
+* этой коллекции, и о его узле календарь не узнаёт.
+*/
+function gridStopOf(root, ctx) {
+	const owner = ctx.getInstance();
+	const elements = ctx.get(TCollectionElements) ?? null;
+	const engine = elements?.engine ?? null;
+	if (!owner || !engine) return null;
+	const picker = engine.extensions.picker.pickers.find((place) => place.popover.open);
+	if (picker) return pickerListOf(owner, pickerPanelOf(owner, root, picker));
+	return dayElementOf(engine, elements, engine.extensions.focus.focusedDate);
+}
+//#endregion
+export { gridStopOf };

package/dist/custom/calendar/types.d.ts

@@ -0,0 +1,16 @@
+import type { ICalendarItem } from '@soxa-ui/core';
+/** Кнопка листания календаря: «предыдущий месяц» или «следующий». */
+export type TCalendarPager = 'prev' | 'next';
+/** Кнопка шапки панели выбора месяца и года: стрелка или кнопка уровня. */
+export type TCalendarPickerPart = TCalendarPager | 'heading';
+/** Кнопка шапки панели выбора, место панели и её узел. */
+export type TCalendarPickerHit = {
+    part: TCalendarPickerPart;
+    index: number;
+    panel: Element;
+};
+/** День календаря и его узел — корень дня, ячейка сетки. */
+export type TCalendarDay = {
+    item: ICalendarItem;
+    element: Element;
+};

package/dist/custom/clearable/index.d.ts

@@ -0,0 +1 @@
+export * from './names';

package/dist/custom/clearable/names/index.d.ts

@@ -0,0 +1 @@
+export * from './names.plugin';

package/dist/custom/clearable/names/names.plugin.d.ts

@@ -0,0 +1,24 @@
+import type { IClearable } from '@soxa-ui/core';
+import type { TPluginEvents } from '../../../base';
+import { TNamesPlugin } from '../../../locale/names.plugin';
+import type { TTranslations } from '../../../locale/types';
+/**
+ * TClearableNamesPlugin — имя кнопки очистки поля от локали: в `clearAria`,
+ * вместе с именем поля — «Clear Город».
+ *
+ * Без имени поля на форме с пятью полями в списке элементов скринридера было
+ * бы пять одинаковых «Clear, кнопка». Как имя складывается с именем поля,
+ * решает шаблон локали (`field.clear`). Сменилось имя — имя кнопки
+ * переписывается.
+ *
+ * Ставится наследникам базы очистки (`TClearable`) — текстовому полю и полю
+ * даты, — а через наследников — DatePicker (`TDatePickerNamesPlugin`) и полю
+ * числа (`TNumberInputNamesPlugin`): плагин имён у компонента один, и самой
+ * базе он не ставится. Дженерик по владельцу и событиям — для наследника, у
+ * которого кнопок больше. Строка — из раздела локали `field`: формат локали
+ * публичный, и имя раздела осталось прежним.
+ */
+export declare class TClearableNamesPlugin<TOwner extends IClearable<any, any, any> = IClearable<unknown>, TEvents extends TPluginEvents = TPluginEvents> extends TNamesPlugin<TOwner, TEvents> {
+    protected _name(owner: TOwner, translations: TTranslations): void;
+    protected _watch(owner: TOwner, name: () => void): void;
+}

package/dist/custom/clearable/names/names.plugin.js

@@ -0,0 +1,29 @@
+import { formatName } from "../../../locale/locale.js";
+import { TNamesPlugin } from "../../../locale/names.plugin.js";
+//#region src/custom/clearable/names/names.plugin.ts
+/**
+* TClearableNamesPlugin — имя кнопки очистки поля от локали: в `clearAria`,
+* вместе с именем поля — «Clear Город».
+*
+* Без имени поля на форме с пятью полями в списке элементов скринридера было
+* бы пять одинаковых «Clear, кнопка». Как имя складывается с именем поля,
+* решает шаблон локали (`field.clear`). Сменилось имя — имя кнопки
+* переписывается.
+*
+* Ставится наследникам базы очистки (`TClearable`) — текстовому полю и полю
+* даты, — а через наследников — DatePicker (`TDatePickerNamesPlugin`) и полю
+* числа (`TNumberInputNamesPlugin`): плагин имён у компонента один, и самой
+* базе он не ставится. Дженерик по владельцу и событиям — для наследника, у
+* которого кнопок больше. Строка — из раздела локали `field`: формат локали
+* публичный, и имя раздела осталось прежним.
+*/
+var TClearableNamesPlugin = class extends TNamesPlugin {
+	_name(owner, translations) {
+		owner.clearAria.add("aria-label", formatName(translations.field.clear, owner.name));
+	}
+	_watch(owner, name) {
+		this._listenTo(owner.events, "change:name", name);
+	}
+};
+//#endregion
+export { TClearableNamesPlugin };

package/dist/custom/collection/bundles.plugin.d.ts

@@ -0,0 +1,55 @@
+import { TBasePlugin } from '../../base';
+import type { IPluginBundle } from '../../base';
+import type { TCollectionEngine } from '@soxa-ui/core';
+import type { TBundlesEvents } from './types';
+/**
+ * TCollectionBundlesPlugin — реестр plugin-bundles элементов коллекции.
+ *
+ * Держит ссылку на коллекцию (`engine`), поэтому любой плагин имеет доступ
+ * ко всему состоянию коллекции (активный элемент, порядок, элементы) без костылей
+ * для каждого отдельного свойства.
+ *
+ * Накапливает ТОЛЬКО bundles: Map<uid, IPluginBundle>. Реестр синхронизируется с
+ * жизненным циклом элементов коллекции через события `plain` (`item:removed`, `reset`).
+ * Порядок bundles всегда берётся из коллекции, поэтому `item:moved` не требует
+ * дополнительной обработки.
+ *
+ * Запись живёт, пока набор элемента в документе, и о каждой снятой записи
+ * реестр сообщает `bundle:unregistered` — кончилось ли монтирование элемента
+ * из данных (`release`) или элемент ушёл из коллекции: убран из данных, снят
+ * из разметки, коллекцию очистили. Иначе подписчик, который держит что-то за
+ * набором элемента (ссылку `aria-activedescendant` на его `id`, наблюдатель
+ * его узла), узнавал бы только об одном из путей.
+ *
+ * Устанавливается на owner-компоненте коллекции (например, Tabs). Коллекция
+ * привязывается через {@link bindEngine} из adapter-слоя после её создания.
+ */
+export declare class TCollectionBundlesPlugin extends TBasePlugin<any, TBundlesEvents> {
+    private _engine;
+    private readonly _bundles;
+    /** Привязать коллекцию. Вызывается adapter-слоем после создания коллекции. */
+    bindEngine(engine: TCollectionEngine<any, any>): void;
+    /** Ссылка на коллекцию, к которой привязан реестр. */
+    get engine(): TCollectionEngine<any, any> | null;
+    /** Зарегистрировать bundle элемента коллекции (ключ — uid элемента). */
+    register(bundle: IPluginBundle, item: unknown): void;
+    /**
+     * Отпустить bundle элемента, чьё монтирование кончилось: запись снимается,
+     * только если она всё ещё его. Элемент из данных остаётся в коллекции и
+     * после размонтирования — отбор или окно таблицы его прячут, — и без этого
+     * запись держала бы bundle с отсоединённым узлом, пока элемент не удалят.
+     * Новое монтирование того же элемента регистрирует свой bundle раньше, чем
+     * прежнее снимается (React пересобирает до очистки), — его запись не
+     * трогается.
+     */
+    release(bundle: IPluginBundle, item: unknown): void;
+    /** Снять регистрацию bundle элемента коллекции. */
+    unregister(uid: string | number): void;
+    /** Bundle элемента по uid. */
+    getByUid(uid: string | number): IPluginBundle | undefined;
+    /** Bundle по элементу коллекции. */
+    getByItem(item: unknown): IPluginBundle | undefined;
+    /** Все bundles в порядке элементов коллекции. */
+    getAll(): IPluginBundle[];
+    private _uid;
+}

package/dist/custom/collection/bundles.plugin.js

@@ -0,0 +1,100 @@
+import { TBasePlugin } from "../../base/base.class.js";
+import { batchOf, plainOf } from "@soxa-ui/core";
+//#region src/custom/collection/bundles.plugin.ts
+/**
+* TCollectionBundlesPlugin — реестр plugin-bundles элементов коллекции.
+*
+* Держит ссылку на коллекцию (`engine`), поэтому любой плагин имеет доступ
+* ко всему состоянию коллекции (активный элемент, порядок, элементы) без костылей
+* для каждого отдельного свойства.
+*
+* Накапливает ТОЛЬКО bundles: Map<uid, IPluginBundle>. Реестр синхронизируется с
+* жизненным циклом элементов коллекции через события `plain` (`item:removed`, `reset`).
+* Порядок bundles всегда берётся из коллекции, поэтому `item:moved` не требует
+* дополнительной обработки.
+*
+* Запись живёт, пока набор элемента в документе, и о каждой снятой записи
+* реестр сообщает `bundle:unregistered` — кончилось ли монтирование элемента
+* из данных (`release`) или элемент ушёл из коллекции: убран из данных, снят
+* из разметки, коллекцию очистили. Иначе подписчик, который держит что-то за
+* набором элемента (ссылку `aria-activedescendant` на его `id`, наблюдатель
+* его узла), узнавал бы только об одном из путей.
+*
+* Устанавливается на owner-компоненте коллекции (например, Tabs). Коллекция
+* привязывается через {@link bindEngine} из adapter-слоя после её создания.
+*/
+var TCollectionBundlesPlugin = class extends TBasePlugin {
+	_engine = null;
+	_bundles = /* @__PURE__ */ new Map();
+	/** Привязать коллекцию. Вызывается adapter-слоем после создания коллекции. */
+	bindEngine(engine) {
+		if (this._engine === engine) return;
+		this._engine = engine;
+		const plain = plainOf(engine);
+		this._listenTo(plain?.events, "item:removed", (e) => {
+			const uid = this._uid(e.item);
+			if (uid !== void 0 && this._bundles.has(uid)) this.unregister(uid);
+		});
+		this._listenTo(plain?.events, "reset", () => {
+			for (const uid of [...this._bundles.keys()]) this.unregister(uid);
+		});
+		this.events.emit("engine:bound", engine);
+	}
+	/** Ссылка на коллекцию, к которой привязан реестр. */
+	get engine() {
+		return this._engine;
+	}
+	/** Зарегистрировать bundle элемента коллекции (ключ — uid элемента). */
+	register(bundle, item) {
+		const uid = this._uid(item);
+		if (uid === void 0) return;
+		this._bundles.set(uid, bundle);
+		this.events.emit("bundle:registered", {
+			uid,
+			bundle
+		});
+	}
+	/**
+	* Отпустить bundle элемента, чьё монтирование кончилось: запись снимается,
+	* только если она всё ещё его. Элемент из данных остаётся в коллекции и
+	* после размонтирования — отбор или окно таблицы его прячут, — и без этого
+	* запись держала бы bundle с отсоединённым узлом, пока элемент не удалят.
+	* Новое монтирование того же элемента регистрирует свой bundle раньше, чем
+	* прежнее снимается (React пересобирает до очистки), — его запись не
+	* трогается.
+	*/
+	release(bundle, item) {
+		const uid = this._uid(item);
+		if (uid === void 0 || this._bundles.get(uid) !== bundle) return;
+		this.unregister(uid);
+	}
+	/** Снять регистрацию bundle элемента коллекции. */
+	unregister(uid) {
+		this._bundles.delete(uid);
+		this.events.emit("bundle:unregistered", { uid });
+	}
+	/** Bundle элемента по uid. */
+	getByUid(uid) {
+		return this._bundles.get(uid);
+	}
+	/** Bundle по элементу коллекции. */
+	getByItem(item) {
+		const uid = this._uid(item);
+		return uid === void 0 ? void 0 : this._bundles.get(uid);
+	}
+	/** Все bundles в порядке элементов коллекции. */
+	getAll() {
+		if (!this._engine) return Array.from(this._bundles.values());
+		const result = [];
+		for (const item of batchOf(this._engine)?.items ?? []) {
+			const bundle = this.getByItem(item);
+			if (bundle) result.push(bundle);
+		}
+		return result;
+	}
+	_uid(item) {
+		return item?.uid;
+	}
+};
+//#endregion
+export { TCollectionBundlesPlugin };