@northguild/gmt 1.18.0 → 1.20.0

package/dist/plain/calculate/previousWeekday.js

@@ -1,27 +1,29 @@
 // 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 { advanceToWeekday, isValidDayOfWeek } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
- * Return a PlainDate ISO string for the previous occurrence of `dayOfWeek` on or before `value`.
+ * Return a PlainDate ISO string for the previous occurrence of `dayOfWeek` before `value` (or on
+ * it, with `inclusive: true`).
  *
  * - `dayOfWeek` uses Temporal's ISO numbering: 1 (Monday) through 7 (Sunday), consistent with
  *   `getDayOfWeek`/`parseDayOfWeekFromDate`.
  * - Returns "" on invalid input.
  *
- * Replaces date-fns's sixteen `previous*` functions with one parameterized call:
+ * Migrating from date-fns: its eight `previous*` functions map to one parameterized call.
+ * date-fns numbers days 0 (Sunday) to 6 (Saturday), so `previousDay`'s 0 becomes 7.
  *
- * | date-fns              | gmt                              |
- * | ---------------------- | --------------------------------- |
- * | `previousMonday`      | `previousWeekday(value, 1)`      |
- * | `previousTuesday`     | `previousWeekday(value, 2)`      |
- * | `previousWednesday`   | `previousWeekday(value, 3)`      |
- * | `previousThursday`    | `previousWeekday(value, 4)`      |
- * | `previousFriday`      | `previousWeekday(value, 5)`      |
- * | `previousSaturday`    | `previousWeekday(value, 6)`      |
- * | `previousSunday`      | `previousWeekday(value, 7)`      |
- * | `previousDay(v, n)`   | `previousWeekday(value, n)`      |
+ * | date-fns            | gmt                                       |
+ * | ------------------- | ----------------------------------------- |
+ * | `previousMonday`    | `previousWeekday(value, 1)`               |
+ * | `previousTuesday`   | `previousWeekday(value, 2)`               |
+ * | `previousWednesday` | `previousWeekday(value, 3)`               |
+ * | `previousThursday`  | `previousWeekday(value, 4)`               |
+ * | `previousFriday`    | `previousWeekday(value, 5)`               |
+ * | `previousSaturday`  | `previousWeekday(value, 6)`               |
+ * | `previousSunday`    | `previousWeekday(value, 7)`               |
+ * | `previousDay(v, n)` | `previousWeekday(value, n === 0 ? 7 : n)` |
  *
  * @param value ISO PlainDate string
  * @param dayOfWeek target ISO day of week (1-7, Monday-Sunday)

package/dist/plain/calculate/roundDate.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { DateUnit } from "../../types/index.js";
 /**
  * Round an ISO 8601 date string to the specified date unit.

package/dist/plain/calculate/roundDate.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 { addDateUnit, getDaysIntoDateUnit, getStartOfDateUnit, getStartOfNextDateUnit, } from "../../internal/dateUnitHelpers.js";
 import { measureNearRangeEnd } from "../../internal/measureNearRangeEnd.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";

package/dist/plain/calculate/roundDateTime.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { DateTimeUnit } from "../../types/index.js";
 /**
  * Round an ISO 8601 datetime string to the specified date-time unit.

package/dist/plain/calculate/roundDateTime.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 { defaultFractionalDigits, isObject, resolveDateTimeUnit, } from "../../internal/index.js";
 import { addDateTimeUnit, getStartOfDateTimeUnit, getStartOfNextDateTimeUnit, } from "../../internal/dateTimeUnitHelpers.js";
 import { getDaysIntoDateUnit } from "../../internal/dateUnitHelpers.js";

package/dist/plain/calculate/roundTime.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Round an ISO 8601 time string to the specified time unit.
  *

package/dist/plain/calculate/roundTime.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 { defaultFractionalDigits, isObject, resolveDateTimeUnit, } from "../../internal/index.js";
 import { isValidTime, isValidTimeUnit } from "../validate/index.js";
 /**

package/dist/plain/calculate/setDate.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { Overflow } from "../../types/index.js";
 /**
  * Return a PlainDate ISO string with the given `fields` set on `value`.
@@ -8,8 +8,20 @@ import type { Overflow } from "../../types/index.js";
  *   field-by-field: each sequential `.add()` resolves overflow against its own intermediate
  *   value, so setting month-then-day vs. day-then-month on the same target can silently
  *   diverge — `.with()` has no such order-dependence.
- * - `fields` may set `year`, `month`, `monthCode`, `day`, `era`, and/or `eraYear`; omitted
- *   fields keep their current value. An empty object is a no-op.
+ * - `fields` may set `year`, `month`, `monthCode` and/or `day`; omitted fields keep their current
+ *   value. An object with no field set, such as `{}` or `{ year: undefined }`, is a no-op.
+ * - Values are not converted: `year`, `month` and `day` must be integer numbers and `monthCode` a
+ *   string. `null`, a numeric string, a boolean or a fraction returns "", where Temporal would
+ *   convert or truncate it. A bigint, `NaN` or an infinity returns "" too. A number too large for
+ *   its field follows `overflow`. A month or day below 1, or a date outside Temporal's range,
+ *   returns "".
+ * - An own key that is not one of these fields, such as a misspelt `yaer`, returns "". So does a
+ *   field this function does not take, such as `hour`, or a `calendar` or `timeZone` property,
+ *   whether own, inherited or a getter. A field is read with a property get, as Temporal reads it,
+ *   so an inherited or getter field is set.
+ * - A Temporal date or time object returns "", as Temporal's `with` refuses one. One whose
+ *   prototype has been replaced with `Object.prototype`, `null` or `Function.prototype` sets
+ *   nothing instead.
  * - Returns "" for invalid input.
  *
  * @param value ISO PlainDate string
@@ -20,10 +32,15 @@ import type { Overflow } from "../../types/index.js";
  * @example setDate("2024-03-10", { year: 2025 }) // "2025-03-10"
  * @example setDate("2024-01-31", { month: 2 }) // "2024-02-29" (constrain clamps to the last valid day)
  * @example setDate("2024-01-31", { month: 2 }, { overflow: "reject" }) // ""
+ * @example setDate("2024-01-31", { month: 13 }) // "2024-12-31" (too large: constrain clamps it)
+ * @example setDate("2024-01-31", { month: 0 }) // "" (below 1, under either overflow)
  * @example setDate("2024-03-10", {}) // "2024-03-10" (empty fields object is a no-op)
+ * @example setDate("2024-01-31", { year: "2025" }) // "" (not converted)
+ * @example setDate("2024-01-31", { year: 2025, yaer: 1 }) // "" (misspelt key)
+ * @example setDate("2024-03-10", { year: 2025, hour: 5 }) // "" (setDate takes no hour)
  * @example setDate("invalid", { year: 2025 }) // ""
  */
-export declare function setDate(value: string, fields: Omit<Temporal.PlainDateLike, "calendar">, options?: {
+export declare function setDate(value: string, fields: Omit<Temporal.PlainDateLike, "calendar" | "era" | "eraYear">, options?: {
     /**
      * What to do when the fields do not form a real date. `"constrain"` clamps to the last valid
      * day, so `month: 2` on the 31st gives Feb 29 or 28; `"reject"` returns `""`.

package/dist/plain/calculate/setDate.js

@@ -1,5 +1,5 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { resolveOverflow } from "../../internal/index.js";
+import { Temporal } from "../../internal/temporal.js";
+import { DATE_FIELDS, readSetFields, resolveOverflow } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -10,8 +10,20 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   field-by-field: each sequential `.add()` resolves overflow against its own intermediate
  *   value, so setting month-then-day vs. day-then-month on the same target can silently
  *   diverge — `.with()` has no such order-dependence.
- * - `fields` may set `year`, `month`, `monthCode`, `day`, `era`, and/or `eraYear`; omitted
- *   fields keep their current value. An empty object is a no-op.
+ * - `fields` may set `year`, `month`, `monthCode` and/or `day`; omitted fields keep their current
+ *   value. An object with no field set, such as `{}` or `{ year: undefined }`, is a no-op.
+ * - Values are not converted: `year`, `month` and `day` must be integer numbers and `monthCode` a
+ *   string. `null`, a numeric string, a boolean or a fraction returns "", where Temporal would
+ *   convert or truncate it. A bigint, `NaN` or an infinity returns "" too. A number too large for
+ *   its field follows `overflow`. A month or day below 1, or a date outside Temporal's range,
+ *   returns "".
+ * - An own key that is not one of these fields, such as a misspelt `yaer`, returns "". So does a
+ *   field this function does not take, such as `hour`, or a `calendar` or `timeZone` property,
+ *   whether own, inherited or a getter. A field is read with a property get, as Temporal reads it,
+ *   so an inherited or getter field is set.
+ * - A Temporal date or time object returns "", as Temporal's `with` refuses one. One whose
+ *   prototype has been replaced with `Object.prototype`, `null` or `Function.prototype` sets
+ *   nothing instead.
  * - Returns "" for invalid input.
  *
  * @param value ISO PlainDate string
@@ -22,7 +34,12 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example setDate("2024-03-10", { year: 2025 }) // "2025-03-10"
  * @example setDate("2024-01-31", { month: 2 }) // "2024-02-29" (constrain clamps to the last valid day)
  * @example setDate("2024-01-31", { month: 2 }, { overflow: "reject" }) // ""
+ * @example setDate("2024-01-31", { month: 13 }) // "2024-12-31" (too large: constrain clamps it)
+ * @example setDate("2024-01-31", { month: 0 }) // "" (below 1, under either overflow)
  * @example setDate("2024-03-10", {}) // "2024-03-10" (empty fields object is a no-op)
+ * @example setDate("2024-01-31", { year: "2025" }) // "" (not converted)
+ * @example setDate("2024-01-31", { year: 2025, yaer: 1 }) // "" (misspelt key)
+ * @example setDate("2024-03-10", { year: 2025, hour: 5 }) // "" (setDate takes no hour)
  * @example setDate("invalid", { year: 2025 }) // ""
  */
 export function setDate(value, fields, options) {
@@ -33,12 +50,15 @@ export function setDate(value, fields, options) {
         return "";
     try {
         const date = Temporal.PlainDate.from(value);
-        // Temporal.PlainDate.prototype.with() throws on an empty fields object ("no supported
-        // properties found") rather than treating it as a no-op, so short-circuit here.
-        if (Object.keys(fields).length === 0)
+        const set = readSetFields(fields, DATE_FIELDS);
+        if (set === null)
+            return "";
+        // Only the values readSetFields checked reach Temporal. An empty result sets nothing: a
+        // no-op here, where Temporal's with() would throw.
+        if (Object.keys(set).length === 0)
             return date.toString();
         return date
-            .with(fields, { overflow: resolveOverflow(options?.overflow) })
+            .with(set, { overflow: resolveOverflow(options?.overflow) })
             .toString();
     }
     catch {

package/dist/plain/calculate/setDateTime.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { Overflow } from "../../types/index.js";
 /**
  * Return a PlainDateTime ISO string with the given `fields` set on `value`.
@@ -7,8 +7,19 @@ import type { Overflow } from "../../types/index.js";
  *   single atomic overflow pass — see `setDate`'s doc for why that matters over composing
  *   `addDateTime()` calls field-by-field.
  * - `fields` may set any of `year`, `month`, `monthCode`, `day`, `hour`, `minute`, `second`,
- *   `millisecond`, `microsecond`, `nanosecond`, `era`, and/or `eraYear`; omitted fields keep
- *   their current value. An empty object is a no-op.
+ *   `millisecond`, `microsecond` and/or `nanosecond`; omitted fields keep their current value. An
+ *   object with no field set, such as `{}` or `{ year: undefined }`, is a no-op.
+ * - Values are not converted: `monthCode` must be a string and every other field an integer number.
+ *   `null`, a numeric string, a boolean or a fraction returns "", where Temporal would convert or
+ *   truncate it. A bigint, `NaN` or an infinity returns "" too. A number too large for its
+ *   field follows `overflow`. A month or day below 1, or a date outside Temporal's range, returns
+ *   "".
+ * - An own key that is not one of these fields, such as a misspelt `yaer`, returns "". So does an
+ *   era, or a `calendar` or `timeZone` property, whether own, inherited or a getter. A field is
+ *   read with a property get, as Temporal reads it, so an inherited or getter field is set.
+ * - A Temporal date or time object returns "", as Temporal's `with` refuses one. One whose
+ *   prototype has been replaced with `Object.prototype`, `null` or `Function.prototype` sets
+ *   nothing instead.
  * - Returns "" for invalid input.
  *
  * @param value ISO PlainDateTime string
@@ -20,9 +31,10 @@ import type { Overflow } from "../../types/index.js";
  * @example setDateTime("2024-01-31T12:00:00", { month: 2 }) // "2024-02-29T12:00:00" (constrain clamps to the last valid day)
  * @example setDateTime("2024-01-31T12:00:00", { month: 2 }, { overflow: "reject" }) // ""
  * @example setDateTime("2024-03-10T12:00:00", {}) // "2024-03-10T12:00:00" (empty fields object is a no-op)
+ * @example setDateTime("2024-03-10T12:00:00", { hour: "9" }) // "" (not converted)
  * @example setDateTime("invalid", { hour: 9 }) // ""
  */
-export declare function setDateTime(value: string, fields: Omit<Temporal.PlainDateTimeLike, "calendar">, options?: {
+export declare function setDateTime(value: string, fields: Omit<Temporal.PlainDateTimeLike, "calendar" | "era" | "eraYear">, options?: {
     /**
      * What to do when the fields do not form a real date-time. `"constrain"` clamps each field to
      * its nearest valid value, so `month: 2` on the 31st gives Feb 29 or 28; `"reject"` returns

package/dist/plain/calculate/setDateTime.js

@@ -1,5 +1,5 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { resolveOverflow } from "../../internal/index.js";
+import { Temporal } from "../../internal/temporal.js";
+import { DATE_TIME_FIELDS, readSetFields, resolveOverflow, } from "../../internal/index.js";
 import { isValidDateTime } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -9,8 +9,19 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   single atomic overflow pass — see `setDate`'s doc for why that matters over composing
  *   `addDateTime()` calls field-by-field.
  * - `fields` may set any of `year`, `month`, `monthCode`, `day`, `hour`, `minute`, `second`,
- *   `millisecond`, `microsecond`, `nanosecond`, `era`, and/or `eraYear`; omitted fields keep
- *   their current value. An empty object is a no-op.
+ *   `millisecond`, `microsecond` and/or `nanosecond`; omitted fields keep their current value. An
+ *   object with no field set, such as `{}` or `{ year: undefined }`, is a no-op.
+ * - Values are not converted: `monthCode` must be a string and every other field an integer number.
+ *   `null`, a numeric string, a boolean or a fraction returns "", where Temporal would convert or
+ *   truncate it. A bigint, `NaN` or an infinity returns "" too. A number too large for its
+ *   field follows `overflow`. A month or day below 1, or a date outside Temporal's range, returns
+ *   "".
+ * - An own key that is not one of these fields, such as a misspelt `yaer`, returns "". So does an
+ *   era, or a `calendar` or `timeZone` property, whether own, inherited or a getter. A field is
+ *   read with a property get, as Temporal reads it, so an inherited or getter field is set.
+ * - A Temporal date or time object returns "", as Temporal's `with` refuses one. One whose
+ *   prototype has been replaced with `Object.prototype`, `null` or `Function.prototype` sets
+ *   nothing instead.
  * - Returns "" for invalid input.
  *
  * @param value ISO PlainDateTime string
@@ -22,6 +33,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example setDateTime("2024-01-31T12:00:00", { month: 2 }) // "2024-02-29T12:00:00" (constrain clamps to the last valid day)
  * @example setDateTime("2024-01-31T12:00:00", { month: 2 }, { overflow: "reject" }) // ""
  * @example setDateTime("2024-03-10T12:00:00", {}) // "2024-03-10T12:00:00" (empty fields object is a no-op)
+ * @example setDateTime("2024-03-10T12:00:00", { hour: "9" }) // "" (not converted)
  * @example setDateTime("invalid", { hour: 9 }) // ""
  */
 export function setDateTime(value, fields, options) {
@@ -32,12 +44,15 @@ export function setDateTime(value, fields, options) {
         return "";
     try {
         const dateTime = Temporal.PlainDateTime.from(value);
-        // Temporal.PlainDateTime.prototype.with() throws on an empty fields object ("no supported
-        // properties found") rather than treating it as a no-op, so short-circuit here.
-        if (Object.keys(fields).length === 0)
+        const set = readSetFields(fields, DATE_TIME_FIELDS);
+        if (set === null)
+            return "";
+        // Only the values readSetFields checked reach Temporal. An empty result sets nothing: a
+        // no-op here, where Temporal's with() would throw.
+        if (Object.keys(set).length === 0)
             return dateTime.toString();
         return dateTime
-            .with(fields, { overflow: resolveOverflow(options?.overflow) })
+            .with(set, { overflow: resolveOverflow(options?.overflow) })
             .toString();
     }
     catch {

package/dist/plain/calculate/setTime.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { Overflow } from "../../types/index.js";
 /**
  * Return a PlainTime ISO string with the given `fields` set on `value`.
@@ -7,7 +7,18 @@ import type { Overflow } from "../../types/index.js";
  *   single atomic overflow pass — see `setDate`'s doc for why that matters over composing
  *   `addTime()` calls field-by-field.
  * - `fields` may set any of `hour`, `minute`, `second`, `millisecond`, `microsecond`, and/or
- *   `nanosecond`; omitted fields keep their current value. An empty object is a no-op.
+ *   `nanosecond`; omitted fields keep their current value. An object with no field set, such as
+ *   `{}` or `{ hour: undefined }`, is a no-op.
+ * - Values are not converted: all six fields must be integer numbers. `null`, a numeric string, a
+ *   boolean or a fraction returns "", where Temporal would convert or truncate it. A bigint, `NaN`
+ *   or an infinity returns "" too. An out-of-range number follows `overflow`.
+ * - An own key that is not one of these fields, such as a misspelt `huor`, returns "". So does a
+ *   date field, such as `year`, or a `calendar` or `timeZone` property, whether own, inherited or a
+ *   getter. A field is read with a property get, as Temporal reads it, so an inherited or getter
+ *   field is set.
+ * - A Temporal date or time object returns "", as Temporal's `with` refuses one. One whose
+ *   prototype has been replaced with `Object.prototype`, `null` or `Function.prototype` sets
+ *   nothing instead.
  * - Unlike `addTime`, which takes no `overflow` because addition always wraps around the clock,
  *   `overflow` has an effect here: `.with()` assigns fixed field values rather than adding a
  *   delta.
@@ -22,6 +33,7 @@ import type { Overflow } from "../../types/index.js";
  * @example setTime("12:00:00", { hour: 25 }) // "23:00:00" (constrain clamps to the max valid hour)
  * @example setTime("12:00:00", { hour: 25 }, { overflow: "reject" }) // ""
  * @example setTime("12:00:00", {}) // "12:00:00" (empty fields object is a no-op)
+ * @example setTime("12:00:00", { hour: 9.5 }) // "" (not truncated)
  * @example setTime("invalid", { hour: 9 }) // ""
  */
 export declare function setTime(value: string, fields: Temporal.PlainTimeLike, options?: {

package/dist/plain/calculate/setTime.js

@@ -1,5 +1,5 @@
-import { Temporal } from "@js-temporal/polyfill";
-import { resolveOverflow } from "../../internal/index.js";
+import { Temporal } from "../../internal/temporal.js";
+import { TIME_FIELDS, readSetFields, resolveOverflow } from "../../internal/index.js";
 import { isValidTime } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -9,7 +9,18 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   single atomic overflow pass — see `setDate`'s doc for why that matters over composing
  *   `addTime()` calls field-by-field.
  * - `fields` may set any of `hour`, `minute`, `second`, `millisecond`, `microsecond`, and/or
- *   `nanosecond`; omitted fields keep their current value. An empty object is a no-op.
+ *   `nanosecond`; omitted fields keep their current value. An object with no field set, such as
+ *   `{}` or `{ hour: undefined }`, is a no-op.
+ * - Values are not converted: all six fields must be integer numbers. `null`, a numeric string, a
+ *   boolean or a fraction returns "", where Temporal would convert or truncate it. A bigint, `NaN`
+ *   or an infinity returns "" too. An out-of-range number follows `overflow`.
+ * - An own key that is not one of these fields, such as a misspelt `huor`, returns "". So does a
+ *   date field, such as `year`, or a `calendar` or `timeZone` property, whether own, inherited or a
+ *   getter. A field is read with a property get, as Temporal reads it, so an inherited or getter
+ *   field is set.
+ * - A Temporal date or time object returns "", as Temporal's `with` refuses one. One whose
+ *   prototype has been replaced with `Object.prototype`, `null` or `Function.prototype` sets
+ *   nothing instead.
  * - Unlike `addTime`, which takes no `overflow` because addition always wraps around the clock,
  *   `overflow` has an effect here: `.with()` assigns fixed field values rather than adding a
  *   delta.
@@ -24,6 +35,7 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  * @example setTime("12:00:00", { hour: 25 }) // "23:00:00" (constrain clamps to the max valid hour)
  * @example setTime("12:00:00", { hour: 25 }, { overflow: "reject" }) // ""
  * @example setTime("12:00:00", {}) // "12:00:00" (empty fields object is a no-op)
+ * @example setTime("12:00:00", { hour: 9.5 }) // "" (not truncated)
  * @example setTime("invalid", { hour: 9 }) // ""
  */
 export function setTime(value, fields, options) {
@@ -34,12 +46,15 @@ export function setTime(value, fields, options) {
         return "";
     try {
         const time = Temporal.PlainTime.from(value);
-        // Temporal.PlainTime.prototype.with() throws on an empty fields object ("invalid time-like")
-        // rather than treating it as a no-op, so short-circuit here.
-        if (Object.keys(fields).length === 0)
+        const set = readSetFields(fields, TIME_FIELDS);
+        if (set === null)
+            return "";
+        // Only the values readSetFields checked reach Temporal. An empty result sets nothing: a
+        // no-op here, where Temporal's with() would throw.
+        if (Object.keys(set).length === 0)
             return time.toString();
         return time
-            .with(fields, { overflow: resolveOverflow(options?.overflow) })
+            .with(set, { overflow: resolveOverflow(options?.overflow) })
             .toString();
     }
     catch {

package/dist/plain/calculate/sortDateTimes.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Sort an array of PlainDateTime values in ascending or descending order.

package/dist/plain/calculate/sortDates.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Sort an array of PlainDate values in ascending or descending order.

package/dist/plain/calculate/sortTimes.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Sort an array of PlainTime values in ascending or descending order.

package/dist/plain/calculate/startOfDate.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 /**
  * Return the start of the specified date `unit` for a given ISO 8601 date string.
  *

package/dist/plain/calculate/startOfDate.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 { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { resolveWeekStartsOn } from "../../internal/resolveWeekStartsOn.js";
 import { isValidDate } from "../validate/index.js";

package/dist/plain/calculate/startOfDateTime.d.ts

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

package/dist/plain/calculate/startOfDateTime.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 { defaultFractionalDigits } from "../../internal/index.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { resolveWeekStartsOn } from "../../internal/resolveWeekStartsOn.js";

package/dist/plain/calculate/startOfQuarterForDate.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the first day of the quarter for a given ISO date.

package/dist/plain/calculate/startOfQuarterForDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the start of the quarter for a given ISO datetime.

package/dist/plain/calculate/startOfTime.d.ts

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import type { FractionalDigit } from "../../types/index.js";
 /**
  * Units `startOfTime` accepts: a Temporal time unit, or `"day"` for midnight, each singular or plural.
@@ -7,7 +7,7 @@ import type { FractionalDigit } from "../../types/index.js";
  * import { StartOfTimeUnit } from "@northguild/gmt/plain";
  * const unit: StartOfTimeUnit = "hours";
  */
-export type StartOfTimeUnit = Temporal.SmallestUnit<Temporal.TimeUnit | "day">;
+export type StartOfTimeUnit = Temporal.SmallestUnit<"day" | Temporal.TimeUnit>;
 /**
  * Return the start of the specified time `unit` for a given ISO 8601 time string.
  *

package/dist/plain/calculate/startOfTime.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 { defaultFractionalDigits } from "../../internal/index.js";
 import { resolveDateTimeUnit } from "../../internal/resolveDateTimeUnit.js";
 import { isValidTime } from "../validate/index.js";

package/dist/plain/calculate/subtractBusinessDays.d.ts

@@ -24,8 +24,8 @@ import type { BusinessCalendar } from "../../types/index.js";
  * @example subtractBusinessDays("2024-03-18", 1) // "2024-03-15" (Monday back to Friday)
  * @example subtractBusinessDays("2024-03-17", 1) // "2024-03-15" (from a Sunday)
  * @example subtractBusinessDays("2024-03-18", 0) // "2024-03-18"
- * @example subtractBusinessDays("2024-07-05", 1, { weekend: [6, 7], holidays: ["2024-07-04"], timeZone: "America/New_York" }) // "2024-07-03" (skips the holiday)
- * @example subtractBusinessDays("2024-07-05", -1, { weekend: [6, 7], holidays: [], timeZone: "America/New_York" }) // "2024-07-08"
+ * @example subtractBusinessDays("2024-07-05", 1, { weekend: [6, 7], holidays: ["2024-07-04"], timeZone: "Africa/Kigali" }) // "2024-07-03" (skips the holiday)
+ * @example subtractBusinessDays("2024-07-05", -1, { weekend: [6, 7], holidays: [], timeZone: "Asia/Tokyo" }) // "2024-07-08"
  * @example subtractBusinessDays("2024-07-07", 1, { weekend: [5, 6], holidays: [], timeZone: "Asia/Riyadh" }) // "2024-07-04" (Friday–Saturday weekend)
  * @example subtractBusinessDays("invalid", 1) // ""
  * @example subtractBusinessDays("2024-03-18", 1, { weekend: [6, 7], holidays: [], timeZone: "Invalid/Zone" }) // "" (bad calendar)

package/dist/plain/calculate/subtractBusinessDays.js

@@ -24,8 +24,8 @@ import { stepBusinessDaysValue } from "../../internal/businessDayValues.js";
  * @example subtractBusinessDays("2024-03-18", 1) // "2024-03-15" (Monday back to Friday)
  * @example subtractBusinessDays("2024-03-17", 1) // "2024-03-15" (from a Sunday)
  * @example subtractBusinessDays("2024-03-18", 0) // "2024-03-18"
- * @example subtractBusinessDays("2024-07-05", 1, { weekend: [6, 7], holidays: ["2024-07-04"], timeZone: "America/New_York" }) // "2024-07-03" (skips the holiday)
- * @example subtractBusinessDays("2024-07-05", -1, { weekend: [6, 7], holidays: [], timeZone: "America/New_York" }) // "2024-07-08"
+ * @example subtractBusinessDays("2024-07-05", 1, { weekend: [6, 7], holidays: ["2024-07-04"], timeZone: "Africa/Kigali" }) // "2024-07-03" (skips the holiday)
+ * @example subtractBusinessDays("2024-07-05", -1, { weekend: [6, 7], holidays: [], timeZone: "Asia/Tokyo" }) // "2024-07-08"
  * @example subtractBusinessDays("2024-07-07", 1, { weekend: [5, 6], holidays: [], timeZone: "Asia/Riyadh" }) // "2024-07-04" (Friday–Saturday weekend)
  * @example subtractBusinessDays("invalid", 1) // ""
  * @example subtractBusinessDays("2024-03-18", 1, { weekend: [6, 7], holidays: [], timeZone: "Invalid/Zone" }) // "" (bad calendar)

package/dist/plain/calculate/subtractDate.js

@@ -1,6 +1,6 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
-import { calendarSystemOfDateValue, formatDateInCalendar, isValidAmount, parseCalendarDateValue, plainDateAdd, resolveOverflow, } from "../../internal/index.js";
+import { Temporal } from "../../internal/temporal.js";
+import { calendarSystemOfDateValue, formatDateInCalendar, parseCalendarDateValue, plainDateAdd, readDurationUnits, resolveOverflow, } from "../../internal/index.js";
 import { isValidCalendarDate, isValidDateDurationUnit } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -30,11 +30,8 @@ export function subtractDate(value, units, options) {
             return "";
         }
         const validDate = isValidCalendarDate(value);
-        const validUnits = typeof units === "object" &&
-            units !== null &&
-            Object.keys(units).every(isValidDateDurationUnit);
-        const validAmounts = validUnits && Object.values(units).every(isValidAmount);
-        if (!validDate || !validUnits || !validAmounts) {
+        const amounts = readDurationUnits(units, isValidDateDurationUnit);
+        if (!validDate || amounts === null) {
             return "";
         }
         try {
@@ -43,7 +40,7 @@ export function subtractDate(value, units, options) {
                 return "";
             }
             const date = parseCalendarDateValue(value);
-            const result = plainDateAdd(date, Temporal.Duration.from(units).negated(), resolveOverflow(options?.overflow));
+            const result = plainDateAdd(date, Temporal.Duration.from(amounts).negated(), resolveOverflow(options?.overflow));
             return formatDateInCalendar(result, calendar);
         }
         catch {

package/dist/plain/calculate/subtractDateTime.js

@@ -1,6 +1,6 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidAmount, resolveOverflow } from "../../internal/index.js";
+import { Temporal } from "../../internal/temporal.js";
+import { readDurationUnits, resolveOverflow } from "../../internal/index.js";
 import { isValidDateTime, isValidDateTimeDurationUnit } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
@@ -24,17 +24,14 @@ export function subtractDateTime(value, units, options) {
             return "";
         }
         const validDateTime = isValidDateTime(value);
-        const validUnits = typeof units === "object" &&
-            units !== null &&
-            Object.keys(units).every(isValidDateTimeDurationUnit);
-        const validAmounts = validUnits && Object.values(units).every(isValidAmount);
-        if (!validDateTime || !validUnits || !validAmounts) {
+        const amounts = readDurationUnits(units, isValidDateTimeDurationUnit);
+        if (!validDateTime || amounts === null) {
             return "";
         }
         try {
             const dateTime = Temporal.PlainDateTime.from(value);
             return dateTime
-                .subtract(units, { overflow: resolveOverflow(options?.overflow) })
+                .subtract(amounts, { overflow: resolveOverflow(options?.overflow) })
                 .toString();
         }
         catch {

package/dist/plain/calculate/subtractTime.js

@@ -1,6 +1,6 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
-import { isValidAmount } from "../../internal/index.js";
+import { Temporal } from "../../internal/temporal.js";
+import { readDurationUnits } from "../../internal/index.js";
 import { isValidTime, isValidTimeDurationUnit } from "../validate/index.js";
 /**
  * Return a PlainTime ISO string with `units` subtracted from `value`.
@@ -22,16 +22,13 @@ import { isValidTime, isValidTimeDurationUnit } from "../validate/index.js";
 export function subtractTime(value, units) {
     try {
         const validTime = isValidTime(value);
-        const validUnits = typeof units === "object" &&
-            units !== null &&
-            Object.keys(units).every(isValidTimeDurationUnit);
-        const validAmounts = validUnits && Object.values(units).every(isValidAmount);
-        if (!validTime || !validUnits || !validAmounts) {
+        const amounts = readDurationUnits(units, isValidTimeDurationUnit);
+        if (!validTime || amounts === null) {
             return "";
         }
         try {
             const time = Temporal.PlainTime.from(value);
-            return time.subtract(units).toString();
+            return time.subtract(amounts).toString();
         }
         catch {
             return "";

package/dist/plain/calculate/weekOfYearForDate.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the ISO week number for a given ISO 8601 date string.