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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@reformer/core",
-  "version": "11.0.0-beta.8",
-  "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/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,72 +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;
-    /**
-     * Донастройка ПОСЛЕ сборки. Единственное место для правок, которые обязаны идти следом за
-     * сборкой формы: поле, чьё значение уже массив, ноды не получает (см. `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>> {
-    /**
-     * Билдер схемы формы. Именно функция, а не готовое дерево: узлы схемы держат ручки модели
-     * (`model: model.$.email`), поэтому построить дерево до модели нечем.
-     */
-    schema?: (model: FormModel<T>) => FormSchemaNode;
-}
-/**
- * Собрать модель, форму и валидацию за один проход.
- *
- * @deprecated Пишите `createForm` — та же сборка, в бандле вдобавок дерево для рендерера.
- *
- * @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;
-}

package/dist/form/form-submitter.d.ts

@@ -1,121 +0,0 @@
-import { ReadonlySignal } from '@preact/signals-core';
-/**
- * Интерфейс формы для FormSubmitter
- * Минимальный контракт для работы с любой формой
- */
-export interface SubmittableForm<T extends object> {
-    /** Пометить все поля как touched */
-    markAsTouched(): void;
-    /** Валидировать форму */
-    validate(): Promise<boolean>;
-    /** Получить значения формы */
-    getValue(): T;
-}
-/**
- * Опции для submit
- */
-export interface SubmitOptions {
-    /** Пропустить валидацию перед submit */
-    skipValidation?: boolean;
-    /** Пропустить markAsTouched перед submit */
-    skipTouch?: boolean;
-}
-/**
- * Результат submit
- */
-export interface SubmitResult<R> {
-    /** Успешно ли выполнен submit */
-    success: boolean;
-    /** Результат от onSubmit callback */
-    data: R | null;
-    /** Ошибка, если submit не удался */
-    error?: Error;
-}
-/**
- * FormSubmitter - управляет процессом отправки формы
- *
- * @example
- * ```typescript
- * const submitter = new FormSubmitter(form);
- *
- * // Простой submit
- * const result = await submitter.submit(async (values) => {
- *   return await api.saveForm(values);
- * });
- *
- * // Проверка состояния
- * if (submitter.submitting.value) {
- *   console.log('Форма отправляется...');
- * }
- * ```
- */
-export declare class FormSubmitter<T extends object> {
-    private readonly form;
-    /** Внутренний сигнал состояния отправки */
-    private readonly _submitting;
-    /** Публичный read-only сигнал состояния отправки */
-    readonly submitting: ReadonlySignal<boolean>;
-    /**
-     * @param form - Форма для отправки
-     */
-    constructor(form: SubmittableForm<T>);
-    /**
-     * Отправить форму
-     *
-     * Процесс:
-     * 1. Помечает все поля как touched (для отображения ошибок)
-     * 2. Валидирует форму
-     * 3. Если валидация успешна - вызывает onSubmit
-     * 4. Управляет состоянием submitting
-     *
-     * @param onSubmit - Callback для отправки данных
-     * @param options - Опции submit
-     * @returns Результат от onSubmit или `null` если валидация не пройдена
-     *
-     * @remarks
-     * Возвращаемый `null` неоднозначен: он сигналит и провал валидации, и легитимный `null`,
-     * который вернул `onSubmit` (или void-обработчик). Чтобы различать эти случаи, используйте
-     * {@link submitWithResult} — он отдаёт явный флаг `success`.
-     *
-     * @example
-     * ```typescript
-     * const result = await submitter.submit(async (values) => {
-     *   const response = await fetch('/api/form', {
-     *     method: 'POST',
-     *     body: JSON.stringify(values)
-     *   });
-     *   return response.json();
-     * });
-     *
-     * if (result === null) {
-     *   console.log('Форма не прошла валидацию');
-     * }
-     * ```
-     */
-    submit<R>(onSubmit: (values: T) => Promise<R> | R, options?: SubmitOptions): Promise<R | null>;
-    /**
-     * Отправить форму с расширенным результатом
-     *
-     * В отличие от submit(), возвращает объект с информацией об успехе/ошибке
-     *
-     * @param onSubmit - Callback для отправки данных
-     * @param options - Опции submit
-     * @returns Объект SubmitResult с данными и статусом
-     *
-     * @example
-     * ```typescript
-     * const result = await submitter.submitWithResult(async (values) => {
-     *   return await api.saveForm(values);
-     * });
-     *
-     * if (result.success) {
-     *   console.log('Сохранено:', result.data);
-     * } else if (result.error) {
-     *   console.error('Ошибка:', result.error.message);
-     * } else {
-     *   console.log('Валидация не пройдена');
-     * }
-     * ```
-     */
-    submitWithResult<R>(onSubmit: (values: T) => Promise<R> | R, options?: SubmitOptions): Promise<SubmitResult<R>>;
-}