easy-forms-core 1.1.8 → 1.1.10

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Tipos de campos soportados
  */
-type FieldType = 'text' | 'email' | 'number' | 'password' | 'textarea' | 'select' | 'checkbox' | 'radio' | 'switch' | 'date' | 'file' | 'array' | 'group' | 'row' | 'custom' | 'quantity' | 'accordion-select' | 'image-grid-select' | 'otp';
+type FieldType = 'text' | 'email' | 'number' | 'password' | 'textarea' | 'select' | 'checkbox' | 'radio' | 'switch' | 'date' | 'file' | 'array' | 'group' | 'row' | 'custom' | 'quantity' | 'accordion-select' | 'image-grid-select' | 'otp' | 'file-drop' | 'map' | 'rating' | 'slider';
 /**
  * Tipos de validaciones soportadas
  */
@@ -101,10 +101,14 @@ interface MaskConfig {
 /**
  * Campo base
  */
+/** Posición del label: up (arriba), down (debajo), left (izquierda), right (derecha), none (oculto) */
+type LabelPosition = 'up' | 'down' | 'left' | 'right' | 'none';
 interface BaseField {
     type: FieldType;
     name: string;
     label?: string;
+    /** Posición del label (override del atributo label-position del componente) */
+    labelPosition?: LabelPosition;
     placeholder?: string;
     defaultValue?: any;
     validations?: Validation[];
@@ -125,7 +129,17 @@ interface BaseField {
  * Campo de texto
  */
 interface TextField extends BaseField {
-    type: 'text' | 'email' | 'password';
+    type: 'text' | 'email';
+}
+/**
+ * Campo password (con opciones de visibilidad y modo carácter separado)
+ */
+interface PasswordField extends BaseField {
+    type: 'password';
+    /** Mostrar botón para alternar visibilidad del texto */
+    showToggle?: boolean;
+    /** Modo carácter separado: true = longitud por defecto 6, number = cantidad de cajas */
+    characterSeparated?: boolean | number;
 }
 /**
  * Campo numérico
@@ -195,6 +209,45 @@ interface FileField extends BaseField {
     accept?: string;
     multiple?: boolean;
 }
+/**
+ * Campo file-drop (arrastrar y soltar archivos)
+ */
+interface FileDropField extends BaseField {
+    type: 'file-drop';
+    accept?: string;
+    multiple?: boolean;
+    maxSize?: number;
+}
+/**
+ * Campo map (lat/lng)
+ */
+interface MapField extends BaseField {
+    type: 'map';
+    center?: {
+        lat: number;
+        lng: number;
+    };
+    zoom?: number;
+}
+/**
+ * Campo rating
+ */
+interface RatingField extends BaseField {
+    type: 'rating';
+    max?: number;
+    icon?: 'star' | 'heart' | 'thumb';
+    half?: boolean;
+}
+/**
+ * Campo slider
+ */
+interface SliderField extends BaseField {
+    type: 'slider';
+    min: number;
+    max: number;
+    step?: number;
+    showValue?: boolean;
+}
 /**
  * Campo array
  */
@@ -210,6 +263,8 @@ interface ArrayField extends BaseField {
 interface GroupField extends BaseField {
     type: 'group';
     fields: Field[];
+    /** Dirección del layout del grupo (override del formulario) */
+    direction?: 'vertical' | 'horizontal';
 }
 /**
  * Campo row
@@ -277,7 +332,7 @@ interface OTPField extends BaseField {
 /**
  * Unión de todos los tipos de campos
  */
-type Field = TextField | NumberField | TextareaField | SelectField | CheckboxField | RadioField | SwitchField | DateField | FileField | ArrayField | GroupField | RowField | CustomField | QuantityField | AccordionSelectField | ImageGridSelectField | OTPField;
+type Field = TextField | PasswordField | NumberField | TextareaField | SelectField | CheckboxField | RadioField | SwitchField | DateField | FileField | FileDropField | MapField | RatingField | SliderField | ArrayField | GroupField | RowField | CustomField | QuantityField | AccordionSelectField | ImageGridSelectField | OTPField;
 /**
  * Step para formularios wizard
  */
@@ -329,6 +384,12 @@ interface FormSchema {
     initialData?: Record<string, any>;
     /** Configuración del botón de submit (también puede definirse vía atributo submit-button) */
     submitButton?: SubmitButtonConfig;
+    /** Barra de progreso de campos obligatorios completados: true | { position?: 'top'|'bottom' } */
+    completedIndicator?: boolean | {
+        position?: 'top' | 'bottom';
+    };
+    /** Dirección del layout: vertical (default) u horizontal */
+    direction?: 'vertical' | 'horizontal';
 }
 /**
  * Estado del formulario
@@ -542,6 +603,10 @@ declare class EasyForm extends BrowserHTMLElement {
      * Renderiza un campo custom
      */
     private renderCustom;
+    /**
+     * Obtiene el progreso de campos obligatorios completados
+     */
+    private getCompletedRequiredProgress;
     /**
      * Renderiza wizard
      */
@@ -1177,4 +1242,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 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, INJECTION_VALIDATION_MESSAGE, type ImageGridSelectField, type MaskConfig, MaskEngine, type MaxLengthValidation, type MaxValidation, type MinLengthValidation, type MinValidation, type NoInjectionValidation, type NumberField, type OTPField, PREDEFINED_MASKS, type PatternValidation, type PredefinedMask, type QuantityField, type RadioField, type RequiredValidation, type RowField, SchemaParser, type SelectField, 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 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, 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 };