GrTree

type GrTreeKey = string | number;

type GrTreeNodeDropType = 'prev' | 'inner' | 'next';

type GrTreeAllowDropType = GrTreeNodeDropType;

type GrTreeNode<T = any> = {
    key: GrTreeKey;
    label: string;
    data: T;
    level: number;
    parent?: GrTreeNode<T>;
    childNodes: GrTreeNode<T>[];
};

type GrTreeNodeTarget<T = any> = GrTreeKey | GrTreeNode<T> | T;

type GrTreeInstance<T = any> = {
    filter: (value: string) => void;

type GrTreePropsMap = {
    children?: string;
    label?: string;
    /** Поле данных «узел — лист». Нужно ленивому режиму: детей ещё нет, а раскрывать нечего. */
    isLeaf?: string;
};

type GrTreeFilterNodeMethod<T extends object = any> = (value: string, data: T, node?: GrTreeNode<T>) => boolean;
export type GrTreeBranchLine = 'line' | 'elbow';
export type GrTreeBranchLineColor<T extends object = any> = string | ((node: GrTreeNode<T>) => string | undefined | null);
export type GrTreeVisibleRow<T extends object> = {
    node: GrTreeNode<T>;
    isExpanded: boolean;
    isLeaf: boolean;
    isMatched: boolean;
    /**
     * Место узла среди соседей. В плоском 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);
export type GrTreeDataProps<T extends object> = {
    /**
     * Корневые узлы в исходной форме. Дерево их не копирует: перенос и `appendNode` меняют эти
     * массивы на месте.
     */
    data: T[];
    /** Имена полей в данных: `children`, `label`, `isLeaf`. По умолчанию `children` и `label`. */
    props?: GrTreePropsMap;
    /** Поле с уникальным ключом узла: на нём держатся раскрытие, отметки, перенос. По умолчанию `id`. */
    nodeKey?: NodeKeyProp<T> | 'id';
    /** Стартовый набор раскрытых узлов. Новый массив в пропе заменяет раскрытие целиком. */
    defaultExpandedKeys?: GrTreeKey[];
    /**
     * Раскрывать узлы, как только они появились в данных. Уже свёрнутое руками
     * не раскрывается обратно на каждом обновлении `data`.
     */
    defaultExpandAll?: boolean;
    /**
     * Своё правило совпадения узла с фильтром; `undefined` из него — правило по умолчанию: подстрока
     * подписи без учёта регистра. Совпавший узел остаётся видимым вместе с предками.
     */
    filterNodeMethod?: GrTreeFilterNodeMethod<T>;
    /**
     * Значение фильтра. Проп, а не только метод `filter()`: обёртке иначе
     * приходится держать `ref` на дерево и гонять значение в обход собственного
     * реактивного контура.
     *
     * Результат фильтрации дерево сообщает событием `filter` — без него нельзя
     * отличить «данных нет» от «поиск ничего не нашёл», а это разные экраны.
     */
    filterValue?: string;
    /**
     * Ленивый режим: дети ветки приходят по её раскрытию через `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;
    /**
     * Максимальная высота дерева со своим скроллером — всегда, не только с
     * `virtual`: тот лишь кладёт поверх окно строк. Число — пиксели.
     */
    maxHeight?: number | string;
    /** Подсвечивать строку текущего узла. По умолчанию `true`. */
    highlightCurrent?: boolean;
    /**
     * Иконка свёрнутого узла: Vue-компонент либо класс иконки (`'i-lucide-plus'` —
     * правило для класса заводит приложение: фабрике движка или провайдером,
     * см. `docs/installation.md#иконки`).
     * Не задана — встроенная стрелка.
     */
    expandIcon?: string | Component;
    /** Иконка раскрытого узла. Не задана — та же встроенная стрелка, повёрнутая. */
    collapseIcon?: string | Component;
    /** Поворот иконки раскрытого узла на 90°: хватает одной `expandIcon`. По умолчанию `true`. */
    toggleIconRotate?: boolean;
    /**
     * Направляющие уровней. `true` — то же, что `'line'`: одна вертикаль на
     * уровень. `'elbow'` добавляет горизонтальное колено к строке и обрывает
     * линию на середине последнего ребёнка — так видно не только уровень, но и
     * то, какие ветки ещё продолжаются.
     */
    branchLine?: boolean | GrTreeBranchLine;
    /**
     * Цвет направляющих: CSS-значение или функция от узла. Не задан —
     * `--gr-tree-branch-line-default-color`, иначе цвет рамки.
     */
    branchLineColor?: GrTreeBranchLineColor<T>;
    /** Цвет направляющей у ветки текущего узла: значение или функция. Не задан — `branchLineColor`. */
    branchLineActiveColor?: GrTreeBranchLineColor<T>;
    /**
     * Класс строки узла — значением или функцией от строки (`node`, `isExpanded`, `isLeaf`,
     * `isMatched`). Перебивает кегль и цвет дерева: так делают ступени по уровням.
     */
    rowClass?: GrTreeNodeClass<T>;
    /** Класс ручки переноса — значением или функцией от строки. */
    dragHandleClass?: GrTreeNodeClass<T>;
    /** Класс кнопки раскрытия — значением или функцией от строки. */
    toggleClass?: GrTreeNodeClass<T>;
    /** Класс иконки раскрытия — значением или функцией от строки. */
    toggleIconClass?: GrTreeNodeClass<T>;
    /** Класс заглушки на месте кнопки раскрытия у листа — значением или функцией от строки. */
    toggleSpacerClass?: GrTreeNodeClass<T>;
    /** Класс обёртки содержимого строки (подписи или слота) — значением или функцией от строки. */
    contentClass?: GrTreeNodeClass<T>;
    /** i18n-метка кнопки "Перетащить" (default: 'Drag'). */
    dragLabel?: string;
    /** i18n-метка кнопки "Развернуть" (default: 'Expand'). */
    expandLabel?: string;
    /** i18n-метка кнопки "Свернуть" (default: 'Collapse'). */
    collapseLabel?: string;
};
export type GrTreeInteractionProps<T extends object> = {
    /** Клик по строке раскрывает/сворачивает узел, а не только выбирает его. */
    expandOnClickNode?: boolean;
    /** На каждом уровне раскрыт максимум один узел. */
    accordion?: boolean;
    /** Перенос узлов мышью, пальцем и `Shift` со стрелкой. Ограничивают `allowDrag` и `allowDrop`. */
    draggable?: boolean;
    /** Иконка ручки переноса: компонент, класс иконки или ничего — тогда встроенная. */
    dragHandleIcon?: string | Component;
    /** Можно ли уронить узел на цель: `prev` — перед ней, `inner` — внутрь, `next` — после. */
    allowDrop?: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, type: GrTreeAllowDropType) => boolean;
    /** Можно ли взять узел: `false` выключает его ручку переноса. */
    allowDrag?: (draggingNode: GrTreeNode<T>) => boolean;
    /**
     * Когда показывать ручку переноса.
     *
     * `hover` — только под курсором; `always` — всегда; `auto` (по умолчанию) —
     * `always` там, где наведения не бывает (`@media (hover: none)`), иначе
     * `hover`. На тач-устройстве ручка «по наведению» недостижима вовсе, то есть
     * перетаскивания там нет — а это не решение дизайна, а отсутствие функции.
     */
    dragHandleVisibility?: 'hover' | 'always' | 'auto';
};
export type GrTreeSelectionProps = {
    /** Чекбоксы у узлов: множественный выбор поверх дерева. */
    showCheckbox?: boolean;
    /**
     * Текущий узел — `v-model:current-key`.
     *
     * Не задан — дерево ведёт текущий узел само, как и раньше. Задан — источник
     * правды снаружи: подсветка строки и признак, по которому обёртка рисует
     * собственные детали, перестают быть двумя разными состояниями, способными
     * разойтись на такт.
     */
    currentKey?: GrTreeKey | null;
    /** Отмеченные ключи (`v-model:checked-keys`). */
    checkedKeys?: GrTreeKey[];
    /** Стартовые отметки, когда `checkedKeys` не ведут снаружи. Читаются один раз, при создании. */
    defaultCheckedKeys?: GrTreeKey[];
    /** Не связывать родителей и детей: каждый узел отмечается сам по себе. */
    checkStrictly?: boolean;
};
export type GrTreeProps<T extends object> = GrTreeDataProps<T> & GrTreeViewProps<T> & GrTreeSelectionProps & GrTreeInteractionProps<T>;

type GrTreeBranchLineColor<T extends object = any> = string | ((node: GrTreeNode<T>) => string | undefined | null);
export type GrTreeVisibleRow<T extends object> = {

type GrTreeVisibleRow<T extends object> = {
    node: GrTreeNode<T>;
    isExpanded: boolean;
    isLeaf: boolean;
    isMatched: boolean;
    /**
     * Место узла среди соседей. В плоском DOM группы нет, поэтому структуру
     * дерева диктору сообщают `aria-level` + `aria-posinset` + `aria-setsize`.
     */
    posInSet: number;
    setSize: number;
    /** Идёт ли сейчас ленивая загрузка детей этого узла. */
    isLoading: boolean;
    /** Цвета направляющих для уровней предков (пусто, если `branchLine` выключен). */
    branchColors: string[];
};

type GrTreeNodeClass<T extends object> = GrTreeClassValue | ((row: GrTreeVisibleRow<T>) => GrTreeClassValue);
export type GrTreeDataProps<T extends object> = {

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;
    /**
     * Максимальная высота дерева со своим скроллером — всегда, не только с
     * `virtual`: тот лишь кладёт поверх окно строк. Число — пиксели.
     */
    maxHeight?: number | string;
    /** Подсвечивать строку текущего узла. По умолчанию `true`. */
    highlightCurrent?: boolean;
    /**
     * Иконка свёрнутого узла: Vue-компонент либо класс иконки (`'i-lucide-plus'` —

type GrTreeSelectionProps = {
    /** Чекбоксы у узлов: множественный выбор поверх дерева. */
    showCheckbox?: boolean;
    /**
     * Текущий узел — `v-model:current-key`.
     *
     * Не задан — дерево ведёт текущий узел само, как и раньше. Задан — источник
     * правды снаружи: подсветка строки и признак, по которому обёртка рисует
     * собственные детали, перестают быть двумя разными состояниями, способными
     * разойтись на такт.
     */
    currentKey?: GrTreeKey | null;
    /** Отмеченные ключи (`v-model:checked-keys`). */
    checkedKeys?: GrTreeKey[];
    /** Стартовые отметки, когда `checkedKeys` не ведут снаружи. Читаются один раз, при создании. */
    defaultCheckedKeys?: GrTreeKey[];
    /** Не связывать родителей и детей: каждый узел отмечается сам по себе. */
    checkStrictly?: boolean;
};

type GrTreeProps<T extends object> = GrTreeDataProps<T> & GrTreeViewProps<T> & GrTreeSelectionProps & GrTreeInteractionProps<T>;

type GrTreeCheckState = typeof GR_TREE_CHECK_STATES[number];

const grTreeConfig: import("@feugene/granum/contract").GranumComponentDescriptor<"GrTree">;

interface GrTreeConfigurableProps {
    size: GrComponentSize;
}

type GrTreeSize = GrComponentSize;

type GrTreeView = 'explorer' | 'rail' | 'outline' | 'picker';

const grTreeViewVars: Record<GrTreeView, Record<string, string>>;

const grTreeSafelist: readonly [];

interface GrTreeEmits<T extends Record<string, any> = any> {
    /** Узел выбран кликом или `Enter` и стал текущим. */
    (e: 'nodeClick', data: T, node: GrTreeNode<T>): void;
    /** Узел раскрыт кнопкой, клавиатурой или кликом при `expandOnClickNode`. */
    (e: 'nodeExpand', data: T, node: GrTreeNode<T>): void;
    /** Узел свёрнут — пользователем или `accordion`, когда раскрыли соседа. */
    (e: 'nodeCollapse', data: T, node: GrTreeNode<T>): void;
    /**
     * Узел перенесён указателем или `Shift` со стрелкой и уже переставлен в `data`. `dropType` —
     * `prev`, `inner` или `next` относительно `dropNode`.
     */
    (e: 'nodeDrop', draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType): void;
    /** Контекстное меню строки. Событие — первым аргументом: `preventDefault()` и своё меню. */
    (e: 'nodeContextMenu', evt: MouseEvent, data: T, node: GrTreeNode<T>): void;
    /** Текущий узел сменился кликом или `Enter` (`v-model:current-key`). */
    (e: 'update:currentKey', key: GrTreeKey | undefined): void;
    /**
     * Результат фильтрации. Без него потребитель не отличит «данных нет» от
     * «поиск ничего не нашёл» — а это разные пустые экраны: второй пользователь
     * может исправить сам.
     */
    (e: 'filter', info: {
        value: string;
        visibleCount: number;
        matchedCount: number;
    }): void;
    /**
     * Отмеченные ключи (`v-model:checked-keys`) после отметки пользователем или методом; родители,
     * отмеченные каскадом, входят тоже.
     */
    (e: 'update:checkedKeys', keys: GrTreeKey[]): void;
    /** Отметка узла сменилась — `Space`, кликом или `setChecked()`; с итоговыми наборами ключей. */
    (e: 'check', data: T, node: GrTreeNode<T>, info: {
        checkedKeys: GrTreeKey[];
        halfCheckedKeys: GrTreeKey[];
    }): void;
}