@faicad/faijs 0.14.1 → 0.16.0

package/dist/api/fai_split.js

@@ -1,254 +0,0 @@
-/**
- * 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 **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：`fai_` 前缀 op 为编辑器应用提供，不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**（见 `docs/plans/2026-09-22-topology-identity-development-plan.md` §2）。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.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'],
-    naming: { kind: 'subdivide' },
-});
-//# sourceMappingURL=fai_split.js.map

package/dist/api/fai_split.js.map

@@ -1 +0,0 @@
-{"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 type { Provenance } from '../topology/naming/lineage'\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 **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：`fai_` 前缀 op 为编辑器应用提供，不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**（见 `docs/plans/2026-09-22-topology-identity-development-plan.md` §2）。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.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  naming: { kind: 'subdivide' } as Provenance,\n})\n"]}

package/dist/api/load.d.ts

@@ -1,41 +0,0 @@
-/**
- * stdlib load — 加载库函数（统一 load 函数）
- *
- *
- * buffer 经宿主资产解析器解析，isCadFormat 静态判定 brep/mesh，
- * 产物经 solid()/fromBrep() 构造器创建。
- */
-import type { Shape } from '../mesh/types.js';
-/**
- * 执行加载操作（统一 load 函数）
- *
- * 按 params 中存在的 key/path/url 分流解析 buffer，全部经宿主资产解析器。
- *
- * 静态分派：
- * - CAD 源 + kernel + 非 mesh 模式 → BREP 路径（loadBrep 异常 = 未预期错误，冒泡上报）
- * - 非 CAD 源 / 无 kernel / mesh 模式 → mesh 路径
- * - brep 模式且将走 mesh 路径 → 调用前抛 BrepUnsupportedError（不静默回退）
- */
-/**
- * 加载几何资产。key / path / url 三选一（按此优先级分流），内容经宿主资产解析器解析，**引用而非拷贝**。
- * @group 创建
- * @inputs 0
- * @async true
- * @qual ok
- * @name load
- * @note 语言正常化后 loadFile/loadUrl/loadByKey 别名已删除（A4），统一为 `load` 一个函数。
- * @returns Shape 加载的几何，永远是 part 的第一条语句，后面可接特征链。
- * @param params.key - faicad 缓存中的资产 key（内容按 key 取）。type:string
- * @param params.path - 本地绝对路径（非 web 环境）。type:string
- * @param params.url - 网络地址。type:string
- * @param params.format - 格式提示（如 'step'/'stl'；CAD 源走 BREP 精确路径，STL 等三角化源走 mesh 路径）。type:string
- * @note key/path/url 是优先级分流（key 优先，其次 path，最后 url），三者只需其一；同时给多个时按优先级取。`format` 是提示而非强约束——CAD 源（step/stp/brep 等）与三角化源（stl 等）由 `isCadFormat` 静态判定路径。
- * @note 本 op 要求导入物含实体（历史契约）。非实体（wire/face/shell）的导入是平台 `cad.import_brep` 的一等能力，不由本 op 承担。
- * @deprecated **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：该 op 为编辑器应用的「文件导入 Feature」提供——key/path/url 三键分流读的是应用侧 `FileRef`，产物语句位置、命名与 partIndex 都是画布语义。不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**（见 `docs/plans/2026-09-22-topology-identity-development-plan.md` §2）。平台侧导入请用 `cad.import_brep`（冻结 BREP 资产）。
- * @example
- * const p = await cad.load({ key: 'file_abc123' })
- * const p = await cad.load({ path: 'D:/models/box.step', format: 'step' })
- * const p = await cad.load({ url: 'https://…/box.3mf' })
- */
-export declare function load(params: Record<string, unknown>): Promise<Shape>;
-//# sourceMappingURL=load.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/api/load.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAS1C;;;;;;;;;GASG;AACH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CA8C1E"}

package/dist/api/load.js

@@ -1,84 +0,0 @@
-/**
- * stdlib load — 加载库函数（统一 load 函数）
- *
- *
- * buffer 经宿主资产解析器解析，isCadFormat 静态判定 brep/mesh，
- * 产物经 solid()/fromBrep() 构造器创建。
- */
-import { cad } from '../mesh/index.js';
-import { isCadFormat } from '../brep/brep-chain.js';
-import { loadBrep } from '../brep/brep-ops.js';
-import { OpError } from './internal/result-unwrap.js';
-import { getBackends, BrepUnsupportedError } from '../runtime-state.js';
-import { solid, fromBrep } from '../shape.js';
-/**
- * 执行加载操作（统一 load 函数）
- *
- * 按 params 中存在的 key/path/url 分流解析 buffer，全部经宿主资产解析器。
- *
- * 静态分派：
- * - CAD 源 + kernel + 非 mesh 模式 → BREP 路径（loadBrep 异常 = 未预期错误，冒泡上报）
- * - 非 CAD 源 / 无 kernel / mesh 模式 → mesh 路径
- * - brep 模式且将走 mesh 路径 → 调用前抛 BrepUnsupportedError（不静默回退）
- */
-/**
- * 加载几何资产。key / path / url 三选一（按此优先级分流），内容经宿主资产解析器解析，**引用而非拷贝**。
- * @group 创建
- * @inputs 0
- * @async true
- * @qual ok
- * @name load
- * @note 语言正常化后 loadFile/loadUrl/loadByKey 别名已删除（A4），统一为 `load` 一个函数。
- * @returns Shape 加载的几何，永远是 part 的第一条语句，后面可接特征链。
- * @param params.key - faicad 缓存中的资产 key（内容按 key 取）。type:string
- * @param params.path - 本地绝对路径（非 web 环境）。type:string
- * @param params.url - 网络地址。type:string
- * @param params.format - 格式提示（如 'step'/'stl'；CAD 源走 BREP 精确路径，STL 等三角化源走 mesh 路径）。type:string
- * @note key/path/url 是优先级分流（key 优先，其次 path，最后 url），三者只需其一；同时给多个时按优先级取。`format` 是提示而非强约束——CAD 源（step/stp/brep 等）与三角化源（stl 等）由 `isCadFormat` 静态判定路径。
- * @note 本 op 要求导入物含实体（历史契约）。非实体（wire/face/shell）的导入是平台 `cad.import_brep` 的一等能力，不由本 op 承担。
- * @deprecated **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：该 op 为编辑器应用的「文件导入 Feature」提供——key/path/url 三键分流读的是应用侧 `FileRef`，产物语句位置、命名与 partIndex 都是画布语义。不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**（见 `docs/plans/2026-09-22-topology-identity-development-plan.md` §2）。平台侧导入请用 `cad.import_brep`（冻结 BREP 资产）。
- * @example
- * const p = await cad.load({ key: 'file_abc123' })
- * const p = await cad.load({ path: 'D:/models/box.step', format: 'step' })
- * const p = await cad.load({ url: 'https://…/box.3mf' })
- */
-export async function load(params) {
-    const assets = getBackends().assets;
-    if (!assets) {
-        throw new OpError('load', 'E_OP_FAILED', '[stdlib/load] assets is required for load op');
-    }
-    // 按 key/path/url 分流解析 buffer
-    let buffer;
-    if (params.key !== undefined && params.key !== null) {
-        buffer = (await assets.resolveByKey(params.key)).bytes;
-    }
-    else if (params.path !== undefined && params.path !== null) {
-        buffer = await assets.resolveFile(params.path);
-    }
-    else if (params.url !== undefined && params.url !== null) {
-        buffer = await assets.resolveUrl(params.url);
-    }
-    else {
-        throw new OpError('load', 'E_OP_FAILED', '[stdlib/load] load op requires exactly one of key/path/url');
-    }
-    // 静态判定路径：mesh 模式 / 无 kernel / 非 CAD 源 → mesh 路径；否则 BREP 路径
-    const { config, kernel: kernels } = getBackends();
-    const kernel = kernels.brep;
-    const useBrep = config.mode !== 'mesh' && !!kernel && isCadFormat(params, true);
-    // brep 模式且将走 mesh-only 路径 → 调用前抛错，不静默回退
-    if (!useBrep && config.mode === 'brep') {
-        throw new BrepUnsupportedError('E_BREP_UNSUPPORTED: load op has no BREP implementation for this source');
-    }
-    // mesh 路径
-    if (!useBrep) {
-        return solid(await cad.load(buffer, params.format));
-    }
-    // BREP 路径（直接执行，不包 try-catch！异常 = 未预期错误，冒泡上报）
-    // P2：brepChain（meshShapeCache）归引擎侧，loadBrep 不再传
-    // partIndex：多 part 文件（如多 solid STEP）逐 part 加载——宿主为每个 part
-    // 生成独立 load 语句并携带 partIndex，提取 Compound 中对应子 solid。
-    const partIndex = typeof params.partIndex === 'number' ? params.partIndex : undefined;
-    const { solid: solidHandle, shape } = loadBrep(kernel, buffer, undefined, undefined, partIndex);
-    return fromBrep(shape, { solid: solidHandle });
-}
-//# sourceMappingURL=load.js.map

package/dist/api/load.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/api/load.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAG1C;;;;;;;;;GASG;AACH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,MAA+B;IACxD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAIhB,CAAA;IACb,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,8CAA8C,CAAC,CAAA;IAC1F,CAAC;IAED,6BAA6B;IAC7B,IAAI,MAAmB,CAAA;IACvB,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACpD,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAa,CAAC,CAAC,CAAC,KAAK,CAAA;IAClE,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QAC7D,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,IAAc,CAAC,CAAA;IAC1D,CAAC;SAAM,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QAC3D,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,GAAa,CAAC,CAAA;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,4DAA4D,CAAC,CAAA;IACxG,CAAC;IAED,2DAA2D;IAC3D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,CAAA;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,IAA4B,CAAA;IACnD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IAE/E,wCAAwC;IACxC,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACvC,MAAM,IAAI,oBAAoB,CAAC,wEAAwE,CAAC,CAAA;IAC1G,CAAC;IAED,UAAU;IACV,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAA4B,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,6CAA6C;IAC7C,gDAAgD;IAChD,0DAA0D;IAC1D,oDAAoD;IACpD,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;IACrF,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,QAAQ,CAC5C,MAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CACjD,CAAA;IACD,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAChD,CAAC","sourcesContent":["/**\n * stdlib load — 加载库函数（统一 load 函数）\n *\n *\n * buffer 经宿主资产解析器解析，isCadFormat 静态判定 brep/mesh，\n * 产物经 solid()/fromBrep() 构造器创建。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { cad } from '../mesh'\nimport { isCadFormat } from '../brep/brep-chain'\nimport { loadBrep } from '../brep/brep-ops'\nimport { OpError } from './internal/result-unwrap'\nimport { getBackends, BrepUnsupportedError } from '../runtime-state'\nimport { solid, fromBrep } from '../shape'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/**\n * 执行加载操作（统一 load 函数）\n *\n * 按 params 中存在的 key/path/url 分流解析 buffer，全部经宿主资产解析器。\n *\n * 静态分派：\n * - CAD 源 + kernel + 非 mesh 模式 → BREP 路径（loadBrep 异常 = 未预期错误，冒泡上报）\n * - 非 CAD 源 / 无 kernel / mesh 模式 → mesh 路径\n * - brep 模式且将走 mesh 路径 → 调用前抛 BrepUnsupportedError（不静默回退）\n */\n/**\n * 加载几何资产。key / path / url 三选一（按此优先级分流），内容经宿主资产解析器解析，**引用而非拷贝**。\n * @group 创建\n * @inputs 0\n * @async true\n * @qual ok\n * @name load\n * @note 语言正常化后 loadFile/loadUrl/loadByKey 别名已删除（A4），统一为 `load` 一个函数。\n * @returns Shape 加载的几何，永远是 part 的第一条语句，后面可接特征链。\n * @param params.key - faicad 缓存中的资产 key（内容按 key 取）。type:string\n * @param params.path - 本地绝对路径（非 web 环境）。type:string\n * @param params.url - 网络地址。type:string\n * @param params.format - 格式提示（如 'step'/'stl'；CAD 源走 BREP 精确路径，STL 等三角化源走 mesh 路径）。type:string\n * @note key/path/url 是优先级分流（key 优先，其次 path，最后 url），三者只需其一；同时给多个时按优先级取。`format` 是提示而非强约束——CAD 源（step/stp/brep 等）与三角化源（stl 等）由 `isCadFormat` 静态判定路径。\n * @note 本 op 要求导入物含实体（历史契约）。非实体（wire/face/shell）的导入是平台 `cad.import_brep` 的一等能力，不由本 op 承担。\n * @deprecated **`../3d_editor` 消费面**（原 `@deprecated` 措辞已于 2026-09-22 校正）：该 op 为编辑器应用的「文件导入 Feature」提供——key/path/url 三键分流读的是应用侧 `FileRef`，产物语句位置、命名与 partIndex 都是画布语义。不属 faijs 平台面，但**不是废弃项**——它服务真实负载。**变更其 API 形态必须同步更新 `../3d_editor`**（见 `docs/plans/2026-09-22-topology-identity-development-plan.md` §2）。平台侧导入请用 `cad.import_brep`（冻结 BREP 资产）。\n * @example\n * const p = await cad.load({ key: 'file_abc123' })\n * const p = await cad.load({ path: 'D:/models/box.step', format: 'step' })\n * const p = await cad.load({ url: 'https://…/box.3mf' })\n */\nexport async function load(params: Record<string, unknown>): Promise<Shape> {\n  const assets = getBackends().assets as {\n    resolveByKey(key: string): Promise<{ bytes: ArrayBuffer }>\n    resolveFile(path: string): Promise<ArrayBuffer>\n    resolveUrl(url: string): Promise<ArrayBuffer>\n  } | undefined\n  if (!assets) {\n    throw new OpError('load', 'E_OP_FAILED', '[stdlib/load] assets is required for load op')\n  }\n\n  // 按 key/path/url 分流解析 buffer\n  let buffer: ArrayBuffer\n  if (params.key !== undefined && params.key !== null) {\n    buffer = (await assets.resolveByKey(params.key as string)).bytes\n  } else if (params.path !== undefined && params.path !== null) {\n    buffer = await assets.resolveFile(params.path as string)\n  } else if (params.url !== undefined && params.url !== null) {\n    buffer = await assets.resolveUrl(params.url as string)\n  } else {\n    throw new OpError('load', 'E_OP_FAILED', '[stdlib/load] load op requires exactly one of key/path/url')\n  }\n\n  // 静态判定路径：mesh 模式 / 无 kernel / 非 CAD 源 → mesh 路径；否则 BREP 路径\n  const { config, kernel: kernels } = getBackends()\n  const kernel = kernels.brep as BrepEngineApi | null\n  const useBrep = config.mode !== 'mesh' && !!kernel && isCadFormat(params, true)\n\n  // brep 模式且将走 mesh-only 路径 → 调用前抛错，不静默回退\n  if (!useBrep && config.mode === 'brep') {\n    throw new BrepUnsupportedError('E_BREP_UNSUPPORTED: load op has no BREP implementation for this source')\n  }\n\n  // mesh 路径\n  if (!useBrep) {\n    return solid(await cad.load(buffer, params.format as string | undefined))\n  }\n\n  // BREP 路径（直接执行，不包 try-catch！异常 = 未预期错误，冒泡上报）\n  // P2：brepChain（meshShapeCache）归引擎侧，loadBrep 不再传\n  // partIndex：多 part 文件（如多 solid STEP）逐 part 加载——宿主为每个 part\n  // 生成独立 load 语句并携带 partIndex，提取 Compound 中对应子 solid。\n  const partIndex = typeof params.partIndex === 'number' ? params.partIndex : undefined\n  const { solid: solidHandle, shape } = loadBrep(\n    kernel!, buffer, undefined, undefined, partIndex,\n  )\n  return fromBrep(shape, { solid: solidHandle })\n}\n"]}

package/dist/api/svgExtrude.d.ts

@@ -1,32 +0,0 @@
-/**
- * stdlib svgExtrude — SVG 挤出创建库函数（creator 函数，无输入）
- *
- *
- * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
- */
-import type { Shape } from '../mesh/types.js';
-/**
- * Validate svgExtrude parameters: `svg` is required and `depth` must be a
- * positive number.
- * @param params - the raw svgExtrude operation parameters.
- */
-export declare function assertSvgExtrudeParams(params: Record<string, unknown>): void;
-/**
- * 从二维 SVG 轮廓挤出零件（拓扑操作）。
- * @group 创建
- * @inputs 0
- * @async true
- * @qual warn
- * @name svgExtrude
- * @note SVG 是外部资产，应优先用资产引用（`cad.asset(key)` 经 CallRefIR）而非整份 XML 内联拷贝。自然尺寸（viewBox）与缩放已显式成参数（mesh/BREP 两条路径都解析 viewBox 并传递 naturalWidth/naturalHeight），尺寸语义不再依赖两套实现各自推导。
- * @returns Shape SVG 挤出几何，生成独立零件。
- * @param params.svg - SVG 内容：资产 key（推荐）或整份 SVG 文本（兼容）。type:string required:true
- * @param params.depth - 挤出深度（mm）。type:number required:true
- * @param params.targetLongSide - 长边目标尺寸（mm）。type:number 默认 20
- * @example
- * const s = await cad.svgExtrude({ svg: 'logo.svg', depth: 5, targetLongSide: 20 })
-  */
-export declare const svgExtrude: ((params: Record<string, unknown>) => Promise<Shape>) & {
-    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
-};
-//# sourceMappingURL=svgExtrude.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"svgExtrude.d.ts","sourceRoot":"","sources":["../../src/api/svgExtrude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAc1C;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAK5E;AAeD;;;;;;;;;;;;;;IAcI;AACJ,eAAO,MAAM,UAAU;;CAoBrB,CAAA"}

package/dist/api/svgExtrude.js

@@ -1,74 +0,0 @@
-/**
- * stdlib svgExtrude — SVG 挤出创建库函数（creator 函数，无输入）
- *
- *
- * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
- */
-import { cad } from '../mesh/index.js';
-import { parseSvgNaturalSize } from '../primitives/parse-svg-size.js';
-import { svgToSolid } from '../brep/svg/svg-to-solid.js';
-import { solidToShape } from '../brep/brep-ops.js';
-import { resolveSvgArg } from './internal/svg-asset-resolver.js';
-import { getBackends } from '../runtime-state.js';
-import { fromBrep } from '../shape.js';
-import { defineOp } from '../sdk.js';
-import { assertPositiveNumber } from './assert.js';
-/**
- * Validate svgExtrude parameters: `svg` is required and `depth` must be a
- * positive number.
- * @param params - the raw svgExtrude operation parameters.
- */
-export function assertSvgExtrudeParams(params) {
-    if (params.svg === undefined || params.svg === null || params.svg === '') {
-        throw new Error(`[stdlib/svgExtrude] svg is required, got ${JSON.stringify(params.svg)}`);
-    }
-    assertPositiveNumber(params.depth, 'svgExtrude.depth');
-}
-/** BREP 路径：SVG path 解析 → OCCT wire/face → extrude + fromBrep 登记。 */
-function svgExtrudeBrep(params, svgText) {
-    const kernel = getBackends().kernel.brep;
-    if (!kernel)
-        throw new Error('[stdlib/svgExtrude] no OCCT kernel');
-    const solidHandle = svgToSolid(kernel, svgText, {
-        depth: params.depth,
-        targetLongSide: params.targetLongSide ?? 20,
-    });
-    return fromBrep(solidToShape(kernel, solidHandle), { solid: solidHandle });
-}
-/**
- * 从二维 SVG 轮廓挤出零件（拓扑操作）。
- * @group 创建
- * @inputs 0
- * @async true
- * @qual warn
- * @name svgExtrude
- * @note SVG 是外部资产，应优先用资产引用（`cad.asset(key)` 经 CallRefIR）而非整份 XML 内联拷贝。自然尺寸（viewBox）与缩放已显式成参数（mesh/BREP 两条路径都解析 viewBox 并传递 naturalWidth/naturalHeight），尺寸语义不再依赖两套实现各自推导。
- * @returns Shape SVG 挤出几何，生成独立零件。
- * @param params.svg - SVG 内容：资产 key（推荐）或整份 SVG 文本（兼容）。type:string required:true
- * @param params.depth - 挤出深度（mm）。type:number required:true
- * @param params.targetLongSide - 长边目标尺寸（mm）。type:number 默认 20
- * @example
- * const s = await cad.svgExtrude({ svg: 'logo.svg', depth: 5, targetLongSide: 20 })
-  */
-export const svgExtrude = defineOp({
-    mesh: async (params) => {
-        assertSvgExtrudeParams(params);
-        const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets });
-        // mesh 路径：与 BREP 路径一致，内部解析 SVG 自然尺寸后缩放
-        const { naturalWidth, naturalHeight } = parseSvgNaturalSize(svgText);
-        return cad.svgExtrude({
-            svg: svgText,
-            depth: params.depth,
-            targetLongSide: params.targetLongSide ?? 20,
-            naturalWidth,
-            naturalHeight,
-        });
-    },
-    brep: async (params) => {
-        assertSvgExtrudeParams(params);
-        const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets });
-        return svgExtrudeBrep(params, svgText);
-    },
-    naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } },
-});
-//# sourceMappingURL=svgExtrude.js.map

package/dist/api/svgExtrude.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"svgExtrude.js","sourceRoot":"","sources":["../../src/api/svgExtrude.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAG/C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B;IACpE,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,MAAM,CAAC,GAAG,KAAK,EAAE,EAAE,CAAC;QACzE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC3F,CAAC;IACD,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAAC,CAAA;AACxD,CAAC;AAED,oEAAoE;AACpE,SAAS,cAAc,CAAC,MAA+B,EAAE,OAAe;IACtE,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAA4B,CAAA;IAChE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAElE,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE;QAC9C,KAAK,EAAE,MAAM,CAAC,KAAe;QAC7B,cAAc,EAAG,MAAM,CAAC,cAAqC,IAAI,EAAE;KACpE,CAAC,CAAA;IAEF,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAA;AAC5E,CAAC;AAED;;;;;;;;;;;;;;IAcI;AACJ,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;IACjC,IAAI,EAAE,KAAK,EAAE,MAA+B,EAAE,EAAE;QAC9C,sBAAsB,CAAC,MAAM,CAAC,CAAA;QAC9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,MAAmC,EAAE,CAAC,CAAA;QAC9G,uCAAuC;QACvC,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAA;QACpE,OAAO,GAAG,CAAC,UAAU,CAAC;YACpB,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,MAAM,CAAC,KAAe;YAC7B,cAAc,EAAG,MAAM,CAAC,cAAqC,IAAI,EAAE;YACnE,YAAY;YACZ,aAAa;SACd,CAAC,CAAA;IACJ,CAAC;IACD,IAAI,EAAE,KAAK,EAAE,MAA+B,EAAE,EAAE;QAC9C,sBAAsB,CAAC,MAAM,CAAC,CAAA;QAC9B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,MAAmC,EAAE,CAAC,CAAA;QAC9G,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE,EAAgB;CACtF,CAAC,CAAA","sourcesContent":["/**\n * stdlib svgExtrude — SVG 挤出创建库函数（creator 函数，无输入）\n *\n *\n * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。\n */\n\nimport type { Shape } from '../mesh/types'\nimport type { AssetResolver } from '../cad-runtime/ports'\nimport { cad } from '../mesh'\nimport { parseSvgNaturalSize } from '../primitives/parse-svg-size'\nimport { svgToSolid } from '../brep/svg/svg-to-solid'\nimport { solidToShape } from '../brep/brep-ops'\nimport { resolveSvgArg } from './internal/svg-asset-resolver'\nimport { getBackends } from '../runtime-state'\nimport { fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { assertPositiveNumber } from './assert'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/**\n * Validate svgExtrude parameters: `svg` is required and `depth` must be a\n * positive number.\n * @param params - the raw svgExtrude operation parameters.\n */\nexport function assertSvgExtrudeParams(params: Record<string, unknown>): void {\n  if (params.svg === undefined || params.svg === null || params.svg === '') {\n    throw new Error(`[stdlib/svgExtrude] svg is required, got ${JSON.stringify(params.svg)}`)\n  }\n  assertPositiveNumber(params.depth, 'svgExtrude.depth')\n}\n\n/** BREP 路径：SVG path 解析 → OCCT wire/face → extrude + fromBrep 登记。 */\nfunction svgExtrudeBrep(params: Record<string, unknown>, svgText: string): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/svgExtrude] no OCCT kernel')\n\n  const solidHandle = svgToSolid(kernel, svgText, {\n    depth: params.depth as number,\n    targetLongSide: (params.targetLongSide as number | undefined) ?? 20,\n  })\n\n  return fromBrep(solidToShape(kernel, solidHandle), { solid: solidHandle })\n}\n\n/**\n * 从二维 SVG 轮廓挤出零件（拓扑操作）。\n * @group 创建\n * @inputs 0\n * @async true\n * @qual warn\n * @name svgExtrude\n * @note SVG 是外部资产，应优先用资产引用（`cad.asset(key)` 经 CallRefIR）而非整份 XML 内联拷贝。自然尺寸（viewBox）与缩放已显式成参数（mesh/BREP 两条路径都解析 viewBox 并传递 naturalWidth/naturalHeight），尺寸语义不再依赖两套实现各自推导。\n * @returns Shape SVG 挤出几何，生成独立零件。\n * @param params.svg - SVG 内容：资产 key（推荐）或整份 SVG 文本（兼容）。type:string required:true\n * @param params.depth - 挤出深度（mm）。type:number required:true\n * @param params.targetLongSide - 长边目标尺寸（mm）。type:number 默认 20\n * @example\n * const s = await cad.svgExtrude({ svg: 'logo.svg', depth: 5, targetLongSide: 20 })\n  */\nexport const svgExtrude = defineOp({\n  mesh: async (params: Record<string, unknown>) => {\n    assertSvgExtrudeParams(params)\n    const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets as AssetResolver | undefined })\n    // mesh 路径：与 BREP 路径一致，内部解析 SVG 自然尺寸后缩放\n    const { naturalWidth, naturalHeight } = parseSvgNaturalSize(svgText)\n    return cad.svgExtrude({\n      svg: svgText,\n      depth: params.depth as number,\n      targetLongSide: (params.targetLongSide as number | undefined) ?? 20,\n      naturalWidth,\n      naturalHeight,\n    })\n  },\n  brep: async (params: Record<string, unknown>) => {\n    assertSvgExtrudeParams(params)\n    const svgText = await resolveSvgArg(params.svg, { assets: getBackends().assets as AssetResolver | undefined })\n    return svgExtrudeBrep(params, svgText)\n  },\n  naming: { kind: 'construct', newFaces: { via: 'explicit', vocab: [] } } as Provenance,\n})\n"]}

package/dist/api/text.d.ts

@@ -1,34 +0,0 @@
-/**
- * stdlib text — 文字创建库函数（text）
- *
- *
- * dispatchPath 静态判定 brep/mesh，产物经 solid()/fromBrep() 构造器创建。
- */
-import type { Shape } from '../mesh/types.js';
-/**
- * Validate text parameters: `text` must be a non-empty string, and `size` and
- * `depth` must be positive numbers.
- * @param params - the raw text operation parameters.
- */
-export declare function assertTextParams(params: Record<string, unknown>): void;
-/**
- * 生成文字零件（文字轮廓挤出，X/Z 居中、Y 底部对齐原点）。
- * @group 创建
- * @inputs 0
- * @async true
- * @qual warn
- * @name text
- * @returns Shape 文字几何，生成独立零件。
- * @param maybeParams - 兼容形态的补充参数（正常不传）。type:Record<string, unknown> required:false
- * @param inputOrParams.text - 要生成的文字。type:string required:true
- * @param inputOrParams.size - 字号（mm）。type:number required:true
- * @param inputOrParams.depth - 挤出深度（mm）。type:number required:true
- * @param inputOrParams.font - 字体。type:string 默认 默认字体
- * @note font 语义未定（当前只有默认字体），⚠️ 暂不要传。兼容 `cad.text(part0, {...})` 带输入形态（输入被忽略），正常写 `cad.text({...})` 即可。
- * @example
- * const t = await cad.text({ text: 'Hello', size: 20, depth: 5 })
-  */
-export declare const text: ((inputOrParams: unknown, maybeParams?: Record<string, unknown> | undefined) => Promise<Shape>) & {
-    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
-};
-//# sourceMappingURL=text.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/api/text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAc1C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAMtE;AAmDD;;;;;;;;;;;;;;;;IAgBI;AACJ,eAAO,MAAM,IAAI;;CAYf,CAAA"}