katanakit-js 6.4.3 → 6.7.1

package/dist/core/services/dates.service.d.ts

@@ -1,5 +1,186 @@
 import { Temporal } from "@js-temporal/polyfill";
 import type { Locale, TemporalInput } from "../../types/index.js";
+/**
+ * DatesService - Singleton para operaciones de fechas.
+ *
+ * Aplica el patrón Singleton: una única instancia reutilizable que centraliza
+ * toda la lógica de fechas (diferencias, formateo, aritmética y comparaciones).
+ * Puro, sin I/O, seguro para SSR.
+ */
+export declare class DatesService {
+    private static instance;
+    /**
+     * Constructor privado - enforce singleton.
+     */
+    private constructor();
+    /**
+     * Obtiene la instancia única del DatesService (Singleton).
+     *
+     * @returns La instancia única de {@link DatesService}.
+     *
+     * @example
+     * ```ts
+     * const dates = DatesService.getInstance();
+     * dates.useNow();
+     * ```
+     */
+    static getInstance(): DatesService;
+    /**
+     * Internal helper that adapts flexible inputs into a `PlainDate`.
+     *
+     * @param date - An ISO date string or a `Temporal.PlainDate`.
+     * @returns A `Temporal.PlainDate`.
+     */
+    private toPlainDate;
+    /**
+     * Returns a human-readable diff between two dates as years, months, and days.
+     *
+     * @param start - Start date (ISO string or `PlainDate`).
+     * @param end - End date (ISO string or `PlainDate`).
+     * @returns A formatted string, e.g. `"2 years, 3 months and 15 days"`.
+     *
+     * @example
+     * ```ts
+     * useDiff("2020-01-01", "2022-04-16");
+     * // "2 years, 3 months and 15 days"
+     * ```
+     */
+    useDiff(start: string | Temporal.PlainDate, end: string | Temporal.PlainDate): string;
+    /**
+     * Formats a date input into a localised string using `Intl.DateTimeFormat`.
+     *
+     * Accepts epoch milliseconds, ISO strings, native `Date` objects,
+     * `Temporal.Instant`, or any `Temporal` date/time type.
+     *
+     * @param dateInput - The value to format.
+     * @param locale - BCP 47 locale tag (defaults to `"en"`).
+     * @param options - `Intl.DateTimeFormatOptions` (defaults to `{}`).
+     * @returns The formatted date string.
+     * @throws {Error} If the input cannot be parsed as a date.
+     *
+     * @example
+     * ```ts
+     * useFormat("2024-06-15");                        // "6/15/2024" (en-US)
+     * useFormat(Date.now(), "es", { dateStyle: "full" }); // "sábado, 15 de junio de 2024"
+     * ```
+     */
+    useFormat(dateInput: TemporalInput, locale?: Locale, options?: Intl.DateTimeFormatOptions): string;
+    /**
+     * Returns today's date as an ISO date string.
+     *
+     * @returns The current date in `YYYY-MM-DD` format.
+     *
+     * @example
+     * ```ts
+     * useNow(); // "2024-06-15"
+     * ```
+     */
+    useNow(): string;
+    /**
+     * Returns the current date and time as an ISO string (no timezone offset).
+     *
+     * @returns The current date-time in `YYYY-MM-DDTHH:MM:SS` format.
+     *
+     * @example
+     * ```ts
+     * useNowDateTime(); // "2024-06-15T14:30:00"
+     * ```
+     */
+    useNowDateTime(): string;
+    /**
+     * Adds a number of days to a date.
+     *
+     * @param date - Base date (ISO string or `PlainDate`).
+     * @param days - Number of days to add (can be negative).
+     * @returns The resulting date as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useAddDays("2024-01-01", 10); // "2024-01-11"
+     * ```
+     */
+    useAddDays(date: string | Temporal.PlainDate, days: number): string;
+    /**
+     * Subtracts a number of days from a date.
+     *
+     * @param date - Base date (ISO string or `PlainDate`).
+     * @param days - Number of days to subtract.
+     * @returns The resulting date as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useSubtractDays("2024-01-11", 10); // "2024-01-01"
+     * ```
+     */
+    useSubtractDays(date: string | Temporal.PlainDate, days: number): string;
+    /**
+     * Checks whether two dates are equal.
+     *
+     * @param date1 - First date (ISO string or `PlainDate`).
+     * @param date2 - Second date (ISO string or `PlainDate`).
+     * @returns `true` if the dates represent the same day.
+     *
+     * @example
+     * ```ts
+     * useIsEqual("2024-06-15", "2024-06-15"); // true
+     * useIsEqual("2024-06-15", "2024-06-16"); // false
+     * ```
+     */
+    useIsEqual(date1: string | Temporal.PlainDate, date2: string | Temporal.PlainDate): boolean;
+    /**
+     * Checks whether `date1` is before `date2`.
+     *
+     * @param date1 - First date (ISO string or `PlainDate`).
+     * @param date2 - Second date (ISO string or `PlainDate`).
+     * @returns `true` if `date1` is strictly before `date2`.
+     *
+     * @example
+     * ```ts
+     * useIsBefore("2024-01-01", "2024-06-15"); // true
+     * useIsBefore("2024-06-15", "2024-06-15"); // false
+     * ```
+     */
+    useIsBefore(date1: string | Temporal.PlainDate, date2: string | Temporal.PlainDate): boolean;
+    /**
+     * Checks whether `date1` is after `date2`.
+     *
+     * @param date1 - First date (ISO string or `PlainDate`).
+     * @param date2 - Second date (ISO string or `PlainDate`).
+     * @returns `true` if `date1` is strictly after `date2`.
+     *
+     * @example
+     * ```ts
+     * useIsAfter("2024-06-15", "2024-01-01"); // true
+     * useIsAfter("2024-06-15", "2024-06-15"); // false
+     * ```
+     */
+    useIsAfter(date1: string | Temporal.PlainDate, date2: string | Temporal.PlainDate): boolean;
+    /**
+     * Returns the first day of the month for a given date.
+     *
+     * @param date - Base date (defaults to today).
+     * @returns The first day of the month as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useFirstDayOfMonth("2024-06-15"); // "2024-06-01"
+     * ```
+     */
+    useFirstDayOfMonth(date?: string | Temporal.PlainDate): string;
+    /**
+     * Returns the last day of the month for a given date.
+     *
+     * @param date - Base date (defaults to today).
+     * @returns The last day of the month as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useLastDayOfMonth("2024-02-10"); // "2024-02-29" (leap year)
+     * useLastDayOfMonth("2024-06-15"); // "2024-06-30"
+     * ```
+     */
+    useLastDayOfMonth(date?: string | Temporal.PlainDate): string;
+}
 /**
  * Returns a human-readable diff between two dates as years, months, and days.
  *
@@ -17,19 +198,14 @@ export declare function useDiff(start: string | Temporal.PlainDate, end: string
 /**
  * Formats a date input into a localised string using `Intl.DateTimeFormat`.
  *
- * Accepts epoch milliseconds, ISO strings, native `Date` objects,
- * `Temporal.Instant`, or any `Temporal` date/time type.
- *
  * @param dateInput - The value to format.
  * @param locale - BCP 47 locale tag (defaults to `"en"`).
  * @param options - `Intl.DateTimeFormatOptions` (defaults to `{}`).
  * @returns The formatted date string.
- * @throws {Error} If the input cannot be parsed as a date.
  *
  * @example
  * ```ts
- * useFormat("2024-06-15");                        // "6/15/2024" (en-US)
- * useFormat(Date.now(), "es", { dateStyle: "full" }); // "sábado, 15 de junio de 2024"
+ * useFormat("2024-06-15");
  * ```
  */
 export declare function useFormat(dateInput: TemporalInput, locale?: Locale, options?: Intl.DateTimeFormatOptions): string;
@@ -91,7 +267,6 @@ export declare function useSubtractDays(date: string | Temporal.PlainDate, days:
  * @example
  * ```ts
  * useIsEqual("2024-06-15", "2024-06-15"); // true
- * useIsEqual("2024-06-15", "2024-06-16"); // false
  * ```
  */
 export declare function useIsEqual(date1: string | Temporal.PlainDate, date2: string | Temporal.PlainDate): boolean;
@@ -105,7 +280,6 @@ export declare function useIsEqual(date1: string | Temporal.PlainDate, date2: st
  * @example
  * ```ts
  * useIsBefore("2024-01-01", "2024-06-15"); // true
- * useIsBefore("2024-06-15", "2024-06-15"); // false
  * ```
  */
 export declare function useIsBefore(date1: string | Temporal.PlainDate, date2: string | Temporal.PlainDate): boolean;
@@ -119,7 +293,6 @@ export declare function useIsBefore(date1: string | Temporal.PlainDate, date2: s
  * @example
  * ```ts
  * useIsAfter("2024-06-15", "2024-01-01"); // true
- * useIsAfter("2024-06-15", "2024-06-15"); // false
  * ```
  */
 export declare function useIsAfter(date1: string | Temporal.PlainDate, date2: string | Temporal.PlainDate): boolean;
@@ -143,8 +316,7 @@ export declare function useFirstDayOfMonth(date?: string | Temporal.PlainDate):
  *
  * @example
  * ```ts
- * useLastDayOfMonth("2024-02-10"); // "2024-02-29" (leap year)
- * useLastDayOfMonth("2024-06-15"); // "2024-06-30"
+ * useLastDayOfMonth("2024-02-10"); // "2024-02-29"
  * ```
  */
 export declare function useLastDayOfMonth(date?: string | Temporal.PlainDate): string;

package/dist/core/services/dates.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dates.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/dates.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAalE;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACtB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,EAClC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,GAC9B,MAAM,CAMR;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACxB,SAAS,EAAE,aAAa,EACxB,MAAM,GAAE,MAAa,EACrB,OAAO,GAAE,IAAI,CAAC,qBAA0B,GACtC,MAAM,CA6BR;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,EAClC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,GAChC,OAAO,CAET;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,EAClC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,GAChC,OAAO,CAET;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,EAClC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,GAChC,OAAO,CAET;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,GAAE,MAAM,GAAG,QAAQ,CAAC,SAAuC,GAC7D,MAAM,CAER;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,GAAE,MAAM,GAAG,QAAQ,CAAC,SAAuC,GAC7D,MAAM,CAER"}
+{"version":3,"file":"dates.service.d.ts","sourceRoot":"","sources":["../../../src/core/services/dates.service.ts"],"names":[],"mappings":"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"}

package/dist/core/services/dates.service.js

@@ -1,14 +1,252 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { useLogger } from "./logger.service.js";
 /**
- * Internal helper that adapts flexible inputs into a `PlainDate`.
+ * DatesService - Singleton para operaciones de fechas.
  *
- * @param date - An ISO date string or a `Temporal.PlainDate`.
- * @returns A `Temporal.PlainDate`.
+ * Aplica el patrón Singleton: una única instancia reutilizable que centraliza
+ * toda la lógica de fechas (diferencias, formateo, aritmética y comparaciones).
+ * Puro, sin I/O, seguro para SSR.
  */
-function toPlainDate(date) {
-    return typeof date === "string" ? Temporal.PlainDate.from(date) : date;
+export class DatesService {
+    static instance;
+    /**
+     * Constructor privado - enforce singleton.
+     */
+    constructor() { }
+    /**
+     * Obtiene la instancia única del DatesService (Singleton).
+     *
+     * @returns La instancia única de {@link DatesService}.
+     *
+     * @example
+     * ```ts
+     * const dates = DatesService.getInstance();
+     * dates.useNow();
+     * ```
+     */
+    static getInstance() {
+        if (!DatesService.instance) {
+            DatesService.instance = new DatesService();
+        }
+        return DatesService.instance;
+    }
+    /**
+     * Internal helper that adapts flexible inputs into a `PlainDate`.
+     *
+     * @param date - An ISO date string or a `Temporal.PlainDate`.
+     * @returns A `Temporal.PlainDate`.
+     */
+    toPlainDate(date) {
+        return typeof date === "string" ? Temporal.PlainDate.from(date) : date;
+    }
+    /**
+     * Returns a human-readable diff between two dates as years, months, and days.
+     *
+     * @param start - Start date (ISO string or `PlainDate`).
+     * @param end - End date (ISO string or `PlainDate`).
+     * @returns A formatted string, e.g. `"2 years, 3 months and 15 days"`.
+     *
+     * @example
+     * ```ts
+     * useDiff("2020-01-01", "2022-04-16");
+     * // "2 years, 3 months and 15 days"
+     * ```
+     */
+    useDiff(start, end) {
+        const startDate = this.toPlainDate(start);
+        const endDate = this.toPlainDate(end);
+        const duration = startDate.until(endDate, { largestUnit: "year" });
+        return `${duration.years} years, ${duration.months} months and ${duration.days} days`;
+    }
+    /**
+     * Formats a date input into a localised string using `Intl.DateTimeFormat`.
+     *
+     * Accepts epoch milliseconds, ISO strings, native `Date` objects,
+     * `Temporal.Instant`, or any `Temporal` date/time type.
+     *
+     * @param dateInput - The value to format.
+     * @param locale - BCP 47 locale tag (defaults to `"en"`).
+     * @param options - `Intl.DateTimeFormatOptions` (defaults to `{}`).
+     * @returns The formatted date string.
+     * @throws {Error} If the input cannot be parsed as a date.
+     *
+     * @example
+     * ```ts
+     * useFormat("2024-06-15");                        // "6/15/2024" (en-US)
+     * useFormat(Date.now(), "es", { dateStyle: "full" }); // "sábado, 15 de junio de 2024"
+     * ```
+     */
+    useFormat(dateInput, locale = "en", options = {}) {
+        let date;
+        try {
+            if (typeof dateInput === "number") {
+                date = Temporal.Instant.fromEpochMilliseconds(dateInput).toZonedDateTimeISO(Temporal.Now.timeZoneId());
+            }
+            else if (typeof dateInput === "string") {
+                try {
+                    date = Temporal.PlainDate.from(dateInput);
+                }
+                catch {
+                    date = Temporal.PlainDateTime.from(dateInput);
+                }
+            }
+            else if (dateInput instanceof Date) {
+                date = Temporal.Instant.fromEpochMilliseconds(dateInput.getTime()).toZonedDateTimeISO(Temporal.Now.timeZoneId());
+            }
+            else if (dateInput instanceof Temporal.Instant) {
+                date = dateInput.toZonedDateTimeISO(Temporal.Now.timeZoneId());
+            }
+            else {
+                date = dateInput;
+            }
+            return date.toLocaleString(locale, options);
+        }
+        catch (error) {
+            useLogger("Invalid date input:", error, "error");
+            throw new Error(`Invalid date input: ${dateInput}`);
+        }
+    }
+    /**
+     * Returns today's date as an ISO date string.
+     *
+     * @returns The current date in `YYYY-MM-DD` format.
+     *
+     * @example
+     * ```ts
+     * useNow(); // "2024-06-15"
+     * ```
+     */
+    useNow() {
+        return Temporal.Now.plainDateISO().toString();
+    }
+    /**
+     * Returns the current date and time as an ISO string (no timezone offset).
+     *
+     * @returns The current date-time in `YYYY-MM-DDTHH:MM:SS` format.
+     *
+     * @example
+     * ```ts
+     * useNowDateTime(); // "2024-06-15T14:30:00"
+     * ```
+     */
+    useNowDateTime() {
+        return Temporal.Now.plainDateTimeISO().toString();
+    }
+    /**
+     * Adds a number of days to a date.
+     *
+     * @param date - Base date (ISO string or `PlainDate`).
+     * @param days - Number of days to add (can be negative).
+     * @returns The resulting date as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useAddDays("2024-01-01", 10); // "2024-01-11"
+     * ```
+     */
+    useAddDays(date, days) {
+        return this.toPlainDate(date).add({ days }).toString();
+    }
+    /**
+     * Subtracts a number of days from a date.
+     *
+     * @param date - Base date (ISO string or `PlainDate`).
+     * @param days - Number of days to subtract.
+     * @returns The resulting date as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useSubtractDays("2024-01-11", 10); // "2024-01-01"
+     * ```
+     */
+    useSubtractDays(date, days) {
+        return this.toPlainDate(date).subtract({ days }).toString();
+    }
+    /**
+     * Checks whether two dates are equal.
+     *
+     * @param date1 - First date (ISO string or `PlainDate`).
+     * @param date2 - Second date (ISO string or `PlainDate`).
+     * @returns `true` if the dates represent the same day.
+     *
+     * @example
+     * ```ts
+     * useIsEqual("2024-06-15", "2024-06-15"); // true
+     * useIsEqual("2024-06-15", "2024-06-16"); // false
+     * ```
+     */
+    useIsEqual(date1, date2) {
+        return Temporal.PlainDate.compare(this.toPlainDate(date1), this.toPlainDate(date2)) === 0;
+    }
+    /**
+     * Checks whether `date1` is before `date2`.
+     *
+     * @param date1 - First date (ISO string or `PlainDate`).
+     * @param date2 - Second date (ISO string or `PlainDate`).
+     * @returns `true` if `date1` is strictly before `date2`.
+     *
+     * @example
+     * ```ts
+     * useIsBefore("2024-01-01", "2024-06-15"); // true
+     * useIsBefore("2024-06-15", "2024-06-15"); // false
+     * ```
+     */
+    useIsBefore(date1, date2) {
+        return Temporal.PlainDate.compare(this.toPlainDate(date1), this.toPlainDate(date2)) < 0;
+    }
+    /**
+     * Checks whether `date1` is after `date2`.
+     *
+     * @param date1 - First date (ISO string or `PlainDate`).
+     * @param date2 - Second date (ISO string or `PlainDate`).
+     * @returns `true` if `date1` is strictly after `date2`.
+     *
+     * @example
+     * ```ts
+     * useIsAfter("2024-06-15", "2024-01-01"); // true
+     * useIsAfter("2024-06-15", "2024-06-15"); // false
+     * ```
+     */
+    useIsAfter(date1, date2) {
+        return Temporal.PlainDate.compare(this.toPlainDate(date1), this.toPlainDate(date2)) > 0;
+    }
+    /**
+     * Returns the first day of the month for a given date.
+     *
+     * @param date - Base date (defaults to today).
+     * @returns The first day of the month as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useFirstDayOfMonth("2024-06-15"); // "2024-06-01"
+     * ```
+     */
+    useFirstDayOfMonth(date = Temporal.Now.plainDateISO()) {
+        return this.toPlainDate(date).with({ day: 1 }).toString();
+    }
+    /**
+     * Returns the last day of the month for a given date.
+     *
+     * @param date - Base date (defaults to today).
+     * @returns The last day of the month as an ISO string.
+     *
+     * @example
+     * ```ts
+     * useLastDayOfMonth("2024-02-10"); // "2024-02-29" (leap year)
+     * useLastDayOfMonth("2024-06-15"); // "2024-06-30"
+     * ```
+     */
+    useLastDayOfMonth(date = Temporal.Now.plainDateISO()) {
+        return this.toPlainDate(date)
+            .add({ months: 1 })
+            .with({ day: 1 })
+            .subtract({ days: 1 })
+            .toString();
+    }
 }
+/* -------------------------------------------------------------------------- */
+/* Wrappers (backward compatibility)                                          */
+/* -------------------------------------------------------------------------- */
 /**
  * Returns a human-readable diff between two dates as years, months, and days.
  *
@@ -23,58 +261,23 @@ function toPlainDate(date) {
  * ```
  */
 export function useDiff(start, end) {
-    const startDate = toPlainDate(start);
-    const endDate = toPlainDate(end);
-    const duration = startDate.until(endDate, { largestUnit: "year" });
-    return `${duration.years} years, ${duration.months} months and ${duration.days} days`;
+    return DatesService.getInstance().useDiff(start, end);
 }
 /**
  * Formats a date input into a localised string using `Intl.DateTimeFormat`.
  *
- * Accepts epoch milliseconds, ISO strings, native `Date` objects,
- * `Temporal.Instant`, or any `Temporal` date/time type.
- *
  * @param dateInput - The value to format.
  * @param locale - BCP 47 locale tag (defaults to `"en"`).
  * @param options - `Intl.DateTimeFormatOptions` (defaults to `{}`).
  * @returns The formatted date string.
- * @throws {Error} If the input cannot be parsed as a date.
  *
  * @example
  * ```ts
- * useFormat("2024-06-15");                        // "6/15/2024" (en-US)
- * useFormat(Date.now(), "es", { dateStyle: "full" }); // "sábado, 15 de junio de 2024"
+ * useFormat("2024-06-15");
  * ```
  */
 export function useFormat(dateInput, locale = "en", options = {}) {
-    let date;
-    try {
-        if (typeof dateInput === "number") {
-            date = Temporal.Instant.fromEpochMilliseconds(dateInput).toZonedDateTimeISO(Temporal.Now.timeZoneId());
-        }
-        else if (typeof dateInput === "string") {
-            try {
-                date = Temporal.PlainDate.from(dateInput);
-            }
-            catch {
-                date = Temporal.PlainDateTime.from(dateInput);
-            }
-        }
-        else if (dateInput instanceof Date) {
-            date = Temporal.Instant.fromEpochMilliseconds(dateInput.getTime()).toZonedDateTimeISO(Temporal.Now.timeZoneId());
-        }
-        else if (dateInput instanceof Temporal.Instant) {
-            date = dateInput.toZonedDateTimeISO(Temporal.Now.timeZoneId());
-        }
-        else {
-            date = dateInput;
-        }
-        return date.toLocaleString(locale, options);
-    }
-    catch (error) {
-        useLogger("Invalid date input:", error, "error");
-        throw new Error(`Invalid date input: ${dateInput}`);
-    }
+    return DatesService.getInstance().useFormat(dateInput, locale, options);
 }
 /**
  * Returns today's date as an ISO date string.
@@ -87,7 +290,7 @@ export function useFormat(dateInput, locale = "en", options = {}) {
  * ```
  */
 export function useNow() {
-    return Temporal.Now.plainDateISO().toString();
+    return DatesService.getInstance().useNow();
 }
 /**
  * Returns the current date and time as an ISO string (no timezone offset).
@@ -100,7 +303,7 @@ export function useNow() {
  * ```
  */
 export function useNowDateTime() {
-    return Temporal.Now.plainDateTimeISO().toString();
+    return DatesService.getInstance().useNowDateTime();
 }
 /**
  * Adds a number of days to a date.
@@ -115,7 +318,7 @@ export function useNowDateTime() {
  * ```
  */
 export function useAddDays(date, days) {
-    return toPlainDate(date).add({ days }).toString();
+    return DatesService.getInstance().useAddDays(date, days);
 }
 /**
  * Subtracts a number of days from a date.
@@ -130,7 +333,7 @@ export function useAddDays(date, days) {
  * ```
  */
 export function useSubtractDays(date, days) {
-    return toPlainDate(date).subtract({ days }).toString();
+    return DatesService.getInstance().useSubtractDays(date, days);
 }
 /**
  * Checks whether two dates are equal.
@@ -142,11 +345,10 @@ export function useSubtractDays(date, days) {
  * @example
  * ```ts
  * useIsEqual("2024-06-15", "2024-06-15"); // true
- * useIsEqual("2024-06-15", "2024-06-16"); // false
  * ```
  */
 export function useIsEqual(date1, date2) {
-    return Temporal.PlainDate.compare(toPlainDate(date1), toPlainDate(date2)) === 0;
+    return DatesService.getInstance().useIsEqual(date1, date2);
 }
 /**
  * Checks whether `date1` is before `date2`.
@@ -158,11 +360,10 @@ export function useIsEqual(date1, date2) {
  * @example
  * ```ts
  * useIsBefore("2024-01-01", "2024-06-15"); // true
- * useIsBefore("2024-06-15", "2024-06-15"); // false
  * ```
  */
 export function useIsBefore(date1, date2) {
-    return Temporal.PlainDate.compare(toPlainDate(date1), toPlainDate(date2)) < 0;
+    return DatesService.getInstance().useIsBefore(date1, date2);
 }
 /**
  * Checks whether `date1` is after `date2`.
@@ -174,11 +375,10 @@ export function useIsBefore(date1, date2) {
  * @example
  * ```ts
  * useIsAfter("2024-06-15", "2024-01-01"); // true
- * useIsAfter("2024-06-15", "2024-06-15"); // false
  * ```
  */
 export function useIsAfter(date1, date2) {
-    return Temporal.PlainDate.compare(toPlainDate(date1), toPlainDate(date2)) > 0;
+    return DatesService.getInstance().useIsAfter(date1, date2);
 }
 /**
  * Returns the first day of the month for a given date.
@@ -192,7 +392,7 @@ export function useIsAfter(date1, date2) {
  * ```
  */
 export function useFirstDayOfMonth(date = Temporal.Now.plainDateISO()) {
-    return toPlainDate(date).with({ day: 1 }).toString();
+    return DatesService.getInstance().useFirstDayOfMonth(date);
 }
 /**
  * Returns the last day of the month for a given date.
@@ -202,11 +402,10 @@ export function useFirstDayOfMonth(date = Temporal.Now.plainDateISO()) {
  *
  * @example
  * ```ts
- * useLastDayOfMonth("2024-02-10"); // "2024-02-29" (leap year)
- * useLastDayOfMonth("2024-06-15"); // "2024-06-30"
+ * useLastDayOfMonth("2024-02-10"); // "2024-02-29"
  * ```
  */
 export function useLastDayOfMonth(date = Temporal.Now.plainDateISO()) {
-    return toPlainDate(date).add({ months: 1 }).with({ day: 1 }).subtract({ days: 1 }).toString();
+    return DatesService.getInstance().useLastDayOfMonth(date);
 }
 //# sourceMappingURL=dates.service.js.map