@cedx/base 0.1.0 → 0.2.0

package/lib/Date.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Returns the date at midnight corresponding to the specified date.
+ * @param date The source date.
+ * @returns The date whose time has been set at midnight.
+ */
+export declare function atMidnight(date: Date): Date;
+/**
+ * Gets the number of days in the month of the specified date.
+ * @param date The date.
+ * @returns The number of days in the month of the specified date.
+ */
+export declare function daysInMonth(date: Date): number;
+/**
+ * Gets the date of Easter for a given year.
+ * @param year The year.
+ * @returns The date of Easter for the specified year.
+ */
+export declare function getEaster(year?: number): Date;
+/**
+ * Gets the list of holidays for a given year.
+ * @param year The year.
+ * @returns The list of holidays for the specified year.
+ */
+export declare function getHolidays(year?: number): Date[];
+/**
+ * Gets the quarter corresponding to the specified date.
+ * @param date The date.
+ * @returns The quarter corresponding to the specified date.
+ */
+export declare function getQuarter(date: Date): number;
+/**
+ * Gets the week number corresponding to the specified date.
+ * @param date The date.
+ * @returns The week number corresponding to the specified date.
+ */
+export declare function getWeekOfYear(date: Date): number;
+/**
+ * Returns a value indicating whether the specified date is in a leap year.
+ * @param date The date to check.
+ * @returns `true` if the specified date is in a leap year, otherwise `false`.
+ */
+export declare function inLeapYear(date: Date): boolean;
+/**
+ * Returns a value indicating whether the specified date is a holiday.
+ * @param date The date to check.
+ * @returns `true` if the specified date is a holiday, otherwise `false`.
+ */
+export declare function isHoliday(date: Date): boolean;
+/**
+ * Returns a value indicating whether the specified date is a working day.
+ * @param date The date to check.
+ * @returns `true` if the specified date is a working day, otherwise `false`.
+ */
+export declare function isWorkingDay(date: Date): boolean;
+/**
+ * Converts the specified date to an ISO 8601 week.
+ * @param date The date to convert.
+ * @returns The ISO 8601 week corresponding to the specified date.
+ */
+export declare function toIsoWeek(date: Date): string;
+/**
+ * Converts the specified date to the `YYYY-MM-DD HH:MM:SS` format.
+ * @param date The date to convert.
+ * @param options Values indicating how to format the resulting string.
+ * @returns The `YYYY-MM-DD HH:MM:SS` format corresponding to the specified date.
+ */
+export declare function toYmdHms(date: Date, options?: {
+    excludeDate?: boolean;
+    excludeTime?: boolean;
+    separator?: string;
+}): string;
+//# sourceMappingURL=Date.d.ts.map

package/lib/Date.d.ts.map

@@ -0,0 +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,SAA2B,GAAG,IAAI,CAY/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,SAA2B,GAAG,IAAI,EAAE,CAoBnE;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"}

package/lib/Date.js

@@ -0,0 +1,125 @@
+import { Duration } from "./Duration.js";
+/**
+ * Returns the date at midnight corresponding to the specified date.
+ * @param date The source date.
+ * @returns The date whose time has been set at midnight.
+ */
+export function atMidnight(date) {
+    return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+/**
+ * Gets the number of days in the month of the specified date.
+ * @param date The date.
+ * @returns The number of days in the month of the specified date.
+ */
+export function daysInMonth(date) {
+    return new Date(date.getFullYear(), date.getMonth() + 1, 0).getDate();
+}
+/**
+ * Gets the date of Easter for a given year.
+ * @param year The year.
+ * @returns The date of Easter for the specified year.
+ */
+export function getEaster(year = new Date().getFullYear()) {
+    /* eslint-disable id-length */
+    const n = year % 19;
+    const c = Math.trunc(year / 100);
+    const u = year % 100;
+    const e = ((19 * n) + c - Math.trunc(c / 4) - Math.trunc((c - Math.trunc((c + 8) / 25) + 1) / 3) + 15) % 30;
+    const l = ((2 * (c % 4)) + (2 * Math.trunc(u / 4)) - e - (u % 4) + 32) % 7;
+    const h = Math.trunc((n + (11 * e) + (22 * l)) / 451);
+    const result = e + l - (7 * h) + 114;
+    /* eslint-enable id-length */
+    return new Date(year, Math.trunc(result / 31) - 1, (result % 31) + 1);
+}
+/**
+ * Gets the list of holidays for a given year.
+ * @param year The year.
+ * @returns The list of holidays for the specified year.
+ */
+export function getHolidays(year = new Date().getFullYear()) {
+    const holidays = [];
+    // Fixed holidays.
+    holidays.push(new Date(year, 0, 1)); // New year.
+    holidays.push(new Date(year, 4, 1)); // Labor day.
+    holidays.push(new Date(year, 4, 8)); // Armistice (1945).
+    holidays.push(new Date(year, 6, 14)); // National holiday.
+    holidays.push(new Date(year, 7, 15)); // Assumption.
+    holidays.push(new Date(year, 10, 1)); // Toussaint.
+    holidays.push(new Date(year, 10, 11)); // Armistice (1918).
+    holidays.push(new Date(year, 11, 25)); // Christmas.
+    // Holidays depending on Easter.
+    const easter = getEaster(year);
+    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.
+    return holidays;
+}
+/**
+ * Gets the quarter corresponding to the specified date.
+ * @param date The date.
+ * @returns The quarter corresponding to the specified date.
+ */
+export function getQuarter(date) {
+    return Math.ceil((date.getMonth() + 1) / 3);
+}
+/**
+ * Gets the week number corresponding to the specified date.
+ * @param date The date.
+ * @returns The week number corresponding to the specified 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);
+}
+/**
+ * Returns a value indicating whether the specified date is in a leap year.
+ * @param date The date to check.
+ * @returns `true` if the specified date is in a leap year, otherwise `false`.
+ */
+export function inLeapYear(date) {
+    const year = date.getFullYear();
+    return year % 4 == 0 && (year % 100 != 0 || year % 400 == 0);
+}
+/**
+ * Returns a value indicating whether the specified date is a holiday.
+ * @param date The date to check.
+ * @returns `true` if the specified date is a holiday, otherwise `false`.
+ */
+export function isHoliday(date) {
+    const timestamp = atMidnight(date).getTime();
+    return getHolidays(date.getFullYear()).some(holiday => holiday.getTime() == timestamp);
+}
+/**
+ * Returns a value indicating whether the specified date is a working day.
+ * @param date The date to check.
+ * @returns `true` if the specified date is a working day, otherwise `false`.
+ */
+export function isWorkingDay(date) {
+    const dayOfWeek = date.getDay();
+    return dayOfWeek >= 1 && dayOfWeek <= 5;
+}
+/**
+ * Converts the specified date to an ISO 8601 week.
+ * @param date The date to convert.
+ * @returns The ISO 8601 week corresponding to the specified date.
+ */
+export function toIsoWeek(date) {
+    return `${date.getFullYear().toString().padStart(4, "0")}-W${getWeekOfYear(date).toString().padStart(2, "0")}`;
+}
+/**
+ * Converts the specified date to the `YYYY-MM-DD HH:MM:SS` format.
+ * @param date The date to convert.
+ * @param options Values indicating how to format the resulting string.
+ * @returns The `YYYY-MM-DD HH:MM:SS` format corresponding to the specified date.
+ */
+export function toYmdHms(date, options = {}) {
+    const padStart = (number, length = 2) => number.toString().padStart(length, "0");
+    const parts = [];
+    if (!options.excludeDate)
+        parts.push([padStart(date.getFullYear(), 4), padStart(date.getMonth() + 1), padStart(date.getDate())].join("-"));
+    if (!options.excludeTime)
+        parts.push([date.getHours(), date.getMinutes(), date.getSeconds()].map(item => padStart(item)).join(":"));
+    return parts.join(options.separator ?? " ");
+}

package/lib/Duration.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,21 @@
+/**
+ * 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/lib/Html/Context.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Defines contextual modifiers.
+ */
+export declare const Context: Readonly<{
+    /**
+     * A danger.
+     */
+    Danger: "danger";
+    /**
+     * A warning.
+     */
+    Warning: "warning";
+    /**
+     * An information.
+     */
+    Info: "info";
+    /**
+     * A success.
+     */
+    Success: "success";
+}>;
+/**
+ * Defines contextual modifiers.
+ */
+export type Context = typeof Context[keyof typeof Context];
+/**
+ * Gets the icon corresponding to the specified context.
+ * @param context The context.
+ * @returns The icon corresponding to the specified context.
+ */
+export declare function contextIcon(context: Context): string;
+//# sourceMappingURL=Context.d.ts.map

package/lib/Html/Context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/Client/Html/Context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,OAAO;IAEnB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAOpD"}

package/lib/Html/Context.js

@@ -0,0 +1,34 @@
+/**
+ * Defines contextual modifiers.
+ */
+export const Context = Object.freeze({
+    /**
+     * A danger.
+     */
+    Danger: "danger",
+    /**
+     * A warning.
+     */
+    Warning: "warning",
+    /**
+     * An information.
+     */
+    Info: "info",
+    /**
+     * A success.
+     */
+    Success: "success"
+});
+/**
+ * Gets the icon corresponding to the specified context.
+ * @param context The context.
+ * @returns The icon corresponding to the specified context.
+ */
+export function contextIcon(context) {
+    switch (context) {
+        case Context.Danger: return "error";
+        case Context.Success: return "check_circle";
+        case Context.Warning: return "warning";
+        default: return "info";
+    }
+}

package/lib/Html/File.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Downloads the specified file.
+ * @param file The file to be downloaded.
+ */
+export declare function downloadFile(file: File): void;
+/**
+ * Downloads the specified text content.
+ * @param text The text content.
+ * @param fileName The file name.
+ * @param options The optional attributes for the file.
+ */
+export declare function downloadString(text: string, fileName: string, options?: FilePropertyBag): void;
+/**
+ * Opens the specified file.
+ * @param file The file to be opened.
+ * @param options Value indicating whether to open the file in a new tab.
+ */
+export declare function openFile(file: File, options?: {
+    newTab?: boolean;
+}): void;
+/**
+ * Prints the specified file.
+ * @param file The file to be printed.
+ */
+export declare function printFile(file: File): void;
+/**
+ * Converts the specified file to a data URL.
+ * @param file The file to convert.
+ * @returns The data URL corresponding to the given file.
+ */
+export declare function toDataUrl(file: File): Promise<URL>;
+//# sourceMappingURL=File.d.ts.map

package/lib/Html/File.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../../src/Client/Html/File.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAU7C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,IAAI,CAElG;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAM,GAAG,IAAI,CAkB3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAa1C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAOlD"}

package/lib/Html/File.js

@@ -0,0 +1,76 @@
+import { Duration } from "#Base/Duration.js";
+/**
+ * Downloads the specified file.
+ * @param file The file to be downloaded.
+ */
+export function downloadFile(file) {
+    const url = URL.createObjectURL(file);
+    const anchor = document.createElement("a");
+    anchor.download = file.name;
+    anchor.href = url;
+    document.body.appendChild(anchor);
+    anchor.click();
+    document.body.removeChild(anchor);
+    URL.revokeObjectURL(url);
+}
+/**
+ * Downloads the specified text content.
+ * @param text The text content.
+ * @param fileName The file name.
+ * @param options The optional attributes for the file.
+ */
+export function downloadString(text, fileName, options = {}) {
+    downloadFile(new File([text], fileName, options));
+}
+/**
+ * Opens the specified file.
+ * @param file The file to be opened.
+ * @param options Value indicating whether to open the file in a new tab.
+ */
+export function openFile(file, options = {}) {
+    const url = URL.createObjectURL(file);
+    if (!options.newTab) {
+        location.assign(url);
+        return;
+    }
+    const handle = window.open(url, "_blank");
+    if (!handle) {
+        location.assign(url);
+        return;
+    }
+    const timer = window.setInterval(() => {
+        if (!handle.closed)
+            return;
+        clearInterval(timer);
+        URL.revokeObjectURL(url);
+    }, 5 * Duration.Second);
+}
+/**
+ * Prints the specified file.
+ * @param file The file to be printed.
+ */
+export function printFile(file) {
+    const url = URL.createObjectURL(file);
+    const frame = document.createElement("iframe");
+    frame.addEventListener("load", () => frame.contentWindow?.print());
+    frame.hidden = true;
+    frame.src = url;
+    window.addEventListener("focus", () => {
+        document.body.removeChild(frame);
+        URL.revokeObjectURL(url);
+    }, { once: true });
+    document.body.appendChild(frame);
+}
+/**
+ * Converts the specified file to a data URL.
+ * @param file The file to convert.
+ * @returns The data URL corresponding to the given file.
+ */
+export function toDataUrl(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader;
+        reader.addEventListener("error", reject);
+        reader.addEventListener("load", () => resolve(new URL(reader.result)));
+        reader.readAsDataURL(file);
+    });
+}

package/lib/UI/LoadingIndicator.d.ts

@@ -1,9 +1,8 @@
 import type { ILoadingIndicator } from "#Abstractions/ILoadingIndicator.js";
-import { LitElement, type TemplateResult } from "lit";
 /**
  * A component that shows up when an HTTP request starts, and hides when all concurrent HTTP requests are completed.
  */
-export declare class LoadingIndicator extends LitElement implements ILoadingIndicator {
+export declare class LoadingIndicator extends HTMLElement implements ILoadingIndicator {
     #private;
     /**
      * Creates a new loading indicator.
@@ -20,11 +19,6 @@ export declare class LoadingIndicator extends LitElement implements ILoadingIndi
     stop(options?: {
         force?: boolean;
     }): void;
-    /**
-     * Renders this component.
-     * @returns The view template.
-     */
-    protected render(): TemplateResult;
 }
 /**
  * Declaration merging.

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

@@ -1 +1 @@
-{"version":3,"file":"LoadingIndicator.d.ts","sourceRoot":"","sources":["../../src/Client/UI/LoadingIndicator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAO,UAAU,EAAE,KAAK,cAAc,EAAC,MAAM,KAAK,CAAC;AAG1D;;GAEG;AACH,qBACa,gBAAiB,SAAQ,UAAW,YAAW,iBAAiB;;IAO5E;;OAEG;;IAMH;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,IAAI,CAAC,OAAO,GAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAM,GAAG,IAAI;IAS3C;;;OAGG;cACgB,MAAM,IAAI,cAAc;CAG3C;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/LoadingIndicator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,oCAAoC,CAAC;AAE1E;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAY,YAAW,iBAAiB;;IAO7E;;OAEG;;IAcH;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,IAAI,CAAC,OAAO,GAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAM,GAAG,IAAI;CAQ3C;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,mBAAmB,EAAE,gBAAgB,CAAC;KACtC;CACD"}

package/lib/UI/LoadingIndicator.js

@@ -1,10 +1,7 @@
-import { __decorate } from "tslib";
-import { html, LitElement } from "lit";
-import { customElement } from "lit/decorators.js";
 /**
  * A component that shows up when an HTTP request starts, and hides when all concurrent HTTP requests are completed.
  */
-let LoadingIndicator = class LoadingIndicator extends LitElement {
+export class LoadingIndicator extends HTMLElement {
     /**
      * The number of concurrent HTTP requests.
      */
@@ -15,6 +12,13 @@ let LoadingIndicator = class LoadingIndicator extends LitElement {
     constructor() {
         super();
         this.hidden = true;
+        this.attachShadow({ mode: "open" }).appendChild(document.createElement("slot"));
+    }
+    /**
+     * Registers the component.
+     */
+    static {
+        customElements.define("loading-indicator", this);
     }
     /**
      * Starts the loading indicator.
@@ -36,15 +40,4 @@ let LoadingIndicator = class LoadingIndicator extends LitElement {
             document.body.classList.remove("loading");
         }
     }
-    /**
-     * Renders this component.
-     * @returns The view template.
-     */
-    render() {
-        return html `<slot></slot>`;
-    }
-};
-LoadingIndicator = __decorate([
-    customElement("loading-indicator")
-], LoadingIndicator);
-export { LoadingIndicator };
+}

package/lib/UI/MenuActivator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A component that activates the items of a menu based on the current document URL.
+ */
+export declare class MenuActivator extends HTMLElement {
+    /**
+     * Creates a new menu activator.
+     */
+    constructor();
+    /**
+     * Method invoked when this component is connected.
+     */
+    connectedCallback(): void;
+}
+/**
+ * Declaration merging.
+ */
+declare global {
+    /**
+     * The map of HTML tag names.
+     */
+    interface HTMLElementTagNameMap {
+        "menu-activator": MenuActivator;
+    }
+}
+//# sourceMappingURL=MenuActivator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MenuActivator.d.ts","sourceRoot":"","sources":["../../src/Client/UI/MenuActivator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAE7C;;OAEG;;IAaH;;OAEG;IACH,iBAAiB,IAAI,IAAI;CASzB;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,gBAAgB,EAAE,aAAa,CAAC;KAChC;CACD"}

package/lib/UI/MenuActivator.js

@@ -0,0 +1,32 @@
+/**
+ * A component that activates the items of a menu based on the current document URL.
+ */
+export class MenuActivator extends HTMLElement {
+    /**
+     * Creates a new menu activator.
+     */
+    constructor() {
+        super();
+        this.attachShadow({ mode: "open" }).appendChild(document.createElement("slot"));
+    }
+    /**
+     * Registers the component.
+     */
+    static {
+        customElements.define("menu-activator", this);
+    }
+    /**
+     * Method invoked when this component is connected.
+     */
+    connectedCallback() {
+        const menu = this.shadowRoot.querySelector("slot").assignedElements().at(0);
+        if (menu)
+            for (const anchor of menu.getElementsByTagName("a"))
+                if (anchor.href != location.href)
+                    anchor.classList.remove("active");
+                else {
+                    anchor.classList.add("active");
+                    anchor.closest(".nav-item.dropdown")?.querySelector(".nav-link")?.classList.add("active");
+                }
+    }
+}

package/lib/UI/OfflineIndicator.d.ts

@@ -1,8 +1,7 @@
-import { LitElement, type TemplateResult } from "lit";
 /**
  * A component that shows up when the network is unavailable, and hides when connectivity is restored.
  */
-export declare class OfflineIndicator extends LitElement {
+export declare class OfflineIndicator extends HTMLElement {
     /**
      * Creates a new offline indicator.
      */
@@ -19,11 +18,6 @@ export declare class OfflineIndicator extends LitElement {
      * Handles the events.
      */
     handleEvent(): void;
-    /**
-     * Renders this component.
-     * @returns The view template.
-     */
-    protected render(): TemplateResult;
 }
 /**
  * Declaration merging.

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

@@ -1 +1 @@
-{"version":3,"file":"OfflineIndicator.d.ts","sourceRoot":"","sources":["../../src/Client/UI/OfflineIndicator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,UAAU,EAAE,KAAK,cAAc,EAAC,MAAM,KAAK,CAAC;AAG1D;;GAEG;AACH,qBACa,gBAAiB,SAAQ,UAAU;IAE/C;;OAEG;;IAMH;;OAEG;IACM,iBAAiB,IAAI,IAAI;IAKlC;;OAEG;IACM,oBAAoB,IAAI,IAAI;IAKrC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;;OAGG;cACgB,MAAM,IAAI,cAAc;CAG3C;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,mBAAmB,EAAE,gBAAgB,CAAC;KACtC;CACD"}
+{"version":3,"file":"OfflineIndicator.d.ts","sourceRoot":"","sources":["../../src/Client/UI/OfflineIndicator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAEhD;;OAEG;;IAcH;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;OAEG;IACH,WAAW,IAAI,IAAI;CAGnB;AAED;;GAEG;AACH,OAAO,CAAC,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,qBAAqB;QAC9B,mBAAmB,EAAE,gBAAgB,CAAC;KACtC;CACD"}

package/lib/UI/OfflineIndicator.js

@@ -1,22 +1,25 @@
-import { __decorate } from "tslib";
-import { html, LitElement } from "lit";
-import { customElement } from "lit/decorators.js";
 /**
  * A component that shows up when the network is unavailable, and hides when connectivity is restored.
  */
-let OfflineIndicator = class OfflineIndicator extends LitElement {
+export class OfflineIndicator extends HTMLElement {
     /**
      * Creates a new offline indicator.
      */
     constructor() {
         super();
         this.hidden = navigator.onLine;
+        this.attachShadow({ mode: "open" }).appendChild(document.createElement("slot"));
+    }
+    /**
+     * Registers the component.
+     */
+    static {
+        customElements.define("offline-indicator", this);
     }
     /**
      * Method invoked when this component is connected.
      */
     connectedCallback() {
-        super.connectedCallback();
         for (const event of ["online", "offline"])
             addEventListener(event, this);
     }
@@ -26,7 +29,6 @@ let OfflineIndicator = class OfflineIndicator extends LitElement {
     disconnectedCallback() {
         for (const event of ["online", "offline"])
             removeEventListener(event, this);
-        super.disconnectedCallback();
     }
     /**
      * Handles the events.
@@ -34,15 +36,4 @@ let OfflineIndicator = class OfflineIndicator extends LitElement {
     handleEvent() {
         this.hidden = navigator.onLine;
     }
-    /**
-     * Renders this component.
-     * @returns The view template.
-     */
-    render() {
-        return html `<slot></slot>`;
-    }
-};
-OfflineIndicator = __decorate([
-    customElement("offline-indicator")
-], OfflineIndicator);
-export { OfflineIndicator };
+}

package/package.json

@@ -7,7 +7,7 @@
 	"name": "@cedx/base",
 	"repository": "cedx/base",
 	"type": "module",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"devDependencies": {
 		"@playwright/browser-chromium": "^1.54.2",
 		"@types/bootstrap": "^5.2.10",
@@ -40,6 +40,7 @@
 	],
 	"imports": {
 		"#Abstractions/*.js": "./lib/Abstractions/*.js",
+		"#Base/*.js": "./lib/*.js",
 		"#Html/*.js": "./lib/Html/*.js"
 	},
 	"keywords": [

package/src/Client/Date.ts

@@ -0,0 +1,138 @@
+import {Duration} from "./Duration.js";
+
+/**
+ * Returns the date at midnight corresponding to the specified date.
+ * @param date The source date.
+ * @returns The date whose time has been set at midnight.
+ */
+export function atMidnight(date: Date): Date {
+	return new Date(date.getFullYear(), date.getMonth(), date.getDate());
+}
+
+/**
+ * Gets the number of days in the month of the specified date.
+ * @param date The date.
+ * @returns The number of days in the month of the specified date.
+ */
+export function daysInMonth(date: Date): number {
+	return new Date(date.getFullYear(), date.getMonth() + 1, 0).getDate();
+}
+
+/**
+ * Gets the date of Easter for a given year.
+ * @param year The year.
+ * @returns The date of Easter for the specified year.
+ */
+export function getEaster(year = new Date().getFullYear()): Date {
+	/* eslint-disable id-length */
+	const n = year % 19;
+	const c = Math.trunc(year / 100);
+	const u = year % 100;
+	const e = ((19 * n) + c - Math.trunc(c / 4) - Math.trunc((c - Math.trunc((c + 8) / 25) + 1) / 3) + 15) % 30;
+	const l = ((2 * (c % 4)) + (2 * Math.trunc(u / 4)) - e - (u % 4) + 32) % 7;
+	const h = Math.trunc((n + (11 * e) + (22 * l)) / 451);
+	const result = e + l - (7 * h) + 114;
+	/* eslint-enable id-length */
+
+	return new Date(year, Math.trunc(result / 31) - 1, (result % 31) + 1);
+}
+
+/**
+ * Gets the list of holidays for a given year.
+ * @param year The year.
+ * @returns The list of holidays for the specified year.
+ */
+export function getHolidays(year = new Date().getFullYear()): Date[] {
+	const holidays = [];
+
+	// Fixed holidays.
+	holidays.push(new Date(year, 0, 1)); // New year.
+	holidays.push(new Date(year, 4, 1)); // Labor day.
+	holidays.push(new Date(year, 4, 8)); // Armistice (1945).
+	holidays.push(new Date(year, 6, 14)); // National holiday.
+	holidays.push(new Date(year, 7, 15)); // Assumption.
+	holidays.push(new Date(year, 10, 1)); // Toussaint.
+	holidays.push(new Date(year, 10, 11)); // Armistice (1918).
+	holidays.push(new Date(year, 11, 25)); // Christmas.
+
+	// Holidays depending on Easter.
+	const easter = getEaster(year);
+	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.
+
+	return holidays;
+}
+
+/**
+ * Gets the quarter corresponding to the specified date.
+ * @param date The date.
+ * @returns The quarter corresponding to the specified date.
+ */
+export function getQuarter(date: Date): number {
+	return Math.ceil((date.getMonth() + 1) / 3);
+}
+
+/**
+ * Gets the week number corresponding to the specified date.
+ * @param date The date.
+ * @returns The week number corresponding to the specified date.
+ */
+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);
+}
+
+/**
+ * Returns a value indicating whether the specified date is in a leap year.
+ * @param date The date to check.
+ * @returns `true` if the specified date is in a leap year, otherwise `false`.
+ */
+export function inLeapYear(date: Date): boolean {
+	const year = date.getFullYear();
+	return year % 4 == 0 && (year % 100 != 0 || year % 400 == 0);
+}
+
+/**
+ * Returns a value indicating whether the specified date is a holiday.
+ * @param date The date to check.
+ * @returns `true` if the specified date is a holiday, otherwise `false`.
+ */
+export function isHoliday(date: Date): boolean {
+	const timestamp = atMidnight(date).getTime();
+	return getHolidays(date.getFullYear()).some(holiday => holiday.getTime() == timestamp);
+}
+
+/**
+ * Returns a value indicating whether the specified date is a working day.
+ * @param date The date to check.
+ * @returns `true` if the specified date is a working day, otherwise `false`.
+ */
+export function isWorkingDay(date: Date): boolean {
+	const dayOfWeek = date.getDay();
+	return dayOfWeek >= 1 && dayOfWeek <= 5;
+}
+
+/**
+ * Converts the specified date to an ISO 8601 week.
+ * @param date The date to convert.
+ * @returns The ISO 8601 week corresponding to the specified date.
+ */
+export function toIsoWeek(date: Date): string {
+	return `${date.getFullYear().toString().padStart(4, "0")}-W${getWeekOfYear(date).toString().padStart(2, "0")}`;
+}
+
+/**
+ * Converts the specified date to the `YYYY-MM-DD HH:MM:SS` format.
+ * @param date The date to convert.
+ * @param options Values indicating how to format the resulting string.
+ * @returns The `YYYY-MM-DD HH:MM:SS` format corresponding to the specified date.
+ */
+export function toYmdHms(date: Date, options: {excludeDate?: boolean, excludeTime?: boolean, separator?: string} = {}): string {
+	const padStart = (number: number, length = 2): string => number.toString().padStart(length, "0");
+	const parts = [];
+	if (!options.excludeDate) parts.push([padStart(date.getFullYear(), 4), padStart(date.getMonth() + 1), padStart(date.getDate())].join("-"));
+	if (!options.excludeTime) parts.push([date.getHours(), date.getMinutes(), date.getSeconds()].map(item => padStart(item)).join(":"));
+	return parts.join(options.separator ?? " ");
+}

package/src/Client/Duration.ts

@@ -0,0 +1,30 @@
+/**
+ * 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];

package/src/Client/Html/Context.ts

@@ -0,0 +1,44 @@
+/**
+ * Defines contextual modifiers.
+ */
+export const Context = Object.freeze({
+
+	/**
+	 * A danger.
+	 */
+	Danger: "danger",
+
+	/**
+	 * A warning.
+	 */
+	Warning: "warning",
+
+	/**
+	 * An information.
+	 */
+	Info: "info",
+
+	/**
+	 * A success.
+	 */
+	Success: "success"
+});
+
+/**
+ * Defines contextual modifiers.
+ */
+export type Context = typeof Context[keyof typeof Context];
+
+/**
+ * Gets the icon corresponding to the specified context.
+ * @param context The context.
+ * @returns The icon corresponding to the specified context.
+ */
+export function contextIcon(context: Context): string {
+	switch (context) {
+		case Context.Danger: return "error";
+		case Context.Success: return "check_circle";
+		case Context.Warning: return "warning";
+		default: return "info";
+	}
+}

package/src/Client/Html/File.ts

@@ -0,0 +1,85 @@
+import {Duration} from "#Base/Duration.js";
+
+/**
+ * Downloads the specified file.
+ * @param file The file to be downloaded.
+ */
+export function downloadFile(file: File): void {
+	const url = URL.createObjectURL(file);
+	const anchor = document.createElement("a");
+	anchor.download = file.name;
+	anchor.href = url;
+
+	document.body.appendChild(anchor);
+	anchor.click();
+	document.body.removeChild(anchor);
+	URL.revokeObjectURL(url);
+}
+
+/**
+ * Downloads the specified text content.
+ * @param text The text content.
+ * @param fileName The file name.
+ * @param options The optional attributes for the file.
+ */
+export function downloadString(text: string, fileName: string, options: FilePropertyBag = {}): void {
+	downloadFile(new File([text], fileName, options));
+}
+
+/**
+ * Opens the specified file.
+ * @param file The file to be opened.
+ * @param options Value indicating whether to open the file in a new tab.
+ */
+export function openFile(file: File, options: {newTab?: boolean} = {}): void {
+	const url = URL.createObjectURL(file);
+	if (!options.newTab) {
+		location.assign(url);
+		return;
+	}
+
+	const handle = window.open(url, "_blank");
+	if (!handle)  {
+		location.assign(url);
+		return;
+	}
+
+	const timer = window.setInterval(() => {
+		if (!handle.closed) return;
+		clearInterval(timer);
+		URL.revokeObjectURL(url);
+	}, 5 * Duration.Second);
+}
+
+/**
+ * Prints the specified file.
+ * @param file The file to be printed.
+ */
+export function printFile(file: File): void {
+	const url = URL.createObjectURL(file);
+	const frame = document.createElement("iframe");
+	frame.addEventListener("load", () => frame.contentWindow?.print());
+	frame.hidden = true;
+	frame.src = url;
+
+	window.addEventListener("focus", () => {
+		document.body.removeChild(frame);
+		URL.revokeObjectURL(url);
+	}, {once: true});
+
+	document.body.appendChild(frame);
+}
+
+/**
+ * Converts the specified file to a data URL.
+ * @param file The file to convert.
+ * @returns The data URL corresponding to the given file.
+ */
+export function toDataUrl(file: File): Promise<URL> {
+	return new Promise((resolve, reject) => {
+		const reader = new FileReader;
+		reader.addEventListener("error", reject);
+		reader.addEventListener("load", () => resolve(new URL(reader.result as string)));
+		reader.readAsDataURL(file);
+	});
+}

package/src/Client/Html/tsconfig.json

@@ -9,5 +9,8 @@
 		"outDir": "../../../lib/Html",
 		"rootDir": ".",
 		"tsBuildInfoFile": "../../../var/Html.tsbuildinfo"
-	}
+	},
+	"references": [
+		{"path": "../Base/tsconfig.json"}
+	]
 }

package/src/Client/UI/LoadingIndicator.ts

@@ -1,12 +1,9 @@
 import type {ILoadingIndicator} from "#Abstractions/ILoadingIndicator.js";
-import {html, LitElement, type TemplateResult} from "lit";
-import {customElement} from "lit/decorators.js";
 
 /**
  * A component that shows up when an HTTP request starts, and hides when all concurrent HTTP requests are completed.
  */
-@customElement("loading-indicator")
-export class LoadingIndicator extends LitElement implements ILoadingIndicator {
+export class LoadingIndicator extends HTMLElement implements ILoadingIndicator {
 
 	/**
 	 * The number of concurrent HTTP requests.
@@ -19,6 +16,14 @@ export class LoadingIndicator extends LitElement implements ILoadingIndicator {
 	constructor() {
 		super();
 		this.hidden = true;
+		this.attachShadow({mode: "open"}).appendChild(document.createElement("slot"));
+	}
+
+	/**
+	 * Registers the component.
+	 */
+	static {
+		customElements.define("loading-indicator", this);
 	}
 
 	/**
@@ -42,14 +47,6 @@ export class LoadingIndicator extends LitElement implements ILoadingIndicator {
 			document.body.classList.remove("loading");
 		}
 	}
-
-	/**
-	 * Renders this component.
-	 * @returns The view template.
-	 */
-	protected override render(): TemplateResult {
-		return html`<slot></slot>`;
-	}
 }
 
 /**

package/src/Client/UI/MenuActivator.ts

@@ -0,0 +1,46 @@
+/**
+ * A component that activates the items of a menu based on the current document URL.
+ */
+export class MenuActivator extends HTMLElement {
+
+	/**
+	 * Creates a new menu activator.
+	 */
+	constructor() {
+		super();
+		this.attachShadow({mode: "open"}).appendChild(document.createElement("slot"));
+	}
+
+	/**
+	 * Registers the component.
+	 */
+	static {
+		customElements.define("menu-activator", this);
+	}
+
+	/**
+	 * Method invoked when this component is connected.
+	 */
+	connectedCallback(): void {
+		const menu = this.shadowRoot!.querySelector("slot")!.assignedElements().at(0);
+		if (menu) for (const anchor of menu.getElementsByTagName("a"))
+			if (anchor.href != location.href) anchor.classList.remove("active");
+			else {
+				anchor.classList.add("active");
+				anchor.closest(".nav-item.dropdown")?.querySelector(".nav-link")?.classList.add("active");
+			}
+	}
+}
+
+/**
+ * Declaration merging.
+ */
+declare global {
+
+	/**
+	 * The map of HTML tag names.
+	 */
+	interface HTMLElementTagNameMap {
+		"menu-activator": MenuActivator;
+	}
+}

package/src/Client/UI/OfflineIndicator.ts

@@ -1,11 +1,7 @@
-import {html, LitElement, type TemplateResult} from "lit";
-import {customElement} from "lit/decorators.js";
-
 /**
  * A component that shows up when the network is unavailable, and hides when connectivity is restored.
  */
-@customElement("offline-indicator")
-export class OfflineIndicator extends LitElement {
+export class OfflineIndicator extends HTMLElement {
 
 	/**
 	 * Creates a new offline indicator.
@@ -13,22 +9,28 @@ export class OfflineIndicator extends LitElement {
 	constructor() {
 		super();
 		this.hidden = navigator.onLine;
+		this.attachShadow({mode: "open"}).appendChild(document.createElement("slot"));
+	}
+
+	/**
+	 * Registers the component.
+	 */
+	static {
+		customElements.define("offline-indicator", this);
 	}
 
 	/**
 	 * Method invoked when this component is connected.
 	 */
-	override connectedCallback(): void {
-		super.connectedCallback();
+	connectedCallback(): void {
 		for (const event of ["online", "offline"]) addEventListener(event, this);
 	}
 
 	/**
 	 * Method invoked when this component is disconnected.
 	 */
-	override disconnectedCallback(): void {
+	disconnectedCallback(): void {
 		for (const event of ["online", "offline"]) removeEventListener(event, this);
-		super.disconnectedCallback();
 	}
 
 	/**
@@ -37,14 +39,6 @@ export class OfflineIndicator extends LitElement {
 	handleEvent(): void {
 		this.hidden = navigator.onLine;
 	}
-
-	/**
-	 * Renders this component.
-	 * @returns The view template.
-	 */
-	protected override render(): TemplateResult {
-		return html`<slot></slot>`;
-	}
 }
 
 /**