turbogui-angular 19.0.0 → 19.1.0

package/fesm2022/turbogui-angular.mjs

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { EventEmitter, Output, Directive, HostListener, NgModule, inject, Injectable, Component, Inject, HostBinding, Input } from '@angular/core';
+import { EventEmitter, HostListener, Output, Directive, NgModule, inject, Injectable, Component, Inject, HostBinding, Input } from '@angular/core';
 import { Subject, BehaviorSubject } from 'rxjs';
 import { ArrayUtils, NumericUtils, HTTPManager, StringUtils, HTTPManagerGetRequest, HTTPManagerPostRequest, BrowserManager, ConversionUtils } from 'turbocommons-ts';
 import * as i1 from '@angular/material/dialog';
@@ -24,6 +24,47 @@ import { MatInputModule } from '@angular/material/input';
 import * as i5 from '@angular/forms';
 import { FormsModule, Validators } from '@angular/forms';
 
+/**
+ * TurboGUI is A library that helps with the most common and generic UI elements and functionalities
+ *
+ * Website : -> http://www.turbogui.org
+ * License : -> Licensed under the Apache License, Version 2.0. You may not use this file except in compliance with the License.
+ * License Url : -> http://www.apache.org/licenses/LICENSE-2.0
+ * CopyRight : -> Copyright 2018 Edertone Advanded Solutions. https://www.edertone.com
+ */
+/** This directive is used to trigger an event when the user clicks outside of an element */
+/**
+ * This directive is used to execute an action when the user clicks outside of an element.
+ * If we set the elementClickOutside tag to the html element and set the onClickOutside event to a function: <element elementClickOutside (onClickOutside)="onClickedOutside()" ...,
+ * this function will be executed when the user clicks outside of the element.
+ */
+class ElementClickOutsideDirective {
+    constructor(elementRef) {
+        this.elementRef = elementRef;
+        this.onClickOutside = new EventEmitter();
+    }
+    onClick(targetElement) {
+        const clickedInside = this.elementRef.nativeElement.contains(targetElement);
+        if (!clickedInside) {
+            this.onClickOutside.emit();
+        }
+    }
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: ElementClickOutsideDirective, deps: [{ token: i0.ElementRef }], target: i0.ɵɵFactoryTarget.Directive }); }
+    static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "19.2.5", type: ElementClickOutsideDirective, isStandalone: false, selector: "[elementClickOutside]", outputs: { onClickOutside: "onClickOutside" }, host: { listeners: { "document:click": "onClick($event.target)" } }, ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: ElementClickOutsideDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[elementClickOutside]',
+                    standalone: false
+                }]
+        }], ctorParameters: () => [{ type: i0.ElementRef }], propDecorators: { onClickOutside: [{
+                type: Output
+            }], onClick: [{
+                type: HostListener,
+                args: ['document:click', ['$event.target']]
+            }] } });
+
 /**
  * TurboGUI is A library that helps with the most common and generic UI elements and functionalities
  *
@@ -195,10 +236,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.5", ngImpor
  */
 class TurboGuiAngularModule {
     static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.5", ngImport: i0, type: TurboGuiAngularModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule }); }
-    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "19.2.5", ngImport: i0, type: TurboGuiAngularModule, declarations: [ElementCreatedDirective,
+    static { this.ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "19.2.5", ngImport: i0, type: TurboGuiAngularModule, declarations: [ElementClickOutsideDirective,
+            ElementCreatedDirective,
             ElementDestroyedDirective,
             AutoFocusOnDisplayDirective,
-            AutoSelectTextOnFocusDirective], exports: [ElementCreatedDirective,
+            AutoSelectTextOnFocusDirective], exports: [ElementClickOutsideDirective,
+            ElementCreatedDirective,
             ElementDestroyedDirective,
             AutoFocusOnDisplayDirective,
             AutoSelectTextOnFocusDirective] }); }
@@ -209,6 +252,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.5", ngImpor
             args: [{
                     imports: [],
                     declarations: [
+                        ElementClickOutsideDirective,
                         ElementCreatedDirective,
                         ElementDestroyedDirective,
                         AutoFocusOnDisplayDirective,
@@ -216,6 +260,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.5", ngImpor
                     ],
                     providers: [],
                     exports: [
+                        ElementClickOutsideDirective,
                         ElementCreatedDirective,
                         ElementDestroyedDirective,
                         AutoFocusOnDisplayDirective,
@@ -1777,18 +1822,19 @@ class LocalesBaseService {
         return this._missingKeyFormat;
     }
     /**
-     * Initializes the translation system by loading and parsing bundle files from the specified JSON object.
-     * After the method finishes, the class will contain all the translation data and will be ready to translate any provided key.
+     * Adds translations to the class by loading and parsing bundles from the provided JSON object.
+     * After the method finishes, the class will contain all the translation data and will be ready to translate
+     * any provided key to any of the specified locales.
      *
-     * @param translations A JSON object containing the translation data. The structure must be as follows:
-     *       { library_name: { bundle_name: { locale_code: { key1: "translation1", key2: "translation2" } } } ... }
+     * @param locales An array of locale codes (e.g., ['en_US', 'es_ES', 'fr_FR']) to load from the json data into this class.
+     *        The order of this array will determine the priority when looking for translations.
      *
-     * @param locales An array of locale codes (e.g., ['en_US', 'es_ES', 'fr_FR']) to load into this class. The order of this array
-     *        will determine the translation priority
+     * @param json A JSON object containing the translation data. The structure must be as follows:
+     *       { library_name: { bundle_name: { locale_code: { key1: "translation1", key2: "translation2" } } } ... }
      *
      * @return True if the translations get correctly loaded. Any unsuccessful initialization will throw an exception
      */
-    initializeFromJson(translations, locales) {
+    loadLocalesFromJson(locales, json) {
         this._isInitialized = false;
         // Validate received locales are correct
         for (const locale of locales) {
@@ -1796,9 +1842,9 @@ class LocalesBaseService {
         }
         // Validate the translations object follows the right structure
         let isTranslationsValid = false;
-        for (const library in translations) {
-            for (const bundle in translations[library]) {
-                for (const locale in translations[library][bundle]) {
+        for (const library in json) {
+            for (const bundle in json[library]) {
+                for (const locale in json[library][bundle]) {
                     this._validateLocaleString(locale);
                     isTranslationsValid = true;
                 }
@@ -1807,39 +1853,38 @@ class LocalesBaseService {
         if (!isTranslationsValid) {
             throw new Error('translations must be a non empty object with the structure: { library: { bundle: { xx_XX: { key: translation } } } }');
         }
-        this._loadedTranslations = translations;
+        this._loadedTranslations = json;
         this._locales = locales;
         this._languages = locales.map((l) => l.substring(0, 2));
         this._cacheHashBaseString = this._wildCardsFormat + this._missingKeyFormat + this._locales[0];
-        return this._isInitialized = true;
+        this._isInitialized = true;
+        return true;
     }
     /**
      * Initializes the translation system by loading and parsing bundle files from the specified translations path.
      * After the promise finishes, the class will contain all the translation data and will be ready to translate any
      * provided key.
      *
-     * @param translationsPath - Url where the translations Json structure of libraries/bundles/locales/keys is available.
-     * @param locales An array of locale codes (e.g., ['en_US', 'es_ES', 'fr_FR']) to load. These will be added to the translation
-     *        path using the following format: translationsPath/en_US-es_ES-fr_FR. The order of this array will determine the
-     *        translation priority
-     * @param parameters Any extra parameters to be attached to the translationsPath after the locales like /param1/param2/ etc
+     * @param locales An array of locale codes (['en_US', 'es_ES', 'fr_FR', ...]) to load from the url response.
+     *        The order of this array will determine the translation priority
+     * @param url - Url where the translations are found. The response must be a Json with the expected structure:
+     *              { library_name: { bundle_name: { locale_code: { key1: "translation1", key2: "translation2" } } } ... }
      *
      * @return A promise that will resolve if the translations get correctly loaded, or reject with an error if load fails
      */
-    initializeFromUrl(translationsPath, locales, parameters) {
+    loadLocalesFromUrl(locales, url) {
         this._isInitialized = false;
-        const translationsFullPath = translationsPath + '/' + locales.join('-') + '/' + parameters.join('/');
         return new Promise((resolve, reject) => {
-            fetch(translationsFullPath).then(response => {
+            fetch(url).then(response => {
                 if (!response.ok) {
                     throw new Error(`HTTP error! status: ${response.status}`);
                 }
                 return response.json();
             }).then(data => {
-                this.initializeFromJson(data, locales);
+                this.loadLocalesFromJson(locales, data);
                 resolve(undefined);
             }).catch(error => {
-                reject(new Error(`ERROR LOADING LOCALES FROM: ${translationsFullPath}\n` + error));
+                reject(new Error(`ERROR LOADING LOCALES FROM: ${url}\n` + error));
             });
         });
     }
@@ -2940,5 +2985,5 @@ class ValidatorsPlus extends Validators {
  * Generated bundle index. Do not edit.
  */
 
-export { AutoFocusOnDisplayDirective, AutoSelectTextOnFocusDirective, BrowserService, BusyStateBaseComponent, ButtonContainerComponent, ButtonImageComponent, DelayedMethodCallManager, DialogBaseComponent, DialogDateSelectionComponent, DialogErrorComponent, DialogMultipleOptionComponent, DialogService, DialogSingleInputComponent, DialogSingleOptionComponent, DialogSingleSelectionListComponent, DialogTwoOptionComponent, ElementCreatedDirective, ElementDestroyedDirective, FadeAnimationClass, GUINotification, GlobalErrorService, HTTPService, HTTPServiceGetRequest, HTTPServicePostRequest, LocalesBaseService, NotificationService, RouterBaseService, SingletoneStrictClass, TurboApiCallerService, TurboGuiAngularModule, ValidatorsPlus, View, ViewService };
+export { AutoFocusOnDisplayDirective, AutoSelectTextOnFocusDirective, BrowserService, BusyStateBaseComponent, ButtonContainerComponent, ButtonImageComponent, DelayedMethodCallManager, DialogBaseComponent, DialogDateSelectionComponent, DialogErrorComponent, DialogMultipleOptionComponent, DialogService, DialogSingleInputComponent, DialogSingleOptionComponent, DialogSingleSelectionListComponent, DialogTwoOptionComponent, ElementClickOutsideDirective, ElementCreatedDirective, ElementDestroyedDirective, FadeAnimationClass, GUINotification, GlobalErrorService, HTTPService, HTTPServiceGetRequest, HTTPServicePostRequest, LocalesBaseService, NotificationService, RouterBaseService, SingletoneStrictClass, TurboApiCallerService, TurboGuiAngularModule, ValidatorsPlus, View, ViewService };
 //# sourceMappingURL=turbogui-angular.mjs.map