@feugene/granularity 0.13.0 → 0.18.0

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

@@ -1,62 +1,127 @@
-import { type GrTextareaState } from './grTextareaStyles';
-type __VLS_Props = {
+import { type GrTextareaResize, type GrTextareaSize, type GrTextareaState } from './grTextareaStyles';
+export interface GrTextareaProps {
     modelValue: string;
     placeholder?: string;
     autocomplete?: string;
     disabled?: boolean;
+    /** Только для чтения: значение видно и уходит в форму, но не редактируется. */
+    readonly?: boolean;
     invalid?: boolean;
+    /** Обязательное поле (`aria-required`). Складывается с `required` у `GrFormField`. */
+    required?: boolean;
+    /** Доступное имя вне `GrFormField`. */
+    ariaLabel?: string;
     state?: GrTextareaState;
     name?: string;
     id?: string;
     rows?: number;
-};
-declare const props: Readonly<{
-    modelValue: string;
-}> & {
-    readonly placeholder: string | undefined;
-    readonly autocomplete: string | undefined;
-    readonly disabled: boolean;
-    readonly invalid: boolean;
-    readonly state: GrTextareaState;
-    readonly name: string | undefined;
-    readonly id: string | undefined;
-    readonly rows: number;
-} & {
-    readonly invalid: boolean;
-    readonly disabled: boolean;
-};
-export type GrTextareaProps = typeof props;
-declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    size?: GrTextareaSize;
+    /** Ограничение длины + основа для счётчика символов. */
+    maxlength?: number;
+    /** Показывать счётчик символов (`len` или `len/maxlength`). */
+    showCount?: boolean;
+    /**
+     * Показывать счётчик строк. Считаются **логические** строки (переводы строки), а
+     * не визуальные переносы: при `autosize` число не меняется от ширины поля.
+     */
+    showLineCount?: boolean;
+    /**
+     * Ориентир по числу строк для счётчика (`3 / 10`). Ввод не ограничивает: обрезать
+     * набранный текст за пользователя компонент не вправе.
+     */
+    maxLines?: number;
+    /** Подгонять высоту под содержимое (директива `v-autosize`). */
+    autosize?: boolean;
+    /** Кнопка очистки значения. Настраивается через `GrConfigProvider`. */
+    clearable?: boolean;
+    /** A11y-подпись кнопки очистки. */
+    clearLabel?: string;
+    /** Ручное изменение размера пользователем. */
+    resize?: GrTextareaResize;
+}
+export interface GrTextareaEmits {
+    (e: 'update:modelValue', value: string): void;
+    /** Значение зафиксировано нативным `change` — по `blur`. */
+    (e: 'change', value: string): void;
+    /** Значение стёрто кнопкой очистки. */
+    (e: 'clear'): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+declare function focus(): void;
+declare function blur(): void;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTextareaProps>, {
     placeholder: undefined;
     autocomplete: undefined;
     disabled: boolean;
+    readonly: boolean;
     invalid: boolean;
+    required: boolean;
+    ariaLabel: undefined;
     state: string;
     name: undefined;
     id: undefined;
     rows: number;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    size: undefined;
+    maxlength: undefined;
+    showCount: boolean;
+    autosize: boolean;
+    clearable: undefined;
+    clearLabel: undefined;
+    resize: string;
+}>>, {
+    focus: typeof focus;
+    blur: typeof blur;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+    change: (value: string) => void;
+    clear: () => void;
+    focus: (event: FocusEvent) => void;
+    blur: (event: FocusEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTextareaProps>, {
     placeholder: undefined;
     autocomplete: undefined;
     disabled: boolean;
+    readonly: boolean;
     invalid: boolean;
+    required: boolean;
+    ariaLabel: undefined;
     state: string;
     name: undefined;
     id: undefined;
     rows: number;
+    size: undefined;
+    maxlength: undefined;
+    showCount: boolean;
+    autosize: boolean;
+    clearable: undefined;
+    clearLabel: undefined;
+    resize: string;
 }>>> & Readonly<{
+    onClear?: (() => any) | undefined;
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
+    size: GrTextareaSize;
+    clearable: boolean;
+    readonly: boolean;
+    name: string;
     invalid: boolean;
+    resize: GrTextareaResize;
     id: string;
-    name: string;
     disabled: boolean;
+    required: boolean;
     placeholder: string;
+    ariaLabel: string;
+    clearLabel: string;
     autocomplete: string;
-    rows: number;
+    showCount: boolean;
     state: GrTextareaState;
+    maxlength: number;
+    rows: number;
+    autosize: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

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

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

@@ -0,0 +1,18 @@
+import type { GrComponentSize } from '../GrConfigProvider/context';
+/**
+ * Пропы `GrTextarea`, настраиваемые глобально через `componentDefaults`.
+ *
+ * `size` типизируем через `GrComponentSize`, а не через `GrTextareaSize`:
+ * последний объявлен в `grTextareaStyles.ts`, который тянет контекст, — вышел
+ * бы цикл модулей.
+ */
+export interface GrTextareaConfigurableProps {
+    size: GrComponentSize;
+    /** Кнопка очистки значения. */
+    clearable: boolean;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrTextarea: GrTextareaConfigurableProps;
+    }
+}

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

@@ -1,5 +1,37 @@
-export type GrTextareaState = 'default' | 'success' | 'warning' | 'danger';
+import type { GrComponentSize, GrControlState } from '../shared/sizes';
+export type GrTextareaState = GrControlState;
+export type GrTextareaSize = GrComponentSize;
 export declare const borderClassByState: Record<GrTextareaState, string>;
+/**
+ * Ошибка валидации красится своей ролью, а не декоративным тоном `danger`:
+ * `state="danger"` — это подсветка по решению разработчика, `invalid` — вердикт
+ * валидации, и тема вправе развести их по цвету.
+ */
+export declare const invalidBorderClass = "border-[var(--gr-invalid-brd)] focus-visible:ring-[var(--gr-invalid-ring)]";
+/**
+ * Кегль совпадает с `GrInput` на каждой ступени: поле ввода и текстовая область
+ * в одной форме обязаны читаться одинаково. Вертикальный паддинг меньше, чем у
+ * `GrInput`: там он центрирует одну строку в фиксированной высоте, здесь высоту
+ * задаёт `rows`.
+ */
+export declare const sizes: Record<GrTextareaSize, string>;
+export type GrTextareaResize = 'none' | 'vertical' | 'both';
+export declare const resizeClass: Record<GrTextareaResize, string>;
+export declare const enabledSurfaceClass = "bg-[var(--gr-bg)]";
+/**
+ * Заблокированное поле гасится фоном, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA токены текста. Классы взаимоисключающие — два `bg-*` одной
+ * специфичности разрулил бы порядок в сгенерированном CSS.
+ */
+export declare const disabledSurfaceClass = "bg-[var(--gr-muted)] text-[var(--gr-muted-fg)] cursor-not-allowed";
+/**
+ * Ряд счётчиков под полем: слева строки, справа символы. Обе подписи — один
+ * визуальный уровень, поэтому кегль и цвет у них общие (`countClass`).
+ */
+export declare const countRowClass = "mt-1 flex items-baseline justify-between gap-3";
+/** Счётчик строк. Слева, потому что читается раньше: сначала «сколько строк», потом лимит символов. */
+export declare const lineCountClass = "text-[length:var(--gr-control-text-xs)] leading-[var(--gr-leading-xs)] text-[var(--gr-muted-fg)] tabular-nums";
+export declare const countClass = "mt-1 text-right text-[length:var(--gr-control-text-xs)] leading-[var(--gr-leading-xs)] text-[var(--gr-muted-fg)] tabular-nums";
 export declare function grTextareaClass(options: {
     state: GrTextareaState;
     invalid: boolean;

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 '../../composables/useGrComponentConfig' {
+    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)] 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,21 @@ export interface GrToasterProps {
     dismissLabel?: string;
     /** A11y-лейбл контейнера-региона (i18n). */
     regionLabel?: string;
+    /**
+     * Ширина стека. Число — пиксели, строка — любая CSS-длина. Уезжает в
+     * `--gr-toaster-width`, поэтому то же самое можно задать и темой.
+     */
+    width?: string | number;
+    /**
+     * Клавиша перевода фокуса в стек уведомлений; `false` отключает хоткей.
+     * `F6` — рекомендация APG для перехода между «регионами» страницы.
+     */
+    focusHotkey?: string | false;
+    /**
+     * Смахивание тоста к своему краю экрана. Клавиатурный эквивалент — `Delete`
+     * и `Backspace` на сфокусированном тосте — остаётся и при выключенном жесте.
+     */
+    swipeDismiss?: boolean;
 }
 /**
  * Слот `actions` полностью заменяет дефолтные action-кнопки тоста. Получает сам
@@ -21,21 +36,38 @@ 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;
+    swipeDismiss: boolean;
+}>>, {
+    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;
+    swipeDismiss: boolean;
 }>>> & Readonly<{}>, {
+    width: string | number;
     placement: GrToasterPlacement;
     dismissLabel: string;
     regionLabel: string;
     maxVisible: number;
+    focusHotkey: string | false;
+    swipeDismiss: 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/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/grToasterStyles.d.ts

@@ -1,2 +1,29 @@
 export type GrToasterPlacement = 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
 export declare const PLACEMENT_CLASS: Record<GrToasterPlacement, string>;
+/**
+ * Куда смахивается тост: к своему краю экрана. Стек у правого края уходит
+ * вправо, у левого — влево; смахивание «вглубь экрана» читалось бы как попытка
+ * достать что-то из-под тоста, а не выбросить его.
+ */
+export declare const SWIPE_DIRECTION: Record<GrToasterPlacement, 1 | -1>;
+/** Доля ширины тоста, после которой отпускание закрывает, а не возвращает. */
+export declare const SWIPE_THRESHOLD_RATIO = 0.25;
+/** Нижняя граница порога: на узком стеке четверть ширины слишком мала. */
+export declare const SWIPE_THRESHOLD_MIN_PX = 56;
+/**
+ * Сопротивление движению не в свою сторону. Жест остаётся живым — тост едет за
+ * пальцем, — но закрыть его «наоборот» нельзя: это была бы вторая, неочевидная
+ * дорога к тому же действию.
+ */
+export declare const SWIPE_RESISTANCE = 4;
+/**
+ * Куда уезжает отпущенный тост. Заведомо дальше своей ширины: он должен уйти
+ * за край экрана, а не остановиться на полпути.
+ */
+export declare const SWIPE_FLY_OUT_PX = 600;
+/**
+ * Смещение, на котором тост становится полностью прозрачным, — вдвое дальше
+ * порога. К моменту закрытия он уже наполовину растворён, и уход не выглядит
+ * мгновенным исчезновением.
+ */
+export declare function swipeOpacity(offset: number, threshold: number): number;

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>;