@reformer/core 10.1.0 → 11.0.0-beta.1

package/llms.txt

@@ -37,6 +37,7 @@
 - 30-type-safety-recipes.md — type-safety-recipes
 - 31-async-validator-debounce.md — async-validator-debounce
 - 32-async-options-loading.md — async-options-loading
+- 33-validation-strategy.md — useFormValidation — Единый выбор стратегии валидации
 - API Reference (auto-generated from JSDoc)
 
 ## 1. 1. API Reference
@@ -4113,39 +4114,215 @@ loadOptionsOn(model.$.carBrand, form.carModel, fetchCarModels, { resetTarget: tr
 - [29-async-preload.md](29-async-preload.md) — preload данных при инициализации
 - [31-async-validator-debounce.md](31-async-validator-debounce.md) — async **валидация** (не options)
 
-## 77. API Reference
+## 77. Purpose
 
-_Auto-generated from JSDoc on public exports._
+Одна декларативная точка выбора «когда прогонять схему валидации» вместо ручной разводки
+`markAsTouched` + `validateModel` + `revalidateWhen` + `useState(pending)`. Аддитивный слой над
+функциональной схемой (`@reformer/core/validation`): переиспользует `validateModel` как
+ЕДИНСТВЕННЫЙ движок (роутинг ошибок в ноды, отмена устаревших прогонов, дедуп по `(model, schema)`),
+второго движка не заводит. Node-level `updateOn` / `debounce` на самой ноде поля (legacy-триггеры)
+этот API НЕ трогает.
 
-### AnyFunction
+Стратегия определяет только момент запуска и раскрытие ошибок — сами правила остаются в отдельной
+`defineValidationSchema<T>(({ model }) => …)`.
 
-**Kind:** `type`
+## 78. API
 
-Тип для проверки на функцию в conditional types
-Используется вместо Function для type narrowing
+Основной способ — React-хук `useFormValidation` из `@reformer/core` (рядом с `useFormControl`).
+Под ним — headless-фабрика `createFormValidation` из `@reformer/core/validation` (для SSR / тестов /
+не-React потребителей).
 
-**Signature:**
 ```typescript
-export type AnyFunction = (...args: never[]) => unknown;
+// React (@reformer/core)
+function useFormValidation<T>(args: {
+  model: FormModel<T>;
+  schema: ValidationSchema<T>;         // СТАБИЛЬНАЯ ссылка (module-level const / useMemo)
+  strategy?: ValidationStrategyKind;   // default 'submit'
+  debounce?: number;                   // мс, для live-фаз (change / live-часть afterFirstSubmit)
+  liveAfterSubmit?: 'change' | 'blur'; // default 'change'
+}): { submit: () => Promise<boolean>; validate: () => Promise<boolean>; isValidating: boolean };
+
+// headless (@reformer/core/validation)
+type ValidationStrategyKind = 'submit' | 'blur' | 'change' | 'afterFirstSubmit';
+interface ValidationStrategyOptions {
+  strategy?: ValidationStrategyKind;
+  debounce?: number;
+  liveAfterSubmit?: 'change' | 'blur';
+}
+interface FormValidationController {
+  validate(): Promise<boolean>;        // полный прогон, touch:true (раскрыть ВСЕ ошибки); переводит afterFirstSubmit в live-фазу
+  start(): () => void;                 // армит реактивные подписки (ТОЛЬКО на клиенте) → dispose
+  dispose(): void;
+  readonly isValidating: boolean;
+  readonly validating: ReadonlySignal<boolean>;
+}
+function createFormValidation<T>(
+  model: FormModel<T>,
+  schema: ValidationSchema<T>,
+  options?: ValidationStrategyOptions,
+): FormValidationController;
 ```
 
-_Source: src/form/types/index.ts_
+- `useFormValidation` мемоизирует контроллер по `[model, schema, strategy, debounce, liveAfterSubmit]`,
+  армит стратегию в `useEffect` (SSR-safe), а `submit()` = `controller.validate()`.
+- `createFormValidation` ЧИСТА до `start()` (никаких подписок) → SSR-safe; `start()` возвращает
+  `dispose` и арминует триггеры только на клиенте.
 
-### ArrayConfig
+### Стратегии
 
-**Kind:** `interface`
+| strategy | когда прогон | touch | раскрытие ошибок |
+| --- | --- | --- | --- |
+| `submit` (default) | только `validate()` / `submit()` | `true` | всё на submit |
+| `blur` | смена `touched` поля (потеря фокуса) | `false` | только сблюренные (по `touched`) |
+| `change` | на каждый ввод (+ `debounce`) | `false` | только редактированные (по `dirty`) |
+| `afterFirstSubmit` | тихо до 1-го submit, затем live (`liveAfterSubmit: 'change'` \| `'blur'`, default `'change'`) | `true` один раз на 1-м submit, дальше `false` | тихо → раскрыть всё на submit → далее live |
 
-Конфигурация массива
+## 79. Examples
+
+### Простая форма — afterFirstSubmit + debounce
+
+Тихо до первой отправки, `submit()` раскрывает все ошибки и переводит форму в живую фазу
+(дальше проверка на ввод с задержкой 400 мс). `submit()` сам метит `touched` — ручной
+`markAsTouched` не нужен.
+
+```tsx
+import { createModel, createForm, useFormValidation } from '@reformer/core';
+import { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, email, minLength } from '@reformer/core/validators';
+
+type RegistrationData = { username: string; email: string; password: string };
+
+// Схема — стабильный module-level const (иначе ломается дедуп раннера).
+const registrationValidation = defineValidationSchema<RegistrationData>(({ model }) => {
+  validate(model.$.username, [required(), minLength(3)]);
+  validate(model.$.email, [required(), email()]);
+  validate(model.$.password, [required(), minLength(8)]);
+});
+
+function RegistrationForm() {
+  const model = useMemo(() => createModel<RegistrationData>({ username: '', email: '', password: '' }), []);
+  const form = useMemo(() => createForm({ model }), [model]);
+
+  const { submit, isValidating } = useFormValidation({
+    model,
+    schema: registrationValidation,
+    strategy: 'afterFirstSubmit',
+    debounce: 400,
+  });
+
+  const onSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    if (await submit()) await api.save(model.get()); // true = нет блокирующих ошибок
+  };
+
+  return (
+    <form onSubmit={onSubmit}>
+      <FormField control={form.username} />
+      <FormField control={form.email} />
+      <FormField control={form.password} />
+      <button type="submit" disabled={isValidating}>Отправить</button>
+    </form>
+  );
+}
+```
+
+### Wizard — live-стратегия внутри активного шага
+
+`defineSteps(..., { strategy })` задаёт ЖИВУЮ стратегию ВНУТРИ шага; `useWizardStepValidation`
+арминует её под текущий шаг (`currentStep` из `FormWizardContext`) и снимает при смене шага / unmount.
+Per-step gate (`validateStep` на «Далее») и `validateAll` (submit) при этом НЕ меняются — стратегия
+добавляет живой слой ПОВЕРХ них. No-op, если `strategy` не задана / `'submit'` / у шага нет правил.
+
+```tsx
+import { defineSteps, useWizardStepValidation, FormWizard } from '@reformer/cdk/form-wizard';
+
+const config = defineSteps<'loan' | 'applicant' | 'confirm', CreditForm>(model, {
+  steps: { loan: loanStep, applicant: applicantStep, confirm: null }, // confirm — без правил, ЯВНО
+  extras: crossFieldRules,   // применяются только в validateAll (submit)
+  strategy: 'blur',          // живая валидация полей текущего шага при потере фокуса
+});
+
+function LoanStepBody() {
+  useWizardStepValidation(config); // армит 'blur' под активный шаг, снимает при переходе
+  return <>{/* поля шага */}</>;
+}
+
+<FormWizard form={form} config={config}>
+  <LoanStepBody />
+</FormWizard>;
+```
+
+### Headless / SSR / тесты — createFormValidation
+
+```typescript
+import { createFormValidation } from '@reformer/core/validation';
+
+const ctrl = createFormValidation(model, registrationValidation, {
+  strategy: 'afterFirstSubmit',
+  debounce: 300,
+});
+const dispose = ctrl.start();        // ТОЛЬКО на клиенте (в React — из useEffect)
+const ok = await ctrl.validate();    // submit → раскрыть все ошибки
+dispose();
+```
+
+## 80. Anti-patterns
 
-**Signature:**
 ```typescript
-export interface ArrayConfig<T extends object> {
-  itemSchema: FormSchema<T>;
-  initial?: Partial<T>[];
+// ❌ schema пересоздаётся каждый рендер → контроллер и дедуп раннера ломаются
+function MyForm() {
+  const schema = defineValidationSchema<Form>(({ model }) => { … }); // новая ссылка на каждый рендер
+  useFormValidation({ model, schema, strategy: 'change' });
+}
+
+// ✅ Стабильная ссылка: module-level const (или useMemo с пустыми deps)
+const formValidation = defineValidationSchema<Form>(({ model }) => { … });
+function MyForm() {
+  useFormValidation({ model, schema: formValidation, strategy: 'change' });
 }
 ```
 
-_Source: src/form/types/deep-schema.ts_
+```typescript
+// ❌ Node-level updateOn (Слой B) И активная schema-стратегия на ОДНОМ поле → оба пишут ошибки в ноду → мерцание
+// узел поля: { updateOn: 'blur', … } + useFormValidation({ strategy: 'blur', schema: включает это же поле })
+
+// ✅ Одно поле обслуживает ОДИН слой: либо node-level updateOn, либо schema-стратегия — не оба сразу
+```
+
+```typescript
+// ❌ start() на сервере — арминует реактивные подписки при SSR
+const ctrl = createFormValidation(model, schema, { strategy: 'change' });
+ctrl.start(); // на сервере подписок быть не должно
+
+// ✅ Фабрика чиста до start(); армить только на клиенте (useFormValidation делает это в useEffect)
+const ctrl = createFormValidation(model, schema, { strategy: 'change' });
+if (typeof window !== 'undefined') ctrl.start();
+```
+
+## 81. See also
+
+- [28-submit-and-reset.md](./28-submit-and-reset.md) — submit-флоу и `validateModel` (движок под стратегией)
+- [27-revalidate-when.md](./27-revalidate-when.md) — ручные триггеры перевалидации (низкоуровневый примитив)
+- [31-async-validator-debounce.md](./31-async-validator-debounce.md) — async-правила и отмена устаревших прогонов
+- [13-multi-step.md](./13-multi-step.md) — per-step / полная валидация wizard (`validateStep` / `validateAll`)
+
+## 82. API Reference
+
+_Auto-generated from JSDoc on public exports._
+
+### AnyFunction
+
+**Kind:** `type`
+
+Тип для проверки на функцию в conditional types
+Используется вместо Function для type narrowing
+
+**Signature:**
+```typescript
+export type AnyFunction = (...args: never[]) => unknown;
+```
+
+_Source: src/form/types/index.ts_
 
 ### ArrayControlState
 
@@ -4291,7 +4468,7 @@ return (
 <PhoneItem
  key={item.id}
  control={item}
- onRemove={() => control.remove(index)}
+ onRemove={() => control.removeAt(index)}
 />
 ))}
 
@@ -4359,28 +4536,6 @@ export interface ArrayNodeLike {
 
 _Source: src/form/types/index.ts_
 
-### AsyncValidator
-
-**Kind:** `type`
-
-Чистый асинхронный валидатор поля. Та же тройка аргументов `(value, scope, root)`, что у
-{@link Validator}, но возвращает `Promise`.
-
-**Signature:**
-```typescript
-export type AsyncValidator<TForm, TField> = (
-  value: TField,
-  scope: unknown,
-  root: FormModel<TForm>
-) => Promise<ValidationError | null>;
-```
-
-**Deprecated:** Осиротевший остаток удалённого оператора `validateAsync` (Ф7). Рантаймом не
-потребляется — живой async-путь узла поля использует `AsyncValidatorFn` `(value, { signal })`.
-Экспортируется только ради обратной совместимости.
-
-_Source: src/form/types/validation-schema.ts_
-
 ### AsyncValidatorFn
 
 **Kind:** `type`
@@ -4484,22 +4639,6 @@ computeFrom([model.$.price, model.$.qty], model.$.total, (price, qty) => price *
 
 _Source: src/state/behaviors-value.ts_
 
-### ConditionFn
-
-**Kind:** `type`
-
-Функция-предикат `(value) => boolean`.
-
-**Signature:**
-```typescript
-export type ConditionFn<T> = (value: T) => boolean;
-```
-
-**Deprecated:** Осиротевший остаток удалённого оператора `applyWhen` (Ф7). Рантаймом не
-потребляется; экспортируется только ради обратной совместимости.
-
-_Source: src/form/types/validation-schema.ts_
-
 ### ConfigWithSchema
 
 **Kind:** `interface`
@@ -4554,6 +4693,40 @@ copyFrom(model.$.email, model.$.emailAdditional, { when: () => model.sameEmail }
 
 _Source: src/state/behaviors-value.ts_
 
+### CORE_RUNTIME_TOKEN
+
+**Kind:** `const`
+
+Штамп копии рантайма ядра.
+
+Единственное назначение — быть объектом, уникальным в пределах ОДНОЙ копии модуля. Две
+независимо загруженные копии `@reformer/core` дадут два разных объекта, и по их несовпадению
+guard распознаёт дубль рантайма.
+
+Почему именно объект, а не строка с версией: две копии ОДНОЙ версии ломают всё ровно так же,
+как две копии разных версий, — раздваиваются модульные `WeakMap` (`derived-registry`,
+`signal-node-registry`) и перестают работать проверки `instanceof Signal`. Сравнение версий
+такой случай пропустило бы.
+
+**Signature:**
+```typescript
+export const CORE_RUNTIME_TOKEN: object
+```
+
+**Examples:**
+
+```ts
+import { CORE_RUNTIME_TOKEN } from '@reformer/core';
+import { stampRuntime } from '@reformer/form-registry/guard';
+
+stampRuntime('@reformer/core', CORE_RUNTIME_TOKEN);
+```
+
+**See also:**
+- `@reformer/form-registry/guard`
+
+_Source: src/runtime-token.ts_
+
 ### createForm
 
 **Kind:** `function`
@@ -4759,43 +4932,6 @@ disableWhen(model.$.discount, () => model.plan !== 'promo', { resetOnDisable: tr
 
 _Source: src/form/behaviors-node.ts_
 
-### email
-
-**Kind:** `function`
-
-Фабрика валидатора формата email.
-
-Проверяет по упрощённому regex `^[^\s@]+@[^\s@]+\.[^\s@]+$`. Пустые значения
-(`''`/`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function email<TForm = unknown, TField extends string | null | undefined = string>(
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для строкового поля
-
-**Examples:**
-
-Проверка формата email
-```typescript
-import { required, email } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-email: {
-value: model.$.email,
-component: Input,
-validators: [required(), email({ message: 'Введите корректный email' })],
-},
-```
-
-_Source: src/form/validation/validators/email.ts_
-
 ### enableWhen
 
 **Kind:** `function`
@@ -5085,12 +5221,12 @@ export interface FieldControlState<T> {
 
   /**
    * Пользовательские props для передачи в UI-компоненты.
-   * Устанавливаются через {@link FieldNode.setComponentProps}.
+   * Устанавливаются через {@link FieldNode.updateComponentProps}.
    *
    * @example
    * ```tsx
    * // Установка props
-   * field.setComponentProps({
+   * field.updateComponentProps({
    *   placeholder: 'Enter email...',
    *   maxLength: 100,
    *   autoComplete: 'email'
@@ -5190,23 +5326,6 @@ console.log(field.valid.value); // true
 
 _Source: src/form/nodes/field-node.ts_
 
-### FieldPathSegment
-
-**Kind:** `type`
-
-Тип для путей к полям (field paths)
-Используется в навигации по полям вместо any
-
-**Signature:**
-```typescript
-export type FieldPathSegment = {
-  key: string;
-  index?: number;
-};
-```
-
-_Source: src/form/types/index.ts_
-
 ### FieldStatus
 
 **Kind:** `type`
@@ -5220,70 +5339,6 @@ export type FieldStatus = 'valid' | 'invalid' | 'pending' | 'disabled';
 
 _Source: src/form/types/contracts.ts_
 
-### FileLike
-
-**Kind:** `interface`
-
-Минимальный файлоподобный контракт, с которым работают file-валидаторы:
-нативный `File`, сериализуемый дескриптор загруженного файла и т.п.
-
-**Signature:**
-```typescript
-export interface FileLike {
-  name: string;
-  size?: number;
-  type?: string;
-}
-```
-
-_Source: src/form/validation/validators/file-utils.ts_
-
-### fileType
-
-**Kind:** `function`
-
-Фабрика валидатора типа файла.
-
-Проверяет каждый файл против accept-строки в синтаксисе нативного атрибута
-`<input type="file" accept>`: расширения (`.pdf`), точные MIME (`image/png`),
-wildcard-категории (`image/*`), список через запятую. Матчинг регистронезависимый,
-по `type` и/или расширению из `name` ({@link matchesFileAccept}).
-
-Нужен потому, что нативный `accept` — только подсказка пикеру: на drag-and-drop
-и «All files» он не действует. Пустые значения (`null`/`undefined`/`''`/`[]`)
-пропускаются (используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function fileType<TForm = unknown, TField = unknown>(
-  accept: string,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `accept` — - Accept-строка допустимых типов, например `'image/*,.pdf'`
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `accept` и `fileName` (первый нарушивший файл).
-
-**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
-
-**Examples:**
-
-Только изображения и PDF
-```typescript
-import { fileType } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-documents: {
-value: model.$.documents,
-component: FileUploadField,
-validators: [fileType('image/*,.pdf', { message: 'Только изображения или PDF' })],
-},
-```
-
-_Source: src/form/validation/validators/file-type.ts_
-
 ### FormArrayProxy
 
 **Kind:** `type`
@@ -5664,19 +5719,25 @@ export interface FormSchemaNode {
   component?: ElementType;
   /** Props компонента. Также «клапан» для вложенности под-узлов (напр. steps визарда). */
   componentProps?: Record<string, unknown>;
-  validators?: SchemaValidator[];
-  asyncValidators?: SchemaValidator[];
   updateOn?: 'change' | 'blur' | 'submit';
   disabled?: boolean;
   /** Задержка (мс) перед запуском асинхронной валидации. */
   debounce?: number;
   /** Идентификатор узла (для wizard/tabs/renderBehavior). */
   selector?: string;
+  /**
+   * ⚠️ Рантайм этого поля НЕ ЧИТАЕТ — `renderer-react` берёт testId из `componentProps.testId`
+   * (иначе выводит из пути сигнала). Поле оставлено только потому, что `RenderSchemaNode`
+   * рендерера объявляет свой одноимённый; пишите `componentProps: { testId: '…' }`.
+   */
   testId?: string;
-  /** Дочерние узлы (даёт контекстную типизацию вложенным литералам — value/validators/when). */
-  children?: readonly FormSchemaNode[];
-  /** Условие включения поддерева (branch-узел `{ when, children }`). */
-  when?: (scope: any, root: any) => boolean;
+  /**
+   * Содержимое узла: под-узлы (даёт контекстную типизацию вложенным литералам — value/validators/when)
+   * и текстовые части. Текст (литерал, число, сигнал модели) — такой же ребёнок, как узел: core его
+   * не интерпретирует (обход пропускает примитивы и не спускается внутрь сигнала), а рендерер
+   * выводит на своём месте в порядке следования.
+   */
+  children?: readonly (FormSchemaNode | string | number | Signal<any>)[];
   /** Реактивный массив модели (`model.<path>`) — маркер узла-массива (вместе с `item`). */
   array?: SchemaArrayControl;
   /** Схема элемента массива: под-модель элемента → узел поддерева. */
@@ -5694,43 +5755,6 @@ export interface FormSchemaNode {
 
 _Source: src/form/types/schema-node.ts_
 
-### FormStatusMachine
-
-**Kind:** `class`
-
-FormStatusMachine - управляет состоянием поля формы
-
-Предоставляет:
-- Единый источник истины для статуса
-- Computed signals для derived состояний (valid, invalid, pending, disabled)
-- Валидацию переходов между состояниями
-
-**Signature:**
-```typescript
-export class FormStatusMachine {
-  /** Внутренний сигнал статуса */ /* … */ }
-```
-
-**Examples:**
-
-```typescript
-const statusMachine = new FormStatusMachine('valid');
-
-// Начало валидации
-statusMachine.startValidation();
-console.log(statusMachine.pending.value); // true
-
-// Завершение валидации с ошибками
-statusMachine.completeValidation(true);
-console.log(statusMachine.invalid.value); // true
-
-// Отключение поля
-statusMachine.disable();
-console.log(statusMachine.disabled.value); // true
-```
-
-_Source: src/form/status-machine.ts_
-
 ### FormSubmitter
 
 **Kind:** `class`
@@ -5784,44 +5808,6 @@ export type FormValue =
 
 _Source: src/form/types/contracts.ts_
 
-### futureDate
-
-**Kind:** `function`
-
-Фабрика валидатора, проверяющего что дата не в прошлом.
-
-Дата не должна быть раньше сегодняшнего дня (сравнение по нормализованным датам).
-Пустые и невалидные даты пропускаются (используйте {@link required} и {@link isDate}).
-
-**Signature:**
-```typescript
-export function futureDate<
-  TForm = unknown,
-  TField extends string | Date | null | undefined = string | Date,
->(options?: ValidateOptions): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для поля даты (`string | Date`)
-
-**Examples:**
-
-Дата не в прошлом
-```typescript
-import { required, futureDate } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-appointmentDate: {
-value: model.$.appointmentDate,
-component: DatePicker,
-validators: [required(), futureDate({ message: 'Дата записи должна быть в будущем' })],
-},
-```
-
-_Source: src/form/validation/validators/future-date.ts_
-
 ### getNodeForSignal
 
 **Kind:** `function`
@@ -5937,42 +5923,6 @@ export interface GroupNodeConfig<T> {
 
 _Source: src/form/types/index.ts_
 
-### integer
-
-**Kind:** `function`
-
-Фабрика валидатора, проверяющего что число — целое.
-
-Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
-
-**Signature:**
-```typescript
-export function integer<TForm = unknown, TField extends number | null | undefined = number>(
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для числового поля
-
-**Examples:**
-
-Проверка целого числа
-```typescript
-import { required, integer } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-count: {
-value: model.$.count,
-component: Input,
-validators: [required(), integer({ message: 'Должно быть целым числом' })],
-},
-```
-
-_Source: src/form/validation/validators/integer.ts_
-
 ### isArrayNode
 
 **Kind:** `function`
@@ -6004,49 +5954,11 @@ if (isArrayNode(node)) {
 
 _Source: src/form/type-guards.ts_
 
-### isDate
+### isDerived
 
 **Kind:** `function`
 
-Фабрика валидатора, проверяющего что значение — валидная дата.
-
-Принимает `Date` или строку, парсимую в дату. Пустые значения (`''`/`null`/`undefined`)
-пропускаются (используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function isDate<
-  TForm = unknown,
-  TField extends string | Date | null | undefined = string | Date,
->(options?: ValidateOptions): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для поля даты (`string | Date`)
-
-**Examples:**
-
-Проверка валидности даты
-```typescript
-import { required, isDate } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-eventDate: {
-value: model.$.eventDate,
-component: DatePicker,
-validators: [required(), isDate({ message: 'Введите корректную дату' })],
-},
-```
-
-_Source: src/form/validation/validators/is-date.ts_
-
-### isDerived
-
-**Kind:** `function`
-
-Производный ли сигнал (помечен через {@link markDerived}).
+Производный ли сигнал (помечен через {@link markDerived}).
 
 Читается bulk-сеттерами модели/группы, чтобы не затирать вычисляемые (`computeFrom`) поля
 значениями из payload.
@@ -6087,733 +5999,119 @@ FieldNode представляет примитивное поле формы (s
 
 **Signature:**
 ```typescript
-export function isFieldNode(value: unknown): value is FieldNode<FormValue>
-```
-
-**Parameters:**
-- `value` — - Значение для проверки
-
-**Returns:** true если value является FieldNode
-
-**Examples:**
-
-```typescript
-if (isFieldNode(node)) {
-  node.validators; //  OK
-  node.asyncValidators; //  OK
-  node.markAsTouched(); //  OK
-}
-```
-
-_Source: src/form/type-guards.ts_
-
-### isFileLike
-
-**Kind:** `function`
-
-Проверяет, что значение файлоподобно: объект со строковым `name` и опциональными
-числовым `size` / строковым `type`.
-
-**Signature:**
-```typescript
-export function isFileLike(value: unknown): value is FileLike
-```
-
-**Parameters:**
-- `value` — - Проверяемое значение
-
-**Returns:** `true`, если значение соответствует {@link FileLike}
-
-_Source: src/form/validation/validators/file-utils.ts_
-
-### isFormNode
-
-**Kind:** `function`
-
-Проверить, является ли значение любым FormNode
-
-Проверяет базовые свойства, общие для всех типов узлов
-
-**Signature:**
-```typescript
-export function isFormNode(value: unknown): value is FormNode<FormValue>
-```
-
-**Parameters:**
-- `value` — - Значение для проверки
-
-**Returns:** true если value является FormNode
-
-**Examples:**
-
-```typescript
-if (isFormNode(value)) {
-  value.setValue(newValue);
-  value.validate();
-}
-```
-
-_Source: src/form/type-guards.ts_
-
-### isGroupNode
-
-**Kind:** `function`
-
-Проверить, является ли значение GroupNode (объект с вложенными полями)
-
-GroupNode представляет объект с вложенными полями формы: имеет навигацию по полям
-(`getFieldByPath`/`fields`) и НЕ имеет array-методов (`items`/`push`/`removeAt`).
-
-**Signature:**
-```typescript
-export function isGroupNode(value: unknown): value is GroupNode<object>
-```
-
-**Parameters:**
-- `value` — - Значение для проверки
-
-**Returns:** true если value является GroupNode
-
-**Examples:**
-
-```typescript
-if (isGroupNode(node)) {
-  node.getFieldByPath('user.email'); //  OK
-}
-```
-
-_Source: src/form/type-guards.ts_
-
-### isNumber
-
-**Kind:** `function`
-
-Фабрика валидатора, проверяющего что значение — конечное число (не NaN, не строка).
-
-Пустые значения (`null`/`undefined`) пропускаются (используйте {@link required} для
-обязательности). В отличие от других number-валидаторов, **не** пропускает не-числа
-и `NaN` — это его задача.
-
-**Signature:**
-```typescript
-export function isNumber<TForm = unknown, TField extends number | null | undefined = number>(
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для числового поля
-
-**Examples:**
-
-Проверка, что значение — число
-```typescript
-import { required, isNumber } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-amount: {
-value: model.$.amount,
-component: Input,
-validators: [required(), isNumber({ message: 'Введите число' })],
-},
-```
-
-_Source: src/form/validation/validators/is-number.ts_
-
-### markDerived
-
-**Kind:** `function`
-
-Пометить сигнал производным (вычисляемым).
-
-Вызывается операторами {@link computeFrom}/`compute` для их сигнала-цели. После этого
-bulk-сеттеры (`model.set`/`model.patch`, `patchValue`/`setValue`) пропускают это поле, чтобы
-значение из payload не затирало вычисляемое. Прикладной код напрямую обычно не вызывает.
-
-Идемпотентна на уровне флага: повторные вызовы наращивают счётчик ссылок, чтобы каждый оператор,
-пишущий в этот сигнал, был сбалансирован своим {@link unmarkDerived} при dispose.
-
-**Signature:**
-```typescript
-export function markDerived(signal: Signal<any>): void
-```
-
-**Parameters:**
-- `signal` — - Сигнал значения из {@link FormModel}, которым владеет compute
-
-**Examples:**
-
-```typescript
-import { markDerived } from '@reformer/core';
-
-// Помечаем поле total как вычисляемое — bulk-set его не перезапишет
-markDerived(model.$.total);
-```
-
-**See also:**
-- {@link isDerived} - проверка пометки
-- {@link unmarkDerived} - снять пометку при dispose оператора
-
-_Source: src/state/derived-registry.ts_
-
-### matchesFileAccept
-
-**Kind:** `function`
-
-Проверяет файл против accept-паттерна в синтаксисе нативного атрибута
-`<input type="file" accept>`: список через запятую из расширений (`.pdf`),
-точных MIME (`image/png`) и wildcard-категорий (`image/*`). Регистронезависимо.
-
-Нужен собственный матчер, потому что `accept` у нативного input — только подсказка
-пикеру: на drag-and-drop и на программное значение он не действует.
-
-**Signature:**
-```typescript
-export function matchesFileAccept(file: Pick<FileLike, 'name' | 'type'>, accept: string): boolean
-```
-
-**Parameters:**
-- `file` — - Файлоподобное значение (`name` + опциональный `type`)
-- `accept` — - Accept-строка; пустая/пробельная строка матчит всё
-
-**Returns:** `true`, если файл подходит хотя бы под один паттерн
-
-_Source: src/form/validation/validators/file-utils.ts_
-
-### max
-
-**Kind:** `function`
-
-Фабрика валидатора максимального числового значения.
-
-Пустые значения (`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function max<TForm = unknown, TField extends number | null | undefined = number>(
-  maxValue: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `maxValue` — - Максимально допустимое значение (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `max` и `actual`.
-
-**Returns:** Чистый валидатор {@link Validator} для числового поля
-
-**Examples:**
-
-Максимальное значение числового поля
-```typescript
-import { required, max } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-quantity: { value: model.$.quantity, component: Input, validators: [max(100)] },
-discount: {
-value: model.$.discount,
-component: Input,
-validators: [required(), max(50, { message: 'Не более 50%' })],
-},
-```
-
-_Source: src/form/validation/validators/max.ts_
-
-### maxAge
-
-**Kind:** `function`
-
-Фабрика валидатора максимального возраста (по дате рождения).
-
-Возраст вычисляется по дате рождения относительно сегодняшнего дня. Пустые и невалидные
-даты пропускаются (используйте {@link required} и {@link isDate}).
-
-**Signature:**
-```typescript
-export function maxAge<
-  TForm = unknown,
-  TField extends string | Date | null | undefined = string | Date,
->(maxAgeValue: number, options?: ValidateOptions): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `maxAgeValue` — - Максимально допустимый возраст (в полных годах)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `maxAge` и `currentAge`.
-
-**Returns:** Чистый валидатор {@link Validator} для поля даты рождения (`string | Date`)
-
-**Examples:**
-
-Максимальный возраст
-```typescript
-import { maxAge } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-birthDate: {
-value: model.$.birthDate,
-component: DatePicker,
-validators: [maxAge(100, { message: 'Проверьте дату рождения' })],
-},
-```
-
-_Source: src/form/validation/validators/max-age.ts_
-
-### maxDate
-
-**Kind:** `function`
-
-Фабрика валидатора максимальной даты (включительно).
-
-Сравнение по нормализованным датам (время обнуляется). Пустые и невалидные даты
-пропускаются (используйте {@link required} и {@link isDate}).
-
-**Signature:**
-```typescript
-export function maxDate<
-  TForm = unknown,
-  TField extends string | Date | null | undefined = string | Date,
->(maxDateValue: Date, options?: ValidateOptions): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `maxDateValue` — - Максимально допустимая дата (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадает `maxDate`.
-
-**Returns:** Чистый валидатор {@link Validator} для поля даты (`string | Date`)
-
-**Examples:**
-
-Максимальная дата
-```typescript
-import { maxDate } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-birthDate: {
-value: model.$.birthDate,
-component: DatePicker,
-validators: [maxDate(new Date(), { message: 'Дата не может быть в будущем' })],
-},
-```
-
-_Source: src/form/validation/validators/max-date.ts_
-
-### maxFiles
-
-**Kind:** `function`
-
-Фабрика валидатора максимального количества файлов.
-
-Работает с массивом файлов (одиночный файл считается как 1). Пустые значения
-(`null`/`undefined`/`''`/`[]`) пропускаются (используйте {@link required}
-для обязательности).
-
-**Signature:**
-```typescript
-export function maxFiles<TForm = unknown, TField = unknown>(
-  max: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `max` — - Максимально допустимое количество файлов (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `maxFiles` и `actualCount`.
-
-**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
-
-**Examples:**
-
-Не более трёх вложений
-```typescript
-import { maxFiles } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-documents: {
-value: model.$.documents,
-component: FileUploadField,
-validators: [maxFiles(3, { message: 'Максимум 3 файла' })],
-},
-```
-
-_Source: src/form/validation/validators/max-files.ts_
-
-### maxFileSize
-
-**Kind:** `function`
-
-Фабрика валидатора максимального размера файла.
-
-Работает с одиночным файлом или массивом (`File` либо файлоподобный дескриптор с
-`name`/`size`). Проверяется каждый файл; в ошибку попадает первый нарушивший.
-Пустые значения (`null`/`undefined`/`''`/`[]`) и элементы без числового `size`
-(например, дескриптор загруженного файла без размера) пропускаются
-(используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function maxFileSize<TForm = unknown, TField = unknown>(
-  maxSize: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `maxSize` — - Максимально допустимый размер файла в байтах (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `maxFileSize`, `fileName` и `actualSize`.
-
-**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
-
-**Examples:**
-
-Ограничение размера вложений
-```typescript
-import { maxFileSize } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-documents: {
-value: model.$.documents,
-component: FileUploadField,
-validators: [maxFileSize(5 * 1024 * 1024, { message: 'Файл больше 5 МБ' })],
-},
-```
-
-_Source: src/form/validation/validators/max-file-size.ts_
-
-### maxLength
-
-**Kind:** `function`
-
-Фабрика валидатора максимальной длины строки или массива.
-
-Работает со строкой или массивом (проверяется `value.length`). Пустые значения
-(`null`/`undefined`/`''`) и значения без числового `length` пропускаются
-(используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function maxLength<TForm = unknown, TField = unknown>(
-  maxLen: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `maxLen` — - Максимально допустимая длина (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `maxLength` и `actualLength`.
-
-**Returns:** Чистый валидатор {@link Validator} для строки или массива
-
-**Examples:**
-
-Максимальная длина строки
-```typescript
-import { maxLength } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-name: { value: model.$.name, component: Input, validators: [maxLength(50)] },
-bio: {
-value: model.$.bio,
-component: Textarea,
-validators: [maxLength(500, { message: 'Максимум 500 символов' })],
-},
-```
-
-_Source: src/form/validation/validators/max-length.ts_
-
-### maxTotalFileSize
-
-**Kind:** `function`
-
-Фабрика валидатора суммарного размера всех файлов.
-
-Складывает `size` всех файлов значения (элементы без числового `size` в сумму
-не входят). Пустые значения (`null`/`undefined`/`''`/`[]`) пропускаются
-(используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function maxTotalFileSize<TForm = unknown, TField = unknown>(
-  maxTotal: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `maxTotal` — - Максимально допустимый суммарный размер в байтах (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `maxTotalFileSize` и `actualTotal`.
-
-**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
-
-**Examples:**
-
-Суммарно не более 20 МБ
-```typescript
-import { maxTotalFileSize } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-documents: {
-value: model.$.documents,
-component: FileUploadField,
-validators: [maxTotalFileSize(20 * 1024 * 1024, { message: 'Суммарно не более 20 МБ' })],
-},
-```
-
-_Source: src/form/validation/validators/max-total-file-size.ts_
-
-### min
-
-**Kind:** `function`
-
-Фабрика валидатора минимального числового значения.
-
-Пустые значения (`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
-
-**Signature:**
-```typescript
-export function min<TForm = unknown, TField extends number | null | undefined = number>(
-  minValue: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `minValue` — - Минимально допустимое значение (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `min` и `actual`.
-
-**Returns:** Чистый валидатор {@link Validator} для числового поля
-
-**Examples:**
-
-Минимальное значение числового поля
-```typescript
-import { required, min } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-age: { value: model.$.age, component: Input, validators: [min(18)] },
-quantity: {
-value: model.$.quantity,
-component: Input,
-validators: [required(), min(1, { message: 'Минимум 1' })],
-},
-```
-
-_Source: src/form/validation/validators/min.ts_
-
-### minAge
-
-**Kind:** `function`
-
-Фабрика валидатора минимального возраста (по дате рождения).
-
-Возраст вычисляется по дате рождения относительно сегодняшнего дня. Пустые и невалидные
-даты пропускаются (используйте {@link required} и {@link isDate}).
-
-**Signature:**
-```typescript
-export function minAge<
-  TForm = unknown,
-  TField extends string | Date | null | undefined = string | Date,
->(minAgeValue: number, options?: ValidateOptions): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `minAgeValue` — - Минимально допустимый возраст (в полных годах)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `minAge` и `currentAge`.
-
-**Returns:** Чистый валидатор {@link Validator} для поля даты рождения (`string | Date`)
-
-**Examples:**
-
-Минимальный возраст
-```typescript
-import { required, minAge } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-birthDate: {
-value: model.$.birthDate,
-component: DatePicker,
-validators: [required(), minAge(18, { message: 'Вам должно быть не менее 18 лет' })],
-},
-```
-
-_Source: src/form/validation/validators/min-age.ts_
-
-### minDate
-
-**Kind:** `function`
-
-Фабрика валидатора минимальной даты (включительно).
-
-Сравнение по нормализованным датам (время обнуляется). Пустые и невалидные даты
-пропускаются (используйте {@link required} и {@link isDate}).
-
-**Signature:**
-```typescript
-export function minDate<
-  TForm = unknown,
-  TField extends string | Date | null | undefined = string | Date,
->(minDateValue: Date, options?: ValidateOptions): Validator<TForm, TField>
+export function isFieldNode(value: unknown): value is FieldNode<FormValue>
 ```
 
 **Parameters:**
-- `minDateValue` — - Минимально допустимая дата (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадает `minDate`.
+- `value` — - Значение для проверки
 
-**Returns:** Чистый валидатор {@link Validator} для поля даты (`string | Date`)
+**Returns:** true если value является FieldNode
 
 **Examples:**
 
-Минимальная дата
 ```typescript
-import { required, minDate } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-startDate: {
-value: model.$.startDate,
-component: DatePicker,
-validators: [required(), minDate(new Date(), { message: 'Дата не раньше сегодня' })],
-},
+if (isFieldNode(node)) {
+  node.validators; //  OK
+  node.asyncValidators; //  OK
+  node.markAsTouched(); //  OK
+}
 ```
 
-_Source: src/form/validation/validators/min-date.ts_
+_Source: src/form/type-guards.ts_
 
-### minFiles
+### isFormNode
 
 **Kind:** `function`
 
-Фабрика валидатора минимального количества файлов.
+Проверить, является ли значение любым FormNode
 
-Работает с массивом файлов (одиночный файл считается как 1). Пустые значения
-(`null`/`undefined`/`''`/`[]`) пропускаются — «нужен хотя бы один файл» выражается
-связкой `required()` + `minFiles(n)`, как и у {@link minLength}.
+Проверяет базовые свойства, общие для всех типов узлов
 
 **Signature:**
 ```typescript
-export function minFiles<TForm = unknown, TField = unknown>(
-  min: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
+export function isFormNode(value: unknown): value is FormNode<FormValue>
 ```
 
 **Parameters:**
-- `min` — - Минимально допустимое количество файлов (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `minFiles` и `actualCount`.
+- `value` — - Значение для проверки
 
-**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
+**Returns:** true если value является FormNode
 
 **Examples:**
 
-Не менее двух документов
 ```typescript
-import { required, minFiles } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-documents: {
-value: model.$.documents,
-component: FileUploadField,
-validators: [required(), minFiles(2, { message: 'Приложите минимум 2 документа' })],
-},
+if (isFormNode(value)) {
+  value.setValue(newValue);
+  value.validate();
+}
 ```
 
-_Source: src/form/validation/validators/min-files.ts_
+_Source: src/form/type-guards.ts_
 
-### minFileSize
+### isGroupNode
 
 **Kind:** `function`
 
-Фабрика валидатора минимального размера файла.
+Проверить, является ли значение GroupNode (объект с вложенными полями)
 
-Работает с одиночным файлом или массивом (`File` либо файлоподобный дескриптор с
-`name`/`size`). Проверяется каждый файл; в ошибку попадает первый нарушивший.
-Типовой сценарий — отсев пустых (0-байтовых) файлов: `minFileSize(1)`.
-Пустые значения (`null`/`undefined`/`''`/`[]`) и элементы без числового `size`
-пропускаются (используйте {@link required} для обязательности).
+GroupNode представляет объект с вложенными полями формы: имеет навигацию по полям
+(`getFieldByPath`/`fields`) и НЕ имеет array-методов (`items`/`push`/`removeAt`).
 
 **Signature:**
 ```typescript
-export function minFileSize<TForm = unknown, TField = unknown>(
-  minSize: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
+export function isGroupNode(value: unknown): value is GroupNode<object>
 ```
 
 **Parameters:**
-- `minSize` — - Минимально допустимый размер файла в байтах (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `minFileSize`, `fileName` и `actualSize`.
+- `value` — - Значение для проверки
 
-**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
+**Returns:** true если value является GroupNode
 
 **Examples:**
 
-Отсев пустых файлов
 ```typescript
-import { minFileSize } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-documents: {
-value: model.$.documents,
-component: FileUploadField,
-validators: [minFileSize(1, { message: 'Файл пустой' })],
-},
+if (isGroupNode(node)) {
+  node.getFieldByPath('user.email'); //  OK
+}
 ```
 
-_Source: src/form/validation/validators/min-file-size.ts_
+_Source: src/form/type-guards.ts_
 
-### minLength
+### markDerived
 
 **Kind:** `function`
 
-Фабрика валидатора минимальной длины строки или массива.
+Пометить сигнал производным (вычисляемым).
+
+Вызывается операторами {@link computeFrom}/`compute` для их сигнала-цели. После этого
+bulk-сеттеры (`model.set`/`model.patch`, `patchValue`/`setValue`) пропускают это поле, чтобы
+значение из payload не затирало вычисляемое. Прикладной код напрямую обычно не вызывает.
 
-Работает со строкой или массивом (проверяется `value.length`). Пустые значения
-(`null`/`undefined`/`''`) и значения без числового `length` пропускаются
-(используйте {@link required} для обязательности).
+Идемпотентна на уровне флага: повторные вызовы наращивают счётчик ссылок, чтобы каждый оператор,
+пишущий в этот сигнал, был сбалансирован своим {@link unmarkDerived} при dispose.
 
 **Signature:**
 ```typescript
-export function minLength<TForm = unknown, TField = unknown>(
-  minLen: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
+export function markDerived(signal: Signal<any>): void
 ```
 
 **Parameters:**
-- `minLen` — - Минимально допустимая длина (включительно)
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадают `minLength` и `actualLength`.
-
-**Returns:** Чистый валидатор {@link Validator} для строки или массива
+- `signal` — - Сигнал значения из {@link FormModel}, которым владеет compute
 
 **Examples:**
 
-Минимальная длина строки
 ```typescript
-import { required, minLength } from '@reformer/core/validators';
+import { markDerived } from '@reformer/core';
 
-// Внутри FieldConfig схемы формы:
-name: { value: model.$.name, component: Input, validators: [minLength(2)] },
-password: {
-value: model.$.password,
-component: Input,
-validators: [required(), minLength(8, { message: 'Минимум 8 символов' })],
-},
+// Помечаем поле total как вычисляемое — bulk-set его не перезапишет
+markDerived(model.$.total);
 ```
 
-_Source: src/form/validation/validators/min-length.ts_
+**See also:**
+- {@link isDerived} - проверка пометки
+- {@link unmarkDerived} - снять пометку при dispose оператора
+
+_Source: src/state/derived-registry.ts_
 
 ### ModelApi
 
@@ -7017,358 +6315,105 @@ _Source: src/state/types.ts_
 - примитив → значение
 
 **Signature:**
-```typescript
-export type ModelValue<V> =
-  NonNullable<V> extends ReadonlyArray<infer U>
-    ? ModelArray<U>
-    : NonNullable<V> extends Opaque
-      ? V
-      : NonNullable<V> extends object
-        ? FormModel<NonNullable<V>>
-        : V;
-```
-
-_Source: src/state/types.ts_
-
-### multipleOf
-
-**Kind:** `function`
-
-Фабрика валидатора, проверяющего что число кратно заданному.
-
-Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
-
-**Signature:**
-```typescript
-export function multipleOf<TForm = unknown, TField extends number | null | undefined = number>(
-  divisor: number,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `divisor` — - Делитель: значение должно быть кратно ему
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадает `multipleOf` (делитель).
-
-**Returns:** Чистый валидатор {@link Validator} для числового поля
-
-**Examples:**
-
-Проверка кратности
-```typescript
-import { multipleOf } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-rating: {
-value: model.$.rating,
-component: Input,
-validators: [multipleOf(0.5, { message: 'Только шаг 0.5' })],
-},
-```
-
-_Source: src/form/validation/validators/multiple-of.ts_
-
-### NodeFactory
-
-**Kind:** `class`
-
-Фабрика для создания узлов формы.
-
-Определяет тип конфига и создаёт соответствующий узел (FieldNode, GroupNode, ArrayNode).
-Используется внутри `getReformerForm`/`group`/`array` — явно вызывать обычно не нужно.
-
-**Signature:**
-```typescript
-export 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();
-   *
-   * // 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
-   * ]);
-   * ```
-   */ /* … */ }
-```
-
-**Examples:**
-
-```typescript
-import { NodeFactory } from '@reformer/core';
-
-const factory = new NodeFactory();
-const node = factory.createNode({ value: '', component: Input }); // → FieldNode<string>
-```
-
-_Source: src/form/factories/node-factory.ts_
-
-### nonNegative
-
-**Kind:** `function`
-
-Фабрика валидатора, проверяющего что число неотрицательное (`≥ 0`).
-
-Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
-
-**Signature:**
-```typescript
-export function nonNegative<TForm = unknown, TField extends number | null | undefined = number>(
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для числового поля
-
-**Examples:**
-
-Проверка неотрицательности
-```typescript
-import { nonNegative } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-balance: {
-value: model.$.balance,
-component: Input,
-validators: [nonNegative({ message: 'Баланс не может быть отрицательным' })],
-},
-```
-
-_Source: src/form/validation/validators/non-negative.ts_
-
-### nonZero
-
-**Kind:** `function`
-
-Фабрика валидатора, проверяющего что число не равно нулю.
-
-Пустые значения и не-числа пропускаются (используйте {@link required} и {@link isNumber}).
-
-**Signature:**
-```typescript
-export function nonZero<TForm = unknown, TField extends number | null | undefined = number>(
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для числового поля
-
-**Examples:**
-
-Проверка «не ноль»
-```typescript
-import { nonZero } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-divisor: {
-value: model.$.divisor,
-component: Input,
-validators: [nonZero({ message: 'Не может быть нулём' })],
-},
-```
-
-_Source: src/form/validation/validators/non-zero.ts_
-
-### pastDate
-
-**Kind:** `function`
-
-Фабрика валидатора, проверяющего что дата не в будущем.
-
-Дата не должна быть позже сегодняшнего дня (сравнение по нормализованным датам).
-Пустые и невалидные даты пропускаются (используйте {@link required} и {@link isDate}).
-
-**Signature:**
-```typescript
-export function pastDate<
-  TForm = unknown,
-  TField extends string | Date | null | undefined = string | Date,
->(options?: ValidateOptions): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для поля даты (`string | Date`)
-
-**Examples:**
-
-Дата не в будущем
-```typescript
-import { required, pastDate } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-birthDate: {
-value: model.$.birthDate,
-component: DatePicker,
-validators: [required(), pastDate({ message: 'Дата рождения не может быть в будущем' })],
-},
-```
-
-_Source: src/form/validation/validators/past-date.ts_
-
-### PathAwareSignal
-
-**Kind:** `type`
-
-Сигнал, который знает свой путь в модели (`'personalData.lastName'`).
-Используется как «ручка поля»: и привязка value в схеме, и идентичность для testId/devtools.
-
-**Signature:**
-```typescript
-export type PathAwareSignal<T> = Signal<T> & {
-  /** Путь поля в модели (dot-нотация). На элементах массива включает индекс. */
-  readonly __path: string;
-};
-```
-
-_Source: src/state/types.ts_
-
-### pattern
-
-**Kind:** `function`
-
-Фабрика валидатора регулярного выражения.
-
-Пустые значения (`''`/`null`/`undefined`) пропускаются (используйте {@link required}
-для обязательности).
-
-**Signature:**
-```typescript
-export function pattern<TForm = unknown, TField extends string | null | undefined = string>(
-  regex: RegExp,
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `regex` — - Регулярное выражение для проверки значения
-- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
-попадает `pattern` (строка-источник regex).
-
-**Returns:** Чистый валидатор {@link Validator} для строкового поля
-
-**Examples:**
-
-Проверка по регулярному выражению
-```typescript
-import { required, pattern } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-name: {
-value: model.$.name,
-component: Input,
-validators: [pattern(/^[a-zA-Zа-яА-Я]+$/, { message: 'Только буквы' })],
-},
-phone: {
-value: model.$.phone,
-component: InputMask,
-validators: [
-required(),
-pattern(/^\+7 \(\d{3}\) \d{3}-\d{2}-\d{2}$/, { message: 'Формат +7 (999) 123-45-67' }),
-],
-},
+```typescript
+export type ModelValue<V> =
+  NonNullable<V> extends ReadonlyArray<infer U>
+    ? ModelArray<U>
+    : NonNullable<V> extends Opaque
+      ? V
+      : NonNullable<V> extends object
+        ? FormModel<NonNullable<V>>
+        : V;
 ```
 
-_Source: src/form/validation/validators/pattern.ts_
+_Source: src/state/types.ts_
 
-### phone
+### NodeFactory
 
-**Kind:** `function`
+**Kind:** `class`
 
-Фабрика валидатора номера телефона.
+Фабрика для создания узлов формы.
 
-Проверяет значение по regex выбранного {@link PhoneFormat}. Пустые значения
-(`''`/`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
+Определяет тип конфига и создаёт соответствующий узел (FieldNode, GroupNode, ArrayNode).
+Используется внутри `getReformerForm`/`group`/`array` — явно вызывать обычно не нужно.
 
 **Signature:**
 ```typescript
-export function phone<TForm = unknown, TField extends string | null | undefined = string>(
-  options?: PhoneValidatorOptions
-): Validator<TForm, TField>
+export 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();
+   *
+   * // 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
+   * ]);
+   * ```
+   */ /* … */ }
 ```
 
-**Parameters:**
-- `options` — - Опции валидатора {@link PhoneValidatorOptions}. В `params` ошибки
-автоматически попадает выбранный `format`.
-
-**Returns:** Чистый валидатор {@link Validator} для строкового поля
-
 **Examples:**
 
-Проверка номера телефона
 ```typescript
-import { required, phone } from '@reformer/core/validators';
+import { NodeFactory } from '@reformer/core';
 
-// Внутри FieldConfig схемы формы:
-phone: {
-value: model.$.phone,
-component: Input,
-validators: [required(), phone({ format: 'ru' })],
-},
+const factory = new NodeFactory();
+const node = factory.createNode({ value: '', component: Input }); // → FieldNode<string>
 ```
 
-_Source: src/form/validation/validators/phone.ts_
+_Source: src/form/factories/node-factory.ts_
 
-### PhoneFormat
+### PathAwareSignal
 
 **Kind:** `type`
 
-Формат проверки номера телефона для валидатора {@link phone}.
-
-- `international` — международный формат E.164 (`+?[1-9]\d{1,14}`);
-- `ru` — российские номера (`+7`/`7`/`8`, коды `4`/`8`/`9`, с разделителями);
-- `us` — североамериканские номера (NANP);
-- `any` — свободный формат: цифры, скобки и разделители (по умолчанию).
+Сигнал, который знает свой путь в модели (`'personalData.lastName'`).
+Используется как «ручка поля»: и привязка value в схеме, и идентичность для testId/devtools.
 
 **Signature:**
 ```typescript
-export type PhoneFormat = 'international' | 'ru' | 'us' | 'any';
+export type PathAwareSignal<T> = Signal<T> & {
+  /** Путь поля в модели (dot-нотация). На элементах массива включает индекс. */
+  readonly __path: string;
+};
 ```
 
-_Source: src/form/validation/validators/phone.ts_
+_Source: src/state/types.ts_
 
 ### registerSignalNode
 
@@ -7404,52 +6449,6 @@ if (sig && node) registerSignalNode(sig, node);
 
 _Source: src/form/signal-node-registry.ts_
 
-### required
-
-**Kind:** `function`
-
-Фабрика валидатора обязательного поля.
-
-Возвращает чистую функцию-валидатор `(value, control, root)`. Передаётся в `validate()`.
-
-Пустыми считаются: `null`, `undefined`, `''` (пустая строка), `[]` (пустой массив —
-обязательный multi-select / FormArray без выбранных элементов).
-Для boolean полей требуется значение `true`.
-
-**Signature:**
-```typescript
-export function required<TForm = unknown, TField = unknown>(
-  options?: ValidateOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
-
-**Returns:** Чистый валидатор {@link Validator} для поля схемы
-
-**Examples:**
-
-Обязательные поля в схеме формы
-```typescript
-import { required } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-email: { value: model.$.email, component: Input, validators: [required()] },
-phone: {
-value: model.$.phone,
-component: Input,
-validators: [required({ message: 'Укажите номер телефона' })],
-},
-agreeToTerms: {
-value: model.$.agreeToTerms,
-component: Checkbox,
-validators: [required({ message: 'Необходимо принять условия' })],
-},
-```
-
-_Source: src/form/validation/validators/required.ts_
-
 ### resetWhen
 
 **Kind:** `function`
@@ -7473,19 +6472,6 @@ resetWhen(model.$.cardNumber, () => model.paymentType !== 'card', { resetValue:
 
 _Source: src/state/behaviors-value.ts_
 
-### ResourceLoadResult
-
-**Kind:** `type`
-
-Тип для результатов загрузки ресурсов
-
-**Signature:**
-```typescript
-export type ResourceLoadResult = unknown;
-```
-
-_Source: src/form/types/index.ts_
-
 ### revalidateWhen
 
 **Kind:** `function`
@@ -7643,25 +6629,6 @@ export interface SchemaArrayControl {
 
 _Source: src/form/types/schema-node.ts_
 
-### SchemaValidator
-
-**Kind:** `type`
-
-Валидатор поля схемы (legacy). Дерево-движок, вызывавший `validators` узла как
-`(value, scope, root)`, удалён — живые правила это `Rule<T>` в `validate(sig, [...])`
-(`@reformer/core/validation`). Тип остаётся широким по параметрам для совместимости
-узлов, всё ещё несущих `validators` (гетерогенные контракты `ValidatorFn`/`Validator`).
-
-**Signature:**
-```typescript
-export type SchemaValidator = (
-  value: any,
-  ...rest: any[]
-) => ValidationError | null | Promise<ValidationError | null>;
-```
-
-_Source: src/form/types/schema-node.ts_
-
 ### SetValueOptions
 
 **Kind:** `interface`
@@ -7673,32 +6640,13 @@ _Source: src/form/types/schema-node.ts_
 export interface SetValueOptions {
   /** Не вызывать событие изменения (не триггерить валидацию) */
   emitEvent?: boolean;
-  /** Обновить только этот узел, не распространять на родителей */
-  onlySelf?: boolean;
+  // onlySelf удалён в 7.0: опция объявлялась, но не была реализована ни одной из четырёх
+  // реализаций setValue — передача значения ни на что не влияла.
 }
 ```
 
 _Source: src/form/nodes/form-node.ts_
 
-### StatusEvent
-
-**Kind:** `type`
-
-События для State Machine
-
-**Signature:**
-```typescript
-export type StatusEvent =
-  | { type: 'START_VALIDATION' }
-  | { type: 'VALIDATION_SUCCESS' }
-  | { type: 'VALIDATION_FAILURE' }
-  | { type: 'DISABLE' }
-  | { type: 'ENABLE'; hasErrors?: boolean }
-  | { type: 'SET_ERRORS'; hasErrors: boolean };
-```
-
-_Source: src/form/status-machine.ts_
-
 ### SubmitOptions
 
 **Kind:** `interface`
@@ -7825,27 +6773,6 @@ syncFields(model.$.field1, model.$.field2);
 
 _Source: src/state/behaviors-value.ts_
 
-### toFileArray
-
-**Kind:** `function`
-
-Нормализует значение file-поля в массив файлоподобных элементов.
-
-Одиночный {@link FileLike} оборачивается в массив; из массива отбираются только
-файлоподобные элементы. Для прочих значений — `null` (валидатор пропускает).
-
-**Signature:**
-```typescript
-export function toFileArray(value: unknown): FileLike[] | null
-```
-
-**Parameters:**
-- `value` — - Значение поля (`FileLike`, `FileLike[]` или что-то ещё)
-
-**Returns:** Массив файлоподобных элементов или `null`
-
-_Source: src/form/validation/validators/file-utils.ts_
-
 ### transformValue
 
 **Kind:** `function`
@@ -7869,61 +6796,6 @@ transformValue(model.$.promoCode, (v) => (v ?? '').toUpperCase());
 
 _Source: src/state/behaviors-value.ts_
 
-### uniqueId
-
-**Kind:** `function`
-
-Генерирует уникальный идентификатор с указанным префиксом.
-
-**Signature:**
-```typescript
-export function uniqueId(prefix: SubscriptionKeyType): string
-```
-
-**Parameters:**
-- `prefix` — - Префикс для идентификатора (используйте {@link SubscriptionKey}).
-
-**Returns:** Уникальный идентификатор в формате `${prefix}-${counter}`.
-
-**Examples:**
-
-```typescript
-import { uniqueId, SubscriptionKey } from '@reformer/core';
-
-uniqueId(SubscriptionKey.WatchField); // → 'watchField-1'
-uniqueId(SubscriptionKey.WatchField); // → 'watchField-2'
-```
-
-_Source: src/form/unique-id.ts_
-
-### UnknownCallback
-
-**Kind:** `type`
-
-Тип для коллбэков и обработчиков событий
-Используется вместо (...args: any[]) => any
-
-**Signature:**
-```typescript
-export type UnknownCallback = (...args: unknown[]) => unknown;
-```
-
-_Source: src/form/types/index.ts_
-
-### UnknownFormValue
-
-**Kind:** `type`
-
-Type-safe alternative to 'any' for unknown form values
-Requires explicit type checking before use
-
-**Signature:**
-```typescript
-export type UnknownFormValue = unknown;
-```
-
-_Source: src/form/types/contracts.ts_
-
 ### UnknownRecord
 
 **Kind:** `type`
@@ -7974,50 +6846,6 @@ onDispose(() => unmarkDerived(model.$.total)); // при снятии compute с
 
 _Source: src/state/derived-registry.ts_
 
-### url
-
-**Kind:** `function`
-
-Фабрика валидатора URL.
-
-Пустые значения (`''`/`null`/`undefined`) пропускаются (используйте {@link required}
-для обязательности). При `requireProtocol` протокол обязателен; `allowedProtocols`
-дополнительно ограничивает набор допустимых протоколов.
-
-**Signature:**
-```typescript
-export function url<TForm = unknown, TField extends string | null | undefined = string>(
-  options?: UrlValidatorOptions
-): Validator<TForm, TField>
-```
-
-**Parameters:**
-- `options` — - Опции валидатора {@link UrlValidatorOptions}
-
-**Returns:** Чистый валидатор {@link Validator} для строкового поля
-
-**Examples:**
-
-Проверка URL
-```typescript
-import { required, url } from '@reformer/core/validators';
-
-// Внутри FieldConfig схемы формы:
-website: {
-value: model.$.website,
-component: Input,
-validators: [required(), url({ message: 'Введите корректный URL' })],
-},
-// Требовать протокол и ограничить схему только https:
-homepage: {
-value: model.$.homepage,
-component: Input,
-validators: [url({ requireProtocol: true, allowedProtocols: ['https'] })],
-},
-```
-
-_Source: src/form/validation/validators/url.ts_
-
 ### useArrayLength
 
 **Kind:** `function`
@@ -8166,7 +6994,7 @@ onChange={e => control.setValue(e.target.checked)}
 }
 
 // Использование
-control.setComponentProps({
+control.updateComponentProps({
 label: 'Accept terms and conditions',
 hint: 'Required to continue'
 });
@@ -8222,7 +7050,7 @@ control.push({ street: '', city: '' });
 };
 
 const handleRemove = (index: number) => {
-control.remove(index);
+control.removeAt(index);
 };
 
 return (
@@ -8471,23 +7299,80 @@ return (
 
 _Source: src/form/hooks/useFormControlValue.ts_
 
-### ValidateAsyncOptions
+### useFormValidation
+
+**Kind:** `function`
+
+Декларативный выбор стратегии валидации формы: одна точка вместо ручной разводки
+`validateModel`/`revalidateWhen`. Собирает стабильный {@link createFormValidation}-контроллер,
+армит реактивную стратегию на клиенте (`useEffect` → SSR-safe) и отдаёт `submit`/`isValidating`.
+
+Схема-валидации — **стабильная ссылка** (обязанность вызывающего): контроллер мемоизируется по
+`[model, schema, strategy, debounce, liveAfterSubmit]`.
+
+**Signature:**
+```typescript
+export function useFormValidation<T>(args: UseFormValidationArgs<T>): UseFormValidationResult
+```
+
+**Examples:**
+
+```tsx
+const validation = defineValidationSchema<Form>(({ model }) => { ... }); // module-level
+
+function MyForm() {
+  const { submit, isValidating } = useFormValidation({
+    model, schema: validation, strategy: 'afterFirstSubmit', debounce: 300,
+  });
+  const onSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    if (await submit()) await api.save(model.get());
+  };
+  return <form onSubmit={onSubmit}>{ ... }<button disabled={isValidating}>Отправить</button></form>;
+}
+```
+
+_Source: src/form/hooks/use-form-validation.ts_
+
+### UseFormValidationArgs
 
 **Kind:** `interface`
 
 **Signature:**
 ```typescript
-export interface ValidateAsyncOptions extends ValidateOptions {
-  /** Задержка перед выполнением валидации (в мс). */
+export interface UseFormValidationArgs<T> {
+  /** Модель данных формы. */
+  model: FormModel<T>;
+  /** Схема валидации. **Стабильная ссылка** (module-level `const` / `useMemo`) — иначе ломается дедуп раннера. */
+  schema: ValidationSchema<T>;
+  /** Стратегия запуска. Default `'submit'`. */
+  strategy?: ValidationStrategyKind;
+  /** Debounce (мс) для live-фаз (`change` / live-часть `afterFirstSubmit`). */
   debounce?: number;
+  /** Режим live-фазы для `afterFirstSubmit`. Default `'change'`. */
+  liveAfterSubmit?: 'change' | 'blur';
 }
 ```
 
-**Deprecated:** Осиротевший остаток удалённого оператора `validateAsync` (Ф7): опция `debounce`
-подключалась тем оператором, которого больше нет. Рантаймом не потребляется; экспортируется
-только ради обратной совместимости.
+_Source: src/form/hooks/use-form-validation.ts_
 
-_Source: src/form/types/validation-schema.ts_
+### UseFormValidationResult
+
+**Kind:** `interface`
+
+**Signature:**
+```typescript
+export interface UseFormValidationResult {
+  /** Полный прогон + раскрытие ошибок (`touch:true`); для `onSubmit`. Стабильная ссылка. */
+  submit: () => Promise<boolean>;
+  /** Алиас `submit` для не-submit сценариев. */
+  validate: () => Promise<boolean>;
+  /** Идёт ли прогон (submit или live) — для блокировки кнопки. */
+  isValidating: boolean;
+}
+```
+
+_Source: src/form/hooks/use-form-validation.ts_
 
 ### ValidateOptions
 
@@ -8591,33 +7476,3 @@ watchField(model.$.country, async (country) => {
 ```
 
 _Source: src/state/behaviors-value.ts_
-
-### WithBehaviorSchema
-
-**Kind:** `interface`
-
-Интерфейс для узлов с методом applyBehaviorSchema
-
-**Signature:**
-```typescript
-export interface WithBehaviorSchema {
-  applyBehaviorSchema(schemaFn: unknown): void;
-}
-```
-
-_Source: src/form/types/index.ts_
-
-### WithValidationSchema
-
-**Kind:** `interface`
-
-Интерфейс для узлов с методом applyValidationSchema
-
-**Signature:**
-```typescript
-export interface WithValidationSchema {
-  applyValidationSchema(schemaFn: unknown): void;
-}
-```
-
-_Source: src/form/types/index.ts_