easy-forms-core 1.1.9 → 1.1.10

package/README.md

@@ -27,6 +27,8 @@ npm install easy-forms-core
 pnpm add easy-forms-core
 ```
 
+**Campo map:** EasyForms no incluye Leaflet. Si usas el tipo `map`, instala e importa Leaflet tú mismo: `npm install leaflet`, luego `import 'leaflet'` y `import 'leaflet/dist/leaflet.css'`. Ver [documentación](https://easyforms.dev/docs/tipos-campos#map).
+
 ## Uso Básico
 
 ### HTML Vanilla

package/dist/easy-form.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[];
@@ -205,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
  */
@@ -220,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
@@ -287,7 +332,7 @@ interface OTPField extends BaseField {
 /**
  * Unión de todos los tipos de campos
  */
-type Field = TextField | PasswordField | 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
  */
@@ -339,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';
 }
 /**
  * Componente personalizado para inyección
@@ -503,6 +554,10 @@ declare class EasyForm extends BrowserHTMLElement {
      * Renderiza un campo custom
      */
     private renderCustom;
+    /**
+     * Obtiene el progreso de campos obligatorios completados
+     */
+    private getCompletedRequiredProgress;
     /**
      * Renderiza wizard
      */