@feugene/granularity 0.11.0 → 0.13.0

package/dist/styles/themes/dark.css

@@ -7,27 +7,39 @@
 .theme-dark,
 .dark {
   /* Surface roles */
-  --bg: #0f172a;
-  --fg: #f8fafc;
-  --card: #1e293b;
-  --card-fg: #f8fafc;
-  --popover: #1e293b;
-  --popover-fg: #f8fafc;
-  --muted: #334155;
-  --muted-fg: #94a3b8;
-  --secondary: #334155;
-  --secondary-fg: #f1f5f9;
-  --brd: #334155;
-  --input: #334155;
-  --ring: #818cf8;
+  --gr-bg: #0f172a;
+  --gr-fg: #f8fafc;
+  --gr-card: #1e293b;
+  --gr-card-fg: #f8fafc;
+  --gr-popover: #1e293b;
+  --gr-popover-fg: #f8fafc;
+  --gr-muted: #334155;
+  /* Симметрично light: минимум по фону `--gr-muted`/`--gr-secondary` (#334155).
+     Прежний #94a3b8 давал там 4.04, #aab6c7 даёт 5.04. */
+  --gr-muted-fg: #aab6c7;
+  --gr-secondary: #334155;
+  --gr-secondary-fg: #f1f5f9;
+  --gr-brd: #334155;
+  --gr-input: #334155;
+  --gr-ring: #818cf8;
 
   /* Action roles */
-  --primary: #6366f1;
-  --primary-fg: #ffffff;
-  --accent: #1e1b4b;
-  --accent-fg: #c7d2fe;
-  --destructive: #ef4444;
-  --destructive-fg: #ffffff;
+  /*
+   * Primary был единственным тоном, выпадавшим из конвенции тёмной темы
+   * (светлая заливка + тёмный текст, как у success/warning/danger/info/azure):
+   * оставался светло-тёмным индиго #6366f1 с белым текстом и проваливал сразу
+   * все три роли — текст на фоне 4.00, текст на карточке 3.27, белый на
+   * заливке 4.47. Светлый индиго с тёмным `-fg` даёт 6.38 / 5.23 / 6.38.
+   * Не indigo-400 (#818cf8): это ровно `--gr-info` тёмной темы, и solid-бейджи
+   * Primary и Info стали бы неотличимы.
+   * Кнопок не касается: GrButton задаёт свой `--gr-button-primary-bg`.
+   */
+  --gr-primary: #9d8bfa;
+  --gr-primary-fg: #0f172a;
+  --gr-accent: #1e1b4b;
+  --gr-accent-fg: #c7d2fe;
+  --gr-destructive: #ef4444;
+  --gr-destructive-fg: #ffffff;
 
   /* Status roles */
   --gr-success: #34d399;
@@ -56,21 +68,21 @@
   --gr-azure-text: #bae6fd;
 
   /* Data visualization roles */
-  --chart-1: #6366f1;
-  --chart-2: #34d399;
-  --chart-3: #fb923c;
-  --chart-4: #818cf8;
-  --chart-5: #a78bfa;
+  --gr-chart-1: #6366f1;
+  --gr-chart-2: #34d399;
+  --gr-chart-3: #fb923c;
+  --gr-chart-4: #818cf8;
+  --gr-chart-5: #a78bfa;
 
   /* Navigation roles */
-  --sidebar: #1e293b;
-  --sidebar-fg: #f8fafc;
-  --sidebar-primary: #6366f1;
-  --sidebar-primary-fg: #ffffff;
-  --sidebar-accent: #334155;
-  --sidebar-accent-fg: #f1f5f9;
-  --sidebar-brd: #334155;
-  --sidebar-ring: #818cf8;
+  --gr-sidebar: #1e293b;
+  --gr-sidebar-fg: #f8fafc;
+  --gr-sidebar-primary: #6366f1;
+  --gr-sidebar-primary-fg: #ffffff;
+  --gr-sidebar-accent: #334155;
+  --gr-sidebar-accent-fg: #f1f5f9;
+  --gr-sidebar-brd: #334155;
+  --gr-sidebar-ring: #818cf8;
 }
 
 @supports not (color: color-mix(in srgb, #000 50%, #fff)) {
@@ -78,14 +90,14 @@
   .dark,
   [data-theme='dark'] {
     /* Action role fallbacks */
-    --primary-hover: #6f72f2;
-    --primary-active: #7b7ef3;
-    --secondary-hover: #435062;
-    --secondary-active: #535f70;
-    --brd-hover: #6e7987;
-    --brd-active: #8c94a0;
-    --destructive-hover: #f05353;
-    --destructive-active: #f06161;
+    --gr-primary-hover: #a494fa;
+    --gr-primary-active: #ac9dfa;
+    --gr-secondary-hover: #435062;
+    --gr-secondary-active: #535f70;
+    --gr-brd-hover: #6e7987;
+    --gr-brd-active: #8c94a0;
+    --gr-destructive-hover: #f05353;
+    --gr-destructive-active: #f06161;
 
     /* Status role fallbacks */
     --gr-success-hover: #44d6a1;

package/dist/styles/themes/light.css

@@ -1,35 +1,51 @@
 :root {
   /* Surface roles */
-  --bg: #f8fafc;
-  --fg: #0f172a;
-  --card: #ffffff;
-  --card-fg: #0f172a;
-  --popover: #ffffff;
-  --popover-fg: #0f172a;
-  --muted: #f1f5f9;
-  --muted-fg: #64748b;
-  --secondary: #e2e8f0;
-  --secondary-fg: #1e293b;
-  --brd: #e2e8f0;
-  --input: #e2e8f0;
-  --ring: #6366f1;
+  --gr-bg: #f8fafc;
+  --gr-fg: #0f172a;
+  --gr-card: #ffffff;
+  --gr-card-fg: #0f172a;
+  --gr-popover: #ffffff;
+  --gr-popover-fg: #0f172a;
+  --gr-muted: #f1f5f9;
+  /*
+   * Вторичный текст обязан проходить AA на САМОМ ТЁМНОМ из фонов, на которых
+   * он появляется, а это не страница, а `--gr-secondary` (#e2e8f0). Прежний
+   * #64748b держался только на `--gr-bg` (4.55) и `--gr-card` (4.76), но
+   * проваливался на `--gr-muted` (4.34) и `--gr-secondary` (3.86) — то есть
+   * ровно там, где вторичный текст и живёт: чипы, таблицы, подписи в панелях.
+   * #556275 даёт минимум 5.02 по всем четырём фонам.
+   */
+  --gr-muted-fg: #556275;
+  --gr-secondary: #e2e8f0;
+  --gr-secondary-fg: #1e293b;
+  --gr-brd: #e2e8f0;
+  --gr-input: #e2e8f0;
+  --gr-ring: #6366f1;
 
   /* Action roles */
-  --primary: #4f46e5;
-  --primary-fg: #ffffff;
-  --accent: #eef2ff;
-  --accent-fg: #3730a3;
-  --destructive: #dc2626;
-  --destructive-fg: #ffffff;
+  --gr-primary: #4f46e5;
+  --gr-primary-fg: #ffffff;
+  --gr-accent: #eef2ff;
+  --gr-accent-fg: #3730a3;
+  --gr-destructive: #dc2626;
+  --gr-destructive-fg: #ffffff;
 
   /* Status roles */
+  /*
+   * `-fg` — цвет текста НА сплошной заливке тоном. У светлых заливок он обязан
+   * быть тёмным: белый на `--gr-success` даёт 2.54:1, на `--gr-warning` 2.80:1
+   * при пороге AA 4.5 — а это solid-кнопки и бейджи (`grButtonStyles.ts`,
+   * `grBadgeStyles.ts`). С `--gr-fg` получаем 7.04 и 6.37, и hover/active,
+   * которые уводят заливку в тёмную сторону, остаются выше порога (5.30 / 4.79).
+   * В `dark.css` эти токены уже тёмные — там заливки светлее фона.
+   */
   --gr-success: #10b981;
   --gr-success-light: #d1fae5;
-  --gr-success-fg: #ffffff;
+  --gr-success-fg: #0f172a;
   --gr-success-text: #065f46;
   --gr-warning: #f97316;
   --gr-warning-light: #ffedd5;
-  --gr-warning-fg: #ffffff;
+  --gr-warning-fg: #0f172a;
   --gr-warning-text: #7c2d12;
   --gr-danger: #dc2626;
   --gr-danger-light: #fee2e2;
@@ -43,40 +59,49 @@
   --gr-slate-light: #e2e8f0;
   --gr-slate-fg: #ffffff;
   --gr-slate-text: #334155;
-  --gr-azure: #0ea5e9;
+  /*
+   * Azure — единственный тон, который не чинится сменой `-fg`. Тёмный текст
+   * проходит на базе (6.44), но hover/active уводят заливку вниз и ломают его
+   * (4.36 / 3.01); белый же не проходит на базе (2.77). Выход один — сама
+   * заливка: sky-500 `#0ea5e9` слишком светлая для белого текста. `#0077b6` —
+   * самое светлое значение, дающее запас по всем трём состояниям
+   * (4.87 / 5.44 / 6.02) и заодно поднимающее azure-иконку на `-light`
+   * подложке с 2.42 до 4.24. Оттенок остаётся отличимым от `--gr-info`.
+   */
+  --gr-azure: #0077b6;
   --gr-azure-light: #e0f2fe;
   --gr-azure-fg: #ffffff;
   --gr-azure-text: #075985;
 
   /* Data visualization roles */
-  --chart-1: #4f46e5;
-  --chart-2: #10b981;
-  --chart-3: #f97316;
-  --chart-4: #6366f1;
-  --chart-5: #8b5cf6;
+  --gr-chart-1: #4f46e5;
+  --gr-chart-2: #10b981;
+  --gr-chart-3: #f97316;
+  --gr-chart-4: #6366f1;
+  --gr-chart-5: #8b5cf6;
 
   /* Navigation roles */
-  --sidebar: #ffffff;
-  --sidebar-fg: #0f172a;
-  --sidebar-primary: #4f46e5;
-  --sidebar-primary-fg: #ffffff;
-  --sidebar-accent: #f1f5f9;
-  --sidebar-accent-fg: #1e293b;
-  --sidebar-brd: #e2e8f0;
-  --sidebar-ring: #6366f1;
+  --gr-sidebar: #ffffff;
+  --gr-sidebar-fg: #0f172a;
+  --gr-sidebar-primary: #4f46e5;
+  --gr-sidebar-primary-fg: #ffffff;
+  --gr-sidebar-accent: #f1f5f9;
+  --gr-sidebar-accent-fg: #1e293b;
+  --gr-sidebar-brd: #e2e8f0;
+  --gr-sidebar-ring: #6366f1;
 }
 
 @supports not (color: color-mix(in srgb, #000 50%, #fff)) {
   :root {
     /* Action role fallbacks */
-    --primary-hover: #4a42d6;
-    --primary-active: #453ec7;
-    --secondary-hover: #d1d7e0;
-    --secondary-active: #c0c7d0;
-    --brd-hover: #a3a9b5;
-    --brd-active: #838a97;
-    --destructive-hover: #cc2526;
-    --destructive-active: #bb2427;
+    --gr-primary-hover: #4a42d6;
+    --gr-primary-active: #453ec7;
+    --gr-secondary-hover: #d1d7e0;
+    --gr-secondary-active: #c0c7d0;
+    --gr-brd-hover: #a3a9b5;
+    --gr-brd-active: #838a97;
+    --gr-destructive-hover: #cc2526;
+    --gr-destructive-active: #bb2427;
 
     /* Status role fallbacks */
     --gr-success-hover: #10ac7a;
@@ -89,8 +114,8 @@
     --gr-info-active: #5659d1;
     --gr-slate-hover: #435062;
     --gr-slate-active: #3d4a5b;
-    --gr-azure-hover: #0284c7;
-    --gr-azure-active: #0369a1;
+    --gr-azure-hover: #016fab;
+    --gr-azure-active: #0268a0;
 
     /* Component semantic fallbacks */
     /*--gr-category-tree-branch-line-active-color: #c4cdf7;*/

package/dist/styles/tokens.css

@@ -110,26 +110,26 @@
   --gr-z-toast: 1200;
 
   /* Derived interaction formulas: action roles */
-  --primary-hover: color-mix(in srgb, var(--primary) 92%, var(--fg));
-  --primary-active: color-mix(in srgb, var(--primary) 84%, var(--fg));
-  --secondary-hover: color-mix(in srgb, var(--secondary) 92%, var(--fg));
-  --secondary-active: color-mix(in srgb, var(--secondary) 84%, var(--fg));
-  --brd-hover: color-mix(in srgb, var(--brd) 70%, var(--fg));
-  --brd-active: color-mix(in srgb, var(--brd) 55%, var(--fg));
-  --destructive-hover: color-mix(in srgb, var(--destructive) 92%, var(--fg));
-  --destructive-active: color-mix(in srgb, var(--destructive) 84%, var(--fg));
+  --gr-primary-hover: color-mix(in srgb, var(--gr-primary) 92%, var(--gr-fg));
+  --gr-primary-active: color-mix(in srgb, var(--gr-primary) 84%, var(--gr-fg));
+  --gr-secondary-hover: color-mix(in srgb, var(--gr-secondary) 92%, var(--gr-fg));
+  --gr-secondary-active: color-mix(in srgb, var(--gr-secondary) 84%, var(--gr-fg));
+  --gr-brd-hover: color-mix(in srgb, var(--gr-brd) 70%, var(--gr-fg));
+  --gr-brd-active: color-mix(in srgb, var(--gr-brd) 55%, var(--gr-fg));
+  --gr-destructive-hover: color-mix(in srgb, var(--gr-destructive) 92%, var(--gr-fg));
+  --gr-destructive-active: color-mix(in srgb, var(--gr-destructive) 84%, var(--gr-fg));
 
   /* Derived interaction formulas: status roles */
-  --gr-success-hover: color-mix(in srgb, var(--gr-success) 92%, var(--fg));
-  --gr-success-active: color-mix(in srgb, var(--gr-success) 84%, var(--fg));
-  --gr-warning-hover: color-mix(in srgb, var(--gr-warning) 92%, var(--fg));
-  --gr-warning-active: color-mix(in srgb, var(--gr-warning) 84%, var(--fg));
-  --gr-danger-hover: color-mix(in srgb, var(--gr-danger) 92%, var(--fg));
-  --gr-danger-active: color-mix(in srgb, var(--gr-danger) 84%, var(--fg));
-  --gr-info-hover: color-mix(in srgb, var(--gr-info) 92%, var(--fg));
-  --gr-info-active: color-mix(in srgb, var(--gr-info) 84%, var(--fg));
-  --gr-slate-hover: color-mix(in srgb, var(--gr-slate) 92%, var(--fg));
-  --gr-slate-active: color-mix(in srgb, var(--gr-slate) 84%, var(--fg));
-  --gr-azure-hover: color-mix(in srgb, var(--gr-azure) 92%, var(--fg));
-  --gr-azure-active: color-mix(in srgb, var(--gr-azure) 84%, var(--fg));
+  --gr-success-hover: color-mix(in srgb, var(--gr-success) 92%, var(--gr-fg));
+  --gr-success-active: color-mix(in srgb, var(--gr-success) 84%, var(--gr-fg));
+  --gr-warning-hover: color-mix(in srgb, var(--gr-warning) 92%, var(--gr-fg));
+  --gr-warning-active: color-mix(in srgb, var(--gr-warning) 84%, var(--gr-fg));
+  --gr-danger-hover: color-mix(in srgb, var(--gr-danger) 92%, var(--gr-fg));
+  --gr-danger-active: color-mix(in srgb, var(--gr-danger) 84%, var(--gr-fg));
+  --gr-info-hover: color-mix(in srgb, var(--gr-info) 92%, var(--gr-fg));
+  --gr-info-active: color-mix(in srgb, var(--gr-info) 84%, var(--gr-fg));
+  --gr-slate-hover: color-mix(in srgb, var(--gr-slate) 92%, var(--gr-fg));
+  --gr-slate-active: color-mix(in srgb, var(--gr-slate) 84%, var(--gr-fg));
+  --gr-azure-hover: color-mix(in srgb, var(--gr-azure) 92%, var(--gr-fg));
+  --gr-azure-active: color-mix(in srgb, var(--gr-azure) 84%, var(--gr-fg));
 }

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

@@ -1,34 +1,45 @@
 import type { GrTone } from '../shared/tones';
+import type { GrAlertVariantInput } from './grAlertStyles';
+import './defaults';
 export type GrAlertTone = GrTone;
-export type GrAlertVariant = 'soft' | 'light';
-type __VLS_Props = {
+export type { GrAlertVariant, GrAlertVariantInput } from './grAlertStyles';
+/**
+ * Режим объявления сообщения скринридеру.
+ * `auto` — по тону: `warning`/`danger` перебивают речь (`role="alert"`),
+ * остальные ждут паузы (`role="status"`).
+ */
+export type GrAlertLive = 'auto' | 'assertive' | 'polite' | 'off';
+export interface GrAlertProps {
     tone?: GrAlertTone;
-    variant?: GrAlertVariant;
+    variant?: GrAlertVariantInput;
     title?: string;
     closable?: boolean;
+    live?: GrAlertLive;
     backgroundColor?: string;
     textColor?: string;
     borderColor?: string;
-};
+}
 declare var __VLS_6: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_6) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
-    tone: string;
-    variant: string;
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrAlertProps>, {
+    tone: undefined;
+    variant: undefined;
     title: undefined;
-    closable: boolean;
+    closable: undefined;
+    live: string;
     backgroundColor: undefined;
     textColor: undefined;
     borderColor: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     close: () => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
-    tone: string;
-    variant: string;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrAlertProps>, {
+    tone: undefined;
+    variant: undefined;
     title: undefined;
-    closable: boolean;
+    closable: undefined;
+    live: string;
     backgroundColor: undefined;
     textColor: undefined;
     borderColor: undefined;
@@ -36,9 +47,10 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     onClose?: (() => any) | undefined;
 }>, {
     tone: GrAlertTone;
-    variant: GrAlertVariant;
-    title: string;
+    variant: GrAlertVariantInput;
     closable: boolean;
+    title: string;
+    live: GrAlertLive;
     backgroundColor: string;
     textColor: string;
     borderColor: string;

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

@@ -0,0 +1,17 @@
+import type { GrTone } from '../shared/tones';
+import type { GrAlertVariantInput } from './grAlertStyles';
+/**
+ * Пропы `GrAlert`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrAlert: { … } }">`.
+ * Только оформление — см. `GrButton/defaults.ts`.
+ */
+export interface GrAlertConfigurableProps {
+    tone: GrTone;
+    variant: GrAlertVariantInput;
+    closable: boolean;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrAlert: GrAlertConfigurableProps;
+    }
+}

package/dist/types/src/components/GrAlert/grAlertStyles.d.ts

@@ -0,0 +1,55 @@
+import type { GrTone } from '../shared/tones';
+/**
+ * Цветовая модель `GrAlert`.
+ *
+ * Модуль намеренно чистый: он оперирует **строками CSS-значений**, а не
+ * utility-классами UnoCSS. Классы, живущие только строковыми литералами в
+ * `.ts`, не сканируются `granularContent` и требуют ручного safelist — здесь
+ * этой проблемы нет по построению, а логику цветов можно тестировать без
+ * монтирования компонента.
+ */
+/**
+ * `soft` — залитая тоном подложка, тональный текст. Основной вариант.
+ * `outline` — фон страницы, тон несут рамка и иконка; текст нейтральный.
+ *
+ * `light` (устаревший) нормализуется в `soft`: раньше он существовал ровно для
+ * одного тона (`warning`) и был набран hex-литералами, то есть не реагировал на
+ * смену темы. См. {@link normalizeGrAlertVariant}.
+ */
+export declare const GR_ALERT_VARIANTS: readonly ["soft", "outline"];
+export type GrAlertVariant = typeof GR_ALERT_VARIANTS[number];
+/** То, что компонент принимает в проп `variant`, включая устаревший алиас. */
+export type GrAlertVariantInput = GrAlertVariant | 'light';
+/** Ключ иконки тона. Сама иконка резолвится в SFC — модуль остаётся чистым. */
+export type GrAlertIconKey = 'info' | 'success' | 'warning' | 'danger';
+/** Разрешённые цвета одного алерта — ровно то, что уходит в CSS-переменные. */
+export type GrAlertColors = {
+    bg: string;
+    border: string;
+    icon: string;
+    title: string;
+    text: string;
+    close: string;
+    closeHover: string;
+    closeHoverBg: string;
+};
+/** Пользовательские переопределения цвета (пропы-эскейпы). */
+export type GrAlertColorOverrides = {
+    backgroundColor?: string;
+    textColor?: string;
+    borderColor?: string;
+};
+export declare function normalizeGrAlertVariant(variant: GrAlertVariantInput): GrAlertVariant;
+export declare function grAlertIconKey(tone: GrTone): GrAlertIconKey;
+export declare function resolveGrAlertColors(tone: GrTone, variant: GrAlertVariant): GrAlertColors;
+/**
+ * Пропы-эскейпы поверх тона. `textColor` красит весь текстовый слой целиком
+ * (иконка, заголовок, текст, кнопка закрытия) — иначе пользовательский цвет
+ * соседствовал бы с тональным и давал грязь.
+ */
+export declare function applyGrAlertOverrides(colors: GrAlertColors, overrides: GrAlertColorOverrides): GrAlertColors;
+/**
+ * Публичный контракт кастомизации: переменные `--gr-alert-*` можно
+ * переопределить снаружи так же, как их задаёт компонент.
+ */
+export declare function grAlertCssVars(colors: GrAlertColors): Record<string, string>;

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

@@ -1,4 +1,7 @@
 export { default } from './GrAlert.vue';
 export { default as GrAlert } from './GrAlert.vue';
 export { grAlertConfig } from './config';
-export type { GrAlertTone, GrAlertVariant } from './GrAlert.vue';
+export type { GrAlertLive, GrAlertProps, GrAlertTone } from './GrAlert.vue';
+export type { GrAlertConfigurableProps } from './defaults';
+export { applyGrAlertOverrides, GR_ALERT_VARIANTS, grAlertCssVars, grAlertIconKey, normalizeGrAlertVariant, resolveGrAlertColors, } from './grAlertStyles';
+export type { GrAlertColorOverrides, GrAlertColors, GrAlertIconKey, GrAlertVariant, GrAlertVariantInput, } from './grAlertStyles';

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

@@ -0,0 +1,153 @@
+import { type GrAutocompleteModelValue, type GrAutocompleteOption, type GrAutocompleteSize } from './grAutocompleteStyles';
+export type { GrAutocompleteModelValue, GrAutocompleteOption, GrAutocompleteSize, } from './grAutocompleteStyles';
+/**
+ * Публичный GR-примитив «Autocomplete / Combobox» (WAI-ARIA editable combobox).
+ *
+ * В отличие от `GrSelect` (select-only combobox с кнопкой-триггером), здесь
+ * combobox-ом является сам текстовый `<input>`: набранный текст — это поисковый
+ * запрос, а выбор опции заполняет поле. Поддерживает локальную фильтрацию,
+ * удалённую (async) загрузку через событие `search` + внешний проп `loading`,
+ * произвольные значения (`allowCustomValue`) и multiple с удаляемыми chips.
+ */
+export interface GrAutocompleteProps {
+    /** Выбранное значение (single — строка, multiple — массив строк). */
+    modelValue: GrAutocompleteModelValue;
+    /**
+     * Доступные опции. Для локального режима — полный список (фильтруется на клиенте).
+     * Для remote-режима (`filterable=false`) — список, который родитель обновляет
+     * в ответ на событие `search`.
+     */
+    options?: GrAutocompleteOption[];
+    multiple?: boolean;
+    disabled?: boolean;
+    size?: GrAutocompleteSize;
+    placeholder?: string;
+    ariaLabel?: string;
+    /** Кнопка очистки выбранного значения/запроса. */
+    clearable?: boolean;
+    /** Внешне управляемое состояние загрузки (для async-сценариев). */
+    loading?: boolean;
+    /**
+     * Локальная фильтрация опций по введённому запросу. Отключите (`false`) для
+     * чисто удалённого поиска — тогда `options` показываются как есть, а фильтрацию
+     * выполняет сервер по событию `search`.
+     */
+    filterable?: boolean;
+    /** Кастомный матчер локальной фильтрации. По умолчанию — подстрока в `label`/`value`. */
+    filter?: (option: GrAutocompleteOption, query: string) => boolean;
+    /** Минимальная длина запроса до эмита `search` (для дебаунса remote-загрузки). */
+    minQueryLength?: number;
+    /** Задержка дебаунса события `search`, мс. */
+    debounce?: number;
+    /** Разрешить ввод/коммит значения, которого нет в `options`. */
+    allowCustomValue?: boolean;
+    /** Закрывать панель после выбора (single всегда закрывает). */
+    closeOnSelect?: boolean;
+    /** Максимальная высота панели, px. */
+    dropdownMaxHeight?: number;
+    /** i18n-тексты состояний панели / aria. */
+    loadingText?: string;
+    noResultsText?: string;
+    clearLabel?: string;
+}
+declare var __VLS_13: {
+    option: GrAutocompleteOption;
+    selected: boolean;
+}, __VLS_15: {}, __VLS_17: {};
+type __VLS_Slots = {} & {
+    option?: (props: typeof __VLS_13) => any;
+} & {
+    loading?: (props: typeof __VLS_15) => any;
+} & {
+    empty?: (props: typeof __VLS_17) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrAutocompleteProps>, {
+    options: undefined;
+    multiple: boolean;
+    disabled: boolean;
+    size: undefined;
+    placeholder: undefined;
+    ariaLabel: undefined;
+    clearable: undefined;
+    loading: boolean;
+    filterable: boolean;
+    filter: undefined;
+    minQueryLength: number;
+    debounce: number;
+    allowCustomValue: boolean;
+    closeOnSelect: boolean;
+    dropdownMaxHeight: number;
+    loadingText: undefined;
+    noResultsText: undefined;
+    clearLabel: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: GrAutocompleteModelValue) => void;
+    search: (query: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrAutocompleteProps>, {
+    options: undefined;
+    multiple: boolean;
+    disabled: boolean;
+    size: undefined;
+    placeholder: undefined;
+    ariaLabel: undefined;
+    clearable: undefined;
+    loading: boolean;
+    filterable: boolean;
+    filter: undefined;
+    minQueryLength: number;
+    debounce: number;
+    allowCustomValue: boolean;
+    closeOnSelect: boolean;
+    dropdownMaxHeight: number;
+    loadingText: undefined;
+    noResultsText: undefined;
+    clearLabel: undefined;
+}>>> & Readonly<{
+    onSearch?: ((query: string) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: GrAutocompleteModelValue) => any) | undefined;
+}>, {
+    size: GrAutocompleteSize;
+    clearable: boolean;
+    filter: (option: GrAutocompleteOption, query: string) => boolean;
+    loading: boolean;
+    options: GrAutocompleteOption[];
+    multiple: boolean;
+    disabled: boolean;
+    placeholder: string;
+    ariaLabel: string;
+    filterable: boolean;
+    minQueryLength: number;
+    debounce: number;
+    allowCustomValue: boolean;
+    closeOnSelect: boolean;
+    dropdownMaxHeight: number;
+    loadingText: string;
+    noResultsText: string;
+    clearLabel: 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/GrAutocomplete/config.d.ts

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

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

@@ -0,0 +1,15 @@
+import type { GrAutocompleteSize } from './grAutocompleteStyles';
+/**
+ * Пропы `GrAutocomplete`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrAutocomplete: { … } }">`.
+ * Только оформление и поведение по умолчанию — см. `GrButton/defaults.ts`.
+ */
+export interface GrAutocompleteConfigurableProps {
+    size: GrAutocompleteSize;
+    clearable: boolean;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrAutocomplete: GrAutocompleteConfigurableProps;
+    }
+}