@shtabapp/ui-kit 1.62.0 → 1.64.0

package/dist/components/STable/utils/useTableGridFocus.d.ts

@@ -0,0 +1,79 @@
+import { type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';
+import { type TSTableFlatRow } from '../STable.types';
+import type { TSTableFlatRowsSnapshot } from './useFlatTableRows';
+import { type TSTableColumnDescriptor } from './useTableColumns';
+/** Секции грида по вертикальной оси; значения совпадают с `data-section` в DOM. */
+export declare enum ESTableGridSection {
+    HEADER = "h",
+    BODY = "b",
+    CREATION = "c",
+    AGGREGATE = "a"
+}
+/** Адрес roving-фокуса. Тело адресуется КЛЮЧОМ строки: индекс переживает не всякую правку данных. */
+export type TSTableGridFocusAddress = {
+    section: ESTableGridSection;
+    /** Ключ строки тела; у шапки и полос tfoot отсутствует. */
+    rowKey?: string;
+    columnKey: string;
+};
+type TSTableGridFocusOptions = {
+    /** Доскроллить тело к строке адреса. */
+    scroll?: boolean;
+    /** Перенести DOM-фокус на ячейку (false — только смена roving-адреса). */
+    focusElement?: boolean;
+    /** Обновить память колонки (вертикальные переходы её сохраняют). */
+    updateDesired?: boolean;
+};
+/** Разбор `data-section` из DOM: значение приходит строкой, поэтому нужен guard. */
+export declare const resolveTableGridSection: (value: string | null) => ESTableGridSection | undefined;
+export interface IUseTableGridFocusOptions<TItem extends Record<string, unknown>> {
+    tableRootElement: Ref<HTMLElement | null>;
+    tableElement: Ref<HTMLElement | null>;
+    scrollElement: Ref<HTMLElement | null>;
+    columnDescriptors: ComputedRef<TSTableColumnDescriptor<TItem>[]>;
+    flatRows: ComputedRef<TSTableFlatRow<TItem>[]>;
+    snapshot: ComputedRef<TSTableFlatRowsSnapshot<TItem>>;
+    /** Колонка контента групповой строки. */
+    groupColumnKey: MaybeRefOrGetter<string | undefined>;
+    /** Колонка контента строки-футера поддерева. */
+    depthFooterColumnKey: MaybeRefOrGetter<string | undefined>;
+    /** Колонка контента строки «Показать ещё». */
+    loadMoreColumnKey: MaybeRefOrGetter<string | undefined>;
+    /** Колонка контента строки создания. */
+    creationColumnKey: MaybeRefOrGetter<string | undefined>;
+    hasCreationRow: MaybeRefOrGetter<boolean>;
+    hasAggregateRow: MaybeRefOrGetter<boolean>;
+    isRowNavigable: (flatRow: TSTableFlatRow<TItem> | undefined) => boolean;
+    /** Шаг PageUp/PageDown в строках. */
+    pageSize: MaybeRefOrGetter<number>;
+    buildCellDomId: (address: TSTableGridFocusAddress) => string;
+    onBodyRowFocused: (rowKey: string) => void;
+    scrollToRowIndex: (rowIndex: number) => void;
+}
+/**
+ * Геометрия грида и DOM-фокус модели WAI-ARIA Grid: одна roving-ячейка на всю
+ * таблицу, порядковая ось строк «шапка → тело → строка создания → агрегат».
+ * Семантики клавиш здесь нет — её держит таблица.
+ */
+export declare const useTableGridFocus: <TItem extends Record<string, unknown>>({ tableRootElement, tableElement, scrollElement, columnDescriptors, flatRows, snapshot, groupColumnKey, depthFooterColumnKey, loadMoreColumnKey, creationColumnKey, hasCreationRow, hasAggregateRow, isRowNavigable, pageSize, buildCellDomId, onBodyRowFocused, scrollToRowIndex, }: IUseTableGridFocusOptions<TItem>) => {
+    focusAddress: ComputedRef<TSTableGridFocusAddress>;
+    focusedBodyRowKey: ComputedRef<string | undefined>;
+    focusBodyRowIndex: ComputedRef<number | undefined>;
+    cellEntered: import("vue").ShallowRef<boolean, boolean>;
+    isCellFocused: (section: ESTableGridSection, rowKey: string | undefined, columnKey: string) => boolean;
+    getCellTabIndex: (section: ESTableGridSection, rowKey: string | undefined, columnKey: string) => 0 | -1;
+    moveFocus: (rowDelta: number, columnDelta: number) => void;
+    moveToRowEdge: (edge: "start" | "end") => void;
+    moveToGridEdge: (edge: "first" | "last") => void;
+    moveByPage: (direction: 1 | -1) => void;
+    focusAddressNow: (address: TSTableGridFocusAddress, options?: TSTableGridFocusOptions) => void;
+    syncFocusAddress: (address: TSTableGridFocusAddress, entered: boolean) => void;
+    enterCell: () => boolean;
+    exitCell: () => void;
+    cycleCellFocus: (direction: 1 | -1) => void;
+    restoreFocusAfterUnmount: () => void;
+    ensureFocusedCellVisibleHorizontally: () => void;
+    queryFocusedCellElement: () => HTMLElement | undefined;
+};
+export {};
+//# sourceMappingURL=useTableGridFocus.d.ts.map

package/dist/components/STable/utils/useTableGridFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableGridFocus.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableGridFocus.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACT,MAAM,KAAK,CAAA;AAEZ,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAwB,KAAK,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAEtF,mFAAmF;AACnF,oBAAY,kBAAkB;IAC5B,MAAM,MAAM;IACZ,IAAI,MAAM;IACV,QAAQ,MAAM;IACd,SAAS,MAAM;CAChB;AAED,qGAAqG;AACrG,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,kBAAkB,CAAA;IAC3B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,uBAAuB,GAAG;IAC7B,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,0EAA0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,oEAAoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAMD,oFAAoF;AACpF,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,GAAG,IAAI,mCAE3D,CAAA;AAED,MAAM,WAAW,yBAAyB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9E,gBAAgB,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACzC,YAAY,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACrC,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtC,iBAAiB,EAAE,WAAW,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChE,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC9C,QAAQ,EAAE,WAAW,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAA;IACrD,yCAAyC;IACzC,cAAc,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACpD,gDAAgD;IAChD,oBAAoB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC1D,8CAA8C;IAC9C,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,wCAAwC;IACxC,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,cAAc,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACzC,eAAe,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC1C,cAAc,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,SAAS,KAAK,OAAO,CAAA;IACvE,qCAAqC;IACrC,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAClC,cAAc,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,MAAM,CAAA;IAC5D,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7C;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,sRAkBtE,yBAAyB,CAAC,KAAK,CAAC;;;;;6BAyhBtB,kBAAkB,UACnB,MAAM,GAAG,SAAS,aACf,MAAM;+BAWR,kBAAkB,UACnB,MAAM,GAAG,SAAS,aACf,MAAM;0BAhOU,MAAM,eAAe,MAAM;0BA2B3B,OAAO,GAAG,KAAK;2BAUd,OAAO,GAAG,MAAM;4BAgBf,CAAC,GAAG,CAAC,CAAC;+BApFH,uBAAuB,YAAY,uBAAuB;gCAsOzD,uBAAuB,WAAW,OAAO;;;gCAvFzC,CAAC,GAAG,CAAC,CAAC;;;;CAsJ1C,CAAA"}

package/dist/components/STable/utils/useTableGridKeyboard.d.ts

@@ -0,0 +1,36 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+import { type TSTableFlatRow } from '../STable.types';
+import type { TSTableColumnDescriptor } from './useTableColumns';
+import { type useTableGridFocus } from './useTableGridFocus';
+type TGridFocus<TItem extends Record<string, unknown>> = ReturnType<typeof useTableGridFocus<TItem>>;
+export interface IUseTableGridKeyboardOptions<TItem extends Record<string, unknown>> {
+    gridFocus: TGridFocus<TItem>;
+    columnDescriptors: ComputedRef<TSTableColumnDescriptor<TItem>[]>;
+    flatRows: ComputedRef<TSTableFlatRow<TItem>[]>;
+    /** Колонка дерева обычной строки: проп `expandColumnKey`, иначе главная колонка. */
+    expandColumnKey: MaybeRefOrGetter<string | undefined>;
+    primaryColumnKey: MaybeRefOrGetter<string | undefined>;
+    /** У групповой строки контент живёт в одной колонке — она же колонка дерева. */
+    groupColumnKey: MaybeRefOrGetter<string | undefined>;
+    selectable: MaybeRefOrGetter<boolean>;
+    openMenuColumnKey: MaybeRefOrGetter<string | undefined>;
+    toggleExpanded: (rowKey: string) => void;
+    toggleRowSelected: (rowKey: string) => void;
+    applySortCycle: (columnKey: string, append: boolean) => void;
+    setColumnMenuOpen: (columnKey: string, open: boolean) => void;
+    resizeColumnByKeyboard: (descriptor: TSTableColumnDescriptor<TItem>, direction: 1 | -1) => void;
+    onDepthFooterActivate: (flatRow: TSTableFlatRow<TItem>) => void;
+    onLoadMoreActivate: (flatRow: TSTableFlatRow<TItem>) => void;
+    onRowActivate: (flatRow: TSTableFlatRow<TItem>, event: KeyboardEvent) => void;
+}
+/**
+ * Клавиатурный диспетчер грида: разбирает событие и переводит его в вызовы
+ * `useTableGridFocus` и коллбэки таблицы. Собственного состояния не держит —
+ * адрес фокуса и режим «внутри ячейки» живут в `useTableGridFocus`.
+ */
+export declare const useTableGridKeyboard: <TItem extends Record<string, unknown>>({ gridFocus, columnDescriptors, flatRows, expandColumnKey, primaryColumnKey, groupColumnKey, selectable, openMenuColumnKey, toggleExpanded, toggleRowSelected, applySortCycle, setColumnMenuOpen, resizeColumnByKeyboard, onDepthFooterActivate, onLoadMoreActivate, onRowActivate, }: IUseTableGridKeyboardOptions<TItem>) => {
+    handleGridFocusIn: (event: FocusEvent) => void;
+    handleGridKeydown: (event: KeyboardEvent) => void;
+};
+export {};
+//# sourceMappingURL=useTableGridKeyboard.d.ts.map

package/dist/components/STable/utils/useTableGridKeyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableGridKeyboard.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableGridKeyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAGtE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAA;AAE5B,KAAK,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAA;AAEpG,MAAM,WAAW,4BAA4B,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjF,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IAC5B,iBAAiB,EAAE,WAAW,CAAC,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAChE,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC9C,oFAAoF;IACpF,eAAe,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACrD,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACtD,gFAAgF;IAChF,cAAc,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACpD,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACrC,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3C,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5D,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7D,sBAAsB,EAAE,CAAC,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAA;IAC/F,qBAAqB,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IAC/D,kBAAkB,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IAC5D,aAAa,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;CAC9E;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,uRAiBzE,4BAA4B,CAAC,KAAK,CAAC;+BAoBF,UAAU;+BA+JV,aAAa;CAgGhD,CAAA"}

package/dist/components/STable/utils/useTableRenderEntries.d.ts

@@ -0,0 +1,56 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+import type { TSTableFlatRow } from '../STable.types';
+export type TSTableRenderEntry<TItem extends Record<string, unknown> = Record<string, unknown>> = {
+    row?: TSTableFlatRow<TItem>;
+    /** Ключ рендера: идентичность строки или позиция спейсера. */
+    renderKey: string;
+    spacer?: boolean;
+    spacerHeight?: number;
+    stuckTop?: boolean;
+    stuckBottom?: boolean;
+    /** Уходящий sticky-футер: прижат вместе со следующим и рисуется поверх него. */
+    stuckBottomLeaving?: boolean;
+    /** Выезжающий sticky-футер: уже отпущен CSS, но держится поверх всех до выхода из слота. */
+    stuckBottomSliding?: boolean;
+    /** Высота уходящего футера для следующего под ним: обрезка, чтобы не выглядывал. */
+    stuckBottomCoverHeight?: number;
+    /** Прижат дальше следующего: под ним, ниже по z. */
+    stuckBottomFar?: boolean;
+    /** Измеренная высота строки — держит геометрию в режиме плейсхолдеров. */
+    rowHeight?: number;
+};
+type TRowOffset = {
+    start: number;
+    end: number;
+} | undefined;
+export interface IUseTableRenderEntriesOptions<TItem extends Record<string, unknown>> {
+    flatRows: ComputedRef<TSTableFlatRow<TItem>[]>;
+    virtualEnabled: MaybeRefOrGetter<boolean>;
+    /** Индексы строк окна виртуализации; вне виртуального режима не читаются. */
+    windowIndexes: ComputedRef<number[]>;
+    /** Высота tbody в UI-координатах: при сжатии прокрутки меньше модельной. */
+    uiTotalSize: ComputedRef<number>;
+    /** Офсет строки в UI-координатах tbody. */
+    getRowUiOffset: (rowIndex: number) => TRowOffset;
+    /** Прилипшая сверху групповая строка и прилипшие снизу футеры поддеревьев. */
+    activeGroupRowIndex: ComputedRef<number | undefined>;
+    activeDepthFooterRowIndexes: ComputedRef<number[]>;
+    leavingDepthFooterRowIndex: ComputedRef<number | undefined>;
+    slidingDepthFooterRowIndexes: ComputedRef<number[]>;
+    farDepthFooterRowIndexes: ComputedRef<number[]>;
+    /** Активная строка навигации: на ней стоит DOM-фокус грида. */
+    activeRowIndex: ComputedRef<number | undefined>;
+}
+/**
+ * Единый поток рендера tbody: блоки строк (окно плюс форс-строки вне окна),
+ * разделённые спейсерами по фактическим виртуальным офсетам.
+ *
+ * Ключ рендера — всегда идентичность строки. Роль (прилипшая, активная) на ключ не
+ * влияет: она меняется в рантайме, и ключ, зависящий от роли, размонтировал бы живой
+ * DOM вместе с фокусом, начатым кликом и незавершённым перетаскиванием.
+ */
+export declare const useTableRenderEntries: <TItem extends Record<string, unknown>>({ flatRows, virtualEnabled, windowIndexes, uiTotalSize, getRowUiOffset, activeGroupRowIndex, activeDepthFooterRowIndexes, leavingDepthFooterRowIndex, slidingDepthFooterRowIndexes, farDepthFooterRowIndexes, activeRowIndex, }: IUseTableRenderEntriesOptions<TItem>) => {
+    renderEntries: ComputedRef<TSTableRenderEntry<TItem>[]>;
+};
+export {};
+//# sourceMappingURL=useTableRenderEntries.d.ts.map

package/dist/components/STable/utils/useTableRenderEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableRenderEntries.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableRenderEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAChG,GAAG,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;IAC3B,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,4FAA4F;IAC5F,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,oFAAoF;IACpF,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,oDAAoD;IACpD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAE5D,MAAM,WAAW,6BAA6B,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAClF,QAAQ,EAAE,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC9C,cAAc,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACzC,6EAA6E;IAC7E,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IACpC,4EAA4E;IAC5E,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,2CAA2C;IAC3C,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU,CAAA;IAChD,8EAA8E;IAC9E,mBAAmB,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACpD,2BAA2B,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IAClD,0BAA0B,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC3D,4BAA4B,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IACnD,wBAAwB,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IAC/C,+DAA+D;IAC/D,cAAc,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;CAChD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,iOAY1E,6BAA6B,CAAC,KAAK,CAAC;;CA6JtC,CAAA"}

package/dist/components/STable/utils/useTableRowDnd.d.ts

@@ -0,0 +1,37 @@
+import { type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';
+import { ESTableDropAction, ESTableRowsDragMode, type ISTableRowsDropPayload, type ISTableRowsReorderPayload, type TSTableFlatRow } from '../STable.types';
+import type { TSTableFlatRowsSnapshot } from './useFlatTableRows';
+type TSTableRowDropIndicator = {
+    targetKey: string;
+    action: ESTableDropAction;
+    depth: number;
+};
+export interface IUseTableRowDndOptions<TItem extends Record<string, unknown>> {
+    tableId: string;
+    enabled: MaybeRefOrGetter<boolean>;
+    dragMode: MaybeRefOrGetter<ESTableRowsDragMode>;
+    snapshot: ComputedRef<TSTableFlatRowsSnapshot<TItem>>;
+    scrollElement: Ref<HTMLElement | null>;
+    isRowDraggable: MaybeRefOrGetter<((item: TItem) => boolean) | undefined>;
+    dragExpandDelayMs: MaybeRefOrGetter<number>;
+    isExpanded: (rowKey: string) => boolean;
+    onHoverExpand: (rowKey: string) => void;
+    onReorder: (payload: ISTableRowsReorderPayload<TItem>) => void;
+    onTreeDrop: (payload: ISTableRowsDropPayload<TItem>) => void;
+    /** Заголовок строки для драг-превью. */
+    resolveRowPreviewTitle: (flatRow: TSTableFlatRow<TItem>) => string;
+}
+/**
+ * DnD строк: draggable/dropTarget регистрируются на `<tr>` из DOM-пула, данные
+ * строки читаются лениво из data-index на момент жеста — переиспользование
+ * элементов пула безопасно. Payload переживает размонтирование источника
+ * (monitorForElements). Tree: edges top/bottom + drop-inside центральной зоной
+ * (у групп мгновенно, у строк с задержкой), hover-раскрытие веток.
+ */
+export declare const useTableRowDnd: <TItem extends Record<string, unknown>>({ tableId, enabled, dragMode, snapshot, scrollElement, isRowDraggable, dragExpandDelayMs, isExpanded, onHoverExpand, onReorder, onTreeDrop, resolveRowPreviewTitle, }: IUseTableRowDndOptions<TItem>) => {
+    registerRowElement: (rowElement: Element | null) => void;
+    draggingRowKey: import("vue").ShallowRef<string | undefined, string | undefined>;
+    dropIndicator: import("vue").ShallowRef<TSTableRowDropIndicator | undefined, TSTableRowDropIndicator | undefined>;
+};
+export {};
+//# sourceMappingURL=useTableRowDnd.d.ts.map

package/dist/components/STable/utils/useTableRowDnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableRowDnd.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableRowDnd.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACT,MAAM,KAAK,CAAA;AAqBZ,OAAO,EACL,iBAAiB,EAEjB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAEjE,KAAK,uBAAuB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,iBAAiB,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED,MAAM,WAAW,sBAAsB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3E,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC,QAAQ,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,CAAA;IAC/C,QAAQ,EAAE,WAAW,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAA;IACrD,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC,CAAA;IACxE,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC3C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;IACvC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,SAAS,EAAE,CAAC,OAAO,EAAE,yBAAyB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IAC9D,UAAU,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IAC5D,wCAAwC;IACxC,sBAAsB,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,MAAM,CAAA;CACnE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,uKAanE,sBAAsB,CAAC,KAAK,CAAC;qCA6MU,OAAO,GAAG,IAAI;;;CAgOvD,CAAA"}

package/dist/components/STable/utils/useTableRowHydration.d.ts

@@ -0,0 +1,29 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+export interface IUseTableRowHydrationOptions {
+    /** Индексы строк окна виртуализации. */
+    windowIndexes: ComputedRef<number[]>;
+    /** Видимый диапазон без overscan: ближние к нему строки гидрируются первыми. */
+    visibleRange: ComputedRef<{
+        startIndex: number;
+        endIndex: number;
+    } | undefined>;
+    getRowKey: (rowIndex: number) => string | undefined;
+    /** Строка, которая гидрируется первой и вне бюджета (активная строка навигации). */
+    pinnedRowKey?: MaybeRefOrGetter<string | undefined>;
+    /** Выключено — все строки окна рендерятся полностью и сразу. */
+    enabled: MaybeRefOrGetter<boolean>;
+}
+/**
+ * Прогрессивная гидрация строк окна. Виртуализатор меняет окно на каждый кадр прокрутки,
+ * а монтирование строки с компонентами в ячейках стоит миллисекунды: при быстрой
+ * прокрутке кадр не укладывается в 16 мс — отсюда подвисания и пустые полосы (окно
+ * отстаёт от композитора). Новые строки окна получают полный рендер порциями: не больше
+ * бюджета за кадр, остальные ждут плашками и добираются следующими кадрами, ближние к
+ * видимой области — первыми. Бюджет подстраивается под фактическое время кадра, поэтому
+ * на лёгких ячейках плашки не появляются вовсе. Строки, вышедшие из окна, гидрацию теряют.
+ */
+export declare const useTableRowHydration: ({ windowIndexes, visibleRange, getRowKey, pinnedRowKey, enabled, }: IUseTableRowHydrationOptions) => {
+    isRowHydrated: (rowKey: string) => boolean;
+    hydratedKeys: import("vue").ShallowRef<ReadonlySet<string>, ReadonlySet<string>>;
+};
+//# sourceMappingURL=useTableRowHydration.d.ts.map

package/dist/components/STable/utils/useTableRowHydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableRowHydration.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableRowHydration.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAYzF,MAAM,WAAW,4BAA4B;IAC3C,wCAAwC;IACxC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IACpC,gFAAgF;IAChF,YAAY,EAAE,WAAW,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IAC/E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACnD,oFAAoF;IACpF,YAAY,CAAC,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACnD,gEAAgE;IAChE,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CACnC;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAAI,oEAMlC,4BAA4B;4BA6KE,MAAM;;CAKtC,CAAA"}

package/dist/components/STable/utils/useTableScrollScale.d.ts

@@ -0,0 +1,34 @@
+import { type MaybeRefOrGetter, type Ref } from 'vue';
+export interface IUseTableScrollScaleOptions {
+    scrollElement: Ref<HTMLElement | null>;
+    /** Модельная высота tbody — сумма высот всех строк. */
+    totalSize: MaybeRefOrGetter<number>;
+    /** Высота вьюпорта скроллера (clientHeight). */
+    viewportHeight: MaybeRefOrGetter<number>;
+    /** Шапка и полосы tfoot: они тоже входят в scrollHeight. */
+    extraHeight: MaybeRefOrGetter<number>;
+    /**
+     * Масштаб сменился при активном сжатии, scrollTop переписан под прежний модельный
+     * офсет. Перезапись обычно округляется в то же число и scroll-события не даёт —
+     * потребитель сообщает офсет виртуализатору сам.
+     */
+    onRescale?: (modelOffset: number) => void;
+}
+/**
+ * Сжатие прокрутки для таблиц выше лимита браузера (ag-grid-style): высота tbody в DOM
+ * ограничена потолком, scrollTop скроллера («UI») переводится в модельный офсет, а строки
+ * раскладываются по UI-координатам как `модель − uiShift`. Карта кусочная: краевые зоны
+ * один к одному, середина — пропорционально. Пока таблица ниже потолка — тождество.
+ */
+export declare const useTableScrollScale: ({ scrollElement, totalSize, viewportHeight, extraHeight, onRescale, }: IUseTableScrollScaleOptions) => {
+    uiScrollTop: import("vue").ShallowRef<number, number>;
+    modelScrollOffset: import("vue").ComputedRef<number>;
+    uiShift: import("vue").ComputedRef<number>;
+    uiTotalSize: import("vue").ComputedRef<number>;
+    maxModelScrollTop: import("vue").ComputedRef<number>;
+    active: import("vue").ComputedRef<boolean>;
+    uiToModel: (uiOffset: number) => number;
+    modelToUi: (modelOffset: number) => number;
+    setScrollTop: (container: HTMLElement, uiOffset: number) => void;
+};
+//# sourceMappingURL=useTableScrollScale.d.ts.map

package/dist/components/STable/utils/useTableScrollScale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableScrollScale.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableScrollScale.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,GAAG,EACT,MAAM,KAAK,CAAA;AAWZ,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtC,uDAAuD;IACvD,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACnC,gDAAgD;IAChD,cAAc,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,4DAA4D;IAC5D,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACrC;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AA+GD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,uEAMjC,2BAA2B;;;;;;;0BAmBC,MAAM;6BAIH,MAAM;8BAuDL,WAAW,YAAY,MAAM;CAsG/D,CAAA"}

package/dist/components/STable/utils/useTableSelection.d.ts

@@ -0,0 +1,27 @@
+import { type ComputedRef, type MaybeRefOrGetter, type Ref } from 'vue';
+import { ESTableCheckState, type TSTableFieldResolver } from '../STable.types';
+import { type TSTableTreeIndex } from './useFlatTableRows';
+export interface IUseTableSelectionOptions<TItem extends Record<string, unknown>> {
+    selected: Ref<string[]>;
+    cascade: MaybeRefOrGetter<boolean>;
+    treeIndex: ComputedRef<TSTableTreeIndex<TItem>>;
+    groupRow: MaybeRefOrGetter<TSTableFieldResolver<TItem, boolean> | undefined>;
+    disabledKey: MaybeRefOrGetter<(keyof TItem & string) | undefined>;
+    isItemSelectable?: MaybeRefOrGetter<((item: TItem) => boolean) | undefined>;
+}
+/**
+ * Выбор строк с опциональным каскадом (tri-state):
+ * - в `selected` живут только selectable-узлы (группы и disabled исключены);
+ * - checked = сам узел в наборе; indeterminate = узел не в наборе, но есть выбранные потомки;
+ * - каскадный клик кладёт/убирает всё selectable-поддерево, авто-подъём достраивает предков.
+ */
+export declare const useTableSelection: <TItem extends Record<string, unknown>>({ selected, cascade, treeIndex, groupRow, disabledKey, isItemSelectable, }: IUseTableSelectionOptions<TItem>) => {
+    isSelected: (rowKey: string) => boolean;
+    isNodeSelectable: (rowKey: string) => boolean;
+    getCheckState: (rowKey: string) => ESTableCheckState;
+    toggleRow: (rowKey: string) => void;
+    headerCheckState: ComputedRef<ESTableCheckState>;
+    toggleSelectAll: () => void;
+    clearSelection: () => void;
+};
+//# sourceMappingURL=useTableSelection.d.ts.map

package/dist/components/STable/utils/useTableSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableSelection.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAEnG,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC9E,OAAO,EAA4B,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAEpF,MAAM,WAAW,yBAAyB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9E,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;IACvB,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC,SAAS,EAAE,WAAW,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/C,QAAQ,EAAE,gBAAgB,CAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAAA;IAC5E,WAAW,EAAE,gBAAgB,CAAC,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC,CAAA;IACjE,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,SAAS,CAAC,CAAA;CAC5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,4EAOtE,yBAAyB,CAAC,KAAK,CAAC;yBAyDL,MAAM;+BAhDA,MAAM;4BAoDT,MAAM;wBAmEV,MAAM;;;;CAiFlC,CAAA"}

package/dist/components/STable/utils/useTableServiceRows.d.ts

@@ -0,0 +1,57 @@
+import { type ComputedRef, type CSSProperties, type MaybeRefOrGetter } from 'vue';
+import type { ISTableColumn, ISTableDepthFooterConfig, ISTableFooterValue, TSTableDepthFooterSlotScope, TSTableFlatRow, TSTableLoadMoreSlotScope } from '../STable.types';
+import { type TSTableTreeNode } from './useFlatTableRows';
+export interface IUseTableServiceRowsOptions<TItem extends Record<string, unknown>> {
+    columns: MaybeRefOrGetter<readonly ISTableColumn<TItem>[]>;
+    primaryColumnKey: ComputedRef<string | undefined>;
+    /** Узлы индекса дерева: размер поддерева идёт в счётчик «загружено/всего» группы. */
+    treeNodeByKey: ComputedRef<ReadonlyMap<string, TSTableTreeNode<TItem>>>;
+    groupTotalKey: MaybeRefOrGetter<(keyof TItem & string) | undefined>;
+    depthFooter: MaybeRefOrGetter<ISTableDepthFooterConfig<TItem> | undefined>;
+    groupContentColumnKey: MaybeRefOrGetter<string | undefined>;
+    creationContentColumnKey: MaybeRefOrGetter<string | undefined>;
+    loadMoreContentColumnKey: MaybeRefOrGetter<string | undefined>;
+    treeIndent: MaybeRefOrGetter<number>;
+    loadingMoreChildrenKeys: MaybeRefOrGetter<readonly string[] | undefined>;
+    footerValues: MaybeRefOrGetter<Readonly<Record<string, ISTableFooterValue>> | undefined>;
+    /** Индекс футера, видимого прижатым у нижней кромки: слот должен знать своё состояние. */
+    stuckDepthFooterRowIndex: ComputedRef<number | undefined>;
+    onDepthFooterClick: (payload: {
+        parentKey: string;
+        parentItem: TItem;
+        depth: number;
+    }) => void;
+    onLoadMoreChildren: (payload: {
+        key: string;
+        item: TItem;
+    }) => void;
+}
+/**
+ * Служебные строки (группа, футер поддерева, «Показать ещё») и агрегатный футер.
+ *
+ * Общий принцип: контент такой строки живёт в конкретной колонке, а не растягивается
+ * через `colspan` — колоночная структура сохраняется, и при горизонтальном скролле
+ * контент не уезжает, потому что колонка по умолчанию главная и всегда sticky-left.
+ */
+export declare const useTableServiceRows: <TItem extends Record<string, unknown>>({ columns, primaryColumnKey, treeNodeByKey, groupTotalKey, depthFooter, groupContentColumnKey, creationContentColumnKey, loadMoreContentColumnKey, treeIndent, loadingMoreChildrenKeys, footerValues, stuckDepthFooterRowIndex, onDepthFooterClick, onLoadMoreChildren, }: IUseTableServiceRowsOptions<TItem>) => {
+    depthFooterColumnKey: ComputedRef<string | undefined>;
+    groupColumnKey: ComputedRef<string | undefined>;
+    creationColumnKey: ComputedRef<string | undefined>;
+    loadMoreColumnKey: ComputedRef<string | undefined>;
+    getGroupCount: (flatRow: TSTableFlatRow<TItem>) => number;
+    getGroupTotal: (flatRow: TSTableFlatRow<TItem>) => number | undefined;
+    getGroupTitle: (flatRow: TSTableFlatRow<TItem>) => string | undefined;
+    getDepthIndentStyle: (depth: number) => CSSProperties;
+    emitDepthFooterClick: (flatRow: TSTableFlatRow<TItem>) => void;
+    getDepthFooterSlotScope: (flatRow: TSTableFlatRow<TItem>) => TSTableDepthFooterSlotScope<TItem>;
+    isLoadMoreRowLoading: (flatRow: TSTableFlatRow<TItem>) => boolean;
+    emitLoadMoreChildren: (flatRow: TSTableFlatRow<TItem>) => void;
+    getLoadMoreSlotScope: (flatRow: TSTableFlatRow<TItem>) => TSTableLoadMoreSlotScope<TItem>;
+    getFooterValueText: (columnKey: string) => string;
+    getFooterToneClass: (columnKey: string) => string | undefined;
+    getFooterSlotScope: (columnKey: string) => {
+        column: ISTableColumn<TItem>;
+        footerValue: ISTableFooterValue | undefined;
+    };
+};
+//# sourceMappingURL=useTableServiceRows.d.ts.map

package/dist/components/STable/utils/useTableServiceRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableServiceRows.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableServiceRows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAEpG,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,2BAA2B,EAC3B,cAAc,EACd,wBAAwB,EACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,WAAW,2BAA2B,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChF,OAAO,EAAE,gBAAgB,CAAC,SAAS,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC1D,gBAAgB,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,qFAAqF;IACrF,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACvE,aAAa,EAAE,gBAAgB,CAAC,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,SAAS,CAAC,CAAA;IACnE,WAAW,EAAE,gBAAgB,CAAC,wBAAwB,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAA;IAC1E,qBAAqB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC3D,wBAAwB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC9D,wBAAwB,EAAE,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC9D,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACpC,uBAAuB,EAAE,gBAAgB,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IACxE,YAAY,EAAE,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;IACxF,0FAA0F;IAC1F,wBAAwB,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACzD,kBAAkB,EAAE,CAAC,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAC9F,kBAAkB,EAAE,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAA;CACpE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,2QAexE,2BAA2B,CAAC,KAAK,CAAC;;;;;6BAsBH,cAAc,CAAC,KAAK,CAAC;6BAIrB,cAAc,CAAC,KAAK,CAAC;6BAIrB,cAAc,CAAC,KAAK,CAAC;iCAUjB,MAAM,KAAG,aAAa;oCAMnB,cAAc,CAAC,KAAK,CAAC;uCASjD,cAAc,CAAC,KAAK,CAAC,KAC7B,2BAA2B,CAAC,KAAK,CAAC;oCAgBE,cAAc,CAAC,KAAK,CAAC;oCAQrB,cAAc,CAAC,KAAK,CAAC;oCASjD,cAAc,CAAC,KAAK,CAAC,KAC7B,wBAAwB,CAAC,KAAK,CAAC;oCAgBK,MAAM;oCAeN,MAAM;oCAMN,MAAM;;;;CA2B9C,CAAA"}

package/dist/components/STable/utils/useTableSorting.d.ts

@@ -0,0 +1,21 @@
+import { type Ref } from 'vue';
+import { ESTableSortDirection, type TSTableHeaderSlotScope, type TSTableSortEntry } from '../STable.types';
+import type { TSTableColumnDescriptor } from './useTableColumns';
+export interface IUseTableSortingOptions {
+    sortState: Ref<TSTableSortEntry[]>;
+    onSortChange: (sortEntries: TSTableSortEntry[]) => void;
+}
+/**
+ * Сортировка как намерение: кит не трогает данные, а держит индикаторы
+ * (`sortState`) и сообщает о смене наружу. Порядок записей в `sortState` — это
+ * порядок мультисортировки, он же даёт номера бейджей в шапке.
+ */
+export declare const useTableSorting: <TItem extends Record<string, unknown>>({ sortState, onSortChange, }: IUseTableSortingOptions) => {
+    getColumnSortDirection: (columnKey: string) => ESTableSortDirection | undefined;
+    getColumnSortIndex: (columnKey: string) => number | undefined;
+    applySortCycle: (columnKey: string, append: boolean) => void;
+    applySortExact: (columnKey: string, direction: ESTableSortDirection | undefined) => void;
+    getHeaderAriaSort: (descriptor: TSTableColumnDescriptor<TItem>) => "descending" | "ascending" | undefined;
+    getHeaderSlotScope: (descriptor: TSTableColumnDescriptor<TItem>) => TSTableHeaderSlotScope<TItem>;
+};
+//# sourceMappingURL=useTableSorting.d.ts.map

package/dist/components/STable/utils/useTableSorting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableSorting.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableSorting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAExC,OAAO,EACL,oBAAoB,EACpB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAEhE,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAA;IAClC,YAAY,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAA;CACxD;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,8BAGpE,uBAAuB;wCAKmB,MAAM;oCAIV,MAAM;gCAgBV,MAAM,UAAU,OAAO;gCA+BvB,MAAM,aAAa,oBAAoB,GAAG,SAAS;oCAwB/C,uBAAuB,CAAC,KAAK,CAAC;qCAevD,uBAAuB,CAAC,KAAK,CAAC,KACzC,sBAAsB,CAAC,KAAK,CAAC;CAoBjC,CAAA"}

package/dist/components/STable/utils/useTableStickyRows.d.ts

@@ -0,0 +1,38 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+import type { TSTableFlatRowsSnapshot } from './useFlatTableRows';
+export interface IUseTableStickyRowsOptions<TItem extends Record<string, unknown>> {
+    snapshot: ComputedRef<TSTableFlatRowsSnapshot<TItem>>;
+    /** Видимый диапазон строк (без overscan) от виртуализатора. */
+    visibleRange: ComputedRef<{
+        startIndex: number;
+        endIndex: number;
+    } | undefined>;
+    depthFooterSticky: MaybeRefOrGetter<boolean>;
+    /**
+     * Индекс строки у нижней кромки вьюпорта с поправкой на шапку и прижатые
+     * полосы tfoot: `range.endIndex` считает от начала tbody и указывает на
+     * строку, которая ниже видимой области на высоту этих полос.
+     */
+    bottomVisibleRowIndex: ComputedRef<number | undefined>;
+    /** Модельные офсеты строк от виртуализатора: запас прижатия футеров считается в px. */
+    getRowOffset: (rowIndex: number) => {
+        start: number;
+        end: number;
+    } | undefined;
+}
+/**
+ * Выбор «активных» sticky-строк по индексам (вердикт ресёрча sticky-строк):
+ * JS решает только, ЧЬИ ячейки получают `position: sticky`, — само прилипание,
+ * плавный вход и выход в поток делает CSS. Активный групп-хедер — глубочайшая
+ * группа, накрывающая верх вьюпорта; активный depth-футер — футер глубочайшего
+ * предка строки у нижней границы (вариант А: прижат, пока поддерево видимо).
+ */
+export declare const useTableStickyRows: <TItem extends Record<string, unknown>>({ snapshot, visibleRange, depthFooterSticky, bottomVisibleRowIndex, getRowOffset, }: IUseTableStickyRowsOptions<TItem>) => {
+    activeGroupRowIndex: ComputedRef<number | undefined>;
+    activeDepthFooterRowIndex: ComputedRef<number | undefined>;
+    activeDepthFooterRowIndexes: ComputedRef<number[]>;
+    leavingDepthFooterRowIndex: ComputedRef<number | undefined>;
+    slidingDepthFooterRowIndexes: ComputedRef<number[]>;
+    farDepthFooterRowIndexes: ComputedRef<number[]>;
+};
+//# sourceMappingURL=useTableStickyRows.d.ts.map

package/dist/components/STable/utils/useTableStickyRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableStickyRows.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableStickyRows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAOhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAOjE,MAAM,WAAW,0BAA0B,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/E,QAAQ,EAAE,WAAW,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAA;IACrD,+DAA+D;IAC/D,YAAY,EAAE,WAAW,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAA;IAC/E,iBAAiB,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC5C;;;;OAIG;IACH,qBAAqB,EAAE,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACtD,uFAAuF;IACvF,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC/E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,qFAMvE,0BAA0B,CAAC,KAAK,CAAC;;;;;;;CA2LnC,CAAA"}

package/dist/components/STable/utils/useTableStyleVars.d.ts

@@ -0,0 +1,22 @@
+import { type ComputedRef, type CSSProperties, type MaybeRefOrGetter } from 'vue';
+export interface IUseTableStyleVarsOptions {
+    /** Суммарная высота прилипших снизу полос tfoot (агрегат + строка создания). */
+    tfootBarStackHeight: ComputedRef<number>;
+    hasFooterValues: MaybeRefOrGetter<boolean>;
+    scrollClientWidth: MaybeRefOrGetter<number>;
+    columnCssVars: ComputedRef<Record<string, string>>;
+    totalWidth: ComputedRef<number>;
+    height: MaybeRefOrGetter<number | string | undefined>;
+    maxHeight: MaybeRefOrGetter<number | string | undefined>;
+}
+/**
+ * CSS-переменные блока: единственный источник размеров — константы `tableSizes`,
+ * поэтому в стилях нет дублей чисел, а ширины и sticky-офсеты колонок приезжают
+ * из `useTableColumns` уже посчитанными.
+ */
+export declare const useTableStyleVars: ({ tfootBarStackHeight, hasFooterValues, scrollClientWidth, columnCssVars, totalWidth, height, maxHeight, }: IUseTableStyleVarsOptions) => {
+    rootStyle: ComputedRef<CSSProperties>;
+    scrollStyle: ComputedRef<CSSProperties>;
+    tableStyle: ComputedRef<CSSProperties>;
+};
+//# sourceMappingURL=useTableStyleVars.d.ts.map

package/dist/components/STable/utils/useTableStyleVars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableStyleVars.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableStyleVars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAUpG,MAAM,WAAW,yBAAyB;IACxC,gFAAgF;IAChF,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACxC,eAAe,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAC1C,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC3C,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,EAAE,gBAAgB,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;IACrD,SAAS,EAAE,gBAAgB,CAAC,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACzD;AAUD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,4GAQ/B,yBAAyB;;;;CAqC3B,CAAA"}

package/dist/components/STable/utils/useTableVirtualRows.d.ts

@@ -0,0 +1,56 @@
+import { type MaybeRefOrGetter, type Ref } from 'vue';
+import { type VirtualItem, type Virtualizer } from '@tanstack/vue-virtual';
+import type { TSTableScrollAlign } from '../STable.types';
+export interface IUseTableVirtualRowsOptions {
+    rowCount: MaybeRefOrGetter<number>;
+    enabled: MaybeRefOrGetter<boolean>;
+    /** Замер фактических высот строк (rowHeightMode auto). */
+    autoMeasure: MaybeRefOrGetter<boolean>;
+    estimateRowSize: MaybeRefOrGetter<number>;
+    /** Оценка высоты конкретной строки (групповые/футерные ниже обычных). */
+    estimateRowSizeByIndex?: (rowIndex: number) => number | undefined;
+    overscan: MaybeRefOrGetter<number>;
+    scrollElement: Ref<HTMLElement | null>;
+    /** Ключ строки по индексу: кэш размеров живёт по ключу, а не по позиции. */
+    getRowKey: (rowIndex: number) => string | number;
+    /** Версия данных: смена (новый массив строк) сбрасывает кэш замеров. */
+    rowsVersion: MaybeRefOrGetter<unknown>;
+    /** Высота вьюпорта скроллера (clientHeight) — для сжатия прокрутки и выравнивания. */
+    viewportHeight: MaybeRefOrGetter<number>;
+    /** Шапка и полосы tfoot: входят в scrollHeight, но не в модельную высоту строк. */
+    extraHeight: MaybeRefOrGetter<number>;
+}
+/**
+ * Оконная математика поверх @tanstack/vue-virtual для спейсерной виртуализации:
+ * строки рендерятся in-flow, вырезанное компенсируют два спейсер-`<tr>` (формула
+ * TanStack discussion #476). Замер высот — ручной батч offsetHeight → resizeItem
+ * в post-flush (DOM-пул строк несовместим со штатным measureElement: ref-каллбек
+ * не перевызывается при смене data-index у переиспользованного элемента).
+ * resizeItem сам компенсирует scrollTop при перемере строк выше вьюпорта.
+ */
+export declare const useTableVirtualRows: ({ rowCount, enabled, autoMeasure, estimateRowSize, estimateRowSizeByIndex, overscan, scrollElement, getRowKey, rowsVersion, viewportHeight, extraHeight, }: IUseTableVirtualRowsOptions) => {
+    rowVirtualizer: Ref<Virtualizer<HTMLElement, Element>, Virtualizer<HTMLElement, Element>>;
+    virtualItems: import("vue").ComputedRef<VirtualItem[]>;
+    windowIndexes: import("vue").ComputedRef<number[]>;
+    totalSize: import("vue").ComputedRef<number>;
+    uiTotalSize: import("vue").ComputedRef<number>;
+    modelScrollOffset: import("vue").ComputedRef<number>;
+    scrollCompressed: import("vue").ComputedRef<boolean>;
+    measureWindowRows: () => void;
+    measureNewRows: () => void;
+    scrollToIndex: (rowIndex: number, align?: TSTableScrollAlign) => void;
+    visibleRange: import("vue").ComputedRef<{
+        startIndex: number;
+        endIndex: number;
+    } | undefined>;
+    getRowOffset: (rowIndex: number) => {
+        start: number;
+        end: number;
+    } | undefined;
+    getRowUiOffset: (rowIndex: number) => {
+        start: number;
+        end: number;
+    } | undefined;
+    getRowIndexAtOffset: (contentOffset: number) => number | undefined;
+};
+//# sourceMappingURL=useTableVirtualRows.d.ts.map

package/dist/components/STable/utils/useTableVirtualRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTableVirtualRows.d.ts","sourceRoot":"","sources":["../../../../src/components/STable/utils/useTableVirtualRows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,gBAAgB,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAE3F,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAKzD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAClC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAClC,0DAA0D;IAC1D,WAAW,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACtC,eAAe,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACzC,yEAAyE;IACzE,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACjE,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAClC,aAAa,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACtC,4EAA4E;IAC5E,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAA;IAChD,wEAAwE;IACxE,WAAW,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACtC,sFAAsF;IACtF,cAAc,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACxC,mFAAmF;IACnF,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;CACtC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,4JAYjC,2BAA2B;;;;;;;;;;8BA2UK,MAAM,UAAS,kBAAkB;;;;;6BAsDlC,MAAM;;;;+BAWJ,MAAM;;;;yCAxCI,MAAM;CAoEnD,CAAA"}

package/dist/composables/treeKeyboardNavigation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Структурный минимум строки дерева: и SList, и STable кладут сюда свои плоские строки.
+ * Утилита не знает ни про item, ни про вид строки — только про связи родитель/потомки.
+ */
+export type TTreeNavigationRow = {
+    key: string;
+    depth: number;
+    hasChildren: boolean;
+    expanded: boolean;
+    parentKey?: string;
+};
+export type TTreeKeyboardNavigationAction = {
+    type: 'select';
+    rowKey: string;
+} | {
+    type: 'expand';
+    rowKey: string;
+} | {
+    type: 'collapse';
+    rowKey: string;
+};
+export declare const resolveListSelectionAnchorKey: (currentKey: string, selectedKey: string | string[] | undefined) => string;
+export declare const listHasTreeStructure: <TRow extends TTreeNavigationRow>(flatRows: readonly TRow[]) => boolean;
+export declare const resolveTreeKeyboardNavigationAction: <TRow extends TTreeNavigationRow>(key: "ArrowLeft" | "ArrowRight", anchorKey: string, flatRows: readonly TRow[]) => TTreeKeyboardNavigationAction | null;
+export declare const resolveTreeVerticalNavigationTarget: <TRow extends TTreeNavigationRow>(key: "ArrowUp" | "ArrowDown", anchorKey: string, flatRows: readonly TRow[]) => string | null;
+//# sourceMappingURL=treeKeyboardNavigation.d.ts.map

package/dist/composables/treeKeyboardNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treeKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../src/composables/treeKeyboardNavigation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,6BAA6B,GACrC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC,eAAO,MAAM,6BAA6B,GACxC,YAAY,MAAM,EAClB,aAAa,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,WAW3C,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,IAAI,SAAS,kBAAkB,EAClE,UAAU,SAAS,IAAI,EAAE,YAG1B,CAAA;AAyCD,eAAO,MAAM,mCAAmC,GAAI,IAAI,SAAS,kBAAkB,EACjF,KAAK,WAAW,GAAG,YAAY,EAC/B,WAAW,MAAM,EACjB,UAAU,SAAS,IAAI,EAAE,KACxB,6BAA6B,GAAG,IAUlC,CAAA;AAuBD,eAAO,MAAM,mCAAmC,GAAI,IAAI,SAAS,kBAAkB,EACjF,KAAK,SAAS,GAAG,WAAW,EAC5B,WAAW,MAAM,EACjB,UAAU,SAAS,IAAI,EAAE,kBAoB1B,CAAA"}