@gobrand/tiempo 3.0.1 → 3.1.3

package/README.md

@@ -11,11 +11,11 @@
 ![tiempo banner](./tiempo_banner.png)
 
 
-- **Zero timezone bugs** - Real IANA timezone support, not UTC offset hacks
+- **IANA timezone support** - Named timezone rules and DST handling through Temporal
 - **DST-aware math** - `addDays(1)` means tomorrow, even across clock changes
 - **Nanosecond precision** - When milliseconds aren't enough
 - **Type-safe** - Full TypeScript, catches datetime errors at compile time
-- **Familiar API** - If you've used date-fns, you already know this
+- **Familiar API** - date-fns names and argument order ([mapping](https://tiempo.gobrand.app/docs/date-fns))
 
 ```typescript
 import { toZonedTime, addDays, format, toIso } from '@gobrand/tiempo';
@@ -26,10 +26,10 @@ const utc = "2025-03-09T07:00:00Z";
 // Convert to user's timezone, manipulate, format
 const userTime = toZonedTime(utc, "America/New_York");
 const tomorrow = addDays(userTime, 1);  // DST transition handled correctly
-const display = format(tomorrow, "EEEE 'at' h:mm a");  // "Monday at 2:00 AM"
+const display = format(tomorrow, "EEEE 'at' h:mm a");  // "Monday at 3:00 AM"
 
 // Send back to backend as ISO 8601 string
-const payload = toIso(tomorrow);  // "2025-03-10T06:00:00Z"
+const payload = toIso(tomorrow);  // "2025-03-10T07:00:00Z"
 ```
 
 ## Install
@@ -42,6 +42,8 @@ npm install @gobrand/tiempo
 
 **[tiempo.gobrand.app](https://tiempo.gobrand.app)** — Full API reference, examples, and guides.
 
+For coding agents: [llms.txt](https://tiempo.gobrand.app/llms.txt), or install the Agent Skill with `npx skills add go-brand/tiempo`.
+
 ## License
 
 MIT © [Ruben Costa](https://x.com/PonziChad) / [Go Brand](https://gobrand.app)

package/dist/addBusinessDays.d.ts

@@ -0,0 +1,28 @@
+import { type Temporal } from './shared/temporal.js';
+/**
+ * Adds business days (Monday–Friday), skipping weekends. Holidays are not
+ * considered.
+ *
+ * Starting on a weekend, the first business day counted is the next Monday
+ * (or the previous Friday for negative values). Adding 0 returns the input's
+ * date unchanged, even on a weekend.
+ *
+ * Instant inputs are converted to UTC. ZonedDateTime inputs keep their
+ * timezone and time of day. PlainDate inputs stay dates.
+ *
+ * @param input - An Instant (UTC), ZonedDateTime, or PlainDate
+ * @param days - Whole business days to add (negative to subtract)
+ * @returns PlainDate for a date input; otherwise ZonedDateTime
+ * @throws RangeError if days is not an integer
+ *
+ * @example
+ * ```ts
+ * const friday = Temporal.PlainDate.from('2025-01-24');
+ *
+ * addBusinessDays(friday, 1); // 2025-01-27 (Monday)
+ * addBusinessDays(friday, 5); // 2025-01-31 (Friday)
+ * ```
+ */
+export declare function addBusinessDays(input: Temporal.PlainDate, days: number): Temporal.PlainDate;
+export declare function addBusinessDays(input: Temporal.Instant | Temporal.ZonedDateTime, days: number): Temporal.ZonedDateTime;
+//# sourceMappingURL=addBusinessDays.d.ts.map

package/dist/addBusinessDays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"addBusinessDays.d.ts","sourceRoot":"","sources":["../src/addBusinessDays.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC7F,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,aAAa,CAAC"}

package/dist/addBusinessDays.js

@@ -0,0 +1,10 @@
+import {
+  addBusinessDays
+} from "./chunk-D3N7BT44.js";
+import "./chunk-K7CLBBBM.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
+export {
+  addBusinessDays
+};
+//# sourceMappingURL=addBusinessDays.js.map

package/dist/addDays.d.ts

@@ -1,20 +1,22 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import { type Temporal } from './shared/temporal.js';
 /**
- * Adds the specified number of days to a datetime.
+ * Adds the specified number of days to a datetime or date.
  *
  * Properly handles DST transitions and calendar edge cases through Temporal API.
  * Instant inputs are converted to UTC. For ZonedDateTime inputs, their timezone is preserved.
  *
- * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * PlainDate inputs stay in calendar space, preserving their calendar without a timezone.
+ *
+ * @param input - A Temporal.Instant (UTC), Temporal.ZonedDateTime, or Temporal.PlainDate
  * @param days - Number of days to add (can be negative to subtract)
- * @returns ZonedDateTime with days added, in the same timezone as input
+ * @returns PlainDate for a date input; otherwise ZonedDateTime with days added
  *
  * @example
  * ```ts
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addDays(instant, 5);
- * // 2025-01-25T12:00:00Z[UTC] (5 days later)
+ * // 2025-01-25T12:00:00+00:00[UTC] (5 days later)
  * ```
  *
  * @example
@@ -30,8 +32,9 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract days
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addDays(instant, -7);
- * // 2025-01-13T12:00:00Z[UTC] (7 days earlier)
+ * // 2025-01-13T12:00:00+00:00[UTC] (7 days earlier)
  * ```
  */
+export declare function addDays(input: Temporal.PlainDate, days: number): Temporal.PlainDate;
 export declare function addDays(input: Temporal.Instant | Temporal.ZonedDateTime, days: number): Temporal.ZonedDateTime;
 //# sourceMappingURL=addDays.d.ts.map

package/dist/addDays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addDays.d.ts","sourceRoot":"","sources":["../src/addDays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addDays.d.ts","sourceRoot":"","sources":["../src/addDays.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;AACrF,wBAAgB,OAAO,CACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,IAAI,EAAE,MAAM,GACX,QAAQ,CAAC,aAAa,CAAC"}

package/dist/addDays.js

@@ -1,8 +1,8 @@
 import {
   addDays
-} from "./chunk-G2U5WGRP.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-4KAIF44F.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addDays
 };

package/dist/addHours.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import type { Temporal } from './shared/temporal.js';
 /**
  * Adds the specified number of hours to a datetime.
  *
@@ -14,7 +14,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addHours(instant, 3);
- * // 2025-01-20T15:00:00Z[UTC] (3 hours later)
+ * // 2025-01-20T15:00:00+00:00[UTC] (3 hours later)
  * ```
  *
  * @example
@@ -30,7 +30,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract hours
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addHours(instant, -5);
- * // 2025-01-20T07:00:00Z[UTC] (5 hours earlier)
+ * // 2025-01-20T07:00:00+00:00[UTC] (5 hours earlier)
  * ```
  */
 export declare function addHours(input: Temporal.Instant | Temporal.ZonedDateTime, hours: number): Temporal.ZonedDateTime;

package/dist/addHours.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addHours.d.ts","sourceRoot":"","sources":["../src/addHours.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addHours.d.ts","sourceRoot":"","sources":["../src/addHours.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAGxB"}

package/dist/addHours.js

@@ -1,8 +1,8 @@
 import {
   addHours
-} from "./chunk-DHFBKOFZ.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-YKXRVQ4S.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addHours
 };

package/dist/addMicroseconds.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import type { Temporal } from './shared/temporal.js';
 /**
  * Adds the specified number of microseconds to a datetime.
  *
@@ -13,7 +13,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addMicroseconds(instant, 500);
- * // 2025-01-20T12:00:00.000500Z[UTC] (500 microseconds later)
+ * // 2025-01-20T12:00:00.000500+00:00[UTC] (500 microseconds later)
  * ```
  *
  * @example
@@ -29,7 +29,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract microseconds
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00.001Z');
  * const result = addMicroseconds(instant, -500);
- * // 2025-01-20T12:00:00.000500Z[UTC] (500 microseconds earlier)
+ * // 2025-01-20T12:00:00.000500+00:00[UTC] (500 microseconds earlier)
  * ```
  */
 export declare function addMicroseconds(input: Temporal.Instant | Temporal.ZonedDateTime, microseconds: number): Temporal.ZonedDateTime;

package/dist/addMicroseconds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addMicroseconds.d.ts","sourceRoot":"","sources":["../src/addMicroseconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,YAAY,EAAE,MAAM,GACnB,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addMicroseconds.d.ts","sourceRoot":"","sources":["../src/addMicroseconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,YAAY,EAAE,MAAM,GACnB,QAAQ,CAAC,aAAa,CAGxB"}

package/dist/addMicroseconds.js

@@ -1,8 +1,8 @@
 import {
   addMicroseconds
-} from "./chunk-IAXVREU5.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-TI6WBLCB.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addMicroseconds
 };

package/dist/addMilliseconds.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import type { Temporal } from './shared/temporal.js';
 /**
  * Adds the specified number of milliseconds to a datetime.
  *
@@ -13,7 +13,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addMilliseconds(instant, 500);
- * // 2025-01-20T12:00:00.500Z[UTC] (500 milliseconds later)
+ * // 2025-01-20T12:00:00.500+00:00[UTC] (500 milliseconds later)
  * ```
  *
  * @example
@@ -29,7 +29,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract milliseconds
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00.500Z');
  * const result = addMilliseconds(instant, -250);
- * // 2025-01-20T12:00:00.250Z[UTC] (250 milliseconds earlier)
+ * // 2025-01-20T12:00:00.250+00:00[UTC] (250 milliseconds earlier)
  * ```
  */
 export declare function addMilliseconds(input: Temporal.Instant | Temporal.ZonedDateTime, milliseconds: number): Temporal.ZonedDateTime;

package/dist/addMilliseconds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addMilliseconds.d.ts","sourceRoot":"","sources":["../src/addMilliseconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,YAAY,EAAE,MAAM,GACnB,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addMilliseconds.d.ts","sourceRoot":"","sources":["../src/addMilliseconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,YAAY,EAAE,MAAM,GACnB,QAAQ,CAAC,aAAa,CAGxB"}

package/dist/addMilliseconds.js

@@ -1,8 +1,8 @@
 import {
   addMilliseconds
-} from "./chunk-FCJO72WG.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-AUOZACFS.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addMilliseconds
 };

package/dist/addMinutes.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import type { Temporal } from './shared/temporal.js';
 /**
  * Adds the specified number of minutes to a datetime.
  *
@@ -13,7 +13,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addMinutes(instant, 30);
- * // 2025-01-20T12:30:00Z[UTC] (30 minutes later)
+ * // 2025-01-20T12:30:00+00:00[UTC] (30 minutes later)
  * ```
  *
  * @example
@@ -29,7 +29,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract minutes
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addMinutes(instant, -15);
- * // 2025-01-20T11:45:00Z[UTC] (15 minutes earlier)
+ * // 2025-01-20T11:45:00+00:00[UTC] (15 minutes earlier)
  * ```
  */
 export declare function addMinutes(input: Temporal.Instant | Temporal.ZonedDateTime, minutes: number): Temporal.ZonedDateTime;

package/dist/addMinutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addMinutes.d.ts","sourceRoot":"","sources":["../src/addMinutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addMinutes.d.ts","sourceRoot":"","sources":["../src/addMinutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,aAAa,CAGxB"}

package/dist/addMinutes.js

@@ -1,8 +1,8 @@
 import {
   addMinutes
-} from "./chunk-4PGGOVSG.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-GXSVYUCG.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addMinutes
 };

package/dist/addMonths.d.ts

@@ -1,20 +1,22 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import { type Temporal } from './shared/temporal.js';
 /**
- * Adds the specified number of months to a datetime.
+ * Adds the specified number of months to a datetime or date.
  *
  * Properly handles month-end dates and calendar edge cases through Temporal API.
  * Instant inputs are converted to UTC. For ZonedDateTime inputs, their timezone is preserved.
  *
- * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * PlainDate inputs stay in calendar space, preserving their calendar without a timezone.
+ *
+ * @param input - A Temporal.Instant (UTC), Temporal.ZonedDateTime, or Temporal.PlainDate
  * @param months - Number of months to add (can be negative to subtract)
- * @returns ZonedDateTime with months added, in the same timezone as input
+ * @returns PlainDate for a date input; otherwise ZonedDateTime with months added
  *
  * @example
  * ```ts
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addMonths(instant, 3);
- * // 2025-04-20T12:00:00Z[UTC] (3 months later)
+ * // 2025-04-20T12:00:00+00:00[UTC] (3 months later)
  * ```
  *
  * @example
@@ -30,8 +32,9 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Month-end handling
  * const instant = Temporal.Instant.from('2025-01-31T12:00:00Z');
  * const result = addMonths(instant, 1);
- * // 2025-02-28T12:00:00Z[UTC] (Jan 31 → Feb 28)
+ * // 2025-02-28T12:00:00+00:00[UTC] (Jan 31 → Feb 28)
  * ```
  */
+export declare function addMonths(input: Temporal.PlainDate, months: number): Temporal.PlainDate;
 export declare function addMonths(input: Temporal.Instant | Temporal.ZonedDateTime, months: number): Temporal.ZonedDateTime;
 //# sourceMappingURL=addMonths.d.ts.map

package/dist/addMonths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addMonths.d.ts","sourceRoot":"","sources":["../src/addMonths.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,MAAM,EAAE,MAAM,GACb,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addMonths.d.ts","sourceRoot":"","sources":["../src/addMonths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;AACzF,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,MAAM,EAAE,MAAM,GACb,QAAQ,CAAC,aAAa,CAAC"}

package/dist/addMonths.js

@@ -1,8 +1,8 @@
 import {
   addMonths
-} from "./chunk-VQPIPLHX.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-ZXKU4SKR.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addMonths
 };

package/dist/addNanoseconds.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import type { Temporal } from './shared/temporal.js';
 /**
  * Adds the specified number of nanoseconds to a datetime.
  *
@@ -13,7 +13,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addNanoseconds(instant, 500);
- * // 2025-01-20T12:00:00.000000500Z[UTC] (500 nanoseconds later)
+ * // 2025-01-20T12:00:00.000000500+00:00[UTC] (500 nanoseconds later)
  * ```
  *
  * @example
@@ -29,7 +29,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract nanoseconds
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00.000001Z');
  * const result = addNanoseconds(instant, -500);
- * // 2025-01-20T12:00:00.000000500Z[UTC] (500 nanoseconds earlier)
+ * // 2025-01-20T12:00:00.000000500+00:00[UTC] (500 nanoseconds earlier)
  * ```
  */
 export declare function addNanoseconds(input: Temporal.Instant | Temporal.ZonedDateTime, nanoseconds: number): Temporal.ZonedDateTime;

package/dist/addNanoseconds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addNanoseconds.d.ts","sourceRoot":"","sources":["../src/addNanoseconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,WAAW,EAAE,MAAM,GAClB,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addNanoseconds.d.ts","sourceRoot":"","sources":["../src/addNanoseconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,WAAW,EAAE,MAAM,GAClB,QAAQ,CAAC,aAAa,CAGxB"}

package/dist/addNanoseconds.js

@@ -1,8 +1,8 @@
 import {
   addNanoseconds
-} from "./chunk-WGLZHBJG.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-32AWWYBF.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addNanoseconds
 };

package/dist/addQuarters.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import { type Temporal } from "./shared/temporal.js";
 /**
  * Adds the specified number of quarters (3-month blocks) to a datetime or date.
  *
@@ -6,15 +6,15 @@ import type { Temporal } from "@js-temporal/polyfill";
  * Instant inputs are converted to UTC; ZonedDateTime inputs preserve their
  * timezone. PlainDate inputs stay in calendar space and return a PlainDate.
  *
- * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param input - A Temporal.Instant (UTC), Temporal.ZonedDateTime, or Temporal.PlainDate
  * @param quarters - Number of quarters to add (can be negative to subtract)
- * @returns A ZonedDateTime (for Instant/ZonedDateTime) with the quarters added
+ * @returns PlainDate for a date input; otherwise ZonedDateTime with the quarters added
  *
  * @example
  * ```ts
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * addQuarters(instant, 2);
- * // 2025-07-20T12:00:00Z[UTC] (6 months later)
+ * // 2025-07-20T12:00:00+00:00[UTC] (6 months later)
  * ```
  *
  * @example

package/dist/addQuarters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addQuarters.d.ts","sourceRoot":"","sources":["../src/addQuarters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC"}
+{"version":3,"file":"addQuarters.d.ts","sourceRoot":"","sources":["../src/addQuarters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,QAAQ,EAAE,MAAM,GACf,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC"}

package/dist/addQuarters.js

@@ -1,8 +1,8 @@
 import {
   addQuarters
-} from "./chunk-UQ2F3I2S.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-QDY2KMYX.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addQuarters
 };

package/dist/addSeconds.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import type { Temporal } from './shared/temporal.js';
 /**
  * Adds the specified number of seconds to a datetime.
  *
@@ -13,7 +13,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addSeconds(instant, 45);
- * // 2025-01-20T12:00:45Z[UTC] (45 seconds later)
+ * // 2025-01-20T12:00:45+00:00[UTC] (45 seconds later)
  * ```
  *
  * @example
@@ -29,7 +29,7 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract seconds
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addSeconds(instant, -30);
- * // 2025-01-20T11:59:30Z[UTC] (30 seconds earlier)
+ * // 2025-01-20T11:59:30+00:00[UTC] (30 seconds earlier)
  * ```
  */
 export declare function addSeconds(input: Temporal.Instant | Temporal.ZonedDateTime, seconds: number): Temporal.ZonedDateTime;

package/dist/addSeconds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addSeconds.d.ts","sourceRoot":"","sources":["../src/addSeconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addSeconds.d.ts","sourceRoot":"","sources":["../src/addSeconds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,OAAO,EAAE,MAAM,GACd,QAAQ,CAAC,aAAa,CAGxB"}

package/dist/addSeconds.js

@@ -1,8 +1,8 @@
 import {
   addSeconds
-} from "./chunk-LAITZAIG.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-7IKCDOCT.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addSeconds
 };

package/dist/addWeeks.d.ts

@@ -1,20 +1,22 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import { type Temporal } from './shared/temporal.js';
 /**
- * Adds the specified number of weeks to a datetime.
+ * Adds the specified number of weeks to a datetime or date.
  *
  * Properly handles DST transitions and calendar edge cases through Temporal API.
  * Instant inputs are converted to UTC. For ZonedDateTime inputs, their timezone is preserved.
  *
- * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * PlainDate inputs stay in calendar space, preserving their calendar without a timezone.
+ *
+ * @param input - A Temporal.Instant (UTC), Temporal.ZonedDateTime, or Temporal.PlainDate
  * @param weeks - Number of weeks to add (can be negative to subtract)
- * @returns ZonedDateTime with weeks added, in the same timezone as input
+ * @returns PlainDate for a date input; otherwise ZonedDateTime with weeks added
  *
  * @example
  * ```ts
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addWeeks(instant, 2);
- * // 2025-02-03T12:00:00Z[UTC] (2 weeks later)
+ * // 2025-02-03T12:00:00+00:00[UTC] (2 weeks later)
  * ```
  *
  * @example
@@ -30,8 +32,9 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Negative values subtract weeks
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addWeeks(instant, -1);
- * // 2025-01-13T12:00:00Z[UTC] (1 week earlier)
+ * // 2025-01-13T12:00:00+00:00[UTC] (1 week earlier)
  * ```
  */
+export declare function addWeeks(input: Temporal.PlainDate, weeks: number): Temporal.PlainDate;
 export declare function addWeeks(input: Temporal.Instant | Temporal.ZonedDateTime, weeks: number): Temporal.ZonedDateTime;
 //# sourceMappingURL=addWeeks.d.ts.map

package/dist/addWeeks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addWeeks.d.ts","sourceRoot":"","sources":["../src/addWeeks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addWeeks.d.ts","sourceRoot":"","sources":["../src/addWeeks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;AACvF,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAAC"}

package/dist/addWeeks.js

@@ -1,8 +1,8 @@
 import {
   addWeeks
-} from "./chunk-ZG4ROOWI.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-3X2U6I44.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addWeeks
 };

package/dist/addYears.d.ts

@@ -1,20 +1,22 @@
-import type { Temporal } from '@js-temporal/polyfill';
+import { type Temporal } from './shared/temporal.js';
 /**
- * Adds the specified number of years to a datetime.
+ * Adds the specified number of years to a datetime or date.
  *
  * Properly handles leap years and calendar edge cases through Temporal API.
  * Instant inputs are converted to UTC. For ZonedDateTime inputs, their timezone is preserved.
  *
- * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * PlainDate inputs stay in calendar space, preserving their calendar without a timezone.
+ *
+ * @param input - A Temporal.Instant (UTC), Temporal.ZonedDateTime, or Temporal.PlainDate
  * @param years - Number of years to add (can be negative to subtract)
- * @returns ZonedDateTime with years added, in the same timezone as input
+ * @returns PlainDate for a date input; otherwise ZonedDateTime with years added
  *
  * @example
  * ```ts
  * // From Instant (always UTC)
  * const instant = Temporal.Instant.from('2025-01-20T12:00:00Z');
  * const result = addYears(instant, 2);
- * // 2027-01-20T12:00:00Z[UTC] (2 years later)
+ * // 2027-01-20T12:00:00+00:00[UTC] (2 years later)
  * ```
  *
  * @example
@@ -30,8 +32,9 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // Leap year handling
  * const instant = Temporal.Instant.from('2024-02-29T12:00:00Z');
  * const result = addYears(instant, 1);
- * // 2025-02-28T12:00:00Z[UTC] (Feb 29 → Feb 28)
+ * // 2025-02-28T12:00:00+00:00[UTC] (Feb 29 → Feb 28)
  * ```
  */
+export declare function addYears(input: Temporal.PlainDate, years: number): Temporal.PlainDate;
 export declare function addYears(input: Temporal.Instant | Temporal.ZonedDateTime, years: number): Temporal.ZonedDateTime;
 //# sourceMappingURL=addYears.d.ts.map

package/dist/addYears.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addYears.d.ts","sourceRoot":"","sources":["../src/addYears.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAGxB"}
+{"version":3,"file":"addYears.d.ts","sourceRoot":"","sources":["../src/addYears.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAe,MAAM,mBAAmB,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;AACvF,wBAAgB,QAAQ,CACtB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EAChD,KAAK,EAAE,MAAM,GACZ,QAAQ,CAAC,aAAa,CAAC"}

package/dist/addYears.js

@@ -1,8 +1,8 @@
 import {
   addYears
-} from "./chunk-6YU6BQOZ.js";
-import "./chunk-NTMT5XGC.js";
-import "./chunk-R7ZCA6AQ.js";
+} from "./chunk-HRCTWTP3.js";
+import "./chunk-Q6QLOUXJ.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addYears
 };