@reformer/core 1.1.0 → 2.0.0-beta.2

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

@@ -1,534 +0,0 @@
-/**
- * ArrayNode - узел формы для работы с массивами
- *
- * Управляет массивом форм с поддержкой:
- * - Динамического добавления/удаления элементов
- * - Валидации всех элементов
- * - Реактивного состояния через signals
- *
- * @group Nodes
- */
-import { signal, computed, effect } from '@preact/signals-core';
-import { FormNode } from './form-node';
-import { GroupNode } from './group-node';
-import { SubscriptionManager } from '../utils/subscription-manager';
-/**
- * ArrayNode - массив форм с реактивным состоянием
- *
- * @group Nodes
- *
- * @example
- * ```typescript
- * const array = new ArrayNode({
- *   title: { value: '', component: Input },
- *   price: { value: 0, component: Input },
- * });
- *
- * array.push({ title: 'Item 1', price: 100 });
- * array.at(0)?.title.setValue('Updated');
- * console.log(array.length.value); // 1
- * ```
- */
-export class ArrayNode extends FormNode {
-    // ============================================================================
-    // Приватные поля
-    // ============================================================================
-    items;
-    itemSchema;
-    initialItems;
-    /**
-     * Менеджер подписок для централизованного cleanup
-     * Использует SubscriptionManager вместо массива для управления подписками
-     */
-    disposers = new SubscriptionManager();
-    // ============================================================================
-    // Приватные поля для сохранения схем
-    // ============================================================================
-    validationSchemaFn;
-    behaviorSchemaFn;
-    // ============================================================================
-    // Публичные computed signals
-    // ============================================================================
-    value;
-    valid;
-    invalid;
-    touched;
-    dirty;
-    pending;
-    errors;
-    status;
-    length;
-    // ============================================================================
-    // Конструктор
-    // ============================================================================
-    constructor(schema, initialItems = []) {
-        super();
-        this.itemSchema = schema;
-        this.initialItems = initialItems;
-        this.items = signal([]);
-        // Создать начальные элементы
-        for (const initialValue of initialItems) {
-            this.push(initialValue);
-        }
-        // ============================================================================
-        // Computed signals
-        // ============================================================================
-        this.length = computed(() => this.items.value.length);
-        this.value = computed(() => this.items.value.map((item) => item.value.value));
-        this.valid = computed(() => this.items.value.every((item) => item.valid.value));
-        this.invalid = computed(() => !this.valid.value);
-        this.pending = computed(() => this.items.value.some((item) => item.pending.value));
-        this.touched = computed(() => this.items.value.some((item) => item.touched.value));
-        this.dirty = computed(() => this.items.value.some((item) => item.dirty.value));
-        this.errors = computed(() => {
-            const allErrors = [];
-            this.items.value.forEach((item) => {
-                allErrors.push(...item.errors.value);
-            });
-            return allErrors;
-        });
-        this.status = computed(() => {
-            if (this.pending.value)
-                return 'pending';
-            if (this.invalid.value)
-                return 'invalid';
-            return 'valid';
-        });
-    }
-    // ============================================================================
-    // CRUD операции
-    // ============================================================================
-    /**
-     * Добавить элемент в конец массива
-     * @param initialValue - Начальные значения для нового элемента
-     */
-    push(initialValue) {
-        const newItem = this.createItem(initialValue);
-        this.items.value = [...this.items.value, newItem];
-    }
-    /**
-     * Удалить элемент по индексу
-     * @param index - Индекс элемента для удаления
-     */
-    removeAt(index) {
-        if (index < 0 || index >= this.items.value.length) {
-            if (import.meta.env.DEV) {
-                console.warn(`ArrayNode: index ${index} out of bounds (length: ${this.items.value.length})`);
-            }
-            return;
-        }
-        this.items.value = this.items.value.filter((_, i) => i !== index);
-    }
-    /**
-     * Вставить элемент в массив
-     * @param index - Индекс для вставки
-     * @param initialValue - Начальные значения для нового элемента
-     */
-    insert(index, initialValue) {
-        if (index < 0 || index > this.items.value.length) {
-            if (import.meta.env.DEV) {
-                console.warn(`ArrayNode: index ${index} out of bounds (length: ${this.items.value.length})`);
-            }
-            return;
-        }
-        const newItem = this.createItem(initialValue);
-        const newItems = [...this.items.value];
-        newItems.splice(index, 0, newItem);
-        this.items.value = newItems;
-    }
-    /**
-     * Удалить все элементы массива
-     */
-    clear() {
-        this.items.value = [];
-    }
-    /**
-     * Получить элемент по индексу
-     * @param index - Индекс элемента
-     * @returns Типизированный GroupNode или undefined если индекс вне границ
-     */
-    at(index) {
-        return this.items.value[index];
-    }
-    // ============================================================================
-    // Реализация абстрактных методов
-    // ============================================================================
-    getValue() {
-        return this.items.value.map((item) => item.getValue());
-    }
-    setValue(values, options) {
-        this.clear();
-        values.forEach((value) => this.push(value));
-        // Запускаем валидацию если emitEvent !== false
-        // Fire-and-forget (не ждем результат, как в FieldNode)
-        if (options?.emitEvent !== false) {
-            this.validate().catch(() => {
-                // Игнорируем ошибки валидации (они будут в errors signal)
-            });
-        }
-    }
-    patchValue(values) {
-        values.forEach((value, index) => {
-            if (this.items.value[index] && value !== undefined) {
-                this.items.value[index].patchValue(value);
-            }
-        });
-    }
-    /**
-     * Сбросить массив к указанным значениям (или очистить)
-     *
-     * @param values - опциональный массив значений для сброса
-     *
-     * @remarks
-     * Очищает текущий массив и заполняет новыми элементами
-     *
-     * @example
-     * ```typescript
-     * // Очистить массив
-     * arrayNode.reset();
-     *
-     * // Сбросить к новым значениям
-     * arrayNode.reset([{ name: 'Item 1' }, { name: 'Item 2' }]);
-     * ```
-     */
-    reset(values) {
-        this.clear();
-        if (values) {
-            values.forEach((value) => this.push(value));
-        }
-    }
-    /**
-     * Сбросить массив к исходным значениям (initialItems)
-     *
-     * @remarks
-     * Восстанавливает массив в состояние, которое было при создании ArrayNode.
-     * Более явный способ сброса к начальным значениям по сравнению с reset()
-     *
-     * Полезно когда:
-     * - Пользователь нажал "Cancel" - вернуть массив к исходным элементам
-     * - Массив был изменен через reset(newValues), но нужно вернуться к началу
-     * - Явное намерение показать "отмена всех изменений"
-     *
-     * @example
-     * ```typescript
-     * const arrayNode = new ArrayNode(
-     *   { name: { value: '', component: Input } },
-     *   [{ name: 'Initial 1' }, { name: 'Initial 2' }]
-     * );
-     *
-     * arrayNode.push({ name: 'New Item' });
-     * arrayNode.reset([{ name: 'Temp' }]);
-     * console.log(arrayNode.length.value); // 1
-     *
-     * arrayNode.resetToInitial();
-     * console.log(arrayNode.length.value); // 2
-     * console.log(arrayNode.at(0)?.name.value.value); // 'Initial 1'
-     * ```
-     */
-    resetToInitial() {
-        this.clear();
-        this.initialItems.forEach((value) => this.push(value));
-    }
-    async validate() {
-        const results = await Promise.all(this.items.value.map((item) => item.validate()));
-        return results.every(Boolean);
-    }
-    setErrors(_errors) {
-        // ArrayNode level errors - можно реализовать позже
-        // Пока просто игнорируем
-    }
-    clearErrors() {
-        this.items.value.forEach((item) => item.clearErrors());
-    }
-    // ============================================================================
-    // Protected hooks (Template Method pattern)
-    // ============================================================================
-    /**
-     * Hook: вызывается после markAsTouched()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как touched
-     */
-    onMarkAsTouched() {
-        this.items.value.forEach((item) => item.markAsTouched());
-    }
-    /**
-     * Hook: вызывается после markAsUntouched()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как untouched
-     */
-    onMarkAsUntouched() {
-        this.items.value.forEach((item) => item.markAsUntouched());
-    }
-    /**
-     * Hook: вызывается после markAsDirty()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как dirty
-     */
-    onMarkAsDirty() {
-        this.items.value.forEach((item) => item.markAsDirty());
-    }
-    /**
-     * Hook: вызывается после markAsPristine()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как pristine
-     */
-    onMarkAsPristine() {
-        this.items.value.forEach((item) => item.markAsPristine());
-    }
-    // ============================================================================
-    // Итерация
-    // ============================================================================
-    /**
-     * Итерировать по элементам массива
-     * @param callback - Функция, вызываемая для каждого элемента с типизированным GroupNode
-     */
-    forEach(callback) {
-        this.items.value.forEach((item, index) => {
-            callback(item, index);
-        });
-    }
-    /**
-     * Маппинг элементов массива
-     * @param callback - Функция преобразования с типизированным GroupNode
-     * @returns Новый массив результатов
-     */
-    map(callback) {
-        return this.items.value.map((item, index) => {
-            return callback(item, index);
-        });
-    }
-    // ============================================================================
-    // Private методы
-    // ============================================================================
-    /**
-     * Создать новый элемент массива на основе схемы
-     * @param initialValue - Начальные значения
-     */
-    createItem(initialValue) {
-        // Определить тип узла на основе схемы
-        if (this.isGroupSchema(this.itemSchema)) {
-            const node = new GroupNode(this.itemSchema);
-            if (initialValue) {
-                node.patchValue(initialValue);
-            }
-            // Применяем validation schema к новому элементу, если она была установлена
-            if (this.validationSchemaFn && 'applyValidationSchema' in node) {
-                node.applyValidationSchema(this.validationSchemaFn);
-            }
-            //  Применяем behavior schema к новому элементу, если она была установлена
-            if (this.behaviorSchemaFn && 'applyBehaviorSchema' in node) {
-                node.applyBehaviorSchema(this.behaviorSchemaFn);
-            }
-            return node;
-        }
-        // Если схема - FieldConfig, ArrayNode не поддерживает примитивные массивы
-        throw new Error('ArrayNode поддерживает только GroupNode элементы. ' +
-            'Для массива примитивов используйте обычное поле с типом массива.');
-    }
-    /**
-     * Проверить, является ли схема групповой (объект полей)
-     * @param schema - Схема для проверки
-     */
-    isGroupSchema(schema) {
-        return (typeof schema === 'object' &&
-            schema !== null &&
-            !('component' in schema) &&
-            !Array.isArray(schema));
-    }
-    // ============================================================================
-    // Validation Schema
-    // ============================================================================
-    /**
-     * Применить validation schema ко всем элементам массива
-     *
-     * Validation schema будет применена к:
-     * - Всем существующим элементам
-     * - Всем новым элементам, добавляемым через push/insert
-     *
-     * @param schemaFn - Функция валидации для элемента массива
-     *
-     * @example
-     * ```typescript
-     * import { propertyValidation } from './validation/property-validation';
-     *
-     * form.properties.applyValidationSchema(propertyValidation);
-     * ```
-     */
-    applyValidationSchema(schemaFn) {
-        // Сохраняем validation schema для применения к новым элементам
-        this.validationSchemaFn = schemaFn;
-        // Применяем validation schema ко всем существующим элементам
-        this.items.value.forEach((item) => {
-            if ('applyValidationSchema' in item &&
-                typeof item.applyValidationSchema === 'function') {
-                item.applyValidationSchema(schemaFn);
-            }
-        });
-    }
-    /**
-     * Применить behavior schema ко всем элементам ArrayNode
-     *
-     * Автоматически применяется к новым элементам при push/insert.
-     *
-     * @param schemaFn - Behavior schema функция
-     *
-     * @example
-     * ```typescript
-     * import { addressBehavior } from './behaviors/address-behavior';
-     *
-     * form.addresses.applyBehaviorSchema(addressBehavior);
-     * ```
-     */
-    applyBehaviorSchema(schemaFn) {
-        // Сохраняем behavior schema для применения к новым элементам
-        this.behaviorSchemaFn = schemaFn;
-        // Применяем behavior schema ко всем существующим элементам
-        this.items.value.forEach((item) => {
-            if ('applyBehaviorSchema' in item &&
-                typeof item.applyBehaviorSchema === 'function') {
-                item.applyBehaviorSchema(schemaFn);
-            }
-        });
-    }
-    // ============================================================================
-    // Методы-помощники для реактивности (Фаза 1)
-    // ============================================================================
-    /**
-     * Подписка на изменения конкретного поля во всех элементах массива
-     * Срабатывает при изменении значения поля в любом элементе
-     *
-     * @param fieldKey - Ключ поля для отслеживания
-     * @param callback - Функция, вызываемая при изменении, получает массив всех значений и индекс измененного элемента
-     * @returns Функция отписки для cleanup
-     *
-     * @example
-     * ```typescript
-     * // Автоматический пересчет общей стоимости при изменении цен
-     * const dispose = form.existingLoans.watchItems(
-     *   'remainingAmount',
-     *   (amounts) => {
-     *     const totalDebt = amounts.reduce((sum, amount) => sum + (amount || 0), 0);
-     *     form.totalDebt.setValue(totalDebt);
-     *   }
-     * );
-     *
-     * // При изменении любого remainingAmount → пересчитается totalDebt
-     * form.existingLoans.at(0)?.remainingAmount.setValue(500000);
-     *
-     * // Cleanup
-     * useEffect(() => dispose, []);
-     * ```
-     */
-    watchItems(fieldKey, callback) {
-        const dispose = effect(() => {
-            // Отслеживаем изменения всех элементов массива
-            const values = this.items.value.map((item) => {
-                if (item instanceof GroupNode) {
-                    const field = item.getFieldByPath(fieldKey);
-                    return field?.value.value;
-                }
-                return undefined;
-            });
-            callback(values);
-        });
-        // Регистрируем через SubscriptionManager и возвращаем unsubscribe
-        const key = `watchItems-${Date.now()}-${Math.random()}`;
-        return this.disposers.add(key, dispose);
-    }
-    /**
-     * Подписка на изменение длины массива
-     * Срабатывает при добавлении/удалении элементов
-     *
-     * @param callback - Функция, вызываемая при изменении длины, получает новую длину
-     * @returns Функция отписки для cleanup
-     *
-     * @example
-     * ```typescript
-     * // Обновление счетчика элементов в UI
-     * const dispose = form.properties.watchLength((length) => {
-     *   console.log(`Количество объектов недвижимости: ${length}`);
-     *   form.propertyCount.setValue(length);
-     * });
-     *
-     * form.properties.push({ title: 'Квартира', value: 5000000 });
-     * // Выведет: "Количество объектов недвижимости: 1"
-     *
-     * // Cleanup
-     * useEffect(() => dispose, []);
-     * ```
-     */
-    watchLength(callback) {
-        const dispose = effect(() => {
-            const currentLength = this.length.value;
-            callback(currentLength);
-        });
-        // Регистрируем через SubscriptionManager и возвращаем unsubscribe
-        const key = `watchLength-${Date.now()}-${Math.random()}`;
-        return this.disposers.add(key, dispose);
-    }
-    /**
-     * Очистить все ресурсы узла
-     * Рекурсивно очищает все subscriptions и элементы массива
-     *
-     * @example
-     * ```typescript
-     * useEffect(() => {
-     *   return () => {
-     *     arrayNode.dispose();
-     *   };
-     * }, []);
-     * ```
-     */
-    dispose() {
-        // Очищаем все subscriptions через SubscriptionManager
-        this.disposers.dispose();
-        // Очищаем элементы массива
-        this.items.value.forEach((item) => {
-            if ('dispose' in item && typeof item.dispose === 'function') {
-                item.dispose();
-            }
-        });
-    }
-    /**
-     * Hook: вызывается после disable()
-     *
-     * Для ArrayNode: рекурсивно отключаем все элементы массива
-     *
-     * @example
-     * ```typescript
-     * // Отключить весь массив полей
-     * form.items.disable();
-     *
-     * // Все элементы становятся disabled
-     * form.items.forEach(item => {
-     *   console.log(item.status.value); // 'disabled'
-     * });
-     * ```
-     */
-    onDisable() {
-        this.items.value.forEach((item) => {
-            item.disable();
-        });
-    }
-    /**
-     * Hook: вызывается после enable()
-     *
-     * Для ArrayNode: рекурсивно включаем все элементы массива
-     *
-     * @example
-     * ```typescript
-     * // Включить весь массив полей
-     * form.items.enable();
-     *
-     * // Все элементы становятся enabled
-     * form.items.forEach(item => {
-     *   console.log(item.status.value); // 'valid' или 'invalid'
-     * });
-     * ```
-     */
-    onEnable() {
-        this.items.value.forEach((item) => {
-            item.enable();
-        });
-    }
-}