@carbonenginejs/runtime-resource 0.12.1 → 0.13.0

package/dist/formats/webgl/core/helpers.js

@@ -1,306 +1,167 @@
-import { CewgPackage } from './cewg/CewgPackage.js';
-import { CewgPackageBuilder } from './cewg/CewgPackageBuilder.js';
-import { DxbcGlslEmitter } from './glsl/DxbcGlslEmitter.js';
-import { WebglReadError } from './errors.js';
-import { validateEffectPackageEnvelope } from './effectPackageValidation.js';
-
-/**
- * Internal read-pipeline glue for CjsWebglFormat.
- *
- * Keeps the public class file small: input/option normalization, the shared
- * CEWG package read path used by both the instance and the static one-shots,
- * package construction, DXBC-to-GLSL emission, and JSON conversion all live
- * here. The CEWG container parser lives under src/core/cewg (internal parsing
- * machinery, not part of this package's public surface); the GLSL emitter
- * lives under src/core/glsl.
- */
-
-const OUTPUT_JSON = "json";
-const OUTPUT_RAW = "raw";
-const CEWG_MAGIC = "CEWG";
-const CEWG_FORMAT = "CEWG";
-const DEFAULT_VALUES = Object.freeze({
-  emit: OUTPUT_JSON,
-  source: "memory"
-});
-const VALID_EMITS = new Set([OUTPUT_JSON, OUTPUT_RAW]);
-const OPTION_KEYS = new Set(["emit", "source"]);
-
-/**
- * Merge format values over a base set and validate them.
- *
- * @param {object} base Current values.
- * @param {object} [options] Values to merge in.
- * @param {string} [readerName] Reader name used in error messages.
- * @returns {object} A validated copy of the merged values.
- */
-function normalizeValues(base, options = {}, readerName = "CjsWebglFormat") {
-  if (!options || typeof options !== "object") {
-    throw new TypeError(`${readerName}: options must be an object`);
-  }
-  for (const key of Object.keys(options)) {
-    if (!OPTION_KEYS.has(key)) {
-      throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
-    }
-  }
-  const values = {
-    ...base,
-    ...options
-  };
-  if (!VALID_EMITS.has(values.emit)) {
-    throw new TypeError(`${readerName}: emit must be "${OUTPUT_JSON}" or "${OUTPUT_RAW}", got ${JSON.stringify(values.emit)}`);
-  }
-  if (typeof values.source !== "string" || !values.source) {
-    values.source = DEFAULT_VALUES.source;
-  }
-  return {
-    emit: values.emit,
-    source: values.source
-  };
-}
-
-/**
- * Normalize caller input into a Uint8Array of package/DXBC bytes.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
- * @returns {Uint8Array} The payload bytes.
- */
-function toBytes(input) {
-  if (input instanceof Uint8Array) return input;
-  if (typeof ArrayBuffer !== "undefined" && input instanceof ArrayBuffer) return new Uint8Array(input);
-  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
-  throw new TypeError("CjsWebglFormat: input must be CEWG package bytes (Uint8Array, Buffer, DataView or ArrayBuffer)");
-}
-
-/**
- * Sniffs whether a payload starts with the CEWG container magic.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
- * @returns {boolean} True when the payload looks like a CEWG package.
- */
-function isCewg(input) {
-  try {
-    const bytes = toBytes(input);
-    return bytes.length >= CEWG_MAGIC.length && CEWG_MAGIC.split("").every((char, index) => bytes[index] === char.charCodeAt(0));
-  } catch {
-    return false;
-  }
-}
-
-/**
- * The shared read path used by the instance Read/Inspect and the static
- * one-shots: normalizes input bytes and loads a CewgPackage.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package payload.
- * @param {object} values Normalized format values.
- * @returns {CewgPackage} The loaded package.
- */
-function readRaw(input, values) {
-  const bytes = toBytes(input);
-  const pkg = new CewgPackage();
-  const ok = pkg.Read(bytes, {
-    sourcePath: values.source
-  });
-  if (!ok) {
-    throw new WebglReadError(pkg.readError ? pkg.readError.message : "Failed to read CEWG package", {
-      source: values.source,
-      cause: pkg.readError || null
-    });
-  }
-  try {
-    validateEffectPackageEnvelope(pkg);
-  } catch (error) {
-    throw new WebglReadError(error.message, {
-      source: values.source,
-      cause: error
-    });
-  }
-  return pkg;
-}
-
-/**
- * Reads the `GLSL` chunk's shader records, when present.
- *
- * @param {CewgPackage} pkg Loaded package.
- * @returns {object[]} Shader records, or an empty array when absent.
- */
-function glslShaders(pkg) {
-  const glslJson = pkg.glslJson;
-  return Array.isArray(glslJson?.shaders) ? glslJson.shaders : [];
-}
-
-/**
- * Reads the `GLSL` chunk's stage records, when present.
- *
- * @param {CewgPackage} pkg Loaded package.
- * @returns {object[]} Stage records, or an empty array when absent.
- */
-function glslStages(pkg) {
-  const glslJson = pkg.glslJson;
-  return Array.isArray(glslJson?.stages) ? glslJson.stages : [];
-}
-
-/**
- * Converts a loaded package to the documented plain JSON shape.
- *
- * @param {CewgPackage} pkg Loaded package.
- * @returns {object} Plain JSON data.
- */
-function packageToJson(pkg) {
-  return toJsonValue({
-    format: CEWG_FORMAT,
-    version: pkg.version,
-    sourcePath: pkg.sourcePath,
-    chunks: pkg.chunks.map(({
-      tag,
-      size,
-      offset
-    }) => ({
-      tag,
-      size,
-      offset
-    })),
-    info: pkg.info,
-    metadata: pkg.metadata,
-    permutationGraph: pkg.permutationGraph,
-    reflection: pkg.reflection,
-    reflectionBlobByteLength: pkg.reflectionBlobBytes?.byteLength ?? 0,
-    glsl: pkg.glslJson !== null ? pkg.glslJson : pkg.glsl,
-    shaders: glslShaders(pkg)
-  });
-}
-
-/**
- * Shared read entry honouring the emit mode.
- *
- * `emit: "raw"` returns the live CewgPackage instance — internal, unstable,
- * not schema-guaranteed. `emit: "json"` (the default) returns the documented
- * plain-data package shape: parsed INFO/META/GLSL chunks plus a flat shader
- * record list.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package payload.
- * @param {object} values Normalized format values.
- * @returns {CewgPackage|object} The raw package instance, or the documented JSON shape.
- */
-function readWithValues(input, values) {
-  const pkg = readRaw(input, values);
-  return values.emit === OUTPUT_RAW ? pkg : packageToJson(pkg);
-}
-
-/**
- * Cheap inspection: version, chunk tags/sizes, and GLSL shader/stage counts,
- * without building the full JSON package shape.
- *
- * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package payload.
- * @param {object} values Normalized format values.
- * @returns {object} Plain summary data.
- */
-function inspectWithValues(input, values) {
-  const pkg = readRaw(input, values);
-  const info = pkg.info;
-  const permutationGraph = pkg.permutationGraph;
-  return {
-    source: values.source,
-    isCewg: true,
-    version: pkg.version,
-    chunks: pkg.chunks.map(({
-      tag,
-      size,
-      offset
-    }) => ({
-      tag,
-      size,
-      offset
-    })),
-    shaderCount: glslShaders(pkg).length,
-    stageCount: glslStages(pkg).length,
-    permutationCount: permutationGraph?.variants?.length ?? 0,
-    uniqueBodyCount: permutationGraph?.bodies?.length ?? 0,
-    reflectionBodyCount: info?.effectReflection?.bodyCount ?? 0,
-    reflectionSourceProgramCount: info?.effectReflection?.sourceProgramCount ?? 0,
-    reflectionBlobCount: info?.effectReflection?.blobCount ?? 0,
-    reflectionBlobByteLength: info?.effectReflection?.blobByteLength ?? 0
-  };
-}
-
-/**
- * Assembles a CEWG package from ordered chunk payloads.
- *
- * @param {Array<[string, string|object|Uint8Array|ArrayBuffer|ArrayBufferView]>} chunks Ordered package chunks.
- * @returns {Uint8Array} Package bytes.
- */
-function buildPackage(chunks) {
-  return CewgPackageBuilder.build(chunks);
-}
-const EMIT_GLSL_OPTION_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "lightConstantBuffer", "lightPackedTexture", "pairVaryings", "source"]);
-const EMIT_GLSL_PROFILE_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "lightConstantBuffer", "lightPackedTexture"]);
-
-/**
- * Translates one DXBC stage into GLSL ES 3.00 source, sharing one core path
- * between `CjsWebglFormat.emitGlsl` (static) and `EmitGlsl` (instance).
- *
- * `options` is a flat bag combining the emitter's ccpwgl-profile constructor
- * bits (`constantBufferStyle`, `pixelConstantBufferRemap`, `samplerName`,
- * `vertexStructuredCapacity`, `dataTextureWidth`) with its per-call Emit
- * options (`pairVaryings`, `source`); omitted keys keep the emitter's
- * existing defaults exactly.
- *
- * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
- * @param {object} [options] Combined profile/emit options.
- * @returns {{source:string,stageName:string,inputs:object[],outputs:object[],bindings:object[],warnings:string[],computeFragment:(object|undefined)}}
- *   GLSL text plus the IO contract the packaging layer records; compute
- *   stages add the emitter's `computeFragment` host contract.
- */
-function emitGlslWithOptions(dxbcBytes, options = {}) {
-  if (!options || typeof options !== "object") {
-    throw new TypeError("CjsWebglFormat: emitGlsl options must be an object");
-  }
-  for (const key of Object.keys(options)) {
-    if (!EMIT_GLSL_OPTION_KEYS.has(key)) {
-      throw new TypeError(`CjsWebglFormat: unknown emitGlsl option ${JSON.stringify(key)}`);
-    }
-  }
-  const profile = {};
-  for (const key of EMIT_GLSL_PROFILE_KEYS) {
-    if (Object.prototype.hasOwnProperty.call(options, key)) profile[key] = options[key];
-  }
-  const emitter = new DxbcGlslEmitter({
-    profile
-  });
-  return emitter.Emit(dxbcBytes, {
-    source: options.source,
-    pairVaryings: options.pairVaryings
-  });
-}
-
-/**
- * Deep-convert a value to plain JSON-compatible data. Typed arrays become
- * plain number arrays; Maps/Sets become objects/arrays; class instances
- * with toJSON are honoured.
- *
- * @param {any} value Value to convert.
- * @returns {any} Plain data.
- */
-function toJsonValue(value) {
-  if (value === null || value === undefined) return value ?? null;
-  if (typeof value === "number" || typeof value === "string" || typeof value === "boolean") return value;
-  if (typeof value === "bigint") return value.toString();
-  if (ArrayBuffer.isView(value)) return Array.from(value);
-  if (Array.isArray(value)) return value.map(toJsonValue);
-  if (value instanceof Map) {
-    const out = {};
-    for (const [key, entry] of value) out[key] = toJsonValue(entry);
-    return out;
-  }
-  if (value instanceof Set) return Array.from(value, toJsonValue);
-  if (typeof value === "object") {
-    if (typeof value.toJSON === "function") return toJsonValue(value.toJSON());
-    const out = {};
-    for (const key of Object.keys(value)) out[key] = toJsonValue(value[key]);
-    return out;
-  }
-  return null;
-}
-
-export { CEWG_FORMAT, CEWG_MAGIC, DEFAULT_VALUES, OUTPUT_JSON, OUTPUT_RAW, WebglReadError, buildPackage, emitGlslWithOptions, inspectWithValues, isCewg, normalizeValues, packageToJson, readRaw, readWithValues, toBytes, toJsonValue };
-//# sourceMappingURL=helpers.js.map
+import { DxbcGlslEmitter } from './glsl/DxbcGlslEmitter.js';
+import { applyPackedLightFixups } from './glsl/packedLightFixups.js';
+import { looksLikeCarbonEffectContainer } from '../../../format/carbonEffect/CjsCarbonEffectReader.js';
+
+/**
+ * Internal glue for CjsWebglFormat.
+ *
+ * Keeps the public class file small: input/option normalization, DXBC-to-GLSL
+ * emission, and JSON conversion live here. Reading an effect is
+ * `readGlslEffectContainer` and summarising one is `inspectGlslEffectContainer`;
+ * neither needs glue, so neither is wrapped here. The GLSL emitter lives under
+ * src/formats/webgl/core/glsl.
+ */
+
+const OUTPUT_JSON = "json";
+const DEFAULT_VALUES = Object.freeze({
+  emit: OUTPUT_JSON,
+  source: "memory"
+});
+const VALID_EMITS = new Set([OUTPUT_JSON]);
+const OPTION_KEYS = new Set(["emit", "source"]);
+
+/**
+ * Merge format values over a base set and validate them.
+ *
+ * @param {object} base Current values.
+ * @param {object} [options] Values to merge in.
+ * @param {string} [readerName] Reader name used in error messages.
+ * @returns {object} A validated copy of the merged values.
+ */
+function normalizeValues(base, options = {}, readerName = "CjsWebglFormat") {
+  if (!options || typeof options !== "object") {
+    throw new TypeError(`${readerName}: options must be an object`);
+  }
+  for (const key of Object.keys(options)) {
+    if (!OPTION_KEYS.has(key)) {
+      throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);
+    }
+  }
+  const values = {
+    ...base,
+    ...options
+  };
+  if (!VALID_EMITS.has(values.emit)) {
+    throw new TypeError(`${readerName}: emit must be "${OUTPUT_JSON}", got ${JSON.stringify(values.emit)}`);
+  }
+  if (typeof values.source !== "string" || !values.source) {
+    values.source = DEFAULT_VALUES.source;
+  }
+  return {
+    emit: values.emit,
+    source: values.source
+  };
+}
+
+/**
+ * Normalize caller input into a Uint8Array of package/DXBC bytes.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
+ * @returns {Uint8Array} The payload bytes.
+ */
+function toBytes(input) {
+  if (input instanceof Uint8Array) return input;
+  if (typeof ArrayBuffer !== "undefined" && input instanceof ArrayBuffer) return new Uint8Array(input);
+  if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);
+  throw new TypeError("CjsWebglFormat: input must be effect container bytes (Uint8Array, Buffer, DataView or ArrayBuffer)");
+}
+
+/**
+ * Reports whether a payload has the Carbon effect container shape.
+ *
+ * A shape check, not an identity check: our files are stock Carbon containers,
+ * so nothing in the bytes distinguishes a WebGL one from a shipped
+ * `effect.dx11`. Identity comes from the path the file was resolved through.
+ *
+ * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.
+ * @returns {boolean} True when the payload has the container shape.
+ */
+function isWebglEffectContainer(input) {
+  try {
+    return looksLikeCarbonEffectContainer(toBytes(input));
+  } catch {
+    return false;
+  }
+}
+const EMIT_GLSL_OPTION_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "neutralResourceRegisters", "detailMapArrayRegisters", "lightConstantBuffer", "lightPackedTexture", "pairVaryings", "source"]);
+const EMIT_GLSL_PROFILE_KEYS = new Set(["constantBufferStyle", "pixelConstantBufferRemap", "samplerName", "vertexStructuredCapacity", "dataTextureWidth", "stubResourceRegisters", "neutralResourceRegisters", "detailMapArrayRegisters", "lightConstantBuffer", "lightPackedTexture"]);
+
+/**
+ * Translates one DXBC stage into GLSL ES 3.00 source, sharing one core path
+ * between `CjsWebglFormat.emitGlsl` (static) and `EmitGlsl` (instance).
+ *
+ * `options` is a flat bag combining the emitter's ccpwgl-profile constructor
+ * bits (`constantBufferStyle`, `pixelConstantBufferRemap`, `samplerName`,
+ * `vertexStructuredCapacity`, `dataTextureWidth`) with its per-call Emit
+ * options (`pairVaryings`, `source`); omitted keys keep the emitter's
+ * existing defaults exactly.
+ *
+ * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.
+ * @param {object} [options] Combined profile/emit options.
+ * @returns {{source:string,stageName:string,inputs:object[],outputs:object[],bindings:object[],warnings:string[],computeFragment:(object|undefined)}}
+ *   GLSL text plus the IO contract the packaging layer records; compute
+ *   stages add the emitter's `computeFragment` host contract.
+ */
+function emitGlslWithOptions(dxbcBytes, options = {}) {
+  if (!options || typeof options !== "object") {
+    throw new TypeError("CjsWebglFormat: emitGlsl options must be an object");
+  }
+  for (const key of Object.keys(options)) {
+    if (!EMIT_GLSL_OPTION_KEYS.has(key)) {
+      throw new TypeError(`CjsWebglFormat: unknown emitGlsl option ${JSON.stringify(key)}`);
+    }
+  }
+  const profile = {};
+  for (const key of EMIT_GLSL_PROFILE_KEYS) {
+    if (Object.prototype.hasOwnProperty.call(options, key)) profile[key] = options[key];
+  }
+  const emitter = new DxbcGlslEmitter({
+    profile
+  });
+  const result = emitter.Emit(dxbcBytes, {
+    source: options.source,
+    pairVaryings: options.pairVaryings
+  });
+
+  // The packed local-light lowering leaves two idioms that must not reach a
+  // driver: a flag mask round-tripped through a float, and an all-bits mask
+  // stored as a float and then used for branch control, where 0xFFFFFFFF is a
+  // NaN. Applied here rather than at a call site so every caller gets them.
+  if (!options.lightPackedTexture) return result;
+  return {
+    ...result,
+    source: applyPackedLightFixups(result.source, result.stageName)
+  };
+}
+
+/**
+ * Deep-convert a value to plain JSON-compatible data. Typed arrays become
+ * plain number arrays; Maps/Sets become objects/arrays; class instances
+ * with toJSON are honoured.
+ *
+ * @param {any} value Value to convert.
+ * @returns {any} Plain data.
+ */
+function toJsonValue(value) {
+  if (value === null || value === undefined) return value ?? null;
+  if (typeof value === "number" || typeof value === "string" || typeof value === "boolean") return value;
+  if (typeof value === "bigint") return value.toString();
+  if (ArrayBuffer.isView(value)) return Array.from(value);
+  if (Array.isArray(value)) return value.map(toJsonValue);
+  if (value instanceof Map) {
+    const out = {};
+    for (const [key, entry] of value) out[key] = toJsonValue(entry);
+    return out;
+  }
+  if (value instanceof Set) return Array.from(value, toJsonValue);
+  if (typeof value === "object") {
+    if (typeof value.toJSON === "function") return toJsonValue(value.toJSON());
+    const out = {};
+    for (const key of Object.keys(value)) out[key] = toJsonValue(value[key]);
+    return out;
+  }
+  return null;
+}
+
+export { DEFAULT_VALUES, OUTPUT_JSON, emitGlslWithOptions, isWebglEffectContainer, normalizeValues, toBytes, toJsonValue };
+//# sourceMappingURL=helpers.js.map

package/dist/formats/webgl/core/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/webgl/core/helpers.js"],"sourcesContent":["/**\n * Internal read-pipeline glue for CjsWebglFormat.\n *\n * Keeps the public class file small: input/option normalization, the shared\n * CEWG package read path used by both the instance and the static one-shots,\n * package construction, DXBC-to-GLSL emission, and JSON conversion all live\n * here. The CEWG container parser lives under src/core/cewg (internal parsing\n * machinery, not part of this package's public surface); the GLSL emitter\n * lives under src/core/glsl.\n */\n\nimport { CewgPackage } from \"./cewg/CewgPackage.js\";\nimport { CewgPackageBuilder } from \"./cewg/CewgPackageBuilder.js\";\nimport { DxbcGlslEmitter } from \"./glsl/DxbcGlslEmitter.js\";\nimport { WebglReadError } from \"./errors.js\";\nimport { validateEffectPackageEnvelope } from \"./effectPackageValidation.js\";\n\nexport const OUTPUT_JSON = \"json\";\nexport const OUTPUT_RAW = \"raw\";\nexport const CEWG_MAGIC = \"CEWG\";\nexport const CEWG_FORMAT = \"CEWG\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    source: \"memory\"\n});\n\nconst VALID_EMITS = new Set([ OUTPUT_JSON, OUTPUT_RAW ]);\nconst OPTION_KEYS = new Set([ \"emit\", \"source\" ]);\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Reader name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsWebglFormat\")\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName}: options must be an object`);\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const values = { ...base, ...options };\n\n    if (!VALID_EMITS.has(values.emit))\n    {\n        throw new TypeError(`${readerName}: emit must be \"${OUTPUT_JSON}\" or \"${OUTPUT_RAW}\", got ${JSON.stringify(values.emit)}`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n\n    return {\n        emit: values.emit,\n        source: values.source\n    };\n}\n\n/**\n * Normalize caller input into a Uint8Array of package/DXBC bytes.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {Uint8Array} The payload bytes.\n */\nexport function toBytes(input)\n{\n    if (input instanceof Uint8Array) return input;\n    if (typeof ArrayBuffer !== \"undefined\" && input instanceof ArrayBuffer) return new Uint8Array(input);\n    if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n    throw new TypeError(\"CjsWebglFormat: input must be CEWG package bytes (Uint8Array, Buffer, DataView or ArrayBuffer)\");\n}\n\n/**\n * Sniffs whether a payload starts with the CEWG container magic.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {boolean} True when the payload looks like a CEWG package.\n */\nexport function isCewg(input)\n{\n    try\n    {\n        const bytes = toBytes(input);\n        return bytes.length >= CEWG_MAGIC.length\n            && CEWG_MAGIC.split(\"\").every((char, index) => bytes[index] === char.charCodeAt(0));\n    }\n    catch\n    {\n        return false;\n    }\n}\n\n/**\n * The shared read path used by the instance Read/Inspect and the static\n * one-shots: normalizes input bytes and loads a CewgPackage.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package payload.\n * @param {object} values Normalized format values.\n * @returns {CewgPackage} The loaded package.\n */\nexport function readRaw(input, values)\n{\n    const bytes = toBytes(input);\n    const pkg = new CewgPackage();\n    const ok = pkg.Read(bytes, { sourcePath: values.source });\n\n    if (!ok)\n    {\n        throw new WebglReadError(\n            pkg.readError ? pkg.readError.message : \"Failed to read CEWG package\",\n            {\n                source: values.source,\n                cause: pkg.readError || null\n            }\n        );\n    }\n\n    try\n    {\n        validateEffectPackageEnvelope(pkg);\n    }\n    catch (error)\n    {\n        throw new WebglReadError(error.message, {\n            source: values.source,\n            cause: error\n        });\n    }\n\n    return pkg;\n}\n\n/**\n * Reads the `GLSL` chunk's shader records, when present.\n *\n * @param {CewgPackage} pkg Loaded package.\n * @returns {object[]} Shader records, or an empty array when absent.\n */\nfunction glslShaders(pkg)\n{\n    const glslJson = pkg.glslJson;\n    return Array.isArray(glslJson?.shaders) ? glslJson.shaders : [];\n}\n\n/**\n * Reads the `GLSL` chunk's stage records, when present.\n *\n * @param {CewgPackage} pkg Loaded package.\n * @returns {object[]} Stage records, or an empty array when absent.\n */\nfunction glslStages(pkg)\n{\n    const glslJson = pkg.glslJson;\n    return Array.isArray(glslJson?.stages) ? glslJson.stages : [];\n}\n\n/**\n * Converts a loaded package to the documented plain JSON shape.\n *\n * @param {CewgPackage} pkg Loaded package.\n * @returns {object} Plain JSON data.\n */\nexport function packageToJson(pkg)\n{\n    return toJsonValue({\n        format: CEWG_FORMAT,\n        version: pkg.version,\n        sourcePath: pkg.sourcePath,\n        chunks: pkg.chunks.map(({ tag, size, offset }) => ({ tag, size, offset })),\n        info: pkg.info,\n        metadata: pkg.metadata,\n        permutationGraph: pkg.permutationGraph,\n        reflection: pkg.reflection,\n        reflectionBlobByteLength: pkg.reflectionBlobBytes?.byteLength ?? 0,\n        glsl: pkg.glslJson !== null ? pkg.glslJson : pkg.glsl,\n        shaders: glslShaders(pkg)\n    });\n}\n\n/**\n * Shared read entry honouring the emit mode.\n *\n * `emit: \"raw\"` returns the live CewgPackage instance — internal, unstable,\n * not schema-guaranteed. `emit: \"json\"` (the default) returns the documented\n * plain-data package shape: parsed INFO/META/GLSL chunks plus a flat shader\n * record list.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package payload.\n * @param {object} values Normalized format values.\n * @returns {CewgPackage|object} The raw package instance, or the documented JSON shape.\n */\nexport function readWithValues(input, values)\n{\n    const pkg = readRaw(input, values);\n    return values.emit === OUTPUT_RAW ? pkg : packageToJson(pkg);\n}\n\n/**\n * Cheap inspection: version, chunk tags/sizes, and GLSL shader/stage counts,\n * without building the full JSON package shape.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input CEWG package payload.\n * @param {object} values Normalized format values.\n * @returns {object} Plain summary data.\n */\nexport function inspectWithValues(input, values)\n{\n    const pkg = readRaw(input, values);\n    const info = pkg.info;\n    const permutationGraph = pkg.permutationGraph;\n    return {\n        source: values.source,\n        isCewg: true,\n        version: pkg.version,\n        chunks: pkg.chunks.map(({ tag, size, offset }) => ({ tag, size, offset })),\n        shaderCount: glslShaders(pkg).length,\n        stageCount: glslStages(pkg).length,\n        permutationCount: permutationGraph?.variants?.length ?? 0,\n        uniqueBodyCount: permutationGraph?.bodies?.length ?? 0,\n        reflectionBodyCount: info?.effectReflection?.bodyCount ?? 0,\n        reflectionSourceProgramCount:\n            info?.effectReflection?.sourceProgramCount ?? 0,\n        reflectionBlobCount: info?.effectReflection?.blobCount ?? 0,\n        reflectionBlobByteLength:\n            info?.effectReflection?.blobByteLength ?? 0\n    };\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 */\nexport function buildPackage(chunks)\n{\n    return CewgPackageBuilder.build(chunks);\n}\n\nconst EMIT_GLSL_OPTION_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\",\n    \"pairVaryings\",\n    \"source\"\n]);\n\nconst EMIT_GLSL_PROFILE_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\"\n]);\n\n/**\n * Translates one DXBC stage into GLSL ES 3.00 source, sharing one core path\n * between `CjsWebglFormat.emitGlsl` (static) and `EmitGlsl` (instance).\n *\n * `options` is a flat bag combining the emitter's ccpwgl-profile constructor\n * bits (`constantBufferStyle`, `pixelConstantBufferRemap`, `samplerName`,\n * `vertexStructuredCapacity`, `dataTextureWidth`) with its per-call Emit\n * options (`pairVaryings`, `source`); omitted keys keep the emitter's\n * existing defaults exactly.\n *\n * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n * @param {object} [options] Combined profile/emit options.\n * @returns {{source:string,stageName:string,inputs:object[],outputs:object[],bindings:object[],warnings:string[],computeFragment:(object|undefined)}}\n *   GLSL text plus the IO contract the packaging layer records; compute\n *   stages add the emitter's `computeFragment` host contract.\n */\nexport function emitGlslWithOptions(dxbcBytes, options = {})\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(\"CjsWebglFormat: emitGlsl options must be an object\");\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!EMIT_GLSL_OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`CjsWebglFormat: unknown emitGlsl option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const profile = {};\n    for (const key of EMIT_GLSL_PROFILE_KEYS)\n    {\n        if (Object.prototype.hasOwnProperty.call(options, key)) profile[key] = options[key];\n    }\n\n    const emitter = new DxbcGlslEmitter({ profile });\n    return emitter.Emit(dxbcBytes, {\n        source: options.source,\n        pairVaryings: options.pairVaryings\n    });\n}\n\n/**\n * Deep-convert a value to plain JSON-compatible data. Typed arrays become\n * plain number arrays; Maps/Sets become objects/arrays; class instances\n * with toJSON are honoured.\n *\n * @param {any} value Value to convert.\n * @returns {any} Plain data.\n */\nexport function toJsonValue(value)\n{\n    if (value === null || value === undefined) return value ?? null;\n    if (typeof value === \"number\" || typeof value === \"string\" || typeof value === \"boolean\") return value;\n    if (typeof value === \"bigint\") return value.toString();\n    if (ArrayBuffer.isView(value)) return Array.from(value);\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (value instanceof Map)\n    {\n        const out = {};\n        for (const [ key, entry ] of value) out[key] = toJsonValue(entry);\n        return out;\n    }\n    if (value instanceof Set) return Array.from(value, toJsonValue);\n    if (typeof value === \"object\")\n    {\n        if (typeof value.toJSON === \"function\") return toJsonValue(value.toJSON());\n        const out = {};\n        for (const key of Object.keys(value)) out[key] = toJsonValue(value[key]);\n        return out;\n    }\n    return null;\n}\n\nexport { WebglReadError };\n"],"names":["OUTPUT_JSON","OUTPUT_RAW","CEWG_MAGIC","CEWG_FORMAT","DEFAULT_VALUES","Object","freeze","emit","source","VALID_EMITS","Set","OPTION_KEYS","normalizeValues","base","options","readerName","TypeError","key","keys","has","JSON","stringify","values","toBytes","input","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","isCewg","bytes","length","split","every","char","index","charCodeAt","readRaw","pkg","CewgPackage","ok","Read","sourcePath","WebglReadError","readError","message","cause","validateEffectPackageEnvelope","error","glslShaders","glslJson","Array","isArray","shaders","glslStages","stages","packageToJson","toJsonValue","format","version","chunks","map","tag","size","offset","info","metadata","permutationGraph","reflection","reflectionBlobByteLength","reflectionBlobBytes","glsl","readWithValues","inspectWithValues","shaderCount","stageCount","permutationCount","variants","uniqueBodyCount","bodies","reflectionBodyCount","effectReflection","bodyCount","reflectionSourceProgramCount","sourceProgramCount","reflectionBlobCount","blobCount","blobByteLength","buildPackage","CewgPackageBuilder","build","EMIT_GLSL_OPTION_KEYS","EMIT_GLSL_PROFILE_KEYS","emitGlslWithOptions","dxbcBytes","profile","prototype","hasOwnProperty","call","emitter","DxbcGlslEmitter","Emit","pairVaryings","value","undefined","toString","from","Map","out","entry","toJSON"],"mappings":"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"}
+{"version":3,"file":"helpers.js","sources":["../../../../../src/formats/webgl/core/helpers.js"],"sourcesContent":["/**\n * Internal glue for CjsWebglFormat.\n *\n * Keeps the public class file small: input/option normalization, DXBC-to-GLSL\n * emission, and JSON conversion live here. Reading an effect is\n * `readGlslEffectContainer` and summarising one is `inspectGlslEffectContainer`;\n * neither needs glue, so neither is wrapped here. The GLSL emitter lives under\n * src/formats/webgl/core/glsl.\n */\n\nimport { DxbcGlslEmitter } from \"./glsl/DxbcGlslEmitter.js\";\nimport { applyPackedLightFixups } from \"./glsl/packedLightFixups.js\";\nimport { WebglReadError } from \"./errors.js\";\nimport {\n    looksLikeCarbonEffectContainer\n} from \"../../../format/carbonEffect/CjsCarbonEffectReader.js\";\n\nexport const OUTPUT_JSON = \"json\";\n\nexport const DEFAULT_VALUES = Object.freeze({\n    emit: OUTPUT_JSON,\n    source: \"memory\"\n});\n\nconst VALID_EMITS = new Set([ OUTPUT_JSON ]);\nconst OPTION_KEYS = new Set([ \"emit\", \"source\" ]);\n\n/**\n * Merge format values over a base set and validate them.\n *\n * @param {object} base Current values.\n * @param {object} [options] Values to merge in.\n * @param {string} [readerName] Reader name used in error messages.\n * @returns {object} A validated copy of the merged values.\n */\nexport function normalizeValues(base, options = {}, readerName = \"CjsWebglFormat\")\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(`${readerName}: options must be an object`);\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`${readerName}: unknown option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const values = { ...base, ...options };\n\n    if (!VALID_EMITS.has(values.emit))\n    {\n        throw new TypeError(`${readerName}: emit must be \"${OUTPUT_JSON}\", got ${JSON.stringify(values.emit)}`);\n    }\n    if (typeof values.source !== \"string\" || !values.source)\n    {\n        values.source = DEFAULT_VALUES.source;\n    }\n\n    return {\n        emit: values.emit,\n        source: values.source\n    };\n}\n\n/**\n * Normalize caller input into a Uint8Array of package/DXBC bytes.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {Uint8Array} The payload bytes.\n */\nexport function toBytes(input)\n{\n    if (input instanceof Uint8Array) return input;\n    if (typeof ArrayBuffer !== \"undefined\" && input instanceof ArrayBuffer) return new Uint8Array(input);\n    if (ArrayBuffer.isView(input)) return new Uint8Array(input.buffer, input.byteOffset, input.byteLength);\n    throw new TypeError(\"CjsWebglFormat: input must be effect container bytes (Uint8Array, Buffer, DataView or ArrayBuffer)\");\n}\n\n/**\n * Reports whether a payload has the Carbon effect container shape.\n *\n * A shape check, not an identity check: our files are stock Carbon containers,\n * so nothing in the bytes distinguishes a WebGL one from a shipped\n * `effect.dx11`. Identity comes from the path the file was resolved through.\n *\n * @param {Uint8Array|ArrayBuffer|Buffer|DataView} input Candidate payload.\n * @returns {boolean} True when the payload has the container shape.\n */\nexport function isWebglEffectContainer(input)\n{\n    try\n    {\n        return looksLikeCarbonEffectContainer(toBytes(input));\n    }\n    catch\n    {\n        return false;\n    }\n}\n\nconst EMIT_GLSL_OPTION_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"neutralResourceRegisters\",\n    \"detailMapArrayRegisters\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\",\n    \"pairVaryings\",\n    \"source\"\n]);\n\nconst EMIT_GLSL_PROFILE_KEYS = new Set([\n    \"constantBufferStyle\",\n    \"pixelConstantBufferRemap\",\n    \"samplerName\",\n    \"vertexStructuredCapacity\",\n    \"dataTextureWidth\",\n    \"stubResourceRegisters\",\n    \"neutralResourceRegisters\",\n    \"detailMapArrayRegisters\",\n    \"lightConstantBuffer\",\n    \"lightPackedTexture\"\n]);\n\n/**\n * Translates one DXBC stage into GLSL ES 3.00 source, sharing one core path\n * between `CjsWebglFormat.emitGlsl` (static) and `EmitGlsl` (instance).\n *\n * `options` is a flat bag combining the emitter's ccpwgl-profile constructor\n * bits (`constantBufferStyle`, `pixelConstantBufferRemap`, `samplerName`,\n * `vertexStructuredCapacity`, `dataTextureWidth`) with its per-call Emit\n * options (`pairVaryings`, `source`); omitted keys keep the emitter's\n * existing defaults exactly.\n *\n * @param {ArrayBuffer|ArrayBufferView|Uint8Array} dxbcBytes DXBC container bytes.\n * @param {object} [options] Combined profile/emit options.\n * @returns {{source:string,stageName:string,inputs:object[],outputs:object[],bindings:object[],warnings:string[],computeFragment:(object|undefined)}}\n *   GLSL text plus the IO contract the packaging layer records; compute\n *   stages add the emitter's `computeFragment` host contract.\n */\nexport function emitGlslWithOptions(dxbcBytes, options = {})\n{\n    if (!options || typeof options !== \"object\")\n    {\n        throw new TypeError(\"CjsWebglFormat: emitGlsl options must be an object\");\n    }\n    for (const key of Object.keys(options))\n    {\n        if (!EMIT_GLSL_OPTION_KEYS.has(key))\n        {\n            throw new TypeError(`CjsWebglFormat: unknown emitGlsl option ${JSON.stringify(key)}`);\n        }\n    }\n\n    const profile = {};\n    for (const key of EMIT_GLSL_PROFILE_KEYS)\n    {\n        if (Object.prototype.hasOwnProperty.call(options, key)) profile[key] = options[key];\n    }\n\n    const emitter = new DxbcGlslEmitter({ profile });\n    const result = emitter.Emit(dxbcBytes, {\n        source: options.source,\n        pairVaryings: options.pairVaryings\n    });\n\n    // The packed local-light lowering leaves two idioms that must not reach a\n    // driver: a flag mask round-tripped through a float, and an all-bits mask\n    // stored as a float and then used for branch control, where 0xFFFFFFFF is a\n    // NaN. Applied here rather than at a call site so every caller gets them.\n    if (!options.lightPackedTexture) return result;\n\n    return {\n        ...result,\n        source: applyPackedLightFixups(result.source, result.stageName)\n    };\n}\n\n/**\n * Deep-convert a value to plain JSON-compatible data. Typed arrays become\n * plain number arrays; Maps/Sets become objects/arrays; class instances\n * with toJSON are honoured.\n *\n * @param {any} value Value to convert.\n * @returns {any} Plain data.\n */\nexport function toJsonValue(value)\n{\n    if (value === null || value === undefined) return value ?? null;\n    if (typeof value === \"number\" || typeof value === \"string\" || typeof value === \"boolean\") return value;\n    if (typeof value === \"bigint\") return value.toString();\n    if (ArrayBuffer.isView(value)) return Array.from(value);\n    if (Array.isArray(value)) return value.map(toJsonValue);\n    if (value instanceof Map)\n    {\n        const out = {};\n        for (const [ key, entry ] of value) out[key] = toJsonValue(entry);\n        return out;\n    }\n    if (value instanceof Set) return Array.from(value, toJsonValue);\n    if (typeof value === \"object\")\n    {\n        if (typeof value.toJSON === \"function\") return toJsonValue(value.toJSON());\n        const out = {};\n        for (const key of Object.keys(value)) out[key] = toJsonValue(value[key]);\n        return out;\n    }\n    return null;\n}\n\nexport { WebglReadError };\n"],"names":["OUTPUT_JSON","DEFAULT_VALUES","Object","freeze","emit","source","VALID_EMITS","Set","OPTION_KEYS","normalizeValues","base","options","readerName","TypeError","key","keys","has","JSON","stringify","values","toBytes","input","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","isWebglEffectContainer","looksLikeCarbonEffectContainer","EMIT_GLSL_OPTION_KEYS","EMIT_GLSL_PROFILE_KEYS","emitGlslWithOptions","dxbcBytes","profile","prototype","hasOwnProperty","call","emitter","DxbcGlslEmitter","result","Emit","pairVaryings","lightPackedTexture","applyPackedLightFixups","stageName","toJsonValue","value","undefined","toString","Array","from","isArray","map","Map","out","entry","toJSON"],"mappings":"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"}