@gobrand/tiempo 3.0.0 → 3.1.2

package/README.md

@@ -6,16 +6,16 @@
 
 **Timezone conversions that don't suck.** Built on the [Temporal API](https://tc39.es/proposal-temporal/docs/).
 
-👉 **[Documentation](https://eng.gobrand.app/tiempo)**
+👉 **[Documentation](https://tiempo.gobrand.app)**
 
 ![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
@@ -40,7 +40,9 @@ npm install @gobrand/tiempo
 
 ## Docs
 
-**[eng.gobrand.app/tiempo](https://eng.gobrand.app/tiempo)** — Full API reference, examples, and guides.
+**[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
 

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-SMMVTXL4.js";
+import "./chunk-Z7I7YCKN.js";
+import "./chunk-JNAWZ4RN.js";
+import "./chunk-BSVOJYJ7.js";
+export {
+  addBusinessDays
+};
+//# sourceMappingURL=addBusinessDays.js.map

package/dist/addDays.d.ts

@@ -1,13 +1,15 @@
-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
@@ -33,5 +35,6 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // 2025-01-13T12:00:00Z[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-V36MCE25.js";
+import "./chunk-JNAWZ4RN.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.
  *

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-XTS6LZBP.js";
+import "./chunk-JNAWZ4RN.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.
  *

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-PU6PU2JM.js";
+import "./chunk-JNAWZ4RN.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.
  *

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-NYM3EW3M.js";
+import "./chunk-JNAWZ4RN.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.
  *

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-5ST6IOPN.js";
+import "./chunk-JNAWZ4RN.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addMinutes
 };

package/dist/addMonths.d.ts

@@ -1,13 +1,15 @@
-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
@@ -33,5 +35,6 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // 2025-02-28T12:00:00Z[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-WJZHUNF5.js";
+import "./chunk-JNAWZ4RN.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.
  *

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-ETO77GIW.js";
+import "./chunk-JNAWZ4RN.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,9 +6,9 @@ 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

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-YR26F7OA.js";
+import "./chunk-JNAWZ4RN.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.
  *

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-WY5I452J.js";
+import "./chunk-JNAWZ4RN.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addSeconds
 };

package/dist/addWeeks.d.ts

@@ -1,13 +1,15 @@
-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
@@ -33,5 +35,6 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // 2025-01-13T12:00:00Z[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-426MJGNT.js";
+import "./chunk-JNAWZ4RN.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addWeeks
 };

package/dist/addYears.d.ts

@@ -1,13 +1,15 @@
-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
@@ -33,5 +35,6 @@ import type { Temporal } from '@js-temporal/polyfill';
  * // 2025-02-28T12:00:00Z[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-FL33IWLY.js";
+import "./chunk-JNAWZ4RN.js";
+import "./chunk-BSVOJYJ7.js";
 export {
   addYears
 };

package/dist/{chunk-BEGD73DT.js → chunk-22IDWEHQ.js}

@@ -1,12 +1,22 @@
+import {
+  formatPlainDate
+} from "./chunk-TWXUGWYX.js";
 import {
   normalizeTemporalInput
-} from "./chunk-NTMT5XGC.js";
+} from "./chunk-JNAWZ4RN.js";
 import {
-  isInstant
-} from "./chunk-R7ZCA6AQ.js";
+  isInstant,
+  isPlainDate
+} from "./chunk-BSVOJYJ7.js";
 
 // src/format.ts
 function format(input, formatStr, options = {}) {
+  if (isPlainDate(input)) {
+    if (options.timeZone !== void 0) {
+      throw new TypeError("PlainDate formatting does not accept a timezone");
+    }
+    return formatPlainDate(input, formatStr, options);
+  }
   const { locale = "en-US", timeZone } = options;
   let zonedDateTime;
   if (timeZone) {
@@ -248,41 +258,17 @@ function formatToken(token, zonedDateTime, locale) {
     case "S":
       return Math.floor(zonedDateTime.millisecond / 100).toString();
     // Timezone
-    case "XXXXX": {
-      const offset = getTimezoneOffset(zonedDateTime);
-      return offset === "+00:00" ? "Z" : offset;
-    }
-    case "XXXX": {
-      const offset = getTimezoneOffset(zonedDateTime).replace(":", "");
-      return offset === "+0000" ? "Z" : offset;
-    }
-    case "XXX": {
-      const offset = getTimezoneOffset(zonedDateTime);
-      return offset === "+00:00" ? "Z" : offset;
-    }
-    case "XX": {
-      const offset = getTimezoneOffset(zonedDateTime).replace(":", "");
-      return offset === "+0000" ? "Z" : offset;
-    }
-    case "X": {
-      const offset = getTimezoneOffset(zonedDateTime);
-      if (offset === "+00:00") return "Z";
-      const [hours, minutes] = offset.split(":");
-      return minutes === "00" ? hours : `${hours}${minutes}`;
-    }
+    case "XXXXX":
+    case "XXXX":
+    case "XXX":
+    case "XX":
+    case "X":
     case "xxxxx":
-      return getTimezoneOffset(zonedDateTime);
     case "xxxx":
-      return getTimezoneOffset(zonedDateTime).replace(":", "");
     case "xxx":
-      return getTimezoneOffset(zonedDateTime);
     case "xx":
-      return getTimezoneOffset(zonedDateTime).replace(":", "");
-    case "x": {
-      const offset = getTimezoneOffset(zonedDateTime);
-      const [hours, minutes] = offset.split(":");
-      return minutes === "00" ? hours : `${hours}${minutes}`;
-    }
+    case "x":
+      return formatTimezoneOffset(zonedDateTime, token);
     case "zzzz":
       return formatPart(zonedDateTime, "timeZoneName", "long", locale);
     case "zzz":
@@ -299,9 +285,12 @@ function formatToken(token, zonedDateTime, locale) {
   }
 }
 function formatPart(zonedDateTime, part, style, locale) {
-  const options = {};
-  options[part] = style;
-  return zonedDateTime.toLocaleString(locale, options);
+  const options = {
+    [part]: style,
+    timeZone: zonedDateTime.timeZoneId,
+    calendar: zonedDateTime.calendarId === "iso8601" ? void 0 : zonedDateTime.calendarId
+  };
+  return new Intl.DateTimeFormat(locale, options).formatToParts(zonedDateTime.epochMilliseconds).find((value) => value.type === part)?.value ?? "";
 }
 function getOrdinalSuffix(num) {
   const j = num % 10;
@@ -311,21 +300,18 @@ function getOrdinalSuffix(num) {
   if (j === 3 && k !== 13) return "rd";
   return "th";
 }
-function getTimezoneOffset(zonedDateTime) {
-  const offsetNs = zonedDateTime.offsetNanoseconds;
-  const offsetMinutes = offsetNs / (60 * 1e9);
-  const sign = offsetMinutes >= 0 ? "+" : "-";
-  const absMinutes = Math.abs(offsetMinutes);
-  const hours = Math.floor(absMinutes / 60);
-  const minutes = absMinutes % 60;
-  return `${sign}${hours.toString().padStart(2, "0")}:${minutes.toString().padStart(2, "0")}`;
+function formatTimezoneOffset(zonedDateTime, token) {
+  if (token[0] === "X" && zonedDateTime.offsetNanoseconds === 0) return "Z";
+  const offset = token.length >= 4 ? zonedDateTime.offset : zonedDateTime.offset.slice(0, 6);
+  if (token.length === 1 && offset.endsWith(":00")) return offset.slice(0, 3);
+  return token.length === 3 || token.length === 5 ? offset : offset.replaceAll(":", "");
 }
 function getDayPeriod(zonedDateTime, locale) {
   const parts = new Intl.DateTimeFormat(locale, {
     hour: "numeric",
     hour12: true,
     timeZone: zonedDateTime.timeZoneId
-  }).formatToParts(new Date(zonedDateTime.epochMilliseconds));
+  }).formatToParts(zonedDateTime.epochMilliseconds);
   return parts.find((p) => p.type === "dayPeriod")?.value ?? "";
 }
 function isAsciiAmPm(period) {
@@ -339,4 +325,4 @@ function isAm(period) {
 export {
   format
 };
-//# sourceMappingURL=chunk-BEGD73DT.js.map
+//# sourceMappingURL=chunk-22IDWEHQ.js.map