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

package/dist/form/factories/node-factory.d.ts

@@ -11,7 +11,7 @@ import { ConfigWithSchema, ConfigWithValue, UnknownRecord } from '../types/index
  * import { NodeFactory } from '@reformer/core';
  *
  * const factory = new NodeFactory();
- * const node = factory.createNode({ value: '', component: InputField }); // → FieldNode<string>
+ * const node = factory.createNode({ value: '', component: Input }); // → FieldNode<string>
  * ```
  */
 export declare class NodeFactory {
@@ -37,25 +37,25 @@ export declare class NodeFactory {
      * // FieldNode
      * const field = factory.createNode({
      *   value: 'test@mail.com',
-     *   component: InputField,
+     *   component: Input,
      *   validators: [required, email]
      * });
      *
      * // GroupNode
      * const group = factory.createNode({
-     *   email: { value: '', component: InputField },
-     *   password: { value: '', component: InputField }
+     *   email: { value: '', component: Input },
+     *   password: { value: '', component: Input }
      * });
      *
      * // ArrayNode (объект)
      * const array = factory.createNode({
-     *   schema: { title: { value: '', component: InputField } },
+     *   schema: { title: { value: '', component: Input } },
      *   initialItems: [{ title: 'Item 1' }]
      * });
      *
      * // ArrayNode (массив) - новый формат
      * const array2 = factory.createNode([
-     *   { title: { value: '', component: InputField } }, // schema
+     *   { title: { value: '', component: Input } }, // schema
      *   { title: 'Item 1' }, // initial item 1
      *   { title: 'Item 2' }  // initial item 2
      * ]);
@@ -80,7 +80,7 @@ export declare class NodeFactory {
      *
      * // Массив с начальными элементами
      * const array = factory.createArrayNodeFromArray([
-     *   { title: { value: '', component: InputField } }, // schema
+     *   { title: { value: '', component: Input } }, // schema
      *   { title: 'Item 1' }, // initial value
      *   { title: 'Item 2' }  // initial value
      * ]);
@@ -94,7 +94,7 @@ export declare class NodeFactory {
      * ✅ НОВОЕ: Извлечено из GroupNode для централизации логики
      *
      * Преобразует схему формы в объект со значениями:
-     * - `{ name: { value: 'John', component: InputField } } → { name: 'John' }`
+     * - `{ name: { value: 'John', component: Input } } → { name: 'John' }`
      * - Поддерживает вложенные группы
      * - Поддерживает массивы
      *
@@ -106,10 +106,10 @@ export declare class NodeFactory {
      * const factory = new NodeFactory();
      *
      * const schema = {
-     *   name: { value: 'John', component: InputField },
-     *   age: { value: 30, component: InputField },
+     *   name: { value: 'John', component: Input },
+     *   age: { value: 30, component: Input },
      *   address: {
-     *     city: { value: 'Moscow', component: InputField }
+     *     city: { value: 'Moscow', component: Input }
      *   }
      * };
      *
@@ -132,7 +132,7 @@ export declare class NodeFactory {
      * ```typescript
      * const factory = new NodeFactory();
      *
-     * factory.isFieldConfig({ value: '', component: InputField }); // true
+     * factory.isFieldConfig({ value: '', component: Input }); // true
      * factory.isFieldConfig({ email: { value: '' } }); // false
      * factory.isFieldConfig(null); // false
      * ```
@@ -155,7 +155,7 @@ export declare class NodeFactory {
      * const factory = new NodeFactory();
      *
      * factory.isArrayConfig({ schema: {}, initialItems: [] }); // true
-     * factory.isArrayConfig({ value: '', component: InputField }); // false
+     * factory.isArrayConfig({ value: '', component: Input }); // false
      * factory.isArrayConfig({ email: { value: '' } }); // false
      * ```
      */
@@ -176,11 +176,11 @@ export declare class NodeFactory {
      * const factory = new NodeFactory();
      *
      * factory.isGroupConfig({
-     *   email: { value: '', component: InputField },
-     *   password: { value: '', component: InputField }
+     *   email: { value: '', component: Input },
+     *   password: { value: '', component: Input }
      * }); // true
      *
-     * factory.isGroupConfig({ value: '', component: InputField }); // false
+     * factory.isGroupConfig({ value: '', component: Input }); // false
      * factory.isGroupConfig({ schema: {} }); // false
      * factory.isGroupConfig(null); // false
      * ```

package/dist/form/nodes/array-node.d.ts

@@ -11,8 +11,8 @@ import { FormProxy } from '../types/form-proxy';
  * @example
  * ```typescript
  * const array = new ArrayNode({
- *   title: { value: '', component: InputField },
- *   price: { value: 0, component: InputField },
+ *   title: { value: '', component: Input },
+ *   price: { value: 0, component: Input },
  * });
  *
  * array.push({ title: 'Item 1', price: 100 });
@@ -141,7 +141,7 @@ export declare class ArrayNode<T extends object> extends FormNode<T[]> {
      * @example
      * ```typescript
      * const arrayNode = new ArrayNode(
-     *   { name: { value: '', component: InputField } },
+     *   { name: { value: '', component: Input } },
      *   [{ name: 'Initial 1' }, { name: 'Initial 2' }]
      * );
      *

package/dist/form/nodes/field-node.d.ts

@@ -11,7 +11,7 @@ import { FieldConfig, FieldStatus, ValidationError } from '../types/index';
  * ```typescript
  * const field = new FieldNode({
  *   value: '',
- *   component: InputField,
+ *   component: Input,
  *   validators: [required, email],
  * });
  *
@@ -103,7 +103,7 @@ export declare class FieldNode<T> extends FormNode<T> {
      *
      * @example
      * ```typescript
-     * const field = new FieldNode({ value: 'initial', component: InputField });
+     * const field = new FieldNode({ value: 'initial', component: Input });
      *
      * field.setValue('changed');
      * field.reset('temp value');
@@ -202,7 +202,7 @@ export declare class FieldNode<T> extends FormNode<T> {
      * const form = createForm({
      *   email: {
      *     value: '',
-     *     component: InputField,
+     *     component: Input,
      *     updateOn: 'submit', // Изначально валидация только при submit
      *     validators: [required, email],
      *   },

package/dist/form/nodes/group-node.d.ts

@@ -15,8 +15,8 @@ import { SubmitOptions, SubmitResult } from '../form-submitter';
  * @example
  * ```typescript
  * const form = new GroupNode({
- *   email: { valueSignal: model.$.email, component: InputField },
- *   password: { valueSignal: model.$.password, component: InputField },
+ *   email: { valueSignal: model.$.email, component: Input },
+ *   password: { valueSignal: model.$.password, component: Input },
  * });
  *
  * // Прямой доступ к полям через Proxy
@@ -136,8 +136,8 @@ export declare class GroupNode<T> extends FormNode<T> {
      * @example
      * ```typescript
      * const form = new GroupNode({
-     *   email: { value: '', component: InputField },
-     *   name: { value: '', component: InputField },
+     *   email: { value: '', component: Input },
+     *   name: { value: '', component: Input },
      * });
      *
      * const proxy = form.getProxy();
@@ -189,11 +189,11 @@ export declare class GroupNode<T> extends FormNode<T> {
      * @example
      * ```typescript
      * const form = new GroupNode({
-     *   email: { value: '', component: InputField },
+     *   email: { value: '', component: Input },
      *   address: {
-     *     city: { value: '', component: InputField }
+     *     city: { value: '', component: Input }
      *   },
-     *   items: [{ name: { value: '', component: InputField } }]
+     *   items: [{ name: { value: '', component: Input } }]
      * });
      *
      * form.getFieldByPath('email');           // FieldNode

package/dist/form/nodes/model-array-node.d.ts

@@ -36,8 +36,8 @@ export interface ModelArrayControl<TItem extends object> {
  * const model = createModel<{ rows: { name: string; qty: number }[] }>({ rows: [] });
  *
  * const rowItem = (item: FormModel<{ name: string; qty: number }>) => ({
- *   name: { value: item.$.name, component: InputField },
- *   qty: { value: item.$.qty, component: InputField },
+ *   name: { value: item.$.name, component: Input },
+ *   qty: { value: item.$.qty, component: Input },
  * });
  *
  * const form = createForm({

package/dist/form/types/contracts.d.ts

@@ -75,7 +75,13 @@ export type AsyncValidatorFn<T = FormValue> = (value: T, options?: AsyncValidato
  */
 export interface ValidationError {
     code: string;
+    /**
+     * Готовый текст ошибки. Пустая строка — «автор правила текста не задавал»: отображаемую строку
+     * тогда даёт резолвер по `code` (словарь локали `validation.<code>`).
+     */
     message: string;
+    /** Ключ сообщения в словаре приложения; при наличии в активной локали важнее `message`. */
+    messageKey?: string;
     params?: Record<string, FormValue>;
     /** Severity level: 'error' (default) blocks submission, 'warning' shows message but allows submission */
     severity?: 'error' | 'warning';

package/dist/form/types/deep-schema.d.ts

@@ -89,14 +89,14 @@ type NonEmptyFieldConfig<T> = RequireAtLeastOne<FieldConfig<T>>;
  * }
  *
  * const schema: FormSchema<Form> = {
- *   name: { value: '', component: InputField },
+ *   name: { value: '', component: Input },
  *   address: {
- *     city: { value: '', component: InputField },
- *     street: { value: '', component: InputField },
+ *     city: { value: '', component: Input },
+ *     street: { value: '', component: Input },
  *   },
  *   items: [{
- *     title: { value: '', component: InputField },
- *     price: { value: 0, component: InputField },
+ *     title: { value: '', component: Input },
+ *     price: { value: 0, component: Input },
  *   }],
  * };
  * ```

package/dist/form/types/validation-schema.d.ts

@@ -17,8 +17,20 @@ export type Validator<TForm, TField> = (value: TField, scope: unknown, root: For
  */
 export interface ValidateOptions {
     /** Готовое сообщение об ошибке. Если не задано, валидаторы кладут `''`, и отображаемый текст
-     * резолвится из `code` (см. резолвер сообщений в `@reformer/cdk`). */
+     * берётся из словаря локали по `code` (`validation.<code>`; см. `resolveValidationError` в
+     * `@reformer/core/i18n`). Явное сообщение важнее словаря, но не переключается вместе с языком —
+     * для локализуемого текста используйте {@link ValidateOptions.messageKey}. */
     message?: string;
+    /**
+     * Ключ сообщения в словаре приложения — локализуемый текст автора правила. Если ключ есть в
+     * активной локали, он важнее и `message`, и текста по `code`; если нет — в ход идёт `message`.
+     *
+     * @example
+     * ```ts
+     * required({ messageKey: 'profile.name.required', message: 'Name is required' });
+     * ```
+     */
+    messageKey?: string;
     /** Параметры ошибки (подстановка в шаблон сообщения / i18n). */
     params?: Record<string, FormValue>;
 }

package/dist/form/validation/operators.d.ts

@@ -3,9 +3,13 @@ import { AsyncRule, Rule, ValidationSchema } from './types';
 /**
  * Синхронные правила поля.
  *
+ * Поле — лист либо массив целиком: `model.$.<массив>` — такая же ручка значения, и правило
+ * получает массив (мультивыбор, теги, список файлов).
+ *
  * @example
  * ```ts
  * validate(model.$.loanAmount, [required({ message: 'Сумма' }), min(50000)]);
+ * validate(model.$.tags, [required(), maxLength(3)]); // tags: string[] — массив как значение
  * ```
  */
 export declare function validate<TField>(sig: PathAwareSignal<TField>, rules: Rule<TField>[]): void;
@@ -35,7 +39,8 @@ export declare function validateWhen(cond: () => boolean, cb: () => void): void;
 export declare function cross<TSnapshot>(sig: PathAwareSignal<unknown>, fn: (form: TSnapshot) => ValidationError | null): void;
 /**
  * Применить под-правила к КАЖДОМУ элементу текущего массива модели.
- * `U extends object` — элементы должны быть под-моделями (объектами); для массива примитивов валидируйте лист напрямую.
+ * `U extends object` — элементы должны быть под-моделями (объектами); массив примитивов — одно
+ * значение поля, его проверяют целиком: `validate(model.$.<массив>, [...])`.
  */
 export declare function each<U extends object>(arr: ModelArray<U>, itemFn: (item: FormModel<U>) => void): void;
 /** Композиция под-схем в текущую (над той же моделью scope). Заменяет пошаговую группировку. */

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

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

package/dist/i18n/descriptor.d.ts

@@ -0,0 +1,54 @@
+import { Messages } from './locale';
+/**
+ * Бренд описателя. `Symbol.for` — чтобы описатель узнавался и через границу двух копий модуля
+ * (разные чанки, разные версии пакета на странице).
+ */
+export declare const MESSAGE_DESCRIPTOR: unique symbol;
+/**
+ * Описатель сообщения. Намеренно без ключей `value`, `array`, `item`, `component`: обход схемы в
+ * `createForm` узнаёт по ним узел, а описатель узлом не является.
+ */
+export interface MessageDescriptor {
+    readonly [MESSAGE_DESCRIPTOR]: true;
+    /** Ключ сообщения в словаре приложения. */
+    readonly key: string;
+    /** Значения подстановок. */
+    readonly values?: Readonly<Record<string, unknown>>;
+    /** Английский текст на случай, если ключа в локали нет. */
+    readonly defaultMessage?: string;
+}
+/** Текст, который можно задать строкой или описателем. */
+export type LocalizableText = string | MessageDescriptor;
+/**
+ * Создаёт описатель сообщения.
+ *
+ * @param key - Ключ в словаре приложения.
+ * @param values - Значения подстановок.
+ * @param defaultMessage - Английский текст на случай, если ключа в локали нет.
+ *
+ * @example
+ * ```ts
+ * { value: model.$.email, component: Input, componentProps: { label: msg('profile.email.label') } }
+ * ```
+ */
+export declare function msg(key: string, values?: Readonly<Record<string, unknown>>, defaultMessage?: string): MessageDescriptor;
+/** Является ли значение описателем сообщения. */
+export declare function isMessageDescriptor(value: unknown): value is MessageDescriptor;
+/**
+ * `msg` с типизированными ключами: принимает английский словарь приложения, проверяет ключ при
+ * компиляции и подставляет английский текст как `defaultMessage` — без провайдера и при промахе
+ * по локали форма покажет его, а не ключ.
+ *
+ * @param defaults - Английский словарь приложения.
+ *
+ * @example
+ * ```ts
+ * import appEn from './locales/en.json';
+ *
+ * export const { msg } = defineMessages(appEn);
+ * msg('profile.email.label'); // опечатка в ключе — ошибка компиляции
+ * ```
+ */
+export declare function defineMessages<D extends Messages>(defaults: D): {
+    msg(key: keyof D & string, values?: Readonly<Record<string, unknown>>): MessageDescriptor;
+};

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

@@ -0,0 +1,45 @@
+declare const _default: {
+  "format.fileSize.b": "{value} B",
+  "format.fileSize.kb": "{value} KB",
+  "format.fileSize.mb": "{value} MB",
+  "format.fileSize.gb": "{value} GB",
+  "format.fileSize.tb": "{value} TB",
+
+  "validation.required": "This field is required",
+  "validation.pattern": "Invalid format",
+  "validation.email": "Enter a valid email address",
+  "validation.url": "Enter a valid URL",
+  "validation.url_protocol": "The URL must use one of these protocols: {allowedProtocols}",
+  "validation.phone": "Enter a valid phone number",
+
+  "validation.min": "Must be at least {min}",
+  "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.isNumber": "Enter a number",
+  "validation.integer": "Enter a whole number",
+  "validation.multipleOf": "Must be a multiple of {multipleOf}",
+  "validation.nonNegative": "Must not be negative",
+  "validation.nonZero": "Must not be zero",
+
+  "validation.date_invalid": "Enter a valid date",
+  "validation.date_min": "The date must not be earlier than {minDate}",
+  "validation.date_max": "The date must not be later than {maxDate}",
+  "validation.date_past": "The date must not be in the past",
+  "validation.date_future": "The date must not be in the future",
+  "validation.date_min_age": "Age must be at least {minAge}",
+  "validation.date_max_age": "Age must be at most {maxAge}",
+
+  "validation.fileType": "File {fileName} has a type that is not allowed. Allowed: {accept}",
+  "validation.maxFileSize": "File {fileName} is larger than {maxFileSize}",
+  "validation.minFileSize": "File {fileName} is smaller than {minFileSize}",
+  "validation.maxFiles": "No more than {maxFiles, plural, one{# file} other{# files}}",
+  "validation.minFiles": "At least {minFiles, plural, one{# file} other{# files}}",
+  "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}"
+}
+;
+
+export default _default;

package/dist/i18n/loader.d.ts

@@ -0,0 +1,71 @@
+import { FormLocale, Messages } from './locale';
+/** Что может вернуть источник: локаль целиком, её часть, голый словарь или ничего. */
+export type LocaleSourceResult = Partial<FormLocale> | Messages | null | undefined;
+/**
+ * Источник локали. Получает код языка, отдаёт локаль или словарь — сразу или промисом.
+ * `null`/`undefined` означает «для этого языка у меня ничего нет» и ошибкой не считается.
+ */
+export type LocaleSource = (code: string) => LocaleSourceResult | Promise<LocaleSourceResult>;
+/** Загрузчик локалей с кэшем. */
+export interface LocaleLoader {
+    /** Загрузить локаль языка. Повторный вызов возвращает тот же промис и ту же локаль. */
+    (code: string): Promise<FormLocale>;
+    /** Уже загруженная локаль или `undefined`. Позволяет провайдеру отрисоваться синхронно. */
+    peek(code: string): FormLocale | undefined;
+    /** То же, что вызов загрузчика; имя для чтения в коде старта приложения. */
+    preload(code: string): Promise<FormLocale>;
+}
+/**
+ * Собирает загрузчик из источников. Источники опрашиваются параллельно, а сливаются по порядку:
+ * поздний перекрывает ранний. Результат кэшируется по коду языка, идущий запрос не дублируется.
+ * Отказ любого источника — отказ загрузки; из кэша такой запрос удаляется, и следующая попытка
+ * пойдёт заново. Источник, которому можно промахнуться, приложение оборачивает само:
+ * `(code) => source(code).catch(() => null)`.
+ *
+ * Код языка у результата — всегда запрошенный: по нему работает `Intl`, и он не должен зависеть
+ * от того, что написано внутри файла.
+ *
+ * @param sources - Источники в порядке возрастания приоритета.
+ *
+ * @example
+ * ```ts
+ * import { createLocaleLoader, fetchMessages } from '@reformer/core/i18n';
+ * import { loadKitLocale } from '@reformer/ui-kit/locale';
+ *
+ * export const loadLocale = createLocaleLoader([
+ *   loadKitLocale,                                    // подписи кита — чанк нужного языка
+ *   fetchMessages((code) => `/locales/${code}.json`), // ключи приложения и правки — с сервера
+ * ]);
+ * ```
+ */
+export declare function createLocaleLoader(sources: readonly LocaleSource[]): LocaleLoader;
+/**
+ * Источник локали по сети: забирает JSON по адресу, построенному из кода языка. Файл может быть
+ * словарём (`{ "profile.title": "Профиль" }`) или локалью целиком (`{ "code": "ru", "messages": … }`).
+ * Ответ не `2xx` — ошибка загрузки.
+ *
+ * @param url - Адрес файла для языка.
+ * @param init - Параметры запроса, передаются в `fetch` как есть.
+ *
+ * @example
+ * ```ts
+ * fetchMessages((code) => `/locales/${code}.json`);
+ * ```
+ */
+export declare function fetchMessages(url: (code: string) => string, init?: RequestInit): LocaleSource;
+/**
+ * Источник встроенных локалей пакета: по чанку на язык. Язык ищется точно, затем по основной части
+ * кода (`ru-RU` → `ru`). Языка нет — источник отдаёт `null`: подписи пакета останутся английскими,
+ * пока приложение не даст их своим источником.
+ *
+ * @param loaders - Код языка → ленивый импорт его локали.
+ *
+ * @example
+ * ```ts
+ * export const loadKitLocale = bundledLocaleSource({
+ *   en: () => import('./en').then((m) => m.en),
+ *   ru: () => import('./ru').then((m) => m.ru),
+ * });
+ * ```
+ */
+export declare function bundledLocaleSource(loaders: Readonly<Record<string, () => Promise<FormLocale>>>): LocaleSource;

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

@@ -0,0 +1,39 @@
+import { FormLocale } from './locale';
+/** Функция загрузки локали. `peek` — необязательный синхронный кэш (есть у `createLocaleLoader`). */
+export interface LocaleLoad {
+    (code: string): Promise<FormLocale>;
+    peek?(code: string): FormLocale | undefined;
+}
+/** Состояние хранилища. Объект неизменяемый: новая ссылка — новое состояние. */
+export interface LocaleStoreState {
+    /** Запрошенный язык. Пока `pending`, может отличаться от языка `locale`. */
+    readonly lang: string;
+    /** Локаль, которая сейчас на экране; `null` — ни одна ещё не загружена. */
+    readonly locale: FormLocale | null;
+    /** Идёт загрузка запрошенного языка. */
+    readonly pending: boolean;
+    /** Ошибка последней загрузки; сбрасывается следующей удачной. */
+    readonly error: unknown;
+}
+/** Хранилище активной локали. */
+export interface LocaleStore {
+    getState(): LocaleStoreState;
+    subscribe(listener: () => void): () => void;
+    /** Запросить язык. Повторный запрос того же языка, пока он грузится или уже показан, — no-op. */
+    setLang(lang: string): void;
+}
+/** Настройки хранилища. */
+export interface LocaleStoreOptions {
+    /** Вызывается при отказе загрузки языка, который всё ещё запрошен. */
+    readonly onError?: (error: unknown, lang: string) => void;
+}
+/**
+ * Создаёт хранилище. Загрузка при создании НЕ начинается: начальное состояние считается чисто —
+ * из кэша загрузчика, если локаль там уже есть, — а запрос уходит на первый {@link LocaleStore.setLang}.
+ * Это позволяет создавать хранилище прямо в рендере.
+ *
+ * @param load - Загрузчик локалей.
+ * @param lang - Начальный язык.
+ * @param options - См. {@link LocaleStoreOptions}.
+ */
+export declare function createLocaleStore(load: LocaleLoad, lang: string, options?: LocaleStoreOptions): LocaleStore;

package/dist/i18n/locale.d.ts

@@ -0,0 +1,90 @@
+import { MessagePattern } from './message-format';
+/** Плоский словарь: ключ → сообщение в формате ICU (см. `message-format.ts`). */
+export type Messages = Readonly<Record<string, string>>;
+/** День недели, с которого начинается календарь: `0` — воскресенье, `1` — понедельник. */
+export type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Локаль формы.
+ *
+ * @example
+ * ```ts
+ * const ru: FormLocale = {
+ *   code: 'ru',
+ *   weekStartsOn: 1,
+ *   messages: { 'kit.select.selected': 'Выбрано: {count}' },
+ * };
+ * ```
+ */
+export interface FormLocale {
+    /** Код языка BCP 47 (`en`, `ru`, `pt-BR`): по нему работают `Intl` и множественные формы. */
+    readonly code: string;
+    /** Словарь сообщений. Ключа нет — пакет подставит встроенный английский. */
+    readonly messages: Messages;
+    /** Первый день недели календаря. По умолчанию — воскресенье. */
+    readonly weekStartsOn?: WeekStart;
+    /**
+     * Необязательное переопределение: объект локали `react-day-picker` / `date-fns`. Для ядра
+     * непрозрачен. Без него даты форматируются через `Intl` по {@link FormLocale.code}.
+     */
+    readonly dateLocale?: unknown;
+    /** Необязательное переопределение: формат даты в токенах `date-fns` для DatePicker. */
+    readonly dateFormat?: string;
+}
+/**
+ * Локаль «провайдера нет»: английский, пустой словарь. Каждый пакет при промахе по словарю берёт
+ * свою встроенную английскую таблицу, поэтому пустой словарь означает «всё по-английски».
+ */
+export declare const DEFAULT_LOCALE: FormLocale;
+/**
+ * Новая локаль на основе существующей: словари сливаются (ключи из `patch` важнее), остальные
+ * поля заменяются. Исходный объект не меняется.
+ *
+ * @param base - Локаль-основа, например поставляемая китом.
+ * @param patch - Свои ключи, переопределения китовых подписей и поля локали.
+ *
+ * @example
+ * ```ts
+ * import { ru } from '@reformer/ui-kit/locale/ru';
+ *
+ * const appRu = extendLocale(ru, {
+ *   messages: { 'profile.title': 'Профиль', 'kit.formWizard.submit': 'Отправить' },
+ * });
+ * ```
+ */
+export declare function extendLocale(base: FormLocale, patch: Partial<FormLocale>): FormLocale;
+/** `Object.hasOwn` без требования ES2022 к рантайму потребителя. */
+export declare function hasOwn(target: object, key: string): boolean;
+/** Что не так со словарём. */
+export interface LocaleIssue {
+    readonly key: string;
+    /**
+     * - `syntax` — сообщение не разбирается;
+     * - `missing` — ключ есть в образце, но его нет в словаре;
+     * - `extra` — ключа нет в образце;
+     * - `arguments` — набор подстановок не совпадает с образцом.
+     */
+    readonly kind: 'syntax' | 'missing' | 'extra' | 'arguments';
+    readonly message: string;
+}
+/**
+ * Имена аргументов сообщения, включая те, что встречаются только внутри веток `plural`/`select`.
+ *
+ * @param pattern - Результат `parseMessage`.
+ */
+export declare function messageArguments(pattern: MessagePattern, out?: Set<string>): Set<string>;
+/**
+ * Проверяет словарь: каждое сообщение разбирается, а при заданном образце — набор ключей и имена
+ * подстановок совпадают с ним. Нужна там, где компилятор не поможет: словарь пришёл по сети или
+ * написан вне репозитория. В рантайме вызывать не обязательно — битое или пропущенное сообщение
+ * и так откатится на встроенный английский; проверка нужна тестам и CI.
+ *
+ * @param messages - Проверяемый словарь.
+ * @param reference - Образец, обычно английский словарь того же пакета.
+ * @returns Список расхождений; пустой — словарь в порядке.
+ *
+ * @example
+ * ```ts
+ * expect(validateLocale(ruJson, enJson)).toEqual([]);
+ * ```
+ */
+export declare function validateLocale(messages: Messages, reference?: Messages): LocaleIssue[];