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

package/dist/custom/input-control/input-control.plugin.d.ts

@@ -0,0 +1,12 @@
+import { TBasePlugin } from '../../base';
+import type { IPluginContext } from '../../base';
+import type { TInputControlPluginEvents } from './types';
+export declare class TInputControlPlugin extends TBasePlugin<any, TInputControlPluginEvents> {
+    private _input;
+    private _instance;
+    private _onClick;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    private _handleClick;
+    private _removeClickListener;
+}

package/dist/custom/input-control/input-control.plugin.js

@@ -0,0 +1,40 @@
+import { TBasePlugin } from "../../base/base.class.js";
+import { TElementPlugin } from "../element/element.plugin.js";
+import { fieldOf } from "../input/field.js";
+//#region src/custom/input-control/input-control.plugin.ts
+var TInputControlPlugin = class extends TBasePlugin {
+	_input = null;
+	_instance = null;
+	_onClick = this._handleClick.bind(this);
+	install(ctx) {
+		super.install(ctx);
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", () => {
+			const el = elementPlugin.element;
+			if (!el) return;
+			const input = fieldOf(el);
+			if (!(input instanceof HTMLInputElement)) return;
+			this._input = input;
+			input.addEventListener("click", this._onClick);
+		});
+		elementPlugin?.events.on("removed", () => {
+			this._removeClickListener();
+			this._input = null;
+		});
+		this._instance = ctx.getInstance();
+	}
+	destroy() {
+		this._removeClickListener();
+		this._input = null;
+		this._instance = null;
+		super.destroy();
+	}
+	_handleClick(event) {
+		if (this._instance?.readonly || this._input?.disabled) event.preventDefault();
+	}
+	_removeClickListener() {
+		if (this._input) this._input.removeEventListener("click", this._onClick);
+	}
+};
+//#endregion
+export { TInputControlPlugin };

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

@@ -0,0 +1,2 @@
+import type { TPluginEvents } from '../../base';
+export type TInputControlPluginEvents = TPluginEvents;

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

@@ -0,0 +1,19 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TItemGroupIdsPlugin — имя группы элементов от её подписи: у групп меню,
+ * ListBox и Select (`Menu.Group`, `ListBox.Group`, `Select.Group`) — один на
+ * все три, формула связки у них одна.
+ *
+ * `id` подписи — в её набор (`labelAria`), ссылка на него — `aria-labelledby`
+ * группы, пока подпись не пуста: без подписи разметка её не рисует, и ссылка
+ * указывала бы в пустоту. Пишется при установке, синхронно, и на смену
+ * подписи — связка есть уже в первой (и серверной) отрисовке. `id` — от
+ * монтирования (`createId`): он нужен только документу.
+ *
+ * Шина группы бывает долговечнее плагина — приложение передаёт свой `ctrl`,
+ * — поэтому подписка через `_listenTo`.
+ */
+export declare class TItemGroupIdsPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

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

@@ -0,0 +1,32 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+//#region src/custom/item-group/ids/ids.plugin.ts
+/**
+* TItemGroupIdsPlugin — имя группы элементов от её подписи: у групп меню,
+* ListBox и Select (`Menu.Group`, `ListBox.Group`, `Select.Group`) — один на
+* все три, формула связки у них одна.
+*
+* `id` подписи — в её набор (`labelAria`), ссылка на него — `aria-labelledby`
+* группы, пока подпись не пуста: без подписи разметка её не рисует, и ссылка
+* указывала бы в пустоту. Пишется при установке, синхронно, и на смену
+* подписи — связка есть уже в первой (и серверной) отрисовке. `id` — от
+* монтирования (`createId`): он нужен только документу.
+*
+* Шина группы бывает долговечнее плагина — приложение передаёт свой `ctrl`,
+* — поэтому подписка через `_listenTo`.
+*/
+var TItemGroupIdsPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const group = ctx.getInstance();
+		if (!group) return;
+		const labelId = ctx.createId("label");
+		group.labelAria.add("id", labelId);
+		const refer = () => {
+			group.aria.add("aria-labelledby", group.label ? labelId : null);
+		};
+		refer();
+		this._listenTo(group.events, "change:label", refer);
+	}
+};
+//#endregion
+export { TItemGroupIdsPlugin };

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

@@ -0,0 +1 @@
+export { TItemGroupIdsPlugin } from './ids.plugin';

package/dist/custom/item-group/index.d.ts

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

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

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

package/dist/custom/label/nested-warn/index.d.ts

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

package/dist/custom/label/nested-warn/nested-warn.plugin.d.ts

@@ -0,0 +1,21 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+/**
+ * TLabelNestedWarnPlugin — предупреждает, если внутри корня-`label` подписи
+ * `Label` оказался другой `label`.
+ *
+ * HTML запрещает `label` внутри `label`. Верный знак такой ошибки — радио,
+ * положенное в подпись без `tag="span"`: корень `RadioGroup.Item` — тоже
+ * `label`. Разметка при этом выглядит правильно, поэтому без предупреждения
+ * ошибку видно только валидатором.
+ *
+ * Диагностика, не защита: исключение не бросаем. Корень подписи — не `label`
+ * (задан другой `tag`) — вкладывать нечего, проверка молчит.
+ *
+ * Узел берётся у `TElementPlugin` из общего bundle: сразу, если элемент уже
+ * есть, иначе по событию `ready`. К `ready` контрол из слота уже в DOM. До
+ * монтирования (в т.ч. SSR) узла нет — проверка молчит.
+ */
+export declare class TLabelNestedWarnPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

package/dist/custom/label/nested-warn/nested-warn.plugin.js

@@ -0,0 +1,41 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+//#region src/custom/label/nested-warn/nested-warn.plugin.ts
+/**
+* TLabelNestedWarnPlugin — предупреждает, если внутри корня-`label` подписи
+* `Label` оказался другой `label`.
+*
+* HTML запрещает `label` внутри `label`. Верный знак такой ошибки — радио,
+* положенное в подпись без `tag="span"`: корень `RadioGroup.Item` — тоже
+* `label`. Разметка при этом выглядит правильно, поэтому без предупреждения
+* ошибку видно только валидатором.
+*
+* Диагностика, не защита: исключение не бросаем. Корень подписи — не `label`
+* (задан другой `tag`) — вкладывать нечего, проверка молчит.
+*
+* Узел берётся у `TElementPlugin` из общего bundle: сразу, если элемент уже
+* есть, иначе по событию `ready`. К `ready` контрол из слота уже в DOM. До
+* монтирования (в т.ч. SSR) узла нет — проверка молчит.
+*/
+var TLabelNestedWarnPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const elementPlugin = ctx.get(TElementPlugin);
+		if (!elementPlugin) return;
+		const check = (el) => {
+			if (!el || el.localName !== "label" || !el.querySelector("label")) return;
+			console.warn("[soxa] Label: внутри подписи оказался ещё один <label> — HTML запрещает вкладывать их друг в друга. Корень RadioGroup.Item — <label>: внутри Label рисуйте его с tag=\"span\".");
+		};
+		if (elementPlugin.element) {
+			check(elementPlugin.element);
+			return;
+		}
+		const onReady = (el) => {
+			elementPlugin.events.off("ready", onReady);
+			check(el);
+		};
+		elementPlugin.events.on("ready", onReady);
+	}
+};
+//#endregion
+export { TLabelNestedWarnPlugin };

package/dist/custom/list/height/height.plugin.d.ts

@@ -0,0 +1,129 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TListHeightPluginEvents } from './types';
+/**
+ * TListHeightPlugin — высота контейнера списка по `maxRows`.
+ *
+ * Единственное списочное свойство, которому нужен плагин. `contentFit` ядро
+ * применяет само (`data-*`), `scrollBehavior` только читают — а `maxRows`
+ * требует измерений: высоту строк без DOM не узнать. Ради этого здесь и живут
+ * `ResizeObserver`ы.
+ *
+ * Оба наблюдателя — за корнем и за каждой строкой — смотрят border-box:
+ * наблюдать надо ровно то, что меряем, а строки меряются `offsetHeight`.
+ * Умолчание `content-box` пропустило бы смену одного паддинга или рамки
+ * строки (паддинг по размеру, толщина рамки по состоянию): content-box строки
+ * от неё не меняется, а контейнер, уже зажатый `max-height`, не меняется
+ * вовсе. Предел держался бы по старой высоте строк до ближайшего пересчёта по
+ * другой причине.
+ *
+ * Само свойство лежит на инстансе (`IList`), плагин его читает и подписан на
+ * `change:maxRows`. Так устроены и остальные плагины пакета: свойство —
+ * ядру, применение — плагину.
+ *
+ * Строки считаются по показанным элементам коллекции (`batch.shown`), а не по
+ * узлам в документе: в окне (обёртка `Virtual`) нарисованы только видимые, и
+ * их число и порядок не говорят ни сколько строк в списке, ни нужна ли
+ * прокрутка. Высоту строки дают нарисованные: показанный, но не нарисованный
+ * элемент — той же высоты, высота строк в окне одна на все.
+ *
+ * **Строки в группах** (`ListBox.Group`, `Select.Group`) — не дети
+ * контейнера, а между ними стоят подписи групп и разделители, и суммой высот
+ * строк предел не сосчитать. Тогда он — по месту последней из первых строк:
+ * от верха содержимого списка до её низа, с подписью первой группы и всем, что
+ * между строками. Окна у списка с группами нет — нарисованы все строки, и
+ * место есть у каждой.
+ *
+ * **Строки измерены** (`measured`) — у нарисованной строки есть высота. У
+ * скрытого списка — закрытой панели Select, ListBox в скрытой вкладке или
+ * поповере — её нет: предел из нулевых высот — не предел строк, и плагин не
+ * пишет ничего, а прежний предел остаётся до замера. Показ списка плагин
+ * узнаёт от наблюдателя строк и мерит их кадром позже, тогда же пишет предел.
+ * Признак считается на каждом пересчёте, при любом `maxRows`, и о смене плагин
+ * сообщает `change:measured` — после записи предела. Слушает его прокрутка
+ * списка (`TListScrollPlugin`): к элементу скрытого списка она крутит, когда
+ * строки измерятся, — уже в пределе строк. Событие — соседу по набору, в
+ * дескриптор оно не публикуется. Без узла корня строки не мерятся, и признак —
+ * по последнему замеру: следующий `ready` мерит заново.
+ *
+ * **Пересчёт на кадр — только при узле корня**: между `ready` и `removed`
+ * своего `TElementPlugin`. Сборка вместе с подписками плагина идёт и на
+ * сервере, и состав, `maxRows` и строки меняются уже тогда, а узла там нет,
+ * как нет и `requestAnimationFrame`. Без узла мерить нечего, и повод кадра не
+ * планирует: всё, что сменилось до узла, применяет `ready` — предел он ставит
+ * сразу. Кадр, запланированный до `removed`, без узла ничего не мерит.
+ */
+export declare class TListHeightPlugin extends TBasePlugin<any, TListHeightPluginEvents> {
+    private _element;
+    private _list;
+    private _engine;
+    private _collectionElements;
+    private _rootObserver;
+    private readonly _itemObservers;
+    /**
+     * Узел, которому плагин ставил предел последним. Контейнер бывает и другим
+     * узлом — у списка без строк это корень, — и с прежнего предел снимается:
+     * иначе узел списка ListBox, опустев, остался бы в пределе прежних строк.
+     */
+    private _container;
+    /** Строки измерены — у нарисованной строки есть высота (`measured`). */
+    private _measured;
+    /** Пересчёт в следующем кадре; прежний отложенный отменяется. */
+    private readonly _updateNextFrame;
+    constructor();
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    /**
+     * Строки измерены: у нарисованной строки есть высота. Скрытый список, пустой
+     * и ещё не нарисованный — `false`: предел строк плагину считать не из чего
+     * (см. описание класса). Смена — `change:measured`.
+     */
+    get measured(): boolean;
+    private _observeItem;
+    private _unobserveItem;
+    /**
+     * Пересчитать предел кадром позже — пока у плагина есть узел корня. Без
+     * узла повод ничего не планирует, какой бы он ни был: всё, что сменилось до
+     * узла, пересчитает `ready`.
+     */
+    private _scheduleUpdate;
+    /**
+     * Пересчёт: предел строк и признак «строки измерены» (`measured`). О смене
+     * признака — `change:measured`, после записи предела: подписчик видит список
+     * уже в пределе строк. Кадр, пришедший без узла корня (запланирован до
+     * `removed`), ничего не мерит.
+     */
+    private _update;
+    /**
+     * Ограничивает высоту прокручиваемого контейнера по `maxRows`. `rows` — узлы
+     * показанных элементов по порядку, `null` — не нарисованный окном.
+     *
+     * Контейнер — **список, в котором стоят элементы** (`closestList`), а не
+     * корень компонента. У Select его корень — поле, а список лежит в
+     * телепортированной панели: пока плагин писал в корень, Select получал
+     * `max-height` на поле и схлопывался в полосу. У ListBox это узел списка
+     * внутри корня: шапка и подвал стоят рядом с ним и в предел строк не входят.
+     * Не родитель элемента: у элемента группы родитель — группа, и предел
+     * получила бы она.
+     */
+    private _limit;
+    /**
+     * Высота первых `count` строк вместе с промежутками между ними.
+     *
+     * Строки — дети контейнера: сумма их высот и зазоров. Строку, которую окно
+     * не нарисовало, считаем высотой нарисованной: в окне высота строк одна на
+     * все. Не нарисовано ни одной — строки ещё не измерены, и писать нечего.
+     * Последняя из первых строк стоит в группе — по её месту (`_measureByPlace`).
+     *
+     * `max-height` пишется в контейнер, а не в область строк, поэтому в неё идёт
+     * и то, что контейнер берёт сверх строк (`boxExtra`).
+     */
+    private _measure;
+    /**
+     * Высота до низа последней из первых строк по её месту — у строк в группах:
+     * от верха содержимого контейнера, с подписями групп и разделителями между
+     * строками. Верх — без прокрутки: место строки считается от начала списка, а
+     * не от того, что сейчас видно.
+     */
+    private _measureByPlace;
+}

package/dist/custom/list/height/height.plugin.js

@@ -0,0 +1,272 @@
+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 { closestList } from "../row.js";
+import { batchOf, frameDebounce } from "@soxa-ui/core";
+//#region src/custom/list/height/height.plugin.ts
+/** Снять с узла предел строк: потолок и прокрутка возвращаются теме. */
+function release(container) {
+	container.style.maxHeight = "";
+	container.style.overflowY = "";
+}
+/**
+* Строка измерена: у её узла есть высота. У строки скрытого списка — закрытой
+* панели, ListBox в скрытой обёртке — высоты нет, как и у строки без
+* layout-бокса.
+*/
+function hasHeight(row) {
+	return isMeasurableElement(row) && row.offsetHeight > 0;
+}
+/**
+* Что `max-height` контейнера берёт сверх строк: при `box-sizing: border-box`
+* — вертикальные паддинги и рамки, иначе тема, добавившая отступы, теряла бы
+* последнюю строку. При `content-box` добавлять нечего, поэтому решаем по
+* факту стиля, а не по допущению про конкретную тему.
+*/
+function boxExtra(style) {
+	if (style.boxSizing !== "border-box") return 0;
+	return (parseFloat(style.paddingTop) || 0) + (parseFloat(style.paddingBottom) || 0) + (parseFloat(style.borderTopWidth) || 0) + (parseFloat(style.borderBottomWidth) || 0);
+}
+/**
+* TListHeightPlugin — высота контейнера списка по `maxRows`.
+*
+* Единственное списочное свойство, которому нужен плагин. `contentFit` ядро
+* применяет само (`data-*`), `scrollBehavior` только читают — а `maxRows`
+* требует измерений: высоту строк без DOM не узнать. Ради этого здесь и живут
+* `ResizeObserver`ы.
+*
+* Оба наблюдателя — за корнем и за каждой строкой — смотрят border-box:
+* наблюдать надо ровно то, что меряем, а строки меряются `offsetHeight`.
+* Умолчание `content-box` пропустило бы смену одного паддинга или рамки
+* строки (паддинг по размеру, толщина рамки по состоянию): content-box строки
+* от неё не меняется, а контейнер, уже зажатый `max-height`, не меняется
+* вовсе. Предел держался бы по старой высоте строк до ближайшего пересчёта по
+* другой причине.
+*
+* Само свойство лежит на инстансе (`IList`), плагин его читает и подписан на
+* `change:maxRows`. Так устроены и остальные плагины пакета: свойство —
+* ядру, применение — плагину.
+*
+* Строки считаются по показанным элементам коллекции (`batch.shown`), а не по
+* узлам в документе: в окне (обёртка `Virtual`) нарисованы только видимые, и
+* их число и порядок не говорят ни сколько строк в списке, ни нужна ли
+* прокрутка. Высоту строки дают нарисованные: показанный, но не нарисованный
+* элемент — той же высоты, высота строк в окне одна на все.
+*
+* **Строки в группах** (`ListBox.Group`, `Select.Group`) — не дети
+* контейнера, а между ними стоят подписи групп и разделители, и суммой высот
+* строк предел не сосчитать. Тогда он — по месту последней из первых строк:
+* от верха содержимого списка до её низа, с подписью первой группы и всем, что
+* между строками. Окна у списка с группами нет — нарисованы все строки, и
+* место есть у каждой.
+*
+* **Строки измерены** (`measured`) — у нарисованной строки есть высота. У
+* скрытого списка — закрытой панели Select, ListBox в скрытой вкладке или
+* поповере — её нет: предел из нулевых высот — не предел строк, и плагин не
+* пишет ничего, а прежний предел остаётся до замера. Показ списка плагин
+* узнаёт от наблюдателя строк и мерит их кадром позже, тогда же пишет предел.
+* Признак считается на каждом пересчёте, при любом `maxRows`, и о смене плагин
+* сообщает `change:measured` — после записи предела. Слушает его прокрутка
+* списка (`TListScrollPlugin`): к элементу скрытого списка она крутит, когда
+* строки измерятся, — уже в пределе строк. Событие — соседу по набору, в
+* дескриптор оно не публикуется. Без узла корня строки не мерятся, и признак —
+* по последнему замеру: следующий `ready` мерит заново.
+*
+* **Пересчёт на кадр — только при узле корня**: между `ready` и `removed`
+* своего `TElementPlugin`. Сборка вместе с подписками плагина идёт и на
+* сервере, и состав, `maxRows` и строки меняются уже тогда, а узла там нет,
+* как нет и `requestAnimationFrame`. Без узла мерить нечего, и повод кадра не
+* планирует: всё, что сменилось до узла, применяет `ready` — предел он ставит
+* сразу. Кадр, запланированный до `removed`, без узла ничего не мерит.
+*/
+var TListHeightPlugin = class extends TBasePlugin {
+	_element = null;
+	_list = null;
+	_engine = null;
+	_collectionElements = null;
+	_rootObserver = null;
+	_itemObservers = /* @__PURE__ */ new Map();
+	/**
+	* Узел, которому плагин ставил предел последним. Контейнер бывает и другим
+	* узлом — у списка без строк это корень, — и с прежнего предел снимается:
+	* иначе узел списка ListBox, опустев, остался бы в пределе прежних строк.
+	*/
+	_container = null;
+	/** Строки измерены — у нарисованной строки есть высота (`measured`). */
+	_measured = false;
+	/** Пересчёт в следующем кадре; прежний отложенный отменяется. */
+	_updateNextFrame;
+	constructor() {
+		super();
+		this._updateNextFrame = frameDebounce(() => this._update());
+	}
+	install(ctx) {
+		super.install(ctx);
+		this._list = ctx.getInstance();
+		this._collectionElements = ctx.get(TCollectionElements) ?? null;
+		this._listenTo(this._list?.events, "change:maxRows", () => this._scheduleUpdate());
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", (element) => {
+			this._element = element;
+			this._rootObserver?.disconnect();
+			this._rootObserver = new ResizeObserver(() => this._scheduleUpdate());
+			this._rootObserver.observe(element, { box: "border-box" });
+			this._update();
+		});
+		elementPlugin?.events.on("removed", () => {
+			this._rootObserver?.disconnect();
+			this._rootObserver = null;
+			this._element = null;
+			this._container = null;
+		});
+		const bundles = ctx.get(TCollectionBundlesPlugin);
+		bundles?.events.on("engine:bound", (engine) => {
+			this._engine = engine;
+			this._listenTo(batchOf(engine)?.events, "change:shown", () => this._scheduleUpdate());
+		});
+		bundles?.events.on("bundle:registered", ({ uid, bundle }) => {
+			const itemElement = bundle.get(TElementPlugin);
+			itemElement?.events.on("ready", (element) => {
+				this._observeItem(uid, element);
+			});
+			itemElement?.events.on("removed", () => this._unobserveItem(uid));
+		});
+		bundles?.events.on("bundle:unregistered", ({ uid }) => this._unobserveItem(uid));
+	}
+	destroy() {
+		this._rootObserver?.disconnect();
+		this._rootObserver = null;
+		for (const observer of this._itemObservers.values()) observer.disconnect();
+		this._itemObservers.clear();
+		this._element = null;
+		this._container = null;
+		this._list = null;
+		this._engine = null;
+		this._collectionElements = null;
+		super.destroy();
+	}
+	/**
+	* Строки измерены: у нарисованной строки есть высота. Скрытый список, пустой
+	* и ещё не нарисованный — `false`: предел строк плагину считать не из чего
+	* (см. описание класса). Смена — `change:measured`.
+	*/
+	get measured() {
+		return this._measured;
+	}
+	_observeItem(uid, element) {
+		this._itemObservers.get(uid)?.disconnect();
+		const observer = new ResizeObserver(() => this._scheduleUpdate());
+		observer.observe(element, { box: "border-box" });
+		this._itemObservers.set(uid, observer);
+		this._scheduleUpdate();
+	}
+	_unobserveItem(uid) {
+		this._itemObservers.get(uid)?.disconnect();
+		this._itemObservers.delete(uid);
+		this._scheduleUpdate();
+	}
+	/**
+	* Пересчитать предел кадром позже — пока у плагина есть узел корня. Без
+	* узла повод ничего не планирует, какой бы он ни был: всё, что сменилось до
+	* узла, пересчитает `ready`.
+	*/
+	_scheduleUpdate() {
+		if (this._element) this._updateNextFrame();
+	}
+	/**
+	* Пересчёт: предел строк и признак «строки измерены» (`measured`). О смене
+	* признака — `change:measured`, после записи предела: подписчик видит список
+	* уже в пределе строк. Кадр, пришедший без узла корня (запланирован до
+	* `removed`), ничего не мерит.
+	*/
+	_update() {
+		const oldMeasured = this.measured;
+		if (!this._element) return;
+		const rows = (batchOf(this._engine)?.shown ?? []).map((item) => this._collectionElements?.getElementByItem(item) ?? null);
+		const measured = rows.some(hasHeight);
+		this._limit(rows, measured);
+		if (this._measured === measured) return;
+		this._measured = measured;
+		this.events.emit("change:measured", {
+			newValue: measured,
+			oldValue: oldMeasured
+		});
+	}
+	/**
+	* Ограничивает высоту прокручиваемого контейнера по `maxRows`. `rows` — узлы
+	* показанных элементов по порядку, `null` — не нарисованный окном.
+	*
+	* Контейнер — **список, в котором стоят элементы** (`closestList`), а не
+	* корень компонента. У Select его корень — поле, а список лежит в
+	* телепортированной панели: пока плагин писал в корень, Select получал
+	* `max-height` на поле и схлопывался в полосу. У ListBox это узел списка
+	* внутри корня: шапка и подвал стоят рядом с ним и в предел строк не входят.
+	* Не родитель элемента: у элемента группы родитель — группа, и предел
+	* получила бы она.
+	*/
+	_limit(rows, measured) {
+		const row = rows.find((candidate) => candidate !== null);
+		const container = (row ? closestList(row) : null) ?? this._element;
+		if (!isMeasurableElement(container)) return;
+		if (this._container !== container) {
+			if (this._container) release(this._container);
+			this._container = container;
+		}
+		const maxRows = this._list?.maxRows ?? 0;
+		if (maxRows === 0) {
+			release(container);
+			return;
+		}
+		if (row && !measured) return;
+		const visibleCount = Math.min(maxRows, rows.length);
+		const totalHeight = this._measure(container, rows, visibleCount);
+		if (totalHeight === 0) {
+			release(container);
+			return;
+		}
+		container.style.maxHeight = `${totalHeight}px`;
+		container.style.overflowY = visibleCount >= rows.length ? "hidden" : "auto";
+	}
+	/**
+	* Высота первых `count` строк вместе с промежутками между ними.
+	*
+	* Строки — дети контейнера: сумма их высот и зазоров. Строку, которую окно
+	* не нарисовало, считаем высотой нарисованной: в окне высота строк одна на
+	* все. Не нарисовано ни одной — строки ещё не измерены, и писать нечего.
+	* Последняя из первых строк стоит в группе — по её месту (`_measureByPlace`).
+	*
+	* `max-height` пишется в контейнер, а не в область строк, поэтому в неё идёт
+	* и то, что контейнер берёт сверх строк (`boxExtra`).
+	*/
+	_measure(container, rows, count) {
+		if (count === 0) return 0;
+		const last = rows[count - 1];
+		if (last && last.parentElement !== container) return this._measureByPlace(container, last);
+		const drawn = rows.find((row) => row !== null && isMeasurableElement(row));
+		if (!isMeasurableElement(drawn)) return 0;
+		const style = getComputedStyle(container);
+		const gap = parseFloat(style.rowGap) || 0;
+		let total = 0;
+		for (let i = 0; i < count; i++) {
+			const row = rows[i] ?? drawn;
+			if (isMeasurableElement(row)) total += row.offsetHeight;
+		}
+		total += (count - 1) * gap;
+		return total + boxExtra(style);
+	}
+	/**
+	* Высота до низа последней из первых строк по её месту — у строк в группах:
+	* от верха содержимого контейнера, с подписями групп и разделителями между
+	* строками. Верх — без прокрутки: место строки считается от начала списка, а
+	* не от того, что сейчас видно.
+	*/
+	_measureByPlace(container, last) {
+		const style = getComputedStyle(container);
+		const top = container.getBoundingClientRect().top + (parseFloat(style.borderTopWidth) || 0) + (parseFloat(style.paddingTop) || 0) - container.scrollTop;
+		return last.getBoundingClientRect().bottom - top + boxExtra(style);
+	}
+};
+//#endregion
+export { TListHeightPlugin };

package/dist/custom/list/height/index.d.ts

@@ -0,0 +1,2 @@
+export * from './height.plugin';
+export type { TListHeightPluginEvents } from './types';

package/dist/custom/list/height/types.d.ts

@@ -0,0 +1,10 @@
+import type { TValuePayload } from '@soxa-ui/core';
+import type { TPluginEvents } from '../../../base';
+export type TListHeightPluginEvents = TPluginEvents & {
+    /**
+     * Строки списка измерились или перестали мериться — `measured` сменился.
+     * Нужно соседу по набору (`TListScrollPlugin`), а не потребителю: в
+     * дескриптор событие не публикуется.
+     */
+    'change:measured': (payload: TValuePayload<boolean>) => void;
+};

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

@@ -0,0 +1,7 @@
+export * from './item';
+export * from './navigation';
+export * from './height';
+export * from './keyboard';
+export * from './scroll';
+export * from './option-ids';
+export { listOf, rowIn } from './row';

package/dist/custom/list/item/index.d.ts

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

package/dist/custom/list/item/item.plugin.d.ts

@@ -0,0 +1,25 @@
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TListItemPluginEvents } from './types';
+/**
+ * TListItemPlugin — состояние подсветки элемента списка (клавиатурная навигация).
+ *
+ * Не управляет выбором: выбор элемента выполняется selection-расширением коллекции.
+ * Плагин лишь хранит флаг `highlighted`, которым управляет TListKeyboardPlugin.
+ *
+ * Подсветку отдаёт теме сам — через `data-highlighted`. Раньше это делал
+ * шаблон, и два компонента успели разойтись: ListBox отдавал значение сырым,
+ * Select приводил его через `String(!!value)`. Оба варианта работали по
+ * случайности; здесь преобразование одно и живёт рядом с состоянием.
+ *
+ * В DOM плагин не ходит — пишет в набор, а раскладывает его шаблон, синхронно.
+ */
+export declare class TListItemPlugin extends TBasePlugin<any, TListItemPluginEvents> {
+    private _instance;
+    private _highlighted;
+    install(ctx: IPluginContext, options?: object): void;
+    get highlighted(): boolean;
+    set highlighted(value: boolean);
+    private _apply;
+    destroy(): void;
+}