@nextera.one/tps-standard 0.5.33 → 0.6.0

package/CHANGELOG.md

@@ -0,0 +1,88 @@
+# Changelog
+
+All notable changes to `@nextera.one/tps-standard` are documented here.
+
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
+
+---
+
+## [0.5.35] — 2026-03-04
+
+### Added
+
+- **`TPS.now(calendar?, opts?)`** — shorthand for `TPS.fromDate(new Date(), calendar, opts)`.
+- **`TPS.diff(t1, t2)`** — returns elapsed time in milliseconds between two TPS strings (`t2 − t1`).
+- **`TPS.add(tpsStr, duration)`** — returns a new TPS string shifted by a `{days, hours, minutes, seconds, milliseconds}` duration object. Preserves original calendar and time order.
+- **Chinese Lunisolar calendar driver** (`chin`) — Huangdi year numbering (≈4722 = 2024 CE), Sexagenary ganzhi cycle, month formatting in romanized and Chinese character form (`zh` format).
+- **`DriverManager` class** — dedicated driver registry. `TPS.driverManager` exposes `register()`, `get()`, `has()`, `list()`, and `unregister()`. The static `TPS.registerDriver()` / `TPS.getDriver()` methods are preserved as convenience shorthands.
+- **`src/utils/timezone.ts`** — zero-dependency timezone utility using `Intl.DateTimeFormat`. Supports IANA names (`Asia/Tehran`), fixed offsets (`+03:30`), and common abbreviations (`IRST`, `JST`, `EST`, …).
+- **Timezone-aware `TPS.toDate()`** — when a parsed TPS URI has a `;tz=` extension, the returned `Date` is automatically converted from local → UTC.
+- **ESM dual-mode build** — `dist/esm/index.js` emitted via `tsconfig.esm.json`. `package.json` `"exports"` field routes `import` to ESM and `require` to CJS.
+- **Browser IIFE bundle** — `dist/tps.min.js` (global `window.TPS`) built via Rollup (`npm run bundle`).
+
+### Changed
+
+- Internal driver registry moved from a private `Map` in `TPS` to `DriverManager`.
+- `package.json`: added `"module"`, `"browser"`, `"exports"` fields; build script now also emits ESM.
+
+---
+
+## [0.5.34] — 2026-03-04
+
+### Changed
+
+- Version bump after authentication issue during 0.5.4 publish attempt.
+
+---
+
+## [0.5.33] — 2026-03-03
+
+### Added
+
+- Full library modularization:
+  - `src/types.ts` — shared interfaces and enums.
+  - `src/uid.ts` — `TPSUID7RB` binary UID logic.
+  - `src/date.ts` — `TpsDate` wrapper with component caching.
+  - `src/utils/env.ts` — Node.js / Browser polyfill layer.
+  - `src/utils/calendar.ts` — centralized JDN math.
+  - `src/utils/tps-string.ts` — TPS string build / parse utilities (breaks circular deps).
+- Calendar drivers: **Persian** (`per`), **Hijri** (`hij`), **Julian** (`jul`), **Holocene** (`holo`).
+- `TPS.parseCalendarDate()`, `TPS.fromCalendarDate()`, `TPS.formatCalendarDate()` convenience helpers.
+- `TPS.sanitizeTimeInput()` — normalizes casing, whitespace, legacy `/T:` separator, and detects ascending order.
+
+### Fixed
+
+- Persian calendar JDN → month calculation typo (divisor 108 → 31).
+- All circular dependencies between drivers and the main TPS class.
+
+---
+
+## [0.5.3] — 2026-03-02
+
+### Changed
+
+- Minor internal refactoring and stability fixes.
+
+---
+
+## [0.5.2] — 2026-02-28
+
+### Added
+
+- `TPSUID7RB` binary reversible IDs.
+- Ascending (`TimeOrder.ASC`) time string support.
+- Pre-`@` generic space anchors (`adm:`, `node:`, `net:ip4:`, `planet:`, …).
+- Structural anchors (`bldg=`, `floor=`, `room=`, `zone=`).
+- Geospatial cell anchors (`s2=`, `h3=`, `plus=`, `w3w=`).
+- Actor anchor (`A:`), cryptographic signature (`!`).
+
+---
+
+## [0.5.0] — 2026-02-01
+
+### Added
+
+- Initial public release.
+- Core TPS URI parsing, validation, and serialization.
+- Gregorian (`greg`) and Unix (`unix`) built-in calendar drivers.
+- `TpsDate` — Date-like wrapper with TPS conversion helpers.

package/README.md

@@ -21,14 +21,18 @@ import {
   TPSUID7RB,
 } from "@nextera.one/tps-standard";
 
-// 1) Date -> TPS time string
+// Current time in Gregorian
+const now = TPS.now();
+// "T:greg.m3.c1.y26.m3.d4.h06.m30.s00.m0"
+
+// Convert a Date to TPS
 const tpsTime = TPS.fromDate(
   new Date("2026-01-09T14:30:25Z"),
   DefaultCalendars.GREG,
 );
-// T:greg.m3.c1.y26.m1.d9.h14.m30.s25.m0
+// "T:greg.m3.c1.y26.m1.d9.h14.m30.s25.m0"
 
-// 2) Build full TPS URI
+// Build a full TPS URI with coordinates
 const uri = TPS.toURI({
   calendar: "greg",
   millennium: 3,
@@ -44,113 +48,186 @@ const uri = TPS.toURI({
   longitude: 35.91,
   altitude: 800,
 });
-// tps://L:31.95,35.91,800m@T:greg.m3.c1.y26.m1.d9.h14.m30.s25.m0
+// "tps://L:31.95,35.91,800m@T:greg.m3.c1.y26.m1.d9.h14.m30.s25.m0"
 
-// 3) Parse back
+// Parse back
 const parsed = TPS.parse(uri);
 
-// 4) Generate reversible TPS UID (binary base64url form)
+// Generate reversible TPS UID (binary base64url)
 const uid = TPSUID7RB.encodeBinaryB64(uri);
 const decoded = TPSUID7RB.decodeBinaryB64(uid);
 ```
 
+---
+
+## Calendars
+
+8 built-in calendar drivers are registered automatically:
+
+| Code   | Calendar                     | Notes                                            |
+| ------ | ---------------------------- | ------------------------------------------------ |
+| `tps`  | TPS Native                   | Hierarchical millennium/century/year tokens      |
+| `greg` | Gregorian                    | ISO proleptic calendar                           |
+| `unix` | Unix Epoch                   | seconds since 1970-01-01T00:00:00Z               |
+| `per`  | Persian (Jalali/Solar Hijri) | Solar calendar, used in Iran & Afghanistan       |
+| `hij`  | Hijri (Islamic Tabular)      | Lunar calendar, 12 months × 29/30 days           |
+| `jul`  | Julian                       | Historical proleptic; Gregorian is 13d ahead now |
+| `holo` | Holocene (Human Era)         | Gregorian + 10,000                               |
+| `chin` | Chinese Lunisolar            | Huangdi year numbering + Ganzhi cycle            |
+
+### Examples
+
+```ts
+// Persian
+TPS.fromDate(new Date(), "per"); // "T:per.y1404.m12.d14.h10.m0.s0"
+
+// Hijri
+TPS.fromDate(new Date(), "hij"); // "T:hij.y1447.m09.d04.h10.m0.s0"
+
+// Chinese
+TPS.fromDate(new Date(), "chin"); // "T:chin.m5.c5.y26.m1.d14.h10.m0.s0"
+TPS.getDriver("chin")!.format(
+  { millennium: 5, century: 5, year: 26, month: 1, day: 14 },
+  "zh",
+);
+// "4726年正月14日"
+
+// Julian
+TPS.fromDate(new Date(), "jul"); // "T:jul.m3.c1.y26.m2.d19.h10.m0.s0"
+
+// Holocene
+TPS.fromDate(new Date(), "holo"); // "T:holo.m4.c3.y26.m3.d4.h10.m0.s0" (12026 HE)
+```
+
+Custom drivers can be registered via:
+
+```ts
+TPS.registerDriver(myDriver);
+// or via the DriverManager:
+TPS.driverManager.register(myDriver);
+console.log(TPS.driverManager.list()); // ["tps","greg","unix","per","hij","jul","holo","chin",...]
+```
+
+---
+
 ## Time Format
 
-Canonical time token order is descending hierarchy:
+Canonical token order is **descending hierarchy**:
 
-```txt
+```
 T:greg.m3.c1.y26.m01.d13.h09.m30.s12.m0
 ```
 
-Where:
+| Token        | Meaning         |
+| ------------ | --------------- |
+| `m` (rank 8) | millennium      |
+| `c`          | century         |
+| `y`          | year in century |
+| `m` (rank 5) | month           |
+| `d`          | day             |
+| `h`          | hour            |
+| `m` (rank 2) | minute          |
+| `s`          | second          |
+| `m` (rank 0) | millisecond     |
 
-- `m` (rank 8) = millennium
-- `c` = century
-- `y` = year in century
-- `m` (rank 5) = month
-- `d` = day
-- `h` = hour
-- `m` (rank 2) = minute
-- `s` = second
-- `m` (rank 0) = millisecond
+Ascending order is supported via `TimeOrder.ASC` and auto-detected during parsing.
 
-Ascending order is supported via `TimeOrder.ASC` and is auto-detected during parsing.
+---
 
 ## URI Format
 
-```txt
-tps://[SPACE][ /A:actor ]@T:[calendar].[tokens][!signature][;extensions][?query][#fragment]
+```
+tps://[SPACE][/A:actor]@T:[calendar].[tokens][!signature][;extensions][?query][#fragment]
 ```
 
-### Supported space anchors
-
-- Privacy: `L:-`, `L:~`, `L:redacted`, `unknown`, `hidden`, `redacted`
-- Coordinates: `L:lat,lon[,alt]m`
-- Cells: `L:s2=...`, `L:h3=...`, `L:plus=...`, `L:w3w=...`
-- Structural: `L:bldg=...(.floor=...)(.room=...)(.zone=...)`
-- Generic pre-`@` anchors: `adm:...`, `node:...`, `net:ip4:...`, `net:ip6:...`, `planet:...`, `P:...`
+### Space Anchors
 
-## Calendars
+| Pattern                                | Meaning                               |
+| -------------------------------------- | ------------------------------------- |
+| `L:-`, `L:unknown`                     | Unknown / anonymous location          |
+| `L:~`, `L:hidden`                      | Hidden location                       |
+| `L:redacted`                           | Redacted location                     |
+| `L:lat,lon[,alt]m`                     | GPS coordinates                       |
+| `L:s2=...`                             | S2 Cell                               |
+| `L:h3=...`                             | H3 Cell                               |
+| `L:plus=...`                           | Plus Code                             |
+| `L:w3w=...`                            | What3Words                            |
+| `L:bldg=...`                           | Structural (building/floor/room/zone) |
+| `adm:`, `node:`, `net:ip4:`, `planet:` | Generic pre-`@` anchors               |
 
-Built-in drivers:
+### Timezone Extension
 
-- `tps`
-- `greg`
-- `unix`
+Add `;tz=` to have `TPS.toDate()` interpret the calendar components as local time:
 
-Additional calendars can be plugged in via `TPS.registerDriver(driver)`.
+```ts
+// 14:30 in Tehran time → UTC 11:00
+TPS.toDate("tps://unknown@T:greg.m3.c1.y26.m1.d9.h14.m30.s0.m0;tz=Asia/Tehran");
+// or
+TPS.toDate("T:greg.m3.c1.y26.m1.d9.h14.m30.s0.m0;tz=+03:30");
+```
 
-Calendar code width is enforced to **3–4 lowercase letters** when generating TPS time strings.
+Supported: IANA names (`Asia/Tehran`), fixed offsets (`+03:30`, `-05:00`), and common abbreviations (`IRST`, `JST`, `EST`, …).
 
-## TpsDate
+---
 
-`TpsDate` is a Date-like wrapper that works directly with TPS.
+## Convenience Methods
 
 ```ts
-import {
-  TpsDate,
-  DefaultCalendars,
-  TimeOrder,
-} from "@nextera.one/tps-standard";
+// Current time
+TPS.now(); // Gregorian by default
+TPS.now("hij"); // Current time in Hijri
+
+// Time difference
+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)
+
+// Shift by duration
+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
+TPS.add(t, { minutes: 90, seconds: 30 }); // +1h 30m 30s
+```
 
-const td = new TpsDate("tps://unknown@T:greg.m3.c1.y26.m01.d09.h14.m30.s25.m0");
+---
 
-// Native Gregorian Date clone
-const gregorian = td.toGregorianDate();
+## TpsDate
 
-// Alias (same value)
-const same = td.toDate();
+```ts
+const td = new TpsDate("tps://unknown@T:greg.m3.c1.y26.m01.d09.h14.m30.s25.m0");
 
-// TPS time in desired calendar
+const gregorian = td.toGregorianDate(); // native JS Date clone
 const asTps = td.toTPS(DefaultCalendars.TPS, { order: TimeOrder.DESC });
-
-// Full URI
 const uri = td.toTPSURI(DefaultCalendars.GREG, {
   latitude: 31.95,
   longitude: 35.91,
-  altitude: 800,
 });
 ```
 
+---
+
 ## TPSUID7RB (Reversible Binary ID)
 
 ```ts
-import { TPSUID7RB } from "@nextera.one/tps-standard";
-
 const tps = "tps://node:api-1@T:greg.m3.c1.y26.m01.d09.h14.m30.s25.m0";
-
 const id = TPSUID7RB.encodeBinaryB64(tps, { compress: true });
 const out = TPSUID7RB.decodeBinaryB64(id);
 // out.tps === tps
 ```
 
+---
+
 ## Scripts
 
 ```bash
-npm run build
-npm run tests
+npm run build    # CJS + ESM TypeScript compilation
+npm run bundle   # Browser IIFE bundle (dist/tps.min.js)
+npm run tests    # Run all test suites
 ```
 
+---
+
 ## License
 
 Apache-2.0

package/dist/date.d.ts

@@ -0,0 +1,54 @@
+/**
+ * TpsDate Date-like wrapper with native TPS conversion helpers.
+ */
+import { TimeOrder } from "./types";
+export declare class TpsDate {
+    private readonly internal;
+    private _cachedComponents;
+    private _cachedTps;
+    constructor();
+    constructor(value: string | number | Date | TpsDate);
+    constructor(year: number, monthIndex: number, day?: number, hours?: number, minutes?: number, seconds?: number, ms?: number);
+    private static looksLikeTPS;
+    private getTpsComponents;
+    private getTpsFullYear;
+    static now(): number;
+    static parse(input: string): number;
+    static UTC(year: number, monthIndex: number, day?: number, hours?: number, minutes?: number, seconds?: number, ms?: number): number;
+    static fromTPS(tps: string): TpsDate;
+    toGregorianDate(): Date;
+    toDate(): Date;
+    toTPS(calendar?: string, opts?: {
+        order?: TimeOrder;
+    }): string;
+    toTPSURI(calendar?: string, opts?: {
+        order?: TimeOrder;
+        latitude?: number;
+        longitude?: number;
+        altitude?: number;
+        isUnknownLocation?: boolean;
+        isHiddenLocation?: boolean;
+        isRedactedLocation?: boolean;
+    }): string;
+    getTime(): number;
+    valueOf(): number;
+    toString(): string;
+    toISOString(): string;
+    toUTCString(): string;
+    toJSON(): string | null;
+    getFullYear(): number;
+    getUTCFullYear(): number;
+    getMonth(): number;
+    getUTCMonth(): number;
+    getDate(): number;
+    getUTCDate(): number;
+    getHours(): number;
+    getUTCHours(): number;
+    getMinutes(): number;
+    getUTCMinutes(): number;
+    getSeconds(): number;
+    getUTCSeconds(): number;
+    getMilliseconds(): number;
+    getUTCMilliseconds(): number;
+    [Symbol.toPrimitive](hint: string): string | number;
+}

package/dist/date.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * TpsDate Date-like wrapper with native TPS conversion helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TpsDate = void 0;
+const types_1 = require("./types");
+const index_1 = require("./index");
+class TpsDate {
+    constructor(...args) {
+        this._cachedComponents = null;
+        this._cachedTps = null;
+        if (args.length === 0) {
+            this.internal = new Date();
+            return;
+        }
+        if (args.length === 1) {
+            const value = args[0];
+            if (value instanceof TpsDate) {
+                this.internal = new Date(value.getTime());
+                return;
+            }
+            if (value instanceof Date) {
+                this.internal = new Date(value.getTime());
+                return;
+            }
+            if (typeof value === "string" && TpsDate.looksLikeTPS(value)) {
+                const parsed = index_1.TPS.toDate(value);
+                if (!parsed) {
+                    throw new RangeError(`Invalid TPS date string: ${value}`);
+                }
+                this.internal = parsed;
+                return;
+            }
+            this.internal = new Date(value);
+            return;
+        }
+        const [year, monthIndex, day, hours, minutes, seconds, ms] = args;
+        this.internal = new Date(year, monthIndex, day ?? 1, hours ?? 0, minutes ?? 0, seconds ?? 0, ms ?? 0);
+    }
+    static looksLikeTPS(input) {
+        const s = input.trim();
+        return s.startsWith("tps://") || s.startsWith("T:") || s.startsWith("t:");
+    }
+    getTpsComponents() {
+        const currentTps = this.toTPS(types_1.DefaultCalendars.TPS);
+        if (this._cachedTps === currentTps && this._cachedComponents) {
+            return this._cachedComponents;
+        }
+        const parsed = index_1.TPS.parse(currentTps);
+        if (!parsed) {
+            throw new Error("TpsDate: failed to derive TPS components");
+        }
+        this._cachedTps = currentTps;
+        this._cachedComponents = parsed;
+        return parsed;
+    }
+    getTpsFullYear() {
+        const comp = this.getTpsComponents();
+        return (comp.millennium - 1) * 1000 + (comp.century - 1) * 100 + comp.year;
+    }
+    static now() {
+        return Date.now();
+    }
+    static parse(input) {
+        if (this.looksLikeTPS(input)) {
+            const d = index_1.TPS.toDate(input);
+            return d ? d.getTime() : Number.NaN;
+        }
+        return Date.parse(input);
+    }
+    static UTC(year, monthIndex, day, hours, minutes, seconds, ms) {
+        return Date.UTC(year, monthIndex, day ?? 1, hours ?? 0, minutes ?? 0, seconds ?? 0, ms ?? 0);
+    }
+    static fromTPS(tps) {
+        return new TpsDate(tps);
+    }
+    toGregorianDate() {
+        return new Date(this.internal.getTime());
+    }
+    toDate() {
+        return this.toGregorianDate();
+    }
+    toTPS(calendar = types_1.DefaultCalendars.TPS, opts) {
+        return index_1.TPS.fromDate(this.internal, calendar, opts);
+    }
+    toTPSURI(calendar = types_1.DefaultCalendars.TPS, opts) {
+        const time = this.toTPS(calendar, { order: opts?.order });
+        const comp = index_1.TPS.parse(time);
+        if (opts?.latitude !== undefined && opts?.longitude !== undefined) {
+            comp.latitude = opts.latitude;
+            comp.longitude = opts.longitude;
+            if (opts.altitude !== undefined)
+                comp.altitude = opts.altitude;
+        }
+        else if (opts?.isHiddenLocation) {
+            comp.isHiddenLocation = true;
+        }
+        else if (opts?.isRedactedLocation) {
+            comp.isRedactedLocation = true;
+        }
+        else {
+            comp.isUnknownLocation = true;
+        }
+        return index_1.TPS.toURI(comp);
+    }
+    getTime() {
+        return this.internal.getTime();
+    }
+    valueOf() {
+        return this.internal.valueOf();
+    }
+    toString() {
+        return this.toTPS(types_1.DefaultCalendars.TPS);
+    }
+    toISOString() {
+        return this.internal.toISOString();
+    }
+    toUTCString() {
+        return this.internal.toUTCString();
+    }
+    toJSON() {
+        return this.internal.toJSON();
+    }
+    getFullYear() {
+        return this.getTpsFullYear();
+    }
+    getUTCFullYear() {
+        return this.getTpsFullYear();
+    }
+    getMonth() {
+        return this.getTpsComponents().month - 1;
+    }
+    getUTCMonth() {
+        return this.getTpsComponents().month - 1;
+    }
+    getDate() {
+        return this.getTpsComponents().day;
+    }
+    getUTCDate() {
+        return this.getTpsComponents().day;
+    }
+    getHours() {
+        return this.getTpsComponents().hour;
+    }
+    getUTCHours() {
+        return this.getTpsComponents().hour;
+    }
+    getMinutes() {
+        return this.getTpsComponents().minute;
+    }
+    getUTCMinutes() {
+        return this.getTpsComponents().minute;
+    }
+    getSeconds() {
+        return this.getTpsComponents().second;
+    }
+    getUTCSeconds() {
+        return this.getTpsComponents().second;
+    }
+    getMilliseconds() {
+        return this.getTpsComponents().millisecond;
+    }
+    getUTCMilliseconds() {
+        return this.getTpsComponents().millisecond;
+    }
+    [Symbol.toPrimitive](hint) {
+        if (hint === "number")
+            return this.valueOf();
+        return this.toString();
+    }
+}
+exports.TpsDate = TpsDate;
+//# sourceMappingURL=date.js.map

package/dist/date.js.map

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

package/dist/driver-manager.d.ts

@@ -0,0 +1,34 @@
+/**
+ * TPS DriverManager
+ * Manages the registry of calendar driver plugins.
+ */
+import { CalendarDriver } from "./types";
+/**
+ * A dedicated registry for TPS calendar driver plugins.
+ * The global `TPS` class exposes a shared singleton instance (`TPS.driverManager`).
+ */
+export declare class DriverManager {
+    private readonly registry;
+    /**
+     * Registers a calendar driver.
+     * Overwrites any previously registered driver with the same code.
+     */
+    register(driver: CalendarDriver): void;
+    /**
+     * Returns the driver registered for the given calendar code, or `undefined`.
+     */
+    get(code: string): CalendarDriver | undefined;
+    /**
+     * Returns `true` if a driver with the given code has been registered.
+     */
+    has(code: string): boolean;
+    /**
+     * Returns an array of all registered calendar codes.
+     */
+    list(): string[];
+    /**
+     * Removes a driver from the registry.
+     * Returns `true` if the driver existed and was removed.
+     */
+    unregister(code: string): boolean;
+}

package/dist/driver-manager.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * TPS DriverManager
+ * Manages the registry of calendar driver plugins.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DriverManager = void 0;
+/**
+ * A dedicated registry for TPS calendar driver plugins.
+ * The global `TPS` class exposes a shared singleton instance (`TPS.driverManager`).
+ */
+class DriverManager {
+    constructor() {
+        this.registry = new Map();
+    }
+    /**
+     * Registers a calendar driver.
+     * Overwrites any previously registered driver with the same code.
+     */
+    register(driver) {
+        if (!driver || !driver.code) {
+            throw new Error("DriverManager: driver must have a valid `code` string.");
+        }
+        this.registry.set(driver.code, driver);
+    }
+    /**
+     * Returns the driver registered for the given calendar code, or `undefined`.
+     */
+    get(code) {
+        return this.registry.get(code);
+    }
+    /**
+     * Returns `true` if a driver with the given code has been registered.
+     */
+    has(code) {
+        return this.registry.has(code);
+    }
+    /**
+     * Returns an array of all registered calendar codes.
+     */
+    list() {
+        return Array.from(this.registry.keys());
+    }
+    /**
+     * Removes a driver from the registry.
+     * Returns `true` if the driver existed and was removed.
+     */
+    unregister(code) {
+        return this.registry.delete(code);
+    }
+}
+exports.DriverManager = DriverManager;
+//# sourceMappingURL=driver-manager.js.map

package/dist/driver-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-manager.js","sourceRoot":"","sources":["../src/driver-manager.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH;;;GAGG;AACH,MAAa,aAAa;IAA1B;QACmB,aAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAyChE,CAAC;IAvCC;;;OAGG;IACH,QAAQ,CAAC,MAAsB;QAC7B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AA1CD,sCA0CC"}