@feugene/granularity 0.13.0 → 0.16.0

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 '../GrConfigProvider/context' {
+    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)]";

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

@@ -17,10 +17,36 @@ export interface GrTreeSelectProps<T extends object = any> {
     disabled?: boolean;
     placeholder?: string;
     size?: GrInputSize;
+    /**
+     * Данные ещё едут. Панель показывает индикатор вместо «Нет данных» — иначе
+     * пустой ответ и незагруженный выглядят одинаково.
+     */
+    loading?: boolean;
     invalid?: boolean;
+    /** Только для чтения: значение видно, но не меняется. */
+    readonly?: boolean;
+    /** Обязательное поле (`aria-required`). */
+    required?: boolean;
+    /** Доступное имя вне `GrFormField`. */
+    ariaLabel?: string;
     state?: GrTreeSelectState;
     multiple?: boolean;
+    /**
+     * Чекбоксы в дереве вместо собственной галочки: отметка родителя каскадом
+     * закрывает поддерево, полувыбранный родитель показывается `mixed`. Работает
+     * только вместе с `multiple`.
+     */
+    showCheckbox?: boolean;
+    /** Отвязать родителей от детей: отметка перестаёт распространяться каскадом. */
+    checkStrictly?: boolean;
     clearable?: boolean;
+    /**
+     * Контролируемое состояние панели (`v-model:open`). Без пропа панель ведёт
+     * себя сама (uncontrolled), с ним — слушайте `update:open` и меняйте проп.
+     */
+    open?: boolean;
+    /** Имя для нативной формы: hidden input на каждый выбранный ключ. */
+    name?: string;
     /** Как отображать выбранное значение в single-режиме. */
     valueDisplay?: GrTreeSelectValueDisplay;
     filterable?: boolean;
@@ -29,5 +55,22 @@ export interface GrTreeSelectProps<T extends object = any> {
     filterNodeMethod?: GrTreeFilterNodeMethod<T>;
     closeOnSelect?: boolean;
     dropdownMaxHeight?: number;
+    /**
+     * Виртуализация дерева в панели: в DOM живёт только окно вокруг вьюпорта.
+     *
+     * Скроллером в этом режиме становится само дерево, а не контейнер панели —
+     * два вложенных скроллера дали бы две полосы прокрутки на одном списке.
+     */
+    virtual?: boolean;
+    /**
+     * Ширины аддонов `prefix`/`suffix` — общий контракт контролов пакета
+     * (`docs/form-controls.md`).
+     */
+    prefixMinWidth?: string;
+    prefixMaxWidth?: string;
+    suffixMinWidth?: string;
+    suffixMaxWidth?: string;
+    prefixFixed?: boolean;
+    suffixFixed?: boolean;
 }
 export {};

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

@@ -1,5 +1,10 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrTreeSelectComponent from './GrTreeSelect.vue';
 export { default } from './GrTreeSelect.vue';
 export { default as GrTreeSelect } from './GrTreeSelect.vue';
 export type { GrTreeSelectModelValue, GrTreeSelectProps, GrTreeSelectValueDisplay } from './grTreeSelectTypes';
 export { grTreeSelectConfig } from './config';
+export type { GrTreeSelectConfigurableProps } from './defaults';
 export { grTreeSelectSafelist } from './safelist';
+export type { GrTreeSelectEmits } from './GrTreeSelect.vue';
+export type GrTreeSelectInstance = ComponentExposed<typeof GrTreeSelectComponent>;

package/dist/types/src/components/shared/hotkey.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Разбор, матчинг и человекочитаемое представление сочетаний клавиш.
+ *
+ * Общий модуль, а не часть `GrCommandPalette`: то же нужно `GrKbd`, а импорт из
+ * чужой компонентной директории на сборке дал бы ребро `GrKbd →
+ * GrCommandPalette` (хелпер уехал бы в чанк палитры) — `granular doctor` считает
+ * такое незадекларированной зависимостью.
+ *
+ * Директива `v-hotkey` для палитры не годится: ей нужен смонтированный элемент,
+ * а палитра в закрытом состоянии не рендерит ничего. Поэтому здесь — свой
+ * матчер на `window`, с тем же синтаксисом комбинаций плюс токен `mod`.
+ */
+export type ParsedCommandHotkey = {
+    key: string;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+    shift: boolean;
+    /** `mod` — Cmd на macOS, Ctrl на остальных платформах. */
+    mod: boolean;
+};
+export declare function parseCommandHotkey(combo: string): ParsedCommandHotkey | null;
+/** macOS определяем по платформе — от неё зависит, чем является `mod`. */
+export declare function isAppleDevice(): boolean;
+export declare function matchesCommandHotkey(event: KeyboardEvent, hotkey: ParsedCommandHotkey, apple?: boolean): boolean;
+/** Человекочитаемые клавиши для подсказки в поле ввода (`⌘` / `Ctrl`). */
+export declare function formatCommandHotkey(hotkey: ParsedCommandHotkey, apple?: boolean): string[];
+/** Одна клавиша в человекочитаемом виде. */
+export interface HotkeyKeyView {
+    /** Что видно на экране: символ (`⌘`) или слово (`Ctrl`). */
+    label: string;
+    /**
+     * Ключ читаемого имени (`gr.kbd.<name>`) для символьных клавиш. У `K` или
+     * `Ctrl` его нет — они и так читаются вслух.
+     */
+    name?: 'command' | 'option' | 'shift' | 'control' | 'enter' | 'escape';
+}
+/**
+ * Токен → то, что видит пользователь. `mod` зависит от платформы: на macOS это
+ * Cmd, на остальных — Ctrl. Символы отдаются вместе с ключом читаемого имени:
+ * `⌘` без имени диктор произносит как «знак места интереса».
+ */
+export declare function formatHotkeyToken(token: string, apple: boolean): HotkeyKeyView;
+export declare function formatHotkeyTokens(tokens: readonly string[], apple: boolean): HotkeyKeyView[];
+/** Комбинация строкой (`mod+shift+K`) — в набор токенов в порядке показа. */
+export declare function splitHotkeyCombo(combo: string): string[];

package/dist/types/src/components/shared/instance.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Тип публичного API компонента — то, что он отдал через `defineExpose`.
+ *
+ * Зачем свой, а не `InstanceType<typeof GrX>`: у компонентов с
+ * `<script setup generic>` (`GrSelect`, `GrTree`, `GrDataTable`, …) `InstanceType`
+ * не работает вовсе — такой компонент компилируется не в класс, а в функцию.
+ *
+ * Зачем выводом, а не руками: написанный руками тип — копия `defineExpose`,
+ * которая расходится с оригиналом молча. Здесь разойтись не с чем.
+ *
+ * Определение — из `vue-component-type-helpers` (MIT). Скопировано, а не
+ * подключено зависимостью: пакет публикуемый, и тащить потребителю целый
+ * пакет ради одного условного типа несоразмерно.
+ */
+export type ComponentExposed<T> = T extends new (...args: any) => infer E ? E : T extends (props: any, ctx: any, expose: (exposed: infer E) => any, ...args: any) => any ? NonNullable<E> : Record<string, never>;

package/dist/types/src/components/shared/optionFilter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Подстрочный поиск по опциям — один на пакет.
+ *
+ * Тот же предикат был написан трижды, и у каждой копии был свой контракт
+ * нормализации: `GrSelect` лоукейсил запрос в вызывающем коде, `GrAutocomplete`
+ * внутри матчера, `GrCommandPalette` — внутри своего. Расхождение такого рода
+ * не видно на глаз и всплывает как «в одном компоненте регистр учитывается, в
+ * другом нет».
+ *
+ * Нормализация здесь ровно одна (`normalizeOptionQuery`), а компонент выбирает,
+ * что ему нужно: готовый плоский список (`filterOptions`) или голый предикат
+ * (`matchesOptionQuery`) — `GrSelect` фильтрует внутри обхода групп и списка не
+ * имеет.
+ */
+/** Запрос в сравнимом виде: без краевых пробелов и в нижнем регистре. */
+export declare function normalizeOptionQuery(raw: string): string;
+/**
+ * Ядро матча: подстрока в любом из полей. `undefined` в наборе пропускается —
+ * у команды палитры может не быть ни описания, ни группы.
+ *
+ * `needle` ожидается уже нормализованным: нормализовать на каждый элемент
+ * списка значило бы делать одну и ту же работу n раз.
+ */
+export declare function matchesQueryParts(parts: readonly (string | undefined)[], needle: string): boolean;
+/** Опция в терминах поиска: метка видна пользователю, значение — то, что он мог запомнить. */
+export interface OptionLike {
+    label: string;
+    value: unknown;
+}
+/** Матчер по умолчанию: метка и значение опции. */
+export declare function matchesOptionQuery(option: OptionLike, needle: string): boolean;
+/**
+ * Плоская фильтрация списка опций.
+ *
+ * Пустой запрос отдаёт **тот же массив** и матчер не зовёт вовсе: свой `filter`
+ * потребителя не должен решать, что показывать «без запроса», а копия на
+ * каждый пересчёт била бы по виртуализированным спискам на тысячи опций.
+ *
+ * Пользовательскому матчеру уходит **сырой** запрос (только `trim`), а не
+ * нормализованный: это публичный контракт пропа `filter` у `GrAutocomplete`,
+ * и чужая реализация вправе смотреть на регистр.
+ */
+export declare function filterOptions<TOption extends OptionLike>(options: TOption[], rawQuery: string, filter?: (option: TOption, query: string) => boolean): TOption[];
+/**
+ * Значения выбора — в опции для чипов.
+ *
+ * Значение, которого нет среди опций, показывается как есть: так выглядит
+ * произвольное значение (`allowCustomValue`) и значение, пришедшее из модели
+ * раньше, чем подгрузились опции. Прятать его нельзя — пользователь видел бы
+ * пустое место вместо своего выбора.
+ *
+ * Сравнение идёт через ключ, а не `===`: объектные значения приходят в модель
+ * отдельной копией, и ссылочное равенство не нашло бы ничего.
+ */
+export declare function resolveSelectedOptions<TValue, TOption extends {
+    label: string;
+    value: TValue;
+}>(values: readonly TValue[], options: readonly TOption[], keyOf?: (value: TValue) => string): (TOption | {
+    value: TValue;
+    label: string;
+})[];

package/dist/types/src/components/shared/sizes.d.ts

@@ -0,0 +1,30 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+export type { GrComponentSize } from '../GrConfigProvider/context';
+export { GR_COMPONENT_SIZES } from '../GrConfigProvider/context';
+/**
+ * Каноническая шкала размеров контролов — `GrComponentSize` (`xs|sm|md|lg`).
+ *
+ * До сведе́ния шкал в пакете было пять несовместимых: `xs sm md lg`, `sm md lg`,
+ * `sm md lg xl full`, `sm md lg full`, `md lg xl`, `sm md` и отдельно
+ * `GrAvatar.size: number`. Практическое следствие: `<GrConfigProvider size="xs">`
+ * физически не мог примениться к половине пакета, а `size="xl"` компилировался у
+ * одного компонента и падал у соседнего.
+ */
+/**
+ * Шкала **ширины оверлея** — отдельный тип, а не размер контрола.
+ *
+ * У модалки «размер» означает ширину окна, а не высоту строки и не кегль, и
+ * шкала у неё своя: `full` осмыслен, `xs` — нет. Смешивать их в одном типе
+ * значило бы разрешить `<GrModal size="xs">` и `<GrInput size="full">`.
+ */
+export declare const GR_OVERLAY_SIZES: readonly ["sm", "md", "lg", "xl", "full"];
+export type GrOverlaySize = typeof GR_OVERLAY_SIZES[number];
+/**
+ * Визуальное состояние форм-контрола. Было объявлено четырьмя независимыми
+ * копиями (`GrTextareaState`, `GrInputTagState`, `GrNumberInputState`,
+ * `GrTreeSelectState`) — расхождение обнаружилось бы только рантаймом.
+ */
+export declare const GR_CONTROL_STATES: readonly ["default", "success", "warning", "danger"];
+export type GrControlState = typeof GR_CONTROL_STATES[number];
+/** Размер контрола с escape-hatch в пиксели: только `GrAvatar` и `GrIcon`. */
+export type GrSizeWithPx = GrComponentSize | number;

package/dist/types/src/components/shared/slotNodes.d.ts

@@ -0,0 +1,19 @@
+import { type VNode } from 'vue';
+/**
+ * Разбор содержимого слота.
+ *
+ * Общий модуль, а не приватные функции внутри SFC: то же самое нужно и
+ * `GrFileUpload` («слот с кастомным UI или просто текст»), и `GrList` («в
+ * списке пусто»). Импорт из чужой компонентной директории на сборке дал бы
+ * ребро между компонентами, которого в разметке нет.
+ */
+/** `v-for` и `<template>` приходят фрагментами — разворачиваем до реальных узлов. */
+export declare function flattenSlotNodes(nodes: VNode[]): VNode[];
+export declare function isWhitespaceTextNode(node: VNode): boolean;
+/**
+ * Узлы, которые пользователь действительно видит: без комментариев (их
+ * оставляет после себя каждый `v-if`) и без переносов строк из шаблона.
+ */
+export declare function meaningfulSlotNodes(nodes: VNode[]): VNode[];
+/** Есть ли в слоте хоть что-то, кроме комментариев и пробелов. */
+export declare function hasMeaningfulSlotContent(nodes: VNode[]): boolean;

package/dist/types/src/composables/internal/focusables.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Что пакет считает фокусируемым.
+ *
+ * Один источник правды на ловушку фокуса, roving-навигацию и «первый элемент
+ * панели». До него каждый компонент собирал свой селектор: у `GrDropdown` в
+ * список не попадали `select` и `textarea`, а фильтр видимости стоял на
+ * `offsetParent !== null` — он врёт на `position: fixed` (у таких элементов
+ * `offsetParent` всегда `null`), то есть на панелях самих оверлеев.
+ */
+export declare function isFocusable(element: HTMLElement): boolean;
+/** Участвует ли элемент в таб-порядке (`tabindex="-1"` — нет). */
+export declare function isTabbable(element: HTMLElement): boolean;
+/**
+ * Фокусируемые внутри корня, в порядке документа.
+ *
+ * `tabbableOnly` (по умолчанию) оставляет только участников таб-порядка — это
+ * то, что нужно циклу Tab. Полный список нужен «первому фокусируемому» при
+ * открытии: панель с `tabindex="-1"` фокусируется программно.
+ */
+export declare function getFocusableElements(root: HTMLElement | null | undefined, options?: {
+    tabbableOnly?: boolean;
+}): HTMLElement[];
+/**
+ * Фокусируемые сразу в нескольких корнях, в порядке документа.
+ *
+ * Нужен ловушке: панель селекта, открытого внутри модалки, телепортирована в
+ * `body` и лежит вне DOM-поддерева окна, но для пользователя это продолжение
+ * того же слоя.
+ */
+export declare function getFocusableElementsIn(roots: (HTMLElement | null | undefined)[]): HTMLElement[];