@reformer/core 11.0.0-beta.4 → 11.0.0-beta.6

package/llms.txt

@@ -42,6 +42,8 @@
 
 ## 1. 1. API Reference
 
+**api-reference**
+
 ### Imports (CRITICALLY IMPORTANT)
 
 Архитектура M1: значения живут в **модели** (`createModel`), а форма (`createForm`) строит ноды поверх сигналов модели. Behaviors работают на сигналах (`model.$.field`), а не на строковых путях.
@@ -106,6 +108,8 @@ const { value, errors, disabled } = useFormControl(control.loanType);
 
 ## 2. 1.5 QUICK START - Minimal Working Form
 
+**quick-start**
+
 > **Schema-driven UI rule (read first)**: компонент И его пропсы (label, placeholder,
 > options, type) объявляются в **схеме поля** (`component` + `componentProps`).
 > В JSX рендерится один универсальный `<FormField control={form.x} />` из
@@ -219,14 +223,14 @@ const model = createModel<MyForm>({ properties: [] });
 const propertyItem = (item: FormModel<PropertyItem>) => ({
   type: {
     value: item.$.type,
-    component: Select,
+    component: SelectAsync,
     componentProps: { label: 'Тип', options: [/* ... */] },
   },
   description: { value: item.$.description, component: Textarea, componentProps: { label: 'Описание' } },
   estimatedValue: {
     value: item.$.estimatedValue,
-    component: Input,
-    componentProps: { label: 'Стоимость', type: 'number' },
+    component: InputNumber,
+    componentProps: { label: 'Стоимость' },
   },
 });
 
@@ -257,6 +261,8 @@ model.properties.length; // реактивная длина
 
 ## 3. 2. API SIGNATURES
 
+**api-signatures**
+
 ### Model & Form
 
 ```typescript
@@ -322,16 +328,16 @@ import { createModel, createForm } from '@reformer/core';
 import { defineValidationSchema, validate, validateModel } from '@reformer/core/validation';
 import { required, min, max, email } from '@reformer/core/validators';
 
-type Loan = { email: string; age: number; amount: number };
-const model = createModel<Loan>({ email: '', age: 0, amount: 0 });
+type Loan = { email: string; age: number | null; amount: number | null };
+const model = createModel<Loan>({ email: '', age: null, amount: null });
 
 // layout-схема createForm НЕ несёт validators — только привязка поля к сигналу + компонент
 const form = createForm({
   model,
   schema: {
     email:  { value: model.$.email,  component: Input },
-    age:    { value: model.$.age,    component: Input },
-    amount: { value: model.$.amount, component: Input },
+    age:    { value: model.$.age,    component: InputNumber },
+    amount: { value: model.$.amount, component: InputNumber },
   },
 });
 
@@ -531,6 +537,8 @@ revalidateWhen([model.$.dep], () => void validateModel(model, schema));
 
 ## 4. 3. COMMON PATTERNS
 
+**common-patterns**
+
 Все паттерны — на архитектуре M1: значения в модели (`model.$.field`), поведение (`defineFormBehavior`)
 на живых сигналах, валидация — отдельной ambient-схемой (`defineValidationSchema`, прогон по требованию
 через `validateModel`). Слои раздельны: layout НЕ несёт validators.
@@ -734,6 +742,8 @@ const schema = defineValidationSchema<MyForm>(({ model }) => {
 
 ## 5. 4. COMMON MISTAKES
 
+**common-mistakes**
+
 ### Imports rule (#1 cause of cascading errors — read first)
 
 - Модель/форма/хуки/типы (`FormModel`, `ValidationError`)/**примитивы behaviors** — из `@reformer/core`.
@@ -902,6 +912,8 @@ if (isFieldNode(node)) { ... }
 
 ## 6. 5. TROUBLESHOOTING
 
+**troubleshooting**
+
 | Error                                                  | Cause                                                    | Solution                                          |
 | ------------------------------------------------------ | -------------------------------------------------------- | ------------------------------------------------- |
 | `'string' is not assignable to '{ message?: string }'` | Валидатору передали строку вместо options                | Используй `required({ message: 'text' })`         |
@@ -914,6 +926,8 @@ if (isFieldNode(node)) { ... }
 
 ## 7. Import Patterns
 
+**complete-import**
+
 ```typescript
 // Модель, форма, хуки, типы, примитивы behaviors — из @reformer/core
 import {
@@ -1014,6 +1028,8 @@ export type CoBorrower = {
 
 ## 8. 7. FORM TYPE DEFINITION
 
+**form-types**
+
 Form-shape объявляй через `type`-alias (не `interface` — см. `30-type-safety-recipes.md`).
 Тип описывает форму ДАННЫХ (то, что кладётся в `createModel`), без узлов/сигналов.
 
@@ -1062,6 +1078,8 @@ const model = createModel<MyForm>({
 
 ## 9. 8. SCHEMA FORMAT (CRITICALLY IMPORTANT)
 
+**formschema**
+
 Под M1 схема **привязывает поле к сигналу модели** (`value: model.$.field`) и держит
 UI-конфиг (`component`/`componentProps`). Значения принадлежат модели. Валидаторов в
 layout-схеме НЕТ — правила живут в отдельной схеме `defineValidationSchema` из
@@ -1090,7 +1108,7 @@ layout-схеме НЕТ — правила живут в отдельной с
 import { createModel, createForm } from '@reformer/core';
 import { defineValidationSchema, validate } from '@reformer/core/validation';
 import { required } from '@reformer/core/validators';
-import { Input, Select, Checkbox } from '@reformer/ui-kit';
+import { Input, InputNumber, SelectAsync, CheckboxWithLabel } from '@reformer/ui-kit';
 
 const model = createModel<MyForm>({ name: '', age: null, agree: false, status: 'active' });
 
@@ -1107,17 +1125,17 @@ const schema = {
   },
   age: {
     value: model.$.age,
-    component: Input,
-    componentProps: { type: 'number', label: 'Age' },
+    component: InputNumber,
+    componentProps: { label: 'Age' },
   },
   agree: {
     value: model.$.agree,
-    component: Checkbox,
+    component: CheckboxWithLabel,
     componentProps: { label: 'I agree to terms' },
   },
   status: {
     value: model.$.status,
-    component: Select,
+    component: SelectAsync,
     componentProps: {
       label: 'Status',
       options: [
@@ -1206,6 +1224,8 @@ if (isFieldNode(node)) { /* ... */ }
 
 ## 10. 9. ARRAY SCHEMA FORMAT
 
+**arrays**
+
 Массивы объектов — **model-owned**: данные принадлежат модели (`model.arrayField` — это
 `ModelArray<Item>` с реактивными `push`/`removeAt`/`length`). В схеме массив объявляется узлом
 `{ array: model.<path>, item: (itemModel) => subSchema }`, где `item` строит под-схему одного
@@ -1213,7 +1233,7 @@ if (isFieldNode(node)) { /* ... */ }
 
 ```typescript
 import { createModel, createForm, type FormModel } from '@reformer/core';
-import { Input } from '@reformer/ui-kit';
+import { Input, InputNumber } from '@reformer/ui-kit';
 
 type Item = { id: string; name: string; price: number };
 type MyForm = { items: Item[] };
@@ -1224,7 +1244,7 @@ const model = createModel<MyForm>({ items: [] });
 const itemSchema = (item: FormModel<Item>) => ({
   id:    { value: item.$.id,    component: Input },
   name:  { value: item.$.name,  component: Input },
-  price: { value: item.$.price, component: Input, componentProps: { type: 'number' } },
+  price: { value: item.$.price, component: InputNumber },
 });
 
 const schema = {
@@ -1368,6 +1388,8 @@ cross(model.$.hasItems, (f: MyForm) => {
 
 ## 12. 10. ASYNC REACTION — onChange (CRITICALLY IMPORTANT)
 
+**async-watchfield**
+
 Для async-реакции на изменение поля (загрузка зависимых опций, справочников) используй
 `onChange` из `@reformer/core/behaviors`. Колбэк выполняется ВНЕ effect-контекста (можно
 безопасно писать сигналы/ноды), а 2-й аргумент — `{ signal }` (AbortSignal): при следующей
@@ -1422,6 +1444,8 @@ const stop = watchField(model.$.country, (country) => {
 
 ## 13. 11. ARRAY CLEANUP PATTERN
 
+**array-cleanup**
+
 Очистка массива при выключении флага — через `onChange` на сигнале флага + `clear()` на
 модели-массиве. Колбит выполняется вне effect-контекста, поэтому мутировать массив безопасно.
 
@@ -1454,6 +1478,8 @@ clearWhenOff(model.$.hasProperty, model.properties);
 
 ## 14. 12. MULTI-STEP FORM VALIDATION
 
+**multi-step**
+
 Каждый шаг — своя `ValidationSchema<Form>` (обычная функция `({ model }) => void`, обёрнутая
 `defineValidationSchema`). Переход к следующему шагу проверяется `validateModel(model, stepSchema)`;
 полный submit — по общей схеме (композиция шагов через `apply(...)`). `validateModel` сам разносит
@@ -1546,6 +1572,8 @@ function MultiStepForm() {
 
 ## 15. 13. EXTENDED COMMON MISTAKES
 
+**extended-mistakes**
+
 ### Reuse via apply / applyEach — не дублируй код
 
 ```typescript
@@ -1645,13 +1673,17 @@ revalidateWhen([model.$.field2], () => void validateModel(model, schema));
 
 ## 16. 14. PROJECT STRUCTURE (COLOCATION)
 
+**project-structure**
+
 One form is one module folder. **Default layout — flat minimalist:** every concern is a single
 file at the module root, and the whole form (entry + all wizard steps inline) lives in one
-`index.tsx`. Filenames are flat with no prefix — **the dot-prefix (`form.` / `renderer.`) is
-carried only by `schema` and `behavior`**, the two concerns that have both a model-layer and a
-render-layer version (`form.schema.ts` / `form.behavior.ts` here; renderer slices add
-`renderer.schema.*` / `renderer.behavior.ts`). No `lib/` / `schema/` / `components/steps/`
-nesting until the form grows (see "Scaling up" below). Arrays are declared in `form.schema.ts`
+`index.tsx`. Naming rule: **`form.<role>` is a form artefact, the suffix names its role** —
+`form.schema.*` (layout), `form.behavior.ts` (model behavior), `form.render.ts` (render-layer
+behavior, renderer targets only), `form.validation.ts` (validation rules); every other file has
+no prefix. A wizard may instead keep each
+step's code in `steps/<slug>/` (same file names inside) with a `steps/index.ts` aggregator. The old
+`renderer.schema.*` / `renderer.behavior.ts` / `renderer.wizard.tsx` / `validation.ts` names still
+work with a warning. No `lib/` / `schema/` / `components/` nesting until the form grows (see "Scaling up" below). Arrays are declared in `form.schema.ts`
 and rendered with `FormArraySection` — no per-step component files.
 
 ```
@@ -1665,13 +1697,13 @@ src/
 │       ├── model.ts              # createModel + initial values + empty-array-element factories
 │       ├── form.schema.ts        # FormSchema: { value: model.$.x, component, componentProps }
 │       ├── form.behavior.ts      # defineFormBehavior: compute / enableWhen / hideWhen / copyFrom / onChange
-│       ├── validation.ts         # ALL validation → { validateStep, validateAll }
+│       ├── form.validation.ts    # ALL validation → { validateStep, validateAll }
 │       ├── data-sources.ts       # options + async loaders (dataSources)
 │       └── api.ts                # submit + prefill/load
 ```
 
 Rule of thumb: **one concern → one file at the module root; the whole component tree (all steps) →
-`index.tsx`; validation is a single `validation.ts`.** This is the working default for
+`index.tsx`; validation is a single `form.validation.ts`.** This is the working default for
 almost every form — reach for folders only when a file stops fitting on a screen.
 
 ### Key Files
@@ -1692,7 +1724,7 @@ export const createCreditApplicationModel = (): FormModel<CreditApplicationForm>
 // forms/credit-application/form.schema.ts
 import type { FormModel } from '@reformer/core';
 export const creditApplicationSchema = (model: FormModel<CreditApplicationForm>) => ({
-  loanType: { value: model.$.loanType, component: Select, componentProps: { /* ... */ } },
+  loanType: { value: model.$.loanType, component: SelectAsync, componentProps: { /* ... */ } },
   personalData: personalDataNodes(model.$.personalData),
   properties: { array: model.properties, item: propertyItem },
 });
@@ -1739,9 +1771,9 @@ forms/
     │
     ├── schema/                   # The form definition
     │   ├── model.ts             # createModel factory + initial values + array-element factories
-    │   ├── schema.ts            # schema builder (model) => tree ({ value: model.$.x, component })
-    │   ├── validation.ts        # defineValidationSchema + validateModel config ({ validateStep, validateAll })
-    │   ├── behavior.ts          # defineFormBehavior(...)
+    │   ├── form.schema.ts       # schema builder (model) => tree ({ value: model.$.x, component })
+    │   ├── form.validation.ts   # defineValidationSchema + validateModel config ({ validateStep, validateAll })
+    │   ├── form.behavior.ts     # defineFormBehavior(...)
     │   └── create-form.ts       # Assembly: createCoreForm({ model, schema, behavior, validation })
     │
     └── components/
@@ -1752,7 +1784,7 @@ forms/
 
 Rule of thumb for this layout: **domain raw material → `lib/`; anything describing the form →
 `schema/`; React layout → `components/`; root = entry + `index.ts`.** In very large forms you
-may co-locate each step's `schema.ts` / `validation.ts` / `behavior.ts` inside its
+may co-locate each step's `form.schema.ts` / `form.validation.ts` / `form.behavior.ts` inside its
 `steps/[Step]/` folder, keeping only the shared `model` and cross-step rules in `schema/` — see
 the guide below.
 
@@ -1768,21 +1800,25 @@ the guide below.
 > when registering the MCP server to choose which structure the generators lead with. Default
 > is `minimalist`.
 
-> Cross-target variants (renderer-react `renderer.schema.ts` + `renderer.behavior.ts` /
-> renderer-json `renderer.schema.json` + `renderer.behavior.ts` + `registry.ts`), the
-> centralized-vs-co-located choice, and the full reuse map live in the
-> **form-directory-layout** guide (`@reformer/mcp`).
+> Cross-target variants (renderer-react `form.schema.ts` + `form.render.ts` /
+> renderer-json `form.schema.ts` + `form.render.ts` + `registry.ts`, plus an optional
+> `wizard.tsx` shim), the `.tsx` / `.json` schema variants, the centralized-vs-co-located
+> choice, and the full reuse map live in the **form-directory-layout** guide (`@reformer/mcp`) —
+> `find_recipe directory-layout`.
 
 ## 17. 14.5 UI COMPONENT PATTERNS
 
+**ui-components**
+
 > **Default rule (read first)**: для UI используй `FormField` из
 > [`@reformer/ui-kit`](../../reformer-ui-kit/) — он покрывает 95% случаев одной
-> строкой `<FormField control={form.x} />`. Свои field-обёртки пиши ТОЛЬКО если
+> строкой `<FormField control={form.x} />`. Свои обёртки поля пиши ТОЛЬКО если
 > ui-kit не подходит (другая design system, особый low-level input).
 >
 > Канонический schema-driven подход:
 >
-> - **компонент** объявляется в схеме как `component: Input` (или `Select`, `Checkbox`, etc.)
+> - **компонент** объявляется в схеме как `component: Input` (или `SelectAsync`, `CheckboxWithLabel`, …) —
+>   сам компонент кита, отдельных «field-версий» нет: связывает его с полем обёртка (`FormField`)
 > - **пропсы** компонента — в `componentProps: { label, placeholder, options, type, ... }`
 > - **JSX рендерит**: `<FormField control={form.x} />` БЕЗ дополнительных props
 >
@@ -1794,7 +1830,7 @@ the guide below.
 ```tsx
 import { useMemo } from 'react';
 import { createModel, createForm } from '@reformer/core';
-import { FormField, Input, Select, Checkbox, Button } from '@reformer/ui-kit';
+import { FormField, Input, SelectAsync, CheckboxWithLabel, Button } from '@reformer/ui-kit';
 
 type RegistrationForm = {
   email: string;
@@ -1813,7 +1849,7 @@ function RegistrationPage() {
       },
       country: {
         value: model.$.country,
-        component: Select,
+        component: SelectAsync,
         componentProps: {
           label: 'Country',
           options: [
@@ -1824,7 +1860,7 @@ function RegistrationPage() {
       },
       agree: {
         value: model.$.agree,
-        component: Checkbox,
+        component: CheckboxWithLabel,
         componentProps: { label: 'I agree to terms' },
       },
     };
@@ -1888,7 +1924,8 @@ import { InputMask } from 'react-input-mask';
 ```
 
 `children` оборачивается в `CdkFormField.Control asChild` и получает все нужные
-props (`value`, `onChange`, `onBlur`, `aria-invalid`).
+props (`value`, `onChange`, `onBlur`, `aria-invalid`) — в диалекте ребёнка, если тот объявил
+статику `reformerAdapter` (`defineFieldControl` из `@reformer/ui-kit/fields`), иначе value-based.
 
 ### Advanced — write your own from scratch (rare)
 
@@ -1930,12 +1967,37 @@ function MyFormField<T>({ control }: MyFormFieldProps<T>) {
 <MyFormField control={form.email} /> // ← без label-prop
 ```
 
+### Связывание поля с контролом — `FieldAdapter` (`@reformer/core`)
+
+Контролы говорят на разных диалектах (`checked` + `onCheckedChange`, `onValueChange`, DOM-событие
+в `onChange`), форма — на value-based seam (`value` + `onChange(value)` + `onBlur`). Перевод
+описывает `FieldAdapter` (`valueProp`, `changeProp`, `fromEmit`, `toValue`, `bindBlur`, `strip`,
+`passControl` — все необязательны). Компонент объявляет его статикой `reformerAdapter`, а обёртка
+поля (`FormField.Control` из `@reformer/cdk`, рендерер `@reformer/renderer-react`) читает статику
+и связывает поле сама — отдельные «field-версии» компонентов не нужны.
+
+| Символ                        | Назначение                                                                  |
+| ----------------------------- | --------------------------------------------------------------------------- |
+| `FieldAdapter`                | Тип адаптера: диалект контрола                                              |
+| `getFieldAdapter(component)`  | Статика `component.reformerAdapter` либо `undefined`                        |
+| `bindFieldProps(adapter, seam, props)` | Props контрола под адаптер (без адаптера — seam как есть)          |
+| `FieldHandle`                 | Императивный handle поля: `focus` / `blur` / `scrollIntoView` / `getElement` |
+| `makeElementFieldHandle(ref)` | Базовый `FieldHandle` из DOM-узла                                           |
+| `useFieldHandleRef(outerRef)` | Ref для контрола + публикация handle потребителю (строит ОБЁРТКА поля)     |
+
+В приложении обычно достаточно `defineFieldControl(MyControl, { adapter })` из
+`@reformer/ui-kit/fields` (плюс готовые пресеты `checkedAdapter`, `valueChangeAdapter`, …); для
+компонентов чужой библиотеки без статики — `RendererSettings.resolveFieldAdapter`.
+
 ### Integration with UI libraries (shadcn etc.)
 
 > **Через рендерер — без обёртки.** Если ты рендеришь форму через `@reformer/renderer-react` /
 > `@reformer/renderer-json`, вместо ручной обёртки на каждый контрол можно зарегистрировать сырой
 > компонент и передать `settings.resolveFieldAdapter` — рендерер сам сведёт value-seam к диалекту
-> контрола. Ручная обёртка на `useFormControl` (ниже) нужна для прямого JSX без рендерера.
+> контрола. Свой компонент можно подготовить и один раз — статикой
+> `defineFieldControl(MyInput, { adapter })` из `@reformer/ui-kit/fields`: его поймут и рендерер,
+> и `FormField.Control` из `@reformer/cdk`. Ручная обёртка на `useFormControl` (ниже) нужна для
+> прямого JSX без `FormField` и рендерера.
 
 Если есть существующая design system — оборачивай её компоненты в один
 `MyFormField` (как выше) и используй один прop `control`. Не множь обёртки на
@@ -1965,6 +2027,8 @@ function ShadcnFormField({ control }: { control: FieldNode<string> }) {
 
 ## 18. 15. NON-EXISTENT API (DO NOT USE)
 
+**nonexistent-api**
+
 **Следующего API НЕТ в @reformer/core** (наследие старой path-based архитектуры,
 удалено при переходе на M1 и при разделении валидации/поведения):
 
@@ -1991,6 +2055,20 @@ function ShadcnFormField({ control }: { control: FieldNode<string> }) {
 | `FormProvider`, `control` prop, `register()` | `<Component form={form} />`, `useFormControl(form.field)` | Форма передаётся через props |
 | `getFieldValue()`                | `model.field` / `useFormControlValue(form.field)`| Не существует                                   |
 
+### UI: удалённые field-версии компонентов (`@reformer/ui-kit`)
+
+Отдельных «field-версий» у компонентов кита больше нет: в `component` поля кладётся сам
+компонент, диалект он объявляет статикой `reformerAdapter`, связывает поле обёртка
+(`FormField.Control` / рендерер).
+
+| Wrong                                          | Correct                                                   |
+| ---------------------------------------------- | --------------------------------------------------------- |
+| `InputField`, `SelectField`, `CheckboxField`, … (любой `*Field`) | `Input`, `SelectAsync`, `CheckboxWithLabel`, … — таблица в ui-kit `01-overview.md` |
+| `InputField` + `type: 'number'`                | `InputNumber`                                             |
+| `InputField` + `suggestions`                   | `InputSuggest`                                            |
+| `FileUploadField` + `variant: 'dropzone' \| 'input'` | `FileUploadDropzone` / `FileUploadInput` (без `variant`) |
+| `withFormControl(MyControl, adapter)`          | `defineFieldControl(MyControl, { adapter })` из `@reformer/ui-kit/fields` |
+
 ### Common Import Errors
 
 ```typescript
@@ -2059,6 +2137,8 @@ revalidateWhen([model.$.password], () => void validateModel(model, validation));
 
 ## 19. Purpose
 
+**Условные поля — видимость, доступность и валидация**
+
 «Показать поле X только если Y» под M1 решается тремя независимыми механизмами — выбирай по
 тому, что именно должно быть условным:
 
@@ -2241,6 +2321,8 @@ function MortgageFields({ form }: { form: CreditForm }) {
 
 ## 25. 16. READING FIELD VALUES (CRITICALLY IMPORTANT)
 
+**reading-values**
+
 Под M1 значения живут в модели. Есть три контекста чтения: value-доступ модели, сигналы, и React-хуки.
 
 ### В React-компоненте — хуки
@@ -2330,6 +2412,8 @@ const behavior = defineFormBehavior<MyForm>(({ model, form }) => {
 
 ## 26. 17. COMPUTE vs ONCHANGE
 
+**compute-vs-watch**
+
 Под M1 behaviors работают на сигналах модели. Есть два способа их писать:
 
 - **примитивы из `@reformer/core`** — принимают сигналы, возвращают cleanup, вызываются
@@ -2478,6 +2562,8 @@ watchField(model.$, (all) => autosave(all));           // любое поле ф
 
 ## 27. 18. ARRAY OPERATIONS
 
+**array-operations**
+
 Массивы объектов — model-owned. Мутации делаются через `ModelArray` (`model.arrayField`);
 рендер — через ноду формы (`form.items.map` / `.at`).
 
@@ -2592,6 +2678,8 @@ cross(model.$.totalPercent, percentagesSumTo100); // носитель — ска
 
 ## 28. Как устроено под M1
 
+**Cycle Detection — предотвращение «Cycle detected»**
+
 Behaviors на сигналах уже защищены от типичных циклов:
 
 - `compute`/`computeFrom` пишут в цель только если значение изменилось (**peek-guard**), а цель
@@ -2677,6 +2765,8 @@ enableWhen([model.$.propertyValue, model.$.initialPayment], () => model.loanType
 
 ## 32. Purpose
 
+**copyFrom — Копирование значений между полями**
+
 `copyFrom` декларативно копирует значение одного поля (или группы) в другое при выполнении
 условия `when`. Используется для UX-сценариев «совпадает с …»: «адрес проживания = адрес
 регистрации», «email для уведомлений = основной email», «billing = shipping». Оператор сам
@@ -2817,6 +2907,8 @@ A: `copyFrom` при `when === false` просто не пишет (не сбр
 
 ## 38. Purpose
 
+**syncFields — Двусторонняя синхронизация полей**
+
 `syncFields` создаёт двунаправленную связь между двумя полями: изменение любого из них
 переписывает второе. Применяется для дублей одного значения в разных частях формы
 (тех. поле + видимое представление, mirror-поля). Внутренний флаг + `runOutsideEffect`
@@ -2930,6 +3022,8 @@ A: У `syncFields` нет `when`. Эмулируй через два `copyFrom(a
 
 ## 44. Purpose
 
+**resetWhen — Условный сброс полей**
+
 `resetWhen` сбрасывает значение поля к `resetValue`, когда `condition` истинно. Это
 альтернатива `enableWhen({ resetOnDisable: true })`, когда поле остаётся **enabled**, но
 содержимое нужно очистить (например, переключение способа оплаты обнуляет «номер карты», но
@@ -3044,6 +3138,8 @@ A: `resetWhen` рассчитан на скалярные сигналы. Для
 
 ## 50. Purpose
 
+**transformValue — Автоматическая трансформация значений**
+
 `transformValue` подписывается на изменение поля и переписывает его трансформированной
 версией: uppercase для кодов, trim+toLowerCase для email, округление для чисел. Применяется
 единообразно ко всем источникам изменения (пользователь, `model.field = …`, `model.set/patch`,
@@ -3179,6 +3275,8 @@ A: Симптом частых записей. Форматирование с
 
 ## 56. Purpose
 
+**revalidateWhen — Перевалидация по триггерам**
+
 `revalidateWhen` вызывает переданный колбэк ревалидации, когда изменяется любая из
 зависимостей. Применяется, когда правило зависит от значений других полей
 (`amount <= maxAmount`, `confirmPassword === password`, `initialPayment >= propertyValue * 0.2`).
@@ -3310,6 +3408,8 @@ A: Схема — обычная функция, поэтому опиши ст
 
 ## 62. Purpose
 
+**Submit и Reset — Жизненный цикл отправки формы**
+
 Канонический submit-флоу под M1: «запустить полную валидацию данных (`validateModel`) →
 проверить `boolean`-результат → достать снимок (`model.get()`) → сделать запрос → `model.reset()`».
 Валидация — **отдельный слой** (`@reformer/core/validation`, схема через `defineValidationSchema`), она
@@ -3568,6 +3668,8 @@ A: `model.get()` возвращает значения всех полей. Фи
 
 ## 68. Purpose
 
+**Async Preload — Загрузка начальных значений и справочников**
+
 Загрузка формы данными с сервера под M1: (1) **initial values** в `createModel(...)`; (2)
 **`model.set` / `model.patch`** для загрузки/обновления значений; (3) **external React-hook**
 для full-blown async preload (параллельный fetch заявки + справочников, обработка ошибок,
@@ -3597,7 +3699,7 @@ Initial values задаются в `createModel(initial)`; `reset()` возвр
 
 ```typescript
 import { createModel, createForm } from '@reformer/core';
-import { Input, Select } from '@reformer/ui-kit';
+import { Input, SelectAsync, CheckboxWithLabel } from '@reformer/ui-kit';
 
 type ProfileForm = { username: string; language: 'ru' | 'en'; marketing: boolean };
 
@@ -3606,7 +3708,7 @@ const schema = {
   username: { value: model.$.username, component: Input, componentProps: { label: 'Username' } },
   language: {
     value: model.$.language,
-    component: Select,
+    component: SelectAsync,
     componentProps: {
       label: 'Язык',
       options: [
@@ -3615,7 +3717,7 @@ const schema = {
       ],
     },
   },
-  marketing: { value: model.$.marketing, component: Input, componentProps: { type: 'checkbox' } },
+  marketing: { value: model.$.marketing, component: CheckboxWithLabel, componentProps: { label: 'Рассылка' } },
 };
 const form = createForm({ model, schema });
 // model.get() === { username: '', language: 'ru', marketing: true }
@@ -3760,6 +3862,8 @@ A: `reset()` возвращает к initial-снимку из `createModel`, н
 
 ## 74. 30. TYPE-SAFETY RECIPES
 
+**type-safety-recipes**
+
 Идиоматичные паттерны, которые держат сгенерированный код без `any` и `as`-кастов под M1.
 
 ### Recipe 1 — Imports (root cause prevention)
@@ -3819,7 +3923,7 @@ Layout-схема БЕЗ валидаторов — правила живут в
 const model = createModel<CreditApplicationForm>(initial);
 
 const schema = {
-  loanAmount: { value: model.$.loanAmount, component: Input },
+  loanAmount: { value: model.$.loanAmount, component: InputNumber },
   // вложенная группа — builder, принимающий ModelSignals<Sub>
   personalData: personalDataNodes(model.$.personalData),
   // массив — { array, item }
@@ -3920,6 +4024,8 @@ validate(model.$.birthDate, [validateAdultAge]);
 
 ## 75. 31. ASYNC VALIDATOR
 
+**async-validator-debounce**
+
 Для проверок типа «уникальность email», «валидация ИНН через API», «проверка адреса» —
 async-правило это `AsyncRule<T>` = `(value, { signal }) => Promise<ValidationError | null>`.
 Оно регистрируется оператором `validateAsync(sig, [asyncRules])` внутри схемы валидации
@@ -4056,6 +4162,8 @@ return checking ? <Spinner /> : errors.length ? <Error errors={errors} /> : null
 
 ## 76. 32. ASYNC OPTIONS LOADING
 
+**async-options-loading**
+
 Для динамической подгрузки опций dropdown'а по значению другого поля (`region` → `city options`,
 `carBrand` → `carModel options`) — используй `onChange` из `@reformer/core/behaviors` +
 `form.field.updateComponentProps({ options })`. `onChange` даёт debounce и AbortSignal из коробки.
@@ -4165,6 +4273,8 @@ loadOptionsOn(model.$.carBrand, form.carModel, fetchCarModels, { resetTarget: tr
 
 ## 77. Purpose
 
+**useFormValidation — Единый выбор стратегии валидации**
+
 Одна декларативная точка выбора «когда прогонять схему валидации» вместо ручной разводки
 `markAsTouched` + `validateModel` + `revalidateWhen` + `useState(pending)`. Аддитивный слой над
 функциональной схемой (`@reformer/core/validation`): переиспользует `validateModel` как
@@ -4359,6 +4469,34 @@ if (typeof window !== 'undefined') ctrl.start();
 
 _Auto-generated from JSDoc on public exports._
 
+### aggregateInto
+
+**Kind:** `function`
+
+Агрегатная запись в строки массива. `derive(snapshot)` получает СНИМОК строк и возвращает список
+`{ index, patch }`, который применяется к строкам. Записи КОАЛЕСИРУЮТСЯ в один отложенный проход на
+финальном состоянии — поэтому массовые синхронные мутации (push в цикле) не вызывают каскад на
+промежуточных состояниях. `derive` должна сходиться (на фикспоинте возвращать те же значения).
+
+**Signature:**
+```typescript
+export function aggregateInto<TItem>(
+  array: object,
+  derive: (rows: TItem[]) => Array<{ index: number; patch: Partial<TItem> }>
+): void
+```
+
+**Examples:**
+
+// последняя строка = 100 − Σ(остальные)
+aggregateInto(model.$.rows, (rows) => {
+  const n = rows.length; if (n === 0) return [];
+  const others = rows.slice(0, n - 1).reduce((s, r) => s + r.percent, 0);
+  return [{ index: n - 1, patch: { percent: 100 - others } }];
+});
+
+_Source: src/form/behaviors/collections.ts_
+
 ### AnyFunction
 
 **Kind:** `type`
@@ -4373,6 +4511,47 @@ export type AnyFunction = (...args: never[]) => unknown;
 
 _Source: src/form/types/index.ts_
 
+### apply
+
+**Kind:** `function`
+
+Композиция под-схем в текущую (над той же моделью scope). Заменяет пошаговую группировку.
+
+**Signature:**
+```typescript
+export function apply<T>(...schemas: ValidationSchema<T>[]): void
+```
+
+_Source: src/form/validation/operators.ts_
+
+### applyEach
+
+**Kind:** `function`
+
+Применить под-схему к КАЖДОМУ элементу динамического массива (per-item поведение).
+Реагирует на добавление/удаление строк: новым строкам поведение применяется, удалённым — отписывается.
+
+Под-схема получает scope строки: `model` (под-модель строки — `row.$.field`) и `form` (нода строки).
+- Value-операции (`compute`/`copyFrom`/`transformValue` на `row.$.*`) работают всегда.
+- Node-операции (`enableWhen`/`updateComponentProps`/`reset` через `form.*`) требуют, чтобы массив был
+  МАТЕРИАЛИЗОВАН в форме (узел `{ array, item }` в схеме) — тогда `form` строки = та же нода, что
+  рендерится, а её сигналы зарегистрированы (`enableWhen` резолвит ноду). Без материализации доступ
+  к `form.*` бросит понятную ошибку (см. {@link unmaterializedRowForm}).
+
+**Signature:**
+```typescript
+export function applyEach<TItem>(array: object, itemSchema: FormBehavior<TItem>): void
+```
+
+**Examples:**
+
+applyEach(model.$.items, defineFormBehavior<Item>(({ model: row, form }) => {
+  compute(row.$.lineTotal, () => row.qty * row.price);    // value-op — всегда
+  enableWhen(row.$.discount, () => row.qty > 10);          // node-op — нужна материализация массива
+}));
+
+_Source: src/form/behaviors/collections.ts_
+
 ### ArrayControlState
 
 **Kind:** `interface`
@@ -4585,6 +4764,23 @@ export interface ArrayNodeLike {
 
 _Source: src/form/types/index.ts_
 
+### AsyncRule
+
+**Kind:** `type`
+
+Асинхронное правило поля. Получает `AbortSignal` для отмены устаревших ответов (быстрый повторный
+прогон той же схемы отменяет предыдущий). Сетевой сбой не должен блокировать — ловите и возвращайте `null`.
+
+**Signature:**
+```typescript
+export type AsyncRule<TField> = (
+  value: TField,
+  ctx: { signal: AbortSignal }
+) => Promise<ValidationError | null>;
+```
+
+_Source: src/form/validation/types.ts_
+
 ### AsyncValidatorFn
 
 **Kind:** `type`
@@ -4657,6 +4853,48 @@ export type BehaviorCleanup = () => void;
 
 _Source: src/model/behaviors-value.ts_
 
+### BehaviorScope
+
+**Kind:** `type`
+
+Контекст схемы поведения: модель (значения/сигналы) + форма (ноды).
+
+**Signature:**
+```typescript
+export type BehaviorScope<T> = { model: FormModel<T>; form: FormProxy<T> };
+```
+
+_Source: src/form/behaviors/types.ts_
+
+### bindFieldProps
+
+**Kind:** `function`
+
+Props контрола под адаптер: срезает служебные ключи обёртки и `strip` адаптера, кладёт значение
+в `valueProp` (через `toValue`), вешает `changeProp`, который прогоняет эмит контрола через
+`fromEmit` в value-based `onChange` поля, и пробрасывает blur (`bindBlur` либо `onBlur`).
+Без адаптера seam проходит как есть (`value` / `onChange` / `onBlur`).
+
+`componentProps` спредятся ПЕРВЫМИ — seam их перекрывает при совпадении ключей.
+
+**Signature:**
+```typescript
+export function bindFieldProps(
+  adapter: FieldAdapter | undefined,
+  seam: FieldSeam,
+  componentProps: Record<string, unknown> = {}
+): Record<string, unknown>
+```
+
+**Parameters:**
+- `adapter` — - Адаптер контрола или `undefined` (value-based контрол).
+- `seam` — - Значение поля и его колбэки.
+- `componentProps` — - Прочие props контрола.
+
+**Returns:** Плоский объект props для спреда в контрол.
+
+_Source: src/platforms/react/field-binding/field-adapter.ts_
+
 ### buildValidation
 
 **Kind:** `function`
@@ -4694,6 +4932,38 @@ await v!.validateAll();     // все шаги + extras
 
 _Source: src/form/validation/config.ts_
 
+### ChangeContext
+
+**Kind:** `interface`
+
+Контекст async-реакции: `signal` аннулируется, когда поле меняется снова до завершения колбэка.
+
+**Signature:**
+```typescript
+export interface ChangeContext {
+  signal: AbortSignal;
+}
+```
+
+_Source: src/form/behaviors/types.ts_
+
+### compute
+
+**Kind:** `function`
+
+Вычисляемое поле с auto-tracking: `target = read()` при изменении прочитанных сигналов.
+
+**Signature:**
+```typescript
+export function compute<R>(
+  target: Signal<R>,
+  read: () => R,
+  options?: { when?: () => boolean }
+): void
+```
+
+_Source: src/form/behaviors/operators.ts_
+
 ### computeFrom
 
 **Kind:** `function`
@@ -4976,7 +5246,7 @@ _Source: src/form/create-core-form.ts_
 
 Значения принадлежат модели (источник истины), ноды формы держат UI/валидационное состояние и
 ссылаются на сигналы модели по идентичности (`node.value === model.$.path`). Обходит структуру
-модели, привязывает конфиг поля (component/componentProps/validators) из схемы, материализует
+модели, привязывает конфиг поля (component/componentProps) из схемы, материализует
 top-level массивы как {@link ModelArrayNode}, заполняет реестр сигнал→нода (для `enableWhen`/
 роутинга ошибок) и, при наличии, запускает декларативное поведение (cleanup живёт на форме).
 
@@ -5008,7 +5278,8 @@ const model = createModel<Form>({ email: '', profile: { name: '', age: 0 } });
 const schema = {
 component: Section,
 children: [
-{ value: model.$.email, component: Input, validators: [required] },
+// Layout несёт только component/componentProps; правила — в отдельной ValidationSchema.
+{ value: model.$.email, component: Input },
 // вложенная группа: `model.$.profile.name` (≡ под-модель `model.profile.$.name` — тот же сигнал)
 { value: model.$.profile.name, component: Input },
 ],
@@ -5031,7 +5302,7 @@ _Source: src/form/create-form.ts_
 **Kind:** `interface`
 
 Аргументы createForm под архитектуру M1: данные приходят из {@link FormModel},
-конфиг полей (component/componentProps/validators) — из единой схемы.
+конфиг полей (component/componentProps) — из единой схемы.
 
 **Signature:**
 ```typescript
@@ -5053,6 +5324,41 @@ export interface CreateFormFromModelArgs<T> {
 
 _Source: src/form/create-form.ts_
 
+### createFormValidation
+
+**Kind:** `function`
+
+Собрать контроллер валидации формы с выбранной стратегией запуска. Переиспользует
+{@link validateModel} как единственный движок прогона.
+
+Фабрика ЧИСТАЯ до `start()` (никаких подписок) — безопасна для SSR/headless. Реактивные триггеры
+арминуются только в `start()` (в React — из `useEffect`).
+
+**Signature:**
+```typescript
+export function createFormValidation<T>(
+  model: FormModel<T>,
+  schema: ValidationSchema<T>,
+  options: ValidationStrategyOptions = {}
+): FormValidationController
+```
+
+**Parameters:**
+- `model` — - Модель данных.
+- `schema` — - Схема валидации. **Стабильная ссылка** (иначе `validateModel` не отменит устаревший прогон).
+- `options` — - {@link ValidationStrategyOptions}.
+
+**Examples:**
+
+```ts
+const ctrl = createFormValidation(model, schema, { strategy: 'afterFirstSubmit', debounce: 300 });
+const dispose = ctrl.start();               // на клиенте
+const ok = await ctrl.validate();           // submit → раскрыть все ошибки
+dispose();
+```
+
+_Source: src/form/validation/strategy.ts_
+
 ### createModel
 
 **Kind:** `function`
@@ -5089,6 +5395,81 @@ model.get();                  // { email: 'a@b.c', profile: { name: 'Ada' }, tag
 
 _Source: src/model/create-model.ts_
 
+### cross
+
+**Kind:** `function`
+
+Cross-field правило: `fn` получает СНАПШОТ модели текущего scope (`model.get()`) и вешает ошибку на `sig`.
+Для элементов массива / под-моделей захватывайте нужный снапшот в замыкание (`const item = im.get()`),
+т.к. `fn` всегда получает модель ТЕКУЩЕГО scope (корень прогона), а не под-модель.
+
+**Signature:**
+```typescript
+export function cross<TSnapshot>(
+  sig: PathAwareSignal<unknown>,
+  fn: (form: TSnapshot) => ValidationError | null
+): void
+```
+
+_Source: src/form/validation/operators.ts_
+
+### defer
+
+**Kind:** `function`
+
+Отложенная запись вне effect-контекста (микротаск) — защита от «Cycle detected».
+
+**Signature:**
+```typescript
+export function defer(fn: () => void): void
+```
+
+_Source: src/form/behaviors/context.ts_
+
+### defineFormBehavior
+
+**Kind:** `function`
+
+Описать поведение формы декларативно. Возвращает {@link FormBehavior} для `createForm({ behavior })`.
+
+**Signature:**
+```typescript
+export function defineFormBehavior<T>(setup: (scope: BehaviorScope<T>) => void): FormBehavior<T>
+```
+
+**Examples:**
+
+```ts
+export const myBehavior = defineFormBehavior<MyForm>(({ model, form }) => {
+  compute(model.$.total, () => model.price * model.qty);
+  enableWhen([model.$.city], () => Boolean(model.country));
+  onChange(model.$.country, async (c) => form.city.updateComponentProps({ options: await load(c) }));
+});
+```
+
+_Source: src/form/behaviors/context.ts_
+
+### defineValidationSchema
+
+**Kind:** `function`
+
+Тонкая identity-обёртка для типизации/discoverability (как `defineFormBehavior`). Возвращает схему как есть.
+
+**Signature:**
+```typescript
+export function defineValidationSchema<T>(schema: ValidationSchema<T>): ValidationSchema<T>
+```
+
+**Examples:**
+
+```ts
+export const step1 = defineValidationSchema<LoanForm>(({ model }) => {
+  validate(model.$.loanAmount, [required(), min(50000)]);
+});
+```
+
+_Source: src/form/validation/run.ts_
+
 ### disableWhen
 
 **Kind:** `function`
@@ -5121,6 +5502,23 @@ disableWhen(model.$.discount, () => model.plan !== 'promo', { resetOnDisable: tr
 
 _Source: src/form/behaviors/node.ts_
 
+### each
+
+**Kind:** `function`
+
+Применить под-правила к КАЖДОМУ элементу текущего массива модели.
+`U extends object` — элементы должны быть под-моделями (объектами); для массива примитивов валидируйте лист напрямую.
+
+**Signature:**
+```typescript
+export function each<U extends object>(
+  arr: ModelArray<U>,
+  itemFn: (item: FormModel<U>) => void
+): void
+```
+
+_Source: src/form/validation/operators.ts_
+
 ### eachLeafSignal
 
 **Kind:** `function`
@@ -5142,6 +5540,55 @@ export function eachLeafSignal<T>(
 
 _Source: src/model/create-model.ts_
 
+### effect
+
+**Kind:** `function`
+
+Реактивный эффект (авто-dispose). Колбэк может вернуть собственный cleanup.
+
+**Signature:**
+```typescript
+export function effect(fn: () => void | (() => void)): void
+```
+
+_Source: src/form/behaviors/context.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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, email } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.email, [required(), email({ message: 'Введите корректный email' })]);
+});
+```
+
+_Source: src/form/validators/email.ts_
+
 ### enableWhen
 
 **Kind:** `function`
@@ -5244,20 +5691,119 @@ export enum ErrorStrategy {
 
 _Source: src/form/validation/error-handler.ts_
 
-### FieldConfig
+### exclusiveFlag
 
-**Kind:** `interface`
+**Kind:** `function`
 
-Конфигурация поля
+Взаимное исключение булева флага среди строк массива (single-selection — «единственный primary»).
+Когда флаг строки становится true, у остальных строк он сбрасывается в false. Не хрупок к push:
+новые строки с флагом false исключения не запускают.
 
 **Signature:**
 ```typescript
-export interface FieldConfig<T> {
-  /**
-   * Начальное значение-литерал (legacy-путь). Под архитектурой M1 значение приходит из
-   * {@link FieldConfig.valueSignal} (сигнал {@link FormModel}); тогда `value` не требуется.
-   */
-  value?: T | null;
+export function exclusiveFlag<TItem>(
+  array: object,
+  getFlag: (row: FormModel<TItem>) => Signal<boolean>
+): void
+```
+
+**Examples:**
+
+exclusiveFlag(model.$.contacts, (row) => row.$.primary);
+
+_Source: src/form/behaviors/collections.ts_
+
+### FIELD_WRAPPER_ONLY_PROPS
+
+**Kind:** `const`
+
+Props, которые адресованы обёртке поля, а не контролу: `labelTooltip` рисует `FormField` у
+подписи. Они приходят в общем мешке `componentProps`, и без среза утекли бы в DOM контрола.
+
+**Signature:**
+```typescript
+export const FIELD_WRAPPER_ONLY_PROPS: readonly string[]
+```
+
+_Source: src/platforms/react/field-binding/field-adapter.ts_
+
+### FieldAdapter
+
+**Kind:** `interface`
+
+Адаптер поля: описывает диалект контрола (`checked`/`onCheckedChange`, `value`/`onValueChange`,
+DOM-событие в `onChange`, …). Все ключи необязательны — по умолчанию seam проходит как есть.
+
+**Signature:**
+```typescript
+export interface FieldAdapter {
+  /** Проп, из которого контрол читает значение (по умолчанию `'value'`). */
+  valueProp?: string;
+  /** Колбэк, через который контрол эмитит изменение (по умолчанию `'onChange'`). */
+  changeProp?: string;
+  /**
+   * Эмит контрола → значение поля (по умолчанию — как есть). `rest` — прочие props контрола
+   * (например, чтобы достать `options` при резолве значения).
+   */
+  fromEmit?: (arg: unknown, rest: Record<string, unknown>) => unknown;
+  /** Значение поля → `valueProp` контрола (коэрсия `null`/`undefined`; по умолчанию — как есть). */
+  toValue?: (value: unknown) => unknown;
+  /** Проброс blur нестандартным каналом (по умолчанию — `onBlur`). */
+  bindBlur?: (onBlur: () => void) => Record<string, unknown>;
+  /** Ключи, которые убрать из `componentProps` перед спредом в контрол. */
+  strip?: string[];
+  /**
+   * Передавать ли контролу ноду формы пропом `control` (только рендерер). По умолчанию `false`:
+   * errors/touched обслуживает обёртка поля. Ставь `true`, если контрол сам вызывает
+   * `useFormControl(control)`.
+   */
+  passControl?: boolean;
+}
+```
+
+**Examples:**
+
+Radix Checkbox
+```ts
+const checkedAdapter: FieldAdapter = {
+valueProp: 'checked',
+changeProp: 'onCheckedChange',
+fromEmit: (c) => c === true,
+toValue: (v) => v ?? false,
+};
+```
+
+_Source: src/platforms/react/field-binding/field-adapter.ts_
+
+### FieldAdapterCarrier
+
+**Kind:** `interface`
+
+Компонент, объявивший свой диалект статикой.
+
+**Signature:**
+```typescript
+export interface FieldAdapterCarrier {
+  reformerAdapter?: FieldAdapter;
+}
+```
+
+_Source: src/platforms/react/field-binding/field-adapter.ts_
+
+### FieldConfig
+
+**Kind:** `interface`
+
+Конфигурация поля
+
+**Signature:**
+```typescript
+export interface FieldConfig<T> {
+  /**
+   * Начальное значение-литерал (legacy-путь). Под архитектурой M1 значение приходит из
+   * {@link FieldConfig.valueSignal} (сигнал {@link FormModel}); тогда `value` не требуется.
+   */
+  value?: T | null;
   /**
    * Сигнал значения из {@link FormModel} (M1). Если задан — служит источником истины значения
    * поля (нода не владеет значением, а ссылается на этот сигнал). Имеет приоритет над `value`.
@@ -5506,6 +6052,38 @@ onChange={e => control.setValue(e.target.value)}
 
 _Source: src/platforms/react/hooks/types.ts_
 
+### FieldHandle
+
+**Kind:** `interface`
+
+Базовый императивный контракт поля формы.
+
+Обёртка поля (`FormField.Control` из `@reformer/cdk`, рендерер `@reformer/renderer-react`)
+строит его из DOM-узла контрола. Композиты со своим handle (`open`/`close`/`reload`/…) отдают
+его как есть — он расширяет этот контракт.
+
+Достаётся из render-схемы по селектору:
+`schema.node(sel).getRef<FieldHandle>().current?.focus()`.
+
+Покрывает ТОЛЬКО императивные действия. Реактивное состояние (value / disabled / options /
+validation) живёт в behaviors и через handle не дублируется.
+
+**Signature:**
+```typescript
+export interface FieldHandle {
+  /** Сфокусировать поле (делегирует на DOM-элемент контрола). */
+  focus(): void;
+  /** Снять фокус. */
+  blur(): void;
+  /** Проскроллить поле в область видимости. */
+  scrollIntoView(opts?: ScrollIntoViewOptions): void;
+  /** Живой DOM-элемент поля (или `null` до монтирования / для размонтированной ноды). */
+  getElement(): HTMLElement | null;
+}
+```
+
+_Source: src/platforms/react/field-binding/field-handle.ts_
+
 ### FieldNode
 
 **Kind:** `class`
@@ -5522,6 +6100,7 @@ export class FieldNode<T> extends FormNode<T> {
 
 **Examples:**
 
+Пример node-level: конфиг УЗЛА, а не layout-схема M1 (в ней поля `validators` нет).
 ```typescript
 const field = new FieldNode({
   value: '',
@@ -5536,6 +6115,23 @@ console.log(field.valid.value); // true
 
 _Source: src/form/nodes/field-node.ts_
 
+### FieldSeam
+
+**Kind:** `interface`
+
+Seam поля: текущее значение и value-based колбэки.
+
+**Signature:**
+```typescript
+export interface FieldSeam {
+  value: unknown;
+  onChange: (value: unknown) => void;
+  onBlur: () => void;
+}
+```
+
+_Source: src/platforms/react/field-binding/field-adapter.ts_
+
 ### FieldStatus
 
 **Kind:** `type`
@@ -5549,6 +6145,69 @@ 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/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { fileType } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.documents, [fileType('image/*,.pdf', { message: 'Только изображения или PDF' })]);
+});
+```
+
+_Source: src/form/validators/file-type.ts_
+
 ### FormArrayProxy
 
 **Kind:** `type`
@@ -5603,6 +6262,22 @@ todos.forEach((item, i) => {
 
 _Source: src/form/types/form-proxy.ts_
 
+### FormBehavior
+
+**Kind:** `interface`
+
+Результат {@link defineFormBehavior}; передаётся в `createForm({ behavior })`.
+
+**Signature:**
+```typescript
+export interface FormBehavior<T> {
+  /** @internal Запускается `createForm` после построения нод и заполнения реестра сигнал→нода. */
+  __run(model: FormModel<T>, form: FormProxy<T>): BehaviorCleanup;
+}
+```
+
+_Source: src/form/behaviors/types.ts_
+
 ### FormBundleLike
 
 **Kind:** `interface`
@@ -6074,6 +6749,37 @@ export interface FormValidationBundle<T> {
 
 _Source: src/form/validation/config.ts_
 
+### FormValidationController
+
+**Kind:** `interface`
+
+**Signature:**
+```typescript
+export interface FormValidationController {
+  /**
+   * Полный прогон схемы с раскрытием ошибок (`touch: true`) — для submit. Также переводит
+   * `afterFirstSubmit` в live-фазу. Возвращает `false`, если есть блокирующие ошибки.
+   */
+  validate(): Promise<boolean>;
+  /**
+   * Армировать реактивные подписки стратегии. Идемпотентно. Возвращает `dispose`. НЕ звать при SSR.
+   *
+   * После {@link FormValidationController.dispose} контроллер армируется ЗАНОВО: React монтирует
+   * компоненты повторно (StrictMode в разработке, remount по роуту), и «одноразовый» контроллер
+   * после такого цикла молча оставался бы без живой валидации.
+   */
+  start(): () => void;
+  /** Снять подписки/таймеры. Идемпотентно; после него `start()` снова армирует стратегию. */
+  dispose(): void;
+  /** Идёт ли прогон (submit или live) — снапшот. */
+  readonly isValidating: boolean;
+  /** Реактивный сигнал состояния прогона (для тонкой подписки в UI). */
+  readonly validating: ReadonlySignal<boolean>;
+}
+```
+
+_Source: src/form/validation/strategy.ts_
+
 ### FormValue
 
 **Kind:** `type`
@@ -6097,6 +6803,63 @@ 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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, futureDate } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.appointmentDate, [required(), futureDate({ message: 'Дата записи должна быть в будущем' })]);
+});
+```
+
+_Source: src/form/validators/future-date.ts_
+
+### getFieldAdapter
+
+**Kind:** `function`
+
+Адаптер, объявленный компонентом статикой `reformerAdapter`, либо `undefined`.
+
+**Signature:**
+```typescript
+export function getFieldAdapter(component: unknown): FieldAdapter | undefined
+```
+
+**Examples:**
+
+```ts
+Checkbox.reformerAdapter = checkedAdapter;
+getFieldAdapter(Checkbox); // → checkedAdapter
+```
+
+_Source: src/platforms/react/field-binding/field-adapter.ts_
+
 ### getNodeForSignal
 
 **Kind:** `function`
@@ -6158,6 +6921,19 @@ console.log('Node type:', getNodeType(node)); // "FieldNode" | "GroupNode" | "Ar
 
 _Source: src/form/type-guards.ts_
 
+### getScope
+
+**Kind:** `function`
+
+Текущий scope ({ model, form }) активной схемы (escape hatch для кросс-операторов).
+
+**Signature:**
+```typescript
+export function getScope<T>(): BehaviorScope<T>
+```
+
+_Source: src/form/behaviors/context.ts_
+
 ### GroupNode
 
 **Kind:** `class`
@@ -6212,6 +6988,41 @@ 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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, integer } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.count, [required(), integer({ message: 'Должно быть целым числом' })]);
+});
+```
+
+_Source: src/form/validators/integer.ts_
+
 ### isArrayNode
 
 **Kind:** `function`
@@ -6243,6 +7054,43 @@ if (isArrayNode(node)) {
 
 _Source: src/form/type-guards.ts_
 
+### isDate
+
+**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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, isDate } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.eventDate, [required(), isDate({ message: 'Введите корректную дату' })]);
+});
+```
+
+_Source: src/form/validators/is-date.ts_
+
 ### isDerived
 
 **Kind:** `function`
@@ -6308,6 +7156,25 @@ if (isFieldNode(node)) {
 
 _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/validators/file-utils.ts_
+
 ### isFormNode
 
 **Kind:** `function`
@@ -6389,31 +7256,82 @@ const isLeaf = (v: unknown) => isSignalLike(v) && !isModelContainerSignal(v);
 
 _Source: src/model/model-signals-proxy.ts_
 
-### markDerived
+### isNumber
 
 **Kind:** `function`
 
-Пометить сигнал производным (вычисляемым).
-
-Вызывается операторами {@link computeFrom}/`compute` для их сигнала-цели. После этого
-bulk-сеттеры (`model.set`/`model.patch`, `patchValue`/`setValue`) пропускают это поле, чтобы
-значение из payload не затирало вычисляемое. Прикладной код напрямую обычно не вызывает.
+Фабрика валидатора, проверяющего что значение — конечное число (не NaN, не строка).
 
-Идемпотентна на уровне флага: повторные вызовы наращивают счётчик ссылок, чтобы каждый оператор,
-пишущий в этот сигнал, был сбалансирован своим {@link unmarkDerived} при dispose.
+Пустые значения (`null`/`undefined`) пропускаются (используйте {@link required} для
+обязательности). В отличие от других number-валидаторов, **не** пропускает не-числа
+и `NaN` — это его задача.
 
 **Signature:**
 ```typescript
-export function markDerived(signal: Signal<any>): void
+export function isNumber<TForm = unknown, TField extends number | null | undefined = number>(
+  options?: ValidateOptions
+): Validator<TForm, TField>
 ```
 
 **Parameters:**
-- `signal` — - Сигнал значения из {@link FormModel}, которым владеет compute
+- `options` — - Опции валидатора ({@link ValidateOptions}): `message`, `params`
+
+**Returns:** Чистый валидатор {@link Validator} для числового поля
 
 **Examples:**
 
+Проверка, что значение — число
 ```typescript
-import { markDerived } from '@reformer/core';
+import { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, isNumber } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.amount, [required(), isNumber({ message: 'Введите число' })]);
+});
+```
+
+_Source: src/form/validators/is-number.ts_
+
+### makeElementFieldHandle
+
+**Kind:** `function`
+
+Собирает базовый {@link FieldHandle}, делегирующий на DOM-элемент по ссылке `el`.
+Все вызовы null-safe: до монтирования (`el.current === null`) — no-op, без исключений.
+
+**Signature:**
+```typescript
+export function makeElementFieldHandle(el: RefObject<HTMLElement | null>): FieldHandle
+```
+
+_Source: src/platforms/react/field-binding/field-handle.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);
@@ -6425,6 +7343,550 @@ markDerived(model.$.total);
 
 _Source: src/model/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/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, max } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.quantity, [max(100)]);
+validate(model.$.discount, [required(), max(50, { message: 'Не более 50%' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { maxAge } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.birthDate, [maxAge(100, { message: 'Проверьте дату рождения' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { maxDate } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.birthDate, [maxDate(new Date(), { message: 'Дата не может быть в будущем' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { maxFiles } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.documents, [maxFiles(3, { message: 'Максимум 3 файла' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { maxFileSize } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.documents, [maxFileSize(5 * 1024 * 1024, { message: 'Файл больше 5 МБ' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { maxLength } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.name, [maxLength(50)]);
+validate(model.$.bio, [maxLength(500, { message: 'Максимум 500 символов' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { maxTotalFileSize } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.documents, [maxTotalFileSize(20 * 1024 * 1024, { message: 'Суммарно не более 20 МБ' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, min } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.age, [min(18)]);
+validate(model.$.quantity, [required(), min(1, { message: 'Минимум 1' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, minAge } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.birthDate, [required(), minAge(18, { message: 'Вам должно быть не менее 18 лет' })]);
+});
+```
+
+_Source: src/form/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>
+```
+
+**Parameters:**
+- `minDateValue` — - Минимально допустимая дата (включительно)
+- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
+попадает `minDate`.
+
+**Returns:** Чистый валидатор {@link Validator} для поля даты (`string | Date`)
+
+**Examples:**
+
+Минимальная дата
+```typescript
+import { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, minDate } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.startDate, [required(), minDate(new Date(), { message: 'Дата не раньше сегодня' })]);
+});
+```
+
+_Source: src/form/validators/min-date.ts_
+
+### minFiles
+
+**Kind:** `function`
+
+Фабрика валидатора минимального количества файлов.
+
+Работает с массивом файлов (одиночный файл считается как 1). Пустые значения
+(`null`/`undefined`/`''`/`[]`) пропускаются — «нужен хотя бы один файл» выражается
+связкой `required()` + `minFiles(n)`, как и у {@link minLength}.
+
+**Signature:**
+```typescript
+export function minFiles<TForm = unknown, TField = unknown>(
+  min: number,
+  options?: ValidateOptions
+): Validator<TForm, TField>
+```
+
+**Parameters:**
+- `min` — - Минимально допустимое количество файлов (включительно)
+- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
+попадают `minFiles` и `actualCount`.
+
+**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
+
+**Examples:**
+
+Не менее двух документов
+```typescript
+import { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, minFiles } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.documents, [required(), minFiles(2, { message: 'Приложите минимум 2 документа' })]);
+});
+```
+
+_Source: src/form/validators/min-files.ts_
+
+### minFileSize
+
+**Kind:** `function`
+
+Фабрика валидатора минимального размера файла.
+
+Работает с одиночным файлом или массивом (`File` либо файлоподобный дескриптор с
+`name`/`size`). Проверяется каждый файл; в ошибку попадает первый нарушивший.
+Типовой сценарий — отсев пустых (0-байтовых) файлов: `minFileSize(1)`.
+Пустые значения (`null`/`undefined`/`''`/`[]`) и элементы без числового `size`
+пропускаются (используйте {@link required} для обязательности).
+
+**Signature:**
+```typescript
+export function minFileSize<TForm = unknown, TField = unknown>(
+  minSize: number,
+  options?: ValidateOptions
+): Validator<TForm, TField>
+```
+
+**Parameters:**
+- `minSize` — - Минимально допустимый размер файла в байтах (включительно)
+- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
+попадают `minFileSize`, `fileName` и `actualSize`.
+
+**Returns:** Чистый валидатор {@link Validator} для файла или массива файлов
+
+**Examples:**
+
+Отсев пустых файлов
+```typescript
+import { defineValidationSchema, validate } from '@reformer/core/validation';
+import { minFileSize } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.documents, [minFileSize(1, { message: 'Файл пустой' })]);
+});
+```
+
+_Source: src/form/validators/min-file-size.ts_
+
+### minLength
+
+**Kind:** `function`
+
+Фабрика валидатора минимальной длины строки или массива.
+
+Работает со строкой или массивом (проверяется `value.length`). Пустые значения
+(`null`/`undefined`/`''`) и значения без числового `length` пропускаются
+(используйте {@link required} для обязательности).
+
+**Signature:**
+```typescript
+export function minLength<TForm = unknown, TField = unknown>(
+  minLen: number,
+  options?: ValidateOptions
+): Validator<TForm, TField>
+```
+
+**Parameters:**
+- `minLen` — - Минимально допустимая длина (включительно)
+- `options` — - Опции валидатора ({@link ValidateOptions}). В `params` ошибки автоматически
+попадают `minLength` и `actualLength`.
+
+**Returns:** Чистый валидатор {@link Validator} для строки или массива
+
+**Examples:**
+
+Минимальная длина строки
+```typescript
+import { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, minLength } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.name, [minLength(2)]);
+validate(model.$.password, [required(), minLength(8, { message: 'Минимум 8 символов' })]);
+});
+```
+
+_Source: src/form/validators/min-length.ts_
+
 ### ModelApi
 
 **Kind:** `interface`
@@ -6678,6 +8140,44 @@ export type ModelValue<V> =
 
 _Source: src/model/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { multipleOf } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.rating, [multipleOf(0.5, { message: 'Только шаг 0.5' })]);
+});
+```
+
+_Source: src/form/validators/multiple-of.ts_
+
 ### NodeFactory
 
 **Kind:** `class`
@@ -6708,6 +8208,7 @@ export class NodeFactory {
    * ```typescript
    * const factory = new NodeFactory();
    *
+   * Конфиг node-level (не layout-схема M1, где `validators` уже нет).
    * // FieldNode
    * const field = factory.createNode({
    *   value: 'test@mail.com',
@@ -6740,13 +8241,157 @@ export class NodeFactory {
 **Examples:**
 
 ```typescript
-import { NodeFactory } from '@reformer/core';
+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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { nonNegative } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.balance, [nonNegative({ message: 'Баланс не может быть отрицательным' })]);
+});
+```
+
+_Source: src/form/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { nonZero } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.divisor, [nonZero({ message: 'Не может быть нулём' })]);
+});
+```
+
+_Source: src/form/validators/non-zero.ts_
+
+### onChange
+
+**Kind:** `function`
+
+Реакция на изменение поля; `{ debounce, immediate }`.
+
+Колбэк выполняется ВНЕ effect-контекста (микротаск/таймер) — можно безопасно писать сигналы и ноды
+(`updateComponentProps`/`reset`/`clear`) без ручного `defer` и без «Cycle detected».
+
+Для async-колбэков 2-м аргументом приходит `{ signal }` (AbortSignal): при следующей смене значения
+предыдущий `signal` аннулируется. Передавай его в `fetch` (сетевая отмена) или проверяй
+`signal.aborted` перед применением результата — это убирает гонки устаревших ответов (F2).
+
+**Signature:**
+```typescript
+export function onChange<T>(
+  source: ReadonlySignal<T>,
+  cb: (value: T, ctx: ChangeContext) => void,
+  options?: { immediate?: boolean; debounce?: number }
+): void
+```
+
+_Source: src/form/behaviors/operators.ts_
+
+### onDispose
+
+**Kind:** `function`
+
+Зарегистрировать произвольную отписку в активной схеме.
+
+**Signature:**
+```typescript
+export function onDispose(cleanup: BehaviorCleanup): void
+```
+
+_Source: src/form/behaviors/context.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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, pastDate } from '@reformer/core/validators';
 
-const factory = new NodeFactory();
-const node = factory.createNode({ value: '', component: Input }); // → FieldNode<string>
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.birthDate, [required(), pastDate({ message: 'Дата рождения не может быть в будущем' })]);
+});
 ```
 
-_Source: src/form/factories/node-factory.ts_
+_Source: src/form/validators/past-date.ts_
 
 ### PathAwareSignal
 
@@ -6765,6 +8410,118 @@ export type PathAwareSignal<T> = Signal<T> & {
 
 _Source: src/model/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, pattern } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.name, [pattern(/^[a-zA-Zа-яА-Я]+$/, { message: 'Только буквы' })]);
+validate(model.$.phone, [required(), pattern(/^\+7 \(\d{3}\) \d{3}-\d{2}-\d{2}$/, { message: 'Формат +7 (999) 123-45-67' })]);
+});
+```
+
+_Source: src/form/validators/pattern.ts_
+
+### phone
+
+**Kind:** `function`
+
+Фабрика валидатора номера телефона.
+
+Проверяет значение по regex выбранного {@link PhoneFormat}. Пустые значения
+(`''`/`null`/`undefined`) пропускаются (используйте {@link required} для обязательности).
+
+**Signature:**
+```typescript
+export function phone<TForm = unknown, TField extends string | null | undefined = string>(
+  options?: PhoneValidatorOptions
+): Validator<TForm, TField>
+```
+
+**Parameters:**
+- `options` — - Опции валидатора {@link PhoneValidatorOptions}. В `params` ошибки
+автоматически попадает выбранный `format`.
+
+**Returns:** Чистый валидатор {@link Validator} для строкового поля
+
+**Examples:**
+
+Проверка номера телефона
+```typescript
+import { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, phone } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.phone, [required(), phone({ format: 'ru' })]);
+});
+```
+
+_Source: src/form/validators/phone.ts_
+
+### PhoneFormat
+
+**Kind:** `type`
+
+Формат проверки номера телефона для валидатора {@link phone}.
+
+- `international` — международный формат E.164 (`+?[1-9]\d{1,14}`);
+- `ru` — российские номера (`+7`/`7`/`8`, коды `4`/`8`/`9`, с разделителями);
+- `us` — североамериканские номера (NANP);
+- `any` — свободный формат: цифры, скобки и разделители (по умолчанию).
+
+**Signature:**
+```typescript
+export type PhoneFormat = 'international' | 'ru' | 'us' | 'any';
+```
+
+_Source: src/form/validators/phone.ts_
+
+### PhoneValidatorOptions
+
+**Kind:** `interface`
+
+Опции валидатора {@link phone}. Расширяют {@link ValidateOptions} (`message`, `params`)
+выбором формата номера.
+
+**Signature:**
+```typescript
+export interface PhoneValidatorOptions extends ValidateOptions {
+  /** Формат проверки {@link PhoneFormat}. По умолчанию `'any'`. */
+  format?: PhoneFormat;
+}
+```
+
+_Source: src/form/validators/phone.ts_
+
 ### registerSignalNode
 
 **Kind:** `function`
@@ -6799,6 +8556,47 @@ 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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.email, [required()]);
+validate(model.$.phone, [required({ message: 'Укажите номер телефона' })]);
+validate(model.$.agreeToTerms, [required({ message: 'Необходимо принять условия' })]);
+});
+```
+
+_Source: src/form/validators/required.ts_
+
 ### resetWhen
 
 **Kind:** `function`
@@ -6845,6 +8643,25 @@ revalidateWhen([model.$.maxAmount], () => void validateModel(model, schema));
 
 _Source: src/model/behaviors-value.ts_
 
+### Rule
+
+**Kind:** `type`
+
+Синхронное правило поля типа `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)`.
+
+**Signature:**
+```typescript
+export type Rule<TField> = (value: TField, scope: never, root: never) => ValidationError | null;
+```
+
+_Source: src/form/validation/types.ts_
+
 ### runOutsideEffect
 
 **Kind:** `function`
@@ -7123,6 +8940,27 @@ syncFields(model.$.field1, model.$.field2);
 
 _Source: src/model/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/validators/file-utils.ts_
+
 ### transformValue
 
 **Kind:** `function`
@@ -7196,6 +9034,67 @@ onDispose(() => unmarkDerived(model.$.total)); // при снятии compute с
 
 _Source: src/model/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 { defineValidationSchema, validate } from '@reformer/core/validation';
+import { required, url } from '@reformer/core/validators';
+
+// Правила живут в отдельной схеме над МОДЕЛЬЮ — layout-схема валидаторов не несёт.
+const validation = defineValidationSchema<MyForm>(({ model }) => {
+validate(model.$.website, [required(), url({ message: 'Введите корректный URL' })]);
+// Требовать протокол и ограничить схему только https:
+validate(model.$.homepage, [url({ requireProtocol: true, allowedProtocols: ['https'] })]);
+});
+```
+
+_Source: src/form/validators/url.ts_
+
+### UrlValidatorOptions
+
+**Kind:** `interface`
+
+Опции валидатора {@link url}. Расширяют {@link ValidateOptions} (`message`, `params`)
+настройками проверки протокола.
+
+**Signature:**
+```typescript
+export interface UrlValidatorOptions extends ValidateOptions {
+  /** Требовать наличие протокола (`http://` или `https://`). По умолчанию `false`. */
+  requireProtocol?: boolean;
+  /**
+   * Список разрешённых протоколов (без `://`), например `['https']`. Если задан,
+   * значение с иным протоколом даёт ошибку с кодом `url_protocol`.
+   */
+  allowedProtocols?: string[];
+}
+```
+
+_Source: src/form/validators/url.ts_
+
 ### useArrayLength
 
 **Kind:** `function`
@@ -7234,6 +9133,33 @@ function ArrayRenderer({ arrayNode }) {
 
 _Source: src/platforms/react/hooks/useArrayLength.ts_
 
+### useFieldHandleRef
+
+**Kind:** `function`
+
+Ref для контрола поля + императивный handle для потребителя.
+
+Возвращённый ref вешается на контрол. На `outerRef` публикуется:
+- handle самого контрола, если тот его реализует (`useImperativeHandle` композита);
+- иначе — базовый {@link FieldHandle}, построенный из DOM-узла контрола.
+
+Хук вызывается безусловно; вешать ref на контрол стоит только при заданном `outerRef` —
+так function-компонент без ref-поддержки не получает лишний ref.
+
+**Signature:**
+```typescript
+export function useFieldHandleRef<H = FieldHandle>(
+  outerRef: Ref<H> | undefined
+): RefObject<unknown>
+```
+
+**Parameters:**
+- `outerRef` — - ref потребителя (из `forwardRef` или `schema.node(sel).getRef()`).
+
+**Returns:** ref, который нужно передать контролу.
+
+_Source: src/platforms/react/field-binding/field-handle.ts_
+
 ### useFormBundle
 
 **Kind:** `function`
@@ -7749,6 +9675,96 @@ export interface UseFormValidationResult {
 
 _Source: src/platforms/react/hooks/use-form-validation.ts_
 
+### validate
+
+**Kind:** `function`
+
+Синхронные правила поля.
+
+**Signature:**
+```typescript
+export function validate<TField>(sig: PathAwareSignal<TField>, rules: Rule<TField>[]): void
+```
+
+**Examples:**
+
+```ts
+validate(model.$.loanAmount, [required({ message: 'Сумма' }), min(50000)]);
+```
+
+_Source: src/form/validation/operators.ts_
+
+### validateAsync
+
+**Kind:** `function`
+
+Асинхронные правила поля (зеркалит движковое разделение `validators` / `asyncValidators`).
+Раннер дожидается их и прокидывает `AbortSignal` для отмены устаревших ответов.
+
+**Signature:**
+```typescript
+export function validateAsync<TField>(
+  sig: PathAwareSignal<TField>,
+  rules: AsyncRule<TField>[]
+): void
+```
+
+**Examples:**
+
+```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: 'Занято' };
+}]);
+```
+
+_Source: src/form/validation/operators.ts_
+
+### validateModel
+
+**Kind:** `function`
+
+Провалидировать модель ЛЮБОЙ схемой (шаг или вся форма). Открывает 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()`; при пошаговой валидации следующий шаг не показывается
+«тронутым» до ввода. Валидные проверенные поля тоже метятся — это безвредно (ошибка не покажется).
+
+**Signature:**
+```typescript
+export async function validateModel<T>(
+  model: FormModel<T>,
+  schema: ValidationSchema<T>,
+  options?: { touch?: boolean }
+): Promise<boolean>
+```
+
+**Parameters:**
+- `model` — - Модель данных формы.
+- `schema` — - Схема валидации (стабильная ссылка).
+- `options` — - `{ touch }` — пометить провалидированные поля `touched` для показа ошибок.
+
+**Examples:**
+
+```ts
+const ok = await validateModel(model, step2Validation);              // один шаг
+const all = await validateModel(model, formValidation);              // вся форма
+const stepOk = await validateModel(model, step2Validation, { touch: true }); // + показать ошибки шага
+```
+
+_Source: src/form/validation/run.ts_
+
 ### ValidateOptions
 
 **Kind:** `interface`
@@ -7769,6 +9785,20 @@ export interface ValidateOptions {
 
 _Source: src/form/types/validation-schema.ts_
 
+### validateWhen
+
+**Kind:** `function`
+
+Условная валидация: правила внутри `cb` активны, только пока `cond()` истинно; иначе их поля
+ГАСЯТСЯ (пустой bucket → `setErrors([])`). Не трогает включение/сброс поля — это дело поведения (`enableWhen`).
+
+**Signature:**
+```typescript
+export function validateWhen(cond: () => boolean, cb: () => void): void
+```
+
+_Source: src/form/validation/operators.ts_
+
 ### ValidationError
 
 **Kind:** `interface`
@@ -7788,6 +9818,54 @@ export interface ValidationError {
 
 _Source: src/form/types/contracts.ts_
 
+### ValidationSchema
+
+**Kind:** `type`
+
+Схема валидации — обычная функция над (под)моделью. First-class значение (можно `apply`/тестировать/переиспользовать).
+
+**Signature:**
+```typescript
+export type ValidationSchema<T> = (ctx: { model: FormModel<T> }) => void;
+```
+
+_Source: src/form/validation/types.ts_
+
+### ValidationStrategyKind
+
+**Kind:** `type`
+
+Когда запускается schema-валидация:
+- `submit` (по умолчанию) — только явным вызовом `validate()` (на отправке);
+- `blur` — при потере фокуса поля (смена `touched` любого листа);
+- `change` — на каждый ввод (с опц. `debounce`);
+- `afterFirstSubmit` — тихо до первого `validate()`, затем live (см. `liveAfterSubmit`).
+
+**Signature:**
+```typescript
+export type ValidationStrategyKind = 'submit' | 'blur' | 'change' | 'afterFirstSubmit';
+```
+
+_Source: src/form/validation/strategy.ts_
+
+### ValidationStrategyOptions
+
+**Kind:** `interface`
+
+**Signature:**
+```typescript
+export interface ValidationStrategyOptions {
+  /** Стратегия запуска. Default `'submit'`. */
+  strategy?: ValidationStrategyKind;
+  /** Debounce (мс) для live-фаз (`change` и live-часть `afterFirstSubmit`). Default `0`. */
+  debounce?: number;
+  /** Режим live-фазы для `afterFirstSubmit`. Default `'change'`. */
+  liveAfterSubmit?: 'change' | 'blur';
+}
+```
+
+_Source: src/form/validation/strategy.ts_
+
 ### Validator
 
 **Kind:** `type`