@jvsoft/utils 0.0.13-alpha.4 → 0.0.13-alpha.6

package/src/functions/mat-form-controls/autocomplete.ts

@@ -1,205 +0,0 @@
-import {esNumero} from '../objects-arrays';
-import {AbstractControl} from '@angular/forms';
-import {untilDestroyed} from '@ngneat/until-destroy';
-import {debounceTime, finalize, isObservable, of, startWith, switchMap, tap} from 'rxjs';
-import {map} from 'rxjs/operators';
-
-/**
- * Devuelve un valor de visualización para un elemento buscado.
- * Compatible con listas simples, objetos y campos múltiples.
- */
-export function mostrarValorEnBusqueda(campos: any, idxSel: any) {
-    const buscarEnLista = (lista: any[]) => {
-        if (!lista) return null;
-        if (campos.campoId === '*object*' || campos.campoId === '*objeto*') {
-            return lista.find((x: any) => JSON.stringify(x).trim() === JSON.stringify(idxSel).trim());
-        }
-        return lista.find((x: any) => x[campos.campoId] === idxSel);
-    };
-
-    const impDataMostrar = () => {
-        let vD = buscarEnLista(campos.lista) || (campos.opcExtra && buscarEnLista(campos.opcExtra));
-        if (!vD) return '';
-
-        if (Array.isArray(campos.campoValue)) {
-            return campos.campoValue.map((vCampo: any) => vD[vCampo] ?? '').join(' - ').trim();
-        }
-        return (vD[campos.campoValue] ?? '').trim();
-    };
-
-    if (esNumero(idxSel)) {
-        if ((idxSel > 0 && campos.lista?.length) || (idxSel && typeof idxSel === 'object')) {
-            return impDataMostrar();
-        }
-    } else if (campos.lista?.length) {
-        return impDataMostrar();
-    }
-    return '';
-}
-
-/**
- * Filtra datos locales de un array basado en un valor de búsqueda.
- */
-function filtrarDatosLocal(data: any[], value: any, campoBuscar: string | string[]) {
-    if (!value) return data;
-
-    const normalizar = (val: any) => val?.toString()?.toLowerCase() ?? '';
-    const esNum = !isNaN(Number(value));
-
-    return data.filter(item => {
-        const campos = Array.isArray(campoBuscar) ? campoBuscar : [campoBuscar];
-        return campos.some(campo => {
-            const campoVal = item[campo];
-            if (campoVal == null) return false;
-            return esNum
-                ? campoVal.toString().includes(value.toString())
-                : normalizar(campoVal).includes(normalizar(value));
-        });
-    });
-}
-
-/**
- * Vincula un FormControl a datos locales para autocompletado.
- */
-export function changeSelectData(objThis: any, { formControl, data, campoBuscar, variableResultado }: {
-    formControl: AbstractControl;
-    data: any[];
-    campoBuscar: string | string[];
-    variableResultado: string;
-}) {
-    objThis.filtrados[variableResultado] = formControl.valueChanges.pipe(untilDestroyed(objThis)).pipe(
-        startWith(''),
-        map(value => data ? filtrarDatosLocal(data, value, campoBuscar) : [])
-    );
-}
-
-/**
- * Vincula un FormControl a datos locales obtenidos de dataServidor o dataServidorSuscripcion.
- */
-export function changeSelect(control: any, formControl: AbstractControl, tipo: string, campoBuscar: string | string[], campoFiltro: string | null = null) {
-    const filtro = campoFiltro ?? tipo;
-    control.filtrados[filtro] = formControl.valueChanges.pipe(untilDestroyed(control)).pipe(
-        startWith(''),
-        map(value => {
-            const partes = tipo.split('.');
-            const varN =
-                control.dataServidor?.[partes[0]]?.[partes[1]] ??
-                control.dataServidor?.[tipo] ??
-                control.dataServidorSuscripcion?.[tipo]?.getValue();
-
-            return varN ? filtrarDatosLocal(varN, value, campoBuscar) : [];
-        })
-    );
-}
-
-/**
- * Configuración para changeSelectReformateado.
- */
-interface ChangeSelectConfig {
-    objThis: any;
-    tipoReq: string;
-    formControl: AbstractControl;
-    queryService: any;
-    campoId?: string;
-    minLength?: number;
-    dataExtra?: any;
-    dataExtraVariable?: { campo: string; ctrlValue: AbstractControl }[];
-    anonimo?: boolean;
-    variableResultado?: string;
-}
-
-/**
- * Función genérica para vincular un FormControl con datos desde API o Promise.
- * Preparada para migrar a signals en el futuro.
- */
-export function changeSelectReformateado(config: ChangeSelectConfig) {
-    const {
-        objThis,
-        tipoReq,
-        formControl,
-        queryService,
-        campoId,
-        minLength = 3,
-        dataExtra = {},
-        dataExtraVariable = [],
-        anonimo = false,
-        variableResultado = tipoReq,
-    } = config;
-
-    formControl.valueChanges.pipe(
-        debounceTime(500),
-        tap(() => {
-            objThis.filtrados[variableResultado + 'tmp'] = isObservable(objThis.filtrados[variableResultado])
-                ? []
-                : objThis.filtrados[variableResultado] || [];
-            if (objThis.filtrados[variableResultado] !== objThis.filtrados[variableResultado + 'tmp']) {
-                objThis.filtrados[variableResultado] = [];
-            }
-            objThis.isLoading = true;
-        }),
-        switchMap(value => {
-            if (campoId) {
-                const existe = objThis.filtrados[variableResultado + 'tmp']
-                    .findIndex((item: any) => item[campoId] === value);
-                if (existe >= 0) {
-                    return of({ [tipoReq]: objThis.filtrados[variableResultado + 'tmp'] });
-                }
-            }
-            if (!value || value.length < minLength) {
-                objThis.isLoading = false;
-                return of({ [tipoReq]: [] });
-            }
-            const extraVars = Object.fromEntries(dataExtraVariable.map(v => [v.campo, v.ctrlValue.value]));
-            const query = queryService.getDataMethod('GET', tipoReq, { ...dataExtra, ...extraVars, txtBuscar: value }, anonimo);
-
-            if (esPromise(query)) {
-                return query.then((data: any) => ({ [tipoReq]: data[tipoReq] ?? [] }))
-                    .finally(() => { objThis.isLoading = false; });
-            }
-            return query.pipe(finalize(() => { objThis.isLoading = false; }));
-        })
-    ).subscribe((data: any) => {
-        objThis.filtrados[variableResultado] = data[tipoReq] ?? [];
-    });
-}
-
-/**
- * Alias para compatibilidad.
- */
-export function changeSelectDataApi(objThis: any, dataFiltro: any) {
-    return changeSelectReformateado({
-        objThis,
-        tipoReq: dataFiltro.tipoReq,
-        formControl: dataFiltro.formControl,
-        queryService: dataFiltro.queryService,
-        campoId: dataFiltro.campoId,
-        minLength: dataFiltro.minLength,
-        dataExtra: dataFiltro.dataExtra,
-        dataExtraVariable: dataFiltro.dataExtraVariable,
-        anonimo: dataFiltro.anonimo,
-        variableResultado: dataFiltro.variableResultado,
-    });
-}
-
-/**
- * Alias para compatibilidad.
- */
-export function changeSelectApi(control: any, queryService: any, formControl: AbstractControl, tipo: any, dataExtra = {}, dataExtraVariable: any[] | null = null, minLength = 1, anonimo = false) {
-    return changeSelectReformateado({
-        objThis: control,
-        tipoReq: tipo,
-        formControl,
-        queryService,
-        minLength,
-        dataExtra,
-        dataExtraVariable: dataExtraVariable ?? [],
-        anonimo,
-    });
-}
-
-/**
- * Comprueba si un valor es una Promesa.
- */
-function esPromise(valor: any): valor is Promise<any> {
-    return !!valor && typeof valor.then === 'function';
-}

package/src/functions/mat-form-controls/index.ts

@@ -1,6 +0,0 @@
-export * from './autocomplete'
-
-
-export function seleccionarTextoInput(event: any): void {
-    (event.target as HTMLInputElement).select();
-}

package/src/functions/ng-package.json

@@ -1,5 +0,0 @@
-{
-  "lib": {
-    "entryFile": "public-api.ts"
-  }
-}

package/src/functions/number.ts

@@ -1,85 +0,0 @@
-export function roundToDecimal(number: number, decimal: number): number {
-    return parseFloat(number.toFixed(decimal));
-}
-
-export function numberToWords(num: number): string {
-    if (num === 0) return 'cero';
-    if (num < 0) return 'menos ' + numberToWords(Math.abs(num));
-    if (num > 999999999999) return 'número demasiado grande';
-
-    const ones = ['', 'un', 'dos', 'tres', 'cuatro', 'cinco', 'seis', 'siete', 'ocho', 'nueve'];
-    const onesFinal = ['', 'uno', 'dos', 'tres', 'cuatro', 'cinco', 'seis', 'siete', 'ocho', 'nueve'];
-    const tens = ['', 'diez', 'veinte', 'treinta', 'cuarenta', 'cincuenta', 'sesenta', 'setenta', 'ochenta', 'noventa'];
-    const teens = ['diez', 'once', 'doce', 'trece', 'catorce', 'quince', 'dieciséis', 'diecisiete', 'dieciocho', 'diecinueve'];
-    const hundreds = ['', 'ciento', 'doscientos', 'trescientos', 'cuatrocientos', 'quinientos', 'seiscientos', 'setecientos', 'ochocientos', 'novecientos'];
-
-    // Función auxiliar para "un"/"uno"
-    const getOneForm = (n: number, isFinal: boolean): string =>
-        n === 1 ? (isFinal ? 'uno':'un'):onesFinal[n];
-
-    let words = '';
-
-    // Miles de millones (ahora sí se ejecuta)
-    if (num >= 1000000000) {
-        const billions = Math.floor(num / 1000000000);
-        words += (billions === 1 ? 'mil':numberToWords(billions) + ' mil') + ' millones ';
-        num %= 1000000000;
-    }
-
-    // Millones
-    if (num >= 1000000) {
-        const millions = Math.floor(num / 1000000);
-        words += millions === 1 ? 'un millón ':numberToWords(millions) + ' millones ';
-        num %= 1000000;
-    }
-
-    // Miles
-    if (num >= 1000) {
-        const thousands = Math.floor(num / 1000);
-        words += thousands === 1 ? 'mil ':numberToWords(thousands) + ' mil ';
-        num %= 1000;
-    }
-
-    // Centenas (con tratamiento especial para "ciento uno")
-    if (num >= 100) {
-        if (num === 100) {
-            words += 'cien';
-            num = 0;
-        }
-        else {
-            words += hundreds[Math.floor(num / 100)];
-            num %= 100;
-            if (num > 0) {
-                words += ' ' + getOneForm(num, true); // Siempre "uno" después de ciento
-                num = 0;
-            }
-        }
-    }
-
-    // Decenas y unidades
-    if (num > 0) {
-        const isFinalWord = words === '';
-
-        if (num < 10) {
-            words += getOneForm(num, isFinalWord);
-        }
-        else if (num < 20) {
-            words += teens[num - 10];
-        }
-        else if (num < 30) {
-            if (num === 21) words += 'veintiuno';
-            else if (num === 22) words += 'veintidós';
-            else if (num === 23) words += 'veintitrés';
-            else if (num === 26) words += 'veintiséis';
-            else words += `veinti${onesFinal[num % 10]}`;
-        }
-        else {
-            words += tens[Math.floor(num / 10)];
-            if (num % 10 > 0) {
-                words += ' y ' + getOneForm(num % 10, isFinalWord);
-            }
-        }
-    }
-
-    return words.trim().replace(/\s+/g, ' ');
-}

package/src/functions/object-transformation.ts

@@ -1,37 +0,0 @@
-import {formatDate} from '@angular/common';
-import {formatearFecha} from './date';
-
-export function objectPropertiesToType(formFields: Record<string, any>) {
-    Object.keys(formFields).filter(control => !!formFields[control]).forEach(control => {
-        if (/^dt[a-zA-Z]+/.test(control)) {
-            formFields[control] = formatDate(formFields[control], 'yyyy-MM-dd HH:mm', 'es-PE');
-        }
-        else if (control.startsWith('d')) {
-            formFields[control] = formatearFecha(formFields[control]);
-        }
-        else if (control.startsWith('n')) {
-            formFields[control] = Number(formFields[control]);
-        }
-    });
-
-    return formFields;
-}
-
-export function objectPropertiesBoolean(formFields: Record<string, any>, retorno: 'boolean' | 'bit' = 'boolean') {
-    Object.keys(formFields).forEach(control => {
-        const valRetorno = (ctrl: any) => {
-            switch (retorno) {
-                case 'boolean':
-                    formFields[ctrl] = formFields[ctrl] == 1;
-                    break;
-                case 'bit':
-                    formFields[ctrl] = formFields[ctrl] ? 1:0;
-                    break;
-            }
-        };
-        if (control.charAt(0) == 'b' || (control.charAt(0) == 'i' && control.indexOf('Estado') !== -1)) {
-            valRetorno(control);
-        }
-    });
-    return formFields;
-}

package/src/functions/objects-arrays.ts

@@ -1,321 +0,0 @@
-export function deepMerge(source: any, target: any): any {
-    // Crea un clon profundo sin usar JSON.parse(JSON.stringify)
-    let cloneSource = deepClone(source);
-
-    if (typeof target !== 'object' || target === null) {
-        return target;
-    }
-
-    if (typeof cloneSource !== 'object' || cloneSource === null) {
-        cloneSource = Array.isArray(target) ? [] : {};
-    }
-
-    for (const key of Object.keys(target)) {
-        const targetValue = target[key];
-        const sourceValue = cloneSource[key];
-
-        if (typeof targetValue === 'object' && targetValue !== null && !Array.isArray(targetValue)) {
-            cloneSource[key] = deepMerge(sourceValue, targetValue);
-        } else {
-            cloneSource[key] = targetValue;
-        }
-    }
-    return cloneSource; // Retorna el clon y no modifica el original
-}
-
-// Función de clonación profunda que maneja funciones, fechas y otros tipos especiales
-export function deepClone(obj: any): any {
-    if (obj === null || typeof obj !== 'object') {
-        return obj; // Devuelve el valor si no es un objeto
-    }
-
-    // Manejar instancias de Date
-    if (obj instanceof Date) {
-        return new Date(obj.getTime());
-    }
-
-    // Manejar funciones devolviendo una copia directa
-    if (typeof obj === 'function') {
-        return obj.bind({}); // Devuelve una copia de la función enlazada a un contexto vacío
-    }
-
-    // Crear un nuevo objeto o array
-    const clonedObj: Record<string, any> = Array.isArray(obj) ? [] : {};
-
-    // Clonar recursivamente las propiedades del objeto
-    for (const key in obj) {
-        if (Object.prototype.hasOwnProperty.call(obj, key)) {
-            clonedObj[key] = deepClone(obj[key]);
-        }
-    }
-
-    return clonedObj;
-}
-
-/**
- * Busca un elemento en un array o jerarquía de objetos según un campo y valor especificado.
- *
- * @returns El elemento encontrado o undefined si no existe.
- */
-export function buscarPorCampo<T>(datosFn: {
-    items: T[];
-    campo: keyof T;
-    valor: any;
-    campoHijo?: string; // Campo opcional para búsqueda recursiva
-}): T | undefined {
-    for (const item of datosFn.items) {
-        // Verifica si el campo coincide con el valor
-        if (item[datosFn.campo] === datosFn.valor) {
-            return item;
-        }
-
-        // Verifica si hay un campo hijo y si es un array
-        if (datosFn.campoHijo && item[datosFn.campoHijo as keyof T] && Array.isArray(item[datosFn.campoHijo as keyof T])) {
-            // Realiza la búsqueda recursiva en el campo hijo
-            const encontrado = buscarPorCampo({
-                items: item[datosFn.campoHijo as keyof T] as T[], // Asegura el tipo correcto
-                campo: datosFn.campo,
-                valor: datosFn.valor,
-                campoHijo: datosFn.campoHijo,
-            });
-
-            // Si se encuentra el valor en el campo hijo, retorna el resultado
-            if (encontrado) {
-                return encontrado;
-            }
-        }
-    }
-
-    // Si no se encuentra nada, retorna undefined
-    return undefined;
-}
-
-export function sumarPropiedades(item: Record<string, any>, campos: string[]) {
-    const datosSumar = campos.map(campo => (item[campo] * 1));
-    return datosSumar.reduce((a, b) => a + b, 0);
-}
-
-export function esNumero(value: any): boolean {
-    return !isNaN(Number(value));
-}
-
-export function sumarObjetos(arrayObjetos: any[], campos: string[]): Record<string, number> {
-    return arrayObjetos.reduce((accumulator: Record<string, number>, item: any) => {
-        campos.forEach(campo => {
-            const valor = Number(item[campo]);
-            if (!isNaN(valor)) {
-                accumulator[campo] = (accumulator[campo] ?? 0) + valor;
-            }
-        });
-        return accumulator;
-    }, {});
-}
-
-export function getUniqueValues(array: any[]) {
-    return array.filter((currentValue, index, arr) => (
-        arr.indexOf(currentValue) === index
-    ));
-}
-
-export function getUniqueValuesByProperty<T>(objetos: T[], campo: string): T[] {
-    const objetosUnicos: {[key: string]: T} = {};
-
-    objetos.forEach(objeto => {
-        // Verificar si el objeto tiene el campo especificado
-        // @ts-ignore
-        if (objeto.hasOwnProperty(campo)) {
-            // @ts-ignore
-            const valorCampo = objeto[campo];
-
-            // Utilizar el valor del campo como clave en un objeto para asegurar que no haya duplicados
-            objetosUnicos[valorCampo] = objeto;
-        }
-    });
-
-    // Convertir el objeto de claves únicas de vuelta a una lista de objetos
-    return Object.values(objetosUnicos);
-}
-
-
-export function ordenarArray(array: any[], numeros = false, sentido: 'ASC' | 'DESC' = 'ASC'): any[] {
-    if (numeros) {
-        if (sentido != 'ASC') {
-            return array.sort((a: any, b: any) => b - a);
-        }
-        return array.sort((a: any, b: any) => a - b);
-    }
-    return array.sort((a, b) => (a > b) ? 1:((b > a) ? -1:0));
-
-}
-
-export function ordenarPorPropiedad(objData: any, propiedad: string, /**@deprecated*/ numeros = false) {
-    return ordenarPorPropiedades(objData, {propiedades: [propiedad], direcciones:['asc']});
-}
-
-export function ordenarPorPropiedades<T>(arr: T[], options: {
-    propiedades: (keyof T)[],
-    direcciones?: ('asc' | 'desc' | '')[],
-}): T[] {
-    const {propiedades, direcciones = []} = options;
-    const orden = direcciones.map(d => d === 'desc' ? -1:1);
-
-    return [...arr].sort((a, b) => {
-        return propiedades.reduce((acc, propiedad, index) => {
-            if (acc !== 0) return acc; // Si ya hay diferencia, no seguir comparando
-
-            const aValue = a[propiedad];
-            const bValue = b[propiedad];
-
-            if (typeof aValue === 'string' && typeof bValue === 'string') {
-                return aValue.localeCompare(bValue) * orden[index]; // 🔹 Comparación alfabética
-            }
-            if (typeof aValue === 'number' && typeof bValue === 'number') {
-                return (aValue - bValue) * orden[index]; // 🔹 Comparación numérica
-            }
-
-            return 0; // En caso de valores no comparables
-        }, 0);
-    });
-}
-
-export function groupBy<T extends Record<string, any>, K extends keyof T>(
-    array: T[],
-    key: K | ((obj: T) => string)
-): Record<string, T[]> {
-    const keyFn = key instanceof Function ? key:(obj: T) => obj[key];
-    return array.reduce((objectsByKeyValue, obj) => {
-        const value = keyFn(obj);
-        objectsByKeyValue[value] = (objectsByKeyValue[value] || []).concat(obj);
-        return objectsByKeyValue;
-    }, {} as Record<string, T[]>);
-}
-
-export function nestGroupsBy(arr: any, properties: any) {
-    const fnGroupBy = (conversions: any, property2: any) => {
-        return conversions.reduce((acc: any, obj: any) => {
-            const key = obj[property2];
-            if (!acc[key]) {
-                acc[key] = [];
-            }
-            acc[key].push(obj);
-            return acc;
-        }, {});
-    };
-    properties = Array.from(properties);
-    if (properties.length === 1) {
-        return fnGroupBy(arr, properties[0]);
-    }
-    const property = properties.shift();
-    const grouped = fnGroupBy(arr, property);
-    Object.keys(grouped).forEach(key => {
-        grouped[key] = nestGroupsBy(grouped[key], Array.from(properties));
-    });
-    return grouped;
-}
-
-
-/**
- * Obtiene un valor de un objeto usando una ruta de propiedad anidada.
- *
- * @param obj - Objeto de entrada.
- * @param path - Ruta en formato punto (ej: "cliente.orden").
- * @returns El valor encontrado o undefined si no existe.
- */
-function getValueByPath(obj: any, path: string): any {
-    return path.split('.').reduce((acc, key) => acc?.[key], obj);
-}
-
-/**
- * Retorna el valor máximo del campo especificado (incluso anidado) en un arreglo de objetos.
- *
- * @param data - Lista de objetos a procesar.
- * @param campo - Nombre del campo a evaluar, puede ser anidado (ej. "campo.orden").
- * @param incrementar - Si es true, retorna el valor máximo + 1. Por defecto es true.
- * @returns El valor máximo encontrado, posiblemente incrementado.
- */
-export function obtenerUltimoOrden(data: any[], campo: string, incrementar: boolean = true): number {
-    const max = data.reduce((mayor, item) => {
-        const valor = Number(getValueByPath(item, campo)) || 0;
-        return valor > mayor ? valor:mayor;
-    }, 0);
-
-    return incrementar ? max + 1:max;
-}
-
-
-/**
- * Elimina una o varias columnas específicas (por índice) de una tabla representada como array de arrays.
- *
- * @param data - Array de filas (cada fila debe ser un array).
- * @param columnIndex - Índice o lista de índices de las columnas a eliminar.
- * @returns Nuevo array con las columnas eliminadas.
- */
-export function eliminarColumnaPorIndex<T extends unknown[][]>(
-    data: T,
-    columnIndex: number | number[]
-): T {
-    if (!Array.isArray(data)) return [] as unknown as T;
-
-    // Normalizar a array único y ordenado (descendente para evitar reindexación al splicing)
-    const indices: number[] = Array.isArray(columnIndex)
-        ? [...new Set(columnIndex)].filter((i) => (typeof i === 'number' && i >= 0)).sort((a, b) => b - a)
-        :[columnIndex];
-
-    return data.map((row) => {
-        if (!Array.isArray(row)) return row;
-
-        const newRow = [...row];
-
-        for (const index of indices) {
-            if (index >= 0 && index < newRow.length) {
-                newRow.splice(index, 1);
-            }
-        }
-
-        return newRow as typeof row;
-    }) as T;
-}
-
-
-
-export function eliminarDuplicados<T extends object>(
-    array: T[],
-    claves?: (keyof T)[]
-): T[] {
-    const unicos = new Map<string, T>();
-
-    for (const item of array) {
-        const claveUnica = claves && claves.length > 0
-            ? claves.map(k => item[k]).join('|')
-            : JSON.stringify(item);
-
-        if (!unicos.has(claveUnica)) {
-            unicos.set(claveUnica, item);
-        }
-    }
-
-    return Array.from(unicos.values());
-}
-
-export function eliminarElementos<T extends object>(
-    origen: T[],
-    elementosAEliminar: T[],
-    claves?: (keyof T)[]
-): T[] {
-    const clavesSet = new Set<string>();
-
-    for (const item of elementosAEliminar) {
-        const key = claves && claves.length > 0
-            ? claves.map(k => item[k]).join('|')
-            : JSON.stringify(item);
-        clavesSet.add(key);
-    }
-
-    return origen.filter(item => {
-        const key = claves && claves.length > 0
-            ? claves.map(k => item[k]).join('|')
-            : JSON.stringify(item);
-        return !clavesSet.has(key);
-    });
-}
-

package/src/functions/public-api.ts

@@ -1,19 +0,0 @@
-export * from './mat-form-controls';
-
-export * from './base64'
-export * from './browser'
-export * from './crypto-js';
-export * from './date';
-export * from './email';
-export * from './file'
-export * from './forms'
-export * from './http-client'
-export * from './local-storage';
-export * from './number';
-export * from './object-transformation'
-export * from './objects-arrays'
-export * from './string'
-export * from './sweetalert'
-export * from './utiles'
-
-