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

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

@@ -0,0 +1,125 @@
+import type { ISelectItem, TCollectionEngine } from '@soxa-ui/core';
+import type { IPluginContext } from '../../../base';
+import { TListNavigationPlugin } from '../../list/navigation';
+import type { TListEdge } from '../../list/navigation';
+import type { ISelectKeyboardHost } from './strategies';
+import type { ISelectKeyboardPluginOptions, TSelectKeyboardPluginEvents } from './types';
+/**
+ * TSelectKeyboardPlugin — клавиатура поля выбора по паттерну APG Combobox.
+ *
+ * Общая механика — подписка на `keydown`, привязка к коллекции, учёт
+ * подсветки, циклический сдвиг, пропуск недоступных опций — в
+ * `TListNavigationPlugin`. Что делают конкретные клавиши, решает выбранная
+ * стратегия (`strategies/`):
+ * `TSelectOnlyKeyboardStrategy` и `TEditableKeyboardStrategy` — обе поверх
+ * общей части `TSelectKeyboardStrategy`. Плагин сам не проверяет
+ * `owner.editable` нигде — режим выражен подпиской на `change:editable`,
+ * которая переключает стратегию, а не веткой внутри обработчика.
+ *
+ * Ключевое свойство паттерна: **DOM-фокус никогда не уходит с поля**. Поэтому
+ * `keydown` слушается на корне Select, а не на списке, и панель может быть
+ * телепортирована куда угодно — на навигацию это не влияет. Подсветку для
+ * скринридера передаёт `aria-activedescendant` на поле.
+ *
+ * Слушатель висит на корне, но клавишу комбобокс берёт только с `<input>`
+ * поля. До корня всплывают и клавиши кнопки очистки, крестиков тегов и
+ * содержимого слотов — что с ними делать, эти элементы знают сами: кнопка
+ * делает из Enter и пробела клик. Правило отвечает на вопрос «чья клавиша», а
+ * не «какая», исключений нет: с кнопки очистки не работают ни стрелки, ни
+ * `Escape`. Проверка цели — здесь, а не в `TListNavigationPlugin`: база общая
+ * с ListBox, у которого фокус на самом списке.
+ *
+ * Набор по первым буквам — правило, общее с меню (`TTypeahead`,
+ * `list/typeahead.ts`): следующая за подсвеченной опция на набранное, повтор
+ * буквы — по опциям на неё, без совпадения подсветка на месте. Набор живёт,
+ * пока открыта панель: закрытие начинает следующий заново, как у меню.
+ *
+ * Прокрутки здесь нет: к подсвеченной опции и к выбранной список докручивает
+ * `TListScrollPlugin` — тот же, что у ListBox и меню, — по событию подсветки
+ * этого плагина (`change:highlight`) и по смене выбора.
+ *
+ * **В окне** (обёртка `Virtual`) клавиши ходят по всем показанным опциям, а
+ * подсветка, уведённая к опции вне окна, закрепляет её в рисовании (база).
+ * Своего `id` у такой опции нет, пока окно её не нарисует: ссылка
+ * `aria-activedescendant` ждёт, когда опция войдёт в документ
+ * (`onHighlightedMounted`), — ссылка в пустоту оставила бы скринридер немым.
+ */
+export declare class TSelectKeyboardPlugin extends TListNavigationPlugin<TSelectKeyboardPluginEvents, ISelectItem> implements ISelectKeyboardHost {
+    private _owner;
+    /** `<input>` поля — единственный источник клавиш комбобокса. */
+    private _input;
+    private _strategy;
+    /** Набор по первым буквам; паузу набора задают опции установки. */
+    private _typeahead;
+    install(ctx: IPluginContext, options?: ISelectKeyboardPluginOptions): void;
+    destroy(): void;
+    /** Стратегия по режиму `editable` — выбор класса, а не проверка внутри. */
+    private _syncStrategy;
+    /**
+     * Подсветка сама по открытию не появляется — только по клавиатуре (см.
+     * `highlightSelected`, вызываемый из стратегий). Но раз подсветка может
+     * быть выставлена, а выдача — сузиться под отбором (`filter.query`),
+     * откуда бы он ни пришёл — из ввода в поле или из кода, — нужно следить,
+     * чтобы она не осталась на опции, которой на экране больше нет. Тогда
+     * `Enter` выбрал бы скрытое, а `aria-activedescendant` указывал бы в
+     * пустоту, поэтому подсветка переезжает на первую из оставшихся.
+     *
+     * Чинит это сам плагин, а не тот, кто поменял отбор: подсветка — его
+     * состояние, и знать о ней отбору незачем.
+     */
+    protected onEngineBound(engine: TCollectionEngine<any, any>): void;
+    /** Видимая подсветка сменилась — ссылка поля за ней. */
+    protected onHighlightChanged(_uid: string | number | null): void;
+    /**
+     * Подсвеченная опция вошла в документ: окно дорисовало её уже после
+     * подсветки. Теперь у неё есть `id` этого монтирования — на него ссылка.
+     */
+    protected onHighlightedMounted(_uid: string | number): void;
+    /**
+     * Набор подсвеченной опции сменился — с ним мог смениться её `id` (`id`
+     * опции в `TIdPlugin` задали, сменили или сняли): ссылка поля за ним. Подсветка та
+     * же, и прокручивать к опции снова незачем.
+     */
+    protected onHighlightedAriaChanged(_uid: string | number): void;
+    /**
+     * `aria-activedescendant` поля — на `id` подсвеченной опции, пока она в
+     * документе (`highlightedId` базы): фокус у комбобокса на поле. Опция вне
+     * окна своего `id` не имеет, а оставшийся от прошлого монтирования указывал
+     * бы в пустоту — тогда ссылки нет, пока окно опцию не нарисует
+     * (`onHighlightedMounted`). `id` опции пишет `TOptionIdsPlugin`.
+     */
+    private _refer;
+    protected onKeyDown(e: KeyboardEvent): void;
+    navigate(step: number): void;
+    jumpTo(edge: TListEdge): void;
+    chooseHighlighted(): void;
+    /**
+     * Буква набора по первым буквам: подсветка — на опцию, которую нашёл
+     * набор, а нет такой — остаётся на месте. Подсветки нет (панель открыла
+     * эта же буква) — поиск с первой опции.
+     */
+    typeaheadTo(char: string): void;
+    emitClosedEscape(): void;
+    /**
+     * Подсветка встаёт на выбранную опцию — иначе на первую.
+     *
+     * Публичный метод: стратегии зовут его из закрытия и навигации, а
+     * `TEditablePlugin` — при первом открытии панели набором фильтра
+     * (`editableMode: 'filter'`), где своей клавиатурной подсказки нет. Клик и
+     * любое другое открытие без явного участника подсветку не ставят.
+     */
+    highlightSelected(): void;
+    /**
+     * Подсветить первую опцию, в чьём тексте есть `needle` — в любом месте и
+     * без учёта регистра. Пустая строка и текст без совпадения снимают
+     * подсветку.
+     *
+     * Так ищет ввод в поле в режиме `search` (`TEditablePlugin`) — как отбор в
+     * режиме `filter`. Подсветка и `aria-activedescendant` и для ввода
+     * остаются здесь, в одной точке.
+     *
+     * Набор по первым буквам сюда не ходит: у него свои правила —
+     * `typeaheadTo`.
+     */
+    highlightByText(needle: string): void;
+}

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

@@ -0,0 +1,205 @@
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { fieldOf } from "../../input/field.js";
+import { TListNavigationPlugin } from "../../list/navigation/navigation.plugin.js";
+import { TTypeahead, itemText } from "../../list/typeahead.js";
+import { TSelectOnlyKeyboardStrategy } from "./strategies/select-only.strategy.js";
+import { TEditableKeyboardStrategy } from "./strategies/editable.strategy.js";
+import { batchOf, selectOf, selectionOf } from "@soxa-ui/core";
+//#region src/custom/select/keyboard/keyboard.plugin.ts
+/**
+* TSelectKeyboardPlugin — клавиатура поля выбора по паттерну APG Combobox.
+*
+* Общая механика — подписка на `keydown`, привязка к коллекции, учёт
+* подсветки, циклический сдвиг, пропуск недоступных опций — в
+* `TListNavigationPlugin`. Что делают конкретные клавиши, решает выбранная
+* стратегия (`strategies/`):
+* `TSelectOnlyKeyboardStrategy` и `TEditableKeyboardStrategy` — обе поверх
+* общей части `TSelectKeyboardStrategy`. Плагин сам не проверяет
+* `owner.editable` нигде — режим выражен подпиской на `change:editable`,
+* которая переключает стратегию, а не веткой внутри обработчика.
+*
+* Ключевое свойство паттерна: **DOM-фокус никогда не уходит с поля**. Поэтому
+* `keydown` слушается на корне Select, а не на списке, и панель может быть
+* телепортирована куда угодно — на навигацию это не влияет. Подсветку для
+* скринридера передаёт `aria-activedescendant` на поле.
+*
+* Слушатель висит на корне, но клавишу комбобокс берёт только с `<input>`
+* поля. До корня всплывают и клавиши кнопки очистки, крестиков тегов и
+* содержимого слотов — что с ними делать, эти элементы знают сами: кнопка
+* делает из Enter и пробела клик. Правило отвечает на вопрос «чья клавиша», а
+* не «какая», исключений нет: с кнопки очистки не работают ни стрелки, ни
+* `Escape`. Проверка цели — здесь, а не в `TListNavigationPlugin`: база общая
+* с ListBox, у которого фокус на самом списке.
+*
+* Набор по первым буквам — правило, общее с меню (`TTypeahead`,
+* `list/typeahead.ts`): следующая за подсвеченной опция на набранное, повтор
+* буквы — по опциям на неё, без совпадения подсветка на месте. Набор живёт,
+* пока открыта панель: закрытие начинает следующий заново, как у меню.
+*
+* Прокрутки здесь нет: к подсвеченной опции и к выбранной список докручивает
+* `TListScrollPlugin` — тот же, что у ListBox и меню, — по событию подсветки
+* этого плагина (`change:highlight`) и по смене выбора.
+*
+* **В окне** (обёртка `Virtual`) клавиши ходят по всем показанным опциям, а
+* подсветка, уведённая к опции вне окна, закрепляет её в рисовании (база).
+* Своего `id` у такой опции нет, пока окно её не нарисует: ссылка
+* `aria-activedescendant` ждёт, когда опция войдёт в документ
+* (`onHighlightedMounted`), — ссылка в пустоту оставила бы скринридер немым.
+*/
+var TSelectKeyboardPlugin = class extends TListNavigationPlugin {
+	_owner = null;
+	/** `<input>` поля — единственный источник клавиш комбобокса. */
+	_input = null;
+	_strategy = new TSelectOnlyKeyboardStrategy();
+	/** Набор по первым буквам; паузу набора задают опции установки. */
+	_typeahead = new TTypeahead();
+	install(ctx, options) {
+		super.install(ctx, options);
+		this._typeahead = new TTypeahead(options?.typeaheadTimeout);
+		this._owner = ctx.getInstance() ?? null;
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => {
+			const field = fieldOf(element);
+			this._input = field instanceof HTMLInputElement ? field : null;
+		});
+		elementPlugin?.events.on("removed", () => {
+			this._input = null;
+		});
+		this._syncStrategy();
+		this._listenTo(this._owner?.events, "change:editable", () => this._syncStrategy());
+		this._listenTo(this._owner?.events, "close", () => {
+			this._typeahead.reset();
+			this.clearHighlight();
+		});
+	}
+	destroy() {
+		super.destroy();
+		this._owner = null;
+		this._input = null;
+	}
+	/** Стратегия по режиму `editable` — выбор класса, а не проверка внутри. */
+	_syncStrategy() {
+		this._strategy = this._owner?.editable ? new TEditableKeyboardStrategy() : new TSelectOnlyKeyboardStrategy();
+	}
+	/**
+	* Подсветка сама по открытию не появляется — только по клавиатуре (см.
+	* `highlightSelected`, вызываемый из стратегий). Но раз подсветка может
+	* быть выставлена, а выдача — сузиться под отбором (`filter.query`),
+	* откуда бы он ни пришёл — из ввода в поле или из кода, — нужно следить,
+	* чтобы она не осталась на опции, которой на экране больше нет. Тогда
+	* `Enter` выбрал бы скрытое, а `aria-activedescendant` указывал бы в
+	* пустоту, поэтому подсветка переезжает на первую из оставшихся.
+	*
+	* Чинит это сам плагин, а не тот, кто поменял отбор: подсветка — его
+	* состояние, и знать о ней отбору незачем.
+	*/
+	onEngineBound(engine) {
+		this._listenTo(batchOf(engine)?.events, "change:shown", () => {
+			if (this._highlightedUid == null) return;
+			if (this.indexOf(this._highlightedUid) !== -1) return;
+			const first = this.items()[0];
+			if (first) this.highlight(first.uid);
+			else this.clearHighlight();
+		});
+	}
+	/** Видимая подсветка сменилась — ссылка поля за ней. */
+	onHighlightChanged(_uid) {
+		this._refer();
+	}
+	/**
+	* Подсвеченная опция вошла в документ: окно дорисовало её уже после
+	* подсветки. Теперь у неё есть `id` этого монтирования — на него ссылка.
+	*/
+	onHighlightedMounted(_uid) {
+		this._refer();
+	}
+	/**
+	* Набор подсвеченной опции сменился — с ним мог смениться её `id` (`id`
+	* опции в `TIdPlugin` задали, сменили или сняли): ссылка поля за ним. Подсветка та
+	* же, и прокручивать к опции снова незачем.
+	*/
+	onHighlightedAriaChanged(_uid) {
+		this._refer();
+	}
+	/**
+	* `aria-activedescendant` поля — на `id` подсвеченной опции, пока она в
+	* документе (`highlightedId` базы): фокус у комбобокса на поле. Опция вне
+	* окна своего `id` не имеет, а оставшийся от прошлого монтирования указывал
+	* бы в пустоту — тогда ссылки нет, пока окно опцию не нарисует
+	* (`onHighlightedMounted`). `id` опции пишет `TOptionIdsPlugin`.
+	*/
+	_refer() {
+		this._owner?.field.aria.add("aria-activedescendant", this.highlightedId());
+	}
+	onKeyDown(e) {
+		if (e.target !== this._input) return;
+		const owner = this._owner;
+		if (!owner) return;
+		if (owner.open) this._strategy.handleOpen(e, owner, this);
+		else this._strategy.handleClosed(e, owner, this);
+	}
+	navigate(step) {
+		this.move(step);
+	}
+	jumpTo(edge) {
+		this.highlightEdge(edge);
+	}
+	chooseHighlighted() {
+		if (this._highlightedUid == null) return;
+		const item = this.itemByUid(this._highlightedUid);
+		if (item) selectOf(this._engine)?.chooseItem(item);
+	}
+	/**
+	* Буква набора по первым буквам: подсветка — на опцию, которую нашёл
+	* набор, а нет такой — остаётся на месте. Подсветки нет (панель открыла
+	* эта же буква) — поиск с первой опции.
+	*/
+	typeaheadTo(char) {
+		const current = this._highlightedUid == null ? null : this.itemByUid(this._highlightedUid);
+		const match = this._typeahead.next(char, this.items(), current, itemText);
+		if (match) this.highlight(match.uid);
+	}
+	emitClosedEscape() {
+		this.events.emit("escape");
+	}
+	/**
+	* Подсветка встаёт на выбранную опцию — иначе на первую.
+	*
+	* Публичный метод: стратегии зовут его из закрытия и навигации, а
+	* `TEditablePlugin` — при первом открытии панели набором фильтра
+	* (`editableMode: 'filter'`), где своей клавиатурной подсказки нет. Клик и
+	* любое другое открытие без явного участника подсветку не ставят.
+	*/
+	highlightSelected() {
+		const [selected] = selectionOf(this._engine)?.selected ?? [];
+		if (selected && this.indexOf(selected.uid) !== -1) {
+			this.highlight(selected.uid);
+			return;
+		}
+		this.highlightEdge("first");
+	}
+	/**
+	* Подсветить первую опцию, в чьём тексте есть `needle` — в любом месте и
+	* без учёта регистра. Пустая строка и текст без совпадения снимают
+	* подсветку.
+	*
+	* Так ищет ввод в поле в режиме `search` (`TEditablePlugin`) — как отбор в
+	* режиме `filter`. Подсветка и `aria-activedescendant` и для ввода
+	* остаются здесь, в одной точке.
+	*
+	* Набор по первым буквам сюда не ходит: у него свои правила —
+	* `typeaheadTo`.
+	*/
+	highlightByText(needle) {
+		if (!needle) {
+			this.clearHighlight();
+			return;
+		}
+		const lower = needle.toLowerCase();
+		const match = this.items().find((item) => itemText(item).toLowerCase().includes(lower));
+		if (match) this.highlight(match.uid);
+		else this.clearHighlight();
+	}
+};
+//#endregion
+export { TSelectKeyboardPlugin };

package/dist/custom/select/keyboard/strategies/base.strategy.d.ts

@@ -0,0 +1,37 @@
+import type { ISelect } from '@soxa-ui/core';
+import type { ISelectKeyboardHost, ISelectKeyboardStrategy } from './types';
+/**
+ * TSelectKeyboardStrategy — общая часть клавиатурной модели Select, одна на
+ * оба режима `editable`.
+ *
+ * Здесь то, что не зависит от режима: открытие стрелками/Enter, жест
+ * `Alt+↓`/`Alt+↑` из APG, навигация и закрытие открытой панели. Что
+ * добавляется поверх — решают `_extraClosed`/`_extraOpen` наследника
+ * (`TSelectOnlyKeyboardStrategy`, `TEditableKeyboardStrategy`): режим выражен
+ * выбором класса, а не `if (owner.editable)` внутри общего метода.
+ */
+export declare abstract class TSelectKeyboardStrategy implements ISelectKeyboardStrategy {
+    handleClosed(e: KeyboardEvent, owner: ISelect, host: ISelectKeyboardHost): void;
+    handleOpen(e: KeyboardEvent, owner: ISelect, host: ISelectKeyboardHost): void;
+    /** Что режим добавляет к закрытой панели — Home/End/пробел/набор по буквам. */
+    protected abstract _extraClosed(e: KeyboardEvent, owner: ISelect, host: ISelectKeyboardHost): void;
+    /** Что режим добавляет к открытой панели. */
+    protected abstract _extraOpen(e: KeyboardEvent, owner: ISelect, host: ISelectKeyboardHost): void;
+    /**
+     * `Alt+↓` открывает закрытую панель без подсветки — жест APG, одинаковый
+     * в обоих режимах.
+     */
+    private _altOpen;
+    /**
+     * `ArrowDown`/`ArrowUp`/`Enter` открывают закрытую панель. `↑` встаёт на
+     * последнюю опцию — так пользователь попадает в конец списка одним
+     * нажатием, остальные — на выбранную или на первую.
+     */
+    private _openCommon;
+    /**
+     * Открытая панель: стрелки двигают подсветку, `Enter` выбирает,
+     * `Escape`/`Tab` закрывают. `Alt+↑` — второй APG-жест: выбирает
+     * подсвеченное и закрывает, тем же движением, что и `Enter`.
+     */
+    private _navigateOpen;
+}

package/dist/custom/select/keyboard/strategies/base.strategy.js

@@ -0,0 +1,81 @@
+//#region src/custom/select/keyboard/strategies/base.strategy.ts
+/**
+* TSelectKeyboardStrategy — общая часть клавиатурной модели Select, одна на
+* оба режима `editable`.
+*
+* Здесь то, что не зависит от режима: открытие стрелками/Enter, жест
+* `Alt+↓`/`Alt+↑` из APG, навигация и закрытие открытой панели. Что
+* добавляется поверх — решают `_extraClosed`/`_extraOpen` наследника
+* (`TSelectOnlyKeyboardStrategy`, `TEditableKeyboardStrategy`): режим выражен
+* выбором класса, а не `if (owner.editable)` внутри общего метода.
+*/
+var TSelectKeyboardStrategy = class {
+	handleClosed(e, owner, host) {
+		if (!owner.openable) return;
+		if (this._altOpen(e, owner)) return;
+		if (this._openCommon(e, owner, host)) return;
+		this._extraClosed(e, owner, host);
+	}
+	handleOpen(e, owner, host) {
+		if (this._navigateOpen(e, owner, host)) return;
+		this._extraOpen(e, owner, host);
+	}
+	/**
+	* `Alt+↓` открывает закрытую панель без подсветки — жест APG, одинаковый
+	* в обоих режимах.
+	*/
+	_altOpen(e, owner) {
+		if (!e.altKey || e.key !== "ArrowDown") return false;
+		e.preventDefault();
+		owner.open = true;
+		return true;
+	}
+	/**
+	* `ArrowDown`/`ArrowUp`/`Enter` открывают закрытую панель. `↑` встаёт на
+	* последнюю опцию — так пользователь попадает в конец списка одним
+	* нажатием, остальные — на выбранную или на первую.
+	*/
+	_openCommon(e, owner, host) {
+		if (e.key !== "ArrowDown" && e.key !== "ArrowUp" && e.key !== "Enter") return false;
+		e.preventDefault();
+		owner.open = true;
+		if (e.key === "ArrowUp") host.jumpTo("last");
+		else host.highlightSelected();
+		return true;
+	}
+	/**
+	* Открытая панель: стрелки двигают подсветку, `Enter` выбирает,
+	* `Escape`/`Tab` закрывают. `Alt+↑` — второй APG-жест: выбирает
+	* подсвеченное и закрывает, тем же движением, что и `Enter`.
+	*/
+	_navigateOpen(e, owner, host) {
+		switch (e.key) {
+			case "ArrowDown":
+				e.preventDefault();
+				if (host.highlightedUid == null) host.highlightSelected();
+				else host.navigate(1);
+				return true;
+			case "ArrowUp":
+				e.preventDefault();
+				if (e.altKey) {
+					host.chooseHighlighted();
+					owner.open = false;
+				} else host.navigate(-1);
+				return true;
+			case "Enter":
+				e.preventDefault();
+				host.chooseHighlighted();
+				return true;
+			case "Escape":
+				e.preventDefault();
+				owner.open = false;
+				return true;
+			case "Tab":
+				owner.open = false;
+				return true;
+		}
+		return false;
+	}
+};
+//#endregion
+export { TSelectKeyboardStrategy };

package/dist/custom/select/keyboard/strategies/editable.strategy.d.ts

@@ -0,0 +1,16 @@
+import type { ISelect } from '@soxa-ui/core';
+import { TSelectKeyboardStrategy } from './base.strategy';
+import type { ISelectKeyboardHost } from './types';
+/**
+ * TEditableKeyboardStrategy — клавиатура `editable` поверх общей части.
+ *
+ * `Home`/`End`, пробел и печатные символы не перехватываются вовсе — они
+ * принадлежат тексту поля. Единственное добавление — `Escape` на уже
+ * закрытой панели: сам он ничего не открывает и не выбирает, а сообщает
+ * событием, что дальше решает `TEditablePlugin` (двойной Escape и возврат
+ * текста, см. `AGENTS.md`).
+ */
+export declare class TEditableKeyboardStrategy extends TSelectKeyboardStrategy {
+    protected _extraClosed(e: KeyboardEvent, _owner: ISelect, host: ISelectKeyboardHost): void;
+    protected _extraOpen(): void;
+}

package/dist/custom/select/keyboard/strategies/editable.strategy.js

@@ -0,0 +1,20 @@
+import { TSelectKeyboardStrategy } from "./base.strategy.js";
+//#region src/custom/select/keyboard/strategies/editable.strategy.ts
+/**
+* TEditableKeyboardStrategy — клавиатура `editable` поверх общей части.
+*
+* `Home`/`End`, пробел и печатные символы не перехватываются вовсе — они
+* принадлежат тексту поля. Единственное добавление — `Escape` на уже
+* закрытой панели: сам он ничего не открывает и не выбирает, а сообщает
+* событием, что дальше решает `TEditablePlugin` (двойной Escape и возврат
+* текста, см. `AGENTS.md`).
+*/
+var TEditableKeyboardStrategy = class extends TSelectKeyboardStrategy {
+	_extraClosed(e, _owner, host) {
+		if (e.key !== "Escape") return;
+		host.emitClosedEscape();
+	}
+	_extraOpen() {}
+};
+//#endregion
+export { TEditableKeyboardStrategy };

package/dist/custom/select/keyboard/strategies/index.d.ts

@@ -0,0 +1,4 @@
+export { TSelectKeyboardStrategy } from './base.strategy';
+export { TSelectOnlyKeyboardStrategy } from './select-only.strategy';
+export { TEditableKeyboardStrategy } from './editable.strategy';
+export type { ISelectKeyboardHost, ISelectKeyboardStrategy } from './types';

package/dist/custom/select/keyboard/strategies/select-only.strategy.d.ts

@@ -0,0 +1,13 @@
+import type { ISelect } from '@soxa-ui/core';
+import { TSelectKeyboardStrategy } from './base.strategy';
+import type { ISelectKeyboardHost } from './types';
+/**
+ * TSelectOnlyKeyboardStrategy — клавиатура select-only поверх общей части.
+ *
+ * Добавляет то, что в `editable` принадлежит тексту поля: `Home`/`End`,
+ * пробел и набор по буквам.
+ */
+export declare class TSelectOnlyKeyboardStrategy extends TSelectKeyboardStrategy {
+    protected _extraClosed(e: KeyboardEvent, owner: ISelect, host: ISelectKeyboardHost): void;
+    protected _extraOpen(e: KeyboardEvent, _owner: ISelect, host: ISelectKeyboardHost): void;
+}

package/dist/custom/select/keyboard/strategies/select-only.strategy.js

@@ -0,0 +1,59 @@
+import { isPrintableKey } from "../../../../utils/isPrintableKey.js";
+import { TSelectKeyboardStrategy } from "./base.strategy.js";
+//#region src/custom/select/keyboard/strategies/select-only.strategy.ts
+/**
+* TSelectOnlyKeyboardStrategy — клавиатура select-only поверх общей части.
+*
+* Добавляет то, что в `editable` принадлежит тексту поля: `Home`/`End`,
+* пробел и набор по буквам.
+*/
+var TSelectOnlyKeyboardStrategy = class extends TSelectKeyboardStrategy {
+	_extraClosed(e, owner, host) {
+		if (e.key === "Home") {
+			e.preventDefault();
+			owner.open = true;
+			host.jumpTo("first");
+			return;
+		}
+		if (e.key === "End") {
+			e.preventDefault();
+			owner.open = true;
+			host.jumpTo("last");
+			return;
+		}
+		if (e.key === " ") {
+			e.preventDefault();
+			owner.open = true;
+			host.highlightSelected();
+			return;
+		}
+		if (isPrintableKey(e)) {
+			e.preventDefault();
+			owner.open = true;
+			host.typeaheadTo(e.key);
+		}
+	}
+	_extraOpen(e, _owner, host) {
+		if (e.key === "Home") {
+			e.preventDefault();
+			host.jumpTo("first");
+			return;
+		}
+		if (e.key === "End") {
+			e.preventDefault();
+			host.jumpTo("last");
+			return;
+		}
+		if (e.key === " ") {
+			e.preventDefault();
+			host.chooseHighlighted();
+			return;
+		}
+		if (isPrintableKey(e)) {
+			e.preventDefault();
+			host.typeaheadTo(e.key);
+		}
+	}
+};
+//#endregion
+export { TSelectOnlyKeyboardStrategy };

package/dist/custom/select/keyboard/strategies/types.d.ts

@@ -0,0 +1,29 @@
+import type { ISelect } from '@soxa-ui/core';
+import type { TListEdge } from '../../../list/navigation';
+/**
+ * Срез клавиатурного плагина, который видят стратегии — не весь его API.
+ *
+ * Имена намеренно не совпадают с внутренними методами `TSelectKeyboardPlugin`
+ * (`move`, `highlightEdge`, …): стратегии — публичный контракт плагина для
+ * посторонних классов, а не доступ к его защищённым внутренностям.
+ */
+export interface ISelectKeyboardHost {
+    readonly highlightedUid: string | number | null;
+    /** Сдвинуть подсветку на `step` с цикличным переходом через край. */
+    navigate(step: number): void;
+    /** Поставить подсветку на край списка. */
+    jumpTo(edge: TListEdge): void;
+    /** Подсветка на выбранную опцию — иначе на первую. */
+    highlightSelected(): void;
+    /** Выбрать подсвеченную опцию. */
+    chooseHighlighted(): void;
+    /** Буква набора по первым буквам: подсветка — на найденную опцию, нет такой — на месте. */
+    typeaheadTo(char: string): void;
+    /** Escape нажат на уже закрытой панели — сигнал `TEditablePlugin`. */
+    emitClosedEscape(): void;
+}
+/** Клавиатурная модель для одного режима `editable`. */
+export interface ISelectKeyboardStrategy {
+    handleClosed(e: KeyboardEvent, owner: ISelect, host: ISelectKeyboardHost): void;
+    handleOpen(e: KeyboardEvent, owner: ISelect, host: ISelectKeyboardHost): void;
+}

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

@@ -0,0 +1,18 @@
+import type { TListNavigationPluginEvents } from '../../list/navigation';
+export interface ISelectKeyboardPluginOptions {
+    /**
+     * Пауза набора по первым буквам, мс; по умолчанию 500, как у меню.
+     *
+     * Буквы, набранные быстрее неё, — одно слово: «мо» находит «Москва».
+     * После паузы следующая буква начинает набор заново.
+     */
+    typeaheadTimeout?: number;
+}
+export type TSelectKeyboardPluginEvents = TListNavigationPluginEvents & {
+    /**
+     * `Escape` нажат на уже закрытой панели — только в `editable`. Сам плагин
+     * ничего не делает: слушает `TEditablePlugin` (двойной Escape и возврат
+     * текста).
+     */
+    escape: () => void;
+};

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

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