@faicad/faijs 0.18.2 → 0.19.0

package/dist/api/sketch-on-plane.js

@@ -0,0 +1,103 @@
+import { getBrepApi } from '../brep/handle-bridge.js';
+import { solidToShape } from '../brep/brep-ops.js';
+import { fromBrep, fromBrepCurve } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { Blueprint } from '../geometry2d/blueprint.js';
+import { CompoundBlueprint } from '../geometry2d/compound-blueprint.js';
+import { organiseBlueprints } from '../geometry2d/organise.js';
+import { namedPlane, makePlane, toVec3 } from '../geometry2d/bridge/plane.js';
+import { assembleWire } from '../geometry2d/bridge/lift-on-plane.js';
+import { profileSegToCurve } from '../geometry2d/adapt.js';
+import { assertProfileParams } from './profile.js';
+/**
+ * Resolve a `PlaneSpec` to a plane frame. A named plane wins over an explicit
+ * frame; with neither, the XY plane is used.
+ * @param planeSpec - the user-facing plane spec (named plane and/or explicit frame).
+ * @param fallbackOrigin - the origin used when `planeSpec.origin` is absent (default [0,0,0]).
+ * @returns the resolved plane frame.
+ */
+export function resolvePlane(planeSpec, fallbackOrigin = [0, 0, 0]) {
+    const o = planeSpec.origin ?? toVec3(fallbackOrigin);
+    if (planeSpec.name)
+        return namedPlane(planeSpec.name, o);
+    if (planeSpec.normal)
+        return makePlane(o, planeSpec.normal, planeSpec.xAxis);
+    return namedPlane('XY', o);
+}
+/**
+ * Build a 3D Shape (planar face, or outer-loop wire when `as:'wire'`) from a set
+ * of classified `Blueprint` contours on a plane. This is the shared placement
+ * core for every 2D profile source (`cad.profile` / `cad.draw` / sketch): it
+ * organises the closed contours (holes vs islands), assembles edge wires on the
+ * plane via the geometry2d bridge, and wraps them as a BREP face — ready to be
+ * extruded along the plane normal.
+ * @param kernel - the BREP engine surface.
+ * @param plane - the resolved target plane frame.
+ * @param blueprints - ordered closed contours as `Blueprint`s (draw output).
+ * @param as - `'face'` (default) or `'wire'` (outer loop only).
+ * @returns Shape on the target plane (face, or a wire curve when `as:'wire'`).
+ */
+export function buildShapeFromBlueprints(kernel, plane, blueprints, as = 'face') {
+    const organised = organiseBlueprints(blueprints);
+    if (as === 'wire') {
+        const outerBp = organised.blueprints[0] instanceof CompoundBlueprint
+            ? organised.blueprints[0].blueprints[0]
+            : organised.blueprints[0];
+        const wire = assembleWire(kernel, plane, outerBp);
+        return fromBrepCurve(solidToShape(kernel, wire), { solid: wire });
+    }
+    const faces = [];
+    for (const entry of organised.blueprints) {
+        if (entry instanceof CompoundBlueprint) {
+            let face = kernel.makeFace(assembleWire(kernel, plane, entry.blueprints[0]));
+            const holes = entry.blueprints.slice(1).map((h) => assembleWire(kernel, plane, h));
+            if (holes.length > 0) {
+                face = kernel.addHolesInFace(face, holes);
+            }
+            faces.push(face);
+        }
+        else {
+            faces.push(kernel.makeFace(assembleWire(kernel, plane, entry)));
+        }
+    }
+    if (faces.length === 1) {
+        const f = faces[0];
+        return fromBrep(solidToShape(kernel, f), { solid: f });
+    }
+    const compound = kernel.makeCompound(faces);
+    return fromBrep(solidToShape(kernel, compound), { solid: compound });
+}
+/**
+ * Build the 2D→3D placement: convert contour loops to a classified Blueprint
+ * set, assemble a wire on the plane, then wrap as a face (or the outer wire).
+ * @param kernel - the BREP engine surface.
+ * @param params - contour loops + plane + mode.
+ * @returns Shape on the target plane (face, or a wire curve when `as:'wire'`).
+ */
+export function buildSketchOnPlaneWith(kernel, params) {
+    const plane = resolvePlane(params.plane);
+    const blueprints = params.contours.map((loop) => new Blueprint(loop.segments.map((s) => profileSegToCurve(s))));
+    return buildShapeFromBlueprints(kernel, plane, blueprints, params.as ?? 'face');
+}
+/**
+ * `cad.sketchOnPlane`: place 2D contours on a plane and construct a Shape.
+ * @group 创建
+ * @inputs 0
+ * @async false
+ * @qual ok
+ * @name sketchOnPlane
+ * @returns Shape on the target plane (face, or a wire curve when `as:'wire'`).
+ * @param params.contours - ordered 2D contours (same shape as `cad.profile`).type:any[] required:true
+ * @param params.plane - named plane (`'XY'` / `'XZ'`…) or `{ origin, normal, xAxis }`.type:any required:true
+ * @param params.as - `'face'` (default) or `'wire'` (outer loop only).type:string required:false
+ */
+export const sketchOnPlane = defineOp({
+    capabilities: ['directEdit'],
+    engines: ['occt'],
+    brep(params) {
+        assertProfileParams(params);
+        return buildSketchOnPlaneWith(getBrepApi(), params);
+    },
+    naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } },
+});
+//# sourceMappingURL=sketch-on-plane.js.map

package/dist/api/sketch-on-plane.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketch-on-plane.js","sourceRoot":"","sources":["../../src/api/sketch-on-plane.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `cad.sketchOnPlane`: lift 2D contours onto an arbitrary plane (E2 placement).\n *\n * This is the shared \"placement\" step of the plan's unified 3D pipeline: any 2D\n * profile source (profile / draw / sketch) that describes contours as\n * `ProfileLoop`s can be placed here, then extruded along the plane normal. The\n * plane is a named plane (`'XY'` / `'XZ'` / `'top'` …) or an explicit frame\n * `{ origin, normal, xAxis }`. The plane lift runs on the occt platform surface\n * via the geometry2d bridge; the op declares `engines: ['occt']`.\n * @module\n */\nimport type { Shape } from '../mesh/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { solidToShape } from '../brep/brep-ops'\nimport { fromBrep, fromBrepCurve } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { Blueprint } from '../geometry2d/blueprint'\nimport { CompoundBlueprint } from '../geometry2d/compound-blueprint'\nimport { organiseBlueprints } from '../geometry2d/organise'\nimport { namedPlane, makePlane, toVec3, type Plane, type Vec3Input } from '../geometry2d/bridge/plane'\nimport { assembleWire } from '../geometry2d/bridge/lift-on-plane'\nimport { profileSegToCurve, type ProfileSegLike } from '../geometry2d/adapt'\nimport { assertProfileParams, type ProfileLoop } from './profile'\n\n/** A plane given by a named plane and/or an explicit frame (coords accept both array and `{x,y,z}`). */\nexport interface PlaneSpec {\n  /** Named plane (`'XY'` / `'XZ'` / `'YZ'` / `'front'` / `'back'` / `'left'` / …). */\n  name?: string\n  /** The plane origin (default [0,0,0]; array `[x,y,z]` or `{x,y,z}`). */\n  origin?: Vec3Input\n  /** Explicit normal (used with an explicit frame; array or `{x,y,z}`). */\n  normal?: Vec3Input\n  /** Explicit in-plane X axis (auto-derived when omitted; array or `{x,y,z}`). */\n  xAxis?: Vec3Input\n}\n\n/** Contour loops + a target plane (+ the result mode) for `cad.sketchOnPlane`. */\nexport interface SketchOnPlaneParams {\n  contours: ProfileLoop[]\n  /** Named plane or explicit `{ origin, normal, xAxis }` frame. */\n  plane: PlaneSpec\n  /** Result shape: 'face' (default) builds a planar face; 'wire' returns the outer-loop wire only. */\n  as?: 'face' | 'wire'\n}\n\n/**\n * Resolve a `PlaneSpec` to a plane frame. A named plane wins over an explicit\n * frame; with neither, the XY plane is used.\n * @param planeSpec - the user-facing plane spec (named plane and/or explicit frame).\n * @param fallbackOrigin - the origin used when `planeSpec.origin` is absent (default [0,0,0]).\n * @returns the resolved plane frame.\n */\nexport function resolvePlane(planeSpec: PlaneSpec, fallbackOrigin: Vec3Input = [0, 0, 0]): Plane {\n  const o = planeSpec.origin ?? toVec3(fallbackOrigin)\n  if (planeSpec.name) return namedPlane(planeSpec.name, o)\n  if (planeSpec.normal) return makePlane(o, planeSpec.normal, planeSpec.xAxis)\n  return namedPlane('XY', o)\n}\n\n/**\n * Build a 3D Shape (planar face, or outer-loop wire when `as:'wire'`) from a set\n * of classified `Blueprint` contours on a plane. This is the shared placement\n * core for every 2D profile source (`cad.profile` / `cad.draw` / sketch): it\n * organises the closed contours (holes vs islands), assembles edge wires on the\n * plane via the geometry2d bridge, and wraps them as a BREP face — ready to be\n * extruded along the plane normal.\n * @param kernel - the BREP engine surface.\n * @param plane - the resolved target plane frame.\n * @param blueprints - ordered closed contours as `Blueprint`s (draw output).\n * @param as - `'face'` (default) or `'wire'` (outer loop only).\n * @returns Shape on the target plane (face, or a wire curve when `as:'wire'`).\n */\nexport function buildShapeFromBlueprints(\n  kernel: BrepEngineApi,\n  plane: Plane,\n  blueprints: Blueprint[],\n  as: 'face' | 'wire' = 'face',\n): Shape {\n  const organised = organiseBlueprints(blueprints)\n\n  if (as === 'wire') {\n    const outerBp =\n      organised.blueprints[0] instanceof CompoundBlueprint\n        ? organised.blueprints[0].blueprints[0]!\n        : (organised.blueprints[0] as Blueprint)\n    const wire = assembleWire(kernel, plane, outerBp)\n    return fromBrepCurve(solidToShape(kernel, wire), { solid: wire })\n  }\n\n  const faces: ReturnType<BrepEngineApi['makeFace']>[] = []\n  for (const entry of organised.blueprints) {\n    if (entry instanceof CompoundBlueprint) {\n      let face = kernel.makeFace(assembleWire(kernel, plane, entry.blueprints[0]!))\n      const holes = entry.blueprints.slice(1).map((h) => assembleWire(kernel, plane, h) as never)\n      if (holes.length > 0) {\n        face = kernel.addHolesInFace(face, holes)\n      }\n      faces.push(face)\n    } else {\n      faces.push(kernel.makeFace(assembleWire(kernel, plane, entry)))\n    }\n  }\n\n  if (faces.length === 1) {\n    const f = faces[0]!\n    return fromBrep(solidToShape(kernel, f), { solid: f })\n  }\n  const compound = kernel.makeCompound(faces)\n  return fromBrep(solidToShape(kernel, compound), { solid: compound })\n}\n\n/**\n * Build the 2D→3D placement: convert contour loops to a classified Blueprint\n * set, assemble a wire on the plane, then wrap as a face (or the outer wire).\n * @param kernel - the BREP engine surface.\n * @param params - contour loops + plane + mode.\n * @returns Shape on the target plane (face, or a wire curve when `as:'wire'`).\n */\nexport function buildSketchOnPlaneWith(kernel: BrepEngineApi, params: SketchOnPlaneParams): Shape {\n  const plane = resolvePlane(params.plane)\n  const blueprints = params.contours.map(\n    (loop) => new Blueprint(loop.segments.map((s) => profileSegToCurve(s as ProfileSegLike))),\n  )\n  return buildShapeFromBlueprints(kernel, plane, blueprints, params.as ?? 'face')\n}\n\n/**\n * `cad.sketchOnPlane`: place 2D contours on a plane and construct a Shape.\n * @group 创建\n * @inputs 0\n * @async false\n * @qual ok\n * @name sketchOnPlane\n * @returns Shape on the target plane (face, or a wire curve when `as:'wire'`).\n * @param params.contours - ordered 2D contours (same shape as `cad.profile`).type:any[] required:true\n * @param params.plane - named plane (`'XY'` / `'XZ'`…) or `{ origin, normal, xAxis }`.type:any required:true\n * @param params.as - `'face'` (default) or `'wire'` (outer loop only).type:string required:false\n */\nexport const sketchOnPlane = defineOp({\n  capabilities: ['directEdit'],\n  engines: ['occt'],\n  brep(params: Record<string, unknown>) {\n    assertProfileParams(params)\n    return buildSketchOnPlaneWith(getBrepApi(), params as unknown as SketchOnPlaneParams)\n  },\n  naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } } as Provenance,\n})"]}

package/dist/boolean/csg-backend.d.ts

@@ -39,14 +39,14 @@ export declare function computeSplit(mesh: ManifoldMeshData, normal: [number, nu
  * Split a mesh by a plane and cut a dovetail groove via the current backend.
  * @param mesh                The mesh to split.
  * @param planeNormal         The cutting plane normal (unit vector).
- * @param planeOriginOffset   The cutting plane offset along the normal.
+ * @param planeDistance   The cutting plane offset along the normal.
  * @param planeCenter         A point on the cutting plane.
  * @param widthDir            The width direction within the cutting plane (unit vector).
  * @param bboxWidthOnWidthDir The model bounding-box width along the width direction.
  * @param groove              The dovetail groove parameters.
  * @returns The front/back halves plus the wedge mesh (or null when no wedge).
  */
-export declare function computeDovetailSplit(mesh: ManifoldMeshData, planeNormal: [number, number, number], planeOriginOffset: number, planeCenter: [number, number, number], widthDir: [number, number, number], bboxWidthOnWidthDir: number, groove: DovetailGrooveParams): Promise<{
+export declare function computeDovetailSplit(mesh: ManifoldMeshData, planeNormal: [number, number, number], planeDistance: number, planeCenter: [number, number, number], widthDir: [number, number, number], bboxWidthOnWidthDir: number, groove: DovetailGrooveParams): Promise<{
     front: ManifoldMeshData;
     back: ManifoldMeshData;
     wedge: ManifoldMeshData | null;
@@ -55,14 +55,14 @@ export declare function computeDovetailSplit(mesh: ManifoldMeshData, planeNormal
  * Split a mesh by a plane and cut dowel tenons via the current backend.
  * @param mesh                The mesh to split.
  * @param planeNormal         The cutting plane normal (unit vector).
- * @param planeOriginOffset   The cutting plane offset along the normal.
+ * @param planeDistance   The cutting plane offset along the normal.
  * @param planeCenter         A point on the cutting plane.
  * @param widthDir            The width direction within the cutting plane (unit vector).
  * @param dowel               The dowel split parameters.
  * @param selectedSections    Optional list of section indices to place tenons on.
  * @returns The front/back halves plus the wedge mesh (or null when no wedge).
  */
-export declare function computeDowelSplit(mesh: ManifoldMeshData, planeNormal: [number, number, number], planeOriginOffset: number, planeCenter: [number, number, number], widthDir: [number, number, number], dowel: DowelSplitParams, selectedSections?: number[] | null): Promise<{
+export declare function computeDowelSplit(mesh: ManifoldMeshData, planeNormal: [number, number, number], planeDistance: number, planeCenter: [number, number, number], widthDir: [number, number, number], dowel: DowelSplitParams, selectedSections?: number[] | null): Promise<{
     front: ManifoldMeshData;
     back: ManifoldMeshData;
     wedge: ManifoldMeshData | null;
@@ -71,14 +71,14 @@ export declare function computeDowelSplit(mesh: ManifoldMeshData, planeNormal: [
  * Split a mesh by a plane and cut straight tenons via the current backend.
  * @param mesh                The mesh to split.
  * @param planeNormal         The cutting plane normal (unit vector).
- * @param planeOriginOffset   The cutting plane offset along the normal.
+ * @param planeDistance   The cutting plane offset along the normal.
  * @param planeCenter         A point on the cutting plane.
  * @param widthDir            The width direction within the cutting plane (unit vector).
  * @param tenon               The straight-tenon split parameters.
  * @param selectedSections    Optional list of section indices to place tenons on.
  * @returns The front/back halves plus the wedge mesh (or null when no wedge).
  */
-export declare function computeStraightTenonSplit(mesh: ManifoldMeshData, planeNormal: [number, number, number], planeOriginOffset: number, planeCenter: [number, number, number], widthDir: [number, number, number], tenon: StraightTenonSplitParams, selectedSections?: number[] | null): Promise<{
+export declare function computeStraightTenonSplit(mesh: ManifoldMeshData, planeNormal: [number, number, number], planeDistance: number, planeCenter: [number, number, number], widthDir: [number, number, number], tenon: StraightTenonSplitParams, selectedSections?: number[] | null): Promise<{
     front: ManifoldMeshData;
     back: ManifoldMeshData;
     wedge: ManifoldMeshData | null;

package/dist/boolean/csg-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csg-backend.d.ts","sourceRoot":"","sources":["../../src/boolean/csg-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,eAAe,CAAA;AAMtB;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAEvD;AAgBD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,gBAAgB,EAAE,EAC1B,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC,CAI9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,mBAAmB,EAAE,MAAM,EAC3B,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,CAAC,CAW9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,KAAK,EAAE,gBAAgB,EACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GACjC,OAAO,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,CAAC,CAW9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,EACtB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,iBAAiB,EAAE,MAAM,EACzB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,KAAK,EAAE,wBAAwB,EAC/B,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GACjC,OAAO,CAAC;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAAE,CAAC,CAW9F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAID,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAIpE,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,eAAe,CAAA"}
+{"version":3,"file":"csg-backend.d.ts","sourceRoot":"","sources":["../../src/boolean/csg-backend.ts"],"names":[],"mappings":"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"}

package/dist/boolean/csg-backend.js

@@ -58,18 +58,18 @@ export async function computeSplit(mesh, normal, offset) {
  * Split a mesh by a plane and cut a dovetail groove via the current backend.
  * @param mesh                The mesh to split.
  * @param planeNormal         The cutting plane normal (unit vector).
- * @param planeOriginOffset   The cutting plane offset along the normal.
+ * @param planeDistance   The cutting plane offset along the normal.
  * @param planeCenter         A point on the cutting plane.
  * @param widthDir            The width direction within the cutting plane (unit vector).
  * @param bboxWidthOnWidthDir The model bounding-box width along the width direction.
  * @param groove              The dovetail groove parameters.
  * @returns The front/back halves plus the wedge mesh (or null when no wedge).
  */
-export async function computeDovetailSplit(mesh, planeNormal, planeOriginOffset, planeCenter, widthDir, bboxWidthOnWidthDir, groove) {
+export async function computeDovetailSplit(mesh, planeNormal, planeDistance, planeCenter, widthDir, bboxWidthOnWidthDir, groove) {
     const backend = await getBackend();
     const result = await backend.splitDovetail(mesh, {
         planeNormal,
-        planeOriginOffset,
+        planeDistance,
         planeCenter,
         widthDir,
         bboxWidthOnWidthDir,
@@ -81,18 +81,18 @@ export async function computeDovetailSplit(mesh, planeNormal, planeOriginOffset,
  * Split a mesh by a plane and cut dowel tenons via the current backend.
  * @param mesh                The mesh to split.
  * @param planeNormal         The cutting plane normal (unit vector).
- * @param planeOriginOffset   The cutting plane offset along the normal.
+ * @param planeDistance   The cutting plane offset along the normal.
  * @param planeCenter         A point on the cutting plane.
  * @param widthDir            The width direction within the cutting plane (unit vector).
  * @param dowel               The dowel split parameters.
  * @param selectedSections    Optional list of section indices to place tenons on.
  * @returns The front/back halves plus the wedge mesh (or null when no wedge).
  */
-export async function computeDowelSplit(mesh, planeNormal, planeOriginOffset, planeCenter, widthDir, dowel, selectedSections) {
+export async function computeDowelSplit(mesh, planeNormal, planeDistance, planeCenter, widthDir, dowel, selectedSections) {
     const backend = await getBackend();
     const result = await backend.splitDowel(mesh, {
         planeNormal,
-        planeOriginOffset,
+        planeDistance,
         planeCenter,
         widthDir,
         dowel,
@@ -104,18 +104,18 @@ export async function computeDowelSplit(mesh, planeNormal, planeOriginOffset, pl
  * Split a mesh by a plane and cut straight tenons via the current backend.
  * @param mesh                The mesh to split.
  * @param planeNormal         The cutting plane normal (unit vector).
- * @param planeOriginOffset   The cutting plane offset along the normal.
+ * @param planeDistance   The cutting plane offset along the normal.
  * @param planeCenter         A point on the cutting plane.
  * @param widthDir            The width direction within the cutting plane (unit vector).
  * @param tenon               The straight-tenon split parameters.
  * @param selectedSections    Optional list of section indices to place tenons on.
  * @returns The front/back halves plus the wedge mesh (or null when no wedge).
  */
-export async function computeStraightTenonSplit(mesh, planeNormal, planeOriginOffset, planeCenter, widthDir, tenon, selectedSections) {
+export async function computeStraightTenonSplit(mesh, planeNormal, planeDistance, planeCenter, widthDir, tenon, selectedSections) {
     const backend = await getBackend();
     const result = await backend.splitStraightTenon(mesh, {
         planeNormal,
-        planeOriginOffset,
+        planeDistance,
         planeCenter,
         widthDir,
         tenon,

package/dist/boolean/csg-backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"csg-backend.js","sourceRoot":"","sources":["../../src/boolean/csg-backend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * csg-backend — 可注入的 CSG 后端\n *\n * 提供 computeBoolean / computeSplit / computeDovetailSplit / computeDowelSplit / computeStraightTenonSplit\n * 等异步函数，与 csg.ts 的 API 一致。\n *\n * Node 环境：默认使用 InlineCsgBackend（主线程直跑 manifold-3d）。\n * 浏览器环境：通过 setCsgBackend() 注入 WorkerCsgBackend。\n *\n * F1 修复：不静态 import browser-host/inline-csg-backend（L1 不依赖 L3）。\n * 改为延迟动态 import，仅在未注入后端时按需加载。\n */\n\nimport type { CsgBackend } from '../cad-runtime/ports'\nimport type {\n  ManifoldMeshData,\n  BooleanOperation,\n  DovetailGrooveParams,\n  DowelSplitParams,\n  StraightTenonSplitParams,\n} from './geo-convert'\n\n// ── 后端实例管理 ──\n\nlet _backend: CsgBackend | null = null\n\n/**\n * Inject the CSG backend used by the browser host (e.g. WorkerCsgBackend).\n * @param backend The backend instance to install as the current CSG backend.\n */\nexport function setCsgBackend(backend: CsgBackend): void {\n  _backend = backend\n}\n\n/**\n * 获取当前 CSG 后端。\n * F1 修复：延迟动态 import InlineCsgBackend，避免 L1 静态依赖 L3。\n */\nasync function getBackend(): Promise<CsgBackend> {\n  if (_backend) return _backend\n  // 延迟加载——仅在实际需要时才拉入 L3 代码\n  const { InlineCsgBackend } = await import('../browser-host/inline-csg-backend')\n  _backend = new InlineCsgBackend()\n  return _backend\n}\n\n// ── CSG 操作 API（与 csg.ts 签名一致）──\n\n/**\n * Apply a boolean operation across several meshes via the current backend.\n * @param meshes    The input meshes to combine.\n * @param operation The boolean operation to perform (union/subtract/intersect).\n * @returns The resulting mesh of the boolean operation.\n */\nexport async function computeBoolean(\n  meshes: ManifoldMeshData[],\n  operation: BooleanOperation,\n): Promise<ManifoldMeshData> {\n  const backend = await getBackend()\n  return backend.boolean(operation, meshes)\n}\n\n/**\n * Split a mesh by a plane via the current backend.\n * @param mesh   The mesh to split.\n * @param normal The plane normal (unit vector).\n * @param offset The plane offset along the normal.\n * @returns The front and back halves of the split.\n */\nexport async function computeSplit(\n  mesh: ManifoldMeshData,\n  normal: [number, number, number],\n  offset: number,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData }> {\n  const backend = await getBackend()\n  const result = await backend.splitPlane(mesh, { normal, offset })\n  return { front: result.front, back: result.back }\n}\n\n/**\n * Split a mesh by a plane and cut a dovetail groove via the current backend.\n * @param mesh                The mesh to split.\n * @param planeNormal         The cutting plane normal (unit vector).\n * @param planeOriginOffset   The cutting plane offset along the normal.\n * @param planeCenter         A point on the cutting plane.\n * @param widthDir            The width direction within the cutting plane (unit vector).\n * @param bboxWidthOnWidthDir The model bounding-box width along the width direction.\n * @param groove              The dovetail groove parameters.\n * @returns The front/back halves plus the wedge mesh (or null when no wedge).\n */\nexport async function computeDovetailSplit(\n  mesh: ManifoldMeshData,\n  planeNormal: [number, number, number],\n  planeOriginOffset: number,\n  planeCenter: [number, number, number],\n  widthDir: [number, number, number],\n  bboxWidthOnWidthDir: number,\n  groove: DovetailGrooveParams,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData; wedge: ManifoldMeshData | null }> {\n  const backend = await getBackend()\n  const result = await backend.splitDovetail(mesh, {\n    planeNormal,\n    planeOriginOffset,\n    planeCenter,\n    widthDir,\n    bboxWidthOnWidthDir,\n    groove,\n  })\n  return { front: result.front, back: result.back, wedge: result.wedge }\n}\n\n/**\n * Split a mesh by a plane and cut dowel tenons via the current backend.\n * @param mesh                The mesh to split.\n * @param planeNormal         The cutting plane normal (unit vector).\n * @param planeOriginOffset   The cutting plane offset along the normal.\n * @param planeCenter         A point on the cutting plane.\n * @param widthDir            The width direction within the cutting plane (unit vector).\n * @param dowel               The dowel split parameters.\n * @param selectedSections    Optional list of section indices to place tenons on.\n * @returns The front/back halves plus the wedge mesh (or null when no wedge).\n */\nexport async function computeDowelSplit(\n  mesh: ManifoldMeshData,\n  planeNormal: [number, number, number],\n  planeOriginOffset: number,\n  planeCenter: [number, number, number],\n  widthDir: [number, number, number],\n  dowel: DowelSplitParams,\n  selectedSections?: number[] | null,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData; wedge: ManifoldMeshData | null }> {\n  const backend = await getBackend()\n  const result = await backend.splitDowel(mesh, {\n    planeNormal,\n    planeOriginOffset,\n    planeCenter,\n    widthDir,\n    dowel,\n    selectedSections,\n  })\n  return { front: result.front, back: result.back, wedge: result.wedge }\n}\n\n/**\n * Split a mesh by a plane and cut straight tenons via the current backend.\n * @param mesh                The mesh to split.\n * @param planeNormal         The cutting plane normal (unit vector).\n * @param planeOriginOffset   The cutting plane offset along the normal.\n * @param planeCenter         A point on the cutting plane.\n * @param widthDir            The width direction within the cutting plane (unit vector).\n * @param tenon               The straight-tenon split parameters.\n * @param selectedSections    Optional list of section indices to place tenons on.\n * @returns The front/back halves plus the wedge mesh (or null when no wedge).\n */\nexport async function computeStraightTenonSplit(\n  mesh: ManifoldMeshData,\n  planeNormal: [number, number, number],\n  planeOriginOffset: number,\n  planeCenter: [number, number, number],\n  widthDir: [number, number, number],\n  tenon: StraightTenonSplitParams,\n  selectedSections?: number[] | null,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData; wedge: ManifoldMeshData | null }> {\n  const backend = await getBackend()\n  const result = await backend.splitStraightTenon(mesh, {\n    planeNormal,\n    planeOriginOffset,\n    planeCenter,\n    widthDir,\n    tenon,\n    selectedSections,\n  })\n  return { front: result.front, back: result.back, wedge: result.wedge }\n}\n\n/**\n * Terminate the worker held by the backend, if any.\n * The InlineCsgBackend owns no worker to terminate; the WorkerCsgBackend\n * termination logic is managed by the browser host.\n */\nexport function terminateWorker(): void {\n  // InlineCsgBackend has no worker to terminate\n  // WorkerCsgBackend termination is managed by the browser host\n}\n\n// ── 纯函数重导出（从 geo-convert）──\n\nexport { geoToManifoldMesh, manifoldMeshToGeo } from './geo-convert'\n\n// ── 类型重导出 ──\n\nexport type {\n  ManifoldMeshData,\n  BooleanOperation,\n  DovetailGrooveParams,\n  DowelSplitParams,\n  StraightTenonSplitParams,\n} from './geo-convert'\n"]}
+{"version":3,"file":"csg-backend.js","sourceRoot":"","sources":["../../src/boolean/csg-backend.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * csg-backend — 可注入的 CSG 后端\n *\n * 提供 computeBoolean / computeSplit / computeDovetailSplit / computeDowelSplit / computeStraightTenonSplit\n * 等异步函数，与 csg.ts 的 API 一致。\n *\n * Node 环境：默认使用 InlineCsgBackend（主线程直跑 manifold-3d）。\n * 浏览器环境：通过 setCsgBackend() 注入 WorkerCsgBackend。\n *\n * F1 修复：不静态 import browser-host/inline-csg-backend（L1 不依赖 L3）。\n * 改为延迟动态 import，仅在未注入后端时按需加载。\n */\n\nimport type { CsgBackend } from '../cad-runtime/ports'\nimport type {\n  ManifoldMeshData,\n  BooleanOperation,\n  DovetailGrooveParams,\n  DowelSplitParams,\n  StraightTenonSplitParams,\n} from './geo-convert'\n\n// ── 后端实例管理 ──\n\nlet _backend: CsgBackend | null = null\n\n/**\n * Inject the CSG backend used by the browser host (e.g. WorkerCsgBackend).\n * @param backend The backend instance to install as the current CSG backend.\n */\nexport function setCsgBackend(backend: CsgBackend): void {\n  _backend = backend\n}\n\n/**\n * 获取当前 CSG 后端。\n * F1 修复：延迟动态 import InlineCsgBackend，避免 L1 静态依赖 L3。\n */\nasync function getBackend(): Promise<CsgBackend> {\n  if (_backend) return _backend\n  // 延迟加载——仅在实际需要时才拉入 L3 代码\n  const { InlineCsgBackend } = await import('../browser-host/inline-csg-backend')\n  _backend = new InlineCsgBackend()\n  return _backend\n}\n\n// ── CSG 操作 API（与 csg.ts 签名一致）──\n\n/**\n * Apply a boolean operation across several meshes via the current backend.\n * @param meshes    The input meshes to combine.\n * @param operation The boolean operation to perform (union/subtract/intersect).\n * @returns The resulting mesh of the boolean operation.\n */\nexport async function computeBoolean(\n  meshes: ManifoldMeshData[],\n  operation: BooleanOperation,\n): Promise<ManifoldMeshData> {\n  const backend = await getBackend()\n  return backend.boolean(operation, meshes)\n}\n\n/**\n * Split a mesh by a plane via the current backend.\n * @param mesh   The mesh to split.\n * @param normal The plane normal (unit vector).\n * @param offset The plane offset along the normal.\n * @returns The front and back halves of the split.\n */\nexport async function computeSplit(\n  mesh: ManifoldMeshData,\n  normal: [number, number, number],\n  offset: number,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData }> {\n  const backend = await getBackend()\n  const result = await backend.splitPlane(mesh, { normal, offset })\n  return { front: result.front, back: result.back }\n}\n\n/**\n * Split a mesh by a plane and cut a dovetail groove via the current backend.\n * @param mesh                The mesh to split.\n * @param planeNormal         The cutting plane normal (unit vector).\n * @param planeDistance   The cutting plane offset along the normal.\n * @param planeCenter         A point on the cutting plane.\n * @param widthDir            The width direction within the cutting plane (unit vector).\n * @param bboxWidthOnWidthDir The model bounding-box width along the width direction.\n * @param groove              The dovetail groove parameters.\n * @returns The front/back halves plus the wedge mesh (or null when no wedge).\n */\nexport async function computeDovetailSplit(\n  mesh: ManifoldMeshData,\n  planeNormal: [number, number, number],\n  planeDistance: number,\n  planeCenter: [number, number, number],\n  widthDir: [number, number, number],\n  bboxWidthOnWidthDir: number,\n  groove: DovetailGrooveParams,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData; wedge: ManifoldMeshData | null }> {\n  const backend = await getBackend()\n  const result = await backend.splitDovetail(mesh, {\n    planeNormal,\n    planeDistance,\n    planeCenter,\n    widthDir,\n    bboxWidthOnWidthDir,\n    groove,\n  })\n  return { front: result.front, back: result.back, wedge: result.wedge }\n}\n\n/**\n * Split a mesh by a plane and cut dowel tenons via the current backend.\n * @param mesh                The mesh to split.\n * @param planeNormal         The cutting plane normal (unit vector).\n * @param planeDistance   The cutting plane offset along the normal.\n * @param planeCenter         A point on the cutting plane.\n * @param widthDir            The width direction within the cutting plane (unit vector).\n * @param dowel               The dowel split parameters.\n * @param selectedSections    Optional list of section indices to place tenons on.\n * @returns The front/back halves plus the wedge mesh (or null when no wedge).\n */\nexport async function computeDowelSplit(\n  mesh: ManifoldMeshData,\n  planeNormal: [number, number, number],\n  planeDistance: number,\n  planeCenter: [number, number, number],\n  widthDir: [number, number, number],\n  dowel: DowelSplitParams,\n  selectedSections?: number[] | null,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData; wedge: ManifoldMeshData | null }> {\n  const backend = await getBackend()\n  const result = await backend.splitDowel(mesh, {\n    planeNormal,\n    planeDistance,\n    planeCenter,\n    widthDir,\n    dowel,\n    selectedSections,\n  })\n  return { front: result.front, back: result.back, wedge: result.wedge }\n}\n\n/**\n * Split a mesh by a plane and cut straight tenons via the current backend.\n * @param mesh                The mesh to split.\n * @param planeNormal         The cutting plane normal (unit vector).\n * @param planeDistance   The cutting plane offset along the normal.\n * @param planeCenter         A point on the cutting plane.\n * @param widthDir            The width direction within the cutting plane (unit vector).\n * @param tenon               The straight-tenon split parameters.\n * @param selectedSections    Optional list of section indices to place tenons on.\n * @returns The front/back halves plus the wedge mesh (or null when no wedge).\n */\nexport async function computeStraightTenonSplit(\n  mesh: ManifoldMeshData,\n  planeNormal: [number, number, number],\n  planeDistance: number,\n  planeCenter: [number, number, number],\n  widthDir: [number, number, number],\n  tenon: StraightTenonSplitParams,\n  selectedSections?: number[] | null,\n): Promise<{ front: ManifoldMeshData; back: ManifoldMeshData; wedge: ManifoldMeshData | null }> {\n  const backend = await getBackend()\n  const result = await backend.splitStraightTenon(mesh, {\n    planeNormal,\n    planeDistance,\n    planeCenter,\n    widthDir,\n    tenon,\n    selectedSections,\n  })\n  return { front: result.front, back: result.back, wedge: result.wedge }\n}\n\n/**\n * Terminate the worker held by the backend, if any.\n * The InlineCsgBackend owns no worker to terminate; the WorkerCsgBackend\n * termination logic is managed by the browser host.\n */\nexport function terminateWorker(): void {\n  // InlineCsgBackend has no worker to terminate\n  // WorkerCsgBackend termination is managed by the browser host\n}\n\n// ── 纯函数重导出（从 geo-convert）──\n\nexport { geoToManifoldMesh, manifoldMeshToGeo } from './geo-convert'\n\n// ── 类型重导出 ──\n\nexport type {\n  ManifoldMeshData,\n  BooleanOperation,\n  DovetailGrooveParams,\n  DowelSplitParams,\n  StraightTenonSplitParams,\n} from './geo-convert'\n"]}

package/dist/boolean/csg-core.d.ts

@@ -95,38 +95,38 @@ export declare function createWedge(Manifold: ManifoldCtor, Mesh: MeshCtor, plan
  * Returns an array of components, each being a Set of vertex indices.
  * @param upper         The upper mesh to scan for cap faces.
  * @param normal        The cutting plane normal.
- * @param originOffset  The cutting plane offset along the normal.
+ * @param planeDistance  The cutting plane offset along the normal.
  * @returns An array of components, each a Set of vertex indices on the cap.
  */
-export declare function detectCapComponents(upper: ManifoldInstance, normal: Vec3, originOffset: number): Set<number>[];
+export declare function detectCapComponents(upper: ManifoldInstance, normal: Vec3, planeDistance: number): Set<number>[];
 /**
  * Compute the actual extent of the model's cross-section at the cutting plane
  * along the width direction.
  * @param upper         The upper mesh to measure.
  * @param normal        The cutting plane normal.
- * @param originOffset  The cutting plane offset along the normal.
+ * @param planeDistance  The cutting plane offset along the normal.
  * @param widthDir      The width direction along which to measure.
  * @param comp          Optional connected component to restrict the measurement to.
  * @returns The cross-section extent along the width direction (0 when none found).
  */
-export declare function computeCrossSectionWidth(upper: ManifoldInstance, normal: Vec3, originOffset: number, widthDir: Vec3, comp?: Set<number>): number;
+export declare function computeCrossSectionWidth(upper: ManifoldInstance, normal: Vec3, planeDistance: number, widthDir: Vec3, comp?: Set<number>): number;
 /**
  * Compute the centroid of vertices lying on the cutting plane.
  * @param upper         The upper mesh to scan.
  * @param normal        The cutting plane normal.
- * @param originOffset  The cutting plane offset along the normal.
+ * @param planeDistance  The cutting plane offset along the normal.
  * @param fallback      The centroid fallback when no vertex lies on the plane.
  * @param comp          Optional connected component to restrict the measurement to.
  * @returns The computed centroid, or the fallback when none is found.
  */
-export declare function computeCrossSectionCentroid(upper: ManifoldInstance, normal: Vec3, originOffset: number, fallback: Vec3, comp?: Set<number>): Vec3;
+export declare function computeCrossSectionCentroid(upper: ManifoldInstance, normal: Vec3, planeDistance: number, fallback: Vec3, comp?: Set<number>): Vec3;
 /**
  * Perform the dovetail split using boolean operations.
  * @param Manifold - the Manifold constructor from the manifold module.
  * @param Mesh - the Mesh constructor from the manifold module.
  * @param original - the original manifold to split.
  * @param normal - the cutting plane normal (unit vector).
- * @param originOffset - the plane equation origin offset along the normal.
+ * @param planeDistance - the plane equation origin offset along the normal.
  * @param planeCenter - a point on the cutting plane used to center the wedge.
  * @param widthDirInput - the width direction in the cutting plane (will be normalized).
  * @param bboxWidthOnWidthDir - the model's bounding-box width along widthDir, used as a fallback cross-section width.
@@ -134,7 +134,7 @@ export declare function computeCrossSectionCentroid(upper: ManifoldInstance, nor
  * @param keepOriginal - when true, the original manifold is not deleted after splitting (default false).
  * @returns a tuple of the split upper manifold, lower manifold, and the trimmed wedge mesh data (or null when empty).
  */
-export declare function dovetailBooleanSplit(Manifold: ManifoldCtor, Mesh: MeshCtor, original: ManifoldInstance, normal: Vec3, originOffset: number, planeCenter: Vec3, widthDirInput: Vec3, bboxWidthOnWidthDir: number, groove: {
+export declare function dovetailBooleanSplit(Manifold: ManifoldCtor, Mesh: MeshCtor, original: ManifoldInstance, normal: Vec3, planeDistance: number, planeCenter: Vec3, widthDirInput: Vec3, bboxWidthOnWidthDir: number, groove: {
     depth: number;
     depthTolerance: number;
     width: number;
@@ -181,7 +181,7 @@ export declare function createStraightTenon(Manifold: ManifoldCtor, Mesh: MeshCt
  * @param Mesh - the Mesh constructor from the manifold module.
  * @param original - the original manifold to split.
  * @param normal - the cutting plane normal (unit vector).
- * @param originOffset - the plane equation origin offset along the normal.
+ * @param planeDistance - the plane equation origin offset along the normal.
  * @param planeCenter - a point on the cutting plane used to center the joinery.
  * @param widthDirInput - the width direction in the cutting plane (will be normalized).
  * @param shape - the joinery shape: 'dowel' or 'tenon'.
@@ -190,7 +190,7 @@ export declare function createStraightTenon(Manifold: ManifoldCtor, Mesh: MeshCt
  * @param selectedSections - optional list of indices selecting which cap sections receive joinery placement; null or empty means a single placement at the overall cross-section centroid.
  * @returns a tuple of the split upper manifold, lower manifold, and the generated joinery mesh data (or null).
  */
-export declare function dowelOrTenonBooleanSplit(Manifold: ManifoldCtor, Mesh: MeshCtor, original: ManifoldInstance, normal: Vec3, originOffset: number, planeCenter: Vec3, widthDirInput: Vec3, shape: 'dowel' | 'tenon', params: {
+export declare function dowelOrTenonBooleanSplit(Manifold: ManifoldCtor, Mesh: MeshCtor, original: ManifoldInstance, normal: Vec3, planeDistance: number, planeCenter: Vec3, widthDirInput: Vec3, shape: 'dowel' | 'tenon', params: {
     size: number;
     sizeTolerance: number;
     height: number;

package/dist/boolean/csg-core.d.ts.map

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

package/dist/boolean/csg-core.js

@@ -201,10 +201,10 @@ export function createWedge(Manifold, Mesh, planeCenter, normal, widthDir, depth
  * Returns an array of components, each being a Set of vertex indices.
  * @param upper         The upper mesh to scan for cap faces.
  * @param normal        The cutting plane normal.
- * @param originOffset  The cutting plane offset along the normal.
+ * @param planeDistance  The cutting plane offset along the normal.
  * @returns An array of components, each a Set of vertex indices on the cap.
  */
-export function detectCapComponents(upper, normal, originOffset) {
+export function detectCapComponents(upper, normal, planeDistance) {
     const mesh = upper.getMesh();
     const eps = 0.001;
     const numProp = mesh.numProp || 3;
@@ -221,13 +221,13 @@ export function detectCapComponents(upper, normal, originOffset) {
         const i2 = triVerts[t * 3 + 2];
         const d0 = Math.abs(mesh.vertProperties[i0 * numProp] * normal[0] +
             mesh.vertProperties[i0 * numProp + 1] * normal[1] +
-            mesh.vertProperties[i0 * numProp + 2] * normal[2] - originOffset);
+            mesh.vertProperties[i0 * numProp + 2] * normal[2] - planeDistance);
         const d1 = Math.abs(mesh.vertProperties[i1 * numProp] * normal[0] +
             mesh.vertProperties[i1 * numProp + 1] * normal[1] +
-            mesh.vertProperties[i1 * numProp + 2] * normal[2] - originOffset);
+            mesh.vertProperties[i1 * numProp + 2] * normal[2] - planeDistance);
         const d2 = Math.abs(mesh.vertProperties[i2 * numProp] * normal[0] +
             mesh.vertProperties[i2 * numProp + 1] * normal[1] +
-            mesh.vertProperties[i2 * numProp + 2] * normal[2] - originOffset);
+            mesh.vertProperties[i2 * numProp + 2] * normal[2] - planeDistance);
         if (d0 < eps && d1 < eps && d2 < eps) {
             capTris.push({ v0: i0, v1: i1, v2: i2 });
             capVertSet.add(i0);
@@ -258,12 +258,12 @@ export function detectCapComponents(upper, normal, originOffset) {
  * along the width direction.
  * @param upper         The upper mesh to measure.
  * @param normal        The cutting plane normal.
- * @param originOffset  The cutting plane offset along the normal.
+ * @param planeDistance  The cutting plane offset along the normal.
  * @param widthDir      The width direction along which to measure.
  * @param comp          Optional connected component to restrict the measurement to.
  * @returns The cross-section extent along the width direction (0 when none found).
  */
-export function computeCrossSectionWidth(upper, normal, originOffset, widthDir, comp) {
+export function computeCrossSectionWidth(upper, normal, planeDistance, widthDir, comp) {
     const mesh = upper.getMesh();
     const eps = 0.001;
     let minProj = Infinity;
@@ -278,7 +278,7 @@ export function computeCrossSectionWidth(upper, normal, originOffset, widthDir,
         const x = mesh.vertProperties[base];
         const y = mesh.vertProperties[base + 1];
         const z = mesh.vertProperties[base + 2];
-        const dist = x * normal[0] + y * normal[1] + z * normal[2] - originOffset;
+        const dist = x * normal[0] + y * normal[1] + z * normal[2] - planeDistance;
         if (Math.abs(dist) < eps) {
             const proj = x * widthDir[0] + y * widthDir[1] + z * widthDir[2];
             if (proj < minProj)
@@ -297,12 +297,12 @@ export function computeCrossSectionWidth(upper, normal, originOffset, widthDir,
  * Compute the centroid of vertices lying on the cutting plane.
  * @param upper         The upper mesh to scan.
  * @param normal        The cutting plane normal.
- * @param originOffset  The cutting plane offset along the normal.
+ * @param planeDistance  The cutting plane offset along the normal.
  * @param fallback      The centroid fallback when no vertex lies on the plane.
  * @param comp          Optional connected component to restrict the measurement to.
  * @returns The computed centroid, or the fallback when none is found.
  */
-export function computeCrossSectionCentroid(upper, normal, originOffset, fallback, comp) {
+export function computeCrossSectionCentroid(upper, normal, planeDistance, fallback, comp) {
     const mesh = upper.getMesh();
     const eps = 0.001;
     let cx = 0, cy = 0, cz = 0;
@@ -316,7 +316,7 @@ export function computeCrossSectionCentroid(upper, normal, originOffset, fallbac
         const x = mesh.vertProperties[base];
         const y = mesh.vertProperties[base + 1];
         const z = mesh.vertProperties[base + 2];
-        const dist = x * normal[0] + y * normal[1] + z * normal[2] - originOffset;
+        const dist = x * normal[0] + y * normal[1] + z * normal[2] - planeDistance;
         if (Math.abs(dist) < eps) {
             cx += x;
             cy += y;
@@ -335,7 +335,7 @@ export function computeCrossSectionCentroid(upper, normal, originOffset, fallbac
  * @param Mesh - the Mesh constructor from the manifold module.
  * @param original - the original manifold to split.
  * @param normal - the cutting plane normal (unit vector).
- * @param originOffset - the plane equation origin offset along the normal.
+ * @param planeDistance - the plane equation origin offset along the normal.
  * @param planeCenter - a point on the cutting plane used to center the wedge.
  * @param widthDirInput - the width direction in the cutting plane (will be normalized).
  * @param bboxWidthOnWidthDir - the model's bounding-box width along widthDir, used as a fallback cross-section width.
@@ -343,14 +343,14 @@ export function computeCrossSectionCentroid(upper, normal, originOffset, fallbac
  * @param keepOriginal - when true, the original manifold is not deleted after splitting (default false).
  * @returns a tuple of the split upper manifold, lower manifold, and the trimmed wedge mesh data (or null when empty).
  */
-export function dovetailBooleanSplit(Manifold, Mesh, original, normal, originOffset, planeCenter, widthDirInput, bboxWidthOnWidthDir, groove, keepOriginal = false) {
+export function dovetailBooleanSplit(Manifold, Mesh, original, normal, planeDistance, planeCenter, widthDirInput, bboxWidthOnWidthDir, groove, keepOriginal = false) {
     const widthDir = vec3Normalize(widthDirInput);
     // Step 1: Split by plane → upper + lower
-    const [upper, lower] = original.splitByPlane(normal, originOffset);
+    const [upper, lower] = original.splitByPlane(normal, planeDistance);
     if (!keepOriginal)
         original.delete();
     // Step 2: Compute actual cross-section width at the cutting plane
-    let crossSectionWidth = computeCrossSectionWidth(upper, normal, originOffset, widthDir);
+    let crossSectionWidth = computeCrossSectionWidth(upper, normal, planeDistance, widthDir);
     if (crossSectionWidth <= 0) {
         crossSectionWidth = bboxWidthOnWidthDir;
     }
@@ -466,7 +466,7 @@ export function createStraightTenon(Manifold, Mesh, centroid, normal, widthDir,
  * @param Mesh - the Mesh constructor from the manifold module.
  * @param original - the original manifold to split.
  * @param normal - the cutting plane normal (unit vector).
- * @param originOffset - the plane equation origin offset along the normal.
+ * @param planeDistance - the plane equation origin offset along the normal.
  * @param planeCenter - a point on the cutting plane used to center the joinery.
  * @param widthDirInput - the width direction in the cutting plane (will be normalized).
  * @param shape - the joinery shape: 'dowel' or 'tenon'.
@@ -475,25 +475,25 @@ export function createStraightTenon(Manifold, Mesh, centroid, normal, widthDir,
  * @param selectedSections - optional list of indices selecting which cap sections receive joinery placement; null or empty means a single placement at the overall cross-section centroid.
  * @returns a tuple of the split upper manifold, lower manifold, and the generated joinery mesh data (or null).
  */
-export function dowelOrTenonBooleanSplit(Manifold, Mesh, original, normal, originOffset, planeCenter, widthDirInput, shape, params, keepOriginal = false, selectedSections) {
+export function dowelOrTenonBooleanSplit(Manifold, Mesh, original, normal, planeDistance, planeCenter, widthDirInput, shape, params, keepOriginal = false, selectedSections) {
     const widthDir = vec3Normalize(widthDirInput);
     const depthDir = vec3Normalize(vec3Cross(normal, widthDir));
     // Step 1: Split by plane → upper + lower
-    const [upper, lower] = original.splitByPlane(normal, originOffset);
+    const [upper, lower] = original.splitByPlane(normal, planeDistance);
     if (!keepOriginal)
         original.delete();
     // Step 2: Detect cap components (multi-section support)
-    const components = detectCapComponents(upper, normal, originOffset);
+    const components = detectCapComponents(upper, normal, planeDistance);
     let placements;
     if (components.length <= 1 || !selectedSections || selectedSections.length === 0) {
-        const centroid = computeCrossSectionCentroid(upper, normal, originOffset, planeCenter);
+        const centroid = computeCrossSectionCentroid(upper, normal, planeDistance, planeCenter);
         placements = [{ centroid }];
     }
     else {
         const compInfo = components.map((comp, idx) => {
-            const compWidth = computeCrossSectionWidth(upper, normal, originOffset, widthDir, comp);
-            const compCentroid = computeCrossSectionCentroid(upper, normal, originOffset, planeCenter, comp);
-            const compDepth = computeCrossSectionWidth(upper, normal, originOffset, depthDir, comp);
+            const compWidth = computeCrossSectionWidth(upper, normal, planeDistance, widthDir, comp);
+            const compCentroid = computeCrossSectionCentroid(upper, normal, planeDistance, planeCenter, comp);
+            const compDepth = computeCrossSectionWidth(upper, normal, planeDistance, depthDir, comp);
             const area = compWidth * compDepth;
             return { idx, comp, area, centroid: compCentroid };
         });
@@ -505,7 +505,7 @@ export function dowelOrTenonBooleanSplit(Manifold, Mesh, original, normal, origi
             }
         }
         if (placements.length === 0) {
-            const centroid = computeCrossSectionCentroid(upper, normal, originOffset, planeCenter);
+            const centroid = computeCrossSectionCentroid(upper, normal, planeDistance, planeCenter);
             placements = [{ centroid }];
         }
     }