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

package/dist/custom/toasts/cascade/cascade.plugin.js

@@ -0,0 +1,214 @@
+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 { isFocusableElement } from "../../../utils/isFocusableElement.js";
+//#region src/custom/toasts/cascade/cascade.plugin.ts
+/**
+* Сколько прокрутить колесом, чтобы стопка сделала шаг, px. Щелчок колеса
+* мыши — около сотни пикселей, и шаг он делает сразу. Тачпад шлёт события
+* мелкими долями, и они копятся: случайное касание стопку не листает.
+*/
+var WHEEL_STEP = 50;
+/**
+* Тишина колеса, после которой жест кончился, мс. Инерция тачпада и щелчки,
+* идущие подряд, — один жест и один шаг: стопка из трёх тостов иначе
+* пролисталась бы одним взмахом по кругу.
+*/
+var WHEEL_GESTURE_END = 200;
+/** Поле, которому стрелки нужны самому: ввод, выбор, редактируемый текст. */
+var TAKES_ARROWS = "input, select, textarea, [contenteditable]:not([contenteditable=\"false\"])";
+/**
+* TToastsCascadePlugin — листание стопки тостов (`layout: 'cascade'`).
+*
+* В стопке тосты перекрывают друг друга. Передний — первый по порядку
+* коллекции, а вывести задний вперёд — перестановка (`plain.move`): своего
+* состояния «передний» у тоста нет, и экран со скринридером видят один
+* порядок. Шаг стопки — поворот открытых показанных тостов по кругу:
+*
+* - **колесо** над регионом: вниз — передний уходит назад, вверх — задний
+*   выходит вперёд. Шаг один на жест колеса (`WHEEL_GESTURE_END`), прокрутка
+*   копится до порога (`WHEEL_STEP`), колесо жеста гасится — страница под
+*   стопкой не едет. Колесо с Ctrl — масштаб окна, а вбок — не наше;
+* - **стрелки ↓ и ↑** при фокусе на тосте — то же самое, и фокус переходит на
+*   новый передний: тот, кого читают, всегда впереди. Стрелки поля ввода и
+*   списка в своём содержимом тоста не перехватываются, погашенные раньше —
+*   тоже.
+*
+* **Передний для шага — тост под фокусом.** Фокус Tab на заднем тосте выводит
+* его вперёд темой, по `:focus-within`, без перестановки: перестановка на
+* фокус ставила бы тост под фокусом первым в документе, и следующий Tab
+* приходил бы в прежний передний — по кругу, без выхода из региона. Поэтому
+* шаг считается от того, что видно: тост под фокусом впереди, остальные — за
+* ним по порядку.
+*
+* Закрытые тосты, которые ещё гаснут, в повороте не участвуют и встают за
+* открытыми; ждущие за пределом видимых не трогаются. Открытых меньше двух —
+* листать нечего, и колесо со стрелками остаются странице.
+*
+* **Фокус после перерисовки.** Переставленный узел браузер переносит в
+* документе, и фокус с него уходит. Поэтому, если фокус был на тосте, плагин
+* ставит его новому переднему сразу и ещё раз кадром позже, когда разметка уже
+* переставлена, — как перестановка колонки Table.
+*
+* Без стопки (`list`) плагин ничего не делает: колесо и стрелки остаются
+* странице. Слушатели висят, пока есть узел региона.
+*/
+var TToastsCascadePlugin = class extends TBasePlugin {
+	_owner = null;
+	_engine = null;
+	_elements = null;
+	/** Узел региона: на нём слушатели колеса и клавиш. */
+	_region = null;
+	/** Жест колеса; `null` — колесо стоит. */
+	_gesture = null;
+	/** Конец жеста — по тишине колеса. */
+	_gestureTimer = null;
+	/** Возврат фокуса после перерисовки. */
+	_frame = null;
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance();
+		this._elements = ctx.get(TCollectionElements) ?? null;
+		const element = ctx.get(TElementPlugin);
+		element?.events.on("ready", (node) => this._attach(node));
+		element?.events.on("removed", () => this._detach());
+		ctx.get(TCollectionBundlesPlugin)?.events.on("engine:bound", (engine) => {
+			this._engine = engine;
+		});
+	}
+	destroy() {
+		this._detach();
+		this._owner = null;
+		this._engine = null;
+		this._elements = null;
+		super.destroy();
+	}
+	_attach(node) {
+		this._detach();
+		const region = node;
+		region.addEventListener("wheel", this._onWheel, { passive: false });
+		region.addEventListener("keydown", this._onKeyDown);
+		this._region = region;
+	}
+	_detach() {
+		this._region?.removeEventListener("wheel", this._onWheel);
+		this._region?.removeEventListener("keydown", this._onKeyDown);
+		this._region = null;
+		this._endGesture();
+		this._cancelFrame();
+	}
+	/** Тосты стоят стопкой. */
+	get _cascade() {
+		return this._owner?.layout === "cascade";
+	}
+	_onWheel = (event) => {
+		if (!this._cascade || event.ctrlKey || event.defaultPrevented) return;
+		const distance = wheelDistance(event);
+		if (distance === 0 || this._open().length < 2) return;
+		event.preventDefault();
+		const gesture = this._gesture ?? {
+			distance: 0,
+			stepped: false
+		};
+		this._gesture = gesture;
+		this._restartGesture();
+		if (gesture.stepped) return;
+		gesture.distance += distance;
+		if (Math.abs(gesture.distance) < WHEEL_STEP) return;
+		gesture.stepped = true;
+		const focused = this._toastOf(this._region?.ownerDocument?.activeElement ?? null);
+		const front = this._step(gesture.distance > 0 ? 1 : -1, focused);
+		if (front && focused) this._focus(front);
+	};
+	_onKeyDown = (event) => {
+		if (!this._cascade || event.defaultPrevented) return;
+		if (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey) return;
+		const step = arrowStep(event.key);
+		if (step === null || takesArrows(event.target)) return;
+		const toast = this._toastOf(event.target);
+		if (!toast) return;
+		const front = this._step(step, toast);
+		if (!front) return;
+		event.preventDefault();
+		this._focus(front);
+	};
+	/**
+	* Шаг стопки от тоста `reference` (под фокусом), а без него — от первого
+	* открытого. Новый порядок пишется перестановками одной пачкой: подписчики
+	* получают одно `change:items`. Отдаёт новый передний; листать нечего —
+	* `undefined`.
+	*
+	* Показанные — начало состава: предел видимых (`items:query:before`
+	* расширения `toasts`) берёт первые `max`, поэтому место тоста среди
+	* показанных и есть его индекс в коллекции.
+	*/
+	_step(direction, reference) {
+		const engine = this._engine;
+		const shown = engine?.extensions.batch.shown ?? [];
+		const open = shown.filter((toast) => toast.open);
+		const front = reference && open.includes(reference) ? reference : open[0];
+		if (!engine || !front || open.length < 2) return void 0;
+		const stack = [front, ...open.filter((toast) => toast !== front)];
+		const turned = direction === 1 ? [...stack.slice(1), front] : [...stack.slice(-1), ...stack.slice(0, -1)];
+		const order = [...turned, ...shown.filter((toast) => !toast.open)];
+		const { plain } = engine.extensions;
+		engine.batch(() => order.forEach((toast, index) => plain.move(toast, index)));
+		return turned[0];
+	}
+	/** Фокус — переднему, и ещё раз, когда разметка переставлена. */
+	_focus(toast) {
+		const node = this._elements?.getElementByItem(toast);
+		if (!isFocusableElement(node)) return;
+		node.focus();
+		this._cancelFrame();
+		this._frame = requestAnimationFrame(() => {
+			this._frame = null;
+			if (node.isConnected && node.ownerDocument.activeElement !== node) node.focus();
+		});
+	}
+	/** Открытые показанные тосты — то, что листается. */
+	_open() {
+		return this._engine?.extensions.batch.shown.filter((toast) => toast.open) ?? [];
+	}
+	/** Открытый показанный тост, чей узел содержит цель. */
+	_toastOf(target) {
+		if (!(target instanceof Node)) return void 0;
+		return this._open().find((toast) => this._elements?.getElementByItem(toast)?.contains(target));
+	}
+	_restartGesture() {
+		if (this._gestureTimer !== null) clearTimeout(this._gestureTimer);
+		this._gestureTimer = setTimeout(() => this._endGesture(), WHEEL_GESTURE_END);
+	}
+	_endGesture() {
+		if (this._gestureTimer !== null) clearTimeout(this._gestureTimer);
+		this._gestureTimer = null;
+		this._gesture = null;
+	}
+	_cancelFrame() {
+		if (this._frame === null) return;
+		cancelAnimationFrame(this._frame);
+		this._frame = null;
+	}
+};
+/**
+* Прокрутка колесом по вертикали, px со знаком оси окна; `0` — колесо вбок
+* (поперёк стопки) или стоит. Строки и страницы (`deltaMode` не пиксели)
+* пикселей не знают: такой щелчок — сразу шаг.
+*/
+function wheelDistance(event) {
+	if (event.deltaY === 0 || Math.abs(event.deltaY) < Math.abs(event.deltaX)) return 0;
+	return event.deltaMode === 0 ? event.deltaY : Math.sign(event.deltaY) * WHEEL_STEP;
+}
+/** Шаг стрелки: ↓ — передний назад, ↑ — задний вперёд; другая клавиша — `null`. */
+function arrowStep(key) {
+	if (key === "ArrowDown") return 1;
+	if (key === "ArrowUp") return -1;
+	return null;
+}
+/** Цель — поле, которому стрелки нужны самому. */
+function takesArrows(target) {
+	return target instanceof Element && target.closest(TAKES_ARROWS) !== null;
+}
+//#endregion
+export { TToastsCascadePlugin };

package/dist/custom/toasts/cascade/index.d.ts

@@ -0,0 +1,2 @@
+export { TToastsCascadePlugin } from './cascade.plugin';
+export type { TCascadeStep, TToastsCascadePluginEvents, TWheelGesture } from './types';

package/dist/custom/toasts/cascade/types.d.ts

@@ -0,0 +1,15 @@
+import type { TPluginEvents } from '../../../base';
+/**
+ * Своих событий у плагина нет: шаг стопки виден через коллекцию — перестановку
+ * сообщают `item:moved` и `change:order`, а фокус — DOM.
+ */
+export type TToastsCascadePluginEvents = TPluginEvents;
+/** Шаг стопки: `1` — передний уходит назад, `-1` — задний выходит вперёд. */
+export type TCascadeStep = 1 | -1;
+/** Жест колеса: сколько прокрутили с его начала и был ли уже шаг. */
+export type TWheelGesture = {
+    /** Прокрутка с начала жеста, px со знаком оси окна */
+    distance: number;
+    /** Шаг в этом жесте уже был: остаток жеста стопку не листает */
+    stepped: boolean;
+};

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

@@ -0,0 +1,7 @@
+export * from './timer';
+export * from './removal';
+export * from './keyboard';
+export * from './cascade';
+export * from './layout';
+export * from './names';
+export * from './item-names';

package/dist/custom/toasts/item-names/index.d.ts

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

package/dist/custom/toasts/item-names/item-names.plugin.d.ts

@@ -0,0 +1,12 @@
+import type { IToastsItem } from '@soxa-ui/core';
+import { TNamesPlugin } from '../../../locale/names.plugin';
+import type { TTranslations } from '../../../locale/types';
+/**
+ * TToastsItemNamesPlugin — имя кнопки закрытия тоста от локали: в `closeAria`,
+ * вместе с текстом тоста («Закрыть Сохранено»), как у тега. Пять одинаковых
+ * «Закрыть» в стопке скринридер не различил бы.
+ */
+export declare class TToastsItemNamesPlugin extends TNamesPlugin<IToastsItem> {
+    protected _name(owner: IToastsItem, translations: TTranslations): void;
+    protected _watch(owner: IToastsItem, name: () => void): void;
+}

package/dist/custom/toasts/item-names/item-names.plugin.js

@@ -0,0 +1,18 @@
+import { formatName } from "../../../locale/locale.js";
+import { TNamesPlugin } from "../../../locale/names.plugin.js";
+//#region src/custom/toasts/item-names/item-names.plugin.ts
+/**
+* TToastsItemNamesPlugin — имя кнопки закрытия тоста от локали: в `closeAria`,
+* вместе с текстом тоста («Закрыть Сохранено»), как у тега. Пять одинаковых
+* «Закрыть» в стопке скринридер не различил бы.
+*/
+var TToastsItemNamesPlugin = class extends TNamesPlugin {
+	_name(owner, translations) {
+		owner.closeAria.add("aria-label", formatName(translations.toasts.close, owner.text));
+	}
+	_watch(owner, name) {
+		this._listenTo(owner.events, "change:text", name);
+	}
+};
+//#endregion
+export { TToastsItemNamesPlugin };

package/dist/custom/toasts/keyboard/index.d.ts

@@ -0,0 +1,2 @@
+export { TToastsKeyboardPlugin } from './keyboard.plugin';
+export type { TToastsKeyboardPluginEvents } from './types';

package/dist/custom/toasts/keyboard/keyboard.plugin.d.ts

@@ -0,0 +1,57 @@
+import type { IToasts } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TToastsKeyboardPluginEvents } from './types';
+/**
+ * TToastsKeyboardPlugin — клавиатура тостов.
+ *
+ * Тосты фокус не забирают: появившееся уведомление не прерывает работу.
+ * Дойти до них с клавиатуры — F8 (как в Radix), её же называет имя региона
+ * («Уведомления (F8)»):
+ *
+ * - **F8** без модификаторов, если клавишу не погасили, поднимает регион над
+ *   слоями (`raise`), запоминает, где был фокус вне региона, и ведёт фокус на
+ *   новейший открытый тост. Тостов нет — клавиша не наша, и её никто не
+ *   гасит;
+ * - **Escape** на тосте под фокусом (или на контроле в нём) закрывает его и
+ *   гасится `preventDefault`. Погашенный раньше — например, поповером из
+ *   содержимого тоста — тост не трогает: клавиша адресована верхнему слою;
+ * - **закрыли тост с фокусом** — крестиком, Escape, жестом или таймером, —
+ *   фокус переходит соседнему открытому тосту, а если его нет — туда, где он
+ *   был до перехода в регион. Иначе он остался бы на гаснущем тосте и ушёл бы
+ *   на `body`, когда тост уйдёт из документа.
+ *
+ * Слушатели висят, пока есть узел региона.
+ */
+export declare class TToastsKeyboardPlugin extends TBasePlugin<IToasts, TToastsKeyboardPluginEvents> {
+    private _owner;
+    private _engine;
+    private _elements;
+    /** Узел региона: на нём слушатели Escape и входа фокуса. */
+    private _region;
+    private _document;
+    /** Где был фокус до перехода в регион: туда он вернётся, когда тостов не останется. */
+    private _return;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    private _bindEngine;
+    private _attach;
+    private _detach;
+    /** F8 — фокус на новейший открытый тост. */
+    private readonly _onDocumentKeyDown;
+    /** Escape на тосте — закрыть его. */
+    private readonly _onRegionKeyDown;
+    /**
+     * Фокус пришёл в регион снаружи — запомнить откуда: Tab и нажатие тоже
+     * приводят к тостам, не только F8.
+     */
+    private readonly _onFocusIn;
+    /** Закрыли тост с фокусом — фокус соседу, иначе туда, откуда пришли. */
+    private _passFocus;
+    /** Новейший открытый тост с узлом, который можно сфокусировать. */
+    private _newest;
+    /** Сосед закрытого тоста — следующий открытый, у последнего — предыдущий. */
+    private _neighbour;
+    /** Тост, чей узел содержит цель события. */
+    private _toastOf;
+}

package/dist/custom/toasts/keyboard/keyboard.plugin.js

@@ -0,0 +1,136 @@
+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 { isFocusableElement } from "../../../utils/isFocusableElement.js";
+//#region src/custom/toasts/keyboard/keyboard.plugin.ts
+/** Клавиша, которая ведёт фокус к тостам. F6 занят браузером — переход между панелями окна. */
+var HOTKEY = "F8";
+/**
+* TToastsKeyboardPlugin — клавиатура тостов.
+*
+* Тосты фокус не забирают: появившееся уведомление не прерывает работу.
+* Дойти до них с клавиатуры — F8 (как в Radix), её же называет имя региона
+* («Уведомления (F8)»):
+*
+* - **F8** без модификаторов, если клавишу не погасили, поднимает регион над
+*   слоями (`raise`), запоминает, где был фокус вне региона, и ведёт фокус на
+*   новейший открытый тост. Тостов нет — клавиша не наша, и её никто не
+*   гасит;
+* - **Escape** на тосте под фокусом (или на контроле в нём) закрывает его и
+*   гасится `preventDefault`. Погашенный раньше — например, поповером из
+*   содержимого тоста — тост не трогает: клавиша адресована верхнему слою;
+* - **закрыли тост с фокусом** — крестиком, Escape, жестом или таймером, —
+*   фокус переходит соседнему открытому тосту, а если его нет — туда, где он
+*   был до перехода в регион. Иначе он остался бы на гаснущем тосте и ушёл бы
+*   на `body`, когда тост уйдёт из документа.
+*
+* Слушатели висят, пока есть узел региона.
+*/
+var TToastsKeyboardPlugin = class extends TBasePlugin {
+	_owner = null;
+	_engine = null;
+	_elements = null;
+	/** Узел региона: на нём слушатели Escape и входа фокуса. */
+	_region = null;
+	_document = null;
+	/** Где был фокус до перехода в регион: туда он вернётся, когда тостов не останется. */
+	_return = null;
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance();
+		this._elements = ctx.get(TCollectionElements) ?? null;
+		const element = ctx.get(TElementPlugin);
+		element?.events.on("ready", (node) => this._attach(node));
+		element?.events.on("removed", () => this._detach());
+		ctx.get(TCollectionBundlesPlugin)?.events.on("engine:bound", (engine) => this._bindEngine(engine));
+	}
+	destroy() {
+		this._detach();
+		this._owner = null;
+		this._engine = null;
+		this._elements = null;
+		super.destroy();
+	}
+	_bindEngine(engine) {
+		this._engine = engine;
+		this._listenTo(engine.extensions.toasts.events, "item:close", (toast) => this._passFocus(toast));
+	}
+	_attach(node) {
+		this._detach();
+		const region = node;
+		region.addEventListener("keydown", this._onRegionKeyDown);
+		region.addEventListener("focusin", this._onFocusIn);
+		node.ownerDocument.addEventListener("keydown", this._onDocumentKeyDown);
+		this._region = region;
+		this._document = node.ownerDocument;
+	}
+	_detach() {
+		this._region?.removeEventListener("keydown", this._onRegionKeyDown);
+		this._region?.removeEventListener("focusin", this._onFocusIn);
+		this._document?.removeEventListener("keydown", this._onDocumentKeyDown);
+		this._region = null;
+		this._document = null;
+		this._return = null;
+	}
+	/** F8 — фокус на новейший открытый тост. */
+	_onDocumentKeyDown = (event) => {
+		if (event.key !== HOTKEY || event.defaultPrevented) return;
+		if (event.altKey || event.ctrlKey || event.metaKey || event.shiftKey) return;
+		const region = this._region;
+		const target = this._newest();
+		if (!region || !target) return;
+		event.preventDefault();
+		this._owner?.raise();
+		const active = this._document?.activeElement;
+		if (active && !region.contains(active)) this._return = active;
+		target.focus();
+	};
+	/** Escape на тосте — закрыть его. */
+	_onRegionKeyDown = (event) => {
+		if (event.key !== "Escape" || event.defaultPrevented) return;
+		const toast = this._toastOf(event.target);
+		if (!toast?.open) return;
+		event.preventDefault();
+		toast.close();
+	};
+	/**
+	* Фокус пришёл в регион снаружи — запомнить откуда: Tab и нажатие тоже
+	* приводят к тостам, не только F8.
+	*/
+	_onFocusIn = (event) => {
+		const from = event.relatedTarget;
+		if (from instanceof Element && !this._region?.contains(from)) this._return = from;
+	};
+	/** Закрыли тост с фокусом — фокус соседу, иначе туда, откуда пришли. */
+	_passFocus(toast) {
+		const node = this._elements?.getElementByItem(toast);
+		const active = node?.ownerDocument.activeElement;
+		if (!node || !active || !node.contains(active)) return;
+		const neighbour = this._neighbour(toast);
+		const target = neighbour ? this._elements?.getElementByItem(neighbour) : this._return;
+		if (isFocusableElement(target) && target.isConnected) target.focus();
+	}
+	/** Новейший открытый тост с узлом, который можно сфокусировать. */
+	_newest() {
+		for (const toast of this._engine?.extensions.batch.shown ?? []) {
+			if (!toast.open) continue;
+			const node = this._elements?.getElementByItem(toast);
+			if (isFocusableElement(node)) return node;
+		}
+		return null;
+	}
+	/** Сосед закрытого тоста — следующий открытый, у последнего — предыдущий. */
+	_neighbour(toast) {
+		const shown = this._engine?.extensions.batch.shown ?? [];
+		const index = shown.indexOf(toast);
+		return shown.slice(index + 1).find((item) => item.open) ?? shown.slice(0, Math.max(0, index)).reverse().find((item) => item.open);
+	}
+	/** Тост, чей узел содержит цель события. */
+	_toastOf(target) {
+		if (!(target instanceof Node)) return void 0;
+		return this._engine?.extensions.batch.shown.find((toast) => this._elements?.getElementByItem(toast)?.contains(target));
+	}
+};
+//#endregion
+export { TToastsKeyboardPlugin };

package/dist/custom/toasts/keyboard/types.d.ts

@@ -0,0 +1,6 @@
+import type { TPluginEvents } from '../../../base';
+/**
+ * Своих событий у плагина нет: результат клавиши виден и так — фокус
+ * сообщает DOM, закрытие — тост (`change:open`) и коллекция (`item:close`).
+ */
+export type TToastsKeyboardPluginEvents = TPluginEvents;

package/dist/custom/toasts/layout/index.d.ts

@@ -0,0 +1,2 @@
+export { TToastsLayoutPlugin } from './layout.plugin';
+export type { TToastsLayoutPluginEvents } from './types';

package/dist/custom/toasts/layout/layout.plugin.d.ts

@@ -0,0 +1,23 @@
+import type { IToasts } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TToastsLayoutPluginEvents } from './types';
+/**
+ * TToastsLayoutPlugin — раскладка региона тостов: номер слоя в стили.
+ *
+ * Регион ничего не меряет и координат не считает: место у края окна, отступы
+ * и стопку раскладывает тема по модификатору места. Плагину остаётся
+ * значение, которое в класс не уложить, — `z-index` слоя: регион поднимается
+ * в общем стеке на каждый новый тост и на F8, и номер у него каждый раз новый.
+ *
+ * Объект стилей заменяется целиком, а не мутируется: геттер отдаёт ссылку
+ * наружу, и без смены идентичности адаптер не увидит изменения.
+ * `change:styles` — только когда номер сменился.
+ */
+export declare class TToastsLayoutPlugin extends TBasePlugin<IToasts, TToastsLayoutPluginEvents> {
+    private _styles;
+    install(ctx: IPluginContext): void;
+    /** Стили региона: `z-index` слоя. */
+    get styles(): Record<string, string | number>;
+    private _update;
+}

package/dist/custom/toasts/layout/layout.plugin.js

@@ -0,0 +1,39 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+//#region src/custom/toasts/layout/layout.plugin.ts
+/**
+* TToastsLayoutPlugin — раскладка региона тостов: номер слоя в стили.
+*
+* Регион ничего не меряет и координат не считает: место у края окна, отступы
+* и стопку раскладывает тема по модификатору места. Плагину остаётся
+* значение, которое в класс не уложить, — `z-index` слоя: регион поднимается
+* в общем стеке на каждый новый тост и на F8, и номер у него каждый раз новый.
+*
+* Объект стилей заменяется целиком, а не мутируется: геттер отдаёт ссылку
+* наружу, и без смены идентичности адаптер не увидит изменения.
+* `change:styles` — только когда номер сменился.
+*/
+var TToastsLayoutPlugin = class extends TBasePlugin {
+	_styles = {};
+	install(ctx) {
+		super.install(ctx);
+		const owner = ctx.getInstance();
+		if (!owner) return;
+		this._listenTo(owner.events, "change:zIndex", () => this._update(owner));
+		this._update(owner);
+	}
+	/** Стили региона: `z-index` слоя. */
+	get styles() {
+		return this._styles;
+	}
+	_update(owner) {
+		const oldStyles = this.styles;
+		if (this._styles["z-index"] === owner.zIndex) return;
+		this._styles = { "z-index": owner.zIndex };
+		this.events.emit("change:styles", {
+			newValue: this._styles,
+			oldValue: oldStyles
+		});
+	}
+};
+//#endregion
+export { TToastsLayoutPlugin };

package/dist/custom/toasts/layout/types.d.ts

@@ -0,0 +1,5 @@
+import type { TValuePayload } from '@soxa-ui/core';
+import type { TPluginEvents } from '../../../base';
+export type TToastsLayoutPluginEvents = TPluginEvents & {
+    'change:styles': (payload: TValuePayload<Record<string, string | number>>) => void;
+};

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

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

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

@@ -0,0 +1,10 @@
+import type { IToasts } from '@soxa-ui/core';
+import { TNamesPlugin } from '../../../locale/names.plugin';
+import type { TTranslations } from '../../../locale/types';
+/**
+ * TToastsNamesPlugin — имя региона тостов от локали: `aria-label` в `aria`
+ * владельца, вместе с клавишей, которая ведёт к тостам («Уведомления (F8)»).
+ */
+export declare class TToastsNamesPlugin extends TNamesPlugin<IToasts> {
+    protected _name(owner: IToasts, translations: TTranslations): void;
+}

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

@@ -0,0 +1,13 @@
+import { TNamesPlugin } from "../../../locale/names.plugin.js";
+//#region src/custom/toasts/names/names.plugin.ts
+/**
+* TToastsNamesPlugin — имя региона тостов от локали: `aria-label` в `aria`
+* владельца, вместе с клавишей, которая ведёт к тостам («Уведомления (F8)»).
+*/
+var TToastsNamesPlugin = class extends TNamesPlugin {
+	_name(owner, translations) {
+		owner.aria.add("aria-label", translations.toasts.region);
+	}
+};
+//#endregion
+export { TToastsNamesPlugin };

package/dist/custom/toasts/removal/index.d.ts

@@ -0,0 +1,2 @@
+export { TToastsRemovalPlugin } from './removal.plugin';
+export type { TToastsRemovalPluginEvents } from './types';

package/dist/custom/toasts/removal/removal.plugin.d.ts

@@ -0,0 +1,35 @@
+import type { IToasts } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TToastsRemovalPluginEvents } from './types';
+/**
+ * TToastsRemovalPlugin — закрытый тост уходит из коллекции, когда догас.
+ *
+ * Закрытый тост из разметки не прячется: тема ведёт его переходом по
+ * `data-open="false"` — он гаснет, уезжает к стороне жеста, а место его
+ * схлопывается, — и коллекция держит его, пока переходы его узла не
+ * доиграли (`afterTransitions`), а потом удаляет (`plain.remove`). Сними его
+ * сразу — узел ушёл бы из документа посреди исчезания. Чисел темы плагин не
+ * знает: сколько ждать, решает переход; без движения и без переходов (jsdom)
+ * — тем же кадром.
+ *
+ * Узла у тоста нет — он не нарисован (вытеснен за предел видимых, региона нет
+ * или его ещё не отрисовали) — гаснуть нечему, и тост удаляется сразу.
+ *
+ * Закрытые до привязки движка — тосты, закрытые, пока компонента не было, —
+ * удаляются при привязке: их узлов в этом монтировании нет. Набор уничтожают,
+ * пока тост гаснет, — ожидание снимается, а тост удаляется сразу: он закрыт, а
+ * движок снаружи переживает компонент.
+ */
+export declare class TToastsRemovalPlugin extends TBasePlugin<IToasts, TToastsRemovalPluginEvents> {
+    private _engine;
+    private _elements;
+    /** Тосты, которые гаснут: отмена ожидания — по тосту. */
+    private readonly _fading;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    private _bindEngine;
+    /** Закрытый тост: дождаться, пока его узел догаснет, и удалить. */
+    private _fade;
+    private _remove;
+}