@cedx/base 0.29.0 → 0.30.0

package/ReadMe.md

@@ -1,5 +1,5 @@
 # Cédric Belin's Base
-![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![Version](https://badgen.net/badge/project/v0.29.0/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.30.0/blue) ![Licence](https://badgen.net/badge/licence/MIT/blue)
 
 Base library by [Cédric Belin](https://cedric-belin.fr), full stack developer,
 implemented in [C#](https://learn.microsoft.com/en-us/dotnet/csharp) and [TypeScript](https://www.typescriptlang.org).

package/lib/TimeSpan.d.ts

@@ -9,7 +9,7 @@ export declare const TimeSpan: Readonly<{
     /**
      * The number of minutes in 1 day.
      */
-    MinutesPerDay: 1440;
+    MinutesPerDay: number;
     /**
      * The number of minutes in 1 hour.
      */
@@ -17,11 +17,11 @@ export declare const TimeSpan: Readonly<{
     /**
      * The number of seconds in 1 day.
      */
-    SecondsPerDay: 86400;
+    SecondsPerDay: number;
     /**
      * The number of seconds in 1 hour.
      */
-    SecondsPerHour: 3600;
+    SecondsPerHour: number;
     /**
      * The number of seconds in 1 minute.
      */
@@ -29,15 +29,15 @@ export declare const TimeSpan: Readonly<{
     /**
      * The number of milliseconds in 1 day.
      */
-    MillisecondsPerDay: 86400000;
+    MillisecondsPerDay: number;
     /**
      * The number of milliseconds in 1 hour.
      */
-    MillisecondsPerHour: 3600000;
+    MillisecondsPerHour: number;
     /**
      * The number of milliseconds in 1 minute.
      */
-    MillisecondsPerMinute: 60000;
+    MillisecondsPerMinute: number;
     /**
      * The number of milliseconds in 1 second.
      */

package/lib/TimeSpan.js

@@ -9,7 +9,7 @@ export const TimeSpan = Object.freeze({
     /**
      * The number of minutes in 1 day.
      */
-    MinutesPerDay: 1_440,
+    MinutesPerDay: 24 * 60,
     /**
      * The number of minutes in 1 hour.
      */
@@ -17,11 +17,11 @@ export const TimeSpan = Object.freeze({
     /**
      * The number of seconds in 1 day.
      */
-    SecondsPerDay: 86_400,
+    SecondsPerDay: 24 * 60 * 60,
     /**
      * The number of seconds in 1 hour.
      */
-    SecondsPerHour: 3_600,
+    SecondsPerHour: 60 * 60,
     /**
      * The number of seconds in 1 minute.
      */
@@ -29,15 +29,15 @@ export const TimeSpan = Object.freeze({
     /**
      * The number of milliseconds in 1 day.
      */
-    MillisecondsPerDay: 86_400_000,
+    MillisecondsPerDay: 24 * 60 * 60 * 1_000,
     /**
      * The number of milliseconds in 1 hour.
      */
-    MillisecondsPerHour: 3_600_000,
+    MillisecondsPerHour: 60 * 60 * 1_000,
     /**
      * The number of milliseconds in 1 minute.
      */
-    MillisecondsPerMinute: 60_000,
+    MillisecondsPerMinute: 60 * 1_000,
     /**
      * The number of milliseconds in 1 second.
      */

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

@@ -23,6 +23,16 @@ export declare class ThemeDropdown extends HTMLElement {
      */
     get appTheme(): AppTheme;
     set appTheme(value: AppTheme);
+    /**
+     * Value indicating whether to store the application theme in a cookie.
+     */
+    get cookie(): boolean;
+    set cookie(value: boolean);
+    /**
+     * The URI for which the associated cookie is valid.
+     */
+    get cookieDomain(): string;
+    set cookieDomain(value: string);
     /**
      * The label of the dropdown menu.
      */
@@ -46,8 +56,9 @@ export declare class ThemeDropdown extends HTMLElement {
     close(): void;
     /**
      * Method invoked when this component is connected.
+     * @returns Completes when this component has been connected.
      */
-    connectedCallback(): void;
+    connectedCallback(): Promise<void>;
     /**
      * Method invoked when this component is disconnected.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"ThemeDropdown.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/ThemeDropdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAC,QAAQ,EAAU,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAE7C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAAsC;IAYxE;;OAEG;;IAcH;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAGzB;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,SAAS,EAE7B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAGvB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAE3B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAGlB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAGvB;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,EAE3B;IAED;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,GAAG,IAAI;IAS/F;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAQzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAK5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,IAAI,IAAI,IAAI;CAgDZ;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,gBAAgB,EAAE,aAAa,CAAC;KAChC;CACD"}
+{"version":3,"file":"ThemeDropdown.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/ThemeDropdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAC,QAAQ,EAAU,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAE7C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAAsC;IAYxE;;OAEG;;IAcH;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAGzB;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,SAAS,EAE7B;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAGvB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAE3B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAExB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAGlB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAGvB;IACD,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,EAE3B;IAED;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,GAAG,IAAI;IAS/F;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYxC;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAK5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,IAAI,IAAI,IAAI;CAwDZ;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,gBAAgB,EAAE,aAAa,CAAC;KAChC;CACD"}

package/lib/UI/Components/ThemeDropdown.js

@@ -51,6 +51,24 @@ export class ThemeDropdown extends HTMLElement {
     set appTheme(value) {
         this.setAttribute("apptheme", value);
     }
+    /**
+     * Value indicating whether to store the application theme in a cookie.
+     */
+    get cookie() {
+        return this.hasAttribute("cookie");
+    }
+    set cookie(value) {
+        this.toggleAttribute("cookie", value);
+    }
+    /**
+     * The URI for which the associated cookie is valid.
+     */
+    get cookieDomain() {
+        return (this.getAttribute("cookiedomain") ?? "").trim();
+    }
+    set cookieDomain(value) {
+        this.setAttribute("cookiedomain", value);
+    }
     /**
      * The label of the dropdown menu.
      */
@@ -100,13 +118,19 @@ export class ThemeDropdown extends HTMLElement {
     }
     /**
      * Method invoked when this component is connected.
+     * @returns Completes when this component has been connected.
      */
-    connectedCallback() {
-        const appTheme = localStorage.getItem(this.storageKey);
-        if (appTheme)
-            this.appTheme = appTheme;
+    async connectedCallback() {
         this.#dropdown = new Dropdown(this.querySelector(".dropdown-toggle"));
         this.#mediaQuery.addEventListener("change", this.#applyToDocument);
+        const cookie = this.cookie ? await cookieStore.get(this.storageKey) : null;
+        if (cookie)
+            this.appTheme = cookie.value;
+        else {
+            const storage = localStorage.getItem(this.storageKey);
+            if (storage)
+                this.appTheme = storage;
+        }
     }
     /**
      * Method invoked when this component is disconnected.
@@ -125,7 +149,15 @@ export class ThemeDropdown extends HTMLElement {
      * Saves the current application theme into the local storage.
      */
     save() {
-        localStorage.setItem(this.storageKey, this.appTheme);
+        const { appTheme, cookieDomain } = this;
+        localStorage.setItem(this.storageKey, appTheme);
+        if (this.cookie)
+            void cookieStore.set({
+                domain: cookieDomain ? cookieDomain : null,
+                expires: Date.now() + (365 * 24 * 60 * 60 * 1_000),
+                name: this.storageKey,
+                value: appTheme
+            });
     }
     /**
      * Applies the application theme to the document.

package/package.json

@@ -7,13 +7,13 @@
 	"name": "@cedx/base",
 	"repository": "cedx/base",
 	"type": "module",
-	"version": "0.29.0",
+	"version": "0.30.0",
 	"devDependencies": {
 		"@playwright/browser-chromium": "^1.55.0",
 		"@types/bootstrap": "^5.2.10",
 		"@types/chai": "^5.2.2",
 		"@types/mocha": "^10.0.10",
-		"@types/node": "^24.3.0",
+		"@types/node": "^24.3.1",
 		"@types/serve-handler": "^6.1.4",
 		"chai": "^6.0.1",
 		"esbuild": "^0.25.9",

package/src/Client/TimeSpan.ts

@@ -11,7 +11,7 @@ export const TimeSpan = Object.freeze({
 	/**
 	 * The number of minutes in 1 day.
 	 */
-	MinutesPerDay: 1_440,
+	MinutesPerDay: 24 * 60,
 
 	/**
 	 * The number of minutes in 1 hour.
@@ -21,12 +21,12 @@ export const TimeSpan = Object.freeze({
 	/**
 	 * The number of seconds in 1 day.
 	 */
-	SecondsPerDay: 86_400,
+	SecondsPerDay: 24 * 60 * 60,
 
 	/**
 	 * The number of seconds in 1 hour.
 	 */
-	SecondsPerHour: 3_600,
+	SecondsPerHour: 60 * 60,
 
 	/**
 	 * The number of seconds in 1 minute.
@@ -36,17 +36,17 @@ export const TimeSpan = Object.freeze({
 	/**
 	 * The number of milliseconds in 1 day.
 	 */
-	MillisecondsPerDay: 86_400_000,
+	MillisecondsPerDay: 24 * 60 * 60 * 1_000,
 
 	/**
 	 * The number of milliseconds in 1 hour.
 	 */
-	MillisecondsPerHour: 3_600_000,
+	MillisecondsPerHour: 60 * 60 * 1_000,
 
 	/**
 	 * The number of milliseconds in 1 minute.
 	 */
-	MillisecondsPerMinute: 60_000,
+	MillisecondsPerMinute: 60 * 1_000,
 
 	/**
 	 * The number of milliseconds in 1 second.

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

@@ -60,6 +60,26 @@ export class ThemeDropdown extends HTMLElement {
 		this.setAttribute("apptheme", value);
 	}
 
+	/**
+	 * Value indicating whether to store the application theme in a cookie.
+	 */
+	get cookie(): boolean {
+		return this.hasAttribute("cookie");
+	}
+	set cookie(value: boolean) {
+		this.toggleAttribute("cookie", value);
+	}
+
+	/**
+	 * The URI for which the associated cookie is valid.
+	 */
+	get cookieDomain(): string {
+		return (this.getAttribute("cookiedomain") ?? "").trim();
+	}
+	set cookieDomain(value: string) {
+		this.setAttribute("cookiedomain", value);
+	}
+
 	/**
 	 * The label of the dropdown menu.
 	 */
@@ -106,13 +126,18 @@ export class ThemeDropdown extends HTMLElement {
 
 	/**
 	 * Method invoked when this component is connected.
+	 * @returns Completes when this component has been connected.
 	 */
-	connectedCallback(): void {
-		const appTheme = localStorage.getItem(this.storageKey) as AppTheme|null;
-		if (appTheme) this.appTheme = appTheme;
-
+	async connectedCallback(): Promise<void> {
 		this.#dropdown = new Dropdown(this.querySelector(".dropdown-toggle")!);
 		this.#mediaQuery.addEventListener("change", this.#applyToDocument);
+
+		const cookie = this.cookie ? await cookieStore.get(this.storageKey) : null;
+		if (cookie) this.appTheme = cookie.value as AppTheme;
+		else {
+			const storage = localStorage.getItem(this.storageKey);
+			if (storage) this.appTheme = storage as AppTheme;
+		}
 	}
 
 	/**
@@ -134,7 +159,15 @@ export class ThemeDropdown extends HTMLElement {
 	 * Saves the current application theme into the local storage.
 	 */
 	save(): void {
-		localStorage.setItem(this.storageKey, this.appTheme);
+		const {appTheme, cookieDomain} = this;
+		localStorage.setItem(this.storageKey, appTheme);
+
+		if (this.cookie) void cookieStore.set({
+			domain: cookieDomain ? cookieDomain : null,
+			expires: Date.now() + (365 * 24 * 60 * 60 * 1_000),
+			name: this.storageKey,
+			value: appTheme
+		});
 	}
 
 	/**