@feugene/granularity 0.19.0 → 0.21.0

package/dist/types/components/GrColorPicker/index.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrColorPickerComponent from './GrColorPicker.vue';
+export { default } from './GrColorPicker.vue';
+export { default as GrColorPicker } from './GrColorPicker.vue';
+export { grColorPickerConfig } from './config';
+export type { GrColorPickerConfigurableProps } from './defaults';
+export type { GrColorPickerEmits, GrColorPickerProps } from './GrColorPicker.vue';
+export type { GrColorPickerSize } from './grColorPickerStyles';
+export { type GrHsla } from './color';
+export { grColorPickerSafelist } from './safelist';
+export type GrColorPickerInstance = ComponentExposed<typeof GrColorPickerComponent>;

package/dist/types/components/GrCommandPalette/GrCommandPalette.vue.d.ts

@@ -0,0 +1,163 @@
+import { type GrCommandFilter, type GrCommandItem } from './filtering';
+import { type GrCommandPaletteSize } from './grCommandPaletteStyles';
+export type { GrCommandFilter, GrCommandGroup, GrCommandItem } from './filtering';
+export type { GrCommandPaletteSize } from './grCommandPaletteStyles';
+/**
+ * Публичный GR-примитив «Command palette» (⌘K) — модальный поиск по командам
+ * приложения с группировкой, подсказками сочетаний и клавиатурной навигацией.
+ *
+ * A11y: WAI-ARIA combobox поверх модалки — `role="combobox"` на поле ввода,
+ * `role="listbox"` на списке, `aria-activedescendant` на активной команде
+ * (фокус остаётся в поле). Esc, фокус-ловушка и блокировка скролла приходят
+ * из `GrModal`.
+ *
+ * Открытие по глобальному сочетанию (`hotkey`, по умолчанию `mod+k` — Cmd на
+ * macOS, Ctrl на прочих) компонент берёт на себя; передайте `hotkey: null`,
+ * чтобы управлять открытием только через `v-model`.
+ */
+export interface GrCommandPaletteProps {
+    /** Открыта ли палитра. */
+    modelValue: boolean;
+    /** Плоский список команд; группировка — по полю `group` самой команды. */
+    items?: GrCommandItem[];
+    /**
+     * Недавние команды: пока запрос пуст, они поднимаются отдельной группой
+     * наверх в этом порядке и не дублируются ниже.
+     */
+    recentIds?: string[];
+    placeholder?: string;
+    size?: GrCommandPaletteSize;
+    /** Глобальное сочетание открытия. `null` — не вешать слушатель. */
+    hotkey?: string | null;
+    /** Локальная фильтрация по запросу. `false` — фильтрует владелец по событию `search`. */
+    filterable?: boolean;
+    /** Кастомный матчер локальной фильтрации. */
+    filter?: GrCommandFilter;
+    /** Внешне управляемое состояние загрузки (для remote-поиска). */
+    loading?: boolean;
+    /** Закрывать палитру после выбора команды. */
+    closeOnSelect?: boolean;
+    /** Максимальная высота списка, px. */
+    maxHeight?: number;
+    /**
+     * Виртуализация списка: в DOM живёт только окно вокруг вьюпорта. Высоту окна
+     * задаёт `maxHeight`.
+     *
+     * Включается осознанно: на сотне команд выигрыша нет, а в разметке остаётся
+     * только окно — вместе с ним меняется и то, что находит `querySelector`
+     * потребителя. Профильный сценарий — палитра приложения на тысячи команд.
+     */
+    virtual?: boolean;
+    /** Показывать подсказку сочетания в поле ввода. */
+    showHotkeyHint?: boolean;
+    emptyText?: string;
+    ariaLabel?: string;
+}
+export interface GrCommandPaletteEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    /** Команда выбрана (клик или Enter). */
+    (e: 'select', item: GrCommandItem): void;
+    /** Поисковый запрос изменился — точка входа для remote-поиска. */
+    (e: 'search', query: string): void;
+}
+import './defaults';
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
+declare var __VLS_25: {
+    item: GrCommandItem;
+    active: boolean;
+}, __VLS_37: {
+    query: string;
+}, __VLS_39: {};
+type __VLS_Slots = {} & {
+    item?: (props: typeof __VLS_25) => any;
+} & {
+    empty?: (props: typeof __VLS_37) => any;
+} & {
+    footer?: (props: typeof __VLS_39) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCommandPaletteProps>, {
+    items: undefined;
+    recentIds: undefined;
+    placeholder: undefined;
+    size: undefined;
+    hotkey: string;
+    filterable: boolean;
+    filter: undefined;
+    loading: boolean;
+    closeOnSelect: boolean;
+    maxHeight: number;
+    virtual: boolean;
+    showHotkeyHint: boolean;
+    emptyText: undefined;
+    ariaLabel: undefined;
+}>>, {
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: boolean) => void;
+    select: (item: GrCommandItem) => void;
+    search: (query: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCommandPaletteProps>, {
+    items: undefined;
+    recentIds: undefined;
+    placeholder: undefined;
+    size: undefined;
+    hotkey: string;
+    filterable: boolean;
+    filter: undefined;
+    loading: boolean;
+    closeOnSelect: boolean;
+    maxHeight: number;
+    virtual: boolean;
+    showHotkeyHint: boolean;
+    emptyText: undefined;
+    ariaLabel: undefined;
+}>>> & Readonly<{
+    onSearch?: ((query: string) => any) | undefined;
+    onSelect?: ((item: GrCommandItem) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: GrCommandPaletteSize;
+    emptyText: string;
+    loading: boolean;
+    filter: GrCommandFilter;
+    maxHeight: number;
+    placeholder: string;
+    ariaLabel: string;
+    filterable: boolean;
+    closeOnSelect: boolean;
+    virtual: boolean;
+    items: GrCommandItem[];
+    recentIds: string[];
+    hotkey: string | null;
+    showHotkeyHint: boolean;
+}, {}, {}, {}, 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> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        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];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrCommandPalette/index.d.ts

@@ -0,0 +1,9 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrCommandPaletteComponent from './GrCommandPalette.vue';
+export { default } from './GrCommandPalette.vue';
+export { default as GrCommandPalette } from './GrCommandPalette.vue';
+export { grCommandPaletteConfig } from './config';
+export type { GrCommandFilter, GrCommandGroup, GrCommandItem, GrCommandPaletteProps, GrCommandPaletteSize, } from './GrCommandPalette.vue';
+export { grCommandPaletteSafelist } from './safelist';
+export type { GrCommandPaletteEmits } from './GrCommandPalette.vue';
+export type GrCommandPaletteInstance = ComponentExposed<typeof GrCommandPaletteComponent>;

package/dist/types/components/GrConfigProvider/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './GrConfigProvider.vue';
+export { default as GrConfigProvider } from './GrConfigProvider.vue';
+export type { GrComponentDefaults, GrComponentSize } from './GrConfigProvider.vue';
+export { type GrComponentDefaultsRegistry, type GrConfigContext, type GrConfigSource, type GrConfigurableComponent, useGrComponentDefaults, useGrComponentProp, useGrComponentSize, type UseGrComponentSizeOptions, useGrConfig, useGrThemeAttrs, } from './context';
+export { grConfigProviderConfig } from './config';
+export type { GrConfigProviderProps } from './GrConfigProvider.vue';

package/dist/types/components/GrDataTable/GrDataTable.vue.d.ts

@@ -0,0 +1,250 @@
+import { type GrDataTableSortDir } from './grDataTableSort';
+import { type GrDataTableSize } from './grDataTableStyles';
+/**
+ * Ключ колонки. Собственные поля строки подсказываются автодополнением, но
+ * произвольная строка тоже допустима: колонка может быть вычисляемой и жить
+ * только в слоте `#cell-<key>`.
+ */
+export type GrDataColumnKey<TRow extends Record<string, unknown> = Record<string, unknown>> = Extract<keyof TRow, string> | (string & {});
+export type GrDataColumn<TRow extends Record<string, unknown> = Record<string, unknown>> = {
+    key: GrDataColumnKey<TRow>;
+    label: string;
+    /**
+     * Заголовок колонки сортирует.
+     *
+     * Сортируется **переданный массив `rows`**, и только он. Над серверной
+     * пагинацией это врёт: «максимальное списание» покажет максимум по текущей
+     * странице, а прочитается как максимум по журналу. Данные приходят
+     * постранично — включайте `externalSort` и сортируйте запросом.
+     */
+    sortable?: boolean;
+    align?: 'left' | 'center' | 'right';
+    /**
+     * Ширина колонки: число — пиксели, строка — как есть (`'40%'`, `'12rem'`).
+     *
+     * Уезжает в заголовочную ячейку: при фиксированной раскладке ширины колонок
+     * задаёт первая строка таблицы, а это и есть `<thead>`.
+     */
+    width?: string | number;
+    /**
+     * Колонка липнет к краю при горизонтальной прокрутке.
+     *
+     * Закреплённые колонки всегда стоят своей группой у своего края — перенос
+     * колонки из группы в группу запрещён, иначе «закреплена слева» перестало бы
+     * означать «слева».
+     */
+    pinned?: 'left' | 'right';
+};
+/**
+ * Значения итоговой строки по ключам колонок.
+ *
+ * Не строка набора: у итога нет ключа, он не сортируется и не выбирается.
+ * Колонка, для которой значения нет, остаётся пустой ячейкой — заполнять все
+ * колонки итог не обязан.
+ */
+export type GrDataTableSummary<TRow extends Record<string, unknown> = Record<string, unknown>> = Partial<Record<GrDataColumnKey<TRow>, unknown>>;
+export type GrDataTableRowKey<TRow extends Record<string, unknown> = Record<string, unknown>> = string | ((row: TRow) => string | number);
+/** Порядок обхода состояний сортировки по клику на заголовок. */
+export type GrDataTableSortCycle = 'asc-desc' | 'asc-desc-none';
+export interface GrDataTableProps<TRow extends Record<string, unknown> = Record<string, unknown>> {
+    rows: TRow[];
+    columns: GrDataColumn<TRow>[];
+    /** Ключ строки или функция-резолвер. По умолчанию — поле `'id'`. */
+    rowKey?: GrDataTableRowKey<TRow>;
+    /** Ключ колонки для начальной сортировки (uncontrolled-режим). */
+    initialSortKey?: string;
+    /** Направление начальной сортировки (uncontrolled-режим). */
+    initialSortDir?: GrDataTableSortDir;
+    /** Контролируемый ключ сортировки: `v-model:sortKey`. Задаёт controlled-режим. */
+    sortKey?: string;
+    /** Контролируемое направление сортировки: `v-model:sortDir`. */
+    sortDir?: GrDataTableSortDir;
+    /** Клик по заголовку: `asc → desc` или `asc → desc → без сортировки`. */
+    sortCycle?: GrDataTableSortCycle;
+    /**
+     * Внешняя сортировка (например серверная): компонент НЕ сортирует `rows`
+     * сам, а только сообщает о смене через `update:sortKey`/`update:sortDir`/
+     * `sortChange`. `rows` при этом должны приходить уже отсортированными.
+     */
+    externalSort?: boolean;
+    /**
+     * Выбор строк: добавляет ведущую колонку с чекбоксами (+ «выбрать все» в шапке).
+     * Выбранные ключи строк — через `v-model:selected`.
+     */
+    selectable?: boolean;
+    /** Контролируемый список выбранных ключей строк: `v-model:selected`. */
+    selected?: Array<string | number>;
+    /** Предикат «строку можно выбрать». Невыбираемые строки не попадают и в «выбрать все». */
+    selectableRow?: (row: TRow) => boolean;
+    /**
+     * Состояние загрузки: тело таблицы заменяется строкой-индикатором.
+     * `empty`-состояние при этом не показывается.
+     */
+    loading?: boolean;
+    /** Текст индикатора загрузки. i18n: fallback `gr.dataTable.loading`. */
+    loadingText?: string;
+    /** Текст пустого состояния. i18n: fallback `gr.dataTable.empty`; слот `#empty` сильнее. */
+    emptyText?: string;
+    /** Класс строки: общий для всех либо вычисляемый по строке. */
+    rowClass?: string | ((row: TRow, index: number) => string | undefined);
+    /** Произвольные атрибуты строки (`data-*`, `title`, …). */
+    rowProps?: (row: TRow, index: number) => Record<string, unknown> | undefined;
+    /**
+     * Итоговая строка в `<tfoot>`: значения по ключам колонок.
+     *
+     * Встаёт по той же колоночной сетке, что и тело, — с теми же паддингами,
+     * выравниванием, ширинами и закреплением. Собранная руками в `#footer`, она
+     * этих классов не получает (`GrTable` их принципиально не даёт) и разъезжается
+     * с телом на первой же смене `size`.
+     *
+     * Итог не суммируется компонентом: что считать итогом — знает приложение.
+     * Оформление ячейки — слот `#summary-<key>`.
+     *
+     * `null` равнозначен отсутствию: `totals ?? null` — обычная запись там, где
+     * итог считается не всегда.
+     */
+    summaryRow?: GrDataTableSummary<TRow> | null;
+    /**
+     * Размер таблицы: кегль, паддинги ячеек, стрелки сортировки и чекбоксы.
+     * Прокидывается в `GrTable`.
+     */
+    size?: GrDataTableSize;
+    caption?: string;
+    ariaLabel?: string;
+    ariaLabelledby?: string;
+    regionLabel?: string;
+    /** Прилипающий заголовок при вертикальном скролле (нужен `maxHeight`). */
+    stickyHeader?: boolean;
+    /**
+     * Виртуализация строк: в DOM живёт только окно вокруг вьюпорта. Высоту окна
+     * задаёт `maxHeight`, без него окна прокрутки не существует.
+     *
+     * Включает фиксированную раскладку таблицы: ширина колонки считается по
+     * содержимому всех строк, а в DOM их только окно — без фиксации колонки
+     * прыгали бы на каждой прокрутке. Ширины стоит задать через `width` у
+     * колонок, иначе фиксированная раскладка делит место поровну.
+     */
+    virtual?: boolean;
+    /** Максимальная высота таблицы (вертикальный скролл). Число — в пикселях. */
+    maxHeight?: string | number;
+    /**
+     * Пользовательский порядок колонок: в шапке появляется ручка переноса.
+     * Колонка тянется указателем и двигается `Shift`+`←`/`→` с клавиатуры.
+     */
+    reorderableColumns?: boolean;
+    /**
+     * Контролируемый порядок колонок — ключи в нужном порядке (`v-model:columnOrder`).
+     * Не задан — порядок компонент помнит сам, начиная с порядка `columns`.
+     */
+    columnOrder?: string[];
+    /**
+     * Пользовательская ширина колонок: у правого края заголовка появляется ручка.
+     * Тянется указателем, с клавиатуры — стрелками (паттерн window splitter).
+     *
+     * Включает фиксированную раскладку таблицы: без неё браузер пересчитывает
+     * ширины по содержимому и заданная пользователем пропадает.
+     */
+    resizableColumns?: boolean;
+    /**
+     * Контролируемые ширины в пикселях по ключу колонки (`v-model:columnWidths`).
+     * Не заданы — ширины компонент помнит сам.
+     */
+    columnWidths?: Record<string, number>;
+}
+export interface GrDataTableEmits<TRow extends Record<string, unknown> = Record<string, unknown>> {
+    (e: 'update:sortKey', value: string): void;
+    (e: 'update:sortDir', value: GrDataTableSortDir): void;
+    (e: 'sortChange', value: {
+        key: string;
+        dir: GrDataTableSortDir;
+    }): void;
+    (e: 'update:selected', value: Array<string | number>): void;
+    (e: 'rowClick', payload: {
+        row: TRow;
+        index: number;
+        event: MouseEvent;
+    }): void;
+    (e: 'update:columnOrder', value: string[]): void;
+    (e: 'columnReorder', payload: {
+        key: string;
+        from: number;
+        to: number;
+    }): void;
+    (e: 'update:columnWidths', value: Record<string, number>): void;
+    (e: 'columnResize', payload: {
+        key: string;
+        width: number;
+    }): void;
+}
+declare const __VLS_export: <TRow extends Record<string, unknown> = Record<string, unknown>>(__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<GrDataTableProps<TRow> & {
+        "onUpdate:sortKey"?: ((value: string) => any) | undefined;
+        "onUpdate:sortDir"?: ((value: GrDataTableSortDir) => any) | undefined;
+        onSortChange?: ((value: {
+            key: string;
+            dir: GrDataTableSortDir;
+        }) => any) | undefined;
+        "onUpdate:selected"?: ((value: (string | number)[]) => any) | undefined;
+        onRowClick?: ((payload: {
+            row: TRow;
+            index: number;
+            event: MouseEvent;
+        }) => any) | undefined;
+        "onUpdate:columnOrder"?: ((value: string[]) => any) | undefined;
+        onColumnReorder?: ((payload: {
+            key: string;
+            from: number;
+            to: number;
+        }) => any) | undefined;
+        "onUpdate:columnWidths"?: ((value: Record<string, number>) => any) | undefined;
+        onColumnResize?: ((payload: {
+            key: string;
+            width: number;
+        }) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        /** Прокрутить к строке по её ключу. `false` — строки нет в DOM. */
+        scrollToRow: (key: string | number, options?: ScrollIntoViewOptions) => boolean;
+        /** Прокрутить скролл-контейнер таблицы. */
+        scrollTo: (options: ScrollToOptions) => void;
+        /** Снять сортировку (эквивалент третьего состояния). */
+        clearSort: () => void;
+        /** Отметить/снять все выбираемые строки. */
+        toggleAll: () => void;
+    }>) => void;
+    attrs: any;
+    slots: { [K in NonNullable<`header-${string & {}}` | `header-${Extract<keyof TRow, string>}`>]?: ((props: {
+        column: GrDataColumn<TRow>;
+    }) => any) | undefined; } & { [K_1 in NonNullable<`header-${string & {}}` | `header-${Extract<keyof TRow, string>}`>]?: ((props: {
+        column: GrDataColumn<TRow>;
+    }) => any) | undefined; } & { [K_2 in NonNullable<`cell-${string & {}}` | `cell-${Extract<keyof TRow, string>}`>]?: ((props: {
+        row: TRow;
+        index: number;
+    }) => any) | undefined; } & { [K_3 in NonNullable<`summary-${string & {}}` | `summary-${Extract<keyof TRow, string>}`>]?: ((props: {
+        value: unknown;
+        column: GrDataColumn<TRow>;
+    }) => any) | undefined; } & {
+        caption?: (props: {}) => any;
+    } & {
+        loading?: (props: {}) => any;
+    } & {
+        empty?: (props: {}) => any;
+    } & {
+        footer?: (props: {
+            columns: GrDataColumn<TRow>[];
+            totalColumns: number;
+        }) => any;
+    };
+    emit: GrDataTableEmits<TRow>;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrDataTable/grDataTableStyles.d.ts

@@ -0,0 +1,74 @@
+import type { GrCheckboxSize } from '../GrCheckbox/grCheckboxStyles';
+import type { GrComponentSize } from '../shared/sizes';
+export type GrDataTableSize = GrComponentSize;
+/** Паддинг ячейки — и в шапке, и в теле: колонки обязаны совпадать по сетке. */
+export declare const cellPaddings: Record<GrDataTableSize, string>;
+/**
+ * Оценка высоты строки по размеру: два вертикальных отступа ячейки плюс строка
+ * текста и рамка. Виртуализация уточняет её замером — точное число здесь знать
+ * неоткуда, содержимое ячейки задаёт потребитель.
+ */
+export declare const rowHeightEstimates: Record<GrDataTableSize, number>;
+/** Заглушки loading/empty: по горизонтали как ячейка, по вертикали просторнее. */
+export declare const placeholderPaddings: Record<GrDataTableSize, string>;
+/**
+ * Ручка перестановки колонки. Появляется по наведению на заголовок и по
+ * фокусу: постоянная сетка ручек в шапке из десяти колонок читается как рябь,
+ * а не как управление.
+ */
+export declare const columnHandleClass = "inline-flex shrink-0 cursor-grab items-center text-[var(--gr-datatable-drag-handle,var(--gr-muted-fg))] opacity-0 [touch-action:none] transition-opacity duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:opacity-100 focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] rounded-[var(--gr-radius-sm)] group-hover:opacity-100";
+export declare const columnHandleActiveClass = "opacity-100";
+/** Переносимая колонка гасится, чтобы было видно, что она «поднята». */
+export declare const columnDraggingClass = "bg-[var(--gr-muted)]";
+/**
+ * Место вставки — полоса по краю ячейки заголовка. Псевдоэлемент, а не свой
+ * узел: `<th>` не терпит посторонних детей в раскладке таблицы.
+ */
+export declare const columnDropBeforeClass = "before:absolute before:inset-y-0 before:left-0 before:w-[var(--gr-datatable-drag-indicator-width,2px)] before:bg-[var(--gr-datatable-drag-indicator,var(--gr-primary))] before:content-empty";
+export declare const columnDropAfterClass = "after:absolute after:inset-y-0 after:right-0 after:w-[var(--gr-datatable-drag-indicator-width,2px)] after:bg-[var(--gr-datatable-drag-indicator,var(--gr-primary))] after:content-empty";
+/**
+ * Подсветка выбранной строки. Живёт здесь, потому что закреплённой ячейке её
+ * приходится повторять: у ячейки свой непрозрачный фон, и подсветка строки
+ * сквозь него не видна.
+ */
+export declare const rowSelectedClass = "bg-[color-mix(in_srgb,var(--gr-primary)_8%,transparent)]";
+/**
+ * Итоговая строка. Отбивка та же, что между строками тела, плюс вес: итог —
+ * вывод из набора, а не ещё одна его запись, и читатель должен видеть это до
+ * того, как разберёт цифры. Тон оставлен потребителю: «возвраты» и «прибыль» —
+ * разные сообщения, и выбирать за него компонент не должен.
+ */
+export declare const summaryRowClass = "border-t border-[var(--gr-brd)] font-600";
+/**
+ * Ручка ширины — полоса у правого края заголовка. Видима она узкой линией, а
+ * ловится широкой зоной: попасть в двухпиксельную границу мышью тяжело.
+ */
+export declare const columnResizerClass = "absolute inset-y-0 right-0 z-[1] flex w-3 translate-x-1/2 cursor-col-resize items-stretch justify-center [touch-action:none] focus:outline-none";
+export declare const columnResizerLineClass = "w-[var(--gr-datatable-resizer-width,2px)] bg-transparent transition-colors duration-[var(--gr-duration-fast)]";
+/** Полоса подсвечивается только когда её ведут или на неё встал фокус. */
+export declare const columnResizerLineActiveClass = "bg-[var(--gr-datatable-resizer,var(--gr-primary))]";
+export declare const columnResizerHoverClass = "hover:bg-[var(--gr-datatable-resizer,var(--gr-primary))] focus-visible:bg-[var(--gr-datatable-resizer,var(--gr-primary))]";
+/**
+ * Закреплённая колонка липнет к краю прокрутки. Фон обязателен: без него
+ * уезжающие под неё ячейки просвечивают насквозь.
+ */
+export declare const columnPinnedClass = "sticky z-[2] bg-[var(--gr-card)]";
+/** Граница группы закреплённых колонок — тень, а не рамка: рамка сдвигает сетку. */
+export declare const columnPinnedLeftEdgeClass = "shadow-[var(--gr-datatable-pinned-shadow,4px_0_6px_-4px_rgba(0,0,0,0.25))]";
+export declare const columnPinnedRightEdgeClass = "shadow-[var(--gr-datatable-pinned-shadow-end,-4px_0_6px_-4px_rgba(0,0,0,0.25))]";
+/** Подпись колонки набирается мельче тела таблицы — она не данные, а навигация. */
+export declare const headerTextSizes: Record<GrDataTableSize, string>;
+/**
+ * Размер `GrCheckbox` в колонке выбора. Здесь не классы, а ступень шкалы:
+ * коробку рисует сам чекбокс — он же держит `indeterminate`, disabled без
+ * `opacity` и фокус-кольцо.
+ */
+export declare const selectCheckboxSizes: Record<GrDataTableSize, GrCheckboxSize>;
+/** Ширина колонки выбора: коробка чекбокса плюс горизонтальный паддинг ячейки. */
+export declare const selectColumnWidths: Record<GrDataTableSize, string>;
+/** Зазор между подписью колонки и стрелкой сортировки. */
+export declare const headerGaps: Record<GrDataTableSize, string>;
+/** Спиннер в строке загрузки — тем же кеглем, что иконка сортировки рядом. */
+export declare const spinnerSizes: Record<GrDataTableSize, string>;
+/** Стрелка сортировки берёт размер из шкалы `GrIcon` (`xs…lg` → `14…20px`). */
+export declare const sortIconSizes: Record<GrDataTableSize, GrComponentSize>;

package/dist/types/components/GrDataTable/index.d.ts

@@ -0,0 +1,12 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrDataTableComponent from './GrDataTable.vue';
+export { default } from './GrDataTable.vue';
+export { default as GrDataTable } from './GrDataTable.vue';
+export type { GrDataColumn, GrDataColumnKey, GrDataTableProps, GrDataTableRowKey, GrDataTableSortCycle, GrDataTableSummary, } from './GrDataTable.vue';
+export type { GrDataTableSortDir } from './grDataTableSort';
+export { grDataTableConfig } from './config';
+export type { GrDataTableConfigurableProps } from './defaults';
+export type { GrDataTableSize } from './grDataTableStyles';
+export { grDataTableSafelist } from './safelist';
+export type { GrDataTableEmits } from './GrDataTable.vue';
+export type GrDataTableInstance = ComponentExposed<typeof GrDataTableComponent>;

package/dist/types/components/GrDelta/GrDelta.vue.d.ts

@@ -0,0 +1,84 @@
+import { type GrDeltaPolarity } from './deltaTone';
+import type { GrComponentSize } from '../shared/sizes';
+export type { GrDeltaPolarity, GrDeltaTone } from './deltaTone';
+/**
+ * Величина со знаком и тоном **внутри строки текста**: «Дельта: +$0.004».
+ *
+ * Компонент презентационный: дельту не считает и периоды не сравнивает —
+ * «к чему сравнивать» знает приложение. Блочная плитка показателя — `GrStatistic`.
+ */
+export interface GrDeltaProps {
+    /** Величина. `null` — её нет; это не ноль. */
+    value: number | null;
+    /** Знаков после запятой. Не задано — как отдаст локаль. */
+    precision?: number;
+    /** Приписка перед числом: валюта, единица. */
+    prefix?: string;
+    /** Приписка после числа: `%`, `мс`. */
+    suffix?: string;
+    /**
+     * Что считать хорошим. Для выручки рост — успех, для себестоимости и времени
+     * отклика — наоборот; без этого компонент врал бы в половине случаев.
+     */
+    polarity?: GrDeltaPolarity;
+    /** Ставить `+` у положительных. Минус подставляет `Intl` сам. */
+    showSign?: boolean;
+    /** Стрелка направления. Декоративна: направление уже в знаке. */
+    showArrow?: boolean;
+    /** Чем печатать отсутствующую величину. */
+    emptyText?: string;
+    /** Локаль форматирования. Не задана — локаль i18n-адаптера. */
+    locale?: string;
+    size?: GrComponentSize;
+}
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDeltaProps>, {
+    precision: undefined;
+    prefix: undefined;
+    suffix: undefined;
+    polarity: undefined;
+    showSign: undefined;
+    showArrow: undefined;
+    emptyText: undefined;
+    locale: undefined;
+    size: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDeltaProps>, {
+    precision: undefined;
+    prefix: undefined;
+    suffix: undefined;
+    polarity: undefined;
+    showSign: undefined;
+    showArrow: undefined;
+    emptyText: undefined;
+    locale: undefined;
+    size: undefined;
+}>>> & Readonly<{}>, {
+    size: GrComponentSize;
+    polarity: GrDeltaPolarity;
+    showSign: boolean;
+    showArrow: boolean;
+    emptyText: string;
+    prefix: string;
+    suffix: string;
+    locale: string;
+    precision: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrDelta/config.d.ts

@@ -0,0 +1 @@
+export declare const grDeltaConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrDelta">;

package/dist/types/components/GrDelta/defaults.d.ts

@@ -0,0 +1,22 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrDeltaPolarity } from './deltaTone';
+/**
+ * Пропы `GrDelta`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrDelta: { … } }">`.
+ *
+ * `polarity` здесь наравне с оформлением не случайно: в отчёте по расходам
+ * «рост — плохо» верно для всех величин сразу, и повторять это на каждой
+ * значит однажды забыть.
+ */
+export interface GrDeltaConfigurableProps {
+    size: GrComponentSize;
+    polarity: GrDeltaPolarity;
+    showSign: boolean;
+    showArrow: boolean;
+    emptyText: string;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrDelta: GrDeltaConfigurableProps;
+    }
+}