easy-forms-core 1.2.13 → 1.2.15

package/dist/index.d.ts

@@ -358,6 +358,10 @@ interface OTPField extends BaseField {
  * Unión de todos los tipos de campos
  */
 type Field = TextField | PasswordField | NumberField | TextareaField | SelectField | CheckboxField | RadioField | SwitchField | DateField | FileField | FileDropField | MapField | RatingField | SliderField | ColorpickerField | ArrayField | GroupField | RowField | CustomField | QuantityField | AccordionSelectField | ImageGridSelectField | OTPField;
+/**
+ * Estilos visuales del stepper
+ */
+type StepStyle = 'default' | 'tabs' | 'buttons' | 'timeline' | 'none';
 /**
  * Step para formularios wizard
  */
@@ -365,6 +369,8 @@ interface Step {
     title: string;
     description?: string;
     fields: Field[];
+    /** Estilo visual del stepper para este step */
+    stepStyle?: StepStyle;
 }
 /**
  * Tipos de temas disponibles
@@ -423,6 +429,8 @@ interface FormSchema {
     direction?: 'vertical' | 'horizontal';
     /** Configuración de persistencia/autosave del formulario */
     persistence?: PersistenceConfig;
+    /** Estilo visual del stepper (aplica a todos los steps): 'default' | 'tabs' | 'buttons' | 'timeline' | 'none' */
+    stepStyle?: StepStyle;
 }
 /**
  * Configuración de persistencia del formulario
@@ -464,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
@@ -488,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
  */
@@ -529,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();
     /**
@@ -816,6 +837,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
      */
@@ -848,6 +877,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;
 }
 
 /**
@@ -1348,4 +1405,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 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 };