@reformer/core 1.1.0 → 2.0.0-beta.10

package/dist/core/validation/validators/required.d.ts

@@ -1,12 +1,5 @@
-/**
- * Валидатор обязательного поля
- *
- * @group Validation
- * @category Validators
- * @module validators/required
- */
-import type { ValidateOptions } from '../../types/validation-schema';
-import type { FieldPathNode } from '../../types';
+import { ValidateOptions } from '../../types/validation-schema';
+import { FieldPathNode } from '../../types';
 /**
  * Валидатор обязательного поля
  *

package/dist/core/validation/validators/url.d.ts

@@ -1,12 +1,5 @@
-/**
- * Валидатор URL
- *
- * @group Validation
- * @category Validators
- * @module validators/url
- */
-import type { ValidateOptions } from '../../types/validation-schema';
-import type { FieldPathNode } from '../../types';
+import { ValidateOptions } from '../../types/validation-schema';
+import { FieldPathNode } from '../../types';
 /**
  * Адаптер для URL валидатора
  * Поддерживает опциональные поля (string | undefined)

package/dist/date-utils-xUWFslTj.js

@@ -0,0 +1,29 @@
+function r(t) {
+  if (t == null || t === "")
+    return null;
+  if (t instanceof Date)
+    return isNaN(t.getTime()) ? null : t;
+  if (typeof t == "string") {
+    const n = new Date(t);
+    return isNaN(n.getTime()) ? null : n;
+  }
+  return null;
+}
+function e() {
+  const t = /* @__PURE__ */ new Date();
+  return t.setHours(0, 0, 0, 0), t;
+}
+function o(t) {
+  const n = new Date(t);
+  return n.setHours(0, 0, 0, 0), n;
+}
+function i(t) {
+  const n = e();
+  return Math.floor((n.getTime() - t.getTime()) / (365.25 * 24 * 60 * 60 * 1e3));
+}
+export {
+  i as c,
+  e as g,
+  o as n,
+  r as p
+};

package/dist/field-path-DuKdGcIE.js

@@ -0,0 +1,66 @@
+function c() {
+  return _("");
+}
+function _(t) {
+  return new Proxy({}, {
+    get(r, i) {
+      if (typeof i == "symbol")
+        return;
+      if (i === "__path" || i === "__fieldPath")
+        return t || i;
+      if (i === "__key") {
+        const n = t.split(".");
+        return n[n.length - 1] || i;
+      }
+      if (i === "then" || i === "catch" || i === "finally" || i === "constructor" || i === "toString" || i === "valueOf" || i === "toJSON")
+        return;
+      const f = t ? `${t}.${i}` : i, a = {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        __key: i,
+        __path: f,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        __formType: void 0,
+        __fieldType: void 0
+      };
+      return new Proxy(a, {
+        get(n, e) {
+          if (typeof e != "symbol") {
+            if (e === "__path" || e === "__fieldPath") return f;
+            if (e === "__key") return i;
+            if (e !== "__formType" && e !== "__fieldType" && !(e === "then" || e === "catch" || e === "finally" || e === "constructor" || e === "toString" || e === "valueOf" || e === "toJSON"))
+              return _(`${f}.${e}`);
+          }
+        }
+      });
+    }
+  });
+}
+function u(t) {
+  if (typeof t == "string")
+    return t;
+  if (t && typeof t == "object") {
+    const r = t.__path;
+    if (typeof r == "string")
+      return r;
+  }
+  throw new Error("Invalid field path node: " + JSON.stringify(t));
+}
+function y(t) {
+  const r = u(t);
+  return _(r);
+}
+function l(t) {
+  if (t && typeof t == "object" && "__key" in t)
+    return t.__key;
+  if (typeof t == "string") {
+    const r = t.split(".");
+    return r[r.length - 1];
+  }
+  throw new Error("Invalid field path node");
+}
+export {
+  l as a,
+  c,
+  u as e,
+  y as t
+};

package/dist/hooks/types.d.ts

@@ -0,0 +1,328 @@
+import { ValidationError } from '../core/types';
+/**
+ * Состояние поля формы, возвращаемое хуком {@link useFormControl} для {@link FieldNode}.
+ *
+ * Содержит реактивные данные поля: значение, состояние валидации, флаги взаимодействия
+ * и пользовательские props для компонентов.
+ *
+ * @typeParam T - Тип значения поля (string, number, boolean и т.д.)
+ *
+ * @example Базовое использование
+ * ```tsx
+ * interface Props {
+ *   control: FieldNode<string>;
+ * }
+ *
+ * function TextField({ control }: Props) {
+ *   const state = useFormControl(control);
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={state.value}
+ *         disabled={state.disabled}
+ *         onChange={e => control.setValue(e.target.value)}
+ *       />
+ *       {state.shouldShowError && state.errors[0] && (
+ *         <span className="error">{state.errors[0].message}</span>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link useFormControl} - хук для получения состояния
+ * @see {@link ArrayControlState} - состояние для массивов
+ *
+ * @group Types
+ */
+export interface FieldControlState<T> {
+    /**
+     * Текущее значение поля.
+     *
+     * @example
+     * ```tsx
+     * const { value } = useFormControl(emailField);
+     * console.log(value); // "user@example.com"
+     * ```
+     */
+    value: T;
+    /**
+     * Флаг асинхронной валидации или загрузки.
+     * `true` когда выполняется асинхронный валидатор.
+     *
+     * @example
+     * ```tsx
+     * const { pending } = useFormControl(usernameField);
+     *
+     * return (
+     *   <div>
+     *     <input {...props} />
+     *     {pending && <Spinner size="small" />}
+     *   </div>
+     * );
+     * ```
+     */
+    pending: boolean;
+    /**
+     * Флаг отключения поля.
+     * `true` когда поле недоступно для редактирования.
+     *
+     * @example
+     * ```tsx
+     * const { disabled, value } = useFormControl(field);
+     *
+     * return (
+     *   <input
+     *     value={value}
+     *     disabled={disabled}
+     *     className={disabled ? 'opacity-50' : ''}
+     *   />
+     * );
+     * ```
+     */
+    disabled: boolean;
+    /**
+     * Массив ошибок валидации.
+     * Пустой массив означает отсутствие ошибок.
+     *
+     * @example
+     * ```tsx
+     * const { errors } = useFormControl(field);
+     *
+     * return (
+     *   <ul className="error-list">
+     *     {errors.map((error, i) => (
+     *       <li key={i}>{error.message}</li>
+     *     ))}
+     *   </ul>
+     * );
+     * ```
+     */
+    errors: ValidationError[];
+    /**
+     * Флаг валидности поля.
+     * `true` когда поле прошло все валидации (errors.length === 0).
+     *
+     * @example
+     * ```tsx
+     * const { valid } = useFormControl(field);
+     *
+     * return (
+     *   <input className={valid ? 'border-green' : 'border-gray'} />
+     * );
+     * ```
+     */
+    valid: boolean;
+    /**
+     * Флаг невалидности поля.
+     * `true` когда есть ошибки валидации (errors.length > 0).
+     * Противоположность {@link valid}.
+     *
+     * @example
+     * ```tsx
+     * const { invalid } = useFormControl(field);
+     *
+     * return (
+     *   <input
+     *     aria-invalid={invalid}
+     *     className={invalid ? 'border-red' : ''}
+     *   />
+     * );
+     * ```
+     */
+    invalid: boolean;
+    /**
+     * Флаг взаимодействия с полем.
+     * `true` после того как поле потеряло фокус (blur) хотя бы один раз.
+     *
+     * @example
+     * ```tsx
+     * const { touched, invalid } = useFormControl(field);
+     *
+     * // Показываем ошибку только после взаимодействия
+     * const showError = touched && invalid;
+     * ```
+     */
+    touched: boolean;
+    /**
+     * Флаг для отображения ошибки.
+     * Комбинация touched && invalid - удобный shortcut для UI.
+     *
+     * @example
+     * ```tsx
+     * const { shouldShowError, errors } = useFormControl(field);
+     *
+     * return (
+     *   <div>
+     *     <input {...props} />
+     *     {shouldShowError && (
+     *       <span className="error">{errors[0]?.message}</span>
+     *     )}
+     *   </div>
+     * );
+     * ```
+     */
+    shouldShowError: boolean;
+    /**
+     * Пользовательские props для передачи в UI-компоненты.
+     * Устанавливаются через {@link FieldNode.setComponentProps}.
+     *
+     * @example
+     * ```tsx
+     * // Установка props
+     * field.setComponentProps({
+     *   placeholder: 'Enter email...',
+     *   maxLength: 100,
+     *   autoComplete: 'email'
+     * });
+     *
+     * // Использование в компоненте
+     * const { componentProps, value } = useFormControl(field);
+     *
+     * return (
+     *   <input
+     *     value={value}
+     *     placeholder={componentProps.placeholder}
+     *     maxLength={componentProps.maxLength}
+     *     autoComplete={componentProps.autoComplete}
+     *   />
+     * );
+     * ```
+     */
+    componentProps: Record<string, any>;
+}
+/**
+ * Состояние массива формы, возвращаемое хуком {@link useFormControl} для {@link ArrayNode}.
+ *
+ * Содержит реактивные данные массива: значения элементов, длину, состояние валидации
+ * и флаги взаимодействия.
+ *
+ * @typeParam T - Тип элемента массива (обычно объект с полями формы)
+ *
+ * @example Список с динамическим добавлением
+ * ```tsx
+ * interface Phone {
+ *   type: string;
+ *   number: string;
+ * }
+ *
+ * interface Props {
+ *   control: ArrayNode<Phone>;
+ * }
+ *
+ * function PhoneList({ control }: Props) {
+ *   const { length, valid } = useFormControl(control);
+ *
+ *   return (
+ *     <div>
+ *       {control.map((item, index) => (
+ *         <PhoneItem
+ *           key={item.id}
+ *           control={item}
+ *           onRemove={() => control.remove(index)}
+ *         />
+ *       ))}
+ *
+ *       {length === 0 && <p>No phones added</p>}
+ *
+ *       <button onClick={() => control.push({ type: 'mobile', number: '' })}>
+ *         Add Phone
+ *       </button>
+ *
+ *       {!valid && <p className="error">Please fix phone errors</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @see {@link useFormControl} - хук для получения состояния
+ * @see {@link FieldControlState} - состояние для полей
+ *
+ * @group Types
+ */
+export interface ArrayControlState<T> {
+    /**
+     * Массив текущих значений всех элементов.
+     *
+     * @example
+     * ```tsx
+     * const { value } = useFormControl(phonesArray);
+     * console.log(value);
+     * // [{ type: 'mobile', number: '+1234567890' }, { type: 'home', number: '+0987654321' }]
+     * ```
+     */
+    value: T[];
+    /**
+     * Количество элементов в массиве.
+     * Эквивалентно value.length, но оптимизировано для реактивности.
+     *
+     * @example
+     * ```tsx
+     * const { length } = useFormControl(itemsArray);
+     *
+     * return (
+     *   <div>
+     *     <span>Items: {length}</span>
+     *     {length >= 10 && <span>Maximum reached</span>}
+     *   </div>
+     * );
+     * ```
+     */
+    length: number;
+    /**
+     * Флаг асинхронной валидации.
+     * `true` когда выполняется асинхронный валидатор массива или любого элемента.
+     */
+    pending: boolean;
+    /**
+     * Массив ошибок валидации уровня массива.
+     * Не включает ошибки отдельных элементов.
+     *
+     * @example
+     * ```tsx
+     * // Валидатор массива
+     * validators.apply(phonesArray, {
+     *   validator: (phones) => phones.length >= 1,
+     *   message: 'At least one phone required'
+     * });
+     *
+     * // В компоненте
+     * const { errors } = useFormControl(phonesArray);
+     * // errors содержит ошибку "At least one phone required" если массив пуст
+     * ```
+     */
+    errors: ValidationError[];
+    /**
+     * Флаг валидности массива и всех его элементов.
+     * `true` только когда массив и все вложенные элементы валидны.
+     */
+    valid: boolean;
+    /**
+     * Флаг невалидности.
+     * `true` когда есть ошибки в массиве или любом элементе.
+     */
+    invalid: boolean;
+    /**
+     * Флаг взаимодействия.
+     * `true` после взаимодействия с любым элементом массива.
+     */
+    touched: boolean;
+    /**
+     * Флаг изменения.
+     * `true` когда значение массива отличается от начального.
+     *
+     * @example
+     * ```tsx
+     * const { dirty } = useFormControl(itemsArray);
+     *
+     * return (
+     *   <div>
+     *     {dirty && <span>* Unsaved changes</span>}
+     *     <button disabled={!dirty}>Save</button>
+     *   </div>
+     * );
+     * ```
+     */
+    dirty: boolean;
+}

package/dist/hooks/useArrayLength.d.ts

@@ -0,0 +1,31 @@
+import { ArrayNode } from '../core/nodes/array-node';
+import { FormFields } from '../core/types';
+/**
+ * React-хук для подписки только на длину массива.
+ *
+ * Оптимизированная версия {@link useFormControl} для ArrayNode, которая
+ * подписывается только на сигнал `length`. Компонент не будет ре-рендериться
+ * при изменении значений вложенных полей.
+ *
+ * @typeParam T - Тип элемента массива
+ * @param control - ArrayNode для подписки
+ * @returns Текущая длина массива
+ *
+ * @example
+ * ```tsx
+ * function ArrayRenderer({ arrayNode }) {
+ *   const length = useArrayLength(arrayNode);
+ *
+ *   return (
+ *     <div>
+ *       {arrayNode.map((item, index) => (
+ *         <ItemRenderer key={item.id} item={item} />
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @group React Hooks
+ */
+export declare function useArrayLength<T extends FormFields>(control: ArrayNode<T>): number;

package/dist/hooks/useFormControl.d.ts

@@ -1,48 +1,24 @@
-import type { FieldNode } from '../core/nodes/field-node';
-import type { ArrayNode } from '../core/nodes/array-node';
-import type { FormValue, ValidationError, FormFields } from '../core/types';
+import { FieldNode } from '../core/nodes/field-node';
+import { ArrayNode } from '../core/nodes/array-node';
+import { FormValue, FormFields } from '../core/types';
+import { FieldControlState, ArrayControlState } from './types';
 /**
- * @internal
- */
-interface FieldControlState<T> {
-    value: T;
-    pending: boolean;
-    disabled: boolean;
-    errors: ValidationError[];
-    valid: boolean;
-    invalid: boolean;
-    touched: boolean;
-    shouldShowError: boolean;
-    componentProps: Record<string, any>;
-}
-/**
- * @internal
- */
-interface ArrayControlState<T> {
-    value: T[];
-    length: number;
-    pending: boolean;
-    errors: ValidationError[];
-    valid: boolean;
-    invalid: boolean;
-    touched: boolean;
-    dirty: boolean;
-}
-/**
- * Хук для получения только значения поля без подписки на errors, valid и т.д.
- * Используйте когда нужно только значение для условного рендеринга.
+ * React-хук для подписки на состояние {@link ArrayNode}.
+ *
+ * @typeParam T - Тип элемента массива
+ * @param control - ArrayNode или undefined
+ * @returns Состояние массива {@link ArrayControlState}
  *
- * @group React Hooks
- */
-export declare function useFormControlValue<T extends FormValue>(control: FieldNode<T>): T;
-/**
- * Хук для работы с ArrayNode - возвращает состояние массива с подписками на сигналы
  * @group React Hooks
  */
 export declare function useFormControl<T extends FormFields>(control: ArrayNode<T> | undefined): ArrayControlState<T>;
 /**
- * Хук для работы с FieldNode - возвращает состояние поля с подписками на сигналы
+ * React-хук для подписки на состояние {@link FieldNode}.
+ *
+ * @typeParam T - Тип значения поля
+ * @param control - FieldNode для подписки
+ * @returns Состояние поля {@link FieldControlState}
+ *
  * @group React Hooks
  */
 export declare function useFormControl<T extends FormValue>(control: FieldNode<T>): FieldControlState<T>;
-export {};