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

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[];

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

@@ -0,0 +1,116 @@
+/**
+ * Формат сообщений интерфейса — подмножество ICU MessageFormat без зависимостей.
+ *
+ * Один на подписи форм (`@reformer/core/i18n`) и на интерфейс билдера. Поддерживает ровно то, что
+ * им нужно, и ничего сверх:
+ * - **подстановка** — `Открыт файл {name}`;
+ * - **множественные формы** — `{count, plural, one{# файл} few{# файла} many{# файлов} other{# файла}}`,
+ *   категории берутся из {@link Intl.PluralRules} активной локали, `#` подставляет само число через
+ *   {@link Intl.NumberFormat};
+ * - **выбор по значению** — `{gender, select, male{он} female{она} other{оно}}`;
+ * - **экранирование** — апострофом, как в ICU: `'{'` → `{`, `'}'` → `}`, `''` → `'`.
+ *
+ * Три свойства, ради которых формат устроен именно так:
+ *
+ * 1. **Сообщение разбирается в дерево, а не форматируется заменами по строке.** Значение аргумента
+ *    попадает в результат как текст и повторно не разбирается: `{name}` со значением
+ *    `{count, plural, ...}` выведет эти символы, а не выполнит их. Замена регулярным выражением
+ *    такой гарантии не даёт.
+ * 2. **Синтаксис — честное подмножество ICU.** Любое сообщение, которое понимает этот модуль,
+ *    `intl-messageformat` (в режиме `ignoreTag`, со строковыми и числовыми значениями) понимает так
+ *    же и выводит посимвольно то же самое; это проверено дифференциальным тестом на общем наборе
+ *    сообщений (`tests/i18n/message-format.differential.test.ts`). Отсюда страховка из контракта:
+ *    если подмножества перестанет хватать, библиотека подставляется под тот же вызов, и словари
+ *    переписывать не придётся.
+ * 3. **Ошибка синтаксиса и отсутствие ветки `other` — отказ на разборе**, а не молчаливая
+ *    неправильная строка в интерфейсе. Разбор словаря на старте и в CI ловит их до пользователя.
+ *
+ * Отличий от `intl-messageformat` в выводе нет; отличий два, и оба — сужение, а не расхождение:
+ * - **Грамматика уже.** Типы аргументов `number`, `date`, `time`, `selectordinal` не поддержаны и
+ *   отвергаются на разборе. Сообщение с ними не пройдёт в словарь, а не отформатируется молча
+ *   неправильно. Заметь: голое `{n}` форматируется как `String(n)` и здесь, и в `intl-messageformat`
+ *   (`{year}` → `2026`, а не `2 026`); по локали форматируется только `#` внутри `plural`.
+ * - **Пропущенный аргумент не бросает исключение**, а подставляет заметный маркер `⟦name⟧`: строка
+ *   интерфейса не должна ронять панель. Поведение настраивается через `onMissingArgument`.
+ *
+ * @module i18n/message-format
+ */
+/** Узел разобранного сообщения. */
+export type MessageNode = {
+    readonly kind: 'text';
+    readonly value: string;
+} | {
+    readonly kind: 'arg';
+    readonly name: string;
+} | {
+    readonly kind: 'number';
+    readonly name: string;
+} | {
+    readonly kind: 'plural';
+    readonly name: string;
+    readonly branches: MessageBranches;
+} | {
+    readonly kind: 'select';
+    readonly name: string;
+    readonly branches: MessageBranches;
+};
+/** Разобранное сообщение — плоская последовательность узлов. */
+export type MessagePattern = readonly MessageNode[];
+/** Ветки `plural`/`select`: категория CLDR (`one`, `few`, …), точное совпадение (`=0`) или значение `select`. */
+export type MessageBranches = ReadonlyMap<string, MessagePattern>;
+/** Значения аргументов сообщения. */
+export type MessageValues = Readonly<Record<string, unknown>>;
+/** Настройки форматирования. */
+export interface MessageFormatOptions {
+    /**
+     * Что подставить вместо аргумента, которого нет в значениях (или чьё значение не число там, где
+     * ожидалось число). По умолчанию — заметный маркер `⟦name⟧`, тот же приём, что и для пропущенного
+     * ключа: пропуск должен попадаться разработчику, а не пользователю.
+     */
+    readonly onMissingArgument?: (name: string) => string;
+}
+/** Отказ разбора сообщения: синтаксис или отсутствие обязательной ветки `other`. */
+export declare class MessageSyntaxError extends Error {
+    readonly name = "MessageSyntaxError";
+}
+/**
+ * Разбирает сообщение в дерево. Бросает {@link MessageSyntaxError} на ошибке синтаксиса и на
+ * `plural`/`select` без ветки `other`.
+ *
+ * @param source - Текст сообщения из словаря.
+ * @returns Разобранное сообщение для {@link formatPattern}.
+ *
+ * @example
+ * ```ts
+ * parseMessage('{count, plural, one{# файл} few{# файла} many{# файлов} other{# файла}}');
+ * ```
+ */
+export declare function parseMessage(source: string): MessagePattern;
+/**
+ * Собирает строку из разобранного сообщения. Значения подставляются как текст и повторно
+ * не разбираются.
+ *
+ * @param pattern - Результат {@link parseMessage}.
+ * @param values - Значения аргументов.
+ * @param locale - Локаль для {@link Intl.PluralRules} и {@link Intl.NumberFormat} (`ru`, `en`, …).
+ * @param options - Настройки; см. {@link MessageFormatOptions}.
+ * @returns Готовая строка интерфейса.
+ */
+export declare function formatPattern(pattern: MessagePattern, values: MessageValues, locale: string, options?: MessageFormatOptions): string;
+/**
+ * Форматтер одной локали с кэшем разбора: сообщение разбирается один раз, на первый вызов.
+ * Это внутренность `I18nService.t()` — сам `t()` добавляет сверху поиск ключа в словаре, маркер
+ * пропущенного ключа и откат на резервную локаль.
+ *
+ * @param locale - Локаль форматтера.
+ * @param options - Настройки; см. {@link MessageFormatOptions}.
+ * @returns Функция `(сообщение, значения) => строка`.
+ *
+ * @example
+ * ```ts
+ * const format = createMessageFormatter('ru');
+ * format('{count, plural, one{# файл} few{# файла} many{# файлов} other{# файла}}', { count: 5 });
+ * // '5 файлов'
+ * ```
+ */
+export declare function createMessageFormatter(locale: string, options?: MessageFormatOptions): (source: string, values?: MessageValues) => string;

package/dist/i18n/resolve-localized.d.ts

@@ -0,0 +1,17 @@
+import { I18nHandle } from './translator';
+/**
+ * Заменяет описатели сообщений на строки по активной локали. Обходит массивы и простые
+ * объекты-литералы — подписи опций, заголовки шагов; сигналы, React-элементы, функции и
+ * экземпляры классов (узлы формы) возвращает как есть. Поддерево без описателей сохраняет ссылку:
+ * если раскрывать было нечего, возвращается тот же объект.
+ *
+ * @param value - Пропсы, массив или одиночное значение.
+ * @param i18n - Ручка активной локали (`createI18n` / `useI18n`).
+ *
+ * @example
+ * ```ts
+ * resolveLocalized({ label: msg('profile.email.label'), options: [{ value: 'a', label: msg('opt.a') }] }, i18n);
+ * // { label: 'Почта', options: [{ value: 'a', label: 'Вариант А' }] }
+ * ```
+ */
+export declare function resolveLocalized<T>(value: T, i18n: I18nHandle): T;

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

@@ -0,0 +1,45 @@
+declare const _default: {
+  "format.fileSize.b": "{value} Б",
+  "format.fileSize.kb": "{value} КБ",
+  "format.fileSize.mb": "{value} МБ",
+  "format.fileSize.gb": "{value} ГБ",
+  "format.fileSize.tb": "{value} ТБ",
+
+  "validation.required": "Обязательное поле",
+  "validation.pattern": "Неверный формат",
+  "validation.email": "Введите корректный email",
+  "validation.url": "Введите корректный адрес (URL)",
+  "validation.url_protocol": "Адрес должен начинаться с одного из протоколов: {allowedProtocols}",
+  "validation.phone": "Введите корректный номер телефона",
+
+  "validation.min": "Не меньше {min}",
+  "validation.max": "Не больше {max}",
+  "validation.minLength": "Не меньше {minLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
+  "validation.maxLength": "Не больше {maxLength, plural, one{# символа} few{# символов} many{# символов} other{# символа}}",
+  "validation.isNumber": "Введите число",
+  "validation.integer": "Введите целое число",
+  "validation.multipleOf": "Число должно быть кратно {multipleOf}",
+  "validation.nonNegative": "Число не может быть отрицательным",
+  "validation.nonZero": "Число не может быть нулём",
+
+  "validation.date_invalid": "Введите корректную дату",
+  "validation.date_min": "Дата не раньше {minDate}",
+  "validation.date_max": "Дата не позже {maxDate}",
+  "validation.date_past": "Дата не может быть в прошлом",
+  "validation.date_future": "Дата не может быть в будущем",
+  "validation.date_min_age": "Возраст не меньше {minAge, plural, one{# года} few{# лет} many{# лет} other{# года}}",
+  "validation.date_max_age": "Возраст не больше {maxAge, plural, one{# года} few{# лет} many{# лет} other{# года}}",
+
+  "validation.fileType": "Недопустимый тип файла {fileName}. Разрешено: {accept}",
+  "validation.maxFileSize": "Файл {fileName} больше {maxFileSize}",
+  "validation.minFileSize": "Файл {fileName} меньше {minFileSize}",
+  "validation.maxFiles": "Не больше {maxFiles, plural, one{# файла} few{# файлов} many{# файлов} other{# файла}}",
+  "validation.minFiles": "Не меньше {minFiles, plural, one{# файла} few{# файлов} many{# файлов} other{# файла}}",
+  "validation.maxTotalFileSize": "Суммарный размер файлов больше {maxTotalFileSize}",
+  "validation.fileExists": "Файл {fileName} уже добавлен",
+  "validation.uploadAborted": "Загрузка прервана",
+  "validation.uploadFailed": "Не удалось загрузить файл {fileName}"
+}
+;
+
+export default _default;

package/dist/i18n/translator.d.ts

@@ -0,0 +1,50 @@
+import { FormLocale, Messages } from './locale';
+import { MessageValues } from './message-format';
+/**
+ * Перевод ключа пакета: словарь локали, затем встроенная английская таблица пакета, затем сам
+ * ключ. Английская таблица форматируется по английским правилам — её множественные формы и
+ * группировка чисел не зависят от активного языка.
+ *
+ * @param locale - Активная локаль.
+ * @param builtin - Встроенная английская таблица пакета-владельца ключа.
+ * @param key - Ключ сообщения.
+ * @param values - Значения подстановок.
+ */
+export declare function translateBuiltin(locale: FormLocale, builtin: Messages, key: string, values?: MessageValues): string;
+/** Ручка локали: перевод и форматирование по одному языку. */
+export interface I18nHandle {
+    /** Локаль, по которой работает ручка. */
+    readonly locale: FormLocale;
+    /** Код языка — то же, что `locale.code`. */
+    readonly code: string;
+    /** Есть ли ключ в словаре локали (встроенные английские таблицы не учитываются). */
+    has(key: string): boolean;
+    /**
+     * Перевод ключа приложения: словарь локали → `defaultMessage` → встроенная таблица ядра → ключ.
+     *
+     * @param key - Ключ сообщения.
+     * @param values - Значения подстановок.
+     * @param defaultMessage - Английский текст на случай, если ключа в локали нет.
+     */
+    t(key: string, values?: MessageValues, defaultMessage?: string): string;
+    /** Число по правилам языка. */
+    number(value: number, options?: Intl.NumberFormatOptions): string;
+    /** Дата по правилам языка. */
+    date(value: Date | number, options?: Intl.DateTimeFormatOptions): string;
+    /** Размер файла: `1536` → `1.5 KB` (`1,5 КБ` в русской локали). База — 1024. */
+    fileSize(bytes: number): string;
+}
+/**
+ * Ручка для локали. Для одного и того же объекта локали возвращается один и тот же объект —
+ * ручку можно держать в зависимостях хуков.
+ *
+ * @param locale - Локаль; см. {@link FormLocale}.
+ *
+ * @example
+ * ```ts
+ * const i18n = createI18n({ code: 'ru', messages: { 'cart.items': '{count, plural, one{# товар} few{# товара} other{# товаров}}' } });
+ * i18n.t('cart.items', { count: 3 });  // '3 товара'
+ * i18n.fileSize(1536);                 // '1,5 КБ'
+ * ```
+ */
+export declare function createI18n(locale: FormLocale): I18nHandle;

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

@@ -0,0 +1,18 @@
+import { ValidationError } from '../form/types/contracts';
+import { I18nHandle } from './translator';
+/**
+ * Отображаемый текст ошибки валидации. Порядок источников — в шапке модуля.
+ *
+ * @param error - Ошибка от правила: `code`, `message`, `messageKey`, `params`.
+ * @param i18n - Ручка активной локали (`createI18n` / `useI18n`).
+ *
+ * @example
+ * ```ts
+ * resolveValidationError({ code: 'minLength', message: '', params: { minLength: 8 } }, i18n);
+ * // 'Enter at least 8 characters' · в русской локали — 'Не меньше 8 символов'
+ *
+ * resolveValidationError({ code: 'required', message: 'Укажите телефон' }, i18n);
+ * // 'Укажите телефон' — явное сообщение автора важнее словаря
+ * ```
+ */
+export declare function resolveValidationError(error: ValidationError, i18n: I18nHandle): string;

package/dist/i18n.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Подпуть `@reformer/core/i18n` — локализация форм: объект локали, загрузка словарей, провайдер,
+ * перевод и форматирование, описатели авторских подписей.
+ *
+ * Вторая точка сшивки слоёв после корневого `index.ts`: чистая часть лежит в `src/i18n/`
+ * (без React), привязка к React — в `src/platforms/react/i18n/`. Из главной бочки `@reformer/core`
+ * этот модуль не реэкспортируется: канонический импорт один, а контекст обязан существовать в
+ * единственном экземпляре на все пакеты `@reformer/*`.
+ *
+ * @group i18n
+ * @module i18n
+ */
+export { parseMessage, formatPattern, createMessageFormatter, MessageSyntaxError, } from './i18n/message-format';
+export type { MessageNode, MessagePattern, MessageBranches, MessageValues, MessageFormatOptions, } from './i18n/message-format';
+export { DEFAULT_LOCALE, extendLocale, validateLocale, messageArguments } from './i18n/locale';
+export type { FormLocale, Messages, WeekStart, LocaleIssue } from './i18n/locale';
+export { createLocaleLoader, fetchMessages, bundledLocaleSource } from './i18n/loader';
+export type { LocaleLoader, LocaleSource, LocaleSourceResult } from './i18n/loader';
+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 { 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';