@reformer/core 1.1.0-beta.7 → 1.1.0-beta.8

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.js

@@ -1,265 +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 { signal, computed } from '@preact/signals-core';
-/**
- * Менеджер состояния для GroupNode
- *
- * Создает и управляет всеми сигналами состояния формы:
- * - value - значение формы как объект
- * - valid/invalid - валидность формы
- * - touched/dirty - пользовательское взаимодействие
- * - pending - асинхронная валидация в процессе
- * - errors - все ошибки валидации (form-level + field-level)
- * - status - общий статус формы
- * - submitting - флаг отправки формы
- *
- * @template T Тип формы (объект)
- */
-export class StateManager {
-    fieldRegistry;
-    // ============================================================================
-    // Приватные сигналы (мутабельные)
-    // ============================================================================
-    /**
-     * Флаг отправки формы
-     * Устанавливается в true во время отправки формы на сервер
-     */
-    _submitting;
-    /**
-     * Флаг disabled состояния
-     * Если true, форма считается disabled
-     */
-    _disabled;
-    /**
-     * Form-level validation errors (не связанные с конкретным полем)
-     * Используется для server-side errors или кросс-полевой валидации
-     */
-    _formErrors;
-    // ============================================================================
-    // Публичные computed signals (read-only)
-    // ============================================================================
-    /**
-     * Значение формы как объект
-     *
-     * Computed signal, который автоматически пересчитывается при изменении любого поля.
-     * Использует мемоизацию - если зависимости не изменились, вернет закешированный объект.
-     *
-     * @example
-     * ```typescript
-     * const form = new GroupNode({ email: { value: 'test@mail.com' } });
-     * console.log(form.value.value); // { email: 'test@mail.com' }
-     * ```
-     */
-    value;
-    /**
-     * Форма валидна?
-     *
-     * Computed signal. Форма валидна, если:
-     * - Нет form-level errors
-     * - Все поля валидны
-     */
-    valid;
-    /**
-     * Форма невалидна?
-     *
-     * Computed signal. Инверсия valid.
-     */
-    invalid;
-    /**
-     * Хотя бы одно поле touched?
-     *
-     * Computed signal. Возвращает true, если хотя бы одно поле было touched.
-     */
-    touched;
-    /**
-     * Хотя бы одно поле dirty?
-     *
-     * Computed signal. Возвращает true, если хотя бы одно поле изменилось.
-     */
-    dirty;
-    /**
-     * Асинхронная валидация в процессе?
-     *
-     * Computed signal. Возвращает true, если хотя бы одно поле находится в pending состоянии.
-     */
-    pending;
-    /**
-     * Все ошибки валидации
-     *
-     * Computed signal. Возвращает массив всех ошибок:
-     * - Form-level errors
-     * - Field-level errors (из всех вложенных полей)
-     */
-    errors;
-    /**
-     * Общий статус формы
-     *
-     * Computed signal. Возможные значения:
-     * - 'disabled' - форма disabled
-     * - 'pending' - асинхронная валидация в процессе
-     * - 'invalid' - форма невалидна
-     * - 'valid' - форма валидна
-     */
-    status;
-    /**
-     * Форма в процессе отправки?
-     *
-     * Computed signal (обертка над _submitting для read-only доступа).
-     */
-    submitting;
-    // ============================================================================
-    // Конструктор
-    // ============================================================================
-    /**
-     * Создать менеджер состояния
-     *
-     * @param fieldRegistry - реестр полей формы
-     */
-    constructor(fieldRegistry) {
-        this.fieldRegistry = fieldRegistry;
-        // Инициализация приватных сигналов
-        this._submitting = signal(false);
-        this._disabled = signal(false);
-        this._formErrors = signal([]);
-        // Создание computed signals
-        // Computed signal для значения формы
-        // Автоматически кеширует результат (мемоизация)
-        // Первый вызов: O(n) где n = количество полей
-        // Повторные вызовы (если зависимости не изменились): O(1) (возврат кешированного объекта)
-        this.value = computed(() => {
-            const result = {};
-            this.fieldRegistry.forEach((field, key) => {
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                result[key] = field.value.value;
-            });
-            return result;
-        });
-        // Computed signal для валидности формы
-        this.valid = computed(() => {
-            // Проверяем отсутствие form-level errors
-            const hasFormErrors = this._formErrors.value.length > 0;
-            if (hasFormErrors)
-                return false;
-            // Проверяем все поля
-            return Array.from(this.fieldRegistry.values()).every((field) => field.valid.value);
-        });
-        // Computed signal для невалидности (инверсия valid)
-        this.invalid = computed(() => !this.valid.value);
-        // Computed signal для pending состояния
-        this.pending = computed(() => Array.from(this.fieldRegistry.values()).some((field) => field.pending.value));
-        // Computed signal для touched состояния
-        this.touched = computed(() => Array.from(this.fieldRegistry.values()).some((field) => field.touched.value));
-        // Computed signal для dirty состояния
-        this.dirty = computed(() => Array.from(this.fieldRegistry.values()).some((field) => field.dirty.value));
-        // Computed signal для ошибок (form-level + field-level)
-        this.errors = computed(() => {
-            const allErrors = [];
-            // Добавляем form-level errors
-            allErrors.push(...this._formErrors.value);
-            // Добавляем field-level errors
-            this.fieldRegistry.forEach((field) => {
-                allErrors.push(...field.errors.value);
-            });
-            return allErrors;
-        });
-        // Computed signal для статуса формы
-        this.status = computed(() => {
-            if (this._disabled.value)
-                return 'disabled';
-            if (this.pending.value)
-                return 'pending';
-            if (this.invalid.value)
-                return 'invalid';
-            return 'valid';
-        });
-        // Computed signal для submitting (read-only обертка)
-        this.submitting = computed(() => this._submitting.value);
-    }
-    // ============================================================================
-    // Публичные методы для управления состоянием
-    // ============================================================================
-    /**
-     * Установить form-level ошибки
-     *
-     * @param errors - массив ошибок валидации
-     *
-     * @example
-     * ```typescript
-     * // Server-side ошибки
-     * stateManager.setFormErrors([
-     *   { code: 'server_error', message: 'Пользователь с таким email уже существует' }
-     * ]);
-     * ```
-     */
-    setFormErrors(errors) {
-        this._formErrors.value = errors;
-    }
-    /**
-     * Очистить form-level ошибки
-     */
-    clearFormErrors() {
-        this._formErrors.value = [];
-    }
-    /**
-     * Получить form-level ошибки
-     */
-    getFormErrors() {
-        return this._formErrors.value;
-    }
-    /**
-     * Установить флаг submitting
-     *
-     * @param value - true если форма отправляется, false если нет
-     *
-     * @example
-     * ```typescript
-     * stateManager.setSubmitting(true);
-     * await api.submitForm(form.getValue());
-     * stateManager.setSubmitting(false);
-     * ```
-     */
-    setSubmitting(value) {
-        this._submitting.value = value;
-    }
-    /**
-     * Установить флаг disabled
-     *
-     * @param value - true если форма disabled, false если нет
-     */
-    setDisabled(value) {
-        this._disabled.value = value;
-    }
-    /**
-     * Получить флаг disabled
-     */
-    isDisabled() {
-        return this._disabled.value;
-    }
-}