@carbonenginejs/runtime-resource 0.13.0 → 0.14.0

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

@@ -1,164 +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 Carbon WebGPU 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
+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 Carbon WebGPU 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/packageMetadata.js

@@ -1,17 +1,17 @@
-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;
-
-/**
- * Version of the `INFO`-shaped summary the package reports.
- *
- * The summary is now a **derived view** rather than a stored chunk, so this
- * versions what callers receive, not what is on the wire. Nothing in the
- * container carries it.
- */
-const EFFECT_INFO_VERSION = 3;
-
-export { DXBC_WGSL_TRANSLATOR_NAME, DXBC_WGSL_TRANSLATOR_VERSION, EFFECT_INFO_VERSION, FORMAT_WEBGPU_PACKAGE_NAME, FORMAT_WEBGPU_PACKAGE_VERSION, WEBGPU_BACKEND_NAME };
-//# sourceMappingURL=packageMetadata.js.map
+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;
+
+/**
+ * Version of the `INFO`-shaped summary the package reports.
+ *
+ * The summary is now a **derived view** rather than a stored chunk, so this
+ * versions what callers receive, not what is on the wire. Nothing in the
+ * container carries it.
+ */
+const EFFECT_INFO_VERSION = 3;
+
+export { DXBC_WGSL_TRANSLATOR_NAME, DXBC_WGSL_TRANSLATOR_VERSION, EFFECT_INFO_VERSION, FORMAT_WEBGPU_PACKAGE_NAME, FORMAT_WEBGPU_PACKAGE_VERSION, WEBGPU_BACKEND_NAME };
+//# sourceMappingURL=packageMetadata.js.map

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

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