@northguild/gmt 1.19.0 → 1.20.0

package/dist/internal/operatingSchedule.d.ts

@@ -1,10 +1,15 @@
 import type { Disambiguation } from "../types/index.js";
 import { type IntervalNanoseconds } from "./intervalNanoseconds.js";
 import { type ZoneFrame } from "./zoneFrame.js";
-/** A `LocalWindow` validated once: canonical PlainTime strings, and whether it wraps midnight. */
+/**
+ * A `LocalWindow` validated once: canonical PlainTime strings, the same times in nanoseconds
+ * since local midnight, and whether it wraps midnight.
+ */
 export type ResolvedWindow = {
     from: string;
     to: string;
+    fromNs: bigint;
+    toNs: bigint;
     wraps: boolean;
 };
 /** An `OperatingSchedule` reduced to the lookups the day walk needs. */
@@ -15,20 +20,13 @@ export type ResolvedSchedule = {
     frame: ZoneFrame;
     /** Windows by ISO weekday; index 0 is unused. */
     weekly: readonly (readonly ResolvedWindow[])[];
-    holidays: ReadonlySet<string>;
-    overrides: ReadonlyMap<string, readonly ResolvedWindow[]>;
+    /** Holiday epoch days, sorted ascending; never mutated. */
+    holidays: Readonly<Int32Array>;
+    /** Override windows by epoch day (days since 1970-01-01). */
+    overrides: ReadonlyMap<number, readonly ResolvedWindow[]>;
+    /** Epoch days with a holiday or an override, sorted ascending, no repeats. */
+    specials: Readonly<Int32Array>;
 };
-/**
- * Local dates a range may span, counted from the date its start falls on: about 27 years, the
- * same bound `bucketRange` puts on a day walk. A walk that runs out answers with the sentinel,
- * never a partial list.
- */
-export declare const MAX_SCHEDULE_DAYS = 10000;
-/**
- * The search horizon of `nextOpenAt`, `nextCloseAt` and `addOperatingTime` when the caller
- * gives no `within`: one calendar year in the schedule's zone.
- */
-export declare const DEFAULT_OPERATING_HORIZON = "P1Y";
 /**
  * Parse `OperatingSchedule['weekly']`: an object keyed by ISO weekday `"1"`–`"7"`, each holding an
  * array of `LocalWindow`s (or `undefined`, meaning closed). Each weekday is read with an ordinary
@@ -80,25 +78,13 @@ export type ScheduleWalk = {
     unresolvedStart: bigint | undefined;
 };
 /**
- * Walk the schedule's local dates from a little before `fromNs`, handing the visitor each open
- * run as soon as no later window can extend it.
- *
- * - Dates come from the day buckets `floorToZone` and `bucketRange` use, so a deleted date
- *   (`Pacific/Apia`, 2011-12-30) is never visited, and a date the clock re-enters after a
- *   fall-back (`America/Goose_Bay`, 2010-11-06) is visited once.
- * - A window can start as early as the previous date's first instant (see `resolveDateWindows`),
- *   so the walk settles one date behind: once a date is resolved, the first instant of the date
- *   resolved before it is the `bound` no later window starts before.
- * - A walk from the start of Temporal's range also resolves the date before its first, whose
- *   wrapping windows are still open when the range begins (`resolveWindowsBefore`).
- * - When the visitor stops the walk from `day`, or the last representable day is reached, the
- *   runs still pending are handed over too.
- * - Returns `null` when a day bucket could not be found, or the walk would resolve a date
- *   `MAX_SCHEDULE_DAYS + 2` after the one `fromNs` falls on. Neither use reaches that: a range
- *   is refused up front past `MAX_SCHEDULE_DAYS` dates, and a search's horizon ends with the
- *   `MAX_SCHEDULE_DAYS`th date, so its walk stops by the horizon one date later.
+ * The text of a run's edges: the range's own where the run was clipped to it, else the instant's
+ * UTC string, written here and only for the runs a caller returns.
  */
-export declare function walkSchedule(schedule: ResolvedSchedule, fromNs: bigint, disambiguation: Disambiguation, visitor: ScheduleVisitor): ScheduleWalk | null;
+export declare function runText(run: IntervalNanoseconds): {
+    start: string;
+    end: string;
+};
 /**
  * The schedule's open runs clipped to `[startNs, endNs)`, in the range's own strings where a run
  * is clipped. `null` when the walk fails (see `walkSchedule`), or when a window rejected under
@@ -136,3 +122,13 @@ export declare function instantAfterOpenTime(schedule: ResolvedSchedule, fromNs:
 export declare function parseOpenTimeAmount(value: unknown): bigint | null;
 /** Epoch nanoseconds as a UTC instant string ending in `Z`. */
 export declare function instantText(nanoseconds: bigint): string;
+/**
+ * Open time in `[range.start, range.end)`, in nanoseconds; `null` exactly when
+ * `scheduleRunsWithin` would be.
+ *
+ * Open time is additive over disjoint half-open pieces. Whole day buckets inside a stretch of
+ * constant offset are summed in closed form (whole weeks of the weekly pattern, plus a correction
+ * for each holiday and override); the pieces between them, the range's ends and the dates near an
+ * offset change, are walked.
+ */
+export declare function openTimeWithin(schedule: ResolvedSchedule, range: IntervalNanoseconds, disambiguation: Disambiguation): bigint | null;