@reformer/core 11.0.0-beta.1 → 11.0.0-beta.10

package/dist/form/types/form-proxy.d.ts

@@ -1,141 +0,0 @@
-import { FieldNode } from '../nodes/field-node';
-import { GroupNode } from '../nodes/group-node';
-import { ArrayNode } from '../nodes/array-node';
-/**
- * Признак «объект-группа» — обычный объект, который нужно обернуть в под-форму.
- *
- * Исключает массивы, спец-объекты (`Date`/`File`/`Blob`) и примитивы.
- * Используется как дискриминатор вместо `extends FormFields` (`Record<string, FormValue>`):
- * пользовательские модели почти всегда объявлены через `interface`, который НЕ assignable
- * к Record-типу (у интерфейса нет неявной index signature), и потому ошибочно проваливался
- * бы в ветку `FieldNode`. Проверка `extends object` корректно ловит и `interface`, и `type`.
- *
- * @internal
- */
-type IsGroupObject<V> = V extends ReadonlyArray<unknown> ? false : V extends Date | File | Blob ? false : V extends (...args: never[]) => unknown ? false : V extends object ? true : false;
-/**
- * Мапит тип модели данных T на правильные типы узлов формы
- *
- * Рекурсивно определяет типы узлов на основе структуры данных:
- * - `T[K] extends Array<infer U>` где U - объект → `FormArrayProxy<U>`
- * - `T[K] extends Array<infer U>` где U - примитив → `FieldNode<T[K]>` (массив как обычное поле)
- * - `T[K] extends object` → `FormProxy<T[K]>` (вложенная форма с типизацией)
- * - `T[K]` примитив → `FieldNode<T[K]>` (простое поле)
- *
- * Использует NonNullable для правильной обработки опциональных полей
- *
- * @group Types
- * @category Proxy Types
- *
- * @template T - Тип модели данных формы
- */
-export type FormControlsProxy<T> = {
-    [K in keyof T]-?: NonNullable<T[K]> extends ReadonlyArray<infer U> ? IsGroupObject<U> extends true ? FormArrayProxy<U & object> : FieldNode<T[K]> : IsGroupObject<NonNullable<T[K]>> extends true ? FormProxy<NonNullable<T[K]>> : FieldNode<T[K]>;
-};
-/**
- * Комбинированный тип для GroupNode с Proxy доступом к полям
- *
- * Объединяет методы и свойства GroupNode с типизированными полями формы.
- * Это позволяет использовать как API GroupNode, так и прямой доступ к полям.
- *
- * @group Types
- * @category Proxy Types
- *
- * @template T - Тип модели данных формы
- *
- * @example
- * ```typescript
- * interface UserForm {
- *   email: string;
- *   profile: {
- *     name: string;
- *     age: number;
- *   };
- * }
- *
- * const form = createForm<UserForm>(schema);
- *
- * // Доступ к методам GroupNode
- * await form.validate();
- * const values = form.getValue();
- * console.log(form.valid.value);
- *
- * // Прямой доступ к полям (через Proxy)
- * form.email.setValue('test@mail.com');
- * form.profile.name.setValue('John');
- * ```
- *
- * @remarks
- * **Зарезервированные имена.** Прямой доступ `form.<name>` отдаёт приоритет собственным
- * членам {@link GroupNode} (`value`, `status`, `id`, `errors`, `disabled`, `reset`, `submit`, …).
- * Поэтому поле модели, названное любым из этих имён, недостижимо как `form.<name>` — там будет
- * агрегированный сигнал/метод узла, а не {@link FieldNode}. Такие имена исключены из полевого
- * пространства имён на уровне типов (через `Omit<…, keyof GroupNode>`), чтобы затенение не
- * компилировалось молча. Для доступа к любому полю по имени — включая затенённые — используйте
- * escape-hatch пространство {@link FormProxy.$}: `form.$.status`, `form.$.id`, `form.$.value`.
- */
-export type FormProxy<T> = GroupNode<T> & Omit<FormControlsProxy<T>, keyof GroupNode<T>> & {
-    /**
-     * Escape-hatch пространство имён «controls»: типобезопасный доступ ко ВСЕМ полям формы
-     * по имени, включая поля, чьи имена совпадают с членами {@link GroupNode}
-     * (`value`/`status`/`id`/`errors`/…), недостижимые через `form.<name>`.
-     *
-     * @example
-     * ```typescript
-     * // модель: { status: string; email: string }
-     * form.status;      // ReadonlySignal<FieldStatus> — агрегат GroupNode (не поле!)
-     * form.$.status;    // FieldNode<string> — поле пользователя
-     * form.$.status.setValue('active');
-     * form.$.email;     // FieldNode<string> — так же доступны и незатенённые поля
-     * ```
-     */
-    readonly $: FormControlsProxy<T>;
-};
-/**
- * Комбинированный тип для ArrayNode с Proxy доступом к элементам
- *
- * Объединяет методы и свойства ArrayNode с типизированным доступом к элементам массива.
- *
- * @group Types
- * @category Proxy Types
- *
- * @template T - Тип модели данных элемента массива
- *
- * @example
- * ```typescript
- * interface TodoItem {
- *   title: string;
- *   completed: boolean;
- * }
- *
- * const todos: FormArrayProxy<TodoItem> = new ArrayNode(schema);
- *
- * // Доступ к методам ArrayNode
- * todos.push({ title: 'New todo', completed: false });
- * todos.removeAt(0);
- *
- * // Доступ к элементам (через Proxy)
- * todos.at(0)?.title.setValue('Updated title');
- *
- * // Итерация
- * todos.forEach((item, i) => {
- *   console.log(item.title.value.value);
- * });
- * ```
- */
-export type FormArrayProxy<T extends object> = ArrayNode<T> & {
-    /**
-     * Безопасный доступ к элементу массива по индексу
-     * Возвращает GroupNode с типизированными полями или undefined
-     */
-    at(index: number): FormProxy<T> | undefined;
-    /**
-     * Итерация по элементам массива с типизированными элементами
-     */
-    forEach(callback: (item: FormProxy<T>, index: number) => void): void;
-    /**
-     * Маппинг элементов массива с типизированными элементами
-     */
-    map<R>(callback: (item: FormProxy<T>, index: number) => R): R[];
-};
-export {};

package/dist/form/unique-id.d.ts

@@ -1,45 +0,0 @@
-/**
- * Генератор уникальных идентификаторов
- *
- * Использует атомный счётчик для генерации гарантированно уникальных ключей.
- * Решает проблему возможного дублирования ключей при использовании
- * Date.now() + Math.random() в быстрых последовательных вызовах.
- *
- * @example
- * ```typescript
- * const key1 = uniqueId(SubscriptionKey.Watch); // "watch-1"
- * const key2 = uniqueId(SubscriptionKey.Watch); // "watch-2"
- * const key3 = uniqueId(SubscriptionKey.ComputeFrom); // "computeFrom-3"
- * ```
- */
-/**
- * Типобезопасные ключи для подписок
- * Используются с uniqueId() для генерации уникальных идентификаторов
- */
-export declare const SubscriptionKey: {
-    /** FieldNode.watch() */
-    readonly Watch: "watch";
-    /** FieldNode.computeFrom() */
-    readonly ComputeFrom: "computeFrom";
-    /** GroupNode.linkFields() */
-    readonly LinkFields: "linkFields";
-    /** GroupNode.watchField() */
-    readonly WatchField: "watchField";
-};
-export type SubscriptionKeyType = (typeof SubscriptionKey)[keyof typeof SubscriptionKey];
-/**
- * Генерирует уникальный идентификатор с указанным префиксом.
- *
- * @param prefix - Префикс для идентификатора (используйте {@link SubscriptionKey}).
- * @returns Уникальный идентификатор в формате `${prefix}-${counter}`.
- *
- * ⚠️ `SubscriptionKey`/`SubscriptionKeyType` — внутренние: барель `@reformer/core` их не отдаёт,
- * поэтому вызвать `uniqueId` извне пакета типобезопасно нельзя. Пример ниже — внутрипакетный.
- *
- * @example
- * ```typescript
- * uniqueId(SubscriptionKey.WatchField); // → 'watchField-1'
- * uniqueId(SubscriptionKey.WatchField); // → 'watchField-2'
- * ```
- */
-export declare function uniqueId(prefix: SubscriptionKeyType): string;

package/dist/form/validation/validators/date-utils.d.ts

@@ -1,30 +0,0 @@
-/**
- * Утилиты для работы с датами в валидаторах
- *
- * @group Validation
- * @category Validators
- * @module validators/date-utils
- */
-/**
- * Парсит значение в объект Date
- *
- * @param value - Значение для парсинга (Date, string или undefined)
- * @returns Date объект или null если парсинг не удался
- */
-export declare function parseDate(value: string | Date | null | undefined): Date | null;
-/**
- * Возвращает сегодняшнюю дату с обнулённым временем
- */
-export declare function getToday(): Date;
-/**
- * Нормализует дату, обнуляя время
- */
-export declare function normalizeDate(date: Date): Date;
-/**
- * Вычисляет полный возраст (в годах) по календарным полям.
- *
- * Считаем по годам/месяцам/дням, а не делением миллисекунд на усреднённый год (365.25 дн): усреднение
- * даёт off-by-one на границе — в день N-летия накопленных реальных дней меньше `N * 365.25`, и `floor`
- * роняет возраст до `N - 1` (т.е. `minAge(18)` ошибочно отклонял 18-летнего в его день рождения).
- */
-export declare function calculateAge(birthDate: Date): number;

package/dist/form/validation/validators/email.d.ts

@@ -1,23 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора формата email.
- *
- * Проверяет по упрощённому regex `^[^\s@]+@[^\s@]+\.[^\s@]+$`. Пустые значения
- * (`''`/`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
- *
- * @param options - Опции валидатора ({@link ValidateOptions}): `message`, `params`
- * @returns Чистый валидатор {@link Validator} для строкового поля
- *
- * @example Проверка формата email
- * ```typescript
- * import { required, email } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * email: {
- *   value: model.$.email,
- *   component: Input,
- *   validators: [required(), email({ message: 'Введите корректный email' })],
- * },
- * ```
- */
-export declare function email<TForm = unknown, TField extends string | null | undefined = string>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/future-date.d.ts

@@ -1,23 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора, проверяющего что дата не в прошлом.
- *
- * Дата не должна быть раньше сегодняшнего дня (сравнение по нормализованным датам).
- * Пустые и невалидные даты пропускаются (используйте {@link required} и {@link isDate}).
- *
- * @param options - Опции валидатора ({@link ValidateOptions}): `message`, `params`
- * @returns Чистый валидатор {@link Validator} для поля даты (`string | Date`)
- *
- * @example Дата не в прошлом
- * ```typescript
- * import { required, futureDate } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * appointmentDate: {
- *   value: model.$.appointmentDate,
- *   component: DatePicker,
- *   validators: [required(), futureDate({ message: 'Дата записи должна быть в будущем' })],
- * },
- * ```
- */
-export declare function futureDate<TForm = unknown, TField extends string | Date | null | undefined = string | Date>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/integer.d.ts

@@ -1,22 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора, проверяющего что число — целое.
- *
- * Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
- *
- * @param options - Опции валидатора ({@link ValidateOptions}): `message`, `params`
- * @returns Чистый валидатор {@link Validator} для числового поля
- *
- * @example Проверка целого числа
- * ```typescript
- * import { required, integer } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * count: {
- *   value: model.$.count,
- *   component: Input,
- *   validators: [required(), integer({ message: 'Должно быть целым числом' })],
- * },
- * ```
- */
-export declare function integer<TForm = unknown, TField extends number | null | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/is-date.d.ts

@@ -1,23 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора, проверяющего что значение — валидная дата.
- *
- * Принимает `Date` или строку, парсимую в дату. Пустые значения (`''`/`null`/`undefined`)
- * пропускаются (используйте {@link required} для обязательности).
- *
- * @param options - Опции валидатора ({@link ValidateOptions}): `message`, `params`
- * @returns Чистый валидатор {@link Validator} для поля даты (`string | Date`)
- *
- * @example Проверка валидности даты
- * ```typescript
- * import { required, isDate } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * eventDate: {
- *   value: model.$.eventDate,
- *   component: DatePicker,
- *   validators: [required(), isDate({ message: 'Введите корректную дату' })],
- * },
- * ```
- */
-export declare function isDate<TForm = unknown, TField extends string | Date | null | undefined = string | Date>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/is-number.d.ts

@@ -1,24 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора, проверяющего что значение — конечное число (не NaN, не строка).
- *
- * Пустые значения (`null`/`undefined`) пропускаются (используйте {@link required} для
- * обязательности). В отличие от других number-валидаторов, **не** пропускает не-числа
- * и `NaN` — это его задача.
- *
- * @param options - Опции валидатора ({@link ValidateOptions}): `message`, `params`
- * @returns Чистый валидатор {@link Validator} для числового поля
- *
- * @example Проверка, что значение — число
- * ```typescript
- * import { required, isNumber } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * amount: {
- *   value: model.$.amount,
- *   component: Input,
- *   validators: [required(), isNumber({ message: 'Введите число' })],
- * },
- * ```
- */
-export declare function isNumber<TForm = unknown, TField extends number | null | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/max-age.d.ts

@@ -1,25 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора максимального возраста (по дате рождения).
- *
- * Возраст вычисляется по дате рождения относительно сегодняшнего дня. Пустые и невалидные
- * даты пропускаются (используйте {@link required} и {@link isDate}).
- *
- * @param maxAgeValue - Максимально допустимый возраст (в полных годах)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `maxAge` и `currentAge`.
- * @returns Чистый валидатор {@link Validator} для поля даты рождения (`string | Date`)
- *
- * @example Максимальный возраст
- * ```typescript
- * import { maxAge } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * birthDate: {
- *   value: model.$.birthDate,
- *   component: DatePicker,
- *   validators: [maxAge(100, { message: 'Проверьте дату рождения' })],
- * },
- * ```
- */
-export declare function maxAge<TForm = unknown, TField extends string | Date | null | undefined = string | Date>(maxAgeValue: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/max-date.d.ts

@@ -1,25 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора максимальной даты (включительно).
- *
- * Сравнение по нормализованным датам (время обнуляется). Пустые и невалидные даты
- * пропускаются (используйте {@link required} и {@link isDate}).
- *
- * @param maxDateValue - Максимально допустимая дата (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадает `maxDate`.
- * @returns Чистый валидатор {@link Validator} для поля даты (`string | Date`)
- *
- * @example Максимальная дата
- * ```typescript
- * import { maxDate } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * birthDate: {
- *   value: model.$.birthDate,
- *   component: DatePicker,
- *   validators: [maxDate(new Date(), { message: 'Дата не может быть в будущем' })],
- * },
- * ```
- */
-export declare function maxDate<TForm = unknown, TField extends string | Date | null | undefined = string | Date>(maxDateValue: Date, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/max-files.d.ts

@@ -1,26 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора максимального количества файлов.
- *
- * Работает с массивом файлов (одиночный файл считается как 1). Пустые значения
- * (`null`/`undefined`/`''`/`[]`) пропускаются (используйте {@link required}
- * для обязательности).
- *
- * @param max - Максимально допустимое количество файлов (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `maxFiles` и `actualCount`.
- * @returns Чистый валидатор {@link Validator} для файла или массива файлов
- *
- * @example Не более трёх вложений
- * ```typescript
- * import { maxFiles } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * documents: {
- *   value: model.$.documents,
- *   component: FileUploadField,
- *   validators: [maxFiles(3, { message: 'Максимум 3 файла' })],
- * },
- * ```
- */
-export declare function maxFiles<TForm = unknown, TField = unknown>(max: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/max-length.d.ts

@@ -1,27 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора максимальной длины строки или массива.
- *
- * Работает со строкой или массивом (проверяется `value.length`). Пустые значения
- * (`null`/`undefined`/`''`) и значения без числового `length` пропускаются
- * (используйте {@link required} для обязательности).
- *
- * @param maxLen - Максимально допустимая длина (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `maxLength` и `actualLength`.
- * @returns Чистый валидатор {@link Validator} для строки или массива
- *
- * @example Максимальная длина строки
- * ```typescript
- * import { maxLength } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * name: { value: model.$.name, component: Input, validators: [maxLength(50)] },
- * bio: {
- *   value: model.$.bio,
- *   component: Textarea,
- *   validators: [maxLength(500, { message: 'Максимум 500 символов' })],
- * },
- * ```
- */
-export declare function maxLength<TForm = unknown, TField = unknown>(maxLen: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/max-total-file-size.d.ts

@@ -1,26 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора суммарного размера всех файлов.
- *
- * Складывает `size` всех файлов значения (элементы без числового `size` в сумму
- * не входят). Пустые значения (`null`/`undefined`/`''`/`[]`) пропускаются
- * (используйте {@link required} для обязательности).
- *
- * @param maxTotal - Максимально допустимый суммарный размер в байтах (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `maxTotalFileSize` и `actualTotal`.
- * @returns Чистый валидатор {@link Validator} для файла или массива файлов
- *
- * @example Суммарно не более 20 МБ
- * ```typescript
- * import { maxTotalFileSize } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * documents: {
- *   value: model.$.documents,
- *   component: FileUploadField,
- *   validators: [maxTotalFileSize(20 * 1024 * 1024, { message: 'Суммарно не более 20 МБ' })],
- * },
- * ```
- */
-export declare function maxTotalFileSize<TForm = unknown, TField = unknown>(maxTotal: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/max.d.ts

@@ -1,25 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора максимального числового значения.
- *
- * Пустые значения (`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
- *
- * @param maxValue - Максимально допустимое значение (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `max` и `actual`.
- * @returns Чистый валидатор {@link Validator} для числового поля
- *
- * @example Максимальное значение числового поля
- * ```typescript
- * import { required, max } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * quantity: { value: model.$.quantity, component: Input, validators: [max(100)] },
- * discount: {
- *   value: model.$.discount,
- *   component: Input,
- *   validators: [required(), max(50, { message: 'Не более 50%' })],
- * },
- * ```
- */
-export declare function max<TForm = unknown, TField extends number | null | undefined = number>(maxValue: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/min-age.d.ts

@@ -1,25 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора минимального возраста (по дате рождения).
- *
- * Возраст вычисляется по дате рождения относительно сегодняшнего дня. Пустые и невалидные
- * даты пропускаются (используйте {@link required} и {@link isDate}).
- *
- * @param minAgeValue - Минимально допустимый возраст (в полных годах)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `minAge` и `currentAge`.
- * @returns Чистый валидатор {@link Validator} для поля даты рождения (`string | Date`)
- *
- * @example Минимальный возраст
- * ```typescript
- * import { required, minAge } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * birthDate: {
- *   value: model.$.birthDate,
- *   component: DatePicker,
- *   validators: [required(), minAge(18, { message: 'Вам должно быть не менее 18 лет' })],
- * },
- * ```
- */
-export declare function minAge<TForm = unknown, TField extends string | Date | null | undefined = string | Date>(minAgeValue: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/min-date.d.ts

@@ -1,25 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора минимальной даты (включительно).
- *
- * Сравнение по нормализованным датам (время обнуляется). Пустые и невалидные даты
- * пропускаются (используйте {@link required} и {@link isDate}).
- *
- * @param minDateValue - Минимально допустимая дата (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадает `minDate`.
- * @returns Чистый валидатор {@link Validator} для поля даты (`string | Date`)
- *
- * @example Минимальная дата
- * ```typescript
- * import { required, minDate } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * startDate: {
- *   value: model.$.startDate,
- *   component: DatePicker,
- *   validators: [required(), minDate(new Date(), { message: 'Дата не раньше сегодня' })],
- * },
- * ```
- */
-export declare function minDate<TForm = unknown, TField extends string | Date | null | undefined = string | Date>(minDateValue: Date, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/min-files.d.ts

@@ -1,26 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора минимального количества файлов.
- *
- * Работает с массивом файлов (одиночный файл считается как 1). Пустые значения
- * (`null`/`undefined`/`''`/`[]`) пропускаются — «нужен хотя бы один файл» выражается
- * связкой `required()` + `minFiles(n)`, как и у {@link minLength}.
- *
- * @param min - Минимально допустимое количество файлов (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `minFiles` и `actualCount`.
- * @returns Чистый валидатор {@link Validator} для файла или массива файлов
- *
- * @example Не менее двух документов
- * ```typescript
- * import { required, minFiles } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * documents: {
- *   value: model.$.documents,
- *   component: FileUploadField,
- *   validators: [required(), minFiles(2, { message: 'Приложите минимум 2 документа' })],
- * },
- * ```
- */
-export declare function minFiles<TForm = unknown, TField = unknown>(min: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/min-length.d.ts

@@ -1,27 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора минимальной длины строки или массива.
- *
- * Работает со строкой или массивом (проверяется `value.length`). Пустые значения
- * (`null`/`undefined`/`''`) и значения без числового `length` пропускаются
- * (используйте {@link required} для обязательности).
- *
- * @param minLen - Минимально допустимая длина (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `minLength` и `actualLength`.
- * @returns Чистый валидатор {@link Validator} для строки или массива
- *
- * @example Минимальная длина строки
- * ```typescript
- * import { required, minLength } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * name: { value: model.$.name, component: Input, validators: [minLength(2)] },
- * password: {
- *   value: model.$.password,
- *   component: Input,
- *   validators: [required(), minLength(8, { message: 'Минимум 8 символов' })],
- * },
- * ```
- */
-export declare function minLength<TForm = unknown, TField = unknown>(minLen: number, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/validation/validators/min.d.ts

@@ -1,25 +0,0 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
-/**
- * Фабрика валидатора минимального числового значения.
- *
- * Пустые значения (`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
- *
- * @param minValue - Минимально допустимое значение (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
- *   попадают `min` и `actual`.
- * @returns Чистый валидатор {@link Validator} для числового поля
- *
- * @example Минимальное значение числового поля
- * ```typescript
- * import { required, min } from '@reformer/core/validators';
- *
- * // Внутри FieldConfig схемы формы:
- * age: { value: model.$.age, component: Input, validators: [min(18)] },
- * quantity: {
- *   value: model.$.quantity,
- *   component: Input,
- *   validators: [required(), min(1, { message: 'Минимум 1' })],
- * },
- * ```
- */
-export declare function min<TForm = unknown, TField extends number | null | undefined = number>(minValue: number, options?: ValidateOptions): Validator<TForm, TField>;