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

package/dist/trinityal/stub/Tr2BufferALStub.js

@@ -1,13 +1,14 @@
-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';
-import { PixelFormat, GetBytesPerPixel } from '../../global/consts/renderContext/formats.js';
+import { Tr2BufferDescriptionAL } from '../Tr2BufferAL/Tr2BufferDescriptionAL.js';
+import '../../global/consts/renderContext/formats.js';
 import '../../global/consts/renderContext/pipeline.js';
-import { Tr2GpuUsage, Tr2CpuUsage, HasFlag } from '../../global/consts/renderContext/resources.js';
+import { HasFlag, Tr2CpuUsage } from '../../global/consts/renderContext/resources.js';
 
 // Source: trinity/trinityal/stub/Tr2BufferALStub.cpp
 // Source: trinity/trinityal/stub/Tr2BufferALStub.h
-// Source: trinity/trinityal/include/Tr2BufferAL.h
-// Source: trinity/trinityal/src/Tr2BufferAL.cpp (the description constructors)
 //
 // The GPU-free buffer: vertex, index, structured and indirect-argument data.
 //
@@ -31,93 +32,23 @@ import { Tr2GpuUsage, Tr2CpuUsage, HasFlag } from '../../global/consts/renderCon
 /** Carbon's "no descriptor heap index". */
 const NO_HEAP_INDEX = 0xffffffff;
 
-/**
- * How a buffer is laid out and what may touch it.
- *
- * Carbon's two non-default constructors differ only in where the stride comes
- * from: `FromFormat` derives it from the pixel format, `FromStride` is given
- * it outright for a structured buffer.
+/**
+ * A buffer that holds its bytes on the CPU.
  */
-class Tr2BufferDescriptionAL {
-  /** A `PixelFormat` value; unknown for a structured buffer. */
-  format = PixelFormat.PIXEL_FORMAT_UNKNOWN;
-
-  /** Bytes per element. */
-  stride = 0;
-
-  /** Elements. */
-  count = 0;
-
-  /** A `Tr2GpuUsage` bit set. */
-  gpuUsage = Tr2GpuUsage.NONE;
-
-  /** A `Tr2CpuUsage` bit set. */
-  cpuUsage = Tr2CpuUsage.NONE;
-
-  /**
-   * A typed buffer, whose stride follows from its format.
-   *
-   * @param {number} format A `PixelFormat` value.
-   * @param {number} count Elements.
-   * @param {number} gpuUsage A `Tr2GpuUsage` bit set.
-   * @param {number} cpuUsage A `Tr2CpuUsage` bit set.
-   * @returns {Tr2BufferDescriptionAL} The description.
-   */
-  static FromFormat(format, count, gpuUsage, cpuUsage) {
-    const description = new Tr2BufferDescriptionAL();
-    description.format = format;
-    description.stride = GetBytesPerPixel(format);
-    description.count = count;
-    description.gpuUsage = gpuUsage;
-    description.cpuUsage = cpuUsage;
-    return description;
-  }
-
-  /**
-   * A structured buffer, whose stride is given.
-   *
-   * @param {number} stride Bytes per element.
-   * @param {number} count Elements.
-   * @param {number} gpuUsage A `Tr2GpuUsage` bit set.
-   * @param {number} cpuUsage A `Tr2CpuUsage` bit set.
-   * @returns {Tr2BufferDescriptionAL} The description.
-   */
-  static FromStride(stride, count, gpuUsage, cpuUsage) {
-    const description = new Tr2BufferDescriptionAL();
-    description.stride = stride;
-    description.count = count;
-    description.gpuUsage = gpuUsage;
-    description.cpuUsage = cpuUsage;
-    return description;
-  }
-
-  /**
-   * The buffer's size in bytes.
-   *
-   * @returns {number} Stride times count.
-   */
-  GetSizeInBytes() {
-    return this.stride * this.count;
-  }
-}
-
-/**
- * A buffer that holds its bytes on the CPU.
- */
-class Tr2BufferALStub extends Tr2BaseDeviceResourceAL {
+class Tr2BufferALStub extends Tr2DeviceResourceAL {
   /** m_desc */
   _desc = new Tr2BufferDescriptionAL();
 
   /** m_buffer */
   _buffer = new Uint8Array(0);
 
-  /**
-   * Creates the buffer.
-   *
-   * @param {Tr2BufferDescriptionAL} desc The buffer description.
-   * @param {ArrayBufferView|null} initialData Initial contents, if any.
-   * @param {object} renderContext The context to create against.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Creates the buffer.
+   *
+   * @param {Tr2BufferDescriptionAL} desc The buffer description.
+   * @param {ArrayBufferView|null} initialData Initial contents, if any.
+   * @param {object} renderContext The context to create against.
+   * @returns {number} An `ALResult` value.
    */
   Create(desc, initialData, renderContext) {
     this._Reset();
@@ -144,53 +75,53 @@ class Tr2BufferALStub extends Tr2BaseDeviceResourceAL {
     super.Destroy();
   }
 
-  /**
-   * Whether the buffer holds anything.
-   *
-   * @returns {boolean} True when it has a size.
+  /**
+   * Whether the buffer holds anything.
+   *
+   * @returns {boolean} True when it has a size.
    */
   IsValid() {
     return this._buffer.length > 0;
   }
 
-  /**
-   * Which memory class this buffer occupies.
-   *
-   * @returns {number} A `Tr2ALMemoryType` value.
+  /**
+   * Which memory class this buffer occupies.
+   *
+   * @returns {number} A `Tr2ALMemoryType` value.
    */
   GetMemoryClass() {
     return Tr2ALMemoryType.AL_MEMORY_MANAGED;
   }
 
-  /**
-   * The buffer description.
-   *
-   * @returns {Tr2BufferDescriptionAL} The description.
+  /**
+   * The buffer description.
+   *
+   * @returns {Tr2BufferDescriptionAL} The description.
    */
   GetDesc() {
     return this._desc;
   }
 
-  /**
-   * The buffer's size in bytes.
-   *
-   * Carbon derives it rather than storing it: `GetDesc().count *
-   * GetDesc().stride` (`src/Tr2BufferAL.cpp:112-115`). Derived here too, so a
-   * description change cannot leave a stale size behind.
-   *
-   * @returns {number} Bytes.
+  /**
+   * The buffer's size in bytes.
+   *
+   * Carbon derives it rather than storing it: `GetDesc().count *
+   * GetDesc().stride` (`src/Tr2BufferAL.cpp:112-115`). Derived here too, so a
+   * description change cannot leave a stale size behind.
+   *
+   * @returns {number} Bytes.
    */
   GetSize() {
     return this._desc.GetSizeInBytes();
   }
 
-  /**
-   * Maps the whole buffer, or a range of it, for reading.
-   *
-   * @param {object} renderContext The context to map against.
-   * @param {number} [offset] Byte offset of the range.
-   * @param {number} [size] Bytes in the range; the whole buffer when omitted.
-   * @returns {{result: number, data: Uint8Array|null}} The mapping.
+  /**
+   * Maps the whole buffer, or a range of it, for reading.
+   *
+   * @param {object} renderContext The context to map against.
+   * @param {number} [offset] Byte offset of the range.
+   * @param {number} [size] Bytes in the range; the whole buffer when omitted.
+   * @returns {{result: number, data: Uint8Array|null}} The mapping.
    */
   MapForReading(renderContext, offset = 0, size = 0) {
     if (!renderContext.IsValid() || !this.IsValid()) return {
@@ -220,11 +151,11 @@ class Tr2BufferALStub extends Tr2BaseDeviceResourceAL {
   /** Carbon's stub releases nothing on unmap; the storage is the buffer. */
   UnmapForReading() {}
 
-  /**
-   * Maps the whole buffer for writing.
-   *
-   * @param {object} renderContext The context to map against.
-   * @returns {{result: number, data: Uint8Array|null}} The mapping.
+  /**
+   * Maps the whole buffer for writing.
+   *
+   * @param {object} renderContext The context to map against.
+   * @returns {{result: number, data: Uint8Array|null}} The mapping.
    */
   MapForWriting(renderContext) {
     if (!renderContext.IsValid() || !this.IsValid()) return {
@@ -244,17 +175,17 @@ class Tr2BufferALStub extends Tr2BaseDeviceResourceAL {
   /** @see UnmapForReading */
   UnmapForWriting() {}
 
-  /**
-   * Validates a buffer update. IT MOVES NO BYTES - see the head comment.
-   *
-   * A buffer mapped often is written through a map, so Carbon refuses
-   * `WRITE_OFTEN` here outright.
-   *
-   * @param {number} offset Byte offset of the range.
-   * @param {number} size Bytes in the range.
-   * @param {ArrayBufferView} data The bytes.
-   * @param {object} renderContext The context to update against.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Validates a buffer update. IT MOVES NO BYTES - see the head comment.
+   *
+   * A buffer mapped often is written through a map, so Carbon refuses
+   * `WRITE_OFTEN` here outright.
+   *
+   * @param {number} offset Byte offset of the range.
+   * @param {number} size Bytes in the range.
+   * @param {ArrayBufferView} data The bytes.
+   * @param {object} renderContext The context to update against.
+   * @returns {number} An `ALResult` value.
    */
   UpdateBuffer(offset, size, data, renderContext) {
     if (!renderContext.IsValid() || !this.IsValid()) return ALResult.E_INVALIDCALL;
@@ -265,34 +196,48 @@ class Tr2BufferALStub extends Tr2BaseDeviceResourceAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * Where the shader-resource view sits in the descriptor heap.
-   *
-   * @returns {number} Carbon's "no index".
+  /**
+   * Where the shader-resource view sits in the descriptor heap.
+   *
+   * @returns {number} Carbon's "no index".
    */
   GetSrvIndexInHeap() {
     return NO_HEAP_INDEX;
   }
 
-  /**
-   * Where the unordered-access view sits in the descriptor heap.
-   *
-   * @returns {number} Carbon's "no index".
+  /**
+   * Where the unordered-access view sits in the descriptor heap.
+   *
+   * @returns {number} Carbon's "no index".
    */
   GetUavIndexInHeap() {
     return NO_HEAP_INDEX;
   }
 
-  /**
-   * Names the buffer 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.
+  /**
+   * Names the buffer 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.
    */
   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(Tr2BufferALStub, {
+  className: "Tr2BufferALStub",
+  carbon: "Tr2BufferAL"
+});
+
 export { Tr2BufferALStub, Tr2BufferDescriptionAL };
 //# sourceMappingURL=Tr2BufferALStub.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2BufferALStub.js","sources":["../../../../src/trinityal/stub/Tr2BufferALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2BufferALStub.cpp\n// Source: trinity/trinityal/stub/Tr2BufferALStub.h\n// Source: trinity/trinityal/include/Tr2BufferAL.h\n// Source: trinity/trinityal/src/Tr2BufferAL.cpp (the description constructors)\n//\n// The GPU-free buffer: vertex, index, structured and indirect-argument data.\n//\n// Unlike the texture, the buffer's storage is the whole point of the type -\n// `IsValid` is literally \"the allocation has a size\". A caller maps it, writes\n// vertices into it, maps it again and reads them back, all without a device,\n// which is what lets a headless frame carry real geometry.\n//\n// TWO DECISIONS TO KNOW ABOUT.\n//\n// - A ranged read returns the bytes of THAT RANGE. Carbon's stub validates the\n//   range and then hands back the start of the buffer regardless\n//   (`Tr2BufferALStub.cpp:96-98`), which is harmless there because its storage\n//   is never meaningfully filled. Ours is, so returning the base would hand a\n//   caller the wrong bytes; every real backend offsets, and so does this.\n// - `UpdateBuffer` VALIDATES AND MOVES NOTHING, exactly as Carbon's stub does.\n//   The stub is not a memory model: the map path is what carries data. A caller\n//   that needs the write to land must map for writing.\n\nimport { Tr2ALMemoryType, Tr2BaseDeviceResourceAL } from \"../Tr2DeviceResourceAL.js\";\nimport { ALResult } from \"../ALResult.js\";\nimport {\n  GetBytesPerPixel,\n  HasFlag,\n  PixelFormat,\n  Tr2CpuUsage,\n  Tr2GpuUsage\n} from \"../../global/consts/renderContext/index.js\";\n\n\n/** Carbon's \"no descriptor heap index\". */\nconst NO_HEAP_INDEX = 0xffffffff;\n\n\n/**\n * How a buffer is laid out and what may touch it.\n *\n * Carbon's two non-default constructors differ only in where the stride comes\n * from: `FromFormat` derives it from the pixel format, `FromStride` is given\n * it outright for a structured buffer.\n */\nexport class Tr2BufferDescriptionAL\n{\n  /** A `PixelFormat` value; unknown for a structured buffer. */\n  format = PixelFormat.PIXEL_FORMAT_UNKNOWN;\n\n  /** Bytes per element. */\n  stride = 0;\n\n  /** Elements. */\n  count = 0;\n\n  /** A `Tr2GpuUsage` bit set. */\n  gpuUsage = Tr2GpuUsage.NONE;\n\n  /** A `Tr2CpuUsage` bit set. */\n  cpuUsage = Tr2CpuUsage.NONE;\n\n  /**\n   * A typed buffer, whose stride follows from its format.\n   *\n   * @param {number} format A `PixelFormat` value.\n   * @param {number} count Elements.\n   * @param {number} gpuUsage A `Tr2GpuUsage` bit set.\n   * @param {number} cpuUsage A `Tr2CpuUsage` bit set.\n   * @returns {Tr2BufferDescriptionAL} The description.\n   */\n  static FromFormat(format, count, gpuUsage, cpuUsage)\n  {\n    const description = new Tr2BufferDescriptionAL();\n\n    description.format = format;\n    description.stride = GetBytesPerPixel(format);\n    description.count = count;\n    description.gpuUsage = gpuUsage;\n    description.cpuUsage = cpuUsage;\n\n    return description;\n  }\n\n  /**\n   * A structured buffer, whose stride is given.\n   *\n   * @param {number} stride Bytes per element.\n   * @param {number} count Elements.\n   * @param {number} gpuUsage A `Tr2GpuUsage` bit set.\n   * @param {number} cpuUsage A `Tr2CpuUsage` bit set.\n   * @returns {Tr2BufferDescriptionAL} The description.\n   */\n  static FromStride(stride, count, gpuUsage, cpuUsage)\n  {\n    const description = new Tr2BufferDescriptionAL();\n\n    description.stride = stride;\n    description.count = count;\n    description.gpuUsage = gpuUsage;\n    description.cpuUsage = cpuUsage;\n\n    return description;\n  }\n\n  /**\n   * The buffer's size in bytes.\n   *\n   * @returns {number} Stride times count.\n   */\n  GetSizeInBytes()\n  {\n    return this.stride * this.count;\n  }\n}\n\n\n/**\n * A buffer that holds its bytes on the CPU.\n */\nexport class Tr2BufferALStub extends Tr2BaseDeviceResourceAL\n{\n  /** m_desc */\n  _desc = new Tr2BufferDescriptionAL();\n\n  /** m_buffer */\n  _buffer = new Uint8Array(0);\n\n  /**\n   * Creates the buffer.\n   *\n   * @param {Tr2BufferDescriptionAL} desc The buffer description.\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\n   * @param {object} renderContext The context to create against.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(desc, initialData, renderContext)\n  {\n    this._Reset();\n\n    if (desc.count === 0) return ALResult.E_INVALIDARG;\n\n    // Nothing can ever put bytes in it: the same refusal the texture makes,\n    // for the same reason.\n    if (!HasFlag(desc.cpuUsage, Tr2CpuUsage.WRITE) && !initialData) return ALResult.E_INVALIDARG;\n\n    if (!renderContext.IsValid()) return ALResult.E_INVALIDCALL;\n\n    this._desc = desc;\n    this._buffer = new Uint8Array(desc.GetSizeInBytes());\n\n    return ALResult.S_OK;\n  }\n\n  /** Carbon's impl `Destroy`: empties without unregistering. */\n  _Reset()\n  {\n    this._desc.count = 0;\n    this._buffer = new Uint8Array(0);\n  }\n\n  /** Releases the buffer and leaves the device-resource registry. */\n  Destroy()\n  {\n    this._Reset();\n    super.Destroy();\n  }\n\n  /**\n   * Whether the buffer holds anything.\n   *\n   * @returns {boolean} True when it has a size.\n   */\n  IsValid()\n  {\n    return this._buffer.length > 0;\n  }\n\n  /**\n   * Which memory class this buffer occupies.\n   *\n   * @returns {number} A `Tr2ALMemoryType` value.\n   */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\n  }\n\n  /**\n   * The buffer description.\n   *\n   * @returns {Tr2BufferDescriptionAL} The description.\n   */\n  GetDesc()\n  {\n    return this._desc;\n  }\n\n\n  /**\n   * The buffer's size in bytes.\n   *\n   * Carbon derives it rather than storing it: `GetDesc().count *\n   * GetDesc().stride` (`src/Tr2BufferAL.cpp:112-115`). Derived here too, so a\n   * description change cannot leave a stale size behind.\n   *\n   * @returns {number} Bytes.\n   */\n  GetSize()\n  {\n    return this._desc.GetSizeInBytes();\n  }\n\n  /**\n   * Maps the whole buffer, or a range of it, for reading.\n   *\n   * @param {object} renderContext The context to map against.\n   * @param {number} [offset] Byte offset of the range.\n   * @param {number} [size] Bytes in the range; the whole buffer when omitted.\n   * @returns {{result: number, data: Uint8Array|null}} The mapping.\n   */\n  MapForReading(renderContext, offset = 0, size = 0)\n  {\n    if (!renderContext.IsValid() || !this.IsValid()) return { result: ALResult.E_INVALIDCALL, data: null };\n\n    const ranged = size !== 0 || offset !== 0;\n\n    if (ranged && (size === 0 || offset + size > this._desc.GetSizeInBytes()))\n    {\n      return { result: ALResult.E_INVALIDARG, data: null };\n    }\n\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.READ)) return { result: ALResult.E_INVALIDCALL, data: null };\n\n    // See the head comment: a range returns its own bytes, not the base.\n    const data = ranged ? this._buffer.subarray(offset, offset + size) : this._buffer;\n\n    return { result: ALResult.S_OK, data };\n  }\n\n  /** Carbon's stub releases nothing on unmap; the storage is the buffer. */\n  UnmapForReading()\n  {\n  }\n\n  /**\n   * Maps the whole buffer for writing.\n   *\n   * @param {object} renderContext The context to map against.\n   * @returns {{result: number, data: Uint8Array|null}} The mapping.\n   */\n  MapForWriting(renderContext)\n  {\n    if (!renderContext.IsValid() || !this.IsValid()) return { result: ALResult.E_INVALIDCALL, data: null };\n\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE)) return { result: ALResult.E_INVALIDCALL, data: null };\n\n    return { result: ALResult.S_OK, data: this._buffer };\n  }\n\n  /** @see UnmapForReading */\n  UnmapForWriting()\n  {\n  }\n\n  /**\n   * Validates a buffer update. IT MOVES NO BYTES - see the head comment.\n   *\n   * A buffer mapped often is written through a map, so Carbon refuses\n   * `WRITE_OFTEN` here outright.\n   *\n   * @param {number} offset Byte offset of the range.\n   * @param {number} size Bytes in the range.\n   * @param {ArrayBufferView} data The bytes.\n   * @param {object} renderContext The context to update against.\n   * @returns {number} An `ALResult` value.\n   */\n  UpdateBuffer(offset, size, data, renderContext)\n  {\n    if (!renderContext.IsValid() || !this.IsValid()) return ALResult.E_INVALIDCALL;\n\n    if (offset + size > this._desc.GetSizeInBytes()) return ALResult.E_INVALIDARG;\n\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE) || HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE_OFTEN))\n    {\n      return ALResult.E_INVALIDCALL;\n    }\n\n    return ALResult.S_OK;\n  }\n\n  /**\n   * Where the shader-resource view sits in the descriptor heap.\n   *\n   * @returns {number} Carbon's \"no index\".\n   */\n  GetSrvIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n\n  /**\n   * Where the unordered-access view sits in the descriptor heap.\n   *\n   * @returns {number} Carbon's \"no index\".\n   */\n  GetUavIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n\n  /**\n   * Names the buffer for a debugger.\n   *\n   * @param {string} _name The name Carbon would attach; the stub discards it.\n   * @returns {number} An `ALResult` value; the stub keeps no name.\n   */\n  SetName(_name)\n  {\n    return ALResult.S_OK;\n  }\n}\n"],"names":["NO_HEAP_INDEX","Tr2BufferDescriptionAL","format","PixelFormat","PIXEL_FORMAT_UNKNOWN","stride","count","gpuUsage","Tr2GpuUsage","NONE","cpuUsage","Tr2CpuUsage","FromFormat","description","GetBytesPerPixel","FromStride","GetSizeInBytes","Tr2BufferALStub","Tr2BaseDeviceResourceAL","_desc","_buffer","Uint8Array","Create","desc","initialData","renderContext","_Reset","ALResult","E_INVALIDARG","HasFlag","WRITE","IsValid","E_INVALIDCALL","S_OK","Destroy","length","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","GetDesc","GetSize","MapForReading","offset","size","result","data","ranged","READ","subarray","UnmapForReading","MapForWriting","UnmapForWriting","UpdateBuffer","WRITE_OFTEN","GetSrvIndexInHeap","GetUavIndexInHeap","SetName","_name"],"mappings":"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"}
+{"version":3,"file":"Tr2BufferALStub.js","sources":["../../../../src/trinityal/stub/Tr2BufferALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2BufferALStub.cpp\r\n// Source: trinity/trinityal/stub/Tr2BufferALStub.h\r\n//\r\n// The GPU-free buffer: vertex, index, structured and indirect-argument data.\r\n//\r\n// Unlike the texture, the buffer's storage is the whole point of the type -\r\n// `IsValid` is literally \"the allocation has a size\". A caller maps it, writes\r\n// vertices into it, maps it again and reads them back, all without a device,\r\n// which is what lets a headless frame carry real geometry.\r\n//\r\n// TWO DECISIONS TO KNOW ABOUT.\r\n//\r\n// - A ranged read returns the bytes of THAT RANGE. Carbon's stub validates the\r\n//   range and then hands back the start of the buffer regardless\r\n//   (`Tr2BufferALStub.cpp:96-98`), which is harmless there because its storage\r\n//   is never meaningfully filled. Ours is, so returning the base would hand a\r\n//   caller the wrong bytes; every real backend offsets, and so does this.\r\n// - `UpdateBuffer` VALIDATES AND MOVES NOTHING, exactly as Carbon's stub does.\r\n//   The stub is not a memory model: the map path is what carries data. A caller\r\n//   that needs the write to land must map for writing.\r\n\r\nimport { CjsSchema } from \"#schema\";\r\nimport { Tr2ALMemoryType, Tr2DeviceResourceAL } from \"../Tr2DeviceResourceAL/index.js\";\r\nimport { ALResult } from \"../ALResult.js\";\r\nimport { Tr2BufferDescriptionAL } from \"../Tr2BufferAL/Tr2BufferDescriptionAL.js\";\r\n\r\n// Preserve the existing import path while the declaration lives with its donor header.\r\nexport { Tr2BufferDescriptionAL } from \"../Tr2BufferAL/Tr2BufferDescriptionAL.js\";\r\nimport {\r\n  HasFlag,\r\n  PixelFormat,\r\n  Tr2CpuUsage,\r\n  Tr2GpuUsage\r\n} from \"../../global/consts/renderContext/index.js\";\r\n\r\n\r\n/** Carbon's \"no descriptor heap index\". */\r\nconst NO_HEAP_INDEX = 0xffffffff;\r\n\r\n\r\n/**\r\n * A buffer that holds its bytes on the CPU.\r\n */\r\nexport class Tr2BufferALStub extends Tr2DeviceResourceAL\r\n{\r\n  /** m_desc */\r\n  _desc = new Tr2BufferDescriptionAL();\r\n\r\n  /** m_buffer */\r\n  _buffer = new Uint8Array(0);\r\n\r\n  /**\r\n   * Creates the buffer.\r\n   *\r\n   * @param {Tr2BufferDescriptionAL} desc The buffer description.\r\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\r\n   * @param {object} renderContext The context to create against.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Create(desc, initialData, renderContext)\r\n  {\r\n    this._Reset();\r\n\r\n    if (desc.count === 0) return ALResult.E_INVALIDARG;\r\n\r\n    // Nothing can ever put bytes in it: the same refusal the texture makes,\r\n    // for the same reason.\r\n    if (!HasFlag(desc.cpuUsage, Tr2CpuUsage.WRITE) && !initialData) return ALResult.E_INVALIDARG;\r\n\r\n    if (!renderContext.IsValid()) return ALResult.E_INVALIDCALL;\r\n\r\n    this._desc = desc;\r\n    this._buffer = new Uint8Array(desc.GetSizeInBytes());\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Carbon's impl `Destroy`: empties without unregistering. */\r\n  _Reset()\r\n  {\r\n    this._desc.count = 0;\r\n    this._buffer = new Uint8Array(0);\r\n  }\r\n\r\n  /** Releases the buffer and leaves the device-resource registry. */\r\n  Destroy()\r\n  {\r\n    this._Reset();\r\n    super.Destroy();\r\n  }\r\n\r\n  /**\r\n   * Whether the buffer holds anything.\r\n   *\r\n   * @returns {boolean} True when it has a size.\r\n   */\r\n  IsValid()\r\n  {\r\n    return this._buffer.length > 0;\r\n  }\r\n\r\n  /**\r\n   * Which memory class this buffer occupies.\r\n   *\r\n   * @returns {number} A `Tr2ALMemoryType` value.\r\n   */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\r\n  }\r\n\r\n  /**\r\n   * The buffer description.\r\n   *\r\n   * @returns {Tr2BufferDescriptionAL} The description.\r\n   */\r\n  GetDesc()\r\n  {\r\n    return this._desc;\r\n  }\r\n\r\n\r\n  /**\r\n   * The buffer's size in bytes.\r\n   *\r\n   * Carbon derives it rather than storing it: `GetDesc().count *\r\n   * GetDesc().stride` (`src/Tr2BufferAL.cpp:112-115`). Derived here too, so a\r\n   * description change cannot leave a stale size behind.\r\n   *\r\n   * @returns {number} Bytes.\r\n   */\r\n  GetSize()\r\n  {\r\n    return this._desc.GetSizeInBytes();\r\n  }\r\n\r\n  /**\r\n   * Maps the whole buffer, or a range of it, for reading.\r\n   *\r\n   * @param {object} renderContext The context to map against.\r\n   * @param {number} [offset] Byte offset of the range.\r\n   * @param {number} [size] Bytes in the range; the whole buffer when omitted.\r\n   * @returns {{result: number, data: Uint8Array|null}} The mapping.\r\n   */\r\n  MapForReading(renderContext, offset = 0, size = 0)\r\n  {\r\n    if (!renderContext.IsValid() || !this.IsValid()) return { result: ALResult.E_INVALIDCALL, data: null };\r\n\r\n    const ranged = size !== 0 || offset !== 0;\r\n\r\n    if (ranged && (size === 0 || offset + size > this._desc.GetSizeInBytes()))\r\n    {\r\n      return { result: ALResult.E_INVALIDARG, data: null };\r\n    }\r\n\r\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.READ)) return { result: ALResult.E_INVALIDCALL, data: null };\r\n\r\n    // See the head comment: a range returns its own bytes, not the base.\r\n    const data = ranged ? this._buffer.subarray(offset, offset + size) : this._buffer;\r\n\r\n    return { result: ALResult.S_OK, data };\r\n  }\r\n\r\n  /** Carbon's stub releases nothing on unmap; the storage is the buffer. */\r\n  UnmapForReading()\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Maps the whole buffer for writing.\r\n   *\r\n   * @param {object} renderContext The context to map against.\r\n   * @returns {{result: number, data: Uint8Array|null}} The mapping.\r\n   */\r\n  MapForWriting(renderContext)\r\n  {\r\n    if (!renderContext.IsValid() || !this.IsValid()) return { result: ALResult.E_INVALIDCALL, data: null };\r\n\r\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE)) return { result: ALResult.E_INVALIDCALL, data: null };\r\n\r\n    return { result: ALResult.S_OK, data: this._buffer };\r\n  }\r\n\r\n  /** @see UnmapForReading */\r\n  UnmapForWriting()\r\n  {\r\n  }\r\n\r\n  /**\r\n   * Validates a buffer update. IT MOVES NO BYTES - see the head comment.\r\n   *\r\n   * A buffer mapped often is written through a map, so Carbon refuses\r\n   * `WRITE_OFTEN` here outright.\r\n   *\r\n   * @param {number} offset Byte offset of the range.\r\n   * @param {number} size Bytes in the range.\r\n   * @param {ArrayBufferView} data The bytes.\r\n   * @param {object} renderContext The context to update against.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  UpdateBuffer(offset, size, data, renderContext)\r\n  {\r\n    if (!renderContext.IsValid() || !this.IsValid()) return ALResult.E_INVALIDCALL;\r\n\r\n    if (offset + size > this._desc.GetSizeInBytes()) return ALResult.E_INVALIDARG;\r\n\r\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE) || HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE_OFTEN))\r\n    {\r\n      return ALResult.E_INVALIDCALL;\r\n    }\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * Where the shader-resource view sits in the descriptor heap.\r\n   *\r\n   * @returns {number} Carbon's \"no index\".\r\n   */\r\n  GetSrvIndexInHeap()\r\n  {\r\n    return NO_HEAP_INDEX;\r\n  }\r\n\r\n  /**\r\n   * Where the unordered-access view sits in the descriptor heap.\r\n   *\r\n   * @returns {number} Carbon's \"no index\".\r\n   */\r\n  GetUavIndexInHeap()\r\n  {\r\n    return NO_HEAP_INDEX;\r\n  }\r\n\r\n  /**\r\n   * Names the buffer 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   */\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(Tr2BufferALStub, { className: \"Tr2BufferALStub\", carbon: \"Tr2BufferAL\" });\r\n"],"names":["NO_HEAP_INDEX","Tr2BufferALStub","Tr2DeviceResourceAL","_desc","Tr2BufferDescriptionAL","_buffer","Uint8Array","Create","desc","initialData","renderContext","_Reset","count","ALResult","E_INVALIDARG","HasFlag","cpuUsage","Tr2CpuUsage","WRITE","IsValid","E_INVALIDCALL","GetSizeInBytes","S_OK","Destroy","length","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","GetDesc","GetSize","MapForReading","offset","size","result","data","ranged","READ","subarray","UnmapForReading","MapForWriting","UnmapForWriting","UpdateBuffer","WRITE_OFTEN","GetSrvIndexInHeap","GetUavIndexInHeap","SetName","_name","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/stub/Tr2CapsALStub.js

@@ -1,3 +1,5 @@
+import { CjsSchema } from '#schema';
+
 // Source: trinity/trinityal/stub/Tr2CapsALStub.cpp
 // Source: trinity/trinityal/stub/Tr2CapsALStub.h
 //
@@ -13,6 +15,7 @@
 // to everything would drive Trinity down paths a real device never takes, which
 // is the opposite of what a headless engine carrying correct data is for.
 
+
 /**
  * The platform capability constants (`Tr2CapsALStub.h:10-19`).
  *
@@ -91,5 +94,19 @@ class Tr2CapsALStub {
   }
 }
 
+// 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(Tr2CapsALStub, {
+  className: "Tr2CapsALStub",
+  carbon: "Tr2CapsAL"
+});
+
 export { Tr2CapsALStub, Tr2StubPlatformCaps };
 //# sourceMappingURL=Tr2CapsALStub.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2CapsALStub.js","sources":["../../../../src/trinityal/stub/Tr2CapsALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2CapsALStub.cpp\n// Source: trinity/trinityal/stub/Tr2CapsALStub.h\n//\n// What the GPU-free backend says it can do.\n//\n// Every value here is Carbon's stub answer, and the interesting thing about\n// them is that they are NOT all \"no\". The stub claims float16, vertex-shader\n// textures, compute, texture arrays and a standalone swap chain, and denies\n// GPU buffers, unordered access, buffer shader resources, variable refresh rate\n// and ray tracing - and it declares itself a low-performance platform.\n//\n// That matters because a caller branches on these. A backend that answered \"no\"\n// to everything would drive Trinity down paths a real device never takes, which\n// is the opposite of what a headless engine carrying correct data is for.\n\n/**\n * The platform capability constants (`Tr2CapsALStub.h:10-19`).\n *\n * Carbon spells these as preprocessor defines the compiler folds away; here\n * they are values, because nothing folds them away at build time.\n */\nexport const Tr2StubPlatformCaps = Object.freeze({\n  SUPPORTS_BUFFER_SHADER_RESOURCES: false,\n  SUPPORTS_BUFFER_COUNTERS: false,\n  SUPPORTS_UNORDERED_ACCESS: false,\n  SUPPORTS_COMPUTE: true,\n  SUPPORTS_TEXTURE_ARRAYS: true,\n  SUPPORTS_MSAA_SAMPLE: true,\n  SUPPORTS_RENDER_PASS_HINTS: false,\n  IS_LOW_PERFORMANCE: true,\n  MAX_CONSTANT_BUFFER_SIZE: 4 * 1024,\n  SUPPORTS_RAY_TRACING: false\n});\n\n\n/**\n * The capabilities the stub backend reports.\n */\nexport class Tr2CapsALStub\n{\n  /**\n   * Whether half-precision floats are available.\n   *\n   * @returns {boolean} True.\n   */\n  SupportsFloat16()\n  {\n    return true;\n  }\n\n  /**\n   * Whether a shader can read a buffer resource.\n   *\n   * @returns {boolean} False; the stub has no buffer views.\n   */\n  SupportsGpuBuffer()\n  {\n    return false;\n  }\n\n  /**\n   * Whether a swap chain can exist apart from the device's own.\n   *\n   * @returns {boolean} True.\n   */\n  SupportsStandaloneSwapChain()\n  {\n    return true;\n  }\n\n  /**\n   * Whether a vertex shader can sample a texture.\n   *\n   * @returns {boolean} True.\n   */\n  SupportsVertexShaderTextures()\n  {\n    return true;\n  }\n\n  /**\n   * Whether the display can refresh at a variable rate.\n   *\n   * @returns {boolean} False.\n   */\n  SupportsVariableRefreshRate()\n  {\n    return false;\n  }\n\n  /**\n   * Whether hardware ray tracing is available.\n   *\n   * @returns {boolean} False; Carbon's stub fails every ray-tracing path.\n   */\n  SupportsRaytracing()\n  {\n    return false;\n  }\n}\n"],"names":["Tr2StubPlatformCaps","Object","freeze","SUPPORTS_BUFFER_SHADER_RESOURCES","SUPPORTS_BUFFER_COUNTERS","SUPPORTS_UNORDERED_ACCESS","SUPPORTS_COMPUTE","SUPPORTS_TEXTURE_ARRAYS","SUPPORTS_MSAA_SAMPLE","SUPPORTS_RENDER_PASS_HINTS","IS_LOW_PERFORMANCE","MAX_CONSTANT_BUFFER_SIZE","SUPPORTS_RAY_TRACING","Tr2CapsALStub","SupportsFloat16","SupportsGpuBuffer","SupportsStandaloneSwapChain","SupportsVertexShaderTextures","SupportsVariableRefreshRate","SupportsRaytracing"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;MACaA,mBAAmB,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC/CC,EAAAA,gCAAgC,EAAE,KAAK;AACvCC,EAAAA,wBAAwB,EAAE,KAAK;AAC/BC,EAAAA,yBAAyB,EAAE,KAAK;AAChCC,EAAAA,gBAAgB,EAAE,IAAI;AACtBC,EAAAA,uBAAuB,EAAE,IAAI;AAC7BC,EAAAA,oBAAoB,EAAE,IAAI;AAC1BC,EAAAA,0BAA0B,EAAE,KAAK;AACjCC,EAAAA,kBAAkB,EAAE,IAAI;EACxBC,wBAAwB,EAAE,CAAC,GAAG,IAAI;AAClCC,EAAAA,oBAAoB,EAAE;AACxB,CAAC;;AAGD;AACA;AACA;AACO,MAAMC,aAAa,CAC1B;AACE;AACF;AACA;AACA;AACA;AACEC,EAAAA,eAAeA,GACf;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,iBAAiBA,GACjB;AACE,IAAA,OAAO,KAAK;AACd,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,2BAA2BA,GAC3B;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,4BAA4BA,GAC5B;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,2BAA2BA,GAC3B;AACE,IAAA,OAAO,KAAK;AACd,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,kBAAkBA,GAClB;AACE,IAAA,OAAO,KAAK;AACd,EAAA;AACF;;;;"}
+{"version":3,"file":"Tr2CapsALStub.js","sources":["../../../../src/trinityal/stub/Tr2CapsALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2CapsALStub.cpp\n// Source: trinity/trinityal/stub/Tr2CapsALStub.h\n//\n// What the GPU-free backend says it can do.\n//\n// Every value here is Carbon's stub answer, and the interesting thing about\n// them is that they are NOT all \"no\". The stub claims float16, vertex-shader\n// textures, compute, texture arrays and a standalone swap chain, and denies\n// GPU buffers, unordered access, buffer shader resources, variable refresh rate\n// and ray tracing - and it declares itself a low-performance platform.\n//\n// That matters because a caller branches on these. A backend that answered \"no\"\n// to everything would drive Trinity down paths a real device never takes, which\n// is the opposite of what a headless engine carrying correct data is for.\n\nimport { CjsSchema } from \"#schema\";\n\n/**\n * The platform capability constants (`Tr2CapsALStub.h:10-19`).\n *\n * Carbon spells these as preprocessor defines the compiler folds away; here\n * they are values, because nothing folds them away at build time.\n */\nexport const Tr2StubPlatformCaps = Object.freeze({\n  SUPPORTS_BUFFER_SHADER_RESOURCES: false,\n  SUPPORTS_BUFFER_COUNTERS: false,\n  SUPPORTS_UNORDERED_ACCESS: false,\n  SUPPORTS_COMPUTE: true,\n  SUPPORTS_TEXTURE_ARRAYS: true,\n  SUPPORTS_MSAA_SAMPLE: true,\n  SUPPORTS_RENDER_PASS_HINTS: false,\n  IS_LOW_PERFORMANCE: true,\n  MAX_CONSTANT_BUFFER_SIZE: 4 * 1024,\n  SUPPORTS_RAY_TRACING: false\n});\n\n\n/**\n * The capabilities the stub backend reports.\n */\nexport class Tr2CapsALStub\n{\n  /**\n   * Whether half-precision floats are available.\n   *\n   * @returns {boolean} True.\n   */\n  SupportsFloat16()\n  {\n    return true;\n  }\n\n  /**\n   * Whether a shader can read a buffer resource.\n   *\n   * @returns {boolean} False; the stub has no buffer views.\n   */\n  SupportsGpuBuffer()\n  {\n    return false;\n  }\n\n  /**\n   * Whether a swap chain can exist apart from the device's own.\n   *\n   * @returns {boolean} True.\n   */\n  SupportsStandaloneSwapChain()\n  {\n    return true;\n  }\n\n  /**\n   * Whether a vertex shader can sample a texture.\n   *\n   * @returns {boolean} True.\n   */\n  SupportsVertexShaderTextures()\n  {\n    return true;\n  }\n\n  /**\n   * Whether the display can refresh at a variable rate.\n   *\n   * @returns {boolean} False.\n   */\n  SupportsVariableRefreshRate()\n  {\n    return false;\n  }\n\n  /**\n   * Whether hardware ray tracing is available.\n   *\n   * @returns {boolean} False; Carbon's stub fails every ray-tracing path.\n   */\n  SupportsRaytracing()\n  {\n    return false;\n  }\n}\n\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\n// tests and raw Node cannot parse decorator syntax.\n//\n// The donor is NAMED rather than left to be derived from this class's name.\n// Carbon calls every backend's class the same thing and carries the backend in\n// the FILE name, because only one backend compiles at a time; we ship them\n// together, so the backend moves onto the class name. That divergence is the\n// author's to declare, never a checker's to guess.\nCjsSchema.define(Tr2CapsALStub, { className: \"Tr2CapsALStub\", carbon: \"Tr2CapsAL\" });\n"],"names":["Tr2StubPlatformCaps","Object","freeze","SUPPORTS_BUFFER_SHADER_RESOURCES","SUPPORTS_BUFFER_COUNTERS","SUPPORTS_UNORDERED_ACCESS","SUPPORTS_COMPUTE","SUPPORTS_TEXTURE_ARRAYS","SUPPORTS_MSAA_SAMPLE","SUPPORTS_RENDER_PASS_HINTS","IS_LOW_PERFORMANCE","MAX_CONSTANT_BUFFER_SIZE","SUPPORTS_RAY_TRACING","Tr2CapsALStub","SupportsFloat16","SupportsGpuBuffer","SupportsStandaloneSwapChain","SupportsVertexShaderTextures","SupportsVariableRefreshRate","SupportsRaytracing","CjsSchema","define","className","carbon"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAIA;AACA;AACA;AACA;AACA;AACA;MACaA,mBAAmB,GAAGC,MAAM,CAACC,MAAM,CAAC;AAC/CC,EAAAA,gCAAgC,EAAE,KAAK;AACvCC,EAAAA,wBAAwB,EAAE,KAAK;AAC/BC,EAAAA,yBAAyB,EAAE,KAAK;AAChCC,EAAAA,gBAAgB,EAAE,IAAI;AACtBC,EAAAA,uBAAuB,EAAE,IAAI;AAC7BC,EAAAA,oBAAoB,EAAE,IAAI;AAC1BC,EAAAA,0BAA0B,EAAE,KAAK;AACjCC,EAAAA,kBAAkB,EAAE,IAAI;EACxBC,wBAAwB,EAAE,CAAC,GAAG,IAAI;AAClCC,EAAAA,oBAAoB,EAAE;AACxB,CAAC;;AAGD;AACA;AACA;AACO,MAAMC,aAAa,CAC1B;AACE;AACF;AACA;AACA;AACA;AACEC,EAAAA,eAAeA,GACf;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,iBAAiBA,GACjB;AACE,IAAA,OAAO,KAAK;AACd,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,2BAA2BA,GAC3B;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,4BAA4BA,GAC5B;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,2BAA2BA,GAC3B;AACE,IAAA,OAAO,KAAK;AACd,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,kBAAkBA,GAClB;AACE,IAAA,OAAO,KAAK;AACd,EAAA;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,SAAS,CAACC,MAAM,CAACR,aAAa,EAAE;AAAES,EAAAA,SAAS,EAAE,eAAe;AAAEC,EAAAA,MAAM,EAAE;AAAY,CAAC,CAAC;;;;"}

package/dist/trinityal/stub/Tr2ConstantBufferALStub.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/Tr2ConstantBufferALStub.cpp
@@ -26,25 +28,25 @@ const Tr2ConstantUsageAL = Object.freeze({
   REUSABLE: 2
 });
 
-/**
- * A constant buffer holding its shadow copy on the CPU.
+/**
+ * A constant buffer holding its shadow copy on the CPU.
  */
-class Tr2ConstantBufferALStub extends Tr2BaseDeviceResourceAL {
+class Tr2ConstantBufferALStub extends Tr2DeviceResourceAL {
   /** m_shadowCopy */
   _shadowCopy = new Uint8Array(0);
 
-  /**
-   * Creates the buffer.
-   *
-   * An immutable buffer is written once, at creation - so arriving without
-   * data means it can never hold anything, and Carbon logs and refuses rather
-   * than handing back a buffer of zeroes.
-   *
-   * @param {number} size Size in bytes.
-   * @param {number} usage A `Tr2ConstantUsageAL` value.
-   * @param {ArrayBufferView|null} initialData Initial contents, if any.
-   * @param {object} renderContext The context to create against.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Creates the buffer.
+   *
+   * An immutable buffer is written once, at creation - so arriving without
+   * data means it can never hold anything, and Carbon logs and refuses rather
+   * than handing back a buffer of zeroes.
+   *
+   * @param {number} size Size in bytes.
+   * @param {number} usage A `Tr2ConstantUsageAL` value.
+   * @param {ArrayBufferView|null} initialData Initial contents, if any.
+   * @param {object} renderContext The context to create against.
+   * @returns {number} An `ALResult` value.
    */
   Create(size, usage, initialData, renderContext) {
     if (!renderContext.IsValid()) return ALResult.E_INVALIDARG;
@@ -65,10 +67,10 @@ class Tr2ConstantBufferALStub extends Tr2BaseDeviceResourceAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * Hands back the shadow copy to write into.
-   *
-   * @returns {{result: number, data: Uint8Array|null}} The locked storage.
+  /**
+   * Hands back the shadow copy to write into.
+   *
+   * @returns {{result: number, data: Uint8Array|null}} The locked storage.
    */
   Lock() {
     if (this._shadowCopy.length === 0) return {
@@ -81,10 +83,10 @@ class Tr2ConstantBufferALStub extends Tr2BaseDeviceResourceAL {
     };
   }
 
-  /**
-   * Releases the lock. The storage stays; there is nothing to upload to.
-   *
-   * @returns {number} An `ALResult` value.
+  /**
+   * Releases the lock. The storage stays; there is nothing to upload to.
+   *
+   * @returns {number} An `ALResult` value.
    */
   Unlock() {
     return ALResult.S_OK;
@@ -96,43 +98,57 @@ class Tr2ConstantBufferALStub extends Tr2BaseDeviceResourceAL {
     super.Destroy();
   }
 
-  /**
-   * Whether the buffer holds anything.
-   *
-   * @returns {boolean} True when it has a size.
+  /**
+   * Whether the buffer holds anything.
+   *
+   * @returns {boolean} True when it has a size.
    */
   IsValid() {
     return this._shadowCopy.length !== 0;
   }
 
-  /**
-   * The buffer's size.
-   *
-   * @returns {number} Size in bytes.
+  /**
+   * The buffer's size.
+   *
+   * @returns {number} Size in bytes.
    */
   GetSize() {
     return this._shadowCopy.length;
   }
 
-  /**
-   * Which memory class this buffer occupies.
-   *
-   * @returns {number} A `Tr2ALMemoryType` value.
+  /**
+   * Which memory class this buffer occupies.
+   *
+   * @returns {number} A `Tr2ALMemoryType` value.
    */
   GetMemoryClass() {
     return Tr2ALMemoryType.AL_MEMORY_MANAGED;
   }
 
-  /**
-   * Names the buffer 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.
+  /**
+   * Names the buffer 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.
    */
   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(Tr2ConstantBufferALStub, {
+  className: "Tr2ConstantBufferALStub",
+  carbon: "Tr2ConstantBufferAL"
+});
+
 export { Tr2ConstantBufferALStub, Tr2ConstantUsageAL };
 //# sourceMappingURL=Tr2ConstantBufferALStub.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"Tr2ConstantBufferALStub.js","sources":["../../../../src/trinityal/stub/Tr2ConstantBufferALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2ConstantBufferALStub.cpp\n// Source: trinity/trinityal/stub/Tr2ConstantBufferALStub.h\n// Source: trinity/trinityal/include/Tr2ConstantBufferAL.h\n//\n// The GPU-free constant buffer - the shadow copy behind cb0..cb8.\n//\n// This is the type the per-frame and per-object data actually lands in, so its\n// storage being real is what makes a headless frame inspectable: lock it, write\n// the vec4 registers, unlock, and read the same bytes back.\n//\n// Carbon names the storage `m_shadowCopy` and that is exactly what it is even\n// on a real backend - the CPU-side mirror the driver uploads from. Here there\n// is nothing to upload to, so the mirror is the whole resource.\n\nimport { Tr2ALMemoryType, Tr2BaseDeviceResourceAL } from \"../Tr2DeviceResourceAL.js\";\nimport { ALResult } from \"../ALResult.js\";\n\n\n/** `Tr2ConstantUsageAL` (`Tr2ConstantBufferAL.h:16-24`). */\nexport const Tr2ConstantUsageAL = Object.freeze({\n  /** Written once at creation and never again. */\n  IMMUTABLE: 0,\n\n  /** Written and consumed within one frame. */\n  ONE_SHOT: 1,\n\n  /** Written repeatedly across frames. */\n  REUSABLE: 2\n});\n\n\n/**\n * A constant buffer holding its shadow copy on the CPU.\n */\nexport class Tr2ConstantBufferALStub extends Tr2BaseDeviceResourceAL\n{\n  /** m_shadowCopy */\n  _shadowCopy = new Uint8Array(0);\n\n  /**\n   * Creates the buffer.\n   *\n   * An immutable buffer is written once, at creation - so arriving without\n   * data means it can never hold anything, and Carbon logs and refuses rather\n   * than handing back a buffer of zeroes.\n   *\n   * @param {number} size Size in bytes.\n   * @param {number} usage A `Tr2ConstantUsageAL` value.\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\n   * @param {object} renderContext The context to create against.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(size, usage, initialData, renderContext)\n  {\n    if (!renderContext.IsValid()) return ALResult.E_INVALIDARG;\n\n    if (size === 0) return ALResult.E_INVALIDARG;\n\n    if (usage === Tr2ConstantUsageAL.IMMUTABLE && !initialData) return ALResult.E_INVALIDARG;\n\n    this._shadowCopy = new Uint8Array(size);\n\n    // Carbon's allocation can fail; here only a zero size produces an empty\n    // buffer, and that was already refused above.\n    if (this._shadowCopy.length === 0) return ALResult.E_OUTOFMEMORY;\n\n    // The initial contents land in the shadow, so a buffer created from a\n    // static mirror reads back as that mirror without ever being locked.\n    if (initialData)\n    {\n      const bytes = new Uint8Array(initialData.buffer, initialData.byteOffset, initialData.byteLength);\n\n      this._shadowCopy.set(bytes.subarray(0, Math.min(bytes.length, size)));\n    }\n\n    return ALResult.S_OK;\n  }\n\n  /**\n   * Hands back the shadow copy to write into.\n   *\n   * @returns {{result: number, data: Uint8Array|null}} The locked storage.\n   */\n  Lock()\n  {\n    if (this._shadowCopy.length === 0) return { result: ALResult.E_FAIL, data: null };\n\n    return { result: ALResult.S_OK, data: this._shadowCopy };\n  }\n\n  /**\n   * Releases the lock. The storage stays; there is nothing to upload to.\n   *\n   * @returns {number} An `ALResult` value.\n   */\n  Unlock()\n  {\n    return ALResult.S_OK;\n  }\n\n  /** Releases the shadow copy and leaves the device-resource registry. */\n  Destroy()\n  {\n    this._shadowCopy = new Uint8Array(0);\n    super.Destroy();\n  }\n\n  /**\n   * Whether the buffer holds anything.\n   *\n   * @returns {boolean} True when it has a size.\n   */\n  IsValid()\n  {\n    return this._shadowCopy.length !== 0;\n  }\n\n  /**\n   * The buffer's size.\n   *\n   * @returns {number} Size in bytes.\n   */\n  GetSize()\n  {\n    return this._shadowCopy.length;\n  }\n\n  /**\n   * Which memory class this buffer occupies.\n   *\n   * @returns {number} A `Tr2ALMemoryType` value.\n   */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\n  }\n\n  /**\n   * Names the buffer for a debugger.\n   *\n   * @param {string} _name The name Carbon would attach; the stub discards it.\n   * @returns {number} An `ALResult` value; the stub keeps no name.\n   */\n  SetName(_name)\n  {\n    return ALResult.S_OK;\n  }\n}\n"],"names":["Tr2ConstantUsageAL","Object","freeze","IMMUTABLE","ONE_SHOT","REUSABLE","Tr2ConstantBufferALStub","Tr2BaseDeviceResourceAL","_shadowCopy","Uint8Array","Create","size","usage","initialData","renderContext","IsValid","ALResult","E_INVALIDARG","length","E_OUTOFMEMORY","bytes","buffer","byteOffset","byteLength","set","subarray","Math","min","S_OK","Lock","result","E_FAIL","data","Unlock","Destroy","GetSize","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","SetName","_name"],"mappings":"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"}
+{"version":3,"file":"Tr2ConstantBufferALStub.js","sources":["../../../../src/trinityal/stub/Tr2ConstantBufferALStub.js"],"sourcesContent":["// Source: trinity/trinityal/stub/Tr2ConstantBufferALStub.cpp\r\n// Source: trinity/trinityal/stub/Tr2ConstantBufferALStub.h\r\n// Source: trinity/trinityal/include/Tr2ConstantBufferAL.h\r\n//\r\n// The GPU-free constant buffer - the shadow copy behind cb0..cb8.\r\n//\r\n// This is the type the per-frame and per-object data actually lands in, so its\r\n// storage being real is what makes a headless frame inspectable: lock it, write\r\n// the vec4 registers, unlock, and read the same bytes back.\r\n//\r\n// Carbon names the storage `m_shadowCopy` and that is exactly what it is even\r\n// on a real backend - the CPU-side mirror the driver uploads from. Here there\r\n// is nothing to upload to, so the mirror is the whole resource.\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/** `Tr2ConstantUsageAL` (`Tr2ConstantBufferAL.h:16-24`). */\r\nexport const Tr2ConstantUsageAL = Object.freeze({\r\n  /** Written once at creation and never again. */\r\n  IMMUTABLE: 0,\r\n\r\n  /** Written and consumed within one frame. */\r\n  ONE_SHOT: 1,\r\n\r\n  /** Written repeatedly across frames. */\r\n  REUSABLE: 2\r\n});\r\n\r\n\r\n/**\r\n * A constant buffer holding its shadow copy on the CPU.\r\n */\r\nexport class Tr2ConstantBufferALStub extends Tr2DeviceResourceAL\r\n{\r\n  /** m_shadowCopy */\r\n  _shadowCopy = new Uint8Array(0);\r\n\r\n  /**\r\n   * Creates the buffer.\r\n   *\r\n   * An immutable buffer is written once, at creation - so arriving without\r\n   * data means it can never hold anything, and Carbon logs and refuses rather\r\n   * than handing back a buffer of zeroes.\r\n   *\r\n   * @param {number} size Size in bytes.\r\n   * @param {number} usage A `Tr2ConstantUsageAL` value.\r\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\r\n   * @param {object} renderContext The context to create against.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Create(size, usage, initialData, renderContext)\r\n  {\r\n    if (!renderContext.IsValid()) return ALResult.E_INVALIDARG;\r\n\r\n    if (size === 0) return ALResult.E_INVALIDARG;\r\n\r\n    if (usage === Tr2ConstantUsageAL.IMMUTABLE && !initialData) return ALResult.E_INVALIDARG;\r\n\r\n    this._shadowCopy = new Uint8Array(size);\r\n\r\n    // Carbon's allocation can fail; here only a zero size produces an empty\r\n    // buffer, and that was already refused above.\r\n    if (this._shadowCopy.length === 0) return ALResult.E_OUTOFMEMORY;\r\n\r\n    // The initial contents land in the shadow, so a buffer created from a\r\n    // static mirror reads back as that mirror without ever being locked.\r\n    if (initialData)\r\n    {\r\n      const bytes = new Uint8Array(initialData.buffer, initialData.byteOffset, initialData.byteLength);\r\n\r\n      this._shadowCopy.set(bytes.subarray(0, Math.min(bytes.length, size)));\r\n    }\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * Hands back the shadow copy to write into.\r\n   *\r\n   * @returns {{result: number, data: Uint8Array|null}} The locked storage.\r\n   */\r\n  Lock()\r\n  {\r\n    if (this._shadowCopy.length === 0) return { result: ALResult.E_FAIL, data: null };\r\n\r\n    return { result: ALResult.S_OK, data: this._shadowCopy };\r\n  }\r\n\r\n  /**\r\n   * Releases the lock. The storage stays; there is nothing to upload to.\r\n   *\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Unlock()\r\n  {\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Releases the shadow copy and leaves the device-resource registry. */\r\n  Destroy()\r\n  {\r\n    this._shadowCopy = new Uint8Array(0);\r\n    super.Destroy();\r\n  }\r\n\r\n  /**\r\n   * Whether the buffer holds anything.\r\n   *\r\n   * @returns {boolean} True when it has a size.\r\n   */\r\n  IsValid()\r\n  {\r\n    return this._shadowCopy.length !== 0;\r\n  }\r\n\r\n  /**\r\n   * The buffer's size.\r\n   *\r\n   * @returns {number} Size in bytes.\r\n   */\r\n  GetSize()\r\n  {\r\n    return this._shadowCopy.length;\r\n  }\r\n\r\n  /**\r\n   * Which memory class this buffer occupies.\r\n   *\r\n   * @returns {number} A `Tr2ALMemoryType` value.\r\n   */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\r\n  }\r\n\r\n  /**\r\n   * Names the buffer 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   */\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(Tr2ConstantBufferALStub, { className: \"Tr2ConstantBufferALStub\", carbon: \"Tr2ConstantBufferAL\" });\r\n"],"names":["Tr2ConstantUsageAL","Object","freeze","IMMUTABLE","ONE_SHOT","REUSABLE","Tr2ConstantBufferALStub","Tr2DeviceResourceAL","_shadowCopy","Uint8Array","Create","size","usage","initialData","renderContext","IsValid","ALResult","E_INVALIDARG","length","E_OUTOFMEMORY","bytes","buffer","byteOffset","byteLength","set","subarray","Math","min","S_OK","Lock","result","E_FAIL","data","Unlock","Destroy","GetSize","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","SetName","_name","CjsSchema","define","className","carbon"],"mappings":"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"}