@nextera.one/tps-standard 0.5.34 → 0.6.0

package/dist/esm/utils/timezone.js

@@ -0,0 +1,168 @@
+/**
+ * Timezone Utilities
+ *
+ * Provides lightweight, zero-dependency helpers for converting between
+ * UTC timestamps and local timestamps in a given IANA timezone or
+ * fixed UTC offset.
+ *
+ * Used by `TPS.toDate()` when the parsed extensions include a `tz` key.
+ *
+ * Examples:
+ *   tz=Asia/Tehran   → IANA timezone name
+ *   tz=+03:30        → fixed UTC offset
+ *   tz=IRST          → abbreviated names (best-effort, common ones mapped)
+ */
+/** Map of common abbreviated timezone names to IANA names. */
+const TZ_ABBR = {
+    // Middle East
+    IRST: "Asia/Tehran",
+    IRDT: "Asia/Tehran",
+    AST: "Asia/Riyadh",
+    AST3: "Asia/Riyadh",
+    // Europe
+    CET: "Europe/Paris",
+    CEST: "Europe/Paris",
+    EET: "Europe/Athens",
+    EEST: "Europe/Athens",
+    WET: "Europe/Lisbon",
+    WEST: "Europe/Lisbon",
+    // Americas
+    EST: "America/New_York",
+    EDT: "America/New_York",
+    CST: "America/Chicago",
+    CDT: "America/Chicago",
+    MST: "America/Denver",
+    MDT: "America/Denver",
+    PST: "America/Los_Angeles",
+    PDT: "America/Los_Angeles",
+    // Asia Pacific
+    JST: "Asia/Tokyo",
+    KST: "Asia/Seoul",
+    IST: "Asia/Kolkata",
+    CST8: "Asia/Shanghai",
+    AEST: "Australia/Sydney",
+    AEDT: "Australia/Sydney",
+    // UTC variants
+    UTC: "UTC",
+    GMT: "UTC",
+    Z: "UTC",
+};
+/**
+ * Parse a `tz` string into an IANA timezone name, or return null if unrecognized.
+ */
+function resolveIANA(tz) {
+    if (!tz)
+        return null;
+    // Direct IANA name (e.g. "Asia/Tehran")
+    if (tz.includes("/"))
+        return tz;
+    // Common abbreviation lookup
+    const abbr = TZ_ABBR[tz.toUpperCase()];
+    if (abbr)
+        return abbr;
+    return null;
+}
+/**
+ * Parses a fixed offset string like "+03:30", "-05:00", "+0530" into ms.
+ * Returns NaN if the string is not a valid offset.
+ */
+function parseFixedOffset(tz) {
+    const m = tz.match(/^([+-])(\d{1,2}):?(\d{2})$/);
+    if (!m)
+        return NaN;
+    const sign = m[1] === "+" ? 1 : -1;
+    const h = parseInt(m[2], 10);
+    const min = parseInt(m[3], 10);
+    return sign * (h * 60 + min) * 60000;
+}
+/**
+ * Returns the UTC offset in milliseconds for a given IANA timezone at a
+ * specific UTC moment. Uses `Intl.DateTimeFormat` for correctness.
+ *
+ * Returns 0 (UTC) if the timezone is unrecognised by the runtime.
+ */
+function getIANAOffsetMs(ianaName, atUtcMs) {
+    try {
+        // Build a formatter that reports both UTC and local time parts
+        const fmt = new Intl.DateTimeFormat("en-US", {
+            timeZone: ianaName,
+            year: "numeric",
+            month: "2-digit",
+            day: "2-digit",
+            hour: "2-digit",
+            minute: "2-digit",
+            second: "2-digit",
+            hour12: false,
+        });
+        const parts = Object.fromEntries(fmt.formatToParts(new Date(atUtcMs)).map((p) => [p.type, p.value]));
+        // Reconstruct the local time as UTC
+        const localMs = Date.UTC(parseInt(parts.year), parseInt(parts.month) - 1, parseInt(parts.day), parseInt(parts.hour === "24" ? "0" : parts.hour), parseInt(parts.minute), parseInt(parts.second));
+        return localMs - atUtcMs;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Given a UTC timestamp (ms), returns the equivalent *local* millisecond
+ * value for the given `tz` string.
+ *
+ * This is useful for display: `utcMs + offsetMs` gives local wall-clock time.
+ */
+export function utcToLocal(utcMs, tz) {
+    // Try fixed offset first (e.g. "+03:30")
+    const fixed = parseFixedOffset(tz);
+    if (!isNaN(fixed))
+        return utcMs + fixed;
+    const iana = resolveIANA(tz);
+    if (!iana)
+        return utcMs; // Unknown tz — return UTC unchanged
+    return utcMs + getIANAOffsetMs(iana, utcMs);
+}
+/**
+ * Given a *local* timestamp (ms) in `tz`, returns the equivalent UTC ms.
+ *
+ * Used when converting a calendar date expressed in local time back to UTC.
+ */
+export function localToUtc(localMs, tz) {
+    // Try fixed offset first
+    const fixed = parseFixedOffset(tz);
+    if (!isNaN(fixed))
+        return localMs - fixed;
+    const iana = resolveIANA(tz);
+    if (!iana)
+        return localMs;
+    // Approximation: compute the offset at the approximate UTC moment
+    // (offset iteration is overkill for a scheduling library)
+    const approxUtcMs = localMs - getIANAOffsetMs(iana, localMs);
+    // One correction pass for DST edge-cases
+    const correctedOffset = getIANAOffsetMs(iana, approxUtcMs);
+    return localMs - correctedOffset;
+}
+/**
+ * Returns the UTC offset string (e.g. "+03:30") for a given IANA timezone
+ * at the current moment. Useful for formatting and display.
+ */
+export function getOffsetString(tz, atUtcMs = Date.now()) {
+    // Fast-path for UTC/GMT/Z
+    const upper = tz.toUpperCase();
+    if (upper === "UTC" || upper === "GMT" || upper === "Z")
+        return "+00:00";
+    const fixed = parseFixedOffset(tz);
+    if (!isNaN(fixed))
+        return tz;
+    const iana = resolveIANA(tz);
+    if (!iana)
+        return "+00:00";
+    const offsetMs = getIANAOffsetMs(iana, atUtcMs);
+    const sign = offsetMs >= 0 ? "+" : "-";
+    const abs = Math.abs(offsetMs);
+    const h = Math.floor(abs / 3600000)
+        .toString()
+        .padStart(2, "0");
+    const m = Math.floor((abs % 3600000) / 60000)
+        .toString()
+        .padStart(2, "0");
+    return `${sign}${h}:${m}`;
+}
+//# sourceMappingURL=timezone.js.map

package/dist/esm/utils/timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.js","sourceRoot":"","sources":["../../../src/utils/timezone.ts"],"names":[],"mappings":"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"}

package/dist/esm/utils/tps-string.js

@@ -0,0 +1,160 @@
+import { TimeOrder, DefaultCalendars } from "../types";
+/**
+ * Generate the canonical `T:` time string for a set of components.
+ */
+export function buildTimePart(comp) {
+    const calendar = (comp.calendar || "").toLowerCase();
+    if (!/^[a-z]{3,4}$/.test(calendar)) {
+        throw new Error(`Invalid calendar code '${comp.calendar}'. Calendar code width must be 3–4 lowercase letters.`);
+    }
+    let time = `T:${calendar}`;
+    if (calendar === DefaultCalendars.UNIX) {
+        if (comp.unixSeconds !== undefined) {
+            time += `.s${comp.unixSeconds}`;
+        }
+        return time;
+    }
+    const tokens = [
+        ["m", comp.millennium, 8],
+        ["c", comp.century, 7],
+        ["y", comp.year, 6],
+        ["m", comp.month, 5],
+        ["d", comp.day, 4],
+        ["h", comp.hour, 3],
+        ["m", comp.minute, 2],
+        ["s", comp.second, 1],
+        ["m", comp.millisecond, 0],
+    ];
+    const order = comp.order || TimeOrder.DESC;
+    const activeTokens = order === TimeOrder.ASC ? [...tokens].reverse() : tokens;
+    for (const [pref, val] of activeTokens) {
+        if (val !== undefined) {
+            time += `.${pref}${val}`;
+        }
+    }
+    if (comp.signature) {
+        time += `!${comp.signature}`;
+    }
+    return time;
+}
+/**
+ * Parse the time portion of a TPS string into components.
+ */
+export function parseTimeString(input) {
+    let s = input.trim();
+    s = s.split(/[!;?#]/)[0];
+    if (s.startsWith("T:"))
+        s = s.slice(2);
+    const parts = s.split(".");
+    if (parts.length === 0)
+        return null;
+    const calendar = parts[0];
+    const comp = { calendar };
+    const fixedRankMap = {
+        c: 7,
+        y: 6,
+        d: 4,
+        h: 3,
+        s: 1,
+    };
+    let initialOrder = TimeOrder.DESC;
+    if (calendar !== DefaultCalendars.UNIX) {
+        const nonMRanks = [];
+        for (let i = 1; i < parts.length; i++) {
+            const pr = parts[i]?.charAt(0);
+            if (pr && pr in fixedRankMap)
+                nonMRanks.push(fixedRankMap[pr]);
+        }
+        if (nonMRanks.length >= 2) {
+            const isAsc = nonMRanks.every((v, i, a) => i === 0 || a[i - 1] <= v);
+            if (isAsc)
+                initialOrder = TimeOrder.ASC;
+        }
+    }
+    const assignMRank = (lastRank, ord) => {
+        if (ord === TimeOrder.DESC) {
+            if (lastRank === null)
+                return 8;
+            if (lastRank > 5)
+                return 5;
+            if (lastRank > 2)
+                return 2;
+            return 0;
+        }
+        else {
+            if (lastRank === null)
+                return 0;
+            if (lastRank < 2)
+                return 2;
+            if (lastRank < 5)
+                return 5;
+            return 8;
+        }
+    };
+    const ranks = [];
+    let lastAssignedRank = null;
+    for (let i = 1; i < parts.length; i++) {
+        const token = parts[i];
+        if (!token)
+            continue;
+        const prefix = token.charAt(0);
+        const value = token.slice(1);
+        if (calendar === DefaultCalendars.UNIX && prefix === "s") {
+            comp.unixSeconds = parseFloat(value);
+            ranks.push(9);
+            continue;
+        }
+        if (prefix === "m") {
+            const rank = assignMRank(lastAssignedRank, initialOrder);
+            switch (rank) {
+                case 8:
+                    comp.millennium = parseInt(value, 10);
+                    break;
+                case 5:
+                    comp.month = parseInt(value, 10);
+                    break;
+                case 2:
+                    comp.minute = parseInt(value, 10);
+                    break;
+                case 0:
+                    comp.millisecond = parseInt(value, 10);
+                    break;
+            }
+            ranks.push(rank);
+            lastAssignedRank = rank;
+        }
+        else {
+            const rank = fixedRankMap[prefix];
+            if (rank !== undefined) {
+                switch (prefix) {
+                    case "c":
+                        comp.century = parseInt(value, 10);
+                        break;
+                    case "y":
+                        comp.year = parseInt(value, 10);
+                        break;
+                    case "d":
+                        comp.day = parseInt(value, 10);
+                        break;
+                    case "h":
+                        comp.hour = parseInt(value, 10);
+                        break;
+                    case "s":
+                        comp.second = parseFloat(value);
+                        break;
+                }
+                ranks.push(rank);
+                lastAssignedRank = rank;
+            }
+        }
+    }
+    let order = TimeOrder.DESC;
+    if (ranks.length > 1) {
+        const isAsc = ranks.every((v, i, a) => i === 0 || a[i - 1] <= v);
+        const isDesc = ranks.every((v, i, a) => i === 0 || a[i - 1] >= v);
+        if (isAsc && !isDesc)
+            order = TimeOrder.ASC;
+    }
+    return { components: comp, order };
+}
+//# sourceMappingURL=tps-string.js.map

package/dist/esm/utils/tps-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tps-string.js","sourceRoot":"","sources":["../../../src/utils/tps-string.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,10 +2,18 @@
  * TPS: Temporal Positioning System
  * The Universal Protocol for Space-Time Coordinates.
  * @packageDocumentation
- * @version 0.5.34
+ * @version 0.6.0
  * @license Apache-2.0
  * @copyright 2026 TPS Standards Working Group
  *
+ * v0.5.35 Changes:
+ * - Added TPS.now(), TPS.diff(), TPS.add() convenience methods
+ * - Added Chinese Lunisolar (chin) calendar driver
+ * - Added DriverManager (driver registry separated from TPS class)
+ * - Added timezone utility (src/utils/timezone.ts) with IANA + offset support
+ * - TPS.toDate() now respects ;tz= extensions when present
+ * - ESM dual-mode exports + browser IIFE bundle
+ *
  * v0.5.0 Changes:
  * - Added Actor anchor (A:) for provenance tracking
  * - Added Signature (!) for cryptographic verification
@@ -16,9 +24,13 @@ export * from "./types";
 export * from "./uid";
 export * from "./date";
 export { Env } from "./utils/env";
+export { DriverManager } from "./driver-manager";
+export { utcToLocal, localToUtc, getOffsetString } from "./utils/timezone";
+import { DriverManager } from "./driver-manager";
 import { CalendarDriver, TPSComponents, TimeOrder } from "./types";
 export declare class TPS {
-    private static readonly drivers;
+    /** Shared DriverManager instance — use TPS.driverManager for direct access. */
+    static readonly driverManager: DriverManager;
     /**
      * Registers a calendar driver plugin.
      * @param driver - The driver instance to register.
@@ -144,7 +156,84 @@ export declare class TPS {
      * ```
      */
     static formatCalendarDate(calendar: string, components: Partial<TPSComponents>, format?: string): string;
+    /**
+     * Returns a TPS time string for the current moment.
+     * Shorthand for `TPS.fromDate(new Date(), calendar, opts)`.
+     *
+     * @param calendar - Calendar code. Defaults to 'greg'.
+     * @param opts - Optional `order` (ASC/DESC) parameter.
+     * @returns TPS time string.
+     *
+     * @example
+     * ```ts
+     * TPS.now(); // "T:greg.m3.c1.y26.m3.d4.h06.m30.s00.m0"
+     * TPS.now('hij'); // "T:hij.y1447.m09.d05.h06.m30.s00"
+     * ```
+     */
+    static now(calendar?: string, opts?: {
+        order?: TimeOrder;
+    }): string;
+    /**
+     * Returns the difference in milliseconds between two TPS strings.
+     * The result is `t2 - t1`; negative if t1 is after t2.
+     *
+     * @param t1 - First TPS string (subtracted from t2).
+     * @param t2 - Second TPS string.
+     * @returns Milliseconds between the two moments, or NaN on parse failure.
+     *
+     * @example
+     * ```ts
+     * const ms = TPS.diff('T:greg.m3.c1.y26.m1.d1.h0.m0.s0.m0',
+     *                       'T:greg.m3.c1.y26.m1.d2.h0.m0.s0.m0');
+     * // 86_400_000  (one day)
+     * ```
+     */
+    static diff(t1: string, t2: string): number;
+    /**
+     * Returns a new TPS string shifted by the given duration.
+     * The result is in the same calendar as the original string.
+     *
+     * @param tpsStr - Source TPS string.
+     * @param duration - Object with optional `days`, `hours`, `minutes`, `seconds`, `milliseconds`.
+     * @returns Shifted TPS string, or null if the input is invalid.
+     *
+     * @example
+     * ```ts
+     * const t = 'T:greg.m3.c1.y26.m1.d9.h14.m30.s25.m0';
+     * TPS.add(t, { days: 7 });   // one week later
+     * TPS.add(t, { hours: -2 }); // two hours earlier
+     * ```
+     */
+    static add(tpsStr: string, duration: {
+        days?: number;
+        hours?: number;
+        minutes?: number;
+        seconds?: number;
+        milliseconds?: number;
+    }): string | null;
     private static _mapGroupsToComponents;
+    /**
+     * Parses a multi-layer location string (before @T:) into component fields.
+     * Layers are `;`-separated. Each layer is identified by its prefix token.
+     *
+     * Supported layers:
+     *   L:lat,lon[,altm]         — GPS
+     *   L:~|L:-|L:redacted       — Privacy markers
+     *   P:cc=JO,ci=AMM,...       — Place (country/city codes and names)
+     *   S2:token                 — S2 cell
+     *   H3:token                 — H3 cell
+     *   3W:word.word.word        — What3Words
+     *   plus:token               — Plus Code
+     *   net:ip4:x.x.x.x          — IPv4
+     *   net:ip6:x::x             — IPv6
+     *   node:name                — Logical node/host
+     *   bldg:name                — Building
+     *   floor:x                  — Floor
+     *   room:x                   — Room
+     *   door:x                   — Door
+     *   zone:x                   — Zone
+     */
+    private static _parseLocationLayers;
 }
 /**
  * `TpsDate` is a Date-like wrapper with native TPS conversion helpers.