@feugene/granularity 0.10.0 → 0.12.0

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

@@ -1,30 +1,53 @@
-/**
- * GrSidebar — боковая панель приложения с заголовком и слотом контента.
- *
- * Слоты `#title` / `#subtitle` имеют приоритет над одноимёнными пропами
- * и позволяют передать произвольную разметку (иконки, бейджи, действия).
- */
 export interface GrSidebarProps {
     title?: string;
     subtitle?: string;
+    /** Свёрнутое состояние. Поддерживает `v-model:collapsed`. */
+    collapsed?: boolean;
+    /** Показать кнопку сворачивания/разворачивания в хедере. */
+    showToggleButton?: boolean;
+    /** Ширина в развёрнутом состоянии. */
+    width?: string;
+    /** Ширина в свёрнутом состоянии. */
+    collapsedWidth?: string;
+    /** A11y-лейбл кнопки тогла. */
+    toggleLabel?: string;
 }
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_29: {};
 type __VLS_Slots = {} & {
     subtitle?: (props: typeof __VLS_1) => any;
 } & {
     title?: (props: typeof __VLS_3) => any;
 } & {
-    default?: (props: typeof __VLS_5) => any;
+    default?: (props: typeof __VLS_29) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSidebarProps>, {
     title: undefined;
     subtitle: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSidebarProps>, {
+    collapsed: boolean;
+    showToggleButton: boolean;
+    width: string;
+    collapsedWidth: string;
+    toggleLabel: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:collapsed": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrSidebarProps>, {
     title: undefined;
     subtitle: undefined;
-}>>> & Readonly<{}>, {
+    collapsed: boolean;
+    showToggleButton: boolean;
+    width: string;
+    collapsedWidth: string;
+    toggleLabel: undefined;
+}>>> & Readonly<{
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+}>, {
     title: string;
+    width: string;
     subtitle: string;
+    collapsed: boolean;
+    showToggleButton: boolean;
+    collapsedWidth: string;
+    toggleLabel: 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/GrSidebar/GrSidebarItem.vue.d.ts

@@ -0,0 +1,64 @@
+/**
+ * GrSidebarItem — пункт навигации боковой панели `GrSidebar`.
+ *
+ * Контракт:
+ * - развёрнутая панель — `[иконка] метка [бейдж]`;
+ * - свёрнутая панель — только иконка; если иконки нет, показывается ПЕРВАЯ БУКВА
+ *   метки (uppercase). В свёрнутом виде метка уходит в `title`/`aria-label` для
+ *   доступности и tooltip.
+ *
+ * Корневой тег: `as` → `<a href>` → `<button>` (в этом порядке).
+ */
+import { type Component } from 'vue';
+type __VLS_Props = {
+    label: string;
+    /** Иконка: класс UnoCSS-иконки (`'i-lucide-home'`) или Vue-компонент. */
+    icon?: string | Component;
+    href?: string;
+    as?: string | Component;
+    active?: boolean;
+    disabled?: boolean;
+    badge?: string | number;
+};
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    icon: undefined;
+    href: undefined;
+    as: undefined;
+    active: boolean;
+    disabled: boolean;
+    badge: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    icon: undefined;
+    href: undefined;
+    as: undefined;
+    active: boolean;
+    disabled: boolean;
+    badge: undefined;
+}>>> & Readonly<{}>, {
+    icon: string | Component;
+    disabled: boolean;
+    as: string | Component;
+    href: string;
+    active: boolean;
+    badge: string | number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -1,3 +1,4 @@
 export { default } from './GrSidebar.vue';
 export { default as GrSidebar, type GrSidebarProps } from './GrSidebar.vue';
+export { default as GrSidebarItem } from './GrSidebarItem.vue';
 export { grSidebarConfig } from './config';

package/dist/types/src/components/GrSidebar/sidebarContext.d.ts

@@ -0,0 +1,9 @@
+import type { InjectionKey, Ref } from 'vue';
+/**
+ * Контекст `GrSidebar`, который потребляют `GrSidebarItem`'ы: свёрнута ли панель.
+ * В свёрнутом состоянии пункты показывают только иконку (или первую букву метки).
+ */
+export interface GrSidebarContext {
+    collapsed: Ref<boolean>;
+}
+export declare const GR_SIDEBAR_KEY: InjectionKey<GrSidebarContext>;

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

@@ -1,7 +1,7 @@
 import { type GrSwitchSize } from './grSwitchStyles';
 export type { GrSwitchSize } from './grSwitchStyles';
 /**
- * Пропсы публичного DS-примитива «Switch».
+ * Пропсы публичного GR-примитива «Switch».
  */
 export interface GrSwitchProps {
     modelValue: boolean;

package/dist/types/src/components/GrSwitch/grSwitchStyles.d.ts

@@ -3,9 +3,9 @@ type GrSwitchThumbClassOptions = {
     checked: boolean;
     size: GrSwitchSize;
 };
-export declare const trackBase = "relative inline-flex items-center rounded-full border border-[var(--ds-switch-track-brd)] transition-colors duration-150";
+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 trackSizes: Record<GrSwitchSize, string>;
-export declare const thumbBase = "inline-block rounded-full bg-[var(--card)] shadow-[var(--ds-shadow-1)] transition-transform duration-150";
+export declare const thumbBase = "inline-block shrink-0 rounded-full bg-[var(--card)] shadow-[var(--gr-shadow-1)] transition-transform duration-150";
 export declare const thumbSizes: Record<GrSwitchSize, string>;
 export declare const thumbTranslations: Record<GrSwitchSize, {
     checked: string;

package/dist/types/src/components/GrTabPanels/GrTabPanel.vue.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GrTabPanel — одна панель внутри `GrTabPanels`. Показывается, когда её `value`
+ * равно активной вкладке. `keepAlive` оставляет неактивные панели в DOM
+ * (скрытыми через `hidden`) — полезно, чтобы не терять состояние форм.
+ */
+type __VLS_Props = {
+    value: string;
+    keepAlive?: boolean;
+};
+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>, {
+    keepAlive: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    keepAlive: boolean;
+}>>> & Readonly<{}>, {
+    keepAlive: 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];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -0,0 +1,51 @@
+/**
+ * GrTabPanels — контейнер `tabpanel`-ов, companion к `GrTabs`.
+ *
+ * Показывает панель, чьё `value` совпадает с `modelValue`, и связывает её с
+ * соответствующей вкладкой по ARIA (`role="tabpanel"`, `aria-labelledby`).
+ *
+ * Для полной связки `tab`↔`tabpanel` передайте **одинаковый `idBase`** и в
+ * `GrTabs`, и в `GrTabPanels` — тогда id вкладок и панелей совпадут
+ * (`aria-controls` ↔ `aria-labelledby`).
+ */
+type __VLS_Props = {
+    modelValue: string;
+    idBase?: string;
+};
+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>, {
+    idBase: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    idBase: undefined;
+}>>> & Readonly<{}>, {
+    idBase: 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/GrTabPanels/config.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Granular-конфиг семейства `GrTabPanels` (контейнер `GrTabPanels` + панель
+ * `GrTabPanel`). Companion к `GrTabs` для ARIA-связки `tab`↔`tabpanel`.
+ */
+export declare const grTabPanelsConfig: import("@feugene/unocss-preset-granular").GranularComponentDescriptor<"GrTabPanels">;

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

@@ -0,0 +1,9 @@
+import type { ComputedRef, InjectionKey } from 'vue';
+/** Контекст, который `GrTabPanels` предоставляет своим `GrTabPanel`. */
+export interface GrTabPanelsContext {
+    /** Значение активной вкладки (совпадает с `modelValue` у `GrTabs`). */
+    activeValue: ComputedRef<string>;
+    /** Общая база id для связки `tab`↔`tabpanel` (см. проп `idBase` у `GrTabs`). */
+    idBase: string;
+}
+export declare const GR_TAB_PANELS_KEY: InjectionKey<GrTabPanelsContext>;

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

@@ -0,0 +1,6 @@
+export { default } from './GrTabPanels.vue';
+export { default as GrTabPanels } from './GrTabPanels.vue';
+export { default as GrTabPanel } from './GrTabPanel.vue';
+export type { GrTabPanelsContext } from './context';
+export { GR_TAB_PANELS_KEY } from './context';
+export { grTabPanelsConfig } from './config';

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

@@ -7,6 +7,12 @@ export type GrTab = {
 export type GrTabsProps = {
     modelValue: string;
     tabs: GrTab[];
+    /**
+     * База id для ARIA-связки с `GrTabPanels`. Если задана, каждая вкладка
+     * получает `id="<idBase>-tab-<value>"` и `aria-controls="<idBase>-panel-<value>"`.
+     * Передайте тот же `idBase` в `GrTabPanels`, чтобы связать `tab`↔`tabpanel`.
+     */
+    idBase?: string;
 };
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<GrTabsProps>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => void;

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

@@ -3,6 +3,8 @@ export type { GrToasterPlacement };
 export interface GrToasterProps {
     /** Угол экрана для стека уведомлений. */
     placement?: GrToasterPlacement;
+    /** Максимум одновременно видимых тостов; остальные ждут в очереди. По умолчанию `4`. */
+    maxVisible?: number;
     /** A11y-лейбл кнопки закрытия (i18n). */
     dismissLabel?: string;
     /** A11y-лейбл контейнера-региона (i18n). */
@@ -10,16 +12,19 @@ export interface GrToasterProps {
 }
 declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
     placement: string;
-    dismissLabel: string;
-    regionLabel: string;
+    maxVisible: number;
+    dismissLabel: undefined;
+    regionLabel: undefined;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
     placement: string;
-    dismissLabel: string;
-    regionLabel: string;
+    maxVisible: number;
+    dismissLabel: undefined;
+    regionLabel: undefined;
 }>>> & Readonly<{}>, {
     dismissLabel: string;
     regionLabel: string;
     placement: GrToasterPlacement;
+    maxVisible: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -24,7 +24,7 @@ declare const __VLS_export: <T extends Record<string, any> = any>(__VLS_props: N
         (event: "nodeDrop", draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType): void;
     };
 }>) => import("vue").VNode & {
-    __ctx?: Awaited<typeof __VLS_setup>;
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/src/components/GrTree/grTreeInteractionContext.d.ts

@@ -18,6 +18,8 @@ export type GrTreeInteractionEmitters<T> = {
 };
 export type GrTreeInteractionContext<T> = {
     hoveredKey: Ref<GrTreeKey | undefined>;
+    /** Клавиша узла, держащего roving-фокус (единственный tabindex=0 во всём дереве). */
+    focusedKey: Ref<GrTreeKey | undefined>;
     draggingNode: ShallowRef<GrTreeNode<T> | null>;
     dropTarget: ShallowRef<GrTreeDropTarget | null>;
     canDrag: (node: GrTreeNode<T>) => boolean;

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

@@ -3,8 +3,8 @@ import type { GrTreeSelectModelValue, GrTreeSelectProps } from './grTreeSelectTy
 declare const __VLS_export: <T extends Record<string, any> = any>(__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<GrTreeSelectProps<T> & {
         "onUpdate:modelValue"?: ((value: GrTreeSelectModelValue) => any) | undefined;
-        onChange?: ((value: GrTreeSelectModelValue) => any) | undefined;
         onClear?: (() => any) | undefined;
+        onChange?: ((value: GrTreeSelectModelValue) => any) | undefined;
         onNodeClick?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
         onVisibleChange?: ((visible: boolean) => any) | undefined;
     }> & (typeof globalThis extends {
@@ -37,7 +37,7 @@ declare const __VLS_export: <T extends Record<string, any> = any>(__VLS_props: N
         (e: "nodeClick", data: T, node: GrTreeNode<T>): void;
     };
 }>) => import("vue").VNode & {
-    __ctx?: Awaited<typeof __VLS_setup>;
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/types/src/components/GrTreeSelect/grTreeSelectStyles.d.ts

@@ -7,4 +7,4 @@ export declare function grTreeSelectClass(options: {
     state: GrTreeSelectState;
     invalid: boolean;
 }): string;
-export declare const grTreeSelectPanelClass = "rounded-[var(--ds-radius-xl)] border border-[var(--brd)] bg-[var(--card)] text-[var(--card-fg)] shadow-[var(--ds-shadow-2)] overflow-hidden";
+export declare const grTreeSelectPanelClass = "rounded-[var(--gr-radius-xl)] border border-[var(--brd)] bg-[var(--card)] text-[var(--card-fg)] shadow-[var(--gr-shadow-2)] overflow-hidden";

package/dist/types/src/components/GrTreeSelect/grTreeSelectTypes.d.ts

@@ -6,7 +6,7 @@ export type GrTreeSelectModelValue = GrTreeKey | GrTreeKey[] | null;
 export type GrTreeSelectValueDisplay = 'label' | 'path';
 type NodeKeyProp<T> = keyof T & string;
 /**
- * Пропсы публичного DS-примитива «TreeSelect».
+ * Пропсы публичного GR-примитива «TreeSelect».
  */
 export interface GrTreeSelectProps<T extends object = any> {
     modelValue: GrTreeSelectModelValue;

package/dist/types/src/composables/internal/useAddonMeasurement.d.ts

@@ -0,0 +1,18 @@
+import type { Ref } from 'vue';
+/**
+ * Измерение фактической ширины prefix/suffix add-on'ов через `ResizeObserver`.
+ * Общая логика GrInput/GrNumberInput (раньше дублировалась ~60 строк в каждом).
+ *
+ * Потребитель вешает возвращённые `prefixEl`/`suffixEl` на DOM-элементы аддонов
+ * и передаёт реактивные `hasPrefix`/`hasSuffix` (обычно — наличие слотов).
+ * Возвращает измеренные ширины (`"<n>px"` или `undefined`, если элемент
+ * отсутствует/скрыт/нулевой — например, в jsdom).
+ */
+export declare function useAddonMeasurement(hasPrefix: Ref<boolean>, hasSuffix: Ref<boolean>): {
+    prefixEl: Ref<HTMLElement | null, HTMLElement | null>;
+    suffixEl: Ref<HTMLElement | null, HTMLElement | null>;
+    measuredPrefixWidth: Ref<string | undefined, string | undefined>;
+    measuredSuffixWidth: Ref<string | undefined, string | undefined>;
+};
+/** Складывает две CSS-длины: числовые `px` — арифметически, иначе через `calc()`. */
+export declare function addLen(a: string, b: string): string;

package/dist/types/src/composables/internal/useEscapeToClose.d.ts

@@ -0,0 +1,11 @@
+import type { Ref } from 'vue';
+/**
+ * Пока `open` истинно, слушает `keydown` на `document` и вызывает `onEscape`
+ * по нажатию Esc; снимает слушатель при закрытии и размонтировании.
+ *
+ * Общая dismiss-логика floating-компонентов (GrSelect/GrDropdown) — раньше
+ * дублировалась (`closeOnEscape` + watch(open) + onUnmounted) в каждом.
+ * Click-outside у этих компонентов закрывается общей директивой `vClickOutside`,
+ * поэтому здесь только Esc-часть.
+ */
+export declare function useEscapeToClose(open: Ref<boolean>, onEscape: () => void): void;

package/dist/types/src/composables/internal/useScrollLock.d.ts

@@ -0,0 +1,24 @@
+/**
+ * useScrollLock — общий **reference-counted** lock скролла `<body>` для оверлеев
+ * (GrModal, GrDrawer, GrImageViewer).
+ *
+ * Зачем счётчик: раньше каждый оверлей хранил `savedBodyOverflow` per-instance и
+ * восстанавливал `overflow` при СВОЁМ закрытии. Если открыты A, затем B, и первым
+ * закрывают A — body получал `overflow: ''` при ещё открытой B (баг LIFO).
+ * Здесь состояние `<body>` сохраняется один раз (при переходе счётчика 0→1) и
+ * восстанавливается только когда закрыт последний оверлей (счётчик 1→0).
+ *
+ * Плюс компенсация ширины скроллбара: при `overflow: hidden` скроллбар исчезает и
+ * контент дёргается вправо — добавляем `padding-right` на его ширину.
+ */
+/**
+ * Возвращает пару `lock`/`unlock`, идемпотентную **в пределах одного инстанса**
+ * (повторный `lock()` без `unlock()` не увеличивает глобальный счётчик дважды).
+ * Глобальный счётчик разделяется всеми оверлеями.
+ */
+export declare function useScrollLock(): {
+    lock: () => void;
+    unlock: () => void;
+};
+/** Тестовая/служебная очистка глобального состояния. */
+export declare function resetScrollLock(): void;

package/dist/types/src/composables/useTheme.d.ts

@@ -1,8 +1,9 @@
+import type { Ref } from 'vue';
 export type ThemeName = 'light' | 'dark';
 export type UseThemeOptions = {
     /**
      * Ключ для хранения выбранной темы в localStorage.
-     * По умолчанию: `fint-ds-theme`.
+     * По умолчанию: `gr-theme`.
      */
     storageKey?: string;
     /**
@@ -13,10 +14,12 @@ export type UseThemeOptions = {
 };
 /**
  * Для применения темы максимально рано (до монтирования Vue), чтобы избежать "мигания".
+ * Также сидирует shared-синглтон, чтобы значение в `useTheme()` совпадало с уже
+ * применённым к документу.
  */
 export declare function initThemeEarly(options?: UseThemeOptions): void;
 export declare function useTheme(options?: UseThemeOptions): {
-    theme: import("vue").Ref<ThemeName, ThemeName>;
+    theme: Ref<ThemeName, ThemeName>;
     isDark: import("vue").ComputedRef<boolean>;
     setTheme: (next: ThemeName) => void;
     toggleTheme: () => void;

package/dist/types/src/composables/useToast.d.ts

@@ -1,3 +1,4 @@
+import type { App, InjectionKey } from 'vue';
 import type { GrTone } from '../components/shared/tones';
 export type GrToastTone = GrTone;
 export type ToastInput = {
@@ -15,10 +16,41 @@ export type Toast = {
     title: string;
     message?: string;
     tone: GrToastTone;
+    /** Исходный таймаут автозакрытия, мс (`0` — без автозакрытия). Нужен для progress-бара. */
+    timeoutMs: number;
+};
+type ToastTimer = {
+    handle: number | null;
+    /** Сколько мс осталось до автозакрытия на момент последней паузы/старта. */
+    remaining: number;
+    /** `performance.now()` момента запуска текущего отрезка (для вычисления остатка). */
+    startedAt: number;
+};
+export type ToastState = {
+    toasts: Toast[];
+    timers: Map<string, ToastTimer>;
+};
+/** Ключ provide/inject для app-scoped состояния тостов (устанавливает плагин ниже). */
+export declare const GRANULARITY_TOAST_STATE: InjectionKey<ToastState>;
+/**
+ * Vue-плагин: даёт каждому приложению собственное изолированное состояние тостов
+ * через `app.provide`. Обязателен для (а) нескольких Vue-приложений на одной
+ * странице (микрофронтенды — иначе делят один стек тостов) и (б) SSR (иначе
+ * модульное состояние течёт между запросами).
+ *
+ * ```ts
+ * app.use(granularityToastPlugin)
+ * ```
+ */
+export declare const granularityToastPlugin: {
+    install(app: App): void;
 };
 export declare function useToast(): {
-    list: import("vue").ComputedRef<import("vue").Reactive<Toast[]>>;
+    list: import("vue").ComputedRef<Toast[]>;
     push: (input: ToastInput) => string;
     dismiss: (id: string) => void;
     clear: () => void;
+    pause: (id: string) => void;
+    resume: (id: string) => void;
 };
+export {};

package/dist/types/src/directives/hotkey.d.ts

@@ -10,9 +10,17 @@ export type HotkeyEntry = HotkeyHandler | {
     allowInEditable?: boolean;
 };
 export type HotkeyMap = Record<string, HotkeyEntry>;
+/**
+ * Где слушать клавиатуру:
+ * - `'global'` (по умолчанию) — слушатель на `window`; хоткеи работают из любого места страницы.
+ * - `'element'` — слушатель на самом элементе; хоткеи срабатывают только когда фокус внутри
+ *   элемента (событие всплывает до него). Элемент должен быть фокусируемым (`tabindex`).
+ */
+export type HotkeyScope = 'global' | 'element';
 export type HotkeyBindingValue = HotkeyMap | {
     handlers: HotkeyMap;
     enabled?: boolean;
+    scope?: HotkeyScope;
 };
 /**
  * `v-hotkey` — горячие клавиши на компонент/страницу.
@@ -21,5 +29,11 @@ export type HotkeyBindingValue = HotkeyMap | {
  * ```vue
  * <div v-hotkey="{ 'Escape': close, 'Ctrl+K': openSearch }" />
  * ```
+ *
+ * По умолчанию слушатель глобальный (`window`). Чтобы хоткеи срабатывали только
+ * когда фокус внутри элемента, используйте `scope: 'element'`:
+ * ```vue
+ * <div tabindex="0" v-hotkey="{ handlers: { 'j': next }, scope: 'element' }" />
+ * ```
  */
 export declare const vHotkey: Directive<HTMLElement, HotkeyBindingValue>;

package/dist/types/src/granular-provider/shared.d.ts

@@ -18,9 +18,6 @@ export declare const granularityDefaultThemes: readonly GranularityThemeName[];
  * остаётся здесь, а node‑вариант подставляется снаружи через
  * `createGranularityProvider(overrides)` — см. `./index.ts` (browser)
  * и `./node.ts` (node).
- *
- * Формат записи `<Name>: ds<Name>Config` критичен для regex‑парсинга
- * в `apps/showcase/scripts/generate-component-api.mjs`, не ломайте его.
  */
 export declare const granularityComponentConfigs: {
     GrAlert: GranularComponentDescriptor<"GrAlert">;
@@ -36,6 +33,8 @@ export declare const granularityComponentConfigs: {
     GrConfirmDialog: GranularComponentDescriptor<"GrConfirmDialog">;
     GrDataTable: GranularComponentDescriptor<"GrDataTable">;
     GrDialog: GranularComponentDescriptor<"GrDialog">;
+    GrDialogService: GranularComponentDescriptor<"GrDialogServiceHost">;
+    GrDivider: GranularComponentDescriptor<"GrDivider">;
     GrDrawer: GranularComponentDescriptor<"GrDrawer">;
     GrDropdown: GranularComponentDescriptor<"GrDropdown">;
     GrDropdownMenu: GranularComponentDescriptor<"GrDropdownMenu">;
@@ -48,6 +47,7 @@ export declare const granularityComponentConfigs: {
     GrImageViewer: GranularComponentDescriptor<"GrImageViewer">;
     GrInput: GranularComponentDescriptor<"GrInput">;
     GrInputTag: GranularComponentDescriptor<"GrInputTag">;
+    GrKbd: GranularComponentDescriptor<"GrKbd">;
     GrLink: GranularComponentDescriptor<"GrLink">;
     GrList: GranularComponentDescriptor<"GrList">;
     GrLoading: GranularComponentDescriptor<"GrLoading">;
@@ -66,6 +66,7 @@ export declare const granularityComponentConfigs: {
     GrSkeleton: GranularComponentDescriptor<"GrSkeleton">;
     GrSwitch: GranularComponentDescriptor<"GrSwitch">;
     GrTable: GranularComponentDescriptor<"GrTable">;
+    GrTabPanels: GranularComponentDescriptor<"GrTabPanels">;
     GrTabs: GranularComponentDescriptor<"GrTabs">;
     GrTextarea: GranularComponentDescriptor<"GrTextarea">;
     GrToaster: GranularComponentDescriptor<"GrToaster">;