@faicad/faijs 0.33.2 → 0.35.8

package/dist/api/feature-repair.js.map

@@ -1 +1 @@
-{"version":3,"file":"feature-repair.js","sourceRoot":"","sources":["../../src/api/feature-repair.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAI3D,gCAAgC;AAChC,SAAS,WAAW,CAAC,KAAY,EAAE,EAAU;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAA;IACtD,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAA;IACnG,OAAO,MAAM,CAAA;AACf,CAAC;AAED,iDAAiD;AACjD,SAAS,YAAY,CAAC,MAAqC,EAAE,KAAY,EAAE,IAAmB,EAAE,EAAU;IACxG,MAAM,GAAG,GAAG,0BAA0B,CAAC,MAAM,EAAE,KAAe,CAAC,CAAA;IAC/D,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,oCAAoC,CAAC,CAAA;IACvG,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,IAAI,CAAC,GAAG,IAAK,GAA0B,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,sEAAsE,CAAC,CAAA;QAC9G,CAAC;QACD,MAAM,CAAC,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAClC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,MAAM,EAAE,GAAG,EAAE,mCAAmC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAA;QACvH,CAAC;QACD,OAAO,CAAC,CAAC,MAAoB,CAAA;IAC/B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,kCAAkC;AAClC,SAAS,aAAa,CAAC,MAAe,EAAE,EAAU;IAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,uCAAuC,CAAC,CAAA;IAChG,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAA2B,CAAA;QAC7C,IAAI,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,0BAA0B,CAAC,CAAA;QACvF,OAAO,CAAC,CAAA;IACV,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,MAAqC,EAAE,MAAkB;IACtE,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,YAAY,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,EAAoB,CAAA;AAE3F;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;IAChC,IAAI,CAAC,KAAY,EAAE,KAAoB;QACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACtF,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QAC7C,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;QAC/D,OAAO,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;IACxD,CAAC;IACD,MAAM,EAAE,YAAY;IAEpB,SAAS,EAAE,EAAE;CACd,CAAC,CAAA;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;IACnC,6CAA6C;IAC7C,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,IAAI,CAAC,KAAY;QACf,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;QAChD,OAAO,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;IAClD,CAAC;IACD,MAAM,EAAE,YAAY;IAEpB,SAAS,EAAE,EAAE;CACd,CAAC,CAAA;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;IACtC,IAAI,CAAC,KAAY;QACf,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAA;QACnD,OAAO,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;IACrD,CAAC;IACD,MAAM,EAAE,YAAY;IAEpB,SAAS,EAAE,EAAE;CACd,CAAC,CAAA;AAQF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,QAAQ,CAAC;IAC1B,IAAI,CAAC,MAAe,EAAE,MAAkB;QACtC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;QAC5C,OAAO,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IAC9D,CAAC;IACD,MAAM,EAAE,YAAY;IAEpB,SAAS,EAAE,EAAE;CACd,CAAC,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;IACrC,IAAI,CAAC,MAAe,EAAE,MAAkB;QACtC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;QACvD,OAAO,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;IACzE,CAAC;IACD,MAAM,EAAE,YAAY;IAEpB,SAAS,EAAE,EAAE;CACd,CAAC,CAAA;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAC1C,IAAI,CAAC,IAAW;QACd,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAA;QAC9F,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;QAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAA2B,CAAA;QACrD,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAA;QACzG,OAAO,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAA;IAC1D,CAAC;IACD,MAAM,EAAE,YAAY;IAEpB,SAAS,EAAE,EAAE;CACd,CAAC,CAAA","sourcesContent":["/**\n * api feature-repair — L1 薄包装族（手写 op，Phase 5）\n *\n * 六条 L1 已有动作的手写薄包装，全部走 `getBrepApi()`（D12）：\n * - `defeature(shape, faces)` — 移除特征面（孔/凸台等）\n * - `removeHolesFromFace(face)` — 移除面上的孔\n * - `reverseShape(shape)` — 反转壳体朝向 —— **occt-only**（见下）\n * - `unifySameDomain(shape)` — 合并同域面/边\n * - `sew(shapes, tolerance?)` — 缝合壳\n * - `sewAndSolidify(shapes, tolerance?)` — 缝合并固化为实体\n *\n * 每条都极薄：解析入参 → 直调 L1 → 收养。选面口径与 `shell`/`draft` 一致\n * （FaceTopoRef[]，设计原则 4）。\n *\n * 引擎声明（**逐条判定，不整族一刀切**）：\n * - `reverseShape` 声明 `engines: ['occt']` —— 实证收窄：brepkit 实测在 **op 级**\n *   失败（`invalid solid handle: index N is out of bounds`，callee = reverseShape，\n *   非输入构造侧），静态门须在执行前拒绝。\n * - 其余五条保持中立（无 engines）。\n *   注意 `unifySameDomain` 在 brepkit 上**可用但语义有差**（会把体重新居中），\n *   未收窄 —— 缺证据表明它不可用，不擅自扩大范围。\n *\n * 未覆盖（诚实留档，本轮未验）：`defeature` / `sew` / `sewAndSolidify` /\n * `removeHolesFromFace` 在 brepkit 上的 op 级行为未取得干净证据（探针的面输入\n * 先撞到 faceRef/输入构造侧限制），故不做引擎声明。\n */\n\nimport type { Shape } from '../mesh/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { brepOf, fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { FaceTopoRef } from '../topology/naming'\nimport { resolveTopoRef, TopoRefError } from '../topology/naming'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { buildEdgeResolutionContext } from './topo-resolve'\n\ntype ProvenanceLike = Provenance\n\n/** BREP 输入守卫：取 BREP 句柄，无则报错。 */\nfunction requireBrep(input: Shape, op: string): BrepHandle {\n  const handle = brepOf(input) as BrepHandle | undefined\n  if (handle === undefined) throw new Error(`E_${op.toUpperCase()}_NO_BREP: ${op} input is not BREP`)\n  return handle\n}\n\n/** 解析 FaceTopoRef[] → 句柄数组（shell/draft 同款口径）。 */\nfunction resolveFaces(kernel: ReturnType<typeof getBrepApi>, input: Shape, refs: FaceTopoRef[], op: string): BrepHandle[] {\n  const ctx = buildEdgeResolutionContext(kernel, input as object)\n  if (!ctx) throw new TopoRefError('E_TOPO_NOT_FOUND', 'face', `${op}: input has no BREP naming context`)\n  return refs.map((ref) => {\n    if (!ref || (ref as { kind?: unknown }).kind !== 'face') {\n      throw new Error(`E_${op.toUpperCase()}_BAD_FACE_REF: every faces entry must be a FaceTopoRef (cad.faceRef)`)\n    }\n    const r = resolveTopoRef(ref, ctx)\n    if (r.handle === undefined) {\n      throw new TopoRefError('E_TOPO_NOT_FOUND', 'face', `${op}: face resolved without handle (${ref.origin}/${ref.role})`)\n    }\n    return r.handle as BrepHandle\n  })\n}\n\n/** 借入一组输入 Shape → 句柄数组（sew 族）。 */\nfunction borrowHandles(shapes: Shape[], op: string): BrepHandle[] {\n  if (!Array.isArray(shapes) || shapes.length === 0) {\n    throw new Error(`E_${op.toUpperCase()}_NO_SHAPES: ${op} requires a non-empty array of shapes`)\n  }\n  return shapes.map((s) => {\n    const h = brepOf(s) as BrepHandle | undefined\n    if (!h) throw new Error(`E_${op.toUpperCase()}_NO_BREP: ${op} input shape is not BREP`)\n    return h\n  })\n}\n\nfunction adopt(kernel: ReturnType<typeof getBrepApi>, handle: BrepHandle): Shape {\n  return fromBrep(solidToShape(kernel, handle), { solid: handle })\n}\n\nconst kernelNaming = { kind: 'kernel', newFaces: { via: 'byAdjacency' } } as ProvenanceLike\n\n/**\n * 移除特征面（孔/凸台等），恢复基础形状。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name defeature\n * @note 中立 op：L1 defeature 两引擎同实现。仅 BREP 可用。\n * @returns Shape 移除特征后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param faces - 要移除的面（FaceTopoRef[]，cad.faceRef 产物）。type:FaceTopoRef[] required:true\n * @example\n * const base = await cad.defeature(part0, [cad.faceRef(part0, 5)])\n */\nexport const defeature = defineOp({\n  brep(input: Shape, faces: FaceTopoRef[]) {\n    if (!Array.isArray(faces) || faces.length === 0) {\n      throw new Error('E_DEFEATURE_NO_FACES: defeature requires at least one FaceTopoRef')\n    }\n    const kernel = getBrepApi()\n    const solid = requireBrep(input, 'defeature')\n    const handles = resolveFaces(kernel, input, faces, 'defeature')\n    return adopt(kernel, kernel.defeature(solid, handles))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 反转壳体朝向（内表面 ↔ 外表面）。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name reverseShape\n * @note **occt-only**（`engines: ['occt']`，实证收窄）：brepkit 实测在 op 级抛\n *       `invalid solid handle: index N is out of bounds`（非输入侧失败），\n *       故由静态门在执行前拒绝而非等到运行时。产物 `getVolume` 返回**有向**体积\n *       （朝向反转 ⇒ 符号翻转）。仅 BREP 可用。\n * @returns Shape 朝向反转后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @example\n * const flipped = await cad.reverseShape(sh)\n */\nexport const reverseShape = defineOp({\n  // 实证收窄（2026-09-24）：brepkit op 级失败 → 静态门提前拒绝。\n  engines: ['occt'],\n  brep(input: Shape) {\n    const kernel = getBrepApi()\n    const solid = requireBrep(input, 'reverseShape')\n    return adopt(kernel, kernel.reverseShape(solid))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 合并同域面/边（去除被分割成多片的冗余细分）。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name unifySameDomain\n * @note 中立 op：L1 unifySameDomain 两引擎同实现。仅 BREP 可用。\n * @returns Shape 合并后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @example\n * const merged = await cad.unifySameDomain(part0)\n */\nexport const unifySameDomain = defineOp({\n  brep(input: Shape) {\n    const kernel = getBrepApi()\n    const solid = requireBrep(input, 'unifySameDomain')\n    return adopt(kernel, kernel.unifySameDomain(solid))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/** `cad.sew` / `cad.sewAndSolidify` 公共参数。 */\nexport interface SewParams {\n  /** 缝合容差（mm，可选）。 */\n  tolerance?: number\n}\n\n/**\n * 缝合：把一组面/壳沿公共边缝成一张壳。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name sew\n * @note 中立 op：L1 sew 两引擎同实现。产物是壳（不保证闭合）；要实体用 sewAndSolidify。\n * @returns Shape 缝合后的壳。\n * @param shapes - 面/壳集合。type:Shape[] required:true\n * @param params.tolerance - 缝合容差（mm）。type:number required:false\n * @example\n * const shellShape = await cad.sew([f1, f2, f3], { tolerance: 1e-5 })\n */\nexport const sew = defineOp({\n  brep(shapes: Shape[], params?: SewParams) {\n    const kernel = getBrepApi()\n    const handles = borrowHandles(shapes, 'sew')\n    return adopt(kernel, kernel.sew(handles, params?.tolerance))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 缝合并固化为实体：缝合后若闭合则生成 solid。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name sewAndSolidify\n * @note 中立 op：L1 sewAndSolidify 两引擎同实现。仅 BREP 可用。\n * @returns Shape 缝合固化后的实体。\n * @param shapes - 面/壳集合。type:Shape[] required:true\n * @param params.tolerance - 缝合容差（mm）。type:number required:false\n * @example\n * const solid = await cad.sewAndSolidify([f1, f2, f3, f4, f5, f6])\n */\nexport const sewAndSolidify = defineOp({\n  brep(shapes: Shape[], params?: SewParams) {\n    const kernel = getBrepApi()\n    const handles = borrowHandles(shapes, 'sewAndSolidify')\n    return adopt(kernel, kernel.sewAndSolidify(handles, params?.tolerance))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 移除面（或实体某面）上的孔。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name removeHolesFromFace\n * @note 中立 op：L1 removeHolesFromFace 两引擎同实现。入参为含孔的面 Shape\n *       （L1 形参是面句柄；借入输入 Shape 的 BREP 槽位句柄）。\n * @returns Shape 去孔后的面。\n * @param face - 含孔的面几何。type:Shape required:true\n * @example\n * const plain = await cad.removeHolesFromFace(faceWithHoles)\n */\nexport const removeHolesFromFace = defineOp({\n  brep(face: Shape) {\n    if (!face) throw new Error('E_REMOVEHOLES_NO_FACE: removeHolesFromFace requires a face shape')\n    const kernel = getBrepApi()\n    const handle = brepOf(face) as BrepHandle | undefined\n    if (handle === undefined) throw new Error('E_REMOVEHOLES_NO_BREP: removeHolesFromFace input is not BREP')\n    return adopt(kernel, kernel.removeHolesFromFace(handle))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n"]}
+{"version":3,"file":"feature-repair.js","sourceRoot":"","sources":["../../src/api/feature-repair.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api feature-repair — L1 薄包装族（手写 op，Phase 5）\n *\n * 六条 L1 已有动作的手写薄包装，全部走 `getBrepApi()`（D12）：\n * - `defeature(shape, faces)` — 移除特征面（孔/凸台等）\n * - `removeHolesFromFace(face)` — 移除面上的孔\n * - `reverseShape(shape)` — 反转壳体朝向 —— **occt-only**（见下）\n * - `unifySameDomain(shape)` — 合并同域面/边\n * - `sew(shapes, tolerance?)` — 缝合壳\n * - `sewAndSolidify(shapes, tolerance?)` — 缝合并固化为实体\n *\n * 每条都极薄：解析入参 → 直调 L1 → 收养。选面口径与 `shell`/`draft` 一致\n * （FaceTopoRef[]，设计原则 4）。\n *\n * 引擎声明（**逐条判定，不整族一刀切**）：\n * - `reverseShape` 声明 `engines: ['occt']` —— 实证收窄：brepkit 实测在 **op 级**\n *   失败（`invalid solid handle: index N is out of bounds`，callee = reverseShape，\n *   非输入构造侧），静态门须在执行前拒绝。\n * - 其余五条保持中立（无 engines）。\n *   注意 `unifySameDomain` 在 brepkit 上**可用但语义有差**（会把体重新居中），\n *   未收窄 —— 缺证据表明它不可用，不擅自扩大范围。\n *\n * 未覆盖（诚实留档，本轮未验）：`defeature` / `sew` / `sewAndSolidify` /\n * `removeHolesFromFace` 在 brepkit 上的 op 级行为未取得干净证据（探针的面输入\n * 先撞到 faceRef/输入构造侧限制），故不做引擎声明。\n */\n\nimport type { Shape } from '../mesh/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { brepOf, fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { FaceTopoRef } from '../topology/naming'\nimport { resolveTopoRef, TopoRefError } from '../topology/naming'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { buildEdgeResolutionContext } from './topo-resolve'\nimport { expandFaceSelectorRefs } from './selectors-to-refs'\n\ntype ProvenanceLike = Provenance\n\n/** BREP 输入守卫：取 BREP 句柄，无则报错。 */\nfunction requireBrep(input: Shape, op: string): BrepHandle {\n  const handle = brepOf(input) as BrepHandle | undefined\n  if (handle === undefined) throw new Error(`E_${op.toUpperCase()}_NO_BREP: ${op} input is not BREP`)\n  return handle\n}\n\n/** 解析面选择器（FaceTopoRef[] | 字符串）→ 句柄数组（shell/draft 同款口径）。 */\nfunction resolveFaces(kernel: ReturnType<typeof getBrepApi>, input: Shape, refs: FaceTopoRef[] | string, op: string): BrepHandle[] {\n  const ctx = buildEdgeResolutionContext(kernel, input as object)\n  if (!ctx) throw new TopoRefError('E_TOPO_NOT_FOUND', 'face', `${op}: input has no BREP naming context`)\n  // 展开选择器字符串 → FaceTopoRef[]，再逐 ref 解析句柄\n  return expandFaceSelectorRefs(input, refs).map((ref) => {\n    if (!ref || (ref as { kind?: unknown }).kind !== 'face') {\n      throw new Error(`E_${op.toUpperCase()}_BAD_FACE_REF: every faces entry must be a FaceTopoRef (cad.faceRef) or a selector string`)\n    }\n    const r = resolveTopoRef(ref, ctx)\n    if (r.handle === undefined) {\n      throw new TopoRefError('E_TOPO_NOT_FOUND', 'face', `${op}: face resolved without handle (${ref.origin}/${ref.role})`)\n    }\n    return r.handle as BrepHandle\n  })\n}\n\n/** 借入一组输入 Shape → 句柄数组（sew 族）。 */\nfunction borrowHandles(shapes: Shape[], op: string): BrepHandle[] {\n  if (!Array.isArray(shapes) || shapes.length === 0) {\n    throw new Error(`E_${op.toUpperCase()}_NO_SHAPES: ${op} requires a non-empty array of shapes`)\n  }\n  return shapes.map((s) => {\n    const h = brepOf(s) as BrepHandle | undefined\n    if (!h) throw new Error(`E_${op.toUpperCase()}_NO_BREP: ${op} input shape is not BREP`)\n    return h\n  })\n}\n\nfunction adopt(kernel: ReturnType<typeof getBrepApi>, handle: BrepHandle): Shape {\n  return fromBrep(solidToShape(kernel, handle), { solid: handle })\n}\n\nconst kernelNaming = { kind: 'kernel', newFaces: { via: 'byAdjacency' } } as ProvenanceLike\n\n/**\n * 移除特征面（孔/凸台等），恢复基础形状。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name defeature\n * @note 中立 op：L1 defeature 两引擎同实现。仅 BREP 可用。\n * @returns Shape 移除特征后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param faces - 要移除的面：面选择器字符串（如 \"|Z\"，AI 生成）或 FaceTopoRef[]（UI 拾取产物字面量；禁止 cad.faceRef 序号）。type:FaceTopoRef[]|string required:true\n * @example\n * // faces 取 UI 拾取产物的 FaceTopoRef 字面量；❌ 禁止 cad.faceRef 序号（跨内核不可移植）\n * const base = await cad.defeature(part0, pickedFaces)\n * // AI 生成可写 CadQuery 面选择器字符串\n * const base2 = await cad.defeature(part0, \"|Z\")\n */\nexport const defeature = defineOp({\n  brep(input: Shape, faces: FaceTopoRef[] | string) {\n    if (typeof faces !== 'string' && (!Array.isArray(faces) || faces.length === 0)) {\n      throw new Error('E_DEFEATURE_NO_FACES: defeature requires at least one FaceTopoRef or a face selector string')\n    }\n    const kernel = getBrepApi()\n    const solid = requireBrep(input, 'defeature')\n    const handles = resolveFaces(kernel, input, faces, 'defeature')\n    return adopt(kernel, kernel.defeature(solid, handles))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 反转壳体朝向（内表面 ↔ 外表面）。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name reverseShape\n * @note **occt-only**（`engines: ['occt']`，实证收窄）：brepkit 实测在 op 级抛\n *       `invalid solid handle: index N is out of bounds`（非输入侧失败），\n *       故由静态门在执行前拒绝而非等到运行时。产物 `getVolume` 返回**有向**体积\n *       （朝向反转 ⇒ 符号翻转）。仅 BREP 可用。\n * @returns Shape 朝向反转后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @example\n * const flipped = await cad.reverseShape(sh)\n */\nexport const reverseShape = defineOp({\n  // 实证收窄（2026-09-24）：brepkit op 级失败 → 静态门提前拒绝。\n  engines: ['occt'],\n  brep(input: Shape) {\n    const kernel = getBrepApi()\n    const solid = requireBrep(input, 'reverseShape')\n    return adopt(kernel, kernel.reverseShape(solid))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 合并同域面/边（去除被分割成多片的冗余细分）。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name unifySameDomain\n * @note 中立 op：L1 unifySameDomain 两引擎同实现。仅 BREP 可用。\n * @returns Shape 合并后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @example\n * const merged = await cad.unifySameDomain(part0)\n */\nexport const unifySameDomain = defineOp({\n  brep(input: Shape) {\n    const kernel = getBrepApi()\n    const solid = requireBrep(input, 'unifySameDomain')\n    return adopt(kernel, kernel.unifySameDomain(solid))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/** `cad.sew` / `cad.sewAndSolidify` 公共参数。 */\nexport interface SewParams {\n  /** 缝合容差（mm，可选）。 */\n  tolerance?: number\n}\n\n/**\n * 缝合：把一组面/壳沿公共边缝成一张壳。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name sew\n * @note 中立 op：L1 sew 两引擎同实现。产物是壳（不保证闭合）；要实体用 sewAndSolidify。\n * @returns Shape 缝合后的壳。\n * @param shapes - 面/壳集合。type:Shape[] required:true\n * @param params.tolerance - 缝合容差（mm）。type:number required:false\n * @example\n * const shellShape = await cad.sew([f1, f2, f3], { tolerance: 1e-5 })\n */\nexport const sew = defineOp({\n  brep(shapes: Shape[], params?: SewParams) {\n    const kernel = getBrepApi()\n    const handles = borrowHandles(shapes, 'sew')\n    return adopt(kernel, kernel.sew(handles, params?.tolerance))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 缝合并固化为实体：缝合后若闭合则生成 solid。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name sewAndSolidify\n * @note 中立 op：L1 sewAndSolidify 两引擎同实现。仅 BREP 可用。\n * @returns Shape 缝合固化后的实体。\n * @param shapes - 面/壳集合。type:Shape[] required:true\n * @param params.tolerance - 缝合容差（mm）。type:number required:false\n * @example\n * const solid = await cad.sewAndSolidify([f1, f2, f3, f4, f5, f6])\n */\nexport const sewAndSolidify = defineOp({\n  brep(shapes: Shape[], params?: SewParams) {\n    const kernel = getBrepApi()\n    const handles = borrowHandles(shapes, 'sewAndSolidify')\n    return adopt(kernel, kernel.sewAndSolidify(handles, params?.tolerance))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n\n/**\n * 移除面（或实体某面）上的孔。\n * @group 修复\n * @inputs 1\n * @async true\n * @qual ok\n * @name removeHolesFromFace\n * @note 中立 op：L1 removeHolesFromFace 两引擎同实现。入参为含孔的面 Shape\n *       （L1 形参是面句柄；借入输入 Shape 的 BREP 槽位句柄）。\n * @returns Shape 去孔后的面。\n * @param face - 含孔的面几何。type:Shape required:true\n * @example\n * const plain = await cad.removeHolesFromFace(faceWithHoles)\n */\nexport const removeHolesFromFace = defineOp({\n  brep(face: Shape) {\n    if (!face) throw new Error('E_REMOVEHOLES_NO_FACE: removeHolesFromFace requires a face shape')\n    const kernel = getBrepApi()\n    const handle = brepOf(face) as BrepHandle | undefined\n    if (handle === undefined) throw new Error('E_REMOVEHOLES_NO_BREP: removeHolesFromFace input is not BREP')\n    return adopt(kernel, kernel.removeHolesFromFace(handle))\n  },\n  naming: kernelNaming,\n\n  paramDims: {},\n})\n"]}

package/dist/api/fillet-variable.d.ts

@@ -11,6 +11,8 @@
  */
 import type { Shape } from '../mesh/types.js';
 import type { EdgeTopoRef } from '../topology/naming/index.js';
+/** 单边选择：EdgeTopoRef（UI 拾取产物）或 CadQuery 边选择器字符串（AI 生成）。 */
+export type FilletVariableEdge = EdgeTopoRef | string;
 /**
  * 变半径圆角：对单条边施加从起点到终点的线性变半径圆角。
  * @group 特征
@@ -23,13 +25,15 @@ import type { EdgeTopoRef } from '../topology/naming/index.js';
  *       仅 BREP 可用。
  * @returns Shape 变半径圆角后的几何。
  * @param input - 目标几何。type:Shape required:true
- * @param edge - 目标边（EdgeTopoRef，同 cad.fillet 的 edges 条目）。type:EdgeTopoRef required:true
+ * @param edge - 目标边：EdgeTopoRef（同 cad.fillet 的 edges 条目，UI 拾取产物）或 CadQuery 边选择器字符串（如 "|Z"，AI 生成；多边命中抛错）。type:EdgeTopoRef|string required:true
  * @param r1 - 起点半径（mm，>0）。type:number required:true
  * @param r2 - 终点半径（mm，>0）。type:number required:true
  * @example
  * const v = await cad.filletVariable(part0, partEdges[0], 1, 4)
+ * // AI 生成可写 CadQuery 边选择器字符串
+ * const v2 = await cad.filletVariable(part0, "|Z", 1, 4)
  */
-export declare const filletVariable: ((input: Shape, edge: EdgeTopoRef, r1: number, r2: number) => Promise<Shape>) & {
+export declare const filletVariable: ((input: Shape, edge: FilletVariableEdge, r1: number, r2: number) => Promise<Shape>) & {
     __faijs__dualOp?: import("../define-op.js").DualOpMeta;
 };
 //# sourceMappingURL=fillet-variable.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fillet-variable.d.ts","sourceRoot":"","sources":["../../src/api/fillet-variable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAM1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAkCrD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc;;CAOzB,CAAA"}
+{"version":3,"file":"fillet-variable.d.ts","sourceRoot":"","sources":["../../src/api/fillet-variable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAM1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAMrD,0DAA0D;AAC1D,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAA;AAiDrD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc;;CAOzB,CAAA"}

package/dist/api/fillet-variable.js

@@ -15,12 +15,28 @@ import { brepOf, fromBrep } from '../shape.js';
 import { defineOp } from '../sdk.js';
 import { resolveTopoRef, TopoRefError } from '../topology/naming/index.js';
 import { buildEdgeResolutionContext } from './topo-resolve.js';
+import { resolveSelectorToEdgeRefs } from './selectors-to-refs.js';
 /** BREP 路径：解析边引用 → L1 filletVariable → 收养。 */
 function filletVariableBrep(input, edge, startRadius, endRadius) {
-    if (!edge || edge.kind !== 'edge') {
-        throw new Error('E_FILLETVAR_BAD_EDGE_REF: edge must be an EdgeTopoRef (as consumed by cad.fillet)');
+    let edgeRef;
+    if (typeof edge === 'string') {
+        // 选择器字符串 → 解析；单边参数多命中 → 抛错（R3：不静默取第一个）。
+        const refs = resolveSelectorToEdgeRefs(input, edge);
+        if (refs.length === 0) {
+            throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `filletVariable: selector "${edge}" matched no edge`);
+        }
+        if (refs.length > 1) {
+            throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `filletVariable: selector "${edge}" matched ${refs.length} edges; filletVariable takes exactly one edge`);
+        }
+        edgeRef = refs[0];
+    }
+    else {
+        edgeRef = edge;
+    }
+    if (!edgeRef || edgeRef.kind !== 'edge') {
+        throw new Error('E_FILLETVAR_BAD_EDGE_REF: edge must be an EdgeTopoRef (as consumed by cad.fillet) or a selector string');
     }
-    const faces = edge.faces;
+    const faces = edgeRef.faces;
     if (!Array.isArray(faces) || faces.length !== 2) {
         throw new Error('E_FILLETVAR_BAD_EDGE_REF: EdgeTopoRef.faces must be a two-entry RoleQualifier pair');
     }
@@ -36,9 +52,9 @@ function filletVariableBrep(input, edge, startRadius, endRadius) {
     const ctx = buildEdgeResolutionContext(kernel, input);
     if (!ctx)
         throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', 'filletVariable: input has no BREP naming context');
-    const r = resolveTopoRef(edge, ctx);
+    const r = resolveTopoRef(edgeRef, ctx);
     if (r.handle === undefined) {
-        throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `filletVariable: edge resolved without handle (${edge.faces[0].role}/${edge.faces[1].role})`);
+        throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `filletVariable: edge resolved without handle (${edgeRef.faces[0].role}/${edgeRef.faces[1].role})`);
     }
     const result = kernel.filletVariable(solid, r.handle, startRadius, endRadius);
     return fromBrep(solidToShape(kernel, result), { solid: result });
@@ -55,11 +71,13 @@ function filletVariableBrep(input, edge, startRadius, endRadius) {
  *       仅 BREP 可用。
  * @returns Shape 变半径圆角后的几何。
  * @param input - 目标几何。type:Shape required:true
- * @param edge - 目标边（EdgeTopoRef，同 cad.fillet 的 edges 条目）。type:EdgeTopoRef required:true
+ * @param edge - 目标边：EdgeTopoRef（同 cad.fillet 的 edges 条目，UI 拾取产物）或 CadQuery 边选择器字符串（如 "|Z"，AI 生成；多边命中抛错）。type:EdgeTopoRef|string required:true
  * @param r1 - 起点半径（mm，>0）。type:number required:true
  * @param r2 - 终点半径（mm，>0）。type:number required:true
  * @example
  * const v = await cad.filletVariable(part0, partEdges[0], 1, 4)
+ * // AI 生成可写 CadQuery 边选择器字符串
+ * const v2 = await cad.filletVariable(part0, "|Z", 1, 4)
  */
 export const filletVariable = defineOp({
     brep(input, edge, r1, r2) {

package/dist/api/fillet-variable.js.map

@@ -1 +1 @@
-{"version":3,"file":"fillet-variable.js","sourceRoot":"","sources":["../../src/api/fillet-variable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAA;AAE3D,8CAA8C;AAC9C,SAAS,kBAAkB,CAAC,KAAY,EAAE,IAAiB,EAAE,WAAmB,EAAE,SAAiB;IACjG,IAAI,CAAC,IAAI,IAAK,IAA2B,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAA;IACtG,CAAC;IACD,MAAM,KAAK,GAAI,IAA4B,CAAC,KAAK,CAAA;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,oFAAoF,CAAC,CAAA;IACvG,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAA;QAC7F,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAA;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAEjG,MAAM,GAAG,GAAG,0BAA0B,CAAC,MAAM,EAAE,KAAe,CAAC,CAAA;IAC/D,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,MAAM,EAAE,kDAAkD,CAAC,CAAA;IAChH,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IACnC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,MAAM,EAAE,iDAAiD,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAA;IAClJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,MAAoB,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;IAC3F,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;IACrC,IAAI,CAAC,KAAY,EAAE,IAAiB,EAAE,EAAU,EAAE,EAAU;QAC1D,OAAO,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;IAChD,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,EAAgB;IAE1E,SAAS,EAAE,EAAE;CACd,CAAC,CAAA","sourcesContent":["/**\n * api fillet-variable — 变半径圆角：单边起止半径（手写中立 op，Phase 5）\n *\n * 中立 op：L1 `filletVariable(solid, edge, startRadius, endRadius)` 在 occt 与\n * brepkit 两侧均有真实现（engine-method-map 实测 `dialect`）⇒ 走 `getBrepApi()`\n * （D12），不声明 engines（中立 op：实现只经 L1 契约面）。\n *\n * 这是 faijs 简化形态（单边 + 起止半径）；旧版的 per-edge 回调形态\n * （`variableFillet`）维持 skip（状态化回调不可静态建模）。\n * 选边口径与 `fillet` 一致（EdgeTopoRef，faces 两面 role 线路）。\n */\n\nimport type { Shape } from '../mesh/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { brepOf, fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { EdgeTopoRef } from '../topology/naming'\nimport { resolveTopoRef, TopoRefError } from '../topology/naming'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { buildEdgeResolutionContext } from './topo-resolve'\n\n/** BREP 路径：解析边引用 → L1 filletVariable → 收养。 */\nfunction filletVariableBrep(input: Shape, edge: EdgeTopoRef, startRadius: number, endRadius: number): Shape {\n  if (!edge || (edge as { kind?: unknown }).kind !== 'edge') {\n    throw new Error('E_FILLETVAR_BAD_EDGE_REF: edge must be an EdgeTopoRef (as consumed by cad.fillet)')\n  }\n  const faces = (edge as { faces?: unknown }).faces\n  if (!Array.isArray(faces) || faces.length !== 2) {\n    throw new Error('E_FILLETVAR_BAD_EDGE_REF: EdgeTopoRef.faces must be a two-entry RoleQualifier pair')\n  }\n  for (const r of [startRadius, endRadius]) {\n    if (typeof r !== 'number' || !Number.isFinite(r) || r <= 0) {\n      throw new Error('E_FILLETVAR_BAD_RADIUS: startRadius / endRadius must be positive numbers')\n    }\n  }\n  const kernel = getBrepApi()\n  const solid = brepOf(input) as BrepHandle | undefined\n  if (solid === undefined) throw new Error('E_FILLETVAR_NO_BREP: filletVariable input is not BREP')\n\n  const ctx = buildEdgeResolutionContext(kernel, input as object)\n  if (!ctx) throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', 'filletVariable: input has no BREP naming context')\n  const r = resolveTopoRef(edge, ctx)\n  if (r.handle === undefined) {\n    throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `filletVariable: edge resolved without handle (${edge.faces[0].role}/${edge.faces[1].role})`)\n  }\n\n  const result = kernel.filletVariable(solid, r.handle as BrepHandle, startRadius, endRadius)\n  return fromBrep(solidToShape(kernel, result), { solid: result })\n}\n\n/**\n * 变半径圆角：对单条边施加从起点到终点的线性变半径圆角。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name filletVariable\n * @note 中立 op：L1 filletVariable 两引擎同实现。`r1 == r2` 时与 cad.fillet 等半径\n *       结果等价。旧版的 per-edge 回调变半径（variableFillet）不上脚本面。\n *       仅 BREP 可用。\n * @returns Shape 变半径圆角后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param edge - 目标边（EdgeTopoRef，同 cad.fillet 的 edges 条目）。type:EdgeTopoRef required:true\n * @param r1 - 起点半径（mm，>0）。type:number required:true\n * @param r2 - 终点半径（mm，>0）。type:number required:true\n * @example\n * const v = await cad.filletVariable(part0, partEdges[0], 1, 4)\n */\nexport const filletVariable = defineOp({\n  brep(input: Shape, edge: EdgeTopoRef, r1: number, r2: number) {\n    return filletVariableBrep(input, edge, r1, r2)\n  },\n  naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } } as Provenance,\n\n  paramDims: {},\n})\n"]}
+{"version":3,"file":"fillet-variable.js","sourceRoot":"","sources":["../../src/api/fillet-variable.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api fillet-variable — 变半径圆角：单边起止半径（手写中立 op，Phase 5）\n *\n * 中立 op：L1 `filletVariable(solid, edge, startRadius, endRadius)` 在 occt 与\n * brepkit 两侧均有真实现（engine-method-map 实测 `dialect`）⇒ 走 `getBrepApi()`\n * （D12），不声明 engines（中立 op：实现只经 L1 契约面）。\n *\n * 这是 faijs 简化形态（单边 + 起止半径）；旧版的 per-edge 回调形态\n * （`variableFillet`）维持 skip（状态化回调不可静态建模）。\n * 选边口径与 `fillet` 一致（EdgeTopoRef，faces 两面 role 线路）。\n */\n\nimport type { Shape } from '../mesh/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { brepOf, fromBrep } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { EdgeTopoRef } from '../topology/naming'\nimport { resolveTopoRef, TopoRefError } from '../topology/naming'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { buildEdgeResolutionContext } from './topo-resolve'\nimport { resolveSelectorToEdgeRefs } from './selectors-to-refs'\n\n/** 单边选择：EdgeTopoRef（UI 拾取产物）或 CadQuery 边选择器字符串（AI 生成）。 */\nexport type FilletVariableEdge = EdgeTopoRef | string\n\n/** BREP 路径：解析边引用 → L1 filletVariable → 收养。 */\nfunction filletVariableBrep(input: Shape, edge: FilletVariableEdge, startRadius: number, endRadius: number): Shape {\n  let edgeRef: EdgeTopoRef\n  if (typeof edge === 'string') {\n    // 选择器字符串 → 解析；单边参数多命中 → 抛错（R3：不静默取第一个）。\n    const refs = resolveSelectorToEdgeRefs(input, edge)\n    if (refs.length === 0) {\n      throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `filletVariable: selector \"${edge}\" matched no edge`)\n    }\n    if (refs.length > 1) {\n      throw new TopoRefError(\n        'E_TOPO_NOT_FOUND',\n        'edge',\n        `filletVariable: selector \"${edge}\" matched ${refs.length} edges; filletVariable takes exactly one edge`,\n      )\n    }\n    edgeRef = refs[0]\n  } else {\n    edgeRef = edge\n  }\n  if (!edgeRef || (edgeRef as { kind?: unknown }).kind !== 'edge') {\n    throw new Error('E_FILLETVAR_BAD_EDGE_REF: edge must be an EdgeTopoRef (as consumed by cad.fillet) or a selector string')\n  }\n  const faces = (edgeRef as { faces?: unknown }).faces\n  if (!Array.isArray(faces) || faces.length !== 2) {\n    throw new Error('E_FILLETVAR_BAD_EDGE_REF: EdgeTopoRef.faces must be a two-entry RoleQualifier pair')\n  }\n  for (const r of [startRadius, endRadius]) {\n    if (typeof r !== 'number' || !Number.isFinite(r) || r <= 0) {\n      throw new Error('E_FILLETVAR_BAD_RADIUS: startRadius / endRadius must be positive numbers')\n    }\n  }\n  const kernel = getBrepApi()\n  const solid = brepOf(input) as BrepHandle | undefined\n  if (solid === undefined) throw new Error('E_FILLETVAR_NO_BREP: filletVariable input is not BREP')\n\n  const ctx = buildEdgeResolutionContext(kernel, input as object)\n  if (!ctx) throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', 'filletVariable: input has no BREP naming context')\n  const r = resolveTopoRef(edgeRef, ctx)\n  if (r.handle === undefined) {\n    throw new TopoRefError('E_TOPO_NOT_FOUND', 'edge', `filletVariable: edge resolved without handle (${edgeRef.faces[0].role}/${edgeRef.faces[1].role})`)\n  }\n\n  const result = kernel.filletVariable(solid, r.handle as BrepHandle, startRadius, endRadius)\n  return fromBrep(solidToShape(kernel, result), { solid: result })\n}\n\n/**\n * 变半径圆角：对单条边施加从起点到终点的线性变半径圆角。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name filletVariable\n * @note 中立 op：L1 filletVariable 两引擎同实现。`r1 == r2` 时与 cad.fillet 等半径\n *       结果等价。旧版的 per-edge 回调变半径（variableFillet）不上脚本面。\n *       仅 BREP 可用。\n * @returns Shape 变半径圆角后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param edge - 目标边：EdgeTopoRef（同 cad.fillet 的 edges 条目，UI 拾取产物）或 CadQuery 边选择器字符串（如 \"|Z\"，AI 生成；多边命中抛错）。type:EdgeTopoRef|string required:true\n * @param r1 - 起点半径（mm，>0）。type:number required:true\n * @param r2 - 终点半径（mm，>0）。type:number required:true\n * @example\n * const v = await cad.filletVariable(part0, partEdges[0], 1, 4)\n * // AI 生成可写 CadQuery 边选择器字符串\n * const v2 = await cad.filletVariable(part0, \"|Z\", 1, 4)\n */\nexport const filletVariable = defineOp({\n  brep(input: Shape, edge: FilletVariableEdge, r1: number, r2: number) {\n    return filletVariableBrep(input, edge, r1, r2)\n  },\n  naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } } as Provenance,\n\n  paramDims: {},\n})\n"]}

package/dist/api/fillet.d.ts

@@ -31,9 +31,10 @@ export interface EdgeSelectorCheckOptions {
 }
 /**
  * Validate fillet parameters: `edges` must be a non-empty array of EdgeTopoRef
- * (each with kind key "edge" and a two-entry faces pair) — or of 1-based
- * ordinals when `opts.allowOrdinals` (the mesh chain); `radius` must be a
- * positive number (M1: uniform radius only).
+ * (each with kind key "edge" and a two-entry faces pair) or of selector strings
+ * (`"|Z"` etc., precision chain) — or of 1-based ordinals when
+ * `opts.allowOrdinals` (the mesh chain); a top-level selector string is also
+ * accepted. `radius` must be a positive number (M1: uniform radius only).
  * @param params the raw fillet operation parameters.
  * @param opts the selector-form options (mesh chain allows ordinals).
  */
@@ -55,10 +56,12 @@ export declare function assertFilletParams(params: Record<string, unknown>, opts
  *       序号（近似拓扑 `edges` 数组下标 + 1）指认。
  * @returns Shape 圆角后的几何。
  * @param input - 目标几何。type:Shape required:true
- * @param params.edges - 参与圆角的边：相邻两面的 role 线路（EdgeTopoRef[]）；网格链上也可用 1 起序号。type:EdgeTopoRef[] required:true
+ * @param params.edges - 参与圆角的边：CadQuery 边选择器字符串（如 "|Z"，AI 生成）或相邻两面的 role 线路（EdgeTopoRef[]，UI 拾取产物）；网格链上也可用 1 起序号。type:EdgeTopoRef[]|string 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 })
+ * // AI 生成可写 CadQuery 边选择器字符串（"|Z" 切线平行 Z 的边）
+ * const p2 = await cad.fillet(part0, { edges: "|Z", radius: 2 })
  * const q = await cad.fillet(meshPart, { edges: [3], radius: 1 })
  */
 export declare const fillet: ((input: Shape, params: Record<string, unknown>) => Promise<Shape>) & {

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

@@ -1 +1 @@
-{"version":3,"file":"fillet.d.ts","sourceRoot":"","sources":["../../src/api/fillet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAgB1C,gBAAgB;AAChB,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,wBAAwB,GAC9B,IAAI,CAwBN;AA6GD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,MAAM;;CAajB,CAAA"}
+{"version":3,"file":"fillet.d.ts","sourceRoot":"","sources":["../../src/api/fillet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAiB1C,gBAAgB;AAChB,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,CAAC,EAAE,wBAAwB,GAC9B,IAAI,CA+BN;AAoLD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,MAAM;;CAmBjB,CAAA"}

package/dist/api/fillet.js

@@ -20,32 +20,41 @@
 import { solidToShape } from '../brep/brep-ops.js';
 import { filletWithRoleTable } from '../brep/face-evolution.js';
 import { getBrepApi } from '../brep/handle-bridge.js';
-import { getCurrentStmt } from '../runtime-state.js';
-import { fromBrep, brepOf, inputRoleTable } from '../shape.js';
+import { getCurrentStmt, nameOf, setName } from '../runtime-state.js';
+import { fromBrep, brepOf, inputRoleTable, resolveCompoundMember, replaceCompoundMember } from '../shape.js';
 import { defineOp } from '../sdk.js';
 import { resolveTopoRef, TopoRefError } from '../topology/naming/index.js';
 import { buildEdgeResolutionContext } from './topo-resolve.js';
+import { expandEdgeSelectorRefs } from './selectors-to-refs.js';
 import { meshKernelFailure, meshSolidEntry, meshSolidProduct, resolveMeshEdges } from './internal/mesh-solid-op.js';
 /**
  * Validate fillet parameters: `edges` must be a non-empty array of EdgeTopoRef
- * (each with kind key "edge" and a two-entry faces pair) — or of 1-based
- * ordinals when `opts.allowOrdinals` (the mesh chain); `radius` must be a
- * positive number (M1: uniform radius only).
+ * (each with kind key "edge" and a two-entry faces pair) or of selector strings
+ * (`"|Z"` etc., precision chain) — or of 1-based ordinals when
+ * `opts.allowOrdinals` (the mesh chain); a top-level selector string is also
+ * accepted. `radius` must be a positive number (M1: uniform radius only).
  * @param params the raw fillet operation parameters.
  * @param opts the selector-form options (mesh chain allows ordinals).
  */
 export function assertFilletParams(params, opts) {
     const edges = params.edges;
-    if (!Array.isArray(edges) || edges.length === 0) {
+    const list = typeof edges === 'string' ? [edges] : edges;
+    if (typeof edges !== 'string' && (!Array.isArray(edges) || list.length === 0)) {
         throw new Error('E_FILLET_NO_EDGES: fillet requires at least one edge');
     }
-    for (const e of edges) {
+    for (const e of list) {
         if (opts?.allowOrdinals && typeof e === 'number') {
             if (!Number.isInteger(e) || e < 1) {
                 throw new Error('E_FILLET_BAD_EDGE_REF: an edge ordinal must be a positive integer (1-based)');
             }
             continue;
         }
+        if (typeof e === 'string') {
+            if (e.trim() === '') {
+                throw new Error('E_FILLET_BAD_EDGE_REF: an edge selector string must not be empty');
+            }
+            continue;
+        }
         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"');
         }
@@ -91,8 +100,8 @@ function filletBrep(input, params) {
     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));
+    // 展开选择器字符串 → EdgeTopoRef[]，再解析所有 EdgeTopoRef → Edge 句柄
+    const edgeHandles = expandEdgeSelectorRefs(input, edges).map((e) => resolveEdge(ctx, e));
     // 输入 roleTable + outStmt（与 boolean.ts 同构）。Phase 1.6：origin=本次语句 StmtId。
     const inputTable = inputRoleTable(input);
     const outStmt = String(getCurrentStmt()?.id ?? '');
@@ -108,8 +117,55 @@ function filletBrep(input, params) {
     catch (err) {
         throw translateOcctError(err);
     }
+    // 如实报告内核缺陷（2026-10-16 主线 bug「圆角预览模型消失」）：brepkit
+    // FilletBuilder 对部分边输出**退化几何**（显示 deflection 下 bbox 压扁成线/单点、
+    // 顶点骤减）——execute 若放行，结果 mesh 不可见 =「物体消失」且 UI 无报错。
+    // 这里用与显示三角化同口径的 meshShape 度量（线性 deflection 0.1），退化即抛错，
+    // 绝不静默放行；失败时场景保持操作前状态（物体不消失）。
+    assertNonDegenerateFilletMesh(kernel, resultSolid, radius, edgeHandles.length);
     return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid, faceEvolution, roleTable });
 }
+/**
+ * 检查 fillet 结果是否退化（mesh 层面，与显示三角化同口径）。
+ *
+ * 内核失败（E_FILLET_RADIUS_TOO_LARGE 等）走 translateOcctError 已如实报错；
+ * 但「execute 成功 + 退化几何」此前是静默的——mesh bbox 压扁成线/单点时渲染
+ * 不可见，UI 无任何提示。本检查把它变成显式错误：报错好于掩盖（项目红线）。
+ *
+ * 阈值：顶点数 < 4（连一个完整三角形都构不成），或 bbox 任一维跨度 ≤ 1e-6
+ * （压扁成线/单点）。OCCT 内核同场景 12 边全健康（fillet-per-edge-occt.test.ts），
+ * 本检查不会误伤健康结果。
+ */
+function assertNonDegenerateFilletMesh(kernel, solid, radius, edgeCount) {
+    const mesh = kernel.meshShape(solid);
+    const pos = mesh.positions;
+    if (pos.length < 12) {
+        throw new Error(`E_FILLET_DEGENERATE_MESH: brepkit FilletBuilder produced degenerate geometry for fillet(r=${radius}, edges=${edgeCount}): vertices=${pos.length / 3} (< 4). Refusing to render a vanished solid.`);
+    }
+    let minX = Infinity, minY = Infinity, minZ = Infinity;
+    let maxX = -Infinity, maxY = -Infinity, maxZ = -Infinity;
+    for (let i = 0; i < pos.length; i += 3) {
+        const x = pos[i], y = pos[i + 1], z = pos[i + 2];
+        if (x < minX)
+            minX = x;
+        if (y < minY)
+            minY = y;
+        if (z < minZ)
+            minZ = z;
+        if (x > maxX)
+            maxX = x;
+        if (y > maxY)
+            maxY = y;
+        if (z > maxZ)
+            maxZ = z;
+    }
+    const sx = maxX - minX;
+    const sy = maxY - minY;
+    const sz = maxZ - minZ;
+    if (!(sx > 1e-6 && sy > 1e-6 && sz > 1e-6)) {
+        throw new Error(`E_FILLET_DEGENERATE_MESH: brepkit FilletBuilder produced degenerate geometry for fillet(r=${radius}, edges=${edgeCount}): bbox=${sx.toFixed(4)}×${sy.toFixed(4)}×${sz.toFixed(4)} (flattened). Refusing to render a vanished solid.`);
+    }
+}
 /**
  * 网格实体路径：对近似拓扑里识别出的边倒圆角（方案 2026-10-01 §3.5 三明治）。
  *
@@ -135,6 +191,10 @@ function filletMeshSolid(input, params) {
     const edges = params.edges;
     const radius = params.radius;
     const entry = meshSolidEntry(input, 'fillet');
+    // 选择器字符串只服务精度链（网格零件无 role 层）；网格链用 1 起序号。
+    if (typeof edges === 'string' || edges.some((e) => typeof e === 'string')) {
+        throw new TopoRefError('E_TOPO_MESH_UNSUPPORTED', 'edge', 'fillet: selector strings are precision-chain only — mesh solids have no role layer (use 1-based edge ordinals)');
+    }
     const edgeHandles = resolveMeshEdges(entry, edges, 'fillet');
     let result;
     try {
@@ -145,6 +205,18 @@ function filletMeshSolid(input, params) {
     }
     return meshSolidProduct(entry, result);
 }
+/**
+ * 多零件 compound 成员是匿名 Shape：其面 role 记录在父 compound 的 part 键合并表里。
+ * 解包后让 target 继承父 part 名，buildEdgeResolutionContext/inputRoleTable 才能按
+ * part 名查到表（与 chamfer 同构）。单零件路径 input===target 已命名，守卫使其空转。
+ */
+function adoptParentPartName(input, target) {
+    if (target === input)
+        return;
+    const parentName = nameOf(input);
+    if (parentName && !nameOf(target))
+        setName(target, parentName);
+}
 /**
  * 在几何体上做圆角（等半径）。
  *
@@ -162,21 +234,29 @@ function filletMeshSolid(input, params) {
  *       序号（近似拓扑 `edges` 数组下标 + 1）指认。
  * @returns Shape 圆角后的几何。
  * @param input - 目标几何。type:Shape required:true
- * @param params.edges - 参与圆角的边：相邻两面的 role 线路（EdgeTopoRef[]）；网格链上也可用 1 起序号。type:EdgeTopoRef[] required:true
+ * @param params.edges - 参与圆角的边：CadQuery 边选择器字符串（如 "|Z"，AI 生成）或相邻两面的 role 线路（EdgeTopoRef[]，UI 拾取产物）；网格链上也可用 1 起序号。type:EdgeTopoRef[]|string 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 })
+ * // AI 生成可写 CadQuery 边选择器字符串（"|Z" 切线平行 Z 的边）
+ * const p2 = await cad.fillet(part0, { edges: "|Z", radius: 2 })
  * const q = await cad.fillet(meshPart, { edges: [3], radius: 1 })
  */
 export const fillet = defineOp({
     meshEngines: ['brepkit'],
     mesh(input, params) {
         assertFilletParams(params, { allowOrdinals: true });
-        return filletMeshSolid(input, params);
+        // P2：多零件 load 输入是 compound——按 partIndex 取目标成员，结果替换回原 compound。
+        const target = resolveCompoundMember(input, params.partIndex, 'fillet');
+        const result = filletMeshSolid(target, params);
+        return replaceCompoundMember(input, params.partIndex, result);
     },
     brep(input, params) {
         assertFilletParams(params);
-        return filletBrep(input, params);
+        const target = resolveCompoundMember(input, params.partIndex, 'fillet');
+        adoptParentPartName(input, target);
+        const result = filletBrep(target, params);
+        return replaceCompoundMember(input, params.partIndex, result);
     },
     naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
     paramDims: {},

package/dist/api/fillet.js.map

@@ -1 +1 @@
-{"version":3,"file":"fillet.js","sourceRoot":"","sources":["../../src/api/fillet.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api fillet — fillet 圆角库函数（BREP-only）\n *\n * 平台分层（narrowing plan Phase 5，D11）：**中立 op**——`filletWithHistory` 是\n * L1 核心面（brepkit 亦实现），实现全程走 L1（getBrepApi，D12），不声明 engines。\n * 实现体内不分支：两引擎都走 `filletWithRoleTable` 历史轨（见 `filletBrep`）。\n *\n * 与 chamfer 的差异：fillet 用 filletWithHistory 走面演化 + roleTable 传播\n * （chamfer 在 P5 同步改造）。M1 只支持等半径；M2 计划支持变半径与几何限定符。\n *\n * M1：\n * - 等半径（number）：kernel.filletWithHistory(solid, edges, radius, hashes, bound)\n * - 走 filletWithRoleTable 传播 roleTable\n * - BREP-only：mesh 输入 → E_MESH_UNSUPPORTED（backend-dispatch 静态判定）\n *\n * M2（未实施）：\n * - 变半径 [r1, r2]：filletVariable + 单边 + 不产 roleTable（降级）\n * - 几何限定符字符串选边（§4）\n */\n\nimport type { Shape } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { filletWithRoleTable } from '../brep/face-evolution'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { getCurrentStmt } from '../runtime-state'\nimport { fromBrep, brepOf, inputRoleTable } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { EdgeTopoRef, ResolutionContext } from '../topology/naming'\nimport { resolveTopoRef, TopoRefError } from '../topology/naming'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { buildEdgeResolutionContext } from './topo-resolve'\nimport { meshKernelFailure, meshSolidEntry, meshSolidProduct, resolveMeshEdges } from './internal/mesh-solid-op'\n\n// ── 参数自校验（api 层被直接 import 时的防御层）──\n\n/** 边选择器校验选项。 */\nexport interface EdgeSelectorCheckOptions {\n  /**\n   * 允许 1 起序号作为边选择器（**仅网格链**；见 `resolveMeshEdges`）。\n   *\n   * 精度链不开这个口子：BREP 的边身份是 role 线路（两个相邻面的 `(origin, role)`），\n   * 序号只是内核枚举序，跨特征会漂移——让精度链接受序号等于把\"可重放的引用\"降级成\n   * \"这次跑出来的下标\"。近似链相反：没有 role 层，序号是唯一无歧义的指认方式。\n   */\n  readonly allowOrdinals?: boolean\n}\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) — or of 1-based\n * ordinals when `opts.allowOrdinals` (the mesh chain); `radius` must be a\n * positive number (M1: uniform radius only).\n * @param params the raw fillet operation parameters.\n * @param opts the selector-form options (mesh chain allows ordinals).\n */\nexport function assertFilletParams(\n  params: Record<string, unknown>,\n  opts?: EdgeSelectorCheckOptions,\n): 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 (opts?.allowOrdinals && typeof e === 'number') {\n      if (!Number.isInteger(e) || e < 1) {\n        throw new Error('E_FILLET_BAD_EDGE_REF: an edge ordinal must be a positive integer (1-based)')\n      }\n      continue\n    }\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  // L1 面（D12）：filletWithHistory 是 L1，全链路中立。\n  const kernel = getBrepApi()\n  const solid = brepOf(input) as BrepHandle | undefined\n  if (solid === undefined) 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 + outStmt（与 boolean.ts 同构）。Phase 1.6：origin=本次语句 StmtId。\n  const inputTable = inputRoleTable(input) as ReadonlyMap<unknown, unknown> | undefined\n  const outStmt = String(getCurrentStmt()?.id ?? '')\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      inputTable ?? new Map(),\n      outStmt,\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 * 网格实体路径：对近似拓扑里识别出的边倒圆角（方案 2026-10-01 §3.5 三明治）。\n *\n * 与 BREP 路径的三处实质差异，都是\"网格零件没有精度链、没有 role 层\"的直接后果：\n * - 边**按几何或序号**解析：`EdgeTopoRef` 走长度/中点匹配；**1 起序号**直接取自近似\n *   拓扑的 `edges` 数组下标 + 1（等长边靠几何分不开，序号是唯一无歧义的指认方式）；\n * - 内核调用走 L1 裸 `kernel.fillet`（`filletWithHistory` 是精度链的面演化能力，\n *   近似拓扑没有 hash 演化可言，故**不产生** faceEvolution / roleTable，如实缺席\n *   而不是造一张恒等映射）；\n * - 产物句柄写回后由 `meshSolidProduct` 重新三角化并重建近似拓扑。\n *\n * GOTCHA（2026-10-01 实测，见 `brepkit-kernel/mesh-solid-topology.test.ts`）：\n * 一次请求里的**全部**边交给内核，会在共面边链（如圆柱端盖的 64 条边）上被整体\n * 拒绝——不是单条边不可倒，而是\"一次性磨圆会自交\"。故本实现**如实失败**，不自动\n * 拆成逐边重试（运行时换策略会掩盖几何事实）。要给共面边链倒角，请分多次调用，\n * 每次一组几何上互不相邻的边。\n *\n * @param input - the mesh-solid input.\n * @param params - the validated fillet parameters.\n * @returns the filleted mesh solid as a new mesh part.\n */\nfunction filletMeshSolid(input: Shape, params: Record<string, unknown>): Shape {\n  const edges = params.edges as (number | EdgeTopoRef)[]\n  const radius = params.radius as number\n  const entry = meshSolidEntry(input, 'fillet')\n  const edgeHandles = resolveMeshEdges(entry, edges, 'fillet')\n\n  let result: BrepHandle\n  try {\n    result = entry.kernel.fillet(entry.solid, edgeHandles, radius)\n  } catch (cause) {\n    throw meshKernelFailure(\n      'fillet',\n      'E_FILLET_RADIUS_TOO_LARGE',\n      `fillet(r=${radius}) on ${edgeHandles.length} edge(s)`,\n      cause,\n    )\n  }\n  return meshSolidProduct(entry, result)\n}\n\n/**\n * 在几何体上做圆角（等半径）。\n *\n * 两条路径都以 `meshEngines: ['brepkit']` 之外的事实为界：BREP 输入走\n * `filletWithHistory`（带面演化与 roleTable 传播）；**网格实体**输入走网格后端\n * （近似拓扑无 role，边按几何或序号解析，无面演化）。非 BREP 的**裸网格**输入仍抛\n * `E_MESH_SOLID_UNSUPPORTED`——裸网格没有近似拓扑，没有边可选。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name fillet\n * @note `radius` 为正数（mm）。BREP 路径圆角后 roleTable 经 filletWithHistory 传播，\n *       后续特征仍可按 role 选面/选边；网格实体路径没有 role 层，边只能按几何或\n *       序号（近似拓扑 `edges` 数组下标 + 1）指认。\n * @returns Shape 圆角后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.edges - 参与圆角的边：相邻两面的 role 线路（EdgeTopoRef[]）；网格链上也可用 1 起序号。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 * const q = await cad.fillet(meshPart, { edges: [3], radius: 1 })\n */\nexport const fillet = defineOp({\n  meshEngines: ['brepkit'],\n  mesh(input: Shape, params: Record<string, unknown>) {\n    assertFilletParams(params, { allowOrdinals: true })\n    return filletMeshSolid(input, params)\n  },\n  brep(input: Shape, params: Record<string, unknown>) {\n    assertFilletParams(params)\n    return filletBrep(input, params)\n  },\n  naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } } as Provenance,\n\n  paramDims: {},\n})\n"]}
+{"version":3,"file":"fillet.js","sourceRoot":"","sources":["../../src/api/fillet.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api fillet — fillet 圆角库函数（BREP-only）\n *\n * 平台分层（narrowing plan Phase 5，D11）：**中立 op**——`filletWithHistory` 是\n * L1 核心面（brepkit 亦实现），实现全程走 L1（getBrepApi，D12），不声明 engines。\n * 实现体内不分支：两引擎都走 `filletWithRoleTable` 历史轨（见 `filletBrep`）。\n *\n * 与 chamfer 的差异：fillet 用 filletWithHistory 走面演化 + roleTable 传播\n * （chamfer 在 P5 同步改造）。M1 只支持等半径；M2 计划支持变半径与几何限定符。\n *\n * M1：\n * - 等半径（number）：kernel.filletWithHistory(solid, edges, radius, hashes, bound)\n * - 走 filletWithRoleTable 传播 roleTable\n * - BREP-only：mesh 输入 → E_MESH_UNSUPPORTED（backend-dispatch 静态判定）\n *\n * M2（未实施）：\n * - 变半径 [r1, r2]：filletVariable + 单边 + 不产 roleTable（降级）\n * - 几何限定符字符串选边（§4）\n */\n\nimport type { Shape } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { filletWithRoleTable } from '../brep/face-evolution'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { getCurrentStmt, nameOf, setName } from '../runtime-state'\nimport { fromBrep, brepOf, inputRoleTable, resolveCompoundMember, replaceCompoundMember } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { EdgeTopoRef, ResolutionContext } from '../topology/naming'\nimport { resolveTopoRef, TopoRefError } from '../topology/naming'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { buildEdgeResolutionContext } from './topo-resolve'\nimport { expandEdgeSelectorRefs } from './selectors-to-refs'\nimport { meshKernelFailure, meshSolidEntry, meshSolidProduct, resolveMeshEdges } from './internal/mesh-solid-op'\n\n// ── 参数自校验（api 层被直接 import 时的防御层）──\n\n/** 边选择器校验选项。 */\nexport interface EdgeSelectorCheckOptions {\n  /**\n   * 允许 1 起序号作为边选择器（**仅网格链**；见 `resolveMeshEdges`）。\n   *\n   * 精度链不开这个口子：BREP 的边身份是 role 线路（两个相邻面的 `(origin, role)`），\n   * 序号只是内核枚举序，跨特征会漂移——让精度链接受序号等于把\"可重放的引用\"降级成\n   * \"这次跑出来的下标\"。近似链相反：没有 role 层，序号是唯一无歧义的指认方式。\n   */\n  readonly allowOrdinals?: boolean\n}\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) or of selector strings\n * (`\"|Z\"` etc., precision chain) — or of 1-based ordinals when\n * `opts.allowOrdinals` (the mesh chain); a top-level selector string is also\n * accepted. `radius` must be a positive number (M1: uniform radius only).\n * @param params the raw fillet operation parameters.\n * @param opts the selector-form options (mesh chain allows ordinals).\n */\nexport function assertFilletParams(\n  params: Record<string, unknown>,\n  opts?: EdgeSelectorCheckOptions,\n): void {\n  const edges = params.edges\n  const list = typeof edges === 'string' ? [edges] : (edges as unknown[])\n  if (typeof edges !== 'string' && (!Array.isArray(edges) || list.length === 0)) {\n    throw new Error('E_FILLET_NO_EDGES: fillet requires at least one edge')\n  }\n  for (const e of list) {\n    if (opts?.allowOrdinals && typeof e === 'number') {\n      if (!Number.isInteger(e) || e < 1) {\n        throw new Error('E_FILLET_BAD_EDGE_REF: an edge ordinal must be a positive integer (1-based)')\n      }\n      continue\n    }\n    if (typeof e === 'string') {\n      if (e.trim() === '') {\n        throw new Error('E_FILLET_BAD_EDGE_REF: an edge selector string must not be empty')\n      }\n      continue\n    }\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  // L1 面（D12）：filletWithHistory 是 L1，全链路中立。\n  const kernel = getBrepApi()\n  const solid = brepOf(input) as BrepHandle | undefined\n  if (solid === undefined) throw new Error('E_FILLET_NO_BREP: fillet input is not BREP')\n\n  const edges = params.edges as EdgeTopoRef[] | string\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[]，再解析所有 EdgeTopoRef → Edge 句柄\n  const edgeHandles = expandEdgeSelectorRefs(input, edges).map((e) => resolveEdge(ctx, e))\n\n  // 输入 roleTable + outStmt（与 boolean.ts 同构）。Phase 1.6：origin=本次语句 StmtId。\n  const inputTable = inputRoleTable(input) as ReadonlyMap<unknown, unknown> | undefined\n  const outStmt = String(getCurrentStmt()?.id ?? '')\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      inputTable ?? new Map(),\n      outStmt,\n    )\n    resultSolid = r.result\n    faceEvolution = r.faceEvolution\n    roleTable = r.roleTable\n  } catch (err) {\n    throw translateOcctError(err)\n  }\n\n  // 如实报告内核缺陷（2026-10-16 主线 bug「圆角预览模型消失」）：brepkit\n  // FilletBuilder 对部分边输出**退化几何**（显示 deflection 下 bbox 压扁成线/单点、\n  // 顶点骤减）——execute 若放行，结果 mesh 不可见 =「物体消失」且 UI 无报错。\n  // 这里用与显示三角化同口径的 meshShape 度量（线性 deflection 0.1），退化即抛错，\n  // 绝不静默放行；失败时场景保持操作前状态（物体不消失）。\n  assertNonDegenerateFilletMesh(kernel, resultSolid, radius, edgeHandles.length)\n\n  return fromBrep(\n    solidToShape(kernel, resultSolid),\n    { solid: resultSolid, faceEvolution, roleTable },\n  )\n}\n\n/**\n * 检查 fillet 结果是否退化（mesh 层面，与显示三角化同口径）。\n *\n * 内核失败（E_FILLET_RADIUS_TOO_LARGE 等）走 translateOcctError 已如实报错；\n * 但「execute 成功 + 退化几何」此前是静默的——mesh bbox 压扁成线/单点时渲染\n * 不可见，UI 无任何提示。本检查把它变成显式错误：报错好于掩盖（项目红线）。\n *\n * 阈值：顶点数 < 4（连一个完整三角形都构不成），或 bbox 任一维跨度 ≤ 1e-6\n * （压扁成线/单点）。OCCT 内核同场景 12 边全健康（fillet-per-edge-occt.test.ts），\n * 本检查不会误伤健康结果。\n */\nfunction assertNonDegenerateFilletMesh(\n  kernel: ReturnType<typeof getBrepApi>,\n  solid: BrepHandle,\n  radius: number,\n  edgeCount: number,\n): void {\n  const mesh = kernel.meshShape(solid)\n  const pos = mesh.positions\n  if (pos.length < 12) {\n    throw new Error(\n      `E_FILLET_DEGENERATE_MESH: brepkit FilletBuilder produced degenerate geometry for fillet(r=${radius}, edges=${edgeCount}): vertices=${pos.length / 3} (< 4). Refusing to render a vanished solid.`,\n    )\n  }\n  let minX = Infinity, minY = Infinity, minZ = Infinity\n  let maxX = -Infinity, maxY = -Infinity, maxZ = -Infinity\n  for (let i = 0; i < pos.length; i += 3) {\n    const x = pos[i]!, y = pos[i + 1]!, z = pos[i + 2]!\n    if (x < minX) minX = x\n    if (y < minY) minY = y\n    if (z < minZ) minZ = z\n    if (x > maxX) maxX = x\n    if (y > maxY) maxY = y\n    if (z > maxZ) maxZ = z\n  }\n  const sx = maxX - minX\n  const sy = maxY - minY\n  const sz = maxZ - minZ\n  if (!(sx > 1e-6 && sy > 1e-6 && sz > 1e-6)) {\n    throw new Error(\n      `E_FILLET_DEGENERATE_MESH: brepkit FilletBuilder produced degenerate geometry for fillet(r=${radius}, edges=${edgeCount}): bbox=${sx.toFixed(4)}×${sy.toFixed(4)}×${sz.toFixed(4)} (flattened). Refusing to render a vanished solid.`,\n    )\n  }\n}\n\n/**\n * 网格实体路径：对近似拓扑里识别出的边倒圆角（方案 2026-10-01 §3.5 三明治）。\n *\n * 与 BREP 路径的三处实质差异，都是\"网格零件没有精度链、没有 role 层\"的直接后果：\n * - 边**按几何或序号**解析：`EdgeTopoRef` 走长度/中点匹配；**1 起序号**直接取自近似\n *   拓扑的 `edges` 数组下标 + 1（等长边靠几何分不开，序号是唯一无歧义的指认方式）；\n * - 内核调用走 L1 裸 `kernel.fillet`（`filletWithHistory` 是精度链的面演化能力，\n *   近似拓扑没有 hash 演化可言，故**不产生** faceEvolution / roleTable，如实缺席\n *   而不是造一张恒等映射）；\n * - 产物句柄写回后由 `meshSolidProduct` 重新三角化并重建近似拓扑。\n *\n * GOTCHA（2026-10-01 实测，见 `brepkit-kernel/mesh-solid-topology.test.ts`）：\n * 一次请求里的**全部**边交给内核，会在共面边链（如圆柱端盖的 64 条边）上被整体\n * 拒绝——不是单条边不可倒，而是\"一次性磨圆会自交\"。故本实现**如实失败**，不自动\n * 拆成逐边重试（运行时换策略会掩盖几何事实）。要给共面边链倒角，请分多次调用，\n * 每次一组几何上互不相邻的边。\n *\n * @param input - the mesh-solid input.\n * @param params - the validated fillet parameters.\n * @returns the filleted mesh solid as a new mesh part.\n */\nfunction filletMeshSolid(input: Shape, params: Record<string, unknown>): Shape {\n  const edges = params.edges as (number | string | EdgeTopoRef)[] | string\n  const radius = params.radius as number\n  const entry = meshSolidEntry(input, 'fillet')\n  // 选择器字符串只服务精度链（网格零件无 role 层）；网格链用 1 起序号。\n  if (typeof edges === 'string' || edges.some((e) => typeof e === 'string')) {\n    throw new TopoRefError(\n      'E_TOPO_MESH_UNSUPPORTED',\n      'edge',\n      'fillet: selector strings are precision-chain only — mesh solids have no role layer (use 1-based edge ordinals)',\n    )\n  }\n  const edgeHandles = resolveMeshEdges(entry, edges as (number | EdgeTopoRef)[], 'fillet')\n\n  let result: BrepHandle\n  try {\n    result = entry.kernel.fillet(entry.solid, edgeHandles, radius)\n  } catch (cause) {\n    throw meshKernelFailure(\n      'fillet',\n      'E_FILLET_RADIUS_TOO_LARGE',\n      `fillet(r=${radius}) on ${edgeHandles.length} edge(s)`,\n      cause,\n    )\n  }\n  return meshSolidProduct(entry, result)\n}\n\n/**\n * 多零件 compound 成员是匿名 Shape：其面 role 记录在父 compound 的 part 键合并表里。\n * 解包后让 target 继承父 part 名，buildEdgeResolutionContext/inputRoleTable 才能按\n * part 名查到表（与 chamfer 同构）。单零件路径 input===target 已命名，守卫使其空转。\n */\nfunction adoptParentPartName(input: Shape, target: Shape): void {\n  if (target === input) return\n  const parentName = nameOf(input)\n  if (parentName && !nameOf(target)) setName(target, parentName)\n}\n\n/**\n * 在几何体上做圆角（等半径）。\n *\n * 两条路径都以 `meshEngines: ['brepkit']` 之外的事实为界：BREP 输入走\n * `filletWithHistory`（带面演化与 roleTable 传播）；**网格实体**输入走网格后端\n * （近似拓扑无 role，边按几何或序号解析，无面演化）。非 BREP 的**裸网格**输入仍抛\n * `E_MESH_SOLID_UNSUPPORTED`——裸网格没有近似拓扑，没有边可选。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name fillet\n * @note `radius` 为正数（mm）。BREP 路径圆角后 roleTable 经 filletWithHistory 传播，\n *       后续特征仍可按 role 选面/选边；网格实体路径没有 role 层，边只能按几何或\n *       序号（近似拓扑 `edges` 数组下标 + 1）指认。\n * @returns Shape 圆角后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param params.edges - 参与圆角的边：CadQuery 边选择器字符串（如 \"|Z\"，AI 生成）或相邻两面的 role 线路（EdgeTopoRef[]，UI 拾取产物）；网格链上也可用 1 起序号。type:EdgeTopoRef[]|string 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 * // AI 生成可写 CadQuery 边选择器字符串（\"|Z\" 切线平行 Z 的边）\n * const p2 = await cad.fillet(part0, { edges: \"|Z\", radius: 2 })\n * const q = await cad.fillet(meshPart, { edges: [3], radius: 1 })\n */\nexport const fillet = defineOp({\n  meshEngines: ['brepkit'],\n  mesh(input: Shape, params: Record<string, unknown>) {\n    assertFilletParams(params, { allowOrdinals: true })\n    // P2：多零件 load 输入是 compound——按 partIndex 取目标成员，结果替换回原 compound。\n    const target = resolveCompoundMember(input, params.partIndex, 'fillet')\n    const result = filletMeshSolid(target, params)\n    return replaceCompoundMember(input, params.partIndex, result)\n  },\n  brep(input: Shape, params: Record<string, unknown>) {\n    assertFilletParams(params)\n    const target = resolveCompoundMember(input, params.partIndex, 'fillet')\n    adoptParentPartName(input, target)\n    const result = filletBrep(target, params)\n    return replaceCompoundMember(input, params.partIndex, result)\n  },\n  naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } } as Provenance,\n\n  paramDims: {},\n})\n"]}

package/dist/api/generated/script-face-manifest.js

@@ -6,7 +6,7 @@
 /** Cad script-face op manifest (B1: single source for cad namespace, check() symbol table). */
 export const SCRIPT_FACE_OPS = [
     { name: 'torus', module: 'topology' },
-    { name: 'fuse', module: 'topology', engines: ["occt"] },
+    { name: 'fuse', module: 'topology' },
     { name: 'inspectMassProps', module: 'measurement', engines: ["occt"] },
     { name: 'area', module: 'measurement' },
     { name: 'length', module: 'measurement' },

package/dist/api/generated/script-face-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"script-face-manifest.js","sourceRoot":"","sources":["../../../src/api/generated/script-face-manifest.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * generated/script-face-manifest.ts — 生成文件，禁手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成。\n * cad 脚本面新增 op 清单（P23 B1 双源一致：cad 面 ≡ check() 符号表）。\n */\n\n/** 一条 cad 脚本面新增 op。 */\nexport interface ScriptFaceOp {\n  /** faijs 面导出名（= brepjs 符号名）。 */\n  name: string\n  /** 所属分片模块（生成文件名）。 */\n  module: string\n  /** Phase 5（D11）：平台 op 的平台身份（中立 op 缺省）。 */\n  engines?: readonly string[]\n  /** P26 (unit-system D8)：参数量纲声明（参数名 → DimName）。 */\n  paramDims?: Record<string, string>\n  /** P26 (unit-system D8)：返回值量纲。 */\n  retDim?: string\n}\n\n/** Cad script-face op manifest (B1: single source for cad namespace, check() symbol table). */\nexport const SCRIPT_FACE_OPS: readonly ScriptFaceOp[] = [\n  { name: 'torus', module: 'topology' },\n  { name: 'fuse', module: 'topology', engines: [\"occt\"] },\n  { name: 'inspectMassProps', module: 'measurement', engines: [\"occt\"] },\n  { name: 'area', module: 'measurement' },\n  { name: 'length', module: 'measurement' },\n  { name: 'volume', module: 'measurement' },\n  { name: 'centerOfMass', module: 'measurement' },\n  { name: 'viewCamera', module: 'view' },\n  { name: 'projectView', module: 'view' },\n  { name: 'projectSheet', module: 'view' },\n  { name: 'complexExtrude', module: 'operations', engines: [\"occt\"] },\n  { name: 'twistExtrude', module: 'operations', engines: [\"occt\"] },\n  { name: 'linearPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'circularPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'gridPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'roof', module: 'operations', engines: [\"occt\"] },\n  { name: 'drill', module: 'operations' },\n  { name: 'pocket', module: 'operations' },\n  { name: 'boss', module: 'operations' },\n  { name: 'mirrorJoin', module: 'operations' },\n  { name: 'rectangularPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'thread', module: 'operations', engines: [\"occt\"] },\n  { name: 'convexHull', module: 'operations' },\n  { name: 'makeBaseBox', module: 'sketching' },\n  { name: 'ellipsoid', module: 'topology' },\n  { name: 'rotate', module: 'topology' },\n  { name: 'mirror', module: 'topology' },\n  { name: 'clone', module: 'topology' },\n  { name: 'applyMatrix', module: 'topology' },\n  { name: 'locate', module: 'topology', engines: [\"occt\"] },\n  { name: 'split', module: 'topology', engines: [\"occt\"] },\n  { name: 'offset', module: 'topology', engines: [\"occt\"] },\n  { name: 'heal', module: 'topology', engines: [\"occt\"] },\n  { name: 'simplify', module: 'topology', engines: [\"occt\"] },\n  { name: 'isValid', module: 'topology' },\n  { name: 'isSameShape', module: 'topology' },\n  { name: 'autoHeal', module: 'topology', engines: [\"occt\"] },\n  { name: 'fixShape', module: 'topology' },\n  { name: 'healSolid', module: 'topology' },\n  { name: 'fixSelfIntersection', module: 'topology', engines: [\"occt\"] },\n]\n"]}
+{"version":3,"file":"script-face-manifest.js","sourceRoot":"","sources":["../../../src/api/generated/script-face-manifest.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * generated/script-face-manifest.ts — 生成文件，禁手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成。\n * cad 脚本面新增 op 清单（P23 B1 双源一致：cad 面 ≡ check() 符号表）。\n */\n\n/** 一条 cad 脚本面新增 op。 */\nexport interface ScriptFaceOp {\n  /** faijs 面导出名（= brepjs 符号名）。 */\n  name: string\n  /** 所属分片模块（生成文件名）。 */\n  module: string\n  /** Phase 5（D11）：平台 op 的平台身份（中立 op 缺省）。 */\n  engines?: readonly string[]\n  /** P26 (unit-system D8)：参数量纲声明（参数名 → DimName）。 */\n  paramDims?: Record<string, string>\n  /** P26 (unit-system D8)：返回值量纲。 */\n  retDim?: string\n}\n\n/** Cad script-face op manifest (B1: single source for cad namespace, check() symbol table). */\nexport const SCRIPT_FACE_OPS: readonly ScriptFaceOp[] = [\n  { name: 'torus', module: 'topology' },\n  { name: 'fuse', module: 'topology' },\n  { name: 'inspectMassProps', module: 'measurement', engines: [\"occt\"] },\n  { name: 'area', module: 'measurement' },\n  { name: 'length', module: 'measurement' },\n  { name: 'volume', module: 'measurement' },\n  { name: 'centerOfMass', module: 'measurement' },\n  { name: 'viewCamera', module: 'view' },\n  { name: 'projectView', module: 'view' },\n  { name: 'projectSheet', module: 'view' },\n  { name: 'complexExtrude', module: 'operations', engines: [\"occt\"] },\n  { name: 'twistExtrude', module: 'operations', engines: [\"occt\"] },\n  { name: 'linearPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'circularPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'gridPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'roof', module: 'operations', engines: [\"occt\"] },\n  { name: 'drill', module: 'operations' },\n  { name: 'pocket', module: 'operations' },\n  { name: 'boss', module: 'operations' },\n  { name: 'mirrorJoin', module: 'operations' },\n  { name: 'rectangularPattern', module: 'operations', engines: [\"occt\"] },\n  { name: 'thread', module: 'operations', engines: [\"occt\"] },\n  { name: 'convexHull', module: 'operations' },\n  { name: 'makeBaseBox', module: 'sketching' },\n  { name: 'ellipsoid', module: 'topology' },\n  { name: 'rotate', module: 'topology' },\n  { name: 'mirror', module: 'topology' },\n  { name: 'clone', module: 'topology' },\n  { name: 'applyMatrix', module: 'topology' },\n  { name: 'locate', module: 'topology', engines: [\"occt\"] },\n  { name: 'split', module: 'topology', engines: [\"occt\"] },\n  { name: 'offset', module: 'topology', engines: [\"occt\"] },\n  { name: 'heal', module: 'topology', engines: [\"occt\"] },\n  { name: 'simplify', module: 'topology', engines: [\"occt\"] },\n  { name: 'isValid', module: 'topology' },\n  { name: 'isSameShape', module: 'topology' },\n  { name: 'autoHeal', module: 'topology', engines: [\"occt\"] },\n  { name: 'fixShape', module: 'topology' },\n  { name: 'healSolid', module: 'topology' },\n  { name: 'fixSelfIntersection', module: 'topology', engines: [\"occt\"] },\n]\n"]}

package/dist/api/generated/topology.js

@@ -46,7 +46,7 @@ export const torus = defineOp({
  */
 export const fuse = defineOp({
     brep: __own_fuseBrep,
-    name: 'fuse', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"], paramDims: {},
+    name: 'fuse', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, paramDims: {},
 });
 /**
  * getBounds — 查询（core，生成文件，勿手改；来源 api/surface/arg-spec.ts）。