GrJsonViewer

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

interface GrJsonViewerConfigurableProps {
    size: GrComponentSize;
    defaultExpandDepth: number;
    maxStringLength: number;
    maxArrayItems: number;
    searchable: boolean;
    copyable: boolean;
}

type GrJsonNodeKind = 'object' | 'array' | 'string' | 'number' | 'boolean' | 'null'

type GrJsonNode = {
    /** Читаемый адрес узла (`$.items[3].name`). Он же ключ для `GrTree`. */
    path: string;
    /** Имя ключа или индекс. Показывается слева от двоеточия. */
    label: string;
    kind: GrJsonNodeKind;
    /** Что видно в строке. У ветки — счётчик, у листа — значение, возможно обрезанное. */
    preview: string;
    /** Полное значение. Копирование берёт его, а не `preview`. */
    value: unknown;
    /** Показ обрезан: копирование всё равно отдаёт целое. */
    truncated: boolean;
    isLeaf: boolean;
    children?: GrJsonNode[];
};

interface GrJsonViewerProps {
    /** Показываемое значение. `unknown`, потому что приходит из БД или чужого сервиса. */
    value: unknown;
    /** Подпись корня. По умолчанию `$` — так адресуют путь JSONPath и dev-tools. */
    rootLabel?: string;
    /** Сколько уровней раскрыто изначально. */
    defaultExpandDepth?: number;
    /**
     * Длина строкового значения, после которой показ обрезается.
     *
     * Не косметика: запрос к модели с картинкой в base64 — это один лист на
     * сотни тысяч символов, и ни свёртка, ни виртуализация по строкам его не
     * берут. Копирование при этом отдаёт значение целиком.
     */
    maxStringLength?: number;
    /** Сколько элементов массива разбирать до заглушки «ещё N». */
    maxArrayItems?: number;
    /**
     * Панель над деревом: поле поиска и «Развернуть всё / Свернуть всё». По
     * умолчанию **включена** (умолчание меняется через `GrConfigProvider`).
     * `false` убирает панель целиком: поиск остаётся на `filter()`, раскрытие —
     * на `expandAll()`/`collapseAll()` из `defineExpose`.
     */
    searchable?: boolean;
    /** Кнопка копирования узла в строке. */
    copyable?: boolean;
    /** Оставлять в DOM только окно вокруг вьюпорта. Требует `maxHeight`. */
    virtual?: boolean;
    /**
     * Высота области просмотра со своим скроллом — и без `virtual`. Число —
     * пиксели, строка — как есть.
     */
    maxHeight?: string | number;
    /** Имя области для скринридера. Безымянное дерево объявляется просто «дерево». */
    ariaLabel?: string;
    /** Кегль дерева и высота поиска и кнопок панели. Не задан — из `GrConfigProvider`, иначе `md`. */
    size?: GrComponentSize;
}

interface GrJsonViewerEmits {
    /** Узел скопирован: путь для тикета и полное значение. */
    (e: 'copy', payload: {
        path: string;
        value: unknown;
    }): void;
}

const grJsonViewerSafelist: string[];

type GrJsonViewerInstance = ComponentExposed<typeof GrJsonViewerComponent>;