@faicad/faijs 0.14.1 → 0.16.1

package/dist/brep/engine/adapters/occt.js

@@ -11,10 +11,15 @@
  * 接触 occt-wasm 类型。
  */
 import { registerBrepEngine, hasBrepEngine, isBrepEngineRegistered } from '../registry.js';
+import { OcctWasmAdapter } from '../../../vendored/brepjs/kernel/occtWasm/occtWasmAdapter.js';
 import { initOcctWasm } from '../../../occt-kernel/occtKernel.js';
-import { bindOcctKernel } from '../../../api/occt-kernel-bridge.js';
+import { injectCurrentBrepEngineAsKernel } from '../../../api/occt-kernel-bridge.js';
 /** OCCT 引擎注册 id（默认 BREP 引擎；首个注册自动成为默认）。 */
 export const OCCT_BREP_ENGINE_ID = 'occt';
+// Phase 2 幂等护栏：occt-wasm 是进程级单例，registerOcctBrepEngine 可能被多次调用
+// （测试重置注册表后重注册）。pattern 三方法只覆写一次——重复覆写会捕获到上一轮
+// 覆写版（返回 BrepHandle[]），把它当 compound 拆 → getSubShapes: Invalid shape ID: 0。
+let occtPatternWired = false;
 /**
  * OCCT 实际提供的 `*WithHistory` 核函数名（Phase 0.2：逐核函数如实声明）。
  *
@@ -23,37 +28,245 @@ export const OCCT_BREP_ENGINE_ID = 'occt';
  * 冒烟测试（`brep/engine/evolution-bindings.test.ts`——因 `initOcctWasm` 的返回类型
  * 被 `as unknown as` 硬断言，编译期守卫是空转的，只有运行时测试能证明它们真在）。
  */
-const OCCT_EVOLUTION_KINDS = [
+/**
+ * 非演化内核方法全集（BrepMethodKind）——occt-wasm 是参考内核，vendored
+ * occtWasmAdapter 提供全部方法（occt-kernel/initOcctWasm 包装同一实例），
+ * 逐核如实声明（Phase 1，P2 缺口补齐）。
+ *
+ * ⚠️ Phase 2 修正（能力声明=可执行语义）：
+ *   - 保留 `gridPattern`：occt-wasm 无原生 gridPattern，但 vendored gridPattern
+ *     有回退路径（嵌套 linearPattern，patternFns.ts）且本适配器新增组合实现
+ *     ——occt 下 gridPattern op 可执行，声明成立；
+ *   - 移除 `rectangularPattern`：occt-wasm 无此内核方法，vendored rectangularPattern
+ *     是纯 JS 组合（compoundOpsFns.ts translate+fuseAll，不调内核）——无 op 依赖
+ *     该能力名，声明即虚假（capability-map 实证 36 op 无一依赖）。
+ */
+const OCCT_METHOD_KINDS = [
+    'linearPattern',
+    'circularPattern',
+    'gridPattern',
+    'mirror',
+    'rotate',
+    'translate',
+    'scale',
+    'makeRectangle',
+    'shell',
+    'extrude',
+    'loft',
+    'loftAdvanced',
+    'section',
+    'sweepPipeShell',
+    'simplePipe',
+    'revolveVec',
+    'buildExtrusionLaw',
     'fuse',
     'cut',
     'intersect',
-    'fillet',
+    'fuseAll',
+    'makeArcEdge',
+    'makeBezierEdge',
+    'makeCylinder',
+    'makeEllipsoid',
+    'makeFace',
+    'makeFaceOnSurface',
+    'makeLineEdge',
+    'makeTorus',
+    'makeVertex',
+    'makeWireFromMixed',
+    'buildEdgeOnSurface',
+    'addHolesInFace',
+    'buildTriFace',
+    'sew',
+    'sewAndSolidify',
+    'healFace',
+    'healSolid',
+    'healWire',
+    'fixShape',
+    'fixSelfIntersection',
+    'isValid',
+    'removeDegenerateEdges',
+    'simplify',
+    'split',
+    'boundingBox',
+    'curveParameters',
+    'curvePointAtParam',
+    'curveTangent',
+    'hullFromPoints',
+    'isNull',
+    'iterShapes',
+    'locate',
+    'shapeType',
+    'surfaceCenterOfMass',
+    'surfaceNormal',
+    'surfaceType',
+    'uvBounds',
+    'composeTransform',
+    'applyComposedTransformWithHistory',
+    'generalTransformNonOrthogonal',
+    'generalTransformWithHistory',
+    'importStl',
+    'createXCAFDocument',
+    'importXCAFFromSTEP',
+    'copyShape',
+    'dispose',
+    'downcast',
+    'hashCode',
+    // Phase 2：chamfer/fillet 基础方法（directEdit 族逐核真名；occt-wasm 原生提供，
+    // brepkit 无——chamfer op 静态判定执行前报错）
     'chamfer',
-    'translate',
-    'rotate',
-    'mirror',
-    'scale',
-    'shell',
-    'offset',
-    'thicken',
+    'chamferDistAngle',
+    'fillet',
+    'filletVariable',
+];
+const OCCT_EVOLUTION_KINDS = [
+    'fuseWithHistory',
+    'cutWithHistory',
+    'intersectWithHistory',
+    'filletWithHistory',
+    'chamferWithHistory',
+    'translateWithHistory',
+    'rotateWithHistory',
+    'mirrorWithHistory',
+    'scaleWithHistory',
+    'shellWithHistory',
+    'offsetWithHistory',
+    'thickenWithHistory',
 ];
 /**
- * 装配 OCCT BREP 引擎（宿主启动时调用一次，幂等）。
- *
- * 预初始化 initOcctWasm()：wasm 加载完成后立即注册——保证注册返回后
- * getKernel() 立即可用（occt-kernel 单例已就绪），provider 直接返回预初始化实例。
- * 幂等：已注册（含运行时默认装配或宿主先行注册）则跳过注册，仅确保 wasm 预初始化。
+ * 装配 OCCT BREP 引擎（幂等；pattern 三方法仅首次覆写，见上方长注释）。
  */
 export async function registerOcctBrepEngine() {
     const primitives = await initOcctWasm();
     if (isBrepEngineRegistered(OCCT_BREP_ENGINE_ID))
         return;
+    // Phase 2：occt-wasm 原生 linearPattern/circularPattern 返回 compound（含全部副本），
+    // BrepEngineApi 契约要求 BrepHandle[]（各份副本）→ 在此拆 compound（getSubShapes）。
+    // gridPattern 无原生内核函数 → 组合实现（嵌套 linearPattern + fuseAll，与 vendored
+    // 回退路径同构）；拆出的子句柄由调用方 release，compound 容器拆完即释放。
+    // ⚠️ initOcctWasm 的返回类型在 occtKernel.ts 被硬断言为 BrepEngineApi（linearPattern
+    // 签名 BrepHandle[]），但运行时 occt-wasm 的 linearPattern/circularPattern 返回**单个
+    // compound 句柄**（含全部副本）——类型撒谎。此处以运行时原始形态（OcctPatternRaw）
+    // 调用，再经 getSubShapes 拆成数组（与 vendored transformOps.linearPattern 同构）。
+    // 不能使用对象展开（{ ...primitives }）：OcctKernel 的方法在原型上（class 实例），
+    // 展开只拷自有属性 → makeBoxFromCorners 等全部原型方法丢失（consume-input.test 实证）。
+    // 直接覆盖单例实例的 pattern 三方法（occt-wasm 单例，无共享状态风险）。
+    // ⚠️ 覆盖前必须先捕获原生 linearPattern/circularPattern：覆盖后 raw.linearPattern
+    // 会指向 occtApi.linearPattern 自身 → 无限递归（Maximum call stack size exceeded 实证）。
+    const raw = primitives;
+    // ⚠️ 幂等护栏：occt-wasm 是进程级单例，宿主可能多次调用本注册（测试重置注册表后
+    // 重注册）。重复覆写会捕获到上一轮覆写版（返回 BrepHandle[]），把它当 compound 拆
+    // → `getSubShapes: Invalid shape ID: 0`（engine-switch-p2 parity 实证）。只覆写一次，
+    // raw 与 occtApi 指向同一单例，后续注册直接复用覆写结果。
+    if (!occtPatternWired) {
+        // ⚠️ 覆盖前必须先捕获原生 linearPattern/circularPattern：覆盖后 raw.linearPattern
+        // 会指向 occtApi.linearPattern 自身 → 无限递归（Maximum call stack size exceeded 实证）。
+        const nativeLinearPattern = raw.linearPattern.bind(raw);
+        const nativeCircularPattern = raw.circularPattern.bind(raw);
+        const occtApi = primitives;
+        occtApi.linearPattern = (shape, direction, spacing, count) => {
+            const compound = nativeLinearPattern(shape, direction, spacing, count);
+            const parts = raw.getSubShapes(compound, 'solid');
+            raw.release(compound);
+            return parts.map((h) => h);
+        };
+        occtApi.circularPattern = (shape, center, axis, angleStep, count) => {
+            const compound = nativeCircularPattern(shape, center, axis, angleStep, count);
+            const parts = raw.getSubShapes(compound, 'solid');
+            raw.release(compound);
+            return parts.map((h) => h);
+        };
+        occtApi.gridPattern = (shape, directionX, directionY, spacingX, spacingY, countX, countY) => {
+            // ⚠️ 内部必须用捕获的 nativeLinearPattern：此时 raw.linearPattern 已被覆写为
+            // BrepHandle[] 语义，误用会把数组当 compound 拆（同上红线实证）。
+            const colCompound = nativeLinearPattern(shape, directionX, spacingX, countX);
+            const cols = raw.getSubShapes(colCompound, 'solid');
+            raw.release(colCompound);
+            const all = [];
+            try {
+                for (const c of cols) {
+                    const rowCompound = nativeLinearPattern(c, directionY, spacingY, countY);
+                    try {
+                        all.push(...raw.getSubShapes(rowCompound, 'solid'));
+                    }
+                    finally {
+                        raw.release(rowCompound);
+                    }
+                }
+            }
+            finally {
+                for (const c of cols)
+                    raw.release(c);
+            }
+            return raw.fuseAll(all);
+        };
+        // ═══ Phase 3：能力表 33 个登记方法接线（capability-map 64 方法收口） ═══
+        // 原则：能力表声明了（OCCT_METHOD_KINDS 含全部 33）→ 实例必须可实现，否则静态
+        // 判定放行后运行时崩（红线）。18 个 occt-wasm 原生导出直接绑定（签名与
+        // BrepEngineApi 一致：Vec3=BrepVec3、ShapeHandle=BrepHandle）；15 个组合方法
+        // （occt-wasm 无原生导出）经 vendored OcctWasmAdapter 组合面代理 + 形态转换。
+        // 只接线一次（occtPatternWired 护栏内）；重复注册复用覆写结果，不重复捕获。
+        const k = primitives;
+        occtApi.buildExtrusionLaw = k.buildExtrusionLaw.bind(primitives);
+        occtApi.composeTransform = k.composeTransform.bind(primitives);
+        occtApi.downcast = k.downcast.bind(primitives);
+        occtApi.healFace = k.healFace.bind(primitives);
+        occtApi.healWire = k.healWire.bind(primitives);
+        occtApi.isNull = k.isNull.bind(primitives);
+        occtApi.iterShapes = k.iterShapes.bind(primitives);
+        occtApi.makeEllipsoid = k.makeEllipsoid.bind(primitives);
+        occtApi.makeFaceOnSurface = k.makeFaceOnSurface.bind(primitives);
+        occtApi.makeTorus = k.makeTorus.bind(primitives);
+        occtApi.makeVertex = k.makeVertex.bind(primitives);
+        occtApi.mirror = k.mirror.bind(primitives);
+        occtApi.sew = k.sew.bind(primitives);
+        occtApi.shell = k.shell.bind(primitives);
+        occtApi.simplePipe = k.simplePipe.bind(primitives);
+        occtApi.simplify = k.simplify.bind(primitives);
+        occtApi.split = k.split.bind(primitives);
+        occtApi.sweepPipeShell = k.sweepPipeShell.bind(primitives);
+        const vendor = OcctWasmAdapter.fromKernel(primitives);
+        occtApi.boundingBox = (shape) => {
+            const b = vendor.boundingBox(shape);
+            return { xmin: b.min[0], ymin: b.min[1], zmin: b.min[2], xmax: b.max[0], ymax: b.max[1], zmax: b.max[2] };
+        };
+        occtApi.shapeType = (shape) => vendor.shapeType(shape);
+        occtApi.surfaceCenterOfMass = (face) => {
+            const v = vendor.surfaceCenterOfMass(face);
+            return { x: v[0], y: v[1], z: v[2] };
+        };
+        occtApi.locate = (shape, matrix) => vendor.locate(shape, matrix);
+        occtApi.copyShape = (shape) => vendor.copyShape(shape);
+        occtApi.fixSelfIntersection = (wire) => vendor.fixSelfIntersection(wire);
+        occtApi.hullFromPoints = (points, tolerance) => vendor.hullFromPoints(points, tolerance);
+        occtApi.loftAdvanced = (wires, options) => vendor.loftAdvanced(wires, options);
+        occtApi.makeWireFromMixed = (items) => vendor.makeWireFromMixed(items);
+        occtApi.revolveVec = (shape, center, direction, angleDeg) => vendor.revolveVec(shape, [center.x, center.y, center.z], [direction.x, direction.y, direction.z], angleDeg);
+        occtApi.buildEdgeOnSurface = (curve, surface) => vendor.buildEdgeOnSurface(curve, surface);
+        occtApi.dispose = (shape) => { if (shape !== undefined)
+            raw.release(shape); };
+        occtApi.generalTransformNonOrthogonal = (shape, matrix) => vendor.generalTransformNonOrthogonal(shape, matrix.slice(0, 9), matrix.slice(9, 12));
+        const toEvolution = (op) => {
+            const segments = (m) => {
+                const out = [];
+                for (const [inHash, outHashes] of m)
+                    out.push(inHash, outHashes.length, ...outHashes);
+                return out;
+            };
+            return { result: op.shape, modified: segments(op.evolution.modified), generated: segments(op.evolution.generated), deleted: [...op.evolution.deleted] };
+        };
+        occtApi.generalTransformWithHistory = (shape, matrix, inputFaceHashes, hashUpperBound) => toEvolution(vendor.generalTransformWithHistory(shape, matrix.slice(0, 9), matrix.slice(9, 12), false, inputFaceHashes, hashUpperBound));
+        occtApi.applyComposedTransformWithHistory = (shape, matrix, inputFaceHashes, hashUpperBound) => toEvolution(vendor.applyComposedTransformWithHistory(shape, matrix, inputFaceHashes, hashUpperBound));
+        occtPatternWired = true;
+    }
+    const occtApi = primitives;
     registerBrepEngine(OCCT_BREP_ENGINE_ID, async () => ({
         id: OCCT_BREP_ENGINE_ID,
-        primitives,
+        primitives: occtApi,
         capabilities: {
             // 面演化：逐核函数名单（不是族级布尔——见 BrepEvolutionKind）。
             evolution: OCCT_EVOLUTION_KINDS,
+            // 非演化内核方法：逐核如实声明（Phase 1，P2 缺口补齐；op 声明按此静态判定）。
+            methods: OCCT_METHOD_KINDS,
             heal: true,
             directEdit: true,
             advSurface: true,
@@ -65,9 +278,10 @@ export async function registerOcctBrepEngine() {
             tessellationModel: 'extract-time',
         },
     }));
-    // P7-②：同一装配点把移植内核注册表绑定到同一个 occt-wasm 实例（D10 单实例 + 冻结）。
+    // P7-②：同一装配点把移植内核注册表注入到当前 BREP 引擎（Phase 2 P2-5：取代旧的
+    // bindOcctKernel() 固定绑定，改为引擎中立的 injectCurrentBrepEngineAsKernel）。
     // 使 L3 调移植 L2 的 op 在宿主装配后立即可用；幂等，重复调用安全。
-    bindOcctKernel();
+    await injectCurrentBrepEngineAsKernel();
 }
 /**
  * 内置默认 BREP 引擎装配（OCCT）：宿主未注册任何引擎时的缺省值。

package/dist/brep/engine/adapters/occt.js.map

@@ -1 +1 @@
-{"version":3,"file":"occt.js","sourceRoot":"","sources":["../../../../src/brep/engine/adapters/occt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,sBAAsB,EAAmB,MAAM,aAAa,CAAA;AAGxG,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAA;AAEhE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAEzC;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG;IAC3B,MAAM;IACN,KAAK;IACL,WAAW;IACX,QAAQ;IACR,SAAS;IACT,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;IACP,QAAQ;IACR,SAAS;CACsC,CAAA;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,UAAU,GAAG,MAAM,YAAY,EAAE,CAAA;IACvC,IAAI,sBAAsB,CAAC,mBAAmB,CAAC;QAAE,OAAM;IACvD,kBAAkB,CAAC,mBAAmB,EAAE,KAAK,IAAyB,EAAE,CAAC,CAAC;QACxE,EAAE,EAAE,mBAAmB;QACvB,UAAU;QACV,YAAY,EAAE;YACZ,2CAA2C;YAC3C,SAAS,EAAE,oBAAoB;YAC/B,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,kEAAkE;YAClE,KAAK,EAAE,IAAI;YACX,UAAU,EAAE,IAAI;YAChB,gBAAgB,EAAE,IAAI;YACtB,iBAAiB,EAAE,cAAc;SAClC;KACF,CAAC,CAAC,CAAA;IACH,uDAAuD;IACvD,yCAAyC;IACzC,cAAc,EAAE,CAAA;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,IAAI,aAAa,EAAE;QAAE,OAAM;IAC3B,MAAM,sBAAsB,EAAE,CAAA;AAChC,CAAC","sourcesContent":["/**\n * engine/adapters/occt — OCCT BREP 引擎适配器（槽位 1 的默认实现）\n *\n *\n * 本文件是「occt 引擎实现」的注册入口：把 occt-kernel 的 initOcctWasm 包装为\n * BrepEngine 注册进注册表。业务层（runtime/brep ops/stdlib）只经注册表取引擎，\n * 不直接 import occt 初始化函数——引擎本体可整体替换（换一个适配器即换引擎）。\n *\n * OCCT 类型耦合（import 'occt-wasm'）只存在于 occt-kernel/occtKernel.ts（A1 验收\n * 允许的唯一耦合区）；本文件经 initOcctWasm 函数边界获得 BrepEngineApi，不直接\n * 接触 occt-wasm 类型。\n */\n\nimport { registerBrepEngine, hasBrepEngine, isBrepEngineRegistered, type BrepEngine } from '../registry'\nimport type { AssertSatisfiesBrepEngineApi } from '../primitives'\nimport type { BrepEvolutionKind } from '../types'\nimport { initOcctWasm } from '../../../occt-kernel/occtKernel'\nimport { bindOcctKernel } from '../../../api/occt-kernel-bridge'\n\n/** OCCT 引擎注册 id（默认 BREP 引擎；首个注册自动成为默认）。 */\nexport const OCCT_BREP_ENGINE_ID = 'occt'\n\n/**\n * OCCT 实际提供的 `*WithHistory` 核函数名（Phase 0.2：逐核函数如实声明）。\n *\n * 12 个全部由 `occt-wasm@3.8.4` 提供（`dist/index.d.ts` 的 `*WithHistory` 声明），\n * 且 faijs 侧已全部绑定（`brep/engine/primitives.ts` 的 `BrepEngineApi`）并有运行时\n * 冒烟测试（`brep/engine/evolution-bindings.test.ts`——因 `initOcctWasm` 的返回类型\n * 被 `as unknown as` 硬断言，编译期守卫是空转的，只有运行时测试能证明它们真在）。\n */\nconst OCCT_EVOLUTION_KINDS = [\n  'fuse',\n  'cut',\n  'intersect',\n  'fillet',\n  'chamfer',\n  'translate',\n  'rotate',\n  'mirror',\n  'scale',\n  'shell',\n  'offset',\n  'thicken',\n] as const satisfies readonly BrepEvolutionKind[]\n\n/**\n * 装配 OCCT BREP 引擎（宿主启动时调用一次，幂等）。\n *\n * 预初始化 initOcctWasm()：wasm 加载完成后立即注册——保证注册返回后\n * getKernel() 立即可用（occt-kernel 单例已就绪），provider 直接返回预初始化实例。\n * 幂等：已注册（含运行时默认装配或宿主先行注册）则跳过注册，仅确保 wasm 预初始化。\n */\nexport async function registerOcctBrepEngine(): Promise<void> {\n  const primitives = await initOcctWasm()\n  if (isBrepEngineRegistered(OCCT_BREP_ENGINE_ID)) return\n  registerBrepEngine(OCCT_BREP_ENGINE_ID, async (): Promise<BrepEngine> => ({\n    id: OCCT_BREP_ENGINE_ID,\n    primitives,\n    capabilities: {\n      // 面演化：逐核函数名单（不是族级布尔——见 BrepEvolutionKind）。\n      evolution: OCCT_EVOLUTION_KINDS,\n      heal: true,\n      directEdit: true,\n      advSurface: true,\n      assembly: true,\n      // P7 并入（D4）：OCCT 是精确 B-rep 内核——如实声明 brepjs KernelCapabilities 字段。\n      exact: true,\n      brepExport: true,\n      exactMeasurement: true,\n      tessellationModel: 'extract-time',\n    },\n  }))\n  // P7-②：同一装配点把移植内核注册表绑定到同一个 occt-wasm 实例（D10 单实例 + 冻结）。\n  // 使 L3 调移植 L2 的 op 在宿主装配后立即可用；幂等，重复调用安全。\n  bindOcctKernel()\n}\n\n/**\n * 内置默认 BREP 引擎装配（OCCT）：宿主未注册任何引擎时的缺省值。\n *\n * OCCT 是 faijs 的默认 BREP 引擎——低频率、静态的替换：换引擎 = 宿主在\n * 装配期显式注册其它引擎（首个注册者为默认），或改本处默认。宿主无需为\n * 每次使用自行提供引擎；本函数幂等，已注册任何引擎则 no-op。\n */\nexport async function ensureOcctDefaultEngine(): Promise<void> {\n  if (hasBrepEngine()) return\n  await registerOcctBrepEngine()\n}\n\n// §7.8 编译期守卫：initOcctWasm 的返回类型必须满足 BrepEngineApi。\n// 若未来 occt-kernel 的导出类型不再满足接口（如接口新增方法）→ tsc 报错列出缺失。\ntype _AssertOcctApi = AssertSatisfiesBrepEngineApi<Awaited<ReturnType<typeof initOcctWasm>>>\n"]}
+{"version":3,"file":"occt.js","sourceRoot":"","sources":["../../../../src/brep/engine/adapters/occt.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * engine/adapters/occt — OCCT BREP 引擎适配器（槽位 1 的默认实现）\n *\n *\n * 本文件是「occt 引擎实现」的注册入口：把 occt-kernel 的 initOcctWasm 包装为\n * BrepEngine 注册进注册表。业务层（runtime/brep ops/stdlib）只经注册表取引擎，\n * 不直接 import occt 初始化函数——引擎本体可整体替换（换一个适配器即换引擎）。\n *\n * OCCT 类型耦合（import 'occt-wasm'）只存在于 occt-kernel/occtKernel.ts（A1 验收\n * 允许的唯一耦合区）；本文件经 initOcctWasm 函数边界获得 BrepEngineApi，不直接\n * 接触 occt-wasm 类型。\n */\n\nimport { registerBrepEngine, hasBrepEngine, isBrepEngineRegistered, type BrepEngine } from '../registry'\nimport type { AssertSatisfiesBrepEngineApi, BrepEngineApi } from '../primitives'\nimport type { BrepEvolutionKind, BrepMethodKind } from '../types'\nimport type { BrepEvolutionData, BrepHandle, BrepSubShapeType, BrepVec3 } from '../types'\nimport { OcctWasmAdapter } from '../../../vendored/brepjs/kernel/occtWasm/occtWasmAdapter'\nimport { initOcctWasm } from '../../../occt-kernel/occtKernel'\nimport { injectCurrentBrepEngineAsKernel } from '../../../api/occt-kernel-bridge'\n\n/** OCCT 引擎注册 id（默认 BREP 引擎；首个注册自动成为默认）。 */\nexport const OCCT_BREP_ENGINE_ID = 'occt'\n\n// Phase 2 幂等护栏：occt-wasm 是进程级单例，registerOcctBrepEngine 可能被多次调用\n// （测试重置注册表后重注册）。pattern 三方法只覆写一次——重复覆写会捕获到上一轮\n// 覆写版（返回 BrepHandle[]），把它当 compound 拆 → getSubShapes: Invalid shape ID: 0。\nlet occtPatternWired = false\n\n/**\n * OCCT 实际提供的 `*WithHistory` 核函数名（Phase 0.2：逐核函数如实声明）。\n *\n * 12 个全部由 `occt-wasm@3.8.4` 提供（`dist/index.d.ts` 的 `*WithHistory` 声明），\n * 且 faijs 侧已全部绑定（`brep/engine/primitives.ts` 的 `BrepEngineApi`）并有运行时\n * 冒烟测试（`brep/engine/evolution-bindings.test.ts`——因 `initOcctWasm` 的返回类型\n * 被 `as unknown as` 硬断言，编译期守卫是空转的，只有运行时测试能证明它们真在）。\n */\n/**\n * 非演化内核方法全集（BrepMethodKind）——occt-wasm 是参考内核，vendored\n * occtWasmAdapter 提供全部方法（occt-kernel/initOcctWasm 包装同一实例），\n * 逐核如实声明（Phase 1，P2 缺口补齐）。\n *\n * ⚠️ Phase 2 修正（能力声明=可执行语义）：\n *   - 保留 `gridPattern`：occt-wasm 无原生 gridPattern，但 vendored gridPattern\n *     有回退路径（嵌套 linearPattern，patternFns.ts）且本适配器新增组合实现\n *     ——occt 下 gridPattern op 可执行，声明成立；\n *   - 移除 `rectangularPattern`：occt-wasm 无此内核方法，vendored rectangularPattern\n *     是纯 JS 组合（compoundOpsFns.ts translate+fuseAll，不调内核）——无 op 依赖\n *     该能力名，声明即虚假（capability-map 实证 36 op 无一依赖）。\n */\nconst OCCT_METHOD_KINDS = [\n  'linearPattern',\n  'circularPattern',\n  'gridPattern',\n  'mirror',\n  'rotate',\n  'translate',\n  'scale',\n  'makeRectangle',\n  'shell',\n  'extrude',\n  'loft',\n  'loftAdvanced',\n  'section',\n  'sweepPipeShell',\n  'simplePipe',\n  'revolveVec',\n  'buildExtrusionLaw',\n  'fuse',\n  'cut',\n  'intersect',\n  'fuseAll',\n  'makeArcEdge',\n  'makeBezierEdge',\n  'makeCylinder',\n  'makeEllipsoid',\n  'makeFace',\n  'makeFaceOnSurface',\n  'makeLineEdge',\n  'makeTorus',\n  'makeVertex',\n  'makeWireFromMixed',\n  'buildEdgeOnSurface',\n  'addHolesInFace',\n  'buildTriFace',\n  'sew',\n  'sewAndSolidify',\n  'healFace',\n  'healSolid',\n  'healWire',\n  'fixShape',\n  'fixSelfIntersection',\n  'isValid',\n  'removeDegenerateEdges',\n  'simplify',\n  'split',\n  'boundingBox',\n  'curveParameters',\n  'curvePointAtParam',\n  'curveTangent',\n  'hullFromPoints',\n  'isNull',\n  'iterShapes',\n  'locate',\n  'shapeType',\n  'surfaceCenterOfMass',\n  'surfaceNormal',\n  'surfaceType',\n  'uvBounds',\n  'composeTransform',\n  'applyComposedTransformWithHistory',\n  'generalTransformNonOrthogonal',\n  'generalTransformWithHistory',\n  'importStl',\n  'createXCAFDocument',\n  'importXCAFFromSTEP',\n  'copyShape',\n  'dispose',\n  'downcast',\n  'hashCode',\n  // Phase 2：chamfer/fillet 基础方法（directEdit 族逐核真名；occt-wasm 原生提供，\n  // brepkit 无——chamfer op 静态判定执行前报错）\n  'chamfer',\n  'chamferDistAngle',\n  'fillet',\n  'filletVariable',\n] as const satisfies readonly BrepMethodKind[]\n\nconst OCCT_EVOLUTION_KINDS = [\n  'fuseWithHistory',\n  'cutWithHistory',\n  'intersectWithHistory',\n  'filletWithHistory',\n  'chamferWithHistory',\n  'translateWithHistory',\n  'rotateWithHistory',\n  'mirrorWithHistory',\n  'scaleWithHistory',\n  'shellWithHistory',\n  'offsetWithHistory',\n  'thickenWithHistory',\n] as const satisfies readonly BrepEvolutionKind[]\n\n/**\n * 装配 OCCT BREP 引擎（宿主启动时调用一次，幂等）。\n *\n * 预初始化 initOcctWasm()：wasm 加载完成后立即注册——保证注册返回后\n * getKernel() 立即可用（occt-kernel 单例已就绪），provider 直接返回预初始化实例。\n * 幂等：已注册（含运行时默认装配或宿主先行注册）则跳过注册，仅确保 wasm 预初始化。\n */\n/** occt-wasm 运行时原始 pattern 形态（initOcctWasm 返回类型被硬断言，此处如实还原）。 */\ninterface OcctPatternRaw {\n  // occt-wasm 原生签名（dist/index.d.ts:230-231 实证）：方向/中心/轴是 **Vec3 对象**\n  // （{x,y,z}），4/5 参数形态。⚠️ vendored transformOps.ts 的分量式调用（6/9 参数）\n  // 是 brepjs 内部 OcctKernelWasm 的假定面，对真实 occt-wasm 不成立（运行实证崩），\n  // Phase 3 全量收敛时单独处置。\n  linearPattern(shape: number, direction: { x: number; y: number; z: number }, spacing: number, count: number): number\n  circularPattern(shape: number, center: { x: number; y: number; z: number }, axis: { x: number; y: number; z: number }, angleStep: number, count: number): number\n  getSubShapes(shape: number, type: 'solid'): number[]\n  release(shape: number): void\n  fuseAll(shapes: number[]): number\n}\n\n/**\n * 装配 OCCT BREP 引擎（幂等；pattern 三方法仅首次覆写，见上方长注释）。\n */\nexport async function registerOcctBrepEngine(): Promise<void> {\n  const primitives = await initOcctWasm()\n  if (isBrepEngineRegistered(OCCT_BREP_ENGINE_ID)) return\n  // Phase 2：occt-wasm 原生 linearPattern/circularPattern 返回 compound（含全部副本），\n  // BrepEngineApi 契约要求 BrepHandle[]（各份副本）→ 在此拆 compound（getSubShapes）。\n  // gridPattern 无原生内核函数 → 组合实现（嵌套 linearPattern + fuseAll，与 vendored\n  // 回退路径同构）；拆出的子句柄由调用方 release，compound 容器拆完即释放。\n  // ⚠️ initOcctWasm 的返回类型在 occtKernel.ts 被硬断言为 BrepEngineApi（linearPattern\n  // 签名 BrepHandle[]），但运行时 occt-wasm 的 linearPattern/circularPattern 返回**单个\n  // compound 句柄**（含全部副本）——类型撒谎。此处以运行时原始形态（OcctPatternRaw）\n  // 调用，再经 getSubShapes 拆成数组（与 vendored transformOps.linearPattern 同构）。\n  // 不能使用对象展开（{ ...primitives }）：OcctKernel 的方法在原型上（class 实例），\n  // 展开只拷自有属性 → makeBoxFromCorners 等全部原型方法丢失（consume-input.test 实证）。\n  // 直接覆盖单例实例的 pattern 三方法（occt-wasm 单例，无共享状态风险）。\n  // ⚠️ 覆盖前必须先捕获原生 linearPattern/circularPattern：覆盖后 raw.linearPattern\n  // 会指向 occtApi.linearPattern 自身 → 无限递归（Maximum call stack size exceeded 实证）。\n  const raw = primitives as unknown as OcctPatternRaw\n  // ⚠️ 幂等护栏：occt-wasm 是进程级单例，宿主可能多次调用本注册（测试重置注册表后\n  // 重注册）。重复覆写会捕获到上一轮覆写版（返回 BrepHandle[]），把它当 compound 拆\n  // → `getSubShapes: Invalid shape ID: 0`（engine-switch-p2 parity 实证）。只覆写一次，\n  // raw 与 occtApi 指向同一单例，后续注册直接复用覆写结果。\n  if (!occtPatternWired) {\n    // ⚠️ 覆盖前必须先捕获原生 linearPattern/circularPattern：覆盖后 raw.linearPattern\n    // 会指向 occtApi.linearPattern 自身 → 无限递归（Maximum call stack size exceeded 实证）。\n    const nativeLinearPattern = raw.linearPattern.bind(raw)\n    const nativeCircularPattern = raw.circularPattern.bind(raw)\n    const occtApi = primitives as BrepEngineApi\n    occtApi.linearPattern = (shape, direction, spacing, count) => {\n      const compound = nativeLinearPattern(shape, direction, spacing, count)\n      const parts = raw.getSubShapes(compound, 'solid')\n      raw.release(compound)\n      return parts.map((h) => h as BrepHandle)\n    }\n    occtApi.circularPattern = (shape, center, axis, angleStep, count) => {\n      const compound = nativeCircularPattern(shape, center, axis, angleStep, count)\n      const parts = raw.getSubShapes(compound, 'solid')\n      raw.release(compound)\n      return parts.map((h) => h as BrepHandle)\n    }\n    occtApi.gridPattern = (shape, directionX, directionY, spacingX, spacingY, countX, countY) => {\n      // ⚠️ 内部必须用捕获的 nativeLinearPattern：此时 raw.linearPattern 已被覆写为\n      // BrepHandle[] 语义，误用会把数组当 compound 拆（同上红线实证）。\n      const colCompound = nativeLinearPattern(shape, directionX, spacingX, countX)\n      const cols = raw.getSubShapes(colCompound, 'solid')\n      raw.release(colCompound)\n      const all: number[] = []\n      try {\n        for (const c of cols) {\n          const rowCompound = nativeLinearPattern(c, directionY, spacingY, countY)\n          try {\n            all.push(...raw.getSubShapes(rowCompound, 'solid'))\n          } finally {\n            raw.release(rowCompound)\n          }\n        }\n      } finally {\n        for (const c of cols) raw.release(c)\n      }\n      return raw.fuseAll(all) as BrepHandle\n    }\n\n    // ═══ Phase 3：能力表 33 个登记方法接线（capability-map 64 方法收口） ═══\n    // 原则：能力表声明了（OCCT_METHOD_KINDS 含全部 33）→ 实例必须可实现，否则静态\n    // 判定放行后运行时崩（红线）。18 个 occt-wasm 原生导出直接绑定（签名与\n    // BrepEngineApi 一致：Vec3=BrepVec3、ShapeHandle=BrepHandle）；15 个组合方法\n    // （occt-wasm 无原生导出）经 vendored OcctWasmAdapter 组合面代理 + 形态转换。\n    // 只接线一次（occtPatternWired 护栏内）；重复注册复用覆写结果，不重复捕获。\n    const k = primitives as unknown as {\n      buildExtrusionLaw(profile: string, length: number, endFactor: number): BrepHandle\n      composeTransform(m1: number[], m2: number[]): number[]\n      downcast(shape: BrepHandle, targetType: BrepSubShapeType): BrepHandle\n      healFace(shape: BrepHandle, tolerance?: number): BrepHandle\n      healWire(shape: BrepHandle, tolerance?: number): BrepHandle\n      isNull(shape: BrepHandle): boolean\n      iterShapes(shape: BrepHandle): BrepHandle[]\n      makeEllipsoid(rx: number, ry: number, rz: number): BrepHandle\n      makeFaceOnSurface(face: BrepHandle, wire: BrepHandle): BrepHandle\n      makeTorus(majorRadius: number, minorRadius: number): BrepHandle\n      makeVertex(x: number, y: number, z: number): BrepHandle\n      mirror(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle\n      sew(shapes: BrepHandle[], tolerance?: number): BrepHandle\n      shell(solid: BrepHandle, facesToRemove: BrepHandle[], thickness: number, tolerance: number): BrepHandle\n      simplePipe(profile: BrepHandle, spine: BrepHandle): BrepHandle\n      simplify(shape: BrepHandle): BrepHandle\n      split(shape: BrepHandle, tools: BrepHandle[]): BrepHandle\n      sweepPipeShell(profile: BrepHandle, spine: BrepHandle, freenet?: boolean, smooth?: boolean): BrepHandle\n    }\n    occtApi.buildExtrusionLaw = k.buildExtrusionLaw.bind(primitives)\n    occtApi.composeTransform = k.composeTransform.bind(primitives)\n    occtApi.downcast = k.downcast.bind(primitives)\n    occtApi.healFace = k.healFace.bind(primitives)\n    occtApi.healWire = k.healWire.bind(primitives)\n    occtApi.isNull = k.isNull.bind(primitives)\n    occtApi.iterShapes = k.iterShapes.bind(primitives)\n    occtApi.makeEllipsoid = k.makeEllipsoid.bind(primitives)\n    occtApi.makeFaceOnSurface = k.makeFaceOnSurface.bind(primitives)\n    occtApi.makeTorus = k.makeTorus.bind(primitives)\n    occtApi.makeVertex = k.makeVertex.bind(primitives)\n    occtApi.mirror = k.mirror.bind(primitives)\n    occtApi.sew = k.sew.bind(primitives)\n    occtApi.shell = k.shell.bind(primitives)\n    occtApi.simplePipe = k.simplePipe.bind(primitives)\n    occtApi.simplify = k.simplify.bind(primitives)\n    occtApi.split = k.split.bind(primitives)\n    occtApi.sweepPipeShell = k.sweepPipeShell.bind(primitives)\n    const vendor = OcctWasmAdapter.fromKernel(primitives as never)\n    occtApi.boundingBox = (shape) => {\n      const b = vendor.boundingBox(shape as never)\n      return { xmin: b.min[0], ymin: b.min[1], zmin: b.min[2], xmax: b.max[0], ymax: b.max[1], zmax: b.max[2] }\n    }\n    occtApi.shapeType = (shape) => vendor.shapeType(shape as never) as BrepSubShapeType\n    occtApi.surfaceCenterOfMass = (face) => {\n      const v = vendor.surfaceCenterOfMass(face as never)\n      return { x: v[0], y: v[1], z: v[2] }\n    }\n    occtApi.locate = (shape, matrix) => vendor.locate(shape as never, matrix as never) as BrepHandle\n    occtApi.copyShape = (shape) => vendor.copyShape(shape as never) as BrepHandle\n    occtApi.fixSelfIntersection = (wire) => vendor.fixSelfIntersection(wire as never) as BrepHandle\n    occtApi.hullFromPoints = (points, tolerance) => vendor.hullFromPoints(points as never, tolerance) as BrepHandle\n    occtApi.loftAdvanced = (wires, options) => vendor.loftAdvanced(wires as never, options as never) as BrepHandle\n    occtApi.makeWireFromMixed = (items) => vendor.makeWireFromMixed(items as never) as BrepHandle\n    occtApi.revolveVec = (shape, center, direction, angleDeg) =>\n      vendor.revolveVec(shape as never, [center.x, center.y, center.z] as never, [direction.x, direction.y, direction.z] as never, angleDeg) as BrepHandle\n    occtApi.buildEdgeOnSurface = (curve, surface) => vendor.buildEdgeOnSurface(curve as never, surface as never) as BrepHandle\n    occtApi.dispose = (shape) => { if (shape !== undefined) raw.release(shape as number) }\n    occtApi.generalTransformNonOrthogonal = (shape, matrix) =>\n      vendor.generalTransformNonOrthogonal(shape as never, matrix.slice(0, 9) as never, matrix.slice(9, 12) as never) as BrepHandle\n    const toEvolution = (op: {\n      shape: number\n      evolution: {\n        modified: ReadonlyMap<number, readonly number[]>\n        generated: ReadonlyMap<number, readonly number[]>\n        deleted: ReadonlySet<number>\n      }\n    }): BrepEvolutionData => {\n      const segments = (m: ReadonlyMap<number, readonly number[]>): number[] => {\n        const out: number[] = []\n        for (const [inHash, outHashes] of m) out.push(inHash, outHashes.length, ...outHashes)\n        return out\n      }\n      return { result: op.shape as BrepHandle, modified: segments(op.evolution.modified), generated: segments(op.evolution.generated), deleted: [...op.evolution.deleted] }\n    }\n    occtApi.generalTransformWithHistory = (shape, matrix, inputFaceHashes, hashUpperBound) =>\n      toEvolution(vendor.generalTransformWithHistory(\n        shape as never,\n        matrix.slice(0, 9) as never,\n        matrix.slice(9, 12) as never,\n        false,\n        inputFaceHashes as never,\n        hashUpperBound,\n      ) as never)\n    occtApi.applyComposedTransformWithHistory = (shape, matrix, inputFaceHashes, hashUpperBound) =>\n      toEvolution(vendor.applyComposedTransformWithHistory(\n        shape as never,\n        matrix as never,\n        inputFaceHashes as never,\n        hashUpperBound,\n      ) as never)\n    occtPatternWired = true\n  }\n  const occtApi = primitives as BrepEngineApi\n  registerBrepEngine(OCCT_BREP_ENGINE_ID, async (): Promise<BrepEngine> => ({\n    id: OCCT_BREP_ENGINE_ID,\n    primitives: occtApi,\n    capabilities: {\n      // 面演化：逐核函数名单（不是族级布尔——见 BrepEvolutionKind）。\n      evolution: OCCT_EVOLUTION_KINDS,\n      // 非演化内核方法：逐核如实声明（Phase 1，P2 缺口补齐；op 声明按此静态判定）。\n      methods: OCCT_METHOD_KINDS,\n      heal: true,\n      directEdit: true,\n      advSurface: true,\n      assembly: true,\n      // P7 并入（D4）：OCCT 是精确 B-rep 内核——如实声明 brepjs KernelCapabilities 字段。\n      exact: true,\n      brepExport: true,\n      exactMeasurement: true,\n      tessellationModel: 'extract-time',\n    },\n  }))\n  // P7-②：同一装配点把移植内核注册表注入到当前 BREP 引擎（Phase 2 P2-5：取代旧的\n  // bindOcctKernel() 固定绑定，改为引擎中立的 injectCurrentBrepEngineAsKernel）。\n  // 使 L3 调移植 L2 的 op 在宿主装配后立即可用；幂等，重复调用安全。\n  await injectCurrentBrepEngineAsKernel()\n}\n\n/**\n * 内置默认 BREP 引擎装配（OCCT）：宿主未注册任何引擎时的缺省值。\n *\n * OCCT 是 faijs 的默认 BREP 引擎——低频率、静态的替换：换引擎 = 宿主在\n * 装配期显式注册其它引擎（首个注册者为默认），或改本处默认。宿主无需为\n * 每次使用自行提供引擎；本函数幂等，已注册任何引擎则 no-op。\n */\nexport async function ensureOcctDefaultEngine(): Promise<void> {\n  if (hasBrepEngine()) return\n  await registerOcctBrepEngine()\n}\n\n// §7.8 编译期守卫：initOcctWasm 的返回类型必须满足 BrepEngineApi。\n// 若未来 occt-kernel 的导出类型不再满足接口（如接口新增方法）→ tsc 报错列出缺失。\ntype _AssertOcctApi = AssertSatisfiesBrepEngineApi<Awaited<ReturnType<typeof initOcctWasm>>>\n"]}

package/dist/brep/engine/primitives.d.ts

@@ -54,10 +54,89 @@ export interface BrepEngineApi {
     chamferWithHistory(solid: BrepHandle, edges: BrepHandle[], distance: number, inputFaceHashes: number[], hashUpperBound: number): BrepEvolutionData;
     translate(shape: BrepHandle, dx: number, dy: number, dz: number): BrepHandle;
     scale(shape: BrepHandle, center: BrepVec3, factor: number): BrepHandle;
+    /** 3×4 行主序 12 元素矩阵（口径见上方"变换"节注释）。 */
     transform(shape: BrepHandle, matrix: number[]): BrepHandle;
+    /** 3×4 行主序 12 元素矩阵（口径见上方"变换"节注释）。 */
     located(shape: BrepHandle, matrix: number[]): BrepHandle;
+    /** 3×4 行主序 12 元素矩阵（口径见上方"变换"节注释）。 */
     generalTransform(shape: BrepHandle, matrix: number[]): BrepHandle;
     copy(shape: BrepHandle): BrepHandle;
+    /** 线性阵列：沿 direction 复制 count 份（含原位置），返回各份副本句柄数组。 */
+    linearPattern(shape: BrepHandle, direction: BrepVec3, spacing: number, count: number): BrepHandle[];
+    /** 环形阵列：绕 axis 均分 angleStep 每份，返回各份副本句柄数组。 */
+    circularPattern(shape: BrepHandle, center: BrepVec3, axis: BrepVec3, angleStep: number, count: number): BrepHandle[];
+    /** 二维栅格阵列：沿两方向复制 countX×countY 份，返回 compound 单句柄。 */
+    gridPattern(shape: BrepHandle, directionX: BrepVec3, directionY: BrepVec3, spacingX: number, spacingY: number, countX: number, countY: number): BrepHandle;
+    /** 轴对齐包围盒。 */
+    boundingBox(shape: BrepHandle): BrepBoundingBox;
+    /** 形状类型（vertex/edge/wire/face/shell/solid）。 */
+    shapeType(shape: BrepHandle): BrepSubShapeType;
+    /** 句柄是否为空（无效引用）。 */
+    isNull(shape: BrepHandle): boolean;
+    /** 遍历子形状句柄（与 getSubShapes 同族，返回句柄数组）。 */
+    iterShapes(shape: BrepHandle): BrepHandle[];
+    /** 曲面质心。 */
+    surfaceCenterOfMass(face: BrepHandle): BrepVec3;
+    /** 带位置矩阵放置（3×4 行主序 12 元素，口径见变换族注释）。 */
+    locate(shape: BrepHandle, matrix: number[]): BrepHandle;
+    /** 复制句柄（独立引用计数）。 */
+    copyShape(shape: BrepHandle): BrepHandle;
+    /** 类型降级（目标子形状类型；不匹配返回空句柄）。 */
+    downcast(shape: BrepHandle, targetType: BrepSubShapeType): BrepHandle;
+    /** 释放内核/句柄（引擎级释放语义；brepkit GC 型 no-op）。 */
+    dispose(shape?: BrepHandle): void;
+    /** 组合两个 3×4 行主序变换矩阵（12 元素）。 */
+    composeTransform(m1: number[], m2: number[]): number[];
+    /** 拉伸律面构造（profile 为曲线描述串）。 */
+    buildExtrusionLaw(profile: string, length: number, endFactor: number): BrepHandle;
+    /** 曲面上的边构造（curve 为 2D 曲线句柄，宽化 BrepHandle 口径）。 */
+    buildEdgeOnSurface(curve: BrepHandle, surface: BrepHandle): BrepHandle;
+    /** 面修复（ShapeFix，容忍度可选）。 */
+    healFace(shape: BrepHandle, tolerance?: number): BrepHandle;
+    /** 线修复（ShapeFix，容忍度可选）。 */
+    healWire(shape: BrepHandle, tolerance?: number): BrepHandle;
+    /** 线自相交修复。 */
+    fixSelfIntersection(wire: BrepHandle): BrepHandle;
+    /** 点集凸包（tolerance 为容差）。 */
+    hullFromPoints(points: BrepVec3[], tolerance: number): BrepHandle;
+    /** 高级放样（options 形态同 vendored loftAdvanced）。 */
+    loftAdvanced(wires: BrepHandle[], options?: {
+        solid?: boolean;
+        ruled?: boolean;
+        tolerance?: number;
+    }): BrepHandle;
+    /** 椭球（三半轴）。 */
+    makeEllipsoid(rx: number, ry: number, rz: number): BrepHandle;
+    /** 曲面上的面构造（face 为承载面、wire 为边界）。 */
+    makeFaceOnSurface(face: BrepHandle, wire: BrepHandle): BrepHandle;
+    /** 圆环（主/次半径）。 */
+    makeTorus(majorRadius: number, minorRadius: number): BrepHandle;
+    /** 顶点构造。 */
+    makeVertex(x: number, y: number, z: number): BrepHandle;
+    /** 混合线构造（items 为边/顶点混合）。 */
+    makeWireFromMixed(items: BrepHandle[]): BrepHandle;
+    /** 镜像（过 point、法向 normal 的平面）。 */
+    mirror(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle;
+    /** 旋转（绕过 center、方向 direction 的轴，angle 为度）。 */
+    revolveVec(shape: BrepHandle, center: BrepVec3, direction: BrepVec3, angleDeg: number): BrepHandle;
+    /** 缝合（tolerance 可选）。 */
+    sew(shapes: BrepHandle[], tolerance?: number): BrepHandle;
+    /** 抽壳（facesToRemove 移除面、thickness 壁厚、tolerance 容差）。 */
+    shell(solid: BrepHandle, facesToRemove: BrepHandle[], thickness: number, tolerance: number): BrepHandle;
+    /** 简单扫掠（profile 沿 spine 扫出实体）。 */
+    simplePipe(profile: BrepHandle, spine: BrepHandle): BrepHandle;
+    /** 简化几何。 */
+    simplify(shape: BrepHandle): BrepHandle;
+    /** 分割（tools 切割体；返回单个结果句柄，语义同 vendored boolOps.split）。 */
+    split(shape: BrepHandle, tools: BrepHandle[]): BrepHandle;
+    /** 管壳扫掠（freenet/smooth 可选）。 */
+    sweepPipeShell(profile: BrepHandle, spine: BrepHandle, freenet?: boolean, smooth?: boolean): BrepHandle;
+    /** 非正交一般变换（3×4 行主序 12 元素）。 */
+    generalTransformNonOrthogonal(shape: BrepHandle, matrix: number[]): BrepHandle;
+    /** 一般变换（带面演化；3×4 行主序 12 元素，适配器拆分 linear/translation）。 */
+    generalTransformWithHistory(shape: BrepHandle, matrix: number[], inputFaceHashes: number[], hashUpperBound: number): BrepEvolutionData;
+    /** 组合变换（带面演化；3×4 行主序 12 元素）。 */
+    applyComposedTransformWithHistory(shape: BrepHandle, matrix: number[], inputFaceHashes: number[], hashUpperBound: number): BrepEvolutionData;
     makeLineEdge(start: BrepVec3, end: BrepVec3): BrepHandle;
     makeArcEdge(start: BrepVec3, mid: BrepVec3, end: BrepVec3): BrepHandle;
     makeBezierEdge(controlPoints: BrepVec3[]): BrepHandle;

package/dist/brep/engine/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/brep/engine/primitives.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/brep/engine/primitives.ts"],"names":[],"mappings":"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"}

package/dist/brep/engine/primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/brep/engine/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * engine/primitives — BREP 引擎契约面（port 面）\n *\n *\n * ⚠️ Phase 0 落地形态：覆盖 §2.3 实测的 66 个被调方法（BrepHandle 中立签名），\n * 供类型解耦使用。Phase 1 按 §7.4 扩到 83 项分 14 族，并落地编译期完整性守卫\n * （_AssertSatisfiesBrepEngineApi，抄 brepjs §3.2）。\n * 复杂返回类型（XCAF 文档 / NURBS 曲线数据等）在 Phase 0 用 unknown 占位，Phase 1 钉死。\n *\n * 命名沿用 occt-wasm 现状——最小迁移成本 + 可演进（§7.4 的取舍）。\n */\n\nimport type {\n  BrepBoundingBox,\n  BrepCurveParameters,\n  BrepEdgeData,\n  BrepEvolutionData,\n  BrepHandle,\n  BrepMeshResult,\n  BrepSubShapeType,\n  BrepTessellateOptions,\n  BrepUvBounds,\n  BrepVec3,\n  BrepXcafDocument,\n} from './types'\n\n/**\n * BREP 引擎原语契约。所有句柄参数/返回值均为 BrepHandle（不透明值，§6.3）。\n * 引擎实现（occt/remus 适配器）负责内部句柄形态与 BrepHandle 的转换。\n */\nexport interface BrepEngineApi {\n  // ── 生命周期 ──\n  /** 手工释放句柄（GC 型引擎实现为 no-op）。 */\n  release(shape: BrepHandle): void\n\n  // ── 实体图元 ──\n  makeBox(dx: number, dy: number, dz: number): BrepHandle\n  makeBoxFromCorners(corner1: BrepVec3, corner2: BrepVec3): BrepHandle\n  makeCylinder(radius: number, height: number): BrepHandle\n  makeSphere(radius: number): BrepHandle\n  makeCone(r1: number, r2: number, height: number): BrepHandle\n  makeRectangle(width: number, height: number): BrepHandle\n\n  // ── 造型运算 ──\n  extrude(shape: BrepHandle, dx: number, dy: number, dz: number): BrepHandle\n  loft(wires: BrepHandle[], isSolid: boolean, ruled: boolean): BrepHandle\n\n  // ── 布尔与分割 ──\n  fuse(a: BrepHandle, b: BrepHandle): BrepHandle\n  cut(a: BrepHandle, b: BrepHandle): BrepHandle\n  common(a: BrepHandle, b: BrepHandle): BrepHandle\n  intersect(a: BrepHandle, b: BrepHandle): BrepHandle\n  section(a: BrepHandle, b: BrepHandle): BrepHandle\n  fuseAll(shapes: BrepHandle[]): BrepHandle\n\n  // ── 倒角与圆角（directEdit 能力）──\n  /** 等距倒角：逐边 `BRepFilletAPI_MakeChamfer::Add(distance, E)`。 */\n  chamfer(solid: BrepHandle, edges: BrepHandle[], distance: number): BrepHandle\n  /**\n   * 距角倒角：`AddDA(distance, angleRad, E, F)`。\n   * ⚠️ F 由内核自选（外层 TopExp_Explorer 第一个含该边的面），调用方不可指定。\n   */\n  chamferDistAngle(\n    solid: BrepHandle, edges: BrepHandle[], distance: number, angleDeg: number,\n  ): BrepHandle\n  /** 等半径圆角：`BRepFilletAPI_MakeFillet::Add(radius, E)`。 */\n  fillet(solid: BrepHandle, edges: BrepHandle[], radius: number): BrepHandle\n  /** 变半径圆角：单边 `BRepFilletAPI_MakeFillet::Add(startRadius, endRadius, E)`。 */\n  filletVariable(solid: BrepHandle, edge: BrepHandle, startRadius: number, endRadius: number): BrepHandle\n  /**\n   * 等半径圆角（WithHistory）：返回面演化数据，供 roleTable 传播。\n   * modified/generated/deleted 用面 hash 编码（§7.5）。\n   */\n  filletWithHistory(\n    solid: BrepHandle,\n    edges: BrepHandle[],\n    radius: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /**\n   * 等距倒角（WithHistory）：返回面演化数据，供 roleTable 传播。\n   * modified/generated/deleted 用面 hash 编码（§7.5）。\n   */\n  chamferWithHistory(\n    solid: BrepHandle,\n    edges: BrepHandle[],\n    distance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n\n  // ── 变换 ──\n  translate(shape: BrepHandle, dx: number, dy: number, dz: number): BrepHandle\n  scale(shape: BrepHandle, center: BrepVec3, factor: number): BrepHandle\n  transform(shape: BrepHandle, matrix: number[]): BrepHandle\n  located(shape: BrepHandle, matrix: number[]): BrepHandle\n  generalTransform(shape: BrepHandle, matrix: number[]): BrepHandle\n  copy(shape: BrepHandle): BrepHandle\n\n  // ── 曲线构造 ──\n  makeLineEdge(start: BrepVec3, end: BrepVec3): BrepHandle\n  makeArcEdge(start: BrepVec3, mid: BrepVec3, end: BrepVec3): BrepHandle\n  makeBezierEdge(controlPoints: BrepVec3[]): BrepHandle\n\n  // ── 拓扑构造 ──\n  makeWire(edges: BrepHandle[]): BrepHandle\n  makeFace(wire: BrepHandle): BrepHandle\n  makeCompound(shapes: BrepHandle[]): BrepHandle\n  sewAndSolidify(faces: BrepHandle[], tolerance?: number): BrepHandle\n  buildTriFace(a: BrepVec3, b: BrepVec3, c: BrepVec3): BrepHandle\n  addHolesInFace(face: BrepHandle, holeWires: BrepHandle[]): BrepHandle\n\n  // ── 三角化（BREP→mesh 唯一出口，断链物化依赖，硬必需） ──\n  meshShape(shape: BrepHandle, options?: BrepTessellateOptions): BrepMeshResult\n  wireframe(shape: BrepHandle, deflection?: number): BrepEdgeData\n\n  // ── 拓扑查询 ──\n  getSubShapes(shape: BrepHandle, type: BrepSubShapeType): BrepHandle[]\n  /** 批量查询（§2.3：生产路径零调用，仅测试使用；Phase 1 钉死返回形态）。 */\n  queryBatch(shapes: BrepHandle[]): Array<{ area: number }>\n  subShapeHashes(shape: BrepHandle, type: BrepSubShapeType, hashUpperBound: number): number[]\n  hashCode(shape: BrepHandle, upperBound: number): number\n  isSame(a: BrepHandle, b: BrepHandle): boolean\n  isSolid(shape: BrepHandle): boolean\n  /** 方向标识（与内核 ShapeOrientation 同构：'forward'|'reversed'|'internal'|'external'）。 */\n  shapeOrientation(shape: BrepHandle): string\n\n  // ── 几何求值 ──\n  /** 曲面类型标识（与内核 SurfaceKind 同构的中立字符串形态）。 */\n  curveType(edge: BrepHandle): string\n  curvePointAtParam(edge: BrepHandle, param: number): BrepVec3\n  curveTangent(edge: BrepHandle, param: number): BrepVec3\n  curveParameters(edge: BrepHandle): BrepCurveParameters\n  curveIsClosed(edge: BrepHandle): boolean\n  curveLength(edge: BrepHandle): number\n  /** 曲面类型标识（与内核 SurfaceKind 同构的中立字符串形态）。 */\n  surfaceType(face: BrepHandle): string\n  surfaceNormal(face: BrepHandle, u: number, v: number): BrepVec3\n  pointOnSurface(face: BrepHandle, u: number, v: number): BrepVec3\n  uvBounds(face: BrepHandle): BrepUvBounds\n  getSurfaceCenterOfMass(face: BrepHandle): BrepVec3\n  /** Phase 1 钉死返回形态（topologyExt 仅读 radius）。 */\n  getFaceCylinderData(face: BrepHandle): { radius: number } | null\n  /** Phase 1 钉死返回形态（topologyExt 读 degree/periodic/rational）。 */\n  getNurbsCurveData(edge: BrepHandle): { degree: number; periodic: boolean; rational: boolean } | null\n\n  // ── 测量 ──\n  getBoundingBox(shape: BrepHandle, useTriangulation?: boolean): BrepBoundingBox\n  getVolume(shape: BrepHandle): number\n  getCenterOfMass(shape: BrepHandle): BrepVec3\n\n  // ── 校验与修复 ──\n  isValid(shape: BrepHandle): boolean\n  unifySameDomain(shape: BrepHandle): BrepHandle\n  healSolid(shape: BrepHandle, tolerance?: number): BrepHandle\n  fixShape(shape: BrepHandle): BrepHandle\n  fixFaceOrientations(shape: BrepHandle): BrepHandle\n  removeDegenerateEdges(shape: BrepHandle): BrepHandle\n\n  // ── IO ──\n  importStep(data: string | ArrayBuffer): BrepHandle\n  exportStep(shape: BrepHandle): string\n  importStl(data: string | ArrayBuffer): BrepHandle\n  fromBREP(data: string): BrepHandle\n\n  // ── 面演化（可选能力槽 §7.5 EvolutionCapability） ──\n  cutWithHistory(\n    a: BrepHandle,\n    b: BrepHandle,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  fuseWithHistory(\n    a: BrepHandle,\n    b: BrepHandle,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  intersectWithHistory(\n    a: BrepHandle,\n    b: BrepHandle,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n\n  // ── 面演化 · Phase 0.1 补齐的 7 个（occt-wasm 运行时本就存在） ──\n  //\n  // ⚠️ 为什么此前只有 5 个：faijs 只绑了 boolean 与 fillet/chamfer，那 7 个在\n  // `occt-wasm@3.8.4` 的运行时**一直都在**（dist/index.d.ts:458-472 共 12 个），\n  // 只是 faijs 类型层未声明、也无人调用。补齐**不动 WASM**。\n  //\n  // ⚠️ 注意：`initOcctWasm()` 的返回类型在本文件之外已被硬断言为 BrepEngineApi\n  // （occtKernel.ts:88/95/106/112 `as unknown as`）⇒ 下方 `_AssertOcctApi`\n  // 恒真、**无校验力**。声明 ≠ 运行时存在：存在性由\n  // `packages/core/src/brep/engine/evolution-bindings.test.ts` 的冒烟测试钉住。\n\n  /** 平移 + 面演化（权威 hash→hash 映射，替代序号对齐近似）。 */\n  translateWithHistory(\n    shape: BrepHandle,\n    dx: number,\n    dy: number,\n    dz: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 绕任意轴旋转 + 面演化。`axis = {point, direction}`，`angleRad` 为**弧度**。 */\n  rotateWithHistory(\n    shape: BrepHandle,\n    axis: { point: BrepVec3; direction: BrepVec3 },\n    angleRad: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 镜像 + 面演化。`point` 为镜像面上一点，`normal` 为镜像面法向。 */\n  mirrorWithHistory(\n    shape: BrepHandle,\n    point: BrepVec3,\n    normal: BrepVec3,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 缩放 + 面演化。⚠️ 仅**均匀**缩放（`factor: number`）；非均匀走 `generalTransform`（无历史）。 */\n  scaleWithHistory(\n    shape: BrepHandle,\n    center: BrepVec3,\n    factor: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 抽壳 + 面演化。`faces` 为被移除的面（开口），`thickness` 为壁厚。 */\n  shellWithHistory(\n    solid: BrepHandle,\n    faces: BrepHandle[],\n    thickness: number,\n    tolerance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 偏移 + 面演化。 */\n  offsetWithHistory(\n    solid: BrepHandle,\n    distance: number,\n    tolerance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 加厚（面/壳 → 实体）+ 面演化。 */\n  thickenWithHistory(\n    shape: BrepHandle,\n    thickness: number,\n    tolerance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n\n  // ── XCAF 装配（可选能力槽 §7.5 AssemblyCapability，Phase 1 钉死完整形态） ──\n  createXCAFDocument(): BrepXcafDocument\n  importXCAFFromSTEP(stepData: string): BrepXcafDocument\n}\n\n/**\n * 编译期完整性守卫（§7.8，抄 brepjs §3.2 的 _AssertSatisfiesKernelShape）。\n *\n * 用法（适配器里）：\n * ```ts\n * type _AssertOcct = AssertSatisfiesBrepEngineApi<Awaited<ReturnType<typeof initOcctWasm>>>\n * ```\n * 若实现类型缺少接口中的任何方法（或签名不兼容）→ tsc 报错并列出缺失属性。\n * 引擎换用 / 接口演进（Phase 1 扩到 83 项）时，失配在编译期暴露，而非运行时黑盒。\n */\nexport type AssertSatisfiesBrepEngineApi<Impl extends BrepEngineApi> = Impl\n"]}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/brep/engine/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG","sourcesContent":["/**\n * engine/primitives — BREP 引擎契约面（port 面）\n *\n *\n * ⚠️ Phase 0 落地形态：覆盖 §2.3 实测的 66 个被调方法（BrepHandle 中立签名），\n * 供类型解耦使用。Phase 1 按 §7.4 扩到 83 项分 14 族，并落地编译期完整性守卫\n * （_AssertSatisfiesBrepEngineApi，抄 brepjs §3.2）。\n * 复杂返回类型（XCAF 文档 / NURBS 曲线数据等）在 Phase 0 用 unknown 占位，Phase 1 钉死。\n *\n * 命名沿用 occt-wasm 现状——最小迁移成本 + 可演进（§7.4 的取舍）。\n */\n\nimport type {\n  BrepBoundingBox,\n  BrepCurveParameters,\n  BrepEdgeData,\n  BrepEvolutionData,\n  BrepHandle,\n  BrepMeshResult,\n  BrepSubShapeType,\n  BrepTessellateOptions,\n  BrepUvBounds,\n  BrepVec3,\n  BrepXcafDocument,\n} from './types'\n\n/**\n * BREP 引擎原语契约。所有句柄参数/返回值均为 BrepHandle（不透明值，§6.3）。\n * 引擎实现（occt/remus 适配器）负责内部句柄形态与 BrepHandle 的转换。\n */\nexport interface BrepEngineApi {\n  // ── 生命周期 ──\n  /** 手工释放句柄（GC 型引擎实现为 no-op）。 */\n  release(shape: BrepHandle): void\n\n  // ── 实体图元 ──\n  makeBox(dx: number, dy: number, dz: number): BrepHandle\n  makeBoxFromCorners(corner1: BrepVec3, corner2: BrepVec3): BrepHandle\n  makeCylinder(radius: number, height: number): BrepHandle\n  makeSphere(radius: number): BrepHandle\n  makeCone(r1: number, r2: number, height: number): BrepHandle\n  makeRectangle(width: number, height: number): BrepHandle\n\n  // ── 造型运算 ──\n  extrude(shape: BrepHandle, dx: number, dy: number, dz: number): BrepHandle\n  loft(wires: BrepHandle[], isSolid: boolean, ruled: boolean): BrepHandle\n\n  // ── 布尔与分割 ──\n  fuse(a: BrepHandle, b: BrepHandle): BrepHandle\n  cut(a: BrepHandle, b: BrepHandle): BrepHandle\n  common(a: BrepHandle, b: BrepHandle): BrepHandle\n  intersect(a: BrepHandle, b: BrepHandle): BrepHandle\n  section(a: BrepHandle, b: BrepHandle): BrepHandle\n  fuseAll(shapes: BrepHandle[]): BrepHandle\n\n  // ── 倒角与圆角（directEdit 能力）──\n  /** 等距倒角：逐边 `BRepFilletAPI_MakeChamfer::Add(distance, E)`。 */\n  chamfer(solid: BrepHandle, edges: BrepHandle[], distance: number): BrepHandle\n  /**\n   * 距角倒角：`AddDA(distance, angleRad, E, F)`。\n   * ⚠️ F 由内核自选（外层 TopExp_Explorer 第一个含该边的面），调用方不可指定。\n   */\n  chamferDistAngle(\n    solid: BrepHandle, edges: BrepHandle[], distance: number, angleDeg: number,\n  ): BrepHandle\n  /** 等半径圆角：`BRepFilletAPI_MakeFillet::Add(radius, E)`。 */\n  fillet(solid: BrepHandle, edges: BrepHandle[], radius: number): BrepHandle\n  /** 变半径圆角：单边 `BRepFilletAPI_MakeFillet::Add(startRadius, endRadius, E)`。 */\n  filletVariable(solid: BrepHandle, edge: BrepHandle, startRadius: number, endRadius: number): BrepHandle\n  /**\n   * 等半径圆角（WithHistory）：返回面演化数据，供 roleTable 传播。\n   * modified/generated/deleted 用面 hash 编码（§7.5）。\n   */\n  filletWithHistory(\n    solid: BrepHandle,\n    edges: BrepHandle[],\n    radius: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /**\n   * 等距倒角（WithHistory）：返回面演化数据，供 roleTable 传播。\n   * modified/generated/deleted 用面 hash 编码（§7.5）。\n   */\n  chamferWithHistory(\n    solid: BrepHandle,\n    edges: BrepHandle[],\n    distance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n\n  // ── 变换 ──\n  // 矩阵口径（唯一权威）：matrix 参数是 **3×4 行主序、12 个 double**——\n  // [r00,r01,r02,tx, r10,r11,r12,ty, r20,r21,r22,tz]，与 brep/brep-ops.ts 的\n  // matrixToArray()（THREE.Matrix4 column-major → 行主序 3×4）产出同构。\n  // 各引擎方言不同（如 brepkit transformSolid 吃 4×4 行主序 16 元素）时，\n  // 由该引擎适配层内部转换（见 brepkit-kernel/brepkitKernel.ts 的 toKernelMatrix\n  // 唯一转换点），禁止要求调用方适配引擎方言。\n  translate(shape: BrepHandle, dx: number, dy: number, dz: number): BrepHandle\n  scale(shape: BrepHandle, center: BrepVec3, factor: number): BrepHandle\n  /** 3×4 行主序 12 元素矩阵（口径见上方\"变换\"节注释）。 */\n  transform(shape: BrepHandle, matrix: number[]): BrepHandle\n  /** 3×4 行主序 12 元素矩阵（口径见上方\"变换\"节注释）。 */\n  located(shape: BrepHandle, matrix: number[]): BrepHandle\n  /** 3×4 行主序 12 元素矩阵（口径见上方\"变换\"节注释）。 */\n  generalTransform(shape: BrepHandle, matrix: number[]): BrepHandle\n  copy(shape: BrepHandle): BrepHandle\n\n  // ── 阵列（Phase 2：pattern 族；occt-wasm 原生 + brepkit wasm 已导出） ──\n  // 口径（vendored brepjs 内核调用面，docs/plans/2026-09-23-brep-engine-switchability-rework.md §Phase 2）：\n  //   - 两内核的 pattern 内核函数都返回 compound（含全部副本），适配器负责拆成数组；\n  //   - 不声明 rectangularPattern：vendored rectangularPattern 是纯 JS 组合\n  //     （compoundOpsFns.ts，translate + fuseAll），不调内核方法（capability-map 实证）；\n  //   - 不声明裸 mirror/rotate：vendored transformFns 全部走 `*WithHistory` 内核\n  //     （transformFns.ts:29-99 实证），基础方法仅 2D sketcher 面使用（走 KernelAdapter）。\n  /** 线性阵列：沿 direction 复制 count 份（含原位置），返回各份副本句柄数组。 */\n  linearPattern(shape: BrepHandle, direction: BrepVec3, spacing: number, count: number): BrepHandle[]\n  /** 环形阵列：绕 axis 均分 angleStep 每份，返回各份副本句柄数组。 */\n  circularPattern(\n    shape: BrepHandle,\n    center: BrepVec3,\n    axis: BrepVec3,\n    angleStep: number,\n    count: number,\n  ): BrepHandle[]\n  /** 二维栅格阵列：沿两方向复制 countX×countY 份，返回 compound 单句柄。 */\n  gridPattern(\n    shape: BrepHandle,\n    directionX: BrepVec3,\n    directionY: BrepVec3,\n    spacingX: number,\n    spacingY: number,\n    countX: number,\n    countY: number,\n  ): BrepHandle\n\n  // ── 查询与测量（Phase 3：capability-map 64 方法登记补全——occt-wasm 原生或\n  //   vendored 适配器组合面；brepkit 无实现的能力保持不声明，静态判定拦截） ──\n  /** 轴对齐包围盒。 */\n  boundingBox(shape: BrepHandle): BrepBoundingBox\n  /** 形状类型（vertex/edge/wire/face/shell/solid）。 */\n  shapeType(shape: BrepHandle): BrepSubShapeType\n  /** 句柄是否为空（无效引用）。 */\n  isNull(shape: BrepHandle): boolean\n  /** 遍历子形状句柄（与 getSubShapes 同族，返回句柄数组）。 */\n  iterShapes(shape: BrepHandle): BrepHandle[]\n  /** 曲面质心。 */\n  surfaceCenterOfMass(face: BrepHandle): BrepVec3\n  /** 带位置矩阵放置（3×4 行主序 12 元素，口径见变换族注释）。 */\n  locate(shape: BrepHandle, matrix: number[]): BrepHandle\n  /** 复制句柄（独立引用计数）。 */\n  copyShape(shape: BrepHandle): BrepHandle\n  /** 类型降级（目标子形状类型；不匹配返回空句柄）。 */\n  downcast(shape: BrepHandle, targetType: BrepSubShapeType): BrepHandle\n  /** 释放内核/句柄（引擎级释放语义；brepkit GC 型 no-op）。 */\n  dispose(shape?: BrepHandle): void\n  /** 组合两个 3×4 行主序变换矩阵（12 元素）。 */\n  composeTransform(m1: number[], m2: number[]): number[]\n\n  // ── 构形与修复（Phase 3 登记；brepkit 未实现 → 能力表不声明） ──\n  /** 拉伸律面构造（profile 为曲线描述串）。 */\n  buildExtrusionLaw(profile: string, length: number, endFactor: number): BrepHandle\n  /** 曲面上的边构造（curve 为 2D 曲线句柄，宽化 BrepHandle 口径）。 */\n  buildEdgeOnSurface(curve: BrepHandle, surface: BrepHandle): BrepHandle\n  /** 面修复（ShapeFix，容忍度可选）。 */\n  healFace(shape: BrepHandle, tolerance?: number): BrepHandle\n  /** 线修复（ShapeFix，容忍度可选）。 */\n  healWire(shape: BrepHandle, tolerance?: number): BrepHandle\n  /** 线自相交修复。 */\n  fixSelfIntersection(wire: BrepHandle): BrepHandle\n  /** 点集凸包（tolerance 为容差）。 */\n  hullFromPoints(points: BrepVec3[], tolerance: number): BrepHandle\n  /** 高级放样（options 形态同 vendored loftAdvanced）。 */\n  loftAdvanced(wires: BrepHandle[], options?: { solid?: boolean; ruled?: boolean; tolerance?: number }): BrepHandle\n  /** 椭球（三半轴）。 */\n  makeEllipsoid(rx: number, ry: number, rz: number): BrepHandle\n  /** 曲面上的面构造（face 为承载面、wire 为边界）。 */\n  makeFaceOnSurface(face: BrepHandle, wire: BrepHandle): BrepHandle\n  /** 圆环（主/次半径）。 */\n  makeTorus(majorRadius: number, minorRadius: number): BrepHandle\n  /** 顶点构造。 */\n  makeVertex(x: number, y: number, z: number): BrepHandle\n  /** 混合线构造（items 为边/顶点混合）。 */\n  makeWireFromMixed(items: BrepHandle[]): BrepHandle\n  /** 镜像（过 point、法向 normal 的平面）。 */\n  mirror(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle\n  /** 旋转（绕过 center、方向 direction 的轴，angle 为度）。 */\n  revolveVec(shape: BrepHandle, center: BrepVec3, direction: BrepVec3, angleDeg: number): BrepHandle\n  /** 缝合（tolerance 可选）。 */\n  sew(shapes: BrepHandle[], tolerance?: number): BrepHandle\n  /** 抽壳（facesToRemove 移除面、thickness 壁厚、tolerance 容差）。 */\n  shell(solid: BrepHandle, facesToRemove: BrepHandle[], thickness: number, tolerance: number): BrepHandle\n  /** 简单扫掠（profile 沿 spine 扫出实体）。 */\n  simplePipe(profile: BrepHandle, spine: BrepHandle): BrepHandle\n  /** 简化几何。 */\n  simplify(shape: BrepHandle): BrepHandle\n  /** 分割（tools 切割体；返回单个结果句柄，语义同 vendored boolOps.split）。 */\n  split(shape: BrepHandle, tools: BrepHandle[]): BrepHandle\n  /** 管壳扫掠（freenet/smooth 可选）。 */\n  sweepPipeShell(profile: BrepHandle, spine: BrepHandle, freenet?: boolean, smooth?: boolean): BrepHandle\n  /** 非正交一般变换（3×4 行主序 12 元素）。 */\n  generalTransformNonOrthogonal(shape: BrepHandle, matrix: number[]): BrepHandle\n  /** 一般变换（带面演化；3×4 行主序 12 元素，适配器拆分 linear/translation）。 */\n  generalTransformWithHistory(\n    shape: BrepHandle,\n    matrix: number[],\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 组合变换（带面演化；3×4 行主序 12 元素）。 */\n  applyComposedTransformWithHistory(\n    shape: BrepHandle,\n    matrix: number[],\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n\n\n  // ── 曲线构造 ──\n  makeLineEdge(start: BrepVec3, end: BrepVec3): BrepHandle\n  makeArcEdge(start: BrepVec3, mid: BrepVec3, end: BrepVec3): BrepHandle\n  makeBezierEdge(controlPoints: BrepVec3[]): BrepHandle\n\n  // ── 拓扑构造 ──\n  makeWire(edges: BrepHandle[]): BrepHandle\n  makeFace(wire: BrepHandle): BrepHandle\n  makeCompound(shapes: BrepHandle[]): BrepHandle\n  sewAndSolidify(faces: BrepHandle[], tolerance?: number): BrepHandle\n  buildTriFace(a: BrepVec3, b: BrepVec3, c: BrepVec3): BrepHandle\n  addHolesInFace(face: BrepHandle, holeWires: BrepHandle[]): BrepHandle\n\n  // ── 三角化（BREP→mesh 唯一出口，断链物化依赖，硬必需） ──\n  meshShape(shape: BrepHandle, options?: BrepTessellateOptions): BrepMeshResult\n  wireframe(shape: BrepHandle, deflection?: number): BrepEdgeData\n\n  // ── 拓扑查询 ──\n  getSubShapes(shape: BrepHandle, type: BrepSubShapeType): BrepHandle[]\n  /** 批量查询（§2.3：生产路径零调用，仅测试使用；Phase 1 钉死返回形态）。 */\n  queryBatch(shapes: BrepHandle[]): Array<{ area: number }>\n  subShapeHashes(shape: BrepHandle, type: BrepSubShapeType, hashUpperBound: number): number[]\n  hashCode(shape: BrepHandle, upperBound: number): number\n  isSame(a: BrepHandle, b: BrepHandle): boolean\n  isSolid(shape: BrepHandle): boolean\n  /** 方向标识（与内核 ShapeOrientation 同构：'forward'|'reversed'|'internal'|'external'）。 */\n  shapeOrientation(shape: BrepHandle): string\n\n  // ── 几何求值 ──\n  /** 曲面类型标识（与内核 SurfaceKind 同构的中立字符串形态）。 */\n  curveType(edge: BrepHandle): string\n  curvePointAtParam(edge: BrepHandle, param: number): BrepVec3\n  curveTangent(edge: BrepHandle, param: number): BrepVec3\n  curveParameters(edge: BrepHandle): BrepCurveParameters\n  curveIsClosed(edge: BrepHandle): boolean\n  curveLength(edge: BrepHandle): number\n  /** 曲面类型标识（与内核 SurfaceKind 同构的中立字符串形态）。 */\n  surfaceType(face: BrepHandle): string\n  surfaceNormal(face: BrepHandle, u: number, v: number): BrepVec3\n  pointOnSurface(face: BrepHandle, u: number, v: number): BrepVec3\n  uvBounds(face: BrepHandle): BrepUvBounds\n  getSurfaceCenterOfMass(face: BrepHandle): BrepVec3\n  /** Phase 1 钉死返回形态（topologyExt 仅读 radius）。 */\n  getFaceCylinderData(face: BrepHandle): { radius: number } | null\n  /** Phase 1 钉死返回形态（topologyExt 读 degree/periodic/rational）。 */\n  getNurbsCurveData(edge: BrepHandle): { degree: number; periodic: boolean; rational: boolean } | null\n\n  // ── 测量 ──\n  getBoundingBox(shape: BrepHandle, useTriangulation?: boolean): BrepBoundingBox\n  getVolume(shape: BrepHandle): number\n  getCenterOfMass(shape: BrepHandle): BrepVec3\n\n  // ── 校验与修复 ──\n  isValid(shape: BrepHandle): boolean\n  unifySameDomain(shape: BrepHandle): BrepHandle\n  healSolid(shape: BrepHandle, tolerance?: number): BrepHandle\n  fixShape(shape: BrepHandle): BrepHandle\n  fixFaceOrientations(shape: BrepHandle): BrepHandle\n  removeDegenerateEdges(shape: BrepHandle): BrepHandle\n\n  // ── IO ──\n  importStep(data: string | ArrayBuffer): BrepHandle\n  exportStep(shape: BrepHandle): string\n  importStl(data: string | ArrayBuffer): BrepHandle\n  fromBREP(data: string): BrepHandle\n\n  // ── 面演化（可选能力槽 §7.5 EvolutionCapability） ──\n  cutWithHistory(\n    a: BrepHandle,\n    b: BrepHandle,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  fuseWithHistory(\n    a: BrepHandle,\n    b: BrepHandle,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  intersectWithHistory(\n    a: BrepHandle,\n    b: BrepHandle,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n\n  // ── 面演化 · Phase 0.1 补齐的 7 个（occt-wasm 运行时本就存在） ──\n  //\n  // ⚠️ 为什么此前只有 5 个：faijs 只绑了 boolean 与 fillet/chamfer，那 7 个在\n  // `occt-wasm@3.8.4` 的运行时**一直都在**（dist/index.d.ts:458-472 共 12 个），\n  // 只是 faijs 类型层未声明、也无人调用。补齐**不动 WASM**。\n  //\n  // ⚠️ 注意：`initOcctWasm()` 的返回类型在本文件之外已被硬断言为 BrepEngineApi\n  // （occtKernel.ts:88/95/106/112 `as unknown as`）⇒ 下方 `_AssertOcctApi`\n  // 恒真、**无校验力**。声明 ≠ 运行时存在：存在性由\n  // `packages/core/src/brep/engine/evolution-bindings.test.ts` 的冒烟测试钉住。\n\n  /** 平移 + 面演化（权威 hash→hash 映射，替代序号对齐近似）。 */\n  translateWithHistory(\n    shape: BrepHandle,\n    dx: number,\n    dy: number,\n    dz: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 绕任意轴旋转 + 面演化。`axis = {point, direction}`，`angleRad` 为**弧度**。 */\n  rotateWithHistory(\n    shape: BrepHandle,\n    axis: { point: BrepVec3; direction: BrepVec3 },\n    angleRad: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 镜像 + 面演化。`point` 为镜像面上一点，`normal` 为镜像面法向。 */\n  mirrorWithHistory(\n    shape: BrepHandle,\n    point: BrepVec3,\n    normal: BrepVec3,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 缩放 + 面演化。⚠️ 仅**均匀**缩放（`factor: number`）；非均匀走 `generalTransform`（无历史）。 */\n  scaleWithHistory(\n    shape: BrepHandle,\n    center: BrepVec3,\n    factor: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 抽壳 + 面演化。`faces` 为被移除的面（开口），`thickness` 为壁厚。 */\n  shellWithHistory(\n    solid: BrepHandle,\n    faces: BrepHandle[],\n    thickness: number,\n    tolerance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 偏移 + 面演化。 */\n  offsetWithHistory(\n    solid: BrepHandle,\n    distance: number,\n    tolerance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n  /** 加厚（面/壳 → 实体）+ 面演化。 */\n  thickenWithHistory(\n    shape: BrepHandle,\n    thickness: number,\n    tolerance: number,\n    inputFaceHashes: number[],\n    hashUpperBound: number,\n  ): BrepEvolutionData\n\n  // ── XCAF 装配（可选能力槽 §7.5 AssemblyCapability，Phase 1 钉死完整形态） ──\n  createXCAFDocument(): BrepXcafDocument\n  importXCAFFromSTEP(stepData: string): BrepXcafDocument\n}\n\n/**\n * 编译期完整性守卫（§7.8，抄 brepjs §3.2 的 _AssertSatisfiesKernelShape）。\n *\n * 用法（适配器里）：\n * ```ts\n * type _AssertOcct = AssertSatisfiesBrepEngineApi<Awaited<ReturnType<typeof initOcctWasm>>>\n * ```\n * 若实现类型缺少接口中的任何方法（或签名不兼容）→ tsc 报错并列出缺失属性。\n * 引擎换用 / 接口演进（Phase 1 扩到 83 项）时，失配在编译期暴露，而非运行时黑盒。\n */\nexport type AssertSatisfiesBrepEngineApi<Impl extends BrepEngineApi> = Impl\n"]}

package/dist/brep/engine/types.d.ts

@@ -156,7 +156,19 @@ export type BrepTessellationModel = 'build-time' | 'extract-time' | 'none';
  * ⇒ 引擎声明"我提供哪几个"（`BrepCapabilities.evolution`），op 声明"我要哪一个"
  * （`defineOp.capabilities`），两者**按名字求交集**（`cad-runtime/backend-dispatch.ts`）。
  */
-export type BrepEvolutionKind = 'fuse' | 'cut' | 'intersect' | 'fillet' | 'chamfer' | 'translate' | 'rotate' | 'mirror' | 'scale' | 'shell' | 'offset' | 'thicken';
+export type BrepEvolutionKind = 'fuseWithHistory' | 'cutWithHistory' | 'intersectWithHistory' | 'filletWithHistory' | 'chamferWithHistory' | 'translateWithHistory' | 'rotateWithHistory' | 'mirrorWithHistory' | 'scaleWithHistory' | 'shellWithHistory' | 'offsetWithHistory' | 'thickenWithHistory';
+/**
+ * 非演化内核方法真名（`*WithHistory` 之外的 `BrepEngineApi` 方法）。
+ *
+ * 与 `BrepEvolutionKind` 分名（P3 冲突消除）：`'mirror'` 一个字符串不能同时表示
+ * "提供 `mirrorWithHistory`"与"提供 `mirror`"，两族必须互不共用字符串。
+ * 语义与 evolution 相同——**逐核函数**声明：声明 = 实现（诚实原则），
+ * 缺省/空 = 一个都不提供。
+ *
+ * 初始全集 = Phase 0 能力映射表（`api/surface/capability-map.json`）盘点的
+ * compat op 依赖内核方法 + 方案初始项；Phase 3 全量收敛时按映射表滚动补全。
+ */
+export type BrepMethodKind = 'linearPattern' | 'circularPattern' | 'gridPattern' | 'rectangularPattern' | 'mirror' | 'rotate' | 'translate' | 'scale' | 'chamfer' | 'chamferDistAngle' | 'fillet' | 'filletVariable' | 'makeRectangle' | 'shell' | 'extrude' | 'loft' | 'loftAdvanced' | 'section' | 'sweepPipeShell' | 'simplePipe' | 'revolveVec' | 'buildExtrusionLaw' | 'fuse' | 'cut' | 'intersect' | 'fuseAll' | 'makeArcEdge' | 'makeBezierEdge' | 'makeCylinder' | 'makeEllipsoid' | 'makeFace' | 'makeFaceOnSurface' | 'makeLineEdge' | 'makeTorus' | 'makeVertex' | 'makeWireFromMixed' | 'buildEdgeOnSurface' | 'addHolesInFace' | 'buildTriFace' | 'sew' | 'sewAndSolidify' | 'healFace' | 'healSolid' | 'healWire' | 'fixShape' | 'fixSelfIntersection' | 'isValid' | 'removeDegenerateEdges' | 'simplify' | 'split' | 'boundingBox' | 'curveParameters' | 'curvePointAtParam' | 'curveTangent' | 'hullFromPoints' | 'isNull' | 'iterShapes' | 'locate' | 'shapeType' | 'surfaceCenterOfMass' | 'surfaceNormal' | 'surfaceType' | 'uvBounds' | 'composeTransform' | 'applyComposedTransformWithHistory' | 'generalTransformNonOrthogonal' | 'generalTransformWithHistory' | 'importStl' | 'createXCAFDocument' | 'importXCAFFromSTEP' | 'copyShape' | 'dispose' | 'downcast' | 'hashCode';
 /**
  * 可选能力槽声明（§7.5，Phase 1 钉死成员）。
  *
@@ -177,6 +189,11 @@ export interface BrepCapabilities {
      * `BrepEvolutionKind`）。空数组 / 缺省 = 一个都不提供。
      */
     evolution?: readonly BrepEvolutionKind[];
+    /**
+     * 非演化内核方法族：本引擎**实际提供**的 `BrepEngineApi` 方法真名
+     * （逐核声明，与 `evolution` 同语义；空数组 / 缺省 = 一个都不提供）。
+     */
+    methods?: readonly BrepMethodKind[];
     /** 修复族（healSolid/fixShape/fixFaceOrientations/...） */
     heal?: boolean;
     /** 直接编辑族（C1：moveFace/replaceFace/...） */