@feugene/granularity 0.12.0 → 0.16.0

package/dist/types/src/components/GrStatistic/formatStatisticValue.d.ts

@@ -0,0 +1,20 @@
+export type GrStatisticFormatOptions = {
+    /** Число знаков после запятой. `undefined` — оставить как есть. */
+    precision?: number;
+    /** Разделитель групп разрядов. Сильнее локали. */
+    groupSeparator?: string;
+    /** Десятичный разделитель. Сильнее локали. */
+    decimalSeparator?: string;
+    /** BCP-47 локаль: разделители берутся из `Intl.NumberFormat`. */
+    locale?: string;
+};
+/**
+ * Форматирует значение показателя: фиксирует точность и расставляет разделители.
+ *
+ * Нечисловые значения возвращаются без изменений — это позволяет показывать в
+ * `GrStatistic` уже готовые строки («2 ч 15 мин», «—») без обходных пропов.
+ * Вынесено из SFC отдельным модулем, чтобы тестировалось без монтирования.
+ *
+ * Порядок разрешения разделителей: явный проп → локаль → встроенный дефолт.
+ */
+export declare function formatStatisticValue(value: number | string, options?: GrStatisticFormatOptions): string;

package/dist/types/src/components/GrStatistic/grStatisticStyles.d.ts

@@ -0,0 +1,37 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrTone } from '../shared/tones';
+export type GrStatisticSize = GrComponentSize;
+export type GrStatisticTone = GrTone;
+/** Направление динамики показателя. */
+export type GrStatisticTrend = 'up' | 'down' | 'flat';
+/**
+ * Кастомизация через CSS-переменные:
+ *
+ * - `--gr-statistic-value-color` — цвет значения (по умолчанию — из `tone`).
+ * - `--gr-statistic-title-color` — цвет подписи показателя.
+ */
+export declare const statisticTitleSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticValueSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticAffixSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticPlaceholderHeightBySize: Record<GrStatisticSize, string>;
+export declare const statisticTrendSizeBySize: Record<GrStatisticSize, string>;
+export declare const statisticValueClassByTone: Record<GrStatisticTone, string>;
+export declare const statisticTrendClassByTrend: Record<GrStatisticTrend, string>;
+export declare const statisticTrendIconByTrend: Record<GrStatisticTrend, string>;
+export declare const statisticTitleClass = "font-medium tracking-wide text-[var(--gr-statistic-title-color,var(--gr-muted-fg))]";
+export declare const statisticRootBase = "flex items-start gap-3 text-left";
+/**
+ * Показатель-ссылка или показатель-кнопка. Своей заливки не получает: плитка
+ * дашборда обычно уже лежит в `GrCard`, и вторая поверхность спорила бы с ней.
+ * Видимость интерактивности держат курсор, фокус-кольцо и подсветка подписи.
+ */
+export declare const statisticRootInteractiveClass = "w-full cursor-pointer rounded-[var(--gr-radius-md)] transition-colors hover:bg-[var(--gr-muted)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare function statisticRootClass(options: {
+    interactive: boolean;
+}): string;
+/** `tabular-nums` держит ширину строки при переборе чисел и при смене значения. */
+export declare const statisticValueTypographyClass = "font-semibold [font-variant-numeric:tabular-nums]";
+export declare function statisticValueClass(options: {
+    size: GrStatisticSize;
+    tone: GrStatisticTone;
+}): string;

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

@@ -0,0 +1,7 @@
+export { default } from './GrStatistic.vue';
+export { default as GrStatistic } from './GrStatistic.vue';
+export { grStatisticConfig } from './config';
+export { formatStatisticValue } from './formatStatisticValue';
+export type { GrStatisticEmits, GrStatisticFormatOptions, GrStatisticProps, GrStatisticSize, GrStatisticTone, GrStatisticTrend, } from './GrStatistic.vue';
+export { grStatisticSafelist } from './safelist';
+export type { GrStatisticConfigurableProps } from './defaults';

package/dist/types/src/components/GrStatistic/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grStatisticSafelist: string[];

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

@@ -1,42 +1,104 @@
-import { type GrSwitchSize } from './grSwitchStyles';
-export type { GrSwitchSize } from './grSwitchStyles';
+import { type GrSwitchLabelPosition, type GrSwitchSize } from './grSwitchStyles';
+export type { GrSwitchLabelPosition, GrSwitchSize } from './grSwitchStyles';
 /**
  * Пропсы публичного GR-примитива «Switch».
  */
 export interface GrSwitchProps {
     modelValue: boolean;
     disabled?: boolean;
+    /** Только для чтения: состояние видно, но не переключается. */
+    readonly?: boolean;
+    /** Визуальное и ARIA-состояние ошибки. */
+    invalid?: boolean;
+    /** Обязательное поле (`aria-required`). */
+    required?: boolean;
     ariaLabel?: string;
     size?: GrSwitchSize;
-    /** Кастомный цвет фона в активном состоянии. Если не задан — `var(--primary)`. */
+    /** Сторона подписи относительно дорожки. */
+    labelPosition?: GrSwitchLabelPosition;
+    /** Идёт сохранение: бегунок показывает спиннер, переключение заблокировано. */
+    loading?: boolean;
+    /** i18n: что именно грузится. `aria-busy` сам по себе часть AT не объявляет. */
+    loadingText?: string;
+    /** Имя поля для нативной отправки формы. Без него скрытое поле не рендерится. */
+    name?: string;
+    /** Значение, уходящее в форму во включённом состоянии. */
+    value?: string;
+    /** `id` формы, если переключатель лежит вне неё. */
+    form?: string;
+    /** Кастомный цвет фона в активном состоянии. Если не задан — `var(--gr-primary)`. */
     activeBackgroundColor?: string;
-    /** Кастомный цвет фона в неактивном состоянии. Если не задан — `var(--muted)`. */
+    /** Кастомный цвет фона в неактивном состоянии. Если не задан — `var(--gr-muted)`. */
     inactiveBackgroundColor?: string;
 }
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+export interface GrSwitchEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    (e: 'change', value: boolean): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+declare function focus(): void;
+declare function blur(): void;
+type __VLS_Slots = {
+    /** Подпись переключателя. */
+    default?: () => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSwitchProps>, {
     disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
     ariaLabel: undefined;
-    size: string;
+    size: undefined;
+    labelPosition: string;
+    loading: boolean;
+    loadingText: undefined;
+    name: undefined;
+    value: string;
+    form: undefined;
     activeBackgroundColor: undefined;
     inactiveBackgroundColor: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+}>>, {
+    focus: typeof focus;
+    blur: typeof blur;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => void;
+    change: (value: boolean) => void;
+    focus: (event: FocusEvent) => void;
+    blur: (event: FocusEvent) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSwitchProps>, {
     disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
     ariaLabel: undefined;
-    size: string;
+    size: undefined;
+    labelPosition: string;
+    loading: boolean;
+    loadingText: undefined;
+    name: undefined;
+    value: string;
+    form: undefined;
     activeBackgroundColor: undefined;
     inactiveBackgroundColor: undefined;
 }>>> & Readonly<{
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onChange?: ((value: boolean) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
     size: GrSwitchSize;
+    labelPosition: GrSwitchLabelPosition;
+    value: string;
+    readonly: boolean;
+    form: string;
+    name: string;
+    invalid: boolean;
+    loading: boolean;
     disabled: boolean;
+    required: boolean;
     ariaLabel: string;
+    loadingText: string;
     activeBackgroundColor: string;
     inactiveBackgroundColor: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

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

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

@@ -0,0 +1,14 @@
+import type { GrSwitchSize } from './grSwitchStyles';
+/**
+ * Пропы `GrSwitch`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrSwitch: { … } }">`.
+ * Только оформление — см. `GrButton/defaults.ts`.
+ */
+export interface GrSwitchConfigurableProps {
+    size: GrSwitchSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrSwitch: GrSwitchConfigurableProps;
+    }
+}

package/dist/types/src/components/GrSwitch/grSwitchStyles.d.ts

@@ -1,19 +1,60 @@
-export type GrSwitchSize = 'sm' | 'md' | 'lg';
+import type { GrComponentSize } from '../shared/sizes';
+export type GrSwitchSize = GrComponentSize;
+/** Сторона подписи относительно дорожки — логическая, не физическая (RTL). */
+export declare const GR_SWITCH_LABEL_POSITIONS: readonly ["start", "end"];
+export type GrSwitchLabelPosition = typeof GR_SWITCH_LABEL_POSITIONS[number];
 type GrSwitchThumbClassOptions = {
     checked: boolean;
     size: GrSwitchSize;
 };
-export declare const trackBase = "relative inline-flex shrink-0 items-center rounded-full border border-[var(--gr-switch-track-brd)] transition-colors duration-150";
+export declare const rootBase = "inline-flex items-center gap-2 select-none disabled:cursor-not-allowed";
+/** `start` разворачивает ряд, а не меняет порядок узлов: DOM-порядок читает диктор. */
+export declare const rootLabelPositions: Record<GrSwitchLabelPosition, string>;
+export declare const trackBase = "relative inline-flex shrink-0 items-center rounded-[var(--gr-radius-full)] border border-[var(--gr-switch-track-brd)] transition-colors duration-[var(--gr-duration-fast)]";
 export declare const trackSizes: Record<GrSwitchSize, string>;
-export declare const thumbBase = "inline-block shrink-0 rounded-full bg-[var(--card)] shadow-[var(--gr-shadow-1)] transition-transform duration-150";
+export declare const thumbBase = "inline-flex shrink-0 items-center justify-center rounded-[var(--gr-radius-full)] bg-[var(--gr-card)] shadow-[var(--gr-shadow-1)] transition-transform duration-[var(--gr-duration-fast)]";
 export declare const thumbSizes: Record<GrSwitchSize, string>;
+/** Спиннер загрузки живёт в бегунке, поэтому мельче его на ступень. */
+export declare const thumbSpinnerSizes: Record<GrSwitchSize, string>;
+export declare const thumbSpinnerBase = "animate-spin text-[var(--gr-muted-fg)]";
+/**
+ * Сдвиг бегунка по горизонтали.
+ *
+ * Бегунок — обычный флекс-ребёнок дорожки, поэтому сдвиг отсчитывается от её
+ * **content-box**, а он на 2px уже внешнего размера: рамка по 1px с каждой
+ * стороны. Отсюда и весь расчёт.
+ *
+ * Зазор по вертикали задан геометрией и равен 1px на всех ступенях
+ * (`(content-height − thumb) / 2`, дорожка центрирует бегунок сама). Значит и по
+ * горизонтали он обязан быть 1px: иначе бегунок в покое выглядит вдавленным
+ * внутрь, а в крайнем положении прижатым к краю — именно так и было, зазоры
+ * расходились на 1–2px у `xs`, `sm` и `lg`.
+ *
+ * | ступень | дорожка | content | бегунок | покой | крайнее |
+ * | --- | --- | --- | --- | --- | --- |
+ * | `xs` | 28 | 26 | 12 | 1 | 13 |
+ * | `sm` | 36 | 34 | 16 | 1 | 17 |
+ * | `md` | 44 | 42 | 20 | 1 | 21 |
+ * | `lg` | 56 | 54 | 24 | 1 | 29 |
+ *
+ * Крайнее положение — `content − thumb − зазор`. Гейт на эту арифметику живёт в
+ * `__tests__/GrSwitch.test.ts`: он считает её заново из `trackSizes`/`thumbSizes`,
+ * поэтому смена любой ступени размера сразу покажет разъехавшийся зазор.
+ */
 export declare const thumbTranslations: Record<GrSwitchSize, {
     checked: string;
     unchecked: string;
 }>;
-export declare const labelBase = "text-[var(--muted-fg)]";
+export declare const labelBase = "text-[var(--gr-muted-fg)]";
+/**
+ * Недоступность гасится токеном, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA токены текста и роняет контраст подписи.
+ */
+export declare const labelDisabledClass = "text-[var(--gr-disabled-fg)]";
 export declare const labelSizes: Record<GrSwitchSize, string>;
+export declare function grSwitchRootClass(labelPosition: GrSwitchLabelPosition): string;
 export declare function grSwitchTrackClass(size: GrSwitchSize): string;
 export declare function grSwitchThumbClass(options: GrSwitchThumbClassOptions): string;
-export declare function grSwitchLabelClass(size: GrSwitchSize): string;
+export declare function grSwitchSpinnerClass(size: GrSwitchSize): string;
+export declare function grSwitchLabelClass(size: GrSwitchSize, disabled?: boolean): string;
 export {};

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

@@ -1,5 +1,10 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrSwitchComponent from './GrSwitch.vue';
 export { default } from './GrSwitch.vue';
 export { default as GrSwitch } from './GrSwitch.vue';
 export { grSwitchConfig } from './config';
+export type { GrSwitchConfigurableProps } from './defaults';
 export { grSwitchSafelist } from './safelist';
-export type { GrSwitchProps, GrSwitchSize } from './GrSwitch.vue';
+export type { GrSwitchLabelPosition, GrSwitchProps, GrSwitchSize } from './GrSwitch.vue';
+export type { GrSwitchEmits } from './GrSwitch.vue';
+export type GrSwitchInstance = ComponentExposed<typeof GrSwitchComponent>;

package/dist/types/src/components/GrSwitch/safelist.d.ts

@@ -1,10 +1,13 @@
 export declare const grSwitchClassTokens: {
+    readonly rootBase: string[];
+    readonly rootLabelPositions: string[];
     readonly trackBase: string[];
     readonly trackSizes: string[];
     readonly thumbBase: string[];
     readonly thumbSizes: string[];
+    readonly thumbSpinner: readonly string[];
     readonly thumbTranslations: string[];
-    readonly labelBase: string[];
+    readonly labelBase: readonly string[];
     readonly labelSizes: string[];
 };
 export declare const grSwitchSafelist: string[];

package/dist/types/src/components/GrTabPanels/GrTabPanel.vue.d.ts

@@ -1,21 +1,24 @@
-/**
- * GrTabPanel — одна панель внутри `GrTabPanels`. Показывается, когда её `value`
- * равно активной вкладке. `keepAlive` оставляет неактивные панели в DOM
- * (скрытыми через `hidden`) — полезно, чтобы не терять состояние форм.
- */
-type __VLS_Props = {
+export interface GrTabPanelProps {
     value: string;
     keepAlive?: boolean;
-};
+    /**
+     * Не монтировать содержимое, пока панель не показали впервые. Имеет смысл
+     * вместе с `keepAlive`: без него неактивная панель и так не в DOM.
+     */
+    lazy?: boolean;
+}
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabPanelProps>, {
     keepAlive: boolean;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    lazy: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabPanelProps>, {
     keepAlive: boolean;
+    lazy: boolean;
 }>>> & Readonly<{}>, {
+    lazy: boolean;
     keepAlive: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

@@ -1,24 +1,14 @@
-/**
- * GrTabPanels — контейнер `tabpanel`-ов, companion к `GrTabs`.
- *
- * Показывает панель, чьё `value` совпадает с `modelValue`, и связывает её с
- * соответствующей вкладкой по ARIA (`role="tabpanel"`, `aria-labelledby`).
- *
- * Для полной связки `tab`↔`tabpanel` передайте **одинаковый `idBase`** и в
- * `GrTabs`, и в `GrTabPanels` — тогда id вкладок и панелей совпадут
- * (`aria-controls` ↔ `aria-labelledby`).
- */
-type __VLS_Props = {
+export interface GrTabPanelsProps {
     modelValue: string;
     idBase?: string;
-};
+}
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabPanelsProps>, {
     idBase: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabPanelsProps>, {
     idBase: undefined;
 }>>> & Readonly<{}>, {
     idBase: string;

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

@@ -2,4 +2,4 @@
  * Granular-конфиг семейства `GrTabPanels` (контейнер `GrTabPanels` + панель
  * `GrTabPanel`). Companion к `GrTabs` для ARIA-связки `tab`↔`tabpanel`.
  */
-export declare const grTabPanelsConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrTabPanels">;
+export declare const grTabPanelsConfig: import("@feugene/unocss-preset-granular/contract").GranularComponentDescriptor<"GrTabPanels">;

package/dist/types/src/components/GrTabPanels/context.d.ts

@@ -4,6 +4,6 @@ export interface GrTabPanelsContext {
     /** Значение активной вкладки (совпадает с `modelValue` у `GrTabs`). */
     activeValue: ComputedRef<string>;
     /** Общая база id для связки `tab`↔`tabpanel` (см. проп `idBase` у `GrTabs`). */
-    idBase: string;
+    idBase: ComputedRef<string>;
 }
 export declare const GR_TAB_PANELS_KEY: InjectionKey<GrTabPanelsContext>;

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

@@ -4,3 +4,5 @@ export { default as GrTabPanel } from './GrTabPanel.vue';
 export type { GrTabPanelsContext } from './context';
 export { GR_TAB_PANELS_KEY } from './context';
 export { grTabPanelsConfig } from './config';
+export type { GrTabPanelsProps } from './GrTabPanels.vue';
+export type { GrTabPanelProps } from './GrTabPanel.vue';

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

@@ -1,10 +1,10 @@
-export type GrTableDensity = 'compact' | 'regular';
+import { type GrTableSize } from './grTableStyles';
 export interface GrTableProps {
     /**
-     * Плотность таблицы — влияет на базовый размер шрифта.
-     * Паддинги ячеек оставлены за консьюмером (GrTable — «тонкий» контейнер).
+     * Размер таблицы — базовый кегль текста. Паддинги ячеек оставлены за
+     * консьюмером (GrTable — «тонкий» контейнер).
      */
-    density?: GrTableDensity;
+    size?: GrTableSize;
     /**
      * Текст caption для screen reader'ов. Рендерится как `<caption class="sr-only">`,
      * если не передан слот `#caption`.
@@ -15,40 +15,126 @@ export interface GrTableProps {
     /** ID элемента-заголовка, связанного с `<table>` через `aria-labelledby`. */
     ariaLabelledby?: string;
     /**
-     * ARIA-label для скролл-контейнера (`role="region"` + `tabindex="0"`).
-     * Позволяет клавиатурным пользователям проскроллить широкую таблицу.
-     * Если не задан — region-роль не включается.
+     * ARIA-label для скролл-контейнера. Включает `role="region"`; сам скролл
+     * достижим с клавиатуры всегда, независимо от метки.
      */
     regionLabel?: string;
+    /** Идёт загрузка: вместо строк — скелетоны, контейнер помечен `aria-busy`. */
+    loading?: boolean;
+    /** Сколько строк-заглушек показать при `loading`. */
+    loadingRows?: number;
+    /** Сколько колонок занимает служебная строка (пустое состояние и скелетоны). */
+    columnCount?: number;
+    /** Текст пустого состояния. Слот `#empty` сильнее. */
+    emptyText?: string;
+    /** Таблица пуста. По умолчанию определяется по содержимому слота. */
+    empty?: boolean;
+    /** Чередование строк. */
+    striped?: boolean;
+    /** Подсветка строки под курсором. */
+    hoverable?: boolean;
+    /**
+     * Прилипающий заголовок: `<thead>` остаётся видимым при вертикальном скролле.
+     * Осмысленно вместе с `maxHeight` (иначе таблица не скроллится вертикально).
+     */
+    stickyHeader?: boolean;
+    /**
+     * Полное число строк набора, включая строки заголовка (`aria-rowcount`).
+     *
+     * Нужен, когда в DOM не весь набор — например, при виртуализации: диктор
+     * считает строки по разметке и объявил бы «5 из 20» на таблице в десять
+     * тысяч. Строки при этом обязаны нести `aria-rowindex`.
+     */
+    rowCount?: number;
+    /**
+     * Фиксированная раскладка (`table-layout: fixed`): ширины колонок берутся из
+     * первой строки, а не из содержимого всех.
+     *
+     * Обязателен, если в DOM не весь набор: иначе ширины считаются по
+     * отрисованному окну и прыгают на каждой прокрутке.
+     *
+     * Класс — arbitrary-значение, а не `table-fixed`: такого правила в
+     * `presetMini` нет, и класс молча не превратился бы в CSS.
+     */
+    fixedLayout?: boolean;
+    /**
+     * Максимальная высота скролл-контейнера (включает вертикальный скролл).
+     * Число трактуется как пиксели. Нужен для работы `stickyHeader`.
+     */
+    maxHeight?: string | number;
 }
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {};
+declare function scrollTo(options: ScrollToOptions): void;
+declare function scrollToRow(index: number, options?: ScrollIntoViewOptions): boolean;
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_12: {}, __VLS_14: {}, __VLS_16: {};
 type __VLS_Slots = {} & {
     caption?: (props: typeof __VLS_1) => any;
 } & {
-    head?: (props: typeof __VLS_3) => any;
+    header?: (props: typeof __VLS_3) => any;
+} & {
+    loading?: (props: typeof __VLS_5) => any;
+} & {
+    empty?: (props: typeof __VLS_12) => any;
 } & {
-    default?: (props: typeof __VLS_5) => any;
+    default?: (props: typeof __VLS_14) => any;
 } & {
-    foot?: (props: typeof __VLS_7) => any;
+    footer?: (props: typeof __VLS_16) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTableProps>, {
-    density: string;
+    size: undefined;
     caption: undefined;
     ariaLabel: undefined;
     ariaLabelledby: undefined;
     regionLabel: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTableProps>, {
-    density: string;
+    loading: boolean;
+    loadingRows: number;
+    columnCount: number;
+    emptyText: undefined;
+    empty: undefined;
+    striped: boolean;
+    hoverable: boolean;
+    stickyHeader: boolean;
+    maxHeight: undefined;
+    rowCount: undefined;
+    fixedLayout: boolean;
+}>>, {
+    /** Прокрутить скролл-контейнер таблицы — тот же контракт, что у `GrDataTable`. */
+    scrollTo: typeof scrollTo;
+    /** Прокрутить к строке содержимого по её индексу в разметке. `false` — строки нет в DOM. */
+    scrollToRow: typeof scrollToRow;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTableProps>, {
+    size: undefined;
     caption: undefined;
     ariaLabel: undefined;
     ariaLabelledby: undefined;
     regionLabel: undefined;
+    loading: boolean;
+    loadingRows: number;
+    columnCount: number;
+    emptyText: undefined;
+    empty: undefined;
+    striped: boolean;
+    hoverable: boolean;
+    stickyHeader: boolean;
+    maxHeight: undefined;
+    rowCount: undefined;
+    fixedLayout: boolean;
 }>>> & Readonly<{}>, {
+    size: GrTableSize;
     caption: string;
+    loading: boolean;
+    columnCount: number;
+    maxHeight: string | number;
     ariaLabel: string;
-    density: GrTableDensity;
+    empty: boolean;
+    hoverable: boolean;
+    emptyText: string;
     ariaLabelledby: string;
     regionLabel: string;
+    loadingRows: number;
+    striped: boolean;
+    stickyHeader: boolean;
+    rowCount: number;
+    fixedLayout: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

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

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

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

package/dist/types/src/components/GrTable/grTableStyles.d.ts

@@ -0,0 +1,20 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrTableSize = GrComponentSize;
+/**
+ * `GrTable` — «тонкий» контейнер: он задаёт только кегль таблицы, паддинги
+ * ячеек остаются за потребителем (см. `GrTableProps`). Поэтому карта здесь
+ * одна, а метрики ячеек живут в `GrDataTable`, который рисует их сам.
+ */
+/**
+ * Лестница 12/13/14/16 совпадает с `GrInput`, `GrTextarea` и `GrSelect` — это
+ * типографика контролов пакета, а не самодеятельность таблицы. В шкале
+ * `--gr-text-*` ступени 13px нет, и подстановка `--gr-text-sm` схлопнула бы
+ * `sm` и `md` в один кегль. Перевод всей лестницы на токены — отдельная
+ * системная задача.
+ */
+export declare const tableSizes: Record<GrTableSize, string>;
+/** Чередование строк и подсветка под курсором — на `<tbody>`, а не на ячейках. */
+export declare const stripedClass = "[&>tr:nth-child(even)]:bg-[color-mix(in_srgb,var(--gr-muted)_35%,transparent)]";
+export declare const hoverableClass = "[&>tr:hover]:bg-[color-mix(in_srgb,var(--gr-muted)_45%,transparent)]";
+export declare const emptyCellClass = "px-4 py-8 text-center text-[var(--gr-muted-fg)]";
+export declare const loadingRowCellClass = "px-4 py-3";

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

@@ -1,4 +1,10 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrTableComponent from './GrTable.vue';
 export { default } from './GrTable.vue';
 export { default as GrTable } from './GrTable.vue';
-export type { GrTableDensity, GrTableProps } from './GrTable.vue';
+export type { GrTableProps } from './GrTable.vue';
 export { grTableConfig } from './config';
+export type { GrTableConfigurableProps } from './defaults';
+export type { GrTableSize } from './grTableStyles';
+export { grTableSafelist } from './safelist';
+export type GrTableInstance = ComponentExposed<typeof GrTableComponent>;

package/dist/types/src/components/GrTable/safelist.d.ts

@@ -0,0 +1 @@
+export declare const grTableSafelist: string[];