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

package/dist/custom/component-view/aria.plugin.d.ts

@@ -0,0 +1,102 @@
+import type { TDefaultValues } from '@soxa-ui/core';
+import { TBasePlugin } from '../../base';
+import type { IPluginContext } from '../../base';
+import type { IAriaLinks, IAriaParts, IAriaPluginOptions, IAriaPluginProps, TAriaPluginEvents } from './types';
+/**
+ * TAriaPlugin — доступное имя и описание компонента.
+ *
+ * Почему плагин, а не свойства `TComponentView`. Имя нужно не всякому
+ * компоненту, а только тому, у кого нет подходящего видимого текста:
+ * иконочной кнопке, индикатору выполнения, диалогу, полю ввода. У кнопки с
+ * текстом, у заголовка или обёртки имя вычисляется из содержимого само, и
+ * лишние `label`/`labelledBy` на базовом классе были бы мусором в каждом
+ * наследнике.
+ * Поэтому подключается по необходимости — как `TActionPlugin`.
+ *
+ * Почему плагин здесь годится, хотя обычно для ARIA не годится. Плагин,
+ * который писал бы атрибуты прямо в DOM после монтирования, дал бы пустую
+ * серверную разметку. Этот в DOM не ходит: он пишет в `instance.aria` — тот же
+ * набор, что заполняют ядро и расширения коллекции, — а раскладывает набор
+ * шаблон, синхронно.
+ *
+ * Входов у плагина три: пропсы (`aria_label`, `aria_labelledBy`,
+ * `aria_describedBy`) — их задаёт разметка компонента, — ссылки от разметки
+ * вокруг (`links`) — их пишет поле формы `Field` своему контролу — и ссылки
+ * на части своей разметки (`parts`) — их пишет плагин связок компонента
+ * (счётчик символов Textarea). Сливает их плагин: подпись поля — имя, пока
+ * своего нет, а в `aria-describedby` встают по порядку пояснение поля, свои
+ * части и своё пояснение. Второго писателя тех же атрибутов нет, и ни один
+ * вход не стирает другой.
+ */
+export declare class TAriaPlugin extends TBasePlugin<any, TAriaPluginEvents> {
+    /**
+     * Умолчания пропов — «имени нет». Объявлены ключами без значения, как
+     * `closable` у элемента Tabs: значим ключ, а не значение. Снятый из разметки
+     * проп связка возвращает к умолчанию декларации, и без ключа у компонента
+     * оставалось бы прежнее имя. В декларацию их кладёт `definePlugin` — см.
+     * `TAnchorPlugin.defaultValues`.
+     */
+    static defaultValues: TDefaultValues<IAriaPluginProps, never, 'label' | 'labelledBy' | 'describedBy'>;
+    private _instance;
+    private _label;
+    private _labelledBy;
+    private _describedBy;
+    private _links;
+    private _parts;
+    private _role;
+    install(ctx: IPluginContext, options?: IAriaPluginOptions): void;
+    /**
+     * Доступное имя.
+     *
+     * Пустая строка приравнена к отсутствию: `aria-label=""` имени не даёт, но
+     * глушит вычисление имени из содержимого — хуже, чем не ставить атрибут.
+     */
+    get label(): string | undefined;
+    set label(value: string | undefined);
+    /**
+     * `id` элемента, чей текст служит именем. Приоритетнее `label` — так решает
+     * сам алгоритм вычисления имени в браузере, и мы ему не противоречим.
+     */
+    get labelledBy(): string | undefined;
+    set labelledBy(value: string | undefined);
+    /** `id` элемента с пояснением: подсказка под полем, текст ошибки. */
+    get describedBy(): string | undefined;
+    set describedBy(value: string | undefined);
+    /**
+     * Ссылки от разметки вокруг — подпись и пояснение поля формы. Не проп: в
+     * контракт плагина не входит, пишет его связка поля с контролом
+     * (`TFieldControlExtension`), а не разметка компонента.
+     *
+     * - `labelledBy` — имя, пока своего нет: своё (`label`, `labelledBy`)
+     *   главнее, иначе подпись поля перекрыла бы имя, которое задал
+     *   потребитель;
+     * - `describedBy` — перед своим: `aria-describedby` получает оба `id`,
+     *   пояснение поля — первым.
+     *
+     * Объект заменяется целиком, а не правится на месте.
+     */
+    get links(): IAriaLinks;
+    set links(value: IAriaLinks);
+    /**
+     * Ссылки на части своей разметки — часть без своего экземпляра, которая
+     * поясняет компонент: счётчик символов Textarea. Не проп: в контракт
+     * плагина не входит, как и `links`, — пишет его плагин связок компонента,
+     * который знает `id` части, а не разметка.
+     *
+     * Только пояснение: `describedBy` встаёт в `aria-describedby` после
+     * пояснения поля формы и перед своим. Так части звучат на фокусе
+     * компонента, вместе с ним, а не живым регионом на каждое изменение.
+     *
+     * Объект заменяется целиком, а не правится на месте.
+     */
+    get parts(): IAriaParts;
+    set parts(value: IAriaParts);
+    /**
+     * Есть ли у компонента имя из этого плагина — своё или подпись поля.
+     * Описание именем не считается.
+     */
+    get named(): boolean;
+    /** Пишет свою часть в общий набор компонента. */
+    private _apply;
+    destroy(): void;
+}

package/dist/custom/component-view/aria.plugin.js

@@ -0,0 +1,190 @@
+import { TBasePlugin } from "../../base/base.class.js";
+//#region src/custom/component-view/aria.plugin.ts
+/** Ссылок от разметки вокруг нет. */
+var NO_LINKS = {};
+/** Ссылок на свои части нет. */
+var NO_PARTS = {};
+/** Те же ли ссылки — по содержимому: связка пишет новый объект на каждую смену. */
+function sameLinks(a, b) {
+	return a.labelledBy === b.labelledBy && a.describedBy === b.describedBy;
+}
+/**
+* TAriaPlugin — доступное имя и описание компонента.
+*
+* Почему плагин, а не свойства `TComponentView`. Имя нужно не всякому
+* компоненту, а только тому, у кого нет подходящего видимого текста:
+* иконочной кнопке, индикатору выполнения, диалогу, полю ввода. У кнопки с
+* текстом, у заголовка или обёртки имя вычисляется из содержимого само, и
+* лишние `label`/`labelledBy` на базовом классе были бы мусором в каждом
+* наследнике.
+* Поэтому подключается по необходимости — как `TActionPlugin`.
+*
+* Почему плагин здесь годится, хотя обычно для ARIA не годится. Плагин,
+* который писал бы атрибуты прямо в DOM после монтирования, дал бы пустую
+* серверную разметку. Этот в DOM не ходит: он пишет в `instance.aria` — тот же
+* набор, что заполняют ядро и расширения коллекции, — а раскладывает набор
+* шаблон, синхронно.
+*
+* Входов у плагина три: пропсы (`aria_label`, `aria_labelledBy`,
+* `aria_describedBy`) — их задаёт разметка компонента, — ссылки от разметки
+* вокруг (`links`) — их пишет поле формы `Field` своему контролу — и ссылки
+* на части своей разметки (`parts`) — их пишет плагин связок компонента
+* (счётчик символов Textarea). Сливает их плагин: подпись поля — имя, пока
+* своего нет, а в `aria-describedby` встают по порядку пояснение поля, свои
+* части и своё пояснение. Второго писателя тех же атрибутов нет, и ни один
+* вход не стирает другой.
+*/
+var TAriaPlugin = class TAriaPlugin extends TBasePlugin {
+	/**
+	* Умолчания пропов — «имени нет». Объявлены ключами без значения, как
+	* `closable` у элемента Tabs: значим ключ, а не значение. Снятый из разметки
+	* проп связка возвращает к умолчанию декларации, и без ключа у компонента
+	* оставалось бы прежнее имя. В декларацию их кладёт `definePlugin` — см.
+	* `TAnchorPlugin.defaultValues`.
+	*/
+	static defaultValues = {
+		label: void 0,
+		labelledBy: void 0,
+		describedBy: void 0
+	};
+	_instance = null;
+	_label = TAriaPlugin.defaultValues.label;
+	_labelledBy = TAriaPlugin.defaultValues.labelledBy;
+	_describedBy = TAriaPlugin.defaultValues.describedBy;
+	_links = NO_LINKS;
+	_parts = NO_PARTS;
+	_role;
+	install(ctx, options) {
+		super.install(ctx, options);
+		this._instance = ctx.getInstance();
+		this._role = options?.role;
+		this._apply();
+	}
+	/**
+	* Доступное имя.
+	*
+	* Пустая строка приравнена к отсутствию: `aria-label=""` имени не даёт, но
+	* глушит вычисление имени из содержимого — хуже, чем не ставить атрибут.
+	*/
+	get label() {
+		return this._label;
+	}
+	set label(value) {
+		const oldLabel = this.label;
+		if (this._label === value) return;
+		this._label = value;
+		this._apply();
+		this.events.emit("change:label", {
+			newValue: value,
+			oldValue: oldLabel
+		});
+	}
+	/**
+	* `id` элемента, чей текст служит именем. Приоритетнее `label` — так решает
+	* сам алгоритм вычисления имени в браузере, и мы ему не противоречим.
+	*/
+	get labelledBy() {
+		return this._labelledBy;
+	}
+	set labelledBy(value) {
+		const oldLabelledBy = this.labelledBy;
+		if (this._labelledBy === value) return;
+		this._labelledBy = value;
+		this._apply();
+		this.events.emit("change:labelledBy", {
+			newValue: value,
+			oldValue: oldLabelledBy
+		});
+	}
+	/** `id` элемента с пояснением: подсказка под полем, текст ошибки. */
+	get describedBy() {
+		return this._describedBy;
+	}
+	set describedBy(value) {
+		const oldDescribedBy = this.describedBy;
+		if (this._describedBy === value) return;
+		this._describedBy = value;
+		this._apply();
+		this.events.emit("change:describedBy", {
+			newValue: value,
+			oldValue: oldDescribedBy
+		});
+	}
+	/**
+	* Ссылки от разметки вокруг — подпись и пояснение поля формы. Не проп: в
+	* контракт плагина не входит, пишет его связка поля с контролом
+	* (`TFieldControlExtension`), а не разметка компонента.
+	*
+	* - `labelledBy` — имя, пока своего нет: своё (`label`, `labelledBy`)
+	*   главнее, иначе подпись поля перекрыла бы имя, которое задал
+	*   потребитель;
+	* - `describedBy` — перед своим: `aria-describedby` получает оба `id`,
+	*   пояснение поля — первым.
+	*
+	* Объект заменяется целиком, а не правится на месте.
+	*/
+	get links() {
+		return this._links;
+	}
+	set links(value) {
+		if (sameLinks(value, this._links)) return;
+		this._links = value;
+		this._apply();
+	}
+	/**
+	* Ссылки на части своей разметки — часть без своего экземпляра, которая
+	* поясняет компонент: счётчик символов Textarea. Не проп: в контракт
+	* плагина не входит, как и `links`, — пишет его плагин связок компонента,
+	* который знает `id` части, а не разметка.
+	*
+	* Только пояснение: `describedBy` встаёт в `aria-describedby` после
+	* пояснения поля формы и перед своим. Так части звучат на фокусе
+	* компонента, вместе с ним, а не живым регионом на каждое изменение.
+	*
+	* Объект заменяется целиком, а не правится на месте.
+	*/
+	get parts() {
+		return this._parts;
+	}
+	set parts(value) {
+		if (value.describedBy === this._parts.describedBy) return;
+		this._parts = value;
+		this._apply();
+	}
+	/**
+	* Есть ли у компонента имя из этого плагина — своё или подпись поля.
+	* Описание именем не считается.
+	*/
+	get named() {
+		return !!(this._label || this._labelledBy || this._links.labelledBy);
+	}
+	/** Пишет свою часть в общий набор компонента. */
+	_apply() {
+		const aria = this._instance?.aria;
+		if (!aria) return;
+		const labelledBy = this._labelledBy || (this._label ? void 0 : this._links.labelledBy);
+		const describedBy = [
+			this._links.describedBy,
+			this._parts.describedBy,
+			this._describedBy
+		].filter(Boolean).join(" ");
+		aria.add("aria-label", this._label || null);
+		aria.add("aria-labelledby", labelledBy || null);
+		aria.add("aria-describedby", describedBy || null);
+		if (!this._role) return;
+		aria.add("role", this.named ? this._role : null);
+		aria.add("aria-hidden", this.named ? null : "true");
+	}
+	destroy() {
+		this._instance = null;
+		this._label = void 0;
+		this._labelledBy = void 0;
+		this._describedBy = void 0;
+		this._links = NO_LINKS;
+		this._parts = NO_PARTS;
+		this._role = void 0;
+		super.destroy();
+	}
+};
+//#endregion
+export { TAriaPlugin };

package/dist/custom/component-view/index.d.ts

@@ -0,0 +1,2 @@
+export { TAriaPlugin } from './aria.plugin';
+export type { IAriaLinks, IAriaParts, IAriaPluginOptions, TAriaPluginEvents, IAriaPluginProps, } from './types';

package/dist/custom/component-view/types.d.ts

@@ -0,0 +1,62 @@
+import type { TValuePayload } from '@soxa-ui/core';
+import type { TPluginEvents } from '../../base';
+/**
+ * Настройки TAriaPlugin.
+ */
+export interface IAriaPluginOptions {
+    /**
+     * Роль, которую элемент принимает, как только у него появилось имя.
+     *
+     * Нужна там, где без имени элемент декоративен: `TIcon` по умолчанию
+     * отдаёт `aria-hidden="true"`, а с именем обязан стать `role="img"`.
+     * Компонентам, у которых роль не зависит от наличия имени, не нужна.
+     */
+    role?: string;
+}
+export type TAriaPluginEvents = TPluginEvents & {
+    /** change:label */
+    'change:label': (payload: TValuePayload<string | undefined>) => void;
+    /** change:labelledBy */
+    'change:labelledBy': (payload: TValuePayload<string | undefined>) => void;
+    /** change:describedBy */
+    'change:describedBy': (payload: TValuePayload<string | undefined>) => void;
+};
+/**
+ * Пропсы плагина такими, какими их объявляет contribution — без неймспейса.
+ *
+ * Неймспейс (`aria_label`) навешивает `DescriptorAllProps` в `@soxa-ui/setup`
+ * по `namespace` из `definePlugin`; здесь только собственные имена пропсов.
+ */
+export interface IAriaPluginProps {
+    label?: string;
+    labelledBy?: string;
+    describedBy?: string;
+}
+/**
+ * Ссылки от разметки вокруг компонента — второй вход плагина рядом с
+ * пропсами: подпись и пояснение поля формы (`Field`). Пишет их связка поля с
+ * контролом, а не разметка компонента, поэтому в контракт они не входят.
+ */
+export interface IAriaLinks {
+    /**
+     * `id` подписи — имя, пока своего нет: своё имя (`label`, `labelledBy`)
+     * главнее
+     */
+    readonly labelledBy?: string;
+    /** `id` пояснения — встаёт в `aria-describedby` перед своим */
+    readonly describedBy?: string;
+}
+/**
+ * Ссылки на части своей разметки — третий вход плагина: часть компонента без
+ * своего экземпляра, которая его поясняет (счётчик символов Textarea). Пишет
+ * их плагин связок компонента, а не разметка, поэтому в контракт они не
+ * входят, как и `IAriaLinks`. Только пояснение: имя компоненту его часть не
+ * даёт.
+ */
+export interface IAriaParts {
+    /**
+     * `id` части-пояснения — встаёт в `aria-describedby` после пояснения поля
+     * формы и перед своим `describedBy`
+     */
+    readonly describedBy?: string;
+}

package/dist/custom/date-input/clipboard/clipboard.plugin.d.ts

@@ -0,0 +1,41 @@
+import type { IDateInput } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TDateInputClipboardPluginEvents } from './types';
+/**
+ * TDateInputClipboardPlugin — буфер обмена и перетаскивание поля даты: дата
+ * копируется, вырезается и вставляется как текст.
+ *
+ * **Копирование и вырезание** — то, что выделено в ряду, текстом узлов:
+ * `12.05.2026`, `05.2026`. Текст собирает плагин, а не браузер: Chrome ставит
+ * перевод строки между флекс-коробками частей. Слушатель — на документе:
+ * протяжка, начатая с пустого места поля, оставляет фокус вне частей, а
+ * событие буфера приходит туда, где фокус. Выделение шире ряда — не поля, и его
+ * копирует браузер. Вырезание вдобавок очищает задетые части; у поля только для
+ * чтения — копирует, и только.
+ *
+ * **Перетаскивание** выделенной даты кладёт тот же текст.
+ *
+ * **Вставка** приходит на часть под фокусом, хотя она нередактируемая: текст
+ * уходит ядру, и дата ISO или в формате поля заменяет всю дату. Не дата —
+ * ничего не меняется, но вставка гасится всегда: в ряду, ставшем редактируемым
+ * ради контекстного меню, браузер вставил бы текст в разметку.
+ */
+export declare class TDateInputClipboardPlugin extends TBasePlugin<IDateInput, TDateInputClipboardPluginEvents> {
+    private _owner;
+    private _root;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    /** Корень сменился — слушатели переезжают, у документа — тоже: он может быть другим. */
+    private _bind;
+    private readonly _onCopy;
+    /** Вырезание — копирование и очистка задетых частей. */
+    private readonly _onCut;
+    /** Положить в буфер выделенное в ряду; выделение не поля — `null`, буфер браузера. */
+    private _copy;
+    private readonly _onPaste;
+    /** Перетаскивают выделенную дату — тот же текст, что в буфер. */
+    private readonly _onDragStart;
+    /** Выделение документа в ряду поля. */
+    private _selection;
+}

package/dist/custom/date-input/clipboard/clipboard.plugin.js

@@ -0,0 +1,98 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { rangeText, rowOf, rowSelection, segmentsOf, touchedSegments } from "../parts.js";
+//#region src/custom/date-input/clipboard/clipboard.plugin.ts
+/** Текст для буфера и перетаскивания — обычный текст, без разметки частей. */
+var PLAIN_TEXT = "text/plain";
+/**
+* TDateInputClipboardPlugin — буфер обмена и перетаскивание поля даты: дата
+* копируется, вырезается и вставляется как текст.
+*
+* **Копирование и вырезание** — то, что выделено в ряду, текстом узлов:
+* `12.05.2026`, `05.2026`. Текст собирает плагин, а не браузер: Chrome ставит
+* перевод строки между флекс-коробками частей. Слушатель — на документе:
+* протяжка, начатая с пустого места поля, оставляет фокус вне частей, а
+* событие буфера приходит туда, где фокус. Выделение шире ряда — не поля, и его
+* копирует браузер. Вырезание вдобавок очищает задетые части; у поля только для
+* чтения — копирует, и только.
+*
+* **Перетаскивание** выделенной даты кладёт тот же текст.
+*
+* **Вставка** приходит на часть под фокусом, хотя она нередактируемая: текст
+* уходит ядру, и дата ISO или в формате поля заменяет всю дату. Не дата —
+* ничего не меняется, но вставка гасится всегда: в ряду, ставшем редактируемым
+* ради контекстного меню, браузер вставил бы текст в разметку.
+*/
+var TDateInputClipboardPlugin = class extends TBasePlugin {
+	_owner = null;
+	_root = null;
+	install(ctx) {
+		super.install(ctx);
+		this._owner = ctx.getInstance() ?? null;
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => this._bind(element));
+		elementPlugin?.events.on("removed", () => this._bind(null));
+	}
+	destroy() {
+		this._bind(null);
+		this._owner = null;
+		super.destroy();
+	}
+	/** Корень сменился — слушатели переезжают, у документа — тоже: он может быть другим. */
+	_bind(root) {
+		const previous = this._root;
+		previous?.removeEventListener("paste", this._onPaste);
+		previous?.removeEventListener("dragstart", this._onDragStart);
+		this._root?.ownerDocument.removeEventListener("copy", this._onCopy);
+		this._root?.ownerDocument.removeEventListener("cut", this._onCut);
+		this._root = root;
+		const target = root;
+		target?.addEventListener("paste", this._onPaste);
+		target?.addEventListener("dragstart", this._onDragStart);
+		root?.ownerDocument.addEventListener("copy", this._onCopy);
+		root?.ownerDocument.addEventListener("cut", this._onCut);
+	}
+	_onCopy = (event) => {
+		this._copy(event);
+	};
+	/** Вырезание — копирование и очистка задетых частей. */
+	_onCut = (event) => {
+		const range = this._copy(event);
+		const owner = this._owner;
+		const root = this._root;
+		if (range && owner && root) owner.clearSegments(touchedSegments(segmentsOf(owner, root), range));
+	};
+	/** Положить в буфер выделенное в ряду; выделение не поля — `null`, буфер браузера. */
+	_copy(event) {
+		const range = this._selection();
+		if (event.defaultPrevented || !range || !event.clipboardData) return null;
+		event.clipboardData.setData(PLAIN_TEXT, rangeText(range));
+		event.preventDefault();
+		return range;
+	}
+	_onPaste = (event) => {
+		const owner = this._owner;
+		const root = this._root;
+		const row = owner && root ? rowOf(owner, root) : null;
+		if (!owner || !row || event.defaultPrevented) return;
+		if (!(event.target instanceof Node) || !row.contains(event.target)) return;
+		event.preventDefault();
+		owner.paste(event.clipboardData?.getData(PLAIN_TEXT) ?? "");
+	};
+	/** Перетаскивают выделенную дату — тот же текст, что в буфер. */
+	_onDragStart = (event) => {
+		const range = this._selection();
+		if (!range || !event.dataTransfer) return;
+		event.dataTransfer.clearData();
+		event.dataTransfer.setData(PLAIN_TEXT, rangeText(range));
+	};
+	/** Выделение документа в ряду поля. */
+	_selection() {
+		const owner = this._owner;
+		const root = this._root;
+		const row = owner && root ? rowOf(owner, root) : null;
+		return row ? rowSelection(row) : null;
+	}
+};
+//#endregion
+export { TDateInputClipboardPlugin };

package/dist/custom/date-input/clipboard/index.d.ts

@@ -0,0 +1,2 @@
+export { TDateInputClipboardPlugin } from './clipboard.plugin';
+export type { TDateInputClipboardPluginEvents } from './types';

package/dist/custom/date-input/clipboard/types.d.ts

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

package/dist/custom/date-input/ids/ids.plugin.d.ts

@@ -0,0 +1,21 @@
+import type { IDateInput } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TDateInputIdsPlugin — `id` частей поля даты в документе.
+ *
+ * Пишет `id` каждой части в её набор (`segmentSets` поля), который ядро
+ * раскладывает в `segments`. По нему часть ссылается на себя, когда её имя
+ * собирают из её имени и имени поля (`aria-labelledby` на сенсорных
+ * устройствах Apple — `TDateInputTouchPlugin`).
+ *
+ * `id` — от монтирования (`createId`) и типа части, а не от места в формате:
+ * смена локали переставляет части, а их `id` остаются. Пишется при установке,
+ * синхронно, — `id` есть уже в первой (и серверной) отрисовке. Пишется всем
+ * типам частей, а не только частям формата: смена вида поля, точности времени
+ * и локали добавляет части (время, секунду, период суток), и у них `id` уже
+ * есть, кто бы ни прочёл набор первым.
+ */
+export declare class TDateInputIdsPlugin extends TBasePlugin<IDateInput> {
+    install(ctx: IPluginContext): void;
+}

package/dist/custom/date-input/ids/ids.plugin.js

@@ -0,0 +1,28 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { allPartTypes } from "../parts.js";
+//#region src/custom/date-input/ids/ids.plugin.ts
+/**
+* TDateInputIdsPlugin — `id` частей поля даты в документе.
+*
+* Пишет `id` каждой части в её набор (`segmentSets` поля), который ядро
+* раскладывает в `segments`. По нему часть ссылается на себя, когда её имя
+* собирают из её имени и имени поля (`aria-labelledby` на сенсорных
+* устройствах Apple — `TDateInputTouchPlugin`).
+*
+* `id` — от монтирования (`createId`) и типа части, а не от места в формате:
+* смена локали переставляет части, а их `id` остаются. Пишется при установке,
+* синхронно, — `id` есть уже в первой (и серверной) отрисовке. Пишется всем
+* типам частей, а не только частям формата: смена вида поля, точности времени
+* и локали добавляет части (время, секунду, период суток), и у них `id` уже
+* есть, кто бы ни прочёл набор первым.
+*/
+var TDateInputIdsPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const owner = ctx.getInstance();
+		if (!owner) return;
+		for (const type of allPartTypes()) owner.segmentSets(type).aria.add("id", ctx.createId(type));
+	}
+};
+//#endregion
+export { TDateInputIdsPlugin };

package/dist/custom/date-input/ids/index.d.ts

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

package/dist/custom/date-input/index.d.ts

@@ -0,0 +1,6 @@
+export * from './clipboard';
+export * from './ids';
+export * from './keyboard';
+export * from './pointer';
+export * from './touch';
+export { firstSegmentOf } from './parts';

package/dist/custom/date-input/keyboard/index.d.ts

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

package/dist/custom/date-input/keyboard/keyboard.plugin.d.ts

@@ -0,0 +1,54 @@
+import type { IDateInput } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TDateInputKeyboardPluginEvents } from './types';
+/**
+ * TDateInputKeyboardPlugin — клавиатура поля даты и DOM-фокус, который идёт
+ * за частью под фокусом ядра.
+ *
+ * Части нередактируемые: браузер текст сам не правит и `beforeinput` не шлёт,
+ * а всё, что делает клавиша, — команда ядра. Клавиши берутся только с самой
+ * части: у содержимого слотов (кнопки календаря) свои клавиши. Обработанная
+ * клавиша гасится `preventDefault`.
+ *
+ * - **Цифра** — набор в часть (`typeKey`); цифры ASCII, локали и
+ *   полноширинные различает ядро. Во время композиции IME клавиша не наша.
+ * - **Буква** у периода суток — тот же `typeKey`: какой период она выбирает,
+ *   решает ядро по именам периодов локали.
+ * - **↑/↓, Home/End** — число части (у периода суток — другой период),
+ *   **Backspace** — стереть цифру (с пустой части — фокус на предыдущую),
+ *   **Delete** — очистить часть, **←/→** — соседняя часть по направлению ряда.
+ * - **Ctrl/Cmd+A** — выделение браузера на весь ряд, по `code`, а не `key`:
+ *   на русской раскладке `key` — «ф». Фокус остаётся на части, копирует и
+ *   вырезает выделенное плагин буфера обмена.
+ * - **Выделение задело части** — Delete и Backspace их очищают, цифра
+ *   очищает и набирается в первую (`replaceSegments`). Выделение браузер у
+ *   нередактируемого текста сам не снимает, поэтому клавишу, которую поле
+ *   обработало, плагин снимает с ним вместе.
+ *
+ * **Фокус.** `focusin` на части сообщает ядру часть, `focusout` из ряда —
+ * что фокуса в поле нет. Обратно — `change:focusedSegment`: ядро перевело
+ * фокус (набрали число до конца, Backspace на пустой части), и DOM-фокус идёт
+ * за ним, если стоит в ряду. Своих `tabindex` у плагина нет: остановка Tab у
+ * каждой части — набор, который отдаёт ядро.
+ */
+export declare class TDateInputKeyboardPlugin extends TBasePlugin<IDateInput, TDateInputKeyboardPluginEvents> {
+    private _owner;
+    private _root;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    /** Корень сменился — слушатели переезжают. */
+    private _bind;
+    private readonly _onKeyDown;
+    /** Исполнить клавишу; клавиша не поля — `false`. */
+    private _handle;
+    /** Фокус пришёл на часть — ядро ведёт набор в неё; не на часть — фокуса в поле нет. */
+    private readonly _onFocusIn;
+    /** Фокус ушёл не на часть — из поля. На соседнюю часть его приведёт `focusin`. */
+    private readonly _onFocusOut;
+    /**
+     * Ядро перевело фокус на другую часть — DOM-фокус за ним, если он в ряду:
+     * фокус, который пользователь увёл со страницы, поле не забирает.
+     */
+    private readonly _onFocusedSegment;
+}