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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@reformer/core",
-  "version": "11.0.0-beta.7",
-  "description": "Reactive form state management library for React with signals-based architecture",
+  "version": "11.0.0-beta.9",
+  "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",
@@ -19,6 +19,10 @@
       "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"
@@ -142,7 +146,8 @@
     "dev": "vite",
     "test": "node ../../scripts/run-vitest.mjs",
     "test:watch": "vitest watch",
-    "coverage": "vitest run --coverage"
+    "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",
@@ -185,17 +190,31 @@
     "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": {
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.3.0",
     "@types/use-sync-external-store": "^0.0.6",
-    "@vitest/coverage-v8": "~4.0.15",
+    "@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",

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/create-model-B8U-COv-.js

@@ -1,103 +0,0 @@
-import { s as p, r as g, c as u, G as v } from "./model-signals-proxy-2vqS243J.js";
-function r(t) {
-  if (t)
-    return t.kind === "group" ? d(t) : t.kind === "array" ? w(t) : t.read();
-}
-function w(t) {
-  const i = {
-    get length() {
-      return t.items.value.length;
-    },
-    push: (e) => t.push(e),
-    insertAt: (e, n) => t.insertAt(e, n),
-    removeAt: (e) => t.removeAt(e),
-    move: (e, n) => t.move(e, n),
-    swap: (e, n) => t.swap(e, n),
-    clear: () => t.clear(),
-    at: (e) => r(t.items.value[e]),
-    map: (e) => t.items.value.map((n, s) => e(r(n), s)),
-    forEach: (e) => t.items.value.forEach((n, s) => e(r(n), s)),
-    toArray: () => t.peek(),
-    [Symbol.iterator]: function* () {
-      const e = t.items.value;
-      for (let n = 0; n < e.length; n++) yield r(e[n]);
-    }
-  };
-  return new Proxy(i, {
-    get: (e, n, s) => n === "__path" ? t.path : typeof n == "string" && u(n) ? r(t.items.value[Number(n)]) : Reflect.get(e, n, s),
-    has: (e, n) => typeof n == "string" && u(n) ? Number(n) < t.items.value.length : Reflect.has(e, n)
-  });
-}
-const h = /* @__PURE__ */ new Set([
-  "$",
-  "get",
-  "set",
-  "patch",
-  "isDirty",
-  "reset",
-  "captureInitial",
-  "signalAt"
-]), m = /* @__PURE__ */ new WeakMap(), o = /* @__PURE__ */ new WeakMap();
-function d(t) {
-  const i = m.get(t);
-  if (i) return i;
-  const e = {
-    $: p(t),
-    get: () => t.peek(),
-    set: (s) => t.set(s),
-    patch: (s) => t.set(s),
-    isDirty: () => t.dirty(),
-    reset: () => t.resetToInitial(),
-    captureInitial: () => t.captureInitial(),
-    signalAt: (s) => g(t, s)
-  }, n = new Proxy(
-    {},
-    {
-      get: (s, a) => {
-        if (a === "__path") return t.path;
-        if (typeof a != "string") return;
-        const c = t.children.get(a);
-        if (c) return r(c);
-        if (h.has(a)) return e[a];
-      },
-      set: (s, a, c) => {
-        if (typeof a != "string") return !1;
-        const f = t.children.get(a);
-        return f ? (f.set(c), !0) : !1;
-      },
-      has: (s, a) => typeof a == "string" && (t.children.has(a) || h.has(a)),
-      ownKeys: () => [...t.children.keys()],
-      getOwnPropertyDescriptor: (s, a) => typeof a == "string" && t.children.has(a) ? { enumerable: !0, configurable: !0 } : void 0
-    }
-  );
-  return m.set(t, n), o.set(n, t), n;
-}
-function l(t, i, e) {
-  if (t.kind === "leaf") {
-    i(t.signal);
-    return;
-  }
-  if (t.kind === "group") {
-    for (const n of t.children.values()) l(n, i, e);
-    return;
-  }
-  e && i(p(t));
-  for (const n of t.items.value) l(n, i, e);
-}
-function x(t, i) {
-  const e = o.get(t);
-  e && l(e, i, !1);
-}
-function y(t, i) {
-  const e = o.get(t);
-  e && l(e, i, !0);
-}
-function A(t) {
-  const i = new v(t, "");
-  return d(i);
-}
-export {
-  y as a,
-  A as c,
-  x as e
-};

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/form/create-core-form.d.ts

@@ -1,70 +0,0 @@
-import { FormModel } from '../model/types';
-import { FormSchemaNode } from './types/schema-node';
-import { FormBehavior } from './behaviors';
-import { FormProxy } from './types/index';
-import { FormValidation, FormValidationBundle } from './validation/config';
-import { ValidationSchema } from './validation';
-/**
- * Общая часть конфига всех фабрик формы.
- *
- * @typeParam T - Форма данных модели.
- * @typeParam B - Бандл конкретной фабрики (его получает {@link CreateFormConfigBase.setup}).
- */
-export interface CreateFormConfigBase<T, B> {
-    /** Начальные значения — из них создаётся модель. Взаимоисключимо с `model`. */
-    initial?: T;
-    /** Готовая модель (если создана отдельной фабрикой). Приоритетнее `initial`. */
-    model?: FormModel<T>;
-    /** Декларативное поведение модели (compute/copyFrom/enableWhen/onChange). */
-    behavior?: FormBehavior<T>;
-    /** Правила валидации: готовая схема либо {@link FormValidation} со стратегией и шагами. */
-    validation?: FormValidation<T> | ValidationSchema<T>;
-    /**
-     * Правка модели ДО сборки формы. Нужна там, где значение обязано существовать к моменту
-     * построения нод — например, массив, наполняемый из вычислений (реактивные `onChange` на
-     * инициализации не срабатывают).
-     */
-    seed?: (model: FormModel<T>) => void;
-    /**
-     * Донастройка ПОСЛЕ сборки. Единственное место для правок, которые обязаны идти следом за
-     * `createForm`: поле, чьё значение уже массив, ноды не получает (см. `buildModelConfig`),
-     * поэтому такой префилл выполняется здесь.
-     */
-    setup?: (bundle: B) => void;
-}
-/** Результат {@link createCoreForm}: модель, форма и (если заданы правила) собранная валидация. */
-export interface CoreForm<T> {
-    model: FormModel<T>;
-    form: FormProxy<T>;
-    validation?: FormValidationBundle<T>;
-}
-/** Конфиг {@link createCoreForm}. */
-export interface CreateCoreFormConfig<T> extends CreateFormConfigBase<T, CoreForm<T>> {
-    /**
-     * Билдер схемы формы. Именно функция, а не готовое дерево: листья схемы держат сами сигналы
-     * модели (`value: model.$.email`), поэтому построить дерево до модели нечем.
-     */
-    schema?: (model: FormModel<T>) => FormSchemaNode;
-}
-/**
- * Собрать модель, форму и валидацию за один проход.
- *
- * @typeParam T - Форма данных модели.
- * @param config - {@link CreateCoreFormConfig}: (`initial` | `model`) + опц. `schema`, `behavior`,
- *   `validation`, `seed`, `setup`.
- * @returns {@link CoreForm}` <T>` — `{ model, form, validation? }`.
- *
- * @example
- * ```tsx
- * const credit = useFormBundle(() =>
- *   createCoreForm<CreditForm>({
- *     model: createCreditModel(),
- *     schema: buildCreditSchema,
- *     behavior: creditBehavior,
- *     validation: { steps: { loan: loanRules, confirm: null }, extras: crossRules },
- *   })
- * );
- * return <FormWizard form={credit.form} config={credit.validation} steps={STEPS} />;
- * ```
- */
-export declare function createCoreForm<T extends object>(config: CreateCoreFormConfig<T>): CoreForm<T>;

package/dist/form/factories/index.d.ts

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

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

@@ -1,189 +0,0 @@
-import { FormNode } from '../nodes/form-node';
-import { ConfigWithSchema, ConfigWithValue, UnknownRecord } from '../types/index';
-/**
- * Фабрика для создания узлов формы.
- *
- * Определяет тип конфига и создаёт соответствующий узел (FieldNode, GroupNode, ArrayNode).
- * Используется внутри `getReformerForm`/`group`/`array` — явно вызывать обычно не нужно.
- *
- * @example
- * ```typescript
- * import { NodeFactory } from '@reformer/core';
- *
- * const factory = new NodeFactory();
- * const node = factory.createNode({ value: '', component: Input }); // → FieldNode<string>
- * ```
- */
-export declare class NodeFactory {
-    /**
-     * Создает узел формы на основе конфигурации
-     *
-     * ✅ ОБНОВЛЕНО: Теперь поддерживает массивы напрямую
-     *
-     * Автоматически определяет тип узла:
-     * - FieldNode: имеет value и component
-     * - ArrayNode: массив [schema, ...items] или { schema, initialItems }
-     * - GroupNode: объект без value, component, schema
-     *
-     * @param config Конфигурация узла
-     * @returns Экземпляр FieldNode, GroupNode или ArrayNode
-     * @throws Error если конфиг не соответствует ни одному типу
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * Конфиг node-level (не layout-схема M1, где `validators` уже нет).
-     * // FieldNode
-     * const field = factory.createNode({
-     *   value: 'test@mail.com',
-     *   component: Input,
-     *   validators: [required, email]
-     * });
-     *
-     * // GroupNode
-     * const group = factory.createNode({
-     *   email: { value: '', component: Input },
-     *   password: { value: '', component: Input }
-     * });
-     *
-     * // ArrayNode (объект)
-     * const array = factory.createNode({
-     *   schema: { title: { value: '', component: Input } },
-     *   initialItems: [{ title: 'Item 1' }]
-     * });
-     *
-     * // ArrayNode (массив) - новый формат
-     * const array2 = factory.createNode([
-     *   { title: { value: '', component: Input } }, // schema
-     *   { title: 'Item 1' }, // initial item 1
-     *   { title: 'Item 2' }  // initial item 2
-     * ]);
-     * ```
-     */
-    createNode(config: unknown): FormNode<unknown>;
-    /**
-     * Создать ArrayNode из массива [schema, ...initialItems]
-     *
-     * ✅ НОВОЕ: Извлечено из GroupNode для централизации логики
-     *
-     * Формат: [itemSchema, ...initialItems]
-     * - Первый элемент - схема элемента массива
-     * - Остальные элементы - начальные значения
-     *
-     * @param config Массив с схемой и начальными элементами
-     * @returns ArrayNode
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * // Массив с начальными элементами
-     * const array = factory.createArrayNodeFromArray([
-     *   { title: { value: '', component: Input } }, // schema
-     *   { title: 'Item 1' }, // initial value
-     *   { title: 'Item 2' }  // initial value
-     * ]);
-     * ```
-     * @private
-     */
-    private createArrayNodeFromArray;
-    /**
-     * Извлечь значения из схемы (рекурсивно)
-     *
-     * ✅ НОВОЕ: Извлечено из GroupNode для централизации логики
-     *
-     * Преобразует схему формы в объект со значениями:
-     * - `{ name: { value: 'John', component: Input } } → { name: 'John' }`
-     * - Поддерживает вложенные группы
-     * - Поддерживает массивы
-     *
-     * @param schema Схема формы
-     * @returns Объект со значениями полей
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * const schema = {
-     *   name: { value: 'John', component: Input },
-     *   age: { value: 30, component: Input },
-     *   address: {
-     *     city: { value: 'Moscow', component: Input }
-     *   }
-     * };
-     *
-     * factory.extractValues(schema);
-     * // { name: 'John', age: 30, address: { city: 'Moscow' } }
-     * ```
-     */
-    extractValues(schema: unknown): unknown;
-    /**
-     * Проверяет, является ли конфиг конфигурацией поля (FieldConfig)
-     *
-     * FieldConfig имеет обязательные свойства:
-     * - value: начальное значение поля
-     * - component: React-компонент для отображения
-     *
-     * @param config Проверяемая конфигурация
-     * @returns true если config является FieldConfig
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * factory.isFieldConfig({ value: '', component: Input }); // true
-     * factory.isFieldConfig({ email: { value: '' } }); // false
-     * factory.isFieldConfig(null); // false
-     * ```
-     */
-    isFieldConfig(config: unknown): config is ConfigWithValue;
-    /**
-     * Проверяет, является ли конфиг конфигурацией массива (ArrayConfig)
-     *
-     * ArrayConfig имеет обязательное свойство:
-     * - schema: схема для элементов массива
-     *
-     * И НЕ имеет:
-     * - value (отличие от FieldConfig)
-     *
-     * @param config Проверяемая конфигурация
-     * @returns true если config является ArrayConfig
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * factory.isArrayConfig({ schema: {}, initialItems: [] }); // true
-     * factory.isArrayConfig({ value: '', component: Input }); // false
-     * factory.isArrayConfig({ email: { value: '' } }); // false
-     * ```
-     */
-    isArrayConfig(config: unknown): config is ConfigWithSchema;
-    /**
-     * Проверяет, является ли конфиг конфигурацией группы (GroupConfig)
-     *
-     * GroupConfig - это объект, который:
-     * - НЕ является FieldConfig (нет value/component)
-     * - НЕ является ArrayConfig (нет schema)
-     * - Содержит вложенные конфиги полей/групп/массивов
-     *
-     * @param config Проверяемая конфигурация
-     * @returns true если config является GroupConfig
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * factory.isGroupConfig({
-     *   email: { value: '', component: Input },
-     *   password: { value: '', component: Input }
-     * }); // true
-     *
-     * factory.isGroupConfig({ value: '', component: Input }); // false
-     * factory.isGroupConfig({ schema: {} }); // false
-     * factory.isGroupConfig(null); // false
-     * ```
-     */
-    isGroupConfig(config: unknown): config is UnknownRecord;
-}