ngx-dsxlibrary 1.21.98 → 2.21.0

package/fesm2022/ngx-dsxlibrary.mjs

@@ -884,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--;
@@ -912,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);
@@ -3613,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);
             }
         }
@@ -3635,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;
     }