@feugene/granularity 0.9.4 → 0.11.0

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

@@ -1,7 +1,7 @@
 import { type GrSelectModelValue, type GrSelectOption, type GrSelectOptionOrGroup, type GrSelectOptionsView, type GrSelectSize, type GrSelectUnderline, type GrSelectVariant, type GrSelectView } from './grSelectStyles';
 export type { GrSelectModelValue, GrSelectOption, GrSelectOptionGroup, GrSelectOptionOrGroup, GrSelectOptionsView, GrSelectSize, GrSelectUnderline, GrSelectVariant, GrSelectView, } from './grSelectStyles';
 /**
- * Пропсы публичного DS-примитива «Select».
+ * Пропсы публичного GR-примитива «Select».
  */
 export interface GrSelectProps {
     modelValue: GrSelectModelValue;
@@ -19,7 +19,7 @@ export interface GrSelectProps {
     optionsView?: GrSelectOptionsView;
     /** Разрешает ввод/выбор значения, которого нет в `options`. */
     allowCustomValue?: boolean;
-    /** Placeholder для инпута кастомного значения (только в `optionsView="panel"`). */
+    /** Placeholder для инпута кастомного значения (только в `optionsView="panel"`). i18n-friendly: если не задан — берётся из адаптера перевода (`gr.select.customValuePlaceholder`), иначе — встроенный fallback. */
     customValuePlaceholder?: string;
     /** Максимальная высота панели (только в `optionsView="panel"`). */
     dropdownMaxHeight?: number;
@@ -67,11 +67,11 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     multiple: boolean;
     optionsView: string;
     allowCustomValue: boolean;
-    customValuePlaceholder: string;
+    customValuePlaceholder: undefined;
     dropdownMaxHeight: number;
     closeOnSelect: boolean;
     clearable: boolean;
-    clearLabel: string;
+    clearLabel: undefined;
     variant: string;
     underline: string;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
@@ -86,11 +86,11 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     multiple: boolean;
     optionsView: string;
     allowCustomValue: boolean;
-    customValuePlaceholder: string;
+    customValuePlaceholder: undefined;
     dropdownMaxHeight: number;
     closeOnSelect: boolean;
     clearable: boolean;
-    clearLabel: string;
+    clearLabel: undefined;
     variant: string;
     underline: string;
 }>>> & Readonly<{
@@ -103,8 +103,8 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     ariaLabel: string;
     placeholder: string;
     options: GrSelectOptionOrGroup[];
-    multiple: boolean;
     underline: GrSelectUnderline;
+    multiple: boolean;
     optionsView: GrSelectOptionsView;
     allowCustomValue: boolean;
     customValuePlaceholder: string;

package/dist/types/src/components/GrSelect/grSelectStyles.d.ts

@@ -6,6 +6,7 @@ export type GrSelectOptionsView = 'native' | 'panel';
 export type GrSelectOption = {
     value: string;
     label: string;
+    disabled?: boolean;
 };
 /** Группа опций: заголовок `label` + вложенные опции `options`. */
 export type GrSelectOptionGroup = {
@@ -66,4 +67,4 @@ export declare function grSelectTriggerClass(options: {
     variant: GrSelectVariant;
     underline: GrSelectUnderline;
 }): string;
-export declare const grSelectPanelClasses = "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 grSelectPanelClasses = "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/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/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/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/useFloating.d.ts

@@ -0,0 +1,53 @@
+import type { CSSProperties, Ref } from 'vue';
+import type { Placement } from '@floating-ui/dom';
+export type UseFloatingPlacement = Placement;
+export interface UseFloatingOptions {
+    /**
+     * Предпочитаемое место панели относительно триггера. По умолчанию `bottom-start`.
+     * Можно передать функцию-геттер, если место зависит от реактивного пропа
+     * (например, `align`) — она вызывается заново при каждом пересчёте позиции.
+     */
+    placement?: UseFloatingPlacement | (() => UseFloatingPlacement);
+    /** Зазор между триггером и панелью, px. По умолчанию `8`. */
+    offsetPx?: number;
+    /** Минимальный отступ от края viewport при flip/shift, px. По умолчанию `8`. */
+    boundaryPadding?: number;
+    /**
+     * Согласовать ширину панели с шириной триггера (актуально для Select/TreeSelect).
+     * Не годится для Dropdown/Tooltip, где ширина панели определяется контентом.
+     * - `true` — точная ширина (`width = ширина триггера`);
+     * - `'min'` — панель растёт по контенту (`width: max-content`), но не уже триггера
+     *   (`min-width = ширина триггера`) — режим `GrSelect view="link"`;
+     * - функция-геттер — как и `placement`, для реактивной зависимости от пропа.
+     */
+    matchWidth?: boolean | 'min' | (() => boolean | 'min');
+    /** CSS-переменная шкалы слоёв (см. `styles/tokens.css`). По умолчанию `--gr-z-dropdown`. */
+    zIndexVar?: string;
+}
+export interface UseFloatingReturn {
+    /** Готовый объект для `:style` на плавающем элементе. */
+    floatingStyle: Ref<CSSProperties>;
+    /**
+     * Итоговое место панели ПОСЛЕ применения `flip` — может отличаться от запрошенного
+     * `placement`, если места не хватило и панель перевернуло на противоположную сторону.
+     * Полезно для выбора `transform-origin`/направления transition в потребителе.
+     */
+    resolvedPlacement: Ref<Placement>;
+    /** Принудительный пересчёт позиции (например, после изменения контента панели). */
+    update: () => void;
+}
+/**
+ * Единый движок позиционирования floating-панелей (Dropdown/Select/TreeSelect/Tooltip)
+ * поверх `@floating-ui/dom`: flip (переворот при нехватке места), shift (клэмп к границам
+ * viewport), опциональный `size`-мидлвар для растягивания по ширине триггера.
+ *
+ * Пересчёт положения при скролле/ресайзе делает `autoUpdate` из `@floating-ui/dom` —
+ * он сам использует `ResizeObserver`/`IntersectionObserver` и пассивные слушатели вместо
+ * наивного враппера на каждый `scroll`/`resize`, поэтому отдельный rAF-throttling здесь
+ * не нужен (в отличие от прежней ручной реализации в `GrSelect`/`GrDropdown`).
+ *
+ * Требует, чтобы `floatingEl` был примонтирован в DOM на момент открытия (обычно —
+ * `<teleport to="body">` + `v-show`, а не `v-if`): позиционирование не может измерить
+ * элемент, которого нет в дереве.
+ */
+export declare function useFloating(referenceEl: Ref<HTMLElement | null>, floatingEl: Ref<HTMLElement | null>, open: Ref<boolean>, options?: UseFloatingOptions): UseFloatingReturn;

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,7 @@ export declare const granularityComponentConfigs: {
     GrConfirmDialog: GranularComponentDescriptor<"GrConfirmDialog">;
     GrDataTable: GranularComponentDescriptor<"GrDataTable">;
     GrDialog: GranularComponentDescriptor<"GrDialog">;
+    GrDialogService: GranularComponentDescriptor<"GrDialogServiceHost">;
     GrDrawer: GranularComponentDescriptor<"GrDrawer">;
     GrDropdown: GranularComponentDescriptor<"GrDropdown">;
     GrDropdownMenu: GranularComponentDescriptor<"GrDropdownMenu">;