@northguild/gmt 1.19.0 → 1.20.0

package/dist/calendar/hours/nextOpenAt.d.ts

@@ -23,9 +23,9 @@ import type { Disambiguation, OperatingSchedule } from "../../types/index.js";
  * @param optionsArg How far the search goes, and how a window edge on a clock change is resolved
  * @returns UTC instant string ending in "Z", or "" when none within the horizon or on invalid input
  *
- * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T13:00:00Z" — Saturday noon to Monday 09:00 local
- * @example nextOpenAt("2024-06-17T14:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T14:00:00Z" — already open
- * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { within: "P1D" }) // "" — Monday is past the horizon
+ * @example nextOpenAt("2024-06-15T15:00:00Z", { timeZone: "America/Sao_Paulo", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T12:00:00Z" — Saturday noon to Monday 09:00 local
+ * @example nextOpenAt("2024-06-17T13:00:00Z", { timeZone: "America/Sao_Paulo", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T13:00:00Z" — already open
+ * @example nextOpenAt("2024-06-15T15:00:00Z", { timeZone: "America/Sao_Paulo", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { within: "P1D" }) // "" — Monday is past the horizon
  * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "UTC", weekly: {} }) // "" — never opens
  * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { within: "-P1D" }) // ""
  */

package/dist/calendar/hours/nextOpenAt.js

@@ -24,9 +24,9 @@ import { firstOpenInstant, instantText, parseOperatingSchedule, parseScheduleDis
  * @param optionsArg How far the search goes, and how a window edge on a clock change is resolved
  * @returns UTC instant string ending in "Z", or "" when none within the horizon or on invalid input
  *
- * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T13:00:00Z" — Saturday noon to Monday 09:00 local
- * @example nextOpenAt("2024-06-17T14:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T14:00:00Z" — already open
- * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { within: "P1D" }) // "" — Monday is past the horizon
+ * @example nextOpenAt("2024-06-15T15:00:00Z", { timeZone: "America/Sao_Paulo", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T12:00:00Z" — Saturday noon to Monday 09:00 local
+ * @example nextOpenAt("2024-06-17T13:00:00Z", { timeZone: "America/Sao_Paulo", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "2024-06-17T13:00:00Z" — already open
+ * @example nextOpenAt("2024-06-15T15:00:00Z", { timeZone: "America/Sao_Paulo", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { within: "P1D" }) // "" — Monday is past the horizon
  * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "UTC", weekly: {} }) // "" — never opens
  * @example nextOpenAt("2024-06-15T16:00:00Z", { timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { within: "-P1D" }) // ""
  */

package/dist/calendar/hours/operatingIntervals.d.ts

@@ -29,8 +29,8 @@ import type { Disambiguation, Interval, OperatingSchedule } from "../../types/in
  * @param optionsArg How a window edge on a clock change is resolved
  * @returns sorted, merged `{ start, end }` records of the open instants, or [] on invalid input
  *
- * @example operatingIntervals({ timeZone: "America/New_York", weekly: { 4: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-06T00:00:00Z" }) // [{ start: "2024-07-05T13:00:00Z", end: "2024-07-05T21:00:00Z" }] — the holiday is closed
- * @example operatingIntervals({ timeZone: "America/New_York", weekly: { 4: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"], overrides: [{ date: "2024-07-04", windows: [{ from: "10:00", to: "12:00" }] }] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-05T00:00:00Z" }) // [{ start: "2024-07-04T14:00:00Z", end: "2024-07-04T16:00:00Z" }] — the override wins
+ * @example operatingIntervals({ timeZone: "Africa/Kigali", weekly: { 4: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-06T00:00:00Z" }) // [{ start: "2024-07-05T07:00:00Z", end: "2024-07-05T15:00:00Z" }] — the holiday is closed
+ * @example operatingIntervals({ timeZone: "Africa/Kigali", weekly: { 4: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"], overrides: [{ date: "2024-07-04", windows: [{ from: "10:00", to: "12:00" }] }] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-05T00:00:00Z" }) // [{ start: "2024-07-04T08:00:00Z", end: "2024-07-04T10:00:00Z" }] — the override wins
  * @example operatingIntervals({ timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { start: "2024-06-10T12:00:00Z", end: "2024-06-10T14:00:00Z" }) // [{ start: "2024-06-10T12:00:00Z", end: "2024-06-10T14:00:00Z" }] — clipped to the range
  * @example operatingIntervals({ timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] }, overrides: [{ date: "2024-06-10", windows: [] }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }) // [] — closed by override
  * @example operatingIntervals({ timeZone: "Invalid/Zone", weekly: {} }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }) // []

package/dist/calendar/hours/operatingIntervals.js

@@ -1,5 +1,5 @@
 import { parseIntervalNanoseconds } from "../../internal/index.js";
-import { parseOperatingSchedule, parseScheduleDisambiguation, scheduleRunsWithin, } from "../../internal/operatingSchedule.js";
+import { parseOperatingSchedule, parseScheduleDisambiguation, runText, scheduleRunsWithin, } from "../../internal/operatingSchedule.js";
 /**
  * Return the instants an `OperatingSchedule` is open inside `range`: its weekly windows with
  * holidays closed and overrides applied, resolved in the schedule's zone.
@@ -30,8 +30,8 @@ import { parseOperatingSchedule, parseScheduleDisambiguation, scheduleRunsWithin
  * @param optionsArg How a window edge on a clock change is resolved
  * @returns sorted, merged `{ start, end }` records of the open instants, or [] on invalid input
  *
- * @example operatingIntervals({ timeZone: "America/New_York", weekly: { 4: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-06T00:00:00Z" }) // [{ start: "2024-07-05T13:00:00Z", end: "2024-07-05T21:00:00Z" }] — the holiday is closed
- * @example operatingIntervals({ timeZone: "America/New_York", weekly: { 4: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"], overrides: [{ date: "2024-07-04", windows: [{ from: "10:00", to: "12:00" }] }] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-05T00:00:00Z" }) // [{ start: "2024-07-04T14:00:00Z", end: "2024-07-04T16:00:00Z" }] — the override wins
+ * @example operatingIntervals({ timeZone: "Africa/Kigali", weekly: { 4: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-06T00:00:00Z" }) // [{ start: "2024-07-05T07:00:00Z", end: "2024-07-05T15:00:00Z" }] — the holiday is closed
+ * @example operatingIntervals({ timeZone: "Africa/Kigali", weekly: { 4: [{ from: "09:00", to: "17:00" }] }, holidays: ["2024-07-04"], overrides: [{ date: "2024-07-04", windows: [{ from: "10:00", to: "12:00" }] }] }, { start: "2024-07-04T00:00:00Z", end: "2024-07-05T00:00:00Z" }) // [{ start: "2024-07-04T08:00:00Z", end: "2024-07-04T10:00:00Z" }] — the override wins
  * @example operatingIntervals({ timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }, { start: "2024-06-10T12:00:00Z", end: "2024-06-10T14:00:00Z" }) // [{ start: "2024-06-10T12:00:00Z", end: "2024-06-10T14:00:00Z" }] — clipped to the range
  * @example operatingIntervals({ timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] }, overrides: [{ date: "2024-06-10", windows: [] }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }) // [] — closed by override
  * @example operatingIntervals({ timeZone: "Invalid/Zone", weekly: {} }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }) // []
@@ -45,9 +45,7 @@ export function operatingIntervals(schedule, range, optionsArg) {
             return [];
         }
         const runs = scheduleRunsWithin(resolved, bounds, disambiguation);
-        return runs === null
-            ? []
-            : runs.map((run) => ({ start: run.startText, end: run.endText }));
+        return runs === null ? [] : runs.map(runText);
     }
     catch {
         // Never throws (Core Rule 3): a hostile

package/dist/calendar/hours/operatingTimeBetween.d.ts

@@ -8,7 +8,7 @@ import type { Disambiguation, OperatingSchedule } from "../../types/index.js";
  *   waited `PT2H` of open time.
  * - Hours are the largest unit (`PT40H`, not `P1DT16H`): an open-time total has no calendar.
  *   Exact to the nanosecond, and elapsed time, not wall-clock distance, so a 00:00–00:00 window
- *   on a New York fall-back date adds 25 hours.
+ *   on a London fall-back date adds 25 hours.
  * - Holidays and overrides apply as in `operatingIntervals`.
  * - `start === end` returns `"PT0S"`.
  * - Returns `""` on invalid input: an invalid instant or `OperatingSchedule`, `start` after
@@ -26,9 +26,9 @@ import type { Disambiguation, OperatingSchedule } from "../../types/index.js";
  * @param optionsArg How a window edge on a clock change is resolved
  * @returns ISO 8601 duration string of the open time, or "" on invalid input
  *
- * @example operatingTimeBetween("2024-06-14T20:00:00Z", "2024-06-17T14:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "PT2H" — Friday 16:00 to Monday 10:00 local
+ * @example operatingTimeBetween("2024-06-14T10:30:00Z", "2024-06-17T04:30:00Z", { timeZone: "Asia/Kolkata", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "PT2H" — Friday 16:00 to Monday 10:00 local
  * @example operatingTimeBetween("2024-06-15T00:00:00Z", "2024-06-16T00:00:00Z", { timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "PT0S" — a closed Saturday
- * @example operatingTimeBetween("2024-11-03T04:00:00Z", "2024-11-04T05:00:00Z", { timeZone: "America/New_York", weekly: { 7: [{ from: "00:00", to: "00:00" }] } }) // "PT25H" — the fall-back day
+ * @example operatingTimeBetween("2024-10-26T23:00:00Z", "2024-10-28T00:00:00Z", { timeZone: "Europe/London", weekly: { 7: [{ from: "00:00", to: "00:00" }] } }) // "PT25H" — the fall-back day
  * @example operatingTimeBetween("2024-06-10T09:00:00Z", "2024-06-10T09:30:00.5Z", { timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "PT30M0.5S"
  * @example operatingTimeBetween("2024-06-17T00:00:00Z", "2024-06-10T00:00:00Z", { timeZone: "UTC", weekly: {} }) // "" — start after end
  */

package/dist/calendar/hours/operatingTimeBetween.js

@@ -1,5 +1,5 @@
 import { formatHourDuration, parseIntervalNanoseconds } from "../../internal/index.js";
-import { parseOperatingSchedule, parseScheduleDisambiguation, scheduleRunsWithin, } from "../../internal/operatingSchedule.js";
+import { parseOperatingSchedule, parseScheduleDisambiguation, openTimeWithin, } from "../../internal/operatingSchedule.js";
 /**
  * Return how much open time `schedule` has between two instants, as an exact ISO duration.
  *
@@ -9,7 +9,7 @@ import { parseOperatingSchedule, parseScheduleDisambiguation, scheduleRunsWithin
  *   waited `PT2H` of open time.
  * - Hours are the largest unit (`PT40H`, not `P1DT16H`): an open-time total has no calendar.
  *   Exact to the nanosecond, and elapsed time, not wall-clock distance, so a 00:00–00:00 window
- *   on a New York fall-back date adds 25 hours.
+ *   on a London fall-back date adds 25 hours.
  * - Holidays and overrides apply as in `operatingIntervals`.
  * - `start === end` returns `"PT0S"`.
  * - Returns `""` on invalid input: an invalid instant or `OperatingSchedule`, `start` after
@@ -27,9 +27,9 @@ import { parseOperatingSchedule, parseScheduleDisambiguation, scheduleRunsWithin
  * @param optionsArg How a window edge on a clock change is resolved
  * @returns ISO 8601 duration string of the open time, or "" on invalid input
  *
- * @example operatingTimeBetween("2024-06-14T20:00:00Z", "2024-06-17T14:00:00Z", { timeZone: "America/New_York", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "PT2H" — Friday 16:00 to Monday 10:00 local
+ * @example operatingTimeBetween("2024-06-14T10:30:00Z", "2024-06-17T04:30:00Z", { timeZone: "Asia/Kolkata", weekly: { 1: [{ from: "09:00", to: "17:00" }], 5: [{ from: "09:00", to: "17:00" }] } }) // "PT2H" — Friday 16:00 to Monday 10:00 local
  * @example operatingTimeBetween("2024-06-15T00:00:00Z", "2024-06-16T00:00:00Z", { timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "PT0S" — a closed Saturday
- * @example operatingTimeBetween("2024-11-03T04:00:00Z", "2024-11-04T05:00:00Z", { timeZone: "America/New_York", weekly: { 7: [{ from: "00:00", to: "00:00" }] } }) // "PT25H" — the fall-back day
+ * @example operatingTimeBetween("2024-10-26T23:00:00Z", "2024-10-28T00:00:00Z", { timeZone: "Europe/London", weekly: { 7: [{ from: "00:00", to: "00:00" }] } }) // "PT25H" — the fall-back day
  * @example operatingTimeBetween("2024-06-10T09:00:00Z", "2024-06-10T09:30:00.5Z", { timeZone: "UTC", weekly: { 1: [{ from: "09:00", to: "17:00" }] } }) // "PT30M0.5S"
  * @example operatingTimeBetween("2024-06-17T00:00:00Z", "2024-06-10T00:00:00Z", { timeZone: "UTC", weekly: {} }) // "" — start after end
  */
@@ -41,10 +41,8 @@ export function operatingTimeBetween(start, end, schedule, optionsArg) {
         if (disambiguation === null || resolved === null || range === null) {
             return "";
         }
-        const runs = scheduleRunsWithin(resolved, range, disambiguation);
-        return runs === null
-            ? ""
-            : formatHourDuration(runs.reduce((total, run) => total + (run.end - run.start), 0n));
+        const open = openTimeWithin(resolved, range, disambiguation);
+        return open === null ? "" : formatHourDuration(open);
     }
     catch {
         // Never throws (Core Rule 3): a hostile

package/dist/calendar/hours/recurringWindows.d.ts

@@ -17,7 +17,7 @@ import type { Disambiguation, Interval, OperatingSchedule } from "../../types/in
  *   read `"earlier"`, its `to` read `"later"`) overlaps `range`. A rejected window elsewhere
  *   does not matter.
  * - Windows are elapsed time between their resolved edges, so the wall-clock length is not the
- *   real one on transition nights: in New York, 23:00–06:00 is 8 hours across the fall-back
+ *   real one on transition nights: in London, 23:00–06:00 is 8 hours across the fall-back
  *   night and 6 across the spring-forward one, and 00:00–00:00 is 25 and 23 hours.
  * - A window whose edges resolve to an empty or inverted span on a transition night — only a
  *   window shorter than the gap it straddles — is empty that day and left out.
@@ -44,11 +44,11 @@ import type { Disambiguation, Interval, OperatingSchedule } from "../../types/in
  * @param optionsArg How a window edge on a clock change is resolved
  * @returns sorted, merged `{ start, end }` records of the open instants, or [] on invalid input
  *
- * @example recurringWindows({ 1: [{ from: "09:00", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "America/New_York") // [{ start: "2024-06-10T13:00:00Z", end: "2024-06-10T21:00:00Z" }]
+ * @example recurringWindows({ 1: [{ from: "09:00", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "Africa/Johannesburg") // [{ start: "2024-06-10T07:00:00Z", end: "2024-06-10T15:00:00Z" }]
  * @example recurringWindows({ 5: [{ from: "23:00", to: "06:00" }] }, { start: "2024-06-14T00:00:00Z", end: "2024-06-16T00:00:00Z" }, "UTC") // [{ start: "2024-06-14T23:00:00Z", end: "2024-06-15T06:00:00Z" }] — Friday night into Saturday
- * @example recurringWindows({ 6: [{ from: "23:00", to: "06:00" }] }, { start: "2024-11-02T00:00:00Z", end: "2024-11-04T00:00:00Z" }, "America/New_York") // [{ start: "2024-11-03T03:00:00Z", end: "2024-11-03T11:00:00Z" }] — 8 hours across the fall-back night
- * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-03-10T00:00:00Z", end: "2024-03-11T00:00:00Z" }, "America/New_York") // [{ start: "2024-03-10T07:30:00Z", end: "2024-03-10T08:00:00Z" }] — 02:30 does not exist; "compatible" reads it as 03:30
- * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-03-10T00:00:00Z", end: "2024-03-11T00:00:00Z" }, "America/New_York", { disambiguation: "reject" }) // []
+ * @example recurringWindows({ 6: [{ from: "23:00", to: "06:00" }] }, { start: "2024-10-26T00:00:00Z", end: "2024-10-28T00:00:00Z" }, "Europe/London") // [{ start: "2024-10-26T22:00:00Z", end: "2024-10-27T06:00:00Z" }] — 8 hours across the fall-back night
+ * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-10-05T12:00:00Z", end: "2024-10-06T12:00:00Z" }, "Australia/Sydney") // [{ start: "2024-10-05T16:30:00Z", end: "2024-10-05T17:00:00Z" }] — 02:30 does not exist; "compatible" reads it as 03:30
+ * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-10-05T12:00:00Z", end: "2024-10-06T12:00:00Z" }, "Australia/Sydney", { disambiguation: "reject" }) // []
  * @example recurringWindows({ 1: [{ from: "00:00", to: "00:00" }], 2: [{ from: "00:00", to: "00:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-13T00:00:00Z" }, "UTC") // [{ start: "2024-06-10T00:00:00Z", end: "2024-06-12T00:00:00Z" }] — touching days merge
  * @example recurringWindows({ 8: [{ from: "09:00", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "UTC") // [] — not an ISO weekday
  * @example recurringWindows({ 1: [{ from: "9am", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "UTC") // [] — malformed window

package/dist/calendar/hours/recurringWindows.js

@@ -1,5 +1,5 @@
 import { parseIntervalNanoseconds, zoneFrame } from "../../internal/index.js";
-import { parseScheduleDisambiguation, parseWeeklyPattern, scheduleRunsWithin, } from "../../internal/operatingSchedule.js";
+import { parseScheduleDisambiguation, parseWeeklyPattern, runText, scheduleRunsWithin, } from "../../internal/operatingSchedule.js";
 /**
  * Return the instants a weekly pattern of local windows is open inside `range`, read in
  * `timeZone`: the primitive under operating hours, curfews and recurring crew windows.
@@ -18,7 +18,7 @@ import { parseScheduleDisambiguation, parseWeeklyPattern, scheduleRunsWithin, }
  *   read `"earlier"`, its `to` read `"later"`) overlaps `range`. A rejected window elsewhere
  *   does not matter.
  * - Windows are elapsed time between their resolved edges, so the wall-clock length is not the
- *   real one on transition nights: in New York, 23:00–06:00 is 8 hours across the fall-back
+ *   real one on transition nights: in London, 23:00–06:00 is 8 hours across the fall-back
  *   night and 6 across the spring-forward one, and 00:00–00:00 is 25 and 23 hours.
  * - A window whose edges resolve to an empty or inverted span on a transition night — only a
  *   window shorter than the gap it straddles — is empty that day and left out.
@@ -45,11 +45,11 @@ import { parseScheduleDisambiguation, parseWeeklyPattern, scheduleRunsWithin, }
  * @param optionsArg How a window edge on a clock change is resolved
  * @returns sorted, merged `{ start, end }` records of the open instants, or [] on invalid input
  *
- * @example recurringWindows({ 1: [{ from: "09:00", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "America/New_York") // [{ start: "2024-06-10T13:00:00Z", end: "2024-06-10T21:00:00Z" }]
+ * @example recurringWindows({ 1: [{ from: "09:00", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "Africa/Johannesburg") // [{ start: "2024-06-10T07:00:00Z", end: "2024-06-10T15:00:00Z" }]
  * @example recurringWindows({ 5: [{ from: "23:00", to: "06:00" }] }, { start: "2024-06-14T00:00:00Z", end: "2024-06-16T00:00:00Z" }, "UTC") // [{ start: "2024-06-14T23:00:00Z", end: "2024-06-15T06:00:00Z" }] — Friday night into Saturday
- * @example recurringWindows({ 6: [{ from: "23:00", to: "06:00" }] }, { start: "2024-11-02T00:00:00Z", end: "2024-11-04T00:00:00Z" }, "America/New_York") // [{ start: "2024-11-03T03:00:00Z", end: "2024-11-03T11:00:00Z" }] — 8 hours across the fall-back night
- * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-03-10T00:00:00Z", end: "2024-03-11T00:00:00Z" }, "America/New_York") // [{ start: "2024-03-10T07:30:00Z", end: "2024-03-10T08:00:00Z" }] — 02:30 does not exist; "compatible" reads it as 03:30
- * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-03-10T00:00:00Z", end: "2024-03-11T00:00:00Z" }, "America/New_York", { disambiguation: "reject" }) // []
+ * @example recurringWindows({ 6: [{ from: "23:00", to: "06:00" }] }, { start: "2024-10-26T00:00:00Z", end: "2024-10-28T00:00:00Z" }, "Europe/London") // [{ start: "2024-10-26T22:00:00Z", end: "2024-10-27T06:00:00Z" }] — 8 hours across the fall-back night
+ * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-10-05T12:00:00Z", end: "2024-10-06T12:00:00Z" }, "Australia/Sydney") // [{ start: "2024-10-05T16:30:00Z", end: "2024-10-05T17:00:00Z" }] — 02:30 does not exist; "compatible" reads it as 03:30
+ * @example recurringWindows({ 7: [{ from: "02:30", to: "04:00" }] }, { start: "2024-10-05T12:00:00Z", end: "2024-10-06T12:00:00Z" }, "Australia/Sydney", { disambiguation: "reject" }) // []
  * @example recurringWindows({ 1: [{ from: "00:00", to: "00:00" }], 2: [{ from: "00:00", to: "00:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-13T00:00:00Z" }, "UTC") // [{ start: "2024-06-10T00:00:00Z", end: "2024-06-12T00:00:00Z" }] — touching days merge
  * @example recurringWindows({ 8: [{ from: "09:00", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "UTC") // [] — not an ISO weekday
  * @example recurringWindows({ 1: [{ from: "9am", to: "17:00" }] }, { start: "2024-06-10T00:00:00Z", end: "2024-06-11T00:00:00Z" }, "UTC") // [] — malformed window
@@ -73,12 +73,11 @@ export function recurringWindows(weekly, range, timeZone, optionsArg) {
             timeZone,
             frame,
             weekly: weeklyWindows,
-            holidays: new Set(),
+            holidays: new Int32Array(0),
             overrides: new Map(),
+            specials: new Int32Array(0),
         }, bounds, disambiguation);
-        return runs === null
-            ? []
-            : runs.map((run) => ({ start: run.startText, end: run.endText }));
+        return runs === null ? [] : runs.map(runText);
     }
     catch {
         // Never throws (Core Rule 3): a hostile

package/dist/calendar/index.d.ts

@@ -1,4 +1,4 @@
-export * from "@js-temporal/polyfill";
+export { Intl, Temporal, toTemporalInstant } from "../internal/temporal.js";
 export * from "./business/index.js";
 export * from "./calculate/index.js";
 export * from "./hours/index.js";

package/dist/calendar/index.js

@@ -1,5 +1,5 @@
-// Re-export the Temporal polyfill (`Temporal`, `Intl`, `toTemporalInstant`) so every namespace subpath offers it
-export * from "@js-temporal/polyfill";
+// Re-export `Temporal`, `Intl` and `toTemporalInstant` from the internal seam so every namespace subpath offers them
+export { Intl, Temporal, toTemporalInstant } from "../internal/temporal.js";
 export * from "./business/index.js";
 export * from "./calculate/index.js";
 export * from "./hours/index.js";

package/dist/calendar/validate/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./isValidBusinessCalendar.js";
+export * from "./isValidFiscalCalendar.js";
+export * from "./isValidFiscalExtraWeek.js";
 export * from "./isValidFiscalPattern.js";
+export * from "./isValidFiscalYearLabel.js";
 export * from "./isValidRollConvention.js";
 export * from "./isValidZoneBucketUnit.js";

package/dist/calendar/validate/index.js

@@ -1,4 +1,7 @@
 export * from "./isValidBusinessCalendar.js";
+export * from "./isValidFiscalCalendar.js";
+export * from "./isValidFiscalExtraWeek.js";
 export * from "./isValidFiscalPattern.js";
+export * from "./isValidFiscalYearLabel.js";
 export * from "./isValidRollConvention.js";
 export * from "./isValidZoneBucketUnit.js";

package/dist/calendar/validate/isValidFiscalCalendar.d.ts

@@ -0,0 +1,23 @@
+import type { FiscalCalendar } from "../../types/index.js";
+/**
+ * Return true when `calendar` is a `FiscalCalendar` that `getFiscalPeriod` accepts.
+ *
+ * - `pattern` must be `"4-5-4"`, `"4-4-5"` or `"5-4-4"`.
+ * - `yearEndsOn` must be a plain ISO date. A datetime or a date that does not exist is not.
+ * - `extraWeek` must be `"firstPeriod"` or `"lastPeriod"`, and `yearLabel` must be
+ *   `"startYear"`, `"endYear"` or `"majorityYear"`. Both are required: there is no default.
+ * - Extra properties are ignored.
+ * - Returns `false` for non-objects, `null` and arrays.
+ * - `getFiscalPeriod` returns null for a calendar this rejects, the same sentinel it returns
+ *   for an invalid date. Check the calendar here to tell the two apart.
+ *
+ * @param calendar candidate value of any type
+ * @returns boolean indicating whether `getFiscalPeriod` accepts it
+ *
+ * @example isValidFiscalCalendar({ pattern: "4-5-4", yearEndsOn: "2026-01-31", extraWeek: "lastPeriod", yearLabel: "startYear" }) // true
+ * @example isValidFiscalCalendar({ pattern: "4-5-4", yearEndsOn: "2026-01-31" }) // false (the 1.19 shape: no extraWeek or yearLabel)
+ * @example isValidFiscalCalendar({ pattern: "4-5-4", yearEndsOn: "2026-02-30", extraWeek: "lastPeriod", yearLabel: "startYear" }) // false
+ * @example isValidFiscalCalendar("4-5-4") // false
+ * @example isValidFiscalCalendar([]) // false
+ */
+export declare function isValidFiscalCalendar(calendar: unknown): calendar is FiscalCalendar;

package/dist/calendar/validate/isValidFiscalCalendar.js

@@ -0,0 +1,44 @@
+import { isObject } from "../../internal/isObject.js";
+import { isValidDate } from "../../plain/validate/index.js";
+import { isValidFiscalExtraWeek } from "./isValidFiscalExtraWeek.js";
+import { isValidFiscalPattern } from "./isValidFiscalPattern.js";
+import { isValidFiscalYearLabel } from "./isValidFiscalYearLabel.js";
+/**
+ * Return true when `calendar` is a `FiscalCalendar` that `getFiscalPeriod` accepts.
+ *
+ * - `pattern` must be `"4-5-4"`, `"4-4-5"` or `"5-4-4"`.
+ * - `yearEndsOn` must be a plain ISO date. A datetime or a date that does not exist is not.
+ * - `extraWeek` must be `"firstPeriod"` or `"lastPeriod"`, and `yearLabel` must be
+ *   `"startYear"`, `"endYear"` or `"majorityYear"`. Both are required: there is no default.
+ * - Extra properties are ignored.
+ * - Returns `false` for non-objects, `null` and arrays.
+ * - `getFiscalPeriod` returns null for a calendar this rejects, the same sentinel it returns
+ *   for an invalid date. Check the calendar here to tell the two apart.
+ *
+ * @param calendar candidate value of any type
+ * @returns boolean indicating whether `getFiscalPeriod` accepts it
+ *
+ * @example isValidFiscalCalendar({ pattern: "4-5-4", yearEndsOn: "2026-01-31", extraWeek: "lastPeriod", yearLabel: "startYear" }) // true
+ * @example isValidFiscalCalendar({ pattern: "4-5-4", yearEndsOn: "2026-01-31" }) // false (the 1.19 shape: no extraWeek or yearLabel)
+ * @example isValidFiscalCalendar({ pattern: "4-5-4", yearEndsOn: "2026-02-30", extraWeek: "lastPeriod", yearLabel: "startYear" }) // false
+ * @example isValidFiscalCalendar("4-5-4") // false
+ * @example isValidFiscalCalendar([]) // false
+ */
+export function isValidFiscalCalendar(calendar) {
+    try {
+        if (!isObject(calendar) || Array.isArray(calendar)) {
+            return false;
+        }
+        const { pattern, yearEndsOn, extraWeek, yearLabel } = calendar;
+        return (isValidFiscalPattern(pattern) &&
+            typeof yearEndsOn === "string" &&
+            isValidDate(yearEndsOn) &&
+            isValidFiscalExtraWeek(extraWeek) &&
+            isValidFiscalYearLabel(yearLabel));
+    }
+    catch {
+        // Never throws (Core Rule 3): a hostile
+        // argument is invalid input, not an exception.
+        return false;
+    }
+}

package/dist/calendar/validate/isValidFiscalExtraWeek.d.ts

@@ -0,0 +1,19 @@
+import type { FiscalExtraWeek } from "../../types/index.js";
+/**
+ * Return true when `value` is a valid FiscalExtraWeek: the period a 53rd week is added to.
+ *
+ * - Valid values are `"firstPeriod"` and `"lastPeriod"`. The ONS retail trading periods (UK)
+ *   add a five-week January; the NRF 4-5-4 calendar (US) adds the week to the end.
+ * - Accepts any input type and returns false for non-string values.
+ * - Use it to narrow a value read from config, an env var or a form before building a
+ *   `FiscalCalendar`.
+ *
+ * @param value candidate value of any type
+ * @returns boolean indicating validity
+ *
+ * @example isValidFiscalExtraWeek("firstPeriod") // true
+ * @example isValidFiscalExtraWeek("lastPeriod") // true
+ * @example isValidFiscalExtraWeek("lastQuarter") // false
+ * @example isValidFiscalExtraWeek(12) // false
+ */
+export declare function isValidFiscalExtraWeek(value: unknown): value is FiscalExtraWeek;

package/dist/calendar/validate/isValidFiscalExtraWeek.js

@@ -0,0 +1,23 @@
+/**
+ * Return true when `value` is a valid FiscalExtraWeek: the period a 53rd week is added to.
+ *
+ * - Valid values are `"firstPeriod"` and `"lastPeriod"`. The ONS retail trading periods (UK)
+ *   add a five-week January; the NRF 4-5-4 calendar (US) adds the week to the end.
+ * - Accepts any input type and returns false for non-string values.
+ * - Use it to narrow a value read from config, an env var or a form before building a
+ *   `FiscalCalendar`.
+ *
+ * @param value candidate value of any type
+ * @returns boolean indicating validity
+ *
+ * @example isValidFiscalExtraWeek("firstPeriod") // true
+ * @example isValidFiscalExtraWeek("lastPeriod") // true
+ * @example isValidFiscalExtraWeek("lastQuarter") // false
+ * @example isValidFiscalExtraWeek(12) // false
+ */
+export function isValidFiscalExtraWeek(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    return value === "firstPeriod" || value === "lastPeriod";
+}

package/dist/calendar/validate/isValidFiscalPattern.d.ts

@@ -2,21 +2,21 @@ import type { FiscalPattern } from "../../types/index.js";
 /**
  * Return true when `pattern` is a valid FiscalPattern.
  *
- * - Valid patterns are: "4-5-4" (the NRF retail calendar), "4-4-5", "5-4-4".
+ * - Valid patterns are: "4-5-4", "4-4-5", "5-4-4". One published 4-5-4 example is the NRF
+ *   retail calendar (US).
  * - Accepts any input type and returns false for non-string values.
  * - Uses type assertion to narrow the type.
- * - `getFiscalPeriod` returns null for a pattern it does not recognise — the same sentinel it
- *   returns for a date it cannot place. Check the pattern here to tell a misconfigured
- *   calendar apart from an unusable date: a pattern read from config, an env var or a form is
- *   a bare string until something narrows it.
+ * - A pattern read from config, an env var or a form is a bare string until something narrows
+ *   it. Narrow it here; to check a whole calendar before `getFiscalPeriod`, whose null also
+ *   means an invalid date, use `isValidFiscalCalendar`.
  *
  * @param pattern candidate value of any type
  * @returns boolean indicating validity
  *
- * @example isValidFiscalPattern("4-5-4") // true (the NRF retail calendar)
+ * @example isValidFiscalPattern("4-5-4") // true
  * @example isValidFiscalPattern("4-4-5") // true
  * @example isValidFiscalPattern("5-4-4") // true
- * @example isValidFiscalPattern("4-5-5") // false (the shape a 53-week year's last quarter takes, not a pattern)
+ * @example isValidFiscalPattern("4-5-5") // false (a 53-week year's last quarter under `"lastPeriod"`, not a pattern)
  * @example isValidFiscalPattern("454") // false
  * @example isValidFiscalPattern("invalid") // false
  * @example isValidFiscalPattern(454) // false

package/dist/calendar/validate/isValidFiscalPattern.js

@@ -1,21 +1,21 @@
 /**
  * Return true when `pattern` is a valid FiscalPattern.
  *
- * - Valid patterns are: "4-5-4" (the NRF retail calendar), "4-4-5", "5-4-4".
+ * - Valid patterns are: "4-5-4", "4-4-5", "5-4-4". One published 4-5-4 example is the NRF
+ *   retail calendar (US).
  * - Accepts any input type and returns false for non-string values.
  * - Uses type assertion to narrow the type.
- * - `getFiscalPeriod` returns null for a pattern it does not recognise — the same sentinel it
- *   returns for a date it cannot place. Check the pattern here to tell a misconfigured
- *   calendar apart from an unusable date: a pattern read from config, an env var or a form is
- *   a bare string until something narrows it.
+ * - A pattern read from config, an env var or a form is a bare string until something narrows
+ *   it. Narrow it here; to check a whole calendar before `getFiscalPeriod`, whose null also
+ *   means an invalid date, use `isValidFiscalCalendar`.
  *
  * @param pattern candidate value of any type
  * @returns boolean indicating validity
  *
- * @example isValidFiscalPattern("4-5-4") // true (the NRF retail calendar)
+ * @example isValidFiscalPattern("4-5-4") // true
  * @example isValidFiscalPattern("4-4-5") // true
  * @example isValidFiscalPattern("5-4-4") // true
- * @example isValidFiscalPattern("4-5-5") // false (the shape a 53-week year's last quarter takes, not a pattern)
+ * @example isValidFiscalPattern("4-5-5") // false (a 53-week year's last quarter under `"lastPeriod"`, not a pattern)
  * @example isValidFiscalPattern("454") // false
  * @example isValidFiscalPattern("invalid") // false
  * @example isValidFiscalPattern(454) // false

package/dist/calendar/validate/isValidFiscalYearLabel.d.ts

@@ -0,0 +1,20 @@
+import type { FiscalYearLabel } from "../../types/index.js";
+/**
+ * Return true when `value` is a valid FiscalYearLabel: the rule that picks the calendar year
+ * naming a fiscal year.
+ *
+ * - Valid values are `"startYear"`, `"endYear"` and `"majorityYear"`.
+ * - Accepts any input type and returns false for non-string values.
+ * - Use it to narrow a value read from config, an env var or a form before building a
+ *   `FiscalCalendar` or passing `getQuarter` its options.
+ *
+ * @param value candidate value of any type
+ * @returns boolean indicating validity
+ *
+ * @example isValidFiscalYearLabel("startYear") // true
+ * @example isValidFiscalYearLabel("endYear") // true
+ * @example isValidFiscalYearLabel("majorityYear") // true
+ * @example isValidFiscalYearLabel("fiscalYear") // false
+ * @example isValidFiscalYearLabel(null) // false
+ */
+export declare function isValidFiscalYearLabel(value: unknown): value is FiscalYearLabel;

package/dist/calendar/validate/isValidFiscalYearLabel.js

@@ -0,0 +1,24 @@
+/**
+ * Return true when `value` is a valid FiscalYearLabel: the rule that picks the calendar year
+ * naming a fiscal year.
+ *
+ * - Valid values are `"startYear"`, `"endYear"` and `"majorityYear"`.
+ * - Accepts any input type and returns false for non-string values.
+ * - Use it to narrow a value read from config, an env var or a form before building a
+ *   `FiscalCalendar` or passing `getQuarter` its options.
+ *
+ * @param value candidate value of any type
+ * @returns boolean indicating validity
+ *
+ * @example isValidFiscalYearLabel("startYear") // true
+ * @example isValidFiscalYearLabel("endYear") // true
+ * @example isValidFiscalYearLabel("majorityYear") // true
+ * @example isValidFiscalYearLabel("fiscalYear") // false
+ * @example isValidFiscalYearLabel(null) // false
+ */
+export function isValidFiscalYearLabel(value) {
+    if (typeof value !== "string") {
+        return false;
+    }
+    return (value === "startYear" || value === "endYear" || value === "majorityYear");
+}

package/dist/calendar/validate/isValidRollConvention.js

@@ -1,11 +1,4 @@
-const ROLL_CONVENTIONS = [
-    "following",
-    "modifiedFollowing",
-    "preceding",
-    "modifiedPreceding",
-    "endOfMonth",
-    "none",
-];
+import { isRollConventionName } from "../../internal/inputChecks.js";
 /**
  * Return true when `convention` is a `RollConvention` that `rollDate` implements.
  *
@@ -33,6 +26,5 @@ const ROLL_CONVENTIONS = [
  * @example isValidRollConvention(null) // false
  */
 export function isValidRollConvention(convention) {
-    return (typeof convention === "string" &&
-        ROLL_CONVENTIONS.includes(convention));
+    return isRollConventionName(convention);
 }

package/dist/calendar/validate/isValidZoneBucketUnit.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 import type { ZoneBucketUnit } from "../../types/index.js";
 /**
  * Return true when `unit` is a valid ZoneBucketUnit.

package/dist/duration/calculate/absDuration.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDuration } from "../validate/isValidDuration.js";
 /**
  * Return the absolute value of an ISO 8601 duration string.

package/dist/duration/calculate/addDuration.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDuration } from "../validate/isValidDuration.js";
 /**
  * Combine two ISO 8601 duration strings by addition.

package/dist/duration/calculate/durationFromUnits.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { readDurationUnits } from "../../internal/index.js";
 import { isValidDateTimeDurationUnit } from "../../plain/validate/index.js";
 /**

package/dist/duration/calculate/getDurationSign.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDuration } from "../validate/isValidDuration.js";
 /**
  * Report whether an ISO 8601 duration is negative, zero-length, or positive.

package/dist/duration/calculate/getDurationUnit.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { DateTimeDurationUnit } from "../../types/index.js";
 /**
  * Read a single component out of an ISO 8601 duration string.

package/dist/duration/calculate/getDurationUnit.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTimeDurationUnit } from "../../plain/validate/index.js";
 import { isValidDuration } from "../validate/isValidDuration.js";
 import { resolveDurationUnit } from "../../internal/resolveDurationUnit.js";

package/dist/duration/calculate/negateDuration.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDuration } from "../validate/isValidDuration.js";
 /**
  * Flip the sign of an ISO 8601 duration string.

package/dist/duration/calculate/subtractDuration.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDuration } from "../validate/isValidDuration.js";
 /**
  * Combine two ISO 8601 duration strings by subtraction.