ngx-dsxlibrary 1.21.38 → 1.21.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-dsxlibrary",
-  "version": "1.21.38",
+  "version": "1.21.40",
   "description": "Libreria para control de código automatizado.",
   "author": "DevSoftXela",
   "dependencies": {
@@ -49,6 +49,10 @@
       "types": "./types/ngx-dsxlibrary-src-lib-services.d.ts",
       "default": "./fesm2022/ngx-dsxlibrary-src-lib-services.mjs"
     },
+    "./src/lib/utils": {
+      "types": "./types/ngx-dsxlibrary-src-lib-utils.d.ts",
+      "default": "./fesm2022/ngx-dsxlibrary-src-lib-utils.mjs"
+    },
     "./src/lib/validations": {
       "types": "./types/ngx-dsxlibrary-src-lib-validations.d.ts",
       "default": "./fesm2022/ngx-dsxlibrary-src-lib-validations.mjs"

package/types/ngx-dsxlibrary-src-lib-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Formateador de moneda por defecto para Guatemala.
+ *
+ * Usa la configuración regional `es-GT` y el código de moneda `GTQ`.
+ * Siempre muestra 2 decimales.
+ *
+ * Ejemplo de uso:
+ * ```ts
+ * GTQFormatter.format(1234.5); // "Q 1,234.50"
+ * ```
+ */
+declare const GTQFormatter: Intl.NumberFormat;
+/**
+ * Crea un formateador de moneda personalizado.
+ *
+ * Permite definir la configuración regional (`locale`) y el código de moneda (`currency`)
+ * manteniendo 2 decimales fijos.
+ *
+ * Ejemplos de uso:
+ * ```ts
+ * const usdFormatter = createCurrencyFormatter('en-US', 'USD');
+ * usdFormatter.format(1000); // "$1,000.00"
+ *
+ * const mxnFormatter = createCurrencyFormatter('es-MX', 'MXN');
+ * mxnFormatter.format(1500.75); // "$1,500.75"
+ * ```
+ *
+ * @param locale   Código de configuración regional, por ejemplo: `es-GT`, `en-US`.
+ * @param currency Código de moneda ISO 4217, por ejemplo: `GTQ`, `USD`, `EUR`.
+ * @returns Instancia de `Intl.NumberFormat` configurada para moneda.
+ */
+declare function createCurrencyFormatter(locale: string, currency: string): Intl.NumberFormat;
+
+export { GTQFormatter, createCurrencyFormatter };

package/types/ngx-dsxlibrary.d.ts

@@ -1196,14 +1196,17 @@ declare class ParameterValuesService<T extends string = string> {
     private validateParameters;
     /**
      * Obtiene un valor específico de un parámetro.
+     * Si `index` es null (valor por defecto), devuelve todo el arreglo de valores.
      * Devuelve `defaultValue` si no existe el parámetro o el índice es inválido.
      * Valida que el parámetro exista antes de acceder a su valor.
      * @param parameterName Nombre del parámetro
-     * @param index Índice del valor dentro del array (default: 0)
+     * @param index Índice del valor dentro del array. Si es null (default), devuelve todos los valores.
      * @param defaultValue Valor por defecto si no existe (default: null)
-     * @returns Valor del parámetro o defaultValue si no existe o el índice es inválido
+     * @returns Valor del parámetro, todos los valores si index es null, o defaultValue si no existe o el índice es inválido
      */
-    getValue<U = any>(parameterName: T, index?: number, defaultValue?: U | null): U;
+    getValue<U = any>(parameterName: T): U[];
+    getValue<U = any>(parameterName: T, index: number, defaultValue?: U | null): U;
+    getValue<U = any>(parameterName: T, index: null, defaultValue?: U[] | null): U[];
     /**
      * Compara un valor específico con un valor esperado, usando cache para optimizar llamadas repetidas.
      * @param parameterName Nombre del parámetro
@@ -1612,6 +1615,39 @@ declare class UtilityAddService {
     static ɵprov: i0.ɵɵInjectableDeclaration<UtilityAddService>;
 }
 
+/**
+ * Formateador de moneda por defecto para Guatemala.
+ *
+ * Usa la configuración regional `es-GT` y el código de moneda `GTQ`.
+ * Siempre muestra 2 decimales.
+ *
+ * Ejemplo de uso:
+ * ```ts
+ * GTQFormatter.format(1234.5); // "Q 1,234.50"
+ * ```
+ */
+declare const GTQFormatter: Intl.NumberFormat;
+/**
+ * Crea un formateador de moneda personalizado.
+ *
+ * Permite definir la configuración regional (`locale`) y el código de moneda (`currency`)
+ * manteniendo 2 decimales fijos.
+ *
+ * Ejemplos de uso:
+ * ```ts
+ * const usdFormatter = createCurrencyFormatter('en-US', 'USD');
+ * usdFormatter.format(1000); // "$1,000.00"
+ *
+ * const mxnFormatter = createCurrencyFormatter('es-MX', 'MXN');
+ * mxnFormatter.format(1500.75); // "$1,500.75"
+ * ```
+ *
+ * @param locale   Código de configuración regional, por ejemplo: `es-GT`, `en-US`.
+ * @param currency Código de moneda ISO 4217, por ejemplo: `GTQ`, `USD`, `EUR`.
+ * @returns Instancia de `Intl.NumberFormat` configurada para moneda.
+ */
+declare function createCurrencyFormatter(locale: string, currency: string): Intl.NumberFormat;
+
 /**
  * Valida que el control contenga un rango de fechas válido (dos fechas no nulas y válidas).
  */
@@ -1665,5 +1701,5 @@ declare function nitValidator(control: AbstractControl): ValidationErrors | null
  */
 declare function cuiValidator(control: AbstractControl): ValidationErrors | null;
 
-export { AlertaService, AppMessageErrorComponent, AuthorizeService, CACHE_KEYS, CacheService, CssV2Component, DsxAddToolsModule, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, INITIAL_PARAMETERS, IconDsxComponent, JsonHighlightPipe, JsonValuesDebujComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, NavbarDsxComponent, OnlyRangoPatternDirective, ParameterValuesService, PrimeNgModule, SWEET_ALERT_THEMES, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, TruncatePipe, UtilityAddService, atLeastOneFieldRequiredValidator, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, httpAuthorizeInterceptor, nitValidator, provideEnvironment, validateEnvironmentConfig };
+export { AlertaService, AppMessageErrorComponent, AuthorizeService, CACHE_KEYS, CacheService, CssV2Component, DsxAddToolsModule, DteService, ENVIRONMENT, EndpointService, ErrorHandlerService, FileComponent, GTQFormatter, INITIAL_PARAMETERS, IconDsxComponent, JsonHighlightPipe, JsonValuesDebujComponent, KpicardComponent, LoadingComponent, LoadingLottieComponent, NavbarDsxComponent, OnlyRangoPatternDirective, ParameterValuesService, PrimeNgModule, SWEET_ALERT_THEMES, SecurityService, SelectAllOnFocusDirective, SpinnerLoadingService, TruncatePipe, UtilityAddService, atLeastOneFieldRequiredValidator, createCurrencyFormatter, createInitialCache, createTypedCacheProvider, cuiValidator, dateMinMaxValidator, dateRangeValidator, dateRangeValidatorFromTo, httpAuthorizeInterceptor, nitValidator, provideEnvironment, validateEnvironmentConfig };
 export type { Certificacion, Column, Complemento, Complementos, DatosEmision, DatosGenerales, Direccion, DocumentoFelResponse, Dte, Emisor, EnvironmentConfig, ExportColumn, FechasConversion, FieldConfig, FilterOption, Frase, Frases, Impuesto, Impuestos, InferCacheKeyType, InferCacheOptions, Item, Items, MyParameterValues, NITResponse, NumeroAutorizacion, ParameterSecurity, ParameterValue, Receptor, ResponseHttpModel, Sat, SeguridadITParameter, ServiceResult, ServiceResultVoid, SweetAlertThemeType, T, TipoFechaConversion, TotalImpuesto, Totales, typeModel };