easy-forms-core 1.1.3 → 1.1.6

package/dist/easy-form.d.ts

@@ -5,7 +5,7 @@ type FieldType = 'text' | 'email' | 'number' | 'password' | 'textarea' | 'select
 /**
  * Tipos de validaciones soportadas
  */
-type ValidationType = 'required' | 'email' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'custom';
+type ValidationType = 'required' | 'email' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'custom' | 'noInjection';
 /**
  * Operadores de condición
  */
@@ -50,10 +50,13 @@ interface CustomValidation extends BaseValidation {
     type: 'custom';
     validator: (value: any) => boolean | Promise<boolean>;
 }
+interface NoInjectionValidation extends BaseValidation {
+    type: 'noInjection';
+}
 /**
  * Unión de todas las validaciones
  */
-type Validation = RequiredValidation | EmailValidation | MinLengthValidation | MaxLengthValidation | MinValidation | MaxValidation | PatternValidation | CustomValidation;
+type Validation = RequiredValidation | EmailValidation | MinLengthValidation | MaxLengthValidation | MinValidation | MaxValidation | PatternValidation | CustomValidation | NoInjectionValidation;
 /**
  * Condición individual para campos
  */
@@ -109,6 +112,8 @@ interface BaseField {
     disabled?: boolean;
     hidden?: boolean;
     description?: string;
+    /** Si true, no se aplica validación anti-inyección automática */
+    skipInjectionValidation?: boolean;
     dependencies?: FieldDependencies;
     conditionalValidations?: Array<{
         condition: FieldCondition | FieldCondition[];
@@ -302,6 +307,19 @@ interface FormColors {
  * Template names available
  */
 type TemplateName = 'login' | 'register' | 'otp' | 'contact' | 'password-reset' | 'password-change' | 'profile' | 'checkout' | 'feedback' | 'subscription' | 'booking' | 'review';
+/**
+ * Configuración del botón de submit
+ */
+interface SubmitButtonConfig {
+    /** Si false, no se muestra el botón (submit programático) */
+    visible?: boolean;
+    /** Texto del botón (default: "Enviar") */
+    text?: string;
+    /** Ancho del botón: "auto", "100%", "200px", etc. (default: "auto") */
+    width?: string;
+    /** Alineación: "left" | "center" | "right" (default: "left") */
+    align?: 'left' | 'center' | 'right';
+}
 /**
  * Schema del formulario
  */
@@ -309,6 +327,8 @@ interface FormSchema {
     fields?: Field[];
     steps?: Step[];
     initialData?: Record<string, any>;
+    /** Configuración del botón de submit (también puede definirse vía atributo submit-button) */
+    submitButton?: SubmitButtonConfig;
 }
 /**
  * Componente personalizado para inyección
@@ -339,6 +359,8 @@ declare class EasyForm extends BrowserHTMLElement {
     protected shadow: ShadowRoot;
     private customComponents;
     private isRendering;
+    private attemptsLock;
+    private lockCountdownInterval;
     static get observedAttributes(): string[];
     constructor();
     /**
@@ -365,6 +387,30 @@ declare class EasyForm extends BrowserHTMLElement {
      * Establece los campos adicionales para extender el template
      */
     set templateExtend(value: Field[] | null);
+    /**
+     * Máximo de intentos antes de bloquear (para AttemptsLock)
+     */
+    get maxAttempts(): number | null;
+    set maxAttempts(value: number | null);
+    /**
+     * Duración del bloqueo en minutos (default: 5)
+     */
+    get blockDurationMinutes(): number | null;
+    set blockDurationMinutes(value: number | null);
+    /**
+     * Clave para persistir intentos en sessionStorage
+     */
+    get attemptsStorageKey(): string | null;
+    set attemptsStorageKey(value: string | null);
+    /**
+     * Configuración del botón de submit (desde atributo o schema)
+     */
+    get submitButton(): SubmitButtonConfig | null;
+    set submitButton(value: SubmitButtonConfig | null);
+    /**
+     * Obtiene la configuración efectiva del botón submit (atributo > schema > defaults)
+     */
+    private getSubmitButtonConfig;
     /**
      * Se llama cuando el componente se conecta al DOM
      */
@@ -373,6 +419,10 @@ declare class EasyForm extends BrowserHTMLElement {
      * Se llama cuando un atributo cambia
      */
     attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    /**
+     * Configura el AttemptsLock según los atributos actuales
+     */
+    private setupAttemptsLock;
     /**
      * Maneja el cambio de schema
      */
@@ -385,6 +435,11 @@ declare class EasyForm extends BrowserHTMLElement {
      * Renderiza el formulario
      */
     private render;
+    /**
+     * Actualiza el overlay de bloqueo por intentos
+     */
+    private updateLockOverlay;
+    private stopLockCountdown;
     /**
      * Actualiza el overlay de loading sobre el formulario
      */
@@ -467,6 +522,28 @@ declare class EasyForm extends BrowserHTMLElement {
      * Resetea el formulario a sus valores iniciales
      */
     reset(): void;
+    /**
+     * Incrementa el contador de intentos (para bloqueo por intentos fallidos).
+     * El consumidor debe llamar esto cuando la API/login falle.
+     */
+    incrementAttempts(): void;
+    /**
+     * Resetea el contador de intentos y desbloquea el formulario.
+     */
+    resetAttempts(): void;
+    /**
+     * Retorna true si el formulario está bloqueado por intentos.
+     */
+    isLocked(): boolean;
+    /**
+     * Retorna los milisegundos restantes del bloqueo, o 0 si no está bloqueado.
+     */
+    getRemainingBlockTimeMs(): number;
+    /**
+     * Dispara el submit del formulario programáticamente.
+     * Útil cuando el botón submit está oculto (visible: false).
+     */
+    requestSubmit(): void;
     /**
      * Limpia todos los valores del formulario
      */