@faicad/faijs 0.17.0 → 0.18.0

package/dist/api/surface/arg-spec.js

@@ -1719,7 +1719,8 @@ export const ARG_SPEC = [
         naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
     },
     {
-        name: 'drill', source: 'brep-mirror/compoundFns.ts#drillBrep', selfhost: true, kind: 'brep-op', engines: ['occt'], module: 'operations',
+        name: 'drill', source: 'brep-mirror/compoundFns.ts#drillBrep', selfhost: true, kind: 'brep-op',
+        capabilities: ["makeCylinder", "located", "getBoundingBox", "cut"], module: 'operations',
         geometryArgs: [0], reason: 'Shapeable<Shape3D> → Result<T>，brep-op',
         args: 'drill(shape: Shape, options: DrillOptions): Shape',
         params: ['shape', 'options'], formClass: 'A',
@@ -1727,7 +1728,8 @@ export const ARG_SPEC = [
         naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
     },
     {
-        name: 'pocket', source: 'brep-mirror/compoundFns.ts#pocketBrep', selfhost: true, kind: 'brep-op', engines: ['occt'], module: 'operations',
+        name: 'pocket', source: 'brep-mirror/compoundFns.ts#pocketBrep', selfhost: true, kind: 'brep-op',
+        capabilities: ["getSubShapes", "surfaceCenterOfMass", "uvBounds", "surfaceNormal", "makeFace", "translate", "extrude", "cut"], module: 'operations',
         geometryArgs: [0], reason: 'Shapeable<Shape3D> → Result<T>，brep-op',
         args: 'pocket(shape: Shape, options: PocketOptions): Shape',
         params: ['shape', 'options'], formClass: 'A',
@@ -1735,7 +1737,8 @@ export const ARG_SPEC = [
         naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
     },
     {
-        name: 'boss', source: 'brep-mirror/compoundFns.ts#bossBrep', selfhost: true, kind: 'brep-op', engines: ['occt'], module: 'operations',
+        name: 'boss', source: 'brep-mirror/compoundFns.ts#bossBrep', selfhost: true, kind: 'brep-op',
+        capabilities: ["getSubShapes", "surfaceCenterOfMass", "uvBounds", "surfaceNormal", "makeFace", "translate", "extrude", "fuse"], module: 'operations',
         geometryArgs: [0], reason: 'Shapeable<Shape3D> → Result<T>，brep-op',
         args: 'boss(shape: Shape, options: BossOptions): Shape',
         params: ['shape', 'options'], formClass: 'A',
@@ -1743,7 +1746,8 @@ export const ARG_SPEC = [
         naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
     },
     {
-        name: 'mirrorJoin', source: 'brep-mirror/compoundFns.ts#mirrorJoinBrep', selfhost: true, kind: 'brep-op', engines: ['occt'], module: 'operations',
+        name: 'mirrorJoin', source: 'brep-mirror/compoundFns.ts#mirrorJoinBrep', selfhost: true, kind: 'brep-op',
+        capabilities: ["mirror", "fuse"], module: 'operations',
         geometryArgs: [0], reason: 'Shapeable<Shape3D> → Result<T>，brep-op',
         args: 'mirrorJoin(shape: Shape, options?: MirrorJoinOptions): Shape',
         params: ['shape', 'options'], formClass: 'A',
@@ -1767,7 +1771,7 @@ export const ARG_SPEC = [
         scriptFace: true,
     },
     {
-        name: 'convexHull', source: 'brep-mirror/hullFns.ts#convexHullBrep', selfhost: true, kind: 'brep-op', engines: ['occt'], module: 'operations',
+        name: 'convexHull', source: 'brep-mirror/hullFns.ts#convexHullBrep', selfhost: true, kind: 'brep-op', capabilities: ['hullFromPoints'], module: 'operations',
         geometryArgs: [], reason: '点集构造 → Result(Solid)，单产物，brep-op',
         args: 'convexHull(points: Vec3[]): Shape',
         params: ['points'], formClass: 'A',
@@ -2462,7 +2466,7 @@ export const ARG_SPEC = [
     },
     // 1 × brep-op（构造类：纯数值参数 → Shape3D，无几何输入）
     {
-        name: 'makeBaseBox', source: 'brep-mirror/primitiveFns.ts#makeBaseBoxBrep', selfhost: true, kind: 'brep-op', engines: ['occt'], module: 'sketching',
+        name: 'makeBaseBox', source: 'brep-mirror/primitiveFns.ts#makeBaseBoxBrep', selfhost: true, kind: 'brep-op', capabilities: ['makeRectangle', 'extrude'], module: 'sketching',
         args: '(xLength: number, yLength: number, zLength: number) -> Shape3D',
         geometryArgs: [],
         returnsResult: false,
@@ -2745,7 +2749,7 @@ export const ARG_SPEC = [
         reason: 'overridden by handwritten api/primitives.ts (cone dual-op, mesh+brep)',
     },
     {
-        name: 'ellipsoid', source: 'brep-mirror/primitiveFns.ts#ellipsoidBrep', selfhost: true, kind: 'brep-op', engines: ['occt'],
+        name: 'ellipsoid', source: 'brep-mirror/primitiveFns.ts#ellipsoidBrep', selfhost: true, kind: 'brep-op', capabilities: ['makeEllipsoid', 'translate'],
         geometryArgs: [], returnsResult: false,
         args: 'ellipsoid(rx: number, ry: number, rz: number, options?: EllipsoidOptions): Shape',
         reason: '纯数值整件构造（rx/ry/rz → ValidSolid），brep-op',
@@ -2844,7 +2848,7 @@ export const ARG_SPEC = [
         reason: 'faijs 同名 translate（§5.1 双形态：对象形态手写面覆盖 + v:Vec3 位置形态并入），生成层不重复投影',
     },
     {
-        name: 'rotate', source: 'brep-mirror/topologyFns.ts#rotateBrep', selfhost: true, kind: 'brep-op', engines: ['occt'],
+        name: 'rotate', source: 'brep-mirror/topologyFns.ts#rotateBrep', selfhost: true, kind: 'brep-op', capabilities: ['transform'],
         geometryArgs: [0], returnsResult: false,
         args: 'rotate(shape: Shape, angle: number, options?: { at?, axis? }): Shape',
         reason: 'faijs rotate 已更名 rotate_euler（faijs 面只导出 rotate_euler），上游轴角 rotate 空出 → brep-op 进脚本面'
@@ -2860,7 +2864,7 @@ export const ARG_SPEC = [
         reason: 'overridden by handwritten api/transform.ts (scale dual-op, mesh+brep)',
     },
     {
-        name: 'mirror', source: 'brep-mirror/topologyFns.ts#mirrorBrep', selfhost: true, kind: 'brep-op', engines: ['occt'],
+        name: 'mirror', source: 'brep-mirror/topologyFns.ts#mirrorBrep', selfhost: true, kind: 'brep-op', capabilities: ['mirror'],
         geometryArgs: [0], returnsResult: false,
         args: 'mirror(shape: Shape, options?: MirrorOptions): Shape',
         reason: 'faijs 无同名 mirror，整件反射 → brep-op',
@@ -2869,16 +2873,16 @@ export const ARG_SPEC = [
         naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
     },
     {
-        name: 'clone', source: 'brep-mirror/topologyFns.ts#cloneBrep', selfhost: true, kind: 'brep-op', engines: ['occt'],
+        name: 'clone', source: 'brep-mirror/topologyFns.ts#cloneBrep', selfhost: true, kind: 'brep-op', capabilities: ['copyShape'],
         geometryArgs: [0], returnsResult: true,
         args: 'clone(shape: Shape): Shape',
-        reason: 'faijs 用 copy（不同名），整件克隆（Result<T>）→ brep-op',
+        reason: 'faijs 用 copy（不同名），整件克隆（Result<T>）→ brep-op；纯 copyShape 调用、无 occt 特有 API（2026-09-26 从 engines:[occt] 白名单降级为 copyShape 能力路由，brepkit 已声明 copyShape）',
         params: ['shape'], formClass: 'A',
         scriptFace: true,
         naming: { kind: 'identity' },
     },
     {
-        name: 'applyMatrix', source: 'brep-mirror/topologyFns.ts#applyMatrixBrep', selfhost: true, kind: 'brep-op', engines: ['occt'],
+        name: 'applyMatrix', source: 'brep-mirror/topologyFns.ts#applyMatrixBrep', selfhost: true, kind: 'brep-op', capabilities: ['transform', 'generalTransform'],
         geometryArgs: [0], returnsResult: true,
         args: 'applyMatrix(shape: Shape, matrix: unknown): Shape',
         reason: 'faijs 用 applyTransform（不同名），整件矩阵变换 → brep-op',
@@ -2932,7 +2936,8 @@ export const ARG_SPEC = [
             + '（含 UI ops 与存量迁移）——生成期守卫见 gen-l3-surface.ts（§4.8 触发条件）。',
     },
     {
-        name: 'section', source: 'brep-mirror/booleanFns.ts#sectionBrep', selfhost: true, kind: 'brep-op', engines: ['occt'],
+        name: 'section', source: 'brep-mirror/booleanFns.ts#sectionBrep', selfhost: true, kind: 'brep-op',
+        capabilities: ["sectionByPlane", "makeCompound"],
         geometryArgs: [0], returnsResult: true,
         args: 'section(shape: Shape, plane: PlaneInput): Shape',
         params: ['shape', 'plane'], formClass: 'A',
@@ -2983,7 +2988,7 @@ export const ARG_SPEC = [
     },
     {
         name: 'thicken', source: 'topology/api.js#thicken', kind: 'skip',
-        reason: 'overridden by handwritten api/thicken.ts (平台 op engines:[occt]：入参取面/壳整件 Shape——cad.sketch 产物即天然面来源；内部借入喂 vendored thicken，不再要求子形状句柄)',
+        reason: 'overridden by handwritten api/thicken.ts (平台 op engines:[occt]：入参取面/壳整件 Shape——cad.profile 产物即天然面来源；内部借入喂 vendored thicken，不再要求子形状句柄)',
     },
     {
         name: 'draft', source: 'topology/api.js#draft', kind: 'skip',
@@ -3325,7 +3330,7 @@ export const ARG_SPEC = [
         naming: { kind: 'kernel', newFaces: { via: 'byAdjacency' } },
     },
     {
-        name: 'healSolid', source: 'brep-mirror/healingFns.ts#healSolidBrep', selfhost: true, kind: 'brep-op', engines: ['occt'],
+        name: 'healSolid', source: 'brep-mirror/healingFns.ts#healSolidBrep', selfhost: true, kind: 'brep-op', capabilities: ['healSolid'],
         geometryArgs: [0], returnsResult: true,
         args: 'healSolid(solid: Shape): Shape',
         reason: 'Solid 修复（Result<ValidSolid>），brep-op',