@carbonenginejs/runtime-resource 0.10.0 → 0.11.1

package/dist/formats/webgpu/core/packageEffect.js

@@ -0,0 +1,300 @@
+import { readEffectAnalysis } from './effectAnalysis.js';
+import { EFFECT_INFO_VERSION } from './effectPackageValidation.js';
+import { buildEffectAnalysis, buildPackage, inspectWithValues } from './helpers.js';
+import { lowerDxbcToIr } from './ir/lowerDxbcToIr.js';
+import { buildWgslBindingPlan } from './wgsl/buildWgslBindingPlan.js';
+import { buildWgsl } from './wgsl/emitWgsl.js';
+import { buildWgslSet } from './wgsl/buildWgslSet.js';
+import { buildResourceTransformPlan } from './wgsl/buildResourceTransformPlan.js';
+import { buildEffectPermutationGraph, EFFECT_PERMUTATION_GRAPH_VERSION, EFFECT_PERMUTATION_GRAPH_FORMAT, EFFECT_PERMUTATION_GRAPH_CHUNK } from '../../../format/effect/effectPermutationGraph.js';
+import { buildCompleteEffectReflection, EFFECT_REFLECTION_CHUNK, EFFECT_REFLECTION_BLOB_CHUNK } from '../../../format/effect/effectReflectionPackage.js';
+import { buildEffectBackendBodySet, EFFECT_BACKEND_BODY_SET_VERSION, EFFECT_BACKEND_BODY_SET_FORMAT, EFFECT_BACKEND_BODY_SET_CHUNK } from './effectBackendBodySet.js';
+import { DXBC_WGSL_TRANSLATOR_VERSION, DXBC_WGSL_TRANSLATOR_NAME, FORMAT_WEBGPU_PACKAGE_VERSION, FORMAT_WEBGPU_PACKAGE_NAME, WEBGPU_BACKEND_NAME } from './packageMetadata.js';
+import { sha256Utf8, sha256Bytes } from '../../../format/effect/sha256.js';
+import { isParticleClearEffectCandidate, preflightParticleClearEffectProfile, particleClearEffectProofFor } from './wgsl/lowerParticleClearComputePrograms.js';
+import { normalizeEffectPermutation, validateResolvedPermutation, selectEffectStages, buildWgslSelectionMetadata } from './packageEffectSelection.js';
+
+/**
+ * Build one structurally valid CEWGPU package from compiled Tr2 effect bytes.
+ *
+ * Version-15 packages preserve every unique body's source reflection while
+ * resolving one backend body and emitting complete passes within the requested
+ * stage selection. Filesystem concerns remain in callers.
+ *
+ * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.
+ * @param {object} [options] Source, body-mode, permutation, and stage-selection policy.
+ * @returns {object} Package bytes plus inspection and provenance documents.
+ */
+function buildEffectPackage(input, options = {}) {
+  const mode = normalizeMode(options.mode, options.allPermutations);
+  const source = normalizeSource(options.source);
+  const outputPath = normalizeOptionalString(options.outputPath, "Effect outputPath");
+  const sourceIdentity = normalizeSourceIdentity(options.sourceIdentity, source, input);
+  const permutation = normalizeEffectPermutation(options.permutation);
+  const selection = normalizeSelection(options.selection);
+  const resolved = readEffectAnalysis(input, {
+    source,
+    permutation
+  });
+
+  // One INFO version means one contract, and that contract requires complete
+  // source reflection, which only version-15 input can supply.
+  if (resolved.effectRes?.m_version !== 15) {
+    throw new Error("Effect package requires a version-15 compiled effect, got version " + (resolved.effectRes?.m_version ?? "unknown"));
+  }
+  validateResolvedPermutation(permutation, resolved.selection?.selectedOptions ?? []);
+  const analysis = buildEffectAnalysis(resolved, {
+    source,
+    decodeBytecode: false,
+    decodeInstructions: false
+  });
+  const bytecodeByKey = resolved.stageBytecodeByKey;
+  const selectedStages = selectEffectStages(analysis.stages, selection);
+  const programsByKey = new Map();
+  const programForKey = key => {
+    if (programsByKey.has(key)) return programsByKey.get(key);
+    const bytecode = bytecodeByKey.get(key)?.bytes;
+    if (!bytecode?.length) {
+      throw new Error(`${key} has no shader bytecode`);
+    }
+    const program = lowerDxbcToIr(bytecode, {
+      source: `${source}#${key}`
+    });
+    programsByKey.set(key, program);
+    return program;
+  };
+  let effectProfileContext = null;
+  if (isParticleClearEffectCandidate(resolved.effectDescription)) {
+    programForKey("Main.pass0.compute");
+    programForKey("Main.pass1.compute");
+    effectProfileContext = preflightParticleClearEffectProfile(resolved.effectDescription, programsByKey);
+  }
+  const irEntries = selectedStages.map(stage => ({
+    key: stage.key,
+    passKey: `${stage.techniqueName}.pass${stage.passIndex}`,
+    ir: programForKey(stage.key),
+    semanticBindings: analysis.stages.find(candidate => candidate.techniqueName === stage.techniqueName && candidate.passIndex === stage.passIndex && candidate.stageName === stage.stageName)?.bindings || [],
+    effectProfileProof: particleClearEffectProofFor(effectProfileContext, stage.key)
+  }));
+  const programsByPass = new Map();
+  for (const entry of irEntries) {
+    if (!programsByPass.has(entry.passKey)) {
+      programsByPass.set(entry.passKey, []);
+    }
+    programsByPass.get(entry.passKey).push(entry);
+  }
+  const resourceTransformPlans = new Map(Array.from(programsByPass, ([key, entries]) => [key, buildResourceTransformPlan(entries.map(entry => ({
+    ir: entry.ir,
+    semanticBindings: entry.semanticBindings
+  })), {
+    layoutKey: key
+  })]));
+  const plans = new Map(Array.from(programsByPass, ([key, entries]) => {
+    const proof = entries.find(entry => entry.effectProfileProof)?.effectProfileProof ?? null;
+    const resourceTransformPlan = resourceTransformPlans.get(key);
+    return [key, buildWgslBindingPlan(entries.map(entry => entry.ir), {
+      ...(options.bindingPolicy ?? {}),
+      ...(proof ? {
+        effectProfileProof: proof
+      } : {}),
+      ...(resourceTransformPlan ? {
+        resourceTransformPlan
+      } : {})
+    })];
+  }));
+  const shaderEntries = irEntries.map(entry => ({
+    key: entry.key,
+    shader: buildWgsl(entry.ir, {
+      bindingPlan: plans.get(entry.passKey),
+      ...(resourceTransformPlans.get(entry.passKey) ? {
+        resourceTransformPlan: resourceTransformPlans.get(entry.passKey)
+      } : {}),
+      ...(entry.effectProfileProof ? {
+        effectProfileProof: entry.effectProfileProof
+      } : {})
+    })
+  }));
+  const wgsl = buildWgslSet(shaderEntries);
+  const wgslSelection = buildWgslSelectionMetadata(selection, selectedStages);
+  const permutationGraph = buildEffectPermutationGraph(resolved.effectRes);
+  const effectReflection = resolved.effectRes.m_version === 15 ? buildCompleteEffectReflection(resolved.effectRes, permutationGraph, {
+    sourceIdentity,
+    sourcePath: source
+  }) : null;
+  if (mode === "all" && !effectReflection) {
+    throw new Error("Effect package mode all requires complete version-15 source reflection");
+  }
+  const backendBodySet = mode === "all" ? buildEffectBackendBodySet(resolved.effectRes, permutationGraph, {
+    source,
+    selection,
+    bindingPolicy: options.bindingPolicy
+  }) : null;
+  const completeness = Object.freeze({
+    packageValid: true,
+    sourceComplete: effectReflection !== null,
+    backendComplete: false,
+    runtimeComplete: false
+  });
+  const info = {
+    format: "CEWGPU",
+    formatVersion: EFFECT_INFO_VERSION,
+    packageKind: "tr2-effect-webgpu",
+    sourcePath: source,
+    outputPath,
+    sourceIdentity,
+    targetBackend: WEBGPU_BACKEND_NAME,
+    backendPackage: FORMAT_WEBGPU_PACKAGE_NAME,
+    backendPackageVersion: FORMAT_WEBGPU_PACKAGE_VERSION,
+    translator: DXBC_WGSL_TRANSLATOR_NAME,
+    translatorVersion: DXBC_WGSL_TRANSLATOR_VERSION,
+    permutationGraph: Object.freeze({
+      chunk: EFFECT_PERMUTATION_GRAPH_CHUNK,
+      format: EFFECT_PERMUTATION_GRAPH_FORMAT,
+      formatVersion: EFFECT_PERMUTATION_GRAPH_VERSION,
+      sha256: sha256Utf8(`${JSON.stringify(permutationGraph)}\n`),
+      permutationCount: permutationGraph.variants.length,
+      uniqueBodyCount: permutationGraph.bodies.length
+    }),
+    ...(effectReflection ? {
+      effectReflection: effectReflection.pointer,
+      sourceBodyCoverage: "all-unique",
+      backendBodyCoverage: backendBodySet ? backendBodySet.coverage.bodies : "selected"
+    } : {}),
+    ...(backendBodySet ? {
+      backendBodySet: Object.freeze({
+        chunk: EFFECT_BACKEND_BODY_SET_CHUNK,
+        format: EFFECT_BACKEND_BODY_SET_FORMAT,
+        formatVersion: EFFECT_BACKEND_BODY_SET_VERSION,
+        sha256: sha256Utf8(`${JSON.stringify(backendBodySet)}\n`),
+        bodyCount: backendBodySet.bodyCount,
+        translatedBodyCount: backendBodySet.translatedBodyCount,
+        passUnitCount: backendBodySet.passUnitCount
+      })
+    } : {}),
+    bodyMode: mode,
+    completeness,
+    stageCount: analysis.stages.length,
+    selectedStageCount: selectedStages.length,
+    shaderCount: wgsl.shaders.length,
+    layoutCount: wgsl.layouts.length
+  };
+  const metadata = {
+    effectName: analysis.effectName,
+    sourcePath: source,
+    bodyMode: mode,
+    bodyIndex: analysis.bodyIndex,
+    selectedOptions: analysis.selectedOptions,
+    ...(wgslSelection ? {
+      wgslSelection
+    } : {})
+  };
+  const bytes = buildPackage([["INFO", info], ["META", metadata], [EFFECT_PERMUTATION_GRAPH_CHUNK, permutationGraph], ...(effectReflection ? [[EFFECT_REFLECTION_CHUNK, effectReflection.reflection], [EFFECT_REFLECTION_BLOB_CHUNK, effectReflection.blobBytes]] : []), ["ANLS", analysis], ["WGSL", wgsl], ...(backendBodySet ? [[EFFECT_BACKEND_BODY_SET_CHUNK, backendBodySet]] : [])]);
+  const inspection = inspectWithValues(bytes, {
+    source});
+  const qualification = Object.freeze({
+    ok: true,
+    level: "structural",
+    validator: "cewgpu-structural",
+    mode,
+    ...completeness,
+    selectedStageCount: selectedStages.length,
+    shaderCount: wgsl.shaders.length,
+    layoutCount: wgsl.layouts.length,
+    ...(backendBodySet ? {
+      backendBodyCount: backendBodySet.bodyCount,
+      backendTranslatedBodyCount: backendBodySet.translatedBodyCount,
+      backendPassUnitCount: backendBodySet.passUnitCount
+    } : {}),
+    nativeComparison: false
+  });
+  return Object.freeze({
+    bytes,
+    info: Object.freeze(info),
+    metadata: Object.freeze(metadata),
+    permutationGraph,
+    reflection: effectReflection?.reflection ?? null,
+    reflectionBlobs: effectReflection?.blobBytes ?? null,
+    analysis,
+    wgsl,
+    backendBodySet,
+    inspection: Object.freeze(inspection),
+    qualification
+  });
+}
+function normalizeMode(value, allPermutations) {
+  if (allPermutations !== undefined && typeof allPermutations !== "boolean") {
+    throw new TypeError("Effect allPermutations compatibility option must be boolean");
+  }
+  const mode = String(allPermutations === true ? "all" : value ?? "selected").trim();
+  if (mode !== "selected" && mode !== "all") {
+    throw new Error(`Effect package mode ${mode || "<empty>"} is not supported; ` + "supported modes are selected and all");
+  }
+  return mode;
+}
+function normalizeSource(value) {
+  const source = String(value ?? "memory").trim();
+  return source || "memory";
+}
+function normalizeOptionalString(value, name) {
+  if (value === undefined || value === null) {
+    return null;
+  }
+  const result = String(value).trim();
+  if (!result) {
+    throw new TypeError(`${name} must be a non-empty string or null`);
+  }
+  return result;
+}
+function normalizeSelection(value) {
+  if (value === undefined || value === null) {
+    return null;
+  }
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new TypeError("Effect stage selection must be an object");
+  }
+  const techniqueName = String(value.techniqueName ?? "").trim();
+  const passIndex = value.passIndex ?? null;
+  const stageNames = value.stageNames ?? [];
+  if (!techniqueName) {
+    throw new TypeError("Effect stage selection requires techniqueName");
+  }
+  if (passIndex !== null && (!Number.isSafeInteger(passIndex) || passIndex < 0)) {
+    throw new TypeError("Effect stage selection passIndex must be a non-negative integer or null");
+  }
+  if (!Array.isArray(stageNames) || stageNames.some(stageName => !["vertex", "pixel", "compute"].includes(stageName))) {
+    throw new TypeError("Effect stage selection supports only vertex, pixel, and compute stageNames");
+  }
+  if (stageNames.length && passIndex === null) {
+    throw new TypeError("Effect stageNames require an exact passIndex");
+  }
+  return Object.freeze({
+    techniqueName,
+    passIndex,
+    stageNames: Object.freeze([...new Set(stageNames)])
+  });
+}
+function normalizeSourceIdentity(value, source, input) {
+  if (value !== undefined && value !== null && (!value || typeof value !== "object" || Array.isArray(value))) {
+    throw new TypeError("Effect sourceIdentity must be an object");
+  }
+  const bytes = input instanceof Uint8Array ? input : input instanceof ArrayBuffer ? new Uint8Array(input) : ArrayBuffer.isView(input) ? new Uint8Array(input.buffer, input.byteOffset, input.byteLength) : null;
+  if (!bytes) {
+    throw new TypeError("Effect input must be Uint8Array, ArrayBuffer, or ArrayBufferView bytes");
+  }
+  const sha256 = sha256Bytes(bytes);
+  if (value?.sha256 !== undefined && value?.sha256 !== null && value.sha256 !== sha256) {
+    throw new Error("Effect sourceIdentity.sha256 does not match the exact effect input bytes");
+  }
+  return Object.freeze({
+    logicalPath: value?.logicalPath ?? source,
+    game: value?.game ?? null,
+    client: value?.client ?? null,
+    build: value?.build === undefined || value?.build === null ? null : String(value.build),
+    byteLength: bytes.byteLength,
+    md5: value?.md5 ?? null,
+    sha256
+  });
+}
+
+export { buildEffectPackage };
+//# sourceMappingURL=packageEffect.js.map

package/dist/formats/webgpu/core/packageEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageEffect.js","sources":["../../../../../src/formats/webgpu/core/packageEffect.js"],"sourcesContent":["import { readEffectAnalysis } from \"./effectAnalysis.js\";\nimport { EFFECT_INFO_VERSION } from \"./effectPackageValidation.js\";\nimport { buildEffectAnalysis, buildPackage, inspectWithValues } from \"./helpers.js\";\nimport { lowerDxbcToIr } from \"./ir/lowerDxbcToIr.js\";\nimport { buildWgslBindingPlan } from \"./wgsl/buildWgslBindingPlan.js\";\nimport { buildWgsl } from \"./wgsl/emitWgsl.js\";\nimport { buildWgslSet } from \"./wgsl/buildWgslSet.js\";\nimport { buildResourceTransformPlan } from \"./wgsl/buildResourceTransformPlan.js\";\nimport {\n    buildEffectPermutationGraph,\n    EFFECT_PERMUTATION_GRAPH_CHUNK,\n    EFFECT_PERMUTATION_GRAPH_FORMAT,\n    EFFECT_PERMUTATION_GRAPH_VERSION\n} from \"../../../format/effect/effectPermutationGraph.js\";\nimport {\n    buildCompleteEffectReflection,\n    EFFECT_REFLECTION_BLOB_CHUNK,\n    EFFECT_REFLECTION_CHUNK\n} from \"../../../format/effect/effectReflectionPackage.js\";\nimport {\n    buildEffectBackendBodySet,\n    EFFECT_BACKEND_BODY_SET_CHUNK,\n    EFFECT_BACKEND_BODY_SET_FORMAT,\n    EFFECT_BACKEND_BODY_SET_VERSION\n} from \"./effectBackendBodySet.js\";\nimport {\n    DXBC_WGSL_TRANSLATOR_NAME,\n    DXBC_WGSL_TRANSLATOR_VERSION,\n    FORMAT_WEBGPU_PACKAGE_NAME,\n    FORMAT_WEBGPU_PACKAGE_VERSION,\n    WEBGPU_BACKEND_NAME\n} from \"./packageMetadata.js\";\nimport { sha256Bytes, sha256Utf8 } from \"../../../format/effect/sha256.js\";\nimport {\n    isParticleClearEffectCandidate,\n    particleClearEffectProofFor,\n    preflightParticleClearEffectProfile\n} from \"./wgsl/lowerParticleClearComputePrograms.js\";\nimport {\n    buildWgslSelectionMetadata,\n    normalizeEffectPermutation,\n    selectEffectStages,\n    validateResolvedPermutation\n} from \"./packageEffectSelection.js\";\n\n/**\n * Build one structurally valid CEWGPU package from compiled Tr2 effect bytes.\n *\n * Version-15 packages preserve every unique body's source reflection while\n * resolving one backend body and emitting complete passes within the requested\n * stage selection. Filesystem concerns remain in callers.\n *\n * @param {Uint8Array|ArrayBuffer|ArrayBufferView} input Compiled effect bytes.\n * @param {object} [options] Source, body-mode, permutation, and stage-selection policy.\n * @returns {object} Package bytes plus inspection and provenance documents.\n */\nexport function buildEffectPackage(input, options = {})\n{\n    const mode = normalizeMode(options.mode, options.allPermutations);\n    const source = normalizeSource(options.source);\n    const outputPath = normalizeOptionalString(options.outputPath, \"Effect outputPath\");\n    const sourceIdentity = normalizeSourceIdentity(\n        options.sourceIdentity,\n        source,\n        input\n    );\n    const permutation = normalizeEffectPermutation(options.permutation);\n    const selection = normalizeSelection(options.selection);\n    const resolved = readEffectAnalysis(input, { source, permutation });\n\n    // One INFO version means one contract, and that contract requires complete\n    // source reflection, which only version-15 input can supply.\n    if (resolved.effectRes?.m_version !== 15)\n    {\n        throw new Error(\n            \"Effect package requires a version-15 compiled effect, got version \"\n            + (resolved.effectRes?.m_version ?? \"unknown\")\n        );\n    }\n\n    validateResolvedPermutation(permutation, resolved.selection?.selectedOptions ?? []);\n\n    const analysis = buildEffectAnalysis(resolved, {\n        source,\n        decodeBytecode: false,\n        decodeInstructions: false\n    });\n    const bytecodeByKey = resolved.stageBytecodeByKey;\n    const selectedStages = selectEffectStages(analysis.stages, selection);\n    const programsByKey = new Map();\n    const programForKey = (key) =>\n    {\n        if (programsByKey.has(key)) return programsByKey.get(key);\n        const bytecode = bytecodeByKey.get(key)?.bytes;\n\n        if (!bytecode?.length)\n        {\n            throw new Error(`${key} has no shader bytecode`);\n        }\n        const program = lowerDxbcToIr(\n            bytecode,\n            { source: `${source}#${key}` }\n        );\n        programsByKey.set(key, program);\n        return program;\n    };\n    let effectProfileContext = null;\n    if (isParticleClearEffectCandidate(resolved.effectDescription))\n    {\n        programForKey(\"Main.pass0.compute\");\n        programForKey(\"Main.pass1.compute\");\n        effectProfileContext = preflightParticleClearEffectProfile(\n            resolved.effectDescription,\n            programsByKey\n        );\n    }\n    const irEntries = selectedStages.map((stage) => ({\n        key: stage.key,\n        passKey: `${stage.techniqueName}.pass${stage.passIndex}`,\n        ir: programForKey(stage.key),\n        semanticBindings: analysis.stages.find((candidate) =>\n            candidate.techniqueName === stage.techniqueName\n            && candidate.passIndex === stage.passIndex\n            && candidate.stageName === stage.stageName)?.bindings || [],\n        effectProfileProof: particleClearEffectProofFor(\n            effectProfileContext,\n            stage.key\n        )\n    }));\n    const programsByPass = new Map();\n\n    for (const entry of irEntries)\n    {\n        if (!programsByPass.has(entry.passKey))\n        {\n            programsByPass.set(entry.passKey, []);\n        }\n\n        programsByPass.get(entry.passKey).push(entry);\n    }\n\n    const resourceTransformPlans = new Map(Array.from(programsByPass, ([ key, entries ]) => [\n        key,\n        buildResourceTransformPlan(\n            entries.map((entry) => ({\n                ir: entry.ir,\n                semanticBindings: entry.semanticBindings\n            })),\n            { layoutKey: key }\n        )\n    ]));\n    const plans = new Map(Array.from(programsByPass, ([ key, entries ]) =>\n    {\n        const proof = entries.find((entry) => entry.effectProfileProof)\n            ?.effectProfileProof ?? null;\n        const resourceTransformPlan = resourceTransformPlans.get(key);\n        return [\n            key,\n            buildWgslBindingPlan(\n                entries.map((entry) => entry.ir),\n                {\n                    ...(options.bindingPolicy ?? {}),\n                    ...(proof ? { effectProfileProof: proof } : {}),\n                    ...(resourceTransformPlan ? { resourceTransformPlan } : {})\n                }\n            )\n        ];\n    }));\n    const shaderEntries = irEntries.map((entry) => ({\n        key: entry.key,\n        shader: buildWgsl(entry.ir, {\n            bindingPlan: plans.get(entry.passKey),\n            ...(resourceTransformPlans.get(entry.passKey)\n                ? { resourceTransformPlan: resourceTransformPlans.get(entry.passKey) }\n                : {}),\n            ...(entry.effectProfileProof\n                ? { effectProfileProof: entry.effectProfileProof }\n                : {})\n        })\n    }));\n    const wgsl = buildWgslSet(shaderEntries);\n    const wgslSelection = buildWgslSelectionMetadata(selection, selectedStages);\n    const permutationGraph = buildEffectPermutationGraph(resolved.effectRes);\n    const effectReflection = resolved.effectRes.m_version === 15\n        ? buildCompleteEffectReflection(\n            resolved.effectRes,\n            permutationGraph,\n            { sourceIdentity, sourcePath: source }\n        )\n        : null;\n    if (mode === \"all\" && !effectReflection)\n    {\n        throw new Error(\n            \"Effect package mode all requires complete version-15 source reflection\"\n        );\n    }\n\n    const backendBodySet = mode === \"all\"\n        ? buildEffectBackendBodySet(resolved.effectRes, permutationGraph, {\n            source,\n            selection,\n            bindingPolicy: options.bindingPolicy\n        })\n        : null;\n    const completeness = Object.freeze({\n        packageValid: true,\n        sourceComplete: effectReflection !== null,\n        backendComplete: false,\n        runtimeComplete: false\n    });\n    const info = {\n        format: \"CEWGPU\",\n        formatVersion: EFFECT_INFO_VERSION,\n        packageKind: \"tr2-effect-webgpu\",\n        sourcePath: source,\n        outputPath,\n        sourceIdentity,\n        targetBackend: WEBGPU_BACKEND_NAME,\n        backendPackage: FORMAT_WEBGPU_PACKAGE_NAME,\n        backendPackageVersion: FORMAT_WEBGPU_PACKAGE_VERSION,\n        translator: DXBC_WGSL_TRANSLATOR_NAME,\n        translatorVersion: DXBC_WGSL_TRANSLATOR_VERSION,\n        permutationGraph: Object.freeze({\n            chunk: EFFECT_PERMUTATION_GRAPH_CHUNK,\n            format: EFFECT_PERMUTATION_GRAPH_FORMAT,\n            formatVersion: EFFECT_PERMUTATION_GRAPH_VERSION,\n            sha256: sha256Utf8(`${JSON.stringify(permutationGraph)}\\n`),\n            permutationCount: permutationGraph.variants.length,\n            uniqueBodyCount: permutationGraph.bodies.length\n        }),\n        ...(effectReflection\n            ? {\n                effectReflection: effectReflection.pointer,\n                sourceBodyCoverage: \"all-unique\",\n                backendBodyCoverage: backendBodySet\n                    ? backendBodySet.coverage.bodies\n                    : \"selected\"\n            }\n            : {}),\n        ...(backendBodySet\n            ? {\n                backendBodySet: Object.freeze({\n                    chunk: EFFECT_BACKEND_BODY_SET_CHUNK,\n                    format: EFFECT_BACKEND_BODY_SET_FORMAT,\n                    formatVersion: EFFECT_BACKEND_BODY_SET_VERSION,\n                    sha256: sha256Utf8(`${JSON.stringify(backendBodySet)}\\n`),\n                    bodyCount: backendBodySet.bodyCount,\n                    translatedBodyCount: backendBodySet.translatedBodyCount,\n                    passUnitCount: backendBodySet.passUnitCount\n                })\n            }\n            : {}),\n        bodyMode: mode,\n        completeness,\n        stageCount: analysis.stages.length,\n        selectedStageCount: selectedStages.length,\n        shaderCount: wgsl.shaders.length,\n        layoutCount: wgsl.layouts.length\n    };\n    const metadata = {\n        effectName: analysis.effectName,\n        sourcePath: source,\n        bodyMode: mode,\n        bodyIndex: analysis.bodyIndex,\n        selectedOptions: analysis.selectedOptions,\n        ...(wgslSelection ? { wgslSelection } : {})\n    };\n    const bytes = buildPackage([\n        [ \"INFO\", info ],\n        [ \"META\", metadata ],\n        [ EFFECT_PERMUTATION_GRAPH_CHUNK, permutationGraph ],\n        ...(effectReflection ? [\n            [ EFFECT_REFLECTION_CHUNK, effectReflection.reflection ],\n            [ EFFECT_REFLECTION_BLOB_CHUNK, effectReflection.blobBytes ]\n        ] : []),\n        [ \"ANLS\", analysis ],\n        [ \"WGSL\", wgsl ],\n        ...(backendBodySet ? [ [ EFFECT_BACKEND_BODY_SET_CHUNK, backendBodySet ] ] : [])\n    ]);\n    const inspection = inspectWithValues(bytes, {\n        source,\n        emit: \"json\"\n    });\n    const qualification = Object.freeze({\n        ok: true,\n        level: \"structural\",\n        validator: \"cewgpu-structural\",\n        mode,\n        ...completeness,\n        selectedStageCount: selectedStages.length,\n        shaderCount: wgsl.shaders.length,\n        layoutCount: wgsl.layouts.length,\n        ...(backendBodySet\n            ? {\n                backendBodyCount: backendBodySet.bodyCount,\n                backendTranslatedBodyCount: backendBodySet.translatedBodyCount,\n                backendPassUnitCount: backendBodySet.passUnitCount\n            }\n            : {}),\n        nativeComparison: false\n    });\n\n    return Object.freeze({\n        bytes,\n        info: Object.freeze(info),\n        metadata: Object.freeze(metadata),\n        permutationGraph,\n        reflection: effectReflection?.reflection ?? null,\n        reflectionBlobs: effectReflection?.blobBytes ?? null,\n        analysis,\n        wgsl,\n        backendBodySet,\n        inspection: Object.freeze(inspection),\n        qualification\n    });\n}\n\nfunction normalizeMode(value, allPermutations)\n{\n    if (allPermutations !== undefined && typeof allPermutations !== \"boolean\")\n    {\n        throw new TypeError(\"Effect allPermutations compatibility option must be boolean\");\n    }\n\n    const mode = String(allPermutations === true ? \"all\" : value ?? \"selected\").trim();\n\n    if (mode !== \"selected\" && mode !== \"all\")\n    {\n        throw new Error(\n            `Effect package mode ${mode || \"<empty>\"} is not supported; `\n            + \"supported modes are selected and all\"\n        );\n    }\n\n    return mode;\n}\n\nfunction normalizeSource(value)\n{\n    const source = String(value ?? \"memory\").trim();\n\n    return source || \"memory\";\n}\n\nfunction normalizeOptionalString(value, name)\n{\n    if (value === undefined || value === null)\n    {\n        return null;\n    }\n\n    const result = String(value).trim();\n\n    if (!result)\n    {\n        throw new TypeError(`${name} must be a non-empty string or null`);\n    }\n\n    return result;\n}\n\nfunction normalizeSelection(value)\n{\n    if (value === undefined || value === null)\n    {\n        return null;\n    }\n\n    if (!value || typeof value !== \"object\" || Array.isArray(value))\n    {\n        throw new TypeError(\"Effect stage selection must be an object\");\n    }\n\n    const techniqueName = String(value.techniqueName ?? \"\").trim();\n    const passIndex = value.passIndex ?? null;\n    const stageNames = value.stageNames ?? [];\n\n    if (!techniqueName)\n    {\n        throw new TypeError(\"Effect stage selection requires techniqueName\");\n    }\n\n    if (passIndex !== null && (!Number.isSafeInteger(passIndex) || passIndex < 0))\n    {\n        throw new TypeError(\"Effect stage selection passIndex must be a non-negative integer or null\");\n    }\n\n    if (!Array.isArray(stageNames)\n        || stageNames.some((stageName) => ![ \"vertex\", \"pixel\", \"compute\" ].includes(stageName)))\n    {\n        throw new TypeError(\"Effect stage selection supports only vertex, pixel, and compute stageNames\");\n    }\n\n    if (stageNames.length && passIndex === null)\n    {\n        throw new TypeError(\"Effect stageNames require an exact passIndex\");\n    }\n\n    return Object.freeze({\n        techniqueName,\n        passIndex,\n        stageNames: Object.freeze([ ...new Set(stageNames) ])\n    });\n}\n\nfunction normalizeSourceIdentity(value, source, input)\n{\n    if (value !== undefined && value !== null\n        && (!value || typeof value !== \"object\" || Array.isArray(value)))\n    {\n        throw new TypeError(\"Effect sourceIdentity must be an object\");\n    }\n\n    const bytes = input instanceof Uint8Array\n        ? input\n        : input instanceof ArrayBuffer\n            ? new Uint8Array(input)\n            : ArrayBuffer.isView(input)\n                ? new Uint8Array(input.buffer, input.byteOffset, input.byteLength)\n                : null;\n\n    if (!bytes)\n    {\n        throw new TypeError(\"Effect input must be Uint8Array, ArrayBuffer, or ArrayBufferView bytes\");\n    }\n\n    const sha256 = sha256Bytes(bytes);\n    if (value?.sha256 !== undefined && value?.sha256 !== null\n        && value.sha256 !== sha256)\n    {\n        throw new Error(\n            \"Effect sourceIdentity.sha256 does not match the exact effect input bytes\"\n        );\n    }\n\n    return Object.freeze({\n        logicalPath: value?.logicalPath ?? source,\n        game: value?.game ?? null,\n        client: value?.client ?? null,\n        build: value?.build === undefined || value?.build === null ? null : String(value.build),\n        byteLength: bytes.byteLength,\n        md5: value?.md5 ?? null,\n        sha256\n    });\n}\n"],"names":["buildEffectPackage","input","options","mode","normalizeMode","allPermutations","source","normalizeSource","outputPath","normalizeOptionalString","sourceIdentity","normalizeSourceIdentity","permutation","normalizeEffectPermutation","selection","normalizeSelection","resolved","readEffectAnalysis","effectRes","m_version","Error","validateResolvedPermutation","selectedOptions","analysis","buildEffectAnalysis","decodeBytecode","decodeInstructions","bytecodeByKey","stageBytecodeByKey","selectedStages","selectEffectStages","stages","programsByKey","Map","programForKey","key","has","get","bytecode","bytes","length","program","lowerDxbcToIr","set","effectProfileContext","isParticleClearEffectCandidate","effectDescription","preflightParticleClearEffectProfile","irEntries","map","stage","passKey","techniqueName","passIndex","ir","semanticBindings","find","candidate","stageName","bindings","effectProfileProof","particleClearEffectProofFor","programsByPass","entry","push","resourceTransformPlans","Array","from","entries","buildResourceTransformPlan","layoutKey","plans","proof","resourceTransformPlan","buildWgslBindingPlan","bindingPolicy","shaderEntries","shader","buildWgsl","bindingPlan","wgsl","buildWgslSet","wgslSelection","buildWgslSelectionMetadata","permutationGraph","buildEffectPermutationGraph","effectReflection","buildCompleteEffectReflection","sourcePath","backendBodySet","buildEffectBackendBodySet","completeness","Object","freeze","packageValid","sourceComplete","backendComplete","runtimeComplete","info","format","formatVersion","EFFECT_INFO_VERSION","packageKind","targetBackend","WEBGPU_BACKEND_NAME","backendPackage","FORMAT_WEBGPU_PACKAGE_NAME","backendPackageVersion","FORMAT_WEBGPU_PACKAGE_VERSION","translator","DXBC_WGSL_TRANSLATOR_NAME","translatorVersion","DXBC_WGSL_TRANSLATOR_VERSION","chunk","EFFECT_PERMUTATION_GRAPH_CHUNK","EFFECT_PERMUTATION_GRAPH_FORMAT","EFFECT_PERMUTATION_GRAPH_VERSION","sha256","sha256Utf8","JSON","stringify","permutationCount","variants","uniqueBodyCount","bodies","pointer","sourceBodyCoverage","backendBodyCoverage","coverage","EFFECT_BACKEND_BODY_SET_CHUNK","EFFECT_BACKEND_BODY_SET_FORMAT","EFFECT_BACKEND_BODY_SET_VERSION","bodyCount","translatedBodyCount","passUnitCount","bodyMode","stageCount","selectedStageCount","shaderCount","shaders","layoutCount","layouts","metadata","effectName","bodyIndex","buildPackage","EFFECT_REFLECTION_CHUNK","reflection","EFFECT_REFLECTION_BLOB_CHUNK","blobBytes","inspection","inspectWithValues","qualification","ok","level","validator","backendBodyCount","backendTranslatedBodyCount","backendPassUnitCount","nativeComparison","reflectionBlobs","value","undefined","TypeError","String","trim","name","result","isArray","stageNames","Number","isSafeInteger","some","includes","Set","Uint8Array","ArrayBuffer","isView","buffer","byteOffset","byteLength","sha256Bytes","logicalPath","game","client","build","md5"],"mappings":"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"}

package/dist/formats/webgpu/core/packageEffectSelection.js

@@ -0,0 +1,164 @@
+const STAGE_NAMES = new Set(["vertex", "pixel", "compute"]);
+// Structurally valid DXBC stage kinds that the WGSL packager cannot lower yet:
+// there is no WGSL geometry/hull/domain stage. These fail closed as unsupported
+// rather than being misreported as malformed records.
+const KNOWN_UNSUPPORTED_STAGE_NAMES = new Set(["geometry", "hull", "domain"]);
+
+/**
+ * Normalize caller permutation assertions without coercing malformed values.
+ *
+ * @param {object[]|Map<string,string>|null|undefined} value Permutation assertions.
+ * @returns {object[]} Frozen NAME=VALUE assertion records.
+ */
+function normalizeEffectPermutation(value) {
+  if (value === undefined || value === null) {
+    return Object.freeze([]);
+  }
+  const entries = value instanceof Map ? Array.from(value, ([name, option]) => ({
+    name,
+    value: option
+  })) : value;
+  if (!Array.isArray(entries)) {
+    throw new TypeError("Effect permutation policy must be an array or Map");
+  }
+  return Object.freeze(entries.map(entry => {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry) || typeof entry.name !== "string" || !entry.name || typeof entry.value !== "string" || !entry.value) {
+      throw new TypeError("Requested effect permutation is malformed");
+    }
+    return Object.freeze({
+      name: entry.name,
+      value: entry.value
+    });
+  }));
+}
+
+/**
+ * Verify that every requested permutation resolved exactly.
+ *
+ * @param {object[]} requested Requested NAME=VALUE records.
+ * @param {object[]} selectedOptions Resolved effect option records.
+ * @returns {true} True when every request resolved exactly.
+ */
+function validateResolvedPermutation(requested, selectedOptions) {
+  if (!Array.isArray(requested) || !Array.isArray(selectedOptions)) {
+    throw new TypeError("Effect permutation validation requires requested and selected option arrays");
+  }
+  const requestedNames = new Set();
+  const selectedByName = new Map();
+  for (const entry of selectedOptions) {
+    if (typeof entry?.name !== "string" || !entry.name || selectedByName.has(entry.name)) {
+      throw new Error("Effect selectedOptions are malformed or duplicated");
+    }
+    selectedByName.set(entry.name, entry);
+  }
+  for (const entry of requested) {
+    if (typeof entry?.name !== "string" || !entry.name || typeof entry.value !== "string" || !entry.value) {
+      throw new Error("Requested effect permutation is malformed");
+    }
+    if (requestedNames.has(entry.name)) {
+      throw new Error(`Requested effect permutation duplicates axis ${entry.name}`);
+    }
+    requestedNames.add(entry.name);
+    const resolved = selectedByName.get(entry.name);
+    if (!resolved) {
+      throw new Error(`Unknown effect permutation axis ${entry.name}`);
+    }
+    if (resolved.value !== entry.value) {
+      throw new Error(`Effect permutation ${entry.name} requested ${entry.value} but resolved ${resolved.value}`);
+    }
+  }
+  return true;
+}
+function validateStageRecords(stages) {
+  if (!Array.isArray(stages)) {
+    throw new TypeError("Effect analysis stages must be an array");
+  }
+  const keys = new Set();
+  for (const [index, stage] of stages.entries()) {
+    const expected = `${stage?.techniqueName}.pass${stage?.passIndex}.${stage?.stageName}`;
+    if (!stage || typeof stage.techniqueName !== "string" || !stage.techniqueName || !Number.isInteger(stage.passIndex) || stage.passIndex < 0 || stage.key !== expected) {
+      throw new Error(`Effect analysis stage ${index} is malformed`);
+    }
+    if (!STAGE_NAMES.has(stage.stageName)) {
+      if (KNOWN_UNSUPPORTED_STAGE_NAMES.has(stage.stageName)) {
+        throw new Error(`WGSL effect stage ${expected} kind ${stage.stageName} is not supported`);
+      }
+      throw new Error(`Effect analysis stage ${index} is malformed`);
+    }
+    if (keys.has(stage.key)) {
+      throw new Error(`Effect analysis contains duplicate stage ${stage.key}`);
+    }
+    keys.add(stage.key);
+  }
+  const stagesByPass = new Map();
+  for (const stage of stages) {
+    const passKey = `${stage.techniqueName}.pass${stage.passIndex}`;
+    if (!stagesByPass.has(passKey)) stagesByPass.set(passKey, []);
+    stagesByPass.get(passKey).push(stage.stageName);
+  }
+  for (const [passKey, stageNames] of stagesByPass) {
+    if (stageNames.includes("compute") && (stageNames.length !== 1 || stageNames[0] !== "compute")) {
+      throw new Error(`WGSL effect pass ${passKey} cannot mix compute and render stages`);
+    }
+  }
+}
+
+/**
+ * Select complete analysis stages for WGSL emission.
+ *
+ * @param {object[]} stages Complete analysis stage list.
+ * @param {object|null} selection Optional technique/pass/stage assertion.
+ * @returns {object[]} Selected stage records in analysis order.
+ */
+function selectEffectStages(stages, selection) {
+  validateStageRecords(stages);
+  if (!selection) {
+    return stages.slice();
+  }
+  const techniqueName = String(selection.techniqueName ?? "");
+  const passIndex = selection.passIndex ?? null;
+  const stageNames = Array.isArray(selection.stageNames) ? selection.stageNames : [];
+  const techniqueStages = stages.filter(stage => stage.techniqueName === techniqueName);
+  if (!techniqueStages.length) {
+    throw new Error(`Unknown effect technique ${techniqueName}`);
+  }
+  const selected = passIndex === null ? techniqueStages : techniqueStages.filter(stage => stage.passIndex === passIndex);
+  if (!selected.length) {
+    throw new Error(`Unknown effect pass ${techniqueName}.pass${passIndex}`);
+  }
+  if (stageNames.length) {
+    const requested = new Set(stageNames);
+    const actual = new Set(selected.map(stage => stage.stageName));
+    const missing = stageNames.filter(stageName => !actual.has(stageName));
+    const unexpected = Array.from(actual).filter(stageName => !requested.has(stageName));
+    if (missing.length || unexpected.length) {
+      throw new Error(`Stage assertion for ${techniqueName}.pass${passIndex} is incomplete: ` + `missing ${missing.join(",") || "none"}; unlisted ${unexpected.join(",") || "none"}`);
+    }
+  }
+  return selected;
+}
+
+/**
+ * Build explicit selection provenance for CEWGPU metadata.
+ *
+ * @param {object|null} selection Optional technique/pass/stage assertion.
+ * @param {object[]} selectedStages Selected analysis stage records.
+ * @returns {object|null} Selection metadata.
+ */
+function buildWgslSelectionMetadata(selection, selectedStages) {
+  if (!selection) {
+    return null;
+  }
+  const selectedStageNames = Array.from(new Set(selectedStages.map(stage => stage.stageName)));
+  return {
+    mode: "explicit",
+    completePasses: true,
+    techniqueName: selection.techniqueName,
+    passIndex: selection.passIndex ?? null,
+    requestedStageNames: selection.stageNames?.length ? selectedStageNames : [],
+    selectedStageKeys: selectedStages.map(stage => stage.key)
+  };
+}
+
+export { buildWgslSelectionMetadata, normalizeEffectPermutation, selectEffectStages, validateResolvedPermutation };
+//# sourceMappingURL=packageEffectSelection.js.map

package/dist/formats/webgpu/core/packageEffectSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageEffectSelection.js","sources":["../../../../../src/formats/webgpu/core/packageEffectSelection.js"],"sourcesContent":["const STAGE_NAMES = new Set([ \"vertex\", \"pixel\", \"compute\" ]);\n// Structurally valid DXBC stage kinds that the WGSL packager cannot lower yet:\n// there is no WGSL geometry/hull/domain stage. These fail closed as unsupported\n// rather than being misreported as malformed records.\nconst KNOWN_UNSUPPORTED_STAGE_NAMES = new Set([ \"geometry\", \"hull\", \"domain\" ]);\n\n/**\n * Normalize caller permutation assertions without coercing malformed values.\n *\n * @param {object[]|Map<string,string>|null|undefined} value Permutation assertions.\n * @returns {object[]} Frozen NAME=VALUE assertion records.\n */\nexport function normalizeEffectPermutation(value)\n{\n    if (value === undefined || value === null)\n    {\n        return Object.freeze([]);\n    }\n\n    const entries = value instanceof Map\n        ? Array.from(value, ([ name, option ]) => ({ name, value: option }))\n        : value;\n\n    if (!Array.isArray(entries))\n    {\n        throw new TypeError(\"Effect permutation policy must be an array or Map\");\n    }\n\n    return Object.freeze(entries.map((entry) =>\n    {\n        if (!entry || typeof entry !== \"object\" || Array.isArray(entry)\n            || typeof entry.name !== \"string\" || !entry.name\n            || typeof entry.value !== \"string\" || !entry.value)\n        {\n            throw new TypeError(\"Requested effect permutation is malformed\");\n        }\n\n        return Object.freeze({\n            name: entry.name,\n            value: entry.value\n        });\n    }));\n}\n\n/**\n * Verify that every requested permutation resolved exactly.\n *\n * @param {object[]} requested Requested NAME=VALUE records.\n * @param {object[]} selectedOptions Resolved effect option records.\n * @returns {true} True when every request resolved exactly.\n */\nexport function validateResolvedPermutation(requested, selectedOptions)\n{\n    if (!Array.isArray(requested) || !Array.isArray(selectedOptions))\n    {\n        throw new TypeError(\"Effect permutation validation requires requested and selected option arrays\");\n    }\n\n    const requestedNames = new Set();\n    const selectedByName = new Map();\n\n    for (const entry of selectedOptions)\n    {\n        if (typeof entry?.name !== \"string\" || !entry.name || selectedByName.has(entry.name))\n        {\n            throw new Error(\"Effect selectedOptions are malformed or duplicated\");\n        }\n\n        selectedByName.set(entry.name, entry);\n    }\n\n    for (const entry of requested)\n    {\n        if (typeof entry?.name !== \"string\" || !entry.name\n            || typeof entry.value !== \"string\" || !entry.value)\n        {\n            throw new Error(\"Requested effect permutation is malformed\");\n        }\n\n        if (requestedNames.has(entry.name))\n        {\n            throw new Error(`Requested effect permutation duplicates axis ${entry.name}`);\n        }\n\n        requestedNames.add(entry.name);\n        const resolved = selectedByName.get(entry.name);\n\n        if (!resolved)\n        {\n            throw new Error(`Unknown effect permutation axis ${entry.name}`);\n        }\n\n        if (resolved.value !== entry.value)\n        {\n            throw new Error(\n                `Effect permutation ${entry.name} requested ${entry.value} but resolved ${resolved.value}`\n            );\n        }\n    }\n\n    return true;\n}\n\nfunction validateStageRecords(stages)\n{\n    if (!Array.isArray(stages))\n    {\n        throw new TypeError(\"Effect analysis stages must be an array\");\n    }\n\n    const keys = new Set();\n\n    for (const [ index, stage ] of stages.entries())\n    {\n        const expected = `${stage?.techniqueName}.pass${stage?.passIndex}.${stage?.stageName}`;\n\n        if (!stage || typeof stage.techniqueName !== \"string\" || !stage.techniqueName\n            || !Number.isInteger(stage.passIndex) || stage.passIndex < 0\n            || stage.key !== expected)\n        {\n            throw new Error(`Effect analysis stage ${index} is malformed`);\n        }\n\n        if (!STAGE_NAMES.has(stage.stageName))\n        {\n            if (KNOWN_UNSUPPORTED_STAGE_NAMES.has(stage.stageName))\n            {\n                throw new Error(\n                    `WGSL effect stage ${expected} kind ${stage.stageName} is not supported`\n                );\n            }\n\n            throw new Error(`Effect analysis stage ${index} is malformed`);\n        }\n\n        if (keys.has(stage.key))\n        {\n            throw new Error(`Effect analysis contains duplicate stage ${stage.key}`);\n        }\n\n        keys.add(stage.key);\n    }\n\n    const stagesByPass = new Map();\n    for (const stage of stages)\n    {\n        const passKey = `${stage.techniqueName}.pass${stage.passIndex}`;\n        if (!stagesByPass.has(passKey)) stagesByPass.set(passKey, []);\n        stagesByPass.get(passKey).push(stage.stageName);\n    }\n    for (const [ passKey, stageNames ] of stagesByPass)\n    {\n        if (stageNames.includes(\"compute\")\n            && (stageNames.length !== 1 || stageNames[0] !== \"compute\"))\n        {\n            throw new Error(`WGSL effect pass ${passKey} cannot mix compute and render stages`);\n        }\n    }\n}\n\n/**\n * Select complete analysis stages for WGSL emission.\n *\n * @param {object[]} stages Complete analysis stage list.\n * @param {object|null} selection Optional technique/pass/stage assertion.\n * @returns {object[]} Selected stage records in analysis order.\n */\nexport function selectEffectStages(stages, selection)\n{\n    validateStageRecords(stages);\n\n    if (!selection)\n    {\n        return stages.slice();\n    }\n\n    const techniqueName = String(selection.techniqueName ?? \"\");\n    const passIndex = selection.passIndex ?? null;\n    const stageNames = Array.isArray(selection.stageNames) ? selection.stageNames : [];\n    const techniqueStages = stages.filter((stage) => stage.techniqueName === techniqueName);\n\n    if (!techniqueStages.length)\n    {\n        throw new Error(`Unknown effect technique ${techniqueName}`);\n    }\n\n    const selected = passIndex === null\n        ? techniqueStages\n        : techniqueStages.filter((stage) => stage.passIndex === passIndex);\n\n    if (!selected.length)\n    {\n        throw new Error(`Unknown effect pass ${techniqueName}.pass${passIndex}`);\n    }\n\n    if (stageNames.length)\n    {\n        const requested = new Set(stageNames);\n        const actual = new Set(selected.map((stage) => stage.stageName));\n        const missing = stageNames.filter((stageName) => !actual.has(stageName));\n        const unexpected = Array.from(actual).filter((stageName) => !requested.has(stageName));\n\n        if (missing.length || unexpected.length)\n        {\n            throw new Error(\n                `Stage assertion for ${techniqueName}.pass${passIndex} is incomplete: `\n                + `missing ${missing.join(\",\") || \"none\"}; unlisted ${unexpected.join(\",\") || \"none\"}`\n            );\n        }\n    }\n\n    return selected;\n}\n\n/**\n * Build explicit selection provenance for CEWGPU metadata.\n *\n * @param {object|null} selection Optional technique/pass/stage assertion.\n * @param {object[]} selectedStages Selected analysis stage records.\n * @returns {object|null} Selection metadata.\n */\nexport function buildWgslSelectionMetadata(selection, selectedStages)\n{\n    if (!selection)\n    {\n        return null;\n    }\n\n    const selectedStageNames = Array.from(new Set(selectedStages.map((stage) => stage.stageName)));\n\n    return {\n        mode: \"explicit\",\n        completePasses: true,\n        techniqueName: selection.techniqueName,\n        passIndex: selection.passIndex ?? null,\n        requestedStageNames: selection.stageNames?.length ? selectedStageNames : [],\n        selectedStageKeys: selectedStages.map((stage) => stage.key)\n    };\n}\n"],"names":["STAGE_NAMES","Set","KNOWN_UNSUPPORTED_STAGE_NAMES","normalizeEffectPermutation","value","undefined","Object","freeze","entries","Map","Array","from","name","option","isArray","TypeError","map","entry","validateResolvedPermutation","requested","selectedOptions","requestedNames","selectedByName","has","Error","set","add","resolved","get","validateStageRecords","stages","keys","index","stage","expected","techniqueName","passIndex","stageName","Number","isInteger","key","stagesByPass","passKey","push","stageNames","includes","length","selectEffectStages","selection","slice","String","techniqueStages","filter","selected","actual","missing","unexpected","join","buildWgslSelectionMetadata","selectedStages","selectedStageNames","mode","completePasses","requestedStageNames","selectedStageKeys"],"mappings":"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"}

package/dist/formats/webgpu/core/packageMetadata.js

@@ -0,0 +1,8 @@
+const FORMAT_WEBGPU_PACKAGE_NAME = "@carbonenginejs/runtime-resource/formats/webgpu";
+const FORMAT_WEBGPU_PACKAGE_VERSION = "0.11.1";
+const WEBGPU_BACKEND_NAME = "webgpu";
+const DXBC_WGSL_TRANSLATOR_NAME = "dxbc-js-wgsl";
+const DXBC_WGSL_TRANSLATOR_VERSION = FORMAT_WEBGPU_PACKAGE_VERSION;
+
+export { DXBC_WGSL_TRANSLATOR_NAME, DXBC_WGSL_TRANSLATOR_VERSION, FORMAT_WEBGPU_PACKAGE_NAME, FORMAT_WEBGPU_PACKAGE_VERSION, WEBGPU_BACKEND_NAME };
+//# sourceMappingURL=packageMetadata.js.map

package/dist/formats/webgpu/core/packageMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageMetadata.js","sources":["../../../../../src/formats/webgpu/core/packageMetadata.js"],"sourcesContent":["export const FORMAT_WEBGPU_PACKAGE_NAME = \"@carbonenginejs/runtime-resource/formats/webgpu\";\nexport const FORMAT_WEBGPU_PACKAGE_VERSION = \"0.11.1\";\nexport const WEBGPU_BACKEND_NAME = \"webgpu\";\nexport const DXBC_WGSL_TRANSLATOR_NAME = \"dxbc-js-wgsl\";\nexport const DXBC_WGSL_TRANSLATOR_VERSION = FORMAT_WEBGPU_PACKAGE_VERSION;\n"],"names":["FORMAT_WEBGPU_PACKAGE_NAME","FORMAT_WEBGPU_PACKAGE_VERSION","WEBGPU_BACKEND_NAME","DXBC_WGSL_TRANSLATOR_NAME","DXBC_WGSL_TRANSLATOR_VERSION"],"mappings":"AAAO,MAAMA,0BAA0B,GAAG;AACnC,MAAMC,6BAA6B,GAAG;AACtC,MAAMC,mBAAmB,GAAG;AAC5B,MAAMC,yBAAyB,GAAG;AAClC,MAAMC,4BAA4B,GAAGH;;;;"}

package/dist/formats/webgpu/core/schema.js

@@ -0,0 +1,4 @@
+const CLASS_KEYS = Object.freeze(["Package", "Resource", "Buffer", "Texture", "ShaderModule", "Pipeline", "BindGroup", "Sampler"]);
+
+export { CLASS_KEYS };
+//# sourceMappingURL=schema.js.map

package/dist/formats/webgpu/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../../../../src/formats/webgpu/core/schema.js"],"sourcesContent":["export const CLASS_KEYS = Object.freeze([\n    \"Package\",\n    \"Resource\",\n    \"Buffer\",\n    \"Texture\",\n    \"ShaderModule\",\n    \"Pipeline\",\n    \"BindGroup\",\n    \"Sampler\"\n]);\n"],"names":["CLASS_KEYS","Object","freeze"],"mappings":"AAAO,MAAMA,UAAU,GAAGC,MAAM,CAACC,MAAM,CAAC,CACpC,SAAS,EACT,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,UAAU,EACV,WAAW,EACX,SAAS,CACZ;;;;"}