ngx-dsxlibrary 1.21.37 → 1.21.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ngx-dsxlibrary",
-  "version": "1.21.37",
+  "version": "1.21.39",
   "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

@@ -183,17 +183,20 @@ declare class NavbarDsxComponent implements OnInit {
  * - Dígitos (0-9)
  * - Separadores punto (.)
  * - Rango con guión (-)
+ * - O bien un comodín completo "*" que representa "todos"
  *
  * Ejemplos válidos:
  * - 1.2.3
  * - 4-6
  * - 1.3.5-9
+ * - *  (comodín: todos)
  *
  * Restringe:
  * - Letras
  * - Espacios
- * - Caracteres especiales
+ * - Caracteres especiales (salvo "*")
  * - Doble punto (..), doble guión (--), o combinaciones como (.-)
+ * - Mezclas de comodín con números (por ejemplo: *1, 1.*)
  */
 declare class OnlyRangoPatternDirective {
     private el;
@@ -1553,7 +1556,10 @@ declare class UtilityAddService {
      * Adaptador para procesar eventos de input y extraer rangos numéricos.
      *
      * @param event - Objeto Event del DOM, preferiblemente de un elemento input
-     * @returns Array de números generado a partir del valor del input
+     * @returns
+     *   - Array de números generado a partir del valor del input, cuando hay
+     *     números/rangos.
+     *   - El carácter comodín "*" cuando el valor del input es exactamente "*".
      *
      * @example
      * // Uso en template Angular
@@ -1573,7 +1579,7 @@ declare class UtilityAddService {
      * Requiere que el evento tenga la propiedad target.value (standard DOM)
      * Para otros tipos de eventos (ej. Angular Material) puede necesitar ajustes
      */
-    processNumericRangesFromEvent(event: Event): number[];
+    processNumericRangesFromEvent(event: Event): number[] | '*';
     /**
      * Maneja la respuesta estándar de una operación HTTP, mostrando alertas y realizando acciones comunes en formularios.
      *
@@ -1606,6 +1612,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).
  */
@@ -1659,5 +1698,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 };