@reformer/core 11.0.0-beta.7 → 11.0.0-beta.9

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

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

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

@@ -1,22 +1,24 @@
-import { Validator, ValidateOptions } from '../types/validation-schema';
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
 /**
  * Фабрика валидатора, проверяющего что значение — валидная дата.
  *
- * Принимает `Date` или строку, парсимую в дату. Пустые значения (`''`/`null`/`undefined`)
- * пропускаются (используйте {@link required} для обязательности).
+ * Строгий формат: `Date` либо строка `YYYY-MM-DD` с существующим днём календаря. Строки в иных
+ * форматах (`'31.12.2024'`, `'March 7'`, дата со временем) — `date_invalid`. Пустые значения
+ * (`''`/`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
  *
- * @param options - Опции валидатора ({@link ValidateOptions}): `message`, `params`
- * @returns Чистый валидатор {@link Validator} для поля даты (`string | Date`)
+ * @param options - Опции валидатора ({@link RuleOptions}): `code`, `params`
+ * @returns Правило {@link Rule} для поля даты (`string | Date`)
  *
  * @example Проверка валидности даты
  * ```typescript
- * import { defineValidationSchema, validate } from '@reformer/core/validation';
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { required, isDate } from '@reformer/core/validators';
  *
  * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
- * const validation = defineValidationSchema<MyForm>(({ model }) => {
- *   validate(model.$.eventDate, [required(), isDate({ message: 'Введите корректную дату' })]);
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.eventDate, [required(), isDate({ code: 'eventDate.isDate' })]);
  * });
  * ```
  */
-export declare function isDate<TForm = unknown, TField extends string | Date | null | undefined = string | Date>(options?: ValidateOptions): Validator<TForm, TField>;
+export declare function isDate(options?: RuleOptions): Rule<string | Date | null | undefined>;

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

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

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

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

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

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

package/dist/form/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,19 +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 { defineValidationSchema, validate } from '@reformer/core/validation';
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { maxFileSize } from '@reformer/core/validators';
  *
  * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
- * const validation = defineValidationSchema<MyForm>(({ model }) => {
- *   validate(model.$.documents, [maxFileSize(5 * 1024 * 1024, { message: 'Файл больше 5 МБ' })]);
+ * 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

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

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

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

package/dist/form/validators/max-total-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';
 /**
  * Фабрика валидатора суммарного размера всех файлов.
  *
@@ -7,19 +8,19 @@ import { Validator, ValidateOptions } from '../types/validation-schema';
  * (используйте {@link required} для обязательности).
  *
  * @param maxTotal - Максимально допустимый суммарный размер в байтах (включительно)
- * @param options - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
+ * @param options - Опции валидатора ({@link RuleOptions}). В `params` ошибки автоматически
  *   попадают `maxTotalFileSize` и `actualTotal`.
- * @returns Чистый валидатор {@link Validator} для файла или массива файлов
+ * @returns Правило {@link Rule} для файла или массива файлов
  *
  * @example Суммарно не более 20 МБ
  * ```typescript
- * import { defineValidationSchema, validate } from '@reformer/core/validation';
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { maxTotalFileSize } from '@reformer/core/validators';
  *
  * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
- * const validation = defineValidationSchema<MyForm>(({ model }) => {
- *   validate(model.$.documents, [maxTotalFileSize(20 * 1024 * 1024, { message: 'Суммарно не более 20 МБ' })]);
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.documents, [maxTotalFileSize(20 * 1024 * 1024, { code: 'documents.maxTotalFileSize' })]);
  * });
  * ```
  */
-export declare function maxTotalFileSize<TForm = unknown, TField = unknown>(maxTotal: number, options?: ValidateOptions): Validator<TForm, TField>;
+export declare function maxTotalFileSize(maxTotal: number, options?: RuleOptions): Rule<unknown>;

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

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

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

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

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

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

package/dist/form/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,19 +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 { defineValidationSchema, validate } from '@reformer/core/validation';
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { minFileSize } from '@reformer/core/validators';
  *
  * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
- * const validation = defineValidationSchema<MyForm>(({ model }) => {
- *   validate(model.$.documents, [minFileSize(1, { message: 'Файл пустой' })]);
+ * 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

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

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

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

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

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