@feugene/granularity 0.12.0 → 0.16.0

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

@@ -0,0 +1,138 @@
+import { type GrSliderMarks, type GrSliderModelValue, type GrSliderOrientation, type GrSliderSize } from './grSliderStyles';
+export type { GrSliderMarks, GrSliderModelValue, GrSliderOrientation, GrSliderSize, } from './grSliderStyles';
+/**
+ * Публичный GR-примитив «Slider» (WAI-ARIA slider pattern).
+ *
+ * Поддерживает одиночное значение и диапазон (`range` — два бегунка), шаг, метки
+ * делений, всплывающее значение (tooltip), полную клавиатурную навигацию
+ * (стрелки / PageUp/Down / Home / End) и `role="slider"` с
+ * `aria-valuemin`/`max`/`now` на каждом бегунке.
+ */
+export interface GrSliderProps {
+    /** `number` — одиночное значение; `[lo, hi]` — диапазон (при `range=true`). */
+    modelValue: GrSliderModelValue;
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Диапазон с двумя бегунками; модель — кортеж `[lo, hi]`. */
+    range?: boolean;
+    disabled?: boolean;
+    /** Только для чтения: значение видно, но не меняется. */
+    readonly?: boolean;
+    /** Визуальное и ARIA-состояние ошибки. */
+    invalid?: boolean;
+    /** Обязательное поле (`aria-required`). */
+    required?: boolean;
+    size?: GrSliderSize;
+    /** Метки делений: `{ [value]: label }` или массив значений. */
+    marks?: GrSliderMarks;
+    /** Всплывающее значение над бегунком: `true`/`'hover'` — при hover/drag/focus, `'always'` — всегда. */
+    showTooltip?: boolean | 'always' | 'hover';
+    /** Форматирование значения в tooltip. Оно же уходит в `aria-valuetext`. */
+    formatTooltip?: (value: number) => string;
+    /** Ориентация дорожки. В вертикальной минимум внизу. */
+    orientation?: GrSliderOrientation;
+    /**
+     * Эмитить `update:modelValue` только по завершении жеста: во время
+     * перетаскивания значение ведёт сам слайдер. Клавиатура коммитит сразу —
+     * нажатие клавиши дискретно, придерживать его нечего.
+     */
+    lazy?: boolean;
+    ariaLabel?: string;
+    /** Имя для нативной формы: hidden input на значение, при `range` — два с одним именем. */
+    name?: string;
+}
+export interface GrSliderEmits {
+    (e: 'update:modelValue', value: GrSliderModelValue): void;
+    /** Значение зафиксировано (отпущен бегунок / клавиша). */
+    (e: 'change', value: GrSliderModelValue): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+declare function focus(): void;
+declare function blur(): void;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSliderProps>, {
+    min: number;
+    max: number;
+    step: number;
+    range: boolean;
+    disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
+    size: undefined;
+    marks: undefined;
+    showTooltip: boolean;
+    formatTooltip: undefined;
+    orientation: string;
+    lazy: boolean;
+    ariaLabel: undefined;
+    name: undefined;
+}>>, {
+    focus: typeof focus;
+    blur: typeof blur;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: GrSliderModelValue) => void;
+    change: (value: GrSliderModelValue) => void;
+    focus: (event: FocusEvent) => void;
+    blur: (event: FocusEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSliderProps>, {
+    min: number;
+    max: number;
+    step: number;
+    range: boolean;
+    disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
+    size: undefined;
+    marks: undefined;
+    showTooltip: boolean;
+    formatTooltip: undefined;
+    orientation: string;
+    lazy: boolean;
+    ariaLabel: undefined;
+    name: undefined;
+}>>> & Readonly<{
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onChange?: ((value: GrSliderModelValue) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: GrSliderModelValue) => any) | undefined;
+}>, {
+    size: GrSliderSize;
+    orientation: GrSliderOrientation;
+    readonly: boolean;
+    name: string;
+    invalid: boolean;
+    max: number;
+    min: number;
+    range: boolean;
+    disabled: boolean;
+    required: boolean;
+    ariaLabel: string;
+    step: number;
+    marks: GrSliderMarks;
+    showTooltip: boolean | "always" | "hover";
+    formatTooltip: (value: number) => string;
+    lazy: boolean;
+}, {}, {}, {}, 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/src/components/GrSlider/config.d.ts

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

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

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

package/dist/types/src/components/GrSlider/grSliderStyles.d.ts

@@ -0,0 +1,75 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrSliderSize = GrComponentSize;
+/** Значение: число (single) или кортеж `[lo, hi]` (range при `range=true`). */
+export type GrSliderModelValue = number | [number, number];
+/** Метка деления: словарь `value → label` или просто массив значений (label = значение). */
+export type GrSliderMarks = Record<number, string> | number[];
+/** Ориентация дорожки. В вертикальной минимум внизу — как на регуляторе громкости. */
+export declare const GR_SLIDER_ORIENTATIONS: readonly ["horizontal", "vertical"];
+export type GrSliderOrientation = typeof GR_SLIDER_ORIENTATIONS[number];
+/**
+ * Кастомизация через CSS-переменные (можно задать на самом слайдере или любом
+ * предке — inline `style`, класс, тема). Значение по умолчанию — второй аргумент
+ * `var(--name, default)`, поэтому переопределять можно точечно:
+ *
+ * - `--gr-slider-rail`         — цвет фона дорожки (неактивная часть).
+ * - `--gr-slider-fill`         — цвет активной (заполненной) части.
+ * - `--gr-slider-thumb-bg`     — заливка бегунка.
+ * - `--gr-slider-thumb-border` — цвет окантовки бегунка (по умолчанию = fill).
+ * - `--gr-slider-thumb-size`   — диаметр бегунка (по умолчанию — из `size`).
+ * - `--gr-slider-track-height` — толщина дорожки (по умолчанию — из `size`).
+ * - `--gr-slider-length`       — длина вертикальной дорожки (по умолчанию `10rem`).
+ */
+export declare const sliderTrackHeightBySize: Record<GrSliderSize, string>;
+/** В вертикали та же толщина задаёт ширину, а длину берёт `--gr-slider-length`. */
+export declare const sliderTrackWidthBySize: Record<GrSliderSize, string>;
+export declare const sliderTrackVerticalLengthClass = "h-[var(--gr-slider-length,10rem)]";
+export declare const sliderThumbSizeBySize: Record<GrSliderSize, string>;
+export declare const sliderPaddingBySize: Record<GrSliderSize, string>;
+export declare const sliderRailClass = "absolute inset-0 rounded-[var(--gr-radius-full)] bg-[var(--gr-slider-rail,color-mix(in_srgb,var(--gr-muted)_45%,transparent))]";
+export declare const sliderFillBaseClass = "absolute rounded-[var(--gr-radius-full)]";
+/** Заливка растёт вдоль дорожки: по горизонтали — влево-вправо, по вертикали — снизу вверх. */
+export declare const sliderFillOrientationClass: Record<GrSliderOrientation, string>;
+/**
+ * Недоступный слайдер гасится токенами, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA токены и роняет контраст подписей меток.
+ */
+export declare const sliderFillDisabledClass = "bg-[var(--gr-disabled-fg)]";
+export declare const sliderFillEnabledClass = "bg-[var(--gr-slider-fill,var(--gr-primary))]";
+export declare function sliderFillClass(disabled: boolean): string;
+export declare const sliderThumbBaseClass = "absolute rounded-[var(--gr-radius-full)] border-2 border-[var(--gr-slider-thumb-border,var(--gr-slider-fill,var(--gr-primary)))] bg-[var(--gr-slider-thumb-bg,var(--gr-bg))] ring-1 ring-[color-mix(in_srgb,var(--gr-fg)_22%,transparent)] shadow-[var(--gr-shadow-1)] transition-[box-shadow,transform] duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] focus-visible:ring-offset-1 focus-visible:ring-offset-[var(--gr-bg)]";
+/** Бегунок центрируется поперёк дорожки, а вдоль неё его ведёт inline-стиль. */
+export declare const sliderThumbOrientationClass: Record<GrSliderOrientation, string>;
+export declare const sliderThumbDisabledClass = "cursor-not-allowed border-[var(--gr-disabled-fg)] bg-[var(--gr-disabled-bg)]";
+export declare const sliderThumbEnabledClass = "cursor-grab active:cursor-grabbing hover:scale-110";
+export declare function sliderThumbClass(options: {
+    size: GrSliderSize;
+    disabled: boolean;
+    orientation?: GrSliderOrientation;
+}): string;
+export declare const sliderTooltipBaseClass = "pointer-events-none absolute whitespace-nowrap rounded-[var(--gr-radius-control)] bg-[var(--gr-fg)] px-1.5 py-0.5 text-[length:var(--gr-text-2xs)] font-medium leading-tight text-[var(--gr-bg)] shadow-[var(--gr-shadow-2)]";
+/** В вертикали подсказка уходит вбок: над бегунком она легла бы на дорожку. */
+export declare const sliderTooltipOrientationClass: Record<GrSliderOrientation, string>;
+export declare function sliderTooltipClass(orientation?: GrSliderOrientation): string;
+export declare const sliderMarkTickBaseClass = "absolute h-1.5 w-1.5 rounded-[var(--gr-radius-full)] bg-[var(--gr-bg)] ring-1 ring-[var(--gr-brd)]";
+export declare const sliderMarkTickOrientationClass: Record<GrSliderOrientation, string>;
+export declare function sliderMarkTickClass(orientation?: GrSliderOrientation): string;
+export declare const sliderMarkLabelClass = "absolute whitespace-nowrap text-[length:var(--gr-text-2xs)] leading-none text-[var(--gr-muted-fg)]";
+export declare const sliderMarkLabelDisabledClass = "text-[var(--gr-disabled-fg)]";
+/** Вертикальные подписи уходят вправо от дорожки: под ней им места нет. */
+export declare const sliderMarkLabelVerticalClass = "left-full ml-2.5 translate-y-1/2";
+export declare const sliderMarkLabelHorizontalClass = "top-full mt-2.5";
+export declare function sliderMarkLabelClassFor(pct: number, options?: {
+    orientation?: GrSliderOrientation;
+    disabled?: boolean;
+}): string;
+export declare const sliderRootBaseClass = "relative select-none";
+export declare const sliderRootOrientationClass: Record<GrSliderOrientation, string>;
+/** Горизонтальный отступ обёртки вертикали — та же роль, что у `py-*` у горизонтали. */
+export declare const sliderPaddingVerticalBySize: Record<GrSliderSize, string>;
+export declare function sliderRootClass(options: {
+    size: GrSliderSize;
+    disabled: boolean;
+    hasMarks?: boolean;
+    orientation?: GrSliderOrientation;
+}): string;

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

@@ -0,0 +1,10 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrSliderComponent from './GrSlider.vue';
+export { default } from './GrSlider.vue';
+export { default as GrSlider } from './GrSlider.vue';
+export { grSliderConfig } from './config';
+export type { GrSliderConfigurableProps } from './defaults';
+export type { GrSliderMarks, GrSliderModelValue, GrSliderProps, GrSliderSize, } from './GrSlider.vue';
+export { grSliderSafelist } from './safelist';
+export type { GrSliderEmits } from './GrSlider.vue';
+export type GrSliderInstance = ComponentExposed<typeof GrSliderComponent>;

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

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

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

@@ -0,0 +1,121 @@
+import { type GrSplitterOrientation } from './splitterGeometry';
+export type { GrSplitterOrientation } from './splitterGeometry';
+/**
+ * Пропы {@link GrSplitter}.
+ *
+ * Две панели и разделитель между ними. Размер первой панели — доля контейнера
+ * в процентах: она переживает смену ширины окна и рендерится на сервере без
+ * замеров.
+ */
+export interface GrSplitterProps {
+    /** Доля первой панели в процентах. Поддерживает `v-model`; без него компонент помнит размер сам. */
+    modelValue?: number;
+    /** Стартовая доля и точка возврата по двойному клику. */
+    defaultSize?: number;
+    /** `horizontal` — панели рядом, `vertical` — одна над другой. */
+    orientation?: GrSplitterOrientation;
+    /** Минимум первой панели в процентах. */
+    min?: number;
+    /** Максимум первой панели в процентах. */
+    max?: number;
+    /** Минимум второй панели: без него её можно задавить в ноль. */
+    minEnd?: number;
+    /** Шаг стрелок. */
+    step?: number;
+    /** Шаг стрелок с `Shift`. */
+    bigStep?: number;
+    /** Разрешить сворачивание первой панели. */
+    collapsible?: boolean;
+    /** Первая панель свёрнута. Поддерживает `v-model:collapsed`. */
+    collapsed?: boolean;
+    /** Разделитель не тянется, не фокусируется и не отвечает на клавиши. */
+    disabled?: boolean;
+    /** Имя разделителя для скринридера. Не задано — из локали. */
+    ariaLabel?: string;
+}
+export interface GrSplitterEmits {
+    (e: 'update:modelValue', value: number): void;
+    (e: 'update:collapsed', value: boolean): void;
+    /** Конец жеста и каждый шаг с клавиатуры: сюда вешают сохранение раскладки. */
+    (e: 'change', value: number): void;
+}
+type __VLS_Slots = {
+    /** Первая панель — та, чей размер задаёт модель. */
+    start?: () => any;
+    /** Вторая панель: занимает остаток. */
+    end?: () => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSplitterProps>, {
+    modelValue: undefined;
+    defaultSize: number;
+    min: number;
+    max: number;
+    minEnd: number;
+    step: number;
+    bigStep: number;
+    collapsed: boolean;
+    disabled: boolean;
+    ariaLabel: undefined;
+    orientation: undefined;
+    collapsible: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: number) => void;
+    "update:collapsed": (value: boolean) => void;
+    change: (value: number) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSplitterProps>, {
+    modelValue: undefined;
+    defaultSize: number;
+    min: number;
+    max: number;
+    minEnd: number;
+    step: number;
+    bigStep: number;
+    collapsed: boolean;
+    disabled: boolean;
+    ariaLabel: undefined;
+    orientation: undefined;
+    collapsible: undefined;
+}>>> & Readonly<{
+    onChange?: ((value: number) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: number) => any) | undefined;
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+}>, {
+    orientation: GrSplitterOrientation;
+    collapsible: boolean;
+    max: number;
+    min: number;
+    disabled: boolean;
+    modelValue: number;
+    ariaLabel: string;
+    step: number;
+    collapsed: boolean;
+    defaultSize: number;
+    minEnd: number;
+    bigStep: number;
+}, {}, {}, {}, 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/src/components/GrSplitter/config.d.ts

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

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

@@ -0,0 +1,16 @@
+import type { GrSplitterOrientation } from './splitterGeometry';
+/**
+ * Пропы `GrSplitter`, настраиваемые глобально через `componentDefaults`.
+ *
+ * Только оформление раскладки: размер панели и её свёрнутость принадлежат
+ * конкретному экземпляру.
+ */
+export interface GrSplitterConfigurableProps {
+    orientation: GrSplitterOrientation;
+    collapsible: boolean;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrSplitter: GrSplitterConfigurableProps;
+    }
+}

package/dist/types/src/components/GrSplitter/grSplitterStyles.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Классы `GrSplitter`. Геометрия (толщина полосы, зона захвата, курсоры)
+ * зависит от ориентации и от состояния жеста, поэтому живёт в собственном
+ * `<style>` компонента, а не в утилитах.
+ */
+export declare const rootClass = "grid h-full w-full";
+/** Без `min-*: 0` содержимое панели распирает грид-трек и ломает раскладку. */
+export declare const paneClass = "min-h-0 min-w-0";
+export declare const separatorClass = "relative [touch-action:none] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] focus-visible:ring-inset";

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

@@ -0,0 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrSplitterComponent from './GrSplitter.vue';
+export { default } from './GrSplitter.vue';
+export { default as GrSplitter } from './GrSplitter.vue';
+export type { GrSplitterEmits, GrSplitterOrientation, GrSplitterProps } from './GrSplitter.vue';
+export { grSplitterConfig } from './config';
+export { clampSize, GR_SPLITTER_ORIENTATIONS, shouldCollapse, sizeFromPointer } from './splitterGeometry';
+export type { GrSplitterBounds } from './splitterGeometry';
+export { grSplitterSafelist } from './safelist';
+export type { GrSplitterConfigurableProps } from './defaults';
+export type GrSplitterInstance = ComponentExposed<typeof GrSplitterComponent>;

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

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

package/dist/types/src/components/GrSplitter/splitterGeometry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Арифметика раздвижных панелей. Без Vue — проверяется без монтирования.
+ *
+ * Всё считается в процентах ширины (или высоты) контейнера: клавиатура,
+ * границы и сворачивание работают без единого замера DOM, а серверный рендер
+ * совпадает с клиентским. Замер нужен ровно в одном месте — перевод координаты
+ * указателя в проценты.
+ */
+export declare const GR_SPLITTER_ORIENTATIONS: readonly ["horizontal", "vertical"];
+export type GrSplitterOrientation = typeof GR_SPLITTER_ORIENTATIONS[number];
+export interface GrSplitterBounds {
+    /** Минимум первой панели. */
+    min: number;
+    /** Максимум первой панели. */
+    max: number;
+    /** Минимум второй панели: без него её можно задавить в ноль. */
+    minEnd: number;
+}
+/**
+ * Приводит долю первой панели к допустимой.
+ *
+ * При конфликте `min` и `minEnd` побеждает `min`: первая панель не должна
+ * уезжать под свой минимум, даже если вторая при этом окажется уже своего.
+ * Обратный порядок дал бы панель, которую пользователь не может вернуть.
+ */
+export declare function clampSize(value: number, bounds: GrSplitterBounds): number;
+/** Доля, соответствующая позиции указателя. Вне контейнера — его края. */
+export declare function sizeFromPointer(rect: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, clientX: number, clientY: number, orientation: GrSplitterOrientation): number;
+/**
+ * Тянуть панель ниже половины её минимума пользователь может только с одним
+ * намерением — убрать её совсем. Это единственный способ свернуть панель
+ * мышью: двойной клик занят сбросом к дефолту, `Enter` — клавиатурой.
+ */
+export declare function shouldCollapse(value: number, bounds: GrSplitterBounds): boolean;

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

@@ -0,0 +1,165 @@
+import { type Component } from 'vue';
+import { type GrStatisticSize, type GrStatisticTone, type GrStatisticTrend } from './grStatisticStyles';
+export type { GrStatisticSize, GrStatisticTone, GrStatisticTrend, } from './grStatisticStyles';
+export type { GrStatisticFormatOptions } from './formatStatisticValue';
+/**
+ * Публичный GR-примитив «Statistic» — крупный числовой показатель с подписью,
+ * префиксом/суффиксом и строкой динамики.
+ *
+ * Компонент презентационный: не грузит данные и не считает дельту, только
+ * форматирует и подаёт. Форматирование — чистая функция `formatStatisticValue`.
+ */
+export interface GrStatisticProps {
+    /** Значение показателя. Нечисловая строка выводится как есть. */
+    value: number | string;
+    /** Подпись над значением. */
+    title?: string;
+    /** Число знаков после запятой. */
+    precision?: number;
+    /** Разделитель разрядов. Сильнее локали; без него и без локали — узкий пробел. */
+    groupSeparator?: string;
+    /** Десятичный разделитель. Сильнее локали; без него и без локали — точка. */
+    decimalSeparator?: string;
+    /**
+     * BCP-47 локаль форматирования. Не задана — берётся из i18n-адаптера; нет и
+     * адаптера — работают ручные разделители.
+     */
+    locale?: string;
+    /** Приписка перед значением (валюта, знак). */
+    prefix?: string;
+    /** Приписка после значения (единица измерения, `%`). */
+    suffix?: string;
+    /** UnoCSS-класс иконки слева от блока (например `i-lucide-users`). */
+    icon?: string;
+    size?: GrStatisticSize;
+    /** Тон значения; точечно перекрывается `--gr-statistic-value-color`. */
+    tone?: GrStatisticTone;
+    /** Направление динамики — задаёт цвет и иконку строки под значением. */
+    trend?: GrStatisticTrend;
+    /** Текст динамики (например `+12,5% к прошлой неделе`). */
+    trendText?: string;
+    /** Состояние загрузки: вместо значения — плейсхолдер. */
+    loading?: boolean;
+    /**
+     * Перебирать числа при появлении и при смене значения. Нечисловое значение
+     * ставится сразу, под `prefers-reduced-motion: reduce` — тоже.
+     */
+    animate?: boolean;
+    /**
+     * Длительность перебора в миллисекундах. Не токеном: шкала `--gr-duration-*`
+     * заканчивается на 300 мс и описывает смену состояния, а перебор чисел —
+     * другой жанр, и его число живёт там же, где твин.
+     */
+    animateDuration?: number;
+    /** Свой корневой тег (`RouterLink`, `Link` от Inertia). Сильнее `href`. */
+    as?: string | Component;
+    /** Показатель-ссылка: переход к деталям. */
+    href?: string;
+    /** Показатель-кнопка: интерактивна вся плитка. */
+    clickable?: boolean;
+}
+export interface GrStatisticEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+declare var __VLS_10: {}, __VLS_18: {}, __VLS_37: {}, __VLS_39: {}, __VLS_41: {}, __VLS_43: {};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_10) => any;
+} & {
+    title?: (props: typeof __VLS_18) => any;
+} & {
+    prefix?: (props: typeof __VLS_37) => any;
+} & {
+    default?: (props: typeof __VLS_39) => any;
+} & {
+    suffix?: (props: typeof __VLS_41) => any;
+} & {
+    trend?: (props: typeof __VLS_43) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrStatisticProps>, {
+    title: undefined;
+    precision: undefined;
+    groupSeparator: undefined;
+    decimalSeparator: undefined;
+    locale: undefined;
+    prefix: undefined;
+    suffix: undefined;
+    icon: undefined;
+    size: undefined;
+    tone: string;
+    trend: undefined;
+    trendText: undefined;
+    loading: boolean;
+    animate: boolean;
+    animateDuration: number;
+    as: undefined;
+    href: undefined;
+    clickable: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrStatisticProps>, {
+    title: undefined;
+    precision: undefined;
+    groupSeparator: undefined;
+    decimalSeparator: undefined;
+    locale: undefined;
+    prefix: undefined;
+    suffix: undefined;
+    icon: undefined;
+    size: undefined;
+    tone: string;
+    trend: undefined;
+    trendText: undefined;
+    loading: boolean;
+    animate: boolean;
+    animateDuration: number;
+    as: undefined;
+    href: undefined;
+    clickable: boolean;
+}>>> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    tone: GrStatisticTone;
+    size: GrStatisticSize;
+    title: string;
+    icon: string;
+    animate: boolean;
+    href: string;
+    loading: boolean;
+    prefix: string;
+    suffix: string;
+    as: string | Component;
+    clickable: boolean;
+    locale: string;
+    decimalSeparator: string;
+    precision: number;
+    groupSeparator: string;
+    trend: GrStatisticTrend;
+    trendText: string;
+    animateDuration: number;
+}, {}, {}, {}, 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/src/components/GrStatistic/config.d.ts

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

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

@@ -0,0 +1,17 @@
+/**
+ * Перебор чисел для `GrStatistic`: чистая арифметика кадра без Vue и таймеров.
+ *
+ * Вынесено отдельным модулем по той же причине, что и `formatStatisticValue`:
+ * кривая и округление проверяются напрямую, без монтирования и подмены `rAF`.
+ */
+/** Быстрый старт, мягкая остановка — та же форма, что у `--gr-ease-out`. */
+export declare function easeOutCubic(t: number): number;
+/**
+ * Значение кадра на `elapsed` миллисекунде перехода `from → to`.
+ *
+ * Округление до `precision` обязательно: без него кадры показывали бы
+ * `1283.6666666666667` там, где показатель целый, и ширина строки прыгала бы
+ * даже при `tabular-nums`. Последний кадр возвращает ровно `to` — приближение
+ * не должно оставлять показатель в 1283.9999.
+ */
+export declare function countUpFrame(from: number, to: number, elapsed: number, duration: number, precision?: number): number;

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

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