easy-forms-core 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -6,6 +6,10 @@ type FieldType = 'text' | 'email' | 'number' | 'password' | 'textarea' | 'select
  * Tipos de validaciones soportadas
  */
 type ValidationType = 'required' | 'email' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'custom';
+/**
+ * Operadores de condición
+ */
+type ConditionOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'in' | 'notIn' | 'isEmpty' | 'isNotEmpty' | 'regex';
 /**
  * Validación base
  */
@@ -50,6 +54,47 @@ interface CustomValidation extends BaseValidation {
  * Unión de todas las validaciones
  */
 type Validation = RequiredValidation | EmailValidation | MinLengthValidation | MaxLengthValidation | MinValidation | MaxValidation | PatternValidation | CustomValidation;
+/**
+ * Condición individual para campos
+ */
+interface FieldCondition {
+    field: string;
+    operator: ConditionOperator;
+    value: any;
+}
+/**
+ * Dependencias de un campo
+ */
+interface FieldDependencies {
+    show?: FieldCondition | FieldCondition[];
+    hide?: FieldCondition | FieldCondition[];
+    enable?: FieldCondition | FieldCondition[];
+    disable?: FieldCondition | FieldCondition[];
+    required?: FieldCondition | FieldCondition[];
+    optional?: FieldCondition | FieldCondition[];
+}
+/**
+ * Tipos de máscaras predefinidas
+ */
+type PredefinedMask = 'phone' | 'phone-us' | 'phone-international' | 'date' | 'date-us' | 'date-eu' | 'credit-card' | 'ssn' | 'zip-code' | 'currency' | 'percentage' | 'time' | 'datetime';
+/**
+ * Máscara personalizada con patrón
+ */
+interface CustomMask {
+    pattern: string;
+    placeholder?: string;
+    transform?: (value: string) => string;
+}
+/**
+ * Configuración de máscara
+ */
+interface MaskConfig {
+    type?: PredefinedMask;
+    custom?: CustomMask;
+    keepFormat?: boolean;
+    showMaskOnFocus?: boolean;
+    showMaskOnHover?: boolean;
+}
 /**
  * Campo base
  */
@@ -64,6 +109,12 @@ interface BaseField {
     disabled?: boolean;
     hidden?: boolean;
     description?: string;
+    dependencies?: FieldDependencies;
+    conditionalValidations?: Array<{
+        condition: FieldCondition | FieldCondition[];
+        validations: Validation[];
+    }>;
+    mask?: MaskConfig;
 }
 /**
  * Campo de texto
@@ -334,6 +385,15 @@ declare class EasyForm extends BrowserHTMLElement {
      * Maneja el cambio de un campo
      */
     private handleFieldChange;
+    private dependencyRenderTimeout;
+    /**
+     * Re-renderiza campos dependientes
+     */
+    private renderDependentFields;
+    /**
+     * Emite evento de cambio de dependencia
+     */
+    private emitDependencyChange;
     /**
      * Maneja el blur de un campo
      */
@@ -393,6 +453,9 @@ declare class StateManager {
     private schema;
     private parser;
     private validator;
+    private conditionEngine;
+    private dependencyCache;
+    private fieldDependencies;
     constructor();
     /**
      * Crea el estado inicial
@@ -402,6 +465,14 @@ declare class StateManager {
      * Inicializa el schema
      */
     initializeSchema(schema: FormSchema): void;
+    /**
+     * Construye el mapa de dependencias para optimizar re-evaluaciones
+     */
+    private buildDependencyMap;
+    /**
+     * Extrae los nombres de campos observados de las dependencias
+     */
+    private extractObservedFields;
     /**
      * Inicializa los valores por defecto
      */
@@ -430,6 +501,10 @@ declare class StateManager {
      * Establece un valor
      */
     setValue(fieldName: string, value: any): Promise<void>;
+    /**
+     * Invalida el cache de dependencias para campos dependientes
+     */
+    private invalidateDependencyCache;
     /**
      * Establece un valor sin validar (útil para preservar valores durante re-renderizado)
      */
@@ -438,6 +513,10 @@ declare class StateManager {
      * Valida un campo específico
      */
     validateField(fieldName: string): Promise<void>;
+    /**
+     * Obtiene las validaciones activas para un campo (incluyendo condicionales)
+     */
+    private getActiveValidations;
     /**
      * Valida todo el formulario
      */
@@ -486,6 +565,22 @@ declare class StateManager {
      * Obtiene los campos del step actual
      */
     getCurrentStepFields(): Field[];
+    /**
+     * Obtiene la visibilidad de un campo basándose en dependencias
+     */
+    getFieldVisibility(fieldName: string): boolean;
+    /**
+     * Obtiene si un campo está habilitado basándose en dependencias
+     */
+    getFieldEnabled(fieldName: string): boolean;
+    /**
+     * Obtiene si un campo es requerido basándose en dependencias
+     */
+    getFieldRequired(fieldName: string): boolean;
+    /**
+     * Obtiene los campos que dependen de un campo específico
+     */
+    getDependentFields(fieldName: string): string[];
 }
 
 /**
@@ -496,6 +591,10 @@ declare class ValidationEngine {
      * Valida un campo con todas sus validaciones
      */
     validateField(field: Field, value: any): Promise<string[]>;
+    /**
+     * Valida un campo con validaciones específicas
+     */
+    validateFieldWithValidations(_field: Field, value: any, validations: Validation[]): Promise<string[]>;
     /**
      * Valida un valor con una validación específica
      */
@@ -576,6 +675,89 @@ interface ParsedSchema {
     isWizard: boolean;
 }
 
+/**
+ * Motor de evaluación de condiciones
+ */
+declare class ConditionEngine {
+    /**
+     * Evalúa una condición individual
+     */
+    evaluateCondition(condition: FieldCondition, formValues: Record<string, any>): boolean;
+    /**
+     * Evalúa múltiples condiciones (AND por defecto, soportar OR)
+     */
+    evaluateConditions(conditions: FieldCondition | FieldCondition[], formValues: Record<string, any>, logic?: 'and' | 'or'): boolean;
+    /**
+     * Evalúa dependencias de un campo
+     */
+    evaluateDependencies(dependencies: FieldDependencies, formValues: Record<string, any>): {
+        visible: boolean;
+        enabled: boolean;
+        required: boolean;
+    };
+    /**
+     * Obtiene el valor de un campo (soporta nested paths)
+     */
+    private getFieldValue;
+    /**
+     * Compara valores según el operador
+     */
+    private compareValues;
+    /**
+     * Comparación profunda de valores
+     */
+    private deepEqual;
+    /**
+     * Convierte un valor a número
+     */
+    private toNumber;
+}
+
+/**
+ * Motor de máscaras
+ */
+declare class MaskEngine {
+    private tokenCache;
+    /**
+     * Obtiene la configuración de máscara personalizada
+     */
+    private getCustomMask;
+    /**
+     * Obtiene los tokens parseados de una máscara (con cache)
+     */
+    private getTokens;
+    /**
+     * Aplica máscara a un valor
+     */
+    applyMask(value: string, mask: MaskConfig): string;
+    /**
+     * Remueve máscara de un valor (obtiene valor raw)
+     */
+    removeMask(value: string, mask: MaskConfig): string;
+    /**
+     * Obtiene el placeholder para una máscara
+     */
+    getMaskPlaceholder(mask: MaskConfig): string;
+    /**
+     * Valida si un carácter puede ser insertado en una posición
+     */
+    canInsertChar(char: string, position: number, mask: MaskConfig): boolean;
+    /**
+     * Procesa entrada del usuario aplicando máscara en tiempo real
+     */
+    processInput(input: string, previousValue: string, mask: MaskConfig, cursorPosition: number): {
+        value: string;
+        cursorPosition: number;
+    };
+    /**
+     * Procesa entrada con manejo de backspace/delete
+     */
+    processKeyInput(key: string, currentValue: string, cursorPosition: number, mask: MaskConfig, isBackspace?: boolean): {
+        value: string;
+        cursorPosition: number;
+    };
+}
+
 /**
  * Obtiene los colores con valores por defecto
  */
@@ -585,6 +767,15 @@ declare function getColors(colors?: FormColors): Required<FormColors>;
  */
 declare function getThemeStyles(theme: FormTheme, colors: Required<FormColors>): string;
 
+/**
+ * Máscaras predefinidas
+ */
+declare const PREDEFINED_MASKS: Record<PredefinedMask, CustomMask>;
+/**
+ * Obtiene una máscara predefinida
+ */
+declare function getPredefinedMask(type: PredefinedMask): CustomMask;
+
 /**
  * Utilidades generales
  */
@@ -634,4 +825,4 @@ declare function registerComponents(components: Record<string, CustomComponent>)
  */
 declare function getCustomComponent(type: string): CustomComponent | undefined;
 
-export { type ArrayField, type BaseField, type BaseValidation, type ChangeEventDetail, type CheckboxField, type ComponentRegistry, type CustomComponent, type CustomField, type CustomValidation, type DateField, EasyForm, type EmailValidation, type ErrorEventDetail, type Field, type FieldType, type FileField, type FormColors, type FormSchema, type FormState, type FormTheme, type GroupField, type MaxLengthValidation, type MaxValidation, type MinLengthValidation, type MinValidation, type NumberField, type PatternValidation, type RadioField, type RequiredValidation, SchemaParser, type SelectField, StateManager, type Step, type StepChangeEventDetail, type SubmitEventDetail, type SwitchField, type TextField, type TextareaField, type Validation, ValidationEngine, type ValidationType, type WizardState, attributeValue, createInput, generateId, getColors, getCustomComponent, getNestedValue, getThemeStyles, isValidEmail, parseAttributeValue, registerComponent, registerComponents, sanitizeId, setNestedValue };
+export { type ArrayField, type BaseField, type BaseValidation, type ChangeEventDetail, type CheckboxField, 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 FileField, type FormColors, type FormSchema, type FormState, type FormTheme, type GroupField, type MaskConfig, MaskEngine, type MaxLengthValidation, type MaxValidation, type MinLengthValidation, type MinValidation, type NumberField, PREDEFINED_MASKS, type PatternValidation, type PredefinedMask, type RadioField, type RequiredValidation, SchemaParser, type SelectField, StateManager, type Step, type StepChangeEventDetail, type SubmitEventDetail, type SwitchField, type TextField, type TextareaField, type Validation, ValidationEngine, type ValidationType, type WizardState, attributeValue, createInput, generateId, getColors, getCustomComponent, getNestedValue, getPredefinedMask, getThemeStyles, isValidEmail, parseAttributeValue, registerComponent, registerComponents, sanitizeId, setNestedValue };