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

package/dist/form/schema-controller.d.ts

@@ -0,0 +1,153 @@
+import { Signal } from '@preact/signals-core';
+import { CompiledSchema } from './schema/compiled';
+/**
+ * Хуки жизненного цикла узла схемы. Каждый хук опционален; повторная регистрация перезаписывает
+ * предыдущее значение.
+ *
+ * @group Schema
+ */
+export interface NodeLifecycleHooks {
+    /** Срабатывает один раз при mount узла. Может вернуть cleanup-функцию. */
+    onMount?: () => void | (() => void);
+    /** Срабатывает один раз при unmount узла. */
+    onUnmount?: () => void;
+}
+/**
+ * Хранилище переопределений одной области схемы. Ключ каждой карты — `selector` узла: он же
+ * идентификатор узла в скомпилированной схеме области ({@link SchemaNodeId}).
+ *
+ * @group Schema
+ */
+export interface SchemaOverrideMaps {
+    hiddenOverrides: Map<string, boolean | null>;
+    propsOverrides: Map<string, Record<string, unknown> | null>;
+    refRegistry: Map<string, {
+        current: any;
+    }>;
+    /** Условия скрытия узлов: selector → реактивное условие. */
+    conditionRegistry: Map<string, () => boolean>;
+    /** Реактивные эффекты, живущие, пока область смонтирована (`renderEffect`). */
+    effectRegistry: Array<() => void | (() => void)>;
+    /** Обработчики событий компонентов: selector → { имя пропа → обработчик }. */
+    callbackRegistry: Map<string, Map<string, (...args: any[]) => any>>;
+    /** Хуки жизненного цикла узла: selector → { onMount, onUnmount }. */
+    lifecycleRegistry: Map<string, NodeLifecycleHooks>;
+    /** Общий счётчик изменений области. Узлы на него не подписываются — см. `versionFor`. */
+    version: Signal<number>;
+    /**
+     * Версия-сигнал одного селектора (создаётся лениво). Узел подписывается только на сигнал СВОЕГО
+     * селектора, поэтому `setHidden` / `patchProps` уведомляют один узел, а не всё дерево.
+     */
+    versionFor(selector: string): Signal<number>;
+}
+/**
+ * Управление одним узлом схемы. Получается через `schema.node(selector)`.
+ *
+ * @group Schema
+ */
+export interface SchemaNodeControl {
+    /** Принудительно скрыть или показать узел, минуя условие `hideWhen`. */
+    setHidden(value: boolean): this;
+    /** Убрать принудительное значение — снова действует условие `hideWhen`. */
+    resetHidden(): this;
+    /** Подмешать объект в `componentProps` узла. */
+    patchProps(partial: Record<string, unknown>): this;
+    /** Убрать подмешанные пропсы. */
+    resetProps(): this;
+    /**
+     * Ref на компонент узла. Создаётся один раз на селектор; рендерер вешает его на компонент.
+     * Компонент обязан принимать `ref`.
+     */
+    getRef<H>(): {
+        current: H | null;
+    };
+    /**
+     * @internal Записать условие скрытия узла (`hideWhen`). Возвращает снятие: оно убирает условие,
+     * только если его не сменило более позднее.
+     */
+    addHideCondition(condition: () => boolean): () => void;
+    /**
+     * @internal Записать обработчик проп-события компонента узла (`onComponentEvent`). Возвращает
+     * снятие: оно убирает обработчик, только если его не сменил более поздний.
+     */
+    addEventHandler(event: string, handler: (...args: any[]) => any): () => void;
+    /**
+     * @internal Записать хук жизненного цикла узла (`onMount`, `onUnmount`). Возвращает снятие: оно
+     * убирает хук, только если его не сменил более поздний.
+     */
+    addLifecycleHook<K extends keyof NodeLifecycleHooks>(hook: K, value: NonNullable<NodeLifecycleHooks[K]>): () => void;
+    /** @internal Селектор узла. */
+    __selector: string;
+    /** @internal Хранилище области — его читает рендерер. */
+    __overrideMaps: SchemaOverrideMaps;
+}
+/**
+ * Схема одной области: адресует узлы по `selector`.
+ *
+ * @group Schema
+ */
+export interface SchemaScope {
+    /** Управление узлом области по его `selector`. */
+    node(selector: string): SchemaNodeControl;
+    /**
+     * @internal Записать эффект, живущий, пока область смонтирована (`renderEffect`). Возвращает
+     * снятие.
+     */
+    addRenderEffect(effect: () => void | (() => void)): () => void;
+    /** @internal Хранилище области — его читает рендерер. */
+    __overrideMaps: SchemaOverrideMaps;
+}
+/**
+ * Схема-контроллер сборки: области по под-моделям.
+ *
+ * @group Schema
+ */
+export interface SchemaController {
+    /**
+     * Область под-модели: корня сборки, строки массива или группы подформы. Создаётся при первом
+     * обращении; повторное обращение отдаёт ту же область.
+     */
+    scopeOf(subModel: object): SchemaScope;
+}
+/**
+ * Схема области поверх хранилища: `node(selector)` → управление узлом.
+ *
+ * @param maps - Хранилище области; по умолчанию создаётся новое.
+ * @group Schema
+ */
+export declare function createSchemaScope(maps?: SchemaOverrideMaps): SchemaScope;
+/**
+ * Схема-контроллер одной сборки формы.
+ *
+ * @example
+ * ```typescript
+ * const controller = createSchemaController();
+ * const root = controller.scopeOf(model);
+ * root.node('mortgage').setHidden(true);
+ *
+ * controller.scopeOf(model.items.at(0)); // область строки — свои селекторы
+ * ```
+ *
+ * @group Schema
+ */
+export declare function createSchemaController(): SchemaController;
+/**
+ * Селекторы, на которые в области записаны правила, но которых нет в её скомпилированной схеме.
+ * Такое правило ничего не делает — сборка и рендерер в dev предупреждают о нём.
+ *
+ * Ref в проверку не входит: его разрешено брать по абсолютному пути модели
+ * (`phones.0.number`), а такой строки при сборке может ещё не быть.
+ *
+ * @param maps - Хранилище области.
+ * @param compiled - Скомпилированная схема области ({@link CompiledSchema}).
+ * @returns Селекторы с правилами, не найденные в схеме области.
+ *
+ * @example
+ * ```typescript
+ * const scope = controller.scopeOf(model);
+ * unknownSchemaSelectors(scope.__overrideMaps, bundle.render.tree!); // ['mortgage'] — узла нет
+ * ```
+ *
+ * @group Schema
+ */
+export declare function unknownSchemaSelectors(maps: SchemaOverrideMaps, compiled: CompiledSchema): string[];

package/dist/form/schema-subtree.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Поддерево схемы для под-модели: содержимое строки массива (`item`) или подформы (`part`).
+ *
+ * Билдер поддерева зовут два места — сборка формы и рендерер. Оба обязаны получить ОДНО дерево:
+ * на объектах его узлов держится идентичность (ключи рендера, записи схемы-контроллера), а сам
+ * билдер не обязан быть чистым. Поэтому дерево строится один раз на пару «билдер + под-модель»
+ * и дальше отдаётся из памяти.
+ *
+ * Память привязана к под-модели: исчезла строка массива — исчезли и её поддеревья.
+ *
+ * @group Utilities
+ * @module form/schema-subtree
+ */
+/**
+ * Поддерево схемы для под-модели — результат `builder(subModel)`, один на пару.
+ *
+ * @typeParam N - Тип узла, который возвращает билдер.
+ * @param builder - Билдер поддерева: `item` узла-массива или `part` узла-подформы.
+ * @param subModel - Под-модель строки массива или группы.
+ * @returns Узел поддерева; повторный вызов с той же парой отдаёт тот же объект.
+ *
+ * @example
+ * ```typescript
+ * const row = model.items.at(0);
+ * schemaSubtree(itemSchema, row) === schemaSubtree(itemSchema, row); // true
+ * ```
+ */
+export declare function schemaSubtree<N>(builder: (subModel: any) => N, subModel: object): N;

package/dist/form/signal-node-registry.d.ts

@@ -1,46 +1,51 @@
-import { Signal } from '@preact/signals-core';
-import { FormNode } from './nodes/form-node';
+import { FormNode } from './types/nodes';
 /**
- * Связать сигнал модели с его нодой формы.
+ * Связать ручку модели с её нодой формы.
  *
- * Вызывается движком при сборке формы (`createForm`/{@link createFormFromModel}) для каждого
- * листового поля. Прикладной код обычно этот реестр не заполняет напрямую.
+ * Вызывается движком при сборке формы (`createForm`/{@link createFormFromModel}) для каждого поля,
+ * группы и массива под-форм; у группы в реестре лежит её лицо {@link FormGroup} с нодами полей.
+ * Прикладной код обычно этот реестр не заполняет напрямую.
  *
- * @param signal - Сигнал значения из {@link FormModel} (ручка поля, `model.$.path`)
- * @param node - Нода формы, отвечающая за это поле
+ * @param signal - Ручка из {@link FormModel}: сигнал листа, узел-массив или узел-группа дерева `model.$`
+ * @param node - Нода формы, отвечающая за эту часть модели
  *
- * @example Привязка листовых полей при построении формы
+ * @example Ручка модели указывает на ноду другой сборки
  * ```typescript
  * import { registerSignalNode } from '@reformer/core';
  *
- * const sig = model.signalAt('profile.email');
- * const node = group.getFieldByPath('profile.email');
- * if (sig && node) registerSignalNode(sig, node);
+ * registerSignalNode(model.$.profile.email, profileForm.email);
  * ```
  *
- * @see {@link getNodeForSignal} - обратный поиск ноды по сигналу
+ * @see {@link getNodeForSignal} - обратный поиск ноды по ручке
  * @group Utilities
  */
-export declare function registerSignalNode(signal: Signal<any>, node: FormNode<any>): void;
+export declare function registerSignalNode(signal: object, node: FormNode<any>): void;
 /**
- * Найти ноду формы по сигналу модели.
+ * Найти ноду формы по ручке модели.
  *
- * Используется state-операциями behavior (`enableWhen`/`disableWhen`) и роутингом ошибок
- * валидации в ноды. Возвращает `undefined`, если форма ещё не построена или поле не
- * материализовано в этой форме (например, элемент массива, который строится per-item).
+ * Используется state-операциями behavior (`enableWhen`/`disableWhen`), подключением под-схем
+ * (`apply`/`applyEach`) и роутингом ошибок валидации в ноды. Возвращает `undefined`, если форма
+ * ещё не построена или эта часть модели в форме не материализована (например, массив без
+ * item-схемы).
  *
- * @param signal - Сигнал значения из {@link FormModel}
- * @returns Нода формы для этого поля или `undefined`
+ * @param signal - Ручка из {@link FormModel}: `model.$.<поле>`, `model.$.<группа>`, `model.$.<массив>`
+ * @returns Нода формы — поля, группы или массива — либо `undefined`
  *
  * @example Роутинг ошибок валидации в ноду поля
  * ```typescript
  * import { getNodeForSignal } from '@reformer/core';
  *
  * const sig = model.$.email;
- * getNodeForSignal(sig)?.setErrors([{ code: 'required', message: 'Обязательно' }]);
+ * getNodeForSignal(sig)?.setIssues([{ code: 'required' }]);
  * ```
  *
- * @see {@link registerSignalNode} - регистрация связи сигнал→нода
+ * @example Нода группы и строки массива
+ * ```typescript
+ * getNodeForSignal(model.$.address)?.disable(); // группа целиком
+ * getNodeForSignal(model.$.phones[0])?.markAsTouched(); // форма строки массива
+ * ```
+ *
+ * @see {@link registerSignalNode} - регистрация связи ручка→нода
  * @group Utilities
  */
-export declare function getNodeForSignal(signal: Signal<any>): FormNode<any> | undefined;
+export declare function getNodeForSignal(signal: object): FormNode<any> | undefined;

package/dist/form/submission.d.ts

@@ -0,0 +1,93 @@
+import { ReadonlySignal } from '@preact/signals-core';
+import { ValidationResult } from './validation/types';
+/**
+ * Итог отправки: `submitted` — обработчик отработал, `invalid` / `error` / `cancelled` —
+ * проверка не пропустила (обработчик не вызывался), `failed` — обработчик бросил исключение.
+ *
+ * `cancelled` — проверку отправки сменила следующая (вторая отправка, живой прогон) либо модель
+ * изменилась, пока проверка шла: правила видели прежние значения, и отправлять новые нельзя.
+ * Замечаний такой итог не несёт — отправку повторяют.
+ *
+ * @group Form
+ */
+export type SubmitResult<TResult> = {
+    readonly status: 'submitted';
+    readonly result: TResult;
+} | {
+    readonly status: 'invalid' | 'error' | 'cancelled';
+    readonly validation: ValidationResult;
+} | {
+    readonly status: 'failed';
+    readonly error: unknown;
+};
+/**
+ * Итог проверки для действия по её результату (отправка, переход шага).
+ *
+ * @group Form
+ */
+export interface ActionCheck<T> {
+    /** Результат проверки. */
+    readonly result: ValidationResult;
+    /** Значения модели после проверки; при `stale === false` — ровно те, что видели правила. */
+    readonly values: T;
+    /** Проверка успешна, но модель с тех пор изменилась: её успех относится к прежним значениям. */
+    readonly stale: boolean;
+}
+/**
+ * Зависимости отправки. Явные, чтобы модуль не тянул ни модель, ни ноды формы.
+ *
+ * @group Form
+ */
+export interface SubmissionDependencies<T> {
+    /**
+     * Проверка перед отправкой — попытка отправки: замечания раскрыты, при необходимости вся форма
+     * тронута. `undefined` — правил нет: обработчик получает {@link SubmissionDependencies.values}.
+     */
+    readonly check: (() => Promise<ActionCheck<T>>) | undefined;
+    /** Значения без проверки. */
+    readonly values: () => T;
+}
+/**
+ * Отправка формы.
+ *
+ * @group Form
+ */
+export interface FormSubmission<T> {
+    /** Идёт ли отправка: работает обработчик. Пока идёт проверка, — `false`. */
+    readonly submitting: ReadonlySignal<boolean>;
+    /**
+     * Отправить: один прогон всех правил; при успехе — обработчик со значениями модели.
+     *
+     * Обработчик получает ровно те значения, которые видели правила. Пока идёт async-правило,
+     * форма не заперта (`submitting` ещё `false`); если модель за это время изменилась — правкой
+     * пользователя, загрузкой, записью поведения после таймера или запроса, — итог `cancelled`,
+     * обработчик не вызывается.
+     *
+     * Значения — модель целиком, с выключенными полями: их правила не считаются, но данные
+     * принадлежат модели. Убрать их из отправки — забота обработчика либо
+     * `enableWhen(…, { resetOnDisable: true })`.
+     *
+     * Исключение обработчика наружу не выходит: итог `failed` с этим исключением.
+     */
+    submit<TResult>(handler: (values: T) => TResult | Promise<TResult>): Promise<SubmitResult<TResult>>;
+}
+/**
+ * Создать отправку формы.
+ *
+ * Обычно её создаёт сборка (`createForm` → `bundle.submission`). Прямой вызов нужен там, где
+ * сборки нет: визард в разметке без `createForm` отправляет значения формы без проверки.
+ *
+ * @typeParam T - Форма данных.
+ * @param dependencies - {@link SubmissionDependencies}: проверка перед действием и значения.
+ * @returns {@link FormSubmission}.
+ *
+ * @example Без проверки — значения формы как есть
+ * ```typescript
+ * const submission = createSubmission<Profile>({ check: undefined, values: () => form.getValue() });
+ * const outcome = await submission.submit(api.save);
+ * if (outcome.status === 'failed') showToast('Не удалось сохранить');
+ * ```
+ *
+ * @group Form
+ */
+export declare function createSubmission<T>(dependencies: SubmissionDependencies<T>): FormSubmission<T>;

package/dist/form/type-guards.d.ts

@@ -1,97 +1,38 @@
-import { FormNode } from './nodes/form-node';
-import { FieldNode } from './nodes/field-node';
-import { GroupNode } from './nodes/group-node';
-import { ArrayNode } from './nodes/array-node';
-import { FormValue } from './types/index';
+import { FormArray, FormControl, FormGroup, FormNode } from './types/nodes';
 /**
- * Проверить, является ли значение любым FormNode
- *
- * Проверяет базовые свойства, общие для всех типов узлов
- *
- * @group Utilities
- * @category Type Guards
- *
- * @param value - Значение для проверки
- * @returns true если value является FormNode
- *
- * @example
- * ```typescript
- * if (isFormNode(value)) {
- *   value.setValue(newValue);
- *   value.validate();
- * }
- * ```
- */
-export declare function isFormNode(value: unknown): value is FormNode<FormValue>;
-/**
- * Проверить, является ли значение FieldNode (примитивное поле)
- *
- * FieldNode представляет примитивное поле формы (string, number, boolean и т.д.)
- * и имеет валидаторы, но не имеет вложенных полей или элементов массива
- *
- * @group Utilities
- * @category Type Guards
- *
- * @param value - Значение для проверки
- * @returns true если value является FieldNode
+ * Нода формы любого вида — поле, группа или массив под-форм.
  *
  * @example
  * ```typescript
- * if (isFieldNode(node)) {
- *   node.validators; //  OK
- *   node.asyncValidators; //  OK
- *   node.markAsTouched(); //  OK
- * }
+ * const node = getNodeForSignal(model.$.email);
+ * if (isFormNode(node)) node.markAsTouched();
  * ```
  */
-export declare function isFieldNode(value: unknown): value is FieldNode<FormValue>;
+export declare function isFormNode(value: unknown): value is FormNode<unknown>;
 /**
- * Проверить, является ли значение GroupNode (объект с вложенными полями)
- *
- * GroupNode представляет объект с вложенными полями формы: имеет навигацию по полям
- * (`getFieldByPath`/`fields`) и НЕ имеет array-методов (`items`/`push`/`removeAt`).
- *
- * @param value - Значение для проверки
- * @returns true если value является GroupNode
+ * Поле формы — нода над листом модели с пропсами компонента.
  *
  * @example
  * ```typescript
- * if (isGroupNode(node)) {
- *   node.getFieldByPath('user.email'); //  OK
- * }
+ * if (isFormControl(node)) node.updateComponentProps({ placeholder: 'Email' });
  * ```
  */
-export declare function isGroupNode(value: unknown): value is GroupNode<object>;
+export declare function isFormControl(value: unknown): value is FormControl<unknown>;
 /**
- * Проверить, является ли значение ArrayNode (массив форм)
- *
- * ArrayNode представляет массив вложенных форм (обычно GroupNode)
- * и имеет array-like методы (push, removeAt, at)
- *
- * @param value - Значение для проверки
- * @returns true если value является ArrayNode
+ * Группа полей — её прокси с нодами полей по именам.
  *
  * @example
  * ```typescript
- * if (isArrayNode(node)) {
- *   node.push(); //  OK - добавить элемент
- *   node.removeAt(0); //  OK - удалить элемент
- *   const item = node.at(0); //  OK - получить элемент
- * }
+ * if (isFormGroup(node)) node.markAsTouched();
  * ```
  */
-export declare function isArrayNode(value: unknown): value is ArrayNode<object>;
+export declare function isFormGroup(value: unknown): value is FormGroup<Record<string, unknown>>;
 /**
- * Получить тип узла как строку (для отладки)
- *
- * Полезно для логирования и отладки
- *
- * @param node - Узел для проверки
- * @returns Строковое название типа узла
+ * Массив под-форм.
  *
  * @example
  * ```typescript
- * console.log('Node type:', getNodeType(node)); // "FieldNode" | "GroupNode" | "ArrayNode" | "FormNode" | "Unknown"
+ * if (isFormArray(node)) node.push();
  * ```
  */
-export declare function getNodeType(node: unknown): string;
+export declare function isFormArray(value: unknown): value is FormArray<object>;

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

@@ -1,109 +1,36 @@
 /**
- * Общие контракт-типы значения и валидации.
+ * Контракт замечания валидации.
  *
- * Базовый словарь «значение + ошибка + статус», на который опираются узлы формы
- * (`FormNode.getErrors`, `FieldNode`, `FormStatusMachine`, `aggregate-signals`), слой валидации
- * и платформенные биндинги. Файл не импортирует ничего — это лист графа зависимостей.
+ * Базовый словарь, на который опираются ноды формы, слой валидации и платформенные биндинги.
+ * Файл не импортирует ничего — это лист графа зависимостей.
  *
- * Живёт в `form/types/`, а не в слое модели: `FieldStatus`/`ErrorFilterOptions` — понятия формы,
- * а модель этих типов не использует (и импортировать их оттуда запрещено границей model⇏form).
+ * Живёт в `form/types/`, а не в слое модели: замечание — понятие формы, а модель этих типов
+ * не использует (и импортировать их оттуда запрещено границей model⇏form).
  * Наружу отдаётся через `form/types/index`.
  *
  * @group Types
  * @module form/types/contracts
  */
 /**
- * Represents any valid form value type
- * Use this instead of 'any' for form values to maintain type safety
- *
- * @group Types
- * @category Core Types
- */
-export type FormValue = string | number | boolean | null | undefined | Date | File | FormValue[] | {
-    [key: string]: FormValue;
-};
-/**
- * Синхронная функция валидации
- * @group Types
- * @category Validation Types
- */
-export type ValidatorFn<T = FormValue> = (value: T) => ValidationError | null;
-/**
- * Опции для асинхронного валидатора
- * @group Types
- * @category Validation Types
- */
-export interface AsyncValidatorOptions {
-    /**
-     * AbortSignal для отмены валидации
-     * Позволяет отменить асинхронную операцию при новой валидации
-     */
-    signal?: AbortSignal;
-}
-/**
- * Асинхронная функция валидации
- *
- * @param value - Значение для валидации
- * @param options - Опции валидации (опционально)
- * @returns Promise с ошибкой валидации или null если значение валидно
+ * Замечание валидации: что нарушено (`code`) и с какими числами (`params`). Текста у замечания
+ * нет — отображаемую строку по коду даёт слой представления (`resolveIssueMessage` из
+ * `@reformer/core/i18n`): словарь формы → словарь локали → встроенный английский → сам код.
+ * Поэтому одно и то же замечание показывается на любом языке без повторной проверки.
  *
  * @example
- * ```typescript
- * // Простой валидатор (без поддержки отмены)
- * const emailExists: AsyncValidatorFn<string> = async (value) => {
- *   const exists = await checkEmail(value);
- *   return exists ? { code: 'exists', message: 'Email already exists' } : null;
- * };
- *
- * // Валидатор с поддержкой отмены
- * const emailExistsAbortable: AsyncValidatorFn<string> = async (value, options) => {
- *   const exists = await fetch(`/api/check-email?email=${value}`, {
- *     signal: options?.signal // Передаём signal в fetch для отмены запроса
- *   });
- *   return exists ? { code: 'exists', message: 'Email already exists' } : null;
- * };
+ * ```ts
+ * const tooShort: ValidationIssue = { code: 'minLength', params: { minLength: 8 } };
+ * const softLimit: ValidationIssue = { code: 'loanAmount.high', severity: 'warning' };
  * ```
  *
  * @group Types
  * @category Validation Types
  */
-export type AsyncValidatorFn<T = FormValue> = (value: T, options?: AsyncValidatorOptions) => Promise<ValidationError | null>;
-/**
- * Ошибка валидации
- * @group Types
- * @category Validation Types
- */
-export interface ValidationError {
-    code: string;
-    /**
-     * Готовый текст ошибки. Пустая строка — «автор правила текста не задавал»: отображаемую строку
-     * тогда даёт резолвер по `code` (словарь локали `validation.<code>`).
-     */
-    message: string;
-    /** Ключ сообщения в словаре приложения; при наличии в активной локали важнее `message`. */
-    messageKey?: string;
-    params?: Record<string, FormValue>;
-    /** Severity level: 'error' (default) blocks submission, 'warning' shows message but allows submission */
-    severity?: 'error' | 'warning';
+export interface ValidationIssue {
+    /** Код правила: встроенный (`required`, `minLength`) либо свой (`loanAmount.required`). */
+    readonly code: string;
+    /** Значения для подстановки в текст: порог правила, фактическое значение. */
+    readonly params?: Readonly<Record<string, unknown>>;
+    /** `'error'` (по умолчанию) блокирует отправку, `'warning'` показывается, но не блокирует. */
+    readonly severity?: 'error' | 'warning';
 }
-/**
- * Опции для фильтрации ошибок в методе getErrors()
- * @group Types
- * @category Validation Types
- */
-export interface ErrorFilterOptions {
-    /** Фильтр по коду ошибки */
-    code?: string | string[];
-    /** Фильтр по сообщению (поддерживает частичное совпадение) */
-    message?: string;
-    /** Фильтр по параметрам ошибки */
-    params?: Record<string, FormValue>;
-    /** Кастомный предикат для фильтрации */
-    predicate?: (error: ValidationError) => boolean;
-}
-/**
- * Статус поля формы
- * @group Types
- * @category Core Types
- */
-export type FieldStatus = 'valid' | 'invalid' | 'pending' | 'disabled';

package/dist/form/types/field-config.d.ts

@@ -0,0 +1,27 @@
+import { Signal } from '@preact/signals-core';
+import { ComponentRef } from './schema-node';
+/**
+ * Конфигурация поля формы ({@link FormControl}): сигнал значения из модели и то, что нода берёт
+ * из узла схемы.
+ *
+ * В схеме формы поле записывают узлом `{ model: model.$.field, component, componentProps }`;
+ * сборка `createFormFromModel` превращает узел в этот конфиг сама. Правил валидации в конфиге нет —
+ * они живут в схеме валидации (`defineValidation`, `@reformer/core/validation`).
+ *
+ * @group Types
+ * @category Configuration Types
+ */
+export interface FieldConfig<T> {
+    /**
+     * Сигнал значения из {@link FormModel} — источник истины значения поля. Нода значением не
+     * владеет, а ссылается на этот сигнал.
+     */
+    valueSignal: Signal<T>;
+    /**
+     * UI-компонент поля. Опционален: core-часть можно использовать без ссылки на компонент
+     * (значение и состояние работают без UI; компонент нужен только для рендеринга).
+     */
+    component?: ComponentRef;
+    componentProps?: any;
+    disabled?: boolean;
+}