indicator-ui 0.1.48 → 0.1.49

package/dist/types/src/hooks/forms/classes/index.d.ts

@@ -1,13 +1,23 @@
-import { FormErrorsType, FormErrorType, FormPath, FormValidateFunItemType, FormValidateFunListType, FormValidateFunType, FormValue, GetFormValidateFunPathType, GetFormValidateFunValueType } from "../types";
+import { ExtendFormPath, ExtendFormValue, FormErrorsType, FormErrorType, FormPath, FormValidateFunItemType, FormValidateFunListType, FormValidateFunType, FormValue } from "../types";
 export declare class Form<T> {
     private data;
+    private defaultValues;
     constructor(data?: T | undefined);
     getFormData(): T | undefined;
     setFormData(data: T | undefined): void;
     get formData(): T | undefined;
     set formData(data: T | undefined);
-    setField<const P extends FormPath<T>>(chain: P, value: FormValue<T, P> | undefined): void;
-    getField<const P extends FormPath<T>>(chain: P): FormValue<T, P> | undefined;
+    hasDefaultValue<const P extends FormPath<T>>(path: P): boolean;
+    getDefaultValue<const P extends FormPath<T>>(path: P): {
+        default: ExtendFormValue<T | undefined, P>;
+    } | undefined;
+    setDefaultValue<const P extends ExtendFormPath<T>>(path: P, value: ExtendFormValue<T, P>): void;
+    deleteDefaultValue<const P extends ExtendFormPath<T>>(path: P): void;
+    clearDefaultValues(): void;
+    applyDefaultValue<const P extends ExtendFormPath<T>>(path: P): void;
+    applyDefaultValues(): void;
+    setField<const P extends FormPath<T>>(path: P, value: FormValue<T, P> | undefined): void;
+    getField<const P extends FormPath<T>>(path: P): FormValue<T, P> | undefined;
     clear(): void;
 }
 export declare class FormError<T> {
@@ -32,12 +42,12 @@ export declare class FormValidateFun<T> {
     private getValueForValidate;
     getFormValidateFunctions(): FormValidateFunType<T>;
     setFormValidateFunctions(newValue: FormValidateFunType<T>): void;
-    getValidateFunctions<const P extends GetFormValidateFunPathType<T>>(path: P): FormValidateFunListType<GetFormValidateFunValueType<T, P>>;
-    setValidateFunctions<const P extends GetFormValidateFunPathType<T>>(path: P, func: FormValidateFunListType<GetFormValidateFunValueType<T, P>>): void;
-    deleteValidateFunctions<const P extends GetFormValidateFunPathType<T>>(chain: P): void;
-    addValidateFunctions<const P extends GetFormValidateFunPathType<T>>(chain: P, fun: FormValidateFunItemType<GetFormValidateFunValueType<T, P>>): void;
-    validate<const P extends GetFormValidateFunPathType<T>>(path: P): Promise<ValidateResArrayType<T>>;
-    isValid<const P extends GetFormValidateFunPathType<T>>(path: P): Promise<boolean>;
+    getValidateFunctions<const P extends ExtendFormPath<T>>(path: P): FormValidateFunListType<ExtendFormValue<T, P>>;
+    setValidateFunctions<const P extends ExtendFormPath<T>>(path: P, func: FormValidateFunListType<ExtendFormValue<T, P>>): void;
+    deleteValidateFunctions<const P extends ExtendFormPath<T>>(chain: P): void;
+    addValidateFunctions<const P extends ExtendFormPath<T>>(chain: P, fun: FormValidateFunItemType<ExtendFormValue<T, P>>): void;
+    validate<const P extends ExtendFormPath<T>>(path: P): Promise<ValidateResArrayType<T>>;
+    isValid<const P extends ExtendFormPath<T>>(path: P): Promise<boolean>;
     validateAllFields(): Promise<ValidateResArrayType<T>>;
     isFormValid(): Promise<boolean>;
 }

package/dist/types/src/hooks/forms/lib/scheme.d.ts

@@ -1,13 +1,16 @@
-import { FieldConfigType, FormPath, FormSchemeType, GetFormValidateFunPathType, GetProcessArrayFieldValue } from '../types';
+import { ExtendFormPath, ExtendFormValue, FieldConfigType, FormDefaultValues, FormPath, FormSchemeType, GetProcessArrayFieldValue } from '../types';
 import { Form, FormValidateFun } from '../classes';
 type PropsOptionsType<T> = {
     form: Form<T>;
     formValidateFun: FormValidateFun<T>;
 };
 /** Полностью заменяет валидаторы поля */
-export declare function processValidators<T, F>(path: FormPath<T>, config: FieldConfigType<T, F>, options: PropsOptionsType<T>): void;
+export declare function processValidators<T, F>(path: FormPath<T>, _config: FieldConfigType<T, F>, options: PropsOptionsType<T>): void;
 /** Полностью заменяет валидаторы полей */
 export declare function processScheme<T>(scheme: FormSchemeType<T>, options: PropsOptionsType<T>): void;
-export declare function getRealPathByArrayItemPath<T, P extends GetFormValidateFunPathType<T>>(path: P): GetProcessArrayFieldValue<T, P> | undefined;
-export declare function getArrayItemPathByRealPath<T, P extends GetFormValidateFunPathType<T>>(path: P): GetProcessArrayFieldValue<T, P> | undefined;
+export declare function getArrayExtendBasePath<T, P extends ExtendFormPath<T>>(path: P): GetProcessArrayFieldValue<T, P> | undefined;
+export declare function getArrayExtendPath<T, P extends ExtendFormPath<T>>(path: P): GetProcessArrayFieldValue<T, P> | undefined;
+export declare function getExtendPath<T, P extends FormPath<T>>(path: P): ExtendFormPath<T>;
+export declare function getSortedExtendsPaths<T>(defaultValues: FormDefaultValues<T>): ExtendFormPath<T>[];
+export declare function setExtendValue<T, P extends ExtendFormPath<T>>(formData: T, path: P, value: ExtendFormValue<T, P>): T | undefined;
 export {};

package/dist/types/src/hooks/forms/lib/utils.d.ts

@@ -1,4 +1,4 @@
-export declare function copyData(data: unknown): unknown;
+export declare function copyData<T>(data: T): T;
 export declare function getBasePath(path: string): string | null;
 export declare function getBaseRest(path: string): string | null;
 export declare function getArrayIndex(path: string): number | null;

package/dist/types/src/hooks/forms/types/formTypes.d.ts

@@ -37,15 +37,18 @@ export type FormErrorsType<T> = Array<{
 }[FormPath<T>]>;
 type GetOnlyArrayField<P> = P extends string ? Extract<P, `${string}]`> : never;
 export type ProcessArrayFields<P> = GetOnlyArrayField<P> extends infer T extends string ? T extends `${infer B}[${number}]` ? `${B}[*]` : never : never;
+export type ExtendFormPath<T> = FormPath<T> | ProcessArrayFields<FormPath<T>>;
 export type GetProcessArrayFieldValue<T, P> = P extends `${infer Rest}[*]` ? Rest extends FormPath<T> ? FormValue<T, Rest> extends infer Arr extends any[] ? Arr[number] : never : never : never;
-export type GetFormValidateFunPathType<T> = FormPath<T> | ProcessArrayFields<FormPath<T>>;
-export type GetFormValidateFunValueType<T, P> = GetProcessArrayFieldValue<T, P> | (P extends FormPath<T> ? FormValue<T, P> : never);
+export type ExtendFormValue<T, P> = GetProcessArrayFieldValue<T, P> | (P extends FormPath<T> ? FormValue<T, P> : never);
 export type FormValidateFunItemType<T> = (value: T | undefined) => Promise<FormErrorType> | FormErrorType;
 export type FormValidateFunListType<T> = Array<FormValidateFunItemType<T>>;
 export type FormValidateFunType<T> = Array<{
-    [K in GetFormValidateFunPathType<T>]: {
+    [K in ExtendFormPath<T>]: {
         path: K;
-        fun: FormValidateFunListType<GetFormValidateFunValueType<T, K>>;
+        fun: FormValidateFunListType<ExtendFormValue<T, K>>;
     };
-}[GetFormValidateFunPathType<T>]>;
+}[ExtendFormPath<T>]>;
+export type FormDefaultValues<T> = {
+    [P in ExtendFormPath<T>]?: ExtendFormValue<T, P>;
+};
 export {};

package/dist/types/src/hooks/forms/types/scheme.d.ts

@@ -1,4 +1,4 @@
-import { FormErrorType, FormPath, FormValidateFunItemType, GetFormValidateFunPathType, GetFormValidateFunValueType } from './formTypes';
+import { FormErrorType, FormPath, FormValidateFunItemType, ExtendFormPath, ExtendFormValue } from './formTypes';
 export type StringFieldValidators = Partial<{
     /** Минимальная длина строки */
     minStr: number;
@@ -70,6 +70,10 @@ export type BaseFieldValidators<T, F> = Partial<{
         priory?: number;
     };
 }>;
+export type DefaultValueConfig<T, F> = Partial<{
+    /** Значение по-умолчанию */
+    default: F;
+}>;
 export type ExtendsValidatorOptions<T> = {
     /** Значение валидотора */
     setting: T;
@@ -87,7 +91,7 @@ type ProcessValidator<T> = T extends Record<string, unknown> ? {
     [K in keyof T]: T[K] | ValidatorOption<T[K]>;
 } : never;
 type GetValidatorValue<V> = V extends ExtendsValidatorOptions<infer T> ? T : never;
-export type FieldConfigType<T, F> = BaseFieldValidators<T, F> & ProcessValidator<ArrayFieldValidators> & ProcessValidator<FileFieldValidators> & ProcessValidator<StringFieldValidators> & ProcessValidator<DateTimeFieldValidators> & ProcessValidator<NumberFieldValidators>;
+export type FieldConfigType<T, F> = DefaultValueConfig<T, F> & BaseFieldValidators<T, F> & ProcessValidator<ArrayFieldValidators> & ProcessValidator<FileFieldValidators> & ProcessValidator<StringFieldValidators> & ProcessValidator<DateTimeFieldValidators> & ProcessValidator<NumberFieldValidators>;
 /**
  * Тип схемы валидации формы.
  *
@@ -136,7 +140,7 @@ export type FieldConfigType<T, F> = BaseFieldValidators<T, F> & ProcessValidator
  * @template T — тип данных формы (например, интерфейс или тип объекта формы).
  */
 export type FormSchemeType<T> = Partial<T> extends infer Form ? {
-    [K in GetFormValidateFunPathType<Form>]?: FieldConfigType<Form, GetFormValidateFunValueType<Form, K>>;
+    [K in ExtendFormPath<Form>]?: FieldConfigType<Form, ExtendFormValue<Form, K>>;
 } : never;
 export type FieldPropsType<V> = {
     value?: V;

package/dist/types/src/hooks/forms/useForm.d.ts

@@ -1,9 +1,13 @@
-import { FieldPropsType, FormErrorsType, FormErrorType, GetFormValidateFunPathType } from "../../hooks";
+import React from "react";
+import { ExtendFormPath, FieldPropsType, FormErrorsType, FormErrorType } from "../../hooks";
 import { FormPath, FormSchemeType, FormValue } from "./types";
-type PropsType<T> = [{
-    initFormData?: T;
-    scheme?: FormSchemeType<T>;
-}];
+type PropsType<T, Form> = [
+    {
+        initFormData?: T;
+        scheme?: FormSchemeType<T>;
+        onSubmit?: (data: Form) => void | Promise<void>;
+    }
+];
 /**
  * Хук `useForm` — универсальное решение для управления и валидации форм с полной статической типизацией.
  *
@@ -71,10 +75,13 @@ type PropsType<T> = [{
  * };
  *
  * export function FormPage() {
- *   const { register, formData, errors, isFormValid } = useForm<TestFormType>({ scheme });
+ *   const { register, registerForm, formData, errors, isFormValid } = useForm<TestFormType>({
+ *     scheme,
+ *     onSubmit: (data) => console.log('Submit data:', data),
+ *   });
  *
  *   return (
- *     <div>
+ *     <form {...registerForm()}>
  *       <FormField
  *         {...register('baseInput', { required: { setting: true, message: 'Обязательное поле' } })}
  *         label="base input"
@@ -105,8 +112,9 @@ type PropsType<T> = [{
  *         hint="Select с выбором нескольких элементов"
  *       />
  *
- *       <button disabled={!isFormValid()}>Отправить</button>
- *     </div>
+ *       <button type="submit">Отправить</button>
+ *       <button type="reset">Сбросить</button>
+ *     </form>
  *   );
  * }
  * ```
@@ -132,6 +140,34 @@ type PropsType<T> = [{
  * | `clearForm()` | `() => void` | Сбрасывает все значения формы |
  * | `clearErrors()` | `() => void` | Очищает все ошибки |
  * | `register(path, config?)` | `(path, config?) => FieldPropsType` | Регистрирует поле и возвращает пропсы для компонента |
+ * | `registerForm()` | `() => Pick<React.ComponentProps<'form'>, 'onSubmit' | 'onReset' | 'noValidate'>` | Возвращает обработчики и настройки для `<form>` |
+ *
+ * ---
+ * ### 🧠 `registerForm`
+ *
+ * Функция `registerForm` позволяет удобно подключить форму к системе валидации и управления состоянием,
+ * не теряя контроль над поведением `onSubmit` и `onReset`.
+ *
+ * #### Пример:
+ * ```tsx
+ * const { register, registerForm } = useForm<MyFormType>({
+ *   onSubmit: (data) => console.log('Отправлено:', data),
+ * });
+ *
+ * return (
+ *   <form {...registerForm()}>
+ *     <FormField {...register('username')} label="Имя" />
+ *     <FormField {...register('email')} label="Email" />
+ *     <button type="submit">Отправить</button>
+ *     <button type="reset">Сбросить</button>
+ *   </form>
+ * );
+ * ```
+ *
+ * #### Поведение:
+ * - `onSubmit`: выполняет валидацию всей формы (`isFormValid()`), при успехе вызывает переданный `onSubmit`;
+ * - `onReset`: предотвращает нативный сброс, очищает значения (`clearForm()`) и ошибки (`clearErrors()`);
+ * - `noValidate: true`: отключает нативную HTML5-валидацию, чтобы не мешала кастомной логике.
  *
  * ---
  * @template Form — объект, описывающий форму.
@@ -140,58 +176,11 @@ type PropsType<T> = [{
  * @param {Object} [params]
  * @param {T} [params.initFormData] — начальные данные формы.
  * @param {FormSchemeType<T>} [params.scheme] — схема валидации формы.
+ * @param {(data: Form) => void | Promise<void>} [params.onSubmit] — колбэк, вызываемый при успешной отправке формы.
  *
- * @returns {{
- *   /** Текущее состояние формы (реактивное) *\/
- *   formData: T;
- *
- *   /** Установка полного состояния формы *\/
- *   setFormData: (data: T) => void;
- *
- *   /** Получение текущего состояния формы *\/
- *   getFormData: () => T;
- *
- *   /** Все ошибки формы *\/
- *   errors: FormErrorsType<T>;
- *
- *   /** Замена всех ошибок формы *\/
- *   setErrors: (errors: FormErrorsType<T>) => void;
- *
- *   /** Получение значения поля *\/
- *   getField: <P extends FormPath<T>>(path: P) => FormValue<T, P>;
- *
- *   /** Установка значения поля *\/
- *   setField: <P extends FormPath<T>>(path: P, value: FormValue<T, P> | undefined) => void;
- *
- *   /** Получение ошибки конкретного поля *\/
- *   getError: <P extends FormPath<T>>(path: P) => FormErrorType;
- *
- *   /** Установка ошибки поля вручную *\/
- *   setError: <P extends FormPath<T>>(path: P, error: FormErrorType) => void;
- *
- *   /** Проверка конкретного поля с обновлением `errors` *\/
- *   highlightField: <P extends GetFormValidateFunPathType<T>>(path: P) => Promise<void>;
- *
- *   /** Проверка всех полей формы с обновлением `errors` *\/
- *   highlightFormErrors: () => Promise<void>;
- *
- *   /** Проверка валидности конкретного поля (без обновления `errors`) *\/
- *   isFieldValid: <P extends GetFormValidateFunPathType<T>>(path: P) => boolean;
- *
- *   /** Проверка валидности всей формы (без обновления `errors`) *\/
- *   isFormValid: () => boolean;
- *
- *   /** Сброс всех значений формы *\/
- *   clearForm: () => void;
- *
- *   /** Очистка всех ошибок *\/
- *   clearErrors: () => void;
- *
- *   /** Регистрация поля с привязкой валидации и значений *\/
- *   register: <P extends FormPath<T>>(path: P, config?: FormSchemeType<T>[P]) => FieldPropsType<FormValue<T, P>>;
- * }}
+ * @returns {object} Объект с методами и состоянием формы (см. таблицу выше).
  */
-export declare function useForm<Form, T extends Partial<Form> = Partial<Form>>(...args: PropsType<T>): {
+export declare function useForm<Form, T extends Partial<Form> = Partial<Form>>(...args: PropsType<T, Form>): {
     formData: T | undefined;
     setFormData: (formData: T) => void;
     getFormData: () => T | undefined;
@@ -201,12 +190,13 @@ export declare function useForm<Form, T extends Partial<Form> = Partial<Form>>(.
     setField: <P extends FormPath<T>>(path: P, value: FormValue<T, P> | undefined) => void;
     getError: <P extends FormPath<T>>(path: P) => FormErrorType | undefined;
     setError: <P extends FormPath<T>>(path: P, error: FormErrorType) => void;
-    highlightField: <P extends GetFormValidateFunPathType<T>>(path: P) => Promise<void>;
+    highlightField: <P extends ExtendFormPath<T>>(path: P) => Promise<void>;
     highlightFormErrors: () => Promise<void>;
-    isFieldValid: <P extends GetFormValidateFunPathType<T>>(path: P) => Promise<boolean>;
+    isFieldValid: <P extends ExtendFormPath<T>>(path: P) => Promise<boolean>;
     isFormValid: () => Promise<boolean>;
     clearForm: () => void;
     clearErrors: () => void;
     register: <P extends FormPath<T>>(path: P, config?: FormSchemeType<T>[P]) => FieldPropsType<FormValue<T, P>>;
+    registerForm: () => Pick<React.ComponentProps<"form">, "onSubmit" | "onReset" | "noValidate">;
 };
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "indicator-ui",
-  "version": "0.1.48",
+  "version": "0.1.49",
   "main": "dist/index.js",
   "types": "dist/types/src/index.d.ts",
   "style": "dist/index.css",