@carbonenginejs/runtime-resource 0.9.2 → 0.11.0

package/dist/formats/webgl/CjsWebglFormat.js

@@ -0,0 +1,221 @@
+import { DEFAULT_VALUES, normalizeValues, readWithValues, inspectWithValues, buildPackage, emitGlslWithOptions, toJsonValue, isCewg, OUTPUT_JSON, OUTPUT_RAW } from './core/helpers.js';
+import { buildEffectPackage } from './core/effectPackage.js';
+
+/**
+ * Exposed CarbonEngineJS-facing WebGL format class.
+ *
+ * Keep this file small and reviewable: CEWG container parsing lives under
+ * src/core/cewg (internal parsing machinery, not part of this package's
+ * public surface); the DXBC-to-GLSL ES 3.00 emitter lives under
+ * src/core/glsl; input/option normalization and the shared read/build/emit
+ * paths live in src/core/helpers.js.
+ */
+
+const FORMAT_NAME = "CjsWebglFormat";
+
+/**
+ * CarbonEngineJS-facing format surface for `.cewg` WebGL shader packages, and
+ * a DXBC -> GLSL ES 3.00 emitter for the WebGL2 vertex/pixel/map-style-compute
+ * stages ccpwgl targets.
+ *
+ * The Cjs prefix marks this as a JavaScript format/construction boundary.
+ * CEWG is a CarbonEngineJS-invented container format (flat four-byte-tagged
+ * chunks: `INFO`/`META`/`GLSL`/...), not a Microsoft or CCP one. `Read`
+ * parses a package to plain JSON by default (`emit: "raw"` exposes the live
+ * `CewgPackage` instance instead); `Inspect` is a cheap chunk/shader-count
+ * summary; `Build` assembles package bytes from chunk payloads; `EmitGlsl`
+ * translates one DXBC vertex/pixel/map-style-compute stage to GLSL ES 3.00.
+ */
+class CjsWebglFormat {
+  #emit = DEFAULT_VALUES.emit;
+  #source = DEFAULT_VALUES.source;
+
+  /**
+   * Create a reusable format profile.
+   *
+   * @param {object} [options] Default format values.
+   */
+  constructor(options = {}) {
+    this.SetValues(options);
+  }
+
+  /**
+   * Set format values for this reusable profile.
+   *
+   * @param {object} [options] Values to merge into the profile.
+   * @returns {CjsWebglFormat} This format profile.
+   */
+  SetValues(options = {}) {
+    const values = normalizeValues(this.GetValues(), options, FORMAT_NAME);
+    this.#emit = values.emit;
+    this.#source = values.source;
+    return this;
+  }
+
+  /**
+   * Get this profile's current values, optionally with per-call overrides.
+   *
+   * @param {object} [options] Optional values to merge into a copy.
+   * @returns {object} A copy of the effective values.
+   */
+  GetValues(options = {}) {
+    return normalizeValues({
+      emit: this.#emit,
+      source: this.#source
+    }, options, FORMAT_NAME);
+  }
+
+  /**
+   * Read a CEWG package with this profile's values.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is "raw".
+   */
+  Read(input, options = {}) {
+    return readWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Inspect a CEWG package without building the full JSON shape.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {object} [options] Per-call value overrides.
+   * @returns {object} Plain summary data.
+   */
+  Inspect(input, options = {}) {
+    return inspectWithValues(input, this.GetValues(options));
+  }
+
+  /**
+   * Assembles a CEWG package from ordered chunk payloads.
+   *
+   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
+   * @returns {Uint8Array} Package bytes.
+   */
+  Build(chunks) {
+    return buildPackage(chunks);
+  }
+
+  /**
+   * Translates one DXBC vertex/pixel/map-style-compute stage into GLSL ES 3.00.
+   *
+   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
+   * @param {object} [options] Combined ccpwgl-profile/emit options. See {@link CjsWebglFormat.emitGlsl}.
+   * @returns {object} GLSL text plus the IO contract the packaging layer records.
+   */
+  EmitGlsl(dxbcBytes, options = {}) {
+    return emitGlslWithOptions(dxbcBytes, options);
+  }
+
+  /**
+   * Builds a complete CEWG package from compiled Tr2 effect bytes.
+   *
+   * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
+   * @param {object} [options] Selection, provenance, and emitter policy.
+   * @returns {object} Package bytes plus inspection and qualification records.
+   */
+  BuildEffect(input, options = {}) {
+    return buildEffectPackage(input, options);
+  }
+
+  /**
+   * Instance JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  ToJSON(value) {
+    return toJsonValue(value);
+  }
+
+  /**
+   * Static payload sniff. Static methods use camelCase by convention.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate bytes.
+   * @returns {boolean} True when the payload starts with the CEWG magic.
+   */
+  static isCewg(input) {
+    return isCewg(input);
+  }
+
+  /**
+   * Static one-shot read.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is "raw".
+   */
+  static read(input, options = {}) {
+    return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot inspection.
+   *
+   * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.
+   * @param {object} [options] Format values.
+   * @returns {object} Plain summary data.
+   */
+  static inspect(input, options = {}) {
+    return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));
+  }
+
+  /**
+   * Static one-shot package build.
+   *
+   * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
+   * @returns {Uint8Array} Package bytes.
+   */
+  static build(chunks) {
+    return buildPackage(chunks);
+  }
+
+  /**
+   * Static one-shot DXBC-to-GLSL emission.
+   *
+   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
+   * @param {object} [options] Combined ccpwgl-profile/emit options: `constantBufferStyle`
+   *   (`"array"` (default) uniform `vec4[]` for ccpwgl's uniform4fv path, or `"std140"`),
+   *   `pixelConstantBufferRemap` (default `{ 0: 7 }`, pixel-stage cb slot renames),
+   *   `samplerName(register, stageName)` (naming function), `vertexStructuredCapacity`
+   *   (default 69, bone-array element capacity), `dataTextureWidth` (default 2048),
+   *   `pairVaryings` (per-call varying zero-fill list), `source` (per-call error-detail name).
+   * @returns {object} GLSL text plus the IO contract the packaging layer records.
+   */
+  static emitGlsl(dxbcBytes, options = {}) {
+    return emitGlslWithOptions(dxbcBytes, options);
+  }
+
+  /**
+   * Static whole-effect CEWG builder.
+   *
+   * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
+   * @param {object} [options] Selection, provenance, and emitter policy.
+   * @returns {object} Package bytes plus inspection and qualification records.
+   */
+  static buildEffect(input, options = {}) {
+    return buildEffectPackage(input, options);
+  }
+
+  /**
+   * Static JSON-compatible conversion.
+   *
+   * @param {any} value Format output to convert.
+   * @returns {any} Plain JSON-compatible data.
+   */
+  static toJSON(value) {
+    return toJsonValue(value);
+  }
+  static OUTPUT_JSON = OUTPUT_JSON;
+  static OUTPUT_RAW = OUTPUT_RAW;
+  static type = Object.freeze(["shader"]);
+  static mediaTypes = Object.freeze(["shader"]);
+  static inputTypes = Object.freeze(["cewg"]);
+  static outputTypes = Object.freeze([OUTPUT_JSON]);
+  static debugOutputTypes = Object.freeze([OUTPUT_RAW]);
+  static packageVersion = "0.2.0";
+}
+
+export { CjsWebglFormat, CjsWebglFormat as default };
+//# sourceMappingURL=CjsWebglFormat.js.map

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

@@ -0,0 +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: CEWG container parsing lives under\n * src/core/cewg (internal parsing machinery, not part of this package's\n * public surface); the DXBC-to-GLSL ES 3.00 emitter lives under\n * src/core/glsl; input/option normalization and the shared read/build/emit\n * paths live in src/core/helpers.js.\n */\n\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_JSON,\n    OUTPUT_RAW,\n    buildPackage,\n    emitGlslWithOptions,\n    inspectWithValues,\n    isCewg,\n    normalizeValues,\n    readWithValues,\n    toJsonValue\n} from \"./core/helpers.js\";\nimport { buildEffectPackage } from \"./core/effectPackage.js\";\n\nconst FORMAT_NAME = \"CjsWebglFormat\";\n\n/**\n * CarbonEngineJS-facing format surface for `.cewg` 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.\n * CEWG is a CarbonEngineJS-invented container format (flat four-byte-tagged\n * chunks: `INFO`/`META`/`GLSL`/...), not a Microsoft or CCP one. `Read`\n * parses a package to plain JSON by default (`emit: \"raw\"` exposes the live\n * `CewgPackage` instance instead); `Inspect` is a cheap chunk/shader-count\n * summary; `Build` assembles package bytes from chunk payloads; `EmitGlsl`\n * translates one DXBC vertex/pixel/map-style-compute stage to GLSL ES 3.00.\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     * Read a CEWG package with this profile's values.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is \"raw\".\n     */\n    Read(input, options = {})\n    {\n        return readWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Inspect a CEWG package without building the full JSON shape.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Per-call value overrides.\n     * @returns {object} Plain summary data.\n     */\n    Inspect(input, options = {})\n    {\n        return inspectWithValues(input, this.GetValues(options));\n    }\n\n    /**\n     * Assembles a CEWG package from ordered chunk payloads.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    Build(chunks)\n    {\n        return buildPackage(chunks);\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 CEWG package 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 starts with the CEWG magic.\n     */\n    static isCewg(input)\n    {\n        return isCewg(input);\n    }\n\n    /**\n     * Static one-shot read.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain JSON data, or the raw CewgPackage instance when emit is \"raw\".\n     */\n    static read(input, options = {})\n    {\n        return readWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot inspection.\n     *\n     * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package bytes.\n     * @param {object} [options] Format values.\n     * @returns {object} Plain summary data.\n     */\n    static inspect(input, options = {})\n    {\n        return inspectWithValues(input, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Static one-shot package build.\n     *\n     * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.\n     * @returns {Uint8Array} Package bytes.\n     */\n    static build(chunks)\n    {\n        return buildPackage(chunks);\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 CEWG 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 OUTPUT_RAW = OUTPUT_RAW;\n    static type = Object.freeze([ \"shader\" ]);\n    static mediaTypes = Object.freeze([ \"shader\" ]);\n    static inputTypes = Object.freeze([ \"cewg\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW ]);\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","readWithValues","Inspect","inspectWithValues","Build","chunks","buildPackage","EmitGlsl","dxbcBytes","emitGlslWithOptions","BuildEffect","buildEffectPackage","ToJSON","value","toJsonValue","isCewg","read","inspect","build","emitGlsl","buildEffect","toJSON","OUTPUT_JSON","OUTPUT_RAW","type","Object","freeze","mediaTypes","inputTypes","outputTypes","debugOutputTypes","packageVersion"],"mappings":"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"}

package/dist/formats/webgl/core/cewg/CewgPackage.js

@@ -0,0 +1,339 @@
+import { asUint8Array, WebglReader } from './binary.js';
+import { sha256Bytes } from '../../../../format/effect/sha256.js';
+import { hydrateEffectReflectionForPermutation } from '../../../../format/effect/effectReflectionPackage.js';
+
+const CEWG_MAGIC = "CEWG";
+const CEWG_FORMAT = "CEWG";
+const CEWG_VERSION = 1;
+const textDecoder = new TextDecoder("utf-8", {
+  fatal: false
+});
+const jsonTextDecoder = new TextDecoder("utf-8", {
+  fatal: true
+});
+const validatedEffectReflectionPackages = new WeakSet();
+
+/**
+ * Reader for CarbonEngineJS CEWG shader packages emitted by `hlsl2webgl`.
+ */
+class CewgPackage {
+  /**
+  * Creates an empty package reader.
+  */
+  constructor() {
+    this.version = 0;
+    this.chunks = [];
+    this.chunkMap = new Map();
+    this.jsonCache = new Map();
+    this.reflectionBlobIndex = null;
+    this.readError = null;
+    this.sourcePath = "";
+  }
+
+  /**
+  * Reads a CEWG package from bytes.
+  *
+  * @param {ArrayBuffer|ArrayBufferView|Uint8Array} source CEWG binary bytes.
+  * @param {object} [options] Read options.
+  * @param {string} [options.sourcePath] Source path for diagnostics.
+  * @returns {boolean} True when the package was decoded.
+  */
+  Read(source, options = {}) {
+    validatedEffectReflectionPackages.delete(this);
+    this.version = 0;
+    this.chunks = [];
+    this.chunkMap = new Map();
+    this.jsonCache = new Map();
+    this.reflectionBlobIndex = null;
+    this.readError = null;
+    this.sourcePath = options.sourcePath || "";
+    try {
+      const bytes = asUint8Array(source);
+      const stream = new WebglReader(bytes, {
+        source: this.sourcePath || "CEWG"
+      });
+      const magic = decodeAscii(stream.readRaw(CEWG_MAGIC.length));
+      if (magic !== CEWG_MAGIC) {
+        throw new Error(`Invalid CEWG magic "${magic}"`);
+      }
+      this.version = stream.readUint32();
+      if (this.version !== CEWG_VERSION) {
+        throw new Error(`Unsupported CEWG version ${this.version}`);
+      }
+      const chunkCount = stream.readUint32();
+      for (let index = 0; index < chunkCount; index += 1) {
+        const tag = decodeAscii(stream.readRaw(4));
+        validateChunkTag(tag);
+        if (this.chunkMap.has(tag)) {
+          throw new Error(`CEWG package contains duplicate chunk tag ${tag}`);
+        }
+        const size = stream.readUint32();
+        const offset = stream.offset;
+        const chunkBytes = stream.readRaw(size);
+        const chunk = {
+          tag,
+          size,
+          offset,
+          bytes: chunkBytes
+        };
+        this.chunks.push(chunk);
+        this.chunkMap.set(tag, chunk);
+      }
+      if (stream.remaining !== 0) {
+        throw new Error(`CEWG package has ${stream.remaining} trailing bytes`);
+      }
+      return true;
+    } catch (error) {
+      this.readError = error;
+      this.chunks = [];
+      this.chunkMap = new Map();
+      this.jsonCache = new Map();
+      this.reflectionBlobIndex = null;
+      return false;
+    }
+  }
+
+  /**
+  * Reports whether the package decoded successfully.
+  *
+  * @returns {boolean} True when no read error is present.
+  */
+  IsGood() {
+    return !this.readError && this.version === CEWG_VERSION;
+  }
+
+  /**
+  * Gets a chunk by four-character tag.
+  *
+  * @param {string} tag Chunk tag.
+  * @returns {{tag:string,size:number,offset:number,bytes:Uint8Array}|null} Chunk record.
+  */
+  GetChunk(tag) {
+    return this.chunkMap.get(tag) || null;
+  }
+
+  /**
+  * Decodes a text chunk.
+  *
+  * @param {string} tag Chunk tag.
+  * @returns {string|null} Decoded text, or null when absent.
+  */
+  GetText(tag) {
+    const chunk = this.GetChunk(tag);
+    return chunk ? textDecoder.decode(chunk.bytes) : null;
+  }
+
+  /**
+  * Decodes a JSON chunk.
+  *
+  * @param {string} tag Chunk tag.
+  * @returns {object|null} Parsed JSON, or null when absent.
+  */
+  GetJson(tag) {
+    return cloneJson(getCachedJson(this, tag));
+  }
+
+  /**
+  * Gets translator summary metadata from the `INFO` chunk.
+  *
+  * @returns {object|null} Info JSON.
+  */
+  get info() {
+    return this.GetJson("INFO");
+  }
+
+  /**
+  * Gets caller-provided Carbon metadata from the `META` chunk.
+  *
+  * @returns {object|null} Metadata JSON.
+  */
+  get metadata() {
+    return this.GetJson("META");
+  }
+
+  /**
+   * Gets the complete source permutation graph when present.
+   *
+   * @returns {object|null} Parsed permutation graph.
+   */
+  get permutationGraph() {
+    return this.GetJson("PGRF");
+  }
+
+  /**
+   * Gets complete source effect reflection when present.
+   *
+   * @returns {object|null} Parsed reflection document.
+   */
+  get reflection() {
+    return this.GetJson("RFLX");
+  }
+
+  /**
+   * Gets the raw reflection blob store when present.
+   *
+   * @returns {Uint8Array|null} RBLB bytes.
+   */
+  get reflectionBlobBytes() {
+    return this.GetChunk("RBLB")?.bytes ?? null;
+  }
+
+  /**
+   * Copies one reflected byte payload by blob key or exact reference.
+   *
+   * @param {string|object} value Blob key or exact RFLX byte-reference object.
+   * @returns {Uint8Array|null} Owned payload bytes, or null when unavailable.
+   */
+  GetReflectionBlob(value) {
+    const key = typeof value === "string" ? value : value?.blobKey;
+    if (!this.reflectionBlobIndex) {
+      this.reflectionBlobIndex = new Map((getCachedJson(this, "RFLX")?.blobStore?.blobs ?? []).map(entry => [entry.blobKey, entry]));
+    }
+    const entry = this.reflectionBlobIndex.get(key);
+    const bytes = this.reflectionBlobBytes;
+    if (!entry || !bytes) return null;
+    if (typeof value !== "string" && (!value || value.offset !== entry.offset || value.byteLength !== entry.byteLength || value.sha256 !== entry.sha256)) {
+      return null;
+    }
+    const end = entry.offset + entry.byteLength;
+    if (!Number.isSafeInteger(entry.offset) || entry.offset < 0 || !Number.isSafeInteger(entry.byteLength) || entry.byteLength < 0 || end > bytes.byteLength || sha256Bytes(bytes.subarray(entry.offset, end)) !== entry.sha256) {
+      return null;
+    }
+    return Uint8Array.from(bytes.subarray(entry.offset, end));
+  }
+
+  /**
+   * Gets fully hydrated portable source reflection for one permutation.
+   *
+   * Every reflected byte field is returned as a fresh owned `Uint8Array`.
+   *
+   * @param {number} [permutationIndex] Exact PGRF permutation index.
+   * @returns {object|null} Validated portable reflection, or null when absent.
+   */
+  GetPortableEffectReflection(permutationIndex) {
+    if (!validatedEffectReflectionPackages.has(this)) return null;
+    const reflection = getCachedJson(this, "RFLX");
+    const permutationGraph = getCachedJson(this, "PGRF");
+    if (!reflection || !permutationGraph) return null;
+    const selectedIndex = permutationIndex ?? getCachedJson(this, "INFO")?.defaultPermutationIndex ?? 0;
+    return hydrateEffectReflectionForPermutation(reflection, permutationGraph, selectedIndex, reference => this.GetReflectionBlob(reference));
+  }
+
+  /**
+  * Gets translated GLSL source from the `GLSL` chunk.
+  *
+  * @returns {string|null} GLSL source.
+  */
+  get glsl() {
+    return this.GetText("GLSL");
+  }
+
+  /**
+  * Gets translated GLSL metadata when the `GLSL` chunk contains JSON.
+  *
+  * Whole-effect packages store a JSON stage set in this chunk; single-stage
+  * packages store raw GLSL text and return null here.
+  *
+  * @returns {object|null} Parsed GLSL stage set, or null for raw source.
+  */
+  get glslJson() {
+    try {
+      return this.GetJson("GLSL");
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+  * Gets original DXBC bytes when present.
+  *
+  * @returns {Uint8Array|null} DXBC bytes.
+  */
+  get dxbc() {
+    return this.GetChunk("DXBC")?.bytes || null;
+  }
+
+  /**
+  * Returns a JSON-safe package summary.
+  *
+  * @returns {object} Serializable summary.
+  */
+  toJSON() {
+    return {
+      format: CEWG_FORMAT,
+      version: this.version,
+      sourcePath: this.sourcePath,
+      chunks: this.chunks.map(chunk => ({
+        tag: chunk.tag,
+        size: chunk.size,
+        offset: chunk.offset
+      })),
+      readError: this.readError ? {
+        name: this.readError.name,
+        message: this.readError.message
+      } : null
+    };
+  }
+}
+
+/**
+ * Marks one package as having passed the canonical v3 reflection envelope.
+ *
+ * This is intentionally an internal deep import rather than package-root API.
+ *
+ * @param {CewgPackage} pkg Validated package reader.
+ * @returns {void}
+ */
+function markEffectReflectionValidated(pkg) {
+  validatedEffectReflectionPackages.add(pkg);
+}
+
+/**
+ * Decode and cache one private JSON document.
+ *
+ * @param {CewgPackage} pkg Package reader.
+ * @param {string} tag Chunk tag.
+ * @returns {object|null} Private parsed JSON, or null when absent.
+ */
+function getCachedJson(pkg, tag) {
+  if (!pkg.jsonCache.has(tag)) {
+    const chunk = pkg.GetChunk(tag);
+    pkg.jsonCache.set(tag, chunk ? JSON.parse(jsonTextDecoder.decode(chunk.bytes)) : null);
+  }
+  return pkg.jsonCache.get(tag);
+}
+
+/**
+ * Copy JSON-compatible data without reparsing its source chunk.
+ *
+ * @param {any} value Cached JSON value.
+ * @returns {any} Structurally independent JSON value.
+ */
+function cloneJson(value) {
+  if (Array.isArray(value)) return value.map(cloneJson);
+  if (value && typeof value === "object") {
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, cloneJson(entry)]));
+  }
+  return value;
+}
+function validateChunkTag(tag) {
+  if (typeof tag !== "string" || tag.length !== 4 || [...tag].some(character => {
+    const code = character.charCodeAt(0);
+    return code < 0x21 || code > 0x7e;
+  })) {
+    throw new Error(`Invalid CEWG chunk tag ${JSON.stringify(tag)}`);
+  }
+}
+
+/**
+ * Decodes an ASCII four-character code.
+ *
+ * @param {Uint8Array} bytes Four-byte tag payload.
+ * @returns {string} ASCII string.
+ */
+function decodeAscii(bytes) {
+  return String.fromCharCode(...bytes);
+}
+
+export { CewgPackage, markEffectReflectionValidated };
+//# sourceMappingURL=CewgPackage.js.map

package/dist/formats/webgl/core/cewg/CewgPackage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CewgPackage.js","sources":["../../../../../../src/formats/webgl/core/cewg/CewgPackage.js"],"sourcesContent":["import { WebglReader, asUint8Array } from \"./binary.js\";\nimport { sha256Bytes } from \"../../../../format/effect/sha256.js\";\nimport {\n    hydrateEffectReflectionForPermutation\n} from \"../../../../format/effect/effectReflectionPackage.js\";\n\nconst CEWG_MAGIC = \"CEWG\";\nconst CEWG_FORMAT = \"CEWG\";\nconst CEWG_VERSION = 1;\nconst textDecoder = new TextDecoder(\"utf-8\", { fatal: false });\nconst jsonTextDecoder = new TextDecoder(\"utf-8\", { fatal: true });\nconst validatedEffectReflectionPackages = new WeakSet();\n\n/**\n * Reader for CarbonEngineJS CEWG shader packages emitted by `hlsl2webgl`.\n */\nexport class CewgPackage\n{\n    /**\n   * Creates an empty package reader.\n   */\n    constructor()\n    {\n        this.version = 0;\n        this.chunks = [];\n        this.chunkMap = new Map();\n        this.jsonCache = new Map();\n        this.reflectionBlobIndex = null;\n        this.readError = null;\n        this.sourcePath = \"\";\n    }\n\n    /**\n   * Reads a CEWG package from bytes.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} source CEWG binary bytes.\n   * @param {object} [options] Read options.\n   * @param {string} [options.sourcePath] Source path for diagnostics.\n   * @returns {boolean} True when the package was decoded.\n   */\n    Read(source, options = {})\n    {\n        validatedEffectReflectionPackages.delete(this);\n        this.version = 0;\n        this.chunks = [];\n        this.chunkMap = new Map();\n        this.jsonCache = new Map();\n        this.reflectionBlobIndex = null;\n        this.readError = null;\n        this.sourcePath = options.sourcePath || \"\";\n\n        try\n        {\n            const bytes = asUint8Array(source);\n            const stream = new WebglReader(bytes, { source: this.sourcePath || \"CEWG\" });\n            const magic = decodeAscii(stream.readRaw(CEWG_MAGIC.length));\n            if (magic !== CEWG_MAGIC)\n            {\n                throw new Error(`Invalid CEWG magic \"${magic}\"`);\n            }\n\n            this.version = stream.readUint32();\n            if (this.version !== CEWG_VERSION)\n            {\n                throw new Error(`Unsupported CEWG version ${this.version}`);\n            }\n\n            const chunkCount = stream.readUint32();\n            for (let index = 0; index < chunkCount; index += 1)\n            {\n                const tag = decodeAscii(stream.readRaw(4));\n                validateChunkTag(tag);\n                if (this.chunkMap.has(tag))\n                {\n                    throw new Error(`CEWG package contains duplicate chunk tag ${tag}`);\n                }\n                const size = stream.readUint32();\n                const offset = stream.offset;\n                const chunkBytes = stream.readRaw(size);\n                const chunk = {\n                    tag,\n                    size,\n                    offset,\n                    bytes: chunkBytes\n                };\n                this.chunks.push(chunk);\n                this.chunkMap.set(tag, chunk);\n            }\n\n            if (stream.remaining !== 0)\n            {\n                throw new Error(`CEWG package has ${stream.remaining} trailing bytes`);\n            }\n\n            return true;\n        }\n        catch (error)\n        {\n            this.readError = error;\n            this.chunks = [];\n            this.chunkMap = new Map();\n            this.jsonCache = new Map();\n            this.reflectionBlobIndex = null;\n            return false;\n        }\n    }\n\n    /**\n   * Reports whether the package decoded successfully.\n   *\n   * @returns {boolean} True when no read error is present.\n   */\n    IsGood()\n    {\n        return !this.readError && this.version === CEWG_VERSION;\n    }\n\n    /**\n   * Gets a chunk by four-character tag.\n   *\n   * @param {string} tag Chunk tag.\n   * @returns {{tag:string,size:number,offset:number,bytes:Uint8Array}|null} Chunk record.\n   */\n    GetChunk(tag)\n    {\n        return this.chunkMap.get(tag) || null;\n    }\n\n    /**\n   * Decodes a text chunk.\n   *\n   * @param {string} tag Chunk tag.\n   * @returns {string|null} Decoded text, or null when absent.\n   */\n    GetText(tag)\n    {\n        const chunk = this.GetChunk(tag);\n        return chunk ? textDecoder.decode(chunk.bytes) : null;\n    }\n\n    /**\n   * Decodes a JSON chunk.\n   *\n   * @param {string} tag Chunk tag.\n   * @returns {object|null} Parsed JSON, or null when absent.\n   */\n    GetJson(tag)\n    {\n        return cloneJson(getCachedJson(this, tag));\n    }\n\n    /**\n   * Gets translator summary metadata from the `INFO` chunk.\n   *\n   * @returns {object|null} Info JSON.\n   */\n    get info()\n    {\n        return this.GetJson(\"INFO\");\n    }\n\n    /**\n   * Gets caller-provided Carbon metadata from the `META` chunk.\n   *\n   * @returns {object|null} Metadata JSON.\n   */\n    get metadata()\n    {\n        return this.GetJson(\"META\");\n    }\n\n    /**\n     * Gets the complete source permutation graph when present.\n     *\n     * @returns {object|null} Parsed permutation graph.\n     */\n    get permutationGraph()\n    {\n        return this.GetJson(\"PGRF\");\n    }\n\n    /**\n     * Gets complete source effect reflection when present.\n     *\n     * @returns {object|null} Parsed reflection document.\n     */\n    get reflection()\n    {\n        return this.GetJson(\"RFLX\");\n    }\n\n    /**\n     * Gets the raw reflection blob store when present.\n     *\n     * @returns {Uint8Array|null} RBLB bytes.\n     */\n    get reflectionBlobBytes()\n    {\n        return this.GetChunk(\"RBLB\")?.bytes ?? null;\n    }\n\n    /**\n     * Copies one reflected byte payload by blob key or exact reference.\n     *\n     * @param {string|object} value Blob key or exact RFLX byte-reference object.\n     * @returns {Uint8Array|null} Owned payload bytes, or null when unavailable.\n     */\n    GetReflectionBlob(value)\n    {\n        const key = typeof value === \"string\" ? value : value?.blobKey;\n        if (!this.reflectionBlobIndex)\n        {\n            this.reflectionBlobIndex = new Map(\n                (getCachedJson(this, \"RFLX\")?.blobStore?.blobs ?? []).map((entry) => [\n                    entry.blobKey,\n                    entry\n                ])\n            );\n        }\n        const entry = this.reflectionBlobIndex.get(key);\n        const bytes = this.reflectionBlobBytes;\n        if (!entry || !bytes) return null;\n        if (typeof value !== \"string\"\n            && (!value\n                || value.offset !== entry.offset\n                || value.byteLength !== entry.byteLength\n                || value.sha256 !== entry.sha256))\n        {\n            return null;\n        }\n        const end = entry.offset + entry.byteLength;\n        if (!Number.isSafeInteger(entry.offset) || entry.offset < 0\n            || !Number.isSafeInteger(entry.byteLength) || entry.byteLength < 0\n            || end > bytes.byteLength\n            || sha256Bytes(bytes.subarray(entry.offset, end)) !== entry.sha256)\n        {\n            return null;\n        }\n        return Uint8Array.from(bytes.subarray(entry.offset, end));\n    }\n\n    /**\n     * Gets fully hydrated portable source reflection for one permutation.\n     *\n     * Every reflected byte field is returned as a fresh owned `Uint8Array`.\n     *\n     * @param {number} [permutationIndex] Exact PGRF permutation index.\n     * @returns {object|null} Validated portable reflection, or null when absent.\n     */\n    GetPortableEffectReflection(permutationIndex)\n    {\n        if (!validatedEffectReflectionPackages.has(this)) return null;\n        const reflection = getCachedJson(this, \"RFLX\");\n        const permutationGraph = getCachedJson(this, \"PGRF\");\n        if (!reflection || !permutationGraph) return null;\n        const selectedIndex = permutationIndex\n            ?? getCachedJson(this, \"INFO\")?.defaultPermutationIndex\n            ?? 0;\n        return hydrateEffectReflectionForPermutation(\n            reflection,\n            permutationGraph,\n            selectedIndex,\n            (reference) => this.GetReflectionBlob(reference)\n        );\n    }\n\n    /**\n   * Gets translated GLSL source from the `GLSL` chunk.\n   *\n   * @returns {string|null} GLSL source.\n   */\n    get glsl()\n    {\n        return this.GetText(\"GLSL\");\n    }\n\n    /**\n   * Gets translated GLSL metadata when the `GLSL` chunk contains JSON.\n   *\n   * Whole-effect packages store a JSON stage set in this chunk; single-stage\n   * packages store raw GLSL text and return null here.\n   *\n   * @returns {object|null} Parsed GLSL stage set, or null for raw source.\n   */\n    get glslJson()\n    {\n        try\n        {\n            return this.GetJson(\"GLSL\");\n        }\n        catch\n        {\n            return null;\n        }\n    }\n\n    /**\n   * Gets original DXBC bytes when present.\n   *\n   * @returns {Uint8Array|null} DXBC bytes.\n   */\n    get dxbc()\n    {\n        return this.GetChunk(\"DXBC\")?.bytes || null;\n    }\n\n    /**\n   * Returns a JSON-safe package summary.\n   *\n   * @returns {object} Serializable summary.\n   */\n    toJSON()\n    {\n        return {\n            format: CEWG_FORMAT,\n            version: this.version,\n            sourcePath: this.sourcePath,\n            chunks: this.chunks.map((chunk) => ({\n                tag: chunk.tag,\n                size: chunk.size,\n                offset: chunk.offset\n            })),\n            readError: this.readError ? {\n                name: this.readError.name,\n                message: this.readError.message\n            } : null\n        };\n    }\n}\n\n/**\n * Marks one package as having passed the canonical v3 reflection envelope.\n *\n * This is intentionally an internal deep import rather than package-root API.\n *\n * @param {CewgPackage} pkg Validated package reader.\n * @returns {void}\n */\nexport function markEffectReflectionValidated(pkg)\n{\n    validatedEffectReflectionPackages.add(pkg);\n}\n\n/**\n * Decode and cache one private JSON document.\n *\n * @param {CewgPackage} pkg Package reader.\n * @param {string} tag Chunk tag.\n * @returns {object|null} Private parsed JSON, or null when absent.\n */\nfunction getCachedJson(pkg, tag)\n{\n    if (!pkg.jsonCache.has(tag))\n    {\n        const chunk = pkg.GetChunk(tag);\n        pkg.jsonCache.set(\n            tag,\n            chunk ? JSON.parse(jsonTextDecoder.decode(chunk.bytes)) : null\n        );\n    }\n    return pkg.jsonCache.get(tag);\n}\n\n/**\n * Copy JSON-compatible data without reparsing its source chunk.\n *\n * @param {any} value Cached JSON value.\n * @returns {any} Structurally independent JSON value.\n */\nfunction cloneJson(value)\n{\n    if (Array.isArray(value)) return value.map(cloneJson);\n    if (value && typeof value === \"object\")\n    {\n        return Object.fromEntries(Object.entries(value).map(([ key, entry ]) => [\n            key,\n            cloneJson(entry)\n        ]));\n    }\n    return value;\n}\n\nfunction validateChunkTag(tag)\n{\n    if (typeof tag !== \"string\"\n        || tag.length !== 4\n        || [ ...tag ].some((character) =>\n        {\n            const code = character.charCodeAt(0);\n            return code < 0x21 || code > 0x7e;\n        }))\n    {\n        throw new Error(`Invalid CEWG chunk tag ${JSON.stringify(tag)}`);\n    }\n}\n\n/**\n * Decodes an ASCII four-character code.\n *\n * @param {Uint8Array} bytes Four-byte tag payload.\n * @returns {string} ASCII string.\n */\nfunction decodeAscii(bytes)\n{\n    return String.fromCharCode(...bytes);\n}\n"],"names":["CEWG_MAGIC","CEWG_FORMAT","CEWG_VERSION","textDecoder","TextDecoder","fatal","jsonTextDecoder","validatedEffectReflectionPackages","WeakSet","CewgPackage","constructor","version","chunks","chunkMap","Map","jsonCache","reflectionBlobIndex","readError","sourcePath","Read","source","options","delete","bytes","asUint8Array","stream","WebglReader","magic","decodeAscii","readRaw","length","Error","readUint32","chunkCount","index","tag","validateChunkTag","has","size","offset","chunkBytes","chunk","push","set","remaining","error","IsGood","GetChunk","get","GetText","decode","GetJson","cloneJson","getCachedJson","info","metadata","permutationGraph","reflection","reflectionBlobBytes","GetReflectionBlob","value","key","blobKey","blobStore","blobs","map","entry","byteLength","sha256","end","Number","isSafeInteger","sha256Bytes","subarray","Uint8Array","from","GetPortableEffectReflection","permutationIndex","selectedIndex","defaultPermutationIndex","hydrateEffectReflectionForPermutation","reference","glsl","glslJson","dxbc","toJSON","format","name","message","markEffectReflectionValidated","pkg","add","JSON","parse","Array","isArray","Object","fromEntries","entries","some","character","code","charCodeAt","stringify","String","fromCharCode"],"mappings":"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"}