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

package/dist/custom/table/row-ids/row-ids.plugin.d.ts

@@ -0,0 +1,21 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TTableRowIdsPlugin — имя строки таблицы в документе: `id` её заголовка.
+ *
+ * Заголовок строки — ячейка колонки `rowHeader`, и по её тексту строку
+ * называют: чекбокс выбора строки ссылается на неё (`aria-labelledby`). Своего
+ * экземпляра у ячейки нет, поэтому `id` уходит в набор строки `headerAria`, а
+ * на ячейку набор кладёт проекция ячеек — только у первой показанной колонки
+ * заголовка. Ссылку чекбокса строит она же (`rowHeaderId`), поэтому формула
+ * одна — здесь.
+ *
+ * `id` — от монтирования строки (`createId`), а не от экземпляра: он нужен
+ * только документу, и на сервере и в браузере обязан совпасть. Строку таблица
+ * рисует с готовым экземпляром (`ctrl`), и его конструктор адаптер не зовёт, а
+ * монтирование у неё своё. Пишется при установке, синхронно, — имя есть уже в
+ * первой (и серверной) отрисовке.
+ */
+export declare class TTableRowIdsPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

package/dist/custom/table/row-ids/row-ids.plugin.js

@@ -0,0 +1,28 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+//#region src/custom/table/row-ids/row-ids.plugin.ts
+/**
+* TTableRowIdsPlugin — имя строки таблицы в документе: `id` её заголовка.
+*
+* Заголовок строки — ячейка колонки `rowHeader`, и по её тексту строку
+* называют: чекбокс выбора строки ссылается на неё (`aria-labelledby`). Своего
+* экземпляра у ячейки нет, поэтому `id` уходит в набор строки `headerAria`, а
+* на ячейку набор кладёт проекция ячеек — только у первой показанной колонки
+* заголовка. Ссылку чекбокса строит она же (`rowHeaderId`), поэтому формула
+* одна — здесь.
+*
+* `id` — от монтирования строки (`createId`), а не от экземпляра: он нужен
+* только документу, и на сервере и в браузере обязан совпасть. Строку таблица
+* рисует с готовым экземпляром (`ctrl`), и его конструктор адаптер не зовёт, а
+* монтирование у неё своё. Пишется при установке, синхронно, — имя есть уже в
+* первой (и серверной) отрисовке.
+*/
+var TTableRowIdsPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const row = ctx.getInstance();
+		if (!row) return;
+		row.headerAria.add("id", ctx.createId("header"));
+	}
+};
+//#endregion
+export { TTableRowIdsPlugin };

package/dist/custom/tabs/active-tab/active-tab.plugin.d.ts

@@ -0,0 +1,42 @@
+import type { ITabs } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TActiveTabOffset, TTabsActiveTabPluginEvents } from './types';
+/**
+ * TTabsActiveTabPlugin — вычисляет позицию/размер активного таба (offset).
+ *
+ * Использует:
+ * - корень набора (через TElementPlugin) и его ряд — ребёнка корня, от
+ *   которого считаются `offset*` табов;
+ * - активный элемент коллекции (engine.extensions.activation);
+ * - DOM-элемент активного таба (через TCollectionElements).
+ *
+ * Пересчитывает offset при активации/деактивации, удалении/перемещении элементов,
+ * изменении view и изменении layout (resize).
+ *
+ * **Удаление и перемещение пересчитываются кадром позже — и только при узле
+ * корня**: между `ready` и `removed` своего `TElementPlugin`. Сборка вместе с
+ * подписками плагина идёт и на сервере, и табы там уходят из коллекции — Solid
+ * снимает собранный корень после `renderToString`, — а узла там нет, как нет и
+ * `requestAnimationFrame`. Без узла мерить нечего (`_computeOffset` отдаёт
+ * `null`), и кадр не планируется: место активного таба померит `ready`.
+ */
+export declare class TTabsActiveTabPlugin extends TBasePlugin<ITabs, TTabsActiveTabPluginEvents> {
+    private _element;
+    private _tabs;
+    private _collectionElements;
+    private _engine;
+    /** Last published measurement, retained by reference for the next notification. */
+    private _offset;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    getOffset(): TActiveTabOffset | null;
+    private _emitOffset;
+    /**
+     * Пересчитать offset кадром позже — пока у плагина есть узел корня: разметка
+     * после удаления или перемещения таба ещё не перерисована. Без узла повод
+     * ничего не планирует: место активного таба померит `ready`.
+     */
+    private _emitOffsetNextFrame;
+    private _computeOffset;
+}

package/dist/custom/tabs/active-tab/active-tab.plugin.js

@@ -0,0 +1,103 @@
+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 { isMeasurableElement } from "../../../utils/isMeasurableElement.js";
+import { barOf } from "../parts.js";
+import { TTabsLayoutPlugin } from "../layout/layout.plugin.js";
+//#region src/custom/tabs/active-tab/active-tab.plugin.ts
+/**
+* TTabsActiveTabPlugin — вычисляет позицию/размер активного таба (offset).
+*
+* Использует:
+* - корень набора (через TElementPlugin) и его ряд — ребёнка корня, от
+*   которого считаются `offset*` табов;
+* - активный элемент коллекции (engine.extensions.activation);
+* - DOM-элемент активного таба (через TCollectionElements).
+*
+* Пересчитывает offset при активации/деактивации, удалении/перемещении элементов,
+* изменении view и изменении layout (resize).
+*
+* **Удаление и перемещение пересчитываются кадром позже — и только при узле
+* корня**: между `ready` и `removed` своего `TElementPlugin`. Сборка вместе с
+* подписками плагина идёт и на сервере, и табы там уходят из коллекции — Solid
+* снимает собранный корень после `renderToString`, — а узла там нет, как нет и
+* `requestAnimationFrame`. Без узла мерить нечего (`_computeOffset` отдаёт
+* `null`), и кадр не планируется: место активного таба померит `ready`.
+*/
+var TTabsActiveTabPlugin = class extends TBasePlugin {
+	_element = null;
+	_tabs = null;
+	_collectionElements = null;
+	_engine = null;
+	/** Last published measurement, retained by reference for the next notification. */
+	_offset = null;
+	install(ctx) {
+		super.install(ctx);
+		this._tabs = ctx.getInstance();
+		this._collectionElements = ctx.get(TCollectionElements) ?? null;
+		ctx.get(TElementPlugin)?.events.on("ready", (element) => {
+			this._element = element;
+			this._emitOffset();
+		});
+		ctx.get(TElementPlugin)?.events.on("removed", () => {
+			this._element = null;
+			this._offset = null;
+		});
+		ctx.get(TTabsLayoutPlugin)?.events.on("change:layout", () => this._emitOffset());
+		ctx.get(TCollectionBundlesPlugin)?.events.on("engine:bound", (engine) => {
+			this._engine = engine;
+			const emit = () => this._emitOffset();
+			const emitNextFrame = () => this._emitOffsetNextFrame();
+			this._listenTo(engine.extensions.activation.events, "item:activated", emit);
+			this._listenTo(engine.extensions.activation.events, "item:deactivated", emit);
+			this._listenTo(engine.extensions.plain.events, "item:removed", emitNextFrame);
+			this._listenTo(engine.extensions.plain.events, "item:moved", emitNextFrame);
+		});
+		this._listenTo(this._tabs?.events, "change:view", () => this._emitOffset());
+	}
+	destroy() {
+		this._element = null;
+		this._offset = null;
+		this._tabs = null;
+		this._collectionElements = null;
+		this._engine = null;
+		super.destroy();
+	}
+	getOffset() {
+		return this._computeOffset();
+	}
+	_emitOffset() {
+		const oldValue = this._offset;
+		this._offset = this._computeOffset();
+		this.events.emit("change:active-tab", {
+			newValue: this._offset,
+			oldValue
+		});
+	}
+	/**
+	* Пересчитать offset кадром позже — пока у плагина есть узел корня: разметка
+	* после удаления или перемещения таба ещё не перерисована. Без узла повод
+	* ничего не планирует: место активного таба померит `ready`.
+	*/
+	_emitOffsetNextFrame() {
+		if (this._element) requestAnimationFrame(() => this._emitOffset());
+	}
+	_computeOffset() {
+		if (!this._element || !this._collectionElements || !this._engine || !this._tabs) return null;
+		const barEl = barOf(this._tabs, this._element);
+		if (!isMeasurableElement(barEl)) return null;
+		const activeItem = this._engine.extensions.activation.activeItem;
+		const activeEl = activeItem ? this._collectionElements.getElementByUid(activeItem.uid) : null;
+		const activeBox = isMeasurableElement(activeEl) ? activeEl : null;
+		return {
+			barEl,
+			offsetLeft: activeBox ? activeBox.offsetLeft : 0,
+			offsetWidth: activeBox ? activeBox.offsetWidth : 0,
+			offsetTop: activeBox ? activeBox.offsetTop : 0,
+			offsetHeight: activeBox ? activeBox.offsetHeight : 0
+		};
+	}
+};
+//#endregion
+export { TTabsActiveTabPlugin };

package/dist/custom/tabs/active-tab/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './active-tab.plugin';

package/dist/custom/tabs/active-tab/types.d.ts

@@ -0,0 +1,17 @@
+import type { TValuePayload } from '@soxa-ui/core';
+import type { TPluginEvents } from '../../../base';
+/**
+ * Место активного таба: `offset*` его узла — от ряда набора (`barEl`), его
+ * ближайшего позиционированного предка в разметке темы. Нет активного таба —
+ * нули.
+ */
+export type TActiveTabOffset = {
+    barEl: HTMLElement;
+    offsetLeft: number;
+    offsetWidth: number;
+    offsetTop: number;
+    offsetHeight: number;
+};
+export type TTabsActiveTabPluginEvents = TPluginEvents & {
+    'change:active-tab': (payload: TValuePayload<TActiveTabOffset | null>) => void;
+};

package/dist/custom/tabs/content-warn/content-warn.plugin.d.ts

@@ -0,0 +1,21 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TTabsContentWarnPlugin — предупреждает, если DOM-узел панели `Tabs.Content`
+ * оказался внутри `[role="tablist"]`.
+ *
+ * Верный знак, что панель положили в слот `default` вместо `content`: `default`
+ * рендерится внутри списка табов (`[role=tablist]`), `content` — снаружи.
+ * Перепутанный слот иначе виден только глазами.
+ *
+ * Диагностика, не защита: исключение не бросаем — позиция панели не мешает
+ * работе, связка с табом по `value` и ARIA остаются корректными независимо от
+ * того, куда панель попала в разметке.
+ *
+ * Узел берётся у `TElementPlugin` из общего bundle: сразу, если элемент уже
+ * готов, иначе по событию `ready`. До монтирования (в т.ч. SSR) узла нет —
+ * проверка молчит.
+ */
+export declare class TTabsContentWarnPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

package/dist/custom/tabs/content-warn/content-warn.plugin.js

@@ -0,0 +1,41 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+//#region src/custom/tabs/content-warn/content-warn.plugin.ts
+/**
+* TTabsContentWarnPlugin — предупреждает, если DOM-узел панели `Tabs.Content`
+* оказался внутри `[role="tablist"]`.
+*
+* Верный знак, что панель положили в слот `default` вместо `content`: `default`
+* рендерится внутри списка табов (`[role=tablist]`), `content` — снаружи.
+* Перепутанный слот иначе виден только глазами.
+*
+* Диагностика, не защита: исключение не бросаем — позиция панели не мешает
+* работе, связка с табом по `value` и ARIA остаются корректными независимо от
+* того, куда панель попала в разметке.
+*
+* Узел берётся у `TElementPlugin` из общего bundle: сразу, если элемент уже
+* готов, иначе по событию `ready`. До монтирования (в т.ч. SSR) узла нет —
+* проверка молчит.
+*/
+var TTabsContentWarnPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const elementPlugin = ctx.get(TElementPlugin);
+		if (!elementPlugin) return;
+		const check = (el) => {
+			if (!el || !el.closest("[role=\"tablist\"]")) return;
+			console.warn("[soxa] Tabs.Content оказался внутри [role=\"tablist\"]: панель нужно класть в слот `content`, а не в `default`.");
+		};
+		if (elementPlugin.element) {
+			check(elementPlugin.element);
+			return;
+		}
+		const onReady = (el) => {
+			elementPlugin.events.off("ready", onReady);
+			check(el);
+		};
+		elementPlugin.events.on("ready", onReady);
+	}
+};
+//#endregion
+export { TTabsContentWarnPlugin };

package/dist/custom/tabs/content-warn/index.d.ts

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

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

@@ -0,0 +1,7 @@
+export * from './active-tab';
+export * from './content-warn';
+export * from './item-ids';
+export * from './keyboard';
+export * from './layout';
+export * from './item-names';
+export { tabIn, tabStopOf } from './tab';

package/dist/custom/tabs/item-ids/index.d.ts

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

package/dist/custom/tabs/item-ids/item-ids.plugin.d.ts

@@ -0,0 +1,60 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import { TIdPlugin } from '../../id';
+/**
+ * TTabsItemIdsPlugin — связка «таб ↔ панель» в документе со стороны таба.
+ *
+ * Пишет в `aria` таба его `id` и `aria-controls` — `id` его панели; других
+ * писателей у этих атрибутов нет. Панель своей формулы не держит: проводка
+ * `Tabs.Content` (`TTabsContentBindingExtension`) берёт у таба, которого нашла
+ * по `value`, его `id` себе в `aria-labelledby`, а `id` себе — из
+ * `aria-controls`, если своего у неё нет, — и идёт за ними на каждую смену
+ * набора таба (`change:aria`).
+ *
+ * `id`, заданный приложением, главнее `id` от монтирования — с обеих сторон
+ * связки. Свой `id` таба (`TIdPlugin` таба) встаёт на строку таба, и на него
+ * ссылается панель. Свой `id` панели (`TIdPlugin` панели) таб узнаёт от
+ * связки: принятая панель отдаёт плагину свой `TIdPlugin` (`bindPanel`), и
+ * `aria-controls` ведёт на `id` из него, отвязанная (`unbindPanel`) — снова на
+ * формулу. Сменили или сняли `id` с любой стороны — плагин переписывает набор,
+ * и панель идёт следом.
+ *
+ * Без них — `id` от монтирования, а не от экземпляра: он нужен только
+ * документу, и на сервере и в браузере обязан совпасть. Таб из данных
+ * рисуется с готовым экземпляром (`ctrl`), и его конструктор адаптер не зовёт,
+ * а монтирование у него своё. Пишется при установке, синхронно, — связка таба
+ * есть уже в первой (и серверной) отрисовке. Свой `id` панели приходит позже,
+ * со входом панели: таб в разметке раньше неё, и в разметке сервера его
+ * `aria-controls` ведёт на формулу, а у панели уже свой `id` — ссылка сходится
+ * после гидратации. Плата: `aria-controls` стоит и тогда, когда `Tabs.Content`
+ * в разметке нет вовсе; в паттерне вкладок панель обязательна.
+ */
+export declare class TTabsItemIdsPlugin extends TBasePlugin {
+    /** Таб — с установки; после `destroy()` писать некуда. */
+    private _tab;
+    /** `id` панели от монтирования таба — пока своего у панели нет. */
+    private _formula;
+    /** `TIdPlugin` привязанной панели: `id`, который ей задало приложение. */
+    private _panel;
+    install(ctx: IPluginContext): void;
+    /**
+     * Панель таба отдаёт свой `TIdPlugin`: `aria-controls` ведёт на `id`,
+     * который ей задало приложение, и идёт за его сменой; не задан — на
+     * формулу. Зовёт связка панели, когда принятая панель нашла таб. Панель у
+     * таба одна: привязанная следом заменяет прежнюю.
+     */
+    bindPanel(panel: TIdPlugin): void;
+    /**
+     * Панель отвязалась: `aria-controls` — снова на формулу. Чужую панель
+     * отвязка не трогает: новое монтирование панели бывает принято раньше,
+     * чем снято прежнее.
+     */
+    unbindPanel(panel: TIdPlugin): void;
+    /**
+     * Шина `TIdPlugin` панели плагину чужая: панель переживает монтирование
+     * таба — таб из данных монтируется заново, когда его показывают снова.
+     */
+    destroy(): void;
+    /** `aria-controls` — на `id` панели: свой, если его задали, иначе формула. */
+    private readonly _writeControls;
+}

package/dist/custom/tabs/item-ids/item-ids.plugin.js

@@ -0,0 +1,94 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TIdPlugin } from "../../id/id.plugin.js";
+//#region src/custom/tabs/item-ids/item-ids.plugin.ts
+/**
+* TTabsItemIdsPlugin — связка «таб ↔ панель» в документе со стороны таба.
+*
+* Пишет в `aria` таба его `id` и `aria-controls` — `id` его панели; других
+* писателей у этих атрибутов нет. Панель своей формулы не держит: проводка
+* `Tabs.Content` (`TTabsContentBindingExtension`) берёт у таба, которого нашла
+* по `value`, его `id` себе в `aria-labelledby`, а `id` себе — из
+* `aria-controls`, если своего у неё нет, — и идёт за ними на каждую смену
+* набора таба (`change:aria`).
+*
+* `id`, заданный приложением, главнее `id` от монтирования — с обеих сторон
+* связки. Свой `id` таба (`TIdPlugin` таба) встаёт на строку таба, и на него
+* ссылается панель. Свой `id` панели (`TIdPlugin` панели) таб узнаёт от
+* связки: принятая панель отдаёт плагину свой `TIdPlugin` (`bindPanel`), и
+* `aria-controls` ведёт на `id` из него, отвязанная (`unbindPanel`) — снова на
+* формулу. Сменили или сняли `id` с любой стороны — плагин переписывает набор,
+* и панель идёт следом.
+*
+* Без них — `id` от монтирования, а не от экземпляра: он нужен только
+* документу, и на сервере и в браузере обязан совпасть. Таб из данных
+* рисуется с готовым экземпляром (`ctrl`), и его конструктор адаптер не зовёт,
+* а монтирование у него своё. Пишется при установке, синхронно, — связка таба
+* есть уже в первой (и серверной) отрисовке. Свой `id` панели приходит позже,
+* со входом панели: таб в разметке раньше неё, и в разметке сервера его
+* `aria-controls` ведёт на формулу, а у панели уже свой `id` — ссылка сходится
+* после гидратации. Плата: `aria-controls` стоит и тогда, когда `Tabs.Content`
+* в разметке нет вовсе; в паттерне вкладок панель обязательна.
+*/
+var TTabsItemIdsPlugin = class extends TBasePlugin {
+	/** Таб — с установки; после `destroy()` писать некуда. */
+	_tab = null;
+	/** `id` панели от монтирования таба — пока своего у панели нет. */
+	_formula = "";
+	/** `TIdPlugin` привязанной панели: `id`, который ей задало приложение. */
+	_panel;
+	install(ctx) {
+		super.install(ctx);
+		const tab = ctx.getInstance();
+		if (!tab) return;
+		const idPlugin = ctx.get(TIdPlugin);
+		const mountId = ctx.createId("tab");
+		const write = () => {
+			tab.aria.add("id", idPlugin?.id ?? mountId);
+		};
+		this._tab = tab;
+		this._formula = ctx.createId("panel");
+		write();
+		this._writeControls();
+		idPlugin?.events.on("change:id", write);
+	}
+	/**
+	* Панель таба отдаёт свой `TIdPlugin`: `aria-controls` ведёт на `id`,
+	* который ей задало приложение, и идёт за его сменой; не задан — на
+	* формулу. Зовёт связка панели, когда принятая панель нашла таб. Панель у
+	* таба одна: привязанная следом заменяет прежнюю.
+	*/
+	bindPanel(panel) {
+		if (this._panel === panel) return;
+		this._panel?.events.off("change:id", this._writeControls);
+		this._panel = panel;
+		panel.events.on("change:id", this._writeControls);
+		this._writeControls();
+	}
+	/**
+	* Панель отвязалась: `aria-controls` — снова на формулу. Чужую панель
+	* отвязка не трогает: новое монтирование панели бывает принято раньше,
+	* чем снято прежнее.
+	*/
+	unbindPanel(panel) {
+		if (this._panel !== panel) return;
+		panel.events.off("change:id", this._writeControls);
+		this._panel = void 0;
+		this._writeControls();
+	}
+	/**
+	* Шина `TIdPlugin` панели плагину чужая: панель переживает монтирование
+	* таба — таб из данных монтируется заново, когда его показывают снова.
+	*/
+	destroy() {
+		this._panel?.events.off("change:id", this._writeControls);
+		this._panel = void 0;
+		this._tab = null;
+		super.destroy();
+	}
+	/** `aria-controls` — на `id` панели: свой, если его задали, иначе формула. */
+	_writeControls = () => {
+		this._tab?.aria.add("aria-controls", this._panel?.id ?? this._formula);
+	};
+};
+//#endregion
+export { TTabsItemIdsPlugin };

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

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

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

@@ -0,0 +1,17 @@
+import type { ITabsItem } from '@soxa-ui/core';
+import { TNamesPlugin } from '../../../locale/names.plugin';
+import type { TTranslations } from '../../../locale/types';
+/**
+ * TTabsItemNamesPlugin — имя кнопки закрытия таба от локали: в `closeAria`,
+ * вместе с текстом таба — «Close Настройки».
+ *
+ * Без текста все кнопки закрытия в наборе назывались бы одинаково, и по
+ * списку элементов скринридера («Close, кнопка» пять раз подряд) выбрать
+ * нужную было бы невозможно. Как имя складывается с текстом, решает шаблон
+ * локали (`tabs.close`): порядок слов у каждого языка свой. Сменился текст —
+ * имя переписывается.
+ */
+export declare class TTabsItemNamesPlugin extends TNamesPlugin<ITabsItem> {
+    protected _name(owner: ITabsItem, translations: TTranslations): void;
+    protected _watch(owner: ITabsItem, name: () => void): void;
+}

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

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

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

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './keyboard.plugin';

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

@@ -0,0 +1,105 @@
+import type { ITabs } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TTabsKeyboardPluginEvents } from './types';
+/**
+ * TTabsKeyboardPlugin — клавиатура Tabs по паттерну APG Tabs и фокус после
+ * закрытия таба.
+ *
+ * Стрелки по оси списка (у горизонтального ←/→, у вертикального ↑/↓) ведут к
+ * соседнему табу по кругу, `Home`/`End` — к первому и последнему. Табы, на
+ * которые нельзя перейти (`TTabsExtension.isEnabledTab`), пропускаются.
+ * `Delete` закрывает таб, если его можно закрыть.
+ *
+ * **Активация автоматическая**: переход сразу активирует таб. APG советует
+ * так, когда панель показывается без задержки, а `Tabs.Content` рисуется
+ * локально. Поэтому фокус и активный таб не расходятся, и остановка Tab —
+ * активный таб — считается в коллекции без знания о фокусе. `Enter` и пробел
+ * здесь не обрабатываются: таб — нативная `<button>`, и активирует её клик.
+ *
+ * **Закрытый таб отдаёт фокус остановке Tab** — любым закрытием: клавишей,
+ * крестиком, из кода. Крестик фокус от клика принимает, и узел таба уходит из
+ * документа вместе с ним: фокус ушёл бы на страницу, и следующий Tab начинал
+ * бы обход заново. Переносится только фокус из узла закрываемого таба — на
+ * таб-остановку после удаления (`tabStop`): закрыли активный — это сосед,
+ * которого уже активировал `TTabsExtension`; закрыли неактивный — прежний
+ * активный, соседа такое закрытие не активирует. Остановки нет — к первой
+ * остановке Tab после списка; нет и её — фокус не трогается.
+ *
+ * Когда переносить фокус, решает помощник коллекции (`TLeavingFocus`), общий с
+ * Tags: таб бывает снят ещё до того, как закрытие дойдёт до плагина, —
+ * подписчиком `item:close`, который стоит раньше, например приложением в
+ * обработчике события фасада. Удаление, отменённое в `item:remove:before`, и
+ * уход таба без закрытия фокус не трогают. Закрыть таб из кода можно и на
+ * сервере, поэтому фокус читается только при узле корня.
+ *
+ * Сами `tabindex` плагин не пишет: roving tabindex ставит `TTabsExtension`,
+ * потому что атрибут обязан стоять с первой отрисовки, включая серверную.
+ * Здесь только то, что требует DOM: слушатель клавиш и перенос фокуса.
+ *
+ * От `TListNavigationPlugin` не наследуется: там модель подсветки при фокусе
+ * на контейнере, а у табов по APG фокус ходит по самим табам (см. AGENTS.md,
+ * «Граница переиспользования между похожими компонентами»).
+ */
+export declare class TTabsKeyboardPlugin extends TBasePlugin<ITabs, TTabsKeyboardPluginEvents> {
+    private _owner;
+    /** Корень: на нём слушатель, по нему же направление письма. */
+    private _element;
+    private _elements;
+    private _engine;
+    /** Фокус закрываемого таба — ждёт, пока таб закроют и он уйдёт из списка. */
+    private _leaving;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    private _attach;
+    private _detach;
+    /** Движок сменился — закрытие табов и их уход слушаются у нового. */
+    private _bindEngine;
+    private readonly _onKeyDown;
+    /**
+     * Таб, с которого пришла клавиша, — тот, чей узел содержит цель события.
+     *
+     * Слушатель висит на корне, и до него всплывают клавиши панелей, слотов
+     * списка и вложенных Tabs: их перехватывать нельзя. Кнопка закрытия лежит
+     * внутри узла таба и считается его частью.
+     */
+    private _tabOf;
+    /**
+     * Куда ведёт клавиша — табы по порядку, от первого кандидата; пусто —
+     * клавиша не наша или перейти некуда. `Home` идёт от первого вперёд,
+     * `End` — от последнего назад, стрелка — от соседа в своём направлении.
+     */
+    private _candidates;
+    /**
+     * Шаг по списку от стрелки; клавиши чужой оси не перехватываются. В RTL
+     * горизонтальный список идёт справа налево, и ←/→ меняются местами.
+     */
+    private _step;
+    /**
+     * Направление письма берётся вычисленным: `direction` компонента бывает
+     * `inherit`, и тогда его задаёт предок.
+     */
+    private get _rtl();
+    /** Табы в порядке списка, на которые можно перейти. */
+    private _available;
+    /**
+     * Табы в направлении шага, по кругу, от ближайшего: с последнего вперёд —
+     * на первый. Отсчёт от позиции таба в списке, а не среди доступных: таб
+     * могли выключить, пока на нём фокус.
+     */
+    private _neighbours;
+    /** Фокус на узел таба с ролью. Гард нужен: узел плагину приходит `Element`. */
+    private _focus;
+    /**
+     * Таб закрывают — любым путём: клавишей, крестиком, из кода. Переносить
+     * ли фокус, решает помощник: фокус мог стоять и не в этом табе.
+     */
+    private readonly _onClose;
+    /**
+     * Фокус закрытого таба — на таб-остановку. Остановка берётся по модели
+     * (`tabStop`), а не по `[tabindex="0"]`: в такте закрытия разметка ещё
+     * старая. Остановки нет — на первую остановку Tab после списка: за ним
+     * слот `trailing` и панели; нет и её — фокус остаётся, где был.
+     */
+    private _pass;
+}