@faicad/faijs 0.13.0

package/dist/api/fai_drill.js

@@ -0,0 +1,230 @@
+/**
+ * stdlib drill — 钻孔库函数
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh。
+ * BREP 路径：OCCT cut（简单孔）或 threadBrep + cut（螺丝孔）。
+ */
+import { cad } from '../mesh/index.js';
+import { drillBrep, solidToShape, matrixToArray, } from '../brep/brep-ops.js';
+import { threadBrep } from './brep-mirror/threadFns.js';
+import { getScrewSpec, threadToPitchMm } from '../primitives/screw/screw-db.js';
+import * as THREE from 'three';
+import { getBackends } from '../runtime-state.js';
+import { fromBrep, brepOf } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { assertPositiveNumber, assertNumber, assertVec3 } from './assert.js';
+import { resolveFaceGeometry } from './topo-resolve.js';
+// ── per-op 参数自校验（Phase 2.2；stdlib 被直接 import 时的防御层） ──
+/**
+ * Validate drill parameters: `diameter` must be a positive number, `position`
+ * (if provided) a vec3, and `depth` (if provided) a number (<= 0 means a through hole).
+ * @param params - the raw drill operation parameters.
+ */
+export function assertDrillParams(params) {
+    assertPositiveNumber(params.diameter, 'drill.diameter');
+    if (params.position !== undefined && params.position !== null) {
+        assertVec3(params.position, 'drill.position');
+    }
+    if (params.depth !== undefined && params.depth !== null) {
+        assertNumber(params.depth, 'drill.depth');
+    }
+}
+/** 世界坐标 → 几何体局部坐标（含单位缩放）。 */
+function worldToLocalPosition(worldPos, partTransform) {
+    const offset = partTransform?.position;
+    if (!offset)
+        return worldPos;
+    const scale = partTransform?.scale;
+    if (scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1)) {
+        return [
+            (worldPos[0] - offset[0]) / scale[0],
+            (worldPos[1] - offset[1]) / scale[1],
+            (worldPos[2] - offset[2]) / scale[2],
+        ];
+    }
+    return [
+        worldPos[0] - offset[0],
+        worldPos[1] - offset[1],
+        worldPos[2] - offset[2],
+    ];
+}
+/** 解析 direction 枚举 → 钻孔方向向量。 */
+function resolveDirection(params, faceNormal) {
+    const directionEnum = params.direction ?? 'normal';
+    if (directionEnum === 'normal')
+        return faceNormal;
+    if (directionEnum === 'x')
+        return [-1, 0, 0];
+    if (directionEnum === 'y')
+        return [0, -1, 0];
+    if (directionEnum === 'z')
+        return [0, 0, -1];
+    return faceNormal;
+}
+/**
+ * 面法向派生（§6.2）：钻孔轴向是「点击点的真实面法向」——曲面（圆柱面等）上
+ * 仅凭 FaceTopoRef 的单一 hint 法向无法还原点击点的径向方向（引擎无 点→曲面
+ * 投影 API），故轴向优先使用宿主捕获的 `faceNormal` 快照（与 position 同为点击
+ * 快照）；`face: FaceTopoRef` 作为持久化身份引用（跨重放追踪），仅在无
+ * `faceNormal` 的历史/手写脚本时才按其派生的法向兜底。
+ *
+ * @param input - the target geometry (used to resolve the face ref).
+ * @param params - raw drill params.
+ * @returns the face normal the drill axis uses.
+ */
+function faceNormalFrom(input, params) {
+    const faceNormal = params.faceNormal;
+    if (faceNormal && Array.isArray(faceNormal)) {
+        return faceNormal;
+    }
+    const face = params.face;
+    if (face && typeof face === 'object' && face.kind === 'face') {
+        const kernel = getBackends().kernel.brep;
+        const geom = resolveFaceGeometry(kernel, input, face);
+        return geom.normal;
+    }
+    return [0, 0, 1];
+}
+/** BREP 螺丝孔：底孔（圆柱 cut）+ 内螺纹（threadBrep + cut）。 */
+function screwHoleBrep(kernel, upstreamSolid, params, direction, faceNormal, localPosition) {
+    const diameter = params.diameter;
+    const depth = params.depth;
+    // 1. 底孔（圆柱 cut）
+    const result = drillBrep(kernel, upstreamSolid, {
+        diameter,
+        depth,
+        position: localPosition,
+        direction,
+        faceNormal,
+        holeType: 'simple',
+    });
+    // 2. 螺纹（内螺纹 ridge，inward=true）
+    const screwSystem = params.screwSystem ?? 'metric';
+    const screwSpecIdx = params.screwSpecIdx ?? 4; // M5 default（与 mesh 路径一致）
+    const screwThread = params.screwThread ?? 'coarse';
+    const spec = getScrewSpec(screwSystem, screwSpecIdx);
+    const pitch = threadToPitchMm(screwSystem, spec, screwThread);
+    if (pitch > 0) {
+        const threadSolid = threadBrep(kernel, {
+            radius: diameter / 2,
+            pitch,
+            height: depth > 0 ? depth : 20,
+            inward: true,
+        });
+        const dir = new THREE.Vector3(...direction).normalize();
+        const fn = new THREE.Vector3(...faceNormal);
+        if (dir.dot(fn) > 0)
+            dir.negate();
+        const zAxis = new THREE.Vector3(0, 0, 1);
+        const quat = new THREE.Quaternion().setFromUnitVectors(zAxis, dir);
+        const rotMatrix = new THREE.Matrix4().makeRotationFromQuaternion(quat);
+        const transMatrix = new THREE.Matrix4().makeTranslation(localPosition[0], localPosition[1], localPosition[2]);
+        const fullMatrix = new THREE.Matrix4().multiplyMatrices(transMatrix, rotMatrix);
+        const positionedThread = kernel.transform(threadSolid, matrixToArray(fullMatrix));
+        kernel.release(threadSolid);
+        const finalResult = kernel.cut(result, positionedThread);
+        kernel.release(result);
+        kernel.release(positionedThread);
+        return finalResult;
+    }
+    return result;
+}
+/** BREP 路径：OCCT cut（简单孔）或 threadBrep + cut（螺丝孔）。 */
+function drillBrepPath(input, params) {
+    const kernel = getBackends().kernel.brep;
+    if (!kernel)
+        throw new Error('[stdlib/drill] no OCCT kernel');
+    const inputSolid = brepOf(input);
+    if (!inputSolid)
+        throw new Error('[stdlib/drill] input is not BREP');
+    const faceNormal = faceNormalFrom(input, params);
+    const direction = resolveDirection(params, faceNormal);
+    const holeType = params.holeType;
+    // 世界坐标 → 局部坐标（cad.load 返回的几何体在原始文件坐标系中）
+    const partTransform = getBackends().config.partTransform;
+    const localPosition = worldToLocalPosition(params.position, partTransform);
+    let resultSolid;
+    if (holeType === 'screw') {
+        resultSolid = screwHoleBrep(kernel, inputSolid, params, direction, faceNormal, localPosition);
+    }
+    else {
+        resultSolid = drillBrep(kernel, inputSolid, {
+            diameter: params.diameter,
+            depth: params.depth,
+            position: localPosition,
+            direction,
+            faceNormal,
+            holeType: 'simple',
+        });
+    }
+    return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid });
+}
+/** mesh 路径：manifold-3d mesh-CSG。 */
+async function drillMeshPath(input, params) {
+    const faceNormal = faceNormalFrom(input, params);
+    const direction = resolveDirection(params, faceNormal);
+    const partTransform = getBackends().config.partTransform;
+    const localPos = worldToLocalPosition(params.position, partTransform);
+    const scale = partTransform?.scale;
+    const unitScale = scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1)
+        ? scale[0]
+        : 1;
+    return cad.fai_drill(input, {
+        diameter: params.diameter / unitScale,
+        depth: params.depth / unitScale,
+        type: params.depth > 0 ? 'blind' : 'through',
+        position: localPos,
+        direction,
+        faceNormal,
+        tolerance: params.tolerance !== undefined ? params.tolerance / unitScale : undefined,
+        holeType: params.holeType,
+        screwSystem: params.screwSystem,
+        screwSpecIdx: params.screwSpecIdx,
+        screwThread: params.screwThread,
+        screwHead: params.screwHead,
+    });
+}
+/**
+ * 在几何体上钻孔（CSG 减除）。depth=0 为通孔，>0 为盲孔。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name fai_drill
+ * @deprecated `fai_` 前缀 op 是 ../3d_editor 项目特有的操作，不属于 faijs 平台面；将来会迁往该项目并从 faijs 删除。新代码请勿使用。
+ * @note 键名以本表为准：`type: 'through'|'blind'` 与 `direction` 为向量的旧素材是无效写法——孔型由 `depth`（0=通孔）推导，`direction` 是 'normal'|'x'|'y'|'z' 枚举。
+ * @returns Shape 钻孔后的几何。
+ * @param input - 目标几何。type:Shape required:true
+ * @param params.diameter - 孔径（mm）。type:number required:true
+ * @param params.depth - 孔深（mm）；0 = 通孔，> 0 = 盲孔。type:number 默认 0
+ * @param params.holeType - 孔类型：simple 简单孔 / screw 螺丝孔。type:'simple' | 'screw' 默认 'simple'
+ * @param params.direction - 钻孔轴向（normal 表示沿面法向）。type:'normal' | 'x' | 'y' | 'z' 默认 'normal'
+ * @param params.position - 孔心位置。type:[x,y,z] 默认 原点
+ * @param params.face - 面引用（§6.2 新形态：`FaceTopoRef`，执行期按输入 Shape 解析派生法向；优先于 `faceNormal`）。type:FaceTopoRef
+ * @param params.faceNormal - 面法向（决定朝向；历史兜底，§6.2 起宿主不再写，改由 `face` 解析）。type:[x,y,z] 默认 [0,0,1]
+ * @param params.tolerance - 公差（mm）。type:number 默认 0.3
+ * @param params.screwSystem - 螺丝孔制式（holeType='screw' 时用）。type:'metric' | 'imperial' 默认 'metric'
+ * @param params.screwSpecIdx - 螺丝规格索引（holeType='screw' 时用；4 → M5）。type:number 默认 4
+ * @param params.screwThread - 螺丝螺纹类型。type:'coarse' | 'fine' | 'custom' 默认 'coarse'
+ * @param params.screwHead - 螺丝头型。type:'hex' | 'chc' | 'none' 默认 'none'
+ * @example
+ * const p = await cad.fai_drill(part0, { diameter: 5 })
+ * const p = await cad.fai_drill(part0, { diameter: 5, depth: 3 })
+ * const p = await cad.fai_drill(part0, { diameter: 5.2, depth: 8, holeType: 'screw', screwSystem: 'metric', screwSpecIdx: 4, screwThread: 'coarse', screwHead: 'none' })
+  */
+export const fai_drill = defineOp({
+    mesh: async (input, params) => {
+        if (!input)
+            throw new Error('[stdlib/drill] no input geometry');
+        assertDrillParams(params);
+        return drillMeshPath(input, params);
+    },
+    brep: (input, params) => {
+        if (!input)
+            throw new Error('[stdlib/drill] no input geometry');
+        assertDrillParams(params);
+        return drillBrepPath(input, params);
+    },
+});
+//# sourceMappingURL=fai_drill.js.map

package/dist/api/fai_drill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_drill.js","sourceRoot":"","sources":["../../src/api/fai_drill.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib drill — 钻孔库函数\n *\n *\n * dispatchPath 静态判定 brep/mesh。\n * BREP 路径：OCCT cut（简单孔）或 threadBrep + cut（螺丝孔）。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { cad } from '../mesh'\nimport {\n  drillBrep,\n  solidToShape,\n  matrixToArray,\n} from '../brep/brep-ops'\nimport { threadBrep } from './brep-mirror/threadFns'\nimport { getScrewSpec, threadToPitchMm } from '../primitives/screw/screw-db'\nimport * as THREE from 'three'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep, brepOf } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { assertPositiveNumber, assertNumber, assertVec3 } from './assert'\nimport type { FaceTopoRef } from '../topology/naming'\nimport { resolveFaceGeometry } from './topo-resolve'\n\n// ── per-op 参数自校验（Phase 2.2；stdlib 被直接 import 时的防御层） ──\n\n/**\n * Validate drill parameters: `diameter` must be a positive number, `position`\n * (if provided) a vec3, and `depth` (if provided) a number (<= 0 means a through hole).\n * @param params - the raw drill operation parameters.\n */\nexport function assertDrillParams(params: Record<string, unknown>): void {\n  assertPositiveNumber(params.diameter, 'drill.diameter')\n  if (params.position !== undefined && params.position !== null) {\n    assertVec3(params.position, 'drill.position')\n  }\n  if (params.depth !== undefined && params.depth !== null) {\n    assertNumber(params.depth, 'drill.depth')\n  }\n}\n\n/** 世界坐标 → 几何体局部坐标（含单位缩放）。 */\nfunction worldToLocalPosition(\n  worldPos: [number, number, number],\n  partTransform: { position: [number, number, number]; scale?: [number, number, number] } | undefined,\n): [number, number, number] {\n  const offset = partTransform?.position\n  if (!offset) return worldPos\n  const scale = partTransform?.scale\n  if (scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1)) {\n    return [\n      (worldPos[0] - offset[0]) / scale[0],\n      (worldPos[1] - offset[1]) / scale[1],\n      (worldPos[2] - offset[2]) / scale[2],\n    ]\n  }\n  return [\n    worldPos[0] - offset[0],\n    worldPos[1] - offset[1],\n    worldPos[2] - offset[2],\n  ]\n}\n\n/** 解析 direction 枚举 → 钻孔方向向量。 */\nfunction resolveDirection(params: Record<string, unknown>, faceNormal: Vec3): Vec3 {\n  const directionEnum = (params.direction as string | undefined) ?? 'normal'\n  if (directionEnum === 'normal') return faceNormal\n  if (directionEnum === 'x') return [-1, 0, 0]\n  if (directionEnum === 'y') return [0, -1, 0]\n  if (directionEnum === 'z') return [0, 0, -1]\n  return faceNormal\n}\n\n/**\n * 面法向派生（§6.2）：钻孔轴向是「点击点的真实面法向」——曲面（圆柱面等）上\n * 仅凭 FaceTopoRef 的单一 hint 法向无法还原点击点的径向方向（引擎无 点→曲面\n * 投影 API），故轴向优先使用宿主捕获的 `faceNormal` 快照（与 position 同为点击\n * 快照）；`face: FaceTopoRef` 作为持久化身份引用（跨重放追踪），仅在无\n * `faceNormal` 的历史/手写脚本时才按其派生的法向兜底。\n *\n * @param input - the target geometry (used to resolve the face ref).\n * @param params - raw drill params.\n * @returns the face normal the drill axis uses.\n */\nfunction faceNormalFrom(input: Shape, params: Record<string, unknown>): Vec3 {\n  const faceNormal = params.faceNormal as Vec3 | undefined\n  if (faceNormal && Array.isArray(faceNormal)) {\n    return faceNormal\n  }\n  const face = params.face as FaceTopoRef | undefined\n  if (face && typeof face === 'object' && face.kind === 'face') {\n    const kernel = getBackends().kernel.brep as BrepEngineApi | null\n    const geom = resolveFaceGeometry(kernel, input, face)\n    return geom.normal\n  }\n  return [0, 0, 1]\n}\n\n/** BREP 螺丝孔：底孔（圆柱 cut）+ 内螺纹（threadBrep + cut）。 */\nfunction screwHoleBrep(\n  kernel: BrepEngineApi,\n  upstreamSolid: BrepHandle,\n  params: Record<string, unknown>,\n  direction: Vec3,\n  faceNormal: Vec3,\n  localPosition: [number, number, number],\n): BrepHandle {\n  const diameter = params.diameter as number\n  const depth = params.depth as number\n  // 1. 底孔（圆柱 cut）\n  const result = drillBrep(kernel, upstreamSolid, {\n    diameter,\n    depth,\n    position: localPosition,\n    direction,\n    faceNormal,\n    holeType: 'simple',\n  })\n\n  // 2. 螺纹（内螺纹 ridge，inward=true）\n  const screwSystem = (params.screwSystem as 'metric' | 'imperial') ?? 'metric'\n  const screwSpecIdx = (params.screwSpecIdx as number) ?? 4 // M5 default（与 mesh 路径一致）\n  const screwThread = (params.screwThread as 'coarse' | 'fine' | 'custom') ?? 'coarse'\n  const spec = getScrewSpec(screwSystem, screwSpecIdx)\n  const pitch = threadToPitchMm(screwSystem, spec, screwThread)\n\n  if (pitch > 0) {\n    const threadSolid = threadBrep(kernel, {\n      radius: diameter / 2,\n      pitch,\n      height: depth > 0 ? depth : 20,\n      inward: true,\n    })\n    const dir = new THREE.Vector3(...direction).normalize()\n    const fn = new THREE.Vector3(...faceNormal)\n    if (dir.dot(fn) > 0) dir.negate()\n\n    const zAxis = new THREE.Vector3(0, 0, 1)\n    const quat = new THREE.Quaternion().setFromUnitVectors(zAxis, dir)\n    const rotMatrix = new THREE.Matrix4().makeRotationFromQuaternion(quat)\n    const transMatrix = new THREE.Matrix4().makeTranslation(localPosition[0], localPosition[1], localPosition[2])\n    const fullMatrix = new THREE.Matrix4().multiplyMatrices(transMatrix, rotMatrix)\n\n    const positionedThread = kernel.transform(threadSolid, matrixToArray(fullMatrix))\n    kernel.release(threadSolid)\n\n    const finalResult = kernel.cut(result, positionedThread)\n    kernel.release(result)\n    kernel.release(positionedThread)\n    return finalResult\n  }\n\n  return result\n}\n\n/** BREP 路径：OCCT cut（简单孔）或 threadBrep + cut（螺丝孔）。 */\nfunction drillBrepPath(input: Shape, params: Record<string, unknown>): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/drill] no OCCT kernel')\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (!inputSolid) throw new Error('[stdlib/drill] input is not BREP')\n\n  const faceNormal = faceNormalFrom(input, params)\n  const direction = resolveDirection(params, faceNormal)\n  const holeType = params.holeType as 'simple' | 'screw' | undefined\n\n  // 世界坐标 → 局部坐标（cad.load 返回的几何体在原始文件坐标系中）\n  const partTransform = getBackends().config.partTransform\n  const localPosition = worldToLocalPosition(params.position as [number, number, number], partTransform)\n\n  let resultSolid: BrepHandle\n  if (holeType === 'screw') {\n    resultSolid = screwHoleBrep(kernel, inputSolid, params, direction, faceNormal, localPosition)\n  } else {\n    resultSolid = drillBrep(kernel, inputSolid, {\n      diameter: params.diameter as number,\n      depth: params.depth as number,\n      position: localPosition,\n      direction,\n      faceNormal,\n      holeType: 'simple',\n    })\n  }\n\n  return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid })\n}\n\n/** mesh 路径：manifold-3d mesh-CSG。 */\nasync function drillMeshPath(input: Shape, params: Record<string, unknown>): Promise<Shape> {\n  const faceNormal = faceNormalFrom(input, params)\n  const direction = resolveDirection(params, faceNormal)\n  const partTransform = getBackends().config.partTransform\n  const localPos = worldToLocalPosition(params.position as [number, number, number], partTransform)\n\n  const scale = partTransform?.scale\n  const unitScale = scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1)\n    ? scale[0]\n    : 1\n\n  return cad.fai_drill(input, {\n    diameter: (params.diameter as number) / unitScale,\n    depth: (params.depth as number) / unitScale,\n    type: (params.depth as number) > 0 ? 'blind' : 'through',\n    position: localPos,\n    direction,\n    faceNormal,\n    tolerance: (params.tolerance as number | undefined) !== undefined ? (params.tolerance as number) / unitScale : undefined,\n    holeType: params.holeType as 'simple' | 'screw' | undefined,\n    screwSystem: params.screwSystem as string | undefined,\n    screwSpecIdx: params.screwSpecIdx as number | undefined,\n    screwThread: params.screwThread as string | undefined,\n    screwHead: params.screwHead as string | undefined,\n  })\n}\n\n/**\n * 在几何体上钻孔（CSG 减除）。depth=0 为通孔，>0 为盲孔。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name fai_drill\n * @deprecated `fai_` 前缀 op 是 ../3d_editor 项目特有的操作，不属于 faijs 平台面；将来会迁往该项目并从 faijs 删除。新代码请勿使用。\n * @note 键名以本表为准：`type: 'through'|'blind'` 与 `direction` 为向量的旧素材是无效写法——孔型由 `depth`（0=通孔）推导，`direction` 是 'normal'|'x'|'y'|'z' 枚举。\n * @returns Shape 钻孔后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.diameter - 孔径（mm）。type:number required:true\n * @param params.depth - 孔深（mm）；0 = 通孔，> 0 = 盲孔。type:number 默认 0\n * @param params.holeType - 孔类型：simple 简单孔 / screw 螺丝孔。type:'simple' | 'screw' 默认 'simple'\n * @param params.direction - 钻孔轴向（normal 表示沿面法向）。type:'normal' | 'x' | 'y' | 'z' 默认 'normal'\n * @param params.position - 孔心位置。type:[x,y,z] 默认 原点\n * @param params.face - 面引用（§6.2 新形态：`FaceTopoRef`，执行期按输入 Shape 解析派生法向；优先于 `faceNormal`）。type:FaceTopoRef\n * @param params.faceNormal - 面法向（决定朝向；历史兜底，§6.2 起宿主不再写，改由 `face` 解析）。type:[x,y,z] 默认 [0,0,1]\n * @param params.tolerance - 公差（mm）。type:number 默认 0.3\n * @param params.screwSystem - 螺丝孔制式（holeType='screw' 时用）。type:'metric' | 'imperial' 默认 'metric'\n * @param params.screwSpecIdx - 螺丝规格索引（holeType='screw' 时用；4 → M5）。type:number 默认 4\n * @param params.screwThread - 螺丝螺纹类型。type:'coarse' | 'fine' | 'custom' 默认 'coarse'\n * @param params.screwHead - 螺丝头型。type:'hex' | 'chc' | 'none' 默认 'none'\n * @example\n * const p = await cad.fai_drill(part0, { diameter: 5 })\n * const p = await cad.fai_drill(part0, { diameter: 5, depth: 3 })\n * const p = await cad.fai_drill(part0, { diameter: 5.2, depth: 8, holeType: 'screw', screwSystem: 'metric', screwSpecIdx: 4, screwThread: 'coarse', screwHead: 'none' })\n  */\nexport const fai_drill = defineOp({\n  mesh: async (input: Shape, params: Record<string, unknown>) => {\n    if (!input) throw new Error('[stdlib/drill] no input geometry')\n    assertDrillParams(params)\n    return drillMeshPath(input, params)\n  },\n  brep: (input: Shape, params: Record<string, unknown>) => {\n    if (!input) throw new Error('[stdlib/drill] no input geometry')\n    assertDrillParams(params)\n    return drillBrepPath(input, params)\n  },\n})\n"]}

package/dist/api/fai_extrude.d.ts

@@ -0,0 +1,36 @@
+/**
+ * stdlib extrude — 拉伸库函数
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
+ */
+import type { Shape } from '../mesh/types.js';
+/**
+ * Validate extrude parameters: `length` must be a positive number.
+ * @param params - the raw extrude operation parameters.
+ */
+export declare function assertExtrudeParams(params: Record<string, unknown>): void;
+/**
+ * 沿法向拉伸几何。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name fai_extrude
+ * @deprecated `fai_` 前缀 op 是 ../3d_editor 项目特有的操作，不属于 faijs 平台面；将来会迁往该项目并从 faijs 删除。新代码请勿使用。
+ * @returns Shape 拉伸后的几何。
+ * @param input - 目标几何。type:Shape required:true
+ * @param params.length - 总拉伸量（mm）。type:number required:true
+ * @param params.mode - 拉伸方向：centered 双向各一半 / forward 正向 / backward 反向。type:'centered' | 'forward' | 'backward' 默认 'centered'
+ * @param params.normal - 拉伸方向法向。type:[x,y,z] 默认 当前面法向 [0,0,1]
+ * @param params.originOffset - 切面在法向上的偏移。type:number 默认 0
+ * @param params.space - 坐标空间声明。type:'local' | 'world'
+ * @example
+ * const p = await cad.fai_extrude(part0, { length: 10 })
+ * const p = await cad.fai_extrude(part0, { length: 10, mode: 'forward' })
+ * const p = await cad.fai_extrude(part0, { length: 10, normal: [0,0,1], originOffset: 2 })
+  */
+export declare const fai_extrude: ((input: Shape, params: Record<string, unknown>) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=fai_extrude.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fai_extrude.d.ts","sourceRoot":"","sources":["../../src/api/fai_extrude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,eAAe,CAAA;AAYhD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEzE;AAqBD;;;;;;;;;;;;;;;;;;;IAmBI;AACJ,eAAO,MAAM,WAAW;;CAgBtB,CAAA"}

package/dist/api/fai_extrude.js

@@ -0,0 +1,78 @@
+/**
+ * stdlib extrude — 拉伸库函数
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
+ */
+import { cad } from '../mesh/index.js';
+import { extrudeBrep, solidToShape } from '../brep/brep-ops.js';
+import { getBackends } from '../runtime-state.js';
+import { fromBrep, brepOf } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { assertPositiveNumber } from './assert.js';
+// ── per-op 参数自校验（Phase 2.2；stdlib 被直接 import 时的防御层） ──
+/**
+ * Validate extrude parameters: `length` must be a positive number.
+ * @param params - the raw extrude operation parameters.
+ */
+export function assertExtrudeParams(params) {
+    assertPositiveNumber(params.length, 'extrude.length');
+}
+/** BREP 路径：OCCT extrude + 三角化 + fromBrep 登记。 */
+function extrudeBrepPath(input, params) {
+    const kernel = getBackends().kernel.brep;
+    if (!kernel)
+        throw new Error('[stdlib/extrude] no OCCT kernel');
+    const inputSolid = brepOf(input);
+    if (!inputSolid)
+        throw new Error('[stdlib/extrude] input is not BREP');
+    const normal = params.normal ?? [0, 0, 1];
+    const originOffset = params.originOffset ?? 0;
+    const resultSolid = extrudeBrep(kernel, inputSolid, {
+        normal,
+        originOffset,
+        length: params.length,
+        mode: params.mode,
+    });
+    return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid });
+}
+/**
+ * 沿法向拉伸几何。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name fai_extrude
+ * @deprecated `fai_` 前缀 op 是 ../3d_editor 项目特有的操作，不属于 faijs 平台面；将来会迁往该项目并从 faijs 删除。新代码请勿使用。
+ * @returns Shape 拉伸后的几何。
+ * @param input - 目标几何。type:Shape required:true
+ * @param params.length - 总拉伸量（mm）。type:number required:true
+ * @param params.mode - 拉伸方向：centered 双向各一半 / forward 正向 / backward 反向。type:'centered' | 'forward' | 'backward' 默认 'centered'
+ * @param params.normal - 拉伸方向法向。type:[x,y,z] 默认 当前面法向 [0,0,1]
+ * @param params.originOffset - 切面在法向上的偏移。type:number 默认 0
+ * @param params.space - 坐标空间声明。type:'local' | 'world'
+ * @example
+ * const p = await cad.fai_extrude(part0, { length: 10 })
+ * const p = await cad.fai_extrude(part0, { length: 10, mode: 'forward' })
+ * const p = await cad.fai_extrude(part0, { length: 10, normal: [0,0,1], originOffset: 2 })
+  */
+export const fai_extrude = defineOp({
+    mesh: async (input, params) => {
+        if (!input)
+            throw new Error('[stdlib/extrude] no input geometry');
+        assertExtrudeParams(params);
+        return cad.fai_extrude(input, {
+            normal: params.normal ?? [0, 0, 1],
+            originOffset: params.originOffset ?? 0,
+            length: params.length,
+            mode: params.mode,
+        });
+    },
+    brep: (input, params) => {
+        if (!input)
+            throw new Error('[stdlib/extrude] no input geometry');
+        assertExtrudeParams(params);
+        return extrudeBrepPath(input, params);
+    },
+});
+//# sourceMappingURL=fai_extrude.js.map

package/dist/api/fai_extrude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_extrude.js","sourceRoot":"","sources":["../../src/api/fai_extrude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAI/C,wDAAwD;AAExD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA+B;IACjE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;AACvD,CAAC;AAED,gDAAgD;AAChD,SAAS,eAAe,CAAC,KAAY,EAAE,MAA+B;IACpE,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAA4B,CAAA;IAChE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAA;IAC1D,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAEtE,MAAM,MAAM,GAAI,MAAM,CAAC,MAA2B,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/D,MAAM,YAAY,GAAI,MAAM,CAAC,YAAmC,IAAI,CAAC,CAAA;IACrE,MAAM,WAAW,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE;QAClD,MAAM;QACN,YAAY;QACZ,MAAM,EAAE,MAAM,CAAC,MAAgB;QAC/B,IAAI,EAAE,MAAM,CAAC,IAAuD;KACrE,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;;;;IAmBI;AACJ,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,KAAK,EAAE,KAAY,EAAE,MAA+B,EAAE,EAAE;QAC5D,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACjE,mBAAmB,CAAC,MAAM,CAAC,CAAA;QAC3B,OAAO,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE;YAC5B,MAAM,EAAG,MAAM,CAAC,MAA2B,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACxD,YAAY,EAAG,MAAM,CAAC,YAAmC,IAAI,CAAC;YAC9D,MAAM,EAAE,MAAM,CAAC,MAAgB;YAC/B,IAAI,EAAE,MAAM,CAAC,IAAuD;SACrE,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,EAAE,CAAC,KAAY,EAAE,MAA+B,EAAE,EAAE;QACtD,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;QACjE,mBAAmB,CAAC,MAAM,CAAC,CAAA;QAC3B,OAAO,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACvC,CAAC;CACF,CAAC,CAAA","sourcesContent":["/**\n * stdlib extrude — 拉伸库函数\n *\n *\n * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { cad } from '../mesh'\nimport { extrudeBrep, solidToShape } from '../brep/brep-ops'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep, brepOf } from '../shape'\nimport { defineOp } from '../sdk'\nimport { assertPositiveNumber } from './assert'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n// ── per-op 参数自校验（Phase 2.2；stdlib 被直接 import 时的防御层） ──\n\n/**\n * Validate extrude parameters: `length` must be a positive number.\n * @param params - the raw extrude operation parameters.\n */\nexport function assertExtrudeParams(params: Record<string, unknown>): void {\n  assertPositiveNumber(params.length, 'extrude.length')\n}\n\n/** BREP 路径：OCCT extrude + 三角化 + fromBrep 登记。 */\nfunction extrudeBrepPath(input: Shape, params: Record<string, unknown>): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/extrude] no OCCT kernel')\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (!inputSolid) throw new Error('[stdlib/extrude] input is not BREP')\n\n  const normal = (params.normal as Vec3 | undefined) ?? [0, 0, 1]\n  const originOffset = (params.originOffset as number | undefined) ?? 0\n  const resultSolid = extrudeBrep(kernel, inputSolid, {\n    normal,\n    originOffset,\n    length: params.length as number,\n    mode: params.mode as 'centered' | 'forward' | 'backward' | undefined,\n  })\n\n  return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid })\n}\n\n/**\n * 沿法向拉伸几何。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name fai_extrude\n * @deprecated `fai_` 前缀 op 是 ../3d_editor 项目特有的操作，不属于 faijs 平台面；将来会迁往该项目并从 faijs 删除。新代码请勿使用。\n * @returns Shape 拉伸后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.length - 总拉伸量（mm）。type:number required:true\n * @param params.mode - 拉伸方向：centered 双向各一半 / forward 正向 / backward 反向。type:'centered' | 'forward' | 'backward' 默认 'centered'\n * @param params.normal - 拉伸方向法向。type:[x,y,z] 默认 当前面法向 [0,0,1]\n * @param params.originOffset - 切面在法向上的偏移。type:number 默认 0\n * @param params.space - 坐标空间声明。type:'local' | 'world'\n * @example\n * const p = await cad.fai_extrude(part0, { length: 10 })\n * const p = await cad.fai_extrude(part0, { length: 10, mode: 'forward' })\n * const p = await cad.fai_extrude(part0, { length: 10, normal: [0,0,1], originOffset: 2 })\n  */\nexport const fai_extrude = defineOp({\n  mesh: async (input: Shape, params: Record<string, unknown>) => {\n    if (!input) throw new Error('[stdlib/extrude] no input geometry')\n    assertExtrudeParams(params)\n    return cad.fai_extrude(input, {\n      normal: (params.normal as Vec3 | undefined) ?? [0, 0, 1],\n      originOffset: (params.originOffset as number | undefined) ?? 0,\n      length: params.length as number,\n      mode: params.mode as 'centered' | 'forward' | 'backward' | undefined,\n    })\n  },\n  brep: (input: Shape, params: Record<string, unknown>) => {\n    if (!input) throw new Error('[stdlib/extrude] no input geometry')\n    assertExtrudeParams(params)\n    return extrudeBrepPath(input, params)\n  },\n})\n"]}

package/dist/api/fai_split.d.ts

@@ -0,0 +1,46 @@
+/**
+ * stdlib split — 分割库函数（返回具名对象 { front, back }）
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，双输出以具名对象返回（替代 outputCache 多输出写入）。
+ */
+import type { Shape } from '../mesh/types.js';
+/**
+ * 分割几何，返回具名对象 { front, back } 两个独立零件。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual warn
+ * @name fai_split
+ * @deprecated `fai_` 前缀 op 是 ../3d_editor 项目特有的操作，不属于 faijs 平台面；将来会迁往该项目并从 faijs 删除。新代码请勿使用。
+ * @returns { front: Shape; back: Shape } 必须用解构 `const { front: partA, back: partB } = await cad.fai_split(...)` 取出两个零件。
+ * @param input - 目标几何。type:Shape required:true
+ * @param params.cutMode - 切割模式。type:'plane' | 'dovetail' | 'dowel' | 'tenon' | 'straight-tenon' | 'straight' 默认 'plane'
+ * @param params.normal - 切割面法向。type:[x,y,z] 默认 [0,0,1]
+ * @param params.offset - 切割面沿法向偏移（过 bbCenter）。type:number 默认 0
+ * @param params.inPlaneAngleDeg - 切割面面内旋转角（度）。type:number 默认 0
+ * @param params.bbCenter - 包围盒中心（缺省自动推导）。type:[x,y,z] 默认 自动
+ * @param params.bboxSize - 包围盒尺寸（缺省自动推导）。type:[x,y,z] 默认 自动
+ * @param params.applyExplode - 是否将两侧沿法向分离位移（bbox 对角线 2% + 榫卯深度一半）。type:boolean 默认 true
+ * @param params.grooveDepth - 燕尾槽深（cutMode='dovetail'）。type:number
+ * @param params.grooveWidth - 燕尾槽宽（cutMode='dovetail'）。type:number
+ * @param params.grooveDepthTolerance - 燕尾槽深公差。type:number
+ * @param params.grooveWidthTolerance - 燕尾槽宽公差。type:number
+ * @param params.grooveFlapsAngle - 燕尾槽翼角（度）。type:number
+ * @param params.dowelDiameter - 定位销直径（cutMode='dowel'）。type:number
+ * @param params.dowelDiameterTolerance - 定位销直径公差。type:number
+ * @param params.dowelHeight - 定位销高度。type:number
+ * @param params.dowelHeightTolerance - 定位销高度公差。type:number
+ * @param params.tenonSideLength - 直榫边长（cutMode='tenon'/'straight-tenon'）。type:number
+ * @param params.tenonSideLengthTolerance - 直榫边长公差。type:number
+ * @param params.tenonHeight - 直榫高度。type:number
+ * @param params.tenonHeightTolerance - 直榫高度公差。type:number
+ * @param params.selectedSections - 参与榫卯的截面下标。type:number[]
+ * @note 切割面统一用 `normal`/`offset`/`inPlaneAngleDeg` 描述；早期文本层曾与执行层键名断裂（planeRotation/planePosition），已修并统一为上述键名。
+ * @example
+ * const { front: part1, back: part2 } = await cad.fai_split(part0, { normal: [0, 0, 1], offset: 5, cutMode: 'dovetail', grooveDepth: 3, grooveWidth: 5 })
+  */
+export declare const fai_split: ((input: Shape, params?: Record<string, unknown> | undefined) => Promise<Record<string, Shape>>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=fai_split.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fai_split.d.ts","sourceRoot":"","sources":["../../src/api/fai_split.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAQ,MAAM,eAAe,CAAA;AA+NhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkCI;AACJ,eAAO,MAAM,SAAS;;CAgBpB,CAAA"}