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

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

@@ -1 +1 @@
-{"version":3,"file":"CjsWebgpuShaderAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuShaderAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2ShaderAL.h\r\n//   trinity/trinityal/stub/Tr2ShaderALStub.cpp\r\n//   trinity/trinityal/include/Tr2ShaderProgramAL.h\r\n//\r\n// The device-backed half of Carbon's shader pair, and the second piece of the\r\n// immediate-draw route after `CjsWebgpuBufferAL`.\r\n//\r\n// WHY THESE EXIST. Carbon's draws all begin with `SetAllState`, which resolves a\r\n// pipeline from an incrementally described PSO (`Tr2RenderContextDx12.cpp:810`,\r\n// `:793-807`). The description's shader half is a `Tr2ShaderProgramAL` - a real\r\n// linked program, not a handle - so a backend that cannot produce one cannot\r\n// build a pipeline, and `SetStreamSource` + `DrawPrimitive` stay recording-only.\r\n// That is exactly where `Tr2Blitter` currently stops.\r\n//\r\n// BYTECODE HERE IS WGSL TEXT, NOT DXBC. Carbon hands its backends compiled\r\n// bytecode because its shaders are compiled offline for one API. Ours arrive as\r\n// translated WGSL from the effect container, so the \"bytecode\" a shader carries\r\n// is UTF-8 source. The AL contract does not care - it stores bytes and a\r\n// signature - and the divergence is here rather than in Trinity, which is where\r\n// Carbon puts every other API difference too.\r\n//\r\n// FIELDS ARE PUBLIC AND CARBON-NAMED, not private. Carbon's AL facade holds\r\n// exactly one private member - the `shared_ptr` to its impl - and the impl\r\n// class behind it carries public state, which is why Metal reads\r\n// `buffer.m_buffer->GetMetalBuffer()` and the stub swap chain declares\r\n// `m_backBuffer` public. We merge facade and impl into one class, so the merged\r\n// class carries the impl's fields.\r\n//\r\n// The whole layer is internal, so hiding inside it buys nothing - and it cost\r\n// something real: a program whose state was entirely private has no own\r\n// enumerable keys, canonicalised to an empty object, and would have collided\r\n// with every other program in the pipeline cache.\r\nimport { ALResult, Tr2ALMemoryType } from \"#trinityal\";\r\nimport { ShaderType } from \"#consts/render-context\";\r\nimport { readBackendBlock } from \"#resource/format\";\r\n\r\n\r\n/**\r\n * The entry point every stage in a Carbon WebGPU container has.\r\n *\r\n * The writer refuses any other name (`buildCarbonEffectContainer.js:45-50`), so\r\n * a module carries no entry-point record and this is the one value it can be.\r\n */\r\nexport const WEBGPU_ENTRY_POINT = \"main\";\r\n\r\n/**\r\n * WebGPU's `GPUShaderStage` bit for each stage name the backend block uses.\r\n *\r\n * Spelled out rather than read from `globalThis.GPUShaderStage` because a\r\n * headless test has no such global and the values are spec constants.\r\n */\r\nconst STAGE_VISIBILITY = Object.freeze({ vertex: 1, fragment: 2, compute: 4 });\r\n\r\n/** A monotonic program identity, for the pipeline cache. */\r\nlet nextProgramId = 1;\r\n\r\n\r\n/**\r\n * Carbon's ShaderType to the stage name WebGPU's pipeline descriptor wants.\r\n *\r\n * The stage is carried as Carbon's INTEGER ENUM everywhere, and becomes a\r\n * string only here, at the one boundary that genuinely demands one.\r\n *\r\n * It used to be a string throughout, which was an unforced divergence: an\r\n * integer enum is perfectly expressible in JavaScript, Carbon's\r\n * `Tr2RenderContextEnum::ShaderType` is ALREADY ported in `global/consts`\r\n * (`renderContext/pipeline.js`) from that same header, and `layers.json`\r\n * explicitly permits `trinityal` to import `global/consts`. Carrying strings\r\n * also silently broke the duplicate-stage check, which Carbon writes as\r\n * `1 << GetType()` - shifting by a string puts every stage on bit 0.\r\n */\r\nexport const WEBGPU_STAGE_NAME = Object.freeze({\r\n    [ShaderType.VERTEX_SHADER]: \"vertex\",\r\n    [ShaderType.PIXEL_SHADER]: \"fragment\",\r\n    [ShaderType.COMPUTE_SHADER]: \"compute\"\r\n});\r\n\r\n\r\n/** Decodes a shader's bytecode as WGSL source. */\r\nfunction wgslFrom(bytecode)\r\n{\r\n  if (typeof bytecode === \"string\") return bytecode;\r\n\r\n  const bytes = bytecode instanceof Uint8Array\r\n    ? bytecode\r\n    : new Uint8Array(bytecode.buffer, bytecode.byteOffset, bytecode.byteLength);\r\n\r\n  return new TextDecoder().decode(bytes);\r\n}\r\n\r\n\r\n/**\r\n * The bind-group declarations visible to one stage, decoded from the block on\r\n * its signature.\r\n *\r\n * @param {number} type A Carbon `ShaderType`.\r\n * @param {object|null} signature The stage's signature.\r\n * @returns {object[]|null} The stage's bindings; an empty list when the\r\n *   signature carries no block; null when the block is not this backend's.\r\n */\r\nfunction StageBindings(type, signature)\r\n{\r\n  const block = signature?.backendBlock;\r\n\r\n  if (!block || !block.size || !block.bytes) return [];\r\n\r\n  const stageName = WEBGPU_STAGE_NAME[type];\r\n  let decoded;\r\n\r\n  try\r\n  {\r\n    decoded = readBackendBlock(block.bytes, { source: \"Tr2ShaderSignatureAL.backendBlock\" });\r\n  }\r\n  catch\r\n  {\r\n    return null;\r\n  }\r\n\r\n  const bindings = [];\r\n\r\n  for (const group of decoded.bindGroups)\r\n  {\r\n    for (const binding of group.bindings)\r\n    {\r\n      if (!binding.visibility.includes(stageName)) continue;\r\n\r\n      bindings.push({\r\n        group: group.group,\r\n        binding: binding.binding,\r\n        identity: binding.identity,\r\n        scopeIdentity: binding.scopeIdentity,\r\n        resourceKind: binding.resourceKind,\r\n        registerIndex: binding.registerIndex,\r\n        registerSpace: binding.registerSpace,\r\n        // Exactly one of these is present, already in GPUBindGroupLayoutEntry\r\n        // form - the reader derives it from the WGSL type text.\r\n        buffer: binding.buffer,\r\n        texture: binding.texture,\r\n        sampler: binding.sampler\r\n      });\r\n    }\r\n  }\r\n\r\n  return bindings;\r\n}\r\n\r\n\r\n/**\r\n * The layout half of a binding, the part two stages must agree on.\r\n *\r\n * @param {object} binding A stage binding.\r\n * @returns {string} A comparable key.\r\n */\r\nfunction LayoutKey(binding)\r\n{\r\n  return JSON.stringify([\r\n    binding.resourceKind,\r\n    binding.registerSpace,\r\n    binding.registerIndex,\r\n    binding.buffer ?? null,\r\n    binding.texture ?? null,\r\n    binding.sampler ?? null\r\n  ]);\r\n}\r\n\r\n\r\n/**\r\n * A `Tr2ShaderAL` holding a real `GPUShaderModule`.\r\n *\r\n * Carbon's stub COPIES the bytecode so a shader stays readable after whatever\r\n * produced it moved on. This keeps the source for the same reason: a pipeline\r\n * built later needs the entry point and the module, and a compilation error\r\n * needs the text to report against.\r\n */\r\nexport class CjsWebgpuShaderAL\r\n{\r\n  /** m_type - a Carbon `ShaderType`; `INVALID_SHADER` until Create succeeds. */\r\n  m_type = ShaderType.INVALID_SHADER;\r\n\r\n  /** m_signature */\r\n  m_signature = null;\r\n\r\n  /** The WGSL this module was compiled from. */\r\n  m_source = \"\";\r\n\r\n  /** The compiled module, or null before Create. */\r\n  m_module = null;\r\n\r\n  m_webgpu = null;\r\n\r\n  /**\r\n   * This stage's bind-group declarations, from the pass's backend block.\r\n   *\r\n   * METAL'S `m_resourceMask`, IN THIS BACKEND'S VOCABULARY. Metal derives a\r\n   * per-stage binding table from `signature.registers` at Create\r\n   * (`Tr2ShaderALMetal.mm:37-217`) and the program merges the stages' tables\r\n   * (`Tr2ShaderProgramALMetal.mm:67`). A WGSL pipeline needs `(group, binding,\r\n   * layout)` rather than a register mask, and Carbon's registers cannot say\r\n   * that - so the container's per-pass block does, and it arrives here on the\r\n   * signature. Only the bindings visible to THIS stage are kept: a stage's\r\n   * table describes its own bindings, which is what lets two passes share an\r\n   * identical vertex stage.\r\n   */\r\n  m_bindings = [];\r\n\r\n  /** Carbon's `m_signature.pipelineInputs`, the vertex inputs this stage reads. */\r\n  m_inputs = [];\r\n\r\n  /**\r\n   * Compiles the shader.\r\n   *\r\n   * @param {number} type A Carbon `ShaderType` value.\r\n   * @param {ArrayBufferView|string} bytecode WGSL source.\r\n   * @param {object|null} signature The reflected signature.\r\n   * @param {string} shaderPath A debug label.\r\n   * @param {object} renderContext The WebGPU render context AL.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Create(type, bytecode, signature, shaderPath, renderContext)\r\n  {\r\n    this.Destroy();\r\n\r\n    // Carbon's stub reports OUT_OF_MEMORY for empty bytecode rather than\r\n    // INVALIDARG (`Tr2ShaderALStub.cpp`), and the odd choice is transcribed\r\n    // rather than tidied: a caller testing for it would not recognise a\r\n    // different code.\r\n    if (!bytecode || (bytecode.byteLength === 0 && bytecode.length === 0)) return ALResult.E_OUTOFMEMORY;\r\n\r\n    if (!renderContext || !renderContext.IsValid()) return ALResult.E_INVALIDCALL;\r\n\r\n    const webgpu = renderContext.GetWebgpu();\r\n    if (!webgpu) return ALResult.E_INVALIDCALL;\r\n\r\n    // REFUSED BEFORE COMPILING, AS METAL REFUSES A SIGNATURE IT CANNOT HONOUR\r\n    // (`Tr2ShaderALMetal.mm:24-27`). A block that is not this backend's - a\r\n    // WebGL2 container routed here - would otherwise compile a module whose\r\n    // bindings nothing can lay out, and fail later with a message about the\r\n    // pipeline.\r\n    const bindings = StageBindings(type, signature);\r\n    if (bindings === null) return ALResult.E_INVALIDARG;\r\n\r\n    this.m_source = wgslFrom(bytecode);\r\n    this.m_module = webgpu.GetDevice().createShaderModule({\r\n      label: shaderPath || \"Tr2ShaderAL\",\r\n      code: this.m_source\r\n    });\r\n    this.m_webgpu = webgpu;\r\n    this.m_type = type;\r\n    this.m_signature = signature;\r\n    this.m_bindings = bindings;\r\n    this.m_inputs = Array.isArray(signature?.pipelineInputs) ? signature.pipelineInputs.slice() : [];\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** This stage's bind-group declarations. @returns {object[]} */\r\n  GetBindings()\r\n  {\r\n    return this.m_bindings;\r\n  }\r\n\r\n  /** The vertex inputs this stage reads. @returns {object[]} */\r\n  GetInputs()\r\n  {\r\n    return this.m_inputs;\r\n  }\r\n\r\n  /**\r\n   * Whether the shader compiled AND carries a stage.\r\n   *\r\n   * Carbon is `m_type != INVALID_SHADER && !m_bytecode.empty()`\r\n   * (`Tr2ShaderALStub.cpp:48-51`) - both halves, on every backend. Testing the\r\n   * module alone accepted a shader with no stage, which a program would then\r\n   * link and resolve `GetModuleFor` against.\r\n   */\r\n  IsValid()\r\n  {\r\n    return this.m_module !== null && this.m_type !== ShaderType.INVALID_SHADER;\r\n  }\r\n\r\n  /** The stage this shader was created for. */\r\n  GetType()\r\n  {\r\n    return this.m_type;\r\n  }\r\n\r\n  /** The WGSL this was compiled from, as bytes, matching the stub's contract. */\r\n  GetBytecode()\r\n  {\r\n    return new TextEncoder().encode(this.m_source);\r\n  }\r\n\r\n  /** The reflected signature. */\r\n  GetSignature()\r\n  {\r\n    return this.m_signature;\r\n  }\r\n\r\n  /** The `GPUShaderModule`, for a pipeline to reference. */\r\n  GetModule()\r\n  {\r\n    return this.m_module;\r\n  }\r\n\r\n  /** Releases the module. */\r\n  Destroy()\r\n  {\r\n    // A GPUShaderModule has no destroy(); it is released when nothing\r\n    // references it. Dropping the reference is the whole of it.\r\n    this.m_module = null;\r\n    this.m_webgpu = null;\r\n    this.m_type = ShaderType.INVALID_SHADER;\r\n    this.m_signature = null;\r\n    this.m_source = \"\";\r\n    this.m_bindings = [];\r\n    this.m_inputs = [];\r\n  }\r\n\r\n  /**\r\n   * Claims a stage without bytecode, for a deliberately empty shader.\r\n   *\r\n   * The shader stays INVALID, which is the point: the pipeline must name the\r\n   * stage, and nothing must try to reference a module for it.\r\n   *\r\n   * @param {number} type The pipeline stage.\r\n   */\r\n  SetNullShaderType(type)\r\n  {\r\n    this.m_type = type;\r\n  }\r\n\r\n  /**\r\n   * Which memory class this shader occupies.\r\n   *\r\n   * @returns {number} A `Tr2ALMemoryType` value.\r\n   */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\r\n  }\r\n\r\n  /**\r\n   * Fills in a device-resource description.\r\n   *\r\n   * @param {object} description The description to fill.\r\n   * @returns {object} The description, filled.\r\n   */\r\n  Describe(description)\r\n  {\r\n    if (!description) return description;\r\n\r\n    description.memoryClass = this.GetMemoryClass();\r\n\r\n    return description;\r\n  }\r\n\r\n  /**\r\n   * Names the shader for a debugger.\r\n   *\r\n   * `GPUShaderModule` carries a writable `label`, and it is what a WebGPU\r\n   * compilation error quotes - so unlike the stub this keeps the name.\r\n   *\r\n   * @param {string} name The name to attach.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  SetName(name)\r\n  {\r\n    if (this.m_module) this.m_module.label = String(name);\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n}\r\n\r\n\r\n/**\r\n * A `Tr2ShaderProgramAL` linking compiled stages.\r\n *\r\n * Carbon's program is what a PSO description names, and its stub records which\r\n * stages were supplied as a mask. WebGPU has no link step - a render pipeline\r\n * takes the vertex and fragment modules directly - so this holds the stages and\r\n * answers for them, which is the part the pipeline description needs.\r\n *\r\n * THE PIPELINE LAYOUT IS BUILT HERE, AT CREATE, FROM THE STAGES. That is\r\n * DX12's shape exactly: `Tr2ShaderProgramAL::Create` walks each stage's\r\n * signature and merges its registers into one root signature\r\n * (`dx12/Tr2ShaderProgramALDx12.cpp:220-252`), and Metal's merges each stage's\r\n * resource mask the same way (`Tr2ShaderProgramALMetal.mm:67`). WebGPU's root\r\n * signature is a `GPUPipelineLayout`, and its per-stage input is the binding\r\n * list each `CjsWebgpuShaderAL` decoded from the block on its signature.\r\n *\r\n * This is what lets a draw resolve a pipeline from BOUND STATE: a bound program\r\n * carries its own layout, so nothing downstream needs the effect package the\r\n * program was read from. Before this the program held modules and nothing else,\r\n * and the layout lived only in a package the abstraction layer had no route to.\r\n *\r\n * `GetRegisterMap` is still not here; it belongs to the resource-set lane, and\r\n * the parity baseline records it.\r\n */\r\nexport class CjsWebgpuShaderProgramAL\r\n{\r\n  /** m_shaders, in the order given. */\r\n  m_shaders = [];\r\n\r\n  /**\r\n   * A process-unique identity, which is what the pipeline cache keys on.\r\n   *\r\n   * Metal hashes the function POINTERS into its pipeline key\r\n   * (`MetalWorkQueue.mm:1610-1611`); an id is the same thing in a language\r\n   * without addresses. Zero until Create.\r\n   */\r\n  m_id = 0;\r\n\r\n  /** The merged bindings, one entry per `(group, binding)` slot. */\r\n  m_bindings = [];\r\n\r\n  /** `GPUBindGroupLayout` per group, contiguous from group zero. */\r\n  m_bindGroupLayouts = [];\r\n\r\n  /** The `GPUPipelineLayout`, this backend's root signature; null until Create. */\r\n  m_pipelineLayout = null;\r\n\r\n  /** Metal's `m_iaInputs`: the vertex stage's pipeline inputs. */\r\n  m_inputs = [];\r\n\r\n  /**\r\n   * Links the shaders into a program.\r\n   *\r\n   * @param {object[]} shaders The `CjsWebgpuShaderAL`s to link.\r\n   * @param {object} renderContext The context to link against.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  Create(shaders, renderContext)\r\n  {\r\n    this.Destroy();\r\n\r\n    if (!renderContext || !renderContext.IsValid()) return ALResult.E_INVALIDCALL;\r\n    if (!shaders || shaders.length === 0) return ALResult.E_INVALIDARG;\r\n\r\n    // A program with an uncompiled stage would fail at pipeline creation with a\r\n    // message about the pipeline, not the shader. Refuse where the cause is.\r\n    //\r\n    // Two shaders of the SAME stage are refused for the same reason, and every\r\n    // Carbon backend does it: the stub and Metal by bitmask\r\n    // (`Tr2ShaderProgramALStub.cpp:35-48`, `Tr2ShaderProgramALMetal.mm:40-53`),\r\n    // DX11 per slot. Without it a duplicate linked silently and `GetModuleFor`\r\n    // returned whichever `find` reached first - unpredictable, and invisible\r\n    // until a pipeline drew with the wrong stage.\r\n    let stages = 0;\r\n    for (const shader of shaders)\r\n    {\r\n      if (!shader || !shader.IsValid()) return ALResult.E_INVALIDARG;\r\n\r\n      const bit = 1 << shader.GetType();\r\n      if ((stages & bit) !== 0) return ALResult.E_INVALIDARG;\r\n      stages |= bit;\r\n    }\r\n\r\n    // MERGE BY SLOT, AS DX12 MERGES BY REGISTER. A binding two stages both\r\n    // read appears in both stage lists; it becomes ONE layout entry visible to\r\n    // both. Two stages claiming one slot with different layouts is a container\r\n    // defect, refused here where the cause is rather than at pipeline creation.\r\n    const merged = new Map();\r\n\r\n    for (const shader of shaders)\r\n    {\r\n      const visibility = STAGE_VISIBILITY[WEBGPU_STAGE_NAME[shader.GetType()]] ?? 0;\r\n\r\n      for (const binding of shader.GetBindings())\r\n      {\r\n        const slot = `${binding.group}:${binding.binding}`;\r\n        const existing = merged.get(slot);\r\n\r\n        if (existing)\r\n        {\r\n          if (existing.layoutKey !== LayoutKey(binding)) return ALResult.E_INVALIDARG;\r\n          existing.visibility |= visibility;\r\n          continue;\r\n        }\r\n\r\n        merged.set(slot, { ...binding, visibility, layoutKey: LayoutKey(binding) });\r\n      }\r\n    }\r\n\r\n    const bindings = Array.from(merged.values())\r\n      .sort((left, right) => left.group - right.group || left.binding - right.binding);\r\n    const groupCount = bindings.length ? bindings[bindings.length - 1].group + 1 : 0;\r\n\r\n    // THE DEVICE OBJECTS ARE MADE HERE, as DX12 serialises and creates its root\r\n    // signature inside Create (`:262-289`). An absent group index gets an\r\n    // empty layout: WebGPU pipeline layouts are positional.\r\n    const webgpu = renderContext.GetWebgpu();\r\n    if (!webgpu) return ALResult.E_INVALIDCALL;\r\n\r\n    const device = webgpu.GetDevice();\r\n\r\n    const bindGroupLayouts = [];\r\n\r\n    for (let group = 0; group < groupCount; group += 1)\r\n    {\r\n      bindGroupLayouts.push(device.createBindGroupLayout({\r\n        label: `Tr2ShaderProgramAL.group${group}`,\r\n        entries: bindings\r\n          .filter(binding => binding.group === group)\r\n          .map(binding => ({\r\n            binding: binding.binding,\r\n            visibility: binding.visibility,\r\n            // A UNIFORM SLOT IS DYNAMIC, by the backend's decision and not the\r\n            // container's. Constant buffers are bound out of a per-frame arena\r\n            // at (page, offset), as Metal's are (`MetalWorkQueue.mm:2656-2659`,\r\n            // `setVertexBufferOffset:`), and WebGPU spells a per-draw offset as\r\n            // a dynamic offset on the layout. The container's `hasDynamicOffset`\r\n            // is not consulted: it describes nothing the AL does not decide.\r\n            ...(binding.buffer\r\n              ? { buffer: binding.buffer.type === \"uniform\" ? { ...binding.buffer, hasDynamicOffset: true } : binding.buffer }\r\n              : {}),\r\n            ...(binding.texture ? { texture: binding.texture } : {}),\r\n            ...(binding.sampler ? { sampler: binding.sampler } : {})\r\n          }))\r\n      }));\r\n    }\r\n\r\n    this.m_pipelineLayout = device.createPipelineLayout({\r\n      label: \"Tr2ShaderProgramAL.layout\",\r\n      bindGroupLayouts\r\n    });\r\n    this.m_bindGroupLayouts = bindGroupLayouts;\r\n    this.m_bindings = bindings;\r\n    this.m_shaders = shaders.slice();\r\n    this.m_inputs = shaders\r\n      .find(shader => shader.GetType() === ShaderType.VERTEX_SHADER)\r\n      ?.GetInputs() ?? [];\r\n    this.m_id = nextProgramId;\r\n    nextProgramId += 1;\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n\r\n  /** Whether the program linked. */\r\n  IsValid()\r\n  {\r\n    return this.m_shaders.length > 0;\r\n  }\r\n\r\n  /**\r\n   * The identity a pipeline cache keys this program under.\r\n   *\r\n   * @returns {string|null} A stable string, or null before Create.\r\n   */\r\n  GetIdentity()\r\n  {\r\n    return this.m_id ? `program:${this.m_id}` : null;\r\n  }\r\n\r\n  /** The merged bind-group declarations, sorted by group then binding. */\r\n  GetBindings()\r\n  {\r\n    return this.m_bindings;\r\n  }\r\n\r\n  /** Metal's `GetInputs`: the vertex stage's pipeline inputs. */\r\n  GetInputs()\r\n  {\r\n    return this.m_inputs;\r\n  }\r\n\r\n  /** One `GPUBindGroupLayout` per group, contiguous from zero. */\r\n  GetBindGroupLayouts()\r\n  {\r\n    return this.m_bindGroupLayouts;\r\n  }\r\n\r\n  /** The `GPUPipelineLayout` a pipeline built from this program takes. */\r\n  GetPipelineLayout()\r\n  {\r\n    return this.m_pipelineLayout;\r\n  }\r\n\r\n  /** The linked shaders, in the order they were given. */\r\n  GetShaders()\r\n  {\r\n    return this.m_shaders;\r\n  }\r\n\r\n  /**\r\n   * The module for one stage, or null when the program has no such stage.\r\n   *\r\n   * @param {*} type The stage to find.\r\n   * @returns {GPUShaderModule|null} Its module.\r\n   */\r\n  GetModuleFor(type)\r\n  {\r\n    const shader = this.m_shaders.find(candidate => candidate.GetType() === type);\r\n\r\n    return shader ? shader.GetModule() : null;\r\n  }\r\n\r\n  /** Releases the linked shaders and the layout built from them. */\r\n  Destroy()\r\n  {\r\n    // Layout objects have no destroy(); dropping the references releases them.\r\n    this.m_shaders = [];\r\n    this.m_bindings = [];\r\n    this.m_bindGroupLayouts = [];\r\n    this.m_pipelineLayout = null;\r\n    this.m_inputs = [];\r\n    this.m_id = 0;\r\n  }\r\n\r\n  /**\r\n   * Builds D3D12 indirect-command signatures.\r\n   *\r\n   * REFUSES, WHICH IS CARBON'S OWN NON-DX12 ANSWER rather than an omission.\r\n   * The shared facade defines it for every other backend as `return E_FAIL`\r\n   * (`src/Tr2ShaderProgramAL.cpp:34-42`), so the method is on the contract\r\n   * everywhere and only its implementation is DX12's.\r\n   *\r\n   * It was recorded as an accepted divergence on the grounds that it is\r\n   * \"DX12-only\". That was a misreading: leaving it out produces a TypeError at\r\n   * the call site, which is the defect class this backend's surface work was\r\n   * written to remove.\r\n   *\r\n   * @param {object} _bufferLayout A `Tr2IndirectBufferLayoutAL`.\r\n   * @param {object} _renderContext The primary render context.\r\n   * @returns {boolean} False.\r\n   */\r\n  CreateCommandSignatures(_bufferLayout, _renderContext)\r\n  {\r\n    return false;\r\n  }\r\n\r\n  /**\r\n   * Which memory class this program occupies.\r\n   *\r\n   * @returns {number} A `Tr2ALMemoryType` value.\r\n   */\r\n  GetMemoryClass()\r\n  {\r\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\r\n  }\r\n\r\n  /**\r\n   * Fills in a device-resource description.\r\n   *\r\n   * @param {object} description The description to fill.\r\n   * @returns {object} The description, filled.\r\n   */\r\n  Describe(description)\r\n  {\r\n    if (!description) return description;\r\n\r\n    description.memoryClass = this.GetMemoryClass();\r\n\r\n    return description;\r\n  }\r\n\r\n  /**\r\n   * Names the program for a debugger, and every stage under it.\r\n   *\r\n   * WebGPU has no program object to label - there is no link step - so the name\r\n   * reaches the modules, which is where it can actually appear in an error.\r\n   *\r\n   * @param {string} name The name to attach.\r\n   * @returns {number} An `ALResult` value.\r\n   */\r\n  SetName(name)\r\n  {\r\n    for (const shader of this.m_shaders) shader.SetName(name);\r\n\r\n    return ALResult.S_OK;\r\n  }\r\n}\r\n"],"names":["WEBGPU_ENTRY_POINT","STAGE_VISIBILITY","Object","freeze","vertex","fragment","compute","nextProgramId","WEBGPU_STAGE_NAME","ShaderType","VERTEX_SHADER","PIXEL_SHADER","COMPUTE_SHADER","wgslFrom","bytecode","bytes","Uint8Array","buffer","byteOffset","byteLength","TextDecoder","decode","StageBindings","type","signature","block","backendBlock","size","stageName","decoded","readBackendBlock","source","bindings","group","bindGroups","binding","visibility","includes","push","identity","scopeIdentity","resourceKind","registerIndex","registerSpace","texture","sampler","LayoutKey","JSON","stringify","CjsWebgpuShaderAL","m_type","INVALID_SHADER","m_signature","m_source","m_module","m_webgpu","m_bindings","m_inputs","Create","shaderPath","renderContext","Destroy","length","ALResult","E_OUTOFMEMORY","IsValid","E_INVALIDCALL","webgpu","GetWebgpu","E_INVALIDARG","GetDevice","createShaderModule","label","code","Array","isArray","pipelineInputs","slice","S_OK","GetBindings","GetInputs","GetType","GetBytecode","TextEncoder","encode","GetSignature","GetModule","SetNullShaderType","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","Describe","description","memoryClass","SetName","name","String","CjsWebgpuShaderProgramAL","m_shaders","m_id","m_bindGroupLayouts","m_pipelineLayout","shaders","stages","shader","bit","merged","Map","slot","existing","get","layoutKey","set","from","values","sort","left","right","groupCount","device","bindGroupLayouts","createBindGroupLayout","entries","filter","map","hasDynamicOffset","createPipelineLayout","find","GetIdentity","GetBindGroupLayouts","GetPipelineLayout","GetShaders","GetModuleFor","candidate","CreateCommandSignatures","_bufferLayout","_renderContext"],"mappings":"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"}
+{"version":3,"file":"CjsWebgpuShaderAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuShaderAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2ShaderAL.h\n//   trinity/trinityal/stub/Tr2ShaderALStub.cpp\n//\n// The device-backed half of Carbon's shader pair, and the second piece of the\n// immediate-draw route after `CjsWebgpuBufferAL`.\n//\n// WHY THESE EXIST. Carbon's draws all begin with `SetAllState`, which resolves a\n// pipeline from an incrementally described PSO (`Tr2RenderContextDx12.cpp:810`,\n// `:793-807`). The description's shader half is a `Tr2ShaderProgramAL` - a real\n// linked program, not a handle - so a backend that cannot produce one cannot\n// build a pipeline, and `SetStreamSource` + `DrawPrimitive` stay recording-only.\n// That is exactly where `Tr2Blitter` currently stops.\n//\n// BYTECODE HERE IS WGSL TEXT, NOT DXBC. Carbon hands its backends compiled\n// bytecode because its shaders are compiled offline for one API. Ours arrive as\n// translated WGSL from the effect container, so the \"bytecode\" a shader carries\n// is UTF-8 source. The AL contract does not care - it stores bytes and a\n// signature - and the divergence is here rather than in Trinity, which is where\n// Carbon puts every other API difference too.\n//\n// FIELDS ARE PUBLIC AND CARBON-NAMED, not private. Carbon's AL facade holds\n// exactly one private member - the `shared_ptr` to its impl - and the impl\n// class behind it carries public state, which is why Metal reads\n// `buffer.m_buffer->GetMetalBuffer()` and the stub swap chain declares\n// `m_backBuffer` public. We merge facade and impl into one class, so the merged\n// class carries the impl's fields.\n//\n// The whole layer is internal, so hiding inside it buys nothing - and it cost\n// something real: a program whose state was entirely private has no own\n// enumerable keys, canonicalised to an empty object, and would have collided\n// with every other program in the pipeline cache.\nimport { CjsSchema } from \"#schema\";\nimport { ALResult, Tr2ALMemoryType } from \"#trinityal\";\nimport { ShaderType } from \"#consts/render-context\";\nimport { readBackendBlock } from \"#resource/format\";\n\n/**\n * The entry point every stage in a Carbon WebGPU container has.\n *\n * The writer refuses any other name (`buildCarbonEffectContainer.js:45-50`), so\n * a module carries no entry-point record and this is the one value it can be.\n */\nexport const WEBGPU_ENTRY_POINT = \"main\";\n\n/**\n * Carbon's ShaderType to the stage name WebGPU's pipeline descriptor wants.\n *\n * The stage is carried as Carbon's INTEGER ENUM everywhere, and becomes a\n * string only here, at the one boundary that genuinely demands one.\n *\n * It used to be a string throughout, which was an unforced divergence: an\n * integer enum is perfectly expressible in JavaScript, Carbon's\n * `Tr2RenderContextEnum::ShaderType` is ALREADY ported in `global/consts`\n * (`renderContext/pipeline.js`) from that same header, and `layers.json`\n * explicitly permits `trinityal` to import `global/consts`. Carrying strings\n * also silently broke the duplicate-stage check, which Carbon writes as\n * `1 << GetType()` - shifting by a string puts every stage on bit 0.\n */\nexport const WEBGPU_STAGE_NAME = Object.freeze({\n    [ShaderType.VERTEX_SHADER]: \"vertex\",\n    [ShaderType.PIXEL_SHADER]: \"fragment\",\n    [ShaderType.COMPUTE_SHADER]: \"compute\"\n});\n\n\n/** Decodes a shader's bytecode as WGSL source. */\nfunction wgslFrom(bytecode)\n{\n  if (typeof bytecode === \"string\") return bytecode;\n\n  const bytes = bytecode instanceof Uint8Array\n    ? bytecode\n    : new Uint8Array(bytecode.buffer, bytecode.byteOffset, bytecode.byteLength);\n\n  return new TextDecoder().decode(bytes);\n}\n\n/**\n * The bind-group declarations visible to one stage, decoded from the block on\n * its signature.\n *\n * @param {number} type A Carbon `ShaderType`.\n * @param {object|null} signature The stage's signature.\n * @returns {object[]|null} The stage's bindings; an empty list when the\n *   signature carries no block; null when the block is not this backend's.\n */\nfunction StageBindings(type, signature)\n{\n  const block = signature?.backendBlock;\n\n  if (!block || !block.size || !block.bytes) return [];\n\n  const stageName = WEBGPU_STAGE_NAME[type];\n  let decoded;\n\n  try\n  {\n    decoded = readBackendBlock(block.bytes, { source: \"Tr2ShaderSignatureAL.backendBlock\" });\n  }\n  catch\n  {\n    return null;\n  }\n\n  const bindings = [];\n\n  for (const group of decoded.bindGroups)\n  {\n    for (const binding of group.bindings)\n    {\n      if (!binding.visibility.includes(stageName)) continue;\n\n      bindings.push({\n        group: group.group,\n        binding: binding.binding,\n        identity: binding.identity,\n        scopeIdentity: binding.scopeIdentity,\n        resourceKind: binding.resourceKind,\n        registerIndex: binding.registerIndex,\n        registerSpace: binding.registerSpace,\n        // Exactly one of these is present, already in GPUBindGroupLayoutEntry\n        // form - the reader derives it from the WGSL type text.\n        buffer: binding.buffer,\n        texture: binding.texture,\n        sampler: binding.sampler\n      });\n    }\n  }\n\n  return bindings;\n}\n\n/**\n * A `Tr2ShaderAL` holding a real `GPUShaderModule`.\n *\n * Carbon's stub COPIES the bytecode so a shader stays readable after whatever\n * produced it moved on. This keeps the source for the same reason: a pipeline\n * built later needs the entry point and the module, and a compilation error\n * needs the text to report against.\n */\nexport class CjsWebgpuShaderAL\n{\n  /** m_type - a Carbon `ShaderType`; `INVALID_SHADER` until Create succeeds. */\n  m_type = ShaderType.INVALID_SHADER;\n\n  /** m_signature */\n  m_signature = null;\n\n  /** The WGSL this module was compiled from. */\n  m_source = \"\";\n\n  /** The compiled module, or null before Create. */\n  m_module = null;\n\n  m_webgpu = null;\n\n  /**\n   * This stage's bind-group declarations, from the pass's backend block.\n   *\n   * METAL'S `m_resourceMask`, IN THIS BACKEND'S VOCABULARY. Metal derives a\n   * per-stage binding table from `signature.registers` at Create\n   * (`Tr2ShaderALMetal.mm:37-217`) and the program merges the stages' tables\n   * (`Tr2ShaderProgramALMetal.mm:67`). A WGSL pipeline needs `(group, binding,\n   * layout)` rather than a register mask, and Carbon's registers cannot say\n   * that - so the container's per-pass block does, and it arrives here on the\n   * signature. Only the bindings visible to THIS stage are kept: a stage's\n   * table describes its own bindings, which is what lets two passes share an\n   * identical vertex stage.\n   */\n  m_bindings = [];\n\n  /** Carbon's `m_signature.pipelineInputs`, the vertex inputs this stage reads. */\n  m_inputs = [];\n\n  /**\n   * Compiles the shader.\n   *\n   * @param {number} type A Carbon `ShaderType` value.\n   * @param {ArrayBufferView|string} bytecode WGSL source.\n   * @param {object|null} signature The reflected signature.\n   * @param {string} shaderPath A debug label.\n   * @param {object} renderContext The WebGPU render context AL.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(type, bytecode, signature, shaderPath, renderContext)\n  {\n    this.Destroy();\n\n    // Carbon's stub reports OUT_OF_MEMORY for empty bytecode rather than\n    // INVALIDARG (`Tr2ShaderALStub.cpp`), and the odd choice is transcribed\n    // rather than tidied: a caller testing for it would not recognise a\n    // different code.\n    if (!bytecode || (bytecode.byteLength === 0 && bytecode.length === 0)) return ALResult.E_OUTOFMEMORY;\n\n    if (!renderContext || !renderContext.IsValid()) return ALResult.E_INVALIDCALL;\n\n    const webgpu = renderContext.GetWebgpu();\n    if (!webgpu) return ALResult.E_INVALIDCALL;\n\n    // REFUSED BEFORE COMPILING, AS METAL REFUSES A SIGNATURE IT CANNOT HONOUR\n    // (`Tr2ShaderALMetal.mm:24-27`). A block that is not this backend's - a\n    // WebGL2 container routed here - would otherwise compile a module whose\n    // bindings nothing can lay out, and fail later with a message about the\n    // pipeline.\n    const bindings = StageBindings(type, signature);\n    if (bindings === null) return ALResult.E_INVALIDARG;\n\n    this.m_source = wgslFrom(bytecode);\n    this.m_module = webgpu.GetDevice().createShaderModule({\n      label: shaderPath || \"Tr2ShaderAL\",\n      code: this.m_source\n    });\n    this.m_webgpu = webgpu;\n    this.m_type = type;\n    this.m_signature = signature;\n    this.m_bindings = bindings;\n    this.m_inputs = Array.isArray(signature?.pipelineInputs) ? signature.pipelineInputs.slice() : [];\n\n    return ALResult.S_OK;\n  }\n\n  /** This stage's bind-group declarations. @returns {object[]} */\n  GetBindings()\n  {\n    return this.m_bindings;\n  }\n\n  /** The vertex inputs this stage reads. @returns {object[]} */\n  GetInputs()\n  {\n    return this.m_inputs;\n  }\n\n  /**\n   * Whether the shader compiled AND carries a stage.\n   *\n   * Carbon is `m_type != INVALID_SHADER && !m_bytecode.empty()`\n   * (`Tr2ShaderALStub.cpp:48-51`) - both halves, on every backend. Testing the\n   * module alone accepted a shader with no stage, which a program would then\n   * link and resolve `GetModuleFor` against.\n   */\n  IsValid()\n  {\n    return this.m_module !== null && this.m_type !== ShaderType.INVALID_SHADER;\n  }\n\n  /** The stage this shader was created for. */\n  GetType()\n  {\n    return this.m_type;\n  }\n\n  /** The WGSL this was compiled from, as bytes, matching the stub's contract. */\n  GetBytecode()\n  {\n    return new TextEncoder().encode(this.m_source);\n  }\n\n  /** The reflected signature. */\n  GetSignature()\n  {\n    return this.m_signature;\n  }\n\n  /** The `GPUShaderModule`, for a pipeline to reference. */\n  GetModule()\n  {\n    return this.m_module;\n  }\n\n  /** Releases the module. */\n  Destroy()\n  {\n    // A GPUShaderModule has no destroy(); it is released when nothing\n    // references it. Dropping the reference is the whole of it.\n    this.m_module = null;\n    this.m_webgpu = null;\n    this.m_type = ShaderType.INVALID_SHADER;\n    this.m_signature = null;\n    this.m_source = \"\";\n    this.m_bindings = [];\n    this.m_inputs = [];\n  }\n\n  /**\n   * Claims a stage without bytecode, for a deliberately empty shader.\n   *\n   * The shader stays INVALID, which is the point: the pipeline must name the\n   * stage, and nothing must try to reference a module for it.\n   *\n   * @param {number} type The pipeline stage.\n   */\n  SetNullShaderType(type)\n  {\n    this.m_type = type;\n  }\n\n  /**\n   * Which memory class this shader occupies.\n   *\n   * @returns {number} A `Tr2ALMemoryType` value.\n   */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\n  }\n\n  /**\n   * Fills in a device-resource description.\n   *\n   * @param {object} description The description to fill.\n   * @returns {object} The description, filled.\n   */\n  Describe(description)\n  {\n    if (!description) return description;\n\n    description.memoryClass = this.GetMemoryClass();\n\n    return description;\n  }\n\n  /**\n   * Names the shader for a debugger.\n   *\n   * `GPUShaderModule` carries a writable `label`, and it is what a WebGPU\n   * compilation error quotes - so unlike the stub this keeps the name.\n   *\n   * @param {string} name The name to attach.\n   * @returns {number} An `ALResult` value.\n   */\n  SetName(name)\n  {\n    if (this.m_module) this.m_module.label = String(name);\n\n    return ALResult.S_OK;\n  }\n}\n\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\n// tests and raw Node cannot parse decorator syntax.\n//\n// The donor is NAMED rather than left to be derived from this class's name.\n// Carbon calls every backend's class the same thing and carries the backend in\n// the FILE name, because only one backend compiles at a time; we ship them\n// together, so the backend moves onto the class name. That divergence is the\n// author's to declare, never a checker's to guess.\nCjsSchema.define(CjsWebgpuShaderAL, { className: \"CjsWebgpuShaderAL\", carbon: \"Tr2ShaderAL\" });\n"],"names":["WEBGPU_ENTRY_POINT","WEBGPU_STAGE_NAME","Object","freeze","ShaderType","VERTEX_SHADER","PIXEL_SHADER","COMPUTE_SHADER","wgslFrom","bytecode","bytes","Uint8Array","buffer","byteOffset","byteLength","TextDecoder","decode","StageBindings","type","signature","block","backendBlock","size","stageName","decoded","readBackendBlock","source","bindings","group","bindGroups","binding","visibility","includes","push","identity","scopeIdentity","resourceKind","registerIndex","registerSpace","texture","sampler","CjsWebgpuShaderAL","m_type","INVALID_SHADER","m_signature","m_source","m_module","m_webgpu","m_bindings","m_inputs","Create","shaderPath","renderContext","Destroy","length","ALResult","E_OUTOFMEMORY","IsValid","E_INVALIDCALL","webgpu","GetWebgpu","E_INVALIDARG","GetDevice","createShaderModule","label","code","Array","isArray","pipelineInputs","slice","S_OK","GetBindings","GetInputs","GetType","GetBytecode","TextEncoder","encode","GetSignature","GetModule","SetNullShaderType","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","Describe","description","memoryClass","SetName","name","String","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/webgpu/CjsWebgpuShaderProgramAL.js

@@ -0,0 +1,330 @@
+import { CjsSchema } from '#schema';
+import { Tr2RegisterMapAL, ALResult, Tr2ALMemoryType } from '#trinityal';
+import { ShaderType } from '#consts/render-context';
+import { WEBGPU_STAGE_NAME } from './CjsWebgpuShaderAL.js';
+
+// Source: trinity/trinityal/include/Tr2ShaderProgramAL.h
+//
+// The linked-program half of Carbon's shader pair. The rationale shared with
+// its partner - why these exist at all, why bytecode here is WGSL text rather
+// than DXBC, and why fields are public and Carbon-named - is recorded in the
+// head comment of CjsWebgpuShaderAL.js, which several other files already cite.
+
+/**
+ * WebGPU's `GPUShaderStage` bit for each stage name the backend block uses.
+ *
+ * Spelled out rather than read from `globalThis.GPUShaderStage` because a
+ * headless test has no such global and the values are spec constants.
+ */
+const STAGE_VISIBILITY = Object.freeze({
+  vertex: 1,
+  fragment: 2,
+  compute: 4
+});
+
+/** A monotonic program identity, for the pipeline cache. */
+let nextProgramId = 1;
+
+/**
+ * The layout half of a binding, the part two stages must agree on.
+ *
+ * @param {object} binding A stage binding.
+ * @returns {string} A comparable key.
+ */
+function LayoutKey(binding) {
+  return JSON.stringify([binding.resourceKind, binding.registerSpace, binding.registerIndex, binding.buffer ?? null, binding.texture ?? null, binding.sampler ?? null]);
+}
+
+/**
+ * A `Tr2ShaderProgramAL` linking compiled stages.
+ *
+ * Carbon's program is what a PSO description names, and its stub records which
+ * stages were supplied as a mask. WebGPU has no link step - a render pipeline
+ * takes the vertex and fragment modules directly - so this holds the stages and
+ * answers for them, which is the part the pipeline description needs.
+ *
+ * THE PIPELINE LAYOUT IS BUILT HERE, AT CREATE, FROM THE STAGES. That is
+ * DX12's shape exactly: `Tr2ShaderProgramAL::Create` walks each stage's
+ * signature and merges its registers into one root signature
+ * (`dx12/Tr2ShaderProgramALDx12.cpp:220-252`), and Metal's merges each stage's
+ * resource mask the same way (`Tr2ShaderProgramALMetal.mm:67`). WebGPU's root
+ * signature is a `GPUPipelineLayout`, and its per-stage input is the binding
+ * list each `CjsWebgpuShaderAL` decoded from the block on its signature.
+ *
+ * This is what lets a draw resolve a pipeline from BOUND STATE: a bound program
+ * carries its own layout, so nothing downstream needs the effect package the
+ * program was read from. Before this the program held modules and nothing else,
+ * and the layout lived only in a package the abstraction layer had no route to.
+ *
+ * Register maps retain signature order before physical WebGPU bindings merge.
+ */
+class CjsWebgpuShaderProgramAL {
+  /** m_shaders, in the order given. */
+  m_shaders = [];
+  m_registerMap = new Tr2RegisterMapAL();
+
+  /** Returns the dense register map built from the linked shader signatures. */
+  GetRegisterMap() {
+    return this.m_registerMap;
+  }
+
+  /**
+   * A process-unique identity, which is what the pipeline cache keys on.
+   *
+   * Metal hashes the function POINTERS into its pipeline key
+   * (`MetalWorkQueue.mm:1610-1611`); an id is the same thing in a language
+   * without addresses. Zero until Create.
+   */
+  m_id = 0;
+
+  /** The merged bindings, one entry per `(group, binding)` slot. */
+  m_bindings = [];
+
+  /** `GPUBindGroupLayout` per group, contiguous from group zero. */
+  m_bindGroupLayouts = [];
+
+  /** The `GPUPipelineLayout`, this backend's root signature; null until Create. */
+  m_pipelineLayout = null;
+
+  /** Metal's `m_iaInputs`: the vertex stage's pipeline inputs. */
+  m_inputs = [];
+
+  /**
+   * Links the shaders into a program.
+   *
+   * @param {object[]} shaders The `CjsWebgpuShaderAL`s to link.
+   * @param {object} renderContext The context to link against.
+   * @returns {number} An `ALResult` value.
+   */
+  Create(shaders, renderContext) {
+    this.Destroy();
+    if (!renderContext || !renderContext.IsValid()) return ALResult.E_INVALIDCALL;
+    if (!shaders || shaders.length === 0) return ALResult.E_INVALIDARG;
+
+    // A program with an uncompiled stage would fail at pipeline creation with a
+    // message about the pipeline, not the shader. Refuse where the cause is.
+    //
+    // Two shaders of the SAME stage are refused for the same reason, and every
+    // Carbon backend does it: the stub and Metal by bitmask
+    // (`Tr2ShaderProgramALStub.cpp:35-48`, `Tr2ShaderProgramALMetal.mm:40-53`),
+    // DX11 per slot. Without it a duplicate linked silently and `GetModuleFor`
+    // returned whichever `find` reached first - unpredictable, and invisible
+    // until a pipeline drew with the wrong stage.
+    let stages = 0;
+    for (const shader of shaders) {
+      if (!shader || !shader.IsValid()) return ALResult.E_INVALIDARG;
+      const bit = 1 << shader.GetType();
+      if ((stages & bit) !== 0) return ALResult.E_INVALIDARG;
+      stages |= bit;
+    }
+
+    // MERGE BY SLOT, AS DX12 MERGES BY REGISTER. A binding two stages both
+    // read appears in both stage lists; it becomes ONE layout entry visible to
+    // both. Two stages claiming one slot with different layouts is a container
+    // defect, refused here where the cause is rather than at pipeline creation.
+    const merged = new Map();
+    for (const shader of shaders) {
+      const visibility = STAGE_VISIBILITY[WEBGPU_STAGE_NAME[shader.GetType()]] ?? 0;
+      for (const binding of shader.GetBindings()) {
+        const slot = `${binding.group}:${binding.binding}`;
+        const existing = merged.get(slot);
+        if (existing) {
+          if (existing.layoutKey !== LayoutKey(binding)) return ALResult.E_INVALIDARG;
+          existing.visibility |= visibility;
+          continue;
+        }
+        merged.set(slot, {
+          ...binding,
+          visibility,
+          layoutKey: LayoutKey(binding)
+        });
+      }
+    }
+    const bindings = Array.from(merged.values()).sort((left, right) => left.group - right.group || left.binding - right.binding);
+    const groupCount = bindings.length ? bindings[bindings.length - 1].group + 1 : 0;
+
+    // THE DEVICE OBJECTS ARE MADE HERE, as DX12 serialises and creates its root
+    // signature inside Create (`:262-289`). An absent group index gets an
+    // empty layout: WebGPU pipeline layouts are positional.
+    const webgpu = renderContext.GetWebgpu();
+    if (!webgpu) return ALResult.E_INVALIDCALL;
+    const device = webgpu.GetDevice();
+    const bindGroupLayouts = [];
+    for (let group = 0; group < groupCount; group += 1) {
+      bindGroupLayouts.push(device.createBindGroupLayout({
+        label: `Tr2ShaderProgramAL.group${group}`,
+        entries: bindings.filter(binding => binding.group === group).map(binding => ({
+          binding: binding.binding,
+          visibility: binding.visibility,
+          // A UNIFORM SLOT IS DYNAMIC, by the backend's decision and not the
+          // container's. Constant buffers are bound out of a per-frame arena
+          // at (page, offset), as Metal's are (`MetalWorkQueue.mm:2656-2659`,
+          // `setVertexBufferOffset:`), and WebGPU spells a per-draw offset as
+          // a dynamic offset on the layout. The container's `hasDynamicOffset`
+          // is not consulted: it describes nothing the AL does not decide.
+          ...(binding.buffer ? {
+            buffer: binding.buffer.type === "uniform" ? {
+              ...binding.buffer,
+              hasDynamicOffset: true
+            } : binding.buffer
+          } : {}),
+          ...(binding.texture ? {
+            texture: binding.texture
+          } : {}),
+          ...(binding.sampler ? {
+            sampler: binding.sampler
+          } : {})
+        }))
+      }));
+    }
+    this.m_pipelineLayout = device.createPipelineLayout({
+      label: "Tr2ShaderProgramAL.layout",
+      bindGroupLayouts
+    });
+    this.m_bindGroupLayouts = bindGroupLayouts;
+    this.m_bindings = bindings;
+    this.m_shaders = shaders.slice();
+    this.m_registerMap = new Tr2RegisterMapAL({
+      shaders
+    });
+    this.m_inputs = shaders.find(shader => shader.GetType() === ShaderType.VERTEX_SHADER)?.GetInputs() ?? [];
+    this.m_id = nextProgramId;
+    nextProgramId += 1;
+    return ALResult.S_OK;
+  }
+
+  /** Whether the program linked. */
+  IsValid() {
+    return this.m_shaders.length > 0;
+  }
+
+  /**
+   * The identity a pipeline cache keys this program under.
+   *
+   * @returns {string|null} A stable string, or null before Create.
+   */
+  GetIdentity() {
+    return this.m_id ? `program:${this.m_id}` : null;
+  }
+
+  /** The merged bind-group declarations, sorted by group then binding. */
+  GetBindings() {
+    return this.m_bindings;
+  }
+
+  /** Metal's `GetInputs`: the vertex stage's pipeline inputs. */
+  GetInputs() {
+    return this.m_inputs;
+  }
+
+  /** One `GPUBindGroupLayout` per group, contiguous from zero. */
+  GetBindGroupLayouts() {
+    return this.m_bindGroupLayouts;
+  }
+
+  /** The `GPUPipelineLayout` a pipeline built from this program takes. */
+  GetPipelineLayout() {
+    return this.m_pipelineLayout;
+  }
+
+  /** The linked shaders, in the order they were given. */
+  GetShaders() {
+    return this.m_shaders;
+  }
+
+  /**
+   * The module for one stage, or null when the program has no such stage.
+   *
+   * @param {*} type The stage to find.
+   * @returns {GPUShaderModule|null} Its module.
+   */
+  GetModuleFor(type) {
+    const shader = this.m_shaders.find(candidate => candidate.GetType() === type);
+    return shader ? shader.GetModule() : null;
+  }
+
+  /** Releases the linked shaders and the layout built from them. */
+  Destroy() {
+    // Layout objects have no destroy(); dropping the references releases them.
+    this.m_shaders = [];
+    this.m_registerMap = new Tr2RegisterMapAL();
+    this.m_bindings = [];
+    this.m_bindGroupLayouts = [];
+    this.m_pipelineLayout = null;
+    this.m_inputs = [];
+    this.m_id = 0;
+  }
+
+  /**
+   * Builds D3D12 indirect-command signatures.
+   *
+   * REFUSES, WHICH IS CARBON'S OWN NON-DX12 ANSWER rather than an omission.
+   * The shared facade defines it for every other backend as `return E_FAIL`
+   * (`src/Tr2ShaderProgramAL.cpp:34-42`), so the method is on the contract
+   * everywhere and only its implementation is DX12's.
+   *
+   * It was recorded as an accepted divergence on the grounds that it is
+   * "DX12-only". That was a misreading: leaving it out produces a TypeError at
+   * the call site, which is the defect class this backend's surface work was
+   * written to remove.
+   *
+   * @param {object} _bufferLayout A `Tr2IndirectBufferLayoutAL`.
+   * @param {object} _renderContext The primary render context.
+   * @returns {boolean} False.
+   */
+  CreateCommandSignatures(_bufferLayout, _renderContext) {
+    return false;
+  }
+
+  /**
+   * Which memory class this program occupies.
+   *
+   * @returns {number} A `Tr2ALMemoryType` value.
+   */
+  GetMemoryClass() {
+    return Tr2ALMemoryType.AL_MEMORY_MANAGED;
+  }
+
+  /**
+   * Fills in a device-resource description.
+   *
+   * @param {object} description The description to fill.
+   * @returns {object} The description, filled.
+   */
+  Describe(description) {
+    if (!description) return description;
+    description.memoryClass = this.GetMemoryClass();
+    return description;
+  }
+
+  /**
+   * Names the program for a debugger, and every stage under it.
+   *
+   * WebGPU has no program object to label - there is no link step - so the name
+   * reaches the modules, which is where it can actually appear in an error.
+   *
+   * @param {string} name The name to attach.
+   * @returns {number} An `ALResult` value.
+   */
+  SetName(name) {
+    for (const shader of this.m_shaders) shader.SetName(name);
+    return ALResult.S_OK;
+  }
+}
+
+// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in
+// Tr2BitmapDimensions.js: the layer is imported straight from source by its
+// tests and raw Node cannot parse decorator syntax.
+//
+// The donor is NAMED rather than left to be derived from this class's name.
+// Carbon calls every backend's class the same thing and carries the backend in
+// the FILE name, because only one backend compiles at a time; we ship them
+// together, so the backend moves onto the class name. That divergence is the
+// author's to declare, never a checker's to guess.
+CjsSchema.define(CjsWebgpuShaderProgramAL, {
+  className: "CjsWebgpuShaderProgramAL",
+  carbon: "Tr2ShaderProgramAL"
+});
+
+export { CjsWebgpuShaderProgramAL };
+//# sourceMappingURL=CjsWebgpuShaderProgramAL.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CjsWebgpuShaderProgramAL.js","sources":["../../../../src/trinityal/webgpu/CjsWebgpuShaderProgramAL.js"],"sourcesContent":["// Source: trinity/trinityal/include/Tr2ShaderProgramAL.h\n//\n// The linked-program half of Carbon's shader pair. The rationale shared with\n// its partner - why these exist at all, why bytecode here is WGSL text rather\n// than DXBC, and why fields are public and Carbon-named - is recorded in the\n// head comment of CjsWebgpuShaderAL.js, which several other files already cite.\nimport { CjsSchema } from \"#schema\";\nimport { ALResult, Tr2ALMemoryType, Tr2RegisterMapAL } from \"#trinityal\";\nimport { ShaderType } from \"#consts/render-context\";\nimport { WEBGPU_STAGE_NAME } from \"./CjsWebgpuShaderAL.js\";\n\n/**\n * WebGPU's `GPUShaderStage` bit for each stage name the backend block uses.\n *\n * Spelled out rather than read from `globalThis.GPUShaderStage` because a\n * headless test has no such global and the values are spec constants.\n */\nconst STAGE_VISIBILITY = Object.freeze({ vertex: 1, fragment: 2, compute: 4 });\n\n/** A monotonic program identity, for the pipeline cache. */\nlet nextProgramId = 1;\n\n/**\n * The layout half of a binding, the part two stages must agree on.\n *\n * @param {object} binding A stage binding.\n * @returns {string} A comparable key.\n */\nfunction LayoutKey(binding)\n{\n  return JSON.stringify([\n    binding.resourceKind,\n    binding.registerSpace,\n    binding.registerIndex,\n    binding.buffer ?? null,\n    binding.texture ?? null,\n    binding.sampler ?? null\n  ]);\n}\n\n/**\n * A `Tr2ShaderProgramAL` linking compiled stages.\n *\n * Carbon's program is what a PSO description names, and its stub records which\n * stages were supplied as a mask. WebGPU has no link step - a render pipeline\n * takes the vertex and fragment modules directly - so this holds the stages and\n * answers for them, which is the part the pipeline description needs.\n *\n * THE PIPELINE LAYOUT IS BUILT HERE, AT CREATE, FROM THE STAGES. That is\n * DX12's shape exactly: `Tr2ShaderProgramAL::Create` walks each stage's\n * signature and merges its registers into one root signature\n * (`dx12/Tr2ShaderProgramALDx12.cpp:220-252`), and Metal's merges each stage's\n * resource mask the same way (`Tr2ShaderProgramALMetal.mm:67`). WebGPU's root\n * signature is a `GPUPipelineLayout`, and its per-stage input is the binding\n * list each `CjsWebgpuShaderAL` decoded from the block on its signature.\n *\n * This is what lets a draw resolve a pipeline from BOUND STATE: a bound program\n * carries its own layout, so nothing downstream needs the effect package the\n * program was read from. Before this the program held modules and nothing else,\n * and the layout lived only in a package the abstraction layer had no route to.\n *\n * Register maps retain signature order before physical WebGPU bindings merge.\n */\nexport class CjsWebgpuShaderProgramAL\n{\n  /** m_shaders, in the order given. */\n  m_shaders = [];\n\n  m_registerMap = new Tr2RegisterMapAL();\n\n  /** Returns the dense register map built from the linked shader signatures. */\n  GetRegisterMap()\n  {\n    return this.m_registerMap;\n  }\n\n  /**\n   * A process-unique identity, which is what the pipeline cache keys on.\n   *\n   * Metal hashes the function POINTERS into its pipeline key\n   * (`MetalWorkQueue.mm:1610-1611`); an id is the same thing in a language\n   * without addresses. Zero until Create.\n   */\n  m_id = 0;\n\n  /** The merged bindings, one entry per `(group, binding)` slot. */\n  m_bindings = [];\n\n  /** `GPUBindGroupLayout` per group, contiguous from group zero. */\n  m_bindGroupLayouts = [];\n\n  /** The `GPUPipelineLayout`, this backend's root signature; null until Create. */\n  m_pipelineLayout = null;\n\n  /** Metal's `m_iaInputs`: the vertex stage's pipeline inputs. */\n  m_inputs = [];\n\n  /**\n   * Links the shaders into a program.\n   *\n   * @param {object[]} shaders The `CjsWebgpuShaderAL`s to link.\n   * @param {object} renderContext The context to link against.\n   * @returns {number} An `ALResult` value.\n   */\n  Create(shaders, renderContext)\n  {\n    this.Destroy();\n\n    if (!renderContext || !renderContext.IsValid()) return ALResult.E_INVALIDCALL;\n    if (!shaders || shaders.length === 0) return ALResult.E_INVALIDARG;\n\n    // A program with an uncompiled stage would fail at pipeline creation with a\n    // message about the pipeline, not the shader. Refuse where the cause is.\n    //\n    // Two shaders of the SAME stage are refused for the same reason, and every\n    // Carbon backend does it: the stub and Metal by bitmask\n    // (`Tr2ShaderProgramALStub.cpp:35-48`, `Tr2ShaderProgramALMetal.mm:40-53`),\n    // DX11 per slot. Without it a duplicate linked silently and `GetModuleFor`\n    // returned whichever `find` reached first - unpredictable, and invisible\n    // until a pipeline drew with the wrong stage.\n    let stages = 0;\n    for (const shader of shaders)\n    {\n      if (!shader || !shader.IsValid()) return ALResult.E_INVALIDARG;\n\n      const bit = 1 << shader.GetType();\n      if ((stages & bit) !== 0) return ALResult.E_INVALIDARG;\n      stages |= bit;\n    }\n\n    // MERGE BY SLOT, AS DX12 MERGES BY REGISTER. A binding two stages both\n    // read appears in both stage lists; it becomes ONE layout entry visible to\n    // both. Two stages claiming one slot with different layouts is a container\n    // defect, refused here where the cause is rather than at pipeline creation.\n    const merged = new Map();\n\n    for (const shader of shaders)\n    {\n      const visibility = STAGE_VISIBILITY[WEBGPU_STAGE_NAME[shader.GetType()]] ?? 0;\n\n      for (const binding of shader.GetBindings())\n      {\n        const slot = `${binding.group}:${binding.binding}`;\n        const existing = merged.get(slot);\n\n        if (existing)\n        {\n          if (existing.layoutKey !== LayoutKey(binding)) return ALResult.E_INVALIDARG;\n          existing.visibility |= visibility;\n          continue;\n        }\n\n        merged.set(slot, { ...binding, visibility, layoutKey: LayoutKey(binding) });\n      }\n    }\n\n    const bindings = Array.from(merged.values())\n      .sort((left, right) => left.group - right.group || left.binding - right.binding);\n    const groupCount = bindings.length ? bindings[bindings.length - 1].group + 1 : 0;\n\n    // THE DEVICE OBJECTS ARE MADE HERE, as DX12 serialises and creates its root\n    // signature inside Create (`:262-289`). An absent group index gets an\n    // empty layout: WebGPU pipeline layouts are positional.\n    const webgpu = renderContext.GetWebgpu();\n    if (!webgpu) return ALResult.E_INVALIDCALL;\n\n    const device = webgpu.GetDevice();\n\n    const bindGroupLayouts = [];\n\n    for (let group = 0; group < groupCount; group += 1)\n    {\n      bindGroupLayouts.push(device.createBindGroupLayout({\n        label: `Tr2ShaderProgramAL.group${group}`,\n        entries: bindings\n          .filter(binding => binding.group === group)\n          .map(binding => ({\n            binding: binding.binding,\n            visibility: binding.visibility,\n            // A UNIFORM SLOT IS DYNAMIC, by the backend's decision and not the\n            // container's. Constant buffers are bound out of a per-frame arena\n            // at (page, offset), as Metal's are (`MetalWorkQueue.mm:2656-2659`,\n            // `setVertexBufferOffset:`), and WebGPU spells a per-draw offset as\n            // a dynamic offset on the layout. The container's `hasDynamicOffset`\n            // is not consulted: it describes nothing the AL does not decide.\n            ...(binding.buffer\n              ? { buffer: binding.buffer.type === \"uniform\" ? { ...binding.buffer, hasDynamicOffset: true } : binding.buffer }\n              : {}),\n            ...(binding.texture ? { texture: binding.texture } : {}),\n            ...(binding.sampler ? { sampler: binding.sampler } : {})\n          }))\n      }));\n    }\n\n    this.m_pipelineLayout = device.createPipelineLayout({\n      label: \"Tr2ShaderProgramAL.layout\",\n      bindGroupLayouts\n    });\n    this.m_bindGroupLayouts = bindGroupLayouts;\n    this.m_bindings = bindings;\n    this.m_shaders = shaders.slice();\n    this.m_registerMap = new Tr2RegisterMapAL({ shaders });\n    this.m_inputs = shaders\n      .find(shader => shader.GetType() === ShaderType.VERTEX_SHADER)\n      ?.GetInputs() ?? [];\n    this.m_id = nextProgramId;\n    nextProgramId += 1;\n\n    return ALResult.S_OK;\n  }\n\n  /** Whether the program linked. */\n  IsValid()\n  {\n    return this.m_shaders.length > 0;\n  }\n\n  /**\n   * The identity a pipeline cache keys this program under.\n   *\n   * @returns {string|null} A stable string, or null before Create.\n   */\n  GetIdentity()\n  {\n    return this.m_id ? `program:${this.m_id}` : null;\n  }\n\n  /** The merged bind-group declarations, sorted by group then binding. */\n  GetBindings()\n  {\n    return this.m_bindings;\n  }\n\n  /** Metal's `GetInputs`: the vertex stage's pipeline inputs. */\n  GetInputs()\n  {\n    return this.m_inputs;\n  }\n\n  /** One `GPUBindGroupLayout` per group, contiguous from zero. */\n  GetBindGroupLayouts()\n  {\n    return this.m_bindGroupLayouts;\n  }\n\n  /** The `GPUPipelineLayout` a pipeline built from this program takes. */\n  GetPipelineLayout()\n  {\n    return this.m_pipelineLayout;\n  }\n\n  /** The linked shaders, in the order they were given. */\n  GetShaders()\n  {\n    return this.m_shaders;\n  }\n\n  /**\n   * The module for one stage, or null when the program has no such stage.\n   *\n   * @param {*} type The stage to find.\n   * @returns {GPUShaderModule|null} Its module.\n   */\n  GetModuleFor(type)\n  {\n    const shader = this.m_shaders.find(candidate => candidate.GetType() === type);\n\n    return shader ? shader.GetModule() : null;\n  }\n\n  /** Releases the linked shaders and the layout built from them. */\n  Destroy()\n  {\n    // Layout objects have no destroy(); dropping the references releases them.\n    this.m_shaders = [];\n    this.m_registerMap = new Tr2RegisterMapAL();\n    this.m_bindings = [];\n    this.m_bindGroupLayouts = [];\n    this.m_pipelineLayout = null;\n    this.m_inputs = [];\n    this.m_id = 0;\n  }\n\n  /**\n   * Builds D3D12 indirect-command signatures.\n   *\n   * REFUSES, WHICH IS CARBON'S OWN NON-DX12 ANSWER rather than an omission.\n   * The shared facade defines it for every other backend as `return E_FAIL`\n   * (`src/Tr2ShaderProgramAL.cpp:34-42`), so the method is on the contract\n   * everywhere and only its implementation is DX12's.\n   *\n   * It was recorded as an accepted divergence on the grounds that it is\n   * \"DX12-only\". That was a misreading: leaving it out produces a TypeError at\n   * the call site, which is the defect class this backend's surface work was\n   * written to remove.\n   *\n   * @param {object} _bufferLayout A `Tr2IndirectBufferLayoutAL`.\n   * @param {object} _renderContext The primary render context.\n   * @returns {boolean} False.\n   */\n  CreateCommandSignatures(_bufferLayout, _renderContext)\n  {\n    return false;\n  }\n\n  /**\n   * Which memory class this program occupies.\n   *\n   * @returns {number} A `Tr2ALMemoryType` value.\n   */\n  GetMemoryClass()\n  {\n    return Tr2ALMemoryType.AL_MEMORY_MANAGED;\n  }\n\n  /**\n   * Fills in a device-resource description.\n   *\n   * @param {object} description The description to fill.\n   * @returns {object} The description, filled.\n   */\n  Describe(description)\n  {\n    if (!description) return description;\n\n    description.memoryClass = this.GetMemoryClass();\n\n    return description;\n  }\n\n  /**\n   * Names the program for a debugger, and every stage under it.\n   *\n   * WebGPU has no program object to label - there is no link step - so the name\n   * reaches the modules, which is where it can actually appear in an error.\n   *\n   * @param {string} name The name to attach.\n   * @returns {number} An `ALResult` value.\n   */\n  SetName(name)\n  {\n    for (const shader of this.m_shaders) shader.SetName(name);\n\n    return ALResult.S_OK;\n  }\n}\n\n// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in\n// Tr2BitmapDimensions.js: the layer is imported straight from source by its\n// tests and raw Node cannot parse decorator syntax.\n//\n// The donor is NAMED rather than left to be derived from this class's name.\n// Carbon calls every backend's class the same thing and carries the backend in\n// the FILE name, because only one backend compiles at a time; we ship them\n// together, so the backend moves onto the class name. That divergence is the\n// author's to declare, never a checker's to guess.\nCjsSchema.define(CjsWebgpuShaderProgramAL, { className: \"CjsWebgpuShaderProgramAL\", carbon: \"Tr2ShaderProgramAL\" });\n"],"names":["STAGE_VISIBILITY","Object","freeze","vertex","fragment","compute","nextProgramId","LayoutKey","binding","JSON","stringify","resourceKind","registerSpace","registerIndex","buffer","texture","sampler","CjsWebgpuShaderProgramAL","m_shaders","m_registerMap","Tr2RegisterMapAL","GetRegisterMap","m_id","m_bindings","m_bindGroupLayouts","m_pipelineLayout","m_inputs","Create","shaders","renderContext","Destroy","IsValid","ALResult","E_INVALIDCALL","length","E_INVALIDARG","stages","shader","bit","GetType","merged","Map","visibility","WEBGPU_STAGE_NAME","GetBindings","slot","group","existing","get","layoutKey","set","bindings","Array","from","values","sort","left","right","groupCount","webgpu","GetWebgpu","device","GetDevice","bindGroupLayouts","push","createBindGroupLayout","label","entries","filter","map","type","hasDynamicOffset","createPipelineLayout","slice","find","ShaderType","VERTEX_SHADER","GetInputs","S_OK","GetIdentity","GetBindGroupLayouts","GetPipelineLayout","GetShaders","GetModuleFor","candidate","GetModule","CreateCommandSignatures","_bufferLayout","_renderContext","GetMemoryClass","Tr2ALMemoryType","AL_MEMORY_MANAGED","Describe","description","memoryClass","SetName","name","CjsSchema","define","className","carbon"],"mappings":"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"}

package/dist/trinityal/webgpu/CjsWebgpuTextureAL.js

@@ -1,3 +1,4 @@
+import { CjsSchema } from '#schema';
 import { Tr2MsaaDesc, ALResult, Tr2ALMemoryType } from '#trinityal';
 import { TextureType, Tr2GpuUsage, Tr2CpuUsage, HasFlag, PixelFormat } from '#consts/render-context';
 import { CarbonPixelFormatToWebGpu, SrgbSiblingOf } from '../../global/consts/webgpu/textureFormats.js';
@@ -415,5 +416,19 @@ class CjsWebgpuTextureAL {
   }
 }
 
+// DECLARED AS A CALL, NOT A DECORATOR, for the reason recorded in
+// Tr2BitmapDimensions.js: the layer is imported straight from source by its
+// tests and raw Node cannot parse decorator syntax.
+//
+// The donor is NAMED rather than left to be derived from this class's name.
+// Carbon calls every backend's class the same thing and carries the backend in
+// the FILE name, because only one backend compiles at a time; we ship them
+// together, so the backend moves onto the class name. That divergence is the
+// author's to declare, never a checker's to guess.
+CjsSchema.define(CjsWebgpuTextureAL, {
+  className: "CjsWebgpuTextureAL",
+  carbon: "Tr2TextureAL"
+});
+
 export { CjsWebgpuTextureAL };
 //# sourceMappingURL=CjsWebgpuTextureAL.js.map