@cedx/base 0.31.0 → 0.33.0

package/ReadMe.md

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

package/lib/Data/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/lib/Data/Scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scenario.d.ts","sourceRoot":"","sources":["../../src/Client/Data/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/lib/Data/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/lib/Date.d.ts.map

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

package/lib/DateRange.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Defines the type of a date range.
+ */
+export declare const DateRangeType: Readonly<{
+    /**
+     * A custom date range.
+     */
+    Custom: "Custom";
+    /**
+     * A whole day.
+     */
+    Day: "Day";
+    /**
+     * A whole week.
+     */
+    Week: "Week";
+    /**
+     * A whole month.
+     */
+    Month: "Month";
+    /**
+     * A whole quarter.
+     */
+    Quarter: "Quarter";
+    /**
+     * A whole year.
+     */
+    Year: "Year";
+}>;
+/**
+ * Defines the type of a date range.
+ */
+export type DateRangeType = typeof DateRangeType[keyof typeof DateRangeType];
+/**
+ * Defines a date range.
+ */
+export declare class DateRange {
+    /**
+     * The end date.
+     */
+    readonly end: Date;
+    /**
+     * The start date.
+     */
+    readonly start: Date;
+    /**
+     * The range type.
+     */
+    readonly type: DateRangeType;
+    /**
+     * Creates a new date range.
+     * @param start The start date.
+     * @param end The end date.
+     * @param type The range type.
+     */
+    constructor(start: Date, end: Date, type?: DateRangeType);
+    /**
+     * Creates a new date range from the specified JSON object.
+     * @param json A JSON object representing a date range.
+     * @returns The instance corresponding to the specified JSON object.
+     */
+    static fromJson(json: Record<string, any>): DateRange;
+    /**
+     * Creates a date range corresponding to the day including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the day including the specified date.
+     */
+    static day(date: Date): DateRange;
+    /**
+     * Creates a date range corresponding to the month including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the month including the specified date.
+     */
+    static month(date: Date): DateRange;
+    /**
+     * Creates a date range corresponding to the quarter including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the quarter including the specified date.
+     */
+    static quarter(date: Date): DateRange;
+    /**
+     * Creates a date range corresponding to the week including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the week including the specified date.
+     */
+    static week(date: Date): DateRange;
+    /**
+     * Creates a date range corresponding to the year including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the year including the specified date.
+     */
+    static year(date: Date): DateRange;
+    /**
+     * Returns a value indicating whether this date range is equal to the specified date range.
+     * @param other The other date range to compare.
+     * @returns `true` if this date range is equal to the specified date range, otherwise `false`.
+     */
+    equals(other: DateRange): boolean;
+    /**
+     * The label corresponding to this date range.
+     * @param culture The current culture.
+     * @returns The label corresponding to this date range.
+     */
+    getLabel(culture?: Intl.Locale | string): string;
+}
+//# sourceMappingURL=DateRange.d.ts.map

package/lib/DateRange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateRange.d.ts","sourceRoot":"","sources":["../src/Client/Base/DateRange.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,aAAa;IAEzB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;EAEF,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E;;GAEG;AACH,qBAAa,SAAS;IAErB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IAEnB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAE7B;;;;;OAKG;gBACS,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,GAAE,aAAoC;IAM9E;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS;IAQrD;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAIjC;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAQnC;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAUrC;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAOlC;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS;IAIlC;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO;IAIjC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,GAAE,IAAI,CAAC,MAAM,GAAC,MAA2B,GAAG,MAAM;CAWlE"}

package/lib/DateRange.js

@@ -0,0 +1,136 @@
+import { atMidnight, daysInMonth, getQuarter, getWeekOfYear } from "./Date.js";
+import { TimeSpan } from "./TimeSpan.js";
+/**
+ * Defines the type of a date range.
+ */
+export const DateRangeType = Object.freeze({
+    /**
+     * A custom date range.
+     */
+    Custom: "Custom",
+    /**
+     * A whole day.
+     */
+    Day: "Day",
+    /**
+     * A whole week.
+     */
+    Week: "Week",
+    /**
+     * A whole month.
+     */
+    Month: "Month",
+    /**
+     * A whole quarter.
+     */
+    Quarter: "Quarter",
+    /**
+     * A whole year.
+     */
+    Year: "Year"
+});
+/**
+ * Defines a date range.
+ */
+export class DateRange {
+    /**
+     * The end date.
+     */
+    end;
+    /**
+     * The start date.
+     */
+    start;
+    /**
+     * The range type.
+     */
+    type;
+    /**
+     * Creates a new date range.
+     * @param start The start date.
+     * @param end The end date.
+     * @param type The range type.
+     */
+    constructor(start, end, type = DateRangeType.Custom) {
+        this.start = start;
+        this.end = end;
+        this.type = type;
+    }
+    /**
+     * Creates a new date range from the specified JSON object.
+     * @param json A JSON object representing a date range.
+     * @returns The instance corresponding to the specified JSON object.
+     */
+    static fromJson(json) {
+        return new this(new Date(typeof json.start == "string" ? json.start : Date.now()), new Date(typeof json.end == "string" ? json.end : Date.now()), Object.values(DateRangeType).includes(json.type) ? json.type : DateRangeType.Custom);
+    }
+    /**
+     * Creates a date range corresponding to the day including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the day including the specified date.
+     */
+    static day(date) {
+        return new this(atMidnight(date), new Date(date.getFullYear(), date.getMonth(), date.getDate(), 23, 59, 59, 999), DateRangeType.Day);
+    }
+    /**
+     * Creates a date range corresponding to the month including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the month including the specified date.
+     */
+    static month(date) {
+        return new this(new Date(date.getFullYear(), date.getMonth(), 1), new Date(date.getFullYear(), date.getMonth(), daysInMonth(date), 23, 59, 59, 999), DateRangeType.Month);
+    }
+    /**
+     * Creates a date range corresponding to the quarter including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the quarter including the specified date.
+     */
+    static quarter(date) {
+        const firstMonth = (getQuarter(date) * 3) - 3;
+        const lastMonth = firstMonth + 2;
+        return new this(new Date(date.getFullYear(), firstMonth, 1), new Date(date.getFullYear(), lastMonth, daysInMonth(new Date(date.getFullYear(), lastMonth, 1)), 23, 59, 59, 999), DateRangeType.Quarter);
+    }
+    /**
+     * Creates a date range corresponding to the week including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the week including the specified date.
+     */
+    static week(date) {
+        const delta = -((date.getDay() + 6) % 7);
+        const sunday = new Date(date.getTime() + ((delta + 6) * TimeSpan.MillisecondsPerDay));
+        sunday.setHours(23, 59, 59, 999);
+        return new this(atMidnight(new Date(date.getTime() + (delta * TimeSpan.MillisecondsPerDay))), sunday, DateRangeType.Week);
+    }
+    /**
+     * Creates a date range corresponding to the year including the specified date.
+     * @param date The date.
+     * @returns The date range corresponding to the year including the specified date.
+     */
+    static year(date) {
+        return new this(new Date(date.getFullYear(), 0, 1), new Date(date.getFullYear(), 11, 31, 23, 59, 59, 999), DateRangeType.Year);
+    }
+    /**
+     * Returns a value indicating whether this date range is equal to the specified date range.
+     * @param other The other date range to compare.
+     * @returns `true` if this date range is equal to the specified date range, otherwise `false`.
+     */
+    equals(other) {
+        return this.start.getTime() == other.start.getTime() && this.end.getTime() == other.end.getTime();
+    }
+    /**
+     * The label corresponding to this date range.
+     * @param culture The current culture.
+     * @returns The label corresponding to this date range.
+     */
+    getLabel(culture = navigator.language) {
+        const { start, end, type } = this;
+        switch (type) {
+            case DateRangeType.Day: return start.toLocaleString(culture, { dateStyle: "medium" });
+            case DateRangeType.Week: return `S${getWeekOfYear(start)} ${start.getFullYear()}`;
+            case DateRangeType.Month: return start.toLocaleString(culture, { month: "long", year: "numeric" });
+            case DateRangeType.Quarter: return `T${getQuarter(start)} ${start.getFullYear()}`;
+            case DateRangeType.Year: return start.getFullYear().toString();
+            default: return end.toLocaleString(culture, { dateStyle: "medium" });
+        }
+    }
+}

package/lib/File.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../src/Client/File.ts"],"names":[],"mappings":"AAAA;;;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"}
+{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../src/Client/Base/File.ts"],"names":[],"mappings":"AAAA;;;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/Number.d.ts.map

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

package/lib/String.d.ts

@@ -1,10 +1,10 @@
 /**
- * Converts the first character to uppercase.
+ * Converts the first character of the specified string to uppercase.
  * @param value The string to process.
- * @param locale The current locale.
+ * @param culture The current culture.
  * @returns The processed string.
  */
-export declare function capitalize(value: string, locale?: Intl.Locale | string): string;
+export declare function capitalize(value: string, culture?: Intl.Locale | string): string;
 /**
  * Replaces all new lines in the specified value by HTML line breaks.
  * @param value The string to format.

package/lib/String.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../src/Client/String.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,IAAI,CAAC,MAAM,GAAC,MAA2B,GAAG,MAAM,CAEjG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAM,GAAG,MAAM,CAElF;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;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAEhF"}
+{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../src/Client/Base/String.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,MAAM,GAAC,MAA2B,GAAG,MAAM,CAElG;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAM,GAAG,MAAM,CAElF;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;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,SAAQ,GAAG,MAAM,CAEhF"}

package/lib/String.js

@@ -1,11 +1,11 @@
 /**
- * Converts the first character to uppercase.
+ * Converts the first character of the specified string to uppercase.
  * @param value The string to process.
- * @param locale The current locale.
+ * @param culture The current culture.
  * @returns The processed string.
  */
-export function capitalize(value, locale = navigator.language) {
-    return value.charAt(0).toLocaleUpperCase(locale) + value.slice(1);
+export function capitalize(value, culture = navigator.language) {
+    return value.length == 0 ? "" : value.charAt(0).toLocaleUpperCase(culture) + value.slice(1);
 }
 /**
  * Replaces all new lines in the specified value by HTML line breaks.

package/lib/TimeSpan.d.ts.map

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

package/package.json

@@ -7,23 +7,23 @@
 	"name": "@cedx/base",
 	"repository": "cedx/base",
 	"type": "module",
-	"version": "0.31.0",
+	"version": "0.33.0",
 	"devDependencies": {
-		"@playwright/browser-chromium": "^1.55.0",
+		"@playwright/browser-firefox": "^1.56.1",
 		"@types/bootstrap": "^5.2.10",
-		"@types/chai": "^5.2.2",
+		"@types/chai": "^5.2.3",
 		"@types/mocha": "^10.0.10",
-		"@types/node": "^24.5.2",
+		"@types/node": "^24.10.1",
 		"@types/serve-handler": "^6.1.4",
-		"chai": "^6.0.1",
-		"esbuild": "^0.25.10",
-		"globals": "^16.4.0",
-		"mocha": "^11.7.2",
-		"playwright": "^1.55.0",
+		"chai": "^6.2.1",
+		"esbuild": "^0.27.0",
+		"globals": "^16.5.0",
+		"mocha": "^11.7.5",
+		"playwright": "^1.56.1",
 		"serve-handler": "^6.1.6",
-		"typedoc": "^0.28.13",
-		"typescript": "^5.9.2",
-		"typescript-eslint": "^8.44.0"
+		"typedoc": "^0.28.14",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.46.4"
 	},
 	"engines": {
 		"node": ">=24.0.0"

package/src/Client/Base/DateRange.ts

@@ -0,0 +1,173 @@
+import {atMidnight, daysInMonth, getQuarter, getWeekOfYear} from "./Date.js";
+import {TimeSpan} from "./TimeSpan.js";
+
+/**
+ * Defines the type of a date range.
+ */
+export const DateRangeType = Object.freeze({
+
+	/**
+	 * A custom date range.
+	 */
+	Custom: "Custom",
+
+	/**
+	 * A whole day.
+	 */
+	Day: "Day",
+
+	/**
+	 * A whole week.
+	 */
+	Week: "Week",
+
+	/**
+	 * A whole month.
+	 */
+	Month: "Month",
+
+	/**
+	 * A whole quarter.
+	 */
+	Quarter: "Quarter",
+
+	/**
+	 * A whole year.
+	 */
+	Year: "Year"
+});
+
+/**
+ * Defines the type of a date range.
+ */
+export type DateRangeType = typeof DateRangeType[keyof typeof DateRangeType];
+
+/**
+ * Defines a date range.
+ */
+export class DateRange {
+
+	/**
+	 * The end date.
+	 */
+	readonly end: Date;
+
+	/**
+	 * The start date.
+	 */
+	readonly start: Date;
+
+	/**
+	 * The range type.
+	 */
+	readonly type: DateRangeType;
+
+	/**
+	 * Creates a new date range.
+	 * @param start The start date.
+	 * @param end The end date.
+	 * @param type The range type.
+	 */
+	constructor(start: Date, end: Date, type: DateRangeType = DateRangeType.Custom) {
+		this.start = start;
+		this.end = end;
+		this.type = type;
+	}
+
+	/**
+	 * Creates a new date range from the specified JSON object.
+	 * @param json A JSON object representing a date range.
+	 * @returns The instance corresponding to the specified JSON object.
+	 */
+	static fromJson(json: Record<string, any>): DateRange {
+		return new this(
+			new Date(typeof json.start == "string" ? json.start : Date.now()),
+			new Date(typeof json.end == "string" ? json.end : Date.now()),
+			Object.values(DateRangeType).includes(json.type as DateRangeType) ? json.type as DateRangeType : DateRangeType.Custom
+		);
+	}
+
+	/**
+	 * Creates a date range corresponding to the day including the specified date.
+	 * @param date The date.
+	 * @returns The date range corresponding to the day including the specified date.
+	 */
+	static day(date: Date): DateRange {
+		return new this(atMidnight(date), new Date(date.getFullYear(), date.getMonth(), date.getDate(), 23, 59, 59, 999), DateRangeType.Day);
+	}
+
+	/**
+	 * Creates a date range corresponding to the month including the specified date.
+	 * @param date The date.
+	 * @returns The date range corresponding to the month including the specified date.
+	 */
+	static month(date: Date): DateRange {
+		return new this(
+			new Date(date.getFullYear(), date.getMonth(), 1),
+			new Date(date.getFullYear(), date.getMonth(), daysInMonth(date), 23, 59, 59, 999),
+			DateRangeType.Month
+		);
+	}
+
+	/**
+	 * Creates a date range corresponding to the quarter including the specified date.
+	 * @param date The date.
+	 * @returns The date range corresponding to the quarter including the specified date.
+	 */
+	static quarter(date: Date): DateRange {
+		const firstMonth = (getQuarter(date) * 3) - 3;
+		const lastMonth = firstMonth + 2;
+		return new this(
+			new Date(date.getFullYear(), firstMonth, 1),
+			new Date(date.getFullYear(), lastMonth, daysInMonth(new Date(date.getFullYear(), lastMonth, 1)), 23, 59, 59, 999),
+			DateRangeType.Quarter
+		);
+	}
+
+	/**
+	 * Creates a date range corresponding to the week including the specified date.
+	 * @param date The date.
+	 * @returns The date range corresponding to the week including the specified date.
+	 */
+	static week(date: Date): DateRange {
+		const delta = -((date.getDay() + 6) % 7);
+		const sunday = new Date(date.getTime() + ((delta + 6) * TimeSpan.MillisecondsPerDay));
+		sunday.setHours(23, 59, 59, 999);
+		return new this(atMidnight(new Date(date.getTime() + (delta * TimeSpan.MillisecondsPerDay))), sunday, DateRangeType.Week);
+	}
+
+	/**
+	 * Creates a date range corresponding to the year including the specified date.
+	 * @param date The date.
+	 * @returns The date range corresponding to the year including the specified date.
+	 */
+	static year(date: Date): DateRange {
+		return new this(new Date(date.getFullYear(), 0, 1), new Date(date.getFullYear(), 11, 31, 23, 59, 59, 999), DateRangeType.Year);
+	}
+
+	/**
+	 * Returns a value indicating whether this date range is equal to the specified date range.
+	 * @param other The other date range to compare.
+	 * @returns `true` if this date range is equal to the specified date range, otherwise `false`.
+	 */
+	equals(other: DateRange): boolean {
+		return this.start.getTime() == other.start.getTime() && this.end.getTime() == other.end.getTime();
+	}
+
+	/**
+	 * The label corresponding to this date range.
+	 * @param culture The current culture.
+	 * @returns The label corresponding to this date range.
+	 */
+	getLabel(culture: Intl.Locale|string = navigator.language): string {
+		const {start, end, type} = this;
+		switch (type) {
+			case DateRangeType.Day: return start.toLocaleString(culture, {dateStyle: "medium"});
+			case DateRangeType.Week: return `S${getWeekOfYear(start)} ${start.getFullYear()}`;
+			case DateRangeType.Month: return start.toLocaleString(culture, {month: "long", year: "numeric"});
+			case DateRangeType.Quarter: return `T${getQuarter(start)} ${start.getFullYear()}`;
+			case DateRangeType.Year: return start.getFullYear().toString();
+			default: return end.toLocaleString(culture, {dateStyle: "medium"});
+		}
+	}
+}

package/src/Client/{String.ts → Base/String.ts}

@@ -1,11 +1,11 @@
 /**
- * Converts the first character to uppercase.
+ * Converts the first character of the specified string to uppercase.
  * @param value The string to process.
- * @param locale The current locale.
+ * @param culture The current culture.
  * @returns The processed string.
  */
-export function capitalize(value: string, locale: Intl.Locale|string = navigator.language): string {
-	return value.charAt(0).toLocaleUpperCase(locale) + value.slice(1);
+export function capitalize(value: string, culture: Intl.Locale|string = navigator.language): string {
+	return value.length == 0 ? "" : value.charAt(0).toLocaleUpperCase(culture) + value.slice(1);
 }
 
 /**

package/src/Client/Base/tsconfig.json

@@ -1,13 +1,13 @@
 {
 	"extends": "../../../tsconfig.json",
-	"include": ["../*.ts"],
+	"include": ["**/*.ts"],
 	"compilerOptions": {
 		"composite": true,
 		"declaration": true,
 		"declarationMap": true,
 		"noEmit": false,
 		"outDir": "../../../lib",
-		"rootDir": "..",
+		"rootDir": ".",
 		"tsBuildInfoFile": "../../../var/Base.tsbuildinfo"
 	}
 }

package/src/Client/Data/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];