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

package/dist/trinityal/webgpu/CjsWebgpuBufferAL.js

@@ -1,3 +1,4 @@
+import { CjsSchema } from '#schema';
 import { ALResult, Tr2ALMemoryType } from '#trinityal';
 import { HasFlag, Tr2CpuUsage, Tr2GpuUsage } from '#consts/render-context';
 import { RenderContextALOf } from '../renderContextAL.js';
@@ -71,12 +72,12 @@ function gpuBufferUsage(gpuUsage, usage) {
   return mask;
 }
 
-/**
- * A `Tr2BufferAL` backed by a real `GPUBuffer`.
- *
- * It deliberately does NOT extend `Tr2BaseDeviceResourceAL`: that base lives in
- * Trinity and registers into a Trinity-side resource list, and the engine does
- * not import Trinity classes for identity. It implements the same surface.
+/**
+ * A `Tr2BufferAL` backed by a real `GPUBuffer`.
+ *
+ * It deliberately does NOT extend `Tr2BaseDeviceResourceAL`: that base lives in
+ * Trinity and registers into a Trinity-side resource list, and the engine does
+ * not import Trinity classes for identity. It implements the same surface.
  */
 class CjsWebgpuBufferAL {
   /** m_desc */
@@ -94,13 +95,13 @@ class CjsWebgpuBufferAL {
   /** Whether a map is open, so a double map is caught rather than silently nested. */
   _mapped = false;
 
-  /**
-   * Creates the buffer against a device.
-   *
-   * @param {Tr2BufferDescriptionAL} desc The description.
-   * @param {ArrayBufferView|null} initialData Initial contents, if any.
-   * @param {object} renderContext The WebGPU render context AL.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Creates the buffer against a device.
+   *
+   * @param {Tr2BufferDescriptionAL} desc The description.
+   * @param {ArrayBufferView|null} initialData Initial contents, if any.
+   * @param {object} renderContext The WebGPU render context AL.
+   * @returns {number} An `ALResult` value.
    */
   Create(desc, initialData, renderContext) {
     this.Destroy();
@@ -162,14 +163,14 @@ class CjsWebgpuBufferAL {
     return this._handle ? this._webgpu.GetDeviceBuffer(this._handle) : null;
   }
 
-  /**
-   * Opens the buffer for writing, returning the shadow to write into.
-   *
-   * Carbon returns `{ result, data }` from its stub and a raw pointer from the
-   * backends; the stub's shape is the one Trinity callers already read.
-   *
-   * @param {object} _renderContext Unused; the device came from Create.
-   * @returns {{result: number, data: Uint8Array|null}} The shadow.
+  /**
+   * Opens the buffer for writing, returning the shadow to write into.
+   *
+   * Carbon returns `{ result, data }` from its stub and a raw pointer from the
+   * backends; the stub's shape is the one Trinity callers already read.
+   *
+   * @param {object} _renderContext Unused; the device came from Create.
+   * @returns {{result: number, data: Uint8Array|null}} The shadow.
    */
   MapForWriting(_renderContext) {
     if (!this.IsValid()) return {
@@ -194,13 +195,13 @@ class CjsWebgpuBufferAL {
     };
   }
 
-  /**
-   * Closes the map and uploads the whole buffer.
-   *
-   * Uploading everything rather than a dirty range matches all three real
-   * backends: DX11 `UpdateSubresource` on the whole buffer (cpp:400), DX12
-   * `CopyBufferRegion` of `m_size` (Tr2ResourceHelper.cpp:234), Metal a blit of
-   * `m_mtlBuffer.length` (mm:259).
+  /**
+   * Closes the map and uploads the whole buffer.
+   *
+   * Uploading everything rather than a dirty range matches all three real
+   * backends: DX11 `UpdateSubresource` on the whole buffer (cpp:400), DX12
+   * `CopyBufferRegion` of `m_size` (Tr2ResourceHelper.cpp:234), Metal a blit of
+   * `m_mtlBuffer.length` (mm:259).
    */
   UnmapForWriting() {
     if (!this._mapped) return;
@@ -208,21 +209,21 @@ class CjsWebgpuBufferAL {
     this._webgpu.WriteDeviceBuffer(this._handle, this._shadow);
   }
 
-  /**
-   * Writes a range without a map.
-   *
-   * Carbon's stub refuses this for `WRITE_OFTEN` (`Tr2BufferALStub.cpp:138-141`)
-   * and DX12 refuses it for a DYNAMIC buffer (`Tr2ResourceHelper.cpp:253-256`),
-   * both because such a buffer's storage moves under a partial write. Ours does
-   * not move, but the refusal is kept: a caller that reaches here with a
-   * WRITE_OFTEN buffer has confused the two update paths, and every portable
-   * caller uses map/unmap for those.
-   *
-   * @param {number} offset Byte offset of the range.
-   * @param {number} size Bytes in the range.
-   * @param {ArrayBufferView} data The bytes.
-   * @param {object} _renderContext Unused; the device came from Create.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Writes a range without a map.
+   *
+   * Carbon's stub refuses this for `WRITE_OFTEN` (`Tr2BufferALStub.cpp:138-141`)
+   * and DX12 refuses it for a DYNAMIC buffer (`Tr2ResourceHelper.cpp:253-256`),
+   * both because such a buffer's storage moves under a partial write. Ours does
+   * not move, but the refusal is kept: a caller that reaches here with a
+   * WRITE_OFTEN buffer has confused the two update paths, and every portable
+   * caller uses map/unmap for those.
+   *
+   * @param {number} offset Byte offset of the range.
+   * @param {number} size Bytes in the range.
+   * @param {ArrayBufferView} data The bytes.
+   * @param {object} _renderContext Unused; the device came from Create.
+   * @returns {number} An `ALResult` value.
    */
   UpdateBuffer(offset, size, data, _renderContext) {
     if (!this.IsValid()) return ALResult.E_INVALIDCALL;
@@ -271,42 +272,42 @@ class CjsWebgpuBufferAL {
   /** @see MapForReading */
   UnmapForReading() {}
 
-  /**
-   * The buffer's size in bytes, under Carbon's name for the question.
-   *
-   * `GetSizeInBytes` above is this backend's own spelling and predates the
-   * parity check. Both stay: the stub answers to `GetSize`
-   * (`stub/Tr2BufferALStub.js`), so a caller written against one backend must
-   * not fail against the other.
-   *
-   * @returns {number} Size in bytes.
+  /**
+   * The buffer's size in bytes, under Carbon's name for the question.
+   *
+   * `GetSizeInBytes` above is this backend's own spelling and predates the
+   * parity check. Both stay: the stub answers to `GetSize`
+   * (`stub/Tr2BufferALStub.js`), so a caller written against one backend must
+   * not fail against the other.
+   *
+   * @returns {number} Size in bytes.
    */
   GetSize() {
     return this.GetSizeInBytes();
   }
 
-  /**
-   * Which memory class this buffer occupies.
-   *
-   * MANAGED, as the stub buffer reports: WebGPU gives no placement control and
-   * no residency signal, so the honest answer is the device-heap default rather
-   * than a claim about video memory.
-   *
-   * @returns {number} A `Tr2ALMemoryType` value.
+  /**
+   * Which memory class this buffer occupies.
+   *
+   * MANAGED, as the stub buffer reports: WebGPU gives no placement control and
+   * no residency signal, so the honest answer is the device-heap default rather
+   * than a claim about video memory.
+   *
+   * @returns {number} A `Tr2ALMemoryType` value.
    */
   GetMemoryClass() {
     return Tr2ALMemoryType.AL_MEMORY_MANAGED;
   }
 
-  /**
-   * Fills in a device-resource description.
-   *
-   * Carbon's backends report size and memory class into the struct the resource
-   * sweep walks; the base class's own version is empty
-   * (`Tr2DeviceResourceAL.js`), and so is the stub's.
-   *
-   * @param {object} description The description to fill.
-   * @returns {object} The description, filled.
+  /**
+   * Fills in a device-resource description.
+   *
+   * Carbon's backends report size and memory class into the struct the resource
+   * sweep walks; the base class's own version is empty
+   * (`Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js`), and so is the stub's.
+   *
+   * @param {object} description The description to fill.
+   * @returns {object} The description, filled.
    */
   Describe(description) {
     if (!description) return description;
@@ -315,14 +316,14 @@ class CjsWebgpuBufferAL {
     return description;
   }
 
-  /**
-   * Names the buffer for a debugger.
-   *
-   * `GPUObjectBase.label` is writable after creation, so unlike the stub this
-   * one keeps the name where the browser's own error messages will quote it.
-   *
-   * @param {string} name The name to attach.
-   * @returns {number} An `ALResult` value.
+  /**
+   * Names the buffer for a debugger.
+   *
+   * `GPUObjectBase.label` is writable after creation, so unlike the stub this
+   * one keeps the name where the browser's own error messages will quote it.
+   *
+   * @param {string} name The name to attach.
+   * @returns {number} An `ALResult` value.
    */
   SetName(name) {
     const buffer = this.GetDeviceBuffer();
@@ -330,29 +331,43 @@ class CjsWebgpuBufferAL {
     return ALResult.S_OK;
   }
 
-  /**
-   * The buffer's index in a shader-resource descriptor heap.
-   *
-   * WebGPU HAS NO DESCRIPTOR HEAP - a resource is reached through a bind group,
-   * not by index into a global table - so this reports Carbon's "not in a heap"
-   * sentinel, as the stub does. It is not a gap to be filled later; there is
-   * nothing for it to number.
-   *
-   * @returns {number} `NO_HEAP_INDEX`.
+  /**
+   * The buffer's index in a shader-resource descriptor heap.
+   *
+   * WebGPU HAS NO DESCRIPTOR HEAP - a resource is reached through a bind group,
+   * not by index into a global table - so this reports Carbon's "not in a heap"
+   * sentinel, as the stub does. It is not a gap to be filled later; there is
+   * nothing for it to number.
+   *
+   * @returns {number} `NO_HEAP_INDEX`.
    */
   GetSrvIndexInHeap() {
     return NO_HEAP_INDEX;
   }
 
-  /**
-   * The buffer's index in an unordered-access descriptor heap.
-   *
-   * @returns {number} `NO_HEAP_INDEX`; see `GetSrvIndexInHeap`.
+  /**
+   * The buffer's index in an unordered-access descriptor heap.
+   *
+   * @returns {number} `NO_HEAP_INDEX`; see `GetSrvIndexInHeap`.
    */
   GetUavIndexInHeap() {
     return NO_HEAP_INDEX;
   }
 }
 
+// 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(CjsWebgpuBufferAL, {
+  className: "CjsWebgpuBufferAL",
+  carbon: "Tr2BufferAL"
+});
+
 export { CjsWebgpuBufferAL };
 //# sourceMappingURL=CjsWebgpuBufferAL.js.map

package/dist/trinityal/webgpu/CjsWebgpuBufferAL.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWebgpuBufferAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuBufferAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2BufferAL.h\n//   trinity/trinityal/dx11/Tr2BufferALDx11.cpp\n//   trinity/trinityal/metal/Tr2BufferALMetal.mm\n//\n// A device-backed `Tr2BufferAL` for WebGPU. The first one: until now the only\n// buffer implementation was `Tr2BufferALStub`, a `Uint8Array` that reaches no\n// device, so a Trinity class that fills a buffer every frame - `Tr2Blitter`'s\n// screen quad, `Tr2RingBuffer`'s upload arena - could be written and would\n// silently draw nothing.\n//\n// WHICH BACKEND THIS IMITATES, AND WHY IT MATTERS.\n//\n// Carbon has two families of MapForWriting. DX11 with WRITE_OFTEN and Metal\n// with NON_SYNCRONIZED_WRITE hand back a pointer into GPU-visible memory and\n// let the driver (or an engine-side pool) RENAME the underlying allocation on\n// unmap, so a second map in the same frame gets fresh storage and previously\n// recorded draws keep the bytes they were given. DX11 plain WRITE, DX12\n// STATIC and Metal plain WRITE instead hand back a CPU scratch and upload the\n// whole buffer on unmap.\n//\n// This is the second family, because it is the one WebGPU can express.\n// `queue.writeBuffer` is already ordered on the queue, so the upload lands\n// before any subsequently submitted draw reads it - which gives the guarantee\n// the renaming backends buy with renaming, without needing to rename.\n//\n// The shadow is RETAINED, not reallocated per map - which is DX11's behaviour\n// specifically, not the family's. DX11 allocates `m_writeLockMemory` once and\n// only if empty (`Tr2BufferALDx11.cpp:357-363`), so it survives across maps.\n// DX12 STATIC calls CreateScratch on every map (`Tr2ResourceHelper.cpp:192`)\n// and Metal plain WRITE makes a fresh MTLBuffer (`Tr2BufferALMetal.mm:233-237`)\n// - both hand back UNINITIALISED scratch, which is only safe because on those\n// backends plain-WRITE UpdateBuffer never goes through map/unmap at all.\n// Retaining is what makes a partial update correct here, since our shadow is\n// the authoritative copy between maps.\n//\n// CORRECTED 2026-09-08: this note previously cited dx11:419-429 and\n// metal:293-302 as showing bytes outside a memcpy range surviving. Those lines\n// are the WRITE_OFTEN arm, not the plain-WRITE arm this class imitates, and\n// under WRITE_DISCARD DX11 does not preserve them either. The plain-WRITE arms\n// are dx11:431-433 and metal:302-306. The decision was right; the citation\n// pointed at a branch that did not demonstrate it.\n//\n// NOT IMPLEMENTED: MapForReading. Reading a buffer back needs MAP_READ, a\n// separate staging buffer and an await, and nothing asks for it yet. It\n// refuses by name rather than returning empty bytes.\n//\n// THREE OF CARBON'S BUFFER METHODS ARE NOT HERE, AND SHOULD NOT BE.\n// `GetGpuResource` (DX) and `GetMetalBuffer` (Metal) are the SAME accessor\n// under each backend's own name for its native object; ours is\n// `GetDeviceBuffer`, which is that name for WebGPU. `CreateStagingBuffer` is\n// declared only by DX11, and PRIVATE there (`Tr2BufferALDx11.h:43`) - it is an\n// implementation detail of that backend's upload path, not part of the\n// contract, and neither dx12, metal nor the stub has it.\nimport { ALResult, Tr2ALMemoryType } from \"#trinityal\";\nimport { Tr2CpuUsage, Tr2GpuUsage, HasFlag } from \"#consts/render-context\";\nimport { RenderContextALOf } from \"../renderContextAL.js\";\n\n\n/** Carbon's \"no descriptor heap index\", as the stub buffer spells it. */\nconst NO_HEAP_INDEX = 0xffffffff;\n\n\n/** Carbon's usage flags mapped onto `GPUBufferUsage`. */\nfunction gpuBufferUsage(gpuUsage, usage)\n{\n  let mask = 0;\n\n  if (HasFlag(gpuUsage, Tr2GpuUsage.VERTEX_BUFFER)) mask |= usage.VERTEX;\n  if (HasFlag(gpuUsage, Tr2GpuUsage.INDEX_BUFFER)) mask |= usage.INDEX;\n  if (HasFlag(gpuUsage, Tr2GpuUsage.SHADER_RESOURCE)) mask |= usage.STORAGE;\n  if (HasFlag(gpuUsage, Tr2GpuUsage.UNORDERED_ACCESS)) mask |= usage.STORAGE;\n  if (HasFlag(gpuUsage, Tr2GpuUsage.DRAW_INDIRECT_ARGS)) mask |= usage.INDIRECT;\n  if (HasFlag(gpuUsage, Tr2GpuUsage.COPY_DESTINATION)) mask |= usage.COPY_DST;\n\n  return mask;\n}\n\n\n/**\n * A `Tr2BufferAL` backed by a real `GPUBuffer`.\n *\n * It deliberately does NOT extend `Tr2BaseDeviceResourceAL`: that base lives in\n * Trinity and registers into a Trinity-side resource list, and the engine does\n * not import Trinity classes for identity. It implements the same surface.\n */\nexport class CjsWebgpuBufferAL\n{\n  /** m_desc */\n  _desc = null;\n\n  /** The device that owns the buffer, for writes and destruction. */\n  _webgpu = null;\n\n  /** The opaque `CreateDeviceBuffer` handle. */\n  _handle = null;\n\n  /** The retained CPU shadow; see the head comment on why it is retained. */\n  _shadow = null;\n\n  /** Whether a map is open, so a double map is caught rather than silently nested. */\n  _mapped = false;\n\n  /**\n   * Creates the buffer against a device.\n   *\n   * @param {Tr2BufferDescriptionAL} desc The description.\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\n   * @param {object} renderContext The WebGPU render context AL.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(desc, initialData, renderContext)\n  {\n    this.Destroy();\n\n    if (!desc || desc.count === 0) return ALResult.E_INVALIDARG;\n\n    // Carbon's immutability rule (dx11:48-52, dx12:45, metal:47-52): a buffer\n    // the CPU can never write must arrive with its contents, or nothing can\n    // ever put bytes in it.\n    const writable = HasFlag(desc.cpuUsage, Tr2CpuUsage.WRITE)\n      || HasFlag(desc.gpuUsage, Tr2GpuUsage.UNORDERED_ACCESS);\n\n    if (!writable && !initialData) return ALResult.E_INVALIDARG;\n\n    // DX12 refuses this pair outright (Tr2BufferALDx12.cpp:51-54) and we have\n    // no read path at all, so refusing is both faithful and honest.\n    if (HasFlag(desc.cpuUsage, Tr2CpuUsage.READ)) return ALResult.E_INVALIDARG;\n\n    // Trinity hands its own context, as Carbon's upcast lets it (`Tr2RingBuffer`,\n    // `Tr2GpuResourcePool`); the AL behind it is what creates.\n    const al = RenderContextALOf(renderContext);\n\n    if (!al || !al.IsValid()) return ALResult.E_INVALIDCALL;\n\n    const webgpu = al.GetWebgpu();\n    if (!webgpu) return ALResult.E_INVALIDCALL;\n\n    const size = desc.GetSizeInBytes();\n    if (size === 0) return ALResult.E_INVALIDARG;\n\n    const mask = gpuBufferUsage(desc.gpuUsage, webgpu.GetBufferUsage());\n    if (mask === 0) return ALResult.E_INVALIDARG;\n\n    this._handle = webgpu.CreateDeviceBuffer({ label: desc.label ?? \"Tr2BufferAL\", size, usage: mask });\n    this._webgpu = webgpu;\n    this._desc = desc;\n    this._shadow = new Uint8Array(this._handle.size);\n\n    if (initialData)\n    {\n      const bytes = new Uint8Array(initialData.buffer, initialData.byteOffset, initialData.byteLength);\n      this._shadow.set(bytes.subarray(0, Math.min(bytes.length, this._shadow.length)));\n      webgpu.WriteDeviceBuffer(this._handle, this._shadow);\n    }\n\n    return ALResult.S_OK;\n  }\n\n  /** Whether the buffer holds anything. */\n  IsValid()\n  {\n    return this._handle !== null;\n  }\n\n  /** The description this buffer was created from, or null. */\n  GetDesc()\n  {\n    return this._desc;\n  }\n\n  /** The buffer's size in bytes, as the description gives it. */\n  GetSizeInBytes()\n  {\n    return this._desc ? this._desc.GetSizeInBytes() : 0;\n  }\n\n  /** The `GPUBuffer`, for binding it to a draw. */\n  GetDeviceBuffer()\n  {\n    return this._handle ? this._webgpu.GetDeviceBuffer(this._handle) : null;\n  }\n\n  /**\n   * Opens the buffer for writing, returning the shadow to write into.\n   *\n   * Carbon returns `{ result, data }` from its stub and a raw pointer from the\n   * backends; the stub's shape is the one Trinity callers already read.\n   *\n   * @param {object} _renderContext Unused; the device came from Create.\n   * @returns {{result: number, data: Uint8Array|null}} The shadow.\n   */\n  MapForWriting(_renderContext)\n  {\n    if (!this.IsValid()) return { result: ALResult.E_INVALIDCALL, data: null };\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE)) return { result: ALResult.E_INVALIDCALL, data: null };\n\n    // Every backend permits a second map; none permits a NESTED one, and a\n    // nested map here would upload twice and hide which write won.\n    if (this._mapped) return { result: ALResult.E_INVALIDCALL, data: null };\n\n    this._mapped = true;\n\n    return { result: ALResult.S_OK, data: this._shadow };\n  }\n\n  /**\n   * Closes the map and uploads the whole buffer.\n   *\n   * Uploading everything rather than a dirty range matches all three real\n   * backends: DX11 `UpdateSubresource` on the whole buffer (cpp:400), DX12\n   * `CopyBufferRegion` of `m_size` (Tr2ResourceHelper.cpp:234), Metal a blit of\n   * `m_mtlBuffer.length` (mm:259).\n   */\n  UnmapForWriting()\n  {\n    if (!this._mapped) return;\n\n    this._mapped = false;\n    this._webgpu.WriteDeviceBuffer(this._handle, this._shadow);\n  }\n\n  /**\n   * Writes a range without a map.\n   *\n   * Carbon's stub refuses this for `WRITE_OFTEN` (`Tr2BufferALStub.cpp:138-141`)\n   * and DX12 refuses it for a DYNAMIC buffer (`Tr2ResourceHelper.cpp:253-256`),\n   * both because such a buffer's storage moves under a partial write. Ours does\n   * not move, but the refusal is kept: a caller that reaches here with a\n   * WRITE_OFTEN buffer has confused the two update paths, and every portable\n   * caller uses map/unmap for those.\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 Unused; the device came from Create.\n   * @returns {number} An `ALResult` value.\n   */\n  UpdateBuffer(offset, size, data, _renderContext)\n  {\n    if (!this.IsValid()) return ALResult.E_INVALIDCALL;\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE)) return ALResult.E_INVALIDCALL;\n    if (HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE_OFTEN)) return ALResult.E_INVALIDCALL;\n    if (!data) return ALResult.E_INVALIDARG;\n    if (offset < 0 || size < 0 || offset + size > this._shadow.length) return ALResult.E_INVALIDARG;\n\n    const bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\n\n    this._shadow.set(bytes.subarray(0, size), offset);\n\n    // Upload the RANGE, as every Carbon backend does for plain WRITE - DX11 a\n    // D3D11_BOX (`Tr2BufferALDx11.cpp:431-433`), Metal a size-byte staging copy\n    // (`Tr2BufferALMetal.mm:302-306`), DX12 a CopyBufferRegion of size at offset\n    // (`Tr2ResourceHelper.cpp:258-266`). This used to write the whole shadow,\n    // which was correct but paid the full buffer on every partial update.\n    //\n    // Widened outward to four-byte bounds because `queue.writeBuffer` requires\n    // that alignment and D3D11_BOX does not. Widening is safe here and only\n    // here: the shadow is RETAINED and authoritative, so the extra bytes on\n    // each side are the same ones already on the device. The buffer size is\n    // aligned at creation, so the widened end never runs past it.\n    const start = offset & ~3;\n    const end = Math.min((offset + size + 3) & ~3, this._shadow.length);\n\n    this._webgpu.WriteDeviceBuffer(this._handle, this._shadow.subarray(start, end), start);\n\n    return ALResult.S_OK;\n  }\n\n  /** Releases the GPU buffer and the shadow. */\n  Destroy()\n  {\n    if (this._handle) this._handle.Destroy();\n\n    this._handle = null;\n    this._webgpu = null;\n    this._desc = null;\n    this._shadow = null;\n    this._mapped = false;\n  }\n\n  /** REFUSED: reading back needs MAP_READ, a staging buffer and an await. */\n  MapForReading()\n  {\n    return { result: ALResult.E_INVALIDCALL, data: null };\n  }\n\n  /** @see MapForReading */\n  UnmapForReading()\n  {\n  }\n\n  /**\n   * The buffer's size in bytes, under Carbon's name for the question.\n   *\n   * `GetSizeInBytes` above is this backend's own spelling and predates the\n   * parity check. Both stay: the stub answers to `GetSize`\n   * (`stub/Tr2BufferALStub.js`), so a caller written against one backend must\n   * not fail against the other.\n   *\n   * @returns {number} Size in bytes.\n   */\n  GetSize()\n  {\n    return this.GetSizeInBytes();\n  }\n\n  /**\n   * Which memory class this buffer occupies.\n   *\n   * MANAGED, as the stub buffer reports: WebGPU gives no placement control and\n   * no residency signal, so the honest answer is the device-heap default rather\n   * than a claim about video memory.\n   *\n   * @returns {number} A `Tr2ALMemoryType` value.\n   */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\n  }\n\n  /**\n   * Fills in a device-resource description.\n   *\n   * Carbon's backends report size and memory class into the struct the resource\n   * sweep walks; the base class's own version is empty\n   * (`Tr2DeviceResourceAL.js`), and so is the stub's.\n   *\n   * @param {object} description The description to fill.\n   * @returns {object} The description, filled.\n   */\n  Describe(description)\n  {\n    if (!description) return description;\n\n    description.sizeInBytes = this.GetSize();\n    description.memoryClass = this.GetMemoryClass();\n\n    return description;\n  }\n\n  /**\n   * Names the buffer for a debugger.\n   *\n   * `GPUObjectBase.label` is writable after creation, so unlike the stub this\n   * one keeps the name where the browser's own error messages will quote it.\n   *\n   * @param {string} name The name to attach.\n   * @returns {number} An `ALResult` value.\n   */\n  SetName(name)\n  {\n    const buffer = this.GetDeviceBuffer();\n\n    if (buffer) buffer.label = String(name);\n\n    return ALResult.S_OK;\n  }\n\n  /**\n   * The buffer's index in a shader-resource descriptor heap.\n   *\n   * WebGPU HAS NO DESCRIPTOR HEAP - a resource is reached through a bind group,\n   * not by index into a global table - so this reports Carbon's \"not in a heap\"\n   * sentinel, as the stub does. It is not a gap to be filled later; there is\n   * nothing for it to number.\n   *\n   * @returns {number} `NO_HEAP_INDEX`.\n   */\n  GetSrvIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n\n  /**\n   * The buffer's index in an unordered-access descriptor heap.\n   *\n   * @returns {number} `NO_HEAP_INDEX`; see `GetSrvIndexInHeap`.\n   */\n  GetUavIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n}\n"],"names":["NO_HEAP_INDEX","gpuBufferUsage","gpuUsage","usage","mask","HasFlag","Tr2GpuUsage","VERTEX_BUFFER","VERTEX","INDEX_BUFFER","INDEX","SHADER_RESOURCE","STORAGE","UNORDERED_ACCESS","DRAW_INDIRECT_ARGS","INDIRECT","COPY_DESTINATION","COPY_DST","CjsWebgpuBufferAL","_desc","_webgpu","_handle","_shadow","_mapped","Create","desc","initialData","renderContext","Destroy","count","ALResult","E_INVALIDARG","writable","cpuUsage","Tr2CpuUsage","WRITE","READ","al","RenderContextALOf","IsValid","E_INVALIDCALL","webgpu","GetWebgpu","size","GetSizeInBytes","GetBufferUsage","CreateDeviceBuffer","label","Uint8Array","bytes","buffer","byteOffset","byteLength","set","subarray","Math","min","length","WriteDeviceBuffer","S_OK","GetDesc","GetDeviceBuffer","MapForWriting","_renderContext","result","data","UnmapForWriting","UpdateBuffer","offset","WRITE_OFTEN","start","end","MapForReading","UnmapForReading","GetSize","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","Describe","description","sizeInBytes","memoryClass","SetName","name","String","GetSrvIndexInHeap","GetUavIndexInHeap"],"mappings":"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"}
+{"version":3,"file":"CjsWebgpuBufferAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuBufferAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2BufferAL.h\r\n//   trinity/trinityal/dx11/Tr2BufferALDx11.cpp\r\n//   trinity/trinityal/metal/Tr2BufferALMetal.mm\r\n//\r\n// A device-backed `Tr2BufferAL` for WebGPU. The first one: until now the only\r\n// buffer implementation was `Tr2BufferALStub`, a `Uint8Array` that reaches no\r\n// device, so a Trinity class that fills a buffer every frame - `Tr2Blitter`'s\r\n// screen quad, `Tr2RingBuffer`'s upload arena - could be written and would\r\n// silently draw nothing.\r\n//\r\n// WHICH BACKEND THIS IMITATES, AND WHY IT MATTERS.\r\n//\r\n// Carbon has two families of MapForWriting. DX11 with WRITE_OFTEN and Metal\r\n// with NON_SYNCRONIZED_WRITE hand back a pointer into GPU-visible memory and\r\n// let the driver (or an engine-side pool) RENAME the underlying allocation on\r\n// unmap, so a second map in the same frame gets fresh storage and previously\r\n// recorded draws keep the bytes they were given. DX11 plain WRITE, DX12\r\n// STATIC and Metal plain WRITE instead hand back a CPU scratch and upload the\r\n// whole buffer on unmap.\r\n//\r\n// This is the second family, because it is the one WebGPU can express.\r\n// `queue.writeBuffer` is already ordered on the queue, so the upload lands\r\n// before any subsequently submitted draw reads it - which gives the guarantee\r\n// the renaming backends buy with renaming, without needing to rename.\r\n//\r\n// The shadow is RETAINED, not reallocated per map - which is DX11's behaviour\r\n// specifically, not the family's. DX11 allocates `m_writeLockMemory` once and\r\n// only if empty (`Tr2BufferALDx11.cpp:357-363`), so it survives across maps.\r\n// DX12 STATIC calls CreateScratch on every map (`Tr2ResourceHelper.cpp:192`)\r\n// and Metal plain WRITE makes a fresh MTLBuffer (`Tr2BufferALMetal.mm:233-237`)\r\n// - both hand back UNINITIALISED scratch, which is only safe because on those\r\n// backends plain-WRITE UpdateBuffer never goes through map/unmap at all.\r\n// Retaining is what makes a partial update correct here, since our shadow is\r\n// the authoritative copy between maps.\r\n//\r\n// CORRECTED 2026-09-08: this note previously cited dx11:419-429 and\r\n// metal:293-302 as showing bytes outside a memcpy range surviving. Those lines\r\n// are the WRITE_OFTEN arm, not the plain-WRITE arm this class imitates, and\r\n// under WRITE_DISCARD DX11 does not preserve them either. The plain-WRITE arms\r\n// are dx11:431-433 and metal:302-306. The decision was right; the citation\r\n// pointed at a branch that did not demonstrate it.\r\n//\r\n// NOT IMPLEMENTED: MapForReading. Reading a buffer back needs MAP_READ, a\r\n// separate staging buffer and an await, and nothing asks for it yet. It\r\n// refuses by name rather than returning empty bytes.\r\n//\r\n// THREE OF CARBON'S BUFFER METHODS ARE NOT HERE, AND SHOULD NOT BE.\r\n// `GetGpuResource` (DX) and `GetMetalBuffer` (Metal) are the SAME accessor\r\n// under each backend's own name for its native object; ours is\r\n// `GetDeviceBuffer`, which is that name for WebGPU. `CreateStagingBuffer` is\r\n// declared only by DX11, and PRIVATE there (`Tr2BufferALDx11.h:43`) - it is an\r\n// implementation detail of that backend's upload path, not part of the\r\n// contract, and neither dx12, metal nor the stub has it.\r\nimport { CjsSchema } from \"#schema\";\r\nimport { ALResult, Tr2ALMemoryType } from \"#trinityal\";\r\nimport { Tr2CpuUsage, Tr2GpuUsage, HasFlag } from \"#consts/render-context\";\r\nimport { RenderContextALOf } from \"../renderContextAL.js\";\r\n\r\n\r\n/** Carbon's \"no descriptor heap index\", as the stub buffer spells it. */\r\nconst NO_HEAP_INDEX = 0xffffffff;\r\n\r\n\r\n/** Carbon's usage flags mapped onto `GPUBufferUsage`. */\r\nfunction gpuBufferUsage(gpuUsage, usage)\r\n{\r\n  let mask = 0;\r\n\r\n  if (HasFlag(gpuUsage, Tr2GpuUsage.VERTEX_BUFFER)) mask |= usage.VERTEX;\r\n  if (HasFlag(gpuUsage, Tr2GpuUsage.INDEX_BUFFER)) mask |= usage.INDEX;\r\n  if (HasFlag(gpuUsage, Tr2GpuUsage.SHADER_RESOURCE)) mask |= usage.STORAGE;\r\n  if (HasFlag(gpuUsage, Tr2GpuUsage.UNORDERED_ACCESS)) mask |= usage.STORAGE;\r\n  if (HasFlag(gpuUsage, Tr2GpuUsage.DRAW_INDIRECT_ARGS)) mask |= usage.INDIRECT;\r\n  if (HasFlag(gpuUsage, Tr2GpuUsage.COPY_DESTINATION)) mask |= usage.COPY_DST;\r\n\r\n  return mask;\r\n}\r\n\r\n\r\n/**\r\n * A `Tr2BufferAL` backed by a real `GPUBuffer`.\r\n *\r\n * It deliberately does NOT extend `Tr2BaseDeviceResourceAL`: that base lives in\r\n * Trinity and registers into a Trinity-side resource list, and the engine does\r\n * not import Trinity classes for identity. It implements the same surface.\r\n */\r\nexport class CjsWebgpuBufferAL\r\n{\r\n  /** m_desc */\r\n  _desc = null;\r\n\r\n  /** The device that owns the buffer, for writes and destruction. */\r\n  _webgpu = null;\r\n\r\n  /** The opaque `CreateDeviceBuffer` handle. */\r\n  _handle = null;\r\n\r\n  /** The retained CPU shadow; see the head comment on why it is retained. */\r\n  _shadow = null;\r\n\r\n  /** Whether a map is open, so a double map is caught rather than silently nested. */\r\n  _mapped = false;\r\n\r\n  /**\r\n   * Creates the buffer against a device.\r\n   *\r\n   * @param {Tr2BufferDescriptionAL} desc The description.\r\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\r\n   * @param {object} renderContext The WebGPU render context AL.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Create(desc, initialData, renderContext)\r\n  {\r\n    this.Destroy();\r\n\r\n    if (!desc || desc.count === 0) return ALResult.E_INVALIDARG;\r\n\r\n    // Carbon's immutability rule (dx11:48-52, dx12:45, metal:47-52): a buffer\r\n    // the CPU can never write must arrive with its contents, or nothing can\r\n    // ever put bytes in it.\r\n    const writable = HasFlag(desc.cpuUsage, Tr2CpuUsage.WRITE)\r\n      || HasFlag(desc.gpuUsage, Tr2GpuUsage.UNORDERED_ACCESS);\r\n\r\n    if (!writable && !initialData) return ALResult.E_INVALIDARG;\r\n\r\n    // DX12 refuses this pair outright (Tr2BufferALDx12.cpp:51-54) and we have\r\n    // no read path at all, so refusing is both faithful and honest.\r\n    if (HasFlag(desc.cpuUsage, Tr2CpuUsage.READ)) return ALResult.E_INVALIDARG;\r\n\r\n    // Trinity hands its own context, as Carbon's upcast lets it (`Tr2RingBuffer`,\r\n    // `Tr2GpuResourcePool`); the AL behind it is what creates.\r\n    const al = RenderContextALOf(renderContext);\r\n\r\n    if (!al || !al.IsValid()) return ALResult.E_INVALIDCALL;\r\n\r\n    const webgpu = al.GetWebgpu();\r\n    if (!webgpu) return ALResult.E_INVALIDCALL;\r\n\r\n    const size = desc.GetSizeInBytes();\r\n    if (size === 0) return ALResult.E_INVALIDARG;\r\n\r\n    const mask = gpuBufferUsage(desc.gpuUsage, webgpu.GetBufferUsage());\r\n    if (mask === 0) return ALResult.E_INVALIDARG;\r\n\r\n    this._handle = webgpu.CreateDeviceBuffer({ label: desc.label ?? \"Tr2BufferAL\", size, usage: mask });\r\n    this._webgpu = webgpu;\r\n    this._desc = desc;\r\n    this._shadow = new Uint8Array(this._handle.size);\r\n\r\n    if (initialData)\r\n    {\r\n      const bytes = new Uint8Array(initialData.buffer, initialData.byteOffset, initialData.byteLength);\r\n      this._shadow.set(bytes.subarray(0, Math.min(bytes.length, this._shadow.length)));\r\n      webgpu.WriteDeviceBuffer(this._handle, this._shadow);\r\n    }\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Whether the buffer holds anything. */\r\n  IsValid()\r\n  {\r\n    return this._handle !== null;\r\n  }\r\n\r\n  /** The description this buffer was created from, or null. */\r\n  GetDesc()\r\n  {\r\n    return this._desc;\r\n  }\r\n\r\n  /** The buffer's size in bytes, as the description gives it. */\r\n  GetSizeInBytes()\r\n  {\r\n    return this._desc ? this._desc.GetSizeInBytes() : 0;\r\n  }\r\n\r\n  /** The `GPUBuffer`, for binding it to a draw. */\r\n  GetDeviceBuffer()\r\n  {\r\n    return this._handle ? this._webgpu.GetDeviceBuffer(this._handle) : null;\r\n  }\r\n\r\n  /**\r\n   * Opens the buffer for writing, returning the shadow to write into.\r\n   *\r\n   * Carbon returns `{ result, data }` from its stub and a raw pointer from the\r\n   * backends; the stub's shape is the one Trinity callers already read.\r\n   *\r\n   * @param {object} _renderContext Unused; the device came from Create.\r\n   * @returns {{result: number, data: Uint8Array|null}} The shadow.\r\n   */\r\n  MapForWriting(_renderContext)\r\n  {\r\n    if (!this.IsValid()) return { result: ALResult.E_INVALIDCALL, data: null };\r\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE)) return { result: ALResult.E_INVALIDCALL, data: null };\r\n\r\n    // Every backend permits a second map; none permits a NESTED one, and a\r\n    // nested map here would upload twice and hide which write won.\r\n    if (this._mapped) return { result: ALResult.E_INVALIDCALL, data: null };\r\n\r\n    this._mapped = true;\r\n\r\n    return { result: ALResult.S_OK, data: this._shadow };\r\n  }\r\n\r\n  /**\r\n   * Closes the map and uploads the whole buffer.\r\n   *\r\n   * Uploading everything rather than a dirty range matches all three real\r\n   * backends: DX11 `UpdateSubresource` on the whole buffer (cpp:400), DX12\r\n   * `CopyBufferRegion` of `m_size` (Tr2ResourceHelper.cpp:234), Metal a blit of\r\n   * `m_mtlBuffer.length` (mm:259).\r\n   */\r\n  UnmapForWriting()\r\n  {\r\n    if (!this._mapped) return;\r\n\r\n    this._mapped = false;\r\n    this._webgpu.WriteDeviceBuffer(this._handle, this._shadow);\r\n  }\r\n\r\n  /**\r\n   * Writes a range without a map.\r\n   *\r\n   * Carbon's stub refuses this for `WRITE_OFTEN` (`Tr2BufferALStub.cpp:138-141`)\r\n   * and DX12 refuses it for a DYNAMIC buffer (`Tr2ResourceHelper.cpp:253-256`),\r\n   * both because such a buffer's storage moves under a partial write. Ours does\r\n   * not move, but the refusal is kept: a caller that reaches here with a\r\n   * WRITE_OFTEN buffer has confused the two update paths, and every portable\r\n   * caller uses map/unmap for those.\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 Unused; the device came from Create.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  UpdateBuffer(offset, size, data, _renderContext)\r\n  {\r\n    if (!this.IsValid()) return ALResult.E_INVALIDCALL;\r\n    if (!HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE)) return ALResult.E_INVALIDCALL;\r\n    if (HasFlag(this._desc.cpuUsage, Tr2CpuUsage.WRITE_OFTEN)) return ALResult.E_INVALIDCALL;\r\n    if (!data) return ALResult.E_INVALIDARG;\r\n    if (offset < 0 || size < 0 || offset + size > this._shadow.length) return ALResult.E_INVALIDARG;\r\n\r\n    const bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);\r\n\r\n    this._shadow.set(bytes.subarray(0, size), offset);\r\n\r\n    // Upload the RANGE, as every Carbon backend does for plain WRITE - DX11 a\r\n    // D3D11_BOX (`Tr2BufferALDx11.cpp:431-433`), Metal a size-byte staging copy\r\n    // (`Tr2BufferALMetal.mm:302-306`), DX12 a CopyBufferRegion of size at offset\r\n    // (`Tr2ResourceHelper.cpp:258-266`). This used to write the whole shadow,\r\n    // which was correct but paid the full buffer on every partial update.\r\n    //\r\n    // Widened outward to four-byte bounds because `queue.writeBuffer` requires\r\n    // that alignment and D3D11_BOX does not. Widening is safe here and only\r\n    // here: the shadow is RETAINED and authoritative, so the extra bytes on\r\n    // each side are the same ones already on the device. The buffer size is\r\n    // aligned at creation, so the widened end never runs past it.\r\n    const start = offset & ~3;\r\n    const end = Math.min((offset + size + 3) & ~3, this._shadow.length);\r\n\r\n    this._webgpu.WriteDeviceBuffer(this._handle, this._shadow.subarray(start, end), start);\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Releases the GPU buffer and the shadow. */\r\n  Destroy()\r\n  {\r\n    if (this._handle) this._handle.Destroy();\r\n\r\n    this._handle = null;\r\n    this._webgpu = null;\r\n    this._desc = null;\r\n    this._shadow = null;\r\n    this._mapped = false;\r\n  }\r\n\r\n  /** REFUSED: reading back needs MAP_READ, a staging buffer and an await. */\r\n  MapForReading()\r\n  {\r\n    return { result: ALResult.E_INVALIDCALL, data: null };\r\n  }\r\n\r\n  /** @see MapForReading */\r\n  UnmapForReading()\r\n  {\r\n  }\r\n\r\n  /**\r\n   * The buffer's size in bytes, under Carbon's name for the question.\r\n   *\r\n   * `GetSizeInBytes` above is this backend's own spelling and predates the\r\n   * parity check. Both stay: the stub answers to `GetSize`\r\n   * (`stub/Tr2BufferALStub.js`), so a caller written against one backend must\r\n   * not fail against the other.\r\n   *\r\n   * @returns {number} Size in bytes.\r\n   */\r\n  GetSize()\r\n  {\r\n    return this.GetSizeInBytes();\r\n  }\r\n\r\n  /**\r\n   * Which memory class this buffer occupies.\r\n   *\r\n   * MANAGED, as the stub buffer reports: WebGPU gives no placement control and\r\n   * no residency signal, so the honest answer is the device-heap default rather\r\n   * than a claim about video memory.\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   * Fills in a device-resource description.\r\n   *\r\n   * Carbon's backends report size and memory class into the struct the resource\r\n   * sweep walks; the base class's own version is empty\r\n   * (`Tr2DeviceResourceAL/Tr2BaseDeviceResourceAL.js`), and so is the stub's.\r\n   *\r\n   * @param {object} description The description to fill.\r\n   * @returns {object} The description, filled.\r\n   */\r\n  Describe(description)\r\n  {\r\n    if (!description) return description;\r\n\r\n    description.sizeInBytes = this.GetSize();\r\n    description.memoryClass = this.GetMemoryClass();\r\n\r\n    return description;\r\n  }\r\n\r\n  /**\r\n   * Names the buffer for a debugger.\r\n   *\r\n   * `GPUObjectBase.label` is writable after creation, so unlike the stub this\r\n   * one keeps the name where the browser's own error messages will quote it.\r\n   *\r\n   * @param {string} name The name to attach.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  SetName(name)\r\n  {\r\n    const buffer = this.GetDeviceBuffer();\r\n\r\n    if (buffer) buffer.label = String(name);\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /**\r\n   * The buffer's index in a shader-resource descriptor heap.\r\n   *\r\n   * WebGPU HAS NO DESCRIPTOR HEAP - a resource is reached through a bind group,\r\n   * not by index into a global table - so this reports Carbon's \"not in a heap\"\r\n   * sentinel, as the stub does. It is not a gap to be filled later; there is\r\n   * nothing for it to number.\r\n   *\r\n   * @returns {number} `NO_HEAP_INDEX`.\r\n   */\r\n  GetSrvIndexInHeap()\r\n  {\r\n    return NO_HEAP_INDEX;\r\n  }\r\n\r\n  /**\r\n   * The buffer's index in an unordered-access descriptor heap.\r\n   *\r\n   * @returns {number} `NO_HEAP_INDEX`; see `GetSrvIndexInHeap`.\r\n   */\r\n  GetUavIndexInHeap()\r\n  {\r\n    return NO_HEAP_INDEX;\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(CjsWebgpuBufferAL, { className: \"CjsWebgpuBufferAL\", carbon: \"Tr2BufferAL\" });\r\n"],"names":["NO_HEAP_INDEX","gpuBufferUsage","gpuUsage","usage","mask","HasFlag","Tr2GpuUsage","VERTEX_BUFFER","VERTEX","INDEX_BUFFER","INDEX","SHADER_RESOURCE","STORAGE","UNORDERED_ACCESS","DRAW_INDIRECT_ARGS","INDIRECT","COPY_DESTINATION","COPY_DST","CjsWebgpuBufferAL","_desc","_webgpu","_handle","_shadow","_mapped","Create","desc","initialData","renderContext","Destroy","count","ALResult","E_INVALIDARG","writable","cpuUsage","Tr2CpuUsage","WRITE","READ","al","RenderContextALOf","IsValid","E_INVALIDCALL","webgpu","GetWebgpu","size","GetSizeInBytes","GetBufferUsage","CreateDeviceBuffer","label","Uint8Array","bytes","buffer","byteOffset","byteLength","set","subarray","Math","min","length","WriteDeviceBuffer","S_OK","GetDesc","GetDeviceBuffer","MapForWriting","_renderContext","result","data","UnmapForWriting","UpdateBuffer","offset","WRITE_OFTEN","start","end","MapForReading","UnmapForReading","GetSize","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","Describe","description","sizeInBytes","memoryClass","SetName","name","String","GetSrvIndexInHeap","GetUavIndexInHeap","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/webgpu/CjsWebgpuCapsAL.js

@@ -1,3 +1,5 @@
+import { CjsSchema } from '#schema';
+
 // Source: trinity/trinityal/metal/Tr2CapsALMetal.h
 // Source: trinity/trinityal/stub/Tr2CapsALStub.h
 //
@@ -11,6 +13,7 @@
 // `SupportsFloat16`, which is an optional feature and is therefore asked of the
 // device when there is one.
 
+
 /**
  * The platform capability constants, WebGPU's answers.
  *
@@ -142,5 +145,19 @@ class CjsWebgpuCapsAL {
   }
 }
 
+// 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(CjsWebgpuCapsAL, {
+  className: "CjsWebgpuCapsAL",
+  carbon: "Tr2CapsAL"
+});
+
 export { CjsWebgpuCapsAL, CjsWebgpuPlatformCaps };
 //# sourceMappingURL=CjsWebgpuCapsAL.js.map

package/dist/trinityal/webgpu/CjsWebgpuCapsAL.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWebgpuCapsAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuCapsAL.js"],"sourcesContent":["// Source: trinity/trinityal/metal/Tr2CapsALMetal.h\n// Source: trinity/trinityal/stub/Tr2CapsALStub.h\n//\n// What the WebGPU backend says it can do.\n//\n// Carbon's caps object is six questions a caller BRANCHES on, so answering them\n// wrongly sends Trinity down a path this device never takes - which is why the\n// stub answers \"yes\" to four of its ten platform constants rather than denying\n// everything. These are WebGPU's answers, each one decided against the spec's\n// baseline guarantees rather than against a particular adapter, EXCEPT\n// `SupportsFloat16`, which is an optional feature and is therefore asked of the\n// device when there is one.\n\n/**\n * The platform capability constants, WebGPU's answers.\n *\n * The stub's equivalent is `Tr2StubPlatformCaps`, and this table said yes to\n * three things the stub says no to. Two of them were wrong, and the reason is\n * worth keeping because it is easy to make again:\n *\n * **A CAP DESCRIBES THIS BACKEND, NOT THE API IT IS BUILT ON.** \"Storage\n * buffers are core WebGPU\" is true and answers a different question than\n * \"can this backend honour a caller that takes the unordered-access branch\".\n * A caller reads a cap to decide, and a cap is the LAST place that can say no -\n * after it, the caller is committed and the refusals it meets have no branch to\n * take. Both corrected entries are commented where they sit.\n *\n * What still differs from the stub, and holds: buffer shader resources, and the\n * platform not being declared low-performance, because a caller uses that to\n * pick reduced paths and a GPU is doing this work.\n */\nexport const CjsWebgpuPlatformCaps = Object.freeze({\n  SUPPORTS_BUFFER_SHADER_RESOURCES: true,\n\n  SUPPORTS_BUFFER_COUNTERS: false,\n\n  // FALSE, AND IT SAID TRUE FOR A DAY. The argument was \"storage buffers and\n  // storage textures are core WebGPU\" - true of the API, and the wrong question.\n  // A cap describes WHAT THIS BACKEND CAN DO, and today `ClearUav` refuses,\n  // nothing dispatches compute, and `CjsWebgpuDevice` fails any binding\n  // visibility that is not vertex or fragment. Carbon's own stub denies this one\n  // (`stub/Tr2CapsALStub.h:10`) while claiming compute, and a caller taking the\n  // UAV branch would meet three refusals in a row - with the cap being the last\n  // place that could have said no.\n  SUPPORTS_UNORDERED_ACCESS: false,\n\n  // Carbon's stub claims compute too. The dispatch verbs refuse here exactly as\n  // they do there, so this promises no more than the stub does.\n  SUPPORTS_COMPUTE: true,\n\n  SUPPORTS_TEXTURE_ARRAYS: true,\n\n  // Real: the render target creates the multisample attachment and sets a\n  // resolve target (`core/renderTarget.js:388-407`, `:303`).\n  SUPPORTS_MSAA_SAMPLE: true,\n\n  // FALSE for the same reason as unordered access. Carbon's callers DELETE\n  // their explicit clears under this cap (`Tr2ReflectionProbe.cpp:128-138`,\n  // `EveSpaceScene.cpp:2312`), and this backend honours only the first colour\n  // slot's load action and the depth load action: every store action is dropped,\n  // colour slots 1-7 are ignored, and the pass descriptor is always built from\n  // the canvas rather than from what `SetRenderTarget` bound. A caller that\n  // trusted this and dropped its clear would get no clear on anything else.\n  SUPPORTS_RENDER_PASS_HINTS: false,\n\n  IS_LOW_PERFORMANCE: false,\n\n  /** WebGPU's guaranteed `maxUniformBufferBindingSize`, 64 KiB. */\n  MAX_CONSTANT_BUFFER_SIZE: 64 * 1024,\n\n  SUPPORTS_RAY_TRACING: false\n});\n\n\n/**\n * The capabilities the WebGPU backend reports.\n */\nexport class CjsWebgpuCapsAL\n{\n  _webgpu = null;\n\n  /**\n   * @param {object} [webgpu] The `CjsWebgpuDevice`, when one is composed.\n   */\n  constructor(webgpu = null)\n  {\n    this._webgpu = webgpu ?? null;\n  }\n\n  /**\n   * Whether half-precision floats are available in a shader.\n   *\n   * `shader-f16` is an OPTIONAL WebGPU feature, so this is the one answer that\n   * cannot be decided from the spec. Without a device the answer is false: a\n   * caller that emits f16 on a promise, against a device that turns out to lack\n   * the feature, gets a shader that fails to compile rather than a slow one.\n   *\n   * @returns {boolean} Whether the device has `shader-f16`.\n   */\n  SupportsFloat16()\n  {\n    if (!this._webgpu) return false;\n\n    return this._webgpu.GetDevice().features.has(\"shader-f16\");\n  }\n\n  /**\n   * Whether a shader can read a buffer resource.\n   *\n   * @returns {boolean} True; storage buffers are core WebGPU.\n   */\n  SupportsGpuBuffer()\n  {\n    return true;\n  }\n\n  /**\n   * Whether the backend can create a swap chain of its own.\n   *\n   * FALSE, and not because it is unimplemented. The browser owns presentation:\n   * a WebGPU surface is a canvas the page already has, configured with\n   * `GPUCanvasContext.configure`, and the frame is shown when the turn ends.\n   * There is no chain for Trinity to create, resize or flip.\n   *\n   * @returns {boolean} False.\n   */\n  SupportsStandaloneSwapChain()\n  {\n    return false;\n  }\n\n  /**\n   * Whether a vertex shader can sample a texture.\n   *\n   * @returns {boolean} True; WebGPU binds textures to any stage.\n   */\n  SupportsVertexShaderTextures()\n  {\n    return true;\n  }\n\n  /**\n   * Whether the display refresh rate varies.\n   *\n   * @returns {boolean} False; the page presents through\n   *   `requestAnimationFrame` and is not told what the display is doing.\n   */\n  SupportsVariableRefreshRate()\n  {\n    return false;\n  }\n\n  /**\n   * Whether hardware ray tracing is available.\n   *\n   * @returns {boolean} False; WebGPU has no ray-tracing pipeline.\n   */\n  SupportsRaytracing()\n  {\n    return false;\n  }\n\n}\n"],"names":["CjsWebgpuPlatformCaps","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","CjsWebgpuCapsAL","_webgpu","constructor","webgpu","SupportsFloat16","GetDevice","features","has","SupportsGpuBuffer","SupportsStandaloneSwapChain","SupportsVertexShaderTextures","SupportsVariableRefreshRate","SupportsRaytracing"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,qBAAqB,GAAGC,MAAM,CAACC,MAAM,CAAC;AACjDC,EAAAA,gCAAgC,EAAE,IAAI;AAEtCC,EAAAA,wBAAwB,EAAE,KAAK;AAE/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,EAAAA,yBAAyB,EAAE,KAAK;AAEhC;AACA;AACAC,EAAAA,gBAAgB,EAAE,IAAI;AAEtBC,EAAAA,uBAAuB,EAAE,IAAI;AAE7B;AACA;AACAC,EAAAA,oBAAoB,EAAE,IAAI;AAE1B;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,EAAAA,0BAA0B,EAAE,KAAK;AAEjCC,EAAAA,kBAAkB,EAAE,KAAK;AAEzB;EACAC,wBAAwB,EAAE,EAAE,GAAG,IAAI;AAEnCC,EAAAA,oBAAoB,EAAE;AACxB,CAAC;;AAGD;AACA;AACA;AACO,MAAMC,eAAe,CAC5B;AACEC,EAAAA,OAAO,GAAG,IAAI;;AAEd;AACF;AACA;AACEC,EAAAA,WAAWA,CAACC,MAAM,GAAG,IAAI,EACzB;AACE,IAAA,IAAI,CAACF,OAAO,GAAGE,MAAM,IAAI,IAAI;AAC/B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,eAAeA,GACf;AACE,IAAA,IAAI,CAAC,IAAI,CAACH,OAAO,EAAE,OAAO,KAAK;AAE/B,IAAA,OAAO,IAAI,CAACA,OAAO,CAACI,SAAS,EAAE,CAACC,QAAQ,CAACC,GAAG,CAAC,YAAY,CAAC;AAC5D,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,iBAAiBA,GACjB;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,2BAA2BA,GAC3B;AACE,IAAA,OAAO,KAAK;AACd,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,4BAA4BA,GAC5B;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;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;AAEF;;;;"}
+{"version":3,"file":"CjsWebgpuCapsAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuCapsAL.js"],"sourcesContent":["// Source: trinity/trinityal/metal/Tr2CapsALMetal.h\n// Source: trinity/trinityal/stub/Tr2CapsALStub.h\n//\n// What the WebGPU backend says it can do.\n//\n// Carbon's caps object is six questions a caller BRANCHES on, so answering them\n// wrongly sends Trinity down a path this device never takes - which is why the\n// stub answers \"yes\" to four of its ten platform constants rather than denying\n// everything. These are WebGPU's answers, each one decided against the spec's\n// baseline guarantees rather than against a particular adapter, EXCEPT\n// `SupportsFloat16`, which is an optional feature and is therefore asked of the\n// device when there is one.\n\nimport { CjsSchema } from \"#schema\";\n\n/**\n * The platform capability constants, WebGPU's answers.\n *\n * The stub's equivalent is `Tr2StubPlatformCaps`, and this table said yes to\n * three things the stub says no to. Two of them were wrong, and the reason is\n * worth keeping because it is easy to make again:\n *\n * **A CAP DESCRIBES THIS BACKEND, NOT THE API IT IS BUILT ON.** \"Storage\n * buffers are core WebGPU\" is true and answers a different question than\n * \"can this backend honour a caller that takes the unordered-access branch\".\n * A caller reads a cap to decide, and a cap is the LAST place that can say no -\n * after it, the caller is committed and the refusals it meets have no branch to\n * take. Both corrected entries are commented where they sit.\n *\n * What still differs from the stub, and holds: buffer shader resources, and the\n * platform not being declared low-performance, because a caller uses that to\n * pick reduced paths and a GPU is doing this work.\n */\nexport const CjsWebgpuPlatformCaps = Object.freeze({\n  SUPPORTS_BUFFER_SHADER_RESOURCES: true,\n\n  SUPPORTS_BUFFER_COUNTERS: false,\n\n  // FALSE, AND IT SAID TRUE FOR A DAY. The argument was \"storage buffers and\n  // storage textures are core WebGPU\" - true of the API, and the wrong question.\n  // A cap describes WHAT THIS BACKEND CAN DO, and today `ClearUav` refuses,\n  // nothing dispatches compute, and `CjsWebgpuDevice` fails any binding\n  // visibility that is not vertex or fragment. Carbon's own stub denies this one\n  // (`stub/Tr2CapsALStub.h:10`) while claiming compute, and a caller taking the\n  // UAV branch would meet three refusals in a row - with the cap being the last\n  // place that could have said no.\n  SUPPORTS_UNORDERED_ACCESS: false,\n\n  // Carbon's stub claims compute too. The dispatch verbs refuse here exactly as\n  // they do there, so this promises no more than the stub does.\n  SUPPORTS_COMPUTE: true,\n\n  SUPPORTS_TEXTURE_ARRAYS: true,\n\n  // Real: the render target creates the multisample attachment and sets a\n  // resolve target (`core/renderTarget.js:388-407`, `:303`).\n  SUPPORTS_MSAA_SAMPLE: true,\n\n  // FALSE for the same reason as unordered access. Carbon's callers DELETE\n  // their explicit clears under this cap (`Tr2ReflectionProbe.cpp:128-138`,\n  // `EveSpaceScene.cpp:2312`), and this backend honours only the first colour\n  // slot's load action and the depth load action: every store action is dropped,\n  // colour slots 1-7 are ignored, and the pass descriptor is always built from\n  // the canvas rather than from what `SetRenderTarget` bound. A caller that\n  // trusted this and dropped its clear would get no clear on anything else.\n  SUPPORTS_RENDER_PASS_HINTS: false,\n\n  IS_LOW_PERFORMANCE: false,\n\n  /** WebGPU's guaranteed `maxUniformBufferBindingSize`, 64 KiB. */\n  MAX_CONSTANT_BUFFER_SIZE: 64 * 1024,\n\n  SUPPORTS_RAY_TRACING: false\n});\n\n\n/**\n * The capabilities the WebGPU backend reports.\n */\nexport class CjsWebgpuCapsAL\n{\n  _webgpu = null;\n\n  /**\n   * @param {object} [webgpu] The `CjsWebgpuDevice`, when one is composed.\n   */\n  constructor(webgpu = null)\n  {\n    this._webgpu = webgpu ?? null;\n  }\n\n  /**\n   * Whether half-precision floats are available in a shader.\n   *\n   * `shader-f16` is an OPTIONAL WebGPU feature, so this is the one answer that\n   * cannot be decided from the spec. Without a device the answer is false: a\n   * caller that emits f16 on a promise, against a device that turns out to lack\n   * the feature, gets a shader that fails to compile rather than a slow one.\n   *\n   * @returns {boolean} Whether the device has `shader-f16`.\n   */\n  SupportsFloat16()\n  {\n    if (!this._webgpu) return false;\n\n    return this._webgpu.GetDevice().features.has(\"shader-f16\");\n  }\n\n  /**\n   * Whether a shader can read a buffer resource.\n   *\n   * @returns {boolean} True; storage buffers are core WebGPU.\n   */\n  SupportsGpuBuffer()\n  {\n    return true;\n  }\n\n  /**\n   * Whether the backend can create a swap chain of its own.\n   *\n   * FALSE, and not because it is unimplemented. The browser owns presentation:\n   * a WebGPU surface is a canvas the page already has, configured with\n   * `GPUCanvasContext.configure`, and the frame is shown when the turn ends.\n   * There is no chain for Trinity to create, resize or flip.\n   *\n   * @returns {boolean} False.\n   */\n  SupportsStandaloneSwapChain()\n  {\n    return false;\n  }\n\n  /**\n   * Whether a vertex shader can sample a texture.\n   *\n   * @returns {boolean} True; WebGPU binds textures to any stage.\n   */\n  SupportsVertexShaderTextures()\n  {\n    return true;\n  }\n\n  /**\n   * Whether the display refresh rate varies.\n   *\n   * @returns {boolean} False; the page presents through\n   *   `requestAnimationFrame` and is not told what the display is doing.\n   */\n  SupportsVariableRefreshRate()\n  {\n    return false;\n  }\n\n  /**\n   * Whether hardware ray tracing is available.\n   *\n   * @returns {boolean} False; WebGPU has no ray-tracing pipeline.\n   */\n  SupportsRaytracing()\n  {\n    return false;\n  }\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(CjsWebgpuCapsAL, { className: \"CjsWebgpuCapsAL\", carbon: \"Tr2CapsAL\" });\n"],"names":["CjsWebgpuPlatformCaps","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","CjsWebgpuCapsAL","_webgpu","constructor","webgpu","SupportsFloat16","GetDevice","features","has","SupportsGpuBuffer","SupportsStandaloneSwapChain","SupportsVertexShaderTextures","SupportsVariableRefreshRate","SupportsRaytracing","CjsSchema","define","className","carbon"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;MACaA,qBAAqB,GAAGC,MAAM,CAACC,MAAM,CAAC;AACjDC,EAAAA,gCAAgC,EAAE,IAAI;AAEtCC,EAAAA,wBAAwB,EAAE,KAAK;AAE/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,EAAAA,yBAAyB,EAAE,KAAK;AAEhC;AACA;AACAC,EAAAA,gBAAgB,EAAE,IAAI;AAEtBC,EAAAA,uBAAuB,EAAE,IAAI;AAE7B;AACA;AACAC,EAAAA,oBAAoB,EAAE,IAAI;AAE1B;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,EAAAA,0BAA0B,EAAE,KAAK;AAEjCC,EAAAA,kBAAkB,EAAE,KAAK;AAEzB;EACAC,wBAAwB,EAAE,EAAE,GAAG,IAAI;AAEnCC,EAAAA,oBAAoB,EAAE;AACxB,CAAC;;AAGD;AACA;AACA;AACO,MAAMC,eAAe,CAC5B;AACEC,EAAAA,OAAO,GAAG,IAAI;;AAEd;AACF;AACA;AACEC,EAAAA,WAAWA,CAACC,MAAM,GAAG,IAAI,EACzB;AACE,IAAA,IAAI,CAACF,OAAO,GAAGE,MAAM,IAAI,IAAI;AAC/B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,eAAeA,GACf;AACE,IAAA,IAAI,CAAC,IAAI,CAACH,OAAO,EAAE,OAAO,KAAK;AAE/B,IAAA,OAAO,IAAI,CAACA,OAAO,CAACI,SAAS,EAAE,CAACC,QAAQ,CAACC,GAAG,CAAC,YAAY,CAAC;AAC5D,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,iBAAiBA,GACjB;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,2BAA2BA,GAC3B;AACE,IAAA,OAAO,KAAK;AACd,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEC,EAAAA,4BAA4BA,GAC5B;AACE,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;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;AAEF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACAC,SAAS,CAACC,MAAM,CAACd,eAAe,EAAE;AAAEe,EAAAA,SAAS,EAAE,iBAAiB;AAAEC,EAAAA,MAAM,EAAE;AAAY,CAAC,CAAC;;;;"}

package/dist/trinityal/webgpu/CjsWebgpuConstantBufferAL.js

@@ -1,3 +1,4 @@
+import { CjsSchema } from '#schema';
 import { Tr2ConstantUsageAL, ALResult, Tr2ALMemoryType } from '#trinityal';
 import { RenderContextALOf } from '../renderContextAL.js';
 
@@ -188,5 +189,19 @@ class CjsWebgpuConstantBufferAL {
   }
 }
 
+// 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(CjsWebgpuConstantBufferAL, {
+  className: "CjsWebgpuConstantBufferAL",
+  carbon: "Tr2ConstantBufferAL"
+});
+
 export { CjsWebgpuConstantBufferAL };
 //# sourceMappingURL=CjsWebgpuConstantBufferAL.js.map

package/dist/trinityal/webgpu/CjsWebgpuConstantBufferAL.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWebgpuConstantBufferAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuConstantBufferAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2ConstantBufferAL.h\n//   trinity/trinityal/metal/Tr2ConstantBufferALMetal.mm\n//   trinity/trinityal/dx12/Tr2ConstantBufferALDx12.cpp\n//\n// A `Tr2ConstantBufferAL` for WebGPU - the type behind b0 and the per-object\n// blocks, which until 2026-09-10 only ever landed in `Tr2ConstantBufferALStub`'s\n// shadow copy and reached no device.\n//\n// IT OWNS NO DEVICE BUFFER, AND NEITHER DOES METAL'S. Metal's constant buffer\n// is a CPU allocation and a token (`Tr2ConstantBufferALMetal.mm:42`, `:60-69`):\n// `Lock` hands back the allocation and invalidates the token, `Unlock` is a\n// no-op, and `SetConstants` copies the bytes into the context's per-frame\n// constant ARENA and binds `(page, offset)` (`MetalWorkQueue.mm:2396-2440`).\n// A buffer locked three times and drawn three times therefore lands in three\n// regions, and each draw reads its own. The first version of this class owned\n// one `GPUBuffer` and `writeBuffer`'d into it, which is correct for a single\n// draw and wrong for a frame: every draw read the LAST write.\n//\n// FIELDS ARE PUBLIC AND CARBON-NAMED, for the reason recorded on\n// `CjsWebgpuShaderAL`: Carbon's impl class carries public state.\nimport { ALResult, Tr2ALMemoryType, Tr2ConstantUsageAL } from \"#trinityal\";\nimport { RenderContextALOf } from \"../renderContextAL.js\";\n\n\n/**\n * The shadow's size granularity. Every uniform layout this backend reads has a\n * `minBindingSize` that is a multiple of 16 (`array<vec4<f32>, N>`), and\n * Carbon's stub rounds its mirror the same way.\n */\nconst ALIGNMENT = 16;\n\nlet nextConstantBufferId = 1;\n\n\n/**\n * A `Tr2ConstantBufferAL` whose contents live in a CPU shadow copy, suballocated\n * into the frame's constant arena when they are bound.\n */\nexport class CjsWebgpuConstantBufferAL\n{\n  /** m_shadowCopy */\n  m_shadowCopy = new Uint8Array(0);\n\n  /** m_size, the REQUESTED size; the shadow is aligned up. */\n  m_size = 0;\n\n  /** m_usage */\n  m_usage = Tr2ConstantUsageAL.REUSABLE;\n\n  /**\n   * m_token: the arena region the shadow was last uploaded to, and for which\n   * frame. `frame` is -1 after a Lock (Carbon's `Invalidate`), so the next bind\n   * uploads again - to a NEW region.\n   *\n   * PUBLIC BECAUSE THE CONTEXT WRITES IT, as Carbon's does: the upload lives on\n   * the render context (`Tr2RenderContextAL::UploadConstants`) and reaches\n   * straight into the buffer's impl - `buffer.m_buffer->m_token`\n   * (`Tr2RenderContextMetal.mm:688-697`).\n   */\n  m_token = { frame: -1, page: 0, offset: 0, size: 0 };\n\n  /** A process-unique identity, for caches and diagnostics. Zero until Create. */\n  m_id = 0;\n\n  /**\n   * Creates the buffer.\n   *\n   * @param {number} size Bytes requested.\n   * @param {number} usage A `Tr2ConstantUsageAL`.\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\n   * @param {object} renderContext The render context, Trinity's or the AL.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(size, usage, initialData, renderContext)\n  {\n    this.Destroy();\n\n    const al = RenderContextALOf(renderContext);\n\n    if (!al || !al.IsValid()) return ALResult.E_INVALIDARG;\n    if (!Number.isInteger(size) || size <= 0) return ALResult.E_INVALIDARG;\n    if (usage === Tr2ConstantUsageAL.IMMUTABLE && !initialData) return ALResult.E_INVALIDARG;\n\n    this.m_shadowCopy = new Uint8Array(Math.ceil(size / ALIGNMENT) * ALIGNMENT);\n    this.m_size = size;\n    this.m_usage = usage;\n    this.m_id = nextConstantBufferId;\n    nextConstantBufferId += 1;\n\n    if (initialData)\n    {\n      const bytes = new Uint8Array(initialData.buffer, initialData.byteOffset, initialData.byteLength);\n\n      this.m_shadowCopy.set(bytes.subarray(0, Math.min(bytes.length, this.m_shadowCopy.length)));\n    }\n\n    return ALResult.S_OK;\n  }\n\n  /**\n   * Hands back the shadow to write into, and invalidates the token.\n   *\n   * @param {object} [_renderContext] Unused.\n   * @returns {{result: number, data: Uint8Array|null}} The shadow.\n   */\n  Lock(_renderContext)\n  {\n    if (!this.IsValid()) return { result: ALResult.E_FAIL, data: null };\n\n    this.m_token.frame = -1;\n\n    return { result: ALResult.S_OK, data: this.m_shadowCopy };\n  }\n\n  /**\n   * Carbon's is a no-op on Metal and a token bump on DX12; the upload waits\n   * for the bind.\n   *\n   * @returns {number} `S_OK`.\n   */\n  Unlock(_renderContext)\n  {\n    return ALResult.S_OK;\n  }\n\n  /**\n   * Binds this buffer at one stage and register.\n   *\n   * Metal's context delegates to the buffer for this\n   * (`Tr2RenderContextMetal.mm:664-677` → `Tr2ConstantBufferALMetal.mm:79-89`);\n   * the upload itself happens when the draw emits its bindings.\n   *\n   * @param {number} shaderType A `ShaderType`.\n   * @param {number} constantIndex The constant-buffer register.\n   * @param {object} renderContext The render context to bind on.\n   * @returns {number} An `ALResult` value.\n   */\n  SetConstants(shaderType, constantIndex, renderContext)\n  {\n    if (!this.IsValid()) return ALResult.E_INVALIDCALL;\n\n    const al = RenderContextALOf(renderContext);\n\n    return al && al.SetConstants(this, shaderType, constantIndex) ? ALResult.S_OK : ALResult.E_INVALIDARG;\n  }\n\n  /** Whether the buffer has a shadow copy, which `Create` gives it. */\n  IsValid()\n  {\n    return this.m_shadowCopy.length !== 0;\n  }\n\n  /** The requested size, as Carbon's `GetSize` reports it. */\n  GetSize()\n  {\n    return this.m_size;\n  }\n\n  /** Releases the shadow copy and its arena token, leaving the buffer invalid. */\n  Destroy()\n  {\n    this.m_shadowCopy = new Uint8Array(0);\n    this.m_size = 0;\n    this.m_token = { frame: -1, page: 0, offset: 0, size: 0 };\n    this.m_id = 0;\n  }\n\n  /** Where the buffer lives, which is managed memory, not the device. */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\n  }\n\n  /**\n   * Fills in a device-resource description.\n   *\n   * @param {object} description The description to fill.\n   * @returns {object} The description, filled.\n   */\n  Describe(description)\n  {\n    if (!description) return description;\n\n    description.memoryClass = this.GetMemoryClass();\n    description.size = this.m_shadowCopy.length;\n\n    return description;\n  }\n\n  /**\n   * Nothing device-side carries a label; the arena pages are shared.\n   *\n   * @returns {number} `S_OK`.\n   */\n  SetName(_name)\n  {\n    return ALResult.S_OK;\n  }\n}\n"],"names":["ALIGNMENT","nextConstantBufferId","CjsWebgpuConstantBufferAL","m_shadowCopy","Uint8Array","m_size","m_usage","Tr2ConstantUsageAL","REUSABLE","m_token","frame","page","offset","size","m_id","Create","usage","initialData","renderContext","Destroy","al","RenderContextALOf","IsValid","ALResult","E_INVALIDARG","Number","isInteger","IMMUTABLE","Math","ceil","bytes","buffer","byteOffset","byteLength","set","subarray","min","length","S_OK","Lock","_renderContext","result","E_FAIL","data","Unlock","SetConstants","shaderType","constantIndex","E_INVALIDCALL","GetSize","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","Describe","description","memoryClass","SetName","_name"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA,MAAMA,SAAS,GAAG,EAAE;AAEpB,IAAIC,oBAAoB,GAAG,CAAC;;AAG5B;AACA;AACA;AACA;AACO,MAAMC,yBAAyB,CACtC;AACE;AACAC,EAAAA,YAAY,GAAG,IAAIC,UAAU,CAAC,CAAC,CAAC;;AAEhC;AACAC,EAAAA,MAAM,GAAG,CAAC;;AAEV;EACAC,OAAO,GAAGC,kBAAkB,CAACC,QAAQ;;AAErC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEC,EAAAA,OAAO,GAAG;IAAEC,KAAK,EAAE,EAAE;AAAEC,IAAAA,IAAI,EAAE,CAAC;AAAEC,IAAAA,MAAM,EAAE,CAAC;AAAEC,IAAAA,IAAI,EAAE;GAAG;;AAEpD;AACAC,EAAAA,IAAI,GAAG,CAAC;;AAER;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEC,MAAMA,CAACF,IAAI,EAAEG,KAAK,EAAEC,WAAW,EAAEC,aAAa,EAC9C;IACE,IAAI,CAACC,OAAO,EAAE;AAEd,IAAA,MAAMC,EAAE,GAAGC,iBAAiB,CAACH,aAAa,CAAC;AAE3C,IAAA,IAAI,CAACE,EAAE,IAAI,CAACA,EAAE,CAACE,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACC,YAAY;AACtD,IAAA,IAAI,CAACC,MAAM,CAACC,SAAS,CAACb,IAAI,CAAC,IAAIA,IAAI,IAAI,CAAC,EAAE,OAAOU,QAAQ,CAACC,YAAY;AACtE,IAAA,IAAIR,KAAK,KAAKT,kBAAkB,CAACoB,SAAS,IAAI,CAACV,WAAW,EAAE,OAAOM,QAAQ,CAACC,YAAY;AAExF,IAAA,IAAI,CAACrB,YAAY,GAAG,IAAIC,UAAU,CAACwB,IAAI,CAACC,IAAI,CAAChB,IAAI,GAAGb,SAAS,CAAC,GAAGA,SAAS,CAAC;IAC3E,IAAI,CAACK,MAAM,GAAGQ,IAAI;IAClB,IAAI,CAACP,OAAO,GAAGU,KAAK;IACpB,IAAI,CAACF,IAAI,GAAGb,oBAAoB;AAChCA,IAAAA,oBAAoB,IAAI,CAAC;AAEzB,IAAA,IAAIgB,WAAW,EACf;AACE,MAAA,MAAMa,KAAK,GAAG,IAAI1B,UAAU,CAACa,WAAW,CAACc,MAAM,EAAEd,WAAW,CAACe,UAAU,EAAEf,WAAW,CAACgB,UAAU,CAAC;MAEhG,IAAI,CAAC9B,YAAY,CAAC+B,GAAG,CAACJ,KAAK,CAACK,QAAQ,CAAC,CAAC,EAAEP,IAAI,CAACQ,GAAG,CAACN,KAAK,CAACO,MAAM,EAAE,IAAI,CAAClC,YAAY,CAACkC,MAAM,CAAC,CAAC,CAAC;AAC5F,IAAA;IAEA,OAAOd,QAAQ,CAACe,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEC,IAAIA,CAACC,cAAc,EACnB;AACE,IAAA,IAAI,CAAC,IAAI,CAAClB,OAAO,EAAE,EAAE,OAAO;MAAEmB,MAAM,EAAElB,QAAQ,CAACmB,MAAM;AAAEC,MAAAA,IAAI,EAAE;KAAM;AAEnE,IAAA,IAAI,CAAClC,OAAO,CAACC,KAAK,GAAG,EAAE;IAEvB,OAAO;MAAE+B,MAAM,EAAElB,QAAQ,CAACe,IAAI;MAAEK,IAAI,EAAE,IAAI,CAACxC;KAAc;AAC3D,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEyC,MAAMA,CAACJ,cAAc,EACrB;IACE,OAAOjB,QAAQ,CAACe,IAAI;AACtB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACEO,EAAAA,YAAYA,CAACC,UAAU,EAAEC,aAAa,EAAE7B,aAAa,EACrD;IACE,IAAI,CAAC,IAAI,CAACI,OAAO,EAAE,EAAE,OAAOC,QAAQ,CAACyB,aAAa;AAElD,IAAA,MAAM5B,EAAE,GAAGC,iBAAiB,CAACH,aAAa,CAAC;AAE3C,IAAA,OAAOE,EAAE,IAAIA,EAAE,CAACyB,YAAY,CAAC,IAAI,EAAEC,UAAU,EAAEC,aAAa,CAAC,GAAGxB,QAAQ,CAACe,IAAI,GAAGf,QAAQ,CAACC,YAAY;AACvG,EAAA;;AAEA;AACAF,EAAAA,OAAOA,GACP;AACE,IAAA,OAAO,IAAI,CAACnB,YAAY,CAACkC,MAAM,KAAK,CAAC;AACvC,EAAA;;AAEA;AACAY,EAAAA,OAAOA,GACP;IACE,OAAO,IAAI,CAAC5C,MAAM;AACpB,EAAA;;AAEA;AACAc,EAAAA,OAAOA,GACP;AACE,IAAA,IAAI,CAAChB,YAAY,GAAG,IAAIC,UAAU,CAAC,CAAC,CAAC;IACrC,IAAI,CAACC,MAAM,GAAG,CAAC;IACf,IAAI,CAACI,OAAO,GAAG;MAAEC,KAAK,EAAE,EAAE;AAAEC,MAAAA,IAAI,EAAE,CAAC;AAAEC,MAAAA,MAAM,EAAE,CAAC;AAAEC,MAAAA,IAAI,EAAE;KAAG;IACzD,IAAI,CAACC,IAAI,GAAG,CAAC;AACf,EAAA;;AAEA;AACAoC,EAAAA,cAAcA,GACd;IACE,OAAOC,eAAe,CAACC,iBAAiB;AAC1C,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEC,QAAQA,CAACC,WAAW,EACpB;AACE,IAAA,IAAI,CAACA,WAAW,EAAE,OAAOA,WAAW;AAEpCA,IAAAA,WAAW,CAACC,WAAW,GAAG,IAAI,CAACL,cAAc,EAAE;AAC/CI,IAAAA,WAAW,CAACzC,IAAI,GAAG,IAAI,CAACV,YAAY,CAACkC,MAAM;AAE3C,IAAA,OAAOiB,WAAW;AACpB,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEE,OAAOA,CAACC,KAAK,EACb;IACE,OAAOlC,QAAQ,CAACe,IAAI;AACtB,EAAA;AACF;;;;"}
+{"version":3,"file":"CjsWebgpuConstantBufferAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuConstantBufferAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2ConstantBufferAL.h\n//   trinity/trinityal/metal/Tr2ConstantBufferALMetal.mm\n//   trinity/trinityal/dx12/Tr2ConstantBufferALDx12.cpp\n//\n// A `Tr2ConstantBufferAL` for WebGPU - the type behind b0 and the per-object\n// blocks, which until 2026-09-10 only ever landed in `Tr2ConstantBufferALStub`'s\n// shadow copy and reached no device.\n//\n// IT OWNS NO DEVICE BUFFER, AND NEITHER DOES METAL'S. Metal's constant buffer\n// is a CPU allocation and a token (`Tr2ConstantBufferALMetal.mm:42`, `:60-69`):\n// `Lock` hands back the allocation and invalidates the token, `Unlock` is a\n// no-op, and `SetConstants` copies the bytes into the context's per-frame\n// constant ARENA and binds `(page, offset)` (`MetalWorkQueue.mm:2396-2440`).\n// A buffer locked three times and drawn three times therefore lands in three\n// regions, and each draw reads its own. The first version of this class owned\n// one `GPUBuffer` and `writeBuffer`'d into it, which is correct for a single\n// draw and wrong for a frame: every draw read the LAST write.\n//\n// FIELDS ARE PUBLIC AND CARBON-NAMED, for the reason recorded on\n// `CjsWebgpuShaderAL`: Carbon's impl class carries public state.\nimport { CjsSchema } from \"#schema\";\nimport { ALResult, Tr2ALMemoryType, Tr2ConstantUsageAL } from \"#trinityal\";\nimport { RenderContextALOf } from \"../renderContextAL.js\";\n\n\n/**\n * The shadow's size granularity. Every uniform layout this backend reads has a\n * `minBindingSize` that is a multiple of 16 (`array<vec4<f32>, N>`), and\n * Carbon's stub rounds its mirror the same way.\n */\nconst ALIGNMENT = 16;\n\nlet nextConstantBufferId = 1;\n\n\n/**\n * A `Tr2ConstantBufferAL` whose contents live in a CPU shadow copy, suballocated\n * into the frame's constant arena when they are bound.\n */\nexport class CjsWebgpuConstantBufferAL\n{\n  /** m_shadowCopy */\n  m_shadowCopy = new Uint8Array(0);\n\n  /** m_size, the REQUESTED size; the shadow is aligned up. */\n  m_size = 0;\n\n  /** m_usage */\n  m_usage = Tr2ConstantUsageAL.REUSABLE;\n\n  /**\n   * m_token: the arena region the shadow was last uploaded to, and for which\n   * frame. `frame` is -1 after a Lock (Carbon's `Invalidate`), so the next bind\n   * uploads again - to a NEW region.\n   *\n   * PUBLIC BECAUSE THE CONTEXT WRITES IT, as Carbon's does: the upload lives on\n   * the render context (`Tr2RenderContextAL::UploadConstants`) and reaches\n   * straight into the buffer's impl - `buffer.m_buffer->m_token`\n   * (`Tr2RenderContextMetal.mm:688-697`).\n   */\n  m_token = { frame: -1, page: 0, offset: 0, size: 0 };\n\n  /** A process-unique identity, for caches and diagnostics. Zero until Create. */\n  m_id = 0;\n\n  /**\n   * Creates the buffer.\n   *\n   * @param {number} size Bytes requested.\n   * @param {number} usage A `Tr2ConstantUsageAL`.\n   * @param {ArrayBufferView|null} initialData Initial contents, if any.\n   * @param {object} renderContext The render context, Trinity's or the AL.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(size, usage, initialData, renderContext)\n  {\n    this.Destroy();\n\n    const al = RenderContextALOf(renderContext);\n\n    if (!al || !al.IsValid()) return ALResult.E_INVALIDARG;\n    if (!Number.isInteger(size) || size <= 0) return ALResult.E_INVALIDARG;\n    if (usage === Tr2ConstantUsageAL.IMMUTABLE && !initialData) return ALResult.E_INVALIDARG;\n\n    this.m_shadowCopy = new Uint8Array(Math.ceil(size / ALIGNMENT) * ALIGNMENT);\n    this.m_size = size;\n    this.m_usage = usage;\n    this.m_id = nextConstantBufferId;\n    nextConstantBufferId += 1;\n\n    if (initialData)\n    {\n      const bytes = new Uint8Array(initialData.buffer, initialData.byteOffset, initialData.byteLength);\n\n      this.m_shadowCopy.set(bytes.subarray(0, Math.min(bytes.length, this.m_shadowCopy.length)));\n    }\n\n    return ALResult.S_OK;\n  }\n\n  /**\n   * Hands back the shadow to write into, and invalidates the token.\n   *\n   * @param {object} [_renderContext] Unused.\n   * @returns {{result: number, data: Uint8Array|null}} The shadow.\n   */\n  Lock(_renderContext)\n  {\n    if (!this.IsValid()) return { result: ALResult.E_FAIL, data: null };\n\n    this.m_token.frame = -1;\n\n    return { result: ALResult.S_OK, data: this.m_shadowCopy };\n  }\n\n  /**\n   * Carbon's is a no-op on Metal and a token bump on DX12; the upload waits\n   * for the bind.\n   *\n   * @returns {number} `S_OK`.\n   */\n  Unlock(_renderContext)\n  {\n    return ALResult.S_OK;\n  }\n\n  /**\n   * Binds this buffer at one stage and register.\n   *\n   * Metal's context delegates to the buffer for this\n   * (`Tr2RenderContextMetal.mm:664-677` → `Tr2ConstantBufferALMetal.mm:79-89`);\n   * the upload itself happens when the draw emits its bindings.\n   *\n   * @param {number} shaderType A `ShaderType`.\n   * @param {number} constantIndex The constant-buffer register.\n   * @param {object} renderContext The render context to bind on.\n   * @returns {number} An `ALResult` value.\n   */\n  SetConstants(shaderType, constantIndex, renderContext)\n  {\n    if (!this.IsValid()) return ALResult.E_INVALIDCALL;\n\n    const al = RenderContextALOf(renderContext);\n\n    return al && al.SetConstants(this, shaderType, constantIndex) ? ALResult.S_OK : ALResult.E_INVALIDARG;\n  }\n\n  /** Whether the buffer has a shadow copy, which `Create` gives it. */\n  IsValid()\n  {\n    return this.m_shadowCopy.length !== 0;\n  }\n\n  /** The requested size, as Carbon's `GetSize` reports it. */\n  GetSize()\n  {\n    return this.m_size;\n  }\n\n  /** Releases the shadow copy and its arena token, leaving the buffer invalid. */\n  Destroy()\n  {\n    this.m_shadowCopy = new Uint8Array(0);\n    this.m_size = 0;\n    this.m_token = { frame: -1, page: 0, offset: 0, size: 0 };\n    this.m_id = 0;\n  }\n\n  /** Where the buffer lives, which is managed memory, not the device. */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\n  }\n\n  /**\n   * Fills in a device-resource description.\n   *\n   * @param {object} description The description to fill.\n   * @returns {object} The description, filled.\n   */\n  Describe(description)\n  {\n    if (!description) return description;\n\n    description.memoryClass = this.GetMemoryClass();\n    description.size = this.m_shadowCopy.length;\n\n    return description;\n  }\n\n  /**\n   * Nothing device-side carries a label; the arena pages are shared.\n   *\n   * @returns {number} `S_OK`.\n   */\n  SetName(_name)\n  {\n    return ALResult.S_OK;\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(CjsWebgpuConstantBufferAL, { className: \"CjsWebgpuConstantBufferAL\", carbon: \"Tr2ConstantBufferAL\" });\n"],"names":["ALIGNMENT","nextConstantBufferId","CjsWebgpuConstantBufferAL","m_shadowCopy","Uint8Array","m_size","m_usage","Tr2ConstantUsageAL","REUSABLE","m_token","frame","page","offset","size","m_id","Create","usage","initialData","renderContext","Destroy","al","RenderContextALOf","IsValid","ALResult","E_INVALIDARG","Number","isInteger","IMMUTABLE","Math","ceil","bytes","buffer","byteOffset","byteLength","set","subarray","min","length","S_OK","Lock","_renderContext","result","E_FAIL","data","Unlock","SetConstants","shaderType","constantIndex","E_INVALIDCALL","GetSize","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","Describe","description","memoryClass","SetName","_name","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/webgpu/CjsWebgpuDevice.js

@@ -1,7 +1,7 @@
 import { CjsResource } from '#resource/CjsResource';
-import { CjsWebgpuPipelineCache, CanonicalKey, RenderPipelineKey } from './core/pipelineCache.js';
+import { CjsWebgpuPipelineCache, CanonicalKey, RenderPipelineKey } from './core/CjsWebgpuPipelineCache.js';
 import { AssertFormatFeature, PlanTextureUpload } from './core/textureLayout.js';
-import { CjsWebgpuEncodeState } from './core/batchGroups.js';
+import { CjsWebgpuEncodeState } from './core/CjsWebgpuEncodeState.js';
 
 const PREPARED_PIPELINES = new WeakMap();
 const LIVE_PIPELINES = new WeakMap();