@reformer/core 10.2.0 → 11.0.0-beta.10

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

@@ -0,0 +1,49 @@
+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.minItems": "Не меньше {minLength, plural, one{# элемента} few{# элементов} many{# элементов} other{# элемента}}",
+  "validation.maxItems": "Не больше {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}",
+
+  "validation.ruleFailed": "Не удалось проверить поле. Повторите попытку"
+}
+;
+
+export default _default;

package/dist/i18n/translator.d.ts

@@ -0,0 +1,61 @@
+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;
+/**
+ * Перевод ключа пакета: словарь локали, затем встроенная английская таблица пакета, затем сам
+ * ключ. Английская таблица форматируется по английским правилам — её множественные формы и
+ * группировка чисел не зависят от активного языка.
+ *
+ * @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,53 @@
+import { ValidationIssue } from '../form/types/contracts';
+import { I18nHandle } from './translator';
+/**
+ * Текст замечания в словаре формы: шаблон с параметрами либо функция.
+ *
+ * Шаблон — тот же формат сообщений, что в словарях локали: `{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
+ * resolveIssueMessage({ code: 'minLength', params: { minLength: 8 } }, i18n);
+ * // 'Enter at least 8 characters' · в русской локали — 'Не меньше 8 символов'
+ *
+ * resolveIssueMessage({ code: 'phone.required' }, i18n, { 'phone.required': 'Укажите телефон' });
+ * // 'Укажите телефон' — текст поля из словаря формы
+ * ```
+ */
+export declare function resolveIssueMessage(issue: ValidationIssue, i18n: I18nHandle, messages?: IssueMessages): string;

package/dist/i18n.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Подпуть `@reformer/core/i18n` — локализация форм без React: объект локали, загрузка словарей,
+ * перевод и форматирование, тексты ошибок, описатели авторских подписей.
+ *
+ * Провайдер и хуки (`I18nProvider`, `useI18n`, `useMessages`, `useIssueMessage`) отдаёт вход
+ * `@reformer/core/react`. Из главной бочки `@reformer/core` этот модуль не реэкспортируется:
+ * канонический импорт один.
+ *
+ * @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 { 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';

package/dist/i18n.js

@@ -0,0 +1,86 @@
+import { D as j, M as x, c as A, e as E, f as _, m as k, p as l, v as D } from "./locale-CG54AU2Q.js";
+import { b as P, c as z, f as C } from "./loader-BWkigpVe.js";
+import { a as R, c as T, d as $, r as q, t as w } from "./validation-message-Ced9MGxs.js";
+import { isSignal as a } from "./signals.js";
+const d = Symbol.for("reformer.i18n.message");
+function g(e, r, t) {
+  return Object.freeze({
+    [d]: !0,
+    key: e,
+    ...r === void 0 ? {} : { values: r },
+    ...t === void 0 ? {} : { defaultMessage: t }
+  });
+}
+function m(e) {
+  return e !== null && typeof e == "object" && e[d] === !0;
+}
+function L(e) {
+  return { msg: (r, t) => g(r, t, e[r]) };
+}
+function u(e) {
+  const r = Object.getPrototypeOf(e);
+  return r === Object.prototype || r === null;
+}
+function p(e) {
+  if (a(e)) return !0;
+  const r = e;
+  return r.$$typeof !== void 0 || r.__path !== void 0 || r.__kind !== void 0;
+}
+function y(e) {
+  if (e === void 0) return;
+  const r = {};
+  for (const t of Object.keys(e)) {
+    const o = e[t];
+    r[t] = a(o) ? o.value : o;
+  }
+  return r;
+}
+function f(e, r, t) {
+  if (e === null || typeof e != "object") return e;
+  if (m(e))
+    return r.t(e.key, y(e.values), e.defaultMessage);
+  if (p(e) || t.has(e)) return e;
+  if (Array.isArray(e)) {
+    t.add(e);
+    let s = !1;
+    const c = e.map((n) => {
+      const i = f(n, r, t);
+      return i !== n && (s = !0), i;
+    });
+    return t.delete(e), s ? c : e;
+  }
+  if (!u(e)) return e;
+  t.add(e);
+  let o;
+  for (const s of Object.keys(e)) {
+    const c = e[s], n = f(c, r, t);
+    n !== c && (o ??= { ...e }, o[s] = n);
+  }
+  return t.delete(e), o ?? e;
+}
+function M(e, r) {
+  return f(e, r, /* @__PURE__ */ new Set());
+}
+export {
+  j as DEFAULT_LOCALE,
+  d as MESSAGE_DESCRIPTOR,
+  x as MessageSyntaxError,
+  P as bundledLocaleSource,
+  R as createI18n,
+  z as createLocaleLoader,
+  T as createLocaleStore,
+  A as createMessageFormatter,
+  $ as defineIssueMessages,
+  L as defineMessages,
+  E as extendLocale,
+  C as fetchMessages,
+  _ as formatPattern,
+  m as isMessageDescriptor,
+  k as messageArguments,
+  g as msg,
+  l as parseMessage,
+  q as resolveIssueMessage,
+  M as resolveLocalized,
+  w as translateBuiltin,
+  D as validateLocale
+};

package/dist/index.d.ts

@@ -1,11 +1,23 @@
 /**
- * Публичный barrel `@reformer/core` — зонтик над модулями `model` (state) и `form`.
+ * Публичный barrel `@reformer/core` — зонтик над слоями `model` и `form`.
  *
- * Состав экспортов НЕ изменился при модуляризации (реорг в src/model + src/form): реализация
- * разложена по модулям, а этот barrel по-прежнему отдаёт единую поверхность.
+ * `model` — реактивная модель данных (сабпат `@reformer/core/model`); `form` — узлы, поведение и
+ * валидация поверх её сигналов. React здесь нет ни в рантайме, ни в типах: хуки, связка поля с
+ * контролом и React-привязки локализации живут в отдельном входе `@reformer/core/react`
+ * (`src/react.ts`), поэтому корень работает на сервере и с любым слоем представления.
+ *
+ * @module index
+ * @mergeModuleWith <project>
  */
 export * from './form/types/index';
-export * from './form/factories/index';
-export * from './state/index';
+export { createModel, eachLeafSignal, eachValueSignal } from './model/create-model';
+export { arrayOf } from './model/model-nodes';
+export type { DeepPartial, FormModel, ModelArray, ModelArraySignals, ModelGroupSignals, ModelObject, ModelValue, ModelSignals, ModelApi, PathAwareSignal, } from './model/types';
+export { isModelContainerSignal, isValueSignal } from './model/model-signals-proxy';
+export { modelOf } from './model/model-value-proxy';
+export type { ModelOf } from './model/model-value-proxy';
+export type { BehaviorCleanup } from './model/behaviors-value';
+export { markDerived, isDerived, unmarkDerived } from './model/derived-registry';
+export { runOutsideEffect, safeCallback, safeDebouncedCallback } from './model/safe-effect';
 export * from './form/index';
-export * as validators from './form/validation/index';
+export { CORE_RUNTIME_TOKEN } from './runtime-token';