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

package/dist/trinityal/stub/Tr2FenceALStub.js

@@ -1,4 +1,6 @@
-import { Tr2BaseDeviceResourceAL, Tr2ALMemoryType } from '../Tr2DeviceResourceAL.js';
+import { CjsSchema } from '#schema';
+import { Tr2ALMemoryType } from '../Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
+import { Tr2DeviceResourceAL } from '../Tr2DeviceResourceAL/Tr2DeviceResourceAL.js';
 import { ALResult } from '../ALResult.js';
 
 // Source: trinity/trinityal/stub/Tr2FenceALStub.cpp
@@ -21,7 +23,7 @@ import { ALResult } from '../ALResult.js';
 
 
 /** A fence the backend has accepted. */
-class Tr2FenceALStub extends Tr2BaseDeviceResourceAL {
+class Tr2FenceALStub extends Tr2DeviceResourceAL {
   /** m_isValid */
   _isValid = false;
 
@@ -121,5 +123,19 @@ class Tr2FenceALStub extends Tr2BaseDeviceResourceAL {
   }
 }
 
+// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in
+// Tr2BitmapDimensions.js: the layer is imported straight from source by its
+// tests and raw Node cannot parse decorator syntax.
+//
+// The donor is NAMED rather than left to be derived from this class's name.
+// Carbon calls every backend's class the same thing and carries the backend in
+// the FILE name, because only one backend compiles at a time; we ship them
+// together, so the backend moves onto the class name. That divergence is the
+// author's to declare, never a checker's to guess.
+CjsSchema.define(Tr2FenceALStub, {
+  className: "Tr2FenceALStub",
+  carbon: "Tr2FenceAL"
+});
+
 export { Tr2FenceALStub };
 //# sourceMappingURL=Tr2FenceALStub.js.map

package/dist/trinityal/stub/Tr2FenceALStub.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2FenceALStub.js","sources":["../../../../src/trinityal/stub/Tr2FenceALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2FenceALStub.cpp\r\n// Source: trinity/trinityal/stub/Tr2FenceALStub.h\r\n//\r\n// A GPU fence: one marker put into the command stream, and a way to ask whether\r\n// the GPU has passed it.\r\n//\r\n// THE STUB IS NOT A NO-OP, and the reason matters. It tracks whether a fence is\r\n// OUTSTANDING and answers `IsReached` with the negation of that. So a stub\r\n// device behaves like a GPU that finishes everything instantly, which is a real\r\n// and consistent answer rather than a shrug - and it makes the double-put and\r\n// wait-without-put errors catchable without hardware.\r\n//\r\n// WHAT THIS IS FOR HERE. `Tr2RingBuffer` already fences, but on FRAME NUMBERS -\r\n// rows recorded for a frame cannot be reused until the device reports that frame\r\n// finished. That is the coarse version of the same idea. A fence is the fine\r\n// one, and the two are not interchangeable: a frame number says \"everything up\r\n// to here is done\", a fence says \"this particular point is done\".\r\n\r\nimport { Tr2ALMemoryType, Tr2BaseDeviceResourceAL } from \"../Tr2DeviceResourceAL.js\";\r\nimport { ALResult } from \"../ALResult.js\";\r\n\r\n\r\n/** A fence the backend has accepted. */\r\nexport class Tr2FenceALStub extends Tr2BaseDeviceResourceAL\r\n{\r\n  /** m_isValid */\r\n  _isValid = false;\r\n\r\n  /** m_hasFence - whether a marker is outstanding. */\r\n  _hasFence = false;\r\n\r\n  /**\r\n   * Creates the fence.\r\n   *\r\n   * @param {object} renderContext The primary context to create against.\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Create(renderContext)\r\n  {\r\n    if (!renderContext?.IsValid()) return ALResult.E_INVALIDARG;\r\n\r\n    this._isValid = true;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Releases the fence and drops any outstanding marker. */\r\n  Destroy()\r\n  {\r\n    this._isValid = false;\r\n    this._hasFence = false;\r\n    super.Destroy();\r\n  }\r\n\r\n  /** @returns {boolean} Whether the fence was created. */\r\n  IsValid()\r\n  {\r\n    return this._isValid;\r\n  }\r\n\r\n  /**\r\n   * Puts a marker into the command stream.\r\n   *\r\n   * TWO MARKERS AT ONCE IS AN ERROR, not a replacement - Carbon returns\r\n   * `E_INVALIDCALL` (`cpp:PutFence`). A fence names one point; putting a second\r\n   * before waiting on the first means the caller has lost track of which point\r\n   * it is waiting for.\r\n   *\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  PutFence()\r\n  {\r\n    if (!this._isValid) return ALResult.E_FAIL;\r\n    if (this._hasFence) return ALResult.E_INVALIDCALL;\r\n\r\n    this._hasFence = true;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * Whether the GPU has passed the marker.\r\n   *\r\n   * A stub device finishes instantly, so this is true whenever no marker is\r\n   * outstanding.\r\n   *\r\n   * @returns {object} `{ result, isReached }`.\r\n   */\r\n  IsReached()\r\n  {\r\n    if (!this._isValid) return { result: ALResult.E_FAIL, isReached: false };\r\n\r\n    return { result: ALResult.S_OK, isReached: !this._hasFence };\r\n  }\r\n\r\n  /**\r\n   * Waits for the marker and clears it.\r\n   *\r\n   * WAITING WITHOUT A MARKER IS AN ERROR (`E_INVALIDCALL`), because there is\r\n   * nothing to wait for and a caller that thinks otherwise has mispaired its\r\n   * calls.\r\n   *\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Wait()\r\n  {\r\n    if (!this._isValid) return ALResult.E_FAIL;\r\n    if (!this._hasFence) return ALResult.E_INVALIDCALL;\r\n\r\n    this._hasFence = false;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** @returns {number} A `Tr2ALMemoryType`. */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\r\n  }\r\n\r\n\r\n  /**\r\n   * Names the fence for a debugger.\r\n   *\r\n   * @param {string} _name The name Carbon would attach; the stub discards it.\r\n   * @returns {number} An `ALResult` value; the stub keeps no name\r\n   *   (`Tr2FenceALStub.cpp:85-88`).\r\n   */\r\n  SetName(_name)\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n}\r\n"],"names":["Tr2FenceALStub","Tr2BaseDeviceResourceAL","_isValid","_hasFence","Create","renderContext","IsValid","ALResult","E_INVALIDARG","S_OK","Destroy","PutFence","E_FAIL","E_INVALIDCALL","IsReached","result","isReached","Wait","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","SetName","_name"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAMA;AACO,MAAMA,cAAc,SAASC,uBAAuB,CAC3D;AACE;AACAC,EAAAA,QAAQ,GAAG,KAAK;;AAEhB;AACAC,EAAAA,SAAS,GAAG,KAAK;;AAEjB;AACF;AACA;AACA;AACA;AACA;EACEC,MAAMA,CAACC,aAAa,EACpB;IACE,IAAI,CAACA,aAAa,EAAEC,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACC,YAAY;IAE3D,IAAI,CAACN,QAAQ,GAAG,IAAI;IAEpB,OAAOK,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACAC,EAAAA,OAAOA,GACP;IACE,IAAI,CAACR,QAAQ,GAAG,KAAK;IACrB,IAAI,CAACC,SAAS,GAAG,KAAK;IACtB,KAAK,CAACO,OAAO,EAAE;AACjB,EAAA;;AAEA;AACAJ,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACJ,QAAQ;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACES,EAAAA,QAAQA,GACR;IACE,IAAI,CAAC,IAAI,CAACT,QAAQ,EAAE,OAAOK,QAAQ,CAACK,MAAM;AAC1C,IAAA,IAAI,IAAI,CAACT,SAAS,EAAE,OAAOI,QAAQ,CAACM,aAAa;IAEjD,IAAI,CAACV,SAAS,GAAG,IAAI;IAErB,OAAOI,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEK,EAAAA,SAASA,GACT;AACE,IAAA,IAAI,CAAC,IAAI,CAACZ,QAAQ,EAAE,OAAO;MAAEa,MAAM,EAAER,QAAQ,CAACK,MAAM;AAAEI,MAAAA,SAAS,EAAE;KAAO;IAExE,OAAO;MAAED,MAAM,EAAER,QAAQ,CAACE,IAAI;MAAEO,SAAS,EAAE,CAAC,IAAI,CAACb;KAAW;AAC9D,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEc,EAAAA,IAAIA,GACJ;IACE,IAAI,CAAC,IAAI,CAACf,QAAQ,EAAE,OAAOK,QAAQ,CAACK,MAAM;IAC1C,IAAI,CAAC,IAAI,CAACT,SAAS,EAAE,OAAOI,QAAQ,CAACM,aAAa;IAElD,IAAI,CAACV,SAAS,GAAG,KAAK;IAEtB,OAAOI,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACAS,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,eAAe;AACxC,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,KAAK,EACb;IACE,OAAOf,QAAQ,CAACE,IAAI;AACtB,EAAA;AACF;;;;"}
+{"version":3,"file":"Tr2FenceALStub.js","sources":["../../../../src/trinityal/stub/Tr2FenceALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2FenceALStub.cpp\r\n// Source: trinity/trinityal/stub/Tr2FenceALStub.h\r\n//\r\n// A GPU fence: one marker put into the command stream, and a way to ask whether\r\n// the GPU has passed it.\r\n//\r\n// THE STUB IS NOT A NO-OP, and the reason matters. It tracks whether a fence is\r\n// OUTSTANDING and answers `IsReached` with the negation of that. So a stub\r\n// device behaves like a GPU that finishes everything instantly, which is a real\r\n// and consistent answer rather than a shrug - and it makes the double-put and\r\n// wait-without-put errors catchable without hardware.\r\n//\r\n// WHAT THIS IS FOR HERE. `Tr2RingBuffer` already fences, but on FRAME NUMBERS -\r\n// rows recorded for a frame cannot be reused until the device reports that frame\r\n// finished. That is the coarse version of the same idea. A fence is the fine\r\n// one, and the two are not interchangeable: a frame number says \"everything up\r\n// to here is done\", a fence says \"this particular point is done\".\r\n\r\nimport { CjsSchema } from \"#schema\";\r\nimport { Tr2ALMemoryType, Tr2DeviceResourceAL } from \"../Tr2DeviceResourceAL/index.js\";\r\nimport { ALResult } from \"../ALResult.js\";\r\n\r\n\r\n/** A fence the backend has accepted. */\r\nexport class Tr2FenceALStub extends Tr2DeviceResourceAL\r\n{\r\n  /** m_isValid */\r\n  _isValid = false;\r\n\r\n  /** m_hasFence - whether a marker is outstanding. */\r\n  _hasFence = false;\r\n\r\n  /**\r\n   * Creates the fence.\r\n   *\r\n   * @param {object} renderContext The primary context to create against.\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Create(renderContext)\r\n  {\r\n    if (!renderContext?.IsValid()) return ALResult.E_INVALIDARG;\r\n\r\n    this._isValid = true;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Releases the fence and drops any outstanding marker. */\r\n  Destroy()\r\n  {\r\n    this._isValid = false;\r\n    this._hasFence = false;\r\n    super.Destroy();\r\n  }\r\n\r\n  /** @returns {boolean} Whether the fence was created. */\r\n  IsValid()\r\n  {\r\n    return this._isValid;\r\n  }\r\n\r\n  /**\r\n   * Puts a marker into the command stream.\r\n   *\r\n   * TWO MARKERS AT ONCE IS AN ERROR, not a replacement - Carbon returns\r\n   * `E_INVALIDCALL` (`cpp:PutFence`). A fence names one point; putting a second\r\n   * before waiting on the first means the caller has lost track of which point\r\n   * it is waiting for.\r\n   *\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  PutFence()\r\n  {\r\n    if (!this._isValid) return ALResult.E_FAIL;\r\n    if (this._hasFence) return ALResult.E_INVALIDCALL;\r\n\r\n    this._hasFence = true;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * Whether the GPU has passed the marker.\r\n   *\r\n   * A stub device finishes instantly, so this is true whenever no marker is\r\n   * outstanding.\r\n   *\r\n   * @returns {object} `{ result, isReached }`.\r\n   */\r\n  IsReached()\r\n  {\r\n    if (!this._isValid) return { result: ALResult.E_FAIL, isReached: false };\r\n\r\n    return { result: ALResult.S_OK, isReached: !this._hasFence };\r\n  }\r\n\r\n  /**\r\n   * Waits for the marker and clears it.\r\n   *\r\n   * WAITING WITHOUT A MARKER IS AN ERROR (`E_INVALIDCALL`), because there is\r\n   * nothing to wait for and a caller that thinks otherwise has mispaired its\r\n   * calls.\r\n   *\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Wait()\r\n  {\r\n    if (!this._isValid) return ALResult.E_FAIL;\r\n    if (!this._hasFence) return ALResult.E_INVALIDCALL;\r\n\r\n    this._hasFence = false;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** @returns {number} A `Tr2ALMemoryType`. */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\r\n  }\r\n\r\n\r\n  /**\r\n   * Names the fence for a debugger.\r\n   *\r\n   * @param {string} _name The name Carbon would attach; the stub discards it.\r\n   * @returns {number} An `ALResult` value; the stub keeps no name\r\n   *   (`Tr2FenceALStub.cpp:85-88`).\r\n   */\r\n  SetName(_name)\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n}\r\n\r\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\r\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\r\n// tests and raw Node cannot parse decorator syntax.\r\n//\r\n// The donor is NAMED rather than left to be derived from this class's name.\r\n// Carbon calls every backend's class the same thing and carries the backend in\r\n// the FILE name, because only one backend compiles at a time; we ship them\r\n// together, so the backend moves onto the class name. That divergence is the\r\n// author's to declare, never a checker's to guess.\r\nCjsSchema.define(Tr2FenceALStub, { className: \"Tr2FenceALStub\", carbon: \"Tr2FenceAL\" });\r\n"],"names":["Tr2FenceALStub","Tr2DeviceResourceAL","_isValid","_hasFence","Create","renderContext","IsValid","ALResult","E_INVALIDARG","S_OK","Destroy","PutFence","E_FAIL","E_INVALIDCALL","IsReached","result","isReached","Wait","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","SetName","_name","CjsSchema","define","className","carbon"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAOA;AACO,MAAMA,cAAc,SAASC,mBAAmB,CACvD;AACE;AACAC,EAAAA,QAAQ,GAAG,KAAK;;AAEhB;AACAC,EAAAA,SAAS,GAAG,KAAK;;AAEjB;AACF;AACA;AACA;AACA;AACA;EACEC,MAAMA,CAACC,aAAa,EACpB;IACE,IAAI,CAACA,aAAa,EAAEC,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACC,YAAY;IAE3D,IAAI,CAACN,QAAQ,GAAG,IAAI;IAEpB,OAAOK,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACAC,EAAAA,OAAOA,GACP;IACE,IAAI,CAACR,QAAQ,GAAG,KAAK;IACrB,IAAI,CAACC,SAAS,GAAG,KAAK;IACtB,KAAK,CAACO,OAAO,EAAE;AACjB,EAAA;;AAEA;AACAJ,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACJ,QAAQ;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACES,EAAAA,QAAQA,GACR;IACE,IAAI,CAAC,IAAI,CAACT,QAAQ,EAAE,OAAOK,QAAQ,CAACK,MAAM;AAC1C,IAAA,IAAI,IAAI,CAACT,SAAS,EAAE,OAAOI,QAAQ,CAACM,aAAa;IAEjD,IAAI,CAACV,SAAS,GAAG,IAAI;IAErB,OAAOI,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEK,EAAAA,SAASA,GACT;AACE,IAAA,IAAI,CAAC,IAAI,CAACZ,QAAQ,EAAE,OAAO;MAAEa,MAAM,EAAER,QAAQ,CAACK,MAAM;AAAEI,MAAAA,SAAS,EAAE;KAAO;IAExE,OAAO;MAAED,MAAM,EAAER,QAAQ,CAACE,IAAI;MAAEO,SAAS,EAAE,CAAC,IAAI,CAACb;KAAW;AAC9D,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEc,EAAAA,IAAIA,GACJ;IACE,IAAI,CAAC,IAAI,CAACf,QAAQ,EAAE,OAAOK,QAAQ,CAACK,MAAM;IAC1C,IAAI,CAAC,IAAI,CAACT,SAAS,EAAE,OAAOI,QAAQ,CAACM,aAAa;IAElD,IAAI,CAACV,SAAS,GAAG,KAAK;IAEtB,OAAOI,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACAS,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,eAAe;AACxC,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,KAAK,EACb;IACE,OAAOf,QAAQ,CAACE,IAAI;AACtB,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAc,SAAS,CAACC,MAAM,CAACxB,cAAc,EAAE;AAAEyB,EAAAA,SAAS,EAAE,gBAAgB;AAAEC,EAAAA,MAAM,EAAE;AAAa,CAAC,CAAC;;;;"}

package/dist/trinityal/stub/Tr2GpuTimerALStub.js

@@ -0,0 +1,97 @@
+import { CjsSchema } from '#schema';
+import { Tr2ALMemoryType } from '../Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
+import { Tr2DeviceResourceAL } from '../Tr2DeviceResourceAL/Tr2DeviceResourceAL.js';
+import { ALResult } from '../ALResult.js';
+
+// Source: trinity/trinityal/stub/Tr2GpuTimerALStub.cpp
+
+/**
+ * Times a bracketed span of GPU work.
+ */
+class Tr2GpuTimerALStub extends Tr2DeviceResourceAL {
+  /** m_isValid */
+  _isValid = false;
+
+  /**
+   * Creates the timer, releasing any previous one first as Carbon does.
+   *
+   * @param {object} renderContext The primary context to create against.
+   * @returns {number} An `ALResult`.
+   */
+  Create(renderContext) {
+    this.Destroy();
+    if (!renderContext?.IsValid()) return ALResult.E_INVALIDARG;
+    this._isValid = true;
+    return ALResult.S_OK;
+  }
+
+  /** Releases the timer. */
+  Destroy() {
+    this._isValid = false;
+    super.Destroy();
+  }
+
+  /** @returns {boolean} Whether the timer was created. */
+  IsValid() {
+    return this._isValid;
+  }
+
+  /**
+   * Starts timing.
+   *
+   * @returns {boolean} True, as Carbon's stub returns.
+   */
+  Begin() {
+    return true;
+  }
+
+  /** Stops timing. */
+  End() {}
+
+  /**
+   * The measured time in seconds.
+   *
+   * A TINY POSITIVE NUMBER RATHER THAN ZERO, which is Carbon's `0.0001f`
+   * (`cpp:GetTime`), and negative one when there is no timer. Zero would divide
+   * badly in a caller computing a rate; the negative distinguishes "no timer"
+   * from "no time".
+   *
+   * @returns {number} Seconds, or -1 without a timer.
+   */
+  GetTime() {
+    return this._isValid ? 0.0001 : -1;
+  }
+
+  /** @returns {number} A `Tr2ALMemoryType`. */
+  GetMemoryClass() {
+    return Tr2ALMemoryType.AL_MEMORY_VIDEO;
+  }
+
+  /**
+   * Names the timer for a debugger.
+   *
+   * @param {string} _name The name Carbon would attach; the stub discards it.
+   * @returns {number} An `ALResult` value; the stub keeps no name
+   *   (`Tr2GpuTimerALStub.cpp:55-58`).
+   */
+  SetName(_name) {
+    return ALResult.S_OK;
+  }
+}
+
+// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in
+// Tr2BitmapDimensions.js: the layer is imported straight from source by its
+// tests and raw Node cannot parse decorator syntax.
+//
+// The donor is NAMED rather than left to be derived from this class's name.
+// Carbon calls every backend's class the same thing and carries the backend in
+// the FILE name, because only one backend compiles at a time; we ship them
+// together, so the backend moves onto the class name. That divergence is the
+// author's to declare, never a checker's to guess.
+CjsSchema.define(Tr2GpuTimerALStub, {
+  className: "Tr2GpuTimerALStub",
+  carbon: "Tr2GpuTimerAL"
+});
+
+export { Tr2GpuTimerALStub };
+//# sourceMappingURL=Tr2GpuTimerALStub.js.map

package/dist/trinityal/stub/Tr2GpuTimerALStub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2GpuTimerALStub.js","sources":["../../../../src/trinityal/stub/Tr2GpuTimerALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2GpuTimerALStub.cpp\r\nimport { CjsSchema } from \"#schema\";\r\nimport { Tr2ALMemoryType, Tr2DeviceResourceAL } from \"../Tr2DeviceResourceAL/index.js\";\r\nimport { ALResult } from \"../ALResult.js\";\r\n\r\n\r\n/**\r\n * Times a bracketed span of GPU work.\r\n */\r\nexport class Tr2GpuTimerALStub extends Tr2DeviceResourceAL\r\n{\r\n  /** m_isValid */\r\n  _isValid = false;\r\n\r\n  /**\r\n   * Creates the timer, releasing any previous one first as Carbon does.\r\n   *\r\n   * @param {object} renderContext The primary context to create against.\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Create(renderContext)\r\n  {\r\n    this.Destroy();\r\n\r\n    if (!renderContext?.IsValid()) return ALResult.E_INVALIDARG;\r\n\r\n    this._isValid = true;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Releases the timer. */\r\n  Destroy()\r\n  {\r\n    this._isValid = false;\r\n    super.Destroy();\r\n  }\r\n\r\n  /** @returns {boolean} Whether the timer was created. */\r\n  IsValid()\r\n  {\r\n    return this._isValid;\r\n  }\r\n\r\n  /**\r\n   * Starts timing.\r\n   *\r\n   * @returns {boolean} True, as Carbon's stub returns.\r\n   */\r\n  Begin()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  /** Stops timing. */\r\n  End()\r\n  {\r\n  }\r\n\r\n  /**\r\n   * The measured time in seconds.\r\n   *\r\n   * A TINY POSITIVE NUMBER RATHER THAN ZERO, which is Carbon's `0.0001f`\r\n   * (`cpp:GetTime`), and negative one when there is no timer. Zero would divide\r\n   * badly in a caller computing a rate; the negative distinguishes \"no timer\"\r\n   * from \"no time\".\r\n   *\r\n   * @returns {number} Seconds, or -1 without a timer.\r\n   */\r\n  GetTime()\r\n  {\r\n    return this._isValid ? 0.0001 : -1;\r\n  }\r\n\r\n  /** @returns {number} A `Tr2ALMemoryType`. */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\r\n  }\r\n\r\n\r\n  /**\r\n   * Names the timer for a debugger.\r\n   *\r\n   * @param {string} _name The name Carbon would attach; the stub discards it.\r\n   * @returns {number} An `ALResult` value; the stub keeps no name\r\n   *   (`Tr2GpuTimerALStub.cpp:55-58`).\r\n   */\r\n  SetName(_name)\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n}\r\n\r\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\r\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\r\n// tests and raw Node cannot parse decorator syntax.\r\n//\r\n// The donor is NAMED rather than left to be derived from this class's name.\r\n// Carbon calls every backend's class the same thing and carries the backend in\r\n// the FILE name, because only one backend compiles at a time; we ship them\r\n// together, so the backend moves onto the class name. That divergence is the\r\n// author's to declare, never a checker's to guess.\r\nCjsSchema.define(Tr2GpuTimerALStub, { className: \"Tr2GpuTimerALStub\", carbon: \"Tr2GpuTimerAL\" });\r\n"],"names":["Tr2GpuTimerALStub","Tr2DeviceResourceAL","_isValid","Create","renderContext","Destroy","IsValid","ALResult","E_INVALIDARG","S_OK","Begin","End","GetTime","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","SetName","_name","CjsSchema","define","className","carbon"],"mappings":";;;;;AAAA;;AAMA;AACA;AACA;AACO,MAAMA,iBAAiB,SAASC,mBAAmB,CAC1D;AACE;AACAC,EAAAA,QAAQ,GAAG,KAAK;;AAEhB;AACF;AACA;AACA;AACA;AACA;EACEC,MAAMA,CAACC,aAAa,EACpB;IACE,IAAI,CAACC,OAAO,EAAE;IAEd,IAAI,CAACD,aAAa,EAAEE,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACC,YAAY;IAE3D,IAAI,CAACN,QAAQ,GAAG,IAAI;IAEpB,OAAOK,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACAJ,EAAAA,OAAOA,GACP;IACE,IAAI,CAACH,QAAQ,GAAG,KAAK;IACrB,KAAK,CAACG,OAAO,EAAE;AACjB,EAAA;;AAEA;AACAC,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACJ,QAAQ;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEQ,EAAAA,KAAKA,GACL;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;EACAC,GAAGA,GACH,CACA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,OAAOA,GACP;AACE,IAAA,OAAO,IAAI,CAACV,QAAQ,GAAG,MAAM,GAAG,EAAE;AACpC,EAAA;;AAEA;AACAW,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,eAAe;AACxC,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,KAAK,EACb;IACE,OAAOV,QAAQ,CAACE,IAAI;AACtB,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAS,SAAS,CAACC,MAAM,CAACnB,iBAAiB,EAAE;AAAEoB,EAAAA,SAAS,EAAE,mBAAmB;AAAEC,EAAAA,MAAM,EAAE;AAAgB,CAAC,CAAC;;;;"}

package/dist/trinityal/stub/Tr2OcclusionQueryALStub.js

@@ -0,0 +1,124 @@
+import { CjsSchema } from '#schema';
+import { Tr2ALMemoryType } from '../Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
+import { Tr2DeviceResourceAL } from '../Tr2DeviceResourceAL/Tr2DeviceResourceAL.js';
+import { ALResult } from '../ALResult.js';
+
+// Source: trinity/trinityal/stub/Tr2OcclusionQueryALStub.cpp
+
+/** Carbon's `Tr2OcclusionQueryAL::WaitMode`. */
+const OcclusionWaitMode = Object.freeze({
+  /** Return whatever is available now. */
+  DO_NOT_WAIT: 0,
+  /** Block until the result is ready. */
+  WAIT: 1
+});
+
+/**
+ * Counts the pixels a bracketed draw passed.
+ */
+class Tr2OcclusionQueryALStub extends Tr2DeviceResourceAL {
+  /** m_isValid */
+  _isValid = false;
+
+  /** m_isRunning */
+  _isRunning = false;
+
+  /**
+   * Creates the query.
+   *
+   * @param {object} renderContext The context to create against.
+   * @returns {number} An `ALResult`.
+   */
+  Create(renderContext) {
+    if (!renderContext?.IsValid()) return ALResult.E_INVALIDARG;
+    this._isValid = true;
+    return ALResult.S_OK;
+  }
+
+  /** @returns {boolean} Whether the query was created. */
+  IsValid() {
+    return this._isValid;
+  }
+
+  /** Releases the query. */
+  Destroy() {
+    this._isValid = false;
+    super.Destroy();
+  }
+
+  /**
+   * Starts counting.
+   *
+   * @returns {number} An `ALResult`.
+   */
+  Begin() {
+    if (!this._isValid) return ALResult.E_INVALIDCALL;
+    this._isRunning = true;
+    return ALResult.S_OK;
+  }
+
+  /**
+   * Stops counting.
+   *
+   * ENDING A QUERY THAT NEVER BEGAN IS AN ERROR, which Carbon checks
+   * (`cpp:End`) and which is the mispairing this class exists to catch.
+   *
+   * @returns {number} An `ALResult`.
+   */
+  End() {
+    if (!this._isValid) return ALResult.E_INVALIDCALL;
+    if (!this._isRunning) return ALResult.E_INVALIDCALL;
+    this._isRunning = false;
+    return ALResult.S_OK;
+  }
+
+  /**
+   * How many pixels passed.
+   *
+   * @param {number} [_waitMode] An `OcclusionWaitMode`; nothing to wait for here.
+   * @returns {object} `{ result, count }`.
+   */
+  GetPixelCount(_waitMode = OcclusionWaitMode.DO_NOT_WAIT) {
+    if (!this._isValid) return {
+      result: ALResult.E_INVALIDCALL,
+      count: 0
+    };
+    return {
+      result: ALResult.S_OK,
+      count: 0
+    };
+  }
+
+  /** @returns {number} A `Tr2ALMemoryType`. */
+  GetMemoryClass() {
+    return Tr2ALMemoryType.AL_MEMORY_VIDEO;
+  }
+
+  /**
+   * Names the query for a debugger.
+   *
+   * @param {string} _name The name Carbon would attach; the stub discards it.
+   * @returns {number} An `ALResult` value; the stub keeps no name
+   *   (`Tr2OcclusionQueryALStub.cpp:81-84`).
+   */
+  SetName(_name) {
+    return ALResult.S_OK;
+  }
+}
+
+// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in
+// Tr2BitmapDimensions.js: the layer is imported straight from source by its
+// tests and raw Node cannot parse decorator syntax.
+//
+// The donor is NAMED rather than left to be derived from this class's name.
+// Carbon calls every backend's class the same thing and carries the backend in
+// the FILE name, because only one backend compiles at a time; we ship them
+// together, so the backend moves onto the class name. That divergence is the
+// author's to declare, never a checker's to guess.
+CjsSchema.define(Tr2OcclusionQueryALStub, {
+  className: "Tr2OcclusionQueryALStub",
+  carbon: "Tr2OcclusionQueryAL"
+});
+
+export { OcclusionWaitMode, Tr2OcclusionQueryALStub };
+//# sourceMappingURL=Tr2OcclusionQueryALStub.js.map

package/dist/trinityal/stub/Tr2OcclusionQueryALStub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2OcclusionQueryALStub.js","sources":["../../../../src/trinityal/stub/Tr2OcclusionQueryALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2OcclusionQueryALStub.cpp\r\nimport { CjsSchema } from \"#schema\";\r\nimport { Tr2ALMemoryType, Tr2DeviceResourceAL } from \"../Tr2DeviceResourceAL/index.js\";\r\nimport { ALResult } from \"../ALResult.js\";\r\n\r\n\r\n/** Carbon's `Tr2OcclusionQueryAL::WaitMode`. */\r\nexport const OcclusionWaitMode = Object.freeze({\r\n  /** Return whatever is available now. */\r\n  DO_NOT_WAIT: 0,\r\n  /** Block until the result is ready. */\r\n  WAIT: 1\r\n});\r\n\r\n\r\n/**\r\n * Counts the pixels a bracketed draw passed.\r\n */\r\nexport class Tr2OcclusionQueryALStub extends Tr2DeviceResourceAL\r\n{\r\n  /** m_isValid */\r\n  _isValid = false;\r\n\r\n  /** m_isRunning */\r\n  _isRunning = false;\r\n\r\n  /**\r\n   * Creates the query.\r\n   *\r\n   * @param {object} renderContext The context to create against.\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Create(renderContext)\r\n  {\r\n    if (!renderContext?.IsValid()) return ALResult.E_INVALIDARG;\r\n\r\n    this._isValid = true;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** @returns {boolean} Whether the query was created. */\r\n  IsValid()\r\n  {\r\n    return this._isValid;\r\n  }\r\n\r\n  /** Releases the query. */\r\n  Destroy()\r\n  {\r\n    this._isValid = false;\r\n    super.Destroy();\r\n  }\r\n\r\n  /**\r\n   * Starts counting.\r\n   *\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Begin()\r\n  {\r\n    if (!this._isValid) return ALResult.E_INVALIDCALL;\r\n\r\n    this._isRunning = true;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * Stops counting.\r\n   *\r\n   * ENDING A QUERY THAT NEVER BEGAN IS AN ERROR, which Carbon checks\r\n   * (`cpp:End`) and which is the mispairing this class exists to catch.\r\n   *\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  End()\r\n  {\r\n    if (!this._isValid) return ALResult.E_INVALIDCALL;\r\n    if (!this._isRunning) return ALResult.E_INVALIDCALL;\r\n\r\n    this._isRunning = false;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * How many pixels passed.\r\n   *\r\n   * @param {number} [_waitMode] An `OcclusionWaitMode`; nothing to wait for here.\r\n   * @returns {object} `{ result, count }`.\r\n   */\r\n  GetPixelCount(_waitMode = OcclusionWaitMode.DO_NOT_WAIT)\r\n  {\r\n    if (!this._isValid) return { result: ALResult.E_INVALIDCALL, count: 0 };\r\n\r\n    return { result: ALResult.S_OK, count: 0 };\r\n  }\r\n\r\n  /** @returns {number} A `Tr2ALMemoryType`. */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\r\n  }\r\n\r\n\r\n  /**\r\n   * Names the query for a debugger.\r\n   *\r\n   * @param {string} _name The name Carbon would attach; the stub discards it.\r\n   * @returns {number} An `ALResult` value; the stub keeps no name\r\n   *   (`Tr2OcclusionQueryALStub.cpp:81-84`).\r\n   */\r\n  SetName(_name)\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n}\r\n\r\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\r\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\r\n// tests and raw Node cannot parse decorator syntax.\r\n//\r\n// The donor is NAMED rather than left to be derived from this class's name.\r\n// Carbon calls every backend's class the same thing and carries the backend in\r\n// the FILE name, because only one backend compiles at a time; we ship them\r\n// together, so the backend moves onto the class name. That divergence is the\r\n// author's to declare, never a checker's to guess.\r\nCjsSchema.define(Tr2OcclusionQueryALStub, { className: \"Tr2OcclusionQueryALStub\", carbon: \"Tr2OcclusionQueryAL\" });\r\n"],"names":["OcclusionWaitMode","Object","freeze","DO_NOT_WAIT","WAIT","Tr2OcclusionQueryALStub","Tr2DeviceResourceAL","_isValid","_isRunning","Create","renderContext","IsValid","ALResult","E_INVALIDARG","S_OK","Destroy","Begin","E_INVALIDCALL","End","GetPixelCount","_waitMode","result","count","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","SetName","_name","CjsSchema","define","className","carbon"],"mappings":";;;;;AAAA;;AAMA;MACaA,iBAAiB,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC7C;AACAC,EAAAA,WAAW,EAAE,CAAC;AACd;AACAC,EAAAA,IAAI,EAAE;AACR,CAAC;;AAGD;AACA;AACA;AACO,MAAMC,uBAAuB,SAASC,mBAAmB,CAChE;AACE;AACAC,EAAAA,QAAQ,GAAG,KAAK;;AAEhB;AACAC,EAAAA,UAAU,GAAG,KAAK;;AAElB;AACF;AACA;AACA;AACA;AACA;EACEC,MAAMA,CAACC,aAAa,EACpB;IACE,IAAI,CAACA,aAAa,EAAEC,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACC,YAAY;IAE3D,IAAI,CAACN,QAAQ,GAAG,IAAI;IAEpB,OAAOK,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACAH,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAACJ,QAAQ;AACtB,EAAA;;AAEA;AACAQ,EAAAA,OAAOA,GACP;IACE,IAAI,CAACR,QAAQ,GAAG,KAAK;IACrB,KAAK,CAACQ,OAAO,EAAE;AACjB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,KAAKA,GACL;IACE,IAAI,CAAC,IAAI,CAACT,QAAQ,EAAE,OAAOK,QAAQ,CAACK,aAAa;IAEjD,IAAI,CAACT,UAAU,GAAG,IAAI;IAEtB,OAAOI,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEI,EAAAA,GAAGA,GACH;IACE,IAAI,CAAC,IAAI,CAACX,QAAQ,EAAE,OAAOK,QAAQ,CAACK,aAAa;IACjD,IAAI,CAAC,IAAI,CAACT,UAAU,EAAE,OAAOI,QAAQ,CAACK,aAAa;IAEnD,IAAI,CAACT,UAAU,GAAG,KAAK;IAEvB,OAAOI,QAAQ,CAACE,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACEK,EAAAA,aAAaA,CAACC,SAAS,GAAGpB,iBAAiB,CAACG,WAAW,EACvD;AACE,IAAA,IAAI,CAAC,IAAI,CAACI,QAAQ,EAAE,OAAO;MAAEc,MAAM,EAAET,QAAQ,CAACK,aAAa;AAAEK,MAAAA,KAAK,EAAE;KAAG;IAEvE,OAAO;MAAED,MAAM,EAAET,QAAQ,CAACE,IAAI;AAAEQ,MAAAA,KAAK,EAAE;KAAG;AAC5C,EAAA;;AAEA;AACAC,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,eAAe;AACxC,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,KAAK,EACb;IACE,OAAOf,QAAQ,CAACE,IAAI;AACtB,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAc,SAAS,CAACC,MAAM,CAACxB,uBAAuB,EAAE;AAAEyB,EAAAA,SAAS,EAAE,yBAAyB;AAAEC,EAAAA,MAAM,EAAE;AAAsB,CAAC,CAAC;;;;"}

package/dist/trinityal/stub/Tr2PipelineStatsQueryALStub/Tr2PipelineStatsQueryALStub.js

@@ -0,0 +1,146 @@
+import { CjsSchema } from '#schema';
+import { Tr2ALMemoryType } from '../../Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js';
+import { Tr2DeviceResourceAL } from '../../Tr2DeviceResourceAL/Tr2DeviceResourceAL.js';
+import { ALResult } from '../../ALResult.js';
+
+// Source: trinity/trinityal/stub/Tr2PipelineStatsQueryALStub.cpp
+
+/**
+ * Collects pipeline statistics over a bracketed span.
+ *
+ * Carbon's stub is the most permissive of the three: it is always valid and
+ * every call succeeds, because there is nothing to allocate and no state worth
+ * mispairing.
+ */
+class Tr2PipelineStatsQueryALStub extends Tr2DeviceResourceAL {
+  /**
+   * Creates the query.
+   *
+   * @returns {number} An `ALResult`.
+   */
+  Create() {
+    return ALResult.S_OK;
+  }
+
+  /** @returns {boolean} True, as Carbon's stub is always valid. */
+  IsValid() {
+    return true;
+  }
+
+  /** Releases the query. */
+  Destroy() {
+    super.Destroy();
+  }
+
+  /** @returns {number} An `ALResult`. */
+  Begin() {
+    return ALResult.S_OK;
+  }
+
+  /** @returns {number} An `ALResult`. */
+  End() {
+    return ALResult.S_OK;
+  }
+
+  /**
+   * The collected statistics.
+   *
+   * @returns {object} `{ result, data }` with an empty data set.
+   */
+  GetStats() {
+    return {
+      result: ALResult.S_OK,
+      data: []
+    };
+  }
+
+  /**
+   * How many values a statistics set holds.
+   *
+   * @param {Array} data A statistics set.
+   * @returns {number} The count.
+   */
+  static GetValueCount(data) {
+    return data?.length ?? 0;
+  }
+
+  /**
+   * One value's label.
+   *
+   * @param {Array} data A statistics set.
+   * @param {number} index Which value.
+   * @returns {string} The label, empty when absent.
+   */
+  static GetLabel(data, index) {
+    return data?.[index]?.label ?? "";
+  }
+
+  /**
+   * One value's description.
+   *
+   * @param {Array} data A statistics set.
+   * @param {number} index Which value.
+   * @returns {string} The description, empty when absent.
+   */
+  static GetDescription(data, index) {
+    return data?.[index]?.description ?? "";
+  }
+
+  /**
+   * One value.
+   *
+   * @param {Array} data A statistics set.
+   * @param {number} index Which value.
+   * @returns {number} The value, zero when absent.
+   */
+  static GetValue(data, index) {
+    return data?.[index]?.value ?? 0;
+  }
+
+  /** @returns {number} A `Tr2ALMemoryType`; MANAGED, not VIDEO, as Carbon has it. */
+  GetMemoryClass() {
+    return Tr2ALMemoryType.AL_MEMORY_MANAGED;
+  }
+
+  /**
+   * Names the query for a debugger.
+   *
+   * @param {string} _name The name Carbon would attach; the stub discards it.
+   * @returns {number} An `ALResult` value; the stub keeps no name
+   *   (`Tr2PipelineStatsQueryALStub.cpp:70-73`).
+   */
+  SetName(_name) {
+    return ALResult.S_OK;
+  }
+
+  /**
+   * Describes this query for a device inventory.
+   *
+   * THE ONE NON-EMPTY `Describe` IN CARBON'S STUB TREE. Every other stub
+   * resource leaves the map untouched; this one writes its own type name
+   * (`Tr2PipelineStatsQueryALStub.cpp:65-68`). Overridden here for that reason
+   * alone - the base class no-op would otherwise be silently wrong.
+   *
+   * @param {object} description Accumulator, keyed by name.
+   */
+  Describe(description) {
+    description.type = "Tr2PipelineStatsQueryAL";
+  }
+}
+
+// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in
+// Tr2BitmapDimensions.js: the layer is imported straight from source by its
+// tests and raw Node cannot parse decorator syntax.
+//
+// The donor is NAMED rather than left to be derived from this class's name.
+// Carbon calls every backend's class the same thing and carries the backend in
+// the FILE name, because only one backend compiles at a time; we ship them
+// together, so the backend moves onto the class name. That divergence is the
+// author's to declare, never a checker's to guess.
+CjsSchema.define(Tr2PipelineStatsQueryALStub, {
+  className: "Tr2PipelineStatsQueryALStub",
+  carbon: "Tr2PipelineStatsQueryAL"
+});
+
+export { Tr2PipelineStatsQueryALStub };
+//# sourceMappingURL=Tr2PipelineStatsQueryALStub.js.map

package/dist/trinityal/stub/Tr2PipelineStatsQueryALStub/Tr2PipelineStatsQueryALStub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2PipelineStatsQueryALStub.js","sources":["../../../../../src/trinityal/stub/Tr2PipelineStatsQueryALStub/Tr2PipelineStatsQueryALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2PipelineStatsQueryALStub.cpp\r\nimport { CjsSchema } from \"#schema\";\r\nimport { Tr2ALMemoryType, Tr2DeviceResourceAL } from \"../../Tr2DeviceResourceAL/index.js\";\r\nimport { ALResult } from \"../../ALResult.js\";\r\n\r\n\r\n/**\r\n * Collects pipeline statistics over a bracketed span.\r\n *\r\n * Carbon's stub is the most permissive of the three: it is always valid and\r\n * every call succeeds, because there is nothing to allocate and no state worth\r\n * mispairing.\r\n */\r\nexport class Tr2PipelineStatsQueryALStub extends Tr2DeviceResourceAL\r\n{\r\n  /**\r\n   * Creates the query.\r\n   *\r\n   * @returns {number} An `ALResult`.\r\n   */\r\n  Create()\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** @returns {boolean} True, as Carbon's stub is always valid. */\r\n  IsValid()\r\n  {\r\n    return true;\r\n  }\r\n\r\n  /** Releases the query. */\r\n  Destroy()\r\n  {\r\n    super.Destroy();\r\n  }\r\n\r\n  /** @returns {number} An `ALResult`. */\r\n  Begin()\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** @returns {number} An `ALResult`. */\r\n  End()\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * The collected statistics.\r\n   *\r\n   * @returns {object} `{ result, data }` with an empty data set.\r\n   */\r\n  GetStats()\r\n  {\r\n    return { result: ALResult.S_OK, data: [] };\r\n  }\r\n\r\n  /**\r\n   * How many values a statistics set holds.\r\n   *\r\n   * @param {Array} data A statistics set.\r\n   * @returns {number} The count.\r\n   */\r\n  static GetValueCount(data)\r\n  {\r\n    return data?.length ?? 0;\r\n  }\r\n\r\n  /**\r\n   * One value's label.\r\n   *\r\n   * @param {Array} data A statistics set.\r\n   * @param {number} index Which value.\r\n   * @returns {string} The label, empty when absent.\r\n   */\r\n  static GetLabel(data, index)\r\n  {\r\n    return data?.[index]?.label ?? \"\";\r\n  }\r\n\r\n  /**\r\n   * One value's description.\r\n   *\r\n   * @param {Array} data A statistics set.\r\n   * @param {number} index Which value.\r\n   * @returns {string} The description, empty when absent.\r\n   */\r\n  static GetDescription(data, index)\r\n  {\r\n    return data?.[index]?.description ?? \"\";\r\n  }\r\n\r\n  /**\r\n   * One value.\r\n   *\r\n   * @param {Array} data A statistics set.\r\n   * @param {number} index Which value.\r\n   * @returns {number} The value, zero when absent.\r\n   */\r\n  static GetValue(data, index)\r\n  {\r\n    return data?.[index]?.value ?? 0;\r\n  }\r\n\r\n  /** @returns {number} A `Tr2ALMemoryType`; MANAGED, not VIDEO, as Carbon has it. */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\r\n  }\r\n\r\n\r\n  /**\r\n   * Names the query for a debugger.\r\n   *\r\n   * @param {string} _name The name Carbon would attach; the stub discards it.\r\n   * @returns {number} An `ALResult` value; the stub keeps no name\r\n   *   (`Tr2PipelineStatsQueryALStub.cpp:70-73`).\r\n   */\r\n  SetName(_name)\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n\r\n  /**\r\n   * Describes this query for a device inventory.\r\n   *\r\n   * THE ONE NON-EMPTY `Describe` IN CARBON'S STUB TREE. Every other stub\r\n   * resource leaves the map untouched; this one writes its own type name\r\n   * (`Tr2PipelineStatsQueryALStub.cpp:65-68`). Overridden here for that reason\r\n   * alone - the base class no-op would otherwise be silently wrong.\r\n   *\r\n   * @param {object} description Accumulator, keyed by name.\r\n   */\r\n  Describe(description)\r\n  {\r\n    description.type = \"Tr2PipelineStatsQueryAL\";\r\n  }\r\n}\r\n\r\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\r\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\r\n// tests and raw Node cannot parse decorator syntax.\r\n//\r\n// The donor is NAMED rather than left to be derived from this class's name.\r\n// Carbon calls every backend's class the same thing and carries the backend in\r\n// the FILE name, because only one backend compiles at a time; we ship them\r\n// together, so the backend moves onto the class name. That divergence is the\r\n// author's to declare, never a checker's to guess.\r\nCjsSchema.define(Tr2PipelineStatsQueryALStub, { className: \"Tr2PipelineStatsQueryALStub\", carbon: \"Tr2PipelineStatsQueryAL\" });\r\n"],"names":["Tr2PipelineStatsQueryALStub","Tr2DeviceResourceAL","Create","ALResult","S_OK","IsValid","Destroy","Begin","End","GetStats","result","data","GetValueCount","length","GetLabel","index","label","GetDescription","description","GetValue","value","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","SetName","_name","Describe","type","CjsSchema","define","className","carbon"],"mappings":";;;;;AAAA;;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,2BAA2B,SAASC,mBAAmB,CACpE;AACE;AACF;AACA;AACA;AACA;AACEC,EAAAA,MAAMA,GACN;IACE,OAAOC,QAAQ,CAACC,IAAI;AACtB,EAAA;;AAEA;AACAC,EAAAA,OAAOA,GACP;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACAC,EAAAA,OAAOA,GACP;IACE,KAAK,CAACA,OAAO,EAAE;AACjB,EAAA;;AAEA;AACAC,EAAAA,KAAKA,GACL;IACE,OAAOJ,QAAQ,CAACC,IAAI;AACtB,EAAA;;AAEA;AACAI,EAAAA,GAAGA,GACH;IACE,OAAOL,QAAQ,CAACC,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEK,EAAAA,QAAQA,GACR;IACE,OAAO;MAAEC,MAAM,EAAEP,QAAQ,CAACC,IAAI;AAAEO,MAAAA,IAAI,EAAE;KAAI;AAC5C,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACE,OAAOC,aAAaA,CAACD,IAAI,EACzB;AACE,IAAA,OAAOA,IAAI,EAAEE,MAAM,IAAI,CAAC;AAC1B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACE,EAAA,OAAOC,QAAQA,CAACH,IAAI,EAAEI,KAAK,EAC3B;AACE,IAAA,OAAOJ,IAAI,GAAGI,KAAK,CAAC,EAAEC,KAAK,IAAI,EAAE;AACnC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACE,EAAA,OAAOC,cAAcA,CAACN,IAAI,EAAEI,KAAK,EACjC;AACE,IAAA,OAAOJ,IAAI,GAAGI,KAAK,CAAC,EAAEG,WAAW,IAAI,EAAE;AACzC,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACE,EAAA,OAAOC,QAAQA,CAACR,IAAI,EAAEI,KAAK,EAC3B;AACE,IAAA,OAAOJ,IAAI,GAAGI,KAAK,CAAC,EAAEK,KAAK,IAAI,CAAC;AAClC,EAAA;;AAEA;AACAC,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,iBAAiB;AAC1C,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,KAAK,EACb;IACE,OAAOtB,QAAQ,CAACC,IAAI;AACtB,EAAA;;AAGA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEsB,QAAQA,CAACR,WAAW,EACpB;IACEA,WAAW,CAACS,IAAI,GAAG,yBAAyB;AAC9C,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,SAAS,CAACC,MAAM,CAAC7B,2BAA2B,EAAE;AAAE8B,EAAAA,SAAS,EAAE,6BAA6B;AAAEC,EAAAA,MAAM,EAAE;AAA0B,CAAC,CAAC;;;;"}

package/dist/trinityal/stub/Tr2RenderContextALStub/Tr2BindlessResourcesAL.js

@@ -0,0 +1,28 @@
+// Source: trinity/trinityal/stub/Tr2RenderContextStub.h
+//   Declared top-level beside the render context, as every backend declares it.
+
+/**
+ * Carbon's `Tr2BindlessResourcesAL` (`Tr2RenderContextStub.h:32-47`).
+ *
+ * A list of resources handed to `UseResources` so a backend can make them
+ * resident together. Every method is empty in the stub, exactly as in Carbon:
+ * residency is a device concern and there is no device here.
+ *
+ * Carbon overloads `Add` for a texture, a buffer and another resource list;
+ * JavaScript dispatches on one method, which is the ordinary shape of an
+ * overload set here and not a divergence in behaviour.
+ */
+class Tr2BindlessResourcesAL {
+  /**
+   * Adds a texture, a buffer, or the contents of another list.
+   *
+   * @param {object} _resource The resource to make resident.
+   */
+  Add(_resource) {}
+
+  /** Empties the list. */
+  Clear() {}
+}
+
+export { Tr2BindlessResourcesAL };
+//# sourceMappingURL=Tr2BindlessResourcesAL.js.map

package/dist/trinityal/stub/Tr2RenderContextALStub/Tr2BindlessResourcesAL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tr2BindlessResourcesAL.js","sources":["../../../../../src/trinityal/stub/Tr2RenderContextALStub/Tr2BindlessResourcesAL.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2RenderContextStub.h\n//   Declared top-level beside the render context, as every backend declares it.\n\n\n/**\n * Carbon's `Tr2BindlessResourcesAL` (`Tr2RenderContextStub.h:32-47`).\n *\n * A list of resources handed to `UseResources` so a backend can make them\n * resident together. Every method is empty in the stub, exactly as in Carbon:\n * residency is a device concern and there is no device here.\n *\n * Carbon overloads `Add` for a texture, a buffer and another resource list;\n * JavaScript dispatches on one method, which is the ordinary shape of an\n * overload set here and not a divergence in behaviour.\n */\nexport class Tr2BindlessResourcesAL\n{\n  /**\n   * Adds a texture, a buffer, or the contents of another list.\n   *\n   * @param {object} _resource The resource to make resident.\n   */\n  Add(_resource)\n  {\n  }\n\n  /** Empties the list. */\n  Clear()\n  {\n  }\n}\n"],"names":["Tr2BindlessResourcesAL","Add","_resource","Clear"],"mappings":"AAAA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,sBAAsB,CACnC;AACE;AACF;AACA;AACA;AACA;EACEC,GAAGA,CAACC,SAAS,EACb,CACA;;AAEA;EACAC,KAAKA,GACL,CACA;AACF;;;;"}