@feugene/granularity 0.13.0 → 0.18.0

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;
+    /** Текст подсказки. Разметка вместо текста — слот `#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 '../../composables/useGrComponentConfig' {
+    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 '../../composables/useGrComponentConfig' {
+    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,18 @@ 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 +36,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>;

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

@@ -10,8 +10,17 @@ export type GrTreeNode<T = any> = {
     childNodes: GrTreeNode<T>[];
 };
 export type GrTreeNodeTarget<T = any> = GrTreeKey | GrTreeNode<T> | T;
+export type GrTreeCheckedKeysOptions = {
+    /** Только листья: родители, отмеченные каскадом, в выдачу не попадают. */
+    leafOnly?: boolean;
+};
 export type GrTreeInstance<T = any> = {
     filter: (value: string) => void;
+    /**
+     * Фокус на узел (по умолчанию — на держателя roving tabindex).
+     * `false` — фокусировать было нечего: дерево пусто или всё отфильтровано.
+     */
+    focus: (key?: GrTreeKey) => boolean;
     setCurrentKey: (key?: GrTreeKey) => void;
     getCurrentKey: () => GrTreeKey | undefined;
     appendNode: (data: T, parent: GrTreeNodeTarget<T>) => GrTreeNode<T> | undefined;
@@ -21,4 +30,10 @@ export type GrTreeInstance<T = any> = {
     getCurrentNode: () => GrTreeNode<T> | undefined;
     setCurrentNode: (node?: GrTreeNodeTarget<T>) => boolean;
     getNode: (key: GrTreeKey) => GrTreeNode<T> | undefined;
+    /** Отмеченные чекбоксами узлы. Без `leafOnly` включает родителей. */
+    getCheckedKeys: (options?: GrTreeCheckedKeysOptions) => GrTreeKey[];
+    setCheckedKeys: (keys: GrTreeKey[]) => void;
+    /** Родители, у которых отмечена часть потомков (`aria-checked="mixed"`). */
+    getHalfCheckedKeys: () => GrTreeKey[];
+    setChecked: (node: GrTreeNodeTarget<T>, checked: boolean) => boolean;
 };

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

@@ -1,6 +1,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, GrTreeNodeClass, GrTreeProps, GrTreePropsMap, GrTreeVisibleRow, GrTreeVisibleTreeRow, } from './grTreeProps';
+export type { GrTreeBranchLineColor, GrTreeFilterNodeMethod, GrTreeLoad, GrTreeNodeClass, GrTreeProps, GrTreePropsMap, GrTreeSelectionProps, GrTreeVisibleRow, } from './grTreeProps';
+export type { GrTreeCheckState } from './grTreeChecking';
 export { grTreeConfig } from './config';
+export type { GrTreeConfigurableProps } from './defaults';
+export type { GrTreeSize } from './grTreeStyles';
 export { grTreeSafelist } from './safelist';
+export type { GrTreeEmits } from './GrTree.vue';

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

@@ -1,16 +1,37 @@
 import { type GrTreeNode } from '../GrTree';
 import type { GrTreeSelectModelValue, GrTreeSelectProps } from './grTreeSelectTypes';
+export interface GrTreeSelectEmits<T extends Record<string, any> = any> {
+    (e: 'update:modelValue', value: GrTreeSelectModelValue): void;
+    (e: 'change', value: GrTreeSelectModelValue): void;
+    /** Панель открылась/закрылась (`v-model:open`). */
+    (e: 'update:open', value: boolean): void;
+    /**
+     * Панель открылась/закрылась.
+     * @deprecated Используйте `update:open` (`v-model:open`); алиас будет снят после 1.0.
+     */
+    (e: 'visibleChange', visible: boolean): void;
+    (e: 'clear'): void;
+    (e: 'nodeClick', data: T, node: GrTreeNode<T>): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): 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<GrTreeSelectProps<T> & {
         onClear?: (() => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
         onChange?: ((value: GrTreeSelectModelValue) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
         "onUpdate:modelValue"?: ((value: GrTreeSelectModelValue) => any) | undefined;
-        onNodeClick?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
+        "onUpdate:open"?: ((value: boolean) => any) | undefined;
         onVisibleChange?: ((visible: boolean) => any) | undefined;
+        onNodeClick?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
-    expose: (exposed: {}) => void;
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        focus: () => void;
+        blur: () => void;
+    }>) => void;
     attrs: any;
     slots: {
         /** Рендер значения внутри триггера (вместо дефолтного текста). */
@@ -28,14 +49,14 @@ declare const __VLS_export: <T extends Record<string, any> = any>(__VLS_props: N
         }) => any;
         /** Содержимое пустого состояния (когда нет данных). */
         empty?: () => any;
+        /** Содержимое панели, пока данные едут. */
+        loading?: () => any;
+        /** Аддон слева от значения: иконка, код валюты, метка. */
+        prefix?: () => any;
+        /** Аддон справа от значения, перед крестиком и шевроном. */
+        suffix?: () => any;
     };
-    emit: {
-        (e: "update:modelValue", value: GrTreeSelectModelValue): void;
-        (e: "change", value: GrTreeSelectModelValue): void;
-        (e: "visibleChange", visible: boolean): void;
-        (e: "clear"): void;
-        (e: "nodeClick", data: T, node: GrTreeNode<T>): void;
-    };
+    emit: GrTreeSelectEmits<T>;
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

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

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

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

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

package/dist/types/src/components/GrTreeSelect/grTreeSelectStyles.d.ts

@@ -1,10 +1,38 @@
+import type { GrControlState } from '../shared/sizes';
 import type { GrInputSize } from '../GrInput';
-export type GrTreeSelectState = 'default' | 'success' | 'warning' | 'danger';
+export type GrTreeSelectState = GrControlState;
 export declare const sizeClassBySize: Record<GrInputSize, string>;
+/**
+ * Горизонтальный отступ из `sizeClassBySize`, но числом: аддоны задают паддинг
+ * инлайн-стилем, а он перекрывает класс — значение нужно обеим формам, и
+ * расходиться им нельзя.
+ */
+export declare const paddingX: Record<GrInputSize, string>;
+/** Ширина зоны шеврона/крестика справа (`pr-9` в классе триггера). */
+export declare const trailingZoneWidth = "2.25rem";
 export declare const borderClassByState: Record<GrTreeSelectState, string>;
+/**
+ * Ошибка валидации красится своей ролью, а не декоративным тоном `danger`:
+ * `state="danger"` — это подсветка по решению разработчика, `invalid` — вердикт
+ * валидации, и тема вправе развести их по цвету.
+ */
+export declare const invalidBorderClass = "border-[var(--gr-invalid-brd)] focus-visible:ring-[var(--gr-invalid-ring)]";
+/**
+ * Disabled красится фоном и цветом текста, а не прозрачностью: `opacity`
+ * разбавляет выверенные на AA токены и роняет контраст подписи.
+ */
+export declare const shellEnabledClass = "bg-[var(--gr-bg)] text-[var(--gr-fg)]";
+export declare const shellDisabledClass = "bg-[var(--gr-muted)] text-[var(--gr-muted-fg)] cursor-not-allowed";
 export declare function grTreeSelectClass(options: {
     size: GrInputSize;
     state: GrTreeSelectState;
     invalid: boolean;
+    disabled?: boolean;
 }): string;
 export declare const grTreeSelectPanelClass = "rounded-[var(--gr-radius-xl)] border border-[var(--gr-brd)] bg-[var(--gr-card)] text-[var(--gr-card-fg)] shadow-[var(--gr-shadow-2)] overflow-hidden";
+/**
+ * Строка состояния панели: загрузка и «нет данных». По центру и с двойным
+ * воздухом — тот же язык, что у `GrSelect`, `GrAutocomplete` и палитры команд.
+ * Слева она расходилась с содержимым дерева на паддинг скроллера.
+ */
+export declare const grTreeSelectStateClass = "flex items-center justify-center gap-2 px-3 py-4 text-center text-[length:var(--gr-text-sm)] text-[var(--gr-muted-fg)]";