@faicad/faijs 0.13.0

package/dist/api/fai_split.js

@@ -0,0 +1,253 @@
+/**
+ * stdlib split — 分割库函数（返回具名对象 { front, back }）
+ *
+ *
+ * dispatchPath 静态判定 brep/mesh，双输出以具名对象返回（替代 outputCache 多输出写入）。
+ */
+import { cad } from '../mesh/index.js';
+import { splitBrep, solidToShape, translateBrep, } from '../brep/brep-ops.js';
+import { dovetailBooleanSplitBrep, dowelOrTenonBooleanSplitBrep, } from './brep-mirror/joinery-brep.js';
+import { computeBasisFromNormal } from '../mesh/fai_split.js';
+import { getBackends } from '../runtime-state.js';
+import { solid, fromBrep, brepOf } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { assertNonZeroVec3 } from './assert.js';
+/** 世界坐标 → 局部坐标（含单位缩放）。 */
+function worldToLocalVec3(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],
+    ];
+}
+/** BREP 路径：OCCT 平面/榫卯分割 + 分离位移。 */
+function splitBrepPath(input, params) {
+    const kernel = getBackends().kernel.brep;
+    if (!kernel)
+        throw new Error('[stdlib/split] no OCCT kernel');
+    const inputSolid = brepOf(input);
+    if (!inputSolid)
+        throw new Error('[stdlib/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 inPlaneAngleDeg = typeof params.inPlaneAngleDeg === 'number' ? params.inPlaneAngleDeg : 0;
+    const bbCenter = params.bbCenter ?? cad.bboxCenter(input);
+    const bboxSize = params.bboxSize ?? cad.boundingBox(input).max.map((v, i) => v - cad.boundingBox(input).min[i]);
+    const partTransform = getBackends().config.partTransform;
+    const localBbCenter = worldToLocalVec3(bbCenter, partTransform);
+    const scale = partTransform?.scale;
+    const hasScale = scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1);
+    const localBboxSize = hasScale
+        ? [bboxSize[0] / scale[0], bboxSize[1] / scale[1], bboxSize[2] / scale[2]]
+        : bboxSize;
+    const planeCenter = [
+        localBbCenter[0] + offset * normal[0],
+        localBbCenter[1] + offset * normal[1],
+        localBbCenter[2] + offset * normal[2],
+    ];
+    const originOffset = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2];
+    const { widthDir, depthDir } = computeBasisFromNormal(normal, inPlaneAngleDeg);
+    const basis = {
+        normal: normal,
+        widthDir: widthDir,
+        depthDir: depthDir,
+        planeCenter: planeCenter,
+        originOffset,
+    };
+    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,
+            originOffset,
+            planeCenter: planeCenter,
+        });
+        frontSolid = splitResult.front;
+        backSolid = splitResult.back;
+    }
+    // 分离位移：与 mesh 路径 finalizeExplode 同公式（bbox 对角线 2% + joinery 深度一半）
+    const applyExplode = params.applyExplode ?? true;
+    if (applyExplode) {
+        const bboxDiagonal = Math.sqrt(localBboxSize[0] * localBboxSize[0] + localBboxSize[1] * localBboxSize[1] + localBboxSize[2] * localBboxSize[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 inPlaneAngleDeg = typeof params.inPlaneAngleDeg === 'number' ? params.inPlaneAngleDeg : 0;
+    const bbCenter = params.bbCenter ?? cad.bboxCenter(input);
+    const bboxSize = params.bboxSize ?? cad.boundingBox(input).max.map((v, i) => v - cad.boundingBox(input).min[i]);
+    const partTransform = getBackends().config.partTransform;
+    const localBbCenter = worldToLocalVec3(bbCenter, partTransform);
+    const scale = partTransform?.scale;
+    const hasScale = scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1);
+    const localBboxSize = hasScale
+        ? [bboxSize[0] / scale[0], bboxSize[1] / scale[1], bboxSize[2] / scale[2]]
+        : bboxSize;
+    const result = await cad.fai_splitWithParams({
+        shape: input,
+        cutMode: cutMode,
+        normal,
+        offset,
+        inPlaneAngleDeg,
+        bbCenter: localBbCenter,
+        bboxSize: localBboxSize,
+        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 `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 const fai_split = defineOp({
+    mesh: (input, params = {}) => {
+        if (!input)
+            throw new Error('[stdlib/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('[stdlib/split] no input geometry');
+        if (params.normal !== undefined && params.normal !== null) {
+            assertNonZeroVec3(params.normal, 'split.normal');
+        }
+        return splitBrepPath(input, params);
+    },
+    outputs: ['front', 'back'],
+});
+//# sourceMappingURL=fai_split.js.map

package/dist/api/fai_split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_split.js","sourceRoot":"","sources":["../../src/api/fai_split.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib split — 分割库函数（返回具名对象 { front, back }）\n *\n *\n * dispatchPath 静态判定 brep/mesh，双输出以具名对象返回（替代 outputCache 多输出写入）。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { cad } from '../mesh'\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 './brep-mirror/joinery-brep'\nimport { computeBasisFromNormal } from '../mesh/fai_split'\nimport { getBackends } from '../runtime-state'\nimport { solid, fromBrep, brepOf } from '../shape'\nimport { defineOp } from '../sdk'\nimport { assertNonZeroVec3 } from './assert'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/** 世界坐标 → 局部坐标（含单位缩放）。 */\nfunction worldToLocalVec3(\n  worldPos: Vec3,\n  partTransform: { position: [number, number, number]; scale?: [number, number, number] } | undefined,\n): Vec3 {\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/** BREP 路径：OCCT 平面/榫卯分割 + 分离位移。 */\nfunction splitBrepPath(input: Shape, params: Record<string, unknown>): { front: Shape; back: Shape } {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/split] no OCCT kernel')\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (!inputSolid) throw new Error('[stdlib/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 inPlaneAngleDeg = typeof params.inPlaneAngleDeg === 'number' ? params.inPlaneAngleDeg : 0\n  const bbCenter = (params.bbCenter as Vec3) ?? cad.bboxCenter(input)\n  const bboxSize = (params.bboxSize as Vec3) ?? cad.boundingBox(input).max.map(\n    (v, i) => v - cad.boundingBox(input).min[i],\n  ) as Vec3\n\n  const partTransform = getBackends().config.partTransform\n  const localBbCenter = worldToLocalVec3(bbCenter, partTransform)\n  const scale = partTransform?.scale\n  const hasScale = scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1)\n  const localBboxSize: Vec3 = hasScale\n    ? [bboxSize[0] / scale![0], bboxSize[1] / scale![1], bboxSize[2] / scale![2]]\n    : bboxSize\n\n  const planeCenter: Vec3 = [\n    localBbCenter[0] + offset * normal[0],\n    localBbCenter[1] + offset * normal[1],\n    localBbCenter[2] + offset * normal[2],\n  ]\n  const originOffset = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2]\n\n  const { widthDir, depthDir } = computeBasisFromNormal(normal, inPlaneAngleDeg)\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    originOffset,\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      originOffset,\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      localBboxSize[0] * localBboxSize[0] + localBboxSize[1] * localBboxSize[1] + localBboxSize[2] * localBboxSize[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 inPlaneAngleDeg = typeof params.inPlaneAngleDeg === 'number' ? params.inPlaneAngleDeg : 0\n  const bbCenter = (params.bbCenter as Vec3) ?? cad.bboxCenter(input)\n  const bboxSize = (params.bboxSize as Vec3) ?? cad.boundingBox(input).max.map(\n    (v, i) => v - cad.boundingBox(input).min[i],\n  ) as Vec3\n\n  const partTransform = getBackends().config.partTransform\n  const localBbCenter = worldToLocalVec3(bbCenter, partTransform)\n  const scale = partTransform?.scale\n  const hasScale = scale && (scale[0] !== 1 || scale[1] !== 1 || scale[2] !== 1)\n  const localBboxSize: Vec3 = hasScale\n    ? [bboxSize[0] / scale![0], bboxSize[1] / scale![1], bboxSize[2] / scale![2]]\n    : bboxSize\n\n  const result = await cad.fai_splitWithParams({\n    shape: input,\n    cutMode: cutMode as 'plane' | 'dovetail' | 'dowel' | 'straight-tenon' | 'tenon' | 'straight',\n    normal,\n    offset,\n    inPlaneAngleDeg,\n    bbCenter: localBbCenter,\n    bboxSize: localBboxSize,\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 `fai_` 前缀 op 是 ../3d_editor 项目特有的操作，不属于 faijs 平台面；将来会迁往该项目并从 faijs 删除。新代码请勿使用。\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.inPlaneAngleDeg - 切割面面内旋转角（度）。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`/`inPlaneAngleDeg` 描述；早期文本层曾与执行层键名断裂（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('[stdlib/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('[stdlib/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})\n"]}

package/dist/api/fillet.d.ts

@@ -0,0 +1,46 @@
+/**
+ * stdlib fillet — fillet 圆角库函数（BREP-only，directEdit 能力）
+ *
+ *
+ * 与 chamfer 的差异：fillet 用 filletWithHistory 走面演化 + roleTable 传播
+ * （chamfer 在 P5 同步改造）。M1 只支持等半径；M2 计划支持变半径与几何限定符。
+ *
+ * 设计见 docs/plans/2026-09-10-fillet-op-and-editor-ui.md §2–§3。
+ *
+ * M1：
+ * - 等半径（number）：kernel.filletWithHistory(solid, edges, radius, hashes, bound)
+ * - 走 filletWithRoleTable 传播 roleTable（§3.2）
+ * - BREP-only：mesh 输入 → E_MESH_UNSUPPORTED（backend-dispatch 静态判定）
+ *
+ * M2（未实施）：
+ * - 变半径 [r1, r2]：filletVariable + 单边 + 不产 roleTable（§3.3 降级）
+ * - 几何限定符字符串选边（§4）
+ */
+import type { Shape } from '../mesh/types.js';
+/**
+ * Validate fillet parameters: `edges` must be a non-empty array of EdgeTopoRef,
+ * each with kind key "edge" and a two-entry faces pair; `radius` must be a
+ * positive number (M1: uniform radius only).
+ * @param params the raw fillet operation parameters.
+ */
+export declare function assertFilletParams(params: Record<string, unknown>): void;
+/**
+ * 在几何体上做圆角（等半径）。仅 BREP 可用。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name fillet
+ * @note 圆角是 BREP-only：非 BREP 输入抛 E_MESH_UNSUPPORTED。`radius` 为正数（mm）。
+ *       圆角后 roleTable 经 filletWithHistory 传播，保证后续特征仍可按 role 选面/选边。
+ * @returns Shape 圆角后的几何。
+ * @param input - 目标几何。type:Shape required:true
+ * @param params.edges - 参与圆角的边（EdgeTopoRef[]，条目为相邻两面的 role 线路）。type:EdgeTopoRef[] required:true
+ * @param params.radius - 圆角半径（mm，>0）。type:number required:true
+ * @example
+ * const p = await cad.fillet(part0, { edges: [{ kind:'edge', faces:[{ origin:'box', role:'box:top' }, { origin:'box', role:'box:front' }], hint:{ kind:'edge' } }], radius:2 })
+ */
+export declare const fillet: ((input: Shape, params: Record<string, unknown>) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=fillet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fillet.d.ts","sourceRoot":"","sources":["../../src/api/fillet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAc1C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAkBxE;AAoED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM;;CAMjB,CAAA"}

package/dist/api/fillet.js

@@ -0,0 +1,127 @@
+/**
+ * stdlib fillet — fillet 圆角库函数（BREP-only，directEdit 能力）
+ *
+ *
+ * 与 chamfer 的差异：fillet 用 filletWithHistory 走面演化 + roleTable 传播
+ * （chamfer 在 P5 同步改造）。M1 只支持等半径；M2 计划支持变半径与几何限定符。
+ *
+ * 设计见 docs/plans/2026-09-10-fillet-op-and-editor-ui.md §2–§3。
+ *
+ * M1：
+ * - 等半径（number）：kernel.filletWithHistory(solid, edges, radius, hashes, bound)
+ * - 走 filletWithRoleTable 传播 roleTable（§3.2）
+ * - BREP-only：mesh 输入 → E_MESH_UNSUPPORTED（backend-dispatch 静态判定）
+ *
+ * M2（未实施）：
+ * - 变半径 [r1, r2]：filletVariable + 单边 + 不产 roleTable（§3.3 降级）
+ * - 几何限定符字符串选边（§4）
+ */
+import { solidToShape } from '../brep/brep-ops.js';
+import { filletWithRoleTable } from '../brep/face-evolution.js';
+import { getBackends, getCurrentStmt } from '../runtime-state.js';
+import { fromBrep, brepOf, getSlot } from '../shape.js';
+import { defineOp } from '../sdk.js';
+import { resolveTopoRef, TopoRefError } from '../topology/naming/index.js';
+import { buildEdgeResolutionContext } from './topo-resolve.js';
+// ── 参数自校验（stdlib 被直接 import 时的防御层）──
+/**
+ * Validate fillet parameters: `edges` must be a non-empty array of EdgeTopoRef,
+ * each with kind key "edge" and a two-entry faces pair; `radius` must be a
+ * positive number (M1: uniform radius only).
+ * @param params the raw fillet operation parameters.
+ */
+export function assertFilletParams(params) {
+    const edges = params.edges;
+    if (!Array.isArray(edges) || edges.length === 0) {
+        throw new Error('E_FILLET_NO_EDGES: fillet requires at least one edge');
+    }
+    for (const e of edges) {
+        if (!e || typeof e !== 'object' || e.kind !== 'edge') {
+            throw new Error('E_FILLET_BAD_EDGE_REF: every edge entry must be an EdgeTopoRef with kind:"edge"');
+        }
+        const faces = e.faces;
+        if (!Array.isArray(faces) || faces.length !== 2) {
+            throw new Error('E_FILLET_BAD_EDGE_REF: EdgeTopoRef.faces must be a two-entry RoleQualifier pair');
+        }
+    }
+    const radius = params.radius;
+    if (typeof radius !== 'number' || !Number.isFinite(radius) || radius <= 0) {
+        throw new Error('E_FILLET_BAD_RADIUS: fillet.radius must be a positive number');
+    }
+}
+/** 解析一条 EdgeTopoRef → handle；失败抛命名层 TopoRefError。 */
+function resolveEdge(ctx, ref) {
+    const r = resolveTopoRef(ref, ctx);
+    if (r.handle === undefined) {
+        throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `fillet: edge resolved without handle (${ref.faces[0].role}/${ref.faces[1].role})`);
+    }
+    return r.handle;
+}
+/**
+ * 把内核 OcctError 回译成 E_FILLET_RADIUS_TOO_LARGE。
+ *
+ * OCCT 在半径超过邻面尺寸、三面交汇处、凹边处都可能失败。
+ * 绝不可静默返回未圆角的原形状（§9 风险）。
+ */
+function translateOcctError(err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes('E_FILLET') || msg.includes('E_TOPO'))
+        return err;
+    return new Error(`E_FILLET_RADIUS_TOO_LARGE: OCCT fillet failed — ${msg}`);
+}
+/** BREP-only 主入口（M1 等半径 flow）。 */
+function filletBrep(input, params) {
+    const kernel = getBackends().kernel.brep;
+    if (!kernel)
+        throw new Error('[stdlib/fillet] no BREP kernel');
+    const solid = brepOf(input);
+    if (!solid)
+        throw new Error('E_FILLET_NO_BREP: fillet input is not BREP');
+    const edges = params.edges;
+    const radius = params.radius;
+    const ctx = buildEdgeResolutionContext(kernel, input);
+    if (!ctx)
+        throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', 'fillet: input has no edge naming context');
+    // 解析所有 EdgeTopoRef → Edge 句柄
+    const edgeHandles = edges.map((e) => resolveEdge(ctx, e));
+    // 输入 roleTable + outPart（与 boolean.ts 同构）
+    const inputRoleTable = getSlot(input)?.roleTable;
+    const outPart = String(getCurrentStmt()?.outputs[0] ?? '');
+    let resultSolid;
+    let faceEvolution;
+    let roleTable;
+    try {
+        const r = filletWithRoleTable(kernel, solid, edgeHandles, radius, inputRoleTable ?? new Map(), outPart);
+        resultSolid = r.result;
+        faceEvolution = r.faceEvolution;
+        roleTable = r.roleTable;
+    }
+    catch (err) {
+        throw translateOcctError(err);
+    }
+    return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid, faceEvolution, roleTable });
+}
+/**
+ * 在几何体上做圆角（等半径）。仅 BREP 可用。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name fillet
+ * @note 圆角是 BREP-only：非 BREP 输入抛 E_MESH_UNSUPPORTED。`radius` 为正数（mm）。
+ *       圆角后 roleTable 经 filletWithHistory 传播，保证后续特征仍可按 role 选面/选边。
+ * @returns Shape 圆角后的几何。
+ * @param input - 目标几何。type:Shape required:true
+ * @param params.edges - 参与圆角的边（EdgeTopoRef[]，条目为相邻两面的 role 线路）。type:EdgeTopoRef[] required:true
+ * @param params.radius - 圆角半径（mm，>0）。type:number required:true
+ * @example
+ * const p = await cad.fillet(part0, { edges: [{ kind:'edge', faces:[{ origin:'box', role:'box:top' }, { origin:'box', role:'box:front' }], hint:{ kind:'edge' } }], radius:2 })
+ */
+export const fillet = defineOp({
+    capabilities: ['directEdit'],
+    brep(input, params) {
+        assertFilletParams(params);
+        return filletBrep(input, params);
+    },
+});
+//# sourceMappingURL=fillet.js.map

package/dist/api/fillet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fillet.js","sourceRoot":"","sources":["../../src/api/fillet.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib fillet — fillet 圆角库函数（BREP-only，directEdit 能力）\n *\n *\n * 与 chamfer 的差异：fillet 用 filletWithHistory 走面演化 + roleTable 传播\n * （chamfer 在 P5 同步改造）。M1 只支持等半径；M2 计划支持变半径与几何限定符。\n *\n * 设计见 docs/plans/2026-09-10-fillet-op-and-editor-ui.md §2–§3。\n *\n * M1：\n * - 等半径（number）：kernel.filletWithHistory(solid, edges, radius, hashes, bound)\n * - 走 filletWithRoleTable 传播 roleTable（§3.2）\n * - BREP-only：mesh 输入 → E_MESH_UNSUPPORTED（backend-dispatch 静态判定）\n *\n * M2（未实施）：\n * - 变半径 [r1, r2]：filletVariable + 单边 + 不产 roleTable（§3.3 降级）\n * - 几何限定符字符串选边（§4）\n */\n\nimport type { Shape } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { filletWithRoleTable } from '../brep/face-evolution'\nimport { getBackends, getCurrentStmt } from '../runtime-state'\nimport { fromBrep, brepOf, getSlot } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport type { EdgeTopoRef, ResolutionContext } from '../topology/naming'\nimport { resolveTopoRef, TopoRefError } from '../topology/naming'\nimport { buildEdgeResolutionContext } from './topo-resolve'\n\n// ── 参数自校验（stdlib 被直接 import 时的防御层）──\n\n/**\n * Validate fillet parameters: `edges` must be a non-empty array of EdgeTopoRef,\n * each with kind key \"edge\" and a two-entry faces pair; `radius` must be a\n * positive number (M1: uniform radius only).\n * @param params the raw fillet operation parameters.\n */\nexport function assertFilletParams(params: Record<string, unknown>): void {\n  const edges = params.edges\n  if (!Array.isArray(edges) || edges.length === 0) {\n    throw new Error('E_FILLET_NO_EDGES: fillet requires at least one edge')\n  }\n  for (const e of edges) {\n    if (!e || typeof e !== 'object' || (e as { kind?: unknown }).kind !== 'edge') {\n      throw new Error('E_FILLET_BAD_EDGE_REF: every edge entry must be an EdgeTopoRef with kind:\"edge\"')\n    }\n    const faces = (e as { faces?: unknown }).faces\n    if (!Array.isArray(faces) || faces.length !== 2) {\n      throw new Error('E_FILLET_BAD_EDGE_REF: EdgeTopoRef.faces must be a two-entry RoleQualifier pair')\n    }\n  }\n  const radius = params.radius\n  if (typeof radius !== 'number' || !Number.isFinite(radius) || radius <= 0) {\n    throw new Error('E_FILLET_BAD_RADIUS: fillet.radius must be a positive number')\n  }\n}\n\n/** 解析一条 EdgeTopoRef → handle；失败抛命名层 TopoRefError。 */\nfunction resolveEdge(ctx: ResolutionContext, ref: EdgeTopoRef): BrepHandle {\n  const r = resolveTopoRef(ref, ctx)\n  if (r.handle === undefined) {\n    throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `fillet: edge resolved without handle (${ref.faces[0].role}/${ref.faces[1].role})`)\n  }\n  return r.handle as BrepHandle\n}\n\n/**\n * 把内核 OcctError 回译成 E_FILLET_RADIUS_TOO_LARGE。\n *\n * OCCT 在半径超过邻面尺寸、三面交汇处、凹边处都可能失败。\n * 绝不可静默返回未圆角的原形状（§9 风险）。\n */\nfunction translateOcctError(err: unknown): Error {\n  const msg = err instanceof Error ? err.message : String(err)\n  if (msg.includes('E_FILLET') || msg.includes('E_TOPO')) return err as Error\n  return new Error(`E_FILLET_RADIUS_TOO_LARGE: OCCT fillet failed — ${msg}`)\n}\n\n/** BREP-only 主入口（M1 等半径 flow）。 */\nfunction filletBrep(input: Shape, params: Record<string, unknown>): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/fillet] no BREP kernel')\n  const solid = brepOf(input) as BrepHandle | undefined\n  if (!solid) throw new Error('E_FILLET_NO_BREP: fillet input is not BREP')\n\n  const edges = params.edges as EdgeTopoRef[]\n  const radius = params.radius as number\n  const ctx = buildEdgeResolutionContext(kernel, input as object)\n  if (!ctx) throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', 'fillet: input has no edge naming context')\n\n  // 解析所有 EdgeTopoRef → Edge 句柄\n  const edgeHandles = edges.map((e) => resolveEdge(ctx, e))\n\n  // 输入 roleTable + outPart（与 boolean.ts 同构）\n  const inputRoleTable = getSlot(input)?.roleTable as ReadonlyMap<unknown, unknown> | undefined\n  const outPart = String(getCurrentStmt()?.outputs[0] ?? '')\n\n  let resultSolid: BrepHandle\n  let faceEvolution: Map<number, number[]> | undefined\n  let roleTable: ReadonlyMap<unknown, unknown> | undefined\n\n  try {\n    const r = filletWithRoleTable(\n      kernel,\n      solid,\n      edgeHandles,\n      radius,\n      inputRoleTable ?? new Map(),\n      outPart,\n    )\n    resultSolid = r.result\n    faceEvolution = r.faceEvolution\n    roleTable = r.roleTable\n  } catch (err) {\n    throw translateOcctError(err)\n  }\n\n  return fromBrep(\n    solidToShape(kernel, resultSolid),\n    { solid: resultSolid, faceEvolution, roleTable },\n  )\n}\n\n/**\n * 在几何体上做圆角（等半径）。仅 BREP 可用。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name fillet\n * @note 圆角是 BREP-only：非 BREP 输入抛 E_MESH_UNSUPPORTED。`radius` 为正数（mm）。\n *       圆角后 roleTable 经 filletWithHistory 传播，保证后续特征仍可按 role 选面/选边。\n * @returns Shape 圆角后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.edges - 参与圆角的边（EdgeTopoRef[]，条目为相邻两面的 role 线路）。type:EdgeTopoRef[] required:true\n * @param params.radius - 圆角半径（mm，>0）。type:number required:true\n * @example\n * const p = await cad.fillet(part0, { edges: [{ kind:'edge', faces:[{ origin:'box', role:'box:top' }, { origin:'box', role:'box:front' }], hint:{ kind:'edge' } }], radius:2 })\n */\nexport const fillet = defineOp({\n  capabilities: ['directEdit'],\n  brep(input: Shape, params: Record<string, unknown>) {\n    assertFilletParams(params)\n    return filletBrep(input, params)\n  },\n})\n"]}

package/dist/api/generated/2d.d.ts

@@ -0,0 +1,18 @@
+/**
+ * generated/2d.ts — 生成文件，勿手改。
+ * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。
+ * 2d 模块：12 个投影符号；另有 33 个 skip 登记。
+ */
+export type { Blueprint } from '../../vendored/brepjs/index.js';
+export type { Blueprints } from '../../vendored/brepjs/index.js';
+export type { BoundingBox2d } from '../../vendored/brepjs/index.js';
+export type { CompoundBlueprint } from '../../vendored/brepjs/index.js';
+export type { Curve2D } from '../../vendored/brepjs/index.js';
+export type { DrawingInterface } from '../../vendored/brepjs/index.js';
+export type { GenericSketcher } from '../../vendored/brepjs/index.js';
+export type { Point2D } from '../../vendored/brepjs/index.js';
+export type { ScaleMode } from '../../vendored/brepjs/index.js';
+export type { Shape2D } from '../../vendored/brepjs/index.js';
+export type { SketchData } from '../../vendored/brepjs/index.js';
+export type { SplineOptions } from '../../vendored/brepjs/index.js';
+//# sourceMappingURL=2d.d.ts.map

package/dist/api/generated/2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"2d.d.ts","sourceRoot":"","sources":["../../../src/api/generated/2d.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,YAAY,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE/D,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAEnE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAEvE,YAAY,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAE7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAErE,YAAY,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAE7D,YAAY,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE/D,YAAY,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAE7D,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/api/generated/2d.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=2d.js.map

package/dist/api/generated/2d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"2d.js","sourceRoot":"","sources":["../../../src/api/generated/2d.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * generated/2d.ts — 生成文件，勿手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。\n * 2d 模块：12 个投影符号；另有 33 个 skip 登记。\n */\nexport type { Blueprint } from '../../vendored/brepjs/index.js'\n\nexport type { Blueprints } from '../../vendored/brepjs/index.js'\n\nexport type { BoundingBox2d } from '../../vendored/brepjs/index.js'\n\nexport type { CompoundBlueprint } from '../../vendored/brepjs/index.js'\n\nexport type { Curve2D } from '../../vendored/brepjs/index.js'\n\nexport type { DrawingInterface } from '../../vendored/brepjs/index.js'\n\nexport type { GenericSketcher } from '../../vendored/brepjs/index.js'\n\nexport type { Point2D } from '../../vendored/brepjs/index.js'\n\nexport type { ScaleMode } from '../../vendored/brepjs/index.js'\n\nexport type { Shape2D } from '../../vendored/brepjs/index.js'\n\nexport type { SketchData } from '../../vendored/brepjs/index.js'\n\nexport type { SplineOptions } from '../../vendored/brepjs/index.js'\n"]}