@faicad/faijs 0.16.1 → 0.17.0

package/dist/brepkit-kernel/brepkitKernel.d.ts

@@ -1,26 +1,46 @@
 /**
- * brepkit-kernel/brepkitKernel — brepkit 内核 → faijs BrepEngineApi 适配器（v1 白名单）
+ * brepkit-kernel/brepkitKernel — brepkit 内核 → faijs BrepEngineApi 适配器
+ *
+ * Phase 4（docs/plans/2026-09-24-brep-engine-api-narrowing-native-access.md）：
+ * 本文件是 L1 契约 `BrepEngineApi` 的 **brepkit 显式对象字面量实现**——与 occt 侧
+ * `occt-primitives.ts` 同构：逐方法接线、方言在适配器内消化、零 `unsupported()` 桩。
+ *
+ * 契约面收窄后 L1 只含 occt/brepkit 双方**语义可对齐**的方法（唯一真源：
+ * `api/surface/engine-method-map.json` 的 aligned/dialect 条目）。brepkit 独有
+ * 能力（chamfer2d/chamferV2/filletV2/sketch* 族、serializeSolid、meshBoolean、
+ * minkowskiSum …）与单方语义（loft、平面 section/split 之外的 splitter 语义…）
+ * 都不在本对象里——平台代码经原生面 `getBrepkitKernel()`（D3）访问。
  *
  * 设计要点（对应 3d_editor 项目的 weapp-voice-ai-modeling 设计计划 §5）：
  * - 句柄：brepkit u32 句柄与 faijs BrepHandle(number) 同构，直通零转换；
  * - 拓扑红线：meshShape 用 tessellateSolidGrouped 输出 faceGroups，与三角化几何同源；
  * - 面溯源：布尔/倒角走 *WithEvolution，映射为 BrepEvolutionData（hash 编码）；
  * - 链纪律：kernel.meshFallbackCount 计数差 > 0 → getMeshFallbackCount 暴露给宿主，
- *   由宿主标记 BREP 链中断（不在此层静默处理）；
- * - v1 白名单之外的方法：显式抛错（报错好于掩盖，禁止空实现假成功）。
+ *   由宿主标记 BREP 链中断（不在此层静默处理）。
  */
+import { type BrepKitKernel } from './brepkitWasm.js';
 import type { BrepEngineApi } from '../brep/engine/primitives.js';
 /** brepkit 适配器返回类型：BrepEngineApi + brepkit 专属诊断。 */
 type BrepkitEngineExtras = BrepEngineApi & {
     getMeshFallbackCount(): number;
 };
 /**
- * 创建 brepkit BrepEngineApi 实现（v1 白名单）。
- * 与 occt 的 initOcctWasm 同位：返回满足引擎契约的原语集合。
+ * 创建 brepkit BrepEngineApi 实现（L1 契约显式对象字面量）。
+ * 与 occt 的 createOcctPrimitives 同位：返回满足引擎契约的原语集合。
  * @returns a promise resolving to the BrepEngineApi implementation plus brepkit-specific
  * diagnostics (`getMeshFallbackCount`).
  */
 export declare function createBrepkitPrimitives(): Promise<BrepkitEngineExtras>;
+/**
+ * 原生 brepkit 内核面（D3）：平台特定代码访问 brepkit 独有能力的唯一入口
+ * （chamfer2d/chamferV2/filletV2/sketch* 族、serializeSolid、meshBoolean 等）。
+ *
+ * ⚠️ 这是**平台特定**出口——import 本函数即声明「这段代码只跑在 brepkit 引擎下」。
+ * 可移植代码请用 `getBrepApi()`（L1 契约面）。
+ *
+ * @returns the live brepkit wasm kernel singleton.
+ */
+export declare function getBrepkitKernel(): BrepKitKernel;
 /** 释放内核单例（测试收尾用；宿主常驻不需调用）。 */
 export declare function disposeBrepkit(): void;
 /** brepkit 适配器原语集类型（BrepEngineApi + brepkit 专属诊断 getMeshFallbackCount）。 */

package/dist/brepkit-kernel/brepkitKernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brepkitKernel.d.ts","sourceRoot":"","sources":["../../src/brepkit-kernel/brepkitKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAkI9D,oDAAoD;AACpD,KAAK,mBAAmB,GAAG,aAAa,GAAG;IAAE,oBAAoB,IAAI,MAAM,CAAA;CAAE,CAAA;AAE7E;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAwc5E;AA0DD,8BAA8B;AAC9B,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAA"}
+{"version":3,"file":"brepkitKernel.d.ts","sourceRoot":"","sources":["../../src/brepkit-kernel/brepkitKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAiI9D,oDAAoD;AACpD,KAAK,mBAAmB,GAAG,aAAa,GAAG;IAAE,oBAAoB,IAAI,MAAM,CAAA;CAAE,CAAA;AAuC7E;;;;;GAKG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAgnB5E;AAoDD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAED,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAA"}