@forgeax/engine-geometry 0.1.21 → 0.1.24

package/dist/__tests__/physical-tangent.unit.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=physical-tangent.unit.test.d.ts.map

package/dist/__tests__/physical-tangent.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical-tangent.unit.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/physical-tangent.unit.test.ts"],"names":[],"mappings":""}

package/dist/assets/mesh-binary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mesh-binary.d.ts","sourceRoot":"","sources":["../../src/assets/mesh-binary.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,SAAS,EAKV,MAAM,uBAAuB,CAAC;AAgW/B,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,SAAS,GAAG,SAAS,CA0BvB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,SAAS,GAAG,SAAS,CAgCvB"}
+{"version":3,"file":"mesh-binary.d.ts","sourceRoot":"","sources":["../../src/assets/mesh-binary.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,SAAS,EAKV,MAAM,uBAAuB,CAAC;AAkW/B,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,SAAS,GAAG,SAAS,CA0BvB;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,SAAS,GAAG,SAAS,CAgCvB"}

package/dist/assets/mesh-decoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mesh-decoder.d.ts","sourceRoot":"","sources":["../../src/assets/mesh-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EAGd,KAAK,SAAS,EAGf,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,SAAS,EAAE,MAAM,CAEtB,CAAC;AA2BlC,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,SAAS,CA+CpD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAI7E,CAAC"}
+{"version":3,"file":"mesh-decoder.d.ts","sourceRoot":"","sources":["../../src/assets/mesh-decoder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EAGd,KAAK,SAAS,EAGf,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,aAAa,EAAE,SAAS,CAAC,SAAS,EAAE,MAAM,CAEtB,CAAC;AAclC,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,SAAS,CA+CpD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,wBAAwB,CAAC,SAAS,EAAE,MAAM,CAI7E,CAAC"}

package/dist/assets/primitive-mesh.d.ts

@@ -2,4 +2,6 @@ import type { AssetError, MeshAsset, Result } from '@forgeax/engine-types';
 export type PrimitiveMeshKind = 'cube' | 'triangle' | 'quad' | 'sphere' | 'cylinder' | 'nine-slice-quad';
 /** Create one ordinary mesh payload for allocation or interning by an owning World. */
 export declare function createPrimitiveMesh(kind: PrimitiveMeshKind): Result<MeshAsset, AssetError>;
+/** Resolve the canonical Pack v2 procedural mesh descriptor without duplicating its alias table. */
+export declare function createProceduralMesh(payload: unknown): Result<MeshAsset, AssetError> | undefined;
 //# sourceMappingURL=primitive-mesh.d.ts.map

package/dist/assets/primitive-mesh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitive-mesh.d.ts","sourceRoot":"","sources":["../../src/assets/primitive-mesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM3E,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,iBAAiB,CAAC;AAEtB,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAoB1F"}
+{"version":3,"file":"primitive-mesh.d.ts","sourceRoot":"","sources":["../../src/assets/primitive-mesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAM3E,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,UAAU,GACV,MAAM,GACN,QAAQ,GACR,UAAU,GACV,iBAAiB,CAAC;AAWtB,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAoB1F;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,SAAS,CAOhG"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export type { VertexAttributePackDetail } from '@forgeax/engine-types';
+export { decodeMeshBinary, normalizeMeshPayload } from './assets/mesh-binary';
 export { meshAssetContribution, meshAssetDecoder, meshAssetKind } from './assets/mesh-decoder';
-export { createPrimitiveMesh, type PrimitiveMeshKind } from './assets/primitive-mesh';
+export { createPrimitiveMesh, createProceduralMesh, type PrimitiveMeshKind, } from './assets/primitive-mesh';
 export { createBoxGeometry, meshFromInterleaved, PROCEDURAL_FLOATS_PER_VERTEX, } from './box';
 export { createCapsuleGeometry } from './capsule';
 export { createConeGeometry } from './cone';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EAAE,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACtF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,IAAI,GACV,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,sCAAsC,EACtC,4BAA4B,EAC5B,oCAAoC,EACpC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,GACrC,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,YAAY,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC/F,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,4BAA4B,GAC7B,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,IAAI,GACV,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,sCAAsC,EACtC,4BAA4B,EAC5B,oCAAoC,EACpC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,+BAA+B,EAC/B,wBAAwB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,GACrC,MAAM,2BAA2B,CAAC"}

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { ok, countUvSets, AssetError, ASSET_ERROR_HINTS, err } from '@forgeax/engine-types';
 import { decodeMeshBinHeader, MESH_BIN_HEADER_V4_BYTES, MESH_BIN_VERSION } from '@forgeax/engine-pack';
 import { box3, circle2, box2 } from '@forgeax/engine-math';
+import { err, ok, countUvSets, AssetError, ASSET_ERROR_HINTS } from '@forgeax/engine-types';
 
-// src/assets/mesh-decoder.ts
+// src/assets/mesh-binary.ts
 var EPSILON = 1e-8;
 function tangentInputError(field, value, reason) {
   return new AssetError({
@@ -82,6 +82,7 @@ function computeTangentVec4(positions, normals, uvs, indices) {
   const vertexCount = preflight.value;
   const accumT = new Float32Array(vertexCount * 3);
   const accumSign = new Float32Array(vertexCount);
+  let validTriangleCount = 0;
   const triangleCount = indices !== void 0 ? indices.length / 3 : vertexCount / 3;
   for (let tri = 0; tri < triangleCount; tri++) {
     const i0 = indices !== void 0 ? indices[tri * 3] ?? 0 : tri * 3;
@@ -125,6 +126,7 @@ function computeTangentVec4(positions, normals, uvs, indices) {
     const cz = dP1x * dP2y - dP1y * dP2x;
     const faceArea = 0.5 * Math.sqrt(cx * cx + cy * cy + cz * cz);
     if (faceArea < EPSILON) continue;
+    validTriangleCount += 1;
     const signDet = det >= 0 ? 1 : -1;
     const signedWeight = faceArea * signDet;
     for (const vi of [i0, i1, i2]) {
@@ -134,6 +136,15 @@ function computeTangentVec4(positions, normals, uvs, indices) {
       accumSign[vi] = (accumSign[vi] ?? 0) + signedWeight;
     }
   }
+  if (validTriangleCount === 0) {
+    return err(
+      tangentInputError(
+        "tangent",
+        0,
+        "material-tangent-required: no triangle has a valid UV-derived tangent"
+      )
+    );
+  }
   const out = new Float32Array(vertexCount * 4);
   for (let v = 0; v < vertexCount; v++) {
     let tx = accumT[v * 3] ?? 0;
@@ -150,26 +161,29 @@ function computeTangentVec4(positions, normals, uvs, indices) {
       let rx = 1;
       let ry = 0;
       let rz = 0;
-      if (ax <= ay && ax <= az) {
-        rx = 1;
-        ry = 0;
-        rz = 0;
-      } else if (ay <= ax && ay <= az) {
+      if (ax > ay && ax > az) {
         rx = 0;
         ry = 1;
-        rz = 0;
-      } else {
+      } else if (ay > ax && ay > az) {
         rx = 0;
-        ry = 0;
         rz = 1;
       }
       tx = ny * rz - nz * ry;
       ty = nz * rx - nx * rz;
       tz = nx * ry - ny * rx;
-      const fLen = Math.sqrt(tx * tx + ty * ty + tz * tz) || 1;
-      tx /= fLen;
-      ty /= fLen;
-      tz /= fLen;
+      const fallbackLength = Math.sqrt(tx * tx + ty * ty + tz * tz);
+      if (fallbackLength < EPSILON) {
+        return err(
+          tangentInputError(
+            "tangent",
+            v,
+            "material-tangent-required: supplied normal cannot define a tangent frame"
+          )
+        );
+      }
+      tx /= fallbackLength;
+      ty /= fallbackLength;
+      tz /= fallbackLength;
     } else {
       tx /= tLen;
       ty /= tLen;
@@ -187,26 +201,29 @@ function computeTangentVec4(positions, normals, uvs, indices) {
       let rx = 1;
       let ry = 0;
       let rz = 0;
-      if (ax <= ay && ax <= az) {
-        rx = 1;
-        ry = 0;
-        rz = 0;
-      } else if (ay <= ax && ay <= az) {
+      if (ax > ay && ax > az) {
         rx = 0;
         ry = 1;
-        rz = 0;
-      } else {
+      } else if (ay > ax && ay > az) {
         rx = 0;
-        ry = 0;
         rz = 1;
       }
       gx = ny * rz - nz * ry;
       gy = nz * rx - nx * rz;
       gz = nx * ry - ny * rx;
-      const fLen = Math.sqrt(gx * gx + gy * gy + gz * gz) || 1;
-      gx /= fLen;
-      gy /= fLen;
-      gz /= fLen;
+      const fallbackLength = Math.sqrt(gx * gx + gy * gy + gz * gz);
+      if (fallbackLength < EPSILON) {
+        return err(
+          tangentInputError(
+            "tangent",
+            v,
+            "material-tangent-required: supplied normal cannot define a tangent frame"
+          )
+        );
+      }
+      gx /= fallbackLength;
+      gy /= fallbackLength;
+      gz /= fallbackLength;
     } else {
       gx /= gLen;
       gy /= gLen;
@@ -977,7 +994,7 @@ function materialSlotsFor(raw, submeshes, refs) {
   if (raw === void 0)
     return submeshes.map((_submesh, index) => ({ slotName: `LegacySlot_${index}` }));
   return raw.map((slot, index) => {
-    const reference = slot.defaultMaterialRef === void 0 ? void 0 : refs[slot.defaultMaterialRef];
+    const reference = slot.defaultMaterialRef === void 0 ? slot.defaultMaterial : refs[slot.defaultMaterialRef];
     const defaultMaterial = reference === void 0 ? void 0 : parseGuid(reference);
     return {
       slotName: typeof slot.slotName === "string" && slot.slotName.trim().length > 0 ? slot.slotName : `LegacySlot_${index}`,
@@ -1387,6 +1404,14 @@ function createSphereGeometry(radius, widthSegments = 16, heightSegments = 12) {
 }
 
 // src/assets/primitive-mesh.ts
+var PROCEDURAL_MESH_KINDS = {
+  "procedural-cube": "cube",
+  "procedural-triangle": "triangle",
+  "procedural-quad": "quad",
+  "procedural-sphere": "sphere",
+  "procedural-cylinder": "cylinder",
+  "procedural-nine-slice-quad": "nine-slice-quad"
+};
 function createPrimitiveMesh(kind) {
   switch (kind) {
     case "cube":
@@ -1431,30 +1456,26 @@ function createPrimitiveMesh(kind) {
       return createPlaneGeometry(1, 1, 3, 3);
   }
 }
+function createProceduralMesh(payload) {
+  if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return void 0;
+  const geometry = payload.geometry;
+  if (typeof geometry !== "string") return void 0;
+  const kind = PROCEDURAL_MESH_KINDS[geometry];
+  if (kind === void 0) return void 0;
+  return createPrimitiveMesh(kind);
+}
 
 // src/assets/mesh-decoder.ts
 var meshAssetKind = {
   kind: "mesh"
 };
-var PROCEDURAL_MESH_KINDS = {
-  "procedural-cube": "cube",
-  "procedural-triangle": "triangle",
-  "procedural-quad": "quad",
-  "procedural-sphere": "sphere",
-  "procedural-cylinder": "cylinder",
-  "procedural-nine-slice-quad": "nine-slice-quad"
-};
 function proceduralMesh(payload) {
-  if (payload === null || typeof payload !== "object" || Array.isArray(payload)) return void 0;
-  const geometry = payload.geometry;
-  if (typeof geometry !== "string") return void 0;
-  const kind = PROCEDURAL_MESH_KINDS[geometry];
-  if (kind === void 0) return void 0;
-  const result = createPrimitiveMesh(kind);
+  const result = createProceduralMesh(payload);
+  if (result === void 0) return void 0;
   if (result.ok) return result;
   return err({
     code: "asset-package-invalid",
-    expected: `a valid procedural ${kind} mesh payload`,
+    expected: result.error.expected,
     hint: "recook the authored procedural mesh descriptor",
     detail: { guid: "", reason: "procedural mesh creation failed" }
   });
@@ -4265,6 +4286,6 @@ function createTorusGeometry(radius, tube, radialSegments = 8, tubularSegments =
   return meshFromInterleaved(vertices, indices);
 }
 
-export { PROCEDURAL_FLOATS_PER_VERTEX, VertexAttributePackError, buildMeshAttributeMapForUvSets, compute2dBounds, computeTangentVec4, create2dGeometry, create2dRingGeometry, createBoxGeometry, createCapsuleGeometry, createConeGeometry, createCylinderGeometry, createEdgesGeometry, createMeshBuilder, createPlaneGeometry, createPrimitiveMesh, createSphereGeometry, createTeapotGeometry, createTorusGeometry, createWireframeGeometry, deriveVertexBufferLayout, deriveVertexBufferLayoutFromProjection, deriveVertexLayoutProjection, deriveVertexLayoutProjectionFromMask, meshAssetContribution, meshAssetDecoder, meshAssetKind, meshFromInterleaved, packInterleavedVertexAttributes };
+export { PROCEDURAL_FLOATS_PER_VERTEX, VertexAttributePackError, buildMeshAttributeMapForUvSets, compute2dBounds, computeTangentVec4, create2dGeometry, create2dRingGeometry, createBoxGeometry, createCapsuleGeometry, createConeGeometry, createCylinderGeometry, createEdgesGeometry, createMeshBuilder, createPlaneGeometry, createPrimitiveMesh, createProceduralMesh, createSphereGeometry, createTeapotGeometry, createTorusGeometry, createWireframeGeometry, decodeMeshBinary, deriveVertexBufferLayout, deriveVertexBufferLayoutFromProjection, deriveVertexLayoutProjection, deriveVertexLayoutProjectionFromMask, meshAssetContribution, meshAssetDecoder, meshAssetKind, meshFromInterleaved, normalizeMeshPayload, packInterleavedVertexAttributes };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map