@reformer/core 7.0.0-beta.1 → 7.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reformer/core",
-  "version": "7.0.0-beta.1",
+  "version": "7.0.0",
   "description": "Reactive form state management library for React with signals-based architecture",
   "type": "module",
   "main": "./dist/index.js",

package/dist/core/utils/abstract-registry.d.ts

@@ -1,74 +0,0 @@
-import { RegistryStack } from './registry-stack';
-/**
- * Базовый класс для реестров (BehaviorRegistry, ValidationRegistry).
- *
- * Реализует паттерн Template Method для управления регистрацией:
- * `beginRegistration()` → `onBeginRegistration()`, `endRegistration()` → `onEndRegistration()`.
- *
- * @typeParam TRegistration - Тип регистрируемых элементов.
- *
- * @example
- * ```typescript
- * import { AbstractRegistry } from '@reformer/core';
- *
- * class MyRegistry extends AbstractRegistry<{ name: string }> {
- *   protected onEndRegistration(items: { name: string }[]) {
- *     console.log('Registered', items.length);
- *   }
- * }
- * ```
- */
-export declare abstract class AbstractRegistry<TRegistration> {
-    /** Флаг активной регистрации */
-    protected isRegistering: boolean;
-    /** Массив зарегистрированных элементов */
-    protected registrations: TRegistration[];
-    /**
-     * Получить стек для конкретного класса реестра
-     * Создает новый стек если не существует
-     *
-     * @param ctor - Конструктор класса реестра
-     * @returns RegistryStack для данного класса
-     */
-    protected static getStack<T extends AbstractRegistry<any>>(ctor: new (...args: any[]) => T): RegistryStack<T>;
-    /**
-     * Получить текущий активный реестр из стека
-     * Должен быть переопределен в наследниках как static метод
-     *
-     * @param ctor - Конструктор класса реестра
-     * @returns Текущий активный реестр или null
-     */
-    protected static getCurrentFromStack<T extends AbstractRegistry<any>>(ctor: new (...args: any[]) => T): T | null;
-    /**
-     * Начать регистрацию
-     *
-     * Помещает this в global stack для изоляции форм
-     * Вызывает hook onBeginRegistration()
-     */
-    beginRegistration(): void;
-    /**
-     * Проверить, активна ли регистрация
-     */
-    isActive(): boolean;
-    /**
-     * Получить зарегистрированные элементы
-     */
-    getRegistrations(): TRegistration[];
-    /**
-     * Hook: вызывается в начале регистрации
-     * Может быть переопределен в наследниках для инициализации
-     */
-    protected onBeginRegistration(): void;
-    /**
-     * Завершить регистрацию и извлечь из стека
-     *
-     * @param registryName - Имя реестра для отладки
-     */
-    protected completeRegistration(registryName: string): void;
-    /**
-     * Отменить регистрацию без применения
-     *
-     * @param registryName - Имя реестра для отладки
-     */
-    cancelRegistration(registryName: string): void;
-}

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

@@ -1,176 +0,0 @@
-import { FormFields, FormValue, FieldStatus, ValidationError } from '../types';
-/**
- * Тип события изменения в форме
- */
-export type FormChangeType = 'value' | 'status' | 'errors' | 'touched' | 'dirty';
-/**
- * Событие изменения в форме
- */
-export interface FormChangeEvent {
-    /** Тип изменения */
-    type: FormChangeType;
-    /** Путь к полю */
-    path: string;
-    /** Timestamp события */
-    timestamp: number;
-    /** Старое значение */
-    oldValue?: unknown;
-    /** Новое значение */
-    newValue: unknown;
-}
-/**
- * Интерфейс узла формы для observer
- */
-export interface ObservableFormNode {
-    value: {
-        value: FormValue;
-    };
-    status: {
-        value: FieldStatus;
-    };
-    errors: {
-        value: ValidationError[];
-    };
-    touched: {
-        value: boolean;
-    };
-    dirty: {
-        value: boolean;
-    };
-}
-/**
- * Интерфейс формы для observer
- */
-export interface ObservableForm<T extends FormFields> {
-    value: {
-        value: T;
-    };
-    status: {
-        value: FieldStatus;
-    };
-    errors: {
-        value: ValidationError[];
-    };
-    touched: {
-        value: boolean;
-    };
-    dirty: {
-        value: boolean;
-    };
-    getFieldByPath(path: string): ObservableFormNode | undefined;
-}
-/**
- * Callback для обработки событий изменения
- */
-export type FormChangeCallback = (event: FormChangeEvent) => void;
-/**
- * Опции для FormObserver
- */
-export interface FormObserverOptions {
-    /** Включить логирование в консоль (по умолчанию true в DEV) */
-    enableLogging?: boolean;
-    /** Фильтр типов событий */
-    eventTypes?: FormChangeType[];
-    /** Фильтр путей полей (regex или массив) */
-    pathFilter?: RegExp | string[];
-}
-/**
- * FormObserver - мониторинг изменений в форме
- *
- * Полезен для:
- * - Отладки сложных форм
- * - Логирования изменений для аудита
- * - Синхронизации с внешними системами
- *
- * @example
- * ```typescript
- * const observer = new FormObserver(form, {
- *   enableLogging: true,
- *   eventTypes: ['value', 'errors']
- * });
- *
- * // Подписка на события
- * const unsubscribe = observer.subscribe((event) => {
- *   console.log(`${event.type} at ${event.path}:`, event.newValue);
- * });
- *
- * // Включить трассировку
- * const disposeTracing = observer.enableTracing();
- *
- * // Cleanup
- * unsubscribe();
- * disposeTracing();
- * ```
- */
-export declare class FormObserver<T extends FormFields> {
-    private readonly form;
-    private listeners;
-    private disposers;
-    private options;
-    /**
-     * @param form - Форма для наблюдения
-     * @param options - Опции observer
-     */
-    constructor(form: ObservableForm<T>, options?: FormObserverOptions);
-    /**
-     * Подписаться на события изменения
-     *
-     * @param callback - Функция обработки события
-     * @returns Функция отписки
-     *
-     * @example
-     * ```typescript
-     * const unsubscribe = observer.subscribe((event) => {
-     *   // Отправить событие в analytics
-     *   analytics.track('form_change', event);
-     * });
-     * ```
-     */
-    subscribe(callback: FormChangeCallback): () => void;
-    /**
-     * Включить трассировку формы
-     *
-     * Подписывается на изменения основных сигналов формы
-     * и вызывает listeners при каждом изменении
-     *
-     * @returns Функция для отключения трассировки
-     *
-     * @example
-     * ```typescript
-     * const dispose = observer.enableTracing();
-     *
-     * // Позже, для отключения
-     * dispose();
-     * ```
-     */
-    enableTracing(): () => void;
-    /**
-     * Наблюдать за конкретным полем
-     *
-     * @param path - Путь к полю
-     * @returns Функция для отключения наблюдения
-     *
-     * @example
-     * ```typescript
-     * // Наблюдать за полем email
-     * const dispose = observer.watchField('email');
-     * ```
-     */
-    watchField(path: string): () => void;
-    /**
-     * Отправить событие всем listeners
-     */
-    private emit;
-    /**
-     * Проверить, нужно ли отслеживать тип события
-     */
-    private shouldTrack;
-    /**
-     * Проверить, соответствует ли путь фильтру
-     */
-    private matchesPathFilter;
-    /**
-     * Очистить все подписки и disposers
-     */
-    dispose(): void;
-}

package/dist/core/utils/registry-stack.d.ts

@@ -1,69 +0,0 @@
-/**
- * Generic Registry Stack - утилита для управления стеком регистрации
- *
- * Используется ValidationRegistry и BehaviorRegistry для tracking активного контекста.
- * Устраняет дублирование кода между параллельными системами.
- *
- * @template T - Тип элементов в стеке (ValidationRegistry или BehaviorRegistry)
- *
- * @internal
- *
- * @example
- * ```typescript
- * class ValidationRegistry {
- *   private static registryStack = new RegistryStack<ValidationRegistry>();
- *
- *   static getCurrent() {
- *     return ValidationRegistry.registryStack.getCurrent();
- *   }
- *
- *   beginRegistration() {
- *     ValidationRegistry.registryStack.push(this);
- *   }
- *
- *   endRegistration() {
- *     ValidationRegistry.registryStack.verify(this, 'ValidationRegistry');
- *   }
- * }
- * ```
- */
-export declare class RegistryStack<T> {
-    private stack;
-    /**
-     * Добавить элемент в стек
-     * @param item - Элемент для добавления
-     */
-    push(item: T): void;
-    /**
-     * Извлечь элемент из стека
-     * @returns Извлеченный элемент или undefined если стек пуст
-     */
-    pop(): T | undefined;
-    /**
-     * Получить текущий элемент (вершину стека) без извлечения
-     * @returns Текущий элемент или null если стек пуст
-     */
-    getCurrent(): T | null;
-    /**
-     * Извлечь элемент из стека с проверкой
-     * Выводит предупреждение в DEV режиме если извлеченный элемент не совпадает с ожидаемым
-     *
-     * @param expected - Ожидаемый элемент
-     * @param name - Имя реестра для отладки (например, 'ValidationRegistry')
-     */
-    verify(expected: T, name: string): void;
-    /**
-     * Получить длину стека
-     * @returns Количество элементов в стеке
-     */
-    get length(): number;
-    /**
-     * Проверить, пуст ли стек
-     * @returns true если стек пуст
-     */
-    isEmpty(): boolean;
-    /**
-     * Очистить стек
-     */
-    clear(): void;
-}