easy-forms-core 1.2.11 → 1.2.13

package/dist/index.d.ts

@@ -421,6 +421,23 @@ interface FormSchema {
     };
     /** Dirección del layout: vertical (default) u horizontal */
     direction?: 'vertical' | 'horizontal';
+    /** Configuración de persistencia/autosave del formulario */
+    persistence?: PersistenceConfig;
+}
+/**
+ * Configuración de persistencia del formulario
+ */
+interface PersistenceConfig {
+    /** Habilitar persistencia */
+    enabled?: boolean;
+    /** Clave para localStorage */
+    key: string;
+    /** Intervalo de autosave en ms (default: 1000) */
+    autoSave?: boolean;
+    /** Debounce para guardar en ms (default: 500) */
+    debounce?: number;
+    /** Callback cuando se restauran datos */
+    onRestore?: (values: Record<string, any>) => void;
 }
 /**
  * Estado del formulario
@@ -508,6 +525,10 @@ declare class EasyForm extends BrowserHTMLElement {
      */
     private slotTemplates;
     private skipPreserveValuesOnNextRender;
+    private persistenceConfig;
+    private persistenceDebounceTimer;
+    private pendingRestoreValues;
+    private isRestoringValues;
     static get observedAttributes(): string[];
     constructor();
     /**
@@ -799,6 +820,34 @@ declare class EasyForm extends BrowserHTMLElement {
      * Configura estilos básicos
      */
     private setupStyles;
+    /**
+     * Inicializa la persistencia del formulario
+     */
+    private initPersistence;
+    /**
+     * Restaura los valores desde localStorage
+     */
+    private restoreFromStorage;
+    /**
+     * Aplica los valores pendientes de restauración después del render
+     */
+    private applyPendingRestoreValues;
+    /**
+     * Actualiza los valores de los inputs del DOM
+     */
+    private updateInputsWithValues;
+    /**
+     * Guarda los valores en localStorage
+     */
+    private saveToStorage;
+    /**
+     * Programa un guardado debounced
+     */
+    private scheduleSave;
+    /**
+     * Limpia los datos de persistencia
+     */
+    private clearPersistence;
 }
 
 /**
@@ -962,6 +1011,8 @@ declare class StateManager {
  * Motor de validaciones
  */
 declare class ValidationEngine {
+    private conditionEngine;
+    constructor();
     /**
      * Valida un campo con todas sus validaciones
      */
@@ -1019,14 +1070,14 @@ declare class ValidationEngine {
       * Un campo no debe validarse si está oculto por una condición
       */
     private shouldValidateField;
-    /**
-     * Evalúa una condición simple
-     */
-    private evaluateCondition;
     /**
      * Valida todos los campos de un formulario
      */
     validateForm(fields: Field[], values: Record<string, any>): Promise<Record<string, string[]>>;
+    /**
+     * Valida un campo array a nivel de array (minItems, maxItems)
+     */
+    private validateArrayField;
 }
 
 /**
@@ -1150,13 +1201,8 @@ declare class MaskEngine {
     };
 }
 
-/**
- * Obtiene los colores con valores por defecto
- */
 declare function getColors(colors?: FormColors): Required<FormColors>;
-/**
- * Genera estilos CSS para un tema específico
- */
+
 declare function getThemeStyles(theme: FormTheme, colors: Required<FormColors>): string;
 
 /**
@@ -1302,4 +1348,4 @@ declare function getAvailableTemplates(): TemplateName[];
  */
 declare function extendTemplate(templateName: string, additionalFields: Field[]): FormSchema;
 
-export { type AccordionSelectField, type ArrayField, AttemptsLock, type AttemptsLockOptions, type BaseField, type BaseValidation, type ChangeEventDetail, type CheckboxField, type ColorpickerField, type ComponentRegistry, ConditionEngine, type ConditionOperator, type CustomComponent, type CustomField, type CustomMask, type CustomValidation, type DateField, EasyForm, type EmailValidation, type ErrorEventDetail, type Field, type FieldCondition, type FieldDependencies, type FieldType, type FileDropField, type FileField, type FormColors, type FormSchema, type FormState, type FormTheme, type GroupField, INJECTION_VALIDATION_MESSAGE, type ImageGridSelectField, type LabelPosition, type MapField, type MaskConfig, MaskEngine, type MaxLengthValidation, type MaxValidation, type MinLengthValidation, type MinValidation, type NoInjectionValidation, type NumberField, type OTPField, PREDEFINED_MASKS, type PasswordField, type PatternValidation, type PredefinedMask, type QuantityField, type RadioField, type RatingField, type RequiredValidation, type RowField, SchemaParser, type SelectField, type SliderField, type SlotContent, StateManager, type Step, type StepChangeEventDetail, type SubmitButtonConfig, type SubmitEventDetail, type SwitchField, type TemplateName, type TextField, type TextareaField, type Validation, ValidationEngine, type ValidationType, type WizardState, attributeValue, containsInjection, createInput, extendTemplate, generateId, getAvailableTemplates, getColors, getCustomComponent, getNestedValue, getPredefinedMask, getTemplate, getThemeStyles, isSafeFromInjection, isValidEmail, parseAttributeValue, registerComponent, registerComponents, sanitizeId, setNestedValue, templates };
+export { type AccordionSelectField, type ArrayField, AttemptsLock, type AttemptsLockOptions, type BaseField, type BaseValidation, type ChangeEventDetail, type CheckboxField, type ColorpickerField, type ComponentRegistry, ConditionEngine, type ConditionOperator, type CustomComponent, type CustomField, type CustomMask, type CustomValidation, type DateField, EasyForm, type EmailValidation, type ErrorEventDetail, type Field, type FieldCondition, type FieldDependencies, type FieldType, type FileDropField, type FileField, type FormColors, type FormSchema, type FormState, type FormTheme, type GroupField, INJECTION_VALIDATION_MESSAGE, type ImageGridSelectField, type LabelPosition, type MapField, type MaskConfig, MaskEngine, type MaxLengthValidation, type MaxValidation, type MinLengthValidation, type MinValidation, type NoInjectionValidation, type NumberField, type OTPField, PREDEFINED_MASKS, type PasswordField, type PatternValidation, type PersistenceConfig, type PredefinedMask, type QuantityField, type RadioField, type RatingField, type RequiredValidation, type RowField, SchemaParser, type SelectField, type SliderField, type SlotContent, StateManager, type Step, type StepChangeEventDetail, type SubmitButtonConfig, type SubmitEventDetail, type SwitchField, type TemplateName, type TextField, type TextareaField, type Validation, ValidationEngine, type ValidationType, type WizardState, attributeValue, containsInjection, createInput, extendTemplate, generateId, getAvailableTemplates, getColors, getCustomComponent, getNestedValue, getPredefinedMask, getTemplate, getThemeStyles, isSafeFromInjection, isValidEmail, parseAttributeValue, registerComponent, registerComponents, sanitizeId, setNestedValue, templates };