@feugene/granularity 0.12.0 → 0.16.0

package/dist/types/src/components/GrEmptyState/grEmptyStateStyles.d.ts

@@ -0,0 +1,32 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrEmptyStateSize = GrComponentSize;
+/** Поверхность карточки. `ghost` — для встраивания в уже существующую карточку. */
+export declare const GR_EMPTY_STATE_VARIANTS: readonly ["outlined", "ghost"];
+export type GrEmptyStateVariant = typeof GR_EMPTY_STATE_VARIANTS[number];
+/**
+ * Уровень заголовка. `h1` намеренно нет: пустое состояние живёт внутри уже
+ * существующей структуры страницы, а не задаёт её.
+ */
+export declare const GR_EMPTY_STATE_HEADING_LEVELS: readonly [2, 3, 4, 5, 6];
+export type GrEmptyStateHeadingLevel = typeof GR_EMPTY_STATE_HEADING_LEVELS[number];
+export declare const rootBaseClass = "text-center";
+export declare const variantClass: Record<GrEmptyStateVariant, string>;
+export declare const rootPaddingBySize: Record<GrEmptyStateSize, string>;
+export declare const iconBoxBaseClass = "flex items-center justify-center border border-[var(--gr-brd)] bg-[var(--gr-muted)] text-[var(--gr-muted-fg)]";
+export declare const iconBoxBySize: Record<GrEmptyStateSize, string>;
+/** Размер самой иконки в пикселях — `GrIcon` принимает число. */
+export declare const iconSizeBySize: Record<GrEmptyStateSize, number>;
+/**
+ * `mb-0` гасит браузерный отступ снизу у настоящего заголовка: без сброса
+ * карточка разъезжается по вертикали.
+ */
+export declare const titleBaseClass = "mb-0 font-700";
+export declare const titleBySize: Record<GrEmptyStateSize, string>;
+export declare const descriptionBaseClass = "text-[var(--gr-muted-fg)]";
+export declare const descriptionBySize: Record<GrEmptyStateSize, string>;
+export declare const actionsBaseClass = "flex justify-center";
+export declare const actionsBySize: Record<GrEmptyStateSize, string>;
+export declare function grEmptyStateRootClass(options: {
+    variant: GrEmptyStateVariant;
+    size: GrEmptyStateSize;
+}): string;

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

@@ -2,3 +2,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 { GR_EMPTY_STATE_HEADING_LEVELS, GR_EMPTY_STATE_VARIANTS } from './grEmptyStateStyles';
+export type { GrEmptyStateHeadingLevel, GrEmptyStateSize, GrEmptyStateVariant, } from './grEmptyStateStyles';
+export { grEmptyStateSafelist } from './safelist';

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

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

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

@@ -2,6 +2,9 @@ import type { GrProgressBarTone } from '../GrProgressBar/grStyle';
 import type { FileValidator, FileValidatorSource } from '../../fileValidation';
 import type { GrUploadProgressInfo } from './uploadViaXhr';
 import type { GrUploadState } from './uploadState';
+import { type GrFileUploadEntry } from './fileEntry';
+import { type GrFileUploadSize } from './grFileUploadStyles';
+export type GrFileUploadMode = 'batch' | 'per-file';
 export type GrFileUploadExtraDataValue = string | Blob;
 export type GrFileUploadExtraData = Record<string, GrFileUploadExtraDataValue | GrFileUploadExtraDataValue[]>;
 export type GrFileUploadRequestCtx = {
@@ -14,7 +17,7 @@ export type GrFileUploadRequestCtx = {
      */
     onProgress?: (info: GrUploadProgressInfo) => void;
 };
-export type GrFileUploadRequest = (files: File[], ctx: GrFileUploadRequestCtx) => Promise<any>;
+export type GrFileUploadRequest<TResponse = unknown> = (files: File[], ctx: GrFileUploadRequestCtx) => Promise<TResponse>;
 /**
  * Пропы `GrFileUpload`.
  *
@@ -23,16 +26,48 @@ export type GrFileUploadRequest = (files: File[], ctx: GrFileUploadRequestCtx) =
  *
  * `placeholder` — надпись в дефолтном UI-варианте (без слота default).
  */
-export interface GrFileUploadProps {
+export interface GrFileUploadProps<TResponse = unknown> {
+    /**
+     * Набор файлов — тот, что показан в списке и уйдёт в `retry`.
+     *
+     * Проп **необязателен**: без него компонент держит набор сам. Передан —
+     * набор следует за ним, и потребитель может очистить или подменить список
+     * снаружи.
+     */
+    modelValue?: File[];
     action?: string;
-    request?: GrFileUploadRequest;
+    request?: GrFileUploadRequest<TResponse>;
     name?: string;
     multiple?: boolean;
     limit?: number;
-    onExceed?: (files: File[], limit: number) => void;
+    /**
+     * Guard перед отправкой. Остаётся пропом, а не эмитом, осознанно: эмит не
+     * возвращает значения, а этот колбэк обязан ответить «пускать или нет».
+     * Уведомления — `exceed`, `success`, `error`, `progress` — эмиты.
+     */
     beforeUpload?: (file: File) => boolean | Promise<unknown>;
     validators?: FileValidator[];
+    /**
+     * W3C `accept` для `<input type="file">` — и sugar к `acceptValidator(...)`.
+     *
+     * Только атрибута мало: он фильтрует системный диалог, но не drag&drop —
+     * перетащить можно что угодно. Поэтому то же значение уходит и в валидаторы,
+     * как в `GrFormFile`.
+     */
+    accept?: string;
+    /** `capture` для мобильной камеры/микрофона. */
+    capture?: 'user' | 'environment';
+    /** Выбор каталога целиком (`webkitdirectory`). Поддержка — Chromium и Safari. */
+    directory?: boolean;
     disabled?: boolean;
+    /** Только для чтения: значение видно и уходит в форму, но не редактируется. */
+    readonly?: boolean;
+    /** Визуальное и ARIA-состояние ошибки. */
+    invalid?: boolean;
+    /** Обязательное поле (`aria-required`). */
+    required?: boolean;
+    /** Доступное имя вне `GrFormField`. */
+    ariaLabel?: string;
     headers?: Record<string, string>;
     withCredentials?: boolean;
     showFileList?: boolean;
@@ -47,154 +82,129 @@ export interface GrFileUploadProps {
     progressLabel?: string;
     /** Через сколько мс после `success` скрыть прогресс-бар. `0` — не скрывать. */
     hideProgressOnSuccess?: number;
+    /** Размер дефолтного UI: поля дроп-зоны, плитка иконки, кегль подписей. */
+    size?: GrFileUploadSize;
+    /**
+     * Как уходит набор файлов:
+     *
+     * - `batch` (по умолчанию) — весь набор одним запросом. Про отдельный файл
+     *   сказать нечего, поэтому и статуса у него нет;
+     * - `per-file` — на каждый файл свой запрос (`request` зовётся с массивом из
+     *   одного файла, контракт не меняется). Появляются статус и процент строки,
+     *   `retryFile` и `abortFile`.
+     */
+    uploadMode?: GrFileUploadMode;
+    /** Сколько файлов грузится одновременно в режиме `per-file`. */
+    concurrency?: number;
+    /** Миниатюры для `image/*` в списке файлов. */
+    preview?: boolean;
 }
-declare function openDialog(): void;
-declare function abort(): void;
-declare function handleFiles(files: File[], source?: FileValidatorSource): Promise<void>;
-declare var __VLS_1: {
-    openDialog: typeof openDialog;
-    abort: typeof abort;
-    disabled: boolean;
-    files: {
-        readonly lastModified: number;
-        readonly name: string;
-        readonly webkitRelativePath: string;
-        readonly size: number;
-        readonly type: string;
-        arrayBuffer: () => Promise<ArrayBuffer>;
-        bytes: () => Promise<Uint8Array<ArrayBuffer>>;
-        slice: (start?: number, end?: number, contentType?: string) => Blob;
-        stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
-        text: () => Promise<string>;
-    }[];
-    isOver: boolean;
-    state: GrUploadState;
-}, __VLS_14: {}, __VLS_16: {}, __VLS_18: {}, __VLS_20: {
-    state: GrUploadState;
-    percent: number;
-    indeterminate: boolean;
-    phase: "success" | "error" | "idle" | "uploading";
-    files: {
-        readonly lastModified: number;
-        readonly name: string;
-        readonly webkitRelativePath: string;
-        readonly size: number;
-        readonly type: string;
-        arrayBuffer: () => Promise<ArrayBuffer>;
-        bytes: () => Promise<Uint8Array<ArrayBuffer>>;
-        slice: (start?: number, end?: number, contentType?: string) => Blob;
-        stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
-        text: () => Promise<string>;
-    }[];
-    abort: typeof abort;
-};
-type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_1) => any;
-} & {
-    label?: (props: typeof __VLS_14) => any;
-} & {
-    default?: (props: typeof __VLS_16) => any;
-} & {
-    tip?: (props: typeof __VLS_18) => any;
-} & {
-    progress?: (props: typeof __VLS_20) => any;
+export interface GrFileUploadEmits<TResponse = unknown> {
+    /** Набор файлов сменился: новый выбор или удаление. Не путать с `change`. */
+    (e: 'update:modelValue', files: File[]): void;
+    /** Выбрано больше файлов, чем разрешает `limit`. Загрузка не стартует. */
+    (e: 'exceed', files: File[], limit: number): void;
+    /** `file` приходит только в режиме `per-file`: в батче отчитываться нечем. */
+    (e: 'success', payload: TResponse, file?: File): void;
+    (e: 'error', error: unknown, file?: File): void;
+    (e: 'progress', percent: number, info?: GrUploadProgressInfo, file?: File): void;
+    (e: 'change', files: File[]): void;
+    (e: 'stateChange', state: GrUploadState): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+declare const __VLS_export: <TResponse = 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<GrFileUploadProps<TResponse> & {
+        onSuccess?: ((payload: TResponse, file?: File | undefined) => any) | undefined;
+        onProgress?: ((percent: number, info?: GrUploadProgressInfo | undefined, file?: File | undefined) => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((files: File[]) => any) | undefined;
+        onError?: ((error: unknown, file?: File | undefined) => any) | undefined;
+        onFocus?: ((event: FocusEvent) => any) | undefined;
+        "onUpdate:modelValue"?: ((files: File[]) => any) | undefined;
+        onExceed?: ((files: File[], limit: number) => any) | undefined;
+        onStateChange?: ((state: GrUploadState) => any) | undefined;
+    }> & (typeof globalThis extends {
+        __VLS_PROPS_FALLBACK: infer P;
+    } ? P : {});
+    expose: (exposed: import("vue").ShallowUnwrapRef<{
+        focus: () => void;
+        blur: () => void;
+        uploadFiles: (files: File[], source?: FileValidatorSource) => Promise<void>;
+        abort: () => void;
+        openDialog: () => void;
+        state: GrUploadState;
+        /** Текущий набор файлов — тот, что показан в списке и уйдёт в `retry`. */
+        files: import("vue").Ref<{
+            readonly lastModified: number;
+            readonly name: string;
+            readonly webkitRelativePath: string;
+            readonly size: number;
+            readonly type: string;
+            arrayBuffer: () => Promise<ArrayBuffer>;
+            bytes: () => Promise<Uint8Array<ArrayBuffer>>;
+            slice: (start?: number, end?: number, contentType?: string) => Blob;
+            stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
+            text: () => Promise<string>;
+        }[], File[] | {
+            readonly lastModified: number;
+            readonly name: string;
+            readonly webkitRelativePath: string;
+            readonly size: number;
+            readonly type: string;
+            arrayBuffer: () => Promise<ArrayBuffer>;
+            bytes: () => Promise<Uint8Array<ArrayBuffer>>;
+            slice: (start?: number, end?: number, contentType?: string) => Blob;
+            stream: () => ReadableStream<Uint8Array<ArrayBuffer>>;
+            text: () => Promise<string>;
+        }[]>;
+        retry: () => Promise<void>;
+        removeFile: (file: File) => void;
+        /** Записи по файлам — пусты в батчевом режиме. */
+        fileEntries: import("vue").Ref<GrFileUploadEntry[], GrFileUploadEntry[]>;
+        retryFile: (file: File) => Promise<void>;
+        abortFile: (file: File) => void;
+    }>) => void;
+    attrs: any;
+    slots: {
+        /** Полностью своя зона загрузки: контрол отдаёт наружу всё своё состояние. */
+        default?: (props: {
+            openDialog: () => void;
+            abort: () => void;
+            disabled: boolean;
+            files: File[];
+            isOver: boolean;
+            state: GrUploadState;
+            retry: () => Promise<void>;
+            removeFile: (file: File) => void;
+            fileEntries: GrFileUploadEntry[];
+            retryFile: (file: File) => Promise<void>;
+            abortFile: (file: File) => void;
+        }) => any;
+        /** Заголовок зоны вместо `placeholder`. */
+        label?: () => any;
+        /** Подпись под заголовком: ограничения по типу и размеру. */
+        tip?: () => any;
+        /** Свой индикатор прогресса вместо встроенного. */
+        progress?: (props: {
+            state: GrUploadState;
+            percent: number;
+            indeterminate: boolean;
+            phase: GrUploadState["phase"];
+            files: File[];
+            abort: () => void;
+            retry: () => Promise<void>;
+            fileEntries: GrFileUploadEntry[];
+            retryFile: (file: File) => Promise<void>;
+            abortFile: (file: File) => void;
+        }) => any;
+    };
+    emit: GrFileUploadEmits<TResponse>;
+}>) => import("vue").VNode & {
+    __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFileUploadProps>, {
-    action: undefined;
-    request: undefined;
-    name: string;
-    multiple: boolean;
-    limit: undefined;
-    onExceed: undefined;
-    beforeUpload: undefined;
-    validators: undefined;
-    disabled: boolean;
-    headers: undefined;
-    withCredentials: boolean;
-    showFileList: boolean;
-    uploadExtraData: undefined;
-    placeholder: undefined;
-    showProgress: boolean;
-    progressTone: string;
-    progressLabel: undefined;
-    hideProgressOnSuccess: number;
-}>>, {
-    uploadFiles: typeof handleFiles;
-    abort: typeof abort;
-    openDialog: typeof openDialog;
-    state: GrUploadState;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    success: (payload: any) => void;
-    error: (error: unknown) => void;
-    progress: (percent: number, info?: GrUploadProgressInfo | undefined) => void;
-    change: (files: File[]) => void;
-    stateChange: (state: GrUploadState) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFileUploadProps>, {
-    action: undefined;
-    request: undefined;
-    name: string;
-    multiple: boolean;
-    limit: undefined;
-    onExceed: undefined;
-    beforeUpload: undefined;
-    validators: undefined;
-    disabled: boolean;
-    headers: undefined;
-    withCredentials: boolean;
-    showFileList: boolean;
-    uploadExtraData: undefined;
-    placeholder: undefined;
-    showProgress: boolean;
-    progressTone: string;
-    progressLabel: undefined;
-    hideProgressOnSuccess: number;
-}>>> & Readonly<{
-    onSuccess?: ((payload: any) => any) | undefined;
-    onProgress?: ((percent: number, info?: GrUploadProgressInfo | undefined) => any) | undefined;
-    onChange?: ((files: File[]) => any) | undefined;
-    onError?: ((error: unknown) => any) | undefined;
-    onStateChange?: ((state: GrUploadState) => any) | undefined;
-}>, {
-    disabled: boolean;
-    name: string;
-    headers: Record<string, string>;
-    placeholder: string;
-    multiple: boolean;
-    withCredentials: boolean;
-    action: string;
-    request: GrFileUploadRequest;
-    limit: number;
-    onExceed: (files: File[], limit: number) => void;
-    beforeUpload: (file: File) => boolean | Promise<unknown>;
-    validators: FileValidator[];
-    showFileList: boolean;
-    uploadExtraData: (files: File[]) => GrFileUploadExtraData | undefined;
-    showProgress: boolean;
-    progressTone: GrProgressBarTone;
-    progressLabel: string;
-    hideProgressOnSuccess: 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];
 } : {

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

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

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

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

package/dist/types/src/components/GrFileUpload/fileEntry.d.ts

@@ -0,0 +1,26 @@
+import type { GrUploadState } from './uploadState';
+/**
+ * Состояние одного файла в пофайловом режиме (`uploadMode="per-file"`).
+ *
+ * Батчевый режим по-прежнему знает только сводное `GrUploadState`: весь набор
+ * уходит одним запросом, и говорить про отдельный файл там нечем.
+ */
+export type GrFileUploadStatus = 'pending' | 'uploading' | 'success' | 'error';
+export interface GrFileUploadEntry {
+    file: File;
+    status: GrFileUploadStatus;
+    /** Процент `0..100`. У `pending` — 0, у `success` — 100. */
+    percent: number;
+    /** Причина ошибки, если `status === 'error'`. */
+    error?: unknown;
+}
+export declare function createFileEntry(file: File): GrFileUploadEntry;
+/**
+ * Сводное состояние набора: грузимся, пока грузится хоть один; ошибка, если
+ * после завершения есть хоть одна; успех — когда успешны все.
+ *
+ * Процент — среднее по файлам, а не по байтам: у пофайловых запросов размеры
+ * разные, и «взвешенная» полоса дёргалась бы назад, когда большой файл
+ * стартует после маленького.
+ */
+export declare function summarizeFileEntries(entries: GrFileUploadEntry[]): GrUploadState;

package/dist/types/src/components/GrFileUpload/grFileUploadStyles.d.ts

@@ -0,0 +1,45 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrFileUploadSize = GrComponentSize;
+/** Поля дроп-зоны в дефолтном UI (в custom-UI зону рисует слот). */
+export declare const zonePaddings: Record<GrFileUploadSize, string>;
+/** Плитка с иконкой слева от подписи. */
+export declare const iconTileSizes: Record<GrFileUploadSize, string>;
+/**
+ * Глиф в плитке задаётся пикселями, а не шкалой `GrIcon`: та упирается в 20px,
+ * а плитке нужны 24px на `md`. Явное значение обязательно — без него иконка
+ * читала бы размер прямо из `GrConfigProvider` и разъезжалась с самой зоной,
+ * когда размер задан точечно через `componentDefaults`.
+ */
+export declare const iconGlyphSizes: Record<GrFileUploadSize, number>;
+/**
+ * Ступени кегля берутся из шкалы и потому местами совпадают: разница в 1px не
+ * воспринимается, а размер компонента несут падинги, гапы и глиф — они остаются
+ * четырёхступенчатыми.
+ */
+export declare const labelSizes: Record<GrFileUploadSize, string>;
+/** Подсказка, список файлов и текст прогресса — мельче основной подписи. */
+export declare const hintSizes: Record<GrFileUploadSize, string>;
+export declare const progressTextSizes: Record<GrFileUploadSize, string>;
+export declare const zoneGaps: Record<GrFileUploadSize, string>;
+/** Полоса прогресса берёт толщину из шкалы `GrProgressBar`. */
+export declare const progressBarSizes: Record<GrFileUploadSize, GrComponentSize>;
+export declare const zoneBaseClass = "relative w-full rounded-[var(--gr-radius-lg)] border border-dashed border-[var(--gr-brd)] outline-none transition";
+/**
+ * Недоступная зона гасится фоном, а не `opacity`: прозрачность разбавляет
+ * выверенные на AA токены текста и роняет контраст.
+ */
+export declare const zoneDisabledClass = "bg-[var(--gr-muted)] cursor-not-allowed";
+/**
+ * `readonly` — не `disabled`: набор виден и уходит в форму, поэтому контраст
+ * остаётся обычным. Меняется только приглашение к вводу — курсор и ховер.
+ */
+export declare const zoneReadonlyClass = "bg-[var(--gr-card)] cursor-default focus-within:ring-2 focus-within:ring-[var(--gr-ring)] focus-within:ring-offset-2 focus-within:ring-offset-[var(--gr-bg)]";
+export declare const zoneIdleClass = "bg-[var(--gr-card)] cursor-pointer hover:bg-[var(--gr-muted)] focus-within:ring-2 focus-within:ring-[var(--gr-ring)] focus-within:ring-offset-2 focus-within:ring-offset-[var(--gr-bg)]";
+/** Файл над зоной: подсветка появляется только там, где drop реально примут. */
+export declare const zoneOverClass = "border-[var(--gr-ring)] bg-[var(--gr-muted)]";
+export declare function grFileUploadZoneClass(options: {
+    size: GrFileUploadSize;
+    disabled: boolean;
+    readonly: boolean;
+    over: boolean;
+}): string;

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

@@ -1,9 +1,18 @@
+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, GrFileUploadProps, GrFileUploadRequest, GrFileUploadRequestCtx, } from './GrFileUpload.vue';
+export type { GrFileUploadExtraData, GrFileUploadExtraDataValue, GrFileUploadMode, GrFileUploadProps, GrFileUploadRequest, GrFileUploadRequestCtx, } from './GrFileUpload.vue';
+export type { GrFileUploadEntry, GrFileUploadStatus } from './fileEntry';
+export { createFileEntry, summarizeFileEntries } 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 { GR_UPLOAD_STATE_IDLE } from './uploadState';
 export * from '../../fileValidation';
+export type { GrFileUploadEmits } from './GrFileUpload.vue';
+export type GrFileUploadInstance = ComponentExposed<typeof GrFileUploadComponent>;

package/dist/types/src/components/GrFileUpload/maxFileSize.d.ts

@@ -0,0 +1,2 @@
+export { maxFileSize } from '../../fileValidation';
+export type { MaxFileSizeOptions } from '../../fileValidation';

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

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

package/dist/types/src/components/GrFileUpload/useDropZone.d.ts

@@ -0,0 +1,24 @@
+import { type Ref } from 'vue';
+export interface UseDropZoneOptions {
+    /** Зона выключена: ввод не принимается (`disabled` или `readonly`). */
+    locked: () => boolean;
+    /** UI рисует слот — зона перестаёт быть зоной, обработка уезжает к нему. */
+    inactive: () => boolean;
+    onDrop: (files: File[]) => void;
+}
+export interface UseDropZoneReturn {
+    /** Файл висит над зоной. */
+    isOver: Ref<boolean>;
+    onDragEnter: (event: DragEvent) => void;
+    onDragOver: (event: DragEvent) => void;
+    onDragLeave: (event: DragEvent) => void;
+    onDropFiles: (event: DragEvent) => void;
+}
+/**
+ * Drag&drop поверх зоны.
+ *
+ * Счётчик входов, а не флаг: `dragenter`/`dragleave` приходят и от вложенных
+ * элементов, и без счётчика подсветка гасла, стоило курсору пересечь границу
+ * подписи внутри зоны.
+ */
+export declare function useDropZone(options: UseDropZoneOptions): UseDropZoneReturn;

package/dist/types/src/components/GrFileUpload/usePerFileUpload.d.ts

@@ -0,0 +1,38 @@
+import { type Ref } from 'vue';
+import { type GrFileUploadEntry } from './fileEntry';
+import type { GrUploadState } from './uploadState';
+import { type GrUploadProgressInfo } from './uploadViaXhr';
+export interface UsePerFileUploadOptions {
+    /** Сколько файлов грузится одновременно. */
+    concurrency: () => number;
+    /** Отправка одного файла. Контракт тот же, что у батча: всегда массив. */
+    send: (files: File[], ctx: {
+        signal: AbortSignal;
+        onProgress: (info: GrUploadProgressInfo) => void;
+    }) => Promise<unknown>;
+    /** Сводное состояние пересчитывается из записей по файлам. */
+    onSummary: (state: GrUploadState) => void;
+    onProgress: (info: GrUploadProgressInfo, file: File) => void;
+    onSuccess: (payload: unknown, file: File) => void;
+    onError: (error: unknown, file: File) => void;
+    onSetChange: (files: File[]) => void;
+}
+export interface UsePerFileUploadReturn {
+    entries: Ref<GrFileUploadEntry[]>;
+    entryOf: (file: File) => GrFileUploadEntry | undefined;
+    /** Загрузить набор пофайлово: у каждого файла свой запрос и свой статус. */
+    run: (files: File[]) => Promise<void>;
+    /** Повторить один файл — соседей это не касается. */
+    retryFile: (file: File) => Promise<void>;
+    /** Оборвать загрузку одного файла. */
+    abortFile: (file: File) => void;
+    abortAll: () => void;
+    /** Убрать файл из набора записей и пересчитать сводное состояние. */
+    dropEntry: (file: File) => void;
+    reset: () => void;
+}
+/**
+ * Пофайловый режим: у каждого файла свой запрос, свой контроллер и свой статус,
+ * а сводное состояние выводится из них.
+ */
+export declare function usePerFileUpload(options: UsePerFileUploadOptions): UsePerFileUploadReturn;

package/dist/types/src/components/GrFileUpload/useUploadState.d.ts

@@ -0,0 +1,30 @@
+import { type GrUploadState } from './uploadState';
+import type { GrUploadProgressInfo } from './uploadViaXhr';
+export interface UseUploadStateOptions {
+    /** Компонент отчитывается о каждой смене фазы наружу. */
+    onChange: (state: GrUploadState) => void;
+}
+export interface UseUploadStateReturn {
+    state: GrUploadState;
+    setIdle: () => void;
+    setUploading: (info?: GrUploadProgressInfo) => void;
+    setSuccess: (info: {
+        loaded: number;
+        total: number;
+    }) => void;
+    setError: (error: unknown) => void;
+    /** Прогресс не двигает состояние вне фазы `uploading`. */
+    applyProgress: (info: GrUploadProgressInfo) => void;
+    assign: (next: GrUploadState) => void;
+    /** Отложенный переход `success` → `idle`. */
+    scheduleIdle: (delayMs: number) => void;
+    clearScheduledIdle: () => void;
+}
+/**
+ * Сводное состояние загрузки: фаза, проценты и таймер скрытия успеха.
+ *
+ * Состояние — `reactive`-объект с меняющейся формой (у `error` есть поле
+ * `error`, у `idle` его нет), поэтому при смене фазы старые ключи удаляются:
+ * иначе `phase: 'idle'` тащил бы за собой `error` от прошлой попытки.
+ */
+export declare function useUploadState(options: UseUploadStateOptions): UseUploadStateReturn;