turbogui-angular 20.0.0 → 20.2.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
@@ -1669,10 +1669,40 @@ 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();
     }
+    /**
+     * 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.
+     *
+     * For example, if the current route is `/user/123`, and you call this method with `key` as `id`, it will return `123`.
+     * The name of the parameter must match the one defined in the route configuration on your application (e.g., `{ path: 'user/:id', component: UserComponent }`).
+     *
+     * @param key The key of the route parameter to retrieve.
+     *
+     * @returns The value of the specified route parameter, or undefined if it does not exist.
+     */
+    getCurrentRouteParamValue(key) {
+        let currentRoute = this.router.routerState.snapshot.root;
+        while (currentRoute.firstChild) {
+            currentRoute = currentRoute.firstChild;
+        }
+        if (!(key in currentRoute.params)) {
+            throw new Error(`Route parameter '${key}' does not exist.`);
+        }
+        return currentRoute.params[key];
+    }
     /**
      * Initializes the title management feature to automatically refresh the browser title based on the current
      * URL route. It Must be called once, typically at application startup
@@ -3042,6 +3072,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 };
+        };
+    }
 }
 
 /*