@feugene/granularity 0.13.0 → 0.18.0

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

@@ -1,5 +1,5 @@
 import { type GrFormRules, type GrFormTrigger } from './validation';
-export type { GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './validation';
+export type { GrFormFileRule, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './validation';
 /**
  * Публичный GR-примитив «Form» — оркестрация валидации над `GrFormField`.
  *
@@ -21,15 +21,42 @@ export interface GrFormProps {
     /** Скроллить к первому невалидному полю после `validate()`. */
     scrollToError?: boolean;
     scrollBehavior?: ScrollBehavior;
+    /**
+     * Выключить форму целиком — типично на время отправки. Доезжает до контролов
+     * через контекст поля, поэтому обходить их по одному не нужно.
+     */
+    disabled?: boolean;
+}
+export interface GrFormEmits {
+    /** Форма прошла валидацию по submit. Отдаёт `model`. */
+    (e: 'submit', model: Record<string, unknown>): void;
+    /** Результат валидации одного поля. */
+    (e: 'validate', name: string, valid: boolean, message: string | undefined): void;
+    /**
+     * Submit не прошёл валидацию. Без этого события «форма невалидна» и «ничего
+     * не произошло» выглядят для потребителя одинаково.
+     */
+    (e: 'invalid', errors: Record<string, string>): void;
 }
 declare function validateField(name: string, trigger?: GrFormTrigger): Promise<boolean>;
 declare function validate(): Promise<boolean>;
 declare function clearValidate(names?: string | string[]): void;
-declare function resetFields(): void;
+/**
+ * Переснять «исходное» состояние. Нужен формам редактирования: модель там
+ * наполняется после ответа сервера, а снимок в `setup` фиксировал пустой
+ * объект — и `resetFields()` возвращал не «как было при загрузке», а пустоту.
+ */
+declare function setSnapshot(model?: Record<string, unknown>): void;
+declare function resetFields(names?: string | string[]): void;
 declare function scrollToField(name: string): void;
 declare var __VLS_1: {
     validate: typeof validate;
     errors: Record<string, string | undefined>;
+    isDirty: boolean;
+    isValid: boolean;
+    validatingFields: Set<string> & Omit<Set<string>, keyof Set<any>>;
+    resetFields: typeof resetFields;
+    setSnapshot: typeof setSnapshot;
 };
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
@@ -40,26 +67,35 @@ declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPro
     validateOnChange: boolean;
     scrollToError: boolean;
     scrollBehavior: string;
+    disabled: boolean;
 }>>, {
     validate: typeof validate;
     validateField: typeof validateField;
     clearValidate: typeof clearValidate;
     resetFields: typeof resetFields;
     scrollToField: typeof scrollToField;
+    setSnapshot: typeof setSnapshot;
+    isDirty: import("vue").ComputedRef<boolean>;
+    isValid: import("vue").ComputedRef<boolean>;
+    validatingFields: import("vue").ComputedRef<Set<string> & Omit<Set<string>, keyof Set<any>>>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     submit: (model: Record<string, unknown>) => void;
     validate: (name: string, valid: boolean, message: string | undefined) => void;
+    invalid: (errors: Record<string, string>) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormProps>, {
     rules: undefined;
     validateOnBlur: boolean;
     validateOnChange: boolean;
     scrollToError: boolean;
     scrollBehavior: string;
+    disabled: boolean;
 }>>> & Readonly<{
     onSubmit?: ((model: Record<string, unknown>) => any) | undefined;
+    onInvalid?: ((errors: Record<string, string>) => any) | undefined;
     onValidate?: ((name: string, valid: boolean, message: string | undefined) => any) | undefined;
 }>, {
     scrollBehavior: ScrollBehavior;
+    disabled: boolean;
     rules: GrFormRules;
     validateOnBlur: boolean;
     validateOnChange: boolean;

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

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

package/dist/types/src/components/GrForm/context.d.ts

@@ -4,21 +4,40 @@ import type { GrFormTrigger } from './validation';
  * Контекст формы, который `GrForm` предоставляет своим `GrFormField`.
  *
  * Ключевая идея архитектуры: контролы (`GrInput`/`GrSelect`/`GrAutocomplete`/…) НЕ
- * знают про форму — они, как и раньше, читают только контекст `GrFormField`
+ * знают про форму — они читают только контекст `GrFormField`
  * (`id`/`aria-describedby`/`invalid`/`required`). А `GrFormField`, находясь внутри
  * `GrForm`, подтягивает свою ошибку и признак обязательности из ЭТОГО контекста по
  * `name` и триггерит валидацию поля. Так оркестрация добавляется сверху, не трогая
  * ни один контрол.
  */
+export interface GrFormFieldRegistration {
+    /** Обязательно ли поле по собственному пропу `required`. */
+    required?: () => boolean;
+}
 export interface GrFormContext {
     /** Реактивная карта ошибок по имени поля. */
     errors: Ref<Record<string, string | undefined>>;
     /** Имена полей, у которых в правилах есть `required` (для маркера `*`). */
     requiredFields: ComputedRef<Set<string>>;
+    /**
+     * Поля, у которых прямо сейчас идёт асинхронная проверка. Необязательны:
+     * тип публичный, и контекст строят руками (в тестах и в своих обёртках) —
+     * старая форма контекста продолжает работать.
+     */
+    validatingFields?: ComputedRef<Set<string>>;
+    /** Форма выключена целиком: значение видно, но ничего не редактируется. */
+    disabled?: ComputedRef<boolean>;
     /** Есть ли для поля правила (тогда `GrFormField` берёт ошибку из формы). */
     hasField: (name: string) => boolean;
-    /** Регистрирует корневой элемент поля (для scroll-to-error). Возвращает unregister. */
-    registerField: (name: string, getEl: () => HTMLElement | null) => () => void;
+    /**
+     * Регистрирует поле: корневой элемент (для scroll-to-error) и собственную
+     * обязательность. Возвращает unregister.
+     *
+     * Обязательность приходит именно отсюда, потому что источников у неё два:
+     * правило в `rules` и проп `required` у поля. Без регистрации второй источник
+     * рисовал бы звёздочку, но не мешал submit'у.
+     */
+    registerField: (name: string, getEl: () => HTMLElement | null, registration?: GrFormFieldRegistration) => () => void;
     /** Валидирует одно поле (с учётом триггера и настроек формы). */
     validateField: (name: string, trigger?: GrFormTrigger) => Promise<boolean>;
 }

package/dist/types/src/components/GrForm/fileRule.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Файловое правило `GrForm` — мост между декларативными `rules` и валидаторами
+ * из `src/fileValidation`.
+ *
+ * Своих проверок здесь нет ни одной: правило собирает те же валидаторы, которые
+ * `GrFormFile` и `v-dropzone` запускают на выборе и на drop. Поэтому ограничение,
+ * переехавшее из пропов поля в правило формы, не меняет ни поведения, ни текста
+ * ошибки — меняется только момент проверки и то, кто о ней сообщает.
+ *
+ * Модуль чистый (без Vue): его гоняют юнит-тесты без монтирования.
+ */
+import { type FileValidationIssue, type FileValidator } from '../../fileValidation';
+export interface GrFormFileRule {
+    /** W3C `accept`: `'image/*,.pdf'`. */
+    accept?: string;
+    /** Белый список расширений (с точкой или без). */
+    extensions?: string[];
+    /** Белый список MIME-типов. */
+    mimeTypes?: string[];
+    /** Предел размера одного файла в мегабайтах. */
+    maxSizeMb?: number;
+    /** Предел размера одного файла в байтах. Задан вместе с `maxSizeMb` — берётся меньший. */
+    maxSizeBytes?: number;
+    /** Максимум файлов в наборе. */
+    maxCount?: number;
+    /** Суммарный размер набора в мегабайтах. */
+    maxTotalSizeMb?: number;
+    /** Свои валидаторы — тот же тип, что у `GrFormFile` и `v-dropzone`. Идут после встроенных. */
+    validators?: FileValidator[];
+}
+/**
+ * Значение поля как набор файлов. Всё, что файлами не является, даёт пустой
+ * набор: правило молчит, а пустоту разбирает `required` движка.
+ */
+export declare function fileRuleFiles(value: unknown): File[];
+/** Порядок повторяет `GrFormFile`: встроенные проверки, затем валидаторы потребителя. */
+export declare function fileRuleValidators(rule: GrFormFileRule): FileValidator[];
+/**
+ * Первая проблема набора или `undefined`. Первая, а не все: у поля формы одна
+ * строка ошибки, и файлы тут не исключение — подробный разбор по каждому файлу
+ * остаётся за `GrFormFile`.
+ */
+export declare function runFileRule(value: unknown, rule: GrFormFileRule): Promise<FileValidationIssue | undefined>;

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

@@ -1,6 +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 { GR_FORM_KEY, type GrFormContext, useGrFormContext } from './context';
-export type { GrFormProps, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './GrForm.vue';
-export { getByPath, type GrFormMessageResolver, type GrFormRuleFailure, isEmpty, runFieldRules, } from './validation';
+export type { GrFormFileRule, GrFormProps, GrFormRule, GrFormRules, GrFormTrigger, GrFormValidatorResult, } from './GrForm.vue';
+export { createGrFormMessageResolver, getByPath, type GrFormMessageResolver, type GrFormMessageTranslate, type GrFormRuleFailure, isEmpty, runFieldRules, } from './validation';
+export type { GrFormEmits } from './GrForm.vue';
+export type GrFormInstance = ComponentExposed<typeof GrFormComponent>;

package/dist/types/src/components/GrForm/modelSnapshot.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Снимок модели формы: клон для `resetFields` и отпечаток для `isDirty`.
+ *
+ * Чистый модуль без Vue: обе операции читают «сквозь» reactive-прокси и
+ * тестируются без монтирования.
+ *
+ * Почему не `JSON.parse(JSON.stringify(...))` и не `structuredClone`: первый
+ * теряет `File` (у файла нет ни перечислимых собственных свойств, ни `toJSON`,
+ * поэтому в снимок попадал `{}`), второй падает на прокси с `DataCloneError`.
+ */
+/** Клон значения модели: JSON-семантика плюс сохранённые по ссылке файлы. */
+export declare function cloneModelValue<T>(value: T): T;
+/**
+ * Строка, по которой сравниваются модель и снимок. Без неё любой `File`
+ * сериализовался в `{}`, и «выбрал документ» было неотличимо от «не трогал».
+ */
+export declare function modelFingerprint(value: unknown): string;

package/dist/types/src/components/GrForm/validation.d.ts

@@ -6,6 +6,8 @@
  * Сообщения резолвит потребитель (компонент) через `resolveMessage` — так i18n и
  * дефолтные тексты остаются в компоненте, а движок ничего о них не знает.
  */
+import { type GrFormFileRule } from './fileRule';
+export type { GrFormFileRule } from './fileRule';
 export type GrFormTrigger = 'blur' | 'change' | 'submit';
 /** Результат кастомного валидатора: `true`/void — ок; `false` — ошибка (дефолт-текст); строка — текст ошибки. */
 export type GrFormValidatorResult = boolean | string | void;
@@ -24,6 +26,8 @@ export interface GrFormRule {
     pattern?: RegExp;
     /** Встроенный тип-валидатор. */
     type?: 'email' | 'url';
+    /** Ограничения для значения `File | File[]`: тип, размер, количество. */
+    file?: GrFormFileRule;
     /** Кастомный (в т.ч. async) валидатор. Второй аргумент — весь `model`. */
     validator?: (value: unknown, model: Record<string, unknown>) => GrFormValidatorResult | Promise<GrFormValidatorResult>;
     /** Когда правило срабатывает. По умолчанию — на любом триггере (blur/change/submit). */
@@ -31,8 +35,19 @@ export interface GrFormRule {
 }
 export type GrFormRules = Record<string, GrFormRule | GrFormRule[]>;
 /** Вид сработавшей проверки — ключ для дефолтного i18n-сообщения. */
-export type GrFormRuleFailure = 'required' | 'min' | 'max' | 'len' | 'pattern' | 'email' | 'url' | 'invalid';
+export type GrFormRuleFailure = 'required' | 'min' | 'max' | 'len' | 'pattern' | 'email' | 'url' | 'file' | 'invalid';
 export type GrFormMessageResolver = (kind: GrFormRuleFailure, rule: GrFormRule, params: Record<string, unknown>) => string;
+/** Подпись `t()` из `useGranularityTranslations()`: ключ, фолбэк, параметры. */
+export type GrFormMessageTranslate = (key: string, fallback: string, params?: Record<string, unknown>) => string;
+/**
+ * Дефолтный резолвер сообщений: `rule.message` сильнее всего, иначе ключ
+ * `gr.form.<kind>` из локали, иначе английский фолбэк.
+ *
+ * Вынесен из `GrForm.vue` и экспортируется наружу не «на всякий случай»:
+ * `runFieldRules` публичен, но без резолвера бесполезен — любой, кто хочет
+ * прогнать те же правила вне формы, обязан был написать свой.
+ */
+export declare function createGrFormMessageResolver(t: GrFormMessageTranslate): GrFormMessageResolver;
 /** Пустое значение: `null`/`undefined`/пустая (или пробельная) строка/пустой массив. */
 export declare function isEmpty(value: unknown): boolean;
 /** Достаёт значение из объекта по dot-path (`address.city`). */

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

@@ -1,5 +1,5 @@
-type LabelClass = string | string[] | Record<string, boolean>;
-type __VLS_Props = {
+import { type GrFormFieldLabelPosition, type GrFormFieldSize } from './grFormFieldStyles';
+export interface GrFormFieldProps {
     label?: string;
     /**
      * Имя поля в модели `GrForm` (в т.ч. dot-path `address.city`). Когда поле внутри
@@ -9,43 +9,89 @@ type __VLS_Props = {
     name?: string;
     /** Явный id контрола. Если не задан — генерируется автоматически. */
     forId?: string;
-    /** Явная ошибка. Перекрывает ошибку из `GrForm` (ручной режим без формы — тоже здесь). */
-    error?: string;
+    /**
+     * Явная ошибка (или несколько). Перекрывает ошибку из `GrForm` — ручной
+     * режим без формы тоже здесь. Массив нужен там, где источник ошибок один,
+     * а претензий несколько: ответ сервера, валидация файла.
+     */
+    error?: string | string[];
     /** Подсказка под лейблом/над контролом (можно также через слот `#hint`). */
     hint?: string;
     /** Помечает поле обязательным (маркер `*` + `aria-required` у контрола). */
     required?: boolean;
+    /** Всё поле только для чтения: контролы внутри перестают редактироваться. */
+    readonly?: boolean;
+    /** Поле недоступно. Складывается с `disabled` формы по «или». */
+    disabled?: boolean;
+    /**
+     * Показывать текст ошибки. `false` — поле остаётся невалидным для контрола
+     * и AT (`aria-invalid`), но сообщение не занимает места: так делают в
+     * плотных таблицах-формах, где ошибка объясняется сводкой сверху.
+     */
+    showMessage?: boolean;
+    /** Размер подписи, подсказки и ошибки. Не задан — из `GrConfigProvider`, иначе `md`. */
+    size?: GrFormFieldSize;
+    /** Подпись сверху (по умолчанию) или сбоку — для плотных форм. */
+    labelPosition?: GrFormFieldLabelPosition;
+    /** Ширина колонки подписи при `labelPosition="start"`. Число — пиксели. */
+    labelWidth?: string | number;
     labelClass?: LabelClass;
+}
+import './defaults';
+type LabelClass = string | string[] | Record<string, boolean>;
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_5: {}, __VLS_7: {
+    errors: string[];
 };
-declare var __VLS_1: {}, __VLS_3: {};
 type __VLS_Slots = {} & {
-    hint?: (props: typeof __VLS_1) => any;
+    label?: (props: typeof __VLS_1) => any;
+} & {
+    hint?: (props: typeof __VLS_3) => any;
+} & {
+    default?: (props: typeof __VLS_5) => any;
 } & {
-    default?: (props: typeof __VLS_3) => any;
+    error?: (props: typeof __VLS_7) => any;
 };
-declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFieldProps>, {
     label: undefined;
     name: undefined;
     forId: undefined;
     error: undefined;
     hint: undefined;
     required: boolean;
+    readonly: boolean;
+    disabled: boolean;
+    showMessage: boolean;
+    size: undefined;
+    labelPosition: undefined;
+    labelWidth: undefined;
     labelClass: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_Props>, {
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFieldProps>, {
     label: undefined;
     name: undefined;
     forId: undefined;
     error: undefined;
     hint: undefined;
     required: boolean;
+    readonly: boolean;
+    disabled: boolean;
+    showMessage: boolean;
+    size: undefined;
+    labelPosition: undefined;
+    labelWidth: undefined;
     labelClass: undefined;
 }>>> & Readonly<{}>, {
+    size: GrFormFieldSize;
+    labelPosition: GrFormFieldLabelPosition;
+    readonly: boolean;
     label: string;
-    error: string;
     name: string;
+    error: string | string[];
+    disabled: boolean;
     required: boolean;
     forId: string;
     hint: string;
+    showMessage: boolean;
+    labelWidth: string | number;
     labelClass: LabelClass;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

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

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

package/dist/types/src/components/GrFormField/context.d.ts

@@ -8,12 +8,31 @@ import { type ComputedRef, type InjectionKey } from 'vue';
 export interface GrFormFieldContext {
     /** Сгенерированный (или переданный `forId`) id контрола. */
     id: ComputedRef<string | undefined>;
+    /**
+     * Id элемента подписи. Нужен контролам, чей виджет — не labelable-элемент
+     * (`span[role="checkbox"]`, `div[role="radiogroup"]`): к ним `<label for>`
+     * не применяется, и имя приходит через `aria-labelledby`.
+     */
+    labelId: ComputedRef<string | undefined>;
     /** `aria-describedby`: id подсказки и/или сообщения об ошибке. */
     describedById: ComputedRef<string | undefined>;
     /** Невалидно ли поле (есть `error`). */
     invalid: ComputedRef<boolean>;
     /** Обязательное ли поле. */
     required: ComputedRef<boolean>;
+    /**
+     * Поле только для чтения. Отличается от `disabled`: значение видно, уходит в
+     * форму и доступно скринридеру — просто не редактируется. Ставится на всё
+     * поле целиком, чтобы «форма только на чтение» не требовала обходить контролы
+     * по одному.
+     */
+    readonly: ComputedRef<boolean>;
+    /**
+     * Поле недоступно: не фокусируется и не отправляется. Приходит от самого
+     * поля или от формы целиком (`GrForm disabled`) — «выключить форму на время
+     * отправки» не должно требовать обхода контролов по одному.
+     */
+    disabled: ComputedRef<boolean>;
 }
 export declare const GR_FORM_FIELD_KEY: InjectionKey<GrFormFieldContext>;
 /** Возвращает контекст поля формы или `null`, если контрол вне `GrFormField`. */

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

@@ -0,0 +1,15 @@
+import type { GrFormFieldLabelPosition, GrFormFieldSize } from './grFormFieldStyles';
+/**
+ * Пропы `GrFormField`, настраиваемые глобально через
+ * `<GrConfigProvider :component-defaults="{ GrFormField: { … } }">`.
+ * Только оформление — см. `GrButton/defaults.ts`.
+ */
+export interface GrFormFieldConfigurableProps {
+    size: GrFormFieldSize;
+    labelPosition: GrFormFieldLabelPosition;
+}
+declare module '../../composables/useGrComponentConfig' {
+    interface GrComponentDefaultsRegistry {
+        GrFormField: GrFormFieldConfigurableProps;
+    }
+}

package/dist/types/src/components/GrFormField/grFormFieldStyles.d.ts

@@ -0,0 +1,19 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrFormFieldSize = GrComponentSize;
+/** Вертикальный ритм поля: подпись → подсказка → контрол → ошибка. */
+export declare const fieldGaps: Record<GrFormFieldSize, string>;
+export declare const labelTexts: Record<GrFormFieldSize, string>;
+/** Подсказка набирается на ступень мельче подписи — она вторична. */
+export declare const hintTexts: Record<GrFormFieldSize, string>;
+export declare const errorTexts: Record<GrFormFieldSize, string>;
+/** Сторона подписи относительно контрола — логическая, не физическая (RTL). */
+export declare const GR_FORM_FIELD_LABEL_POSITIONS: readonly ["top", "start"];
+export type GrFormFieldLabelPosition = typeof GR_FORM_FIELD_LABEL_POSITIONS[number];
+export declare const rootColumnClass = "flex flex-col";
+export declare const rootRowClass = "flex items-start";
+export declare const labelInlineClass = "shrink-0";
+export declare const controlColumnClass = "flex flex-col min-w-0 flex-1";
+export declare const labelBaseClass = "text-[var(--gr-muted-fg)]";
+export declare const hintBaseClass = "text-[var(--gr-muted-fg)]";
+export declare const errorBaseClass = "text-[var(--gr-invalid-text)]";
+export declare const requiredMarkClass = "text-[var(--gr-invalid-text)]";

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

@@ -1,4 +1,8 @@
 export { default } from './GrFormField.vue';
 export { default as GrFormField } from './GrFormField.vue';
-export { GR_FORM_FIELD_KEY, useGrFormFieldContext, type GrFormFieldContext } from './context';
+export { GR_FORM_FIELD_KEY, type GrFormFieldContext, useGrFormFieldContext } from './context';
 export { grFormFieldConfig } from './config';
+export type { GrFormFieldConfigurableProps } from './defaults';
+export type { GrFormFieldLabelPosition, GrFormFieldSize } from './grFormFieldStyles';
+export { grFormFieldSafelist } from './safelist';
+export type { GrFormFieldProps } from './GrFormField.vue';

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

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

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

@@ -1,3 +1,4 @@
+import { type GrFormFileSize } from './grFormFileStyles';
 import type { FileValidationIssue, FileValidator } from '../../fileValidation';
 export type GrFormFileError = FileValidationIssue;
 /**
@@ -10,71 +11,124 @@ export interface GrFormFileProps {
     modelValue: File | File[] | null;
     multiple?: boolean;
     disabled?: boolean;
+    /** Только для чтения: значение видно и уходит в форму, но не редактируется. */
+    readonly?: boolean;
+    /** Визуальное и ARIA-состояние ошибки. */
+    invalid?: boolean;
+    /** Обязательное поле (`aria-required`). */
+    required?: boolean;
+    /** Доступное имя вне `GrFormField`. */
+    ariaLabel?: string;
     /** W3C `accept` для `<input type="file">` + sugar к `acceptValidator(...)`. */
     accept?: string;
     validators?: FileValidator[];
+    /** Максимум файлов в наборе. Лишние не обрезаются молча — набор отбивается ошибкой. */
+    limit?: number;
     uploadText?: string;
     changeText?: string;
     removeText?: string;
     clearAllText?: string;
     placeholder?: string;
+    /** Размер кнопок, иконок и подписей. */
+    size?: GrFormFileSize;
+    /** Миниатюры для картинок в наборе. Файлы других типов остаются строкой. */
+    preview?: boolean;
     /** Дополнительная (кастомная) валидация на стороне потребителя. */
     validate?: (files: File[]) => GrFormFileError[] | Promise<GrFormFileError[]>;
+    /**
+     * Контролируемый список ошибок: `v-model:errors`. Задан — показывается он, и
+     * внутренняя валидация его не перетирает. Сюда же кладутся ошибки, пришедшие
+     * с сервера. Не задан — компонент держит свои ошибки сам.
+     */
+    errors?: GrFormFileError[];
 }
-declare var __VLS_58: {
-    errors: {
-        fileName?: string | undefined;
-        code: import("../../fileValidation").FileValidationIssueCode;
-        message: string;
-        meta?: Record<string, unknown> | undefined;
-        i18nKey?: string | undefined;
-        i18nParams?: Record<string, unknown> | undefined;
-    }[];
-};
-type __VLS_Slots = {} & {
-    errors?: (props: typeof __VLS_58) => any;
+export interface GrFormFileEmits {
+    (e: 'update:modelValue', value: File | File[] | null): void;
+    (e: 'change', value: File | File[] | null): void;
+    (e: 'clear'): void;
+    /** Результат валидации. Канал один: `validation` дублировал эту же нагрузку. */
+    (e: 'update:errors', errors: GrFormFileError[]): void;
+    (e: 'focus', event: FocusEvent): void;
+    (e: 'blur', event: FocusEvent): void;
+}
+type __VLS_Slots = {
+    /** Собственный вывод ошибок вместо списка по умолчанию. */
+    error?: (props: {
+        errors: GrFormFileError[];
+    }) => any;
 };
+declare function focus(): void;
+declare function blur(): void;
 declare const __VLS_base: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFileProps>, {
     multiple: boolean;
+    preview: boolean;
     disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
+    ariaLabel: undefined;
     accept: undefined;
+    limit: undefined;
     uploadText: undefined;
     changeText: undefined;
     removeText: undefined;
     clearAllText: undefined;
     placeholder: undefined;
+    size: undefined;
     validators: undefined;
     validate: undefined;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    errors: undefined;
+}>>, {
+    focus: typeof focus;
+    blur: typeof blur;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (value: File | File[] | null) => void;
     change: (value: File | File[] | null) => void;
     clear: () => void;
-    validation: (errors: FileValidationIssue[]) => void;
     "update:errors": (errors: FileValidationIssue[]) => void;
+    focus: (event: FocusEvent) => void;
+    blur: (event: FocusEvent) => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<GrFormFileProps>, {
     multiple: boolean;
+    preview: boolean;
     disabled: boolean;
+    readonly: boolean;
+    invalid: boolean;
+    required: boolean;
+    ariaLabel: undefined;
     accept: undefined;
+    limit: undefined;
     uploadText: undefined;
     changeText: undefined;
     removeText: undefined;
     clearAllText: undefined;
     placeholder: undefined;
+    size: undefined;
     validators: undefined;
     validate: undefined;
+    errors: undefined;
 }>>> & Readonly<{
     onClear?: (() => any) | undefined;
+    onBlur?: ((event: FocusEvent) => any) | undefined;
     onChange?: ((value: File | File[] | null) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((value: File | File[] | null) => any) | undefined;
-    onValidation?: ((errors: FileValidationIssue[]) => any) | undefined;
     "onUpdate:errors"?: ((errors: FileValidationIssue[]) => any) | undefined;
 }>, {
+    size: GrFormFileSize;
+    readonly: boolean;
+    invalid: boolean;
     accept: string;
     multiple: boolean;
     disabled: boolean;
+    required: boolean;
     placeholder: string;
-    validators: FileValidator[];
+    ariaLabel: string;
+    errors: GrFormFileError[];
     validate: (files: File[]) => GrFormFileError[] | Promise<GrFormFileError[]>;
+    limit: number;
+    validators: FileValidator[];
+    preview: boolean;
     uploadText: string;
     changeText: string;
     removeText: string;

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

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

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

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

package/dist/types/src/components/GrFormFile/grFormFileStyles.d.ts

@@ -0,0 +1,22 @@
+import type { GrComponentSize } from '../shared/sizes';
+export type GrFormFileSize = GrComponentSize;
+/** Имя файла, плейсхолдер, список выбранного. */
+export declare const textSizes: Record<GrFormFileSize, string>;
+/** Ссылка «удалить» у элемента списка — на ступень мельче имени файла. */
+export declare const removeTextSizes: Record<GrFormFileSize, string>;
+export declare const rowGaps: Record<GrFormFileSize, string>;
+export declare const stackGaps: Record<GrFormFileSize, string>;
+/** Отступ между иконкой и подписью внутри кнопки. */
+export declare const iconOffsets: Record<GrFormFileSize, string>;
+/**
+ * Миниатюра картинки в строке набора.
+ *
+ * Квадрат с `object-cover`: файлы приходят любых пропорций, а строки списка
+ * обязаны остаться одной высоты.
+ */
+export declare const previewSizes: Record<GrFormFileSize, string>;
+export declare const previewBaseClass = "shrink-0 rounded-[var(--gr-radius-sm)] object-cover border border-[var(--gr-brd)]";
+/** Кнопки берут размер из шкалы `GrButton` — на ступень ниже самого поля. */
+export declare const buttonSizes: Record<GrFormFileSize, GrComponentSize>;
+/** Иконка внутри кнопки — из шкалы `GrIcon` (`xs…lg` → `14…20px`). */
+export declare const iconSizes: Record<GrFormFileSize, GrComponentSize>;