npm - @faicad/faijs - Versions diffs - 0.31.1 → 0.32.2 - Mend

@faicad/faijs 0.31.1 → 0.32.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1538) hide show

package/dist/mesh/engrave.js CHANGED Viewed

@@ -11,8 +11,10 @@
  * 不包含：store 读写、commitGeometry、undo snapshot、toast。
  * 这些由执行器负责（P1 不改变现有执行器行为）。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C, Quat, Mat4 } from '../math3d/index.js';
+import { transformShape, translateShape } from './meshdata/ops.js';
 import { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend.js';
+import { boundingBox } from './query.js';
 import { getEngraveDecorationProvider } from './decoration-provider.js';
 /**
  * Execute an engraving: generate the decoration geometry (text or SVG),
@@ -39,7 +41,7 @@ export async function engrave(shape, params) {
             'installEditorMeshProviders() from @faicad/faijs-extra) before engraving in mesh mode, ' +
             'or run the op on the BREP path');
     }
-    const decorationGeo = await provider({
+    let decoration = await provider({
         text: params.text,
         textSize: params.textSize,
         svg: params.svg,
@@ -49,27 +51,25 @@ export async function engrave(shape, params) {
         depth: params.depth,
     });
     // 2. 定位装饰几何到面
-    const faceCenter = new THREE.Vector3(...params.face.center);
-    const faceNormal = new THREE.Vector3(...params.face.normal);
+    const faceCenter = new Vec3C(...params.face.center);
+    const faceNormal = new Vec3C(...params.face.normal);
     // Center geometry at origin
-    decorationGeo.computeBoundingBox();
-    const center = new THREE.Vector3();
-    decorationGeo.boundingBox.getCenter(center);
-    decorationGeo.translate(-center.x, -center.y, -center.z);
+    const bb = boundingBox(decoration);
+    const center = new Vec3C((bb.min[0] + bb.max[0]) / 2, (bb.min[1] + bb.max[1]) / 2, (bb.min[2] + bb.max[2]) / 2);
+    decoration = translateShape(decoration, -center.x, -center.y, -center.z);
     // Rotate +Z to align with face normal
-    const quat = new THREE.Quaternion().setFromUnitVectors(new THREE.Vector3(0, 0, 1), faceNormal);
-    decorationGeo.applyQuaternion(quat);
+    const quat = new Quat().setFromUnitVectors(new Vec3C(0, 0, 1), faceNormal);
+    const rotMatrix = new Mat4().makeRotationFromQuaternion(quat);
+    decoration = transformShape(decoration, rotMatrix);
     // Offset along normal (convex = outward, concave = inward)
     const offset = params.mode === 'convex' ? params.depth / 2 : -params.depth / 2;
     const pos = faceCenter.clone().add(faceNormal.clone().multiplyScalar(offset));
-    decorationGeo.translate(pos.x, pos.y, pos.z);
+    decoration = translateShape(decoration, pos.x, pos.y, pos.z);
     // 3. 转换为 ManifoldMeshData
-    const decorationData = geoToManifoldMesh(decorationGeo);
+    const decorationData = geoToManifoldMesh(decoration);
     // 4. 布尔运算
     const op = params.mode === 'convex' ? 'union' : 'subtract';
     const result = await computeBoolean([shape, decorationData], op);
-    // 5. 清理
-    decorationGeo.dispose();
     return result;
 }
 /**
@@ -84,22 +84,21 @@ export async function engrave(shape, params) {
  */
 export async function knurl(shape, params) {
     const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import('./knurl/KnurlGenerator.js');
-    // 1. Shape → THREE.BufferGeometry
+    // 1. Shape → Shape (with normals)
     const geo = manifoldMeshToGeo(shape, { computeNormals: true });
     // 2. 计算面排除权重：法向与 face.normal 不接近的面标记为排除
-    const posAttr = geo.getAttribute('position');
-    const triCount = posAttr.count / 3;
-    const faceNormal = new THREE.Vector3(...params.face.normal).normalize();
+    const positions = geo.positions;
+    const triCount = positions.length / 3;
+    const faceNormal = new Vec3C(...params.face.normal).normalize();
     // 计算每个三角形的法向
-    const positions = posAttr.array;
-    const indices = geo.index ? geo.index.array : null;
-    const faceWeights = new Float32Array(posAttr.count);
-    const v0 = new THREE.Vector3();
-    const v1 = new THREE.Vector3();
-    const v2 = new THREE.Vector3();
-    const edge1 = new THREE.Vector3();
-    const edge2 = new THREE.Vector3();
-    const triNormal = new THREE.Vector3();
+    const indices = geo.indices.length > 0 ? geo.indices : null;
+    const faceWeights = new Float32Array(positions.length);
+    const v0 = new Vec3C();
+    const v1 = new Vec3C();
+    const v2 = new Vec3C();
+    const edge1 = new Vec3C();
+    const edge2 = new Vec3C();
+    const triNormal = new Vec3C();
     for (let t = 0; t < triCount; t++) {
         const i0 = indices ? indices[t * 3] : t * 3;
         const i1 = indices ? indices[t * 3 + 1] : t * 3 + 1;
@@ -119,16 +118,17 @@ export async function knurl(shape, params) {
         }
     }
     // 3. 计算包围盒
-    geo.computeBoundingBox();
-    const bb = geo.boundingBox;
+    const bb = boundingBox(geo);
+    const bbMin = new Vec3C(bb.min[0], bb.min[1], bb.min[2]);
+    const bbMax = new Vec3C(bb.max[0], bb.max[1], bb.max[2]);
     const partBounds = {
-        min: bb.min.clone(),
-        max: bb.max.clone(),
-        size: new THREE.Vector3().subVectors(bb.max, bb.min),
-        center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),
+        min: bbMin,
+        max: bbMax,
+        size: new Vec3C().subVectors(bbMax, bbMin),
+        center: new Vec3C().addVectors(bbMin, bbMax).multiplyScalar(0.5),
     };
     // 4. 调用 applyKnurlDisplacement
-    const resultGeo = await applyKnurlDisplacement(geo, {
+    const result = await applyKnurlDisplacement(geo, {
         ...KNURL_DEFAULTS,
         textureHeight: params.knurlTextureHeight,
         invertDisplacement: params.knurlInvertDisplacement,
@@ -138,8 +138,7 @@ export async function knurl(shape, params) {
         mappingMode: params.knurlMappingMode,
         faceWeights,
     }, undefined, partBounds);
-    geo.dispose();
-    // 5. THREE.BufferGeometry → Shape
-    return geoToManifoldMesh(resultGeo);
+    // 5. Shape → ManifoldMeshData
+    return geoToManifoldMesh(result);
 }
 //# sourceMappingURL=engrave.js.map

package/dist/mesh/engrave.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"engrave.js","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAGpE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY,EAAE,MAAqB;IAC/D,4BAA4B;IAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IACD,MAAM,QAAQ,GAAG,4BAA4B,EAAE,CAAA;IAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC/E,wEAAwE;YACxE,wFAAwF;YACxF,gCAAgC,CACjC,CAAA;IACH,CAAC;IACD,MAAM,aAAa,GAAyB,MAAM,QAAQ,CAAC;QACzD,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAA;IAEF,cAAc;IACd,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC3D,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAE3D,4BAA4B;IAC5B,aAAa,CAAC,kBAAkB,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IAClC,aAAa,CAAC,WAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAC5C,aAAa,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAExD,sCAAsC;IACtC,MAAM,IAAI,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,kBAAkB,CACpD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC1B,UAAU,CACX,CAAA;IACD,aAAa,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;IAEnC,2DAA2D;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAA;IAC9E,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7E,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IAE5C,0BAA0B;IAC1B,MAAM,cAAc,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAA;IAEvD,UAAU;IACV,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAA;IAC1D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAA;IAEhE,QAAQ;IACR,aAAa,CAAC,OAAO,EAAE,CAAA;IAEvB,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAY,EAAE,MAAmB;IAC3D,MAAM,EAAE,sBAAsB,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAC7D,wBAAwB,CACzB,CAAA;IAED,kCAAkC;IAClC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9D,wCAAwC;IACxC,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAA;IAClC,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAA;IAEvE,aAAa;IACb,MAAM,SAAS,GAAG,OAAO,CAAC,KAAqB,CAAA;IAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,GAAG,CAAC,KAAK,CAAC,KAAqB,CAAC,CAAC,CAAC,IAAI,CAAA;IACnE,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAEnD,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IAC9B,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IAC9B,MAAM,EAAE,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IAC9B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IACjC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3C,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnD,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAEnD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAEvE,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACxB,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACxB,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,SAAS,EAAE,CAAA;QAEhD,sCAAsC;QACtC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACrC,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;YACd,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;YACxB,WAAW,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;YAC5B,WAAW,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,WAAW;IACX,GAAG,CAAC,kBAAkB,EAAE,CAAA;IACxB,MAAM,EAAE,GAAG,GAAG,CAAC,WAAY,CAAA;IAC3B,MAAM,UAAU,GAAG;QACjB,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE;QACnB,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE;QACnB,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC;QACpD,MAAM,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC;KAC3E,CAAA;IAED,+BAA+B;IAC/B,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAC5C,GAAG,EACH;QACE,GAAG,cAAc;QACjB,aAAa,EAAE,MAAM,CAAC,kBAAkB;QACxC,kBAAkB,EAAE,MAAM,CAAC,uBAAuB;QAClD,YAAY,EAAE,MAAM,CAAC,iBAAiB;QACtC,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,WAAW,EAAE,MAAM,CAAC,gBAAgB;QACpC,WAAW;KACZ,EACD,SAAS,EACT,UAAU,CACX,CAAA;IAED,GAAG,CAAC,OAAO,EAAE,CAAA;IAEb,kCAAkC;IAClC,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAA;AACrC,CAAC","sourcesContent":["/*\n mesh 雕刻 API\n \n 提取来源：engine/components/engraving/EngravingCore.ts\n \n 从 executeEngraving 中提取纯几何计算部分：\n * 1. 生成装饰几何（文字或 SVG）\n * 2. 定位到面\n * 3. 布尔运算（凸=union，凹=subtract）\n \n 不包含：store 读写、commitGeometry、undo snapshot、toast。\n * 这些由执行器负责（P1 不改变现有执行器行为）。\n /\n\nimport as THREE from 'three'\nimport { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend'\nimport { getEngraveDecorationProvider } from './decoration-provider'\nimport type { Shape, EngraveParams, KnurlParams } from './types'\n\n/*\n Execute an engraving: generate the decoration geometry (text or SVG),\n * position it onto a face, then run a boolean union (convex) or subtract\n * (concave).\n \n The decoration geometry itself comes from the host-installed provider\n * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`\n * chain belongs to `@faicad/faijs-extra`, not to the platform surface.\n \n @param shape - the world-space target shape.\n * @param params - engrave parameters (text/svg, depth, face, mode).\n * @returns the engraved shape in world space.\n /\nexport async function engrave(shape: Shape, params: EngraveParams): Promise<Shape> {\n // 1. 生成装饰几何（局部空间，+Z = 挤出方向）\n if (!params.text && !params.svg) {\n throw new Error('engrave requires either text or svg')\n }\n const provider = getEngraveDecorationProvider()\n if (!provider) {\n throw new Error(\n 'engrave: no mesh decoration provider installed — the text/SVG geometry chain ' +\n 'lives in @faicad/faijs-extra; call setEngraveDecorationProvider() (or ' +\n 'installEditorMeshProviders() from @faicad/faijs-extra) before engraving in mesh mode, ' +\n 'or run the op on the BREP path',\n )\n }\n const decorationGeo: THREE.BufferGeometry = await provider({\n text: params.text,\n textSize: params.textSize,\n svg: params.svg,\n svgSize: params.svgSize,\n svgNaturalWidth: params.svgNaturalWidth,\n svgNaturalHeight: params.svgNaturalHeight,\n depth: params.depth,\n })\n\n // 2. 定位装饰几何到面\n const faceCenter = new THREE.Vector3(...params.face.center)\n const faceNormal = new THREE.Vector3(...params.face.normal)\n\n // Center geometry at origin\n decorationGeo.computeBoundingBox()\n const center = new THREE.Vector3()\n decorationGeo.boundingBox!.getCenter(center)\n decorationGeo.translate(-center.x, -center.y, -center.z)\n\n // Rotate +Z to align with face normal\n const quat = new THREE.Quaternion().setFromUnitVectors(\n new THREE.Vector3(0, 0, 1),\n faceNormal,\n )\n decorationGeo.applyQuaternion(quat)\n\n // Offset along normal (convex = outward, concave = inward)\n const offset = params.mode === 'convex' ? params.depth / 2 : -params.depth / 2\n const pos = faceCenter.clone().add(faceNormal.clone().multiplyScalar(offset))\n decorationGeo.translate(pos.x, pos.y, pos.z)\n\n // 3. 转换为 ManifoldMeshData\n const decorationData = geoToManifoldMesh(decorationGeo)\n\n // 4. 布尔运算\n const op = params.mode === 'convex' ? 'union' : 'subtract'\n const result = await computeBoolean([shape, decorationData], op)\n\n // 5. 清理\n decorationGeo.dispose()\n\n return result\n}\n\n/\n Apply a knurling texture displacement to a shape (vertex displacement, not a\n * boolean op). The replay path approximates UI face selection by excluding\n * faces whose normal deviates from the given face normal; the angle limits act\n * as an angular mask.\n \n @param shape - the world-space shape to knurl.\n * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).\n * @returns the displaced shape in world space.\n /\nexport async function knurl(shape: Shape, params: KnurlParams): Promise<Shape> {\n const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import(\n './knurl/KnurlGenerator'\n )\n\n // 1. Shape → THREE.BufferGeometry\n const geo = manifoldMeshToGeo(shape, { computeNormals: true })\n\n // 2. 计算面排除权重：法向与 face.normal 不接近的面标记为排除\n const posAttr = geo.getAttribute('position')\n const triCount = posAttr.count / 3\n const faceNormal = new THREE.Vector3(...params.face.normal).normalize()\n\n // 计算每个三角形的法向\n const positions = posAttr.array as Float32Array\n const indices = geo.index ? (geo.index.array as Uint32Array) : null\n const faceWeights = new Float32Array(posAttr.count)\n\n const v0 = new THREE.Vector3()\n const v1 = new THREE.Vector3()\n const v2 = new THREE.Vector3()\n const edge1 = new THREE.Vector3()\n const edge2 = new THREE.Vector3()\n const triNormal = new THREE.Vector3()\n\n for (let t = 0; t < triCount; t++) {\n const i0 = indices ? indices[t 3] : t * 3\n const i1 = indices ? indices[t * 3 + 1] : t * 3 + 1\n const i2 = indices ? indices[t * 3 + 2] : t * 3 + 2\n\n v0.set(positions[i0 * 3], positions[i0 * 3 + 1], positions[i0 * 3 + 2])\n v1.set(positions[i1 * 3], positions[i1 * 3 + 1], positions[i1 * 3 + 2])\n v2.set(positions[i2 * 3], positions[i2 * 3 + 1], positions[i2 * 3 + 2])\n\n edge1.subVectors(v1, v0)\n edge2.subVectors(v2, v0)\n triNormal.crossVectors(edge1, edge2).normalize()\n\n // 法向相似度：dot > 0.5 (~60° within) → 不排除\n const dot = triNormal.dot(faceNormal)\n if (dot < 0.5) {\n faceWeights[t * 3] = 1.0\n faceWeights[t * 3 + 1] = 1.0\n faceWeights[t * 3 + 2] = 1.0\n }\n }\n\n // 3. 计算包围盒\n geo.computeBoundingBox()\n const bb = geo.boundingBox!\n const partBounds = {\n min: bb.min.clone(),\n max: bb.max.clone(),\n size: new THREE.Vector3().subVectors(bb.max, bb.min),\n center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),\n }\n\n // 4. 调用 applyKnurlDisplacement\n const resultGeo = await applyKnurlDisplacement(\n geo,\n {\n ...KNURL_DEFAULTS,\n textureHeight: params.knurlTextureHeight,\n invertDisplacement: params.knurlInvertDisplacement,\n refineLength: params.knurlRefineLength,\n scaleU: params.knurlScaleU,\n scaleV: params.knurlScaleV,\n mappingMode: params.knurlMappingMode,\n faceWeights,\n },\n undefined,\n partBounds,\n )\n\n geo.dispose()\n\n // 5. THREE.BufferGeometry → Shape\n return geoToManifoldMesh(resultGeo)\n}\n"]}
1	+ {"version":3,"file":"engrave.js","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAGpE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY,EAAE,MAAqB;IAC/D,4BAA4B;IAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;IACxD,CAAC;IACD,MAAM,QAAQ,GAAG,4BAA4B,EAAE,CAAA;IAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,+EAA+E;YAC/E,wEAAwE;YACxE,wFAAwF;YACxF,gCAAgC,CACjC,CAAA;IACH,CAAC;IACD,IAAI,UAAU,GAAG,MAAM,QAAQ,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAA;IAEF,cAAc;IACd,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IACnD,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAEnD,4BAA4B;IAC5B,MAAM,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,IAAI,KAAK,CACtB,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAC3B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAC3B,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAC5B,CAAA;IACD,UAAU,GAAG,cAAc,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAExE,sCAAsC;IACtC,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CACxC,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAClB,UAAU,CACX,CAAA;IACD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAA;IAC7D,UAAU,GAAG,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAElD,2DAA2D;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAA;IAC9E,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7E,UAAU,GAAG,cAAc,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IAE5D,0BAA0B;IAC1B,MAAM,cAAc,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAEpD,UAAU;IACV,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAA;IAC1D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAA;IAEhE,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,KAAY,EAAE,MAAmB;IAC3D,MAAM,EAAE,sBAAsB,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAC7D,wBAAwB,CACzB,CAAA;IAED,kCAAkC;IAClC,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAA;IAE9D,wCAAwC;IACxC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,CAAA;IAC/B,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAA;IACrC,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,CAAA;IAE/D,aAAa;IACb,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;IAC3D,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAEtD,MAAM,EAAE,GAAG,IAAI,KAAK,EAAE,CAAA;IACtB,MAAM,EAAE,GAAG,IAAI,KAAK,EAAE,CAAA;IACtB,MAAM,EAAE,GAAG,IAAI,KAAK,EAAE,CAAA;IACtB,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACzB,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACzB,MAAM,SAAS,GAAG,IAAI,KAAK,EAAE,CAAA;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3C,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACnD,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAEnD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAEvE,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACxB,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;QACxB,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,SAAS,EAAE,CAAA;QAEhD,sCAAsC;QACtC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACrC,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;YACd,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;YACxB,WAAW,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;YAC5B,WAAW,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAA;QAC9B,CAAC;IACH,CAAC;IAED,WAAW;IACX,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAC3B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACxD,MAAM,UAAU,GAAG;QACjB,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC;QAC1C,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC;KACjE,CAAA;IAED,+BAA+B;IAC/B,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,GAAG,EACH;QACE,GAAG,cAAc;QACjB,aAAa,EAAE,MAAM,CAAC,kBAAkB;QACxC,kBAAkB,EAAE,MAAM,CAAC,uBAAuB;QAClD,YAAY,EAAE,MAAM,CAAC,iBAAiB;QACtC,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,WAAW,EAAE,MAAM,CAAC,gBAAgB;QACpC,WAAW;KACZ,EACD,SAAS,EACT,UAAU,CACX,CAAA;IAED,8BAA8B;IAC9B,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAClC,CAAC","sourcesContent":["/*\n mesh 雕刻 API\n \n 提取来源：engine/components/engraving/EngravingCore.ts\n \n 从 executeEngraving 中提取纯几何计算部分：\n * 1. 生成装饰几何（文字或 SVG）\n * 2. 定位到面\n * 3. 布尔运算（凸=union，凹=subtract）\n \n 不包含：store 读写、commitGeometry、undo snapshot、toast。\n * 这些由执行器负责（P1 不改变现有执行器行为）。\n /\n\nimport { Vec3 as Vec3C, Quat, Mat4 } from '../math3d'\nimport { transformShape, translateShape } from './meshdata/ops'\nimport { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend'\nimport { boundingBox } from './query'\nimport { getEngraveDecorationProvider } from './decoration-provider'\nimport type { Shape, EngraveParams, KnurlParams } from './types'\n\n/\n Execute an engraving: generate the decoration geometry (text or SVG),\n * position it onto a face, then run a boolean union (convex) or subtract\n * (concave).\n \n The decoration geometry itself comes from the host-installed provider\n * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`\n * chain belongs to `@faicad/faijs-extra`, not to the platform surface.\n \n @param shape - the world-space target shape.\n * @param params - engrave parameters (text/svg, depth, face, mode).\n * @returns the engraved shape in world space.\n /\nexport async function engrave(shape: Shape, params: EngraveParams): Promise<Shape> {\n // 1. 生成装饰几何（局部空间，+Z = 挤出方向）\n if (!params.text && !params.svg) {\n throw new Error('engrave requires either text or svg')\n }\n const provider = getEngraveDecorationProvider()\n if (!provider) {\n throw new Error(\n 'engrave: no mesh decoration provider installed — the text/SVG geometry chain ' +\n 'lives in @faicad/faijs-extra; call setEngraveDecorationProvider() (or ' +\n 'installEditorMeshProviders() from @faicad/faijs-extra) before engraving in mesh mode, ' +\n 'or run the op on the BREP path',\n )\n }\n let decoration = await provider({\n text: params.text,\n textSize: params.textSize,\n svg: params.svg,\n svgSize: params.svgSize,\n svgNaturalWidth: params.svgNaturalWidth,\n svgNaturalHeight: params.svgNaturalHeight,\n depth: params.depth,\n })\n\n // 2. 定位装饰几何到面\n const faceCenter = new Vec3C(...params.face.center)\n const faceNormal = new Vec3C(...params.face.normal)\n\n // Center geometry at origin\n const bb = boundingBox(decoration)\n const center = new Vec3C(\n (bb.min[0] + bb.max[0]) / 2,\n (bb.min[1] + bb.max[1]) / 2,\n (bb.min[2] + bb.max[2]) / 2,\n )\n decoration = translateShape(decoration, -center.x, -center.y, -center.z)\n\n // Rotate +Z to align with face normal\n const quat = new Quat().setFromUnitVectors(\n new Vec3C(0, 0, 1),\n faceNormal,\n )\n const rotMatrix = new Mat4().makeRotationFromQuaternion(quat)\n decoration = transformShape(decoration, rotMatrix)\n\n // Offset along normal (convex = outward, concave = inward)\n const offset = params.mode === 'convex' ? params.depth / 2 : -params.depth / 2\n const pos = faceCenter.clone().add(faceNormal.clone().multiplyScalar(offset))\n decoration = translateShape(decoration, pos.x, pos.y, pos.z)\n\n // 3. 转换为 ManifoldMeshData\n const decorationData = geoToManifoldMesh(decoration)\n\n // 4. 布尔运算\n const op = params.mode === 'convex' ? 'union' : 'subtract'\n const result = await computeBoolean([shape, decorationData], op)\n\n return result\n}\n\n/\n Apply a knurling texture displacement to a shape (vertex displacement, not a\n * boolean op). The replay path approximates UI face selection by excluding\n * faces whose normal deviates from the given face normal; the angle limits act\n * as an angular mask.\n \n @param shape - the world-space shape to knurl.\n * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).\n * @returns the displaced shape in world space.\n /\nexport async function knurl(shape: Shape, params: KnurlParams): Promise<Shape> {\n const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import(\n './knurl/KnurlGenerator'\n )\n\n // 1. Shape → Shape (with normals)\n const geo = manifoldMeshToGeo(shape, { computeNormals: true })\n\n // 2. 计算面排除权重：法向与 face.normal 不接近的面标记为排除\n const positions = geo.positions\n const triCount = positions.length / 3\n const faceNormal = new Vec3C(...params.face.normal).normalize()\n\n // 计算每个三角形的法向\n const indices = geo.indices.length > 0 ? geo.indices : null\n const faceWeights = new Float32Array(positions.length)\n\n const v0 = new Vec3C()\n const v1 = new Vec3C()\n const v2 = new Vec3C()\n const edge1 = new Vec3C()\n const edge2 = new Vec3C()\n const triNormal = new Vec3C()\n\n for (let t = 0; t < triCount; t++) {\n const i0 = indices ? indices[t 3] : t * 3\n const i1 = indices ? indices[t * 3 + 1] : t * 3 + 1\n const i2 = indices ? indices[t * 3 + 2] : t * 3 + 2\n\n v0.set(positions[i0 * 3], positions[i0 * 3 + 1], positions[i0 * 3 + 2])\n v1.set(positions[i1 * 3], positions[i1 * 3 + 1], positions[i1 * 3 + 2])\n v2.set(positions[i2 * 3], positions[i2 * 3 + 1], positions[i2 * 3 + 2])\n\n edge1.subVectors(v1, v0)\n edge2.subVectors(v2, v0)\n triNormal.crossVectors(edge1, edge2).normalize()\n\n // 法向相似度：dot > 0.5 (~60° within) → 不排除\n const dot = triNormal.dot(faceNormal)\n if (dot < 0.5) {\n faceWeights[t * 3] = 1.0\n faceWeights[t * 3 + 1] = 1.0\n faceWeights[t * 3 + 2] = 1.0\n }\n }\n\n // 3. 计算包围盒\n const bb = boundingBox(geo)\n const bbMin = new Vec3C(bb.min[0], bb.min[1], bb.min[2])\n const bbMax = new Vec3C(bb.max[0], bb.max[1], bb.max[2])\n const partBounds = {\n min: bbMin,\n max: bbMax,\n size: new Vec3C().subVectors(bbMax, bbMin),\n center: new Vec3C().addVectors(bbMin, bbMax).multiplyScalar(0.5),\n }\n\n // 4. 调用 applyKnurlDisplacement\n const result = await applyKnurlDisplacement(\n geo,\n {\n ...KNURL_DEFAULTS,\n textureHeight: params.knurlTextureHeight,\n invertDisplacement: params.knurlInvertDisplacement,\n refineLength: params.knurlRefineLength,\n scaleU: params.knurlScaleU,\n scaleV: params.knurlScaleV,\n mappingMode: params.knurlMappingMode,\n faceWeights,\n },\n undefined,\n partBounds,\n )\n\n // 5. Shape → ManifoldMeshData\n return geoToManifoldMesh(result)\n}\n"]}

package/dist/mesh/io.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAOH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAA;IACZ;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,CAAA;IACd;;;;;;;OAOG;IACH,IAAI,EAAE,QAAQ,CAAA;IACd;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,aAAa,CAAA;CACjC;AAuBD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAa,CAAA;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAqBhE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,GACzB,OAAO,CAAC,gBAAgB,CAAC,~~CAmG3B~~"}
1	+ {"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAOH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAEnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAA;IACZ;;;;OAIG;IACH,KAAK,EAAE,KAAK,EAAE,CAAA;IACd;;;;;;;OAOG;IACH,IAAI,EAAE,QAAQ,CAAA;IACd;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,aAAa,CAAA;CACjC;AAuBD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,QAAa,CAAA;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAqBhE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAiG3B"}

package/dist/mesh/io.js CHANGED Viewed

@@ -28,6 +28,7 @@
  */
 import { geoToManifoldMesh } from '../boolean/geo-convert.js';
 import { parseStl } from './stl-loader.js';
+import { boundingBox } from './query.js';
 import { parseThreemf } from './threemf-loader.js';
 import { parseBambu3mfFromEntries } from './threemf-bambu.js';
 import { unitScale } from '../units.js';
@@ -199,19 +200,17 @@ export async function importFile(buffer, format, opts) {
             scale = unitScale(declared);
         }
         else {
-            geo.computeBoundingBox();
-            const bb = geo.boundingBox;
-            if (bb) {
+            const bb = boundingBox(geo);
+            if (bb.min[0] !== Infinity) {
                 sourceUnit = guessStlUnit({
-                    min: [bb.min.x, bb.min.y, bb.min.z],
-                    max: [bb.max.x, bb.max.y, bb.max.z],
+                    min: [bb.min[0], bb.min[1], bb.min[2]],
+                    max: [bb.max[0], bb.max[1], bb.max[2]],
                 });
                 scale = unitScale(sourceUnit);
             }
         }
         if (scale !== 1) {
-            const attr = geo.getAttribute('position');
-            const arr = attr.array;
+            const arr = geo.positions;
             for (let i = 0; i < arr.length; i++)
                 arr[i] *= scale;
         }

package/dist/mesh/io.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n mesh IO API — headless 文件加载\n \n STL 由 core 自持的 `mesh/stl-loader.ts` 解析（零 three addons）；3MF 由\n * `mesh/threemf-loader.ts` 解析（ZIP 解压 + XML，单位换算到 mm 基准）。\n * 坐标永远以 faijs 基准长度单位（mm）存储 — Shape 不贴 unit 标签（D3）。\n \n 单位换算边界（unit-system §5.2）：\n * - 本模块只处理 mesh 格式（STL/3MF），坐标可直接折算 → `opts.unit` 提供即\n * 强制设置模型的源单位（直接指定，覆盖/忽略模型内部记录的单位——STL 无\n * 内部单位、3MF `<model unit>` 声明被覆盖），按 `unitScale(unit)` 折算坐标。\n * 它只可能来自调用方的显式知识（脚本作者手写 `cad.load({ file, unit })`、\n * 或宿主让用户选定单位后传入）；调用方不知道单位时必须省略——省略时：\n * STL 走 faijs 启发式（`guessStlUnit`，unified 方案 §6.1/§8 —— 3d_editor\n * 迁移回归的单位断言依赖此行为）、3MF 走文件 `<model unit>`（无声明 →\n * millimeter）。猜测/折算收敛在 faijs 内（红线 R0：宿主不自实现单位换算），\n * G0 = 折算后坐标，渲染 = 拓扑 = G0。\n * - STEP/.brep 不经过本模块（走 BREP 链，load op 内 OCCT 读取）：OCCT 按\n * 文件内部单位声明折算（SI_UNIT），不支持强制设置单位——load op 对\n * BREP 路径 + 用户显式 unit 直接明确报错（不缩放、不 workaround）。\n * - 3MF `<model unit>` 由解析器读取并换算（micron/mm/cm/inch/foot/meter）。\n \n 返回契约（unit-system §10.6）：`importFile` 返回 `{ shape, unit }` — `unit`\n * 是文件源单位（必然有值；faijs 是单一真源）：3MF 取 opts.unit（强制）或文件\n * 声明（无声明 → millimeter），STL 取 opts.unit 或 guessStlUnit 启发式猜测。\n * 坐标恒为基准值 — `unit` 只作元数据（sourceUnit 记录、导出目标判定），绝不\n * 参与几何缩放（读入折算已由解析器完成，二次缩放 = 双重换算）。\n /\n\nimport as THREE from 'three'\nimport { geoToManifoldMesh } from '../boolean/geo-convert'\nimport { parseStl } from './stl-loader'\nimport { parseThreemf, type ThreemfObject, type ThreemfNode } from './threemf-loader'\nimport { parseBambu3mfFromEntries } from './threemf-bambu'\nimport { unitScale, type UnitName } from '../units'\nimport { guessStlUnit } from './stl-unit'\nimport type { Shape } from './types'\nimport type { CompoundShape } from '../shape'\nimport type { PbrAppearance } from '../api/appearance'\nimport type { FileMeta } from '../api/meta'\nimport type { ImportModel } from './import-model'\n\n/** Result of a unit-aware file import. /\nexport interface ImportFileResult {\n shape: Shape\n /\n All parts the file declared, in declaration order (3MF `<build><item>` 序 /\n * STL 单零件)。`shape` is `parts[0]`（单零件兼容，过渡期）。\n * P0（2026-10-06-step-3mf-multipart-import-plan.md §5.4）：多对象 3MF 不再折叠。\n /\n parts: Shape[]\n /\n The file's source unit (always present; faijs is the single source of truth).\n * 3MF: opts.unit (forced) if provided, else the file's declared unit\n * (无声明 → millimeter). STL: opts.unit (forced) if provided, else the\n * guessStlUnit heuristic result. STEP/BREP 不经过本模块（OCCT 链不支持\n * 强制设置单位，load op 报错）。\n * Metadata only — coordinates are already in the faijs base unit (mm).\n /\n unit: UnitName\n /\n Total parts the single file declared (e.g. 3MF `<build>` object count),\n * present only when > 1. Single-part mesh (STL, single-object 3MF) omits it.\n * 保留为 `parts.length`（>1 时）；多零件不再折叠后该字段仅供旧宿主判断。\n /\n multiPartCount?: number\n /\n 整体级元数据（文件级；方案 §5.1 3MF `<model><metadata>`）。STL/STEP 视实现\n * 是否解析；无声明则省略。仅随导入结果上抛，不挂 Shape。\n /\n fileMeta?: FileMeta\n /\n 本次导入的结构数据（P0 §5.1）：零件身份表 + Bambu 视图（3MF 分支填充）。\n * 单/多零件均登记（单零件 parts 长度 1）。\n /\n importModel?: ImportModel\n /\n 装配层级（方案 2026-10-08 §2.1 / 第 5 步「导入归一」）：当 3MF 含 `<components>`\n * 装配结构时，按层级重建为 `CompoundShape`，每个子节点携带相对父的 `transform`\n * （来自 3MF `<component transform>` / build `<item transform>`，行主序 3×4，平移在\n * 末列，与写出器同源）。仅当存在真实装配（多 item 或任一 item 带 components）时存在；\n * 单零件平铺导入不走它（`shape` / `parts` 已覆盖）。viewer 用 `parts`（已烘焙实例），\n * 往返/层级消费者用 `assembly`（局部几何 + 节点 transform）。\n /\n assembly?: Shape \| CompoundShape\n}\n\n/* SI prefixes that may precede .METRE. in a STEP SI_UNIT, → faijs UnitName. /\nconst SI_PREFIX_TO_UNIT: Record<string, UnitName> = {\n '.MILLI.': 'mm',\n '.CENTI.': 'cm',\n '$': 'm',\n}\n\n/* CONVERSION_BASED_UNIT names (uppercased) found in real-world STEP files. /\nconst CONVERSION_NAME_TO_UNIT: Record<string, UnitName> = {\n 'METRE': 'm',\n 'METER': 'm',\n 'MILLIMETRE': 'mm',\n 'MILLIMETER': 'mm',\n 'CENTIMETRE': 'cm',\n 'CENTIMETER': 'cm',\n 'MICROMETRE': 'micron',\n 'MICROMETER': 'micron',\n 'INCH': 'inch',\n 'FOOT': 'foot',\n}\n\n/\n Bounded scan window for `detectStepUnit`. Unit entities sit at the front of\n * the DATA section (right after the product/context blocks); 256 KiB covers\n * every real-world header+context preamble observed so far. Recomputable\n * constant — raise if a fixture ever misses.\n /\nexport const STEP_UNIT_SCAN_PREFIX = 256 1024\n\n/*\n Parse the declared length unit from STEP text (unit-system §10.4).\n \n Unit entities live in the DATA section (not HEADER — ISO 10303-21 reserves\n * HEADER for FILE_DESCRIPTION/FILE_NAME/FILE_SCHEMA), near its start. We scan\n * a bounded prefix; the justification is \"unit entities sit at the front of\n * the DATA section\", not \"top of file\".\n \n Recognized forms, both attached to a LENGTH_UNIT():\n * - `SI_UNIT(<prefix>, .METRE.)` — prefix `.MILLI.`/`.CENTI.`/`.MICRO.` or `$`.\n * - `CONVERSION_BASED_UNIT('<NAME>', #n)` — inch/foot/etc.\n \n Metadata only — NEVER used to scale geometry (OCCT already normalizes on\n * read; re-scaling = double conversion).\n \n @param stepText - the full STEP file text to scan (only a bounded prefix is read).\n * @returns the faijs UnitName, or null when no length-unit declaration is found\n * (STEP permits omitting it; caller falls back to the base unit).\n /\nexport function detectStepUnit(stepText: string): UnitName \| null {\n const head = stepText.slice(0, STEP_UNIT_SCAN_PREFIX)\n\n // 1) CONVERSION_BASED_UNIT('<NAME>', #n) — non-SI units (inch/foot/…).\n const conv = head.match(/CONVERSION_BASED_UNIT\\s\$\\s'([^']+)'/i)\n if (conv) {\n const mapped = CONVERSION_NAME_TO_UNIT[conv[1].toUpperCase()]\n if (mapped) return mapped\n }\n\n // 2) SI_UNIT(<prefix>, .METRE.) — the .METRE. guard excludes angle entities\n // (they carry .RADIAN./.STERADIAN., never .METRE.).\n const si = head.match(/SI_UNIT\\s\\(\\s([^)]?)\\s,\\s\\.METRE\\.\\s\$/i)\n if (si) {\n const prefix = si[1].trim().toUpperCase()\n if (prefix === '.MICRO.') return 'micron'\n const mapped = SI_PREFIX_TO_UNIT[prefix]\n if (mapped) return mapped\n }\n\n return null\n}\n\n/\n Load geometry from raw file bytes (headless variant).\n \n @param buffer - the raw file bytes to parse (already decompressed; stpz\n * unzipping is the caller's job — faijs never unzips implicitly).\n * @param format - format identifier such as 'stl', '3mf'/'threemf' or 'step'\n * (defaults to 'stl'). 仅 mesh 格式（STL/3MF）走本模块；STEP/BREP 走\n * BREP 链（load op 内 OCCT 读取，不支持强制设置单位）。\n * @param opts - optional settings; `unit` (a UnitName string) *force-sets the\n model's source unit** (STL/3MF): it is NOT a default, it directly specifies\n * the unit and overrides/ignores any unit recorded inside the model (3MF\n * `<model unit>`; STL has none), geometry scaled by `unitScale(unit)`. Only\n * provide it when the caller actually knows the unit (author-written\n * `cad.load({ file, unit })`, or a host unit picker). When the caller does\n * NOT know the unit, it MUST omit `unit` — STL then guesses via\n * `guessStlUnit` (the only allowed guessing path), 3MF uses the file\n * declaration (none → millimeter). A wrong explicit unit scales geometry\n * wrongly and is never re-guessed.\n * @returns the shape with base-unit coordinates plus the file's source unit\n * (`unit`, metadata only; always present — faijs is the single source of truth).\n /\nexport async function importFile(\n buffer: ArrayBuffer,\n format?: string,\n opts?: { unit?: UnitName },\n): Promise<ImportFileResult> {\n const fmt = (format ?? 'stl').toLowerCase()\n\n if (fmt === '3mf' \|\| fmt === 'threemf') {\n const archive = await parseThreemf(buffer, opts)\n // P0（方案 §5.4）：不再折叠——返回全部 `<build><item>` 对象（declaration order，\n // 坐标已在 parseThreemf 里折算为 faijs 基准单位）。`shape` 保留为 parts[0]\n // （单零件兼容，过渡期）。\n if (archive.objects.length === 0) {\n throw new Error('[mesh/io] 3MF contains no objects')\n }\n // Bambu 元数据（盘号/挤出机/视图变换）：有 Bambu 配置才产生内容，普通 3MF 返回空表。\n // P4：根 model XML 直传（3MF `<build>` 在 resources 前；id 两套编号经父\n // object components 关联——leafParts 表承载）。\n const bambu = parseBambu3mfFromEntries(archive.extraEntries, archive.modelXml)\n const parts = archive.objects.map(threemfObjectToShape)\n const multiPartCount = parts.length > 1 ? parts.length : undefined\n const importModel: ImportModel = {\n format: '3mf',\n unit: archive.unit,\n parts: archive.objects.map((obj, i) => {\n const part: ImportModel['parts'][number] = {\n index: i,\n name: obj.name ?? `imported:${i}`,\n }\n if (obj.baseColor) part.color = [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]]\n if (obj.meta) part.meta = obj.meta\n // Bambu 身份：3MF `<object id>`（叶子实例）与 Bambu objects 表（键为\n // model_settings 父对象 id）是两套编号——经父 object components 关联\n // （ThreemfObject.parentObjectId/componentIndex → bambu.leafParts）。\n const bm = obj.parentObjectId !== undefined\n ? bambu.leafParts.get(`${obj.parentObjectId}:${obj.componentIndex ?? 1}`)\n : undefined\n if (bm) {\n part.objectId = bm.objectId\n if (bm.plateId > 0) part.plateId = bm.plateId\n // Bambu extruder 1-based（默认 1）：显式登记文件声明值\n part.extruder = bm.extruder\n part.partId = bm.partId\n }\n return part\n }),\n ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n }\n const bambuViews = buildBambuViews(bambu)\n if (bambuViews) importModel.bambuViews = bambuViews\n // 装配层级重建（方案 §2.1 / 第 5 步）：含 `<components>` 时还原 CompoundShape，\n // 叶节点携带相对父 transform；单零件平铺导入不挂载。\n const assembly = archive.hierarchy && archive.localGeomById\n ? buildAssemblyFromArchive(archive.hierarchy, archive.localGeomById)\n : undefined\n return {\n shape: parts[0],\n parts,\n unit: archive.unit,\n multiPartCount,\n importModel,\n // 整体级元数据（`<model><metadata>`）随导入结果上抛（方案 §5.1）。\n ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n ...(assembly ? { assembly } : {}),\n }\n }\n\n if (fmt === 'stl') {\n const geo = parseStl(buffer)\n // STL 无单位声明：opts.unit 显式声明优先；未声明时做启发式猜测\n // （guessStlUnit —— 历史 host 行为，unified §6.1/§8 迁移基线）。猜测与\n // 折算都在 faijs 内完成（红线 R0），G0 即基准值，宿主不再二次换算。\n // unit 字段回传源单位（声明值或猜测值），供宿主记录 sourceUnit 元数据。\n let scale = 1\n let sourceUnit: UnitName = 'mm'\n const declared = opts?.unit\n if (declared) {\n sourceUnit = declared\n scale = unitScale(declared)\n } else {\n geo.computeBoundingBox()\n const bb = geo.boundingBox\n if (bb) {\n sourceUnit = guessStlUnit({\n min: [bb.min.x, bb.min.y, bb.min.z],\n max: [bb.max.x, bb.max.y, bb.max.z],\n })\n scale = unitScale(sourceUnit)\n }\n }\n if (scale !== 1) {\n const attr = geo.getAttribute('position') as THREE.BufferAttribute\n const arr = attr.array as Float32Array\n for (let i = 0; i < arr.length; i++) arr[i] = scale\n }\n const shape = geoToManifoldMesh(geo)\n return { shape, parts: [shape], unit: sourceUnit }\n }\n\n // STEP goes through the BREP chain (loadBrep → OCCT, which normalizes to the\n // base unit on read). The mesh io path has no kernel-independent STEP parser\n // and must not fake one — a missing path is an error, not a fallback.\n throw new Error(`[mesh/io] unsupported format: ${fmt}`)\n}\n\n/** 单个 3MF `<build><item>` 对象 → Shape（P0：逐对象构造，替换原\"只取第一个\"收敛）。 /\nfunction threemfObjectToShape(obj: ThreemfObject): Shape {\n return {\n positions: obj.positions as Float32Array,\n indices: obj.indices as Uint32Array,\n // P2（方案 §5 3MF 行）：对象级 baseColor → appearance.color（sRGB 原值，\n // 宽容兼容：无 baseColor 不带 appearance）。colorgroup（vertexColors）与\n // 逐三角形材质属 Phase 2（materialGroups / vertexColors），P2 不映射。\n ...(obj.baseColor ? { appearance: { color: [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]] } } : {}),\n // P4（方案 §5 3MF 行）：逐三角形 basematerials（p1=p2=p3）→ materialGroups\n // （三角形区间 + appearance.color）；无则不带。vertexColors（colorgroup）\n // 由上层（编辑器导入路径）消费，io 单零件收敛不展开为材质分组。\n ...(obj.materialGroups && obj.materialGroups.length > 0\n ? {\n materialGroups: obj.materialGroups.map((g) => ({\n start: g.start,\n count: g.count,\n appearance: { color: [g.color[0], g.color[1], g.color[2]] } as PbrAppearance,\n })),\n }\n : {}),\n // 零件级元数据（方案 §5.1 3MF 行）：对象 name/partnumber/metadatagroup → meta。\n ...(obj.meta ? { meta: obj.meta } : {}),\n }\n}\n\n/\n 由 3MF 装配层级重建 `CompoundShape`（方案 §2.1 / 第 5 步「导入归一」）。\n \n 见 `ThreemfArchive.hierarchy` / `localGeomById`：节点带相对父位姿（行主序 3×4，\n * 平移在末列，与写出器 `transformToMatrix12` 同源）；几何来自 `localGeomById` 的未烘焙\n * 局部网格。叶节点的最终 `Shape.transform` 即该相对位姿（写回 `Shape.transform`，供\n * 后续导出按 3MF `<component transform>` 原样还原——D1 往返）。容器节点落为\n * `CompoundShape`（不含 `transform` / `meta`，与 `shape.ts` 的 `CompoundShape` 形态一致）。\n \n 注：`shape.ts` 的 `CompoundShape.children` 当前声明为 `Shape[]`（非递归），故嵌套装配\n * 在类型层面暂不表达；运行时子节点可为子 `CompoundShape`（由 `isCompoundLike` 结构判定消费）。\n * 把 `CompoundShape` 改为递归类型是独立的后续重构（会波及 faijs-extra / cad-runtime），本步\n * 以最小改动桥接——见下方 `children` 处的收窄断言。\n \n 仅在存在真实装配（多 item 或任一 item 带 components）时返回非空；单零件平铺导入返回\n * `undefined`（由调用方决定是否挂载到 `result.assembly`，避免改变单零件结果形状）。\n /\nfunction buildAssemblyFromArchive(\n hierarchy: ThreemfNode[],\n localGeomById: Map<number, ThreemfObject>,\n): Shape \| CompoundShape \| undefined {\n const hasHierarchy = hierarchy.length > 1 \|\| hierarchy.some((n) => (n.children?.length ?? 0) > 0)\n if (!hasHierarchy) return undefined\n\n const buildNode = (node: ThreemfNode): Shape \| CompoundShape => {\n const obj = localGeomById.get(node.objectId)\n if (node.children && node.children.length > 0) {\n // 收窄断言：共享 CompoundShape 非递归声明，运行时子节点可含子 CompoundShape。\n return { kind: 'compound', children: node.children.map(buildNode) as Shape[] }\n }\n // 叶节点：局部几何 + 相对父位姿。\n if (!obj \|\| !obj.positions \|\| !obj.indices) {\n return { kind: 'compound', children: [] }\n }\n const leaf = threemfObjectToShape(obj)\n if (node.transform) {\n ;(leaf as Shape & { transform?: unknown }).transform = { matrix: Array.from(node.transform) }\n }\n return leaf\n }\n\n return hierarchy.length === 1\n ? buildNode(hierarchy[0])\n : { kind: 'compound', children: hierarchy.map(buildNode) as Shape[] }\n}\n\n/* Bambu 显示视图数据 → ImportModel.bambuViews（无任何 Bambu 结构时省略）。 */\nfunction buildBambuViews(\n bambu: import('./threemf-bambu').Bambu3mfMetadata,\n): ImportModel['bambuViews'] \| undefined {\n const plates = [...bambu.plates.keys()].sort((a, b) => a - b)\n if (plates.length === 0 && !bambu.assembleTransforms && !bambu.importTransforms) return undefined\n const views: NonNullable<ImportModel['bambuViews']> = { plates }\n if (bambu.assembleTransforms) {\n views.assembleTransforms = Object.fromEntries(\n [...bambu.assembleTransforms].map(([k, v]) => [k, { transform: v.transform, offset: v.offset }]),\n )\n }\n if (bambu.importTransforms) {\n views.importTransforms = Object.fromEntries(\n [...bambu.importTransforms].map(([k, v]) => [k, { matrix: v.matrix, sourceOffset: v.sourceOffset }]),\n )\n }\n // P4：完整消费面随结果回传——宿主重建 Bambu3mfMetadata 不再回读 archive。\n if (bambu.buildItems) {\n views.buildItems = bambu.buildItems.map((b) => ({\n objectId: b.objectId,\n transform: b.transform ?? null,\n }))\n }\n if (bambu.filamentColors.length > 0) views.filamentColors = bambu.filamentColors\n if (bambu.filamentTypes.length > 0) views.filamentTypes = bambu.filamentTypes\n if (bambu.parts.length > 0) {\n views.parts = bambu.parts.map((p) => ({\n partIndex: p.partIndex,\n objectId: p.objectId,\n partId: p.partId,\n name: p.name,\n extruder: p.extruder,\n plateId: p.plateId,\n }))\n }\n return views\n}\n"]}
1	+ {"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n mesh IO API — headless 文件加载\n \n STL 由 core 自持的 `mesh/stl-loader.ts` 解析（零 three addons）；3MF 由\n * `mesh/threemf-loader.ts` 解析（ZIP 解压 + XML，单位换算到 mm 基准）。\n * 坐标永远以 faijs 基准长度单位（mm）存储 — Shape 不贴 unit 标签（D3）。\n \n 单位换算边界（unit-system §5.2）：\n * - 本模块只处理 mesh 格式（STL/3MF），坐标可直接折算 → `opts.unit` 提供即\n * 强制设置模型的源单位（直接指定，覆盖/忽略模型内部记录的单位——STL 无\n * 内部单位、3MF `<model unit>` 声明被覆盖），按 `unitScale(unit)` 折算坐标。\n * 它只可能来自调用方的显式知识（脚本作者手写 `cad.load({ file, unit })`、\n * 或宿主让用户选定单位后传入）；调用方不知道单位时必须省略——省略时：\n * STL 走 faijs 启发式（`guessStlUnit`，unified 方案 §6.1/§8 —— 3d_editor\n * 迁移回归的单位断言依赖此行为）、3MF 走文件 `<model unit>`（无声明 →\n * millimeter）。猜测/折算收敛在 faijs 内（红线 R0：宿主不自实现单位换算），\n * G0 = 折算后坐标，渲染 = 拓扑 = G0。\n * - STEP/.brep 不经过本模块（走 BREP 链，load op 内 OCCT 读取）：OCCT 按\n * 文件内部单位声明折算（SI_UNIT），不支持强制设置单位——load op 对\n * BREP 路径 + 用户显式 unit 直接明确报错（不缩放、不 workaround）。\n * - 3MF `<model unit>` 由解析器读取并换算（micron/mm/cm/inch/foot/meter）。\n \n 返回契约（unit-system §10.6）：`importFile` 返回 `{ shape, unit }` — `unit`\n * 是文件源单位（必然有值；faijs 是单一真源）：3MF 取 opts.unit（强制）或文件\n * 声明（无声明 → millimeter），STL 取 opts.unit 或 guessStlUnit 启发式猜测。\n * 坐标恒为基准值 — `unit` 只作元数据（sourceUnit 记录、导出目标判定），绝不\n * 参与几何缩放（读入折算已由解析器完成，二次缩放 = 双重换算）。\n /\n\nimport { geoToManifoldMesh } from '../boolean/geo-convert'\nimport { parseStl } from './stl-loader'\nimport { boundingBox } from './query'\nimport { parseThreemf, type ThreemfObject, type ThreemfNode } from './threemf-loader'\nimport { parseBambu3mfFromEntries } from './threemf-bambu'\nimport { unitScale, type UnitName } from '../units'\nimport { guessStlUnit } from './stl-unit'\nimport type { Shape } from './types'\nimport type { CompoundShape } from '../shape'\nimport type { PbrAppearance } from '../api/appearance'\nimport type { FileMeta } from '../api/meta'\nimport type { ImportModel } from './import-model'\n\n/* Result of a unit-aware file import. /\nexport interface ImportFileResult {\n shape: Shape\n /\n All parts the file declared, in declaration order (3MF `<build><item>` 序 /\n * STL 单零件)。`shape` is `parts[0]`（单零件兼容，过渡期）。\n * P0（2026-10-06-step-3mf-multipart-import-plan.md §5.4）：多对象 3MF 不再折叠。\n /\n parts: Shape[]\n /\n The file's source unit (always present; faijs is the single source of truth).\n * 3MF: opts.unit (forced) if provided, else the file's declared unit\n * (无声明 → millimeter). STL: opts.unit (forced) if provided, else the\n * guessStlUnit heuristic result. STEP/BREP 不经过本模块（OCCT 链不支持\n * 强制设置单位，load op 报错）。\n * Metadata only — coordinates are already in the faijs base unit (mm).\n /\n unit: UnitName\n /\n Total parts the single file declared (e.g. 3MF `<build>` object count),\n * present only when > 1. Single-part mesh (STL, single-object 3MF) omits it.\n * 保留为 `parts.length`（>1 时）；多零件不再折叠后该字段仅供旧宿主判断。\n /\n multiPartCount?: number\n /\n 整体级元数据（文件级；方案 §5.1 3MF `<model><metadata>`）。STL/STEP 视实现\n * 是否解析；无声明则省略。仅随导入结果上抛，不挂 Shape。\n /\n fileMeta?: FileMeta\n /\n 本次导入的结构数据（P0 §5.1）：零件身份表 + Bambu 视图（3MF 分支填充）。\n * 单/多零件均登记（单零件 parts 长度 1）。\n /\n importModel?: ImportModel\n /\n 装配层级（方案 2026-10-08 §2.1 / 第 5 步「导入归一」）：当 3MF 含 `<components>`\n * 装配结构时，按层级重建为 `CompoundShape`，每个子节点携带相对父的 `transform`\n * （来自 3MF `<component transform>` / build `<item transform>`，行主序 3×4，平移在\n * 末列，与写出器同源）。仅当存在真实装配（多 item 或任一 item 带 components）时存在；\n * 单零件平铺导入不走它（`shape` / `parts` 已覆盖）。viewer 用 `parts`（已烘焙实例），\n * 往返/层级消费者用 `assembly`（局部几何 + 节点 transform）。\n /\n assembly?: Shape \| CompoundShape\n}\n\n/* SI prefixes that may precede .METRE. in a STEP SI_UNIT, → faijs UnitName. /\nconst SI_PREFIX_TO_UNIT: Record<string, UnitName> = {\n '.MILLI.': 'mm',\n '.CENTI.': 'cm',\n '$': 'm',\n}\n\n/* CONVERSION_BASED_UNIT names (uppercased) found in real-world STEP files. /\nconst CONVERSION_NAME_TO_UNIT: Record<string, UnitName> = {\n 'METRE': 'm',\n 'METER': 'm',\n 'MILLIMETRE': 'mm',\n 'MILLIMETER': 'mm',\n 'CENTIMETRE': 'cm',\n 'CENTIMETER': 'cm',\n 'MICROMETRE': 'micron',\n 'MICROMETER': 'micron',\n 'INCH': 'inch',\n 'FOOT': 'foot',\n}\n\n/\n Bounded scan window for `detectStepUnit`. Unit entities sit at the front of\n * the DATA section (right after the product/context blocks); 256 KiB covers\n * every real-world header+context preamble observed so far. Recomputable\n * constant — raise if a fixture ever misses.\n /\nexport const STEP_UNIT_SCAN_PREFIX = 256 1024\n\n/*\n Parse the declared length unit from STEP text (unit-system §10.4).\n \n Unit entities live in the DATA section (not HEADER — ISO 10303-21 reserves\n * HEADER for FILE_DESCRIPTION/FILE_NAME/FILE_SCHEMA), near its start. We scan\n * a bounded prefix; the justification is \"unit entities sit at the front of\n * the DATA section\", not \"top of file\".\n \n Recognized forms, both attached to a LENGTH_UNIT():\n * - `SI_UNIT(<prefix>, .METRE.)` — prefix `.MILLI.`/`.CENTI.`/`.MICRO.` or `$`.\n * - `CONVERSION_BASED_UNIT('<NAME>', #n)` — inch/foot/etc.\n \n Metadata only — NEVER used to scale geometry (OCCT already normalizes on\n * read; re-scaling = double conversion).\n \n @param stepText - the full STEP file text to scan (only a bounded prefix is read).\n * @returns the faijs UnitName, or null when no length-unit declaration is found\n * (STEP permits omitting it; caller falls back to the base unit).\n /\nexport function detectStepUnit(stepText: string): UnitName \| null {\n const head = stepText.slice(0, STEP_UNIT_SCAN_PREFIX)\n\n // 1) CONVERSION_BASED_UNIT('<NAME>', #n) — non-SI units (inch/foot/…).\n const conv = head.match(/CONVERSION_BASED_UNIT\\s\$\\s'([^']+)'/i)\n if (conv) {\n const mapped = CONVERSION_NAME_TO_UNIT[conv[1].toUpperCase()]\n if (mapped) return mapped\n }\n\n // 2) SI_UNIT(<prefix>, .METRE.) — the .METRE. guard excludes angle entities\n // (they carry .RADIAN./.STERADIAN., never .METRE.).\n const si = head.match(/SI_UNIT\\s\\(\\s([^)]?)\\s,\\s\\.METRE\\.\\s\$/i)\n if (si) {\n const prefix = si[1].trim().toUpperCase()\n if (prefix === '.MICRO.') return 'micron'\n const mapped = SI_PREFIX_TO_UNIT[prefix]\n if (mapped) return mapped\n }\n\n return null\n}\n\n/\n Load geometry from raw file bytes (headless variant).\n \n @param buffer - the raw file bytes to parse (already decompressed; stpz\n * unzipping is the caller's job — faijs never unzips implicitly).\n * @param format - format identifier such as 'stl', '3mf'/'threemf' or 'step'\n * (defaults to 'stl'). 仅 mesh 格式（STL/3MF）走本模块；STEP/BREP 走\n * BREP 链（load op 内 OCCT 读取，不支持强制设置单位）。\n * @param opts - optional settings; `unit` (a UnitName string) *force-sets the\n model's source unit** (STL/3MF): it is NOT a default, it directly specifies\n * the unit and overrides/ignores any unit recorded inside the model (3MF\n * `<model unit>`; STL has none), geometry scaled by `unitScale(unit)`. Only\n * provide it when the caller actually knows the unit (author-written\n * `cad.load({ file, unit })`, or a host unit picker). When the caller does\n * NOT know the unit, it MUST omit `unit` — STL then guesses via\n * `guessStlUnit` (the only allowed guessing path), 3MF uses the file\n * declaration (none → millimeter). A wrong explicit unit scales geometry\n * wrongly and is never re-guessed.\n * @returns the shape with base-unit coordinates plus the file's source unit\n * (`unit`, metadata only; always present — faijs is the single source of truth).\n /\nexport async function importFile(\n buffer: ArrayBuffer,\n format?: string,\n opts?: { unit?: UnitName },\n): Promise<ImportFileResult> {\n const fmt = (format ?? 'stl').toLowerCase()\n\n if (fmt === '3mf' \|\| fmt === 'threemf') {\n const archive = await parseThreemf(buffer, opts)\n // P0（方案 §5.4）：不再折叠——返回全部 `<build><item>` 对象（declaration order，\n // 坐标已在 parseThreemf 里折算为 faijs 基准单位）。`shape` 保留为 parts[0]\n // （单零件兼容，过渡期）。\n if (archive.objects.length === 0) {\n throw new Error('[mesh/io] 3MF contains no objects')\n }\n // Bambu 元数据（盘号/挤出机/视图变换）：有 Bambu 配置才产生内容，普通 3MF 返回空表。\n // P4：根 model XML 直传（3MF `<build>` 在 resources 前；id 两套编号经父\n // object components 关联——leafParts 表承载）。\n const bambu = parseBambu3mfFromEntries(archive.extraEntries, archive.modelXml)\n const parts = archive.objects.map(threemfObjectToShape)\n const multiPartCount = parts.length > 1 ? parts.length : undefined\n const importModel: ImportModel = {\n format: '3mf',\n unit: archive.unit,\n parts: archive.objects.map((obj, i) => {\n const part: ImportModel['parts'][number] = {\n index: i,\n name: obj.name ?? `imported:${i}`,\n }\n if (obj.baseColor) part.color = [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]]\n if (obj.meta) part.meta = obj.meta\n // Bambu 身份：3MF `<object id>`（叶子实例）与 Bambu objects 表（键为\n // model_settings 父对象 id）是两套编号——经父 object components 关联\n // （ThreemfObject.parentObjectId/componentIndex → bambu.leafParts）。\n const bm = obj.parentObjectId !== undefined\n ? bambu.leafParts.get(`${obj.parentObjectId}:${obj.componentIndex ?? 1}`)\n : undefined\n if (bm) {\n part.objectId = bm.objectId\n if (bm.plateId > 0) part.plateId = bm.plateId\n // Bambu extruder 1-based（默认 1）：显式登记文件声明值\n part.extruder = bm.extruder\n part.partId = bm.partId\n }\n return part\n }),\n ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n }\n const bambuViews = buildBambuViews(bambu)\n if (bambuViews) importModel.bambuViews = bambuViews\n // 装配层级重建（方案 §2.1 / 第 5 步）：含 `<components>` 时还原 CompoundShape，\n // 叶节点携带相对父 transform；单零件平铺导入不挂载。\n const assembly = archive.hierarchy && archive.localGeomById\n ? buildAssemblyFromArchive(archive.hierarchy, archive.localGeomById)\n : undefined\n return {\n shape: parts[0],\n parts,\n unit: archive.unit,\n multiPartCount,\n importModel,\n // 整体级元数据（`<model><metadata>`）随导入结果上抛（方案 §5.1）。\n ...(archive.fileMeta ? { fileMeta: archive.fileMeta } : {}),\n ...(assembly ? { assembly } : {}),\n }\n }\n\n if (fmt === 'stl') {\n const geo = parseStl(buffer)\n // STL 无单位声明：opts.unit 显式声明优先；未声明时做启发式猜测\n // （guessStlUnit —— 历史 host 行为，unified §6.1/§8 迁移基线）。猜测与\n // 折算都在 faijs 内完成（红线 R0），G0 即基准值，宿主不再二次换算。\n // unit 字段回传源单位（声明值或猜测值），供宿主记录 sourceUnit 元数据。\n let scale = 1\n let sourceUnit: UnitName = 'mm'\n const declared = opts?.unit\n if (declared) {\n sourceUnit = declared\n scale = unitScale(declared)\n } else {\n const bb = boundingBox(geo)\n if (bb.min[0] !== Infinity) {\n sourceUnit = guessStlUnit({\n min: [bb.min[0], bb.min[1], bb.min[2]],\n max: [bb.max[0], bb.max[1], bb.max[2]],\n })\n scale = unitScale(sourceUnit)\n }\n }\n if (scale !== 1) {\n const arr = geo.positions\n for (let i = 0; i < arr.length; i++) arr[i] = scale\n }\n const shape = geoToManifoldMesh(geo)\n return { shape, parts: [shape], unit: sourceUnit }\n }\n\n // STEP goes through the BREP chain (loadBrep → OCCT, which normalizes to the\n // base unit on read). The mesh io path has no kernel-independent STEP parser\n // and must not fake one — a missing path is an error, not a fallback.\n throw new Error(`[mesh/io] unsupported format: ${fmt}`)\n}\n\n/** 单个 3MF `<build><item>` 对象 → Shape（P0：逐对象构造，替换原\"只取第一个\"收敛）。 /\nfunction threemfObjectToShape(obj: ThreemfObject): Shape {\n return {\n positions: obj.positions as Float32Array,\n indices: obj.indices as Uint32Array,\n // P2（方案 §5 3MF 行）：对象级 baseColor → appearance.color（sRGB 原值，\n // 宽容兼容：无 baseColor 不带 appearance）。colorgroup（vertexColors）与\n // 逐三角形材质属 Phase 2（materialGroups / vertexColors），P2 不映射。\n ...(obj.baseColor ? { appearance: { color: [obj.baseColor[0], obj.baseColor[1], obj.baseColor[2]] } } : {}),\n // P4（方案 §5 3MF 行）：逐三角形 basematerials（p1=p2=p3）→ materialGroups\n // （三角形区间 + appearance.color）；无则不带。vertexColors（colorgroup）\n // 由上层（编辑器导入路径）消费，io 单零件收敛不展开为材质分组。\n ...(obj.materialGroups && obj.materialGroups.length > 0\n ? {\n materialGroups: obj.materialGroups.map((g) => ({\n start: g.start,\n count: g.count,\n appearance: { color: [g.color[0], g.color[1], g.color[2]] } as PbrAppearance,\n })),\n }\n : {}),\n // 零件级元数据（方案 §5.1 3MF 行）：对象 name/partnumber/metadatagroup → meta。\n ...(obj.meta ? { meta: obj.meta } : {}),\n }\n}\n\n/\n 由 3MF 装配层级重建 `CompoundShape`（方案 §2.1 / 第 5 步「导入归一」）。\n \n 见 `ThreemfArchive.hierarchy` / `localGeomById`：节点带相对父位姿（行主序 3×4，\n * 平移在末列，与写出器 `transformToMatrix12` 同源）；几何来自 `localGeomById` 的未烘焙\n * 局部网格。叶节点的最终 `Shape.transform` 即该相对位姿（写回 `Shape.transform`，供\n * 后续导出按 3MF `<component transform>` 原样还原——D1 往返）。容器节点落为\n * `CompoundShape`（不含 `transform` / `meta`，与 `shape.ts` 的 `CompoundShape` 形态一致）。\n \n 注：`shape.ts` 的 `CompoundShape.children` 当前声明为 `Shape[]`（非递归），故嵌套装配\n * 在类型层面暂不表达；运行时子节点可为子 `CompoundShape`（由 `isCompoundLike` 结构判定消费）。\n * 把 `CompoundShape` 改为递归类型是独立的后续重构（会波及 faijs-extra / cad-runtime），本步\n * 以最小改动桥接——见下方 `children` 处的收窄断言。\n \n 仅在存在真实装配（多 item 或任一 item 带 components）时返回非空；单零件平铺导入返回\n * `undefined`（由调用方决定是否挂载到 `result.assembly`，避免改变单零件结果形状）。\n /\nfunction buildAssemblyFromArchive(\n hierarchy: ThreemfNode[],\n localGeomById: Map<number, ThreemfObject>,\n): Shape \| CompoundShape \| undefined {\n const hasHierarchy = hierarchy.length > 1 \|\| hierarchy.some((n) => (n.children?.length ?? 0) > 0)\n if (!hasHierarchy) return undefined\n\n const buildNode = (node: ThreemfNode): Shape \| CompoundShape => {\n const obj = localGeomById.get(node.objectId)\n if (node.children && node.children.length > 0) {\n // 收窄断言：共享 CompoundShape 非递归声明，运行时子节点可含子 CompoundShape。\n return { kind: 'compound', children: node.children.map(buildNode) as Shape[] }\n }\n // 叶节点：局部几何 + 相对父位姿。\n if (!obj \|\| !obj.positions \|\| !obj.indices) {\n return { kind: 'compound', children: [] }\n }\n const leaf = threemfObjectToShape(obj)\n if (node.transform) {\n ;(leaf as Shape & { transform?: unknown }).transform = { matrix: Array.from(node.transform) }\n }\n return leaf\n }\n\n return hierarchy.length === 1\n ? buildNode(hierarchy[0])\n : { kind: 'compound', children: hierarchy.map(buildNode) as Shape[] }\n}\n\n/* Bambu 显示视图数据 → ImportModel.bambuViews（无任何 Bambu 结构时省略）。 */\nfunction buildBambuViews(\n bambu: import('./threemf-bambu').Bambu3mfMetadata,\n): ImportModel['bambuViews'] \| undefined {\n const plates = [...bambu.plates.keys()].sort((a, b) => a - b)\n if (plates.length === 0 && !bambu.assembleTransforms && !bambu.importTransforms) return undefined\n const views: NonNullable<ImportModel['bambuViews']> = { plates }\n if (bambu.assembleTransforms) {\n views.assembleTransforms = Object.fromEntries(\n [...bambu.assembleTransforms].map(([k, v]) => [k, { transform: v.transform, offset: v.offset }]),\n )\n }\n if (bambu.importTransforms) {\n views.importTransforms = Object.fromEntries(\n [...bambu.importTransforms].map(([k, v]) => [k, { matrix: v.matrix, sourceOffset: v.sourceOffset }]),\n )\n }\n // P4：完整消费面随结果回传——宿主重建 Bambu3mfMetadata 不再回读 archive。\n if (bambu.buildItems) {\n views.buildItems = bambu.buildItems.map((b) => ({\n objectId: b.objectId,\n transform: b.transform ?? null,\n }))\n }\n if (bambu.filamentColors.length > 0) views.filamentColors = bambu.filamentColors\n if (bambu.filamentTypes.length > 0) views.filamentTypes = bambu.filamentTypes\n if (bambu.parts.length > 0) {\n views.parts = bambu.parts.map((p) => ({\n partIndex: p.partIndex,\n objectId: p.objectId,\n partId: p.partId,\n name: p.name,\n extruder: p.extruder,\n plateId: p.plateId,\n }))\n }\n return views\n}\n"]}

package/dist/mesh/knurl/KnurlGenerator.d.ts CHANGED Viewed

@@ -6,7 +6,8 @@
  *
  * 全程在 mesh 局部空间工作，不需要 world matrix 变换。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C } from '../../math3d/index.js';
+import type { Shape } from '../types.js';
 /**
  * Knurling texture-displacement parameters: texture height, inversion,
  * subdivision resolution, UV scale/offset/rotation, mapping mode, seam
@@ -44,10 +45,10 @@ export interface KnurlParams {
 }
 /** 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） */
 export interface KnurlBounds {
-    min: THREE.Vector3;
-    max: THREE.Vector3;
-    size: THREE.Vector3;
-    center: THREE.Vector3;
+    min: Vec3C;
+    max: Vec3C;
+    size: Vec3C;
+    center: Vec3C;
 }
 /** Default knurling parameters, used for every field the caller leaves unset. */
 export declare const KNURL_DEFAULTS: KnurlParams;
@@ -68,10 +69,10 @@ export declare const KNURL_DEFAULTS: KnurlParams;
  * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.
  * @returns the displaced geometry.
  */
-export declare function applyKnurlDisplacement(geometry: THREE.BufferGeometry, params: KnurlParams, onProgress?: (stage: string, p: number) => void,
+export declare function applyKnurlDisplacement(geometry: Shape, params: KnurlParams, onProgress?: (stage: string, p: number) => void,
 /** External whole-part bounds (defaults to the geometry's own bounds).
  *  Passing the whole part's bounds keeps texture density consistent with the
  *  GPU preview, which normalizes against the part bbox while this geometry
  *  is often only the selected-face subset. */
-boundsOverride?: KnurlBounds): Promise<THREE.BufferGeometry>;
+boundsOverride?: KnurlBounds): Promise<Shape>;
 //# sourceMappingURL=KnurlGenerator.d.ts.map

package/dist/mesh/knurl/KnurlGenerator.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"KnurlGenerator.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,~~KAAK~~,KAAK,MAAM,OAAO,CAAA;~~AAQ9B~~;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CAClC;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~IAClB~~,GAAG,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~IAClB~~,IAAI,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~IACnB~~,MAAM,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~CACtB~~;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,KAAK,~~CAAC~~,~~cAAc,EAC9B,~~MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI;AAC/C;;;8CAG8C;AAC9C,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,KAAK,CAAC,~~cAAc,CAAC,CAkG/B~~"}
1	+ {"version":3,"file":"KnurlGenerator.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,cAAc,CAAA;AAM5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAIrC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CAClC;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,KAAK,CAAA;IACV,GAAG,EAAE,KAAK,CAAA;IACV,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,EAAE,KAAK,CAAA;CACd;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,KAAK,EACf,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI;AAC/C;;;8CAG8C;AAC9C,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,KAAK,CAAC,CAiGhB"}

package/dist/mesh/knurl/KnurlGenerator.js CHANGED Viewed

@@ -6,11 +6,12 @@
  *
  * 全程在 mesh 局部空间工作，不需要 world matrix 变换。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C } from '../../math3d/index.js';
 import { subdivide } from './subdivision.js';
 import { applyDisplacement } from './displacement.js';
 import { loadKnurlingTexture } from './textureLoader.js';
 import { MODE_TRIPLANAR } from './mapping.js';
+import { boundingBox } from '../query.js';
 /** Default knurling parameters, used for every field the caller leaves unset. */
 export const KNURL_DEFAULTS = {
     textureHeight: 0.5,
@@ -69,13 +70,14 @@ boundsOverride) {
     const bounds = boundsOverride
         ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }
         : (() => {
-            geometry.computeBoundingBox();
-            const bb = geometry.boundingBox;
+            const bb = boundingBox(geometry);
+            const bbMin = new Vec3C(bb.min[0], bb.min[1], bb.min[2]);
+            const bbMax = new Vec3C(bb.max[0], bb.max[1], bb.max[2]);
             return {
-                min: bb.min.clone(),
-                max: bb.max.clone(),
-                size: new THREE.Vector3().subVectors(bb.max, bb.min),
-                center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),
+                min: bbMin,
+                max: bbMax,
+                size: new Vec3C().subVectors(bbMax, bbMin),
+                center: new Vec3C().addVectors(bbMin, bbMax).multiplyScalar(0.5),
             };
         })();
     // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），
@@ -109,8 +111,6 @@ boundsOverride) {
         seamBandWidth,
     };
     const result = applyDisplacement(subdivided, texData, texData.width, texData.height, settings, bounds, (p) => onProgress?.('displace', p));
-    // 5. 释放中间几何体
-    subdivided.dispose();
     return result;
 }
 //# sourceMappingURL=KnurlGenerator.js.map

package/dist/mesh/knurl/KnurlGenerator.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"KnurlGenerator.js","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,~~KAAK~~,KAAK,MAAM,~~OAAO~~,CAAA;~~AAC9B~~,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAA6B,MAAM,gBAAgB,CAAA;AAC7E,OAAO,EAAE,mBAAmB,EAAoB,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;~~AAgD1C~~,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,aAAa,EAAE,GAAG;IAClB,kBAAkB,EAAE,KAAK;IACzB,YAAY,EAAE,GAAG;IACjB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,cAAc;IAC3B,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,IAAI;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,~~QAA8B~~,~~EAC9B~~,MAAmB,EACnB,UAA+C;AAC/C;;;8CAG8C;AAC9C,cAA4B;IAE5B,MAAM,EACJ,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,MAAM,EACN,WAAW,EACX,OAAO,GAAG,CAAC,EACX,OAAO,GAAG,CAAC,EACX,QAAQ,GAAG,CAAC,EACZ,gBAAgB,GAAG,CAAC,EACpB,aAAa,GAAG,CAAC,EACjB,YAAY,GAAG,CAAC,EAChB,aAAa,GAAG,GAAG,EACnB,WAAW,GAAG,IAAI,GACnB,GAAG,MAAM,CAAA;IAEV,UAAU;IACV,UAAU,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC1B,IAAI,OAA2B,CAAA;IAC/B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAA;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,GAAG,CAAC,CAAA;QAC9D,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IACzH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IAED,mCAAmC;IACnC,MAAM,MAAM,GAAgB,cAAc;QACxC,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE;QAChH,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,~~QAAQ~~,CAAC,~~kBAAkB~~,~~EAAE~~,CAAA;~~YAC7B~~,MAAM,~~EAAE~~,GAAG,~~QAAQ~~,CAAC,~~WAAY~~,~~CAAA;YAChC~~,~~OAAO;gBACL,~~GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,~~KAAK~~,~~EAAE;gBACnB~~,~~GAAG,~~EAAE,EAAE,CAAC,GAAG,CAAC,~~KAAK~~,~~EAAE~~;~~gBACnB~~,~~IAAI~~,~~EAAE~~,IAAI,KAAK,CAAC,~~OAAO,~~EAAE,CAAC,~~UAAU~~,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC;~~gBACpD~~,~~MAAM~~,EAAE,~~IAAI~~,KAAK,~~CAAC~~,~~OAAO~~,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,~~GAAG~~,EAAE,EAAE,CAAC,~~GAAG~~,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC;~~aAC3E~~,CAAA;QACH,CAAC,CAAC,EAAE,CAAA;IAER,mCAAmC;IACnC,8CAA8C;IAC9C,sCAAsC;IACtC,yCAAyC;IACzC,yCAAyC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,CAAA,CAAC,mBAAmB;IACvE,MAAM,mBAAmB,GAAG,WAAW,GAAG,CAAC,CAAA;IAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,CAAA;IAElF,QAAQ;IACR,UAAU,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAC5B,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,SAAS,CAC9C,QAAQ,EACR,eAAe,EACf,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EACnC,WAAW,CACZ,CAAA;IAED,QAAQ;IACR,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;IAC3B,MAAM,QAAQ,GAAyB;QACrC,WAAW;QACX,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;QACP,QAAQ;QACR,mDAAmD;QACnD,qDAAqD;QACrD,SAAS,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa;QACxD,qBAAqB,EAAE,IAAI;QAC3B,gBAAgB;QAChB,aAAa;QACb,YAAY;QACZ,aAAa;KACd,CAAA;IAED,MAAM,MAAM,GAAG,iBAAiB,CAC9B,UAAU,EACV,OAAO,EACP,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,MAAM,EACd,QAAQ,EACR,MAAM,EACN,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CACnC,CAAA;~~IAED~~,~~aAAa;IACb,UAAU,CAAC,~~OAAO,~~EAAE,CAAA;IAEpB,OAAO,~~MAAM,CAAA;AACf,CAAC","sourcesContent":["/*\n KnurlGenerator — 滚花纹理位移管线编排器\n \n 完全照搬 stlTexturizer 的管线：subdivide → applyDisplacement。\n * 使用 knurling.jpg 作为位移纹理。\n \n 全程在 mesh 局部空间工作，不需要 world matrix 变换。\n /\n\nimport as ~~THREE~~ from '~~three~~'\nimport { subdivide } from './subdivision'\nimport { applyDisplacement, type DisplacementSettings } from './displacement'\nimport { loadKnurlingTexture, type TextureData } from './textureLoader'\nimport { MODE_TRIPLANAR } from './mapping'\n\n// ── Types ──\n\n/*\n Knurling texture-displacement parameters: texture height, inversion,\n * subdivision resolution, UV scale/offset/rotation, mapping mode, seam\n * blending, and angle-based face masking limits.\n /\nexport interface KnurlParams {\n /* 纹理高度 (mm)，默认 0.5 /\n textureHeight: number\n /* 反向（内推而非外推），默认 false /\n invertDisplacement: boolean\n /* 分辨率 (mm) — 细分后最大边长，默认 1.0 /\n refineLength: number\n /* U 缩放，默认 0.15（knurling 专用） /\n scaleU: number\n /* V 缩放，默认 0.15 /\n scaleV: number\n /* 投影模式，默认 5 (Triplanar) /\n mappingMode: number\n /* UV 偏移 U，默认 0 /\n offsetU?: number\n /* UV 偏移 V，默认 0 /\n offsetV?: number\n /* UV 旋转（度），默认 0 /\n rotation?: number\n /* 底面角度遮罩（度），默认 5 /\n bottomAngleLimit?: number\n /* 顶面角度遮罩（度），默认 0（不遮罩） /\n topAngleLimit?: number\n /* 接缝混合，默认 1 /\n mappingBlend?: number\n /* 接缝带宽，默认 0.5 /\n seamBandWidth?: number\n /* 面排除权重（By Surface 用），null = 不排除 /\n faceWeights?: Float32Array \| null\n}\n\n/* 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） /\nexport interface KnurlBounds {\n min: ~~THREE.Vector3~~\n max: ~~THREE.Vector3~~\n size: ~~THREE.Vector3~~\n center: ~~THREE.Vector3~~\n}\n\n/* Default knurling parameters, used for every field the caller leaves unset. /\nexport const KNURL_DEFAULTS: KnurlParams = {\n textureHeight: 0.5,\n invertDisplacement: false,\n refineLength: 1.0,\n scaleU: 0.15,\n scaleV: 0.15,\n mappingMode: MODE_TRIPLANAR,\n offsetU: 0,\n offsetV: 0,\n rotation: 0,\n bottomAngleLimit: 5,\n topAngleLimit: 0,\n mappingBlend: 1,\n seamBandWidth: 0.5,\n faceWeights: null,\n}\n\n/\n Apply a knurling texture displacement to a geometry, entirely in mesh-local\n * space. Pipeline:\n * 1. Load the knurling texture as ImageData.\n * 2. Subdivide the geometry to the effective refine length.\n * 3. Displace the subdivided vertices along their smoothed normals.\n \n The effective refine length is never coarser than the caller's\n * `refineLength`: it is clamped so each texture tile keeps ~8 segments when\n * the requested resolution would alias the fine diamond pattern.\n \n @param geometry - the source geometry (mesh-local space).\n * @param params - knurl parameters.\n * @param onProgress - optional callback reporting stage and progress ('texture' \| 'subdivide' \| 'displace').\n * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.\n * @returns the displaced geometry.\n /\nexport async function applyKnurlDisplacement(\n geometry: ~~THREE.BufferGeometry~~,\n params: KnurlParams,\n onProgress?: (stage: string, p: number) => void,\n /* External whole-part bounds (defaults to the geometry's own bounds).\n * Passing the whole part's bounds keeps texture density consistent with the\n * GPU preview, which normalizes against the part bbox while this geometry\n * is often only the selected-face subset. /\n boundsOverride?: KnurlBounds,\n): Promise<~~THREE.BufferGeometry~~> {\n const {\n textureHeight,\n invertDisplacement,\n refineLength,\n scaleU,\n scaleV,\n mappingMode,\n offsetU = 0,\n offsetV = 0,\n rotation = 0,\n bottomAngleLimit = 5,\n topAngleLimit = 0,\n mappingBlend = 1,\n seamBandWidth = 0.5,\n faceWeights = null,\n } = params\n\n // 1. 加载纹理\n onProgress?.('texture', 0)\n let texData: TextureData \| null\n try {\n texData = await loadKnurlingTexture()\n } catch (err) {\n console.error('[KnurlGenerator] Failed to load texture:', err)\n throw new Error(`Failed to load knurling texture: ${err instanceof Error ? err.message : String(err)}`, { cause: err })\n }\n\n if (!texData) {\n throw new Error('[KnurlGenerator] No texture data available — TextureSampler port not injected')\n }\n\n // 2. 计算几何体边界（优先使用整块部件包围盒，使密度与预览一致）\n const bounds: KnurlBounds = boundsOverride\n ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }\n : (() => {\n geometry~~.computeBoundingBox(~~)\n const bb = ~~geometry~~.~~boundingBox!\~~n return {\n min: ~~bb.min.clone()~~,\n max: ~~bb.max.clone()~~,\n size: new ~~THREE.Vector3~~().subVectors(~~bb.max~~, ~~bb.min~~),\n center: new ~~THREE.Vector3~~().addVectors(~~bb.min~~, ~~bb.max~~).multiplyScalar(0.5),\n }\n })()\n\n // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），\n // 而实刻是真几何位移，受三角形密度限制。若 refineLength 大于滚花纹理\n // 的物理周期，网格采样不足会把细密菱形混叠成更低频、更稀疏的图案，\n // 看起来就比预览\"密度低\"。这里保证每瓦片至少 ~8 段，只在用户设得太\n // 粗时才自动加密——绝不会比用户设定的 refineLength 更粗。\n const maxDim = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n const knurlPeriod = Math.max(maxDim scaleU, 1e-6) // 单个纹理瓦片的物理尺寸 (mm)\n const minRefineForPattern = knurlPeriod / 8\n const effectiveRefine = Math.min(refineLength, Math.max(minRefineForPattern, 0.1))\n\n // 3. 细分\n onProgress?.('subdivide', 0)\n const { geometry: subdivided } = await subdivide(\n geometry,\n effectiveRefine,\n (p) => onProgress?.('subdivide', p),\n faceWeights,\n )\n\n // 4. 位移\n onProgress?.('displace', 0)\n const settings: DisplacementSettings = {\n mappingMode,\n scaleU,\n scaleV,\n offsetU,\n offsetV,\n rotation,\n // 与预览着色器 (knurlPreviewMaterial: h = h - 0.5) 保持一致：\n // 纹理以中灰为 0 的对称高度图，位移范围 [-amplitude/2, +amplitude/2]。\n amplitude: (invertDisplacement ? -1 : 1) * textureHeight,\n symmetricDisplacement: true,\n bottomAngleLimit,\n topAngleLimit,\n mappingBlend,\n seamBandWidth,\n }\n\n const result = applyDisplacement(\n subdivided,\n texData,\n texData.width,\n texData.height,\n settings,\n bounds,\n (p) => onProgress?.('displace', p),\n )\n\n ~~// 5. 释放中间几何体\n subdivided.dispose()~~\n\n return result\n}\n"]}
1	+ {"version":3,"file":"KnurlGenerator.js","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAA6B,MAAM,gBAAgB,CAAA;AAC7E,OAAO,EAAE,mBAAmB,EAAoB,MAAM,iBAAiB,CAAA;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAiDtC,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,aAAa,EAAE,GAAG;IAClB,kBAAkB,EAAE,KAAK;IACzB,YAAY,EAAE,GAAG;IACjB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,IAAI;IACZ,WAAW,EAAE,cAAc;IAC3B,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,IAAI;CAClB,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAAe,EACf,MAAmB,EACnB,UAA+C;AAC/C;;;8CAG8C;AAC9C,cAA4B;IAE5B,MAAM,EACJ,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,MAAM,EACN,MAAM,EACN,WAAW,EACX,OAAO,GAAG,CAAC,EACX,OAAO,GAAG,CAAC,EACX,QAAQ,GAAG,CAAC,EACZ,gBAAgB,GAAG,CAAC,EACpB,aAAa,GAAG,CAAC,EACjB,YAAY,GAAG,CAAC,EAChB,aAAa,GAAG,GAAG,EACnB,WAAW,GAAG,IAAI,GACnB,GAAG,MAAM,CAAA;IAEV,UAAU;IACV,UAAU,EAAE,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;IAC1B,IAAI,OAA2B,CAAA;IAC/B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,mBAAmB,EAAE,CAAA;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,GAAG,CAAC,CAAA;QAC9D,MAAM,IAAI,KAAK,CAAC,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;IACzH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IAED,mCAAmC;IACnC,MAAM,MAAM,GAAgB,cAAc;QACxC,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,MAAM,EAAE;QAChH,CAAC,CAAC,CAAC,GAAG,EAAE;YACJ,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;YAChC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YACxD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YACxD,OAAO;gBACL,GAAG,EAAE,KAAK;gBACV,GAAG,EAAE,KAAK;gBACV,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC;gBAC1C,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC;aACjE,CAAA;QACH,CAAC,CAAC,EAAE,CAAA;IAER,mCAAmC;IACnC,8CAA8C;IAC9C,sCAAsC;IACtC,yCAAyC;IACzC,yCAAyC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,CAAA,CAAC,mBAAmB;IACvE,MAAM,mBAAmB,GAAG,WAAW,GAAG,CAAC,CAAA;IAC3C,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,CAAA;IAElF,QAAQ;IACR,UAAU,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAA;IAC5B,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,SAAS,CAC9C,QAAQ,EACR,eAAe,EACf,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,EACnC,WAAW,CACZ,CAAA;IAED,QAAQ;IACR,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CAAA;IAC3B,MAAM,QAAQ,GAAyB;QACrC,WAAW;QACX,MAAM;QACN,MAAM;QACN,OAAO;QACP,OAAO;QACP,QAAQ;QACR,mDAAmD;QACnD,qDAAqD;QACrD,SAAS,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,aAAa;QACxD,qBAAqB,EAAE,IAAI;QAC3B,gBAAgB;QAChB,aAAa;QACb,YAAY;QACZ,aAAa;KACd,CAAA;IAED,MAAM,MAAM,GAAG,iBAAiB,CAC9B,UAAU,EACV,OAAO,EACP,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,MAAM,EACd,QAAQ,EACR,MAAM,EACN,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,UAAU,EAAE,CAAC,CAAC,CACnC,CAAA;IAGD,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["/*\n KnurlGenerator — 滚花纹理位移管线编排器\n \n 完全照搬 stlTexturizer 的管线：subdivide → applyDisplacement。\n * 使用 knurling.jpg 作为位移纹理。\n \n 全程在 mesh 局部空间工作，不需要 world matrix 变换。\n /\n\nimport { Vec3 as Vec3C } from '../../math3d'\nimport { subdivide } from './subdivision'\nimport { applyDisplacement, type DisplacementSettings } from './displacement'\nimport { loadKnurlingTexture, type TextureData } from './textureLoader'\nimport { MODE_TRIPLANAR } from './mapping'\nimport { boundingBox } from '../query'\nimport type { Shape } from '../types'\n\n// ── Types ──\n\n/\n Knurling texture-displacement parameters: texture height, inversion,\n * subdivision resolution, UV scale/offset/rotation, mapping mode, seam\n * blending, and angle-based face masking limits.\n /\nexport interface KnurlParams {\n /* 纹理高度 (mm)，默认 0.5 /\n textureHeight: number\n /* 反向（内推而非外推），默认 false /\n invertDisplacement: boolean\n /* 分辨率 (mm) — 细分后最大边长，默认 1.0 /\n refineLength: number\n /* U 缩放，默认 0.15（knurling 专用） /\n scaleU: number\n /* V 缩放，默认 0.15 /\n scaleV: number\n /* 投影模式，默认 5 (Triplanar) /\n mappingMode: number\n /* UV 偏移 U，默认 0 /\n offsetU?: number\n /* UV 偏移 V，默认 0 /\n offsetV?: number\n /* UV 旋转（度），默认 0 /\n rotation?: number\n /* 底面角度遮罩（度），默认 5 /\n bottomAngleLimit?: number\n /* 顶面角度遮罩（度），默认 0（不遮罩） /\n topAngleLimit?: number\n /* 接缝混合，默认 1 /\n mappingBlend?: number\n /* 接缝带宽，默认 0.5 /\n seamBandWidth?: number\n /* 面排除权重（By Surface 用），null = 不排除 /\n faceWeights?: Float32Array \| null\n}\n\n/* 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） /\nexport interface KnurlBounds {\n min: Vec3C\n max: Vec3C\n size: Vec3C\n center: Vec3C\n}\n\n/* Default knurling parameters, used for every field the caller leaves unset. /\nexport const KNURL_DEFAULTS: KnurlParams = {\n textureHeight: 0.5,\n invertDisplacement: false,\n refineLength: 1.0,\n scaleU: 0.15,\n scaleV: 0.15,\n mappingMode: MODE_TRIPLANAR,\n offsetU: 0,\n offsetV: 0,\n rotation: 0,\n bottomAngleLimit: 5,\n topAngleLimit: 0,\n mappingBlend: 1,\n seamBandWidth: 0.5,\n faceWeights: null,\n}\n\n/\n Apply a knurling texture displacement to a geometry, entirely in mesh-local\n * space. Pipeline:\n * 1. Load the knurling texture as ImageData.\n * 2. Subdivide the geometry to the effective refine length.\n * 3. Displace the subdivided vertices along their smoothed normals.\n \n The effective refine length is never coarser than the caller's\n * `refineLength`: it is clamped so each texture tile keeps ~8 segments when\n * the requested resolution would alias the fine diamond pattern.\n \n @param geometry - the source geometry (mesh-local space).\n * @param params - knurl parameters.\n * @param onProgress - optional callback reporting stage and progress ('texture' \| 'subdivide' \| 'displace').\n * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.\n * @returns the displaced geometry.\n /\nexport async function applyKnurlDisplacement(\n geometry: Shape,\n params: KnurlParams,\n onProgress?: (stage: string, p: number) => void,\n /* External whole-part bounds (defaults to the geometry's own bounds).\n * Passing the whole part's bounds keeps texture density consistent with the\n * GPU preview, which normalizes against the part bbox while this geometry\n * is often only the selected-face subset. /\n boundsOverride?: KnurlBounds,\n): Promise<Shape> {\n const {\n textureHeight,\n invertDisplacement,\n refineLength,\n scaleU,\n scaleV,\n mappingMode,\n offsetU = 0,\n offsetV = 0,\n rotation = 0,\n bottomAngleLimit = 5,\n topAngleLimit = 0,\n mappingBlend = 1,\n seamBandWidth = 0.5,\n faceWeights = null,\n } = params\n\n // 1. 加载纹理\n onProgress?.('texture', 0)\n let texData: TextureData \| null\n try {\n texData = await loadKnurlingTexture()\n } catch (err) {\n console.error('[KnurlGenerator] Failed to load texture:', err)\n throw new Error(`Failed to load knurling texture: ${err instanceof Error ? err.message : String(err)}`, { cause: err })\n }\n\n if (!texData) {\n throw new Error('[KnurlGenerator] No texture data available — TextureSampler port not injected')\n }\n\n // 2. 计算几何体边界（优先使用整块部件包围盒，使密度与预览一致）\n const bounds: KnurlBounds = boundsOverride\n ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }\n : (() => {\n const bb = boundingBox(geometry)\n const bbMin = new Vec3C(bb.min[0], bb.min[1], bb.min[2])\n const bbMax = new Vec3C(bb.max[0], bb.max[1], bb.max[2])\n return {\n min: bbMin,\n max: bbMax,\n size: new Vec3C().subVectors(bbMax, bbMin),\n center: new Vec3C().addVectors(bbMin, bbMax).multiplyScalar(0.5),\n }\n })()\n\n // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），\n // 而实刻是真几何位移，受三角形密度限制。若 refineLength 大于滚花纹理\n // 的物理周期，网格采样不足会把细密菱形混叠成更低频、更稀疏的图案，\n // 看起来就比预览\"密度低\"。这里保证每瓦片至少 ~8 段，只在用户设得太\n // 粗时才自动加密——绝不会比用户设定的 refineLength 更粗。\n const maxDim = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n const knurlPeriod = Math.max(maxDim scaleU, 1e-6) // 单个纹理瓦片的物理尺寸 (mm)\n const minRefineForPattern = knurlPeriod / 8\n const effectiveRefine = Math.min(refineLength, Math.max(minRefineForPattern, 0.1))\n\n // 3. 细分\n onProgress?.('subdivide', 0)\n const { geometry: subdivided } = await subdivide(\n geometry,\n effectiveRefine,\n (p) => onProgress?.('subdivide', p),\n faceWeights,\n )\n\n // 4. 位移\n onProgress?.('displace', 0)\n const settings: DisplacementSettings = {\n mappingMode,\n scaleU,\n scaleV,\n offsetU,\n offsetV,\n rotation,\n // 与预览着色器 (knurlPreviewMaterial: h = h - 0.5) 保持一致：\n // 纹理以中灰为 0 的对称高度图，位移范围 [-amplitude/2, +amplitude/2]。\n amplitude: (invertDisplacement ? -1 : 1) * textureHeight,\n symmetricDisplacement: true,\n bottomAngleLimit,\n topAngleLimit,\n mappingBlend,\n seamBandWidth,\n }\n\n const result = applyDisplacement(\n subdivided,\n texData,\n texData.width,\n texData.height,\n settings,\n bounds,\n (p) => onProgress?.('displace', p),\n )\n\n\n return result\n}\n"]}

package/dist/mesh/knurl/displacement.d.ts CHANGED Viewed

@@ -9,7 +9,8 @@
  * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。
  * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C } from '../../math3d/index.js';
+import type { Shape } from '../types.js';
 import { type MappingSettings } from './mapping.js';
 /**
  * Displacement settings: the mapping settings plus the amplitude, optional
@@ -23,10 +24,10 @@ export interface DisplacementSettings extends MappingSettings {
     topAngleLimit?: number;
 }
 interface Bounds {
-    min: THREE.Vector3;
-    max: THREE.Vector3;
-    center: THREE.Vector3;
-    size: THREE.Vector3;
+    min: Vec3C;
+    max: Vec3C;
+    center: Vec3C;
+    size: Vec3C;
 }
 interface ImageDataLike {
     data: Uint8ClampedArray | Uint8Array;
@@ -48,6 +49,6 @@ interface ImageDataLike {
  * @param onProgress - optional callback receiving progress in [0, 1].
  * @returns a new BufferGeometry with displaced positions and face normals.
  */
-export declare function applyDisplacement(geometry: THREE.BufferGeometry, imageData: ImageDataLike, imgWidth: number, imgHeight: number, settings: DisplacementSettings, bounds: Bounds, onProgress?: (p: number) => void): THREE.BufferGeometry;
+export declare function applyDisplacement(geometry: Shape, imageData: ImageDataLike, imgWidth: number, imgHeight: number, settings: DisplacementSettings, bounds: Bounds, onProgress?: (p: number) => void): Shape;
 export {};
 //# sourceMappingURL=displacement.d.ts.map

package/dist/mesh/knurl/displacement.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"displacement.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,~~KAAK~~,KAAK,MAAM,OAAO,CAAA;~~AAE9B~~,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAEjF;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,MAAM;IACd,GAAG,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~IAClB~~,GAAG,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~IAClB~~,MAAM,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~IACrB~~,IAAI,EAAE,KAAK,~~CAAC,OAAO,~~CAAA;~~CACpB~~;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,KAAK,~~CAAC~~,~~cAAc,EAC9B,~~SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC/B,KAAK,~~CAAC,cAAc,CA8OtB~~"}
1	+ {"version":3,"file":"displacement.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAEjF;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,MAAM;IACd,GAAG,EAAE,KAAK,CAAA;IACV,GAAG,EAAE,KAAK,CAAA;IACV,MAAM,EAAE,KAAK,CAAA;IACb,IAAI,EAAE,KAAK,CAAA;CACZ;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,KAAK,EACf,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC/B,KAAK,CA6OP"}