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

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

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

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

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

package/dist/form/validators/non-zero.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 { nonZero } from '@reformer/core/validators';
  *
  * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
- * const validation = defineValidationSchema<MyForm>(({ model }) => {
- *   validate(model.$.divisor, [nonZero({ message: 'Не может быть нулём' })]);
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.divisor, [nonZero({ code: 'divisor.nonZero' })]);
  * });
  * ```
  */
-export declare function nonZero<TForm = unknown, TField extends number | null | undefined = number>(options?: ValidateOptions): Validator<TForm, TField>;
+export declare function nonZero(options?: RuleOptions): Rule<number | null | undefined>;

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

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

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

package/dist/form/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,17 +25,17 @@ export interface PhoneValidatorOptions extends ValidateOptions {
  *
  * @param options - Опции валидатора {@link PhoneValidatorOptions}. В `params` ошибки
  *   автоматически попадает выбранный `format`.
- * @returns Чистый валидатор {@link Validator} для строкового поля
+ * @returns Правило {@link Rule} для строкового поля
  *
  * @example Проверка номера телефона
  * ```typescript
- * import { defineValidationSchema, validate } from '@reformer/core/validation';
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { required, phone } from '@reformer/core/validators';
  *
  * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
- * const validation = defineValidationSchema<MyForm>(({ model }) => {
+ * 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

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

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

@@ -1,14 +1,16 @@
-import { Validator, ValidateOptions } from '../types/validation-schema';
+import { RuleOptions } from '../types/validation-schema';
+import { Rule } from '../validation/types';
 /**
- * Опции валидатора {@link url}. Расширяют {@link ValidateOptions} (`message`, `params`)
+ * Опции валидатора {@link url}. Расширяют {@link RuleOptions} (`code`, `params`)
  * настройками проверки протокола.
  */
-export interface UrlValidatorOptions extends ValidateOptions {
-    /** Требовать наличие протокола (`http://` или `https://`). По умолчанию `false`. */
+export interface UrlValidatorOptions extends RuleOptions {
+    /** Требовать протокол (`схема://`). По умолчанию `false`: `example.com` допустим. */
     requireProtocol?: boolean;
     /**
-     * Список разрешённых протоколов (без `://`), например `['https']`. Если задан,
-     * значение с иным протоколом даёт ошибку с кодом `url_protocol`.
+     * Разрешённые протоколы (без `://`), сравнение без учёта регистра, например `['https']`. Не
+     * задан или пуст — `http` и `https`. Значение с иным протоколом даёт замечание `url_protocol`;
+     * при заданном списке — и значение без протокола.
      */
     allowedProtocols?: string[];
 }
@@ -16,23 +18,28 @@ export interface UrlValidatorOptions extends ValidateOptions {
  * Фабрика валидатора URL.
  *
  * Пустые значения (`''`/`null`/`undefined`) пропускаются (используйте {@link required}
- * для обязательности). При `requireProtocol` протокол обязателен; `allowedProtocols`
- * дополнительно ограничивает набор допустимых протоколов.
+ * для обязательности).
+ *
+ * Контракт адреса: разбор — `new URL`; хост — `localhost`, домен с буквенной зоной (в том числе
+ * кириллический и punycode), IPv4 или `[IPv6]`; порт допустим. Запрещены пробелы и userinfo
+ * (`user:pass@`). Протокол необязателен (`example.com`), пока не задан `requireProtocol`; по
+ * умолчанию разрешены `http` и `https`, чужой протокол — замечание `url_protocol` с
+ * `params.allowedProtocols`. Свой `code` из опций заменяет оба встроенных кода.
  *
  * @param options - Опции валидатора {@link UrlValidatorOptions}
- * @returns Чистый валидатор {@link Validator} для строкового поля
+ * @returns Правило {@link Rule} для строкового поля
  *
  * @example Проверка URL
  * ```typescript
- * import { defineValidationSchema, validate } from '@reformer/core/validation';
+ * import { defineValidation, validate } from '@reformer/core/validation';
  * import { required, url } from '@reformer/core/validators';
  *
  * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
- * const validation = defineValidationSchema<MyForm>(({ model }) => {
- *   validate(model.$.website, [required(), url({ message: 'Введите корректный URL' })]);
+ * const validation = defineValidation<MyForm>(({ model }) => {
+ *   validate(model.$.website, [required(), url({ code: 'website.url' })]);
  *   // Требовать протокол и ограничить схему только https:
  *   validate(model.$.homepage, [url({ requireProtocol: true, allowedProtocols: ['https'] })]);
  * });
  * ```
  */
-export declare function url<TForm = unknown, TField extends string | null | undefined = string>(options?: UrlValidatorOptions): Validator<TForm, TField>;
+export declare function url(options?: UrlValidatorOptions): Rule<string | null | undefined>;

package/dist/form/validators/validation-issue.d.ts

@@ -0,0 +1,8 @@
+import { ValidationIssue } from '../types/contracts';
+import { RuleOptions } from '../types/validation-schema';
+/**
+ * @param code - Встроенный код правила; по нему ищется текст в словаре локали (`validation.<code>`).
+ * @param options - Опции правила: свой код и дополнительные параметры.
+ * @param params - Параметры, которые правило заполняет само; параметры из `options` важнее.
+ */
+export declare function validationIssue(code: string, options: RuleOptions | undefined, params?: Record<string, unknown>): ValidationIssue;

package/dist/i18n/descriptor.d.ts

@@ -28,7 +28,7 @@ export type LocalizableText = string | MessageDescriptor;
  *
  * @example
  * ```ts
- * { value: model.$.email, component: Input, componentProps: { label: msg('profile.email.label') } }
+ * { model: model.$.email, component: Input, componentProps: { label: msg('profile.email.label') } }
  * ```
  */
 export declare function msg(key: string, values?: Readonly<Record<string, unknown>>, defaultMessage?: string): MessageDescriptor;

package/dist/i18n/en.json.d.ts

@@ -16,6 +16,8 @@ declare const _default: {
   "validation.max": "Must be at most {max}",
   "validation.minLength": "Enter at least {minLength, plural, one{# character} other{# characters}}",
   "validation.maxLength": "Enter no more than {maxLength, plural, one{# character} other{# characters}}",
+  "validation.minItems": "At least {minLength, plural, one{# item} other{# items}}",
+  "validation.maxItems": "No more than {maxLength, plural, one{# item} other{# items}}",
   "validation.isNumber": "Enter a number",
   "validation.integer": "Enter a whole number",
   "validation.multipleOf": "Must be a multiple of {multipleOf}",
@@ -38,7 +40,9 @@ declare const _default: {
   "validation.maxTotalFileSize": "The total size of the files exceeds {maxTotalFileSize}",
   "validation.fileExists": "File {fileName} has already been added",
   "validation.uploadAborted": "Upload cancelled",
-  "validation.uploadFailed": "Failed to upload {fileName}"
+  "validation.uploadFailed": "Failed to upload {fileName}",
+
+  "validation.ruleFailed": "Could not check this field. Try again"
 }
 ;
 

package/dist/i18n/locale-store.d.ts

@@ -21,11 +21,18 @@ export interface LocaleStore {
     subscribe(listener: () => void): () => void;
     /** Запросить язык. Повторный запрос того же языка, пока он грузится или уже показан, — no-op. */
     setLang(lang: string): void;
+    /** Повторить запрос языка, загрузка которого упала. Без ошибки — no-op. */
+    retry(): void;
 }
 /** Настройки хранилища. */
 export interface LocaleStoreOptions {
     /** Вызывается при отказе загрузки языка, который всё ещё запрошен. */
     readonly onError?: (error: unknown, lang: string) => void;
+    /**
+     * Локаль, которая уже на экране (прежнее хранилище провайдера с другим загрузчиком). Пока новый
+     * загрузчик не отдал язык, на экране остаётся она, а не «ничего не загружено».
+     */
+    readonly previous?: FormLocale;
 }
 /**
  * Создаёт хранилище. Загрузка при создании НЕ начинается: начальное состояние считается чисто —

package/dist/i18n/message-format.d.ts

@@ -8,7 +8,8 @@
  *   категории берутся из {@link Intl.PluralRules} активной локали, `#` подставляет само число через
  *   {@link Intl.NumberFormat};
  * - **выбор по значению** — `{gender, select, male{он} female{она} other{оно}}`;
- * - **экранирование** — апострофом, как в ICU: `'{'` → `{`, `'}'` → `}`, `''` → `'`.
+ * - **экранирование** — апострофом, как в ICU: `'{'` → `{`, `'}'` → `}`, `''` → `'`; как в
+ *   `intl-messageformat`, литерал открывает и апостроф перед `<` и `>`.
  *
  * Три свойства, ради которых формат устроен именно так:
  *
@@ -17,9 +18,12 @@
  *    `{count, plural, ...}` выведет эти символы, а не выполнит их. Замена регулярным выражением
  *    такой гарантии не даёт.
  * 2. **Синтаксис — честное подмножество ICU.** Любое сообщение, которое понимает этот модуль,
- *    `intl-messageformat` (в режиме `ignoreTag`, со строковыми и числовыми значениями) понимает так
- *    же и выводит посимвольно то же самое; это проверено дифференциальным тестом на общем наборе
- *    сообщений (`tests/i18n/message-format.differential.test.ts`). Отсюда страховка из контракта:
+ *    `intl-messageformat` (в режиме `ignoreTag`, со строковыми значениями и конечными числами;
+ *    значение `plural` — число) понимает так же и выводит посимвольно то же самое; это проверено
+ *    дифференциальным и property-тестами (`tests/i18n/message-format.differential.test.ts`,
+ *    `message-format.property.test.ts`). Чего не понимает эталон — повтор ключа ветки, `=N` с не
+ *    целым числом или в `select`, символы синтаксиса ICU в имени, — не понимает и этот модуль.
+ *    Отсюда страховка из контракта:
  *    если подмножества перестанет хватать, библиотека подставляется под тот же вызов, и словари
  *    переписывать не придётся.
  * 3. **Ошибка синтаксиса и отсутствие ветки `other` — отказ на разборе**, а не молчаливая
@@ -30,6 +34,8 @@
  *   отвергаются на разборе. Сообщение с ними не пройдёт в словарь, а не отформатируется молча
  *   неправильно. Заметь: голое `{n}` форматируется как `String(n)` и здесь, и в `intl-messageformat`
  *   (`{year}` → `2026`, а не `2 026`); по локали форматируется только `#` внутри `plural`.
+ *   Вложенность аргументов — не глубже 100 уровней: глубже рекурсивный разбор исчерпал бы стек
+ *   (`RangeError`) вместо внятного отказа.
  * - **Пропущенный аргумент не бросает исключение**, а подставляет заметный маркер `⟦name⟧`: строка
  *   интерфейса не должна ронять панель. Поведение настраивается через `onMissingArgument`.
  *
@@ -73,6 +79,20 @@ export interface MessageFormatOptions {
 export declare class MessageSyntaxError extends Error {
     readonly name = "MessageSyntaxError";
 }
+/**
+ * Код языка, пригодный для `Intl`. Некорректный (не BCP 47) заменяется на `en` — с предупреждением
+ * в dev, один раз на код. Код может прийти извне (язык из адресной строки), и `RangeError` из
+ * `Intl` ронял бы рендер на первом же `plural`, числе или дате.
+ *
+ * @param code - Код языка локали.
+ * @returns Тот же код либо `en`.
+ */
+export declare function intlLocale(code: string): string;
+/**
+ * Значение как текст. Значение, которое нельзя привести к строке (`Object.create(null)`, объект
+ * с бросающим `toString`), — пустая строка: одно такое значение не роняет всё сообщение.
+ */
+export declare function toText(value: unknown): string;
 /**
  * Разбирает сообщение в дерево. Бросает {@link MessageSyntaxError} на ошибке синтаксиса и на
  * `plural`/`select` без ветки `other`.

package/dist/i18n/ru.json.d.ts

@@ -16,6 +16,8 @@ declare const _default: {
   "validation.max": "Не больше {max}",
   "validation.minLength": "Не меньше {minLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
   "validation.maxLength": "Не больше {maxLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
+  "validation.minItems": "Не меньше {minLength, plural, one{# элемента} few{# элементов} many{# элементов} other{# элемента}}",
+  "validation.maxItems": "Не больше {maxLength, plural, one{# элемента} few{# элементов} many{# элементов} other{# элемента}}",
   "validation.isNumber": "Введите число",
   "validation.integer": "Введите целое число",
   "validation.multipleOf": "Число должно быть кратно {multipleOf}",
@@ -38,7 +40,9 @@ declare const _default: {
   "validation.maxTotalFileSize": "Суммарный размер файлов больше {maxTotalFileSize}",
   "validation.fileExists": "Файл {fileName} уже добавлен",
   "validation.uploadAborted": "Загрузка прервана",
-  "validation.uploadFailed": "Не удалось загрузить файл {fileName}"
+  "validation.uploadFailed": "Не удалось загрузить файл {fileName}",
+
+  "validation.ruleFailed": "Не удалось проверить поле. Повторите попытку"
 }
 ;
 

package/dist/i18n/translator.d.ts

@@ -1,5 +1,16 @@
 import { FormLocale, Messages } from './locale';
 import { MessageValues } from './message-format';
+/**
+ * Сообщение произвольного словаря по правилам языка `code`; `undefined`, если ключа нет, значение
+ * не строка либо шаблон не разобрался. Разбор кэшируется по объекту словаря, поэтому словарь
+ * должен быть стабильной ссылкой (константа модуля), а не литералом в теле компонента.
+ *
+ * @param messages - Словарь: ключ → шаблон сообщения. Нестроковые значения пропускаются.
+ * @param code - Код языка для `plural` и форматирования чисел.
+ * @param key - Ключ сообщения.
+ * @param values - Значения подстановок.
+ */
+export declare function formatMessage(messages: Readonly<Record<string, unknown>>, code: string, key: string, values?: MessageValues): string | undefined;
 /**
  * Перевод ключа пакета: словарь локали, затем встроенная английская таблица пакета, затем сам
  * ключ. Английская таблица форматируется по английским правилам — её множественные формы и

package/dist/i18n/validation-message.d.ts

@@ -1,18 +1,53 @@
-import { ValidationError } from '../form/types/contracts';
+import { ValidationIssue } from '../form/types/contracts';
 import { I18nHandle } from './translator';
 /**
- * Отображаемый текст ошибки валидации. Порядок источников — в шапке модуля.
+ * Текст замечания в словаре формы: шаблон с параметрами либо функция.
  *
- * @param error - Ошибка от правила: `code`, `message`, `messageKey`, `params`.
+ * Шаблон — тот же формат сообщений, что в словарях локали: `{minLength}`, `plural`, `select`.
+ * Параметры в него приходят подготовленными: дата — по языку, массив — перечнем, размер файла —
+ * строкой с единицей. Число шаблон печатает как есть, без разрядов: «50 000 ₽» пишут готовым
+ * текстом либо функцией, которая форматирует число сама.
+ *
+ * @example
+ * ```ts
+ * const byTemplate: IssueMessage = 'Не меньше {minLength} символов';
+ * const byFunction: IssueMessage = (params, i18n) => `Не меньше ${i18n.number(Number(params.min))} ₽`;
+ * ```
+ */
+export type IssueMessage = string | ((params: Readonly<Record<string, unknown>>, i18n: I18nHandle) => string);
+/**
+ * Словарь формы: код замечания → текст. Ключ — `code` замечания: встроенный (`required`) либо
+ * свой (`loanAmount.required`).
+ */
+export type IssueMessages = Readonly<Record<string, IssueMessage>>;
+/**
+ * Объявить словарь формы. Возвращает аргумент как есть — функция нужна типам: коды остаются
+ * литералами, а значения проверяются как {@link IssueMessage}.
+ *
+ * @example
+ * ```ts
+ * export const loanMessages = defineIssueMessages({
+ *   'loanAmount.required': 'Укажите сумму кредита',
+ *   'loanPurpose.minLength': 'Минимум {minLength} символов',
+ *   'carYear.max': (params) => `Не позднее ${String(params.max)}`,
+ * });
+ * ```
+ */
+export declare function defineIssueMessages<const Messages extends IssueMessages>(messages: Messages): Messages;
+/**
+ * Отображаемый текст замечания валидации. Порядок источников — в шапке модуля.
+ *
+ * @param issue - Замечание от правила: `code` и `params`.
  * @param i18n - Ручка активной локали (`createI18n` / `useI18n`).
+ * @param messages - Словарь формы; его записи важнее словаря локали.
  *
  * @example
  * ```ts
- * resolveValidationError({ code: 'minLength', message: '', params: { minLength: 8 } }, i18n);
+ * resolveIssueMessage({ code: 'minLength', params: { minLength: 8 } }, i18n);
  * // 'Enter at least 8 characters' · в русской локали — 'Не меньше 8 символов'
  *
- * resolveValidationError({ code: 'required', message: 'Укажите телефон' }, i18n);
- * // 'Укажите телефон' — явное сообщение автора важнее словаря
+ * resolveIssueMessage({ code: 'phone.required' }, i18n, { 'phone.required': 'Укажите телефон' });
+ * // 'Укажите телефон' — текст поля из словаря формы
  * ```
  */
-export declare function resolveValidationError(error: ValidationError, i18n: I18nHandle): string;
+export declare function resolveIssueMessage(issue: ValidationIssue, i18n: I18nHandle, messages?: IssueMessages): string;

package/dist/i18n.d.ts

@@ -1,11 +1,10 @@
 /**
- * Подпуть `@reformer/core/i18n` — локализация форм: объект локали, загрузка словарей, провайдер,
- * перевод и форматирование, описатели авторских подписей.
+ * Подпуть `@reformer/core/i18n` — локализация форм без React: объект локали, загрузка словарей,
+ * перевод и форматирование, тексты ошибок, описатели авторских подписей.
  *
- * Вторая точка сшивки слоёв после корневого `index.ts`: чистая часть лежит в `src/i18n/`
- * (без React), привязка к React — в `src/platforms/react/i18n/`. Из главной бочки `@reformer/core`
- * этот модуль не реэкспортируется: канонический импорт один, а контекст обязан существовать в
- * единственном экземпляре на все пакеты `@reformer/*`.
+ * Провайдер и хуки (`I18nProvider`, `useI18n`, `useMessages`, `useIssueMessage`) отдаёт вход
+ * `@reformer/core/react`. Из главной бочки `@reformer/core` этот модуль не реэкспортируется:
+ * канонический импорт один.
  *
  * @group i18n
  * @module i18n
@@ -20,12 +19,8 @@ export { createLocaleStore } from './i18n/locale-store';
 export type { LocaleLoad, LocaleStore, LocaleStoreState, LocaleStoreOptions, } from './i18n/locale-store';
 export { createI18n, translateBuiltin } from './i18n/translator';
 export type { I18nHandle } from './i18n/translator';
-export { resolveValidationError } from './i18n/validation-message';
+export { resolveIssueMessage, defineIssueMessages } from './i18n/validation-message';
+export type { IssueMessage, IssueMessages } from './i18n/validation-message';
 export { msg, defineMessages, isMessageDescriptor, MESSAGE_DESCRIPTOR } from './i18n/descriptor';
 export type { MessageDescriptor, LocalizableText } from './i18n/descriptor';
 export { resolveLocalized } from './i18n/resolve-localized';
-export { I18nProvider } from './platforms/react/i18n/provider';
-export type { I18nProviderProps, I18nStaticProviderProps, I18nLoadingProviderProps, } from './platforms/react/i18n/provider';
-export { useI18n, useMessages, useValidationMessage } from './platforms/react/i18n/hooks';
-export { I18N_CONTEXT_MARKER } from './platforms/react/i18n/context';
-export type { I18nContextValue } from './platforms/react/i18n/context';