@reformer/core 1.0.0-beta.3

package/dist/core/nodes/group-node/field-registry.d.ts

@@ -0,0 +1,191 @@
+/**
+ * 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);
+ * });
+ * ```
+ */
+import type { FormNode } from '../form-node';
+import type { FormValue } from '../../types';
+/**
+ * Реестр полей формы
+ *
+ * Предоставляет типобезопасный доступ к полям формы
+ * через Map-подобный интерфейс
+ *
+ * @template T Тип формы (объект)
+ */
+export declare class FieldRegistry<T> {
+    /**
+     * Внутреннее хранилище полей
+     * Map обеспечивает быструю lookup производительность O(1)
+     */
+    private fields;
+    /**
+     * Установить поле в реестр
+     *
+     * @param key - Ключ поля (имя свойства в типе T)
+     * @param node - FormNode для этого поля
+     *
+     * @example
+     * ```typescript
+     * registry.set('email', new FieldNode({ value: '' }));
+     * ```
+     */
+    set<K extends keyof T>(key: K, node: FormNode<T[K]>): void;
+    /**
+     * Получить поле из реестра
+     *
+     * @param key - Ключ поля
+     * @returns FormNode или undefined, если поле не найдено
+     *
+     * @example
+     * ```typescript
+     * const emailField = registry.get('email');
+     * if (emailField) {
+     *   console.log(emailField.value.value);
+     * }
+     * ```
+     */
+    get<K extends keyof T>(key: K): FormNode<T[K]> | undefined;
+    /**
+     * Проверить наличие поля в реестре
+     *
+     * @param key - Ключ поля
+     * @returns true если поле существует
+     *
+     * @example
+     * ```typescript
+     * if (registry.has('email')) {
+     *   console.log('Email field exists');
+     * }
+     * ```
+     */
+    has(key: keyof T): boolean;
+    /**
+     * Удалить поле из реестра
+     *
+     * @param key - Ключ поля
+     * @returns true если поле было удалено, false если поля не было
+     *
+     * @example
+     * ```typescript
+     * registry.delete('email');
+     * ```
+     */
+    delete(key: keyof T): boolean;
+    /**
+     * Перебрать все поля
+     *
+     * @param callback - Функция обратного вызова для каждого поля
+     *
+     * @example
+     * ```typescript
+     * registry.forEach((field, key) => {
+     *   console.log(`${key}: ${field.value.value}`);
+     * });
+     * ```
+     */
+    forEach(callback: (field: FormNode<FormValue>, key: keyof T) => void): void;
+    /**
+     * Получить итератор значений (полей)
+     *
+     * @returns Итератор по всем полям
+     *
+     * @example
+     * ```typescript
+     * for (const field of registry.values()) {
+     *   await field.validate();
+     * }
+     * ```
+     */
+    values(): IterableIterator<FormNode<FormValue>>;
+    /**
+     * Получить итератор пар [ключ, значение]
+     *
+     * @returns Итератор по всем записям
+     *
+     * @example
+     * ```typescript
+     * for (const [key, field] of registry.entries()) {
+     *   console.log(key, field.value.value);
+     * }
+     * ```
+     */
+    entries(): IterableIterator<[keyof T, FormNode<FormValue>]>;
+    /**
+     * Получить итератор ключей полей
+     *
+     * @returns Итератор по всем ключам
+     *
+     * @example
+     * ```typescript
+     * const fieldNames = Array.from(registry.keys());
+     * // ['email', 'name', 'age']
+     * ```
+     */
+    keys(): IterableIterator<keyof T>;
+    /**
+     * Получить количество полей
+     *
+     * @returns Количество зарегистрированных полей
+     *
+     * @example
+     * ```typescript
+     * console.log(`Form has ${registry.size()} fields`);
+     * ```
+     */
+    size(): number;
+    /**
+     * Очистить все поля
+     *
+     * Удаляет все поля из реестра
+     *
+     * @example
+     * ```typescript
+     * registry.clear();
+     * console.log(registry.size()); // 0
+     * ```
+     */
+    clear(): void;
+    /**
+     * Получить все поля как массив
+     *
+     * Полезно для операций, требующих работу с массивом
+     *
+     * @returns Массив всех полей
+     *
+     * @example
+     * ```typescript
+     * const allValid = registry.toArray().every(field => field.valid.value);
+     * ```
+     */
+    toArray(): FormNode<FormValue>[];
+    /**
+     * Получить Map-представление реестра (readonly)
+     *
+     * Используйте для совместимости с существующим кодом
+     *
+     * @returns ReadonlyMap с полями
+     * @internal
+     *
+     * @example
+     * ```typescript
+     * const mapView = registry.asMap();
+     * ```
+     */
+    asMap(): ReadonlyMap<keyof T, FormNode<FormValue>>;
+}

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

@@ -0,0 +1,215 @@
+/**
+ * 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

@@ -0,0 +1,11 @@
+/**
+ * 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

@@ -0,0 +1,11 @@
+/**
+ * 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

@@ -0,0 +1,71 @@
+/**
+ * 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

@@ -0,0 +1,161 @@
+/**
+ * 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);
+            },
+        });
+    }
+}