@forgeax/engine-geometry 0.1.33 → 0.1.34

package/README.md

@@ -33,6 +33,12 @@ forgeax-engine. A **leaf** package: depends on `@forgeax/engine-ecs` (`Result`),
   structured `.detail.field/.value/.reason`. No silent fallback, no `console.warn`,
   no `null` return (charter P3).
 
+The canonical vertex layout is interned by its finite attribute-presence mask.
+Mesh maps and packed masks resolve to the same deeply frozen projection; changing
+an authoring map's attributes derives a different mask without retaining the map
+or its buffers. Layout offsets, formats, and digests still derive from the one
+canonical attribute schema.
+
 ## MeshBuilder
 
 `MeshBuilder` is the incremental authoring owner for custom geometry. Append

package/dist/index.mjs

@@ -400,23 +400,26 @@ function fnv1a(input) {
   }
   return `vlp-v1-${(hash >>> 0).toString(16).padStart(8, "0")}`;
 }
+var layoutsByMask = /* @__PURE__ */ new Map();
 function deriveVertexLayoutProjection(map) {
+  let mask = 0;
+  for (let index = 0; index < CANONICAL_KEYS.length; index += 1) {
+    const key = CANONICAL_KEYS[index];
+    if (key !== void 0 && map[key] !== void 0) mask |= 1 << index;
+  }
+  return layoutFromMask(mask);
+}
+function layoutFromMask(mask) {
+  const cached = layoutsByMask.get(mask);
+  if (cached !== void 0) return cached;
   const attributes = [];
   let offset = 0;
-  let mask = 0;
-  for (const key of CANONICAL_KEYS) {
-    const value = map[key];
-    if (value === void 0) continue;
+  for (let index = 0; index < CANONICAL_KEYS.length; index += 1) {
+    const key = CANONICAL_KEYS[index];
+    if (key === void 0 || (mask & 1 << index) === 0) continue;
     const format = ATTRIBUTE_FORMAT_MAP[key];
     const byteLength = bytesForFormat(format);
-    attributes.push({
-      key,
-      shaderLocation: CANONICAL_KEYS.indexOf(key),
-      offset,
-      format,
-      byteLength
-    });
-    mask |= 1 << CANONICAL_KEYS.indexOf(key);
+    attributes.push(Object.freeze({ key, shaderLocation: index, offset, format, byteLength }));
     offset += byteLength;
   }
   const digestInput = [
@@ -427,13 +430,15 @@ function deriveVertexLayoutProjection(map) {
       (entry) => `${entry.key},${entry.shaderLocation},${entry.offset},${entry.format}`
     )
   ].join("|");
-  return Object.freeze({
+  const projection = Object.freeze({
     schemaVersion: 1,
     attributes: Object.freeze(attributes),
     mask,
     arrayStride: offset,
     digest: fnv1a(digestInput)
   });
+  layoutsByMask.set(mask, projection);
+  return projection;
 }
 var VertexAttributePackError = class extends AssetError {
   constructor(detail) {
@@ -465,14 +470,7 @@ function deriveVertexLayoutProjectionFromMask(mask) {
       detail: { mask, knownMask, unknownMask, reason: "unknown-bits" }
     });
   }
-  const map = {};
-  for (let index = 0; index < CANONICAL_KEYS.length; index += 1) {
-    if ((mask & 1 << index) === 0) continue;
-    const key = CANONICAL_KEYS[index];
-    if (key !== void 0)
-      map[key] = key === "skinIndex" ? new Uint16Array(0) : new Float32Array(0);
-  }
-  return ok(deriveVertexLayoutProjection(map));
+  return ok(layoutFromMask(unsignedMask));
 }
 function packInterleavedVertexAttributes(map, vertexCount) {
   const invalid3 = (detail) => err(new VertexAttributePackError(detail));