@jvsoft/utils 0.0.13-alpha.2 → 0.0.13-alpha.3

package/functions/forms.d.ts

@@ -1,4 +1,5 @@
-import { AbstractControl, FormGroup } from '@angular/forms';
+import { AbstractControl, FormControl, FormGroup } from '@angular/forms';
+import { BehaviorSubject } from 'rxjs';
 export declare function establecerQuitarRequired(formulario: FormGroup, establecer?: any[], quitar?: any[], camposDisabled?: string[] | 'todos'): void;
 export declare function getFormValidationErrors(form: FormGroup): {
     control: string;
@@ -8,3 +9,15 @@ export declare function getFormValidationErrors(form: FormGroup): {
 export declare function mensajesErrorFormControl(control: AbstractControl | null): string;
 export declare function toFormData<T extends Record<string, any>>(formValue: T): FormData;
 export declare function markAsTouchedWithoutEmitEvent(control: AbstractControl): void;
+export interface SetControlDesdeListaConfig<T, V = any> {
+    lista$: BehaviorSubject<T[]>;
+    formControl?: FormControl<V>;
+    formGroup?: FormGroup;
+    controlName?: string;
+    idProp?: keyof T;
+    idValor?: any;
+    selector?: (item: T) => V;
+    usarPrimeraOpcion?: boolean;
+}
+export declare function setControlDesdeLista<T, V = any>(config: SetControlDesdeListaConfig<T, V>): void;
+export declare function transformarFechasPorNombreDeCampo<T extends Record<string, any>>(formValue: T): T;

package/functions/number.d.ts

@@ -1 +1,2 @@
 export declare function roundToDecimal(number: number, decimal: number): number;
+export declare function numberToWords(num: number): string;

package/functions/objects-arrays.d.ts

@@ -35,3 +35,13 @@ export declare function nestGroupsBy(arr: any, properties: any): any;
  * @returns El valor máximo encontrado, posiblemente incrementado.
  */
 export declare function obtenerUltimoOrden(data: any[], campo: string, incrementar?: boolean): number;
+/**
+ * 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 declare function eliminarColumnaPorIndex<T extends unknown[][]>(data: T, columnIndex: number | number[]): T;
+export declare function eliminarDuplicados<T extends object>(array: T[], claves?: (keyof T)[]): T[];
+export declare function eliminarElementos<T extends object>(origen: T[], elementosAEliminar: T[], claves?: (keyof T)[]): T[];

package/functions/string.d.ts

@@ -1 +1,23 @@
 export declare function generateRandomString(length: number): string;
+/**
+ * Obtiene el host (hostname) de una URL o cadena host[:port].
+ * Opcionalmente puede devolver también el puerto si está presente.
+ *
+ * - Acepta inputs como:
+ *   'https://example.com/path', 'example.com:3000', 'localhost', 'http://[::1]:4200'
+ * - Usa la API URL cuando es posible (más robusta) y cae a un regex de respaldo.
+ *
+ * @param url Cadena que representa una URL o host
+ * @param options
+ * @param options.includePort Si es true, incluye":puerto" cuando exista (por defecto false)
+ * @param options.includeProtocol Incluye "http://" o "https://" según corresponda (por defecto false)
+ */
+export declare function obtenerHostDesdeUrl(url: string | null | undefined, options?: {
+    includePort?: boolean;
+    includeProtocol?: boolean;
+}): string | null;
+/** @deprecated Alias compatible (deprecated) — preferir usar `obtenerHostDesdeUrl`. */
+export declare const extraerDominio: (url: string | null | undefined, options?: {
+    includePort?: boolean;
+    includeProtocol?: boolean;
+}) => string | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jvsoft/utils",
-  "version": "0.0.13-alpha.2",
+  "version": "0.0.13-alpha.3",
   "description": "JVSOFT Angular Utils",
   "publishConfig": {
     "tag": "alpha",
@@ -34,10 +34,6 @@
       "types": "./index.d.ts",
       "default": "./fesm2022/jvsoft-utils.mjs"
     },
-    "./src/interfaces": {
-      "types": "./src/interfaces/index.d.ts",
-      "default": "./fesm2022/jvsoft-utils-src-interfaces.mjs"
-    },
     "./src/functions": {
       "types": "./src/functions/index.d.ts",
       "default": "./fesm2022/jvsoft-utils-src-functions.mjs"
@@ -45,6 +41,10 @@
     "./src/pipes": {
       "types": "./src/pipes/index.d.ts",
       "default": "./fesm2022/jvsoft-utils-src-pipes.mjs"
+    },
+    "./src/interfaces": {
+      "types": "./src/interfaces/index.d.ts",
+      "default": "./fesm2022/jvsoft-utils-src-interfaces.mjs"
     }
   }
-}
+}

package/src/functions/forms.d.ts

@@ -1,4 +1,5 @@
-import { AbstractControl, FormGroup } from '@angular/forms';
+import { AbstractControl, FormControl, FormGroup } from '@angular/forms';
+import { BehaviorSubject } from 'rxjs';
 export declare function establecerQuitarRequired(formulario: FormGroup, establecer?: any[], quitar?: any[], camposDisabled?: string[] | 'todos'): void;
 export declare function getFormValidationErrors(form: FormGroup): {
     control: string;
@@ -8,3 +9,15 @@ export declare function getFormValidationErrors(form: FormGroup): {
 export declare function mensajesErrorFormControl(control: AbstractControl | null): string;
 export declare function toFormData<T extends Record<string, any>>(formValue: T): FormData;
 export declare function markAsTouchedWithoutEmitEvent(control: AbstractControl): void;
+export interface SetControlDesdeListaConfig<T, V = any> {
+    lista$: BehaviorSubject<T[]>;
+    formControl?: FormControl<V>;
+    formGroup?: FormGroup;
+    controlName?: string;
+    idProp?: keyof T;
+    idValor?: any;
+    selector?: (item: T) => V;
+    usarPrimeraOpcion?: boolean;
+}
+export declare function setControlDesdeLista<T, V = any>(config: SetControlDesdeListaConfig<T, V>): void;
+export declare function transformarFechasPorNombreDeCampo<T extends Record<string, any>>(formValue: T): T;

package/src/functions/number.d.ts

@@ -1 +1,2 @@
 export declare function roundToDecimal(number: number, decimal: number): number;
+export declare function numberToWords(num: number): string;

package/src/functions/objects-arrays.d.ts

@@ -35,3 +35,13 @@ export declare function nestGroupsBy(arr: any, properties: any): any;
  * @returns El valor máximo encontrado, posiblemente incrementado.
  */
 export declare function obtenerUltimoOrden(data: any[], campo: string, incrementar?: boolean): number;
+/**
+ * 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 declare function eliminarColumnaPorIndex<T extends unknown[][]>(data: T, columnIndex: number | number[]): T;
+export declare function eliminarDuplicados<T extends object>(array: T[], claves?: (keyof T)[]): T[];
+export declare function eliminarElementos<T extends object>(origen: T[], elementosAEliminar: T[], claves?: (keyof T)[]): T[];

package/src/functions/string.d.ts

@@ -1 +1,23 @@
 export declare function generateRandomString(length: number): string;
+/**
+ * Obtiene el host (hostname) de una URL o cadena host[:port].
+ * Opcionalmente puede devolver también el puerto si está presente.
+ *
+ * - Acepta inputs como:
+ *   'https://example.com/path', 'example.com:3000', 'localhost', 'http://[::1]:4200'
+ * - Usa la API URL cuando es posible (más robusta) y cae a un regex de respaldo.
+ *
+ * @param url Cadena que representa una URL o host
+ * @param options
+ * @param options.includePort Si es true, incluye":puerto" cuando exista (por defecto false)
+ * @param options.includeProtocol Incluye "http://" o "https://" según corresponda (por defecto false)
+ */
+export declare function obtenerHostDesdeUrl(url: string | null | undefined, options?: {
+    includePort?: boolean;
+    includeProtocol?: boolean;
+}): string | null;
+/** @deprecated Alias compatible (deprecated) — preferir usar `obtenerHostDesdeUrl`. */
+export declare const extraerDominio: (url: string | null | undefined, options?: {
+    includePort?: boolean;
+    includeProtocol?: boolean;
+}) => string | null;