ngx-dsxlibrary 1.21.97 → 1.21.99

package/fesm2022/ngx-dsxlibrary.mjs

@@ -34,8 +34,10 @@ import { AccordionModule } from 'primeng/accordion';
 import { AutoCompleteModule } from 'primeng/autocomplete';
 import { AutoFocusModule } from 'primeng/autofocus';
 import { AvatarGroupModule } from 'primeng/avatargroup';
+import { BadgeModule } from 'primeng/badge';
 import { CardModule } from 'primeng/card';
 import { CheckboxModule } from 'primeng/checkbox';
+import { ContextMenuModule } from 'primeng/contextmenu';
 import { DatePickerModule } from 'primeng/datepicker';
 import { DividerModule } from 'primeng/divider';
 import { DrawerModule } from 'primeng/drawer';
@@ -46,21 +48,34 @@ import { InputIconModule } from 'primeng/inputicon';
 import { InputMaskModule } from 'primeng/inputmask';
 import { InputNumberModule } from 'primeng/inputnumber';
 import { InputTextModule } from 'primeng/inputtext';
+import { KeyFilterModule } from 'primeng/keyfilter';
+import { KnobModule } from 'primeng/knob';
 import { MessageModule } from 'primeng/message';
 import { MultiSelectModule } from 'primeng/multiselect';
+import { OrganizationChartModule } from 'primeng/organizationchart';
+import { OverlayBadgeModule } from 'primeng/overlaybadge';
 import { PanelMenuModule } from 'primeng/panelmenu';
 import { PasswordModule } from 'primeng/password';
+import { PickListModule } from 'primeng/picklist';
 import { PopoverModule } from 'primeng/popover';
 import { RadioButtonModule } from 'primeng/radiobutton';
+import { RatingModule } from 'primeng/rating';
 import { RippleModule } from 'primeng/ripple';
+import { ScrollerModule } from 'primeng/scroller';
+import { ScrollPanelModule } from 'primeng/scrollpanel';
 import { SelectModule } from 'primeng/select';
+import { SelectButtonModule } from 'primeng/selectbutton';
+import { SliderModule } from 'primeng/slider';
+import { SpeedDialModule } from 'primeng/speeddial';
 import { SplitButtonModule } from 'primeng/splitbutton';
 import { StepperModule } from 'primeng/stepper';
 import { TableModule } from 'primeng/table';
 import { TabsModule } from 'primeng/tabs';
 import { TextareaModule } from 'primeng/textarea';
+import { TimelineModule } from 'primeng/timeline';
 import { ToastModule } from 'primeng/toast';
 import { ToggleButtonModule } from 'primeng/togglebutton';
+import { TreeTableModule } from 'primeng/treetable';
 import moment from 'moment-timezone';
 
 class AppMessageErrorComponent {
@@ -869,26 +884,68 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.6", ngImpor
                 type: Input
             }] } });
 
+/**
+ * Servicio centralizado para controlar el estado de carga global.
+ *
+ * Expone una señal (`spinnerVisible`) que puede consumirse en componentes
+ * para mostrar u ocultar un spinner.
+ *
+ * Uso recomendado:
+ * - `show()` / `hide()` para flujos con múltiples operaciones concurrentes.
+ * - `showImmediate()` para feedback visual inmediato (sin afectar contador).
+ * - `reset()` para recuperar estado en errores inesperados.
+ */
 class SpinnerLoadingService {
-    // Señal para el estado de visibilidad del spinner
+    /**
+     * Señal reactiva que indica si el spinner debe mostrarse.
+     *
+     * Ejemplo:
+     * ```ts
+     * readonly isLoading = this.spinnerLoadingService.spinnerVisible;
+     * ```
+     */
     spinnerVisible = signal(false, ...(ngDevMode ? [{ debugName: "spinnerVisible" }] : /* istanbul ignore next */ []));
-    // Contador de peticiones/acciones activas
+    /**
+     * Contador interno de operaciones activas.
+     * Permite que el spinner permanezca visible mientras haya procesos en curso.
+     */
     counter = 0;
     constructor() { }
-    // Incrementa el contador y muestra el spinner sólo cuando pasa de 0 -> 1
+    /**
+     * Incrementa el contador de cargas activas.
+     *
+     * Muestra el spinner solo en la transición de `0 -> 1` para evitar
+     * renderizados redundantes cuando hay varias operaciones simultáneas.
+     *
+     * Cuándo usarlo:
+     * - Antes de iniciar una petición HTTP manual.
+     * - Antes de ejecutar una acción asíncrona larga.
+     */
     show() {
         this.counter++;
         if (this.counter === 1) {
             this.spinnerVisible.set(true);
         }
     }
-    // Muestra el spinner de forma inmediata sin afectar el contador.
-    // Útil para feedback al hacer clic en botones, dejando que el interceptor
-    // controle el inicio/fin real de las peticiones HTTP.
+    /**
+     * Muestra el spinner de forma inmediata sin modificar el contador.
+     *
+     * Cuándo usarlo:
+     * - Para feedback instantáneo en la UI (por ejemplo, al hacer clic en un botón).
+     * - Cuando otro mecanismo (ejemplo: interceptor HTTP) controlará `show()`/`hide()`.
+     */
     showImmediate() {
         this.spinnerVisible.set(true);
     }
-    // Decrementa el contador y oculta el spinner cuando llega a 0
+    /**
+     * Decrementa el contador de cargas activas.
+     *
+     * Oculta el spinner únicamente cuando el contador llega a `0`.
+     * Si se llama más veces de las debidas, el contador no baja de `0`.
+     *
+     * Cuándo usarlo:
+     * - Al finalizar una operación iniciada con `show()`.
+     */
     hide() {
         if (this.counter > 0) {
             this.counter--;
@@ -897,7 +954,12 @@ class SpinnerLoadingService {
             this.spinnerVisible.set(false);
         }
     }
-    // Por si se desincroniza el estado
+    /**
+     * Restablece el estado del servicio a su valor inicial.
+     *
+     * Fuerza `counter = 0` y oculta el spinner.
+     * Útil en escenarios de recuperación por error o al reinicializar contexto.
+     */
     reset() {
         this.counter = 0;
         this.spinnerVisible.set(false);
@@ -2863,9 +2925,11 @@ const PRIME_NG_MODULES = [
     AutoFocusModule,
     AvatarGroupModule,
     AvatarModule,
+    BadgeModule,
     ButtonModule,
     CardModule,
     CheckboxModule,
+    ContextMenuModule,
     DatePickerModule,
     DialogModule,
     DividerModule,
@@ -2879,25 +2943,38 @@ const PRIME_NG_MODULES = [
     InputMaskModule,
     InputNumberModule,
     InputTextModule,
+    KeyFilterModule,
+    KnobModule,
     MenubarModule,
     MessageModule,
     MultiSelectModule,
+    OrganizationChartModule,
+    OverlayBadgeModule,
     PanelMenuModule,
     PasswordModule,
+    PickListModule,
     PopoverModule,
     RadioButtonModule,
+    RatingModule,
     RippleModule,
+    ScrollerModule,
+    ScrollPanelModule,
+    SelectButtonModule,
     SelectModule,
+    SliderModule,
+    SpeedDialModule,
     SplitButtonModule,
     StepperModule,
     TableModule,
     TabsModule,
     TagModule,
     TextareaModule,
+    TimelineModule,
     ToastModule,
     ToggleButtonModule,
     TooltipModule,
     TreeModule,
+    TreeTableModule,
 ];
 class PrimeNgModule {
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.6", ngImport: i0, type: PrimeNgModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
@@ -2906,9 +2983,11 @@ class PrimeNgModule {
             AutoFocusModule,
             AvatarGroupModule,
             AvatarModule,
+            BadgeModule,
             ButtonModule,
             CardModule,
             CheckboxModule,
+            ContextMenuModule,
             DatePickerModule,
             DialogModule,
             DividerModule,
@@ -2922,33 +3001,48 @@ class PrimeNgModule {
             InputMaskModule,
             InputNumberModule,
             InputTextModule,
+            KeyFilterModule,
+            KnobModule,
             MenubarModule,
             MessageModule,
             MultiSelectModule,
+            OrganizationChartModule,
+            OverlayBadgeModule,
             PanelMenuModule,
             PasswordModule,
+            PickListModule,
             PopoverModule,
             RadioButtonModule,
+            RatingModule,
             RippleModule,
+            ScrollerModule,
+            ScrollPanelModule,
+            SelectButtonModule,
             SelectModule,
+            SliderModule,
+            SpeedDialModule,
             SplitButtonModule,
             StepperModule,
             TableModule,
             TabsModule,
             TagModule,
             TextareaModule,
+            TimelineModule,
             ToastModule,
             ToggleButtonModule,
             TooltipModule,
-            TreeModule] });
+            TreeModule,
+            TreeTableModule] });
     static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "21.2.6", ngImport: i0, type: PrimeNgModule, imports: [AccordionModule,
             AutoCompleteModule,
             AutoFocusModule,
             AvatarGroupModule,
             AvatarModule,
+            BadgeModule,
             ButtonModule,
             CardModule,
             CheckboxModule,
+            ContextMenuModule,
             DatePickerModule,
             DialogModule,
             DividerModule,
@@ -2962,25 +3056,38 @@ class PrimeNgModule {
             InputMaskModule,
             InputNumberModule,
             InputTextModule,
+            KeyFilterModule,
+            KnobModule,
             MenubarModule,
             MessageModule,
             MultiSelectModule,
+            OrganizationChartModule,
+            OverlayBadgeModule,
             PanelMenuModule,
             PasswordModule,
+            PickListModule,
             PopoverModule,
             RadioButtonModule,
+            RatingModule,
             RippleModule,
+            ScrollerModule,
+            ScrollPanelModule,
+            SelectButtonModule,
             SelectModule,
+            SliderModule,
+            SpeedDialModule,
             SplitButtonModule,
             StepperModule,
             TableModule,
             TabsModule,
             TagModule,
             TextareaModule,
+            TimelineModule,
             ToastModule,
             ToggleButtonModule,
             TooltipModule,
-            TreeModule] });
+            TreeModule,
+            TreeTableModule] });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.6", ngImport: i0, type: PrimeNgModule, decorators: [{
             type: NgModule,
@@ -3553,21 +3660,23 @@ class UtilityAddService {
         const fechaMoment = moment(fecha).format('YYYYMMDD');
         return fechaMoment;
     }
-    /* OPCIONES PARA FOMULARIOS REACTIVOS */
-    /**
-     * Crea un FormGroup tipado a partir de una configuración de campos.
-     *
-     * @param {FormBuilder} fb - Instancia de FormBuilder para crear el FormGroup.
-     * @param {FieldConfig<T>} config - Configuración de los campos del formulario.
-     * @param {ValidatorFn[]} groupValidators - Validadores adicionales a nivel de grupo.
-     * @returns {FormGroup} - El FormGroup creado.
-     */
-    createTypedForm(fb, config, groupValidators) {
+    createTypedForm(fb, config, groupValidatorsOrOptions, options = { disableUnassignedControls: false }) {
+        const groupValidators = Array.isArray(groupValidatorsOrOptions)
+            ? groupValidatorsOrOptions
+            : undefined;
+        const resolvedOptions = Array.isArray(groupValidatorsOrOptions)
+            ? options
+            : (groupValidatorsOrOptions ?? options);
         const formGroup = {};
         // Crear controles de formulario individuales
         for (const key in config) {
             if (Object.prototype.hasOwnProperty.call(config, key)) {
-                const { value, disabled = false, validators = [] } = config[key];
+                const fieldConfig = config[key];
+                const { value, validators = [] } = fieldConfig;
+                const hasAssignedDisabled = Object.prototype.hasOwnProperty.call(fieldConfig, 'disabled');
+                const disabled = hasAssignedDisabled
+                    ? Boolean(fieldConfig.disabled)
+                    : Boolean(resolvedOptions.disableUnassignedControls);
                 formGroup[key] = new FormControl({ value, disabled }, validators);
             }
         }
@@ -3575,41 +3684,14 @@ class UtilityAddService {
         const group = fb.group(formGroup, groupValidators ? { validators: groupValidators } : {});
         return group;
     }
-    /**
-     * Crea un ReactiveForm tipado con capacidad de suscripción y limpieza.
-     *
-     * Extiende createTypedForm() agregando un Subject (destroy$) para manejar
-     * la suscripción y limpieza automática de observables cuando el componente
-     * se destruye.
-     *
-     * @template T - El tipo genérico del modelo para el formulario.
-     * @param fb - Instancia de FormBuilder.
-     * @param config - Configuración de los campos del formulario (FieldConfig<T>).
-     * @returns ReactiveForm<T> - FormGroup tipado con Subject destroy$ para limpieza.
-     *
-     * @example
-     * ```typescript
-     * interface LoginForm {
-     *   username: string;
-     *   password: string;
-     * }
-     *
-     * const config: FieldConfig<LoginForm> = {
-     *   username: { value: '', validators: [Validators.required] },
-     *   password: { value: '', validators: [Validators.required] }
-     * };
-     *
-     * const form = this.utilityAddService.createReactiveForm(this.fb, config);
-     *
-     * // Al destruir el componente, limpiar todas las suscripciones
-     * ngOnDestroy() {
-     *   form.destroy$.next();
-     *   form.destroy$.complete();
-     * }
-     * ```
-     */
-    createReactiveForm(fb, config) {
-        const form = this.createTypedForm(fb, config);
+    createReactiveForm(fb, config, groupValidatorsOrOptions, options = { disableUnassignedControls: false }) {
+        const groupValidators = Array.isArray(groupValidatorsOrOptions)
+            ? groupValidatorsOrOptions
+            : undefined;
+        const resolvedOptions = Array.isArray(groupValidatorsOrOptions)
+            ? options
+            : (groupValidatorsOrOptions ?? options);
+        const form = this.createTypedForm(fb, config, groupValidators, resolvedOptions);
         form.destroy$ = new Subject();
         return form;
     }