@faicad/faijs 0.29.5 → 0.31.1

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

@@ -6,7 +6,7 @@
  * 业务层（runtime/brep ops/api）只经注册表取引擎，不直接 import occt 初始化
  * 函数——引擎本体可整体替换（换一个适配器即换引擎）。
  *
- * Phase 3（docs/plans/2026-09-24-brep-engine-api-narrowing-native-access.md）：
+ * Phase 3：
  * 本文件不再做任何猴子补丁（旧版在 occt-wasm 单例上覆写 pattern 三方法与 33 个
  * 登记方法——全部移入 `createOcctPrimitives` 的显式对象字面量）。occt-wasm 类型
  * 耦合只存在于 occt-kernel/（A1 允许的唯一耦合区）；本文件不接触 occt-wasm 类型。
@@ -18,135 +18,6 @@ import { registerBrepEngine, hasBrepEngine, isBrepEngineRegistered } from '../re
 import { createOcctPrimitives } from '../../../occt-kernel/occt-primitives.js';
 /** OCCT 引擎注册 id（默认 BREP 引擎；首个注册自动成为默认）。 */
 export const OCCT_BREP_ENGINE_ID = 'occt';
-/**
- * OCCT 实际提供的 `*WithHistory` 核函数名（Phase 0.2：逐核函数如实声明）。
- *
- * 12 个全部由 `occt-wasm@5.6.0` 提供（`dist/index.d.ts` 的 `*WithHistory` 声明）。
- * L1 契约只含前三员 + filletWithHistory（双方都有对齐实现）；其余 8 个是 occt
- * 平台面能力（brepkit 无对应 API），存在性由本能力表如实声明，op 侧用
- * `engines: ['occt']`（Phase 5 D11）表达平台归属。
- */
-const OCCT_EVOLUTION_KINDS = [
-    'fuseWithHistory',
-    'cutWithHistory',
-    'intersectWithHistory',
-    'filletWithHistory',
-    'chamferWithHistory',
-    'translateWithHistory',
-    'rotateWithHistory',
-    'mirrorWithHistory',
-    'scaleWithHistory',
-    'shellWithHistory',
-    'offsetWithHistory',
-    'thickenWithHistory',
-];
-/**
- * 非演化内核方法全集（BrepMethodKind）——逐核如实声明（Phase 1，P2 缺口补齐）。
- *
- * ⚠️ Phase 2 修正（能力声明=可执行语义）：
- *   - 保留 `gridPattern`：occt-wasm 无原生 gridPattern，但适配器有组合实现
- *     （嵌套 linearPattern + fuseAll，见 occt-primitives.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',
-    'fuseAll',
-    'makeArcEdge',
-    'makeCircleEdge',
-    'makeBezierEdge',
-    'makeCylinder',
-    'makeEllipsoid',
-    'makeFace',
-    'makeFaceOnSurface',
-    'makeLineEdge',
-    'makeTorus',
-    'makeVertex',
-    'makeWire',
-    'makeWireFromMixed',
-    'buildEdgeOnSurface',
-    'addHolesInFace',
-    'buildTriFace',
-    'sew',
-    'sewAndSolidify',
-    'healFace',
-    'healSolid',
-    'healWire',
-    'fixShape',
-    'fixSelfIntersection',
-    'isValid',
-    'removeDegenerateEdges',
-    'simplify',
-    'split',
-    'curveParameters',
-    'curvePointAtParam',
-    'curveTangent',
-    'hullFromPoints',
-    'isNull',
-    'iterShapes',
-    'locate',
-    'shapeType',
-    'surfaceCenterOfMass',
-    'surfaceNormal',
-    'surfaceType',
-    'uvBounds',
-    // Phase 5（D5）：测量族能力名统一为 L1 中立名（getBoundingBox/getVolume/...）——
-    // vendored 面按 brepjs 自身命名（volume/area/length），core 能力表用 L1 中立名。
-    'getBoundingBox',
-    'getVolume',
-    'getSurfaceArea',
-    'getLength',
-    'getCenterOfMass',
-    'composeTransform',
-    'applyComposedTransformWithHistory',
-    'generalTransformNonOrthogonal',
-    'generalTransformWithHistory',
-    'importStl',
-    'createXCAFDocument',
-    'importXCAFFromSTEP',
-    'copyShape',
-    'dispose',
-    'downcast',
-    'hashCode',
-    // chamfer/fillet 基础方法（directEdit 族逐核真名；occt-wasm 原生提供）
-    'chamfer',
-    'chamferDistAngle',
-    'fillet',
-    'filletVariable',
-    // 2026-09-26 B 批：rotate/applyMatrix 从 engines:[occt] 降级为能力路由后，occt 侧须
-    // 如实声明 transform(:228，BRepBuilderAPI_Transform 深拷贝，STEP-safe)/
-    // generalTransform(:231，gp_GTrsf)——此前两方法在 primitives 上实现但未登记进能力表。
-    'transform',
-    'generalTransform',
-    // 2026-09-26 C batch: section/drill/pocket/boss/mirrorJoin downgrade - OCCT already implements
-    // sectionByPlane(:162)/makeCompound(:285)/located(:229)/getSubShapes(:314) but previously undeclared
-    // (engines:[occt] bypassed the gate). Now declared honestly for capability routing.
-    'sectionByPlane',
-    'makeCompound',
-    'located',
-    'getSubShapes',
-];
 /**
  * 装配 OCCT BREP 引擎（宿主启动时调用一次，幂等）。
  *
@@ -161,26 +32,11 @@ export async function registerOcctBrepEngine() {
     registerBrepEngine(OCCT_BREP_ENGINE_ID, async () => ({
         id: OCCT_BREP_ENGINE_ID,
         primitives,
-        capabilities: {
-            // 面演化：逐核函数名单（不是族级布尔——见 BrepEvolutionKind）。
-            evolution: OCCT_EVOLUTION_KINDS,
-            // 非演化内核方法：逐核如实声明（Phase 1，P2 缺口补齐；op 声明按此静态判定）。
-            methods: OCCT_METHOD_KINDS,
-            heal: true,
-            directEdit: true,
-            advSurface: true,
-            assembly: true,
-            // P7 并入（D4）：OCCT 是精确 B-rep 内核——如实声明 brepjs KernelCapabilities 字段。
-            exact: true,
-            brepExport: true,
-            exactMeasurement: true,
-            tessellationModel: 'extract-time',
-        },
     }));
     // 2026-09-25 core-decouple Phase 2（§5.1）：删除 occt-kernel-bridge 后，本注册
-    // 流程只管 core 引擎注册表，不再向 vendored kernel registry 注入——vendored
-    // 兼容面（compat op）由 Phase 3 逐批自有化替换；中间态下需要 vendored 面的
-    // 宿主/测试自行装配 vendored registry。
+    // 流程只管 core 引擎注册表，不再向旧 kernel registry 注入——compat
+    // 兼容面（compat op）由 Phase 3 逐批自有化替换；中间态下需要 compat 面的
+    // 宿主/测试自行装配 registry。
 }
 /**
  * 内置默认 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":"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","sourcesContent":["/**\n * engine/adapters/occt — OCCT BREP 引擎适配器（槽位 1 的默认实现）\n *\n * 本文件是「occt 引擎实现」的注册入口：把 `createOcctPrimitives()`（occt-kernel/\n * occt-primitives.ts，L1 契约 `BrepEngineApi` 的 occt 显式实现）注册进引擎注册表。\n * 业务层（runtime/brep ops/api）只经注册表取引擎，不直接 import occt 初始化\n * 函数——引擎本体可整体替换（换一个适配器即换引擎）。\n *\n * Phase 3（docs/plans/2026-09-24-brep-engine-api-narrowing-native-access.md）：\n * 本文件不再做任何猴子补丁（旧版在 occt-wasm 单例上覆写 pattern 三方法与 33 个\n * 登记方法——全部移入 `createOcctPrimitives` 的显式对象字面量）。occt-wasm 类型\n * 耦合只存在于 occt-kernel/（A1 允许的唯一耦合区）；本文件不接触 occt-wasm 类型。\n *\n * 平台独有能力（loft 族、工具实体 section/split、L1 三员之外的 *WithHistory、\n * XCAF 等）不在 L1 契约里——平台代码经原生面 `getOcctKernel()`（D3）访问。\n */\n\nimport { registerBrepEngine, hasBrepEngine, isBrepEngineRegistered, type BrepEngine } from '../registry'\nimport type { BrepEvolutionKind, BrepMethodKind } from '../types'\nimport { createOcctPrimitives } from '../../../occt-kernel/occt-primitives'\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@5.6.0` 提供（`dist/index.d.ts` 的 `*WithHistory` 声明）。\n * L1 契约只含前三员 + filletWithHistory（双方都有对齐实现）；其余 8 个是 occt\n * 平台面能力（brepkit 无对应 API），存在性由本能力表如实声明，op 侧用\n * `engines: ['occt']`（Phase 5 D11）表达平台归属。\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 * 非演化内核方法全集（BrepMethodKind）——逐核如实声明（Phase 1，P2 缺口补齐）。\n *\n * ⚠️ Phase 2 修正（能力声明=可执行语义）：\n *   - 保留 `gridPattern`：occt-wasm 无原生 gridPattern，但适配器有组合实现\n *     （嵌套 linearPattern + fuseAll，见 occt-primitives.ts）——occt 下\n *     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  'makeCircleEdge',\n  'makeBezierEdge',\n  'makeCylinder',\n  'makeEllipsoid',\n  'makeFace',\n  'makeFaceOnSurface',\n  'makeLineEdge',\n  'makeTorus',\n  'makeVertex',\n  'makeWire',\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  'curveParameters',\n  'curvePointAtParam',\n  'curveTangent',\n  'hullFromPoints',\n  'isNull',\n  'iterShapes',\n  'locate',\n  'shapeType',\n  'surfaceCenterOfMass',\n  'surfaceNormal',\n  'surfaceType',\n  'uvBounds',\n  // Phase 5（D5）：测量族能力名统一为 L1 中立名（getBoundingBox/getVolume/...）——\n  // vendored 面按 brepjs 自身命名（volume/area/length），core 能力表用 L1 中立名。\n  'getBoundingBox',\n  'getVolume',\n  'getSurfaceArea',\n  'getLength',\n  'getCenterOfMass',\n  'composeTransform',\n  'applyComposedTransformWithHistory',\n  'generalTransformNonOrthogonal',\n  'generalTransformWithHistory',\n  'importStl',\n  'createXCAFDocument',\n  'importXCAFFromSTEP',\n  'copyShape',\n  'dispose',\n  'downcast',\n  'hashCode',\n  // chamfer/fillet 基础方法（directEdit 族逐核真名；occt-wasm 原生提供）\n  'chamfer',\n  'chamferDistAngle',\n  'fillet',\n  'filletVariable',\n  // 2026-09-26 B 批：rotate/applyMatrix 从 engines:[occt] 降级为能力路由后，occt 侧须\n  // 如实声明 transform(:228，BRepBuilderAPI_Transform 深拷贝，STEP-safe)/\n  // generalTransform(:231，gp_GTrsf)——此前两方法在 primitives 上实现但未登记进能力表。\n  'transform',\n  'generalTransform',\n  // 2026-09-26 C batch: section/drill/pocket/boss/mirrorJoin downgrade - OCCT already implements\n  // sectionByPlane(:162)/makeCompound(:285)/located(:229)/getSubShapes(:314) but previously undeclared\n  // (engines:[occt] bypassed the gate). Now declared honestly for capability routing.\n  'sectionByPlane',\n  'makeCompound',\n  'located',\n  'getSubShapes',\n] as const satisfies readonly BrepMethodKind[]\n\n/**\n * 装配 OCCT BREP 引擎（宿主启动时调用一次，幂等）。\n *\n * 预初始化 `createOcctPrimitives()`（内部 await initOcctWasm）：wasm 加载完成后\n * 立即注册——保证注册返回后内核单例已就绪。幂等：已注册（含运行时默认装配或\n * 宿主先行注册）则跳过注册，仅确保 wasm 预初始化。\n */\nexport async function registerOcctBrepEngine(): Promise<void> {\n  const primitives = await createOcctPrimitives()\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      // 非演化内核方法：逐核如实声明（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  // 2026-09-25 core-decouple Phase 2（§5.1）：删除 occt-kernel-bridge 后，本注册\n  // 流程只管 core 引擎注册表，不再向 vendored kernel registry 注入——vendored\n  // 兼容面（compat op）由 Phase 3 逐批自有化替换；中间态下需要 vendored 面的\n  // 宿主/测试自行装配 vendored registry。\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"]}
+{"version":3,"file":"occt.js","sourceRoot":"","sources":["../../../../src/brep/engine/adapters/occt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,sBAAsB,EAAmB,MAAM,aAAa,CAAA;AACxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAE3E,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AAEzC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,UAAU,GAAG,MAAM,oBAAoB,EAAE,CAAA;IAC/C,IAAI,sBAAsB,CAAC,mBAAmB,CAAC;QAAE,OAAM;IACvD,kBAAkB,CAAC,mBAAmB,EAAE,KAAK,IAAyB,EAAE,CAAC,CAAC;QACxE,EAAE,EAAE,mBAAmB;QACvB,UAAU;KACX,CAAC,CAAC,CAAA;IACH,qEAAqE;IACrE,kDAAkD;IAClD,mDAAmD;IACnD,sBAAsB;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,IAAI,aAAa,EAAE;QAAE,OAAM;IAC3B,MAAM,sBAAsB,EAAE,CAAA;AAChC,CAAC","sourcesContent":["/**\r\n * engine/adapters/occt — OCCT BREP 引擎适配器（槽位 1 的默认实现）\r\n *\r\n * 本文件是「occt 引擎实现」的注册入口：把 `createOcctPrimitives()`（occt-kernel/\r\n * occt-primitives.ts，L1 契约 `BrepEngineApi` 的 occt 显式实现）注册进引擎注册表。\r\n * 业务层（runtime/brep ops/api）只经注册表取引擎，不直接 import occt 初始化\r\n * 函数——引擎本体可整体替换（换一个适配器即换引擎）。\r\n *\r\n * Phase 3：\r\n * 本文件不再做任何猴子补丁（旧版在 occt-wasm 单例上覆写 pattern 三方法与 33 个\r\n * 登记方法——全部移入 `createOcctPrimitives` 的显式对象字面量）。occt-wasm 类型\r\n * 耦合只存在于 occt-kernel/（A1 允许的唯一耦合区）；本文件不接触 occt-wasm 类型。\r\n *\r\n * 平台独有能力（loft 族、工具实体 section/split、L1 三员之外的 *WithHistory、\r\n * XCAF 等）不在 L1 契约里——平台代码经原生面 `getOcctKernel()`（D3）访问。\r\n */\r\n\r\nimport { registerBrepEngine, hasBrepEngine, isBrepEngineRegistered, type BrepEngine } from '../registry'\r\nimport { createOcctPrimitives } from '../../../occt-kernel/occt-primitives'\r\n\r\n/** OCCT 引擎注册 id（默认 BREP 引擎；首个注册自动成为默认）。 */\r\nexport const OCCT_BREP_ENGINE_ID = 'occt'\r\n\r\n/**\r\n * 装配 OCCT BREP 引擎（宿主启动时调用一次，幂等）。\r\n *\r\n * 预初始化 `createOcctPrimitives()`（内部 await initOcctWasm）：wasm 加载完成后\r\n * 立即注册——保证注册返回后内核单例已就绪。幂等：已注册（含运行时默认装配或\r\n * 宿主先行注册）则跳过注册，仅确保 wasm 预初始化。\r\n */\r\nexport async function registerOcctBrepEngine(): Promise<void> {\r\n  const primitives = await createOcctPrimitives()\r\n  if (isBrepEngineRegistered(OCCT_BREP_ENGINE_ID)) return\r\n  registerBrepEngine(OCCT_BREP_ENGINE_ID, async (): Promise<BrepEngine> => ({\r\n    id: OCCT_BREP_ENGINE_ID,\r\n    primitives,\r\n  }))\r\n  // 2026-09-25 core-decouple Phase 2（§5.1）：删除 occt-kernel-bridge 后，本注册\r\n  // 流程只管 core 引擎注册表，不再向旧 kernel registry 注入——compat\r\n  // 兼容面（compat op）由 Phase 3 逐批自有化替换；中间态下需要 compat 面的\r\n  // 宿主/测试自行装配 registry。\r\n}\r\n\r\n/**\r\n * 内置默认 BREP 引擎装配（OCCT）：宿主未注册任何引擎时的缺省值。\r\n *\r\n * OCCT 是 faijs 的默认 BREP 引擎——低频率、静态的替换：换引擎 = 宿主在\r\n * 装配期显式注册其它引擎（首个注册者为默认），或改本处默认。宿主无需为\r\n * 每次使用自行提供引擎；本函数幂等，已注册任何引擎则 no-op。\r\n */\r\nexport async function ensureOcctDefaultEngine(): Promise<void> {\r\n  if (hasBrepEngine()) return\r\n  await registerOcctBrepEngine()\r\n}\r\n"]}

package/dist/brep/engine/native-history.d.ts

@@ -0,0 +1,27 @@
+/**
+ * native-history — 引擎是否原生提供某个 `*WithHistory` 面演化核函数。
+ *
+ * op 实现体内选实现轨（调 `*WithHistory` 还是裸方法）时读这里：这是一条**引擎事实**，
+ * 与 op 无关，因此不挂在 op 声明上，也没有任何"能力表"参与——「引擎能不能做这件事」
+ * 由引擎身份静态决定，写代码的时刻就是常量。
+ *
+ * 两个真实引擎的事实（本模块是唯一归属，别处不再声明）：
+ * - `occt`：12 个 `*WithHistory` 全有（`occt-wasm@5.6.0` 原生导出）。
+ * - `brepkit`：只有 `fuseWithHistory` / `cutWithHistory` / `filletWithHistory`
+ *   （`brepkit-kernel/brepkitKernel.ts` 的面演化三员，其余为 `unsupported(...)` 桩）。
+ *
+ * 未知 / 未装配引擎（含测试替身 `brep_mock`）→ 一律 `false`：拿不到事实时按"没有"处理，
+ * 让 op 走裸方法轨（几何仍正确，只是不产面演化），绝不假设引擎有历史。
+ *
+ * 零重依赖：只读运行期装配配置（引擎 id），不 import 任何平台内核。
+ */
+import type { BrepEvolutionKind } from './types.js';
+/**
+ * 当前 BREP 引擎是否原生实现该 `*WithHistory`（静态；读引擎身份，不读任何声明表）。
+ *
+ * @param kind - the evolution kernel function name to test.
+ * @returns true when the current engine natively implements it; false otherwise
+ * (including when no engine is assembled / the engine is unknown).
+ */
+export declare function hasNativeHistory(kind: BrepEvolutionKind): boolean;
+//# sourceMappingURL=native-history.d.ts.map

package/dist/brep/engine/native-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-history.d.ts","sourceRoot":"","sources":["../../../src/brep/engine/native-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AA2BhD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAGjE"}

package/dist/brep/engine/native-history.js

@@ -0,0 +1,54 @@
+/**
+ * native-history — 引擎是否原生提供某个 `*WithHistory` 面演化核函数。
+ *
+ * op 实现体内选实现轨（调 `*WithHistory` 还是裸方法）时读这里：这是一条**引擎事实**，
+ * 与 op 无关，因此不挂在 op 声明上，也没有任何"能力表"参与——「引擎能不能做这件事」
+ * 由引擎身份静态决定，写代码的时刻就是常量。
+ *
+ * 两个真实引擎的事实（本模块是唯一归属，别处不再声明）：
+ * - `occt`：12 个 `*WithHistory` 全有（`occt-wasm@5.6.0` 原生导出）。
+ * - `brepkit`：只有 `fuseWithHistory` / `cutWithHistory` / `filletWithHistory`
+ *   （`brepkit-kernel/brepkitKernel.ts` 的面演化三员，其余为 `unsupported(...)` 桩）。
+ *
+ * 未知 / 未装配引擎（含测试替身 `brep_mock`）→ 一律 `false`：拿不到事实时按"没有"处理，
+ * 让 op 走裸方法轨（几何仍正确，只是不产面演化），绝不假设引擎有历史。
+ *
+ * 零重依赖：只读运行期装配配置（引擎 id），不 import 任何平台内核。
+ */
+import { getBackends } from '../../runtime-state.js';
+/**
+ * 各引擎**原生提供**的面演化核函数（常量表，非运行时探测）。
+ *
+ * 为什么是常量而不是"探测实现面"：所有适配器的 `*WithHistory` 成员都在 API 对象里
+ * **有函数**——没实现的也放一个 `unsupported(...)` 桩，故
+ * `typeof api.xWithHistory === 'function'` 恒为真，探测不出"真有还是桩"。
+ */
+const NATIVE_HISTORY_BY_ENGINE = {
+    occt: [
+        'fuseWithHistory',
+        'cutWithHistory',
+        'intersectWithHistory',
+        'filletWithHistory',
+        'chamferWithHistory',
+        'translateWithHistory',
+        'rotateWithHistory',
+        'mirrorWithHistory',
+        'scaleWithHistory',
+        'shellWithHistory',
+        'offsetWithHistory',
+        'thickenWithHistory',
+    ],
+    brepkit: ['fuseWithHistory', 'cutWithHistory', 'filletWithHistory'],
+};
+/**
+ * 当前 BREP 引擎是否原生实现该 `*WithHistory`（静态；读引擎身份，不读任何声明表）。
+ *
+ * @param kind - the evolution kernel function name to test.
+ * @returns true when the current engine natively implements it; false otherwise
+ * (including when no engine is assembled / the engine is unknown).
+ */
+export function hasNativeHistory(kind) {
+    const engineId = getBackends().config.brepEngineId;
+    return engineId != null && (NATIVE_HISTORY_BY_ENGINE[engineId]?.includes(kind) ?? false);
+}
+//# sourceMappingURL=native-history.js.map

package/dist/brep/engine/native-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-history.js","sourceRoot":"","sources":["../../../src/brep/engine/native-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGjD;;;;;;GAMG;AACH,MAAM,wBAAwB,GAA2D;IACvF,IAAI,EAAE;QACJ,iBAAiB;QACjB,gBAAgB;QAChB,sBAAsB;QACtB,mBAAmB;QACnB,oBAAoB;QACpB,sBAAsB;QACtB,mBAAmB;QACnB,mBAAmB;QACnB,kBAAkB;QAClB,kBAAkB;QAClB,mBAAmB;QACnB,oBAAoB;KACrB;IACD,OAAO,EAAE,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;CACpE,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,YAAY,CAAA;IAClD,OAAO,QAAQ,IAAI,IAAI,IAAI,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAA;AAC1F,CAAC","sourcesContent":["/**\n * native-history — 引擎是否原生提供某个 `*WithHistory` 面演化核函数。\n *\n * op 实现体内选实现轨（调 `*WithHistory` 还是裸方法）时读这里：这是一条**引擎事实**，\n * 与 op 无关，因此不挂在 op 声明上，也没有任何\"能力表\"参与——「引擎能不能做这件事」\n * 由引擎身份静态决定，写代码的时刻就是常量。\n *\n * 两个真实引擎的事实（本模块是唯一归属，别处不再声明）：\n * - `occt`：12 个 `*WithHistory` 全有（`occt-wasm@5.6.0` 原生导出）。\n * - `brepkit`：只有 `fuseWithHistory` / `cutWithHistory` / `filletWithHistory`\n *   （`brepkit-kernel/brepkitKernel.ts` 的面演化三员，其余为 `unsupported(...)` 桩）。\n *\n * 未知 / 未装配引擎（含测试替身 `brep_mock`）→ 一律 `false`：拿不到事实时按\"没有\"处理，\n * 让 op 走裸方法轨（几何仍正确，只是不产面演化），绝不假设引擎有历史。\n *\n * 零重依赖：只读运行期装配配置（引擎 id），不 import 任何平台内核。\n */\n\nimport { getBackends } from '../../runtime-state'\nimport type { BrepEvolutionKind } from './types'\n\n/**\n * 各引擎**原生提供**的面演化核函数（常量表，非运行时探测）。\n *\n * 为什么是常量而不是\"探测实现面\"：所有适配器的 `*WithHistory` 成员都在 API 对象里\n * **有函数**——没实现的也放一个 `unsupported(...)` 桩，故\n * `typeof api.xWithHistory === 'function'` 恒为真，探测不出\"真有还是桩\"。\n */\nconst NATIVE_HISTORY_BY_ENGINE: Readonly<Record<string, readonly BrepEvolutionKind[]>> = {\n  occt: [\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  ],\n  brepkit: ['fuseWithHistory', 'cutWithHistory', 'filletWithHistory'],\n}\n\n/**\n * 当前 BREP 引擎是否原生实现该 `*WithHistory`（静态；读引擎身份，不读任何声明表）。\n *\n * @param kind - the evolution kernel function name to test.\n * @returns true when the current engine natively implements it; false otherwise\n * (including when no engine is assembled / the engine is unknown).\n */\nexport function hasNativeHistory(kind: BrepEvolutionKind): boolean {\n  const engineId = getBackends().config.brepEngineId\n  return engineId != null && (NATIVE_HISTORY_BY_ENGINE[engineId]?.includes(kind) ?? false)\n}\n"]}

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

@@ -1,8 +1,7 @@
 /**
  * engine/primitives — BREP 引擎契约面（port 面，L1 核心面）
  *
- * ⚠️ 2026-09-24 契约面收窄（docs/plans/2026-09-24-brep-engine-api-narrowing-native-access.md
- * §Phase 2 / D1 / D9 / D10）：`BrepEngineApi` 的语义 = **所有已注册 BREP 引擎都真实现的
+ * ⚠️ 2026-09-24 契约面收窄（Phase 2 / D1 / D9 / D10）：`BrepEngineApi` 的语义 = **所有已注册 BREP 引擎都真实现的
  * 方法**（occt 与 brepkit 双方语义可对齐的交集面，最大化口径）。判据唯一真源：
  * `api/surface/engine-method-map.json`（status ∈ {aligned, dialect} 的条目）。
  *
@@ -140,7 +139,7 @@ export interface BrepEngineApi {
     isSame(a: BrepHandle, b: BrepHandle): boolean;
     isSolid(shape: BrepHandle): boolean;
     /** 形状类型名（'SOLID' / 'FACE' / 'EDGE' / 'WIRE' / 'COMPOUND' 等；引擎方言归一）。
-     * 库桥（l3-bridge）构造借入视图时读；brepkit/mock 按能力防御返回。 */
+     * 库桥（l3-bridge）收编产物时判类型读；brepkit/mock 按能力防御返回。 */
     shapeType(shape: BrepHandle): string;
     /** 方向标识（与内核 ShapeOrientation 同构：'forward'|'reversed'|'internal'|'external'）。 */
     shapeOrientation(shape: BrepHandle): string;

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

@@ -1,8 +1,7 @@
 /**
  * engine/primitives — BREP 引擎契约面（port 面，L1 核心面）
  *
- * ⚠️ 2026-09-24 契约面收窄（docs/plans/2026-09-24-brep-engine-api-narrowing-native-access.md
- * §Phase 2 / D1 / D9 / D10）：`BrepEngineApi` 的语义 = **所有已注册 BREP 引擎都真实现的
+ * ⚠️ 2026-09-24 契约面收窄（Phase 2 / D1 / D9 / D10）：`BrepEngineApi` 的语义 = **所有已注册 BREP 引擎都真实现的
  * 方法**（occt 与 brepkit 双方语义可对齐的交集面，最大化口径）。判据唯一真源：
  * `api/surface/engine-method-map.json`（status ∈ {aligned, dialect} 的条目）。
  *

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

@@ -1 +1 @@
-{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/brep/engine/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG","sourcesContent":["/**\n * engine/primitives — BREP 引擎契约面（port 面，L1 核心面）\n *\n * ⚠️ 2026-09-24 契约面收窄（docs/plans/2026-09-24-brep-engine-api-narrowing-native-access.md\n * §Phase 2 / D1 / D9 / D10）：`BrepEngineApi` 的语义 = **所有已注册 BREP 引擎都真实现的\n * 方法**（occt 与 brepkit 双方语义可对齐的交集面，最大化口径）。判据唯一真源：\n * `api/surface/engine-method-map.json`（status ∈ {aligned, dialect} 的条目）。\n *\n * - 移出 L1 的方法（occt-only 语义）不再有中立名，平台代码直接走原生面：\n *   `getOcctKernel()` / `getBrepkitKernel()`（D3），op 侧用 `engines: ['occt']` 声明（D11）。\n * - 禁止任何 `as BrepEngineApi` 跨层断言（守卫见 §5 守卫清单）。\n * - 三个适配器的编译期断言 `_Assert*Api` 由此全部获得真校验力。\n */\n\nimport type {\n  BrepBoundingBox,\n  BrepCurveParameters,\n  BrepEdgeData,\n  BrepEvolutionData,\n  BrepHandle,\n  BrepMeshResult,\n  BrepNurbsCurveData,\n  BrepSubShapeType,\n  BrepTessellateOptions,\n  BrepUvBounds,\n  BrepVec3,\n} from './types'\n\n/**\n * BREP 引擎原语契约（L1 核心面）。所有句柄参数/返回值均为 BrepHandle（不透明值，§6.3）。\n * 引擎实现（occt/brepkit 适配器）负责内部句柄形态与 BrepHandle 的转换，以及方言消化\n * （如 brepkit surfaceArea → getSurfaceArea，与 matrix 方言的 toKernelMatrix 同构）。\n */\nexport interface BrepEngineApi {\n  // ── 生命周期 ──\n  /** 手工释放句柄（GC 型引擎实现为 no-op）。 */\n  release(shape: BrepHandle): void\n  /** 释放内核/句柄（引擎级释放语义；brepkit GC 型 no-op）。 */\n  dispose(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  makeEllipsoid(rx: number, ry: number, rz: number): BrepHandle\n  makeTorus(majorRadius: number, minorRadius: number): BrepHandle\n  makeVertex(x: number, y: number, z: number): BrepHandle\n\n  // ── 造型运算 ──\n  /**\n   * 挤出：`{dx,dy,dz}` 为挤出向量（occt 方言）。\n   * brepkit 方言（方向+距离、只吃 face）由适配器归一：`len = |v|`、`dir = v/len`；\n   * `len === 0` 抛错；输入不是 face → 报错（显式失败，不静默降级，§3.6-1）。\n   */\n  extrude(shape: BrepHandle, dx: number, dy: number, dz: number): BrepHandle\n  /** 旋转挤出（绕过 center、方向 direction 的轴，angle 为度；输入需 face，brepkit 方言断言同 extrude）。 */\n  revolveVec(shape: BrepHandle, center: BrepVec3, direction: BrepVec3, angleDeg: number): BrepHandle\n  /** 缝合（tolerance 可选）。 */\n  sew(shapes: BrepHandle[], tolerance?: number): BrepHandle\n  /** 缝合并固化成实体。 */\n  sewAndSolidify(faces: BrepHandle[], tolerance?: number): BrepHandle\n  /** 抽壳（facesToRemove 移除面、thickness 壁厚、tolerance 容差）。 */\n  shell(solid: BrepHandle, facesToRemove: BrepHandle[], thickness: number, tolerance: number): BrepHandle\n  /** 点集凸包（tolerance 为容差）。 */\n  hullFromPoints(points: BrepVec3[], tolerance: number): 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  fuseAll(shapes: BrepHandle[]): BrepHandle\n  /**\n   * 平面求交线：solid 与「过 point、法向 normal 的无限平面」的交线（§3.6-2 新中立名）。\n   * occt 适配器：大平面 face 作 tool 经原生 section 达成（Phase 1 探针 A 实测可达）。\n   * 返回交线/顶点句柄数组（brepkit 返回 Uint32Array 句柄组，occt compound downcast 展开）。\n   */\n  sectionByPlane(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle[]\n  /**\n   * 平面二分：把 solid 沿「过 point、法向 normal 的无限平面」切成两半（§3.6-2 新中立名）。\n   * occt 适配器：大平面 face 作 tool 经原生 splitter 达成（Phase 1 探针 A 实测，solidCount=2）。\n   * 法向正侧 = `positive`（§3.7 返回口径）。\n   */\n  splitByPlane(\n    shape: BrepHandle,\n    point: BrepVec3,\n    normal: BrepVec3,\n  ): { positive: BrepHandle; negative: BrepHandle }\n\n  // ── 倒角与圆角（Q7：只对齐等距 + 距角两种粒度）──\n  /** 等距倒角：逐边 `BRepFilletAPI_MakeChamfer::Add(distance, E)`。 */\n  chamfer(solid: BrepHandle, edges: BrepHandle[], distance: number): BrepHandle\n  /**\n   * 距角倒角：`AddDA(distance, angleDeg, E, F)`（brepkit 原生 chamferDistanceAngle，方言映射）。\n   * ⚠️ F 由内核自选（外层第一个含该边的面），调用方不可指定。\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  /** 变半径圆角：单边 `Add(startRadius, endRadius, E)`（brepkit 吃 json 描述，适配器消化）。 */\n  filletVariable(solid: BrepHandle, edge: BrepHandle, startRadius: number, endRadius: number): BrepHandle\n  /**\n   * 等半径圆角（带面演化）：modified/generated/deleted 用面 hash 编码（§7.5）。\n   * brepkit 原生 filletWithEvolution，适配器映射。\n   */\n  filletWithHistory(\n    solid: BrepHandle,\n    edges: BrepHandle[],\n    radius: 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  locate(shape: BrepHandle, matrix: number[]): BrepHandle\n  /** 一般变换（3×4 行主序 12 元素）。 */\n  generalTransform(shape: BrepHandle, matrix: number[]): BrepHandle\n  copy(shape: BrepHandle): BrepHandle\n  /** 复制句柄（独立引用计数）。 */\n  copyShape(shape: BrepHandle): BrepHandle\n  /** 组合两个 3×4 行主序变换矩阵（12 元素）。 */\n  composeTransform(m1: number[], m2: number[]): number[]\n  /** 镜像（过 point、法向 normal 的平面）。 */\n  mirror(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle\n\n  // ── 阵列 ──\n  // 口径：两内核的 pattern 内核函数都返回 compound（含全部副本），适配器负责拆成数组。\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  // ── 曲线构造 ──\n  makeLineEdge(start: BrepVec3, end: BrepVec3): BrepHandle\n  makeArcEdge(start: BrepVec3, mid: BrepVec3, end: BrepVec3): BrepHandle\n  makeBezierEdge(controlPoints: BrepVec3[]): BrepHandle\n  /**\n   * Exact NURBS edge from raw control data — the write-side counterpart of\n   * `getNurbsCurveData`, so a rational / multi-span curve survives a round trip\n   * instead of being tessellated.\n   *\n   * `poles` is flat `[x,y,z, …]`; `knots`/`multiplicities` are parallel (the\n   * expanded knot vector is `knots[i]` repeated `multiplicities[i]` times). The\n   * built edge spans the WHOLE curve — to reproduce an edge that is a sub-range\n   * of its basis curve, trim it with `curveSplit`.\n   */\n  makeBSplineEdge(\n    poles: number[],\n    weights: number[],\n    knots: number[],\n    multiplicities: number[],\n    degree: number,\n    periodic?: boolean,\n  ): BrepHandle\n  makeCircleEdge(center: BrepVec3, normal: BrepVec3, radius: number): BrepHandle\n  /**\n   * Split an edge at an interior parameter into its two sub-edges, in order.\n   * The parameter must be STRICTLY inside the edge's domain — splitting at an\n   * end is rejected by the kernel rather than returning a degenerate pair.\n   */\n  curveSplit(edge: BrepHandle, param: number): [BrepHandle, BrepHandle]\n\n  // ── 拓扑构造 ──\n  makeWire(edges: BrepHandle[]): BrepHandle\n  makeFace(wire: BrepHandle): BrepHandle\n  makeCompound(shapes: BrepHandle[]): BrepHandle\n  addHolesInFace(face: BrepHandle, holeWires: BrepHandle[]): BrepHandle\n  /** 三角面（三顶点）。 */\n  buildTriFace(a: BrepVec3, b: BrepVec3, c: BrepVec3): 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  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  /** 形状类型名（'SOLID' / 'FACE' / 'EDGE' / 'WIRE' / 'COMPOUND' 等；引擎方言归一）。\n   * 库桥（l3-bridge）构造借入视图时读；brepkit/mock 按能力防御返回。 */\n  shapeType(shape: BrepHandle): string\n  /** 方向标识（与内核 ShapeOrientation 同构：'forward'|'reversed'|'internal'|'external'）。 */\n  shapeOrientation(shape: BrepHandle): string\n  /** 边→面关联（brepkit 原生同名）。 */\n  edgeToFaceMap(shape: BrepHandle): unknown\n  /** 面的相邻面（同一 solid 内与 face 共享边的面；两内核原生都吃 (shape, face)）。 */\n  adjacentFaces(shape: BrepHandle, face: BrepHandle): BrepHandle[]\n  /** 两面共享的边。 */\n  sharedEdges(a: BrepHandle, b: BrepHandle): BrepHandle[]\n\n  // ── 几何求值 ──\n  /** 曲线类型标识（与内核 CurveKind 同构的中立字符串形态）。 */\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  /** 曲面质心。 */\n  surfaceCenterOfMass(face: BrepHandle): BrepVec3\n  /** Phase 1 钉死返回形态（topologyExt 仅读 radius）。 */\n  getFaceCylinderData(face: BrepHandle): { radius: number } | null\n  /**\n   * NURBS control data of the edge's basis curve, or `null` for the analytic\n   * kinds (line / circle / ellipse / hyperbola / parabola).\n   *\n   * ⚠️ Two measured behaviours (2026-09-29) that the name does not imply:\n   *  · it THROWS — it is not a nullable getter — when the edge is not a B-spline\n   *    or Bézier, so callers must guard, not just null-check;\n   *  · it returns the WHOLE basis curve, while `curveParameters` returns the\n   *    EDGE's trim range on it; rebuilding without the trim is not faithful.\n   */\n  getNurbsCurveData(edge: BrepHandle): BrepNurbsCurveData | null\n  interpolatePoints(points: BrepVec3[], degree: number): BrepHandle\n\n  /** 去特征（移除面集合）。 */\n  defeature(shape: BrepHandle, faces: BrepHandle[]): BrepHandle\n  /** 拔模。 */\n  draft(shape: BrepHandle, faces: BrepHandle[], pull: BrepVec3, neutral: BrepVec3, angleDeg: number): BrepHandle\n  removeHolesFromFace(face: BrepHandle): BrepHandle\n  reverseShape(shape: BrepHandle): BrepHandle\n  /** 边投影（方言参数由适配器消化）。 */\n  projectEdges(shape: BrepHandle, origin: BrepVec3, direction: BrepVec3, xAxis: BrepVec3, hiddenLines: boolean, deflection: number): unknown\n\n  // ── 测量（D5/D6：核心面只进双方都有的；linearCenterOfMass/inertia/distance 是 L2 平台面）──\n  getBoundingBox(shape: BrepHandle, useTriangulation?: boolean): BrepBoundingBox\n  getVolume(shape: BrepHandle): number\n  getCenterOfMass(shape: BrepHandle): BrepVec3\n  /** 表面积（D6：面积进 L1；brepkit 原生 surfaceArea/faceArea，适配器映射）。 */\n  getSurfaceArea(shape: BrepHandle): number\n  /** 长度（D6：进 L1；brepkit 原生 length/wireLength，wire 与 edge 入参差异由适配器判别）。 */\n  getLength(shape: BrepHandle): number\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, tolerance?: number): 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  // ── 面演化（仅双方都有原生/可对齐实现的三员，D1）──\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\n/**\n * 编译期完整性断言（D1）：实现类型必须逐成员满足 L1 核心面。\n * 三处守卫 `_AssertOcctApi` / `_AssertBrepkitApi` / `_AssertBrepMockApi` 同时生效。\n */\nexport type AssertSatisfiesBrepEngineApi<Impl extends BrepEngineApi> = Impl\n"]}
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/brep/engine/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG","sourcesContent":["/**\n * engine/primitives — BREP 引擎契约面（port 面，L1 核心面）\n *\n * ⚠️ 2026-09-24 契约面收窄（Phase 2 / D1 / D9 / D10）：`BrepEngineApi` 的语义 = **所有已注册 BREP 引擎都真实现的\n * 方法**（occt 与 brepkit 双方语义可对齐的交集面，最大化口径）。判据唯一真源：\n * `api/surface/engine-method-map.json`（status ∈ {aligned, dialect} 的条目）。\n *\n * - 移出 L1 的方法（occt-only 语义）不再有中立名，平台代码直接走原生面：\n *   `getOcctKernel()` / `getBrepkitKernel()`（D3），op 侧用 `engines: ['occt']` 声明（D11）。\n * - 禁止任何 `as BrepEngineApi` 跨层断言（守卫见 §5 守卫清单）。\n * - 三个适配器的编译期断言 `_Assert*Api` 由此全部获得真校验力。\n */\n\nimport type {\n  BrepBoundingBox,\n  BrepCurveParameters,\n  BrepEdgeData,\n  BrepEvolutionData,\n  BrepHandle,\n  BrepMeshResult,\n  BrepNurbsCurveData,\n  BrepSubShapeType,\n  BrepTessellateOptions,\n  BrepUvBounds,\n  BrepVec3,\n} from './types'\n\n/**\n * BREP 引擎原语契约（L1 核心面）。所有句柄参数/返回值均为 BrepHandle（不透明值，§6.3）。\n * 引擎实现（occt/brepkit 适配器）负责内部句柄形态与 BrepHandle 的转换，以及方言消化\n * （如 brepkit surfaceArea → getSurfaceArea，与 matrix 方言的 toKernelMatrix 同构）。\n */\nexport interface BrepEngineApi {\n  // ── 生命周期 ──\n  /** 手工释放句柄（GC 型引擎实现为 no-op）。 */\n  release(shape: BrepHandle): void\n  /** 释放内核/句柄（引擎级释放语义；brepkit GC 型 no-op）。 */\n  dispose(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  makeEllipsoid(rx: number, ry: number, rz: number): BrepHandle\n  makeTorus(majorRadius: number, minorRadius: number): BrepHandle\n  makeVertex(x: number, y: number, z: number): BrepHandle\n\n  // ── 造型运算 ──\n  /**\n   * 挤出：`{dx,dy,dz}` 为挤出向量（occt 方言）。\n   * brepkit 方言（方向+距离、只吃 face）由适配器归一：`len = |v|`、`dir = v/len`；\n   * `len === 0` 抛错；输入不是 face → 报错（显式失败，不静默降级，§3.6-1）。\n   */\n  extrude(shape: BrepHandle, dx: number, dy: number, dz: number): BrepHandle\n  /** 旋转挤出（绕过 center、方向 direction 的轴，angle 为度；输入需 face，brepkit 方言断言同 extrude）。 */\n  revolveVec(shape: BrepHandle, center: BrepVec3, direction: BrepVec3, angleDeg: number): BrepHandle\n  /** 缝合（tolerance 可选）。 */\n  sew(shapes: BrepHandle[], tolerance?: number): BrepHandle\n  /** 缝合并固化成实体。 */\n  sewAndSolidify(faces: BrepHandle[], tolerance?: number): BrepHandle\n  /** 抽壳（facesToRemove 移除面、thickness 壁厚、tolerance 容差）。 */\n  shell(solid: BrepHandle, facesToRemove: BrepHandle[], thickness: number, tolerance: number): BrepHandle\n  /** 点集凸包（tolerance 为容差）。 */\n  hullFromPoints(points: BrepVec3[], tolerance: number): 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  fuseAll(shapes: BrepHandle[]): BrepHandle\n  /**\n   * 平面求交线：solid 与「过 point、法向 normal 的无限平面」的交线（§3.6-2 新中立名）。\n   * occt 适配器：大平面 face 作 tool 经原生 section 达成（Phase 1 探针 A 实测可达）。\n   * 返回交线/顶点句柄数组（brepkit 返回 Uint32Array 句柄组，occt compound downcast 展开）。\n   */\n  sectionByPlane(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle[]\n  /**\n   * 平面二分：把 solid 沿「过 point、法向 normal 的无限平面」切成两半（§3.6-2 新中立名）。\n   * occt 适配器：大平面 face 作 tool 经原生 splitter 达成（Phase 1 探针 A 实测，solidCount=2）。\n   * 法向正侧 = `positive`（§3.7 返回口径）。\n   */\n  splitByPlane(\n    shape: BrepHandle,\n    point: BrepVec3,\n    normal: BrepVec3,\n  ): { positive: BrepHandle; negative: BrepHandle }\n\n  // ── 倒角与圆角（Q7：只对齐等距 + 距角两种粒度）──\n  /** 等距倒角：逐边 `BRepFilletAPI_MakeChamfer::Add(distance, E)`。 */\n  chamfer(solid: BrepHandle, edges: BrepHandle[], distance: number): BrepHandle\n  /**\n   * 距角倒角：`AddDA(distance, angleDeg, E, F)`（brepkit 原生 chamferDistanceAngle，方言映射）。\n   * ⚠️ F 由内核自选（外层第一个含该边的面），调用方不可指定。\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  /** 变半径圆角：单边 `Add(startRadius, endRadius, E)`（brepkit 吃 json 描述，适配器消化）。 */\n  filletVariable(solid: BrepHandle, edge: BrepHandle, startRadius: number, endRadius: number): BrepHandle\n  /**\n   * 等半径圆角（带面演化）：modified/generated/deleted 用面 hash 编码（§7.5）。\n   * brepkit 原生 filletWithEvolution，适配器映射。\n   */\n  filletWithHistory(\n    solid: BrepHandle,\n    edges: BrepHandle[],\n    radius: 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  locate(shape: BrepHandle, matrix: number[]): BrepHandle\n  /** 一般变换（3×4 行主序 12 元素）。 */\n  generalTransform(shape: BrepHandle, matrix: number[]): BrepHandle\n  copy(shape: BrepHandle): BrepHandle\n  /** 复制句柄（独立引用计数）。 */\n  copyShape(shape: BrepHandle): BrepHandle\n  /** 组合两个 3×4 行主序变换矩阵（12 元素）。 */\n  composeTransform(m1: number[], m2: number[]): number[]\n  /** 镜像（过 point、法向 normal 的平面）。 */\n  mirror(shape: BrepHandle, point: BrepVec3, normal: BrepVec3): BrepHandle\n\n  // ── 阵列 ──\n  // 口径：两内核的 pattern 内核函数都返回 compound（含全部副本），适配器负责拆成数组。\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  // ── 曲线构造 ──\n  makeLineEdge(start: BrepVec3, end: BrepVec3): BrepHandle\n  makeArcEdge(start: BrepVec3, mid: BrepVec3, end: BrepVec3): BrepHandle\n  makeBezierEdge(controlPoints: BrepVec3[]): BrepHandle\n  /**\n   * Exact NURBS edge from raw control data — the write-side counterpart of\n   * `getNurbsCurveData`, so a rational / multi-span curve survives a round trip\n   * instead of being tessellated.\n   *\n   * `poles` is flat `[x,y,z, …]`; `knots`/`multiplicities` are parallel (the\n   * expanded knot vector is `knots[i]` repeated `multiplicities[i]` times). The\n   * built edge spans the WHOLE curve — to reproduce an edge that is a sub-range\n   * of its basis curve, trim it with `curveSplit`.\n   */\n  makeBSplineEdge(\n    poles: number[],\n    weights: number[],\n    knots: number[],\n    multiplicities: number[],\n    degree: number,\n    periodic?: boolean,\n  ): BrepHandle\n  makeCircleEdge(center: BrepVec3, normal: BrepVec3, radius: number): BrepHandle\n  /**\n   * Split an edge at an interior parameter into its two sub-edges, in order.\n   * The parameter must be STRICTLY inside the edge's domain — splitting at an\n   * end is rejected by the kernel rather than returning a degenerate pair.\n   */\n  curveSplit(edge: BrepHandle, param: number): [BrepHandle, BrepHandle]\n\n  // ── 拓扑构造 ──\n  makeWire(edges: BrepHandle[]): BrepHandle\n  makeFace(wire: BrepHandle): BrepHandle\n  makeCompound(shapes: BrepHandle[]): BrepHandle\n  addHolesInFace(face: BrepHandle, holeWires: BrepHandle[]): BrepHandle\n  /** 三角面（三顶点）。 */\n  buildTriFace(a: BrepVec3, b: BrepVec3, c: BrepVec3): 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  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  /** 形状类型名（'SOLID' / 'FACE' / 'EDGE' / 'WIRE' / 'COMPOUND' 等；引擎方言归一）。\n   * 库桥（l3-bridge）收编产物时判类型读；brepkit/mock 按能力防御返回。 */\n  shapeType(shape: BrepHandle): string\n  /** 方向标识（与内核 ShapeOrientation 同构：'forward'|'reversed'|'internal'|'external'）。 */\n  shapeOrientation(shape: BrepHandle): string\n  /** 边→面关联（brepkit 原生同名）。 */\n  edgeToFaceMap(shape: BrepHandle): unknown\n  /** 面的相邻面（同一 solid 内与 face 共享边的面；两内核原生都吃 (shape, face)）。 */\n  adjacentFaces(shape: BrepHandle, face: BrepHandle): BrepHandle[]\n  /** 两面共享的边。 */\n  sharedEdges(a: BrepHandle, b: BrepHandle): BrepHandle[]\n\n  // ── 几何求值 ──\n  /** 曲线类型标识（与内核 CurveKind 同构的中立字符串形态）。 */\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  /** 曲面质心。 */\n  surfaceCenterOfMass(face: BrepHandle): BrepVec3\n  /** Phase 1 钉死返回形态（topologyExt 仅读 radius）。 */\n  getFaceCylinderData(face: BrepHandle): { radius: number } | null\n  /**\n   * NURBS control data of the edge's basis curve, or `null` for the analytic\n   * kinds (line / circle / ellipse / hyperbola / parabola).\n   *\n   * ⚠️ Two measured behaviours (2026-09-29) that the name does not imply:\n   *  · it THROWS — it is not a nullable getter — when the edge is not a B-spline\n   *    or Bézier, so callers must guard, not just null-check;\n   *  · it returns the WHOLE basis curve, while `curveParameters` returns the\n   *    EDGE's trim range on it; rebuilding without the trim is not faithful.\n   */\n  getNurbsCurveData(edge: BrepHandle): BrepNurbsCurveData | null\n  interpolatePoints(points: BrepVec3[], degree: number): BrepHandle\n\n  /** 去特征（移除面集合）。 */\n  defeature(shape: BrepHandle, faces: BrepHandle[]): BrepHandle\n  /** 拔模。 */\n  draft(shape: BrepHandle, faces: BrepHandle[], pull: BrepVec3, neutral: BrepVec3, angleDeg: number): BrepHandle\n  removeHolesFromFace(face: BrepHandle): BrepHandle\n  reverseShape(shape: BrepHandle): BrepHandle\n  /** 边投影（方言参数由适配器消化）。 */\n  projectEdges(shape: BrepHandle, origin: BrepVec3, direction: BrepVec3, xAxis: BrepVec3, hiddenLines: boolean, deflection: number): unknown\n\n  // ── 测量（D5/D6：核心面只进双方都有的；linearCenterOfMass/inertia/distance 是 L2 平台面）──\n  getBoundingBox(shape: BrepHandle, useTriangulation?: boolean): BrepBoundingBox\n  getVolume(shape: BrepHandle): number\n  getCenterOfMass(shape: BrepHandle): BrepVec3\n  /** 表面积（D6：面积进 L1；brepkit 原生 surfaceArea/faceArea，适配器映射）。 */\n  getSurfaceArea(shape: BrepHandle): number\n  /** 长度（D6：进 L1；brepkit 原生 length/wireLength，wire 与 edge 入参差异由适配器判别）。 */\n  getLength(shape: BrepHandle): number\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, tolerance?: number): 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  // ── 面演化（仅双方都有原生/可对齐实现的三员，D1）──\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\n/**\n * 编译期完整性断言（D1）：实现类型必须逐成员满足 L1 核心面。\n * 三处守卫 `_AssertOcctApi` / `_AssertBrepkitApi` / `_AssertBrepMockApi` 同时生效。\n */\nexport type AssertSatisfiesBrepEngineApi<Impl extends BrepEngineApi> = Impl\n"]}

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

@@ -2,7 +2,7 @@
  * engine/registry — BREP / mesh 双槽位注册表（§6.2，R8 构建时切换）
  *
  *
- * 与 brepjs 的 registerKernel 同构（首个注册者为默认），但两张表、两套 getter——
+ * 首个注册者为默认，但两张表、两套 getter——
  * 这是 R2（双槽位正交：mesh 引擎与 BREP 引擎独立注册、单独切换）的直接落地。
  *
  * BREP 槽以「异步 provider」注册：引擎可能需异步初始化（occt-wasm 加载、
@@ -13,12 +13,10 @@
  * 装配完成后调用 freezeEngineRegistries() 冻结，冻结后任何注册尝试抛错（E2 验收）。
  */
 import type { BrepEngineApi } from './primitives.js';
-import type { BrepCapabilities } from './types.js';
-/** BREP 引擎实例（槽位 1）：原语契约 + 可选能力声明。 */
+/** BREP 引擎实例（槽位 1）：原语契约。引擎能做什么由实现本身决定，没有能力声明面。 */
 export interface BrepEngine {
     readonly id: string;
     readonly primitives: BrepEngineApi;
-    readonly capabilities?: BrepCapabilities;
 }
 /** BREP 引擎异步提供者（宿主装配时注册；引擎初始化完成后 resolve）。 */
 export type BrepEngineProvider = () => Promise<BrepEngine>;
@@ -58,7 +56,7 @@ export declare function registerMeshEngine(id: string, engine: MeshEngine): void
  */
 export declare function isMeshEngineRegistered(id: string): boolean;
 /**
- * Whether a default BREP engine is registered (none → mesh mode, equivalent to "no BREP capability").
+ * Whether a default BREP engine is registered (none → mesh mode, i.e. no BREP engine at all).
  * @returns true when a default BREP engine is registered.
  */
 export declare function hasBrepEngine(): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/brep/engine/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAA;CACzC;AAED,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,eAAe,EAAE,gBAAgB,CAAA;CAC9D;AAWD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CASjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CASvE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAcpE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAOrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAKrF;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAOtD"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/brep/engine/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAA;CACnC;AAED,8CAA8C;AAC9C,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,eAAe,EAAE,gBAAgB,CAAA;CAC9D;AAWD;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CASjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CASvE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAcpE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAOrD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAErD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,eAAe,EAAE,gBAAgB,GAAG,IAAI,CAKrF;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAOtD"}

package/dist/brep/engine/registry.js

@@ -2,7 +2,7 @@
  * engine/registry — BREP / mesh 双槽位注册表（§6.2，R8 构建时切换）
  *
  *
- * 与 brepjs 的 registerKernel 同构（首个注册者为默认），但两张表、两套 getter——
+ * 首个注册者为默认，但两张表、两套 getter——
  * 这是 R2（双槽位正交：mesh 引擎与 BREP 引擎独立注册、单独切换）的直接落地。
  *
  * BREP 槽以「异步 provider」注册：引擎可能需异步初始化（occt-wasm 加载、
@@ -67,7 +67,7 @@ export function isMeshEngineRegistered(id) {
     return meshEngines.has(id);
 }
 /**
- * Whether a default BREP engine is registered (none → mesh mode, equivalent to "no BREP capability").
+ * Whether a default BREP engine is registered (none → mesh mode, i.e. no BREP engine at all).
  * @returns true when a default BREP engine is registered.
  */
 export function hasBrepEngine() {

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

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/brep/engine/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA2BH,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAA8B,CAAA;AACjE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAsB,CAAA;AACrD,IAAI,aAAa,GAAkB,IAAI,CAAA;AAEvC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAA;AACjD,IAAI,aAAa,GAAkB,IAAI,CAAA;AAEvC,IAAI,MAAM,GAAG,KAAK,CAAA;AAElB;;;;GAIG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,IAAI,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,QAA4B;IACzE,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oEAAoE,EAAE,uBAAuB,CAAC,CAAA;IAChH,CAAC;IACD,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,kCAAkC,EAAE,sBAAsB,CAAC,CAAA;IAC7E,CAAC;IACD,mBAAmB,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IACrC,IAAI,aAAa,KAAK,IAAI;QAAE,aAAa,GAAG,EAAE,CAAA;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU,EAAE,MAAkB;IAC/D,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oEAAoE,EAAE,uBAAuB,CAAC,CAAA;IAChH,CAAC;IACD,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,kCAAkC,EAAE,sBAAsB,CAAC,CAAA;IAC7E,CAAC;IACD,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;IAC3B,IAAI,aAAa,KAAK,IAAI;QAAE,aAAa,GAAG,EAAE,CAAA;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAU;IAC/C,OAAO,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,aAAa,KAAK,IAAI,CAAA;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAU;IAC/C,OAAO,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,EAAW;IAC7C,MAAM,GAAG,GAAG,EAAE,IAAI,aAAa,CAAA;IAC/B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAA;IACtH,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACvC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IACzB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,kBAAkB,CAAC,CAAA;IAC1E,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAA;IAC/B,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,EAAW;IACvC,MAAM,GAAG,GAAG,EAAE,IAAI,aAAa,CAAA;IAC/B,MAAM,MAAM,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC9D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,IAAI,QAAQ,kBAAkB,CAAC,CAAA;IACtF,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,SAAS;YAAE,OAAO,MAAM,CAAC,SAAS,CAAA;IAC/C,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B;IAC7C,mBAAmB,CAAC,KAAK,EAAE,CAAA;IAC3B,eAAe,CAAC,KAAK,EAAE,CAAA;IACvB,WAAW,CAAC,KAAK,EAAE,CAAA;IACnB,aAAa,GAAG,IAAI,CAAA;IACpB,aAAa,GAAG,IAAI,CAAA;IACpB,MAAM,GAAG,KAAK,CAAA;AAChB,CAAC","sourcesContent":["/**\n * engine/registry — BREP / mesh 双槽位注册表（§6.2，R8 构建时切换）\n *\n *\n * 与 brepjs 的 registerKernel 同构（首个注册者为默认），但两张表、两套 getter——\n * 这是 R2（双槽位正交：mesh 引擎与 BREP 引擎独立注册、单独切换）的直接落地。\n *\n * BREP 槽以「异步 provider」注册：引擎可能需异步初始化（occt-wasm 加载、\n * 外部内核 wasm 下载等），provider 只解析一次，结果缓存。\n *\n * 注册只发生在宿主启动装配期（R8）：构建时选定的适配器包在初始化时完成注册，\n * 之后注册表运行期只读。不提供运行时的 unregister / setDefault / 切换 API；\n * 装配完成后调用 freezeEngineRegistries() 冻结，冻结后任何注册尝试抛错（E2 验收）。\n */\n\nimport type { BrepEngineApi } from './primitives'\nimport type { BrepCapabilities } from './types'\n\n/** BREP 引擎实例（槽位 1）：原语契约 + 可选能力声明。 */\nexport interface BrepEngine {\n  readonly id: string\n  readonly primitives: BrepEngineApi\n  readonly capabilities?: BrepCapabilities\n}\n\n/** BREP 引擎异步提供者（宿主装配时注册；引擎初始化完成后 resolve）。 */\nexport type BrepEngineProvider = () => Promise<BrepEngine>\n\n/**\n * mesh 引擎实例（槽位 2）——与 BREP 槽完全独立（R2）。\n *\n * `meshSolid`：可选的**网格实体后端**（方案 2026-10-01 §3.3）。提供它的 mesh\n * 引擎才能把网格文件导入成\"网格实体 + 近似拓扑\"。缺省（未提供）= 该 mesh 后端\n * 只做裸网格布尔，`load` 的 mesh 路径保持\"裸网格、无拓扑\"的历史行为。\n */\nexport interface MeshEngine {\n  readonly id: string\n  readonly meshSolid?: import('../mesh-solid').MeshSolidBackend\n}\n\nconst brepEngineProviders = new Map<string, BrepEngineProvider>()\nconst brepEngineCache = new Map<string, BrepEngine>()\nlet defaultBrepId: string | null = null\n\nconst meshEngines = new Map<string, MeshEngine>()\nlet defaultMeshId: string | null = null\n\nlet frozen = false\n\n/**\n * 冻结注册表：宿主启动装配完成后调用（R8）。\n * 冻结后任何 registerBrepEngine / registerMeshEngine 尝试抛错。\n * 已解析的引擎实例仍可读取（运行期只读，不冻结读取）。\n */\nexport function freezeEngineRegistries(): void {\n  frozen = true\n}\n\n/**\n * Register a BREP engine (slot 1). The first registrant automatically becomes the default.\n * @param id - the engine registration id.\n * @param provider - the async provider that resolves the engine instance.\n */\nexport function registerBrepEngine(id: string, provider: BrepEngineProvider): void {\n  if (frozen) {\n    throw new Error(`[engine/registry] registry frozen — cannot register BREP engine '${id}' after assembly (R8)`)\n  }\n  if (brepEngineProviders.has(id)) {\n    throw new Error(`[engine/registry] BREP engine '${id}' already registered`)\n  }\n  brepEngineProviders.set(id, provider)\n  if (defaultBrepId === null) defaultBrepId = id\n}\n\n/**\n * Register a mesh engine (slot 2). The first registrant automatically becomes the default.\n * @param id - the engine registration id.\n * @param engine - the engine instance to register.\n */\nexport function registerMeshEngine(id: string, engine: MeshEngine): void {\n  if (frozen) {\n    throw new Error(`[engine/registry] registry frozen — cannot register mesh engine '${id}' after assembly (R8)`)\n  }\n  if (meshEngines.has(id)) {\n    throw new Error(`[engine/registry] mesh engine '${id}' already registered`)\n  }\n  meshEngines.set(id, engine)\n  if (defaultMeshId === null) defaultMeshId = id\n}\n\n/**\n * Whether the given mesh engine is registered (used for idempotent adapter registration).\n * @param id - the mesh engine registration id to look up.\n * @returns true when the engine is registered.\n */\nexport function isMeshEngineRegistered(id: string): boolean {\n  return meshEngines.has(id)\n}\n\n/**\n * Whether a default BREP engine is registered (none → mesh mode, equivalent to \"no BREP capability\").\n * @returns true when a default BREP engine is registered.\n */\nexport function hasBrepEngine(): boolean {\n  return defaultBrepId !== null\n}\n\n/**\n * Whether the given BREP engine is registered (used for idempotent adapter registration).\n * @param id - the engine registration id to look up.\n * @returns true when the engine is registered.\n */\nexport function isBrepEngineRegistered(id: string): boolean {\n  return brepEngineProviders.has(id)\n}\n\n/**\n * Resolve a BREP engine (asynchronously, resolving its provider; throws when not registered).\n * Omitting id uses the default (the first registrant).\n * @param id - optional engine registration id; defaults to the active engine.\n * @returns a Promise resolving to the BREP engine instance.\n */\nexport async function getBrepEngine(id?: string): Promise<BrepEngine> {\n  const key = id ?? defaultBrepId\n  if (key === null) {\n    throw new Error('[engine/registry] no BREP engine registered — call registerBrepEngine() during host assembly (R8)')\n  }\n  const cached = brepEngineCache.get(key)\n  if (cached) return cached\n  const provider = brepEngineProviders.get(key)\n  if (!provider) {\n    throw new Error(`[engine/registry] BREP engine '${key}' not registered`)\n  }\n  const engine = await provider()\n  brepEngineCache.set(key, engine)\n  return engine\n}\n\n/**\n * Get a mesh engine (throws when not registered). Omitting id uses the default (the first registrant).\n * @param id - optional engine registration id; defaults to the active engine.\n * @returns the mesh engine instance.\n */\nexport function getMeshEngine(id?: string): MeshEngine {\n  const key = id ?? defaultMeshId\n  const engine = key === null ? undefined : meshEngines.get(key)\n  if (!engine) {\n    throw new Error(`[engine/registry] mesh engine '${key ?? '<none>'}' not registered`)\n  }\n  return engine\n}\n\n/**\n * The current default BREP engine id (null when none is registered).\n * @returns the active BREP engine id or null.\n */\nexport function getActiveBrepEngineId(): string | null {\n  return defaultBrepId\n}\n\n/**\n * The current default mesh engine id (null when none is registered).\n * @returns the active mesh engine id or null.\n */\nexport function getActiveMeshEngineId(): string | null {\n  return defaultMeshId\n}\n\n/**\n * 已装配的网格实体后端（方案 2026-10-01 §3.3）。\n *\n * 按**注册顺序**返回第一个声明了 `meshSolid` 的 mesh 引擎——不要求它就是\n * \"默认\" mesh 引擎（默认槽位今天无人注册，直接看默认槽会永远拿不到后端）。\n * 一个都没有 → `null`：这是宿主装配事实，不是错误。\n *\n * @returns the assembled mesh-solid backend, or null when none is available.\n */\nexport function getMeshSolidBackend(): import('../mesh-solid').MeshSolidBackend | null {\n  for (const engine of meshEngines.values()) {\n    if (engine.meshSolid) return engine.meshSolid\n  }\n  return null\n}\n\n/**\n * 仅测试用：重置注册表状态。\n *\n * R8 不提供运行期的 unregister / setDefault；此函数仅供 registry.test.ts\n * 重置模块级单例，不进入任何公共导出面（index/browser/node/sdk 均不 re-export）。\n */\nexport function __resetEngineRegistriesForTests(): void {\n  brepEngineProviders.clear()\n  brepEngineCache.clear()\n  meshEngines.clear()\n  defaultBrepId = null\n  defaultMeshId = null\n  frozen = false\n}\n"]}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/brep/engine/registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * engine/registry — BREP / mesh 双槽位注册表（§6.2，R8 构建时切换）\n *\n *\n * 首个注册者为默认，但两张表、两套 getter——\n * 这是 R2（双槽位正交：mesh 引擎与 BREP 引擎独立注册、单独切换）的直接落地。\n *\n * BREP 槽以「异步 provider」注册：引擎可能需异步初始化（occt-wasm 加载、\n * 外部内核 wasm 下载等），provider 只解析一次，结果缓存。\n *\n * 注册只发生在宿主启动装配期（R8）：构建时选定的适配器包在初始化时完成注册，\n * 之后注册表运行期只读。不提供运行时的 unregister / setDefault / 切换 API；\n * 装配完成后调用 freezeEngineRegistries() 冻结，冻结后任何注册尝试抛错（E2 验收）。\n */\n\nimport type { BrepEngineApi } from './primitives'\n\n/** BREP 引擎实例（槽位 1）：原语契约。引擎能做什么由实现本身决定，没有能力声明面。 */\nexport interface BrepEngine {\n  readonly id: string\n  readonly primitives: BrepEngineApi\n}\n\n/** BREP 引擎异步提供者（宿主装配时注册；引擎初始化完成后 resolve）。 */\nexport type BrepEngineProvider = () => Promise<BrepEngine>\n\n/**\n * mesh 引擎实例（槽位 2）——与 BREP 槽完全独立（R2）。\n *\n * `meshSolid`：可选的**网格实体后端**（方案 2026-10-01 §3.3）。提供它的 mesh\n * 引擎才能把网格文件导入成\"网格实体 + 近似拓扑\"。缺省（未提供）= 该 mesh 后端\n * 只做裸网格布尔，`load` 的 mesh 路径保持\"裸网格、无拓扑\"的历史行为。\n */\nexport interface MeshEngine {\n  readonly id: string\n  readonly meshSolid?: import('../mesh-solid').MeshSolidBackend\n}\n\nconst brepEngineProviders = new Map<string, BrepEngineProvider>()\nconst brepEngineCache = new Map<string, BrepEngine>()\nlet defaultBrepId: string | null = null\n\nconst meshEngines = new Map<string, MeshEngine>()\nlet defaultMeshId: string | null = null\n\nlet frozen = false\n\n/**\n * 冻结注册表：宿主启动装配完成后调用（R8）。\n * 冻结后任何 registerBrepEngine / registerMeshEngine 尝试抛错。\n * 已解析的引擎实例仍可读取（运行期只读，不冻结读取）。\n */\nexport function freezeEngineRegistries(): void {\n  frozen = true\n}\n\n/**\n * Register a BREP engine (slot 1). The first registrant automatically becomes the default.\n * @param id - the engine registration id.\n * @param provider - the async provider that resolves the engine instance.\n */\nexport function registerBrepEngine(id: string, provider: BrepEngineProvider): void {\n  if (frozen) {\n    throw new Error(`[engine/registry] registry frozen — cannot register BREP engine '${id}' after assembly (R8)`)\n  }\n  if (brepEngineProviders.has(id)) {\n    throw new Error(`[engine/registry] BREP engine '${id}' already registered`)\n  }\n  brepEngineProviders.set(id, provider)\n  if (defaultBrepId === null) defaultBrepId = id\n}\n\n/**\n * Register a mesh engine (slot 2). The first registrant automatically becomes the default.\n * @param id - the engine registration id.\n * @param engine - the engine instance to register.\n */\nexport function registerMeshEngine(id: string, engine: MeshEngine): void {\n  if (frozen) {\n    throw new Error(`[engine/registry] registry frozen — cannot register mesh engine '${id}' after assembly (R8)`)\n  }\n  if (meshEngines.has(id)) {\n    throw new Error(`[engine/registry] mesh engine '${id}' already registered`)\n  }\n  meshEngines.set(id, engine)\n  if (defaultMeshId === null) defaultMeshId = id\n}\n\n/**\n * Whether the given mesh engine is registered (used for idempotent adapter registration).\n * @param id - the mesh engine registration id to look up.\n * @returns true when the engine is registered.\n */\nexport function isMeshEngineRegistered(id: string): boolean {\n  return meshEngines.has(id)\n}\n\n/**\n * Whether a default BREP engine is registered (none → mesh mode, i.e. no BREP engine at all).\n * @returns true when a default BREP engine is registered.\n */\nexport function hasBrepEngine(): boolean {\n  return defaultBrepId !== null\n}\n\n/**\n * Whether the given BREP engine is registered (used for idempotent adapter registration).\n * @param id - the engine registration id to look up.\n * @returns true when the engine is registered.\n */\nexport function isBrepEngineRegistered(id: string): boolean {\n  return brepEngineProviders.has(id)\n}\n\n/**\n * Resolve a BREP engine (asynchronously, resolving its provider; throws when not registered).\n * Omitting id uses the default (the first registrant).\n * @param id - optional engine registration id; defaults to the active engine.\n * @returns a Promise resolving to the BREP engine instance.\n */\nexport async function getBrepEngine(id?: string): Promise<BrepEngine> {\n  const key = id ?? defaultBrepId\n  if (key === null) {\n    throw new Error('[engine/registry] no BREP engine registered — call registerBrepEngine() during host assembly (R8)')\n  }\n  const cached = brepEngineCache.get(key)\n  if (cached) return cached\n  const provider = brepEngineProviders.get(key)\n  if (!provider) {\n    throw new Error(`[engine/registry] BREP engine '${key}' not registered`)\n  }\n  const engine = await provider()\n  brepEngineCache.set(key, engine)\n  return engine\n}\n\n/**\n * Get a mesh engine (throws when not registered). Omitting id uses the default (the first registrant).\n * @param id - optional engine registration id; defaults to the active engine.\n * @returns the mesh engine instance.\n */\nexport function getMeshEngine(id?: string): MeshEngine {\n  const key = id ?? defaultMeshId\n  const engine = key === null ? undefined : meshEngines.get(key)\n  if (!engine) {\n    throw new Error(`[engine/registry] mesh engine '${key ?? '<none>'}' not registered`)\n  }\n  return engine\n}\n\n/**\n * The current default BREP engine id (null when none is registered).\n * @returns the active BREP engine id or null.\n */\nexport function getActiveBrepEngineId(): string | null {\n  return defaultBrepId\n}\n\n/**\n * The current default mesh engine id (null when none is registered).\n * @returns the active mesh engine id or null.\n */\nexport function getActiveMeshEngineId(): string | null {\n  return defaultMeshId\n}\n\n/**\n * 已装配的网格实体后端（方案 2026-10-01 §3.3）。\n *\n * 按**注册顺序**返回第一个声明了 `meshSolid` 的 mesh 引擎——不要求它就是\n * \"默认\" mesh 引擎（默认槽位今天无人注册，直接看默认槽会永远拿不到后端）。\n * 一个都没有 → `null`：这是宿主装配事实，不是错误。\n *\n * @returns the assembled mesh-solid backend, or null when none is available.\n */\nexport function getMeshSolidBackend(): import('../mesh-solid').MeshSolidBackend | null {\n  for (const engine of meshEngines.values()) {\n    if (engine.meshSolid) return engine.meshSolid\n  }\n  return null\n}\n\n/**\n * 仅测试用：重置注册表状态。\n *\n * R8 不提供运行期的 unregister / setDefault；此函数仅供 registry.test.ts\n * 重置模块级单例，不进入任何公共导出面（index/browser/node/sdk 均不 re-export）。\n */\nexport function __resetEngineRegistriesForTests(): void {\n  brepEngineProviders.clear()\n  brepEngineCache.clear()\n  meshEngines.clear()\n  defaultBrepId = null\n  defaultMeshId = null\n  frozen = false\n}\n"]}