@reformer/core 10.2.0 → 11.0.0-beta.10

package/dist/state/index.d.ts

@@ -1,31 +0,0 @@
-/**
- * `@reformer/core/state` — низкоуровневый реактивный **state-субстрат** (M1) и barrel модуля `state`.
- *
- * Это «прокси-объект с сигналами» и инструментарий для построения доменных модулей поверх него
- * (form, table, …). Модуль СТРОГО реактивный: НИЧЕГО связанного с формами/валидацией/схемами здесь
- * нет — только модель, value-операции, producer-флаг и утилиты субстрата. Граница state⇏form
- * зафиксирована ESLint-правилом (`no-restricted-imports` на `src/state/**`).
- *
- * Реактивный рантайм (`signal/computed/effect/…`) живёт в отдельном subpath `@reformer/core/signals`
- * (единый владелец `@preact/signals-core`) — импортируй его оттуда; здесь он НЕ реэкспортируется,
- * чтобы зонтичный barrel `.` не разрастался рантаймом.
- *
- * Состав (реэкспорты — из тех же файлов, что использует зонтик `.`, поэтому `.` и `/state` — один
- * module-инстанс: общий `derived`-WeakMap, единая идентичность `Signal`):
- * - **модель** — `createModel` + типы `FormModel`/`ModelArray`/… + `PathAwareSignal`;
- * - **value-операции** (реактивные правила) — `computeFrom`/`copyFrom`/`watchField`/`transformValue`/
- *   `resetWhen`/`syncFields`/`revalidateWhen`;
- * - **producer-owned флаг** — `markDerived`/`isDerived`/`unmarkDerived`;
- * - **утилиты субстрата** — `runOutsideEffect`/`safeCallback`/`safeDebouncedCallback`,
- *   `SubscriptionManager`.
- *
- * @group State
- * @module state
- */
-export { createModel } from './form-model';
-export type { FormModel, ModelArray, ModelObject, ModelValue, ModelSignals, ModelApi, PathAwareSignal, } from './types';
-export { computeFrom, copyFrom, watchField, transformValue, resetWhen, syncFields, revalidateWhen, } from './behaviors-value';
-export type { BehaviorCleanup } from './behaviors-value';
-export { markDerived, isDerived, unmarkDerived } from './derived-registry';
-export { runOutsideEffect, safeCallback, safeDebouncedCallback } from './safe-effect';
-export { SubscriptionManager } from './subscription-manager';

package/dist/state/subscription-manager.d.ts

@@ -1,180 +0,0 @@
-/**
- * Менеджер подписок для FormNode
- *
- * Централизует управление effect-подписками в узлах формы,
- * предотвращает утечки памяти и упрощает отладку.
- *
- * Каждая подписка имеет уникальный ключ, что позволяет:
- * - Отписываться от конкретной подписки по ключу
- * - Автоматически заменять существующие подписки
- * - Отслеживать количество активных подписок (для отладки)
- *
- * @internal
- *
- * @example
- * ```typescript
- * class FieldNode {
- *   private subscriptions = new SubscriptionManager();
- *
- *   watch(callback: Function) {
- *     const dispose = effect(() => callback(this.value.value));
- *     return this.subscriptions.add('watch', dispose);
- *   }
- *
- *   dispose() {
- *     this.subscriptions.clear();
- *   }
- * }
- * ```
- */
-export declare class SubscriptionManager {
-    /**
-     * Хранилище подписок
-     * Ключ: уникальный идентификатор подписки
-     * Значение: функция отписки (dispose)
-     */
-    private subscriptions;
-    /**
-     * Добавляет подписку
-     *
-     * Если подписка с таким ключом уже существует, отписывается от неё
-     * и заменяет новой. Это предотвращает утечки памяти при повторной
-     * регистрации подписки с тем же ключом.
-     *
-     * @param key Уникальный ключ подписки
-     * @param dispose Функция отписки (обычно возвращаемая из effect())
-     * @returns Функция для отписки от этой конкретной подписки
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     *
-     * // Добавление подписки
-     * const unsubscribe = manager.add('mySubscription', () => {
-     *   console.log('Disposing subscription');
-     * });
-     *
-     * // Отписка через возвращаемую функцию
-     * unsubscribe();
-     *
-     * // Или через manager.remove()
-     * manager.add('anotherSub', disposeFn);
-     * manager.remove('anotherSub');
-     * ```
-     */
-    add(key: string, dispose: () => void): () => void;
-    /**
-     * Удаляет подписку по ключу
-     *
-     * Вызывает функцию отписки и удаляет подписку из хранилища.
-     * Если подписка с таким ключом не найдена, ничего не делает.
-     *
-     * @param key Ключ подписки
-     * @returns true, если подписка была удалена, false если не найдена
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * manager.add('mySub', disposeFn);
-     *
-     * // Удаление подписки
-     * const removed = manager.remove('mySub'); // true
-     *
-     * // Попытка удалить несуществующую подписку
-     * const removed2 = manager.remove('nonExistent'); // false
-     * ```
-     */
-    remove(key: string): boolean;
-    /**
-     * Очищает все подписки
-     *
-     * Вызывает функции отписки для всех активных подписок
-     * и очищает хранилище. Обычно используется при dispose узла формы.
-     *
-     * @example
-     * ```typescript
-     * class FieldNode {
-     *   private subscriptions = new SubscriptionManager();
-     *
-     *   dispose() {
-     *     // Отписываемся от всех effect
-     *     this.subscriptions.clear();
-     *   }
-     * }
-     * ```
-     */
-    clear(): void;
-    /**
-     * Возвращает количество активных подписок
-     *
-     * Полезно для отладки утечек памяти. Если количество подписок
-     * растет без ограничений, это может указывать на то, что
-     * компоненты не отписываются должным образом.
-     *
-     * @returns Количество активных подписок
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * console.log(manager.size()); // 0
-     *
-     * manager.add('sub1', disposeFn1);
-     * manager.add('sub2', disposeFn2);
-     * console.log(manager.size()); // 2
-     *
-     * manager.clear();
-     * console.log(manager.size()); // 0
-     * ```
-     */
-    size(): number;
-    /**
-     * Проверяет, есть ли подписка с данным ключом
-     *
-     * @param key Ключ подписки
-     * @returns true, если подписка существует
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * manager.add('mySub', disposeFn);
-     *
-     * console.log(manager.has('mySub')); // true
-     * console.log(manager.has('nonExistent')); // false
-     * ```
-     */
-    has(key: string): boolean;
-    /**
-     * Возвращает список всех ключей активных подписок
-     *
-     * Полезно для отладки: можно увидеть, какие подписки активны.
-     *
-     * @returns Массив ключей всех активных подписок
-     *
-     * @example
-     * ```typescript
-     * const manager = new SubscriptionManager();
-     * manager.add('watch-value', disposeFn1);
-     * manager.add('watch-errors', disposeFn2);
-     *
-     * console.log(manager.getKeys()); // ['watch-value', 'watch-errors']
-     * ```
-     */
-    getKeys(): string[];
-    /**
-     * Отписывается от всех подписок (алиас для clear())
-     *
-     * Используется при dispose() узла формы для совместимости с ожидаемым API.
-     *
-     * @example
-     * ```typescript
-     * class FieldNode {
-     *   private subscriptions = new SubscriptionManager();
-     *
-     *   dispose() {
-     *     this.subscriptions.dispose();
-     *   }
-     * }
-     * ```
-     */
-    dispose(): void;
-}

package/dist/state/types.d.ts

@@ -1,144 +0,0 @@
-import { Signal } from '@preact/signals-core';
-/**
- * Сигнал, который знает свой путь в модели (`'personalData.lastName'`).
- * Используется как «ручка поля»: и привязка value в схеме, и идентичность для testId/devtools.
- *
- * @group Model
- */
-export type PathAwareSignal<T> = Signal<T> & {
-    /** Путь поля в модели (dot-нотация). На элементах массива включает индекс. */
-    readonly __path: string;
-};
-/**
- * Спец-объекты, которые трактуются как листья (не разворачиваются в под-модель).
- * @internal
- */
-type Opaque = Date | File | Blob;
-/**
- * Фасад элемента массива при обходе (`at`/`map`/`forEach`): массив → {@link ModelArray},
- * Opaque (Date/File/Blob) и примитив → значение, объект → под-модель {@link FormModel}.
- * Зеркалит листовой/объектный сплит {@link ModelValue} (но объект → под-модель с API),
- * чтобы `files: File[]`/`dates: Date[]`/вложенные массивы не мис-типизировались как `FormModel`.
- * @internal
- */
-type ModelArrayItem<U> = NonNullable<U> extends ReadonlyArray<infer E> ? ModelArray<E> : NonNullable<U> extends Opaque ? U : NonNullable<U> extends object ? FormModel<NonNullable<U>> : U;
-/**
- * Значение поля в value-доступе модели:
- * - массив → {@link ModelArray}
- * - спец-объект (Date/File/Blob) → как есть
- * - объект → под-модель {@link FormModel} (value-доступ + `.$`-сигналы + API get/set/patch/…);
- *   промоутится рантаймом (`makeFormModel`); сигналы идентичны `model.$.<path>`
- * - примитив → значение
- *
- * @group Model
- */
-export type ModelValue<V> = NonNullable<V> extends ReadonlyArray<infer U> ? ModelArray<U> : NonNullable<V> extends Opaque ? V : NonNullable<V> extends object ? FormModel<NonNullable<V>> : V;
-/**
- * Карта value-полей объекта (value-половина {@link FormModel}): поля доступны как обычные свойства
- * (чтение реактивно внутри `effect`/`computed`, запись — присваиванием). Вложенные объекты-поля
- * резолвятся в под-модели {@link FormModel} (см. {@link ModelValue}), массивы — в {@link ModelArray}.
- *
- * @group Model
- */
-export type ModelObject<T> = {
-    [K in keyof T]: ModelValue<T[K]>;
-};
-/**
- * Реактивный массив модели. Мутации (`push`/`removeAt`/…) меняют длину реактивно;
- * `map`/`forEach`/`at` отдают под-модель элемента ({@link FormModel}) для объектных элементов.
- *
- * @group Model
- */
-export interface ModelArray<U> {
-    /**
-     * Путь массива в модели (dot-нотация). Предоставляется рантаймом (value-прокси) и требуется
-     * рендер-слою для резолва узла массива (напр. `ArrayRenderNode` в `@reformer/renderer-react`).
-     */
-    readonly __path: string;
-    /** Реактивная длина. */
-    readonly length: number;
-    /** Добавить элемент в конец (значение элемента целиком). */
-    push(item: U): void;
-    /** Вставить элемент по индексу. */
-    insertAt(index: number, item: U): void;
-    /** Удалить элемент по индексу. */
-    removeAt(index: number): void;
-    /** Переместить элемент. */
-    move(from: number, to: number): void;
-    /** Поменять местами два элемента. */
-    swap(a: number, b: number): void;
-    /** Очистить массив. */
-    clear(): void;
-    /** Элемент по индексу: объект → под-модель, массив → {@link ModelArray}, лист → значение. */
-    at(index: number): NonNullable<U> extends object ? ModelArrayItem<U> : ModelArrayItem<U> | undefined;
-    /** Map по элементам (объект → {@link FormModel}, Opaque/примитив → значение, массив → {@link ModelArray}). */
-    map<R>(fn: (item: ModelArrayItem<U>, index: number) => R): R[];
-    /** Итерация по элементам (см. {@link ModelArrayItem}). */
-    forEach(fn: (item: ModelArrayItem<U>, index: number) => void): void;
-    /** Снимок массива значений (без подписки). */
-    toArray(): U[];
-    /** Индексный value-доступ. */
-    [index: number]: ModelValue<U>;
-}
-/**
- * Дерево сигналов (escape-hatch `model.$`): листья → {@link PathAwareSignal},
- * объекты → вложенное дерево, массивы → индексируемое дерево под-сигналов.
- *
- * @group Model
- */
-export type ModelSignals<T> = {
-    [K in keyof T]: ModelSignalNode<T[K]>;
-};
-/**
- * Узел дерева сигналов `model.$`: массив → индексируемый узел под-сигналов, Opaque (Date/File/Blob)
- * и примитив → {@link PathAwareSignal}, объект → вложенное дерево {@link ModelSignals}. Для примитивных
- * и Opaque массивов элемент — сам сигнал листа (а не под-дерево), поэтому `model.$.tags[0]` — это
- * `PathAwareSignal<string>`, а не `ModelSignals<never>`.
- * @internal
- */
-type ModelSignalNode<V> = NonNullable<V> extends ReadonlyArray<infer U> ? {
-    readonly length: number;
-    readonly [index: number]: ModelSignalNode<U>;
-} : NonNullable<V> extends Opaque ? PathAwareSignal<V> : NonNullable<V> extends object ? ModelSignals<NonNullable<V>> : PathAwareSignal<V>;
-/**
- * API уровня модели (доступно на корне, под-моделях вложенных объектов-групп и элементов массива).
- *
- * ⚠️ Имена методов (`$`/`get`/`set`/`patch`/`isDirty`/`reset`/`signalAt`/`captureInitial`)
- * зарезервированы: одноимённое поле формы их затеняет (редкий краевой случай).
- *
- * @group Model
- */
-export interface ModelApi<T> {
-    /** Escape-hatch к сигналам: `model.$.loanType` → `PathAwareSignal<LoanType>`. */
-    readonly $: ModelSignals<T>;
-    /** Снимок значений (без подписки) — для submit. */
-    get(): T;
-    /**
-     * Полная установка значений: принимает объект целиком (все ключи `T`) и записывает их в модель.
-     * Производными полями (цели `compute`) владеет compute — их значения из payload игнорируются.
-     * Не меняет initial-снимок. Для частичного обновления (только переданные ключи) — {@link ModelApi.patch}.
-     */
-    set(value: T): void;
-    /**
-     * Частичное слияние значений (load/patch с сервера): обновляет только переданные ключи,
-     * отсутствующие ключи НЕ трогаются. Не меняет initial-снимок.
-     */
-    patch(value: Partial<T>): void;
-    /** Отличаются ли текущие значения от initial-снимка (value-diff). */
-    isDirty(): boolean;
-    /** Сбросить значения к initial-снимку. */
-    reset(): void;
-    /** Зафиксировать текущие значения как новый initial-снимок («точка отсчёта»). */
-    captureInitial(): void;
-    /** Резолв строкового пути в сигнал (для error-routing/мостов). */
-    signalAt(path: string): PathAwareSignal<unknown> | undefined;
-}
-/**
- * FormModel — под-модель объекта `T`: value-доступ ({@link ModelObject}) + `.$`-сигналы + {@link ModelApi}
- * (get/set/patch/isDirty/reset/signalAt). Вложенные объекты-группы модели — тоже {@link FormModel}
- * (доступны как `model.<group>`), поэтому `model.<group>.$.<field>` эквивалентно `model.$.<group>.<field>`.
- *
- * @group Model
- */
-export type FormModel<T> = ModelObject<T> & ModelApi<T>;
-export {};

package/dist/state.d.ts

@@ -1,2 +0,0 @@
-export * from './state/index'
-export {}

package/dist/state.js

@@ -1,21 +0,0 @@
-import { c as s } from "./form-model-DYCzGGKF.js";
-import { c as o, a as t, r as c, b as i, d as m, e as d, f, s as l, t as n, w as u } from "./behaviors-value-C7dSEhCc.js";
-import { i as b, m as k, u as v } from "./derived-registry-CluZCQ7U.js";
-import { S as D } from "./subscription-manager-705bls97.js";
-export {
-  D as SubscriptionManager,
-  o as computeFrom,
-  t as copyFrom,
-  s as createModel,
-  b as isDerived,
-  k as markDerived,
-  c as resetWhen,
-  i as revalidateWhen,
-  m as runOutsideEffect,
-  d as safeCallback,
-  f as safeDebouncedCallback,
-  l as syncFields,
-  n as transformValue,
-  v as unmarkDerived,
-  u as watchField
-};

package/dist/subscription-manager-705bls97.js

@@ -1,171 +0,0 @@
-class t {
-  /**
-   * Хранилище подписок
-   * Ключ: уникальный идентификатор подписки
-   * Значение: функция отписки (dispose)
-   */
-  subscriptions = /* @__PURE__ */ new Map();
-  /**
-   * Добавляет подписку
-   *
-   * Если подписка с таким ключом уже существует, отписывается от неё
-   * и заменяет новой. Это предотвращает утечки памяти при повторной
-   * регистрации подписки с тем же ключом.
-   *
-   * @param key Уникальный ключ подписки
-   * @param dispose Функция отписки (обычно возвращаемая из effect())
-   * @returns Функция для отписки от этой конкретной подписки
-   *
-   * @example
-   * ```typescript
-   * const manager = new SubscriptionManager();
-   *
-   * // Добавление подписки
-   * const unsubscribe = manager.add('mySubscription', () => {
-   *   console.log('Disposing subscription');
-   * });
-   *
-   * // Отписка через возвращаемую функцию
-   * unsubscribe();
-   *
-   * // Или через manager.remove()
-   * manager.add('anotherSub', disposeFn);
-   * manager.remove('anotherSub');
-   * ```
-   */
-  add(s, i) {
-    return this.subscriptions.has(s) && (process.env.NODE_ENV !== "production" && console.warn(`[SubscriptionManager] Subscription "${s}" already exists, replacing`), this.subscriptions.get(s)?.()), this.subscriptions.set(s, i), () => this.remove(s);
-  }
-  /**
-   * Удаляет подписку по ключу
-   *
-   * Вызывает функцию отписки и удаляет подписку из хранилища.
-   * Если подписка с таким ключом не найдена, ничего не делает.
-   *
-   * @param key Ключ подписки
-   * @returns true, если подписка была удалена, false если не найдена
-   *
-   * @example
-   * ```typescript
-   * const manager = new SubscriptionManager();
-   * manager.add('mySub', disposeFn);
-   *
-   * // Удаление подписки
-   * const removed = manager.remove('mySub'); // true
-   *
-   * // Попытка удалить несуществующую подписку
-   * const removed2 = manager.remove('nonExistent'); // false
-   * ```
-   */
-  remove(s) {
-    const i = this.subscriptions.get(s);
-    return i ? (i(), this.subscriptions.delete(s), !0) : !1;
-  }
-  /**
-   * Очищает все подписки
-   *
-   * Вызывает функции отписки для всех активных подписок
-   * и очищает хранилище. Обычно используется при dispose узла формы.
-   *
-   * @example
-   * ```typescript
-   * class FieldNode {
-   *   private subscriptions = new SubscriptionManager();
-   *
-   *   dispose() {
-   *     // Отписываемся от всех effect
-   *     this.subscriptions.clear();
-   *   }
-   * }
-   * ```
-   */
-  clear() {
-    this.subscriptions.forEach((s) => {
-      s();
-    }), this.subscriptions.clear();
-  }
-  /**
-   * Возвращает количество активных подписок
-   *
-   * Полезно для отладки утечек памяти. Если количество подписок
-   * растет без ограничений, это может указывать на то, что
-   * компоненты не отписываются должным образом.
-   *
-   * @returns Количество активных подписок
-   *
-   * @example
-   * ```typescript
-   * const manager = new SubscriptionManager();
-   * console.log(manager.size()); // 0
-   *
-   * manager.add('sub1', disposeFn1);
-   * manager.add('sub2', disposeFn2);
-   * console.log(manager.size()); // 2
-   *
-   * manager.clear();
-   * console.log(manager.size()); // 0
-   * ```
-   */
-  size() {
-    return this.subscriptions.size;
-  }
-  /**
-   * Проверяет, есть ли подписка с данным ключом
-   *
-   * @param key Ключ подписки
-   * @returns true, если подписка существует
-   *
-   * @example
-   * ```typescript
-   * const manager = new SubscriptionManager();
-   * manager.add('mySub', disposeFn);
-   *
-   * console.log(manager.has('mySub')); // true
-   * console.log(manager.has('nonExistent')); // false
-   * ```
-   */
-  has(s) {
-    return this.subscriptions.has(s);
-  }
-  /**
-   * Возвращает список всех ключей активных подписок
-   *
-   * Полезно для отладки: можно увидеть, какие подписки активны.
-   *
-   * @returns Массив ключей всех активных подписок
-   *
-   * @example
-   * ```typescript
-   * const manager = new SubscriptionManager();
-   * manager.add('watch-value', disposeFn1);
-   * manager.add('watch-errors', disposeFn2);
-   *
-   * console.log(manager.getKeys()); // ['watch-value', 'watch-errors']
-   * ```
-   */
-  getKeys() {
-    return Array.from(this.subscriptions.keys());
-  }
-  /**
-   * Отписывается от всех подписок (алиас для clear())
-   *
-   * Используется при dispose() узла формы для совместимости с ожидаемым API.
-   *
-   * @example
-   * ```typescript
-   * class FieldNode {
-   *   private subscriptions = new SubscriptionManager();
-   *
-   *   dispose() {
-   *     this.subscriptions.dispose();
-   *   }
-   * }
-   * ```
-   */
-  dispose() {
-    this.clear();
-  }
-}
-export {
-  t as S
-};