@feugene/granularity 0.13.0 → 0.18.0

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 '../../composables/useGrComponentConfig' {
+    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

@@ -1,3 +1,4 @@
+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';
@@ -15,9 +16,15 @@ export interface GrStatisticProps {
     title?: string;
     /** Число знаков после запятой. */
     precision?: number;
-    /** Разделитель разрядов (по умолчанию — узкий пробел). */
+    /** Разделитель разрядов. Сильнее локали; без него и без локали — узкий пробел. */
     groupSeparator?: string;
+    /** Десятичный разделитель. Сильнее локали; без него и без локали — точка. */
     decimalSeparator?: string;
+    /**
+     * BCP-47 локаль форматирования. Не задана — берётся из i18n-адаптера; нет и
+     * адаптера — работают ручные разделители.
+     */
+    locale?: string;
     /** Приписка перед значением (валюта, знак). */
     prefix?: string;
     /** Приписка после значения (единица измерения, `%`). */
@@ -33,60 +40,102 @@ export interface GrStatisticProps {
     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;
 }
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_10: {}, __VLS_12: {}, __VLS_14: {}, __VLS_16: {};
+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_1) => any;
+    icon?: (props: typeof __VLS_10) => any;
 } & {
-    title?: (props: typeof __VLS_3) => any;
+    title?: (props: typeof __VLS_18) => any;
 } & {
-    prefix?: (props: typeof __VLS_10) => any;
+    prefix?: (props: typeof __VLS_37) => any;
 } & {
-    default?: (props: typeof __VLS_12) => any;
+    default?: (props: typeof __VLS_39) => any;
 } & {
-    suffix?: (props: typeof __VLS_14) => any;
+    suffix?: (props: typeof __VLS_41) => any;
 } & {
-    trend?: (props: typeof __VLS_16) => 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: string;
-    decimalSeparator: string;
+    groupSeparator: undefined;
+    decimalSeparator: undefined;
+    locale: undefined;
     prefix: undefined;
     suffix: undefined;
     icon: undefined;
-    size: string;
+    size: undefined;
     tone: string;
     trend: undefined;
     trendText: undefined;
     loading: boolean;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrStatisticProps>, {
+    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: string;
-    decimalSeparator: string;
+    groupSeparator: undefined;
+    decimalSeparator: undefined;
+    locale: undefined;
     prefix: undefined;
     suffix: undefined;
     icon: undefined;
-    size: string;
+    size: undefined;
     tone: string;
     trend: undefined;
     trendText: undefined;
     loading: boolean;
-}>>> & Readonly<{}>, {
+    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;

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

@@ -1 +1 @@
-export declare const grStatisticConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrStatistic">;
+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 '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrStatistic: GrStatisticConfigurableProps;
+    }
+}

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

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

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

@@ -1,5 +1,6 @@
+import type { GrComponentSize } from '../shared/sizes';
 import type { GrTone } from '../shared/tones';
-export type GrStatisticSize = 'sm' | 'md' | 'lg';
+export type GrStatisticSize = GrComponentSize;
 export type GrStatisticTone = GrTone;
 /** Направление динамики показателя. */
 export type GrStatisticTrend = 'up' | 'down' | 'flat';
@@ -18,6 +19,18 @@ 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 tabular-nums";
 export declare function statisticValueClass(options: {
     size: GrStatisticSize;
     tone: GrStatisticTone;

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

@@ -2,5 +2,6 @@ export { default } from './GrStatistic.vue';
 export { default as GrStatistic } from './GrStatistic.vue';
 export { grStatisticConfig } from './config';
 export { formatStatisticValue } from './formatStatisticValue';
-export type { GrStatisticFormatOptions, GrStatisticProps, GrStatisticSize, GrStatisticTone, GrStatisticTrend, } from './GrStatistic.vue';
+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/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;
+    /** Сторона подписи относительно дорожки. */
+    labelPosition?: GrSwitchLabelPosition;
+    /** Идёт сохранение: бегунок показывает спиннер, переключение заблокировано. */
+    loading?: boolean;
+    /** i18n: что именно грузится. `aria-busy` сам по себе часть AT не объявляет. */
+    loadingText?: string;
+    /** Имя поля для нативной отправки формы. Без него скрытое поле не рендерится. */
+    name?: string;
+    /** Значение, уходящее в форму во включённом состоянии. */
+    value?: string;
+    /** `id` формы, если переключатель лежит вне неё. */
+    form?: string;
     /** Кастомный цвет фона в активном состоянии. Если не задан — `var(--gr-primary)`. */
     activeBackgroundColor?: string;
     /** Кастомный цвет фона в неактивном состоянии. Если не задан — `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: 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: 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

@@ -7,7 +7,7 @@ import type { GrSwitchSize } from './grSwitchStyles';
 export interface GrSwitchConfigurableProps {
     size: GrSwitchSize;
 }
-declare module '../GrConfigProvider/context' {
+declare module '../../composables/useGrComponentConfig' {
     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(--gr-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(--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 {};