@reformer/core 10.2.0 → 11.0.0-beta.10

package/dist/form/factories/node-factory.d.ts

@@ -1,188 +0,0 @@
-import { FormNode } from '../nodes/form-node';
-import { ConfigWithSchema, ConfigWithValue, UnknownRecord } from '../types/index';
-/**
- * Фабрика для создания узлов формы.
- *
- * Определяет тип конфига и создаёт соответствующий узел (FieldNode, GroupNode, ArrayNode).
- * Используется внутри `getReformerForm`/`group`/`array` — явно вызывать обычно не нужно.
- *
- * @example
- * ```typescript
- * import { NodeFactory } from '@reformer/core';
- *
- * const factory = new NodeFactory();
- * const node = factory.createNode({ value: '', component: Input }); // → FieldNode<string>
- * ```
- */
-export declare class NodeFactory {
-    /**
-     * Создает узел формы на основе конфигурации
-     *
-     * ✅ ОБНОВЛЕНО: Теперь поддерживает массивы напрямую
-     *
-     * Автоматически определяет тип узла:
-     * - FieldNode: имеет value и component
-     * - ArrayNode: массив [schema, ...items] или { schema, initialItems }
-     * - GroupNode: объект без value, component, schema
-     *
-     * @param config Конфигурация узла
-     * @returns Экземпляр FieldNode, GroupNode или ArrayNode
-     * @throws Error если конфиг не соответствует ни одному типу
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * // FieldNode
-     * const field = factory.createNode({
-     *   value: 'test@mail.com',
-     *   component: Input,
-     *   validators: [required, email]
-     * });
-     *
-     * // GroupNode
-     * const group = factory.createNode({
-     *   email: { value: '', component: Input },
-     *   password: { value: '', component: Input }
-     * });
-     *
-     * // ArrayNode (объект)
-     * const array = factory.createNode({
-     *   schema: { title: { value: '', component: Input } },
-     *   initialItems: [{ title: 'Item 1' }]
-     * });
-     *
-     * // ArrayNode (массив) - новый формат
-     * const array2 = factory.createNode([
-     *   { title: { value: '', component: Input } }, // schema
-     *   { title: 'Item 1' }, // initial item 1
-     *   { title: 'Item 2' }  // initial item 2
-     * ]);
-     * ```
-     */
-    createNode(config: unknown): FormNode<unknown>;
-    /**
-     * Создать ArrayNode из массива [schema, ...initialItems]
-     *
-     * ✅ НОВОЕ: Извлечено из GroupNode для централизации логики
-     *
-     * Формат: [itemSchema, ...initialItems]
-     * - Первый элемент - схема элемента массива
-     * - Остальные элементы - начальные значения
-     *
-     * @param config Массив с схемой и начальными элементами
-     * @returns ArrayNode
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * // Массив с начальными элементами
-     * const array = factory.createArrayNodeFromArray([
-     *   { title: { value: '', component: Input } }, // schema
-     *   { title: 'Item 1' }, // initial value
-     *   { title: 'Item 2' }  // initial value
-     * ]);
-     * ```
-     * @private
-     */
-    private createArrayNodeFromArray;
-    /**
-     * Извлечь значения из схемы (рекурсивно)
-     *
-     * ✅ НОВОЕ: Извлечено из GroupNode для централизации логики
-     *
-     * Преобразует схему формы в объект со значениями:
-     * - `{ name: { value: 'John', component: Input } } → { name: 'John' }`
-     * - Поддерживает вложенные группы
-     * - Поддерживает массивы
-     *
-     * @param schema Схема формы
-     * @returns Объект со значениями полей
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * const schema = {
-     *   name: { value: 'John', component: Input },
-     *   age: { value: 30, component: Input },
-     *   address: {
-     *     city: { value: 'Moscow', component: Input }
-     *   }
-     * };
-     *
-     * factory.extractValues(schema);
-     * // { name: 'John', age: 30, address: { city: 'Moscow' } }
-     * ```
-     */
-    extractValues(schema: unknown): unknown;
-    /**
-     * Проверяет, является ли конфиг конфигурацией поля (FieldConfig)
-     *
-     * FieldConfig имеет обязательные свойства:
-     * - value: начальное значение поля
-     * - component: React-компонент для отображения
-     *
-     * @param config Проверяемая конфигурация
-     * @returns true если config является FieldConfig
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * factory.isFieldConfig({ value: '', component: Input }); // true
-     * factory.isFieldConfig({ email: { value: '' } }); // false
-     * factory.isFieldConfig(null); // false
-     * ```
-     */
-    isFieldConfig(config: unknown): config is ConfigWithValue;
-    /**
-     * Проверяет, является ли конфиг конфигурацией массива (ArrayConfig)
-     *
-     * ArrayConfig имеет обязательное свойство:
-     * - schema: схема для элементов массива
-     *
-     * И НЕ имеет:
-     * - value (отличие от FieldConfig)
-     *
-     * @param config Проверяемая конфигурация
-     * @returns true если config является ArrayConfig
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * factory.isArrayConfig({ schema: {}, initialItems: [] }); // true
-     * factory.isArrayConfig({ value: '', component: Input }); // false
-     * factory.isArrayConfig({ email: { value: '' } }); // false
-     * ```
-     */
-    isArrayConfig(config: unknown): config is ConfigWithSchema;
-    /**
-     * Проверяет, является ли конфиг конфигурацией группы (GroupConfig)
-     *
-     * GroupConfig - это объект, который:
-     * - НЕ является FieldConfig (нет value/component)
-     * - НЕ является ArrayConfig (нет schema)
-     * - Содержит вложенные конфиги полей/групп/массивов
-     *
-     * @param config Проверяемая конфигурация
-     * @returns true если config является GroupConfig
-     *
-     * @example
-     * ```typescript
-     * const factory = new NodeFactory();
-     *
-     * factory.isGroupConfig({
-     *   email: { value: '', component: Input },
-     *   password: { value: '', component: Input }
-     * }); // true
-     *
-     * factory.isGroupConfig({ value: '', component: Input }); // false
-     * factory.isGroupConfig({ schema: {} }); // false
-     * factory.isGroupConfig(null); // false
-     * ```
-     */
-    isGroupConfig(config: unknown): config is UnknownRecord;
-}

package/dist/form/form-submitter.d.ts

@@ -1,125 +0,0 @@
-import { ReadonlySignal } from '@preact/signals-core';
-/**
- * Интерфейс формы для FormSubmitter
- * Минимальный контракт для работы с любой формой
- */
-export interface SubmittableForm<T extends object> {
-    /** Пометить все поля как touched */
-    markAsTouched(): void;
-    /** Валидировать форму */
-    validate(): Promise<boolean>;
-    /** Получить значения формы */
-    getValue(): T;
-}
-/**
- * Опции для submit
- */
-export interface SubmitOptions {
-    /** Пропустить валидацию перед submit */
-    skipValidation?: boolean;
-    /** Пропустить markAsTouched перед submit */
-    skipTouch?: boolean;
-}
-/**
- * Результат submit
- */
-export interface SubmitResult<R> {
-    /** Успешно ли выполнен submit */
-    success: boolean;
-    /** Результат от onSubmit callback */
-    data: R | null;
-    /** Ошибка, если submit не удался */
-    error?: Error;
-}
-/**
- * FormSubmitter - управляет процессом отправки формы
- *
- * @example
- * ```typescript
- * const submitter = new FormSubmitter(form);
- *
- * // Простой submit
- * const result = await submitter.submit(async (values) => {
- *   return await api.saveForm(values);
- * });
- *
- * // Проверка состояния
- * if (submitter.submitting.value) {
- *   console.log('Форма отправляется...');
- * }
- * ```
- */
-export declare class FormSubmitter<T extends object> {
-    private readonly form;
-    /** Внутренний сигнал состояния отправки */
-    private readonly _submitting;
-    /** Публичный read-only сигнал состояния отправки */
-    readonly submitting: ReadonlySignal<boolean>;
-    /**
-     * @param form - Форма для отправки
-     */
-    constructor(form: SubmittableForm<T>);
-    /**
-     * Отправить форму
-     *
-     * Процесс:
-     * 1. Помечает все поля как touched (для отображения ошибок)
-     * 2. Валидирует форму
-     * 3. Если валидация успешна - вызывает onSubmit
-     * 4. Управляет состоянием submitting
-     *
-     * @param onSubmit - Callback для отправки данных
-     * @param options - Опции submit
-     * @returns Результат от onSubmit или `null` если валидация не пройдена
-     *
-     * @remarks
-     * Возвращаемый `null` неоднозначен: он сигналит и провал валидации, и легитимный `null`,
-     * который вернул `onSubmit` (или void-обработчик). Чтобы различать эти случаи, используйте
-     * {@link submitWithResult} — он отдаёт явный флаг `success`.
-     *
-     * @example
-     * ```typescript
-     * const result = await submitter.submit(async (values) => {
-     *   const response = await fetch('/api/form', {
-     *     method: 'POST',
-     *     body: JSON.stringify(values)
-     *   });
-     *   return response.json();
-     * });
-     *
-     * if (result === null) {
-     *   console.log('Форма не прошла валидацию');
-     * }
-     * ```
-     */
-    submit<R>(onSubmit: (values: T) => Promise<R> | R, options?: SubmitOptions): Promise<R | null>;
-    /**
-     * Отправить форму с расширенным результатом
-     *
-     * В отличие от submit(), возвращает объект с информацией об успехе/ошибке
-     *
-     * @param onSubmit - Callback для отправки данных
-     * @param options - Опции submit
-     * @returns Объект SubmitResult с данными и статусом
-     *
-     * @example
-     * ```typescript
-     * const result = await submitter.submitWithResult(async (values) => {
-     *   return await api.saveForm(values);
-     * });
-     *
-     * if (result.success) {
-     *   console.log('Сохранено:', result.data);
-     * } else if (result.error) {
-     *   console.error('Ошибка:', result.error.message);
-     * } else {
-     *   console.log('Валидация не пройдена');
-     * }
-     * ```
-     */
-    submitWithResult<R>(onSubmit: (values: T) => Promise<R> | R, options?: SubmitOptions): Promise<SubmitResult<R>>;
-    /**
-     * Проверить, идет ли отправка формы
-     */
-    isSubmitting(): boolean;
-}

package/dist/form/nodes/array-node.d.ts

@@ -1,360 +0,0 @@
-import { ReadonlySignal } from '@preact/signals-core';
-import { FormNode, SetValueOptions } from './form-node';
-import { FieldStatus, ValidationError } from '../types/index';
-import { FormSchema } from '../types/deep-schema';
-import { FormProxy } from '../types/form-proxy';
-/**
- * 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 declare class ArrayNode<T extends object> extends FormNode<T[]> {
-    private items;
-    private itemSchema;
-    private initialItems;
-    /**
-     * Менеджер подписок для централизованного cleanup
-     * Использует SubscriptionManager вместо массива для управления подписками
-     */
-    private disposers;
-    /** Array-level validation errors (e.g., "минимум 1 элемент") */
-    private readonly _arrayErrors;
-    private validationSchemaFn?;
-    private behaviorSchemaFn?;
-    readonly value: ReadonlySignal<T[]>;
-    readonly valid: ReadonlySignal<boolean>;
-    readonly invalid: ReadonlySignal<boolean>;
-    readonly touched: ReadonlySignal<boolean>;
-    readonly dirty: ReadonlySignal<boolean>;
-    readonly pending: ReadonlySignal<boolean>;
-    readonly errors: ReadonlySignal<ValidationError[]>;
-    readonly status: ReadonlySignal<FieldStatus>;
-    readonly length: ReadonlySignal<number>;
-    constructor(schema: FormSchema<T>, initialItems?: Partial<T>[]);
-    /**
-     * Добавить элемент в конец массива
-     * @param initialValue - Начальные значения для нового элемента
-     */
-    push(initialValue?: Partial<T>): void;
-    /**
-     * Удалить элемент по индексу
-     * @param index - Индекс элемента для удаления
-     *
-     * @remarks
-     * Вызывает dispose() на удаляемом элементе для очистки подписок
-     */
-    removeAt(index: number): void;
-    /**
-     * Вставить элемент в массив
-     * @param index - Индекс для вставки
-     * @param initialValue - Начальные значения для нового элемента
-     */
-    insert(index: number, initialValue?: Partial<T>): void;
-    /**
-     * Переместить элемент массива с позиции `from` на позицию `to`
-     *
-     * @param from - Индекс перемещаемого элемента
-     * @param to - Целевой индекс
-     *
-     * @remarks
-     * Реордер не уничтожает элемент (dispose НЕ вызывается) — тот же инстанс под-формы
-     * переезжает на новую позицию, состояние/валидация сохраняются. Длина не меняется.
-     *
-     * @example
-     * ```typescript
-     * // Поднять элемент #2 на одну позицию вверх
-     * form.items.move(2, 1);
-     * ```
-     */
-    move(from: number, to: number): void;
-    /**
-     * Поменять местами два элемента массива
-     *
-     * @param a - Индекс первого элемента
-     * @param b - Индекс второго элемента
-     *
-     * @remarks
-     * Как и {@link move}, не уничтожает элементы — меняет только их порядок.
-     *
-     * @example
-     * ```typescript
-     * form.items.swap(0, 2);
-     * ```
-     */
-    swap(a: number, b: number): void;
-    /**
-     * Удалить все элементы массива
-     *
-     * @remarks
-     * Вызывает dispose() на всех элементах для очистки подписок
-     */
-    clear(): void;
-    /**
-     * Получить элемент по индексу
-     * @param index - Индекс элемента
-     * @returns Типизированный GroupNode proxy или undefined если индекс вне границ
-     */
-    at(index: number): FormProxy<T> | undefined;
-    getValue(): T[];
-    setValue(values: T[], options?: SetValueOptions): void;
-    patchValue(values: (T | undefined)[]): void;
-    /**
-     * Сбросить массив к указанным значениям (или очистить)
-     *
-     * @param values - опциональный массив значений для сброса
-     *
-     * @remarks
-     * Очищает текущий массив и заполняет новыми элементами
-     *
-     * @example
-     * ```typescript
-     * // Очистить массив
-     * arrayNode.reset();
-     *
-     * // Сбросить к новым значениям
-     * arrayNode.reset([{ name: 'Item 1' }, { name: 'Item 2' }]);
-     * ```
-     */
-    reset(values?: T[]): void;
-    /**
-     * Сбросить массив к исходным значениям (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(): void;
-    validate(): Promise<boolean>;
-    /**
-     * Установить array-level validation errors
-     *
-     * @param errors - Массив ошибок валидации уровня массива
-     *
-     * @example
-     * ```typescript
-     * arrayNode.setErrors([{
-     *   code: 'minItems',
-     *   message: 'Минимум 1 элемент обязателен',
-     * }]);
-     * ```
-     */
-    setErrors(errors: ValidationError[]): void;
-    /**
-     * Очистить все errors (array-level + item-level)
-     *
-     * @example
-     * ```typescript
-     * arrayNode.clearErrors();
-     * console.log(arrayNode.errors.value); // []
-     * ```
-     */
-    clearErrors(): void;
-    /**
-     * Hook: вызывается после markAsTouched()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как touched
-     */
-    protected onMarkAsTouched(): void;
-    /**
-     * Hook: вызывается после markAsUntouched()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как untouched
-     */
-    protected onMarkAsUntouched(): void;
-    /**
-     * Hook: вызывается после markAsDirty()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как dirty
-     */
-    protected onMarkAsDirty(): void;
-    /**
-     * Hook: вызывается после markAsPristine()
-     *
-     * Для ArrayNode: рекурсивно помечаем все элементы массива как pristine
-     */
-    protected onMarkAsPristine(): void;
-    /**
-     * Итерировать по элементам массива
-     * @param callback - Функция, вызываемая для каждого элемента с типизированным GroupNode proxy
-     */
-    forEach(callback: (item: FormProxy<T>, index: number) => void): void;
-    /**
-     * Маппинг элементов массива
-     * @param callback - Функция преобразования с типизированным GroupNode proxy
-     * @returns Новый массив результатов
-     */
-    map<R>(callback: (item: FormProxy<T>, index: number) => R): R[];
-    /**
-     * Создать новый элемент массива на основе схемы
-     * @param initialValue - Начальные значения
-     */
-    private createItem;
-    /**
-     * Проверить, является ли схема групповой (объект полей)
-     * @param schema - Схема для проверки
-     */
-    private isGroupSchema;
-    /**
-     * Применить validation schema ко всем элементам массива
-     *
-     * Validation schema будет применена к:
-     * - Всем существующим элементам
-     * - Всем новым элементам, добавляемым через push/insert
-     *
-     * @param schemaFn - Функция валидации для элемента массива
-     *
-     * @example
-     * ```typescript
-     * import { propertyValidation } from './validation/property-validation';
-     *
-     * form.properties.applyValidationSchema(propertyValidation);
-     * ```
-     */
-    applyValidationSchema(schemaFn: unknown): void;
-    /**
-     * Применить behavior schema ко всем элементам ArrayNode
-     *
-     * Автоматически применяется к новым элементам при push/insert.
-     *
-     * @param schemaFn - Behavior schema функция
-     *
-     * @example
-     * ```typescript
-     * import { addressBehavior } from './behaviors/address-behavior';
-     *
-     * form.addresses.applyBehaviorSchema(addressBehavior);
-     * ```
-     */
-    applyBehaviorSchema(schemaFn: unknown): void;
-    /**
-     * Подписка на изменения конкретного поля во всех элементах массива
-     * Срабатывает при изменении значения поля в любом элементе
-     *
-     * @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<K extends keyof T>(fieldKey: K, callback: (values: Array<T[K] | undefined>) => void | Promise<void>): () => void;
-    /**
-     * Подписка на изменение длины массива
-     * Срабатывает при добавлении/удалении элементов
-     *
-     * @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: (length: number) => void | Promise<void>): () => void;
-    /**
-     * Очистить все ресурсы узла
-     * Рекурсивно очищает все subscriptions и элементы массива
-     *
-     * @example
-     * ```typescript
-     * useEffect(() => {
-     *   return () => {
-     *     arrayNode.dispose();
-     *   };
-     * }, []);
-     * ```
-     */
-    dispose(): void;
-    /**
-     * Hook: вызывается после disable()
-     *
-     * Для ArrayNode: рекурсивно отключаем все элементы массива
-     *
-     * @example
-     * ```typescript
-     * // Отключить весь массив полей
-     * form.items.disable();
-     *
-     * // Все элементы становятся disabled
-     * form.items.forEach(item => {
-     *   console.log(item.status.value); // 'disabled'
-     * });
-     * ```
-     */
-    protected onDisable(): void;
-    /**
-     * Hook: вызывается после enable()
-     *
-     * Для ArrayNode: рекурсивно включаем все элементы массива
-     *
-     * @example
-     * ```typescript
-     * // Включить весь массив полей
-     * form.items.enable();
-     *
-     * // Все элементы становятся enabled
-     * form.items.forEach(item => {
-     *   console.log(item.status.value); // 'valid' или 'invalid'
-     * });
-     * ```
-     */
-    protected onEnable(): void;
-}