@faicad/faijs 0.13.0

package/dist/boolean/deriveNormals.d.ts

@@ -0,0 +1,21 @@
+import { BufferGeometry } from 'three';
+/**
+ * 统一的法线派生函数（折边法线）。
+ *
+ * 取代散落在各处的 `geometry.computeVertexNormals()`。后者在**索引（共享顶点）
+ * 几何**上会把相邻三角面的法线取平均 → 棱边被"磨圆"。这正是钻孔/布尔/分割操作后
+ * model visual anomalies after drilling/boolean/split operations.
+ *
+ * `toCreasedNormals` 只在二面角大于 `creaseAngleDeg` 的边处"裂开"法线 → 锐边保持锐利，
+ * 仅对近共面 / 真实曲面（如钻孔内壁）平滑。它内部会把索引几何 `toNonIndexed()`
+ * （单条法线属性无法在共享顶点上表达锐边），因此返回的几何**可能是非索引的**——
+ * 这是预期且正确的表示，且与 STL 源零件本就是非索引一致，使各格式往返统一。
+ *
+ * 约定：项目中所有"需要派生法线"之处（操作结果、STL/3MF 导入）都经此函数，
+ * 不得再直接调用 `computeVertexNormals()`。
+ * @param geometry - the indexed geometry to derive creased (folded) normals for.
+ * @param creaseAngleDeg - the dihedral-angle threshold in degrees above which normals are split (default 60).
+ * @returns a BufferGeometry with creased normals applied; it may be non-indexed.
+ */
+export declare function deriveNormals(geometry: BufferGeometry, creaseAngleDeg?: number): BufferGeometry;
+//# sourceMappingURL=deriveNormals.d.ts.map

package/dist/boolean/deriveNormals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveNormals.d.ts","sourceRoot":"","sources":["../../src/boolean/deriveNormals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAGtC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,cAAc,SAAK,GAAG,cAAc,CAG3F"}

package/dist/boolean/deriveNormals.js

@@ -0,0 +1,24 @@
+import { toCreasedNormals } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+/**
+ * 统一的法线派生函数（折边法线）。
+ *
+ * 取代散落在各处的 `geometry.computeVertexNormals()`。后者在**索引（共享顶点）
+ * 几何**上会把相邻三角面的法线取平均 → 棱边被"磨圆"。这正是钻孔/布尔/分割操作后
+ * model visual anomalies after drilling/boolean/split operations.
+ *
+ * `toCreasedNormals` 只在二面角大于 `creaseAngleDeg` 的边处"裂开"法线 → 锐边保持锐利，
+ * 仅对近共面 / 真实曲面（如钻孔内壁）平滑。它内部会把索引几何 `toNonIndexed()`
+ * （单条法线属性无法在共享顶点上表达锐边），因此返回的几何**可能是非索引的**——
+ * 这是预期且正确的表示，且与 STL 源零件本就是非索引一致，使各格式往返统一。
+ *
+ * 约定：项目中所有"需要派生法线"之处（操作结果、STL/3MF 导入）都经此函数，
+ * 不得再直接调用 `computeVertexNormals()`。
+ * @param geometry - the indexed geometry to derive creased (folded) normals for.
+ * @param creaseAngleDeg - the dihedral-angle threshold in degrees above which normals are split (default 60).
+ * @returns a BufferGeometry with creased normals applied; it may be non-indexed.
+ */
+export function deriveNormals(geometry, creaseAngleDeg = 60) {
+    const creaseAngle = (creaseAngleDeg * Math.PI) / 180;
+    return toCreasedNormals(geometry, creaseAngle);
+}
+//# sourceMappingURL=deriveNormals.js.map

package/dist/boolean/deriveNormals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveNormals.js","sourceRoot":"","sources":["../../src/boolean/deriveNormals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iDAAiD,CAAA;AAElF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,QAAwB,EAAE,cAAc,GAAG,EAAE;IACzE,MAAM,WAAW,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAA;IACpD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;AAChD,CAAC","sourcesContent":["import { BufferGeometry } from 'three'\nimport { toCreasedNormals } from 'three/examples/jsm/utils/BufferGeometryUtils.js'\n\n/**\n * 统一的法线派生函数（折边法线）。\n *\n * 取代散落在各处的 `geometry.computeVertexNormals()`。后者在**索引（共享顶点）\n * 几何**上会把相邻三角面的法线取平均 → 棱边被\"磨圆\"。这正是钻孔/布尔/分割操作后\n * model visual anomalies after drilling/boolean/split operations.\n *\n * `toCreasedNormals` 只在二面角大于 `creaseAngleDeg` 的边处\"裂开\"法线 → 锐边保持锐利，\n * 仅对近共面 / 真实曲面（如钻孔内壁）平滑。它内部会把索引几何 `toNonIndexed()`\n * （单条法线属性无法在共享顶点上表达锐边），因此返回的几何**可能是非索引的**——\n * 这是预期且正确的表示，且与 STL 源零件本就是非索引一致，使各格式往返统一。\n *\n * 约定：项目中所有\"需要派生法线\"之处（操作结果、STL/3MF 导入）都经此函数，\n * 不得再直接调用 `computeVertexNormals()`。\n * @param geometry - the indexed geometry to derive creased (folded) normals for.\n * @param creaseAngleDeg - the dihedral-angle threshold in degrees above which normals are split (default 60).\n * @returns a BufferGeometry with creased normals applied; it may be non-indexed.\n */\nexport function deriveNormals(geometry: BufferGeometry, creaseAngleDeg = 60): BufferGeometry {\n  const creaseAngle = (creaseAngleDeg * Math.PI) / 180\n  return toCreasedNormals(geometry, creaseAngle)\n}\n"]}

package/dist/boolean/dovetail-math.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Vector math helpers for the dovetail boolean algorithm.
+ * Extracted to a separate module so they can be unit-tested.
+ * These are pure functions with no dependencies (no THREE.js).
+ */
+export type Vec3 = [number, number, number];
+/**
+ * Compute the cross product of two 3-component vectors.
+ * @param a - the left operand vector.
+ * @param b - the right operand vector.
+ * @returns the cross product a × b.
+ */
+export declare function vec3Cross(a: Vec3, b: Vec3): Vec3;
+/**
+ * Compute the dot product of two 3-component vectors.
+ * @param a - the left operand vector.
+ * @param b - the right operand vector.
+ * @returns the scalar dot product a · b.
+ */
+export declare function vec3Dot(a: Vec3, b: Vec3): number;
+/**
+ * Normalize a 3-component vector to unit length; returns the zero vector for a (near) zero input.
+ * @param a - the vector to normalize.
+ * @returns the unit-length vector, or [0, 0, 0] when the input magnitude is below the epsilon.
+ */
+export declare function vec3Normalize(a: Vec3): Vec3;
+/**
+ * Scale a 3-component vector by a scalar.
+ * @param a - the vector to scale.
+ * @param s - the scalar factor.
+ * @returns the scaled vector.
+ */
+export declare function vec3Scale(a: Vec3, s: number): Vec3;
+/**
+ * Add two 3-component vectors component-wise.
+ * @param a - the first vector.
+ * @param b - the second vector.
+ * @returns the component-wise sum a + b.
+ */
+export declare function vec3Add(a: Vec3, b: Vec3): Vec3;
+/**
+ * Subtract one 3-component vector from another component-wise.
+ * @param a - the vector being subtracted from.
+ * @param b - the vector to subtract.
+ * @returns the component-wise difference a - b.
+ */
+export declare function vec3Sub(a: Vec3, b: Vec3): Vec3;
+/**
+ * Rodrigues' rotation formula: rotate vector v around unit axis k by angleRad.
+ * @param v - the vector to rotate.
+ * @param k - the rotation axis (does not need to be unit length; it is normalized internally).
+ * @param angleRad - the rotation angle in radians.
+ * @returns the rotated vector.
+ */
+export declare function vec3RotateAroundAxis(v: Vec3, k: Vec3, angleRad: number): Vec3;
+//# sourceMappingURL=dovetail-math.d.ts.map

package/dist/boolean/dovetail-math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dovetail-math.d.ts","sourceRoot":"","sources":["../../src/boolean/dovetail-math.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE3C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAMhD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAI3C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAE9C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAE9C;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAW7E"}

package/dist/boolean/dovetail-math.js

@@ -0,0 +1,85 @@
+/**
+ * Vector math helpers for the dovetail boolean algorithm.
+ * Extracted to a separate module so they can be unit-tested.
+ * These are pure functions with no dependencies (no THREE.js).
+ */
+/**
+ * Compute the cross product of two 3-component vectors.
+ * @param a - the left operand vector.
+ * @param b - the right operand vector.
+ * @returns the cross product a × b.
+ */
+export function vec3Cross(a, b) {
+    return [
+        a[1] * b[2] - a[2] * b[1],
+        a[2] * b[0] - a[0] * b[2],
+        a[0] * b[1] - a[1] * b[0],
+    ];
+}
+/**
+ * Compute the dot product of two 3-component vectors.
+ * @param a - the left operand vector.
+ * @param b - the right operand vector.
+ * @returns the scalar dot product a · b.
+ */
+export function vec3Dot(a, b) {
+    return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+}
+/**
+ * Normalize a 3-component vector to unit length; returns the zero vector for a (near) zero input.
+ * @param a - the vector to normalize.
+ * @returns the unit-length vector, or [0, 0, 0] when the input magnitude is below the epsilon.
+ */
+export function vec3Normalize(a) {
+    const len = Math.sqrt(a[0] * a[0] + a[1] * a[1] + a[2] * a[2]);
+    if (len < 1e-12)
+        return [0, 0, 0];
+    return [a[0] / len, a[1] / len, a[2] / len];
+}
+/**
+ * Scale a 3-component vector by a scalar.
+ * @param a - the vector to scale.
+ * @param s - the scalar factor.
+ * @returns the scaled vector.
+ */
+export function vec3Scale(a, s) {
+    return [a[0] * s, a[1] * s, a[2] * s];
+}
+/**
+ * Add two 3-component vectors component-wise.
+ * @param a - the first vector.
+ * @param b - the second vector.
+ * @returns the component-wise sum a + b.
+ */
+export function vec3Add(a, b) {
+    return [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+}
+/**
+ * Subtract one 3-component vector from another component-wise.
+ * @param a - the vector being subtracted from.
+ * @param b - the vector to subtract.
+ * @returns the component-wise difference a - b.
+ */
+export function vec3Sub(a, b) {
+    return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+}
+/**
+ * Rodrigues' rotation formula: rotate vector v around unit axis k by angleRad.
+ * @param v - the vector to rotate.
+ * @param k - the rotation axis (does not need to be unit length; it is normalized internally).
+ * @param angleRad - the rotation angle in radians.
+ * @returns the rotated vector.
+ */
+export function vec3RotateAroundAxis(v, k, angleRad) {
+    const cos = Math.cos(angleRad);
+    const sin = Math.sin(angleRad);
+    const kNorm = vec3Normalize(k);
+    const kCrossV = vec3Cross(kNorm, v);
+    const kDotV = vec3Dot(kNorm, v);
+    return [
+        v[0] * cos + kCrossV[0] * sin + kNorm[0] * kDotV * (1 - cos),
+        v[1] * cos + kCrossV[1] * sin + kNorm[1] * kDotV * (1 - cos),
+        v[2] * cos + kCrossV[2] * sin + kNorm[2] * kDotV * (1 - cos),
+    ];
+}
+//# sourceMappingURL=dovetail-math.js.map

package/dist/boolean/dovetail-math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dovetail-math.js","sourceRoot":"","sources":["../../src/boolean/dovetail-math.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Vector math helpers for the dovetail boolean algorithm.\n * Extracted to a separate module so they can be unit-tested.\n * These are pure functions with no dependencies (no THREE.js).\n */\n\nexport type Vec3 = [number, number, number]\n\n/**\n * Compute the cross product of two 3-component vectors.\n * @param a - the left operand vector.\n * @param b - the right operand vector.\n * @returns the cross product a × b.\n */\nexport function vec3Cross(a: Vec3, b: Vec3): Vec3 {\n  return [\n    a[1] * b[2] - a[2] * b[1],\n    a[2] * b[0] - a[0] * b[2],\n    a[0] * b[1] - a[1] * b[0],\n  ]\n}\n\n/**\n * Compute the dot product of two 3-component vectors.\n * @param a - the left operand vector.\n * @param b - the right operand vector.\n * @returns the scalar dot product a · b.\n */\nexport function vec3Dot(a: Vec3, b: Vec3): number {\n  return a[0] * b[0] + a[1] * b[1] + a[2] * b[2]\n}\n\n/**\n * Normalize a 3-component vector to unit length; returns the zero vector for a (near) zero input.\n * @param a - the vector to normalize.\n * @returns the unit-length vector, or [0, 0, 0] when the input magnitude is below the epsilon.\n */\nexport function vec3Normalize(a: Vec3): Vec3 {\n  const len = Math.sqrt(a[0] * a[0] + a[1] * a[1] + a[2] * a[2])\n  if (len < 1e-12) return [0, 0, 0]\n  return [a[0] / len, a[1] / len, a[2] / len]\n}\n\n/**\n * Scale a 3-component vector by a scalar.\n * @param a - the vector to scale.\n * @param s - the scalar factor.\n * @returns the scaled vector.\n */\nexport function vec3Scale(a: Vec3, s: number): Vec3 {\n  return [a[0] * s, a[1] * s, a[2] * s]\n}\n\n/**\n * Add two 3-component vectors component-wise.\n * @param a - the first vector.\n * @param b - the second vector.\n * @returns the component-wise sum a + b.\n */\nexport function vec3Add(a: Vec3, b: Vec3): Vec3 {\n  return [a[0] + b[0], a[1] + b[1], a[2] + b[2]]\n}\n\n/**\n * Subtract one 3-component vector from another component-wise.\n * @param a - the vector being subtracted from.\n * @param b - the vector to subtract.\n * @returns the component-wise difference a - b.\n */\nexport function vec3Sub(a: Vec3, b: Vec3): Vec3 {\n  return [a[0] - b[0], a[1] - b[1], a[2] - b[2]]\n}\n\n/**\n * Rodrigues' rotation formula: rotate vector v around unit axis k by angleRad.\n * @param v - the vector to rotate.\n * @param k - the rotation axis (does not need to be unit length; it is normalized internally).\n * @param angleRad - the rotation angle in radians.\n * @returns the rotated vector.\n */\nexport function vec3RotateAroundAxis(v: Vec3, k: Vec3, angleRad: number): Vec3 {\n  const cos = Math.cos(angleRad)\n  const sin = Math.sin(angleRad)\n  const kNorm = vec3Normalize(k)\n  const kCrossV = vec3Cross(kNorm, v)\n  const kDotV = vec3Dot(kNorm, v)\n  return [\n    v[0] * cos + kCrossV[0] * sin + kNorm[0] * kDotV * (1 - cos),\n    v[1] * cos + kCrossV[1] * sin + kNorm[1] * kDotV * (1 - cos),\n    v[2] * cos + kCrossV[2] * sin + kNorm[2] * kDotV * (1 - cos),\n  ]\n}\n"]}

package/dist/boolean/extrude-helpers.d.ts

@@ -0,0 +1,88 @@
+/**
+ * 拉伸（extrude）几何工具集 —— 从 ExtrudeRenderer.tsx 抽出的纯几何函数。
+ *
+ * 拉伸的语义（三段模型）：在切割平面把模型切开，得到
+ *   - back（下半）：沿法线 N 平移 offsetBack
+ *   - middle（中段）：平面处的截面沿 N 挤出 L，落在 [offsetBack, offsetBack + L]
+ *   - front（上半）：沿法线 N 平移 offsetFront
+ * 其中 offsetFront - offsetBack === L 恒成立（见 computeExtrudeOffsets）。
+ *
+ * 本模块只负责「全分辨率、几何正确」的那条路径（预览提交 / 无预览直接执行）。
+ * 交互期的快速预览走 engine/components/extrude-preview-nosplit.ts（不 split 原模型）。
+ *
+ * 放在 engine/boolean/ 下的约束：**不得 import stores**（保持与 csg.ts 同层的纯度）。
+ * 平面参数（normal / originOffset）由调用方用 computePlaneParams 算好后传入。
+ */
+import * as THREE from 'three';
+import type { ManifoldMeshData } from '../boolean/csg-backend.js';
+/** 与 extrude-store 的 ExtrusionMode 结构兼容（此处不 import store，避免层级倒置）。 */
+export type ExtrudeOffsetMode = 'centered' | 'forward' | 'backward';
+/** slice 法取薄片的厚度（沿法线），随后按 L/SLICE_THICKNESS 拉伸。 */
+export declare const SLICE_THICKNESS = 0.2;
+/**
+ * The three mesh parts produced by an extrude operation.
+ */
+export interface ExtrudeParts {
+    front: ManifoldMeshData | null;
+    back: ManifoldMeshData | null;
+    extruded: ManifoldMeshData | null;
+}
+/**
+ * 三段的位移量。不变量：front - back === length。
+ * - centered：平面居中，上下各推 L/2
+ * - forward：只推上半 L，下半不动
+ * - backward：只拉下半 -L，上半不动
+ * @param mode - the offset mode ('centered', 'forward', or 'backward').
+ * @param length - the extrusion length L (mm).
+ * @returns the front and back displacement amounts, with front - back === length.
+ */
+export declare function computeExtrudeOffsets(mode: ExtrudeOffsetMode, length: number): {
+    front: number;
+    back: number;
+};
+/**
+ * 由 computePlaneParams 的 (normal, originOffset) 构造 THREE 世界平面。
+ *
+ * 约定：平面方程为 `N · p = originOffset`；THREE.Plane 用 `N · p + constant = 0`，
+ * 故 constant = -originOffset。THREE 裁剪保留 distanceToPoint >= 0 的一侧（法线正侧）。
+ * @param normal - the cutting plane normal as a 3-component array.
+ * @param originOffset - the plane equation origin offset along the normal.
+ * @returns a THREE.Plane and its normalized normal vector.
+ */
+export declare function makeWorldPlane(normal: [number, number, number], originOffset: number): {
+    plane: THREE.Plane;
+    normalVec: THREE.Vector3;
+};
+/**
+ * 全分辨率构建拉伸三段（世界空间进、世界空间出）。
+ *
+ * 这是**提交路径的唯一真相**：预览无论用什么近似手段，执行时都走这里重算，
+ * so preview geometry errors do not pollute the final model.
+ *
+ * @param worldMesh   世界空间的源网格（局部几何 × matrixWorld）
+ * @param normal      切割平面法线（单位向量）
+ * @param originOffset 平面方程 N·p = originOffset 的右端
+ * @param length      拉伸长度 L
+ * @param mode        三段位移模式
+ * @returns the split front, back, and extruded middle mesh parts.
+ */
+export declare function buildExtrudeParts(worldMesh: ManifoldMeshData, normal: [number, number, number], originOffset: number, length: number, mode: ExtrudeOffsetMode): Promise<ExtrudeParts>;
+/**
+ * 沿法线方向按 scaleFactor 缩放每个顶点到平面的有向距离。
+ * 平面上的顶点不动，离面顶点按比例外推。
+ * @param mesh - the source mesh data to scale.
+ * @param normal - the plane normal (unit vector).
+ * @param planeOffset - the plane offset along the normal.
+ * @param scaleFactor - the scaling factor applied to each vertex's signed distance to the plane.
+ * @returns the scaled mesh data (positions rewritten, indices unchanged).
+ */
+export declare function scaleMeshAlongNormal(mesh: ManifoldMeshData, normal: [number, number, number], planeOffset: number, scaleFactor: number): ManifoldMeshData;
+/**
+ * 整体沿 direction 平移 distance（distance 为 0 时原样返回，不拷贝）。
+ * @param mesh - the source mesh data to translate.
+ * @param direction - the translation direction (not necessarily unit length).
+ * @param distance - the translation distance (mm); 0 returns the mesh unchanged.
+ * @returns the translated mesh data (positions rewritten, indices unchanged).
+ */
+export declare function offsetMesh(mesh: ManifoldMeshData, direction: [number, number, number], distance: number): ManifoldMeshData;
+//# sourceMappingURL=extrude-helpers.d.ts.map

package/dist/boolean/extrude-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extrude-helpers.d.ts","sourceRoot":"","sources":["../../src/boolean/extrude-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,qEAAqE;AACrE,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAA;AAEnE,mDAAmD;AACnD,eAAO,MAAM,eAAe,MAAM,CAAA;AAElC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC9B,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAClC;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAUjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAChC,YAAY,EAAE,MAAM,GACnB;IAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC,OAAO,CAAA;CAAE,CAMlD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,YAAY,CAAC,CAyBvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,gBAAgB,CAUlB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACnC,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAYlB"}

package/dist/boolean/extrude-helpers.js

@@ -0,0 +1,134 @@
+/**
+ * 拉伸（extrude）几何工具集 —— 从 ExtrudeRenderer.tsx 抽出的纯几何函数。
+ *
+ * 拉伸的语义（三段模型）：在切割平面把模型切开，得到
+ *   - back（下半）：沿法线 N 平移 offsetBack
+ *   - middle（中段）：平面处的截面沿 N 挤出 L，落在 [offsetBack, offsetBack + L]
+ *   - front（上半）：沿法线 N 平移 offsetFront
+ * 其中 offsetFront - offsetBack === L 恒成立（见 computeExtrudeOffsets）。
+ *
+ * 本模块只负责「全分辨率、几何正确」的那条路径（预览提交 / 无预览直接执行）。
+ * 交互期的快速预览走 engine/components/extrude-preview-nosplit.ts（不 split 原模型）。
+ *
+ * 放在 engine/boolean/ 下的约束：**不得 import stores**（保持与 csg.ts 同层的纯度）。
+ * 平面参数（normal / originOffset）由调用方用 computePlaneParams 算好后传入。
+ */
+import * as THREE from 'three';
+import { computeSplit } from '../boolean/csg-backend.js';
+/** slice 法取薄片的厚度（沿法线），随后按 L/SLICE_THICKNESS 拉伸。 */
+export const SLICE_THICKNESS = 0.2;
+/**
+ * 三段的位移量。不变量：front - back === length。
+ * - centered：平面居中，上下各推 L/2
+ * - forward：只推上半 L，下半不动
+ * - backward：只拉下半 -L，上半不动
+ * @param mode - the offset mode ('centered', 'forward', or 'backward').
+ * @param length - the extrusion length L (mm).
+ * @returns the front and back displacement amounts, with front - back === length.
+ */
+export function computeExtrudeOffsets(mode, length) {
+    switch (mode) {
+        case 'forward':
+            return { front: length, back: 0 };
+        case 'backward':
+            return { front: 0, back: -length };
+        case 'centered':
+        default:
+            return { front: length / 2, back: -length / 2 };
+    }
+}
+/**
+ * 由 computePlaneParams 的 (normal, originOffset) 构造 THREE 世界平面。
+ *
+ * 约定：平面方程为 `N · p = originOffset`；THREE.Plane 用 `N · p + constant = 0`，
+ * 故 constant = -originOffset。THREE 裁剪保留 distanceToPoint >= 0 的一侧（法线正侧）。
+ * @param normal - the cutting plane normal as a 3-component array.
+ * @param originOffset - the plane equation origin offset along the normal.
+ * @returns a THREE.Plane and its normalized normal vector.
+ */
+export function makeWorldPlane(normal, originOffset) {
+    const normalVec = new THREE.Vector3(normal[0], normal[1], normal[2]).normalize();
+    return {
+        plane: new THREE.Plane(normalVec.clone(), -originOffset),
+        normalVec,
+    };
+}
+/**
+ * 全分辨率构建拉伸三段（世界空间进、世界空间出）。
+ *
+ * 这是**提交路径的唯一真相**：预览无论用什么近似手段，执行时都走这里重算，
+ * so preview geometry errors do not pollute the final model.
+ *
+ * @param worldMesh   世界空间的源网格（局部几何 × matrixWorld）
+ * @param normal      切割平面法线（单位向量）
+ * @param originOffset 平面方程 N·p = originOffset 的右端
+ * @param length      拉伸长度 L
+ * @param mode        三段位移模式
+ * @returns the split front, back, and extruded middle mesh parts.
+ */
+export async function buildExtrudeParts(worldMesh, normal, originOffset, length, mode) {
+    const { front: offsetFront, back: offsetBack } = computeExtrudeOffsets(mode, length);
+    // 拉伸方向 D 恒等于切割平面法线 N
+    const D = [normal[0], normal[1], normal[2]];
+    // 1. 平面处切开 → front / back
+    const splitResult = await computeSplit(worldMesh, normal, originOffset);
+    let front = splitResult.front;
+    let back = splitResult.back;
+    let extruded = null;
+    // 2. 从 front 再切一片厚 SLICE_THICKNESS 的薄壳
+    const capSplit = await computeSplit(splitResult.front, normal, originOffset + SLICE_THICKNESS);
+    // 3. 薄壳以平面为锚点沿 N 放大 L/SLICE_THICKNESS → 占据 [originOffset, originOffset+L]
+    if (capSplit.back && capSplit.back.indices.length > 0) {
+        extruded = scaleMeshAlongNormal(capSplit.back, D, originOffset, length / SLICE_THICKNESS);
+    }
+    // 4. 三段各自沿 D 位移；中段起点对齐 back 侧
+    if (front)
+        front = offsetMesh(front, D, offsetFront);
+    if (back)
+        back = offsetMesh(back, D, offsetBack);
+    if (extruded)
+        extruded = offsetMesh(extruded, D, offsetBack);
+    return { front, back, extruded };
+}
+/**
+ * 沿法线方向按 scaleFactor 缩放每个顶点到平面的有向距离。
+ * 平面上的顶点不动，离面顶点按比例外推。
+ * @param mesh - the source mesh data to scale.
+ * @param normal - the plane normal (unit vector).
+ * @param planeOffset - the plane offset along the normal.
+ * @param scaleFactor - the scaling factor applied to each vertex's signed distance to the plane.
+ * @returns the scaled mesh data (positions rewritten, indices unchanged).
+ */
+export function scaleMeshAlongNormal(mesh, normal, planeOffset, scaleFactor) {
+    const out = new Float32Array(mesh.positions);
+    for (let i = 0; i < out.length; i += 3) {
+        const d = out[i] * normal[0] + out[i + 1] * normal[1] + out[i + 2] * normal[2] - planeOffset;
+        const delta = d * scaleFactor - d;
+        out[i] += normal[0] * delta;
+        out[i + 1] += normal[1] * delta;
+        out[i + 2] += normal[2] * delta;
+    }
+    return { positions: out, indices: mesh.indices };
+}
+/**
+ * 整体沿 direction 平移 distance（distance 为 0 时原样返回，不拷贝）。
+ * @param mesh - the source mesh data to translate.
+ * @param direction - the translation direction (not necessarily unit length).
+ * @param distance - the translation distance (mm); 0 returns the mesh unchanged.
+ * @returns the translated mesh data (positions rewritten, indices unchanged).
+ */
+export function offsetMesh(mesh, direction, distance) {
+    if (distance === 0)
+        return mesh;
+    const dx = direction[0] * distance;
+    const dy = direction[1] * distance;
+    const dz = direction[2] * distance;
+    const out = new Float32Array(mesh.positions);
+    for (let i = 0; i < out.length; i += 3) {
+        out[i] += dx;
+        out[i + 1] += dy;
+        out[i + 2] += dz;
+    }
+    return { positions: out, indices: mesh.indices };
+}
+//# sourceMappingURL=extrude-helpers.js.map

package/dist/boolean/extrude-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extrude-helpers.js","sourceRoot":"","sources":["../../src/boolean/extrude-helpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 拉伸（extrude）几何工具集 —— 从 ExtrudeRenderer.tsx 抽出的纯几何函数。\n *\n * 拉伸的语义（三段模型）：在切割平面把模型切开，得到\n *   - back（下半）：沿法线 N 平移 offsetBack\n *   - middle（中段）：平面处的截面沿 N 挤出 L，落在 [offsetBack, offsetBack + L]\n *   - front（上半）：沿法线 N 平移 offsetFront\n * 其中 offsetFront - offsetBack === L 恒成立（见 computeExtrudeOffsets）。\n *\n * 本模块只负责「全分辨率、几何正确」的那条路径（预览提交 / 无预览直接执行）。\n * 交互期的快速预览走 engine/components/extrude-preview-nosplit.ts（不 split 原模型）。\n *\n * 放在 engine/boolean/ 下的约束：**不得 import stores**（保持与 csg.ts 同层的纯度）。\n * 平面参数（normal / originOffset）由调用方用 computePlaneParams 算好后传入。\n */\nimport * as THREE from 'three'\nimport { computeSplit } from '../boolean/csg-backend'\nimport type { ManifoldMeshData } from '../boolean/csg-backend'\n\n/** 与 extrude-store 的 ExtrusionMode 结构兼容（此处不 import store，避免层级倒置）。 */\nexport type ExtrudeOffsetMode = 'centered' | 'forward' | 'backward'\n\n/** slice 法取薄片的厚度（沿法线），随后按 L/SLICE_THICKNESS 拉伸。 */\nexport const SLICE_THICKNESS = 0.2\n\n/**\n * The three mesh parts produced by an extrude operation.\n */\nexport interface ExtrudeParts {\n  front: ManifoldMeshData | null\n  back: ManifoldMeshData | null\n  extruded: ManifoldMeshData | null\n}\n\n/**\n * 三段的位移量。不变量：front - back === length。\n * - centered：平面居中，上下各推 L/2\n * - forward：只推上半 L，下半不动\n * - backward：只拉下半 -L，上半不动\n * @param mode - the offset mode ('centered', 'forward', or 'backward').\n * @param length - the extrusion length L (mm).\n * @returns the front and back displacement amounts, with front - back === length.\n */\nexport function computeExtrudeOffsets(\n  mode: ExtrudeOffsetMode,\n  length: number,\n): { front: number; back: number } {\n  switch (mode) {\n    case 'forward':\n      return { front: length, back: 0 }\n    case 'backward':\n      return { front: 0, back: -length }\n    case 'centered':\n    default:\n      return { front: length / 2, back: -length / 2 }\n  }\n}\n\n/**\n * 由 computePlaneParams 的 (normal, originOffset) 构造 THREE 世界平面。\n *\n * 约定：平面方程为 `N · p = originOffset`；THREE.Plane 用 `N · p + constant = 0`，\n * 故 constant = -originOffset。THREE 裁剪保留 distanceToPoint >= 0 的一侧（法线正侧）。\n * @param normal - the cutting plane normal as a 3-component array.\n * @param originOffset - the plane equation origin offset along the normal.\n * @returns a THREE.Plane and its normalized normal vector.\n */\nexport function makeWorldPlane(\n  normal: [number, number, number],\n  originOffset: number,\n): { plane: THREE.Plane; normalVec: THREE.Vector3 } {\n  const normalVec = new THREE.Vector3(normal[0], normal[1], normal[2]).normalize()\n  return {\n    plane: new THREE.Plane(normalVec.clone(), -originOffset),\n    normalVec,\n  }\n}\n\n/**\n * 全分辨率构建拉伸三段（世界空间进、世界空间出）。\n *\n * 这是**提交路径的唯一真相**：预览无论用什么近似手段，执行时都走这里重算，\n * so preview geometry errors do not pollute the final model.\n *\n * @param worldMesh   世界空间的源网格（局部几何 × matrixWorld）\n * @param normal      切割平面法线（单位向量）\n * @param originOffset 平面方程 N·p = originOffset 的右端\n * @param length      拉伸长度 L\n * @param mode        三段位移模式\n * @returns the split front, back, and extruded middle mesh parts.\n */\nexport async function buildExtrudeParts(\n  worldMesh: ManifoldMeshData,\n  normal: [number, number, number],\n  originOffset: number,\n  length: number,\n  mode: ExtrudeOffsetMode,\n): Promise<ExtrudeParts> {\n  const { front: offsetFront, back: offsetBack } = computeExtrudeOffsets(mode, length)\n  // 拉伸方向 D 恒等于切割平面法线 N\n  const D: [number, number, number] = [normal[0], normal[1], normal[2]]\n\n  // 1. 平面处切开 → front / back\n  const splitResult = await computeSplit(worldMesh, normal, originOffset)\n  let front: ManifoldMeshData | null = splitResult.front\n  let back: ManifoldMeshData | null = splitResult.back\n  let extruded: ManifoldMeshData | null = null\n\n  // 2. 从 front 再切一片厚 SLICE_THICKNESS 的薄壳\n  const capSplit = await computeSplit(splitResult.front, normal, originOffset + SLICE_THICKNESS)\n\n  // 3. 薄壳以平面为锚点沿 N 放大 L/SLICE_THICKNESS → 占据 [originOffset, originOffset+L]\n  if (capSplit.back && capSplit.back.indices.length > 0) {\n    extruded = scaleMeshAlongNormal(capSplit.back, D, originOffset, length / SLICE_THICKNESS)\n  }\n\n  // 4. 三段各自沿 D 位移；中段起点对齐 back 侧\n  if (front) front = offsetMesh(front, D, offsetFront)\n  if (back) back = offsetMesh(back, D, offsetBack)\n  if (extruded) extruded = offsetMesh(extruded, D, offsetBack)\n\n  return { front, back, extruded }\n}\n\n/**\n * 沿法线方向按 scaleFactor 缩放每个顶点到平面的有向距离。\n * 平面上的顶点不动，离面顶点按比例外推。\n * @param mesh - the source mesh data to scale.\n * @param normal - the plane normal (unit vector).\n * @param planeOffset - the plane offset along the normal.\n * @param scaleFactor - the scaling factor applied to each vertex's signed distance to the plane.\n * @returns the scaled mesh data (positions rewritten, indices unchanged).\n */\nexport function scaleMeshAlongNormal(\n  mesh: ManifoldMeshData,\n  normal: [number, number, number],\n  planeOffset: number,\n  scaleFactor: number,\n): ManifoldMeshData {\n  const out = new Float32Array(mesh.positions)\n  for (let i = 0; i < out.length; i += 3) {\n    const d = out[i] * normal[0] + out[i + 1] * normal[1] + out[i + 2] * normal[2] - planeOffset\n    const delta = d * scaleFactor - d\n    out[i] += normal[0] * delta\n    out[i + 1] += normal[1] * delta\n    out[i + 2] += normal[2] * delta\n  }\n  return { positions: out, indices: mesh.indices }\n}\n\n/**\n * 整体沿 direction 平移 distance（distance 为 0 时原样返回，不拷贝）。\n * @param mesh - the source mesh data to translate.\n * @param direction - the translation direction (not necessarily unit length).\n * @param distance - the translation distance (mm); 0 returns the mesh unchanged.\n * @returns the translated mesh data (positions rewritten, indices unchanged).\n */\nexport function offsetMesh(\n  mesh: ManifoldMeshData,\n  direction: [number, number, number],\n  distance: number,\n): ManifoldMeshData {\n  if (distance === 0) return mesh\n  const dx = direction[0] * distance\n  const dy = direction[1] * distance\n  const dz = direction[2] * distance\n  const out = new Float32Array(mesh.positions)\n  for (let i = 0; i < out.length; i += 3) {\n    out[i] += dx\n    out[i + 1] += dy\n    out[i + 2] += dz\n  }\n  return { positions: out, indices: mesh.indices }\n}\n"]}

package/dist/boolean/geo-convert.d.ts

@@ -0,0 +1,52 @@
+/**
+ * geo-convert — 纯数据转换函数（从 csg.ts 提取）
+ *
+ * THREE.BufferGeometry ↔ ManifoldMeshData 转换。
+ * 不依赖 Worker / postMessage，可在 Node 和浏览器环境通用。
+ */
+import * as THREE from 'three';
+/** The set of supported boolean operations. */
+export type BooleanOperation = 'union' | 'subtract' | 'intersect';
+/** Interchange mesh representation: interleaved positions with triangle indices. */
+export interface ManifoldMeshData {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/** Design parameters for a dovetail groove (depth, tolerances, width, flaps angle). */
+export interface DovetailGrooveParams {
+    depth: number;
+    depthTolerance: number;
+    width: number;
+    widthTolerance: number;
+    flapsAngle: number;
+}
+/** Design parameters for a dowel split (diameter, tolerances, height). */
+export interface DowelSplitParams {
+    diameter: number;
+    diameterTolerance: number;
+    height: number;
+    heightTolerance: number;
+}
+/** Design parameters for a straight-tenon split (side length, tolerances, height). */
+export interface StraightTenonSplitParams {
+    sideLength: number;
+    sideLengthTolerance: number;
+    height: number;
+    heightTolerance: number;
+}
+/**
+ * Convert a THREE.BufferGeometry into ManifoldMeshData, welding duplicate vertices.
+ * @param geo - the source THREE.BufferGeometry with a position attribute (and optional index).
+ * @returns the converted mesh data with welded, unique vertices.
+ */
+export declare function geoToManifoldMesh(geo: THREE.BufferGeometry): ManifoldMeshData;
+/**
+ * Convert ManifoldMeshData into a THREE.BufferGeometry, optionally computing creased normals.
+ * @param data - the source mesh data.
+ * @param options - optional settings; computeNormals defaults to true and derives creased normals.
+ * @returns the resulting THREE.BufferGeometry (empty when there are no positions or indices).
+ */
+export declare function manifoldMeshToGeo(data: ManifoldMeshData, options?: {
+    computeNormals?: boolean;
+}): THREE.BufferGeometry;
+//# sourceMappingURL=geo-convert.d.ts.map

package/dist/boolean/geo-convert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-convert.d.ts","sourceRoot":"","sources":["../../src/boolean/geo-convert.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,+CAA+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAA;AAEjE,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,sFAAsF;AACtF,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB;AAiDD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,cAAc,GAAG,gBAAgB,CAsB7E;AAID;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,KAAK,CAAC,cAAc,CAYtB"}

package/dist/boolean/geo-convert.js

@@ -0,0 +1,94 @@
+/**
+ * geo-convert — 纯数据转换函数（从 csg.ts 提取）
+ *
+ * THREE.BufferGeometry ↔ ManifoldMeshData 转换。
+ * 不依赖 Worker / postMessage，可在 Node 和浏览器环境通用。
+ */
+import * as THREE from 'three';
+import { deriveNormals } from './deriveNormals.js';
+// ── 焊接重复顶点 ──
+function weldPositions(positions, indices, count) {
+    const mapX = new Map();
+    const weldedPosArr = [];
+    const weldedIdxArr = [];
+    for (let i = 0; i < count; i++) {
+        const vi = indices[i];
+        const x = positions[vi * 3];
+        const y = positions[vi * 3 + 1];
+        const z = positions[vi * 3 + 2];
+        const qx = Math.round(x * 1e6);
+        const qy = Math.round(y * 1e6);
+        const qz = Math.round(z * 1e6);
+        let mapY = mapX.get(qx);
+        if (mapY === undefined) {
+            mapY = new Map();
+            mapX.set(qx, mapY);
+        }
+        let mapZ = mapY.get(qy);
+        if (mapZ === undefined) {
+            mapZ = new Map();
+            mapY.set(qy, mapZ);
+        }
+        let ni = mapZ.get(qz);
+        if (ni === undefined) {
+            ni = weldedPosArr.length / 3;
+            mapZ.set(qz, ni);
+            weldedPosArr.push(x, y, z);
+        }
+        weldedIdxArr.push(ni);
+    }
+    return {
+        positions: new Float32Array(weldedPosArr),
+        indices: new Uint32Array(weldedIdxArr),
+    };
+}
+// ── THREE.BufferGeometry → ManifoldMeshData ──
+/**
+ * Convert a THREE.BufferGeometry into ManifoldMeshData, welding duplicate vertices.
+ * @param geo - the source THREE.BufferGeometry with a position attribute (and optional index).
+ * @returns the converted mesh data with welded, unique vertices.
+ */
+export function geoToManifoldMesh(geo) {
+    const pos = geo.getAttribute('position');
+    const arr = pos.array;
+    const positions = new Float32Array(arr);
+    let triCount;
+    let indices;
+    if (geo.index) {
+        const idx = geo.index;
+        triCount = idx.count;
+        const idxArr = idx.array;
+        indices = idxArr instanceof Uint32Array
+            ? new Uint32Array(idxArr.buffer, idxArr.byteOffset, idx.count)
+            : new Uint16Array(idxArr.buffer, idxArr.byteOffset, idx.count);
+    }
+    else {
+        triCount = pos.count;
+        const arr = new Uint32Array(triCount);
+        for (let i = 0; i < triCount; i++)
+            arr[i] = i;
+        indices = arr;
+    }
+    return weldPositions(positions, indices, triCount);
+}
+// ── ManifoldMeshData → THREE.BufferGeometry ──
+/**
+ * Convert ManifoldMeshData into a THREE.BufferGeometry, optionally computing creased normals.
+ * @param data - the source mesh data.
+ * @param options - optional settings; computeNormals defaults to true and derives creased normals.
+ * @returns the resulting THREE.BufferGeometry (empty when there are no positions or indices).
+ */
+export function manifoldMeshToGeo(data, options) {
+    let geo = new THREE.BufferGeometry();
+    if (data.positions.length === 0 || data.indices.length === 0) {
+        return geo;
+    }
+    geo.setAttribute('position', new THREE.BufferAttribute(data.positions, 3));
+    geo.setIndex(new THREE.BufferAttribute(data.indices, 1));
+    if (options?.computeNormals !== false) {
+        geo = deriveNormals(geo);
+    }
+    geo.computeBoundingBox();
+    return geo;
+}
+//# sourceMappingURL=geo-convert.js.map

package/dist/boolean/geo-convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo-convert.js","sourceRoot":"","sources":["../../src/boolean/geo-convert.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * geo-convert — 纯数据转换函数（从 csg.ts 提取）\n *\n * THREE.BufferGeometry ↔ ManifoldMeshData 转换。\n * 不依赖 Worker / postMessage，可在 Node 和浏览器环境通用。\n */\n\nimport * as THREE from 'three'\nimport { deriveNormals } from './deriveNormals'\n\n// ── 类型（与 csg.ts 保持一致）──\n\n/** The set of supported boolean operations. */\nexport type BooleanOperation = 'union' | 'subtract' | 'intersect'\n\n/** Interchange mesh representation: interleaved positions with triangle indices. */\nexport interface ManifoldMeshData {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n/** Design parameters for a dovetail groove (depth, tolerances, width, flaps angle). */\nexport interface DovetailGrooveParams {\n  depth: number\n  depthTolerance: number\n  width: number\n  widthTolerance: number\n  flapsAngle: number\n}\n\n/** Design parameters for a dowel split (diameter, tolerances, height). */\nexport interface DowelSplitParams {\n  diameter: number\n  diameterTolerance: number\n  height: number\n  heightTolerance: number\n}\n\n/** Design parameters for a straight-tenon split (side length, tolerances, height). */\nexport interface StraightTenonSplitParams {\n  sideLength: number\n  sideLengthTolerance: number\n  height: number\n  heightTolerance: number\n}\n\n// ── 焊接重复顶点 ──\n\nfunction weldPositions(\n  positions: Float32Array,\n  indices: Uint32Array | Uint16Array,\n  count: number,\n): ManifoldMeshData {\n  const mapX = new Map<number, Map<number, Map<number, number>>>()\n  const weldedPosArr: number[] = []\n  const weldedIdxArr: number[] = []\n\n  for (let i = 0; i < count; i++) {\n    const vi = indices[i]\n    const x = positions[vi * 3]\n    const y = positions[vi * 3 + 1]\n    const z = positions[vi * 3 + 2]\n    const qx = Math.round(x * 1e6)\n    const qy = Math.round(y * 1e6)\n    const qz = Math.round(z * 1e6)\n\n    let mapY = mapX.get(qx)\n    if (mapY === undefined) {\n      mapY = new Map<number, Map<number, number>>()\n      mapX.set(qx, mapY)\n    }\n    let mapZ = mapY.get(qy)\n    if (mapZ === undefined) {\n      mapZ = new Map<number, number>()\n      mapY.set(qy, mapZ)\n    }\n    let ni = mapZ.get(qz)\n    if (ni === undefined) {\n      ni = weldedPosArr.length / 3\n      mapZ.set(qz, ni)\n      weldedPosArr.push(x, y, z)\n    }\n    weldedIdxArr.push(ni)\n  }\n\n  return {\n    positions: new Float32Array(weldedPosArr),\n    indices: new Uint32Array(weldedIdxArr),\n  }\n}\n\n// ── THREE.BufferGeometry → ManifoldMeshData ──\n\n/**\n * Convert a THREE.BufferGeometry into ManifoldMeshData, welding duplicate vertices.\n * @param geo - the source THREE.BufferGeometry with a position attribute (and optional index).\n * @returns the converted mesh data with welded, unique vertices.\n */\nexport function geoToManifoldMesh(geo: THREE.BufferGeometry): ManifoldMeshData {\n  const pos = geo.getAttribute('position') as THREE.BufferAttribute\n  const arr = (pos as unknown as { array: ArrayLike<number> }).array\n  const positions = new Float32Array(arr as Float32Array)\n\n  let triCount: number\n  let indices: Uint32Array | Uint16Array\n  if (geo.index) {\n    const idx = geo.index\n    triCount = idx.count\n    const idxArr = (idx as unknown as { array: Uint32Array | Uint16Array }).array\n    indices = idxArr instanceof Uint32Array\n      ? new Uint32Array(idxArr.buffer, idxArr.byteOffset, idx.count)\n      : new Uint16Array(idxArr.buffer, idxArr.byteOffset, idx.count)\n  } else {\n    triCount = pos.count\n    const arr = new Uint32Array(triCount)\n    for (let i = 0; i < triCount; i++) arr[i] = i\n    indices = arr\n  }\n\n  return weldPositions(positions, indices, triCount)\n}\n\n// ── ManifoldMeshData → THREE.BufferGeometry ──\n\n/**\n * Convert ManifoldMeshData into a THREE.BufferGeometry, optionally computing creased normals.\n * @param data - the source mesh data.\n * @param options - optional settings; computeNormals defaults to true and derives creased normals.\n * @returns the resulting THREE.BufferGeometry (empty when there are no positions or indices).\n */\nexport function manifoldMeshToGeo(\n  data: ManifoldMeshData,\n  options?: { computeNormals?: boolean },\n): THREE.BufferGeometry {\n  let geo = new THREE.BufferGeometry()\n  if (data.positions.length === 0 || data.indices.length === 0) {\n    return geo\n  }\n  geo.setAttribute('position', new THREE.BufferAttribute(data.positions, 3))\n  geo.setIndex(new THREE.BufferAttribute(data.indices, 1))\n  if (options?.computeNormals !== false) {\n    geo = deriveNormals(geo)\n  }\n  geo.computeBoundingBox()\n  return geo\n}\n"]}