turbogui-angular 20.1.0 → 20.3.0

package/fesm2022/turbogui-angular.mjs

@@ -22,7 +22,7 @@ import { MatFormFieldModule } from '@angular/material/form-field';
 import * as i4 from '@angular/material/input';
 import { MatInputModule } from '@angular/material/input';
 import * as i5 from '@angular/forms';
-import { FormsModule, Validators } from '@angular/forms';
+import { FormsModule, Validators, FormControl } from '@angular/forms';
 
 /**
  * TurboGUI is A library that helps with the most common and generic UI elements and functionalities
@@ -984,10 +984,6 @@ class DialogService extends SingletoneStrictClass {
         if (!this._isEnabled) {
             return;
         }
-        // If there are dialogs that should close on navigation and a history state was pushed, pop it
-        if (this._activeCloseableDialogs > 0 && window.history.state?.dialogOpen) {
-            history.back();
-        }
         for (const dialogRef of this._activeDialogInstances) {
             dialogRef.close({ index: -1 });
         }
@@ -1669,10 +1665,34 @@ class RouterBaseService {
     }
     /**
      * Gets the current value of the route URL synchronously.
+     * For example, if the current route is `/user/123`, it will return `/user/123`.
+     * Notice that the base URL is not included in the returned value.
      */
     getCurrentRoute() {
         return this._currentRoute.getValue();
     }
+    /**
+     * The current route title, translated using the LocalesService.
+     * This is updated automatically after each navigation event if the title manager is initialized.
+     */
+    getCurrentRouteTitle() {
+        return this._currentRouteTitle;
+    }
+    /**
+     * The current browser title, which may include prefixes or suffixes.
+     * This is updated automatically after each navigation event if the title manager is initialized.
+     */
+    getCurrentBrowserTitle() {
+        return this._currentBrowserTitle;
+    }
+    /**
+     * Gets the current value of the route absolute URL synchronously.
+     *
+     * For example, if the current route is `/user/123` and the base href is `http://example.com/app/`, it will return `http://example.com/app/user/123`.
+     */
+    getCurrentRouteAbsolute() {
+        return window.location.origin + this.getCurrentRoute();
+    }
     /**
      * Gets the value of a specific route parameter by its key from the current route.
      *
@@ -1709,6 +1729,7 @@ class RouterBaseService {
      *   { path: '', component: HomePageComponent,
      *     data: { titleKey: 'HOME',  titleBundle: 'turbodepot/user-interface'} },
      *
+     * @param localesService An instance of the LocalesService to be used for translations.
      * @param prefix A text to be added before the computed title.
      * @param sufix A text to be added after the computed title.
      */
@@ -1734,14 +1755,18 @@ class RouterBaseService {
      * @param sufix A text to be added after the computed title.
      */
     updateTitleFromCurrentRoute(prefix, sufix) {
+        this._currentRouteTitle = '';
+        this._currentBrowserTitle = '';
         let currentRoute = this.router.routerState.snapshot.root;
         while (currentRoute.firstChild) {
             currentRoute = currentRoute.firstChild;
         }
         const data = currentRoute.data;
         if (data['titleKey'] && data['titleBundle']) {
-            this.titleService.setTitle(prefix + this._localesService.t(data['titleKey'], data['titleBundle']) + sufix);
+            this._currentRouteTitle = this._localesService.t(data['titleKey'], data['titleBundle']);
         }
+        this._currentBrowserTitle = prefix + this._currentRouteTitle + sufix;
+        this.titleService.setTitle(this._currentBrowserTitle);
     }
     /**
      * Navigates to the specified route.
@@ -1751,6 +1776,12 @@ class RouterBaseService {
     navigateTo(route) {
         this.router.navigate(['/' + route]);
     }
+    /**
+     * Automatically called when the service is destroyed.
+     * We use it to clean up subscriptions and other resources.
+     *
+     * Usially not necessary to call this manually.
+     */
     ngOnDestroy() {
         this._routerSubscription?.unsubscribe();
         // Clean up BehaviorSubject
@@ -3062,6 +3093,28 @@ class ValidatorsPlus extends Validators {
             return null;
         }
     }
+    /**
+     * Validator to check that at least one of the specified form controls has a non empty value.
+     * Non empty criteria is the same as the nonEmpty validator on this same class, which verifies that the value is not semantically empty.
+     *
+     * To use this validator, you need to pass an array of control names that you want to check. And set it to the validators property
+     * of the form builder group.
+     *
+     * @param controlNames An array of control names to check. For example, ['name', 'surname'].
+     *
+     * @returns A validator function.
+     */
+    static atLeastOneIsNotEmpty(controlNames) {
+        return (control) => {
+            const formGroup = control;
+            const hasValue = controlNames.some(name => {
+                const formControl = formGroup.get(name);
+                // Check if it's a FormControl and if it's not empty
+                return formControl instanceof FormControl && ValidatorsPlus.nonEmpty(formControl) === null;
+            });
+            return hasValue ? null : { atLeastOneRequired: true };
+        };
+    }
 }
 
 /*