@faicad/faijs 0.33.2 → 0.35.2

package/dist/extra/ops/fai_split.js

@@ -0,0 +1,235 @@
+/**
+ * faijs-extra split — 分割库函数（返回具名对象 { front, back }）
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，双输出以具名对象返回（替代 outputCache 多输出写入）。
+ */
+import { splitWithParams as meshSplitWithParams } from '../mesh/fai_split.js';
+import { bboxCenter, boundingBox } from '../../mesh/query.js';
+import { splitBrep, solidToShape, translateBrep, } from '../../brep/brep-ops.js';
+import { dovetailBooleanSplitBrep, dowelOrTenonBooleanSplitBrep, } from '../../api/brep-operations/joinery-brep.js';
+import { computeBasisFromNormal } from '../mesh/fai_split.js';
+import { getBrepApi } from '../../brep/handle-bridge.js';
+import { solid, fromBrep, brepOf } from '../../shape.js';
+import { defineOp } from '../../sdk.js';
+import { assertNonZeroVec3 } from '../../api/assert.js';
+/** BREP 路径：OCCT 平面/榫卯分割 + 分离位移。 */
+function splitBrepPath(input, params) {
+    const kernel = getBrepApi();
+    const inputSolid = brepOf(input);
+    if (inputSolid === undefined)
+        throw new Error('[extra/split] input is not BREP');
+    const cutMode = params.cutMode ?? 'plane';
+    const normal = params.normal ?? [0, 0, 1];
+    const offset = typeof params.offset === 'number' ? params.offset : 0;
+    const inPlaneAngle = typeof params.inPlaneAngle === 'number' ? params.inPlaneAngle : 0;
+    // 坐标契约（方向 A）：bbCenter/bboxSize 是模型局部空间值——宿主生成脚本时已把
+    // 交互世界坐标转换好，本 op 不做 world→local（无 partTransform 依赖）。
+    const bbCenter = params.bbCenter ?? bboxCenter(input);
+    const bboxSize = params.bboxSize ?? boundingBox(input).max.map((v, i) => v - boundingBox(input).min[i]);
+    const planeCenter = [
+        bbCenter[0] + offset * normal[0],
+        bbCenter[1] + offset * normal[1],
+        bbCenter[2] + offset * normal[2],
+    ];
+    const planeDistance = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2];
+    const { widthDir, depthDir } = computeBasisFromNormal(normal, inPlaneAngle);
+    const basis = {
+        normal: normal,
+        widthDir: widthDir,
+        depthDir: depthDir,
+        planeCenter: planeCenter,
+        planeDistance,
+    };
+    let frontSolid;
+    let backSolid;
+    if (cutMode === 'dovetail') {
+        const groove = {
+            depth: params.grooveDepth ?? 0,
+            depthTolerance: params.grooveDepthTolerance ?? 0,
+            width: params.grooveWidth ?? 0,
+            widthTolerance: params.grooveWidthTolerance ?? 0,
+            flapsAngle: params.grooveFlapsAngle ?? 0,
+        };
+        const result = dovetailBooleanSplitBrep(kernel, inputSolid, basis, groove);
+        frontSolid = result.front;
+        backSolid = result.back;
+    }
+    else if (cutMode === 'dowel' || cutMode === 'straight-tenon' || cutMode === 'tenon') {
+        const shape = cutMode === 'dowel' ? 'dowel' : 'tenon';
+        let joineryParams;
+        if (cutMode === 'dowel') {
+            joineryParams = {
+                size: params.dowelDiameter ?? 0,
+                sizeTolerance: params.dowelDiameterTolerance ?? 0,
+                height: params.dowelHeight ?? 0,
+                heightTolerance: params.dowelHeightTolerance ?? 0,
+            };
+        }
+        else {
+            joineryParams = {
+                size: params.tenonSideLength ?? 0,
+                sizeTolerance: params.tenonSideLengthTolerance ?? 0,
+                height: params.tenonHeight ?? 0,
+                heightTolerance: params.tenonHeightTolerance ?? 0,
+            };
+        }
+        const selectedSections = params.selectedSections;
+        const result = dowelOrTenonBooleanSplitBrep(kernel, inputSolid, basis, shape, joineryParams, selectedSections ?? null);
+        frontSolid = result.front;
+        backSolid = result.back;
+    }
+    else {
+        const splitResult = splitBrep(kernel, inputSolid, {
+            normal: normal,
+            planeDistance,
+            planeCenter: planeCenter,
+        });
+        frontSolid = splitResult.front;
+        backSolid = splitResult.back;
+    }
+    // 分离位移：与 mesh 路径 finalizeExplode 同公式（bbox 对角线 2% + joinery 深度一半）
+    const applyExplode = params.applyExplode ?? true;
+    if (applyExplode) {
+        const bboxDiagonal = Math.sqrt(bboxSize[0] * bboxSize[0] + bboxSize[1] * bboxSize[1] + bboxSize[2] * bboxSize[2]);
+        const baseOffset = bboxDiagonal * 0.02;
+        let joineryOffset = 0;
+        if (cutMode === 'dovetail') {
+            joineryOffset = (params.grooveDepth ?? 0) / 2;
+        }
+        else if (cutMode === 'dowel') {
+            joineryOffset = (params.dowelHeight ?? 0) / 2;
+        }
+        else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {
+            joineryOffset = (params.tenonHeight ?? 0) / 2;
+        }
+        const frontOffset = baseOffset + joineryOffset;
+        const backOffset = -(baseOffset + joineryOffset);
+        const frontTranslated = translateBrep(kernel, frontSolid, [
+            normal[0] * frontOffset,
+            normal[1] * frontOffset,
+            normal[2] * frontOffset,
+        ]);
+        const backTranslated = translateBrep(kernel, backSolid, [
+            normal[0] * backOffset,
+            normal[1] * backOffset,
+            normal[2] * backOffset,
+        ]);
+        kernel.release(frontSolid);
+        kernel.release(backSolid);
+        frontSolid = frontTranslated;
+        backSolid = backTranslated;
+    }
+    const frontShape = fromBrep(solidToShape(kernel, frontSolid), { solid: frontSolid });
+    const backShape = fromBrep(solidToShape(kernel, backSolid), { solid: backSolid });
+    return { front: frontShape, back: backShape };
+}
+/** mesh 路径：manifold-3d mesh-CSG。 */
+async function splitMeshPath(input, params) {
+    const cutMode = params.cutMode ?? 'plane';
+    const normal = params.normal ?? [0, 0, 1];
+    const offset = typeof params.offset === 'number' ? params.offset : 0;
+    const inPlaneAngle = typeof params.inPlaneAngle === 'number' ? params.inPlaneAngle : 0;
+    const bbCenter = params.bbCenter ?? bboxCenter(input);
+    const bboxSize = params.bboxSize ?? boundingBox(input).max.map((v, i) => v - boundingBox(input).min[i]);
+    // 坐标契约（方向 A）：bbCenter/bboxSize 是模型局部空间值（宿主生成脚本时已转），
+    // 本 op 不做 world→local（无 partTransform 依赖）。
+    const result = await meshSplitWithParams({
+        shape: input,
+        cutMode: cutMode,
+        normal,
+        offset,
+        inPlaneAngle,
+        bbCenter,
+        bboxSize,
+        groove: params.grooveDepth !== undefined ? {
+            depth: params.grooveDepth,
+            depthTolerance: params.grooveDepthTolerance ?? 0,
+            width: params.grooveWidth ?? 0,
+            widthTolerance: params.grooveWidthTolerance ?? 0,
+            flapsAngle: params.grooveFlapsAngle ?? 0,
+        } : undefined,
+        dowel: params.dowelDiameter !== undefined ? {
+            diameter: params.dowelDiameter,
+            diameterTolerance: params.dowelDiameterTolerance ?? 0,
+            height: params.dowelHeight ?? 0,
+            heightTolerance: params.dowelHeightTolerance ?? 0,
+        } : undefined,
+        tenon: params.tenonSideLength !== undefined ? {
+            sideLength: params.tenonSideLength,
+            sideLengthTolerance: params.tenonSideLengthTolerance ?? 0,
+            height: params.tenonHeight ?? 0,
+            heightTolerance: params.tenonHeightTolerance ?? 0,
+        } : undefined,
+        selectedSections: params.selectedSections,
+        applyExplode: params.applyExplode ?? true,
+    });
+    return { front: solid(result.front), back: solid(result.back) };
+}
+/**
+ * 分割几何，返回具名对象 { front, back } 两个独立零件。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual warn
+ * @name fai_split
+ * @deprecated **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：`fai_` 前缀 op 为编辑器应用提供，不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**。faijs 平台面不提供等价 op（需要时须按平台需求另行设计，不得直接搬用本 op）。
+ * @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.inPlaneAngle - 切割面面内旋转角（度）。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`/`inPlaneAngle` 描述；早期文本层曾与执行层键名断裂（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 const fai_split = defineOp({
+    mesh: (input, params = {}) => {
+        if (!input)
+            throw new Error('[extra/split] no input geometry');
+        if (params.normal !== undefined && params.normal !== null) {
+            assertNonZeroVec3(params.normal, 'split.normal');
+        }
+        return splitMeshPath(input, params);
+    },
+    brep: (input, params = {}) => {
+        if (!input)
+            throw new Error('[extra/split] no input geometry');
+        if (params.normal !== undefined && params.normal !== null) {
+            assertNonZeroVec3(params.normal, 'split.normal');
+        }
+        return splitBrepPath(input, params);
+    },
+    outputs: ['front', 'back'],
+    naming: { kind: 'subdivide' },
+    // 脚本面参数量纲（单位系统 G3）：offset/木销/榫头/榫槽为 length，inPlaneAngle 为 angle。
+    paramDims: {
+        offset: 'length',
+        inPlaneAngle: 'angle',
+        grooveDepth: 'length',
+        grooveWidth: 'length',
+        dowelDiameter: 'length',
+        dowelHeight: 'length',
+        tenonSideLength: 'length',
+        tenonHeight: 'length',
+    },
+});
+//# sourceMappingURL=fai_split.js.map

package/dist/extra/ops/fai_split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_split.js","sourceRoot":"","sources":["../../../src/extra/ops/fai_split.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * faijs-extra split — 分割库函数（返回具名对象 { front, back }）\n *\n *\n * dispatchPath 静态判定 brep/mesh，双输出以具名对象返回（替代 outputCache 多输出写入）。\n */\n\nimport type { Shape, Vec3 } from '../../mesh/types'\nimport { splitWithParams as meshSplitWithParams } from '../mesh/fai_split'\nimport { bboxCenter, boundingBox } from '../../mesh/query'\nimport {\n  splitBrep,\n  solidToShape,\n  translateBrep,\n} from '../../brep/brep-ops'\nimport {\n  dovetailBooleanSplitBrep,\n  dowelOrTenonBooleanSplitBrep,\n  type JoineryBasis,\n  type GrooveParams,\n  type DowelOrTenonParams,\n} from '../../api/brep-operations/joinery-brep'\nimport { computeBasisFromNormal } from '../mesh/fai_split'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport { solid, fromBrep, brepOf } from '../../shape'\nimport { defineOp } from '../../sdk'\nimport type { Provenance } from '../../topology/naming/lineage'\nimport { assertNonZeroVec3 } from '../../api/assert'\nimport type { BrepHandle } from '../../brep/engine/types'\n\n/** BREP 路径：OCCT 平面/榫卯分割 + 分离位移。 */\nfunction splitBrepPath(input: Shape, params: Record<string, unknown>): { front: Shape; back: Shape } {\n  const kernel = getBrepApi()\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (inputSolid === undefined) throw new Error('[extra/split] input is not BREP')\n\n  const cutMode = (params.cutMode as string) ?? 'plane'\n  const normal = (params.normal as Vec3) ?? [0, 0, 1]\n  const offset = typeof params.offset === 'number' ? params.offset : 0\n  const inPlaneAngle = typeof params.inPlaneAngle === 'number' ? params.inPlaneAngle : 0\n  // 坐标契约（方向 A）：bbCenter/bboxSize 是模型局部空间值——宿主生成脚本时已把\n  // 交互世界坐标转换好，本 op 不做 world→local（无 partTransform 依赖）。\n  const bbCenter = (params.bbCenter as Vec3) ?? bboxCenter(input)\n  const bboxSize = (params.bboxSize as Vec3) ?? boundingBox(input).max.map(\n    (v, i) => v - boundingBox(input).min[i],\n  ) as Vec3\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 planeDistance = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2]\n\n  const { widthDir, depthDir } = computeBasisFromNormal(normal, inPlaneAngle)\n  const basis: JoineryBasis = {\n    normal: normal as Vec3,\n    widthDir: widthDir as Vec3,\n    depthDir: depthDir as Vec3,\n    planeCenter: planeCenter as Vec3,\n    planeDistance,\n  }\n\n  let frontSolid: BrepHandle\n  let backSolid: BrepHandle\n\n  if (cutMode === 'dovetail') {\n    const groove: GrooveParams = {\n      depth: (params.grooveDepth as number) ?? 0,\n      depthTolerance: (params.grooveDepthTolerance as number) ?? 0,\n      width: (params.grooveWidth as number) ?? 0,\n      widthTolerance: (params.grooveWidthTolerance as number) ?? 0,\n      flapsAngle: (params.grooveFlapsAngle as number) ?? 0,\n    }\n    const result = dovetailBooleanSplitBrep(kernel, inputSolid, basis, groove)\n    frontSolid = result.front\n    backSolid = result.back\n  } else if (cutMode === 'dowel' || cutMode === 'straight-tenon' || cutMode === 'tenon') {\n    const shape: 'dowel' | 'tenon' = cutMode === 'dowel' ? 'dowel' : 'tenon'\n    let joineryParams: DowelOrTenonParams\n    if (cutMode === 'dowel') {\n      joineryParams = {\n        size: (params.dowelDiameter as number) ?? 0,\n        sizeTolerance: (params.dowelDiameterTolerance as number) ?? 0,\n        height: (params.dowelHeight as number) ?? 0,\n        heightTolerance: (params.dowelHeightTolerance as number) ?? 0,\n      }\n    } else {\n      joineryParams = {\n        size: (params.tenonSideLength as number) ?? 0,\n        sizeTolerance: (params.tenonSideLengthTolerance as number) ?? 0,\n        height: (params.tenonHeight as number) ?? 0,\n        heightTolerance: (params.tenonHeightTolerance as number) ?? 0,\n      }\n    }\n    const selectedSections = params.selectedSections as number[] | null | undefined\n    const result = dowelOrTenonBooleanSplitBrep(\n      kernel, inputSolid, basis, shape, joineryParams, selectedSections ?? null,\n    )\n    frontSolid = result.front\n    backSolid = result.back\n  } else {\n    const splitResult = splitBrep(kernel, inputSolid, {\n      normal: normal as Vec3,\n      planeDistance,\n      planeCenter: planeCenter as Vec3,\n    })\n    frontSolid = splitResult.front\n    backSolid = splitResult.back\n  }\n\n  // 分离位移：与 mesh 路径 finalizeExplode 同公式（bbox 对角线 2% + joinery 深度一半）\n  const applyExplode = (params.applyExplode as boolean | undefined) ?? true\n  if (applyExplode) {\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 = ((params.grooveDepth as number) ?? 0) / 2\n    } else if (cutMode === 'dowel') {\n      joineryOffset = ((params.dowelHeight as number) ?? 0) / 2\n    } else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {\n      joineryOffset = ((params.tenonHeight as number) ?? 0) / 2\n    }\n    const frontOffset = baseOffset + joineryOffset\n    const backOffset = -(baseOffset + joineryOffset)\n    const frontTranslated = translateBrep(kernel, frontSolid, [\n      normal[0] * frontOffset,\n      normal[1] * frontOffset,\n      normal[2] * frontOffset,\n    ])\n    const backTranslated = translateBrep(kernel, backSolid, [\n      normal[0] * backOffset,\n      normal[1] * backOffset,\n      normal[2] * backOffset,\n    ])\n    kernel.release(frontSolid)\n    kernel.release(backSolid)\n    frontSolid = frontTranslated\n    backSolid = backTranslated\n  }\n\n  const frontShape = fromBrep(solidToShape(kernel, frontSolid), { solid: frontSolid })\n  const backShape = fromBrep(solidToShape(kernel, backSolid), { solid: backSolid })\n  return { front: frontShape, back: backShape }\n}\n\n/** mesh 路径：manifold-3d mesh-CSG。 */\nasync function splitMeshPath(input: Shape, params: Record<string, unknown>): Promise<{ front: Shape; back: Shape }> {\n  const cutMode = (params.cutMode as string) ?? 'plane'\n  const normal = (params.normal as Vec3) ?? [0, 0, 1]\n  const offset = typeof params.offset === 'number' ? params.offset : 0\n  const inPlaneAngle = typeof params.inPlaneAngle === 'number' ? params.inPlaneAngle : 0\n  const bbCenter = (params.bbCenter as Vec3) ?? bboxCenter(input)\n  const bboxSize = (params.bboxSize as Vec3) ?? boundingBox(input).max.map(\n    (v, i) => v - boundingBox(input).min[i],\n  ) as Vec3\n  // 坐标契约（方向 A）：bbCenter/bboxSize 是模型局部空间值（宿主生成脚本时已转），\n  // 本 op 不做 world→local（无 partTransform 依赖）。\n\n  const result = await meshSplitWithParams({\n    shape: input,\n    cutMode: cutMode as 'plane' | 'dovetail' | 'dowel' | 'straight-tenon' | 'tenon' | 'straight',\n    normal,\n    offset,\n    inPlaneAngle,\n    bbCenter,\n    bboxSize,\n    groove: params.grooveDepth !== undefined ? {\n      depth: params.grooveDepth as number,\n      depthTolerance: (params.grooveDepthTolerance as number) ?? 0,\n      width: (params.grooveWidth as number) ?? 0,\n      widthTolerance: (params.grooveWidthTolerance as number) ?? 0,\n      flapsAngle: (params.grooveFlapsAngle as number) ?? 0,\n    } : undefined,\n    dowel: params.dowelDiameter !== undefined ? {\n      diameter: params.dowelDiameter as number,\n      diameterTolerance: (params.dowelDiameterTolerance as number) ?? 0,\n      height: (params.dowelHeight as number) ?? 0,\n      heightTolerance: (params.dowelHeightTolerance as number) ?? 0,\n    } : undefined,\n    tenon: params.tenonSideLength !== undefined ? {\n      sideLength: params.tenonSideLength as number,\n      sideLengthTolerance: (params.tenonSideLengthTolerance as number) ?? 0,\n      height: (params.tenonHeight as number) ?? 0,\n      heightTolerance: (params.tenonHeightTolerance as number) ?? 0,\n    } : undefined,\n    selectedSections: params.selectedSections as number[] | null | undefined,\n    applyExplode: (params.applyExplode as boolean | undefined) ?? true,\n  })\n\n  return { front: solid(result.front), back: solid(result.back) }\n}\n\n/**\n * 分割几何，返回具名对象 { front, back } 两个独立零件。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual warn\n * @name fai_split\n * @deprecated **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：`fai_` 前缀 op 为编辑器应用提供，不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**。faijs 平台面不提供等价 op（需要时须按平台需求另行设计，不得直接搬用本 op）。\n * @returns { front: Shape; back: Shape } 必须用解构 `const { front: partA, back: partB } = await cad.fai_split(...)` 取出两个零件。\n * @param input - 目标几何。type:Shape required:true\n * @param params.cutMode - 切割模式。type:'plane' | 'dovetail' | 'dowel' | 'tenon' | 'straight-tenon' | 'straight' 默认 'plane'\n * @param params.normal - 切割面法向。type:[x,y,z] 默认 [0,0,1]\n * @param params.offset - 切割面沿法向偏移（过 bbCenter）。type:number 默认 0\n * @param params.inPlaneAngle - 切割面面内旋转角（度）。type:number 默认 0\n * @param params.bbCenter - 包围盒中心（缺省自动推导）。type:[x,y,z] 默认 自动\n * @param params.bboxSize - 包围盒尺寸（缺省自动推导）。type:[x,y,z] 默认 自动\n * @param params.applyExplode - 是否将两侧沿法向分离位移（bbox 对角线 2% + 榫卯深度一半）。type:boolean 默认 true\n * @param params.grooveDepth - 燕尾槽深（cutMode='dovetail'）。type:number\n * @param params.grooveWidth - 燕尾槽宽（cutMode='dovetail'）。type:number\n * @param params.grooveDepthTolerance - 燕尾槽深公差。type:number\n * @param params.grooveWidthTolerance - 燕尾槽宽公差。type:number\n * @param params.grooveFlapsAngle - 燕尾槽翼角（度）。type:number\n * @param params.dowelDiameter - 定位销直径（cutMode='dowel'）。type:number\n * @param params.dowelDiameterTolerance - 定位销直径公差。type:number\n * @param params.dowelHeight - 定位销高度。type:number\n * @param params.dowelHeightTolerance - 定位销高度公差。type:number\n * @param params.tenonSideLength - 直榫边长（cutMode='tenon'/'straight-tenon'）。type:number\n * @param params.tenonSideLengthTolerance - 直榫边长公差。type:number\n * @param params.tenonHeight - 直榫高度。type:number\n * @param params.tenonHeightTolerance - 直榫高度公差。type:number\n * @param params.selectedSections - 参与榫卯的截面下标。type:number[]\n * @note 切割面统一用 `normal`/`offset`/`inPlaneAngle` 描述；早期文本层曾与执行层键名断裂（planeRotation/planePosition），已修并统一为上述键名。\n * @example\n * const { front: part1, back: part2 } = await cad.fai_split(part0, { normal: [0, 0, 1], offset: 5, cutMode: 'dovetail', grooveDepth: 3, grooveWidth: 5 })\n  */\nexport const fai_split = defineOp({\n  mesh: (input: Shape, params: Record<string, unknown> = {}) => {\n    if (!input) throw new Error('[extra/split] no input geometry')\n    if (params.normal !== undefined && params.normal !== null) {\n      assertNonZeroVec3(params.normal, 'split.normal')\n    }\n    return splitMeshPath(input, params)\n  },\n  brep: (input: Shape, params: Record<string, unknown> = {}) => {\n    if (!input) throw new Error('[extra/split] no input geometry')\n    if (params.normal !== undefined && params.normal !== null) {\n      assertNonZeroVec3(params.normal, 'split.normal')\n    }\n    return splitBrepPath(input, params)\n  },\n  outputs: ['front', 'back'],\n  naming: { kind: 'subdivide' } as Provenance,\n  // 脚本面参数量纲（单位系统 G3）：offset/木销/榫头/榫槽为 length，inPlaneAngle 为 angle。\n  paramDims: {\n    offset: 'length',\n    inPlaneAngle: 'angle',\n    grooveDepth: 'length',\n    grooveWidth: 'length',\n    dowelDiameter: 'length',\n    dowelHeight: 'length',\n    tenonSideLength: 'length',\n    tenonHeight: 'length',\n  },\n})\n"]}

package/dist/extra/ops/load.d.ts

@@ -0,0 +1,49 @@
+/**
+ * faijs-extra load — 加载库函数（统一 load 函数）
+ *
+ * file 指定资产名（用户上传文件名，不含路径、含后缀），经宿主资产解析器按名解析；
+ * 格式由 file 后缀白名单自判（不依赖宿主 format 参数），isCadFormat 静态判定 brep/mesh，
+ * 产物经 solid()/fromBrep() 构造器创建。
+ *
+ * @platform occt — 本文件 import `occt-kernel/occtKernel`（BREP 路径的 XCAF /
+ * `importBrepToMesh` 平台面）。mesh 路径（STL/3MF）不依赖平台模块；本 op 无
+ * `engines` 声明（不按 op 整体做引擎门，运行时按引擎能力静态分派，见下方注释）。
+ */
+import type { Shape } from '../../mesh/types.js';
+import type { CompoundShape } from '../../shape.js';
+/**
+ * 执行加载操作（统一 load 函数）
+ *
+ * 按 params.file（资产名）从宿主资产库解析 buffer。
+ *
+ * 静态分派：
+ * - CAD 源 + kernel + 非 mesh 模式 → BREP 路径（loadBrep 异常 = 未预期错误，冒泡上报）
+ * - 非 CAD 源 / 无 kernel / mesh 模式 → mesh 路径
+ * - brep 模式且将走 mesh 路径 → 调用前抛 BrepUnsupportedError（不静默回退）
+ */
+/**
+ * 加载几何资产。`file` 指定资产名（用户上传文件名，不含路径、含后缀），内容经宿主资产解析器按名解析，**引用而非拷贝**。
+ * @group 创建
+ * @inputs 0
+ * @async true
+ * @qual ok
+ * @name load
+ * @note 语言正常化后 loadFile/loadUrl/loadByKey 别名已删除（A4），统一为 `load` 一个函数。
+ * @returns Shape 加载的几何，永远是 part 的第一条语句，后面可接特征链。
+ * @param params.file - 资产文件名（用户上传名，不含路径、含后缀，如 'vise.3mf'）；内容按名从宿主资产库取。type:string
+ * @param params.unit - **强制设置模型的源单位**：仅对无内部单位声明的 mesh 格式
+ *   （STL/3MF）有效——提供即覆盖/忽略模型内部记录的单位（3MF `<model unit>`），
+ *   按指定单位折算坐标；只有调用方确实知道单位时才提供（用户手写脚本）。未提供
+ *   时：STL faijs 启发式（guessStlUnit）、3MF 文件声明。**STEP/BREP 不支持**——
+ *   走 OCCT 链、单位由文件内部声明决定（读取时折算），提供 unit 直接报错。type:string
+ * @note 格式由 `file` 后缀白名单自判：stl/3mf → mesh 路径；step/stp/stpz/brep → BREP 路径。宿主不再传 `format`。
+ * @note 后缀白名单未命中 → 报错（不猜格式）；3MF 后缀会做 zip 魔数 sanity（后缀与内容明显不符时报错）。
+ * @note 本 op 要求导入物含实体（历史契约）。非实体（wire/face/shell）的导入是平台 `cad.import_brep` 的一等能力，不由本 op 承担。
+ * @deprecated **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：该 op 为编辑器应用的「文件导入 Feature」提供——`file` 读的是应用侧资产库（按用户上传文件名注册），产物语句位置与命名都是画布语义。不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**。2026-10-06 起多零件文件不再单零件收敛——全量以 compound + `ExecutionResult.importModels` 返回；宿主按 `importModel.parts` 身份批量建 part。
+ * @example
+ * const p = await cad.load({ file: 'box.stl' })
+ * const p = await cad.load({ file: 'box.3mf' })
+ * const p = await cad.load({ file: 'model.step' })
+ */
+export declare function load(params: Record<string, unknown>): Promise<Shape | CompoundShape>;
+//# sourceMappingURL=load.d.ts.map

package/dist/extra/ops/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/extra/ops/load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAyBhD;;;;;;;;;GASG;AACH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,CAgK1F"}