@carbonenginejs/runtime-resource 0.13.0 → 0.15.0

package/dist/formats/webgpu/core/wgsl/particleEmitSemanticDigest.js

@@ -1,110 +1,110 @@
-import { sha256Utf8 } from '../../../../format/effect/sha256.js';
-
-function encodeString(value, parts) {
-  parts.push("s", `${value.length}`, ":", value, ";");
-}
-function propertyKeyRecord(key) {
-  if (typeof key === "string") return `s${key.length}:${key}`;
-  return `y${String(key).length}:${String(key)}`;
-}
-function objectKind(value) {
-  if (Array.isArray(value)) return "array";
-  const prototype = Object.getPrototypeOf(value);
-  if (prototype === Object.prototype) return "object";
-  if (prototype === null) return "null-prototype";
-  return "foreign-prototype";
-}
-function encodeDescriptor(descriptor, parts, seen, transform = null) {
-  if (!descriptor) {
-    parts.push("missing;");
-    return;
-  }
-  if (!Object.hasOwn(descriptor, "value")) {
-    parts.push("accessor;");
-    return;
-  }
-  parts.push("data:");
-  if (transform) transform(descriptor.value, parts, seen);else encodeValue(descriptor.value, parts, seen);
-}
-function sortedKeys(value, omitted = null) {
-  return Reflect.ownKeys(value).filter(key => !omitted?.has(key)).map(key => ({
-    key,
-    record: propertyKeyRecord(key)
-  })).sort((left, right) => left.record < right.record ? -1 : left.record > right.record ? 1 : 0);
-}
-function encodeObject(value, parts, seen, omitted = null, transformProperty = null) {
-  if (seen.has(value)) {
-    throw new TypeError("Exact semantic records must be acyclic");
-  }
-  seen.add(value);
-  const kind = objectKind(value);
-  parts.push("o", `${kind.length}`, ":", kind, "{");
-  const keys = sortedKeys(value, omitted);
-  parts.push(`${keys.length}`, ":");
-  for (const {
-    key,
-    record
-  } of keys) {
-    parts.push("k", record, "=");
-    const descriptor = Object.getOwnPropertyDescriptor(value, key);
-    const transform = transformProperty ? transformProperty(key) : null;
-    encodeDescriptor(descriptor, parts, seen, transform);
-  }
-  parts.push("}");
-  seen.delete(value);
-}
-function encodeValue(value, parts, seen) {
-  if (value === undefined) parts.push("undefined;");else if (value === null) parts.push("null;");else if (typeof value === "boolean") {
-    parts.push(value ? "boolean:true;" : "boolean:false;");
-  } else if (typeof value === "number") {
-    if (Number.isNaN(value)) parts.push("number:NaN;");else if (Object.is(value, -0)) parts.push("number:-0;");else if (value === Number.POSITIVE_INFINITY) {
-      parts.push("number:+Infinity;");
-    } else if (value === Number.NEGATIVE_INFINITY) {
-      parts.push("number:-Infinity;");
-    } else parts.push("number:", `${value}`, ";");
-  } else if (typeof value === "string") encodeString(value, parts);else if (typeof value === "bigint") {
-    parts.push("bigint:", value.toString(), ";");
-  } else if (typeof value === "symbol") {
-    parts.push("symbol:", propertyKeyRecord(value), ";");
-  } else if (typeof value === "function") parts.push("function;");else encodeObject(value, parts, seen);
-}
-function encodeInstruction(instruction, parts, seen) {
-  if (!instruction || typeof instruction !== "object") {
-    encodeValue(instruction, parts, seen);
-    return;
-  }
-  encodeObject(instruction, parts, seen, new Set(["dataflow", "typeInfo"]));
-}
-function instructionTransform(key) {
-  return typeof key === "string" && /^\d+$/u.test(key) ? encodeInstruction : null;
-}
-function encodeInstructions(value, parts, seen) {
-  if (!Array.isArray(value)) {
-    encodeValue(value, parts, seen);
-    return;
-  }
-  encodeObject(value, parts, seen, null, instructionTransform);
-}
-
-/**
- * Produces the lossless semantic digest used only by the particle-emitter
- * exact profile. Source labels and derived CFG/SSA/type annotations are
- * deliberately excluded.
- *
- * @param {object} program CJS shader IR candidate.
- * @returns {string} Lower-case SHA-256 digest.
- */
-function particleEmitSemanticDigest(program) {
-  const parts = ["particle-emit-semantic-profile:1{"];
-  const seen = new WeakSet();
-  if (!program || typeof program !== "object") {
-    encodeValue(program, parts, seen);
-  } else {
-    encodeObject(program, parts, seen, new Set(["source", "blocks", "controlFlow", "values"]), key => key === "instructions" ? encodeInstructions : null);
-  }
-  parts.push("}");
-  return sha256Utf8(parts.join(""));
-}
-
-export { particleEmitSemanticDigest, sha256Utf8 };
-//# sourceMappingURL=particleEmitSemanticDigest.js.map
+import { sha256Utf8 } from '../../../../format/effect/sha256.js';
+
+function encodeString(value, parts) {
+  parts.push("s", `${value.length}`, ":", value, ";");
+}
+function propertyKeyRecord(key) {
+  if (typeof key === "string") return `s${key.length}:${key}`;
+  return `y${String(key).length}:${String(key)}`;
+}
+function objectKind(value) {
+  if (Array.isArray(value)) return "array";
+  const prototype = Object.getPrototypeOf(value);
+  if (prototype === Object.prototype) return "object";
+  if (prototype === null) return "null-prototype";
+  return "foreign-prototype";
+}
+function encodeDescriptor(descriptor, parts, seen, transform = null) {
+  if (!descriptor) {
+    parts.push("missing;");
+    return;
+  }
+  if (!Object.hasOwn(descriptor, "value")) {
+    parts.push("accessor;");
+    return;
+  }
+  parts.push("data:");
+  if (transform) transform(descriptor.value, parts, seen);else encodeValue(descriptor.value, parts, seen);
+}
+function sortedKeys(value, omitted = null) {
+  return Reflect.ownKeys(value).filter(key => !omitted?.has(key)).map(key => ({
+    key,
+    record: propertyKeyRecord(key)
+  })).sort((left, right) => left.record < right.record ? -1 : left.record > right.record ? 1 : 0);
+}
+function encodeObject(value, parts, seen, omitted = null, transformProperty = null) {
+  if (seen.has(value)) {
+    throw new TypeError("Exact semantic records must be acyclic");
+  }
+  seen.add(value);
+  const kind = objectKind(value);
+  parts.push("o", `${kind.length}`, ":", kind, "{");
+  const keys = sortedKeys(value, omitted);
+  parts.push(`${keys.length}`, ":");
+  for (const {
+    key,
+    record
+  } of keys) {
+    parts.push("k", record, "=");
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    const transform = transformProperty ? transformProperty(key) : null;
+    encodeDescriptor(descriptor, parts, seen, transform);
+  }
+  parts.push("}");
+  seen.delete(value);
+}
+function encodeValue(value, parts, seen) {
+  if (value === undefined) parts.push("undefined;");else if (value === null) parts.push("null;");else if (typeof value === "boolean") {
+    parts.push(value ? "boolean:true;" : "boolean:false;");
+  } else if (typeof value === "number") {
+    if (Number.isNaN(value)) parts.push("number:NaN;");else if (Object.is(value, -0)) parts.push("number:-0;");else if (value === Number.POSITIVE_INFINITY) {
+      parts.push("number:+Infinity;");
+    } else if (value === Number.NEGATIVE_INFINITY) {
+      parts.push("number:-Infinity;");
+    } else parts.push("number:", `${value}`, ";");
+  } else if (typeof value === "string") encodeString(value, parts);else if (typeof value === "bigint") {
+    parts.push("bigint:", value.toString(), ";");
+  } else if (typeof value === "symbol") {
+    parts.push("symbol:", propertyKeyRecord(value), ";");
+  } else if (typeof value === "function") parts.push("function;");else encodeObject(value, parts, seen);
+}
+function encodeInstruction(instruction, parts, seen) {
+  if (!instruction || typeof instruction !== "object") {
+    encodeValue(instruction, parts, seen);
+    return;
+  }
+  encodeObject(instruction, parts, seen, new Set(["dataflow", "typeInfo"]));
+}
+function instructionTransform(key) {
+  return typeof key === "string" && /^\d+$/u.test(key) ? encodeInstruction : null;
+}
+function encodeInstructions(value, parts, seen) {
+  if (!Array.isArray(value)) {
+    encodeValue(value, parts, seen);
+    return;
+  }
+  encodeObject(value, parts, seen, null, instructionTransform);
+}
+
+/**
+ * Produces the lossless semantic digest used only by the particle-emitter
+ * exact profile. Source labels and derived CFG/SSA/type annotations are
+ * deliberately excluded.
+ *
+ * @param {object} program CJS shader IR candidate.
+ * @returns {string} Lower-case SHA-256 digest.
+ */
+function particleEmitSemanticDigest(program) {
+  const parts = ["particle-emit-semantic-profile:1{"];
+  const seen = new WeakSet();
+  if (!program || typeof program !== "object") {
+    encodeValue(program, parts, seen);
+  } else {
+    encodeObject(program, parts, seen, new Set(["source", "blocks", "controlFlow", "values"]), key => key === "instructions" ? encodeInstructions : null);
+  }
+  parts.push("}");
+  return sha256Utf8(parts.join(""));
+}
+
+export { particleEmitSemanticDigest, sha256Utf8 };
+//# sourceMappingURL=particleEmitSemanticDigest.js.map

package/dist/formats/webgpu/core/wgsl/precisionControls.js

@@ -1,55 +1,55 @@
-const COMPONENT_MASK = /^x?y?z?w?$/u;
-const REFACTORING_ALLOWED = 1 << 11;
-function fail(stage, instruction, message) {
-  throw new Error(`WGSL ${stage} instruction ${instruction.index} precise ${instruction.opcodeName} ${message}`);
-}
-
-/**
- * Requires the DXBC shader to opt into refactoring. Without the global flag,
- * DXBC defines every operation as precise, which portable WGSL cannot promise.
- *
- * @param {object} program CJS shader IR.
- * @param {string} stage Diagnostic stage label.
- */
-function requireRefactoringAllowed(program, stage) {
-  const declarations = program.declarations.filter(entry => entry.opcodeName === "dcl_global_flags");
-  if (declarations.length !== 1) {
-    throw new Error(`WGSL ${stage} shader requires exactly one dcl_global_flags declaration`);
-  }
-  const data = declarations[0].data;
-  if (!Number.isInteger(data?.globalFlags) || data.globalFlags < 0 || typeof data.refactoringAllowed !== "boolean" || data.refactoringAllowed !== ((data.globalFlags & REFACTORING_ALLOWED) !== 0)) {
-    throw new Error(`WGSL ${stage} shader has inconsistent dcl_global_flags metadata`);
-  }
-  if (!data.refactoringAllowed) {
-    throw new Error(`WGSL ${stage} shader disables refactoring globally; exact lowering is not representable in WGSL`);
-  }
-}
-
-/**
- * Validates precise-mask metadata only. ADAPTED CONTRACT (requester decision,
- * 2026-07-20): DXBC `precise` operations are accepted and lowered as ordinary
- * IEEE float math, and the vertex position output is emitted `@invariant`.
- * WGSL has no general no-contraction control, so bit-exact parity with native
- * D3D11 arithmetic is NOT promised; `@invariant` instead guarantees identical
- * position results across the pipelines built from the same emitted WGSL,
- * which is the multi-pass invariance `precise` protects in these shaders.
- * See docs/reference/wgsl-compatibility.md ("precise" entry) before changing
- * this.
- *
- * @param {object} instruction Typed CJS shader IR instruction.
- * @param {string} stage Diagnostic stage label.
- */
-function validatePreciseInstruction(instruction, stage) {
-  const mask = instruction.preciseMask;
-  if (typeof mask !== "string" || !COMPONENT_MASK.test(mask)) {
-    fail(stage, instruction, `has malformed component mask ${String(mask)}`);
-  }
-  if (!mask) return;
-  const writes = instruction.dataflow?.writes || [];
-  if (!writes.length || Array.from(mask).some(component => !writes.some(write => write.mask.includes(component)))) {
-    fail(stage, instruction, `mask ${mask} requires a destination write containing every precise lane`);
-  }
-}
-
-export { requireRefactoringAllowed, validatePreciseInstruction };
-//# sourceMappingURL=precisionControls.js.map
+const COMPONENT_MASK = /^x?y?z?w?$/u;
+const REFACTORING_ALLOWED = 1 << 11;
+function fail(stage, instruction, message) {
+  throw new Error(`WGSL ${stage} instruction ${instruction.index} precise ${instruction.opcodeName} ${message}`);
+}
+
+/**
+ * Requires the DXBC shader to opt into refactoring. Without the global flag,
+ * DXBC defines every operation as precise, which portable WGSL cannot promise.
+ *
+ * @param {object} program CJS shader IR.
+ * @param {string} stage Diagnostic stage label.
+ */
+function requireRefactoringAllowed(program, stage) {
+  const declarations = program.declarations.filter(entry => entry.opcodeName === "dcl_global_flags");
+  if (declarations.length !== 1) {
+    throw new Error(`WGSL ${stage} shader requires exactly one dcl_global_flags declaration`);
+  }
+  const data = declarations[0].data;
+  if (!Number.isInteger(data?.globalFlags) || data.globalFlags < 0 || typeof data.refactoringAllowed !== "boolean" || data.refactoringAllowed !== ((data.globalFlags & REFACTORING_ALLOWED) !== 0)) {
+    throw new Error(`WGSL ${stage} shader has inconsistent dcl_global_flags metadata`);
+  }
+  if (!data.refactoringAllowed) {
+    throw new Error(`WGSL ${stage} shader disables refactoring globally; exact lowering is not representable in WGSL`);
+  }
+}
+
+/**
+ * Validates precise-mask metadata only. ADAPTED CONTRACT (requester decision,
+ * 2026-07-20): DXBC `precise` operations are accepted and lowered as ordinary
+ * IEEE float math, and the vertex position output is emitted `@invariant`.
+ * WGSL has no general no-contraction control, so bit-exact parity with native
+ * D3D11 arithmetic is NOT promised; `@invariant` instead guarantees identical
+ * position results across the pipelines built from the same emitted WGSL,
+ * which is the multi-pass invariance `precise` protects in these shaders.
+ * See docs/reference/wgsl-compatibility.md ("precise" entry) before changing
+ * this.
+ *
+ * @param {object} instruction Typed CJS shader IR instruction.
+ * @param {string} stage Diagnostic stage label.
+ */
+function validatePreciseInstruction(instruction, stage) {
+  const mask = instruction.preciseMask;
+  if (typeof mask !== "string" || !COMPONENT_MASK.test(mask)) {
+    fail(stage, instruction, `has malformed component mask ${String(mask)}`);
+  }
+  if (!mask) return;
+  const writes = instruction.dataflow?.writes || [];
+  if (!writes.length || Array.from(mask).some(component => !writes.some(write => write.mask.includes(component)))) {
+    fail(stage, instruction, `mask ${mask} requires a destination write containing every precise lane`);
+  }
+}
+
+export { requireRefactoringAllowed, validatePreciseInstruction };
+//# sourceMappingURL=precisionControls.js.map