@reformer/core 1.1.0-beta.8 → 2.0.0-beta.2

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

@@ -15,7 +15,6 @@ import { FormNode, type SetValueOptions } from './form-node';
 import type { ValidationError, FieldStatus, ValidationSchemaFn, ValidatorRegistration, FormSchema, GroupNodeConfig, FormValue } from '../types';
 import type { GroupNodeWithControls } from '../types/group-node-proxy';
 import type { BehaviorSchemaFn } from '../behavior/types';
-import { FieldRegistry } from './group-node/field-registry';
 /**
  * GroupNode - узел для группы полей
  *
@@ -59,65 +58,43 @@ import { FieldRegistry } from './group-node/field-registry';
 export declare class GroupNode<T> extends FormNode<T> {
     id: string;
     /**
-     * Реестр полей формы
-     * Использует FieldRegistry для инкапсуляции логики управления коллекцией полей
+     * Коллекция полей формы (упрощённый Map вместо FieldRegistry)
      */
-    private fieldRegistry;
-    /**
-     * Строитель Proxy для типобезопасного доступа к полям
-     * Использует ProxyBuilder для создания Proxy с расширенной функциональностью
-     */
-    private proxyBuilder;
-    /**
-     * Менеджер состояния формы
-     * Инкапсулирует всю логику создания и управления сигналами состояния
-     * Извлечен из GroupNode для соблюдения SRP
-     */
-    private stateManager;
+    private readonly _fields;
     /**
      * Менеджер подписок для централизованного cleanup
-     * Использует SubscriptionManager вместо массива для управления подписками
      */
     private disposers;
     /**
      * Ссылка на Proxy-инстанс для использования в BehaviorContext
-     * Устанавливается в конструкторе до применения behavior schema
      */
     private _proxyInstance?;
     /**
      * Навигатор для работы с путями к полям
-     * Использует композицию вместо дублирования логики парсинга путей
      */
     private readonly pathNavigator;
     /**
      * Фабрика для создания узлов формы
-     * Использует композицию для централизованного создания FieldNode/GroupNode/ArrayNode
      */
     private readonly nodeFactory;
     /**
      * Реестр валидаторов для этой формы
-     * Использует композицию вместо глобального Singleton
-     * Обеспечивает полную изоляцию форм друг от друга
      */
     private readonly validationRegistry;
     /**
      * Реестр behaviors для этой формы
-     * Использует композицию вместо глобального Singleton
-     * Обеспечивает полную изоляцию форм друг от друга
      */
     private readonly behaviorRegistry;
     /**
      * Аппликатор для применения валидаторов к форме
-     * Извлечен из GroupNode для соблюдения SRP
-     * Использует композицию для управления процессом валидации
      */
     private readonly validationApplicator;
-    /**
-     * Аппликатор для применения behavior схемы к форме
-     * Извлечен из GroupNode для соблюдения SRP
-     * Использует композицию для управления процессом применения behaviors
-     */
-    private readonly behaviorApplicator;
+    /** Флаг отправки формы */
+    private readonly _submitting;
+    /** Флаг disabled состояния */
+    private readonly _disabled;
+    /** Form-level validation errors */
+    private readonly _formErrors;
     readonly value: ReadonlySignal<T>;
     readonly valid: ReadonlySignal<boolean>;
     readonly invalid: ReadonlySignal<boolean>;
@@ -135,6 +112,10 @@ export declare class GroupNode<T> extends FormNode<T> {
      * Создать GroupNode с полной конфигурацией (form, behavior, validation)
      */
     constructor(config: GroupNodeConfig<T>);
+    /**
+     * Создать Proxy для типобезопасного доступа к полям
+     */
+    private buildProxy;
     getValue(): T;
     setValue(value: T, options?: SetValueOptions): void;
     patchValue(value: Partial<T>): void;
@@ -158,50 +139,11 @@ export declare class GroupNode<T> extends FormNode<T> {
     reset(value?: T): void;
     /**
      * Сбросить форму к исходным значениям (initialValues)
-     *
-     * @remarks
-     * Рекурсивно вызывает resetToInitial() для всех полей формы.
-     * Более явный способ сброса к начальным значениям по сравнению с reset()
-     *
-     * Полезно когда:
-     * - Пользователь нажал "Cancel" - полная отмена изменений
-     * - Форма была изменена через reset(newValues), но нужно вернуться к самому началу
-     * - Явное намерение показать "отмена всех изменений"
-     *
-     * @example
-     * ```typescript
-     * const form = new GroupNode({
-     *   email: { value: 'initial@mail.com', component: Input },
-     *   name: { value: 'John', component: Input }
-     * });
-     *
-     * form.email.setValue('changed@mail.com');
-     * form.reset({ email: 'temp@mail.com', name: 'Jane' });
-     * console.log(form.getValue()); // { email: 'temp@mail.com', name: 'Jane' }
-     *
-     * form.resetToInitial();
-     * console.log(form.getValue()); // { email: 'initial@mail.com', name: 'John' }
-     * ```
      */
     resetToInitial(): void;
     validate(): Promise<boolean>;
     /**
      * Установить form-level validation errors
-     * Используется для server-side validation или кросс-полевых ошибок
-     *
-     * @param errors - массив ошибок уровня формы
-     *
-     * @example
-     * ```typescript
-     * // Server-side validation после submit
-     * try {
-     *   await api.createUser(form.getValue());
-     * } catch (error) {
-     *   form.setErrors([
-     *     { code: 'duplicate_email', message: 'Email уже используется' }
-     *   ]);
-     * }
-     * ```
      */
     setErrors(errors: ValidationError[]): void;
     /**
@@ -210,29 +152,12 @@ export declare class GroupNode<T> extends FormNode<T> {
     clearErrors(): void;
     /**
      * Получить поле по ключу
-     *
-     * Публичный метод для доступа к полю из fieldRegistry
-     *
-     * @param key - Ключ поля
-     * @returns FormNode или undefined, если поле не найдено
-     *
-     * @example
-     * ```typescript
-     * const emailField = form.getField('email');
-     * if (emailField) {
-     *   console.log(emailField.value.value);
-     * }
-     * ```
      */
     getField<K extends keyof T>(key: K): FormNode<T[K]> | undefined;
     /**
-     * Получить Map всех полей формы
-     *
-     * Используется в FieldPathNavigator для навигации по полям
-     *
-     * @returns Map полей формы
+     * Получить Map всех полей формы (для совместимости)
      */
-    get fields(): FieldRegistry<T>;
+    get fields(): Map<keyof T, FormNode<FormValue>>;
     /**
      * Получить Proxy-инстанс для прямого доступа к полям
      *
@@ -262,47 +187,14 @@ export declare class GroupNode<T> extends FormNode<T> {
     getProxy(): GroupNodeWithControls<T>;
     /**
      * Получить все поля формы как итератор
-     *
-     * Предоставляет доступ к внутренним полям для валидации и других операций
-     *
-     * @returns Итератор по всем полям формы
-     *
-     * @example
-     * ```typescript
-     * // Валидация всех полей
-     * await Promise.all(
-     *   Array.from(form.getAllFields()).map(field => field.validate())
-     * );
-     * ```
      */
     getAllFields(): IterableIterator<FormNode<FormValue>>;
-    /**
-     * Hook: вызывается после markAsTouched()
-     *
-     * Для GroupNode: рекурсивно помечаем все дочерние поля как touched
-     */
     protected onMarkAsTouched(): void;
-    /**
-     * Hook: вызывается после markAsUntouched()
-     *
-     * Для GroupNode: рекурсивно помечаем все дочерние поля как untouched
-     */
     protected onMarkAsUntouched(): void;
-    /**
-     * Hook: вызывается после markAsDirty()
-     *
-     * Для GroupNode: рекурсивно помечаем все дочерние поля как dirty
-     */
     protected onMarkAsDirty(): void;
-    /**
-     * Hook: вызывается после markAsPristine()
-     *
-     * Для GroupNode: рекурсивно помечаем все дочерние поля как pristine
-     */
     protected onMarkAsPristine(): void;
     /**
      * Отправить форму
-     * Валидирует форму и вызывает onSubmit если форма валидна
      */
     submit<R>(onSubmit: (values: T) => Promise<R> | R): Promise<R | null>;
     /**
@@ -314,41 +206,7 @@ export declare class GroupNode<T> extends FormNode<T> {
     applyValidationSchema(schemaFn: ValidationSchemaFn<T>): void;
     /**
      * Применить behavior schema к форме
-     *
-     * ✅ РЕФАКТОРИНГ: Делегирование BehaviorApplicator (SRP)
-     *
-     * Логика применения behavior схемы извлечена в BehaviorApplicator для:
-     * - Соблюдения Single Responsibility Principle
-     * - Уменьшения размера GroupNode (~50 строк)
-     * - Улучшения тестируемости
-     * - Консистентности с ValidationApplicator
-     *
-     * @param schemaFn Функция описания поведения формы
      * @returns Функция cleanup для отписки от всех behaviors
-     *
-     * @example
-     * ```typescript
-     * import { copyFrom, enableWhen, computeFrom } from '@/lib/forms/core/behaviors';
-     *
-     * const behaviorSchema: BehaviorSchemaFn<MyForm> = (path) => {
-     *   copyFrom(path.residenceAddress, path.registrationAddress, {
-     *     when: (form) => form.sameAsRegistration === true
-     *   });
-     *
-     *   enableWhen(path.propertyValue, (form) => form.loanType === 'mortgage');
-     *
-     *   computeFrom(
-     *     path.initialPayment,
-     *     [path.propertyValue],
-     *     (propertyValue) => propertyValue ? propertyValue * 0.2 : null
-     *   );
-     * };
-     *
-     * const cleanup = form.applyBehaviorSchema(behaviorSchema);
-     *
-     * // Cleanup при unmount
-     * useEffect(() => cleanup, []);
-     * ```
      */
     applyBehaviorSchema(schemaFn: BehaviorSchemaFn<T>): () => void;
     /**
@@ -412,29 +270,6 @@ export declare class GroupNode<T> extends FormNode<T> {
     private createNode;
     /**
      * Связывает два поля: при изменении source автоматически обновляется target
-     * Поддерживает опциональную трансформацию значения
-     *
-     * @param sourceKey - Ключ поля-источника
-     * @param targetKey - Ключ поля-цели
-     * @param transform - Опциональная функция трансформации значения
-     * @returns Функция отписки для cleanup
-     *
-     * @example
-     * ```typescript
-     * // Автоматический расчет минимального взноса от стоимости недвижимости
-     * const dispose = form.linkFields(
-     *   'propertyValue',
-     *   'initialPayment',
-     *   (propertyValue) => propertyValue ? propertyValue * 0.2 : null
-     * );
-     *
-     * // При изменении propertyValue → автоматически обновится initialPayment
-     * form.propertyValue.setValue(1000000);
-     * // initialPayment станет 200000
-     *
-     * // Cleanup
-     * useEffect(() => dispose, []);
-     * ```
      */
     linkFields<K1 extends keyof T, K2 extends keyof T>(sourceKey: K1, targetKey: K2, transform?: (value: T[K1]) => T[K2]): () => void;
     /**
@@ -467,28 +302,14 @@ export declare class GroupNode<T> extends FormNode<T> {
     watchField<K extends keyof T>(fieldPath: K extends string ? K : string, callback: (value: T[K]) => void | Promise<void>): () => void;
     /**
      * Hook: вызывается после disable()
-     *
-     * Для GroupNode: рекурсивно отключаем все дочерние поля
      */
     protected onDisable(): void;
     /**
      * Hook: вызывается после enable()
-     *
-     * Для GroupNode: рекурсивно включаем все дочерние поля
      */
     protected onEnable(): void;
     /**
      * Очистить все ресурсы узла
-     * Рекурсивно очищает все subscriptions и дочерние узлы
-     *
-     * @example
-     * ```typescript
-     * useEffect(() => {
-     *   return () => {
-     *     form.dispose();
-     *   };
-     * }, []);
-     * ```
      */
     dispose(): void;
 }

package/dist/core/utils/field-path.d.ts

@@ -0,0 +1,48 @@
+/**
+ * FieldPath proxy - типобезопасный доступ к путям полей формы
+ *
+ * Единый модуль для validation и behavior схем.
+ * Предоставляет типизированную навигацию по структуре формы.
+ *
+ * @module utils/field-path
+ */
+import type { FieldPath, FieldPathNode } from '../types';
+/**
+ * Создать FieldPath proxy для формы
+ *
+ * @example
+ * ```typescript
+ * const path = createFieldPath<MyForm>();
+ * console.log(path.email.__path); // 'email'
+ * console.log(path.personalData.firstName.__path); // 'personalData.firstName'
+ * ```
+ */
+export declare function createFieldPath<T>(): FieldPath<T>;
+/**
+ * Извлечь путь из FieldPathNode
+ */
+export declare function extractPath(node: FieldPathNode<unknown, unknown> | unknown): string;
+/**
+ * Преобразовать FieldPathNode в FieldPath для переиспользования схем
+ *
+ * Позволяет композировать validation schemas:
+ *
+ * @example
+ * ```typescript
+ * const personalDataValidation = (path: FieldPath<PersonalData>) => {
+ *   required(path.firstName, { message: 'Имя обязательно' });
+ *   required(path.lastName, { message: 'Фамилия обязательна' });
+ * };
+ *
+ * const mainValidation = (path: FieldPath<MyForm>) => {
+ *   //  Переиспользуем схему
+ *   personalDataValidation(toFieldPath(path.personalData));
+ *   required(path.email);
+ * };
+ * ```
+ */
+export declare function toFieldPath<T>(node: FieldPathNode<unknown, T, never> | FieldPathNode<any, T, any>): FieldPath<T>;
+/**
+ * Извлечь ключ поля из FieldPathNode
+ */
+export declare function extractKey(node: FieldPathNode<unknown, unknown> | unknown): string;

package/dist/core/utils/index.d.ts

@@ -4,6 +4,7 @@
  * Централизованные вспомогательные классы и функции.
  */
 export { FieldPathNavigator, type PathSegment } from './field-path-navigator';
+export { createFieldPath, extractPath, extractKey, toFieldPath } from './field-path';
 export { SubscriptionManager } from './subscription-manager';
 export { getCurrentValidationRegistry, getCurrentBehaviorRegistry } from './registry-helpers';
 export { RegistryStack } from './registry-stack';

package/dist/core/validation/field-path.d.ts

@@ -1,43 +1,7 @@
 /**
  * FieldPath proxy - типобезопасный доступ к путям полей формы
- */
-import type { FieldPath, FieldPathNode } from '../types';
-/**
- * Создать FieldPath proxy для формы
  *
- * @example
- * ```typescript
- * const path = createFieldPath<MyForm>();
- * console.log(path.email.__path); // 'email'
- * console.log(path.personalData.firstName.__path); // 'personalData.firstName'
- * ```
- */
-export declare function createFieldPath<T>(): FieldPath<T>;
-/**
- * Извлечь путь из FieldPathNode
- */
-export declare function extractPath(node: FieldPathNode<unknown, unknown> | unknown): string;
-/**
- * Преобразовать FieldPathNode в FieldPath для переиспользования схем
- *
- * Позволяет композировать validation schemas:
- *
- * @example
- * ```typescript
- * const personalDataValidation = (path: FieldPath<PersonalData>) => {
- *   required(path.firstName, { message: 'Имя обязательно' });
- *   required(path.lastName, { message: 'Фамилия обязательна' });
- * };
- *
- * const mainValidation = (path: FieldPath<MyForm>) => {
- *   //  Переиспользуем схему
- *   personalDataValidation(toFieldPath(path.personalData));
- *   required(path.email);
- * };
- * ```
- */
-export declare function toFieldPath<T>(node: FieldPathNode<unknown, T, never> | FieldPathNode<any, T, any>): FieldPath<T>;
-/**
- * Извлечь ключ поля из FieldPathNode
+ * @deprecated Импортируйте из '../utils/field-path' напрямую.
+ * Этот файл оставлен для обратной совместимости.
  */
-export declare function extractKey(node: FieldPathNode<unknown, unknown> | unknown): string;
+export { createFieldPath, extractPath, extractKey, toFieldPath } from '../utils/field-path';

package/dist/core/validation/validation-context.d.ts

@@ -45,3 +45,26 @@ export declare class TreeValidationContextImpl<TForm> implements FormContext<TFo
      */
     setFieldValue(path: string, value: unknown): void;
 }
+/**
+ * Реализация контекста валидации для ArrayNode
+ * Позволяет валидаторам типа notEmpty работать с массивами
+ */
+export declare class ArrayValidationContextImpl<TForm, TItem> implements FormContext<TForm> {
+    private _form;
+    private arrayValue;
+    /**
+     * Форма с типизированным Proxy-доступом к полям
+     */
+    readonly form: GroupNodeWithControls<TForm>;
+    constructor(form: GroupNode<TForm>, _fieldKey: keyof TForm, arrayValue: TItem[]);
+    /**
+     * Получить текущее значение массива (для валидатора)
+     * @internal
+     */
+    value(): TItem[];
+    /**
+     * Безопасно установить значение поля по строковому пути
+     * Автоматически использует emitEvent: false для предотвращения циклов
+     */
+    setFieldValue(path: string, value: unknown): void;
+}