@gobrand/tiempo 2.10.0 → 3.0.0

package/dist/differenceInMinutes.d.ts

@@ -1,5 +1,5 @@
-import { Temporal } from './shared/temporal';
-import type { DifferenceOptions } from './shared/differenceOptions';
+import { Temporal } from './shared/temporal.js';
+import type { DifferenceOptions } from './shared/differenceOptions.js';
 /**
  * Returns the number of minutes between two datetimes.
  * The result is positive if laterDate is after earlierDate, negative if before.

package/dist/differenceInMonths.d.ts

@@ -1,5 +1,5 @@
-import { Temporal } from './shared/temporal';
-import type { DifferenceOptions } from './shared/differenceOptions';
+import { Temporal } from './shared/temporal.js';
+import type { DifferenceOptions } from './shared/differenceOptions.js';
 /**
  * Returns the number of months between two datetimes.
  * The result is positive if laterDate is after earlierDate, negative if before.

package/dist/differenceInNanoseconds.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 /**
  * Returns the number of nanoseconds between two datetimes.
  * The result is positive if laterDate is after earlierDate, negative if before.

package/dist/differenceInQuarters.d.ts

@@ -1,37 +1,33 @@
 import type { Temporal } from "@js-temporal/polyfill";
-import type { DifferenceOptions } from "./shared/differenceOptions";
+import type { DifferenceOptions } from "./shared/differenceOptions.js";
 /**
- * Returns the number of quarters (3-month blocks) between two datetimes.
+ * Returns the number of quarters (3-month blocks) between two datetimes or dates.
  * The result is positive if laterDate is after earlierDate, negative if before.
  *
- * This function uses calendar-aware calculation, which means it properly handles
- * months with different numbers of days (28, 29, 30, or 31).
+ * Uses calendar-aware, elapsed-time calculation (a quarter is three months).
+ * Instant inputs are converted to UTC; ZonedDateTime inputs keep their timezone.
+ * PlainDate inputs are compared directly — no timezone needed.
  *
- * Instant inputs are converted to UTC for calendar calculations.
- * For ZonedDateTime inputs, their timezone is preserved.
- *
- * @param laterDate - The later datetime (Instant or ZonedDateTime)
- * @param earlierDate - The earlier datetime (Instant or ZonedDateTime)
+ * @param laterDate - The later Instant or ZonedDateTime
+ * @param earlierDate - The earlier Instant or ZonedDateTime
  * @param options - Optional { fractional } to return the precise value
- * @returns The number of quarters between the dates, truncated toward zero (pass { fractional: true } for the precise value)
+ * @returns The number of quarters, truncated toward zero (pass { fractional: true } for the precise value)
  *
  * @example
  * ```ts
  * const later = Temporal.Instant.from('2025-07-20T12:00:00Z');
  * const earlier = Temporal.Instant.from('2025-01-20T12:00:00Z');
- *
  * differenceInQuarters(later, earlier); // 2
  * ```
  *
  * @example
  * ```ts
- * // Pass { fractional: true } for partial-unit precision
- * const later = Temporal.Instant.from('2025-03-20T12:00:00Z');
- * const earlier = Temporal.Instant.from('2025-01-20T12:00:00Z');
- *
- * differenceInQuarters(later, earlier);                     // 0
- * differenceInQuarters(later, earlier, { fractional: true }); // ~0.67
+ * // PlainDate comparison needs no timezone
+ * const later = Temporal.PlainDate.from('2025-07-20');
+ * const earlier = Temporal.PlainDate.from('2025-01-20');
+ * differenceInQuarters(later, earlier); // 2
  * ```
  */
 export declare function differenceInQuarters(laterDate: Temporal.Instant | Temporal.ZonedDateTime, earlierDate: Temporal.Instant | Temporal.ZonedDateTime, options?: DifferenceOptions): number;
+export declare function differenceInQuarters(laterDate: Temporal.PlainDate, earlierDate: Temporal.PlainDate, options?: DifferenceOptions): number;
 //# sourceMappingURL=differenceInQuarters.d.ts.map

package/dist/differenceInQuarters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"differenceInQuarters.d.ts","sourceRoot":"","sources":["../src/differenceInQuarters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACpD,WAAW,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACtD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAIR"}
+{"version":3,"file":"differenceInQuarters.d.ts","sourceRoot":"","sources":["../src/differenceInQuarters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACpD,WAAW,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,EACtD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC;AACV,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,QAAQ,CAAC,SAAS,EAC7B,WAAW,EAAE,QAAQ,CAAC,SAAS,EAC/B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAAC"}

package/dist/differenceInQuarters.js

@@ -1,6 +1,6 @@
 import {
   differenceInQuarters
-} from "./chunk-VUKOSQWW.js";
+} from "./chunk-KPB5ENNM.js";
 import "./chunk-CIA46DWB.js";
 import "./chunk-NTMT5XGC.js";
 import "./chunk-R7ZCA6AQ.js";

package/dist/differenceInSeconds.d.ts

@@ -1,5 +1,5 @@
-import { Temporal } from './shared/temporal';
-import type { DifferenceOptions } from './shared/differenceOptions';
+import { Temporal } from './shared/temporal.js';
+import type { DifferenceOptions } from './shared/differenceOptions.js';
 /**
  * Returns the number of seconds between two datetimes.
  * The result is positive if laterDate is after earlierDate, negative if before.

package/dist/differenceInWeeks.d.ts

@@ -1,5 +1,5 @@
-import { Temporal } from './shared/temporal';
-import type { DifferenceOptions } from './shared/differenceOptions';
+import { Temporal } from './shared/temporal.js';
+import type { DifferenceOptions } from './shared/differenceOptions.js';
 /**
  * Returns the number of weeks between two datetimes.
  * The result is positive if laterDate is after earlierDate, negative if before.

package/dist/differenceInYears.d.ts

@@ -1,5 +1,5 @@
-import { Temporal } from './shared/temporal';
-import type { DifferenceOptions } from './shared/differenceOptions';
+import { Temporal } from './shared/temporal.js';
+import type { DifferenceOptions } from './shared/differenceOptions.js';
 /**
  * Returns the number of years between two datetimes.
  * The result is positive if laterDate is after earlierDate, negative if before.

package/dist/eachDayOfInterval.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 /**
  * Returns an array of ZonedDateTime objects for each calendar day within the interval.
  * Each element represents the start of day (midnight) in the timezone of the interval start.

package/dist/eachHourOfInterval.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 /**
  * Returns an array of ZonedDateTime objects for each hour within the interval.
  * Each element represents the start of the hour (minute/second/etc. set to 0).

package/dist/eachMinuteOfInterval.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 /**
  * Returns an array of ZonedDateTime objects for each minute within the interval.
  * Each element represents the start of the minute (seconds/etc. set to 0).

package/dist/eachMonthOfInterval.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 /**
  * Returns an array of ZonedDateTime objects for each month within the interval.
  * Each element represents the first moment of the month (day 1 at midnight).

package/dist/eachQuarterOfInterval.d.ts

@@ -1,47 +1,43 @@
-import { Temporal } from "./shared/temporal";
+import { Temporal } from "./shared/temporal.js";
 /**
- * Returns an array of ZonedDateTime objects for each quarter within the interval.
- * Each element represents the first moment of the quarter (day 1 of the quarter's
- * starting month at midnight). The interval is inclusive of both start and end quarters.
+ * Returns an array with the start of each quarter within the interval, inclusive
+ * of both the start and end quarters.
  *
- * Quarters: Q1 = Jan–Mar, Q2 = Apr–Jun, Q3 = Jul–Sep, Q4 = Oct–Dec.
+ * Quarters: Q1 = Jan–Mar, Q2 = Apr–Jun, Q3 = Jul–Sep, Q4 = Oct–Dec. Each element
+ * is the first moment of the quarter (1st day of the quarter's starting month at
+ * midnight) for Instant/ZonedDateTime inputs, or the first day as a PlainDate for
+ * PlainDate inputs.
  *
- * For Instant inputs, UTC is used as the timezone.
- * For ZonedDateTime inputs, the timezone of the start date is preserved.
+ * For Instant inputs, UTC is used. For ZonedDateTime inputs, the timezone of the
+ * start date is preserved. PlainDate inputs need no timezone and return PlainDate[].
  *
- * @param interval - The interval with start and end datetimes
- * @returns Array of ZonedDateTime at start of each quarter in the interval
+ * @param interval - The interval with start and end
+ * @returns Array of ZonedDateTime (or PlainDate) at the start of each quarter
  *
  * @example
  * ```ts
  * const start = Temporal.ZonedDateTime.from('2025-02-15T10:00:00Z[UTC]');
  * const end = Temporal.ZonedDateTime.from('2025-11-20T14:00:00Z[UTC]');
- *
- * const quarters = eachQuarterOfInterval({ start, end });
- * // [
- * //   2025-01-01T00:00:00Z[UTC], // Q1
- * //   2025-04-01T00:00:00Z[UTC], // Q2
- * //   2025-07-01T00:00:00Z[UTC], // Q3
- * //   2025-10-01T00:00:00Z[UTC]  // Q4
- * // ]
+ * eachQuarterOfInterval({ start, end });
+ * // [2025-01-01…, 2025-04-01…, 2025-07-01…, 2025-10-01…]
  * ```
  *
  * @example
  * ```ts
- * // Cross-year boundary
- * const start = Temporal.ZonedDateTime.from('2024-11-15T00:00:00Z[UTC]');
- * const end = Temporal.ZonedDateTime.from('2025-05-15T00:00:00Z[UTC]');
- *
- * const quarters = eachQuarterOfInterval({ start, end });
- * // [
- * //   2024-10-01T00:00:00Z[UTC], // Q4 2024
- * //   2025-01-01T00:00:00Z[UTC], // Q1 2025
- * //   2025-04-01T00:00:00Z[UTC]  // Q2 2025
- * // ]
+ * // PlainDate interval returns PlainDate quarter starts (no timezone)
+ * eachQuarterOfInterval({
+ *   start: Temporal.PlainDate.from('2025-02-15'),
+ *   end: Temporal.PlainDate.from('2025-08-20'),
+ * });
+ * // [2025-01-01, 2025-04-01, 2025-07-01]
  * ```
  */
 export declare function eachQuarterOfInterval(interval: {
     start: Temporal.Instant | Temporal.ZonedDateTime;
     end: Temporal.Instant | Temporal.ZonedDateTime;
 }): Temporal.ZonedDateTime[];
+export declare function eachQuarterOfInterval(interval: {
+    start: Temporal.PlainDate;
+    end: Temporal.PlainDate;
+}): Temporal.PlainDate[];
 //# sourceMappingURL=eachQuarterOfInterval.d.ts.map

package/dist/eachQuarterOfInterval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eachQuarterOfInterval.d.ts","sourceRoot":"","sources":["../src/eachQuarterOfInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;IACjD,GAAG,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;CAChD,GAAG,QAAQ,CAAC,aAAa,EAAE,CAkC3B"}
+{"version":3,"file":"eachQuarterOfInterval.d.ts","sourceRoot":"","sources":["../src/eachQuarterOfInterval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;IACjD,GAAG,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC;CAChD,GAAG,QAAQ,CAAC,aAAa,EAAE,CAAC;AAC7B,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC;IAC1B,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC;CACzB,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC"}

package/dist/eachQuarterOfInterval.js

@@ -1,6 +1,6 @@
 import {
   eachQuarterOfInterval
-} from "./chunk-6UBZ5YB3.js";
+} from "./chunk-YRCFMGBH.js";
 import "./chunk-XS2HUADA.js";
 import "./chunk-NTMT5XGC.js";
 import "./chunk-R7ZCA6AQ.js";

package/dist/eachWeekOfInterval.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 /**
  * Returns an array of ZonedDateTime objects for each week within the interval.
  * Each element represents the first moment of the week (Monday at midnight).

package/dist/eachYearOfInterval.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 /**
  * Returns an array of ZonedDateTime objects for each year within the interval.
  * Each element represents the first moment of the year (January 1st at midnight).

package/dist/endOfDay.d.ts

@@ -1,5 +1,5 @@
-import { Temporal } from './shared/temporal';
-import type { Timezone } from './types';
+import { Temporal } from './shared/temporal.js';
+import type { Timezone } from './types.js';
 /**
  * Returns a ZonedDateTime representing the last nanosecond of the day.
  *

package/dist/endOfDay.js

@@ -1,8 +1,8 @@
 import {
   endOfDay
-} from "./chunk-7HUJC5M6.js";
-import "./chunk-AVGNRINZ.js";
+} from "./chunk-S7L5KBI4.js";
 import "./chunk-ZOHYNJUD.js";
+import "./chunk-AVGNRINZ.js";
 import "./chunk-L5AMAEWX.js";
 import "./chunk-NTMT5XGC.js";
 import "./chunk-R7ZCA6AQ.js";

package/dist/endOfMonth.d.ts

@@ -1,7 +1,8 @@
-import { Temporal } from './shared/temporal';
-import type { Timezone } from './types';
+import { Temporal } from './shared/temporal.js';
+import type { Timezone } from './types.js';
 /**
- * Returns a ZonedDateTime representing the last moment of the month (last day at 23:59:59.999999999).
+ * Returns the last boundary of the month.
+ * PlainDate inputs stay in calendar space unless a timezone is provided.
  *
  * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
  * @returns ZonedDateTime at the last day of the month at 23:59:59.999999999
@@ -24,12 +25,21 @@ import type { Timezone } from './types';
  *
  * @example
  * ```ts
- * // From PlainDate (requires timezone)
+ * // From PlainDate (stays a date)
+ * const date = Temporal.PlainDate.from('2025-02-15');
+ * const end = endOfMonth(date);
+ * // 2025-02-28
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From PlainDate with a timezone (returns a ZonedDateTime)
  * const date = Temporal.PlainDate.from('2025-02-15');
  * const end = endOfMonth(date, 'America/New_York');
  * // 2025-02-28T23:59:59.999999999-05:00[America/New_York]
  * ```
  */
 export declare function endOfMonth(input: Temporal.Instant | Temporal.ZonedDateTime): Temporal.ZonedDateTime;
+export declare function endOfMonth(input: Temporal.PlainDate): Temporal.PlainDate;
 export declare function endOfMonth(input: Temporal.PlainDate, timezone: Timezone): Temporal.ZonedDateTime;
 //# sourceMappingURL=endOfMonth.d.ts.map

package/dist/endOfMonth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endOfMonth.d.ts","sourceRoot":"","sources":["../src/endOfMonth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,SAAS,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAAC"}
+{"version":3,"file":"endOfMonth.d.ts","sourceRoot":"","sources":["../src/endOfMonth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC1E,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,SAAS,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAAC"}

package/dist/endOfMonth.js

@@ -1,8 +1,8 @@
 import {
   endOfMonth
-} from "./chunk-VCWP3CZE.js";
-import "./chunk-AVGNRINZ.js";
+} from "./chunk-YNLBS34B.js";
 import "./chunk-ZOHYNJUD.js";
+import "./chunk-AVGNRINZ.js";
 import "./chunk-L5AMAEWX.js";
 import "./chunk-NTMT5XGC.js";
 import "./chunk-R7ZCA6AQ.js";

package/dist/endOfQuarter.d.ts

@@ -1,5 +1,5 @@
-import { Temporal } from "./shared/temporal";
-import type { Timezone } from "./types";
+import type { Temporal } from "@js-temporal/polyfill";
+import type { Timezone } from "./types.js";
 /**
  * Returns a ZonedDateTime representing the last moment of the quarter
  * (last day of the quarter's ending month at 23:59:59.999999999).
@@ -34,5 +34,6 @@ import type { Timezone } from "./types";
  * ```
  */
 export declare function endOfQuarter(input: Temporal.Instant | Temporal.ZonedDateTime): Temporal.ZonedDateTime;
+export declare function endOfQuarter(input: Temporal.PlainDate): Temporal.PlainDate;
 export declare function endOfQuarter(input: Temporal.PlainDate, timezone: Timezone): Temporal.ZonedDateTime;
 //# sourceMappingURL=endOfQuarter.d.ts.map

package/dist/endOfQuarter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endOfQuarter.d.ts","sourceRoot":"","sources":["../src/endOfQuarter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC"}
+{"version":3,"file":"endOfQuarter.d.ts","sourceRoot":"","sources":["../src/endOfQuarter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;AAC5E,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC"}

package/dist/endOfQuarter.js

@@ -1,9 +1,9 @@
 import {
   endOfQuarter
-} from "./chunk-SPK7C7RP.js";
+} from "./chunk-OSBVYUOQ.js";
 import "./chunk-XS2HUADA.js";
-import "./chunk-AVGNRINZ.js";
 import "./chunk-ZOHYNJUD.js";
+import "./chunk-AVGNRINZ.js";
 import "./chunk-L5AMAEWX.js";
 import "./chunk-NTMT5XGC.js";
 import "./chunk-R7ZCA6AQ.js";

package/dist/endOfWeek.d.ts

@@ -1,8 +1,9 @@
 import type { Temporal } from '@js-temporal/polyfill';
-import type { Timezone } from './types';
+import type { Timezone } from './types.js';
 /**
- * Returns a ZonedDateTime representing the last moment of the week (Sunday at 23:59:59.999999999).
+ * Returns the last boundary of the week (Sunday).
  * Uses ISO 8601 week definition: weeks end on Sunday.
+ * PlainDate inputs stay in calendar space unless a timezone is provided.
  *
  * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
  * @returns ZonedDateTime at Sunday 23:59:59.999999999
@@ -25,12 +26,21 @@ import type { Timezone } from './types';
  *
  * @example
  * ```ts
- * // From PlainDate (requires timezone)
+ * // From PlainDate (stays a date)
+ * const date = Temporal.PlainDate.from('2025-01-22'); // Wednesday
+ * const end = endOfWeek(date);
+ * // 2025-01-26 (next Sunday)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From PlainDate with a timezone (returns a ZonedDateTime)
  * const date = Temporal.PlainDate.from('2025-01-22'); // Wednesday
  * const end = endOfWeek(date, 'America/New_York');
  * // 2025-01-26T23:59:59.999999999-05:00[America/New_York] (next Sunday)
  * ```
  */
 export declare function endOfWeek(input: Temporal.Instant | Temporal.ZonedDateTime): Temporal.ZonedDateTime;
+export declare function endOfWeek(input: Temporal.PlainDate): Temporal.PlainDate;
 export declare function endOfWeek(input: Temporal.PlainDate, timezone: Timezone): Temporal.ZonedDateTime;
 //# sourceMappingURL=endOfWeek.d.ts.map

package/dist/endOfWeek.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endOfWeek.d.ts","sourceRoot":"","sources":["../src/endOfWeek.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,SAAS,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAAC"}
+{"version":3,"file":"endOfWeek.d.ts","sourceRoot":"","sources":["../src/endOfWeek.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAKxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;AACzE,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,SAAS,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAAC"}

package/dist/endOfWeek.js

@@ -1,6 +1,6 @@
 import {
   endOfWeek
-} from "./chunk-PVOGE6ME.js";
+} from "./chunk-MTDZG4HK.js";
 import "./chunk-AVGNRINZ.js";
 import "./chunk-L5AMAEWX.js";
 import "./chunk-NTMT5XGC.js";

package/dist/endOfYear.d.ts

@@ -1,7 +1,8 @@
-import { Temporal } from './shared/temporal';
-import type { Timezone } from './types';
+import { Temporal } from './shared/temporal.js';
+import type { Timezone } from './types.js';
 /**
- * Returns a ZonedDateTime representing the last moment of the year (last day at 23:59:59.999999999).
+ * Returns the last boundary of the year.
+ * PlainDate inputs stay in calendar space unless a timezone is provided.
  *
  * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
  * @returns ZonedDateTime at the last day of the year at 23:59:59.999999999
@@ -24,12 +25,21 @@ import type { Timezone } from './types';
  *
  * @example
  * ```ts
- * // From PlainDate (requires timezone)
+ * // From PlainDate (stays a date)
+ * const date = Temporal.PlainDate.from('2025-06-15');
+ * const end = endOfYear(date);
+ * // 2025-12-31
+ * ```
+ *
+ * @example
+ * ```ts
+ * // From PlainDate with a timezone (returns a ZonedDateTime)
  * const date = Temporal.PlainDate.from('2025-06-15');
  * const end = endOfYear(date, 'America/New_York');
  * // 2025-12-31T23:59:59.999999999-05:00[America/New_York]
  * ```
  */
 export declare function endOfYear(input: Temporal.Instant | Temporal.ZonedDateTime): Temporal.ZonedDateTime;
+export declare function endOfYear(input: Temporal.PlainDate): Temporal.PlainDate;
 export declare function endOfYear(input: Temporal.PlainDate, timezone: Timezone): Temporal.ZonedDateTime;
 //# sourceMappingURL=endOfYear.d.ts.map

package/dist/endOfYear.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endOfYear.d.ts","sourceRoot":"","sources":["../src/endOfYear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,SAAS,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAAC"}
+{"version":3,"file":"endOfYear.d.ts","sourceRoot":"","sources":["../src/endOfYear.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAC/C,QAAQ,CAAC,aAAa,CAAC;AAC1B,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;AACzE,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,CAAC,SAAS,EACzB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,CAAC,aAAa,CAAC"}

package/dist/endOfYear.js

@@ -1,8 +1,8 @@
 import {
   endOfYear
-} from "./chunk-KN45BU3W.js";
-import "./chunk-AVGNRINZ.js";
+} from "./chunk-7OEGJCW7.js";
 import "./chunk-ZOHYNJUD.js";
+import "./chunk-AVGNRINZ.js";
 import "./chunk-L5AMAEWX.js";
 import "./chunk-NTMT5XGC.js";
 import "./chunk-R7ZCA6AQ.js";

package/dist/format.d.ts

@@ -1,5 +1,5 @@
 import type { Temporal } from '@js-temporal/polyfill';
-import type { Timezone } from './types';
+import type { Timezone } from './types.js';
 export interface FormatOptions {
     locale?: string;
     timeZone?: Timezone;

package/dist/formatPlainDate.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from './shared/temporal';
+import { Temporal } from './shared/temporal.js';
 export interface FormatPlainDateOptions {
     locale?: string;
 }

package/dist/getQuarter.d.ts

@@ -1,38 +1,21 @@
 import type { Temporal } from "@js-temporal/polyfill";
-import type { Timezone } from "./types";
 /**
- * Returns the quarter (1-4) that a datetime falls in.
+ * Returns the quarter (1-4) that a datetime or date falls in.
  *
  * Quarters: Q1 = Jan–Mar, Q2 = Apr–Jun, Q3 = Jul–Sep, Q4 = Oct–Dec.
  *
- * Instant inputs are interpreted in UTC. For ZonedDateTime inputs, their
- * timezone is used. For PlainDate inputs, a timezone is required for a
- * consistent input contract (the quarter itself is timezone-independent).
+ * A quarter is intrinsic to the calendar date, so no timezone is ever needed.
+ * `Instant` inputs are interpreted in UTC; `ZonedDateTime` inputs use their own
+ * timezone; `PlainDate` inputs use their calendar month directly.
  *
- * @param input - A Temporal.Instant (UTC) or Temporal.ZonedDateTime
+ * @param input - A Temporal.Instant (UTC), Temporal.ZonedDateTime, or Temporal.PlainDate
  * @returns The quarter number: 1, 2, 3, or 4
  *
  * @example
  * ```ts
- * // From Instant (always UTC)
- * const instant = Temporal.Instant.from('2025-05-15T12:00:00Z');
- * getQuarter(instant); // 2
- * ```
- *
- * @example
- * ```ts
- * // From ZonedDateTime (uses its timezone)
- * const zoned = Temporal.ZonedDateTime.from('2025-11-15T15:30:00-05:00[America/New_York]');
- * getQuarter(zoned); // 4
- * ```
- *
- * @example
- * ```ts
- * // From PlainDate (requires timezone)
- * const date = Temporal.PlainDate.from('2025-02-15');
- * getQuarter(date, 'America/New_York'); // 1
+ * getQuarter(Temporal.Instant.from('2025-05-15T12:00:00Z'));   // 2
+ * getQuarter(Temporal.PlainDate.from('2025-11-15'));           // 4
  * ```
  */
-export declare function getQuarter(input: Temporal.Instant | Temporal.ZonedDateTime): 1 | 2 | 3 | 4;
-export declare function getQuarter(input: Temporal.PlainDate, timezone: Timezone): 1 | 2 | 3 | 4;
+export declare function getQuarter(input: Temporal.Instant | Temporal.ZonedDateTime | Temporal.PlainDate): 1 | 2 | 3 | 4;
 //# sourceMappingURL=getQuarter.d.ts.map

package/dist/getQuarter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getQuarter.d.ts","sourceRoot":"","sources":["../src/getQuarter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5F,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC"}
+{"version":3,"file":"getQuarter.d.ts","sourceRoot":"","sources":["../src/getQuarter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAKtD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,GACpE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAGf"}

package/dist/getQuarter.js

@@ -1,9 +1,7 @@
 import {
   getQuarter
-} from "./chunk-NOV3D7OM.js";
+} from "./chunk-GR7322AQ.js";
 import "./chunk-XS2HUADA.js";
-import "./chunk-ZOHYNJUD.js";
-import "./chunk-L5AMAEWX.js";
 import "./chunk-NTMT5XGC.js";
 import "./chunk-R7ZCA6AQ.js";
 export {