chronal 0.0.4 → 0.0.6

package/README.md

@@ -59,7 +59,7 @@ npm install chronal
 ```
 
 ```javascript
-import { addTime, formatDate, subTime } from "chronal";
+import { addTime, formatDate, subtract } from "chronal";
 ```
 
 ## Quick Start
@@ -79,7 +79,7 @@ import {
   isToday,
   parseDate,
   startOf,
-  subTime,
+  subtract,
 } from "chronal";
 
 const date = new Date("2024-06-15T14:35:22Z");
@@ -94,7 +94,7 @@ parseDate("15/06/2024", "DD/MM/YYYY"); // Date object for June 15, 2024
 
 // Add/subtract time
 addTime(date, { days: 5, hours: 2 }); // 2024-06-20T16:35:22Z
-subTime(date, { months: 1, days: 10 }); // 2024-05-05T14:35:22Z
+subtract(date, { months: 1, days: 10 }); // 2024-05-05T14:35:22Z
 
 // Start/End of period
 startOf(date, "month"); // 2024-06-01T00:00:00.000Z
@@ -107,7 +107,7 @@ fromNow(new Date(Date.now() - 300000)); // "5 minutes ago"
 isToday(new Date()); // true
 
 // Generate date ranges
-dateRange(new Date("2024-01-01"), new Date("2024-01-05"));
+datesUntil(new Date("2024-01-01"), new Date("2024-01-05"));
 // [2024-01-01, 2024-01-02, 2024-01-03, 2024-01-04, 2024-01-05]
 ```
 
@@ -129,7 +129,7 @@ console.log(date); // "2024-07-01"
 // All methods available
 const result = chronal("2024-01-15")
   .add({ days: 10 })
-  .sub({ hours: 2 })
+  .subtract({ hours: 2 })
   .format("MMMM DD, YYYY"); // "January 25, 2024"
 
 // Query methods
@@ -144,7 +144,7 @@ chronal("2024-06-15").daysInMonth(); // 30
 
 // Generate date ranges
 chronal("2024-01-01")
-  .range(new Date("2024-01-31"), { weeks: 1 })
+  .until(new Date("2024-01-31"), { weeks: 1 })
   .map((c) => c.format("YYYY-MM-DD"));
 // ["2024-01-01", "2024-01-08", "2024-01-15", "2024-01-22", "2024-01-29"]
 ```
@@ -157,7 +157,7 @@ chronal("2024-01-01")
 
 ## Configuration
 
-### `setConfig(config)`
+### `setChronalConfig(config)`
 
 Set the default configuration for all date operations.
 
@@ -169,18 +169,18 @@ Set the default configuration for all date operations.
 **Example:**
 
 ```typescript
-import { formatDate, months, setConfig } from "chronal";
+import { formatDate, months, setChronalConfig } from "chronal";
 
 // Default is 'en-US' and 'UTC'
 formatDate(new Date("2024-06-15"), "MMMM"); // 'June'
 
 // Change default locale
-setConfig({ locale: "pt-BR" });
+setChronalConfig({ locale: "pt-BR" });
 formatDate(new Date("2024-06-15"), "MMMM"); // 'junho'
 months(); // ['janeiro', 'fevereiro', 'março', ...]
 
 // Change default timezone
-setConfig({ timezone: "America/Sao_Paulo" });
+setChronalConfig({ timezone: "America/Sao_Paulo" });
 
 // You can still override per call
 formatDate(new Date("2024-06-15"), "MMMM", { locale: "fr-FR" }); // 'juin'
@@ -210,7 +210,7 @@ All chainable methods correspond to functional API functions:
 | Chainable Method          | Functional API                        | Description              |
 | ------------------------- | ------------------------------------- | ------------------------ |
 | `.add(options)`           | `addTime(date, options)`              | Add time units           |
-| `.subtract(options)`      | `subTime(date, options)`              | Subtract time units      |
+| `.subtract(options)`      | `subtract(date, options)`             | Subtract time units      |
 | `.startOf(unit)`          | `startOf(date, unit)`                 | Start of time unit       |
 | `.endOf(unit)`            | `endOf(date, unit)`                   | End of time unit         |
 | `.set(options)`           | `setUnit(date, options)`              | Set specific units       |
@@ -233,7 +233,7 @@ All chainable methods correspond to functional API functions:
 | `.quarter()`              | `getQuarter(date)`                    | Get quarter (1-4)        |
 | `.daysInMonth()`          | `daysInMonth(date)`                   | Days in month            |
 | `.week()`                 | `weekOfYear(date)`                    | Week of year             |
-| `.range(end, step?)`      | `dateRange(start, end, step?)`        | Generate date array      |
+| `.until(end, step?)`      | `datesUntil(start, end, step?)`        | Generate date array      |
 
 **Example:**
 
@@ -379,7 +379,7 @@ addTime(date, { months: 1 }); // 2024-02-29T12:00:00.000Z (handles leap year)
 addTime(date, { years: 1, months: 2, days: 3 }); // 2025-04-03T12:00:00.000Z
 ```
 
-#### `subTime(date, options)`
+#### `subtract(date, options)`
 
 Subtracts specified time units from a date.
 
@@ -390,8 +390,8 @@ Subtracts specified time units from a date.
 ```typescript
 const date = new Date("2024-03-31T12:00:00Z");
 
-subTime(date, { days: 5 }); // 2024-03-26T12:00:00.000Z
-subTime(date, { months: 1 }); // 2024-02-29T12:00:00.000Z (handles month overflow)
+subtract(date, { days: 5 }); // 2024-03-26T12:00:00.000Z
+subtract(date, { months: 1 }); // 2024-02-29T12:00:00.000Z (handles month overflow)
 ```
 
 #### `getUnit(date, unit)`
@@ -682,7 +682,7 @@ clampDate(new Date("2024-05-15"), min, max); // June 1 (clamped to min)
 clampDate(new Date("2024-07-15"), min, max); // June 30 (clamped to max)
 ```
 
-#### `dateRange(start, end, step?)`
+#### `datesUntil(start, end, step?)`
 
 Generates an array of dates between start and end dates with a specified step.
 
@@ -709,29 +709,29 @@ const start = new Date("2024-01-01");
 const end = new Date("2024-01-05");
 
 // Daily range (default)
-dateRange(start, end);
+datesUntil(start, end);
 // [2024-01-01, 2024-01-02, 2024-01-03, 2024-01-04, 2024-01-05]
 
-// Chainable: chronal("2024-01-01").range(new Date("2024-01-05"))
+// Chainable: chronal("2024-01-01").until(new Date("2024-01-05"))
 
 // Weekly range
 const weekEnd = new Date("2024-01-31");
-dateRange(start, weekEnd, { weeks: 1 });
+datesUntil(start, weekEnd, { weeks: 1 });
 // [2024-01-01, 2024-01-08, 2024-01-15, 2024-01-22, 2024-01-29]
 
-// Chainable: chronal(start).range(weekEnd, { weeks: 1 })
+// Chainable: chronal(start).until(weekEnd, { weeks: 1 })
 
 // Monthly range
 const monthEnd = new Date("2024-06-15");
-dateRange(new Date("2024-01-15"), monthEnd, { months: 1 });
+datesUntil(new Date("2024-01-15"), monthEnd, { months: 1 });
 // [2024-01-15, 2024-02-15, 2024-03-15, 2024-04-15, 2024-05-15, 2024-06-15]
 
 // Every 3 days
-dateRange(start, new Date("2024-01-10"), { days: 3 });
+datesUntil(start, new Date("2024-01-10"), { days: 3 });
 // [2024-01-01, 2024-01-04, 2024-01-07, 2024-01-10]
 
 // Hourly range
-dateRange(
+datesUntil(
   new Date("2024-01-01T09:00:00Z"),
   new Date("2024-01-01T17:00:00Z"),
   { hours: 2 },

package/esm/chainable/chronal.d.ts

@@ -1,5 +1,5 @@
 import { add } from "./add.js";
-import { sub } from "./sub-time.js";
+import { subtract } from "./subtract.js";
 import { format } from "./format.js";
 import { startOf } from "./start-of.js";
 import { endOf } from "./end-of.js";
@@ -22,7 +22,8 @@ import { getQuarter } from "./get-quarter.js";
 import { daysInMonth } from "./days-in-month.js";
 import { weekOfYear } from "./week-of-year.js";
 import { clamp } from "./clamp.js";
-import { dateRange } from "./date-range.js";
+import { until } from "./dates-until.js";
+import { setChronalConfig } from "../lib/config.js";
 /**
  * Chronal object that wraps a Date and provides chainable date manipulation methods.
  * Similar to Day.js API but built on native Date objects with immutable operations.
@@ -33,7 +34,7 @@ export type Chronal = {
     /** Adds time units to this date */
     add: typeof add;
     /** Subtracts time units from this date */
-    sub: typeof sub;
+    subtract: typeof subtract;
     /** Returns the start of a time unit */
     startOf: typeof startOf;
     /** Returns the end of a time unit */
@@ -79,7 +80,7 @@ export type Chronal = {
     /** Gets the week number of the year */
     week: typeof weekOfYear;
     /** Generates an array of dates between this date and end date */
-    range: typeof dateRange;
+    until: typeof until;
 };
 /**
  * Creates a Chronal object with chainable date manipulation methods.
@@ -96,7 +97,7 @@ export type Chronal = {
  * // Create from Date
  * const c = chronal(new Date('2024-06-15'));
  *
- * // Create from string
+ * // Create from string (respects config.timezone)
  * const c2 = chronal('2024-06-15T12:00:00Z');
  *
  * // Chain operations
@@ -106,5 +107,10 @@ export type Chronal = {
  *   .format('YYYY-MM-DD'); // '2024-03-25'
  * ```
  */
-export declare const chronal: (date?: Date | string | number) => Chronal;
+type ChronalFactory = {
+    (date?: Date | string | number | null): Chronal;
+    config: typeof setChronalConfig;
+};
+export declare const chronal: ChronalFactory;
+export {};
 //# sourceMappingURL=chronal.d.ts.map

package/esm/chainable/chronal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chronal.d.ts","sourceRoot":"","sources":["../../src/chainable/chronal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,iCAAiC;IACjC,IAAI,EAAE,IAAI,CAAC;IAGX,mCAAmC;IACnC,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,0CAA0C;IAC1C,GAAG,EAAE,OAAO,GAAG,CAAC;IAChB,uCAAuC;IACvC,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,qCAAqC;IACrC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,+BAA+B;IAC/B,GAAG,EAAE,OAAO,OAAO,CAAC;IACpB,6CAA6C;IAC7C,KAAK,EAAE,OAAO,KAAK,CAAC;IAGpB,mCAAmC;IACnC,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,6DAA6D;IAC7D,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,0DAA0D;IAC1D,KAAK,EAAE,OAAO,KAAK,CAAC;IAGpB,0CAA0C;IAC1C,IAAI,EAAE,OAAO,IAAI,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,kCAAkC;IAClC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,sCAAsC;IACtC,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,kDAAkD;IAClD,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,8BAA8B;IAC9B,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,iCAAiC;IACjC,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,kCAAkC;IAClC,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,oCAAoC;IACpC,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,OAAO,OAAO,CAAC;IAGxB,sCAAsC;IACtC,GAAG,EAAE,OAAO,OAAO,CAAC;IACpB,yCAAyC;IACzC,OAAO,EAAE,OAAO,UAAU,CAAC;IAC3B,2CAA2C;IAC3C,WAAW,EAAE,OAAO,WAAW,CAAC;IAChC,uCAAuC;IACvC,IAAI,EAAE,OAAO,UAAU,CAAC;IAGxB,iEAAiE;IACjE,KAAK,EAAE,OAAO,SAAS,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,IAAI,GAAG,MAAM,GAAG,MAAM,KAAG,OAsFvD,CAAC"}
+{"version":3,"file":"chronal.d.ts","sourceRoot":"","sources":["../../src/chainable/chronal.ts"],"names":[],"mappings":"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"}

package/esm/chainable/chronal.js

@@ -1,5 +1,5 @@
 import { add } from "./add.js";
-import { sub } from "./sub-time.js";
+import { subtract } from "./subtract.js";
 import { format } from "./format.js";
 import { startOf } from "./start-of.js";
 import { endOf } from "./end-of.js";
@@ -22,42 +22,29 @@ import { getQuarter } from "./get-quarter.js";
 import { daysInMonth } from "./days-in-month.js";
 import { weekOfYear } from "./week-of-year.js";
 import { clamp } from "./clamp.js";
-import { dateRange } from "./date-range.js";
-/**
- * Creates a Chronal object with chainable date manipulation methods.
- * All methods return new instances, preserving immutability.
- *
- * @param date - Optional Date, string, or timestamp. Defaults to current date/time
- * @returns A Chronal object with the date and chainable methods
- *
- * @example
- * ```typescript
- * // Create from current time
- * const now = chronal();
- *
- * // Create from Date
- * const c = chronal(new Date('2024-06-15'));
- *
- * // Create from string
- * const c2 = chronal('2024-06-15T12:00:00Z');
- *
- * // Chain operations
- * chronal('2024-01-15')
- *   .add({ months: 2, days: 10 })
- *   .startOf('day')
- *   .format('YYYY-MM-DD'); // '2024-03-25'
- * ```
- */
+import { until } from "./dates-until.js";
+import { parseDate } from "../lib/parse-date.js";
+import { setChronalConfig } from "../lib/config.js";
 export const chronal = (date) => {
-    const d = date ? new Date(date) : new Date();
+    let d;
+    if (date === null || date === undefined) {
+        d = new Date();
+    }
+    else if (typeof date === "string") {
+        // Parse string with timezone awareness from config
+        d = parseDate(date);
+    }
+    else {
+        d = new Date(date);
+    }
     return {
         date: d,
         // Manipulation
         add: function (opt) {
             return add.call(this, opt);
         },
-        sub: function (opt) {
-            return sub.call(this, opt);
+        subtract: function (opt) {
+            return subtract.call(this, opt);
         },
         startOf: function (unit) {
             return startOf.call(this, unit);
@@ -129,8 +116,9 @@ export const chronal = (date) => {
             return weekOfYear.call(this);
         },
         // Utilities
-        range: function (end, step) {
-            return dateRange.call(this, end, step);
+        until: function (end, step) {
+            return until.call(this, end, step);
         },
     };
 };
+chronal.config = setChronalConfig;

package/esm/chainable/{date-range.d.ts → dates-until.d.ts}

@@ -1,4 +1,4 @@
-import { dateRange as _dateRange } from "../lib/date-range.js";
+import { datesUntil as _datesUntil } from "../lib/dates-until.js";
 import { type Chronal } from "./chronal.js";
 /**
  * Generates an array of Chronal objects between this date and an end date with a specified step.
@@ -12,12 +12,12 @@ import { type Chronal } from "./chronal.js";
  * const start = chronal("2024-01-01");
  * const end = new Date("2024-01-05");
  *
- * start.range(end); // Array of 5 Chronal objects (Jan 1-5)
- * start.range(end, { days: 2 }); // Array of 3 Chronal objects (Jan 1, 3, 5)
+ * start.until(end); // Array of 5 Chronal objects (Jan 1-5)
+ * start.until(end, { days: 2 }); // Array of 3 Chronal objects (Jan 1, 3, 5)
  *
  * // Weekly range
- * chronal("2024-01-01").range(new Date("2024-01-31"), { weeks: 1 });
+ * chronal("2024-01-01").until(new Date("2024-01-31"), { weeks: 1 });
  * ```
  */
-export declare function dateRange(this: Chronal, end: Date | Chronal, step?: Parameters<typeof _dateRange>[2]): Chronal[];
-//# sourceMappingURL=date-range.d.ts.map
+export declare function until(this: Chronal, end: Date | Chronal, step?: Parameters<typeof _datesUntil>[2]): Chronal[];
+//# sourceMappingURL=dates-until.d.ts.map

package/esm/chainable/dates-until.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates-until.d.ts","sourceRoot":"","sources":["../../src/chainable/dates-until.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,IAAI,GAAG,OAAO,EACnB,IAAI,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,GACvC,OAAO,EAAE,CAIX"}

package/esm/chainable/{date-range.js → dates-until.js}

@@ -1,4 +1,4 @@
-import { dateRange as _dateRange } from "../lib/date-range.js";
+import { datesUntil as _datesUntil } from "../lib/dates-until.js";
 import { chronal } from "./chronal.js";
 /**
  * Generates an array of Chronal objects between this date and an end date with a specified step.
@@ -12,15 +12,15 @@ import { chronal } from "./chronal.js";
  * const start = chronal("2024-01-01");
  * const end = new Date("2024-01-05");
  *
- * start.range(end); // Array of 5 Chronal objects (Jan 1-5)
- * start.range(end, { days: 2 }); // Array of 3 Chronal objects (Jan 1, 3, 5)
+ * start.until(end); // Array of 5 Chronal objects (Jan 1-5)
+ * start.until(end, { days: 2 }); // Array of 3 Chronal objects (Jan 1, 3, 5)
  *
  * // Weekly range
- * chronal("2024-01-01").range(new Date("2024-01-31"), { weeks: 1 });
+ * chronal("2024-01-01").until(new Date("2024-01-31"), { weeks: 1 });
  * ```
  */
-export function dateRange(end, step) {
+export function until(end, step) {
     const endDate = end instanceof Date ? end : end.date;
-    const dates = _dateRange(this.date, endDate, step);
+    const dates = _datesUntil(this.date, endDate, step);
     return dates.map((date) => chronal(date));
 }

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

@@ -4,13 +4,13 @@ import { type 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'.
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to config.timezone.
  * @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'
+ * c.endOf('day'); // Uses config.timezone
+ * c.endOf('day', { tz: 'America/Sao_Paulo' }); // '2024-06-16T02:59:59.999Z'
  * ```
  */
 export declare function endOf(this: Chronal, unit: Parameters<typeof _endOf>[1], opt?: Parameters<typeof _endOf>[2]): Chronal;

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":"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"}
+{"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;AAGrD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAOpH"}

package/esm/chainable/end-of.js

@@ -1,19 +1,24 @@
 import { endOf as _endOf } from "../lib/end-of.js";
 import { chronal } from "./chronal.js";
+import { config } from "../lib/config.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'.
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to config.timezone.
  * @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'
+ * c.endOf('day'); // Uses config.timezone
+ * c.endOf('day', { tz: 'America/Sao_Paulo' }); // '2024-06-16T02:59:59.999Z'
  * ```
  */
-export function endOf(unit, opt = {}) {
-    const newDate = _endOf(this.date, unit, opt);
+export function endOf(unit, opt) {
+    const options = opt || {};
+    if (!options.tz) {
+        options.tz = config.timezone;
+    }
+    const newDate = _endOf(this.date, unit, options);
     return chronal(newDate);
 }

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

@@ -4,13 +4,13 @@ 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'.
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to config.timezone.
  * @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'
+ * c.startOf('day'); // Uses config.timezone
+ * c.startOf('day', { tz: 'America/Sao_Paulo' }); // '2024-06-15T03:00:00.000Z'
  * ```
  */
 export declare function startOf(this: Chronal, unit: Parameters<typeof _startOf>[1], opt?: Parameters<typeof _startOf>[2]): Chronal;

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;;;;;;;;;;;;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"}
+{"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;AAGrD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,EACpC,GAAG,CAAC,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GACnC,OAAO,CAOT"}

package/esm/chainable/start-of.js

@@ -1,19 +1,24 @@
 import { startOf as _startOf } from "../lib/start-of.js";
 import { chronal } from "./chronal.js";
+import { config } from "../lib/config.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'.
+ * @param timezone - Optional IANA timezone string (e.g., 'America/Sao_Paulo'). Defaults to config.timezone.
  * @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'
+ * c.startOf('day'); // Uses config.timezone
+ * c.startOf('day', { tz: 'America/Sao_Paulo' }); // '2024-06-15T03:00:00.000Z'
  * ```
  */
-export function startOf(unit, opt = {}) {
-    const newDate = _startOf(this.date, unit, opt);
+export function startOf(unit, opt) {
+    const options = opt || {};
+    if (!options.tz) {
+        options.tz = config.timezone;
+    }
+    const newDate = _startOf(this.date, unit, options);
     return chronal(newDate);
 }

package/{script/chainable/sub-time.d.ts → esm/chainable/subtract.d.ts}

@@ -1,4 +1,4 @@
-import { subTime as _subTime } from "../lib/sub-time.js";
+import { subtract as _subtract } from "../lib/subtract.js";
 import { type Chronal } from "./chronal.js";
 /**
  * Subtracts specified time units from the date.
@@ -8,8 +8,8 @@ import { type Chronal } from "./chronal.js";
  * @example
  * ```typescript
  * const c = chronal('2024-03-31T12:00:00Z');
- * c.sub({ years: 1, months: 1 }); // '2023-02-28T12:00:00.000Z'
+ * c.subtract({ years: 1, months: 1 }); // '2023-02-28T12:00:00.000Z'
  * ```
  */
-export declare function sub(this: Chronal, opt: Parameters<typeof _subTime>[1]): Chronal;
-//# sourceMappingURL=sub-time.d.ts.map
+export declare function subtract(this: Chronal, opt: Parameters<typeof _subtract>[1]): Chronal;
+//# sourceMappingURL=subtract.d.ts.map

package/esm/chainable/subtract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtract.d.ts","sourceRoot":"","sources":["../../src/chainable/subtract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,KAAK,OAAO,EAAW,MAAM,cAAc,CAAC;AAErD;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,GACnC,OAAO,CAGT"}

package/esm/chainable/{sub-time.js → subtract.js}

@@ -1,4 +1,4 @@
-import { subTime as _subTime } from "../lib/sub-time.js";
+import { subtract as _subtract } from "../lib/subtract.js";
 import { chronal } from "./chronal.js";
 /**
  * Subtracts specified time units from the date.
@@ -8,10 +8,10 @@ import { chronal } from "./chronal.js";
  * @example
  * ```typescript
  * const c = chronal('2024-03-31T12:00:00Z');
- * c.sub({ years: 1, months: 1 }); // '2023-02-28T12:00:00.000Z'
+ * c.subtract({ years: 1, months: 1 }); // '2023-02-28T12:00:00.000Z'
  * ```
  */
-export function sub(opt) {
-    const newDate = _subTime(this.date, opt);
+export function subtract(opt) {
+    const newDate = _subtract(this.date, opt);
     return chronal(newDate);
 }

package/esm/lib/config.d.ts

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

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

@@ -1 +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"}
+{"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,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAQlD"}

package/esm/lib/config.js

@@ -4,7 +4,7 @@ export const config = {
     locale: DEFAULT_LOCALE,
     timezone: DEFAULT_TZ,
 };
-export function setConfig(c) {
+export function setChronalConfig(c) {
     if (c.locale) {
         config.locale = c.locale;
     }

package/{script/lib/date-range.d.ts → esm/lib/dates-until.d.ts}

@@ -21,15 +21,15 @@ type RangeStep = {
  * const start = new Date("2024-01-01");
  * const end = new Date("2024-01-05");
  *
- * dateRange(start, end); // Array of 5 dates (Jan 1-5)
- * dateRange(start, end, { days: 2 }); // Array of 3 dates (Jan 1, 3, 5)
+ * datesUntil(start, end); // Array of 5 dates (Jan 1-5)
+ * datesUntil(start, end, { days: 2 }); // Array of 3 dates (Jan 1, 3, 5)
  *
  * // Weekly range
  * const weekStart = new Date("2024-01-01");
  * const weekEnd = new Date("2024-01-31");
- * dateRange(weekStart, weekEnd, { weeks: 1 }); // Array of 5 dates (every Monday)
+ * datesUntil(weekStart, weekEnd, { weeks: 1 }); // Array of 5 dates (every Monday)
  * ```
  */
-export declare function dateRange(start: Date, end: Date, step?: RangeStep): Date[];
+export declare function datesUntil(start: Date, end: Date, step?: RangeStep): Date[];
 export {};
-//# sourceMappingURL=date-range.d.ts.map
+//# sourceMappingURL=dates-until.d.ts.map

package/esm/lib/dates-until.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates-until.d.ts","sourceRoot":"","sources":["../../src/lib/dates-until.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,EACT,IAAI,GAAE,SAAuB,GAC5B,IAAI,EAAE,CAuFR"}

package/esm/lib/{date-range.js → dates-until.js}

@@ -11,16 +11,16 @@
  * const start = new Date("2024-01-01");
  * const end = new Date("2024-01-05");
  *
- * dateRange(start, end); // Array of 5 dates (Jan 1-5)
- * dateRange(start, end, { days: 2 }); // Array of 3 dates (Jan 1, 3, 5)
+ * datesUntil(start, end); // Array of 5 dates (Jan 1-5)
+ * datesUntil(start, end, { days: 2 }); // Array of 3 dates (Jan 1, 3, 5)
  *
  * // Weekly range
  * const weekStart = new Date("2024-01-01");
  * const weekEnd = new Date("2024-01-31");
- * dateRange(weekStart, weekEnd, { weeks: 1 }); // Array of 5 dates (every Monday)
+ * datesUntil(weekStart, weekEnd, { weeks: 1 }); // Array of 5 dates (every Monday)
  * ```
  */
-export function dateRange(start, end, step = { days: 1 }) {
+export function datesUntil(start, end, step = { days: 1 }) {
     const result = [];
     const startTime = start.getTime();
     const endTime = end.getTime();

package/esm/lib/parse-date.d.ts

@@ -1,17 +1,24 @@
+type ParseDateOptions = {
+    format?: string;
+    tz?: string;
+};
 /**
  * Parses a date string into a Date object using an optional format pattern.
+ * If timezone is specified, the string is interpreted as local time in that timezone.
  *
  * @param dateString - The date string to parse
- * @param format - Optional format pattern (e.g., "YYYY-MM-DD", "DD/MM/YYYY")
+ * @param options - Optional format pattern and/or timezone
  * @returns A Date object
  * @throws Error if the date string is invalid or doesn't match the format
  *
  * @example
  * ```typescript
- * parseDate("2024-06-15"); // Uses native Date parser
- * parseDate("15/06/2024", "DD/MM/YYYY"); // Parses with custom format
- * parseDate("2024-06-15 14:30:00", "YYYY-MM-DD HH:mm:ss");
+ * parseDate("2024-06-15"); // Uses native Date parser in UTC
+ * parseDate("15/06/2024", { format: "DD/MM/YYYY" }); // Parses with custom format
+ * parseDate("2024-06-15 14:30:00", { format: "YYYY-MM-DD HH:mm:ss" });
+ * parseDate("2025-04-01", { tz: "America/Sao_Paulo" }); // Parse as São Paulo time
  * ```
  */
-export declare function parseDate(dateString: string, format?: string): Date;
+export declare function parseDate(dateString: string, options?: string | ParseDateOptions): Date;
+export {};
 //# sourceMappingURL=parse-date.d.ts.map

package/esm/lib/parse-date.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-date.d.ts","sourceRoot":"","sources":["../../src/lib/parse-date.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CA+EnE"}
+{"version":3,"file":"parse-date.d.ts","sourceRoot":"","sources":["../../src/lib/parse-date.ts"],"names":[],"mappings":"AAGA,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAClC,IAAI,CA0FN"}