@northguild/gmt 1.19.0 → 1.20.0

package/dist/unix/calculate/startOfUnix.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 start of the specified unit for a Unix timestamp.
@@ -26,7 +26,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example startOfUnix(1706659200000, "month", { timeZone: "UTC" }) // 1704067200000
  * @example startOfUnix(1706659200, "day", { epochUnit: "seconds", timeZone: "UTC" }) // 1706659200
  * @example startOfUnix(-86400000, "year", { timeZone: "UTC" }) // -31536000000 (start of 1969)
- * @example startOfUnix(1730616300000, "hour", { timeZone: "America/New_York" }) // 1730613600000 (1730616300000 is the second, repeated 1:45am of the Nov 3 2024 fall-back; its hour starts at the second 1am)
+ * @example startOfUnix(1729993500000, "hour", { timeZone: "Europe/London" }) // 1729990800000 (1729993500000 is the second, repeated 1:45am of the Oct 27 2024 fall-back; its hour starts at the second 1am)
  * @example startOfUnix(1706780800, "days", { epochUnit: "second" }) // 1706745600 (plural unit, singular epochUnit, UTC by default)
  * @example startOfUnix(1706659200000, "quarter") // null (use startOfQuarterForUnix)
  * @example startOfUnix(NaN, "day") // null

package/dist/unix/calculate/startOfUnix.js

@@ -28,7 +28,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example startOfUnix(1706659200000, "month", { timeZone: "UTC" }) // 1704067200000
  * @example startOfUnix(1706659200, "day", { epochUnit: "seconds", timeZone: "UTC" }) // 1706659200
  * @example startOfUnix(-86400000, "year", { timeZone: "UTC" }) // -31536000000 (start of 1969)
- * @example startOfUnix(1730616300000, "hour", { timeZone: "America/New_York" }) // 1730613600000 (1730616300000 is the second, repeated 1:45am of the Nov 3 2024 fall-back; its hour starts at the second 1am)
+ * @example startOfUnix(1729993500000, "hour", { timeZone: "Europe/London" }) // 1729990800000 (1729993500000 is the second, repeated 1:45am of the Oct 27 2024 fall-back; its hour starts at the second 1am)
  * @example startOfUnix(1706780800, "days", { epochUnit: "second" }) // 1706745600 (plural unit, singular epochUnit, UTC by default)
  * @example startOfUnix(1706659200000, "quarter") // null (use startOfQuarterForUnix)
  * @example startOfUnix(NaN, "day") // null

package/dist/unix/compare/areUnixEqualBy.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";
 /**
  * Compare two Unix epoch values for equality at a given unit.
@@ -12,11 +12,6 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * - Each value is a safe integer or a string of optionally negative ASCII digits; `unit` may be
  *   singular or plural.
  * - Returns false for an unsupported unit (including `"quarter"`) or invalid input.
- *
- * Mapping from date-fns:
- * - `isSameDay(a, b)` → `areUnixEqualBy(a, b, "day")`
- * - `isSameMonth(a, b)` → `areUnixEqualBy(a, b, "month")`
- * - `isSameYear(a, b)` → `areUnixEqualBy(a, b, "year")`
  * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
  *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
  *   offset's seconds (under a minute) of the last instant Temporal supports
@@ -24,6 +19,11 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  *   (`-271821-04-20T00:00:00Z`) for one west, this returns `false`. There `false` is the sentinel,
  *   not a comparison. An offset to the minute has no such limit.
  *
+ * Migrating from date-fns:
+ * - `isSameDay(a, b)` → `areUnixEqualBy(a, b, "day")`
+ * - `isSameMonth(a, b)` → `areUnixEqualBy(a, b, "month")`
+ * - `isSameYear(a, b)` → `areUnixEqualBy(a, b, "year")`
+ *
  * @param value1 first Unix epoch: a safe integer or a digit string
  * @param value2 second Unix epoch, in the same unit
  * @param unit Temporal.DateUnit | Temporal.TimeUnit to compare by

package/dist/unix/compare/areUnixEqualBy.js

@@ -12,11 +12,6 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * - Each value is a safe integer or a string of optionally negative ASCII digits; `unit` may be
  *   singular or plural.
  * - Returns false for an unsupported unit (including `"quarter"`) or invalid input.
- *
- * Mapping from date-fns:
- * - `isSameDay(a, b)` → `areUnixEqualBy(a, b, "day")`
- * - `isSameMonth(a, b)` → `areUnixEqualBy(a, b, "month")`
- * - `isSameYear(a, b)` → `areUnixEqualBy(a, b, "year")`
  * - **Limit at an offset with seconds.** The instant is placed in the offset's whole-minute zone,
  *   moved by its seconds, and the moved instant must be inside Temporal's range. So within the
  *   offset's seconds (under a minute) of the last instant Temporal supports
@@ -24,6 +19,11 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   (`-271821-04-20T00:00:00Z`) for one west, this returns `false`. There `false` is the sentinel,
  *   not a comparison. An offset to the minute has no such limit.
  *
+ * Migrating from date-fns:
+ * - `isSameDay(a, b)` → `areUnixEqualBy(a, b, "day")`
+ * - `isSameMonth(a, b)` → `areUnixEqualBy(a, b, "month")`
+ * - `isSameYear(a, b)` → `areUnixEqualBy(a, b, "year")`
+ *
  * @param value1 first Unix epoch: a safe integer or a digit string
  * @param value2 second Unix epoch, in the same unit
  * @param unit Temporal.DateUnit | Temporal.TimeUnit to compare by

package/dist/unix/convert/convertUnixToPlainTime.d.ts

@@ -14,7 +14,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example convertUnixToPlainTime(1706659200000, { timeZone: "UTC" }) // "00:00:00"
  * @example convertUnixToPlainTime(1706659200, { epochUnit: "seconds", timeZone: "UTC" }) // "00:00:00"
  * @example convertUnixToPlainTime(-1, { timeZone: "UTC" }) // "23:59:59.999"
- * @example convertUnixToPlainTime("1706659200000", { timeZone: "local" }) // system-zone wall clock, e.g. "19:00:00" in America/New_York
+ * @example convertUnixToPlainTime("1706659200000", { timeZone: "local" }) // system-zone wall clock, e.g. "09:00:00" in Asia/Tokyo
  * @example convertUnixToPlainTime(NaN) // ""
  * @example convertUnixToPlainTime(45870000, { timeZone: "-00:44:30" }) // "12:00:00" (a stored offset with seconds)
  */

package/dist/unix/convert/convertUnixToPlainTime.js

@@ -17,7 +17,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example convertUnixToPlainTime(1706659200000, { timeZone: "UTC" }) // "00:00:00"
  * @example convertUnixToPlainTime(1706659200, { epochUnit: "seconds", timeZone: "UTC" }) // "00:00:00"
  * @example convertUnixToPlainTime(-1, { timeZone: "UTC" }) // "23:59:59.999"
- * @example convertUnixToPlainTime("1706659200000", { timeZone: "local" }) // system-zone wall clock, e.g. "19:00:00" in America/New_York
+ * @example convertUnixToPlainTime("1706659200000", { timeZone: "local" }) // system-zone wall clock, e.g. "09:00:00" in Asia/Tokyo
  * @example convertUnixToPlainTime(NaN) // ""
  * @example convertUnixToPlainTime(45870000, { timeZone: "-00:44:30" }) // "12:00:00" (a stored offset with seconds)
  */

package/dist/unix/convert/convertUnixToZoned.d.ts

@@ -17,7 +17,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @param options optional: how `value` is read
  * @returns zoned ISO 8601 string or "" on invalid
  *
- * @example convertUnixToZoned(1709164800000, "America/New_York") // "2024-02-28T19:00:00-05:00[America/New_York]"
+ * @example convertUnixToZoned(1709164800000, "Asia/Kolkata") // "2024-02-29T05:30:00+05:30[Asia/Kolkata]"
  * @example convertUnixToZoned(1709164800, "UTC", { epochUnit: "seconds" }) // "2024-02-29T00:00:00+00:00[UTC]"
  * @example convertUnixToZoned("-1", "UTC") // "1969-12-31T23:59:59.999+00:00[UTC]"
  * @example convertUnixToZoned(1709164800, "UTC", "seconds" as never) // "" (options must be an object)

package/dist/unix/convert/convertUnixToZoned.js

@@ -18,7 +18,7 @@ import { isValidTimeZone } from "../../zoned/validate/index.js";
  * @param options optional: how `value` is read
  * @returns zoned ISO 8601 string or "" on invalid
  *
- * @example convertUnixToZoned(1709164800000, "America/New_York") // "2024-02-28T19:00:00-05:00[America/New_York]"
+ * @example convertUnixToZoned(1709164800000, "Asia/Kolkata") // "2024-02-29T05:30:00+05:30[Asia/Kolkata]"
  * @example convertUnixToZoned(1709164800, "UTC", { epochUnit: "seconds" }) // "2024-02-29T00:00:00+00:00[UTC]"
  * @example convertUnixToZoned("-1", "UTC") // "1969-12-31T23:59:59.999+00:00[UTC]"
  * @example convertUnixToZoned(1709164800, "UTC", "seconds" as never) // "" (options must be an object)

package/dist/unix/format/formatCalendarUnix.d.ts

@@ -5,7 +5,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  *
  * @example
  * import { FormatCalendarUnixOptions } from "@northguild/gmt/unix";
- * const opts: FormatCalendarUnixOptions = { timeZone: "America/New_York" };
+ * const opts: FormatCalendarUnixOptions = { timeZone: "Asia/Tokyo" };
  */
 export interface FormatCalendarUnixOptions {
     /**
@@ -32,8 +32,9 @@ export interface FormatCalendarUnixOptions {
     timeZone?: string;
     /**
      * The length of the time-of-day part, as the `timeStyle` of `Intl.DateTimeFormat`. `"short"`
-     * writes hours and minutes, `"medium"` adds seconds, `"long"` adds the short time zone name
-     * ("EDT") and `"full"` the long one ("Eastern Daylight Time"). Any other value returns `""`.
+     * writes hours and minutes, `"medium"` adds seconds, `"long"` adds the locale's short zone
+     * name ("BST" in en-GB, "GMT+1" in en-US) and `"full"` the long one ("British Summer Time" in
+     * English). Any other value returns `""`.
      *
      * @defaultValue `"short"`
      */
@@ -41,7 +42,7 @@ export interface FormatCalendarUnixOptions {
 }
 /**
  * Format a unix epoch value as a relative day label plus time-of-day, e.g.
- * "Tomorrow at 2:30 PM" — the unix counterpart of `formatCalendar`. See
+ * "tomorrow at 14:30" — the unix counterpart of `formatCalendar`. See
  * that function's JSDoc for the day-label/threshold/connector design; this
  * variant compares calendar days and renders the clock time in `timeZone`.
  *
@@ -59,11 +60,11 @@ export interface FormatCalendarUnixOptions {
  * @param options optional: the reference instant, how epochs are read, the zone and the width of the time
  * @returns the formatted calendar string, or "" on invalid input
  *
- * @example formatCalendarUnix(1710685845000, "en-US", { epochUnit: "milliseconds", timeZone: "America/New_York" }) // day label + time relative to "now", or the absolute fallback beyond the ±6-day threshold
- * @example formatCalendarUnix(1710772200000, "en-US", { reference: 1710685000000, timeZone: "UTC" }) // "tomorrow at 2:30 PM"
- * @example formatCalendarUnix("1710772200", "en-US", { reference: "1710685000", epochUnit: "second" }) // "tomorrow at 2:30 PM"
- * @example formatCalendarUnix(1710772200000, "en-US", { reference: 1710685000000, timeZone: "America/New_Yrok" }) // "" (unknown zone)
- * @example formatCalendarUnix(1710772200000, "en-US", null as never) // ""
+ * @example formatCalendarUnix(1710685845000, "ja-JP", { epochUnit: "milliseconds", timeZone: "Asia/Tokyo" }) // day label + time relative to "now", or the absolute fallback beyond the ±6-day threshold
+ * @example formatCalendarUnix(1710772200000, "en-GB", { reference: 1710685000000, timeZone: "UTC" }) // "tomorrow at 14:30"
+ * @example formatCalendarUnix("1710772200", "de-DE", { reference: "1710685000", epochUnit: "second" }) // "morgen um 14:30"
+ * @example formatCalendarUnix(1710772200000, "fr-FR", { reference: 1710685000000, timeZone: "Australia/Sidney" }) // "" (unknown zone)
+ * @example formatCalendarUnix(1710772200000, "hi-IN", null as never) // ""
  * @example formatCalendarUnix("not-a-number") // ""
  * @example formatCalendarUnix(1710613800000, ["fr-FR", "en-US"], { reference: 1710507600000 }) // "demain à 18:30"
  */

package/dist/unix/format/formatCalendarUnix.js

@@ -6,7 +6,7 @@ import { optionOrDefault } from "../../internal/optionOrDefault.js";
 import { isObject } from "../../internal/isObject.js";
 /**
  * Format a unix epoch value as a relative day label plus time-of-day, e.g.
- * "Tomorrow at 2:30 PM" — the unix counterpart of `formatCalendar`. See
+ * "tomorrow at 14:30" — the unix counterpart of `formatCalendar`. See
  * that function's JSDoc for the day-label/threshold/connector design; this
  * variant compares calendar days and renders the clock time in `timeZone`.
  *
@@ -24,11 +24,11 @@ import { isObject } from "../../internal/isObject.js";
  * @param options optional: the reference instant, how epochs are read, the zone and the width of the time
  * @returns the formatted calendar string, or "" on invalid input
  *
- * @example formatCalendarUnix(1710685845000, "en-US", { epochUnit: "milliseconds", timeZone: "America/New_York" }) // day label + time relative to "now", or the absolute fallback beyond the ±6-day threshold
- * @example formatCalendarUnix(1710772200000, "en-US", { reference: 1710685000000, timeZone: "UTC" }) // "tomorrow at 2:30 PM"
- * @example formatCalendarUnix("1710772200", "en-US", { reference: "1710685000", epochUnit: "second" }) // "tomorrow at 2:30 PM"
- * @example formatCalendarUnix(1710772200000, "en-US", { reference: 1710685000000, timeZone: "America/New_Yrok" }) // "" (unknown zone)
- * @example formatCalendarUnix(1710772200000, "en-US", null as never) // ""
+ * @example formatCalendarUnix(1710685845000, "ja-JP", { epochUnit: "milliseconds", timeZone: "Asia/Tokyo" }) // day label + time relative to "now", or the absolute fallback beyond the ±6-day threshold
+ * @example formatCalendarUnix(1710772200000, "en-GB", { reference: 1710685000000, timeZone: "UTC" }) // "tomorrow at 14:30"
+ * @example formatCalendarUnix("1710772200", "de-DE", { reference: "1710685000", epochUnit: "second" }) // "morgen um 14:30"
+ * @example formatCalendarUnix(1710772200000, "fr-FR", { reference: 1710685000000, timeZone: "Australia/Sidney" }) // "" (unknown zone)
+ * @example formatCalendarUnix(1710772200000, "hi-IN", null as never) // ""
  * @example formatCalendarUnix("not-a-number") // ""
  * @example formatCalendarUnix(1710613800000, ["fr-FR", "en-US"], { reference: 1710507600000 }) // "demain à 18:30"
  */

package/dist/unix/format/formatRelativeUnix.d.ts

@@ -88,14 +88,14 @@ export interface FormatRelativeUnixOptions {
  * @param options optional: the wording, the unit and rounding of the distance, and what it is measured from
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeUnix(1710685845000, "en-US", { epochUnit: "milliseconds", reference: 1805358645000 }) // "3 years ago"
- * @example formatRelativeUnix(1710685845000, "en-US", { epochUnit: "milliseconds", reference: 1805358645000, largestUnit: "day" }) // "1,096 days ago"
- * @example formatRelativeUnix(0, "en-US", { reference: 37800000, roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
- * @example formatRelativeUnix("0", "en-US", { reference: "1800", epochUnit: "second", largestUnit: "minutes" }) // "30 minutes ago"
- * @example formatRelativeUnix(0, "en-US", { reference: 1800000, timeZone: "Invalid/Zone" }) // ""
- * @example formatRelativeUnix(0, "en-US", null as never) // ""
+ * @example formatRelativeUnix(1710685845000, "en-GB", { epochUnit: "milliseconds", reference: 1805358645000 }) // "3 years ago"
+ * @example formatRelativeUnix(1710685845000, "de-DE", { epochUnit: "milliseconds", reference: 1805358645000, largestUnit: "day" }) // "vor 1.096 Tagen"
+ * @example formatRelativeUnix(0, "en-GB", { reference: 37800000, roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
+ * @example formatRelativeUnix("0", "ja-JP", { reference: "1800", epochUnit: "second", largestUnit: "minutes" }) // "30 分前"
+ * @example formatRelativeUnix(0, "zh-CN", { reference: 1800000, timeZone: "Invalid/Zone" }) // ""
+ * @example formatRelativeUnix(0, "pt-BR", null as never) // ""
  * @example formatRelativeUnix("not-a-number") // ""
  * @example formatRelativeUnix(1709163000000, ["fr-FR", "en-US"], { reference: 1709164800000 }) // "il y a 30 minutes"
- * @example formatRelativeUnix(218670000, "en-US", { reference: 45870000, timeZone: "-00:44:30" }) // "in 2 days" (a stored offset with seconds)
+ * @example formatRelativeUnix(218670000, "en-GB", { reference: 45870000, timeZone: "-00:44:30" }) // "in 2 days" (a stored offset with seconds)
  */
 export declare function formatRelativeUnix(value: string | number, locale?: string | string[], options?: FormatRelativeUnixOptions): string;

package/dist/unix/format/formatRelativeUnix.js

@@ -32,15 +32,15 @@ import { isObject } from "../../internal/isObject.js";
  * @param options optional: the wording, the unit and rounding of the distance, and what it is measured from
  * @returns the formatted relative-time string, or "" on invalid input
  *
- * @example formatRelativeUnix(1710685845000, "en-US", { epochUnit: "milliseconds", reference: 1805358645000 }) // "3 years ago"
- * @example formatRelativeUnix(1710685845000, "en-US", { epochUnit: "milliseconds", reference: 1805358645000, largestUnit: "day" }) // "1,096 days ago"
- * @example formatRelativeUnix(0, "en-US", { reference: 37800000, roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
- * @example formatRelativeUnix("0", "en-US", { reference: "1800", epochUnit: "second", largestUnit: "minutes" }) // "30 minutes ago"
- * @example formatRelativeUnix(0, "en-US", { reference: 1800000, timeZone: "Invalid/Zone" }) // ""
- * @example formatRelativeUnix(0, "en-US", null as never) // ""
+ * @example formatRelativeUnix(1710685845000, "en-GB", { epochUnit: "milliseconds", reference: 1805358645000 }) // "3 years ago"
+ * @example formatRelativeUnix(1710685845000, "de-DE", { epochUnit: "milliseconds", reference: 1805358645000, largestUnit: "day" }) // "vor 1.096 Tagen"
+ * @example formatRelativeUnix(0, "en-GB", { reference: 37800000, roundingMethod: "floor" }) // "11 hours ago" (−10.5 hours floors to −11; the default rounds to 10)
+ * @example formatRelativeUnix("0", "ja-JP", { reference: "1800", epochUnit: "second", largestUnit: "minutes" }) // "30 分前"
+ * @example formatRelativeUnix(0, "zh-CN", { reference: 1800000, timeZone: "Invalid/Zone" }) // ""
+ * @example formatRelativeUnix(0, "pt-BR", null as never) // ""
  * @example formatRelativeUnix("not-a-number") // ""
  * @example formatRelativeUnix(1709163000000, ["fr-FR", "en-US"], { reference: 1709164800000 }) // "il y a 30 minutes"
- * @example formatRelativeUnix(218670000, "en-US", { reference: 45870000, timeZone: "-00:44:30" }) // "in 2 days" (a stored offset with seconds)
+ * @example formatRelativeUnix(218670000, "en-GB", { reference: 45870000, timeZone: "-00:44:30" }) // "in 2 days" (a stored offset with seconds)
  */
 export function formatRelativeUnix(value, locale, options = {}) {
     try {

package/dist/unix/format/formatUnix.d.ts

@@ -52,18 +52,18 @@ export interface FormatUnixOptions extends Intl.DateTimeFormatOptions {
  * @param options optional: `Intl.DateTimeFormatOptions` fields, plus how `value` is read, the zone and whether its name is shown
  * @returns the formatted date/time string, or "" on invalid input
  *
- * @example formatUnix("1710685845000", "en-US", { epochUnit: "milliseconds" }) // "3/17/2024, 2:30:45 PM"
- * @example formatUnix(1710685845000, "en-US", { epochUnit: "milliseconds" }) // "3/17/2024, 2:30:45 PM"
- * @example formatUnix("1710685845", "en-US", { epochUnit: "seconds" }) // "3/17/2024, 2:30:45 PM"
- * @example formatUnix("1710685845000", "en-US", { epochUnit: "milliseconds", includeTimeZoneName: true }) // "3/17/2024, 2:30:45 PM UTC"
+ * @example formatUnix("1710685845000", "en-GB", { epochUnit: "milliseconds" }) // "17/03/2024, 14:30:45"
+ * @example formatUnix(1710685845000, "ja-JP", { epochUnit: "milliseconds" }) // "2024/3/17 14:30:45"
+ * @example formatUnix("1710685845", "de-DE", { epochUnit: "seconds" }) // "17.3.2024, 14:30:45"
+ * @example formatUnix("1710685845000", "en-GB", { epochUnit: "milliseconds", includeTimeZoneName: true }) // "17/03/2024, 14:30:45 UTC"
  * @example formatUnix(1706970645, "ja-JP-u-ca-japanese", { epochUnit: "seconds", year: "numeric", month: "long" }) // "令和6年2月"
  * @example formatUnix(1706970645, "ja-JP-u-ca-japanese", { epochUnit: "seconds", year: "numeric", month: "numeric" }) // "R6/2" — the pre-1.16.0 text
- * @example formatUnix(1706970645, "en-US", { epochUnit: "seconds", era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM"
- * @example formatUnix(1706970645, "en-US", { epochUnit: "seconds", era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "2/3/2024 Anno Domini" — the pre-1.16.0 text
- * @example formatUnix(0, "en-US", { timeZoneName: "short" }) // "1/1/1970, 12:00:00 AM"
- * @example formatUnix(1710685845000, "en-US", { timeZone: "America/New_Yrok" }) // "" (unknown zone)
+ * @example formatUnix(1706970645, "en-GB", { epochUnit: "seconds", era: "long" }) // "03/02/2024 Anno Domini, 14:30:45"
+ * @example formatUnix(1706970645, "en-GB", { epochUnit: "seconds", era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "03/02/2024 Anno Domini" — the pre-1.16.0 text
+ * @example formatUnix(0, "fr-FR", { timeZoneName: "short" }) // "01/01/1970 00:00:00"
+ * @example formatUnix(1710685845000, "zh-CN", { timeZone: "Asia/Tokio" }) // "" (unknown zone)
  * @example formatUnix("1710685845000.0") // "" (not a digit string)
- * @example formatUnix(0, "en-US", null as never) // "" (null options, as ECMA-402 rejects them)
+ * @example formatUnix(0, "pt-BR", null as never) // "" (null options, as ECMA-402 rejects them)
  * @example formatUnix("not-a-number") // ""
  * @example formatUnix(1710685845000, ["fr-FR", "en-US"], { dateStyle: "long" }) // "17 mars 2024"
  */

package/dist/unix/format/formatUnix.js

@@ -30,18 +30,18 @@ import { optionOrDefault } from "../../internal/optionOrDefault.js";
  * @param options optional: `Intl.DateTimeFormatOptions` fields, plus how `value` is read, the zone and whether its name is shown
  * @returns the formatted date/time string, or "" on invalid input
  *
- * @example formatUnix("1710685845000", "en-US", { epochUnit: "milliseconds" }) // "3/17/2024, 2:30:45 PM"
- * @example formatUnix(1710685845000, "en-US", { epochUnit: "milliseconds" }) // "3/17/2024, 2:30:45 PM"
- * @example formatUnix("1710685845", "en-US", { epochUnit: "seconds" }) // "3/17/2024, 2:30:45 PM"
- * @example formatUnix("1710685845000", "en-US", { epochUnit: "milliseconds", includeTimeZoneName: true }) // "3/17/2024, 2:30:45 PM UTC"
+ * @example formatUnix("1710685845000", "en-GB", { epochUnit: "milliseconds" }) // "17/03/2024, 14:30:45"
+ * @example formatUnix(1710685845000, "ja-JP", { epochUnit: "milliseconds" }) // "2024/3/17 14:30:45"
+ * @example formatUnix("1710685845", "de-DE", { epochUnit: "seconds" }) // "17.3.2024, 14:30:45"
+ * @example formatUnix("1710685845000", "en-GB", { epochUnit: "milliseconds", includeTimeZoneName: true }) // "17/03/2024, 14:30:45 UTC"
  * @example formatUnix(1706970645, "ja-JP-u-ca-japanese", { epochUnit: "seconds", year: "numeric", month: "long" }) // "令和6年2月"
  * @example formatUnix(1706970645, "ja-JP-u-ca-japanese", { epochUnit: "seconds", year: "numeric", month: "numeric" }) // "R6/2" — the pre-1.16.0 text
- * @example formatUnix(1706970645, "en-US", { epochUnit: "seconds", era: "long" }) // "2/3/2024 Anno Domini, 2:30:45 PM"
- * @example formatUnix(1706970645, "en-US", { epochUnit: "seconds", era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "2/3/2024 Anno Domini" — the pre-1.16.0 text
- * @example formatUnix(0, "en-US", { timeZoneName: "short" }) // "1/1/1970, 12:00:00 AM"
- * @example formatUnix(1710685845000, "en-US", { timeZone: "America/New_Yrok" }) // "" (unknown zone)
+ * @example formatUnix(1706970645, "en-GB", { epochUnit: "seconds", era: "long" }) // "03/02/2024 Anno Domini, 14:30:45"
+ * @example formatUnix(1706970645, "en-GB", { epochUnit: "seconds", era: "long", year: "numeric", month: "numeric", day: "numeric" }) // "03/02/2024 Anno Domini" — the pre-1.16.0 text
+ * @example formatUnix(0, "fr-FR", { timeZoneName: "short" }) // "01/01/1970 00:00:00"
+ * @example formatUnix(1710685845000, "zh-CN", { timeZone: "Asia/Tokio" }) // "" (unknown zone)
  * @example formatUnix("1710685845000.0") // "" (not a digit string)
- * @example formatUnix(0, "en-US", null as never) // "" (null options, as ECMA-402 rejects them)
+ * @example formatUnix(0, "pt-BR", null as never) // "" (null options, as ECMA-402 rejects them)
  * @example formatUnix("not-a-number") // ""
  * @example formatUnix(1710685845000, ["fr-FR", "en-US"], { dateStyle: "long" }) // "17 mars 2024"
  */

package/dist/unix/get/getUnixDay.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current day from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixHour.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current hour from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixMicrosecond.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current microsecond from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixMillisecond.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current millisecond from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixMinute.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current minute from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixMonth.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current month from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixNanosecond.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current nanosecond from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixNow.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { resolveUnixEpochUnitOptions, toUnixEpoch, } from "../../internal/unixEpochValue.js";
 /**
  * Return the current Unix timestamp in either seconds or milliseconds.

package/dist/unix/get/getUnixNowUnit.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { UnixNowUnit } from "../../types/index.js";
 export type { UnixNowUnit };
 /**

package/dist/unix/get/getUnixNowUnit.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isoWeekOfYear, zonedNowUnitValue, } from "../../internal/zonedNowUnitValue.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { isValidDateTimeUnit } from "../../plain/validate/index.js";

package/dist/unix/get/getUnixSecond.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the current second from the Unix timestamp in UTC as a zero-padded string.
  *

package/dist/unix/get/getUnixYear.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isoYearString } from "../../internal/isoYearString.js";
 /**
  * Return the current year from the Unix timestamp in UTC as a zero-padded string.

package/dist/unix/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/unix/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/unix/interval/intervalFromDurationUnix.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 { isValidDuration } from "../../duration/validate/index.js";
 import { addToZoned, frameInstant, frameZoned, normalizeZoneFrame, resolveOverflow, subtractFromZoned, } from "../../internal/index.js";
 import { resolveUnixEpochUnit, toUnixEpoch, unixEpochToInstant, } from "../../internal/unixEpochValue.js";

package/dist/unix/interval/intervalLengthUnix.d.ts

@@ -6,7 +6,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  *   rather than measuring exact duration.
  * - `start` and `end` are each a safe integer or a string of optionally negative ASCII digits.
  * - Fixed-length units (hour, minute, second, …) are zone-independent; a day is a local day in
- *   `options.timeZone`, so New York's 23-hour 2024-03-10 is 1 day long there.
+ *   `options.timeZone`, so Sydney's 23-hour 2024-10-06 is 1 day long there.
  * - Accepts singular or plural units (`"day"` and `"days"` behave identically).
  * - Returns `0` for a zero-length interval (`start === end`).
  * - Returns `null` on invalid input (`start`/`end` that is not a safe integer or numeric string of
@@ -29,7 +29,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example intervalLengthUnix(0, 5400000, "hour") // 1.5
  * @example intervalLengthUnix(0, 0, "hour") // 0
  * @example intervalLengthUnix(86400000, 0, "hour") // null
- * @example intervalLengthUnix(1710046800000, 1710129600000, "day", { timeZone: "America/New_York" }) // 1 (the 23-hour local day)
+ * @example intervalLengthUnix(1728136800000, 1728219600000, "day", { timeZone: "Australia/Sydney" }) // 1 (the 23-hour local day)
  * @example intervalLengthUnix(1710046800000, 1710129600000, "day") // 0.9583333333333334 (23/24 of a UTC day)
  * @example intervalLengthUnix("0", "86400", "hours", { epochUnit: "second" }) // 24
  * @example intervalLengthUnix(NaN, 86400000, "hour") // null

package/dist/unix/interval/intervalLengthUnix.js

@@ -9,7 +9,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   rather than measuring exact duration.
  * - `start` and `end` are each a safe integer or a string of optionally negative ASCII digits.
  * - Fixed-length units (hour, minute, second, …) are zone-independent; a day is a local day in
- *   `options.timeZone`, so New York's 23-hour 2024-03-10 is 1 day long there.
+ *   `options.timeZone`, so Sydney's 23-hour 2024-10-06 is 1 day long there.
  * - Accepts singular or plural units (`"day"` and `"days"` behave identically).
  * - Returns `0` for a zero-length interval (`start === end`).
  * - Returns `null` on invalid input (`start`/`end` that is not a safe integer or numeric string of
@@ -32,7 +32,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example intervalLengthUnix(0, 5400000, "hour") // 1.5
  * @example intervalLengthUnix(0, 0, "hour") // 0
  * @example intervalLengthUnix(86400000, 0, "hour") // null
- * @example intervalLengthUnix(1710046800000, 1710129600000, "day", { timeZone: "America/New_York" }) // 1 (the 23-hour local day)
+ * @example intervalLengthUnix(1728136800000, 1728219600000, "day", { timeZone: "Australia/Sydney" }) // 1 (the 23-hour local day)
  * @example intervalLengthUnix(1710046800000, 1710129600000, "day") // 0.9583333333333334 (23/24 of a UTC day)
  * @example intervalLengthUnix("0", "86400", "hours", { epochUnit: "second" }) // 24
  * @example intervalLengthUnix(NaN, 86400000, "hour") // null

package/dist/unix/interval/splitIntervalByUnitUnix.d.ts

@@ -11,7 +11,8 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  *   lands on February 29, March 31, April 30. Temporal's `add` constrains a day the month lacks
  *   to the month's last day, and stepping from that boundary would keep the shortened day
  *   (February 29, then March 29).
- * - Comparison: Luxon's `Interval.splitBy` computes each boundary from the start the same way.
+ * - Each calendar-unit boundary is `start.add(amount × k)` with Temporal's
+ *   `overflow: "constrain"` (TC39 Temporal `add`), never a step from the previous boundary.
  * - Exact-unit boundaries (hours and smaller) step from the previous boundary. Exact units never
  *   clamp, and stepping keeps nanosecond precision where `k × amount` would pass
  *   `Number.MAX_SAFE_INTEGER` (boundaries are then floored to milliseconds).
@@ -52,7 +53,7 @@ import type { UnixUnit } from "../validate/isValidUnixUnit.js";
  * @example splitIntervalByUnitUnix("invalid", 86400000, "hour", 1) // []
  * @example splitIntervalByUnitUnix(0, 86400000, "hour", 6, { maxPieces: 3 }) // [] (4 slices exceed the limit)
  * @example splitIntervalByUnitUnix(0, 86400000, "hour", 6, { maxPieces: 4 }) // [{ start: 0, end: 21600000 }, { start: 21600000, end: 43200000 }, { start: 43200000, end: 64800000 }, { start: 64800000, end: 86400000 }]
- * @example splitIntervalByUnitUnix(1710046800000, 1710216000000, "day", 1, { timeZone: "America/New_York" }) // [{ start: 1710046800000, end: 1710129600000 }, { start: 1710129600000, end: 1710216000000 }] (the first local day is 23 hours)
+ * @example splitIntervalByUnitUnix(1728136800000, 1728306000000, "day", 1, { timeZone: "Australia/Sydney" }) // [{ start: 1728136800000, end: 1728219600000 }, { start: 1728219600000, end: 1728306000000 }] (the first local day is 23 hours)
  * @example splitIntervalByUnitUnix("0", "86400", "hours", 12, { epochUnit: "second" }) // [{ start: 0, end: 43200 }, { start: 43200, end: 86400 }]
  * @example splitIntervalByUnitUnix(0, 2, "millisecond", 500, { epochUnit: "seconds" }) // [{ start: 0, end: 1 }, { start: 1, end: 2 }] (a step finer than the epoch unit gives one-second pieces)
  */

package/dist/unix/interval/splitIntervalByUnitUnix.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 { frameInstant, resolveDurationUnit, tileByUnit } from "../../internal/index.js";
 import { exceedsPieceLimit, resolveMaxPieces } from "../../internal/maxPieces.js";
 import { resolveUnixIntervalPair } from "../../internal/resolveUnixIntervalPair.js";
@@ -17,7 +17,8 @@ import { toUnixEpoch } from "../../internal/unixEpochValue.js";
  *   lands on February 29, March 31, April 30. Temporal's `add` constrains a day the month lacks
  *   to the month's last day, and stepping from that boundary would keep the shortened day
  *   (February 29, then March 29).
- * - Comparison: Luxon's `Interval.splitBy` computes each boundary from the start the same way.
+ * - Each calendar-unit boundary is `start.add(amount × k)` with Temporal's
+ *   `overflow: "constrain"` (TC39 Temporal `add`), never a step from the previous boundary.
  * - Exact-unit boundaries (hours and smaller) step from the previous boundary. Exact units never
  *   clamp, and stepping keeps nanosecond precision where `k × amount` would pass
  *   `Number.MAX_SAFE_INTEGER` (boundaries are then floored to milliseconds).
@@ -58,7 +59,7 @@ import { toUnixEpoch } from "../../internal/unixEpochValue.js";
  * @example splitIntervalByUnitUnix("invalid", 86400000, "hour", 1) // []
  * @example splitIntervalByUnitUnix(0, 86400000, "hour", 6, { maxPieces: 3 }) // [] (4 slices exceed the limit)
  * @example splitIntervalByUnitUnix(0, 86400000, "hour", 6, { maxPieces: 4 }) // [{ start: 0, end: 21600000 }, { start: 21600000, end: 43200000 }, { start: 43200000, end: 64800000 }, { start: 64800000, end: 86400000 }]
- * @example splitIntervalByUnitUnix(1710046800000, 1710216000000, "day", 1, { timeZone: "America/New_York" }) // [{ start: 1710046800000, end: 1710129600000 }, { start: 1710129600000, end: 1710216000000 }] (the first local day is 23 hours)
+ * @example splitIntervalByUnitUnix(1728136800000, 1728306000000, "day", 1, { timeZone: "Australia/Sydney" }) // [{ start: 1728136800000, end: 1728219600000 }, { start: 1728219600000, end: 1728306000000 }] (the first local day is 23 hours)
  * @example splitIntervalByUnitUnix("0", "86400", "hours", 12, { epochUnit: "second" }) // [{ start: 0, end: 43200 }, { start: 43200, end: 86400 }]
  * @example splitIntervalByUnitUnix(0, 2, "millisecond", 500, { epochUnit: "seconds" }) // [{ start: 0, end: 1 }, { start: 1, end: 2 }] (a step finer than the epoch unit gives one-second pieces)
  */

package/dist/unix/parse/parseUnitFromUnix.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/index.js";
 /**
  * Units extractable from a unix epoch value via `parseUnitFromUnix`. Covers the

package/dist/utc/calculate/addUtc.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { readDurationUnits, resolveOverflow } from "../../internal/index.js";
 import { isValidDateTimeDurationUnit } from "../../plain/validate/index.js";
 import { isValidUtc } from "../validate/isValidUtc.js";

package/dist/utc/calculate/diffUtc.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { DateTimeDurationUnit, RoundingOptions } from "../../types/index.js";
 /**
  * Return the difference between two UTC datetimes measured in the given date-time unit.

package/dist/utc/calculate/diffUtc.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 { addToZoned, zonedUntil } from "../../internal/index.js";
 import { differenceRecord } from "../../internal/differenceRecord.js";
 import { resolveDurationUnit } from "../../internal/resolveDurationUnit.js";

package/dist/utc/calculate/diffUtcAsDuration.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { DateTimeDurationUnit, DurationStringOptions, RoundingOptions } from "../../types/index.js";
 /**
  * Return the difference between two UTC datetimes as an ISO 8601 duration string,

package/dist/utc/calculate/diffUtcAsDuration.js

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

package/dist/utc/calculate/endOfQuarterForUtc.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidUtc } from "../validate/isValidUtc.js";
 /**
  * Return the end of the quarter for a given UTC Instant string.

package/dist/utc/calculate/endOfUtc.d.ts

@@ -1,4 +1,4 @@
-import type { Temporal } from "@js-temporal/polyfill";
+import type { Temporal } from "../../internal/temporal.js";
 import type { FractionalDigit } from "../../types/index.js";
 /**
  * Return the end of the specified date-time `unit` for a given UTC datetime string.