@faicad/faijs 0.14.1 → 0.16.0

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

@@ -1,65 +1,279 @@
 /**
- * L3 bridge — occt-wasm kernel single-instance injection (D10).
+ * L3 bridge — vendored kernel registry injection (engine-neutral, Phase 2 P2-5).
  *
- * The ported `kernel/occtWasm` adapter is constructor-injected (DI form, never
- * imports `occt-wasm` itself). This file is the **only** faijs-side place
- * wiring the two together (boundary rule D8/R5: core side may import the
- * vendored tree only from `api/`):
+ * 原 occt-kernel-bridge 的职责是「把 vendored kernel registry 冻结绑定到 occt-wasm
+ * 单实例」（D10）。Phase 2 起改为**跟随当前 BREP 引擎**：装配期把 registry 里当前
+ * 引擎（occt / brepkit / mock）的 `BrepEngineApi` 适配器包装为 brepjs `KernelAdapter`
+ * 形态注册进 vendored registry，使 `vendoredRegistry.getKernel()` 返回当前引擎——
+ * vendored 函数全部逻辑（命名/角色表/Result）原样保留、零改动。
  *
- *   initOcctWasm()  ──same instance──▶  OcctWasmAdapter  ──▶  registerKernel
- *   (faijs existing                (vendored, DI)             (vendored kernel
- *    occt singleton)                                            registry, D10)
+ * 边界规则（D8/R5）不变：本文件是 faijs 侧唯一把 vendored kernel registry 与
+ * faijs 引擎接线的地方；core 侧只从 `api/` import vendored 树。
  *
- * `occtKernel.getKernel()` returns the faijs singleton `OcctKernel`; building
- * the adapter over that exact instance guarantees the single-instance ban
- * (D10: two wasm instances would put handles in different pointer spaces and
- * silently desync `hasBrep`/`brepOf`/face evolution).
- *
- * See docs/plans/2026-09-01-layered-api-architecture.md §D10 / §D8.
+ * 装配期完整性检查（方案 §Phase 2.5）：KernelAdapter 是 211 方法大接口，但 vendored
+ * 面存在大量**辅助构造方法**（createVector3d / createPoint3d / createDirection3d /
+ * createAxis1 / createAxis2 / createAxis3，见 vendored core/kernelBoundary.ts）——
+ * 它们不落在能力名体系内（BrepMethodKind 之外）、无法由 op 声明覆盖，任何 compat
+ * op / TS compat 面都可能触发。⇒ 注入前必须断言这些胶水方法在适配器上齐备，缺失
+ * 则在**装配期**报错（而非执行期崩）。清单见 {@link GLUE_METHODS}。
  */
 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, } from '../vendored/brepjs/kernel/index.js';
-let _bound = false;
+import { freezeKernels, getActiveKernelId, getKernel as getVendoredKernel, registerKernel, syncRegistryFromGlobal, syncRegistryToGlobal, __resetKernelRegistryForTests, } from '../vendored/brepjs/kernel/index.js';
+/** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的
+ * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——
+ * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */
+export const VENDORED_OCCT_KERNEL_ID = 'occt-wasm';
 /**
- * Bind the ported kernel registry to the faijs single occt-wasm instance.
+ * 装配期完整性检查清单——vendored 面辅助构造/生命周期胶水方法。
  *
- * Idempotent: the first call registers the adapter and freezes the registry
- * (D10 冻结); subsequent calls return the already-bound adapter without
- * re-registering. Call after `initOcctWasm()` has been run (e.g. inside
- * `registerOcctBrepEngine()` host assembly).
+ * 这些方法不在 `BrepMethodKind` 能力名体系内（能力判定无法覆盖），但 vendored 面
+ * 大量使用（kernelBoundary.ts / wrapperFns / castShape 等）。当前引擎的
+ * KernelAdapter 包装必须全部具备，否则对应 compat op / TS compat 面会在执行期崩。
  *
- * @returns the registered kernel adapter.
+ * Phase 0 盘点实证：36 个 compat op 的 vendored 函数（capability-map 64 方法）与
+ * kernelBoundary 都不需要 createAxis*（2D sketcher / TS compat 面需要）——清单按
+ * 「vendored 面实际触发面」保守枚举，缺即装配期报错。
  */
-export function bindOcctKernel() {
-    // Check the SHARED registry first (globalThis singleton): a CDN-bundled faijs
-    // instance has its own module-level `_bound = false`, but the host bundle may
-    // already have registered+bound 'occt-wasm'. Re-registering would throw
-    // "registry frozen" — treat an existing binding as bound instead.
+const GLUE_METHODS = [
+    'createVector3d',
+    'createPoint3d',
+    'createDirection3d',
+    'createAxis1',
+    'createAxis2',
+    'createAxis3',
+];
+let _injected = false;
+/**
+ * Inject the currently-registered BREP engine into the vendored kernel registry
+ * (replaces the old occt-only `bindOcctKernel()` fixed binding, Phase 2 P2-5).
+ *
+ * 装配期调用（在 `registerOcctBrepEngine()` / 其它引擎注册之后）。从引擎注册表取
+ * 当前默认 BREP 引擎，按其 id 构造 KernelAdapter 形态注册进 vendored registry：
+ *
+ * - occt：`OcctWasmAdapter.fromKernel(当前引擎 primitives)`——同一 occt-wasm 单实例
+ *   （D10 不变），211 方法完整适配器，vendored 函数行为与旧 bindOcctKernel 完全一致；
+ * - 其它引擎（brepkit/mock）：将 BrepEngineApi 透传包装为 KernelAdapter 形态
+ *   （`dispose`→`release` 等方法名映射 + pattern 返回形态适配），**不做方法伪造**；
+ * - 任一引擎注入前都做**装配期完整性检查**（GLUE_METHODS 齐备断言）。
+ *
+ * 幂等：首次调用后注册并冻结；重复调用返回已注入的适配器。
+ *
+ * @returns 注册进 vendored registry 的 kernel adapter。
+ * @throws 无 BREP 引擎注册；或完整性检查失败（胶水方法缺失）——装配期报错。
+ */
+export async function injectCurrentBrepEngineAsKernel() {
+    // CDN 宿主跨实例同步：host bundle 已注入则直接复用（同旧 bindOcctKernel 语义）。
+    // 短路判据与 isKernelInjected() 一致（含 registry 侧激活 id 分支），避免
+    // 「registry 已注入但模块级 _injected=false」时走完整路径撞 frozen 抛错。
     syncRegistryFromGlobal();
-    if (_bound)
-        return getVendoredKernel('occt-wasm');
-    const faijsKernel = getFaijsKernel();
-    const adapter = OcctWasmAdapter.fromKernel(faijsKernel);
-    registerKernel('occt-wasm', adapter);
+    if (isKernelInjected())
+        return getVendoredKernel();
+    const engine = await getBrepEngine();
+    const adapter = buildKernelAdapter(engine);
+    assertGlueMethodsComplete(engine.id, adapter);
+    registerKernel(VENDORED_OCCT_KERNEL_ID, adapter);
     freezeKernels();
-    _bound = true;
+    _injected = true;
     syncRegistryToGlobal();
     return adapter;
 }
 /**
- * Whether the vendored kernel registry has been bound (D10).
- * @returns true once bound to the occt-wasm kernel.
+ * 按引擎 id 构造 KernelAdapter 形态（occt 走完整适配器；其它引擎透传包装）。
+ *
+ * occt 分支保持旧 bindOcctKernel 行为：OcctWasmAdapter.fromKernel 需要 occt-wasm
+ * 实例（OcctKernelOwner）。当前引擎的 primitives 即 initOcctWasm 单例（occtApi 是
+ * 同一实例的实例覆盖，方法面完整），转换安全。
+ *
+ * 其它引擎分支：BrepEngineApi → KernelAdapter 契约面——
+ *   - `dispose` → `release`（vendored 面用 dispose，BrepEngineApi 用 release）；
+ *   - `linearPattern` / `circularPattern` 的方向/中心/轴参数是 Vec3 对象（BrepEngineApi
+ *     口径），vendored 面传 [x,y,z] 三元组——包装为对象再转发；
+ *   - 返回 BrepHandle[]（BrepEngineApi）→ KernelShape[]（vendored castResultShape 消费
+ *     `.wrapped` + `.type`）——包装为 `{ wrapped, type: 'solid' }`；
+ *   - `gridPattern` 返回单 BrepHandle → 单 KernelShape（compound 语义一致）。
+ * 不声明 `rectangularPattern`（纯 JS 组合，不调内核——capability-map 实证）。
+ *
+ * ⚠️ 不伪造：BrepEngineApi 未提供的方法**不**补桩；vendored 函数若触发，由
+ * compat op 的静态能力判定（backend-dispatch，Phase 1）在执行前拦截。
+ *
+ * @param engine - 当前 BREP 引擎（装配期从引擎注册表取得）。
+ * @returns 该引擎的 vendored KernelAdapter（occt → OcctWasmAdapter.fromKernel；
+ *   其它引擎 → BrepEngineApi 透传包装，pattern 族 Vec3↔三元组适配）。
+ */
+export function buildKernelAdapter(engine) {
+    if (engine.id === 'occt') {
+        const faijsKernel = engine.primitives;
+        return OcctWasmAdapter.fromKernel(faijsKernel);
+    }
+    return wrapBrepEngineApi(engine.primitives);
+}
+/** 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.
  */
-export function isOcctKernelBound() {
-    return _bound && getActiveKernelId() === 'occt-wasm';
+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')
+        return h;
+    const view = h;
+    return typeof view.id === 'number' ? view.id : h;
+}
+/**
+ * Map vendored measure method names/shapes onto BrepEngineApi capabilities.
+ * The vendored measure face calls `kernel.volume/area/length/centerOfMass/...`
+ * (its own naming); the occt adapter carries an internal mapping layer — this
+ * is the engine-neutral equivalent for any wrapped BrepEngineApi. Only real
+ * BrepEngineApi capabilities are mapped; the rest stay in the gap registry.
+ */
+function mapMeasureMethods(adapter, api) {
+    adapter['volume'] = (s) => api.getVolume(unwrapHandle(s));
+    adapter['centerOfMass'] = (s) => {
+        const v = api.getCenterOfMass(unwrapHandle(s));
+        return [v.x, v.y, v.z];
+    };
+    adapter['boundingBox'] = (s) => {
+        const bb = api.getBoundingBox(unwrapHandle(s), true);
+        return {
+            min: [bb.xmin, bb.ymin, bb.zmin],
+            max: [bb.xmax, bb.ymax, bb.zmax],
+        };
+    };
+    // 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.
 }
 /**
- * Access the currently bound vendored kernel adapter (reads the registry).
- * @throws If the bridge has not been bound.
- * @returns the vendored occt-wasm kernel adapter.
+ * Synthesize the vendored glue/auxiliary construction methods over any engine's
+ * primitives. These 6 methods are pure JS data-literal constructors in the
+ * vendored surface (zero kernel calls — see vendored constructionOps.ts), i.e.
+ * a *calling convention*, not a kernel capability — so they are synthesized at
+ * the faijs wrapper layer (engine-neutral) rather than added to BrepEngineApi.
+ * Field shapes are copied verbatim from the vendored occt adapter; `delete` is
+ * mandatory (kernelBoundary's with* helpers call it in `finally`).
+ */
+function synthesizeGlueMethods(adapter) {
+    const pnt = (x, y, z, __type) => ({ x, y, z, __type, delete: noop });
+    adapter['createPoint3d'] = (x, y, z) => pnt(x, y, z, 'point3d');
+    adapter['createDirection3d'] = (x, y, z) => pnt(x, y, z, 'direction3d');
+    adapter['createVector3d'] = (x, y, z) => pnt(x, y, z, 'vector3d');
+    adapter['createAxis1'] = (cx, cy, cz, dx, dy, dz) => ({
+        origin: { x: cx, y: cy, z: cz },
+        direction: { x: dx, y: dy, z: dz },
+        __type: 'axis1',
+        delete: noop,
+    });
+    // axis2/axis3: 6- or 9-arg forms (origin + zDir + optional xDir).
+    const makeAxis = (__type) => (ox, oy, oz, zx, zy, zz, xx, xy, xz) => ({
+        origin: { x: ox, y: oy, z: oz },
+        zDir: { x: zx, y: zy, z: zz },
+        xDir: xx !== undefined ? { x: xx, y: xy, z: xz } : undefined,
+        __type,
+        delete: noop,
+    });
+    adapter['createAxis2'] = makeAxis('axis2');
+    adapter['createAxis3'] = makeAxis('axis3');
+}
+/** 把 BrepEngineApi 透传包装为 KernelAdapter 形态（非 occt 引擎）。 */
+function wrapBrepEngineApi(api) {
+    const adapter = {
+        // 生命周期：vendored 面统一用 dispose（BrepEngineApi 用 release）。
+        dispose: (h) => api.release(h),
+    };
+    synthesizeGlueMethods(adapter);
+    for (const key of Object.keys(api)) {
+        if (key === 'release')
+            continue; // 上面已映射为 dispose
+        adapter[key] = api[key];
+    }
+    // 测量面映射在透传之后追加，覆盖同名键（vendored 名 → BrepEngineApi 名 + 形态转换）。
+    mapMeasureMethods(adapter, api);
+    // pattern 族形态适配（BrepEngineApi 对象 Vec3 ↔ vendored 三元组）。
+    adapter['linearPattern'] = (shape, direction, spacing, count) => api.linearPattern(shape, { x: direction[0], y: direction[1], z: direction[2] }, spacing, count).map((h) => ({ wrapped: h, type: 'solid' }));
+    adapter['circularPattern'] = (shape, center, axis, angleStep, count) => api.circularPattern(shape, { x: center[0], y: center[1], z: center[2] }, { x: axis[0], y: axis[1], z: axis[2] }, angleStep, count).map((h) => ({ wrapped: h, type: 'solid' }));
+    adapter['gridPattern'] = (shape, directionX, directionY, spacingX, spacingY, countX, countY) => ({
+        wrapped: api.gridPattern(shape, { x: directionX[0], y: directionX[1], z: directionX[2] }, { x: directionY[0], y: directionY[1], z: directionY[2] }, spacingX, spacingY, countX, countY),
+        type: 'compound',
+    });
+    return adapter;
+}
+/**
+ * 装配期完整性检查：KernelAdapter 胶水方法齐备断言。
+ *
+ * @param id - 引擎注册 id（报错时定位到引擎）。
+ * @param adapter - 待注入 vendored registry 的 KernelAdapter。
+ * @throws 缺失任一胶水方法 → 装配期报错（列出引擎 id 与缺失方法名）。
+ */
+export function assertGlueMethodsComplete(id, adapter) {
+    const missing = GLUE_METHODS.filter((m) => typeof adapter[m] !== 'function');
+    if (missing.length > 0) {
+        throw new Error(`[faijs] BREP engine '${id}' cannot back the vendored compat surface: KernelAdapter ` +
+            `missing glue method(s): ${missing.join(', ')}. These auxiliary construction methods ` +
+            `(createVector3d / createPoint3d / createDirection3d / createAxis1/2/3) are required by ` +
+            `the vendored kernel boundary and cannot be covered by capability declarations. ` +
+            `Fix the adapter (add real implementations) or do not inject this engine into the vendored registry.`);
+    }
+}
+/**
+ * Test-only: clear the injection cache and reset the vendored kernel registry
+ * so a re-assembly (e.g. switching engines in tests) re-runs buildKernelAdapter
+ * + assertGlueMethodsComplete for the new engine. Never called in prod.
+ */
+export function __resetKernelInjectionForTests() {
+    _injected = false;
+    __resetKernelRegistryForTests();
+}
+/**
+ * Whether the vendored kernel registry has been injected (engine-neutral D10).
+ *
+ * 取代旧的 `isOcctKernelBound()`（其判据 `_bound && getActiveKernelId() === 'occt-wasm'`
+ * 把注入面写死为 occt）。新判据只问「vendored registry 是否已注入当前引擎」——
+ * 不关心引擎 id，装配期换引擎（brepkit/mock）同样成立。
+ *
+ * @returns 注入是否已完成（vendored registry 已装配当前 BREP 引擎）。
+ */
+export function isKernelInjected() {
+    syncRegistryFromGlobal();
+    return _injected || getActiveKernelId() !== null;
+}
+/**
+ * Access the currently injected vendored kernel adapter (reads the registry).
+ * @throws If the bridge has not been injected.
+ * @returns the vendored kernel adapter for the current BREP engine.
  */
 export function getBrepjsKernel() {
-    return getVendoredKernel('occt-wasm');
+    return getVendoredKernel();
+}
+/**
+ * 固定绑定 occt 内核到 vendored registry（Phase 2 前的装配方式）。
+ *
+ * @deprecated Phase 2 P2-5：固定绑定已被引擎中立的 injectCurrentBrepEngineAsKernel
+ * 取代。保留导出仅为兼容旧调用点（适配器层迁移期）；新代码一律用注入函数。
+ * @returns 恒抛错——本函数已移除，仅保留签名占位。
+ */
+export function bindOcctKernel() {
+    void getFaijsKernel;
+    throw new Error('[faijs] bindOcctKernel() removed (Phase 2 P2-5): use injectCurrentBrepEngineAsKernel() ' +
+        'during host assembly to inject the current BREP engine into the vendored registry.');
+}
+/**
+ * 旧 occt 专用注入判据（Phase 2 前语义：绑定且激活内核为 occt-wasm）。
+ *
+ * @deprecated Phase 2 P2-5：occt 专用判据已被引擎中立的 isKernelInjected() 取代。
+ * @returns 当前是否已注入（透传 isKernelInjected()）。
+ */
+export function isOcctKernelBound() {
+    return isKernelInjected();
 }
 //# sourceMappingURL=occt-kernel-bridge.js.map

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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AACvF,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,IAAI,iBAAiB,EAC9B,cAAc,EACd,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,oCAAoC,CAAA;AAG3C,IAAI,MAAM,GAAG,KAAK,CAAA;AAElB;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc;IAC5B,8EAA8E;IAC9E,8EAA8E;IAC9E,wEAAwE;IACxE,kEAAkE;IAClE,sBAAsB,EAAE,CAAC;IACzB,IAAI,MAAM;QAAE,OAAO,iBAAiB,CAAC,WAAW,CAAC,CAAA;IAEjD,MAAM,WAAW,GAAG,cAAc,EAAgC,CAAA;IAClE,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;IACvD,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACpC,aAAa,EAAE,CAAA;IACf,MAAM,GAAG,IAAI,CAAA;IACb,oBAAoB,EAAE,CAAA;IACtB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,IAAI,iBAAiB,EAAE,KAAK,WAAW,CAAA;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,iBAAiB,CAAC,WAAW,CAAC,CAAA;AACvC,CAAC","sourcesContent":["/**\n * L3 bridge — occt-wasm kernel single-instance injection (D10).\n *\n * The ported `kernel/occtWasm` adapter is constructor-injected (DI form, never\n * imports `occt-wasm` itself). This file is the **only** faijs-side place\n * wiring the two together (boundary rule D8/R5: core side may import the\n * vendored tree only from `api/`):\n *\n *   initOcctWasm()  ──same instance──▶  OcctWasmAdapter  ──▶  registerKernel\n *   (faijs existing                (vendored, DI)             (vendored kernel\n *    occt singleton)                                            registry, D10)\n *\n * `occtKernel.getKernel()` returns the faijs singleton `OcctKernel`; building\n * the adapter over that exact instance guarantees the single-instance ban\n * (D10: two wasm instances would put handles in different pointer spaces and\n * silently desync `hasBrep`/`brepOf`/face evolution).\n *\n * See docs/plans/2026-09-01-layered-api-architecture.md §D10 / §D8.\n */\n\nimport { getKernel as getFaijsKernel } from '../occt-kernel/occtKernel'\nimport type { OcctKernelOwner } from '../vendored/brepjs/kernel/occtWasm/occtWasmAdapter.js'\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} from '../vendored/brepjs/kernel/index.js'\nimport type { KernelAdapter } from '../vendored/brepjs/kernel/types.js'\n\nlet _bound = false\n\n/**\n * Bind the ported kernel registry to the faijs single occt-wasm instance.\n *\n * Idempotent: the first call registers the adapter and freezes the registry\n * (D10 冻结); subsequent calls return the already-bound adapter without\n * re-registering. Call after `initOcctWasm()` has been run (e.g. inside\n * `registerOcctBrepEngine()` host assembly).\n *\n * @returns the registered kernel adapter.\n */\nexport function bindOcctKernel(): KernelAdapter {\n  // Check the SHARED registry first (globalThis singleton): a CDN-bundled faijs\n  // instance has its own module-level `_bound = false`, but the host bundle may\n  // already have registered+bound 'occt-wasm'. Re-registering would throw\n  // \"registry frozen\" — treat an existing binding as bound instead.\n  syncRegistryFromGlobal();\n  if (_bound) return getVendoredKernel('occt-wasm')\n\n  const faijsKernel = getFaijsKernel() as unknown as OcctKernelOwner\n  const adapter = OcctWasmAdapter.fromKernel(faijsKernel)\n  registerKernel('occt-wasm', adapter)\n  freezeKernels()\n  _bound = true\n  syncRegistryToGlobal()\n  return adapter\n}\n\n/**\n * Whether the vendored kernel registry has been bound (D10).\n * @returns true once bound to the occt-wasm kernel.\n */\nexport function isOcctKernelBound(): boolean {\n  return _bound && getActiveKernelId() === 'occt-wasm'\n}\n\n/**\n * Access the currently bound vendored kernel adapter (reads the registry).\n * @throws If the bridge has not been bound.\n * @returns the vendored occt-wasm kernel adapter.\n */\nexport function getBrepjsKernel(): KernelAdapter {\n  return getVendoredKernel('occt-wasm')\n}"]}
+{"version":3,"file":"occt-kernel-bridge.js","sourceRoot":"","sources":["../../src/api/occt-kernel-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAEvE,OAAO,EAAE,aAAa,EAAmB,MAAM,yBAAyB,CAAA;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,uDAAuD,CAAA;AACvF,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,SAAS,IAAI,iBAAiB,EAC9B,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,oCAAoC,CAAA;AAG3C;;4DAE4D;AAC5D,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAA;AAElD;;;;;;;;;;GAUG;AACH,MAAM,YAAY,GAAG;IACnB,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,aAAa;IACb,aAAa;IACb,aAAa;CACL,CAAA;AAEV,IAAI,SAAS,GAAG,KAAK,CAAA;AAErB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B;IACnD,0DAA0D;IAC1D,uDAAuD;IACvD,uDAAuD;IACvD,sBAAsB,EAAE,CAAA;IACxB,IAAI,gBAAgB,EAAE;QAAE,OAAO,iBAAiB,EAAE,CAAA;IAElD,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAA;IACpC,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IAC1C,yBAAyB,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IAE7C,cAAc,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAA;IAChD,aAAa,EAAE,CAAA;IACf,SAAS,GAAG,IAAI,CAAA;IAChB,oBAAoB,EAAE,CAAA;IACtB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAkB;IACnD,IAAI,MAAM,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,UAAwC,CAAA;QACnE,OAAO,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;AAC7C,CAAC;AAED,6EAA6E;AAC7E,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAA;AAE3B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,MAAM;IACN,QAAQ;IACR,oBAAoB;CACZ,CAAA;AAEV,kFAAkF;AAClF,SAAS,YAAY,CAAC,CAAU;IAC9B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAA;IACnC,MAAM,IAAI,GAAG,CAAqB,CAAA;IAClC,OAAO,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,OAAgC,EAAE,GAAkB;IAC7E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAU,CAAC,CAAA;IAC3E,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAU,EAA4B,EAAE;QACjE,MAAM,CAAC,GAAG,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAU,CAAC,CAAA;QACvD,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC,CAAA;IACD,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAU,EAAE,EAAE;QACtC,MAAM,EAAE,GAAG,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC,CAAU,EAAE,IAAI,CAAC,CAAA;QAC7D,OAAO;YACL,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;YAChC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;SACjC,CAAA;IACH,CAAC,CAAA;IACD,yEAAyE;IACzE,4EAA4E;IAC5E,2EAA2E;IAC3E,6DAA6D;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,OAAgC;IAC7D,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACpG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAA;IACvF,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAA;IAC/F,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAA;IACzF,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAE,CAAC,CAAC;QACpG,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;QAC/B,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;QAClC,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,IAAI;KACb,CAAC,CAAA;IACF,kEAAkE;IAClE,MAAM,QAAQ,GAAG,CAAC,MAAyB,EAAE,EAAE,CAC7C,CAAC,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAU,EAAE,EAAW,EAAE,EAAW,EAAE,EAAW,EAAE,EAAE,CAAC,CAAC;QAClH,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;QAC/B,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;QAC7B,IAAI,EAAE,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAY,EAAE,CAAC,EAAE,EAAY,EAAE,CAAC,CAAC,CAAC,SAAS;QAChF,MAAM;QACN,MAAM,EAAE,IAAI;KACb,CAAC,CAAA;IACJ,OAAO,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC1C,OAAO,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;AAC5C,CAAC;AAED,yDAAyD;AACzD,SAAS,iBAAiB,CAAC,GAAkB;IAC3C,MAAM,OAAO,GAA4B;QACvC,uDAAuD;QACvD,OAAO,EAAE,CAAC,CAAU,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAU,CAAC;KACjD,CAAA;IACD,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,IAAI,GAAG,KAAK,SAAS;YAAE,SAAQ,CAAC,iBAAiB;QACjD,OAAO,CAAC,GAAG,CAAC,GAAI,GAA0C,CAAC,GAAG,CAAC,CAAA;IACjE,CAAC;IACD,2DAA2D;IAC3D,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;IAC/B,uDAAuD;IACvD,OAAO,CAAC,eAAe,CAAC,GAAG,CACzB,KAAc,EACd,SAAmC,EACnC,OAAe,EACf,KAAa,EACb,EAAE,CACF,GAAG,CAAC,aAAa,CACf,KAAc,EACd,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EACrD,OAAO,EACP,KAAK,CACN,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IAC/C,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAC3B,KAAc,EACd,MAAgC,EAChC,IAA8B,EAC9B,SAAiB,EACjB,KAAa,EACb,EAAE,CACF,GAAG,CAAC,eAAe,CACjB,KAAc,EACd,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,EAC5C,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EACtC,SAAS,EACT,KAAK,CACN,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IAC/C,OAAO,CAAC,aAAa,CAAC,GAAG,CACvB,KAAc,EACd,UAAoC,EACpC,UAAoC,EACpC,QAAgB,EAChB,QAAgB,EAChB,MAAc,EACd,MAAc,EACd,EAAE,CAAC,CAAC;QACJ,OAAO,EAAE,GAAG,CAAC,WAAW,CACtB,KAAc,EACd,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EACxD,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EACxD,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,MAAM,CACP;QACD,IAAI,EAAE,UAAU;KACjB,CAAC,CAAA;IACF,OAAO,OAAmC,CAAA;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAU,EAAE,OAAsB;IAC1E,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAQ,OAA8C,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAA;IACpH,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,wBAAwB,EAAE,2DAA2D;YACnF,2BAA2B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,yCAAyC;YACtF,yFAAyF;YACzF,iFAAiF;YACjF,qGAAqG,CACxG,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,8BAA8B;IAC5C,SAAS,GAAG,KAAK,CAAA;IACjB,6BAA6B,EAAE,CAAA;AACjC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB;IAC9B,sBAAsB,EAAE,CAAA;IACxB,OAAO,SAAS,IAAI,iBAAiB,EAAE,KAAK,IAAI,CAAA;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,iBAAiB,EAAE,CAAA;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,KAAK,cAAc,CAAA;IACnB,MAAM,IAAI,KAAK,CACb,yFAAyF;QACvF,oFAAoF,CACvF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,gBAAgB,EAAE,CAAA;AAC3B,CAAC","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"]}

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;AAgGhD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;;CAKxB,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;AAqDhD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa;;CAUxB,CAAA"}

package/dist/api/pattern.js

@@ -9,10 +9,10 @@
  * 倍数即得 k；再按「面内坐标」（centroid − t·dir）匹配输入面对应面，回投其 inner role。
  */
 import { solidToShape } from '../brep/brep-ops.js';
-import { getFaceHashes } from '../brep/face-evolution.js';
-import { getBackends, getCurrentStmt } from '../runtime-state.js';
-import { fromBrep, brepOf, inputRoleTable } from '../shape.js';
+import { getBackends, getCurrentStmt, keep } from '../runtime-state.js';
+import { fromBrep, brepOf } from '../shape.js';
 import { defineOp } from '../sdk.js';
+import { buildReplicaRoleTable } from './internal/replica-role-table.js';
 /** 归一化向量（零向量 → [0,0,1] 兜底）。 */
 function norm(v) {
     const len = Math.hypot(v[0], v[1], v[2]);
@@ -30,69 +30,28 @@ function linearPatternBrep(input, direction, count, spacing) {
         throw new Error('[stdlib/pattern] input is not BREP');
     // Phase 1.6：origin = 本次语句 StmtId。
     const outStmt = String(getCurrentStmt()?.id ?? '');
-    const inputTable = inputRoleTable(input);
-    // 输入面角色（hash → role）用于回投 inner
-    const inputHashes = getFaceHashes(kernel, inputSolid);
-    const inputHashToRole = new Map();
-    if (inputTable) {
-        for (const roles of inputTable.values()) {
-            for (const [role, hashes] of roles)
-                for (const h of hashes)
-                    inputHashToRole.set(h, role);
-        }
-    }
-    // 输入面质心（用于按面内坐标回投 inner role）
-    const inputFaces = kernel.getSubShapes(inputSolid, 'face');
-    const inputCentroids = inputFaces.map((f) => kernel.getSurfaceCenterOfMass(f));
-    // 取 count 份副本（内核原生 linearPattern：brepkit 返回 BrepHandle[]，occt-wasm
-    // 返回已 fused 的 BrepHandle —— 两种形态都按结果面质心聚类，故兼容）
+    // 取 count 份副本。Phase 2：BrepEngineApi.linearPattern 契约统一返回 BrepHandle[]
+    // （两内核原生都返回 compound，由适配器拆成数组）——不再有「单句柄 fused」形态。
     const dir = norm(direction);
-    const raw = kernel.linearPattern(inputSolid, [dir[0], dir[1], dir[2]], spacing, count);
+    const raw = kernel.linearPattern(inputSolid, { x: dir[0], y: dir[1], z: dir[2] }, spacing, count);
     let resultSolid;
-    if (Array.isArray(raw)) {
-        try {
-            resultSolid = kernel.fuseAll(raw);
-        }
-        finally {
-            for (const c of raw)
-                kernel.release(c);
-        }
+    try {
+        resultSolid = kernel.fuseAll(raw);
     }
-    else {
-        resultSolid = raw;
+    finally {
+        for (const c of raw)
+            kernel.release(c);
     }
-    // 结果面 hash / 质心
-    const resultHashes = getFaceHashes(kernel, resultSolid);
-    const resultFaces = kernel.getSubShapes(resultSolid, 'face');
-    const resultCentroids = resultFaces.map((f) => kernel.getSurfaceCenterOfMass(f));
-    const roleTable = new Map();
-    const inner = new Map();
-    for (let i = 0; i < resultHashes.length; i++) {
-        const c = resultCentroids[i];
-        // 沿 dir 投影得到份数坐标 t，四舍五入到 spacing 倍数 → k
-        const t = c.x * dir[0] + c.y * dir[1] + c.z * dir[2];
-        const k = Math.round(t / spacing);
-        // 面内坐标 = centroid − t·dir
-        const inPlane = [c.x - t * dir[0], c.y - t * dir[1], c.z - t * dir[2]];
-        // 匹配输入面（最近面内坐标）→ inner role
-        let bestRole;
-        let bestDist = Infinity;
-        for (let j = 0; j < inputCentroids.length; j++) {
-            const ic = inputCentroids[j];
-            const it = ic.x * dir[0] + ic.y * dir[1] + ic.z * dir[2];
-            const ii = [ic.x - it * dir[0], ic.y - it * dir[1], ic.z - it * dir[2]];
-            const d = (inPlane[0] - ii[0]) ** 2 + (inPlane[1] - ii[1]) ** 2 + (inPlane[2] - ii[2]) ** 2;
-            if (d < bestDist) {
-                bestDist = d;
-                bestRole = inputHashToRole.get(inputHashes[j]);
-            }
-        }
-        const role = `replica[${k}]/${bestRole ?? 'face'}`;
-        if (!inner.has(role))
-            inner.set(role, []);
-        inner.get(role).push(resultHashes[i]);
+    // 第 k 份副本是输入沿 dir 平移 k*spacing：质心反投回输入坐标系（T_k⁻¹）。
+    const replicas = [];
+    for (let k = 0; k < count; k++) {
+        const off = k * spacing;
+        replicas.push({
+            label: `replica[${k}]`,
+            inverse: (c) => ({ x: c.x - off * dir[0], y: c.y - off * dir[1], z: c.z - off * dir[2] }),
+        });
     }
-    roleTable.set(outStmt, inner);
+    const roleTable = buildReplicaRoleTable(kernel, input, resultSolid, replicas, outStmt);
     return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid, roleTable });
 }
 /**
@@ -114,8 +73,13 @@ function linearPatternBrep(input, direction, count, spacing) {
  */
 export const linearPattern = defineOp({
     brep(input, direction, count, spacing) {
+        // copy-like keep semantics: replicate ops preserve their source shape.
+        keep(input);
         return linearPatternBrep(input, direction, count, spacing);
     },
+    // Phase 1（Brep 引擎可切换重构）：能力前置判定——linearPattern 需要内核的
+    // 线性阵列方法（BrepMethodKind），brepkit 装配下缺失时执行前静态报错。
+    capabilities: ['linearPattern'],
     naming: { kind: 'replicate', k: 0 },
 });
 //# sourceMappingURL=pattern.js.map

package/dist/api/pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAMjC,+BAA+B;AAC/B,SAAS,IAAI,CAAC,CAAO;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,IAAI,GAAG,GAAG,IAAI;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAChC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;AAC7C,CAAC;AAED,kDAAkD;AAClD,SAAS,iBAAiB,CAAC,KAAY,EAAE,SAAe,EAAE,KAAa,EAAE,OAAe;IACtF,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAA4B,CAAA;IAChE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAA;IAC1D,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAEtE,kCAAkC;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAClD,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAA0B,CAAA;IAEjE,+BAA+B;IAC/B,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACrD,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAA;IACjD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACxC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK;gBAAE,KAAK,MAAM,CAAC,IAAI,MAAM;oBAAE,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC1F,CAAC;IACH,CAAC;IACD,8BAA8B;IAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAC1D,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAA;IAE9E,mEAAmE;IACnE,+CAA+C;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;IAC3B,MAAM,GAAG,GAAI,MAEX,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAEtE,IAAI,WAAuB,CAAA;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACnC,CAAC;gBAAS,CAAC;YACT,KAAK,MAAM,CAAC,IAAI,GAAG;gBAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QACxC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,GAAiB,CAAA;IACjC,CAAC;IAED,gBAAgB;IAChB,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACvD,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC5D,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAA;IAEhF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAA;IAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAA;IAEzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAE,CAAA;QAC7B,wCAAwC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;QACpD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,CAAA;QACjC,0BAA0B;QAC1B,MAAM,OAAO,GAA6B,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;QAChG,4BAA4B;QAC5B,IAAI,QAA4B,CAAA;QAChC,IAAI,QAAQ,GAAG,QAAQ,CAAA;QACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAE,CAAA;YAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAA;YACxD,MAAM,EAAE,GAA6B,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;YACjG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;YAC3F,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC;gBACjB,QAAQ,GAAG,CAAC,CAAA;gBACZ,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,CAAA;YACjD,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,QAAQ,IAAI,MAAM,EAAE,CAAA;QAClD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QACzC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAE,CAAC,CAAA;IACzC,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAE7B,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;AACvF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;IACpC,IAAI,CAAC,KAAY,EAAE,SAAe,EAAE,KAAa,EAAE,OAAe;QAChE,OAAO,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IACD,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,EAAgB;CAClD,CAAC,CAAA","sourcesContent":["/**\n * stdlib pattern — linearPattern（手写覆盖生成投影，Phase 3: L3 `replica[k]` 角色表）\n *\n * 生成投影是 brep-only compatOp，不带角色表；本文件手写 defineOp，BREP 路径\n * 用质心聚类把结果面按份数 k 分组、回投影到输入面角色，产出 `replica[k]/<inner>`。\n *\n * 机制（无内核历史，纯几何推理）：pattern 的每份副本都是输入的精确平移，副本面\n * 几何相同但质心不同。结果面沿 pattern 方向投影得到份数坐标 t，四舍五入到 spacing\n * 倍数即得 k；再按「面内坐标」（centroid − t·dir）匹配输入面对应面，回投其 inner role。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getFaceHashes } from '../brep/face-evolution'\nimport { getBackends, getCurrentStmt } from '../runtime-state'\nimport { fromBrep, brepOf, inputRoleTable } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport type { RoleTable } from '../topology/naming/types'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n/** 归一化向量（零向量 → [0,0,1] 兜底）。 */\nfunction norm(v: Vec3): [number, number, number] {\n  const len = Math.hypot(v[0], v[1], v[2])\n  if (len < 1e-9) return [0, 0, 1]\n  return [v[0] / len, v[1] / len, v[2] / len]\n}\n\n/** BREP 路径：沿 direction 复制 count 份，质心聚类回投输入面角色。 */\nfunction linearPatternBrep(input: Shape, direction: Vec3, count: number, spacing: number): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/pattern] no OCCT kernel')\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (!inputSolid) throw new Error('[stdlib/pattern] input is not BREP')\n\n  // Phase 1.6：origin = 本次语句 StmtId。\n  const outStmt = String(getCurrentStmt()?.id ?? '')\n  const inputTable = inputRoleTable(input) as RoleTable | undefined\n\n  // 输入面角色（hash → role）用于回投 inner\n  const inputHashes = getFaceHashes(kernel, inputSolid)\n  const inputHashToRole = new Map<number, string>()\n  if (inputTable) {\n    for (const roles of inputTable.values()) {\n      for (const [role, hashes] of roles) for (const h of hashes) inputHashToRole.set(h, role)\n    }\n  }\n  // 输入面质心（用于按面内坐标回投 inner role）\n  const inputFaces = kernel.getSubShapes(inputSolid, 'face')\n  const inputCentroids = inputFaces.map((f) => kernel.getSurfaceCenterOfMass(f))\n\n  // 取 count 份副本（内核原生 linearPattern：brepkit 返回 BrepHandle[]，occt-wasm\n  // 返回已 fused 的 BrepHandle —— 两种形态都按结果面质心聚类，故兼容）\n  const dir = norm(direction)\n  const raw = (kernel as unknown as {\n    linearPattern(s: BrepHandle, d: number[], sp: number, n: number): unknown\n  }).linearPattern(inputSolid, [dir[0], dir[1], dir[2]], spacing, count)\n\n  let resultSolid: BrepHandle\n  if (Array.isArray(raw)) {\n    try {\n      resultSolid = kernel.fuseAll(raw)\n    } finally {\n      for (const c of raw) kernel.release(c)\n    }\n  } else {\n    resultSolid = raw as BrepHandle\n  }\n\n  // 结果面 hash / 质心\n  const resultHashes = getFaceHashes(kernel, resultSolid)\n  const resultFaces = kernel.getSubShapes(resultSolid, 'face')\n  const resultCentroids = resultFaces.map((f) => kernel.getSurfaceCenterOfMass(f))\n\n  const roleTable = new Map<string, Map<string, number[]>>()\n  const inner = new Map<string, number[]>()\n\n  for (let i = 0; i < resultHashes.length; i++) {\n    const c = resultCentroids[i]!\n    // 沿 dir 投影得到份数坐标 t，四舍五入到 spacing 倍数 → k\n    const t = c.x * dir[0] + c.y * dir[1] + c.z * dir[2]\n    const k = Math.round(t / spacing)\n    // 面内坐标 = centroid − t·dir\n    const inPlane: [number, number, number] = [c.x - t * dir[0], c.y - t * dir[1], c.z - t * dir[2]]\n    // 匹配输入面（最近面内坐标）→ inner role\n    let bestRole: string | undefined\n    let bestDist = Infinity\n    for (let j = 0; j < inputCentroids.length; j++) {\n      const ic = inputCentroids[j]!\n      const it = ic.x * dir[0] + ic.y * dir[1] + ic.z * dir[2]\n      const ii: [number, number, number] = [ic.x - it * dir[0], ic.y - it * dir[1], ic.z - it * dir[2]]\n      const d = (inPlane[0] - ii[0]) ** 2 + (inPlane[1] - ii[1]) ** 2 + (inPlane[2] - ii[2]) ** 2\n      if (d < bestDist) {\n        bestDist = d\n        bestRole = inputHashToRole.get(inputHashes[j]!)\n      }\n    }\n    const role = `replica[${k}]/${bestRole ?? 'face'}`\n    if (!inner.has(role)) inner.set(role, [])\n    inner.get(role)!.push(resultHashes[i]!)\n  }\n  roleTable.set(outStmt, inner)\n\n  return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid, roleTable })\n}\n\n/**\n * 线性阵列：沿 direction 复制 count 份（含原位置）。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name linearPattern\n * @note BREP-only：非 BREP 输入抛 E_MESH_UNSUPPORTED。结果面按份数 k 回投影到输入面\n *       角色，产出 `replica[k]/<inner>`（Phase 3 L3 抗重放词汇）。\n * @returns Shape 所有副本 fused 后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param direction - 阵列方向。type:[x,y,z] required:true\n * @param count - 副本总数（含原位置）。type:number required:true\n * @param spacing - 副本间距。type:number required:true\n * @example\n * const p = await cad.linearPattern(part0, [1, 0, 0], 3, 20)\n */\nexport const linearPattern = defineOp({\n  brep(input: Shape, direction: Vec3, count: number, spacing: number) {\n    return linearPatternBrep(input, direction, count, spacing)\n  },\n  naming: { kind: 'replicate', k: 0 } as Provenance,\n})\n"]}
+{"version":3,"file":"pattern.js","sourceRoot":"","sources":["../../src/api/pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAIjC,OAAO,EAAE,qBAAqB,EAAyB,MAAM,+BAA+B,CAAA;AAE5F,+BAA+B;AAC/B,SAAS,IAAI,CAAC,CAAO;IACnB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,IAAI,GAAG,GAAG,IAAI;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAChC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;AAC7C,CAAC;AAED,kDAAkD;AAClD,SAAS,iBAAiB,CAAC,KAAY,EAAE,SAAe,EAAE,KAAa,EAAE,OAAe;IACtF,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAA4B,CAAA;IAChE,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAA;IAC/D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAA2B,CAAA;IAC1D,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;IAEtE,kCAAkC;IAClC,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAElD,sEAAsE;IACtE,kDAAkD;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAA;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAEjG,IAAI,WAAuB,CAAA;IAC3B,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,CAAC,IAAI,GAAG;YAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IACxC,CAAC;IAED,kDAAkD;IAClD,MAAM,QAAQ,GAAuB,EAAE,CAAA;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,CAAA;QACvB,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,WAAW,CAAC,GAAG;YACtB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1F,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IAEtF,OAAO,QAAQ,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAA;AACvF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,CAAC;IACpC,IAAI,CAAC,KAAY,EAAE,SAAe,EAAE,KAAa,EAAE,OAAe;QAChE,uEAAuE;QACvE,IAAI,CAAC,KAAK,CAAC,CAAA;QACX,OAAO,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;IAC5D,CAAC;IACD,oDAAoD;IACpD,gDAAgD;IAChD,YAAY,EAAE,CAAC,eAAe,CAAC;IAC/B,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,EAAgB;CAClD,CAAC,CAAA","sourcesContent":["/**\n * stdlib pattern — linearPattern（手写覆盖生成投影，Phase 3: L3 `replica[k]` 角色表）\n *\n * 生成投影是 brep-only compatOp，不带角色表；本文件手写 defineOp，BREP 路径\n * 用质心聚类把结果面按份数 k 分组、回投影到输入面角色，产出 `replica[k]/<inner>`。\n *\n * 机制（无内核历史，纯几何推理）：pattern 的每份副本都是输入的精确平移，副本面\n * 几何相同但质心不同。结果面沿 pattern 方向投影得到份数坐标 t，四舍五入到 spacing\n * 倍数即得 k；再按「面内坐标」（centroid − t·dir）匹配输入面对应面，回投其 inner role。\n */\n\nimport type { Shape, Vec3 } from '../mesh/types'\nimport { solidToShape } from '../brep/brep-ops'\nimport { getBackends, getCurrentStmt, keep } from '../runtime-state'\nimport { fromBrep, brepOf } from '../shape'\nimport { defineOp } from '../sdk'\nimport type { Provenance } from '../topology/naming/lineage'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { buildReplicaRoleTable, type ReplicaTransform } from './internal/replica-role-table'\n\n/** 归一化向量（零向量 → [0,0,1] 兜底）。 */\nfunction norm(v: Vec3): [number, number, number] {\n  const len = Math.hypot(v[0], v[1], v[2])\n  if (len < 1e-9) return [0, 0, 1]\n  return [v[0] / len, v[1] / len, v[2] / len]\n}\n\n/** BREP 路径：沿 direction 复制 count 份，质心聚类回投输入面角色。 */\nfunction linearPatternBrep(input: Shape, direction: Vec3, count: number, spacing: number): Shape {\n  const kernel = getBackends().kernel.brep as BrepEngineApi | null\n  if (!kernel) throw new Error('[stdlib/pattern] no OCCT kernel')\n  const inputSolid = brepOf(input) as BrepHandle | undefined\n  if (!inputSolid) throw new Error('[stdlib/pattern] input is not BREP')\n\n  // Phase 1.6：origin = 本次语句 StmtId。\n  const outStmt = String(getCurrentStmt()?.id ?? '')\n\n  // 取 count 份副本。Phase 2：BrepEngineApi.linearPattern 契约统一返回 BrepHandle[]\n  // （两内核原生都返回 compound，由适配器拆成数组）——不再有「单句柄 fused」形态。\n  const dir = norm(direction)\n  const raw = kernel.linearPattern(inputSolid, { x: dir[0], y: dir[1], z: dir[2] }, spacing, count)\n\n  let resultSolid: BrepHandle\n  try {\n    resultSolid = kernel.fuseAll(raw)\n  } finally {\n    for (const c of raw) kernel.release(c)\n  }\n\n  // 第 k 份副本是输入沿 dir 平移 k*spacing：质心反投回输入坐标系（T_k⁻¹）。\n  const replicas: ReplicaTransform[] = []\n  for (let k = 0; k < count; k++) {\n    const off = k * spacing\n    replicas.push({\n      label: `replica[${k}]`,\n      inverse: (c) => ({ x: c.x - off * dir[0], y: c.y - off * dir[1], z: c.z - off * dir[2] }),\n    })\n  }\n  const roleTable = buildReplicaRoleTable(kernel, input, resultSolid, replicas, outStmt)\n\n  return fromBrep(solidToShape(kernel, resultSolid), { solid: resultSolid, roleTable })\n}\n\n/**\n * 线性阵列：沿 direction 复制 count 份（含原位置）。\n * @group 特征\n * @inputs 1\n * @async true\n * @qual ok\n * @name linearPattern\n * @note BREP-only：非 BREP 输入抛 E_MESH_UNSUPPORTED。结果面按份数 k 回投影到输入面\n *       角色，产出 `replica[k]/<inner>`（Phase 3 L3 抗重放词汇）。\n * @returns Shape 所有副本 fused 后的几何。\n * @param input - 目标几何。type:Shape required:true\n * @param direction - 阵列方向。type:[x,y,z] required:true\n * @param count - 副本总数（含原位置）。type:number required:true\n * @param spacing - 副本间距。type:number required:true\n * @example\n * const p = await cad.linearPattern(part0, [1, 0, 0], 3, 20)\n */\nexport const linearPattern = defineOp({\n  brep(input: Shape, direction: Vec3, count: number, spacing: number) {\n    // copy-like keep semantics: replicate ops preserve their source shape.\n    keep(input)\n    return linearPatternBrep(input, direction, count, spacing)\n  },\n  // Phase 1（Brep 引擎可切换重构）：能力前置判定——linearPattern 需要内核的\n  // 线性阵列方法（BrepMethodKind），brepkit 装配下缺失时执行前静态报错。\n  capabilities: ['linearPattern'],\n  naming: { kind: 'replicate', k: 0 } as Provenance,\n})\n"]}