@cedx/base 0.6.0 → 0.8.0

package/lib/Net/Mime/MediaType.js

@@ -0,0 +1,150 @@
+/**
+ * Provides the strings used to specify the media type.
+ */
+export const MediaType = Object.freeze({
+    /**
+     * Specifies the kind of application data.
+     */
+    Application: Object.freeze({
+        /**
+         * Specifies that the application data consists of url-encoded key-value pairs.
+         */
+        FormUrlEncoded: "application/x-www-form-urlencoded",
+        /**
+         * Specifies that the application data is in gzip format.
+         */
+        GZip: "application/gzip",
+        /**
+         * Specifies that the application data is in JSON format.
+         */
+        Json: "application/json",
+        /**
+         * Specifies that the application data is in Web Application Manifest.
+         */
+        Manifest: "application/manifest+json",
+        /**
+         * Specifies that the application data is not interpreted.
+         */
+        Octet: "application/octet-stream",
+        /**
+         * Specifies that the application data is in Portable Document Format (PDF).
+         */
+        Pdf: "application/pdf",
+        /**
+         * Specifies that the application data is a SOAP document.
+         */
+        Soap: "application/soap+xml",
+        /**
+         * Specifies that the application data is in WASM format.
+         */
+        Wasm: "application/wasm",
+        /**
+         * Specifies that the application data is in XML format.
+         */
+        Xml: "application/xml",
+        /**
+         * Specifies that the application data is compressed.
+         */
+        Zip: "application/zip"
+    }),
+    /**
+     * Specifies the kind of font data.
+     */
+    Font: Object.freeze({
+        /**
+         * Specifies that the font data is in TrueType font (TTF) format.
+         */
+        Ttf: "font/ttf",
+        /**
+         * Specifies that the font data is in WOFF format.
+         */
+        Woff: "font/woff",
+        /**
+         * Specifies that the font data is in WOFF2 format.
+         */
+        Woff2: "font/woff2"
+    }),
+    /**
+     * Specifies the kind of image data.
+     */
+    Image: Object.freeze({
+        /**
+         * Specifies that the image data is in AVIF format.
+         */
+        Avif: "image/avif",
+        /**
+         * Specifies that the image data is in GIF format.
+         */
+        Gif: "image/gif",
+        /**
+         * Specifies that the image data is in ICO format.
+         */
+        Icon: "image/x-icon",
+        /**
+         * Specifies that the image data is in JPEG format.
+         */
+        Jpeg: "image/jpeg",
+        /**
+         * Specifies that the image data is in PNG format.
+         */
+        Png: "image/png",
+        /**
+         * Specifies that the image data is in SVG format.
+         */
+        Svg: "image/svg+xml",
+        /**
+         * Specifies that the image data is in WEBP format.
+         */
+        WebP: "image/webp"
+    }),
+    /**
+     * Specifies the kind of multipart data.
+     */
+    Multipart: Object.freeze({
+        /**
+         * Specifies that the multipart data is in form data format.
+         */
+        FormData: "multipart/form-data",
+        /**
+         * Specifies that the multipart data is in mixed format.
+         */
+        Mixed: "multipart/mixed"
+    }),
+    /**
+     * Specifies the kind of text data.
+     */
+    Text: Object.freeze({
+        /**
+         * Specifies that the text data is in CSS format.
+         */
+        Css: "text/css",
+        /**
+         * Specifies that the text data is in CSV format.
+         */
+        Csv: "text/csv",
+        /**
+         * Specifies that the text data is in event stream format.
+         */
+        EventStream: "text/event-stream",
+        /**
+         * Specifies that the text data is in HTML format.
+         */
+        Html: "text/html",
+        /**
+         * Specifies that the text data is in JavaScript format.
+         */
+        JavaScript: "text/javascript",
+        /**
+         * Specifies that the text data is in Markdown format.
+         */
+        Markdown: "text/markdown",
+        /**
+         * Specifies that the text data is in plain text format.
+         */
+        Plain: "text/plain",
+        /**
+         * Specifies that the text data is in XML format.
+         */
+        Xml: "text/xml"
+    })
+});

package/lib/{Number.d.ts → NumberExtensions.d.ts}

@@ -5,4 +5,4 @@
  * @returns The value rounded to the given precision.
  */
 export declare function round(value: number, precision?: number): number;
-//# sourceMappingURL=Number.d.ts.map
+//# sourceMappingURL=NumberExtensions.d.ts.map

package/lib/NumberExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumberExtensions.d.ts","sourceRoot":"","sources":["../src/Client/NumberExtensions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM,CAG1D"}

package/lib/{String.d.ts → StringExtensions.d.ts}

@@ -56,4 +56,4 @@ export declare function truncate(value: string, length: number, ellipsis?: strin
  * @returns The processed string.
  */
 export declare function xmlEscape(value: string): string;
-//# sourceMappingURL=String.d.ts.map
+//# sourceMappingURL=StringExtensions.d.ts.map

package/lib/StringExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringExtensions.d.ts","sourceRoot":"","sources":["../src/Client/StringExtensions.ts"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,IAAI,CAAC,MAAM,GAAC,MAA2B,GAAG,MAAM,CAEjG;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,EAAE,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAG5C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAG1E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/lib/{Html → UI}/AppTheme.d.ts

@@ -3,15 +3,15 @@
  */
 export declare const AppTheme: Readonly<{
     /**
-     * The system predefined theme mode.
+     * The system theme.
      */
     System: "System";
     /**
-     * The light predefined theme mode.
+     * The light theme.
      */
     Light: "Light";
     /**
-     * The dark predefined theme mode.
+     * The dark theme.
      */
     Dark: "Dark";
 }>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"AppTheme.d.ts","sourceRoot":"","sources":["../../src/Client/UI/AppTheme.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,QAAQ;IAEpB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAM/C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAMhD"}

package/lib/{Html → UI}/AppTheme.js

@@ -3,15 +3,15 @@
  */
 export const AppTheme = Object.freeze({
     /**
-     * The system predefined theme mode.
+     * The system theme.
      */
     System: "System",
     /**
-     * The light predefined theme mode.
+     * The light theme.
      */
     Light: "Light",
     /**
-     * The dark predefined theme mode.
+     * The dark theme.
      */
     Dark: "Dark"
 });

package/lib/UI/{Component.d.ts → Components/ComponentBase.d.ts}

@@ -1,8 +1,8 @@
 import { LitElement, type CSSResultGroup } from "lit";
 /**
- * The optional base class for UI components. Alternatively, components may extend {@link LitElement} directly.
+ * Optional base class for UI components. Alternatively, components may extend {@link LitElement} directly.
  */
-export declare abstract class Component extends LitElement {
+export declare abstract class ComponentBase extends LitElement {
     #private;
     /**
      * The component styles.
@@ -10,10 +10,10 @@ export declare abstract class Component extends LitElement {
     static styles: CSSResultGroup;
     /**
      * Creates a new component.
-     * @param options Value indicating whether this component uses a shadow root.
+     * @param options Value indicating whether a shadow DOM tree should be attached to this component.
      */
     constructor(options?: {
-        shadowRoot?: boolean;
+        attachShadow?: boolean;
     });
     /**
      * Returns the node into which this component should render.
@@ -21,4 +21,4 @@ export declare abstract class Component extends LitElement {
      */
     protected createRenderRoot(): DocumentFragment | HTMLElement;
 }
-//# sourceMappingURL=Component.d.ts.map
+//# sourceMappingURL=ComponentBase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentBase.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/ComponentBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,KAAK,cAAc,EAAC,MAAM,KAAK,CAAC;AAEpD;;GAEG;AACH,8BAAsB,aAAc,SAAQ,UAAU;;IAErD;;OAEG;IACH,OAAgB,MAAM,EAAE,cAAc,CAAiC;IAOvE;;;OAGG;gBACS,OAAO,GAAE;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAM;IAKlD;;;OAGG;cACgB,gBAAgB,IAAI,gBAAgB,GAAC,WAAW;CAGnE"}

package/lib/UI/Components/ComponentBase.js

@@ -0,0 +1,29 @@
+import { LitElement } from "lit";
+/**
+ * Optional base class for UI components. Alternatively, components may extend {@link LitElement} directly.
+ */
+export class ComponentBase extends LitElement {
+    /**
+     * The component styles.
+     */
+    static styles = [document.adoptedStyleSheets];
+    /**
+     * Value indicating whether a shadow DOM tree should be attached to this component.
+     */
+    #attachShadow;
+    /**
+     * Creates a new component.
+     * @param options Value indicating whether a shadow DOM tree should be attached to this component.
+     */
+    constructor(options = {}) {
+        super();
+        this.#attachShadow = options.attachShadow ?? false;
+    }
+    /**
+     * Returns the node into which this component should render.
+     * @returns The node into which this component should render.
+     */
+    createRenderRoot() {
+        return this.#attachShadow ? super.createRenderRoot() : this;
+    }
+}

package/lib/UI/{LoadingIndicator.d.ts → Components/LoadingIndicator.d.ts}

@@ -1,8 +1,7 @@
-import type { ILoadingIndicator } from "#Abstractions/ILoadingIndicator.js";
 /**
  * A component that shows up when an HTTP request starts, and hides when all concurrent HTTP requests are completed.
  */
-export declare class LoadingIndicator extends HTMLElement implements ILoadingIndicator {
+export declare class LoadingIndicator extends HTMLElement {
     #private;
     /**
      * Starts the loading indicator.

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

@@ -0,0 +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;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/Components/MenuActivator.d.ts.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"OfflineIndicator.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/OfflineIndicator.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAEhD;;OAEG;;IAaH;;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/Components/ThemeDropdown.d.ts

@@ -0,0 +1,67 @@
+import { AppTheme } from "../AppTheme.js";
+import { MenuAlignment } from "../MenuAlignment.js";
+/**
+ * A dropdown menu for switching the application theme.
+ */
+export declare class ThemeDropdown extends HTMLElement {
+    #private;
+    /**
+     * The list of observed attributes.
+     */
+    static readonly observedAttributes: string[];
+    /**
+     * Creates a new theme dropdown.
+     */
+    constructor();
+    /**
+     * The alignment of the dropdown menu.
+     */
+    get alignment(): MenuAlignment;
+    set alignment(value: MenuAlignment);
+    /**
+     * The current application theme.
+     */
+    get appTheme(): AppTheme;
+    set appTheme(value: AppTheme);
+    /**
+     * The label of the dropdown menu.
+     */
+    get label(): string;
+    set label(value: string);
+    /**
+     * The key of the storage entry providing the saved application theme.
+     */
+    get storageKey(): string;
+    set storageKey(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;
+    /**
+     * Method invoked when this component is connected.
+     */
+    connectedCallback(): void;
+    /**
+     * Method invoked when this component is disconnected.
+     */
+    disconnectedCallback(): void;
+    /**
+     * Handles the events.
+     */
+    handleEvent(): void;
+}
+/**
+ * Declaration merging.
+ */
+declare global {
+    /**
+     * The map of HTML tag names.
+     */
+    interface HTMLElementTagNameMap {
+        "theme-dropdown": ThemeDropdown;
+    }
+}
+//# sourceMappingURL=ThemeDropdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeDropdown.d.ts","sourceRoot":"","sources":["../../../src/Client/UI/Components/ThemeDropdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAU,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAElD;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAE7C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,kBAAkB,WAAsC;IAOxE;;OAEG;;IAaH;;OAEG;IACH,IAAI,SAAS,IAAI,aAAa,CAG7B;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,aAAa,EAEjC;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,QAAQ,CAGvB;IACD,IAAI,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAG3B;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;IAwB/F;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAMzB;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAI5B;;OAEG;IACH,WAAW,IAAI,IAAI;CAsBnB;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

@@ -0,0 +1,140 @@
+import { AppTheme, getIcon } from "../AppTheme.js";
+import { MenuAlignment } from "../MenuAlignment.js";
+/**
+ * A dropdown menu for switching the application theme.
+ */
+export class ThemeDropdown extends HTMLElement {
+    /**
+     * The list of observed attributes.
+     */
+    static observedAttributes = ["alignment", "apptheme", "label"];
+    /**
+     * The media query used to check the application theme.
+     */
+    #mediaQuery = matchMedia("(prefers-color-scheme: dark)");
+    /**
+     * Creates a new theme dropdown.
+     */
+    constructor() {
+        super();
+        for (const button of this.querySelectorAll("button"))
+            button.addEventListener("click", this.#setTheme.bind(this));
+    }
+    /**
+     * Registers the component.
+     */
+    static {
+        customElements.define("theme-dropdown", this);
+    }
+    /**
+     * The alignment of the dropdown menu.
+     */
+    get alignment() {
+        const value = this.getAttribute("alignment");
+        return Object.values(MenuAlignment).includes(value) ? value : MenuAlignment.End;
+    }
+    set alignment(value) {
+        this.setAttribute("alignment", value);
+    }
+    /**
+     * The current application theme.
+     */
+    get appTheme() {
+        const value = this.getAttribute("apptheme");
+        return Object.values(AppTheme).includes(value) ? value : AppTheme.System;
+    }
+    set appTheme(value) {
+        this.setAttribute("apptheme", value);
+        localStorage.setItem(this.storageKey, this.appTheme);
+    }
+    /**
+     * The label of the dropdown menu.
+     */
+    get label() {
+        const value = this.getAttribute("label") ?? "";
+        return value.trim() || "Thème";
+    }
+    set label(value) {
+        this.setAttribute("label", value);
+    }
+    /**
+     * The key of the storage entry providing the saved application theme.
+     */
+    get storageKey() {
+        const value = this.getAttribute("storagekey") ?? "";
+        return value.trim() || "AppTheme";
+    }
+    set storageKey(value) {
+        this.setAttribute("storagekey", 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 "alignment": {
+                    const alignment = Object.values(MenuAlignment).includes(newValue) ? newValue : MenuAlignment.End;
+                    const { classList } = this.querySelector(".dropdown-menu");
+                    if (alignment == MenuAlignment.End)
+                        classList.add("dropdown-menu-end");
+                    else
+                        classList.remove("dropdown-menu-end");
+                    break;
+                }
+                case "apptheme": {
+                    const appTheme = Object.values(AppTheme).includes(newValue) ? newValue : AppTheme.System;
+                    this.querySelector(".dropdown-toggle > .icon").textContent = getIcon(appTheme);
+                    this.querySelector(`button[data-theme="${appTheme}"]`).appendChild(this.querySelector(".dropdown-item > .icon"));
+                    this.#applyTheme();
+                    break;
+                }
+                case "label": {
+                    this.querySelector(".dropdown-toggle > span").textContent = (newValue ?? "").trim() || "Thème";
+                    break;
+                }
+                // No default
+            }
+    }
+    /**
+     * Method invoked when this component is connected.
+     */
+    connectedCallback() {
+        this.#mediaQuery.addEventListener("change", this);
+        const appTheme = localStorage.getItem(this.storageKey);
+        if (appTheme)
+            this.setAttribute("apptheme", appTheme);
+    }
+    /**
+     * Method invoked when this component is disconnected.
+     */
+    disconnectedCallback() {
+        this.#mediaQuery.removeEventListener("change", this);
+    }
+    /**
+     * Handles the events.
+     */
+    handleEvent() {
+        this.#applyTheme();
+    }
+    /**
+     * Applies the application theme to the document.
+     */
+    #applyTheme() {
+        const { appTheme } = this;
+        const bsTheme = appTheme == AppTheme.System ? (this.#mediaQuery.matches ? AppTheme.Dark : AppTheme.Light) : appTheme;
+        document.documentElement.dataset.bsTheme = bsTheme.toLowerCase();
+    }
+    /**
+     * Changes the current application theme.
+     * @param event The dispatched event.
+     */
+    #setTheme(event) {
+        event.preventDefault();
+        const button = event.target.closest("button");
+        this.appTheme = button.dataset.theme;
+    }
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../src/Client/UI/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,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAOhD"}

package/lib/UI/FormExtensions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Represents a form control.
+ */
+export type FormControl = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
+/**
+ * Gets all controls belonging to the specified form.
+ * @param form The form element.
+ * @returns The controls belonging to the specified form.
+ */
+export declare function getFormControls(form: HTMLFormElement): FormControl[];
+/**
+ * Returns the first invalid control from the specified form.
+ * @param form The form element.
+ * @returns The first invalid control, or `null` if all controls are valid.
+ */
+export declare function invalidControl(form: HTMLFormElement): FormControl | null;
+/**
+ * Returns a value indicating whether the specified element is a form control.
+ * @param element The element to check.
+ * @returns `true` if the specified element is a form control, otherwise `false`.
+ */
+export declare function isFormControl(element: Element): element is FormControl;
+/**
+ * Resets the validity of the specified element.
+ * @param element The element to process.
+ */
+export declare function resetValidity(element: Element): void;
+/**
+ * Removes whitespace from both ends of the value of the specified element.
+ * @param element The element to process.
+ */
+export declare function trimControl(element: Element): void;
+//# sourceMappingURL=FormExtensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormExtensions.d.ts","sourceRoot":"","sources":["../../src/Client/UI/FormExtensions.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAC,iBAAiB,GAAC,mBAAmB,CAAC;AAEjF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,EAAE,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,GAAC,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,WAAW,CAEtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGpD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAIlD"}

package/lib/UI/FormExtensions.js

@@ -0,0 +1,50 @@
+/**
+ * The types of form controls that are not text inputs.
+ */
+const nonTextualTypes = new Set(["button", "checkbox", "file", "hidden", "image", "password", "radio", "range", "reset", "submit"]);
+/**
+ * Gets all controls belonging to the specified form.
+ * @param form The form element.
+ * @returns The controls belonging to the specified form.
+ */
+export function getFormControls(form) {
+    return Array.from(form.elements).filter(isFormControl);
+}
+/**
+ * Returns the first invalid control from the specified form.
+ * @param form The form element.
+ * @returns The first invalid control, or `null` if all controls are valid.
+ */
+export function invalidControl(form) {
+    return form.querySelector(":not(fieldset):invalid");
+}
+/**
+ * Returns a value indicating whether the specified element is a form control.
+ * @param element The element to check.
+ * @returns `true` if the specified element is a form control, otherwise `false`.
+ */
+export function isFormControl(element) {
+    return element instanceof HTMLInputElement || element instanceof HTMLSelectElement || element instanceof HTMLTextAreaElement;
+}
+/**
+ * Resets the validity of the specified element.
+ * @param element The element to process.
+ */
+export function resetValidity(element) {
+    if (element instanceof HTMLFormElement)
+        getFormControls(element).forEach(control => control.setCustomValidity(""));
+    else if (isFormControl(element))
+        element.setCustomValidity("");
+}
+/**
+ * Removes whitespace from both ends of the value of the specified element.
+ * @param element The element to process.
+ */
+export function trimControl(element) {
+    if (element instanceof HTMLFormElement)
+        getFormControls(element).forEach(trimControl);
+    else if (element instanceof HTMLInputElement && !nonTextualTypes.has(element.type))
+        element.value = element.value.trim();
+    else if (element instanceof HTMLTextAreaElement)
+        element.value = element.value.trim();
+}

package/lib/UI/MenuAlignment.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Defines the alignment of a dropdown menu.
+ */
+export declare const MenuAlignment: Readonly<{
+    /**
+     * The dropdown menu is left aligned.
+     */
+    Start: "Start";
+    /**
+     * The dropdown menu is right aligned.
+     */
+    End: "End";
+}>;
+/**
+ * Defines the alignment of a dropdown menu.
+ */
+export type MenuAlignment = typeof MenuAlignment[keyof typeof MenuAlignment];
+//# sourceMappingURL=MenuAlignment.d.ts.map

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

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

package/lib/UI/MenuAlignment.js

@@ -0,0 +1,13 @@
+/**
+ * Defines the alignment of a dropdown menu.
+ */
+export const MenuAlignment = Object.freeze({
+    /**
+     * The dropdown menu is left aligned.
+     */
+    Start: "Start",
+    /**
+     * The dropdown menu is right aligned.
+     */
+    End: "End"
+});

package/lib/{Html → UI}/ViewportScroller.d.ts

@@ -23,7 +23,7 @@ export declare class ViewportScroller {
     get scrollOffset(): number;
     /**
      * Scrolls to the specified anchor.
-     * @param anchor The identifier or name of an elment.
+     * @param anchor The identifier or name of an element.
      * @param options Value indicating whether scrolling is instant or animates smoothly.
      */
     scrollToAnchor(anchor: string, options?: ScrollOptions): void;

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

@@ -0,0 +1 @@
+{"version":3,"file":"ViewportScroller.d.ts","sourceRoot":"","sources":["../../src/Client/UI/ViewportScroller.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;IAEnC;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAA;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,qBAAa,gBAAgB;;IAY5B;;;OAGG;gBACS,QAAQ,GAAE,MAAM,OAAqE;IAIjG;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAWzB;IAED;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAKjE;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAMpE;;;;;OAKG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAIzE;;;OAGG;IACH,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI;CAG9C"}