@arquimedes.co/eureka-forms 3.0.46-new-steps → 3.0.48-test

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

@@ -1,171 +0,0 @@
-/**
- * DRAFT — NumericFormSteps types
- * Cubre tres pasos relacionados con números:
- *   - NUMBER  → entrada numérica con subtipos (integer, decimal, currency, percentage, quantity, rate)
- *   - SCORE   → calificación numérica con min/max/precision y bandas opcionales
- *   - FORMULA → campo calculado (solo lectura), derivado de otros steps
- */
-import { GBaseStep } from './GenericFormSteps';
-import { DynamicRef } from './StepRef';
-/** Subtipo del paso numérico — discriminante secundario */
-export declare enum NumberStepType {
-    INTEGER = "INTEGER",
-    DECIMAL = "DECIMAL",
-    CURRENCY = "CURRENCY",
-    PERCENTAGE = "PERCENTAGE",
-    QUANTITY = "QUANTITY",
-    RATE = "RATE"
-}
-/** Campos base compartidos por todos los subtipos numéricos */
-interface GNumberStep extends GBaseStep {
-    type: '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 que se muestra junto al valor (solo visual, no afecta el número guardado).
-     * Puede ser fijo ("km", "km/h", "°C") o venir de otro step.
-     *
-     * Ejemplo con SELECT dinámico:
-     *   suffix: { type: 'STEP_REF', idStep: 'step_unidad', fallback: 'm' }
-     *   → el step 'step_unidad' es un selector con opciones: km | m | cm
-     */
-    suffix?: DynamicRef<string>;
-    size: 1 | 2 | 3 | 4;
-    defaultValue?: number;
-}
-export interface IntegerStep extends GNumberStep {
-    numberType: NumberStepType.INTEGER;
-    /** Siempre 0 para enteros, pero puede dejarse undefined */
-    decimals?: 0;
-}
-export interface DecimalStep extends GNumberStep {
-    numberType: NumberStepType.DECIMAL;
-}
-export interface PercentageStep extends GNumberStep {
-    numberType: NumberStepType.PERCENTAGE;
-}
-export interface CurrencyStep extends GNumberStep {
-    numberType: NumberStepType.CURRENCY;
-    /**
-     * Moneda: fija ("COP", "USD") o tomada de otro step (ej: un SELECT de monedas).
-     * null = el usuario elige la moneda en el mismo campo.
-     */
-    currency: DynamicRef<string> | null;
-    allowCurrencyChange: boolean;
-}
-export interface QuantityStep extends GNumberStep {
-    numberType: NumberStepType.QUANTITY;
-    /**
-     * Unidad fija ("kg", "m", "hrs") o tomada de otro step (ej: un SELECT con km | m | cm).
-     * null = el usuario elige la unidad dentro del campo.
-     */
-    unit: DynamicRef<string> | null;
-    allowUnitChange: boolean;
-    availableUnits?: string[];
-}
-export interface RateStep extends GNumberStep {
-    numberType: NumberStepType.RATE;
-    /** Moneda del rate ("USD") o tomada de otro step. null = usuario elige */
-    currency: DynamicRef<string> | null;
-    /**
-     * Unidad de tiempo/base del rate ("per_hour", "per_month", "per_km") o tomada de otro step.
-     * null = usuario elige.
-     */
-    unit: DynamicRef<string> | null;
-    availableUnits?: string[];
-}
-/** Unión discriminada del paso NUMBER — narrowing por numberType */
-export type NumberStep = IntegerStep | DecimalStep | PercentageStep | CurrencyStep | QuantityStep | RateStep;
-export type IntegerValue = number;
-export type DecimalValue = number;
-export type PercentageValue = number;
-export interface CurrencyValue {
-    value: number;
-    currency: string;
-}
-export interface QuantityValue {
-    value: number;
-    unit: string;
-}
-export interface RateValue {
-    value: number;
-    currency: string;
-    unit: string;
-}
-/**
- * Banda de calificación — agrupa un rango numérico bajo una etiqueta.
- * Ej: { label: 'Bajo', min: 0, max: 3, color: '#e53935' }
- */
-export interface ScoreBand {
-    label: string;
-    min: number;
-    max: number;
-    /** Color hex o css para mostrar en la UI */
-    color?: string;
-}
-/**
- * Calificación numérica configurable.
- * Diferente de Rating (estrellas/like/escala fija) — Score tiene rango arbitrario.
- * Ej: NPS 0-10, evaluación 0-100, score de riesgo 1-5 con 1 decimal.
- */
-export interface ScoreStep extends GBaseStep {
-    type: 'SCORE';
-    label: string;
-    description: string | null;
-    required: boolean;
-    min: number;
-    max: number;
-    /** Cantidad de decimales. 0 = solo enteros */
-    precision: number;
-    /**
-     * Bandas visuales opcionales (Bajo/Medio/Alto, etc.).
-     * Si no se definen, el campo es solo numérico sin categorización.
-     */
-    bands?: ScoreBand[];
-    size: 1 | 2 | 3 | 4;
-    defaultValue?: number;
-}
-export type ScoreValue = number;
-/** Tipo de salida de la fórmula — define cómo se formatea el resultado */
-export declare enum FormulaOutputType {
-    NUMBER = "NUMBER",
-    CURRENCY = "CURRENCY",
-    PERCENTAGE = "PERCENTAGE"
-}
-/**
- * Campo calculado — siempre readonly, su valor se deriva de otros steps.
- *
- * La expresión usa {{idStep}} para referenciar el valor de otros steps.
- * Ej: "{{precio}} * {{cantidad}} * (1 + {{iva}} / 100)"
- *
- * La evaluación de la fórmula ocurre en el frontend en tiempo real
- * y se valida en backend al guardar.
- */
-export interface FormulaStep extends GBaseStep {
-    type: 'FORMULA';
-    label: string;
-    description: string | null;
-    /**
-     * Expresión matemática con referencias a steps entre doble llave.
-     * Ej: "{{step_subtotal}} * 1.19"
-     */
-    formula: string;
-    outputType: FormulaOutputType;
-    /** Decimales a mostrar en el resultado */
-    precision?: number;
-    /** Requerido si outputType === CURRENCY. Puede venir de otro step. */
-    currency?: DynamicRef<string>;
-    /** Unidad a mostrar si outputType === NUMBER (ej: "m²", "hrs"). Puede venir de otro step. */
-    unit?: DynamicRef<string>;
-    size: 1 | 2 | 3 | 4;
-    /** Siempre true — el usuario no puede editar este campo */
-    readonly: true;
-}
-export type FormulaValue = number;
-export {};

package/dist/@Types/NumericFormSteps.js

@@ -1,32 +0,0 @@
-/**
- * DRAFT — NumericFormSteps types
- * Cubre tres pasos relacionados con números:
- *   - NUMBER  → entrada numérica con subtipos (integer, decimal, currency, percentage, quantity, rate)
- *   - SCORE   → calificación numérica con min/max/precision y bandas opcionales
- *   - FORMULA → campo calculado (solo lectura), derivado de otros steps
- */
-// ===========================================================================
-// NUMBER
-// ===========================================================================
-// NUMBER
-// ===========================================================================
-/** Subtipo del paso numérico — discriminante secundario */
-export var NumberStepType;
-(function (NumberStepType) {
-    NumberStepType["INTEGER"] = "INTEGER";
-    NumberStepType["DECIMAL"] = "DECIMAL";
-    NumberStepType["CURRENCY"] = "CURRENCY";
-    NumberStepType["PERCENTAGE"] = "PERCENTAGE";
-    NumberStepType["QUANTITY"] = "QUANTITY";
-    NumberStepType["RATE"] = "RATE";
-})(NumberStepType || (NumberStepType = {}));
-// ===========================================================================
-// FORMULA
-// ===========================================================================
-/** Tipo de salida de la fórmula — define cómo se formatea el resultado */
-export var FormulaOutputType;
-(function (FormulaOutputType) {
-    FormulaOutputType["NUMBER"] = "NUMBER";
-    FormulaOutputType["CURRENCY"] = "CURRENCY";
-    FormulaOutputType["PERCENTAGE"] = "PERCENTAGE";
-})(FormulaOutputType || (FormulaOutputType = {}));

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

@@ -1,51 +0,0 @@
-/**
- * DRAFT — PredefinedSelectorFormStep types
- *
- * Paso que reemplaza tener que configurar manualmente opciones de selectores
- * para listas fijas y controladas por Capta (países, ciudades, monedas, etc.).
- * Las opciones vienen de APIs internas — el formulario no necesita configurarlas.
- *
- * También resuelve la cascada Country → State → City via parentStepId.
- */
-import { GSmartSelect } from './GenericFormSteps';
-export declare enum PredefinedOptionType {
-    /** ISO 3166-1 — lista de países */
-    COUNTRY = "COUNTRY",
-    /**
-     * Departamento / provincia / estado.
-     * Requiere parentStepId apuntando a un step COUNTRY.
-     */
-    STATE = "STATE",
-    /**
-     * Ciudad / municipio.
-     * Requiere parentStepId apuntando a un step STATE (o COUNTRY si no hay STATE).
-     */
-    CITY = "CITY",
-    /** ISO 4217 — monedas (USD, COP, EUR, etc.) */
-    CURRENCY = "CURRENCY",
-    /** BCP 47 — idiomas (es, en, pt, etc.) */
-    LANGUAGE = "LANGUAGE",
-    /** Tipos de canal de comunicación (WhatsApp, Email, Teléfono) */
-    COMMUNICATION_CHANNEL_TYPE = "COMMUNICATION_CHANNEL_TYPE",
-    /** Tipos de documento de identidad por país (CC, NIT, Pasaporte, etc.) */
-    DOCUMENT_TYPE = "DOCUMENT_TYPE",
-    /** Días de la semana */
-    DAY_OF_WEEK = "DAY_OF_WEEK",
-    /** Meses del año */
-    MONTH = "MONTH"
-}
-export interface PredefinedSelectorStep extends GSmartSelect {
-    type: 'PREDEFINED_SELECTOR';
-    predefinedType: PredefinedOptionType;
-    /**
-     * Solo para STATE y CITY: id del step padre que filtra las opciones.
-     *   - COUNTRY step → filtra estados del país seleccionado
-     *   - STATE step   → filtra ciudades del estado seleccionado
-     *
-     * Si no se especifica, se listan todas las opciones sin filtrar.
-     */
-    parentStepId?: string;
-    maxSize?: number;
-    defaultValue?: string;
-}
-export type PredefinedSelectorValue = string;

package/dist/@Types/PredefinedSelectorFormStep.js

@@ -1,39 +0,0 @@
-/**
- * DRAFT — PredefinedSelectorFormStep types
- *
- * Paso que reemplaza tener que configurar manualmente opciones de selectores
- * para listas fijas y controladas por Capta (países, ciudades, monedas, etc.).
- * Las opciones vienen de APIs internas — el formulario no necesita configurarlas.
- *
- * También resuelve la cascada Country → State → City via parentStepId.
- */
-// ===========================================================================
-// Tipos predefinidos disponibles
-// ===========================================================================
-export var PredefinedOptionType;
-(function (PredefinedOptionType) {
-    /** ISO 3166-1 — lista de países */
-    PredefinedOptionType["COUNTRY"] = "COUNTRY";
-    /**
-     * Departamento / provincia / estado.
-     * Requiere parentStepId apuntando a un step COUNTRY.
-     */
-    PredefinedOptionType["STATE"] = "STATE";
-    /**
-     * Ciudad / municipio.
-     * Requiere parentStepId apuntando a un step STATE (o COUNTRY si no hay STATE).
-     */
-    PredefinedOptionType["CITY"] = "CITY";
-    /** ISO 4217 — monedas (USD, COP, EUR, etc.) */
-    PredefinedOptionType["CURRENCY"] = "CURRENCY";
-    /** BCP 47 — idiomas (es, en, pt, etc.) */
-    PredefinedOptionType["LANGUAGE"] = "LANGUAGE";
-    /** Tipos de canal de comunicación (WhatsApp, Email, Teléfono) */
-    PredefinedOptionType["COMMUNICATION_CHANNEL_TYPE"] = "COMMUNICATION_CHANNEL_TYPE";
-    /** Tipos de documento de identidad por país (CC, NIT, Pasaporte, etc.) */
-    PredefinedOptionType["DOCUMENT_TYPE"] = "DOCUMENT_TYPE";
-    /** Días de la semana */
-    PredefinedOptionType["DAY_OF_WEEK"] = "DAY_OF_WEEK";
-    /** Meses del año */
-    PredefinedOptionType["MONTH"] = "MONTH";
-})(PredefinedOptionType || (PredefinedOptionType = {}));

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

@@ -1,79 +0,0 @@
-/**
- * DRAFT — Sistema de referencias dinámicas entre steps
- *
- * Permite que la configuración de un paso use el valor en tiempo de ejecución
- * de otro step del mismo formulario, en lugar de un literal fijo.
- *
- * Patrón de uso:
- *
- *   // Valor fijo definido en la configuración del formulario
- *   suffix: { type: 'FIXED', value: 'km' }
- *
- *   // Valor tomado del step 'step_unidad' cuando el usuario interactúa
- *   suffix: { type: 'STEP_REF', idStep: 'step_unidad', fallback: 'm' }
- *
- * Se puede aplicar a cualquier campo de configuración cuyo valor deba
- * responder a la selección previa del usuario: sufijos, unidades, monedas,
- * títulos dinámicos, límites numéricos, etc.
- */
-/** Valor literal configurado en tiempo de diseño del formulario */
-export interface FixedRef<T> {
-    type: 'FIXED';
-    value: T;
-}
-/**
- * Referencia al valor actual de otro step en el mismo formulario.
- * El runtime sustituye este ref por el valor que el usuario haya ingresado
- * en el step indicado. Si ese step aún no tiene valor, se usa `fallback`.
- *
- * @typeParam TAllowed - Literal(es) de tipo de step permitidos como origen.
- *   Default: `string` (sin restricción). Pasar un literal union restringe
- *   qué steps puede seleccionar el form builder en la UI.
- *
- * @example
- *   // sin restricción de tipo
- *   StepRef
- *
- *   // solo puede apuntar a steps LOCATION
- *   StepRef<'LOCATION'>
- *
- *   // puede apuntar a PREDEFINED_SELECTOR o CHECKBOX
- *   StepRef<'PREDEFINED_SELECTOR' | 'CHECKBOX'>
- */
-export interface StepRef<TAllowed extends string = string> {
-    type: 'STEP_REF';
-    /** Id del step cuyo valor se usará */
-    idStep: string;
-    /**
-     * Valor de respaldo mientras el step referenciado no tenga valor.
-     * Si no se define, el campo aparece vacío/sin unidad.
-     */
-    fallback?: string;
-    /**
-     * Restricción de tipo — puramente declarativa.
-     * El form builder filtra la lista de steps disponibles a estos tipos.
-     * El backend valida al guardar la configuración.
-     *
-     * Si no se define, se permite referenciar cualquier step.
-     */
-    allowedStepTypes?: TAllowed[];
-}
-/**
- * Un campo dinámico de tipo T puede ser un valor fijo o una referencia a step.
- *
- * @typeParam T        - Tipo del valor cuando es FIXED.
- * @typeParam TAllowed - Tipos de step permitidos en la referencia (default: sin restricción).
- *
- * @example
- *   // sufijo sin restricción de tipo de step
- *   DynamicRef<string>
- *
- *   // centro de radio — solo puede apuntar a steps LOCATION
- *   DynamicRef<LocationCoords, 'LOCATION'>
- *
- *   // moneda — solo desde PREDEFINED_SELECTOR o CHECKBOX
- *   DynamicRef<string, 'PREDEFINED_SELECTOR' | 'CHECKBOX'>
- */
-export type DynamicRef<T, TAllowed extends string = string> = FixedRef<T> | StepRef<TAllowed>;
-export declare function isFixedRef<T, TAllowed extends string = string>(ref: DynamicRef<T, TAllowed>): ref is FixedRef<T>;
-export declare function isStepRef<T, TAllowed extends string = string>(ref: DynamicRef<T, TAllowed>): ref is StepRef<TAllowed>;

package/dist/@Types/StepRef.js

@@ -1,27 +0,0 @@
-/**
- * DRAFT — Sistema de referencias dinámicas entre steps
- *
- * Permite que la configuración de un paso use el valor en tiempo de ejecución
- * de otro step del mismo formulario, en lugar de un literal fijo.
- *
- * Patrón de uso:
- *
- *   // Valor fijo definido en la configuración del formulario
- *   suffix: { type: 'FIXED', value: 'km' }
- *
- *   // Valor tomado del step 'step_unidad' cuando el usuario interactúa
- *   suffix: { type: 'STEP_REF', idStep: 'step_unidad', fallback: 'm' }
- *
- * Se puede aplicar a cualquier campo de configuración cuyo valor deba
- * responder a la selección previa del usuario: sufijos, unidades, monedas,
- * títulos dinámicos, límites numéricos, etc.
- */
-// ---------------------------------------------------------------------------
-// Helpers de narrowing
-// ---------------------------------------------------------------------------
-export function isFixedRef(ref) {
-    return ref.type === 'FIXED';
-}
-export function isStepRef(ref) {
-    return ref.type === 'STEP_REF';
-}