@reformer/core 1.0.0-beta.3

package/dist/core/behavior/compose-behavior.js

@@ -0,0 +1,166 @@
+/**
+ * Композиция behavior схем
+ *
+ * Предоставляет функции для переиспользования behavior схем:
+ * - toBehaviorFieldPath: преобразование FieldPath во вложенный путь
+ * - apply: применение схемы к полям
+ * - applyWhen: условное применение схемы
+ *
+ * Аналог toFieldPath и applyWhen из validation API.
+ */
+import { createFieldPath } from './create-field-path';
+import { watchField } from './behaviors/watch-field';
+// ============================================================================
+// toBehaviorFieldPath - Преобразование FieldPath во вложенный путь
+// ============================================================================
+/**
+ * Преобразовать FieldPath во вложенный путь для композиции behavior схем
+ *
+ * Аналог toFieldPath из validation API.
+ *
+ * @param fieldPath - Поле для преобразования
+ * @returns Вложенный FieldPath
+ *
+ * @example
+ * ```typescript
+ * // address-behavior.ts
+ * export const addressBehavior = (path: FieldPath<Address>) => {
+ *   watchField(path.country, async (country, ctx) => {
+ *     const regions = await fetchRegions(country);
+ *     ctx.updateComponentProps(path.region, { options: regions });
+ *   });
+ * };
+ *
+ * // user-behavior.ts
+ * export const userBehavior = (path: FieldPath<User>) => {
+ *   // Композиция: применяем addressBehavior к вложенному полю
+ *   addressBehavior(toBehaviorFieldPath(path.address));
+ * };
+ * ```
+ */
+export function toBehaviorFieldPath(fieldPath) {
+    if (!fieldPath) {
+        return createFieldPath();
+    }
+    const basePath = fieldPath.__path;
+    return createNestedBehaviorFieldPath(basePath);
+}
+/**
+ * Создать вложенный FieldPath с базовым префиксом
+ * @private
+ */
+function createNestedBehaviorFieldPath(basePath) {
+    return new Proxy({}, {
+        get(_target, prop) {
+            if (typeof prop === 'symbol')
+                return undefined;
+            const fullPath = basePath ? `${basePath}.${prop}` : prop;
+            return {
+                __path: fullPath,
+                __key: prop,
+            };
+        },
+    });
+}
+// ============================================================================
+// apply - Применение behavior схемы к полям
+// ============================================================================
+/**
+ * Применить behavior схему к вложенному полю или полям
+ *
+ * Поддерживает:
+ * - Одно поле или массив полей
+ * - Одну схему или массив схем
+ * - Все комбинации (поле + схема, поле + схемы, поля + схема, поля + схемы)
+ *
+ * @param fields - Одно поле или массив полей
+ * @param behaviors - Одна схема или массив схем
+ *
+ * @example
+ * ```typescript
+ * // Одна схема к одному полю
+ * apply(path.registrationAddress, addressBehavior);
+ *
+ * // Одна схема к нескольким полям
+ * apply([path.registrationAddress, path.residenceAddress], addressBehavior);
+ *
+ * // Несколько схем к одному полю
+ * apply(path.properties, [propertyBehavior, arrayBehavior]);
+ *
+ * // Несколько схем к нескольким полям
+ * apply(
+ *   [path.registrationAddress, path.residenceAddress],
+ *   [addressBehavior, validationBehavior]
+ * );
+ * ```
+ */
+export function apply(fields, behaviors) {
+    // Нормализуем inputs в массивы
+    const fieldArray = (Array.isArray(fields) ? fields : [fields]).filter(Boolean);
+    const behaviorArray = Array.isArray(behaviors) ? behaviors : [behaviors];
+    // Применяем все схемы ко всем полям
+    for (const field of fieldArray) {
+        const nestedPath = toBehaviorFieldPath(field);
+        for (const behavior of behaviorArray) {
+            behavior(nestedPath);
+        }
+    }
+}
+// ============================================================================
+// applyWhen - Условное применение behavior схемы
+// ============================================================================
+/**
+ * Условное применение behavior схем (аналог applyWhen из validation API)
+ *
+ * ⚠️ ВАЖНО: Эта функция НЕ создаёт новые behaviors при каждом изменении условия!
+ * Вместо этого behaviors регистрируются ОДИН РАЗ при первом вызове и затем
+ * просто не выполняются, если условие не выполнено.
+ *
+ * Это отличается от старой реализации, которая создавала утечку памяти,
+ * регистрируя behaviors при каждом изменении conditionField.
+ *
+ * @param conditionField - Поле для проверки условия
+ * @param condition - Функция проверки условия
+ * @param callback - Callback для применения behavior схем
+ *
+ * @example
+ * ```typescript
+ * // Применить addressBehavior только когда sameAsRegistration === false
+ * applyWhen(
+ *   path.sameAsRegistration,
+ *   (value) => value === false,
+ *   (path) => {
+ *     apply(path.residenceAddress, addressBehavior);
+ *   }
+ * );
+ *
+ * // Или с прямым использованием path
+ * applyWhen(
+ *   path.hasProperty,
+ *   (value) => value === true,
+ *   (path) => {
+ *     apply(path.properties, propertyBehavior);
+ *     // Можно применить несколько схем
+ *     apply([path.properties, path.items], arrayBehavior);
+ *   }
+ * );
+ * ```
+ */
+export function applyWhen(conditionField, condition, callback) {
+    if (!conditionField)
+        return;
+    //  ИСПРАВЛЕНО: Регистрируем behaviors только ОДИН РАЗ
+    // вне watchField callback, чтобы избежать утечки памяти
+    let hasRegistered = false;
+    watchField(conditionField, (value, _ctx) => {
+        // Регистрируем behaviors только при первом срабатывании
+        // когда условие выполнено
+        if (!hasRegistered && condition(value)) {
+            const fieldPath = createFieldPath();
+            callback(fieldPath);
+            hasRegistered = true;
+        }
+        // TODO: В будущем можно добавить поддержку деактивации behaviors
+        // при изменении условия, но это требует изменений в BehaviorRegistry
+    }, { immediate: true });
+}

package/dist/core/behavior/create-field-path.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Создание типизированного FieldPath для Behavior Schema
+ * Аналогично createFieldPath из validators
+ */
+import type { FieldPath } from '../types';
+/**
+ * Создать типизированный путь к полям формы
+ * Используется для декларативного описания behavior схем
+ *
+ * @example
+ * ```typescript
+ * const schema: BehaviorSchemaFn<MyForm> = (path) => {
+ *   // path.email, path.address.city и т.д. - типизированы
+ *   copyFrom(path.residenceAddress, path.registrationAddress, {
+ *     when: (form) => form.sameAsRegistration
+ *   });
+ * };
+ * ```
+ */
+export declare function createFieldPath<T>(): FieldPath<T>;

package/dist/core/behavior/create-field-path.js

@@ -0,0 +1,69 @@
+/**
+ * Создание типизированного FieldPath для Behavior Schema
+ * Аналогично createFieldPath из validators
+ */
+/**
+ * Создать типизированный путь к полям формы
+ * Используется для декларативного описания behavior схем
+ *
+ * @example
+ * ```typescript
+ * const schema: BehaviorSchemaFn<MyForm> = (path) => {
+ *   // path.email, path.address.city и т.д. - типизированы
+ *   copyFrom(path.residenceAddress, path.registrationAddress, {
+ *     when: (form) => form.sameAsRegistration
+ *   });
+ * };
+ * ```
+ */
+export function createFieldPath() {
+    return createFieldPathProxy('');
+}
+/**
+ * Создать Proxy для вложенного доступа к полям
+ * @private
+ */
+function createFieldPathProxy(currentPath) {
+    return new Proxy(
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    {}, {
+        get(__target, prop) {
+            // Поддержка обоих вариантов для обратной совместимости
+            if (prop === '__path' || prop === '__fieldPath') {
+                return currentPath || prop;
+            }
+            if (prop === '__key') {
+                const parts = currentPath.split('.');
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return (parts[parts.length - 1] || prop);
+            }
+            const newPath = currentPath ? `${currentPath}.${prop}` : prop;
+            // Создаем объект FieldPathNode с вложенным Proxy
+            const node = {
+                __path: newPath,
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                __key: prop,
+                __formType: undefined,
+                __fieldType: undefined,
+            };
+            // Возвращаем Proxy, который поддерживает дальнейшую вложенность
+            return new Proxy(node, {
+                get(_target, nestedProp) {
+                    // Поддержка обоих вариантов для обратной совместимости
+                    if (nestedProp === '__path' || nestedProp === '__fieldPath') {
+                        return newPath;
+                    }
+                    if (nestedProp === '__key') {
+                        return prop;
+                    }
+                    if (nestedProp === '__formType' || nestedProp === '__fieldType') {
+                        return undefined;
+                    }
+                    // Для вложенных свойств создаем новый Proxy
+                    const nestedPath = `${newPath}.${nestedProp}`;
+                    return createFieldPathProxy(nestedPath);
+                },
+            });
+        },
+    });
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Behavior Schema API - Декларативное описание реактивного поведения форм
+ *
+ * @group Behaviors
+ * @module behaviors
+ */
+export type { BehaviorSchemaFn, BehaviorContext, BehaviorHandlerFn, BehaviorOptions, CopyFromOptions, EnableWhenOptions, ComputeFromOptions, WatchFieldOptions, RevalidateWhenOptions, SyncFieldsOptions, } from './types';
+export * from './behaviors';
+export { apply, applyWhen, toBehaviorFieldPath } from './compose-behavior';
+export { BehaviorRegistry } from './behavior-registry';
+export { BehaviorContextImpl } from './behavior-context';
+export { createFieldPath } from './create-field-path';

package/dist/core/behavior/index.js

@@ -0,0 +1,17 @@
+/**
+ * Behavior Schema API - Декларативное описание реактивного поведения форм
+ *
+ * @group Behaviors
+ * @module behaviors
+ */
+// Функции для декларативного описания поведения
+// Behaviors
+export * from './behaviors';
+// Композиция behavior схем (аналог toFieldPath из validation API)
+export { apply, applyWhen, toBehaviorFieldPath } from './compose-behavior';
+// Вспомогательные классы и функции
+// Примечание: BehaviorRegistry (глобальный singleton) был удален в пользу
+// локальных экземпляров BehaviorRegistry в каждом GroupNode
+export { BehaviorRegistry } from './behavior-registry';
+export { BehaviorContextImpl } from './behavior-context';
+export { createFieldPath } from './create-field-path';

package/dist/core/behavior/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Типы и интерфейсы для Behavior Schema API
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+import { GroupNode } from '../nodes/group-node';
+import type { FieldPath } from '../types/field-path';
+import type { FormContext } from '../types/form-context';
+/**
+ * Тип функции behavior схемы
+ * Принимает FieldPath и описывает поведение формы
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export type BehaviorSchemaFn<T> = (path: FieldPath<T>) => void;
+/**
+ * Контекст для behavior callback функций
+ * Алиас для FormContext
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ *
+ * @example
+ * ```typescript
+ * watchField(path.country, async (country, ctx) => {
+ *   // Прямой типизированный доступ к полям
+ *   const cities = await fetchCities(country);
+ *   ctx.form.city.updateComponentProps({ options: cities });
+ *
+ *   // Безопасная установка значения (без циклов)
+ *   ctx.setFieldValue('city', null);
+ * });
+ * ```
+ */
+export type BehaviorContext<TForm> = FormContext<TForm>;
+/**
+ * Функция-handler для behavior
+ *
+ * Создает effect подписку для реактивного поведения формы.
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ *
+ * @template TForm - Тип формы
+ * @param form - Корневой узел формы (GroupNode)
+ * @param context - Контекст для работы с формой
+ * @param withDebounce - Функция-обертка для debounce
+ * @returns Функция cleanup для отписки от effect или null
+ *
+ * @example
+ * ```typescript
+ * const handler: BehaviorHandlerFn<MyForm> = (form, context, withDebounce) => {
+ *   const sourceNode = form.getFieldByPath('email');
+ *
+ *   return effect(() => {
+ *     const value = sourceNode.value.value;
+ *     withDebounce(() => {
+ *       // Логика behavior
+ *     });
+ *   });
+ * };
+ * ```
+ */
+export type BehaviorHandlerFn<TForm> = (form: GroupNode<TForm>, context: BehaviorContext<TForm>, withDebounce: (callback: () => void) => void) => (() => void) | null;
+/**
+ * Общие опции для behavior
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export interface BehaviorOptions {
+    /** Debounce в миллисекундах */
+    debounce?: number;
+}
+/**
+ * Опции для copyFrom
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export interface CopyFromOptions<TSource, TForm = unknown> {
+    /** Условие копирования */
+    when?: (form: TForm) => boolean;
+    /** Какие поля копировать (для групп) */
+    fields?: (keyof TSource)[] | 'all';
+    /** Трансформация значения */
+    transform?: (value: TSource) => unknown;
+    /** Debounce в мс */
+    debounce?: number;
+}
+/**
+ * Опции для enableWhen/disableWhen
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export interface EnableWhenOptions {
+    /** Сбросить значение при disable */
+    resetOnDisable?: boolean;
+    /** Debounce в мс */
+    debounce?: number;
+}
+/**
+ * Опции для computeFrom
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export interface ComputeFromOptions<TForm> {
+    /** Когда вычислять */
+    trigger?: 'change' | 'blur';
+    /** Debounce в мс */
+    debounce?: number;
+    /** Условие применения */
+    condition?: (form: TForm) => boolean;
+}
+/**
+ * Опции для watchField
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export interface WatchFieldOptions {
+    /** Debounce в мс */
+    debounce?: number;
+    /** Вызвать сразу при инициализации */
+    immediate?: boolean;
+}
+/**
+ * Опции для revalidateWhen
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export interface RevalidateWhenOptions {
+    /** Debounce в мс */
+    debounce?: number;
+}
+/**
+ * Опции для syncFields
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export interface SyncFieldsOptions<T> {
+    /** Трансформация значения */
+    transform?: (value: T) => T;
+    /** Debounce в мс */
+    debounce?: number;
+}

package/dist/core/behavior/types.js

@@ -0,0 +1,7 @@
+/**
+ * Типы и интерфейсы для Behavior Schema API
+ *
+ * @group Behaviors
+ * @category Behavior Types
+ */
+export {};

package/dist/core/context/form-context-impl.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Реализация единого FormContext
+ *
+ * Используется как базовая реализация для behavior и validation контекстов
+ */
+import type { GroupNode } from '../nodes/group-node';
+import type { FormContext } from '../types/form-context';
+import type { GroupNodeWithControls } from '../types/group-node-proxy';
+/**
+ * Базовая реализация FormContext
+ *
+ * Предоставляет:
+ * - `form` - типизированный Proxy-доступ к форме
+ * - `setFieldValue` - безопасная установка значения (emitEvent: false)
+ */
+export declare class FormContextImpl<TForm> implements FormContext<TForm> {
+    /**
+     * Форма с типизированным Proxy-доступом к полям
+     */
+    readonly form: GroupNodeWithControls<TForm>;
+    protected readonly _groupNode: GroupNode<TForm>;
+    constructor(groupNode: GroupNode<TForm>);
+    /**
+     * Безопасно установить значение поля по строковому пути
+     *
+     * Автоматически использует emitEvent: false для предотвращения циклов
+     */
+    setFieldValue(path: string, value: unknown): void;
+}

package/dist/core/context/form-context-impl.js

@@ -0,0 +1,37 @@
+/**
+ * Реализация единого FormContext
+ *
+ * Используется как базовая реализация для behavior и validation контекстов
+ */
+/**
+ * Базовая реализация FormContext
+ *
+ * Предоставляет:
+ * - `form` - типизированный Proxy-доступ к форме
+ * - `setFieldValue` - безопасная установка значения (emitEvent: false)
+ */
+export class FormContextImpl {
+    /**
+     * Форма с типизированным Proxy-доступом к полям
+     */
+    form;
+    _groupNode;
+    constructor(groupNode) {
+        this._groupNode = groupNode;
+        // Используем _proxyInstance если доступен, иначе fallback
+        this.form = (groupNode
+            ._proxyInstance || groupNode.getProxy());
+    }
+    /**
+     * Безопасно установить значение поля по строковому пути
+     *
+     * Автоматически использует emitEvent: false для предотвращения циклов
+     */
+    setFieldValue(path, value) {
+        const node = this._groupNode.getFieldByPath(path);
+        if (node) {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            node.setValue(value, { emitEvent: false });
+        }
+    }
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Фабрики для создания узлов формы
+ *
+ * Централизованное место для всех фабрик и builder-паттернов.
+ */
+export { NodeFactory } from './node-factory';

package/dist/core/factories/index.js

@@ -0,0 +1,6 @@
+/**
+ * Фабрики для создания узлов формы
+ *
+ * Централизованное место для всех фабрик и builder-паттернов.
+ */
+export { NodeFactory } from './node-factory';