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

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

@@ -0,0 +1,28 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора максимального возраста (по дате рождения).
+ *
+ * Возраст вычисляется по дате рождения относительно сегодняшнего дня; родившийся 29 февраля в
+ * невисокосный год взрослеет 28 февраля. Дату рождения в будущем правило не оценивает — её
+ * отклоняет {@link minAge} (или {@link pastDate}); иначе пара правил на поле дала бы два
+ * одинаковых замечания. Пустые и невалидные даты пропускаются (используйте {@link required} и
+ * {@link isDate}).
+ *
+ * @param maxAgeValue - Максимально допустимый возраст (в полных годах)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `maxAge` и `currentAge`.
+ * @returns Правило {@link Rule} для поля даты рождения (`string | Date`)
+ *
+ * @example Максимальный возраст
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { maxAge } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.birthDate, [maxAge(100, { code: 'birthDate.maxAge' })]);
+ * });
+ * ```
+ */
+export declare function maxAge(maxAgeValue: number, options?: RuleOptions): Rule<string | Date | null | undefined>;

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

@@ -0,0 +1,25 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора максимальной даты (включительно).
+ *
+ * Сравнение по нормализованным датам (время обнуляется). Пустые и невалидные даты
+ * пропускаются (используйте {@link required} и {@link isDate}).
+ *
+ * @param maxDateValue - Максимально допустимая дата (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадает `maxDate`.
+ * @returns Правило {@link Rule} для поля даты (`string | Date`)
+ *
+ * @example Максимальная дата
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { maxDate } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.birthDate, [maxDate(new Date(), { code: 'birthDate.maxDate' })]);
+ * });
+ * ```
+ */
+export declare function maxDate(maxDateValue: Date, options?: RuleOptions): Rule<string | Date | null | undefined>;

package/dist/form/{validation/validators → validators}/max-file-size.d.ts

@@ -1,4 +1,5 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
 /**
  * Фабрика валидатора максимального размера файла.
  *
@@ -9,20 +10,19 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * (используйте {@link required} для обязательности).
  *
  * @param maxSize - Максимально допустимый размер файла в байтах (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
  *   попадают `maxFileSize`, `fileName` и `actualSize`.
- * @returns Чистый валидатор {@link Validator} для файла или массива файлов
+ * @returns Правило {@link Rule} для файла или массива файлов
  *
  * @example Ограничение размера вложений
  * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { maxFileSize } from '@reformer/core/validators';
  *
- * // Внутри FieldConfig схемы формы:
- * documents: {
- *   value: model.$.documents,
- *   component: FileUploadField,
- *   validators: [maxFileSize(5 * 1024 * 1024, { message: 'Файл больше 5 МБ' })],
- * },
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.documents, [maxFileSize(5 * 1024 * 1024, { code: 'documents.maxFileSize' })]);
+ * });
  * ```
  */
-export declare function maxFileSize<TForm = unknown, TField = unknown>(maxSize: number, options?: ValidateOptions): Validator<TForm, TField>;
+export declare function maxFileSize(maxSize: number, options?: RuleOptions): Rule<unknown>;

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

@@ -0,0 +1,26 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора максимального количества файлов.
+ *
+ * Работает с массивом файлов (одиночный файл считается как 1). Пустые значения
+ * (`null`/`undefined`/`''`/`[]`) пропускаются (используйте {@link required}
+ * для обязательности).
+ *
+ * @param max - Максимально допустимое количество файлов (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `maxFiles` и `actualCount`.
+ * @returns Правило {@link Rule} для файла или массива файлов
+ *
+ * @example Не более трёх вложений
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { maxFiles } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.documents, [maxFiles(3, { code: 'documents.maxFiles' })]);
+ * });
+ * ```
+ */
+export declare function maxFiles(max: number, options?: RuleOptions): Rule<unknown>;

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

@@ -0,0 +1,33 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора максимальной длины строки или массива.
+ *
+ * Работает со строкой или массивом (проверяется `value.length`). Пустые значения
+ * (`null`/`undefined`/`''`) и значения без числового `length` пропускаются
+ * (используйте {@link required} для обязательности).
+ *
+ * Длина строки — в единицах UTF-16, как `String.length` и атрибут `maxlength` браузера: эмодзи и
+ * другие символы вне BMP считаются за 2, графемы не склеиваются.
+ *
+ * У строки замечание — `maxLength` (символы), у массива — `maxItems` (элементы): мультивыбор и
+ * список считают выбранное, и текст «не больше 3 символов» под ними был бы бессмыслицей.
+ *
+ * @param maxLen - Максимально допустимая длина (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `maxLength` и `actualLength`.
+ * @returns Правило {@link Rule} для строки или массива
+ *
+ * @example Максимальная длина строки
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { maxLength } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.name, [maxLength(50)]);
+ *   validate(model.$.bio, [maxLength(500, { code: 'bio.maxLength' })]);
+ * });
+ * ```
+ */
+export declare function maxLength(maxLen: number, options?: RuleOptions): Rule<unknown>;

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

@@ -0,0 +1,26 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора суммарного размера всех файлов.
+ *
+ * Складывает `size` всех файлов значения (элементы без числового `size` в сумму
+ * не входят). Пустые значения (`null`/`undefined`/`''`/`[]`) пропускаются
+ * (используйте {@link required} для обязательности).
+ *
+ * @param maxTotal - Максимально допустимый суммарный размер в байтах (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `maxTotalFileSize` и `actualTotal`.
+ * @returns Правило {@link Rule} для файла или массива файлов
+ *
+ * @example Суммарно не более 20 МБ
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { maxTotalFileSize } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.documents, [maxTotalFileSize(20 * 1024 * 1024, { code: 'documents.maxTotalFileSize' })]);
+ * });
+ * ```
+ */
+export declare function maxTotalFileSize(maxTotal: number, options?: RuleOptions): Rule<unknown>;

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

@@ -0,0 +1,26 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора максимального числового значения.
+ *
+ * Пустые значения и не-числа (`''`, строка из цифр, `NaN`) пропускаются — используйте
+ * {@link required} и {@link isNumber}.
+ *
+ * @param maxValue - Максимально допустимое значение (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `max` и `actual`.
+ * @returns Правило {@link Rule} для числового поля
+ *
+ * @example Максимальное значение числового поля
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, max } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.quantity, [max(100)]);
+ *   validate(model.$.discount, [required(), max(50, { code: 'discount.max' })]);
+ * });
+ * ```
+ */
+export declare function max(maxValue: number, options?: RuleOptions): Rule<number | null | undefined>;

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

@@ -0,0 +1,27 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора минимального возраста (по дате рождения).
+ *
+ * Возраст вычисляется по дате рождения относительно сегодняшнего дня; родившийся 29 февраля в
+ * невисокосный год взрослеет 28 февраля. Дата рождения в будущем — замечание `date_future` с
+ * `params.minAge` (свой `code` из опций его заменяет), а не возраст −1. Пустые и невалидные даты пропускаются
+ * (используйте {@link required} и {@link isDate}).
+ *
+ * @param minAgeValue - Минимально допустимый возраст (в полных годах)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `minAge` и `currentAge`.
+ * @returns Правило {@link Rule} для поля даты рождения (`string | Date`)
+ *
+ * @example Минимальный возраст
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, minAge } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.birthDate, [required(), minAge(18, { code: 'birthDate.minAge' })]);
+ * });
+ * ```
+ */
+export declare function minAge(minAgeValue: number, options?: RuleOptions): Rule<string | Date | null | undefined>;

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

@@ -0,0 +1,25 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора минимальной даты (включительно).
+ *
+ * Сравнение по нормализованным датам (время обнуляется). Пустые и невалидные даты
+ * пропускаются (используйте {@link required} и {@link isDate}).
+ *
+ * @param minDateValue - Минимально допустимая дата (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадает `minDate`.
+ * @returns Правило {@link Rule} для поля даты (`string | Date`)
+ *
+ * @example Минимальная дата
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, minDate } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.startDate, [required(), minDate(new Date(), { code: 'startDate.minDate' })]);
+ * });
+ * ```
+ */
+export declare function minDate(minDateValue: Date, options?: RuleOptions): Rule<string | Date | null | undefined>;

package/dist/form/{validation/validators → validators}/min-file-size.d.ts

@@ -1,4 +1,5 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
 /**
  * Фабрика валидатора минимального размера файла.
  *
@@ -9,20 +10,19 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  * пропускаются (используйте {@link required} для обязательности).
  *
  * @param minSize - Минимально допустимый размер файла в байтах (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
  *   попадают `minFileSize`, `fileName` и `actualSize`.
- * @returns Чистый валидатор {@link Validator} для файла или массива файлов
+ * @returns Правило {@link Rule} для файла или массива файлов
  *
  * @example Отсев пустых файлов
  * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { minFileSize } from '@reformer/core/validators';
  *
- * // Внутри FieldConfig схемы формы:
- * documents: {
- *   value: model.$.documents,
- *   component: FileUploadField,
- *   validators: [minFileSize(1, { message: 'Файл пустой' })],
- * },
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.documents, [minFileSize(1, { code: 'documents.minFileSize' })]);
+ * });
  * ```
  */
-export declare function minFileSize<TForm = unknown, TField = unknown>(minSize: number, options?: ValidateOptions): Validator<TForm, TField>;
+export declare function minFileSize(minSize: number, options?: RuleOptions): Rule<unknown>;

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

@@ -0,0 +1,27 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора минимального количества файлов.
+ *
+ * Работает с массивом файлов (одиночный файл считается как 1). Пустые значения
+ * (`null`/`undefined`/`''`) пропускаются (используйте {@link required}), а пустой массив — как
+ * у {@link minLength} — проверяется: при `min > 0` это замечание с `actualCount: 0`. Элементы
+ * массива, которые не файлы, не считаются.
+ *
+ * @param min - Минимально допустимое количество файлов (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `minFiles` и `actualCount`.
+ * @returns Правило {@link Rule} для файла или массива файлов
+ *
+ * @example Не менее двух документов
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, minFiles } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.documents, [required(), minFiles(2, { code: 'documents.minFiles' })]);
+ * });
+ * ```
+ */
+export declare function minFiles(min: number, options?: RuleOptions): Rule<unknown>;

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

@@ -0,0 +1,33 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора минимальной длины строки или массива.
+ *
+ * Работает со строкой или массивом (проверяется `value.length`). Пустые значения
+ * (`null`/`undefined`/`''`) и значения без числового `length` пропускаются
+ * (используйте {@link required} для обязательности).
+ *
+ * Длина строки — в единицах UTF-16, как `String.length` и атрибут `minlength` браузера: эмодзи и
+ * другие символы вне BMP считаются за 2, графемы не склеиваются.
+ *
+ * У строки замечание — `minLength` (символы), у массива — `minItems` (элементы): мультивыбор и
+ * список считают выбранное, и текст «не меньше 3 символов» под ними был бы бессмыслицей.
+ *
+ * @param minLen - Минимально допустимая длина (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `minLength` и `actualLength`.
+ * @returns Правило {@link Rule} для строки или массива
+ *
+ * @example Минимальная длина строки
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, minLength } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.name, [minLength(2)]);
+ *   validate(model.$.password, [required(), minLength(8, { code: 'password.minLength' })]);
+ * });
+ * ```
+ */
+export declare function minLength(minLen: number, options?: RuleOptions): Rule<unknown>;

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

@@ -0,0 +1,26 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора минимального числового значения.
+ *
+ * Пустые значения и не-числа (`''`, строка из цифр, `NaN`) пропускаются — используйте
+ * {@link required} и {@link isNumber}.
+ *
+ * @param minValue - Минимально допустимое значение (включительно)
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадают `min` и `actual`.
+ * @returns Правило {@link Rule} для числового поля
+ *
+ * @example Минимальное значение числового поля
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, min } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.age, [min(18)]);
+ *   validate(model.$.quantity, [required(), min(1, { code: 'quantity.min' })]);
+ * });
+ * ```
+ */
+export declare function min(minValue: number, options?: RuleOptions): Rule<number | null | undefined>;

package/dist/form/validators/multiple-of.d.ts

@@ -0,0 +1,25 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора, проверяющего что число кратно заданному.
+ *
+ * Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
+ *
+ * @param divisor - Делитель: значение должно быть кратно ему. Конечное число, не равное нулю, —
+ *   иначе ошибка конфигурации (`RangeError`) при создании правила: кратность нулю вырождена.
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадает `multipleOf` (делитель).
+ * @returns Правило {@link Rule} для числового поля
+ *
+ * @example Проверка кратности
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { multipleOf } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.rating, [multipleOf(0.5, { code: 'rating.multipleOf' })]);
+ * });
+ * ```
+ */
+export declare function multipleOf(divisor: number, options?: RuleOptions): Rule<number | null | undefined>;

package/dist/form/validators/non-negative.d.ts

@@ -0,0 +1,22 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора, проверяющего что число неотрицательное (`≥ 0`).
+ *
+ * Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
+ *
+ * @param options - Опции валидатора ({@link RuleOptions}): `code`, `params`
+ * @returns Правило {@link Rule} для числового поля
+ *
+ * @example Проверка неотрицательности
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { nonNegative } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.balance, [nonNegative({ code: 'balance.nonNegative' })]);
+ * });
+ * ```
+ */
+export declare function nonNegative(options?: RuleOptions): Rule<number | null | undefined>;

package/dist/form/validators/non-zero.d.ts

@@ -0,0 +1,22 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора, проверяющего что число не равно нулю.
+ *
+ * Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
+ *
+ * @param options - Опции валидатора ({@link RuleOptions}): `code`, `params`
+ * @returns Правило {@link Rule} для числового поля
+ *
+ * @example Проверка «не ноль»
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { nonZero } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.divisor, [nonZero({ code: 'divisor.nonZero' })]);
+ * });
+ * ```
+ */
+export declare function nonZero(options?: RuleOptions): Rule<number | null | undefined>;

package/dist/form/validators/past-date.d.ts

@@ -0,0 +1,23 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора, проверяющего что дата не в будущем.
+ *
+ * Дата не должна быть позже сегодняшнего дня (сравнение по нормализованным датам).
+ * Пустые и невалидные даты пропускаются (используйте {@link required} и {@link isDate}).
+ *
+ * @param options - Опции валидатора ({@link RuleOptions}): `code`, `params`
+ * @returns Правило {@link Rule} для поля даты (`string | Date`)
+ *
+ * @example Дата не в будущем
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, pastDate } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.birthDate, [required(), pastDate({ code: 'birthDate.pastDate' })]);
+ * });
+ * ```
+ */
+export declare function pastDate(options?: RuleOptions): Rule<string | Date | null | undefined>;

package/dist/form/validators/pattern.d.ts

@@ -0,0 +1,26 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора регулярного выражения.
+ *
+ * Пустые значения (`''`/`null`/`undefined`) пропускаются (используйте {@link required}
+ * для обязательности).
+ *
+ * @param regex - Регулярное выражение для проверки значения
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
+ *   попадает `pattern` (строка-источник regex).
+ * @returns Правило {@link Rule} для строкового поля
+ *
+ * @example Проверка по регулярному выражению
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required, pattern } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.name, [pattern(/^[a-zA-Zа-яА-Я]+$/, { code: 'name.pattern' })]);
+ *   validate(model.$.phone, [required(), pattern(/^\+7 \(\d{3}\) \d{3}-\d{2}-\d{2}$/, { code: 'phone.pattern' })]);
+ * });
+ * ```
+ */
+export declare function pattern(regex: RegExp, options?: RuleOptions): Rule<string | null | undefined>;

package/dist/form/{validation/validators → validators}/phone.d.ts

@@ -1,4 +1,5 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
 /**
  * Формат проверки номера телефона для валидатора {@link phone}.
  *
@@ -9,10 +10,10 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  */
 export type PhoneFormat = 'international' | 'ru' | 'us' | 'any';
 /**
- * Опции валидатора {@link phone}. Расширяют {@link ValidateOptions} (`message`, `params`)
+ * Опции валидатора {@link phone}. Расширяют {@link RuleOptions} (`code`, `params`)
  * выбором формата номера.
  */
-export interface PhoneValidatorOptions extends ValidateOptions {
+export interface PhoneValidatorOptions extends RuleOptions {
     /** Формат проверки {@link PhoneFormat}. По умолчанию `'any'`. */
     format?: PhoneFormat;
 }
@@ -24,18 +25,17 @@ export interface PhoneValidatorOptions extends ValidateOptions {
  *
  * @param options - Опции валидатора {@link PhoneValidatorOptions}. В `params` ошибки
  *   автоматически попадает выбранный `format`.
- * @returns Чистый валидатор {@link Validator} для строкового поля
+ * @returns Правило {@link Rule} для строкового поля
  *
  * @example Проверка номера телефона
  * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { required, phone } from '@reformer/core/validators';
  *
- * // Внутри FieldConfig схемы формы:
- * phone: {
- *   value: model.$.phone,
- *   component: Input,
- *   validators: [required(), phone({ format: 'ru' })],
- * },
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.phone, [required(), phone({ format: 'ru' })]);
+ * });
  * ```
  */
-export declare function phone<TForm = unknown, TField extends string | null | undefined = string>(options?: PhoneValidatorOptions): Validator<TForm, TField>;
+export declare function phone(options?: PhoneValidatorOptions): Rule<string | null | undefined>;

package/dist/form/validators/required.d.ts

@@ -0,0 +1,29 @@
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
+/**
+ * Фабрика валидатора обязательного поля.
+ *
+ * Возвращает чистую функцию-валидатор `(value, control, root)`. Передаётся в `validate()`.
+ *
+ * Пустыми считаются: `null`, `undefined`, `''` (пустая строка), `[]` (пустой массив —
+ * обязательный multi-select / FieldArray без выбранных элементов), `NaN` (так выглядит очищенный
+ * числовой ввод).
+ * Для boolean полей требуется значение `true`.
+ *
+ * @param options - Опции валидатора ({@link RuleOptions}): `code`, `params`
+ * @returns Правило {@link Rule} для поля схемы
+ *
+ * @example Обязательные поля в схеме формы
+ * ```typescript
+ * import { defineValidation, validate } from '@reformer/core/validation';
+ * import { required } from '@reformer/core/validators';
+ *
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.email, [required()]);
+ *   validate(model.$.phone, [required({ code: 'phone.required' })]);
+ *   validate(model.$.agreeToTerms, [required({ code: 'agreeToTerms.required' })]);
+ * });
+ * ```
+ */
+export declare function required(options?: RuleOptions): Rule<unknown>;