turbogui-angular 20.2.0 → 20.4.0

package/fesm2022/turbogui-angular.mjs

@@ -943,19 +943,14 @@ class DialogService extends SingletoneStrictClass {
      * Show a dialog with a calendar to let the user pick a date.
      *
      * @param properties An object containing the different visual and textual options that this dialog allows:
-     *            - id: The html unique identifier that the dialog will have once created. If not specified, no id will be explicitly set
-     *            - width: Specify the css value for the default dialog width. As the dialog is responsive, the value will be automatically
-     *              reduced if the available screen is not enough, and will reach the desired value otherwise. We can set any css unit like pixels,
-     *              %, vh, vw, or any other. For example: '400px', '50%', etc.
-     *            - maxWidth: Defines the maximum width that the dialog will have regarding the viewport. We can specify it in % or vw, just like is done in
-     *              css. By default it is defined as 96vw, which will fit 96% of the viewport on small devices
-     *            - height: TODO docs
-     *            - maxHeight: TODO docs
-     *            - modal: True (default) if selecting an option is mandatory to close the dialog, false if the dialog can be closed
-     *              by the user clicking outside it
-     *            - title: An optional dialog title
-     *            - viewContainerRef: This is important to propagate providers from a parent component to this dialog. We must specify
-     *              this reference to make sure the same services injected on the parent are available too at the child dialog
+     *            - id: see addDialog() docs
+     *            - width: see addDialog() docs
+     *            - maxWidth: see addDialog() docs
+     *            - height: see addDialog() docs
+     *            - maxHeight: see addDialog() docs
+     *            - modal: see addDialog() docs
+     *            - title: see addDialog() docs
+     *            - viewContainerRef: see addDialog() docs
      *
      * @returns A Promise that resolves to a Date() object selected by the user or null if no selection was made
      */
@@ -975,6 +970,44 @@ class DialogService extends SingletoneStrictClass {
         });
         return selection.index === -1 ? null : selection.value;
     }
+    /**
+     * Show a dialog with an error message and a single option button to close it.
+     *
+     * This method is a shortcut for addDialog() method using DialogErrorComponent as the dialog component class
+     *
+     * @param properties An object containing the different visual and textual options that this dialog allows:
+     *            - title (mandatory): The dialog title
+     *            - option (mandatory): The text to place on the single option button
+     *            - description: An optional description text to show below the title
+     *            - id: see addDialog() docs
+     *            - width: see addDialog() docs
+     *            - maxWidth: see addDialog() docs
+     *            - height: see addDialog() docs
+     *            - maxHeight: see addDialog() docs
+     *            - modal: see addDialog() docs
+     *            - dialogErrorComponentClass: A custom component class to use instead of the default DialogErrorComponent. This custom component must extend DialogErrorComponent
+     *
+     * @returns A Promise that resolves once the user selects the button with the option caption
+     */
+    async addErrorDialog(properties) {
+        if (this._isEnabled) {
+            let texts = [properties.title];
+            if (properties.description && properties.description !== undefined) {
+                texts.push(properties.description);
+            }
+            await this.addDialog(properties.dialogErrorComponentClass ?? DialogErrorComponent, {
+                id: properties.id ?? undefined,
+                width: properties.width ?? "70%",
+                maxWidth: properties.maxWidth ?? "500px",
+                height: properties.height ?? "auto",
+                maxHeight: properties.maxHeight ?? "92vw",
+                modal: properties.modal ?? false,
+                texts: texts,
+                options: [properties.option]
+            });
+        }
+        return null;
+    }
     /**
      * Force the removal of all the dialogs that are currently visible.
      *
@@ -984,10 +1017,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 });
         }
@@ -1675,6 +1704,20 @@ class RouterBaseService {
     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.
      *
@@ -1719,6 +1762,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.
      */
@@ -1744,14 +1788,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.
@@ -1761,6 +1809,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