@northguild/gmt 1.19.0 → 1.20.0

package/dist/transport/compare/isPastCutoff.d.ts

@@ -26,7 +26,7 @@
  * @example isPastCutoff("2024-06-12T16:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // true
  * @example isPastCutoff("2024-06-12T14:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // false
  * @example isPastCutoff("2024-06-12T15:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // true (at the cut-off, the window has closed)
- * @example isPastCutoff("2024-11-03T01:30:00-05:00[America/New_York]", "2024-11-03T01:30:00-04:00[America/New_York]") // true (the second 01:30 is an hour after the first)
+ * @example isPastCutoff("2024-04-07T02:30:00+10:00[Australia/Sydney]", "2024-04-07T02:30:00+11:00[Australia/Sydney]") // true (the second 02:30 is an hour after the first)
  * @example isPastCutoff("2024-06-12T16:00:00", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // false (a zoneless now is not a moment)
  * @example isPastCutoff("2024-06-12T16:00:00Z", "") // false
  */

package/dist/transport/compare/isPastCutoff.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { instantFrom } from "../../internal/index.js";
 import { isValidInstant } from "../../precision/validate/isValidInstant.js";
 /**
@@ -29,7 +29,7 @@ import { isValidInstant } from "../../precision/validate/isValidInstant.js";
  * @example isPastCutoff("2024-06-12T16:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // true
  * @example isPastCutoff("2024-06-12T14:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // false
  * @example isPastCutoff("2024-06-12T15:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // true (at the cut-off, the window has closed)
- * @example isPastCutoff("2024-11-03T01:30:00-05:00[America/New_York]", "2024-11-03T01:30:00-04:00[America/New_York]") // true (the second 01:30 is an hour after the first)
+ * @example isPastCutoff("2024-04-07T02:30:00+10:00[Australia/Sydney]", "2024-04-07T02:30:00+11:00[Australia/Sydney]") // true (the second 02:30 is an hour after the first)
  * @example isPastCutoff("2024-06-12T16:00:00", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // false (a zoneless now is not a moment)
  * @example isPastCutoff("2024-06-12T16:00:00Z", "") // false
  */

package/dist/transport/compare/scheduleDeviation.d.ts

@@ -30,7 +30,7 @@
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-15T09:55:00Z") // "-PT5M" (five minutes early)
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-15T10:00:00Z") // "PT0S"
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-17T11:30:00Z") // "PT49H30M" (hours, never days)
- * @example scheduleDeviation("2024-11-03T01:30:00-04:00[America/New_York]", "2024-11-03T01:30:00-05:00[America/New_York]") // "PT1H" (the same wall time, one hour later across the fall-back)
+ * @example scheduleDeviation("2024-04-07T02:30:00+11:00[Australia/Sydney]", "2024-04-07T02:30:00+10:00[Australia/Sydney]") // "PT1H" (the same wall time, one hour later across the fall-back)
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-15T12:14:00+02:00[Europe/Amsterdam]") // "PT14M" (the zone it is written in does not matter)
  * @example scheduleDeviation("2024-06-15T10:00:00", "2024-06-15T10:14:00Z") // "" (a zoneless plan is not a moment)
  */

package/dist/transport/compare/scheduleDeviation.js

@@ -32,7 +32,7 @@ import { isValidInstant } from "../../precision/validate/isValidInstant.js";
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-15T09:55:00Z") // "-PT5M" (five minutes early)
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-15T10:00:00Z") // "PT0S"
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-17T11:30:00Z") // "PT49H30M" (hours, never days)
- * @example scheduleDeviation("2024-11-03T01:30:00-04:00[America/New_York]", "2024-11-03T01:30:00-05:00[America/New_York]") // "PT1H" (the same wall time, one hour later across the fall-back)
+ * @example scheduleDeviation("2024-04-07T02:30:00+11:00[Australia/Sydney]", "2024-04-07T02:30:00+10:00[Australia/Sydney]") // "PT1H" (the same wall time, one hour later across the fall-back)
  * @example scheduleDeviation("2024-06-15T10:00:00Z", "2024-06-15T12:14:00+02:00[Europe/Amsterdam]") // "PT14M" (the zone it is written in does not matter)
  * @example scheduleDeviation("2024-06-15T10:00:00", "2024-06-15T10:14:00Z") // "" (a zoneless plan is not a moment)
  */

package/dist/transport/compare/timeToCutoff.d.ts

@@ -25,7 +25,7 @@
  * @example timeToCutoff("2024-06-12T13:30:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // "PT1H30M"
  * @example timeToCutoff("2024-06-12T16:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // "-PT1H" (an hour past the cut-off)
  * @example timeToCutoff("2024-06-12T15:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // "PT0S"
- * @example timeToCutoff("2024-11-02T17:00:00-04:00[America/New_York]", "2024-11-03T17:00:00-05:00[America/New_York]") // "PT25H" (across the fall-back)
+ * @example timeToCutoff("2024-10-26T17:00:00+01:00[Europe/London]", "2024-10-27T17:00:00+00:00[Europe/London]") // "PT25H" (across the fall-back)
  * @example timeToCutoff("2024-06-12T16:00:00Z", "") // ""
  */
 export declare function timeToCutoff(now: string, cutoff: string): string;

package/dist/transport/compare/timeToCutoff.js

@@ -27,7 +27,7 @@ import { isValidInstant } from "../../precision/validate/isValidInstant.js";
  * @example timeToCutoff("2024-06-12T13:30:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // "PT1H30M"
  * @example timeToCutoff("2024-06-12T16:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // "-PT1H" (an hour past the cut-off)
  * @example timeToCutoff("2024-06-12T15:00:00Z", "2024-06-12T17:00:00+02:00[Europe/Amsterdam]") // "PT0S"
- * @example timeToCutoff("2024-11-02T17:00:00-04:00[America/New_York]", "2024-11-03T17:00:00-05:00[America/New_York]") // "PT25H" (across the fall-back)
+ * @example timeToCutoff("2024-10-26T17:00:00+01:00[Europe/London]", "2024-10-27T17:00:00+00:00[Europe/London]") // "PT25H" (across the fall-back)
  * @example timeToCutoff("2024-06-12T16:00:00Z", "") // ""
  */
 export function timeToCutoff(now, cutoff) {

package/dist/transport/convert/etaAtZone.d.ts

@@ -40,8 +40,8 @@
  * @example etaAtZone("2024-06-15T12:30:00Z", "Asia/Tokyo") // "2024-06-15T21:30:00+09:00[Asia/Tokyo]"
  * @example etaAtZone("2024-06-15T12:30:00Z", "America/Los_Angeles") // "2024-06-15T05:30:00-07:00[America/Los_Angeles]"
  * @example etaAtZone("2024-06-15T12:30:00+02:00", "Pacific/Apia") // "2024-06-15T23:30:00+13:00[Pacific/Apia]" (the offset fixes the instant; the zone renders it)
- * @example etaAtZone("2024-11-03T05:30:00Z", "America/New_York") // "2024-11-03T01:30:00-04:00[America/New_York]" (the first 01:30 of the fall-back night)
- * @example etaAtZone("2024-11-03T06:30:00Z", "America/New_York") // "2024-11-03T01:30:00-05:00[America/New_York]" (the second; the offset tells them apart)
+ * @example etaAtZone("2024-04-06T15:30:00Z", "Australia/Sydney") // "2024-04-07T02:30:00+11:00[Australia/Sydney]" (the first 02:30 of the fall-back night)
+ * @example etaAtZone("2024-04-06T16:30:00Z", "Australia/Sydney") // "2024-04-07T02:30:00+10:00[Australia/Sydney]" (the second; the offset tells them apart)
  * @example etaAtZone("2024-06-15T12:30:00", "Asia/Tokyo") // "" (no offset designator: not a moment)
  * @example etaAtZone("2024-06-15T12:30:00Z", "Asia/Tokio") // ""
  */

package/dist/transport/convert/etaAtZone.js

@@ -43,8 +43,8 @@ import { isValidTimeZone } from "../../zoned/validate/isValidTimeZone.js";
  * @example etaAtZone("2024-06-15T12:30:00Z", "Asia/Tokyo") // "2024-06-15T21:30:00+09:00[Asia/Tokyo]"
  * @example etaAtZone("2024-06-15T12:30:00Z", "America/Los_Angeles") // "2024-06-15T05:30:00-07:00[America/Los_Angeles]"
  * @example etaAtZone("2024-06-15T12:30:00+02:00", "Pacific/Apia") // "2024-06-15T23:30:00+13:00[Pacific/Apia]" (the offset fixes the instant; the zone renders it)
- * @example etaAtZone("2024-11-03T05:30:00Z", "America/New_York") // "2024-11-03T01:30:00-04:00[America/New_York]" (the first 01:30 of the fall-back night)
- * @example etaAtZone("2024-11-03T06:30:00Z", "America/New_York") // "2024-11-03T01:30:00-05:00[America/New_York]" (the second; the offset tells them apart)
+ * @example etaAtZone("2024-04-06T15:30:00Z", "Australia/Sydney") // "2024-04-07T02:30:00+11:00[Australia/Sydney]" (the first 02:30 of the fall-back night)
+ * @example etaAtZone("2024-04-06T16:30:00Z", "Australia/Sydney") // "2024-04-07T02:30:00+10:00[Australia/Sydney]" (the second; the offset tells them apart)
  * @example etaAtZone("2024-06-15T12:30:00", "Asia/Tokyo") // "" (no offset designator: not a moment)
  * @example etaAtZone("2024-06-15T12:30:00Z", "Asia/Tokio") // ""
  */

package/dist/transport/index.d.ts

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

package/dist/transport/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 "./calculate/index.js";
 export * from "./compare/index.js";
 export * from "./convert/index.js";

package/dist/types/date-duration-unit.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * A date field of an ISO 8601 duration, in the plural: `"years"`, `"months"`, `"weeks"` or
  * `"days"`. It names the unit an amount of dates is given in or a date difference is measured in.

package/dist/types/date-time-duration-units.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * Any field of an ISO 8601 duration, in the plural, from `"years"` down to `"nanoseconds"`. It
  * names the unit an amount of time is given in or a difference is measured in.

package/dist/types/date-time-unit.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * A date or time unit in the singular, from `"year"` down to `"nanosecond"`, as Temporal's
  * rounding and difference options name units.

package/dist/types/date-unit.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * A date unit in the singular: `"year"`, `"month"`, `"week"` or `"day"`, as Temporal's rounding
  * and difference options name units.

package/dist/types/disambiguation.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * How a local wall time that a time zone's clock shows twice or never is resolved to an instant,
  * as Temporal's `disambiguation` option (`Temporal.ZonedDateTime.from(item, { disambiguation })`).

package/dist/types/duration-relative-to.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * The anchor a calendar-unit duration operation is measured from, as Temporal's `relativeTo`
  * option takes it (`Duration.prototype.round`, `Duration.prototype.total`, `Duration.compare`).

package/dist/types/duration-string-options.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * Precision options for the ISO 8601 duration string a `diff*AsDuration` function writes, passed
  * to `Temporal.Duration.prototype.toString()`.

package/dist/types/exact-duration-unit.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * The plural name of a duration field that has an exact length: `"days"`, or a time field from
  * `"hours"` down to `"nanoseconds"`. A day is 24 hours when nothing anchors it, as

package/dist/types/fiscal-calendar.d.ts

@@ -1,7 +1,8 @@
 /**
  * Week-per-period shape of a 52/53-week fiscal year, one entry per month of a quarter.
  *
- * - `"4-5-4"` — the NRF retail calendar, the US retail standard.
+ * - `"4-5-4"` — the longer month falls in the middle of the quarter. One published
+ *   example is the NRF retail calendar (US).
  * - `"4-4-5"` — the longer month falls at the end of the quarter.
  * - `"5-4-4"` — the longer month falls at the start of the quarter.
  *
@@ -9,14 +10,49 @@
  * `isValidFiscalPattern`.
  */
 export type FiscalPattern = "4-5-4" | "4-4-5" | "5-4-4";
-/** Caller-supplied 52/53-week fiscal calendar. GMT bundles none. */
+/**
+ * The period a 53rd week is added to, in a fiscal year that has one.
+ *
+ * - `"firstPeriod"` — the first period gets the extra week, so quarter 1 has 14 weeks. One
+ *   published example is the ONS retail trading periods (UK): "a five week January is
+ *   introduced every five to six years".
+ * - `"lastPeriod"` — the last period gets it, so quarter 4 has 14 weeks. One published example
+ *   is the NRF 4-5-4 calendar (US), which adds the week "to the end of the calendar".
+ *
+ * Narrow a candidate with `isValidFiscalExtraWeek`.
+ */
+export type FiscalExtraWeek = "firstPeriod" | "lastPeriod";
+/**
+ * The calendar year that names a fiscal year.
+ *
+ * - `"startYear"` — the year its first day falls in. NRF (US): fiscal 2023 runs 2023-01-29 to
+ *   2024-02-03.
+ * - `"endYear"` — the year its last day falls in. IFRS 18 ¶27(c) (formerly IAS 1 ¶51(c)) lets
+ *   a reporting period be identified by the date it ends. Under `yearEndsOn: "2021-06-27"`,
+ *   the year 2023-06-26 to 2024-06-30 is 2024.
+ * - `"majorityYear"` — the calendar year holding the most of its days. ONS (UK): 2025 runs
+ *   2024-12-29 to 2026-01-03. When two years hold exactly half each, the label is the end year,
+ *   the year holding the date the period ends on.
+ *
+ * Narrow a candidate with `isValidFiscalYearLabel`.
+ */
+export type FiscalYearLabel = "startYear" | "endYear" | "majorityYear";
+/** Caller-supplied 52/53-week fiscal calendar. GMT bundles none, and has no defaults. */
 export interface FiscalCalendar {
     /** The weeks per period within each quarter. */
     pattern: FiscalPattern;
     /**
      * The year-end rule, stated as one ISO date: fiscal years end on this date's **weekday**,
-     * on the occurrence nearest this date's **month and day**. For the NRF retail calendar —
-     * "the Saturday nearest to January 31" — that is `"2026-01-31"`.
+     * on the occurrence nearest this date's **month and day**. NRF (US) adds a 53rd week when
+     * "there are four or more days left in January", which is the Saturday nearest
+     * January 31: `"2026-01-31"`. One rule covers one run of years: ONS (UK) trading periods
+     * end on the Saturday nearest December 31 (`"2022-12-31"`) from 2004, but when December 31
+     * fell on a Tuesday before then, on the Saturday after it (1997-01-04). Years before 2004
+     * need a second `FiscalCalendar`.
      */
     yearEndsOn: string;
+    /** The period a 53rd week is added to. */
+    extraWeek: FiscalExtraWeek;
+    /** The calendar year that names a fiscal year. */
+    yearLabel: FiscalYearLabel;
 }

package/dist/types/gnss.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A satellite navigation system's time scale, by its RINEX 4.02 time-system identifier: GPS time,
+ * Galileo time, BeiDou time, QZSS time, GLONASS time (in UTC hours, as RINEX and BIPM report it),
+ * NavIC time. The six are peers: IMO recognises GPS, GLONASS, BeiDou, Galileo, NavIC (IRNSS) and
+ * QZSS as components of the Worldwide Radionavigation System (resolution A.1046(27), annex revised
+ * by MSC.599(111)).
+ */
+export type GnssSystem = "GPS" | "GAL" | "BDT" | "QZS" | "GLO" | "IRN";
+/**
+ * A satellite week counter, named by system and, where a system broadcasts two, by navigation
+ * message: GPS and QZSS LNAV count modulo 1024, their CNAV modulo 8192, Galileo modulo 4096,
+ * BeiDou modulo 8192, NavIC LNAV (L5/S) modulo 1024 and L1NV modulo 8192. GLONASS has no week
+ * counter. A RINEX navigation-file week is not one of these: see `RinexWeekSystem`.
+ */
+export type GnssWeekCounter = "GPS-LNAV" | "GPS-CNAV" | "GAL" | "BDT" | "QZS-LNAV" | "QZS-CNAV" | "IRN-LNAV" | "IRN-L1NV";
+/**
+ * Which pass of a wrapping week counter a week number belongs to, in one of three forms. An
+ * integer from 0 is the era itself (era 0 starts at the system's epoch). `"rolling"` picks the era
+ * that puts the week within half a counter period of today, or era 0, when the week would
+ * otherwise fall before the system's epoch; it is for live receiver output and reads the clock, so
+ * the same stored value can give a different answer in a later year. `{ notBefore }`
+ * picks the earliest occurrence at or after an instant you state (a receiver's firmware build
+ * date, or the start of a recorded log) and gives the same answer in any year.
+ */
+export type RolloverEra = number | "rolling" | {
+    /**
+     * An ISO 8601 UTC instant; a listed leap second (`…T23:59:60Z`) is accepted. The week
+     * resolves to the earliest instant at or after it; an instant exactly equal to it counts.
+     * Before the counter's epoch it gives era 0. A value that is not an instant returns the
+     * sentinel.
+     */
+    notBefore: string;
+};
+/** A week and time of week on one satellite week counter. */
+export interface GnssWeek {
+    /** The week number as the counter shows it, from 0 to the counter's modulus − 1. */
+    week: number;
+    /** Seconds since the start of the week, from 0 up to but not including 604 800. */
+    timeOfWeekSeconds: number;
+    /** How many times the counter has wrapped since the system's epoch. */
+    era: number;
+}
+/** The systems whose RINEX navigation records carry a week number. GLONASS records do not. */
+export type RinexWeekSystem = "GPS" | "GAL" | "BDT" | "QZS" | "IRN";
+/** A week and time of week as a RINEX navigation record counts them: continuous, so no era. */
+export interface RinexWeek {
+    /** The continuous week number, counted from the record's epoch without wrapping. */
+    week: number;
+    /** Seconds since the start of the week, from 0 up to but not including 604 800. */
+    timeOfWeekSeconds: number;
+}

package/dist/types/index.d.ts

@@ -18,6 +18,7 @@ export * from "./exact-duration-unit.js";
 export * from "./fiscal-calendar.js";
 export * from "./fractional-digit.js";
 export * from "./free-time-options.js";
+export * from "./gnss.js";
 export * from "./interval.js";
 export * from "./now-unit.js";
 export * from "./offset.js";
@@ -31,6 +32,7 @@ export * from "./relative-time-unit.js";
 export * from "./relative-unit.js";
 export * from "./roll-convention.js";
 export * from "./rounding-options.js";
+export * from "./stored-zoned-classification.js";
 export * from "./time-cycle-field.js";
 export * from "./time-duration-unit.js";
 export * from "./time-unit.js";

package/dist/types/index.js

@@ -18,6 +18,7 @@ export * from "./exact-duration-unit.js";
 export * from "./fiscal-calendar.js";
 export * from "./fractional-digit.js";
 export * from "./free-time-options.js";
+export * from "./gnss.js";
 export * from "./interval.js";
 export * from "./now-unit.js";
 export * from "./offset.js";
@@ -31,6 +32,7 @@ export * from "./relative-time-unit.js";
 export * from "./relative-unit.js";
 export * from "./roll-convention.js";
 export * from "./rounding-options.js";
+export * from "./stored-zoned-classification.js";
 export * from "./time-cycle-field.js";
 export * from "./time-duration-unit.js";
 export * from "./time-unit.js";

package/dist/types/now-unit.d.ts

@@ -2,4 +2,4 @@
  * Units extractable from the current system local time via `getNowUnit`.
  * Defined as `DateTimeUnit | "dayOfWeek"`.
  */
-export type NowUnit = import("@js-temporal/polyfill").Temporal.SmallestUnit<import("./date-time-unit.js").DateTimeUnit> | "dayOfWeek";
+export type NowUnit = import("../internal/temporal.js").Temporal.SmallestUnit<import("./date-time-unit.js").DateTimeUnit> | "dayOfWeek";

package/dist/types/offset.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * What to do when the UTC offset written in a zoned value disagrees with its time zone, as
  * Temporal's `offset` option (`Temporal.ZonedDateTime.prototype.with(item, { offset })`). It is

package/dist/types/overflow.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * What to do when a date or time field is out of range, as Temporal's `overflow` option
  * (`Temporal.PlainDate.prototype.add(item, { overflow })`). `"constrain"` clamps the field to the

package/dist/types/rounding-options.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * How a difference is rounded, as the rounding options of Temporal's `until()` and `since()`
  * (`Temporal.PlainDate.prototype.until(other, options)`). `Unit` is the set of units the values

package/dist/types/stored-zoned-classification.d.ts

@@ -0,0 +1,83 @@
+/**
+ * What `classifyStoredZoned` finds when an RFC 9557 string carries both a UTC offset and a
+ * bracketed IANA zone. Every reading is a `Z` instant string (`Temporal.Instant#toString`), and
+ * every offset is `±HH:MM[:SS]`. Each kind carries enough readings to reproduce each of
+ * Temporal's `offset` values (`use`, `ignore`, `prefer`, `reject`).
+ *
+ * @example
+ * import type { StoredZonedClassification } from "@northguild/gmt/types";
+ * const found: StoredZonedClassification = {
+ *   kind: "offsetMismatch",
+ *   storedOffset: "+02:00",
+ *   zoneOffset: "+03:00",
+ *   atStoredOffset: "2016-12-01T07:00:00Z",
+ *   atZoneOffset: "2016-12-01T06:00:00Z",
+ * };
+ */
+export type StoredZonedClassification = {
+    /**
+     * The string names one instant. Either it ends in `Z`, which Temporal reads as exact
+     * whatever the zone's wall clock does, or its offset matches the zone's offset at that
+     * local time (to the minute, or exactly when written with seconds) and the local time
+     * occurs once. `instant` is what `reject`, `prefer` and `ignore` give.
+     */
+    kind: "valid";
+    /** The instant the string names. */
+    instant: string;
+    /** The instant `offset: "use"` gives: the written wall clock minus the written offset. */
+    atStoredOffset: string;
+} | {
+    /**
+     * The local time occurs twice, and the stored offset picks one of the two: `instant`, which
+     * is either `earlier` or `later`. `ignore` gives `earlier` or `later` by `disambiguation`.
+     */
+    kind: "validInOverlap";
+    /** The occurrence the stored offset picks. `reject` and `prefer` give it. */
+    instant: string;
+    /** The first occurrence. */
+    earlier: string;
+    /** The second occurrence. */
+    later: string;
+    /** The instant `offset: "use"` gives. */
+    atStoredOffset: string;
+} | {
+    /**
+     * The local time occurs once, but not at the stored offset. `reject` refuses it, and `ignore`
+     * and `prefer` give `atZoneOffset`.
+     */
+    kind: "offsetMismatch";
+    /** The offset as written in the string, `±HH:MM` or `±HH:MM:SS`. Seconds are kept when written. */
+    storedOffset: string;
+    /** The offset the zone has at that local time. */
+    zoneOffset: string;
+    /** The instant `offset: "use"` gives. */
+    atStoredOffset: string;
+    /** The instant the zone's own offset gives. */
+    atZoneOffset: string;
+} | {
+    /**
+     * The local time occurs twice, and the stored offset picks neither occurrence. `reject`
+     * refuses it, and `ignore` and `prefer` give `earlier` or `later` by `disambiguation`.
+     */
+    kind: "ambiguous";
+    /** The first occurrence. */
+    earlier: string;
+    /** The second occurrence. */
+    later: string;
+    /** The instant `offset: "use"` gives. */
+    atStoredOffset: string;
+} | {
+    /**
+     * The local time falls in a gap, so there is no occurrence to match. `reject` refuses it,
+     * and `ignore` and `prefer` give `earlier` or `later` by `disambiguation`. `earlier` and
+     * `later` are the wall time shifted back or forward by the size of the gap, as
+     * `disambiguation` names them.
+     */
+    kind: "nonexistent";
+    /** The reading `disambiguation: "earlier"` gives. */
+    earlier: string;
+    /** The reading `disambiguation: "later"` and `"compatible"` give. */
+    later: string;
+    /** The instant `offset: "use"` gives. */
+    atStoredOffset: string;
+};

package/dist/types/time-duration-unit.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * A time field of an ISO 8601 duration, in the plural, from `"hours"` down to `"nanoseconds"`.
  * It names the unit an amount of time is given in or a time difference is measured in.

package/dist/types/time-unit.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../internal/temporal.js";
 /**
  * A time unit in the singular, from `"hour"` down to `"nanosecond"`, as Temporal's rounding and
  * difference options name units.

package/dist/types/utc-now-unit.d.ts

@@ -2,4 +2,4 @@
  * Units extractable from the current UTC instant via `getUtcNowUnit`.
  * Defined as `DateTimeUnit | "dayOfWeek"`.
  */
-export type UtcNowUnit = import("@js-temporal/polyfill").Temporal.SmallestUnit<import("./date-time-unit.js").DateTimeUnit> | "dayOfWeek";
+export type UtcNowUnit = import("../internal/temporal.js").Temporal.SmallestUnit<import("./date-time-unit.js").DateTimeUnit> | "dayOfWeek";

package/dist/unix/calculate/diffUnix.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 import type { DateTimeDurationUnit, RoundingOptions } from "../../types/index.js";
 import type { UnixUnit } from "../validate/isValidUnixUnit.js";
 /**

package/dist/unix/calculate/diffUnixAsDuration.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 import type { DateTimeDurationUnit, DurationStringOptions, RoundingOptions } from "../../types/index.js";
 import type { UnixUnit } from "../validate/isValidUnixUnit.js";
 /**

package/dist/unix/calculate/endOfUnix.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 import type { UnixUnit } from "../validate/isValidUnixUnit.js";
 /**
  * Return the end of the specified unit for a Unix timestamp.
@@ -26,7 +26,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example endOfUnix(1706659200000, "month", { timeZone: "UTC" }) // 1706745599999
  * @example endOfUnix(1706659200, "day", { epochUnit: "seconds", timeZone: "UTC" }) // 1706745599
  * @example endOfUnix(-86400000, "year", { timeZone: "UTC" }) // -1 (end of 1969)
- * @example endOfUnix(1730616300000, "hour", { timeZone: "America/New_York" }) // 1730617199999 (1730616300000 is the second, repeated 1:45am of the Nov 3 2024 fall-back; its hour ends at the second 1:59:59.999)
+ * @example endOfUnix(1729993500000, "hour", { timeZone: "Europe/London" }) // 1729994399999 (1729993500000 is the second, repeated 1:45am of the Oct 27 2024 fall-back; its hour ends at the second 1:59:59.999)
  * @example endOfUnix(1706780800, "days", { epochUnit: "second" }) // 1706831999 (plural unit, singular epochUnit, UTC by default)
  * @example endOfUnix(1706659200000, "quarter") // null (use endOfQuarterForUnix)
  * @example endOfUnix(NaN, "day") // null

package/dist/unix/calculate/endOfUnix.js

@@ -28,7 +28,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example endOfUnix(1706659200000, "month", { timeZone: "UTC" }) // 1706745599999
  * @example endOfUnix(1706659200, "day", { epochUnit: "seconds", timeZone: "UTC" }) // 1706745599
  * @example endOfUnix(-86400000, "year", { timeZone: "UTC" }) // -1 (end of 1969)
- * @example endOfUnix(1730616300000, "hour", { timeZone: "America/New_York" }) // 1730617199999 (1730616300000 is the second, repeated 1:45am of the Nov 3 2024 fall-back; its hour ends at the second 1:59:59.999)
+ * @example endOfUnix(1729993500000, "hour", { timeZone: "Europe/London" }) // 1729994399999 (1729993500000 is the second, repeated 1:45am of the Oct 27 2024 fall-back; its hour ends at the second 1:59:59.999)
  * @example endOfUnix(1706780800, "days", { epochUnit: "second" }) // 1706831999 (plural unit, singular epochUnit, UTC by default)
  * @example endOfUnix(1706659200000, "quarter") // null (use endOfQuarterForUnix)
  * @example endOfUnix(NaN, "day") // null

package/dist/unix/calculate/isBetweenUnix.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { normalizeZoneFrame } from "../../internal/zoneFrame.js";
 import { resolveUnixEpochUnit, unixEpochToInstant, } from "../../internal/unixEpochValue.js";
 import { isOptionsArgument } from "../../internal/isObject.js";

package/dist/unix/calculate/roundUnix.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 import type { UnixUnit } from "../validate/isValidUnixUnit.js";
 /**
  * Round a Unix timestamp to the specified unit.
@@ -9,10 +9,12 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  *   GetTemporalUnitValuedOption accepts both (§13.17).
  * - Date units ("year", "month", "week", in either form) return null: Temporal's
  *   ZonedDateTime.prototype.round accepts no unit larger than "day".
- * - Follows TC39 `ZonedDateTime.round`, which rounds the wall clock and re-resolves it in the
- *   zone. Across a transition the result can land after the input — in `Pacific/Chatham`,
- *   1727532300000 (03:50+13:45) truncated to the hour gives 1727532900000, 15 minutes later.
- *   Use `floorToZone` for a boundary that never exceeds the instant.
+ * - Follows TC39 `ZonedDateTime.round`. Below the day it rounds the wall clock and re-resolves it
+ *   in the zone, so across a transition the result can land after the input — in
+ *   `Pacific/Chatham`, 1727532300000 (03:50+13:45) truncated to the hour gives 1727532900000,
+ *   15 minutes later. To the day it rounds between the start of the input's date and the start of
+ *   the next, so `"floor"` and `"trunc"` never leave the input's date, even when a clock change
+ *   makes that date start twice. Use `floorToZone` for a boundary that never exceeds the instant.
  * - `value` is a safe integer or a digit string (`"1706661000000"`); anything else returns null.
  * - Returns null for invalid input.
  * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,

package/dist/unix/calculate/roundUnix.js

@@ -22,10 +22,12 @@ function isZonedRoundingUnit(unit) {
  *   GetTemporalUnitValuedOption accepts both (§13.17).
  * - Date units ("year", "month", "week", in either form) return null: Temporal's
  *   ZonedDateTime.prototype.round accepts no unit larger than "day".
- * - Follows TC39 `ZonedDateTime.round`, which rounds the wall clock and re-resolves it in the
- *   zone. Across a transition the result can land after the input — in `Pacific/Chatham`,
- *   1727532300000 (03:50+13:45) truncated to the hour gives 1727532900000, 15 minutes later.
- *   Use `floorToZone` for a boundary that never exceeds the instant.
+ * - Follows TC39 `ZonedDateTime.round`. Below the day it rounds the wall clock and re-resolves it
+ *   in the zone, so across a transition the result can land after the input — in
+ *   `Pacific/Chatham`, 1727532300000 (03:50+13:45) truncated to the hour gives 1727532900000,
+ *   15 minutes later. To the day it rounds between the start of the input's date and the start of
+ *   the next, so `"floor"` and `"trunc"` never leave the input's date, even when a clock change
+ *   makes that date start twice. Use `floorToZone` for a boundary that never exceeds the instant.
  * - `value` is a safe integer or a digit string (`"1706661000000"`); anything else returns null.
  * - Returns null for invalid input.
  * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,

package/dist/unix/calculate/setUnix.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 import type { Disambiguation, Offset, Overflow } from "../../types/index.js";
 import type { UnixUnit } from "../validate/isValidUnixUnit.js";
 /**
@@ -41,8 +41,8 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example setUnix(1710072000000, { hour: 9 }, { timeZone: "UTC" }) // 1710061200000 (2024-03-10T09:00:00Z)
  * @example setUnix(1706659200000, { year: 2025 }, { timeZone: "UTC" }) // 1738281600000 (2025-01-31T00:00:00Z)
  * @example setUnix(1706659200000, {}, { timeZone: "UTC" }) // 1706659200000 (empty fields object is a no-op)
- * @example setUnix(1730615400000, { minute: 45 }, { timeZone: "America/New_York" }) // 1730616300000 (the second 01:30 keeps -05:00)
- * @example setUnix(1730615400000, { minute: 45 }, { timeZone: "America/New_York", offset: "ignore" }) // 1730612700000 (re-resolved: the earlier 01:45)
+ * @example setUnix(1729992600000, { minute: 45 }, { timeZone: "Europe/London" }) // 1729993500000 (the second 01:30 keeps +00:00)
+ * @example setUnix(1729992600000, { minute: 45 }, { timeZone: "Europe/London", offset: "ignore" }) // 1729989900000 (re-resolved: the earlier 01:45)
  * @example setUnix(1710072000000, { hour: "9" }, { timeZone: "UTC" }) // null (not converted)
  * @example setUnix(NaN, { hour: 9 }) // null
  */

package/dist/unix/calculate/setUnix.js

@@ -42,8 +42,8 @@ import { optionOrDefault } from "../../internal/optionOrDefault.js";
  * @example setUnix(1710072000000, { hour: 9 }, { timeZone: "UTC" }) // 1710061200000 (2024-03-10T09:00:00Z)
  * @example setUnix(1706659200000, { year: 2025 }, { timeZone: "UTC" }) // 1738281600000 (2025-01-31T00:00:00Z)
  * @example setUnix(1706659200000, {}, { timeZone: "UTC" }) // 1706659200000 (empty fields object is a no-op)
- * @example setUnix(1730615400000, { minute: 45 }, { timeZone: "America/New_York" }) // 1730616300000 (the second 01:30 keeps -05:00)
- * @example setUnix(1730615400000, { minute: 45 }, { timeZone: "America/New_York", offset: "ignore" }) // 1730612700000 (re-resolved: the earlier 01:45)
+ * @example setUnix(1729992600000, { minute: 45 }, { timeZone: "Europe/London" }) // 1729993500000 (the second 01:30 keeps +00:00)
+ * @example setUnix(1729992600000, { minute: 45 }, { timeZone: "Europe/London", offset: "ignore" }) // 1729989900000 (re-resolved: the earlier 01:45)
  * @example setUnix(1710072000000, { hour: "9" }, { timeZone: "UTC" }) // null (not converted)
  * @example setUnix(NaN, { hour: 9 }) // null
  */