@feugene/granularity 0.19.0 → 0.21.0

package/dist/types/components/GrDelta/deltaTone.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Выбор тона для величины со знаком.
+ *
+ * Чистая функция, а не `switch` внутри компонента: ровно этот `switch`
+ * расходился по приложениям копиями, и в одной из них нулевое движение
+ * красилось зелёным — как поступление.
+ */
+/** Что считать хорошим ростом. */
+export type GrDeltaPolarity = 'positive-good'
+/** Рост — проблема: себестоимость, время отклика, отток. */
+ | 'negative-good'
+/** Знак ничего не говорит о качестве: сальдо, смещение, разница координат. */
+ | 'none';
+export type GrDeltaTone = 'success' | 'danger' | 'neutral';
+/**
+ * Тон величины по её знаку и полярности.
+ *
+ * Ноль нейтрален при любой полярности: «не изменилось» — третье состояние, и
+ * двумя цветами его не выразить. `null` величины нет вовсе — тона у неё тоже
+ * нет, это решает вызывающий.
+ */
+export declare function deltaTone(value: number, polarity?: GrDeltaPolarity): GrDeltaTone;
+/** Направление стрелки. Ноль стрелки не получает: двигаться было некуда. */
+export declare function deltaDirection(value: number): 'up' | 'down' | 'flat';

package/dist/types/components/GrDelta/grDeltaStyles.d.ts

@@ -0,0 +1,38 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrDeltaTone } from './deltaTone';
+/**
+ * Классы `GrDelta`.
+ *
+ * Тон перечислен целиком по одному литералу на ветку: UnoCSS сканирует исходный
+ * текст файла, и собранное шаблонной строкой имя (`text-[var(--gr-${tone}-text)]`)
+ * уехало бы в CSS литералом.
+ */
+/**
+ * Величина стоит в строке текста, поэтому наследует её кегль и выравнивание.
+ *
+ * Общего `gap` нет намеренно: префикс — это валюта, и «$ 12,50» с зазором
+ * читается как опечатка. Отбивку получают только стрелка и суффикс.
+ */
+export declare const deltaRootClass = "inline-flex items-baseline tabular-nums";
+/** Суффикс — единица измерения, и от числа он отбивается: «−15 %», «120 мс». */
+export declare const deltaSuffixClass = "ml-1";
+/**
+ * Стрелка выравнивается по строке, а не по базовой линии: у svg её нет.
+ *
+ * Размер — в `em`, потому что на ступени `md` кегля у величины нет вовсе:
+ * пиксельная лестница оставила бы стрелку 14-пиксельной внутри заголовка.
+ * Чуть меньше единицы: стрелка декоративна, и равный вес спорил бы с самим
+ * числом.
+ */
+export declare const deltaArrowClass = "mr-0.5 self-center shrink-0 h-[0.875em] w-[0.875em]";
+export declare const deltaToneClass: Record<GrDeltaTone, string>;
+/** Прочерк вместо величины: тона у него нет, но и цвет основного текста ему не нужен. */
+export declare const deltaEmptyClass = "text-[var(--gr-muted-fg)]";
+/**
+ * `md` пуст намеренно: на ступени по умолчанию величина набирается кеглем той
+ * строки, в которой стоит. Фиксированные 13 px разъезжаются и вверх, и вниз —
+ * внутри заголовка величина оставалась бы мелкой, в подписи под графиком
+ * крупной. Ступени по краям остаются явными: они нужны, когда величина стоит
+ * не в предложении, а в ряду с контролами.
+ */
+export declare const deltaSizeClass: Record<GrComponentSize, string>;

package/dist/types/components/GrDelta/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './GrDelta.vue';
+export { default as GrDelta } from './GrDelta.vue';
+export { grDeltaConfig } from './config';
+export type { GrDeltaPolarity, GrDeltaProps, GrDeltaTone } from './GrDelta.vue';
+export type { GrDeltaConfigurableProps } from './defaults';
+export { grDeltaSafelist } from './safelist';

package/dist/types/components/GrDelta/safelist.d.ts

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

package/dist/types/components/GrDescriptionList/GrDescriptionList.vue.d.ts

@@ -0,0 +1,107 @@
+import { type GrDescriptionColumns, type GrDescriptionDensity, type GrDescriptionLayout } from './grDescriptionListStyles';
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrTone } from '../shared/tones';
+export type { GrDescriptionColumns, GrDescriptionDensity, GrDescriptionLayout, } from './grDescriptionListStyles';
+export interface GrDescriptionItem {
+    label: string;
+    /** Значение. `null` и `''` печатаются прочерком — строка не исчезает. */
+    value?: string | number | null;
+    /** Ключ слотов `#value-<name>` и `#label-<name>`. */
+    name?: string;
+    /** Тон значения. Подпись остаётся нейтральной всегда. */
+    tone?: GrTone;
+}
+/**
+ * Список пар «характеристика → значение»: настоящий `<dl>` с выравниванием
+ * значений в колонку.
+ *
+ * В отличие от `GrList`, где пункт — это «заголовок с подзаголовком», здесь
+ * два разных по роли элемента: термин и его значение.
+ */
+export interface GrDescriptionListProps {
+    items: readonly GrDescriptionItem[];
+    /** `inline` — подпись слева колонкой; `stacked` — над значением. */
+    layout?: GrDescriptionLayout;
+    /** Ширина колонки подписей при `inline`. */
+    labelWidth?: string;
+    /**
+     * Ниже какой ширины контейнера (px) `inline` переключается на `stacked`.
+     * В узкой колонке фиксированная подпись выжимает значение в букву на строку.
+     */
+    stackBelow?: number;
+    density?: GrDescriptionDensity;
+    /** Отбивать пары линиями. */
+    divided?: boolean;
+    columns?: GrDescriptionColumns;
+    /** Чем печатать пустое значение. */
+    emptyText?: string;
+    size?: GrComponentSize;
+}
+declare var __VLS_2: `label-${string}`, __VLS_3: {
+    item: GrDescriptionItem;
+}, __VLS_6: `value-${string}`, __VLS_7: {
+    item: GrDescriptionItem;
+}, __VLS_9: {
+    item: GrDescriptionItem;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_2>]?: (props: typeof __VLS_3) => any;
+} & {
+    [K in NonNullable<typeof __VLS_6>]?: (props: typeof __VLS_7) => any;
+} & {
+    empty?: (props: typeof __VLS_9) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDescriptionListProps>, {
+    layout: undefined;
+    labelWidth: undefined;
+    stackBelow: undefined;
+    density: undefined;
+    divided: undefined;
+    columns: undefined;
+    emptyText: undefined;
+    size: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrDescriptionListProps>, {
+    layout: undefined;
+    labelWidth: undefined;
+    stackBelow: undefined;
+    density: undefined;
+    divided: undefined;
+    columns: undefined;
+    emptyText: undefined;
+    size: undefined;
+}>>> & Readonly<{}>, {
+    size: GrComponentSize;
+    divided: boolean;
+    emptyText: string;
+    layout: GrDescriptionLayout;
+    labelWidth: string;
+    density: GrDescriptionDensity;
+    columns: GrDescriptionColumns;
+    stackBelow: number;
+}, {}, {}, {}, 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/components/GrDescriptionList/config.d.ts

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

package/dist/types/components/GrDescriptionList/defaults.d.ts

@@ -0,0 +1,21 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrDescriptionColumns, GrDescriptionDensity, GrDescriptionLayout } from './grDescriptionListStyles';
+/**
+ * Пропы `GrDescriptionList`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrDescriptionList: { … } }">`.
+ * Только оформление — данные принадлежат экземпляру.
+ */
+export interface GrDescriptionListConfigurableProps {
+    size: GrComponentSize;
+    layout: GrDescriptionLayout;
+    labelWidth: string;
+    density: GrDescriptionDensity;
+    divided: boolean;
+    columns: GrDescriptionColumns;
+    emptyText: string;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrDescriptionList: GrDescriptionListConfigurableProps;
+    }
+}

package/dist/types/components/GrDescriptionList/grDescriptionListStyles.d.ts

@@ -0,0 +1,25 @@
+import type { GrComponentSize } from '../shared/sizes';
+import type { GrTone } from '../shared/tones';
+/**
+ * Классы `GrDescriptionList`.
+ *
+ * Тон перечислен целиком по одному литералу на ветку: UnoCSS сканирует исходный
+ * текст файла, и собранное шаблонной строкой имя уехало бы в CSS литералом.
+ */
+/** `inline` — подпись колонкой слева; `stacked` — над значением. */
+export type GrDescriptionLayout = 'inline' | 'stacked';
+export type GrDescriptionDensity = 'regular' | 'compact';
+/** Сколько колонок пар. Длинный список читается в две. */
+export type GrDescriptionColumns = 1 | 2;
+export declare const descriptionRootClass = "m-0 grid gap-x-4 [row-gap:var(--gr-description-list-row-gap,0.375rem)]";
+export declare const descriptionColumnsClass: Record<GrDescriptionColumns, string>;
+export declare const descriptionPairInlineClass = "flex min-w-0 items-baseline gap-2";
+export declare const descriptionPairStackedClass = "min-w-0";
+export declare const descriptionDividedClass = "border-b border-[var(--gr-description-list-divider,var(--gr-brd))] pb-1 last:border-b-0 last:pb-0";
+export declare const descriptionLabelInlineClass = "shrink-0 text-[var(--gr-description-list-label-color,var(--gr-muted-fg))]";
+export declare const descriptionLabelStackedClass = "text-[var(--gr-description-list-label-color,var(--gr-muted-fg))]";
+export declare const descriptionValueClass = "m-0 min-w-0 break-words";
+/** Тон — только у значения: красная подпись читается как «поле сломано». */
+export declare const descriptionValueToneClass: Record<GrTone, string>;
+export declare const descriptionSizeClass: Record<GrComponentSize, string>;
+export declare const descriptionDensityClass: Record<GrDescriptionDensity, string>;

package/dist/types/components/GrDescriptionList/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './GrDescriptionList.vue';
+export { default as GrDescriptionList } from './GrDescriptionList.vue';
+export { grDescriptionListConfig } from './config';
+export type { GrDescriptionColumns, GrDescriptionDensity, GrDescriptionItem, GrDescriptionLayout, GrDescriptionListProps, } from './GrDescriptionList.vue';
+export type { GrDescriptionListConfigurableProps } from './defaults';
+export { grDescriptionListSafelist } from './safelist';

package/dist/types/components/GrDescriptionList/safelist.d.ts

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

package/dist/types/components/GrDialog/index.d.ts

@@ -0,0 +1,12 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrDialogComponent from './GrDialog.vue';
+export { default } from './GrDialog.vue';
+export { default as GrDialog, type GrDialogProps } from './GrDialog.vue';
+export { default as GrDialogHeader, type GrDialogHeaderProps } from './GrDialogHeader.vue';
+export { default as GrDialogFooter, type GrDialogFooterProps } from './GrDialogFooter.vue';
+export { default as GrDialogCloseButton } from './GrDialogCloseButton.vue';
+export { type GrDialogSectionConfig, type GrDialogSize } from './dialogShared';
+export { grDialogSafelist } from './safelist';
+export type { GrDialogEmits } from './GrDialog.vue';
+export type GrDialogInstance = ComponentExposed<typeof GrDialogComponent>;
+export type { GrDialogCloseButtonEmits } from './GrDialogCloseButton.vue';

package/dist/types/components/GrDialogService/index.d.ts

@@ -0,0 +1,6 @@
+export { default as GrDialogServiceHost } from './GrDialogServiceHost.vue';
+export { dialogService, granularityDialogServicePlugin, teardownDialogService, useDialogService, } from './useDialogService';
+export type { DialogServiceState } from './store';
+export { grDialogServiceConfig } from './config';
+export type { DialogAlertOptions, DialogBaseOptions, DialogCloseAction, DialogConfirmContext, DialogConfirmOptions, DialogErrorOptions, DialogKind, DialogOnConfirm, DialogPromise, DialogPromptOptions, DialogResult, DialogService, DialogServiceDefaults, } from './types';
+export type { GrDialogServiceHostProps } from './GrDialogServiceHost.vue';

package/dist/types/components/GrDropdownMenu/index.d.ts

@@ -0,0 +1,21 @@
+export { default } from './GrDropdownMenu.vue';
+export { default as GrDropdownMenu } from './GrDropdownMenu.vue';
+export { default as GrDropdownMenuColumn } from './GrDropdownMenuColumn.vue';
+export { default as GrDropdownMenuColumns } from './GrDropdownMenuColumns.vue';
+export { default as GrDropdownMenuDivider } from './GrDropdownMenuDivider.vue';
+export { default as GrDropdownMenuGroup } from './GrDropdownMenuGroup.vue';
+export { default as GrDropdownMenuHeader } from './GrDropdownMenuHeader.vue';
+export { default as GrDropdownMenuItem } from './GrDropdownMenuItem.vue';
+export { default as GrDropdownMenuList } from './GrDropdownMenuList.vue';
+export { grDropdownMenuConfig } from './config';
+export { grDropdownMenuSafelist } from './safelist';
+export type { GrDropdownMenuAction, GrDropdownMenuEntry, GrDropdownMenuSection, GrDropdownMenuSeparator, } from './menuModel';
+export type { GrDropdownMenuProps, } from './GrDropdownMenu.vue';
+export type { GrDropdownMenuColumnAlign, GrDropdownMenuColumnProps, } from './GrDropdownMenuColumn.vue';
+export type { GrDropdownMenuColumnsProps } from './GrDropdownMenuColumns.vue';
+export type { GrDropdownMenuDividerProps } from './GrDropdownMenuDivider.vue';
+export type { GrDropdownMenuGroupProps } from './GrDropdownMenuGroup.vue';
+export type { GrDropdownMenuHeaderAlign, GrDropdownMenuHeaderProps, } from './GrDropdownMenuHeader.vue';
+export type { GrDropdownMenuItemAlign, GrDropdownMenuItemProps, GrDropdownMenuItemRole, GrDropdownMenuItemVariant, } from './GrDropdownMenuItem.vue';
+export type { GrDropdownMenuListProps } from './GrDropdownMenuList.vue';
+export type { GrDropdownMenuEmits } from './GrDropdownMenu.vue';

package/dist/types/components/GrEmptyState/index.d.ts

@@ -0,0 +1,7 @@
+export { default } from './GrEmptyState.vue';
+export { default as GrEmptyState } from './GrEmptyState.vue';
+export type { GrEmptyStateProps } from './GrEmptyState.vue';
+export { grEmptyStateConfig } from './config';
+export type { GrEmptyStateConfigurableProps } from './defaults';
+export type { GrEmptyStateHeadingLevel, GrEmptyStateSize, GrEmptyStateVariant, } from './grEmptyStateStyles';
+export { grEmptyStateSafelist } from './safelist';

package/dist/types/components/GrFilePreview/GrFilePreview.vue.d.ts

@@ -0,0 +1,100 @@
+import { type Component } from 'vue';
+import type { GrSizeWithPx } from '../shared/sizes';
+import { type GrFilePreviewRatio } from './grFilePreviewStyles';
+export type { GrFileKind } from './fileKindOf';
+export type { GrFilePreviewRatio } from './grFilePreviewStyles';
+/**
+ * Плитка превью файла с фолбэком по типу.
+ *
+ * Показывает **сохранённый** файл, а не отправляет новый: отправка — это
+ * `GrFormFile` и `GrFileUpload`. Просмотрщик во весь экран открывает
+ * потребитель по событию `click`.
+ */
+export interface GrFilePreviewProps {
+    /** Адрес превью. Пусто — сразу заглушка по типу. */
+    src?: string | null;
+    /** MIME-тип. Он решает, картинка это или файл. */
+    mime?: string | null;
+    /** Имя файла: доступное имя картинки и подпись заглушки. */
+    name?: string | null;
+    /**
+     * Ступень канонической шкалы либо произвольная ширина в пикселях. Число —
+     * escape-hatch, как диаметр у GrAvatar: плитка 96px в ленте вложений в
+     * четыре ступени не укладывается.
+     */
+    tileSize?: GrSizeWithPx;
+    ratio?: GrFilePreviewRatio;
+    /** Ссылка на оригинал — для не-картинок и для перехода мимо просмотрщика. */
+    href?: string;
+    /** Свой корневой тег (`RouterLink`, `Link` от Inertia). Сильнее `href`. */
+    as?: string | Component;
+    /** Плитка кликабельна и эмитит `click` — обычно чтобы открыть просмотрщик. */
+    clickable?: boolean;
+    loading?: 'lazy' | 'eager';
+    /**
+     * Доступное имя интерактивной плитки. Не задано — имя приходит из содержимого:
+     * `alt` картинки или подписи заглушки.
+     */
+    ariaLabel?: string;
+}
+export interface GrFilePreviewEmits {
+    (e: 'click', event: MouseEvent): void;
+}
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFilePreviewProps>, {
+    src: undefined;
+    mime: undefined;
+    name: undefined;
+    tileSize: undefined;
+    ratio: undefined;
+    href: undefined;
+    as: undefined;
+    clickable: boolean;
+    loading: undefined;
+    ariaLabel: undefined;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: MouseEvent) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFilePreviewProps>, {
+    src: undefined;
+    mime: undefined;
+    name: undefined;
+    tileSize: undefined;
+    ratio: undefined;
+    href: undefined;
+    as: undefined;
+    clickable: boolean;
+    loading: undefined;
+    ariaLabel: undefined;
+}>>> & Readonly<{
+    onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    tileSize: GrSizeWithPx;
+    ratio: GrFilePreviewRatio;
+    loading: "lazy" | "eager";
+    name: string | null;
+    href: string;
+    ariaLabel: string;
+    src: string | null;
+    as: string | Component;
+    clickable: boolean;
+    mime: string | null;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

package/dist/types/components/GrFilePreview/config.d.ts

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

package/dist/types/components/GrFilePreview/defaults.d.ts

@@ -0,0 +1,20 @@
+import type { GrSizeWithPx } from '../shared/sizes';
+import type { GrFilePreviewRatio } from './grFilePreviewStyles';
+/**
+ * Пропы `GrFilePreview`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrFilePreview: { … } }">`.
+ *
+ * Только оформление: `src`, `mime` и `name` принадлежат файлу. Размер и
+ * пропорции здесь потому, что лента вложений выглядит одинаково на всех
+ * страницах, и повторять решение у каждой плитки значит однажды разойтись.
+ */
+export interface GrFilePreviewConfigurableProps {
+    tileSize: GrSizeWithPx;
+    ratio: GrFilePreviewRatio;
+    loading: 'lazy' | 'eager';
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrFilePreview: GrFilePreviewConfigurableProps;
+    }
+}

package/dist/types/components/GrFilePreview/fileKindOf.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Вид файла по MIME-типу.
+ *
+ * Тип решает **`mime`, а не расширение**: расширение врёт (`.dat` у выгрузки,
+ * `.pdf` у переименованного архива), а бэкенд отдаёт настоящий тип — брать надо
+ * его. От вида зависит единственное решение компонента: рисовать `<img>` или
+ * иконку.
+ */
+export type GrFileKind = 'image' | 'pdf' | 'document' | 'spreadsheet' | 'archive'
+/** Тип не опознан, пуст или это `application/octet-stream`. */
+ | 'unknown';
+export declare function fileKindOf(mime: string | null | undefined): GrFileKind;
+/** Картинку показываем, остальное — подписываем иконкой. */
+export declare function isPreviewableKind(kind: GrFileKind): boolean;

package/dist/types/components/GrFilePreview/grFilePreviewStyles.d.ts

@@ -0,0 +1,37 @@
+import type { GrComponentSize } from '../shared/sizes';
+/**
+ * Классы `GrFilePreview`.
+ *
+ * Ступени размера перечислены целиком, по литералу на ветку: UnoCSS сканирует
+ * исходный текст файла, и собранное шаблонной строкой имя уехало бы в CSS
+ * литералом.
+ */
+/** Соотношение сторон плитки. */
+export type GrFilePreviewRatio = '1:1' | '4:3' | '16:9';
+/** `relative` — точка отсчёта для картинки, ждущей загрузки вне потока. */
+export declare const filePreviewRootClass = "relative inline-flex overflow-hidden rounded-[var(--gr-file-preview-radius,var(--gr-radius-md))] bg-[var(--gr-file-preview-bg,var(--gr-muted))]";
+/** Интерактивная плитка получает курсор и кольцо фокуса — как любой контрол. */
+export declare const filePreviewInteractiveClass = "cursor-pointer transition-colors duration-[var(--gr-duration-fast)] hover:bg-[var(--gr-secondary)] focus:outline-none focus-visible:ring-2 focus-visible:ring-[var(--gr-ring)]";
+/**
+ * Ширина плитки по канонической шкале: высоту задаёт соотношение сторон.
+ * Своего кортежа размеров компонент не заводит — иначе `GrConfigProvider`
+ * перестал бы до него доставать (гейт `sizeScale.test.ts`).
+ */
+export declare const filePreviewTileWidths: Record<GrComponentSize, string>;
+/**
+ * Соотношение сторон держит место до загрузки: без него ряд плиток прыгает,
+ * когда картинки доезжают вразнобой.
+ */
+export declare const filePreviewRatioClass: Record<GrFilePreviewRatio, string>;
+export declare const filePreviewMediaClass = "h-full w-full object-cover";
+/**
+ * Картинка на время загрузки: `visibility`, а не `display`, — иначе браузер
+ * отменил бы саму загрузку. Вне потока, чтобы скелет занял плитку целиком, а
+ * не поделил её с картинкой как второй flex-элемент.
+ */
+export declare const filePreviewMediaLoadingClass = "invisible absolute";
+/** Заглушка: иконка по центру, подпись под ней. */
+export declare const filePreviewFallbackClass = "h-full w-full flex flex-col items-center justify-center gap-1 p-1 text-center text-[var(--gr-file-preview-icon,var(--gr-muted-fg))]";
+export declare const filePreviewIconClass = "block h-6 w-6 shrink-0";
+/** Подпись под иконкой: имя файла в одну строку. */
+export declare const filePreviewLabelClass = "w-full truncate text-[length:var(--gr-control-text-3xs)] leading-[var(--gr-leading-xs)]";

package/dist/types/components/GrFilePreview/index.d.ts

@@ -0,0 +1,6 @@
+export { default } from './GrFilePreview.vue';
+export { default as GrFilePreview } from './GrFilePreview.vue';
+export { grFilePreviewConfig } from './config';
+export type { GrFileKind, GrFilePreviewEmits, GrFilePreviewProps, GrFilePreviewRatio, } from './GrFilePreview.vue';
+export type { GrFilePreviewConfigurableProps } from './defaults';
+export { grFilePreviewSafelist } from './safelist';

package/dist/types/components/GrFilePreview/safelist.d.ts

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

package/dist/types/components/GrFileUpload/index.d.ts

@@ -0,0 +1,17 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrFileUploadComponent from './GrFileUpload.vue';
+export { default } from './GrFileUpload.vue';
+export { default as GrFileUpload } from './GrFileUpload.vue';
+export type { GrFileUploadExtraData, GrFileUploadExtraDataValue, GrFileUploadMode, GrFileUploadProps, GrFileUploadRequest, GrFileUploadRequestCtx, } from './GrFileUpload.vue';
+export type { GrFileUploadEntry, GrFileUploadStatus } from './fileEntry';
+export { grFileUploadConfig } from './config';
+export type { GrFileUploadConfigurableProps } from './defaults';
+export type { GrFileUploadSize } from './grFileUploadStyles';
+export { grFileUploadSafelist } from './safelist';
+export type { GrUploadProgressInfo } from './uploadViaXhr';
+export { GrUploadAbortError, GrUploadHttpError } from './uploadViaXhr';
+export type { GrUploadPhase, GrUploadState, GrUploadStateError, GrUploadStateIdle, GrUploadStateSuccess, GrUploadStateUploading, } from './uploadState';
+export type { FileValidator, FileValidatorSource } from '../../fileValidation';
+export { FileValidationError } from '../../fileValidation';
+export type { GrFileUploadEmits } from './GrFileUpload.vue';
+export type GrFileUploadInstance = ComponentExposed<typeof GrFileUploadComponent>;

package/dist/types/components/GrForm/GrForm.vue.d.ts

@@ -0,0 +1,90 @@
+import { type GrFormRules, type GrFormTrigger } from './validation';
+export type { GrFormFileRule, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './validation';
+/**
+ * Публичный GR-примитив «Form» — оркестрация валидации над `GrFormField`.
+ *
+ * Модель формы (`v-model`-объект приложения) + декларативные `rules` по имени поля.
+ * Форма прогоняет правила, раскладывает ошибки по контексту, скроллит к первой
+ * ошибке и эмитит `submit` только при валидной форме. Императивный API — через
+ * template ref (`validate` / `validateField` / `clearValidate` / `resetFields` /
+ * `scrollToField`).
+ */
+export interface GrFormProps<TModel extends object = Record<string, unknown>> {
+    /**
+     * Реактивный объект данных формы. Поля адресуются по `name` (`GrFormField`),
+     * в т.ч. dot-path.
+     *
+     * Тип дженерик, а не `Record<string, unknown>`: моделью бывает объект чужой
+     * библиотеки (`useForm` Inertia, стор), у которого рядом с полями лежат
+     * собственные методы. Под словарь он не подходит, и потребителю пришлось бы
+     * приводить его через `as unknown as` в каждой форме.
+     */
+    model: TModel;
+    /** Правила валидации по имени поля: `{ email: [{ required: true, type: 'email' }] }`. */
+    rules?: GrFormRules;
+    /** Валидировать поле при потере фокуса. */
+    validateOnBlur?: boolean;
+    /** Валидировать поле при каждом изменении значения. */
+    validateOnChange?: boolean;
+    /** Скроллить к первому невалидному полю после `validate()`. */
+    scrollToError?: boolean;
+    scrollBehavior?: ScrollBehavior;
+    /**
+     * Выключить форму целиком — типично на время отправки. Доезжает до контролов
+     * через контекст поля, поэтому обходить их по одному не нужно.
+     */
+    disabled?: boolean;
+}
+export interface GrFormEmits<TModel extends object = Record<string, unknown>> {
+    /** Форма прошла валидацию по submit. Отдаёт `model`. */
+    (e: 'submit', model: TModel): void;
+    /** Результат валидации одного поля. */
+    (e: 'validate', name: string, valid: boolean, message: string | undefined): void;
+    /**
+     * Submit не прошёл валидацию. Без этого события «форма невалидна» и «ничего
+     * не произошло» выглядят для потребителя одинаково.
+     */
+    (e: 'invalid', errors: Record<string, string>): void;
+}
+declare const __VLS_export: <TModel extends object = Record<string, 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<GrFormProps<TModel> & {
+        onSubmit?: ((model: TModel) => any) | undefined;
+        onInvalid?: ((errors: Record<string, string>) => any) | undefined;
+        onValidate?: ((name: string, valid: boolean, message: string | undefined) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        validate: () => Promise<boolean>;
+        validateField: (name: string, trigger?: GrFormTrigger) => Promise<boolean>;
+        clearValidate: (names?: string | string[]) => void;
+        resetFields: (names?: string | string[]) => void;
+        scrollToField: (name: string) => void;
+        setSnapshot: (model?: Record<string, unknown>) => void;
+        isDirty: import("vue").ComputedRef<boolean>;
+        isValid: import("vue").ComputedRef<boolean>;
+        validatingFields: import("vue").ComputedRef<Set<string> & Omit<Set<string>, keyof Set<any>>>;
+    }>) => void;
+    attrs: any;
+    slots: {
+        default?: (props: {
+            validate: () => Promise<boolean>;
+            errors: Record<string, string | undefined>;
+            isDirty: boolean;
+            isValid: boolean;
+            validatingFields: Set<string> & Omit<Set<string>, keyof Set<any>>;
+            resetFields: (names?: string | string[]) => void;
+            setSnapshot: (model?: Record<string, unknown>) => void;
+        }) => any;
+    };
+    emit: GrFormEmits<TModel>;
+}>) => 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/components/GrForm/index.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentExposed } from '../shared/instance';
+import type GrFormComponent from './GrForm.vue';
+export { default } from './GrForm.vue';
+export { default as GrForm } from './GrForm.vue';
+export { grFormConfig } from './config';
+export { type GrFormContext, useGrFormContext } from './context';
+export type { GrFormFileRule, GrFormProps, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './GrForm.vue';
+export { createGrFormMessageResolver, type GrFormMessageResolver, type GrFormMessageTranslate, type GrFormRuleFailure, runFieldRules, } from './validation';
+export type { GrFormEmits } from './GrForm.vue';
+export type GrFormInstance = ComponentExposed<typeof GrFormComponent>;