chronal 0.0.1 → 0.0.4

package/README.md

@@ -157,27 +157,31 @@ chronal("2024-01-01")
 
 ## Configuration
 
-### `setDefaultLocale(locale)`
+### `setConfig(config)`
 
-Set the default locale for all date formatting operations.
+Set the default configuration for all date operations.
 
 **Parameters:**
-
-- `locale` (string) - The locale code (e.g., 'en-US', 'pt-BR', 'fr-FR')
+- `config` (object) - Configuration object with optional properties:
+  - `locale` (string) - The locale code (e.g., 'en-US', 'pt-BR', 'fr-FR')
+  - `timezone` (string) - The default IANA timezone (e.g., 'UTC', 'America/Sao_Paulo')
 
 **Example:**
 
 ```typescript
-import { formatDate, months, setDefaultLocale } from "chronal";
+import { formatDate, months, setConfig } from "chronal";
 
-// Default is 'en-US'
+// Default is 'en-US' and 'UTC'
 formatDate(new Date("2024-06-15"), "MMMM"); // 'June'
 
 // Change default locale
-setDefaultLocale("pt-BR");
+setConfig({ locale: "pt-BR" });
 formatDate(new Date("2024-06-15"), "MMMM"); // 'junho'
 months(); // ['janeiro', 'fevereiro', 'março', ...]
 
+// Change default timezone
+setConfig({ timezone: "America/Sao_Paulo" });
+
 // You can still override per call
 formatDate(new Date("2024-06-15"), "MMMM", { locale: "fr-FR" }); // 'juin'
 ```

package/esm/chainable/end-of.d.ts

@@ -1,15 +1,17 @@
+import { endOf as _endOf } from "../lib/end-of.js";
 import { type Chronal } from "./chronal.js";
-import type { Unit } from "../types/unit.js";
 /**
  * Returns the end of the specified time unit.
  *
  * @param unit - The time unit ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second')
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to 'UTC'.
  * @returns A new Chronal instance set to the end of the specified unit (last millisecond)
  * @example
  * ```typescript
  * const c = chronal('2024-06-15T14:35:22.500Z');
  * c.endOf('day'); // '2024-06-15T23:59:59.999Z'
+ * c.endOf('day', 'America/Sao_Paulo'); // '2024-06-16T02:59:59.999Z'
  * ```
  */
-export declare function endOf(this: Chronal, unit: Unit): Chronal;
+export declare function endOf(this: Chronal, unit: Parameters<typeof _endOf>[1], opt?: Parameters<typeof _endOf>[2]): Chronal;
 //# sourceMappingURL=end-of.d.ts.map

package/esm/chainable/end-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"end-of.d.ts","sourceRoot":"","sources":["../../src/chainable/end-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAGxD"}
+{"version":3,"file":"end-of.d.ts","sourceRoot":"","sources":["../../src/chainable/end-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAM,GAAG,OAAO,CAGxH"}

package/esm/chainable/end-of.js

@@ -4,14 +4,16 @@ import { chronal } from "./chronal.js";
  * Returns the end of the specified time unit.
  *
  * @param unit - The time unit ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second')
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to 'UTC'.
  * @returns A new Chronal instance set to the end of the specified unit (last millisecond)
  * @example
  * ```typescript
  * const c = chronal('2024-06-15T14:35:22.500Z');
  * c.endOf('day'); // '2024-06-15T23:59:59.999Z'
+ * c.endOf('day', 'America/Sao_Paulo'); // '2024-06-16T02:59:59.999Z'
  * ```
  */
-export function endOf(unit) {
-    const newDate = _endOf(this.date, unit);
+export function endOf(unit, opt = {}) {
+    const newDate = _endOf(this.date, unit, opt);
     return chronal(newDate);
 }

package/esm/chainable/from-now.d.ts

@@ -2,7 +2,7 @@ import type { Chronal } from "./chronal.js";
 /**
  * Returns a string representing how long ago the date was from now.
  *
- * @param locale - The locale to use for formatting (default: DEFAULT_LOCALE)
+ * @param locale - The locale to use for formatting (default: en-US)
  * @returns A human-readable relative time string
  * @example
  * ```typescript

package/esm/chainable/from-now.js

@@ -2,7 +2,7 @@ import { fromNow as _fromNow } from "../lib/from-now.js";
 /**
  * Returns a string representing how long ago the date was from now.
  *
- * @param locale - The locale to use for formatting (default: DEFAULT_LOCALE)
+ * @param locale - The locale to use for formatting (default: en-US)
  * @returns A human-readable relative time string
  * @example
  * ```typescript

package/esm/chainable/start-of.d.ts

@@ -4,12 +4,14 @@ import { type Chronal } from "./chronal.js";
  * Returns the start of the specified time unit.
  *
  * @param unit - The time unit ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second')
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to 'UTC'.
  * @returns A new Chronal instance set to the start of the specified unit
  * @example
  * ```typescript
  * const c = chronal('2024-06-15T14:35:22.500Z');
  * c.startOf('day'); // '2024-06-15T00:00:00.000Z'
+ * c.startOf('day', 'America/Sao_Paulo'); // '2024-06-15T03:00:00.000Z'
  * ```
  */
-export declare function startOf(this: Chronal, unit: Parameters<typeof _startOf>[1]): Chronal;
+export declare function startOf(this: Chronal, unit: Parameters<typeof _startOf>[1], opt?: Parameters<typeof _startOf>[2]): Chronal;
 //# sourceMappingURL=start-of.d.ts.map

package/esm/chainable/start-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-of.d.ts","sourceRoot":"","sources":["../../src/chainable/start-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GACnC,OAAO,CAGT"}
+{"version":3,"file":"start-of.d.ts","sourceRoot":"","sources":["../../src/chainable/start-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EACpC,GAAG,GAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAM,GACvC,OAAO,CAGT"}

package/esm/chainable/start-of.js

@@ -4,14 +4,16 @@ import { chronal } from "./chronal.js";
  * Returns the start of the specified time unit.
  *
  * @param unit - The time unit ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second')
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to 'UTC'.
  * @returns A new Chronal instance set to the start of the specified unit
  * @example
  * ```typescript
  * const c = chronal('2024-06-15T14:35:22.500Z');
  * c.startOf('day'); // '2024-06-15T00:00:00.000Z'
+ * c.startOf('day', 'America/Sao_Paulo'); // '2024-06-15T03:00:00.000Z'
  * ```
  */
-export function startOf(unit) {
-    const newDate = _startOf(this.date, unit);
+export function startOf(unit, opt = {}) {
+    const newDate = _startOf(this.date, unit, opt);
     return chronal(newDate);
 }

package/esm/chainable/to-now.d.ts

@@ -3,7 +3,7 @@ import type { Chronal } from "./chronal.js";
  * Returns a string representing the time from now to the date.
  * This is the inverse of fromNow() - it shows how long until/since a date from the perspective of looking forward to it.
  *
- * @param locale - The locale to use for formatting (default: DEFAULT_LOCALE)
+ * @param locale - The locale to use for formatting (default: en-US)
  * @returns A human-readable relative time string
  * @example
  * ```typescript

package/esm/chainable/to-now.js

@@ -3,7 +3,7 @@ import { toNow as _toNow } from "../lib/to-now.js";
  * Returns a string representing the time from now to the date.
  * This is the inverse of fromNow() - it shows how long until/since a date from the perspective of looking forward to it.
  *
- * @param locale - The locale to use for formatting (default: DEFAULT_LOCALE)
+ * @param locale - The locale to use for formatting (default: en-US)
  * @returns A human-readable relative time string
  * @example
  * ```typescript

package/esm/lib/config.d.ts

@@ -0,0 +1,8 @@
+type Config = {
+    locale: string;
+    timezone: string;
+};
+export declare const config: Config;
+export declare function setConfig(c: Partial<Config>): void;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/esm/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAGA,KAAK,MAAM,GAAG;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,MAGpB,CAAA;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAQ3C"}

package/esm/lib/config.js

@@ -0,0 +1,14 @@
+const DEFAULT_LOCALE = "en-US";
+const DEFAULT_TZ = "UTC";
+export const config = {
+    locale: DEFAULT_LOCALE,
+    timezone: DEFAULT_TZ,
+};
+export function setConfig(c) {
+    if (c.locale) {
+        config.locale = c.locale;
+    }
+    if (c.timezone) {
+        config.timezone = c.timezone;
+    }
+}

package/esm/lib/end-of.d.ts

@@ -1,14 +1,26 @@
 import type { Unit } from "../types/unit.js";
+type EndOfOptions = {
+    tz?: string;
+};
 /**
  * Returns the end of the specified time unit for the given date.
  *
  * @param date - The original date.
  * @param unit - The time unit to get the end of ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second').
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo', 'Europe/London'). Defaults to 'UTC'.
  * @returns A new Date object set to the end of the specified unit (last millisecond).
  * @example
+ * // UTC timezone (default)
  * const date = new Date('2024-06-15T14:35:22.500Z');
  * const endOfDay = endOf(date, 'day');
  * console.log(endOfDay.toISOString()); // '2024-06-15T23:59:59.999Z'
+ *
+ * @example
+ * // With timezone
+ * const date = new Date('2024-06-15T14:35:22.500Z');
+ * const endOfDay = endOf(date, 'day', 'America/Sao_Paulo'); // GMT-3
+ * console.log(endOfDay.toISOString()); // '2024-06-16T02:59:59.999Z' (23:59:59.999 in Sao Paulo)
  */
-export declare function endOf(date: Date, unit: Unit): Date;
+export declare function endOf(date: Date, unit: Unit, opt?: EndOfOptions): Date;
+export {};
 //# sourceMappingURL=end-of.d.ts.map

package/esm/lib/end-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"end-of.d.ts","sourceRoot":"","sources":["../../src/lib/end-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;;;GAUG;AAEH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CA2ClD"}
+{"version":3,"file":"end-of.d.ts","sourceRoot":"","sources":["../../src/lib/end-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI7C,KAAK,YAAY,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAA;AACD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,YAAiB,GAAG,IAAI,CAmH1E"}

package/esm/lib/end-of.js

@@ -1,53 +1,131 @@
+import { config } from "./config.js";
+import { startOf } from "./start-of.js";
 /**
  * Returns the end of the specified time unit for the given date.
  *
  * @param date - The original date.
  * @param unit - The time unit to get the end of ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second').
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo', 'Europe/London'). Defaults to 'UTC'.
  * @returns A new Date object set to the end of the specified unit (last millisecond).
  * @example
+ * // UTC timezone (default)
  * const date = new Date('2024-06-15T14:35:22.500Z');
  * const endOfDay = endOf(date, 'day');
  * console.log(endOfDay.toISOString()); // '2024-06-15T23:59:59.999Z'
+ *
+ * @example
+ * // With timezone
+ * const date = new Date('2024-06-15T14:35:22.500Z');
+ * const endOfDay = endOf(date, 'day', 'America/Sao_Paulo'); // GMT-3
+ * console.log(endOfDay.toISOString()); // '2024-06-16T02:59:59.999Z' (23:59:59.999 in Sao Paulo)
  */
-export function endOf(date, unit) {
-    const time = new Date(date.getTime());
-    switch (unit) {
-        case "year": {
-            time.setUTCMonth(11, 31);
-            time.setUTCHours(23, 59, 59, 999);
-            break;
-        }
-        case "month": {
-            // Set to next month's first day, then subtract 1 millisecond
-            const month = time.getUTCMonth();
-            time.setUTCMonth(month + 1, 1);
-            time.setUTCHours(0, 0, 0, 0);
-            time.setTime(time.getTime() - 1);
-            break;
-        }
-        case "week": {
-            const day = time.getUTCDay();
-            const diff = (day === 0 ? 0 : 7) - day; // Adjust when day is Sunday
-            time.setUTCDate(time.getUTCDate() + diff);
-            time.setUTCHours(23, 59, 59, 999);
-            break;
+export function endOf(date, unit, opt = {}) {
+    const timezone = opt.tz || config.timezone;
+    if (timezone === "UTC") {
+        // Original UTC-based logic
+        const time = new Date(date.getTime());
+        switch (unit) {
+            case "year": {
+                time.setUTCMonth(11, 31);
+                time.setUTCHours(23, 59, 59, 999);
+                break;
+            }
+            case "month": {
+                const month = time.getUTCMonth();
+                time.setUTCMonth(month + 1, 1);
+                time.setUTCHours(0, 0, 0, 0);
+                time.setTime(time.getTime() - 1);
+                break;
+            }
+            case "week": {
+                const day = time.getUTCDay();
+                const diff = (day === 0 ? 0 : 7) - day;
+                time.setUTCDate(time.getUTCDate() + diff);
+                time.setUTCHours(23, 59, 59, 999);
+                break;
+            }
+            case "day": {
+                time.setUTCHours(23, 59, 59, 999);
+                break;
+            }
+            case "hour": {
+                time.setUTCMinutes(59, 59, 999);
+                break;
+            }
+            case "minute": {
+                time.setUTCSeconds(59, 999);
+                break;
+            }
+            case "second": {
+                time.setUTCMilliseconds(999);
+                break;
+            }
         }
-        case "day": {
-            time.setUTCHours(23, 59, 59, 999);
-            break;
-        }
-        case "hour": {
-            time.setUTCMinutes(59, 59, 999);
-            break;
-        }
-        case "minute": {
-            time.setUTCSeconds(59, 999);
-            break;
-        }
-        case "second": {
-            time.setUTCMilliseconds(999);
-            break;
+        return time;
+    }
+    else {
+        // Timezone-aware: get start of next unit and subtract 1ms
+        const unitMap = {
+            "second": "second",
+            "minute": "minute",
+            "hour": "hour",
+            "day": "day",
+            "week": "week",
+            "month": "month",
+            "year": "year",
+        };
+        // Get the start of the current unit
+        const start = startOf(date, unit, { tz: timezone });
+        // Calculate the next unit boundary
+        let nextBoundary;
+        switch (unit) {
+            case "year": {
+                // Add 1 year
+                const formatter = new Intl.DateTimeFormat("en-US", {
+                    timeZone: timezone,
+                    year: "numeric",
+                });
+                const year = parseInt(formatter.format(start));
+                const nextYear = new Date(start);
+                nextYear.setUTCFullYear(year + 1);
+                nextBoundary = startOf(nextYear, "year", { tz: timezone });
+                break;
+            }
+            case "month": {
+                // Add 1 month
+                const nextMonth = new Date(start.getTime() + 32 * 24 * 60 * 60 * 1000);
+                nextBoundary = startOf(nextMonth, "month", { tz: timezone });
+                break;
+            }
+            case "week": {
+                // Add 7 days
+                const nextWeek = new Date(start.getTime() + 7 * 24 * 60 * 60 * 1000);
+                nextBoundary = startOf(nextWeek, "week", { tz: timezone });
+                break;
+            }
+            case "day": {
+                // Add 1 day
+                const nextDay = new Date(start.getTime() + 25 * 60 * 60 * 1000);
+                nextBoundary = startOf(nextDay, "day", { tz: timezone });
+                break;
+            }
+            case "hour": {
+                // Add 1 hour
+                nextBoundary = new Date(start.getTime() + 60 * 60 * 1000);
+                break;
+            }
+            case "minute": {
+                // Add 1 minute
+                nextBoundary = new Date(start.getTime() + 60 * 1000);
+                break;
+            }
+            case "second": {
+                // Add 1 second
+                nextBoundary = new Date(start.getTime() + 1000);
+                break;
+            }
         }
+        // Return 1ms before the next boundary
+        return new Date(nextBoundary.getTime() - 1);
     }
-    return time;
 }

package/esm/lib/format-date.js

@@ -1,6 +1,6 @@
 import { getDTF } from "../core/dtf.js";
-import { DEFAULT_LOCALE } from "./set-default-locale.js";
 import { months } from "./months.js";
+import { config } from "./config.js";
 // Pre-compute pad functions to avoid repeated padStart calls
 const pad2 = (n) => n < 10 ? "0" + n : String(n);
 const tokenMap = {
@@ -177,8 +177,8 @@ function getPartsWithTZ(date, locale, tz) {
  * console.log(formatDate(date, 'MMMM D, YYYY', { locale: 'en-US' })); // 'June 15, 2024'
  */
 export function formatDate(date, fmt, options = {}) {
-    const locale = options.locale ?? DEFAULT_LOCALE;
-    const tz = options.tz ?? "UTC";
+    const locale = options.locale ?? config.locale;
+    const tz = options.tz ?? config.timezone;
     // Get compiled format (cached)
     const compiled = compileFormat(fmt);
     // Fast path for UTC

package/esm/lib/from-now.d.ts

@@ -2,7 +2,7 @@
  * Returns a string representing how long ago the date was from now.
  *
  * @param date - The date to compare with now
- * @param locale - The locale to use for formatting (default: DEFAULT_LOCALE)
+ * @param locale - The locale to use for formatting (default: en-US)
  * @returns A human-readable relative time string
  *
  * @example

package/esm/lib/from-now.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"from-now.d.ts","sourceRoot":"","sources":["../../src/lib/from-now.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAuB,GAAG,MAAM,CAmC3E"}
+{"version":3,"file":"from-now.d.ts","sourceRoot":"","sources":["../../src/lib/from-now.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,MAAsB,GAAG,MAAM,CAmC1E"}

package/esm/lib/from-now.js

@@ -1,9 +1,9 @@
-import { DEFAULT_LOCALE } from "./set-default-locale.js";
+import { config } from "./config.js";
 /**
  * Returns a string representing how long ago the date was from now.
  *
  * @param date - The date to compare with now
- * @param locale - The locale to use for formatting (default: DEFAULT_LOCALE)
+ * @param locale - The locale to use for formatting (default: en-US)
  * @returns A human-readable relative time string
  *
  * @example
@@ -17,7 +17,7 @@ import { DEFAULT_LOCALE } from "./set-default-locale.js";
  * fromNow(inTwoHours, "es-ES"); // "dentro de 2 horas"
  * ```
  */
-export function fromNow(date, locale = DEFAULT_LOCALE) {
+export function fromNow(date, locale = config.locale) {
     const now = Date.now();
     const diff = now - date.getTime();
     const absDiff = Math.abs(diff);

package/esm/lib/months.js

@@ -1,4 +1,4 @@
-import { DEFAULT_LOCALE } from "./set-default-locale.js";
+import { config } from "./config.js";
 const monthsCache = new Map();
 /**
  * Returns an array of month names for the specified locale and format.
@@ -12,7 +12,7 @@ const monthsCache = new Map();
  * console.log(months('pt-BR', 'long')); // ['janeiro', 'fevereiro', 'março', ...]
  */
 export function months(format = "long", opt = {}) {
-    const locale = opt.locale ?? DEFAULT_LOCALE;
+    const locale = opt.locale ?? config.locale;
     const key = `${locale}|${format}`;
     const cached = monthsCache.get(key);
     if (cached)

package/esm/lib/start-of.d.ts

@@ -1,14 +1,26 @@
 import type { Unit } from "../types/unit.js";
+type StartOfOptions = {
+    tz?: string;
+};
 /**
  * Returns the start of the specified time unit for the given date.
  *
  * @param date - The original date.
  * @param unit - The time unit to get the start of ('year' | 'month' | 'day' | 'hour' | 'minute' | 'second').
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo', 'Europe/London'). Defaults to 'UTC'.
  * @returns A new Date object set to the start of the specified unit.
  * @example
+ * // UTC timezone (default)
  * const date = new Date('2024-06-15T14:35:22.500Z');
  * const startOfDay = startOf(date, 'day');
  * console.log(startOfDay.toISOString()); // '2024-06-15T00:00:00.000Z'
+ *
+ * @example
+ * // With timezone
+ * const date = new Date('2024-06-15T14:35:22.500Z');
+ * const startOfDay = startOf(date, 'day', 'America/Sao_Paulo'); // GMT-3
+ * console.log(startOfDay.toISOString()); // '2024-06-15T03:00:00.000Z' (00:00 in Sao Paulo)
  */
-export declare function startOf(date: Date, unit: Unit): Date;
+export declare function startOf(date: Date, unit: Unit, opt?: StartOfOptions): Date;
+export {};
 //# sourceMappingURL=start-of.d.ts.map

package/esm/lib/start-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-of.d.ts","sourceRoot":"","sources":["../../src/lib/start-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;;;;;;;;GAUG;AAEH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAwCpD"}
+{"version":3,"file":"start-of.d.ts","sourceRoot":"","sources":["../../src/lib/start-of.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C,KAAK,cAAc,GAAG;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AAEH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,cAAmB,GAAG,IAAI,CA4I9E"}