@reformer/core 1.0.0-beta.3

package/dist/core/nodes/group-node/state-manager.d.ts

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

package/dist/core/nodes/group-node/state-manager.js

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