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

package/dist/custom/rating/validity/validity.plugin.js

@@ -0,0 +1,91 @@
+import { TBasePlugin } from "../../../base/base.class.js";
+import { TElementPlugin } from "../../element/element.plugin.js";
+import { fieldOf, thumbsOf, trackOf } from "../../slide/parts.js";
+//#region src/custom/rating/validity/validity.plugin.ts
+/**
+* TRatingValidityPlugin — обязательная оценка: пока её нет, форма не
+* отправляется.
+*
+* 0 у оценки значит «оценки нет», и обязательная оценка с 0 — то же, что
+* пустое поле с `required`. Но поле оценки — `input[type=range]`: ни
+* `required`, ни состояния «пусто» у него нет, у ползунка значение есть
+* всегда. Поэтому ошибку полю ставит плагин — `setCustomValidity` со строкой
+* локали `rating.required`, пока оценка обязательна, не только для показа и
+* равна 0, — и снимает, когда условие ушло. Остальное делает браузер, как с
+* любым неверным полем: не отправляет форму, ставит фокус на поле и
+* показывает сообщение, а `disabled` из проверки исключает сам.
+*
+* Только для показа (`readonly`) ошибки нет, как у нативного поля `readonly`:
+* его браузер тоже не проверяет. Свойства «неверно» у ядра нет: когда
+* показывать ошибку, решает браузер, — до первой отправки нетронутая оценка
+* не горит, — и тема красит её по `:user-invalid` поля.
+*
+* Пересчёт — на появление узла, смену оценки, обязательности, режима только
+* для показа и локали. Без узла плагин ничего не делает: сборка идёт и на
+* сервере, а поле, которому ставить ошибку, появится с `ready`. Отпустил узел
+* или снят сам — ошибку с поля снимает: ставил её он.
+*/
+var TRatingValidityPlugin = class extends TBasePlugin {
+	_owner = null;
+	/** Источник локали набора — за строкой ошибки на её языке */
+	_locale = null;
+	/** Корень оценки, пока узел объявлен: поле плагин находит в нём */
+	_root = null;
+	install(ctx, options) {
+		super.install(ctx, options);
+		const owner = ctx.getInstance();
+		if (!owner) return;
+		this._owner = owner;
+		this._locale = ctx.locale;
+		const element = ctx.get(TElementPlugin);
+		element?.events.on("ready", (root) => this._attach(root));
+		element?.events.on("removed", () => this._detach());
+		const sync = () => this._sync();
+		this._listenTo(owner.events, "change:value", sync);
+		this._listenTo(owner.events, "change:required", sync);
+		this._listenTo(owner.events, "change:readonly", sync);
+		this._listenTo(ctx.locale.events, "change", sync);
+	}
+	destroy() {
+		this._detach();
+		this._owner = null;
+		this._locale = null;
+		super.destroy();
+	}
+	_attach(root) {
+		this._detach();
+		this._root = root;
+		this._sync();
+	}
+	_detach() {
+		this._field()?.setCustomValidity("");
+		this._root = null;
+	}
+	/** Ошибка полю — по текущей оценке; оценки нет только у обязательной. */
+	_sync() {
+		const owner = this._owner;
+		const field = this._field();
+		if (!owner || !field) return;
+		field.setCustomValidity(this._missing(owner) ? this._message() : "");
+	}
+	/**
+	* Обязательной оценки нет: она равна 0 и её можно поставить. Только для
+	* показа её не ставят вовсе, и спрашивать её с пользователя нечего.
+	*/
+	_missing(owner) {
+		return owner.required && !owner.readonly && owner.value === 0;
+	}
+	_message() {
+		return this._locale?.locale.translations.rating.required ?? "";
+	}
+	/** Поле — у единственной ручки оценки, её `input`; узла нет — и поля нет. */
+	_field() {
+		const owner = this._owner;
+		const root = this._root;
+		if (!owner || !root) return null;
+		const track = trackOf(owner, root);
+		return track ? fieldOf(thumbsOf(owner, track)[0]) : null;
+	}
+};
+//#endregion
+export { TRatingValidityPlugin };

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

@@ -0,0 +1 @@
+export { TReadyPlugin } from './ready.plugin';

package/dist/custom/ready/ready.plugin.d.ts

@@ -0,0 +1,14 @@
+import { TBasePlugin } from '../../base';
+import type { IPluginContext } from '../../base';
+/**
+ * Reports component availability through IComponentView.ready: the instance
+ * exists and its root DOM element has been announced by TElementPlugin.
+ * Sets true on element ready and false on removal, including replacement.
+ *
+ * This is an availability signal, not a barrier for other plugins' DOM
+ * handlers or asynchronous work. The instance itself exists before the root.
+ * TLayer uses the same flag to expose its stack position while available.
+ */
+export declare class TReadyPlugin extends TBasePlugin {
+    install(ctx: IPluginContext): void;
+}

package/dist/custom/ready/ready.plugin.js

@@ -0,0 +1,28 @@
+import { TBasePlugin } from "../../base/base.class.js";
+import { TElementPlugin } from "../element/element.plugin.js";
+//#region src/custom/ready/ready.plugin.ts
+/**
+* Reports component availability through IComponentView.ready: the instance
+* exists and its root DOM element has been announced by TElementPlugin.
+* Sets true on element ready and false on removal, including replacement.
+*
+* This is an availability signal, not a barrier for other plugins' DOM
+* handlers or asynchronous work. The instance itself exists before the root.
+* TLayer uses the same flag to expose its stack position while available.
+*/
+var TReadyPlugin = class extends TBasePlugin {
+	install(ctx) {
+		super.install(ctx);
+		const elementPlugin = ctx.get(TElementPlugin);
+		elementPlugin?.events.on("ready", () => {
+			const instance = ctx.getInstance();
+			if (instance) instance.ready = true;
+		});
+		elementPlugin?.events.on("removed", () => {
+			const instance = ctx.getInstance();
+			if (instance) instance.ready = false;
+		});
+	}
+};
+//#endregion
+export { TReadyPlugin };

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

@@ -0,0 +1,2 @@
+export * from './viewport';
+export * from './names';

package/dist/custom/scroller/names/index.d.ts

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

package/dist/custom/scroller/names/names.plugin.d.ts

@@ -0,0 +1,11 @@
+import type { IScroller } from '@soxa-ui/core';
+import { TNamesPlugin } from '../../../locale/names.plugin';
+import type { TTranslations } from '../../../locale/types';
+/**
+ * TScrollerNamesPlugin — имена кнопок листания ленты от локали: в
+ * `prevAria` и `nextAria`. Кнопка со стрелкой без имени для скринридера
+ * безымянна.
+ */
+export declare class TScrollerNamesPlugin extends TNamesPlugin<IScroller> {
+    protected _name(owner: IScroller, translations: TTranslations): void;
+}

package/dist/custom/scroller/names/names.plugin.js

@@ -0,0 +1,15 @@
+import { TNamesPlugin } from "../../../locale/names.plugin.js";
+//#region src/custom/scroller/names/names.plugin.ts
+/**
+* TScrollerNamesPlugin — имена кнопок листания ленты от локали: в
+* `prevAria` и `nextAria`. Кнопка со стрелкой без имени для скринридера
+* безымянна.
+*/
+var TScrollerNamesPlugin = class extends TNamesPlugin {
+	_name(owner, translations) {
+		owner.prevAria.add("aria-label", translations.scroller.prev);
+		owner.nextAria.add("aria-label", translations.scroller.next);
+	}
+};
+//#endregion
+export { TScrollerNamesPlugin };

package/dist/custom/scroller/viewport/edges.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Края ленты — чистая функция, без DOM.
+ *
+ * Весь счёт здесь, а плагин рядом только читает у вьюпорта три числа. Отсюда
+ * и проверяемость: дробные ширины, зум и RTL проверяются числами, а не
+ * настоящей раскладкой.
+ */
+/** Три числа, которые вьюпорт знает о себе сам. */
+export type TEdgesOptions = {
+    /**
+     * Положение ленты в системе координат браузера.
+     *
+     * В RTL оно отрицательное: начало строки — правый край, и от него лента
+     * уезжает влево. Поэтому знак здесь не значим, значим модуль — расстояние
+     * от логического начала.
+     */
+    scrollLeft: number;
+    /** Видимая ширина вьюпорта — она же шаг листания. */
+    clientWidth: number;
+    /** Полная ширина содержимого. */
+    scrollWidth: number;
+};
+/** Есть ли куда листать в каждую сторону. */
+export type TScrollerEdges = {
+    canPrev: boolean;
+    canNext: boolean;
+};
+/**
+ * Края ленты по замеру вьюпорта.
+ *
+ * Нулевая видимая ширина — это «раскладки ещё нет», а не «листать некуда»:
+ * до первой раскладки все три числа нули, и «вперёд» нечему включать.
+ */
+export declare function resolveEdges({ scrollLeft, clientWidth, scrollWidth, }: TEdgesOptions): TScrollerEdges;

package/dist/custom/scroller/viewport/edges.js

@@ -0,0 +1,29 @@
+//#region src/custom/scroller/viewport/edges.ts
+/**
+* Допуск в пиксель.
+*
+* `scrollLeft + clientWidth === scrollWidth` на дробных ширинах и при зуме не
+* сходится: браузер округляет `clientWidth` и `scrollWidth` до целых, а
+* `scrollLeft` отдаёт дробным. Без допуска кнопка «вперёд» на самом краю не
+* гасла бы, а лента доезжала бы до «ещё чуть-чуть» без движения.
+*/
+var TOLERANCE = 1;
+/**
+* Края ленты по замеру вьюпорта.
+*
+* Нулевая видимая ширина — это «раскладки ещё нет», а не «листать некуда»:
+* до первой раскладки все три числа нули, и «вперёд» нечему включать.
+*/
+function resolveEdges({ scrollLeft, clientWidth, scrollWidth }) {
+	if (clientWidth <= 0) return {
+		canPrev: false,
+		canNext: false
+	};
+	const offset = Math.abs(scrollLeft);
+	return {
+		canPrev: offset > TOLERANCE,
+		canNext: offset + clientWidth < scrollWidth - TOLERANCE
+	};
+}
+//#endregion
+export { resolveEdges };

package/dist/custom/scroller/viewport/focus.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Доводка элемента под фокусом в окно снапа ленты — чистая функция, без DOM.
+ *
+ * Плагин рядом только читает у вьюпорта окно снапа и два прямоугольника, а
+ * весь счёт здесь. Отсюда и проверяемость, как у `edges.ts`: RTL, субпиксели и
+ * элемент шире окна проверяются числами, а не настоящей раскладкой.
+ *
+ * Своё у ленты здесь только снап. Проверку «уже в окне» и элемент ленты шире
+ * окна она берёт у общей доводки (`nearestShift`), которой пользуется и ряд
+ * тегов `scroll`.
+ */
+import type { TFocusShiftOptions } from './types';
+/**
+ * На сколько сдвинуть ленту, чтобы элемент под фокусом встал в окно снапа, —
+ * или `null`, если он уже там.
+ *
+ * С ним в окно встаёт и элемент ленты, в котором он лежит: снап выравнивает
+ * элементы, и единица листания — элемент, а не его часть под фокусом. Не
+ * шире окна — целиком, и «уже в окне» значит «в окне весь элемент ленты».
+ * Оставь лента его у края, докрутку до конца окна — фокусом браузера или
+ * чужим `scrollIntoView` — снап вернул бы к соседней точке, и элемент так и
+ * остался бы у края. А у тега кольцо фокуса рисует пилюля, и крестик без
+ * подписи не скажет, какой тег он закроет.
+ *
+ * Сдвиг ведёт к точке снапа элемента ленты, а не просто к краю окна: снап
+ * действует и на программную прокрутку и вернул бы ленту к соседней точке.
+ * Элемент ленты не шире окна — точка одна: его начало у начала окна, и сам
+ * он тогда в окне целиком. Шире окна — точка снапа любое положение, где он
+ * накрывает окно (так их считает и сам снап), а «уже в окне» смотрит по
+ * одному элементу под фокусом: целиком элемент ленты в окно не встанет. Из
+ * таких положений берётся ближайшее, при котором элемент под фокусом в окне:
+ * с одним «начало к началу» крестик в конце длинного тега остался бы за
+ * краем.
+ *
+ * Элемент под фокусом шире окна в него не встанет ни при каком сдвиге и
+ * доводится до ближайшего положения, где накрывает окно: больше окна от него
+ * всё равно не увидеть.
+ */
+export declare function resolveFocusShift({ snapport, focused, item, rtl, }: TFocusShiftOptions): number | null;

package/dist/custom/scroller/viewport/focus.js

@@ -0,0 +1,61 @@
+import { nearestShift } from "../../../utils/nearestShift.js";
+//#region src/custom/scroller/viewport/focus.ts
+/**
+* Доводка элемента под фокусом в окно снапа ленты — чистая функция, без DOM.
+*
+* Плагин рядом только читает у вьюпорта окно снапа и два прямоугольника, а
+* весь счёт здесь. Отсюда и проверяемость, как у `edges.ts`: RTL, субпиксели и
+* элемент шире окна проверяются числами, а не настоящей раскладкой.
+*
+* Своё у ленты здесь только снап. Проверку «уже в окне» и элемент ленты шире
+* окна она берёт у общей доводки (`nearestShift`), которой пользуется и ряд
+* тегов `scroll`.
+*/
+var width = (span) => span.right - span.left;
+/**
+* На сколько сдвинуть ленту, чтобы элемент под фокусом встал в окно снапа, —
+* или `null`, если он уже там.
+*
+* С ним в окно встаёт и элемент ленты, в котором он лежит: снап выравнивает
+* элементы, и единица листания — элемент, а не его часть под фокусом. Не
+* шире окна — целиком, и «уже в окне» значит «в окне весь элемент ленты».
+* Оставь лента его у края, докрутку до конца окна — фокусом браузера или
+* чужим `scrollIntoView` — снап вернул бы к соседней точке, и элемент так и
+* остался бы у края. А у тега кольцо фокуса рисует пилюля, и крестик без
+* подписи не скажет, какой тег он закроет.
+*
+* Сдвиг ведёт к точке снапа элемента ленты, а не просто к краю окна: снап
+* действует и на программную прокрутку и вернул бы ленту к соседней точке.
+* Элемент ленты не шире окна — точка одна: его начало у начала окна, и сам
+* он тогда в окне целиком. Шире окна — точка снапа любое положение, где он
+* накрывает окно (так их считает и сам снап), а «уже в окне» смотрит по
+* одному элементу под фокусом: целиком элемент ленты в окно не встанет. Из
+* таких положений берётся ближайшее, при котором элемент под фокусом в окне:
+* с одним «начало к началу» крестик в конце длинного тега остался бы за
+* краем.
+*
+* Элемент под фокусом шире окна в него не встанет ни при каком сдвиге и
+* доводится до ближайшего положения, где накрывает окно: больше окна от него
+* всё равно не увидеть.
+*/
+function resolveFocusShift({ snapport, focused, item, rtl }) {
+	if (width(item) <= width(snapport)) {
+		if (nearestShift({
+			scrollWindow: snapport,
+			focused,
+			item
+		}) === null) return null;
+		return rtl ? item.right - snapport.right : item.left - snapport.left;
+	}
+	if (nearestShift({
+		scrollWindow: snapport,
+		focused
+	}) === null) return null;
+	return nearestShift({
+		scrollWindow: snapport,
+		focused,
+		item
+	});
+}
+//#endregion
+export { resolveFocusShift };

package/dist/custom/scroller/viewport/index.d.ts

@@ -0,0 +1,6 @@
+export { TScrollerViewportPlugin } from './viewport.plugin';
+export { resolveEdges } from './edges';
+export type { TEdgesOptions, TScrollerEdges } from './edges';
+export { resolveFocusShift } from './focus';
+export type { TFocusShiftOptions, TInlineSpan, TScrollerViewportPluginEvents } from './types';
+export { viewportStopOf } from './stop';

package/dist/custom/scroller/viewport/stop.d.ts

@@ -0,0 +1,24 @@
+import type { IScroller } from '@soxa-ui/core';
+import type { IPluginContext } from '../../../base';
+/**
+ * Вьюпорт ленты — `__viewport` в корне: по классу владельца
+ * (`classes.resolve`), а не строкой. Первый в корне — свой: вьюпорт вложенной
+ * ленты лежит внутри своего. `null` — вьюпорта в корне нет.
+ *
+ * Один на вьюпорт ленты (`TScrollerViewportPlugin`) и узел фокуса ленты
+ * (`viewportStopOf`).
+ */
+export declare function viewportOf(owner: IScroller, root: Element): Element | null;
+/**
+ * Остановка ленты — узел фокуса Scroller (`focusTarget` плагина действия):
+ * запись `focused = true` ставит фокус туда же, куда ведёт Tab, а не на кнопку
+ * «назад» перед вьюпортом.
+ *
+ * Остановку решают так же, как её ставит лента: вьюпорт — сам остановка, пока
+ * своих остановок внутри нет, а листать есть куда (`viewportTabIndex` ядра,
+ * по замеру `TScrollerViewportPlugin`), — тогда фокус на нём. Иначе — первая
+ * остановка внутри вьюпорта: элемент содержимого.
+ *
+ * `null` — остановок у ленты нет: внутри ни одной, а листать некуда.
+ */
+export declare function viewportStopOf(root: Element, ctx: IPluginContext): Element | null;

package/dist/custom/scroller/viewport/stop.js

@@ -0,0 +1,34 @@
+import { tabStops } from "../../../utils/tabStops.js";
+//#region src/custom/scroller/viewport/stop.ts
+/**
+* Вьюпорт ленты — `__viewport` в корне: по классу владельца
+* (`classes.resolve`), а не строкой. Первый в корне — свой: вьюпорт вложенной
+* ленты лежит внутри своего. `null` — вьюпорта в корне нет.
+*
+* Один на вьюпорт ленты (`TScrollerViewportPlugin`) и узел фокуса ленты
+* (`viewportStopOf`).
+*/
+function viewportOf(owner, root) {
+	return root.querySelector(owner.classes.resolve("__viewport", { point: true }));
+}
+/**
+* Остановка ленты — узел фокуса Scroller (`focusTarget` плагина действия):
+* запись `focused = true` ставит фокус туда же, куда ведёт Tab, а не на кнопку
+* «назад» перед вьюпортом.
+*
+* Остановку решают так же, как её ставит лента: вьюпорт — сам остановка, пока
+* своих остановок внутри нет, а листать есть куда (`viewportTabIndex` ядра,
+* по замеру `TScrollerViewportPlugin`), — тогда фокус на нём. Иначе — первая
+* остановка внутри вьюпорта: элемент содержимого.
+*
+* `null` — остановок у ленты нет: внутри ни одной, а листать некуда.
+*/
+function viewportStopOf(root, ctx) {
+	const owner = ctx.getInstance();
+	const viewport = owner ? viewportOf(owner, root) : null;
+	if (!owner || !viewport) return null;
+	if (owner.viewportTabIndex !== void 0) return viewport;
+	return tabStops(viewport)[0] ?? null;
+}
+//#endregion
+export { viewportOf, viewportStopOf };

package/dist/custom/scroller/viewport/types.d.ts

@@ -0,0 +1,31 @@
+import type { TPluginEvents } from '../../../base';
+import type { TInlineSpan } from '../../../utils';
+/**
+ * Своих событий у плагина нет: результат замера виден через инстанс —
+ * `canPrev`/`canNext` и `data-can-*` отдаёт ядро, оно же сообщает об их
+ * смене. Второй путь к тому же факту, через события плагина, разошёлся бы
+ * с первым.
+ */
+export type TScrollerViewportPluginEvents = TPluginEvents;
+/**
+ * Отрезок по строке — общий тип доводки (`utils`). Наружу его отдаёт лента:
+ * им описаны опции `resolveFocusShift`.
+ */
+export type { TInlineSpan };
+/** Что плагин намерил, когда фокус пришёл в ленту, — всё отрезками по строке. */
+export type TFocusShiftOptions = {
+    /**
+     * Окно снапа — паддинг-бокс вьюпорта без `scroll-padding` с каждой
+     * стороны. Тема делает его чистой частью ленты, между подсказками у краёв.
+     */
+    snapport: TInlineSpan;
+    /** Элемент под фокусом. */
+    focused: TInlineSpan;
+    /**
+     * Элемент ленты, в котором он лежит, — прямой ребёнок вьюпорта. Точки
+     * снапа тема ставит на них: `scroll-snap-align: start`.
+     */
+    item: TInlineSpan;
+    /** Письмо справа налево: начало строки — правый край. */
+    rtl: boolean;
+};

package/dist/custom/scroller/viewport/viewport.plugin.d.ts

@@ -0,0 +1,163 @@
+import type { IScroller } from '@soxa-ui/core';
+import { TBasePlugin } from '../../../base';
+import type { IPluginContext } from '../../../base';
+import type { TScrollerViewportPluginEvents } from './types';
+/**
+ * TScrollerViewportPlugin — вьюпорт ленты: замер краёв, само листание,
+ * доводка элемента под фокусом в окно снапа и фокус кнопки, выключенной у
+ * края.
+ *
+ * Плагин, а не расширение или разметка: и то, и другое здесь — операции над
+ * DOM. Где сейчас лента, сколько у неё содержимого и есть ли внутри свои
+ * остановки Tab, знает только живой узел; результат уходит в ядро одним
+ * вызовом (`IScroller.notifyViewport`) — тем же приёмом, каким клавиатура
+ * тегов сообщает тег под фокусом (`notifyFocus`).
+ *
+ * Клики по кнопкам плагин ловит сам, слушателем на корне, и зовёт команды
+ * ядра (приём `TSelectPointerPlugin` → `owner.toggleOpen()`). В разметке
+ * обработчиков нет: связка «нажали ⇄ листаем» повторялась бы в каждом из
+ * шести адаптеров.
+ *
+ * Поводов пересчитать четыре — размер вьюпорта, размер его детей, смена
+ * состава и прокрутка, — и все они сводятся в **один проход раз в кадр**.
+ * Писать в DOM прямо из колбэка наблюдателя нельзя: петля
+ * `ResizeObserver loop completed with undelivered notifications` роняет
+ * браузерный прогон (сторож `playground/vue/browser/setup.ts`).
+ *
+ * **Фокус.** Элемент под фокусом браузер докручивает, только если тот целиком
+ * ушёл из окна снапа, а частично видимый оставляет на месте — у края, под
+ * подсказкой темы. Поэтому по `focusin` плагин доводит элемент в окно сам
+ * (счёт — `resolveFocusShift`). Окно — паддинг-бокс вьюпорта без
+ * `scroll-padding`: ширину подсказки знает только тема, и она же делает окно
+ * чистой частью ленты. Замер окна и доводка без снапа — общие с рядом тегов
+ * `scroll` (`scrollWindowOf`, `nearestShift`). Три решения:
+ * - только фокус с клавиатуры (`:focus-visible`). Фокус от нажатия мышью
+ *   браузер сам не докручивает, и правильно: сдвинься лента между нажатием и
+ *   отпусканием, под указателем оказался бы другой элемент, и `click` не
+ *   дошёл бы;
+ * - сдвиг синхронный, прямо в обработчике, и мгновенный (`instant`). Фокус
+ *   браузер докручивает и сам, тоже мгновенно: после `focus()` — сразу за
+ *   `focusin`, и плавную анимацию он бы перебил, а после нашего сдвига ему уже
+ *   нечего делать. При переходе Tab он докручивает ещё до `focusin`, и
+ *   элемент, целиком ушедший из окна, плагин застаёт уже в окне;
+ * - в окно встаёт элемент ленты (прямой ребёнок вьюпорта), а не только
+ *   элемент под фокусом: не шире окна — целиком, к своей точке снапа; шире —
+ *   к ближайшей точке, где он накрывает окно, а элемент под фокусом в окне.
+ *   Элемент — потому что снап выравнивает элементы, а не их части: докрутку
+ *   до конца окна (фокусом браузера или чужим `scrollIntoView`) он вернул бы
+ *   к соседней точке, и элемент остался бы у края, — а крестик тега без
+ *   подписи не скажет, какой тег он закроет. Точка — потому что снап
+ *   действует и на программную прокрутку; ближайшая — потому что с одним
+ *   «начало к началу» крестик в конце длинного тега остался бы за краем.
+ *
+ * **Фокус у края.** Когда лента доезжает до края, кнопка этой стороны
+ * выключается нативным `disabled`, и если фокус был на ней, браузер
+ * сбрасывает его на страницу: пользователь клавиатуры и скринридера теряет
+ * место и кольцо фокуса. Поэтому плагин отдаёт такой фокус кнопке напротив.
+ * Край, от которого ушли, к этому моменту уже открыт: пользователь остаётся у
+ * ленты, и прокрутка не меняется. Отдаёт кадром позже: в одном замере один
+ * край закрывается, а другой открывается, и кнопку напротив включает только
+ * перерисовка адаптера. Фокус, который за этот кадр увели на другой элемент,
+ * плагин не трогает, а у выключенной ленты отдать его некому.
+ *
+ * Не режим `Button` «выключена, но фокусируема» (`aria-disabled` вместо
+ * нативного `disabled`): это новая поверхность общего компонента ради правила
+ * фокуса одной ленты. И не элемент ленты: остановка ряда тегов бывает за
+ * краем, и фокус на ней прокрутил бы ленту обратно.
+ */
+export declare class TScrollerViewportPlugin extends TBasePlugin<IScroller, TScrollerViewportPluginEvents> {
+    private _owner;
+    private _root;
+    private _viewport;
+    private _resize;
+    private _mutation;
+    private _frame;
+    /** Кадр, в котором фокус уйдёт от выключенной кнопки к кнопке напротив. */
+    private _handoverFrame;
+    /**
+     * Узлы под наблюдением размера — вьюпорт и его прямые дети.
+     *
+     * Список, а не «отключить и наблюдать заново каждый проход»: свежая
+     * подписка `ResizeObserver` сразу шлёт уведомление, и переподписка на
+     * каждом проходе гоняла бы проход по кругу кадр за кадром. Здесь новый
+     * узел даёт одно лишнее уведомление, а следующий проход состава уже не
+     * меняет.
+     */
+    private readonly _observed;
+    install(ctx: IPluginContext): void;
+    destroy(): void;
+    /** Корень сменился — вместе с ним переезжают вьюпорт, слушатели и наблюдатели. */
+    private _bind;
+    private _listen;
+    private _unlisten;
+    /** Снимает наблюдение размеров: узлы старого корня нас больше не касаются. */
+    private _disconnect;
+    /** Проход — раз в кадр: подряд идущие поводы схлопываются в один замер. */
+    private readonly _onSchedule;
+    private _schedule;
+    private _cancel;
+    /**
+     * Под наблюдением вьюпорт и его прямые дети: лента меняет края и когда ей
+     * самой сменили ширину, и когда вырос любой элемент внутри.
+     *
+     * `border-box`: у вьюпорта есть паддинг (запас под кольцо фокуса
+     * содержимого), и `content-box` пропустил бы его смену вместе со сменой
+     * размера.
+     */
+    private _observe;
+    /** Три числа вьюпорта плюс остановки Tab внутри — весь замер ленты. */
+    private _measure;
+    /**
+     * Шаг — видимая ширина вьюпорта, то есть страница; до границы элемента
+     * страницу доводит снап темы, и границы элементов считать не нужно —
+     * в этом и была ставка на слот вместо коллекции.
+     *
+     * Знак — по вычисленному направлению письма: в RTL начало строки справа,
+     * и «вперёд» уводит ленту влево.
+     *
+     * Листает плавно, если движение не убрано (`smoothScrollBehavior`): по
+     * умолчанию — пока система о движении не просила, а режим движения
+     * библиотеки может задать приложение. Плавность — в вызове, а не проп
+     * ядра: из трёх значений `TScrollBehavior` у ленты осмысленны два, и
+     * третье было бы мёртвым значением в перечислении. Правило темы с этим не
+     * спорит — `scroll-behavior` она не объявляет.
+     */
+    private _scroll;
+    /**
+     * Нажатие по кнопке ленты. Кнопки стоят снаружи вьюпорта, поэтому чужая
+     * лента внутри содержимого своими кнопками нашу не двигает: её кнопки
+     * лежат в нашем вьюпорте.
+     */
+    private readonly _onClick;
+    /**
+     * Фокус с клавиатуры пришёл в ленту — довести элемент под ним в окно
+     * снапа (почему так — в описании плагина).
+     *
+     * Сам вьюпорт — остановка Tab ленты без своих остановок: он и есть окно, и
+     * доводить его некуда.
+     */
+    private readonly _onFocusIn;
+    /**
+     * Край закрылся. Если фокус на кнопке этого края, её выключит перерисовка,
+     * и браузер сбросит фокус на страницу, — кадром позже его заберёт кнопка
+     * напротив (почему так — в описании плагина).
+     */
+    private _onEdgeClosed;
+    /**
+     * Отдать фокус кнопке напротив, если у него не осталось места.
+     *
+     * Без места он в двух случаях: браузер сбросил его на страницу или оставил
+     * на выключенной кнопке. Если же край за кадр открылся снова, кнопка жива,
+     * и фокус на ней остаётся.
+     */
+    private _handOver;
+    private _cancelHandover;
+    /**
+     * Кнопка этой ленты, а не первая по селектору: у вложенной ленты кнопки с
+     * тем же классом, и лежат они в нашем вьюпорте.
+     */
+    private _button;
+    private _owns;
+    /** Селектор части — из классов инстанса, а не строкой в плагине. */
+    private _selector;
+}