@reformer/core 9.0.0 → 9.1.0

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

@@ -1,7 +1,7 @@
-import { FormProxy, GroupNodeConfig, FormSchema } from '../types';
-import { FormSchemaNode } from '../types/schema-node';
-import { FormModel } from '../model/types';
-import { FormBehavior } from '../../behaviors';
+import { FormProxy, GroupNodeConfig, FormSchema } from './types/index';
+import { FormSchemaNode } from './types/schema-node';
+import { FormModel } from '../state/types';
+import { FormBehavior } from './behaviors';
 /**
  * Аргументы createForm под архитектуру M1: данные приходят из {@link FormModel},
  * конфиг полей (component/componentProps/validators) — из единой схемы.
@@ -52,6 +52,7 @@ export interface CreateFormFromModelArgs<T> {
  *   component: Section,
  *   children: [
  *     { value: model.$.email, component: Input, validators: [required] },
+ *     // вложенная группа: `model.$.profile.name` (≡ под-модель `model.profile.$.name` — тот же сигнал)
  *     { value: model.$.profile.name, component: Input },
  *   ],
  * };

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

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

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

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

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

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

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

@@ -70,7 +70,12 @@ export declare class FormSubmitter<T extends object> {
      *
      * @param onSubmit - Callback для отправки данных
      * @param options - Опции submit
-     * @returns Результат от onSubmit или null если валидация не пройдена
+     * @returns Результат от onSubmit или `null` если валидация не пройдена
+     *
+     * @remarks
+     * Возвращаемый `null` неоднозначен: он сигналит и провал валидации, и легитимный `null`,
+     * который вернул `onSubmit` (или void-обработчик). Чтобы различать эти случаи, используйте
+     * {@link submitWithResult} — он отдаёт явный флаг `success`.
      *
      * @example
      * ```typescript

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

@@ -1,4 +1,4 @@
-import { ValidationError } from '../core/types';
+import { ValidationError } from '../types/index';
 /**
  * Состояние поля формы, возвращаемое хуком {@link useFormControl} для {@link FieldNode}.
  *
@@ -191,6 +191,20 @@ export interface FieldControlState<T> {
      * ```
      */
     componentProps: Record<string, unknown>;
+    /**
+     * Флаг изменения поля.
+     * `true` когда значение поля отличается от начального.
+     *
+     * Реактивный аналог `control.dirty` — паритет с {@link ArrayControlState.dirty}.
+     *
+     * @example
+     * ```tsx
+     * const { dirty } = useFormControl(field);
+     *
+     * return dirty ? <span className="badge">Изменено</span> : null;
+     * ```
+     */
+    dirty: boolean;
 }
 /**
  * Состояние массива формы, возвращаемое хуком {@link useFormControl} для {@link ArrayNode}.
@@ -325,4 +339,20 @@ export interface ArrayControlState<T> {
      * ```
      */
     dirty: boolean;
+    /**
+     * Флаг отключения массива.
+     * `true` когда массив отключён (`ArrayNode.disable()`), в том числе через
+     * распространение disable от родительской группы.
+     *
+     * Используйте для отключения UI-действий добавления/удаления, когда массив
+     * структурно неизменяем.
+     *
+     * @example
+     * ```tsx
+     * const { disabled } = useFormControl(itemsArray);
+     *
+     * return <button disabled={disabled} onClick={() => control.push()}>Add</button>;
+     * ```
+     */
+    disabled: boolean;
 }

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

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

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

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

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

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

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

@@ -14,4 +14,11 @@ export interface SignalConfig<K extends string> {
  * Хук для подписки на набор сигналов с кешированием
  * @internal
  */
-export declare function useSignalSubscription<TSignals extends SignalMap, TSnapshot extends ExtractSignalValues<TSignals>>(signals: TSignals, configs: SignalConfig<Extract<keyof TSignals, string>>[], buildSnapshot: (values: ExtractSignalValues<TSignals>) => TSnapshot): TSnapshot;
+export declare function useSignalSubscription<TSignals extends SignalMap, TSnapshot extends ExtractSignalValues<TSignals>>(signals: TSignals, configs: SignalConfig<Extract<keyof TSignals, string>>[], buildSnapshot: (values: ExtractSignalValues<TSignals>) => TSnapshot, 
+/**
+ * Стабильная идентичность подписки (обычно сам узел-контрол). subscribe/getSnapshot
+ * пересоздаются ТОЛЬКО при её смене, а не на каждом рендере — как у useFormControlValue,
+ * который ключует по `[control]`. Это убирает per-render churn (dispose+recreate preact-effect),
+ * сохраняя реактивность при подмене контрола на другой узел.
+ */
+subscriptionKey?: unknown): TSnapshot;

package/dist/form/index.d.ts

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

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

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

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

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

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

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

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

@@ -1,8 +1,8 @@
-import { ReadonlySignal } from '@preact/signals-core';
+import { Signal, ReadonlySignal } from '@preact/signals-core';
 import { FormNode, SetValueOptions } from './form-node';
-import { ValidationError, FieldStatus, FormSchema, GroupNodeConfig, FormValue } from '../types';
+import { ValidationError, FieldStatus, FormSchema, GroupNodeConfig, FormValue } from '../types/index';
 import { FormProxy } from '../types/form-proxy';
-import { SubmitOptions, SubmitResult } from '../utils/form-submitter';
+import { SubmitOptions, SubmitResult } from '../form-submitter';
 /**
  * GroupNode - узел для группы полей
  *
@@ -54,6 +54,18 @@ export declare class GroupNode<T> extends FormNode<T> {
     private readonly _disabled;
     /** Form-level validation errors */
     private readonly _formErrors;
+    /**
+     * M1: валидация уровня модели/схемы (`validateFormModel(model, schema)`). Привязывается
+     * `createForm({ model, schema })`, т.к. под M1 валидаторы срезаны с FieldNode и живут на слое
+     * модели. Без неё `validate()`/`submit()` пропускали бы все schema-валидаторы. @internal
+     */
+    private _modelValidate?;
+    /**
+     * M1: связь листовой ноды-ребёнка → её сигнал модели (тот, что помечает `markDerived`).
+     * Нужна bulk-сеттерам (`setValue`/`patchValue`), чтобы корректно определять derived-поля:
+     * `field.value` — computed-обёртка, отличная от записываемого сигнала модели. @internal
+     */
+    private readonly _fieldSignals;
     readonly value: ReadonlySignal<T>;
     readonly valid: ReadonlySignal<boolean>;
     readonly invalid: ReadonlySignal<boolean>;
@@ -156,7 +168,12 @@ export declare class GroupNode<T> extends FormNode<T> {
      *
      * @param onSubmit - Callback для отправки данных
      * @param options - Опции submit (skipValidation, skipTouch)
-     * @returns Результат от onSubmit или null если валидация не пройдена
+     * @returns Результат от onSubmit или `null` если валидация не пройдена
+     *
+     * @remarks
+     * `null` перегружен: он означает и «валидация не пройдена», и легитимный `null`-результат
+     * `onSubmit` (или void-обработчик). Если вызывающей стороне нужно различать эти случаи —
+     * используйте {@link submitWithResult}, который возвращает явный флаг `success`.
      */
     submit<R>(onSubmit: (values: T) => Promise<R> | R, options?: SubmitOptions): Promise<R | null>;
     /**
@@ -264,6 +281,19 @@ export declare class GroupNode<T> extends FormNode<T> {
      * @internal
      */
     attachBehaviorCleanup(cleanup: () => void): void;
+    /**
+     * Прикрепить валидацию уровня модели/схемы (M1). Вызывается `createForm({ model, schema })`,
+     * чтобы `validate()`/`submit()` прогоняли schema-валидаторы (`validateFormModel`), а не только
+     * пустые FieldNode. Возвращаемый флаг — валидна ли модель по схеме.
+     * @internal
+     */
+    attachModelValidator(validate: () => Promise<boolean>): void;
+    /**
+     * Связать листовую ноду-ребёнка с её сигналом модели (M1). Вызывается `createForm` для каждого
+     * листового поля на его владеющей группе — используется bulk-сеттерами для derived-guard (F9).
+     * @internal
+     */
+    registerFieldSignal(node: FormNode<any>, signal: Signal<unknown>): void;
     /**
      * Очистить все ресурсы узла
      */

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

@@ -1,7 +1,7 @@
 import { Signal, ReadonlySignal } from '@preact/signals-core';
 import { FormNode } from './form-node';
-import { FieldStatus, ValidationError } from '../types';
-import { FormModel } from '../model/types';
+import { FieldStatus, ValidationError } from '../types/index';
+import { FormModel } from '../../state/types';
 import { FormProxy } from '../types/form-proxy';
 /** Минимальный контракт реактивного массива модели, используемый узлом. */
 export interface ModelArrayControl<TItem extends object> {
@@ -58,6 +58,7 @@ export declare class ModelArrayNode<T extends object> extends FormNode<T[]> {
     private readonly buildItem;
     private readonly itemNodes;
     private readonly cache;
+    private mountedModels;
     private readonly initial;
     private readonly _arrayErrors;
     private readonly disposeSync;
@@ -109,6 +110,12 @@ export declare class ModelArrayNode<T extends object> extends FormNode<T[]> {
     protected onMarkAsPristine(): void;
     protected onDisable(): void;
     protected onEnable(): void;
-    /** Очистка подписки синхронизации. */
+    /** Диспозит форму элемента (эффекты/поведения/вложенные подписки); терпима к не-GroupNode. */
+    private disposeItemNode;
+    /**
+     * Очистка подписки синхронизации И детерминированный teardown всех форм элементов.
+     * Без пробрасывания dispose в itemNodes эффекты/поведения каждой формы элемента (в т.ч. disposeSync
+     * вложенных ModelArrayNode) остались бы жить после teardown формы — утечка подписок.
+     */
     dispose(): void;
 }

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

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

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

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

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

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

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

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

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

@@ -37,6 +37,27 @@ export interface FieldConfig<T> {
     /** Задержка (в мс) перед запуском асинхронной валидации */
     debounce?: number;
 }
+/**
+ * «Хотя бы одно поле обязано присутствовать»: превращает объект со всеми опциональными
+ * свойствами в объединение вариантов, где ровно один ключ обязателен, а остальные опциональны.
+ * Пустой объект `{}` не assignable ни к одному варианту и потому отклоняется.
+ *
+ * @internal
+ */
+type RequireAtLeastOne<T> = {
+    [K in keyof T]-?: Required<Pick<T, K>> & Partial<Omit<T, K>>;
+}[keyof T];
+/**
+ * {@link FieldConfig}, из которого нельзя сделать пустой `{}`.
+ *
+ * Все свойства {@link FieldConfig} опциональны, поэтому в {@link FormSchema} опечатка вида
+ * `{ email: {} }` молча проходит проверку типов и в рантайме становится пустой подгруппой
+ * вместо поля. `NonEmptyFieldConfig` требует наличия хотя бы одного свойства (value/valueSignal/
+ * component/validators/…), оставляя каждое из них опциональным по отдельности.
+ *
+ * @internal
+ */
+type NonEmptyFieldConfig<T> = RequireAtLeastOne<FieldConfig<T>>;
 /**
  * Конфигурация массива
  * @group Types
@@ -90,5 +111,6 @@ export interface ArrayConfig<T extends object> {
  * ```
  */
 export type FormSchema<T> = {
-    [K in keyof T]: NonNullable<T[K]> extends string | number | boolean ? FieldConfig<T[K]> : NonNullable<T[K]> extends Array<infer U> ? U extends string | number | boolean ? FieldConfig<T[K]> : U extends Date | File | Blob | AnyFunction ? FieldConfig<T[K]> : [FormSchema<U>] : NonNullable<T[K]> extends Date | File | Blob | AnyFunction ? FieldConfig<T[K]> : FormSchema<NonNullable<T[K]>>;
+    [K in keyof T]: NonNullable<T[K]> extends string | number | boolean ? NonEmptyFieldConfig<T[K]> : NonNullable<T[K]> extends Array<infer U> ? U extends string | number | boolean ? NonEmptyFieldConfig<T[K]> : U extends Date | File | Blob | AnyFunction ? NonEmptyFieldConfig<T[K]> : [FormSchema<U>] : NonNullable<T[K]> extends Date | File | Blob | AnyFunction ? NonEmptyFieldConfig<T[K]> : FormSchema<NonNullable<T[K]>>;
 };
+export {};

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

@@ -64,8 +64,33 @@ export type FormControlsProxy<T> = {
  * form.email.setValue('test@mail.com');
  * form.profile.name.setValue('John');
  * ```
+ *
+ * @remarks
+ * **Зарезервированные имена.** Прямой доступ `form.<name>` отдаёт приоритет собственным
+ * членам {@link GroupNode} (`value`, `status`, `id`, `errors`, `disabled`, `reset`, `submit`, …).
+ * Поэтому поле модели, названное любым из этих имён, недостижимо как `form.<name>` — там будет
+ * агрегированный сигнал/метод узла, а не {@link FieldNode}. Такие имена исключены из полевого
+ * пространства имён на уровне типов (через `Omit<…, keyof GroupNode>`), чтобы затенение не
+ * компилировалось молча. Для доступа к любому полю по имени — включая затенённые — используйте
+ * escape-hatch пространство {@link FormProxy.$}: `form.$.status`, `form.$.id`, `form.$.value`.
  */
-export type FormProxy<T> = GroupNode<T> & FormControlsProxy<T>;
+export type FormProxy<T> = GroupNode<T> & Omit<FormControlsProxy<T>, keyof GroupNode<T>> & {
+    /**
+     * Escape-hatch пространство имён «controls»: типобезопасный доступ ко ВСЕМ полям формы
+     * по имени, включая поля, чьи имена совпадают с членами {@link GroupNode}
+     * (`value`/`status`/`id`/`errors`/…), недостижимые через `form.<name>`.
+     *
+     * @example
+     * ```typescript
+     * // модель: { status: string; email: string }
+     * form.status;      // ReadonlySignal<FieldStatus> — агрегат GroupNode (не поле!)
+     * form.$.status;    // FieldNode<string> — поле пользователя
+     * form.$.status.setValue('active');
+     * form.$.email;     // FieldNode<string> — так же доступны и незатенённые поля
+     * ```
+     */
+    readonly $: FormControlsProxy<T>;
+};
 /**
  * Комбинированный тип для ArrayNode с Proxy доступом к элементам
  *

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

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

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

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