@northguild/gmt 1.18.0 → 1.20.0

package/dist/zoned/validate/isValidRfc3339DateTime.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Return true when `value` is a real RFC 3339 date-time: an ISO 8601 date and time that always
+ * states its UTC offset, as `Z` or `±HH:MM` (RFC 3339 §5.6).
+ *
+ * - True exactly when `parseRfc3339` returns a zoned string for the same value: the validator
+ *   calls the parser, so the two cannot disagree.
+ * - Checks the calendar as well as the shape. The `rfc3339DateTime` pattern proves the shape
+ *   alone, so it matches a day that does not exist: 29 February in a common year and 31 June are
+ *   false here.
+ * - Accepts `T`, `t` or a single space between the date and the time, `Z` or `z`, a numeric
+ *   offset from `-23:59` to `+23:59`, and up to nine fraction digits.
+ * - False for a leap second (`:60`), although §5.6 `time-second` admits it: GMT rejects leap
+ *   seconds because Temporal would read one as `:59`.
+ * - False for GMT's own zoned strings, which carry a bracketed zone (`...+00:00[UTC]`): that
+ *   annotation is not RFC 3339. Check those with `isValidZonedDateTime`.
+ * - False for a non-string. Read the value with `parseRfc3339`; write one with `formatRfc3339`.
+ *
+ * @param value candidate RFC 3339 date-time string
+ * @returns boolean indicating validity
+ *
+ * @example isValidRfc3339DateTime("2024-03-15T14:30:00-04:00") // true
+ * @example isValidRfc3339DateTime("2024-03-15t14:30:00z") // true (lower-case t and z)
+ * @example isValidRfc3339DateTime("2024-03-15 14:30:00.5Z") // true (space separator, fraction)
+ * @example isValidRfc3339DateTime("2023-02-29T10:00:00Z") // false (2023 has no 29 February; the rfc3339DateTime pattern matches it)
+ * @example isValidRfc3339DateTime("2024-06-31T10:00:00Z") // false (June has 30 days; the rfc3339DateTime pattern matches it)
+ * @example isValidRfc3339DateTime("2016-12-31T23:59:60Z") // false (leap second)
+ * @example isValidRfc3339DateTime("2024-03-15T14:30:00") // false (no offset)
+ * @example isValidRfc3339DateTime("2024-03-15T14:30:00+00:00[UTC]") // false (bracketed zone: use isValidZonedDateTime)
+ * @example isValidRfc3339DateTime("not a date") // false
+ */
+export declare function isValidRfc3339DateTime(value: string): boolean;

package/dist/zoned/validate/isValidRfc3339DateTime.js

@@ -0,0 +1,34 @@
+import { parseRfc3339 } from "../parse/parseRfc3339.js";
+/**
+ * Return true when `value` is a real RFC 3339 date-time: an ISO 8601 date and time that always
+ * states its UTC offset, as `Z` or `±HH:MM` (RFC 3339 §5.6).
+ *
+ * - True exactly when `parseRfc3339` returns a zoned string for the same value: the validator
+ *   calls the parser, so the two cannot disagree.
+ * - Checks the calendar as well as the shape. The `rfc3339DateTime` pattern proves the shape
+ *   alone, so it matches a day that does not exist: 29 February in a common year and 31 June are
+ *   false here.
+ * - Accepts `T`, `t` or a single space between the date and the time, `Z` or `z`, a numeric
+ *   offset from `-23:59` to `+23:59`, and up to nine fraction digits.
+ * - False for a leap second (`:60`), although §5.6 `time-second` admits it: GMT rejects leap
+ *   seconds because Temporal would read one as `:59`.
+ * - False for GMT's own zoned strings, which carry a bracketed zone (`...+00:00[UTC]`): that
+ *   annotation is not RFC 3339. Check those with `isValidZonedDateTime`.
+ * - False for a non-string. Read the value with `parseRfc3339`; write one with `formatRfc3339`.
+ *
+ * @param value candidate RFC 3339 date-time string
+ * @returns boolean indicating validity
+ *
+ * @example isValidRfc3339DateTime("2024-03-15T14:30:00-04:00") // true
+ * @example isValidRfc3339DateTime("2024-03-15t14:30:00z") // true (lower-case t and z)
+ * @example isValidRfc3339DateTime("2024-03-15 14:30:00.5Z") // true (space separator, fraction)
+ * @example isValidRfc3339DateTime("2023-02-29T10:00:00Z") // false (2023 has no 29 February; the rfc3339DateTime pattern matches it)
+ * @example isValidRfc3339DateTime("2024-06-31T10:00:00Z") // false (June has 30 days; the rfc3339DateTime pattern matches it)
+ * @example isValidRfc3339DateTime("2016-12-31T23:59:60Z") // false (leap second)
+ * @example isValidRfc3339DateTime("2024-03-15T14:30:00") // false (no offset)
+ * @example isValidRfc3339DateTime("2024-03-15T14:30:00+00:00[UTC]") // false (bracketed zone: use isValidZonedDateTime)
+ * @example isValidRfc3339DateTime("not a date") // false
+ */
+export function isValidRfc3339DateTime(value) {
+    return parseRfc3339(value) !== "";
+}

package/dist/zoned/validate/isValidTimeZone.d.ts

@@ -3,7 +3,7 @@
  *
  * - Uses Temporal.ZonedDateTime.from to test timezone validity.
  * - Uses the `timeZoneLike` regex to check the identifier's shape: Temporal's
- *   `TimeZoneIdentifier` grammar (§14.6.2).
+ *   `TimeZoneIdentifier` grammar (§13.31).
  * - Accepts every IANA Zone and Link name the runtime accepts, including single-component names
  *   (`UTC`, `Japan`, `Zulu`, `EST5EDT`, `GMT+0`), in any letter case (ECMA-402 matches
  *   identifiers ASCII-case-insensitively, so `utc` is as valid as `america/new_york`).
@@ -12,17 +12,21 @@
  * - Returns false for invalid timezone formats.
  * - Compatibility: earlier releases required a `/` in every name except `UTC` and `GMT`. To keep
  *   that narrower rule, also require `timeZone.includes("/")` or `"UTC"`/`"GMT"`.
+ * - A stored offset with seconds (`-00:44:30`) is false here and true for `isValidUtcOffset`. To
+ *   check what a function with a zoneless result accepts, use
+ *   `isValidTimeZone(x) || isValidUtcOffset(x)`.
  *
  * @param timeZone timeZone identifier to validate
  * @returns boolean indicating validity
  *
- * @example isValidTimeZone("America/New_York") // true
+ * @example isValidTimeZone("Asia/Kolkata") // true
  * @example isValidTimeZone("Europe/London") // true
  * @example isValidTimeZone("Invalid/Timezone") // false
  * @example isValidTimeZone("Japan") // true (IANA link to Asia/Tokyo)
  * @example isValidTimeZone("utc") // true (case-insensitive)
  * @example isValidTimeZone("+05:00") // true (an offset identifier)
  * @example isValidTimeZone("+05:00:00") // false (no seconds in an offset identifier)
+ * @example isValidTimeZone("-00:44:30") // false (a stored offset with seconds; `isValidUtcOffset` accepts it)
  * @example "Japan".includes("/") // false (the earlier slash-only rule)
  */
 export declare function isValidTimeZone(timeZone: string): boolean;

package/dist/zoned/validate/isValidTimeZone.js

@@ -1,11 +1,10 @@
-import { timeZoneLike } from "../../regex/index.js";
-import { zonedDateTimeFrom } from "../../internal/index.js";
+import { isZoneId } from "../../internal/inputChecks.js";
 /**
  * Validate whether a string is a valid time zone identifier: an IANA name or a UTC offset.
  *
  * - Uses Temporal.ZonedDateTime.from to test timezone validity.
  * - Uses the `timeZoneLike` regex to check the identifier's shape: Temporal's
- *   `TimeZoneIdentifier` grammar (§14.6.2).
+ *   `TimeZoneIdentifier` grammar (§13.31).
  * - Accepts every IANA Zone and Link name the runtime accepts, including single-component names
  *   (`UTC`, `Japan`, `Zulu`, `EST5EDT`, `GMT+0`), in any letter case (ECMA-402 matches
  *   identifiers ASCII-case-insensitively, so `utc` is as valid as `america/new_york`).
@@ -14,33 +13,23 @@ import { zonedDateTimeFrom } from "../../internal/index.js";
  * - Returns false for invalid timezone formats.
  * - Compatibility: earlier releases required a `/` in every name except `UTC` and `GMT`. To keep
  *   that narrower rule, also require `timeZone.includes("/")` or `"UTC"`/`"GMT"`.
+ * - A stored offset with seconds (`-00:44:30`) is false here and true for `isValidUtcOffset`. To
+ *   check what a function with a zoneless result accepts, use
+ *   `isValidTimeZone(x) || isValidUtcOffset(x)`.
  *
  * @param timeZone timeZone identifier to validate
  * @returns boolean indicating validity
  *
- * @example isValidTimeZone("America/New_York") // true
+ * @example isValidTimeZone("Asia/Kolkata") // true
  * @example isValidTimeZone("Europe/London") // true
  * @example isValidTimeZone("Invalid/Timezone") // false
  * @example isValidTimeZone("Japan") // true (IANA link to Asia/Tokyo)
  * @example isValidTimeZone("utc") // true (case-insensitive)
  * @example isValidTimeZone("+05:00") // true (an offset identifier)
  * @example isValidTimeZone("+05:00:00") // false (no seconds in an offset identifier)
+ * @example isValidTimeZone("-00:44:30") // false (a stored offset with seconds; `isValidUtcOffset` accepts it)
  * @example "Japan".includes("/") // false (the earlier slash-only rule)
  */
 export function isValidTimeZone(timeZone) {
-    try {
-        zonedDateTimeFrom({
-            year: 2020,
-            month: 2,
-            day: 28,
-            hour: 0,
-            minute: 0,
-            second: 0,
-            timeZone,
-        });
-        return timeZoneLike.test(timeZone) && true;
-    }
-    catch {
-        return false;
-    }
+    return isZoneId(timeZone);
 }

package/dist/zoned/validate/isValidZonedDateTime.d.ts

@@ -26,13 +26,13 @@
  *
  * @example isValidZonedDateTime("2024-02-29T12:34:56.789+00:00[UTC]") // true
  * @example isValidZonedDateTime("2024-06-30T23:59:60+00:00[UTC]") // false (leap second)
- * @example isValidZonedDateTime("2024-02-10T12:00:00-05:00[America/New_York][u-ca=hebrew]") // false (non-ISO calendar: use isValidCalendarZonedDateTime)
- * @example isValidZonedDateTime("2024-02-10T12:00:00-05:00[America/New_York][u-ca=iso8601]") // true
- * @example isValidZonedDateTime("2024-02-10T12:00:00-05:00[America/New_York][foo=bar]") // true (elective annotation ignored)
- * @example isValidZonedDateTime("20241003T143000-0400[America/New_York]") // false (basic format)
- * @example isValidZonedDateTime("2024-10-03 14:30:00-04:00[America/New_York]") // false (space separator)
- * @example isValidZonedDateTime("2024-10-03[America/New_York]") // false (no time)
- * @example isValidZonedDateTime("2024-10-03T14:30:00-05:00[America/New_York]") // false (New York is -04:00 in October)
+ * @example isValidZonedDateTime("2024-02-10T12:00:00+11:00[Australia/Sydney][u-ca=hebrew]") // false (non-ISO calendar: use isValidCalendarZonedDateTime)
+ * @example isValidZonedDateTime("2024-02-10T12:00:00+11:00[Australia/Sydney][u-ca=iso8601]") // true
+ * @example isValidZonedDateTime("2024-02-10T12:00:00+11:00[Australia/Sydney][foo=bar]") // true (elective annotation ignored)
+ * @example isValidZonedDateTime("20241003T143000+0530[Asia/Kolkata]") // false (basic format)
+ * @example isValidZonedDateTime("2024-10-03 14:30:00+05:30[Asia/Kolkata]") // false (space separator)
+ * @example isValidZonedDateTime("2024-10-03[Asia/Kolkata]") // false (no time)
+ * @example isValidZonedDateTime("2024-10-03T14:30:00+00:00[Europe/London]") // false (London is +01:00 in early October)
  * @example isValidZonedDateTime("1960-01-01T00:20:00-00:45[Africa/Monrovia]") // true (-00:45 is Monrovia's -00:44:30, rounded)
  * @example isValidZonedDateTime("1960-01-01T00:20:00-00:44:30[Africa/Monrovia]") // true
  * @example isValidZonedDateTime("1960-01-01T00:20:00-00:45:00[Africa/Monrovia]") // false (an offset with seconds must be exact)

package/dist/zoned/validate/isValidZonedDateTime.js

@@ -1,6 +1,6 @@
 import { hasZonedDateTimeShape } from "../../internal/isoStringBody.js";
 import { zonedDateTimeFrom } from "../../internal/zonedWallClock.js";
-import { isLeapSecond } from "../../plain/validate/isLeapSecond.js";
+import { hasSecond60 } from "../../plain/validate/hasSecond60.js";
 /**
  * Validate whether a string is a valid ISO 8601 zoned datetime string.
  *
@@ -29,13 +29,13 @@ import { isLeapSecond } from "../../plain/validate/isLeapSecond.js";
  *
  * @example isValidZonedDateTime("2024-02-29T12:34:56.789+00:00[UTC]") // true
  * @example isValidZonedDateTime("2024-06-30T23:59:60+00:00[UTC]") // false (leap second)
- * @example isValidZonedDateTime("2024-02-10T12:00:00-05:00[America/New_York][u-ca=hebrew]") // false (non-ISO calendar: use isValidCalendarZonedDateTime)
- * @example isValidZonedDateTime("2024-02-10T12:00:00-05:00[America/New_York][u-ca=iso8601]") // true
- * @example isValidZonedDateTime("2024-02-10T12:00:00-05:00[America/New_York][foo=bar]") // true (elective annotation ignored)
- * @example isValidZonedDateTime("20241003T143000-0400[America/New_York]") // false (basic format)
- * @example isValidZonedDateTime("2024-10-03 14:30:00-04:00[America/New_York]") // false (space separator)
- * @example isValidZonedDateTime("2024-10-03[America/New_York]") // false (no time)
- * @example isValidZonedDateTime("2024-10-03T14:30:00-05:00[America/New_York]") // false (New York is -04:00 in October)
+ * @example isValidZonedDateTime("2024-02-10T12:00:00+11:00[Australia/Sydney][u-ca=hebrew]") // false (non-ISO calendar: use isValidCalendarZonedDateTime)
+ * @example isValidZonedDateTime("2024-02-10T12:00:00+11:00[Australia/Sydney][u-ca=iso8601]") // true
+ * @example isValidZonedDateTime("2024-02-10T12:00:00+11:00[Australia/Sydney][foo=bar]") // true (elective annotation ignored)
+ * @example isValidZonedDateTime("20241003T143000+0530[Asia/Kolkata]") // false (basic format)
+ * @example isValidZonedDateTime("2024-10-03 14:30:00+05:30[Asia/Kolkata]") // false (space separator)
+ * @example isValidZonedDateTime("2024-10-03[Asia/Kolkata]") // false (no time)
+ * @example isValidZonedDateTime("2024-10-03T14:30:00+00:00[Europe/London]") // false (London is +01:00 in early October)
  * @example isValidZonedDateTime("1960-01-01T00:20:00-00:45[Africa/Monrovia]") // true (-00:45 is Monrovia's -00:44:30, rounded)
  * @example isValidZonedDateTime("1960-01-01T00:20:00-00:44:30[Africa/Monrovia]") // true
  * @example isValidZonedDateTime("1960-01-01T00:20:00-00:45:00[Africa/Monrovia]") // false (an offset with seconds must be exact)
@@ -46,7 +46,7 @@ export function isValidZonedDateTime(value) {
     if (typeof value !== "string" || value.length === 0) {
         return false;
     }
-    if (isLeapSecond(value) || !hasZonedDateTimeShape(value)) {
+    if (hasSecond60(value) || !hasZonedDateTimeShape(value)) {
         return false;
     }
     try {

package/dist/zoned/validate/isValidZonedRange.d.ts

@@ -16,7 +16,7 @@
  *
  * @example isValidZonedRange({ value1: "2024-01-01T10:00:00+00:00[UTC]", value2: "2024-12-31T23:59:59+00:00[UTC]" }) // true
  * @example isValidZonedRange({ value1: "2024-12-31T23:59:59+00:00[UTC]", value2: "2024-01-01T10:00:00+00:00[UTC]" }) // false
- * @example isValidZonedRange({ value1: "2024-06-15T12:00:00-04:00[America/New_York]", value2: "2024-06-15T12:00:00-04:00[America/New_York]", options: { allowEqual: true } }) // true
+ * @example isValidZonedRange({ value1: "2024-06-15T12:00:00+09:00[Asia/Tokyo]", value2: "2024-06-15T12:00:00+09:00[Asia/Tokyo]", options: { allowEqual: true } }) // true
  * @example isValidZonedRange({ value1: "2024-01-01T00:00:00+00:00[UTC][u-ca=hebrew]", value2: "2024-02-01T00:00:00+00:00[UTC]" }) // false (non-ISO calendar)
  * @example isValidZonedRange({ value1: "2024-01-01T00:00:00+00:00[UTC][u-ca=iso8601]", value2: "2024-02-01T00:00:00+00:00[UTC]" }) // true
  * @example isValidZonedRange({ value1: "2024-01-01 10:00:00+00:00[UTC]", value2: "2024-12-31T23:59:59+00:00[UTC]" }) // false (space separator)

package/dist/zoned/validate/isValidZonedRange.js

@@ -1,6 +1,6 @@
 // fallow-ignore-file code-duplication -- cross-family Temporal type clone, by design (rule 5)
-import { Temporal } from "@js-temporal/polyfill";
-import { isLeapSecond } from "../../plain/validate/isLeapSecond.js";
+import { Temporal } from "../../internal/temporal.js";
+import { hasSecond60 } from "../../plain/validate/hasSecond60.js";
 import { isObject, isOptionsArgument, zonedDateTimeFrom } from "../../internal/index.js";
 import { hasZonedDateTimeShape } from "../../internal/isoStringBody.js";
 /**
@@ -21,7 +21,7 @@ import { hasZonedDateTimeShape } from "../../internal/isoStringBody.js";
  *
  * @example isValidZonedRange({ value1: "2024-01-01T10:00:00+00:00[UTC]", value2: "2024-12-31T23:59:59+00:00[UTC]" }) // true
  * @example isValidZonedRange({ value1: "2024-12-31T23:59:59+00:00[UTC]", value2: "2024-01-01T10:00:00+00:00[UTC]" }) // false
- * @example isValidZonedRange({ value1: "2024-06-15T12:00:00-04:00[America/New_York]", value2: "2024-06-15T12:00:00-04:00[America/New_York]", options: { allowEqual: true } }) // true
+ * @example isValidZonedRange({ value1: "2024-06-15T12:00:00+09:00[Asia/Tokyo]", value2: "2024-06-15T12:00:00+09:00[Asia/Tokyo]", options: { allowEqual: true } }) // true
  * @example isValidZonedRange({ value1: "2024-01-01T00:00:00+00:00[UTC][u-ca=hebrew]", value2: "2024-02-01T00:00:00+00:00[UTC]" }) // false (non-ISO calendar)
  * @example isValidZonedRange({ value1: "2024-01-01T00:00:00+00:00[UTC][u-ca=iso8601]", value2: "2024-02-01T00:00:00+00:00[UTC]" }) // true
  * @example isValidZonedRange({ value1: "2024-01-01 10:00:00+00:00[UTC]", value2: "2024-12-31T23:59:59+00:00[UTC]" }) // false (space separator)
@@ -36,8 +36,8 @@ export function isValidZonedRange(props) {
         if (typeof value1 !== "string" || typeof value2 !== "string") {
             return false;
         }
-        if (isLeapSecond(value1) ||
-            isLeapSecond(value2) ||
+        if (hasSecond60(value1) ||
+            hasSecond60(value2) ||
             !hasZonedDateTimeShape(value1) ||
             !hasZonedDateTimeShape(value2)) {
             return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@northguild/gmt",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "description": "Temporal-based date and time utilities with timezone support and polyfill integration",
   "keywords": [
     "date",
@@ -11,7 +11,7 @@
     "time",
     "timezone"
   ],
-  "homepage": "https://gmt-dox.northguild.workers.dev",
+  "homepage": "https://northguild.dev/gmt/",
   "bugs": {
     "url": "https://github.com/northguild/gmt/issues"
   },
@@ -81,18 +81,36 @@
       "duration/validate": [
         "./dist/duration/validate/index.d.ts"
       ],
+      "gnss": [
+        "./dist/gnss/index.d.ts"
+      ],
+      "gnss/convert": [
+        "./dist/gnss/convert/index.d.ts"
+      ],
       "instant": [
         "./dist/instant/index.d.ts"
       ],
       "instant/convert": [
         "./dist/instant/convert/index.d.ts"
       ],
+      "instant/validate": [
+        "./dist/instant/validate/index.d.ts"
+      ],
       "intermodal": [
         "./dist/intermodal/index.d.ts"
       ],
       "intermodal/calculate": [
         "./dist/intermodal/calculate/index.d.ts"
       ],
+      "intermodal/format": [
+        "./dist/intermodal/format/index.d.ts"
+      ],
+      "intermodal/parse": [
+        "./dist/intermodal/parse/index.d.ts"
+      ],
+      "intermodal/validate": [
+        "./dist/intermodal/validate/index.d.ts"
+      ],
       "interval": [
         "./dist/interval/index.d.ts"
       ],
@@ -171,6 +189,18 @@
       "span/validate": [
         "./dist/span/validate/index.d.ts"
       ],
+      "timescale": [
+        "./dist/timescale/index.d.ts"
+      ],
+      "timescale/calculate": [
+        "./dist/timescale/calculate/index.d.ts"
+      ],
+      "timescale/convert": [
+        "./dist/timescale/convert/index.d.ts"
+      ],
+      "timescale/validate": [
+        "./dist/timescale/validate/index.d.ts"
+      ],
       "transport": [
         "./dist/transport/index.d.ts"
       ],
@@ -243,6 +273,15 @@
       "utc/validate": [
         "./dist/utc/validate/index.d.ts"
       ],
+      "workforce": [
+        "./dist/workforce/index.d.ts"
+      ],
+      "workforce/calculate": [
+        "./dist/workforce/calculate/index.d.ts"
+      ],
+      "workforce/validate": [
+        "./dist/workforce/validate/index.d.ts"
+      ],
       "zoned": [
         "./dist/zoned/index.d.ts"
       ],
@@ -252,6 +291,9 @@
       "zoned/chop": [
         "./dist/zoned/chop/index.d.ts"
       ],
+      "zoned/classify": [
+        "./dist/zoned/classify/index.d.ts"
+      ],
       "zoned/compare": [
         "./dist/zoned/compare/index.d.ts"
       ],
@@ -331,6 +373,14 @@
       "types": "./dist/duration/validate/index.d.ts",
       "default": "./dist/duration/validate/index.js"
     },
+    "./gnss": {
+      "types": "./dist/gnss/index.d.ts",
+      "default": "./dist/gnss/index.js"
+    },
+    "./gnss/convert": {
+      "types": "./dist/gnss/convert/index.d.ts",
+      "default": "./dist/gnss/convert/index.js"
+    },
     "./instant": {
       "types": "./dist/instant/index.d.ts",
       "default": "./dist/instant/index.js"
@@ -339,6 +389,10 @@
       "types": "./dist/instant/convert/index.d.ts",
       "default": "./dist/instant/convert/index.js"
     },
+    "./instant/validate": {
+      "types": "./dist/instant/validate/index.d.ts",
+      "default": "./dist/instant/validate/index.js"
+    },
     "./intermodal": {
       "types": "./dist/intermodal/index.d.ts",
       "default": "./dist/intermodal/index.js"
@@ -347,6 +401,18 @@
       "types": "./dist/intermodal/calculate/index.d.ts",
       "default": "./dist/intermodal/calculate/index.js"
     },
+    "./intermodal/format": {
+      "types": "./dist/intermodal/format/index.d.ts",
+      "default": "./dist/intermodal/format/index.js"
+    },
+    "./intermodal/parse": {
+      "types": "./dist/intermodal/parse/index.d.ts",
+      "default": "./dist/intermodal/parse/index.js"
+    },
+    "./intermodal/validate": {
+      "types": "./dist/intermodal/validate/index.d.ts",
+      "default": "./dist/intermodal/validate/index.js"
+    },
     "./interval": {
       "types": "./dist/interval/index.d.ts",
       "default": "./dist/interval/index.js"
@@ -451,6 +517,22 @@
       "types": "./dist/span/validate/index.d.ts",
       "default": "./dist/span/validate/index.js"
     },
+    "./timescale": {
+      "types": "./dist/timescale/index.d.ts",
+      "default": "./dist/timescale/index.js"
+    },
+    "./timescale/calculate": {
+      "types": "./dist/timescale/calculate/index.d.ts",
+      "default": "./dist/timescale/calculate/index.js"
+    },
+    "./timescale/convert": {
+      "types": "./dist/timescale/convert/index.d.ts",
+      "default": "./dist/timescale/convert/index.js"
+    },
+    "./timescale/validate": {
+      "types": "./dist/timescale/validate/index.d.ts",
+      "default": "./dist/timescale/validate/index.js"
+    },
     "./transport": {
       "types": "./dist/transport/index.d.ts",
       "default": "./dist/transport/index.js"
@@ -547,6 +629,18 @@
       "types": "./dist/utc/validate/index.d.ts",
       "default": "./dist/utc/validate/index.js"
     },
+    "./workforce": {
+      "types": "./dist/workforce/index.d.ts",
+      "default": "./dist/workforce/index.js"
+    },
+    "./workforce/calculate": {
+      "types": "./dist/workforce/calculate/index.d.ts",
+      "default": "./dist/workforce/calculate/index.js"
+    },
+    "./workforce/validate": {
+      "types": "./dist/workforce/validate/index.d.ts",
+      "default": "./dist/workforce/validate/index.js"
+    },
     "./zoned": {
       "types": "./dist/zoned/index.d.ts",
       "default": "./dist/zoned/index.js"
@@ -559,6 +653,10 @@
       "types": "./dist/zoned/chop/index.d.ts",
       "default": "./dist/zoned/chop/index.js"
     },
+    "./zoned/classify": {
+      "types": "./dist/zoned/classify/index.d.ts",
+      "default": "./dist/zoned/classify/index.js"
+    },
     "./zoned/compare": {
       "types": "./dist/zoned/compare/index.d.ts",
       "default": "./dist/zoned/compare/index.js"
@@ -600,10 +698,10 @@
     "@js-temporal/polyfill": "^0.5.1"
   },
   "devDependencies": {
+    "@northguild/gmt-oxlint": "1.2.1",
     "@tanstack/intent": "^0.4.0",
     "oxfmt": "^0.62.0",
-    "oxlint": "^1.78.0",
-    "@northguild/gmt-oxlint": "1.2.1"
+    "oxlint": "^1.78.0"
   },
   "engines": {
     "node": ">=22.16.0"
@@ -614,6 +712,7 @@
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
+    "bench": "vitest bench --run --config vitest.bench.config.ts",
     "lint": "oxlint",
     "format": "oxfmt"
   }

package/skills/gmt-arithmetic/SKILL.md

@@ -11,12 +11,17 @@ description: >
   (BusinessCalendar, RollConvention, isBusinessDay, addBusinessDays,
   subtractBusinessDays, businessDaysBetween, nextBusinessDay,
   previousBusinessDay, rollDate, mergeCalendars), overflow "constrain" month-end
-  clamping, splitIntervalByUnit* stepping from the anchor, maxPieces limits,
-  intervalCount* matching bucketRange, RFC 9557 calendar strings, and the
-  correct-at-the-edges guarantees at the first and last representable instant. A
-  routing pointer, not an API dump.
+  clamping, splitIntervalByUnit* anchor stepping, maxPieces limits,
+  intervalCount* matching bucketRange, RFC 9557 calendar strings,
+  correct-at-the-edges guarantees at the limits.
 sources:
-  - 'northguild/gmt:README.md'
+  - 'northguild/gmt:apps/dox/src/content/docs/guides/core-date-operations/plain-arithmetic.mdx'
+  - 'northguild/gmt:apps/dox/src/content/docs/guides/core-date-operations/durations.mdx'
+  - 'northguild/gmt:apps/dox/src/content/docs/guides/core-date-operations/spans.mdx'
+  - 'northguild/gmt:apps/dox/src/content/docs/guides/core-date-operations/business-calendars.mdx'
+  - 'northguild/gmt:apps/dox/src/content/docs/guides/core-date-operations/calendar-systems.mdx'
+  - 'northguild/gmt:apps/dox/src/content/docs/guides/intervals/*.mdx'
+  - 'northguild/gmt:apps/dox/src/content/docs/guides/concepts/correct-at-the-edges.mdx'
   - 'northguild/gmt:packages/gmt/src/plain/calculate/index.ts'
   - 'northguild/gmt:packages/gmt/src/duration/index.ts'
   - 'northguild/gmt:packages/gmt/src/interval/index.ts'
@@ -32,7 +37,7 @@ sources:
 metadata:
   type: core
   library: '@northguild/gmt'
-  library_version: '1.18.0'
+  library_version: '1.20.0'
 ---
 
 # GMT Arithmetic
@@ -59,6 +64,32 @@ and full interval set operations.
 1. **`add*` takes a `{ unit: number }` object, not an ISO duration string.**
    `addDate("2024-03-15", { days: 5 })` works; `addDate("2024-03-15", "P5D")`
    returns `""`. Use `diffDateAsDuration` / `addDuration` for duration strings.
+   An amount has those two shapes, and each function takes one of them:
+   - **A unit object is checked the same way everywhere.** A unit outside the
+     function's set returns the sentinel: `addDate` takes years to days,
+     `addTime` hours to nanoseconds. So does an own key that is no unit name,
+     and an amount that is not a whole finite number. A unit set to `undefined`
+     is absent, as Temporal reads it.
+   - **`durationFromUnits` is the bridge from the object to the string.** It
+     takes all ten units and carries nothing into a larger unit. Seconds and
+     smaller are written as one decimal number of seconds. Pass its result to
+     any function that takes a duration string.
+   - **`totalUnits` totals the object in one call.** It takes exact units only:
+     days down to nanoseconds, a day being 24 hours. A year, a month or a week
+     returns `null`, as a key and as the unit asked for.
+   - **`totalDuration` totals a duration string**, and takes `relativeTo` for a
+     calendar amount. To total `{ months: 1 }`, build the string with
+     `durationFromUnits` and pass it here.
+
+   ```typescript
+   durationFromUnits({ minutes: 15 }); // "PT15M"
+   durationFromUnits({ minutes: 90 }); // "PT90M" — not carried into hours
+   totalUnits({ minutes: 15 }, "seconds"); // 900
+   totalUnits({ weeks: 1 }, "days"); // null — write { days: 7 }
+   totalUnits("PT15M", "seconds"); // null — a duration string goes to totalDuration
+   totalDuration("PT36H", "days"); // 1.5
+   totalDuration(durationFromUnits({ months: 1 }), "days", { relativeTo: "2024-02-01" }); // 29
+   ```
 2. **Arithmetic clamps; parsers reject.** `overflow` defaults to `"constrain"`,
    Temporal's default: January 31 plus one month is February 29, and
    `addDate("2024-02-29", { years: 1 })` is `"2025-02-28"`. Pass
@@ -96,9 +127,10 @@ and full interval set operations.
    hour on its spring-forward counts 2 hours, and a range over `Pacific/Apia`'s
    deleted 30 December 2011 does not count that day. `intervalCountUnix` counts
    in `options.timeZone`, UTC by default (`"local"` for the system zone).
-5. **Calendar units need `relativeTo`.** `durationAs`, `normalizeDuration`, and
+5. **Calendar units need `relativeTo`.** `totalDuration`, `normalizeDuration`, and
    `compareDurations` return `null`/`""` for year/month/week arithmetic without
-   a `relativeTo` anchor — a month is not a fixed length. A calendar-annotated
+   a `relativeTo` anchor — a month is not a fixed length. `totalUnits` takes no
+   `relativeTo`, so it always returns `null` for those units. A calendar-annotated
    `relativeTo` is read as Temporal reads it: zoned when it has a time zone
    annotation, otherwise a date, and its calendar must be a `CalendarSystem`.
    - `round*` accept singular or plural `smallestUnit` names (`"hour"` or
@@ -112,6 +144,8 @@ and full interval set operations.
    "hours")` measures what the clock face did. Across a DST transition they
    differ by the size of the shift — a wall-clock day is 23, 24.5 or 25 real
    hours. Reaching for the wrong one is the most common span bug there is.
+   `spanMs` and `spanNs` do not count leap seconds: for a leap-second-exact span, convert both ends
+   with `toTAI` or add `leapSecondsBetween(start, end)` (see `gmt-integration`).
 7. **Span sentinels are `null`, not `0`.** `0` and `0n` are valid spans, so all
    three span functions return `null` on invalid input rather than a zero —
    `spanMs` also returns it past `Number.MAX_SAFE_INTEGER` milliseconds, where
@@ -199,10 +233,10 @@ and full interval set operations.
     caller-supplied — GMT bundles no holiday table on the default import path.
 
     ```typescript
-    const nyse = { weekend: [6, 7], holidays: ["2024-07-04"], timeZone: "America/New_York" };
-    addBusinessDays("2024-07-03", 1, nyse); // "2024-07-05" — skips the holiday
-    businessDaysBetween("2024-07-01", "2024-07-05", nyse); // 3 — start exclusive, end inclusive
-    rollDate("2024-05-31", "modifiedFollowing", nyse); // backward when forward leaves the month
+    const tokyo = { weekend: [6, 7], holidays: ["2024-05-03", "2024-05-06"], timeZone: "Asia/Tokyo" };
+    addBusinessDays("2024-05-02", 1, tokyo); // "2024-05-07" — skips both holidays and the weekend
+    businessDaysBetween("2024-05-01", "2024-05-07", tokyo); // 2 — start exclusive, end inclusive
+    rollDate("2024-08-31", "modifiedFollowing", tokyo); // "2024-08-30" — backward when forward leaves the month
     ```
 
     These are **local-date in, local-date out**: `calendar.timeZone` records the
@@ -213,9 +247,13 @@ and full interval set operations.
     survives only if it is a working day in every input, and returns `null` for an
     empty list. Narrow inputs with `isValidBusinessCalendar` /
     `isValidRollConvention`.
-13. **Read the README.** This skill is a routing pointer. For full option shapes,
-   locale matrices, and code examples, read the installed package's `README.md`
-   and the source JSDoc of the function you intend to call.
+13. **Read the docs site.** This skill is a routing pointer. For full option
+    shapes, locale matrices, and code examples, read these:
+    - `https://northguild.dev/gmt/llms.txt` is the map of every docs page.
+    - Each page has a `.md` twin that holds its text, for example
+      `https://northguild.dev/gmt/guides/core-date-operations/plain-arithmetic.md`.
+    - The JSDoc of the function you intend to call ships in the installed
+      package: `node_modules/@northguild/gmt/dist/**/*.d.ts`.
 
 ## Key functions
 
@@ -231,9 +269,12 @@ and full interval set operations.
   `startOfQuarterForDate`, `getLocaleStartOfWeek` (zoned boundaries: see the
   `gmt-timezone` skill)
 - **Durations (ISO 8601)**: `isValidDuration`, `parseDuration`, `addDuration`,
-  `subtractDuration`, `normalizeDuration`, `durationAs`, `formatDuration`,
+  `subtractDuration`, `normalizeDuration`, `totalDuration`, `formatDuration`,
   `negateDuration`, `absDuration`, `compareDurations`, `getDurationUnit`,
   `getDurationSign`
+- **Unit objects (`{ unit: number }`)**: `durationFromUnits` (object to
+  duration string), `totalUnits` (object to one total), type
+  `ExactDurationUnit`
 - **Diff-to-duration bridge**: `diffDateAsDuration`,
   `diffZonedAsDuration`, `diffUnixAsDuration`, `diffUtcAsDuration`
 - **Interval algebra (half-open, instants)**: `isValidInterval`,
@@ -256,9 +297,14 @@ and full interval set operations.
 - `duration/*` — ISO 8601 duration strings
 - `span/*` — elapsed and wall-clock spans as raw numbers
 - `interval/*` — half-open interval algebra over instant strings
+- `workforce/*` — see the `gmt-workforce` skill
 
 ## References
 
-- [README — Quick Start](README.md)
+- [Docs map for agents (llms.txt)](https://northguild.dev/gmt/llms.txt)
+- [Plain arithmetic guide](https://northguild.dev/gmt/guides/core-date-operations/plain-arithmetic/)
+- [Durations guide](https://northguild.dev/gmt/guides/core-date-operations/durations/)
+- [Spans guide](https://northguild.dev/gmt/guides/core-date-operations/spans/)
+- [Business calendars guide](https://northguild.dev/gmt/guides/core-date-operations/business-calendars/)
 - [Interval algebra reference](/reference/interval/calculate/intersectIntervals)
 - [Interval guides](/guides/intervals/interval-basics/)