@cedx/ui 0.5.0 → 0.7.0

package/Distributable/Bootstrap.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Disposes all popovers attached to the specified element.
+ * @param element The source element.
+ */
+export declare function disposePopovers(element: Element): void;
+/**
+ * Disposes all tooltips attached to the specified element.
+ * @param element The source element.
+ */
+export declare function disposeTooltips(element: Element): void;
+//# sourceMappingURL=Bootstrap.d.ts.map

package/Distributable/Bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bootstrap.d.ts","sourceRoot":"","sources":["../Sources/Client/Bootstrap.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD"}

package/Distributable/Bootstrap.js

@@ -0,0 +1,17 @@
+import { Popover, Tooltip } from "bootstrap";
+/**
+ * Disposes all popovers attached to the specified element.
+ * @param element The source element.
+ */
+export function disposePopovers(element) {
+    for (const node of element.querySelectorAll('[data-bs-toggle="popover"]'))
+        Popover.getInstance(node)?.dispose();
+}
+/**
+ * Disposes all tooltips attached to the specified element.
+ * @param element The source element.
+ */
+export function disposeTooltips(element) {
+    for (const node of element.querySelectorAll('[data-bs-toggle="tooltip"]'))
+        Tooltip.getInstance(node)?.dispose();
+}

package/Distributable/Components/MenuActivator.d.ts.map

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

package/Distributable/Components/MenuActivator.js

@@ -33,8 +33,10 @@ export class MenuActivator extends HTMLElement {
     #update() {
         for (const element of this.querySelectorAll(".active"))
             element.classList.remove("active");
+        const { origin, pathname } = new URL(location.href);
+        const href = `${origin}${pathname}`;
         for (const anchor of this.querySelectorAll("a"))
-            if (anchor.href == location.href) {
+            if (anchor.href == href) {
                 anchor.classList.add("active");
                 anchor.closest(".dropdown")?.querySelector(".dropdown-toggle")?.classList.add("active");
             }

package/Distributable/Scenario.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Defines the scenario used in data validation.
+ */
+export declare const Scenario: Readonly<{
+    /**
+     * A scenario in which the underlying model is created.
+     */
+    Creation: "Creation";
+    /**
+     * A scenario in which the underlying model is updated.
+     */
+    Update: "Update";
+}>;
+/**
+ * Defines the scenario used in data validation.
+ */
+export type Scenario = typeof Scenario[keyof typeof Scenario];
+//# sourceMappingURL=Scenario.d.ts.map

package/Distributable/Scenario.d.ts.map

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

package/Distributable/Scenario.js

@@ -0,0 +1,13 @@
+/**
+ * Defines the scenario used in data validation.
+ */
+export const Scenario = Object.freeze({
+    /**
+     * A scenario in which the underlying model is created.
+     */
+    Creation: "Creation",
+    /**
+     * A scenario in which the underlying model is updated.
+     */
+    Update: "Update"
+});

package/Distributable/Sort.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Specifies the direction of a sorted property.
+ */
+export declare const SortDirection: Readonly<{
+    /**
+     * The sort is ascending.
+     */
+    Ascending: "Ascending";
+    /**
+     * The sort is descending.
+     */
+    Descending: "Descending";
+}>;
+/**
+ * Specifies the direction of a sorted property.
+ */
+export type SortDirection = typeof SortDirection[keyof typeof SortDirection];
+/**
+ * Holds the name of a property and the direction to sort by.
+ */
+export type SortedProperty = [string, SortDirection];
+/**
+ * Represents information relevant to the sorting of data items.
+ */
+export declare class Sort implements Iterable<SortedProperty> {
+    #private;
+    /**
+     * Creates new sort.
+     * @param properties The list of properties to be sorted.
+     */
+    constructor(properties?: SortedProperty[]);
+    /**
+     * The list of sort properties.
+     */
+    get keys(): string[];
+    /**
+     * The number of properties in this sort.
+     */
+    get length(): number;
+    /**
+     * Creates a new sort from the specified property and direction.
+     * @param property The property name.
+     * @param direction The sort direction.
+     * @returns The sort corresponding to the property and direction.
+     */
+    static of(property: string, direction?: SortDirection): Sort;
+    /**
+     * Creates a new sort from the specified string.
+     * @param value A string representing a sort.
+     * @returns The sort corresponding to the specified string.
+     */
+    static parse(value: string): Sort;
+    /**
+     * Returns a new iterator that allows iterating the entries of this sort.
+     * @returns An iterator over the sort properties.
+     */
+    [Symbol.iterator](): Iterator<SortedProperty>;
+    /**
+     * Appends the specified property to this sort.
+     * @param property The property name.
+     * @param direction The sort direction.
+     * @throws `Error` when a property with the same name already exists.
+     */
+    add(property: string, direction: SortDirection): void;
+    /**
+     * Removes all properties from this sort.
+     */
+    clear(): void;
+    /**
+     * Compares the specified objects, according to the current sort properties.
+     * @param x The first object to compare.
+     * @param y The second object to compare.
+     * @returns A value indicating the relationship between the two objects.
+     */
+    compare(x: object, y: object): number;
+    /**
+     * Returns a value indicating whether the specified property exists in this sort.
+     * @param property The property name.
+     * @returns `true` if the specified property exists in this sort, otherwise `false`.
+     */
+    containsKey(property: string): boolean;
+    /**
+     * Gets the direction associated with the specified property.
+     * @param property The property name.
+     * @returns The direction associated with the specified property, or `null` if the property doesn't exist.
+     */
+    get(property: string): SortDirection | null;
+    /**
+     * Gets the sorted property at the specified index.
+     * @param index The position in this sort.
+     * @returns The sorted property at the specified index, or `null` if it doesn't exist.
+     */
+    getAt(index: number): SortedProperty | null;
+    /**
+     * Gets the icon corresponding to the specified property.
+     * @param property The property name.
+     * @returns The icon corresponding to the specified property.
+     */
+    getIcon(property: string): string;
+    /**
+     * Gets the index of the specified property in the underlying list.
+     * @param property The property name.
+     * @returns The index of the specified property, or `-1` if the property is not found.
+     */
+    indexOf(property: string): number;
+    /**
+     * Inserts the specified property into this sort at the specified index.
+     * @param index The position in this sort.
+     * @param property The property name.
+     * @param direction The sort direction.
+     */
+    insert(index: number, property: string, direction: SortDirection): void;
+    /**
+     * Removes the specified property from this sort.
+     * @param property The property name.
+     */
+    remove(property: string): void;
+    /**
+     * Removes the sorted property at the specified index.
+     * @param index The position in this sort.
+     */
+    removeAt(index: number): void;
+    /**
+     * Sets the direction of the specified property.
+     * @param property The property name.
+     * @param direction The sort direction.
+     */
+    set(property: string, direction: SortDirection): void;
+    /**
+     * Sets the sorted property at the specified index.
+     * @param index The position in this sort.
+     * @param property The property name.
+     * @param direction The sort direction.
+     * @throws `Error` when a property with the same name already exists at a different index.
+     */
+    setAt(index: number, property: string, direction: SortDirection): void;
+    /**
+     * Returns a JSON representation of this object.
+     * @returns The JSON representation of this object.
+     */
+    toJSON(): string;
+    /**
+     * Returns a string representation of this object.
+     * @returns The string representation of this object.
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Sort.d.ts.map

package/Distributable/Sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sort.d.ts","sourceRoot":"","sources":["../Sources/Client/Sort.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;AAE7E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAErD;;GAEG;AACH,qBAAa,IAAK,YAAW,QAAQ,CAAC,cAAc,CAAC;;IAOpD;;;OAGG;gBACS,UAAU,GAAE,cAAc,EAAO;IAI7C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,EAAE,CAEnB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,aAAuC,GAAG,IAAI;IAIrF;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC;;;OAGG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,cAAc,CAAC;IAI7C;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IAKrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAWrC;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAC,IAAI;IAKzC;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAC,IAAI;IAIzC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQjC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKjC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IAIvE;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IASrD;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI;IAMtE;;;OAGG;IACH,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAGlB"}

package/Distributable/Sort.js

@@ -0,0 +1,214 @@
+/**
+ * Specifies the direction of a sorted property.
+ */
+export const SortDirection = Object.freeze({
+    /**
+     * The sort is ascending.
+     */
+    Ascending: "Ascending",
+    /**
+     * The sort is descending.
+     */
+    Descending: "Descending"
+});
+/**
+ * Represents information relevant to the sorting of data items.
+ */
+export class Sort {
+    /**
+     * The list of sort properties.
+     */
+    #properties;
+    /**
+     * Creates new sort.
+     * @param properties The list of properties to be sorted.
+     */
+    constructor(properties = []) {
+        this.#properties = properties;
+    }
+    /**
+     * The list of sort properties.
+     */
+    get keys() {
+        return this.#properties.map(item => item[0]);
+    }
+    /**
+     * The number of properties in this sort.
+     */
+    get length() {
+        return this.#properties.length;
+    }
+    /**
+     * Creates a new sort from the specified property and direction.
+     * @param property The property name.
+     * @param direction The sort direction.
+     * @returns The sort corresponding to the property and direction.
+     */
+    static of(property, direction = SortDirection.Ascending) {
+        return new this([[property, direction]]);
+    }
+    /**
+     * Creates a new sort from the specified string.
+     * @param value A string representing a sort.
+     * @returns The sort corresponding to the specified string.
+     */
+    static parse(value) {
+        return new this((value ? value.split(",") : []).map(token => {
+            const direction = token.startsWith("-") ? SortDirection.Descending : SortDirection.Ascending;
+            return [direction == SortDirection.Ascending ? token : token.slice(1), direction];
+        }));
+    }
+    /**
+     * Returns a new iterator that allows iterating the entries of this sort.
+     * @returns An iterator over the sort properties.
+     */
+    [Symbol.iterator]() {
+        return this.#properties[Symbol.iterator]();
+    }
+    /**
+     * Appends the specified property to this sort.
+     * @param property The property name.
+     * @param direction The sort direction.
+     * @throws `Error` when a property with the same name already exists.
+     */
+    add(property, direction) {
+        if (this.containsKey(property))
+            throw new Error("A property with the same name already exists.");
+        this.#properties.push([property, direction]);
+    }
+    /**
+     * Removes all properties from this sort.
+     */
+    clear() {
+        this.#properties = [];
+    }
+    /**
+     * Compares the specified objects, according to the current sort properties.
+     * @param x The first object to compare.
+     * @param y The second object to compare.
+     * @returns A value indicating the relationship between the two objects.
+     */
+    compare(x, y) {
+        for (const [property, direction] of this.#properties) {
+            const xAttr = Reflect.get(x, property); // eslint-disable-line @typescript-eslint/no-unsafe-assignment
+            const yAttr = Reflect.get(y, property); // eslint-disable-line @typescript-eslint/no-unsafe-assignment
+            const value = xAttr > yAttr ? 1 : (xAttr < yAttr ? -1 : 0);
+            if (value)
+                return direction == SortDirection.Ascending ? value : -value;
+        }
+        return 0;
+    }
+    /**
+     * Returns a value indicating whether the specified property exists in this sort.
+     * @param property The property name.
+     * @returns `true` if the specified property exists in this sort, otherwise `false`.
+     */
+    containsKey(property) {
+        return this.#properties.some(([key]) => key == property);
+    }
+    /**
+     * Gets the direction associated with the specified property.
+     * @param property The property name.
+     * @returns The direction associated with the specified property, or `null` if the property doesn't exist.
+     */
+    get(property) {
+        for (const [key, direction] of this.#properties)
+            if (key == property)
+                return direction;
+        return null;
+    }
+    /**
+     * Gets the sorted property at the specified index.
+     * @param index The position in this sort.
+     * @returns The sorted property at the specified index, or `null` if it doesn't exist.
+     */
+    getAt(index) {
+        return this.#properties.at(index) ?? null;
+    }
+    /**
+     * Gets the icon corresponding to the specified property.
+     * @param property The property name.
+     * @returns The icon corresponding to the specified property.
+     */
+    getIcon(property) {
+        switch (this.get(property)) {
+            case SortDirection.Ascending: return "arrow_upward";
+            case SortDirection.Descending: return "arrow_downward";
+            default: return "swap_vert";
+        }
+    }
+    /**
+     * Gets the index of the specified property in the underlying list.
+     * @param property The property name.
+     * @returns The index of the specified property, or `-1` if the property is not found.
+     */
+    indexOf(property) {
+        for (const [index, [key]] of this.#properties.entries())
+            if (key == property)
+                return index;
+        return -1;
+    }
+    /**
+     * Inserts the specified property into this sort at the specified index.
+     * @param index The position in this sort.
+     * @param property The property name.
+     * @param direction The sort direction.
+     */
+    insert(index, property, direction) {
+        this.#properties.splice(index, 0, [property, direction]);
+    }
+    /**
+     * Removes the specified property from this sort.
+     * @param property The property name.
+     */
+    remove(property) {
+        this.#properties = this.#properties.filter(([key]) => key != property);
+    }
+    /**
+     * Removes the sorted property at the specified index.
+     * @param index The position in this sort.
+     */
+    removeAt(index) {
+        this.#properties.splice(index, 1);
+    }
+    /**
+     * Sets the direction of the specified property.
+     * @param property The property name.
+     * @param direction The sort direction.
+     */
+    set(property, direction) {
+        for (const [index, [key]] of this.#properties.entries())
+            if (key == property) {
+                this.#properties[index] = [key, direction];
+                return;
+            }
+        this.add(property, direction);
+    }
+    /**
+     * Sets the sorted property at the specified index.
+     * @param index The position in this sort.
+     * @param property The property name.
+     * @param direction The sort direction.
+     * @throws `Error` when a property with the same name already exists at a different index.
+     */
+    setAt(index, property, direction) {
+        const existingIndex = this.indexOf(property);
+        if (existingIndex >= 0 && existingIndex != index)
+            throw new Error("A property with the same name already exists at a different index.");
+        this.#properties[index] = [property, direction];
+    }
+    /**
+     * Returns a JSON representation of this object.
+     * @returns The JSON representation of this object.
+     */
+    toJSON() {
+        return this.toString();
+    }
+    /**
+     * Returns a string representation of this object.
+     * @returns The string representation of this object.
+     */
+    toString() {
+        return this.#properties.map(([property, direction]) => `${direction == SortDirection.Descending ? "-" : ""}${property}`).join(",");
+    }
+}

package/Sources/Client/Bootstrap.ts

@@ -0,0 +1,17 @@
+import {Popover, Tooltip} from "bootstrap";
+
+/**
+ * Disposes all popovers attached to the specified element.
+ * @param element The source element.
+ */
+export function disposePopovers(element: Element): void {
+	for (const node of element.querySelectorAll('[data-bs-toggle="popover"]')) Popover.getInstance(node)?.dispose();
+}
+
+/**
+ * Disposes all tooltips attached to the specified element.
+ * @param element The source element.
+ */
+export function disposeTooltips(element: Element): void {
+	for (const node of element.querySelectorAll('[data-bs-toggle="tooltip"]')) Tooltip.getInstance(node)?.dispose();
+}

package/Sources/Client/Components/MenuActivator.ts

@@ -37,7 +37,10 @@ export class MenuActivator extends HTMLElement {
 	 */
 	#update(): void {
 		for (const element of this.querySelectorAll(".active")) element.classList.remove("active");
-		for (const anchor of this.querySelectorAll("a")) if (anchor.href == location.href) {
+
+		const {origin, pathname} = new URL(location.href);
+		const href = `${origin}${pathname}`;
+		for (const anchor of this.querySelectorAll("a")) if (anchor.href == href) {
 			anchor.classList.add("active");
 			anchor.closest(".dropdown")?.querySelector(".dropdown-toggle")?.classList.add("active");
 		}

package/Sources/Client/Scenario.ts

@@ -0,0 +1,20 @@
+/**
+ * Defines the scenario used in data validation.
+ */
+export const Scenario = Object.freeze({
+
+	/**
+	 * A scenario in which the underlying model is created.
+	 */
+	Creation: "Creation",
+
+	/**
+	 * A scenario in which the underlying model is updated.
+	 */
+	Update: "Update"
+});
+
+/**
+ * Defines the scenario used in data validation.
+ */
+export type Scenario = typeof Scenario[keyof typeof Scenario];

package/Sources/Client/Sort.ts

@@ -0,0 +1,243 @@
+/**
+ * Specifies the direction of a sorted property.
+ */
+export const SortDirection = Object.freeze({
+
+	/**
+	 * The sort is ascending.
+	 */
+	Ascending: "Ascending",
+
+	/**
+	 * The sort is descending.
+	 */
+	Descending: "Descending"
+});
+
+/**
+ * Specifies the direction of a sorted property.
+ */
+export type SortDirection = typeof SortDirection[keyof typeof SortDirection];
+
+/**
+ * Holds the name of a property and the direction to sort by.
+ */
+export type SortedProperty = [string, SortDirection];
+
+/**
+ * Represents information relevant to the sorting of data items.
+ */
+export class Sort implements Iterable<SortedProperty> {
+
+	/**
+	 * The list of sort properties.
+	 */
+	#properties: SortedProperty[];
+
+	/**
+	 * Creates new sort.
+	 * @param properties The list of properties to be sorted.
+	 */
+	constructor(properties: SortedProperty[] = []) {
+		this.#properties = properties;
+	}
+
+	/**
+	 * The list of sort properties.
+	 */
+	get keys(): string[] {
+		return this.#properties.map(item => item[0]);
+	}
+
+	/**
+	 * The number of properties in this sort.
+	 */
+	get length(): number {
+		return this.#properties.length;
+	}
+
+	/**
+	 * Creates a new sort from the specified property and direction.
+	 * @param property The property name.
+	 * @param direction The sort direction.
+	 * @returns The sort corresponding to the property and direction.
+	 */
+	static of(property: string, direction: SortDirection = SortDirection.Ascending): Sort {
+		return new this([[property, direction]]);
+	}
+
+	/**
+	 * Creates a new sort from the specified string.
+	 * @param value A string representing a sort.
+	 * @returns The sort corresponding to the specified string.
+	 */
+	static parse(value: string): Sort {
+		return new this((value ? value.split(",") : []).map(token => {
+			const direction = token.startsWith("-") ? SortDirection.Descending : SortDirection.Ascending;
+			return [direction == SortDirection.Ascending ? token : token.slice(1), direction];
+		}));
+	}
+
+	/**
+	 * Returns a new iterator that allows iterating the entries of this sort.
+	 * @returns An iterator over the sort properties.
+	 */
+	[Symbol.iterator](): Iterator<SortedProperty> {
+		return this.#properties[Symbol.iterator]();
+	}
+
+	/**
+	 * Appends the specified property to this sort.
+	 * @param property The property name.
+	 * @param direction The sort direction.
+	 * @throws `Error` when a property with the same name already exists.
+	 */
+	add(property: string, direction: SortDirection): void {
+		if (this.containsKey(property)) throw new Error("A property with the same name already exists.");
+		this.#properties.push([property, direction]);
+	}
+
+	/**
+	 * Removes all properties from this sort.
+	 */
+	clear(): void {
+		this.#properties = [];
+	}
+
+	/**
+	 * Compares the specified objects, according to the current sort properties.
+	 * @param x The first object to compare.
+	 * @param y The second object to compare.
+	 * @returns A value indicating the relationship between the two objects.
+	 */
+	compare(x: object, y: object): number {
+		for (const [property, direction] of this.#properties) {
+			const xAttr = Reflect.get(x, property); // eslint-disable-line @typescript-eslint/no-unsafe-assignment
+			const yAttr = Reflect.get(y, property); // eslint-disable-line @typescript-eslint/no-unsafe-assignment
+			const value = xAttr > yAttr ? 1 : (xAttr < yAttr ? -1 : 0);
+			if (value) return direction == SortDirection.Ascending ? value : -value;
+		}
+
+		return 0;
+	}
+
+	/**
+	 * Returns a value indicating whether the specified property exists in this sort.
+	 * @param property The property name.
+	 * @returns `true` if the specified property exists in this sort, otherwise `false`.
+	 */
+	containsKey(property: string): boolean {
+		return this.#properties.some(([key]) => key == property);
+	}
+
+	/**
+	 * Gets the direction associated with the specified property.
+	 * @param property The property name.
+	 * @returns The direction associated with the specified property, or `null` if the property doesn't exist.
+	 */
+	get(property: string): SortDirection|null {
+		for (const [key, direction] of this.#properties) if (key == property) return direction;
+		return null;
+	}
+
+	/**
+	 * Gets the sorted property at the specified index.
+	 * @param index The position in this sort.
+	 * @returns The sorted property at the specified index, or `null` if it doesn't exist.
+	 */
+	getAt(index: number): SortedProperty|null {
+		return this.#properties.at(index) ?? null;
+	}
+
+	/**
+	 * Gets the icon corresponding to the specified property.
+	 * @param property The property name.
+	 * @returns The icon corresponding to the specified property.
+	 */
+	getIcon(property: string): string {
+		switch (this.get(property)) {
+			case SortDirection.Ascending: return "arrow_upward";
+			case SortDirection.Descending: return "arrow_downward";
+			default: return "swap_vert";
+		}
+	}
+
+	/**
+	 * Gets the index of the specified property in the underlying list.
+	 * @param property The property name.
+	 * @returns The index of the specified property, or `-1` if the property is not found.
+	 */
+	indexOf(property: string): number {
+		for (const [index, [key]] of this.#properties.entries()) if (key == property) return index;
+		return -1;
+	}
+
+	/**
+	 * Inserts the specified property into this sort at the specified index.
+	 * @param index The position in this sort.
+	 * @param property The property name.
+	 * @param direction The sort direction.
+	 */
+	insert(index: number, property: string, direction: SortDirection): void {
+		this.#properties.splice(index, 0, [property, direction]);
+	}
+
+	/**
+	 * Removes the specified property from this sort.
+	 * @param property The property name.
+	 */
+	remove(property: string): void {
+		this.#properties = this.#properties.filter(([key]) => key != property);
+	}
+
+	/**
+	 * Removes the sorted property at the specified index.
+	 * @param index The position in this sort.
+	 */
+	removeAt(index: number): void {
+		this.#properties.splice(index, 1);
+	}
+
+	/**
+	 * Sets the direction of the specified property.
+	 * @param property The property name.
+	 * @param direction The sort direction.
+	 */
+	set(property: string, direction: SortDirection): void {
+		for (const [index, [key]] of this.#properties.entries()) if (key == property) {
+			this.#properties[index] = [key, direction];
+			return;
+		}
+
+		this.add(property, direction);
+	}
+
+	/**
+	 * Sets the sorted property at the specified index.
+	 * @param index The position in this sort.
+	 * @param property The property name.
+	 * @param direction The sort direction.
+	 * @throws `Error` when a property with the same name already exists at a different index.
+	 */
+	setAt(index: number, property: string, direction: SortDirection): void {
+		const existingIndex = this.indexOf(property);
+		if (existingIndex >= 0 && existingIndex != index) throw new Error("A property with the same name already exists at a different index.");
+		this.#properties[index] = [property, direction];
+	}
+
+	/**
+	 * Returns a JSON representation of this object.
+	 * @returns The JSON representation of this object.
+	 */
+	toJSON(): string {
+		return this.toString();
+	}
+
+	/**
+	 * Returns a string representation of this object.
+	 * @returns The string representation of this object.
+	 */
+	toString(): string {
+		return this.#properties.map(([property, direction]) => `${direction == SortDirection.Descending ? "-" : ""}${property}`).join(",");
+	}
+}

package/package.json

@@ -7,7 +7,7 @@
 	"name": "@cedx/ui",
 	"repository": "CedX/UI",
 	"type": "module",
-	"version": "0.5.0",
+	"version": "0.7.0",
 	"allowScripts": {
 		"esbuild": true,
 		"playwright-chromium": true