@faicad/faijs 0.13.0

package/dist/mesh/drill-hole/DrillHoleCore.js

@@ -0,0 +1,287 @@
+import * as THREE from 'three';
+import { makeScrew } from '../../primitives/screw/screw.js';
+import { getScrewSpec } from '../../primitives/screw/screw-db.js';
+import { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo, } from '../../boolean/csg-backend.js';
+import { deriveNormals } from '../../boolean/deriveNormals.js';
+/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */
+const ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2);
+/**
+ * Build a Z-up hole geometry centered on the origin, with the axial direction
+ * along Z.
+ *
+ * - simple: CylinderGeometry rotated to Z-up
+ * - screw: makeScrew() already returns Z-up
+ *
+ * Tolerance is applied as a radial expansion (tolerance/2 on radius).
+ *
+ * @param params - drill-hole parameters (type, diameter, screw details, tolerance).
+ * @param height - axial length of the hole in millimeters.
+ * @returns the hole geometry as a Z-up BufferGeometry.
+ */
+export function buildHoleGeometry(params, height) {
+    const toleranceRadius = params.tolerance / 2;
+    // ── simple: CylinderGeometry → rotate to Z-up ──
+    if (params.holeType === 'simple') {
+        const r = params.diameter / 2 + toleranceRadius;
+        const geo = new THREE.CylinderGeometry(r, r, height, 32);
+        geo.applyMatrix4(ROT_Y_TO_Z);
+        return geo;
+    }
+    // ── screw: makeScrew() already returns Z-up ──
+    if (params.holeType === 'screw') {
+        const geo = makeScrew({
+            system: params.screwSystem,
+            specIdx: params.screwSpecIdx,
+            thread: params.screwThread,
+            pitchCustom: 0,
+            length: height,
+            head: params.screwHead,
+            nRad: 32,
+        });
+        // Center the screw on origin. makeScrew extends from Z=0 to Z=height
+        // for the body, plus headHeight = spec.dia for the head (if present).
+        // The total length = height + headHeight, so center by half that.
+        const spec = getScrewSpec(params.screwSystem, params.screwSpecIdx);
+        const headHeight = params.screwHead !== 'none' ? spec.dia : 0;
+        const totalLength = height + headHeight;
+        geo.translate(0, 0, -totalLength / 2);
+        // For screw with head: makeScrew places the head at the +Z end (top of
+        // the screw), but for a drill hole the head must be at the -Z end — the
+        // entry point at the surface. Reflect Z to put the head at the entry side,
+        // and reverse triangle winding to maintain correct normals.
+        if (params.screwHead !== 'none') {
+            const pos = geo.getAttribute('position');
+            for (let i = 0; i < pos.count; i++) {
+                pos.setZ(i, -pos.getZ(i));
+            }
+            pos.needsUpdate = true;
+            // Fix winding order: reflection flips triangle orientation
+            const idx = geo.index;
+            const arr = idx.array;
+            for (let i = 0; i < arr.length; i += 3) {
+                const tmp = arr[i + 1];
+                arr[i + 1] = arr[i + 2];
+                arr[i + 2] = tmp;
+            }
+            idx.needsUpdate = true;
+        }
+        // Apply tolerance: scale radially (X and Y in Z-up space)
+        const baseRadius = spec.dia / 2;
+        if (toleranceRadius > 0 && baseRadius > 0) {
+            const scale = 1 + toleranceRadius / baseRadius;
+            geo.scale(scale, scale, 1);
+        }
+        return geo;
+    }
+    // Fallback (should not reach)
+    const geo = new THREE.CylinderGeometry(params.diameter / 2, params.diameter / 2, height, 32);
+    geo.applyMatrix4(ROT_Y_TO_Z);
+    return geo;
+}
+/**
+ * Compute the through-hole height by raycasting against the target mesh's
+ * bounding box. Returns { height, center } so the cylinder exactly spans the
+ * model thickness along the drill direction, without extending outside.
+ *
+ * @param position - world-space position of the hole entry point.
+ * @param direction - the drill direction (normalized internally).
+ * @param bbox - world-space bounding box of the target mesh.
+ * @returns the height and world-space center of the through hole.
+ */
+export function computeThroughHoleDimensions(position, direction, bbox) {
+    const dir = direction.clone().normalize();
+    // Manual slab-method intersection: compute distances along dir to bbox entry/exit.
+    // This handles edge cases where position is exactly on the bbox boundary
+    // (Ray.intersectBox returns null in those cases).
+    const p = position;
+    const d = dir;
+    let tNear = -Infinity;
+    let tFar = Infinity;
+    // X slab
+    if (Math.abs(d.x) > 1e-12) {
+        const t1 = (bbox.min.x - p.x) / d.x;
+        const t2 = (bbox.max.x - p.x) / d.x;
+        tNear = Math.max(tNear, Math.min(t1, t2));
+        tFar = Math.min(tFar, Math.max(t1, t2));
+    }
+    else if (p.x < bbox.min.x || p.x > bbox.max.x) {
+        // Parallel to X slab and outside — no intersection
+        return { height: 0, center: position.clone() };
+    }
+    // Y slab
+    if (Math.abs(d.y) > 1e-12) {
+        const t1 = (bbox.min.y - p.y) / d.y;
+        const t2 = (bbox.max.y - p.y) / d.y;
+        tNear = Math.max(tNear, Math.min(t1, t2));
+        tFar = Math.min(tFar, Math.max(t1, t2));
+    }
+    else if (p.y < bbox.min.y || p.y > bbox.max.y) {
+        return { height: 0, center: position.clone() };
+    }
+    // Z slab
+    if (Math.abs(d.z) > 1e-12) {
+        const t1 = (bbox.min.z - p.z) / d.z;
+        const t2 = (bbox.max.z - p.z) / d.z;
+        tNear = Math.max(tNear, Math.min(t1, t2));
+        tFar = Math.min(tFar, Math.max(t1, t2));
+    }
+    else if (p.z < bbox.min.z || p.z > bbox.max.z) {
+        return { height: 0, center: position.clone() };
+    }
+    // Clamp: if position is inside or on boundary, tNear <= 0 <= tFar
+    // Forward distance = tFar (exit point along +dir)
+    // Backward distance = -tNear (exit point along -dir, i.e. behind us)
+    const forwardDist = tFar > 0 ? tFar : 0;
+    const backwardDist = tNear < 0 ? -tNear : 0;
+    const height = forwardDist + backwardDist;
+    const center = position.clone()
+        .add(dir.clone().multiplyScalar((forwardDist - backwardDist) / 2));
+    return { height, center };
+}
+/**
+ * Compute the blind-hole center: the hole entry is at the click point,
+ * the hole extends inward by `depth`. The cylinder center is at
+ * position + direction * (depth / 2).
+ *
+ * @param position - world-space hole entry point.
+ * @param direction - the drill direction (normalized internally).
+ * @param depth - blind-hole depth in millimeters.
+ * @returns the world-space cylinder center.
+ */
+export function computeBlindHoleCenter(position, direction, depth) {
+    return position.clone().add(direction.clone().normalize().multiplyScalar(depth / 2));
+}
+/**
+ * Orient and position a Z-up hole geometry (axial along Z) to world space.
+ * Returns a new geometry with the transform baked in.
+ *
+ * @param geo - Z-up hole geometry centered on the origin.
+ * @param direction - world-space axis the hole should point along.
+ * @param center - world-space position of the hole center.
+ * @returns a transformed clone of the input geometry.
+ */
+export function positionHoleGeometry(geo, direction, center) {
+    const result = geo.clone();
+    // Rotate Z axis to direction
+    const quat = new THREE.Quaternion().setFromUnitVectors(new THREE.Vector3(0, 0, 1), direction.clone().normalize());
+    result.applyQuaternion(quat);
+    // Translate to center
+    result.translate(center.x, center.y, center.z);
+    return result;
+}
+/**
+ * Resolve the drill direction based on params.direction and the face normal.
+ *
+ * - 'normal': inward direction = negated face normal
+ * - 'x'/'y'/'z': axis-aligned, flipped to point INTO the material
+ *   (i.e. opposite to the face normal)
+ *
+ * @param direction - requested drill-direction reference.
+ * @param faceNormal - face normal at the drill position.
+ * @returns the resolved unit drill direction.
+ */
+export function resolveDrillDirection(direction, faceNormal) {
+    if (direction === 'normal') {
+        return faceNormal.clone().negate().normalize();
+    }
+    // Axis-aligned direction
+    const axisDir = new THREE.Vector3(direction === 'x' ? 1 : 0, direction === 'y' ? 1 : 0, direction === 'z' ? 1 : 0);
+    // Flip to point INTO the material (opposite to face normal)
+    if (axisDir.dot(faceNormal) > 0) {
+        axisDir.negate();
+    }
+    return axisDir;
+}
+/**
+ * Drill a hole into a THREE.Mesh in world space, returning the resulting
+ * geometry in the mesh's local space.
+ *
+ * @param targetMesh - the mesh to drill into.
+ * @param params - drill-hole parameters.
+ * @param position - world-space hole entry point.
+ * @param faceNormal - world-space normal of the face at the entry point.
+ * @returns the drilled geometry in mesh-local space.
+ */
+export async function executeDrillHole(targetMesh, params, position, faceNormal) {
+    targetMesh.updateMatrixWorld();
+    return executeDrillHoleOnGeometry(targetMesh.geometry, targetMesh.matrixWorld, params, position, faceNormal);
+}
+/**
+ * Core drill computation that accepts geometry + world matrix directly.
+ *
+ * This avoids the need to temporarily swap mesh.geometry when the mesh
+ * currently has a preview geometry on it. Callers that have the G0 geometry
+ * in a separate BufferGeometry can use this directly.
+ *
+ * @param sourceGeometry - the base geometry to drill (mesh-local space).
+ * @param worldMatrix - world transform of the source geometry.
+ * @param params - drill-hole parameters.
+ * @param position - world-space hole entry point.
+ * @param faceNormal - world-space face normal at the entry point.
+ * @returns the drilled geometry, transformed back into mesh-local space.
+ */
+export async function executeDrillHoleOnGeometry(sourceGeometry, worldMatrix, params, position, faceNormal) {
+    // 1. Compute drill direction based on params.direction
+    const direction = resolveDrillDirection(params.direction, faceNormal);
+    // 2. Compute bbox from the source geometry (in world space)
+    sourceGeometry.computeBoundingBox();
+    const bbox = sourceGeometry.boundingBox.clone();
+    bbox.applyMatrix4(worldMatrix);
+    const bboxSize = bbox.getSize(new THREE.Vector3());
+    const bboxMax = Math.max(bboxSize.x, bboxSize.y, bboxSize.z);
+    // 3. Clamp depth to valid range: [0, bboxMax]
+    const safeDepth = Math.max(0, Math.min(params.depth, bboxMax));
+    // 4. Compute hole height and center
+    let holeHeight;
+    let holeCenter;
+    if (safeDepth === 0) {
+        // Through hole: clip to bbox
+        const dims = computeThroughHoleDimensions(position, direction, bbox);
+        // Add epsilon on both ends for clean CSG cut
+        holeHeight = dims.height + 0.2; // 0.1mm each side
+        holeCenter = dims.center;
+    }
+    else {
+        // Blind hole
+        holeHeight = safeDepth;
+        holeCenter = computeBlindHoleCenter(position, direction, safeDepth);
+        // For screw with head: the geometry is centered at (height + headHeight)/2,
+        // so the entry (-totalLength/2) must map to position.  Adjust holeCenter
+        // by direction * headHeight/2 to compensate.
+        if (params.holeType === 'screw' && params.screwHead !== 'none') {
+            const spec = getScrewSpec(params.screwSystem, params.screwSpecIdx);
+            const headHeight = spec.dia;
+            holeCenter.add(direction.clone().normalize().multiplyScalar(headHeight / 2));
+        }
+    }
+    // 5. Build hole geometry (Z-up, centered on origin)
+    const holeGeo = buildHoleGeometry(params, holeHeight);
+    // 6. Position hole geometry to world space
+    const holeGeoWorld = positionHoleGeometry(holeGeo, direction, holeCenter);
+    // 7. Clone source geometry and transform to world space
+    const targetGeo = sourceGeometry.clone();
+    targetGeo.applyMatrix4(worldMatrix);
+    // 8. Convert to ManifoldMeshData
+    const targetManifold = geoToManifoldMesh(targetGeo);
+    const holeManifold = geoToManifoldMesh(holeGeoWorld);
+    // 9. Execute CSG subtract
+    const result = await computeBoolean([targetManifold, holeManifold], 'subtract');
+    // 10. Convert back to BufferGeometry
+    const resultGeo = manifoldMeshToGeo(result);
+    // 11. Transform back to mesh local space
+    const invMatrix = new THREE.Matrix4().copy(worldMatrix).invert();
+    resultGeo.applyMatrix4(invMatrix);
+    // Derive creased normals on the committed result so sharp edges stay sharp
+    // (the old computeVertexNormals() averaged on the welded shared-vertex
+    // topology and rounded them off). toCreasedNormals transforms correctly with
+    // applyMatrix4 above, but we re-derive to guarantee the final geometry uses
+    // the unified creased-normal logic regardless of the manifold output topology.
+    const finalGeo = deriveNormals(resultGeo);
+    resultGeo.dispose();
+    // 12. Cleanup
+    holeGeo.dispose();
+    holeGeoWorld.dispose();
+    targetGeo.dispose();
+    return finalGeo;
+}
+//# sourceMappingURL=DrillHoleCore.js.map

package/dist/mesh/drill-hole/DrillHoleCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrillHoleCore.js","sourceRoot":"","sources":["../../../src/mesh/drill-hole/DrillHoleCore.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\nimport { makeScrew } from '../../primitives/screw/screw'\nimport { getScrewSpec } from '../../primitives/screw/screw-db'\nimport {\n  computeBoolean,\n  geoToManifoldMesh,\n  manifoldMeshToGeo,\n} from '../../boolean/csg-backend'\nimport { deriveNormals } from '../../boolean/deriveNormals'\nimport type { ManifoldMeshData } from '../../boolean/csg-backend'\nimport type { DrillDirection, DrillHoleParams } from './drill-types'\n\n/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */\nconst ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2)\n\n/**\n * Build a Z-up hole geometry centered on the origin, with the axial direction\n * along Z.\n *\n * - simple: CylinderGeometry rotated to Z-up\n * - screw: makeScrew() already returns Z-up\n *\n * Tolerance is applied as a radial expansion (tolerance/2 on radius).\n *\n * @param params - drill-hole parameters (type, diameter, screw details, tolerance).\n * @param height - axial length of the hole in millimeters.\n * @returns the hole geometry as a Z-up BufferGeometry.\n */\nexport function buildHoleGeometry(\n  params: DrillHoleParams,\n  height: number,\n): THREE.BufferGeometry {\n  const toleranceRadius = params.tolerance / 2\n\n  // ── simple: CylinderGeometry → rotate to Z-up ──\n  if (params.holeType === 'simple') {\n    const r = params.diameter / 2 + toleranceRadius\n    const geo = new THREE.CylinderGeometry(r, r, height, 32)\n    geo.applyMatrix4(ROT_Y_TO_Z)\n    return geo\n  }\n\n  // ── screw: makeScrew() already returns Z-up ──\n  if (params.holeType === 'screw') {\n    const geo = makeScrew({\n      system: params.screwSystem,\n      specIdx: params.screwSpecIdx,\n      thread: params.screwThread,\n      pitchCustom: 0,\n      length: height,\n      head: params.screwHead,\n      nRad: 32,\n    })\n\n    // Center the screw on origin. makeScrew extends from Z=0 to Z=height\n    // for the body, plus headHeight = spec.dia for the head (if present).\n    // The total length = height + headHeight, so center by half that.\n    const spec = getScrewSpec(params.screwSystem, params.screwSpecIdx)\n    const headHeight = params.screwHead !== 'none' ? spec.dia : 0\n    const totalLength = height + headHeight\n    geo.translate(0, 0, -totalLength / 2)\n\n    // For screw with head: makeScrew places the head at the +Z end (top of\n    // the screw), but for a drill hole the head must be at the -Z end — the\n    // entry point at the surface. Reflect Z to put the head at the entry side,\n    // and reverse triangle winding to maintain correct normals.\n    if (params.screwHead !== 'none') {\n      const pos = geo.getAttribute('position')\n      for (let i = 0; i < pos.count; i++) {\n        pos.setZ(i, -pos.getZ(i))\n      }\n      pos.needsUpdate = true\n\n      // Fix winding order: reflection flips triangle orientation\n      const idx = geo.index!\n      const arr = idx.array as Uint16Array | Uint32Array\n      for (let i = 0; i < arr.length; i += 3) {\n        const tmp = arr[i + 1]\n        arr[i + 1] = arr[i + 2]\n        arr[i + 2] = tmp\n      }\n      idx.needsUpdate = true\n    }\n\n    // Apply tolerance: scale radially (X and Y in Z-up space)\n    const baseRadius = spec.dia / 2\n    if (toleranceRadius > 0 && baseRadius > 0) {\n      const scale = 1 + toleranceRadius / baseRadius\n      geo.scale(scale, scale, 1)\n    }\n    return geo\n  }\n\n  // Fallback (should not reach)\n  const geo = new THREE.CylinderGeometry(params.diameter / 2, params.diameter / 2, height, 32)\n  geo.applyMatrix4(ROT_Y_TO_Z)\n  return geo\n}\n\n/**\n * Compute the through-hole height by raycasting against the target mesh's\n * bounding box. Returns { height, center } so the cylinder exactly spans the\n * model thickness along the drill direction, without extending outside.\n *\n * @param position - world-space position of the hole entry point.\n * @param direction - the drill direction (normalized internally).\n * @param bbox - world-space bounding box of the target mesh.\n * @returns the height and world-space center of the through hole.\n */\nexport function computeThroughHoleDimensions(\n  position: THREE.Vector3,\n  direction: THREE.Vector3,\n  bbox: THREE.Box3,\n): { height: number; center: THREE.Vector3 } {\n  const dir = direction.clone().normalize()\n\n  // Manual slab-method intersection: compute distances along dir to bbox entry/exit.\n  // This handles edge cases where position is exactly on the bbox boundary\n  // (Ray.intersectBox returns null in those cases).\n  const p = position\n  const d = dir\n  let tNear = -Infinity\n  let tFar = Infinity\n\n  // X slab\n  if (Math.abs(d.x) > 1e-12) {\n    const t1 = (bbox.min.x - p.x) / d.x\n    const t2 = (bbox.max.x - p.x) / d.x\n    tNear = Math.max(tNear, Math.min(t1, t2))\n    tFar = Math.min(tFar, Math.max(t1, t2))\n  } else if (p.x < bbox.min.x || p.x > bbox.max.x) {\n    // Parallel to X slab and outside — no intersection\n    return { height: 0, center: position.clone() }\n  }\n\n  // Y slab\n  if (Math.abs(d.y) > 1e-12) {\n    const t1 = (bbox.min.y - p.y) / d.y\n    const t2 = (bbox.max.y - p.y) / d.y\n    tNear = Math.max(tNear, Math.min(t1, t2))\n    tFar = Math.min(tFar, Math.max(t1, t2))\n  } else if (p.y < bbox.min.y || p.y > bbox.max.y) {\n    return { height: 0, center: position.clone() }\n  }\n\n  // Z slab\n  if (Math.abs(d.z) > 1e-12) {\n    const t1 = (bbox.min.z - p.z) / d.z\n    const t2 = (bbox.max.z - p.z) / d.z\n    tNear = Math.max(tNear, Math.min(t1, t2))\n    tFar = Math.min(tFar, Math.max(t1, t2))\n  } else if (p.z < bbox.min.z || p.z > bbox.max.z) {\n    return { height: 0, center: position.clone() }\n  }\n\n  // Clamp: if position is inside or on boundary, tNear <= 0 <= tFar\n  // Forward distance = tFar (exit point along +dir)\n  // Backward distance = -tNear (exit point along -dir, i.e. behind us)\n  const forwardDist = tFar > 0 ? tFar : 0\n  const backwardDist = tNear < 0 ? -tNear : 0\n\n  const height = forwardDist + backwardDist\n  const center = position.clone()\n    .add(dir.clone().multiplyScalar((forwardDist - backwardDist) / 2))\n\n  return { height, center }\n}\n\n/**\n * Compute the blind-hole center: the hole entry is at the click point,\n * the hole extends inward by `depth`. The cylinder center is at\n * position + direction * (depth / 2).\n *\n * @param position - world-space hole entry point.\n * @param direction - the drill direction (normalized internally).\n * @param depth - blind-hole depth in millimeters.\n * @returns the world-space cylinder center.\n */\nexport function computeBlindHoleCenter(\n  position: THREE.Vector3,\n  direction: THREE.Vector3,\n  depth: number,\n): THREE.Vector3 {\n  return position.clone().add(direction.clone().normalize().multiplyScalar(depth / 2))\n}\n\n/**\n * Orient and position a Z-up hole geometry (axial along Z) to world space.\n * Returns a new geometry with the transform baked in.\n *\n * @param geo - Z-up hole geometry centered on the origin.\n * @param direction - world-space axis the hole should point along.\n * @param center - world-space position of the hole center.\n * @returns a transformed clone of the input geometry.\n */\nexport function positionHoleGeometry(\n  geo: THREE.BufferGeometry,\n  direction: THREE.Vector3,\n  center: THREE.Vector3,\n): THREE.BufferGeometry {\n  const result = geo.clone()\n  // Rotate Z axis to direction\n  const quat = new THREE.Quaternion().setFromUnitVectors(\n    new THREE.Vector3(0, 0, 1),\n    direction.clone().normalize(),\n  )\n  result.applyQuaternion(quat)\n  // Translate to center\n  result.translate(center.x, center.y, center.z)\n  return result\n}\n\n/**\n * Resolve the drill direction based on params.direction and the face normal.\n *\n * - 'normal': inward direction = negated face normal\n * - 'x'/'y'/'z': axis-aligned, flipped to point INTO the material\n *   (i.e. opposite to the face normal)\n *\n * @param direction - requested drill-direction reference.\n * @param faceNormal - face normal at the drill position.\n * @returns the resolved unit drill direction.\n */\nexport function resolveDrillDirection(\n  direction: DrillDirection,\n  faceNormal: THREE.Vector3,\n): THREE.Vector3 {\n  if (direction === 'normal') {\n    return faceNormal.clone().negate().normalize()\n  }\n\n  // Axis-aligned direction\n  const axisDir = new THREE.Vector3(\n    direction === 'x' ? 1 : 0,\n    direction === 'y' ? 1 : 0,\n    direction === 'z' ? 1 : 0,\n  )\n\n  // Flip to point INTO the material (opposite to face normal)\n  if (axisDir.dot(faceNormal) > 0) {\n    axisDir.negate()\n  }\n  return axisDir\n}\n\n/**\n * Drill a hole into a THREE.Mesh in world space, returning the resulting\n * geometry in the mesh's local space.\n *\n * @param targetMesh - the mesh to drill into.\n * @param params - drill-hole parameters.\n * @param position - world-space hole entry point.\n * @param faceNormal - world-space normal of the face at the entry point.\n * @returns the drilled geometry in mesh-local space.\n */\nexport async function executeDrillHole(\n  targetMesh: THREE.Mesh,\n  params: DrillHoleParams,\n  position: THREE.Vector3,\n  faceNormal: THREE.Vector3,\n): Promise<THREE.BufferGeometry> {\n  targetMesh.updateMatrixWorld()\n  return executeDrillHoleOnGeometry(\n    targetMesh.geometry,\n    targetMesh.matrixWorld,\n    params,\n    position,\n    faceNormal,\n  )\n}\n\n/**\n * Core drill computation that accepts geometry + world matrix directly.\n *\n * This avoids the need to temporarily swap mesh.geometry when the mesh\n * currently has a preview geometry on it. Callers that have the G0 geometry\n * in a separate BufferGeometry can use this directly.\n *\n * @param sourceGeometry - the base geometry to drill (mesh-local space).\n * @param worldMatrix - world transform of the source geometry.\n * @param params - drill-hole parameters.\n * @param position - world-space hole entry point.\n * @param faceNormal - world-space face normal at the entry point.\n * @returns the drilled geometry, transformed back into mesh-local space.\n */\nexport async function executeDrillHoleOnGeometry(\n  sourceGeometry: THREE.BufferGeometry,\n  worldMatrix: THREE.Matrix4,\n  params: DrillHoleParams,\n  position: THREE.Vector3,\n  faceNormal: THREE.Vector3,\n): Promise<THREE.BufferGeometry> {\n  // 1. Compute drill direction based on params.direction\n  const direction = resolveDrillDirection(params.direction, faceNormal)\n\n  // 2. Compute bbox from the source geometry (in world space)\n  sourceGeometry.computeBoundingBox()\n  const bbox = sourceGeometry.boundingBox!.clone()\n  bbox.applyMatrix4(worldMatrix)\n  const bboxSize = bbox.getSize(new THREE.Vector3())\n  const bboxMax = Math.max(bboxSize.x, bboxSize.y, bboxSize.z)\n\n  // 3. Clamp depth to valid range: [0, bboxMax]\n  const safeDepth = Math.max(0, Math.min(params.depth, bboxMax))\n\n  // 4. Compute hole height and center\n  let holeHeight: number\n  let holeCenter: THREE.Vector3\n\n  if (safeDepth === 0) {\n    // Through hole: clip to bbox\n    const dims = computeThroughHoleDimensions(position, direction, bbox)\n    // Add epsilon on both ends for clean CSG cut\n    holeHeight = dims.height + 0.2 // 0.1mm each side\n    holeCenter = dims.center\n  } else {\n    // Blind hole\n    holeHeight = safeDepth\n    holeCenter = computeBlindHoleCenter(position, direction, safeDepth)\n\n    // For screw with head: the geometry is centered at (height + headHeight)/2,\n    // so the entry (-totalLength/2) must map to position.  Adjust holeCenter\n    // by direction * headHeight/2 to compensate.\n    if (params.holeType === 'screw' && params.screwHead !== 'none') {\n      const spec = getScrewSpec(params.screwSystem, params.screwSpecIdx)\n      const headHeight = spec.dia\n      holeCenter.add(direction.clone().normalize().multiplyScalar(headHeight / 2))\n    }\n  }\n\n  // 5. Build hole geometry (Z-up, centered on origin)\n  const holeGeo = buildHoleGeometry(params, holeHeight)\n\n  // 6. Position hole geometry to world space\n  const holeGeoWorld = positionHoleGeometry(holeGeo, direction, holeCenter)\n\n  // 7. Clone source geometry and transform to world space\n  const targetGeo = sourceGeometry.clone()\n  targetGeo.applyMatrix4(worldMatrix)\n\n  // 8. Convert to ManifoldMeshData\n  const targetManifold: ManifoldMeshData = geoToManifoldMesh(targetGeo)\n  const holeManifold: ManifoldMeshData = geoToManifoldMesh(holeGeoWorld)\n\n  // 9. Execute CSG subtract\n  const result = await computeBoolean([targetManifold, holeManifold], 'subtract')\n\n  // 10. Convert back to BufferGeometry\n  const resultGeo = manifoldMeshToGeo(result)\n\n  // 11. Transform back to mesh local space\n  const invMatrix = new THREE.Matrix4().copy(worldMatrix).invert()\n  resultGeo.applyMatrix4(invMatrix)\n\n  // Derive creased normals on the committed result so sharp edges stay sharp\n  // (the old computeVertexNormals() averaged on the welded shared-vertex\n  // topology and rounded them off). toCreasedNormals transforms correctly with\n  // applyMatrix4 above, but we re-derive to guarantee the final geometry uses\n  // the unified creased-normal logic regardless of the manifold output topology.\n  const finalGeo = deriveNormals(resultGeo)\n  resultGeo.dispose()\n\n  // 12. Cleanup\n  holeGeo.dispose()\n  holeGeoWorld.dispose()\n  targetGeo.dispose()\n\n  return finalGeo\n}\n"]}

package/dist/mesh/drill-hole/drill-types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * drill-types — 钻孔相关类型定义
+ *
+ * 从 stores/drill-store.ts 提取的纯类型，供 DrillHoleCore 使用。
+ */
+export type DrillHoleType = 'simple' | 'screw';
+/** Reference axis for the drill direction: along the face normal or an axis-aligned direction. */
+export type DrillDirection = 'normal' | 'x' | 'y' | 'z';
+/** Thread standard used to dimension screw holes: metric or imperial. */
+export type ScrewSystem = 'metric' | 'imperial';
+/** Thread pitch variant for a screw hole. */
+export type ScrewThread = 'coarse' | 'fine' | 'none';
+/** Head (countersink) style for a screw hole. */
+export type ScrewHead = 'none' | 'hex' | 'chc';
+/**
+ * Full parameter set describing a drill-hole operation, including the hole
+ * type (simple or screw), geometry, depth, direction, tolerance, and the
+ * screw-specific fields used by the screw variant.
+ */
+export interface DrillHoleParams {
+    diameter: number;
+    depth: number;
+    holeType: DrillHoleType;
+    direction: DrillDirection;
+    tolerance: number;
+    snapEnabled: boolean;
+    screwSystem: ScrewSystem;
+    screwSpecIdx: number;
+    screwThread: ScrewThread;
+    screwPitchCustom: number;
+    screwLength: number;
+    screwHead: ScrewHead;
+}
+//# sourceMappingURL=drill-types.d.ts.map

package/dist/mesh/drill-hole/drill-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drill-types.d.ts","sourceRoot":"","sources":["../../../src/mesh/drill-hole/drill-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAA;AAC9C,kGAAkG;AAClG,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;AAEvD,yEAAyE;AACzE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAA;AAE/C,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,iDAAiD;AACjD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;AAE9C;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,aAAa,CAAA;IACvB,SAAS,EAAE,cAAc,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,EAAE,WAAW,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,WAAW,CAAA;IACxB,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,SAAS,CAAA;CACrB"}

package/dist/mesh/drill-hole/drill-types.js

@@ -0,0 +1,7 @@
+/**
+ * drill-types — 钻孔相关类型定义
+ *
+ * 从 stores/drill-store.ts 提取的纯类型，供 DrillHoleCore 使用。
+ */
+export {};
+//# sourceMappingURL=drill-types.js.map

package/dist/mesh/drill-hole/drill-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drill-types.js","sourceRoot":"","sources":["../../../src/mesh/drill-hole/drill-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG","sourcesContent":["/**\n * drill-types — 钻孔相关类型定义\n *\n * 从 stores/drill-store.ts 提取的纯类型，供 DrillHoleCore 使用。\n */\n\nexport type DrillHoleType = 'simple' | 'screw'\n/** Reference axis for the drill direction: along the face normal or an axis-aligned direction. */\nexport type DrillDirection = 'normal' | 'x' | 'y' | 'z'\n\n/** Thread standard used to dimension screw holes: metric or imperial. */\nexport type ScrewSystem = 'metric' | 'imperial'\n\n/** Thread pitch variant for a screw hole. */\nexport type ScrewThread = 'coarse' | 'fine' | 'none'\n\n/** Head (countersink) style for a screw hole. */\nexport type ScrewHead = 'none' | 'hex' | 'chc'\n\n/**\n * Full parameter set describing a drill-hole operation, including the hole\n * type (simple or screw), geometry, depth, direction, tolerance, and the\n * screw-specific fields used by the screw variant.\n */\nexport interface DrillHoleParams {\n  diameter: number\n  depth: number\n  holeType: DrillHoleType\n  direction: DrillDirection\n  tolerance: number\n  snapEnabled: boolean\n  screwSystem: ScrewSystem\n  screwSpecIdx: number\n  screwThread: ScrewThread\n  screwPitchCustom: number\n  screwLength: number\n  screwHead: ScrewHead\n}\n"]}

package/dist/mesh/engrave.d.ts

@@ -0,0 +1,36 @@
+/**
+ * mesh 雕刻 API
+ *
+ * 提取来源：engine/components/engraving/EngravingCore.ts
+ *
+ * 从 executeEngraving 中提取纯几何计算部分：
+ * 1. 生成装饰几何（文字或 SVG）
+ * 2. 定位到面
+ * 3. 布尔运算（凸=union，凹=subtract）
+ *
+ * 不包含：store 读写、commitGeometry、undo snapshot、toast。
+ * 这些由执行器负责（P1 不改变现有执行器行为）。
+ */
+import type { Shape, EngraveParams, KnurlParams } from './types.js';
+/**
+ * Execute an engraving: generate the decoration geometry (text or SVG),
+ * position it onto a face, then run a boolean union (convex) or subtract
+ * (concave).
+ *
+ * @param shape - the world-space target shape.
+ * @param params - engrave parameters (text/svg, depth, face, mode).
+ * @returns the engraved shape in world space.
+ */
+export declare function engrave(shape: Shape, params: EngraveParams): Promise<Shape>;
+/**
+ * Apply a knurling texture displacement to a shape (vertex displacement, not a
+ * boolean op). The replay path approximates UI face selection by excluding
+ * faces whose normal deviates from the given face normal; the angle limits act
+ * as an angular mask.
+ *
+ * @param shape - the world-space shape to knurl.
+ * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).
+ * @returns the displaced shape in world space.
+ */
+export declare function knurl(shape: Shape, params: KnurlParams): Promise<Shape>;
+//# sourceMappingURL=engrave.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engrave.d.ts","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEhE;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CA0EjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA8E7E"}

package/dist/mesh/engrave.js

@@ -0,0 +1,154 @@
+/**
+ * mesh 雕刻 API
+ *
+ * 提取来源：engine/components/engraving/EngravingCore.ts
+ *
+ * 从 executeEngraving 中提取纯几何计算部分：
+ * 1. 生成装饰几何（文字或 SVG）
+ * 2. 定位到面
+ * 3. 布尔运算（凸=union，凹=subtract）
+ *
+ * 不包含：store 读写、commitGeometry、undo snapshot、toast。
+ * 这些由执行器负责（P1 不改变现有执行器行为）。
+ */
+import * as THREE from 'three';
+import { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend.js';
+import { svgToExtrudedGeometry } from '../primitives/svg-extrude.js';
+/**
+ * Execute an engraving: generate the decoration geometry (text or SVG),
+ * position it onto a face, then run a boolean union (convex) or subtract
+ * (concave).
+ *
+ * @param shape - the world-space target shape.
+ * @param params - engrave parameters (text/svg, depth, face, mode).
+ * @returns the engraved shape in world space.
+ */
+export async function engrave(shape, params) {
+    // 1. 生成装饰几何（局部空间，+Z = 挤出方向）
+    let decorationGeo;
+    if (params.text) {
+        if (!params.text)
+            throw new Error('Text is empty');
+        const { getOpentypeFont, createTextGeometry } = await import('../primitives/text-geometry.js');
+        const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import('../primitives/text/cjk.js');
+        const font = await getOpentypeFont();
+        if (containsCjk(params.text)) {
+            const cjkFont = await loadSystemCjkFont();
+            if (cjkFont) {
+                decorationGeo = await createMixedTextGeometry(params.text, params.textSize ?? 10, params.depth, cjkFont.font, font);
+            }
+            else {
+                decorationGeo = await createTextGeometry(params.text, params.textSize ?? 10, params.depth, font);
+            }
+        }
+        else {
+            decorationGeo = await createTextGeometry(params.text, params.textSize ?? 10, params.depth, font);
+        }
+    }
+    else if (params.svg) {
+        // logo / SVG
+        decorationGeo = svgToExtrudedGeometry(params.svg, {
+            depth: params.depth,
+            targetLongSide: params.svgSize,
+            naturalWidth: params.svgNaturalWidth ?? 0,
+            naturalHeight: params.svgNaturalHeight ?? 0,
+        });
+    }
+    else {
+        throw new Error('engrave requires either text or svg');
+    }
+    // 2. 定位装饰几何到面
+    const faceCenter = new THREE.Vector3(...params.face.center);
+    const faceNormal = new THREE.Vector3(...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);
+    // Rotate +Z to align with face normal
+    const quat = new THREE.Quaternion().setFromUnitVectors(new THREE.Vector3(0, 0, 1), faceNormal);
+    decorationGeo.applyQuaternion(quat);
+    // 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);
+    // 3. 转换为 ManifoldMeshData
+    const decorationData = geoToManifoldMesh(decorationGeo);
+    // 4. 布尔运算
+    const op = params.mode === 'convex' ? 'union' : 'subtract';
+    const result = await computeBoolean([shape, decorationData], op);
+    // 5. 清理
+    decorationGeo.dispose();
+    return result;
+}
+/**
+ * Apply a knurling texture displacement to a shape (vertex displacement, not a
+ * boolean op). The replay path approximates UI face selection by excluding
+ * faces whose normal deviates from the given face normal; the angle limits act
+ * as an angular mask.
+ *
+ * @param shape - the world-space shape to knurl.
+ * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).
+ * @returns the displaced shape in world space.
+ */
+export async function knurl(shape, params) {
+    const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import('./knurl/KnurlGenerator.js');
+    // 1. Shape → THREE.BufferGeometry
+    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 = 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();
+    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;
+        const i2 = indices ? indices[t * 3 + 2] : t * 3 + 2;
+        v0.set(positions[i0 * 3], positions[i0 * 3 + 1], positions[i0 * 3 + 2]);
+        v1.set(positions[i1 * 3], positions[i1 * 3 + 1], positions[i1 * 3 + 2]);
+        v2.set(positions[i2 * 3], positions[i2 * 3 + 1], positions[i2 * 3 + 2]);
+        edge1.subVectors(v1, v0);
+        edge2.subVectors(v2, v0);
+        triNormal.crossVectors(edge1, edge2).normalize();
+        // 法向相似度：dot > 0.5 (~60° within) → 不排除
+        const dot = triNormal.dot(faceNormal);
+        if (dot < 0.5) {
+            faceWeights[t * 3] = 1.0;
+            faceWeights[t * 3 + 1] = 1.0;
+            faceWeights[t * 3 + 2] = 1.0;
+        }
+    }
+    // 3. 计算包围盒
+    geo.computeBoundingBox();
+    const bb = geo.boundingBox;
+    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),
+    };
+    // 4. 调用 applyKnurlDisplacement
+    const resultGeo = await applyKnurlDisplacement(geo, {
+        ...KNURL_DEFAULTS,
+        textureHeight: params.knurlTextureHeight,
+        invertDisplacement: params.knurlInvertDisplacement,
+        refineLength: params.knurlRefineLength,
+        scaleU: params.knurlScaleU,
+        scaleV: params.knurlScaleV,
+        mappingMode: params.knurlMappingMode,
+        faceWeights,
+    }, undefined, partBounds);
+    geo.dispose();
+    // 5. THREE.BufferGeometry → Shape
+    return geoToManifoldMesh(resultGeo);
+}
+//# sourceMappingURL=engrave.js.map

package/dist/mesh/engrave.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engrave.js","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"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","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 { svgToExtrudedGeometry } from '../primitives/svg-extrude'\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 * @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  let decorationGeo: THREE.BufferGeometry\n\n  if (params.text) {\n    if (!params.text) throw new Error('Text is empty')\n    const { getOpentypeFont, createTextGeometry } = await import(\n      '../primitives/text-geometry'\n    )\n    const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import(\n      '../primitives/text/cjk'\n    )\n    const font = await getOpentypeFont()\n    if (containsCjk(params.text)) {\n      const cjkFont = await loadSystemCjkFont()\n      if (cjkFont) {\n        decorationGeo = await createMixedTextGeometry(\n          params.text, params.textSize ?? 10, params.depth, cjkFont.font, font,\n        )\n      } else {\n        decorationGeo = await createTextGeometry(\n          params.text, params.textSize ?? 10, params.depth, font,\n        )\n      }\n    } else {\n      decorationGeo = await createTextGeometry(\n        params.text, params.textSize ?? 10, params.depth, font,\n      )\n    }\n  } else if (params.svg) {\n    // logo / SVG\n    decorationGeo = svgToExtrudedGeometry(params.svg, {\n      depth: params.depth,\n      targetLongSide: params.svgSize,\n      naturalWidth: params.svgNaturalWidth ?? 0,\n      naturalHeight: params.svgNaturalHeight ?? 0,\n    })\n  } else {\n    throw new Error('engrave requires either text or svg')\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"]}

package/dist/mesh/fai_drill.d.ts

@@ -0,0 +1,21 @@
+/**
+ * mesh 钻孔 API
+ *
+ * 提取来源：
+ * - engine/components/drill-hole/DrillHoleCore.ts (executeDrillHoleOnGeometry)
+ * - engine/version-store/executors/DrillCommandExecutor.ts (executeDrillOnGeometryData)
+ *
+ * DrillCommandExecutor 已是最纯的入口（typed arrays 输入输出），
+ * mesh 直接复用其几何计算逻辑。
+ */
+import type { Shape, DrillParams } from './types.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 declare function drill(shape: Shape, params: DrillParams): Promise<Shape>;
+//# sourceMappingURL=fai_drill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fai_drill.d.ts","sourceRoot":"","sources":["../../src/mesh/fai_drill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEjD;;;;;;;GAOG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA+E7E"}