@cedx/base 0.6.0 → 0.8.0

package/ReadMe.md

@@ -1,5 +1,5 @@
 # Belin.io Base
-![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![Version](https://badgen.net/badge/project/v0.6.0/blue) ![Licence](https://badgen.net/badge/licence/MIT/blue)
+![.NET](https://badgen.net/badge/.net/%3E%3D9.0/green) ![Version](https://badgen.net/badge/project/v0.8.0/blue) ![Licence](https://badgen.net/badge/licence/MIT/blue)
 
 Base library by [Cédric Belin](https://belin.io), full stack developer,
 implemented in [C#](https://learn.microsoft.com/en-us/dotnet/csharp) and [TypeScript](https://www.typescriptlang.org).

package/lib/Data/Pagination.d.ts

@@ -2,23 +2,17 @@
  * Represents information relevant to the pagination of data items.
  */
 export declare class Pagination {
-    /**
-     * The one-based current page number.
-     */
-    currentPageIndex: number;
-    /**
-     * The number of items per page.
-     */
-    itemsPerPage: number;
-    /**
-     * The total number of items.
-     */
-    totalItemCount: number;
+    #private;
     /**
      * Creates a new pagination.
      * @param options An object providing values to initialize this instance.
      */
     constructor(options?: PaginationOptions);
+    /**
+     * The one-based current page number.
+     */
+    get currentPageIndex(): number;
+    set currentPageIndex(value: number);
     /**
      * Value indicating whether a next page exists.
      */
@@ -27,6 +21,11 @@ export declare class Pagination {
      * Value indicating whether a previous page exists.
      */
     get hasPreviousPage(): boolean;
+    /**
+     * The number of items per page.
+     */
+    get itemsPerPage(): number;
+    set itemsPerPage(value: number);
     /**
      * The one-based last page number.
      */
@@ -43,6 +42,11 @@ export declare class Pagination {
      * The search parameters corresponding to this object.
      */
     get searchParams(): URLSearchParams;
+    /**
+     * The total number of items.
+     */
+    get totalItemCount(): number;
+    set totalItemCount(value: number);
     /**
      * Creates a new pagination from the HTTP headers of the specified response.
      * @param response A server response.
@@ -53,5 +57,18 @@ export declare class Pagination {
 /**
  * Defines the options of a {@link Pagination} instance.
  */
-export type PaginationOptions = Partial<Pick<Pagination, "currentPageIndex" | "itemsPerPage" | "totalItemCount">>;
+export type PaginationOptions = Partial<{
+    /**
+     * The one-based current page number.
+     */
+    currentPageIndex: number;
+    /**
+     * The number of items per page.
+     */
+    itemsPerPage: number;
+    /**
+     * The total number of items.
+     */
+    totalItemCount: number;
+}>;
 //# sourceMappingURL=Pagination.d.ts.map

package/lib/Data/Pagination.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../src/Client/Data/Pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAU;IAEtB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;gBACS,OAAO,GAAE,iBAAsB;IAM3C;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,eAAe,CAElC;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU;CAOnD;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,GAAC,cAAc,GAAC,gBAAgB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"Pagination.d.ts","sourceRoot":"","sources":["../../src/Client/Data/Pagination.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAU;;IAiBtB;;;OAGG;gBACS,OAAO,GAAE,iBAAsB;IAM3C;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IACD,IAAI,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAEjC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IACD,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,eAAe,CAElC;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IACD,IAAI,cAAc,CAAC,KAAK,EAAE,MAAM,EAE/B;IAED;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU;CAOnD;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC;IAEvC;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CACvB,CAAC,CAAC"}

package/lib/Data/Pagination.js

@@ -5,59 +5,86 @@ export class Pagination {
     /**
      * The one-based current page number.
      */
-    currentPageIndex;
+    #currentPageIndex;
     /**
      * The number of items per page.
      */
-    itemsPerPage;
+    #itemsPerPage;
     /**
      * The total number of items.
      */
-    totalItemCount;
+    #totalItemCount;
     /**
      * Creates a new pagination.
      * @param options An object providing values to initialize this instance.
      */
     constructor(options = {}) {
-        this.currentPageIndex = Math.max(1, options.currentPageIndex ?? 1);
-        this.itemsPerPage = Math.max(1, Math.min(1000, options.itemsPerPage ?? 25));
-        this.totalItemCount = Math.max(0, options.totalItemCount ?? 0);
+        this.currentPageIndex = options.currentPageIndex ?? 1;
+        this.itemsPerPage = options.itemsPerPage ?? 25;
+        this.totalItemCount = options.totalItemCount ?? 0;
+    }
+    /**
+     * The one-based current page number.
+     */
+    get currentPageIndex() {
+        return this.#currentPageIndex;
+    }
+    set currentPageIndex(value) {
+        this.#currentPageIndex = Math.max(1, value);
     }
     /**
      * Value indicating whether a next page exists.
      */
     get hasNextPage() {
-        return this.currentPageIndex < this.totalItemCount;
+        return this.#currentPageIndex < this.lastPageIndex;
     }
     /**
      * Value indicating whether a previous page exists.
      */
     get hasPreviousPage() {
-        return this.currentPageIndex > 1;
+        return this.#currentPageIndex > 1;
+    }
+    /**
+     * The number of items per page.
+     */
+    get itemsPerPage() {
+        return this.#itemsPerPage;
+    }
+    set itemsPerPage(value) {
+        this.#itemsPerPage = Math.max(1, Math.min(1000, value));
     }
     /**
      * The one-based last page number.
      */
     get lastPageIndex() {
-        return Math.ceil(this.totalItemCount / this.itemsPerPage);
+        return this.#totalItemCount > 0 ? Math.ceil(this.#totalItemCount / this.#itemsPerPage) : 1;
     }
     /**
      * The data limit.
      */
     get limit() {
-        return this.itemsPerPage;
+        return this.#itemsPerPage;
     }
     /**
      * The data offset.
      */
     get offset() {
-        return (this.currentPageIndex - 1) * this.itemsPerPage;
+        return (this.#currentPageIndex - 1) * this.#itemsPerPage;
     }
     /**
      * The search parameters corresponding to this object.
      */
     get searchParams() {
-        return new URLSearchParams({ page: this.currentPageIndex.toString(), perPage: this.itemsPerPage.toString() });
+        return new URLSearchParams({ page: this.#currentPageIndex.toString(), perPage: this.#itemsPerPage.toString() });
+    }
+    /**
+     * The total number of items.
+     */
+    get totalItemCount() {
+        return this.#totalItemCount;
+    }
+    set totalItemCount(value) {
+        this.#totalItemCount = Math.max(0, value);
     }
     /**
      * Creates a new pagination from the HTTP headers of the specified response.

package/lib/Data/Sort.d.ts

@@ -1,18 +1,18 @@
 /**
- * Specifies the order of a sorted property.
+ * Specifies the order of a sort property.
  */
 export declare const SortOrder: Readonly<{
     /**
      * The sort is ascending.
      */
-    Ascending: "ASC";
+    Ascending: "Ascending";
     /**
      * The sort is descending.
      */
-    Descending: "DESC";
+    Descending: "Descending";
 }>;
 /**
- * Specifies the order of a sorted property.
+ * Specifies the order of a sort property.
  */
 export type SortOrder = typeof SortOrder[keyof typeof SortOrder];
 /**
@@ -30,7 +30,11 @@ export declare class Sort implements Iterable<SortProperty> {
      */
     constructor(properties?: SortProperty[]);
     /**
-     * The number of properties.
+     * The list of sort properties.
+     */
+    get keys(): string[];
+    /**
+     * The number of properties in this sort.
      */
     get length(): number;
     /**
@@ -48,22 +52,26 @@ export declare class Sort implements Iterable<SortProperty> {
     static parse(value: string): Sort;
     /**
      * Returns a new iterator that allows iterating the entries of this sort.
-     * @returns An iterator over the sorted properties.
+     * @returns An iterator over the sort properties.
      */
-    [Symbol.iterator](): Generator<SortProperty, void, void>;
+    [Symbol.iterator](): Iterator<SortProperty>;
     /**
      * Appends the specified property to this sort.
      * @param property The property name.
      * @param order The sort order.
-     * @returns This instance.
+     * @throws `Error` when an item with the property name already exists.
      */
-    append(property: string, order: SortOrder): this;
+    add(property: string, order: SortOrder): void;
     /**
-     * Gets the sorted property at the specified index.
+     * Gets the sort 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.
+     * @returns The sort property at the specified index, or `null` if it doesn't exist.
      */
     at(index: number): SortProperty | null;
+    /**
+     * 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.
@@ -71,6 +79,12 @@ export declare class Sort implements Iterable<SortProperty> {
      * @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;
     /**
      * Removes the specified property from this sort.
      * @param property The property name.
@@ -88,12 +102,6 @@ export declare class Sort implements Iterable<SortProperty> {
      * @returns The icon corresponding to the specified property.
      */
     getIcon(property: string): string;
-    /**
-     * 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`.
-     */
-    has(property: string): boolean;
     /**
      * Gets the index of the specified property in the underlying list.
      * @param property The property name.
@@ -129,12 +137,6 @@ export declare class Sort implements Iterable<SortProperty> {
      * @returns The JSON representation of this object.
      */
     toJSON(): string;
-    /**
-     * Converts this sort to an SQL clause.
-     * @param escape A function used to escape the SQL identifiers.
-     * @returns The SQL clause corresponding to this object.
-     */
-    toSql(escape?: (identifier: string) => string): string;
     /**
      * Returns a string representation of this object.
      * @returns The string representation of this object.

package/lib/Data/Sort.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sort.d.ts","sourceRoot":"","sources":["../../src/Client/Data/Sort.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;IAErB;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE/C;;GAEG;AACH,qBAAa,IAAK,YAAW,QAAQ,CAAC,YAAY,CAAC;;IAOlD;;;OAGG;gBACS,UAAU,GAAE,YAAY,EAAO;IAI3C;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,SAA+B,GAAG,IAAI;IAIzE;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC;;;OAGG;IACF,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC;IAIzD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAMhD;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAC,IAAI;IAIpC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAWrC;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAC,IAAI;IAKrC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQjC;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKjC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAMjD;;;;OAIG;IACH,SAAS,CAAC,UAAU,GAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAC,CAAM,GAAG,OAAO;IAW9F;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAS7C;;;OAGG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;OAIG;IACH,KAAK,CAAC,MAAM,GAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAiB,GAAG,MAAM;IAIhE;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAGlB"}
+{"version":3,"file":"Sort.d.ts","sourceRoot":"","sources":["../../src/Client/Data/Sort.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,SAAS;IAErB;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE/C;;GAEG;AACH,qBAAa,IAAK,YAAW,QAAQ,CAAC,YAAY,CAAC;;IAOlD;;;OAGG;gBACS,UAAU,GAAE,YAAY,EAAO;IAI3C;;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,KAAK,GAAE,SAA+B,GAAG,IAAI;IAIzE;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOjC;;;OAGG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,YAAY,CAAC;IAI3C;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAK7C;;;;OAIG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAC,IAAI;IAIpC;;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;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;OAIG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAC,IAAI;IAKrC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQjC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKjC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAMjD;;;;OAIG;IACH,SAAS,CAAC,UAAU,GAAE,OAAO,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAC,CAAM,GAAG,OAAO;IAW9F;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAU7C;;;OAGG;IACH,MAAM,IAAI,MAAM;IAIhB;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAGlB"}

package/lib/Data/Sort.js

@@ -1,22 +1,22 @@
 /**
- * Specifies the order of a sorted property.
+ * Specifies the order of a sort property.
  */
 export const SortOrder = Object.freeze({
     /**
      * The sort is ascending.
      */
-    Ascending: "ASC",
+    Ascending: "Ascending",
     /**
      * The sort is descending.
      */
-    Descending: "DESC"
+    Descending: "Descending"
 });
 /**
  * Represents information relevant to the sorting of data items.
  */
 export class Sort {
     /**
-     * The list of sorted properties.
+     * The list of sort properties.
      */
     #properties;
     /**
@@ -27,7 +27,13 @@ export class Sort {
         this.#properties = properties;
     }
     /**
-     * The number of 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;
@@ -54,31 +60,36 @@ export class Sort {
     }
     /**
      * Returns a new iterator that allows iterating the entries of this sort.
-     * @returns An iterator over the sorted properties.
+     * @returns An iterator over the sort properties.
      */
-    *[Symbol.iterator]() {
-        for (const entry of this.#properties)
-            yield entry;
+    [Symbol.iterator]() {
+        return this.#properties[Symbol.iterator]();
     }
     /**
      * Appends the specified property to this sort.
      * @param property The property name.
      * @param order The sort order.
-     * @returns This instance.
+     * @throws `Error` when an item with the property name already exists.
      */
-    append(property, order) {
-        this.delete(property);
+    add(property, order) {
+        if (this.containsKey(property))
+            throw new Error("An item with the property name has already been added.");
         this.#properties.push([property, order]);
-        return this;
     }
     /**
-     * Gets the sorted property at the specified index.
+     * Gets the sort 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.
+     * @returns The sort property at the specified index, or `null` if it doesn't exist.
      */
     at(index) {
         return this.#properties.at(index) ?? null;
     }
+    /**
+     * 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.
@@ -95,6 +106,14 @@ export class Sort {
         }
         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);
+    }
     /**
      * Removes the specified property from this sort.
      * @param property The property name.
@@ -125,14 +144,6 @@ export class Sort {
             default: return "swap_vert";
         }
     }
-    /**
-     * 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`.
-     */
-    has(property) {
-        return this.#properties.some(([key]) => key == property);
-    }
     /**
      * Gets the index of the specified property in the underlying list.
      * @param property The property name.
@@ -182,7 +193,8 @@ export class Sort {
                 this.#properties[index] = [key, order];
                 return this;
             }
-        return this.append(property, order);
+        this.add(property, order);
+        return this;
     }
     /**
      * Returns a JSON representation of this object.
@@ -191,19 +203,11 @@ export class Sort {
     toJSON() {
         return this.toString();
     }
-    /**
-     * Converts this sort to an SQL clause.
-     * @param escape A function used to escape the SQL identifiers.
-     * @returns The SQL clause corresponding to this object.
-     */
-    toSql(escape = id => id) {
-        return this.#properties.map(([property, order]) => `${escape(property)} ${order}`).join(", ");
-    }
     /**
      * Returns a string representation of this object.
      * @returns The string representation of this object.
      */
     toString() {
-        return this.#properties.map(([property, order]) => `${order == SortOrder.Descending ? "-" : ""}${property}`).join();
+        return this.#properties.map(([property, order]) => `${order == SortOrder.Descending ? "-" : ""}${property}`).join(",");
     }
 }

package/lib/{Date.d.ts → DateExtensions.d.ts}

@@ -69,4 +69,4 @@ export declare function toYmdHms(date: Date, options?: {
     excludeTime?: boolean;
     separator?: string;
 }): string;
-//# sourceMappingURL=Date.d.ts.map
+//# sourceMappingURL=DateExtensions.d.ts.map

package/lib/DateExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateExtensions.d.ts","sourceRoot":"","sources":["../src/Client/DateExtensions.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/{Html/File.d.ts → FileExtensions.d.ts}

@@ -2,31 +2,24 @@
  * 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;
+export declare function download(file: File): 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?: {
+export declare function open(file: File, options?: {
     newTab?: boolean;
 }): void;
 /**
  * Prints the specified file.
  * @param file The file to be printed.
  */
-export declare function printFile(file: File): void;
+export declare function print(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
+//# sourceMappingURL=FileExtensions.d.ts.map

package/lib/FileExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileExtensions.d.ts","sourceRoot":"","sources":["../src/Client/FileExtensions.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAUzC;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAM,GAAG,IAAI,CAkBvE;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAatC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAOlD"}

package/lib/{Html/File.js → FileExtensions.js}

@@ -1,9 +1,9 @@
-import { Duration } from "#Base/Duration.js";
+import { Duration } from "./Duration.js";
 /**
  * Downloads the specified file.
  * @param file The file to be downloaded.
  */
-export function downloadFile(file) {
+export function download(file) {
     const url = URL.createObjectURL(file);
     const anchor = document.createElement("a");
     anchor.download = file.name;
@@ -13,21 +13,12 @@ export function downloadFile(file) {
     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 = {}) {
+export function open(file, options = {}) {
     const url = URL.createObjectURL(file);
     if (!options.newTab) {
         location.assign(url);
@@ -49,7 +40,7 @@ export function openFile(file, options = {}) {
  * Prints the specified file.
  * @param file The file to be printed.
  */
-export function printFile(file) {
+export function print(file) {
     const url = URL.createObjectURL(file);
     const frame = document.createElement("iframe");
     frame.addEventListener("load", () => frame.contentWindow?.print());

package/lib/Hosting/Environment.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Commonly used environment names.
+ */
+export declare const Environment: Readonly<{
+    /**
+     * Specifies the development environment.
+     */
+    Development: "Development";
+    /**
+     * Specifies the production environment.
+     */
+    Production: "Production";
+    /**
+     * Specifies the staging environment.
+     */
+    Staging: "Staging";
+}>;
+/**
+ * Commonly used environment names.
+ */
+export type Environment = typeof Environment[keyof typeof Environment];
+//# sourceMappingURL=Environment.d.ts.map

package/lib/Hosting/Environment.d.ts.map

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

package/lib/Hosting/Environment.js

@@ -0,0 +1,17 @@
+/**
+ * Commonly used environment names.
+ */
+export const Environment = Object.freeze({
+    /**
+     * Specifies the development environment.
+     */
+    Development: "Development",
+    /**
+     * Specifies the production environment.
+     */
+    Production: "Production",
+    /**
+     * Specifies the staging environment.
+     */
+    Staging: "Staging"
+});

package/lib/Hosting/HostEnvironment.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Provides information about the hosting environment an application is running in.
+ */
+export declare class HostEnvironment {
+    /**
+     * The name of the application.
+     */
+    readonly applicationName: string;
+    /**
+     * The path to the directory that contains the application content files.
+     */
+    readonly contentRootPath: string;
+    /**
+     * The name of the environment.
+     */
+    readonly environmentName: string;
+    /**
+     * Creates a new host environment.
+     * @param options An object providing values to initialize this instance.
+     */
+    constructor(options?: HostEnvironmentOptions);
+    /**
+     * Checks if the current environment name is {@link Environment.Development}.
+     * @returns `true` if the environment name is {@link Environment.Development}, otherwise `false`.
+     */
+    get isDevelopment(): boolean;
+    /**
+     * Checks if the current environment name is {@link Environment.Production}.
+     * @returns `true` if the environment name is {@link Environment.Production}, otherwise `false`.
+     */
+    get isProduction(): boolean;
+    /**
+     * Checks if the current environment name is {@link Environment.Staging}.
+     * @returns `true` if the environment name is {@link Environment.Staging}, otherwise `false`.
+     */
+    get isStaging(): boolean;
+    /**
+     * Compares the current host environment name against the specified value.
+     * @param environmentName The environment name to validate against.
+     * @returns `true` if the specified name is the same as the current environment, otherwise `false`.
+     */
+    isEnvironment(environmentName: string): boolean;
+}
+/**
+ * Defines the options of a {@link HostEnvironment} instance.
+ */
+export type HostEnvironmentOptions = Partial<{
+    /**
+     * The name of the application.
+     */
+    applicationName: string;
+    /**
+     * The path to the directory that contains the application content files.
+     */
+    contentRootPath: string;
+    /**
+     * The name of the environment.
+     */
+    environmentName: string;
+}>;
+//# sourceMappingURL=HostEnvironment.d.ts.map

package/lib/Hosting/HostEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HostEnvironment.d.ts","sourceRoot":"","sources":["../../src/Client/Hosting/HostEnvironment.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,eAAe;IAE3B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAEjC;;;OAGG;gBACS,OAAO,GAAE,sBAA2B;IAMhD;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;OAGG;IACH,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED;;;OAGG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;OAIG;IACH,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO;CAG/C;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC;IAE5C;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC"}