@kensio/yulin 0.35.0 → 0.37.0

package/dist/util/background/background.d.ts

@@ -1,5 +1,15 @@
+import { type SimClock } from "../clock/sim-clock.js";
+import { type BackgroundDueTask } from "./background-due-tasks.js";
 export type BackgroundTask = () => Promise<void>;
-export interface BackgroundScheduler {
+/**
+ * Scheduler for a simulator's asynchronous work, and the source of its time.
+ *
+ * Timekeeping and scheduling stay separate responsibilities: a scheduler holds
+ * a SimClock and delegates to it, rather than implementing time itself. They
+ * are combined in one interface because they travel together, so anything
+ * already given a scheduler can read simulated time without extra wiring.
+ */
+export interface BackgroundScheduler extends SimClock {
     /**
      * Wait at a simulator sequencing point.
      *
@@ -9,18 +19,52 @@ export interface BackgroundScheduler {
      */
     sequence(): Promise<void>;
     schedule(task: BackgroundTask): void;
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     *
+     * Nothing dispatches it until the clock gets there, so scheduled work
+     * happens on the simulation's timeline rather than the host's.
+     */
+    scheduleAt(dueTime: Date, task: BackgroundTask): void;
+}
+interface BackgroundTasksProperties {
+    readonly clock?: SimClock;
 }
 export interface BackgroundCompleter {
     complete(): Promise<void>;
 }
+/**
+ * Source of background work waiting on the clock.
+ *
+ * Whatever controls simulated time pulls due work from here as it moves the
+ * clock, which is what makes advancing time dispatch what falls due during the
+ * interval rather than everything at once at the end.
+ */
+export interface BackgroundDueTaskSource {
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant: Date): BackgroundDueTask | undefined;
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    readonly dueTaskCount: number;
+}
 /**
  * Deterministic async background tasks scheduler.
  *
  * Tasks still run asynchronously, outside the current call stack, but dispatch in
  * the order they were scheduled.
  */
-export declare class BackgroundTasks implements BackgroundScheduler, BackgroundCompleter {
+export declare class BackgroundTasks implements BackgroundScheduler, BackgroundCompleter, BackgroundDueTaskSource {
     private readonly pending;
+    private readonly dueTasks;
+    private readonly clock;
+    constructor(properties?: BackgroundTasksProperties);
+    /**
+     * Get the current time in this simulation.
+     */
+    now(): Date;
     /**
      * Wait at a deterministic sequencing point.
      */
@@ -29,14 +73,31 @@ export declare class BackgroundTasks implements BackgroundScheduler, BackgroundC
      * Schedule a task to happen asynchronously in the background.
      */
     schedule(task: BackgroundTask): void;
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime: Date, task: BackgroundTask): void;
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant: Date): BackgroundDueTask | undefined;
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
+     *
+     * Work waiting on the clock is not waited for: it is not outstanding, it is
+     * scheduled for a simulated instant that has not arrived. Only moving the
+     * clock releases it.
      */
     complete(): Promise<void>;
     /**
      * See how many outstanding background tasks are scheduled.
      */
     get pendingTaskCount(): number;
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount(): number;
 }
+export {};
 //# sourceMappingURL=background.d.ts.map

package/dist/util/background/background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,eACX,YAAW,mBAAmB,EAAE,mBAAmB;IAEnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExB;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAqBnC;IAED;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;CACF"}
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAoB,SAAQ,QAAQ;IACnD;;;;;;OAMG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAErC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CACvD;AAED,UAAU,yBAAyB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAE5D;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,eACX,YAAW,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB;IAE5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IAEjC,YAAY,UAAU,GAAE,yBAA8B,EAErD;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAExB;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAqBnC;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAEpD;IAED;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAE1D;IAED;;;;;;;OAOG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAKrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,MAAM,CAEhC;CACF"}

package/dist/util/background/background.js

@@ -1,4 +1,6 @@
 /* eslint-disable unicorn/prefer-await  */
+import { SimRealClock } from "../clock/sim-clock.js";
+import { BackgroundDueTasks, } from "./background-due-tasks.js";
 /**
  * Deterministic async background tasks scheduler.
  *
@@ -7,6 +9,17 @@
  */
 export class BackgroundTasks {
     pending = new Set();
+    dueTasks = new BackgroundDueTasks();
+    clock;
+    constructor(properties = {}) {
+        this.clock = properties.clock ?? new SimRealClock();
+    }
+    /**
+     * Get the current time in this simulation.
+     */
+    now() {
+        return this.clock.now();
+    }
     /**
      * Wait at a deterministic sequencing point.
      */
@@ -33,9 +46,25 @@ export class BackgroundTasks {
         });
         this.pending.add(promise);
     }
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime, task) {
+        this.dueTasks.add(dueTime, task);
+    }
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant) {
+        return this.dueTasks.takeNextDueBy(instant);
+    }
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
+     *
+     * Work waiting on the clock is not waited for: it is not outstanding, it is
+     * scheduled for a simulated instant that has not arrived. Only moving the
+     * clock releases it.
      */
     async complete() {
         while (this.pending.size > 0) {
@@ -49,5 +78,11 @@ export class BackgroundTasks {
     get pendingTaskCount() {
         return this.pending.size;
     }
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount() {
+        return this.dueTasks.size;
+    }
 }
 //# sourceMappingURL=background.js.map

package/dist/util/background/background.js.map

@@ -1 +1 @@
-{"version":3,"file":"background.js","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAqB1C;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAGT,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEpD;;OAEG;IACH,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC;aAEC,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../../src/util/background/background.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,OAAO,EAAiB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AA4DnC;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAGT,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACpC,KAAK,CAAW;IAEjC,YAAY,UAAU,GAA8B,EAAE;QACpD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,IAAI,YAAY,EAAE,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC5C,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC;aAEC,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAa,EAAE,IAAoB;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAa;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/util/background/non-deterministic-background.d.ts

@@ -1,16 +1,25 @@
-import type { BackgroundCompleter, BackgroundScheduler, BackgroundTask } from "./background.js";
+import type { BackgroundCompleter, BackgroundDueTaskSource, BackgroundScheduler, BackgroundTask } from "./background.js";
+import { type SimClock } from "../clock/sim-clock.js";
+import { type BackgroundDueTask } from "./background-due-tasks.js";
 /**
  * Non-deterministic async background tasks scheduler.
  *
  * Use this when you want to simulate asynchronous distributed operations
  * potentially completing out of sequence.
  */
-export declare class NonDeterministicBackgroundTasks implements BackgroundScheduler, BackgroundCompleter {
+export declare class NonDeterministicBackgroundTasks implements BackgroundScheduler, BackgroundCompleter, BackgroundDueTaskSource {
     private readonly pending;
-    private readonly maxJitterMs;
+    private readonly dueTasks;
+    private readonly jitter;
+    private readonly clock;
     constructor(properties?: {
         maxJitterMs?: number;
+        clock?: SimClock;
     });
+    /**
+     * Get the current time in this simulation.
+     */
+    now(): Date;
     /**
      * Wait at a non-deterministic sequencing point.
      */
@@ -19,6 +28,14 @@ export declare class NonDeterministicBackgroundTasks implements BackgroundSchedu
      * Schedule a task to happen asynchronously in the background.
      */
     schedule(task: BackgroundTask): void;
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime: Date, task: BackgroundTask): void;
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant: Date): BackgroundDueTask | undefined;
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
@@ -28,6 +45,9 @@ export declare class NonDeterministicBackgroundTasks implements BackgroundSchedu
      * See how many outstanding background tasks are scheduled.
      */
     get pendingTaskCount(): number;
-    private sleep;
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount(): number;
 }
 //# sourceMappingURL=non-deterministic-background.d.ts.map

package/dist/util/background/non-deterministic-background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"non-deterministic-background.d.ts","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AAIzB;;;;;GAKG;AACH,qBAAa,+BACX,YAAW,mBAAmB,EAAE,mBAAmB;IAEnD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,YAAY,UAAU,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,EAGpD;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAkBnC;IAED;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAcrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;YAEa,KAAK;CAKpB"}
+{"version":3,"file":"non-deterministic-background.d.ts","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,2BAA2B,CAAC;AAMnC;;;;;GAKG;AACH,qBAAa,+BACX,YAAW,mBAAmB,EAAE,mBAAmB,EAAE,uBAAuB;IAE5E,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IAEjC,YAAY,UAAU,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;KAAO,EAItE;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAkBnC;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAEpD;IAED;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAE1D;IAED;;;OAGG;IACU,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAQrC;IAED;;OAEG;IACH,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED;;OAEG;IACH,IAAW,YAAY,IAAI,MAAM,CAEhC;CACF"}

package/dist/util/background/non-deterministic-background.js

@@ -1,3 +1,7 @@
+import { SimRealClock } from "../clock/sim-clock.js";
+import { BackgroundDueTasks, } from "./background-due-tasks.js";
+import { BackgroundJitter } from "./background-jitter.js";
+import { BackgroundSettledTasks } from "./background-settled-tasks.js";
 /* eslint-disable unicorn/prefer-await  */
 /**
  * Non-deterministic async background tasks scheduler.
@@ -7,16 +11,25 @@
  */
 export class NonDeterministicBackgroundTasks {
     pending = new Set();
-    maxJitterMs;
+    dueTasks = new BackgroundDueTasks();
+    jitter;
+    clock;
     constructor(properties = {}) {
-        const { maxJitterMs = 5 } = properties;
-        this.maxJitterMs = maxJitterMs;
+        const { maxJitterMs, clock = new SimRealClock() } = properties;
+        this.jitter = new BackgroundJitter(maxJitterMs);
+        this.clock = clock;
+    }
+    /**
+     * Get the current time in this simulation.
+     */
+    now() {
+        return this.clock.now();
     }
     /**
      * Wait at a non-deterministic sequencing point.
      */
     async sequence() {
-        await this.sleep(Math.random() * this.maxJitterMs);
+        await this.jitter.wait();
     }
     /**
      * Schedule a task to happen asynchronously in the background.
@@ -36,6 +49,18 @@ export class NonDeterministicBackgroundTasks {
         });
         this.pending.add(promise);
     }
+    /**
+     * Schedule a task to happen once simulated time reaches an instant.
+     */
+    scheduleAt(dueTime, task) {
+        this.dueTasks.add(dueTime, task);
+    }
+    /**
+     * Take the next task due at or before an instant, earliest first.
+     */
+    takeNextDueBy(instant) {
+        return this.dueTasks.takeNextDueBy(instant);
+    }
     /**
      * Wait until all tasks currently scheduled have finished.
      * If tasks schedule more tasks, this will continue draining until idle.
@@ -44,11 +69,8 @@ export class NonDeterministicBackgroundTasks {
         while (this.pending.size > 0) {
             // eslint-disable-next-line no-await-in-loop
             const results = await Promise.allSettled(this.pending);
-            // Check if any promises rejected and capture the first error
-            const firstRejected = results.find((result) => result.status === "rejected");
-            if (firstRejected !== undefined) {
-                throw firstRejected.reason;
-            }
+            // Surface a task that failed in the background to whoever waited here.
+            new BackgroundSettledTasks(results).throwFirstFailure();
         }
     }
     /**
@@ -57,10 +79,11 @@ export class NonDeterministicBackgroundTasks {
     get pendingTaskCount() {
         return this.pending.size;
     }
-    async sleep(ms = 0) {
-        await new Promise((resolve) => {
-            setTimeout(resolve, ms);
-        });
+    /**
+     * See how many tasks are waiting for simulated time to reach them.
+     */
+    get dueTaskCount() {
+        return this.dueTasks.size;
     }
 }
 //# sourceMappingURL=non-deterministic-background.js.map

package/dist/util/background/non-deterministic-background.js.map

@@ -1 +1 @@
-{"version":3,"file":"non-deterministic-background.js","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAMA,0CAA0C;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,+BAA+B;IAGzB,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,WAAW,CAAS;IAErC,YAAY,UAAU,GAA6B,EAAE;QACnD,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,GAAG,UAAU,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE;aAC5B,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvD,6DAA6D;YAC7D,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAChC,CAAC,MAAM,EAAmC,EAAE,CAC1C,MAAM,CAAC,MAAM,KAAK,UAAU,CAC/B,CAAC;YAEF,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,aAAa,CAAC,MAAM,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QACxB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"non-deterministic-background.js","sourceRoot":"","sources":["../../../src/util/background/non-deterministic-background.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAEL,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,0CAA0C;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,+BAA+B;IAGzB,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACpC,MAAM,CAAmB;IACzB,KAAK,CAAW;IAEjC,YAAY,UAAU,GAA+C,EAAE;QACrE,MAAM,EAAE,WAAW,EAAE,KAAK,GAAG,IAAI,YAAY,EAAE,EAAE,GAAG,UAAU,CAAC;QAC/D,IAAI,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE;aAC5B,IAAI,CAAC,IAAI,CAAC;aACV,IAAI,CACH,GAAG,EAAE;YACH,EAAE;QACJ,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;YACjB,+DAA+D;YAC/D,qBAAqB;YACrB,MAAM,KAAK,CAAC;QACd,CAAC,CACF;aACA,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEL,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAa,EAAE,IAAoB;QAC5C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAa;QACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,QAAQ;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAC7B,4CAA4C;YAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvD,uEAAuE;YACvE,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/util/clock/sim-clock-control.d.ts

@@ -0,0 +1,94 @@
+import type { BackgroundCompleter, BackgroundDueTaskSource, BackgroundScheduler } from "../background/background.js";
+import type { SimClock } from "./sim-clock.js";
+import type { SimControllableClock } from "./sim-controllable-clock.js";
+import { SimDuration, type SimDurationInput } from "./sim-duration.js";
+/**
+ * The scheduler a clock control moves time for: it releases work waiting on the
+ * clock, and it can be waited on until the simulation settles.
+ */
+export type SimClockControlBackground = BackgroundScheduler & BackgroundCompleter & BackgroundDueTaskSource;
+interface SimClockControlProperties {
+    readonly clock: SimControllableClock;
+    readonly background: SimClockControlBackground;
+}
+/**
+ * Control over one simulation's sense of time.
+ *
+ * Moving the clock is only half of what a test needs. The other half is that
+ * whatever the passage of time should have caused has actually happened by the
+ * time the call returns, so the next line can assert rather than wait. So this
+ * class owns both the clock and the scheduler: advancing walks simulated time
+ * forward through everything that falls due in the interval, running each task
+ * at its own due time, and returns once nothing is left pending.
+ *
+ * Control is per simulation. Moving time here never touches another simulation
+ * or the real clock, which is what keeps a SimAws instance safe to construct
+ * per test case.
+ */
+export declare class SimClockControl implements SimClock {
+    private readonly clock;
+    private readonly background;
+    constructor(properties: SimClockControlProperties);
+    /**
+     * Get the current simulated time.
+     */
+    now(): Date;
+    /**
+     * Whether simulated time is currently standing still.
+     */
+    get isFrozen(): boolean;
+    /**
+     * Stop simulated time where it currently reads.
+     *
+     * A frozen clock reports the same instant however long the host takes, so a
+     * slow test cannot drift past the state it set up.
+     */
+    freeze(): void;
+    /**
+     * Let simulated time pass by itself again, carrying on from where it stopped.
+     *
+     * Time then runs at real speed, offset by however far it has been moved, so
+     * "jump forward an hour and carry on" behaves as it sounds.
+     */
+    resume(): void;
+    /**
+     * Set simulated time to an instant, running whatever falls due on the way.
+     *
+     * Setting time backwards runs nothing: it simply moves the clock, and work
+     * already scheduled waits for time to reach it again.
+     *
+     * Work that fails throws from here, leaving the clock at the failed task's
+     * due time rather than at the instant asked for. Simulated time got that far
+     * and then something broke, and saying so is more use than claiming the whole
+     * interval elapsed. Whatever was still queued stays queued.
+     */
+    setTo(instant: Date): Promise<void>;
+    /**
+     * Move simulated time forward by a duration, running whatever falls due.
+     *
+     * Returns once the simulation has settled, so a test can advance and then
+     * assert without waiting again.
+     */
+    advanceBy(duration: SimDuration | SimDurationInput): Promise<void>;
+    /**
+     * Dispatch everything due at or before an instant, in due order.
+     *
+     * Each task runs with the clock reading its own due time rather than the
+     * final one, so a task that stamps a timestamp records when it happened. Work
+     * a task schedules for itself settles before the next due task is taken,
+     * which keeps cascading work in order too.
+     *
+     * The loop runs as long as work keeps falling due inside the interval, as
+     * draining does generally: a task that endlessly reschedules itself inside
+     * the interval is asking for endless work, and cutting it off part way would
+     * report a settled simulation that is nothing of the kind.
+     */
+    private runDueTasksUpTo;
+    /**
+     * Keep the clock moving forward: an overdue task runs at the current time
+     * rather than dragging simulated time backwards to when it should have run.
+     */
+    private laterOfNow;
+}
+export {};
+//# sourceMappingURL=sim-clock-control.d.ts.map

package/dist/util/clock/sim-clock-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-clock-control.d.ts","sourceRoot":"","sources":["../../../src/util/clock/sim-clock-control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEvE;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GACzD,mBAAmB,GACnB,uBAAuB,CAAC;AAE1B,UAAU,yBAAyB;IACjC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;CAChD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IAEvD,YAAY,UAAU,EAAE,yBAAyB,EAGhD;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;;;;;OAUG;IACG,KAAK,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxC;IAED;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE;IAED;;;;;;;;;;;;OAYG;YACW,eAAe;IAc7B;;;OAGG;IACH,OAAO,CAAC,UAAU;CASnB"}

package/dist/util/clock/sim-clock-control.js

@@ -0,0 +1,116 @@
+import { SimDuration } from "./sim-duration.js";
+/**
+ * Control over one simulation's sense of time.
+ *
+ * Moving the clock is only half of what a test needs. The other half is that
+ * whatever the passage of time should have caused has actually happened by the
+ * time the call returns, so the next line can assert rather than wait. So this
+ * class owns both the clock and the scheduler: advancing walks simulated time
+ * forward through everything that falls due in the interval, running each task
+ * at its own due time, and returns once nothing is left pending.
+ *
+ * Control is per simulation. Moving time here never touches another simulation
+ * or the real clock, which is what keeps a SimAws instance safe to construct
+ * per test case.
+ */
+export class SimClockControl {
+    clock;
+    background;
+    constructor(properties) {
+        this.clock = properties.clock;
+        this.background = properties.background;
+    }
+    /**
+     * Get the current simulated time.
+     */
+    now() {
+        return this.clock.now();
+    }
+    /**
+     * Whether simulated time is currently standing still.
+     */
+    get isFrozen() {
+        return this.clock.isFrozen;
+    }
+    /**
+     * Stop simulated time where it currently reads.
+     *
+     * A frozen clock reports the same instant however long the host takes, so a
+     * slow test cannot drift past the state it set up.
+     */
+    freeze() {
+        this.clock.freeze();
+    }
+    /**
+     * Let simulated time pass by itself again, carrying on from where it stopped.
+     *
+     * Time then runs at real speed, offset by however far it has been moved, so
+     * "jump forward an hour and carry on" behaves as it sounds.
+     */
+    resume() {
+        this.clock.resume();
+    }
+    /**
+     * Set simulated time to an instant, running whatever falls due on the way.
+     *
+     * Setting time backwards runs nothing: it simply moves the clock, and work
+     * already scheduled waits for time to reach it again.
+     *
+     * Work that fails throws from here, leaving the clock at the failed task's
+     * due time rather than at the instant asked for. Simulated time got that far
+     * and then something broke, and saying so is more use than claiming the whole
+     * interval elapsed. Whatever was still queued stays queued.
+     */
+    async setTo(instant) {
+        if (instant.getTime() >= this.now().getTime()) {
+            await this.runDueTasksUpTo(instant);
+        }
+        this.clock.setTo(instant);
+        await this.background.complete();
+    }
+    /**
+     * Move simulated time forward by a duration, running whatever falls due.
+     *
+     * Returns once the simulation has settled, so a test can advance and then
+     * assert without waiting again.
+     */
+    async advanceBy(duration) {
+        const milliseconds = SimDuration.of(duration).toMilliseconds();
+        await this.setTo(new Date(this.now().getTime() + milliseconds));
+    }
+    /**
+     * Dispatch everything due at or before an instant, in due order.
+     *
+     * Each task runs with the clock reading its own due time rather than the
+     * final one, so a task that stamps a timestamp records when it happened. Work
+     * a task schedules for itself settles before the next due task is taken,
+     * which keeps cascading work in order too.
+     *
+     * The loop runs as long as work keeps falling due inside the interval, as
+     * draining does generally: a task that endlessly reschedules itself inside
+     * the interval is asking for endless work, and cutting it off part way would
+     * report a settled simulation that is nothing of the kind.
+     */
+    async runDueTasksUpTo(instant) {
+        let due = this.background.takeNextDueBy(instant);
+        while (due !== undefined) {
+            this.clock.setTo(this.laterOfNow(due.dueTime));
+            this.background.schedule(due.task);
+            // eslint-disable-next-line no-await-in-loop
+            await this.background.complete();
+            due = this.background.takeNextDueBy(instant);
+        }
+    }
+    /**
+     * Keep the clock moving forward: an overdue task runs at the current time
+     * rather than dragging simulated time backwards to when it should have run.
+     */
+    laterOfNow(instant) {
+        const now = this.now();
+        if (instant.getTime() < now.getTime()) {
+            return now;
+        }
+        return instant;
+    }
+}
+//# sourceMappingURL=sim-clock-control.js.map

package/dist/util/clock/sim-clock-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-clock-control.js","sourceRoot":"","sources":["../../../src/util/clock/sim-clock-control.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAyB,MAAM,mBAAmB,CAAC;AAevE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,eAAe;IACT,KAAK,CAAuB;IAC5B,UAAU,CAA4B;IAEvD,YAAY,UAAqC;QAC/C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,MAAM;QACJ,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACtB,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,KAAK,CAAC,OAAa;QACvB,IAAI,OAAO,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE1B,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,QAAwC;QACtD,MAAM,YAAY,GAAG,WAAW,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,cAAc,EAAE,CAAC;QAE/D,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,KAAK,CAAC,eAAe,CAAC,OAAa;QACzC,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAEjD,OAAO,GAAG,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAC/C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAEnC,4CAA4C;YAC5C,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YAEjC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,OAAa;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,IAAI,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC;YACtC,OAAO,GAAG,CAAC;QACb,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/util/clock/sim-clock-mode.d.ts

@@ -0,0 +1,74 @@
+import type { SimClock } from "./sim-clock.js";
+/**
+ * How a controllable clock relates simulated time to the clock underneath it.
+ *
+ * There are two ways to be in control of time, and they answer different
+ * questions. A frozen clock is what a deterministic assertion wants: simulated
+ * time only moves when something moves it, so a slow test never drifts. A
+ * running clock offset from the one underneath is what "jump forward an hour and
+ * carry on" wants: time still passes by itself, just somewhere else on the
+ * timeline.
+ *
+ * Each mode knows how to become the other, so switching never loses the current
+ * simulated instant.
+ */
+export interface SimClockMode {
+    /**
+     * Whether simulated time is standing still in this mode.
+     */
+    readonly isFrozen: boolean;
+    /**
+     * Get the simulated time this mode reports.
+     */
+    now(base: SimClock): Date;
+    /**
+     * Stop simulated time where it currently reads.
+     */
+    freeze(base: SimClock): SimClockMode;
+    /**
+     * Let simulated time run again from where it currently reads.
+     */
+    resume(base: SimClock): SimClockMode;
+}
+/**
+ * Simulated time stopped at an instant, moving only when something moves it.
+ */
+export declare class SimFrozenClockMode implements SimClockMode {
+    readonly isFrozen = true;
+    private readonly instant;
+    constructor(instant: Date);
+    /**
+     * Get the instant this mode is stopped at.
+     */
+    now(): Date;
+    /**
+     * Stay stopped: freezing an already frozen clock changes nothing.
+     */
+    freeze(): SimClockMode;
+    /**
+     * Run again from the frozen instant, keeping it as the offset from the clock
+     * underneath, so no simulated time is gained or lost by resuming.
+     */
+    resume(base: SimClock): SimClockMode;
+}
+/**
+ * Simulated time passing by itself, shifted from the clock underneath.
+ */
+export declare class SimRunningClockMode implements SimClockMode {
+    readonly isFrozen = false;
+    private readonly offsetMs;
+    constructor(offsetMs?: number);
+    /**
+     * Get the time the clock underneath reports, shifted by this offset.
+     */
+    now(base: SimClock): Date;
+    /**
+     * Stop at whatever simulated time currently reads.
+     */
+    freeze(base: SimClock): SimClockMode;
+    /**
+     * Keep running: resuming an already running clock changes nothing.
+     */
+    resume(): SimClockMode;
+}
+//# sourceMappingURL=sim-clock-mode.d.ts.map

package/dist/util/clock/sim-clock-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-clock-mode.d.ts","sourceRoot":"","sources":["../../../src/util/clock/sim-clock-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IAErC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,SAAgB,QAAQ,QAAQ;IAEhC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAO;IAE/B,YAAY,OAAO,EAAE,IAAI,EAExB;IAED;;OAEG;IACH,GAAG,IAAI,IAAI,CAEV;IAED;;OAEG;IACH,MAAM,IAAI,YAAY,CAErB;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAInC;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACtD,SAAgB,QAAQ,SAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAElC,YAAY,QAAQ,SAAI,EAEvB;IAED;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAExB;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAEnC;IAED;;OAEG;IACH,MAAM,IAAI,YAAY,CAErB;CACF"}