@carbonenginejs/runtime-resource 0.9.2 → 0.11.0

package/dist/formats/webgpu/core/cewgpu/CewgpuPackage.js

@@ -0,0 +1,415 @@
+import { asUint8Array, WebgpuReader } from './binary.js';
+import { validateCewgpuChunkTag } from './tags.js';
+import { sha256Bytes } from '../../../../format/effect/sha256.js';
+import { hydrateEffectReflectionForPermutation } from '../../../../format/effect/effectReflectionPackage.js';
+
+const validatedEffectPackages = new WeakSet();
+const CEWGPU_MAGIC = "CWGP";
+const CEWGPU_FORMAT = "CEWGPU";
+const CEWGPU_VERSION = 1;
+const textDecoder = new TextDecoder("utf-8", {
+  fatal: false
+});
+const jsonTextDecoder = new TextDecoder("utf-8", {
+  fatal: true
+});
+
+/**
+ * Reader for CarbonEngineJS CEWGPU shader packages.
+ */
+class CewgpuPackage {
+  /**
+  * 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 CEWGPU package from bytes.
+  *
+  * @param {ArrayBuffer|ArrayBufferView|Uint8Array} source CEWGPU 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 = {}) {
+    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 WebgpuReader(bytes, {
+        source: this.sourcePath || "CEWGPU"
+      });
+      const magic = decodeAscii(stream.readRaw(CEWGPU_MAGIC.length));
+      if (magic !== CEWGPU_MAGIC) {
+        throw new Error(`Invalid CEWGPU magic "${magic}"`);
+      }
+      this.version = stream.readUint32();
+      if (this.version !== CEWGPU_VERSION) {
+        throw new Error(`Unsupported CEWGPU version ${this.version}`);
+      }
+      const chunkCount = stream.readUint32();
+      for (let index = 0; index < chunkCount; index += 1) {
+        const tag = decodeAscii(stream.readRaw(4));
+        validateCewgpuChunkTag(tag);
+        if (this.chunkMap.has(tag)) {
+          throw new Error(`CEWGPU 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(`CEWGPU 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 === CEWGPU_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 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.
+   *
+   * A string performs an inventory-key lookup. An object must exactly match
+   * the stored blob key, offset, byte length, and digest.
+   *
+   * @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.
+   *
+   * The optional index defaults to `META.bodyIndex`. 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 (!validatedEffectPackages.has(this)) return null;
+    const reflection = getCachedJson(this, "RFLX");
+    const permutationGraph = getCachedJson(this, "PGRF");
+    if (!reflection || !permutationGraph) return null;
+    const selectedIndex = permutationIndex ?? getCachedJson(this, "META")?.bodyIndex ?? 0;
+    return hydrateEffectReflectionForPermutation(reflection, permutationGraph, selectedIndex, reference => this.GetReflectionBlob(reference));
+  }
+
+  /**
+   * Gets the all-body backend translation graph when present.
+   *
+   * Selected-mode packages do not carry this chunk.
+   *
+   * @returns {object|null} Parsed `CJS_WGSL_BODY_SET` document.
+   */
+  get backendBodySet() {
+    return this.GetJson("WGSB");
+  }
+
+  /**
+   * Resolves the translated backend passes for one permutation index.
+   *
+   * Joins `PGRF` variant identity to the `WGSB` body record and expands every
+   * pass reference into its shared translation unit. Returns null when the
+   * package carries no all-body graph, and an explicitly unsupported record
+   * when that body could not be lowered.
+   *
+   * @param {number} [permutationIndex] Exact PGRF permutation index.
+   * @returns {object|null} Resolved backend body, or null when unavailable.
+   */
+  GetBackendBodyPrograms(permutationIndex) {
+    if (!validatedEffectPackages.has(this)) return null;
+    const bodySet = getCachedJson(this, "WGSB");
+    const permutationGraph = getCachedJson(this, "PGRF");
+    if (!bodySet || !permutationGraph) return null;
+    const index = permutationIndex ?? getCachedJson(this, "META")?.bodyIndex ?? 0;
+    const variant = permutationGraph.variants?.[index];
+    if (!variant) return null;
+    const body = bodySet.bodies?.find(entry => entry.bodyKey === variant.bodyKey);
+    if (!body) return null;
+    if (body.status !== "translated") {
+      return {
+        permutationIndex: index,
+        bodyKey: body.bodyKey,
+        status: body.status,
+        error: body.error,
+        passes: []
+      };
+    }
+    const units = new Map((bodySet.passUnits ?? []).map(unit => [unit.key, unit]));
+    return {
+      permutationIndex: index,
+      bodyKey: body.bodyKey,
+      status: body.status,
+      error: null,
+      passes: body.passes.map(pass => {
+        const unit = units.get(pass.unitKey);
+        if (!unit) {
+          throw new Error(`CEWGPU backend body ${body.bodyKey} references missing translation unit ${pass.unitKey}`);
+        }
+        return {
+          passKey: pass.passKey,
+          unitKey: pass.unitKey,
+          wgslSetVersion: unit.wgslSetVersion,
+          shaders: unit.shaders,
+          layouts: unit.layouts,
+          ...(unit.resourceTransforms ? {
+            resourceTransforms: unit.resourceTransforms
+          } : {})
+        };
+      })
+    };
+  }
+
+  /**
+  * Gets normalized shader analysis from the `ANLS` chunk.
+  *
+  * @returns {string|null} Analysis text.
+  */
+  get analysis() {
+    return this.GetText("ANLS");
+  }
+
+  /**
+  * Gets normalized shader analysis metadata when the `ANLS` chunk contains
+  * JSON.
+  *
+  * @returns {object|null} Parsed analysis, or null for raw text.
+  */
+  get analysisJson() {
+    try {
+      return this.GetJson("ANLS");
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+  * Gets emitted WGSL when present.
+  *
+  * @returns {string|null} WGSL text.
+  */
+  get wgsl() {
+    return this.GetText("WGSL");
+  }
+
+  /**
+  * Gets emitted WGSL metadata when the `WGSL` chunk contains JSON.
+  *
+  * @returns {object|null} Parsed WGSL metadata, or null for raw source.
+  */
+  get wgslJson() {
+    try {
+      return this.GetJson("WGSL");
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+  * Returns a JSON-safe package summary.
+  *
+  * @returns {object} Serializable summary.
+  */
+  toJSON() {
+    return {
+      format: CEWGPU_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
+    };
+  }
+}
+
+/**
+ * Decode and cache one private JSON document.
+ *
+ * @param {CewgpuPackage} 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;
+}
+
+/**
+ * Decodes an ASCII four-character code.
+ *
+ * @param {Uint8Array} bytes Four-byte tag payload.
+ * @returns {string} ASCII string.
+ */
+function decodeAscii(bytes) {
+  return String.fromCharCode(...bytes);
+}
+
+/**
+ * Marks one package as having passed the canonical effect envelope.
+ *
+ * Reflection and backend accessors return null until this runs, so a
+ * hand-assembled or tampered container cannot be hydrated as if it had been
+ * validated. This is intentionally an internal deep import rather than
+ * package-root API.
+ *
+ * @param {CewgpuPackage} pkg Validated package reader.
+ * @returns {void}
+ */
+function markEffectPackageValidated(pkg) {
+  validatedEffectPackages.add(pkg);
+}
+
+export { CewgpuPackage, markEffectPackageValidated };
+//# sourceMappingURL=CewgpuPackage.js.map

package/dist/formats/webgpu/core/cewgpu/CewgpuPackage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CewgpuPackage.js","sources":["../../../../../../src/formats/webgpu/core/cewgpu/CewgpuPackage.js"],"sourcesContent":["import { WebgpuReader, asUint8Array } from \"./binary.js\";\nimport { validateCewgpuChunkTag } from \"./tags.js\";\nimport { sha256Bytes } from \"../../../../format/effect/sha256.js\";\nimport {\n    hydrateEffectReflectionForPermutation\n} from \"../../../../format/effect/effectReflectionPackage.js\";\n\nconst validatedEffectPackages = new WeakSet();\nconst CEWGPU_MAGIC = \"CWGP\";\nconst CEWGPU_FORMAT = \"CEWGPU\";\nconst CEWGPU_VERSION = 1;\nconst textDecoder = new TextDecoder(\"utf-8\", { fatal: false });\nconst jsonTextDecoder = new TextDecoder(\"utf-8\", { fatal: true });\n\n/**\n * Reader for CarbonEngineJS CEWGPU shader packages.\n */\nexport class CewgpuPackage\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 CEWGPU package from bytes.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} source CEWGPU 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        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 WebgpuReader(bytes, { source: this.sourcePath || \"CEWGPU\" });\n            const magic = decodeAscii(stream.readRaw(CEWGPU_MAGIC.length));\n            if (magic !== CEWGPU_MAGIC)\n            {\n                throw new Error(`Invalid CEWGPU magic \"${magic}\"`);\n            }\n\n            this.version = stream.readUint32();\n            if (this.version !== CEWGPU_VERSION)\n            {\n                throw new Error(`Unsupported CEWGPU 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                validateCewgpuChunkTag(tag);\n                if (this.chunkMap.has(tag))\n                {\n                    throw new Error(`CEWGPU 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(`CEWGPU 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 === CEWGPU_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 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     * A string performs an inventory-key lookup. An object must exactly match\n     * the stored blob key, offset, byte length, and digest.\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     * The optional index defaults to `META.bodyIndex`. Every reflected byte\n     * 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(\n        permutationIndex\n    )\n    {\n        if (!validatedEffectPackages.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, \"META\")?.bodyIndex\n            ?? 0;\n        return hydrateEffectReflectionForPermutation(\n            reflection,\n            permutationGraph,\n            selectedIndex,\n            (reference) => this.GetReflectionBlob(reference)\n        );\n    }\n\n    /**\n     * Gets the all-body backend translation graph when present.\n     *\n     * Selected-mode packages do not carry this chunk.\n     *\n     * @returns {object|null} Parsed `CJS_WGSL_BODY_SET` document.\n     */\n    get backendBodySet()\n    {\n        return this.GetJson(\"WGSB\");\n    }\n\n    /**\n     * Resolves the translated backend passes for one permutation index.\n     *\n     * Joins `PGRF` variant identity to the `WGSB` body record and expands every\n     * pass reference into its shared translation unit. Returns null when the\n     * package carries no all-body graph, and an explicitly unsupported record\n     * when that body could not be lowered.\n     *\n     * @param {number} [permutationIndex] Exact PGRF permutation index.\n     * @returns {object|null} Resolved backend body, or null when unavailable.\n     */\n    GetBackendBodyPrograms(permutationIndex)\n    {\n        if (!validatedEffectPackages.has(this)) return null;\n        const bodySet = getCachedJson(this, \"WGSB\");\n        const permutationGraph = getCachedJson(this, \"PGRF\");\n        if (!bodySet || !permutationGraph) return null;\n\n        const index = permutationIndex\n            ?? getCachedJson(this, \"META\")?.bodyIndex\n            ?? 0;\n        const variant = permutationGraph.variants?.[index];\n        if (!variant) return null;\n\n        const body = bodySet.bodies?.find((entry) => entry.bodyKey === variant.bodyKey);\n        if (!body) return null;\n        if (body.status !== \"translated\")\n        {\n            return {\n                permutationIndex: index,\n                bodyKey: body.bodyKey,\n                status: body.status,\n                error: body.error,\n                passes: []\n            };\n        }\n\n        const units = new Map((bodySet.passUnits ?? []).map((unit) => [ unit.key, unit ]));\n\n        return {\n            permutationIndex: index,\n            bodyKey: body.bodyKey,\n            status: body.status,\n            error: null,\n            passes: body.passes.map((pass) =>\n            {\n                const unit = units.get(pass.unitKey);\n                if (!unit)\n                {\n                    throw new Error(\n                        `CEWGPU backend body ${body.bodyKey} references missing translation unit ${pass.unitKey}`\n                    );\n                }\n                return {\n                    passKey: pass.passKey,\n                    unitKey: pass.unitKey,\n                    wgslSetVersion: unit.wgslSetVersion,\n                    shaders: unit.shaders,\n                    layouts: unit.layouts,\n                    ...(unit.resourceTransforms\n                        ? { resourceTransforms: unit.resourceTransforms }\n                        : {})\n                };\n            })\n        };\n    }\n\n    /**\n   * Gets normalized shader analysis from the `ANLS` chunk.\n   *\n   * @returns {string|null} Analysis text.\n   */\n    get analysis()\n    {\n        return this.GetText(\"ANLS\");\n    }\n\n    /**\n   * Gets normalized shader analysis metadata when the `ANLS` chunk contains\n   * JSON.\n   *\n   * @returns {object|null} Parsed analysis, or null for raw text.\n   */\n    get analysisJson()\n    {\n        try\n        {\n            return this.GetJson(\"ANLS\");\n        }\n        catch\n        {\n            return null;\n        }\n    }\n\n    /**\n   * Gets emitted WGSL when present.\n   *\n   * @returns {string|null} WGSL text.\n   */\n    get wgsl()\n    {\n        return this.GetText(\"WGSL\");\n    }\n\n    /**\n   * Gets emitted WGSL metadata when the `WGSL` chunk contains JSON.\n   *\n   * @returns {object|null} Parsed WGSL metadata, or null for raw source.\n   */\n    get wgslJson()\n    {\n        try\n        {\n            return this.GetJson(\"WGSL\");\n        }\n        catch\n        {\n            return null;\n        }\n    }\n\n    /**\n   * Returns a JSON-safe package summary.\n   *\n   * @returns {object} Serializable summary.\n   */\n    toJSON()\n    {\n        return {\n            format: CEWGPU_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 * Decode and cache one private JSON document.\n *\n * @param {CewgpuPackage} 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\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\n/**\n * Marks one package as having passed the canonical effect envelope.\n *\n * Reflection and backend accessors return null until this runs, so a\n * hand-assembled or tampered container cannot be hydrated as if it had been\n * validated. This is intentionally an internal deep import rather than\n * package-root API.\n *\n * @param {CewgpuPackage} pkg Validated package reader.\n * @returns {void}\n */\nexport function markEffectPackageValidated(pkg)\n{\n    validatedEffectPackages.add(pkg);\n}\n"],"names":["validatedEffectPackages","WeakSet","CEWGPU_MAGIC","CEWGPU_FORMAT","CEWGPU_VERSION","textDecoder","TextDecoder","fatal","jsonTextDecoder","CewgpuPackage","constructor","version","chunks","chunkMap","Map","jsonCache","reflectionBlobIndex","readError","sourcePath","Read","source","options","bytes","asUint8Array","stream","WebgpuReader","magic","decodeAscii","readRaw","length","Error","readUint32","chunkCount","index","tag","validateCewgpuChunkTag","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","bodyIndex","hydrateEffectReflectionForPermutation","reference","backendBodySet","GetBackendBodyPrograms","bodySet","variant","variants","body","bodies","find","bodyKey","status","passes","units","passUnits","unit","pass","unitKey","passKey","wgslSetVersion","shaders","layouts","resourceTransforms","analysis","analysisJson","wgsl","wgslJson","toJSON","format","name","message","pkg","JSON","parse","Array","isArray","Object","fromEntries","entries","String","fromCharCode","markEffectPackageValidated","add"],"mappings":"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"}

package/dist/formats/webgpu/core/cewgpu/CewgpuPackageBuilder.js

@@ -0,0 +1,100 @@
+import { validateCewgpuChunkTag } from './tags.js';
+
+const CEWGPU_MAGIC = "CWGP";
+const CEWGPU_VERSION = 1;
+const textEncoder = new TextEncoder();
+
+/**
+ * Builds CarbonEngineJS CEWGPU package bytes.
+ */
+class CewgpuPackageBuilder {
+  /**
+  * Builds a CEWGPU v1 package from ordered chunks.
+  *
+  * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
+  * @returns {Uint8Array} Package bytes.
+  */
+  static build(chunks) {
+    const tags = new Set();
+    const encodedChunks = chunks.map(([tag, value]) => ({
+      tag: normalizeTag(tag, tags),
+      bytes: normalizeChunkValue(value)
+    }));
+    const size = CEWGPU_MAGIC.length + 8 + encodedChunks.reduce((sum, chunk) => sum + 8 + chunk.bytes.length, 0);
+    const out = new Uint8Array(size);
+    const view = new DataView(out.buffer, out.byteOffset, out.byteLength);
+    let offset = 0;
+    offset = writeAscii(out, offset, CEWGPU_MAGIC);
+    view.setUint32(offset, CEWGPU_VERSION, true);
+    offset += 4;
+    view.setUint32(offset, encodedChunks.length, true);
+    offset += 4;
+    for (const chunk of encodedChunks) {
+      offset = writeAscii(out, offset, chunk.tag);
+      view.setUint32(offset, chunk.bytes.length, true);
+      offset += 4;
+      out.set(chunk.bytes, offset);
+      offset += chunk.bytes.length;
+    }
+    return out;
+  }
+}
+
+/**
+ * Normalizes a package chunk tag.
+ *
+ * @param {string} tag Four-character chunk tag.
+ * @param {Set<string>} tags Tags already present in the package.
+ * @returns {string} Normalized tag.
+ */
+function normalizeTag(tag, tags) {
+  const normalized = validateCewgpuChunkTag(tag);
+  if (tags.has(normalized)) {
+    throw new Error(`CEWGPU package contains duplicate chunk tag ${normalized}`);
+  }
+  tags.add(normalized);
+  return normalized;
+}
+
+/**
+ * Normalizes a package chunk payload.
+ *
+ * @param {string|object|Uint8Array|ArrayBuffer|ArrayBufferView} value Chunk payload.
+ * @returns {Uint8Array} Payload bytes.
+ */
+function normalizeChunkValue(value) {
+  if (typeof value === "string") {
+    return textEncoder.encode(value);
+  }
+  if (value instanceof Uint8Array) {
+    return value;
+  }
+  if (value instanceof ArrayBuffer) {
+    return new Uint8Array(value);
+  }
+  if (ArrayBuffer.isView(value)) {
+    return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+  }
+  if (value && typeof value === "object") {
+    return textEncoder.encode(`${JSON.stringify(value)}\n`);
+  }
+  throw new Error("Unsupported CEWGPU chunk value");
+}
+
+/**
+ * Writes ASCII text into a byte buffer.
+ *
+ * @param {Uint8Array} out Output buffer.
+ * @param {number} offset Current byte offset.
+ * @param {string} value ASCII text.
+ * @returns {number} Updated byte offset.
+ */
+function writeAscii(out, offset, value) {
+  for (let i = 0; i < value.length; i += 1) {
+    out[offset + i] = value.charCodeAt(i) & 0xff;
+  }
+  return offset + value.length;
+}
+
+export { CewgpuPackageBuilder };
+//# sourceMappingURL=CewgpuPackageBuilder.js.map

package/dist/formats/webgpu/core/cewgpu/CewgpuPackageBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CewgpuPackageBuilder.js","sources":["../../../../../../src/formats/webgpu/core/cewgpu/CewgpuPackageBuilder.js"],"sourcesContent":["import { validateCewgpuChunkTag } from \"./tags.js\";\n\nconst CEWGPU_MAGIC = \"CWGP\";\nconst CEWGPU_VERSION = 1;\nconst textEncoder = new TextEncoder();\n\n/**\n * Builds CarbonEngineJS CEWGPU package bytes.\n */\nexport class CewgpuPackageBuilder\n{\n    /**\n   * Builds a CEWGPU v1 package from ordered chunks.\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        const tags = new Set();\n        const encodedChunks = chunks.map(([ tag, value ]) => ({\n            tag: normalizeTag(tag, tags),\n            bytes: normalizeChunkValue(value)\n        }));\n\n        const size = CEWGPU_MAGIC.length + 8 + encodedChunks.reduce((sum, chunk) => sum + 8 + chunk.bytes.length, 0);\n        const out = new Uint8Array(size);\n        const view = new DataView(out.buffer, out.byteOffset, out.byteLength);\n        let offset = 0;\n\n        offset = writeAscii(out, offset, CEWGPU_MAGIC);\n        view.setUint32(offset, CEWGPU_VERSION, true);\n        offset += 4;\n        view.setUint32(offset, encodedChunks.length, true);\n        offset += 4;\n\n        for (const chunk of encodedChunks)\n        {\n            offset = writeAscii(out, offset, chunk.tag);\n            view.setUint32(offset, chunk.bytes.length, true);\n            offset += 4;\n            out.set(chunk.bytes, offset);\n            offset += chunk.bytes.length;\n        }\n\n        return out;\n    }\n}\n\n/**\n * Normalizes a package chunk tag.\n *\n * @param {string} tag Four-character chunk tag.\n * @param {Set<string>} tags Tags already present in the package.\n * @returns {string} Normalized tag.\n */\nfunction normalizeTag(tag, tags)\n{\n    const normalized = validateCewgpuChunkTag(tag);\n    if (tags.has(normalized))\n    {\n        throw new Error(`CEWGPU package contains duplicate chunk tag ${normalized}`);\n    }\n    tags.add(normalized);\n    return normalized;\n}\n\n/**\n * Normalizes a package chunk payload.\n *\n * @param {string|object|Uint8Array|ArrayBuffer|ArrayBufferView} value Chunk payload.\n * @returns {Uint8Array} Payload bytes.\n */\nfunction normalizeChunkValue(value)\n{\n    if (typeof value === \"string\")\n    {\n        return textEncoder.encode(value);\n    }\n    if (value instanceof Uint8Array)\n    {\n        return value;\n    }\n    if (value instanceof ArrayBuffer)\n    {\n        return new Uint8Array(value);\n    }\n    if (ArrayBuffer.isView(value))\n    {\n        return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);\n    }\n    if (value && typeof value === \"object\")\n    {\n        return textEncoder.encode(`${JSON.stringify(value)}\\n`);\n    }\n    throw new Error(\"Unsupported CEWGPU chunk value\");\n}\n\n/**\n * Writes ASCII text into a byte buffer.\n *\n * @param {Uint8Array} out Output buffer.\n * @param {number} offset Current byte offset.\n * @param {string} value ASCII text.\n * @returns {number} Updated byte offset.\n */\nfunction writeAscii(out, offset, value)\n{\n    for (let i = 0; i < value.length; i += 1)\n    {\n        out[offset + i] = value.charCodeAt(i) & 0xff;\n    }\n    return offset + value.length;\n}\n"],"names":["CEWGPU_MAGIC","CEWGPU_VERSION","textEncoder","TextEncoder","CewgpuPackageBuilder","build","chunks","tags","Set","encodedChunks","map","tag","value","normalizeTag","bytes","normalizeChunkValue","size","length","reduce","sum","chunk","out","Uint8Array","view","DataView","buffer","byteOffset","byteLength","offset","writeAscii","setUint32","set","normalized","validateCewgpuChunkTag","has","Error","add","encode","ArrayBuffer","isView","JSON","stringify","i","charCodeAt"],"mappings":"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"}

package/dist/formats/webgpu/core/cewgpu/binary.js

@@ -0,0 +1,93 @@
+import { WebgpuReadError } from '../errors.js';
+
+/**
+ * Returns a byte view for supported binary inputs without copying when
+ * possible.
+ *
+ * @param {ArrayBuffer|ArrayBufferView|Uint8Array} value Binary payload.
+ * @returns {Uint8Array} Normalized byte view.
+ */
+function asUint8Array(value) {
+  if (value instanceof Uint8Array) return value;
+  if (value instanceof ArrayBuffer) return new Uint8Array(value);
+  if (ArrayBuffer.isView(value)) {
+    return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
+  }
+  throw new TypeError("Expected an ArrayBuffer or Uint8Array");
+}
+
+/**
+ * Minimal little-endian binary reader for the flat CEWGPU chunk container.
+ */
+class WebgpuReader {
+  /**
+  * Creates a reader over a byte payload.
+  *
+  * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.
+  * @param {object} [options] Reader bounds and metadata.
+  * @param {number} [options.offset] Initial byte offset.
+  * @param {number} [options.end] Exclusive end offset.
+  * @param {string} [options.source] Source name used in error details.
+  */
+  constructor(bytes, options = {}) {
+    this.bytes = asUint8Array(bytes);
+    this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);
+    this.offset = Number(options.offset) || 0;
+    this.end = Number.isInteger(options.end) ? options.end : this.bytes.length;
+    this.source = options.source || "memory";
+  }
+
+  /**
+  * Returns the unread byte count inside the configured reader bounds.
+  *
+  * @returns {number} Remaining bytes.
+  */
+  get remaining() {
+    return this.end - this.offset;
+  }
+
+  /**
+  * Reads a byte range from the payload.
+  *
+  * @param {number} size Byte count to read.
+  * @returns {Uint8Array} View over the read bytes.
+  */
+  readRaw(size) {
+    this._require(size);
+    const start = this.offset;
+    this.offset += size;
+    return this.bytes.subarray(start, start + size);
+  }
+
+  /**
+  * Reads a little-endian unsigned 32-bit integer.
+  *
+  * @returns {number} Integer value.
+  */
+  readUint32() {
+    this._require(4);
+    const value = this.view.getUint32(this.offset, true);
+    this.offset += 4;
+    return value;
+  }
+
+  /**
+  * Ensures the requested read fits inside the configured payload bounds.
+  *
+  * @param {number} size Requested byte count.
+  * @private
+  */
+  _require(size) {
+    if (!Number.isInteger(size) || size < 0 || this.offset + size > this.end) {
+      throw new WebgpuReadError("Unexpected end of CEWGPU package data", {
+        source: this.source,
+        offset: this.offset,
+        requested: size,
+        end: this.end
+      });
+    }
+  }
+}
+
+export { WebgpuReader, asUint8Array };
+//# sourceMappingURL=binary.js.map