@cedx/base 0.26.0 → 0.28.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.26.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.28.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/Date.d.ts

@@ -52,6 +52,11 @@ export declare function isHoliday(date: Date): boolean;
  * @returns `true` if the specified date is a working day, otherwise `false`.
  */
 export declare function isWorkingDay(date: Date): boolean;
+/**
+ * Gets the current date.
+ * @returns The current date.
+ */
+export declare function today(): Date;
 /**
  * Converts the specified date to an ISO 8601 week.
  * @param date The date to convert.

package/lib/Date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Date.d.ts","sourceRoot":"","sources":["../src/Client/Date.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAc1C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,CAqB9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAIhD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAG9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAGhD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,MAAM,CAM7H"}
+{"version":3,"file":"Date.d.ts","sourceRoot":"","sources":["../src/Client/Date.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAc1C;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,CAqB9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAIhD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAG9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAG7C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAI5B;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAM,GAAG,MAAM,CAM7H"}

package/lib/Date.js

@@ -1,4 +1,4 @@
-import { Duration } from "./Duration.js";
+import { TimeSpan } from "./TimeSpan.js";
 /**
  * Returns the date at midnight corresponding to the specified date.
  * @param date The source date.
@@ -52,9 +52,9 @@ export function getHolidays(date) {
     holidays.push(new Date(year, 11, 25)); // Christmas.
     // Holidays depending on Easter.
     const easter = getEaster(date);
-    holidays.push(new Date(easter.getTime() + Duration.Day)); // Easter monday.
-    holidays.push(new Date(easter.getTime() + (39 * Duration.Day))); // Ascension thursday.
-    holidays.push(new Date(easter.getTime() + (50 * Duration.Day))); // Pentecost monday.
+    holidays.push(new Date(easter.getTime() + TimeSpan.MillisecondsPerDay)); // Easter monday.
+    holidays.push(new Date(easter.getTime() + (39 * TimeSpan.MillisecondsPerDay))); // Ascension thursday.
+    holidays.push(new Date(easter.getTime() + (50 * TimeSpan.MillisecondsPerDay))); // Pentecost monday.
     return holidays;
 }
 /**
@@ -73,7 +73,7 @@ export function getQuarter(date) {
 export function getWeekOfYear(date) {
     const thursday = new Date(date.getFullYear(), date.getMonth(), date.getDate() + 3 - ((date.getDay() + 6) % 7));
     const firstWeek = new Date(thursday.getFullYear(), 0, 4);
-    return 1 + Math.round((((thursday.getTime() - firstWeek.getTime()) / Duration.Day) - 3 + ((firstWeek.getDay() + 6) % 7)) / 7);
+    return 1 + Math.round((((thursday.getTime() - firstWeek.getTime()) / TimeSpan.MillisecondsPerDay) - 3 + ((firstWeek.getDay() + 6) % 7)) / 7);
 }
 /**
  * Returns a value indicating whether the specified date is in a leap year.
@@ -102,6 +102,15 @@ export function isWorkingDay(date) {
     const dayOfWeek = date.getDay();
     return dayOfWeek >= 1 && dayOfWeek <= 5;
 }
+/**
+ * Gets the current date.
+ * @returns The current date.
+ */
+export function today() {
+    const date = new Date;
+    date.setHours(0, 0, 0, 0);
+    return date;
+}
 /**
  * Converts the specified date to an ISO 8601 week.
  * @param date The date to convert.

package/lib/TimeSpan.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Provides some common time intervals in milliseconds.
+ */
+export declare const TimeSpan: Readonly<{
+    /**
+     * The number of hours in 1 day.
+     */
+    HoursPerDay: 24;
+    /**
+     * The number of minutes in 1 day.
+     */
+    MinutesPerDay: 1440;
+    /**
+     * The number of minutes in 1 hour.
+     */
+    MinutesPerHour: 60;
+    /**
+     * The number of seconds in 1 day.
+     */
+    SecondsPerDay: 86400;
+    /**
+     * The number of seconds in 1 hour.
+     */
+    SecondsPerHour: 3600;
+    /**
+     * The number of seconds in 1 minute.
+     */
+    SecondsPerMinute: 60;
+    /**
+     * The number of milliseconds in 1 day.
+     */
+    MillisecondsPerDay: 86400000;
+    /**
+     * The number of milliseconds in 1 hour.
+     */
+    MillisecondsPerHour: 3600000;
+    /**
+     * The number of milliseconds in 1 minute.
+     */
+    MillisecondsPerMinute: 60000;
+    /**
+     * The number of milliseconds in 1 second.
+     */
+    MillisecondsPerSecond: 1000;
+}>;
+//# sourceMappingURL=TimeSpan.d.ts.map

package/lib/TimeSpan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeSpan.d.ts","sourceRoot":"","sources":["../src/Client/TimeSpan.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ;IAEpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC"}

package/lib/TimeSpan.js

@@ -0,0 +1,45 @@
+/**
+ * Provides some common time intervals in milliseconds.
+ */
+export const TimeSpan = Object.freeze({
+    /**
+     * The number of hours in 1 day.
+     */
+    HoursPerDay: 24,
+    /**
+     * The number of minutes in 1 day.
+     */
+    MinutesPerDay: 1_440,
+    /**
+     * The number of minutes in 1 hour.
+     */
+    MinutesPerHour: 60,
+    /**
+     * The number of seconds in 1 day.
+     */
+    SecondsPerDay: 86_400,
+    /**
+     * The number of seconds in 1 hour.
+     */
+    SecondsPerHour: 3_600,
+    /**
+     * The number of seconds in 1 minute.
+     */
+    SecondsPerMinute: 60,
+    /**
+     * The number of milliseconds in 1 day.
+     */
+    MillisecondsPerDay: 86_400_000,
+    /**
+     * The number of milliseconds in 1 hour.
+     */
+    MillisecondsPerHour: 3_600_000,
+    /**
+     * The number of milliseconds in 1 minute.
+     */
+    MillisecondsPerMinute: 60_000,
+    /**
+     * The number of milliseconds in 1 second.
+     */
+    MillisecondsPerSecond: 1_000
+});

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

@@ -28,7 +28,7 @@ export declare class FullScreenToggler extends HTMLElement {
     /**
      * Toggles the full-screen mode of the associated element.
      * @param event The dispatched event.
-     * @returns Resolves when the full-screen mode has been toggled.
+     * @returns Completes when the full-screen mode has been toggled.
      */
     toggleFullScreen(event?: Event): Promise<void>;
 }

package/lib/UI/Components/FullScreenToggler.js

@@ -60,7 +60,7 @@ export class FullScreenToggler extends HTMLElement {
     /**
      * Toggles the full-screen mode of the associated element.
      * @param event The dispatched event.
-     * @returns Resolves when the full-screen mode has been toggled.
+     * @returns Completes when the full-screen mode has been toggled.
      */
     async toggleFullScreen(event) {
         event?.stopPropagation();
@@ -71,7 +71,7 @@ export class FullScreenToggler extends HTMLElement {
     }
     /**
      * Acquires a new wake lock.
-     * @returns Resolves when the wake lock has been acquired.
+     * @returns Completes when the wake lock has been acquired.
      */
     async #acquireWakeLock() {
         if (this.#sentinel && !this.#sentinel.released)
@@ -99,7 +99,7 @@ export class FullScreenToggler extends HTMLElement {
     };
     /**
      * Releases the acquired wake lock.
-     * @returns Resolves when the wake lock has been released.
+     * @returns Completes when the wake lock has been released.
      */
     async #releaseWakeLock() {
         if (!this.#sentinel || this.#sentinel.released)

package/lib/UI/Components/Toaster.js

@@ -60,7 +60,7 @@ export class Toaster extends HTMLElement {
      */
     get delay() {
         const value = Number(this.getAttribute("delay"));
-        return Math.max(1, Number.isNaN(value) ? 5_000 : value);
+        return Math.max(0, Number.isNaN(value) ? 5_000 : value);
     }
     set delay(value) {
         this.setAttribute("delay", value.toString());

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

@@ -0,0 +1,53 @@
+/**
+ * A component that moves back in the session history when clicked.
+ */
+export declare class TypeAhead extends HTMLElement {
+    #private;
+    /**
+     * The list of observed attributes.
+     */
+    static readonly observedAttributes: string[];
+    /**
+     * The delay in milliseconds to wait before triggering autocomplete suggestions.
+     */
+    get delay(): number;
+    set delay(value: number);
+    /**
+     * The function invoked when the query has been changed.
+     */
+    set handler(callback: (query: string) => Promise<string[]>);
+    /**
+     * The data list identifier.
+     */
+    get list(): string;
+    set list(value: string);
+    /**
+     * The minimum character length needed before triggering autocomplete suggestions.
+     */
+    get minLength(): number;
+    set minLength(value: number);
+    /**
+     * The query to look up.
+     */
+    get query(): string;
+    set query(value: string);
+    /**
+     * Method invoked when an attribute has been changed.
+     * @param attribute The attribute name.
+     * @param oldValue The previous attribute value.
+     * @param newValue The new attribute value.
+     */
+    attributeChangedCallback(attribute: string, oldValue: string | null, newValue: string | null): void;
+}
+/**
+ * Declaration merging.
+ */
+declare global {
+    /**
+     * The map of HTML tag names.
+     */
+    interface HTMLElementTagNameMap {
+        "type-ahead": TypeAhead;
+    }
+}
+//# sourceMappingURL=TypeAhead.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TypeAhead.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/TypeAhead.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;;IAEzC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAAqB;IAmBvD;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAGlB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED;;OAEG;IACH,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,EAKzD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAErB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAGtB;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,EAE1B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAEtB;IAED;;;;;OAKG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAC,IAAI,GAAG,IAAI;CAsD/F;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,YAAY,EAAE,SAAS,CAAC;KACxB;CACD"}

package/lib/UI/Components/TypeAhead.js

@@ -0,0 +1,138 @@
+/**
+ * A component that moves back in the session history when clicked.
+ */
+export class TypeAhead extends HTMLElement {
+    /**
+     * The list of observed attributes.
+     */
+    static observedAttributes = ["list", "query"];
+    /**
+     * The debounced handler used to look up the query.
+     */
+    #debounced = () => { };
+    /**
+     * The previous query.
+     */
+    #previousQuery = "";
+    /**
+     * Registers the component.
+     */
+    static {
+        customElements.define("type-ahead", this);
+    }
+    /**
+     * The delay in milliseconds to wait before triggering autocomplete suggestions.
+     */
+    get delay() {
+        const value = Number(this.getAttribute("delay"));
+        return Math.max(0, Number.isNaN(value) ? 300 : value);
+    }
+    set delay(value) {
+        this.setAttribute("delay", value.toString());
+    }
+    /**
+     * The function invoked when the query has been changed.
+     */
+    set handler(callback) {
+        this.#debounced = this.#debounce(async (query) => {
+            try {
+                this.#updateItems(await callback(query));
+            }
+            catch {
+                this.#updateItems([]);
+            }
+        }, this.delay);
+    }
+    /**
+     * The data list identifier.
+     */
+    get list() {
+        return (this.getAttribute("list") ?? "").trim();
+    }
+    set list(value) {
+        this.setAttribute("list", value);
+    }
+    /**
+     * The minimum character length needed before triggering autocomplete suggestions.
+     */
+    get minLength() {
+        const value = Number(this.getAttribute("minlength"));
+        return Math.max(1, Number.isNaN(value) ? 1 : value);
+    }
+    set minLength(value) {
+        this.setAttribute("minlength", value.toString());
+    }
+    /**
+     * The query to look up.
+     */
+    get query() {
+        return (this.getAttribute("query") ?? "").trim();
+    }
+    set query(value) {
+        this.setAttribute("query", value);
+    }
+    /**
+     * Method invoked when an attribute has been changed.
+     * @param attribute The attribute name.
+     * @param oldValue The previous attribute value.
+     * @param newValue The new attribute value.
+     */
+    attributeChangedCallback(attribute, oldValue, newValue) {
+        if (newValue != oldValue)
+            switch (attribute) {
+                case "list":
+                    this.#updateList(newValue ?? "");
+                    break;
+                case "query":
+                    this.#updateQuery(newValue ?? "");
+                    break;
+                // No default
+            }
+    }
+    /**
+     * Postpones the invocation of the specified callback until after a given delay has elapsed since the last time it was invoked.
+     * @param callback The function to debounce.
+     * @param delay The delay to wait, in milliseconds.
+     * @returns The debounced function.
+     */
+    #debounce(callback, delay) {
+        let timer = 0;
+        return value => {
+            if (timer)
+                clearTimeout(timer);
+            timer = window.setTimeout(callback, delay, value);
+        };
+    }
+    /**
+     * Updates the identifier of the underlying data list.
+     * @param value The new value.
+     */
+    #updateList(value) {
+        this.firstElementChild.id = value.trim();
+    }
+    /**
+     * Updates the query to look up.
+     * @param value The new value.
+     */
+    #updateQuery(value) {
+        const query = value.trim();
+        if (query != this.#previousQuery) {
+            this.#previousQuery = query;
+            if (query.length < this.minLength)
+                this.#updateItems([]);
+            else
+                this.#debounced(query);
+        }
+    }
+    /**
+     * Updates the items of the underlying data list.
+     * @param values The new values.
+     */
+    #updateItems(values) {
+        this.firstElementChild.replaceChildren(...values.map(value => {
+            const option = document.createElement("option");
+            option.value = value;
+            return option;
+        }));
+    }
+}

package/lib/UI/DialogResult.d.ts

@@ -27,8 +27,4 @@ export declare const DialogResult: Readonly<{
      */
     Ignore: "Ignore";
 }>;
-/**
- * Specifies the return value of a dialog box.
- */
-export type DialogResult = typeof DialogResult[keyof typeof DialogResult];
 //# sourceMappingURL=DialogResult.d.ts.map

package/lib/UI/DialogResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DialogResult.d.ts","sourceRoot":"","sources":["../../src/Client/UI/DialogResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,YAAY;IAExB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}
+{"version":3,"file":"DialogResult.d.ts","sourceRoot":"","sources":["../../src/Client/UI/DialogResult.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,YAAY;IAExB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC"}

package/package.json

@@ -7,7 +7,7 @@
 	"name": "@cedx/base",
 	"repository": "cedx/base",
 	"type": "module",
-	"version": "0.26.0",
+	"version": "0.28.0",
 	"devDependencies": {
 		"@playwright/browser-chromium": "^1.55.0",
 		"@types/bootstrap": "^5.2.10",
@@ -18,12 +18,12 @@
 		"chai": "^6.0.1",
 		"esbuild": "^0.25.9",
 		"globals": "^16.3.0",
-		"mocha": "^11.7.1",
+		"mocha": "^11.7.2",
 		"playwright": "^1.55.0",
 		"serve-handler": "^6.1.6",
 		"typedoc": "^0.28.12",
 		"typescript": "^5.9.2",
-		"typescript-eslint": "^8.41.0"
+		"typescript-eslint": "^8.42.0"
 	},
 	"engines": {
 		"node": ">=24.0.0"

package/src/Client/Date.ts

@@ -1,4 +1,4 @@
-import {Duration} from "./Duration.js";
+import {TimeSpan} from "./TimeSpan.js";
 
 /**
  * Returns the date at midnight corresponding to the specified date.
@@ -60,9 +60,9 @@ export function getHolidays(date: Date): Date[] {
 
 	// Holidays depending on Easter.
 	const easter = getEaster(date);
-	holidays.push(new Date(easter.getTime() + Duration.Day)); // Easter monday.
-	holidays.push(new Date(easter.getTime() + (39 * Duration.Day))); // Ascension thursday.
-	holidays.push(new Date(easter.getTime() + (50 * Duration.Day))); // Pentecost monday.
+	holidays.push(new Date(easter.getTime() + TimeSpan.MillisecondsPerDay)); // Easter monday.
+	holidays.push(new Date(easter.getTime() + (39 * TimeSpan.MillisecondsPerDay))); // Ascension thursday.
+	holidays.push(new Date(easter.getTime() + (50 * TimeSpan.MillisecondsPerDay))); // Pentecost monday.
 
 	return holidays;
 }
@@ -84,7 +84,7 @@ export function getQuarter(date: Date): number {
 export function getWeekOfYear(date: Date): number {
 	const thursday = new Date(date.getFullYear(), date.getMonth(), date.getDate() + 3 - ((date.getDay() + 6) % 7));
 	const firstWeek = new Date(thursday.getFullYear(), 0, 4);
-	return 1 + Math.round((((thursday.getTime() - firstWeek.getTime()) / Duration.Day) - 3 + ((firstWeek.getDay() + 6) % 7)) / 7);
+	return 1 + Math.round((((thursday.getTime() - firstWeek.getTime()) / TimeSpan.MillisecondsPerDay) - 3 + ((firstWeek.getDay() + 6) % 7)) / 7);
 }
 
 /**
@@ -117,6 +117,16 @@ export function isWorkingDay(date: Date): boolean {
 	return dayOfWeek >= 1 && dayOfWeek <= 5;
 }
 
+/**
+ * Gets the current date.
+ * @returns The current date.
+ */
+export function today(): Date {
+	const date = new Date;
+	date.setHours(0, 0, 0, 0);
+	return date;
+}
+
 /**
  * Converts the specified date to an ISO 8601 week.
  * @param date The date to convert.

package/src/Client/TimeSpan.ts

@@ -0,0 +1,55 @@
+/**
+ * Provides some common time intervals in milliseconds.
+ */
+export const TimeSpan = Object.freeze({
+
+	/**
+	 * The number of hours in 1 day.
+	 */
+	HoursPerDay: 24,
+
+	/**
+	 * The number of minutes in 1 day.
+	 */
+	MinutesPerDay: 1_440,
+
+	/**
+	 * The number of minutes in 1 hour.
+	 */
+	MinutesPerHour: 60,
+
+	/**
+	 * The number of seconds in 1 day.
+	 */
+	SecondsPerDay: 86_400,
+
+	/**
+	 * The number of seconds in 1 hour.
+	 */
+	SecondsPerHour: 3_600,
+
+	/**
+	 * The number of seconds in 1 minute.
+	 */
+	SecondsPerMinute: 60,
+
+	/**
+	 * The number of milliseconds in 1 day.
+	 */
+	MillisecondsPerDay: 86_400_000,
+
+	/**
+	 * The number of milliseconds in 1 hour.
+	 */
+	MillisecondsPerHour: 3_600_000,
+
+	/**
+	 * The number of milliseconds in 1 minute.
+	 */
+	MillisecondsPerMinute: 60_000,
+
+	/**
+	 * The number of milliseconds in 1 second.
+	 */
+	MillisecondsPerSecond: 1_000
+});

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

@@ -69,7 +69,7 @@ export class FullScreenToggler extends HTMLElement {
 	/**
 	 * Toggles the full-screen mode of the associated element.
 	 * @param event The dispatched event.
-	 * @returns Resolves when the full-screen mode has been toggled.
+	 * @returns Completes when the full-screen mode has been toggled.
 	 */
 	async toggleFullScreen(event?: Event): Promise<void> {
 		event?.stopPropagation();
@@ -79,7 +79,7 @@ export class FullScreenToggler extends HTMLElement {
 
 	/**
 	 * Acquires a new wake lock.
-	 * @returns Resolves when the wake lock has been acquired.
+	 * @returns Completes when the wake lock has been acquired.
 	 */
 	async #acquireWakeLock(): Promise<void> {
 		if (this.#sentinel && !this.#sentinel.released) return;
@@ -105,7 +105,7 @@ export class FullScreenToggler extends HTMLElement {
 
 	/**
 	 * Releases the acquired wake lock.
-	 * @returns Resolves when the wake lock has been released.
+	 * @returns Completes when the wake lock has been released.
 	 */
 	async #releaseWakeLock(): Promise<void> {
 		if (!this.#sentinel || this.#sentinel.released) return;

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

@@ -115,7 +115,7 @@ export class Toaster extends HTMLElement {
 	 */
 	get delay(): number {
 		const value = Number(this.getAttribute("delay"));
-		return Math.max(1, Number.isNaN(value) ? 5_000 : value);
+		return Math.max(0, Number.isNaN(value) ? 5_000 : value);
 	}
 	set delay(value: number) {
 		this.setAttribute("delay", value.toString());

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

@@ -0,0 +1,153 @@
+/**
+ * A component that moves back in the session history when clicked.
+ */
+export class TypeAhead extends HTMLElement {
+
+	/**
+	 * The list of observed attributes.
+	 */
+	static readonly observedAttributes = ["list", "query"];
+
+	/**
+	 * The debounced handler used to look up the query.
+	 */
+	#debounced: (value: string) => void = () => { /* Noop */ };
+
+	/**
+	 * The previous query.
+	 */
+	#previousQuery = "";
+
+	/**
+	 * Registers the component.
+	 */
+	static {
+		customElements.define("type-ahead", this);
+	}
+
+	/**
+	 * The delay in milliseconds to wait before triggering autocomplete suggestions.
+	 */
+	get delay(): number {
+		const value = Number(this.getAttribute("delay"));
+		return Math.max(0, Number.isNaN(value) ? 300 : value);
+	}
+	set delay(value: number) {
+		this.setAttribute("delay", value.toString());
+	}
+
+	/**
+	 * The function invoked when the query has been changed.
+	 */
+	set handler(callback: (query: string) => Promise<string[]>) { // eslint-disable-line accessor-pairs
+		this.#debounced = this.#debounce(async query => { // eslint-disable-line @typescript-eslint/no-misused-promises
+			try { this.#updateItems(await callback(query)); }
+			catch { this.#updateItems([]); }
+		}, this.delay);
+	}
+
+	/**
+	 * The data list identifier.
+	 */
+	get list(): string {
+		return (this.getAttribute("list") ?? "").trim();
+	}
+	set list(value: string) {
+		this.setAttribute("list", value);
+	}
+
+	/**
+	 * The minimum character length needed before triggering autocomplete suggestions.
+	 */
+	get minLength(): number {
+		const value = Number(this.getAttribute("minlength"));
+		return Math.max(1, Number.isNaN(value) ? 1 : value);
+	}
+	set minLength(value: number) {
+		this.setAttribute("minlength", value.toString());
+	}
+
+	/**
+	 * The query to look up.
+	 */
+	get query(): string {
+		return (this.getAttribute("query") ?? "").trim();
+	}
+	set query(value: string) {
+		this.setAttribute("query", value);
+	}
+
+	/**
+	 * Method invoked when an attribute has been changed.
+	 * @param attribute The attribute name.
+	 * @param oldValue The previous attribute value.
+	 * @param newValue The new attribute value.
+	 */
+	attributeChangedCallback(attribute: string, oldValue: string|null, newValue: string|null): void {
+		if (newValue != oldValue) switch (attribute) {
+			case "list": this.#updateList(newValue ?? ""); break;
+			case "query": this.#updateQuery(newValue ?? ""); break;
+			// No default
+		}
+	}
+
+	/**
+	 * Postpones the invocation of the specified callback until after a given delay has elapsed since the last time it was invoked.
+	 * @param callback The function to debounce.
+	 * @param delay The delay to wait, in milliseconds.
+	 * @returns The debounced function.
+	 */
+	#debounce(callback: (value: string) => void, delay: number): (value: string) => void {
+		let timer = 0;
+		return value => {
+			if (timer) clearTimeout(timer);
+			timer = window.setTimeout(callback, delay, value);
+		};
+	}
+
+	/**
+	 * Updates the identifier of the underlying data list.
+	 * @param value The new value.
+	 */
+	#updateList(value: string): void {
+		this.firstElementChild!.id = value.trim();
+	}
+
+	/**
+	 * Updates the query to look up.
+	 * @param value The new value.
+	 */
+	#updateQuery(value: string): void {
+		const query = value.trim();
+		if (query != this.#previousQuery) {
+			this.#previousQuery = query;
+			if (query.length < this.minLength) this.#updateItems([]);
+			else this.#debounced(query);
+		}
+	}
+
+	/**
+	 * Updates the items of the underlying data list.
+	 * @param values The new values.
+	 */
+	#updateItems(values: string[]): void {
+		this.firstElementChild!.replaceChildren(...values.map(value => {
+			const option = document.createElement("option");
+			option.value = value;
+			return option;
+		}));
+	}
+}
+
+/**
+ * Declaration merging.
+ */
+declare global {
+
+	/**
+	 * The map of HTML tag names.
+	 */
+	interface HTMLElementTagNameMap {
+		"type-ahead": TypeAhead;
+	}
+}

package/src/Client/UI/DialogResult.ts

@@ -33,8 +33,3 @@ export const DialogResult = Object.freeze({
 	 */
 	Ignore: "Ignore"
 });
-
-/**
- * Specifies the return value of a dialog box.
- */
-export type DialogResult = typeof DialogResult[keyof typeof DialogResult];

package/lib/Duration.d.ts

@@ -1,26 +0,0 @@
-/**
- * Provides some common durations in milliseconds.
- */
-export declare const Duration: Readonly<{
-    /**
-     * One second.
-     */
-    Second: 1000;
-    /**
-     * One minute.
-     */
-    Minute: 60000;
-    /**
-     * One hour.
-     */
-    Hour: 3600000;
-    /**
-     * One day.
-     */
-    Day: 86400000;
-}>;
-/**
- * Provides some common durations in milliseconds.
- */
-export type Duration = typeof Duration[keyof typeof Duration];
-//# sourceMappingURL=Duration.d.ts.map

package/lib/Duration.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Duration.d.ts","sourceRoot":"","sources":["../src/Client/Duration.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ;IAEpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC"}

package/lib/Duration.js

@@ -1,21 +0,0 @@
-/**
- * Provides some common durations in milliseconds.
- */
-export const Duration = Object.freeze({
-    /**
-     * One second.
-     */
-    Second: 1_000,
-    /**
-     * One minute.
-     */
-    Minute: 60_000,
-    /**
-     * One hour.
-     */
-    Hour: 3_600_000,
-    /**
-     * One day.
-     */
-    Day: 86_400_000
-});

package/src/Client/Duration.ts

@@ -1,30 +0,0 @@
-/**
- * Provides some common durations in milliseconds.
- */
-export const Duration = Object.freeze({
-
-	/**
-	 * One second.
-	 */
-	Second: 1_000,
-
-	/**
-	 * One minute.
-	 */
-	Minute: 60_000,
-
-	/**
-	 * One hour.
-	 */
-	Hour: 3_600_000,
-
-	/**
-	 * One day.
-	 */
-	Day: 86_400_000
-});
-
-/**
- * Provides some common durations in milliseconds.
- */
-export type Duration = typeof Duration[keyof typeof Duration];