@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/format-notices/gr2/THIRD-PARTY-NOTICES.md

@@ -13,7 +13,7 @@ reference-only.
 
 ---
 
-## Oodle1 / Oodle0 decompressor - `src/core/oodle1.js`
+## Oodle1 / Oodle0 decompressor - `src/resource/formats/gr2/core/oodle1.js`
 
 **Boost Software License 1.0.** Ported from the Granny `gr2_decompress` implementation
 shipped in [Arbos/nwn2mdk](https://github.com/Arbos/nwn2mdk) (the decompressor is
@@ -49,7 +49,7 @@ DEALINGS IN THE SOFTWARE.
 
 ---
 
-## BitKnit / BitKnit2 decompressor - `src/core/bitknit2.js`
+## BitKnit / BitKnit2 decompressor - `src/resource/formats/gr2/core/bitknit2.js`
 
 **Original CarbonEngineJS code (MIT).** On 2026-07-24 the previous
 EUPL-derived port (transcribed from
@@ -57,7 +57,7 @@ EUPL-derived port (transcribed from
 `GrannyBitKnitCompression.cs`, EUPL-1.2) was replaced by a clean-room
 implementation produced through a documented two-party process: one party
 analyzed the format and published a facts-only decoding specification
-(`docs/formats/bitknit2.md`); a second, isolated party implemented the
+(`docs/resource/formats/bitknit2.md`); a second, isolated party implemented the
 decoder solely from that specification with no access to Knit, pybg3, ooz,
 or any other BitKnit implementation. The result was validated byte-exact
 against 539 BitKnit2 streams extracted from the EVE `.gr2` corpus (section
@@ -68,13 +68,13 @@ format facts only.
 
 ---
 
-## Granny animation-curve decompression - `src/core/curves.js`
+## Granny animation-curve decompression - `src/resource/formats/gr2/core/curves.js`
 
 Authored by **cppctamber** as part of ccpwgl2 (`src/core/reader/granny/curves`), the
 same author/owner as this library; included here under this project's MIT
 license.
 
-## Tangent-frame shader math - `src/core/tangents.js`
+## Tangent-frame shader math - `src/global/math/tangent.js`
 
 The packed tangent-frame decode/encode math is derived from Fenris Creations
 (formerly CCP / CCP Games) EVE/Carbon shader behavior for packed tangent frames.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carbonenginejs/runtime",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.1",
   "private": false,
   "description": "Browser-safe CarbonEngineJS runtime: resource and format readers, the Trinity/EVE object graph, SOF, audio, character, and the WebGPU renderer.",
   "type": "module",
@@ -27,6 +27,7 @@
     "./math/pool": "./dist/global/math/pool.js",
     "./math/utils": "./dist/global/math/utils.js",
     "./math/noise": "./dist/global/math/noise.js",
+    "./math/random": "./dist/global/math/random.js",
     "./math/curve": "./dist/global/math/curve.js",
     "./math/vertex": "./dist/global/math/vertex.js",
     "./math/mesh": "./dist/global/math/mesh.js",
@@ -55,6 +56,7 @@
     "./consts/d3d": "./dist/global/consts/d3d/index.js",
     "./consts/webgpu": "./dist/global/consts/webgpu/index.js",
     "./contracts": "./dist/global/contracts/index.js",
+    "./blue": "./dist/global/blue/index.js",
     "./schema": "./dist/global/schema/index.js",
     "./schema/types": "./dist/global/schema/types/index.js",
     "./schema/hydration": "./dist/global/schema/hydration.js",
@@ -191,6 +193,7 @@
     "#consts/webgpu": "./dist/global/consts/webgpu/index.js",
     "#consts/*": "./dist/global/consts/*.js",
     "#contracts": "./dist/global/contracts/index.js",
+    "#blue": "./dist/global/blue/index.js",
     "#contracts/*": "./dist/global/contracts/*.js",
     "#schema": "./dist/global/schema/index.js",
     "#schema/types": "./dist/global/schema/types/index.js",

package/dist/audio/trinity/audio/AudActionLog.js

@@ -1,173 +0,0 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { carbon, impl, type } from '#schema';
-import { CjsModel } from '#model';
-
-let _initProto, _initClass;
-function Now() {
-  return globalThis.performance?.now() ?? Date.now();
-}
-
-/** Provides the base value contract for one queued Carbon audio action. */
-class AudActionRecord {
-  /** Carbon's Python bridge returns a tuple; JavaScript uses the equivalent array. */
-  ToPyObject() {
-    return [];
-  }
-}
-
-/** Records one event post with time, emitter, playing, event, and name identities. */
-class AudActionRecordPostEvent extends AudActionRecord {
-  /** Creates one event-post record. */
-  constructor(time = 0, emitterID = 0, playID = 0, eventID = 0, name = "") {
-    super();
-    this.time = time;
-    this.emitterID = emitterID;
-    this.playID = playID;
-    this.eventID = eventID;
-    this.name = String(name);
-  }
-
-  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */
-  ToPyObject() {
-    return ["AudActionRecordPostEvent", this.time, this.emitterID, this.playID, this.eventID, this.name];
-  }
-}
-
-/** Records one stop or break action applied to a playing identity. */
-class AudActionRecordExecuteActionOnPlayingID extends AudActionRecord {
-  /** Creates one playing-id action record. */
-  constructor(time = 0, emitterID = 0, playID = 0, action = "") {
-    super();
-    this.time = time;
-    this.emitterID = emitterID;
-    this.playID = playID;
-    this.action = String(action);
-  }
-
-  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */
-  ToPyObject() {
-    return ["AudActionRecordExecuteActionOnPlayingID", this.time, this.emitterID, this.playID, this.action];
-  }
-}
-
-/** Records one emitter-local switch group and state change. */
-class AudActionRecordSetSwitch extends AudActionRecord {
-  /** Creates one emitter-local switch record. */
-  constructor(time = 0, emitterID = 0, group = "", state = "") {
-    super();
-    this.time = time;
-    this.emitterID = emitterID;
-    this.group = String(group);
-    this.state = String(state);
-  }
-
-  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */
-  ToPyObject() {
-    return ["AudActionRecordSetSwitch", this.time, this.emitterID, this.group, this.state];
-  }
-}
-
-/** Records one global audio state-group change. */
-class AudActionRecordSetState extends AudActionRecord {
-  /** Creates one global state record. */
-  constructor(time = 0, group = "", state = "") {
-    super();
-    this.time = time;
-    this.group = String(group);
-    this.state = String(state);
-  }
-
-  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */
-  ToPyObject() {
-    return ["AudActionRecordSetState", this.time, this.group, this.state];
-  }
-}
-
-/** Records one global or emitter-local real-time parameter change. */
-class AudActionRecordSetRTPC extends AudActionRecord {
-  /** Creates one global or emitter-local RTPC record. */
-  constructor(time = 0, emitterID = 0, name = "", value = 0, playID = 0) {
-    super();
-    this.time = time;
-    this.emitterID = emitterID;
-    this.name = String(name);
-    this.value = Number(value);
-    this.playID = playID;
-  }
-
-  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */
-  ToPyObject() {
-    return ["AudActionRecordSetRTPC", this.time, this.emitterID, this.name, this.value, this.playID];
-  }
-}
-
-/**
- * Queues Carbon-shaped audio action records and flushes them to a registered
- * JavaScript callback during manager processing.
- */
-let _AudActionLogCB;
-class AudActionLogCB extends CjsModel {
-  static {
-    ({
-      e: [_initProto],
-      c: [_AudActionLogCB, _initClass]
-    } = _applyDecs2311(this, [type.define({
-      className: "AudActionLogCB",
-      family: "audio"
-    })], [[[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("BlueScriptCallback is represented by a JavaScript function or an object exposing CallVoid(record).")], 18, "RegisterCallback"], [[carbon, carbon.method, impl, impl.implemented], 18, "LogPostEvent"], [[carbon, carbon.method, impl, impl.implemented], 18, "LogExecuteActionOnPlayingID"], [[carbon, carbon.method, impl, impl.implemented], 18, "LogSetSwitch"], [[carbon, carbon.method, impl, impl.implemented], 18, "LogSetState"], [[carbon, carbon.method, impl, impl.implemented], 18, "LogSetRTPC"], [[carbon, carbon.method, impl, impl.implemented], 18, "Flush"]], 0, void 0, CjsModel));
-  }
-  #callback = (_initProto(this), null);
-  #queue = [];
-
-  /** Carbon method RegisterCallback. Null unregisters without discarding queued records. */
-  RegisterCallback(callback) {
-    if (callback !== null && callback !== undefined && typeof callback !== "function" && typeof callback?.CallVoid !== "function") {
-      throw new TypeError("AudActionLogCB.RegisterCallback requires a function, CallVoid object, or null.");
-    }
-    this.#callback = callback ?? null;
-  }
-
-  /** Carbon IAudActionLog method LogPostEvent. */
-  LogPostEvent(emitterID, playID, eventID, name) {
-    this.#queue.push(new AudActionRecordPostEvent(Now(), emitterID, playID, eventID, name));
-  }
-
-  /** Carbon IAudActionLog method LogExecuteActionOnPlayingID. */
-  LogExecuteActionOnPlayingID(emitterID, playID, action) {
-    this.#queue.push(new AudActionRecordExecuteActionOnPlayingID(Now(), emitterID, playID, action));
-  }
-
-  /** Carbon IAudActionLog method LogSetSwitch. */
-  LogSetSwitch(emitterID, group, state) {
-    this.#queue.push(new AudActionRecordSetSwitch(Now(), emitterID, group, state));
-  }
-
-  /** Carbon IAudActionLog method LogSetState. */
-  LogSetState(group, state) {
-    this.#queue.push(new AudActionRecordSetState(Now(), group, state));
-  }
-
-  /** Carbon IAudActionLog method LogSetRTPC. */
-  LogSetRTPC(emitterID, name, value, playID = 0) {
-    this.#queue.push(new AudActionRecordSetRTPC(Now(), emitterID, name, value, playID));
-  }
-
-  /** Carbon method Flush. Records remain queued until a callback exists. */
-  Flush() {
-    while (this.#callback && this.#queue.length) {
-      const record = this.#queue[0].ToPyObject();
-      if (typeof this.#callback === "function") {
-        this.#callback(record);
-      } else {
-        this.#callback.CallVoid(record);
-      }
-      this.#queue.shift();
-    }
-  }
-  static {
-    _initClass();
-  }
-}
-
-export { _AudActionLogCB as AudActionLogCB, AudActionRecord, AudActionRecordExecuteActionOnPlayingID, AudActionRecordPostEvent, AudActionRecordSetRTPC, AudActionRecordSetState, AudActionRecordSetSwitch };
-//# sourceMappingURL=AudActionLog.js.map

package/dist/audio/trinity/audio/AudActionLog.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AudActionLog.js","sources":["../../../../../src/audio/trinity/audio/AudActionLog.js"],"sourcesContent":["// Source: audio/src/AudActionLog.h + AudActionLog.cpp\r\n// Hand-owned behavior port. Verify against audio/AudActionLogCB.json and the\r\n// AudActionRecord*.json schema documents.\r\nimport { carbon, impl, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\n\r\nfunction Now()\r\n{\r\n  return globalThis.performance?.now() ?? Date.now();\r\n}\r\n\r\n/** Provides the base value contract for one queued Carbon audio action. */\r\nexport class AudActionRecord\r\n{\r\n\r\n  /** Carbon's Python bridge returns a tuple; JavaScript uses the equivalent array. */\r\n  ToPyObject()\r\n  {\r\n    return [];\r\n  }\r\n\r\n}\r\n\r\n/** Records one event post with time, emitter, playing, event, and name identities. */\r\nexport class AudActionRecordPostEvent extends AudActionRecord\r\n{\r\n\r\n  /** Creates one event-post record. */\r\n  constructor(time = 0, emitterID = 0, playID = 0, eventID = 0, name = \"\")\r\n  {\r\n    super();\r\n    this.time = time;\r\n    this.emitterID = emitterID;\r\n    this.playID = playID;\r\n    this.eventID = eventID;\r\n    this.name = String(name);\r\n  }\r\n\r\n  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */\r\n  ToPyObject()\r\n  {\r\n    return [ \"AudActionRecordPostEvent\", this.time, this.emitterID, this.playID, this.eventID, this.name ];\r\n  }\r\n\r\n}\r\n\r\n/** Records one stop or break action applied to a playing identity. */\r\nexport class AudActionRecordExecuteActionOnPlayingID extends AudActionRecord\r\n{\r\n\r\n  /** Creates one playing-id action record. */\r\n  constructor(time = 0, emitterID = 0, playID = 0, action = \"\")\r\n  {\r\n    super();\r\n    this.time = time;\r\n    this.emitterID = emitterID;\r\n    this.playID = playID;\r\n    this.action = String(action);\r\n  }\r\n\r\n  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */\r\n  ToPyObject()\r\n  {\r\n    return [ \"AudActionRecordExecuteActionOnPlayingID\", this.time, this.emitterID, this.playID, this.action ];\r\n  }\r\n\r\n}\r\n\r\n/** Records one emitter-local switch group and state change. */\r\nexport class AudActionRecordSetSwitch extends AudActionRecord\r\n{\r\n\r\n  /** Creates one emitter-local switch record. */\r\n  constructor(time = 0, emitterID = 0, group = \"\", state = \"\")\r\n  {\r\n    super();\r\n    this.time = time;\r\n    this.emitterID = emitterID;\r\n    this.group = String(group);\r\n    this.state = String(state);\r\n  }\r\n\r\n  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */\r\n  ToPyObject()\r\n  {\r\n    return [ \"AudActionRecordSetSwitch\", this.time, this.emitterID, this.group, this.state ];\r\n  }\r\n\r\n}\r\n\r\n/** Records one global audio state-group change. */\r\nexport class AudActionRecordSetState extends AudActionRecord\r\n{\r\n\r\n  /** Creates one global state record. */\r\n  constructor(time = 0, group = \"\", state = \"\")\r\n  {\r\n    super();\r\n    this.time = time;\r\n    this.group = String(group);\r\n    this.state = String(state);\r\n  }\r\n\r\n  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */\r\n  ToPyObject()\r\n  {\r\n    return [ \"AudActionRecordSetState\", this.time, this.group, this.state ];\r\n  }\r\n\r\n}\r\n\r\n/** Records one global or emitter-local real-time parameter change. */\r\nexport class AudActionRecordSetRTPC extends AudActionRecord\r\n{\r\n\r\n  /** Creates one global or emitter-local RTPC record. */\r\n  constructor(time = 0, emitterID = 0, name = \"\", value = 0, playID = 0)\r\n  {\r\n    super();\r\n    this.time = time;\r\n    this.emitterID = emitterID;\r\n    this.name = String(name);\r\n    this.value = Number(value);\r\n    this.playID = playID;\r\n  }\r\n\r\n  /** Returns Carbon's Python-bridge tuple as a JavaScript array. */\r\n  ToPyObject()\r\n  {\r\n    return [ \"AudActionRecordSetRTPC\", this.time, this.emitterID, this.name, this.value, this.playID ];\r\n  }\r\n\r\n}\r\n\r\n/**\r\n * Queues Carbon-shaped audio action records and flushes them to a registered\r\n * JavaScript callback during manager processing.\r\n */\r\n@type.define({ className: \"AudActionLogCB\", family: \"audio\" })\r\nexport class AudActionLogCB extends CjsModel\r\n{\r\n\r\n  #callback = null;\r\n\r\n  #queue = [];\r\n\r\n  /** Carbon method RegisterCallback. Null unregisters without discarding queued records. */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"BlueScriptCallback is represented by a JavaScript function or an object exposing CallVoid(record).\")\r\n  RegisterCallback(callback)\r\n  {\r\n    if (callback !== null && callback !== undefined\r\n      && typeof callback !== \"function\" && typeof callback?.CallVoid !== \"function\")\r\n    {\r\n      throw new TypeError(\"AudActionLogCB.RegisterCallback requires a function, CallVoid object, or null.\");\r\n    }\r\n    this.#callback = callback ?? null;\r\n  }\r\n\r\n  /** Carbon IAudActionLog method LogPostEvent. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  LogPostEvent(emitterID, playID, eventID, name)\r\n  {\r\n    this.#queue.push(new AudActionRecordPostEvent(Now(), emitterID, playID, eventID, name));\r\n  }\r\n\r\n  /** Carbon IAudActionLog method LogExecuteActionOnPlayingID. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  LogExecuteActionOnPlayingID(emitterID, playID, action)\r\n  {\r\n    this.#queue.push(new AudActionRecordExecuteActionOnPlayingID(Now(), emitterID, playID, action));\r\n  }\r\n\r\n  /** Carbon IAudActionLog method LogSetSwitch. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  LogSetSwitch(emitterID, group, state)\r\n  {\r\n    this.#queue.push(new AudActionRecordSetSwitch(Now(), emitterID, group, state));\r\n  }\r\n\r\n  /** Carbon IAudActionLog method LogSetState. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  LogSetState(group, state)\r\n  {\r\n    this.#queue.push(new AudActionRecordSetState(Now(), group, state));\r\n  }\r\n\r\n  /** Carbon IAudActionLog method LogSetRTPC. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  LogSetRTPC(emitterID, name, value, playID = 0)\r\n  {\r\n    this.#queue.push(new AudActionRecordSetRTPC(Now(), emitterID, name, value, playID));\r\n  }\r\n\r\n  /** Carbon method Flush. Records remain queued until a callback exists. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Flush()\r\n  {\r\n    while (this.#callback && this.#queue.length)\r\n    {\r\n      const record = this.#queue[0].ToPyObject();\r\n      if (typeof this.#callback === \"function\")\r\n      {\r\n        this.#callback(record);\r\n      }\r\n      else\r\n      {\r\n        this.#callback.CallVoid(record);\r\n      }\r\n      this.#queue.shift();\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["Now","globalThis","performance","now","Date","AudActionRecord","ToPyObject","AudActionRecordPostEvent","constructor","time","emitterID","playID","eventID","name","String","AudActionRecordExecuteActionOnPlayingID","action","AudActionRecordSetSwitch","group","state","AudActionRecordSetState","AudActionRecordSetRTPC","value","Number","_AudActionLogCB","AudActionLogCB","CjsModel","e","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","method","impl","adapted","reason","implemented","RegisterCallback","callback","undefined","CallVoid","TypeError","LogPostEvent","push","LogExecuteActionOnPlayingID","LogSetSwitch","LogSetState","LogSetRTPC","Flush","length","record","shift"],"mappings":"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"}

package/dist/audio/trinity/audio/AudObstructionOcclusion.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AudObstructionOcclusion.js","sources":["../../../../../src/audio/trinity/audio/AudObstructionOcclusion.js"],"sourcesContent":["// Source: audio/src/AudObstructionOcclusion.h + AudObstructionOcclusion.cpp\r\n// Headless behavior port. The host supplies blockage; this class performs no\r\n// ray casting and leaves the audible obstruction/occlusion law to the backend.\r\n\r\nimport { LISTENER_GAME_OBJ_ID } from \"./SoundPrioritization.js\";\r\n\r\nconst DEFAULT_FADE_RATE = 1;\r\n\r\nfunction NowSeconds()\r\n{\r\n  return (globalThis.performance?.now() ?? Date.now()) / 1000;\r\n}\r\n\r\nfunction ClampUnit(value)\r\n{\r\n  return Math.max(0, Math.min(1, Number(value)));\r\n}\r\n\r\n/** One obstruction or occlusion value fading towards an authored target. */\r\nclass FadingValue\r\n{\r\n  currentValue = 0;\r\n\r\n  targetValue = 0;\r\n\r\n  /** Clamps and stores the next fade target. */\r\n  SetTarget(target)\r\n  {\r\n    this.targetValue = ClampUnit(target);\r\n  }\r\n\r\n  /** Advances linearly by one clock delta and reports a live-value change. */\r\n  Advance(deltaSeconds, fadeRate)\r\n  {\r\n    if (this.currentValue === this.targetValue)\r\n    {\r\n      return false;\r\n    }\r\n    if (fadeRate <= 0)\r\n    {\r\n      this.currentValue = this.targetValue;\r\n      return true;\r\n    }\r\n\r\n    const previous = this.currentValue;\r\n    const step = fadeRate * deltaSeconds;\r\n\r\n    if (previous > this.targetValue)\r\n    {\r\n      this.currentValue = Math.max(this.targetValue, previous - step);\r\n    }\r\n    else\r\n    {\r\n      this.currentValue = Math.min(this.targetValue, previous + step);\r\n    }\r\n    return this.currentValue !== previous;\r\n  }\r\n\r\n  /** Applies the target immediately for a newly tracked emitter. */\r\n  SnapToTarget()\r\n  {\r\n    this.currentValue = this.targetValue;\r\n  }\r\n}\r\n\r\n/** Obstruction/occlusion fade state retained for one registered emitter. */\r\nclass EmitterState\r\n{\r\n  obstruction = new FadingValue();\r\n\r\n  occlusion = new FadingValue();\r\n\r\n  needsSend = true;\r\n}\r\n\r\n/**\r\n * Owns Carbon's caller-supplied line-of-sight state and backend delivery.\r\n *\r\n * This collaborator is intentionally not exported from the package. Hosts use\r\n * the Carbon-facing AudManager methods; injected backends may implement\r\n * SetObjectObstructionAndOcclusion to realize the values.\r\n */\r\nexport class AudObstructionOcclusion\r\n{\r\n  #audioManager;\r\n\r\n  #emitters = new Map();\r\n\r\n  #fadeRate = DEFAULT_FADE_RATE;\r\n\r\n  #hasUpdated = false;\r\n\r\n  #lastUpdateTime = 0;\r\n\r\n  #enabled = true;\r\n\r\n  #now;\r\n\r\n  /** Creates Carbon's obstruction/occlusion collaborator for one manager. */\r\n  constructor(audioManager, now = NowSeconds)\r\n  {\r\n    this.#audioManager = audioManager;\r\n    this.#now = now;\r\n  }\r\n\r\n  /** Advances every fade and sends changed awake-emitter values. */\r\n  Update(backend)\r\n  {\r\n    if (!this.#audioManager\r\n      || this.#audioManager.GetState?.() !== \"enabled\")\r\n    {\r\n      return;\r\n    }\r\n\r\n    const now = Number(this.#now());\r\n    const deltaSeconds = this.#hasUpdated && Number.isFinite(now)\r\n      ? Math.max(0, now - this.#lastUpdateTime)\r\n      : 0;\r\n\r\n    this.#lastUpdateTime = Number.isFinite(now) ? now : NowSeconds();\r\n    this.#hasUpdated = true;\r\n\r\n    for (const [ emitterID, state ] of this.#emitters)\r\n    {\r\n      let culled = false;\r\n      const exists = this.#audioManager.WithCallbackGameObject?.(\r\n        emitterID,\r\n        emitter =>\r\n        {\r\n          culled = emitter.IsCulled?.() === true;\r\n        },\r\n      ) === true;\r\n\r\n      if (!exists)\r\n      {\r\n        this.#emitters.delete(emitterID);\r\n        continue;\r\n      }\r\n\r\n      const obstructionChanged = state.obstruction.Advance(\r\n        deltaSeconds,\r\n        this.#fadeRate,\r\n      );\r\n      const occlusionChanged = state.occlusion.Advance(\r\n        deltaSeconds,\r\n        this.#fadeRate,\r\n      );\r\n\r\n      if (culled)\r\n      {\r\n        state.needsSend = true;\r\n        continue;\r\n      }\r\n      if (obstructionChanged || occlusionChanged || state.needsSend)\r\n      {\r\n        state.needsSend = !this.#SendToBackend(\r\n          backend,\r\n          emitterID,\r\n          state,\r\n        );\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Sets the obstruction and occlusion targets for a registered emitter. */\r\n  SetObstructionOcclusion(emitterID, obstruction, occlusion)\r\n  {\r\n    if (!this.#enabled\r\n      || !this.#audioManager\r\n      || this.#audioManager.GetState?.() !== \"enabled\"\r\n      || emitterID === LISTENER_GAME_OBJ_ID\r\n      || this.#audioManager.WithCallbackGameObject?.(\r\n        emitterID,\r\n        () => {},\r\n      ) !== true)\r\n    {\r\n      return false;\r\n    }\r\n\r\n    let state = this.#emitters.get(emitterID);\r\n    const isNewEmitter = !state;\r\n\r\n    if (!state)\r\n    {\r\n      state = new EmitterState();\r\n      this.#emitters.set(emitterID, state);\r\n    }\r\n    state.obstruction.SetTarget(obstruction);\r\n    state.occlusion.SetTarget(occlusion);\r\n\r\n    if (isNewEmitter)\r\n    {\r\n      state.obstruction.SnapToTarget();\r\n      state.occlusion.SnapToTarget();\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Maps caller-supplied blockage to Carbon's acoustics-aware targets. */\r\n  SetEmitterLineOfSightBlockage(emitterID, blockage)\r\n  {\r\n    const acousticsEnabled = this.#audioManager\r\n      ?.GetSpatialAudioGeometryEnabled?.() === true;\r\n\r\n    return this.SetObstructionOcclusion(\r\n      emitterID,\r\n      0,\r\n      acousticsEnabled ? 0 : blockage,\r\n    );\r\n  }\r\n\r\n  /** Returns the live, mid-fade occlusion value for one emitter. */\r\n  GetEmitterOcclusion(emitterID)\r\n  {\r\n    return this.#emitters.get(emitterID)?.occlusion.currentValue ?? 0;\r\n  }\r\n\r\n  /** Drops one emitter immediately when its game object is unregistered. */\r\n  RemoveEmitter(emitterID)\r\n  {\r\n    this.#emitters.delete(emitterID);\r\n  }\r\n\r\n  /** Forgets every emitter and resets the fade clock. */\r\n  Reset()\r\n  {\r\n    this.#emitters.clear();\r\n    this.#hasUpdated = false;\r\n    this.#lastUpdateTime = 0;\r\n  }\r\n\r\n  /** Fades every tracked emitter back to clear. */\r\n  ClearAll()\r\n  {\r\n    for (const state of this.#emitters.values())\r\n    {\r\n      state.obstruction.SetTarget(0);\r\n      state.occlusion.SetTarget(0);\r\n    }\r\n  }\r\n\r\n  /** Returns whether new caller-supplied targets are accepted. */\r\n  IsEnabled()\r\n  {\r\n    return this.#enabled;\r\n  }\r\n\r\n  /** Enables target input or fades every existing target to clear. */\r\n  SetEnabled(value)\r\n  {\r\n    const enabled = Boolean(value);\r\n\r\n    if (this.#enabled === enabled)\r\n    {\r\n      return;\r\n    }\r\n    this.#enabled = enabled;\r\n    if (!enabled)\r\n    {\r\n      this.ClearAll();\r\n    }\r\n  }\r\n\r\n  /** Returns the linear fade speed in value units per second. */\r\n  GetFadeRate()\r\n  {\r\n    return this.#fadeRate;\r\n  }\r\n\r\n  /** Stores Carbon's nonnegative linear fade speed. */\r\n  SetFadeRate(value)\r\n  {\r\n    this.#fadeRate = Math.max(0, Number(value));\r\n  }\r\n\r\n  /** Delivers one live value through the optional Wwise-shaped backend seam. */\r\n  #SendToBackend(backend, emitterID, state)\r\n  {\r\n    if (typeof backend?.SetObjectObstructionAndOcclusion !== \"function\")\r\n    {\r\n      return false;\r\n    }\r\n    // Runtime-audio backend setters conventionally accept a void return and\r\n    // reserve explicit false for rejection. A rejection retains needsSend so\r\n    // the next Process retries, matching Carbon's failed AKRESULT behavior.\r\n    return backend.SetObjectObstructionAndOcclusion(\r\n      emitterID,\r\n      LISTENER_GAME_OBJ_ID,\r\n      state.obstruction.currentValue,\r\n      state.occlusion.currentValue,\r\n    ) !== false;\r\n  }\r\n}\r\n"],"names":["DEFAULT_FADE_RATE","NowSeconds","globalThis","performance","now","Date","ClampUnit","value","Math","max","min","Number","FadingValue","currentValue","targetValue","SetTarget","target","Advance","deltaSeconds","fadeRate","previous","step","SnapToTarget","EmitterState","obstruction","occlusion","needsSend","AudObstructionOcclusion","Map","constructor","audioManager","Update","backend","GetState","isFinite","emitterID","state","culled","exists","WithCallbackGameObject","emitter","IsCulled","delete","obstructionChanged","occlusionChanged","SetObstructionOcclusion","LISTENER_GAME_OBJ_ID","get","isNewEmitter","set","SetEmitterLineOfSightBlockage","blockage","acousticsEnabled","GetSpatialAudioGeometryEnabled","GetEmitterOcclusion","RemoveEmitter","Reset","clear","ClearAll","values","IsEnabled","SetEnabled","enabled","Boolean","GetFadeRate","SetFadeRate","#SendToBackend","SetObjectObstructionAndOcclusion"],"mappings":"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"}

package/dist/global/contracts/CjsScriptCallback.js

@@ -1,94 +0,0 @@
-import { impl } from '../schema/index.js';
-import { CjsSchema } from '../schema/CjsSchema.js';
-
-/**
- * Dependency-free callback identity for Carbon-style script invocation.
- *
- * External JavaScript functions and callback-shaped host objects are adapted
- * once through {@link CjsScriptCallback.from}; runtime hot paths then call the
- * required methods directly.
- */
-class CjsScriptCallback {
-  /**
-   * Adapts one external callback value to the nominal runtime contract.
-   *
-   * @param {CjsScriptCallback|Function|object|null|undefined} value - Callback boundary value.
-   * @returns {CjsScriptCallback|null} A nominal callback or null.
-   */
-  static from(value) {
-    if (value === null || value === undefined) return null;
-    if (value instanceof CjsScriptCallback) return value;
-    if (typeof value === "function") return new CjsFunctionScriptCallback(value);
-    if (typeof value !== "object" || typeof value.Call !== "function" || typeof value.CallVoid !== "function") {
-      throw new TypeError("A script callback must be a function, CjsScriptCallback, or object with Call and CallVoid methods.");
-    }
-    return new CjsExternalScriptCallback(value);
-  }
-
-  /**
-   * Invokes a callback whose return value is significant.
-   *
-   * @param {...*} _args - Callback arguments.
-   * @returns {*} Callback result.
-   */
-  Call(..._args) {
-    throw new Error("CjsScriptCallback.Call must be overridden by a concrete script callback.");
-  }
-
-  /**
-   * Invokes a notification callback and discards its result.
-   *
-   * @param {...*} _args - Callback arguments.
-   * @returns {void}
-   */
-  CallVoid(..._args) {
-    throw new Error("CjsScriptCallback.CallVoid must be overridden by a concrete script callback.");
-  }
-}
-
-/** Adapts one ordinary JavaScript function to the nominal callback contract. */
-class CjsFunctionScriptCallback extends CjsScriptCallback {
-  #callback;
-
-  /** Stores one validated JavaScript function. */
-  constructor(callback) {
-    super();
-    this.#callback = callback;
-  }
-
-  /** Invokes the function and returns its result. */
-  Call(...args) {
-    return this.#callback(...args);
-  }
-
-  /** Invokes the function and discards its result. */
-  CallVoid(...args) {
-    this.#callback(...args);
-  }
-}
-
-/** Adapts one externally supplied callback object after boundary validation. */
-class CjsExternalScriptCallback extends CjsScriptCallback {
-  #callback;
-
-  /** Stores one validated external callback object. */
-  constructor(callback) {
-    super();
-    this.#callback = callback;
-  }
-
-  /** Directly invokes the external return-bearing method. */
-  Call(...args) {
-    return this.#callback.Call(...args);
-  }
-
-  /** Directly invokes the external notification method. */
-  CallVoid(...args) {
-    this.#callback.CallVoid(...args);
-  }
-}
-CjsSchema.decorateMethod(CjsScriptCallback, "Call", impl.abstract);
-CjsSchema.decorateMethod(CjsScriptCallback, "CallVoid", impl.abstract);
-
-export { CjsScriptCallback };
-//# sourceMappingURL=CjsScriptCallback.js.map

package/dist/global/contracts/CjsScriptCallback.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CjsScriptCallback.js","sources":["../../../../src/global/contracts/CjsScriptCallback.js"],"sourcesContent":["import { CjsSchema, impl } from \"../schema/index.js\";\n\n/**\n * Dependency-free callback identity for Carbon-style script invocation.\n *\n * External JavaScript functions and callback-shaped host objects are adapted\n * once through {@link CjsScriptCallback.from}; runtime hot paths then call the\n * required methods directly.\n */\nexport class CjsScriptCallback\n{\n\n    /**\n     * Adapts one external callback value to the nominal runtime contract.\n     *\n     * @param {CjsScriptCallback|Function|object|null|undefined} value - Callback boundary value.\n     * @returns {CjsScriptCallback|null} A nominal callback or null.\n     */\n    static from(value)\n    {\n        if (value === null || value === undefined) return null;\n        if (value instanceof CjsScriptCallback) return value;\n        if (typeof value === \"function\") return new CjsFunctionScriptCallback(value);\n        if (typeof value !== \"object\" || typeof value.Call !== \"function\" || typeof value.CallVoid !== \"function\")\n        {\n            throw new TypeError(\"A script callback must be a function, CjsScriptCallback, or object with Call and CallVoid methods.\");\n        }\n        return new CjsExternalScriptCallback(value);\n    }\n\n    /**\n     * Invokes a callback whose return value is significant.\n     *\n     * @param {...*} _args - Callback arguments.\n     * @returns {*} Callback result.\n     */\n    Call(..._args)\n    {\n        throw new Error(\n            \"CjsScriptCallback.Call must be overridden by a concrete script callback.\"\n        );\n    }\n\n    /**\n     * Invokes a notification callback and discards its result.\n     *\n     * @param {...*} _args - Callback arguments.\n     * @returns {void}\n     */\n    CallVoid(..._args)\n    {\n        throw new Error(\n            \"CjsScriptCallback.CallVoid must be overridden by a concrete script callback.\"\n        );\n    }\n\n}\n\n/** Adapts one ordinary JavaScript function to the nominal callback contract. */\nclass CjsFunctionScriptCallback extends CjsScriptCallback\n{\n\n    #callback;\n\n    /** Stores one validated JavaScript function. */\n    constructor(callback)\n    {\n        super();\n        this.#callback = callback;\n    }\n\n    /** Invokes the function and returns its result. */\n    Call(...args)\n    {\n        return this.#callback(...args);\n    }\n\n    /** Invokes the function and discards its result. */\n    CallVoid(...args)\n    {\n        this.#callback(...args);\n    }\n\n}\n\n/** Adapts one externally supplied callback object after boundary validation. */\nclass CjsExternalScriptCallback extends CjsScriptCallback\n{\n\n    #callback;\n\n    /** Stores one validated external callback object. */\n    constructor(callback)\n    {\n        super();\n        this.#callback = callback;\n    }\n\n    /** Directly invokes the external return-bearing method. */\n    Call(...args)\n    {\n        return this.#callback.Call(...args);\n    }\n\n    /** Directly invokes the external notification method. */\n    CallVoid(...args)\n    {\n        this.#callback.CallVoid(...args);\n    }\n\n}\n\nCjsSchema.decorateMethod(CjsScriptCallback, \"Call\", impl.abstract);\nCjsSchema.decorateMethod(CjsScriptCallback, \"CallVoid\", impl.abstract);\n"],"names":["CjsScriptCallback","from","value","undefined","CjsFunctionScriptCallback","Call","CallVoid","TypeError","CjsExternalScriptCallback","_args","Error","constructor","callback","args","CjsSchema","decorateMethod","impl","abstract"],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,iBAAiB,CAC9B;AAEI;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOC,IAAIA,CAACC,KAAK,EACjB;IACI,IAAIA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS,EAAE,OAAO,IAAI;AACtD,IAAA,IAAID,KAAK,YAAYF,iBAAiB,EAAE,OAAOE,KAAK;IACpD,IAAI,OAAOA,KAAK,KAAK,UAAU,EAAE,OAAO,IAAIE,yBAAyB,CAACF,KAAK,CAAC;AAC5E,IAAA,IAAI,OAAOA,KAAK,KAAK,QAAQ,IAAI,OAAOA,KAAK,CAACG,IAAI,KAAK,UAAU,IAAI,OAAOH,KAAK,CAACI,QAAQ,KAAK,UAAU,EACzG;AACI,MAAA,MAAM,IAAIC,SAAS,CAAC,oGAAoG,CAAC;AAC7H,IAAA;AACA,IAAA,OAAO,IAAIC,yBAAyB,CAACN,KAAK,CAAC;AAC/C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIG,IAAIA,CAAC,GAAGI,KAAK,EACb;AACI,IAAA,MAAM,IAAIC,KAAK,CACX,0EACJ,CAAC;AACL,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIJ,QAAQA,CAAC,GAAGG,KAAK,EACjB;AACI,IAAA,MAAM,IAAIC,KAAK,CACX,8EACJ,CAAC;AACL,EAAA;AAEJ;;AAEA;AACA,MAAMN,yBAAyB,SAASJ,iBAAiB,CACzD;AAEI,EAAA,SAAS;;AAET;EACAW,WAAWA,CAACC,QAAQ,EACpB;AACI,IAAA,KAAK,EAAE;AACP,IAAA,IAAI,CAAC,SAAS,GAAGA,QAAQ;AAC7B,EAAA;;AAEA;EACAP,IAAIA,CAAC,GAAGQ,IAAI,EACZ;AACI,IAAA,OAAO,IAAI,CAAC,SAAS,CAAC,GAAGA,IAAI,CAAC;AAClC,EAAA;;AAEA;EACAP,QAAQA,CAAC,GAAGO,IAAI,EAChB;AACI,IAAA,IAAI,CAAC,SAAS,CAAC,GAAGA,IAAI,CAAC;AAC3B,EAAA;AAEJ;;AAEA;AACA,MAAML,yBAAyB,SAASR,iBAAiB,CACzD;AAEI,EAAA,SAAS;;AAET;EACAW,WAAWA,CAACC,QAAQ,EACpB;AACI,IAAA,KAAK,EAAE;AACP,IAAA,IAAI,CAAC,SAAS,GAAGA,QAAQ;AAC7B,EAAA;;AAEA;EACAP,IAAIA,CAAC,GAAGQ,IAAI,EACZ;IACI,OAAO,IAAI,CAAC,SAAS,CAACR,IAAI,CAAC,GAAGQ,IAAI,CAAC;AACvC,EAAA;;AAEA;EACAP,QAAQA,CAAC,GAAGO,IAAI,EAChB;IACI,IAAI,CAAC,SAAS,CAACP,QAAQ,CAAC,GAAGO,IAAI,CAAC;AACpC,EAAA;AAEJ;AAEAC,SAAS,CAACC,cAAc,CAACf,iBAAiB,EAAE,MAAM,EAAEgB,IAAI,CAACC,QAAQ,CAAC;AAClEH,SAAS,CAACC,cAAc,CAACf,iBAAiB,EAAE,UAAU,EAAEgB,IAAI,CAACC,QAAQ,CAAC;;;;"}

package/dist/trinity/controllers/ITr2Controller.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ITr2Controller.js","sources":["../../../../src/trinity/controllers/ITr2Controller.js"],"sourcesContent":["// Source: trinity/trinity/Controllers/ITr2Controller.h\n//\n// The contract a controller answers to, and the reason 235 call sites in this\n// runtime were written as `controller?.Update?.()`.\n//\n// WHAT WAS WRONG. Our schema already names this interface - EveStretch3 and its\n// neighbours declare `@type.list(\"ITr2Controller\") controllers = []` - but no\n// class implemented it, so nothing guaranteed that a thing in one of those\n// lists could be told to Update, Start or Stop. Every caller hedged instead,\n// and a hedge cannot tell \"this controller does not care about Update\" from\n// \"this object is not a controller at all\". Carbon never has that ambiguity,\n// because the base answers the first case and the type system answers the\n// second.\n//\n// THE KEY DETAIL, AND WHY THE HEDGES CAN SIMPLY GO. Only `IsLinked` is pure\n// virtual. `Link`, `Unlink`, `Start`, `Stop`, `Update`, `SetVariable` and\n// `HandleEvent` all have EMPTY BODIES in Carbon's header. The optional chain\n// was emulating exactly that - a call that harmlessly does nothing when the\n// controller has no opinion - one call site at a time. Inheriting the empty\n// body gives the same behaviour in one place, and turns a genuinely absent\n// method back into the error it should be.\n//\n// TWO INTERFACES, ONE HEADER, as Carbon has them. A plain controller answers\n// the eight verbs below; `ITr2ActionController` adds what a controller driving\n// controller ACTIONS must also provide, all of it pure virtual there and\n// abstract here.\n//\n// `IRoot`, Carbon's base for both, is not ported: it is Blue's reference-counted\n// object root, which a garbage-collected runtime has no use for.\n\nimport { CjsSchema, impl } from \"#schema\";\nimport { UnlinkReason } from \"./enums.js\";\n\n\nconst ITR2_CONTROLLER = Symbol.for(\"carbonenginejs.contract.ITr2Controller\");\nconst ITR2_ACTION_CONTROLLER = Symbol.for(\"carbonenginejs.contract.ITr2ActionController\");\n\n\n/** Contract for an object that controls another between Start and Stop. */\nexport class ITr2Controller\n{\n  static [Symbol.hasInstance](value)\n  {\n    return value !== null && value !== undefined && value[ITR2_CONTROLLER] === true;\n  }\n\n  /**\n   * Attaches this controller to its owner.\n   *\n   * The owner guarantees Link runs before any other method on the controller,\n   * which is why the rest may assume an owner without checking for one.\n   *\n   * @param {object} _owner The object being controlled.\n   */\n  Link(_owner)\n  {\n  }\n\n  /**\n   * Detaches this controller, dropping every reference to the owner.\n   *\n   * @param {number} [_reason] An `UnlinkReason`; DELETING means the owner is going away.\n   */\n  Unlink(_reason = UnlinkReason.UNLINKING)\n  {\n  }\n\n  /**\n   * Whether this controller is attached to an owner.\n   *\n   * THE ONE METHOD CARBON MAKES PURE VIRTUAL. There is no sensible default:\n   * answering false would let an owner silently skip a linked controller, and\n   * answering true would let it drive an unlinked one.\n   *\n   * @returns {boolean} Whether Link has run without a matching Unlink.\n   */\n  IsLinked()\n  {\n    throw new Error(\"ITr2Controller.IsLinked must be implemented by a controller.\");\n  }\n\n  /** Begins controlling the owner. */\n  Start()\n  {\n  }\n\n  /** Stops controlling the owner. */\n  Stop()\n  {\n  }\n\n  /**\n   * Runs one frame's control, between Start and Stop.\n   *\n   * @param {number} _normalizedUpdateFrequency Carbon's normalised frame delta.\n   */\n  Update(_normalizedUpdateFrequency)\n  {\n  }\n\n  /**\n   * Sets one named controller variable.\n   *\n   * @param {string} _name The variable's name.\n   * @param {number} _value Its new value.\n   */\n  SetVariable(_name, _value)\n  {\n  }\n\n  /**\n   * Handles one instantaneous named event.\n   *\n   * @param {string} _eventName The event's name.\n   */\n  HandleEvent(_eventName)\n  {\n  }\n}\n\n\n/** Contract for a controller that also drives controller actions. */\nexport class ITr2ActionController extends ITr2Controller\n{\n  static [Symbol.hasInstance](value)\n  {\n    return value !== null && value !== undefined && value[ITR2_ACTION_CONTROLLER] === true;\n  }\n\n  /**\n   * The object this controller was linked to.\n   *\n   * @returns {object} The owner.\n   */\n  GetOwner()\n  {\n    throw new Error(\"ITr2ActionController.GetOwner must be implemented by an action controller.\");\n  }\n\n  /**\n   * Delivers a named callback to the controller.\n   *\n   * @param {string} _callbackName The callback's name.\n   */\n  Callback(_callbackName)\n  {\n    throw new Error(\"ITr2ActionController.Callback must be implemented by an action controller.\");\n  }\n\n  /**\n   * Registers an object to be updated whenever this controller updates.\n   *\n   * @param {object} _updateable The object to update.\n   */\n  RegisterUpdateable(_updateable)\n  {\n    throw new Error(\"ITr2ActionController.RegisterUpdateable must be implemented by an action controller.\");\n  }\n\n  /**\n   * Stops updating a previously registered object.\n   *\n   * @param {object} _updateable The object to stop updating.\n   */\n  UnRegisterUpdateable(_updateable)\n  {\n    throw new Error(\"ITr2ActionController.UnRegisterUpdateable must be implemented by an action controller.\");\n  }\n\n  /**\n   * The named root objects a dynamic binding path may start from.\n   *\n   * @returns {Array} Name and root pairs.\n   */\n  GetBindingPathRoots()\n  {\n    throw new Error(\"ITr2ActionController.GetBindingPathRoots must be implemented by an action controller.\");\n  }\n\n  /**\n   * One float variable by name.\n   *\n   * Carbon returns an optional, so a missing name is ABSENT rather than zero -\n   * a distinction an expression needs, since zero is a legitimate value.\n   *\n   * @param {string} _name The variable's name.\n   * @returns {number|null} Its value, or null when there is no such variable.\n   */\n  GetFloatVariableByName(_name)\n  {\n    throw new Error(\"ITr2ActionController.GetFloatVariableByName must be implemented by an action controller.\");\n  }\n\n  /**\n   * Adds the functions and variables this controller offers to expressions.\n   *\n   * @param {Array} _out Term info collected from every contributor.\n   */\n  GetExpressionTermInfo(_out)\n  {\n    throw new Error(\"ITr2ActionController.GetExpressionTermInfo must be implemented by an action controller.\");\n  }\n\n  /**\n   * The layout of this controller's variable buffer.\n   *\n   * @returns {Array} The variable view.\n   */\n  GetVariableView()\n  {\n    throw new Error(\"ITr2ActionController.GetVariableView must be implemented by an action controller.\");\n  }\n\n  /**\n   * The buffer the variable view describes.\n   *\n   * @returns {object} The variable buffer.\n   */\n  GetVariableBuffer()\n  {\n    throw new Error(\"ITr2ActionController.GetVariableBuffer must be implemented by an action controller.\");\n  }\n\n  /**\n   * Grows the scratch arena expressions evaluate into.\n   *\n   * @param {number} _size Bytes required.\n   */\n  EnsureTempArenaSize(_size)\n  {\n    throw new Error(\"ITr2ActionController.EnsureTempArenaSize must be implemented by an action controller.\");\n  }\n\n  /**\n   * The scratch arena expressions evaluate into.\n   *\n   * @returns {object} The arena.\n   */\n  GetTempArena()\n  {\n    throw new Error(\"ITr2ActionController.GetTempArena must be implemented by an action controller.\");\n  }\n}\n\n\nconst CONTROLLER_NOOPS = [ \"Link\", \"Unlink\", \"Start\", \"Stop\", \"Update\", \"SetVariable\", \"HandleEvent\" ];\nconst ACTION_ABSTRACTS = [\n  \"GetOwner\", \"Callback\", \"RegisterUpdateable\", \"UnRegisterUpdateable\", \"GetBindingPathRoots\",\n  \"GetFloatVariableByName\", \"GetExpressionTermInfo\", \"GetVariableView\", \"GetVariableBuffer\",\n  \"EnsureTempArenaSize\", \"GetTempArena\"\n];\n\n/**\n * Marks a class as carrying a contract, and records each method's provenance.\n *\n * Shared by every ported Carbon interface in this folder - `ITr2Controller`,\n * `ITr2ControllerAction`, `ITr2StateMachineStateFinalizer` - so the brand and\n * the noop/abstract bookkeeping are written once.\n *\n * @param {Function} target The contract or adopted class.\n * @param {symbol} symbol The contract's brand symbol.\n * @param {string[]} noops Methods Carbon gives an empty body.\n * @param {string[]} abstracts Methods Carbon makes pure virtual.\n */\nexport function Brand(target, symbol, noops, abstracts)\n{\n  Object.defineProperty(target.prototype, symbol, { value: true });\n\n  for (const name of noops) CjsSchema.decorateMethod(target, name, impl.noop);\n  for (const name of abstracts) CjsSchema.decorateMethod(target, name, impl.abstract);\n}\n\nBrand(ITr2Controller, ITR2_CONTROLLER, CONTROLLER_NOOPS, [ \"IsLinked\" ]);\nBrand(ITr2ActionController, ITR2_ACTION_CONTROLLER, [], ACTION_ABSTRACTS);\nObject.defineProperty(ITr2ActionController.prototype, ITR2_CONTROLLER, { value: true });\nCjsSchema.define(ITr2Controller, { className: \"ITr2Controller\" });\nCjsSchema.define(ITr2ActionController, { className: \"ITr2ActionController\" });\n\n\n/**\n * Adds the ITr2Controller contract without replacing an existing model base.\n *\n * A controller class already extends something - CjsModel, EveThrottleable -\n * so the contract arrives as a mixin rather than as a root. The subclass\n * overrides what it cares about and inherits Carbon's empty body for the rest,\n * which is the whole point: the caller no longer has to ask.\n *\n * @param {Function} Base The class to extend.\n * @returns {Function} A subclass carrying the contract.\n */\nexport function withITr2Controller(Base)\n{\n  const Controller = Adopt(Base, ITr2Controller, [ ...CONTROLLER_NOOPS, \"IsLinked\" ]);\n\n  Brand(Controller, ITR2_CONTROLLER, CONTROLLER_NOOPS, [ \"IsLinked\" ]);\n\n  return Controller;\n}\n\n\n/**\n * Adds the ITr2ActionController contract, and ITr2Controller with it.\n *\n * @param {Function} Base The class to extend.\n * @returns {Function} A subclass carrying both contracts.\n */\nexport function withITr2ActionController(Base)\n{\n  const Controller = Adopt(\n    Adopt(Base, ITr2Controller, [ ...CONTROLLER_NOOPS, \"IsLinked\" ]),\n    ITr2ActionController,\n    ACTION_ABSTRACTS\n  );\n\n  Brand(Controller, ITR2_CONTROLLER, CONTROLLER_NOOPS, [ \"IsLinked\" ]);\n  Brand(Controller, ITR2_ACTION_CONTROLLER, [], ACTION_ABSTRACTS);\n\n  return Controller;\n}\n\n\n/**\n * Subclasses `Base`, filling in only the contract methods it does not already\n * have.\n *\n * A CLASS THAT IMPLEMENTS A METHOD KEEPS ITS OWN. That is the whole point of\n * the empty bodies: the contract supplies a default where the implementor has\n * no opinion, and stays out of the way where it does.\n *\n * @param {Function} Base The class to extend.\n * @param {Function} Contract The contract whose methods fill the gaps.\n * @param {string[]} names The contract's method names.\n * @returns {Function} The subclass.\n */\nexport function Adopt(Base, Contract, names)\n{\n  const Adopted = class extends Base\n  {\n  };\n\n  for (const name of names)\n  {\n    if (name in Adopted.prototype) continue;\n\n    Object.defineProperty(Adopted.prototype, name, {\n      value: Contract.prototype[name],\n      writable: true,\n      configurable: true\n    });\n  }\n\n  return Adopted;\n}\n"],"names":["ITR2_CONTROLLER","Symbol","for","ITR2_ACTION_CONTROLLER","ITr2Controller","hasInstance","value","undefined","Link","_owner","Unlink","_reason","UnlinkReason","UNLINKING","IsLinked","Error","Start","Stop","Update","_normalizedUpdateFrequency","SetVariable","_name","_value","HandleEvent","_eventName","ITr2ActionController","GetOwner","Callback","_callbackName","RegisterUpdateable","_updateable","UnRegisterUpdateable","GetBindingPathRoots","GetFloatVariableByName","GetExpressionTermInfo","_out","GetVariableView","GetVariableBuffer","EnsureTempArenaSize","_size","GetTempArena","CONTROLLER_NOOPS","ACTION_ABSTRACTS","Brand","target","symbol","noops","abstracts","Object","defineProperty","prototype","name","CjsSchema","decorateMethod","impl","noop","abstract","define","className","withITr2Controller","Base","Controller","Adopt","withITr2ActionController","Contract","names","Adopted","writable","configurable"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAMA,MAAMA,eAAe,GAAGC,MAAM,CAACC,GAAG,CAAC,wCAAwC,CAAC;AAC5E,MAAMC,sBAAsB,GAAGF,MAAM,CAACC,GAAG,CAAC,8CAA8C,CAAC;;AAGzF;AACO,MAAME,cAAc,CAC3B;AACE,EAAA,QAAQH,MAAM,CAACI,WAAW,CAAA,CAAEC,KAAK,EACjC;AACE,IAAA,OAAOA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS,IAAID,KAAK,CAACN,eAAe,CAAC,KAAK,IAAI;AACjF,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;EACEQ,IAAIA,CAACC,MAAM,EACX,CACA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,MAAMA,CAACC,OAAO,GAAGC,YAAY,CAACC,SAAS,EACvC,CACA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,QAAQA,GACR;AACE,IAAA,MAAM,IAAIC,KAAK,CAAC,8DAA8D,CAAC;AACjF,EAAA;;AAEA;EACAC,KAAKA,GACL,CACA;;AAEA;EACAC,IAAIA,GACJ,CACA;;AAEA;AACF;AACA;AACA;AACA;EACEC,MAAMA,CAACC,0BAA0B,EACjC,CACA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,CAACC,KAAK,EAAEC,MAAM,EACzB,CACA;;AAEA;AACF;AACA;AACA;AACA;EACEC,WAAWA,CAACC,UAAU,EACtB,CACA;AACF;;AAGA;AACO,MAAMC,oBAAoB,SAASrB,cAAc,CACxD;AACE,EAAA,QAAQH,MAAM,CAACI,WAAW,CAAA,CAAEC,KAAK,EACjC;AACE,IAAA,OAAOA,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAKC,SAAS,IAAID,KAAK,CAACH,sBAAsB,CAAC,KAAK,IAAI;AACxF,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEuB,EAAAA,QAAQA,GACR;AACE,IAAA,MAAM,IAAIX,KAAK,CAAC,4EAA4E,CAAC;AAC/F,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEY,QAAQA,CAACC,aAAa,EACtB;AACE,IAAA,MAAM,IAAIb,KAAK,CAAC,4EAA4E,CAAC;AAC/F,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEc,kBAAkBA,CAACC,WAAW,EAC9B;AACE,IAAA,MAAM,IAAIf,KAAK,CAAC,sFAAsF,CAAC;AACzG,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEgB,oBAAoBA,CAACD,WAAW,EAChC;AACE,IAAA,MAAM,IAAIf,KAAK,CAAC,wFAAwF,CAAC;AAC3G,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEiB,EAAAA,mBAAmBA,GACnB;AACE,IAAA,MAAM,IAAIjB,KAAK,CAAC,uFAAuF,CAAC;AAC1G,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEkB,sBAAsBA,CAACZ,KAAK,EAC5B;AACE,IAAA,MAAM,IAAIN,KAAK,CAAC,0FAA0F,CAAC;AAC7G,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEmB,qBAAqBA,CAACC,IAAI,EAC1B;AACE,IAAA,MAAM,IAAIpB,KAAK,CAAC,yFAAyF,CAAC;AAC5G,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEqB,EAAAA,eAAeA,GACf;AACE,IAAA,MAAM,IAAIrB,KAAK,CAAC,mFAAmF,CAAC;AACtG,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEsB,EAAAA,iBAAiBA,GACjB;AACE,IAAA,MAAM,IAAItB,KAAK,CAAC,qFAAqF,CAAC;AACxG,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEuB,mBAAmBA,CAACC,KAAK,EACzB;AACE,IAAA,MAAM,IAAIxB,KAAK,CAAC,uFAAuF,CAAC;AAC1G,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEyB,EAAAA,YAAYA,GACZ;AACE,IAAA,MAAM,IAAIzB,KAAK,CAAC,gFAAgF,CAAC;AACnG,EAAA;AACF;AAGA,MAAM0B,gBAAgB,GAAG,CAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAE;AACtG,MAAMC,gBAAgB,GAAG,CACvB,UAAU,EAAE,UAAU,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,qBAAqB,EAC3F,wBAAwB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,mBAAmB,EACzF,qBAAqB,EAAE,cAAc,CACtC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,KAAKA,CAACC,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAEC,SAAS,EACtD;EACEC,MAAM,CAACC,cAAc,CAACL,MAAM,CAACM,SAAS,EAAEL,MAAM,EAAE;AAAEvC,IAAAA,KAAK,EAAE;AAAK,GAAC,CAAC;AAEhE,EAAA,KAAK,MAAM6C,IAAI,IAAIL,KAAK,EAAEM,SAAS,CAACC,cAAc,CAACT,MAAM,EAAEO,IAAI,EAAEG,IAAI,CAACC,IAAI,CAAC;AAC3E,EAAA,KAAK,MAAMJ,IAAI,IAAIJ,SAAS,EAAEK,SAAS,CAACC,cAAc,CAACT,MAAM,EAAEO,IAAI,EAAEG,IAAI,CAACE,QAAQ,CAAC;AACrF;AAEAb,KAAK,CAACvC,cAAc,EAAEJ,eAAe,EAAEyC,gBAAgB,EAAE,CAAE,UAAU,CAAE,CAAC;AACxEE,KAAK,CAAClB,oBAAoB,EAAEtB,sBAAsB,EAAE,EAAE,EAAEuC,gBAAgB,CAAC;AACzEM,MAAM,CAACC,cAAc,CAACxB,oBAAoB,CAACyB,SAAS,EAAElD,eAAe,EAAE;AAAEM,EAAAA,KAAK,EAAE;AAAK,CAAC,CAAC;AACvF8C,SAAS,CAACK,MAAM,CAACrD,cAAc,EAAE;AAAEsD,EAAAA,SAAS,EAAE;AAAiB,CAAC,CAAC;AACjEN,SAAS,CAACK,MAAM,CAAChC,oBAAoB,EAAE;AAAEiC,EAAAA,SAAS,EAAE;AAAuB,CAAC,CAAC;;AAG7E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,kBAAkBA,CAACC,IAAI,EACvC;AACE,EAAA,MAAMC,UAAU,GAAGC,KAAK,CAACF,IAAI,EAAExD,cAAc,EAAE,CAAE,GAAGqC,gBAAgB,EAAE,UAAU,CAAE,CAAC;EAEnFE,KAAK,CAACkB,UAAU,EAAE7D,eAAe,EAAEyC,gBAAgB,EAAE,CAAE,UAAU,CAAE,CAAC;AAEpE,EAAA,OAAOoB,UAAU;AACnB;;AAGA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,wBAAwBA,CAACH,IAAI,EAC7C;EACE,MAAMC,UAAU,GAAGC,KAAK,CACtBA,KAAK,CAACF,IAAI,EAAExD,cAAc,EAAE,CAAE,GAAGqC,gBAAgB,EAAE,UAAU,CAAE,CAAC,EAChEhB,oBAAoB,EACpBiB,gBACF,CAAC;EAEDC,KAAK,CAACkB,UAAU,EAAE7D,eAAe,EAAEyC,gBAAgB,EAAE,CAAE,UAAU,CAAE,CAAC;EACpEE,KAAK,CAACkB,UAAU,EAAE1D,sBAAsB,EAAE,EAAE,EAAEuC,gBAAgB,CAAC;AAE/D,EAAA,OAAOmB,UAAU;AACnB;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,KAAKA,CAACF,IAAI,EAAEI,QAAQ,EAAEC,KAAK,EAC3C;AACE,EAAA,MAAMC,OAAO,GAAG,cAAcN,IAAI,CAClC,EACC;AAED,EAAA,KAAK,MAAMT,IAAI,IAAIc,KAAK,EACxB;AACE,IAAA,IAAId,IAAI,IAAIe,OAAO,CAAChB,SAAS,EAAE;IAE/BF,MAAM,CAACC,cAAc,CAACiB,OAAO,CAAChB,SAAS,EAAEC,IAAI,EAAE;AAC7C7C,MAAAA,KAAK,EAAE0D,QAAQ,CAACd,SAAS,CAACC,IAAI,CAAC;AAC/BgB,MAAAA,QAAQ,EAAE,IAAI;AACdC,MAAAA,YAAY,EAAE;AAChB,KAAC,CAAC;AACJ,EAAA;AAEA,EAAA,OAAOF,OAAO;AAChB;;;;"}

package/dist/trinity/core/Tr2GpuResourcePool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Tr2GpuResourcePool.js","sources":["../../../../src/trinity/core/Tr2GpuResourcePool.js"],"sourcesContent":["// Source: trinity/trinity/Tr2GpuResourcePool.h\n// Source: trinity/trinity/Tr2GpuResourcePool.cpp\n//\n// Where a render pass gets a scratch texture or buffer, and how one is kept\n// alive only as long as something holds it.\n//\n// THIS IS THE CLASS FOUR INVENTED ONES WERE STANDING IN FOR. Carbon's\n// `Tr2ShadowMap::PrepareShadowRendering( gpuResourcePool, renderContext )` and\n// the whole `EveSpaceScene` volumetrics family take a pool and do their own\n// work. Ours had the methods but bounced them to an engine-supplied executor,\n// because there was no pool to hand them. So an interface was invented per\n// subsystem rather than porting the one class they all needed.\n//\n// TWO LIFETIMES, and the distinction is the whole design. A TEMP resource is\n// recycled as soon as nothing holds it and it has not been touched for a few\n// frames; a PERSISTENT one is initialized once and kept. Asking for a temp\n// texture with the same shape twice in a frame therefore gets the same texture\n// only if the first handle has been released - which is what makes a pass able\n// to say \"give me a working surface\" without owning one.\n//\n// THE HANDLE IS THE LIFETIME. Carbon's `GpuResourceHandle` counts locks on copy\n// and release, and a record with a live lock is never recycled. JavaScript has\n// no destructor, so `Release()` is explicit here - see the note on the class.\n//\n// NESTING IS CARBON'S: a pool may have an OUTER pool, and a lookup that misses\n// walks outward. That is how a scene-local pool shares the global one's\n// resources without owning them.\n\nimport { Tr2BitmapDimensions, Tr2BufferALStub, Tr2TextureALStub } from \"../../trinityal/index.js\";\n\n\nfunction fail(message)\n{\n  const error = new Error(`Tr2GpuResourcePool: ${message}`);\n  error.code = \"CJS_GPU_POOL_INVALID\";\n  throw error;\n}\n\n\n/**\n * A width and height, with Carbon's scaling and comparison.\n */\nexport class TextureSize2D\n{\n  /** Width in pixels. */\n  width = 0;\n\n  /** Height in pixels. */\n  height = 0;\n\n  /**\n   * @param {number|object} [widthOrDimensions] A width, or a `Tr2BitmapDimensions`.\n   * @param {number} [height] The height, when a width was given.\n   */\n  constructor(widthOrDimensions = 0, height = 0)\n  {\n    if (widthOrDimensions && typeof widthOrDimensions === \"object\")\n    {\n      this.width = widthOrDimensions.GetWidth();\n      this.height = widthOrDimensions.GetHeight();\n\n      return;\n    }\n\n    this.width = widthOrDimensions;\n    this.height = height;\n  }\n\n  /**\n   * Whether two sizes match.\n   *\n   * @param {TextureSize2D} other The size to compare with.\n   * @returns {boolean} True when they match.\n   */\n  Equals(other)\n  {\n    return !!other && this.width === other.width && this.height === other.height;\n  }\n\n  /**\n   * This size scaled, never below one pixel in either direction.\n   *\n   * Carbon clamps to one (`h:TextureSize2D::operator*`), because a half-size\n   * chain reaches zero before it reaches one and a zero-sized target is not a\n   * target.\n   *\n   * @param {number} scale The factor.\n   * @returns {TextureSize2D} The scaled size.\n   */\n  Scaled(scale)\n  {\n    return new TextureSize2D(\n      Math.max(1, Math.trunc(this.width * scale)),\n      Math.max(1, Math.trunc(this.height * scale))\n    );\n  }\n}\n\n\n/**\n * A borrowed pool resource.\n *\n * CARBON RELEASES ON DESTRUCTION AND JAVASCRIPT CANNOT. Its handle decrements a\n * lock count in its destructor, so a resource returns to the pool when the last\n * holder goes out of scope. There is no such moment here, so `Release` is\n * explicit and a handle that is never released pins its resource forever -\n * which is a leak, not a crash, and therefore worth being loud about. The pool\n * reports held resources so a caller can assert.\n *\n * THE VERB IS `Free`, AND THE POOL OWNS IT. Settled 2026-09-05 with\n * `cjs-carbon-verbs`, after two wrong turns worth recording:\n *\n * - `Destroy` is wrong. It means GONE NOW - the pure virtual on\n *   `Tr2BaseDeviceResourceAL` (`trinityal/Tr2DeviceResourceAL.h:30`), used on\n *   35 Carbon classes. A pooled resource is not destroyed; it goes back and is\n *   handed out again. `ClearUnusedResources` below is where `Destroy` is\n *   right, and where it is used.\n * - `Release` is not engine vocabulary. Bare `Release` appears ONLY in\n *   Carbon's mesh viewer and video player, as Vulkan idiom. Trinity uses only\n *   the qualified forms - `ReleaseLater`, `ReleaseDeviceResources`.\n *\n * `Free` is shared engine vocabulary on six Carbon classes - `FreeList`,\n * `Tr2VirtualAllocator`, `Tr2SuballocatedBuffer` and three descriptor-heap\n * allocators - and EVERY ONE IS AN ALLOCATOR OR POOL. The direction is theirs\n * too: `Tr2VirtualAllocator::Free( allocation )` and\n * `Tr2SuballocatedBuffer::Free( allocation& )` put the verb on the allocator,\n * not on the thing lent. So `pool.Free(handle)`, not `handle.Release()`.\n *\n * Carbon's handle has no named method at all - the work is in\n * `~GpuResourceHandle`. That absence is C++ not needing a name, and reading it\n * as a prohibition is how this briefly became a coined `ReleaseToPool`.\n */\nexport class GpuResourceHandle\n{\n  #record = null;\n\n  /**\n   * @param {object} [record] The pool record this handle locks.\n   */\n  constructor(record = null)\n  {\n    this.#record = record;\n\n    if (record) record.lockCount += 1;\n  }\n\n  /**\n   * The resource itself.\n   *\n   * @returns {object|null} The resource, or null once released.\n   */\n  Get()\n  {\n    return this.#record?.resource ?? null;\n  }\n\n  /** @returns {boolean} Whether this handle still holds a resource. */\n  IsValid()\n  {\n    return this.#record !== null;\n  }\n\n  /** @returns {string} The resource's debug name. */\n  GetName()\n  {\n    return this.#record?.name ?? \"\";\n  }\n\n  /**\n   * Drops this handle's claim. Called by `Tr2GpuResourcePool.Free`.\n   *\n   * Freeing twice is a caller error rather than a silent no-op: it means the\n   * lock count no longer describes who is holding what.\n   *\n   * @returns {boolean} Whether a claim was dropped.\n   */\n  Detach()\n  {\n    if (!this.#record) fail(\"a handle freed twice\");\n\n    this.#record.lockCount -= 1;\n    this.#record = null;\n\n    return true;\n  }\n}\n\n\n/**\n * Pooled scratch textures and buffers.\n */\nexport class Tr2GpuResourcePool\n{\n  /** m_outer - the pool a miss falls through to. */\n  #outer = null;\n\n  #tempTextures = [];\n\n  #persistentTextures = [];\n\n  #tempBuffers = [];\n\n  #persistentBuffers = [];\n\n  /** m_debugMode */\n  #debugMode = false;\n\n  /** The frame a lookup counts as \"now\". */\n  #frame = 0;\n\n  /**\n   * The backend resources are created against.\n   *\n   * Carbon's pool is a `Tr2DeviceResource` and reaches its device that way.\n   * This runtime has no process-wide device, so the context is handed in - the\n   * same arrangement `Tr2EffectStateManager` uses.\n   */\n  #renderContext = null;\n\n  /**\n   * @param {Tr2GpuResourcePool} [outer] A pool to fall through to on a miss.\n   */\n  constructor(outer = null)\n  {\n    this.#outer = outer;\n  }\n\n  /**\n   * Binds the backend resources are created against.\n   *\n   * @param {object} renderContext A render-context abstraction layer.\n   * @returns {Tr2GpuResourcePool} This pool, for chaining.\n   */\n  SetRenderContext(renderContext)\n  {\n    this.#renderContext = renderContext;\n\n    return this;\n  }\n\n  /**\n   * Advances the pool's idea of the current frame.\n   *\n   * @param {number} frame The frame number.\n   */\n  SetFrame(frame)\n  {\n    this.#frame = frame;\n  }\n\n  /**\n   * Borrows a scratch texture, creating one only if no free match exists.\n   *\n   * A FREE MATCH IS ONE NOBODY HOLDS. A record with a live lock is never handed\n   * out again, which is what lets two passes ask for \"a 512 square\" and get\n   * different surfaces when both are in flight, and the same one when they are\n   * not.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description `{ width, height, format, gpuUsage }`.\n   * @returns {GpuResourceHandle} The borrowed texture.\n   */\n  GetTempTexture(name, description)\n  {\n    return this.#Borrow(this.#tempTextures, name, description, () => this.#CreateTexture(description));\n  }\n\n  /**\n   * Borrows a persistent texture, initializing it the first time only.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description `{ width, height, format, gpuUsage }`.\n   * @param {Function} [initialize] Called once, with the new texture.\n   * @returns {GpuResourceHandle} The texture.\n   */\n  GetPersistentTexture(name, description, initialize = null)\n  {\n    const existing = this.#Find(this.#persistentTextures, name, description, false);\n\n    if (existing) return new GpuResourceHandle(existing);\n\n    const texture = this.#CreateTexture(description);\n\n    if (initialize) initialize(texture);\n\n    return new GpuResourceHandle(this.#Add(this.#persistentTextures, name, description, texture));\n  }\n\n  /**\n   * Borrows a scratch buffer.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BufferDescriptionAL`.\n   * @returns {GpuResourceHandle} The borrowed buffer.\n   */\n  GetTempBuffer(name, description)\n  {\n    return this.#Borrow(this.#tempBuffers, name, description, () => this.#CreateBuffer(description));\n  }\n\n  /**\n   * Borrows a persistent buffer, initializing it the first time only.\n   *\n   * @param {string} name A debug name.\n   * @param {object} description A `Tr2BufferDescriptionAL`.\n   * @param {Function} [initialize] Called once, with the new buffer.\n   * @returns {GpuResourceHandle} The buffer.\n   */\n  GetPersistentBuffer(name, description, initialize = null)\n  {\n    const existing = this.#Find(this.#persistentBuffers, name, description, false);\n\n    if (existing) return new GpuResourceHandle(existing);\n\n    const buffer = this.#CreateBuffer(description);\n\n    if (initialize) initialize(buffer);\n\n    return new GpuResourceHandle(this.#Add(this.#persistentBuffers, name, description, buffer));\n  }\n\n  /**\n   * Returns a borrowed resource, as Carbon's allocators do.\n   *\n   * @param {GpuResourceHandle} handle The handle to give back.\n   * @returns {boolean} Whether a claim was dropped.\n   */\n  Free(handle)\n  {\n    if (!handle) fail(\"Free needs a handle\");\n\n    return handle.Detach();\n  }\n\n  /**\n   * Drops temp resources nobody holds and nobody has touched recently.\n   *\n   * @param {number} [frameThreshold] How many frames of disuse to allow.\n   * @returns {number} How many resources were dropped.\n   */\n  ClearUnusedResources(frameThreshold = 3)\n  {\n    let dropped = 0;\n\n    for (const list of [ this.#tempTextures, this.#tempBuffers ])\n    {\n      for (let index = list.length - 1; index >= 0; index -= 1)\n      {\n        const record = list[index];\n\n        if (record.lockCount > 0) continue;\n        if (this.#frame - record.lastAccessFrame < frameThreshold) continue;\n\n        record.resource.Destroy();\n        list.splice(index, 1);\n        dropped += 1;\n      }\n    }\n\n    return dropped;\n  }\n\n  /** @param {boolean} enable Whether to keep debug detail. */\n  SetDebugMode(enable)\n  {\n    this.#debugMode = !!enable;\n  }\n\n  /** @returns {boolean} Whether debug mode is on. */\n  GetDebugMode()\n  {\n    return this.#debugMode;\n  }\n\n  /**\n   * Every temp texture the pool holds, for a caller that must assert.\n   *\n   * @returns {object[]} The textures.\n   */\n  DebugGetAllTempTextures()\n  {\n    return this.#tempTextures.map(record => record.resource);\n  }\n\n  /**\n   * How many resources are currently held by a handle.\n   *\n   * Not Carbon's - JavaScript has no destructor to release on, so a caller\n   * needs a way to prove it released what it borrowed.\n   *\n   * @returns {number} The count.\n   */\n  GetHeldCount()\n  {\n    return [ this.#tempTextures, this.#persistentTextures, this.#tempBuffers, this.#persistentBuffers ]\n      .reduce((total, list) => total + list.filter(record => record.lockCount > 0).length, 0);\n  }\n\n  /** Splits the pool's flat description into the AL's two arguments. */\n  #CreateTexture(description)\n  {\n    if (!this.#renderContext) fail(\"a pool creates against a render context; none is bound\");\n\n    const texture = new Tr2TextureALStub();\n    const { gpuUsage, cpuUsage, msaa, initialData, ...dimensions } = description;\n\n    texture.Create(\n      new Tr2BitmapDimensions(dimensions),\n      { gpuUsage, cpuUsage, msaa, initialData },\n      this.#renderContext\n    );\n\n    return texture;\n  }\n\n  #CreateBuffer(description)\n  {\n    if (!this.#renderContext) fail(\"a pool creates against a render context; none is bound\");\n\n    const buffer = new Tr2BufferALStub();\n\n    // THREE arguments. The context went into `initialData` here, leaving\n    // `renderContext` undefined, so the first line of Create that touched it\n    // threw a TypeError - which is why neither buffer accessor had ever run.\n    // The texture path two methods up passes all three correctly.\n    buffer.Create(description, null, this.#renderContext);\n\n    return buffer;\n  }\n\n  #Borrow(list, name, description, create)\n  {\n    const free = this.#Find(list, name, description, true);\n\n    if (free) return new GpuResourceHandle(free);\n\n    if (this.#outer) return this.#outer.#Borrow(list === this.#tempTextures\n      ? this.#outer.#tempTextures\n      : this.#outer.#tempBuffers, name, description, create);\n\n    return new GpuResourceHandle(this.#Add(list, name, description, create()));\n  }\n\n  #Find(list, name, description, freeOnly)\n  {\n    const match = list.find(record =>\n      record.name === name\n      && SameDescription(record.description, description)\n      && (!freeOnly || record.lockCount === 0));\n\n    if (match) match.lastAccessFrame = this.#frame;\n\n    return match ?? null;\n  }\n\n  #Add(list, name, description, resource)\n  {\n    const record = { resource, name, description, lockCount: 0, lastAccessFrame: this.#frame };\n\n    list.push(record);\n\n    return record;\n  }\n}\n\n\nfunction SameDescription(left, right)\n{\n  if (left === right) return true;\n  if (!left || !right) return false;\n\n  const keys = new Set([ ...Object.keys(left), ...Object.keys(right) ]);\n\n  for (const key of keys)\n  {\n    if (left[key] !== right[key]) return false;\n  }\n\n  return true;\n}\n\n\nlet globalPool = null;\n\n/**\n * Carbon's `GetGlobalGpuResourcePool`.\n *\n * @returns {Tr2GpuResourcePool} The process-wide pool.\n */\nexport function GetGlobalGpuResourcePool()\n{\n  globalPool ??= new Tr2GpuResourcePool();\n\n  return globalPool;\n}\n"],"names":["fail","message","error","Error","code","TextureSize2D","width","height","constructor","widthOrDimensions","GetWidth","GetHeight","Equals","other","Scaled","scale","Math","max","trunc","GpuResourceHandle","record","lockCount","Get","resource","IsValid","GetName","name","Detach","Tr2GpuResourcePool","outer","SetRenderContext","renderContext","SetFrame","frame","GetTempTexture","description","GetPersistentTexture","initialize","existing","texture","GetTempBuffer","GetPersistentBuffer","buffer","Free","handle","ClearUnusedResources","frameThreshold","dropped","list","index","length","lastAccessFrame","Destroy","splice","SetDebugMode","enable","GetDebugMode","DebugGetAllTempTextures","map","GetHeldCount","reduce","total","filter","#CreateTexture","Tr2TextureALStub","gpuUsage","cpuUsage","msaa","initialData","dimensions","Create","Tr2BitmapDimensions","#CreateBuffer","Tr2BufferALStub","#Borrow","create","free","#Find","freeOnly","match","find","SameDescription","#Add","push","left","right","keys","Set","Object","key","globalPool","GetGlobalGpuResourcePool"],"mappings":"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"}

package/dist/trinity/core/Tr2QuadRenderer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Tr2QuadRenderer.js","sources":["../../../../src/trinity/core/Tr2QuadRenderer.js"],"sourcesContent":["// Source: trinity/trinity/Tr2QuadRenderer.h\n//   trinity/trinity/Tr2QuadRenderer.cpp\r\n// Hand-maintained from Carbon source, promoted out of generated intake.\r\n// CPU half implemented 2026-07-23 (batch-plan P5 scene-global quad collector).\r\n// The generator had flattened the internal EffectRecord/PerThreadData members\r\n// onto the class; corrected to Carbon's nested shape. GPU realization (quad\r\n// vertex/index buffers, ring instance buffer upload, vertex-declaration\r\n// handles) is engine-owned and reads the merged CPU state emitted here.\r\nimport { carbon, impl, type } from \"#schema\";\r\nimport { CjsModel } from \"#model\";\r\nimport { Tr2RenderBatch } from \"./batch/Tr2RenderBatch.js\";\r\nimport { TriBatchType } from \"#consts/graphics\";\r\n\r\n/** One registered quad effect (Carbon Tr2QuadRenderer::EffectRecord). */\r\nexport class Tr2QuadRendererEffectRecord\r\n{\r\n\r\n  effect = null;\r\n\r\n  batchType = 0;\r\n\r\n  /** Size of one instance vertex in BYTES. */\r\n  instanceSize = 0;\r\n\r\n  /** Number of quads to render per instance. */\r\n  quadCount = 0;\r\n\r\n  /** Vertex definition (engine resolves the declaration handle from it). */\r\n  definition = null;\r\n\r\n  /** Byte offset of this record's instances in the merged buffer. */\r\n  bufferOffset = 0;\r\n\r\n  /** Number of instances merged this frame. */\r\n  count = 0;\r\n\r\n  /** Per-frame accumulation (Carbon's per-thread TLS collapses to one list). */\r\n  pending = [];\r\n\r\n  /** Bytes accumulated in pending. */\r\n  addedSize = 0;\r\n\r\n}\r\n\r\n/** Collects quads from every registered effect into one merged instance buffer and emits them as batches. */\r\n@type.define({ className: \"Tr2QuadRenderer\", family: \"trinityCore\" })\r\nexport class Tr2QuadRenderer extends CjsModel\r\n{\r\n\r\n  /** m_vertexBufferOffset (uint32_t) - ring offset; engine stamps the real one. */\r\n  @type.uint32\r\n  vertexBufferOffset = 0;\r\n\r\n  /** m_lastInstanceDataSize (uint32_t) */\r\n  @type.uint32\r\n  lastInstanceDataSize = 0;\r\n\r\n  /** m_bufferAlignment (uint32_t) - lcm of registered instance sizes. */\r\n  @type.uint32\r\n  bufferAlignment = 4;\r\n\r\n  /** m_bufferSize - bytes accumulated this frame across all records. */\r\n  @type.uint32\r\n  bufferSize = 0;\r\n\r\n  /** m_effects - EffectKey -> Tr2QuadRendererEffectRecord. */\r\n  #effects = new Map();\r\n\r\n  /** The merged terminal CPU instance bytes for the frame. */\r\n  #mergedData = null;\r\n\r\n  /** Largest quadCount among records with instances (RecreateQuadBuffers input). */\r\n  #maxQuadCount = 0;\r\n\r\n  /**\r\n   * Registers a quad effect once per key (Carbon Tr2QuadRenderer.cpp:30-53).\r\n   * instanceSize is in bytes; the buffer alignment grows to the lcm of all\r\n   * registered instance sizes.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  RegisterEffect(key, batchType, instanceSize, quadCount, definition, effect)\r\n  {\r\n    if (this.#effects.has(key))\r\n    {\r\n      return;\r\n    }\r\n    const record = new Tr2QuadRendererEffectRecord();\r\n    record.effect = effect ?? null;\r\n    record.batchType = batchType;\r\n    record.instanceSize = instanceSize >>> 0;\r\n    record.quadCount = quadCount >>> 0;\r\n    record.definition = definition ?? null;\r\n    this.#effects.set(key, record);\r\n    this.bufferAlignment = Tr2QuadRenderer.#Lcm(this.bufferAlignment, record.instanceSize || 1);\r\n  }\r\n\r\n  /**\r\n   * Drops a registered effect and the quads accumulated for it.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  UnregisterEffect(key)\r\n  {\r\n    this.#effects.delete(key);\r\n  }\r\n\r\n  /**\r\n   * Accumulates instance data for a registered effect (Carbon cpp:60-79).\r\n   * Accepts terminal byte views or legacy float32-compatible number arrays\r\n   * covering count * instanceSize bytes; unknown keys are ignored like Carbon.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"Single-threaded JS collapses the per-thread TLS buffers to one pending list while preserving Carbon's raw memcpy byte boundary.\")\r\n  AddQuads(effectKey, sprites, count = 1)\r\n  {\r\n    const record = this.#effects.get(effectKey);\r\n    if (!record)\r\n    {\r\n      return;\r\n    }\r\n\r\n    const size = count * record.instanceSize;\r\n    if (!size)\r\n    {\r\n      return;\r\n    }\r\n\r\n    const bytes = Tr2QuadRenderer.#CopyInstanceBytes(sprites, size);\r\n    record.pending.push(bytes);\r\n    record.addedSize += size;\r\n    this.bufferSize += size;\r\n  }\r\n\r\n  /**\r\n   * Concatenates every record's pending instances into one aligned CPU\r\n   * buffer, stamping per-record bufferOffset/count (Carbon cpp:81-115).\r\n   * Returns the largest quadCount among live records.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  MergeBuffers()\r\n  {\r\n    let padded = this.bufferSize;\r\n    for (const record of this.#effects.values())\r\n    {\r\n      padded += record.instanceSize;\r\n    }\r\n    const merged = new Uint8Array(padded);\r\n    let offset = 0;\r\n    let quadCount = 0;\r\n    for (const record of this.#effects.values())\r\n    {\r\n      offset = Tr2QuadRenderer.#Align(offset, record.instanceSize || 1);\r\n      record.bufferOffset = offset;\r\n      for (const chunk of record.pending)\r\n      {\r\n        merged.set(chunk, offset);\r\n        offset += chunk.byteLength;\r\n      }\r\n      record.pending.length = 0;\r\n      record.addedSize = 0;\r\n      record.count = record.instanceSize ? (offset - record.bufferOffset) / record.instanceSize : 0;\r\n      if (record.count)\r\n      {\r\n        quadCount = Math.max(quadCount, record.quadCount);\r\n      }\r\n    }\r\n    this.#mergedData = merged;\r\n    this.#maxQuadCount = quadCount;\r\n    return quadCount;\r\n  }\r\n\r\n  /**\r\n   * Frame-start CPU work (Carbon cpp:160-166): merge the accumulated\r\n   * instances. Buffer upload and quad-buffer creation are engine-owned;\r\n   * the engine reads GetMergedData()/GetMaxQuadCount() and stamps\r\n   * vertexBufferOffset with the ring allocation.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"UpdateInstanceBuffer/RecreateQuadBuffers/PrepareResources are GPU realization; the merged CPU state is exposed for the engine.\")\r\n  BeginRendering(_renderContext = null)\r\n  {\r\n    const quadCount = this.MergeBuffers();\r\n    this.lastInstanceDataSize = this.bufferSize;\r\n    return quadCount;\r\n  }\r\n\r\n  /** Frame-end reset (Carbon cpp:55-58). */\r\n  @carbon.method\r\n  @impl.implemented\r\n  DoneRendering(_renderContext = null)\r\n  {\r\n    this.bufferSize = 0;\r\n  }\r\n\r\n  /**\r\n   * Emits one instanced batch per live record of the requested type\r\n   * (Carbon cpp:188-207). The quad vertex/index buffers are shared engine\r\n   * resources, carried as descriptors on the batch; startInstanceLocation\r\n   * derives from the ring offset + record offset exactly like Carbon.\r\n   * Returns whether any batch was committed (JS convention).\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"Quad and ring buffers become deferred descriptors the engine realizes; Carbon binds live AL buffers here.\")\r\n  GetBatches(batchType, accumulator)\r\n  {\r\n    let committed = false;\r\n    for (const record of this.#effects.values())\r\n    {\r\n      if (!record.count || record.batchType !== batchType)\r\n      {\r\n        continue;\r\n      }\r\n      const batch = accumulator.Allocate(Tr2RenderBatch);\r\n      batch.SetMaterial(record.effect);\r\n      batch.SetGeometry(record.definition, Tr2QuadRenderer.QuadVertexSource, 4, Tr2QuadRenderer.QuadIndexSource, 2);\r\n      batch.SetStreamSource(1, {\r\n        quadInstanceData: this.#mergedData,\r\n        byteOffset: record.bufferOffset,\r\n        instanceSize: record.instanceSize\r\n      }, record.instanceSize);\r\n      batch.SetDrawIndexedInstanced(\r\n        6 * record.quadCount,\r\n        record.count,\r\n        0,\r\n        0,\r\n        record.instanceSize ? (this.vertexBufferOffset + record.bufferOffset) / record.instanceSize : 0\r\n      );\r\n      committed = accumulator.Commit(batch) || committed;\r\n    }\r\n    return committed;\r\n  }\r\n\r\n  /**\r\n   * The per-instance byte size an engine allocates for a registered effect.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetInstanceDataSize()\r\n  {\r\n    return this.lastInstanceDataSize;\r\n  }\r\n\r\n  /** The frame's merged CPU instance buffer for the engine uploader. */\r\n  GetMergedData()\r\n  {\r\n    return this.#mergedData;\r\n  }\r\n\r\n  /** The largest quadCount among live records (quad IB sizing). */\r\n  GetMaxQuadCount()\r\n  {\r\n    return this.#maxQuadCount;\r\n  }\r\n\r\n  /** The registered effect records (engine declaration resolution). */\r\n  GetEffectRecords()\r\n  {\r\n    return this.#effects;\r\n  }\r\n\r\n  /** Carbon Tr2QuadRenderer::Instance - the scene-global singleton. */\r\n  static Instance()\r\n  {\r\n    if (!Tr2QuadRenderer.#instance)\r\n    {\r\n      Tr2QuadRenderer.#instance = new Tr2QuadRenderer();\r\n    }\r\n    return Tr2QuadRenderer.#instance;\r\n  }\r\n\r\n  /**\r\n   * Rounds an offset up to the next multiple of an alignment.\r\n   */\r\n  static #Align(offset, alignment)\r\n  {\r\n    return Math.ceil(offset / alignment) * alignment;\r\n  }\r\n\r\n  /**\r\n   * The lowest common multiple of two sizes, used to align a shared instance stride.\r\n   */\r\n  static #Lcm(a, b)\r\n  {\r\n    const gcd = (x, y) => (y ? gcd(y, x % y) : x);\r\n    return (a * b) / gcd(a, b);\r\n  }\r\n\r\n  /** Copies one AddQuads input as the exact bytes Carbon memcpy would receive. */\r\n  static #CopyInstanceBytes(source, size)\r\n  {\r\n    let bytes;\r\n\r\n    if (ArrayBuffer.isView(source))\r\n    {\r\n      bytes = new Uint8Array(source.buffer, source.byteOffset, source.byteLength);\r\n    }\r\n    else if (source instanceof ArrayBuffer)\r\n    {\r\n      bytes = new Uint8Array(source);\r\n    }\r\n    else if (Array.isArray(source))\r\n    {\r\n      const floats = Float32Array.from(source);\r\n      bytes = new Uint8Array(floats.buffer, floats.byteOffset, floats.byteLength);\r\n    }\r\n    else\r\n    {\r\n      throw new TypeError(\"Tr2QuadRenderer.AddQuads requires terminal bytes or float32-compatible numeric data.\");\r\n    }\r\n\r\n    if (bytes.byteLength < size)\r\n    {\r\n      throw new RangeError(`Tr2QuadRenderer.AddQuads expected ${size} bytes, received ${bytes.byteLength}.`);\r\n    }\r\n\r\n    return bytes.slice(0, size);\r\n  }\r\n\r\n  static #instance = null;\r\n\r\n  /** Deferred descriptor for the engine-owned shared quad vertex buffer. */\r\n  static QuadVertexSource = Object.freeze({ quadRendererBuffer: \"quad-vertices\" });\r\n\r\n  /** Deferred descriptor for the engine-owned shared quad index buffer. */\r\n  static QuadIndexSource = Object.freeze({ quadRendererBuffer: \"quad-indices\" });\r\n\r\n  static TriBatchType = TriBatchType;\r\n\r\n}\r\n"],"names":["Tr2QuadRendererEffectRecord","effect","batchType","instanceSize","quadCount","definition","bufferOffset","count","pending","addedSize","_Tr2QuadRenderer","_identity","Tr2QuadRenderer","CjsModel","e","_init_vertexBufferOffset","_init_extra_vertexBufferOffset","_init_lastInstanceDataSize","_init_extra_lastInstanceDataSize","_init_bufferAlignment","_init_extra_bufferAlignment","_init_bufferSize","_init_extra_bufferSize","_initProto","c","_initClass","_applyDecs","type","define","className","family","uint32","carbon","method","impl","implemented","adapted","reason","vertexBufferOffset","lastInstanceDataSize","bufferAlignment","bufferSize","Map","RegisterEffect","key","has","record","set","UnregisterEffect","delete","AddQuads","effectKey","sprites","get","size","bytes","push","MergeBuffers","padded","values","merged","Uint8Array","offset","chunk","byteLength","length","Math","max","BeginRendering","_renderContext","DoneRendering","GetBatches","accumulator","committed","batch","Allocate","Tr2RenderBatch","SetMaterial","SetGeometry","QuadVertexSource","QuadIndexSource","SetStreamSource","quadInstanceData","byteOffset","SetDrawIndexedInstanced","Commit","GetInstanceDataSize","GetMergedData","GetMaxQuadCount","GetEffectRecords","Instance","#Align","alignment","ceil","#Lcm","a","b","gcd","x","y","#CopyInstanceBytes","source","ArrayBuffer","isView","buffer","Array","isArray","floats","Float32Array","from","TypeError","RangeError","slice","Object","freeze","quadRendererBuffer","TriBatchType","constructor"],"mappings":"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"}