@matter/general 0.16.2-alpha.0-20260114-d3127faee → 0.16.2

package/dist/esm/time/Timestamp.js

@@ -50,7 +50,7 @@ class TimestampFormatError extends UnexpectedDataError {
     return new Date(timestamp);
   }
   Timestamp2.dateOf = dateOf;
-  function delta(from, to) {
+  function delta(from, to = Time.nowMs) {
     return to - from;
   }
   Timestamp2.delta = delta;

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

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/time/Timestamp.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,2BAA2B;AAGpC,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,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,GAAG;AAClC,YAAM,IAAI,qBAAqB,0BAA0B;AAAA,IAC7D;AAAA,EACJ,WAAW,OAAO,WAAW,YAAY,WAAW,QAAQ,kBAAkB,MAAM;AAChF,QAAI,CAAC,OAAO,SAAS,OAAO,QAAQ,CAAC,GAAG;AACpC,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,CAAC,OAAO,SAAS,MAAM,GAAG;AAC1B,YAAM,IAAI,qBAAqB,qCAAqC;AAAA,IACxE;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;AAOT,WAAS,MAAM,MAAiB,IAAe;AAClD,WAAQ,KAAK;AAAA,EACjB;AAFO,EAAAA,WAAS;AAAA,GAtCH;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,2BAA2B;AAGpC,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,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,GAAG;AAClC,YAAM,IAAI,qBAAqB,0BAA0B;AAAA,IAC7D;AAAA,EACJ,WAAW,OAAO,WAAW,YAAY,WAAW,QAAQ,kBAAkB,MAAM;AAChF,QAAI,CAAC,OAAO,SAAS,OAAO,QAAQ,CAAC,GAAG;AACpC,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,CAAC,OAAO,SAAS,MAAM,GAAG;AAC1B,YAAM,IAAI,qBAAqB,qCAAqC;AAAA,IACxE;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;AAOT,WAAS,MAAM,MAAiB,KAAgB,KAAK,OAAO;AAC/D,WAAQ,KAAK;AAAA,EACjB;AAFO,EAAAA,WAAS;AAAA,GAtCH;",
   "names": ["Timestamp"]
 }

package/dist/esm/util/Scheduler.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Timestamp } from "#time/Timestamp.js";
+import { Lifetime } from "./Lifetime.js";
+import { MaybePromise } from "./Promises.js";
+import { Semaphore } from "./Semaphore.js";
+/**
+ * Task scheduler.
+ *
+ * Runs workers at a designated time.
+ */
+export declare class Scheduler<T> {
+    #private;
+    constructor({ name, lifetime, timeOf, run, semaphore, }: Scheduler.Configuration<T>);
+    /**
+     * Schedule a worker.
+     */
+    add(worker: T): void;
+    /**
+     * Unschedule a worker.
+     */
+    delete(worker: T): void;
+    /**
+     * Update a worker's scheduled run time.
+     */
+    reschedule(worker: T): void;
+    /**
+     * Close.
+     *
+     * Stops accepting workers.  Returns when all workers are complete.
+     */
+    close(): Promise<void>;
+}
+export declare namespace Scheduler {
+    interface Configuration<T> {
+        /**
+         * Name used for diagnostics.
+         *
+         * Defaults to "scheduler".
+         */
+        name?: string;
+        /**
+         * Owner lifetime.
+         *
+         * Defaults to process.
+         */
+        lifetime?: Lifetime.Owner;
+        /**
+         * Identify the scheduled time for a specific worker.
+         */
+        timeOf(worker: T): Timestamp;
+        /**
+         * Execute a worker.
+         */
+        run(worker: T, abort: AbortSignal): MaybePromise<void>;
+        /**
+         * If present, controls worker concurrency.
+         *
+         * Providing the semaphore here rather than using it within the worker prevents the worker from starting when no
+         * queue slot is available.
+         */
+        semaphore?: Semaphore;
+    }
+}
+//# sourceMappingURL=Scheduler.d.ts.map

package/dist/esm/util/Scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scheduler.d.ts","sourceRoot":"","sources":["../../../src/util/Scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C;;;;GAIG;AACH,qBAAa,SAAS,CAAC,CAAC;;gBAUR,EACR,IAAkB,EAClB,QAA2B,EAC3B,MAAM,EACN,GAAG,EACH,SAAS,GACZ,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC;IAW7B;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,CAAC;IAOb;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,CAAC;IAIhB;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,CAAC;IAKpB;;;;OAIG;IACG,KAAK;CA8Dd;AAED,yBAAiB,SAAS,CAAC;IACvB,UAAiB,aAAa,CAAC,CAAC;QAC5B;;;;WAIG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd;;;;WAIG;QACH,QAAQ,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;QAE1B;;WAEG;QACH,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;QAE7B;;WAEG;QACH,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAEvD;;;;;WAKG;QACH,SAAS,CAAC,EAAE,SAAS,CAAC;KACzB;CACJ"}

package/dist/esm/util/Scheduler.js

@@ -0,0 +1,187 @@
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (async) dispose = value[__knownSymbol("asyncDispose")];
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+      if (async) inner = dispose;
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Logger } from "#log/Logger.js";
+import { ImplementationError } from "#MatterError.js";
+import { Time } from "#time/Time.js";
+import { Timestamp } from "#time/Timestamp.js";
+import { Abort } from "./Abort.js";
+import { asError } from "./Error.js";
+import { Heap } from "./Heap.js";
+import { Lifetime } from "./Lifetime.js";
+import { BasicMultiplex } from "./Multiplex.js";
+const logger = Logger.get("Scheduler");
+class Scheduler {
+  #name;
+  #lifetime;
+  #timeOf;
+  #run;
+  #queue;
+  #abort = new Abort();
+  #workers = new BasicMultiplex();
+  #semaphore;
+  constructor({
+    name = "scheduler",
+    lifetime = Lifetime.process,
+    timeOf,
+    run,
+    semaphore
+  }) {
+    this.#name = name;
+    this.#lifetime = lifetime.join(this.#name);
+    this.#timeOf = timeOf;
+    this.#run = run;
+    this.#semaphore = semaphore;
+    this.#queue = new Heap(comparatorFor(timeOf));
+    this.#workers.add(this.#schedule());
+  }
+  /**
+   * Schedule a worker.
+   */
+  add(worker) {
+    if (this.#lifetime.isClosing) {
+      throw new ImplementationError(`Cannot schedule new work because ${this.#name} is closed`);
+    }
+    this.#queue.add(worker);
+  }
+  /**
+   * Unschedule a worker.
+   */
+  delete(worker) {
+    this.#queue.delete(worker);
+  }
+  /**
+   * Update a worker's scheduled run time.
+   */
+  reschedule(worker) {
+    this.#queue.delete(worker);
+    this.#queue.add(worker);
+  }
+  /**
+   * Close.
+   *
+   * Stops accepting workers.  Returns when all workers are complete.
+   */
+  async close() {
+    var _stack = [];
+    try {
+      const _closing = __using(_stack, this.#lifetime.closing());
+      this.#abort();
+      await this.#workers;
+    } catch (_) {
+      var _error = _, _hasError = true;
+    } finally {
+      __callDispose(_stack, _error, _hasError);
+    }
+  }
+  /**
+   * Performs actual scheduling of workers.
+   */
+  async #schedule() {
+    while (!this.#abort.aborted) {
+      var _stack = [];
+      try {
+        const now = Time.nowMs;
+        let first = this.#queue.first;
+        let nextAt = first ? this.#timeOf(first) : void 0;
+        while (nextAt !== void 0 && nextAt <= now) {
+          if (this.#abort.aborted) {
+            return;
+          }
+          let slot;
+          if (this.#semaphore) {
+            slot = await this.#semaphore.obtainSlot(this.#abort);
+            if (this.#abort.aborted) {
+              return;
+            }
+          }
+          try {
+            this.#queue.shift();
+            const promise = this.#run(first, this.#abort.signal);
+            if (promise) {
+              let p = Promise.resolve(promise).catch(this.#unhandled.bind(this));
+              if (slot) {
+                p = p.finally(() => slot[Symbol.dispose]());
+              }
+              this.#workers.add(p);
+            } else {
+              slot?.[Symbol.dispose]();
+            }
+          } catch (e) {
+            slot?.[Symbol.dispose]();
+            this.#unhandled(e);
+          }
+          first = this.#queue.first;
+          nextAt = first ? this.#timeOf(first) : void 0;
+        }
+        const abort = __using(_stack, new Abort({
+          abort: this.#abort,
+          timeout: nextAt === void 0 ? void 0 : Timestamp.delta(now, nextAt)
+        }));
+        const _abortOnChange = __using(_stack, this.#queue.firstChanged.use((newFirst) => abort.if(newFirst !== first)));
+        await abort;
+      } catch (_) {
+        var _error = _, _hasError = true;
+      } finally {
+        __callDispose(_stack, _error, _hasError);
+      }
+    }
+  }
+  #unhandled(e) {
+    logger.error(`Unhandled error in ${this.#name} worker:`, asError(e));
+  }
+}
+function comparatorFor(timeOf) {
+  return (a, b) => timeOf(a) - timeOf(b);
+}
+export {
+  Scheduler
+};
+//# sourceMappingURL=Scheduler.js.map

package/dist/esm/util/Scheduler.js.map

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

package/dist/esm/util/Semaphore.d.ts

@@ -14,10 +14,6 @@ export interface WorkSlot extends Disposable {
      * This is called automatically when using `using` syntax.
      */
     close(): void;
-    /**
-     * Release the slot automatically when the object is garbage collected.
-     */
-    [Symbol.dispose](): void;
 }
 /**
  * A queue that limits concurrent work using a slot-based approach.

package/dist/esm/util/Semaphore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Semaphore.d.ts","sourceRoot":"","sources":["../../../src/util/Semaphore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IACxC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC5B;AAED;;;;;GAKG;AACH,qBAAa,SAAS;;gBAYN,KAAK,EAAE,MAAM,EAAE,WAAW,SAAI,EAAE,KAAK,WAAU;IAO3D;;;;;;;;;;OAUG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsIzD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,IAAI,KAAK,WAER;IAED;;OAEG;IACH,IAAI,OAAO,WAEV;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"Semaphore.d.ts","sourceRoot":"","sources":["../../../src/util/Semaphore.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAI7C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,UAAU;IACxC;;;OAGG;IACH,KAAK,IAAI,IAAI,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;;gBAYN,KAAK,EAAE,MAAM,EAAE,WAAW,SAAI,EAAE,KAAK,WAAU;IAO3D;;;;;;;;;;OAUG;IACG,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsIzD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,IAAI,KAAK,WAER;IAED;;OAEG;IACH,IAAI,OAAO,WAEV;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAMhB"}

package/dist/esm/util/Semaphore.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/Semaphore.ts"],
-  "mappings": "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",
+  "mappings": "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",
   "names": []
 }

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

@@ -35,6 +35,7 @@ export * from "./NamedHandler.js";
 export * from "./Number.js";
 export * from "./Observable.js";
 export * from "./Promises.js";
+export * from "./Scheduler.js";
 export * from "./Semaphore.js";
 export * from "./serialize.js";
 export * from "./Set.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/esm/util/index.js

@@ -35,6 +35,7 @@ export * from "./NamedHandler.js";
 export * from "./Number.js";
 export * from "./Observable.js";
 export * from "./Promises.js";
+export * from "./Scheduler.js";
 export * from "./Semaphore.js";
 export * from "./serialize.js";
 export * from "./Set.js";

package/dist/esm/util/index.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/util/index.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/general",
-    "version": "0.16.2-alpha.0-20260114-d3127faee",
+    "version": "0.16.2",
     "description": "Non-Matter support for Matter.js",
     "keywords": [
         "iot",
@@ -36,7 +36,7 @@
         "@noble/curves": "^2.0.1"
     },
     "devDependencies": {
-        "@matter/testing": "0.16.2-alpha.0-20260114-d3127faee"
+        "@matter/testing": "0.16.2"
     },
     "files": [
         "dist/**/*",

package/src/net/Network.ts

@@ -16,6 +16,8 @@ export class BindError extends NetworkError {}
 
 export class AddressInUseError extends BindError {}
 
+export class AddressUnreachableError extends NetworkError {}
+
 export const STANDARD_MATTER_PORT = 5540;
 
 /**

package/src/net/RetrySchedule.ts

@@ -68,7 +68,7 @@ export namespace RetrySchedule {
         /**
          * Overall timeout.
          *
-         * Leave undefined to allow indefinite transmission.
+         * Leave undefined to allow unlimited retries.
          */
         readonly timeout?: Duration;
 

package/src/time/TimeUnit.ts

@@ -159,3 +159,8 @@ export const Days = TimeUnit("day", "d", 86_400_000);
  * A zero-length interval.
  */
 export const Instant = Millis(0);
+
+/**
+ * An infinite interval.
+ */
+export const Forever = Millis(Infinity);

package/src/time/Timestamp.ts

@@ -96,7 +96,7 @@ export namespace Timestamp {
     /**
      * Compute the duration between two timestamps.
      */
-    export function delta(from: Timestamp, to: Timestamp) {
+    export function delta(from: Timestamp, to: Timestamp = Time.nowMs) {
         return (to - from) as Duration;
     }
 }

package/src/util/Scheduler.ts

@@ -0,0 +1,185 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { Logger } from "#log/Logger.js";
+import { ImplementationError } from "#MatterError.js";
+import { Time } from "#time/Time.js";
+import { Timestamp } from "#time/Timestamp.js";
+import { Abort } from "./Abort.js";
+import { asError } from "./Error.js";
+import { Heap } from "./Heap.js";
+import { Lifetime } from "./Lifetime.js";
+import { BasicMultiplex } from "./Multiplex.js";
+import { MaybePromise } from "./Promises.js";
+import { Semaphore } from "./Semaphore.js";
+
+const logger = Logger.get("Scheduler");
+
+/**
+ * Task scheduler.
+ *
+ * Runs workers at a designated time.
+ */
+export class Scheduler<T> {
+    #name: string;
+    #lifetime: Lifetime;
+    #timeOf: Scheduler.Configuration<T>["timeOf"];
+    #run: Scheduler.Configuration<T>["run"];
+    #queue: Heap<T>;
+    #abort = new Abort();
+    #workers = new BasicMultiplex();
+    #semaphore?: Semaphore;
+
+    constructor({
+        name = "scheduler",
+        lifetime = Lifetime.process,
+        timeOf,
+        run,
+        semaphore,
+    }: Scheduler.Configuration<T>) {
+        this.#name = name;
+        this.#lifetime = lifetime.join(this.#name);
+        this.#timeOf = timeOf;
+        this.#run = run;
+        this.#semaphore = semaphore;
+
+        this.#queue = new Heap(comparatorFor(timeOf));
+        this.#workers.add(this.#schedule());
+    }
+
+    /**
+     * Schedule a worker.
+     */
+    add(worker: T) {
+        if (this.#lifetime.isClosing) {
+            throw new ImplementationError(`Cannot schedule new work because ${this.#name} is closed`);
+        }
+        this.#queue.add(worker);
+    }
+
+    /**
+     * Unschedule a worker.
+     */
+    delete(worker: T) {
+        this.#queue.delete(worker);
+    }
+
+    /**
+     * Update a worker's scheduled run time.
+     */
+    reschedule(worker: T) {
+        this.#queue.delete(worker);
+        this.#queue.add(worker);
+    }
+
+    /**
+     * Close.
+     *
+     * Stops accepting workers.  Returns when all workers are complete.
+     */
+    async close() {
+        using _closing = this.#lifetime.closing();
+        this.#abort();
+        await this.#workers;
+    }
+
+    /**
+     * Performs actual scheduling of workers.
+     */
+    async #schedule() {
+        while (!this.#abort.aborted) {
+            // Activate workers that have no more delay
+            const now = Time.nowMs;
+            let first = this.#queue.first;
+            let nextAt = first ? this.#timeOf(first) : undefined;
+            while (nextAt !== undefined && nextAt <= now) {
+                if (this.#abort.aborted) {
+                    return;
+                }
+
+                let slot: undefined | Disposable;
+                if (this.#semaphore) {
+                    slot = await this.#semaphore.obtainSlot(this.#abort);
+                    if (this.#abort.aborted) {
+                        return;
+                    }
+                }
+
+                try {
+                    this.#queue.shift();
+                    const promise = this.#run(first!, this.#abort.signal);
+                    if (promise) {
+                        let p = Promise.resolve(promise).catch(this.#unhandled.bind(this));
+                        if (slot) {
+                            p = p.finally(() => slot[Symbol.dispose]());
+                        }
+                        this.#workers.add(p);
+                    } else {
+                        slot?.[Symbol.dispose]();
+                    }
+                } catch (e) {
+                    slot?.[Symbol.dispose]();
+                    this.#unhandled(e);
+                }
+
+                first = this.#queue.first;
+                nextAt = first ? this.#timeOf(first) : undefined;
+            }
+
+            // Wait for delay for next worker, abort or change in head of queue
+            using abort = new Abort({
+                abort: this.#abort,
+                timeout: nextAt === undefined ? undefined : Timestamp.delta(now, nextAt),
+            });
+            using _abortOnChange = this.#queue.firstChanged.use(newFirst => abort.if(newFirst !== first));
+            await abort;
+        }
+    }
+
+    #unhandled(e: unknown) {
+        logger.error(`Unhandled error in ${this.#name} worker:`, asError(e));
+    }
+}
+
+export namespace Scheduler {
+    export interface Configuration<T> {
+        /**
+         * Name used for diagnostics.
+         *
+         * Defaults to "scheduler".
+         */
+        name?: string;
+
+        /**
+         * Owner lifetime.
+         *
+         * Defaults to process.
+         */
+        lifetime?: Lifetime.Owner;
+
+        /**
+         * Identify the scheduled time for a specific worker.
+         */
+        timeOf(worker: T): Timestamp;
+
+        /**
+         * Execute a worker.
+         */
+        run(worker: T, abort: AbortSignal): MaybePromise<void>;
+
+        /**
+         * If present, controls worker concurrency.
+         *
+         * Providing the semaphore here rather than using it within the worker prevents the worker from starting when no
+         * queue slot is available.
+         */
+        semaphore?: Semaphore;
+    }
+}
+
+function comparatorFor<T>(timeOf: Scheduler.Configuration<T>["timeOf"]) {
+    return (a: T, b: T) => timeOf(a) - timeOf(b);
+}

package/src/util/Semaphore.ts

@@ -23,11 +23,6 @@ export interface WorkSlot extends Disposable {
      * This is called automatically when using `using` syntax.
      */
     close(): void;
-
-    /**
-     * Release the slot automatically when the object is garbage collected.
-     */
-    [Symbol.dispose](): void;
 }
 
 /**

package/src/util/index.ts

@@ -36,6 +36,7 @@ export * from "./NamedHandler.js";
 export * from "./Number.js";
 export * from "./Observable.js";
 export * from "./Promises.js";
+export * from "./Scheduler.js";
 export * from "./Semaphore.js";
 export * from "./serialize.js";
 export * from "./Set.js";