@faicad/faijs 0.33.2 → 0.35.2

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

@@ -0,0 +1,282 @@
+import { Vec3, Mat4, Quat, Box3 } from '../../../math3d/index.js';
+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';
+import { cylinderGeometry } from '../../../mesh/meshdata/parametric.js';
+import { transformShape, translateShape } from '../../../mesh/meshdata/ops.js';
+/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */
+const ROT_Y_TO_Z = new Mat4().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 Shape.
+ */
+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 = cylinderGeometry(r, r, height, 32);
+        return transformShape(geo, ROT_Y_TO_Z);
+    }
+    // ── screw: makeScrew() already returns Z-up ──
+    if (params.holeType === 'screw') {
+        let 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 = translateShape(geo, 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.positions;
+            for (let i = 2; i < pos.length; i += 3) {
+                pos[i] = -pos[i];
+            }
+            // Fix winding order: reflection flips triangle orientation
+            const arr = geo.indices;
+            for (let i = 0; i < arr.length; i += 3) {
+                const tmp = arr[i + 1];
+                arr[i + 1] = arr[i + 2];
+                arr[i + 2] = tmp;
+            }
+        }
+        // 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;
+            const scaleMatrix = new Mat4().makeScale(scale, scale, 1);
+            geo = transformShape(geo, scaleMatrix);
+        }
+        return geo;
+    }
+    // Fallback (should not reach)
+    const geo = cylinderGeometry(params.diameter / 2, params.diameter / 2, height, 32);
+    return transformShape(geo, ROT_Y_TO_Z);
+}
+/**
+ * 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) {
+    // Rotate Z axis to direction
+    const quat = new Quat().setFromUnitVectors(new Vec3(0, 0, 1), direction.clone().normalize());
+    const rotMatrix = new Mat4().makeRotationFromQuaternion(quat);
+    let result = transformShape(geo, rotMatrix);
+    // Translate to center
+    result = translateShape(result, 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 Vec3(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 mesh in world space, returning the resulting
+ * geometry in the mesh's local space.
+ *
+ * @param target - the target mesh-like object with geometry and world matrix.
+ * @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(target, params, position, faceNormal) {
+    return executeDrillHoleOnGeometry(target.geometry, target.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 Shape 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)
+    const bbox = new Box3();
+    const v = new Vec3();
+    for (let i = 0; i < sourceGeometry.positions.length; i += 3) {
+        v.set(sourceGeometry.positions[i], sourceGeometry.positions[i + 1], sourceGeometry.positions[i + 2]);
+        v.applyMatrix4(worldMatrix);
+        bbox.expandByPoint(v);
+    }
+    const bboxSize = bbox.getSize(new Vec3());
+    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. Transform source geometry to world space
+    const targetGeo = transformShape(sourceGeometry, 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 Shape
+    const resultGeo = manifoldMeshToGeo(result);
+    // 11. Transform back to mesh local space
+    const invMatrix = new Mat4().copy(worldMatrix).invert();
+    const transformedGeo = transformShape(resultGeo, 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(transformedGeo);
+    return finalGeo;
+}
+//# sourceMappingURL=DrillHoleCore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DrillHoleCore.js","sourceRoot":"","sources":["../../../../src/extra/mesh/drill-hole/DrillHoleCore.ts"],"names":[],"mappings":"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","sourcesContent":["import { Vec3, Mat4, Quat, Box3 } from '../../../math3d'\nimport type { Shape } from '../../../mesh/types'\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 { cylinderGeometry } from '../../../mesh/meshdata/parametric'\nimport { transformShape, translateShape } from '../../../mesh/meshdata/ops'\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 Mat4().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 Shape.\n */\nexport function buildHoleGeometry(\n  params: DrillHoleParams,\n  height: number,\n): Shape {\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 = cylinderGeometry(r, r, height, 32)\n    return transformShape(geo, ROT_Y_TO_Z)\n  }\n\n  // ── screw: makeScrew() already returns Z-up ──\n  if (params.holeType === 'screw') {\n    let geo: Shape = 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 = translateShape(geo, 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.positions\n      for (let i = 2; i < pos.length; i += 3) {\n        pos[i] = -pos[i]\n      }\n\n      // Fix winding order: reflection flips triangle orientation\n      const arr = geo.indices\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    }\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      const scaleMatrix = new Mat4().makeScale(scale, scale, 1)\n      geo = transformShape(geo, scaleMatrix)\n    }\n    return geo\n  }\n\n  // Fallback (should not reach)\n  const geo = cylinderGeometry(params.diameter / 2, params.diameter / 2, height, 32)\n  return transformShape(geo, ROT_Y_TO_Z)\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: Vec3,\n  direction: Vec3,\n  bbox: Box3,\n): { height: number; center: Vec3 } {\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: Vec3,\n  direction: Vec3,\n  depth: number,\n): Vec3 {\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: Shape,\n  direction: Vec3,\n  center: Vec3,\n): Shape {\n  // Rotate Z axis to direction\n  const quat = new Quat().setFromUnitVectors(\n    new Vec3(0, 0, 1),\n    direction.clone().normalize(),\n  )\n  const rotMatrix = new Mat4().makeRotationFromQuaternion(quat)\n  let result = transformShape(geo, rotMatrix)\n  // Translate to center\n  result = translateShape(result, 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: Vec3,\n): Vec3 {\n  if (direction === 'normal') {\n    return faceNormal.clone().negate().normalize()\n  }\n\n  // Axis-aligned direction\n  const axisDir = new Vec3(\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 mesh in world space, returning the resulting\n * geometry in the mesh's local space.\n *\n * @param target - the target mesh-like object with geometry and world matrix.\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  target: { geometry: Shape; matrixWorld: Mat4 },\n  params: DrillHoleParams,\n  position: Vec3,\n  faceNormal: Vec3,\n): Promise<Shape> {\n  return executeDrillHoleOnGeometry(\n    target.geometry,\n    target.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 Shape 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: Shape,\n  worldMatrix: Mat4,\n  params: DrillHoleParams,\n  position: Vec3,\n  faceNormal: Vec3,\n): Promise<Shape> {\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  const bbox = new Box3()\n  const v = new Vec3()\n  for (let i = 0; i < sourceGeometry.positions.length; i += 3) {\n    v.set(sourceGeometry.positions[i], sourceGeometry.positions[i + 1], sourceGeometry.positions[i + 2])\n    v.applyMatrix4(worldMatrix)\n    bbox.expandByPoint(v)\n  }\n  const bboxSize = bbox.getSize(new Vec3())\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: Vec3\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. Transform source geometry to world space\n  const targetGeo = transformShape(sourceGeometry, 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 Shape\n  const resultGeo = manifoldMeshToGeo(result)\n\n  // 11. Transform back to mesh local space\n  const invMatrix = new Mat4().copy(worldMatrix).invert()\n  const transformedGeo = transformShape(resultGeo, 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(transformedGeo)\n\n  return finalGeo\n}\n"]}

package/dist/extra/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/extra/mesh/drill-hole/drill-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drill-types.d.ts","sourceRoot":"","sources":["../../../../src/extra/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/extra/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/extra/mesh/drill-hole/drill-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drill-types.js","sourceRoot":"","sources":["../../../../src/extra/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/extra/mesh/engrave-decoration.d.ts

@@ -0,0 +1,42 @@
+/**
+ * engrave-decoration — the mesh decoration geometry for `cad.engrave`.
+ *
+ * Core's `mesh/engrave.ts` calls this directly (the old host-injection
+ * port `decoration-provider.ts` was deleted when faijs-extra was absorbed
+ * into core — the text/SVG geometry chain is now an internal implementation).
+ */
+import type { Shape } from '../../mesh/types.js';
+/** Decoration inputs `cad.engrave` passes to the provider. */
+export interface EngraveDecorationParams {
+    /** Text to engrave (mutually exclusive with `svg`). */
+    text?: string;
+    /** Text size in mm. */
+    textSize?: number;
+    /** SVG source text (mutually exclusive with `text`). */
+    svg?: string;
+    /** SVG long-side target size in mm. */
+    svgSize?: number;
+    /** SVG logical width, used for the scale factor. */
+    svgNaturalWidth?: number;
+    /** SVG logical height, used for the scale factor. */
+    svgNaturalHeight?: number;
+    /** Extrusion depth in mm. */
+    depth: number;
+}
+/**
+ * Produces the decoration geometry (local space, `+Z` = extrusion direction) for
+ * `cad.engrave`'s mesh path.
+ */
+export type EngraveDecorationProvider = (params: EngraveDecorationParams) => Promise<Shape>;
+/**
+ * Build the text/SVG decoration provider for `cad.engrave`'s mesh path.
+ *
+ * Semantics match the pre-split implementation inside core: the CJK branch uses
+ * the system CJK font when the Local Font Access API yields one, otherwise the
+ * registered default font (whose missing glyphs then raise the documented
+ * `[text-geometry] Character … not found in font` error).
+ *
+ * @returns the provider, ready to hand to `setEngraveDecorationProvider()`.
+ */
+export declare function createEngraveDecorationProvider(): EngraveDecorationProvider;
+//# sourceMappingURL=engrave-decoration.d.ts.map

package/dist/extra/mesh/engrave-decoration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engrave-decoration.d.ts","sourceRoot":"","sources":["../../../src/extra/mesh/engrave-decoration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAM7C,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,KAAK,CAAC,CAAA;AAEnB;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,IAAI,yBAAyB,CAuB3E"}

package/dist/extra/mesh/engrave-decoration.js

@@ -0,0 +1,39 @@
+import { containsCjk, loadSystemCjkFont } from '../../primitives/text/cjk-font.js';
+import { svgToExtrudedGeometry } from '../extras/svg-extrude.js';
+import { createTextGeometry, getOpentypeFont } from '../extras/text-geometry.js';
+import { createMixedTextGeometry } from '../extras/text-cjk.js';
+/**
+ * Build the text/SVG decoration provider for `cad.engrave`'s mesh path.
+ *
+ * Semantics match the pre-split implementation inside core: the CJK branch uses
+ * the system CJK font when the Local Font Access API yields one, otherwise the
+ * registered default font (whose missing glyphs then raise the documented
+ * `[text-geometry] Character … not found in font` error).
+ *
+ * @returns the provider, ready to hand to `setEngraveDecorationProvider()`.
+ */
+export function createEngraveDecorationProvider() {
+    return async (params) => {
+        if (params.text) {
+            const size = params.textSize ?? 10;
+            const font = await getOpentypeFont();
+            if (containsCjk(params.text)) {
+                const cjkFont = await loadSystemCjkFont();
+                if (cjkFont) {
+                    return createMixedTextGeometry(params.text, size, params.depth, cjkFont.font, font);
+                }
+            }
+            return createTextGeometry(params.text, size, params.depth, font);
+        }
+        if (params.svg) {
+            return svgToExtrudedGeometry(params.svg, {
+                depth: params.depth,
+                targetLongSide: params.svgSize,
+                naturalWidth: params.svgNaturalWidth ?? 0,
+                naturalHeight: params.svgNaturalHeight ?? 0,
+            });
+        }
+        throw new Error('[faijs-extra] engrave decoration requires either text or svg');
+    };
+}
+//# sourceMappingURL=engrave-decoration.js.map

package/dist/extra/mesh/engrave-decoration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engrave-decoration.js","sourceRoot":"","sources":["../../../src/extra/mesh/engrave-decoration.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AA4B5D;;;;;;;;;GASG;AACH,MAAM,UAAU,+BAA+B;IAC7C,OAAO,KAAK,EAAE,MAAM,EAAkB,EAAE;QACtC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA;YAClC,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAA;YACpC,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAA;gBACzC,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;gBACrF,CAAC;YACH,CAAC;YACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAClE,CAAC;QACD,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,OAAO,qBAAqB,CAAC,MAAM,CAAC,GAAG,EAAE;gBACvC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,cAAc,EAAE,MAAM,CAAC,OAAO;gBAC9B,YAAY,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;gBACzC,aAAa,EAAE,MAAM,CAAC,gBAAgB,IAAI,CAAC;aAC5C,CAAC,CAAA;QACJ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;IACjF,CAAC,CAAA;AACH,CAAC","sourcesContent":["/**\n * engrave-decoration — the mesh decoration geometry for `cad.engrave`.\n *\n * Core's `mesh/engrave.ts` calls this directly (the old host-injection\n * port `decoration-provider.ts` was deleted when faijs-extra was absorbed\n * into core — the text/SVG geometry chain is now an internal implementation).\n */\nimport type { Shape } from '../../mesh/types'\nimport { containsCjk, loadSystemCjkFont } from '../../primitives/text/cjk-font'\nimport { svgToExtrudedGeometry } from '../extras/svg-extrude'\nimport { createTextGeometry, getOpentypeFont } from '../extras/text-geometry'\nimport { createMixedTextGeometry } from '../extras/text-cjk'\n\n/** Decoration inputs `cad.engrave` passes to the provider. */\nexport interface EngraveDecorationParams {\n  /** Text to engrave (mutually exclusive with `svg`). */\n  text?: string\n  /** Text size in mm. */\n  textSize?: number\n  /** SVG source text (mutually exclusive with `text`). */\n  svg?: string\n  /** SVG long-side target size in mm. */\n  svgSize?: number\n  /** SVG logical width, used for the scale factor. */\n  svgNaturalWidth?: number\n  /** SVG logical height, used for the scale factor. */\n  svgNaturalHeight?: number\n  /** Extrusion depth in mm. */\n  depth: number\n}\n\n/**\n * Produces the decoration geometry (local space, `+Z` = extrusion direction) for\n * `cad.engrave`'s mesh path.\n */\nexport type EngraveDecorationProvider = (\n  params: EngraveDecorationParams,\n) => Promise<Shape>\n\n/**\n * Build the text/SVG decoration provider for `cad.engrave`'s mesh path.\n *\n * Semantics match the pre-split implementation inside core: the CJK branch uses\n * the system CJK font when the Local Font Access API yields one, otherwise the\n * registered default font (whose missing glyphs then raise the documented\n * `[text-geometry] Character … not found in font` error).\n *\n * @returns the provider, ready to hand to `setEngraveDecorationProvider()`.\n */\nexport function createEngraveDecorationProvider(): EngraveDecorationProvider {\n  return async (params): Promise<Shape> => {\n    if (params.text) {\n      const size = params.textSize ?? 10\n      const font = await getOpentypeFont()\n      if (containsCjk(params.text)) {\n        const cjkFont = await loadSystemCjkFont()\n        if (cjkFont) {\n          return createMixedTextGeometry(params.text, size, params.depth, cjkFont.font, font)\n        }\n      }\n      return createTextGeometry(params.text, size, params.depth, font)\n    }\n    if (params.svg) {\n      return svgToExtrudedGeometry(params.svg, {\n        depth: params.depth,\n        targetLongSide: params.svgSize,\n        naturalWidth: params.svgNaturalWidth ?? 0,\n        naturalHeight: params.svgNaturalHeight ?? 0,\n      })\n    }\n    throw new Error('[faijs-extra] engrave decoration requires either text or svg')\n  }\n}\n"]}

package/dist/extra/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 '../../mesh/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/extra/mesh/fai_drill.d.ts.map

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

package/dist/extra/mesh/fai_drill.js

@@ -0,0 +1,89 @@
+/**
+ * mesh 钻孔 API
+ *
+ * 提取来源：
+ * - engine/components/drill-hole/DrillHoleCore.ts (executeDrillHoleOnGeometry)
+ * - engine/version-store/executors/DrillCommandExecutor.ts (executeDrillOnGeometryData)
+ *
+ * DrillCommandExecutor 已是最纯的入口（typed arrays 输入输出），
+ * mesh 直接复用其几何计算逻辑。
+ */
+import { Vec3, Box3 } from '../../math3d/index.js';
+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 Vec3(...params.position);
+    const faceNormal = new Vec3(...params.faceNormal);
+    // 1. 计算钻孔方向：direction 是 Vec3，确保朝向材料内部
+    const direction = new Vec3(...params.direction).normalize();
+    if (direction.dot(faceNormal) > 0) {
+        direction.negate();
+    }
+    // 2. 从输入几何计算 bbox（世界空间）
+    const bbox = new Box3();
+    const posVec = new Vec3();
+    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 Vec3());
+    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');
+    return result;
+}
+//# sourceMappingURL=fai_drill.js.map

package/dist/extra/mesh/fai_drill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_drill.js","sourceRoot":"","sources":["../../../src/extra/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 { Vec3, Box3 } from '../../math3d'\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 '../../mesh/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 Vec3(...params.position)\n  const faceNormal = new Vec3(...params.faceNormal)\n\n  // 1. 计算钻孔方向：direction 是 Vec3，确保朝向材料内部\n  const direction = new Vec3(...params.direction).normalize()\n  if (direction.dot(faceNormal) > 0) {\n    direction.negate()\n  }\n\n  // 2. 从输入几何计算 bbox（世界空间）\n  const bbox = new Box3()\n  const posVec = new Vec3()\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 Vec3())\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: Vec3\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  return result\n}\n"]}

package/dist/extra/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 '../../mesh/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, planeDistance, 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