@carbonenginejs/runtime-resource 0.19.2 → 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":";;;;;;AAsBA,MAAMA,WAAW,GAAG,gBAAgB;;AAEpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,cAAc,SAASC,SAAS,CAC7C;AAEI,EAAA,KAAK,GAAGC,cAAc,CAACC,IAAI;AAC3B,EAAA,OAAO,GAAGD,cAAc,CAACE,MAAM;;AAE/B;AACJ;AACA;AACA;AACA;AACIC,EAAAA,WAAWA,CAACC,OAAO,GAAG,EAAE,EACxB;AACI,IAAA,KAAK,EAAE;AACP,IAAA,IAAI,CAACC,SAAS,CAACD,OAAO,CAAC;AAC3B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIC,EAAAA,SAASA,CAACD,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,MAAME,MAAM,GAAGC,eAAe,CAAC,IAAI,CAACC,SAAS,EAAE,EAAEJ,OAAO,EAAEP,WAAW,CAAC;AAEtE,IAAA,IAAI,CAAC,KAAK,GAAGS,MAAM,CAACL,IAAI;AACxB,IAAA,IAAI,CAAC,OAAO,GAAGK,MAAM,CAACJ,MAAM;AAE5B,IAAA,OAAO,IAAI;AACf,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACIM,EAAAA,SAASA,CAACJ,OAAO,GAAG,EAAE,EACtB;AACI,IAAA,OAAOG,eAAe,CAAC;AACnBN,MAAAA,IAAI,EAAE,IAAI,CAAC,KAAK;MAChBC,MAAM,EAAE,IAAI,CAAC;AACjB,KAAC,EAAEE,OAAO,EAAEP,WAAW,CAAC;AAC5B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIY,EAAAA,IAAIA,CAACC,KAAK,EAAEN,OAAO,GAAG,EAAE,EACxB;IACI,OAAOO,uBAAuB,CAACD,KAAK,EAAE,IAAI,CAACF,SAAS,CAACJ,OAAO,CAAC,CAAC;AAClE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIQ,EAAAA,OAAOA,CAACF,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC3B;IACI,OAAOS,0BAA0B,CAACH,KAAK,EAAE,IAAI,CAACF,SAAS,CAACJ,OAAO,CAAC,CAAC;AACrE,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIU,EAAAA,QAAQA,CAACC,SAAS,EAAEX,OAAO,GAAG,EAAE,EAChC;AACI,IAAA,OAAOY,mBAAmB,CAACD,SAAS,EAAEX,OAAO,CAAC;AAClD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACIa,EAAAA,WAAWA,CAACP,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOc,kBAAkB,CAACR,KAAK,EAAEN,OAAO,CAAC;AAC7C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACIe,MAAMA,CAACC,KAAK,EACZ;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOE,sBAAsBA,CAACZ,KAAK,EACnC;IACI,OAAOY,sBAAsB,CAACZ,KAAK,CAAC;AACxC,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOa,IAAIA,CAACb,KAAK,EAAEN,OAAO,GAAG,EAAE,EAC/B;AACI,IAAA,OAAOO,uBAAuB,CAACD,KAAK,EAAEH,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEP,WAAW,CAAC,CAAC;AAChG,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAO2B,OAAOA,CAACd,KAAK,EAAEN,OAAO,GAAG,EAAE,EAClC;AACI,IAAA,OAAOS,0BAA0B,CAACH,KAAK,EAAEH,eAAe,CAACP,cAAc,EAAEI,OAAO,EAAEP,WAAW,CAAC,CAAC;AACnG,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACI,OAAO4B,QAAQA,CAACV,SAAS,EAAEX,OAAO,GAAG,EAAE,EACvC;AACI,IAAA,OAAOY,mBAAmB,CAACD,SAAS,EAAEX,OAAO,CAAC;AAClD,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,OAAOsB,WAAWA,CAAChB,KAAK,EAAEN,OAAO,GAAG,EAAE,EACtC;AACI,IAAA,OAAOc,kBAAkB,CAACR,KAAK,EAAEN,OAAO,CAAC;AAC7C,EAAA;;AAEA;AACJ;AACA;AACA;AACA;AACA;EACI,OAAOuB,MAAMA,CAACP,KAAK,EACnB;IACI,OAAOC,WAAW,CAACD,KAAK,CAAC;AAC7B,EAAA;EAEA,OAAOQ,WAAW,GAAGA,WAAW;EAChC,OAAOC,EAAE,GAAG,OAAO;EACnB,OAAOC,UAAU,GAAGC,MAAM,CAACC,MAAM,CAAC,CAAE,QAAQ,CAAE,CAAC;AAC/C,EAAA,OAAOC,OAAO,GAAGlC,SAAS,CAACmC,aAAa,CAAC;AACrCC,IAAAA,IAAI,EAAE;AAAEC,MAAAA,OAAO,EAAE,IAAI;AAAEC,MAAAA,OAAO,EAAE;AAAK;AACzC,GAAC,CAAC;AACF,EAAA,OAAOC,UAAU,GAAGP,MAAM,CAACC,MAAM,CAAC,EAAE,CAAC;EACrC,OAAOO,cAAc,GAAG,OAAO;AAEnC;;;;"}

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

@@ -133,8 +133,33 @@ class DxbcGlslEmitter {
       // into one array binding frees two texture units on shaders that
       // sit exactly on WebGL2's 16-unit limit.
       detailMapArrayRegisters: [],
+      // Which end of the source clip range is NEAR, and therefore which
+      // form the depth-range fixup takes.
+      //
+      //   "reversed" (default)  z_clip [w, 0]  ->  gl_Position.z = w - 2z
+      //   "forward"             z_clip [0, w]  ->  gl_Position.z = 2z - w
+      //
+      // The default is "reversed" because that is what the shaders this
+      // emitter translates were compiled against, and it is a property of
+      // the INPUT, not a preference of any one consumer. It is stated as
+      // an option rather than hard-coded for two reasons: the assumption
+      // is otherwise invisible in the output, and a future source may not
+      // share it. Deciding it here also means a consumer supplies a
+      // matching projection or gets inverted depth, which is a real
+      // coupling and better declared than implied.
+      //
+      // Switch to "forward" to A/B the convention against a forward-range
+      // projection. Expect an unbiased vertex to look identical either
+      // way - the fixup and the projection compose to the identity - and
+      // only shader-authored depth offsets to change sign. That is the
+      // whole observable difference, and it is what makes the wrong
+      // choice so hard to see.
+      depthRange: "reversed",
       ...options.profile
     };
+    if (this.profile.depthRange !== "reversed" && this.profile.depthRange !== "forward") {
+      throw new TypeError(`DxbcGlslEmitter: depthRange must be "reversed" or "forward", got ${JSON.stringify(this.profile.depthRange)}`);
+    }
   }
 
   /**
@@ -2957,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;
@@ -3003,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, "}");
+  }
 };
 
 /**
@@ -3129,6 +3184,18 @@ DxbcGlslEmitter.prototype._gather4Channel = function _gather4Channel(operand) {
 /**
  * Assembles the final GLSL text.
  */
+/**
+ * The depth-range fixup emitted at the end of a vertex stage, by source range.
+ *
+ * Both entries map their range onto GL NDC [-1, 1] and both compose to the
+ * identity with a projection of the matching form, so an unbiased vertex is
+ * unchanged either way. See `profile.depthRange`.
+ * @type {Object.<string,string>}
+ */
+const DEPTH_RANGE_FIXUP = Object.freeze({
+  reversed: "gl_Position.z = gl_Position.w - 2.0 * gl_Position.z;",
+  forward: "gl_Position.z = 2.0 * gl_Position.z - gl_Position.w;"
+});
 DxbcGlslEmitter.prototype._assemble = function _assemble(state) {
   const lines = ["#version 300 es"];
   if (state.isPixel || state.isCompute) {
@@ -3139,16 +3206,27 @@ DxbcGlslEmitter.prototype._assemble = function _assemble(state) {
   if (helperSource) {
     lines.push("", helperSource);
   }
-  // Vertex stages get the standard DX->GL depth-range fixup: EVE's
-  // projection matrices are D3D-style (z_clip in [0, w]), so the raw
-  // DXBC position would land in GL NDC [0, 1] instead of [-1, 1] —
-  // halving depth precision and breaking every pixel-stage read of
-  // SV_Position.z (gl_FragCoord.z) and depth-encoding technique against
-  // the DX-convention values the shaders were compiled for. Remapping
-  // z after the translated body runs makes depth output, clipping and
-  // gl_FragCoord.z all match D3D semantics exactly. The body is wrapped
-  // in a helper so early `ret` (return) statements cannot skip the
-  // fixup.
+  // Vertex stages get the depth-range fixup that turns a compiled shader's
+  // clip z into GL's. These shaders are compiled against a REVERSED depth
+  // range: z_clip runs [w, 0], near at w and far at 0, and `w - 2z` maps that
+  // onto GL NDC [-1, 1].
+  //
+  // The reversal is observable in the shipped bodies themselves. Surface
+  // decals add a small positive constant to clip z to lift themselves off the
+  // hull they sit on, and a lift is only toward the camera on a reversed
+  // axis.
+  //
+  // The caller MUST supply a reversed-D3D projection. Composed with one, this
+  // is exactly the identity for an unbiased vertex, so the depth buffer keeps
+  // conventional GL values and legacy shaders sharing it are unaffected. What
+  // changes is the direction of any offset the shader authors ITSELF: the
+  // decal family adds `+1e-5` to lift itself off the hull, which is toward
+  // the camera only on a reversed axis. Hand it a forward-D3D projection and
+  // every such offset inverts - decals sink INTO the hull by `2e-5/w`, an
+  // error that grows as the camera closes in.
+  //
+  // The body is wrapped in a helper so early `ret` (return) statements cannot
+  // skip the fixup.
   const writesPosition = [...state.outputNames.values()].includes("gl_Position");
   if (!state.isPixel && !state.isCompute && writesPosition) {
     lines.push("", "void dxbc_main() {");
@@ -3156,7 +3234,7 @@ DxbcGlslEmitter.prototype._assemble = function _assemble(state) {
       lines.push(`    ${early}`);
     }
     lines.push(...state.bodyLines, "}");
-    lines.push("", "void main() {", "    dxbc_main();", "    gl_Position.z = 2.0 * gl_Position.z - gl_Position.w;", "}");
+    lines.push("", "void main() {", "    dxbc_main();", `    ${DEPTH_RANGE_FIXUP[this.profile.depthRange]}`, "}");
     return `${lines.join("\n")}\n`;
   }
   lines.push("", "void main() {");