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

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

@@ -1 +1 @@
-{"version":3,"file":"CjsWebgpuTextureAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuTextureAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2TextureAL.h\n//   trinity/trinityal/metal/Tr2TextureALMetal.mm\n//   trinity/trinityal/stub/Tr2TextureALStub.cpp\n//\n// A `Tr2TextureAL` holding a real `GPUTexture`.\n//\n// CREATED WITH ITS DATA, NEVER UPDATED INTO. Carbon's texture resource creates\n// its texture from the decoded bitmap with one `Tr2SubresourceData` per\n// (mip, layer), indexed `mip + layer * mipCount`\n// (`Tr2ImageIOHelpers.cpp:104-128`), and Metal uploads them one\n// `replaceRegion` per (slice, mip) (`Tr2TextureALMetal.mm:140-268`). This does\n// the same with one `writeTexture` per subresource.\n//\n// THE sRGB VIEW IS A FORMAT-REINTERPRETING VIEW, as Metal's is: `MetalContext.mm:342-357`\n// makes `newTextureViewWithPixelFormat:` of the sRGB sibling for RGBA8, BGRA8,\n// BC1, BC2, BC3 and BC7, and `GetSRGBViewMetalTexture()` is what a\n// `COLOR_SPACE_SRGB` SRV binds. WebGPU needs the sibling declared in\n// `viewFormats` at creation, so it is.\n//\n// FIELDS ARE PUBLIC AND CARBON-NAMED, for the reason recorded on `CjsWebgpuShaderAL`.\nimport { ALResult, Tr2ALMemoryType, Tr2MsaaDesc } from \"#trinityal\";\nimport { PixelFormat, TextureType, Tr2CpuUsage, Tr2GpuUsage, HasFlag } from \"#consts/render-context\";\nimport { CarbonPixelFormatToWebGpu, SrgbSiblingOf } from \"../../global/consts/webgpu/textureFormats.js\";\nimport { RenderContextALOf } from \"../renderContextAL.js\";\n\nconst NO_HEAP_INDEX = 0xffffffff;\n\n/** Carbon texture type to WebGPU's view dimension for the texture as a whole. */\nconst VIEW_DIMENSION_OF_TYPE = Object.freeze({\n  [TextureType.TEX_TYPE_2D]: \"2d\",\n  [TextureType.TEX_TYPE_CUBE]: \"cube\",\n  [TextureType.TEX_TYPE_3D]: \"3d\"\n});\n\n\n/**\n * A `Tr2TextureAL` backed by a WebGPU `GPUTexture`, created with all of its data.\n */\nexport class CjsWebgpuTextureAL\n{\n  /** m_desc, a `Tr2BitmapDimensions`. */\n  m_desc = null;\n\n  m_msaa = new Tr2MsaaDesc();\n\n  m_gpuUsage = Tr2GpuUsage.NONE;\n\n  m_cpuUsage = Tr2CpuUsage.NONE;\n\n  /** The `GPUTexture`, or null before Create. */\n  m_texture = null;\n\n  /** The `GPUTextureFormat` it was created with. */\n  m_format = null;\n\n  /** The sRGB sibling format, when the format has one and a view of it exists. */\n  m_srgbFormat = null;\n\n  /** Views by `dimension:colorSpace`, made on first request. */\n  m_views = new Map();\n\n  m_webgpu = null;\n\n  m_name = \"\";\n\n  /**\n   * Creates the texture and uploads its initial data.\n   *\n   * @param {object} desc A `Tr2BitmapDimensions`.\n   * @param {object} options `{ gpuUsage, cpuUsage, msaa, initialData }`;\n   *   `initialData` is an array of `{ sysMem, sysMemPitch, sysMemSlicePitch }`\n   *   indexed `mip + layer * mipCount`, as Carbon's is.\n   * @param {object} renderContext The render context, Trinity's or the AL.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(desc, options, renderContext)\n  {\n    this.Destroy();\n\n    const { gpuUsage = Tr2GpuUsage.NONE, cpuUsage = Tr2CpuUsage.NONE, msaa = new Tr2MsaaDesc(), initialData = null } = options ?? {};\n    const al = RenderContextALOf(renderContext);\n\n    if (!al || !al.IsValid()) return ALResult.E_FAIL;\n    if (!desc || desc.GetWidth() === 0 || desc.GetHeight() === 0) return ALResult.E_INVALIDARG;\n    if (msaa.samples > 1) return ALResult.E_INVALIDARG;\n\n    const type = desc.GetType();\n    const dimension = VIEW_DIMENSION_OF_TYPE[type];\n\n    if (!dimension) return ALResult.E_INVALIDARG;\n    if (type === TextureType.TEX_TYPE_CUBE && desc.GetArraySize() % 6 !== 0) return ALResult.E_INVALIDARG;\n\n    // Carbon's own rule (the stub's last check): a texture nothing can ever\n    // write that arrives with no pixels samples black forever. Refused.\n    const writable = HasFlag(gpuUsage, Tr2GpuUsage.RENDER_TARGET) || HasFlag(gpuUsage, Tr2GpuUsage.UNORDERED_ACCESS)\n      || HasFlag(gpuUsage, Tr2GpuUsage.DEPTH_STENCIL) || HasFlag(cpuUsage, Tr2CpuUsage.WRITE);\n\n    if (!writable && !initialData) return ALResult.E_INVALIDARG;\n\n    const format = CarbonPixelFormatToWebGpu[desc.GetFormat()] ?? null;\n\n    if (!format) return ALResult.E_INVALIDARG;\n\n    const webgpu = al.GetWebgpu();\n    if (!webgpu) return ALResult.E_INVALIDCALL;\n\n    const device = webgpu.GetDevice();\n    const usageFlags = webgpu.GetTextureUsage();\n    const srgbFormat = SrgbSiblingOf(format);\n    const mipCount = Math.max(1, desc.GetTrueMipCount());\n    const layers = type === TextureType.TEX_TYPE_3D ? Math.max(1, desc.GetDepth()) : Math.max(1, desc.GetArraySize());\n    let usage = usageFlags.TEXTURE_BINDING | usageFlags.COPY_DST;\n\n    if (HasFlag(gpuUsage, Tr2GpuUsage.RENDER_TARGET) || HasFlag(gpuUsage, Tr2GpuUsage.DEPTH_STENCIL))\n    {\n      usage |= usageFlags.RENDER_ATTACHMENT ?? 0;\n    }\n\n    this.m_texture = device.createTexture({\n      label: this.m_name || \"Tr2TextureAL\",\n      size: { width: desc.GetWidth(), height: desc.GetHeight(), depthOrArrayLayers: layers },\n      mipLevelCount: mipCount,\n      sampleCount: 1,\n      dimension: type === TextureType.TEX_TYPE_3D ? \"3d\" : \"2d\",\n      format,\n      usage,\n      ...(srgbFormat ? { viewFormats: [ srgbFormat ] } : {})\n    });\n    this.m_format = format;\n    this.m_srgbFormat = srgbFormat;\n    this.m_desc = desc;\n    this.m_msaa = msaa;\n    this.m_gpuUsage = gpuUsage;\n    this.m_cpuUsage = cpuUsage;\n    this.m_webgpu = webgpu;\n\n    if (initialData) this._Upload(initialData, mipCount, type);\n\n    return ALResult.S_OK;\n  }\n\n  /** One `writeTexture` per subresource, Carbon's `mip + layer * mipCount` order. */\n  _Upload(initialData, mipCount, type)\n  {\n    const desc = this.m_desc;\n    const queue = this.m_webgpu.GetDevice().queue;\n    const layerCount = type === TextureType.TEX_TYPE_3D ? 1 : Math.max(1, desc.GetArraySize());\n\n    for (let layer = 0; layer < layerCount; layer += 1)\n    {\n      for (let mip = 0; mip < mipCount; mip += 1)\n      {\n        const subresource = initialData[mip + layer * mipCount];\n\n        if (!subresource || !subresource.sysMem) continue;\n\n        const bytes = subresource.sysMem;\n        const pitch = subresource.sysMemPitch;\n        const slicePitch = subresource.sysMemSlicePitch || bytes.byteLength;\n        const depth = type === TextureType.TEX_TYPE_3D ? Math.max(1, desc.GetMipDepth(mip)) : 1;\n\n        queue.writeTexture(\n          { texture: this.m_texture, mipLevel: mip, origin: { x: 0, y: 0, z: layer } },\n          bytes,\n          { offset: 0, bytesPerRow: pitch, rowsPerImage: pitch ? Math.max(1, Math.floor(slicePitch / pitch)) : undefined },\n          { width: desc.GetMipWidth(mip), height: desc.GetMipHeight(mip), depthOrArrayLayers: depth }\n        );\n      }\n    }\n  }\n\n  /**\n   * The view a resource set binds: linear or sRGB, in the layout's dimension.\n   *\n   * Metal's `GetMetalTexture()` / `GetSRGBViewMetalTexture()`\n   * (`Tr2TextureALMetal.h:49-54`), with the dimension added because a WebGPU\n   * view must name it and a cube texture is legitimately bound as a 2d-array.\n   *\n   * @param {string} [viewDimension] A `GPUTextureViewDimension`.\n   * @param {number} [colorSpace] A `Tr2ColorSpace`; non-zero means sRGB.\n   * @returns {object|null} A `GPUTextureView`, or null before Create.\n   */\n  GetDeviceTextureView(viewDimension = VIEW_DIMENSION_OF_TYPE[this.m_desc?.GetType()] ?? \"2d\", colorSpace = 0)\n  {\n    if (!this.m_texture) return null;\n\n    const srgb = colorSpace !== 0 && this.m_srgbFormat !== null;\n    const key = `${viewDimension}:${srgb ? \"srgb\" : \"linear\"}`;\n    let view = this.m_views.get(key) ?? null;\n\n    if (!view)\n    {\n      view = this.m_texture.createView({\n        label: `${this.m_name || \"Tr2TextureAL\"} ${key}`,\n        dimension: viewDimension,\n        ...(srgb ? { format: this.m_srgbFormat } : {})\n      });\n      this.m_views.set(key, view);\n    }\n\n    return view;\n  }\n\n  /** The `GPUTexture`; Metal's `GetMetalTexture` under this backend's name. */\n  GetDeviceTexture()\n  {\n    return this.m_texture;\n  }\n\n  /** Whether the texture holds a `GPUTexture`. */\n  IsValid()\n  {\n    return this.m_texture !== null;\n  }\n\n  /** Shared textures need a native handle WebGPU does not expose; always fails. */\n  OpenShared()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** The `Tr2BitmapDimensions` this texture was created from, or null. */\n  GetDesc()\n  {\n    return this.m_desc;\n  }\n\n  /** The multisample description; this backend creates single-sampled textures. */\n  GetMsaaDesc()\n  {\n    return this.m_msaa;\n  }\n\n  /** The `Tr2GpuUsage` flags it was created with. */\n  GetGpuUsage()\n  {\n    return this.m_gpuUsage;\n  }\n\n  /** The `Tr2CpuUsage` flags it was created with. */\n  GetCpuUsage()\n  {\n    return this.m_cpuUsage;\n  }\n\n  /** Width in texels of mip zero, or zero before Create. */\n  GetWidth()\n  {\n    return this.m_desc ? this.m_desc.GetWidth() : 0;\n  }\n\n  /** Height in texels of mip zero, or zero before Create. */\n  GetHeight()\n  {\n    return this.m_desc ? this.m_desc.GetHeight() : 0;\n  }\n\n  /** Depth in texels of mip zero, which is one unless the texture is 3D. */\n  GetDepth()\n  {\n    return this.m_desc ? this.m_desc.GetDepth() : 0;\n  }\n\n  /** The mip count requested at creation, which may be zero for a full chain. */\n  GetMipCount()\n  {\n    return this.m_desc ? this.m_desc.GetMipCount() : 0;\n  }\n\n  /** The mip count actually created, with a requested zero resolved. */\n  GetTrueMipCount()\n  {\n    return this.m_desc ? this.m_desc.GetTrueMipCount() : 0;\n  }\n\n  /** The Carbon `PixelFormat`, or `PIXEL_FORMAT_UNKNOWN` before Create. */\n  GetFormat()\n  {\n    return this.m_desc ? this.m_desc.GetFormat() : PixelFormat.PIXEL_FORMAT_UNKNOWN;\n  }\n\n  /** The Carbon `TextureType`, or `TEX_TYPE_INVALID` before Create. */\n  GetType()\n  {\n    return this.m_desc ? this.m_desc.GetType() : TextureType.TEX_TYPE_INVALID;\n  }\n\n  /** The layer count, which for a cube counts its six faces. */\n  GetArraySize()\n  {\n    return this.m_desc ? this.m_desc.GetArraySize() : 0;\n  }\n\n  /**\n   * The byte size of one mip across all layers.\n   *\n   * @param {number} level The mip level.\n   * @returns {number} Its size in bytes, or zero before Create.\n   */\n  GetMipSize(level)\n  {\n    return this.m_desc ? this.m_desc.GetMipSize(level) : 0;\n  }\n\n  /** Reading back needs a staging buffer and an await; refused by name. */\n  MapForReading(_region, _synchronize, _renderContext)\n  {\n    return { result: ALResult.E_FAIL, data: null, pitch: 0 };\n  }\n\n  /** Paired with `MapForReading`, which this backend refuses. */\n  UnmapForReading(_renderContext)\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** Carbon's immutable texture cannot be mapped for writing either. */\n  MapForWriting(_region, _renderContext)\n  {\n    return { result: ALResult.E_FAIL, data: null, pitch: 0 };\n  }\n\n  /** Paired with `MapForWriting`, which this backend refuses. */\n  UnmapForWriting(_renderContext)\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /**\n   * Replaces one mip of one slice, Carbon's `UpdateSubresource`.\n   *\n   * @param {object} region A `Tr2TextureSubresource` naming one mip and slice.\n   * @param {ArrayBufferView} source The texels.\n   * @param {number} pitch Bytes per row.\n   * @param {number} slicePitch Bytes per slice.\n   * @returns {number} An `ALResult` value.\n   */\n  UpdateSubresource(region, source, pitch, slicePitch, _renderContext)\n  {\n    if (!this.IsValid()) return ALResult.E_INVALIDCALL;\n    if (!region || !source) return ALResult.E_INVALIDARG;\n\n    const mip = region.m_startMipLevel ?? 0;\n    const layer = region.m_startFace ?? 0;\n\n    this.m_webgpu.GetDevice().queue.writeTexture(\n      { texture: this.m_texture, mipLevel: mip, origin: { x: 0, y: 0, z: layer } },\n      source,\n      { offset: 0, bytesPerRow: pitch, rowsPerImage: pitch ? Math.max(1, Math.floor((slicePitch || source.byteLength) / pitch)) : undefined },\n      { width: this.m_desc.GetMipWidth(mip), height: this.m_desc.GetMipHeight(mip), depthOrArrayLayers: 1 }\n    );\n\n    return ALResult.S_OK;\n  }\n\n  /** Needs a command encoder the AL is not handed here; refused by name. */\n  CopySubresourceRegion()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** WebGPU has no mip generator; a full chain is uploaded at creation instead. */\n  GenerateMipMaps()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** Multisample resolve, which this backend has no multisampled textures for. */\n  Resolve()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** The native shared handle, which WebGPU does not expose. */\n  GetSharedHandle()\n  {\n    return null;\n  }\n\n  /** The descriptor-heap slot, which only the D3D12 backend has. */\n  GetSrvIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n\n  /** The descriptor-heap slot, which only the D3D12 backend has. */\n  GetUavIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n\n  /** Releases the `GPUTexture` and its views, leaving the AL invalid. */\n  Destroy()\n  {\n    this.m_texture?.destroy?.();\n    this.m_texture = null;\n    this.m_views = new Map();\n    this.m_desc = null;\n    this.m_format = null;\n    this.m_srgbFormat = null;\n    this.m_webgpu = null;\n    this.m_gpuUsage = Tr2GpuUsage.NONE;\n    this.m_cpuUsage = Tr2CpuUsage.NONE;\n  }\n\n  /** Where the texture lives, which for this backend is always video memory. */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\n  }\n\n  /**\n   * Fills in what this AL knows for a memory report.\n   *\n   * @param {object} description The description to fill in.\n   * @returns {object} The same description.\n   */\n  Describe(description)\n  {\n    if (!description) return description;\n\n    description.memoryClass = this.GetMemoryClass();\n\n    return description;\n  }\n\n  /**\n   * Names the texture, which reaches the `GPUTexture` label for debugging.\n   *\n   * @param {string} name The name.\n   * @returns {number} An `ALResult` value.\n   */\n  SetName(name)\n  {\n    this.m_name = String(name ?? \"\");\n\n    if (this.m_texture) this.m_texture.label = this.m_name;\n\n    return ALResult.S_OK;\n  }\n\n  /** The name given by `SetName`. */\n  GetName()\n  {\n    return this.m_name;\n  }\n}\n"],"names":["NO_HEAP_INDEX","VIEW_DIMENSION_OF_TYPE","Object","freeze","TextureType","TEX_TYPE_2D","TEX_TYPE_CUBE","TEX_TYPE_3D","CjsWebgpuTextureAL","m_desc","m_msaa","Tr2MsaaDesc","m_gpuUsage","Tr2GpuUsage","NONE","m_cpuUsage","Tr2CpuUsage","m_texture","m_format","m_srgbFormat","m_views","Map","m_webgpu","m_name","Create","desc","options","renderContext","Destroy","gpuUsage","cpuUsage","msaa","initialData","al","RenderContextALOf","IsValid","ALResult","E_FAIL","GetWidth","GetHeight","E_INVALIDARG","samples","type","GetType","dimension","GetArraySize","writable","HasFlag","RENDER_TARGET","UNORDERED_ACCESS","DEPTH_STENCIL","WRITE","format","CarbonPixelFormatToWebGpu","GetFormat","webgpu","GetWebgpu","E_INVALIDCALL","device","GetDevice","usageFlags","GetTextureUsage","srgbFormat","SrgbSiblingOf","mipCount","Math","max","GetTrueMipCount","layers","GetDepth","usage","TEXTURE_BINDING","COPY_DST","RENDER_ATTACHMENT","createTexture","label","size","width","height","depthOrArrayLayers","mipLevelCount","sampleCount","viewFormats","_Upload","S_OK","queue","layerCount","layer","mip","subresource","sysMem","bytes","pitch","sysMemPitch","slicePitch","sysMemSlicePitch","byteLength","depth","GetMipDepth","writeTexture","texture","mipLevel","origin","x","y","z","offset","bytesPerRow","rowsPerImage","floor","undefined","GetMipWidth","GetMipHeight","GetDeviceTextureView","viewDimension","colorSpace","srgb","key","view","get","createView","set","GetDeviceTexture","OpenShared","GetDesc","GetMsaaDesc","GetGpuUsage","GetCpuUsage","GetMipCount","PixelFormat","PIXEL_FORMAT_UNKNOWN","TEX_TYPE_INVALID","GetMipSize","level","MapForReading","_region","_synchronize","_renderContext","result","data","UnmapForReading","MapForWriting","UnmapForWriting","UpdateSubresource","region","source","m_startMipLevel","m_startFace","CopySubresourceRegion","GenerateMipMaps","Resolve","GetSharedHandle","GetSrvIndexInHeap","GetUavIndexInHeap","destroy","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","Describe","description","memoryClass","SetName","name","String","GetName"],"mappings":"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"}
+{"version":3,"file":"CjsWebgpuTextureAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuTextureAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2TextureAL.h\n//   trinity/trinityal/metal/Tr2TextureALMetal.mm\n//   trinity/trinityal/stub/Tr2TextureALStub.cpp\n//\n// A `Tr2TextureAL` holding a real `GPUTexture`.\n//\n// CREATED WITH ITS DATA, NEVER UPDATED INTO. Carbon's texture resource creates\n// its texture from the decoded bitmap with one `Tr2SubresourceData` per\n// (mip, layer), indexed `mip + layer * mipCount`\n// (`Tr2ImageIOHelpers.cpp:104-128`), and Metal uploads them one\n// `replaceRegion` per (slice, mip) (`Tr2TextureALMetal.mm:140-268`). This does\n// the same with one `writeTexture` per subresource.\n//\n// THE sRGB VIEW IS A FORMAT-REINTERPRETING VIEW, as Metal's is: `MetalContext.mm:342-357`\n// makes `newTextureViewWithPixelFormat:` of the sRGB sibling for RGBA8, BGRA8,\n// BC1, BC2, BC3 and BC7, and `GetSRGBViewMetalTexture()` is what a\n// `COLOR_SPACE_SRGB` SRV binds. WebGPU needs the sibling declared in\n// `viewFormats` at creation, so it is.\n//\n// FIELDS ARE PUBLIC AND CARBON-NAMED, for the reason recorded on `CjsWebgpuShaderAL`.\nimport { CjsSchema } from \"#schema\";\nimport { ALResult, Tr2ALMemoryType, Tr2MsaaDesc } from \"#trinityal\";\nimport { PixelFormat, TextureType, Tr2CpuUsage, Tr2GpuUsage, HasFlag } from \"#consts/render-context\";\nimport { CarbonPixelFormatToWebGpu, SrgbSiblingOf } from \"../../global/consts/webgpu/textureFormats.js\";\nimport { RenderContextALOf } from \"../renderContextAL.js\";\n\nconst NO_HEAP_INDEX = 0xffffffff;\n\n/** Carbon texture type to WebGPU's view dimension for the texture as a whole. */\nconst VIEW_DIMENSION_OF_TYPE = Object.freeze({\n  [TextureType.TEX_TYPE_2D]: \"2d\",\n  [TextureType.TEX_TYPE_CUBE]: \"cube\",\n  [TextureType.TEX_TYPE_3D]: \"3d\"\n});\n\n\n/**\n * A `Tr2TextureAL` backed by a WebGPU `GPUTexture`, created with all of its data.\n */\nexport class CjsWebgpuTextureAL\n{\n  /** m_desc, a `Tr2BitmapDimensions`. */\n  m_desc = null;\n\n  m_msaa = new Tr2MsaaDesc();\n\n  m_gpuUsage = Tr2GpuUsage.NONE;\n\n  m_cpuUsage = Tr2CpuUsage.NONE;\n\n  /** The `GPUTexture`, or null before Create. */\n  m_texture = null;\n\n  /** The `GPUTextureFormat` it was created with. */\n  m_format = null;\n\n  /** The sRGB sibling format, when the format has one and a view of it exists. */\n  m_srgbFormat = null;\n\n  /** Views by `dimension:colorSpace`, made on first request. */\n  m_views = new Map();\n\n  m_webgpu = null;\n\n  m_name = \"\";\n\n  /**\n   * Creates the texture and uploads its initial data.\n   *\n   * @param {object} desc A `Tr2BitmapDimensions`.\n   * @param {object} options `{ gpuUsage, cpuUsage, msaa, initialData }`;\n   *   `initialData` is an array of `{ sysMem, sysMemPitch, sysMemSlicePitch }`\n   *   indexed `mip + layer * mipCount`, as Carbon's is.\n   * @param {object} renderContext The render context, Trinity's or the AL.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(desc, options, renderContext)\n  {\n    this.Destroy();\n\n    const { gpuUsage = Tr2GpuUsage.NONE, cpuUsage = Tr2CpuUsage.NONE, msaa = new Tr2MsaaDesc(), initialData = null } = options ?? {};\n    const al = RenderContextALOf(renderContext);\n\n    if (!al || !al.IsValid()) return ALResult.E_FAIL;\n    if (!desc || desc.GetWidth() === 0 || desc.GetHeight() === 0) return ALResult.E_INVALIDARG;\n    if (msaa.samples > 1) return ALResult.E_INVALIDARG;\n\n    const type = desc.GetType();\n    const dimension = VIEW_DIMENSION_OF_TYPE[type];\n\n    if (!dimension) return ALResult.E_INVALIDARG;\n    if (type === TextureType.TEX_TYPE_CUBE && desc.GetArraySize() % 6 !== 0) return ALResult.E_INVALIDARG;\n\n    // Carbon's own rule (the stub's last check): a texture nothing can ever\n    // write that arrives with no pixels samples black forever. Refused.\n    const writable = HasFlag(gpuUsage, Tr2GpuUsage.RENDER_TARGET) || HasFlag(gpuUsage, Tr2GpuUsage.UNORDERED_ACCESS)\n      || HasFlag(gpuUsage, Tr2GpuUsage.DEPTH_STENCIL) || HasFlag(cpuUsage, Tr2CpuUsage.WRITE);\n\n    if (!writable && !initialData) return ALResult.E_INVALIDARG;\n\n    const format = CarbonPixelFormatToWebGpu[desc.GetFormat()] ?? null;\n\n    if (!format) return ALResult.E_INVALIDARG;\n\n    const webgpu = al.GetWebgpu();\n    if (!webgpu) return ALResult.E_INVALIDCALL;\n\n    const device = webgpu.GetDevice();\n    const usageFlags = webgpu.GetTextureUsage();\n    const srgbFormat = SrgbSiblingOf(format);\n    const mipCount = Math.max(1, desc.GetTrueMipCount());\n    const layers = type === TextureType.TEX_TYPE_3D ? Math.max(1, desc.GetDepth()) : Math.max(1, desc.GetArraySize());\n    let usage = usageFlags.TEXTURE_BINDING | usageFlags.COPY_DST;\n\n    if (HasFlag(gpuUsage, Tr2GpuUsage.RENDER_TARGET) || HasFlag(gpuUsage, Tr2GpuUsage.DEPTH_STENCIL))\n    {\n      usage |= usageFlags.RENDER_ATTACHMENT ?? 0;\n    }\n\n    this.m_texture = device.createTexture({\n      label: this.m_name || \"Tr2TextureAL\",\n      size: { width: desc.GetWidth(), height: desc.GetHeight(), depthOrArrayLayers: layers },\n      mipLevelCount: mipCount,\n      sampleCount: 1,\n      dimension: type === TextureType.TEX_TYPE_3D ? \"3d\" : \"2d\",\n      format,\n      usage,\n      ...(srgbFormat ? { viewFormats: [ srgbFormat ] } : {})\n    });\n    this.m_format = format;\n    this.m_srgbFormat = srgbFormat;\n    this.m_desc = desc;\n    this.m_msaa = msaa;\n    this.m_gpuUsage = gpuUsage;\n    this.m_cpuUsage = cpuUsage;\n    this.m_webgpu = webgpu;\n\n    if (initialData) this._Upload(initialData, mipCount, type);\n\n    return ALResult.S_OK;\n  }\n\n  /** One `writeTexture` per subresource, Carbon's `mip + layer * mipCount` order. */\n  _Upload(initialData, mipCount, type)\n  {\n    const desc = this.m_desc;\n    const queue = this.m_webgpu.GetDevice().queue;\n    const layerCount = type === TextureType.TEX_TYPE_3D ? 1 : Math.max(1, desc.GetArraySize());\n\n    for (let layer = 0; layer < layerCount; layer += 1)\n    {\n      for (let mip = 0; mip < mipCount; mip += 1)\n      {\n        const subresource = initialData[mip + layer * mipCount];\n\n        if (!subresource || !subresource.sysMem) continue;\n\n        const bytes = subresource.sysMem;\n        const pitch = subresource.sysMemPitch;\n        const slicePitch = subresource.sysMemSlicePitch || bytes.byteLength;\n        const depth = type === TextureType.TEX_TYPE_3D ? Math.max(1, desc.GetMipDepth(mip)) : 1;\n\n        queue.writeTexture(\n          { texture: this.m_texture, mipLevel: mip, origin: { x: 0, y: 0, z: layer } },\n          bytes,\n          { offset: 0, bytesPerRow: pitch, rowsPerImage: pitch ? Math.max(1, Math.floor(slicePitch / pitch)) : undefined },\n          { width: desc.GetMipWidth(mip), height: desc.GetMipHeight(mip), depthOrArrayLayers: depth }\n        );\n      }\n    }\n  }\n\n  /**\n   * The view a resource set binds: linear or sRGB, in the layout's dimension.\n   *\n   * Metal's `GetMetalTexture()` / `GetSRGBViewMetalTexture()`\n   * (`Tr2TextureALMetal.h:49-54`), with the dimension added because a WebGPU\n   * view must name it and a cube texture is legitimately bound as a 2d-array.\n   *\n   * @param {string} [viewDimension] A `GPUTextureViewDimension`.\n   * @param {number} [colorSpace] A `Tr2ColorSpace`; non-zero means sRGB.\n   * @returns {object|null} A `GPUTextureView`, or null before Create.\n   */\n  GetDeviceTextureView(viewDimension = VIEW_DIMENSION_OF_TYPE[this.m_desc?.GetType()] ?? \"2d\", colorSpace = 0)\n  {\n    if (!this.m_texture) return null;\n\n    const srgb = colorSpace !== 0 && this.m_srgbFormat !== null;\n    const key = `${viewDimension}:${srgb ? \"srgb\" : \"linear\"}`;\n    let view = this.m_views.get(key) ?? null;\n\n    if (!view)\n    {\n      view = this.m_texture.createView({\n        label: `${this.m_name || \"Tr2TextureAL\"} ${key}`,\n        dimension: viewDimension,\n        ...(srgb ? { format: this.m_srgbFormat } : {})\n      });\n      this.m_views.set(key, view);\n    }\n\n    return view;\n  }\n\n  /** The `GPUTexture`; Metal's `GetMetalTexture` under this backend's name. */\n  GetDeviceTexture()\n  {\n    return this.m_texture;\n  }\n\n  /** Whether the texture holds a `GPUTexture`. */\n  IsValid()\n  {\n    return this.m_texture !== null;\n  }\n\n  /** Shared textures need a native handle WebGPU does not expose; always fails. */\n  OpenShared()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** The `Tr2BitmapDimensions` this texture was created from, or null. */\n  GetDesc()\n  {\n    return this.m_desc;\n  }\n\n  /** The multisample description; this backend creates single-sampled textures. */\n  GetMsaaDesc()\n  {\n    return this.m_msaa;\n  }\n\n  /** The `Tr2GpuUsage` flags it was created with. */\n  GetGpuUsage()\n  {\n    return this.m_gpuUsage;\n  }\n\n  /** The `Tr2CpuUsage` flags it was created with. */\n  GetCpuUsage()\n  {\n    return this.m_cpuUsage;\n  }\n\n  /** Width in texels of mip zero, or zero before Create. */\n  GetWidth()\n  {\n    return this.m_desc ? this.m_desc.GetWidth() : 0;\n  }\n\n  /** Height in texels of mip zero, or zero before Create. */\n  GetHeight()\n  {\n    return this.m_desc ? this.m_desc.GetHeight() : 0;\n  }\n\n  /** Depth in texels of mip zero, which is one unless the texture is 3D. */\n  GetDepth()\n  {\n    return this.m_desc ? this.m_desc.GetDepth() : 0;\n  }\n\n  /** The mip count requested at creation, which may be zero for a full chain. */\n  GetMipCount()\n  {\n    return this.m_desc ? this.m_desc.GetMipCount() : 0;\n  }\n\n  /** The mip count actually created, with a requested zero resolved. */\n  GetTrueMipCount()\n  {\n    return this.m_desc ? this.m_desc.GetTrueMipCount() : 0;\n  }\n\n  /** The Carbon `PixelFormat`, or `PIXEL_FORMAT_UNKNOWN` before Create. */\n  GetFormat()\n  {\n    return this.m_desc ? this.m_desc.GetFormat() : PixelFormat.PIXEL_FORMAT_UNKNOWN;\n  }\n\n  /** The Carbon `TextureType`, or `TEX_TYPE_INVALID` before Create. */\n  GetType()\n  {\n    return this.m_desc ? this.m_desc.GetType() : TextureType.TEX_TYPE_INVALID;\n  }\n\n  /** The layer count, which for a cube counts its six faces. */\n  GetArraySize()\n  {\n    return this.m_desc ? this.m_desc.GetArraySize() : 0;\n  }\n\n  /**\n   * The byte size of one mip across all layers.\n   *\n   * @param {number} level The mip level.\n   * @returns {number} Its size in bytes, or zero before Create.\n   */\n  GetMipSize(level)\n  {\n    return this.m_desc ? this.m_desc.GetMipSize(level) : 0;\n  }\n\n  /** Reading back needs a staging buffer and an await; refused by name. */\n  MapForReading(_region, _synchronize, _renderContext)\n  {\n    return { result: ALResult.E_FAIL, data: null, pitch: 0 };\n  }\n\n  /** Paired with `MapForReading`, which this backend refuses. */\n  UnmapForReading(_renderContext)\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** Carbon's immutable texture cannot be mapped for writing either. */\n  MapForWriting(_region, _renderContext)\n  {\n    return { result: ALResult.E_FAIL, data: null, pitch: 0 };\n  }\n\n  /** Paired with `MapForWriting`, which this backend refuses. */\n  UnmapForWriting(_renderContext)\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /**\n   * Replaces one mip of one slice, Carbon's `UpdateSubresource`.\n   *\n   * @param {object} region A `Tr2TextureSubresource` naming one mip and slice.\n   * @param {ArrayBufferView} source The texels.\n   * @param {number} pitch Bytes per row.\n   * @param {number} slicePitch Bytes per slice.\n   * @returns {number} An `ALResult` value.\n   */\n  UpdateSubresource(region, source, pitch, slicePitch, _renderContext)\n  {\n    if (!this.IsValid()) return ALResult.E_INVALIDCALL;\n    if (!region || !source) return ALResult.E_INVALIDARG;\n\n    const mip = region.m_startMipLevel ?? 0;\n    const layer = region.m_startFace ?? 0;\n\n    this.m_webgpu.GetDevice().queue.writeTexture(\n      { texture: this.m_texture, mipLevel: mip, origin: { x: 0, y: 0, z: layer } },\n      source,\n      { offset: 0, bytesPerRow: pitch, rowsPerImage: pitch ? Math.max(1, Math.floor((slicePitch || source.byteLength) / pitch)) : undefined },\n      { width: this.m_desc.GetMipWidth(mip), height: this.m_desc.GetMipHeight(mip), depthOrArrayLayers: 1 }\n    );\n\n    return ALResult.S_OK;\n  }\n\n  /** Needs a command encoder the AL is not handed here; refused by name. */\n  CopySubresourceRegion()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** WebGPU has no mip generator; a full chain is uploaded at creation instead. */\n  GenerateMipMaps()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** Multisample resolve, which this backend has no multisampled textures for. */\n  Resolve()\n  {\n    return ALResult.E_FAIL;\n  }\n\n  /** The native shared handle, which WebGPU does not expose. */\n  GetSharedHandle()\n  {\n    return null;\n  }\n\n  /** The descriptor-heap slot, which only the D3D12 backend has. */\n  GetSrvIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n\n  /** The descriptor-heap slot, which only the D3D12 backend has. */\n  GetUavIndexInHeap()\n  {\n    return NO_HEAP_INDEX;\n  }\n\n  /** Releases the `GPUTexture` and its views, leaving the AL invalid. */\n  Destroy()\n  {\n    this.m_texture?.destroy?.();\n    this.m_texture = null;\n    this.m_views = new Map();\n    this.m_desc = null;\n    this.m_format = null;\n    this.m_srgbFormat = null;\n    this.m_webgpu = null;\n    this.m_gpuUsage = Tr2GpuUsage.NONE;\n    this.m_cpuUsage = Tr2CpuUsage.NONE;\n  }\n\n  /** Where the texture lives, which for this backend is always video memory. */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_VIDEO;\n  }\n\n  /**\n   * Fills in what this AL knows for a memory report.\n   *\n   * @param {object} description The description to fill in.\n   * @returns {object} The same description.\n   */\n  Describe(description)\n  {\n    if (!description) return description;\n\n    description.memoryClass = this.GetMemoryClass();\n\n    return description;\n  }\n\n  /**\n   * Names the texture, which reaches the `GPUTexture` label for debugging.\n   *\n   * @param {string} name The name.\n   * @returns {number} An `ALResult` value.\n   */\n  SetName(name)\n  {\n    this.m_name = String(name ?? \"\");\n\n    if (this.m_texture) this.m_texture.label = this.m_name;\n\n    return ALResult.S_OK;\n  }\n\n  /** The name given by `SetName`. */\n  GetName()\n  {\n    return this.m_name;\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(CjsWebgpuTextureAL, { className: \"CjsWebgpuTextureAL\", carbon: \"Tr2TextureAL\" });\n"],"names":["NO_HEAP_INDEX","VIEW_DIMENSION_OF_TYPE","Object","freeze","TextureType","TEX_TYPE_2D","TEX_TYPE_CUBE","TEX_TYPE_3D","CjsWebgpuTextureAL","m_desc","m_msaa","Tr2MsaaDesc","m_gpuUsage","Tr2GpuUsage","NONE","m_cpuUsage","Tr2CpuUsage","m_texture","m_format","m_srgbFormat","m_views","Map","m_webgpu","m_name","Create","desc","options","renderContext","Destroy","gpuUsage","cpuUsage","msaa","initialData","al","RenderContextALOf","IsValid","ALResult","E_FAIL","GetWidth","GetHeight","E_INVALIDARG","samples","type","GetType","dimension","GetArraySize","writable","HasFlag","RENDER_TARGET","UNORDERED_ACCESS","DEPTH_STENCIL","WRITE","format","CarbonPixelFormatToWebGpu","GetFormat","webgpu","GetWebgpu","E_INVALIDCALL","device","GetDevice","usageFlags","GetTextureUsage","srgbFormat","SrgbSiblingOf","mipCount","Math","max","GetTrueMipCount","layers","GetDepth","usage","TEXTURE_BINDING","COPY_DST","RENDER_ATTACHMENT","createTexture","label","size","width","height","depthOrArrayLayers","mipLevelCount","sampleCount","viewFormats","_Upload","S_OK","queue","layerCount","layer","mip","subresource","sysMem","bytes","pitch","sysMemPitch","slicePitch","sysMemSlicePitch","byteLength","depth","GetMipDepth","writeTexture","texture","mipLevel","origin","x","y","z","offset","bytesPerRow","rowsPerImage","floor","undefined","GetMipWidth","GetMipHeight","GetDeviceTextureView","viewDimension","colorSpace","srgb","key","view","get","createView","set","GetDeviceTexture","OpenShared","GetDesc","GetMsaaDesc","GetGpuUsage","GetCpuUsage","GetMipCount","PixelFormat","PIXEL_FORMAT_UNKNOWN","TEX_TYPE_INVALID","GetMipSize","level","MapForReading","_region","_synchronize","_renderContext","result","data","UnmapForReading","MapForWriting","UnmapForWriting","UpdateSubresource","region","source","m_startMipLevel","m_startFace","CopySubresourceRegion","GenerateMipMaps","Resolve","GetSharedHandle","GetSrvIndexInHeap","GetUavIndexInHeap","destroy","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_VIDEO","Describe","description","memoryClass","SetName","name","String","GetName","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/webgpu/core/{constantArena.js → CjsWebgpuConstantArena.js}

@@ -152,4 +152,4 @@ CjsSchema.define(CjsWebgpuConstantArena, {
 });
 
 export { CONST_ALIGNMENT, CONST_PAGE_SIZE, CjsWebgpuConstantArena };
-//# sourceMappingURL=constantArena.js.map
+//# sourceMappingURL=CjsWebgpuConstantArena.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuConstantArena.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuConstantArena.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuConstantArena.js"],"sourcesContent":["// Source: trinity/trinityal/metal/MetalUtils.h\n//   trinity/trinityal/metal/MetalUtils.mm:375-440\n//\n// Carbon's per-frame constant arena. Metal's `SetConstants` does not write into\n// a buffer the constant buffer owns; it copies the bytes into a page of this\n// allocator and binds `(page, offset)` (`MetalWorkQueue.mm:2396-2440`), and the\n// allocator is reset at the start of every frame (`MetalContext.mm:473`). That\n// is what gives each draw its own snapshot: a buffer locked three times and\n// drawn three times lands in three regions, and the three draws read three\n// different offsets.\n//\n// WHY THIS IS NOT OPTIONAL HERE. `queue.writeBuffer` into one GPUBuffer per\n// constant buffer executes before the frame's command buffer is submitted, so\n// every draw recorded in the frame would read the LAST write - every object\n// drawn with the last object's transform. The arena is the fix Carbon already\n// has, and the bind is a dynamic offset, which is WebGPU's spelling of Metal's\n// `setVertexBufferOffset:` (`MetalWorkQueue.mm:2656-2659`).\n//\n// Pages are 2 MiB, as Carbon's are, and allocations are aligned to the larger\n// of Carbon's 256 and the device's `minUniformBufferOffsetAlignment`, which a\n// dynamic offset must be a multiple of.\n\n\nimport { CjsSchema } from \"#schema\";\nfunction fail(message)\n{\n  const error = new Error(`CjsWebgpuConstantArena: ${message}`);\n  error.code = \"CJS_WEBGPU_CONSTANT_ARENA_INVALID\";\n  throw error;\n}\n\n\n/** `CONST_PAGE_SIZE` */\nexport const CONST_PAGE_SIZE = 2 * 1024 * 1024;\n\n/** `CONST_ALIGNMENT` */\nexport const CONST_ALIGNMENT = 256;\n\n\n/**\n * A per-frame arena of `GPUBuffer` pages that constant buffers are suballocated\n * into when they are bound.\n */\nexport class CjsWebgpuConstantArena\n{\n  /** m_pages: one `GPUBuffer` per page, created on first use. */\n  m_pages = [];\n\n  /** The current page index and the offset the next allocation takes. */\n  m_page = 0;\n\n  m_offset = 0;\n\n  /** m_totalUploadedSize, for a stats line. */\n  m_totalUploadedSize = 0;\n\n  m_webgpu = null;\n\n  m_alignment = CONST_ALIGNMENT;\n\n  /**\n   * @param {object} webgpu The `CjsWebgpuDevice`.\n   */\n  constructor(webgpu)\n  {\n    if (!webgpu) fail(\"a device is required\");\n\n    this.m_webgpu = webgpu;\n\n    const limit = webgpu.GetDevice()?.limits?.minUniformBufferOffsetAlignment;\n\n    if (Number.isInteger(limit) && limit > CONST_ALIGNMENT) this.m_alignment = limit;\n  }\n\n  /** Carbon's `Reset`: the next frame starts at page zero, offset zero. */\n  Reset()\n  {\n    this.m_page = 0;\n    this.m_offset = 0;\n    this.m_totalUploadedSize = 0;\n  }\n\n  /**\n   * Copies bytes into the arena and says where they landed.\n   *\n   * @param {Uint8Array} bytes The constants; may be shorter than `size`.\n   * @param {number} size Bytes to reserve, at least the bytes' length.\n   * @returns {{page: number, offset: number, size: number}} The region.\n   */\n  Allocate(bytes, size = bytes.byteLength)\n  {\n    const reserved = Math.ceil(Math.max(size, bytes.byteLength, 1) / this.m_alignment) * this.m_alignment;\n\n    if (reserved > CONST_PAGE_SIZE) fail(`a constant buffer of ${size} bytes does not fit a ${CONST_PAGE_SIZE}-byte page`);\n\n    if (this.m_offset + reserved > CONST_PAGE_SIZE)\n    {\n      this.m_totalUploadedSize += this.m_offset;\n      this.m_page += 1;\n      this.m_offset = 0;\n    }\n\n    const page = this.GetPage(this.m_page);\n    const offset = this.m_offset;\n\n    this.m_offset += reserved;\n\n    // `writeBuffer` wants a four-byte-aligned length; the reserve is.\n    this.m_webgpu.GetDevice().queue.writeBuffer(page, offset, bytes, 0, bytes.byteLength & ~3);\n\n    return { page: this.m_page, offset, size: reserved };\n  }\n\n  /**\n   * The `GPUBuffer` for a page, created on first use.\n   *\n   * @param {number} page The page index.\n   * @returns {object} The buffer.\n   */\n  GetPage(page)\n  {\n    if (!this.m_pages[page]) this._CreatePage(page);\n\n    return this.m_pages[page];\n  }\n\n  /**\n   * Allocates one page's `GPUBuffer`, Carbon's `CreatePage`\n   * (`MetalUtils.mm:432-439`).\n   *\n   * Carbon calls it from `Allocate` when the offset runs past the page and the\n   * next page has never been made; ours is reached through `GetPage`, which is\n   * the same \"make it if it is not there\" with one caller instead of two.\n   *\n   * @param {number} index The page index.\n   * @returns {void}\n   */\n  _CreatePage(index)\n  {\n    const usage = this.m_webgpu.GetBufferUsage();\n\n    this.m_pages[index] = this.m_webgpu.GetDevice().createBuffer({\n      label: `Constant buffer page ${index}`,\n      size: CONST_PAGE_SIZE,\n      usage: usage.UNIFORM | usage.COPY_DST\n    });\n  }\n\n  /** Bytes allocated this frame so far. */\n  GetTotalUploadedSize()\n  {\n    return this.m_totalUploadedSize + this.m_offset;\n  }\n\n  /** Releases every page. */\n  Destroy()\n  {\n    for (const page of this.m_pages) page?.destroy?.();\n\n    this.m_pages = [];\n    this.Reset();\n  }\n}\n\n\n// DECLARED AS A CALL, NOT A DECORATOR. The abstraction layer is imported\n// straight from source by its tests - `#trinityal/...` resolves to `src/` - and\n// raw Node cannot parse decorator syntax, so a decorator here breaks every test\n// that reaches this file without a build first. `CjsSchema.define` is the same\n// metadata through the door the schema already provides for exactly this, and\n// it keeps the layer free of the decorator chain it has never carried.\nCjsSchema.define(CjsWebgpuConstantArena, { className: \"CjsWebgpuConstantArena\", carbon: \"ConstantBufferAllocator\" });\n"],"names":["fail","message","error","Error","code","CONST_PAGE_SIZE","CONST_ALIGNMENT","CjsWebgpuConstantArena","m_pages","m_page","m_offset","m_totalUploadedSize","m_webgpu","m_alignment","constructor","webgpu","limit","GetDevice","limits","minUniformBufferOffsetAlignment","Number","isInteger","Reset","Allocate","bytes","size","byteLength","reserved","Math","ceil","max","page","GetPage","offset","queue","writeBuffer","_CreatePage","index","usage","GetBufferUsage","createBuffer","label","UNIFORM","COPY_DST","GetTotalUploadedSize","Destroy","destroy","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/webgpu/core/{batchGroups.js → CjsWebgpuEncodeState.js}

@@ -178,4 +178,4 @@ CjsSchema.define(CjsWebgpuEncodeState, {
 });
 
 export { CanShareBindings, CjsWebgpuEncodeState, DeriveBatchGroups };
-//# sourceMappingURL=batchGroups.js.map
+//# sourceMappingURL=CjsWebgpuEncodeState.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuEncodeState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuEncodeState.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuEncodeState.js"],"sourcesContent":["// Source: trinity/trinity/Tr2RenderContext.cpp:462-537\n//   `RenderBatchGroup` is a METHOD, so this file is MODELLED ON the class that\n//   declares it rather than replicating one: what it ports is the state that\n//   method keeps across a group - what the encoder already has bound - and\n//   there is no class surface to compare against.\n// Source: trinity/trinity/TriRenderBatch.cpp (CanBeBinned)\n//\n// Carbon hoists per GROUP what does not change across a run of batches -\n// standard states for the rendering mode, the shader state interface taken from\n// the MATERIAL rather than the batch's own shader pointer, technique index,\n// pass count, vertex declaration, both stream sources and the index buffer -\n// then applies the pass, then does only material constants, per-object\n// constants, topology and the draw per batch. This dispatcher did all of it per\n// batch, which is what made groupCount and the GDPR partition mean nothing.\n//\n// TWO DELIBERATE DEVIATIONS FROM CARBON, both from the engine-backends plan's\n// decision 3.\n//\n// 1. THE INDEX BUFFER IS PART OF THE PREDICATE. Carbon's CanBeBinned compares\n//    shader, vertex declaration, index stride, both vertex streams and\n//    rendering mode - and NOT the index buffer - while RenderBatchGroup then\n//    binds and branches on the FIRST batch's index buffer. That is sound only\n//    because all Carbon geometry is suballocated from one process-global\n//    buffer, so any two binnable batches necessarily share it. An engine that\n//    gives each geometry its own buffer breaks it SILENTLY, drawing the first\n//    batch's indices for every batch in the run. We are that engine.\n//\n// 2. RUNS ARE DERIVED HERE, NOT CONSUMED FROM A PRECOMPUTED PARTITION. Carbon\n//    stamps groupCount during Finalize; its split loop advances past the\n//    boundary element without re-checking it, and its correctness depends on\n//    the sort order and the equivalence predicate agreeing with nothing\n//    validating that they do. Deriving runs from the batches actually being\n//    encoded cannot disagree with itself.\n//\n// Ordering is never changed here. Sorting belongs to Trinity, and reordering at\n// encode time would break the golden-image comparison the two engines are meant\n// to be judged by. This only finds runs of ADJACENT batches that already agree.\n//\n// The WebGPU translation of Carbon's group key: a render pipeline already folds\n// the shader program, render states, vertex layout and topology into one\n// object, so pipeline identity carries most of CanBeBinned by construction.\n// What it does not carry is which buffers are bound, so the vertex buffers and\n// the index buffer are compared explicitly. Bind groups stay per batch: they\n// are where per-object data lives, and that is exactly what varies within a\n// group.\n\nimport { CjsSchema } from \"#schema\";\n\n/**\n * Whether two prepared draws may share one hoisted binding run.\n *\n * Compares only what a run hoists. Anything set per batch - bind groups, draw\n * arguments - is deliberately absent, because differing there is the normal\n * case inside a group rather than a reason to split one.\n */\nexport function CanShareBindings(first, second)\n{\n  if (!first || !second) return false;\n  if (first === second) return true;\n  if (first.livePipeline !== second.livePipeline) return false;\n  if (first.indexed !== second.indexed) return false;\n  if (!sameVertexBuffers(first.vertexBuffers, second.vertexBuffers)) return false;\n\n  // Decision 3's correction. Two batches on the same pipeline and vertex\n  // streams still draw different indices, and Carbon's own predicate would\n  // have said yes here.\n  return sameIndexBuffer(first.indexed, first.indexBuffer, second.indexBuffer);\n}\n\n\n/**\n * Derives runs of adjacent prepared batches that share hoistable state.\n *\n * Returns one entry per run with its start, end and length, in encode order.\n * Every batch appears in exactly one run, and a run of one is normal - it means\n * that batch shares nothing with its neighbours, not that grouping failed.\n */\nexport function DeriveBatchGroups(batches, resolveDraw = handle => handle?.draw)\n{\n  const groups = [];\n  const list = batches ?? [];\n  let start = 0;\n\n  for (let index = 1; index <= list.length; index += 1)\n  {\n    const isEnd = index === list.length;\n    const shares = !isEnd && CanShareBindings(resolveDraw(list[index - 1]), resolveDraw(list[index]));\n\n    if (isEnd || !shares)\n    {\n      if (index > start) groups.push({ start, end: index, length: index - start });\n      start = index;\n    }\n  }\n\n  return groups;\n}\n\n\n/**\n * A per-pass record of what is already bound, so a run's second and later\n * batches skip the sets their first batch performed.\n *\n * Bound to ONE pass encoder and fails loudly if reused with another: WebGPU\n * pass state does not survive a pass boundary, so a state object leaking\n * across passes would silently skip a set that genuinely had to happen. That\n * failure would appear as geometry drawn with a previous pass's buffers, which\n * is exactly the class of bug this file exists to prevent.\n */\nexport class CjsWebgpuEncodeState\n{\n  _pass = null;\n\n  _pipeline = null;\n\n  _vertexBuffers = null;\n\n  _indexBuffer = null;\n\n  _bindGroups = [];\n\n  /** Binds this state to a pass, rejecting a second one. */\n  Require(pass)\n  {\n    if (this._pass === null) this._pass = pass;\n    else if (this._pass !== pass)\n    {\n      const error = new Error(\"CjsWebgpuEncodeState: encode state belongs to another render pass\");\n      error.code = \"CJS_WEBGPU_ENCODE_STATE_INVALID\";\n      throw error;\n    }\n    return this;\n  }\n\n  /** Whether the pipeline needs setting, recording it when it does. */\n  NeedsPipeline(pipeline)\n  {\n    if (this._pipeline === pipeline) return false;\n    this._pipeline = pipeline;\n    return true;\n  }\n\n  /** Whether the vertex buffers need setting, recording them when they do. */\n  NeedsVertexBuffers(entries)\n  {\n    if (sameVertexBuffers(this._vertexBuffers, entries)) return false;\n    this._vertexBuffers = entries;\n    return true;\n  }\n\n  /** Whether the index buffer needs setting, recording it when it does. */\n  NeedsIndexBuffer(entry)\n  {\n    if (sameIndexBuffer(true, this._indexBuffer, entry)) return false;\n    this._indexBuffer = entry;\n    return true;\n  }\n\n  /** Whether one bind group needs setting, recording it when it does. */\n  NeedsBindGroup(index, bindGroup)\n  {\n    if (this._bindGroups[index] === bindGroup) return false;\n    this._bindGroups[index] = bindGroup;\n    return true;\n  }\n}\n\n\nfunction sameVertexBuffers(first, second)\n{\n  if (first === second) return true;\n  if (!first || !second || first.length !== second.length) return false;\n\n  for (let index = 0; index < first.length; index += 1)\n  {\n    const a = first[index];\n    const b = second[index];\n    if (a.slot !== b.slot || a.buffer !== b.buffer) return false;\n    if ((a.offset ?? 0) !== (b.offset ?? 0) || a.size !== b.size) return false;\n  }\n\n  return true;\n}\n\n\nfunction sameIndexBuffer(indexed, first, second)\n{\n  if (!indexed) return true;\n  if (first === second) return true;\n  if (!first || !second) return false;\n\n  return first.buffer === second.buffer\n    && first.format === second.format\n    && (first.offset ?? 0) === (second.offset ?? 0)\n    && first.size === second.size;\n}\n\n\n// DECLARED AS A CALL, NOT A DECORATOR. The abstraction layer is imported\n// straight from source by its tests - `#trinityal/...` resolves to `src/` - and\n// raw Node cannot parse decorator syntax, so a decorator here breaks every test\n// that reaches this file without a build first. `CjsSchema.define` is the same\n// metadata through the door the schema already provides for exactly this, and\n// it keeps the layer free of the decorator chain it has never carried.\nCjsSchema.define(CjsWebgpuEncodeState, { className: \"CjsWebgpuEncodeState\", modelledOn: \"Tr2RenderContextBase\" });\n"],"names":["CanShareBindings","first","second","livePipeline","indexed","sameVertexBuffers","vertexBuffers","sameIndexBuffer","indexBuffer","DeriveBatchGroups","batches","resolveDraw","handle","draw","groups","list","start","index","length","isEnd","shares","push","end","CjsWebgpuEncodeState","_pass","_pipeline","_vertexBuffers","_indexBuffer","_bindGroups","Require","pass","error","Error","code","NeedsPipeline","pipeline","NeedsVertexBuffers","entries","NeedsIndexBuffer","entry","NeedsBindGroup","bindGroup","a","b","slot","buffer","offset","size","format","CjsSchema","define","className","modelledOn"],"mappings":"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"}

package/dist/trinityal/webgpu/core/{perFrameSource.js → CjsWebgpuPerFrameSource.js}

@@ -65,4 +65,4 @@ class CjsWebgpuPerFrameSource {
 }
 
 export { CjsWebgpuPerFrameSource };
-//# sourceMappingURL=perFrameSource.js.map
+//# sourceMappingURL=CjsWebgpuPerFrameSource.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuPerFrameSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuPerFrameSource.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuPerFrameSource.js"],"sourcesContent":["// The scene's per-frame constants, for the two registers Carbon reserves.\n//\n// Short because everything it needs already exists. EveSpaceScene owns the two\n// records (`m_perFrameVS`/`m_perFramePS`), EveSpaceSceneRenderDriver already\n// fills them each frame in Carbon's order - PS then VS - and RawData extends\n// CjsConstantPayload, so the packed bytes are one call away. What was missing\n// was only the join: nothing carried them from the scene to a binding.\n//\n// b1 and b2 are not optional decoration. Every v5 shader binds both, so a hull\n// cannot be drawn without them, which is why the resolver refuses rather than\n// leaving them empty.\n//\n// The records are PERSISTENT and scene-owned, not leased per draw\n// (`RawData.create`), so this hands back a live view rather than a copy: two\n// batches in one frame read the same bytes, which is the point of a per-frame\n// buffer.\nimport { PER_FRAME_PS, PER_FRAME_VS } from \"#trinity/core/Tr2Renderer\";\n\n\nfunction fail(message)\n{\n  const error = new Error(`CjsWebgpuPerFrameSource: ${message}`);\n  error.code = \"CJS_WEBGPU_PER_FRAME_SOURCE_INVALID\";\n  throw error;\n}\n\n\n/** Supplies the per-frame constant registers from one scene. */\nexport class CjsWebgpuPerFrameSource\n{\n  _scene;\n\n  /**\n   * @param {object} scene Scene owning the per-frame records.\n   */\n  constructor(scene)\n  {\n    if (!scene) fail(\"a scene is required; nothing else owns per-frame data\");\n\n    this._scene = scene;\n  }\n\n  /**\n   * The packed bytes for one per-frame register.\n   *\n   * @param {number} slot Constant-buffer register, 1 or 2.\n   * @returns {ArrayBufferView} The scene's packed record.\n   */\n  Resolve(slot)\n  {\n    // A scene HAS both accessors; only the slot number is in question.\n    const record = slot === PER_FRAME_VS\n      ? this._scene.GetPerFrameVSData()\n      : (slot === PER_FRAME_PS ? this._scene.GetPerFramePSData() : null);\n\n    if (!record)\n    {\n      fail(`b${slot} is not a per-frame register, or the scene holds no record for it`);\n    }\n\n    const data = record.GetData();\n\n    // A record that packs to nothing would bind an empty buffer and draw a\n    // black frame, which reads as a lighting bug rather than a missing upload.\n    if (!ArrayBuffer.isView(data)) fail(`the scene's b${slot} record did not pack to a typed array`);\n\n    return data;\n  }\n\n  /**\n   * A resolver hook bound to this source.\n   *\n   * @returns {Function} `(slot) => ArrayBufferView`\n   */\n  ResolvePerFrame()\n  {\n    return (slot) => this.Resolve(slot);\n  }\n}\n"],"names":["fail","message","error","Error","code","CjsWebgpuPerFrameSource","_scene","constructor","scene","Resolve","slot","record","PER_FRAME_VS","GetPerFrameVSData","PER_FRAME_PS","GetPerFramePSData","data","GetData","ArrayBuffer","isView","ResolvePerFrame"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIA,SAASA,IAAIA,CAACC,OAAO,EACrB;EACE,MAAMC,KAAK,GAAG,IAAIC,KAAK,CAAC,CAAA,yBAAA,EAA4BF,OAAO,EAAE,CAAC;EAC9DC,KAAK,CAACE,IAAI,GAAG,qCAAqC;AAClD,EAAA,MAAMF,KAAK;AACb;;AAGA;AACO,MAAMG,uBAAuB,CACpC;EACEC,MAAM;;AAEN;AACF;AACA;EACEC,WAAWA,CAACC,KAAK,EACjB;AACE,IAAA,IAAI,CAACA,KAAK,EAAER,IAAI,CAAC,uDAAuD,CAAC;IAEzE,IAAI,CAACM,MAAM,GAAGE,KAAK;AACrB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;EACEC,OAAOA,CAACC,IAAI,EACZ;AACE;IACA,MAAMC,MAAM,GAAGD,IAAI,KAAKE,YAAY,GAChC,IAAI,CAACN,MAAM,CAACO,iBAAiB,EAAE,GAC9BH,IAAI,KAAKI,YAAY,GAAG,IAAI,CAACR,MAAM,CAACS,iBAAiB,EAAE,GAAG,IAAK;IAEpE,IAAI,CAACJ,MAAM,EACX;AACEX,MAAAA,IAAI,CAAC,CAAA,CAAA,EAAIU,IAAI,CAAA,iEAAA,CAAmE,CAAC;AACnF,IAAA;AAEA,IAAA,MAAMM,IAAI,GAAGL,MAAM,CAACM,OAAO,EAAE;;AAE7B;AACA;AACA,IAAA,IAAI,CAACC,WAAW,CAACC,MAAM,CAACH,IAAI,CAAC,EAAEhB,IAAI,CAAC,CAAA,aAAA,EAAgBU,IAAI,uCAAuC,CAAC;AAEhG,IAAA,OAAOM,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEI,EAAAA,eAAeA,GACf;AACE,IAAA,OAAQV,IAAI,IAAK,IAAI,CAACD,OAAO,CAACC,IAAI,CAAC;AACrC,EAAA;AACF;;;;"}

package/dist/trinityal/webgpu/core/{pipelineCache.js → CjsWebgpuPipelineCache.js}

@@ -147,4 +147,4 @@ function RenderPipelineKey(programIdentity, recipe) {
 }
 
 export { CanonicalKey, CjsWebgpuPipelineCache, RenderPipelineKey };
-//# sourceMappingURL=pipelineCache.js.map
+//# sourceMappingURL=CjsWebgpuPipelineCache.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuPipelineCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuPipelineCache.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuPipelineCache.js"],"sourcesContent":["// The Stage B pipeline cache, which this engine did not have.\r\n//\r\n// The engine-backends plan splits effect realization the way Carbon splits it.\r\n// Stage A is program identity and dedup, backend-independent, and\r\n// The runtime resource layer already has it in `passUnitSignature` and `unit.sha256`.\r\n// Stage B is the pipeline object itself, backend-owned, and its key differs per\r\n// backend: DX12 keys an ID3D12PipelineState on a dirty-tracked PSODescription,\r\n// Metal on a combined hash of device, functions, vertex descriptor and\r\n// attachments, and DX11 has no monolithic object but four caches including an\r\n// input-layout cache keyed on the vertex shader's input signature.\r\n//\r\n// This device had none. Every PreparePipeline call created fresh shader\r\n// modules, bind-group layouts and a pipeline layout, and recorded the result in\r\n// a WeakMap keyed by the handle object it had just made - which caches nothing,\r\n// because a fresh handle never hits.\r\n//\r\n// KEYS ARE EXACT, NOT HASHED. Carbon's Metal cache is keyed on a hash value\r\n// with no equality recheck, so a collision silently returns the WRONG pipeline;\r\n// DX12 rechecks. Rather than hash and recheck, the key here is the canonical\r\n// serialization itself, so two different pipelines cannot collide in the first\r\n// place and there is nothing to recheck. That is only affordable because a\r\n// recipe is a small POD block; it is why the program half is named by the\r\n// caller instead.\r\n//\r\n// A CALLER THAT CANNOT NAME ITS PROGRAM GETS NO CACHE. Shader source is far too\r\n// large to serialize into a key on every call, and this package has no\r\n// dependency to hash it with. So the identity is supplied - the composed path\r\n// already has one from the runtime resource layer - and an unnamed pipeline is prepared\r\n// uncached, which is never wrong, only slower. Guessing an identity from the\r\n// descriptor's `key` would be worse than no cache: \"Main.pass0\" is the most\r\n// common pass name in the corpus and never dedupes across effects, so it would\r\n// hand back another effect's pipeline.\r\n//\r\n// EVERYTHING IS GENERATION-BOUND. Carbon's registry handles are indices that go\r\n// stale wholesale on device reset. Ours are garbage-collected objects, so a\r\n// stale entry would keep a dead device's pipeline alive and hand it out; each\r\n// entry records the generation it was built for and a mismatch misses.\r\n\r\nfunction fail(message)\r\n{\r\n  const error = new Error(`CjsWebgpuPipelineCache: ${message}`);\r\n  error.code = \"CJS_WEBGPU_PIPELINE_CACHE_INVALID\";\r\n  throw error;\r\n}\r\n\r\n\r\n/**\r\n * Canonically serializes a value so two structurally equal inputs produce the\r\n * same string regardless of property order.\r\n *\r\n * Object key order is normalized because a recipe assembled by different code\r\n * paths is the same recipe, and treating `{topology, cullMode}` as different\r\n * from `{cullMode, topology}` would miss every such hit.\r\n */\r\nexport function CanonicalKey(value)\r\n{\r\n  if (value === null || value === undefined) return String(value);\r\n  if (typeof value !== \"object\") return `${typeof value}:${String(value)}`;\r\n  if (Array.isArray(value)) return `[${value.map(CanonicalKey).join(\",\")}]`;\r\n\r\n  const entries = Object.keys(value)\r\n    .filter(name => value[name] !== undefined)\r\n    .sort()\r\n    .map(name => `${name}=${CanonicalKey(value[name])}`);\r\n\r\n  return `{${entries.join(\",\")}}`;\r\n}\r\n\r\n\r\n/**\r\n * A generation-bound cache of asynchronously built pipeline objects.\r\n *\r\n * In-flight builds are cached as promises, so two callers racing for the same\r\n * pipeline share one build rather than each creating a GPU object and one\r\n * silently winning. That matters more here than in Carbon: pipeline creation is\r\n * asynchronous on this backend and a frame legitimately prepares many at once.\r\n */\r\nexport class CjsWebgpuPipelineCache\r\n{\r\n  _entries = new Map();\r\n\r\n  /** How many entries are held, for diagnostics and tests. */\r\n  get size()\r\n  {\r\n    return this._entries.size;\r\n  }\r\n\r\n  /**\r\n   * Returns the cached value for a key, building it when absent.\r\n   *\r\n   * `key` must be a stable exact identity; `null` or `undefined` bypasses the\r\n   * cache entirely and simply builds, which is what an unnamed pipeline gets.\r\n   * A failed build is not retained, so a transient device error does not\r\n   * poison the key forever.\r\n   */\r\n  async Resolve(key, generation, build)\r\n  {\r\n    if (typeof build !== \"function\") fail(\"a build function is required\");\r\n    if (key === null || key === undefined) return build();\r\n\r\n    const entry = this._entries.get(key);\r\n    if (entry)\r\n    {\r\n      if (entry.generation === generation) return entry.value;\r\n      // A pipeline built for a device that is gone is not repairable, and\r\n      // handing it back would use a dead GPU object.\r\n      this._entries.delete(key);\r\n    }\r\n\r\n    const value = build();\r\n    this._entries.set(key, { generation, value });\r\n\r\n    try\r\n    {\r\n      return await value;\r\n    }\r\n    catch (error)\r\n    {\r\n      if (this._entries.get(key)?.value === value) this._entries.delete(key);\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /** Drops entries not built for the given generation. */\r\n  Prune(generation)\r\n  {\r\n    for (const [ key, entry ] of this._entries)\r\n    {\r\n      if (entry.generation !== generation) this._entries.delete(key);\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /** Drops every entry, as a device reset requires. */\r\n  Clear()\r\n  {\r\n    this._entries.clear();\r\n    return this;\r\n  }\r\n}\r\n\r\n\r\n/**\r\n * The Stage B key for a render pipeline: the prepared program's identity plus\r\n * the recipe's POD block.\r\n *\r\n * Returns null when the program has no identity, which is how an unnamed\r\n * pipeline declines the cache rather than being keyed on its recipe alone -\r\n * two different programs share a recipe constantly.\r\n */\r\nexport function RenderPipelineKey(programIdentity, recipe)\r\n{\r\n  if (programIdentity === null || programIdentity === undefined) return null;\r\n\r\n  const identity = CanonicalKey(programIdentity);\r\n\r\n  // AN OBJECT THAT CANONICALISES TO NOTHING IS NOT AN IDENTITY. `Object.keys`\r\n  // does not see private fields, so a class instance whose state is entirely\r\n  // private - `CjsWebgpuShaderProgramAL` is exactly that - yields `{}` and\r\n  // passes the null guard above. Every such program would then key\r\n  // IDENTICALLY, which is the collision the comment above says must not\r\n  // happen: two different programs share a recipe constantly.\r\n  //\r\n  // Declining the cache is the documented behaviour for a program with no\r\n  // identity, so that is what this does rather than inventing one. A backend\r\n  // that wants its pipelines cached gives its programs a real identity.\r\n  if (identity === \"{}\") return null;\r\n\r\n  return `${identity}|${CanonicalKey(recipe ?? null)}`;\r\n}\r\n"],"names":["fail","message","error","Error","code","CanonicalKey","value","undefined","String","Array","isArray","map","join","entries","Object","keys","filter","name","sort","CjsWebgpuPipelineCache","_entries","Map","size","Resolve","key","generation","build","entry","get","delete","set","Prune","Clear","clear","RenderPipelineKey","programIdentity","recipe","identity"],"mappings":"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"}

package/dist/trinityal/webgpu/core/{psoDescription.js → CjsWebgpuPsoDescription.js}

@@ -1,5 +1,5 @@
 import { CjsSchema } from '#schema';
-import { RenderPipelineKey } from './pipelineCache.js';
+import { RenderPipelineKey } from './CjsWebgpuPipelineCache.js';
 import { TOPOLOGIES } from './topology.js';
 
 // Source: trinity/trinityal/dx12/util/PsoDescription.h
@@ -175,4 +175,4 @@ CjsSchema.define(CjsWebgpuPsoDescription, {
 });
 
 export { CjsWebgpuPsoDescription };
-//# sourceMappingURL=psoDescription.js.map
+//# sourceMappingURL=CjsWebgpuPsoDescription.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuPsoDescription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuPsoDescription.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuPsoDescription.js"],"sourcesContent":["// Source: trinity/trinityal/dx12/util/PsoDescription.h\n//   trinity/trinityal/dx12/util/PsoDescription.cpp\n//   trinity/trinityal/dx12/Tr2RenderContextDx12.cpp (the setters and SetAllState)\n//\n// The pipeline description a draw resolves, and the fourth piece of the\n// immediate-draw route.\n//\n// WHAT CARBON DOES. Its backend does not assemble a pipeline per draw. The\n// setters describe one incrementally and mark it dirty\n// (`Tr2RenderContextDx12.cpp:315-338`: each compares before dirtying, so a\n// redundant apply costs nothing), and the draw resolves it:\n//\n//     m_psoDescription.UpdateHash();                                  // cpp:793\n//     auto found = m_ownerDevice->m_pipelineStates.find( m_psoDescription );\n//     if( found != end ) return found->second;\n//     m_psoDescription.CreatePipelineState( device, pipelineState );\n//     m_ownerDevice->m_pipelineStates[ m_psoDescription ] = pipelineState;\n//\n// THE CACHE IS ON THE DEVICE, NOT THE CONTEXT (`Tr2PrimaryRenderContextDx12.h:319`),\n// which is why two contexts drawing the same material share one pipeline. Ours\n// is `CjsWebgpuPipelineCache`, already on `CjsWebgpuDevice` and already serving\n// the batch path - this describes, and hands the description to that.\n//\n// Carbon's fields, and where each lives here:\n//\n//   m_vertexLayout        -> vertexBufferLayouts, from the bound layout\n//   m_shaderProgram       -> shaderProgram, a CjsWebgpuShaderProgramAL\n//   m_topologyType        -> topology, mapped through the AL's own table\n//   m_blendDesc           }\n//   m_rasterizerDesc      }  all three -> renderStateSetup + overrides, which\n//   m_depthStencilDesc    }  `GetWebgpuRecipe` projects. WebGPU folds state into\n//                            a pipeline at creation, so the three descriptors\n//                            are one projection rather than three structs.\n//   m_renderTargetFormats -> colorFormats\n//   m_depthStencilFormat  -> depthFormat\n//   m_sampleDesc          -> sampleCount\n//   m_vertexStreamMask    -> derived from vertexBufferLayouts\n//\n// THE PROJECTION IS NOT REIMPLEMENTED HERE. `Tr2RenderStateSetup.GetWebgpuRecipe`\n// already turns an interpreted setup into WebGPU state, applies the render-state\n// overrides while doing it, and refuses a fill mode WebGPU cannot rasterize. A\n// second translator is the mistake this whole lane exists to undo.\nimport { CjsSchema } from \"#schema\";\nimport { RenderPipelineKey } from \"./CjsWebgpuPipelineCache.js\";\nimport { TOPOLOGIES } from \"./topology.js\";\n\n\n/**\n * A pipeline description, filled by the abstraction layer's setters.\n *\n * Carbon's `PSODescription` is a plain struct with an `operator==` and a hash;\n * this is the same, with `GetKey` standing in for both because a canonical key\n * compares and hashes at once.\n */\nexport class CjsWebgpuPsoDescription\n{\n  /** m_shaderProgram */\n  shaderProgram = null;\n\n  /** m_vertexLayout, as WebGPU buffer layouts. */\n  vertexBufferLayouts = [];\n\n  /** m_topologyType, in the abstraction layer's vocabulary. */\n  topology = null;\n\n  /** The authored state, projected at resolve time. */\n  renderStateSetup = null;\n\n  /** The state manager's overrides, applied by the projection. */\n  renderStateOverrides = null;\n\n  /** m_renderTargetFormats[MAX_RENDER_TARGET] */\n  colorFormats = [];\n\n  /** m_depthStencilFormat; null means no depth attachment. */\n  depthFormat = null;\n\n  /** m_sampleDesc, reduced to the one field WebGPU exposes. */\n  sampleCount = 1;\n\n  /**\n   * Whether the description names everything a pipeline needs.\n   *\n   * Carbon's `GetPipelineState` returns null and `SetAllState` fails\n   * (`cpp:847-851`) rather than creating a partial pipeline; this is the same\n   * check, made before the attempt so the caller can say what is missing.\n   *\n   * @returns {string|null} What is missing, or null when complete.\n   */\n  GetMissing()\n  {\n    if (!this.shaderProgram || !this.shaderProgram.IsValid()) return \"a linked shader program\";\n    if (!this.renderStateSetup) return \"a render-state setup\";\n    if (this.topology === null || TOPOLOGIES[this.topology] === undefined) return \"a topology WebGPU can draw\";\n    if (this.colorFormats.length === 0 && this.depthFormat === null) return \"a colour or depth attachment\";\n\n    return null;\n  }\n\n  /**\n   * The WebGPU pipeline descriptor this description resolves to.\n   *\n   * Carbon's `CreatePipelineState` builds a `D3D12_GRAPHICS_PIPELINE_STATE_DESC`\n   * from the same fields. Ours produces the recipe shape the device's pipeline\n   * factory already takes from the batch path, so both paths create pipelines\n   * the same way.\n   *\n   * @returns {object} The recipe.\n   */\n  BuildRecipe()\n  {\n    const projected = this.renderStateSetup.GetWebgpuRecipe({\n      depthFormat: this.depthFormat,\n      invertedDepthTest: !!this.renderStateOverrides?.invertedDepthTest,\n      invertedCullMode: !!this.renderStateOverrides?.invertedCullMode\n    });\n\n    return {\n      ...projected,\n      primitive: { ...projected.primitive, topology: TOPOLOGIES[this.topology] },\n      vertex: { buffers: this.vertexBufferLayouts },\n      fragment: {\n        targets: this.colorFormats.map(format => ({ format, blend: projected.blend ?? undefined }))\n      },\n      multisample: { count: this.sampleCount }\n    };\n  }\n\n  /**\n   * The cache key, which is Carbon's `UpdateHash` plus `operator==` at once.\n   *\n   * Two descriptions with the same key resolve to the same pipeline, which is\n   * the whole point of describing rather than assembling: a frame that draws\n   * two hundred objects through one material creates one pipeline.\n   *\n   * @returns {string|null} The key, or null when the description is incomplete.\n   */\n  GetKey()\n  {\n    if (this.GetMissing()) return null;\n\n    // A real program names itself; a stand-in keys on its own fields. Metal\n    // hashes the function pointers for this (`MetalWorkQueue.mm:1610-1611`),\n    // and canonicalising a program's modules would serialise device objects.\n    const identity = typeof this.shaderProgram.GetIdentity === \"function\"\n      ? this.shaderProgram.GetIdentity()\n      : this.shaderProgram;\n\n    return RenderPipelineKey(identity, this.BuildRecipe());\n  }\n\n  /**\n   * Whether two descriptions resolve to the same pipeline.\n   *\n   * @param {CjsWebgpuPsoDescription} other The description to compare.\n   * @returns {boolean} True when both are complete and equal.\n   */\n  Equals(other)\n  {\n    if (!other) return false;\n\n    const key = this.GetKey();\n\n    return key !== null && key === other.GetKey();\n  }\n}\n\n\n// DECLARED AS A CALL, NOT A DECORATOR. The abstraction layer is imported\n// straight from source by its tests - `#trinityal/...` resolves to `src/` - and\n// raw Node cannot parse decorator syntax, so a decorator here breaks every test\n// that reaches this file without a build first. `CjsSchema.define` is the same\n// metadata through the door the schema already provides for exactly this, and\n// it keeps the layer free of the decorator chain it has never carried.\nCjsSchema.define(CjsWebgpuPsoDescription, { className: \"CjsWebgpuPsoDescription\", carbon: \"PSODescription\" });\n"],"names":["CjsWebgpuPsoDescription","shaderProgram","vertexBufferLayouts","topology","renderStateSetup","renderStateOverrides","colorFormats","depthFormat","sampleCount","GetMissing","IsValid","TOPOLOGIES","undefined","length","BuildRecipe","projected","GetWebgpuRecipe","invertedDepthTest","invertedCullMode","primitive","vertex","buffers","fragment","targets","map","format","blend","multisample","count","GetKey","identity","GetIdentity","RenderPipelineKey","Equals","other","key","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/webgpu/core/{renderTarget.js → CjsWebgpuRenderTarget.js}

@@ -398,4 +398,4 @@ class CjsWebgpuRenderTarget {
 }
 
 export { CjsWebgpuRenderTarget };
-//# sourceMappingURL=renderTarget.js.map
+//# sourceMappingURL=CjsWebgpuRenderTarget.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuRenderTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuRenderTarget.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuRenderTarget.js"],"sourcesContent":["// Attachment and target ownership for the WebGPU backend.\r\n//\r\n// Carbon's target model is a render context that owns its swap chain and\r\n// depth-stencil surface. WebGPU's is a render-pass descriptor with FIXED\r\n// attachments, decided before the pass opens and unchangeable inside it, so\r\n// there is nothing to port line for line - the divergence table already records\r\n// this as one of the places the two backends legitimately differ in\r\n// implementation while agreeing on the frame progression.\r\n//\r\n// What this owns: canvas configuration, the depth attachment, the multisample\r\n// attachment, and their size. What it deliberately does not own: when a frame\r\n// happens, which passes exist, or what is drawn. Those belong to the executor\r\n// and to Trinity's steps.\r\n//\r\n// THREE THINGS THAT MUST FAIL LOUDLY, because each is silent otherwise.\r\n//\r\n// 1. A canvas texture view is valid for ONE frame. WebGPU replaces the texture\r\n//    behind `getCurrentTexture()` at presentation, so a view cached across\r\n//    frames refers to a texture that is gone. Reusing one is rejected here\r\n//    rather than surfacing as a validation error from a pass whose descriptor\r\n//    looks correct.\r\n// 2. Depth and colour attachments must agree on size and sample count exactly.\r\n//    A stale depth attachment after a resize is the classic version of this,\r\n//    and beginRenderPass reports it far from the resize that caused it.\r\n// 3. Everything is bound to a device generation. After device loss the context\r\n//    must be reconfigured and every attachment recreated; an attachment from\r\n//    the previous device is not repairable.\r\n//\r\n// PRESENTATION IS NOT A CALL. Carbon presents the previous frame at the top of\r\n// the next tick through Tr2RenderContextAL::Present. WebGPU has no present:\r\n// the browser presents a configured canvas after the queue submission that drew\r\n// into its current texture. So the engine-side tick wrapper has a Present step\r\n// for WebGL and genuinely nothing to do here, and that asymmetry is expected\r\n// rather than a missing port.\r\n\r\nimport { CjsWebgpuDevice } from \"../CjsWebgpuDevice.js\";\r\n\r\nfunction fail(message)\r\n{\r\n  const error = new Error(`CjsWebgpuRenderTarget: ${message}`);\r\n  error.code = \"CJS_WEBGPU_RENDER_TARGET_INVALID\";\r\n  throw error;\r\n}\r\n\r\n\r\nfunction positiveSize(value, name)\r\n{\r\n  if (!Number.isInteger(value) || value < 1)\r\n  {\r\n    fail(`${name} must be a positive integer`);\r\n  }\r\n  return value;\r\n}\r\n\r\n\r\n/** Owns a WebGPU presentation surface and its per-frame attachments. */\r\nexport class CjsWebgpuRenderTarget\r\n{\r\n  _webgpu;\r\n\r\n  _canvas = null;\r\n\r\n  _context = null;\r\n\r\n  _format = null;\r\n\r\n  _alphaMode = \"opaque\";\r\n\r\n  _extraUsage = 0;\r\n\r\n  _sampleCount = 1;\r\n\r\n  _depthFormat = null;\r\n\r\n  _width = 0;\r\n\r\n  _height = 0;\r\n\r\n  _generation = 0;\r\n\r\n  _depth = null;\r\n\r\n  _multisample = null;\r\n\r\n  _frame = null;\r\n\r\n  _destroyed = false;\r\n\r\n  /**\r\n   * @param {CjsWebgpuDevice} webgpu Canonical WebGPU device.\r\n   * @param {object} options Target options.\r\n   * @param {object} options.canvas Canvas or OffscreenCanvas to present to.\r\n   * @param {object} [options.context] Pre-acquired WebGPU canvas context.\r\n   * @param {string} [options.format] Presentation format; defaults to the\r\n   *   browser's preferred canvas format.\r\n   * @param {string} [options.alphaMode=\"opaque\"] Canvas alpha mode.\r\n   * @param {number} [options.sampleCount=1] Multisample count.\r\n   * @param {string} [options.depthFormat] Depth attachment format, or omitted\r\n   *   for a colour-only target.\r\n   * @param {object} [options.textureUsage] GPUTextureUsage constants.\r\n   * @param {object} [options.gpu] `navigator.gpu`-like object, for the\r\n   *   preferred canvas format.\r\n   * @param {number} [options.extraUsage] Extra `GPUTextureUsage` bits for the\r\n   *   surface - `COPY_SRC` when the frame has to be read back and counted.\r\n   */\r\n  constructor(webgpu, options = {})\r\n  {\r\n    if (!(webgpu instanceof CjsWebgpuDevice))\r\n    {\r\n      fail(\"webgpu boundary must be a CjsWebgpuDevice\");\r\n    }\r\n    this._webgpu = webgpu;\r\n    this._canvas = options.canvas ?? null;\r\n    this._context = options.context ?? null;\r\n\r\n    if (!this._context && !this._canvas) fail(\"a canvas or a context is required\");\r\n\r\n    this._textureUsage = options.textureUsage || globalThis.GPUTextureUsage || null;\r\n    this._gpu = options.gpu ?? globalThis.navigator?.gpu ?? null;\r\n    this._alphaMode = options.alphaMode ?? \"opaque\";\r\n    this._sampleCount = options.sampleCount ?? 1;\r\n    this._depthFormat = options.depthFormat ?? null;\r\n    this._format = options.format ?? null;\r\n    this._extraUsage = options.extraUsage ?? 0;\r\n  }\r\n\r\n  /** The presentation format the canvas is configured with. */\r\n  GetFormat()\r\n  {\r\n    return this._format;\r\n  }\r\n\r\n  /**\r\n   * The depth attachment's format, or null when there is no depth.\r\n   *\r\n   * The field existed from the start and nothing could read it, so the value\r\n   * reached a pipeline only by being passed separately into the batch\r\n   * resolver's constructor. A pipeline description assembled from bound state\r\n   * has no constructor to receive it, and asking the target that owns it is\r\n   * both shorter and impossible to disagree with.\r\n   *\r\n   * @returns {string|null} A `GPUTextureFormat`, or null.\r\n   */\r\n  GetDepthFormat()\r\n  {\r\n    return this._depthFormat;\r\n  }\r\n\r\n  /** The current attachment size. */\r\n  GetSize()\r\n  {\r\n    return { width: this._width, height: this._height };\r\n  }\r\n\r\n  // CARBON'S TEXTURE ACCESSORS, so this can BE a bound render target rather\r\n  // than needing an adapter to become one. `Tr2TextureAL` answers `GetWidth`\r\n  // and `GetHeight`, and the abstraction layer resets the viewport from\r\n  // whatever is bound at slot zero by asking exactly those two questions\r\n  // (`Tr2RenderContextMetal.mm:762-766`). Without them a target has to be\r\n  // wrapped at every call site, and the first one that forgets gets a viewport\r\n  // left at the previous pass's size - the 2048 shadow-map defect.\r\n\r\n  /** The bound width, as `Tr2TextureAL::GetWidth` answers it. @returns {number} */\r\n  GetWidth()\r\n  {\r\n    return this._width;\r\n  }\r\n\r\n  /** The bound height, as `Tr2TextureAL::GetHeight` answers it. @returns {number} */\r\n  GetHeight()\r\n  {\r\n    return this._height;\r\n  }\r\n\r\n  /** The multisample count every attachment is created with. */\r\n  GetSampleCount()\r\n  {\r\n    return this._sampleCount;\r\n  }\r\n\r\n  /**\r\n   * Configures the canvas context and sizes every attachment.\r\n   *\r\n   * Idempotent for an unchanged size, format and device generation, so a caller\r\n   * may invoke it each frame without recreating anything. A generation change\r\n   * reconfigures unconditionally, because the previous device's configuration\r\n   * does not carry over.\r\n   */\r\n  Configure(options = {})\r\n  {\r\n    this._AssertLive();\r\n\r\n    const width = positiveSize(options.width ?? this._width, \"width\");\r\n    const height = positiveSize(options.height ?? this._height, \"height\");\r\n    const generation = this._webgpu.GetGeneration();\r\n    const device = this._webgpu.GetDevice();\r\n\r\n    if (!this._context)\r\n    {\r\n      this._context = this._canvas?.getContext?.(\"webgpu\") ?? null;\r\n      if (!this._context) fail(\"the canvas does not provide a webgpu context\");\r\n    }\r\n\r\n    if (!this._format)\r\n    {\r\n      this._format = options.format\r\n        ?? this._gpu?.getPreferredCanvasFormat?.()\r\n        ?? fail(\"a presentation format is required when the browser reports no preferred one\");\r\n    }\r\n\r\n    const changed = generation !== this._generation\r\n      || width !== this._width\r\n      || height !== this._height;\r\n\r\n    if (!changed) return this;\r\n\r\n    // The canvas backing store drives the surface size, so it is set before the\r\n    // context is configured rather than after.\r\n    if (this._canvas)\r\n    {\r\n      this._canvas.width = width;\r\n      this._canvas.height = height;\r\n    }\r\n\r\n    const usage = this._RequireUsage();\r\n\r\n    // EXTRA USAGE IS THE CALLER'S TO ASK FOR, because the surface is theirs to\r\n    // read. A frame that has to be counted back needs COPY_SRC, and hardcoding\r\n    // RENDER_ATTACHMENT alone silently makes that impossible - the readback\r\n    // fails at copy time, long after the configure that caused it. Defaults to\r\n    // nothing extra, so nobody pays for a capability they did not ask for.\r\n    this._context.configure({\r\n      device,\r\n      format: this._format,\r\n      alphaMode: this._alphaMode,\r\n      usage: usage.RENDER_ATTACHMENT | (this._extraUsage ?? 0)\r\n    });\r\n\r\n    this._width = width;\r\n    this._height = height;\r\n    this._generation = generation;\r\n    this._ReleaseAttachments();\r\n    this._CreateAttachments(device, usage);\r\n    this._frame = null;\r\n\r\n    return this;\r\n  }\r\n\r\n  /**\r\n   * Acquires this frame's colour texture view and the matching attachments.\r\n   *\r\n   * A new frame invalidates the previous one. The returned record is the only\r\n   * legal source of a view for the frame it belongs to.\r\n   */\r\n  AcquireFrame()\r\n  {\r\n    this._AssertLive();\r\n    if (!this._context || !this._width) fail(\"Configure must run before a frame is acquired\");\r\n    if (this._generation !== this._webgpu.GetGeneration())\r\n    {\r\n      fail(\"the device generation changed; Configure must run again before acquiring a frame\");\r\n    }\r\n\r\n    const texture = this._context.getCurrentTexture();\r\n    if (!texture) fail(\"the canvas context returned no current texture\");\r\n\r\n    if (this._frame) this._frame.valid = false;\r\n\r\n    const view = texture.createView();\r\n    this._frame = {\r\n      valid: true,\r\n      generation: this._generation,\r\n      // With multisampling the pass renders into the multisample attachment and\r\n      // resolves into the canvas; without it the canvas is the render target.\r\n      colorView: this._multisample ? this._multisample.view : view,\r\n      resolveView: this._multisample ? view : null,\r\n      depthView: this._depth ? this._depth.view : null\r\n    };\r\n\r\n    return { ...this._frame };\r\n  }\r\n\r\n  /**\r\n   * Builds a render-pass descriptor for an acquired frame.\r\n   *\r\n   * `clearColor` omitted means the colour attachment LOADS rather than clears,\r\n   * which is how a second pass over the same target composites. The divergence\r\n   * decision prefers attachment load operations to an explicit clear operation,\r\n   * so clearing is expressed here and never as a separate draw.\r\n   */\r\n  CreateRenderPassDescriptor(frame, options = {})\r\n  {\r\n    this._AssertLive();\r\n    this._AssertFrame(frame);\r\n\r\n    const clearColor = options.clearColor ?? null;\r\n    const colorAttachment = {\r\n      view: frame.colorView,\r\n      loadOp: clearColor ? \"clear\" : \"load\",\r\n      storeOp: \"store\"\r\n    };\r\n    if (clearColor) colorAttachment.clearValue = clearColor;\r\n    if (frame.resolveView) colorAttachment.resolveTarget = frame.resolveView;\r\n\r\n    const descriptor = {\r\n      label: options.label,\r\n      colorAttachments: [ colorAttachment ]\r\n    };\r\n\r\n    if (frame.depthView)\r\n    {\r\n      const clearDepth = options.clearDepth;\r\n      descriptor.depthStencilAttachment = {\r\n        view: frame.depthView,\r\n        depthLoadOp: clearDepth === undefined ? \"load\" : \"clear\",\r\n        depthStoreOp: options.discardDepth ? \"discard\" : \"store\",\r\n        ...(clearDepth === undefined ? {} : { depthClearValue: clearDepth })\r\n      };\r\n    }\r\n    else if (options.clearDepth !== undefined)\r\n    {\r\n      fail(\"clearDepth was given but this target has no depth attachment\");\r\n    }\r\n\r\n    return descriptor;\r\n  }\r\n\r\n  /**\r\n   * Applies viewport and scissor to an open pass.\r\n   *\r\n   * Both default to the whole target. WebGPU treats these as encoder state\r\n   * inside a pass rather than as context state, so they are applied per pass\r\n   * and never persist across one.\r\n   */\r\n  ApplyViewport(pass, options = {})\r\n  {\r\n    this._AssertLive();\r\n    if (typeof pass?.setViewport !== \"function\") fail(\"a GPURenderPassEncoder is required\");\r\n\r\n    const viewport = options.viewport ?? null;\r\n    const scissor = options.scissor ?? null;\r\n\r\n    if (viewport)\r\n    {\r\n      this._AssertInside(viewport, \"viewport\");\r\n      pass.setViewport(\r\n        viewport.x, viewport.y, viewport.width, viewport.height,\r\n        viewport.minDepth ?? 0, viewport.maxDepth ?? 1\r\n      );\r\n    }\r\n    else\r\n    {\r\n      pass.setViewport(0, 0, this._width, this._height, 0, 1);\r\n    }\r\n\r\n    if (typeof pass.setScissorRect !== \"function\") return this;\r\n\r\n    if (scissor)\r\n    {\r\n      this._AssertInside(scissor, \"scissor\");\r\n      pass.setScissorRect(scissor.x, scissor.y, scissor.width, scissor.height);\r\n    }\r\n    else\r\n    {\r\n      pass.setScissorRect(0, 0, this._width, this._height);\r\n    }\r\n\r\n    return this;\r\n  }\r\n\r\n  /** Releases every attachment this target created. The canvas is the caller's. */\r\n  Destroy()\r\n  {\r\n    if (this._destroyed) return this;\r\n    this._destroyed = true;\r\n    if (this._frame) this._frame.valid = false;\r\n    this._frame = null;\r\n    this._ReleaseAttachments();\r\n    // Unconfiguring returns the surface; the canvas element itself is not ours\r\n    // to remove, and a caller may configure a new target against it.\r\n    this._context?.unconfigure?.();\r\n    return this;\r\n  }\r\n\r\n  /** Creates owned multisample and depth attachments for the current size. */\r\n  _CreateAttachments(device, usage)\r\n  {\r\n    if (this._sampleCount > 1)\r\n    {\r\n      const texture = device.createTexture({\r\n        label: \"CjsWebgpuRenderTarget.multisample\",\r\n        size: { width: this._width, height: this._height, depthOrArrayLayers: 1 },\r\n        sampleCount: this._sampleCount,\r\n        format: this._format,\r\n        usage: usage.RENDER_ATTACHMENT\r\n      });\r\n      this._multisample = { texture, view: texture.createView() };\r\n    }\r\n\r\n    if (this._depthFormat)\r\n    {\r\n      // Same size and sample count as the colour attachment, which is what\r\n      // beginRenderPass validates and what a stale depth texture violates.\r\n      const texture = device.createTexture({\r\n        label: \"CjsWebgpuRenderTarget.depth\",\r\n        size: { width: this._width, height: this._height, depthOrArrayLayers: 1 },\r\n        sampleCount: this._sampleCount,\r\n        format: this._depthFormat,\r\n        usage: usage.RENDER_ATTACHMENT\r\n      });\r\n      this._depth = { texture, view: texture.createView() };\r\n    }\r\n  }\r\n\r\n  /** Destroys and forgets every owned attachment. */\r\n  _ReleaseAttachments()\r\n  {\r\n    this._depth?.texture?.destroy?.();\r\n    this._multisample?.texture?.destroy?.();\r\n    this._depth = null;\r\n    this._multisample = null;\r\n  }\r\n\r\n  /** Gets the validated texture-usage vocabulary supplied by the host. */\r\n  _RequireUsage()\r\n  {\r\n    const usage = this._textureUsage;\r\n    if (!usage || !Number.isInteger(usage.RENDER_ATTACHMENT))\r\n    {\r\n      fail(\"the GPUTextureUsage RENDER_ATTACHMENT constant is required\");\r\n    }\r\n    return usage;\r\n  }\r\n\r\n  /** Throws when this target has already been destroyed. */\r\n  _AssertLive()\r\n  {\r\n    if (this._destroyed) fail(\"the render target is destroyed\");\r\n  }\r\n\r\n  // Ordered so the message names the actual problem. A frame invalidated by a\r\n  // later acquire, a resize or a device loss is STALE, and saying \"no frame\" of\r\n  // one the caller is holding sends them looking in the wrong place.\r\n  /** Validates that a frame belongs to the target's current generation. */\r\n  _AssertFrame(frame)\r\n  {\r\n    if (!frame || typeof frame !== \"object\") fail(\"a frame acquired from this target is required\");\r\n    if (!this._frame || !this._frame.valid\r\n      || frame.generation !== this._generation\r\n      || frame.colorView !== this._frame.colorView)\r\n    {\r\n      fail(\"the frame is stale; a canvas texture view is valid for one frame only\");\r\n    }\r\n  }\r\n\r\n  /** Validates that one viewport or scissor rectangle lies inside the target. */\r\n  _AssertInside(rect, name)\r\n  {\r\n    const values = [ rect.x, rect.y, rect.width, rect.height ];\r\n    if (values.some((value) => !Number.isFinite(value) || value < 0))\r\n    {\r\n      fail(`${name} must have non-negative finite bounds`);\r\n    }\r\n    if (rect.x + rect.width > this._width || rect.y + rect.height > this._height)\r\n    {\r\n      fail(`${name} exceeds the ${this._width}x${this._height} target`);\r\n    }\r\n  }\r\n}\r\n"],"names":["fail","message","error","Error","code","positiveSize","value","name","Number","isInteger","CjsWebgpuRenderTarget","_webgpu","_canvas","_context","_format","_alphaMode","_extraUsage","_sampleCount","_depthFormat","_width","_height","_generation","_depth","_multisample","_frame","_destroyed","constructor","webgpu","options","CjsWebgpuDevice","canvas","context","_textureUsage","textureUsage","globalThis","GPUTextureUsage","_gpu","gpu","navigator","alphaMode","sampleCount","depthFormat","format","extraUsage","GetFormat","GetDepthFormat","GetSize","width","height","GetWidth","GetHeight","GetSampleCount","Configure","_AssertLive","generation","GetGeneration","device","GetDevice","getContext","getPreferredCanvasFormat","changed","usage","_RequireUsage","configure","RENDER_ATTACHMENT","_ReleaseAttachments","_CreateAttachments","AcquireFrame","texture","getCurrentTexture","valid","view","createView","colorView","resolveView","depthView","CreateRenderPassDescriptor","frame","_AssertFrame","clearColor","colorAttachment","loadOp","storeOp","clearValue","resolveTarget","descriptor","label","colorAttachments","clearDepth","depthStencilAttachment","depthLoadOp","undefined","depthStoreOp","discardDepth","depthClearValue","ApplyViewport","pass","setViewport","viewport","scissor","_AssertInside","x","y","minDepth","maxDepth","setScissorRect","Destroy","unconfigure","createTexture","size","depthOrArrayLayers","destroy","rect","values","some","isFinite"],"mappings":"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"}

package/dist/trinityal/webgpu/core/{samplerSource.js → CjsWebgpuSamplerSource.js}

@@ -84,4 +84,4 @@ class CjsWebgpuSamplerSource {
 }
 
 export { CjsWebgpuSamplerSource };
-//# sourceMappingURL=samplerSource.js.map
+//# sourceMappingURL=CjsWebgpuSamplerSource.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuSamplerSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuSamplerSource.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuSamplerSource.js"],"sourcesContent":["// An effect's declared sampler to a realized WebGPU sampler.\n//\n// The mirror of CjsWebgpuTextureSource, and much shorter, because a sampler\n// needs nothing loaded. Its state is authored INTO the effect container and\n// arrives on the binding record itself, so resolution is synchronous and has no\n// resource path, no network and no first-frame absence.\n//\n// The one thing worth knowing is what a sampler is NOT: it is not paired with a\n// texture here. Carbon shares samplers across textures and stores the t#/s#\n// pairing only in the DXBC operands - quadv5 binds nine textures against a\n// single s0 - so a source that tried to hand out one sampler per texture would\n// be inventing a relationship the container does not express. See\n// /docs/contracts/texture-sampler-pairing.md.\nimport { CarbonSamplerDescriptor } from \"./samplerDescriptor.js\";\n\n\nfunction fail(message)\n{\n  const error = new Error(`CjsWebgpuSamplerSource: ${message}`);\n  error.code = \"CJS_WEBGPU_SAMPLER_SOURCE_INVALID\";\n  throw error;\n}\n\n\n/** Resolves an effect's declared samplers against one device. */\nexport class CjsWebgpuSamplerSource\n{\n  _webgpu;\n\n  /** Descriptor cache key to the in-flight or settled sampler. */\n  _created = new Map();\n\n  /**\n   * @param {object} webgpu Canonical WebGPU device.\n   */\n  constructor(webgpu)\n  {\n    if (!webgpu) fail(\"a WebGPU device is required\");\n\n    this._webgpu = webgpu;\n  }\n\n  /**\n   * The sampler for one declared binding.\n   *\n   * Keyed on the translated descriptor rather than on the binding's name,\n   * because the name is scoped to one pass while the state is not: every pass\n   * authoring the same state wants the same sampler, and s0 in two effects is\n   * two different bindings that may well be one sampler.\n   *\n   * @param {string} name Binding name, for diagnostics.\n   * @param {object} material Trinity material, unused; kept for the hook shape.\n   * @param {object} binding Declared binding record carrying the authored state.\n   * @returns {Promise<object>} Realized sampler handle.\n   */\n  async Resolve(name, material, binding)\n  {\n    const authored = binding?.carbon?.sampler;\n\n    if (!authored)\n    {\n      fail(`sampler binding \"${name}\" carries no authored state, so there is nothing to translate`);\n    }\n\n    // Keyed BEFORE the label is attached. The label carries the binding name,\n    // so keying on it would give two names with identical state two samplers,\n    // which is the sharing this cache exists to do.\n    const descriptor = CarbonSamplerDescriptor(authored);\n    const key = JSON.stringify(descriptor);\n    const existing = this._created.get(key);\n\n    if (existing) return existing;\n\n    const created = this._webgpu.CreateSampler({ ...descriptor, label: `effect sampler ${name}` });\n\n    this._created.set(key, created);\n\n    return created;\n  }\n\n  /**\n   * A resolver hook bound to this source.\n   *\n   * @returns {Function} `(name, material, binding) => Promise<object>`\n   */\n  ResolveSampler()\n  {\n    return (name, material, binding) => this.Resolve(name, material, binding);\n  }\n\n  /** Forgets every sampler, so a device loss can rebuild them. */\n  Clear()\n  {\n    this._created.clear();\n  }\n}\n"],"names":["fail","message","error","Error","code","CjsWebgpuSamplerSource","_webgpu","_created","Map","constructor","webgpu","Resolve","name","material","binding","authored","carbon","sampler","descriptor","CarbonSamplerDescriptor","key","JSON","stringify","existing","get","created","CreateSampler","label","set","ResolveSampler","Clear","clear"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIA,SAASA,IAAIA,CAACC,OAAO,EACrB;EACE,MAAMC,KAAK,GAAG,IAAIC,KAAK,CAAC,CAAA,wBAAA,EAA2BF,OAAO,EAAE,CAAC;EAC7DC,KAAK,CAACE,IAAI,GAAG,mCAAmC;AAChD,EAAA,MAAMF,KAAK;AACb;;AAGA;AACO,MAAMG,sBAAsB,CACnC;EACEC,OAAO;;AAEP;AACAC,EAAAA,QAAQ,GAAG,IAAIC,GAAG,EAAE;;AAEpB;AACF;AACA;EACEC,WAAWA,CAACC,MAAM,EAClB;AACE,IAAA,IAAI,CAACA,MAAM,EAAEV,IAAI,CAAC,6BAA6B,CAAC;IAEhD,IAAI,CAACM,OAAO,GAAGI,MAAM;AACvB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACE,EAAA,MAAMC,OAAOA,CAACC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,EACrC;AACE,IAAA,MAAMC,QAAQ,GAAGD,OAAO,EAAEE,MAAM,EAAEC,OAAO;IAEzC,IAAI,CAACF,QAAQ,EACb;AACEf,MAAAA,IAAI,CAAC,CAAA,iBAAA,EAAoBY,IAAI,CAAA,6DAAA,CAA+D,CAAC;AAC/F,IAAA;;AAEA;AACA;AACA;AACA,IAAA,MAAMM,UAAU,GAAGC,uBAAuB,CAACJ,QAAQ,CAAC;AACpD,IAAA,MAAMK,GAAG,GAAGC,IAAI,CAACC,SAAS,CAACJ,UAAU,CAAC;IACtC,MAAMK,QAAQ,GAAG,IAAI,CAAChB,QAAQ,CAACiB,GAAG,CAACJ,GAAG,CAAC;IAEvC,IAAIG,QAAQ,EAAE,OAAOA,QAAQ;AAE7B,IAAA,MAAME,OAAO,GAAG,IAAI,CAACnB,OAAO,CAACoB,aAAa,CAAC;AAAE,MAAA,GAAGR,UAAU;MAAES,KAAK,EAAE,kBAAkBf,IAAI,CAAA;AAAG,KAAC,CAAC;IAE9F,IAAI,CAACL,QAAQ,CAACqB,GAAG,CAACR,GAAG,EAAEK,OAAO,CAAC;AAE/B,IAAA,OAAOA,OAAO;AAChB,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEI,EAAAA,cAAcA,GACd;AACE,IAAA,OAAO,CAACjB,IAAI,EAAEC,QAAQ,EAAEC,OAAO,KAAK,IAAI,CAACH,OAAO,CAACC,IAAI,EAAEC,QAAQ,EAAEC,OAAO,CAAC;AAC3E,EAAA;;AAEA;AACAgB,EAAAA,KAAKA,GACL;AACE,IAAA,IAAI,CAACvB,QAAQ,CAACwB,KAAK,EAAE;AACvB,EAAA;AACF;;;;"}

package/dist/trinityal/webgpu/core/{textureSource.js → CjsWebgpuTextureSource.js}

@@ -123,4 +123,4 @@ class CjsWebgpuTextureSource {
 }
 
 export { CjsWebgpuTextureSource };
-//# sourceMappingURL=textureSource.js.map
+//# sourceMappingURL=CjsWebgpuTextureSource.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuTextureSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuTextureSource.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuTextureSource.js"],"sourcesContent":["// An effect's named texture to a realized WebGPU texture.\n//\n// This is the last link of the chain and the one that was genuinely missing.\n// Both ends already worked: the format readers decode dds, png, jpeg, tga, gif\n// and webp, and CjsWebgpuDevice realizes a published payload. Nothing joined\n// them, because `TriTextureParameter.SetResource` is never called from src, so\n// an authored texture path never became a bound texture.\n//\n// Carbon binds an already-created texture: TriTextureParameter holds\n// `m_cachedTexture` and CopyToResourceSet hands it straight to the resource-set\n// description (TriTextureParameter.cpp:177-186). Realization happened when the\n// resource loaded, long before the draw.\n//\n// A BROWSER CANNOT DO THAT, and this is the one honest deviation. A texture\n// arrives over the network, so the first frame that wants it may be earlier\n// than the frame that has it. Resolution is therefore asynchronous and\n// idempotent: the same name resolves to the same texture for the life of the\n// resource, and a caller awaits once rather than polling.\n//\n// The sRGB flag travels with the binding, not with the texture: the same bytes\n// are read as colour by one effect and as data by another, which is why Carbon\n// carries it in the resource FLAGS rather than in the texture. See\n// /docs/contracts/texture-sampler-pairing.md for why the sampler pairing cannot\n// come from here.\nimport { ResourceRequirement } from \"#resource/ResourceRequirement\";\n\n\nfunction fail(message)\n{\n  const error = new Error(`CjsWebgpuTextureSource: ${message}`);\n  error.code = \"CJS_WEBGPU_TEXTURE_SOURCE_INVALID\";\n  throw error;\n}\n\n\n/** Resolves an effect's named textures against one device and resource manager. */\nexport class CjsWebgpuTextureSource\n{\n  _webgpu;\n\n  _resourceManager;\n\n  _adapterKey;\n\n  /** Resource path to the in-flight or settled realization. */\n  _realized = new Map();\n\n  /**\n   * @param {object} webgpu Canonical WebGPU device.\n   * @param {object} options Composition.\n   * @param {object} options.resourceManager Loads textures by path.\n   * @param {string} [options.adapterKey] Adapter slot the realization publishes into.\n   */\n  constructor(webgpu, options = {})\n  {\n    if (!webgpu) fail(\"a WebGPU device is required\");\n    if (!options.resourceManager) fail(\"a resource manager is required to load textures by path\");\n\n    this._webgpu = webgpu;\n    this._resourceManager = options.resourceManager;\n    this._adapterKey = options.adapterKey ?? \"webgpu\";\n  }\n\n  /**\n   * The realized texture for one of an effect's named resources.\n   *\n   * Named rather than pathed, because the shader binds by name and only the\n   * effect knows which file that name currently points at - a skin changes the\n   * path and not the name.\n   *\n   * @param {string} name Effect resource name, as the shader declares it.\n   * @param {object} material Trinity material owning the resource.\n   * @returns {Promise<object>} Realized texture bundle.\n   */\n  async Resolve(name, material)\n  {\n    const parameter = material?.GetResourceByName?.(name) ?? null;\n\n    if (!parameter)\n    {\n      fail(`effect declares no resource named \"${name}\", so nothing says which file to bind`);\n    }\n\n    const path = parameter.resourcePath ?? parameter.GetResourcePath?.() ?? \"\";\n\n    if (!path)\n    {\n      fail(`effect resource \"${name}\" names no path; an unset texture cannot be bound`);\n    }\n\n    const existing = this._realized.get(path);\n\n    // Shared rather than re-entered: two batches binding the same texture in one\n    // frame is the ordinary case, and realizing it twice would allocate twice.\n    if (existing) return existing;\n\n    const realization = this._Realize(path, name);\n\n    this._realized.set(path, realization);\n\n    return realization;\n  }\n\n  /**\n   * Loads and realizes one texture path.\n   *\n   * @param {string} path Resource path.\n   * @param {string} name Effect resource name, for diagnostics.\n   * @returns {Promise<object>} Realized bundle.\n   */\n  async _Realize(path, name)\n  {\n    const resource = this._resourceManager.GetResource(path, {\n      requirement: ResourceRequirement.TEXTURE\n    });\n\n    if (!resource) fail(`no resource for \"${name}\" at ${JSON.stringify(path)}`);\n\n    // The resource publishes its CPU payload before an adapter can be made from\n    // it; a texture still in flight is not an error, it is the normal first\n    // frame.\n    await resource.Ready?.();\n\n    return this._webgpu.RealizeRgba8Texture(resource, {\n      textureKey: name,\n      bundleLabel: `effect texture ${name}`,\n      adapterKey: this._adapterKey\n    });\n  }\n\n  /**\n   * A resolver hook bound to this source.\n   *\n   * @returns {Function} `(name, material) => Promise<object>`\n   */\n  ResolveTexture()\n  {\n    return (name, material) => this.Resolve(name, material);\n  }\n\n  /** Forgets every realization, so a device loss can rebuild them. */\n  Clear()\n  {\n    this._realized.clear();\n  }\n}\n"],"names":["fail","message","error","Error","code","CjsWebgpuTextureSource","_webgpu","_resourceManager","_adapterKey","_realized","Map","constructor","webgpu","options","resourceManager","adapterKey","Resolve","name","material","parameter","GetResourceByName","path","resourcePath","GetResourcePath","existing","get","realization","_Realize","set","resource","GetResource","requirement","ResourceRequirement","TEXTURE","JSON","stringify","Ready","RealizeRgba8Texture","textureKey","bundleLabel","ResolveTexture","Clear","clear"],"mappings":"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"}

package/dist/trinityal/webgpu/core/{trinityBatchDispatcher.js → CjsWebgpuTrinityBatchDispatcher.js}

@@ -1,10 +1,10 @@
 import { CjsWebgpuDevice } from '../CjsWebgpuDevice.js';
 import { CjsTrinityBatchDispatcher } from '#trinity/core/batch/CjsTrinityBatchDispatcher';
 import { CjsTrinityBatchResolver } from '#trinity/core/batch/CjsTrinityBatchResolver';
-import { ITriRenderBatchAccumulator } from '#trinity/core/batch/ITriRenderBatchAccumulator';
-import { Tr2RenderBatch } from '#trinity/core/batch/Tr2RenderBatch';
+import { ITriRenderBatchAccumulator } from '#trinity/core/batch/TriRenderBatch/ITriRenderBatchAccumulator';
+import { Tr2RenderBatch } from '#trinity/core/batch/TriRenderBatch/Tr2RenderBatch';
 import { TriRenderBatchMap } from '#trinity/core/batch/TriRenderBatchMap';
-import { DeriveBatchGroups, CjsWebgpuEncodeState } from './batchGroups.js';
+import { DeriveBatchGroups, CjsWebgpuEncodeState } from './CjsWebgpuEncodeState.js';
 import { TOPOLOGIES } from './topology.js';
 
 const MAX_GPU_SIZE_32 = 0xffffffff;
@@ -484,4 +484,4 @@ class CjsWebgpuTrinityBatchDispatcher extends CjsTrinityBatchDispatcher {
 }
 
 export { CjsWebgpuTrinityBatchDispatcher, TOPOLOGIES };
-//# sourceMappingURL=trinityBatchDispatcher.js.map
+//# sourceMappingURL=CjsWebgpuTrinityBatchDispatcher.js.map

package/dist/trinityal/webgpu/core/CjsWebgpuTrinityBatchDispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuTrinityBatchDispatcher.js","sources":["../../../../../src/trinityal/webgpu/core/CjsWebgpuTrinityBatchDispatcher.js"],"sourcesContent":["import { CjsWebgpuDevice } from \"../CjsWebgpuDevice.js\";\nimport { CjsTrinityBatchDispatcher } from \"#trinity/core/batch/CjsTrinityBatchDispatcher\";\nimport { CjsTrinityBatchResolver } from \"#trinity/core/batch/CjsTrinityBatchResolver\";\nimport { ITriRenderBatchAccumulator } from \"#trinity/core/batch/TriRenderBatch/ITriRenderBatchAccumulator\";\nimport { Tr2RenderBatch } from \"#trinity/core/batch/TriRenderBatch/Tr2RenderBatch\";\nimport { TriRenderBatchMap } from \"#trinity/core/batch/TriRenderBatchMap\";\nimport { CjsWebgpuEncodeState, DeriveBatchGroups } from \"./CjsWebgpuEncodeState.js\";\n// Re-exported so existing importers keep working while this file lives; the\n// table itself moved to topology.js, which is not going away.\nimport { TOPOLOGIES } from \"./topology.js\";\n\nexport { TOPOLOGIES };\n\nconst MAX_GPU_SIZE_32 = 0xffffffff;\n\n\nconst PREPARED_BATCHES = new WeakMap();\nconst PREPARED_ACCUMULATORS = new WeakMap();\nconst PREPARED_BATCH_MAPS = new WeakMap();\nconst EMPTY_CONTEXT = Object.freeze({});\n\nfunction fail(message)\n{\n  const error = new Error(`CjsWebgpuTrinityBatchDispatcher: ${message}`);\n  error.code = \"CJS_WEBGPU_TRINITY_BATCH_INVALID\";\n  throw error;\n}\n\nfunction gpuSize32(value, name, owner = \"batch\")\n{\n  if (!Number.isSafeInteger(value) || value < 0 || value > MAX_GPU_SIZE_32)\n  {\n    fail(`${owner} ${name} must be a GPUSize32 value`);\n  }\n  return value;\n}\n\nfunction signedOffset32(value, name)\n{\n  if (!Number.isSafeInteger(value) || value < -0x80000000 || value > 0x7fffffff)\n  {\n    fail(`resolved geometry draw ${name} must be a GPUSignedOffset32 value`);\n  }\n  return value;\n}\n\nfunction signedBaseVertex(value)\n{\n  const bits = gpuSize32(value, \"baseVertexLocation\");\n  return bits > 0x7fffffff ? bits - 0x100000000 : bits;\n}\n\nfunction preparationContext(value)\n{\n  if (value === undefined) return EMPTY_CONTEXT;\n  if (!value || typeof value !== \"object\" || Array.isArray(value))\n  {\n    fail(\"preparation context must be an object\");\n  }\n  const context = { ...value };\n  if (context.batchType !== undefined\n    && (!Number.isInteger(context.batchType) || context.batchType < 0))\n  {\n    fail(\"preparation context batchType must be a non-negative integer\");\n  }\n  return context;\n}\n\n/** Carbon's DEFAULT_TECHNIQUE (Tr2RenderContext.h:37). */\nconst DEFAULT_TECHNIQUE = \"Main\";\n\n/**\n * How many passes this batch's material draws, the way Carbon asks\n * (Tr2RenderContext.cpp:463-471): the material's shader state interface for the\n * technique index, then its pass count, returning zero for either miss so the\n * batch emits nothing.\n *\n * A material that cannot answer draws ONE pass. Carbon has no such material -\n * it always holds a Tr2Material - but a caller that resolves its own pipeline\n * without Trinity reflection means exactly one thing to draw, and refusing it\n * would reject the composition boundary's whole point.\n */\nfunction passCountOf(material, techniqueName)\n{\n  // EXPLICIT PROBES, not hedges, and the line below already asked this way.\n  // The boundary deliberately accepts a caller's own material - see the\n  // paragraph above - so \"does this object answer\" is the real question here.\n  const shader = typeof material.GetShaderStateInterface === \"function\"\n    ? material.GetShaderStateInterface()\n    : null;\n\n  if (!shader || typeof shader.GetTechniqueIndex !== \"function\") return 1;\n\n  const techniqueIndex = shader.GetTechniqueIndex(techniqueName);\n\n  if (!Number.isInteger(techniqueIndex) || techniqueIndex < 0) return 0;\n\n  return typeof shader.GetPassCount === \"function\" ? shader.GetPassCount(techniqueIndex) : 0;\n}\n\nfunction geometryDraw(value, indexed)\n{\n  if (!value || typeof value !== \"object\" || Array.isArray(value))\n  {\n    fail(\"ResolveGeometry draw must be an object\");\n  }\n  if (indexed)\n  {\n    return {\n      indexCount: gpuSize32(value.indexCount, \"indexCount\", \"resolved geometry draw\"),\n      instanceCount: gpuSize32(value.instanceCount, \"instanceCount\", \"resolved geometry draw\"),\n      firstIndex: gpuSize32(value.firstIndex, \"firstIndex\", \"resolved geometry draw\"),\n      baseVertex: signedOffset32(value.baseVertex, \"baseVertex\"),\n      firstInstance: gpuSize32(value.firstInstance, \"firstInstance\", \"resolved geometry draw\")\n    };\n  }\n  return {\n    vertexCount: gpuSize32(value.vertexCount, \"vertexCount\", \"resolved geometry draw\"),\n    instanceCount: gpuSize32(value.instanceCount, \"instanceCount\", \"resolved geometry draw\"),\n    firstVertex: gpuSize32(value.firstVertex, \"firstVertex\", \"resolved geometry draw\"),\n    firstInstance: gpuSize32(value.firstInstance, \"firstInstance\", \"resolved geometry draw\")\n  };\n}\n\nfunction batchDraw(batch, indexed)\n{\n  const count = gpuSize32(batch.indexCountPerInstance, \"indexCountPerInstance\");\n  const instanceCount = gpuSize32(batch.instanceCount, \"instanceCount\");\n  const first = gpuSize32(batch.startIndexLocation, \"startIndexLocation\");\n  const firstInstance = gpuSize32(batch.startInstanceLocation, \"startInstanceLocation\");\n  if (indexed)\n  {\n    return {\n      indexCount: count,\n      instanceCount,\n      firstIndex: first,\n      baseVertex: signedBaseVertex(batch.baseVertexLocation),\n      firstInstance\n    };\n  }\n  return {\n    vertexCount: count,\n    instanceCount,\n    firstVertex: first,\n    firstInstance\n  };\n}\n\nfunction pipelineRecipe(recipe, topology)\n{\n  if (!recipe || typeof recipe !== \"object\" || Array.isArray(recipe))\n  {\n    fail(\"ResolveMaterial must return a pipeline recipe\");\n  }\n  const primitive = recipe.primitive ?? {};\n  if (!primitive || typeof primitive !== \"object\" || Array.isArray(primitive))\n  {\n    fail(\"resolved pipeline primitive recipe must be an object\");\n  }\n  if (primitive.topology !== undefined && primitive.topology !== topology)\n  {\n    fail(`batch topology ${topology} conflicts with resolved pipeline topology ${primitive.topology}`);\n  }\n  return {\n    ...recipe,\n    primitive: {\n      ...primitive,\n      topology\n    }\n  };\n}\n\n/**\n * Engine-side adapter for canonical Trinity render batches.\n *\n * Trinity supplies transient CPU references and draw arguments. A nominal\n * composition resolver maps those references to WebGPU-owned material,\n * geometry, and binding objects.\n */\nexport class CjsWebgpuTrinityBatchDispatcher extends CjsTrinityBatchDispatcher\n{\n  _webgpu;\n\n  _resolver;\n\n  /**\n   * @param {CjsWebgpuDevice} webgpu Canonical WebGPU device.\n   * @param {CjsTrinityBatchResolver} resolver Backend composition resolver.\n   * @param {Function} resolver.ResolveMaterial Resolves batch material to\n   *   { pipeline, recipe, prepareOptions? }; receives immutable preparation\n   *   context as its third argument.\n   * @param {Function} resolver.ResolveGeometry Resolves geometrySource to\n   *   { geometry, indexed, draw? }; a draw override supplies arguments derived\n   *   from deferred geometry areas and realized buffer packing. Receives\n   *   preparation context as its third argument.\n   * @param {Function} resolver.ResolveBindings Resolves batch/object data to\n   *   { uniformData, resources }; receives preparation context as its third\n   *   argument.\n   */\n  constructor(webgpu, resolver)\n  {\n    super();\n    if (!(webgpu instanceof CjsWebgpuDevice))\n    {\n      fail(\"webgpu boundary requires a CjsWebgpuDevice\");\n    }\n    if (!(resolver instanceof CjsTrinityBatchResolver))\n    {\n      fail(\"composition resolver requires a CjsTrinityBatchResolver\");\n    }\n    this._webgpu = webgpu;\n    this._resolver = resolver;\n  }\n\n  /**\n   * Resolves and validates one transient Trinity batch into a generation-bound\n   * WebGPU draw. External geometry and resources remain owned by their\n   * resolvers; the returned handle owns only its binding set.\n   */\n  async Prepare(batch, context = undefined)\n  {\n    const preparedContext = preparationContext(context);\n    if (!(batch instanceof Tr2RenderBatch)) fail(\"batch must be a Tr2RenderBatch\");\n    if (batch.material === null || batch.material === undefined) fail(\"batch material is required\");\n    if (batch.geometrySource === null || batch.geometrySource === undefined)\n    {\n      fail(\"batch geometrySource is required\");\n    }\n    const topology = TOPOLOGIES[batch.topology];\n    if (!topology) fail(`batch topology ${batch.topology} is unsupported`);\n\n    // Carbon bails before touching the device when the technique is absent or\n    // draws nothing (Tr2RenderContext.cpp:465-471), and so does this.\n    const passCount = passCountOf(batch.material, preparedContext.techniqueName ?? DEFAULT_TECHNIQUE);\n\n    if (!passCount) return null;\n\n    const material = await this._resolver.ResolveMaterial(\n      batch.material,\n      batch,\n      { ...preparedContext, passIndex: 0 }\n    );\n    if (!material || typeof material !== \"object\" || material.pipeline == null)\n    {\n      fail(\"ResolveMaterial must return a pipeline and recipe\");\n    }\n    const geometry = await this._resolver.ResolveGeometry(\n      batch.geometrySource,\n      batch,\n      preparedContext\n    );\n    if (!geometry || typeof geometry !== \"object\" || geometry.geometry == null\n      || typeof geometry.indexed !== \"boolean\")\n    {\n      fail(\"ResolveGeometry must return geometry and an indexed boolean\");\n    }\n    const drawArguments = geometry.draw === undefined\n      ? batchDraw(batch, geometry.indexed)\n      : geometryDraw(geometry.draw, geometry.indexed);\n\n    // Carbon resolves the shader program and render states per PASS and the\n    // material data per pass as well (Tr2RenderContext.cpp:472-535), so a\n    // multi-pass technique yields one pipeline and one binding set per pass over\n    // the same geometry and the same draw arguments.\n    const passes = [];\n\n    try\n    {\n      for (let passIndex = 0; passIndex < passCount; passIndex += 1)\n      {\n        const passContext = { ...preparedContext, passIndex };\n\n        const perPass = passIndex === 0\n          ? material\n          : await this._resolver.ResolveMaterial(batch.material, batch, passContext);\n\n        if (!perPass || typeof perPass !== \"object\" || perPass.pipeline == null)\n        {\n          fail(`ResolveMaterial must return a pipeline and recipe for pass ${passIndex}`);\n        }\n\n        const prepared = await this._webgpu.PreparePipeline(\n          perPass.pipeline,\n          perPass.prepareOptions ?? { warningsAsErrors: true }\n        );\n        const livePipeline = await this._webgpu.CreateRenderPipeline(\n          prepared,\n          pipelineRecipe(perPass.recipe, topology)\n        );\n        const bindings = await this._resolver.ResolveBindings(batch, batch.objectData, passContext);\n\n        if (!bindings || typeof bindings !== \"object\")\n        {\n          fail(\"ResolveBindings must return uniformData and resources\");\n        }\n\n        // Recorded BEFORE the draw is made, so a rejected draw still leaves its\n        // binding set owned and destroyable by the rollback below.\n        const entry = {\n          passIndex,\n          prepared,\n          livePipeline,\n          bindingSet: this._webgpu.CreateBindingSet(livePipeline, {\n            uniformData: bindings.uniformData,\n            resources: bindings.resources\n          }),\n          draw: null\n        };\n\n        passes.push(entry);\n\n        entry.draw = this._webgpu.CreateDraw(livePipeline, {\n          bindingSet: entry.bindingSet,\n          geometry: geometry.geometry,\n          draw: drawArguments\n        });\n      }\n    }\n    catch (error)\n    {\n      for (const entry of passes) entry.bindingSet.Destroy();\n      throw error;\n    }\n\n    const handle = {\n      batch,\n      context: preparedContext,\n      passes,\n      // The first pass's members stay on the handle: grouping compares draws,\n      // and a single-pass batch - which is nearly all of them - reads exactly\n      // as it did before passes existed.\n      prepared: passes[0].prepared,\n      livePipeline: passes[0].livePipeline,\n      bindingSet: passes[0].bindingSet,\n      draw: passes[0].draw\n    };\n\n    PREPARED_BATCHES.set(handle, { owner: this, destroyed: false });\n\n    return handle;\n  }\n\n  /**\n   * Encodes one prepared batch into the supplied render pass.\n   *\n   * `encodeState` is optional and, when given, elides the sets a previous batch\n   * in the same run already performed. A caller encoding a single batch omits\n   * it and every set happens.\n   */\n  Encode(pass, handle, encodeState = null)\n  {\n    const state = PREPARED_BATCHES.get(handle);\n    if (!state || state.owner !== this) fail(\"prepared batch belongs to another dispatcher\");\n    if (state.destroyed) fail(\"prepared batch is destroyed\");\n    for (const entry of handle.passes) this._webgpu.EncodeDraw(pass, entry.draw, encodeState);\n  }\n\n  /** Encodes one pass of a prepared batch, for the grouped pass-major walk. */\n  _EncodePass(pass, handle, passIndex, encodeState)\n  {\n    const entry = handle.passes[passIndex];\n\n    if (entry) this._webgpu.EncodeDraw(pass, entry.draw, encodeState);\n  }\n\n  /**\n   * Encodes a batch vector run by run, hoisting each run's shared pipeline and\n   * buffer bindings to its first batch, as Carbon's RenderBatchGroup hoists\n   * them to the group.\n   *\n   * Order is preserved exactly. Runs are found among ADJACENT batches that\n   * already agree; nothing is reordered, because sorting is Trinity's and a\n   * reorder here would break golden-image comparison between backends.\n   */\n  _EncodeGrouped(pass, batches, encodeState)\n  {\n    for (const group of DeriveBatchGroups(batches, handle => handle?.draw))\n    {\n      // PASS-MAJOR, as Carbon's RenderBatchGroup is: every batch of the group\n      // draws pass 0, then every batch draws pass 1\n      // (Tr2RenderContext.cpp:472-535). Encoding batch-major instead would\n      // interleave a two-pass effect's passes between objects and change what\n      // lands on screen.\n      let passCount = 0;\n      for (let index = group.start; index < group.end; index += 1)\n      {\n        passCount = Math.max(passCount, batches[index]?.passes?.length ?? 0);\n      }\n\n      for (let passIndex = 0; passIndex < passCount; passIndex += 1)\n      {\n        for (let index = group.start; index < group.end; index += 1)\n        {\n          this._EncodePass(pass, batches[index], passIndex, encodeState);\n        }\n      }\n    }\n  }\n\n  /** Releases the prepared batch's owned binding set. */\n  Destroy(handle)\n  {\n    const state = PREPARED_BATCHES.get(handle);\n    if (!state || state.owner !== this) fail(\"prepared batch belongs to another dispatcher\");\n    if (state.destroyed) return;\n    state.destroyed = true;\n    for (const entry of handle.passes) entry.bindingSet.Destroy();\n  }\n\n  /**\n   * Snapshots and prepares both vectors of one finalized\n   * canonical Trinity batch accumulator. GDPR batches retain their\n   * separate identity. Both vectors are grouped at encode time; preparation\n   * stays per batch, because a binding set belongs to one batch.\n   */\n  async PrepareAccumulator(accumulator, context = undefined)\n  {\n    const preparedContext = preparationContext(context);\n    if (!(accumulator instanceof ITriRenderBatchAccumulator))\n    {\n      fail(\"accumulator must be an ITriRenderBatchAccumulator\");\n    }\n    const gdprBatches = accumulator.GetGdprBatches();\n    const batches = accumulator.GetBatches();\n    if (!Array.isArray(gdprBatches) || !Array.isArray(batches))\n    {\n      fail(\"accumulator batch getters must return arrays\");\n    }\n    if (accumulator.GetBatchCount() !== gdprBatches.length + batches.length)\n    {\n      fail(\"accumulator batch count does not match its batch vectors\");\n    }\n\n    const preparedGdprBatches = [];\n    const preparedBatches = [];\n    try\n    {\n      for (const batch of gdprBatches)\n      {\n        preparedGdprBatches.push(await this.Prepare(batch, preparedContext));\n      }\n      for (const batch of batches)\n      {\n        preparedBatches.push(await this.Prepare(batch, preparedContext));\n      }\n      const handle = {\n        accumulator,\n        context: preparedContext,\n        gdprBatches: preparedGdprBatches.slice(),\n        batches: preparedBatches.slice()\n      };\n      PREPARED_ACCUMULATORS.set(handle, {\n        owner: this,\n        destroyed: false\n      });\n      return handle;\n    }\n    catch (error)\n    {\n      for (let index = preparedBatches.length - 1; index >= 0; index -= 1)\n      {\n        this.Destroy(preparedBatches[index]);\n      }\n      for (let index = preparedGdprBatches.length - 1; index >= 0; index -= 1)\n      {\n        this.Destroy(preparedGdprBatches[index]);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Encodes GDPR then ordinary prepared batches in accumulator order, grouping\n   * each vector into hoisted runs.\n   *\n   * One encode state spans both vectors because they are encoded into one pass\n   * and pass state does not reset at a vector boundary; a redundant set there\n   * would be as wasteful as one inside a run.\n   */\n  EncodeAccumulator(pass, handle)\n  {\n    const state = PREPARED_ACCUMULATORS.get(handle);\n    if (!state || state.owner !== this) fail(\"prepared accumulator belongs to another dispatcher\");\n    if (state.destroyed) fail(\"prepared accumulator is destroyed\");\n    const encodeState = new CjsWebgpuEncodeState();\n    this._EncodeGrouped(pass, handle.gdprBatches, encodeState);\n    this._EncodeGrouped(pass, handle.batches, encodeState);\n  }\n\n  /** Releases every binding set owned by a prepared accumulator. */\n  DestroyAccumulator(handle)\n  {\n    const state = PREPARED_ACCUMULATORS.get(handle);\n    if (!state || state.owner !== this) fail(\"prepared accumulator belongs to another dispatcher\");\n    if (state.destroyed) return;\n    state.destroyed = true;\n    for (let index = handle.batches.length - 1; index >= 0; index -= 1)\n    {\n      this.Destroy(handle.batches[index]);\n    }\n    for (let index = handle.gdprBatches.length - 1; index >= 0; index -= 1)\n    {\n      this.Destroy(handle.gdprBatches[index]);\n    }\n  }\n\n  /**\n   * Snapshots and prepares every accumulator in one\n   * canonical TriRenderBatchMap without interpreting batch-type\n   * meaning or selecting render passes.\n   */\n  async PrepareBatchMap(batchMap)\n  {\n    if (!(batchMap instanceof TriRenderBatchMap))\n    {\n      fail(\"batch map must be a TriRenderBatchMap\");\n    }\n    const batchTypes = batchMap.GetBatchTypes();\n    if (!Array.isArray(batchTypes)) fail(\"batch map GetBatchTypes must return an array\");\n    const seen = new Set();\n    for (const batchType of batchTypes)\n    {\n      if (!Number.isInteger(batchType) || batchType < 0)\n      {\n        fail(\"batch map types must be non-negative integers\");\n      }\n      if (seen.has(batchType)) fail(`batch map duplicates batch type ${batchType}`);\n      seen.add(batchType);\n    }\n\n    const entries = [];\n    try\n    {\n      for (const batchType of batchTypes)\n      {\n        const accumulator = batchMap.GetAccumulator(batchType);\n        if (!accumulator) fail(`batch map has no accumulator for type ${batchType}`);\n        entries.push({\n          batchType,\n          accumulator: await this.PrepareAccumulator(accumulator, { batchType })\n        });\n      }\n      const preparedCount = entries.reduce(\n        (count, entry) => count\n          + entry.accumulator.gdprBatches.length\n          + entry.accumulator.batches.length,\n        0\n      );\n      if (batchMap.GetBatchCount() !== preparedCount)\n      {\n        fail(\"batch map count does not match its accumulators\");\n      }\n      const handle = {\n        batchMap,\n        entries: entries.slice()\n      };\n      PREPARED_BATCH_MAPS.set(handle, {\n        owner: this,\n        destroyed: false,\n        entries: new Map(entries.map((entry) => [ entry.batchType, entry ]))\n      });\n      return handle;\n    }\n    catch (error)\n    {\n      for (let index = entries.length - 1; index >= 0; index -= 1)\n      {\n        this.DestroyAccumulator(entries[index].accumulator);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Encodes one prepared batch type into a caller-selected compatible render\n   * pass.\n   */\n  EncodeBatchType(pass, handle, batchType)\n  {\n    const state = PREPARED_BATCH_MAPS.get(handle);\n    if (!state || state.owner !== this) fail(\"prepared batch map belongs to another dispatcher\");\n    if (state.destroyed) fail(\"prepared batch map is destroyed\");\n    const entry = state.entries.get(batchType);\n    if (!entry) fail(`prepared batch map has no batch type ${batchType}`);\n    this.EncodeAccumulator(pass, entry.accumulator);\n  }\n\n  /** Releases every accumulator and binding set owned by a prepared batch map. */\n  DestroyBatchMap(handle)\n  {\n    const state = PREPARED_BATCH_MAPS.get(handle);\n    if (!state || state.owner !== this) fail(\"prepared batch map belongs to another dispatcher\");\n    if (state.destroyed) return;\n    state.destroyed = true;\n    for (let index = handle.entries.length - 1; index >= 0; index -= 1)\n    {\n      this.DestroyAccumulator(handle.entries[index].accumulator);\n    }\n  }\n}\n"],"names":["MAX_GPU_SIZE_32","PREPARED_BATCHES","WeakMap","PREPARED_ACCUMULATORS","PREPARED_BATCH_MAPS","EMPTY_CONTEXT","Object","freeze","fail","message","error","Error","code","gpuSize32","value","name","owner","Number","isSafeInteger","signedOffset32","signedBaseVertex","bits","preparationContext","undefined","Array","isArray","context","batchType","isInteger","DEFAULT_TECHNIQUE","passCountOf","material","techniqueName","shader","GetShaderStateInterface","GetTechniqueIndex","techniqueIndex","GetPassCount","geometryDraw","indexed","indexCount","instanceCount","firstIndex","baseVertex","firstInstance","vertexCount","firstVertex","batchDraw","batch","count","indexCountPerInstance","first","startIndexLocation","startInstanceLocation","baseVertexLocation","pipelineRecipe","recipe","topology","primitive","CjsWebgpuTrinityBatchDispatcher","CjsTrinityBatchDispatcher","_webgpu","_resolver","constructor","webgpu","resolver","CjsWebgpuDevice","CjsTrinityBatchResolver","Prepare","preparedContext","Tr2RenderBatch","geometrySource","TOPOLOGIES","passCount","ResolveMaterial","passIndex","pipeline","geometry","ResolveGeometry","drawArguments","draw","passes","passContext","perPass","prepared","PreparePipeline","prepareOptions","warningsAsErrors","livePipeline","CreateRenderPipeline","bindings","ResolveBindings","objectData","entry","bindingSet","CreateBindingSet","uniformData","resources","push","CreateDraw","Destroy","handle","set","destroyed","Encode","pass","encodeState","state","get","EncodeDraw","_EncodePass","_EncodeGrouped","batches","group","DeriveBatchGroups","index","start","end","Math","max","length","PrepareAccumulator","accumulator","ITriRenderBatchAccumulator","gdprBatches","GetGdprBatches","GetBatches","GetBatchCount","preparedGdprBatches","preparedBatches","slice","EncodeAccumulator","CjsWebgpuEncodeState","DestroyAccumulator","PrepareBatchMap","batchMap","TriRenderBatchMap","batchTypes","GetBatchTypes","seen","Set","has","add","entries","GetAccumulator","preparedCount","reduce","Map","map","EncodeBatchType","DestroyBatchMap"],"mappings":"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"}