@reformer/core 10.2.0 → 11.0.0-beta.10

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@reformer/core",
-  "version": "10.2.0",
-  "description": "Reactive form state management library for React with signals-based architecture",
+  "version": "11.0.0-beta.10",
+  "description": "Reactive form state management on signals: a UI-agnostic core with React bindings in @reformer/core/react",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -15,9 +15,31 @@
       "types": "./dist/signals.d.ts",
       "import": "./dist/signals.js"
     },
-    "./state": {
-      "types": "./dist/state.d.ts",
-      "import": "./dist/state.js"
+    "./i18n": {
+      "types": "./dist/i18n.d.ts",
+      "import": "./dist/i18n.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./locale": {
+      "types": "./dist/locale.d.ts",
+      "import": "./dist/locale.js"
+    },
+    "./locale/en": {
+      "types": "./dist/locale/en.d.ts",
+      "import": "./dist/locale/en.js"
+    },
+    "./locale/ru": {
+      "types": "./dist/locale/ru.d.ts",
+      "import": "./dist/locale/ru.js"
+    },
+    "./locale/en.json": "./dist/locale/en.json",
+    "./locale/ru.json": "./dist/locale/ru.json",
+    "./model": {
+      "types": "./dist/model.d.ts",
+      "import": "./dist/model.js"
     },
     "./behaviors": {
       "types": "./dist/behaviors.d.ts",
@@ -87,9 +109,33 @@
       "types": "./dist/validators/non-zero.d.ts",
       "import": "./dist/validators/non-zero.js"
     },
-    "./validators/date": {
-      "types": "./dist/validators/date.d.ts",
-      "import": "./dist/validators/date.js"
+    "./validators/is-date": {
+      "types": "./dist/validators/is-date.d.ts",
+      "import": "./dist/validators/is-date.js"
+    },
+    "./validators/min-date": {
+      "types": "./dist/validators/min-date.d.ts",
+      "import": "./dist/validators/min-date.js"
+    },
+    "./validators/max-date": {
+      "types": "./dist/validators/max-date.d.ts",
+      "import": "./dist/validators/max-date.js"
+    },
+    "./validators/past-date": {
+      "types": "./dist/validators/past-date.d.ts",
+      "import": "./dist/validators/past-date.js"
+    },
+    "./validators/future-date": {
+      "types": "./dist/validators/future-date.d.ts",
+      "import": "./dist/validators/future-date.js"
+    },
+    "./validators/min-age": {
+      "types": "./dist/validators/min-age.d.ts",
+      "import": "./dist/validators/min-age.js"
+    },
+    "./validators/max-age": {
+      "types": "./dist/validators/max-age.d.ts",
+      "import": "./dist/validators/max-age.js"
     }
   },
   "sideEffects": false,
@@ -99,7 +145,9 @@
     "build:stackblitz": "vite build",
     "dev": "vite",
     "test": "node ../../scripts/run-vitest.mjs",
-    "test:watch": "vitest watch"
+    "test:watch": "vitest watch",
+    "coverage": "node ../../scripts/run-vitest.mjs --coverage && node ../../scripts/check-coverage-per-file.mjs",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.tests.json"
   },
   "keywords": [
     "react",
@@ -134,26 +182,40 @@
     "dist",
     "README.md",
     "LICENSE",
-    "llms.txt"
+    "llms.txt",
+    "llms-index.json",
+    "docs/llms"
   ],
   "peerDependencies": {
     "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
     "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@preact/signals-core": "^1.8.0",
     "use-sync-external-store": "^1.2.0"
   },
   "devDependencies": {
-    "@types/use-sync-external-store": "^0.0.6",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
     "@types/node": "^24.10.1",
-    "tsx": "^4.19.2",
     "@types/react": "^19.2.7",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.0",
-    "@vitest/utils": "^4.0.8",
+    "@types/react-dom": "^19.3.0",
+    "@types/use-sync-external-store": "^0.0.6",
+    "@vitest/coverage-v8": "4.0.15",
+    "fast-check": "^4.10.2",
+    "happy-dom": "^20.14.6",
+    "intl-messageformat": "^12.1.2",
     "react": "^19.2.1",
     "react-dom": "^19.2.1",
+    "tsx": "^4.19.2",
     "typescript": "^5.9.3",
     "vite": "^7.2.2",
     "vite-plugin-dts": "^4.5.4",

package/dist/behaviors-node-DGEFMTQu.js

@@ -1,18 +0,0 @@
-import { effect as i } from "@preact/signals-core";
-import { g as s } from "./signal-node-registry-tiwel-TV.js";
-import { d as f } from "./behaviors-value-C7dSEhCc.js";
-function a(n, r, t) {
-  return i(() => {
-    const o = r(), e = s(n);
-    e && f(() => {
-      o ? e.enable() : (e.disable(), t?.resetOnDisable && e.reset());
-    });
-  });
-}
-function b(n, r, t) {
-  return a(n, () => !r(), t);
-}
-export {
-  b as d,
-  a as e
-};

package/dist/behaviors-value-C7dSEhCc.js

@@ -1,134 +0,0 @@
-import { effect as f } from "@preact/signals-core";
-const d = "runOutsideEffect";
-function i(e, n) {
-  process.env.NODE_ENV !== "production" && console.error(`[${n}]`, e);
-}
-function m(e) {
-  return typeof e == "object" && e !== null && typeof e.then == "function";
-}
-function v(e, n) {
-  try {
-    const t = e();
-    m(t) && t.then(void 0, (r) => i(r, n));
-  } catch (t) {
-    i(t, n);
-  }
-}
-function y(e) {
-  return (...n) => {
-    a(() => e(...n));
-  };
-}
-function a(e) {
-  let n = !1;
-  return queueMicrotask(() => {
-    n || v(e, d);
-  }), () => {
-    n = !0;
-  };
-}
-function h(e, n) {
-  return () => {
-    n(() => v(e, "safeDebouncedCallback"));
-  };
-}
-function k(e, n, t, r) {
-  return f(() => {
-    const u = e.map((c) => c.value);
-    if (r?.when && !r.when(...u)) return;
-    const s = t(...u);
-    n.peek() !== s && (n.value = s);
-  });
-}
-function E(e, n, t) {
-  return f(() => {
-    const r = e.value;
-    if (t?.when && !t.when()) return;
-    const u = t?.transform ? t.transform(r) : r;
-    n.peek() !== u && (n.value = u);
-  });
-}
-function w(e, n, t) {
-  let r = !0;
-  return f(() => {
-    const u = e.value;
-    r && (r = !1, !t?.immediate) || n(u);
-  });
-}
-function b(e, n) {
-  let t = !1;
-  return f(() => {
-    const r = e.value;
-    t || a(() => {
-      const u = n(r);
-      if (e.peek() !== u) {
-        t = !0;
-        try {
-          e.value = u;
-        } finally {
-          t = !1;
-        }
-      }
-    });
-  });
-}
-function D(e, n, t) {
-  const r = t?.resetValue ?? null;
-  return f(() => {
-    const u = n();
-    a(() => {
-      u && e.peek() !== r && (e.value = r);
-    });
-  });
-}
-function F(e, n, t) {
-  const r = t?.transform;
-  let u = !1;
-  const s = f(() => {
-    const l = e.value;
-    u || a(() => {
-      u = !0;
-      try {
-        const o = r ? r(l) : l;
-        n.peek() !== o && (n.value = o);
-      } finally {
-        u = !1;
-      }
-    });
-  }), c = f(() => {
-    const l = n.value;
-    u || a(() => {
-      u = !0;
-      try {
-        e.peek() !== l && (e.value = l);
-      } finally {
-        u = !1;
-      }
-    });
-  });
-  return () => {
-    s(), c();
-  };
-}
-function x(e, n) {
-  let t = !0;
-  return f(() => {
-    if (e.forEach((r) => r.value), t) {
-      t = !1;
-      return;
-    }
-    a(() => n());
-  });
-}
-export {
-  E as a,
-  x as b,
-  k as c,
-  a as d,
-  y as e,
-  h as f,
-  D as r,
-  F as s,
-  b as t,
-  w
-};

package/dist/date-utils-dTT_x_Be.js

@@ -1,31 +0,0 @@
-function i(t) {
-  if (t == null || t === "")
-    return null;
-  if (t instanceof Date)
-    return isNaN(t.getTime()) ? null : t;
-  if (typeof t == "string") {
-    const n = new Date(t);
-    return isNaN(n.getTime()) ? null : n;
-  }
-  return null;
-}
-function s() {
-  const t = /* @__PURE__ */ new Date();
-  return t.setHours(0, 0, 0, 0), t;
-}
-function a(t) {
-  const n = new Date(t);
-  return n.setHours(0, 0, 0, 0), n;
-}
-function c(t) {
-  const n = s(), e = a(t);
-  let r = n.getFullYear() - e.getFullYear();
-  const o = n.getMonth() - e.getMonth();
-  return (o < 0 || o === 0 && n.getDate() < e.getDate()) && (r -= 1), r;
-}
-export {
-  c,
-  s as g,
-  a as n,
-  i as p
-};

package/dist/derived-registry-CluZCQ7U.js

@@ -1,16 +0,0 @@
-const t = /* @__PURE__ */ new WeakMap();
-function n(e) {
-  t.set(e, (t.get(e) ?? 0) + 1);
-}
-function i(e) {
-  const r = t.get(e);
-  r !== void 0 && (r <= 1 ? t.delete(e) : t.set(e, r - 1));
-}
-function o(e) {
-  return t.has(e);
-}
-export {
-  o as i,
-  n as m,
-  i as u
-};

package/dist/form/behaviors.d.ts

@@ -1,133 +0,0 @@
-import { Signal, ReadonlySignal } from '@preact/signals-core';
-import { BehaviorCleanup, FormModel, FormProxy } from '../index';
-/** Контекст схемы поведения: модель (значения/сигналы) + форма (ноды). */
-export type BehaviorScope<T> = {
-    model: FormModel<T>;
-    form: FormProxy<T>;
-};
-/** Результат {@link defineFormBehavior}; передаётся в `createForm({ behavior })`. */
-export interface FormBehavior<T> {
-    /** @internal Запускается `createForm` после построения нод и заполнения реестра сигнал→нода. */
-    __run(model: FormModel<T>, form: FormProxy<T>): BehaviorCleanup;
-}
-export type { Signal, ReadonlySignal, BehaviorCleanup };
-/** Зарегистрировать произвольную отписку в активной схеме. */
-export declare function onDispose(cleanup: BehaviorCleanup): void;
-/** Текущий scope ({ model, form }) активной схемы (escape hatch для кросс-операторов). */
-export declare function getScope<T>(): BehaviorScope<T>;
-/**
- * Описать поведение формы декларативно. Возвращает {@link FormBehavior} для `createForm({ behavior })`.
- *
- * @example
- * ```ts
- * export const myBehavior = defineFormBehavior<MyForm>(({ model, form }) => {
- *   compute(model.$.total, () => model.price * model.qty);
- *   enableWhen([model.$.city], () => Boolean(model.country));
- *   onChange(model.$.country, async (c) => form.city.updateComponentProps({ options: await load(c) }));
- * });
- * ```
- */
-export declare function defineFormBehavior<T>(setup: (scope: BehaviorScope<T>) => void): FormBehavior<T>;
-/** Реактивный эффект (авто-dispose). Колбэк может вернуть собственный cleanup. */
-export declare function effect(fn: () => void | (() => void)): void;
-/** Отложенная запись вне effect-контекста (микротаск) — защита от «Cycle detected». */
-export declare function defer(fn: () => void): void;
-/** Вычисляемое поле с auto-tracking: `target = read()` при изменении прочитанных сигналов. */
-export declare function compute<R>(target: Signal<R>, read: () => R, options?: {
-    when?: () => boolean;
-}): void;
-/** Вычисляемое поле с явным списком зависимостей (escape hatch). */
-export declare function computeFrom<R>(sources: ReadonlySignal<unknown>[], target: Signal<R>, fn: (...values: any[]) => R, options?: {
-    when?: (...values: any[]) => boolean;
-}): void;
-/** Копирование `source → target` — скаляр или группа (объект целиком). */
-export declare function copyFrom<T>(source: ReadonlySignal<T> | object, target: Signal<T> | object, options?: {
-    when?: () => boolean;
-    transform?: (value: T) => T;
-}): void;
-/** Контекст async-реакции: `signal` аннулируется, когда поле меняется снова до завершения колбэка. */
-export interface ChangeContext {
-    signal: AbortSignal;
-}
-/**
- * Реакция на изменение поля; `{ debounce, immediate }`.
- *
- * Колбэк выполняется ВНЕ effect-контекста (микротаск/таймер) — можно безопасно писать сигналы и ноды
- * (`updateComponentProps`/`reset`/`clear`) без ручного `defer` и без «Cycle detected».
- *
- * Для async-колбэков 2-м аргументом приходит `{ signal }` (AbortSignal): при следующей смене значения
- * предыдущий `signal` аннулируется. Передавай его в `fetch` (сетевая отмена) или проверяй
- * `signal.aborted` перед применением результата — это убирает гонки устаревших ответов (F2).
- */
-export declare function onChange<T>(source: ReadonlySignal<T>, cb: (value: T, ctx: ChangeContext) => void, options?: {
-    immediate?: boolean;
-    debounce?: number;
-}): void;
-type EnableTarget = ReadonlySignal<unknown> | object;
-/** Условное включение поля(ей) — скаляр, массив целей или группа. `resetOnDisable=false` по умолчанию. */
-export declare function enableWhen(target: EnableTarget | EnableTarget[], condition: () => boolean, options?: {
-    resetOnDisable?: boolean;
-}): void;
-/** Условное выключение поля(ей) (инверсия {@link enableWhen}). */
-export declare function disableWhen(target: EnableTarget | EnableTarget[], condition: () => boolean, options?: {
-    resetOnDisable?: boolean;
-}): void;
-/** Трансформация значения поля (идемпотентная). */
-export declare function transformValue<T>(target: Signal<T>, transformer: (value: T) => T): void;
-/** Сброс значения по условию. */
-export declare function resetWhen<T>(target: Signal<T>, condition: () => boolean, options?: {
-    resetValue?: T;
-}): void;
-/** Двусторонняя синхронизация двух полей. */
-export declare function syncFields<T>(a: Signal<T>, b: Signal<T>, options?: {
-    transform?: (value: T) => T;
-}): void;
-/** Ревалидация при изменении зависимостей. */
-export declare function revalidateWhen(deps: ReadonlySignal<unknown>[], revalidate: () => void): void;
-/**
- * Применить под-схему к КАЖДОМУ элементу динамического массива (per-item поведение).
- * Реагирует на добавление/удаление строк: новым строкам поведение применяется, удалённым — отписывается.
- *
- * Под-схема получает scope строки: `model` (под-модель строки — `row.$.field`) и `form` (нода строки).
- * - Value-операции (`compute`/`copyFrom`/`transformValue` на `row.$.*`) работают всегда.
- * - Node-операции (`enableWhen`/`updateComponentProps`/`reset` через `form.*`) требуют, чтобы массив был
- *   МАТЕРИАЛИЗОВАН в форме (узел `{ array, item }` в схеме) — тогда `form` строки = та же нода, что
- *   рендерится, а её сигналы зарегистрированы (`enableWhen` резолвит ноду). Без материализации доступ
- *   к `form.*` бросит понятную ошибку (см. {@link unmaterializedRowForm}).
- *
- * @example
- * applyEach(model.$.items, defineFormBehavior<Item>(({ model: row, form }) => {
- *   compute(row.$.lineTotal, () => row.qty * row.price);    // value-op — всегда
- *   enableWhen(row.$.discount, () => row.qty > 10);          // node-op — нужна материализация массива
- * }));
- */
-export declare function applyEach<TItem>(array: object, itemSchema: FormBehavior<TItem>): void;
-/**
- * Взаимное исключение булева флага среди строк массива (single-selection — «единственный primary»).
- * Когда флаг строки становится true, у остальных строк он сбрасывается в false. Не хрупок к push:
- * новые строки с флагом false исключения не запускают.
- *
- * @example
- * exclusiveFlag(model.$.contacts, (row) => row.$.primary);
- */
-export declare function exclusiveFlag<TItem>(array: object, getFlag: (row: FormModel<TItem>) => Signal<boolean>): void;
-/**
- * Агрегатная запись в строки массива. `derive(snapshot)` получает СНИМОК строк и возвращает список
- * `{ index, patch }`, который применяется к строкам. Записи КОАЛЕСИРУЮТСЯ в один отложенный проход на
- * финальном состоянии — поэтому массовые синхронные мутации (push в цикле) не вызывают каскад на
- * промежуточных состояниях. `derive` должна сходиться (на фикспоинте возвращать те же значения).
- *
- * @example
- * // последняя строка = 100 − Σ(остальные)
- * aggregateInto(model.$.rows, (rows) => {
- *   const n = rows.length; if (n === 0) return [];
- *   const others = rows.slice(0, n - 1).reduce((s, r) => s + r.percent, 0);
- *   return [{ index: n - 1, patch: { percent: 100 - others } }];
- * });
- */
-export declare function aggregateInto<TItem>(array: object, derive: (rows: TItem[]) => Array<{
-    index: number;
-    patch: Partial<TItem>;
-}>): void;
-/** Применить под-схему к одному или нескольким полям-группам (переиспользование). */
-export declare function apply<TField>(targets: object | object[], subSchema: FormBehavior<TField>): void;

package/dist/form/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/factories/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Фабрики для создания узлов формы
- *
- * Централизованное место для всех фабрик и builder-паттернов.
- */
-export { NodeFactory } from './node-factory';