@feugene/granularity 0.13.0 → 0.16.0

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

@@ -1,6 +1,11 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrTextareaComponent from './GrTextarea.vue';
 export { default } from './GrTextarea.vue';
 export { default as GrTextarea } from './GrTextarea.vue';
 export type { GrTextareaProps } from './GrTextarea.vue';
 export { grTextareaConfig } from './config';
-export type { GrTextareaState } from './grTextareaStyles';
+export type { GrTextareaConfigurableProps } from './defaults';
+export type { GrTextareaSize, GrTextareaState } from './grTextareaStyles';
 export { grTextareaSafelist } from './safelist';
+export type { GrTextareaEmits } from './GrTextarea.vue';
+export type GrTextareaInstance = ComponentExposed<typeof GrTextareaComponent>;

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

@@ -0,0 +1,70 @@
+import { type GrTimelineHeadingLevel } from './grTimelineContext';
+import { type GrTimelineDensity, type GrTimelineLayout, type GrTimelineOrientation } from './grTimelineStyles';
+import { type GrTimelineGroupBy } from './timelineGroups';
+export type { GrTimelineDensity, GrTimelineLayout, GrTimelineOrientation, } from './grTimelineStyles';
+export type { GrTimelineGroupBy } from './timelineGroups';
+export interface GrTimelineProps<TItem = unknown> {
+    /**
+     * Данные ленты. С ними пункты рисует слот `#item` — и только так лента знает
+     * состав набора, то есть может его группировать.
+     */
+    items?: TItem[];
+    /** Ключ пункта для `v-for`: имя поля или функция. Без него — индекс. */
+    itemKey?: string | ((item: TItem, index: number) => string | number);
+    /** Группировка: имя поля или функция от пункта. Заголовок группы — слот `#group`. */
+    groupBy?: GrTimelineGroupBy<TItem>;
+    /** Уровень заголовка группы: лента обязана вписаться в структуру заголовков страницы. */
+    groupHeadingLevel?: GrTimelineHeadingLevel;
+    /** Раскладка: одна ось, колонка времени слева или чередование сторон. */
+    layout?: GrTimelineLayout;
+    /** Направление оси. Горизонтальная лента — скроллер. */
+    orientation?: GrTimelineOrientation;
+    /** Плотность вертикальных отступов пункта. */
+    density?: GrTimelineDensity;
+    /** Идёт загрузка: вместо пунктов — заглушки, контейнер помечен `aria-busy`. */
+    loading?: boolean;
+    /** Сколько строк-заглушек показать при `loading`. */
+    loadingRows?: number;
+    /**
+     * Лента пуста. По умолчанию определяется сама — по данным или по слоту; проп
+     * нужен там, где потребитель знает лучше.
+     */
+    empty?: boolean;
+    /** Текст пустого состояния. Слот `#empty` сильнее. */
+    emptyText?: string;
+}
+declare const __VLS_export: <T = unknown>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & __VLS_PrettifyLocal<GrTimelineProps<T>> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: {}) => void;
+    attrs: any;
+    slots: {
+        /** Пункты ленты (`GrTimelineItem`), когда данные не переданы пропом. */
+        default?: () => any;
+        /** Пункт в data-режиме. */
+        item?: (props: {
+            item: T;
+            index: number;
+        }) => any;
+        /** Заголовок группы. По умолчанию — сам ключ. */
+        group?: (props: {
+            group: string;
+            items: T[];
+        }) => any;
+        /** Содержимое пустого состояния вместо текста по умолчанию. */
+        empty?: () => any;
+        /** Заглушки загрузки вместо строк по умолчанию. */
+        loading?: () => any;
+    };
+    emit: {};
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default: typeof __VLS_export;
+export default _default;
+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/GrTimeline/GrTimelineItem.vue.d.ts

@@ -0,0 +1,84 @@
+import { type GrTimelineMarkerVariant, type GrTimelineTone } from './grTimelineStyles';
+export type { GrTimelineMarkerVariant, GrTimelineTone } from './grTimelineStyles';
+export interface GrTimelineItemProps {
+    /** Метка времени. Слот `#time` сильнее. */
+    time?: string;
+    /** Машиночитаемое значение метки: попадает в `datetime` тега `<time>`. */
+    datetime?: string;
+    /** Заголовок события. Слот `#title` сильнее. */
+    title?: string;
+    /** Пояснение под заголовком. Слот `#description` сильнее. */
+    description?: string;
+    /** Цвет маркера из палитры пакета. */
+    tone?: GrTimelineTone;
+    /** Заполненная точка — событие случилось, полая — запланировано. */
+    variant?: GrTimelineMarkerVariant;
+    /**
+     * Событие ещё не произошло: точка полая, а отрезок оси **после** неё —
+     * пунктирный. Перебивает `variant`.
+     */
+    pending?: boolean;
+}
+type __VLS_Slots = {
+    /** Содержимое события под заголовком и описанием. */
+    default?: () => any;
+    /** Маркер вместо точки: иконка статуса, аватар автора, номер шага. */
+    marker?: () => any;
+    /** Метка времени. */
+    time?: () => any;
+    /** Заголовок события. */
+    title?: () => any;
+    /** Пояснение под заголовком. */
+    description?: () => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTimelineItemProps>, {
+    time: undefined;
+    datetime: undefined;
+    title: undefined;
+    description: undefined;
+    tone: string;
+    variant: string;
+    pending: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTimelineItemProps>, {
+    time: undefined;
+    datetime: undefined;
+    title: undefined;
+    description: undefined;
+    tone: string;
+    variant: string;
+    pending: boolean;
+}>>> & Readonly<{}>, {
+    tone: GrTimelineTone;
+    variant: GrTimelineMarkerVariant;
+    title: string;
+    time: string;
+    description: string;
+    pending: boolean;
+    datetime: 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/GrTimeline/config.d.ts

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

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

@@ -0,0 +1,19 @@
+import type { GrTimelineHeadingLevel } from './grTimelineContext';
+import type { GrTimelineDensity, GrTimelineLayout, GrTimelineOrientation } from './grTimelineStyles';
+/**
+ * Пропы `GrTimeline`, настраиваемые глобально через `componentDefaults`.
+ *
+ * Только оформление: данные, группировка и состояние загрузки принадлежат
+ * конкретному экземпляру.
+ */
+export interface GrTimelineConfigurableProps {
+    layout: GrTimelineLayout;
+    orientation: GrTimelineOrientation;
+    density: GrTimelineDensity;
+    groupHeadingLevel: GrTimelineHeadingLevel;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrTimeline: GrTimelineConfigurableProps;
+    }
+}

package/dist/types/src/components/GrTimeline/grTimelineContext.d.ts

@@ -0,0 +1,18 @@
+import type { ComputedRef, InjectionKey } from 'vue';
+import type { GrTimelineDensity, GrTimelineLayout, GrTimelineOrientation } from './grTimelineStyles';
+/**
+ * Уровень заголовка группы. Тот же довод, что у `GrCollapse`: лента в разделе
+ * `<h4>` с захардкоженным `<h3>` рвёт навигацию по заголовкам.
+ */
+export declare const GR_TIMELINE_HEADING_LEVELS: readonly [2, 3, 4, 5, 6];
+export type GrTimelineHeadingLevel = typeof GR_TIMELINE_HEADING_LEVELS[number];
+/**
+ * Пункт читает раскладку из контейнера, а не получает её пропом: иначе
+ * `layout` пришлось бы дублировать на каждом `GrTimelineItem`.
+ */
+export interface GrTimelineContext {
+    layout: ComputedRef<GrTimelineLayout>;
+    orientation: ComputedRef<GrTimelineOrientation>;
+    density: ComputedRef<GrTimelineDensity>;
+}
+export declare const GR_TIMELINE_CONTEXT: InjectionKey<GrTimelineContext>;

package/dist/types/src/components/GrTimeline/grTimelineStyles.d.ts

@@ -0,0 +1,37 @@
+import type { GrTone } from '../shared/tones';
+export type GrTimelineTone = GrTone;
+/** Плотность вертикальных отступов пункта — та же ось, что `density` у `GrListItem`. */
+export declare const GR_TIMELINE_DENSITIES: readonly ["regular", "compact"];
+export type GrTimelineDensity = typeof GR_TIMELINE_DENSITIES[number];
+/**
+ * `stacked` — одна ось слева; `time` — метка времени отдельной колонкой слева от
+ * оси; `alternate` — пункты попеременно по обе стороны центральной оси.
+ */
+export declare const GR_TIMELINE_LAYOUTS: readonly ["stacked", "time", "alternate"];
+export type GrTimelineLayout = typeof GR_TIMELINE_LAYOUTS[number];
+export declare const GR_TIMELINE_ORIENTATIONS: readonly ["vertical", "horizontal"];
+export type GrTimelineOrientation = typeof GR_TIMELINE_ORIENTATIONS[number];
+/** Заполненная точка — событие случилось; полая — запланировано. */
+export declare const GR_TIMELINE_MARKER_VARIANTS: readonly ["filled", "outlined"];
+export type GrTimelineMarkerVariant = typeof GR_TIMELINE_MARKER_VARIANTS[number];
+/**
+ * Отступ **под** пунктом, а не `gap` контейнера: отрезок оси растёт до низа
+ * пункта, и промежуток, которого пункт не занимает, разорвал бы линию.
+ */
+export declare const densityPadding: Record<GrTimelineDensity, string>;
+/**
+ * Заливка маркера. У тона `neutral` одноимённой роли в палитре нет — его вес
+ * это приглушённый текст, поэтому точка красится `--gr-muted-fg`.
+ */
+export declare const markerFilledToneClass: Record<GrTimelineTone, string>;
+/** Полая точка: обводка тоном, середина — фон страницы, чтобы ось не просвечивала. */
+export declare const markerOutlinedToneClass: Record<GrTimelineTone, string>;
+export declare const markerBaseClass = "block shrink-0 rounded-[var(--gr-radius-full)]";
+export declare const timeClass = "text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)] [font-variant-numeric:tabular-nums]";
+export declare const titleClass = "text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] font-600 text-[var(--gr-fg)]";
+export declare const descriptionClass = "mt-0.5 text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)]";
+export declare const groupTitleClass = "text-[length:var(--gr-text-xs)] leading-[var(--gr-leading-normal)] font-600 uppercase tracking-wide text-[var(--gr-muted-fg)]";
+export declare const emptyClass = "py-6 text-center text-[length:var(--gr-text-sm)] leading-[var(--gr-leading-normal)] text-[var(--gr-muted-fg)]";
+export declare const loadingRowClass = "flex items-center gap-3 pb-5";
+export declare function grTimelineDensityClass(density: GrTimelineDensity): string;
+export declare function grTimelineMarkerClass(tone: GrTimelineTone, variant: GrTimelineMarkerVariant): string;

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

@@ -0,0 +1,12 @@
+export { default } from './GrTimeline.vue';
+export { default as GrTimeline } from './GrTimeline.vue';
+export type { GrTimelineDensity, GrTimelineGroupBy, GrTimelineLayout, GrTimelineOrientation, GrTimelineProps, } from './GrTimeline.vue';
+export { default as GrTimelineItem } from './GrTimelineItem.vue';
+export type { GrTimelineItemProps, GrTimelineMarkerVariant, GrTimelineTone, } from './GrTimelineItem.vue';
+export { grTimelineConfig } from './config';
+export { GR_TIMELINE_HEADING_LEVELS } from './grTimelineContext';
+export type { GrTimelineHeadingLevel } from './grTimelineContext';
+export { grTimelineSafelist } from './safelist';
+export { groupTimelineItems } from './timelineGroups';
+export type { GrTimelineEntry, GrTimelineGroup } from './timelineGroups';
+export type { GrTimelineConfigurableProps } from './defaults';

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

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

package/dist/types/src/components/GrTimeline/timelineGroups.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Группировка ленты событий. Без Vue — чтобы проверялась без монтирования.
+ */
+export type GrTimelineGroupBy<T> = string | ((item: T, index: number) => string);
+/** Пункт вместе с его позицией в исходном наборе: ключи `v-for` считаются от неё. */
+export interface GrTimelineEntry<T> {
+    item: T;
+    index: number;
+}
+export interface GrTimelineGroup<T> {
+    /** Ключ группы. Пустая строка — заголовка у группы нет. */
+    key: string;
+    entries: GrTimelineEntry<T>[];
+}
+/**
+ * Режет набор на группы, **не меняя порядок**: лента хронологична, и
+ * пересортировать её компонент не вправе. Порядок групп — порядок первого
+ * вхождения ключа; разорванная группа (`A B A`) собирается в одну.
+ *
+ * Без `groupBy` — одна безымянная группа: плоская лента остаётся частным
+ * случаем, и второй ветки рендера у компонента не появляется.
+ */
+export declare function groupTimelineItems<T>(items: readonly T[], groupBy?: GrTimelineGroupBy<T>): GrTimelineGroup<T>[];

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

@@ -10,6 +10,16 @@ export interface GrToasterProps {
     dismissLabel?: string;
     /** A11y-лейбл контейнера-региона (i18n). */
     regionLabel?: string;
+    /**
+     * Ширина стека. Число — пиксели, строка — любая CSS-длина. Уезжает в
+     * `--gr-toaster-width`, поэтому то же самое можно задать и темой.
+     */
+    width?: string | number;
+    /**
+     * Клавиша перевода фокуса в стек уведомлений; `false` отключает хоткей.
+     * `F6` — рекомендация APG для перехода между «регионами» страницы.
+     */
+    focusHotkey?: string | false;
 }
 /**
  * Слот `actions` полностью заменяет дефолтные action-кнопки тоста. Получает сам
@@ -21,21 +31,35 @@ type __VLS_Slots = {
         dismiss: () => void;
     }) => unknown;
 };
+/**
+ * Переводит фокус на верхний тост. Тост фокусируем только программно
+ * (`tabindex="-1"`): собственной остановкой `Tab` стек быть не должен, иначе
+ * всплывающее уведомление перехватывало бы обход страницы.
+ */
+declare function focus(): boolean;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
     placement: 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>, {
+    width: undefined;
+    focusHotkey: string;
+}>>, {
+    focus: typeof focus;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrToasterProps>, {
     placement: string;
     maxVisible: number;
     dismissLabel: undefined;
     regionLabel: undefined;
+    width: undefined;
+    focusHotkey: string;
 }>>> & Readonly<{}>, {
+    width: string | number;
     placement: GrToasterPlacement;
     dismissLabel: string;
     regionLabel: string;
     maxVisible: number;
+    focusHotkey: string | false;
 }, {}, {}, {}, 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/GrToaster/config.d.ts

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

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

@@ -1,6 +1,9 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrToasterComponent from './GrToaster.vue';
 export { default } from './GrToaster.vue';
 export { default as GrToaster } from './GrToaster.vue';
 export type { GrToasterPlacement, GrToasterProps } from './GrToaster.vue';
 export { grToasterConfig } from './config';
 export { grToasterSafelist } from './safelist';
 export type { GrToastTone, Toast, ToastAction, ToastInput } from '../../composables/useToast';
+export type GrToasterInstance = ComponentExposed<typeof GrToasterComponent>;

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

@@ -1,17 +1,68 @@
+import { type UseFloatingPlacement } from '../../composables/useFloating';
+import { type GrTooltipSize } from './grTooltipStyles';
+export type GrTooltipPlacement = UseFloatingPlacement;
 export interface GrTooltipProps {
-    text: string;
+    /** Текст подсказки. Разметка вместо текста — слот `#content`. */
+    text?: string;
     /** Цвет триггер-иконки (CSS color). По умолчанию — `var(--gr-muted-fg)`. */
     iconColor?: string;
+    /** Размер панели и дефолтной триггер-иконки. */
+    size?: GrTooltipSize;
+    /** Предпочтительная сторона панели; `flip` может её изменить. */
+    placement?: GrTooltipPlacement;
+    /** Зазор между триггером и панелью, px. */
+    offsetPx?: number;
+    /** Задержка перед показом, мс. Спасает от мигания при проведении курсором по панели кнопок. */
+    openDelay?: number;
+    /** Задержка перед скрытием, мс. */
+    closeDelay?: number;
+    /** Подсказка не показывается ничем — ни курсором, ни фокусом, ни `v-model:open`. */
+    disabled?: boolean;
+    /** Управляемая видимость. Без неё компонент ведёт видимость сам. */
+    open?: boolean;
+}
+export interface GrTooltipEmits {
+    (e: 'update:open', value: boolean): void;
 }
-declare var __VLS_1: {};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
+type __VLS_Slots = {
+    /** Триггер. По умолчанию — иконка info. */
+    default?: () => unknown;
+    /** Содержимое подсказки; заменяет проп `text`. */
+    content?: () => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTooltipProps>, {
+    text: undefined;
     iconColor: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTooltipProps>, {
+    size: undefined;
+    placement: string;
+    offsetPx: undefined;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
+    open: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:open": (value: boolean) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTooltipProps>, {
+    text: undefined;
     iconColor: string;
-}>>> & Readonly<{}>, {
+    size: undefined;
+    placement: string;
+    offsetPx: undefined;
+    openDelay: number;
+    closeDelay: number;
+    disabled: boolean;
+    open: undefined;
+}>>> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    size: GrTooltipSize;
+    text: string;
+    placement: GrTooltipPlacement;
+    open: boolean;
+    disabled: boolean;
+    offsetPx: number;
+    openDelay: number;
+    closeDelay: number;
     iconColor: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

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

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

@@ -0,0 +1,10 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrTooltip`, настраиваемые глобально через `componentDefaults`. */
+export interface GrTooltipConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrTooltip: GrTooltipConfigurableProps;
+    }
+}

package/dist/types/src/components/GrTooltip/grTooltipStyles.d.ts

@@ -0,0 +1,8 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrTooltipSize = GrComponentSize;
+/** Панель подсказки: кегль и внутренние поля. */
+export declare const panelSizes: Record<GrTooltipSize, string>;
+/** Ширина панели растёт вместе с кеглем — иначе на `lg` строка рвётся втрое. */
+export declare const panelWidths: Record<GrTooltipSize, string>;
+/** Дефолтный триггер — иконка info из шкалы `GrIcon` (`xs…lg` → `14…20px`). */
+export declare const triggerIconSizes: Record<GrTooltipSize, GrComponentSize>;

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

@@ -1,4 +1,8 @@
 export { default } from './GrTooltip.vue';
 export { default as GrTooltip } from './GrTooltip.vue';
-export type { GrTooltipProps } from './GrTooltip.vue';
+export type { GrTooltipPlacement, GrTooltipProps } from './GrTooltip.vue';
 export { grTooltipConfig } from './config';
+export type { GrTooltipConfigurableProps } from './defaults';
+export type { GrTooltipSize } from './grTooltipStyles';
+export { grTooltipSafelist } from './safelist';
+export type { GrTooltipEmits } from './GrTooltip.vue';

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

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

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

@@ -1,11 +1,29 @@
-import type { GrTreeInstance, GrTreeNode, GrTreeNodeDropType } from './grTreeTypes';
+import type { GrTreeInstance, GrTreeKey, GrTreeNode, GrTreeNodeDropType } from './grTreeTypes';
 import type { GrTreeProps } from './grTreeProps';
+export interface GrTreeEmits<T extends Record<string, any> = any> {
+    (e: 'nodeClick', data: T, node: GrTreeNode<T>): void;
+    (e: 'nodeExpand', data: T, node: GrTreeNode<T>): void;
+    (e: 'nodeCollapse', data: T, node: GrTreeNode<T>): void;
+    (e: 'nodeDrop', draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType): void;
+    (e: 'nodeContextMenu', evt: MouseEvent, data: T, node: GrTreeNode<T>): void;
+    (e: 'update:checkedKeys', keys: GrTreeKey[]): void;
+    (e: 'check', data: T, node: GrTreeNode<T>, info: {
+        checkedKeys: GrTreeKey[];
+        halfCheckedKeys: GrTreeKey[];
+    }): void;
+}
 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<GrTreeProps<T> & {
         onNodeClick?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
         onNodeExpand?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
         onNodeCollapse?: ((data: T, node: GrTreeNode<T>) => any) | undefined;
         onNodeDrop?: ((draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType) => any) | undefined;
+        onNodeContextMenu?: ((evt: MouseEvent, data: T, node: GrTreeNode<T>) => any) | undefined;
+        "onUpdate:checkedKeys"?: ((keys: GrTreeKey[]) => any) | undefined;
+        onCheck?: ((data: T, node: GrTreeNode<T>, info: {
+            checkedKeys: GrTreeKey[];
+            halfCheckedKeys: GrTreeKey[];
+        }) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
@@ -17,12 +35,7 @@ declare const __VLS_export: <T extends Record<string, any> = any>(__VLS_props: N
             data: T;
         }) => any;
     };
-    emit: {
-        (event: "nodeClick", data: T, node: GrTreeNode<T>): void;
-        (event: "nodeExpand", data: T, node: GrTreeNode<T>): void;
-        (event: "nodeCollapse", data: T, node: GrTreeNode<T>): void;
-        (event: "nodeDrop", draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType): void;
-    };
+    emit: GrTreeEmits<T>;
 }>) => import("vue").VNode & {
     __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

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

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

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

@@ -0,0 +1,10 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/** Пропы `GrTree`, настраиваемые глобально через `componentDefaults`. */
+export interface GrTreeConfigurableProps {
+    size: GrComponentSize;
+}
+declare module '../GrConfigProvider/context' {
+    interface GrComponentDefaultsRegistry {
+        GrTree: GrTreeConfigurableProps;
+    }
+}

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

@@ -0,0 +1,31 @@
+import type { GrTreeKey, GrTreeNode } from './grTreeTypes';
+/**
+ * Состояние отметки узла. `half` — часть потомков отмечена: в ARIA это
+ * `aria-checked="mixed"`.
+ */
+export declare const GR_TREE_CHECK_STATES: readonly ["checked", "half", "unchecked"];
+export type GrTreeCheckState = typeof GR_TREE_CHECK_STATES[number];
+export type GrTreeCheckStates = Map<GrTreeKey, GrTreeCheckState>;
+/**
+ * Раскладывает отмеченные ключи по всему дереву: родитель отмечен, когда
+ * отмечены все дети, и наполовину — когда часть.
+ *
+ * Считается от листьев вверх, поэтому `checkedKeys` снаружи может содержать
+ * только листья (типовой формат ответа сервера) — родители посчитаются сами.
+ * При `strict` дерево не связывает узлы вовсе: каждый отвечает сам за себя.
+ */
+export declare function resolveCheckStates<T>(roots: GrTreeNode<T>[], checkedKeys: Set<GrTreeKey>, strict: boolean): GrTreeCheckStates;
+/**
+ * Новый набор отмеченных ключей после переключения узла.
+ *
+ * Каскад идёт вниз (все потомки повторяют решение) и вверх (родитель отмечен,
+ * только если отмечены все его дети). Возвращается набор с родителями —
+ * `getCheckedKeys({ leafOnly: true })` при необходимости отбросит их обратно.
+ */
+export declare function toggleCheckedKeys<T>(roots: GrTreeNode<T>[], checkedKeys: Set<GrTreeKey>, node: GrTreeNode<T>, checked: boolean, strict: boolean): Set<GrTreeKey>;
+/** Отбрасывает ключи, которых нет в текущей модели (данные могли смениться). */
+export declare function pruneToTree<T>(roots: GrTreeNode<T>[], keys: Set<GrTreeKey>): Set<GrTreeKey>;
+/** Ключи в состоянии `checked`; `leafOnly` оставляет только листья. */
+export declare function collectCheckedKeys<T>(roots: GrTreeNode<T>[], states: GrTreeCheckStates, leafOnly: boolean): GrTreeKey[];
+/** Ключи в состоянии `half` — родители с частично отмеченными потомками. */
+export declare function collectHalfCheckedKeys(states: GrTreeCheckStates): GrTreeKey[];

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

@@ -6,6 +6,8 @@ export type GrTreeDataAdapter<T extends object> = {
     getChildrenKey: () => string;
     getLabelKey: () => string;
     getLabel: (data: T) => string;
+    /** Признак «лист» из данных. `undefined` — данные молчат, решает вызывающий. */
+    getIsLeaf: (data: T) => boolean | undefined;
     getChildren: (data: T) => T[];
     ensureChildren: (data: T) => T[];
     getNodeKey: (data: T, index: number, parentKey: GrTreeKey | undefined) => GrTreeKey;

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

@@ -15,11 +15,19 @@ export type GrTreeInteractionEmitters<T> = {
     emitNodeExpand: (data: T, node: GrTreeNode<T>) => void;
     emitNodeCollapse: (data: T, node: GrTreeNode<T>) => void;
     emitNodeDrop: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType) => void;
+    emitNodeContextMenu: (evt: MouseEvent, data: T, node: GrTreeNode<T>) => void;
 };
 export type GrTreeInteractionContext<T> = {
     hoveredKey: Ref<GrTreeKey | undefined>;
     /** Клавиша узла, держащего roving-фокус (единственный tabindex=0 во всём дереве). */
     focusedKey: Ref<GrTreeKey | undefined>;
+    /**
+     * Реестр DOM-узлов строк, общий на все уровни дерева. Нужен клавиатуре: без
+     * него каждое нажатие стрелки обходило бы весь DOM поддерева в поисках
+     * строки по `data`-атрибуту.
+     */
+    nodeEls: Map<GrTreeKey, HTMLElement>;
+    registerNodeEl: (key: GrTreeKey, el: HTMLElement | null) => void;
     draggingNode: ShallowRef<GrTreeNode<T> | null>;
     dropTarget: ShallowRef<GrTreeDropTarget | null>;
     canDrag: (node: GrTreeNode<T>) => boolean;
@@ -29,5 +37,6 @@ export type GrTreeInteractionContext<T> = {
     emitNodeExpand: (data: T, node: GrTreeNode<T>) => void;
     emitNodeCollapse: (data: T, node: GrTreeNode<T>) => void;
     emitNodeDrop: (draggingNode: GrTreeNode<T>, dropNode: GrTreeNode<T>, dropType: GrTreeNodeDropType) => void;
+    emitNodeContextMenu: (evt: MouseEvent, data: T, node: GrTreeNode<T>) => void;
 };
 export declare function createGrTreeInteractionContext<T>(options: GrTreeInteractionOptions<T>, emitters: GrTreeInteractionEmitters<T>): GrTreeInteractionContext<T>;