@faicad/faijs 0.30.9 → 0.32.2

package/dist/api/feature-repair.js

@@ -16,7 +16,7 @@
  * - `reverseShape` 声明 `engines: ['occt']` —— 实证收窄：brepkit 实测在 **op 级**
  *   失败（`invalid solid handle: index N is out of bounds`，callee = reverseShape，
  *   非输入构造侧），静态门须在执行前拒绝。
- * - 其余五条保持中立（声明 `capabilities: ['directEdit']`，无 engines）。
+ * - 其余五条保持中立（无 engines）。
  *   注意 `unifySameDomain` 在 brepkit 上**可用但语义有差**（会把体重新居中），
  *   未收窄 —— 缺证据表明它不可用，不擅自扩大范围。
  *
@@ -84,7 +84,6 @@ const kernelNaming = { kind: 'kernel', newFaces: { via: 'byAdjacency' } };
  * const base = await cad.defeature(part0, [cad.faceRef(part0, 5)])
  */
 export const defeature = defineOp({
-    capabilities: ['directEdit'],
     brep(input, faces) {
         if (!Array.isArray(faces) || faces.length === 0) {
             throw new Error('E_DEFEATURE_NO_FACES: defeature requires at least one FaceTopoRef');
@@ -95,6 +94,7 @@ export const defeature = defineOp({
         return adopt(kernel, kernel.defeature(solid, handles));
     },
     naming: kernelNaming,
+    paramDims: {},
 });
 /**
  * 反转壳体朝向（内表面 ↔ 外表面）。
@@ -113,7 +113,6 @@ export const defeature = defineOp({
  * const flipped = await cad.reverseShape(sh)
  */
 export const reverseShape = defineOp({
-    capabilities: ['directEdit'],
     // 实证收窄（2026-09-24）：brepkit op 级失败 → 静态门提前拒绝。
     engines: ['occt'],
     brep(input) {
@@ -122,6 +121,7 @@ export const reverseShape = defineOp({
         return adopt(kernel, kernel.reverseShape(solid));
     },
     naming: kernelNaming,
+    paramDims: {},
 });
 /**
  * 合并同域面/边（去除被分割成多片的冗余细分）。
@@ -137,13 +137,13 @@ export const reverseShape = defineOp({
  * const merged = await cad.unifySameDomain(part0)
  */
 export const unifySameDomain = defineOp({
-    capabilities: ['directEdit'],
     brep(input) {
         const kernel = getBrepApi();
         const solid = requireBrep(input, 'unifySameDomain');
         return adopt(kernel, kernel.unifySameDomain(solid));
     },
     naming: kernelNaming,
+    paramDims: {},
 });
 /**
  * 缝合：把一组面/壳沿公共边缝成一张壳。
@@ -160,13 +160,13 @@ export const unifySameDomain = defineOp({
  * const shellShape = await cad.sew([f1, f2, f3], { tolerance: 1e-5 })
  */
 export const sew = defineOp({
-    capabilities: ['directEdit'],
     brep(shapes, params) {
         const kernel = getBrepApi();
         const handles = borrowHandles(shapes, 'sew');
         return adopt(kernel, kernel.sew(handles, params?.tolerance));
     },
     naming: kernelNaming,
+    paramDims: {},
 });
 /**
  * 缝合并固化为实体：缝合后若闭合则生成 solid。
@@ -183,13 +183,13 @@ export const sew = defineOp({
  * const solid = await cad.sewAndSolidify([f1, f2, f3, f4, f5, f6])
  */
 export const sewAndSolidify = defineOp({
-    capabilities: ['directEdit'],
     brep(shapes, params) {
         const kernel = getBrepApi();
         const handles = borrowHandles(shapes, 'sewAndSolidify');
         return adopt(kernel, kernel.sewAndSolidify(handles, params?.tolerance));
     },
     naming: kernelNaming,
+    paramDims: {},
 });
 /**
  * 移除面（或实体某面）上的孔。
@@ -206,7 +206,6 @@ export const sewAndSolidify = defineOp({
  * const plain = await cad.removeHolesFromFace(faceWithHoles)
  */
 export const removeHolesFromFace = defineOp({
-    capabilities: ['directEdit'],
     brep(face) {
         if (!face)
             throw new Error('E_REMOVEHOLES_NO_FACE: removeHolesFromFace requires a face shape');
@@ -217,5 +216,6 @@ export const removeHolesFromFace = defineOp({
         return adopt(kernel, kernel.removeHolesFromFace(handle));
     },
     naming: kernelNaming,
+    paramDims: {},
 });
 //# sourceMappingURL=feature-repair.js.map

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

@@ -1 +1 @@
-{"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 * - 其余五条保持中立（声明 `capabilities: ['directEdit']`，无 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) 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  capabilities: ['directEdit'],\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\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  capabilities: ['directEdit'],\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\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  capabilities: ['directEdit'],\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\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  capabilities: ['directEdit'],\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\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  capabilities: ['directEdit'],\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\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  capabilities: ['directEdit'],\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) 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"]}
+{"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'\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) 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) 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.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;;CAMzB,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;AAkCrD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc;;CAOzB,CAAA"}

package/dist/api/fillet-variable.js

@@ -62,10 +62,10 @@ function filletVariableBrep(input, edge, startRadius, endRadius) {
  * const v = await cad.filletVariable(part0, partEdges[0], 1, 4)
  */
 export const filletVariable = defineOp({
-    capabilities: ['directEdit'],
     brep(input, edge, r1, r2) {
         return filletVariableBrep(input, edge, r1, r2);
     },
     naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
+    paramDims: {},
 });
 //# sourceMappingURL=fillet-variable.js.map

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,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAEpF,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,YAAY,EAAE,CAAC,YAAY,CAAC;IAC5B,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;CAC3E,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) 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  capabilities: ['directEdit'],\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"]}
+{"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,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAA;IAEpF,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) 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"]}

package/dist/api/fillet.d.ts

@@ -1,9 +1,9 @@
 /**
- * api fillet — fillet 圆角库函数（BREP-only，directEdit 能力）
+ * api fillet — fillet 圆角库函数（BREP-only）
  *
  * 平台分层（narrowing plan Phase 5，D11）：**中立 op**——`filletWithHistory` 是
- * L1 核心面（brepkit 亦实现），实现全程走 L1（getBrepApi，D12），不声明 engines；
- * capabilities 保留族级 `directEdit`（brepkit 声明 directEdit: true）。
+ * L1 核心面（brepkit 亦实现），实现全程走 L1（getBrepApi，D12），不声明 engines。
+ * 实现体内不分支：两引擎都走 `filletWithRoleTable` 历史轨（见 `filletBrep`）。
  *
  * 与 chamfer 的差异：fillet 用 filletWithHistory 走面演化 + roleTable 传播
  * （chamfer 在 P5 同步改造）。M1 只支持等半径；M2 计划支持变半径与几何限定符。

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;;CAYjB,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;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"}

package/dist/api/fillet.js

@@ -1,9 +1,9 @@
 /**
- * api fillet — fillet 圆角库函数（BREP-only，directEdit 能力）
+ * api fillet — fillet 圆角库函数（BREP-only）
  *
  * 平台分层（narrowing plan Phase 5，D11）：**中立 op**——`filletWithHistory` 是
- * L1 核心面（brepkit 亦实现），实现全程走 L1（getBrepApi，D12），不声明 engines；
- * capabilities 保留族级 `directEdit`（brepkit 声明 directEdit: true）。
+ * L1 核心面（brepkit 亦实现），实现全程走 L1（getBrepApi，D12），不声明 engines。
+ * 实现体内不分支：两引擎都走 `filletWithRoleTable` 历史轨（见 `filletBrep`）。
  *
  * 与 chamfer 的差异：fillet 用 filletWithHistory 走面演化 + roleTable 传播
  * （chamfer 在 P5 同步改造）。M1 只支持等半径；M2 计划支持变半径与几何限定符。
@@ -169,7 +169,6 @@ function filletMeshSolid(input, params) {
  * const q = await cad.fillet(meshPart, { edges: [3], radius: 1 })
  */
 export const fillet = defineOp({
-    capabilities: ['directEdit'],
     meshEngines: ['brepkit'],
     mesh(input, params) {
         assertFilletParams(params, { allowOrdinals: true });
@@ -180,5 +179,6 @@ export const fillet = defineOp({
         return filletBrep(input, params);
     },
     naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
+    paramDims: {},
 });
 //# sourceMappingURL=fillet.js.map

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，directEdit 能力）\n *\n * 平台分层（narrowing plan Phase 5，D11）：**中立 op**——`filletWithHistory` 是\n * L1 核心面（brepkit 亦实现），实现全程走 L1（getBrepApi，D12），不声明 engines；\n * capabilities 保留族级 `directEdit`（brepkit 声明 directEdit: true）。\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) 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  capabilities: ['directEdit'],\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"]}
+{"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) 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"]}

package/dist/api/generated/operations.js

@@ -32,7 +32,7 @@ import { convexHullBrep as __own_convexHullBrep } from '../brep-operations/hullF
  */
 export const extrude = defineOp({
     brep: __own_extrudeBrep,
-    name: 'extrude', naming: { "kind": "construct", "newFaces": { "via": "explicit", "vocab": [{ "kind": "semantic", "name": "top" }, { "kind": "semantic", "name": "bottom" }] } }, engines: ["occt"],
+    name: 'extrude', naming: { "kind": "construct", "newFaces": { "via": "explicit", "vocab": [{ "kind": "semantic", "name": "top" }, { "kind": "semantic", "name": "bottom" }] } }, engines: ["occt"], paramDims: {},
 });
 /**
  * revolve — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -42,7 +42,7 @@ export const extrude = defineOp({
  */
 export const revolve = defineOp({
     brep: __own_revolveBrep,
-    name: 'revolve', naming: { "kind": "construct", "newFaces": { "via": "explicit", "vocab": [{ "kind": "semantic", "name": "top" }, { "kind": "semantic", "name": "bottom" }, { "kind": "wall", "index": 0 }] } }, engines: ["occt"],
+    name: 'revolve', naming: { "kind": "construct", "newFaces": { "via": "explicit", "vocab": [{ "kind": "semantic", "name": "top" }, { "kind": "semantic", "name": "bottom" }, { "kind": "wall", "index": 0 }] } }, engines: ["occt"], paramDims: {},
 });
 /**
  * sweep — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -52,7 +52,7 @@ export const revolve = defineOp({
  */
 export const sweep = defineOp({
     brep: __own_sweepBrep,
-    name: 'sweep', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"],
+    name: 'sweep', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"], paramDims: {},
 });
 /**
  * complexExtrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -62,7 +62,7 @@ export const sweep = defineOp({
  */
 export const complexExtrude = defineOp({
     brep: __own_complexExtrudeBrep,
-    name: 'complexExtrude', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"],
+    name: 'complexExtrude', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"], paramDims: {},
 });
 /**
  * twistExtrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -72,7 +72,7 @@ export const complexExtrude = defineOp({
  */
 export const twistExtrude = defineOp({
     brep: __own_twistExtrudeBrep,
-    name: 'twistExtrude', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"],
+    name: 'twistExtrude', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"], paramDims: {},
 });
 /**
  * linearPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -82,7 +82,7 @@ export const twistExtrude = defineOp({
  */
 export const linearPattern = defineOp({
     brep: __own_linearPatternBrep,
-    name: 'linearPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"],
+    name: 'linearPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"], paramDims: {},
 });
 /**
  * circularPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -92,7 +92,7 @@ export const linearPattern = defineOp({
  */
 export const circularPattern = defineOp({
     brep: __own_circularPatternBrep,
-    name: 'circularPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"],
+    name: 'circularPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"], paramDims: {},
 });
 /**
  * gridPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -102,7 +102,7 @@ export const circularPattern = defineOp({
  */
 export const gridPattern = defineOp({
     brep: __own_gridPatternBrep,
-    name: 'gridPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"],
+    name: 'gridPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"], paramDims: {},
 });
 /**
  * roof — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -112,7 +112,7 @@ export const gridPattern = defineOp({
  */
 export const roof = defineOp({
     brep: __own_roofBrep,
-    name: 'roof', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, capabilities: ["buildTriFace", "dispose", "fixShape", "isValid", "sew", "sewAndSolidify"],
+    name: 'roof', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"], paramDims: {},
 });
 /**
  * drill — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -122,7 +122,7 @@ export const roof = defineOp({
  */
 export const drill = defineOp({
     brep: __own_drillBrep,
-    name: 'drill', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, capabilities: ["makeCylinder", "located", "getBoundingBox", "cut"],
+    name: 'drill', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, paramDims: {},
 });
 /**
  * pocket — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -132,7 +132,7 @@ export const drill = defineOp({
  */
 export const pocket = defineOp({
     brep: __own_pocketBrep,
-    name: 'pocket', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, capabilities: ["getSubShapes", "surfaceCenterOfMass", "uvBounds", "surfaceNormal", "makeFace", "translate", "extrude", "cut"],
+    name: 'pocket', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, paramDims: {},
 });
 /**
  * boss — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -142,7 +142,7 @@ export const pocket = defineOp({
  */
 export const boss = defineOp({
     brep: __own_bossBrep,
-    name: 'boss', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, capabilities: ["getSubShapes", "surfaceCenterOfMass", "uvBounds", "surfaceNormal", "makeFace", "translate", "extrude", "fuse"],
+    name: 'boss', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, paramDims: {},
 });
 /**
  * mirrorJoin — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -152,7 +152,7 @@ export const boss = defineOp({
  */
 export const mirrorJoin = defineOp({
     brep: __own_mirrorJoinBrep,
-    name: 'mirrorJoin', naming: { "kind": "replicate", "k": 2 }, capabilities: ["mirror", "fuse"],
+    name: 'mirrorJoin', naming: { "kind": "replicate", "k": 2 }, paramDims: {},
 });
 /**
  * rectangularPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -162,7 +162,7 @@ export const mirrorJoin = defineOp({
  */
 export const rectangularPattern = defineOp({
     brep: __own_rectangularPatternBrep,
-    name: 'rectangularPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"],
+    name: 'rectangularPattern', naming: { "kind": "replicate", "k": 0 }, engines: ["occt"], paramDims: {},
 });
 /**
  * thread — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -172,7 +172,7 @@ export const rectangularPattern = defineOp({
  */
 export const thread = defineOp({
     brep: __own_threadBrepOp,
-    name: 'thread', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"],
+    name: 'thread', naming: { "kind": "kernel", "newFaces": { "via": "byAdjacency" } }, engines: ["occt"], paramDims: {},
 });
 /**
  * convexHull — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。
@@ -182,6 +182,6 @@ export const thread = defineOp({
  */
 export const convexHull = defineOp({
     brep: __own_convexHullBrep,
-    name: 'convexHull', naming: { "kind": "unmodeled", "reason": "construct vocabulary pending Phase 3" }, capabilities: ["hullFromPoints"],
+    name: 'convexHull', naming: { "kind": "unmodeled", "reason": "construct vocabulary pending Phase 3" }, paramDims: {},
 });
 //# sourceMappingURL=operations.js.map

package/dist/api/generated/operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/api/generated/operations.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * generated/operations.ts — 生成文件，勿手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。\n * operations 模块：16 个投影符号；另有 106 个 skip 登记。\n * A6（2026-10-06）口径指认：本文件是 brepjs 投影面的**增量**清单；脚本面全集的\n * 权威来源是 generated/script-face.ts + gen-symbol-table 产物\n * lang/symbol-table.generated.ts（cad 脚本面 95 op）。两个清单回答不同问题，\n * 互不为超集——禁止用本文件的名字反推脚本面能力。\n */\nimport { defineOp } from '../../define-op'\nimport { extrudeBrep as __own_extrudeBrep } from '../brep-operations/sweepFns'\nimport { revolveBrep as __own_revolveBrep } from '../brep-operations/sweepFns'\nimport { sweepBrep as __own_sweepBrep } from '../brep-operations/sweepFns'\nimport { complexExtrudeBrep as __own_complexExtrudeBrep } from '../brep-operations/sweepFns'\nimport { twistExtrudeBrep as __own_twistExtrudeBrep } from '../brep-operations/sweepFns'\nimport { linearPatternBrep as __own_linearPatternBrep } from '../brep-operations/patternFns'\nimport { circularPatternBrep as __own_circularPatternBrep } from '../brep-operations/patternFns'\nimport { gridPatternBrep as __own_gridPatternBrep } from '../brep-operations/patternFns'\nimport { roofBrep as __own_roofBrep } from '../brep-operations/roofFns'\nimport { drillBrep as __own_drillBrep } from '../brep-operations/compoundFns'\nimport { pocketBrep as __own_pocketBrep } from '../brep-operations/compoundFns'\nimport { bossBrep as __own_bossBrep } from '../brep-operations/compoundFns'\nimport { mirrorJoinBrep as __own_mirrorJoinBrep } from '../brep-operations/compoundFns'\nimport { rectangularPatternBrep as __own_rectangularPatternBrep } from '../brep-operations/patternFns'\nimport { threadBrepOp as __own_threadBrepOp } from '../brep-operations/threadFns'\nimport { convexHullBrep as __own_convexHullBrep } from '../brep-operations/hullFns'\n\n/**\n * extrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * extrude(face: Shape, height: number|Vec3) → Shape｜extrude(face: Shape, params: { length? | upTo, normal?, mode?, baseFeature?, offset? }) → Shape\n * 桥接：defineOp({ brep: __own_extrudeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const extrude = defineOp({\n  brep: __own_extrudeBrep,\n  name: 'extrude', naming: {\"kind\":\"construct\",\"newFaces\":{\"via\":\"explicit\",\"vocab\":[{\"kind\":\"semantic\",\"name\":\"top\"},{\"kind\":\"semantic\",\"name\":\"bottom\"}]}}, engines: [\"occt\"],\n})\n\n/**\n * revolve — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * revolve(face: Shape, options?: RevolveOptions): Shape\n * 桥接：defineOp({ brep: __own_revolveBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const revolve = defineOp({\n  brep: __own_revolveBrep,\n  name: 'revolve', naming: {\"kind\":\"construct\",\"newFaces\":{\"via\":\"explicit\",\"vocab\":[{\"kind\":\"semantic\",\"name\":\"top\"},{\"kind\":\"semantic\",\"name\":\"bottom\"},{\"kind\":\"wall\",\"index\":0}]}}, engines: [\"occt\"],\n})\n\n/**\n * sweep — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * sweep(wire: Shape, spine: Shape, config?: SweepOptions, shellMode?: boolean): Shape\n * 桥接：defineOp({ brep: __own_sweepBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const sweep = defineOp({\n  brep: __own_sweepBrep,\n  name: 'sweep', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/**\n * complexExtrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * complexExtrude(wire: Shape, center: Vec3, normal: Vec3, profile?: ExtrusionProfile): Shape\n * 桥接：defineOp({ brep: __own_complexExtrudeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const complexExtrude = defineOp({\n  brep: __own_complexExtrudeBrep,\n  name: 'complexExtrude', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/**\n * twistExtrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * twistExtrude(wire: Shape, angleDegrees: number, center: Vec3, normal: Vec3): Shape\n * 桥接：defineOp({ brep: __own_twistExtrudeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const twistExtrude = defineOp({\n  brep: __own_twistExtrudeBrep,\n  name: 'twistExtrude', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/**\n * linearPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * linearPattern(shape: Shape, direction: Vec3, count: number, spacing: number): Shape\n * 桥接：defineOp({ brep: __own_linearPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const linearPattern = defineOp({\n  brep: __own_linearPatternBrep,\n  name: 'linearPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"],\n})\n\n/**\n * circularPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * circularPattern(shape: Shape, axis: Vec3, count: number, fullAngle?: number, center?: Vec3): Shape\n * 桥接：defineOp({ brep: __own_circularPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const circularPattern = defineOp({\n  brep: __own_circularPatternBrep,\n  name: 'circularPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"],\n})\n\n/**\n * gridPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * gridPattern(shape: Shape, directionX: Vec3, directionY: Vec3, countX: number, countY: number, spacingX: number, spacingY: number): Shape\n * 桥接：defineOp({ brep: __own_gridPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const gridPattern = defineOp({\n  brep: __own_gridPatternBrep,\n  name: 'gridPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"],\n})\n\n/**\n * roof — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * roof(wire: Shape, options?: RoofOptions): Shape\n * 桥接：defineOp({ brep: __own_roofBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const roof = defineOp({\n  brep: __own_roofBrep,\n  name: 'roof', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, capabilities: [\"buildTriFace\",\"dispose\",\"fixShape\",\"isValid\",\"sew\",\"sewAndSolidify\"],\n})\n\n/**\n * drill — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * drill(shape: Shape, options: DrillOptions): Shape\n * 桥接：defineOp({ brep: __own_drillBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const drill = defineOp({\n  brep: __own_drillBrep,\n  name: 'drill', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, capabilities: [\"makeCylinder\",\"located\",\"getBoundingBox\",\"cut\"],\n})\n\n/**\n * pocket — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * pocket(shape: Shape, options: PocketOptions): Shape\n * 桥接：defineOp({ brep: __own_pocketBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const pocket = defineOp({\n  brep: __own_pocketBrep,\n  name: 'pocket', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, capabilities: [\"getSubShapes\",\"surfaceCenterOfMass\",\"uvBounds\",\"surfaceNormal\",\"makeFace\",\"translate\",\"extrude\",\"cut\"],\n})\n\n/**\n * boss — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * boss(shape: Shape, options: BossOptions): Shape\n * 桥接：defineOp({ brep: __own_bossBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const boss = defineOp({\n  brep: __own_bossBrep,\n  name: 'boss', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, capabilities: [\"getSubShapes\",\"surfaceCenterOfMass\",\"uvBounds\",\"surfaceNormal\",\"makeFace\",\"translate\",\"extrude\",\"fuse\"],\n})\n\n/**\n * mirrorJoin — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * mirrorJoin(shape: Shape, options?: MirrorJoinOptions): Shape\n * 桥接：defineOp({ brep: __own_mirrorJoinBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const mirrorJoin = defineOp({\n  brep: __own_mirrorJoinBrep,\n  name: 'mirrorJoin', naming: {\"kind\":\"replicate\",\"k\":2}, capabilities: [\"mirror\",\"fuse\"],\n})\n\n/**\n * rectangularPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * rectangularPattern(shape: Shape, options: RectangularPatternOptions): Shape\n * 桥接：defineOp({ brep: __own_rectangularPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const rectangularPattern = defineOp({\n  brep: __own_rectangularPatternBrep,\n  name: 'rectangularPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"],\n})\n\n/**\n * thread — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * thread(options: ThreadOptions): Shape\n * 桥接：defineOp({ brep: __own_threadBrepOp })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const thread = defineOp({\n  brep: __own_threadBrepOp,\n  name: 'thread', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"],\n})\n\n/**\n * convexHull — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * convexHull(points: Vec3[]): Shape\n * 桥接：defineOp({ brep: __own_convexHullBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const convexHull = defineOp({\n  brep: __own_convexHullBrep,\n  name: 'convexHull', naming: {\"kind\":\"unmodeled\",\"reason\":\"construct vocabulary pending Phase 3\"}, capabilities: [\"hullFromPoints\"],\n})\n"]}
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/api/generated/operations.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * generated/operations.ts — 生成文件，勿手改。\n * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成（E5/P14 分片）。\n * operations 模块：16 个投影符号；另有 106 个 skip 登记。\n * A6（2026-10-06）口径指认：本文件是 brepjs 投影面的**增量**清单；脚本面全集的\n * 权威来源是 generated/script-face.ts + gen-symbol-table 产物\n * lang/symbol-table.generated.ts（cad 脚本面 95 op）。两个清单回答不同问题，\n * 互不为超集——禁止用本文件的名字反推脚本面能力。\n */\nimport { defineOp } from '../../define-op'\nimport { extrudeBrep as __own_extrudeBrep } from '../brep-operations/sweepFns'\nimport { revolveBrep as __own_revolveBrep } from '../brep-operations/sweepFns'\nimport { sweepBrep as __own_sweepBrep } from '../brep-operations/sweepFns'\nimport { complexExtrudeBrep as __own_complexExtrudeBrep } from '../brep-operations/sweepFns'\nimport { twistExtrudeBrep as __own_twistExtrudeBrep } from '../brep-operations/sweepFns'\nimport { linearPatternBrep as __own_linearPatternBrep } from '../brep-operations/patternFns'\nimport { circularPatternBrep as __own_circularPatternBrep } from '../brep-operations/patternFns'\nimport { gridPatternBrep as __own_gridPatternBrep } from '../brep-operations/patternFns'\nimport { roofBrep as __own_roofBrep } from '../brep-operations/roofFns'\nimport { drillBrep as __own_drillBrep } from '../brep-operations/compoundFns'\nimport { pocketBrep as __own_pocketBrep } from '../brep-operations/compoundFns'\nimport { bossBrep as __own_bossBrep } from '../brep-operations/compoundFns'\nimport { mirrorJoinBrep as __own_mirrorJoinBrep } from '../brep-operations/compoundFns'\nimport { rectangularPatternBrep as __own_rectangularPatternBrep } from '../brep-operations/patternFns'\nimport { threadBrepOp as __own_threadBrepOp } from '../brep-operations/threadFns'\nimport { convexHullBrep as __own_convexHullBrep } from '../brep-operations/hullFns'\n\n/**\n * extrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * extrude(face: Shape, height: number|Vec3) → Shape｜extrude(face: Shape, params: { length? | upTo, normal?, mode?, baseFeature?, offset? }) → Shape\n * 桥接：defineOp({ brep: __own_extrudeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const extrude = defineOp({\n  brep: __own_extrudeBrep,\n  name: 'extrude', naming: {\"kind\":\"construct\",\"newFaces\":{\"via\":\"explicit\",\"vocab\":[{\"kind\":\"semantic\",\"name\":\"top\"},{\"kind\":\"semantic\",\"name\":\"bottom\"}]}}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * revolve — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * revolve(face: Shape, options?: RevolveOptions): Shape\n * 桥接：defineOp({ brep: __own_revolveBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const revolve = defineOp({\n  brep: __own_revolveBrep,\n  name: 'revolve', naming: {\"kind\":\"construct\",\"newFaces\":{\"via\":\"explicit\",\"vocab\":[{\"kind\":\"semantic\",\"name\":\"top\"},{\"kind\":\"semantic\",\"name\":\"bottom\"},{\"kind\":\"wall\",\"index\":0}]}}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * sweep — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * sweep(wire: Shape, spine: Shape, config?: SweepOptions, shellMode?: boolean): Shape\n * 桥接：defineOp({ brep: __own_sweepBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const sweep = defineOp({\n  brep: __own_sweepBrep,\n  name: 'sweep', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * complexExtrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * complexExtrude(wire: Shape, center: Vec3, normal: Vec3, profile?: ExtrusionProfile): Shape\n * 桥接：defineOp({ brep: __own_complexExtrudeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const complexExtrude = defineOp({\n  brep: __own_complexExtrudeBrep,\n  name: 'complexExtrude', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * twistExtrude — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * twistExtrude(wire: Shape, angleDegrees: number, center: Vec3, normal: Vec3): Shape\n * 桥接：defineOp({ brep: __own_twistExtrudeBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const twistExtrude = defineOp({\n  brep: __own_twistExtrudeBrep,\n  name: 'twistExtrude', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * linearPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * linearPattern(shape: Shape, direction: Vec3, count: number, spacing: number): Shape\n * 桥接：defineOp({ brep: __own_linearPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const linearPattern = defineOp({\n  brep: __own_linearPatternBrep,\n  name: 'linearPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * circularPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * circularPattern(shape: Shape, axis: Vec3, count: number, fullAngle?: number, center?: Vec3): Shape\n * 桥接：defineOp({ brep: __own_circularPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const circularPattern = defineOp({\n  brep: __own_circularPatternBrep,\n  name: 'circularPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * gridPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * gridPattern(shape: Shape, directionX: Vec3, directionY: Vec3, countX: number, countY: number, spacingX: number, spacingY: number): Shape\n * 桥接：defineOp({ brep: __own_gridPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const gridPattern = defineOp({\n  brep: __own_gridPatternBrep,\n  name: 'gridPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * roof — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * roof(wire: Shape, options?: RoofOptions): Shape\n * 桥接：defineOp({ brep: __own_roofBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const roof = defineOp({\n  brep: __own_roofBrep,\n  name: 'roof', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * drill — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * drill(shape: Shape, options: DrillOptions): Shape\n * 桥接：defineOp({ brep: __own_drillBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const drill = defineOp({\n  brep: __own_drillBrep,\n  name: 'drill', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/**\n * pocket — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * pocket(shape: Shape, options: PocketOptions): Shape\n * 桥接：defineOp({ brep: __own_pocketBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const pocket = defineOp({\n  brep: __own_pocketBrep,\n  name: 'pocket', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/**\n * boss — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * boss(shape: Shape, options: BossOptions): Shape\n * 桥接：defineOp({ brep: __own_bossBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const boss = defineOp({\n  brep: __own_bossBrep,\n  name: 'boss', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, paramDims: {},\n})\n\n/**\n * mirrorJoin — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * mirrorJoin(shape: Shape, options?: MirrorJoinOptions): Shape\n * 桥接：defineOp({ brep: __own_mirrorJoinBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const mirrorJoin = defineOp({\n  brep: __own_mirrorJoinBrep,\n  name: 'mirrorJoin', naming: {\"kind\":\"replicate\",\"k\":2}, paramDims: {},\n})\n\n/**\n * rectangularPattern — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * rectangularPattern(shape: Shape, options: RectangularPatternOptions): Shape\n * 桥接：defineOp({ brep: __own_rectangularPatternBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const rectangularPattern = defineOp({\n  brep: __own_rectangularPatternBrep,\n  name: 'rectangularPattern', naming: {\"kind\":\"replicate\",\"k\":0}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * thread — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * thread(options: ThreadOptions): Shape\n * 桥接：defineOp({ brep: __own_threadBrepOp })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const thread = defineOp({\n  brep: __own_threadBrepOp,\n  name: 'thread', naming: {\"kind\":\"kernel\",\"newFaces\":{\"via\":\"byAdjacency\"}}, engines: [\"occt\"], paramDims: {},\n})\n\n/**\n * convexHull — core 自有实现（生成文件，禁手改；来源 api/surface/arg-spec.ts）。\n * convexHull(points: Vec3[]): Shape\n * 桥接：defineOp({ brep: __own_convexHullBrep })——core 直连 occt 引擎（§5.4），\n * D11 归一在自有实现内部完成（api/brep-operations/）。\n */\nexport const convexHull = defineOp({\n  brep: __own_convexHullBrep,\n  name: 'convexHull', naming: {\"kind\":\"unmodeled\",\"reason\":\"construct vocabulary pending Phase 3\"}, paramDims: {},\n})\n"]}

package/dist/api/generated/script-face-manifest.d.ts

@@ -1,7 +1,7 @@
 /**
  * generated/script-face-manifest.ts — 生成文件，禁手改。
  * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成。
- * cad 脚本面新增 op 清单（P23 B1 三源一致：导出面 ≡ cad 面 ≡ check() 符号表）。
+ * cad 脚本面新增 op 清单（P23 B1 双源一致：cad 面 ≡ check() 符号表）。
  */
 /** 一条 cad 脚本面新增 op。 */
 export interface ScriptFaceOp {

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

@@ -1,7 +1,7 @@
 /**
  * generated/script-face-manifest.ts — 生成文件，禁手改。
  * 由 packages/core/scripts/gen-l3-surface.ts 依据 api/surface/arg-spec.ts 生成。
- * cad 脚本面新增 op 清单（P23 B1 三源一致：导出面 ≡ cad 面 ≡ check() 符号表）。
+ * cad 脚本面新增 op 清单（P23 B1 双源一致：cad 面 ≡ check() 符号表）。
  */
 /** Cad script-face op manifest (B1: single source for cad namespace, check() symbol table). */
 export const SCRIPT_FACE_OPS = [
@@ -20,7 +20,7 @@ export const SCRIPT_FACE_OPS = [
     { name: 'linearPattern', module: 'operations', engines: ["occt"] },
     { name: 'circularPattern', module: 'operations', engines: ["occt"] },
     { name: 'gridPattern', module: 'operations', engines: ["occt"] },
-    { name: 'roof', module: 'operations' },
+    { name: 'roof', module: 'operations', engines: ["occt"] },
     { name: 'drill', module: 'operations' },
     { name: 'pocket', module: 'operations' },
     { name: 'boss', module: 'operations' },
@@ -34,7 +34,7 @@ export const SCRIPT_FACE_OPS = [
     { name: 'mirror', module: 'topology' },
     { name: 'clone', module: 'topology' },
     { name: 'applyMatrix', module: 'topology' },
-    { name: 'locate', module: 'topology' },
+    { name: 'locate', module: 'topology', engines: ["occt"] },
     { name: 'split', module: 'topology', engines: ["occt"] },
     { name: 'offset', module: 'topology', engines: ["occt"] },
     { name: 'heal', module: 'topology', engines: ["occt"] },