easy-forms-core 1.2.14 → 1.3.0

package/dist/index.d.ts

@@ -472,6 +472,8 @@ interface SubmitEventDetail {
     values: Record<string, any>;
     isValid: boolean;
     errors: Record<string, string[]>;
+    /** Tiempo restante en segundos cuando se usa complete-time */
+    timeRemaining?: number;
 }
 /**
  * Evento de change
@@ -496,6 +498,13 @@ interface StepChangeEventDetail {
     previousStep: number;
     totalSteps: number;
 }
+/**
+ * Evento de timeout (cuando expira el tiempo límite)
+ */
+interface TimeoutEventDetail {
+    originalTime: number;
+    expiredAt: Date;
+}
 /**
  * Componente personalizado para inyección
  */
@@ -537,6 +546,10 @@ declare class EasyForm extends BrowserHTMLElement {
     private persistenceDebounceTimer;
     private pendingRestoreValues;
     private isRestoringValues;
+    private completeTimeInterval;
+    private timeRemaining;
+    private timerStarted;
+    private timerExpired;
     static get observedAttributes(): string[];
     constructor();
     /**
@@ -683,9 +696,13 @@ declare class EasyForm extends BrowserHTMLElement {
      */
     private rerenderArrayField;
     /**
-     * Re-renderiza campos dependientes
-     */
+    * Re-renderiza campos dependientes
+    */
     private renderDependentFields;
+    /**
+     * Obtiene todos los campos que tienen dependencias
+     */
+    private getAllFieldsWithDependencies;
     /**
      * Emite evento de cambio de dependencia
      */
@@ -824,6 +841,14 @@ declare class EasyForm extends BrowserHTMLElement {
      * Establece el estado de disabled
      */
     set disabled(value: boolean);
+    /**
+     * Obtiene el tiempo límite en segundos
+     */
+    get completeTime(): number | null;
+    /**
+     * Establece el tiempo límite en segundos
+     */
+    set completeTime(value: number | null);
     /**
      * Configura estilos básicos
      */
@@ -856,6 +881,34 @@ declare class EasyForm extends BrowserHTMLElement {
      * Limpia los datos de persistencia
      */
     private clearPersistence;
+    /**
+     * Resetea el timer de complete-time
+     */
+    private resetTimer;
+    /**
+     * Inicia el timer de complete-time
+     */
+    private startTimer;
+    /**
+     * Actualiza la visualización del timer
+     */
+    private updateTimerDisplay;
+    /**
+     * Maneja cuando el timer expira
+     */
+    private handleTimerExpired;
+    /**
+     * Deshabilita todos los campos del formulario
+     */
+    private disableAllFields;
+    /**
+     * Configura el event listener para iniciar el timer en el primer input
+     */
+    private setupTimerInputListener;
+    /**
+     * Renderiza el display del timer
+     */
+    private renderTimerDisplay;
 }
 
 /**
@@ -890,9 +943,10 @@ declare class StateManager {
      */
     private getArrayItemOnlyFieldNames;
     /**
-     * Encuentra el path completo de un campo dentro de grupos
+     * Extrae todos los campos incluyendo arrays (para mapa de dependencias)
+     * Retorna campos con su información de container
      */
-    private findFieldPath;
+    private extractAllFieldsWithArrays;
     /**
      * Construye el mapa de dependencias para optimizar re-evaluaciones
      */
@@ -937,6 +991,10 @@ declare class StateManager {
      * Invalida el cache de dependencias para campos dependientes
      */
     private invalidateDependencyCache;
+    /**
+     * Agrega el índice de array al path del campo
+     */
+    private addArrayIndexToPath;
     /**
      * Establece un valor sin validar (útil para preservar valores durante re-renderizado)
      */
@@ -1147,7 +1205,7 @@ declare class ConditionEngine {
         required: boolean;
     };
     /**
-     * Obtiene el valor de un campo (soporta nested paths)
+     * Obtiene el valor de un campo (soporta nested paths y claves con puntos)
      */
     private getFieldValue;
     /**
@@ -1356,4 +1414,43 @@ 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 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 StepStyle, 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 };
+interface EasyFormBuilderOptions {
+    fields?: Field[];
+    steps?: Step[];
+    initialData?: Record<string, any>;
+    submitButton?: SubmitButtonConfig;
+    completedIndicator?: boolean | {
+        position?: 'top' | 'bottom';
+    };
+    direction?: 'vertical' | 'horizontal';
+    persistence?: {
+        enabled?: boolean;
+        key: string;
+        autoSave?: boolean;
+        debounce?: number;
+    };
+    stepStyle?: 'default' | 'tabs' | 'buttons' | 'timeline' | 'none';
+    completeTime?: number;
+}
+declare class EasyFormBuilder {
+    private options;
+    constructor();
+    fields(fields: Field[]): EasyFormBuilder;
+    steps(steps: Step[]): EasyFormBuilder;
+    initialData(data: Record<string, any>): EasyFormBuilder;
+    submitButton(config: SubmitButtonConfig): EasyFormBuilder;
+    completedIndicator(enabled?: boolean | {
+        position?: 'top' | 'bottom';
+    }): EasyFormBuilder;
+    direction(direction: 'vertical' | 'horizontal'): EasyFormBuilder;
+    persistence(key: string, options?: {
+        autoSave?: boolean;
+        debounce?: number;
+    }): EasyFormBuilder;
+    stepStyle(style: 'default' | 'tabs' | 'buttons' | 'timeline' | 'none'): EasyFormBuilder;
+    withCompleteTime(seconds: number): EasyFormBuilder;
+    build(): FormSchema;
+}
+declare function createFormSchema(options?: EasyFormBuilderOptions): 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, EasyFormBuilder, 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 StepStyle, type SubmitButtonConfig, type SubmitEventDetail, type SwitchField, type TemplateName, type TextField, type TextareaField, type TimeoutEventDetail, type Validation, ValidationEngine, type ValidationType, type WizardState, attributeValue, containsInjection, createFormSchema, createInput, extendTemplate, generateId, getAvailableTemplates, getColors, getCustomComponent, getNestedValue, getPredefinedMask, getTemplate, getThemeStyles, isSafeFromInjection, isValidEmail, parseAttributeValue, registerComponent, registerComponents, sanitizeId, setNestedValue, templates };