@faicad/faijs 0.13.0

package/dist/mesh/fai_split.js.map

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

package/dist/mesh/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * mesh — 纯数据几何 API 统一入口
+ *
+ * See docs/api-contract.md §1 (architecture layers) and §10 (stdlib function catalog).
+ *
+ * 原则（§5.1）：
+ * 1. 全部纯数据：输入输出是 Shape (ManifoldMeshData)，不碰 THREE 场景、不读 store
+ * 2. 不可变：每个 API 返回新几何，不修改输入
+ * 3. 同步签名、异步执行：API 签名同步（或 async）；worker 边界由 ScriptEngine 处理
+ * 4. 坐标系：右手系 +Z 向上、毫米、角度用度
+ *
+ * P1 阶段：mesh 是对现有纯函数的薄包装层，行为完全不变。
+ * P3+ 阶段：mesh 将由 ScriptEngine 驱动，在 worker 中执行。
+ */
+import * as primitives from './primitives.js';
+import * as brepPrimitives from '../brep/primitives-brep.js';
+import * as brepOps from '../brep/index.js';
+import * as booleanOps from './boolean.js';
+import * as splitOps from './fai_split.js';
+import * as drillOps from './fai_drill.js';
+import * as extrudeOps from './fai_extrude.js';
+import * as engraveOps from './engrave.js';
+import * as transformOps from './transform.js';
+import * as queryOps from './query.js';
+import * as ioOps from './io.js';
+/**
+ * Unified `cad` API object aggregating the pure-data mesh operations: mesh and
+ * BREP primitives, transforms, booleans, splits, drill/extrude/engrave/knurl,
+ * geometry queries, file IO, and BREP feature operations.
+ */
+export declare const cad: {
+    box: typeof primitives.box;
+    sphere: typeof primitives.sphere;
+    cylinder: typeof primitives.cylinder;
+    cone: typeof primitives.cone;
+    wedge: typeof primitives.wedge;
+    text: typeof primitives.text;
+    screw: typeof primitives.screw;
+    svgExtrude: typeof primitives.svgExtrude;
+    sdf: typeof primitives.sdf;
+    boxBrep: typeof brepPrimitives.boxBrep;
+    sphereBrep: typeof brepPrimitives.sphereBrep;
+    cylinderBrep: typeof brepPrimitives.cylinderBrep;
+    coneBrep: typeof brepPrimitives.coneBrep;
+    wedgeBrep: typeof brepPrimitives.wedgeBrep;
+    translate: typeof transformOps.translate;
+    rotate_euler: typeof transformOps.rotate_euler;
+    scale: typeof transformOps.scale;
+    scale3d: typeof transformOps.scale3d;
+    transformMatrix: typeof transformOps.transformMatrix;
+    union: typeof booleanOps.union;
+    subtract: typeof booleanOps.subtract;
+    intersect: typeof booleanOps.intersect;
+    fai_split: typeof splitOps.split;
+    fai_splitWithParams: typeof splitOps.splitWithParams;
+    dovetailSplit: typeof splitOps.dovetailSplit;
+    dowelSplit: typeof splitOps.dowelSplit;
+    tenonSplit: typeof splitOps.tenonSplit;
+    fai_drill: typeof drillOps.drill;
+    fai_extrude: typeof extrudeOps.extrude;
+    engrave: typeof engraveOps.engrave;
+    knurl: typeof engraveOps.knurl;
+    boundingBox: typeof queryOps.boundingBox;
+    bboxCenter: typeof queryOps.bboxCenter;
+    volume: typeof queryOps.volume;
+    faceAt: typeof queryOps.faceAt;
+    load: typeof ioOps.importFile;
+    translateBrep: typeof brepOps.translateBrep;
+    rotateBrep: typeof brepOps.rotateBrep;
+    scaleBrep: typeof brepOps.scaleBrep;
+    fuseBrep: typeof brepOps.fuseBrep;
+    cutBrep: typeof brepOps.cutBrep;
+    commonBrep: typeof brepOps.commonBrep;
+    drillBrep: typeof brepOps.drillBrep;
+    splitBrep: typeof brepOps.splitBrep;
+    extrudeBrep: typeof brepOps.extrudeBrep;
+    loadBrep: typeof brepOps.loadBrep;
+    solidToShape: typeof brepOps.solidToShape;
+};
+export type { Shape, Vec3, BoundingBox, FaceDescriptor } from './types.js';
+export type { BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams, TextParams, SvgExtrudeParams, SdfParams, DrillParams, ExtrudeParams, EngraveParams, KnurlParams, SplitPlane, SplitResult, DovetailSplitParams, DowelSplitParams, TenonSplitParams, } from './types.js';
+export type { BrepChainState, DrillBrepParams, SplitBrepParams, SplitBrepResult, ExtrudeBrepParams, } from '../brep/index.js';
+export { createBrepChainState, initBrepChainState, releaseBrepChainState, solidToShape, isCadFormat, } from '../brep/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,YAAY,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,MAAM,CAAA;AAI7B;;;;GAIG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEf,CAAA;AAID,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACvE,YAAY,EACV,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAChE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EACvC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EACtD,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,GACjF,MAAM,SAAS,CAAA;AAGhB,YAAY,EACV,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EACjE,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,oBAAoB,EAAE,kBAAkB,EAAE,qBAAqB,EAC/D,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA"}

package/dist/mesh/index.js

@@ -0,0 +1,95 @@
+/**
+ * mesh — 纯数据几何 API 统一入口
+ *
+ * See docs/api-contract.md §1 (architecture layers) and §10 (stdlib function catalog).
+ *
+ * 原则（§5.1）：
+ * 1. 全部纯数据：输入输出是 Shape (ManifoldMeshData)，不碰 THREE 场景、不读 store
+ * 2. 不可变：每个 API 返回新几何，不修改输入
+ * 3. 同步签名、异步执行：API 签名同步（或 async）；worker 边界由 ScriptEngine 处理
+ * 4. 坐标系：右手系 +Z 向上、毫米、角度用度
+ *
+ * P1 阶段：mesh 是对现有纯函数的薄包装层，行为完全不变。
+ * P3+ 阶段：mesh 将由 ScriptEngine 驱动，在 worker 中执行。
+ */
+import * as primitives from './primitives.js';
+import * as brepPrimitives from '../brep/primitives-brep.js';
+import * as brepOps from '../brep/index.js';
+import * as booleanOps from './boolean.js';
+import * as splitOps from './fai_split.js';
+import * as drillOps from './fai_drill.js';
+import * as extrudeOps from './fai_extrude.js';
+import * as engraveOps from './engrave.js';
+import * as transformOps from './transform.js';
+import * as queryOps from './query.js';
+import * as ioOps from './io.js';
+// ── 统一 cad API 对象 ──
+/**
+ * Unified `cad` API object aggregating the pure-data mesh operations: mesh and
+ * BREP primitives, transforms, booleans, splits, drill/extrude/engrave/knurl,
+ * geometry queries, file IO, and BREP feature operations.
+ */
+export const cad = {
+    // 创建（mesh 路径）
+    box: primitives.box,
+    sphere: primitives.sphere,
+    cylinder: primitives.cylinder,
+    cone: primitives.cone,
+    wedge: primitives.wedge,
+    text: primitives.text,
+    screw: primitives.screw,
+    svgExtrude: primitives.svgExtrude,
+    sdf: primitives.sdf,
+    // 创建（BREP 路径 — OCCT 精确实体三角化）
+    boxBrep: brepPrimitives.boxBrep,
+    sphereBrep: brepPrimitives.sphereBrep,
+    cylinderBrep: brepPrimitives.cylinderBrep,
+    coneBrep: brepPrimitives.coneBrep,
+    wedgeBrep: brepPrimitives.wedgeBrep,
+    // 变换
+    translate: transformOps.translate,
+    rotate_euler: transformOps.rotate_euler,
+    scale: transformOps.scale,
+    scale3d: transformOps.scale3d,
+    transformMatrix: transformOps.transformMatrix,
+    // 布尔
+    union: booleanOps.union,
+    subtract: booleanOps.subtract,
+    intersect: booleanOps.intersect,
+    // 分割
+    // fai_* 键为 mesh 侧实现入口。DEPRECATED：`fai_` 前缀 op 是 ../3d_editor 项目
+    // 特有的操作，将来迁出并从 faijs 删除（见 api/fai_*.ts 的 @deprecated）。
+    fai_split: splitOps.split,
+    fai_splitWithParams: splitOps.splitWithParams,
+    dovetailSplit: splitOps.dovetailSplit,
+    dowelSplit: splitOps.dowelSplit,
+    tenonSplit: splitOps.tenonSplit,
+    // 钻孔
+    fai_drill: drillOps.drill,
+    // 拉伸
+    fai_extrude: extrudeOps.extrude,
+    // 雕刻
+    engrave: engraveOps.engrave,
+    knurl: engraveOps.knurl,
+    // 查询
+    boundingBox: queryOps.boundingBox,
+    bboxCenter: queryOps.bboxCenter,
+    volume: queryOps.volume,
+    faceAt: queryOps.faceAt,
+    // IO
+    load: ioOps.importFile,
+    // BREP 特征操作（Phase 2 — OCCT 精确实体运算）
+    translateBrep: brepOps.translateBrep,
+    rotateBrep: brepOps.rotateBrep,
+    scaleBrep: brepOps.scaleBrep,
+    fuseBrep: brepOps.fuseBrep,
+    cutBrep: brepOps.cutBrep,
+    commonBrep: brepOps.commonBrep,
+    drillBrep: brepOps.drillBrep,
+    splitBrep: brepOps.splitBrep,
+    extrudeBrep: brepOps.extrudeBrep,
+    loadBrep: brepOps.loadBrep,
+    solidToShape: brepOps.solidToShape,
+};
+export { createBrepChainState, initBrepChainState, releaseBrepChainState, solidToShape, isCadFormat, } from '../brep/index.js';
+//# sourceMappingURL=index.js.map

package/dist/mesh/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh — 纯数据几何 API 统一入口\n *\n * See docs/api-contract.md §1 (architecture layers) and §10 (stdlib function catalog).\n *\n * 原则（§5.1）：\n * 1. 全部纯数据：输入输出是 Shape (ManifoldMeshData)，不碰 THREE 场景、不读 store\n * 2. 不可变：每个 API 返回新几何，不修改输入\n * 3. 同步签名、异步执行：API 签名同步（或 async）；worker 边界由 ScriptEngine 处理\n * 4. 坐标系：右手系 +Z 向上、毫米、角度用度\n *\n * P1 阶段：mesh 是对现有纯函数的薄包装层，行为完全不变。\n * P3+ 阶段：mesh 将由 ScriptEngine 驱动，在 worker 中执行。\n */\n\nimport * as primitives from './primitives'\nimport * as brepPrimitives from '../brep/primitives-brep'\nimport * as brepOps from '../brep'\nimport * as booleanOps from './boolean'\nimport * as splitOps from './fai_split'\nimport * as drillOps from './fai_drill'\nimport * as extrudeOps from './fai_extrude'\nimport * as engraveOps from './engrave'\nimport * as transformOps from './transform'\nimport * as queryOps from './query'\nimport * as ioOps from './io'\n\n// ── 统一 cad API 对象 ──\n\n/**\n * Unified `cad` API object aggregating the pure-data mesh operations: mesh and\n * BREP primitives, transforms, booleans, splits, drill/extrude/engrave/knurl,\n * geometry queries, file IO, and BREP feature operations.\n */\nexport const cad = {\n  // 创建（mesh 路径）\n  box: primitives.box,\n  sphere: primitives.sphere,\n  cylinder: primitives.cylinder,\n  cone: primitives.cone,\n  wedge: primitives.wedge,\n  text: primitives.text,\n  screw: primitives.screw,\n  svgExtrude: primitives.svgExtrude,\n  sdf: primitives.sdf,\n\n  // 创建（BREP 路径 — OCCT 精确实体三角化）\n  boxBrep: brepPrimitives.boxBrep,\n  sphereBrep: brepPrimitives.sphereBrep,\n  cylinderBrep: brepPrimitives.cylinderBrep,\n  coneBrep: brepPrimitives.coneBrep,\n  wedgeBrep: brepPrimitives.wedgeBrep,\n\n  // 变换\n  translate: transformOps.translate,\n  rotate_euler: transformOps.rotate_euler,\n  scale: transformOps.scale,\n  scale3d: transformOps.scale3d,\n  transformMatrix: transformOps.transformMatrix,\n\n  // 布尔\n  union: booleanOps.union,\n  subtract: booleanOps.subtract,\n  intersect: booleanOps.intersect,\n\n  // 分割\n  // fai_* 键为 mesh 侧实现入口。DEPRECATED：`fai_` 前缀 op 是 ../3d_editor 项目\n  // 特有的操作，将来迁出并从 faijs 删除（见 api/fai_*.ts 的 @deprecated）。\n  fai_split: splitOps.split,\n  fai_splitWithParams: splitOps.splitWithParams,\n  dovetailSplit: splitOps.dovetailSplit,\n  dowelSplit: splitOps.dowelSplit,\n  tenonSplit: splitOps.tenonSplit,\n\n  // 钻孔\n  fai_drill: drillOps.drill,\n\n  // 拉伸\n  fai_extrude: extrudeOps.extrude,\n\n  // 雕刻\n  engrave: engraveOps.engrave,\n  knurl: engraveOps.knurl,\n\n  // 查询\n  boundingBox: queryOps.boundingBox,\n  bboxCenter: queryOps.bboxCenter,\n  volume: queryOps.volume,\n  faceAt: queryOps.faceAt,\n\n  // IO\n  load: ioOps.importFile,\n\n  // BREP 特征操作（Phase 2 — OCCT 精确实体运算）\n  translateBrep: brepOps.translateBrep,\n  rotateBrep: brepOps.rotateBrep,\n  scaleBrep: brepOps.scaleBrep,\n  fuseBrep: brepOps.fuseBrep,\n  cutBrep: brepOps.cutBrep,\n  commonBrep: brepOps.commonBrep,\n  drillBrep: brepOps.drillBrep,\n  splitBrep: brepOps.splitBrep,\n  extrudeBrep: brepOps.extrudeBrep,\n  loadBrep: brepOps.loadBrep,\n  solidToShape: brepOps.solidToShape,\n}\n\n// ── 类型导出 ──\n\nexport type { Shape, Vec3, BoundingBox, FaceDescriptor } from './types'\nexport type {\n  BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams,\n  TextParams, SvgExtrudeParams, SdfParams,\n  DrillParams, ExtrudeParams, EngraveParams, KnurlParams,\n  SplitPlane, SplitResult, DovetailSplitParams, DowelSplitParams, TenonSplitParams,\n} from './types'\n\n// BREP ops 类型导出\nexport type {\n  BrepChainState, DrillBrepParams, SplitBrepParams, SplitBrepResult,\n  ExtrudeBrepParams,\n} from '../brep'\nexport {\n  createBrepChainState, initBrepChainState, releaseBrepChainState,\n  solidToShape,\n  isCadFormat,\n} from '../brep'\n"]}

package/dist/mesh/io.d.ts

@@ -0,0 +1,17 @@
+/**
+ * mesh IO API — headless 文件加载
+ *
+ * 替代浏览器版的 io.ts（依赖 fileBlobStore / formatLoaders / model-store）。
+ * 仅使用 THREE.js 的 loader（STLLoader）解析文件字节为 Shape。
+ */
+import type { Shape } from './types.js';
+/**
+ * Load geometry from raw file bytes (headless variant). STL is parsed
+ * directly; unsupported formats fall back to STL parsing.
+ *
+ * @param buffer - the raw file bytes to parse.
+ * @param format - format identifier such as 'stl' (defaults to 'stl').
+ * @returns the loaded shape.
+ */
+export declare function importFile(buffer: ArrayBuffer, format?: string): Promise<Shape>;
+//# sourceMappingURL=io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC,CAiBhB"}

package/dist/mesh/io.js

@@ -0,0 +1,33 @@
+/**
+ * mesh IO API — headless 文件加载
+ *
+ * 替代浏览器版的 io.ts（依赖 fileBlobStore / formatLoaders / model-store）。
+ * 仅使用 THREE.js 的 loader（STLLoader）解析文件字节为 Shape。
+ */
+import { geoToManifoldMesh } from '../boolean/geo-convert.js';
+/**
+ * Load geometry from raw file bytes (headless variant). STL is parsed
+ * directly; unsupported formats fall back to STL parsing.
+ *
+ * @param buffer - the raw file bytes to parse.
+ * @param format - format identifier such as 'stl' (defaults to 'stl').
+ * @returns the loaded shape.
+ */
+export async function importFile(buffer, format) {
+    const fmt = (format ?? 'stl').toLowerCase();
+    if (fmt === 'stl') {
+        const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js');
+        const geo = new STLLoader().parse(buffer);
+        return geoToManifoldMesh(geo);
+    }
+    // For other formats, try STL as fallback
+    try {
+        const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js');
+        const geo = new STLLoader().parse(buffer);
+        return geoToManifoldMesh(geo);
+    }
+    catch {
+        throw new Error(`[mesh/io] unsupported format: ${fmt}`);
+    }
+}
+//# sourceMappingURL=io.js.map

package/dist/mesh/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAG1D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAmB,EACnB,MAAe;IAEf,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAE3C,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAA;QAC7E,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACzC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAA;QAC7E,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACzC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;IACzD,CAAC;AACH,CAAC","sourcesContent":["/**\n * mesh IO API — headless 文件加载\n *\n * 替代浏览器版的 io.ts（依赖 fileBlobStore / formatLoaders / model-store）。\n * 仅使用 THREE.js 的 loader（STLLoader）解析文件字节为 Shape。\n */\n\nimport { geoToManifoldMesh } from '../boolean/geo-convert'\nimport type { Shape } from './types'\n\n/**\n * Load geometry from raw file bytes (headless variant). STL is parsed\n * directly; unsupported formats fall back to STL parsing.\n *\n * @param buffer - the raw file bytes to parse.\n * @param format - format identifier such as 'stl' (defaults to 'stl').\n * @returns the loaded shape.\n */\nexport async function importFile(\n  buffer: ArrayBuffer,\n  format?: string,\n): Promise<Shape> {\n  const fmt = (format ?? 'stl').toLowerCase()\n\n  if (fmt === 'stl') {\n    const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js')\n    const geo = new STLLoader().parse(buffer)\n    return geoToManifoldMesh(geo)\n  }\n\n  // For other formats, try STL as fallback\n  try {\n    const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js')\n    const geo = new STLLoader().parse(buffer)\n    return geoToManifoldMesh(geo)\n  } catch {\n    throw new Error(`[mesh/io] unsupported format: ${fmt}`)\n  }\n}\n"]}

package/dist/mesh/knurl/KnurlGenerator.d.ts

@@ -0,0 +1,77 @@
+/**
+ * KnurlGenerator — 滚花纹理位移管线编排器
+ *
+ * 完全照搬 stlTexturizer 的管线：subdivide → applyDisplacement。
+ * 使用 knurling.jpg 作为位移纹理。
+ *
+ * 全程在 mesh 局部空间工作，不需要 world matrix 变换。
+ */
+import * as THREE from 'three';
+/**
+ * Knurling texture-displacement parameters: texture height, inversion,
+ * subdivision resolution, UV scale/offset/rotation, mapping mode, seam
+ * blending, and angle-based face masking limits.
+ */
+export interface KnurlParams {
+    /** 纹理高度 (mm)，默认 0.5 */
+    textureHeight: number;
+    /** 反向（内推而非外推），默认 false */
+    invertDisplacement: boolean;
+    /** 分辨率 (mm) — 细分后最大边长，默认 1.0 */
+    refineLength: number;
+    /** U 缩放，默认 0.15（knurling 专用） */
+    scaleU: number;
+    /** V 缩放，默认 0.15 */
+    scaleV: number;
+    /** 投影模式，默认 5 (Triplanar) */
+    mappingMode: number;
+    /** UV 偏移 U，默认 0 */
+    offsetU?: number;
+    /** UV 偏移 V，默认 0 */
+    offsetV?: number;
+    /** UV 旋转（度），默认 0 */
+    rotation?: number;
+    /** 底面角度遮罩（度），默认 5 */
+    bottomAngleLimit?: number;
+    /** 顶面角度遮罩（度），默认 0（不遮罩） */
+    topAngleLimit?: number;
+    /** 接缝混合，默认 1 */
+    mappingBlend?: number;
+    /** 接缝带宽，默认 0.5 */
+    seamBandWidth?: number;
+    /** 面排除权重（By Surface 用），null = 不排除 */
+    faceWeights?: Float32Array | null;
+}
+/** 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） */
+export interface KnurlBounds {
+    min: THREE.Vector3;
+    max: THREE.Vector3;
+    size: THREE.Vector3;
+    center: THREE.Vector3;
+}
+/** Default knurling parameters, used for every field the caller leaves unset. */
+export declare const KNURL_DEFAULTS: KnurlParams;
+/**
+ * Apply a knurling texture displacement to a geometry, entirely in mesh-local
+ * space. Pipeline:
+ *   1. Load the knurling texture as ImageData.
+ *   2. Subdivide the geometry to the effective refine length.
+ *   3. Displace the subdivided vertices along their smoothed normals.
+ *
+ * The effective refine length is never coarser than the caller's
+ * `refineLength`: it is clamped so each texture tile keeps ~8 segments when
+ * the requested resolution would alias the fine diamond pattern.
+ *
+ * @param geometry - the source geometry (mesh-local space).
+ * @param params - knurl parameters.
+ * @param onProgress - optional callback reporting stage and progress ('texture' | 'subdivide' | 'displace').
+ * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.
+ * @returns the displaced geometry.
+ */
+export declare function applyKnurlDisplacement(geometry: THREE.BufferGeometry, params: KnurlParams, onProgress?: (stage: string, p: number) => void, 
+/** External whole-part bounds (defaults to the geometry's own bounds).
+ *  Passing the whole part's bounds keeps texture density consistent with the
+ *  GPU preview, which normalizes against the part bbox while this geometry
+ *  is often only the selected-face subset. */
+boundsOverride?: KnurlBounds): Promise<THREE.BufferGeometry>;
+//# sourceMappingURL=KnurlGenerator.d.ts.map

package/dist/mesh/knurl/KnurlGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnurlGenerator.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAQ9B;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,0BAA0B;IAC1B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,0BAA0B;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,kBAAkB;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qCAAqC;IACrC,WAAW,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;CAClC;AAED,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAA;IACnB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CACtB;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,MAAM,EAAE,WAAW,EACnB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI;AAC/C;;;8CAG8C;AAC9C,cAAc,CAAC,EAAE,WAAW,GAC3B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAkG/B"}

package/dist/mesh/knurl/KnurlGenerator.js

@@ -0,0 +1,116 @@
+/**
+ * KnurlGenerator — 滚花纹理位移管线编排器
+ *
+ * 完全照搬 stlTexturizer 的管线：subdivide → applyDisplacement。
+ * 使用 knurling.jpg 作为位移纹理。
+ *
+ * 全程在 mesh 局部空间工作，不需要 world matrix 变换。
+ */
+import * as THREE from 'three';
+import { subdivide } from './subdivision.js';
+import { applyDisplacement } from './displacement.js';
+import { loadKnurlingTexture } from './textureLoader.js';
+import { MODE_TRIPLANAR } from './mapping.js';
+/** Default knurling parameters, used for every field the caller leaves unset. */
+export const KNURL_DEFAULTS = {
+    textureHeight: 0.5,
+    invertDisplacement: false,
+    refineLength: 1.0,
+    scaleU: 0.15,
+    scaleV: 0.15,
+    mappingMode: MODE_TRIPLANAR,
+    offsetU: 0,
+    offsetV: 0,
+    rotation: 0,
+    bottomAngleLimit: 5,
+    topAngleLimit: 0,
+    mappingBlend: 1,
+    seamBandWidth: 0.5,
+    faceWeights: null,
+};
+/**
+ * Apply a knurling texture displacement to a geometry, entirely in mesh-local
+ * space. Pipeline:
+ *   1. Load the knurling texture as ImageData.
+ *   2. Subdivide the geometry to the effective refine length.
+ *   3. Displace the subdivided vertices along their smoothed normals.
+ *
+ * The effective refine length is never coarser than the caller's
+ * `refineLength`: it is clamped so each texture tile keeps ~8 segments when
+ * the requested resolution would alias the fine diamond pattern.
+ *
+ * @param geometry - the source geometry (mesh-local space).
+ * @param params - knurl parameters.
+ * @param onProgress - optional callback reporting stage and progress ('texture' | 'subdivide' | 'displace').
+ * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.
+ * @returns the displaced geometry.
+ */
+export async function applyKnurlDisplacement(geometry, params, onProgress, 
+/** External whole-part bounds (defaults to the geometry's own bounds).
+ *  Passing the whole part's bounds keeps texture density consistent with the
+ *  GPU preview, which normalizes against the part bbox while this geometry
+ *  is often only the selected-face subset. */
+boundsOverride) {
+    const { textureHeight, invertDisplacement, refineLength, scaleU, scaleV, mappingMode, offsetU = 0, offsetV = 0, rotation = 0, bottomAngleLimit = 5, topAngleLimit = 0, mappingBlend = 1, seamBandWidth = 0.5, faceWeights = null, } = params;
+    // 1. 加载纹理
+    onProgress?.('texture', 0);
+    let texData;
+    try {
+        texData = await loadKnurlingTexture();
+    }
+    catch (err) {
+        console.error('[KnurlGenerator] Failed to load texture:', err);
+        throw new Error(`Failed to load knurling texture: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    if (!texData) {
+        throw new Error('[KnurlGenerator] No texture data available — TextureSampler port not injected');
+    }
+    // 2. 计算几何体边界（优先使用整块部件包围盒，使密度与预览一致）
+    const bounds = boundsOverride
+        ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }
+        : (() => {
+            geometry.computeBoundingBox();
+            const bb = geometry.boundingBox;
+            return {
+                min: bb.min.clone(),
+                max: bb.max.clone(),
+                size: new THREE.Vector3().subVectors(bb.max, bb.min),
+                center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),
+            };
+        })();
+    // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），
+    //    而实刻是真几何位移，受三角形密度限制。若 refineLength 大于滚花纹理
+    //    的物理周期，网格采样不足会把细密菱形混叠成更低频、更稀疏的图案，
+    //    看起来就比预览"密度低"。这里保证每瓦片至少 ~8 段，只在用户设得太
+    //    粗时才自动加密——绝不会比用户设定的 refineLength 更粗。
+    const maxDim = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6);
+    const knurlPeriod = Math.max(maxDim * scaleU, 1e-6); // 单个纹理瓦片的物理尺寸 (mm)
+    const minRefineForPattern = knurlPeriod / 8;
+    const effectiveRefine = Math.min(refineLength, Math.max(minRefineForPattern, 0.1));
+    // 3. 细分
+    onProgress?.('subdivide', 0);
+    const { geometry: subdivided } = await subdivide(geometry, effectiveRefine, (p) => onProgress?.('subdivide', p), faceWeights);
+    // 4. 位移
+    onProgress?.('displace', 0);
+    const settings = {
+        mappingMode,
+        scaleU,
+        scaleV,
+        offsetU,
+        offsetV,
+        rotation,
+        // 与预览着色器 (knurlPreviewMaterial: h = h - 0.5) 保持一致：
+        // 纹理以中灰为 0 的对称高度图，位移范围 [-amplitude/2, +amplitude/2]。
+        amplitude: (invertDisplacement ? -1 : 1) * textureHeight,
+        symmetricDisplacement: true,
+        bottomAngleLimit,
+        topAngleLimit,
+        mappingBlend,
+        seamBandWidth,
+    };
+    const result = applyDisplacement(subdivided, texData, texData.width, texData.height, settings, bounds, (p) => onProgress?.('displace', p));
+    // 5. 释放中间几何体
+    subdivided.dispose();
+    return result;
+}
+//# sourceMappingURL=KnurlGenerator.js.map

package/dist/mesh/knurl/KnurlGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnurlGenerator.js","sourceRoot":"","sources":["../../../src/mesh/knurl/KnurlGenerator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * KnurlGenerator — 滚花纹理位移管线编排器\n *\n * 完全照搬 stlTexturizer 的管线：subdivide → applyDisplacement。\n * 使用 knurling.jpg 作为位移纹理。\n *\n * 全程在 mesh 局部空间工作，不需要 world matrix 变换。\n */\n\nimport * as THREE from 'three'\nimport { subdivide } from './subdivision'\nimport { applyDisplacement, type DisplacementSettings } from './displacement'\nimport { loadKnurlingTexture, type TextureData } from './textureLoader'\nimport { MODE_TRIPLANAR } from './mapping'\n\n// ── Types ──\n\n/**\n * Knurling texture-displacement parameters: texture height, inversion,\n * subdivision resolution, UV scale/offset/rotation, mapping mode, seam\n * blending, and angle-based face masking limits.\n */\nexport interface KnurlParams {\n  /** 纹理高度 (mm)，默认 0.5 */\n  textureHeight: number\n  /** 反向（内推而非外推），默认 false */\n  invertDisplacement: boolean\n  /** 分辨率 (mm) — 细分后最大边长，默认 1.0 */\n  refineLength: number\n  /** U 缩放，默认 0.15（knurling 专用） */\n  scaleU: number\n  /** V 缩放，默认 0.15 */\n  scaleV: number\n  /** 投影模式，默认 5 (Triplanar) */\n  mappingMode: number\n  /** UV 偏移 U，默认 0 */\n  offsetU?: number\n  /** UV 偏移 V，默认 0 */\n  offsetV?: number\n  /** UV 旋转（度），默认 0 */\n  rotation?: number\n  /** 底面角度遮罩（度），默认 5 */\n  bottomAngleLimit?: number\n  /** 顶面角度遮罩（度），默认 0（不遮罩） */\n  topAngleLimit?: number\n  /** 接缝混合，默认 1 */\n  mappingBlend?: number\n  /** 接缝带宽，默认 0.5 */\n  seamBandWidth?: number\n  /** 面排除权重（By Surface 用），null = 不排除 */\n  faceWeights?: Float32Array | null\n}\n\n/** 包围盒（与 mapping.ts / displacement.ts 的 Bounds 同构） */\nexport interface KnurlBounds {\n  min: THREE.Vector3\n  max: THREE.Vector3\n  size: THREE.Vector3\n  center: THREE.Vector3\n}\n\n/** Default knurling parameters, used for every field the caller leaves unset. */\nexport const KNURL_DEFAULTS: KnurlParams = {\n  textureHeight: 0.5,\n  invertDisplacement: false,\n  refineLength: 1.0,\n  scaleU: 0.15,\n  scaleV: 0.15,\n  mappingMode: MODE_TRIPLANAR,\n  offsetU: 0,\n  offsetV: 0,\n  rotation: 0,\n  bottomAngleLimit: 5,\n  topAngleLimit: 0,\n  mappingBlend: 1,\n  seamBandWidth: 0.5,\n  faceWeights: null,\n}\n\n/**\n * Apply a knurling texture displacement to a geometry, entirely in mesh-local\n * space. Pipeline:\n *   1. Load the knurling texture as ImageData.\n *   2. Subdivide the geometry to the effective refine length.\n *   3. Displace the subdivided vertices along their smoothed normals.\n *\n * The effective refine length is never coarser than the caller's\n * `refineLength`: it is clamped so each texture tile keeps ~8 segments when\n * the requested resolution would alias the fine diamond pattern.\n *\n * @param geometry - the source geometry (mesh-local space).\n * @param params - knurl parameters.\n * @param onProgress - optional callback reporting stage and progress ('texture' | 'subdivide' | 'displace').\n * @param boundsOverride - optional whole-part bounds keeping texture density consistent with the GPU preview.\n * @returns the displaced geometry.\n */\nexport async function applyKnurlDisplacement(\n  geometry: THREE.BufferGeometry,\n  params: KnurlParams,\n  onProgress?: (stage: string, p: number) => void,\n  /** External whole-part bounds (defaults to the geometry's own bounds).\n   *  Passing the whole part's bounds keeps texture density consistent with the\n   *  GPU preview, which normalizes against the part bbox while this geometry\n   *  is often only the selected-face subset. */\n  boundsOverride?: KnurlBounds,\n): Promise<THREE.BufferGeometry> {\n  const {\n    textureHeight,\n    invertDisplacement,\n    refineLength,\n    scaleU,\n    scaleV,\n    mappingMode,\n    offsetU = 0,\n    offsetV = 0,\n    rotation = 0,\n    bottomAngleLimit = 5,\n    topAngleLimit = 0,\n    mappingBlend = 1,\n    seamBandWidth = 0.5,\n    faceWeights = null,\n  } = params\n\n  // 1. 加载纹理\n  onProgress?.('texture', 0)\n  let texData: TextureData | null\n  try {\n    texData = await loadKnurlingTexture()\n  } catch (err) {\n    console.error('[KnurlGenerator] Failed to load texture:', err)\n    throw new Error(`Failed to load knurling texture: ${err instanceof Error ? err.message : String(err)}`, { cause: err })\n  }\n\n  if (!texData) {\n    throw new Error('[KnurlGenerator] No texture data available — TextureSampler port not injected')\n  }\n\n  // 2. 计算几何体边界（优先使用整块部件包围盒，使密度与预览一致）\n  const bounds: KnurlBounds = boundsOverride\n    ? { min: boundsOverride.min, max: boundsOverride.max, size: boundsOverride.size, center: boundsOverride.center }\n    : (() => {\n        geometry.computeBoundingBox()\n        const bb = geometry.boundingBox!\n        return {\n          min: bb.min.clone(),\n          max: bb.max.clone(),\n          size: new THREE.Vector3().subVectors(bb.max, bb.min),\n          center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),\n        }\n      })()\n\n  // 3. 自适应细分：GPU 预览是逐像素 bump（无限分辨率），\n  //    而实刻是真几何位移，受三角形密度限制。若 refineLength 大于滚花纹理\n  //    的物理周期，网格采样不足会把细密菱形混叠成更低频、更稀疏的图案，\n  //    看起来就比预览\"密度低\"。这里保证每瓦片至少 ~8 段，只在用户设得太\n  //    粗时才自动加密——绝不会比用户设定的 refineLength 更粗。\n  const maxDim = Math.max(bounds.size.x, bounds.size.y, bounds.size.z, 1e-6)\n  const knurlPeriod = Math.max(maxDim * scaleU, 1e-6) // 单个纹理瓦片的物理尺寸 (mm)\n  const minRefineForPattern = knurlPeriod / 8\n  const effectiveRefine = Math.min(refineLength, Math.max(minRefineForPattern, 0.1))\n\n  // 3. 细分\n  onProgress?.('subdivide', 0)\n  const { geometry: subdivided } = await subdivide(\n    geometry,\n    effectiveRefine,\n    (p) => onProgress?.('subdivide', p),\n    faceWeights,\n  )\n\n  // 4. 位移\n  onProgress?.('displace', 0)\n  const settings: DisplacementSettings = {\n    mappingMode,\n    scaleU,\n    scaleV,\n    offsetU,\n    offsetV,\n    rotation,\n    // 与预览着色器 (knurlPreviewMaterial: h = h - 0.5) 保持一致：\n    // 纹理以中灰为 0 的对称高度图，位移范围 [-amplitude/2, +amplitude/2]。\n    amplitude: (invertDisplacement ? -1 : 1) * textureHeight,\n    symmetricDisplacement: true,\n    bottomAngleLimit,\n    topAngleLimit,\n    mappingBlend,\n    seamBandWidth,\n  }\n\n  const result = applyDisplacement(\n    subdivided,\n    texData,\n    texData.width,\n    texData.height,\n    settings,\n    bounds,\n    (p) => onProgress?.('displace', p),\n  )\n\n  // 5. 释放中间几何体\n  subdivided.dispose()\n\n  return result\n}\n"]}

package/dist/mesh/knurl/displacement.d.ts

@@ -0,0 +1,53 @@
+/**
+ * displacement.ts — 纹理位移核心，从 stlTexturizer/js/displacement.js 移植为 TS（简化版）。
+ *
+ * 对每个顶点：
+ *   1. 用与 GPU 预览 shader 相同的数学计算 UV（mapping.ts）
+ *   2. 双线性采样灰度 ImageData
+ *   3. 沿平滑法线位移：grey × amplitude
+ *
+ * 简化：去掉了 boundaryFalloff、blendNormalSmoothing、cubic zoneArea 等。
+ * 保留了核心水密性保证：同位置顶点使用相同平滑法线 + 相同位移值。
+ */
+import * as THREE from 'three';
+import { type MappingSettings } from './mapping.js';
+/**
+ * Displacement settings: the mapping settings plus the amplitude, optional
+ * symmetric displacement, and angle-based face-masking limits.
+ */
+export interface DisplacementSettings extends MappingSettings {
+    mappingMode: number;
+    amplitude: number;
+    symmetricDisplacement?: boolean;
+    bottomAngleLimit?: number;
+    topAngleLimit?: number;
+}
+interface Bounds {
+    min: THREE.Vector3;
+    max: THREE.Vector3;
+    center: THREE.Vector3;
+    size: THREE.Vector3;
+}
+interface ImageDataLike {
+    data: Uint8ClampedArray | Uint8Array;
+    width: number;
+    height: number;
+}
+/**
+ * Displace every vertex of a non-indexed BufferGeometry. For each vertex the
+ * UV is computed with the same math as the GPU preview shader, the greyscale
+ * ImageData is sampled bilinearly, and the position is shifted along the
+ * smoothed normal by grey × amplitude.
+ *
+ * @param geometry - the non-indexed source geometry (position + normal attributes).
+ * @param imageData - RGBA pixel data of the height map.
+ * @param imgWidth - texture width in pixels.
+ * @param imgHeight - texture height in pixels.
+ * @param settings - displacement and mapping settings.
+ * @param bounds - overall mesh bounds used to normalize UV coordinates.
+ * @param onProgress - optional callback receiving progress in [0, 1].
+ * @returns a new BufferGeometry with displaced positions and face normals.
+ */
+export declare function applyDisplacement(geometry: THREE.BufferGeometry, imageData: ImageDataLike, imgWidth: number, imgHeight: number, settings: DisplacementSettings, bounds: Bounds, onProgress?: (p: number) => void): THREE.BufferGeometry;
+export {};
+//# sourceMappingURL=displacement.d.ts.map

package/dist/mesh/knurl/displacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displacement.d.ts","sourceRoot":"","sources":["../../../src/mesh/knurl/displacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,WAAW,CAAA;AAEjF;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,MAAM;IACd,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAA;IAClB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;IACrB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAA;CACpB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAC/B,KAAK,CAAC,cAAc,CA8OtB"}