@carbonenginejs/runtime-resource 0.10.0 → 0.11.0

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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"}

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

@@ -0,0 +1,104 @@
+const CEWG_MAGIC = "CEWG";
+const CEWG_VERSION = 1;
+const textEncoder = new TextEncoder();
+
+/**
+ * Builds CarbonEngineJS CEWG shader package bytes.
+ */
+class CewgPackageBuilder {
+  /**
+  * Builds a CEWG 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 encodedChunks = chunks.map(([tag, value]) => ({
+      tag: normalizeTag(tag),
+      bytes: normalizeChunkValue(value)
+    }));
+    const tags = new Set();
+    for (const chunk of encodedChunks) {
+      if (tags.has(chunk.tag)) {
+        throw new Error(`CEWG package contains duplicate chunk tag ${chunk.tag}`);
+      }
+      tags.add(chunk.tag);
+    }
+    const size = CEWG_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, CEWG_MAGIC);
+    view.setUint32(offset, CEWG_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.
+ * @returns {string} Normalized tag.
+ */
+function normalizeTag(tag) {
+  if (typeof tag !== "string" || tag.length !== 4 || [...tag].some(character => {
+    const code = character.charCodeAt(0);
+    return code < 0x21 || code > 0x7e;
+  })) {
+    throw new Error(`CEWG chunk tag must contain four printable ASCII characters: ${tag}`);
+  }
+  return tag;
+}
+
+/**
+ * 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 CEWG 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 { CewgPackageBuilder };
+//# sourceMappingURL=CewgPackageBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CewgPackageBuilder.js","sources":["../../../../../../src/formats/webgl/core/cewg/CewgPackageBuilder.js"],"sourcesContent":["const CEWG_MAGIC = \"CEWG\";\nconst CEWG_VERSION = 1;\nconst textEncoder = new TextEncoder();\n\n/**\n * Builds CarbonEngineJS CEWG shader package bytes.\n */\nexport class CewgPackageBuilder\n{\n    /**\n   * Builds a CEWG 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 encodedChunks = chunks.map(([ tag, value ]) => ({\n            tag: normalizeTag(tag),\n            bytes: normalizeChunkValue(value)\n        }));\n        const tags = new Set();\n        for (const chunk of encodedChunks)\n        {\n            if (tags.has(chunk.tag))\n            {\n                throw new Error(`CEWG package contains duplicate chunk tag ${chunk.tag}`);\n            }\n            tags.add(chunk.tag);\n        }\n\n        const size = CEWG_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, CEWG_MAGIC);\n        view.setUint32(offset, CEWG_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 * @returns {string} Normalized tag.\n */\nfunction normalizeTag(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(`CEWG chunk tag must contain four printable ASCII characters: ${tag}`);\n    }\n    return tag;\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 CEWG 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":["CEWG_MAGIC","CEWG_VERSION","textEncoder","TextEncoder","CewgPackageBuilder","build","chunks","encodedChunks","map","tag","value","normalizeTag","bytes","normalizeChunkValue","tags","Set","chunk","has","Error","add","size","length","reduce","sum","out","Uint8Array","view","DataView","buffer","byteOffset","byteLength","offset","writeAscii","setUint32","set","some","character","code","charCodeAt","encode","ArrayBuffer","isView","JSON","stringify","i"],"mappings":"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"}

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

@@ -0,0 +1,101 @@
+import { WebglReadError } from '../errors.js';
+
+/**
+ * Returns a byte view for supported binary inputs without copying when possible.
+ *
+ * @param {ArrayBuffer|ArrayBufferView|Uint8Array} value Binary payload to normalize.
+ * @returns {Uint8Array} Byte view over the supplied payload.
+ */
+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 CEWG chunk container.
+ *
+ * Trimmed from Carbon's compiled-effect `WebglReader` (see
+ * `@carbonenginejs/format-dxbc`'s and `@carbonenginejs/format-hlsl`'s vendored
+ * copies): the CEWG format has no string table, so only raw-byte and uint32
+ * reads plus offset/remaining tracking are implemented here.
+ */
+class WebglReader {
+  /**
+  * 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 WebglReadError("Unexpected end of CEWG package data", {
+        source: this.source,
+        offset: this.offset,
+        requested: size,
+        end: this.end
+      });
+    }
+  }
+}
+
+export { WebglReader, asUint8Array };
+//# sourceMappingURL=binary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sources":["../../../../../../src/formats/webgl/core/cewg/binary.js"],"sourcesContent":["import { WebglReadError } from \"../errors.js\";\n\n/**\n * Returns a byte view for supported binary inputs without copying when possible.\n *\n * @param {ArrayBuffer|ArrayBufferView|Uint8Array} value Binary payload to normalize.\n * @returns {Uint8Array} Byte view over the supplied payload.\n */\nexport function asUint8Array(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    throw new TypeError(\"Expected an ArrayBuffer or Uint8Array\");\n}\n\n/**\n * Minimal little-endian binary reader for the flat CEWG chunk container.\n *\n * Trimmed from Carbon's compiled-effect `WebglReader` (see\n * `@carbonenginejs/format-dxbc`'s and `@carbonenginejs/format-hlsl`'s vendored\n * copies): the CEWG format has no string table, so only raw-byte and uint32\n * reads plus offset/remaining tracking are implemented here.\n */\nexport class WebglReader\n{\n    /**\n   * Creates a reader over a byte payload.\n   *\n   * @param {ArrayBuffer|ArrayBufferView|Uint8Array} bytes Source payload.\n   * @param {object} [options] Reader bounds and metadata.\n   * @param {number} [options.offset] Initial byte offset.\n   * @param {number} [options.end] Exclusive end offset.\n   * @param {string} [options.source] Source name used in error details.\n   */\n    constructor(bytes, options = {})\n    {\n        this.bytes = asUint8Array(bytes);\n        this.view = new DataView(this.bytes.buffer, this.bytes.byteOffset, this.bytes.byteLength);\n        this.offset = Number(options.offset) || 0;\n        this.end = Number.isInteger(options.end) ? options.end : this.bytes.length;\n        this.source = options.source || \"memory\";\n    }\n\n    /**\n   * Returns the unread byte count inside the configured reader bounds.\n   *\n   * @returns {number} Remaining bytes.\n   */\n    get remaining()\n    {\n        return this.end - this.offset;\n    }\n\n    /**\n   * Reads a byte range from the payload.\n   *\n   * @param {number} size Byte count to read.\n   * @returns {Uint8Array} View over the read bytes.\n   */\n    readRaw(size)\n    {\n        this._require(size);\n        const start = this.offset;\n        this.offset += size;\n        return this.bytes.subarray(start, start + size);\n    }\n\n    /**\n   * Reads a little-endian unsigned 32-bit integer.\n   *\n   * @returns {number} Integer value.\n   */\n    readUint32()\n    {\n        this._require(4);\n        const value = this.view.getUint32(this.offset, true);\n        this.offset += 4;\n        return value;\n    }\n\n    /**\n   * Ensures the requested read fits inside the configured payload bounds.\n   *\n   * @param {number} size Requested byte count.\n   * @private\n   */\n    _require(size)\n    {\n        if (!Number.isInteger(size) || size < 0 || this.offset + size > this.end)\n        {\n            throw new WebglReadError(\"Unexpected end of CEWG package data\", {\n                source: this.source,\n                offset: this.offset,\n                requested: size,\n                end: this.end\n            });\n        }\n    }\n}\n"],"names":["asUint8Array","value","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","TypeError","WebglReader","constructor","bytes","options","view","DataView","offset","Number","end","isInteger","length","source","remaining","readRaw","size","_require","start","subarray","readUint32","getUint32","WebglReadError","requested"],"mappings":"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"}