@reformer/core 9.0.0-beta.2 → 9.1.0

package/dist/{core → form}/factories/node-factory.d.ts

@@ -1,5 +1,5 @@
 import { FormNode } from '../nodes/form-node';
-import { ConfigWithSchema, ConfigWithValue, UnknownRecord } from '../types';
+import { ConfigWithSchema, ConfigWithValue, UnknownRecord } from '../types/index';
 /**
  * Фабрика для создания узлов формы.
  *

package/dist/{core/utils → form}/form-proxy-builder.d.ts

@@ -1,5 +1,5 @@
-import { FormNode } from '../nodes/form-node';
-import { FormProxy } from '../types/form-proxy';
+import { FormNode } from './nodes/form-node';
+import { FormProxy } from './types/form-proxy';
 /**
  * Создать Proxy для типобезопасного доступа к полям GroupNode
  *

package/dist/{hooks → form/hooks}/types.d.ts

@@ -1,4 +1,4 @@
-import { ValidationError } from '../core/types';
+import { ValidationError } from '../types/index';
 /**
  * Состояние поля формы, возвращаемое хуком {@link useFormControl} для {@link FieldNode}.
  *

package/dist/{hooks → form/hooks}/useArrayLength.d.ts

@@ -1,4 +1,4 @@
-import { ArrayNode } from '../core/nodes/array-node';
+import { ArrayNode } from '../nodes/array-node';
 /**
  * React-хук для подписки только на длину массива.
  *

package/dist/{hooks → form/hooks}/useFormControl.d.ts

@@ -1,6 +1,6 @@
-import { FieldNode } from '../core/nodes/field-node';
-import { ArrayNode } from '../core/nodes/array-node';
-import { FormValue } from '../core/types';
+import { FieldNode } from '../nodes/field-node';
+import { ArrayNode } from '../nodes/array-node';
+import { FormValue } from '../types/index';
 import { FieldControlState, ArrayControlState } from './types';
 /**
  * React-хук для подписки на состояние {@link ArrayNode}.

package/dist/{hooks → form/hooks}/useFormControlValue.d.ts

@@ -1,5 +1,5 @@
-import { FieldNode } from '../core/nodes/field-node';
-import { FormValue } from '../core/types';
+import { FieldNode } from '../nodes/field-node';
+import { FormValue } from '../types/index';
 /**
  * React-хук для подписки только на значение поля.
  *

package/dist/form/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Модуль `form` — доменный слой формы поверх state-субстрата (`model`).
+ *
+ * Ноды (value/touched/dirty/status/errors/componentProps), сборка формы из модели по идентичности
+ * сигнала (`createForm`), state-операции над нодами (`enableWhen`/`disableWhen`), in-form роутинг
+ * валидации (`validateFormModel`), submit/статус, React-хуки. Зависит от `model` (form→state
+ * разрешено); обратной зависимости нет.
+ *
+ * @group Form
+ * @module form
+ */
+export { FormNode } from './nodes/form-node';
+export type { SetValueOptions } from './nodes/form-node';
+export { FieldNode } from './nodes/field-node';
+export { GroupNode } from './nodes/group-node';
+export { ArrayNode } from './nodes/array-node';
+export { ModelArrayNode } from './nodes/model-array-node';
+export type { ModelArrayControl } from './nodes/model-array-node';
+export { createForm, createFormFromModel } from './create-form';
+export type { CreateFormFromModelArgs } from './create-form';
+export { validateModel, validateModelSync } from './validate-model-core';
+export type { ModelValidator, ModelValidationResult } from './validate-model-core';
+export { validateFormModel } from './validate-model';
+export { enableWhen, disableWhen } from './behaviors-node';
+export { FormErrorHandler, ErrorStrategy } from './error-handler';
+export { registerSignalNode, getNodeForSignal } from './signal-node-registry';
+export { FormSubmitter } from './form-submitter';
+export type { SubmittableForm, SubmitOptions, SubmitResult } from './form-submitter';
+export { FormStatusMachine } from './status-machine';
+export type { StatusEvent } from './status-machine';
+export { isFormNode, isFieldNode, isGroupNode, isArrayNode, getNodeType } from './type-guards';
+export { uniqueId } from './unique-id';
+export { useFormControl } from './hooks/useFormControl';
+export { useFormControlValue } from './hooks/useFormControlValue';
+export { useArrayLength } from './hooks/useArrayLength';
+export type { FieldControlState, ArrayControlState } from './hooks/types';

package/dist/{core → form}/nodes/array-node.d.ts

@@ -1,6 +1,6 @@
 import { ReadonlySignal } from '@preact/signals-core';
 import { FormNode, SetValueOptions } from './form-node';
-import { FieldStatus, ValidationError } from '../types';
+import { FieldStatus, ValidationError } from '../types/index';
 import { FormSchema } from '../types/deep-schema';
 import { FormProxy } from '../types/form-proxy';
 /**

package/dist/{core → form}/nodes/field-node.d.ts

@@ -1,6 +1,6 @@
 import { ReadonlySignal } from '@preact/signals-core';
 import { FormNode, SetValueOptions } from './form-node';
-import { FieldConfig, FieldStatus, ValidationError } from '../types';
+import { FieldConfig, FieldStatus, ValidationError } from '../types/index';
 /**
  * FieldNode - узел для отдельного поля формы
  *

package/dist/{core → form}/nodes/form-node.d.ts

@@ -1,5 +1,5 @@
 import { ReadonlySignal, Signal } from '@preact/signals-core';
-import { FieldStatus, ValidationError, ErrorFilterOptions } from '../types';
+import { FieldStatus, ValidationError, ErrorFilterOptions } from '../types/index';
 /**
  * Опции для setValue
  * @group Nodes

package/dist/{core → form}/nodes/group-node.d.ts

@@ -1,8 +1,8 @@
 import { Signal, ReadonlySignal } from '@preact/signals-core';
 import { FormNode, SetValueOptions } from './form-node';
-import { ValidationError, FieldStatus, FormSchema, GroupNodeConfig, FormValue } from '../types';
+import { ValidationError, FieldStatus, FormSchema, GroupNodeConfig, FormValue } from '../types/index';
 import { FormProxy } from '../types/form-proxy';
-import { SubmitOptions, SubmitResult } from '../utils/form-submitter';
+import { SubmitOptions, SubmitResult } from '../form-submitter';
 /**
  * GroupNode - узел для группы полей
  *

package/dist/{core → form}/nodes/model-array-node.d.ts

@@ -1,7 +1,7 @@
 import { Signal, ReadonlySignal } from '@preact/signals-core';
 import { FormNode } from './form-node';
-import { FieldStatus, ValidationError } from '../types';
-import { FormModel } from '../model/types';
+import { FieldStatus, ValidationError } from '../types/index';
+import { FormModel } from '../../state/types';
 import { FormProxy } from '../types/form-proxy';
 /** Минимальный контракт реактивного массива модели, используемый узлом. */
 export interface ModelArrayControl<TItem extends object> {

package/dist/{core/utils → form}/signal-node-registry.d.ts

@@ -1,5 +1,5 @@
 import { Signal } from '@preact/signals-core';
-import { FormNode } from '../nodes/form-node';
+import { FormNode } from './nodes/form-node';
 /**
  * Связать сигнал модели с его нодой формы.
  *

package/dist/{core/utils → form}/status-machine.d.ts

@@ -1,5 +1,5 @@
 import { ReadonlySignal } from '@preact/signals-core';
-import { FieldStatus } from '../types';
+import { FieldStatus } from './types/index';
 /**
  * События для State Machine
  */

package/dist/{core/utils → form}/type-guards.d.ts

@@ -1,8 +1,8 @@
-import { FormNode } from '../nodes/form-node';
-import { FieldNode } from '../nodes/field-node';
-import { GroupNode } from '../nodes/group-node';
-import { ArrayNode } from '../nodes/array-node';
-import { FormValue } from '../types';
+import { FormNode } from './nodes/form-node';
+import { FieldNode } from './nodes/field-node';
+import { GroupNode } from './nodes/group-node';
+import { ArrayNode } from './nodes/array-node';
+import { FormValue } from './types/index';
 /**
  * Проверить, является ли значение любым FormNode
  *

package/dist/{core/types/index.d.ts → form/types/contracts.d.ts}

@@ -1,5 +1,14 @@
-import { FormSchema } from './deep-schema';
-import { FormNode } from '../nodes/form-node';
+/**
+ * Общие контракт-типы значения и валидации (state-слой).
+ *
+ * Эти типы нужны и headless-движку валидации данных (`validate-model-core`, `schema-node`,
+ * `error-handler` — state), и form-слою. Живут в `model/`, поэтому state их импортирует напрямую,
+ * а form-слой реэкспортирует из `form/types` (form→state разрешено). Так граница state⇏form не
+ * нарушается: общие контракты принадлежат нижнему слою.
+ *
+ * @group Types
+ * @module model/contracts
+ */
 /**
  * Represents any valid form value type
  * Use this instead of 'any' for form values to maintain type safety
@@ -95,91 +104,3 @@ export interface ErrorFilterOptions {
  * @category Core Types
  */
 export type FieldStatus = 'valid' | 'invalid' | 'pending' | 'disabled';
-export type { FieldConfig } from './deep-schema';
-export type { Validator, AsyncValidator, ConditionFn, ValidateOptions, ValidateAsyncOptions, } from './validation-schema';
-export type { FormSchema, ArrayConfig } from './deep-schema';
-export type { FormSchemaNode, SchemaArrayControl, SchemaValidator } from './schema-node';
-export type { FormControlsProxy, FormProxy, FormArrayProxy } from './form-proxy';
-/**
- * Конфигурация GroupNode.
- *
- * Под M1 группа создаётся из плоской {@link FormSchema} (дерево field-конфигов). Обёртка
- * `{ form }` сохранена для совместимости вызова, legacy behavior/validation-схемы удалены (Ф7).
- *
- * @group Types
- * @category Configuration Types
- */
-export interface GroupNodeConfig<T> {
-    /** Схема структуры формы (поля и их конфигурация) */
-    form: FormSchema<T>;
-}
-/**
- * Тип для Record с unknown значениями
- * Используется вместо инлайнового `Record<string, unknown>`
- * @internal
- */
-export type UnknownRecord = Record<string, unknown>;
-/**
- * Интерфейс для узлов с методом applyValidationSchema
- * @internal
- */
-export interface WithValidationSchema {
-    applyValidationSchema(schemaFn: unknown): void;
-}
-/**
- * Интерфейс для узлов с методом applyBehaviorSchema
- * @internal
- */
-export interface WithBehaviorSchema {
-    applyBehaviorSchema(schemaFn: unknown): void;
-}
-/**
- * Интерфейс для узлов, похожих на ArrayNode (с методом at)
- * Используется для duck typing при обходе путей
- * @internal
- */
-export interface ArrayNodeLike {
-    at(index: number): FormNode<unknown> | undefined;
-    length: unknown;
-}
-/**
- * Конфиг с полем schema (для ArrayConfig)
- * @internal
- */
-export interface ConfigWithSchema {
-    schema: unknown;
-    initialItems?: unknown[];
-}
-/**
- * Конфиг с полем value (для извлечения значений)
- * @internal
- */
-export interface ConfigWithValue {
-    value: unknown;
-}
-/**
- * Тип для путей к полям (field paths)
- * Используется в навигации по полям вместо any
- * @internal
- */
-export type FieldPathSegment = {
-    key: string;
-    index?: number;
-};
-/**
- * Тип для коллбэков и обработчиков событий
- * Используется вместо (...args: any[]) => any
- * @internal
- */
-export type UnknownCallback = (...args: unknown[]) => unknown;
-/**
- * Тип для проверки на функцию в conditional types
- * Используется вместо Function для type narrowing
- * @internal
- */
-export type AnyFunction = (...args: never[]) => unknown;
-/**
- * Тип для результатов загрузки ресурсов
- * @internal
- */
-export type ResourceLoadResult = unknown;

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

@@ -0,0 +1,91 @@
+import { FormSchema } from './deep-schema';
+import { FormNode } from '../nodes/form-node';
+export type { FormValue, UnknownFormValue, ValidatorFn, AsyncValidatorOptions, AsyncValidatorFn, ValidationError, ErrorFilterOptions, FieldStatus, } from './contracts';
+export type { FieldConfig } from './deep-schema';
+export type { Validator, AsyncValidator, ConditionFn, ValidateOptions, ValidateAsyncOptions, } from './validation-schema';
+export type { FormSchema, ArrayConfig } from './deep-schema';
+export type { FormSchemaNode, SchemaArrayControl, SchemaValidator } from './schema-node';
+export type { FormControlsProxy, FormProxy, FormArrayProxy } from './form-proxy';
+/**
+ * Конфигурация GroupNode.
+ *
+ * Под M1 группа создаётся из плоской {@link FormSchema} (дерево field-конфигов). Обёртка
+ * `{ form }` сохранена для совместимости вызова, legacy behavior/validation-схемы удалены (Ф7).
+ *
+ * @group Types
+ * @category Configuration Types
+ */
+export interface GroupNodeConfig<T> {
+    /** Схема структуры формы (поля и их конфигурация) */
+    form: FormSchema<T>;
+}
+/**
+ * Тип для Record с unknown значениями
+ * Используется вместо инлайнового `Record<string, unknown>`
+ * @internal
+ */
+export type UnknownRecord = Record<string, unknown>;
+/**
+ * Интерфейс для узлов с методом applyValidationSchema
+ * @internal
+ */
+export interface WithValidationSchema {
+    applyValidationSchema(schemaFn: unknown): void;
+}
+/**
+ * Интерфейс для узлов с методом applyBehaviorSchema
+ * @internal
+ */
+export interface WithBehaviorSchema {
+    applyBehaviorSchema(schemaFn: unknown): void;
+}
+/**
+ * Интерфейс для узлов, похожих на ArrayNode (с методом at)
+ * Используется для duck typing при обходе путей
+ * @internal
+ */
+export interface ArrayNodeLike {
+    at(index: number): FormNode<unknown> | undefined;
+    length: unknown;
+}
+/**
+ * Конфиг с полем schema (для ArrayConfig)
+ * @internal
+ */
+export interface ConfigWithSchema {
+    schema: unknown;
+    initialItems?: unknown[];
+}
+/**
+ * Конфиг с полем value (для извлечения значений)
+ * @internal
+ */
+export interface ConfigWithValue {
+    value: unknown;
+}
+/**
+ * Тип для путей к полям (field paths)
+ * Используется в навигации по полям вместо any
+ * @internal
+ */
+export type FieldPathSegment = {
+    key: string;
+    index?: number;
+};
+/**
+ * Тип для коллбэков и обработчиков событий
+ * Используется вместо (...args: any[]) => any
+ * @internal
+ */
+export type UnknownCallback = (...args: unknown[]) => unknown;
+/**
+ * Тип для проверки на функцию в conditional types
+ * Используется вместо Function для type narrowing
+ * @internal
+ */
+export type AnyFunction = (...args: never[]) => unknown;
+/**
+ * Тип для результатов загрузки ресурсов
+ * @internal
+ */
+export type ResourceLoadResult = unknown;

package/dist/{core → form}/types/schema-node.d.ts

@@ -1,5 +1,5 @@
 import { ComponentType } from 'react';
-import { ValidationError } from './index';
+import { ValidationError } from './contracts';
 /**
  * Валидатор поля схемы. Узел хранит validators гетерогенно: движок `validate*` вызывает их как
  * `(value, scope, root)`, но сюда кладут любой контракт — `ValidatorFn` (value),

package/dist/{core → form}/types/validation-schema.d.ts

@@ -1,5 +1,5 @@
 import { FormValue, ValidationError } from './index';
-import { FormModel } from '../model/types';
+import { FormModel } from '../../state/types';
 /**
  * Чистый синхронный валидатор поля.
  *

package/dist/{core/model/validate-model.d.ts → form/validate-model-core.d.ts}

@@ -1,6 +1,6 @@
-import { ValidationError } from '../types';
-import { FormSchemaNode } from '../types/schema-node';
-import { FormModel } from './types';
+import { ValidationError } from './types/contracts';
+import { FormSchemaNode } from './types/schema-node';
+import { FormModel, PathAwareSignal } from '../state/types';
 /**
  * Валидатор слоя **данных**. `value` — значение поля; `model` — ближайший scope (под-модель элемента
  * массива или корень); `root` — корневая модель.
@@ -21,6 +21,26 @@ export interface ModelValidationResult {
     /** Ключ — путь поля (`'coBorrowers.0.relationship'`). Только поля с ошибками. */
     errors: Record<string, ValidationError[]>;
 }
+export interface FieldTask {
+    signal: PathAwareSignal<unknown>;
+    validators: ModelValidator[];
+    scope: unknown;
+}
+/** Результат обхода схемы: что валидировать и что очистить. */
+export interface CollectResult {
+    /** Активные поля с валидаторами (прогоняются). */
+    tasks: FieldTask[];
+    /** Сигналы полей в ВЫКЛЮЧЕННЫХ ветках — их ошибки нужно очистить (`setErrors([])`). */
+    clearSignals: PathAwareSignal<unknown>[];
+}
+/** Один обход схемы → задачи (активные) + сигналы на очистку (выключенные ветки). */
+export declare function collect(model: unknown, schema: unknown): CollectResult;
+/**
+ * Есть ли среди собранных ошибок блокирующие. Ошибка с `severity: 'warning'` показывается,
+ * но НЕ блокирует submit (см. {@link ValidationError.severity} — 'warning' allows submission),
+ * поэтому `valid` выводится из наличия блокирующих ошибок, а не из общего количества ошибок.
+ */
+export declare const hasBlockingErrors: (errors: Record<string, ValidationError[]>) => boolean;
 /**
  * Синхронная headless-валидация данных. Асинхронные валидаторы пропускаются.
  *
@@ -48,25 +68,5 @@ export declare function validateModelSync<T>(model: FormModel<T>, schema: FormSc
  * ```
  */
 export declare function validateModel<T>(model: FormModel<T>, schema: FormSchemaNode): Promise<ModelValidationResult>;
-/**
- * In-form валидация: прогоняет {@link validateModel} и роутит ошибки в ноды формы
- * (через реестр сигнал→нода): `node.setErrors(errors[path] ?? [])` — заодно очищает прошедшие поля
- * И поля выключенных веток (`{ when, children }` с ложным условием). Дерево обходится ОДИН раз.
- *
- * @group Model
- * @param model - Модель данных ({@link FormModel}) — источник значений полей.
- * @param schema - Единая схема формы (та же, что передавалась в `createForm`).
- * @returns {@link ModelValidationResult} — `valid` + ошибки по пути поля; побочный эффект — ошибки
- *   разведены по нодам формы.
- * @remarks Поля, не материализованные в форме (элементы массива — строятся per-item), не роутятся
- * в родительскую форму; их ошибки доступны в возвращаемом результате по пути.
- *
- * @example Валидация перед submit (ошибки показываются в UI автоматически)
- * ```typescript
- * const form = createForm({ model, schema });
- * form.touchAll();
- * const res = await validateFormModel(model, schema);
- * if (res.valid) await api.save(model.get());
- * ```
- */
-export declare function validateFormModel<T>(model: FormModel<T>, schema: FormSchemaNode): Promise<ModelValidationResult>;
+/** Прогон задач (sync + async): возвращает ошибки по пути. */
+export declare function runTasks(tasks: FieldTask[], model: unknown): Promise<Record<string, ValidationError[]>>;

package/dist/form/validate-model.d.ts

@@ -0,0 +1,27 @@
+import { FormSchemaNode } from './types/schema-node';
+import { FormModel } from '../state/types';
+import { ModelValidationResult } from './validate-model-core';
+export { validateModel, validateModelSync } from './validate-model-core';
+export type { ModelValidator, ModelValidationResult } from './validate-model-core';
+/**
+ * In-form валидация: прогоняет {@link validateModel} и роутит ошибки в ноды формы
+ * (через реестр сигнал→нода): `node.setErrors(errors[path] ?? [])` — заодно очищает прошедшие поля
+ * И поля выключенных веток (`{ when, children }` с ложным условием). Дерево обходится ОДИН раз.
+ *
+ * @group Model
+ * @param model - Модель данных ({@link FormModel}) — источник значений полей.
+ * @param schema - Единая схема формы (та же, что передавалась в `createForm`).
+ * @returns {@link ModelValidationResult} — `valid` + ошибки по пути поля; побочный эффект — ошибки
+ *   разведены по нодам формы.
+ * @remarks Поля, не материализованные в форме (элементы массива — строятся per-item), не роутятся
+ * в родительскую форму; их ошибки доступны в возвращаемом результате по пути.
+ *
+ * @example Валидация перед submit (ошибки показываются в UI автоматически)
+ * ```typescript
+ * const form = createForm({ model, schema });
+ * form.touchAll();
+ * const res = await validateFormModel(model, schema);
+ * if (res.valid) await api.save(model.get());
+ * ```
+ */
+export declare function validateFormModel<T>(model: FormModel<T>, schema: FormSchemaNode): Promise<ModelValidationResult>;

package/dist/form/validators.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export validators from the main index to ensure single module instance.
+ * This prevents static registry isolation issues when consuming the library.
+ */
+export { validators as default } from '../index';
+export * from './validation/index';