@feugene/granularity 0.12.0 → 0.16.0

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

@@ -1,10 +1,15 @@
-export type GrTab = {
+import { type GrTabsOrientation, type GrTabsSize, type GrTabsVariant } from './grTabsStyles';
+export interface GrTab {
     value: string;
     label: string;
     badge?: string;
+    /** UnoCSS-класс иконки слева от подписи (например `i-lucide-user`). */
+    icon?: string;
     disabled?: boolean;
-};
-export type GrTabsProps = {
+    /** Перекрывает `closable` ряда в обе стороны: закрепить вкладку или закрыть одну её. */
+    closable?: boolean;
+}
+export interface GrTabsProps {
     modelValue: string;
     tabs: GrTab[];
     /**
@@ -13,12 +18,78 @@ export type GrTabsProps = {
      * Передайте тот же `idBase` в `GrTabPanels`, чтобы связать `tab`↔`tabpanel`.
      */
     idBase?: string;
+    size?: GrTabsSize;
+    /** Вид ряда: обойма с таблетками или ряд с подчёркиванием. */
+    variant?: GrTabsVariant;
+    /**
+     * `automatic` (по умолчанию) — стрелка сразу переключает вкладку;
+     * `manual` — стрелка двигает только фокус, выбор подтверждается
+     * `Enter`/`Space`. Второй режим для вкладок с тяжёлой загрузкой: перебор
+     * стрелками иначе тянет каждую панель.
+     */
+    activationMode?: GrTabsActivationMode;
+    /** Горизонтальный (по умолчанию) или вертикальный список вкладок. */
+    orientation?: GrTabsOrientation;
+    /**
+     * Крестик на вкладках и закрытие по `Delete`/`Backspace`. Точечно снимается
+     * `closable: false` у самой вкладки.
+     */
+    closable?: boolean;
+    /** Текст, когда список вкладок пуст. Слот `#empty` сильнее. */
+    emptyText?: string;
+}
+export interface GrTabsEmits {
+    (e: 'update:modelValue', value: string): void;
+    /**
+     * Просьба закрыть вкладку. Компонент список не трогает: `tabs` — проп, и
+     * закрытие может не состояться («сохранить изменения?»).
+     */
+    (e: 'close', value: string): void;
+}
+export type GrTabsActivationMode = 'automatic' | 'manual';
+export type { GrTabsOrientation, GrTabsVariant } from './grTabsStyles';
+type __VLS_Slots = {
+    /** Содержимое вкладки целиком — вместо подписи, иконки и счётчика. Крестик остаётся. */
+    tab?: (props: {
+        tab: GrTab;
+        active: boolean;
+        disabled: boolean;
+    }) => unknown;
+    /** Пустой ряд — вместо текста из локали. */
+    empty?: () => unknown;
 };
-declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<GrTabsProps>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabsProps>, {
+    idBase: undefined;
+    size: undefined;
+    variant: undefined;
+    activationMode: string;
+    orientation: string;
+    closable: boolean;
+    emptyText: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: string) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<GrTabsProps>>> & Readonly<{
+    close: (value: string) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrTabsProps>, {
+    idBase: undefined;
+    size: undefined;
+    variant: undefined;
+    activationMode: string;
+    orientation: string;
+    closable: boolean;
+    emptyText: undefined;
+}>>> & Readonly<{
+    onClose?: ((value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}>, {
+    variant: GrTabsVariant;
+    closable: boolean;
+    size: GrTabsSize;
+    orientation: GrTabsOrientation;
+    emptyText: string;
+    idBase: string;
+    activationMode: GrTabsActivationMode;
+}, {}, {}, {}, 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> = {
@@ -29,3 +100,18 @@ type __VLS_TypePropsToOption<T> = {
         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/GrTabs/config.d.ts

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

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

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

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

@@ -0,0 +1,71 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrTabsSize = GrComponentSize;
+/**
+ * `pills` — вкладки-таблетки в общей обойме, `line` — классический ряд с
+ * подчёркиванием активной. Имя `pills` общее с `GrSegmented`: у компонентов
+ * одна роль, и вид с таким названием у них совпадает.
+ */
+export declare const GR_TABS_VARIANTS: readonly ["pills", "line"];
+export type GrTabsVariant = typeof GR_TABS_VARIANTS[number];
+export type GrTabsOrientation = 'horizontal' | 'vertical';
+/** Высота вкладки повторяет шкалу `GrButton`: вкладки часто стоят с ним в один ряд. */
+export declare const tabSizes: Record<GrTabsSize, string>;
+/** Счётчик у вкладки: на ступень мельче подписи. */
+export declare const tabBadgeSizes: Record<GrTabsSize, string>;
+/** Обойма вокруг вкладок: на мелких ступенях рамка съедала бы высоту. */
+export declare const tablistSizes: Record<GrTabsSize, string>;
+/** `line` живёт без обоймы, поэтому и без внутренних отступов. */
+export declare const tablistLineSizes: Record<GrTabsSize, string>;
+export declare const tablistBase = "inline-flex max-w-full";
+export declare const tablistVariants: Record<GrTabsVariant, string>;
+/**
+ * Вертикальный `line` подчёркивает вкладку сбоку, а не снизу: линия должна идти
+ * вдоль списка, иначе она отделяет вкладки друг от друга вместо ряда целиком.
+ */
+export declare const tablistVerticalVariants: Record<GrTabsVariant, string>;
+/**
+ * Переполнение прокручивается, а не переносится строкой: перенос ломает ряд и
+ * уводит вкладки под панель. Полоса прокрутки скрыта — ряд ведёт клавиатура и
+ * автоскролл к активной вкладке.
+ */
+export declare const tablistScrollClass = "overflow-x-auto [scrollbar-width:none] [&::-webkit-scrollbar]:hidden";
+/** Вертикальный ряд — колонка; прокрутки ему не нужно: он растёт вниз. */
+export declare const tablistColumnClass = "flex-col";
+export declare const tabBase = "shrink-0 font-600 transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+export declare const tabVariantBase: Record<GrTabsVariant, string>;
+export declare const tabStateClasses: Record<GrTabsVariant, {
+    active: string;
+    idle: string;
+    disabled: string;
+}>;
+export declare const tabIconClass = "h-4 w-4 shrink-0";
+export declare const tabContentClass = "inline-flex items-center gap-2";
+/**
+ * Крестик закрытия. Кнопкой он быть не может: `role="tab"` объявляет потомков
+ * презентационными, и вложенный интерактив теряется у скринридера (axe:
+ * `nested-interactive`). Поэтому это `<span>`, а клик по нему разбирает
+ * обработчик самой вкладки.
+ *
+ * Своего фокус-кольца у него нет по той же причине — в таб-порядке он не стоит,
+ * с клавиатуры закрытие идёт по `Delete`/`Backspace`.
+ */
+export declare const tabCloseBase = "inline-flex items-center justify-center shrink-0 rounded-[var(--gr-radius-sm)] text-[var(--gr-muted-fg)] transition-colors hover:bg-[var(--gr-muted)] hover:text-[var(--gr-fg)]";
+export declare const tabCloseSizes: Record<GrTabsSize, string>;
+export declare const tabCloseIconSizes: Record<GrTabsSize, string>;
+/** Пустой ряд держит высоту вкладки: иначе соседние блоки прыгают при закрытии последней. */
+export declare const tabsEmptyBase = "inline-flex items-center text-[var(--gr-muted-fg)]";
+export declare const tabBadgeBase = "rounded-[var(--gr-radius-full)] bg-[var(--gr-secondary)] text-[var(--gr-secondary-fg)]";
+export declare function grTabsListClass(options: {
+    variant: GrTabsVariant;
+    size: GrTabsSize;
+    orientation: GrTabsOrientation;
+}): string;
+export declare function grTabsTabClass(options: {
+    variant: GrTabsVariant;
+    size: GrTabsSize;
+    active: boolean;
+    disabled: boolean;
+}): string;
+export declare function grTabsBadgeClass(size: GrTabsSize): string;
+export declare function grTabsCloseClass(size: GrTabsSize): string;
+export declare function grTabsEmptyClass(size: GrTabsSize): string;

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

@@ -2,3 +2,8 @@ export { default } from './GrTabs.vue';
 export { default as GrTabs } from './GrTabs.vue';
 export type { GrTab, GrTabsProps } from './GrTabs.vue';
 export { grTabsConfig } from './config';
+export type { GrTabsConfigurableProps } from './defaults';
+export { GR_TABS_VARIANTS } from './grTabsStyles';
+export type { GrTabsOrientation, GrTabsSize, GrTabsVariant } from './grTabsStyles';
+export { grTabsSafelist } from './safelist';
+export type { GrTabsEmits } from './GrTabs.vue';

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

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

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 disabled: boolean;
-    readonly invalid: 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;
 }>, {
-    disabled: boolean;
+    size: GrTextareaSize;
+    clearable: boolean;
+    readonly: boolean;
     name: string;
-    id: string;
     invalid: boolean;
-    rows: number;
+    resize: GrTextareaResize;
+    id: string;
+    disabled: boolean;
+    required: boolean;
     placeholder: string;
+    ariaLabel: string;
+    clearLabel: string;
     autocomplete: string;
+    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 '../GrConfigProvider/context' {
+    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)] [font-variant-numeric: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)] [font-variant-numeric: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 '../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>;