@feugene/granularity 0.12.0 → 0.16.0

package/dist/types/src/components/GrTimeline/grTimelineStyles.d.ts

@@ -0,0 +1,37 @@
+import type { GrTone } from '../shared/tones';
+export type GrTimelineTone = GrTone;
+/** Плотность вертикальных отступов пункта — та же ось, что `density` у `GrListItem`. */
+export declare const GR_TIMELINE_DENSITIES: readonly ["regular", "compact"];
+export type GrTimelineDensity = typeof GR_TIMELINE_DENSITIES[number];
+/**
+ * `stacked` — одна ось слева; `time` — метка времени отдельной колонкой слева от
+ * оси; `alternate` — пункты попеременно по обе стороны центральной оси.
+ */
+export declare const GR_TIMELINE_LAYOUTS: readonly ["stacked", "time", "alternate"];
+export type GrTimelineLayout = typeof GR_TIMELINE_LAYOUTS[number];
+export declare const GR_TIMELINE_ORIENTATIONS: readonly ["vertical", "horizontal"];
+export type GrTimelineOrientation = typeof GR_TIMELINE_ORIENTATIONS[number];
+/** Заполненная точка — событие случилось; полая — запланировано. */
+export declare const GR_TIMELINE_MARKER_VARIANTS: readonly ["filled", "outlined"];
+export type GrTimelineMarkerVariant = typeof GR_TIMELINE_MARKER_VARIANTS[number];
+/**
+ * Отступ **под** пунктом, а не `gap` контейнера: отрезок оси растёт до низа
+ * пункта, и промежуток, которого пункт не занимает, разорвал бы линию.
+ */
+export declare const densityPadding: Record<GrTimelineDensity, string>;
+/**
+ * Заливка маркера. У тона `neutral` одноимённой роли в палитре нет — его вес
+ * это приглушённый текст, поэтому точка красится `--gr-muted-fg`.
+ */
+export declare const markerFilledToneClass: Record<GrTimelineTone, string>;
+/** Полая точка: обводка тоном, середина — фон страницы, чтобы ось не просвечивала. */
+export declare const markerOutlinedToneClass: Record<GrTimelineTone, string>;
+export declare const markerBaseClass = "block shrink-0 rounded-[var(--gr-radius-full)]";
+export declare const timeClass = "text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)] [font-variant-numeric:tabular-nums]";
+export declare const titleClass = "text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] font-600 text-[var(--gr-fg)]";
+export declare const descriptionClass = "mt-0.5 text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)]";
+export declare const groupTitleClass = "text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-normal)] font-600 uppercase tracking-wide text-[var(--gr-muted-fg)]";
+export declare const emptyClass = "py-6 text-center text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)]";
+export declare const loadingRowClass = "flex items-center gap-3 pb-5";
+export declare function grTimelineDensityClass(density: GrTimelineDensity): string;
+export declare function grTimelineMarkerClass(tone: GrTimelineTone, variant: GrTimelineMarkerVariant): string;

package/dist/types/src/components/GrTimeline/index.d.ts

@@ -0,0 +1,12 @@
+export { default } from './GrTimeline.vue';
+export { default as GrTimeline } from './GrTimeline.vue';
+export type { GrTimelineDensity, GrTimelineGroupBy, GrTimelineLayout, GrTimelineOrientation, GrTimelineProps, } from './GrTimeline.vue';
+export { default as GrTimelineItem } from './GrTimelineItem.vue';
+export type { GrTimelineItemProps, GrTimelineMarkerVariant, GrTimelineTone, } from './GrTimelineItem.vue';
+export { grTimelineConfig } from './config';
+export { GR_TIMELINE_HEADING_LEVELS } from './grTimelineContext';
+export type { GrTimelineHeadingLevel } from './grTimelineContext';
+export { grTimelineSafelist } from './safelist';
+export { groupTimelineItems } from './timelineGroups';
+export type { GrTimelineEntry, GrTimelineGroup } from './timelineGroups';
+export type { GrTimelineConfigurableProps } from './defaults';

package/dist/types/src/components/GrTimeline/safelist.d.ts

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

package/dist/types/src/components/GrTimeline/timelineGroups.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Группировка ленты событий. Без Vue — чтобы проверялась без монтирования.
+ */
+export type GrTimelineGroupBy<T> = string | ((item: T, index: number) => string);
+/** Пункт вместе с его позицией в исходном наборе: ключи `v-for` считаются от неё. */
+export interface GrTimelineEntry<T> {
+    item: T;
+    index: number;
+}
+export interface GrTimelineGroup<T> {
+    /** Ключ группы. Пустая строка — заголовка у группы нет. */
+    key: string;
+    entries: GrTimelineEntry<T>[];
+}
+/**
+ * Режет набор на группы, **не меняя порядок**: лента хронологична, и
+ * пересортировать её компонент не вправе. Порядок групп — порядок первого
+ * вхождения ключа; разорванная группа (`A B A`) собирается в одну.
+ *
+ * Без `groupBy` — одна безымянная группа: плоская лента остаётся частным
+ * случаем, и второй ветки рендера у компонента не появляется.
+ */
+export declare function groupTimelineItems<T>(items: readonly T[], groupBy?: GrTimelineGroupBy<T>): GrTimelineGroup<T>[];

package/dist/types/src/components/GrToaster/GrToaster.vue.d.ts

@@ -1,3 +1,4 @@
+import type { Toast } from '../../composables/useToast';
 import { type GrToasterPlacement } from './grToasterStyles';
 export type { GrToasterPlacement };
 export interface GrToasterProps {
@@ -9,23 +10,58 @@ export interface GrToasterProps {
     dismissLabel?: string;
     /** A11y-лейбл контейнера-региона (i18n). */
     regionLabel?: string;
+    /**
+     * Ширина стека. Число — пиксели, строка — любая CSS-длина. Уезжает в
+     * `--gr-toaster-width`, поэтому то же самое можно задать и темой.
+     */
+    width?: string | number;
+    /**
+     * Клавиша перевода фокуса в стек уведомлений; `false` отключает хоткей.
+     * `F6` — рекомендация APG для перехода между «регионами» страницы.
+     */
+    focusHotkey?: string | false;
 }
-declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
+/**
+ * Слот `actions` полностью заменяет дефолтные action-кнопки тоста. Получает сам
+ * `toast` и `dismiss` — функцию, закрывающую именно этот тост.
+ */
+type __VLS_Slots = {
+    actions?: (props: {
+        toast: Toast;
+        dismiss: () => void;
+    }) => unknown;
+};
+/**
+ * Переводит фокус на верхний тост. Тост фокусируем только программно
+ * (`tabindex="-1"`): собственной остановкой `Tab` стек быть не должен, иначе
+ * всплывающее уведомление перехватывало бы обход страницы.
+ */
+declare function focus(): boolean;
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
     placement: string;
     maxVisible: number;
     dismissLabel: undefined;
     regionLabel: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
+    width: undefined;
+    focusHotkey: string;
+}>>, {
+    focus: typeof focus;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
     placement: string;
     maxVisible: number;
     dismissLabel: undefined;
     regionLabel: undefined;
+    width: undefined;
+    focusHotkey: string;
 }>>> & Readonly<{}>, {
+    width: string | number;
+    placement: GrToasterPlacement;
     dismissLabel: string;
     regionLabel: string;
-    placement: GrToasterPlacement;
     maxVisible: number;
+    focusHotkey: string | false;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
 type __VLS_TypePropsToOption<T> = {
@@ -41,6 +77,11 @@ type __VLS_WithDefaults<P, D> = {
         default: D[K];
     }> : P[K];
 };
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};
 type __VLS_PrettifyLocal<T> = (T extends any ? {
     [K in keyof T]: T[K];
 } : {

package/dist/types/src/components/GrToaster/config.d.ts

@@ -1 +1 @@
-export declare const grToasterConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrToaster">;
+export declare const grToasterConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrToaster">;

package/dist/types/src/components/GrToaster/index.d.ts

@@ -1,6 +1,9 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrToasterComponent from './GrToaster.vue';
 export { default } from './GrToaster.vue';
 export { default as GrToaster } from './GrToaster.vue';
 export type { GrToasterPlacement, GrToasterProps } from './GrToaster.vue';
 export { grToasterConfig } from './config';
 export { grToasterSafelist } from './safelist';
-export type { GrToastTone, Toast, ToastInput } from '../../composables/useToast';
+export type { GrToastTone, Toast, ToastAction, ToastInput } from '../../composables/useToast';
+export type GrToasterInstance = ComponentExposed<typeof GrToasterComponent>;

package/dist/types/src/components/GrTooltip/GrTooltip.vue.d.ts

@@ -1,17 +1,68 @@
+import { type UseFloatingPlacement } from '../../composables/useFloating';
+import { type GrTooltipSize } from './grTooltipStyles';
+export type GrTooltipPlacement = UseFloatingPlacement;
 export interface GrTooltipProps {
-    text: string;
-    /** Цвет триггер-иконки (CSS color). По умолчанию — `var(--muted-fg)`. */
+    /** Текст подсказки. Разметка вместо текста — слот `#content`. */
+    text?: string;
+    /** Цвет триггер-иконки (CSS color). По умолчанию — `var(--gr-muted-fg)`. */
     iconColor?: string;
+    /** Размер панели и дефолтной триггер-иконки. */
+    size?: GrTooltipSize;
+    /** Предпочтительная сторона панели; `flip` может её изменить. */
+    placement?: GrTooltipPlacement;
+    /** Зазор между триггером и панелью, px. */
+    offsetPx?: number;
+    /** Задержка перед показом, мс. Спасает от мигания при проведении курсором по панели кнопок. */
+    openDelay?: number;
+    /** Задержка перед скрытием, мс. */
+    closeDelay?: number;
+    /** Подсказка не показывается ничем — ни курсором, ни фокусом, ни `v-model:open`. */
+    disabled?: boolean;
+    /** Управляемая видимость. Без неё компонент ведёт видимость сам. */
+    open?: boolean;
+}
+export interface GrTooltipEmits {
+    (e: 'update:open', value: boolean): void;
 }
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Триггер. По умолчанию — иконка info. */
+    default?: () => unknown;
+    /** Содержимое подсказки; заменяет проп `text`. */
+    content?: () => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTooltipProps>, {
+    text: undefined;
     iconColor: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTooltipProps>, {
+    size: undefined;
+    placement: string;
+    offsetPx: undefined;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
+    open: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTooltipProps>, {
+    text: undefined;
     iconColor: string;
-}>>> & Readonly<{}>, {
+    size: undefined;
+    placement: string;
+    offsetPx: undefined;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
+    open: undefined;
+}>>> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: GrTooltipSize;
+    text: string;
+    placement: GrTooltipPlacement;
+    open: boolean;
+    disabled: boolean;
+    offsetPx: number;
+    openDelay: number;
+    closeDelay: number;
     iconColor: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/types/src/components/GrTooltip/config.d.ts

@@ -1 +1 @@
-export declare const grTooltipConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrTooltip">;
+export declare const grTooltipConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrTooltip">;

package/dist/types/src/components/GrTooltip/defaults.d.ts

@@ -0,0 +1,10 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrTooltip`, настраиваемые глобально через `componentDefaults`. */
+export interface GrTooltipConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrTooltip: GrTooltipConfigurableProps;
+    }
+}

package/dist/types/src/components/GrTooltip/grTooltipStyles.d.ts

@@ -0,0 +1,8 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrTooltipSize = GrComponentSize;
+/** Панель подсказки: кегль и внутренние поля. */
+export declare const panelSizes: Record<GrTooltipSize, string>;
+/** Ширина панели растёт вместе с кеглем — иначе на `lg` строка рвётся втрое. */
+export declare const panelWidths: Record<GrTooltipSize, string>;
+/** Дефолтный триггер — иконка info из шкалы `GrIcon` (`xs…lg` → `14…20px`). */
+export declare const triggerIconSizes: Record<GrTooltipSize, GrComponentSize>;

package/dist/types/src/components/GrTooltip/index.d.ts

@@ -1,4 +1,8 @@
 export { default } from './GrTooltip.vue';
 export { default as GrTooltip } from './GrTooltip.vue';
-export type { GrTooltipProps } from './GrTooltip.vue';
+export type { GrTooltipPlacement, GrTooltipProps } from './GrTooltip.vue';
 export { grTooltipConfig } from './config';
+export type { GrTooltipConfigurableProps } from './defaults';
+export type { GrTooltipSize } from './grTooltipStyles';
+export { grTooltipSafelist } from './safelist';
+export type { GrTooltipEmits } from './GrTooltip.vue';

package/dist/types/src/components/GrTooltip/safelist.d.ts

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

package/dist/types/src/components/GrTree/GrTree.vue.d.ts

@@ -1,11 +1,29 @@
-import type { GrTreeInstance, GrTreeNode, GrTreeNodeDropType } from './grTreeTypes';
+import type { GrTreeInstance, GrTreeKey, GrTreeNode, GrTreeNodeDropType } from './grTreeTypes';
 import type { GrTreeProps } from './grTreeProps';
+export interface GrTreeEmits<T extends Record<string, any> = any> {
+    (e: 'nodeClick', data: T, node: GrTreeNode<T>): void;
+    (e: 'nodeExpand', data: T, node: GrTreeNode<T>): void;
+    (e: 'nodeCollapse', data: T, node: GrTreeNode<T>): void;
+    (e: 'nodeDrop', draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType): void;
+    (e: 'nodeContextMenu', evt: MouseEvent, data: T, node: GrTreeNode<T>): void;
+    (e: 'update:checkedKeys', keys: GrTreeKey[]): void;
+    (e: 'check', data: T, node: GrTreeNode<T>, info: {
+        checkedKeys: GrTreeKey[];
+        halfCheckedKeys: GrTreeKey[];
+    }): 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<GrTreeProps<T> & {
         onNodeClick?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
         onNodeExpand?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
         onNodeCollapse?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
         onNodeDrop?: ((draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType) => any) | undefined;
+        onNodeContextMenu?: ((evt: MouseEvent, data: T, node: GrTreeNode<T>) => any) | undefined;
+        "onUpdate:checkedKeys"?: ((keys: GrTreeKey[]) => any) | undefined;
+        onCheck?: ((data: T, node: GrTreeNode<T>, info: {
+            checkedKeys: GrTreeKey[];
+            halfCheckedKeys: GrTreeKey[];
+        }) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
@@ -17,12 +35,7 @@ declare const __VLS_export: <T extends Record<string, any> = any>(__VLS_props: N
             data: T;
         }) => any;
     };
-    emit: {
-        (event: "nodeClick", data: T, node: GrTreeNode<T>): void;
-        (event: "nodeExpand", data: T, node: GrTreeNode<T>): void;
-        (event: "nodeCollapse", data: T, node: GrTreeNode<T>): void;
-        (event: "nodeDrop", draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType): void;
-    };
+    emit: GrTreeEmits<T>;
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/types/src/components/GrTree/config.d.ts

@@ -1 +1 @@
-export declare const grTreeConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrTree">;
+export declare const grTreeConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrTree">;

package/dist/types/src/components/GrTree/defaults.d.ts

@@ -0,0 +1,10 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrTree`, настраиваемые глобально через `componentDefaults`. */
+export interface GrTreeConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrTree: GrTreeConfigurableProps;
+    }
+}

package/dist/types/src/components/GrTree/grTreeChecking.d.ts

@@ -0,0 +1,31 @@
+import type { GrTreeKey, GrTreeNode } from './grTreeTypes';
+/**
+ * Состояние отметки узла. `half` — часть потомков отмечена: в ARIA это
+ * `aria-checked="mixed"`.
+ */
+export declare const GR_TREE_CHECK_STATES: readonly ["checked", "half", "unchecked"];
+export type GrTreeCheckState = typeof GR_TREE_CHECK_STATES[number];
+export type GrTreeCheckStates = Map<GrTreeKey, GrTreeCheckState>;
+/**
+ * Раскладывает отмеченные ключи по всему дереву: родитель отмечен, когда
+ * отмечены все дети, и наполовину — когда часть.
+ *
+ * Считается от листьев вверх, поэтому `checkedKeys` снаружи может содержать
+ * только листья (типовой формат ответа сервера) — родители посчитаются сами.
+ * При `strict` дерево не связывает узлы вовсе: каждый отвечает сам за себя.
+ */
+export declare function resolveCheckStates<T>(roots: GrTreeNode<T>[], checkedKeys: Set<GrTreeKey>, strict: boolean): GrTreeCheckStates;
+/**
+ * Новый набор отмеченных ключей после переключения узла.
+ *
+ * Каскад идёт вниз (все потомки повторяют решение) и вверх (родитель отмечен,
+ * только если отмечены все его дети). Возвращается набор с родителями —
+ * `getCheckedKeys({ leafOnly: true })` при необходимости отбросит их обратно.
+ */
+export declare function toggleCheckedKeys<T>(roots: GrTreeNode<T>[], checkedKeys: Set<GrTreeKey>, node: GrTreeNode<T>, checked: boolean, strict: boolean): Set<GrTreeKey>;
+/** Отбрасывает ключи, которых нет в текущей модели (данные могли смениться). */
+export declare function pruneToTree<T>(roots: GrTreeNode<T>[], keys: Set<GrTreeKey>): Set<GrTreeKey>;
+/** Ключи в состоянии `checked`; `leafOnly` оставляет только листья. */
+export declare function collectCheckedKeys<T>(roots: GrTreeNode<T>[], states: GrTreeCheckStates, leafOnly: boolean): GrTreeKey[];
+/** Ключи в состоянии `half` — родители с частично отмеченными потомками. */
+export declare function collectHalfCheckedKeys(states: GrTreeCheckStates): GrTreeKey[];

package/dist/types/src/components/GrTree/grTreeDataAdapter.d.ts

@@ -6,6 +6,8 @@ export type GrTreeDataAdapter<T extends object> = {
     getChildrenKey: () => string;
     getLabelKey: () => string;
     getLabel: (data: T) => string;
+    /** Признак «лист» из данных. `undefined` — данные молчат, решает вызывающий. */
+    getIsLeaf: (data: T) => boolean | undefined;
     getChildren: (data: T) => T[];
     ensureChildren: (data: T) => T[];
     getNodeKey: (data: T, index: number, parentKey: GrTreeKey | undefined) => GrTreeKey;

package/dist/types/src/components/GrTree/grTreeInteractionContext.d.ts

@@ -15,11 +15,19 @@ export type GrTreeInteractionEmitters<T> = {
     emitNodeExpand: (data: T, node: GrTreeNode<T>) => void;
     emitNodeCollapse: (data: T, node: GrTreeNode<T>) => void;
     emitNodeDrop: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType) => void;
+    emitNodeContextMenu: (evt: MouseEvent, data: T, node: GrTreeNode<T>) => void;
 };
 export type GrTreeInteractionContext<T> = {
     hoveredKey: Ref<GrTreeKey | undefined>;
     /** Клавиша узла, держащего roving-фокус (единственный tabindex=0 во всём дереве). */
     focusedKey: Ref<GrTreeKey | undefined>;
+    /**
+     * Реестр DOM-узлов строк, общий на все уровни дерева. Нужен клавиатуре: без
+     * него каждое нажатие стрелки обходило бы весь DOM поддерева в поисках
+     * строки по `data`-атрибуту.
+     */
+    nodeEls: Map<GrTreeKey, HTMLElement>;
+    registerNodeEl: (key: GrTreeKey, el: HTMLElement | null) => void;
     draggingNode: ShallowRef<GrTreeNode<T> | null>;
     dropTarget: ShallowRef<GrTreeDropTarget | null>;
     canDrag: (node: GrTreeNode<T>) => boolean;
@@ -29,5 +37,6 @@ export type GrTreeInteractionContext<T> = {
     emitNodeExpand: (data: T, node: GrTreeNode<T>) => void;
     emitNodeCollapse: (data: T, node: GrTreeNode<T>) => void;
     emitNodeDrop: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType) => void;
+    emitNodeContextMenu: (evt: MouseEvent, data: T, node: GrTreeNode<T>) => void;
 };
 export declare function createGrTreeInteractionContext<T>(options: GrTreeInteractionOptions<T>, emitters: GrTreeInteractionEmitters<T>): GrTreeInteractionContext<T>;

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

@@ -1,11 +1,12 @@
 import type { HTMLAttributes } from 'vue';
-import type { GrTreeInteractionContext } from './grTreeInteractionContext';
-import type { GrTreeStore } from './grTreeStore';
+import type { GrTreeSize } from './grTreeStyles';
 import type { GrTreeAllowDropType, GrTreeKey, GrTreeNode } from './grTreeTypes';
 export type NodeKeyProp<T extends object> = Extract<keyof T, string>;
 export type GrTreePropsMap = {
     children?: string;
     label?: string;
+    /** Поле данных «узел — лист». Нужно ленивому режиму: детей ещё нет, а раскрывать нечего. */
+    isLeaf?: string;
 };
 export type GrTreeFilterNodeMethod<T extends object = any> = (value: string, data: T, node?: GrTreeNode<T>) => boolean;
 export type GrTreeBranchLineColor<T extends object = any> = string | ((node: GrTreeNode<T>) => string | undefined | null);
@@ -14,9 +15,16 @@ export type GrTreeVisibleRow<T extends object> = {
     isExpanded: boolean;
     isLeaf: boolean;
     isMatched: boolean;
-};
-export type GrTreeVisibleTreeRow<T extends object> = GrTreeVisibleRow<T> & {
-    children: GrTreeVisibleTreeRow<T>[];
+    /**
+     * Место узла среди соседей. В плоском DOM группы нет, поэтому структуру
+     * дерева диктору сообщают `aria-level` + `aria-posinset` + `aria-setsize`.
+     */
+    posInSet: number;
+    setSize: number;
+    /** Идёт ли сейчас ленивая загрузка детей этого узла. */
+    isLoading: boolean;
+    /** Цвета направляющих для уровней предков (пусто, если `branchLine` выключен). */
+    branchColors: string[];
 };
 export type GrTreeClassValue = HTMLAttributes['class'];
 export type GrTreeNodeClass<T extends object> = GrTreeClassValue | ((row: GrTreeVisibleRow<T>) => GrTreeClassValue);
@@ -25,9 +33,43 @@ export type GrTreeDataProps<T extends object> = {
     props?: GrTreePropsMap;
     nodeKey?: NodeKeyProp<T> | 'id';
     defaultExpandedKeys?: GrTreeKey[];
+    /**
+     * Раскрывать узлы, как только они появились в данных. Уже свёрнутое руками
+     * не раскрывается обратно на каждом обновлении `data`.
+     */
+    defaultExpandAll?: boolean;
     filterNodeMethod?: GrTreeFilterNodeMethod<T>;
+    /**
+     * Ленивый режим: дети ветки приходят по её раскрытию через `load`.
+     * Узел считается разворачиваемым, пока не доказано обратное — полем `isLeaf`
+     * из карты `props`.
+     */
+    lazy?: boolean;
+    /** Загрузчик ветки. `resolve` дописывает детей в данные узла. */
+    load?: GrTreeLoad<T>;
 };
+export type GrTreeLoad<T extends object = any> = (node: GrTreeNode<T>, resolve: (children: T[]) => void) => void;
 export type GrTreeViewProps<T extends object> = {
+    /** Размер строки: высота, отступы, иконки и кегль подписи. */
+    size?: GrTreeSize;
+    /** Шаг отступа уровня в пикселях. `0` — значение из темы (`--gr-tree-indent-step`). */
+    indent?: number;
+    /**
+     * Виртуализация: в DOM живёт только окно вокруг вьюпорта.
+     *
+     * Требует `maxHeight` — без ограниченной высоты окна прокрутки не существует;
+     * скроллером в этом режиме становится сам корень дерева.
+     *
+     * Включается осознанно: на списке в сотню узлов выигрыша нет, а в DOM остаётся
+     * только окно — вместе с ним меняется и то, что находит `querySelector`
+     * потребителя.
+     *
+     * Ограничение: перетаскивание работает по отрисованным строкам — уронить узел
+     * на тот, которого нет на экране, нельзя.
+     */
+    virtual?: boolean;
+    /** Максимальная высота дерева со своим скроллером. Число — пиксели. */
+    maxHeight?: number | string;
     highlightCurrent?: boolean;
     expandIcon?: string;
     collapseIcon?: string;
@@ -49,15 +91,22 @@ export type GrTreeViewProps<T extends object> = {
     collapseLabel?: string;
 };
 export type GrTreeInteractionProps<T extends object> = {
+    /** Клик по строке раскрывает/сворачивает узел, а не только выбирает его. */
+    expandOnClickNode?: boolean;
+    /** На каждом уровне раскрыт максимум один узел. */
+    accordion?: boolean;
     draggable?: boolean;
     dragHandleIcon?: string;
     allowDrop?: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, type: GrTreeAllowDropType) => boolean;
     allowDrag?: (draggingNode: GrTreeNode<T>) => boolean;
 };
-export type GrTreeInternalProps<T extends object> = {
-    internalRows?: GrTreeVisibleTreeRow<T>[];
-    internalNested?: boolean;
-    internalStore?: GrTreeStore<T>;
-    internalInteractionContext?: GrTreeInteractionContext<T>;
+export type GrTreeSelectionProps = {
+    /** Чекбоксы у узлов: множественный выбор поверх дерева. */
+    showCheckbox?: boolean;
+    /** Отмеченные ключи (`v-model:checked-keys`). */
+    checkedKeys?: GrTreeKey[];
+    defaultCheckedKeys?: GrTreeKey[];
+    /** Не связывать родителей и детей: каждый узел отмечается сам по себе. */
+    checkStrictly?: boolean;
 };
-export type GrTreeProps<T extends object> = GrTreeDataProps<T> & GrTreeViewProps<T> & GrTreeInteractionProps<T> & GrTreeInternalProps<T>;
+export type GrTreeProps<T extends object> = GrTreeDataProps<T> & GrTreeViewProps<T> & GrTreeSelectionProps & GrTreeInteractionProps<T>;

package/dist/types/src/components/GrTree/grTreeStore.d.ts

@@ -1,7 +1,8 @@
 import type { ComputedRef, MaybeRefOrGetter, Ref, ShallowRef } from 'vue';
 import type { GrTreeKey, GrTreeNode, GrTreeNodeDropType, GrTreeNodeTarget } from './grTreeTypes';
 import type { GrTreeDataAdapter } from './grTreeDataAdapter';
-import type { GrTreeDataProps, GrTreeFilterNodeMethod } from './grTreeProps';
+import type { GrTreeDataProps, GrTreeFilterNodeMethod, GrTreeLoad } from './grTreeProps';
+import type { GrTreeCheckState, GrTreeCheckStates } from './grTreeChecking';
 type TreeModel<T extends object> = {
     roots: GrTreeNode<T>[];
     byKey: Map<GrTreeKey, GrTreeNode<T>>;
@@ -16,12 +17,24 @@ type FilterInfo = {
 export type GrTreeStoreOptions<T extends object> = {
     data: MaybeRefOrGetter<GrTreeDataProps<T>['data']>;
     defaultExpandedKeys?: MaybeRefOrGetter<GrTreeDataProps<T>['defaultExpandedKeys']>;
+    defaultExpandAll?: MaybeRefOrGetter<boolean | undefined>;
     filterNodeMethod?: MaybeRefOrGetter<GrTreeFilterNodeMethod<T> | undefined>;
+    defaultCheckedKeys?: MaybeRefOrGetter<GrTreeKey[] | undefined>;
+    /** Внешние отмеченные ключи (`v-model:checked-keys`), если потребитель их ведёт. */
+    checkedKeys?: MaybeRefOrGetter<GrTreeKey[] | undefined>;
+    checkStrictly?: MaybeRefOrGetter<boolean | undefined>;
+    lazy?: MaybeRefOrGetter<boolean | undefined>;
+    load?: MaybeRefOrGetter<GrTreeLoad<T> | undefined>;
     adapter: GrTreeDataAdapter<T>;
 };
 export type GrTreeStore<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>;
     treeModel: ComputedRef<TreeModel<T>>;
     filterInfo: ComputedRef<FilterInfo>;
@@ -40,6 +53,19 @@ export type GrTreeStore<T extends object> = {
     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 createGrTreeStore<T extends Record<string, any> = any>(options: GrTreeStoreOptions<T>): GrTreeStore<T>;
 export {};

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

@@ -0,0 +1,22 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrTreeSize = GrComponentSize;
+/**
+ * Размер дерева выражен переменными, а не утилитарными классами: те же
+ * `--gr-tree-*` уже объявлены точками кастомизации в `GrTree.vue`, и size
+ * обязан задавать им дефолты, а не спорить с ними отдельным каналом.
+ *
+ * `font-size` на `md` намеренно `inherit`: дерево по умолчанию набирается
+ * кеглем родителя, и подстановка конкретных пикселей сменила бы вид всем,
+ * кто ничего не просил.
+ */
+export type GrTreeSizeVars = {
+    '--gr-tree-row-min-height': string;
+    '--gr-tree-row-px': string;
+    '--gr-tree-row-py': string;
+    '--gr-tree-toggle-size': string;
+    '--gr-tree-drag-handle-size': string;
+    '--gr-tree-icon-size': string;
+    '--gr-tree-content-gap': string;
+    '--gr-tree-font-size': string;
+};
+export declare const treeSizeVars: Record<GrTreeSize, GrTreeSizeVars>;