@faicad/faijs 0.13.0

package/dist/mesh/fai_drill.js

@@ -0,0 +1,92 @@
+/**
+ * mesh 钻孔 API
+ *
+ * 提取来源：
+ * - engine/components/drill-hole/DrillHoleCore.ts (executeDrillHoleOnGeometry)
+ * - engine/version-store/executors/DrillCommandExecutor.ts (executeDrillOnGeometryData)
+ *
+ * DrillCommandExecutor 已是最纯的入口（typed arrays 输入输出），
+ * mesh 直接复用其几何计算逻辑。
+ */
+import * as THREE from 'three';
+import { buildHoleGeometry, computeThroughHoleDimensions, computeBlindHoleCenter, positionHoleGeometry, } from './drill-hole/DrillHoleCore.js';
+import { computeBoolean, geoToManifoldMesh, } from '../boolean/csg-backend.js';
+import { getScrewSpec } from '../primitives/screw/screw-db.js';
+/**
+ * Drill a hole into a world-space shape, cutting the hole geometry out with a
+ * CSG subtract.
+ *
+ * @param shape - the world-space shape to drill into.
+ * @param params - drill parameters (position, direction, depth, hole type, screw details).
+ * @returns the drilled shape in world space.
+ */
+export async function drill(shape, params) {
+    const position = new THREE.Vector3(...params.position);
+    const faceNormal = new THREE.Vector3(...params.faceNormal);
+    // 1. 计算钻孔方向：direction 是 Vec3，确保朝向材料内部
+    const direction = new THREE.Vector3(...params.direction).normalize();
+    if (direction.dot(faceNormal) > 0) {
+        direction.negate();
+    }
+    // 2. 从输入几何计算 bbox（世界空间）
+    const bbox = new THREE.Box3();
+    const posVec = new THREE.Vector3();
+    for (let i = 0; i < shape.positions.length; i += 3) {
+        posVec.set(shape.positions[i], shape.positions[i + 1], shape.positions[i + 2]);
+        bbox.expandByPoint(posVec);
+    }
+    const bboxSize = bbox.getSize(new THREE.Vector3());
+    const bboxMax = Math.max(bboxSize.x, bboxSize.y, bboxSize.z);
+    // 3. 钳制深度
+    const depth = params.depth ?? 0;
+    const safeDepth = Math.max(0, Math.min(depth, bboxMax));
+    // 4. 计算孔高和中心
+    let holeHeight;
+    let holeCenter;
+    if (safeDepth === 0) {
+        // 通孔：按 bbox 裁剪
+        const dims = computeThroughHoleDimensions(position, direction, bbox);
+        holeHeight = dims.height + 0.2; // 0.1mm each side
+        holeCenter = dims.center;
+    }
+    else {
+        // 盲孔
+        holeHeight = safeDepth;
+        holeCenter = computeBlindHoleCenter(position, direction, safeDepth);
+        // 螺丝孔带头部时调整中心
+        if (params.holeType === 'screw' && params.screwHead && params.screwHead !== 'none') {
+            const system = params.screwSystem ?? 'metric';
+            const specIdx = params.screwSpecIdx ?? 4;
+            const spec = getScrewSpec(system, specIdx);
+            const headHeight = spec.dia;
+            holeCenter.add(direction.clone().normalize().multiplyScalar(headHeight / 2));
+        }
+    }
+    // 5. 构建孔几何（Z-up，居中于原点）
+    const drillHoleParams = {
+        diameter: params.diameter,
+        depth: depth,
+        holeType: params.holeType ?? 'simple',
+        direction: 'normal',
+        tolerance: params.tolerance ?? 0.3,
+        snapEnabled: true,
+        screwSystem: params.screwSystem ?? 'metric',
+        screwSpecIdx: params.screwSpecIdx ?? 4,
+        screwThread: params.screwThread ?? 'coarse',
+        screwHead: params.screwHead ?? 'none',
+        screwPitchCustom: 0,
+        screwLength: 0,
+    };
+    const holeGeo = buildHoleGeometry(drillHoleParams, holeHeight);
+    // 6. 定位孔几何到世界空间
+    const holeGeoWorld = positionHoleGeometry(holeGeo, direction, holeCenter);
+    // 7. 转换为 ManifoldMeshData
+    const holeManifold = geoToManifoldMesh(holeGeoWorld);
+    // 8. CSG subtract
+    const result = await computeBoolean([shape, holeManifold], 'subtract');
+    // 9. 清理
+    holeGeo.dispose();
+    holeGeoWorld.dispose();
+    return result;
+}
+//# sourceMappingURL=fai_drill.js.map

package/dist/mesh/fai_drill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_drill.js","sourceRoot":"","sources":["../../src/mesh/fai_drill.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 钻孔 API\n *\n * 提取来源：\n * - engine/components/drill-hole/DrillHoleCore.ts (executeDrillHoleOnGeometry)\n * - engine/version-store/executors/DrillCommandExecutor.ts (executeDrillOnGeometryData)\n *\n * DrillCommandExecutor 已是最纯的入口（typed arrays 输入输出），\n * mesh 直接复用其几何计算逻辑。\n */\n\nimport * as THREE from 'three'\nimport {\n  buildHoleGeometry,\n  computeThroughHoleDimensions,\n  computeBlindHoleCenter,\n  positionHoleGeometry,\n} from './drill-hole/DrillHoleCore'\nimport {\n  computeBoolean,\n  geoToManifoldMesh,\n} from '../boolean/csg-backend'\nimport { getScrewSpec } from '../primitives/screw/screw-db'\nimport type { Shape, DrillParams } from './types'\n\n/**\n * Drill a hole into a world-space shape, cutting the hole geometry out with a\n * CSG subtract.\n *\n * @param shape - the world-space shape to drill into.\n * @param params - drill parameters (position, direction, depth, hole type, screw details).\n * @returns the drilled shape in world space.\n */\nexport async function drill(shape: Shape, params: DrillParams): Promise<Shape> {\n  const position = new THREE.Vector3(...params.position)\n  const faceNormal = new THREE.Vector3(...params.faceNormal)\n\n  // 1. 计算钻孔方向：direction 是 Vec3，确保朝向材料内部\n  const direction = new THREE.Vector3(...params.direction).normalize()\n  if (direction.dot(faceNormal) > 0) {\n    direction.negate()\n  }\n\n  // 2. 从输入几何计算 bbox（世界空间）\n  const bbox = new THREE.Box3()\n  const posVec = new THREE.Vector3()\n  for (let i = 0; i < shape.positions.length; i += 3) {\n    posVec.set(shape.positions[i], shape.positions[i + 1], shape.positions[i + 2])\n    bbox.expandByPoint(posVec)\n  }\n  const bboxSize = bbox.getSize(new THREE.Vector3())\n  const bboxMax = Math.max(bboxSize.x, bboxSize.y, bboxSize.z)\n\n  // 3. 钳制深度\n  const depth = params.depth ?? 0\n  const safeDepth = Math.max(0, Math.min(depth, bboxMax))\n\n  // 4. 计算孔高和中心\n  let holeHeight: number\n  let holeCenter: THREE.Vector3\n\n  if (safeDepth === 0) {\n    // 通孔：按 bbox 裁剪\n    const dims = computeThroughHoleDimensions(position, direction, bbox)\n    holeHeight = dims.height + 0.2 // 0.1mm each side\n    holeCenter = dims.center\n  } else {\n    // 盲孔\n    holeHeight = safeDepth\n    holeCenter = computeBlindHoleCenter(position, direction, safeDepth)\n\n    // 螺丝孔带头部时调整中心\n    if (params.holeType === 'screw' && params.screwHead && params.screwHead !== 'none') {\n      const system = (params.screwSystem as 'metric' | 'imperial') ?? 'metric'\n      const specIdx = params.screwSpecIdx ?? 4\n      const spec = getScrewSpec(system, specIdx)\n      const headHeight = spec.dia\n      holeCenter.add(direction.clone().normalize().multiplyScalar(headHeight / 2))\n    }\n  }\n\n  // 5. 构建孔几何（Z-up，居中于原点）\n  const drillHoleParams = {\n    diameter: params.diameter,\n    depth: depth,\n    holeType: params.holeType ?? 'simple',\n    direction: 'normal' as const,\n    tolerance: params.tolerance ?? 0.3,\n    snapEnabled: true,\n    screwSystem: (params.screwSystem as 'metric' | 'imperial') ?? 'metric',\n    screwSpecIdx: params.screwSpecIdx ?? 4,\n    screwThread: (params.screwThread as 'coarse' | 'fine' | 'none') ?? 'coarse',\n    screwHead: (params.screwHead as 'hex' | 'chc' | 'none') ?? 'none',\n    screwPitchCustom: 0,\n    screwLength: 0,\n  }\n  const holeGeo = buildHoleGeometry(drillHoleParams, holeHeight)\n\n  // 6. 定位孔几何到世界空间\n  const holeGeoWorld = positionHoleGeometry(holeGeo, direction, holeCenter)\n\n  // 7. 转换为 ManifoldMeshData\n  const holeManifold = geoToManifoldMesh(holeGeoWorld)\n\n  // 8. CSG subtract\n  const result = await computeBoolean([shape, holeManifold], 'subtract')\n\n  // 9. 清理\n  holeGeo.dispose()\n  holeGeoWorld.dispose()\n\n  return result\n}\n"]}

package/dist/mesh/fai_extrude.d.ts

@@ -0,0 +1,24 @@
+/**
+ * mesh 拉伸 API
+ *
+ * 提取来源：engine/boolean/extrude-helpers.ts (buildExtrudeParts)
+ * 已是纯数据函数（ManifoldMeshData 输入输出），直接包装。
+ *
+ * 拉伸语义（三段模型）：
+ * - back（下半）：沿法线 N 平移 offsetBack
+ * - middle（中段）：平面处的截面沿 N 挤出 L
+ * - front（上半）：沿法线 N 平移 offsetFront
+ * 其中 offsetFront - offsetBack === length 恒成立。
+ */
+import type { Shape, ExtrudeParams } from './types.js';
+/**
+ * Execute a face extrude: cut the model at the cutting plane and extrude the
+ * middle section by `length` along the plane normal, then union the three
+ * segments back into a single solid.
+ *
+ * @param shape - the world-space shape to extrude.
+ * @param params - extrude parameters (normal, originOffset, length, mode).
+ * @returns the extruded shape in world space.
+ */
+export declare function extrude(shape: Shape, params: ExtrudeParams): Promise<Shape>;
+//# sourceMappingURL=fai_extrude.d.ts.map

package/dist/mesh/fai_extrude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_extrude.d.ts","sourceRoot":"","sources":["../../src/mesh/fai_extrude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAEnD;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CA2BjF"}

package/dist/mesh/fai_extrude.js

@@ -0,0 +1,42 @@
+/**
+ * mesh 拉伸 API
+ *
+ * 提取来源：engine/boolean/extrude-helpers.ts (buildExtrudeParts)
+ * 已是纯数据函数（ManifoldMeshData 输入输出），直接包装。
+ *
+ * 拉伸语义（三段模型）：
+ * - back（下半）：沿法线 N 平移 offsetBack
+ * - middle（中段）：平面处的截面沿 N 挤出 L
+ * - front（上半）：沿法线 N 平移 offsetFront
+ * 其中 offsetFront - offsetBack === length 恒成立。
+ */
+import { computeBoolean } from '../boolean/csg-backend.js';
+import { buildExtrudeParts } from '../boolean/extrude-helpers.js';
+/**
+ * Execute a face extrude: cut the model at the cutting plane and extrude the
+ * middle section by `length` along the plane normal, then union the three
+ * segments back into a single solid.
+ *
+ * @param shape - the world-space shape to extrude.
+ * @param params - extrude parameters (normal, originOffset, length, mode).
+ * @returns the extruded shape in world space.
+ */
+export async function extrude(shape, params) {
+    const mode = params.mode ?? 'centered';
+    const { front, back, extruded } = await buildExtrudeParts(shape, params.normal, params.originOffset, params.length, mode);
+    // Union 三段为单体
+    const meshesToUnion = [];
+    for (const part of [front, extruded, back]) {
+        if (!part || part.indices.length === 0)
+            continue;
+        meshesToUnion.push(part);
+    }
+    if (meshesToUnion.length === 0) {
+        throw new Error('No valid geometry to extrude');
+    }
+    if (meshesToUnion.length === 1) {
+        return meshesToUnion[0];
+    }
+    return computeBoolean(meshesToUnion, 'union');
+}
+//# sourceMappingURL=fai_extrude.js.map

package/dist/mesh/fai_extrude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_extrude.js","sourceRoot":"","sources":["../../src/mesh/fai_extrude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAI9D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY,EAAE,MAAqB;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,UAAU,CAAA;IAEtC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,CACvD,KAAyB,EACzB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,MAAM,EACb,IAAI,CACL,CAAA;IAED,cAAc;IACd,MAAM,aAAa,GAAuB,EAAE,CAAA;IAC5C,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QAChD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,aAAa,CAAC,CAAC,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;AAC/C,CAAC","sourcesContent":["/**\n * mesh 拉伸 API\n *\n * 提取来源：engine/boolean/extrude-helpers.ts (buildExtrudeParts)\n * 已是纯数据函数（ManifoldMeshData 输入输出），直接包装。\n *\n * 拉伸语义（三段模型）：\n * - back（下半）：沿法线 N 平移 offsetBack\n * - middle（中段）：平面处的截面沿 N 挤出 L\n * - front（上半）：沿法线 N 平移 offsetFront\n * 其中 offsetFront - offsetBack === length 恒成立。\n */\n\nimport { computeBoolean } from '../boolean/csg-backend'\nimport { buildExtrudeParts } from '../boolean/extrude-helpers'\nimport type { ManifoldMeshData } from '../boolean/csg-backend'\nimport type { Shape, ExtrudeParams } from './types'\n\n/**\n * Execute a face extrude: cut the model at the cutting plane and extrude the\n * middle section by `length` along the plane normal, then union the three\n * segments back into a single solid.\n *\n * @param shape - the world-space shape to extrude.\n * @param params - extrude parameters (normal, originOffset, length, mode).\n * @returns the extruded shape in world space.\n */\nexport async function extrude(shape: Shape, params: ExtrudeParams): Promise<Shape> {\n  const mode = params.mode ?? 'centered'\n\n  const { front, back, extruded } = await buildExtrudeParts(\n    shape as ManifoldMeshData,\n    params.normal,\n    params.originOffset,\n    params.length,\n    mode,\n  )\n\n  // Union 三段为单体\n  const meshesToUnion: ManifoldMeshData[] = []\n  for (const part of [front, extruded, back]) {\n    if (!part || part.indices.length === 0) continue\n    meshesToUnion.push(part)\n  }\n\n  if (meshesToUnion.length === 0) {\n    throw new Error('No valid geometry to extrude')\n  }\n\n  if (meshesToUnion.length === 1) {\n    return meshesToUnion[0]\n  }\n\n  return computeBoolean(meshesToUnion, 'union')\n}\n"]}

package/dist/mesh/fai_split.d.ts

@@ -0,0 +1,164 @@
+/**
+ * mesh 分割 API
+ *
+ * 提取来源：engine/boolean/csg.ts (computeSplit/computeDovetailSplit/...)
+ * 已是纯数据函数，直接包装。
+ *
+ * splitWithParams 是 UI 与重放共用的唯一分割入口：
+ * 参数编排（planeParams / planeBasis / 爆炸位移 / 世界坐标变换）
+ * 全部在此函数内部完成，调用方只需传入 cutMode + normal/offset/inPlaneAngleDeg + bbCenter
+ * 以及各 cutMode 专属参数。
+ */
+import type { Shape, SplitResult, SplitPlane, DovetailSplitParams, DowelSplitParams, TenonSplitParams, Vec3 } from './types.js';
+/**
+ * Derive the cutting-plane parameters from Euler angles (in degrees), the
+ * plane position and the bounding-box center. Behavior is identical to the
+ * former split-store.computePlaneParams.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @param planePosition - offset of the cutting plane along the plane normal.
+ * @param bbCenter - world-space bounding-box center of the source mesh.
+ * @returns the plane normal, the plane's signed distance from the origin, and its center.
+ */
+export declare function computePlaneParams(rotationX: number, rotationY: number, rotationZ: number, planePosition: number, bbCenter: Vec3): {
+    normal: Vec3;
+    originOffset: number;
+    planeCenter: Vec3;
+};
+/**
+ * Derive the plane basis vectors from Euler angles (in degrees). Behavior is
+ * identical to the former split-store.computePlaneBasis.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @returns the plane normal plus the in-plane width and depth directions.
+ */
+export declare function computePlaneBasis(rotationX: number, rotationY: number, rotationZ: number): {
+    normal: Vec3;
+    widthDir: Vec3;
+    depthDir: Vec3;
+};
+/**
+ * Derive widthDir/depthDir from the cutting-plane normal and the in-plane
+ * rotation angle. Matches computePlaneBasis(rx, ry, rz) with
+ * normal = eulerXYZToNormal(rx, ry, 0) and inPlaneAngleDeg = rz: the rx/ry
+ * Euler XYZ decomposition is recovered from the normal, then the rz rotation
+ * is applied.
+ *
+ * normal = [sin(ry), -sin(rx)*cos(ry), cos(rx)*cos(ry)]
+ *   ry = asin(normal[0])
+ *   rx = atan2(-normal[1], normal[2])  (when cos(ry) !== 0)
+ * @param normal - cutting-plane unit normal.
+ * @param inPlaneAngleDeg - in-plane rotation about the normal, in degrees.
+ * @returns the in-plane width and depth directions.
+ */
+export declare function computeBasisFromNormal(normal: Vec3, inPlaneAngleDeg: number): {
+    widthDir: Vec3;
+    depthDir: Vec3;
+};
+/**
+ * Input parameters for splitWithParams.
+ */
+export interface SplitWithParamsInput {
+    /** 源几何（已在世界空间） */
+    shape: Shape;
+    /** 分割模式 */
+    cutMode: 'plane' | 'dovetail' | 'dowel' | 'straight-tenon' | 'tenon' | 'straight';
+    /** 切割面法线 */
+    normal: Vec3;
+    /** 切割面沿法线方向相对 bbCenter 的偏移（标量） */
+    offset: number;
+    /** 切割面绕法线的面内旋转（角度制，承载原 planeRotation 的 rz 分量） */
+    inPlaneAngleDeg: number;
+    /** 源 mesh 的世界空间包围盒中心 */
+    bbCenter: Vec3;
+    /** 源 mesh 的世界空间包围盒尺寸（用于计算 bboxWidthOnWidthDir 和爆炸位移） */
+    bboxSize: Vec3;
+    /** 燕尾参数（cutMode='dovetail' 时需要） */
+    groove?: {
+        depth: number;
+        depthTolerance: number;
+        width: number;
+        widthTolerance: number;
+        flapsAngle: number;
+    };
+    /** 定位销参数（cutMode='dowel' 时需要） */
+    dowel?: {
+        diameter: number;
+        diameterTolerance: number;
+        height: number;
+        heightTolerance: number;
+    };
+    /** 直榫参数（cutMode='straight-tenon' 时需要） */
+    tenon?: {
+        sideLength: number;
+        sideLengthTolerance: number;
+        height: number;
+        heightTolerance: number;
+    };
+    /** 选择的截面（dowel/straight-tenon 用） */
+    selectedSections?: number[] | null;
+    /** 是否应用爆炸位移（默认 true；导出/重放纯几何时可设 false） */
+    applyExplode?: boolean;
+}
+/**
+ * Output of splitWithParams: the two halves plus the derived splitting data.
+ */
+export interface SplitWithParamsResult {
+    front: Shape;
+    back: Shape;
+    /** 实际使用的法线（派生量，供调用方记录/调试） */
+    normal: Vec3;
+    /** 实际使用的 originOffset（派生量） */
+    originOffset: number;
+    /** 实际使用的 planeCenter（派生量） */
+    planeCenter: Vec3;
+    /** 实际使用的 widthDir（派生量） */
+    widthDir: Vec3;
+    /** 爆炸位移（front 正、back 负） */
+    frontExplodeOffset: number;
+    backExplodeOffset: number;
+}
+/**
+ * Unified split entry point: the single split function shared by the UI
+ * executor and script replay. All parameter orchestration (planeParams,
+ * planeBasis, bboxWidthOnWidthDir, explode offset) happens inside this
+ * function; callers pass only semantic parameters. Both interaction paths
+ * (mouse / code) converge here, so the geometry result is identical.
+ * @param input - the split mode-specific input (shape, plane, mode params).
+ * @returns the split result with front/back halves and derived plane data.
+ */
+export declare function splitWithParams(input: SplitWithParamsInput): Promise<SplitWithParamsResult>;
+/**
+ * Plane split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param plane - the cutting plane (normal + offset).
+ * @returns the front and back halves of the shape.
+ */
+export declare function split(shape: Shape, plane: SplitPlane): Promise<{
+    front: Shape;
+    back: Shape;
+}>;
+/**
+ * Dovetail split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dovetail groove parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dovetail wedge.
+ */
+export declare function dovetailSplit(shape: Shape, params: DovetailSplitParams): Promise<SplitResult>;
+/**
+ * Dowel-pin split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dowel parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dowel wedge.
+ */
+export declare function dowelSplit(shape: Shape, params: DowelSplitParams): Promise<SplitResult>;
+/**
+ * Straight-tenon split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - tenon parameters plus the cutting plane setup.
+ * @returns the front/back halves and the tenon wedge.
+ */
+export declare function tenonSplit(shape: Shape, params: TenonSplitParams): Promise<SplitResult>;
+//# sourceMappingURL=fai_split.d.ts.map

package/dist/mesh/fai_split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_split.d.ts","sourceRoot":"","sources":["../../src/mesh/fai_split.ts"],"names":[],"mappings":"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"}

package/dist/mesh/fai_split.js

@@ -0,0 +1,269 @@
+/**
+ * mesh 分割 API
+ *
+ * 提取来源：engine/boolean/csg.ts (computeSplit/computeDovetailSplit/...)
+ * 已是纯数据函数，直接包装。
+ *
+ * splitWithParams 是 UI 与重放共用的唯一分割入口：
+ * 参数编排（planeParams / planeBasis / 爆炸位移 / 世界坐标变换）
+ * 全部在此函数内部完成，调用方只需传入 cutMode + normal/offset/inPlaneAngleDeg + bbCenter
+ * 以及各 cutMode 专属参数。
+ */
+import { computeSplit, computeDovetailSplit, computeDowelSplit, computeStraightTenonSplit, } from '../boolean/csg-backend.js';
+import * as THREE from 'three';
+// ── 派生量计算（从 split-store 下沉，UI 与重放共用同一份公式） ──
+/**
+ * Derive the cutting-plane parameters from Euler angles (in degrees), the
+ * plane position and the bounding-box center. Behavior is identical to the
+ * former split-store.computePlaneParams.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @param planePosition - offset of the cutting plane along the plane normal.
+ * @param bbCenter - world-space bounding-box center of the source mesh.
+ * @returns the plane normal, the plane's signed distance from the origin, and its center.
+ */
+export function computePlaneParams(rotationX, rotationY, rotationZ, planePosition, bbCenter) {
+    const rx = (rotationX * Math.PI) / 180;
+    const ry = (rotationY * Math.PI) / 180;
+    const rz = (rotationZ * Math.PI) / 180;
+    const euler = new THREE.Euler(rx, ry, rz, 'XYZ');
+    const quat = new THREE.Quaternion().setFromEuler(euler);
+    const normalVec = new THREE.Vector3(0, 0, 1).applyQuaternion(quat);
+    const normal = [normalVec.x, normalVec.y, normalVec.z];
+    const planeCenter = [
+        bbCenter[0] + planePosition * normal[0],
+        bbCenter[1] + planePosition * normal[1],
+        bbCenter[2] + planePosition * normal[2],
+    ];
+    const originOffset = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2];
+    return { normal, originOffset, planeCenter };
+}
+/**
+ * Derive the plane basis vectors from Euler angles (in degrees). Behavior is
+ * identical to the former split-store.computePlaneBasis.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @returns the plane normal plus the in-plane width and depth directions.
+ */
+export function computePlaneBasis(rotationX, rotationY, rotationZ) {
+    const rx = (rotationX * Math.PI) / 180;
+    const ry = (rotationY * Math.PI) / 180;
+    const rz = (rotationZ * Math.PI) / 180;
+    const euler = new THREE.Euler(rx, ry, rz, 'XYZ');
+    const quat = new THREE.Quaternion().setFromEuler(euler);
+    const normalVec = new THREE.Vector3(0, 0, 1).applyQuaternion(quat);
+    const widthVec = new THREE.Vector3(1, 0, 0).applyQuaternion(quat);
+    const depthVec = new THREE.Vector3(0, 1, 0).applyQuaternion(quat);
+    return {
+        normal: [normalVec.x, normalVec.y, normalVec.z],
+        widthDir: [widthVec.x, widthVec.y, widthVec.z],
+        depthDir: [depthVec.x, depthVec.y, depthVec.z],
+    };
+}
+// ── 从法线 + 面内旋转推导基向量（纯数学，无 THREE 依赖） ──
+/**
+ * Derive widthDir/depthDir from the cutting-plane normal and the in-plane
+ * rotation angle. Matches computePlaneBasis(rx, ry, rz) with
+ * normal = eulerXYZToNormal(rx, ry, 0) and inPlaneAngleDeg = rz: the rx/ry
+ * Euler XYZ decomposition is recovered from the normal, then the rz rotation
+ * is applied.
+ *
+ * normal = [sin(ry), -sin(rx)*cos(ry), cos(rx)*cos(ry)]
+ *   ry = asin(normal[0])
+ *   rx = atan2(-normal[1], normal[2])  (when cos(ry) !== 0)
+ * @param normal - cutting-plane unit normal.
+ * @param inPlaneAngleDeg - in-plane rotation about the normal, in degrees.
+ * @returns the in-plane width and depth directions.
+ */
+export function computeBasisFromNormal(normal, inPlaneAngleDeg) {
+    const sinRy = Math.max(-1, Math.min(1, normal[0]));
+    const ry = Math.asin(sinRy);
+    const cosRy = Math.cos(ry);
+    let rx;
+    if (Math.abs(cosRy) < 1e-10) {
+        // 万向锁：ry = ±90°，rx 与 rz 耦合，设 rx = 0
+        rx = 0;
+    }
+    else {
+        rx = Math.atan2(-normal[1], normal[2]);
+    }
+    const rz = (inPlaneAngleDeg * Math.PI) / 180;
+    // R = RX(rx) · RY(ry)（不含 rz 的部分）
+    // widthDir = R · (cos(rz), sin(rz), 0)
+    // depthDir = R · (-sin(rz), cos(rz), 0)
+    const cr = Math.cos(ry), sr = Math.sin(ry);
+    const cx = Math.cos(rx), sx = Math.sin(rx);
+    const cosRz = Math.cos(rz), sinRz = Math.sin(rz);
+    const widthDir = [
+        cr * cosRz,
+        sx * sr * cosRz + cx * sinRz,
+        -cx * sr * cosRz + sx * sinRz,
+    ];
+    const depthDir = [
+        -cr * sinRz,
+        -sx * sr * sinRz + cx * cosRz,
+        cx * sr * sinRz + sx * cosRz,
+    ];
+    return { widthDir, depthDir };
+}
+/**
+ * Unified split entry point: the single split function shared by the UI
+ * executor and script replay. All parameter orchestration (planeParams,
+ * planeBasis, bboxWidthOnWidthDir, explode offset) happens inside this
+ * function; callers pass only semantic parameters. Both interaction paths
+ * (mouse / code) converge here, so the geometry result is identical.
+ * @param input - the split mode-specific input (shape, plane, mode params).
+ * @returns the split result with front/back halves and derived plane data.
+ */
+export async function splitWithParams(input) {
+    const { shape, cutMode, normal, offset, inPlaneAngleDeg, bbCenter, bboxSize } = input;
+    // 1. 从 normal + offset + bbCenter 派生切割平面参数
+    const planeCenter = [
+        bbCenter[0] + offset * normal[0],
+        bbCenter[1] + offset * normal[1],
+        bbCenter[2] + offset * normal[2],
+    ];
+    const originOffset = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2];
+    // 2. 从 normal + inPlaneAngleDeg 派生基向量
+    const { widthDir } = computeBasisFromNormal(normal, inPlaneAngleDeg);
+    // 3. 按 cutMode 分发
+    let front;
+    let back;
+    if (cutMode === 'dovetail') {
+        const bboxWidthOnWidthDir = Math.abs(bboxSize[0] * widthDir[0]) +
+            Math.abs(bboxSize[1] * widthDir[1]) +
+            Math.abs(bboxSize[2] * widthDir[2]);
+        const groove = input.groove ?? {
+            depth: 0, depthTolerance: 0, width: 0, widthTolerance: 0, flapsAngle: 0,
+        };
+        const result = await computeDovetailSplit(shape, normal, originOffset, planeCenter, widthDir, bboxWidthOnWidthDir, groove);
+        front = result.front;
+        back = result.back;
+        const result2 = await finalizeExplode(front, back, normal, originOffset, planeCenter, widthDir, bboxSize, cutMode, input);
+        return result2;
+    }
+    else if (cutMode === 'dowel') {
+        const dowel = input.dowel ?? {
+            diameter: 0, diameterTolerance: 0, height: 0, heightTolerance: 0,
+        };
+        const result = await computeDowelSplit(shape, normal, originOffset, planeCenter, widthDir, dowel, input.selectedSections ?? null);
+        front = result.front;
+        back = result.back;
+        return finalizeExplode(front, back, normal, originOffset, planeCenter, widthDir, bboxSize, cutMode, input);
+    }
+    else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {
+        const tenon = input.tenon ?? {
+            sideLength: 0, sideLengthTolerance: 0, height: 0, heightTolerance: 0,
+        };
+        const result = await computeStraightTenonSplit(shape, normal, originOffset, planeCenter, widthDir, tenon, input.selectedSections ?? null);
+        front = result.front;
+        back = result.back;
+        return finalizeExplode(front, back, normal, originOffset, planeCenter, widthDir, bboxSize, cutMode, input);
+    }
+    else {
+        // plane / straight / default
+        const result = await computeSplit(shape, normal, originOffset);
+        front = result.front;
+        back = result.back;
+        return finalizeExplode(front, back, normal, originOffset, planeCenter, widthDir, bboxSize, cutMode, input);
+    }
+}
+/** 计算爆炸位移并应用到 front/back */
+async function finalizeExplode(front, back, normal, originOffset, planeCenter, widthDir, bboxSize, cutMode, input) {
+    const applyExplode = input.applyExplode ?? true;
+    // 爆炸位移：包围盒对角线的 2% + joinery 深度的一半
+    const bboxDiagonal = Math.sqrt(bboxSize[0] * bboxSize[0] + bboxSize[1] * bboxSize[1] + bboxSize[2] * bboxSize[2]);
+    const baseOffset = bboxDiagonal * 0.02;
+    let joineryOffset = 0;
+    if (cutMode === 'dovetail') {
+        joineryOffset = (input.groove?.depth ?? 0) / 2;
+    }
+    else if (cutMode === 'dowel') {
+        joineryOffset = (input.dowel?.height ?? 0) / 2;
+    }
+    else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {
+        joineryOffset = (input.tenon?.height ?? 0) / 2;
+    }
+    const frontOffset = baseOffset + joineryOffset;
+    const backOffset = -(baseOffset + joineryOffset);
+    if (applyExplode) {
+        front = { positions: offsetPositions(front.positions, normal, frontOffset), indices: front.indices };
+        back = { positions: offsetPositions(back.positions, normal, backOffset), indices: back.indices };
+    }
+    return {
+        front,
+        back,
+        normal,
+        originOffset,
+        planeCenter,
+        widthDir,
+        frontExplodeOffset: applyExplode ? frontOffset : 0,
+        backExplodeOffset: applyExplode ? backOffset : 0,
+    };
+}
+/** 沿法线方向偏移所有顶点 */
+function offsetPositions(positions, normal, offset) {
+    const out = new Float32Array(positions);
+    for (let i = 0; i < out.length; i += 3) {
+        out[i] += normal[0] * offset;
+        out[i + 1] += normal[1] * offset;
+        out[i + 2] += normal[2] * offset;
+    }
+    return out;
+}
+// ── 低级 API（保留向后兼容） ──
+/**
+ * Plane split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param plane - the cutting plane (normal + offset).
+ * @returns the front and back halves of the shape.
+ */
+export async function split(shape, plane) {
+    const result = await computeSplit(shape, plane.normal, plane.offset);
+    return { front: result.front, back: result.back };
+}
+/**
+ * Dovetail split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dovetail groove parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dovetail wedge.
+ */
+export async function dovetailSplit(shape, params) {
+    const result = await computeDovetailSplit(shape, params.plane.normal, params.plane.offset, params.planeCenter, params.widthDir, params.bboxWidthOnWidthDir, params.groove);
+    return {
+        front: result.front,
+        back: result.back,
+        wedge: result.wedge,
+    };
+}
+/**
+ * Dowel-pin split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dowel parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dowel wedge.
+ */
+export async function dowelSplit(shape, params) {
+    const result = await computeDowelSplit(shape, params.plane.normal, params.plane.offset, params.planeCenter, params.widthDir, params.dowel, params.selectedSections);
+    return {
+        front: result.front,
+        back: result.back,
+        wedge: result.wedge,
+    };
+}
+/**
+ * Straight-tenon split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - tenon parameters plus the cutting plane setup.
+ * @returns the front/back halves and the tenon wedge.
+ */
+export async function tenonSplit(shape, params) {
+    const result = await computeStraightTenonSplit(shape, params.plane.normal, params.plane.offset, params.planeCenter, params.widthDir, params.tenon, params.selectedSections);
+    return {
+        front: result.front,
+        back: result.back,
+        wedge: result.wedge,
+    };
+}
+//# sourceMappingURL=fai_split.js.map