@cedx/base 0.14.1 → 0.15.0

package/ReadMe.md

@@ -1,5 +1,5 @@
 # Belin.io Base
-![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![Version](https://badgen.net/badge/project/v0.14.1/blue) ![Licence](https://badgen.net/badge/licence/MIT/blue)
+![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![Version](https://badgen.net/badge/project/v0.15.0/blue) ![Licence](https://badgen.net/badge/licence/MIT/blue)
 
 Base library by [Cédric Belin](https://belin.io), full stack developer,
 implemented in [C#](https://learn.microsoft.com/en-us/dotnet/csharp) and [TypeScript](https://www.typescriptlang.org).

package/lib/UI/Components/LoadingIndicator.d.ts

@@ -4,16 +4,16 @@
 export declare class LoadingIndicator extends HTMLElement {
     #private;
     /**
-     * Starts the loading indicator.
+     * Hides the loading indicator.
+     * @param options Value indicating whether to force the loading indicator to hide.
      */
-    start(): void;
-    /**
-     * Stops the loading indicator.
-     * @param options Value indicating whether to force the loading indicator to stop.
-     */
-    stop(options?: {
+    hide(options?: {
         force?: boolean;
     }): void;
+    /**
+     * Shows the loading indicator.
+     */
+    show(): void;
 }
 /**
  * Declaration merging.

package/lib/UI/Components/LoadingIndicator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoadingIndicator.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/LoadingIndicator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;;IAchD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,IAAI,CAAC,OAAO,GAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAM,GAAG,IAAI;CAO3C;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,mBAAmB,EAAE,gBAAgB,CAAC;KACtC;CACD"}
+{"version":3,"file":"LoadingIndicator.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/LoadingIndicator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;;IAchD;;;OAGG;IACH,IAAI,CAAC,OAAO,GAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAM,GAAG,IAAI;IAQ3C;;OAEG;IACH,IAAI,IAAI,IAAI;CAIZ;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,mBAAmB,EAAE,gBAAgB,CAAC;KACtC;CACD"}

package/lib/UI/Components/LoadingIndicator.js

@@ -13,21 +13,21 @@ export class LoadingIndicator extends HTMLElement {
         customElements.define("loading-indicator", this);
     }
     /**
-     * Starts the loading indicator.
+     * Hides the loading indicator.
+     * @param options Value indicating whether to force the loading indicator to hide.
      */
-    start() {
-        this.#requestCount++;
-        this.hidden = false;
-    }
-    /**
-     * Stops the loading indicator.
-     * @param options Value indicating whether to force the loading indicator to stop.
-     */
-    stop(options = {}) {
+    hide(options = {}) {
         this.#requestCount--;
         if (this.#requestCount <= 0 || options.force) {
             this.#requestCount = 0;
             this.hidden = true;
         }
     }
+    /**
+     * Shows the loading indicator.
+     */
+    show() {
+        this.#requestCount++;
+        this.hidden = false;
+    }
 }

package/lib/UI/Components/Toast.d.ts

@@ -14,7 +14,7 @@ export declare class Toast extends HTMLElement {
     get animation(): boolean;
     set animation(value: boolean);
     /**
-     * Value indicating whether to automatically hide the toast.
+     * Value indicating whether to automatically hide this toast.
      */
     get autoHide(): boolean;
     set autoHide(value: boolean);
@@ -38,7 +38,7 @@ export declare class Toast extends HTMLElement {
     get culture(): Intl.Locale;
     set culture(value: Intl.Locale);
     /**
-     * The delay, in milliseconds, to hide the toast.
+     * The delay, in milliseconds, to hide this toast.
      */
     get delay(): number;
     set delay(value: number);
@@ -51,6 +51,11 @@ export declare class Toast extends HTMLElement {
      */
     get icon(): string;
     set icon(value: string);
+    /**
+     * Value indicating whether to initially show this toast.
+     */
+    get open(): boolean;
+    set open(value: boolean);
     /**
      * Method invoked when an attribute has been changed.
      * @param attribute The attribute name.

package/lib/UI/Components/Toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/Toast.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAiB,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;;IAErC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAA6C;IAkC/E;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAG3B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAG1B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAExB;IAED;;OAEG;IACH,IAAI,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAEvC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAGrB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAGzB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAE7B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAGlB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAGjB;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAErB;IAED;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,GAAG,IAAI;IAkB/F;;OAEG;IACH,iBAAiB,IAAI,IAAI;IASzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAK5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,IAAI,IAAI,IAAI;CA+DZ;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,cAAc,EAAE,KAAK,CAAC;KACtB;CACD"}
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/Toast.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAiB,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,qBAAa,KAAM,SAAQ,WAAW;;IAErC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAAqD;IAkCvF;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,OAAO,EAG3B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,OAAO,EAG1B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,MAAM,EAExB;IAED;;OAEG;IACH,IAAI,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAEvC;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAGrB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAGzB;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAE7B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAGlB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAGjB;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,OAAO,CAElB;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAGtB;IAED;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,GAAG,IAAI;IAoB/F;;OAEG;IACH,iBAAiB,IAAI,IAAI;IASzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAK5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,IAAI,IAAI,IAAI;CA2EZ;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,cAAc,EAAE,KAAK,CAAC;KACtB;CACD"}

package/lib/UI/Components/Toast.js

@@ -7,7 +7,7 @@ export class Toast extends HTMLElement {
     /**
      * The list of observed attributes.
      */
-    static observedAttributes = ["caption", "context", "culture", "icon"];
+    static observedAttributes = ["caption", "context", "culture", "icon", "open"];
     /**
      * The time units.
      */
@@ -47,7 +47,7 @@ export class Toast extends HTMLElement {
             this.removeAttribute("animation");
     }
     /**
-     * Value indicating whether to automatically hide the toast.
+     * Value indicating whether to automatically hide this toast.
      */
     get autoHide() {
         return this.hasAttribute("autohide");
@@ -94,7 +94,7 @@ export class Toast extends HTMLElement {
         this.setAttribute("culture", value.toString());
     }
     /**
-     * The delay, in milliseconds, to hide the toast.
+     * The delay, in milliseconds, to hide this toast.
      */
     get delay() {
         const value = Number(this.getAttribute("delay"));
@@ -119,6 +119,18 @@ export class Toast extends HTMLElement {
     set icon(value) {
         this.setAttribute("icon", value);
     }
+    /**
+     * Value indicating whether to initially show this toast.
+     */
+    get open() {
+        return this.hasAttribute("open");
+    }
+    set open(value) {
+        if (value)
+            this.setAttribute("open", "");
+        else
+            this.removeAttribute("open");
+    }
     /**
      * Method invoked when an attribute has been changed.
      * @param attribute The attribute name.
@@ -140,6 +152,8 @@ export class Toast extends HTMLElement {
                 case "icon":
                     this.#updateIcon(newValue ?? "");
                     break;
+                case "open":
+                    this.#updateVisibility();
                 // No default
             }
     }
@@ -223,4 +237,17 @@ export class Toast extends HTMLElement {
     #updateIcon(value) {
         this.querySelector(".toast-header .icon").textContent = value.trim() || getIcon(this.context);
     }
+    /**
+     * Updates the toast visibility.
+     */
+    #updateVisibility() {
+        const { classList } = this.firstElementChild;
+        if (!this.open)
+            classList.remove("show");
+        else {
+            if (this.animation)
+                classList.add("fade");
+            classList.add("show");
+        }
+    }
 }

package/lib/UI/Components/Toaster.js

@@ -123,7 +123,7 @@ export class Toaster extends HTMLElement {
     show(toast) {
         const item = document.createElement("toaster-item");
         item.addEventListener("hidden.bs.toast", () => item.remove());
-        item.appendChild(this.#toastTemplate.cloneNode(true).querySelector(".toast"));
+        item.appendChild(this.#toastTemplate.cloneNode(true).firstElementChild);
         item.animation = toast.animation ?? this.animation;
         item.autoHide = toast.autoHide ?? this.autoHide;
         item.caption = toast.caption;

package/package.json

@@ -7,7 +7,7 @@
 	"name": "@cedx/base",
 	"repository": "cedx/base",
 	"type": "module",
-	"version": "0.14.1",
+	"version": "0.15.0",
 	"devDependencies": {
 		"@playwright/browser-chromium": "^1.55.0",
 		"@types/bootstrap": "^5.2.10",

package/src/Client/UI/Components/LoadingIndicator.ts

@@ -16,24 +16,24 @@ export class LoadingIndicator extends HTMLElement {
 	}
 
 	/**
-	 * Starts the loading indicator.
+	 * Hides the loading indicator.
+	 * @param options Value indicating whether to force the loading indicator to hide.
 	 */
-	start(): void {
-		this.#requestCount++;
-		this.hidden = false;
-	}
-
-	/**
-	 * Stops the loading indicator.
-	 * @param options Value indicating whether to force the loading indicator to stop.
-	 */
-	stop(options: {force?: boolean} = {}): void {
+	hide(options: {force?: boolean} = {}): void {
 		this.#requestCount--;
 		if (this.#requestCount <= 0 || options.force) {
 			this.#requestCount = 0;
 			this.hidden = true;
 		}
 	}
+
+	/**
+	 * Shows the loading indicator.
+	 */
+	show(): void {
+		this.#requestCount++;
+		this.hidden = false;
+	}
 }
 
 /**

package/src/Client/UI/Components/Toast.ts

@@ -9,7 +9,7 @@ export class Toast extends HTMLElement {
 	/**
 	 * The list of observed attributes.
 	 */
-	static readonly observedAttributes = ["caption", "context", "culture", "icon"];
+	static readonly observedAttributes = ["caption", "context", "culture", "icon", "open"];
 
 	/**
 	 * The time units.
@@ -55,7 +55,7 @@ export class Toast extends HTMLElement {
 	}
 
 	/**
-	 * Value indicating whether to automatically hide the toast.
+	 * Value indicating whether to automatically hide this toast.
 	 */
 	get autoHide(): boolean {
 		return this.hasAttribute("autohide");
@@ -105,7 +105,7 @@ export class Toast extends HTMLElement {
 	}
 
 	/**
-	 * The delay, in milliseconds, to hide the toast.
+	 * The delay, in milliseconds, to hide this toast.
 	 */
 	get delay(): number {
 		const value = Number(this.getAttribute("delay"));
@@ -133,6 +133,17 @@ export class Toast extends HTMLElement {
 		this.setAttribute("icon", value);
 	}
 
+	/**
+	 * Value indicating whether to initially show this toast.
+	 */
+	get open(): boolean {
+		return this.hasAttribute("open");
+	}
+	set open(value: boolean) {
+		if (value) this.setAttribute("open", "");
+		else this.removeAttribute("open");
+	}
+
 	/**
 	 * Method invoked when an attribute has been changed.
 	 * @param attribute The attribute name.
@@ -153,6 +164,8 @@ export class Toast extends HTMLElement {
 			case "icon":
 				this.#updateIcon(newValue ?? "");
 				break;
+			case "open":
+				this.#updateVisibility();
 			// No default
 		}
 	}
@@ -250,6 +263,18 @@ export class Toast extends HTMLElement {
 	#updateIcon(value: string): void {
 		this.querySelector(".toast-header .icon")!.textContent = value.trim() || getIcon(this.context);
 	}
+
+	/**
+	 * Updates the toast visibility.
+	 */
+	#updateVisibility(): void {
+		const {classList} = this.firstElementChild!;
+		if (!this.open) classList.remove("show");
+		else {
+			if (this.animation) classList.add("fade");
+			classList.add("show");
+		}
+	}
 }
 
 /**

package/src/Client/UI/Components/Toaster.ts

@@ -178,7 +178,7 @@ export class Toaster extends HTMLElement {
 	show(toast: IToast): void {
 		const item = document.createElement("toaster-item");
 		item.addEventListener("hidden.bs.toast", () => item.remove());
-		item.appendChild((this.#toastTemplate.cloneNode(true) as DocumentFragment).querySelector(".toast")!);
+		item.appendChild((this.#toastTemplate.cloneNode(true) as DocumentFragment).firstElementChild!);
 
 		item.animation = toast.animation ?? this.animation;
 		item.autoHide = toast.autoHide ?? this.autoHide;