@arquimedes.co/eureka-forms 3.0.52-test → 3.0.53-new-steps

package/dist/@Types/ConsentFormStep.d.ts

@@ -0,0 +1,36 @@
+/**
+ * DRAFT — ConsentFormStep types
+ *
+ * Paso de consentimiento / términos y condiciones.
+ * El usuario debe aceptar explícitamente para continuar.
+ * El contenido puede ser texto enriquecido (EurekaDraft) o un link externo.
+ */
+import { GBaseStep } from './GenericFormSteps';
+import { EurekaDraft } from './Draft/Draft';
+export interface ConsentStep extends GBaseStep {
+    type: 'CONSENT';
+    /**
+     * Texto del checkbox que el usuario marca.
+     * Ej: "Acepto los términos y condiciones de uso"
+     */
+    label: string;
+    required: boolean;
+    /**
+     * Contenido completo del documento de T&C / política.
+     * Se muestra en un modal o área expandible al hacer clic en el link.
+     * Si no se define, solo se muestra label + linkUrl.
+     */
+    content?: EurekaDraft;
+    /**
+     * URL externa opcional. Si se define, el link abre esta URL en lugar
+     * de mostrar el content inline.
+     * Solo uno de content o linkUrl debería estar activo a la vez.
+     */
+    linkUrl?: string;
+    /**
+     * Si true, el checkbox no se puede desmarcar una vez aceptado
+     * (útil en flujos donde el consentimiento es permanente en esa sesión).
+     */
+    irreversible?: boolean;
+}
+export type ConsentValue = boolean;

package/dist/@Types/ConsentFormStep.js

@@ -0,0 +1,8 @@
+/**
+ * DRAFT — ConsentFormStep types
+ *
+ * Paso de consentimiento / términos y condiciones.
+ * El usuario debe aceptar explícitamente para continuar.
+ * El contenido puede ser texto enriquecido (EurekaDraft) o un link externo.
+ */
+export {};

package/dist/@Types/EntityFormFormStep.d.ts

@@ -0,0 +1,66 @@
+/**
+ * DRAFT — EntityFormFormStep types
+ *
+ * Paso que permite al usuario buscar y/o crear un registro de entidad
+ * directamente dentro del formulario, sin salir de él.
+ *
+ * Modos:
+ *   SEARCH           → solo busca entidades existentes
+ *   CREATE           → solo crea una entidad nueva (muestra sub-campos)
+ *   SEARCH_OR_CREATE → busca primero; si no encuentra, puede crear
+ */
+import { GBaseStep } from './GenericFormSteps';
+import { ErkIconTypes } from '../constants/ErkIconTypes';
+export declare enum EntityFormMode {
+    SEARCH = "SEARCH",
+    CREATE = "CREATE",
+    SEARCH_OR_CREATE = "SEARCH_OR_CREATE"
+}
+export interface EntityFormStep extends GBaseStep {
+    type: 'ENTITY_FORM';
+    label: string;
+    description: string | null;
+    required: boolean;
+    /** Id de la entidad de Capta que se va a buscar/crear */
+    idEntity: string;
+    mode: EntityFormMode;
+    /** Icono representativo de la entidad en la UI */
+    icon: ErkIconTypes;
+    /**
+     * Si true (solo para SEARCH y SEARCH_OR_CREATE), se muestra un campo de
+     * búsqueda con filtrado por texto.
+     */
+    searchable?: boolean;
+    /**
+     * Ids de los FormSteps que definen los campos del sub-formulario de creación.
+     * Solo aplica cuando mode === CREATE o SEARCH_OR_CREATE.
+     * Estos steps son "embebidos" — se renderizan inline dentro de este paso.
+     */
+    entityFieldSteps?: string[];
+    /**
+     * Si true, el usuario puede seleccionar más de un registro.
+     * El valor pasa de ser un objeto a un array.
+     */
+    allowMultiple?: boolean;
+    maxSize?: number;
+    size: 1 | 2 | 3 | 4;
+}
+/** Entidad existente seleccionada en modo SEARCH */
+export interface ExistingEntityRef {
+    /** Id del registro de entidad en Capta */
+    idEntityValue: string;
+    /** Etiqueta display del registro (para mostrar en UI sin refetch) */
+    label?: string;
+}
+/** Entidad nueva creada en modo CREATE */
+export interface NewEntityDraft {
+    /** Indica que este valor corresponde a un registro por crear */
+    isDraft: true;
+    /** Campos del sub-formulario indexados por stepId */
+    fields: Record<string, unknown>;
+}
+/**
+ * Si allowMultiple === false → ExistingEntityRef | NewEntityDraft
+ * Si allowMultiple === true  → (ExistingEntityRef | NewEntityDraft)[]
+ */
+export type EntityFormStepValue = ExistingEntityRef | NewEntityDraft | (ExistingEntityRef | NewEntityDraft)[];

package/dist/@Types/EntityFormFormStep.js

@@ -0,0 +1,20 @@
+/**
+ * DRAFT — EntityFormFormStep types
+ *
+ * Paso que permite al usuario buscar y/o crear un registro de entidad
+ * directamente dentro del formulario, sin salir de él.
+ *
+ * Modos:
+ *   SEARCH           → solo busca entidades existentes
+ *   CREATE           → solo crea una entidad nueva (muestra sub-campos)
+ *   SEARCH_OR_CREATE → busca primero; si no encuentra, puede crear
+ */
+// ===========================================================================
+// Enum de modos
+// ===========================================================================
+export var EntityFormMode;
+(function (EntityFormMode) {
+    EntityFormMode["SEARCH"] = "SEARCH";
+    EntityFormMode["CREATE"] = "CREATE";
+    EntityFormMode["SEARCH_OR_CREATE"] = "SEARCH_OR_CREATE";
+})(EntityFormMode || (EntityFormMode = {}));

package/dist/@Types/EventFormStep.d.ts

@@ -0,0 +1,52 @@
+/**
+ * DRAFT — EventFormStep types
+ *
+ * Paso para capturar un evento de calendario.
+ * La semántica exacta está pendiente de revisión — este draft cubre la
+ * configuración más probable basada en la discusión inicial.
+ *
+ * TODO: Definir si "evento" corresponde a:
+ *   (a) Un evento de calendario puro (integrar con Google Calendar / Outlook)
+ *   (b) Un registro de tipo "evento" en la entidad de Capta
+ *   (c) Ambos con integración opcional
+ */
+import { GBaseStep } from './GenericFormSteps';
+export interface EventStep extends GBaseStep {
+    type: 'EVENT';
+    label: string;
+    description: string | null;
+    required: boolean;
+    /** Si true, el usuario puede especificar una fecha/hora de inicio */
+    includeStartDate: boolean;
+    /** Si true, el usuario puede especificar una fecha/hora de fin */
+    includeEndDate: boolean;
+    /** Si true, se permite marcar el evento como "todo el día" */
+    includeAllDay?: boolean;
+    /** Si true, el usuario puede agregar una ubicación al evento */
+    includeLocation: boolean;
+    /** Si true, el usuario puede escribir una descripción del evento */
+    includeDescription: boolean;
+    /** Si true, el usuario puede agregar asistentes (lista de contactos/emails) */
+    includeAttendees: boolean;
+    /**
+     * Si true, se ofrece la opción de sincronizar con calendario externo.
+     * Pendiente: definir qué calendarios se soportan.
+     */
+    includeCalendarSync?: boolean;
+    size: 1 | 2 | 3 | 4;
+}
+export interface EventStepValue {
+    /** ISO 8601 — fecha y hora de inicio */
+    startDate?: string;
+    /** ISO 8601 — fecha y hora de fin */
+    endDate?: string;
+    /** Si el evento es de día completo (sin hora específica) */
+    allDay?: boolean;
+    title?: string;
+    description?: string;
+    location?: string;
+    /** Lista de emails o ids de contactos */
+    attendees?: string[];
+    /** Si el usuario eligió sincronizar con su calendario externo */
+    calendarSync?: boolean;
+}

package/dist/@Types/EventFormStep.js

@@ -0,0 +1,13 @@
+/**
+ * DRAFT — EventFormStep types
+ *
+ * Paso para capturar un evento de calendario.
+ * La semántica exacta está pendiente de revisión — este draft cubre la
+ * configuración más probable basada en la discusión inicial.
+ *
+ * TODO: Definir si "evento" corresponde a:
+ *   (a) Un evento de calendario puro (integrar con Google Calendar / Outlook)
+ *   (b) Un registro de tipo "evento" en la entidad de Capta
+ *   (c) Ambos con integración opcional
+ */
+export {};

package/dist/@Types/ExternalReferenceFormStep.d.ts

@@ -0,0 +1,74 @@
+/**
+ * DRAFT — ExternalReferenceFormStep types
+ *
+ * Paso para capturar una referencia a un registro externo, ya sea:
+ *   - CBR (Customer Base Record) — entidades del modelo de datos de Capta
+ *   - INTEGRATION — registros de sistemas externos vía integración
+ *
+ * El usuario busca/selecciona un registro externo y el step guarda su referencia.
+ * Opcionalmente, puede incluir validación asistida por IA para normalizar el valor.
+ */
+import { GBaseStep } from './GenericFormSteps';
+export declare enum ExternalRefTargetType {
+    /** Customer Base Record — entidad interna de Capta */
+    CBR = "CBR",
+    /** Sistema externo integrado (ERP, CRM, etc.) */
+    INTEGRATION = "INTEGRATION"
+}
+/** Configuración de un tipo de entidad CBR que se puede referenciar */
+export interface CBRRefTarget {
+    /** Id del tipo de entidad en Capta (ej: "CLIENT", "SUPPLIER", "PROJECT") */
+    entityType: string;
+    /** Etiqueta legible para mostrar en la UI */
+    label: string;
+    /** Icono opcional para diferenciar tipos en el selector */
+    icon?: string;
+}
+export interface ExternalReferenceStep extends GBaseStep {
+    type: 'EXTERNAL_REFERENCE';
+    label: string;
+    description: string | null;
+    required: boolean;
+    targetType: ExternalRefTargetType;
+    /**
+     * Tipos de entidad CBR que el usuario puede referenciar.
+     * Si tiene un solo elemento, no se muestra el selector de tipo.
+     */
+    cbrTargets?: CBRRefTarget[];
+    /** Id de la integración configurada en Capta */
+    integrationId?: string;
+    /** Endpoint o recurso específico dentro de la integración */
+    integrationResource?: string;
+    /**
+     * Si true, se usa IA para validar / normalizar el valor ingresado.
+     * Ej: corregir nombre de empresa, resolver ambigüedades, sugerir coincidencias.
+     */
+    aiValidation: boolean;
+    /**
+     * Ids de otros steps cuyo valor se usa como contexto para la búsqueda.
+     * Ej: usar el valor de un step de "país" para filtrar resultados.
+     */
+    compositeStepIds?: string[];
+    /**
+     * Si true, el usuario puede seleccionar múltiples referencias.
+     */
+    allowMultiple?: boolean;
+    maxSize?: number;
+    size: 1 | 2 | 3 | 4;
+}
+export interface ExternalReferenceValue {
+    /** Identificador de la referencia en el sistema origen */
+    ref: string;
+    /** Etiqueta display del registro referenciado (para UI sin refetch) */
+    label?: string;
+    /**
+     * Datos del registro resuelto, si el backend los retorna.
+     * Estructura variable dependiendo del sistema origen.
+     */
+    resolved?: Record<string, unknown>;
+}
+/**
+ * Si allowMultiple === false → ExternalReferenceValue
+ * Si allowMultiple === true  → ExternalReferenceValue[]
+ */
+export type ExternalReferenceStepValue = ExternalReferenceValue | ExternalReferenceValue[];

package/dist/@Types/ExternalReferenceFormStep.js

@@ -0,0 +1,20 @@
+/**
+ * DRAFT — ExternalReferenceFormStep types
+ *
+ * Paso para capturar una referencia a un registro externo, ya sea:
+ *   - CBR (Customer Base Record) — entidades del modelo de datos de Capta
+ *   - INTEGRATION — registros de sistemas externos vía integración
+ *
+ * El usuario busca/selecciona un registro externo y el step guarda su referencia.
+ * Opcionalmente, puede incluir validación asistida por IA para normalizar el valor.
+ */
+// ===========================================================================
+// Enums
+// ===========================================================================
+export var ExternalRefTargetType;
+(function (ExternalRefTargetType) {
+    /** Customer Base Record — entidad interna de Capta */
+    ExternalRefTargetType["CBR"] = "CBR";
+    /** Sistema externo integrado (ERP, CRM, etc.) */
+    ExternalRefTargetType["INTEGRATION"] = "INTEGRATION";
+})(ExternalRefTargetType || (ExternalRefTargetType = {}));

package/dist/@Types/FormStep.d.ts

@@ -5,7 +5,13 @@ import { EurekaDraft } from './Draft/Draft';
 import { ErkValue } from './ErkValue';
 import * as GSteps from './GenericFormSteps';
 import { Time } from './Time';
-export type FormStep = Title | TimePicker | Rating | CheckBox | TextArea | TextInput | DatePicker | FileUpload | Separator | FormSelector | ClassifierSelector | Collapsible | EntityValuePicker | ApiSelector | Mapper | DatePickerRange;
+import { LocationStep } from './LocationFormStep';
+import { NumberStep, NumberStepType } from './NumericFormSteps';
+import { BookingStep } from './BookingFormStep';
+import { CalendarStep } from './CalendarFormStep';
+export type { LocationStep, NumberStep, BookingStep, CalendarStep };
+export { NumberStepType };
+export type FormStep = Title | TimePicker | Rating | CheckBox | TextArea | TextInput | DatePicker | FileUpload | Separator | FormSelector | ClassifierSelector | Collapsible | EntityValuePicker | ApiSelector | Mapper | DatePickerRange | LocationStep | NumberStep | BookingStep | CalendarStep;
 export interface Title extends GSteps.GBaseStep {
     type: FormStepTypes.TITLE;
     title?: EurekaDraft;
@@ -232,4 +238,3 @@ export interface Mapper extends GSteps.GBaseStep {
     deletable?: boolean;
     max?: number;
 }
-export {};

package/dist/@Types/FormStep.js

@@ -1 +1,2 @@
-export {};
+import { NumberStepType } from './NumericFormSteps';
+export { NumberStepType };

package/dist/@Types/LocationFormStep.d.ts

@@ -0,0 +1,159 @@
+/**
+ * DRAFT — LocationStep types
+ * Pendiente de revisión antes de integrar al FormStep union principal.
+ */
+import { GBaseStep } from './GenericFormSteps';
+export { type DynamicRef } from './StepRef';
+import FormStepTypes from '../constants/FormStepTypes';
+/** Modos de entrada que el paso puede ofrecer al usuario */
+export declare enum LocationInputMode {
+    /** Autocomplete de Google Places — retorna placeId, coordenadas y addressDetail */
+    GOOGLE_PLACES = "GOOGLE_PLACES",
+    /** Geolocalización del navegador (GPS) — retorna solo lat/lng */
+    GPS = "GPS",
+    /** Entrada manual de campos de dirección — sin coordenadas garantizadas */
+    MANUAL = "MANUAL"
+}
+/** Tipo de restricción geográfica */
+export declare enum LocationRestrictionType {
+    /** Zona circular definida por un centro y un radio en metros */
+    RADIUS = "RADIUS",
+    /** Polígono arbitrario (geofence) */
+    GEOFENCE = "GEOFENCE"
+}
+/** Comportamiento de la restricción */
+export declare enum LocationRestrictionBehavior {
+    /** Solo se permite una ubicación dentro de esta zona */
+    ALLOW = "ALLOW",
+    /** Se rechaza una ubicación dentro de esta zona */
+    DENY = "DENY"
+}
+/** Cómo se comporta cada campo de la dirección en el formulario */
+export declare enum AddressFieldMode {
+    /** Se le pide al usuario final */
+    ASK = "ASK",
+    /** El diseñador fija el valor; el usuario no lo cambia */
+    FIXED = "FIXED",
+    /** No se pide ni se muestra */
+    OMIT = "OMIT"
+}
+export interface AddressFieldConfig {
+    mode: AddressFieldMode;
+    /** Valor usado solo cuando `mode === FIXED` */
+    fixedValue?: string;
+}
+/** Campos configurables — coinciden con las claves de LocationAddressDetail (countryCode se deriva de country) */
+export type AddressFieldKey = 'street' | 'streetNumber' | 'unit' | 'neighborhood' | 'city' | 'state' | 'postalCode' | 'country';
+/**
+ * Coordenadas fijas usadas como centro de una restricción de radio.
+ * Cuando el centro viene de otro step se usa StepRef con allowedStepTypes: ['LOCATION'].
+ */
+export interface LocationCoords {
+    latitude: number;
+    longitude: number;
+}
+/**
+ * Centro del radio: coordenadas fijas o referencia a otro LocationStep.
+ * El segundo parámetro de DynamicRef restringe las referencias a steps de tipo 'LOCATION'.
+ *
+ * @example
+ *   // fijo
+ *   center: { type: 'FIXED', value: { latitude: 6.2, longitude: -75.5 } }
+ *
+ *   // dinámico — TypeScript solo acepta allowedStepTypes: ['LOCATION']
+ *   center: { type: 'STEP_REF', idStep: 'step_origen', allowedStepTypes: ['LOCATION'] }
+ */
+/** Restricción circular */
+export interface RadiusRestriction {
+    type: LocationRestrictionType.RADIUS;
+    behavior: LocationRestrictionBehavior;
+    center: LocationCoords;
+    /** Radio en metros */
+    radiusMeters: number;
+    /** Mensaje de error personalizado cuando la validación falla */
+    errorMessage?: string;
+}
+/** Vértice de un polígono */
+export interface GeofenceVertex {
+    latitude: number;
+    longitude: number;
+}
+/** Restricción por polígono — mínimo 3 vértices, se cierra automáticamente */
+export interface GeofenceRestriction {
+    type: LocationRestrictionType.GEOFENCE;
+    behavior: LocationRestrictionBehavior;
+    /** Lista ordenada de vértices que forman el polígono */
+    polygon: [GeofenceVertex, GeofenceVertex, GeofenceVertex, ...GeofenceVertex[]];
+    /** Mensaje de error personalizado cuando la validación falla */
+    errorMessage?: string;
+}
+/** Una restricción geográfica — pueden combinarse varias (todas deben cumplirse) */
+export type LocationRestriction = RadiusRestriction | GeofenceRestriction;
+export interface LocationStep extends GBaseStep {
+    type: FormStepTypes.LOCATION;
+    label: string;
+    description: string | null;
+    required: boolean;
+    /**
+     * Modos de entrada habilitados. Al menos uno debe estar presente.
+     * Si solo hay uno, la UI no muestra selector de modo.
+     */
+    allowedModes: [LocationInputMode, ...LocationInputMode[]];
+    /**
+     * Modo que se preselecciona al abrir el paso.
+     * Debe estar incluido en allowedModes.
+     * Si no se especifica, se usa el primero de allowedModes.
+     */
+    defaultMode?: LocationInputMode;
+    /**
+     * Restricciones geográficas. Se evalúan todas (lógica AND).
+     * Una ubicación es válida solo si pasa cada restricción.
+     */
+    restrictions?: LocationRestriction[];
+    /**
+     * Config por campo de la dirección: pedir / fijar / omitir.
+     * Aplica al modo MANUAL (qué campos se muestran) y como override tras autocompletar
+     * con GOOGLE_PLACES (los FIXED se sobreescriben, los OMIT se descartan del value).
+     */
+    addressFields?: Partial<Record<AddressFieldKey, AddressFieldConfig>>;
+    size: 1 | 2 | 3 | 4;
+    defaultValue?: LocationStepValue | null;
+}
+/** Desglose estructurado de la dirección (mismo shape que AddressModel) */
+export interface LocationAddressDetail {
+    street?: string;
+    streetNumber?: string;
+    unit?: string;
+    neighborhood?: string;
+    city?: string;
+    state?: string;
+    country?: string;
+    /** ISO 3166-1 alpha-2 (e.g., "CO", "US", "MX") */
+    countryCode?: string;
+    postalCode?: string;
+}
+export interface LocationStepValue {
+    /** Indica cómo fue capturada la ubicación */
+    source: LocationInputMode;
+    /**
+     * Latitud — presente si source es GOOGLE_PLACES o GPS.
+     * Ausente en MANUAL si el usuario no activó coordenadas.
+     */
+    latitude?: number;
+    /**
+     * Longitud — presente si source es GOOGLE_PLACES o GPS.
+     * Ausente en MANUAL si el usuario no activó coordenadas.
+     */
+    longitude?: number;
+    /** Nombre del lugar o negocio (ej: "Torre Bancolombia") */
+    name?: string;
+    /** Dirección completa formateada (viene de Google o construida manualmente) */
+    address?: string;
+    /**
+     * Google Place ID — presente solo si source === GOOGLE_PLACES.
+     * Permite re-fetch de detalles y construcción de links a Maps.
+     */
+    placeId?: string;
+    /** Desglose campo a campo de la dirección */
+    addressDetail?: LocationAddressDetail;
+}

package/dist/@Types/LocationFormStep.js

@@ -0,0 +1,46 @@
+/**
+ * DRAFT — LocationStep types
+ * Pendiente de revisión antes de integrar al FormStep union principal.
+ */
+// ---------------------------------------------------------------------------
+// Enums
+// ---------------------------------------------------------------------------
+/** Modos de entrada que el paso puede ofrecer al usuario */
+export var LocationInputMode;
+(function (LocationInputMode) {
+    /** Autocomplete de Google Places — retorna placeId, coordenadas y addressDetail */
+    LocationInputMode["GOOGLE_PLACES"] = "GOOGLE_PLACES";
+    /** Geolocalización del navegador (GPS) — retorna solo lat/lng */
+    LocationInputMode["GPS"] = "GPS";
+    /** Entrada manual de campos de dirección — sin coordenadas garantizadas */
+    LocationInputMode["MANUAL"] = "MANUAL";
+})(LocationInputMode || (LocationInputMode = {}));
+/** Tipo de restricción geográfica */
+export var LocationRestrictionType;
+(function (LocationRestrictionType) {
+    /** Zona circular definida por un centro y un radio en metros */
+    LocationRestrictionType["RADIUS"] = "RADIUS";
+    /** Polígono arbitrario (geofence) */
+    LocationRestrictionType["GEOFENCE"] = "GEOFENCE";
+})(LocationRestrictionType || (LocationRestrictionType = {}));
+/** Comportamiento de la restricción */
+export var LocationRestrictionBehavior;
+(function (LocationRestrictionBehavior) {
+    /** Solo se permite una ubicación dentro de esta zona */
+    LocationRestrictionBehavior["ALLOW"] = "ALLOW";
+    /** Se rechaza una ubicación dentro de esta zona */
+    LocationRestrictionBehavior["DENY"] = "DENY";
+})(LocationRestrictionBehavior || (LocationRestrictionBehavior = {}));
+// ---------------------------------------------------------------------------
+// Config por campo de la dirección (fijo / pedir / omitir)
+// ---------------------------------------------------------------------------
+/** Cómo se comporta cada campo de la dirección en el formulario */
+export var AddressFieldMode;
+(function (AddressFieldMode) {
+    /** Se le pide al usuario final */
+    AddressFieldMode["ASK"] = "ASK";
+    /** El diseñador fija el valor; el usuario no lo cambia */
+    AddressFieldMode["FIXED"] = "FIXED";
+    /** No se pide ni se muestra */
+    AddressFieldMode["OMIT"] = "OMIT";
+})(AddressFieldMode || (AddressFieldMode = {}));

package/dist/@Types/NumericFormSteps.d.ts

@@ -0,0 +1,108 @@
+/**
+ * NumericFormSteps types
+ * Cubre el paso relacionado con números y sus múltiples subtipos.
+ */
+import { GBaseStep } from './GenericFormSteps';
+import FormStepTypes from '../constants/FormStepTypes';
+/** Subtipo del paso numérico — discriminante secundario */
+export declare enum NumberStepType {
+    INTEGER = "INTEGER",
+    DECIMAL = "DECIMAL",
+    PERCENTAGE = "PERCENTAGE",
+    /** Monto de dinero en una divisa (ej: 1500 COP). */
+    MONEY = "MONEY",
+    /** Magnitud con unidad de medida (ej: 5 kg). */
+    MEASURE = "MEASURE",
+    /** Precio por unidad: divisa sobre unidad (ej: 20 USD / hora). */
+    UNIT_PRICE = "UNIT_PRICE"
+}
+/** Campos base compartidos por todos los subtipos numéricos */
+interface GNumberStep extends GBaseStep {
+    type: FormStepTypes.NUMBER;
+    numberType: NumberStepType;
+    label: string;
+    description: string | null;
+    required: boolean;
+    min?: number;
+    max?: number;
+    /** Cantidad de decimales permitidos (0 = entero). Default: 2 */
+    decimals?: number;
+    /** Sufijo de unidad estático que se muestra junto al valor (solo visual, no afecta el número guardado). */
+    suffix?: string;
+    /**
+     * Mostrar u ocultar los botones +/− de incremento/decremento.
+     * Default: true
+     */
+    spinner?: boolean;
+    /**
+     * Tamaño de cada incremento/decremento al usar los botones o las flechas del teclado.
+     * Útil para monedas (0.01), cantidades grandes (100) o porcentajes (5).
+     * Default: 1
+     */
+    step?: number;
+    /** Texto de placeholder del campo numérico. */
+    placeholder?: string;
+    size: 1 | 2 | 3 | 4;
+}
+export interface IntegerStep extends GNumberStep {
+    numberType: NumberStepType.INTEGER;
+    /** Siempre 0 para enteros, pero puede dejarse undefined */
+    decimals?: 0;
+    defaultValue?: number;
+}
+export interface DecimalStep extends GNumberStep {
+    numberType: NumberStepType.DECIMAL;
+    defaultValue?: number;
+}
+export interface PercentageStep extends GNumberStep {
+    numberType: NumberStepType.PERCENTAGE;
+    defaultValue?: number;
+}
+export interface MoneyStep extends GNumberStep {
+    numberType: NumberStepType.MONEY;
+    /** Moneda fija (ej: "COP", "USD", "EUR") */
+    currency?: string;
+    allowCurrencyChange?: boolean;
+    availableCurrencies?: string[];
+    defaultValue?: MoneyValue | null;
+}
+export interface MeasureStep extends GNumberStep {
+    numberType: NumberStepType.MEASURE;
+    /** Unidad fija (ej: "kg", "m", "hrs") */
+    unit?: string;
+    allowUnitChange?: boolean;
+    availableUnits?: string[];
+    defaultValue?: MeasureValue | null;
+}
+export interface UnitPriceStep extends GNumberStep {
+    numberType: NumberStepType.UNIT_PRICE;
+    /** Moneda del precio (ej: "USD") */
+    currency?: string;
+    /** Unidad base del precio (ej: "hrs", "km", "mes") */
+    unit?: string;
+    allowCurrencyChange?: boolean;
+    allowUnitChange?: boolean;
+    availableCurrencies?: string[];
+    availableUnits?: string[];
+    defaultValue?: UnitPriceValue | null;
+}
+/** Unión discriminada del paso NUMBER — narrowing por numberType */
+export type NumberStep = IntegerStep | DecimalStep | PercentageStep | MoneyStep | MeasureStep | UnitPriceStep;
+export type IntegerValue = number;
+export type DecimalValue = number;
+export type PercentageValue = number;
+export interface MoneyValue {
+    value: number;
+    currency: string;
+}
+export interface MeasureValue {
+    value: number;
+    unit: string;
+}
+export interface UnitPriceValue {
+    value: number;
+    currency: string;
+    unit: string;
+}
+export type NumberStepValue = number | MoneyValue | MeasureValue | UnitPriceValue;
+export {};

package/dist/@Types/NumericFormSteps.js

@@ -0,0 +1,20 @@
+/**
+ * NumericFormSteps types
+ * Cubre el paso relacionado con números y sus múltiples subtipos.
+ */
+// ===========================================================================
+// NUMBER
+// ===========================================================================
+/** Subtipo del paso numérico — discriminante secundario */
+export var NumberStepType;
+(function (NumberStepType) {
+    NumberStepType["INTEGER"] = "INTEGER";
+    NumberStepType["DECIMAL"] = "DECIMAL";
+    NumberStepType["PERCENTAGE"] = "PERCENTAGE";
+    /** Monto de dinero en una divisa (ej: 1500 COP). */
+    NumberStepType["MONEY"] = "MONEY";
+    /** Magnitud con unidad de medida (ej: 5 kg). */
+    NumberStepType["MEASURE"] = "MEASURE";
+    /** Precio por unidad: divisa sobre unidad (ej: 20 USD / hora). */
+    NumberStepType["UNIT_PRICE"] = "UNIT_PRICE";
+})(NumberStepType || (NumberStepType = {}));