@feugene/granularity 0.43.0 → 0.45.0

package/dist/types/components/GrScrollSpy/index.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrScrollSpyComponent from './GrScrollSpy.vue';
+export { default } from './GrScrollSpy.vue';
+export { default as GrScrollSpy } from './GrScrollSpy.vue';
+export type { GrScrollSpyEmits, GrScrollSpyProps } from './GrScrollSpy.vue';
+export type { GrScrollSpySection } from './scrollSpyItems';
+export { grScrollSpyConfig } from './config';
+export { grScrollSpySafelist } from './safelist';
+export type GrScrollSpyInstance = ComponentExposed<typeof GrScrollSpyComponent>;

package/dist/types/components/GrScrollSpy/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grScrollSpySafelist: string[];

package/dist/types/components/GrScrollSpy/scrollSpyItems.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Арифметика пунктов оглавления: всё, что следует из того, что пункт —
+ * **ссылка**, а не из положения прокрутки. Положение живёт в
+ * `composables/internal/scrollSpyGeometry.ts`.
+ */
+/** Раздел в оглавлении. */
+export interface GrScrollSpySection {
+    id: string;
+    label: string;
+    /** Уровень вложенности, 1 — верхний. Влияет на отступ и цепочку предков. */
+    level?: number;
+}
+/**
+ * Значение пропа `offset` в CSS-длину для инлайновой переменной.
+ *
+ * Строка уходит как есть и намеренно не валидируется: `4rem`,
+ * `var(--gr-navbar-height)`, `calc(…)` обязаны работать — иначе проп проигрывает
+ * голому `style`. Отрицательное зажимается в ноль: линия активации выше верха
+ * скроллпорта смысла не имеет.
+ */
+export declare function scrollSpyOffsetLength(value: number | string | undefined): string | undefined;
+/**
+ * Наш ли это клик.
+ *
+ * Пункт остаётся `<a href="#id">` ровно ради того, что браузер умеет с ссылкой
+ * сам: `Cmd`-клик открывает в новой вкладке, средняя кнопка — тоже. Перехватив
+ * их, компонент отнял бы у пользователя работающее поведение и ничего не дал
+ * взамен.
+ */
+export declare function anchorClickHandled(event: {
+    button: number;
+    metaKey: boolean;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+    defaultPrevented: boolean;
+}): boolean;
+/**
+ * Предки активного пункта — те разделы выше по списку, чей уровень мельче.
+ *
+ * Считается по документному порядку массива, а не по дереву: дерево позволило
+ * бы объявить вложенность, противоречащую порядку разделов на странице.
+ */
+export declare function ancestorSectionIds(sections: readonly GrScrollSpySection[], activeId: string | null): Set<string>;

package/dist/types/components/GrTree/grTreeProps.d.ts

@@ -9,6 +9,7 @@ export type GrTreePropsMap = {
     isLeaf?: string;
 };
 export type GrTreeFilterNodeMethod<T extends object = any> = (value: string, data: T, node?: GrTreeNode<T>) => boolean;
+export type GrTreeBranchLine = 'line' | 'elbow';
 export type GrTreeBranchLineColor<T extends object = any> = string | ((node: GrTreeNode<T>) => string | undefined | null);
 export type GrTreeVisibleRow<T extends object> = {
     node: GrTreeNode<T>;
@@ -89,7 +90,13 @@ export type GrTreeViewProps<T extends object> = {
     /** Иконка раскрытого узла. Не задана — та же встроенная стрелка, повёрнутая. */
     collapseIcon?: string | Component;
     toggleIconRotate?: boolean;
-    branchLine?: boolean;
+    /**
+     * Направляющие уровней. `true` — то же, что `'line'`: одна вертикаль на
+     * уровень. `'elbow'` добавляет горизонтальное колено к строке и обрывает
+     * линию на середине последнего ребёнка — так видно не только уровень, но и
+     * то, какие ветки ещё продолжаются.
+     */
+    branchLine?: boolean | GrTreeBranchLine;
     branchLineColor?: GrTreeBranchLineColor<T>;
     branchLineActiveColor?: GrTreeBranchLineColor<T>;
     rowClass?: GrTreeNodeClass<T>;

package/dist/types/components/GrTree/grTreeStyles.d.ts

@@ -20,3 +20,15 @@ export type GrTreeSizeVars = {
     '--gr-tree-font-size': string;
 };
 export declare const treeSizeVars: Record<GrTreeSize, GrTreeSizeVars>;
+/**
+ * Готовые виды дерева — наборы значений тех же `--gr-tree-*`, что задаёт
+ * `size`. Не проп: второй канал спорил бы с размером за одни переменные, а
+ * набор с ним композируется — потребитель раскладывает его в `style` и при
+ * необходимости переопределяет по одной строке.
+ *
+ * Шрифт и значки в набор не входят: семейства у дерева своего токена нет, а
+ * значки — это `expandIcon`/`collapseIcon` и слот строки, то есть решение
+ * потребителя, а не вида.
+ */
+export type GrTreeView = 'explorer' | 'rail' | 'outline';
+export declare const grTreeViewVars: Record<GrTreeView, Record<string, string>>;

package/dist/types/components/GrTree/index.d.ts

@@ -2,9 +2,10 @@ export { default } from './GrTree.vue';
 export { default as GrTree } from './GrTree.vue';
 export type { GrTreeAllowDropType, GrTreeInstance, GrTreeKey, GrTreeNode, GrTreeNodeDropType, GrTreeNodeTarget, } from './grTreeTypes';
 export type { GrTreeBranchLineColor, GrTreeFilterNodeMethod, GrTreeLoad, GrTreeNodeClass, GrTreeProps, GrTreePropsMap, GrTreeSelectionProps, GrTreeVisibleRow, } from './grTreeProps';
-export type { GrTreeCheckState } from './grTreeChecking';
+export type { GrTreeCheckState } from '../../composables/internal/treeChecking';
 export { grTreeConfig } from './config';
 export type { GrTreeConfigurableProps } from './defaults';
-export type { GrTreeSize } from './grTreeStyles';
+export { grTreeViewVars } from './grTreeStyles';
+export type { GrTreeSize, GrTreeView } from './grTreeStyles';
 export { grTreeSafelist } from './safelist';
 export type { GrTreeEmits } from './GrTree.vue';

package/dist/types/components/GrTreeSections/GrTreeSections.vue.d.ts

@@ -0,0 +1,71 @@
+import type { GrTreeKey, GrTreeNode } from '../GrTree/grTreeTypes';
+import type { GrTreeBranchLine, GrTreeDataProps, GrTreePropsMap } from '../GrTree/grTreeProps';
+import type { GrComponentSize } from '../shared/sizes';
+/**
+ * GrTreeSections — дерево, у которого верхний уровень стал рубрикой.
+ *
+ * Внутри это не одно дерево с заголовками между строк, а **несколько деревьев**:
+ * `role="tree"` требует, чтобы его детьми были `treeitem`, и заголовок посреди
+ * них либо ломал бы паттерн, либо врал диктору, оставаясь строкой. Заголовки
+ * между отдельными деревьями законны, и каждая группа объявляется сама собой.
+ *
+ * Отсюда же граница: клавиатурное кольцо у каждой группы своё, `Tab` переходит
+ * между ними. Это верно по существу — группы независимы.
+ */
+export interface GrTreeSectionsProps<TData extends object = any> {
+    /** Данные обычного дерева. Корни становятся заголовками, их дети — деревьями. */
+    data: TData[];
+    nodeKey?: GrTreeDataProps<TData>['nodeKey'];
+    props?: GrTreePropsMap;
+    size?: GrComponentSize;
+    /** Уровень заголовка группы под структуру страницы. */
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    /** Показывать число узлов первого уровня в группе. */
+    showCount?: boolean;
+    showCheckbox?: boolean;
+    checkStrictly?: boolean;
+    branchLine?: boolean | GrTreeBranchLine;
+    indent?: number;
+    defaultExpandedKeys?: GrTreeKey[];
+    currentKey?: GrTreeKey;
+    checkedKeys?: GrTreeKey[];
+}
+export interface GrTreeSectionsEmits {
+    (e: 'update:currentKey', key: GrTreeKey | undefined): void;
+    (e: 'update:checkedKeys', keys: GrTreeKey[]): void;
+    (e: 'nodeClick', data: any, node: GrTreeNode<any>): void;
+}
+declare const __VLS_export: <T extends Record<string, any> = any>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & __VLS_PrettifyLocal<GrTreeSectionsProps<T> & {
+        onNodeClick?: ((data: any, node: GrTreeNode<any>) => any) | undefined;
+        "onUpdate:currentKey"?: ((key: GrTreeKey | undefined) => any) | undefined;
+        "onUpdate:checkedKeys"?: ((keys: GrTreeKey[]) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        /** Заголовок группы целиком — вместо подписи корневого узла. */
+        heading?: (props: {
+            data: T;
+            label: string;
+            count: number;
+        }) => unknown;
+        /** Строка внутри группы, как у `GrTree`. */
+        default?: (props: {
+            node: GrTreeNode<T>;
+            data: T;
+        }) => unknown;
+    };
+    emit: GrTreeSectionsEmits;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrTreeSections/config.d.ts

@@ -0,0 +1 @@
+export declare const grTreeSectionsConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrTreeSections">;

package/dist/types/components/GrTreeSections/grTreeSectionsStyles.d.ts

@@ -0,0 +1,8 @@
+export declare const treeSectionsRootClass = "flex flex-col gap-4";
+/**
+ * Заголовок группы набирается капителью и отделяется линией: он объявляет
+ * рубрику, а не узел, и должен читаться иначе, чем строки под ним.
+ */
+export declare const treeSectionsHeadClass = "flex items-baseline gap-2 pb-1 text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-xs)] uppercase tracking-wider text-[var(--gr-muted-fg)] border-b border-[var(--gr-brd)]";
+export declare const treeSectionsCountClass = "ml-auto text-[var(--gr-muted-fg)] [font-variant-numeric:tabular-nums]";
+export declare const treeSectionsGroupClass = "flex flex-col gap-1";

package/dist/types/components/GrTreeSections/index.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrTreeSectionsComponent from './GrTreeSections.vue';
+export { default } from './GrTreeSections.vue';
+export { default as GrTreeSections } from './GrTreeSections.vue';
+export type { GrTreeSectionsEmits, GrTreeSectionsProps } from './GrTreeSections.vue';
+export { grTreeSectionsConfig } from './config';
+export { grTreeSectionsSafelist } from './safelist';
+export type GrTreeSectionsInstance = ComponentExposed<typeof GrTreeSectionsComponent>;

package/dist/types/components/GrTreeSections/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grTreeSectionsSafelist: string[];

package/dist/types/composables/internal/scrollSpyGeometry.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Арифметика положения чтения: чистые функции без DOM и без реактивности.
+ *
+ * Вынесена отдельно по той же причине, что и геометрия перестановки в
+ * `dragSortGeometry.ts`: ошибка здесь проявляется не исключением, а
+ * «подсветился не тот раздел», и поймать это можно только тестом на числах. В
+ * jsdom проверить нечем вовсе — там нет ни прокрутки, ни раскладки.
+ *
+ * Композабл `useScrollSpy` сводит `DOMRect` к числам и зовёт эти функции; что
+ * значит активный раздел для разметки, решает уже компонент.
+ */
+/** Верх раздела в координатах вьюпорта. */
+export interface ScrollSpyRect {
+    id: string;
+    top: number;
+}
+/**
+ * Какой раздел читают сейчас.
+ *
+ * Правило — «последний, чей верх выше линии», а не «самый видимый». Максимум
+ * доли пересечения ошибается двумя способами: длинный раздел выигрывает у
+ * короткого независимо от того, что читают, и подсветка отскакивает назад,
+ * когда следующий раздел только показался снизу. Здесь ответ — заголовок,
+ * ближайший сверху к линии чтения.
+ *
+ * Порядок массива на ответ не влияет: выбор идёт по геометрии. Это снимает
+ * класс дефектов, где объявленный список разошёлся с порядком разделов на
+ * странице — подсветку в таком случае невозможно отладить.
+ *
+ * `atEnd` побеждает правило линии, и без него последний раздел недостижим:
+ * раздел короче остатка скроллпорта никогда не доводит свой верх до линии,
+ * потому что прокрутка кончается раньше.
+ */
+export declare function activeSectionId(rects: readonly ScrollSpyRect[], line: number, atEnd: boolean): string | null;
+/**
+ * `rootMargin` наблюдателя: верх корня поджимается на отступ, и тогда его край
+ * совпадает с линией активации.
+ *
+ * Единицы только `px`: `rootMargin` произвольных длин не принимает, поэтому
+ * отступ приходит сюда уже замеренным.
+ */
+export declare function scrollSpyRootMargin(offsetPx: number): string;
+/**
+ * Куда прокрутить скроллпорт, чтобы верх раздела встал на линию активации.
+ *
+ * Своя арифметика вместо `scrollIntoView` — по трём независимым причинам:
+ * тот двигает всех предков (у карусели это стоило прыжка страницы на каждом
+ * шаге автопрокрутки), не умеет наш отступ, и в jsdom отсутствует вовсе, то
+ * есть клик стал бы непроверяемым.
+ */
+export declare function scrollSpyTargetTop(scrollTop: number, sectionTop: number, portTop: number, offset: number, maxScrollTop: number): number;
+/**
+ * Прокручивается ли предок.
+ *
+ * Читается вычисленный `overflow-y`, а не объявленный: при
+ * `overflow-x: hidden; overflow-y: visible` спецификация превращает вычисленный
+ * `overflow-y` в `auto`, то есть предок действительно становится скроллпортом.
+ */
+export declare function isScrollableOverflow(overflowY: string): boolean;
+/**
+ * Доехали ли до дна.
+ *
+ * `maxScrollTop > 1` — обязательное условие, а не перестраховка: содержимое
+ * короче скроллпорта даёт «дно» на нулевой прокрутке, и правило `atEnd`
+ * подсветило бы последний раздел на странице, где позиции чтения нет вовсе.
+ */
+export declare function isScrolledToEnd(scrollTop: number, maxScrollTop: number): boolean;

package/dist/types/{components/GrTree/grTreeDataAdapter.d.ts → composables/internal/treeAdapter.d.ts}

@@ -1,5 +1,5 @@
-import type { GrTreeKey } from './grTreeTypes';
-import type { GrTreeDataProps } from './grTreeProps';
+import type { GrTreeKey } from '../../components/GrTree/grTreeTypes';
+import type { GrTreeDataProps } from '../../components/GrTree/grTreeProps';
 export type GrTreeDataAdapterOptions<T extends object> = Pick<GrTreeDataProps<T>, 'props' | 'nodeKey'>;
 export type GrTreeDataAdapter<T extends object> = {
     hasNodeKey: () => boolean;
@@ -13,4 +13,4 @@ export type GrTreeDataAdapter<T extends object> = {
     getNodeKey: (data: T, index: number, parentKey: GrTreeKey | undefined) => GrTreeKey;
     getExplicitNodeKey: (data: T) => GrTreeKey | undefined;
 };
-export declare function createGrTreeDataAdapter<T extends Record<string, any> = any>(options: GrTreeDataAdapterOptions<T>): GrTreeDataAdapter<T>;
+export declare function createGrTreeDataAdapter<T extends object>(options: GrTreeDataAdapterOptions<T>): GrTreeDataAdapter<T>;

package/dist/types/{components/GrTree/grTreeChecking.d.ts → composables/internal/treeChecking.d.ts}

@@ -1,4 +1,4 @@
-import type { GrTreeKey, GrTreeNode } from './grTreeTypes';
+import type { GrTreeKey, GrTreeNode } from '../../components/GrTree/grTreeTypes';
 /**
  * Состояние отметки узла. `half` — часть потомков отмечена: в ARIA это
  * `aria-checked="mixed"`.

package/dist/types/composables/useScrollSpy.d.ts

@@ -0,0 +1,59 @@
+import type { Ref } from 'vue';
+/**
+ * Отслеживание того, до какого раздела дочитали.
+ *
+ * Композабл владеет всем, что следует из **положения прокрутки**: линией
+ * активации, выбором раздела, прокруткой к нему и закрепом на время этой
+ * прокрутки. Всё, что следует из того, что пункт оглавления является
+ * **ссылкой** — разметка, `aria-current`, модификаторы клика, — остаётся у
+ * компонента `GrScrollSpy`.
+ *
+ * ```ts
+ * const spy = useScrollSpy({
+ *   sections: () => ids.value,
+ *   offset: () => headerHeight.value,
+ *   onChange: id => emit('activeChange', id),
+ * })
+ * ```
+ */
+export interface UseScrollSpyOptions {
+    /**
+     * Идентификаторы разделов. Порядок задаёт порядок пунктов у потребителя, но
+     * на ответ не влияет: активный выбирается по геометрии.
+     */
+    sections: () => readonly string[];
+    /**
+     * Элемент раздела. По умолчанию — `document.getElementById`.
+     *
+     * Дефолт не догадка: идентификаторы разделов и есть цели ссылок `#id`, то
+     * есть DOM-id по определению жанра.
+     */
+    elementFor?: (id: string) => HTMLElement | null | undefined;
+    /** Скроллпорт. Не задан — ищется от первого раздела, не найден — документ. */
+    scroller?: () => HTMLElement | null | undefined;
+    /**
+     * Отступ линии активации от верха скроллпорта, **в пикселях**.
+     *
+     * Именно число, а не CSS-длина: резолв `4rem` или `var(...)` требует
+     * `getComputedStyle`, то есть DOM, — а композабл обязан оставаться
+     * проверяемым без него. Длину резолвит потребитель.
+     */
+    offset?: () => number;
+    /** Наблюдение выключено: `active` сбрасывается в `null`. */
+    disabled?: () => boolean;
+    /** Активный сменился. Зовётся на смене, а не на каждой записи наблюдателя. */
+    onChange?: (id: string | null, previous: string | null) => void;
+}
+export interface UseScrollSpyReturn {
+    /** Активный раздел. `null` — линия ещё не дошла до первого. */
+    active: Readonly<Ref<string | null>>;
+    /** Прокрутить к разделу и закрепить его активным до следующей прокрутки. */
+    scrollTo: (id: string, options?: {
+        behavior?: ScrollBehavior;
+    }) => void;
+    /** Перечитать отступ, скроллпорт и геометрию. */
+    refresh: () => void;
+    /** Закрепить активным вручную: страницу прокручивает не оглавление. */
+    pin: (id: string | null) => void;
+}
+export declare function useScrollSpy(options: UseScrollSpyOptions): UseScrollSpyReturn;

package/dist/types/composables/useTree.d.ts

@@ -0,0 +1,107 @@
+import type { ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
+import type { GrTreeKey, GrTreeNode, GrTreeNodeDropType, GrTreeNodeTarget } from '../components/GrTree/grTreeTypes';
+import type { GrTreeDataAdapter } from './internal/treeAdapter';
+import type { GrTreeDataProps, GrTreeLoad, GrTreePropsMap, GrTreeVisibleRow } from '../components/GrTree/grTreeProps';
+import type { GrTreeCheckState, GrTreeCheckStates } from './internal/treeChecking';
+export type GrTreeModel<T extends object> = {
+    roots: GrTreeNode<T>[];
+    byKey: Map<GrTreeKey, GrTreeNode<T>>;
+    byData: WeakMap<T, GrTreeNode<T>>;
+};
+export type GrTreeFilterInfo = {
+    isActive: boolean;
+    subtreeHasMatch: Map<GrTreeKey, boolean>;
+    matchedKeys: Set<GrTreeKey>;
+    autoExpandKeys: Set<GrTreeKey>;
+};
+export type UseTreeOptions<T extends object> = {
+    data: MaybeRefOrGetter<GrTreeDataProps<T>['data']>;
+    defaultExpandedKeys?: MaybeRefOrGetter<GrTreeDataProps<T>['defaultExpandedKeys']>;
+    defaultExpandAll?: MaybeRefOrGetter<boolean | undefined>;
+    /**
+     * Совпал ли узел с запросом фильтра.
+     *
+     * Обычная функция, а не `MaybeRefOrGetter`: `toValue` не отличает геттер от
+     * значения-функции и вызвал бы её вместо того, чтобы вернуть. Реактивность
+     * при этом не теряется — потребитель читает своё состояние внутри вызова.
+     */
+    /**
+     * Совпал ли узел с запросом. Вернуть `undefined` — оставить решение модели
+     * (подстрочный матч по подписи).
+     */
+    filterNodeMethod?: (value: string, data: T, node: GrTreeNode<T>) => boolean | undefined;
+    defaultCheckedKeys?: MaybeRefOrGetter<GrTreeKey[] | undefined>;
+    /** Внешние отмеченные ключи (`v-model:checked-keys`), если потребитель их ведёт. */
+    checkedKeys?: MaybeRefOrGetter<GrTreeKey[] | undefined>;
+    checkStrictly?: MaybeRefOrGetter<boolean | undefined>;
+    lazy?: MaybeRefOrGetter<boolean | undefined>;
+    /** Загрузка детей ветки. Обычная функция — по той же причине, что `filterNodeMethod`. */
+    load?: GrTreeLoad<T>;
+    /** Форма данных: поля детей, подписи и признака листа. */
+    props?: GrTreePropsMap;
+    /** Поле-идентификатор узла. */
+    nodeKey?: GrTreeDataProps<T>['nodeKey'];
+    /**
+     * Готовый адаптер. Не задан — собирается из `props` и `nodeKey`.
+     *
+     * Необязателен намеренно: фабрика адаптера наружу не публикуется, и
+     * требовать её значило бы сделать композабл невызываемым вне пакета.
+     * Компонент передаёт свой, потому что уже собрал его для себя.
+     */
+    adapter?: GrTreeDataAdapter<T>;
+    /**
+     * Цвет направляющей уровня для узла. Не задан — `branchColors` у строк
+     * остаётся пустым: направляющие рисует потребитель, и модель о них не знает.
+     *
+     * Обычная функция, а не `MaybeRefOrGetter`: `toValue` не отличает геттер от
+     * значения-функции и вызвал бы её вместо того, чтобы вернуть.
+     */
+    branchColorFor?: (node: GrTreeNode<T>) => string | undefined | null;
+};
+export type UseTreeReturn<T extends object> = {
+    filterValue: Ref<string>;
+    expandedKeys: ShallowRef<Set<GrTreeKey>>;
+    checkedKeys: ShallowRef<Set<GrTreeKey>>;
+    checkStates: ComputedRef<GrTreeCheckStates>;
+    loadingKeys: ShallowRef<Set<GrTreeKey>>;
+    loadedKeys: ShallowRef<Set<GrTreeKey>>;
+    loadedChildren: ShallowRef<Map<GrTreeKey, T[]>>;
+    currentKey: Ref<GrTreeKey | undefined>;
+    /**
+     * Видимые строки одним плоским списком в порядке отображения — то, из чего
+     * строится разметка. Иерархию несут `node.level`, `posInSet` и `setSize`:
+     * в плоском DOM группы нет, и структуру диктору сообщают они.
+     */
+    visibleRows: ComputedRef<GrTreeVisibleRow<T>[]>;
+    treeModel: ComputedRef<GrTreeModel<T>>;
+    filterInfo: ComputedRef<GrTreeFilterInfo>;
+    filter: (value: string) => void;
+    isExpandedKey: (key: GrTreeKey) => boolean;
+    setExpandedKey: (key: GrTreeKey, expanded: boolean) => void;
+    toggleExpand: (node: GrTreeNode<T>) => void;
+    setCurrentKey: (key?: GrTreeKey) => void;
+    getCurrentKey: () => GrTreeKey | undefined;
+    getCurrentNode: () => GrTreeNode<T> | undefined;
+    setCurrentNode: (node?: GrTreeNodeTarget<T>) => boolean;
+    getNode: (key: GrTreeKey) => GrTreeNode<T> | undefined;
+    canMoveNode: (node: GrTreeNodeTarget<T>, referenceNode: GrTreeNodeTarget<T>, dropType: GrTreeNodeDropType) => boolean;
+    moveNode: (node: GrTreeNodeTarget<T>, referenceNode: GrTreeNodeTarget<T>, dropType: GrTreeNodeDropType) => GrTreeNode<T> | undefined;
+    appendNode: (data: T, parent: GrTreeNodeTarget<T>) => GrTreeNode<T> | undefined;
+    removeNode: (node: GrTreeNodeTarget<T>) => boolean;
+    insertNodeBefore: (data: T, referenceNode: GrTreeNodeTarget<T>) => GrTreeNode<T> | undefined;
+    insertNodeAfter: (data: T, referenceNode: GrTreeNodeTarget<T>) => GrTreeNode<T> | undefined;
+    getCheckState: (key: GrTreeKey) => GrTreeCheckState;
+    setChecked: (node: GrTreeNodeTarget<T>, checked: boolean) => GrTreeNode<T> | undefined;
+    toggleChecked: (node: GrTreeNode<T>) => GrTreeNode<T> | undefined;
+    getCheckedKeys: (options?: {
+        leafOnly?: boolean;
+    }) => GrTreeKey[];
+    setCheckedKeys: (keys: GrTreeKey[]) => void;
+    getHalfCheckedKeys: () => GrTreeKey[];
+    /** Лист ли узел с точки зрения раскрытия: в ленивом режиме решают данные и факт загрузки. */
+    isLeafNode: (node: GrTreeNode<T>) => boolean;
+    isLoadingKey: (key: GrTreeKey) => boolean;
+    /** Грузит детей ветки, если это нужно и ещё не делалось. */
+    ensureLoaded: (node: GrTreeNode<T>) => void;
+};
+export declare function useTree<T extends object>(options: UseTreeOptions<T>): UseTreeReturn<T>;

package/dist/types/granular-provider/shared.d.ts

@@ -70,6 +70,7 @@ export declare const granularityComponentConfigs: {
     GrRadioGroup: GranularComponentDescriptor<"GrRadioGroup">;
     GrRating: GranularComponentDescriptor<"GrRating">;
     GrResponseErrorBanner: GranularComponentDescriptor<"GrResponseErrorBanner">;
+    GrScrollSpy: GranularComponentDescriptor<"GrScrollSpy">;
     GrSegmented: GranularComponentDescriptor<"GrSegmented">;
     GrSelect: GranularComponentDescriptor<"GrSelect">;
     GrSidebar: GranularComponentDescriptor<"GrSidebar">;
@@ -89,6 +90,7 @@ export declare const granularityComponentConfigs: {
     GrTooltip: GranularComponentDescriptor<"GrTooltip">;
     GrTransfer: GranularComponentDescriptor<"GrTransfer">;
     GrTree: GranularComponentDescriptor<"GrTree">;
+    GrTreeSections: GranularComponentDescriptor<"GrTreeSections">;
     GrTreeSelect: GranularComponentDescriptor<"GrTreeSelect">;
     GrValue: GranularComponentDescriptor<"GrValue">;
 };

package/dist/types/i18n/messages/en.d.ts

@@ -176,6 +176,9 @@ export declare const en: {
                 navbar: {
                     openMenu: string;
                 };
+                scrollSpy: {
+                    label: string;
+                };
                 responseError: {
                     networkTitle: string;
                     networkMessage: string;
@@ -566,6 +569,9 @@ export declare const en: {
             navbar: {
                 openMenu: string;
             };
+            scrollSpy: {
+                label: string;
+            };
             responseError: {
                 networkTitle: string;
                 networkMessage: string;

package/dist/types/i18n/messages/es.d.ts

@@ -170,6 +170,9 @@ export declare const es: {
                 navbar: {
                     openMenu: string;
                 };
+                scrollSpy: {
+                    label: string;
+                };
                 responseError: {
                     networkTitle: string;
                     networkMessage: string;
@@ -562,6 +565,9 @@ export declare const es: {
             navbar: {
                 openMenu: string;
             };
+            scrollSpy: {
+                label: string;
+            };
             responseError: {
                 networkTitle: string;
                 networkMessage: string;

package/dist/types/i18n/messages/ru.d.ts

@@ -171,6 +171,9 @@ export declare const ru: {
                 navbar: {
                     openMenu: string;
                 };
+                scrollSpy: {
+                    label: string;
+                };
                 responseError: {
                     networkTitle: string;
                     networkMessage: string;
@@ -565,6 +568,9 @@ export declare const ru: {
             navbar: {
                 openMenu: string;
             };
+            scrollSpy: {
+                label: string;
+            };
             responseError: {
                 networkTitle: string;
                 networkMessage: string;

package/dist/types/index.d.ts

@@ -57,6 +57,7 @@ export * from './components/GrRadio';
 export * from './components/GrRadioGroup';
 export * from './components/GrRating';
 export * from './components/GrResponseErrorBanner';
+export * from './components/GrScrollSpy';
 export * from './components/GrSegmented';
 export * from './components/GrSelect';
 export * from './components/GrSidebar';
@@ -76,6 +77,7 @@ export * from './components/GrToaster';
 export * from './components/GrTooltip';
 export * from './components/GrTransfer';
 export * from './components/GrTree';
+export * from './components/GrTreeSections';
 export * from './components/GrTreeSelect';
 export * from './components/GrValue';
 export { useDismissible } from './composables/useDismissible';
@@ -86,6 +88,10 @@ export { usePortalTarget } from './composables/usePortalTarget';
 export type { PortalTarget } from './composables/usePortalTarget';
 export { useOverlayLayer } from './composables/useOverlayLayer';
 export type { OverlayLayerHandle, UseOverlayLayerOptions } from './composables/useOverlayLayer';
+export { useTree } from './composables/useTree';
+export type { GrTreeFilterInfo, GrTreeModel, UseTreeOptions, UseTreeReturn, } from './composables/useTree';
+export { useScrollSpy } from './composables/useScrollSpy';
+export type { UseScrollSpyOptions, UseScrollSpyReturn } from './composables/useScrollSpy';
 export { useRovingFocus } from './composables/useRovingFocus';
 export type { GrRovingEdge, GrRovingOrientation, UseRovingFocusOptions, UseRovingFocusReturn, } from './composables/useRovingFocus';
 export * from './composables/useGrComponentConfig';