@reformer/core 1.1.0 → 2.0.0-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reformer/core",
-  "version": "1.1.0",
+  "version": "2.0.0-beta.3",
   "description": "Reactive form state management library for React with signals-based architecture",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,8 @@
   },
   "sideEffects": false,
   "scripts": {
-    "build": "vite build && tsc -p tsconfig.json",
+    "generate:llms": "npx tsx scripts/generate-llms.ts",
+    "build": "npm run generate:llms && vite build && tsc -p tsconfig.json",
     "dev": "vite",
     "test": "vitest",
     "test:watch": "vitest watch"
@@ -63,15 +64,18 @@
     "LLMs.txt"
   ],
   "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
   },
   "dependencies": {
     "@preact/signals-core": "^1.8.0",
+    "use-sync-external-store": "^1.2.0",
     "uuid": "^13.0.0"
   },
   "devDependencies": {
+    "@types/use-sync-external-store": "^0.0.6",
     "@types/node": "^24.10.1",
+    "tsx": "^4.19.2",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "@types/uuid": "^10.0.0",

package/dist/core/behavior/behavior-applicator.d.ts

@@ -1,71 +0,0 @@
-/**
- * Применение behavior схемы к форме
- *
- * Извлечено из GroupNode для соблюдения SRP (Single Responsibility Principle).
- * Управляет процессом регистрации и применения behaviors.
- *
- * @template T Тип формы
- *
- * @example
- * ```typescript
- * class GroupNode {
- *   private readonly behaviorApplicator = new BehaviorApplicator(this);
- *
- *   applyBehaviorSchema(schemaFn: BehaviorSchemaFn<T>): () => void {
- *     return this.behaviorApplicator.apply(schemaFn);
- *   }
- * }
- * ```
- */
-import type { GroupNode } from '../nodes/group-node';
-import type { BehaviorSchemaFn } from './types';
-import { BehaviorRegistry } from './behavior-registry';
-/**
- * Класс для применения behavior схемы к форме
- *
- * Выполняет:
- * 1. Начало регистрации behaviors (beginRegistration)
- * 2. Выполнение схемы (регистрация behaviors)
- * 3. Завершение регистрации (endRegistration) - применение behaviors
- * 4. Возврат функции cleanup для отписки
- *
- * @template T Тип формы (объект)
- */
-export declare class BehaviorApplicator<T> {
-    private readonly form;
-    private readonly behaviorRegistry;
-    constructor(form: GroupNode<T>, behaviorRegistry: BehaviorRegistry);
-    /**
-     * Применить behavior схему к форме
-     *
-     * Этапы:
-     * 1. Начать регистрацию (beginRegistration)
-     * 2. Выполнить схему (регистрация behaviors)
-     * 3. Завершить регистрацию (endRegistration) - применить behaviors
-     * 4. Вернуть функцию cleanup для отписки
-     *
-     * @param schemaFn Функция-схема behavior
-     * @returns Функция отписки от всех behaviors
-     *
-     * @example
-     * ```typescript
-     * const cleanup = behaviorApplicator.apply((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
-     *   );
-     * });
-     *
-     * // Cleanup при unmount
-     * useEffect(() => cleanup, []);
-     * ```
-     */
-    apply(schemaFn: BehaviorSchemaFn<T>): () => void;
-}

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

@@ -1,92 +0,0 @@
-/**
- * Применение behavior схемы к форме
- *
- * Извлечено из GroupNode для соблюдения SRP (Single Responsibility Principle).
- * Управляет процессом регистрации и применения behaviors.
- *
- * @template T Тип формы
- *
- * @example
- * ```typescript
- * class GroupNode {
- *   private readonly behaviorApplicator = new BehaviorApplicator(this);
- *
- *   applyBehaviorSchema(schemaFn: BehaviorSchemaFn<T>): () => void {
- *     return this.behaviorApplicator.apply(schemaFn);
- *   }
- * }
- * ```
- */
-import { createFieldPath as createBehaviorFieldPath } from './create-field-path';
-import { FormErrorHandler, ErrorStrategy } from '../utils/error-handler';
-/**
- * Класс для применения behavior схемы к форме
- *
- * Выполняет:
- * 1. Начало регистрации behaviors (beginRegistration)
- * 2. Выполнение схемы (регистрация behaviors)
- * 3. Завершение регистрации (endRegistration) - применение behaviors
- * 4. Возврат функции cleanup для отписки
- *
- * @template T Тип формы (объект)
- */
-export class BehaviorApplicator {
-    form;
-    behaviorRegistry;
-    constructor(form, behaviorRegistry) {
-        this.form = form;
-        this.behaviorRegistry = behaviorRegistry;
-    }
-    /**
-     * Применить behavior схему к форме
-     *
-     * Этапы:
-     * 1. Начать регистрацию (beginRegistration)
-     * 2. Выполнить схему (регистрация behaviors)
-     * 3. Завершить регистрацию (endRegistration) - применить behaviors
-     * 4. Вернуть функцию cleanup для отписки
-     *
-     * @param schemaFn Функция-схема behavior
-     * @returns Функция отписки от всех behaviors
-     *
-     * @example
-     * ```typescript
-     * const cleanup = behaviorApplicator.apply((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
-     *   );
-     * });
-     *
-     * // Cleanup при unmount
-     * useEffect(() => cleanup, []);
-     * ```
-     */
-    apply(schemaFn) {
-        this.behaviorRegistry.beginRegistration();
-        try {
-            // 1. Создать field path для type-safe доступа к полям
-            const path = createBehaviorFieldPath();
-            // 2. Выполнить схему (регистрация behaviors)
-            schemaFn(path);
-            // 3. Завершить регистрацию и применить behaviors
-            //  Используем публичный метод getProxy() для получения proxy-инстанса
-            const formToUse = this.form.getProxy();
-            const result = this.behaviorRegistry.endRegistration(formToUse);
-            // 4. Вернуть функцию cleanup
-            return result.cleanup;
-        }
-        catch (error) {
-            FormErrorHandler.handle(error, 'BehaviorApplicator', ErrorStrategy.THROW);
-            // TypeScript требует return, но код никогда не дойдет сюда
-            throw error;
-        }
-    }
-}

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

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

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

@@ -1,198 +0,0 @@
-/**
- * BehaviorRegistry - регистрация и управление behavior схемами
- *
- * Аналогично ValidationRegistry, но для реактивного поведения форм
- */
-import { BehaviorContextImpl } from './behavior-context';
-import { RegistryStack } from '../utils/registry-stack';
-/**
- * Реестр behaviors для формы
- *
- * Каждый экземпляр GroupNode создает собственный реестр (композиция).
- * Устраняет race conditions и изолирует формы друг от друга.
- *
- * Context stack используется для tracking текущего активного реестра:
- * - beginRegistration() помещает this в stack
- * - endRegistration() извлекает из stack
- * - getCurrent() возвращает текущий активный реестр
- *
- * @example
- * ```typescript
- * class GroupNode {
- *   private readonly behaviorRegistry = new BehaviorRegistry();
- *
- *   applyBehaviorSchema(schemaFn) {
- *     this.behaviorRegistry.beginRegistration(); // Pushes this to stack
- *     schemaFn(createBehaviorFieldPath(this));   // Uses getCurrent()
- *     return this.behaviorRegistry.endRegistration(this); // Pops from stack
- *   }
- * }
- * ```
- */
-export class BehaviorRegistry {
-    /**
-     * Stack активных контекстов регистрации
-     * Используется для изоляции форм друг от друга
-     */
-    static contextStack = new RegistryStack();
-    registrations = [];
-    isRegistering = false;
-    /**
-     * Получить текущий активный реестр из context stack
-     *
-     * @returns Текущий активный реестр или null
-     *
-     * @example
-     * ```typescript
-     * // В schema-behaviors.ts
-     * export function copyFrom(...) {
-     *   const registry = BehaviorRegistry.getCurrent();
-     *   if (registry) {
-     *     registry.register({ ... });
-     *   }
-     * }
-     * ```
-     */
-    static getCurrent() {
-        return BehaviorRegistry.contextStack.getCurrent();
-    }
-    /**
-     * Начать регистрацию behaviors
-     * Вызывается перед применением схемы
-     *
-     * Помещает this в context stack для изоляции форм
-     */
-    beginRegistration() {
-        this.isRegistering = true;
-        this.registrations = [];
-        // Помещаем this в stack для tracking текущего активного реестра
-        BehaviorRegistry.contextStack.push(this);
-    }
-    /**
-     * Зарегистрировать behavior handler
-     * Вызывается функциями из schema-behaviors.ts
-     *
-     * @param handler - BehaviorHandlerFn функция
-     * @param options - Опции behavior (debounce)
-     *
-     * @example
-     * ```typescript
-     * const handler = createCopyBehavior(target, source, { when: ... });
-     * registry.register(handler, { debounce: 300 });
-     * ```
-     */
-    register(handler, options) {
-        if (!this.isRegistering) {
-            if (import.meta.env.DEV) {
-                throw new Error('BehaviorRegistry: call beginRegistration() before registering behaviors');
-            }
-            return;
-        }
-        this.registrations.push({
-            // Type assertion безопасен: handler будет вызван с правильным типом формы в createEffect
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            handler: handler,
-            debounce: options?.debounce,
-        });
-    }
-    /**
-     * Завершить регистрацию и применить behaviors к форме
-     * Создает effect подписки для всех зарегистрированных behaviors
-     *
-     * Извлекает this из context stack
-     *
-     * @param form - GroupNode формы
-     * @returns Количество зарегистрированных behaviors и функция cleanup
-     */
-    endRegistration(form) {
-        this.isRegistering = false;
-        // Извлекаем из stack с проверкой
-        BehaviorRegistry.contextStack.verify(this, 'BehaviorRegistry');
-        const context = new BehaviorContextImpl(form);
-        const disposeCallbacks = [];
-        // Создаем effect подписки для каждого behavior
-        for (const registered of this.registrations) {
-            const dispose = this.createEffect(registered, form, context);
-            if (dispose) {
-                disposeCallbacks.push(dispose);
-            }
-        }
-        // Функция cleanup для отписки от всех effects
-        const cleanup = () => {
-            disposeCallbacks.forEach((dispose) => dispose());
-        };
-        return {
-            count: this.registrations.length,
-            cleanup,
-        };
-    }
-    /**
-     * Создать effect подписку для behavior
-     * @private
-     */
-    createEffect(registered, form, context) {
-        const { handler, debounce: debounceMs = 0 } = registered;
-        let debounceTimer = null;
-        // Обертка для debounce
-        const withDebounce = (callback) => {
-            if (debounceMs > 0) {
-                if (debounceTimer)
-                    clearTimeout(debounceTimer);
-                debounceTimer = setTimeout(callback, debounceMs);
-            }
-            else {
-                callback();
-            }
-        };
-        // Cleanup функция для debounce таймера
-        const cleanupDebounce = () => {
-            if (debounceTimer) {
-                clearTimeout(debounceTimer);
-                debounceTimer = null;
-            }
-        };
-        // Вызываем handler напрямую
-        // Type assertion необходим из-за contravariance: handler хранится как
-        // BehaviorHandlerFn<FormFields>, но вызывается с более специфичным типом T.
-        // Используем any для обхода ограничений TypeScript при хранении generic handlers в массиве.
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const effectDispose = handler(form, context, withDebounce);
-        if (!effectDispose) {
-            return null;
-        }
-        // Возвращаем комбинированный cleanup
-        // который очищает и effect, и debounce таймер
-        return () => {
-            cleanupDebounce();
-            if (effectDispose) {
-                effectDispose();
-            }
-        };
-    }
-}
-// ============================================================================
-// Глобальный экземпляр BehaviorRegistry УДАЛЕН
-// ============================================================================
-//
-// Ранее здесь был глобальный Singleton экземпляр BehaviorRegistry,
-// который создавал race conditions и нарушал изоляцию форм.
-//
-//  Теперь каждый GroupNode создает собственный экземпляр BehaviorRegistry:
-//
-// @example
-// ```typescript
-// class GroupNode {
-//   private readonly behaviorRegistry = new BehaviorRegistry();
-//
-//   applyBehaviorSchema(schemaFn) {
-//     this.behaviorRegistry.beginRegistration();
-//     schemaFn(createBehaviorFieldPath(this));
-//     return this.behaviorRegistry.endRegistration(this);
-//   }
-// }
-// ```
-//
-// Это обеспечивает:
-// - Полную изоляцию форм друг от друга
-// - Отсутствие race conditions при параллельной регистрации
-// - Возможность применять разные behavior схемы к разным формам одновременно

package/dist/core/behavior/behaviors/compute-from.js

@@ -1,84 +0,0 @@
-/**
- * Вычисляемые поля
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/computeFrom
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Автоматически вычисляет значение поля на основе других полей
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param sources - Массив полей-зависимостей
- * @param target - Поле для записи результата
- * @param computeFn - Функция вычисления (принимает объект с именами полей)
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Автоматический расчет минимального взноса
- *   computeFrom(
- *     [path.propertyValue],
- *     path.initialPayment,
- *     (values) => values.propertyValue ? values.propertyValue * 0.2 : null,
- *     { debounce: 300 }
- *   );
- *
- *   // Общая стоимость = цена * количество
- *   computeFrom(
- *     [path.price, path.quantity],
- *     path.total,
- *     (values) => values.price * values.quantity
- *   );
- * };
- * ```
- */
-export function computeFrom(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-sources, target, computeFn, options) {
-    const { debounce, condition } = options || {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const handler = (form, _context, withDebounce) => {
-        const targetNode = form.getFieldByPath(target.__path);
-        if (!targetNode)
-            return null;
-        // Разрешаем source узлы
-        const sourceNodes = sources
-            .map((field) => form.getFieldByPath(field.__path))
-            .filter((node) => node !== undefined);
-        if (sourceNodes.length === 0)
-            return null;
-        return effect(() => {
-            // Читаем значения всех source полей
-            const sourceValues = sourceNodes.map((node) => node.value.value);
-            withDebounce(() => {
-                // Проверка условия
-                if (condition) {
-                    const formValue = form.getValue();
-                    if (!condition(formValue))
-                        return;
-                }
-                // Создаем объект с именами полей для computeFn
-                // computeFn ожидает объект вида { fieldName: value, ... }
-                const sourceValuesObject = {};
-                sources.forEach((source, index) => {
-                    // Извлекаем имя поля из пути (последний сегмент)
-                    const fieldName = source.__path.split('.').pop() || source.__path;
-                    sourceValuesObject[fieldName] = sourceValues[index];
-                });
-                // Вычисляем новое значение
-                const computedValue = computeFn(sourceValuesObject);
-                // Устанавливаем значение без триггера событий
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                targetNode.setValue(computedValue, { emitEvent: false });
-            });
-        });
-    };
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}

package/dist/core/behavior/behaviors/copy-from.js

@@ -1,64 +0,0 @@
-/**
- * Копирование значений между полями
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/copyFrom
- */
-import { watchField } from './watch-field';
-/**
- * Копирует значения из одного поля/группы в другое при выполнении условия
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param source - Откуда копировать
- * @param target - Куда копировать
- * @param options - Опции копирования
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Копировать адрес регистрации в адрес проживания
- *   copyFrom(path.registrationAddress, path.residenceAddress, {
- *     when: (form) => form.sameAsRegistration === true,
- *     fields: 'all'
- *   });
- * };
- * ```
- */
-export function copyFrom(source, target, options) {
-    const { when, fields = 'all', transform, debounce } = options || {};
-    watchField(source, (sourceValue, ctx) => {
-        // Проверка условия
-        if (when) {
-            const formValue = ctx.form.getValue();
-            if (!when(formValue))
-                return;
-        }
-        // Трансформация значения
-        const value = transform ? transform(sourceValue) : sourceValue;
-        // Получаем target node
-        const targetNode = ctx.form.getFieldByPath(target.__path);
-        if (!targetNode)
-            return;
-        // Копирование
-        if (fields === 'all' || !fields) {
-            targetNode.setValue(value, { emitEvent: false });
-        }
-        else {
-            // Частичное копирование для групп
-            const patch = {};
-            fields.forEach((key) => {
-                if (sourceValue && typeof sourceValue === 'object') {
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    patch[key] = sourceValue[key];
-                }
-            });
-            if ('patchValue' in targetNode) {
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                targetNode.patchValue(patch);
-            }
-        }
-    }, { debounce });
-}

package/dist/core/behavior/behaviors/enable-when.js

@@ -1,81 +0,0 @@
-/**
- * Условное включение/отключение полей
- *
- * @group Behaviors
- * @category Behavior Rules
- * @module behaviors/enableWhen
- */
-import { effect } from '@preact/signals-core';
-import { getCurrentBehaviorRegistry } from '../../utils/registry-helpers';
-/**
- * Условное включение поля на основе значений других полей
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field - Поле для включения/выключения
- * @param condition - Функция условия (true = enable, false = disable)
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Включить поле только для ипотеки
- *   enableWhen(path.propertyValue, (form) => form.loanType === 'mortgage', {
- *     resetOnDisable: true
- *   });
- * };
- * ```
- */
-export function enableWhen(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-field, condition, options) {
-    const { debounce, resetOnDisable = false } = options || {};
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const handler = (form, _context, withDebounce) => {
-        const targetNode = form.getFieldByPath(field.__path);
-        if (!targetNode)
-            return null;
-        return effect(() => {
-            const formValue = form.value.value;
-            withDebounce(() => {
-                const shouldEnable = condition(formValue);
-                if (shouldEnable) {
-                    targetNode.enable();
-                }
-                else {
-                    targetNode.disable();
-                    if (resetOnDisable) {
-                        targetNode.reset();
-                    }
-                }
-            });
-        });
-    };
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    getCurrentBehaviorRegistry().register(handler, { debounce });
-}
-/**
- * Условное выключение поля (инверсия enableWhen)
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param field - Поле для выключения
- * @param condition - Функция условия (true = disable, false = enable)
- * @param options - Опции
- *
- * @example
- * ```typescript
- * const schema: BehaviorSchemaFn<MyForm> = (path) => {
- *   // Выключить поле для потребительского кредита
- *   disableWhen(path.propertyValue, (form) => form.loanType === 'consumer');
- * };
- * ```
- */
-export function disableWhen(
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-field, condition, options) {
-    // Инвертируем условие
-    enableWhen(field, (form) => !condition(form), options);
-}

package/dist/core/behavior/behaviors/index.js

@@ -1,11 +0,0 @@
-/**
- * Behavior rules
- */
-export { copyFrom } from './copy-from';
-export { enableWhen, disableWhen } from './enable-when';
-export { computeFrom } from './compute-from';
-export { watchField } from './watch-field';
-export { revalidateWhen } from './revalidate-when';
-export { syncFields } from './sync-fields';
-export { resetWhen } from './reset-when';
-export { transformValue, createTransformer, transformers, } from './transform-value';