@reformer/core 1.1.0 → 2.0.0-beta.2

package/dist/core/nodes/group-node/field-registry.js

@@ -1,215 +0,0 @@
-/**
- * FieldRegistry - управление полями в GroupNode
- *
- * Извлечено из GroupNode для соблюдения SRP (Single Responsibility Principle).
- * Отвечает только за хранение и управление коллекцией полей формы.
- *
- * @template T Тип формы (объект)
- *
- * @example
- * ```typescript
- * const registry = new FieldRegistry<{ email: string; name: string }>();
- * registry.set('email', emailField);
- * registry.set('name', nameField);
- *
- * const emailField = registry.get('email');
- * registry.forEach((field, key) => {
- *   console.log(key, field.value.value);
- * });
- * ```
- */
-/**
- * Реестр полей формы
- *
- * Предоставляет типобезопасный доступ к полям формы
- * через Map-подобный интерфейс
- *
- * @template T Тип формы (объект)
- */
-export class FieldRegistry {
-    /**
-     * Внутреннее хранилище полей
-     * Map обеспечивает быструю lookup производительность O(1)
-     */
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    fields = new Map();
-    /**
-     * Установить поле в реестр
-     *
-     * @param key - Ключ поля (имя свойства в типе T)
-     * @param node - FormNode для этого поля
-     *
-     * @example
-     * ```typescript
-     * registry.set('email', new FieldNode({ value: '' }));
-     * ```
-     */
-    set(key, node) {
-        this.fields.set(key, node);
-    }
-    /**
-     * Получить поле из реестра
-     *
-     * @param key - Ключ поля
-     * @returns FormNode или undefined, если поле не найдено
-     *
-     * @example
-     * ```typescript
-     * const emailField = registry.get('email');
-     * if (emailField) {
-     *   console.log(emailField.value.value);
-     * }
-     * ```
-     */
-    get(key) {
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        return this.fields.get(key);
-    }
-    /**
-     * Проверить наличие поля в реестре
-     *
-     * @param key - Ключ поля
-     * @returns true если поле существует
-     *
-     * @example
-     * ```typescript
-     * if (registry.has('email')) {
-     *   console.log('Email field exists');
-     * }
-     * ```
-     */
-    has(key) {
-        return this.fields.has(key);
-    }
-    /**
-     * Удалить поле из реестра
-     *
-     * @param key - Ключ поля
-     * @returns true если поле было удалено, false если поля не было
-     *
-     * @example
-     * ```typescript
-     * registry.delete('email');
-     * ```
-     */
-    delete(key) {
-        return this.fields.delete(key);
-    }
-    /**
-     * Перебрать все поля
-     *
-     * @param callback - Функция обратного вызова для каждого поля
-     *
-     * @example
-     * ```typescript
-     * registry.forEach((field, key) => {
-     *   console.log(`${key}: ${field.value.value}`);
-     * });
-     * ```
-     */
-    forEach(callback) {
-        this.fields.forEach(callback);
-    }
-    /**
-     * Получить итератор значений (полей)
-     *
-     * @returns Итератор по всем полям
-     *
-     * @example
-     * ```typescript
-     * for (const field of registry.values()) {
-     *   await field.validate();
-     * }
-     * ```
-     */
-    values() {
-        return this.fields.values();
-    }
-    /**
-     * Получить итератор пар [ключ, значение]
-     *
-     * @returns Итератор по всем записям
-     *
-     * @example
-     * ```typescript
-     * for (const [key, field] of registry.entries()) {
-     *   console.log(key, field.value.value);
-     * }
-     * ```
-     */
-    entries() {
-        return this.fields.entries();
-    }
-    /**
-     * Получить итератор ключей полей
-     *
-     * @returns Итератор по всем ключам
-     *
-     * @example
-     * ```typescript
-     * const fieldNames = Array.from(registry.keys());
-     * // ['email', 'name', 'age']
-     * ```
-     */
-    keys() {
-        return this.fields.keys();
-    }
-    /**
-     * Получить количество полей
-     *
-     * @returns Количество зарегистрированных полей
-     *
-     * @example
-     * ```typescript
-     * console.log(`Form has ${registry.size()} fields`);
-     * ```
-     */
-    size() {
-        return this.fields.size;
-    }
-    /**
-     * Очистить все поля
-     *
-     * Удаляет все поля из реестра
-     *
-     * @example
-     * ```typescript
-     * registry.clear();
-     * console.log(registry.size()); // 0
-     * ```
-     */
-    clear() {
-        this.fields.clear();
-    }
-    /**
-     * Получить все поля как массив
-     *
-     * Полезно для операций, требующих работу с массивом
-     *
-     * @returns Массив всех полей
-     *
-     * @example
-     * ```typescript
-     * const allValid = registry.toArray().every(field => field.valid.value);
-     * ```
-     */
-    toArray() {
-        return Array.from(this.fields.values());
-    }
-    /**
-     * Получить Map-представление реестра (readonly)
-     *
-     * Используйте для совместимости с существующим кодом
-     *
-     * @returns ReadonlyMap с полями
-     * @internal
-     *
-     * @example
-     * ```typescript
-     * const mapView = registry.asMap();
-     * ```
-     */
-    asMap() {
-        return this.fields;
-    }
-}

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

@@ -1,11 +0,0 @@
-/**
- * GroupNode modules
- *
- * Модульная структура для GroupNode:
- * - FieldRegistry: Управление коллекцией полей
- * - ProxyBuilder: Создание Proxy для типобезопасного доступа к полям
- * - StateManager: Управление состоянием формы (signals)
- */
-export { FieldRegistry } from './field-registry';
-export { ProxyBuilder } from './proxy-builder';
-export { StateManager } from './state-manager';

package/dist/core/nodes/group-node/index.js

@@ -1,11 +0,0 @@
-/**
- * GroupNode modules
- *
- * Модульная структура для GroupNode:
- * - FieldRegistry: Управление коллекцией полей
- * - ProxyBuilder: Создание Proxy для типобезопасного доступа к полям
- * - StateManager: Управление состоянием формы (signals)
- */
-export { FieldRegistry } from './field-registry';
-export { ProxyBuilder } from './proxy-builder';
-export { StateManager } from './state-manager';

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

@@ -1,71 +0,0 @@
-/**
- * ProxyBuilder - создание Proxy для типобезопасного доступа к полям GroupNode
- *
- * Извлечено из GroupNode для соблюдения SRP (Single Responsibility Principle).
- * Отвечает только за создание Proxy с расширенной поддержкой операций.
- *
- * @template T Тип формы (объект)
- *
- * @example
- * ```typescript
- * const fieldRegistry = new FieldRegistry<FormType>();
- * const proxyBuilder = new ProxyBuilder(fieldRegistry);
- * const proxy = proxyBuilder.build(groupNode);
- *
- * // Теперь можно обращаться к полям напрямую:
- * console.log(proxy.email.value);
- * console.log('email' in proxy); // true
- * ```
- */
-import type { GroupNode } from '../group-node';
-import type { GroupNodeWithControls } from '../../types/group-node-proxy';
-import type { FieldRegistry } from './field-registry';
-/**
- * Строитель Proxy для GroupNode
- *
- * Создает Proxy с поддержкой:
- * - get: Прямой доступ к полям через точечную нотацию
- * - set: Предупреждение о попытке прямой установки полей
- * - has: Проверка существования поля ('email' in form)
- * - ownKeys: Перечисление всех ключей (Object.keys(form))
- * - getOwnPropertyDescriptor: Получение дескрипторов полей
- *
- * @template T Тип формы (объект)
- */
-export declare class ProxyBuilder<T> {
-    private fieldRegistry;
-    /**
-     * @param fieldRegistry - Реестр полей для доступа к коллекции
-     */
-    constructor(fieldRegistry: FieldRegistry<T>);
-    /**
-     * Создать Proxy для GroupNode
-     *
-     * Proxy позволяет обращаться к полям формы напрямую:
-     * - form.email вместо form.fields.get('email')
-     * - form.address.city вместо form.fields.get('address').fields.get('city')
-     *
-     * @param target - GroupNode для которого создается Proxy
-     * @returns Proxy с типобезопасным доступом к полям
-     *
-     * @example
-     * ```typescript
-     * const proxy = proxyBuilder.build(groupNode);
-     *
-     * // Доступ к полям
-     * console.log(proxy.email.value); // Работает!
-     * console.log(proxy.name.value);  // Работает!
-     *
-     * // Доступ к методам GroupNode
-     * await proxy.validate(); // Работает!
-     * proxy.markAsTouched();  // Работает!
-     *
-     * // Проверка существования
-     * if ('email' in proxy) { ... }
-     *
-     * // Перечисление ключей
-     * Object.keys(proxy); // ['email', 'name', ...]
-     * ```
-     */
-    build(target: GroupNode<T>): GroupNodeWithControls<T>;
-}

package/dist/core/nodes/group-node/proxy-builder.js

@@ -1,161 +0,0 @@
-/**
- * ProxyBuilder - создание Proxy для типобезопасного доступа к полям GroupNode
- *
- * Извлечено из GroupNode для соблюдения SRP (Single Responsibility Principle).
- * Отвечает только за создание Proxy с расширенной поддержкой операций.
- *
- * @template T Тип формы (объект)
- *
- * @example
- * ```typescript
- * const fieldRegistry = new FieldRegistry<FormType>();
- * const proxyBuilder = new ProxyBuilder(fieldRegistry);
- * const proxy = proxyBuilder.build(groupNode);
- *
- * // Теперь можно обращаться к полям напрямую:
- * console.log(proxy.email.value);
- * console.log('email' in proxy); // true
- * ```
- */
-/**
- * Строитель Proxy для GroupNode
- *
- * Создает Proxy с поддержкой:
- * - get: Прямой доступ к полям через точечную нотацию
- * - set: Предупреждение о попытке прямой установки полей
- * - has: Проверка существования поля ('email' in form)
- * - ownKeys: Перечисление всех ключей (Object.keys(form))
- * - getOwnPropertyDescriptor: Получение дескрипторов полей
- *
- * @template T Тип формы (объект)
- */
-export class ProxyBuilder {
-    fieldRegistry;
-    /**
-     * @param fieldRegistry - Реестр полей для доступа к коллекции
-     */
-    constructor(fieldRegistry) {
-        this.fieldRegistry = fieldRegistry;
-    }
-    /**
-     * Создать Proxy для GroupNode
-     *
-     * Proxy позволяет обращаться к полям формы напрямую:
-     * - form.email вместо form.fields.get('email')
-     * - form.address.city вместо form.fields.get('address').fields.get('city')
-     *
-     * @param target - GroupNode для которого создается Proxy
-     * @returns Proxy с типобезопасным доступом к полям
-     *
-     * @example
-     * ```typescript
-     * const proxy = proxyBuilder.build(groupNode);
-     *
-     * // Доступ к полям
-     * console.log(proxy.email.value); // Работает!
-     * console.log(proxy.name.value);  // Работает!
-     *
-     * // Доступ к методам GroupNode
-     * await proxy.validate(); // Работает!
-     * proxy.markAsTouched();  // Работает!
-     *
-     * // Проверка существования
-     * if ('email' in proxy) { ... }
-     *
-     * // Перечисление ключей
-     * Object.keys(proxy); // ['email', 'name', ...]
-     * ```
-     */
-    build(target) {
-        return new Proxy(target, {
-            /**
-             * Get trap: Перехват доступа к свойствам
-             *
-             * Приоритет:
-             * 1. Собственные свойства и методы GroupNode (validate, setValue и т.д.)
-             * 2. Поля формы из fieldRegistry
-             * 3. undefined для несуществующих свойств
-             */
-            get: (target, prop) => {
-                // Приоритет 1: Собственные свойства и методы GroupNode
-                // Это важно, чтобы методы validate(), setValue() и т.д. работали корректно
-                if (prop in target) {
-                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    return target[prop];
-                }
-                // Приоритет 2: Поля формы
-                // Используем fieldRegistry для типобезопасного доступа
-                if (typeof prop === 'string' && this.fieldRegistry.has(prop)) {
-                    return this.fieldRegistry.get(prop);
-                }
-                // Fallback для несуществующих свойств
-                return undefined;
-            },
-            /**
-             * Set trap: Перехват установки свойств
-             *
-             * Запрещает прямую установку значений полей через form.email = value
-             * Пользователь должен использовать form.email.setValue(value) или form.setValue({...})
-             */
-            set: (target, prop, value) => {
-                // Запретить прямое изменение полей
-                if (typeof prop === 'string' && this.fieldRegistry.has(prop)) {
-                    if (import.meta.env.DEV) {
-                        console.warn(`[GroupNode] Cannot set field "${prop}" directly. Use .setValue() or .patchValue() instead.\n` +
-                            `Example: form.setValue({ ${prop}: ${JSON.stringify(value)} })`);
-                    }
-                    return false;
-                }
-                // Разрешить установку других свойств
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                target[prop] = value;
-                return true;
-            },
-            /**
-             * Has trap: Перехват оператора 'in'
-             *
-             * Позволяет проверять существование полей:
-             * if ('email' in form) { ... }
-             */
-            has: (target, prop) => {
-                // Проверяем наличие в полях
-                if (typeof prop === 'string' && this.fieldRegistry.has(prop)) {
-                    return true;
-                }
-                // Проверяем наличие в самом объекте
-                return prop in target;
-            },
-            /**
-             * OwnKeys trap: Перехват Object.keys() / Object.getOwnPropertyNames()
-             *
-             * Возвращает объединенный список:
-             * - Ключей самого GroupNode
-             * - Ключей полей из fieldRegistry
-             */
-            ownKeys: (target) => {
-                const nodeKeys = Reflect.ownKeys(target);
-                const fieldKeys = Array.from(this.fieldRegistry.keys());
-                // Используем Set для удаления дубликатов
-                return [...new Set([...nodeKeys, ...fieldKeys])];
-            },
-            /**
-             * GetOwnPropertyDescriptor trap: Перехват Object.getOwnPropertyDescriptor()
-             *
-             * Возвращает дескриптор свойства для полей и свойств GroupNode
-             * Важно для корректной работы Object.keys() и других рефлексивных операций
-             */
-            getOwnPropertyDescriptor: (target, prop) => {
-                // Дескриптор для полей формы
-                if (typeof prop === 'string' && this.fieldRegistry.has(prop)) {
-                    return {
-                        enumerable: true, // Поле должно быть перечисляемым
-                        configurable: true, // Поле может быть удалено
-                        // Не указываем writable, т.к. это accessor property через get/set traps
-                    };
-                }
-                // Дескриптор для свойств самого объекта
-                return Reflect.getOwnPropertyDescriptor(target, prop);
-            },
-        });
-    }
-}

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

@@ -1,184 +0,0 @@
-/**
- * StateManager - управление состоянием GroupNode
- *
- * Инкапсулирует всю логику создания и управления сигналами состояния:
- * - Приватные сигналы (submitting, disabled, formErrors)
- * - Публичные computed signals (value, valid, invalid, touched, dirty, pending, errors, status, submitting)
- *
- * Извлечено из GroupNode для соблюдения SRP (Single Responsibility Principle).
- * Отвечает только за логику управления состоянием формы.
- *
- * @template T Тип формы (объект)
- *
- * @example
- * ```typescript
- * class GroupNode {
- *   private stateManager: StateManager<T>;
- *
- *   constructor(schema: FormSchema<T>) {
- *     this.fieldRegistry = new FieldRegistry<T>();
- *     // ... создание полей ...
- *     this.stateManager = new StateManager(this.fieldRegistry);
- *
- *     // Доступ к computed signals
- *     this.value = this.stateManager.value;
- *     this.valid = this.stateManager.valid;
- *   }
- * }
- * ```
- */
-import type { ReadonlySignal } from '@preact/signals-core';
-import type { ValidationError, FieldStatus } from '../../types';
-import type { FieldRegistry } from './field-registry';
-/**
- * Менеджер состояния для GroupNode
- *
- * Создает и управляет всеми сигналами состояния формы:
- * - value - значение формы как объект
- * - valid/invalid - валидность формы
- * - touched/dirty - пользовательское взаимодействие
- * - pending - асинхронная валидация в процессе
- * - errors - все ошибки валидации (form-level + field-level)
- * - status - общий статус формы
- * - submitting - флаг отправки формы
- *
- * @template T Тип формы (объект)
- */
-export declare class StateManager<T> {
-    private readonly fieldRegistry;
-    /**
-     * Флаг отправки формы
-     * Устанавливается в true во время отправки формы на сервер
-     */
-    private _submitting;
-    /**
-     * Флаг disabled состояния
-     * Если true, форма считается disabled
-     */
-    private _disabled;
-    /**
-     * Form-level validation errors (не связанные с конкретным полем)
-     * Используется для server-side errors или кросс-полевой валидации
-     */
-    private _formErrors;
-    /**
-     * Значение формы как объект
-     *
-     * Computed signal, который автоматически пересчитывается при изменении любого поля.
-     * Использует мемоизацию - если зависимости не изменились, вернет закешированный объект.
-     *
-     * @example
-     * ```typescript
-     * const form = new GroupNode({ email: { value: 'test@mail.com' } });
-     * console.log(form.value.value); // { email: 'test@mail.com' }
-     * ```
-     */
-    readonly value: ReadonlySignal<T>;
-    /**
-     * Форма валидна?
-     *
-     * Computed signal. Форма валидна, если:
-     * - Нет form-level errors
-     * - Все поля валидны
-     */
-    readonly valid: ReadonlySignal<boolean>;
-    /**
-     * Форма невалидна?
-     *
-     * Computed signal. Инверсия valid.
-     */
-    readonly invalid: ReadonlySignal<boolean>;
-    /**
-     * Хотя бы одно поле touched?
-     *
-     * Computed signal. Возвращает true, если хотя бы одно поле было touched.
-     */
-    readonly touched: ReadonlySignal<boolean>;
-    /**
-     * Хотя бы одно поле dirty?
-     *
-     * Computed signal. Возвращает true, если хотя бы одно поле изменилось.
-     */
-    readonly dirty: ReadonlySignal<boolean>;
-    /**
-     * Асинхронная валидация в процессе?
-     *
-     * Computed signal. Возвращает true, если хотя бы одно поле находится в pending состоянии.
-     */
-    readonly pending: ReadonlySignal<boolean>;
-    /**
-     * Все ошибки валидации
-     *
-     * Computed signal. Возвращает массив всех ошибок:
-     * - Form-level errors
-     * - Field-level errors (из всех вложенных полей)
-     */
-    readonly errors: ReadonlySignal<ValidationError[]>;
-    /**
-     * Общий статус формы
-     *
-     * Computed signal. Возможные значения:
-     * - 'disabled' - форма disabled
-     * - 'pending' - асинхронная валидация в процессе
-     * - 'invalid' - форма невалидна
-     * - 'valid' - форма валидна
-     */
-    readonly status: ReadonlySignal<FieldStatus>;
-    /**
-     * Форма в процессе отправки?
-     *
-     * Computed signal (обертка над _submitting для read-only доступа).
-     */
-    readonly submitting: ReadonlySignal<boolean>;
-    /**
-     * Создать менеджер состояния
-     *
-     * @param fieldRegistry - реестр полей формы
-     */
-    constructor(fieldRegistry: FieldRegistry<T>);
-    /**
-     * Установить form-level ошибки
-     *
-     * @param errors - массив ошибок валидации
-     *
-     * @example
-     * ```typescript
-     * // Server-side ошибки
-     * stateManager.setFormErrors([
-     *   { code: 'server_error', message: 'Пользователь с таким email уже существует' }
-     * ]);
-     * ```
-     */
-    setFormErrors(errors: ValidationError[]): void;
-    /**
-     * Очистить form-level ошибки
-     */
-    clearFormErrors(): void;
-    /**
-     * Получить form-level ошибки
-     */
-    getFormErrors(): ValidationError[];
-    /**
-     * Установить флаг submitting
-     *
-     * @param value - true если форма отправляется, false если нет
-     *
-     * @example
-     * ```typescript
-     * stateManager.setSubmitting(true);
-     * await api.submitForm(form.getValue());
-     * stateManager.setSubmitting(false);
-     * ```
-     */
-    setSubmitting(value: boolean): void;
-    /**
-     * Установить флаг disabled
-     *
-     * @param value - true если форма disabled, false если нет
-     */
-    setDisabled(value: boolean): void;
-    /**
-     * Получить флаг disabled
-     */
-    isDisabled(): boolean;
-}