@reformer/core 2.0.0-beta.5 → 2.0.0-beta.7

package/dist/{behaviors-DzYL8kY_.js → behaviors-DyPzh2-X.js}

@@ -1,4 +1,4 @@
-import { b as w, c as E, d as I, B as L } from "./registry-helpers-BRxAr6nG.js";
+import { b as w, c as E, d as I, B as L } from "./registry-helpers--8-OogF8.js";
 var $ = /* @__PURE__ */ Symbol.for("preact-signals");
 function B() {
   if (y > 1)
@@ -348,13 +348,22 @@ function Q(e, t, i) {
       const m = a.value.value;
       c || h(() => {
         c = !0;
-        const U = s ? s(m) : m;
-        r.setValue(U, { emitEvent: !1 }), c = !1;
+        try {
+          const U = s ? s(m) : m;
+          r.setValue(U, { emitEvent: !1 });
+        } finally {
+          c = !1;
+        }
       });
     }), b = g(() => {
       const m = r.value.value;
       c || h(() => {
-        c = !0, a.setValue(m, { emitEvent: !1 }), c = !1;
+        c = !0;
+        try {
+          a.setValue(m, { emitEvent: !1 });
+        } finally {
+          c = !1;
+        }
       });
     });
     return () => {

package/dist/behaviors.js

@@ -1,5 +1,5 @@
-import { a as s, b as r, g as t, c as o, m as l, i as h, f as n, e as i, k as m, j as p, s as c, t as d, l as f, n as F, h as y } from "./behaviors-DzYL8kY_.js";
-import { d as v, B, c as b } from "./registry-helpers-BRxAr6nG.js";
+import { a as s, b as r, g as t, c as o, m as l, i as h, f as n, e as i, k as m, j as p, s as c, t as d, l as f, n as F, h as y } from "./behaviors-DyPzh2-X.js";
+import { d as v, B, c as b } from "./registry-helpers--8-OogF8.js";
 export {
   v as BehaviorContextImpl,
   B as BehaviorRegistry,

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

@@ -39,6 +39,8 @@ export declare class ArrayNode<T extends FormFields> extends FormNode<T[]> {
      * Использует SubscriptionManager вместо массива для управления подписками
      */
     private disposers;
+    /** Array-level validation errors (e.g., "минимум 1 элемент") */
+    private readonly _arrayErrors;
     private validationSchemaFn?;
     private behaviorSchemaFn?;
     readonly value: ReadonlySignal<T[]>;
@@ -74,7 +76,7 @@ export declare class ArrayNode<T extends FormFields> extends FormNode<T[]> {
     /**
      * Получить элемент по индексу
      * @param index - Индекс элемента
-     * @returns Типизированный GroupNode или undefined если индекс вне границ
+     * @returns Типизированный GroupNode proxy или undefined если индекс вне границ
      */
     at(index: number): FormProxy<T> | undefined;
     getValue(): T[];
@@ -128,7 +130,29 @@ export declare class ArrayNode<T extends FormFields> extends FormNode<T[]> {
      */
     resetToInitial(): void;
     validate(): Promise<boolean>;
-    setErrors(_errors: ValidationError[]): void;
+    /**
+     * Установить 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()
@@ -156,12 +180,12 @@ export declare class ArrayNode<T extends FormFields> extends FormNode<T[]> {
     protected onMarkAsPristine(): void;
     /**
      * Итерировать по элементам массива
-     * @param callback - Функция, вызываемая для каждого элемента с типизированным GroupNode
+     * @param callback - Функция, вызываемая для каждого элемента с типизированным GroupNode proxy
      */
     forEach(callback: (item: FormProxy<T>, index: number) => void): void;
     /**
      * Маппинг элементов массива
-     * @param callback - Функция преобразования с типизированным GroupNode
+     * @param callback - Функция преобразования с типизированным GroupNode proxy
      * @returns Новый массив результатов
      */
     map<R>(callback: (item: FormProxy<T>, index: number) => R): R[];

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

@@ -49,6 +49,7 @@ export declare class FieldNode<T> extends FormNode<T> {
     private updateOn;
     private initialValue;
     private currentValidationId;
+    private currentAbortController?;
     private debounceMs;
     private validateDebounceTimer?;
     private validateDebounceResolve?;
@@ -137,12 +138,10 @@ export declare class FieldNode<T> extends FormNode<T> {
      * Немедленная валидация без debounce
      * @private
      * @remarks
-     * Защищена от race conditions:
-     * - Проверка validationId после синхронной валидации
-     * - Проверка перед установкой pending
-     * - Проверка после Promise.all
-     * - Проверка перед обработкой async результатов
-     * - Проверка перед очисткой errors
+     * Защищена от race conditions через AbortController:
+     * - Отменяет предыдущую валидацию при запуске новой
+     * - Передаёт AbortSignal в async валидаторы для отмены операций (например, fetch)
+     * - Проверяет signal.aborted в ключевых точках
      */
     private validateImmediate;
     setErrors(errors: ValidationError[]): void;
@@ -256,6 +255,13 @@ export declare class FieldNode<T> extends FormNode<T> {
      * Очистить все ресурсы и таймеры
      * Должен вызываться при unmount компонента
      *
+     * @remarks
+     * Освобождает все ресурсы:
+     * - Отписывает все subscriptions через SubscriptionManager
+     * - Очищает debounce таймер
+     * - Resolve'ит висячий debounce промис (предотвращает утечку памяти)
+     * - Отменяет текущую async валидацию через AbortController
+     *
      * @example
      * ```typescript
      * useEffect(() => {

package/dist/core/types/form-proxy.d.ts

@@ -16,7 +16,7 @@
  *   items: Array<{ title: string }>;
  * }
  *
- * const form: FormProxy<MyForm> = new GroupNode(schema);
+ * const form = createForm<MyForm>(schema);
  *
  * //  TypeScript знает, что это FieldNode<string>
  * form.name.setValue('John');
@@ -72,7 +72,7 @@ export type FormControlsProxy<T> = {
  *   };
  * }
  *
- * const form: FormProxy<UserForm> = new GroupNode(schema);
+ * const form = createForm<UserForm>(schema);
  *
  * // Доступ к методам GroupNode
  * await form.validate();

package/dist/core/types/index.d.ts

@@ -20,12 +20,46 @@ export type UnknownFormValue = unknown;
  * @category Validation Types
  */
 export type ValidatorFn<T = FormValue> = (value: T) => ValidationError | null;
+/**
+ * Опции для асинхронного валидатора
+ * @group Types
+ * @category Validation Types
+ */
+export interface AsyncValidatorOptions {
+    /**
+     * AbortSignal для отмены валидации
+     * Позволяет отменить асинхронную операцию при новой валидации
+     */
+    signal?: AbortSignal;
+}
 /**
  * Асинхронная функция валидации
+ *
+ * @param value - Значение для валидации
+ * @param options - Опции валидации (опционально)
+ * @returns Promise с ошибкой валидации или null если значение валидно
+ *
+ * @example
+ * ```typescript
+ * // Простой валидатор (без поддержки отмены)
+ * const emailExists: AsyncValidatorFn<string> = async (value) => {
+ *   const exists = await checkEmail(value);
+ *   return exists ? { code: 'exists', message: 'Email already exists' } : null;
+ * };
+ *
+ * // Валидатор с поддержкой отмены
+ * const emailExistsAbortable: AsyncValidatorFn<string> = async (value, options) => {
+ *   const exists = await fetch(`/api/check-email?email=${value}`, {
+ *     signal: options?.signal // Передаём signal в fetch для отмены запроса
+ *   });
+ *   return exists ? { code: 'exists', message: 'Email already exists' } : null;
+ * };
+ * ```
+ *
  * @group Types
  * @category Validation Types
  */
-export type AsyncValidatorFn<T = FormValue> = (value: T) => Promise<ValidationError | null>;
+export type AsyncValidatorFn<T = FormValue> = (value: T, options?: AsyncValidatorOptions) => Promise<ValidationError | null>;
 /**
  * Ошибка валидации
  * @group Types

package/dist/core/utils/create-form.d.ts

@@ -1,18 +1,20 @@
 /**
  * Фабричная функция для создания формы с правильной типизацией
  *
- * Решает проблему с типизацией конструктора GroupNode, который возвращает
- * Proxy (FormProxy), но TypeScript не может это вывести автоматически.
+ * Это рекомендуемый способ создания форм в ReFormer v2.0+.
+ * Создаёт GroupNode и возвращает его Proxy для типобезопасного доступа к полям.
  *
  * @group Utilities
  *
  * @example
  * ```typescript
- * // Вместо:
- * const form: FormProxy<MyForm> = new GroupNode<MyForm>(config);
- *
- * // Используйте:
+ * // Рекомендуемый способ:
  * const form = createForm<MyForm>(config);
+ * form.email.setValue('test@mail.com');  // Типобезопасный доступ к полям
+ *
+ * // Если нужен именно GroupNode instance:
+ * const groupNode = new GroupNode<MyForm>(config);
+ * const proxy = groupNode.getProxy();  // Явно получаем Proxy
  * ```
  */
 import type { FormProxy, GroupNodeConfig, FormSchema } from '../types';

package/dist/core/utils/index.d.ts

@@ -13,3 +13,4 @@ export { Debouncer } from './debounce';
 export { FormErrorHandler, ErrorStrategy } from './error-handler';
 export { createForm } from './create-form';
 export * from './resources';
+export { uniqueId } from './unique-id';

package/dist/core/utils/unique-id.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Генератор уникальных идентификаторов
+ *
+ * Использует атомный счётчик для генерации гарантированно уникальных ключей.
+ * Решает проблему возможного дублирования ключей при использовании
+ * Date.now() + Math.random() в быстрых последовательных вызовах.
+ *
+ * @example
+ * ```typescript
+ * const key1 = uniqueId('watch'); // "watch-1"
+ * const key2 = uniqueId('watch'); // "watch-2"
+ * const key3 = uniqueId('effect'); // "effect-3"
+ * ```
+ */
+/**
+ * Генерирует уникальный идентификатор с указанным префиксом
+ *
+ * @param prefix - Префикс для идентификатора
+ * @returns Уникальный идентификатор в формате `${prefix}-${counter}`
+ */
+export declare function uniqueId(prefix: string): string;
+/**
+ * Сбросить счётчик (только для тестов)
+ * @internal
+ */
+export declare function resetUniqueIdCounter(): void;

package/dist/core/validation/validation-context.d.ts

@@ -1,27 +1,25 @@
 /**
  * Реализация контекста валидации
+ *
+ * Использует паттерн наследования для устранения дублирования кода
+ * между различными типами контекстов валидации.
  */
 import type { GroupNode } from '../nodes/group-node';
 import type { FieldNode } from '../nodes/field-node';
 import type { FormProxy } from '../types/form-proxy';
 import type { FormContext } from '../types/form-context';
 /**
- * Реализация контекста валидации для отдельного поля
- * Реализует FormContext
+ * Базовый класс контекста валидации
+ * Содержит общую логику для всех типов контекстов
+ * @internal
  */
-export declare class ValidationContextImpl<TForm, TField> implements FormContext<TForm> {
-    private _form;
-    private control;
+declare abstract class BaseValidationContext<TForm> implements FormContext<TForm> {
+    protected readonly _form: GroupNode<TForm>;
     /**
      * Форма с типизированным Proxy-доступом к полям
      */
     readonly form: FormProxy<TForm>;
-    constructor(form: GroupNode<TForm>, _fieldKey: keyof TForm, control: FieldNode<TField>);
-    /**
-     * Получить текущее значение поля (внутренний метод для validation-applicator)
-     * @internal
-     */
-    value(): TField;
+    constructor(form: GroupNode<TForm>);
     /**
      * Безопасно установить значение поля по строковому пути
      * Автоматически использует emitEvent: false для предотвращения циклов
@@ -29,42 +27,36 @@ export declare class ValidationContextImpl<TForm, TField> implements FormContext
     setFieldValue(path: string, value: unknown): void;
 }
 /**
- * Реализация контекста для cross-field валидации
- * Реализует FormContext
+ * Контекст валидации для отдельного поля
+ * Предоставляет доступ к значению конкретного поля
  */
-export declare class TreeValidationContextImpl<TForm> implements FormContext<TForm> {
-    private _form;
+export declare class ValidationContextImpl<TForm, TField> extends BaseValidationContext<TForm> {
+    private control;
+    constructor(form: GroupNode<TForm>, _fieldKey: keyof TForm, control: FieldNode<TField>);
     /**
-     * Форма с типизированным Proxy-доступом к полям
+     * Получить текущее значение поля (внутренний метод для validation-applicator)
+     * @internal
      */
-    readonly form: FormProxy<TForm>;
+    value(): TField;
+}
+/**
+ * Контекст для cross-field валидации
+ * Не предоставляет доступ к конкретному полю, только к форме целиком
+ */
+export declare class TreeValidationContextImpl<TForm> extends BaseValidationContext<TForm> {
     constructor(form: GroupNode<TForm>);
-    /**
-     * Безопасно установить значение поля по строковому пути
-     * Автоматически использует emitEvent: false для предотвращения циклов
-     */
-    setFieldValue(path: string, value: unknown): void;
 }
 /**
- * Реализация контекста валидации для ArrayNode
- * Позволяет валидаторам типа notEmpty работать с массивами
+ * Контекст валидации для ArrayNode
+ * Предоставляет доступ к значению массива
  */
-export declare class ArrayValidationContextImpl<TForm, TItem> implements FormContext<TForm> {
-    private _form;
+export declare class ArrayValidationContextImpl<TForm, TItem> extends BaseValidationContext<TForm> {
     private arrayValue;
-    /**
-     * Форма с типизированным Proxy-доступом к полям
-     */
-    readonly form: FormProxy<TForm>;
     constructor(form: GroupNode<TForm>, _fieldKey: keyof TForm, arrayValue: TItem[]);
     /**
      * Получить текущее значение массива (для валидатора)
      * @internal
      */
     value(): TItem[];
-    /**
-     * Безопасно установить значение поля по строковому пути
-     * Автоматически использует emitEvent: false для предотвращения циклов
-     */
-    setFieldValue(path: string, value: unknown): void;
 }
+export {};

package/dist/core/validation/validation-registry.d.ts

@@ -142,11 +142,6 @@ export declare class ValidationRegistry {
      * Возвращает локальный массив валидаторов (без аргумента form).
      */
     getValidators(): ValidatorRegistration[];
-    /**
-     * Применить зарегистрированные валидаторы к GroupNode
-     * @private
-     */
-    private applyValidators;
     /**
      * Применить array-items validators к ArrayNode элементам
      * @private