@reformer/core 11.0.0-beta.3 → 11.0.0-beta.5

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

@@ -11,7 +11,7 @@ import { ConfigWithSchema, ConfigWithValue, UnknownRecord } from '../types/index
  * import { NodeFactory } from '@reformer/core';
  *
  * const factory = new NodeFactory();
- * const node = factory.createNode({ value: '', component: Input }); // → FieldNode<string>
+ * const node = factory.createNode({ value: '', component: InputField }); // → FieldNode<string>
  * ```
  */
 export declare class NodeFactory {
@@ -33,28 +33,29 @@ export declare class NodeFactory {
      * ```typescript
      * const factory = new NodeFactory();
      *
+     * Конфиг node-level (не layout-схема M1, где `validators` уже нет).
      * // FieldNode
      * const field = factory.createNode({
      *   value: 'test@mail.com',
-     *   component: Input,
+     *   component: InputField,
      *   validators: [required, email]
      * });
      *
      * // GroupNode
      * const group = factory.createNode({
-     *   email: { value: '', component: Input },
-     *   password: { value: '', component: Input }
+     *   email: { value: '', component: InputField },
+     *   password: { value: '', component: InputField }
      * });
      *
      * // ArrayNode (объект)
      * const array = factory.createNode({
-     *   schema: { title: { value: '', component: Input } },
+     *   schema: { title: { value: '', component: InputField } },
      *   initialItems: [{ title: 'Item 1' }]
      * });
      *
      * // ArrayNode (массив) - новый формат
      * const array2 = factory.createNode([
-     *   { title: { value: '', component: Input } }, // schema
+     *   { title: { value: '', component: InputField } }, // schema
      *   { title: 'Item 1' }, // initial item 1
      *   { title: 'Item 2' }  // initial item 2
      * ]);
@@ -79,7 +80,7 @@ export declare class NodeFactory {
      *
      * // Массив с начальными элементами
      * const array = factory.createArrayNodeFromArray([
-     *   { title: { value: '', component: Input } }, // schema
+     *   { title: { value: '', component: InputField } }, // schema
      *   { title: 'Item 1' }, // initial value
      *   { title: 'Item 2' }  // initial value
      * ]);
@@ -93,7 +94,7 @@ export declare class NodeFactory {
      * ✅ НОВОЕ: Извлечено из GroupNode для централизации логики
      *
      * Преобразует схему формы в объект со значениями:
-     * - `{ name: { value: 'John', component: Input } } → { name: 'John' }`
+     * - `{ name: { value: 'John', component: InputField } } → { name: 'John' }`
      * - Поддерживает вложенные группы
      * - Поддерживает массивы
      *
@@ -105,10 +106,10 @@ export declare class NodeFactory {
      * const factory = new NodeFactory();
      *
      * const schema = {
-     *   name: { value: 'John', component: Input },
-     *   age: { value: 30, component: Input },
+     *   name: { value: 'John', component: InputField },
+     *   age: { value: 30, component: InputField },
      *   address: {
-     *     city: { value: 'Moscow', component: Input }
+     *     city: { value: 'Moscow', component: InputField }
      *   }
      * };
      *
@@ -131,7 +132,7 @@ export declare class NodeFactory {
      * ```typescript
      * const factory = new NodeFactory();
      *
-     * factory.isFieldConfig({ value: '', component: Input }); // true
+     * factory.isFieldConfig({ value: '', component: InputField }); // true
      * factory.isFieldConfig({ email: { value: '' } }); // false
      * factory.isFieldConfig(null); // false
      * ```
@@ -154,7 +155,7 @@ export declare class NodeFactory {
      * const factory = new NodeFactory();
      *
      * factory.isArrayConfig({ schema: {}, initialItems: [] }); // true
-     * factory.isArrayConfig({ value: '', component: Input }); // false
+     * factory.isArrayConfig({ value: '', component: InputField }); // false
      * factory.isArrayConfig({ email: { value: '' } }); // false
      * ```
      */
@@ -175,11 +176,11 @@ export declare class NodeFactory {
      * const factory = new NodeFactory();
      *
      * factory.isGroupConfig({
-     *   email: { value: '', component: Input },
-     *   password: { value: '', component: Input }
+     *   email: { value: '', component: InputField },
+     *   password: { value: '', component: InputField }
      * }); // true
      *
-     * factory.isGroupConfig({ value: '', component: Input }); // false
+     * factory.isGroupConfig({ value: '', component: InputField }); // false
      * factory.isGroupConfig({ schema: {} }); // false
      * factory.isGroupConfig(null); // false
      * ```

package/dist/form/index.d.ts

@@ -1,10 +1,11 @@
 /**
- * Модуль `form` — доменный слой формы поверх state-субстрата (`model`).
+ * Модуль `form` — доменный слой формы поверх реактивной модели (`model`).
  *
  * Ноды (value/touched/dirty/status/errors/componentProps), сборка формы из модели по идентичности
- * сигнала (`createForm`), state-операции над нодами (`enableWhen`/`disableWhen`), submit/статус,
- * React-хуки. Schema-валидация — внешний контракт `@reformer/core/validation` (`validateModel`),
- * роутит ошибки в ноды через реестр сигнал→нода. Зависит от `model` (form→state разрешено);
+ * сигнала (`createForm`), state-операции над нодами (`enableWhen`/`disableWhen`), submit/статус.
+ * React-биндинги вынесены в `platforms/react` — этот слой от React не зависит.
+ * Schema-валидация — внешний контракт `@reformer/core/validation` (`validateModel`),
+ * роутит ошибки в ноды через реестр сигнал→нода. Зависит от `model` (form→model разрешено);
  * обратной зависимости нет.
  *
  * @group Form
@@ -21,19 +22,12 @@ export { createForm, createFormFromModel } from './create-form';
 export type { CreateFormFromModelArgs } from './create-form';
 export { createCoreForm } from './create-core-form';
 export type { CoreForm, CreateCoreFormConfig, CreateFormConfigBase } from './create-core-form';
-export { buildValidation } from './validation-config';
-export type { FormValidation, FormValidationBundle } from './validation-config';
-export { useFormBundle } from './hooks/use-form-bundle';
-export type { FormBundleLike } from './hooks/use-form-bundle';
-export { enableWhen, disableWhen } from './behaviors-node';
-export { FormErrorHandler, ErrorStrategy } from './error-handler';
+export { buildValidation } from './validation/config';
+export type { FormValidation, FormValidationBundle } from './validation/config';
+export { enableWhen, disableWhen } from './behaviors/node';
+export { FormErrorHandler, ErrorStrategy } from './validation/error-handler';
 export { registerSignalNode, getNodeForSignal } from './signal-node-registry';
 export { FormSubmitter } from './form-submitter';
+export { SubscriptionManager } from './nodes/subscription-manager';
 export type { SubmittableForm, SubmitOptions, SubmitResult } from './form-submitter';
 export { isFormNode, isFieldNode, isGroupNode, isArrayNode, getNodeType } from './type-guards';
-export { useFormControl } from './hooks/useFormControl';
-export { useFormControlValue } from './hooks/useFormControlValue';
-export { useArrayLength } from './hooks/useArrayLength';
-export { useFormValidation } from './hooks/use-form-validation';
-export type { UseFormValidationArgs, UseFormValidationResult } from './hooks/use-form-validation';
-export type { FieldControlState, ArrayControlState } from './hooks/types';

package/dist/form/nodes/array-node.d.ts

@@ -11,8 +11,8 @@ import { FormProxy } from '../types/form-proxy';
  * @example
  * ```typescript
  * const array = new ArrayNode({
- *   title: { value: '', component: Input },
- *   price: { value: 0, component: Input },
+ *   title: { value: '', component: InputField },
+ *   price: { value: 0, component: InputField },
  * });
  *
  * array.push({ title: 'Item 1', price: 100 });
@@ -141,7 +141,7 @@ export declare class ArrayNode<T extends object> extends FormNode<T[]> {
      * @example
      * ```typescript
      * const arrayNode = new ArrayNode(
-     *   { name: { value: '', component: Input } },
+     *   { name: { value: '', component: InputField } },
      *   [{ name: 'Initial 1' }, { name: 'Initial 2' }]
      * );
      *

package/dist/form/nodes/field-node.d.ts

@@ -7,10 +7,11 @@ import { FieldConfig, FieldStatus, ValidationError } from '../types/index';
  * @group Nodes
  *
  * @example
+ * Пример node-level: конфиг УЗЛА, а не layout-схема M1 (в ней поля `validators` нет).
  * ```typescript
  * const field = new FieldNode({
  *   value: '',
- *   component: Input,
+ *   component: InputField,
  *   validators: [required, email],
  * });
  *
@@ -102,7 +103,7 @@ export declare class FieldNode<T> extends FormNode<T> {
      *
      * @example
      * ```typescript
-     * const field = new FieldNode({ value: 'initial', component: Input });
+     * const field = new FieldNode({ value: 'initial', component: InputField });
      *
      * field.setValue('changed');
      * field.reset('temp value');
@@ -194,12 +195,14 @@ export declare class FieldNode<T> extends FormNode<T> {
      * @param updateOn - новый триггер валидации: 'change' | 'blur' | 'submit'
      *
      * @example
+     * Пример node-level: плоская схема с инлайн-значениями (back-compat путь до M1). В layout-схеме
+     * `createForm({ model, schema })` поля `validators` нет — правила живут в `defineValidationSchema`.
      * ```typescript
      * // Сценарий 1: Instant feedback после submit
      * const form = createForm({
      *   email: {
      *     value: '',
-     *     component: Input,
+     *     component: InputField,
      *     updateOn: 'submit', // Изначально валидация только при submit
      *     validators: [required, email],
      *   },

package/dist/form/nodes/group-node.d.ts

@@ -15,8 +15,8 @@ import { SubmitOptions, SubmitResult } from '../form-submitter';
  * @example
  * ```typescript
  * const form = new GroupNode({
- *   email: { valueSignal: model.$.email, component: Input },
- *   password: { valueSignal: model.$.password, component: Input },
+ *   email: { valueSignal: model.$.email, component: InputField },
+ *   password: { valueSignal: model.$.password, component: InputField },
  * });
  *
  * // Прямой доступ к полям через Proxy
@@ -136,8 +136,8 @@ export declare class GroupNode<T> extends FormNode<T> {
      * @example
      * ```typescript
      * const form = new GroupNode({
-     *   email: { value: '', component: Input },
-     *   name: { value: '', component: Input },
+     *   email: { value: '', component: InputField },
+     *   name: { value: '', component: InputField },
      * });
      *
      * const proxy = form.getProxy();
@@ -189,11 +189,11 @@ export declare class GroupNode<T> extends FormNode<T> {
      * @example
      * ```typescript
      * const form = new GroupNode({
-     *   email: { value: '', component: Input },
+     *   email: { value: '', component: InputField },
      *   address: {
-     *     city: { value: '', component: Input }
+     *     city: { value: '', component: InputField }
      *   },
-     *   items: [{ name: { value: '', component: Input } }]
+     *   items: [{ name: { value: '', component: InputField } }]
      * });
      *
      * form.getFieldByPath('email');           // FieldNode

package/dist/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/index';
-import { FormModel } from '../../state/types';
+import { FormModel } from '../../model/types';
 import { FormProxy } from '../types/form-proxy';
 /** Минимальный контракт реактивного массива модели, используемый узлом. */
 export interface ModelArrayControl<TItem extends object> {
@@ -36,8 +36,8 @@ export interface ModelArrayControl<TItem extends object> {
  * const model = createModel<{ rows: { name: string; qty: number }[] }>({ rows: [] });
  *
  * const rowItem = (item: FormModel<{ name: string; qty: number }>) => ({
- *   name: { value: item.$.name, component: Input },
- *   qty: { value: item.$.qty, component: Input },
+ *   name: { value: item.$.name, component: InputField },
+ *   qty: { value: item.$.qty, component: InputField },
  * });
  *
  * const form = createForm({

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

@@ -1,13 +1,16 @@
 /**
- * Общие контракт-типы значения и валидации (state-слой).
+ * Общие контракт-типы значения и валидации.
  *
- * Эти типы нужны и headless-движку валидации данных (`validate-model-core`, `schema-node`,
- * `error-handler` — state), и form-слою. Живут в `model/`, поэтому state их импортирует напрямую,
- * а form-слой реэкспортирует из `form/types` (form→state разрешено). Так граница state⇏form не
- * нарушается: общие контракты принадлежат нижнему слою.
+ * Базовый словарь «значение + ошибка + статус», на который опираются узлы формы
+ * (`FormNode.getErrors`, `FieldNode`, `FormStatusMachine`, `aggregate-signals`), слой валидации
+ * и платформенные биндинги. Файл не импортирует ничего — это лист графа зависимостей.
+ *
+ * Живёт в `form/types/`, а не в слое модели: `FieldStatus`/`ErrorFilterOptions` — понятия формы,
+ * а модель этих типов не использует (и импортировать их оттуда запрещено границей model⇏form).
+ * Наружу отдаётся через `form/types/index`.
  *
  * @group Types
- * @module model/contracts
+ * @module form/types/contracts
  */
 /**
  * Represents any valid form value type

package/dist/form/types/deep-schema.d.ts

@@ -89,14 +89,14 @@ type NonEmptyFieldConfig<T> = RequireAtLeastOne<FieldConfig<T>>;
  * }
  *
  * const schema: FormSchema<Form> = {
- *   name: { value: '', component: Input },
+ *   name: { value: '', component: InputField },
  *   address: {
- *     city: { value: '', component: Input },
- *     street: { value: '', component: Input },
+ *     city: { value: '', component: InputField },
+ *     street: { value: '', component: InputField },
  *   },
  *   items: [{
- *     title: { value: '', component: Input },
- *     price: { value: 0, component: Input },
+ *     title: { value: '', component: InputField },
+ *     price: { value: 0, component: InputField },
  *   }],
  * };
  * ```

package/dist/form/types/validation-schema.d.ts

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

package/dist/form/{validation-config.d.ts → validation/config.d.ts}

@@ -1,7 +1,7 @@
 import { ReadonlySignal } from '@preact/signals-core';
-import { FormModel } from '../state/types';
-import { ValidationSchema } from './validation-schema';
-import { FormValidationController, ValidationStrategyKind } from './validation-strategy';
+import { FormModel } from '../../model/types';
+import { ValidationSchema } from './types';
+import { FormValidationController, ValidationStrategyKind } from './strategy';
 /**
  * Правила валидации формы — ДАННЫЕ (без привязки к рендеру).
  *

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

@@ -0,0 +1,27 @@
+import { FormModel, PathAwareSignal, ValidationError } from '../../index';
+/** Сток одного прогона: модель scope, накопленные ошибки, незавершённые async-правила, гейты. */
+export interface VContext {
+    /** Модель текущего scope — источник снапшота для `cross` и модель для `apply`. */
+    model: FormModel<unknown>;
+    /** Накопленные ошибки по сигналу (ключ — идентичность `PathAwareSignal`). */
+    errors: Map<PathAwareSignal<unknown>, ValidationError[]>;
+    /** Незавершённые async-правила (раннер их дожидается). */
+    pending: Promise<void>[];
+    /** Стек активных условий `validateWhen` (все должны быть истинны, чтобы правило сработало). */
+    whenStack: Array<() => boolean>;
+    /** Отмена устаревшего прогона: прокидывается в async-правила, гасит роутинг после await. */
+    signal: AbortSignal;
+}
+/**
+ * Открыть ambient-окно на время `fn` и закрыть его в `finally`.
+ *
+ * Единственный способ установить контекст: прямое присваивание `current` из другого модуля
+ * невозможно. Сохранение/восстановление `prev` делает вложенный прогон безопасным.
+ */
+export declare function runWithContext<R>(ctx: VContext, fn: () => R): R;
+/** Контекст активного прогона либо понятная ошибка, если оператор вызван вне схемы. */
+export declare function requireCtx(op: string): VContext;
+/** «Тронуть» сигнал: гарантирует его наличие в `errors` (даже пустым) → он попадёт в очистку. */
+export declare function touch(ctx: VContext, sig: PathAwareSignal<unknown>): ValidationError[];
+/** Активна ли текущая ветка (все `validateWhen`-условия истинны). */
+export declare const gated: (ctx: VContext) => boolean;

package/dist/form/{error-handler.d.ts → validation/error-handler.d.ts}

@@ -1,4 +1,4 @@
-import { ValidationError } from './types/contracts';
+import { ValidationError } from '../types/contracts';
 /**
  * Стратегия обработки ошибок
  *

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

@@ -1,28 +1,23 @@
-export { required } from './validators/required';
-export { min } from './validators/min';
-export { max } from './validators/max';
-export { minLength } from './validators/min-length';
-export { maxLength } from './validators/max-length';
-export { email } from './validators/email';
-export { pattern } from './validators/pattern';
-export { url } from './validators/url';
-export { phone, type PhoneFormat } from './validators/phone';
-export { isNumber } from './validators/is-number';
-export { integer } from './validators/integer';
-export { multipleOf } from './validators/multiple-of';
-export { nonNegative } from './validators/non-negative';
-export { nonZero } from './validators/non-zero';
-export { isDate } from './validators/is-date';
-export { minDate } from './validators/min-date';
-export { maxDate } from './validators/max-date';
-export { pastDate } from './validators/past-date';
-export { futureDate } from './validators/future-date';
-export { minAge } from './validators/min-age';
-export { maxAge } from './validators/max-age';
-export { maxFileSize } from './validators/max-file-size';
-export { minFileSize } from './validators/min-file-size';
-export { fileType } from './validators/file-type';
-export { maxFiles } from './validators/max-files';
-export { minFiles } from './validators/min-files';
-export { maxTotalFileSize } from './validators/max-total-file-size';
-export { isFileLike, matchesFileAccept, toFileArray, type FileLike } from './validators/file-utils';
+/**
+ * Декларативный контракт СХЕМЫ ВАЛИДАЦИИ — `@reformer/core/validation`.
+ *
+ * Схема валидации — обычная функция `(ctx: { model }) => void`. Внутри вызываются свободные операторы
+ * (`validate`/`validateAsync`/`validateWhen`/`cross`/`each`/`apply`), которые САМИ пишут ошибки в ambient-сток
+ * текущего прогона — автор не видит ни коллектора, ни `getNodeForSignal`, ни `.push`. Внешний раннер
+ * {@link validateModel} открывает ambient-окно на время СИНХРОННОГО прогона схемы, дожидается async-правил
+ * и разносит ошибки по нодам формы (`getNodeForSignal(sig).setErrors(...)`), гася поля, ставшие валидными.
+ *
+ * Зеркалит контракт поведения (`@reformer/core/behaviors`): тот же ambient-стиль, но отдельный слой —
+ * валидация НЕ реактивна (прогон по требованию: submit/шаг), поведение — реактивно (живые подписки).
+ *
+ * Модуль разложен по зонам ответственности: `./types` — контракт правил и схемы, `./context` —
+ * ambient-сток прогона, `./operators` — операторы схемы, `./run` — раннер, `./strategy` — КОГДА
+ * запускать (реэкспортируется отсюда, тот же сабпат).
+ *
+ * @group Validation
+ * @module form/validation
+ */
+export type { Rule, AsyncRule, ValidationSchema } from './types';
+export { validate, validateAsync, validateWhen, cross, each, apply } from './operators';
+export { defineValidationSchema, validateModel } from './run';
+export * from './strategy';

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

@@ -0,0 +1,42 @@
+import { FormModel, ModelArray, PathAwareSignal, ValidationError } from '../../index';
+import { AsyncRule, Rule, ValidationSchema } from './types';
+/**
+ * Синхронные правила поля.
+ *
+ * @example
+ * ```ts
+ * validate(model.$.loanAmount, [required({ message: 'Сумма' }), min(50000)]);
+ * ```
+ */
+export declare function validate<TField>(sig: PathAwareSignal<TField>, rules: Rule<TField>[]): void;
+/**
+ * Асинхронные правила поля (зеркалит движковое разделение `validators` / `asyncValidators`).
+ * Раннер дожидается их и прокидывает `AbortSignal` для отмены устаревших ответов.
+ *
+ * @example
+ * ```ts
+ * validateAsync(model.$.username, [async (v, { signal }) => {
+ *   const r = await fetch(`/api/free?u=${v}`, { signal });
+ *   return (await r.json()).free ? null : { code: 'taken', message: 'Занято' };
+ * }]);
+ * ```
+ */
+export declare function validateAsync<TField>(sig: PathAwareSignal<TField>, rules: AsyncRule<TField>[]): void;
+/**
+ * Условная валидация: правила внутри `cb` активны, только пока `cond()` истинно; иначе их поля
+ * ГАСЯТСЯ (пустой bucket → `setErrors([])`). Не трогает включение/сброс поля — это дело поведения (`enableWhen`).
+ */
+export declare function validateWhen(cond: () => boolean, cb: () => void): void;
+/**
+ * Cross-field правило: `fn` получает СНАПШОТ модели текущего scope (`model.get()`) и вешает ошибку на `sig`.
+ * Для элементов массива / под-моделей захватывайте нужный снапшот в замыкание (`const item = im.get()`),
+ * т.к. `fn` всегда получает модель ТЕКУЩЕГО scope (корень прогона), а не под-модель.
+ */
+export declare function cross<TSnapshot>(sig: PathAwareSignal<unknown>, fn: (form: TSnapshot) => ValidationError | null): void;
+/**
+ * Применить под-правила к КАЖДОМУ элементу текущего массива модели.
+ * `U extends object` — элементы должны быть под-моделями (объектами); для массива примитивов валидируйте лист напрямую.
+ */
+export declare function each<U extends object>(arr: ModelArray<U>, itemFn: (item: FormModel<U>) => void): void;
+/** Композиция под-схем в текущую (над той же моделью scope). Заменяет пошаговую группировку. */
+export declare function apply<T>(...schemas: ValidationSchema<T>[]): void;

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

@@ -0,0 +1,45 @@
+import { FormModel } from '../../index';
+import { ValidationSchema } from './types';
+/**
+ * Тонкая identity-обёртка для типизации/discoverability (как `defineFormBehavior`). Возвращает схему как есть.
+ *
+ * @example
+ * ```ts
+ * export const step1 = defineValidationSchema<LoanForm>(({ model }) => {
+ *   validate(model.$.loanAmount, [required(), min(50000)]);
+ * });
+ * ```
+ */
+export declare function defineValidationSchema<T>(schema: ValidationSchema<T>): ValidationSchema<T>;
+/**
+ * Провалидировать модель ЛЮБОЙ схемой (шаг или вся форма). Открывает ambient-окно на время
+ * синхронного прогона `schema`, дожидается async-правил, разносит ошибки по нодам формы и гасит
+ * поля, ставшие валидными. Возвращает `true`, если нет блокирующих ошибок (`severity:'warning'` не блокирует).
+ *
+ * Гашение — на пару (model, schema): `validateModel(model, step2)` и `validateModel(model, form)` не мешают
+ * друг другу. Устаревший прогон (быстрый повторный вызов той же (model, schema)) отменяется через `AbortSignal`
+ * и возвращает `false` (**fail-closed** — отменённому результату нельзя доверять для submit).
+ *
+ * ⚠️ `schema` должна быть СТАБИЛЬНОЙ ссылкой: отмена устаревших прогонов ключится по идентичности `schema`.
+ * Инлайн-стрелка (`validateModel(model, ({ model }) => …)`) каждый раз создаёт НОВЫЙ прогон без дедупликации —
+ * держите схемы в `const` / `defineValidationSchema`.
+ *
+ * `options.touch` (§6): по завершении помечает `touched` ИМЕННО поля, которые схема проверяла
+ * (не всё поддерево). Ошибки становятся видимыми (`shouldShowError = invalid && (touched||dirty)`)
+ * без ручного `form.markAsTouched()`; при пошаговой валидации следующий шаг не показывается
+ * «тронутым» до ввода. Валидные проверенные поля тоже метятся — это безвредно (ошибка не покажется).
+ *
+ * @param model - Модель данных формы.
+ * @param schema - Схема валидации (стабильная ссылка).
+ * @param options - `{ touch }` — пометить провалидированные поля `touched` для показа ошибок.
+ *
+ * @example
+ * ```ts
+ * const ok = await validateModel(model, step2Validation);              // один шаг
+ * const all = await validateModel(model, formValidation);              // вся форма
+ * const stepOk = await validateModel(model, step2Validation, { touch: true }); // + показать ошибки шага
+ * ```
+ */
+export declare function validateModel<T>(model: FormModel<T>, schema: ValidationSchema<T>, options?: {
+    touch?: boolean;
+}): Promise<boolean>;

package/dist/form/{validation-strategy.d.ts → validation/strategy.d.ts}

@@ -1,6 +1,6 @@
 import { ReadonlySignal } from '@preact/signals-core';
-import { FormModel } from '../index';
-import { ValidationSchema } from './validation-schema';
+import { FormModel } from '../../index';
+import { ValidationSchema } from './types';
 /**
  * Когда запускается schema-валидация:
  * - `submit` (по умолчанию) — только явным вызовом `validate()` (на отправке);

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

@@ -0,0 +1,28 @@
+import { FormModel, ValidationError } from '../../index';
+/**
+ * Внутренний callable-вид правила: value-only фабрики игнорируют 2-й/3-й аргумент.
+ *
+ * @internal
+ */
+export type CallableRule = (value: unknown, model: unknown, root: unknown) => ValidationError | null;
+/**
+ * Синхронное правило поля типа `TField`. Проверяется ТОЛЬКО значение (`value`).
+ *
+ * Позиционные `scope`/`root` помечены `never` намеренно: так встроенные value-only фабрики
+ * (`required()`/`min()`/… — они `(value, model, root) => …`) и inline-правила `(value) => …`
+ * ОБА присваиваются в `Rule<TField>[]` без `any`, при этом сохраняется проверка типа поля
+ * (`validate(model.$.age, [email()])` подсветится — `email` ждёт `string`, поле `number`).
+ * На вызове раннер приводит правило к callable и передаёт `(value, model, model)`.
+ */
+export type Rule<TField> = (value: TField, scope: never, root: never) => ValidationError | null;
+/**
+ * Асинхронное правило поля. Получает `AbortSignal` для отмены устаревших ответов (быстрый повторный
+ * прогон той же схемы отменяет предыдущий). Сетевой сбой не должен блокировать — ловите и возвращайте `null`.
+ */
+export type AsyncRule<TField> = (value: TField, ctx: {
+    signal: AbortSignal;
+}) => Promise<ValidationError | null>;
+/** Схема валидации — обычная функция над (под)моделью. First-class значение (можно `apply`/тестировать/переиспользовать). */
+export type ValidationSchema<T> = (ctx: {
+    model: FormModel<T>;
+}) => void;

package/dist/form/{validation/validators → validators}/date-utils.d.ts

@@ -3,7 +3,7 @@
  *
  * @group Validation
  * @category Validators
- * @module validators/date-utils
+ * @module form/validators/date-utils
  */
 /**
  * Парсит значение в объект Date

package/dist/form/{validation/validators → validators}/email.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора формата email.
  *
@@ -10,14 +10,13 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  *
  * @example Проверка формата email
  * ```typescript
+ * import { defineValidationSchema, validate } from '@reformer/core/validation';
  * import { required, email } from '@reformer/core/validators';
  *
- * // Внутри FieldConfig схемы формы:
- * email: {
- *   value: model.$.email,
- *   component: Input,
- *   validators: [required(), email({ message: 'Введите корректный email' })],
- * },
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidationSchema<MyForm>(({ model }) => {
+ *   validate(model.$.email, [required(), email({ message: 'Введите корректный email' })]);
+ * });
  * ```
  */
 export declare function email<TForm = unknown, TField extends string | null | undefined = string>(options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/{validation/validators → validators}/file-type.d.ts

@@ -1,4 +1,4 @@
-import { Validator, ValidateOptions } from '../../types/validation-schema';
+import { Validator, ValidateOptions } from '../types/validation-schema';
 /**
  * Фабрика валидатора типа файла.
  *
@@ -18,14 +18,13 @@ import { Validator, ValidateOptions } from '../../types/validation-schema';
  *
  * @example Только изображения и PDF
  * ```typescript
+ * import { defineValidationSchema, validate } from '@reformer/core/validation';
  * import { fileType } from '@reformer/core/validators';
  *
- * // Внутри FieldConfig схемы формы:
- * documents: {
- *   value: model.$.documents,
- *   component: FileUploadField,
- *   validators: [fileType('image/*,.pdf', { message: 'Только изображения или PDF' })],
- * },
+ * // Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+ * const validation = defineValidationSchema<MyForm>(({ model }) => {
+ *   validate(model.$.documents, [fileType('image/*,.pdf', { message: 'Только изображения или PDF' })]);
+ * });
  * ```
  */
 export declare function fileType<TForm = unknown, TField = unknown>(accept: string, options?: ValidateOptions): Validator<TForm, TField>;

package/dist/form/{validation/validators → validators}/file-utils.d.ts

@@ -7,7 +7,7 @@
  *
  * @group Validation
  * @category Validators
- * @module validators/file-utils
+ * @module form/validators/file-utils
  */
 /**
  * Минимальный файлоподобный контракт, с которым работают file-валидаторы: