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

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

@@ -0,0 +1,276 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { isAppleTouch } from "../../../utils/isAppleTouch.js";
+import { formatPartsOf, rowOf, rowSelection, segmentOf, segmentsOf, touchedSegments } from "../parts.js";
+//#region src/custom/date-input/touch/touch.plugin.ts
+/**
+* Режим по указателю нажатия: палец и перо делают части редактируемыми, мышь —
+* нет. Нажатие без указателя (`pointerType` пуст у нажатия, которое браузер
+* собрал сам) режим не меняет.
+*/
+var POINTER_MODES = /* @__PURE__ */ new Map([
+	["touch", true],
+	["pen", true],
+	["mouse", false]
+]);
+/**
+* Атрибуты редактируемой части без проверки орфографии и автозамены —
+* подсказки клавиатуры шли бы композицией.
+*/
+var EDITABLE_ATTRS = {
+	contenteditable: "true",
+	spellcheck: "false",
+	autocorrect: "off"
+};
+/**
+* Экранная клавиатура части: цифры — у числа, буквы — у слова (период суток
+* набирают буквой, `A` или `P`).
+*/
+var INPUT_MODES = {
+	numeric: "numeric",
+	word: "text"
+};
+/** Роль части на сенсорных устройствах Apple: счётчик VoiceOver на iOS не фокусирует. */
+var APPLE_TOUCH_ROLE = "textbox";
+/**
+* Правки композиции в Safari: по её окончании браузер убирает её текст и
+* вставляет итог. Гасятся без набора — набранное в композиции ядро получает на
+* `compositionend`, одним путём во всех браузерах.
+*/
+var COMPOSITION_EDITS = /* @__PURE__ */ new Set(["deleteCompositionText", "insertFromComposition"]);
+/**
+* TDateInputTouchPlugin — сенсорный режим поля даты: на касание части
+* редактируемые, и дату вводят с экранной клавиатуры.
+*
+* На компьютере части нередактируемые — так дату целиком выделяет протяжка
+* мышью. Но экранная клавиатура открывается только над редактируемым узлом.
+* Поэтому **режим выбирает нажатие**, а не устройство: палец и перо
+* (`pointerType`) делают части редактируемыми (`contenteditable`; клавиатура
+* цифр, у периода суток — букв: его набирают буквой), мышь — снова нет. Смена
+* вида поля, точности времени и локали меняет состав частей, и наборы
+* пересчитываются: новым частям — те же атрибуты. На ноутбуке с сенсорным экраном
+* мышь сохраняет протяжку, а палец получает клавиатуру. Режим меняется на
+* `pointerdown`, раньше фокуса: фокус браузер переводит после конца касания, а
+* нажатие мышью начинает протяжку уже по нередактируемым частям. Атрибуты
+* идут значениями в наборы частей (`segmentSets`), разметку рисует фреймворк;
+* сервер рисует части нередактируемыми.
+*
+* **Текст части пишет ядро.** Правка браузера (`beforeinput`) гасится и
+* становится командой: вставка — знаки по одному, как клавиши (`typeKey`;
+* по выделению — вместо задетых частей), стирание назад — цифра
+* (`eraseDigit`), другое удаление — часть или задетые выделением части. Чего
+* отменить нельзя — композиции (IME, клавиатуры Android) — браузер пишет в
+* часть сам; по `compositionend` набранное уходит ядру, а часть получает текст
+* ядра обратно. Так же — после правки, которую браузер всё же сделал мимо
+* отмены (SwiftKey стирает и после погашенного Backspace).
+*
+* **Сенсорные устройства Apple.** VoiceOver на iOS счётчик (`spinbutton`) не
+* фокусирует — роль частей там `textbox`; а групп не объявляет — имя поля
+* входит в имя каждой части: ссылкой на себя и на подпись поля
+* (`aria-labelledby`), у поля, названного строкой, — строкой («день, Дата
+* рождения»). Устройство плагин узнаёт после `ready`, у документа корня, и
+* сервер рисует счётчики.
+*
+* Клавиши, которые экранная клавиатура шлёт как клавиши (`keydown` с цифрой),
+* исполняет плагин клавиатуры, и правки за ними браузер не делает: клавиша
+* погашена.
+*/
+var TDateInputTouchPlugin = class extends TBasePlugin {
+	_owner = null;
+	_root = null;
+	/** Последнее нажатие на поле — пальцем или пером: части редактируемые */
+	_touch = false;
+	/** Сенсорное устройство Apple: роль частей — `textbox`, имя поля — в имени части */
+	_appleTouch = false;
+	/** Идёт композиция: её текст в части вернёт `compositionend` */
+	_composing = false;
+	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));
+		this._listenTo(this._owner?.events, "change:disabled", this._syncEditable);
+		this._listenTo(this._owner?.events, "change:readonly", this._syncEditable);
+		this._listenTo(this._owner?.events, "change:aria", this._syncAppleTouch);
+		for (const event of [
+			"change:kind",
+			"change:timePrecision",
+			"change:locale"
+		]) {
+			this._listenTo(this._owner?.events, event, this._syncEditable);
+			this._listenTo(this._owner?.events, event, this._syncAppleTouch);
+		}
+	}
+	/**
+	* Записанное в наборы частей уходит вместе с плагином: наборы — у поля, а
+	* поле переживает монтирование.
+	*/
+	destroy() {
+		this._bind(null);
+		this._touch = false;
+		this._appleTouch = false;
+		this._syncEditable();
+		this._syncAppleTouch();
+		this._owner = null;
+		super.destroy();
+	}
+	/** Части редактируемые: нажатие пальцем или пером, и поле можно править. */
+	get _editable() {
+		const owner = this._owner;
+		return this._touch && owner !== null && !owner.disabled && !owner.readonly;
+	}
+	/** Корень сменился — слушатели переезжают; устройство — у документа корня. */
+	_bind(root) {
+		const previous = this._root;
+		previous?.removeEventListener("pointerdown", this._onPointerDown);
+		previous?.removeEventListener("beforeinput", this._onBeforeInput);
+		previous?.removeEventListener("input", this._onInput);
+		previous?.removeEventListener("compositionstart", this._onCompositionStart);
+		previous?.removeEventListener("compositionend", this._onCompositionEnd);
+		this._root = root;
+		this._composing = false;
+		const target = root;
+		target?.addEventListener("pointerdown", this._onPointerDown);
+		target?.addEventListener("beforeinput", this._onBeforeInput);
+		target?.addEventListener("input", this._onInput);
+		target?.addEventListener("compositionstart", this._onCompositionStart);
+		target?.addEventListener("compositionend", this._onCompositionEnd);
+		if (!root) return;
+		this._appleTouch = isAppleTouch(root.ownerDocument.defaultView?.navigator);
+		this._syncAppleTouch();
+	}
+	/** Нажатие на поле выбирает режим: палец и перо — части редактируемые, мышь — нет. */
+	_onPointerDown = (event) => {
+		const touch = POINTER_MODES.get(event.pointerType);
+		if (touch === void 0 || touch === this._touch) return;
+		this._touch = touch;
+		this._syncEditable();
+	};
+	/**
+	* Правка браузера в части гасится и становится командой ядра. Правка
+	* приходит только туда, где можно править, — в части, которые плагин сделал
+	* редактируемыми.
+	*/
+	_onBeforeInput = (event) => {
+		const owner = this._owner;
+		const root = this._root;
+		if (!owner || !root || event.defaultPrevented || !this._editable) return;
+		const node = segmentOf(owner, root, event.target);
+		if (!node) return;
+		if (event.inputType === "insertCompositionText") return;
+		event.preventDefault();
+		if (COMPOSITION_EDITS.has(event.inputType)) return;
+		this._edit(owner, root, node.part, event.inputType, event.data);
+	};
+	/**
+	* Правка части — команда ядра. Вставка — знаки по одному, как клавиши, а
+	* если выделение задело части — вместо них. Удаление назад — цифра (с пустой
+	* части ядро уводит фокус на предыдущую), другое удаление — часть; задетые
+	* выделением части — целиком.
+	*/
+	_edit(owner, root, part, inputType, data) {
+		owner.focusSegment(part);
+		const row = rowOf(owner, root);
+		const range = row ? rowSelection(row) : null;
+		const touched = range ? touchedSegments(segmentsOf(owner, root), range) : [];
+		if (inputType.startsWith("delete")) {
+			if (touched.length > 0) owner.clearSegments(touched);
+			else if (inputType === "deleteContentBackward") owner.eraseDigit();
+			else owner.clearSegment();
+		} else if (data) typeText(owner, touched, data);
+		if (touched.length > 0) root.ownerDocument.getSelection()?.collapseToEnd();
+	}
+	/**
+	* Браузер поправил текст части мимо отмены — клавиатура не уважает
+	* погашенный `beforeinput`, — и часть получает текст ядра обратно. Пока
+	* идёт композиция, её текст часть показывает: его вернёт `compositionend`.
+	*/
+	_onInput = (event) => {
+		const owner = this._owner;
+		const root = this._root;
+		if (!owner || !root || this._composing) return;
+		const node = segmentOf(owner, root, event.target);
+		if (node) restoreText(owner, node.part, node.element);
+	};
+	_onCompositionStart = () => {
+		this._composing = true;
+	};
+	/**
+	* Композиция кончилась: набранное — в ядро знаками, как клавиши, а часть
+	* получает текст ядра обратно. Текст композиции браузер писал в часть мимо
+	* фреймворка, и тот его не перерисует, если текст ядра не сменился: набрали
+	* не цифры.
+	*/
+	_onCompositionEnd = (event) => {
+		this._composing = false;
+		const owner = this._owner;
+		const root = this._root;
+		if (!owner || !root) return;
+		const node = segmentOf(owner, root, event.target);
+		if (!node) return;
+		owner.focusSegment(node.part);
+		typeText(owner, [], event.data);
+		restoreText(owner, node.part, node.element);
+	};
+	/** Атрибуты редактируемости — в наборы частей: части редактируемы на касание. */
+	_syncEditable = () => {
+		const owner = this._owner;
+		if (!owner) return;
+		const editable = this._editable;
+		for (const { type, numeric } of formatPartsOf(owner)) {
+			const { attrs } = owner.segmentSets(type);
+			for (const [name, value] of Object.entries(EDITABLE_ATTRS)) attrs.add(name, editable ? value : null);
+			attrs.add("inputmode", editable ? INPUT_MODES[numeric ? "numeric" : "word"] : null);
+		}
+	};
+	/**
+	* Роль и имя частей на сенсорных устройствах Apple: `textbox` и имя поля в
+	* имени части. Подпись поля по `id` — ссылкой: часть называет себя (её
+	* `aria-label` — имя части) и подпись. Имя поля строкой — строкой, после
+	* имени части. Без своего `id` части сослаться на себя нельзя, и имя
+	* остаётся её собственным. На остальных устройствах набор пуст.
+	*/
+	_syncAppleTouch = () => {
+		const owner = this._owner;
+		if (!owner) return;
+		const apple = this._appleTouch;
+		const labelledBy = apple ? owner.aria.get("aria-labelledby") : void 0;
+		const label = apple && !labelledBy ? owner.aria.get("aria-label") : void 0;
+		for (const { type, name } of formatPartsOf(owner)) {
+			const { aria } = owner.segmentSets(type);
+			const id = aria.get("id");
+			aria.add("role", apple ? APPLE_TOUCH_ROLE : null);
+			aria.add("aria-labelledby", labelledBy && id ? `${id} ${labelledBy}` : null);
+			aria.add("aria-label", label ? `${name}, ${label}` : null);
+		}
+	};
+};
+/**
+* Знаки текста — в ядро по одному, как клавиши: первый — вместо задетых
+* выделением частей, если они есть. Часть, набранная до конца, переводит фокус
+* ядра, и следующие знаки идут в следующую часть.
+*/
+function typeText(owner, touched, text) {
+	const [first, ...rest] = [...text];
+	if (first === void 0) return;
+	if (touched.length > 0) owner.replaceSegments(touched, first);
+	else owner.typeKey(first);
+	for (const key of rest) owner.typeKey(key);
+}
+/**
+* Вернуть части текст ядра. Текстовый узел, если он один, остаётся тем же —
+* ссылка на него бывает у фреймворка; иначе содержимое заменяется целиком.
+*/
+function restoreText(owner, part, element) {
+	const text = formatPartsOf(owner).find((segment) => segment.type === part)?.text;
+	if (text === void 0) return;
+	const [first, ...rest] = element.childNodes;
+	if (first?.nodeType === Node.TEXT_NODE && rest.length === 0) {
+		if (first.nodeValue !== text) first.nodeValue = text;
+		return;
+	}
+	element.textContent = text;
+}
+//#endregion
+export { TDateInputTouchPlugin };

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

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

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

@@ -0,0 +1,6 @@
+import type { TDateFieldPart } from '@soxa-ui/core';
+/** Часть поля даты и её узел — коробка части в ряду. */
+export type TDateInputSegmentNode = {
+    readonly part: TDateFieldPart;
+    readonly element: Element;
+};

package/dist/custom/date-picker/field.d.ts

@@ -0,0 +1,20 @@
+import type { IDatePicker } from '@soxa-ui/core';
+import type { IPluginContext } from '../../base';
+/**
+ * Первая часть поля в корне DatePicker: у одной даты — поля `field`, у
+ * диапазона — поля начала `start`, оно стоит в корне раньше поля конца.
+ * `null` — части в корне нет.
+ *
+ * Одна на модель фокуса панели (куда вернуть фокус, когда открыли кнопкой
+ * календаря) и узел фокуса DatePicker (`fieldSegmentOf`): поле оба ищут одним
+ * правилом. Часть находят по классу экземпляра поля (`classes.resolve`), а не
+ * строкой.
+ */
+export declare function firstPartOf(owner: IDatePicker, root: Element): Element | null;
+/**
+ * Узел фокуса DatePicker (`focusTarget` плагина действия) — первая часть
+ * поля, у диапазона — поля начала: запись `focused = true` ставит фокус туда
+ * же, куда его возвращает панель, а не на коробку корня. `null` — инстанса или
+ * части в корне нет.
+ */
+export declare function fieldSegmentOf(root: Element, ctx: IPluginContext): Element | null;

package/dist/custom/date-picker/field.js

@@ -0,0 +1,27 @@
+//#region src/custom/date-picker/field.ts
+/**
+* Первая часть поля в корне DatePicker: у одной даты — поля `field`, у
+* диапазона — поля начала `start`, оно стоит в корне раньше поля конца.
+* `null` — части в корне нет.
+*
+* Одна на модель фокуса панели (куда вернуть фокус, когда открыли кнопкой
+* календаря) и узел фокуса DatePicker (`fieldSegmentOf`): поле оба ищут одним
+* правилом. Часть находят по классу экземпляра поля (`classes.resolve`), а не
+* строкой.
+*/
+function firstPartOf(owner, root) {
+	const field = owner.mode === "range" ? owner.start : owner.field;
+	return root.querySelector(field.classes.resolve("__segment", { point: true }));
+}
+/**
+* Узел фокуса DatePicker (`focusTarget` плагина действия) — первая часть
+* поля, у диапазона — поля начала: запись `focused = true` ставит фокус туда
+* же, куда его возвращает панель, а не на коробку корня. `null` — инстанса или
+* части в корне нет.
+*/
+function fieldSegmentOf(root, ctx) {
+	const owner = ctx.getInstance();
+	return owner ? firstPartOf(owner, root) : null;
+}
+//#endregion
+export { fieldSegmentOf, firstPartOf };

package/dist/custom/date-picker/focus/focus.plugin.d.ts

@@ -0,0 +1,56 @@
+import type { IPluginContext } from '../../../base';
+import { TOverlayFocusPlugin } from '../../overlay/focus';
+import type { IOverlayOpenOptions } from '../../overlay/types';
+import type { TDatePickerFocusPluginEvents } from './types';
+/**
+ * TDatePickerFocusPlugin — модель фокуса панели DatePicker, APG Date Picker
+ * Dialog.
+ *
+ * Общее с остальными оверлеями — запомнить, откуда открыли, увести фокус в
+ * панель кадром позже, вернуть его при закрытии, закрыть по Escape — берёт у
+ * `TOverlayFocusPlugin`. Своё у панели — смесь двух других моделей, поэтому
+ * и стратегия своя, а не флаг в одной из них:
+ *
+ * **Tab замкнут в панели, как у модальной** (`trapTab`): панель — диалог с
+ * `aria-modal`, фон спрятан от скринридера, и выйти из неё с клавиатуры можно
+ * только закрыв — выбором, Escape или кнопкой календаря.
+ *
+ * **Нажатие мимо фокус отпускает, как у немодальной.** Подложки у панели нет,
+ * и страница указателем остаётся рабочей: нажатие в соседнее поле закрывает
+ * панель, а фокус остаётся там, куда нажали, — с первого нажатия. Поэтому на
+ * `dismiss` плагин фокус не возвращает и `mousedown` этого нажатия не гасит,
+ * в отличие от модального окна.
+ *
+ * **Первый фокус — день сетки**, а не первая кнопка календаря: остановка
+ * сетки одна на все месяцы, и это день с фокусом коллекции — выбранная дата
+ * или сегодня (`resetFocus` при открытии). Сетки нет в панели — фокус встаёт
+ * на её первую остановку, как у любого оверлея.
+ *
+ * **Возврат — в поле.** Открыли с части поля (Alt+↓) — фокус возвращается
+ * на неё. Открыли кнопкой календаря — на первую часть поля, у диапазона —
+ * поля начала: кнопка местом возврата не считается (`_canReturnTo`). Туда
+ * же, если фокус при открытии был на `body`: так бывает после нажатия кнопки
+ * в Safari, где кнопка по нажатию фокус не получает, и фокус потерялся бы
+ * после выбора. APG возвращает фокус на кнопку; здесь — как у нативного
+ * `<input type="date">`, где кнопка календаря — часть поля: после выбора
+ * дату можно сразу поправить с клавиатуры. Часть поля плагин узнаёт по
+ * классу части (`__segment`) экземпляра поля DatePicker, как кнопку — по
+ * `__trigger`, а не строкой.
+ */
+export declare class TDatePickerFocusPlugin extends TOverlayFocusPlugin<TDatePickerFocusPluginEvents> {
+    private _owner;
+    install(ctx: IPluginContext, options?: IOverlayOpenOptions): void;
+    destroy(): void;
+    /** Tab по кругу внутри панели. */
+    protected _onTab(event: KeyboardEvent): void;
+    /** Остановка сетки календаря — первой, перед остановками панели по порядку. */
+    protected _focusCandidates(panel: Element): readonly Element[];
+    /** Кнопка календаря в корне местом возврата не считается: фокус — в поле. */
+    protected _canReturnTo(element: Element, root: Element): boolean;
+    /**
+     * Запомненного элемента нет или это кнопка календаря — фокус на первую часть
+     * поля, у диапазона — поля начала (`firstPartOf`): туда же его ставит запись
+     * `focused = true`.
+     */
+    protected _returnCandidates(root: Element): readonly Element[];
+}

package/dist/custom/date-picker/focus/focus.plugin.js

@@ -0,0 +1,81 @@
+import { tabStops } from "../../../utils/tabStops.js";
+import { trapTab } from "../../../utils/trapTab.js";
+import { TDismissPlugin } from "../../dismiss/dismiss.plugin.js";
+import { TOverlayFocusPlugin } from "../../overlay/focus/focus.plugin.js";
+import { firstPartOf } from "../field.js";
+//#region src/custom/date-picker/focus/focus.plugin.ts
+/**
+* TDatePickerFocusPlugin — модель фокуса панели DatePicker, APG Date Picker
+* Dialog.
+*
+* Общее с остальными оверлеями — запомнить, откуда открыли, увести фокус в
+* панель кадром позже, вернуть его при закрытии, закрыть по Escape — берёт у
+* `TOverlayFocusPlugin`. Своё у панели — смесь двух других моделей, поэтому
+* и стратегия своя, а не флаг в одной из них:
+*
+* **Tab замкнут в панели, как у модальной** (`trapTab`): панель — диалог с
+* `aria-modal`, фон спрятан от скринридера, и выйти из неё с клавиатуры можно
+* только закрыв — выбором, Escape или кнопкой календаря.
+*
+* **Нажатие мимо фокус отпускает, как у немодальной.** Подложки у панели нет,
+* и страница указателем остаётся рабочей: нажатие в соседнее поле закрывает
+* панель, а фокус остаётся там, куда нажали, — с первого нажатия. Поэтому на
+* `dismiss` плагин фокус не возвращает и `mousedown` этого нажатия не гасит,
+* в отличие от модального окна.
+*
+* **Первый фокус — день сетки**, а не первая кнопка календаря: остановка
+* сетки одна на все месяцы, и это день с фокусом коллекции — выбранная дата
+* или сегодня (`resetFocus` при открытии). Сетки нет в панели — фокус встаёт
+* на её первую остановку, как у любого оверлея.
+*
+* **Возврат — в поле.** Открыли с части поля (Alt+↓) — фокус возвращается
+* на неё. Открыли кнопкой календаря — на первую часть поля, у диапазона —
+* поля начала: кнопка местом возврата не считается (`_canReturnTo`). Туда
+* же, если фокус при открытии был на `body`: так бывает после нажатия кнопки
+* в Safari, где кнопка по нажатию фокус не получает, и фокус потерялся бы
+* после выбора. APG возвращает фокус на кнопку; здесь — как у нативного
+* `<input type="date">`, где кнопка календаря — часть поля: после выбора
+* дату можно сразу поправить с клавиатуры. Часть поля плагин узнаёт по
+* классу части (`__segment`) экземпляра поля DatePicker, как кнопку — по
+* `__trigger`, а не строкой.
+*/
+var TDatePickerFocusPlugin = class extends TOverlayFocusPlugin {
+	_owner = null;
+	install(ctx, options) {
+		super.install(ctx, options);
+		this._owner = ctx.getInstance() ?? null;
+		ctx.get(TDismissPlugin)?.events.on("dismiss", () => {
+			this._restore = false;
+		});
+	}
+	destroy() {
+		this._owner = null;
+		super.destroy();
+	}
+	/** Tab по кругу внутри панели. */
+	_onTab(event) {
+		if (this._panel) trapTab(event, this._panel);
+	}
+	/** Остановка сетки календаря — первой, перед остановками панели по порядку. */
+	_focusCandidates(panel) {
+		const grid = this._owner?.calendar.classes.resolve("__grid", { point: true });
+		return [...grid ? [...panel.querySelectorAll(grid)].flatMap((node) => tabStops(node)) : [], ...super._focusCandidates(panel)];
+	}
+	/** Кнопка календаря в корне местом возврата не считается: фокус — в поле. */
+	_canReturnTo(element, root) {
+		const trigger = this._owner?.classes.resolve("__trigger", { point: true });
+		const button = trigger ? element.closest(trigger) : null;
+		return !button || !root.contains(button);
+	}
+	/**
+	* Запомненного элемента нет или это кнопка календаря — фокус на первую часть
+	* поля, у диапазона — поля начала (`firstPartOf`): туда же его ставит запись
+	* `focused = true`.
+	*/
+	_returnCandidates(root) {
+		const part = this._owner ? firstPartOf(this._owner, root) : null;
+		return part ? [part] : [];
+	}
+};
+//#endregion
+export { TDatePickerFocusPlugin };

package/dist/custom/date-picker/focus/index.d.ts

@@ -0,0 +1,2 @@
+export { TDatePickerFocusPlugin } from './focus.plugin';
+export type { TDatePickerFocusPluginEvents } from './types';

package/dist/custom/date-picker/focus/types.d.ts

@@ -0,0 +1,3 @@
+import type { TPluginEvents } from '../../../base';
+/** Своих событий у плагина нет: фокус сообщает DOM. */
+export type TDatePickerFocusPluginEvents = TPluginEvents;

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

@@ -0,0 +1,19 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TDatePickerIdsPlugin — связка «кнопка календаря ↔ панель» DatePicker в
+ * документе.
+ *
+ * `id` панели — в `panelAria`, который разметка раскладывает на панель, и
+ * ссылка на него `aria-controls` — в `triggerAria` кнопки. Обе стороны
+ * пишутся здесь, от одного `id`: формула одна на обе, как у Popover.
+ *
+ * `id` — от монтирования (`createId`), а не от экземпляра: он нужен только
+ * документу, и на сервере и в браузере обязан совпасть. Пишется при
+ * установке, синхронно, — связка есть уже в первой (и серверной) отрисовке.
+ * `aria-controls` стоит и у закрытой панели: она всегда в документе,
+ * закрытие её только прячет.
+ */
+export declare class TDatePickerIdsPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

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

@@ -0,0 +1,28 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+//#region src/custom/date-picker/ids/ids.plugin.ts
+/**
+* TDatePickerIdsPlugin — связка «кнопка календаря ↔ панель» DatePicker в
+* документе.
+*
+* `id` панели — в `panelAria`, который разметка раскладывает на панель, и
+* ссылка на него `aria-controls` — в `triggerAria` кнопки. Обе стороны
+* пишутся здесь, от одного `id`: формула одна на обе, как у Popover.
+*
+* `id` — от монтирования (`createId`), а не от экземпляра: он нужен только
+* документу, и на сервере и в браузере обязан совпасть. Пишется при
+* установке, синхронно, — связка есть уже в первой (и серверной) отрисовке.
+* `aria-controls` стоит и у закрытой панели: она всегда в документе,
+* закрытие её только прячет.
+*/
+var TDatePickerIdsPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const picker = ctx.getInstance();
+		if (!picker) return;
+		const panelId = ctx.createId("panel");
+		picker.panelAria.add("id", panelId);
+		picker.triggerAria.add("aria-controls", panelId);
+	}
+};
+//#endregion
+export { TDatePickerIdsPlugin };

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

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

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

@@ -0,0 +1,5 @@
+export * from './focus';
+export * from './ids';
+export * from './trigger';
+export * from './names';
+export { fieldSegmentOf } from './field';

package/dist/custom/date-picker/names/index.d.ts

@@ -0,0 +1,2 @@
+export { TDatePickerNamesPlugin } from './names.plugin';
+export type { TDatePickerNamesPluginEvents } from './types';

package/dist/custom/date-picker/names/names.plugin.d.ts

@@ -0,0 +1,33 @@
+import type { IDatePicker, TEventSink } from '@soxa-ui/core';
+import { TClearableNamesPlugin } from '../../clearable/names';
+import type { TTranslations } from '../../../locale/types';
+import type { TDatePickerNamesPluginEvents } from './types';
+/**
+ * TDatePickerNamesPlugin — имена DatePicker от локали.
+ *
+ * Имя кнопки очистки — как у любого поля (`TClearableNamesPlugin`): DatePicker —
+ * поле, и имя его кнопки собирается с его именем (`field.clear`). Имя кнопки
+ * календаря — в её набор (`triggerAria`) и в набор панели (`panelAria`):
+ * панель называется так же, как кнопка, которая её открывает. Имена полей
+ * концов диапазона — выходами (`start`, `end`): поля — свои компоненты, и имя
+ * им разметка отдаёт пропом `aria_label`, который пишет их собственный
+ * `TAriaPlugin`. Текст кнопок подвала панели при `confirmable` — тоже выходами
+ * (`confirm`, `cancel`): кнопки — свои компоненты, и текст им разметка отдаёт
+ * пропом `text`.
+ */
+export declare class TDatePickerNamesPlugin extends TClearableNamesPlugin<IDatePicker, TDatePickerNamesPluginEvents> {
+    private _start;
+    private _end;
+    private _confirm;
+    private _cancel;
+    /** Имя поля начала диапазона. */
+    get start(): string;
+    /** Имя поля конца диапазона. */
+    get end(): string;
+    /** Текст кнопки «OK» подвала панели. */
+    get confirm(): string;
+    /** Текст кнопки «Отмена» подвала панели. */
+    get cancel(): string;
+    protected get _sink(): TEventSink<TDatePickerNamesPluginEvents>;
+    protected _name(owner: IDatePicker, translations: TTranslations): void;
+}