@matter/general 0.16.0-alpha.0-20250817-1b000357c → 0.16.0-alpha.0-20250820-24939dd26

package/dist/esm/time/Time.d.ts

@@ -5,6 +5,8 @@
  */
 import { CancelablePromise } from "#util/Cancelable.js";
 import { Diagnostic } from "../log/Diagnostic.js";
+import { Duration } from "./Duration.js";
+import type { Timestamp } from "./Timestamp.js";
 /**
  * Timer and date/time management interface.
  *
@@ -12,32 +14,32 @@ import { Diagnostic } from "../log/Diagnostic.js";
  * environment.
  */
 export declare class Time {
-    static get: () => Time;
+    static default: Time;
     static startup: {
-        systemMs: number;
-        processMs: number;
+        systemMs: Timestamp;
+        processMs: Timestamp;
     };
-    now(): Date;
-    static readonly now: () => Date;
-    nowMs(): number;
-    static readonly nowMs: () => number;
-    nowUs(): number;
-    static readonly nowUs: () => number;
+    get now(): Date;
+    static get now(): Date;
+    get nowMs(): number;
+    static get nowMs(): Timestamp;
+    get nowUs(): Timestamp;
+    static get nowUs(): Timestamp;
     /**
      * Create a timer that will call callback after durationMs has passed.
      */
-    getTimer(name: string, durationMs: number, callback: Timer.Callback): Timer;
-    static readonly getTimer: (name: string, durationMs: number, callback: Timer.Callback) => Timer;
+    getTimer(name: string, duration: Duration, callback: Timer.Callback): Timer;
+    static readonly getTimer: (name: string, duration: Duration, callback: Timer.Callback) => Timer;
     /**
      * Create a timer that will periodically call callback at intervalMs intervals.
      */
-    getPeriodicTimer(name: string, intervalMs: number, callback: Timer.Callback): Timer;
-    static readonly getPeriodicTimer: (name: string, intervalMs: number, callback: Timer.Callback) => Timer;
+    getPeriodicTimer(name: string, duration: Duration, callback: Timer.Callback): Timer;
+    static readonly getPeriodicTimer: (name: string, duration: Duration, callback: Timer.Callback) => Timer;
     /**
      * Create a promise that resolves after a specific interval or when canceled, whichever comes first.
      */
-    sleep(name: string, durationMs: number): CancelablePromise;
-    static sleep(name: string, durationMs: number): CancelablePromise<void>;
+    sleep(name: string, duration: Duration): CancelablePromise;
+    static sleep(name: string, duration: Duration): CancelablePromise<void>;
     static register(timer: Timer): void;
     static unregister(timer: Timer): void;
     static get timers(): Set<Timer>;
@@ -50,7 +52,7 @@ export interface Timer {
     /** System ID (diagnostics) */
     systemId: unknown;
     /** Interval (diagnostics) */
-    intervalMs: number;
+    interval: Duration;
     /** Is the timer periodic? (diagnostics) */
     isPeriodic: boolean;
     /** Amount of time interval has been active (diagnostics) */
@@ -72,14 +74,14 @@ export declare class StandardTimer implements Timer {
     readonly isPeriodic: boolean;
     isRunning: boolean;
     get systemId(): number;
-    constructor(name: string, intervalMs: number, callback: Timer.Callback, isPeriodic: boolean);
+    constructor(name: string, duration: Duration, callback: Timer.Callback, isPeriodic: boolean);
     /**
      * The timer's interval.
      *
      * You can change this value but changes have no effect until the timer restarts.
      */
-    set intervalMs(intervalMs: number);
-    get intervalMs(): number;
+    set interval(interval: Duration);
+    get interval(): Duration;
     get utility(): boolean;
     set utility(utility: boolean);
     start(): this;

package/dist/esm/time/Time.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/time/Time.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKlD;;;;;GAKG;AACH,qBAAa,IAAI;IACb,MAAM,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;IAEvB,MAAM,CAAC,OAAO;;;MAGZ;IAEF,GAAG;IAGH,MAAM,CAAC,QAAQ,CAAC,GAAG,QAAO,IAAI,CAAqB;IAEnD,KAAK;IAGL,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAO,MAAM,CAAuB;IAEzD,KAAK;IAGL,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAO,MAAM,CAAuB;IAEzD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,KAAK;IAG3E,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAI,MAAM,MAAM,EAAE,YAAY,MAAM,EAAE,UAAU,KAAK,CAAC,QAAQ,KAAG,KAAK,CAC1C;IAEpD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,KAAK;IAGnF,MAAM,CAAC,QAAQ,CAAC,gBAAgB,GAAI,MAAM,MAAM,EAAE,YAAY,MAAM,EAAE,UAAU,KAAK,CAAC,QAAQ,KAAG,KAAK,CAC1C;IAE5D;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB;IAgB1D,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAI7C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK;IAK5B,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK;IAI9B,MAAM,KAAK,MAAM,eAEhB;CACJ;AAOD,MAAM,WAAW,KAAK;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IAEb,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAElB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IAEpB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC;IAE7B,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,KAAK,IAAI,KAAK,CAAC;IAEf,mCAAmC;IACnC,IAAI,IAAI,KAAK,CAAC;CACjB;AAED,yBAAiB,KAAK,CAAC;IACnB,KAAY,QAAQ,GAAG,MAAM,GAAG,CAAC;CACpC;AAED,qBAAa,aAAc,YAAW,KAAK;;IAWnC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAErB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO;IAVhC,SAAS,UAAS;IAElB,IAAI,QAAQ,WAEX;gBAGY,IAAI,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EACD,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAChC,UAAU,EAAE,OAAO;IAKhC;;;;OAIG;IACH,IAAI,UAAU,CAAC,UAAU,EAAE,MAAM,EAOhC;IAED,IAAI,UAAU,IATa,MAAM,CAWhC;IAED,IAAI,OAAO,IAIU,OAAO,CAF3B;IAED,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,EAgB3B;IAED,KAAK;IAcL,IAAI;CAMP"}
+{"version":3,"file":"Time.d.ts","sourceRoot":"","sources":["../../../src/time/Time.ts"],"names":[],"mappings":"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"}

package/dist/esm/time/Time.js

@@ -8,49 +8,56 @@ import { CancelablePromise } from "#util/Cancelable.js";
 import { ImplementationError } from "../MatterError.js";
 import { Diagnostic } from "../log/Diagnostic.js";
 import { DiagnosticSource } from "../log/DiagnosticSource.js";
+import { Instant } from "./TimeUnit.js";
 const registry = /* @__PURE__ */ new Set();
 class Time {
-  static get;
+  static default;
   static startup = {
     systemMs: 0,
     processMs: 0
   };
-  now() {
+  get now() {
     return /* @__PURE__ */ new Date();
   }
-  static now = () => Time.get().now();
-  nowMs() {
+  static get now() {
+    return Time.default.now;
+  }
+  get nowMs() {
     return Date.now();
   }
-  static nowMs = () => Time.get().nowMs();
-  nowUs() {
-    return Math.floor(performance.now() + performance.timeOrigin) * 1e3;
+  static get nowMs() {
+    return Time.default.nowMs;
+  }
+  get nowUs() {
+    return Math.floor(performance.now() + performance.timeOrigin);
+  }
+  static get nowUs() {
+    return Time.default.nowUs;
   }
-  static nowUs = () => Time.get().nowUs();
   /**
    * Create a timer that will call callback after durationMs has passed.
    */
-  getTimer(name, durationMs, callback) {
-    return new StandardTimer(name, durationMs, callback, false);
+  getTimer(name, duration, callback) {
+    return new StandardTimer(name, duration, callback, false);
   }
-  static getTimer = (name, durationMs, callback) => Time.get().getTimer(name, durationMs, callback);
+  static getTimer = (name, duration, callback) => Time.default.getTimer(name, duration, callback);
   /**
    * Create a timer that will periodically call callback at intervalMs intervals.
    */
-  getPeriodicTimer(name, intervalMs, callback) {
-    return new StandardTimer(name, intervalMs, callback, true);
+  getPeriodicTimer(name, duration, callback) {
+    return new StandardTimer(name, duration, callback, true);
   }
-  static getPeriodicTimer = (name, intervalMs, callback) => Time.get().getPeriodicTimer(name, intervalMs, callback);
+  static getPeriodicTimer = (name, duration, callback) => Time.default.getPeriodicTimer(name, duration, callback);
   /**
    * Create a promise that resolves after a specific interval or when canceled, whichever comes first.
    */
-  sleep(name, durationMs) {
+  sleep(name, duration) {
     let timer;
     let resolver;
     return new CancelablePromise(
       (resolve) => {
         resolver = resolve;
-        timer = Time.getTimer(name, durationMs, resolve);
+        timer = Time.getTimer(name, duration, resolve);
         timer.start();
       },
       () => {
@@ -59,8 +66,8 @@ class Time {
       }
     );
   }
-  static sleep(name, durationMs) {
-    return Time.get().sleep(name, durationMs);
+  static sleep(name, duration) {
+    return Time.default.sleep(name, duration);
   }
   static register(timer) {
     registry.add(timer);
@@ -74,18 +81,23 @@ class Time {
   }
 }
 if (!performance || typeof performance.now !== "function" || typeof performance.timeOrigin !== "number") {
-  Time.prototype.nowUs = () => Time.nowMs() * 1e3;
+  Object.defineProperty(Time.prototype, "nowUs", {
+    get() {
+      return Time.nowMs;
+    }
+  });
 }
 class StandardTimer {
-  constructor(name, intervalMs, callback, isPeriodic) {
+  constructor(name, duration, callback, isPeriodic) {
     this.name = name;
     this.callback = callback;
     this.isPeriodic = isPeriodic;
-    this.intervalMs = intervalMs;
+    this.interval = duration;
   }
   #timerId;
   #utility = false;
-  #intervalMs = -1;
+  #interval = Instant;
+  // Real value installed in constructor
   isRunning = false;
   get systemId() {
     return Number(this.#timerId);
@@ -95,16 +107,16 @@ class StandardTimer {
    *
    * You can change this value but changes have no effect until the timer restarts.
    */
-  set intervalMs(intervalMs) {
-    if (intervalMs < 0 || intervalMs > 2147483647) {
+  set interval(interval) {
+    if (interval < 0 || interval > 2147483647) {
       throw new ImplementationError(
-        `Invalid intervalMs: ${intervalMs}. The value must be between 0 and 32-bit maximum value (2147483647)`
+        `Invalid intervalMs: ${interval}. The value must be between 0 and 32-bit maximum value (2147483647)`
       );
     }
-    this.#intervalMs = intervalMs;
+    this.#interval = interval;
   }
-  get intervalMs() {
-    return this.#intervalMs;
+  get interval() {
+    return this.#interval;
   }
   get utility() {
     return this.#utility;
@@ -133,7 +145,7 @@ class StandardTimer {
         this.isRunning = false;
       }
       this.callback();
-    }, this.intervalMs);
+    }, this.interval);
     return this;
   }
   stop() {
@@ -150,7 +162,7 @@ DiagnosticSource.add({
         timer.name,
         Diagnostic.dict({
           periodic: timer.isPeriodic,
-          interval: Diagnostic.interval(timer.intervalMs),
+          interval: timer.interval,
           system: timer.systemId,
           elapsed: timer.elapsed
         })
@@ -159,9 +171,8 @@ DiagnosticSource.add({
   }
 });
 Boot.init(() => {
-  const time = new Time();
-  Time.startup.systemMs = Time.startup.processMs = time.nowMs();
-  Time.get = () => time;
+  Time.default = new Time();
+  Time.startup.systemMs = Time.startup.processMs = Time.nowMs;
   if (typeof MatterHooks !== "undefined") {
     MatterHooks?.timeSetup?.(Time);
   }

package/dist/esm/time/Time.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/time/Time.ts"],
-  "mappings": "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",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,YAAY;AACrB,SAAS,yBAAyB;AAClC,SAAS,2BAA2B;AACpC,SAAS,kBAAkB;AAC3B,SAAS,wBAAwB;AAEjC,SAAS,eAAe;AAGxB,MAAM,WAAW,oBAAI,IAAW;AAQzB,MAAM,KAAK;AAAA,EACd,OAAO;AAAA,EAEP,OAAO,UAAU;AAAA,IACb,UAAU;AAAA,IACV,WAAW;AAAA,EACf;AAAA,EAEA,IAAI,MAAM;AACN,WAAO,oBAAI,KAAK;AAAA,EACpB;AAAA,EACA,WAAW,MAAM;AACb,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK,IAAI;AAAA,EACpB;AAAA,EACA,WAAW,QAAQ;AACf,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK,MAAM,YAAY,IAAI,IAAI,YAAY,UAAU;AAAA,EAChE;AAAA,EACA,WAAW,QAAQ;AACf,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,MAAc,UAAoB,UAAiC;AACxE,WAAO,IAAI,cAAc,MAAM,UAAU,UAAU,KAAK;AAAA,EAC5D;AAAA,EACA,OAAgB,WAAW,CAAC,MAAc,UAAoB,aAC1D,KAAK,QAAQ,SAAS,MAAM,UAAU,QAAQ;AAAA;AAAA;AAAA;AAAA,EAKlD,iBAAiB,MAAc,UAAoB,UAAiC;AAChF,WAAO,IAAI,cAAc,MAAM,UAAU,UAAU,IAAI;AAAA,EAC3D;AAAA,EACA,OAAgB,mBAAmB,CAAC,MAAc,UAAoB,aAClE,KAAK,QAAQ,iBAAiB,MAAM,UAAU,QAAQ;AAAA;AAAA;AAAA;AAAA,EAK1D,MAAM,MAAc,UAAuC;AACvD,QAAI;AACJ,QAAI;AACJ,WAAO,IAAI;AAAA,MACP,aAAW;AACP,mBAAW;AACX,gBAAQ,KAAK,SAAS,MAAM,UAAU,OAAO;AAC7C,cAAM,MAAM;AAAA,MAChB;AAAA,MAEA,MAAM;AACF,cAAM,KAAK;AACX,iBAAS;AAAA,MACb;AAAA,IACJ;AAAA,EACJ;AAAA,EACA,OAAO,MAAM,MAAc,UAAoB;AAC3C,WAAO,KAAK,QAAQ,MAAM,MAAM,QAAQ;AAAA,EAC5C;AAAA,EAEA,OAAO,SAAS,OAAc;AAC1B,aAAS,IAAI,KAAK;AAClB,UAAM,UAAU,WAAW,QAAQ;AAAA,EACvC;AAAA,EAEA,OAAO,WAAW,OAAc;AAC5B,aAAS,OAAO,KAAK;AAAA,EACzB;AAAA,EAEA,WAAW,SAAS;AAChB,WAAO;AAAA,EACX;AACJ;AAGA,IAAI,CAAC,eAAe,OAAO,YAAY,QAAQ,cAAc,OAAO,YAAY,eAAe,UAAU;AACrG,SAAO,eAAe,KAAK,WAAW,SAAS;AAAA,IAC3C,MAAM;AACF,aAAO,KAAK;AAAA,IAChB;AAAA,EACJ,CAAC;AACL;AAmCO,MAAM,cAA+B;AAAA,EAUxC,YACa,MACT,UACiB,UACR,YACX;AAJW;AAEQ;AACR;AAET,SAAK,WAAW;AAAA,EACpB;AAAA,EAhBA;AAAA,EACA,WAAW;AAAA,EACX,YAAY;AAAA;AAAA,EACZ,YAAY;AAAA,EAEZ,IAAI,WAAW;AACX,WAAO,OAAO,KAAK,QAAQ;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAgBA,IAAI,SAAS,UAAoB;AAC7B,QAAI,WAAW,KAAK,WAAW,YAAY;AACvC,YAAM,IAAI;AAAA,QACN,uBAAuB,QAAQ;AAAA,MACnC;AAAA,IACJ;AACA,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,WAAW;AACX,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAU;AACV,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,QAAQ,SAAkB;AAC1B,QAAI,YAAY,KAAK,UAAU;AAC3B;AAAA,IACJ;AAGA,QAAI,KAAK,YAAY,QAAW;AAC5B,YAAM,UAAU,KAAK;AACrB,UAAI,SAAS;AACT,gBAAQ,QAAQ;AAAA,MACpB,OAAO;AACH,gBAAQ,MAAM;AAAA,MAClB;AAAA,IACJ;AAEA,SAAK,WAAW;AAAA,EACpB;AAAA,EAEA,QAAQ;AACJ,QAAI,KAAK,UAAW,MAAK,KAAK;AAC9B,SAAK,SAAS,IAAI;AAClB,SAAK,YAAY;AACjB,SAAK,YAAY,KAAK,aAAa,cAAc,YAAY,MAAM;AAC/D,UAAI,CAAC,KAAK,YAAY;AAClB,aAAK,WAAW,IAAI;AACpB,aAAK,YAAY;AAAA,MACrB;AACA,WAAK,SAAS;AAAA,IAClB,GAAG,KAAK,QAAQ;AAChB,WAAO;AAAA,EACX;AAAA,EAEA,OAAO;AACH,KAAC,KAAK,aAAa,gBAAgB,cAAc,KAAK,QAAyC;AAC/F,SAAK,WAAW,IAAI;AACpB,SAAK,YAAY;AACjB,WAAO;AAAA,EACX;AACJ;AAEA,iBAAiB,IAAI;AAAA,EACjB,KAAK,WAAW,KAAK,IAAI;AACrB,WAAO,WAAW,KAAK,UAAK,UAAU;AAAA,MAClC,UAAU,CAAC,GAAG,QAAQ,EAAE,IAAI,WAAS;AAAA,QACjC,MAAM;AAAA,QACN,WAAW,KAAK;AAAA,UACZ,UAAU,MAAM;AAAA,UAChB,UAAU,MAAM;AAAA,UAChB,QAAQ,MAAM;AAAA,UACd,SAAS,MAAM;AAAA,QACnB,CAAC;AAAA,MACL,CAAC;AAAA,IACL,CAAC;AAAA,EACL;AACJ,CAAC;AAED,KAAK,KAAK,MAAM;AACZ,OAAK,UAAU,IAAI,KAAK;AAExB,OAAK,QAAQ,WAAW,KAAK,QAAQ,YAAY,KAAK;AAGtD,MAAI,OAAO,gBAAgB,aAAa;AACpC,iBAAa,YAAY,IAAI;AAAA,EACjC;AACJ,CAAC;",
   "names": []
 }

package/dist/esm/time/TimeUnit.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Duration } from "./Duration.js";
+/**
+ * Details of a specific unit of time.
+ */
+export interface TimeUnit {
+    (scale: number | bigint): Duration;
+    (scale: undefined | number | bigint): undefined | Duration;
+    /**
+     * Long name of the unit.
+     */
+    readonly kind: TimeUnit.Kind;
+    /**
+     * Abbreviated name of the unit.
+     */
+    readonly abbrev: string;
+    /**
+     * An interval representing a single unit.
+     */
+    readonly one: Duration;
+    /**
+     * Convert an interval to an integer of this unit.
+     *
+     * Produces an even integer result.  Use {@link fractionalOf} to retain any fractional component.
+     */
+    of<T extends Duration | undefined>(interval: T): T extends undefined ? number | undefined : number;
+    /**
+     * Convert an interval to this unit, retaining fractional component.
+     */
+    fractionalOf<T extends Duration | undefined>(interval: T): T extends undefined ? number | undefined : number;
+    /**
+     * Compute the ceiling of an interval in this unit.
+     */
+    ceil(duration: Duration): Duration;
+    /**
+     * Compute the floor of an interval in this unit.
+     */
+    floor(duration: Duration): Duration;
+    /**
+     * Round an interval to this unit.
+     */
+    round(duration: Duration): Duration;
+    length: never;
+}
+export declare namespace TimeUnit {
+    /**
+     * Standard time units.
+     */
+    type Kind = "microsecond" | "millisecond" | "second" | "minute" | "hour" | "day";
+}
+/**
+ * Implement a {@link TimeUnit}.
+ */
+export declare function TimeUnit<T = {}>(kind: TimeUnit.Kind, abbrev: string, one: number, props?: T): TimeUnit & T;
+/**
+ * Create an interval in microseconds.
+ */
+export declare const Microseconds: TimeUnit;
+/**
+ * Create an interval in milliseconds.
+ */
+export declare const Millis: TimeUnit;
+/**
+ * Create an interval in seconds.
+ */
+export declare const Seconds: TimeUnit;
+/**
+ * Create an interval in minutes.
+ */
+export declare const Minutes: TimeUnit;
+/**
+ * Create an interval in hours.
+ */
+export declare const Hours: TimeUnit;
+/**
+ * Create an interval in days.
+ */
+export declare const Days: TimeUnit;
+/**
+ * A zero-length interval.
+ */
+export declare const Instant: Duration;
+//# sourceMappingURL=TimeUnit.d.ts.map

package/dist/esm/time/TimeUnit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeUnit.d.ts","sourceRoot":"","sources":["../../../src/time/TimeUnit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACnC,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAE3D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IAEvB;;;;OAIG;IACH,EAAE,CAAC,CAAC,SAAS,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,SAAS,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAEnG;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,SAAS,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAE7G;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAEnC;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAEpC;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAEpC,MAAM,EAAE,KAAK,CAAC;CACjB;AAED,yBAAiB,QAAQ,CAAC;IACtB;;OAEG;IACH,KAAY,IAAI,GAAG,aAAa,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;CAC3F;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,GAAS,CAAC,GAAG,QAAQ,GAAG,CAAC,CA6BhH;AA0BD;;GAEG;AACH,eAAO,MAAM,YAAY,UAAuC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,MAAM,UAAmC,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,OAAO,UAAiC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,OAAO,UAAkC,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,KAAK,UAAmC,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,IAAI,UAAmC,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,OAAO,UAAY,CAAC"}

package/dist/esm/time/TimeUnit.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function TimeUnit(kind, abbrev, one, props = {}) {
+  const unit = {
+    [kind]: (scale) => {
+      if (scale === void 0) {
+        return void 0;
+      }
+      if (typeof scale === "bigint") {
+        scale = Number(scale);
+      }
+      return scale * one;
+    }
+  }[kind];
+  Object.assign(unit, {
+    ...props,
+    kind,
+    abbrev,
+    one,
+    of,
+    fractionalOf,
+    ceil,
+    floor,
+    round,
+    toString: kindOf,
+    [Symbol.for("nodejs.util.inspect.custom")]: kindOf
+  });
+  return unit;
+}
+function of(duration) {
+  return Math.floor(duration / this.one);
+}
+function fractionalOf(duration) {
+  return duration / this.one;
+}
+function ceil(duration) {
+  return Math.ceil(duration / this.one) * this.one;
+}
+function floor(duration) {
+  return Math.floor(duration / this.one) * this.one;
+}
+function round(duration) {
+  return Math.round(duration / this.one) * this.one;
+}
+function kindOf() {
+  return this.kind;
+}
+const Microseconds = TimeUnit("microsecond", "\u03BCs", 1e-3);
+const Millis = TimeUnit("millisecond", "ms", 1);
+const Seconds = TimeUnit("second", "s", 1e3);
+const Minutes = TimeUnit("minute", "m", 6e4);
+const Hours = TimeUnit("hour", "h", 36e5);
+const Days = TimeUnit("day", "d", 864e5);
+const Instant = Millis(0);
+export {
+  Days,
+  Hours,
+  Instant,
+  Microseconds,
+  Millis,
+  Minutes,
+  Seconds,
+  TimeUnit
+};
+//# sourceMappingURL=TimeUnit.js.map

package/dist/esm/time/TimeUnit.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/time/TimeUnit.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAsEO,SAAS,SAAiB,MAAqB,QAAgB,KAAa,QAAQ,CAAC,GAAsB;AAC9G,QAAM,OAAO;AAAA,IACT,CAAC,IAAI,GAAG,CAAC,UAAuC;AAC5C,UAAI,UAAU,QAAW;AACrB,eAAO;AAAA,MACX;AACA,UAAI,OAAO,UAAU,UAAU;AAC3B,gBAAQ,OAAO,KAAK;AAAA,MACxB;AACA,aAAQ,QAAQ;AAAA,IACpB;AAAA,EACJ,EAAE,IAAI;AAGN,SAAO,OAAO,MAAM;AAAA,IAChB,GAAG;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV,CAAC,OAAO,IAAI,4BAA4B,CAAC,GAAG;AAAA,EAChD,CAAC;AAED,SAAO;AACX;AAEA,SAAS,GAAmB,UAAoB;AAC5C,SAAO,KAAK,MAAM,WAAW,KAAK,GAAG;AACzC;AAEA,SAAS,aAA6B,UAAoB;AACtD,SAAO,WAAW,KAAK;AAC3B;AAEA,SAAS,KAAqB,UAAoB;AAC9C,SAAO,KAAK,KAAK,WAAW,KAAK,GAAG,IAAI,KAAK;AACjD;AAEA,SAAS,MAAsB,UAAoB;AAC/C,SAAO,KAAK,MAAM,WAAW,KAAK,GAAG,IAAI,KAAK;AAClD;AAEA,SAAS,MAAsB,UAAoB;AAC/C,SAAO,KAAK,MAAM,WAAW,KAAK,GAAG,IAAI,KAAK;AAClD;AAEA,SAAS,SAAuB;AAC5B,SAAO,KAAK;AAChB;AAKO,MAAM,eAAe,SAAS,eAAe,WAAM,IAAK;AAKxD,MAAM,SAAS,SAAS,eAAe,MAAM,CAAC;AAK9C,MAAM,UAAU,SAAS,UAAU,KAAK,GAAK;AAK7C,MAAM,UAAU,SAAS,UAAU,KAAK,GAAM;AAK9C,MAAM,QAAQ,SAAS,QAAQ,KAAK,IAAS;AAK7C,MAAM,OAAO,SAAS,OAAO,KAAK,KAAU;AAK5C,MAAM,UAAU,OAAO,CAAC;",
+  "names": []
+}

package/dist/esm/time/Timespan.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Duration } from "./Duration.js";
+import { Timestamp } from "./Timestamp.js";
+/**
+ * A period between two {@link Timestamp}s.
+ */
+export interface Timespan {
+    start: Timestamp;
+    stop: Timestamp;
+    duration: Duration;
+    from(newStart: Timestamp.Definition): Timespan;
+    to(newStart: Timestamp.Definition): Timespan;
+    valueOf(): {
+        start: Timestamp;
+        stop: Timestamp;
+    };
+}
+/**
+ * Create a new timespan representing time between {@link start} and {@link stop}.
+ */
+export declare function Timespan(start: Timestamp.Definition, stop: Timestamp.Definition): Timespan;
+//# sourceMappingURL=Timespan.d.ts.map

package/dist/esm/time/Timespan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timespan.d.ts","sourceRoot":"","sources":["../../../src/time/Timespan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,QAAQ,CAAC;IAEnB,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,GAAG,QAAQ,CAAC;IAC/C,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,GAAG,QAAQ,CAAC;IAC7C,OAAO,IAAI;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC;CACpD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,GAItE,QAAQ,CACjB"}

package/dist/esm/time/Timespan.js

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Timestamp } from "./Timestamp.js";
+function Timespan(start, stop) {
+  return Object.create(prototype, {
+    start: { value: Timestamp(start), enumerable: true },
+    stop: { value: Timestamp(stop), enumerable: true }
+  });
+}
+const prototype = {
+  start: 0,
+  stop: 0,
+  get duration() {
+    return this.stop - this.start;
+  },
+  from(newStart) {
+    return Timespan(newStart, this.stop);
+  },
+  to(newStop) {
+    return Timespan(this.start, newStop);
+  },
+  valueOf() {
+    return { start: this.start, stop: this.stop };
+  }
+};
+export {
+  Timespan
+};
+//# sourceMappingURL=Timespan.js.map

package/dist/esm/time/Timespan.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/time/Timespan.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,iBAAiB;AAkBnB,SAAS,SAAS,OAA6B,MAA4B;AAC9E,SAAO,OAAO,OAAO,WAAW;AAAA,IAC5B,OAAO,EAAE,OAAO,UAAU,KAAK,GAAG,YAAY,KAAK;AAAA,IACnD,MAAM,EAAE,OAAO,UAAU,IAAI,GAAG,YAAY,KAAK;AAAA,EACrD,CAAC;AACL;AAEA,MAAM,YAAsB;AAAA,EACxB,OAAO;AAAA,EACP,MAAM;AAAA,EAEN,IAAI,WAAW;AACX,WAAQ,KAAK,OAAO,KAAK;AAAA,EAC7B;AAAA,EAEA,KAAqB,UAAU;AAC3B,WAAO,SAAS,UAAU,KAAK,IAAI;AAAA,EACvC;AAAA,EAEA,GAAmB,SAAS;AACxB,WAAO,SAAS,KAAK,OAAO,OAAO;AAAA,EACvC;AAAA,EAEA,UAAwB;AACpB,WAAO,EAAE,OAAO,KAAK,OAAO,MAAM,KAAK,KAAK;AAAA,EAChD;AACJ;",
+  "names": []
+}

package/dist/esm/time/Timestamp.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { UnexpectedDataError } from "#MatterError.js";
+import { Branded } from "#util/Type.js";
+/**
+ * A UNIX epoch timestamp in milliseconds.
+ *
+ * Note that the precision of the timestamp may be greater than milliseconds but is limited to floating point precision.
+ */
+export type Timestamp = Branded<number, "Timestamp"> | 0;
+/**
+ * Create a timestamp.
+ *
+ * Input may be a UNIX epoch value in milliseconds, a parseable date string, or a {@link Date}.
+ */
+export declare function Timestamp<T extends undefined | Timestamp.Definition>(source: T): T extends undefined ? undefined | Timestamp : Timestamp;
+/**
+ * Thrown when a textual timestamp cannot be parsed.
+ */
+export declare class TimestampFormatError extends UnexpectedDataError {
+}
+export declare namespace Timestamp {
+    /**
+     * Values that may be used to initialize a timestamp.
+     */
+    type Definition = number | bigint | string | Date;
+    /**
+     * Create a low-resolution timestamp from a seconds value.
+     */
+    function fromSeconds(source: number): number;
+    /**
+     * Create a high-resolution timestamp from a microsecond value.
+     */
+    function fromMicroseconds(source: number | bigint): Timestamp;
+    /**
+     * The UNIX epoch.
+     */
+    const zero: Timestamp;
+    /**
+     * Obtain a {@link Date} for a {@link Timestamp}.
+     */
+    function dateOf(timestamp: Timestamp): Date;
+}
+//# sourceMappingURL=Timestamp.d.ts.map

package/dist/esm/time/Timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timestamp.d.ts","sourceRoot":"","sources":["../../../src/time/Timestamp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,CAAC,UAAU,EAChE,MAAM,EAAE,CAAC,GACV,CAAC,SAAS,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CA4BzD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;CAAG;AAEhE,yBAAiB,SAAS,CAAC;IACvB;;OAEG;IACH,KAAY,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,SAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,UAEzC;IAED;;OAEG;IACH,SAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,aAKvD;IAED;;OAEG;IACI,MAAM,IAAI,WAAe,CAAC;IAEjC;;OAEG;IACH,SAAgB,MAAM,CAAC,SAAS,EAAE,SAAS,QAE1C;CACJ"}

package/dist/esm/time/Timestamp.js

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { UnexpectedDataError } from "#MatterError.js";
+import { Time } from "./Time.js";
+function Timestamp(source) {
+  if (source === void 0) {
+    return Time.nowMs;
+  }
+  if (typeof source === "string") {
+    const date = Date.parse(source);
+    if (Number.isNaN(date.valueOf())) {
+      throw new TimestampFormatError("Invalid timestamp format");
+    }
+  } else if (typeof source === "object" && source !== null && source instanceof Date) {
+    if (Number.isNaN(source.valueOf())) {
+      throw new TimestampFormatError("Cannot convert date to timestamp because it is invalid");
+    }
+    source = source.getTime();
+  } else if (typeof source === "bigint") {
+    source = Number(source);
+  }
+  if (typeof source === "number") {
+    if (Number.isNaN(source)) {
+      throw new TimestampFormatError("A timestamp may not be NaN");
+    }
+  } else {
+    throw new TimestampFormatError(`Timestamp is not a number (received ${typeof source})`);
+  }
+  return source;
+}
+class TimestampFormatError extends UnexpectedDataError {
+}
+((Timestamp2) => {
+  function fromSeconds(source) {
+    return Math.floor(source * 1e3);
+  }
+  Timestamp2.fromSeconds = fromSeconds;
+  function fromMicroseconds(source) {
+    if (typeof source === "bigint") {
+      source = Number(source);
+    }
+    return Timestamp2(source / 1e3);
+  }
+  Timestamp2.fromMicroseconds = fromMicroseconds;
+  Timestamp2.zero = Timestamp2(0);
+  function dateOf(timestamp) {
+    return new Date(timestamp);
+  }
+  Timestamp2.dateOf = dateOf;
+})(Timestamp || (Timestamp = {}));
+export {
+  Timestamp,
+  TimestampFormatError
+};
+//# sourceMappingURL=Timestamp.js.map

package/dist/esm/time/Timestamp.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/time/Timestamp.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,2BAA2B;AAEpC,SAAS,YAAY;AAcd,SAAS,UACZ,QACuD;AACvD,MAAI,WAAW,QAAW;AACtB,WAAO,KAAK;AAAA,EAChB;AAEA,MAAI,OAAO,WAAW,UAAU;AAC5B,UAAM,OAAO,KAAK,MAAM,MAAM;AAC9B,QAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,GAAG;AAC9B,YAAM,IAAI,qBAAqB,0BAA0B;AAAA,IAC7D;AAAA,EACJ,WAAW,OAAO,WAAW,YAAY,WAAW,QAAQ,kBAAkB,MAAM;AAChF,QAAI,OAAO,MAAM,OAAO,QAAQ,CAAC,GAAG;AAChC,YAAM,IAAI,qBAAqB,wDAAwD;AAAA,IAC3F;AACA,aAAS,OAAO,QAAQ;AAAA,EAC5B,WAAW,OAAO,WAAW,UAAU;AACnC,aAAS,OAAO,MAAM;AAAA,EAC1B;AAEA,MAAI,OAAO,WAAW,UAAU;AAC5B,QAAI,OAAO,MAAM,MAAM,GAAG;AACtB,YAAM,IAAI,qBAAqB,4BAA4B;AAAA,IAC/D;AAAA,EACJ,OAAO;AACH,UAAM,IAAI,qBAAqB,uCAAuC,OAAO,MAAM,GAAG;AAAA,EAC1F;AAEA,SAAO;AACX;AAKO,MAAM,6BAA6B,oBAAoB;AAAC;AAAA,CAExD,CAAUA,eAAV;AASI,WAAS,YAAY,QAAgB;AACxC,WAAO,KAAK,MAAM,SAAS,GAAI;AAAA,EACnC;AAFO,EAAAA,WAAS;AAOT,WAAS,iBAAiB,QAAyB;AACtD,QAAI,OAAO,WAAW,UAAU;AAC5B,eAAS,OAAO,MAAM;AAAA,IAC1B;AACA,WAAOA,WAAU,SAAS,GAAI;AAAA,EAClC;AALO,EAAAA,WAAS;AAUT,EAAMA,WAAA,OAAOA,WAAU,CAAC;AAKxB,WAAS,OAAO,WAAsB;AACzC,WAAO,IAAI,KAAK,SAAS;AAAA,EAC7B;AAFO,EAAAA,WAAS;AAAA,GA/BH;",
+  "names": ["Timestamp"]
+}

package/dist/esm/time/index.d.ts

@@ -3,5 +3,9 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+export * from "./Duration.js";
 export * from "./Time.js";
+export * from "./Timespan.js";
+export * from "./Timestamp.js";
+export * from "./TimeUnit.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/time/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/time/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/time/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}