@reformer/core 1.1.0 → 2.0.0-beta.2

package/dist/core/nodes/form-node.js

@@ -1,343 +0,0 @@
-/**
- * FormNode - абстрактный базовый класс для всех узлов формы
- *
- * Аналог AbstractControl из Angular Forms
- * Унифицирует работу с полями (FieldNode), группами (GroupNode) и массивами (ArrayNode)
- *
- * Использует Template Method паттерн для управления состоянием:
- * - Публичные методы (markAsTouched, disable и т.д.) реализованы в базовом классе
- * - Protected hooks (onMarkAsTouched, onDisable и т.д.) переопределяются в наследниках
- *
- * @group Nodes
- */
-import { signal, computed } from '@preact/signals-core';
-/**
- * Абстрактный базовый класс для всех узлов формы
- *
- * Все узлы (поля, группы, массивы) наследуют от этого класса
- * и реализуют единый интерфейс для работы с состоянием и валидацией
- *
- * Template Method паттерн используется для управления состоянием:
- * - Общие signals (_touched, _dirty, _status) определены в базовом классе
- * - Публичные методы (markAsTouched, disable и т.д.) реализованы здесь
- * - Protected hooks (onMarkAsTouched, onDisable и т.д.) переопределяются в наследниках
- *
- * @group Nodes
- */
-export class FormNode {
-    // ============================================================================
-    // Protected состояние (для Template Method паттерна)
-    // ============================================================================
-    /**
-     * Пользователь взаимодействовал с узлом (touched)
-     * Protected: наследники могут читать/изменять через методы
-     */
-    _touched = signal(false);
-    /**
-     * Значение узла было изменено (dirty)
-     * Protected: наследники могут читать/изменять через методы
-     */
-    _dirty = signal(false);
-    /**
-     * Текущий статус узла
-     * Protected: наследники могут читать/изменять через методы
-     */
-    _status = signal('valid');
-    // ============================================================================
-    // Публичные computed signals (readonly для внешнего мира)
-    // ============================================================================
-    /**
-     * Пользователь взаимодействовал с узлом (touched)
-     * Computed из _touched для предоставления readonly интерфейса
-     */
-    touched = computed(() => this._touched.value);
-    /**
-     * Пользователь не взаимодействовал с узлом (untouched)
-     */
-    untouched = computed(() => !this._touched.value);
-    /**
-     * Значение узла было изменено (dirty)
-     * Computed из _dirty для предоставления readonly интерфейса
-     */
-    dirty = computed(() => this._dirty.value);
-    /**
-     * Значение узла не было изменено (pristine)
-     */
-    pristine = computed(() => !this._dirty.value);
-    /**
-     * Текущий статус узла
-     * Computed из _status для предоставления readonly интерфейса
-     */
-    status = computed(() => this._status.value);
-    /**
-     * Узел отключен (disabled)
-     */
-    disabled = computed(() => this._status.value === 'disabled');
-    /**
-     * Узел включен (enabled)
-     */
-    enabled = computed(() => this._status.value !== 'disabled');
-    /**
-     * Получить ошибки валидации с фильтрацией
-     *
-     * Позволяет фильтровать ошибки по различным критериям:
-     * - По коду ошибки
-     * - По сообщению (частичное совпадение)
-     * - По параметрам
-     * - Через кастомный предикат
-     *
-     * Без параметров возвращает все ошибки (эквивалент errors.value)
-     *
-     * @param options - Опции фильтрации ошибок
-     * @returns Отфильтрованный массив ошибок валидации
-     *
-     * @example
-     * ```typescript
-     * // Все ошибки
-     * const allErrors = form.getErrors();
-     *
-     * // Ошибки с конкретным кодом
-     * const requiredErrors = form.getErrors({ code: 'required' });
-     *
-     * // Ошибки с несколькими кодами
-     * const errors = form.getErrors({ code: ['required', 'email'] });
-     *
-     * // Ошибки по сообщению
-     * const passwordErrors = form.getErrors({ message: 'Password' });
-     *
-     * // Ошибки по параметрам
-     * const minLengthErrors = form.getErrors({
-     *   params: { minLength: 8 }
-     * });
-     *
-     * // Кастомная фильтрация
-     * const customErrors = form.getErrors({
-     *   predicate: (err) => err.code.startsWith('custom_')
-     * });
-     * ```
-     */
-    getErrors(options) {
-        const allErrors = this.errors.value;
-        // Без фильтрации - вернуть все ошибки
-        if (!options) {
-            return allErrors;
-        }
-        return allErrors.filter((error) => {
-            // Фильтр по коду
-            if (options.code !== undefined) {
-                const codes = Array.isArray(options.code) ? options.code : [options.code];
-                if (!codes.includes(error.code)) {
-                    return false;
-                }
-            }
-            // Фильтр по сообщению (частичное совпадение, регистронезависимый)
-            if (options.message !== undefined) {
-                if (!error.message.toLowerCase().includes(options.message.toLowerCase())) {
-                    return false;
-                }
-            }
-            // Фильтр по параметрам
-            if (options.params !== undefined) {
-                if (!error.params) {
-                    return false;
-                }
-                // Проверяем, что все ключи из options.params присутствуют в error.params
-                // и имеют те же значения
-                for (const [key, value] of Object.entries(options.params)) {
-                    if (error.params[key] !== value) {
-                        return false;
-                    }
-                }
-            }
-            // Кастомный предикат
-            if (options.predicate !== undefined) {
-                if (!options.predicate(error)) {
-                    return false;
-                }
-            }
-            return true;
-        });
-    }
-    // ============================================================================
-    // Методы управления состоянием (Template Method)
-    // ============================================================================
-    /**
-     * Отметить узел как touched (пользователь взаимодействовал)
-     *
-     * Template Method: обновляет signal в базовом классе,
-     * вызывает hook для кастомной логики в наследниках
-     */
-    markAsTouched() {
-        this._touched.value = true;
-        this.onMarkAsTouched();
-    }
-    /**
-     * Отметить узел как untouched
-     *
-     * Template Method: обновляет signal в базовом классе,
-     * вызывает hook для кастомной логики в наследниках
-     */
-    markAsUntouched() {
-        this._touched.value = false;
-        this.onMarkAsUntouched();
-    }
-    /**
-     * Отметить узел как dirty (значение изменено)
-     *
-     * Template Method: обновляет signal в базовом классе,
-     * вызывает hook для кастомной логики в наследниках
-     */
-    markAsDirty() {
-        this._dirty.value = true;
-        this.onMarkAsDirty();
-    }
-    /**
-     * Отметить узел как pristine (значение не изменено)
-     *
-     * Template Method: обновляет signal в базовом классе,
-     * вызывает hook для кастомной логики в наследниках
-     */
-    markAsPristine() {
-        this._dirty.value = false;
-        this.onMarkAsPristine();
-    }
-    /**
-     * Пометить все поля (включая вложенные) как touched
-     * Алиас для markAsTouched(), но более явно показывает намерение
-     * пометить ВСЕ поля рекурсивно
-     *
-     * Полезно для:
-     * - Показа всех ошибок валидации перед submit
-     * - Принудительного отображения ошибок при нажатии "Validate All"
-     * - Отображения невалидных полей в wizard/step form
-     *
-     * @example
-     * ```typescript
-     * // Показать все ошибки перед submit
-     * form.touchAll();
-     * const isValid = await form.validate();
-     * if (!isValid) {
-     *   // Все ошибки теперь видны пользователю
-     * }
-     *
-     * // Или использовать submit() который уже вызывает touchAll
-     * await form.submit(async (values) => {
-     *   await api.save(values);
-     * });
-     * ```
-     */
-    touchAll() {
-        this.markAsTouched();
-    }
-    // ============================================================================
-    // Методы управления доступностью (Template Method)
-    // ============================================================================
-    /**
-     * Отключить узел
-     *
-     * Template Method: обновляет статус в базовом классе,
-     * вызывает hook для кастомной логики в наследниках
-     *
-     * Отключенные узлы не проходят валидацию и не включаются в getValue()
-     */
-    disable() {
-        this._status.value = 'disabled';
-        this.onDisable();
-    }
-    /**
-     * Включить узел
-     *
-     * Template Method: обновляет статус в базовом классе,
-     * вызывает hook для кастомной логики в наследниках
-     */
-    enable() {
-        this._status.value = 'valid';
-        this.onEnable();
-    }
-    // ============================================================================
-    // Protected hooks (для переопределения в наследниках)
-    // ============================================================================
-    /**
-     * Hook: вызывается после markAsTouched()
-     *
-     * Переопределите в наследниках для дополнительной логики:
-     * - GroupNode: пометить все дочерние узлы как touched
-     * - ArrayNode: пометить все элементы массива как touched
-     * - FieldNode: пустая реализация (нет дочерних узлов)
-     *
-     * @example
-     * ```typescript
-     * // GroupNode
-     * protected onMarkAsTouched(): void {
-     *   this.fields.forEach(field => field.markAsTouched());
-     * }
-     * ```
-     */
-    onMarkAsTouched() {
-        // Пустая реализация по умолчанию
-        // Наследники переопределяют при необходимости
-    }
-    /**
-     * Hook: вызывается после markAsUntouched()
-     *
-     * Переопределите в наследниках для дополнительной логики:
-     * - GroupNode: пометить все дочерние узлы как untouched
-     * - ArrayNode: пометить все элементы массива как untouched
-     * - FieldNode: пустая реализация (нет дочерних узлов)
-     */
-    onMarkAsUntouched() {
-        // Пустая реализация по умолчанию
-    }
-    /**
-     * Hook: вызывается после markAsDirty()
-     *
-     * Переопределите в наследниках для дополнительной логики:
-     * - GroupNode: может обновить родительскую форму
-     * - ArrayNode: может обновить родительскую форму
-     * - FieldNode: пустая реализация
-     */
-    onMarkAsDirty() {
-        // Пустая реализация по умолчанию
-    }
-    /**
-     * Hook: вызывается после markAsPristine()
-     *
-     * Переопределите в наследниках для дополнительной логики:
-     * - GroupNode: пометить все дочерние узлы как pristine
-     * - ArrayNode: пометить все элементы массива как pristine
-     * - FieldNode: пустая реализация
-     */
-    onMarkAsPristine() {
-        // Пустая реализация по умолчанию
-    }
-    /**
-     * Hook: вызывается после disable()
-     *
-     * Переопределите в наследниках для дополнительной логики:
-     * - GroupNode: отключить все дочерние узлы
-     * - ArrayNode: отключить все элементы массива
-     * - FieldNode: очистить ошибки валидации
-     *
-     * @example
-     * ```typescript
-     * // GroupNode
-     * protected onDisable(): void {
-     *   this.fields.forEach(field => field.disable());
-     * }
-     * ```
-     */
-    onDisable() {
-        // Пустая реализация по умолчанию
-    }
-    /**
-     * Hook: вызывается после enable()
-     *
-     * Переопределите в наследниках для дополнительной логики:
-     * - GroupNode: включить все дочерние узлы
-     * - ArrayNode: включить все элементы массива
-     * - FieldNode: пустая реализация
-     */
-    onEnable() {
-        // Пустая реализация по умолчанию
-    }
-}

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>>;
-}