@carbonenginejs/runtime-resource 0.20.0 → 0.22.0

package/dist/formats/webgl/CjsWebglFormat.js

@@ -1,17 +1,9 @@
+import { CjsFormat } from '../../format/CjsFormat.js';
 import { DEFAULT_VALUES, normalizeValues, emitGlslWithOptions, toJsonValue, isWebglEffectContainer, OUTPUT_JSON } from './core/helpers.js';
 import { buildEffectPackage } from './core/effectPackage.js';
 import { readGlslEffectContainer } from './core/readGlslEffectContainer.js';
 import { inspectGlslEffectContainer } from './core/inspectGlslEffectContainer.js';
 
-/**
- * Exposed CarbonEngineJS-facing WebGL format class.
- *
- * Keep this file small and reviewable: container decoding lives in
- * core/readGlslEffectContainer.js, summarising in
- * core/inspectGlslEffectContainer.js, the DXBC-to-GLSL ES 3.00 emitter under
- * core/glsl, and option normalization in core/helpers.js.
- */
-
 const FORMAT_NAME = "CjsWebglFormat";
 
 /**
@@ -26,7 +18,7 @@ const FORMAT_NAME = "CjsWebglFormat";
  * records; `Inspect` is a cheap structural summary; `BuildEffect` translates a
  * compiled Tr2 effect into one; `EmitGlsl` translates a single DXBC stage.
  */
-class CjsWebglFormat {
+class CjsWebglFormat extends CjsFormat {
   #emit = DEFAULT_VALUES.emit;
   #source = DEFAULT_VALUES.source;
 
@@ -36,6 +28,7 @@ class CjsWebglFormat {
    * @param {object} [options] Default format values.
    */
   constructor(options = {}) {
+    super();
     this.SetValues(options);
   }
 
@@ -188,10 +181,15 @@ class CjsWebglFormat {
     return toJsonValue(value);
   }
   static OUTPUT_JSON = OUTPUT_JSON;
-  static type = Object.freeze(["shader"]);
+  static id = "webgl";
   static mediaTypes = Object.freeze(["shader"]);
-  static inputTypes = Object.freeze(["carbonwebgl"]);
-  static outputTypes = Object.freeze([OUTPUT_JSON]);
+  static outputs = CjsFormat.defineOutputs({
+    json: {
+      default: true,
+      decoded: true
+    }
+  });
+  static extensions = Object.freeze([]);
   static packageVersion = "0.2.0";
 }
 

package/dist/formats/webgl/CjsWebglFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsWebglFormat.js","sources":["../../../../src/formats/webgl/CjsWebglFormat.js"],"sourcesContent":["/**\n * Exposed CarbonEngineJS-facing WebGL format class.\n *\n * Keep this file small and reviewable: container decoding lives in\n * core/readGlslEffectContainer.js, summarising in\n * core/inspectGlslEffectContainer.js, the DXBC-to-GLSL ES 3.00 emitter under\n * core/glsl, and option normalization in core/helpers.js.\n */\n\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    emitGlslWithOptions,\n    isWebglEffectContainer,\n    normalizeValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { buildEffectPackage } from \"./core/effectPackage.js\";\nimport { readGlslEffectContainer } from \"./core/readGlslEffectContainer.js\";\nimport { inspectGlslEffectContainer } from \"./core/inspectGlslEffectContainer.js\";\n\nconst FORMAT_NAME = \"CjsWebglFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.carbonwebgl` WebGL shader packages, and\n * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute\n * stages ccpwgl targets.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary. A\n * WebGL effect is a stock Carbon effect container whose stored programs are\n * GLSL ES 3.00 - the same file shape Carbon ships for its own backends, and the\n * same one WebGPU emits with WGSL. `Read` decodes one into stage and shader\n * records; `Inspect` is a cheap structural summary; `BuildEffect` translates a\n * compiled Tr2 effect into one; `EmitGlsl` translates a single DXBC stage.\n */\nexport class CjsWebglFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsWebglFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            source: this.#source\n        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Decode an effect container into stage and shader records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    Read(input, options = {})\n    {\n        return readGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Summarise an effect container without decoding every body's records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    EmitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Builds a complete effect container from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    BuildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Instance JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload has the container shape.\n     */\n    static isWebglEffectContainer(input)\n    {\n        return isWebglEffectContainer(input);\n    }\n\n    /**\n     * Static one-shot container decode.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    static read(input, options = {})\n    {\n        return readGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot DXBC-to-GLSL emission.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`\n     *   (`\"array\"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `\"std140\"`),\n     *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),\n     *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`\n     *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),\n     *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    static emitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Static whole-effect container builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"carbonwebgl\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static packageVersion = \"0.2.0\";\n\n}\n\nexport default CjsWebglFormat;\n"],"names":["FORMAT_NAME","CjsWebglFormat","DEFAULT_VALUES","emit","source","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readGlslEffectContainer","Inspect","inspectGlslEffectContainer","EmitGlsl","dxbcBytes","emitGlslWithOptions","BuildEffect","buildEffectPackage","ToJSON","value","toJsonValue","isWebglEffectContainer","read","inspect","emitGlsl","buildEffect","toJSON","OUTPUT_JSON","type","Object","freeze","mediaTypes","inputTypes","outputTypes","packageVersion"],"mappings":"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"}
+{"version":3,"file":"CjsWebglFormat.js","sources":["../../../../src/formats/webgl/CjsWebglFormat.js"],"sourcesContent":["import { CjsFormat } from \"../../format/CjsFormat.js\";\n/**\n * Exposed CarbonEngineJS-facing WebGL format class.\n *\n * Keep this file small and reviewable: container decoding lives in\n * core/readGlslEffectContainer.js, summarising in\n * core/inspectGlslEffectContainer.js, the DXBC-to-GLSL ES 3.00 emitter under\n * core/glsl, and option normalization in core/helpers.js.\n */\n\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    emitGlslWithOptions,\n    isWebglEffectContainer,\n    normalizeValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { buildEffectPackage } from \"./core/effectPackage.js\";\nimport { readGlslEffectContainer } from \"./core/readGlslEffectContainer.js\";\nimport { inspectGlslEffectContainer } from \"./core/inspectGlslEffectContainer.js\";\n\nconst FORMAT_NAME = \"CjsWebglFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.carbonwebgl` WebGL shader packages, and\n * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute\n * stages ccpwgl targets.\n *\n * The Cjs prefix marks this as a JavaScript format/construction boundary. A\n * WebGL effect is a stock Carbon effect container whose stored programs are\n * GLSL ES 3.00 - the same file shape Carbon ships for its own backends, and the\n * same one WebGPU emits with WGSL. `Read` decodes one into stage and shader\n * records; `Inspect` is a cheap structural summary; `BuildEffect` translates a\n * compiled Tr2 effect into one; `EmitGlsl` translates a single DXBC stage.\n */\nexport class CjsWebglFormat extends CjsFormat\n{\n\n    #emit = DEFAULT_VALUES.emit;\n    #source = DEFAULT_VALUES.source;\n\n    /**\n     * Create a reusable format profile.\n     *\n     * @param {object} [options] Default format values.\n     */\n    constructor(options = {})\n    {\n        super();\n        this.SetValues(options);\n    }\n\n    /**\n     * Set format values for this reusable profile.\n     *\n     * @param {object} [options] Values to merge into the profile.\n     * @returns {CjsWebglFormat} This format profile.\n     */\n    SetValues(options = {})\n    {\n        const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);\n\n        this.#emit = values.emit;\n        this.#source = values.source;\n\n        return this;\n    }\n\n    /**\n     * Get this profile's current values, optionally with per-call overrides.\n     *\n     * @param {object} [options] Optional values to merge into a copy.\n     * @returns {object} A copy of the effective values.\n     */\n    GetValues(options = {})\n    {\n        return normalizeValues({\n            emit: this.#emit,\n            source: this.#source\n        }, options, FORMAT_NAME);\n    }\n\n    /**\n     * Decode an effect container into stage and shader records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    Read(input, options = {})\n    {\n        return readGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Summarise an effect container without decoding every body's records.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, this.GetValues(options));\n    }\n\n    /**\n     * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    EmitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Builds a complete effect container from compiled Tr2 effect bytes.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    BuildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Instance JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    ToJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    /**\n     * Static payload sniff. Static methods use camelCase by convention.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.\n     * @returns {boolean} True when the payload has the container shape.\n     */\n    static isWebglEffectContainer(input)\n    {\n        return isWebglEffectContainer(input);\n    }\n\n    /**\n     * Static one-shot container decode.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Stage graph in the completeness rules' vocabulary.\n     */\n    static read(input, options = {})\n    {\n        return readGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Container bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectGlslEffectContainer(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot DXBC-to-GLSL emission.\n     *\n     * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n     * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`\n     *   (`\"array\"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `\"std140\"`),\n     *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),\n     *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`\n     *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),\n     *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).\n     * @returns {object} GLSL text plus the IO contract the packaging layer records.\n     */\n    static emitGlsl(dxbcBytes, options = {})\n    {\n        return emitGlslWithOptions(dxbcBytes, options);\n    }\n\n    /**\n     * Static whole-effect container builder.\n     *\n     * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n     * @param {object} [options] Selection, provenance, and emitter policy.\n     * @returns {object} Package bytes plus inspection and qualification records.\n     */\n    static buildEffect(input, options = {})\n    {\n        return buildEffectPackage(input, options);\n    }\n\n    /**\n     * Static JSON-compatible conversion.\n     *\n     * @param {any} value Format output to convert.\n     * @returns {any} Plain JSON-compatible data.\n     */\n    static toJSON(value)\n    {\n        return toJsonValue(value);\n    }\n\n    static OUTPUT_JSON = OUTPUT_JSON;\n    static id = \"webgl\";\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static outputs = CjsFormat.defineOutputs({\n        json: { default: true, decoded: true }\n    });\n    static extensions = Object.freeze([]);\n    static packageVersion = \"0.2.0\";\n\n}\n\nexport default CjsWebglFormat;\n"],"names":["FORMAT_NAME","CjsWebglFormat","CjsFormat","DEFAULT_VALUES","emit","source","constructor","options","SetValues","values","normalizeValues","GetValues","Read","input","readGlslEffectContainer","Inspect","inspectGlslEffectContainer","EmitGlsl","dxbcBytes","emitGlslWithOptions","BuildEffect","buildEffectPackage","ToJSON","value","toJsonValue","isWebglEffectContainer","read","inspect","emitGlsl","buildEffect","toJSON","OUTPUT_JSON","id","mediaTypes","Object","freeze","outputs","defineOutputs","json","default","decoded","extensions","packageVersion"],"mappings":"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"}

package/dist/formats/webgl/core/glsl/DxbcGlslEmitter.js

@@ -2982,11 +2982,37 @@ DxbcGlslEmitter.prototype._ldStructured = function _ldStructured(state, instruct
     });
   }
   const offsetDwords = offsetOperand.immediateValues[0].uint32 >> 2;
-  const element = state.formatter.sourceExpression(instruction.operands[1], {
+  let element = state.formatter.sourceExpression(instruction.operands[1], {
     destMask: "x",
     as: "int"
   });
   const swizzle = resourceOperand.swizzle || "xyzw";
+
+  // `ld_structured` reads its address ONCE and writes every masked component
+  // from that one read. This emitter scalarises the write into one assignment
+  // per component and re-substitutes the address expression in each, so when
+  // the destination register is also the address register, the second
+  // component onwards reads the value the first assignment just stored.
+  //
+  // That is not hypothetical: it corrupts the bone-matrix fetch in every
+  // skinned EVE hull shader. The address is `blendIndex + boneArrayBase`, the
+  // destination is the same register, and the third matrix row overwrites it
+  // mid-fetch - so rows 2 and 3 index the bone buffer with a matrix float
+  // (~1e9) instead of a bone index. Verified across skinned_quadv5,
+  // skinned_quaddetailv5 and skinned_quadheatv5: every vertex body of every
+  // technique. Unskinned shaders never alias and are unaffected.
+  //
+  // Same hazard `movc` above already guards, handled the same way, and only
+  // when it actually aliases so non-aliasing shaders emit byte-identical GLSL.
+  const addressOperand = instruction.operands[1];
+  const destOperand = instruction.operands[0];
+  const aliasesAddress = addressOperand && destOperand && addressOperand.type === destOperand.type && addressOperand.registerIndex === destOperand.registerIndex;
+  if (aliasesAddress) {
+    this._line(state, "{");
+    state.indent += 1;
+    this._line(state, `int cjsSbAddr = ${element};`);
+    element = "cjsSbAddr";
+  }
   const widthMask = this.profile.dataTextureWidth - 1;
   const widthShift = Math.log2(this.profile.dataTextureWidth);
   const aligned = info.strideDwords % 4 === 0 && offsetDwords % 4 === 0;
@@ -3028,6 +3054,10 @@ DxbcGlslEmitter.prototype._ldStructured = function _ldStructured(state, instruct
     }
     this._line(state, `${this._destComponentRef(state, instruction.operands[0], target, component)} = ${value};`);
   }
+  if (aliasesAddress) {
+    state.indent -= 1;
+    this._line(state, "}");
+  }
 };
 
 /**