@feugene/granularity 0.13.0 → 0.16.0

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

@@ -1,13 +1,17 @@
 import { type Component } from 'vue';
 export type { GrButtonSize, GrButtonTone, GrButtonVariant } from './grButtonStyles';
 import { type GrButtonSize, type GrButtonTone, type GrButtonVariant } from './grButtonStyles';
-type __VLS_Props = {
+export interface GrButtonProps {
     variant?: GrButtonVariant;
     tone?: GrButtonTone;
     size?: GrButtonSize;
     loading?: boolean;
+    /** i18n: что именно грузится. `aria-busy` сам по себе часть AT не объявляет. */
+    loadingText?: string;
     disabled?: boolean;
     square?: boolean;
+    /** Кнопка на всю ширину контейнера. */
+    block?: boolean;
     type?: 'button' | 'submit' | 'reset';
     ariaLabel?: string;
     /** Полиморфизм: кастомный корневой тег/компонент (например, RouterLink). */
@@ -17,18 +21,31 @@ type __VLS_Props = {
     target?: string;
     rel?: string;
     external?: boolean;
-};
-declare var __VLS_15: {};
+}
+/**
+ * Фокус на кнопку из кода. Нужен там, где окно обязано открываться с фокусом
+ * на конкретном действии (`GrConfirmDialog`), и потребителю не должно быть
+ * важно, тегом или компонентом отрисован корень.
+ */
+declare function focus(): void;
+declare function blur(): void;
+declare var __VLS_16: {}, __VLS_18: {}, __VLS_20: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_15) => any;
+    prefix?: (props: typeof __VLS_16) => any;
+} & {
+    default?: (props: typeof __VLS_18) => any;
+} & {
+    suffix?: (props: typeof __VLS_20) => 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<GrButtonProps>, {
     variant: undefined;
     tone: undefined;
     size: undefined;
     loading: boolean;
+    loadingText: undefined;
     disabled: boolean;
     square: undefined;
+    block: boolean;
     type: string;
     ariaLabel: undefined;
     as: undefined;
@@ -36,13 +53,18 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     target: undefined;
     rel: undefined;
     external: boolean;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+}>>, {
+    focus: typeof focus;
+    blur: typeof blur;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrButtonProps>, {
     variant: undefined;
     tone: undefined;
     size: undefined;
     loading: boolean;
+    loadingText: undefined;
     disabled: boolean;
     square: undefined;
+    block: boolean;
     type: string;
     ariaLabel: undefined;
     as: undefined;
@@ -59,11 +81,13 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     target: string;
     href: string;
     loading: boolean;
+    block: boolean;
     disabled: boolean;
     ariaLabel: string;
+    loadingText: string;
     as: string | Component;
-    rel: string;
     external: boolean;
+    rel: string;
 }, {}, {}, {}, 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/GrButton/config.d.ts

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

package/dist/types/src/components/GrButton/grButtonStyles.d.ts

@@ -1,12 +1,16 @@
+import type { GrComponentSize } from '../shared/sizes';
 import type { GrTone } from '../shared/tones';
 export type GrButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'ghost-border';
 export type GrButtonTone = GrTone;
-export type GrButtonSize = 'xs' | 'sm' | 'md' | 'lg';
+export type GrButtonSize = GrComponentSize;
 export type GrButtonClassOptions = {
     variant: GrButtonVariant;
     tone: GrButtonTone;
     size: GrButtonSize;
     square: boolean;
+    /** Необязательные: `grButtonClass` — публичный хелпер, его зовёт и `GrRadio`. */
+    disabled?: boolean;
+    block?: boolean;
 };
 export type GrButtonToneTokens = {
     solidBackground: string;
@@ -22,9 +26,29 @@ export type GrButtonToneTokens = {
     borderHover: string;
     borderActive: string;
 };
-export declare const base = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-md transition-colors duration-150 focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] disabled:opacity-50 disabled:cursor-not-allowed";
-export declare const grButtonBaseClass = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-md transition-colors duration-150 focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] disabled:opacity-50 disabled:cursor-not-allowed";
+export declare const base = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-[var(--gr-button-radius,0.375rem)] transition-colors duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] disabled:cursor-not-allowed";
+/** Кнопка на всю ширину контейнера. */
+export declare const blockClass = "w-full";
+/**
+ * Отключённая кнопка гасится токенами, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA цвета, а кнопка чаще всего оказывается на цветной подложке,
+ * где разбавленный текст проваливается первым.
+ *
+ * Классы применяются ВМЕСТО вариантных, а не поверх: два `bg-*` одной
+ * специфичности разрулил бы порядок в сгенерированном CSS, а не порядок в
+ * списке классов. Отсюда же и разбиение по вариантам: у прозрачных
+ * (`outline`, `ghost`, `ghost-border`) заливки нет и в отключённом виде —
+ * иначе стрелка пагинации превращалась бы в залитую плашку.
+ */
+export declare const disabledClassByVariant: Record<GrButtonVariant, string>;
+export declare const grButtonBaseClass = "inline-flex items-center justify-center gap-2 select-none whitespace-nowrap rounded-[var(--gr-button-radius,0.375rem)] transition-colors duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] disabled:cursor-not-allowed";
 export declare const sizes: Record<GrButtonSize, string>;
+/**
+ * Квадратный режим — через `--gr-button-square-size` с размерным дефолтом в
+ * fallback: потребитель задаёт переменную в своём CSS и подгоняет кнопку под
+ * свою сетку (приём из `GrSlider`). Размер задаётся только здесь: инлайн-стиль
+ * в SFC перекрыл бы эти классы, и переменная перестала бы что-либо значить.
+ */
 export declare const squareSizes: Record<GrButtonSize, string>;
 export declare const tones: Record<GrButtonTone, GrButtonToneTokens>;
 export declare function variantClass(variant: GrButtonVariant, tone: GrButtonTone): string;

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

@@ -1,7 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrButtonComponent from './GrButton.vue';
 export { default } from './GrButton.vue';
 export { default as GrButton } from './GrButton.vue';
 export { grButtonConfig } from './config';
 export type { GrButtonConfigurableProps } from './defaults';
 export type { GrButtonSize, GrButtonTone, GrButtonVariant } from './grButtonStyles';
 export { grButtonClass } from './grButtonStyles';
-export { grButtonClassTokens, grButtonSafelist } from './safelist';
+export { grButtonSafelist } from './safelist';
+export type { GrButtonProps } from './GrButton.vue';
+export type GrButtonInstance = ComponentExposed<typeof GrButtonComponent>;

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

@@ -3,5 +3,6 @@ export declare const grButtonClassTokens: {
     readonly sizes: string[];
     readonly squareSizes: string[];
     readonly variants: string[];
+    readonly states: readonly string[];
 };
 export declare const grButtonSafelist: string[];

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

@@ -1,16 +1,44 @@
-type __VLS_Props = {
+import type { GrButtonSize, GrButtonTone, GrButtonVariant } from '../GrButton/grButtonStyles';
+export type GrButtonGroupOrientation = 'horizontal' | 'vertical';
+export interface GrButtonGroupProps {
+    /** Доступное имя группы: без него кнопки читаются как несвязанные. */
     ariaLabel?: string;
-};
+    orientation?: GrButtonGroupOrientation;
+    /**
+     * Склеивать кнопки в один блок. `false` — обычный ряд с зазором: каждая
+     * кнопка сохраняет свои радиусы и границы.
+     */
+    attached?: boolean;
+    /** Оформление, общее для кнопок группы. Проп самой кнопки сильнее. */
+    size?: GrButtonSize;
+    variant?: GrButtonVariant;
+    tone?: GrButtonTone;
+}
 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<GrButtonGroupProps>, {
     ariaLabel: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    orientation: string;
+    attached: boolean;
+    size: undefined;
+    variant: undefined;
+    tone: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrButtonGroupProps>, {
     ariaLabel: undefined;
+    orientation: string;
+    attached: boolean;
+    size: undefined;
+    variant: undefined;
+    tone: undefined;
 }>>> & Readonly<{}>, {
+    tone: GrButtonTone;
+    variant: GrButtonVariant;
+    size: GrButtonSize;
+    orientation: GrButtonGroupOrientation;
     ariaLabel: string;
+    attached: 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/GrButtonGroup/config.d.ts

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

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

@@ -0,0 +1,20 @@
+import type { ComputedRef } from 'vue';
+import type { GrButtonSize, GrButtonTone, GrButtonVariant } from '../GrButton/grButtonStyles';
+/**
+ * Оформление, общее для кнопок группы. Каждое поле необязательно: группа
+ * задаёт только то, что задали ей, остальное кнопка решает сама.
+ */
+export type GrButtonGroupContext = {
+    size: ComputedRef<GrButtonSize | undefined>;
+    variant: ComputedRef<GrButtonVariant | undefined>;
+    tone: ComputedRef<GrButtonTone | undefined>;
+};
+export declare function provideGrButtonGroup(context: GrButtonGroupContext): void;
+/**
+ * Контекст группы для `GrButton`.
+ *
+ * Порядок разрешения оформления получается такой: проп кнопки → группа →
+ * `GrConfigProvider` → дефолт. Группа ближе к кнопке, чем глобальный провайдер,
+ * поэтому она и должна побеждать его, но не собственный проп кнопки.
+ */
+export declare function useGrButtonGroup(): GrButtonGroupContext | undefined;

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

@@ -1,3 +1,6 @@
 export { default } from './GrButtonGroup.vue';
 export { default as GrButtonGroup } from './GrButtonGroup.vue';
 export { grButtonGroupConfig } from './config';
+export { useGrButtonGroup } from './context';
+export type { GrButtonGroupContext } from './context';
+export type { GrButtonGroupOrientation, GrButtonGroupProps } from './GrButtonGroup.vue';

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

@@ -1,13 +1,90 @@
-declare var __VLS_1: {};
+import { type Component } from 'vue';
+import { type GrCardPadding, type GrCardVariant } from './grCardStyles';
+export type { GrCardPadding, GrCardVariant } from './grCardStyles';
+export interface GrCardProps {
+    /**
+     * Внутренние отступы. По умолчанию `none`: карточка — поверхность, а её
+     * содержимое (`GrCollapse`, `GrList`) само знает про свои отступы.
+     */
+    padding?: GrCardPadding;
+    /** `elevated` — рамка, фон и тень; `outlined` — без тени; `ghost` — без рамки. */
+    variant?: GrCardVariant;
+    /** Свой корневой тег (`RouterLink`, `Link` от Inertia). Сильнее `href`. */
+    as?: string | Component;
+    /** Карточка-ссылка. */
+    href?: string;
+    /** Карточка-кнопка: интерактивна вся поверхность. */
+    clickable?: boolean;
+    /** Подсветка при наведении без интерактивности. */
+    hoverable?: boolean;
+    /** Классы обёртки тела — она появляется вместе с секциями. */
+    bodyClass?: string;
+}
+export interface GrCardEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+declare var __VLS_10: {}, __VLS_12: {}, __VLS_14: {}, __VLS_16: {};
 type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+    header?: (props: typeof __VLS_10) => any;
+} & {
+    default?: (props: typeof __VLS_12) => any;
+} & {
+    footer?: (props: typeof __VLS_14) => any;
+} & {
+    default?: (props: typeof __VLS_16) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCardProps>, {
+    padding: undefined;
+    variant: undefined;
+    as: undefined;
+    href: undefined;
+    clickable: boolean;
+    hoverable: boolean;
+    bodyClass: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCardProps>, {
+    padding: undefined;
+    variant: undefined;
+    as: undefined;
+    href: undefined;
+    clickable: boolean;
+    hoverable: boolean;
+    bodyClass: undefined;
+}>>> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    variant: GrCardVariant;
+    padding: GrCardPadding;
+    href: string;
+    as: string | Component;
+    clickable: boolean;
+    hoverable: boolean;
+    bodyClass: string;
+}, {}, {}, {}, 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/GrCard/config.d.ts

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

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

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

package/dist/types/src/components/GrCard/grCardStyles.d.ts

@@ -0,0 +1,24 @@
+export type GrCardPadding = 'none' | 'sm' | 'md' | 'lg';
+export type GrCardVariant = 'elevated' | 'outlined' | 'ghost';
+/**
+ * Классы `GrCard`.
+ *
+ * `elevated` — дефолт и ровно тот вид, что был у карточки до появления пропов:
+ * `GrCollapse` и `GrList` рендерят содержимое внутрь `GrCard`, и любое смещение
+ * дефолта поехало бы у них.
+ */
+export declare const surfaceBaseClass = "rounded-[var(--gr-radius-lg)] bg-[var(--gr-card)] text-[var(--gr-card-fg)]";
+export declare const variantClass: Record<GrCardVariant, string>;
+export declare const paddingClass: Record<GrCardPadding, string>;
+export declare const sectionDividerTopClass = "border-t border-[var(--gr-brd)]";
+export declare const sectionDividerBottomClass = "border-b border-[var(--gr-brd)]";
+/** Интерактивная карточка целиком: ссылка или кнопка во всю поверхность. */
+export declare const interactiveClass = "block w-full text-left transition-colors duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const hoverClass = "cursor-pointer hover:bg-[var(--gr-muted)]";
+export declare function grCardRootClass(options: {
+    variant: GrCardVariant;
+    /** Падинг едет на корень, только пока нет секций — иначе лишняя обёртка. */
+    padding: GrCardPadding;
+    interactive: boolean;
+    hoverable: boolean;
+}): string;

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

@@ -1,3 +1,8 @@
 export { default } from './GrCard.vue';
 export { default as GrCard } from './GrCard.vue';
+export type { GrCardProps } from './GrCard.vue';
 export { grCardConfig } from './config';
+export type { GrCardConfigurableProps } from './defaults';
+export type { GrCardPadding, GrCardVariant } from './grCardStyles';
+export { grCardSafelist } from './safelist';
+export type { GrCardEmits } from './GrCard.vue';

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

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

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

@@ -1,49 +1,95 @@
+import { type GrCheckboxLabelPosition, type GrCheckboxSize } from './grCheckboxStyles';
+export type { GrCheckboxLabelPosition, GrCheckboxSize } from './grCheckboxStyles';
 export interface GrCheckboxProps {
+    /** Не задан внутри `GrCheckboxGroup` — состояние берётся из группы. */
     modelValue?: boolean;
     disabled?: boolean;
     name?: string;
     value?: string;
+    /** Обязательное поле: объявляется как `aria-required`, нативной проверки нет. */
     required?: boolean;
+    /** Только для чтения: состояние видно, но не переключается. */
+    readonly?: boolean;
+    /** Визуальное и ARIA-состояние ошибки. */
+    invalid?: boolean;
     form?: string;
     /** Пробрасывается на скрытый нативный `<input>`, чтобы работал `<label for="...">`. */
     id?: string;
     /** Промежуточное («смешанное») состояние: `aria-checked="mixed"`, индикатор — тире. */
     indeterminate?: boolean;
+    /** Имя контрола, когда подписи в слоте нет (или она чисто визуальная). */
+    ariaLabel?: string;
+    /** Сторона подписи относительно контрола. */
+    labelPosition?: GrCheckboxLabelPosition;
+    /** Размер контрола. Не задан — берётся из группы, затем из `GrConfigProvider`, иначе `md`. */
+    size?: GrCheckboxSize;
 }
-declare var __VLS_11: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_11) => any;
+export interface GrCheckboxEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    (e: 'change', value: boolean): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+type __VLS_Slots = {
+    /** Подпись флажка. Может содержать ссылки: роль остаётся на самом контроле. */
+    default?: () => any;
 };
+declare function focus(): void;
+declare function blur(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrCheckboxProps>, {
-    modelValue: boolean;
-    disabled: boolean;
+    modelValue: undefined;
+    disabled: undefined;
     name: undefined;
     value: string;
     required: boolean;
+    readonly: boolean;
+    invalid: boolean;
     form: undefined;
     id: undefined;
     indeterminate: boolean;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    ariaLabel: undefined;
+    labelPosition: string;
+    size: undefined;
+}>>, {
+    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<GrCheckboxProps>, {
-    modelValue: boolean;
-    disabled: boolean;
+    modelValue: undefined;
+    disabled: undefined;
     name: undefined;
     value: string;
     required: boolean;
+    readonly: boolean;
+    invalid: boolean;
     form: undefined;
     id: undefined;
     indeterminate: boolean;
+    ariaLabel: undefined;
+    labelPosition: string;
+    size: undefined;
 }>>> & Readonly<{
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onChange?: ((value: boolean) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
+    size: GrCheckboxSize;
+    labelPosition: GrCheckboxLabelPosition;
+    value: string;
+    readonly: boolean;
     form: string;
-    id: string;
     name: string;
+    invalid: boolean;
+    id: string;
     disabled: boolean;
     modelValue: boolean;
-    value: string;
     required: boolean;
+    ariaLabel: string;
     indeterminate: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

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

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

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

package/dist/types/src/components/GrCheckbox/grCheckboxGroupContext.d.ts

@@ -0,0 +1,19 @@
+import type { ComputedRef, InjectionKey } from 'vue';
+import type { GrCheckboxSize } from './grCheckboxStyles';
+export type GrCheckboxGroupContext = {
+    /** Выбранные значения группы. Чекбокс сравнивает с ними свой `value`. */
+    modelValue: ComputedRef<string[]>;
+    name: ComputedRef<string | undefined>;
+    disabled: ComputedRef<boolean>;
+    readonly: ComputedRef<boolean>;
+    invalid: ComputedRef<boolean>;
+    /**
+     * Обязательность группы объявляют её чекбоксы: `role="group"` не поддерживает
+     * `aria-required` (axe: `aria-allowed-attr`), а `role="checkbox"` — да.
+     */
+    required: ComputedRef<boolean>;
+    size: ComputedRef<GrCheckboxSize>;
+    /** Добавляет или убирает значение из выбранных. */
+    toggle: (value: string, checked: boolean) => void;
+};
+export declare const GR_CHECKBOX_GROUP_CONTEXT: InjectionKey<GrCheckboxGroupContext>;

package/dist/types/src/components/GrCheckbox/grCheckboxStyles.d.ts

@@ -0,0 +1,44 @@
+import type { GrButtonSize } from '../GrButton/grButtonStyles';
+/** Размерная шкала общая с формным рядом (`GrRadio`, `GrInput`, `GrButton`). */
+export type GrCheckboxSize = GrButtonSize;
+/** Сторона подписи относительно контрола — логическая, не физическая (RTL). */
+export declare const GR_CHECKBOX_LABEL_POSITIONS: readonly ["start", "end"];
+export type GrCheckboxLabelPosition = typeof GR_CHECKBOX_LABEL_POSITIONS[number];
+export declare const rootBase = "inline-flex items-center select-none";
+export declare const rootGaps: Record<GrCheckboxSize, string>;
+export declare const rootDisabledClass = "cursor-not-allowed";
+export declare const rootEnabledClass = "cursor-pointer";
+export declare const rootLabelStartClass = "flex-row-reverse justify-end";
+export declare const controlBase = "rounded-[var(--gr-radius-sm)] border flex items-center justify-center transition-colors duration-[var(--gr-duration-fast)] focus-visible:outline-none focus-visible:shadow-[0_0_0_2px_var(--gr-ring),0_0_0_4px_var(--gr-bg)]";
+export declare const controlSizes: Record<GrCheckboxSize, string>;
+export declare const controlCheckedClass = "border-[var(--gr-primary)] bg-[var(--gr-primary)]";
+export declare const controlUncheckedClass = "border-[var(--gr-brd)] bg-[var(--gr-bg)]";
+export declare const controlInvalidCheckedClass = "border-[var(--gr-danger)] bg-[var(--gr-danger)]";
+export declare const controlInvalidUncheckedClass = "border-[var(--gr-danger)] bg-[var(--gr-bg)]";
+export declare const controlDisabledCheckedClass = "border-[var(--gr-muted-fg)] bg-[var(--gr-muted-fg)]";
+export declare const controlDisabledUncheckedClass = "border-[var(--gr-brd)] bg-[var(--gr-muted)]";
+export declare const iconBase = "gr-checkbox-icon";
+export declare const iconColorClass = "text-[var(--gr-primary-fg)]";
+export declare const iconSizes: Record<GrCheckboxSize, string>;
+export declare const iconCheckTransitionClass = "transition-transform transition-opacity duration-[var(--gr-duration-fast)]";
+export declare const iconCheckVisibleClass = "opacity-100 scale-100 text-[var(--gr-primary-fg)]";
+export declare const iconCheckHiddenClass = "opacity-0 scale-75 text-transparent";
+export declare const labelBase = "text-[var(--gr-muted-fg)]";
+export declare const labelSizes: Record<GrCheckboxSize, string>;
+export declare function grCheckboxRootClass(options: {
+    size: GrCheckboxSize;
+    disabled: boolean;
+    labelPosition: GrCheckboxLabelPosition;
+}): string;
+export declare function grCheckboxControlClass(options: {
+    size: GrCheckboxSize;
+    active: boolean;
+    disabled?: boolean;
+    invalid?: boolean;
+}): string;
+export declare function grCheckboxIndeterminateIconClass(size: GrCheckboxSize): string;
+export declare function grCheckboxCheckIconClass(options: {
+    size: GrCheckboxSize;
+    checked: boolean;
+}): string;
+export declare function grCheckboxLabelClass(size: GrCheckboxSize): string;

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

@@ -1,4 +1,13 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrCheckboxComponent from './GrCheckbox.vue';
 export { default } from './GrCheckbox.vue';
 export { default as GrCheckbox } from './GrCheckbox.vue';
 export type { GrCheckboxProps } from './GrCheckbox.vue';
 export { grCheckboxConfig } from './config';
+export type { GrCheckboxConfigurableProps } from './defaults';
+export type { GrCheckboxLabelPosition, GrCheckboxSize } from './grCheckboxStyles';
+export type { GrCheckboxGroupContext } from './grCheckboxGroupContext';
+export { GR_CHECKBOX_GROUP_CONTEXT } from './grCheckboxGroupContext';
+export { grCheckboxSafelist } from './safelist';
+export type { GrCheckboxEmits } from './GrCheckbox.vue';
+export type GrCheckboxInstance = ComponentExposed<typeof GrCheckboxComponent>;

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

@@ -0,0 +1,13 @@
+export declare const grCheckboxClassTokens: {
+    readonly rootBase: string[];
+    readonly rootGaps: string[];
+    readonly rootState: readonly string[];
+    readonly controlBase: string[];
+    readonly controlSizes: string[];
+    readonly controlState: readonly string[];
+    readonly iconSizes: string[];
+    readonly iconState: readonly string[];
+    readonly labelBase: string[];
+    readonly labelSizes: string[];
+};
+export declare const grCheckboxSafelist: string[];