@reformer/core 1.1.0 → 2.0.0-beta.2

package/dist/core/utils/subscription-manager.js

@@ -1,214 +0,0 @@
-/**
- * Менеджер подписок для FormNode
- *
- * Централизует управление effect-подписками в узлах формы,
- * предотвращает утечки памяти и упрощает отладку.
- *
- * Каждая подписка имеет уникальный ключ, что позволяет:
- * - Отписываться от конкретной подписки по ключу
- * - Автоматически заменять существующие подписки
- * - Отслеживать количество активных подписок (для отладки)
- *
- * @internal
- *
- * @example
- * ```typescript
- * class FieldNode {
- *   private subscriptions = new SubscriptionManager();
- *
- *   watch(callback: Function) {
- *     const dispose = effect(() => callback(this.value.value));
- *     return this.subscriptions.add('watch', dispose);
- *   }
- *
- *   dispose() {
- *     this.subscriptions.clear();
- *   }
- * }
- * ```
- */
-export class SubscriptionManager {
-    /**
-     * Хранилище подписок
-     * Ключ: уникальный идентификатор подписки
-     * Значение: функция отписки (dispose)
-     */
-    subscriptions = new Map();
-    /**
-     * Добавляет подписку
-     *
-     * Если подписка с таким ключом уже существует, отписывается от неё
-     * и заменяет новой. Это предотвращает утечки памяти при повторной
-     * регистрации подписки с тем же ключом.
-     *
-     * @param key Уникальный ключ подписки
-     * @param dispose Функция отписки (обычно возвращаемая из effect())
-     * @returns Функция для отписки от этой конкретной подписки
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     *
-     * // Добавление подписки
-     * const unsubscribe = manager.add('mySubscription', () => {
-     *   console.log('Disposing subscription');
-     * });
-     *
-     * // Отписка через возвращаемую функцию
-     * unsubscribe();
-     *
-     * // Или через manager.remove()
-     * manager.add('anotherSub', disposeFn);
-     * manager.remove('anotherSub');
-     * ```
-     */
-    add(key, dispose) {
-        // Если подписка с таким ключом уже есть, отписываемся от неё
-        if (this.subscriptions.has(key)) {
-            if (process.env.NODE_ENV !== 'production') {
-                console.warn(`[SubscriptionManager] Subscription "${key}" already exists, replacing`);
-            }
-            this.subscriptions.get(key)?.();
-        }
-        // Сохраняем новую подписку
-        this.subscriptions.set(key, dispose);
-        // Возвращаем функцию отписки
-        return () => this.remove(key);
-    }
-    /**
-     * Удаляет подписку по ключу
-     *
-     * Вызывает функцию отписки и удаляет подписку из хранилища.
-     * Если подписка с таким ключом не найдена, ничего не делает.
-     *
-     * @param key Ключ подписки
-     * @returns true, если подписка была удалена, false если не найдена
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * manager.add('mySub', disposeFn);
-     *
-     * // Удаление подписки
-     * const removed = manager.remove('mySub'); // true
-     *
-     * // Попытка удалить несуществующую подписку
-     * const removed2 = manager.remove('nonExistent'); // false
-     * ```
-     */
-    remove(key) {
-        const dispose = this.subscriptions.get(key);
-        if (dispose) {
-            dispose();
-            this.subscriptions.delete(key);
-            return true;
-        }
-        return false;
-    }
-    /**
-     * Очищает все подписки
-     *
-     * Вызывает функции отписки для всех активных подписок
-     * и очищает хранилище. Обычно используется при dispose узла формы.
-     *
-     * @example
-     * ```typescript
-     * class FieldNode {
-     *   private subscriptions = new SubscriptionManager();
-     *
-     *   dispose() {
-     *     // Отписываемся от всех effect
-     *     this.subscriptions.clear();
-     *   }
-     * }
-     * ```
-     */
-    clear() {
-        // Используем forEach для совместимости
-        this.subscriptions.forEach((dispose) => {
-            dispose();
-        });
-        this.subscriptions.clear();
-    }
-    /**
-     * Возвращает количество активных подписок
-     *
-     * Полезно для отладки утечек памяти. Если количество подписок
-     * растет без ограничений, это может указывать на то, что
-     * компоненты не отписываются должным образом.
-     *
-     * @returns Количество активных подписок
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * console.log(manager.size()); // 0
-     *
-     * manager.add('sub1', disposeFn1);
-     * manager.add('sub2', disposeFn2);
-     * console.log(manager.size()); // 2
-     *
-     * manager.clear();
-     * console.log(manager.size()); // 0
-     * ```
-     */
-    size() {
-        return this.subscriptions.size;
-    }
-    /**
-     * Проверяет, есть ли подписка с данным ключом
-     *
-     * @param key Ключ подписки
-     * @returns true, если подписка существует
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * manager.add('mySub', disposeFn);
-     *
-     * console.log(manager.has('mySub')); // true
-     * console.log(manager.has('nonExistent')); // false
-     * ```
-     */
-    has(key) {
-        return this.subscriptions.has(key);
-    }
-    /**
-     * Возвращает список всех ключей активных подписок
-     *
-     * Полезно для отладки: можно увидеть, какие подписки активны.
-     *
-     * @returns Массив ключей всех активных подписок
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * manager.add('watch-value', disposeFn1);
-     * manager.add('watch-errors', disposeFn2);
-     *
-     * console.log(manager.getKeys()); // ['watch-value', 'watch-errors']
-     * ```
-     */
-    getKeys() {
-        return Array.from(this.subscriptions.keys());
-    }
-    /**
-     * Отписывается от всех подписок (алиас для clear())
-     *
-     * Используется при dispose() узла формы для совместимости с ожидаемым API.
-     *
-     * @example
-     * ```typescript
-     * class FieldNode {
-     *   private subscriptions = new SubscriptionManager();
-     *
-     *   dispose() {
-     *     this.subscriptions.dispose();
-     *   }
-     * }
-     * ```
-     */
-    dispose() {
-        this.clear();
-    }
-}

package/dist/core/utils/type-guards.js

@@ -1,169 +0,0 @@
-/**
- * Type Guards - централизованные функции проверки типов узлов
- *
- * Устраняет дублирование между form-node.ts, validation-applicator.ts и validation-context.ts
- *
- * @group Utilities
- * @category Type Guards
- *
- * @example
- * ```typescript
- * import { isFieldNode, isGroupNode } from '@/core/utils/type-guards';
- *
- * if (isFieldNode(node)) {
- *   // TypeScript знает, что node это FieldNode
- *   node.validators;
- * }
- * ```
- */
-/**
- * Проверить, является ли значение любым FormNode
- *
- * Проверяет базовые свойства, общие для всех типов узлов
- *
- * @group Utilities
- * @category Type Guards
- *
- * @param value - Значение для проверки
- * @returns true если value является FormNode
- *
- * @example
- * ```typescript
- * if (isFormNode(value)) {
- *   value.setValue(newValue);
- *   value.validate();
- * }
- * ```
- */
-export function isFormNode(value) {
-    if (value === null || value === undefined) {
-        return false;
-    }
-    return (typeof value === 'object' &&
-        'value' in value &&
-        'setValue' in value &&
-        'getValue' in value &&
-        'validate' in value);
-}
-/**
- * Проверить, является ли значение 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
- * }
- * ```
- */
-export function isFieldNode(value) {
-    if (value === null || value === undefined) {
-        return false;
-    }
-    return (isFormNode(value) &&
-        'validators' in value &&
-        'asyncValidators' in value &&
-        // FieldNode имеет markAsTouched метод
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        typeof value.markAsTouched === 'function' &&
-        // У FieldNode нет fields или items
-        !('fields' in value) &&
-        !('items' in value));
-}
-/**
- * Проверить, является ли значение GroupNode (объект с вложенными полями)
- *
- * GroupNode представляет объект с вложенными полями формы
- * и имеет методы для применения validation/behavior схем
- *
- * @param value - Значение для проверки
- * @returns true если value является GroupNode
- *
- * @example
- * ```typescript
- * if (isGroupNode(node)) {
- *   node.applyValidationSchema(schema); //  OK
- *   node.getFieldByPath('user.email'); //  OK
- * }
- * ```
- */
-export function isGroupNode(value) {
-    if (value === null || value === undefined) {
-        return false;
-    }
-    return (isFormNode(value) &&
-        'applyValidationSchema' in value &&
-        'applyBehaviorSchema' in value &&
-        'getFieldByPath' in value &&
-        // GroupNode НЕ имеет items/push/removeAt (это ArrayNode)
-        !('items' in value) &&
-        !('push' in value) &&
-        !('removeAt' in value));
-}
-/**
- * Проверить, является ли значение 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 - получить элемент
- * }
- * ```
- */
-export function isArrayNode(value) {
-    if (value === null || value === undefined) {
-        return false;
-    }
-    return (isFormNode(value) &&
-        'items' in value &&
-        'length' in value &&
-        'push' in value &&
-        'removeAt' in value &&
-        'at' in value &&
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        typeof value.push === 'function' &&
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        typeof value.removeAt === 'function');
-}
-/**
- * Получить тип узла как строку (для отладки)
- *
- * Полезно для логирования и отладки
- *
- * @param node - Узел для проверки
- * @returns Строковое название типа узла
- *
- * @example
- * ```typescript
- * console.log('Node type:', getNodeType(node)); // "FieldNode" | "GroupNode" | "ArrayNode" | "FormNode" | "Unknown"
- * ```
- */
-export function getNodeType(node) {
-    if (isFieldNode(node))
-        return 'FieldNode';
-    if (isGroupNode(node))
-        return 'GroupNode';
-    if (isArrayNode(node))
-        return 'ArrayNode';
-    if (isFormNode(node))
-        return 'FormNode';
-    return 'Unknown';
-}

package/dist/core/validation/core/apply-when.js

@@ -1,41 +0,0 @@
-/**
- * Условная валидация
- *
- * @group Validation
- * @category Core Functions
- */
-import { extractPath, createFieldPath } from '../field-path';
-import { getCurrentValidationRegistry } from '../../utils/registry-helpers';
-/**
- * Применить валидацию только при выполнении условия
- *
- * @group Validation
- * @category Core Functions
- *
- * @example
- * ```typescript
- * applyWhen(
- *   path.loanType,
- *   (type) => type === 'mortgage',
- *   (path) => {
- *     required(path.propertyValue, { message: 'Укажите стоимость' });
- *     min(path.propertyValue, 1000000);
- *   }
- * );
- * ```
- */
-export function applyWhen(fieldPath, condition, validationFn) {
-    const path = extractPath(fieldPath);
-    // Входим в условный блок
-    getCurrentValidationRegistry().enterCondition(path, condition);
-    try {
-        // Выполняем вложенную валидацию
-        // Создаем новый FieldPath proxy для вложенной функции
-        const nestedPath = createFieldPath();
-        validationFn(nestedPath);
-    }
-    finally {
-        // Выходим из условного блока
-        getCurrentValidationRegistry().exitCondition();
-    }
-}

package/dist/core/validation/core/apply.js

@@ -1,38 +0,0 @@
-/**
- * Композиция validation схем
- *
- * Предоставляет функции для переиспользования validation схем:
- * - apply: применение схемы к полям (новый API)
- *
- * Дополняет существующий toFieldPath и applyWhen.
- *
- * @group Validation
- * @category Core Functions
- */
-import { toFieldPath } from '../field-path';
-// Реализация
-export function apply(pathOrFields, validationSchemas) {
-    // Случай 1: FieldPath<TForm> + одна схема (композиция на уровне формы)
-    // Проверяем, является ли это FieldPath (не имеет __key и __path)
-    if (!Array.isArray(pathOrFields) &&
-        !Array.isArray(validationSchemas) &&
-        pathOrFields &&
-        !('__key' in pathOrFields) &&
-        !('__path' in pathOrFields)) {
-        const path = pathOrFields;
-        const schema = validationSchemas;
-        schema(path);
-        return;
-    }
-    // Случай 2: FieldPathNode или массив полей
-    const fieldArray = (Array.isArray(pathOrFields) ? pathOrFields : [pathOrFields]).filter(Boolean);
-    const schemaArray = Array.isArray(validationSchemas) ? validationSchemas : [validationSchemas];
-    // Применяем все схемы ко всем полям
-    for (const field of fieldArray) {
-        const nestedPath = toFieldPath(field);
-        for (const schema of schemaArray) {
-            // Type assertion: в случае 2 мы работаем только с ValidationSchemaFn<TField>
-            schema(nestedPath);
-        }
-    }
-}

package/dist/core/validation/core/index.js

@@ -1,8 +0,0 @@
-/**
- * Core validation functions
- */
-export { validate } from './validate';
-export { validateAsync } from './validate-async';
-export { validateTree } from './validate-tree';
-export { applyWhen } from './apply-when';
-export { apply } from './apply';

package/dist/core/validation/core/validate-async.js

@@ -1,45 +0,0 @@
-/**
- * Асинхронная валидация поля
- *
- * @group Validation
- * @category Core Functions
- */
-import { extractPath } from '../field-path';
-import { getCurrentValidationRegistry } from '../../utils/registry-helpers';
-/**
- * Зарегистрировать асинхронный валидатор для поля
- *
- * @group Validation
- * @category Core Functions
- *
- * @example
- * ```typescript
- * validateAsync(
- *   path.inn,
- *   async (ctx: ValidationContext<TForm, TField>) => {
- *     const inn = ctx.value();
- *     if (!inn) return null;
- *
- *     const response = await fetch('/api/validate-inn', {
- *       method: 'POST',
- *       body: JSON.stringify({ inn }),
- *     });
- *
- *     const data = await response.json();
- *     if (!data.valid) {
- *       return {
- *         code: 'invalidInn',
- *         message: 'ИНН не найден в базе данных ФНС',
- *       };
- *     }
- *
- *     return null;
- *   },
- *   { debounce: 1000 }
- * );
- * ```
- */
-export function validateAsync(fieldPath, validatorFn, options) {
-    const path = extractPath(fieldPath);
-    getCurrentValidationRegistry().registerAsync(path, validatorFn, options);
-}

package/dist/core/validation/core/validate-tree.js

@@ -1,37 +0,0 @@
-/**
- * Cross-field валидация
- *
- * @group Validation
- * @category Core Functions
- */
-import { getCurrentValidationRegistry } from '../../utils/registry-helpers';
-/**
- * Зарегистрировать cross-field валидатор
- *
- * Используется для валидации, которая зависит от нескольких полей
- *
- * @group Validation
- * @category Core Functions
- *
- * @example
- * ```typescript
- * validateTree(
- *   (ctx: ValidationContext<TForm, TField>) => {
- *     const form = ctx.formValue();
- *     if (form.initialPayment && form.propertyValue) {
- *       if (form.initialPayment > form.propertyValue) {
- *         return {
- *           code: 'initialPaymentTooHigh',
- *           message: 'Первоначальный взнос не может превышать стоимость',
- *         };
- *       }
- *     }
- *     return null;
- *   },
- *   { targetField: 'initialPayment' }
- * );
- * ```
- */
-export function validateTree(validatorFn, options) {
-    getCurrentValidationRegistry().registerTree(validatorFn, options);
-}

package/dist/core/validation/core/validate.js

@@ -1,38 +0,0 @@
-/**
- * Кастомная синхронная валидация поля
- *
- * @group Validation
- * @category Core Functions
- */
-import { extractPath } from '../field-path';
-import { getCurrentValidationRegistry } from '../../utils/registry-helpers';
-/**
- * Зарегистрировать кастомный синхронный валидатор для поля
- * Поддерживает опциональные поля
- *
- * @group Validation
- * @category Core Functions
- *
- * @example
- * ```typescript
- * validate(path.birthDate, (ctx: ValidationContext<TForm, TField>) => {
- *   const birthDate = new Date(ctx.value());
- *   const age = calculateAge(birthDate);
- *
- *   if (age < 18) {
- *     return {
- *       code: 'tooYoung',
- *       message: 'Заемщику должно быть не менее 18 лет',
- *     };
- *   }
- *
- *   return null;
- * });
- * ```
- */
-export function validate(fieldPath, validatorFn, options) {
-    if (!fieldPath)
-        return; // Защита от undefined fieldPath
-    const path = extractPath(fieldPath);
-    getCurrentValidationRegistry().registerSync(path, validatorFn, options);
-}