@carbonenginejs/runtime 0.1.0-alpha.3 → 0.1.0-alpha.4

package/dist/global/blue/CjsBlueOS.js

@@ -0,0 +1,301 @@
+import { CjsSchema, impl } from '#schema';
+import { BeInfo } from './BeInfo.js';
+import { IBlueEvents } from './IBlueEvents.js';
+import { IBlueOS } from './IBlueOS.js';
+import { ISimTimeRebaseNotify } from './ISimTimeRebaseNotify.js';
+
+// Source: blue/include/IBlueOS.h, blue/src/BlueOS.cpp:500-525, :1105-1135
+//
+// The clock and the pump, which is the half of `BeOS` this runtime needs and
+// can answer honestly. The error, startup-argument and process-control half
+// stays refused on the interface: it is a real operating-system service with
+// no consumer here, and filling it in would be inventing.
+//
+// WHY THERE IS A CONCRETE ONE AT ALL, when `blue.resMan` is a bare interface
+// that throws: the same reason `CjsBluePaths` exists. An unconfigured clock
+// can answer its questions truthfully - a browser and Node both have a
+// monotonic clock and a wallclock - whereas an unconfigured resource manager
+// cannot answer "fetch me this" at all. A host that has a better clock
+// replaces it; nothing has to be composed for the clock to be right.
+//
+// SMOOTHED TIME IS ACTUAL TIME HERE, and that is Carbon's own fallback rather
+// than a shortcut. `BlueOS::GetSmoothedTime` samples a Python frame clock and
+// returns `GetActualTime()` whenever there is no such clock, or sampling it
+// fails (`BlueOS.cpp:1109-1135`). There is no Python here, so the fallback is
+// the only branch, and the filtering Carbon's own comment calls out for
+// creating artefacts of its own is absent with it.
+//
+// SIMULATION TIME EQUALS REAL TIME HERE. Carbon's differ because simulation
+// time is "sometimes slowed down in order to manage load" (`IBlueOS.h:62`) and
+// can be moved outright by a server sync, which is what `ISimTimeRebaseNotify`
+// exists for. Neither happens in this runtime: there is no load manager and no
+// server to sync against. The two are kept as separate parameters all the way
+// through anyway, because the moment either appears the callers are already
+// written for it - collapsing them into one argument is the change that would
+// be expensive to undo.
+
+/** 100ns ticks between the FILETIME epoch (1601-01-01) and the Unix epoch. */
+const FILETIME_EPOCH_OFFSET = 116444736000000000;
+
+/** 100ns ticks in a millisecond. */
+const TICKS_PER_MILLISECOND = 10000;
+
+/**
+ * Carbon's `BeOS`, as much of it as is honest: the clock and the pump.
+ *
+ * Not a `CjsModel`. It is composed at runtime, carries no `@edit` field and is
+ * never part of a serialized object, which is the same reason `Tr2Renderer`
+ * is not one.
+ */
+class CjsBlueOS extends IBlueOS {
+  /** Wallclock at construction, in Blue UTC ticks, as the anchor for a monotonic reading. */
+  #utcAnchor = 0;
+
+  /** The monotonic clock at construction, in milliseconds. */
+  #originMs = 0;
+
+  /** `m_pumpTicksTotal` - pump cycles since creation. */
+  #pumpTicks = 0;
+
+  /** The cached smoothed time for this frame, in Blue UTC ticks. */
+  #currentFrameTime = 0;
+
+  /** Registrants of `RegisterForTicks`, each with the cookie it supplied. */
+  #tickers = [];
+
+  /** Registrants of `RegisterForSimTimeRebase`. */
+  #rebaseListeners = [];
+
+  /** Anchors the monotonic clock to the current UTC wallclock. */
+  constructor() {
+    super();
+    const wallclock = Date.now();
+    this.#originMs = CjsBlueOS.Monotonic();
+    this.#utcAnchor = FILETIME_EPOCH_OFFSET + Math.round(wallclock * TICKS_PER_MILLISECOND);
+    this.#currentFrameTime = this.#utcAnchor;
+  }
+
+  /**
+   * The monotonic clock in milliseconds, preferring `performance.now`.
+   *
+   * @returns {number} Milliseconds since an arbitrary origin.
+   */
+  static Monotonic() {
+    return typeof performance?.now === "function" ? performance.now() : Date.now();
+  }
+
+  /**
+   * The wallclock adjusted for server sync, in Blue UTC ticks
+   * (`BlueOS.cpp:1105-1107` is `mUTCAdj + mWallclock.Get()`).
+   *
+   * Read from the monotonic clock against a wallclock anchor taken once, so
+   * the reading cannot go backwards when the system clock is adjusted - which
+   * is what `mWallclock` is for on Carbon's side. There is no server to sync
+   * against here, so there is no `mUTCAdj` term.
+   *
+   * @returns {number} Blue UTC, in 100ns ticks, to roughly 1.6 microseconds.
+   */
+  GetActualTime() {
+    const elapsedMs = CjsBlueOS.Monotonic() - this.#originMs;
+    return this.#utcAnchor + Math.round(elapsedMs * TICKS_PER_MILLISECOND);
+  }
+
+  /**
+   * The cached smoothed time for this frame, in Blue UTC ticks.
+   *
+   * CACHED IS THE POINT: every consumer within one frame gets the same answer,
+   * which is why 49 Carbon call sites use this rather than `GetActualTime`.
+   * It moves only when the pump runs.
+   *
+   * @returns {number} Blue UTC, in 100ns ticks.
+   */
+  GetCurrentFrameTime() {
+    return this.#currentFrameTime;
+  }
+
+  /**
+   * One pump cycle: refresh the frame clock, then tick every registrant.
+   *
+   * Carbon's header calls this one "put here temporarily" and it has a single
+   * call site, its own main loop. A host drives it - from
+   * `requestAnimationFrame` in a browser - and nothing in the library calls it
+   * for itself.
+   *
+   * A registrant that throws does not stop the others, and the first failure
+   * is rethrown once every registrant has been offered the tick. A tick half
+   * delivered leaves some consumers a frame behind others, which is worse than
+   * a loud failure after a complete pass.
+   *
+   * @returns {CjsBlueOS} This service.
+   */
+  PumpOS() {
+    this.#pumpTicks++;
+    this.#currentFrameTime = this.GetActualTime();
+    const realTime = this.GetRealTime();
+    let failure = null;
+
+    // Iterated over a copy, because a registrant may unregister itself - or
+    // another - from inside its own tick.
+    for (const {
+      cb,
+      cookie
+    } of [...this.#tickers]) {
+      try {
+        cb.OnTick(realTime, realTime, cookie);
+      } catch (error) {
+        failure ??= error;
+      }
+    }
+    if (failure) throw failure;
+    return this;
+  }
+
+  /**
+   * Time since this service was created, in 100ns ticks.
+   *
+   * This is the base `OnTick` reports in, and it is exact: a JavaScript number
+   * counts 100ns ticks without loss for about nine years, where absolute Blue
+   * UTC cannot be held exactly at all.
+   *
+   * @returns {number} Ticks since construction.
+   */
+  GetRealTime() {
+    return Math.round((CjsBlueOS.Monotonic() - this.#originMs) * TICKS_PER_MILLISECOND);
+  }
+
+  /**
+   * Blue's clocks, framerate state and pump counters (`BeInfo`).
+   *
+   * A FRESH RECORD EACH CALL, where Carbon returns a pointer to its own
+   * long-lived struct. A caller that held Carbon's pointer would see the values
+   * move under it, which is how some of those 19 call sites use it; a caller
+   * holding this one sees a snapshot. That is the safer of the two behaviours
+   * and the one a reader of this code will assume, but it IS a difference, and
+   * a consumer polling a held record would silently never update.
+   *
+   * Only the clocks and the pump count are filled. See BeInfo for which fields
+   * are Blue's own bookkeeping and stay at their defaults.
+   *
+   * @returns {BeInfo} A snapshot of what this service knows.
+   */
+  GetInfo() {
+    const info = new BeInfo();
+    info.realTime = this.GetActualTime();
+    info.simTime = info.realTime;
+    info.startTime = this.#utcAnchor;
+    info.pumpTicksTotal = this.#pumpTicks;
+    return info;
+  }
+
+  /**
+   * Drives an `IBlueEvents` from the pump.
+   *
+   * The cookie is the registrant's own, echoed back to it on every tick;
+   * `TriDevice` uses the string "Trinity" (`TriDevice.cpp:148`). Registering
+   * the same object twice with the same cookie is ignored, as Carbon's
+   * registration is set membership rather than a count.
+   *
+   * @param {object} cb An `IBlueEvents`.
+   * @param {*} [cookie] Passed back on every tick.
+   * @returns {CjsBlueOS} This service.
+   */
+  RegisterForTicks(cb, cookie = null) {
+    // AN IDENTITY CHECK, NOT A NAME PROBE. Carbon's signature is
+    // `RegisterForTicks( IBlueEvents* cb, void* cookie )`, so the type system
+    // refuses anything else before the call is made; `CjsSchema.cast` is that
+    // refusal here. A registrant declares `IBlueEvents` with
+    // `@carbon.inherit`, as `TriDevice` does, and an object that merely
+    // happens to own an `OnTick` is not one.
+    if (!CjsSchema.cast(cb, IBlueEvents)) {
+      throw new TypeError("CjsBlueOS.RegisterForTicks expects an IBlueEvents.");
+    }
+    if (!this.#tickers.some(entry => entry.cb === cb && entry.cookie === cookie)) {
+      this.#tickers.push({
+        cb,
+        cookie
+      });
+    }
+    return this;
+  }
+
+  /**
+   * Stops driving one. Both the object and the cookie must match, as they do
+   * in Carbon's signature.
+   *
+   * @param {object} cb The registered `IBlueEvents`.
+   * @param {*} [cookie] The cookie it registered with.
+   * @returns {CjsBlueOS} This service.
+   */
+  UnregisterForTicks(cb, cookie = null) {
+    const index = this.#tickers.findIndex(entry => entry.cb === cb && entry.cookie === cookie);
+    if (index >= 0) this.#tickers.splice(index, 1);
+    return this;
+  }
+
+  /**
+   * Whether an object is registered for ticks.
+   *
+   * @param {object} cb An `IBlueEvents`.
+   * @returns {boolean} Whether the pump drives it.
+   */
+  IsRegisteredForTicks(cb) {
+    return this.#tickers.some(entry => entry.cb === cb);
+  }
+
+  /**
+   * Registers to be told when the simulation clock is moved.
+   *
+   * @param {object} cb An `ISimTimeRebaseNotify`.
+   * @returns {CjsBlueOS} This service.
+   */
+  RegisterForSimTimeRebase(cb) {
+    if (!CjsSchema.cast(cb, ISimTimeRebaseNotify)) {
+      throw new TypeError("CjsBlueOS.RegisterForSimTimeRebase expects an ISimTimeRebaseNotify.");
+    }
+    if (!this.#rebaseListeners.includes(cb)) this.#rebaseListeners.push(cb);
+    return this;
+  }
+
+  /**
+   * Stops being told.
+   *
+   * @param {object} cb The registered `ISimTimeRebaseNotify`.
+   * @returns {CjsBlueOS} This service.
+   */
+  UnregisterForSimTimeRebase(cb) {
+    const index = this.#rebaseListeners.indexOf(cb);
+    if (index >= 0) this.#rebaseListeners.splice(index, 1);
+    return this;
+  }
+
+  /**
+   * Whether the stackless scheduler is in use (`RunStackless`).
+   *
+   * @returns {boolean} False; there is no stackless Python here.
+   */
+  RunStackless() {
+    return false;
+  }
+}
+CjsSchema.define(CjsBlueOS, {
+  className: "CjsBlueOS",
+  family: "blue",
+  carbon: "BlueOS",
+  fields: {},
+  methods: {
+    GetActualTime: [impl.adapted, impl.reason("Carbon adds a server-sync adjustment (mUTCAdj) to a wallclock object; there is no server to sync against here, so the term is absent. The reading is monotonic against an anchor taken at construction rather than a fresh Date.now(), so it cannot step backwards.")],
+    GetCurrentFrameTime: [impl.implemented],
+    PumpOS: [impl.adapted, impl.reason("Carbon's pump also runs the stackless scheduler, the IO scheduling runs, the recycler update and the statistics. This is the tick delivery only. The error isolation across registrants is ours: Carbon lets an exception escape, and in a browser that would silently drop every registrant after the failing one.")],
+    GetRealTime: [impl.custom, impl.reason("Carbon has no such accessor: its equivalent is BeInfo::mRealTime, reached through GetInfo, and the pump computes the since-startup value inline. Named here because it is the base OnTick reports in, and the distinction from GetActualTime is the one thing about these clocks that is easy to get wrong.")],
+    GetInfo: [impl.adapted, impl.reason("Carbon returns a pointer to a live struct whose values move under the caller; this returns a snapshot, because a JS object handed out would otherwise have to be mutated in place to match and nothing here needs that. Only the time and pump fields are filled - the framerate, sleep, fake-time and build fields belong to a pump this runtime does not have.")],
+    RegisterForTicks: [impl.implemented],
+    UnregisterForTicks: [impl.implemented],
+    IsRegisteredForTicks: [impl.custom, impl.reason("Carbon has no such query; registration is private to BlueOS. It exists here so a host can tell whether it already registered something, and so a test can prove registration without pumping.")],
+    RegisterForSimTimeRebase: [impl.implemented],
+    UnregisterForSimTimeRebase: [impl.implemented],
+    RunStackless: [impl.adapted, impl.reason("Carbon answers whether its stackless Python scheduler is running. There is no Python in this runtime, so the answer is a constant rather than a refusal - a caller asking is asking whether it may yield, and the truthful answer is no.")]
+  }
+});
+
+export { CjsBlueOS };
+//# sourceMappingURL=CjsBlueOS.js.map

package/dist/global/blue/CjsBlueOS.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsBlueOS.js","sources":["../../../../src/global/blue/CjsBlueOS.js"],"sourcesContent":["// Source: blue/include/IBlueOS.h, blue/src/BlueOS.cpp:500-525, :1105-1135\n//\n// The clock and the pump, which is the half of `BeOS` this runtime needs and\n// can answer honestly. The error, startup-argument and process-control half\n// stays refused on the interface: it is a real operating-system service with\n// no consumer here, and filling it in would be inventing.\n//\n// WHY THERE IS A CONCRETE ONE AT ALL, when `blue.resMan` is a bare interface\n// that throws: the same reason `CjsBluePaths` exists. An unconfigured clock\n// can answer its questions truthfully - a browser and Node both have a\n// monotonic clock and a wallclock - whereas an unconfigured resource manager\n// cannot answer \"fetch me this\" at all. A host that has a better clock\n// replaces it; nothing has to be composed for the clock to be right.\n//\n// SMOOTHED TIME IS ACTUAL TIME HERE, and that is Carbon's own fallback rather\n// than a shortcut. `BlueOS::GetSmoothedTime` samples a Python frame clock and\n// returns `GetActualTime()` whenever there is no such clock, or sampling it\n// fails (`BlueOS.cpp:1109-1135`). There is no Python here, so the fallback is\n// the only branch, and the filtering Carbon's own comment calls out for\n// creating artefacts of its own is absent with it.\n//\n// SIMULATION TIME EQUALS REAL TIME HERE. Carbon's differ because simulation\n// time is \"sometimes slowed down in order to manage load\" (`IBlueOS.h:62`) and\n// can be moved outright by a server sync, which is what `ISimTimeRebaseNotify`\n// exists for. Neither happens in this runtime: there is no load manager and no\n// server to sync against. The two are kept as separate parameters all the way\n// through anyway, because the moment either appears the callers are already\n// written for it - collapsing them into one argument is the change that would\n// be expensive to undo.\nimport { CjsSchema, impl } from \"#schema\";\nimport { BeInfo } from \"./BeInfo.js\";\nimport { IBlueEvents } from \"./IBlueEvents.js\";\nimport { IBlueOS } from \"./IBlueOS.js\";\nimport { ISimTimeRebaseNotify } from \"./ISimTimeRebaseNotify.js\";\n\n/** 100ns ticks between the FILETIME epoch (1601-01-01) and the Unix epoch. */\nconst FILETIME_EPOCH_OFFSET = 116444736000000000;\n\n/** 100ns ticks in a millisecond. */\nconst TICKS_PER_MILLISECOND = 10000;\n\n/**\n * Carbon's `BeOS`, as much of it as is honest: the clock and the pump.\n *\n * Not a `CjsModel`. It is composed at runtime, carries no `@edit` field and is\n * never part of a serialized object, which is the same reason `Tr2Renderer`\n * is not one.\n */\nexport class CjsBlueOS extends IBlueOS\n{\n  /** Wallclock at construction, in Blue UTC ticks, as the anchor for a monotonic reading. */\n  #utcAnchor = 0;\n\n  /** The monotonic clock at construction, in milliseconds. */\n  #originMs = 0;\n\n  /** `m_pumpTicksTotal` - pump cycles since creation. */\n  #pumpTicks = 0;\n\n  /** The cached smoothed time for this frame, in Blue UTC ticks. */\n  #currentFrameTime = 0;\n\n  /** Registrants of `RegisterForTicks`, each with the cookie it supplied. */\n  #tickers = [];\n\n  /** Registrants of `RegisterForSimTimeRebase`. */\n  #rebaseListeners = [];\n\n  /** Anchors the monotonic clock to the current UTC wallclock. */\n  constructor()\n  {\n    super();\n    const wallclock = Date.now();\n    this.#originMs = CjsBlueOS.Monotonic();\n    this.#utcAnchor = FILETIME_EPOCH_OFFSET + Math.round(wallclock * TICKS_PER_MILLISECOND);\n    this.#currentFrameTime = this.#utcAnchor;\n  }\n\n  /**\n   * The monotonic clock in milliseconds, preferring `performance.now`.\n   *\n   * @returns {number} Milliseconds since an arbitrary origin.\n   */\n  static Monotonic()\n  {\n    return typeof performance?.now === \"function\" ? performance.now() : Date.now();\n  }\n\n  /**\n   * The wallclock adjusted for server sync, in Blue UTC ticks\n   * (`BlueOS.cpp:1105-1107` is `mUTCAdj + mWallclock.Get()`).\n   *\n   * Read from the monotonic clock against a wallclock anchor taken once, so\n   * the reading cannot go backwards when the system clock is adjusted - which\n   * is what `mWallclock` is for on Carbon's side. There is no server to sync\n   * against here, so there is no `mUTCAdj` term.\n   *\n   * @returns {number} Blue UTC, in 100ns ticks, to roughly 1.6 microseconds.\n   */\n  GetActualTime()\n  {\n    const elapsedMs = CjsBlueOS.Monotonic() - this.#originMs;\n    return this.#utcAnchor + Math.round(elapsedMs * TICKS_PER_MILLISECOND);\n  }\n\n  /**\n   * The cached smoothed time for this frame, in Blue UTC ticks.\n   *\n   * CACHED IS THE POINT: every consumer within one frame gets the same answer,\n   * which is why 49 Carbon call sites use this rather than `GetActualTime`.\n   * It moves only when the pump runs.\n   *\n   * @returns {number} Blue UTC, in 100ns ticks.\n   */\n  GetCurrentFrameTime()\n  {\n    return this.#currentFrameTime;\n  }\n\n  /**\n   * One pump cycle: refresh the frame clock, then tick every registrant.\n   *\n   * Carbon's header calls this one \"put here temporarily\" and it has a single\n   * call site, its own main loop. A host drives it - from\n   * `requestAnimationFrame` in a browser - and nothing in the library calls it\n   * for itself.\n   *\n   * A registrant that throws does not stop the others, and the first failure\n   * is rethrown once every registrant has been offered the tick. A tick half\n   * delivered leaves some consumers a frame behind others, which is worse than\n   * a loud failure after a complete pass.\n   *\n   * @returns {CjsBlueOS} This service.\n   */\n  PumpOS()\n  {\n    this.#pumpTicks++;\n    this.#currentFrameTime = this.GetActualTime();\n\n    const realTime = this.GetRealTime();\n    let failure = null;\n\n    // Iterated over a copy, because a registrant may unregister itself - or\n    // another - from inside its own tick.\n    for (const { cb, cookie } of [ ...this.#tickers ])\n    {\n      try\n      {\n        cb.OnTick(realTime, realTime, cookie);\n      }\n      catch (error)\n      {\n        failure ??= error;\n      }\n    }\n\n    if (failure) throw failure;\n    return this;\n  }\n\n  /**\n   * Time since this service was created, in 100ns ticks.\n   *\n   * This is the base `OnTick` reports in, and it is exact: a JavaScript number\n   * counts 100ns ticks without loss for about nine years, where absolute Blue\n   * UTC cannot be held exactly at all.\n   *\n   * @returns {number} Ticks since construction.\n   */\n  GetRealTime()\n  {\n    return Math.round((CjsBlueOS.Monotonic() - this.#originMs) * TICKS_PER_MILLISECOND);\n  }\n\n  /**\n   * Blue's clocks, framerate state and pump counters (`BeInfo`).\n   *\n   * A FRESH RECORD EACH CALL, where Carbon returns a pointer to its own\n   * long-lived struct. A caller that held Carbon's pointer would see the values\n   * move under it, which is how some of those 19 call sites use it; a caller\n   * holding this one sees a snapshot. That is the safer of the two behaviours\n   * and the one a reader of this code will assume, but it IS a difference, and\n   * a consumer polling a held record would silently never update.\n   *\n   * Only the clocks and the pump count are filled. See BeInfo for which fields\n   * are Blue's own bookkeeping and stay at their defaults.\n   *\n   * @returns {BeInfo} A snapshot of what this service knows.\n   */\n  GetInfo()\n  {\n    const info = new BeInfo();\n    info.realTime = this.GetActualTime();\n    info.simTime = info.realTime;\n    info.startTime = this.#utcAnchor;\n    info.pumpTicksTotal = this.#pumpTicks;\n    return info;\n  }\n\n  /**\n   * Drives an `IBlueEvents` from the pump.\n   *\n   * The cookie is the registrant's own, echoed back to it on every tick;\n   * `TriDevice` uses the string \"Trinity\" (`TriDevice.cpp:148`). Registering\n   * the same object twice with the same cookie is ignored, as Carbon's\n   * registration is set membership rather than a count.\n   *\n   * @param {object} cb An `IBlueEvents`.\n   * @param {*} [cookie] Passed back on every tick.\n   * @returns {CjsBlueOS} This service.\n   */\n  RegisterForTicks(cb, cookie = null)\n  {\n    // AN IDENTITY CHECK, NOT A NAME PROBE. Carbon's signature is\n    // `RegisterForTicks( IBlueEvents* cb, void* cookie )`, so the type system\n    // refuses anything else before the call is made; `CjsSchema.cast` is that\n    // refusal here. A registrant declares `IBlueEvents` with\n    // `@carbon.inherit`, as `TriDevice` does, and an object that merely\n    // happens to own an `OnTick` is not one.\n    if (!CjsSchema.cast(cb, IBlueEvents))\n    {\n      throw new TypeError(\"CjsBlueOS.RegisterForTicks expects an IBlueEvents.\");\n    }\n    if (!this.#tickers.some(entry => entry.cb === cb && entry.cookie === cookie))\n    {\n      this.#tickers.push({ cb, cookie });\n    }\n    return this;\n  }\n\n  /**\n   * Stops driving one. Both the object and the cookie must match, as they do\n   * in Carbon's signature.\n   *\n   * @param {object} cb The registered `IBlueEvents`.\n   * @param {*} [cookie] The cookie it registered with.\n   * @returns {CjsBlueOS} This service.\n   */\n  UnregisterForTicks(cb, cookie = null)\n  {\n    const index = this.#tickers.findIndex(entry => entry.cb === cb && entry.cookie === cookie);\n    if (index >= 0) this.#tickers.splice(index, 1);\n    return this;\n  }\n\n  /**\n   * Whether an object is registered for ticks.\n   *\n   * @param {object} cb An `IBlueEvents`.\n   * @returns {boolean} Whether the pump drives it.\n   */\n  IsRegisteredForTicks(cb)\n  {\n    return this.#tickers.some(entry => entry.cb === cb);\n  }\n\n  /**\n   * Registers to be told when the simulation clock is moved.\n   *\n   * @param {object} cb An `ISimTimeRebaseNotify`.\n   * @returns {CjsBlueOS} This service.\n   */\n  RegisterForSimTimeRebase(cb)\n  {\n    if (!CjsSchema.cast(cb, ISimTimeRebaseNotify))\n    {\n      throw new TypeError(\"CjsBlueOS.RegisterForSimTimeRebase expects an ISimTimeRebaseNotify.\");\n    }\n    if (!this.#rebaseListeners.includes(cb)) this.#rebaseListeners.push(cb);\n    return this;\n  }\n\n  /**\n   * Stops being told.\n   *\n   * @param {object} cb The registered `ISimTimeRebaseNotify`.\n   * @returns {CjsBlueOS} This service.\n   */\n  UnregisterForSimTimeRebase(cb)\n  {\n    const index = this.#rebaseListeners.indexOf(cb);\n    if (index >= 0) this.#rebaseListeners.splice(index, 1);\n    return this;\n  }\n\n  /**\n   * Whether the stackless scheduler is in use (`RunStackless`).\n   *\n   * @returns {boolean} False; there is no stackless Python here.\n   */\n  RunStackless()\n  {\n    return false;\n  }\n}\n\nCjsSchema.define(CjsBlueOS, {\n  className: \"CjsBlueOS\",\n  family: \"blue\",\n  carbon: \"BlueOS\",\n  fields: {},\n  methods: {\n    GetActualTime: [ impl.adapted, impl.reason(\"Carbon adds a server-sync adjustment (mUTCAdj) to a wallclock object; there is no server to sync against here, so the term is absent. The reading is monotonic against an anchor taken at construction rather than a fresh Date.now(), so it cannot step backwards.\") ],\n    GetCurrentFrameTime: [ impl.implemented ],\n    PumpOS: [ impl.adapted, impl.reason(\"Carbon's pump also runs the stackless scheduler, the IO scheduling runs, the recycler update and the statistics. This is the tick delivery only. The error isolation across registrants is ours: Carbon lets an exception escape, and in a browser that would silently drop every registrant after the failing one.\") ],\n    GetRealTime: [ impl.custom, impl.reason(\"Carbon has no such accessor: its equivalent is BeInfo::mRealTime, reached through GetInfo, and the pump computes the since-startup value inline. Named here because it is the base OnTick reports in, and the distinction from GetActualTime is the one thing about these clocks that is easy to get wrong.\") ],\n    GetInfo: [ impl.adapted, impl.reason(\"Carbon returns a pointer to a live struct whose values move under the caller; this returns a snapshot, because a JS object handed out would otherwise have to be mutated in place to match and nothing here needs that. Only the time and pump fields are filled - the framerate, sleep, fake-time and build fields belong to a pump this runtime does not have.\") ],\n    RegisterForTicks: [ impl.implemented ],\n    UnregisterForTicks: [ impl.implemented ],\n    IsRegisteredForTicks: [ impl.custom, impl.reason(\"Carbon has no such query; registration is private to BlueOS. It exists here so a host can tell whether it already registered something, and so a test can prove registration without pumping.\") ],\n    RegisterForSimTimeRebase: [ impl.implemented ],\n    UnregisterForSimTimeRebase: [ impl.implemented ],\n    RunStackless: [ impl.adapted, impl.reason(\"Carbon answers whether its stackless Python scheduler is running. There is no Python in this runtime, so the answer is a constant rather than a refusal - a caller asking is asking whether it may yield, and the truthful answer is no.\") ]\n  }\n});\n"],"names":["FILETIME_EPOCH_OFFSET","TICKS_PER_MILLISECOND","CjsBlueOS","IBlueOS","constructor","wallclock","Date","now","Monotonic","Math","round","performance","GetActualTime","elapsedMs","GetCurrentFrameTime","PumpOS","realTime","GetRealTime","failure","cb","cookie","OnTick","error","GetInfo","info","BeInfo","simTime","startTime","pumpTicksTotal","RegisterForTicks","CjsSchema","cast","IBlueEvents","TypeError","some","entry","push","UnregisterForTicks","index","findIndex","splice","IsRegisteredForTicks","RegisterForSimTimeRebase","ISimTimeRebaseNotify","includes","UnregisterForSimTimeRebase","indexOf","RunStackless","define","className","family","carbon","fields","methods","impl","adapted","reason","implemented","custom"],"mappings":"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"}

package/dist/global/blue/CjsBluePaths.js

@@ -0,0 +1,97 @@
+import { CjsSchema, impl, carbon } from '#schema';
+import { IBluePaths } from './IBluePaths.js';
+
+// Source: blue/include/IBluePaths.h
+//
+// The paths service as a browser can answer it. Carbon asks its file system;
+// here the same questions are answered from a res file index the composer
+// supplies - the "fake local machine", which is what a browser has instead of
+// a disk it may walk.
+//
+// WHY THIS IS INSTALLED BY DEFAULT WHERE THE MANAGER IS NOT. An uncomposed
+// resource manager cannot answer "fetch me this" at all, so it throws. An
+// uncomposed paths service CAN answer "is this file here": no, it is not.
+// Carbon returns exactly that for a file absent from the local machine
+// (`FileExistsLocally`, IBluePaths.h:38), and every caller is written for the
+// answer already - `Tr2Mesh::InitializeGeometryResource` takes the authored
+// path when the probe says no. Throwing instead would make "no index" a
+// different case from "no such file", which it is not.
+//
+// The verbs this cannot answer without a real file system stay refused, from
+// IBluePaths. They are not no-ops: a caller that needs a directory listing or a
+// stream needs a service that has one.
+
+/** Browser paths service: res-file-index existence, with the file-system verbs still refused. */
+class CjsBluePaths extends IBluePaths {
+  #index = null;
+
+  /**
+   * Installs the synchronous res-file index these questions are answered from.
+   *
+   * Accepts a predicate or any membership collection. A collection is compared
+   * case-insensitively, as Carbon's file system does. Null uninstalls, after
+   * which nothing is presumed to exist.
+   *
+   * @param {((path: string) => boolean)|Iterable<string>|Set<string>|Map<string, *>|null} index Index or predicate.
+   * @returns {CjsBluePaths} This service.
+   */
+  SetResourceFileIndex(index = null) {
+    if (index === null || index === undefined) {
+      this.#index = null;
+      return this;
+    }
+    if (typeof index === "function") {
+      this.#index = path => Boolean(index(path));
+      return this;
+    }
+    if (index instanceof Set || index instanceof Map) {
+      this.#index = path => index.has(path);
+      return this;
+    }
+    if (typeof index[Symbol.iterator] === "function") {
+      const names = new Set(Array.from(index, name => String(name ?? "").toLowerCase()));
+      this.#index = path => names.has(String(path ?? "").toLowerCase());
+      return this;
+    }
+    throw new TypeError("CjsBluePaths.SetResourceFileIndex expects a predicate, an iterable of paths, a Set, a Map, or null.");
+  }
+
+  /** Whether an index is installed at all, which composition asks and callers do not. */
+  HasResourceFileIndex() {
+    return this.#index !== null;
+  }
+
+  /**
+   * `FileExistsLocally` - whether the index says this file is here.
+   *
+   * False with no index installed, which is what keeps a caller on the path it
+   * was authored with rather than guessing a sibling exists.
+   */
+  FileExistsLocally(path) {
+    if (!this.#index || !path) return false;
+    return Boolean(this.#index(path));
+  }
+
+  /**
+   * `FileExists` - the same question, since a browser has no second place to
+   * look. Carbon distinguishes the local disk from stuff files and the remote
+   * cache; a res file index is one list.
+   */
+  FileExists(path) {
+    return this.FileExistsLocally(path);
+  }
+}
+CjsSchema.define(CjsBluePaths, {
+  className: "CjsBluePaths",
+  family: "blue",
+  fields: {},
+  methods: {
+    FileExistsLocally: [carbon.method, impl.implemented],
+    FileExists: [carbon.method, impl.adapted, impl.reason("Carbon separates the local disk from stuff files and the remote cache; a res file index is one list, so both questions have one answer.")],
+    SetResourceFileIndex: [impl.custom, impl.reason("Carbon's file system needs no installing. A browser has no disk to walk, so the index it answers from is supplied by composition.")],
+    HasResourceFileIndex: [impl.custom, impl.reason("Composition asks whether it has installed an index; a caller never does, because 'no index' and 'no such file' are one answer.")]
+  }
+});
+
+export { CjsBluePaths };
+//# sourceMappingURL=CjsBluePaths.js.map

package/dist/global/blue/CjsBluePaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsBluePaths.js","sources":["../../../../src/global/blue/CjsBluePaths.js"],"sourcesContent":["// Source: blue/include/IBluePaths.h\n//\n// The paths service as a browser can answer it. Carbon asks its file system;\n// here the same questions are answered from a res file index the composer\n// supplies - the \"fake local machine\", which is what a browser has instead of\n// a disk it may walk.\n//\n// WHY THIS IS INSTALLED BY DEFAULT WHERE THE MANAGER IS NOT. An uncomposed\n// resource manager cannot answer \"fetch me this\" at all, so it throws. An\n// uncomposed paths service CAN answer \"is this file here\": no, it is not.\n// Carbon returns exactly that for a file absent from the local machine\n// (`FileExistsLocally`, IBluePaths.h:38), and every caller is written for the\n// answer already - `Tr2Mesh::InitializeGeometryResource` takes the authored\n// path when the probe says no. Throwing instead would make \"no index\" a\n// different case from \"no such file\", which it is not.\n//\n// The verbs this cannot answer without a real file system stay refused, from\n// IBluePaths. They are not no-ops: a caller that needs a directory listing or a\n// stream needs a service that has one.\nimport { CjsSchema, carbon, impl } from \"#schema\";\nimport { IBluePaths } from \"./IBluePaths.js\";\n\n/** Browser paths service: res-file-index existence, with the file-system verbs still refused. */\nexport class CjsBluePaths extends IBluePaths\n{\n  #index = null;\n\n  /**\n   * Installs the synchronous res-file index these questions are answered from.\n   *\n   * Accepts a predicate or any membership collection. A collection is compared\n   * case-insensitively, as Carbon's file system does. Null uninstalls, after\n   * which nothing is presumed to exist.\n   *\n   * @param {((path: string) => boolean)|Iterable<string>|Set<string>|Map<string, *>|null} index Index or predicate.\n   * @returns {CjsBluePaths} This service.\n   */\n  SetResourceFileIndex(index = null)\n  {\n    if (index === null || index === undefined)\n    {\n      this.#index = null;\n      return this;\n    }\n    if (typeof index === \"function\")\n    {\n      this.#index = path => Boolean(index(path));\n      return this;\n    }\n    if (index instanceof Set || index instanceof Map)\n    {\n      this.#index = path => index.has(path);\n      return this;\n    }\n    if (typeof index[Symbol.iterator] === \"function\")\n    {\n      const names = new Set(Array.from(index, name => String(name ?? \"\").toLowerCase()));\n      this.#index = path => names.has(String(path ?? \"\").toLowerCase());\n      return this;\n    }\n    throw new TypeError(\n      \"CjsBluePaths.SetResourceFileIndex expects a predicate, an iterable of paths, a Set, a Map, or null.\"\n    );\n  }\n\n  /** Whether an index is installed at all, which composition asks and callers do not. */\n  HasResourceFileIndex()\n  {\n    return this.#index !== null;\n  }\n\n  /**\n   * `FileExistsLocally` - whether the index says this file is here.\n   *\n   * False with no index installed, which is what keeps a caller on the path it\n   * was authored with rather than guessing a sibling exists.\n   */\n  FileExistsLocally(path)\n  {\n    if (!this.#index || !path) return false;\n    return Boolean(this.#index(path));\n  }\n\n  /**\n   * `FileExists` - the same question, since a browser has no second place to\n   * look. Carbon distinguishes the local disk from stuff files and the remote\n   * cache; a res file index is one list.\n   */\n  FileExists(path)\n  {\n    return this.FileExistsLocally(path);\n  }\n}\n\nCjsSchema.define(CjsBluePaths, {\n  className: \"CjsBluePaths\",\n  family: \"blue\",\n  fields: {},\n  methods: {\n    FileExistsLocally: [ carbon.method, impl.implemented ],\n    FileExists: [ carbon.method, impl.adapted, impl.reason(\"Carbon separates the local disk from stuff files and the remote cache; a res file index is one list, so both questions have one answer.\") ],\n    SetResourceFileIndex: [ impl.custom, impl.reason(\"Carbon's file system needs no installing. A browser has no disk to walk, so the index it answers from is supplied by composition.\") ],\n    HasResourceFileIndex: [ impl.custom, impl.reason(\"Composition asks whether it has installed an index; a caller never does, because 'no index' and 'no such file' are one answer.\") ]\n  }\n});\n"],"names":["CjsBluePaths","IBluePaths","SetResourceFileIndex","index","undefined","path","Boolean","Set","Map","has","Symbol","iterator","names","Array","from","name","String","toLowerCase","TypeError","HasResourceFileIndex","FileExistsLocally","FileExists","CjsSchema","define","className","family","fields","methods","carbon","method","impl","implemented","adapted","reason","custom"],"mappings":"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"}

package/dist/global/blue/IBlueDynamicResourceConstructor.js

@@ -0,0 +1,29 @@
+import { CjsSchema, compose, impl } from '#schema';
+
+// Source: blue/include/IBlueResMan.h:39-44
+//
+// The factory behind a `dynamic:/<name>/<query>` path. The manager knows
+// nothing about what it builds: the thing that knows registers itself, as
+// Carbon's procedural textures do from their own files -
+// `BeResMan->RegisterResourceConstructor( L"gradient_1d", this )`
+// (`Resources/Procedural/GradientTexture.cpp:35`) and `L"color"`
+// (`SolidColorTexture.cpp:21`).
+//
+// Declared beside IBlueResMan in Carbon's one header; here it takes its own
+// file, because a class is found by its own name.
+
+/** `IBlueDynamicResourceConstructor` - builds a resource for a `dynamic:/<name>` path. */
+class IBlueDynamicResourceConstructor {
+  /** `GetResource` - construct the resource this query describes. */
+  GetResource(_query) {}
+}
+CjsSchema.decorateMethod(IBlueDynamicResourceConstructor, "GetResource", compose.abstract, impl.abstract);
+CjsSchema.define(IBlueDynamicResourceConstructor, {
+  className: "IBlueDynamicResourceConstructor",
+  carbon: "IBlueDynamicResourceConstructor",
+  family: "blue",
+  fields: {}
+});
+
+export { IBlueDynamicResourceConstructor };
+//# sourceMappingURL=IBlueDynamicResourceConstructor.js.map

package/dist/global/blue/IBlueDynamicResourceConstructor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBlueDynamicResourceConstructor.js","sources":["../../../../src/global/blue/IBlueDynamicResourceConstructor.js"],"sourcesContent":["// Source: blue/include/IBlueResMan.h:39-44\n//\n// The factory behind a `dynamic:/<name>/<query>` path. The manager knows\n// nothing about what it builds: the thing that knows registers itself, as\n// Carbon's procedural textures do from their own files -\n// `BeResMan->RegisterResourceConstructor( L\"gradient_1d\", this )`\n// (`Resources/Procedural/GradientTexture.cpp:35`) and `L\"color\"`\n// (`SolidColorTexture.cpp:21`).\n//\n// Declared beside IBlueResMan in Carbon's one header; here it takes its own\n// file, because a class is found by its own name.\nimport { CjsSchema, compose, impl } from \"#schema\";\n\n/** `IBlueDynamicResourceConstructor` - builds a resource for a `dynamic:/<name>` path. */\nexport class IBlueDynamicResourceConstructor\n{\n  /** `GetResource` - construct the resource this query describes. */\n  GetResource(_query) {}\n}\n\nCjsSchema.decorateMethod(IBlueDynamicResourceConstructor, \"GetResource\", compose.abstract, impl.abstract);\nCjsSchema.define(IBlueDynamicResourceConstructor, {\n  className: \"IBlueDynamicResourceConstructor\", carbon: \"IBlueDynamicResourceConstructor\", family: \"blue\", fields: {}\n});\n"],"names":["IBlueDynamicResourceConstructor","GetResource","_query","CjsSchema","decorateMethod","compose","abstract","impl","define","className","carbon","family","fields"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,+BAA+B,CAC5C;AACE;EACAC,WAAWA,CAACC,MAAM,EAAE,CAAC;AACvB;AAEAC,SAAS,CAACC,cAAc,CAACJ,+BAA+B,EAAE,aAAa,EAAEK,OAAO,CAACC,QAAQ,EAAEC,IAAI,CAACD,QAAQ,CAAC;AACzGH,SAAS,CAACK,MAAM,CAACR,+BAA+B,EAAE;AAChDS,EAAAA,SAAS,EAAE,iCAAiC;AAAEC,EAAAA,MAAM,EAAE,iCAAiC;AAAEC,EAAAA,MAAM,EAAE,MAAM;AAAEC,EAAAA,MAAM,EAAE;AACnH,CAAC,CAAC;;;;"}

package/dist/global/blue/IBlueEvents.js

@@ -0,0 +1,34 @@
+import { CjsSchema, compose, impl } from '#schema';
+
+// Source: blue/include/IBlueOS.h:229-243
+//
+//     struct IBlueEvents
+//     {
+//         virtual void OnTick( Be::Time realTime, Be::Time simTime, void* cookie ) = 0;
+//     };
+//
+// The fixed-rate tick callback. Anything that wants to be driven by Blue's
+// pump implements this and hands itself to `RegisterForTicks` with a cookie of
+// its own choosing; `TriDevice` registers with the string "Trinity"
+// (`TriDevice.cpp:148,310`) and advances the animation clock from `simTime`.
+//
+// BOTH TIMES ARE "SINCE THE CLIENT STARTED", per the header's own comments on
+// the parameters - NOT the Blue UTC values that `GetActualTime` and
+// `GetCurrentFrameTime` return. The two bases are easy to confuse and the
+// difference is about four centuries.
+
+/** `IBlueEvents` - the fixed-rate tick callback, per blue/include/IBlueOS.h:229. */
+class IBlueEvents {
+  /**
+   * `OnTick` - one pump cycle.
+   *
+   * @param {number} _realTime Time since the client started, in 100ns ticks.
+   * @param {number} _simTime The same, slowed under load to manage it.
+   * @param {*} _cookie Whatever the registrant passed to RegisterForTicks.
+   */
+  OnTick(_realTime, _simTime, _cookie) {}
+}
+CjsSchema.decorateMethod(IBlueEvents, "OnTick", compose.abstract, impl.abstract);
+
+export { IBlueEvents };
+//# sourceMappingURL=IBlueEvents.js.map

package/dist/global/blue/IBlueEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBlueEvents.js","sources":["../../../../src/global/blue/IBlueEvents.js"],"sourcesContent":["// Source: blue/include/IBlueOS.h:229-243\n//\n//     struct IBlueEvents\n//     {\n//         virtual void OnTick( Be::Time realTime, Be::Time simTime, void* cookie ) = 0;\n//     };\n//\n// The fixed-rate tick callback. Anything that wants to be driven by Blue's\n// pump implements this and hands itself to `RegisterForTicks` with a cookie of\n// its own choosing; `TriDevice` registers with the string \"Trinity\"\n// (`TriDevice.cpp:148,310`) and advances the animation clock from `simTime`.\n//\n// BOTH TIMES ARE \"SINCE THE CLIENT STARTED\", per the header's own comments on\n// the parameters - NOT the Blue UTC values that `GetActualTime` and\n// `GetCurrentFrameTime` return. The two bases are easy to confuse and the\n// difference is about four centuries.\nimport { CjsSchema, compose, impl } from \"#schema\";\n\n/** `IBlueEvents` - the fixed-rate tick callback, per blue/include/IBlueOS.h:229. */\nexport class IBlueEvents\n{\n  /**\n   * `OnTick` - one pump cycle.\n   *\n   * @param {number} _realTime Time since the client started, in 100ns ticks.\n   * @param {number} _simTime The same, slowed under load to manage it.\n   * @param {*} _cookie Whatever the registrant passed to RegisterForTicks.\n   */\n  OnTick(_realTime, _simTime, _cookie) {}\n}\n\nCjsSchema.decorateMethod(IBlueEvents, \"OnTick\", compose.abstract, impl.abstract);\n"],"names":["IBlueEvents","OnTick","_realTime","_simTime","_cookie","CjsSchema","decorateMethod","compose","abstract","impl"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACO,MAAMA,WAAW,CACxB;AACE;AACF;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,MAAMA,CAACC,SAAS,EAAEC,QAAQ,EAAEC,OAAO,EAAE,CAAC;AACxC;AAEAC,SAAS,CAACC,cAAc,CAACN,WAAW,EAAE,QAAQ,EAAEO,OAAO,CAACC,QAAQ,EAAEC,IAAI,CAACD,QAAQ,CAAC;;;;"}