@feugene/granularity 0.12.0 → 0.16.0

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

@@ -12,6 +12,8 @@ export interface GrInputTagProps {
     disabled?: boolean;
     readonly?: boolean;
     invalid?: boolean;
+    /** Обязательное поле (`aria-required`). Складывается с `required` у `GrFormField`. */
+    required?: boolean;
     state?: GrInputTagState;
     size?: GrInputTagSize;
     separators?: string[];
@@ -20,6 +22,15 @@ export interface GrInputTagProps {
     max?: number;
     addOnBlur?: boolean;
     clearInputOnAdd?: boolean;
+    /**
+     * Проверка тега перед добавлением. Может быть асинхронной (проверка на
+     * сервере). Отклонённый тег не добавляется и уходит в событие `reject`.
+     */
+    beforeAdd?: (tag: string) => boolean | Promise<boolean>;
+    /** Кнопка «снести все теги». Настраивается через `GrConfigProvider`. */
+    clearable?: boolean;
+    /** Фоновая работа: спиннер + `aria-busy`. Асинхронный `beforeAdd` поднимает его сам. */
+    loading?: boolean;
     tagTone?: GrBadgeTone;
     tagDark?: boolean;
     tagSize?: GrBadgeSize;
@@ -27,83 +38,155 @@ export interface GrInputTagProps {
     tagClosable?: boolean;
     /** i18n-friendly aria-label for the per-tag remove button. */
     removeTagLabel?: string;
+    /** i18n aria-label кнопки «снести все». */
+    clearAllLabel?: string;
+    /**
+     * Имя контрола, когда он используется вне `GrFormField`. Внутри поля имя даёт
+     * связка с его `<label for>` — там проп не нужен. Без того и другого у инпута
+     * нет доступного имени вовсе: placeholder именем не считается.
+     */
+    ariaLabel?: string;
+    /** Имя для нативной формы: hidden input на каждый тег. */
+    name?: string;
+    /**
+     * Ширины аддонов `prefix`/`suffix` — общий контракт контролов пакета
+     * (`docs/form-controls.md`).
+     */
+    prefixMinWidth?: string;
+    prefixMaxWidth?: string;
+    suffixMinWidth?: string;
+    suffixMaxWidth?: string;
+    prefixFixed?: boolean;
+    suffixFixed?: boolean;
 }
-declare function focus(): void;
-declare var __VLS_7: {
-    tag: string;
-    index: number;
-    remove: () => void;
-};
-type __VLS_Slots = {} & {
-    tag?: (props: typeof __VLS_7) => any;
+export interface GrInputTagEmits {
+    (e: 'update:modelValue', value: string[]): void;
+    (e: 'add', value: string): void;
+    (e: 'remove', value: string, index: number): void;
+    /** Тег не прошёл `beforeAdd`. */
+    (e: 'reject', value: string): void;
+    /** Набор снесён кнопкой «очистить». */
+    (e: 'clear'): void;
+    /** Набор тегов изменился. */
+    (e: 'change', value: string[]): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+type __VLS_Slots = {
+    /** Аддон слева от чипов: иконка, метка. */
+    prefix?: () => any;
+    /** Аддон справа, перед кнопкой очистки. */
+    suffix?: () => any;
+    /** Свой чип: `remove` снимает значение. */
+    tag?: (props: {
+        tag: string;
+        index: number;
+        remove: () => void;
+    }) => any;
 };
+declare function focus(): void;
+declare function blur(): void;
+declare function clearAll(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrInputTagProps>, {
     placeholder: undefined;
     disabled: boolean;
     readonly: boolean;
     invalid: boolean;
+    required: boolean;
     state: string;
-    size: string;
+    size: undefined;
     separators: () => string[];
     allowDuplicates: boolean;
     trim: boolean;
     max: undefined;
     addOnBlur: boolean;
     clearInputOnAdd: boolean;
+    beforeAdd: undefined;
+    clearable: undefined;
+    loading: boolean;
     tagTone: string;
     tagDark: boolean;
     tagSize: string;
     tagRadius: string;
     tagClosable: boolean;
     removeTagLabel: undefined;
+    clearAllLabel: undefined;
+    ariaLabel: undefined;
+    name: undefined;
 }>>, {
     focus: typeof focus;
+    blur: typeof blur;
+    clear: typeof clearAll;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string[]) => void;
     add: (value: string) => void;
     remove: (value: string, index: number) => void;
+    reject: (value: string) => void;
+    clear: () => void;
+    change: (value: string[]) => void;
+    focus: (event: FocusEvent) => void;
+    blur: (event: FocusEvent) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrInputTagProps>, {
     placeholder: undefined;
     disabled: boolean;
     readonly: boolean;
     invalid: boolean;
+    required: boolean;
     state: string;
-    size: string;
+    size: undefined;
     separators: () => string[];
     allowDuplicates: boolean;
     trim: boolean;
     max: undefined;
     addOnBlur: boolean;
     clearInputOnAdd: boolean;
+    beforeAdd: undefined;
+    clearable: undefined;
+    loading: boolean;
     tagTone: string;
     tagDark: boolean;
     tagSize: string;
     tagRadius: string;
     tagClosable: boolean;
     removeTagLabel: undefined;
+    clearAllLabel: undefined;
+    ariaLabel: undefined;
+    name: undefined;
 }>>> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
+    onClear?: (() => any) | undefined;
     onAdd?: ((value: string) => any) | undefined;
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onChange?: ((value: string[]) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
     onRemove?: ((value: string, index: number) => any) | undefined;
+    onReject?: ((value: string) => any) | undefined;
 }>, {
+    size: GrInputTagSize;
+    clearable: boolean;
     trim: boolean;
     readonly: boolean;
-    size: GrInputTagSize;
-    disabled: boolean;
+    name: string;
     invalid: boolean;
     max: number;
+    loading: boolean;
+    disabled: boolean;
+    tagTone: GrBadgeTone;
+    tagDark: boolean;
+    tagSize: GrBadgeSize;
+    tagRadius: GrBadgeRadius;
+    required: boolean;
     placeholder: string;
+    ariaLabel: string;
     state: GrInputTagState;
     separators: string[];
     allowDuplicates: boolean;
     addOnBlur: boolean;
     clearInputOnAdd: boolean;
-    tagTone: GrBadgeTone;
-    tagDark: boolean;
-    tagSize: GrBadgeSize;
-    tagRadius: GrBadgeRadius;
+    beforeAdd: (tag: string) => boolean | Promise<boolean>;
     tagClosable: boolean;
     removeTagLabel: string;
+    clearAllLabel: 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/GrInputTag/config.d.ts

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

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

@@ -0,0 +1,17 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/**
+ * Пропы `GrInputTag`, настраиваемые глобально через `componentDefaults`.
+ *
+ * `size` типизируем через `GrComponentSize` (та же шкала `xs…lg`), а не через
+ * `GrInputTagSize`: последний выводится из `GrInput.vue`, который импортирует
+ * контекст, — получился бы цикл модулей (то же ограничение, что у `GrInput`).
+ */
+export interface GrInputTagConfigurableProps {
+    size: GrComponentSize;
+    clearable: boolean;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrInputTag: GrInputTagConfigurableProps;
+    }
+}

package/dist/types/src/components/GrInputTag/grInputTagStyles.d.ts

@@ -1,9 +1,32 @@
+import type { GrControlState } from '../shared/sizes';
 import type { GrInputSize } from '../GrInput/GrInput.vue';
 export type GrInputTagSize = GrInputSize;
-export type GrInputTagState = 'default' | 'success' | 'warning' | 'danger';
+export type GrInputTagState = GrControlState;
 export declare const wrapperSizeClassBySize: Record<GrInputTagSize, string>;
 export declare const inputSizeClassBySize: Record<GrInputTagSize, string>;
 export declare const wrapperBorderClassByState: Record<GrInputTagState, string>;
+/**
+ * Ошибка валидации красится своей ролью, а не декоративным тоном `danger`:
+ * `state="danger"` — это подсветка по решению разработчика, `invalid` — вердикт
+ * валидации, и тема вправе развести их по цвету.
+ */
+export declare const invalidWrapperBorderClass = "border-[var(--gr-invalid-brd)] focus-within:ring-[var(--gr-invalid-ring)]";
+export declare const wrapperBaseClass = "w-full flex flex-wrap items-center rounded-[var(--gr-radius-control)] border text-[var(--gr-fg)] transition-colors duration-[var(--gr-duration-fast)] focus-within:ring-2 focus-within:ring-[var(--gr-ring)]";
+export declare const wrapperEnabledClass = "bg-[var(--gr-bg)] cursor-text";
+/**
+ * Заблокированное поле гасится фоном, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA токены текста. Фон взаимоисключающий с `wrapperEnabledClass` —
+ * два `bg-*` одной специфичности разрулил бы порядок в сгенерированном CSS.
+ */
+export declare const wrapperDisabledClass = "bg-[var(--gr-muted)] text-[var(--gr-muted-fg)] cursor-not-allowed";
+/**
+ * Крестик наследует цвет тона бейджа (`text-current`) в полную силу: гасить его
+ * прозрачностью нельзя — контраст глифа тогда зависит от тона чипа, а на тёмном
+ * бейдже он проваливается.
+ */
+export declare const removeButtonClass = "-mr-0.5 shrink-0 inline-flex items-center justify-center rounded-[var(--gr-radius-control)] p-0.5 text-current focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const clearButtonClass = "ml-auto shrink-0 inline-flex items-center justify-center rounded-[var(--gr-radius-control)] p-0.5 text-[var(--gr-muted-fg)] transition-colors hover:text-[var(--gr-fg)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const spinnerClass = "shrink-0 inline-flex items-center justify-center text-[var(--gr-muted-fg)]";
 export declare function grInputTagWrapperClass(options: {
     size: GrInputTagSize;
     state: GrInputTagState;

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

@@ -1,6 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrInputTagComponent from './GrInputTag.vue';
 export { default } from './GrInputTag.vue';
 export { default as GrInputTag } from './GrInputTag.vue';
 export { grInputTagConfig } from './config';
+export type { GrInputTagConfigurableProps } from './defaults';
 export type { GrInputTagProps } from './GrInputTag.vue';
 export type { GrInputTagSize, GrInputTagState } from './grInputTagStyles';
 export { grInputTagSafelist } from './safelist';
+export type { GrInputTagEmits } from './GrInputTag.vue';
+export type GrInputTagInstance = ComponentExposed<typeof GrInputTagComponent>;

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

@@ -1,22 +1,43 @@
+import type { GrComponentSize } from '../shared/sizes';
+export interface GrKbdProps {
+    size?: GrKbdSize;
+    /**
+     * Сочетание: строкой (`"mod+shift+K"`) или набором токенов
+     * (`['mod', 'K']`). Токен `mod` — Cmd на macOS, Ctrl на остальных.
+     */
+    keys?: string | string[];
+    /** Разделитель между клавишами сочетания. Пустая строка — только зазор. */
+    separator?: string;
+    platform?: GrKbdPlatform;
+}
 /**
- * GrKbd — GR-примитив для отображения клавиш/сочетаний (`<kbd>`).
+ * GrKbd — GR-примитив для отображения клавиш и сочетаний (`<kbd>`).
  *
- * Пример: `<GrKbd>⌘</GrKbd> <GrKbd>K</GrKbd>`.
+ * Одна клавиша — слотом: `<GrKbd>Esc</GrKbd>`.
+ * Сочетание — пропом: `<GrKbd keys="mod+K" />` (на macOS `⌘ K`, иначе `Ctrl K`).
  */
-export type GrKbdSize = 'sm' | 'md';
-type __VLS_Props = {
-    size?: GrKbdSize;
-};
+export type GrKbdSize = GrComponentSize;
+/** Откуда брать платформу для токена `mod`. */
+export type GrKbdPlatform = 'auto' | 'apple' | 'other';
 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>, {
-    size: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
-    size: string;
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrKbdProps>, {
+    size: undefined;
+    keys: undefined;
+    separator: string;
+    platform: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrKbdProps>, {
+    size: undefined;
+    keys: undefined;
+    separator: string;
+    platform: string;
 }>>> & Readonly<{}>, {
     size: GrKbdSize;
+    separator: string;
+    keys: string | string[];
+    platform: GrKbdPlatform;
 }, {}, {}, {}, 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/GrKbd/config.d.ts

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

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

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

package/dist/types/src/components/GrKbd/grKbdStyles.d.ts

@@ -0,0 +1,15 @@
+import type { GrComponentSize } from '../shared/sizes';
+/**
+ * Классы `GrKbd`.
+ *
+ * Шкала полная (`xs…lg`), а не «sm и всё остальное»: тип пропа обещает четыре
+ * ступени, и `xs`/`lg` не должны молча рендериться как `md`.
+ */
+export declare const keyBaseClass = "inline-flex items-center justify-center rounded-[var(--gr-radius-control)] border border-[var(--gr-brd)] bg-[var(--gr-muted)] font-medium leading-none text-[var(--gr-muted-fg)] shadow-[var(--gr-shadow-1)] [font-variant-numeric:tabular-nums]";
+export declare const keySizes: Record<GrComponentSize, string>;
+/** Обёртка комбинации: сама рамки не имеет — её рисуют вложенные клавиши. */
+export declare const comboBaseClass = "inline-flex items-center align-middle";
+export declare const comboGaps: Record<GrComponentSize, string>;
+export declare const separatorClass = "select-none text-[var(--gr-muted-fg)]";
+export declare function grKbdKeyClass(size: GrComponentSize): string;
+export declare function grKbdComboClass(size: GrComponentSize): string;

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

@@ -1,4 +1,7 @@
 export { default } from './GrKbd.vue';
 export { default as GrKbd } from './GrKbd.vue';
-export type { GrKbdSize } from './GrKbd.vue';
+export type { GrKbdPlatform, GrKbdSize } from './GrKbd.vue';
 export { grKbdConfig } from './config';
+export type { GrKbdConfigurableProps } from './defaults';
+export { grKbdSafelist } from './safelist';
+export type { GrKbdProps } from './GrKbd.vue';

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

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

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

@@ -18,11 +18,11 @@
  */
 import { type Component } from 'vue';
 import { type GrLinkSize, type GrLinkTone, type GrLinkUnderline, type GrLinkVariant } from './grLinkStyles';
-type __VLS_Props = {
+export interface GrLinkProps {
     /**
-     * Кастомный корневой тег/компонент. Если передан и компонент не `disabled` —
-     * рендерится через `<component :is="as">`. Игнорируется при `disabled`.
-     */
+    * Кастомный корневой тег/компонент. Если передан и компонент не `disabled` —
+    * рендерится через `<component :is="as">`. Игнорируется при `disabled`.
+    */
     as?: string | Component;
     href?: string;
     external?: boolean;
@@ -36,12 +36,19 @@ type __VLS_Props = {
     variant?: GrLinkVariant;
     underline?: GrLinkUnderline;
     size?: GrLinkSize;
-};
+    /**
+    * Иконка внешней ссылки. По умолчанию показывается у любой ссылки, которая
+    * открывается в новой вкладке, — не только при `external`.
+    */
+    externalIcon?: boolean;
+    /** i18n: скрытая подсказка «откроется в новой вкладке». */
+    newTabLabel?: string;
+}
 declare var __VLS_8: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => 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<GrLinkProps>, {
     as: undefined;
     href: undefined;
     external: boolean;
@@ -52,8 +59,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     tone: string;
     variant: string;
     underline: string;
-    size: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    size: undefined;
+    externalIcon: undefined;
+    newTabLabel: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLinkProps>, {
     as: undefined;
     href: undefined;
     external: boolean;
@@ -64,19 +73,23 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     tone: string;
     variant: string;
     underline: string;
-    size: string;
+    size: undefined;
+    externalIcon: undefined;
+    newTabLabel: undefined;
 }>>> & Readonly<{}>, {
     tone: GrLinkTone;
     variant: GrLinkVariant;
     size: GrLinkSize;
+    underline: GrLinkUnderline;
+    target: string;
+    href: string;
     disabled: boolean;
     ariaLabel: string;
     as: string | Component;
-    href: string;
-    target: string;
-    rel: string;
     external: boolean;
-    underline: GrLinkUnderline;
+    rel: string;
+    externalIcon: boolean;
+    newTabLabel: 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/GrLink/config.d.ts

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

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

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

package/dist/types/src/components/GrLink/grLinkStyles.d.ts

@@ -1,4 +1,5 @@
-import { GR_TONES, type GrTone } from '../shared/tones';
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrTone } from '../shared/tones';
 /**
  * Архитектура цвета GrLink (согласована с остальной GR, ср. GrButton):
  *
@@ -7,37 +8,34 @@ import { GR_TONES, type GrTone } from '../shared/tones';
  * - `variant` — уровень акцента (СТРУКТУРА), независимый от цвета:
  *   - `default` — текст окрашен в `tone` в покое, `tone-hover`/`tone-active` при
  *     наведении/нажатии (обычная акцентная ссылка);
- *   - `muted` — приглушённый текст (`--muted-fg`) в покое, окрашивается в `tone`
+ *   - `muted` — приглушённый текст (`--gr-muted-fg`) в покое, окрашивается в `tone`
  *     при наведении (вторичные/inline-ссылки в плотных областях).
  *
- * Раньше `variant` смешивал цвет и акцент (`primary/default/muted/muted-primary/danger`).
- * Теперь это ортогональные оси: `tone` × `variant`.
+ * Оси ортогональны намеренно: «красная ссылка» и «приглушённая ссылка» —
+ * независимые решения, и любая их комбинация осмысленна.
  */
 export type GrLinkTone = GrTone;
 export type GrLinkVariant = 'default' | 'muted';
 export type GrLinkUnderline = 'auto' | 'always' | 'none';
-export type GrLinkSize = 'sm' | 'md' | 'lg';
-export declare const baseRootClass = "inline-flex items-center gap-1 rounded-[6px] transition-colors duration-150";
-export declare const focusRingClass = "focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--ring)]";
+export type GrLinkSize = GrComponentSize;
+export declare const baseRootClass = "inline-flex items-center gap-1 rounded-[var(--gr-radius-control)] transition-colors duration-[var(--gr-duration-fast)]";
+export declare const focusRingClass = "focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
 export declare const sizeClassBySize: Record<GrLinkSize, string>;
 export declare const colorClass = "text-[var(--gr-link-color)] visited:text-[var(--gr-link-color)] hover:text-[var(--gr-link-color-hover)] active:text-[var(--gr-link-color-active)]";
-type GrLinkToneColors = {
-    base: string;
-    hover: string;
-    active: string;
-};
-export declare const linkToneColors: Record<GrLinkTone, GrLinkToneColors>;
 /** Инлайновые CSS-переменные цвета для текущей комбинации `tone` × `variant`. */
 export declare function grLinkColorStyle(options: {
     tone: GrLinkTone;
     variant: GrLinkVariant;
     disabled: boolean;
 }): Record<string, string>;
-export declare const disabledStateClass = "cursor-not-allowed opacity-60 text-[var(--muted-fg)]";
+/**
+ * Отключённая ссылка гасится цветом, а не `opacity`: прозрачность разбавляет
+ * выверенный на AA `--gr-muted-fg` и роняет контраст ниже нормы.
+ */
+export declare const disabledStateClass = "cursor-not-allowed text-[var(--gr-muted-fg)]";
 export declare const underlineClasses: readonly string[];
 export declare function grLinkClass(options: {
     size: GrLinkSize;
     underline: GrLinkUnderline;
     disabled: boolean;
 }): string;
-export { GR_TONES };

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

@@ -3,3 +3,5 @@ export { default as GrLink } from './GrLink.vue';
 export { grLinkConfig } from './config';
 export type { GrLinkSize, GrLinkTone, GrLinkUnderline, GrLinkVariant } from './grLinkStyles';
 export { grLinkSafelist } from './safelist';
+export type { GrLinkConfigurableProps } from './defaults';
+export type { GrLinkProps } from './GrLink.vue';

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

@@ -1,41 +1,66 @@
-export interface GrListProps {
+import type { GrCardVariant } from '../GrCard/grCardStyles';
+import { type GrVirtualAlign } from '../../composables/useVirtualList';
+export interface GrListProps<TItem = unknown> {
+    /**
+     * Поверхность списка — вариант карточки под ним. `ghost` убирает рамку и
+     * тень: список внутри уже существующей карточки не должен давать вторую.
+     */
+    variant?: GrCardVariant;
     /** Показывать ли горизонтальные разделители между элементами (по умолчанию — да). */
     divided?: boolean;
+    /** Идёт загрузка: вместо пунктов — строки-скелетоны, контейнер помечен `aria-busy`. */
+    loading?: boolean;
+    /** Сколько строк-заглушек показать при `loading`. */
+    loadingRows?: number;
+    /**
+     * Список пуст. По умолчанию определяется сам — по содержимому слота; проп
+     * нужен там, где потребитель знает лучше (например, слот заполнен
+     * заголовками групп, а данных в них нет).
+     */
+    empty?: boolean;
+    /** Текст пустого состояния. Слот `#empty` сильнее. */
+    emptyText?: string;
+    /**
+     * Данные списка. С ними пункты рисует слот `#item`, а не слот по умолчанию, —
+     * и только так список знает размер набора, то есть может его виртуализировать.
+     */
+    items?: TItem[];
+    /** Ключ пункта для `v-for`: имя поля или функция. Без него — индекс. */
+    itemKey?: string | ((item: TItem, index: number) => string | number);
+    /** Высота видимой части: контейнер становится скроллером. Число — пиксели. */
+    maxHeight?: number | string;
+    /** Держать в DOM только окно вокруг вьюпорта. Требует `items` и `maxHeight`. */
+    virtual?: boolean;
+    /** Оценка высоты пункта до замера. Уточняется по факту при первом рендере. */
+    estimatedItemSize?: number;
 }
-declare var __VLS_8: {}, __VLS_10: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_8) => any;
-} & {
-    default?: (props: typeof __VLS_10) => any;
+declare const __VLS_export: <T = unknown>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & __VLS_PrettifyLocal<GrListProps<T>> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        scrollToIndex: (index: number, align?: GrVirtualAlign) => void;
+    }>) => void;
+    attrs: any;
+    slots: {
+        loading?: (props: {}) => any;
+    } & {
+        empty?: (props: {}) => any;
+    } & {
+        item?: (props: {
+            item: T;
+            index: number;
+            aria: Record<string, number>;
+        }) => any;
+    } & {
+        default?: (props: {}) => any;
+    };
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListProps>, {
-    divided: boolean;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListProps>, {
-    divided: boolean;
-}>>> & Readonly<{}>, {
-    divided: boolean;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_TypePropsToOption<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? {
-        type: import('vue').PropType<Required<T>[K]>;
-    } : {
-        type: import('vue').PropType<T[K]>;
-        required: true;
-    };
-};
-type __VLS_WithDefaults<P, D> = {
-    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
-        default: D[K];
-    }> : P[K];
-};
-type __VLS_WithSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
 type __VLS_PrettifyLocal<T> = (T extends any ? {
     [K in keyof T]: T[K];
 } : {