@reformer/core 5.0.0 → 6.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reformer/core",
-  "version": "5.0.0",
+  "version": "6.0.0",
   "description": "Reactive form state management library for React with signals-based architecture",
   "type": "module",
   "main": "./dist/index.js",
@@ -55,45 +55,29 @@
       "types": "./dist/validators/phone.d.ts",
       "import": "./dist/validators/phone.js"
     },
-    "./validators/number": {
-      "types": "./dist/validators/number.d.ts",
-      "import": "./dist/validators/number.js"
+    "./validators/is-number": {
+      "types": "./dist/validators/is-number.d.ts",
+      "import": "./dist/validators/is-number.js"
     },
-    "./validators/date": {
-      "types": "./dist/validators/date.d.ts",
-      "import": "./dist/validators/date.js"
-    },
-    "./behaviors/copy-from": {
-      "types": "./dist/behaviors/copy-from.d.ts",
-      "import": "./dist/behaviors/copy-from.js"
-    },
-    "./behaviors/enable-when": {
-      "types": "./dist/behaviors/enable-when.d.ts",
-      "import": "./dist/behaviors/enable-when.js"
+    "./validators/integer": {
+      "types": "./dist/validators/integer.d.ts",
+      "import": "./dist/validators/integer.js"
     },
-    "./behaviors/compute-from": {
-      "types": "./dist/behaviors/compute-from.d.ts",
-      "import": "./dist/behaviors/compute-from.js"
+    "./validators/multiple-of": {
+      "types": "./dist/validators/multiple-of.d.ts",
+      "import": "./dist/validators/multiple-of.js"
     },
-    "./behaviors/watch-field": {
-      "types": "./dist/behaviors/watch-field.d.ts",
-      "import": "./dist/behaviors/watch-field.js"
+    "./validators/non-negative": {
+      "types": "./dist/validators/non-negative.d.ts",
+      "import": "./dist/validators/non-negative.js"
     },
-    "./behaviors/revalidate-when": {
-      "types": "./dist/behaviors/revalidate-when.d.ts",
-      "import": "./dist/behaviors/revalidate-when.js"
+    "./validators/non-zero": {
+      "types": "./dist/validators/non-zero.d.ts",
+      "import": "./dist/validators/non-zero.js"
     },
-    "./behaviors/sync-fields": {
-      "types": "./dist/behaviors/sync-fields.d.ts",
-      "import": "./dist/behaviors/sync-fields.js"
-    },
-    "./behaviors/reset-when": {
-      "types": "./dist/behaviors/reset-when.d.ts",
-      "import": "./dist/behaviors/reset-when.js"
-    },
-    "./behaviors/transform-value": {
-      "types": "./dist/behaviors/transform-value.d.ts",
-      "import": "./dist/behaviors/transform-value.js"
+    "./validators/date": {
+      "types": "./dist/validators/date.d.ts",
+      "import": "./dist/validators/date.js"
     }
   },
   "sideEffects": false,

package/dist/behaviors/compute-from.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/compute-from'
-export {}

package/dist/behaviors/compute-from.js

@@ -1,31 +0,0 @@
-import { effect as _ } from "@preact/signals-core";
-import { b as v } from "../registry-helpers-Bv_BJ1s-.js";
-import { r as V } from "../safe-effect-Dh8uw81c.js";
-function N(n, i, s, f) {
-  const { debounce: p, condition: u } = f || {}, h = (r, E, m) => {
-    const a = r.getFieldByPath(i.__path);
-    if (!a) return null;
-    const o = n.map((e) => r.getFieldByPath(e.__path)).filter((e) => e !== void 0);
-    return o.length === 0 ? null : _(() => {
-      o.forEach((e) => e.value.value), m(() => {
-        if (u) {
-          const t = r.getValue();
-          if (!u(t)) return;
-        }
-        const e = o.map((t) => t.value.value), l = {};
-        n.forEach((t, d) => {
-          const g = t.__path.split(".").pop() || t.__path;
-          l[g] = e[d];
-        });
-        const c = s(l);
-        a.value.peek() !== c && V(() => {
-          a.setValue(c, { emitEvent: !1 });
-        });
-      });
-    });
-  };
-  v().register(h, { debounce: p });
-}
-export {
-  N as computeFrom
-};

package/dist/behaviors/copy-from.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/copy-from'
-export {}

package/dist/behaviors/copy-from.js

@@ -1,29 +0,0 @@
-import { r as s } from "../safe-effect-Dh8uw81c.js";
-import { watchField as d } from "./watch-field.js";
-function E(l, c, m) {
-  const { when: a, fields: o = "all", transform: i, debounce: p } = m || {};
-  d(
-    l,
-    (t, n) => {
-      if (a) {
-        const f = n.form.getValue();
-        if (!a(f)) return;
-      }
-      const h = i ? i(t) : t, e = n.form.getFieldByPath(c.__path);
-      e && s(() => {
-        if (o === "all" || !o)
-          e.setValue(h, { emitEvent: !1 });
-        else {
-          const f = {};
-          o.forEach((r) => {
-            t && typeof t == "object" && (f[r] = t[r]);
-          }), "patchValue" in e && e.patchValue(f);
-        }
-      });
-    },
-    { debounce: p }
-  );
-}
-export {
-  E as copyFrom
-};

package/dist/behaviors/enable-when.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/enable-when'
-export {}

package/dist/behaviors/enable-when.js

@@ -1,25 +0,0 @@
-import { effect as c } from "@preact/signals-core";
-import { b } from "../registry-helpers-Bv_BJ1s-.js";
-import { r as d } from "../safe-effect-Dh8uw81c.js";
-function h(t, n, r) {
-  const { debounce: o, resetOnDisable: a = !1 } = r || {}, i = (s, m, l) => {
-    const e = s.getFieldByPath(t.__path);
-    return e ? c(() => {
-      const f = s.value.value;
-      l(() => {
-        const u = n(f);
-        d(() => {
-          u ? e.enable() : (e.disable(), a && e.reset());
-        });
-      });
-    }) : null;
-  };
-  b().register(i, { debounce: o });
-}
-function _(t, n, r) {
-  h(t, (o) => !n(o), r);
-}
-export {
-  _ as disableWhen,
-  h as enableWhen
-};

package/dist/behaviors/reset-when.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/reset-when'
-export {}

package/dist/behaviors/reset-when.js

@@ -1,24 +0,0 @@
-import { effect as c } from "@preact/signals-core";
-import { b as d } from "../registry-helpers-Bv_BJ1s-.js";
-import { r as h } from "../safe-effect-Dh8uw81c.js";
-function R(r, n, o) {
-  const { debounce: s, resetValue: u = null, onlyIfDirty: a = !1 } = o || {}, i = (t, m, l) => {
-    const e = t.getFieldByPath(r.__path);
-    return e ? c(() => {
-      const f = t.value.value;
-      l(() => {
-        if (n(f)) {
-          if (a && !e.dirty.value)
-            return;
-          h(() => {
-            e.setValue(u), e.markAsPristine(), e.markAsUntouched();
-          });
-        }
-      });
-    }) : null;
-  };
-  d().register(i, { debounce: s });
-}
-export {
-  R as resetWhen
-};

package/dist/behaviors/revalidate-when.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/revalidate-when'
-export {}

package/dist/behaviors/revalidate-when.js

@@ -1,18 +0,0 @@
-import { effect as d } from "@preact/signals-core";
-import { b as h } from "../registry-helpers-Bv_BJ1s-.js";
-function p(o, a, i) {
-  const { debounce: l } = i || {}, u = (t, s, c) => {
-    const r = t.getFieldByPath(o.__path);
-    if (!r) return null;
-    const n = a.map((e) => t.getFieldByPath(e.__path)).filter((e) => e !== void 0);
-    return n.length === 0 ? null : d(() => {
-      n.forEach((e) => e.value.value), c(() => {
-        r.validate();
-      });
-    });
-  };
-  h().register(u, { debounce: l });
-}
-export {
-  p as revalidateWhen
-};

package/dist/behaviors/sync-fields.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/sync-fields'
-export {}

package/dist/behaviors/sync-fields.js

@@ -1,41 +0,0 @@
-import { effect as o } from "@preact/signals-core";
-import { b as v } from "../registry-helpers-Bv_BJ1s-.js";
-import { r as i } from "../safe-effect-Dh8uw81c.js";
-function E(u, f, c) {
-  const { debounce: d, transform: a } = c || {}, p = (n, h, l) => {
-    const r = n.getFieldByPath(u.__path), s = n.getFieldByPath(f.__path);
-    if (!r || !s) return null;
-    let e = !1;
-    const g = o(() => {
-      const t = r.value.value;
-      e || l(() => {
-        e = !0, i(() => {
-          try {
-            const y = a ? a(t) : t;
-            s.setValue(y, { emitEvent: !1 });
-          } finally {
-            e = !1;
-          }
-        });
-      });
-    }), m = o(() => {
-      const t = s.value.value;
-      e || l(() => {
-        e = !0, i(() => {
-          try {
-            r.setValue(t, { emitEvent: !1 });
-          } finally {
-            e = !1;
-          }
-        });
-      });
-    });
-    return () => {
-      g(), m();
-    };
-  };
-  v().register(p, { debounce: d });
-}
-export {
-  E as syncFields
-};

package/dist/behaviors/transform-value.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/transform-value'
-export {}

package/dist/behaviors/transform-value.js

@@ -1,45 +0,0 @@
-import { watchField as p } from "./watch-field.js";
-function u(e, t, o) {
-  const { onUserChangeOnly: n = !1, emitEvent: m = !0, debounce: c } = o || {};
-  p(
-    e,
-    (s, i) => {
-      const a = i.form.getFieldByPath(e.__path);
-      if (!a || n && !a.touched.value)
-        return;
-      const f = t(s);
-      f !== s && a.setValue(f, { emitEvent: m });
-    },
-    { debounce: c }
-  );
-}
-function r(e, t) {
-  return (o, n) => {
-    u(o, e, { ...t, ...n });
-  };
-}
-const h = {
-  /** Перевести в верхний регистр */
-  toUpperCase: r((e) => e?.toUpperCase()),
-  /** Перевести в нижний регистр */
-  toLowerCase: r((e) => e?.toLowerCase()),
-  /** Удалить пробелы с краев */
-  trim: r((e) => e?.trim()),
-  /** Удалить все пробелы */
-  removeSpaces: r((e) => e?.replace(/\s/g, "")),
-  /** Оставить только цифры */
-  digitsOnly: r((e) => e?.replace(/\D/g, "")),
-  /** Округлить число */
-  round: r(
-    (e) => typeof e == "number" ? Math.round(e) : e
-  ),
-  /** Округлить до 2 знаков после запятой */
-  roundTo2: r(
-    (e) => typeof e == "number" ? Math.round(e * 100) / 100 : e
-  )
-};
-export {
-  r as createTransformer,
-  u as transformValue,
-  h as transformers
-};

package/dist/behaviors/watch-field.d.ts

@@ -1,2 +0,0 @@
-export * from '../core/behavior/behaviors/watch-field'
-export {}

package/dist/behaviors/watch-field.js

@@ -1,21 +0,0 @@
-import { effect as c } from "@preact/signals-core";
-import { b as d } from "../registry-helpers-Bv_BJ1s-.js";
-import { r as i } from "../safe-effect-Dh8uw81c.js";
-function g(n, r, u) {
-  const { debounce: a, immediate: f = !1 } = u || {}, s = (l, o, m) => {
-    const e = l.getFieldByPath(n.__path);
-    return e ? (f && i(() => {
-      const t = e.value.value;
-      r(t, o);
-    }), c(() => {
-      const t = e.value.value;
-      m(() => {
-        i(() => r(t, o));
-      });
-    })) : null;
-  };
-  d().register(s, { debounce: a });
-}
-export {
-  g as watchField
-};

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

@@ -1,47 +0,0 @@
-import { GroupNode } from '../nodes/group-node';
-import { FormProxy } from '../types/form-proxy';
-import { FormContext } from '../types/form-context';
-import { FieldPathNode } from '../types/field-path';
-/**
- * Реализация {@link FormContext} для behaviors. Создаётся фреймворком и передаётся
- * в callback'и behaviors (`watchField`, `computeFrom`, …) — напрямую инстанцировать
- * не нужно.
- *
- * @example
- * ```typescript
- * import { watchField } from '@reformer/core/behaviors/watch-field';
- *
- * watchField(path.country, (value, ctx) => {
- *   // ctx — экземпляр BehaviorContextImpl
- *   ctx.setFieldValue(path.city, '');
- * });
- * ```
- */
-export declare class BehaviorContextImpl<TForm> implements FormContext<TForm> {
-    /**
-     * Форма с типизированным Proxy-доступом к полям
-     */
-    readonly form: FormProxy<TForm>;
-    private _form;
-    constructor(form: GroupNode<TForm>);
-    /**
-     * Безопасно установить значение поля по строковому пути или FieldPath
-     *
-     * Автоматически использует emitEvent: false для предотвращения циклов
-     *
-     * @param path - Строковый путь к полю или FieldPath объект
-     * @param value - Новое значение
-     */
-    setFieldValue(path: string | FieldPathNode<TForm, unknown>, value: unknown): void;
-    /**
-     * Получить поле формы по строковому пути
-     *
-     * Используется для динамического доступа к вложенным полям, например:
-     * - `ctx.getFieldByPath('address.city')` -> FieldNode
-     * - `ctx.getFieldByPath(path.city.__path)` -> FieldNode (для nested behaviors)
-     *
-     * @param path - Строковый путь к полю (например "address.city")
-     * @returns FieldNode или undefined если поле не найдено
-     */
-    getFieldByPath(path: string): import('../..').FormNode<import('../types').FormValue> | undefined;
-}

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

@@ -1,85 +0,0 @@
-import { GroupNode } from '../nodes/group-node';
-import { BehaviorHandlerFn, BehaviorOptions } from './types';
-import { AbstractRegistry } from '../utils/abstract-registry';
-import { FormFields } from '../types';
-/**
- * Зарегистрированный behavior с опциями
- */
-export interface RegisteredBehavior {
-    /** Handler функция behavior */
-    handler: BehaviorHandlerFn<FormFields>;
-    /** Debounce в миллисекундах */
-    debounce?: number;
-}
-/**
- * Реестр behaviors для формы
- *
- * Каждый экземпляр GroupNode создает собственный реестр (композиция).
- * Устраняет race conditions и изолирует формы друг от друга.
- *
- * Наследует AbstractRegistry для унификации:
- * - Управления global stack
- * - Template methods begin/end registration
- *
- * @example
- * ```typescript
- * class GroupNode {
- *   private readonly behaviorRegistry = new BehaviorRegistry();
- *
- *   applyBehaviorSchema(schemaFn) {
- *     this.behaviorRegistry.beginRegistration(); // Pushes this to stack
- *     schemaFn(createBehaviorFieldPath(this));   // Uses getCurrent()
- *     return this.behaviorRegistry.endRegistration(this); // Pops from stack
- *   }
- * }
- * ```
- */
-export declare class BehaviorRegistry extends AbstractRegistry<RegisteredBehavior> {
-    /**
-     * Получить текущий активный реестр из context stack
-     *
-     * @returns Текущий активный реестр или null
-     *
-     * @example
-     * ```typescript
-     * // В schema-behaviors.ts
-     * export function copyFrom(...) {
-     *   const registry = BehaviorRegistry.getCurrent();
-     *   if (registry) {
-     *     registry.register({ ... });
-     *   }
-     * }
-     * ```
-     */
-    static getCurrent(): BehaviorRegistry | null;
-    /**
-     * Зарегистрировать behavior handler
-     * Вызывается функциями из schema-behaviors.ts
-     *
-     * @param handler - BehaviorHandlerFn функция
-     * @param options - Опции behavior (debounce)
-     *
-     * @example
-     * ```typescript
-     * const handler = createCopyBehavior(target, source, { when: ... });
-     * registry.register(handler, { debounce: 300 });
-     * ```
-     */
-    register<T extends FormFields>(handler: BehaviorHandlerFn<T>, options?: BehaviorOptions): void;
-    /**
-     * Завершить регистрацию и применить behaviors к форме
-     * Создает effect подписки для всех зарегистрированных behaviors
-     *
-     * @param form - GroupNode формы
-     * @returns Количество зарегистрированных behaviors и функция cleanup
-     */
-    endRegistration<T extends FormFields>(form: GroupNode<T>): {
-        count: number;
-        cleanup: () => void;
-    };
-    /**
-     * Создать effect подписку для behavior
-     * @private
-     */
-    private createEffect;
-}

package/dist/core/behavior/behaviors/compute-from.d.ts

@@ -1,70 +0,0 @@
-import { FieldPathNode } from '../../types';
-import { ComputeFromOptions } from '../types';
-/**
- * Автоматически вычисляет значение поля на основе других полей
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param sources - Массив полей-зависимостей
- * @param target - Поле для записи результата
- * @param computeFn - Функция вычисления (принимает объект с именами полей)
- * @param options - Опции (`debounce`, `condition`, `trigger`)
- *
- * @example Многополевой расчёт — total = price × quantity
- * ```typescript
- * import { computeFrom, type BehaviorSchemaFn } from '@reformer/core/behaviors';
- *
- * interface OrderForm {
- *   price: number;
- *   quantity: number;
- *   total: number;
- * }
- *
- * export const orderBehavior: BehaviorSchemaFn<OrderForm> = (path) => {
- *   computeFrom(
- *     [path.price, path.quantity],
- *     path.total,
- *     (values) =>
- *       (typeof values.price === 'number' ? values.price : 0) *
- *       (typeof values.quantity === 'number' ? values.quantity : 0),
- *   );
- * };
- * ```
- *
- * @example Edge case — async-like дорогие вычисления с `debounce` и условием
- * ```typescript
- * import { computeFrom, type BehaviorSchemaFn } from '@reformer/core/behaviors';
- *
- * interface MortgageForm {
- *   loanType: 'mortgage' | 'consumer';
- *   loanAmount: number;
- *   loanTerm: number;
- *   interestRate: number;
- *   monthlyPayment: number;
- * }
- *
- * function annuity(values: MortgageForm): number {
- *   const { loanAmount, loanTerm, interestRate } = values;
- *   if (!loanAmount || !loanTerm || !interestRate) return 0;
- *   const r = interestRate / 100 / 12;
- *   const n = loanTerm;
- *   return Math.round((loanAmount * r * Math.pow(1 + r, n)) / (Math.pow(1 + r, n) - 1));
- * }
- *
- * export const mortgageBehavior: BehaviorSchemaFn<MortgageForm> = (path) => {
- *   computeFrom(
- *     [path.loanAmount, path.loanTerm, path.interestRate],
- *     path.monthlyPayment,
- *     annuity,
- *     {
- *       debounce: 300,                                  // не пересчитываем на каждый keystroke
- *       condition: (form) => form.loanType === 'mortgage', // считаем только для ипотеки
- *     },
- *   );
- * };
- * ```
- *
- * @see [docs/llms/20-compute-vs-watch.md](../../../../docs/llms/20-compute-vs-watch.md)
- */
-export declare function computeFrom<TForm, TTarget>(sources: FieldPathNode<TForm, any>[], target: FieldPathNode<TForm, TTarget>, computeFn: (values: TForm) => TTarget, options?: ComputeFromOptions<TForm>): void;

package/dist/core/behavior/behaviors/copy-from.d.ts

@@ -1,56 +0,0 @@
-import { FieldPathNode } from '../../types';
-import { CopyFromOptions } from '../types';
-/**
- * Копирует значения из одного поля/группы в другое при выполнении условия
- *
- * @group Behaviors
- * @category Behavior Rules
- *
- * @param source - Откуда копировать
- * @param target - Куда копировать
- * @param options - Опции копирования (`when`, `fields`, `transform`, `debounce`)
- *
- * @example Скаляр → скаляр с условием
- * ```typescript
- * import { copyFrom, type BehaviorSchemaFn } from '@reformer/core/behaviors';
- *
- * interface ContactForm {
- *   sameEmail: boolean;
- *   email: string;
- *   emailAdditional: string;
- * }
- *
- * export const contactBehavior: BehaviorSchemaFn<ContactForm> = (path) => {
- *   copyFrom(path.email, path.emailAdditional, {
- *     when: (form) => form.sameEmail === true,
- *   });
- * };
- * ```
- *
- * @example Копирование группы с подмножеством полей и `transform`
- * ```typescript
- * import { copyFrom, type BehaviorSchemaFn } from '@reformer/core/behaviors';
- *
- * interface Address { country: string; region: string; city: string; street: string }
- * interface ProfileForm {
- *   sameAsRegistration: boolean;
- *   registrationAddress: Address;
- *   residenceAddress: Address;
- * }
- *
- * export const profileBehavior: BehaviorSchemaFn<ProfileForm> = (path) => {
- *   copyFrom(path.registrationAddress, path.residenceAddress, {
- *     when: (form) => form.sameAsRegistration === true,
- *     fields: ['country', 'region', 'city'], // street НЕ копируем
- *     transform: (addr) => ({
- *       ...addr,
- *       country: addr.country.toUpperCase(), // нормализация при копировании
- *     }),
- *     debounce: 200,
- *   });
- * };
- * ```
- *
- * @see [docs/llms/23-copy-from.md](../../../../docs/llms/23-copy-from.md)
- */
-export declare function copyFrom<TForm, TSource, TTarget>(source: FieldPathNode<TForm, TSource>, target: FieldPathNode<TForm, TTarget>, options?: CopyFromOptions<TSource, TForm>): void;