@feugene/granularity 0.12.0 → 0.16.0

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

@@ -1,4 +1,6 @@
-export type GrListItemDensity = 'compact' | 'regular';
+import { type Component } from 'vue';
+import { type GrListItemDensity } from './grListStyles';
+export type { GrListItemDensity } from './grListStyles';
 export interface GrListItemProps {
     /** Заголовок строки. Если передан слот `#title`, проп игнорируется. */
     title?: string;
@@ -6,29 +8,60 @@ export interface GrListItemProps {
     description?: string;
     /** Плотность вертикальных отступов: `regular` — 12px, `compact` — 8px. */
     density?: GrListItemDensity;
+    /** Ссылка: строка становится `<a>`. */
+    href?: string;
+    /** Свой корневой тег строки (`RouterLink`, `Link` от Inertia). Сильнее `href`. */
+    as?: string | Component;
+    /** Кликабельная строка без ссылки — `<button>` с событием `click`. */
+    clickable?: boolean;
+    /** Подсветка при наведении без интерактивности. */
+    hoverable?: boolean;
+    disabled?: boolean;
 }
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {};
+export interface GrListItemEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+declare var __VLS_9: {}, __VLS_11: {}, __VLS_13: {}, __VLS_15: {};
 type __VLS_Slots = {} & {
-    prefix?: (props: typeof __VLS_1) => any;
+    prefix?: (props: typeof __VLS_9) => any;
 } & {
-    title?: (props: typeof __VLS_3) => any;
+    title?: (props: typeof __VLS_11) => any;
 } & {
-    description?: (props: typeof __VLS_5) => any;
+    description?: (props: typeof __VLS_13) => any;
 } & {
-    default?: (props: typeof __VLS_7) => any;
+    default?: (props: typeof __VLS_15) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListItemProps>, {
     title: undefined;
     description: undefined;
     density: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListItemProps>, {
+    href: undefined;
+    as: undefined;
+    clickable: boolean;
+    hoverable: boolean;
+    disabled: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrListItemProps>, {
     title: undefined;
     description: undefined;
     density: string;
-}>>> & Readonly<{}>, {
+    href: undefined;
+    as: undefined;
+    clickable: boolean;
+    hoverable: boolean;
+    disabled: boolean;
+}>>> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    density: GrListItemDensity;
     title: string;
     description: string;
-    density: GrListItemDensity;
+    href: string;
+    disabled: boolean;
+    as: string | Component;
+    clickable: boolean;
+    hoverable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

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

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

@@ -0,0 +1,25 @@
+export type GrListItemDensity = 'compact' | 'regular';
+/**
+ * Классы `GrList`/`GrListItem`.
+ *
+ * Единственный источник правды для шаблонов и safelist: до этого карта
+ * плотности жила в SFC, а её копия — строковыми литералами прямо в `config.ts`,
+ * и разойтись они могли молча.
+ */
+export declare const densityPadding: Record<GrListItemDensity, string>;
+export declare const itemLayoutClass = "flex items-start justify-between gap-4";
+/** Интерактивная строка занимает всю ширину пункта — кликабельна вся, а не текст. */
+export declare const itemInteractiveClass = "w-full text-left transition-colors duration-[var(--gr-duration-fast)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)] focus-visible:ring-inset";
+export declare const itemHoverClass = "cursor-pointer hover:bg-[var(--gr-muted)]";
+/**
+ * Заблокированная строка гасится фоном и цветом, а не `opacity`: прозрачность
+ * разбавляет выверенные на AA токены текста.
+ */
+export declare const itemDisabledClass = "cursor-not-allowed bg-[var(--gr-muted)] text-[var(--gr-muted-fg)]";
+export declare const dividedClass = "divide-y divide-[var(--gr-brd)]";
+export declare const emptyClass = "px-4 py-6 text-center text-[length:var(--gr-text-sm)] text-[var(--gr-muted-fg)]";
+/** Заголовок и описание строки. Оба нужны обеим веткам пункта — интерактивной и обычной. */
+export declare const itemTitleClass = "text-[length:var(--gr-text-sm)] font-700";
+export declare const itemDescriptionClass = "mt-0.5 text-[length:var(--gr-text-sm)] text-[var(--gr-muted-fg)]";
+export declare const loadingRowClass = "px-4 py-3";
+export declare function grListItemPaddingClass(density: GrListItemDensity): string;

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

@@ -1,6 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrListComponent from './GrList.vue';
 export { default } from './GrList.vue';
 export { default as GrList } from './GrList.vue';
 export type { GrListProps } from './GrList.vue';
 export { default as GrListItem } from './GrListItem.vue';
 export type { GrListItemDensity, GrListItemProps } from './GrListItem.vue';
 export { grListConfig } from './config';
+export { grListSafelist } from './safelist';
+export type GrListInstance = ComponentExposed<typeof GrListComponent>;
+export type { GrListItemEmits } from './GrListItem.vue';

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

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

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

@@ -1,55 +1,90 @@
 import { type Component } from 'vue';
+import type { GrIconSize, GrIconTone } from '../GrIcon/grIconStyles';
 /**
- * Props for {@link GrLoading}.
- * Overlay primitive that renders a centered spinner with optional text above sibling content.
- * Use `fullscreen` to cover the whole viewport, otherwise overlays the nearest positioned ancestor.
+ * Пропы {@link GrLoading}.
+ *
+ * Оверлей загрузки: спиннер с подписью поверх соседнего контента. `fullscreen`
+ * накрывает весь экран, иначе оверлей ложится на ближайшего позиционированного
+ * предка.
  */
 export interface GrLoadingProps {
-    /** Text under the spinner. Pass an empty string to hide the text entirely. Defaults to `'Loading...'`. */
+    /** Подпись под спиннером. Пустая строка убирает её совсем. По умолчанию — из локали. */
     text?: string;
-    /** Custom spinner component (rendered instead of the default loader icon). */
+    /** Свой компонент спиннера вместо иконки по умолчанию. */
     spinner?: Component;
-    /** Extra classes for the spinner element. */
+    /** Дополнительные классы обёртки спиннера. */
     spinnerClass?: string;
-    /** When `true` (default), the default spinner rotates via `@keyframes gr-loading-spin`. */
+    /** Размер спиннера: шкала пакета либо произвольный в пикселях. */
+    spinnerSize?: GrIconSize | number;
+    /** Тон спиннера из палитры. */
+    spinnerTone?: GrIconTone;
+    /** Вращение спиннера. По умолчанию включено. */
     animated?: boolean;
-    /** Custom CSS `background-color`. When set, disables the default `bg-black/25` dim. */
+    /** Свой `background-color`. Задан — дефолтный скрим `--gr-overlay-bg` снимается. */
     background?: string;
-    /** Cover the whole viewport (`position: fixed`) instead of the nearest positioned ancestor. */
+    /** Накрыть весь экран (`position: fixed`) вместо ближайшего позиционированного предка. */
     fullscreen?: boolean;
-    /** Custom `z-index`. */
-    zIndex?: number;
-    /** Extra classes appended to the overlay root. */
+    /** Имя CSS-переменной слоя — escape-hatch мимо `--gr-z-loading`. */
+    zIndexVar?: string;
+    /** Задержка показа в миллисекундах: короткая загрузка не мигает оверлеем. */
+    delay?: number;
+    /** Дополнительные классы корня оверлея. */
     customClass?: string;
 }
-declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
+export interface GrLoadingEmits {
+    /**
+     * Оверлей появился на экране — сразу или по истечении `delay`. По этому
+     * событию директива блокирует контент под оверлеем: до показа блокировать
+     * нечего, иначе быстрый запрос молча «замораживал» бы форму.
+     */
+    (e: 'show'): void;
+}
+type __VLS_Slots = {
+    /** Содержимое панели целиком вместо спиннера с подписью. */
+    default?: () => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
     text: undefined;
     spinner: undefined;
     spinnerClass: undefined;
+    spinnerSize: number;
+    spinnerTone: string;
     animated: boolean;
     background: undefined;
     fullscreen: boolean;
-    zIndex: undefined;
+    zIndexVar: undefined;
+    delay: number;
     customClass: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    show: () => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrLoadingProps>, {
     text: undefined;
     spinner: undefined;
     spinnerClass: undefined;
+    spinnerSize: number;
+    spinnerTone: string;
     animated: boolean;
     background: undefined;
     fullscreen: boolean;
-    zIndex: undefined;
+    zIndexVar: undefined;
+    delay: number;
     customClass: undefined;
-}>>> & Readonly<{}>, {
+}>>> & Readonly<{
+    onShow?: (() => any) | undefined;
+}>, {
     text: string;
     background: string;
+    fullscreen: boolean;
     spinner: Component;
     spinnerClass: string;
+    spinnerSize: GrIconSize | number;
+    spinnerTone: GrIconTone;
     animated: boolean;
-    fullscreen: boolean;
-    zIndex: number;
+    zIndexVar: string;
+    delay: number;
     customClass: 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> = {
@@ -65,6 +100,11 @@ type __VLS_WithDefaults<P, D> = {
         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];
 } : {

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

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

package/dist/types/src/components/GrLoading/grLoadingStyles.d.ts

@@ -1,11 +1,19 @@
+/**
+ * Полноэкранный оверлей сидит на собственном слое шкалы: он блокирует всё
+ * приложение целиком, поэтому обязан лечь выше модалки (`--gr-z-modal`), но
+ * ниже тоста — уведомление о фоновой ошибке загрузка прятать не должна.
+ * Инлайновый режим к шкале отношения не имеет: `z-10` — порядок внутри
+ * собственного контейнера.
+ */
 export declare const rootModeClass: {
-    readonly fullscreen: "fixed inset-0 z-50";
+    readonly fullscreen: "fixed inset-0 z-[var(--gr-z-loading)]";
     readonly inline: "absolute inset-0 z-10";
 };
-export declare const rootBackgroundClass = "bg-black/25";
+export declare const rootBackgroundClass = "bg-[var(--gr-overlay-bg)]";
 export declare const rootBackdropBlurClass = "backdrop-blur-sm";
 export declare function grLoadingRootClass(options: {
     fullscreen: boolean;
     hasBackground: boolean;
     customClass?: string;
 }): string;
+export declare const grLoadingClassTokens: string[];

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

@@ -3,3 +3,4 @@ export { default as GrLoading } from './GrLoading.vue';
 export { grLoadingConfig } from './config';
 export { grLoadingSafelist } from './safelist';
 export type { GrLoadingProps } from './GrLoading.vue';
+export type { GrLoadingEmits } from './GrLoading.vue';

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

@@ -1,34 +1,80 @@
-import { type GrModalSize } from './grModalStyles';
+import { type GrModalScrollBehavior, type GrModalSize } from './grModalStyles';
+export type { GrModalScrollBehavior };
 export interface GrModalProps {
     modelValue: boolean;
     closeOnBackdrop?: boolean;
     closeOnEsc?: boolean;
     size?: GrModalSize;
+    /**
+     * Кто скроллится при длинном содержимом: весь оверлей (`outside`) или сама
+     * панель (`inside` — окно остаётся на месте, шапка и подвал на виду).
+     */
+    scrollBehavior?: GrModalScrollBehavior;
+    /**
+     * Доступное имя окна, когда заголовка в слоте `#title` нет. Слот сильнее:
+     * при нём имя даёт `aria-labelledby`.
+     */
+    ariaLabel?: string;
+    /**
+     * Элемент, получающий фокус при открытии. По умолчанию — сама панель: она
+     * фокусируема программно (`tabindex="-1"`), диктор объявляет окно целиком, а
+     * первый Tab приводит в начало содержимого.
+     */
+    initialFocus?: HTMLElement | null;
 }
-declare var __VLS_49: {}, __VLS_57: {}, __VLS_59: {};
-type __VLS_Slots = {} & {
-    title?: (props: typeof __VLS_49) => any;
-} & {
-    description?: (props: typeof __VLS_57) => any;
-} & {
-    default?: (props: typeof __VLS_59) => any;
+export interface GrModalEmits {
+    (e: 'update:modelValue', value: boolean): void;
+    /** Окно открылось и анимация закончилась. */
+    (e: 'opened'): void;
+    /** Окно закрылось и анимация закончилась — содержимое можно размонтировать. */
+    (e: 'closed'): void;
+}
+import './defaults';
+type __VLS_Slots = {
+    default?: () => any;
+    title?: () => any;
+    description?: () => any;
+    /** Закреплённая шапка: при `inside` остаётся на месте, скроллится только тело. */
+    header?: () => any;
+    /** Закреплённый подвал: там же, где и шапка, — вне скроллящегося тела. */
+    footer?: () => any;
 };
+declare function open(): void;
+declare function close(): void;
+declare function toggle(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrModalProps>, {
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
-    size: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    size: undefined;
+    scrollBehavior: string;
+    ariaLabel: undefined;
+    initialFocus: null;
+}>>, {
+    open: typeof open;
+    close: typeof close;
+    toggle: typeof toggle;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: boolean) => void;
+    opened: () => void;
+    closed: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrModalProps>, {
     closeOnBackdrop: boolean;
     closeOnEsc: boolean;
-    size: string;
+    size: undefined;
+    scrollBehavior: string;
+    ariaLabel: undefined;
+    initialFocus: null;
 }>>> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onOpened?: (() => any) | undefined;
+    onClosed?: (() => any) | undefined;
 }>, {
     size: GrModalSize;
-    closeOnBackdrop: boolean;
+    scrollBehavior: GrModalScrollBehavior;
+    ariaLabel: string;
+    initialFocus: HTMLElement | null;
     closeOnEsc: boolean;
+    closeOnBackdrop: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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

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

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

@@ -0,0 +1,37 @@
+import type { InjectionKey } from 'vue';
+export interface GrModalContext {
+    /** Id, который обязан оказаться на элементе заголовка окна. */
+    titleId: string;
+    /** Id, который обязан оказаться на элементе описания окна. */
+    descriptionId: string;
+    /** «Заголовок отрисован» — окно ставит `aria-labelledby`. Возвращает отказ от заявки. */
+    claimTitle: () => () => void;
+    /** То же для описания и `aria-describedby`. */
+    claimDescription: () => () => void;
+}
+export declare const GR_MODAL_CONTEXT_KEY: InjectionKey<GrModalContext>;
+export declare function provideGrModalContext(context: GrModalContext): void;
+/**
+ * Контекст окна для его частей.
+ *
+ * Именно контекст, а не проп: заголовок рисует `GrDialogHeader` — внук
+ * `GrModal` через слот, — а `aria-labelledby` стоит на корне окна.
+ *
+ * **Id принадлежит окну, а не заголовку.** Заголовок только сообщает, что
+ * отрисовался. Обратный порядок (id рождается у потомка и уезжает наверх)
+ * означает мутацию состояния окна во время его собственного патча: Vue уходит
+ * в рекурсивный ре-рендер и монтирует заголовок заново, пока не упрётся в
+ * лимит. Стабильный id этого класса ошибок не допускает по построению.
+ *
+ * `null` вне окна — законное состояние: `GrDialogHeader` используют и отдельно.
+ */
+export declare function useGrModalContext(): GrModalContext | null;
+/**
+ * Объявляет элемент заголовком окна, пока `active` истинно.
+ *
+ * Возвращает id для элемента — или `undefined` вне окна: тогда заголовок просто
+ * рисуется без связи.
+ */
+export declare function useGrModalTitle(active: () => boolean): {
+    titleId: string | undefined;
+};

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

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

package/dist/types/src/components/GrModal/grModalStyles.d.ts

@@ -1,26 +1,41 @@
-export type GrModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+import type { GrOverlaySize } from '../shared/sizes';
+export type GrModalSize = GrOverlaySize;
+/**
+ * Кто скроллится при длинном содержимом: весь оверлей (`outside`, окно уезжает
+ * вверх вместе со страницей) или сама панель (`inside`, окно остаётся на месте,
+ * а шапка и подвал `GrDialog` — на виду).
+ */
+export type GrModalScrollBehavior = 'outside' | 'inside';
 export declare const root = "fixed inset-0 z-[var(--gr-z-modal)]";
-export declare const shell = "fixed inset-0 overflow-y-auto p-4 sm:p-6";
-export declare const layout = "min-h-full flex items-center justify-center";
-export declare const overlay = "fixed inset-0 z-0 bg-black/40";
+export declare const overlay = "fixed inset-0 z-0 bg-[var(--gr-overlay-bg)]";
+export declare const shellBase = "fixed inset-0";
+export declare const shellPaddingBySize: Record<GrModalSize, string>;
+export declare const shellByScroll: Record<GrModalScrollBehavior, string>;
+export declare const layoutByScroll: Record<GrModalScrollBehavior, string>;
 export declare const overlayTransition: {
-    readonly enter: "duration-200 ease-out";
+    readonly enter: "duration-[var(--gr-duration-base)] ease-[var(--gr-ease-out)]";
     readonly enterFrom: "opacity-0";
     readonly enterTo: "opacity-100";
-    readonly leave: "duration-150 ease-in";
+    readonly leave: "duration-[var(--gr-duration-fast)] ease-[var(--gr-ease-in)]";
     readonly leaveFrom: "opacity-100";
     readonly leaveTo: "opacity-0";
 };
 export declare const panelTransition: {
-    readonly enter: "duration-200 ease-out";
+    readonly enter: "duration-[var(--gr-duration-base)] ease-[var(--gr-ease-out)]";
     readonly enterFrom: "opacity-0 translate-y-2 sm:translate-y-0 sm:scale-95";
     readonly enterTo: "opacity-100 translate-y-0 sm:scale-100";
-    readonly leave: "duration-150 ease-in";
+    readonly leave: "duration-[var(--gr-duration-fast)] ease-[var(--gr-ease-in)]";
     readonly leaveFrom: "opacity-100 translate-y-0 sm:scale-100";
     readonly leaveTo: "opacity-0 translate-y-2 sm:translate-y-0 sm:scale-95";
 };
-export declare const panelBase = "w-full overflow-hidden relative z-10 border border-[var(--brd)] bg-[var(--card)] text-[var(--card-fg)] shadow-[var(--gr-shadow-2)] outline-none";
+export declare const panelBase = "w-full relative z-10 border border-[var(--gr-brd)] bg-[var(--gr-card)] text-[var(--gr-card-fg)] shadow-[var(--gr-shadow-2)] outline-none";
+export declare const panelOverflowByScroll: Record<GrModalScrollBehavior, string>;
+/** Тело окна при `inside`. `min-h-0` — иначе flex-потомок не даст себя сжать. */
+export declare const panelBodyScrollClass = "min-h-0 overflow-y-auto";
+/** Шапка и подвал при `inside`: сжиматься должно тело, а не они. */
+export declare const panelSectionClass = "shrink-0";
 export declare const panelWidthBySize: Record<GrModalSize, string>;
 export declare const panelRadiusBySize: Record<GrModalSize, string>;
 export declare const panelHeightBySize: Partial<Record<GrModalSize, string>>;
-export declare function getGrModalPanelClass(size: GrModalSize): string;
+export declare function getGrModalPanelClass(size: GrModalSize, scrollBehavior?: GrModalScrollBehavior): string;
+export declare function getGrModalShellClass(size: GrModalSize, scrollBehavior: GrModalScrollBehavior): string;

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

@@ -1,7 +1,10 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrModalComponent from './GrModal.vue';
 export { default } from './GrModal.vue';
 export { default as GrModal } from './GrModal.vue';
 export type { GrModalProps } from './GrModal.vue';
 export { grModalConfig } from './config';
-export type { GrModalSize } from './grModalStyles';
-export { getGrModalPanelClass } from './grModalStyles';
-export { grModalClassTokens, grModalSafelist } from './safelist';
+export type { GrModalScrollBehavior, GrModalSize } from './grModalStyles';
+export { grModalSafelist } from './safelist';
+export type { GrModalEmits } from './GrModal.vue';
+export type GrModalInstance = ComponentExposed<typeof GrModalComponent>;

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

@@ -1,34 +1,53 @@
 /**
- * GrNavbar — верхняя панель приложения (header) с заголовком,
- * опциональной кнопкой меню (обычно — для мобильных) и правым слотом
- * для действий/аватара.
+ * GrNavbar — верхняя панель приложения (header) с тремя зонами: слева заголовок
+ * и кнопка меню, по центру — свободная зона (поиск, хлебные крошки), справа —
+ * действия и аватар.
  *
  * - Корень — `<header>` (landmark), без собственного `role`.
  * - `aria-label` кнопки меню локализуется через `useGranularityTranslations`.
  */
 export interface GrNavbarProps {
-    title: string;
+    /** Заголовок строкой. Слот `#title` сильнее и позволяет обойтись без пропа. */
+    title?: string;
     showMenuButton?: boolean;
     /** Extra classes applied to the menu button wrapper (e.g. `sm:hidden`). */
     menuButtonClass?: string;
+    /**
+     * Панель прилипает к верху при прокрутке. Слой — `--gr-z-navbar`: он ниже
+     * якорных панелей, чтобы открытый список не уезжал под шапку.
+     */
+    sticky?: boolean;
+}
+export interface GrNavbarEmits {
+    (e: 'menu'): void;
 }
-declare var __VLS_20: {}, __VLS_22: {};
-type __VLS_Slots = {} & {
-    title?: (props: typeof __VLS_20) => any;
-} & {
-    default?: (props: typeof __VLS_22) => any;
+type __VLS_Slots = {
+    /** Заголовок целиком — вместо строки `title`. */
+    title?: () => unknown;
+    /** Зона сразу после заголовка: вкладки, переключатель раздела. */
+    left?: () => unknown;
+    /** Центральная зона: поиск, хлебные крошки. */
+    center?: () => unknown;
+    /** Правая зона: действия, аватар. */
+    default?: () => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrNavbarProps>, {
+    title: undefined;
     showMenuButton: boolean;
     menuButtonClass: string;
+    sticky: boolean;
 }>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     menu: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrNavbarProps>, {
+    title: undefined;
     showMenuButton: boolean;
     menuButtonClass: string;
+    sticky: boolean;
 }>>> & Readonly<{
     onMenu?: (() => any) | undefined;
 }>, {
+    title: string;
+    sticky: boolean;
     showMenuButton: boolean;
     menuButtonClass: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

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

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

package/dist/types/src/components/GrNavbar/grNavbarStyles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Кастомизация через CSS-переменные:
+ *
+ * - `--gr-navbar-height` — высота панели (по умолчанию `56px`).
+ */
+export declare const navbarBaseClass = "h-[var(--gr-navbar-height,56px)] border-b border-[var(--gr-brd)] bg-[var(--gr-bg)] flex items-center gap-4 px-4 sm:px-6";
+/**
+ * Прилипшая шапка идёт слоем ниже якорных панелей: она обязана перекрывать
+ * контент, но не выпадашки, тултипы и модалки — иначе открытый список уезжал бы
+ * под неё.
+ */
+export declare const navbarStickyClass = "sticky top-0 z-[var(--gr-z-navbar)]";
+export declare const navbarSideClass = "flex min-w-0 items-center gap-3";
+/**
+ * Центрировать содержимое относительно панели можно только когда боковые зоны
+ * делят остаток поровну: у центра с одним `flex-1` середина считается от
+ * остатка, а не от панели, и уезжает вслед за более широким боком.
+ */
+export declare const navbarSideGrowClass = "flex-1";
+export declare const navbarRightAlignClass = "justify-end";
+export declare const navbarCenterClass = "flex min-w-0 flex-1 items-center justify-center gap-3";
+export declare const navbarTitleClass = "text-[length:var(--gr-text-sm)] font-700";
+export declare function grNavbarRootClass(sticky: boolean): string;

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

@@ -2,3 +2,5 @@ export { default } from './GrNavbar.vue';
 export { default as GrNavbar } from './GrNavbar.vue';
 export type { GrNavbarProps } from './GrNavbar.vue';
 export { grNavbarConfig } from './config';
+export { grNavbarSafelist } from './safelist';
+export type { GrNavbarEmits } from './GrNavbar.vue';

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

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