@faicad/faijs 0.16.1 → 0.17.0

package/dist/api/loft.d.ts

@@ -0,0 +1,66 @@
+/**
+ * stdlib loft — 放样：多个截面之间蒙皮生成体（手写平台 op，Phase 4 → G5 core 直连）
+ *
+ * @platform occt — 实现走 core 直连 `occt-wasm loft` / `loftWithVertices`
+ * （BRepOffsetAPI_ThruSections；engine-method-map 里 `loft` 为 occt-only）⇒ 平台 op：
+ * defineOp 声明 `engines: ['occt']`（D11）。
+ *
+ * 为什么手写而不走生成投影：与 `api/sweep.ts` 同因——截面最常见来源是
+ * `cad.sketch(...)`（产出 **face**），内核 `loft(wires, …)` 只吃 wire ⇒
+ * 需要「面 → 外环」输入适配（`internal/profile-wire.ts` 的唯一步径）。
+ *
+ * core-decouple G5：vendored `loft`（brepjs）替换为 occt-wasm 原生直连，
+ * 产物经 `fromBrep` 收养（替代 l3-bridge adoptEntity）。
+ */
+import type { Shape } from '../mesh/types.js';
+/** 放样配置（与 vendored LoftOptions 同形；本文件自持，去 brepjs 依赖）。 */
+export interface LoftOptions {
+    /** 直线插值（ruled）。默认 true。 */
+    ruled?: boolean;
+    /** 起点（退化到点的蒙皮）。 */
+    startPoint?: readonly [number, number, number] | {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** 终点（退化到点的蒙皮）。 */
+    endPoint?: readonly [number, number, number] | {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** ThruSections 缝合公差。默认 1e-6。 */
+    tolerance?: number;
+}
+/**
+ * 放样：按给定顺序在截面之间蒙皮生成体。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name loft
+ * @note 平台 op：仅 occt 引擎（BRepOffsetAPI_ThruSections）。截面可为 wire 或面
+ *       （面取其外环），至少 2 个；`startPoint` / `endPoint` 可做退化到点的蒙皮。
+ *       非 occt 引擎执行前报错；brep_mock 不拦截。不做 `loftAll`（数组产物）。
+ * @returns Shape 放样体。
+ * @param sections - 有序截面集合（wire 或面；面取其外环）。type:Shape[] required:true
+ * @param opts - 放样配置（ruled / startPoint / endPoint / tolerance）。type:LoftOptions required:false
+ * @example
+ * const bottom = cad.sketch({ contours: [{ segments: [
+ *   { kind: 'line', x1: -5, y1: -5, x2: 5, y2: -5 },
+ *   { kind: 'line', x1: 5, y1: -5, x2: 5, y2: 5 },
+ *   { kind: 'line', x1: 5, y1: 5, x2: -5, y2: 5 },
+ *   { kind: 'line', x1: -5, y1: 5, x2: -5, y2: -5 },
+ * ] }] })
+ * const top = cad.translate(cad.sketch({ contours: [{ segments: [
+ *   { kind: 'line', x1: -3, y1: -3, x2: 3, y2: -3 },
+ *   { kind: 'line', x1: 3, y1: -3, x2: 3, y2: 3 },
+ *   { kind: 'line', x1: 3, y1: 3, x2: -3, y2: 3 },
+ *   { kind: 'line', x1: -3, y1: 3, x2: -3, y2: -3 },
+ * ] }] }), [0, 0, 20])
+ * const body = await cad.loft([bottom, top])
+ */
+export declare const loft: ((sections: Shape[], opts?: LoftOptions | undefined) => Promise<Shape>) & {
+    __faijs__dualOp?: import("../define-op.js").DualOpMeta;
+};
+//# sourceMappingURL=loft.d.ts.map

package/dist/api/loft.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loft.d.ts","sourceRoot":"","sources":["../../src/api/loft.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAU1C,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,mBAAmB;IACnB,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACpF,mBAAmB;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClF,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAiDD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,IAAI;;CAOf,CAAA"}

package/dist/api/loft.js

@@ -0,0 +1,111 @@
+/**
+ * stdlib loft — 放样：多个截面之间蒙皮生成体（手写平台 op，Phase 4 → G5 core 直连）
+ *
+ * @platform occt — 实现走 core 直连 `occt-wasm loft` / `loftWithVertices`
+ * （BRepOffsetAPI_ThruSections；engine-method-map 里 `loft` 为 occt-only）⇒ 平台 op：
+ * defineOp 声明 `engines: ['occt']`（D11）。
+ *
+ * 为什么手写而不走生成投影：与 `api/sweep.ts` 同因——截面最常见来源是
+ * `cad.sketch(...)`（产出 **face**），内核 `loft(wires, …)` 只吃 wire ⇒
+ * 需要「面 → 外环」输入适配（`internal/profile-wire.ts` 的唯一步径）。
+ *
+ * core-decouple G5：vendored `loft`（brepjs）替换为 occt-wasm 原生直连，
+ * 产物经 `fromBrep` 收养（替代 l3-bridge adoptEntity）。
+ */
+import { defineOp } from '../sdk.js';
+import { getBrepApi } from '../brep/handle-bridge.js';
+import { fromBrep } from '../shape.js';
+import { solidToShape } from '../brep/brep-ops.js';
+import { getOcctKernel } from '../occt-kernel/occtKernel.js';
+import { toProfileWireView } from './internal/profile-wire.js';
+/** PointInput → [x,y,z]（vendored toVec3 同口径）。 */
+function toVec3(p) {
+    if (Array.isArray(p) && p.length >= 3)
+        return [p[0], p[1], p[2]];
+    const o = p;
+    return [o.x, o.y, o.z];
+}
+/** BREP 路径：按序蒙皮各截面（wire 视图 → occt-wasm 直连 → fromBrep 收养）。 */
+function loftBrep(sections, opts) {
+    if (!Array.isArray(sections) || sections.length === 0) {
+        throw new Error('E_LOFT_NO_SECTIONS: loft requires a non-empty array of section shapes');
+    }
+    // 每截面：wire 直用；面取外环（孔环不参与放样）。
+    const wireViews = sections.map((s) => toProfileWireView(s));
+    const { ruled = true, startPoint, endPoint } = opts ?? {};
+    const kernel = getBrepApi();
+    const k = getOcctKernel();
+    const wireHandles = wireViews.map((w) => w.wrapped);
+    try {
+        let h;
+        if (startPoint !== undefined || endPoint !== undefined) {
+            const startVertex = startPoint !== undefined ? k.makeVertex(...toVec3(startPoint)) : undefined;
+            const endVertex = endPoint !== undefined ? k.makeVertex(...toVec3(endPoint)) : undefined;
+            try {
+                h = k.loftWithVertices(wireHandles, true, ruled, startVertex, endVertex);
+            }
+            finally {
+                if (startVertex !== undefined)
+                    k.release(startVertex);
+                if (endVertex !== undefined)
+                    k.release(endVertex);
+            }
+        }
+        else {
+            h = k.loft(wireHandles, true, ruled);
+        }
+        return fromBrep(solidToShape(kernel, h), { solid: h });
+    }
+    catch (e) {
+        const raw = e instanceof Error ? e.message : String(e);
+        throw new Error(`E_LOFT_FAILED: loft failed: ${raw}`, { cause: e });
+    }
+    finally {
+        // 面→外环产出的 wire 是 arena 新句柄（曲线借用不 release）
+        for (const w of wireViews) {
+            if (!w.borrowed) {
+                try {
+                    kernel.release(w.wrapped);
+                }
+                catch { /* 已释放 */ }
+            }
+        }
+    }
+}
+/**
+ * 放样：按给定顺序在截面之间蒙皮生成体。
+ * @group 特征
+ * @inputs 1
+ * @async true
+ * @qual ok
+ * @name loft
+ * @note 平台 op：仅 occt 引擎（BRepOffsetAPI_ThruSections）。截面可为 wire 或面
+ *       （面取其外环），至少 2 个；`startPoint` / `endPoint` 可做退化到点的蒙皮。
+ *       非 occt 引擎执行前报错；brep_mock 不拦截。不做 `loftAll`（数组产物）。
+ * @returns Shape 放样体。
+ * @param sections - 有序截面集合（wire 或面；面取其外环）。type:Shape[] required:true
+ * @param opts - 放样配置（ruled / startPoint / endPoint / tolerance）。type:LoftOptions required:false
+ * @example
+ * const bottom = cad.sketch({ contours: [{ segments: [
+ *   { kind: 'line', x1: -5, y1: -5, x2: 5, y2: -5 },
+ *   { kind: 'line', x1: 5, y1: -5, x2: 5, y2: 5 },
+ *   { kind: 'line', x1: 5, y1: 5, x2: -5, y2: 5 },
+ *   { kind: 'line', x1: -5, y1: 5, x2: -5, y2: -5 },
+ * ] }] })
+ * const top = cad.translate(cad.sketch({ contours: [{ segments: [
+ *   { kind: 'line', x1: -3, y1: -3, x2: 3, y2: -3 },
+ *   { kind: 'line', x1: 3, y1: -3, x2: 3, y2: 3 },
+ *   { kind: 'line', x1: 3, y1: 3, x2: -3, y2: 3 },
+ *   { kind: 'line', x1: -3, y1: 3, x2: -3, y2: -3 },
+ * ] }] }), [0, 0, 20])
+ * const body = await cad.loft([bottom, top])
+ */
+export const loft = defineOp({
+    name: 'loft',
+    brep(sections, opts) {
+        return loftBrep(sections, opts);
+    },
+    engines: ['occt'],
+    naming: { kind: 'unmodeled', reason: 'lofted-body face vocabulary not defined' },
+});
+//# sourceMappingURL=loft.js.map

package/dist/api/loft.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loft.js","sourceRoot":"","sources":["../../src/api/loft.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stdlib loft — 放样：多个截面之间蒙皮生成体（手写平台 op，Phase 4 → G5 core 直连）\n *\n * @platform occt — 实现走 core 直连 `occt-wasm loft` / `loftWithVertices`\n * （BRepOffsetAPI_ThruSections；engine-method-map 里 `loft` 为 occt-only）⇒ 平台 op：\n * defineOp 声明 `engines: ['occt']`（D11）。\n *\n * 为什么手写而不走生成投影：与 `api/sweep.ts` 同因——截面最常见来源是\n * `cad.sketch(...)`（产出 **face**），内核 `loft(wires, …)` 只吃 wire ⇒\n * 需要「面 → 外环」输入适配（`internal/profile-wire.ts` 的唯一步径）。\n *\n * core-decouple G5：vendored `loft`（brepjs）替换为 occt-wasm 原生直连，\n * 产物经 `fromBrep` 收养（替代 l3-bridge adoptEntity）。\n */\n\nimport type { Shape } from '../mesh/types'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport { getBrepApi } from '../brep/handle-bridge'\nimport { fromBrep } from '../shape'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getOcctKernel } from '../occt-kernel/occtKernel'\nimport { toProfileWireView } from './internal/profile-wire'\nimport type { BrepHandle } from '../brep/engine/types'\n\n/** 放样配置（与 vendored LoftOptions 同形；本文件自持，去 brepjs 依赖）。 */\nexport interface LoftOptions {\n  /** 直线插值（ruled）。默认 true。 */\n  ruled?: boolean\n  /** 起点（退化到点的蒙皮）。 */\n  startPoint?: readonly [number, number, number] | { x: number; y: number; z: number }\n  /** 终点（退化到点的蒙皮）。 */\n  endPoint?: readonly [number, number, number] | { x: number; y: number; z: number }\n  /** ThruSections 缝合公差。默认 1e-6。 */\n  tolerance?: number\n}\n\n/** PointInput → [x,y,z]（vendored toVec3 同口径）。 */\nfunction toVec3(p: LoftOptions['startPoint']): [number, number, number] {\n  if (Array.isArray(p) && p.length >= 3) return [p[0]!, p[1]!, p[2]!]\n  const o = p as { x: number; y: number; z: number }\n  return [o.x, o.y, o.z]\n}\n\n/** BREP 路径：按序蒙皮各截面（wire 视图 → occt-wasm 直连 → fromBrep 收养）。 */\nfunction loftBrep(sections: Shape[], opts?: LoftOptions): Shape {\n  if (!Array.isArray(sections) || sections.length === 0) {\n    throw new Error('E_LOFT_NO_SECTIONS: loft requires a non-empty array of section shapes')\n  }\n  // 每截面：wire 直用；面取外环（孔环不参与放样）。\n  const wireViews = sections.map((s) => toProfileWireView(s))\n  const { ruled = true, startPoint, endPoint } = opts ?? {}\n  const kernel = getBrepApi()\n  const k = getOcctKernel()\n  const wireHandles = wireViews.map((w) => w.wrapped as never)\n\n  try {\n    let h: unknown\n    if (startPoint !== undefined || endPoint !== undefined) {\n      const startVertex = startPoint !== undefined ? k.makeVertex(...toVec3(startPoint)) : undefined\n      const endVertex = endPoint !== undefined ? k.makeVertex(...toVec3(endPoint)) : undefined\n      try {\n        h = k.loftWithVertices(wireHandles, true, ruled, startVertex as never, endVertex as never)\n      } finally {\n        if (startVertex !== undefined) k.release(startVertex)\n        if (endVertex !== undefined) k.release(endVertex)\n      }\n    } else {\n      h = k.loft(wireHandles, true, ruled)\n    }\n    return fromBrep(solidToShape(kernel, h as BrepHandle), { solid: h as BrepHandle })\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    throw new Error(`E_LOFT_FAILED: loft failed: ${raw}`, { cause: e })\n  } finally {\n    // 面→外环产出的 wire 是 arena 新句柄（曲线借用不 release）\n    for (const w of wireViews) {\n      if (!w.borrowed) {\n        try { kernel.release(w.wrapped) } catch { /* 已释放 */ }\n      }\n    }\n  }\n}\n\n/**\n * 放样：按给定顺序在截面之间蒙皮生成体。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name loft\n * @note 平台 op：仅 occt 引擎（BRepOffsetAPI_ThruSections）。截面可为 wire 或面\n *       （面取其外环），至少 2 个；`startPoint` / `endPoint` 可做退化到点的蒙皮。\n *       非 occt 引擎执行前报错；brep_mock 不拦截。不做 `loftAll`（数组产物）。\n * @returns Shape 放样体。\n * @param sections - 有序截面集合（wire 或面；面取其外环）。type:Shape[] required:true\n * @param opts - 放样配置（ruled / startPoint / endPoint / tolerance）。type:LoftOptions required:false\n * @example\n * const bottom = cad.sketch({ contours: [{ segments: [\n *   { kind: 'line', x1: -5, y1: -5, x2: 5, y2: -5 },\n *   { kind: 'line', x1: 5, y1: -5, x2: 5, y2: 5 },\n *   { kind: 'line', x1: 5, y1: 5, x2: -5, y2: 5 },\n *   { kind: 'line', x1: -5, y1: 5, x2: -5, y2: -5 },\n * ] }] })\n * const top = cad.translate(cad.sketch({ contours: [{ segments: [\n *   { kind: 'line', x1: -3, y1: -3, x2: 3, y2: -3 },\n *   { kind: 'line', x1: 3, y1: -3, x2: 3, y2: 3 },\n *   { kind: 'line', x1: 3, y1: 3, x2: -3, y2: 3 },\n *   { kind: 'line', x1: -3, y1: 3, x2: -3, y2: -3 },\n * ] }] }), [0, 0, 20])\n * const body = await cad.loft([bottom, top])\n */\nexport const loft = defineOp({\n  name: 'loft',\n  brep(sections: Shape[], opts?: LoftOptions) {\n    return loftBrep(sections, opts)\n  },\n  engines: ['occt'],\n  naming: { kind: 'unmodeled', reason: 'lofted-body face vocabulary not defined' } as Provenance,\n})\n"]}

package/dist/api/measurement/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * measurement — cad 脚本面测量 op（Phase 7，narrowing plan §Phase 7 / Q4）
+ *
+ * 补齐 §1.5 的反向缺口：BrepEngineApi 的 L1 测量面（getSurfaceArea / getLength）
+ * 在脚本面此前没有任何入口——脚本里量不出面积、长度。本模块提供两个**中立**测量
+ * op（走 getBrepApi() 的 L1 契约面，occt / brepkit / 小程序端同一份 .fai.js 都可跑）：
+ *   - area(shape)         → 表面积（getSurfaceArea）；
+ *   - length(shape)       → 边长/线长（getLength）；
+ *   - volume(shape)       → 体积（getVolume）；
+ *   - centerOfMass(shape) → 质心坐标（getCenterOfMass，BrepVec3 {x,y,z}）。
+ *
+ * 与 vendored 测量面（api/generated/measurement.ts 的 measureArea / measureLength）
+ * 的区别：那些 op 经 l3-bridge 借入层 + vendored 函数绑定 occt-wasm，整体 occt-only
+ * （Phase 6 已声明 engines: ['occt']）；本模块直接调 L1 方法，无借入层、无引擎绑定，
+ * 是脚本面的中立测量入口。返回纯数字，不产出 Shape、不消费 shape。
+ *
+ * 三源一致（B1）：本模块经 arg-spec 的 `scriptFace: true` 条目（kind 'faijs'）登记，
+ * 由 gen-l3-surface.ts re-export 进 api/generated/script-face.ts / script-face-manifest.ts，
+ * gen-symbol-table.ts 同步 check() 符号表——cad 命名空间、manifest、符号表三处同源。
+ */
+import type { Shape } from '../../mesh/types.js';
+import type { BrepVec3 } from '../../brep/engine/types.js';
+/**
+ * 测量形状的表面积（L1 getSurfaceArea，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（Face / Shape3D / compound）。
+ * @returns 表面积（mm²）。
+ */
+export declare function area(shape: Shape): Promise<number>;
+/**
+ * 测量形状的边长/线长（L1 getLength，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（edge / wire / solid，solid 按内核口径计边）。
+ * @returns 长度（mm）。
+ */
+export declare function length(shape: Shape): Promise<number>;
+/**
+ * 测量形状的体素体积（L1 getVolume，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（solid / compound；对 wire / face 内核按自身口径计，可能返回 0）。
+ * @returns 体积（mm³）。
+ */
+export declare function volume(shape: Shape): Promise<number>;
+/**
+ * 测量形状的质心（L1 getCenterOfMass，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（solid / compound / face）。
+ * @returns 质心坐标（mm，BREP 中立形态 {x,y,z}）。
+ */
+export declare function centerOfMass(shape: Shape): Promise<BrepVec3>;
+//# sourceMappingURL=index.d.ts.map

package/dist/api/measurement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/api/measurement/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAc,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAanE;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxD;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1D;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1D;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAGlE"}

package/dist/api/measurement/index.js

@@ -0,0 +1,71 @@
+/**
+ * measurement — cad 脚本面测量 op（Phase 7，narrowing plan §Phase 7 / Q4）
+ *
+ * 补齐 §1.5 的反向缺口：BrepEngineApi 的 L1 测量面（getSurfaceArea / getLength）
+ * 在脚本面此前没有任何入口——脚本里量不出面积、长度。本模块提供两个**中立**测量
+ * op（走 getBrepApi() 的 L1 契约面，occt / brepkit / 小程序端同一份 .fai.js 都可跑）：
+ *   - area(shape)         → 表面积（getSurfaceArea）；
+ *   - length(shape)       → 边长/线长（getLength）；
+ *   - volume(shape)       → 体积（getVolume）；
+ *   - centerOfMass(shape) → 质心坐标（getCenterOfMass，BrepVec3 {x,y,z}）。
+ *
+ * 与 vendored 测量面（api/generated/measurement.ts 的 measureArea / measureLength）
+ * 的区别：那些 op 经 l3-bridge 借入层 + vendored 函数绑定 occt-wasm，整体 occt-only
+ * （Phase 6 已声明 engines: ['occt']）；本模块直接调 L1 方法，无借入层、无引擎绑定，
+ * 是脚本面的中立测量入口。返回纯数字，不产出 Shape、不消费 shape。
+ *
+ * 三源一致（B1）：本模块经 arg-spec 的 `scriptFace: true` 条目（kind 'faijs'）登记，
+ * 由 gen-l3-surface.ts re-export 进 api/generated/script-face.ts / script-face-manifest.ts，
+ * gen-symbol-table.ts 同步 check() 符号表——cad 命名空间、manifest、符号表三处同源。
+ */
+import { brepOf } from '../../shape.js';
+import { getBrepApi } from '../../brep/handle-bridge.js';
+/** 读该 Shape 的 BREP 句柄；mesh-only 输入在测量前显式报错（不静默降级）。 */
+function requireBrepHandle(shape, op) {
+    const h = brepOf(shape);
+    if (h === undefined) {
+        throw new Error(`[faijs/measurement] ${op}: E_BREP_ONLY_INPUT: measurement requires a BREP-backed shape (mesh-only input has no BREP handle)`);
+    }
+    return h;
+}
+/**
+ * 测量形状的表面积（L1 getSurfaceArea，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（Face / Shape3D / compound）。
+ * @returns 表面积（mm²）。
+ */
+export async function area(shape) {
+    const h = requireBrepHandle(shape, 'area');
+    return getBrepApi().getSurfaceArea(h);
+}
+/**
+ * 测量形状的边长/线长（L1 getLength，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（edge / wire / solid，solid 按内核口径计边）。
+ * @returns 长度（mm）。
+ */
+export async function length(shape) {
+    const h = requireBrepHandle(shape, 'length');
+    return getBrepApi().getLength(h);
+}
+/**
+ * 测量形状的体素体积（L1 getVolume，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（solid / compound；对 wire / face 内核按自身口径计，可能返回 0）。
+ * @returns 体积（mm³）。
+ */
+export async function volume(shape) {
+    const h = requireBrepHandle(shape, 'volume');
+    return getBrepApi().getVolume(h);
+}
+/**
+ * 测量形状的质心（L1 getCenterOfMass，两引擎同口径）。
+ *
+ * @param shape - 被测量的形状（solid / compound / face）。
+ * @returns 质心坐标（mm，BREP 中立形态 {x,y,z}）。
+ */
+export async function centerOfMass(shape) {
+    const h = requireBrepHandle(shape, 'centerOfMass');
+    return getBrepApi().getCenterOfMass(h);
+}
+//# sourceMappingURL=index.js.map

package/dist/api/measurement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/measurement/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAIrD,sDAAsD;AACtD,SAAS,iBAAiB,CAAC,KAAY,EAAE,EAAU;IACjD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACvB,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,uBAAuB,EAAE,oGAAoG,CAC9H,CAAA;IACH,CAAC;IACD,OAAO,CAAe,CAAA;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,KAAY;IACrC,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC1C,OAAO,UAAU,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAY;IACvC,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC5C,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAY;IACvC,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC5C,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAY;IAC7C,MAAM,CAAC,GAAG,iBAAiB,CAAC,KAAK,EAAE,cAAc,CAAC,CAAA;IAClD,OAAO,UAAU,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAA;AACxC,CAAC","sourcesContent":["/**\n * measurement — cad 脚本面测量 op（Phase 7，narrowing plan §Phase 7 / Q4）\n *\n * 补齐 §1.5 的反向缺口：BrepEngineApi 的 L1 测量面（getSurfaceArea / getLength）\n * 在脚本面此前没有任何入口——脚本里量不出面积、长度。本模块提供两个**中立**测量\n * op（走 getBrepApi() 的 L1 契约面，occt / brepkit / 小程序端同一份 .fai.js 都可跑）：\n *   - area(shape)         → 表面积（getSurfaceArea）；\n *   - length(shape)       → 边长/线长（getLength）；\n *   - volume(shape)       → 体积（getVolume）；\n *   - centerOfMass(shape) → 质心坐标（getCenterOfMass，BrepVec3 {x,y,z}）。\n *\n * 与 vendored 测量面（api/generated/measurement.ts 的 measureArea / measureLength）\n * 的区别：那些 op 经 l3-bridge 借入层 + vendored 函数绑定 occt-wasm，整体 occt-only\n * （Phase 6 已声明 engines: ['occt']）；本模块直接调 L1 方法，无借入层、无引擎绑定，\n * 是脚本面的中立测量入口。返回纯数字，不产出 Shape、不消费 shape。\n *\n * 三源一致（B1）：本模块经 arg-spec 的 `scriptFace: true` 条目（kind 'faijs'）登记，\n * 由 gen-l3-surface.ts re-export 进 api/generated/script-face.ts / script-face-manifest.ts，\n * gen-symbol-table.ts 同步 check() 符号表——cad 命名空间、manifest、符号表三处同源。\n */\n\nimport { brepOf } from '../../shape'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport type { Shape } from '../../mesh/types'\nimport type { BrepHandle, BrepVec3 } from '../../brep/engine/types'\n\n/** 读该 Shape 的 BREP 句柄；mesh-only 输入在测量前显式报错（不静默降级）。 */\nfunction requireBrepHandle(shape: Shape, op: string): BrepHandle {\n  const h = brepOf(shape)\n  if (h === undefined) {\n    throw new Error(\n      `[faijs/measurement] ${op}: E_BREP_ONLY_INPUT: measurement requires a BREP-backed shape (mesh-only input has no BREP handle)`,\n    )\n  }\n  return h as BrepHandle\n}\n\n/**\n * 测量形状的表面积（L1 getSurfaceArea，两引擎同口径）。\n *\n * @param shape - 被测量的形状（Face / Shape3D / compound）。\n * @returns 表面积（mm²）。\n */\nexport async function area(shape: Shape): Promise<number> {\n  const h = requireBrepHandle(shape, 'area')\n  return getBrepApi().getSurfaceArea(h)\n}\n\n/**\n * 测量形状的边长/线长（L1 getLength，两引擎同口径）。\n *\n * @param shape - 被测量的形状（edge / wire / solid，solid 按内核口径计边）。\n * @returns 长度（mm）。\n */\nexport async function length(shape: Shape): Promise<number> {\n  const h = requireBrepHandle(shape, 'length')\n  return getBrepApi().getLength(h)\n}\n\n/**\n * 测量形状的体素体积（L1 getVolume，两引擎同口径）。\n *\n * @param shape - 被测量的形状（solid / compound；对 wire / face 内核按自身口径计，可能返回 0）。\n * @returns 体积（mm³）。\n */\nexport async function volume(shape: Shape): Promise<number> {\n  const h = requireBrepHandle(shape, 'volume')\n  return getBrepApi().getVolume(h)\n}\n\n/**\n * 测量形状的质心（L1 getCenterOfMass，两引擎同口径）。\n *\n * @param shape - 被测量的形状（solid / compound / face）。\n * @returns 质心坐标（mm，BREP 中立形态 {x,y,z}）。\n */\nexport async function centerOfMass(shape: Shape): Promise<BrepVec3> {\n  const h = requireBrepHandle(shape, 'centerOfMass')\n  return getBrepApi().getCenterOfMass(h)\n}\n"]}

package/dist/api/occt-kernel-bridge.d.ts

@@ -1,6 +1,10 @@
 /**
  * L3 bridge — vendored kernel registry injection (engine-neutral, Phase 2 P2-5).
  *
+ * @platform occt — 本文件 import occt-kernel（occtKernel）：桥接层把当前引擎的
+ *   BrepEngineApi 适配器包装为 brepjs KernelAdapter 注入 vendored registry，平台
+ *   类型（OcctKernel 句柄）只在桥内出现；守卫 R1 豁免、R2 无 defineOp 不适用。
+ *
  * 原 occt-kernel-bridge 的职责是「把 vendored kernel registry 冻结绑定到 occt-wasm
  * 单实例」（D10）。Phase 2 起改为**跟随当前 BREP 引擎**：装配期把 registry 里当前
  * 引擎（occt / brepkit / mock）的 `BrepEngineApi` 适配器包装为 brepjs `KernelAdapter`
@@ -18,7 +22,7 @@
  * 则在**装配期**报错（而非执行期崩）。清单见 {@link GLUE_METHODS}。
  */
 import { type BrepEngine } from '../brep/engine/registry.js';
-import type { KernelAdapter } from '../vendored/brepjs/kernel/types.js';
+import type { KernelAdapter } from '@faicad/faijs-brepjs/kernel/types.js';
 /** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的
  * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——
  * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */
@@ -66,13 +70,6 @@ export declare function injectCurrentBrepEngineAsKernel(): Promise<KernelAdapter
  *   其它引擎 → BrepEngineApi 透传包装，pattern 族 Vec3↔三元组适配）。
  */
 export declare function buildKernelAdapter(engine: BrepEngine): KernelAdapter;
-/**
- * vendored kernel methods with no source capability in BrepEngineApi.
- * Registered explicitly (not silently undefined): tests assert this list and
- * the engine-contract gap is a separate decision, not a wrapping bug. No
- * stubs, no fake zeros — a silent 0 is worse than a crash.
- */
-export declare const UNMAPPED_VENDORED_MEASURE_METHODS: readonly ["area", "length", "linearCenterOfMass"];
 /**
  * 装配期完整性检查：KernelAdapter 胶水方法齐备断言。
  *

package/dist/api/occt-kernel-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"occt-kernel-bridge.d.ts","sourceRoot":"","sources":["../../src/api/occt-kernel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAYxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAEvE;;4DAE4D;AAC5D,eAAO,MAAM,uBAAuB,cAAc,CAAA;AAwBlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,aAAa,CAAC,CAgB9E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAMpE;AAKD;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC,mDAIpC,CAAA;AAmIV;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}
+{"version":3,"file":"occt-kernel-bridge.d.ts","sourceRoot":"","sources":["../../src/api/occt-kernel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAYxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAA;AAEzE;;4DAE4D;AAC5D,eAAO,MAAM,uBAAuB,cAAc,CAAA;AAwBlD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,+BAA+B,IAAI,OAAO,CAAC,aAAa,CAAC,CAgB9E;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAUpE;AA8ID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,aAAa,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,aAAa,CAM9C;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/api/occt-kernel-bridge.js

@@ -1,6 +1,10 @@
 /**
  * L3 bridge — vendored kernel registry injection (engine-neutral, Phase 2 P2-5).
  *
+ * @platform occt — 本文件 import occt-kernel（occtKernel）：桥接层把当前引擎的
+ *   BrepEngineApi 适配器包装为 brepjs KernelAdapter 注入 vendored registry，平台
+ *   类型（OcctKernel 句柄）只在桥内出现；守卫 R1 豁免、R2 无 defineOp 不适用。
+ *
  * 原 occt-kernel-bridge 的职责是「把 vendored kernel registry 冻结绑定到 occt-wasm
  * 单实例」（D10）。Phase 2 起改为**跟随当前 BREP 引擎**：装配期把 registry 里当前
  * 引擎（occt / brepkit / mock）的 `BrepEngineApi` 适配器包装为 brepjs `KernelAdapter`
@@ -19,8 +23,8 @@
  */
 import { getKernel as getFaijsKernel } from '../occt-kernel/occtKernel.js';
 import { getBrepEngine } from '../brep/engine/registry.js';
-import { OcctWasmAdapter } from '../vendored/brepjs/kernel/occtWasm/occtWasmAdapter.js';
-import { freezeKernels, getActiveKernelId, getKernel as getVendoredKernel, registerKernel, syncRegistryFromGlobal, syncRegistryToGlobal, __resetKernelRegistryForTests, } from '../vendored/brepjs/kernel/index.js';
+import { OcctWasmAdapter } from '@faicad/faijs-brepjs/kernel/occtWasm/occtWasmAdapter.js';
+import { freezeKernels, getActiveKernelId, getKernel as getVendoredKernel, registerKernel, syncRegistryFromGlobal, syncRegistryToGlobal, __resetKernelRegistryForTests, } from '@faicad/faijs-brepjs/kernel/index.js';
 /** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的
  * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——
  * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */
@@ -104,7 +108,11 @@ export async function injectCurrentBrepEngineAsKernel() {
  */
 export function buildKernelAdapter(engine) {
     if (engine.id === 'occt') {
-        const faijsKernel = engine.primitives;
+        // Phase 3 (narrowing plan): engine.primitives is now the L1 adapter object
+        // (createOcctPrimitives), NOT the raw kernel — the old cast lied. The
+        // vendored full adapter needs the raw occt-wasm singleton, which is exactly
+        // what getKernel() returns (process-level singleton, D10 unchanged).
+        const faijsKernel = getFaijsKernel();
         return OcctWasmAdapter.fromKernel(faijsKernel);
     }
     return wrapBrepEngineApi(engine.primitives);
@@ -112,16 +120,11 @@ export function buildKernelAdapter(engine) {
 /** No-op `delete` for synthesized glue objects (mirrors vendored `noop`). */
 const noop = () => { };
 /**
- * vendored kernel methods with no source capability in BrepEngineApi.
- * Registered explicitly (not silently undefined): tests assert this list and
- * the engine-contract gap is a separate decision, not a wrapping bug. No
- * stubs, no fake zeros — a silent 0 is worse than a crash.
+ * vendored 测量名 ↔ BrepEngineApi 能力映射（Phase 6 收口，D7）：
+ * area/length 已映射到 L1 测量面（getSurfaceArea/getLength，Phase 4 D9 接线）；
+ * linearCenterOfMass 无 L1 对应（L2 平台面，primitives.ts 注释），保留真实缺口——
+ * 不补桩、不返回 0（静默 0 比崩溃更糟），测试内联钉住 undefined。
  */
-export const UNMAPPED_VENDORED_MEASURE_METHODS = [
-    'area',
-    'length',
-    'linearCenterOfMass',
-];
 /** Unwrap a vendored KernelShape (handle view or bare number) to a BrepHandle. */
 function unwrapHandle(h) {
     if (typeof h === 'number')
@@ -149,10 +152,11 @@ function mapMeasureMethods(adapter, api) {
             max: [bb.xmax, bb.ymax, bb.zmax],
         };
     };
+    adapter['area'] = (s) => api.getSurfaceArea(unwrapHandle(s));
+    adapter['length'] = (s) => api.getLength(unwrapHandle(s));
     // shapeType / isNull: same name, same semantics — already covered by the
     // transparent pass-through in wrapBrepEngineApi; listed here for docs only.
-    // Known contract gaps (UNMAPPED_VENDORED_MEASURE_METHODS) are NOT stubbed:
-    // they remain undefined so tests can pin the gap explicitly.
+    // linearCenterOfMass（L2 平台面）无 L1 对应，保持 undefined（缺口由测试内联钉住）。
 }
 /**
  * Synthesize the vendored glue/auxiliary construction methods over any engine's

package/dist/api/occt-kernel-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"occt-kernel-bridge.js","sourceRoot":"","sources":["../../src/api/occt-kernel-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * L3 bridge — vendored kernel registry injection (engine-neutral, Phase 2 P2-5).\n *\n * 原 occt-kernel-bridge 的职责是「把 vendored kernel registry 冻结绑定到 occt-wasm\n * 单实例」（D10）。Phase 2 起改为**跟随当前 BREP 引擎**：装配期把 registry 里当前\n * 引擎（occt / brepkit / mock）的 `BrepEngineApi` 适配器包装为 brepjs `KernelAdapter`\n * 形态注册进 vendored registry，使 `vendoredRegistry.getKernel()` 返回当前引擎——\n * vendored 函数全部逻辑（命名/角色表/Result）原样保留、零改动。\n *\n * 边界规则（D8/R5）不变：本文件是 faijs 侧唯一把 vendored kernel registry 与\n * faijs 引擎接线的地方；core 侧只从 `api/` import vendored 树。\n *\n * 装配期完整性检查（方案 §Phase 2.5）：KernelAdapter 是 211 方法大接口，但 vendored\n * 面存在大量**辅助构造方法**（createVector3d / createPoint3d / createDirection3d /\n * createAxis1 / createAxis2 / createAxis3，见 vendored core/kernelBoundary.ts）——\n * 它们不落在能力名体系内（BrepMethodKind 之外）、无法由 op 声明覆盖，任何 compat\n * op / TS compat 面都可能触发。⇒ 注入前必须断言这些胶水方法在适配器上齐备，缺失\n * 则在**装配期**报错（而非执行期崩）。清单见 {@link GLUE_METHODS}。\n */\n\nimport { getKernel as getFaijsKernel } from '../occt-kernel/occtKernel'\nimport type { OcctKernelOwner } from '../vendored/brepjs/kernel/occtWasm/occtWasmAdapter.js'\nimport { getBrepEngine, type BrepEngine } from '../brep/engine/registry'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { OcctWasmAdapter } from '../vendored/brepjs/kernel/occtWasm/occtWasmAdapter.js'\nimport {\n  freezeKernels,\n  getActiveKernelId,\n  getKernel as getVendoredKernel,\n  registerKernel,\n  syncRegistryFromGlobal,\n  syncRegistryToGlobal,\n  __resetKernelRegistryForTests,\n} from '../vendored/brepjs/kernel/index.js'\nimport type { KernelAdapter } from '../vendored/brepjs/kernel/types.js'\n\n/** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的\n * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——\n * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */\nexport const VENDORED_OCCT_KERNEL_ID = 'occt-wasm'\n\n/**\n * 装配期完整性检查清单——vendored 面辅助构造/生命周期胶水方法。\n *\n * 这些方法不在 `BrepMethodKind` 能力名体系内（能力判定无法覆盖），但 vendored 面\n * 大量使用（kernelBoundary.ts / wrapperFns / castShape 等）。当前引擎的\n * KernelAdapter 包装必须全部具备，否则对应 compat op / TS compat 面会在执行期崩。\n *\n * Phase 0 盘点实证：36 个 compat op 的 vendored 函数（capability-map 64 方法）与\n * kernelBoundary 都不需要 createAxis*（2D sketcher / TS compat 面需要）——清单按\n * 「vendored 面实际触发面」保守枚举，缺即装配期报错。\n */\nconst GLUE_METHODS = [\n  'createVector3d',\n  'createPoint3d',\n  'createDirection3d',\n  'createAxis1',\n  'createAxis2',\n  'createAxis3',\n] as const\n\nlet _injected = false\n\n/**\n * Inject the currently-registered BREP engine into the vendored kernel registry\n * (replaces the old occt-only `bindOcctKernel()` fixed binding, Phase 2 P2-5).\n *\n * 装配期调用（在 `registerOcctBrepEngine()` / 其它引擎注册之后）。从引擎注册表取\n * 当前默认 BREP 引擎，按其 id 构造 KernelAdapter 形态注册进 vendored registry：\n *\n * - occt：`OcctWasmAdapter.fromKernel(当前引擎 primitives)`——同一 occt-wasm 单实例\n *   （D10 不变），211 方法完整适配器，vendored 函数行为与旧 bindOcctKernel 完全一致；\n * - 其它引擎（brepkit/mock）：将 BrepEngineApi 透传包装为 KernelAdapter 形态\n *   （`dispose`→`release` 等方法名映射 + pattern 返回形态适配），**不做方法伪造**；\n * - 任一引擎注入前都做**装配期完整性检查**（GLUE_METHODS 齐备断言）。\n *\n * 幂等：首次调用后注册并冻结；重复调用返回已注入的适配器。\n *\n * @returns 注册进 vendored registry 的 kernel adapter。\n * @throws 无 BREP 引擎注册；或完整性检查失败（胶水方法缺失）——装配期报错。\n */\nexport async function injectCurrentBrepEngineAsKernel(): Promise<KernelAdapter> {\n  // CDN 宿主跨实例同步：host bundle 已注入则直接复用（同旧 bindOcctKernel 语义）。\n  // 短路判据与 isKernelInjected() 一致（含 registry 侧激活 id 分支），避免\n  // 「registry 已注入但模块级 _injected=false」时走完整路径撞 frozen 抛错。\n  syncRegistryFromGlobal()\n  if (isKernelInjected()) return getVendoredKernel()\n\n  const engine = await getBrepEngine()\n  const adapter = buildKernelAdapter(engine)\n  assertGlueMethodsComplete(engine.id, adapter)\n\n  registerKernel(VENDORED_OCCT_KERNEL_ID, adapter)\n  freezeKernels()\n  _injected = true\n  syncRegistryToGlobal()\n  return adapter\n}\n\n/**\n * 按引擎 id 构造 KernelAdapter 形态（occt 走完整适配器；其它引擎透传包装）。\n *\n * occt 分支保持旧 bindOcctKernel 行为：OcctWasmAdapter.fromKernel 需要 occt-wasm\n * 实例（OcctKernelOwner）。当前引擎的 primitives 即 initOcctWasm 单例（occtApi 是\n * 同一实例的实例覆盖，方法面完整），转换安全。\n *\n * 其它引擎分支：BrepEngineApi → KernelAdapter 契约面——\n *   - `dispose` → `release`（vendored 面用 dispose，BrepEngineApi 用 release）；\n *   - `linearPattern` / `circularPattern` 的方向/中心/轴参数是 Vec3 对象（BrepEngineApi\n *     口径），vendored 面传 [x,y,z] 三元组——包装为对象再转发；\n *   - 返回 BrepHandle[]（BrepEngineApi）→ KernelShape[]（vendored castResultShape 消费\n *     `.wrapped` + `.type`）——包装为 `{ wrapped, type: 'solid' }`；\n *   - `gridPattern` 返回单 BrepHandle → 单 KernelShape（compound 语义一致）。\n * 不声明 `rectangularPattern`（纯 JS 组合，不调内核——capability-map 实证）。\n *\n * ⚠️ 不伪造：BrepEngineApi 未提供的方法**不**补桩；vendored 函数若触发，由\n * compat op 的静态能力判定（backend-dispatch，Phase 1）在执行前拦截。\n *\n * @param engine - 当前 BREP 引擎（装配期从引擎注册表取得）。\n * @returns 该引擎的 vendored KernelAdapter（occt → OcctWasmAdapter.fromKernel；\n *   其它引擎 → BrepEngineApi 透传包装，pattern 族 Vec3↔三元组适配）。\n */\nexport function buildKernelAdapter(engine: BrepEngine): KernelAdapter {\n  if (engine.id === 'occt') {\n    const faijsKernel = engine.primitives as unknown as OcctKernelOwner\n    return OcctWasmAdapter.fromKernel(faijsKernel)\n  }\n  return wrapBrepEngineApi(engine.primitives)\n}\n\n/** No-op `delete` for synthesized glue objects (mirrors vendored `noop`). */\nconst noop = (): void => {}\n\n/**\n * vendored kernel methods with no source capability in BrepEngineApi.\n * Registered explicitly (not silently undefined): tests assert this list and\n * the engine-contract gap is a separate decision, not a wrapping bug. No\n * stubs, no fake zeros — a silent 0 is worse than a crash.\n */\nexport const UNMAPPED_VENDORED_MEASURE_METHODS = [\n  'area',\n  'length',\n  'linearCenterOfMass',\n] as const\n\n/** Unwrap a vendored KernelShape (handle view or bare number) to a BrepHandle. */\nfunction unwrapHandle(h: unknown): unknown {\n  if (typeof h === 'number') return h\n  const view = h as { id?: unknown }\n  return typeof view.id === 'number' ? view.id : h\n}\n\n/**\n * Map vendored measure method names/shapes onto BrepEngineApi capabilities.\n * The vendored measure face calls `kernel.volume/area/length/centerOfMass/...`\n * (its own naming); the occt adapter carries an internal mapping layer — this\n * is the engine-neutral equivalent for any wrapped BrepEngineApi. Only real\n * BrepEngineApi capabilities are mapped; the rest stay in the gap registry.\n */\nfunction mapMeasureMethods(adapter: Record<string, unknown>, api: BrepEngineApi): void {\n  adapter['volume'] = (s: unknown) => api.getVolume(unwrapHandle(s) as never)\n  adapter['centerOfMass'] = (s: unknown): [number, number, number] => {\n    const v = api.getCenterOfMass(unwrapHandle(s) as never)\n    return [v.x, v.y, v.z]\n  }\n  adapter['boundingBox'] = (s: unknown) => {\n    const bb = api.getBoundingBox(unwrapHandle(s) as never, true)\n    return {\n      min: [bb.xmin, bb.ymin, bb.zmin],\n      max: [bb.xmax, bb.ymax, bb.zmax],\n    }\n  }\n  // shapeType / isNull: same name, same semantics — already covered by the\n  // transparent pass-through in wrapBrepEngineApi; listed here for docs only.\n  // Known contract gaps (UNMAPPED_VENDORED_MEASURE_METHODS) are NOT stubbed:\n  // they remain undefined so tests can pin the gap explicitly.\n}\n\n/**\n * Synthesize the vendored glue/auxiliary construction methods over any engine's\n * primitives. These 6 methods are pure JS data-literal constructors in the\n * vendored surface (zero kernel calls — see vendored constructionOps.ts), i.e.\n * a *calling convention*, not a kernel capability — so they are synthesized at\n * the faijs wrapper layer (engine-neutral) rather than added to BrepEngineApi.\n * Field shapes are copied verbatim from the vendored occt adapter; `delete` is\n * mandatory (kernelBoundary's with* helpers call it in `finally`).\n */\nfunction synthesizeGlueMethods(adapter: Record<string, unknown>): void {\n  const pnt = (x: number, y: number, z: number, __type: string) => ({ x, y, z, __type, delete: noop })\n  adapter['createPoint3d'] = (x: number, y: number, z: number) => pnt(x, y, z, 'point3d')\n  adapter['createDirection3d'] = (x: number, y: number, z: number) => pnt(x, y, z, 'direction3d')\n  adapter['createVector3d'] = (x: number, y: number, z: number) => pnt(x, y, z, 'vector3d')\n  adapter['createAxis1'] = (cx: number, cy: number, cz: number, dx: number, dy: number, dz: number) => ({\n    origin: { x: cx, y: cy, z: cz },\n    direction: { x: dx, y: dy, z: dz },\n    __type: 'axis1',\n    delete: noop,\n  })\n  // axis2/axis3: 6- or 9-arg forms (origin + zDir + optional xDir).\n  const makeAxis = (__type: 'axis2' | 'axis3') =>\n    (ox: number, oy: number, oz: number, zx: number, zy: number, zz: number, xx?: number, xy?: number, xz?: number) => ({\n      origin: { x: ox, y: oy, z: oz },\n      zDir: { x: zx, y: zy, z: zz },\n      xDir: xx !== undefined ? { x: xx, y: xy as number, z: xz as number } : undefined,\n      __type,\n      delete: noop,\n    })\n  adapter['createAxis2'] = makeAxis('axis2')\n  adapter['createAxis3'] = makeAxis('axis3')\n}\n\n/** 把 BrepEngineApi 透传包装为 KernelAdapter 形态（非 occt 引擎）。 */\nfunction wrapBrepEngineApi(api: BrepEngineApi): KernelAdapter {\n  const adapter: Record<string, unknown> = {\n    // 生命周期：vendored 面统一用 dispose（BrepEngineApi 用 release）。\n    dispose: (h: unknown) => api.release(h as never),\n  }\n  synthesizeGlueMethods(adapter)\n  for (const key of Object.keys(api)) {\n    if (key === 'release') continue // 上面已映射为 dispose\n    adapter[key] = (api as unknown as Record<string, unknown>)[key]\n  }\n  // 测量面映射在透传之后追加，覆盖同名键（vendored 名 → BrepEngineApi 名 + 形态转换）。\n  mapMeasureMethods(adapter, api)\n  // pattern 族形态适配（BrepEngineApi 对象 Vec3 ↔ vendored 三元组）。\n  adapter['linearPattern'] = (\n    shape: unknown,\n    direction: [number, number, number],\n    spacing: number,\n    count: number,\n  ) =>\n    api.linearPattern(\n      shape as never,\n      { x: direction[0], y: direction[1], z: direction[2] },\n      spacing,\n      count,\n    ).map((h) => ({ wrapped: h, type: 'solid' }))\n  adapter['circularPattern'] = (\n    shape: unknown,\n    center: [number, number, number],\n    axis: [number, number, number],\n    angleStep: number,\n    count: number,\n  ) =>\n    api.circularPattern(\n      shape as never,\n      { x: center[0], y: center[1], z: center[2] },\n      { x: axis[0], y: axis[1], z: axis[2] },\n      angleStep,\n      count,\n    ).map((h) => ({ wrapped: h, type: 'solid' }))\n  adapter['gridPattern'] = (\n    shape: unknown,\n    directionX: [number, number, number],\n    directionY: [number, number, number],\n    spacingX: number,\n    spacingY: number,\n    countX: number,\n    countY: number,\n  ) => ({\n    wrapped: api.gridPattern(\n      shape as never,\n      { x: directionX[0], y: directionX[1], z: directionX[2] },\n      { x: directionY[0], y: directionY[1], z: directionY[2] },\n      spacingX,\n      spacingY,\n      countX,\n      countY,\n    ),\n    type: 'compound',\n  })\n  return adapter as unknown as KernelAdapter\n}\n\n/**\n * 装配期完整性检查：KernelAdapter 胶水方法齐备断言。\n *\n * @param id - 引擎注册 id（报错时定位到引擎）。\n * @param adapter - 待注入 vendored registry 的 KernelAdapter。\n * @throws 缺失任一胶水方法 → 装配期报错（列出引擎 id 与缺失方法名）。\n */\nexport function assertGlueMethodsComplete(id: string, adapter: KernelAdapter): void {\n  const missing = GLUE_METHODS.filter((m) => typeof (adapter as unknown as Record<string, unknown>)[m] !== 'function')\n  if (missing.length > 0) {\n    throw new Error(\n      `[faijs] BREP engine '${id}' cannot back the vendored compat surface: KernelAdapter ` +\n        `missing glue method(s): ${missing.join(', ')}. These auxiliary construction methods ` +\n        `(createVector3d / createPoint3d / createDirection3d / createAxis1/2/3) are required by ` +\n        `the vendored kernel boundary and cannot be covered by capability declarations. ` +\n        `Fix the adapter (add real implementations) or do not inject this engine into the vendored registry.`\n    )\n  }\n}\n\n/**\n * Test-only: clear the injection cache and reset the vendored kernel registry\n * so a re-assembly (e.g. switching engines in tests) re-runs buildKernelAdapter\n * + assertGlueMethodsComplete for the new engine. Never called in prod.\n */\nexport function __resetKernelInjectionForTests(): void {\n  _injected = false\n  __resetKernelRegistryForTests()\n}\n\n/**\n * Whether the vendored kernel registry has been injected (engine-neutral D10).\n *\n * 取代旧的 `isOcctKernelBound()`（其判据 `_bound && getActiveKernelId() === 'occt-wasm'`\n * 把注入面写死为 occt）。新判据只问「vendored registry 是否已注入当前引擎」——\n * 不关心引擎 id，装配期换引擎（brepkit/mock）同样成立。\n *\n * @returns 注入是否已完成（vendored registry 已装配当前 BREP 引擎）。\n */\nexport function isKernelInjected(): boolean {\n  syncRegistryFromGlobal()\n  return _injected || getActiveKernelId() !== null\n}\n\n/**\n * Access the currently injected vendored kernel adapter (reads the registry).\n * @throws If the bridge has not been injected.\n * @returns the vendored kernel adapter for the current BREP engine.\n */\nexport function getBrepjsKernel(): KernelAdapter {\n  return getVendoredKernel()\n}\n\n/**\n * 固定绑定 occt 内核到 vendored registry（Phase 2 前的装配方式）。\n *\n * @deprecated Phase 2 P2-5：固定绑定已被引擎中立的 injectCurrentBrepEngineAsKernel\n * 取代。保留导出仅为兼容旧调用点（适配器层迁移期）；新代码一律用注入函数。\n * @returns 恒抛错——本函数已移除，仅保留签名占位。\n */\nexport function bindOcctKernel(): KernelAdapter {\n  void getFaijsKernel\n  throw new Error(\n    '[faijs] bindOcctKernel() removed (Phase 2 P2-5): use injectCurrentBrepEngineAsKernel() ' +\n      'during host assembly to inject the current BREP engine into the vendored registry.'\n  )\n}\n\n/**\n * 旧 occt 专用注入判据（Phase 2 前语义：绑定且激活内核为 occt-wasm）。\n *\n * @deprecated Phase 2 P2-5：occt 专用判据已被引擎中立的 isKernelInjected() 取代。\n * @returns 当前是否已注入（透传 isKernelInjected()）。\n */\nexport function isOcctKernelBound(): boolean {\n  return isKernelInjected()\n}\n"]}
+{"version":3,"file":"occt-kernel-bridge.js","sourceRoot":"","sources":["../../src/api/occt-kernel-bridge.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * L3 bridge — vendored kernel registry injection (engine-neutral, Phase 2 P2-5).\n *\n * @platform occt — 本文件 import occt-kernel（occtKernel）：桥接层把当前引擎的\n *   BrepEngineApi 适配器包装为 brepjs KernelAdapter 注入 vendored registry，平台\n *   类型（OcctKernel 句柄）只在桥内出现；守卫 R1 豁免、R2 无 defineOp 不适用。\n *\n * 原 occt-kernel-bridge 的职责是「把 vendored kernel registry 冻结绑定到 occt-wasm\n * 单实例」（D10）。Phase 2 起改为**跟随当前 BREP 引擎**：装配期把 registry 里当前\n * 引擎（occt / brepkit / mock）的 `BrepEngineApi` 适配器包装为 brepjs `KernelAdapter`\n * 形态注册进 vendored registry，使 `vendoredRegistry.getKernel()` 返回当前引擎——\n * vendored 函数全部逻辑（命名/角色表/Result）原样保留、零改动。\n *\n * 边界规则（D8/R5）不变：本文件是 faijs 侧唯一把 vendored kernel registry 与\n * faijs 引擎接线的地方；core 侧只从 `api/` import vendored 树。\n *\n * 装配期完整性检查（方案 §Phase 2.5）：KernelAdapter 是 211 方法大接口，但 vendored\n * 面存在大量**辅助构造方法**（createVector3d / createPoint3d / createDirection3d /\n * createAxis1 / createAxis2 / createAxis3，见 vendored core/kernelBoundary.ts）——\n * 它们不落在能力名体系内（BrepMethodKind 之外）、无法由 op 声明覆盖，任何 compat\n * op / TS compat 面都可能触发。⇒ 注入前必须断言这些胶水方法在适配器上齐备，缺失\n * 则在**装配期**报错（而非执行期崩）。清单见 {@link GLUE_METHODS}。\n */\n\nimport { getKernel as getFaijsKernel } from '../occt-kernel/occtKernel'\nimport { getBrepEngine, type BrepEngine } from '../brep/engine/registry'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { OcctWasmAdapter } from '@faicad/faijs-brepjs/kernel/occtWasm/occtWasmAdapter.js'\nimport {\n  freezeKernels,\n  getActiveKernelId,\n  getKernel as getVendoredKernel,\n  registerKernel,\n  syncRegistryFromGlobal,\n  syncRegistryToGlobal,\n  __resetKernelRegistryForTests,\n} from '@faicad/faijs-brepjs/kernel/index.js'\nimport type { KernelAdapter } from '@faicad/faijs-brepjs/kernel/types.js'\n\n/** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的\n * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——\n * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */\nexport const VENDORED_OCCT_KERNEL_ID = 'occt-wasm'\n\n/**\n * 装配期完整性检查清单——vendored 面辅助构造/生命周期胶水方法。\n *\n * 这些方法不在 `BrepMethodKind` 能力名体系内（能力判定无法覆盖），但 vendored 面\n * 大量使用（kernelBoundary.ts / wrapperFns / castShape 等）。当前引擎的\n * KernelAdapter 包装必须全部具备，否则对应 compat op / TS compat 面会在执行期崩。\n *\n * Phase 0 盘点实证：36 个 compat op 的 vendored 函数（capability-map 64 方法）与\n * kernelBoundary 都不需要 createAxis*（2D sketcher / TS compat 面需要）——清单按\n * 「vendored 面实际触发面」保守枚举，缺即装配期报错。\n */\nconst GLUE_METHODS = [\n  'createVector3d',\n  'createPoint3d',\n  'createDirection3d',\n  'createAxis1',\n  'createAxis2',\n  'createAxis3',\n] as const\n\nlet _injected = false\n\n/**\n * Inject the currently-registered BREP engine into the vendored kernel registry\n * (replaces the old occt-only `bindOcctKernel()` fixed binding, Phase 2 P2-5).\n *\n * 装配期调用（在 `registerOcctBrepEngine()` / 其它引擎注册之后）。从引擎注册表取\n * 当前默认 BREP 引擎，按其 id 构造 KernelAdapter 形态注册进 vendored registry：\n *\n * - occt：`OcctWasmAdapter.fromKernel(当前引擎 primitives)`——同一 occt-wasm 单实例\n *   （D10 不变），211 方法完整适配器，vendored 函数行为与旧 bindOcctKernel 完全一致；\n * - 其它引擎（brepkit/mock）：将 BrepEngineApi 透传包装为 KernelAdapter 形态\n *   （`dispose`→`release` 等方法名映射 + pattern 返回形态适配），**不做方法伪造**；\n * - 任一引擎注入前都做**装配期完整性检查**（GLUE_METHODS 齐备断言）。\n *\n * 幂等：首次调用后注册并冻结；重复调用返回已注入的适配器。\n *\n * @returns 注册进 vendored registry 的 kernel adapter。\n * @throws 无 BREP 引擎注册；或完整性检查失败（胶水方法缺失）——装配期报错。\n */\nexport async function injectCurrentBrepEngineAsKernel(): Promise<KernelAdapter> {\n  // CDN 宿主跨实例同步：host bundle 已注入则直接复用（同旧 bindOcctKernel 语义）。\n  // 短路判据与 isKernelInjected() 一致（含 registry 侧激活 id 分支），避免\n  // 「registry 已注入但模块级 _injected=false」时走完整路径撞 frozen 抛错。\n  syncRegistryFromGlobal()\n  if (isKernelInjected()) return getVendoredKernel()\n\n  const engine = await getBrepEngine()\n  const adapter = buildKernelAdapter(engine)\n  assertGlueMethodsComplete(engine.id, adapter)\n\n  registerKernel(VENDORED_OCCT_KERNEL_ID, adapter)\n  freezeKernels()\n  _injected = true\n  syncRegistryToGlobal()\n  return adapter\n}\n\n/**\n * 按引擎 id 构造 KernelAdapter 形态（occt 走完整适配器；其它引擎透传包装）。\n *\n * occt 分支保持旧 bindOcctKernel 行为：OcctWasmAdapter.fromKernel 需要 occt-wasm\n * 实例（OcctKernelOwner）。当前引擎的 primitives 即 initOcctWasm 单例（occtApi 是\n * 同一实例的实例覆盖，方法面完整），转换安全。\n *\n * 其它引擎分支：BrepEngineApi → KernelAdapter 契约面——\n *   - `dispose` → `release`（vendored 面用 dispose，BrepEngineApi 用 release）；\n *   - `linearPattern` / `circularPattern` 的方向/中心/轴参数是 Vec3 对象（BrepEngineApi\n *     口径），vendored 面传 [x,y,z] 三元组——包装为对象再转发；\n *   - 返回 BrepHandle[]（BrepEngineApi）→ KernelShape[]（vendored castResultShape 消费\n *     `.wrapped` + `.type`）——包装为 `{ wrapped, type: 'solid' }`；\n *   - `gridPattern` 返回单 BrepHandle → 单 KernelShape（compound 语义一致）。\n * 不声明 `rectangularPattern`（纯 JS 组合，不调内核——capability-map 实证）。\n *\n * ⚠️ 不伪造：BrepEngineApi 未提供的方法**不**补桩；vendored 函数若触发，由\n * compat op 的静态能力判定（backend-dispatch，Phase 1）在执行前拦截。\n *\n * @param engine - 当前 BREP 引擎（装配期从引擎注册表取得）。\n * @returns 该引擎的 vendored KernelAdapter（occt → OcctWasmAdapter.fromKernel；\n *   其它引擎 → BrepEngineApi 透传包装，pattern 族 Vec3↔三元组适配）。\n */\nexport function buildKernelAdapter(engine: BrepEngine): KernelAdapter {\n  if (engine.id === 'occt') {\n    // Phase 3 (narrowing plan): engine.primitives is now the L1 adapter object\n    // (createOcctPrimitives), NOT the raw kernel — the old cast lied. The\n    // vendored full adapter needs the raw occt-wasm singleton, which is exactly\n    // what getKernel() returns (process-level singleton, D10 unchanged).\n    const faijsKernel = getFaijsKernel()\n    return OcctWasmAdapter.fromKernel(faijsKernel)\n  }\n  return wrapBrepEngineApi(engine.primitives)\n}\n\n/** No-op `delete` for synthesized glue objects (mirrors vendored `noop`). */\nconst noop = (): void => {}\n\n/**\n * vendored 测量名 ↔ BrepEngineApi 能力映射（Phase 6 收口，D7）：\n * area/length 已映射到 L1 测量面（getSurfaceArea/getLength，Phase 4 D9 接线）；\n * linearCenterOfMass 无 L1 对应（L2 平台面，primitives.ts 注释），保留真实缺口——\n * 不补桩、不返回 0（静默 0 比崩溃更糟），测试内联钉住 undefined。\n */\n\n/** Unwrap a vendored KernelShape (handle view or bare number) to a BrepHandle. */\nfunction unwrapHandle(h: unknown): unknown {\n  if (typeof h === 'number') return h\n  const view = h as { id?: unknown }\n  return typeof view.id === 'number' ? view.id : h\n}\n\n/**\n * Map vendored measure method names/shapes onto BrepEngineApi capabilities.\n * The vendored measure face calls `kernel.volume/area/length/centerOfMass/...`\n * (its own naming); the occt adapter carries an internal mapping layer — this\n * is the engine-neutral equivalent for any wrapped BrepEngineApi. Only real\n * BrepEngineApi capabilities are mapped; the rest stay in the gap registry.\n */\nfunction mapMeasureMethods(adapter: Record<string, unknown>, api: BrepEngineApi): void {\n  adapter['volume'] = (s: unknown) => api.getVolume(unwrapHandle(s) as never)\n  adapter['centerOfMass'] = (s: unknown): [number, number, number] => {\n    const v = api.getCenterOfMass(unwrapHandle(s) as never)\n    return [v.x, v.y, v.z]\n  }\n  adapter['boundingBox'] = (s: unknown) => {\n    const bb = api.getBoundingBox(unwrapHandle(s) as never, true)\n    return {\n      min: [bb.xmin, bb.ymin, bb.zmin],\n      max: [bb.xmax, bb.ymax, bb.zmax],\n    }\n  }\n  adapter['area'] = (s: unknown) => api.getSurfaceArea(unwrapHandle(s) as never)\n  adapter['length'] = (s: unknown) => api.getLength(unwrapHandle(s) as never)\n  // shapeType / isNull: same name, same semantics — already covered by the\n  // transparent pass-through in wrapBrepEngineApi; listed here for docs only.\n  // linearCenterOfMass（L2 平台面）无 L1 对应，保持 undefined（缺口由测试内联钉住）。\n}\n\n/**\n * Synthesize the vendored glue/auxiliary construction methods over any engine's\n * primitives. These 6 methods are pure JS data-literal constructors in the\n * vendored surface (zero kernel calls — see vendored constructionOps.ts), i.e.\n * a *calling convention*, not a kernel capability — so they are synthesized at\n * the faijs wrapper layer (engine-neutral) rather than added to BrepEngineApi.\n * Field shapes are copied verbatim from the vendored occt adapter; `delete` is\n * mandatory (kernelBoundary's with* helpers call it in `finally`).\n */\nfunction synthesizeGlueMethods(adapter: Record<string, unknown>): void {\n  const pnt = (x: number, y: number, z: number, __type: string) => ({ x, y, z, __type, delete: noop })\n  adapter['createPoint3d'] = (x: number, y: number, z: number) => pnt(x, y, z, 'point3d')\n  adapter['createDirection3d'] = (x: number, y: number, z: number) => pnt(x, y, z, 'direction3d')\n  adapter['createVector3d'] = (x: number, y: number, z: number) => pnt(x, y, z, 'vector3d')\n  adapter['createAxis1'] = (cx: number, cy: number, cz: number, dx: number, dy: number, dz: number) => ({\n    origin: { x: cx, y: cy, z: cz },\n    direction: { x: dx, y: dy, z: dz },\n    __type: 'axis1',\n    delete: noop,\n  })\n  // axis2/axis3: 6- or 9-arg forms (origin + zDir + optional xDir).\n  const makeAxis = (__type: 'axis2' | 'axis3') =>\n    (ox: number, oy: number, oz: number, zx: number, zy: number, zz: number, xx?: number, xy?: number, xz?: number) => ({\n      origin: { x: ox, y: oy, z: oz },\n      zDir: { x: zx, y: zy, z: zz },\n      xDir: xx !== undefined ? { x: xx, y: xy as number, z: xz as number } : undefined,\n      __type,\n      delete: noop,\n    })\n  adapter['createAxis2'] = makeAxis('axis2')\n  adapter['createAxis3'] = makeAxis('axis3')\n}\n\n/** 把 BrepEngineApi 透传包装为 KernelAdapter 形态（非 occt 引擎）。 */\nfunction wrapBrepEngineApi(api: BrepEngineApi): KernelAdapter {\n  const adapter: Record<string, unknown> = {\n    // 生命周期：vendored 面统一用 dispose（BrepEngineApi 用 release）。\n    dispose: (h: unknown) => api.release(h as never),\n  }\n  synthesizeGlueMethods(adapter)\n  for (const key of Object.keys(api)) {\n    if (key === 'release') continue // 上面已映射为 dispose\n    adapter[key] = (api as unknown as Record<string, unknown>)[key]\n  }\n  // 测量面映射在透传之后追加，覆盖同名键（vendored 名 → BrepEngineApi 名 + 形态转换）。\n  mapMeasureMethods(adapter, api)\n  // pattern 族形态适配（BrepEngineApi 对象 Vec3 ↔ vendored 三元组）。\n  adapter['linearPattern'] = (\n    shape: unknown,\n    direction: [number, number, number],\n    spacing: number,\n    count: number,\n  ) =>\n    api.linearPattern(\n      shape as never,\n      { x: direction[0], y: direction[1], z: direction[2] },\n      spacing,\n      count,\n    ).map((h) => ({ wrapped: h, type: 'solid' }))\n  adapter['circularPattern'] = (\n    shape: unknown,\n    center: [number, number, number],\n    axis: [number, number, number],\n    angleStep: number,\n    count: number,\n  ) =>\n    api.circularPattern(\n      shape as never,\n      { x: center[0], y: center[1], z: center[2] },\n      { x: axis[0], y: axis[1], z: axis[2] },\n      angleStep,\n      count,\n    ).map((h) => ({ wrapped: h, type: 'solid' }))\n  adapter['gridPattern'] = (\n    shape: unknown,\n    directionX: [number, number, number],\n    directionY: [number, number, number],\n    spacingX: number,\n    spacingY: number,\n    countX: number,\n    countY: number,\n  ) => ({\n    wrapped: api.gridPattern(\n      shape as never,\n      { x: directionX[0], y: directionX[1], z: directionX[2] },\n      { x: directionY[0], y: directionY[1], z: directionY[2] },\n      spacingX,\n      spacingY,\n      countX,\n      countY,\n    ),\n    type: 'compound',\n  })\n  return adapter as unknown as KernelAdapter\n}\n\n/**\n * 装配期完整性检查：KernelAdapter 胶水方法齐备断言。\n *\n * @param id - 引擎注册 id（报错时定位到引擎）。\n * @param adapter - 待注入 vendored registry 的 KernelAdapter。\n * @throws 缺失任一胶水方法 → 装配期报错（列出引擎 id 与缺失方法名）。\n */\nexport function assertGlueMethodsComplete(id: string, adapter: KernelAdapter): void {\n  const missing = GLUE_METHODS.filter((m) => typeof (adapter as unknown as Record<string, unknown>)[m] !== 'function')\n  if (missing.length > 0) {\n    throw new Error(\n      `[faijs] BREP engine '${id}' cannot back the vendored compat surface: KernelAdapter ` +\n        `missing glue method(s): ${missing.join(', ')}. These auxiliary construction methods ` +\n        `(createVector3d / createPoint3d / createDirection3d / createAxis1/2/3) are required by ` +\n        `the vendored kernel boundary and cannot be covered by capability declarations. ` +\n        `Fix the adapter (add real implementations) or do not inject this engine into the vendored registry.`\n    )\n  }\n}\n\n/**\n * Test-only: clear the injection cache and reset the vendored kernel registry\n * so a re-assembly (e.g. switching engines in tests) re-runs buildKernelAdapter\n * + assertGlueMethodsComplete for the new engine. Never called in prod.\n */\nexport function __resetKernelInjectionForTests(): void {\n  _injected = false\n  __resetKernelRegistryForTests()\n}\n\n/**\n * Whether the vendored kernel registry has been injected (engine-neutral D10).\n *\n * 取代旧的 `isOcctKernelBound()`（其判据 `_bound && getActiveKernelId() === 'occt-wasm'`\n * 把注入面写死为 occt）。新判据只问「vendored registry 是否已注入当前引擎」——\n * 不关心引擎 id，装配期换引擎（brepkit/mock）同样成立。\n *\n * @returns 注入是否已完成（vendored registry 已装配当前 BREP 引擎）。\n */\nexport function isKernelInjected(): boolean {\n  syncRegistryFromGlobal()\n  return _injected || getActiveKernelId() !== null\n}\n\n/**\n * Access the currently injected vendored kernel adapter (reads the registry).\n * @throws If the bridge has not been injected.\n * @returns the vendored kernel adapter for the current BREP engine.\n */\nexport function getBrepjsKernel(): KernelAdapter {\n  return getVendoredKernel()\n}\n\n/**\n * 固定绑定 occt 内核到 vendored registry（Phase 2 前的装配方式）。\n *\n * @deprecated Phase 2 P2-5：固定绑定已被引擎中立的 injectCurrentBrepEngineAsKernel\n * 取代。保留导出仅为兼容旧调用点（适配器层迁移期）；新代码一律用注入函数。\n * @returns 恒抛错——本函数已移除，仅保留签名占位。\n */\nexport function bindOcctKernel(): KernelAdapter {\n  void getFaijsKernel\n  throw new Error(\n    '[faijs] bindOcctKernel() removed (Phase 2 P2-5): use injectCurrentBrepEngineAsKernel() ' +\n      'during host assembly to inject the current BREP engine into the vendored registry.'\n  )\n}\n\n/**\n * 旧 occt 专用注入判据（Phase 2 前语义：绑定且激活内核为 occt-wasm）。\n *\n * @deprecated Phase 2 P2-5：occt 专用判据已被引擎中立的 isKernelInjected() 取代。\n * @returns 当前是否已注入（透传 isKernelInjected()）。\n */\nexport function isOcctKernelBound(): boolean {\n  return isKernelInjected()\n}\n"]}

package/dist/api/pattern.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAqDhD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;;CAUxB,CAAA"}
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAoDhD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;;CAUxB,CAAA"}

package/dist/api/pattern.js

@@ -9,7 +9,8 @@
  * 倍数即得 k；再按「面内坐标」（centroid − t·dir）匹配输入面对应面，回投其 inner role。
  */
 import { solidToShape } from '../brep/brep-ops.js';
-import { getBackends, getCurrentStmt, keep } from '../runtime-state.js';
+import { getCurrentStmt, keep } from '../runtime-state.js';
+import { getBrepApi } from '../brep/handle-bridge.js';
 import { fromBrep, brepOf } from '../shape.js';
 import { defineOp } from '../sdk.js';
 import { buildReplicaRoleTable } from './internal/replica-role-table.js';
@@ -22,9 +23,7 @@ function norm(v) {
 }
 /** BREP 路径：沿 direction 复制 count 份，质心聚类回投输入面角色。 */
 function linearPatternBrep(input, direction, count, spacing) {
-    const kernel = getBackends().kernel.brep;
-    if (!kernel)
-        throw new Error('[stdlib/pattern] no OCCT kernel');
+    const kernel = getBrepApi();
     const inputSolid = brepOf(input);
     if (!inputSolid)
         throw new Error('[stdlib/pattern] input is not BREP');