@reformer/core 1.1.0-beta.8 → 2.0.0-beta.2

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

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