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

package/dist/form/unique-id.d.ts

@@ -1,45 +0,0 @@
-/**
- * Генератор уникальных идентификаторов
- *
- * Использует атомный счётчик для генерации гарантированно уникальных ключей.
- * Решает проблему возможного дублирования ключей при использовании
- * Date.now() + Math.random() в быстрых последовательных вызовах.
- *
- * @example
- * ```typescript
- * const key1 = uniqueId(SubscriptionKey.Watch); // "watch-1"
- * const key2 = uniqueId(SubscriptionKey.Watch); // "watch-2"
- * const key3 = uniqueId(SubscriptionKey.ComputeFrom); // "computeFrom-3"
- * ```
- */
-/**
- * Типобезопасные ключи для подписок
- * Используются с uniqueId() для генерации уникальных идентификаторов
- */
-export declare const SubscriptionKey: {
-    /** FieldNode.watch() */
-    readonly Watch: "watch";
-    /** FieldNode.computeFrom() */
-    readonly ComputeFrom: "computeFrom";
-    /** GroupNode.linkFields() */
-    readonly LinkFields: "linkFields";
-    /** GroupNode.watchField() */
-    readonly WatchField: "watchField";
-};
-export type SubscriptionKeyType = (typeof SubscriptionKey)[keyof typeof SubscriptionKey];
-/**
- * Генерирует уникальный идентификатор с указанным префиксом.
- *
- * @param prefix - Префикс для идентификатора (используйте {@link SubscriptionKey}).
- * @returns Уникальный идентификатор в формате `${prefix}-${counter}`.
- *
- * ⚠️ `SubscriptionKey`/`SubscriptionKeyType` — внутренние: барель `@reformer/core` их не отдаёт,
- * поэтому вызвать `uniqueId` извне пакета типобезопасно нельзя. Пример ниже — внутрипакетный.
- *
- * @example
- * ```typescript
- * uniqueId(SubscriptionKey.WatchField); // → 'watchField-1'
- * uniqueId(SubscriptionKey.WatchField); // → 'watchField-2'
- * ```
- */
-export declare function uniqueId(prefix: SubscriptionKeyType): string;

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

@@ -1,73 +0,0 @@
-import { ReadonlySignal } from '@preact/signals-core';
-import { FormModel } from '../../model/types';
-import { ValidationSchema } from './types';
-import { FormValidationController, ValidationStrategyKind } from './strategy';
-/**
- * Правила валидации формы — ДАННЫЕ (без привязки к рендеру).
- *
- * ⚠️ `schema` и значения `steps` обязаны быть **стабильными ссылками**: отмена устаревших прогонов
- * ключуется по паре `(model, schema)` через `WeakMap`, поэтому инлайн-стрелка ломает дедупликацию —
- * валидация начнёт возвращать `false` от уже отменённых прогонов. Держите их
- * module-level-константами (`defineValidationSchema`).
- */
-export interface FormValidation<T> {
-    /** Полный набор правил — для submit и `validateAll`. Без него собирается из `steps` + `extras`. */
-    schema?: ValidationSchema<T>;
-    /**
-     * Пошаговая валидация визарда: ключ = `selector` шага. `null` означает «шаг без правил» ЯВНО —
-     * чтобы опечатка в ключе не выглядела как пустой шаг.
-     */
-    steps?: Record<string, ValidationSchema<T> | null>;
-    /** Cross-field правила, которые проверяются только целиком (в `validateAll`), но не по шагам. */
-    extras?: ValidationSchema<T>;
-    /** Когда запускать живую валидацию. По умолчанию `'submit'` (реактивно молчит). */
-    strategy?: ValidationStrategyKind;
-    debounce?: number;
-    /** Режим live-фазы для `afterFirstSubmit`. По умолчанию `'change'`. */
-    liveAfterSubmit?: 'change' | 'blur';
-}
-/**
- * Собранная валидация формы. Структурно совместима с `FormWizardConfig` и `StepValidationConfig`
- * из `@reformer/cdk`, поэтому уходит в визард как есть: `config={bundle.validation}` либо
- * `patchProps({ form, ...bundle.validation })`.
- */
-export interface FormValidationBundle<T> {
-    /** Полная схема (стабильная ссылка) — та, по которой идёт `validateAll`. */
-    readonly schema: ValidationSchema<T>;
-    /** Селекторы шагов в порядке объявления. Пусто, если `steps` не заданы. */
-    readonly stepSelectors: readonly string[];
-    /** Полный прогон с раскрытием ошибок. Синоним {@link FormValidationBundle.validateAll}. */
-    validate(): Promise<boolean>;
-    validateAll(): Promise<boolean>;
-    /** Прогон правил одного шага: по номеру (1-based, как у визарда) или по селектору. */
-    validateStep(step: number | string): Promise<boolean>;
-    /** Контроллер живой валидации ШАГА; `null` — у шага нет правил либо стратегия `submit`. */
-    createStepController(step: number | string): FormValidationController | null;
-    /** Контроллер живой валидации ФОРМЫ. Армится хуком (`useFormBundle`), не фабрикой. */
-    readonly controller: FormValidationController;
-    /** Идёт ли прогон — реактивный сигнал (для тонкой подписки в UI). */
-    readonly validating: ReadonlySignal<boolean>;
-}
-/**
- * Собрать {@link FormValidationBundle} из правил. Принимает либо готовую схему (сахар для простых
- * форм), либо {@link FormValidation} с шагами и стратегией.
- *
- * Схема для `validateAll` собирается ОДИН раз на бандл — иначе ломается дедупликация прогонов.
- *
- * @typeParam T - Форма данных модели.
- * @param model - Модель, по которой идут прогоны.
- * @param validation - Правила; `undefined` — валидации у формы нет.
- * @returns Бандл валидации либо `undefined`, если правила не заданы.
- *
- * @example
- * ```ts
- * const v = buildValidation(model, {
- *   steps: { loan: loanRules, applicant: applicantRules, confirm: null },
- *   extras: crossFieldRules,
- *   strategy: 'blur',
- * });
- * await v!.validateStep(1);   // правила шага `loan`
- * await v!.validateAll();     // все шаги + extras
- * ```
- */
-export declare function buildValidation<T>(model: FormModel<T>, validation?: FormValidation<T> | ValidationSchema<T>): FormValidationBundle<T> | undefined;

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

@@ -1,166 +0,0 @@
-import { ValidationError } from '../types/contracts';
-/**
- * Стратегия обработки ошибок
- *
- * Определяет, что делать с ошибкой после логирования
- */
-export declare enum ErrorStrategy {
-    /**
-     * Пробросить ошибку дальше (throw)
-     * Используется когда ошибка критична и должна остановить выполнение
-     */
-    THROW = "throw",
-    /**
-     * Залогировать и проглотить ошибку (продолжить выполнение)
-     * Используется когда ошибка не критична
-     */
-    LOG = "log",
-    /**
-     * Конвертировать ошибку в ValidationError
-     * Используется в async validators для отображения ошибки валидации пользователю
-     */
-    CONVERT = "convert"
-}
-/**
- * Централизованный обработчик ошибок для форм
- *
- * Обеспечивает:
- * - Единообразное логирование ошибок в DEV режиме
- * - Гибкие стратегии обработки (throw/log/convert)
- * - Типобезопасное извлечение сообщений из Error/string/unknown
- *
- * @example
- * ```typescript
- * // В async validator (конвертировать в ValidationError)
- * try {
- *   await validateEmail(value);
- * } catch (error) {
- *   return FormErrorHandler.handle(error, 'EmailValidator', ErrorStrategy.CONVERT);
- * }
- *
- * // В behavior applicator (пробросить критичную ошибку)
- * try {
- *   applyBehavior(schema);
- * } catch (error) {
- *   FormErrorHandler.handle(error, 'BehaviorApplicator', ErrorStrategy.THROW);
- * }
- *
- * // В validator (залогировать и продолжить)
- * try {
- *   validator(value);
- * } catch (error) {
- *   FormErrorHandler.handle(error, 'Validator', ErrorStrategy.LOG);
- * }
- * ```
- */
-export declare class FormErrorHandler {
-    /**
-     * Обработать ошибку согласно заданной стратегии
-     *
-     * @param error Ошибка для обработки (Error | string | unknown)
-     * @param context Контекст ошибки для логирования (например, 'AsyncValidator', 'BehaviorRegistry')
-     * @param strategy Стратегия обработки (THROW | LOG | CONVERT)
-     * @returns ValidationError если strategy = CONVERT, undefined если strategy = LOG, никогда не возвращается если strategy = THROW
-     *
-     * @example
-     * ```typescript
-     * // THROW - пробросить ошибку
-     * try {
-     *   riskyOperation();
-     * } catch (error) {
-     *   FormErrorHandler.handle(error, 'RiskyOperation', ErrorStrategy.THROW);
-     *   // Этот код никогда не выполнится
-     * }
-     *
-     * // LOG - залогировать и продолжить
-     * try {
-     *   nonCriticalOperation();
-     * } catch (error) {
-     *   FormErrorHandler.handle(error, 'NonCritical', ErrorStrategy.LOG);
-     *   // Продолжаем выполнение
-     * }
-     *
-     * // CONVERT - конвертировать в ValidationError
-     * try {
-     *   await validator(value);
-     * } catch (error) {
-     *   const validationError = FormErrorHandler.handle(
-     *     error,
-     *     'AsyncValidator',
-     *     ErrorStrategy.CONVERT
-     *   );
-     *   return validationError;
-     * }
-     * ```
-     */
-    static handle(error: unknown, context: string, strategy: ErrorStrategy.CONVERT): ValidationError;
-    static handle(error: unknown, context: string, strategy: ErrorStrategy.THROW): never;
-    static handle(error: unknown, context: string, strategy: ErrorStrategy.LOG): void;
-    static handle(error: unknown, context: string): never;
-    /**
-     * Извлечь сообщение из ошибки
-     *
-     * Обрабатывает различные типы ошибок:
-     * - Error объекты → error.message
-     * - Строки → возвращает как есть
-     * - Объекты с message → извлекает message
-     * - Другое → String(error)
-     *
-     * @param error Ошибка для извлечения сообщения
-     * @returns Сообщение ошибки
-     * @private
-     *
-     * @example
-     * ```typescript
-     * FormErrorHandler.extractMessage(new Error('Test'));
-     * // 'Test'
-     *
-     * FormErrorHandler.extractMessage('String error');
-     * // 'String error'
-     *
-     * FormErrorHandler.extractMessage({ message: 'Object error' });
-     * // 'Object error'
-     *
-     * FormErrorHandler.extractMessage(null);
-     * // 'null'
-     * ```
-     */
-    private static extractMessage;
-    /**
-     * Создать ValidationError с заданными параметрами
-     *
-     * Утилитная функция для создания ValidationError объектов
-     *
-     * @param code Код ошибки
-     * @param message Сообщение ошибки
-     * @param field Поле (опционально)
-     * @returns ValidationError объект
-     *
-     * @example
-     * ```typescript
-     * const error = FormErrorHandler.createValidationError(
-     *   'required',
-     *   'This field is required',
-     *   'email'
-     * );
-     * // { code: 'required', message: 'This field is required', field: 'email' }
-     * ```
-     */
-    static createValidationError(code: string, message: string, field?: string): ValidationError;
-    /**
-     * Проверить, является ли объект ValidationError
-     *
-     * Type guard для ValidationError
-     *
-     * @param value Значение для проверки
-     * @returns true если value является ValidationError
-     *
-     * @example
-     * ```typescript
-     * if (FormErrorHandler.isValidationError(result)) {
-     *   console.log(result.code); // OK, типобезопасно
-     * }
-     * ```
-     */
-    static isValidationError(value: unknown): value is ValidationError;
-}

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

@@ -1,8 +0,0 @@
-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/index-BrNkQj1y.js

@@ -1,105 +0,0 @@
-import T from "react";
-var l = { exports: {} }, y = {};
-var L;
-function A() {
-  if (L) return y;
-  L = 1;
-  var i = T;
-  function _(t, o) {
-    return t === o && (t !== 0 || 1 / t === 1 / o) || t !== t && o !== o;
-  }
-  var c = typeof Object.is == "function" ? Object.is : _, p = i.useState, u = i.useEffect, S = i.useLayoutEffect, E = i.useDebugValue;
-  function O(t, o) {
-    var e = o(), r = p({ inst: { value: e, getSnapshot: o } }), n = r[0].inst, a = r[1];
-    return S(
-      function() {
-        n.value = e, n.getSnapshot = o, f(n) && a({ inst: n });
-      },
-      [t, e, o]
-    ), u(
-      function() {
-        return f(n) && a({ inst: n }), t(function() {
-          f(n) && a({ inst: n });
-        });
-      },
-      [t]
-    ), E(e), e;
-  }
-  function f(t) {
-    var o = t.getSnapshot;
-    t = t.value;
-    try {
-      var e = o();
-      return !c(t, e);
-    } catch {
-      return !0;
-    }
-  }
-  function v(t, o) {
-    return o();
-  }
-  var d = typeof window > "u" || typeof window.document > "u" || typeof window.document.createElement > "u" ? v : O;
-  return y.useSyncExternalStore = i.useSyncExternalStore !== void 0 ? i.useSyncExternalStore : d, y;
-}
-var m = {};
-var x;
-function g() {
-  return x || (x = 1, process.env.NODE_ENV !== "production" && (function() {
-    function i(e, r) {
-      return e === r && (e !== 0 || 1 / e === 1 / r) || e !== e && r !== r;
-    }
-    function _(e, r) {
-      d || u.startTransition === void 0 || (d = !0, console.error(
-        "You are using an outdated, pre-release alpha of React 18 that does not support useSyncExternalStore. The use-sync-external-store shim will not work correctly. Upgrade to a newer pre-release."
-      ));
-      var n = r();
-      if (!t) {
-        var a = r();
-        S(n, a) || (console.error(
-          "The result of getSnapshot should be cached to avoid an infinite loop"
-        ), t = !0);
-      }
-      a = E({
-        inst: { value: n, getSnapshot: r }
-      });
-      var s = a[0].inst, h = a[1];
-      return f(
-        function() {
-          s.value = n, s.getSnapshot = r, c(s) && h({ inst: s });
-        },
-        [e, n, r]
-      ), O(
-        function() {
-          return c(s) && h({ inst: s }), e(function() {
-            c(s) && h({ inst: s });
-          });
-        },
-        [e]
-      ), v(n), n;
-    }
-    function c(e) {
-      var r = e.getSnapshot;
-      e = e.value;
-      try {
-        var n = r();
-        return !S(e, n);
-      } catch {
-        return !0;
-      }
-    }
-    function p(e, r) {
-      return r();
-    }
-    typeof __REACT_DEVTOOLS_GLOBAL_HOOK__ < "u" && typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart == "function" && __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(Error());
-    var u = T, S = typeof Object.is == "function" ? Object.is : i, E = u.useState, O = u.useEffect, f = u.useLayoutEffect, v = u.useDebugValue, d = !1, t = !1, o = typeof window > "u" || typeof window.document > "u" || typeof window.document.createElement > "u" ? p : _;
-    m.useSyncExternalStore = u.useSyncExternalStore !== void 0 ? u.useSyncExternalStore : o, typeof __REACT_DEVTOOLS_GLOBAL_HOOK__ < "u" && typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop == "function" && __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStop(Error());
-  })()), m;
-}
-var w;
-function D() {
-  return w || (w = 1, process.env.NODE_ENV === "production" ? l.exports = A() : l.exports = g()), l.exports;
-}
-var G = D();
-export {
-  G as s
-};

package/dist/loader-Dv_Hl7JC.js

@@ -1,216 +0,0 @@
-class $ extends Error {
-  name = "MessageSyntaxError";
-}
-const v = (t) => `⟦${t}⟧`, b = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map();
-function g(t) {
-  let e = 0;
-  const s = (r) => {
-    throw new $(`${r} (позиция ${e}) в сообщении: ${t}`);
-  }, o = (r, i) => r === "{" || r === "}" || i && r === "#", n = () => {
-    for (; e < t.length && /\s/.test(t[e]); ) e++;
-  }, f = () => {
-    const r = e;
-    for (; e < t.length && !/[\s,{}#]/.test(t[e]); ) e++;
-    return e === r && s("ожидалось имя"), t.slice(r, e);
-  }, l = (r) => {
-    if (e++, t[e] === "'")
-      return e++, "'";
-    if (!o(t[e], r)) return "'";
-    let i = "";
-    for (; e < t.length; )
-      if (t[e] !== "'") i += t[e++];
-      else if (t[e + 1] === "'")
-        i += "'", e += 2;
-      else
-        return e++, i;
-    return i;
-  }, h = (r, i) => {
-    const u = [];
-    let m = "";
-    const p = () => {
-      m !== "" && (u.push({ kind: "text", value: m }), m = "");
-    };
-    for (; e < t.length; ) {
-      const d = t[e];
-      if (d === "}") {
-        r || s("непарная «}» — литерал пишется как '}'");
-        break;
-      }
-      d === "'" ? m += l(i !== null) : d === "#" && i !== null ? (e++, p(), u.push({ kind: "number", name: i })) : d === "{" ? (p(), u.push(a(i))) : (m += d, e++);
-    }
-    return p(), u;
-  }, c = (r, i, u) => {
-    const m = /* @__PURE__ */ new Map();
-    for (n(); e < t.length && t[e] !== "}"; ) {
-      const p = f();
-      n(), t[e] !== "{" && s(`ожидалась «{» после ветки «${p}»`), e++, m.set(p, h(!0, u)), t[e] !== "}" && s(`ветка «${p}» не закрыта`), e++, n();
-    }
-    return t[e] !== "}" && s(`«${r}, ${i}» не закрыт «}»`), e++, m.has("other") || s(`в «${r}, ${i}» нет обязательной ветки other`), m;
-  }, a = (r) => {
-    e++, n();
-    const i = f();
-    if (n(), t[e] === "}")
-      return e++, { kind: "arg", name: i };
-    t[e] !== "," && s(`ожидались «,» или «}» после аргумента «${i}»`), e++, n();
-    const u = f();
-    return u !== "plural" && u !== "select" && s(`неизвестный тип «${u}» у «${i}» — поддерживаются plural и select`), n(), t[e] !== "," && s(`ожидалась «,» после «${u}»`), e++, {
-      kind: u,
-      name: i,
-      branches: c(i, u, u === "plural" ? i : r)
-    };
-  };
-  return h(!1, null);
-}
-function M(t, e, s, o = {}) {
-  const n = o.onMissingArgument ?? v, f = (h) => {
-    const c = e[h];
-    return typeof c == "number" && Number.isFinite(c) ? c : null;
-  }, l = (h) => {
-    let c = "";
-    for (const a of h)
-      if (a.kind === "text") c += a.value;
-      else if (a.kind === "arg")
-        c += e[a.name] === void 0 ? n(a.name) : String(e[a.name]);
-      else if (a.kind === "number") {
-        const r = f(a.name);
-        c += r === null ? n(a.name) : j(s).format(r);
-      } else if (a.kind === "plural") {
-        const r = f(a.name);
-        c += r === null ? n(a.name) : l(
-          a.branches.get(`=${r}`) ?? a.branches.get(x(s).select(r)) ?? a.branches.get("other")
-        );
-      } else {
-        const r = e[a.name];
-        c += r === void 0 ? n(a.name) : l(a.branches.get(String(r)) ?? a.branches.get("other"));
-      }
-    return c;
-  };
-  return l(t);
-}
-function x(t) {
-  let e = b.get(t);
-  return e === void 0 && b.set(t, e = new Intl.PluralRules(t)), e;
-}
-function j(t) {
-  let e = y.get(t);
-  return e === void 0 && y.set(t, e = new Intl.NumberFormat(t)), e;
-}
-function E(t, e = {}) {
-  const s = /* @__PURE__ */ new Map();
-  return (o, n = {}) => {
-    let f = s.get(o);
-    return f === void 0 && s.set(o, f = g(o)), M(f, n, t, e);
-  };
-}
-const P = Object.freeze({
-  code: "en",
-  messages: Object.freeze({})
-});
-function O(t, e) {
-  const { messages: s, ...o } = e;
-  return {
-    ...t,
-    ...o,
-    messages: s === void 0 ? t.messages : { ...t.messages, ...s }
-  };
-}
-function k(t, e) {
-  return Object.prototype.hasOwnProperty.call(t, e);
-}
-function w(t, e = /* @__PURE__ */ new Set()) {
-  for (const s of t)
-    if (s.kind !== "text" && (e.add(s.name), s.kind === "plural" || s.kind === "select"))
-      for (const o of s.branches.values()) w(o, e);
-  return e;
-}
-function F(t, e) {
-  const s = [], o = /* @__PURE__ */ new Map();
-  for (const [n, f] of Object.entries(t))
-    try {
-      o.set(n, g(f));
-    } catch (l) {
-      s.push({
-        key: n,
-        kind: "syntax",
-        message: l instanceof Error ? l.message : String(l)
-      });
-    }
-  if (e === void 0) return s;
-  for (const n of Object.keys(t))
-    k(e, n) || s.push({ key: n, kind: "extra", message: "ключа нет в образце" });
-  for (const [n, f] of Object.entries(e)) {
-    if (!k(t, n)) {
-      s.push({ key: n, kind: "missing", message: "ключ есть в образце, но не переведён" });
-      continue;
-    }
-    const l = o.get(n);
-    if (l === void 0) continue;
-    const h = [...w(g(f))].sort().join(", "), c = [...w(l)].sort().join(", ");
-    h !== c && s.push({
-      key: n,
-      kind: "arguments",
-      message: `образец ждёт {${h}}, словарь — {${c}}`
-    });
-  }
-  return s;
-}
-function S(t) {
-  const e = t.messages;
-  return e !== null && typeof e == "object";
-}
-function L(t) {
-  if (t != null) {
-    if (typeof t != "object" || Array.isArray(t))
-      throw new TypeError("источник локали вернул не объект");
-    return S(t) ? t : { messages: t };
-  }
-}
-function A(t) {
-  const e = /* @__PURE__ */ new Map(), s = /* @__PURE__ */ new Map(), o = (n) => {
-    const f = e.get(n);
-    if (f !== void 0) return Promise.resolve(f);
-    const l = s.get(n);
-    if (l !== void 0) return l;
-    const h = Promise.all(t.map(async (c) => L(await c(n)))).then((c) => {
-      let a = { code: n, messages: {} };
-      for (const r of c)
-        r !== void 0 && (a = O(a, r));
-      return a = { ...a, code: n }, e.set(n, a), a;
-    }).finally(() => {
-      s.delete(n);
-    });
-    return s.set(n, h), h;
-  };
-  return Object.assign(o, {
-    peek: (n) => e.get(n),
-    preload: o
-  });
-}
-function N(t, e) {
-  return async (s) => {
-    const o = t(s), n = await fetch(o, e);
-    if (!n.ok)
-      throw new Error(`локаль «${s}»: ${o} ответил ${n.status}`);
-    return await n.json();
-  };
-}
-function C(t) {
-  return (e) => {
-    const s = e.split("-")[0].toLowerCase(), n = (Object.prototype.hasOwnProperty.call(t, e) ? t[e] : void 0) ?? (Object.prototype.hasOwnProperty.call(t, s) ? t[s] : void 0);
-    return n === void 0 ? null : n();
-  };
-}
-export {
-  P as D,
-  $ as M,
-  A as a,
-  C as b,
-  E as c,
-  N as d,
-  O as e,
-  M as f,
-  k as h,
-  w as m,
-  g as p,
-  F as v
-};