adaptform 2.0.4 → 2.1.0

package/dist/{Form-DOdrOtbT.d.ts → Form-kPYL4f-n.d.ts}

@@ -14,10 +14,11 @@ declare class ArrayField<T = any> {
     protected options: ArrayFieldOptions;
     protected _items: Field<T>[];
     protected _errors: string[];
+    private _hasValidationResult;
     isTouched: boolean;
-    constructor(factory: (value?: T) => Field<T>, options?: ArrayFieldOptions, initial?: T[]);
-    set itemsValue(items: T[]);
-    get itemsValue(): T[];
+    constructor(factory: (value?: T) => Field<T>, options?: ArrayFieldOptions, initial?: (T | null)[]);
+    set itemsValue(items: (T | null)[]);
+    get itemsValue(): (T | null)[];
     get items(): Field<T>[];
     add(value?: T, force_check?: boolean): Field<T>;
     remove(index: number): void;
@@ -37,12 +38,14 @@ declare class ArrayFormField<T extends Form = Form> {
     private options;
     private _forms;
     private _errors;
+    private _hasValidationResult;
     isTouched: boolean;
-    constructor(FormConstructor: new () => T, options?: ArrayFormFieldOptions, initial?: any[]);
-    set forms(forms: any[]);
-    get forms(): Form[];
-    get formsFieldsValue(): any[];
-    add(data?: any, force_check?: boolean): T;
+    constructor(FormConstructor: new () => T, options?: ArrayFormFieldOptions, initial?: unknown[]);
+    set forms(forms: unknown[]);
+    setForms(forms: unknown[], validate?: boolean): void;
+    get forms(): T[];
+    get formsFieldsValue(): FormFieldsValue<T>[];
+    add(data?: unknown, force_check?: boolean): T;
     remove(index: number): void;
     clear(): void;
     reset(): void;
@@ -170,7 +173,7 @@ type FieldTypeConstructor<T, O extends FieldOptions = FieldOptions> = new (optio
 declare class Field<T = any, O extends FieldOptions = FieldOptions> {
     protected _rawValue: any;
     protected _valueClear: T | null;
-    protected filed_type: FieldType<T, O>;
+    protected fieldType: FieldType<T, O>;
     protected defaultValue: T | null;
     protected _errors: string[];
     isValid: boolean | null;
@@ -181,10 +184,12 @@ declare class Field<T = any, O extends FieldOptions = FieldOptions> {
     set options(options: O);
     get rawValue(): T | null;
     set rawValue(input: any);
+    setRawValue(input: any, validate?: boolean): void;
+    private assignRawValue;
     get errors(): string[];
     get error(): string;
     set error(message: string | null);
-    get valueClear(): any;
+    get valueClear(): T | null;
     private isRequired;
     checkValid(form?: Form): boolean;
     checkAndSetValid(form?: Form): boolean;
@@ -192,22 +197,119 @@ declare class Field<T = any, O extends FieldOptions = FieldOptions> {
     reset(): void;
 }
 
+type ErrorFieldMapping = string | ((errorValue: any) => string);
+interface ParsedError {
+    fieldName: string;
+    message: string;
+    sourceKey: string;
+    matchedBy: 'static' | 'dynamic' | 'fallback';
+}
+interface DynamicRule {
+    pattern: RegExp;
+    mapping: ErrorFieldMapping | ((match: RegExpMatchArray, value?: any) => string);
+    priority: number;
+}
+declare class ErrorsSchema {
+    private _staticRules;
+    private _dynamicRules;
+    private _fallbackHandler?;
+    private _valueTransformers;
+    /**
+     * Add a static rule that matches an exact error key.
+     * @param errorKey - Exact error key returned by the server.
+     * @param fieldName - Form field name or a function that resolves it dynamically.
+     */
+    staticKey(errorKey: string, fieldName: string | ((errorValue: any) => string)): this;
+    /**
+     * Add a dynamic rule using a regular expression.
+     * @param pattern - Regular expression used to match an error key.
+     * @param mapping - Field name or function that derives it from the match.
+     * @param options - Additional options, such as rule priority.
+     */
+    dynamicKey(pattern: RegExp, mapping: string | ((match: RegExpMatchArray, value?: any) => string), options?: {
+        priority?: number;
+    }): this;
+    /**
+     * Set a handler for errors that do not match any rule.
+     */
+    fallback(handler: (key: string, value: any) => string | null): this;
+    /**
+     * Add a transformer for error values.
+     * Useful for normalizing messages, such as server responses containing arrays.
+     */
+    transformValue(transformer: (value: any) => any): this;
+    /**
+     * Create a schema from a simple mapping object.
+     */
+    static fromObject(mapping: Record<string, string>): ErrorsSchema;
+    /**
+     * Create a schema for an array of similarly structured forms.
+     */
+    static forArray(itemSchema: ErrorsSchema, arrayFieldName: string, indexExtractor?: (key: string) => number): ErrorsSchema;
+    /**
+     * Parse errors while applying configured value transformers.
+     * Supports nested structures using dot notation.
+     */
+    parseErrors(errors: Record<string, any>, prefix?: string): Record<string, string>;
+    /**
+     * Parse server errors and return detailed metadata.
+     */
+    parseErrorsDetailed(errors: Record<string, any>, prefix?: string): Record<string, ParsedError>;
+    /**
+     * Create a schema for a nested form.
+     */
+    nest(prefix: string): ErrorsSchema;
+    /**
+     * Clone the current schema.
+     */
+    clone(): ErrorsSchema;
+    /**
+     * Merge the current schema with another schema.
+     */
+    merge(other: ErrorsSchema): ErrorsSchema;
+    private isNestedObject;
+    private findMappingDetailed;
+    private findMapping;
+}
+/**
+ * Default base schema.
+ */
+declare const DefaultErrorsSchema: ErrorsSchema;
+
+type FormFieldValue<TField> = TField extends Field<infer TValue, infer _Options> ? TValue | null : TField extends ArrayField<infer TValue> ? (TValue | null)[] : TField extends ArrayFormField<infer TForm> ? TForm extends Form ? FormFieldsValue<TForm>[] : unknown[] : never;
+type FormFieldsValue<TForm extends Form> = {
+    [K in keyof TForm as TForm[K] extends Field<infer _Value, infer _Options> | ArrayField<infer _ArrayValue> | ArrayFormField<infer _NestedForm> ? K : never]: FormFieldValue<TForm[K]>;
+};
 declare abstract class Form {
     private _globalErrors;
+    errorsShema: ErrorsSchema;
     protected get _fields(): Record<string, Field<any> | ArrayField<any> | ArrayFormField<any>>;
     checkValid(form?: this): boolean;
-    get fieldsValue(): Record<string, any>;
-    set fields(data: Record<string, any>);
+    get fieldsValue(): FormFieldsValue<this>;
+    set fields(data: Record<string, unknown>);
+    setFields(data: Record<string, unknown>, validate?: boolean): void;
     get allErrors(): Record<string, string[]>;
+    /**
+     * Recursively collect all errors from an ArrayFormField.
+     */
+    private collectArrayFormErrors;
     get globalErrors(): Record<string, string>;
-    set errors(errors: Record<string, string>);
+    set errors(errors: Record<string, unknown>);
+    private clearErrorsRecursively;
+    /**
+     * Apply an error to the corresponding field.
+     * Supports nested fields using dot notation.
+     */
+    private applyErrorToField;
+    private applyNestedError;
     setGlobalError(key: string, message: string): void;
     clearGlobalErrors(): void;
     reset(): void;
     get isTouched(): boolean;
     get isValid(): boolean;
     toFormData(): FormData;
-    toJSON(): Record<string, any>;
+    toJSON(): Record<string, unknown>;
+    private serializeJsonValue;
 }
 
-export { type ArrayFieldOptions as A, BasePlugin as B, type DecimalOptions as D, Field as F, type MaskPluginOptions as M, type NumberOptions as N, type PluginOptions as P, type StringOptions as S, FieldType as a, type BooleanOptions as b, type DateOptions as c, Form as d, type messagesStringOptions as e, type messagesNumberOptions as f, type messagesBooleanOptions as g, type messagesDateOptions as h, type messagesDecimalOptions as i, type messagesArrayFieldOptions as j, type messagesArrayFormFieldOptions as k, type FieldOptions as l, type messagesOptions as m, type ArrayFormFieldOptions as n, ArrayField as o, ArrayFormField as p, type FieldPlugin as q };
+export { ArrayField as A, BasePlugin as B, type DecimalOptions as D, ErrorsSchema as E, Field as F, type MaskPluginOptions as M, type NumberOptions as N, type PluginOptions as P, type StringOptions as S, FieldType as a, type BooleanOptions as b, type DateOptions as c, type ArrayFieldOptions as d, ArrayFormField as e, type ArrayFormFieldOptions as f, DefaultErrorsSchema as g, type DynamicRule as h, type FieldOptions as i, type FieldPlugin as j, Form as k, type FormFieldValue as l, type FormFieldsValue as m, type ParsedError as n, type messagesArrayFieldOptions as o, type messagesArrayFormFieldOptions as p, type messagesBooleanOptions as q, type messagesDateOptions as r, type messagesDecimalOptions as s, type messagesNumberOptions as t, type messagesOptions as u, type messagesStringOptions as v };