@faicad/faijs 0.30.9 → 0.32.2

package/dist/api/generated/cad/script-face.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"script-face.js","sourceRoot":"","sources":["../../../../src/api/generated/cad/script-face.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,sBAAsB;IACtB,wBAAwB;IACxB,oBAAoB;IACpB,QAAQ;IACR,MAAM;IACN,MAAM;IACN,0BAA0B;IAC1B,iBAAiB;IACjB,8BAA8B;IAC9B,WAAW;IACX,aAAa;IACb,wBAAwB;IACxB,gBAAgB;IAChB,iBAAiB;IACjB,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,aAAa;IACb,cAAc;IACd,YAAY;IACZ,MAAM;IACN,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,WAAW;IACX,SAAS;IACT,SAAS;IACT,cAAc;IACd,UAAU;IACV,QAAQ;IACR,YAAY;IACZ,kBAAkB;IAClB,YAAY;IACZ,6BAA6B;IAC7B,6BAA6B;IAC7B,iBAAiB;IACjB,KAAK;IACL,UAAU;IACV,MAAM;IACN,WAAW;IACX,eAAe;IACf,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,OAAO;IACP,MAAM;IACN,eAAe;IACf,gBAAgB;IAChB,YAAY;IACZ,OAAO;IACP,YAAY;IACZ,UAAU;IACV,aAAa;IACb,SAAS;IACT,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,oBAAoB;IACpB,MAAM;IACN,gBAAgB;IAChB,QAAQ;IACR,cAAc;IACd,eAAe;IACf,oBAAoB;IACpB,oBAAoB;IACpB,aAAa;IACb,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,aAAa;IACb,UAAU;IACV,aAAa;IACb,kBAAkB;IAClB,UAAU;IACV,QAAQ;IACR,eAAe;IACf,MAAM;IACN,QAAQ;IACR,OAAO;IACP,cAAc;IACd,kBAAkB;IAClB,SAAS;IACT,YAAY;IACZ,WAAW;IACX,MAAM;IACN,cAAc;IACd,MAAM;IACN,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,eAAe;IACf,UAAU;IACV,UAAU;IACV,aAAa;IACb,WAAW;IACX,WAAW;IACX,aAAa;IACb,UAAU;IACV,MAAM;IACN,OAAO;IACP,kBAAkB;IAClB,wBAAwB;IACxB,aAAa;IACb,gBAAgB;IAChB,WAAW;IACX,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,WAAW;IACX,MAAM;IACN,iBAAiB;IACjB,0BAA0B;IAC1B,0BAA0B;IAC1B,YAAY;IACZ,aAAa;IACb,WAAW;IACX,UAAU;IACV,aAAa;IACb,mBAAmB;IACnB,WAAW;IACX,SAAS;IACT,YAAY;IACZ,WAAW;IACX,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,YAAY;IACZ,eAAe;IACf,OAAO;IACP,QAAQ;CACT,CAAA","sourcesContent":["/**\n * generated/cad/script-face.ts — auto-generated script face (P5 skeleton).\n *\n * Design: docs/plans/2026-09-07-compat-surface-unified-projection.md §5.1 ③\n *\n * Only symbols with scriptFace=true are exported here.\n * Full compatOp wrapping logic will be implemented in P4.\n *\n * Symbol count: 132\n */\n\n// TODO(P4): generate actual compatOp wrapping per §5.5.\nexport const CAD_SCRIPT_FACE_SYMBOLS = [\n  \"curvesAsEdgesOnPlane\",\n  \"curvesAsEdgesOnSurface\",\n  \"liftCurve2dToPlane\",\n  \"offset\",\n  \"as2D\",\n  \"as3D\",\n  \"borrowShapeWithKnownType\",\n  \"castResultShape\",\n  \"castResultShapeWithKnownType\",\n  \"castShape\",\n  \"castShape3D\",\n  \"castShapeWithKnownType\",\n  \"createCompound\",\n  \"createCompSolid\",\n  \"createEdge\",\n  \"createFace\",\n  \"createShell\",\n  \"createSolid\",\n  \"createVertex\",\n  \"createWire\",\n  \"is2D\",\n  \"is3D\",\n  \"isEdge\",\n  \"isFace\",\n  \"isShape3D\",\n  \"isShell\",\n  \"isSolid\",\n  \"isValidSolid\",\n  \"isVertex\",\n  \"isWire\",\n  \"kernelCall\",\n  \"kernelCallScoped\",\n  \"validSolid\",\n  \"makeExternalGearProfileWire\",\n  \"makeInternalGearProfileWire\",\n  \"circularPattern\",\n  \"cut\",\n  \"fixShape\",\n  \"fuse\",\n  \"healSolid\",\n  \"linearPattern\",\n  \"locate\",\n  \"mirror\",\n  \"rotate\",\n  \"simplify\",\n  \"split\",\n  \"boss\",\n  \"collectShapes\",\n  \"complexExtrude\",\n  \"convexHull\",\n  \"drill\",\n  \"extrudeAll\",\n  \"getShape\",\n  \"gridPattern\",\n  \"loftAll\",\n  \"materialize\",\n  \"mirrorJoin\",\n  \"pocket\",\n  \"rectangularPattern\",\n  \"roof\",\n  \"supportExtrude\",\n  \"thread\",\n  \"twistExtrude\",\n  \"getSingleFace\",\n  \"compoundSketchFace\",\n  \"compoundSketchLoft\",\n  \"makeBaseBox\",\n  \"sketchFace\",\n  \"sketchLoft\",\n  \"sketchSweep\",\n  \"sketchWires\",\n  \"addHoles\",\n  \"applyMatrix\",\n  \"approximateCurve\",\n  \"autoHeal\",\n  \"bezier\",\n  \"bsplineApprox\",\n  \"cast\",\n  \"circle\",\n  \"clone\",\n  \"cutAllBisect\",\n  \"cutWithEvolution\",\n  \"ellipse\",\n  \"ellipseArc\",\n  \"ellipsoid\",\n  \"face\",\n  \"facesForRole\",\n  \"fill\",\n  \"findFacesByTag\",\n  \"fuseAllBisect\",\n  \"fuseWithEvolution\",\n  \"getCompSolids\",\n  \"getEdges\",\n  \"getFaces\",\n  \"getFaceTags\",\n  \"getShells\",\n  \"getSolids\",\n  \"getVertices\",\n  \"getWires\",\n  \"heal\",\n  \"helix\",\n  \"interpolateCurve\",\n  \"intersectWithEvolution\",\n  \"isCompSolid\",\n  \"iterCompSolids\",\n  \"iterEdges\",\n  \"iterFaces\",\n  \"iterShells\",\n  \"iterSolids\",\n  \"iterVertices\",\n  \"iterWires\",\n  \"line\",\n  \"makeBezierCurve\",\n  \"makeBSplineApproximation\",\n  \"makeBSplineInterpolation\",\n  \"makeCircle\",\n  \"makeEllipse\",\n  \"makeHelix\",\n  \"makeLine\",\n  \"makePolygon\",\n  \"makeThreePointArc\",\n  \"minkowski\",\n  \"polygon\",\n  \"polyhedron\",\n  \"resolve3D\",\n  \"setTagMetadata\",\n  \"surfaceFromGrid\",\n  \"surfaceFromImage\",\n  \"tangentArc\",\n  \"threePointArc\",\n  \"torus\",\n  \"vertex\"\n]\n"]}

package/dist/api/internal/compat-projection.d.ts

@@ -1,55 +0,0 @@
-/**
- * compat-projection — the single BREP-TS projection wrapper factory (P23, §4.2).
- *
- * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §4.2 / §4.3.2
- *
- * Every symbol on the TS compat face and every generated `compatOp` op funnels
- * through {@link projectBrepOp}. That is what makes the generated face and the
- * hand-curated `api/brepjs-compat` face one mechanism rather than two:
- *
- *   1. single-kernel assert (D10) — library code never installs a kernel;
- *   2. D11 dual-form normalization — object form → positional form, in the
- *      exported function (§4.2 「归一化位置」), not in a script-side adapter;
- *   3. the brepjs call itself, through `callBrepjs` (Result shape preserved).
- *
- * P21's `api/brepjs-compat` used a private copy of steps 1–3 (`wrapDual`); P23 lifts it
- * here so `gen-l3-surface.ts` can emit one `compatOp(projectBrepOp(…), …)` line
- * per symbol instead of re-expanding the template for each op.
- *
- * @module
- */
-import { type FormClass } from './dual-form-args.js';
-/**
- * Assert that a BREP kernel is bound before invoking a compat op.
- *
- * Reads the configured backend's kernel slot, guarding against the throw that
- * `getBackends()` performs before host configuration. Falls back to the core
- * engine-registry activation flag（2026-09-25 core-decouple wrapup：brepjs
- * registry 已内化到 core——此处只问「core registry 是否已有激活 brep 引擎」）
- * when nothing is configured.
- *
- * @param name - op name, used in the guiding error message.
- * @throws when no BREP kernel is bound (the message tells the host what to do,
- * because library code must never install a kernel itself — §4.2 rule 1).
- */
-export declare function assertKernelBound(name: string): void;
-/** Signature of a projected compat op (inputs normalized before the call). */
-export type CompatProjection = (...args: unknown[]) => unknown;
-/**
- * Project a brepjs function onto the faijs TS compat face.
- *
- * The returned function is brepjs-shaped: positional arguments in, `Result`
- * (or whatever the brepjs function returns) out — no faijs `Shape`, no
- * adoption. Adoption and the statement-boundary unwrap are `compatOp`'s job
- * (§4.3.2 steps 4/5), which is why the script face can wrap the very same
- * projection the TS face exports.
- *
- * @param name      - op name (error messages + D11 discriminant context).
- * @param params    - machine parameter-name table (object form → positional).
- * @param formClass - D11 form class (A single-name dual-form / B1 options-only /
- *                    B2 two names).
- * @param impl      - the brepjs function.
- * @returns the projected compat op.
- */
-export declare function projectBrepOp(name: string, params: string[], formClass: FormClass, impl: (...args: never[]) => unknown): CompatProjection;
-//# sourceMappingURL=compat-projection.d.ts.map

package/dist/api/internal/compat-projection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compat-projection.d.ts","sourceRoot":"","sources":["../../../src/api/internal/compat-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAK9D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAcpD;AAED,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAA;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EAAE,EAChB,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAClC,gBAAgB,CAMlB"}

package/dist/api/internal/compat-projection.js

@@ -1,75 +0,0 @@
-/**
- * compat-projection — the single BREP-TS projection wrapper factory (P23, §4.2).
- *
- * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §4.2 / §4.3.2
- *
- * Every symbol on the TS compat face and every generated `compatOp` op funnels
- * through {@link projectBrepOp}. That is what makes the generated face and the
- * hand-curated `api/brepjs-compat` face one mechanism rather than two:
- *
- *   1. single-kernel assert (D10) — library code never installs a kernel;
- *   2. D11 dual-form normalization — object form → positional form, in the
- *      exported function (§4.2 「归一化位置」), not in a script-side adapter;
- *   3. the brepjs call itself, through `callBrepjs` (Result shape preserved).
- *
- * P21's `api/brepjs-compat` used a private copy of steps 1–3 (`wrapDual`); P23 lifts it
- * here so `gen-l3-surface.ts` can emit one `compatOp(projectBrepOp(…), …)` line
- * per symbol instead of re-expanding the template for each op.
- *
- * @module
- */
-import { resolveArgs } from './dual-form-args.js';
-import { callBrepjs } from './l3-bridge.js';
-import { getActiveBrepEngineId } from '../../brep/engine/registry.js';
-import { getBackends } from '../../runtime-state.js';
-/**
- * Assert that a BREP kernel is bound before invoking a compat op.
- *
- * Reads the configured backend's kernel slot, guarding against the throw that
- * `getBackends()` performs before host configuration. Falls back to the core
- * engine-registry activation flag（2026-09-25 core-decouple wrapup：brepjs
- * registry 已内化到 core——此处只问「core registry 是否已有激活 brep 引擎」）
- * when nothing is configured.
- *
- * @param name - op name, used in the guiding error message.
- * @throws when no BREP kernel is bound (the message tells the host what to do,
- * because library code must never install a kernel itself — §4.2 rule 1).
- */
-export function assertKernelBound(name) {
-    let kernelBound = false;
-    try {
-        kernelBound = getBackends().kernel.brep != null;
-    }
-    catch {
-        // backends not configured yet — that is not an error, just no kernel
-    }
-    if (!kernelBound && getActiveBrepEngineId() === null) {
-        throw new Error(`[compat:${name}] no BREP kernel bound; run host init/inject (e.g. initOcct + ` +
-            `register the occt brep engine) before the first compat.${name} call. ` +
-            `Library code must not install kernels itself.`);
-    }
-}
-/**
- * Project a brepjs function onto the faijs TS compat face.
- *
- * The returned function is brepjs-shaped: positional arguments in, `Result`
- * (or whatever the brepjs function returns) out — no faijs `Shape`, no
- * adoption. Adoption and the statement-boundary unwrap are `compatOp`'s job
- * (§4.3.2 steps 4/5), which is why the script face can wrap the very same
- * projection the TS face exports.
- *
- * @param name      - op name (error messages + D11 discriminant context).
- * @param params    - machine parameter-name table (object form → positional).
- * @param formClass - D11 form class (A single-name dual-form / B1 options-only /
- *                    B2 two names).
- * @param impl      - the brepjs function.
- * @returns the projected compat op.
- */
-export function projectBrepOp(name, params, formClass, impl) {
-    return (...args) => {
-        assertKernelBound(name);
-        const positional = resolveArgs(args, { name, params, formClass });
-        return callBrepjs(impl, positional);
-    };
-}
-//# sourceMappingURL=compat-projection.js.map

package/dist/api/internal/compat-projection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compat-projection.js","sourceRoot":"","sources":["../../../src/api/internal/compat-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,WAAW,GAAG,KAAK,CAAA;IACvB,IAAI,CAAC;QACH,WAAW,GAAG,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAA;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;IACD,IAAI,CAAC,WAAW,IAAI,qBAAqB,EAAE,KAAK,IAAI,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,WAAW,IAAI,gEAAgE;YAC7E,0DAA0D,IAAI,SAAS;YACvE,+CAA+C,CAClD,CAAA;IACH,CAAC;AACH,CAAC;AAKD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,MAAgB,EAChB,SAAoB,EACpB,IAAmC;IAEnC,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;QAC5B,iBAAiB,CAAC,IAAI,CAAC,CAAA;QACvB,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QACjE,OAAO,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;IACrC,CAAC,CAAA;AACH,CAAC","sourcesContent":["/**\n * compat-projection — the single BREP-TS projection wrapper factory (P23, §4.2).\n *\n * Design: docs/plans/2026-09-03-faijs-brepjs-compat-api.md §4.2 / §4.3.2\n *\n * Every symbol on the TS compat face and every generated `compatOp` op funnels\n * through {@link projectBrepOp}. That is what makes the generated face and the\n * hand-curated `api/brepjs-compat` face one mechanism rather than two:\n *\n *   1. single-kernel assert (D10) — library code never installs a kernel;\n *   2. D11 dual-form normalization — object form → positional form, in the\n *      exported function (§4.2 「归一化位置」), not in a script-side adapter;\n *   3. the brepjs call itself, through `callBrepjs` (Result shape preserved).\n *\n * P21's `api/brepjs-compat` used a private copy of steps 1–3 (`wrapDual`); P23 lifts it\n * here so `gen-l3-surface.ts` can emit one `compatOp(projectBrepOp(…), …)` line\n * per symbol instead of re-expanding the template for each op.\n *\n * @module\n */\n\nimport { resolveArgs, type FormClass } from './dual-form-args'\nimport { callBrepjs } from './l3-bridge'\nimport { getActiveBrepEngineId } from '../../brep/engine/registry'\nimport { getBackends } from '../../runtime-state'\n\n/**\n * Assert that a BREP kernel is bound before invoking a compat op.\n *\n * Reads the configured backend's kernel slot, guarding against the throw that\n * `getBackends()` performs before host configuration. Falls back to the core\n * engine-registry activation flag（2026-09-25 core-decouple wrapup：brepjs\n * registry 已内化到 core——此处只问「core registry 是否已有激活 brep 引擎」）\n * when nothing is configured.\n *\n * @param name - op name, used in the guiding error message.\n * @throws when no BREP kernel is bound (the message tells the host what to do,\n * because library code must never install a kernel itself — §4.2 rule 1).\n */\nexport function assertKernelBound(name: string): void {\n  let kernelBound = false\n  try {\n    kernelBound = getBackends().kernel.brep != null\n  } catch {\n    // backends not configured yet — that is not an error, just no kernel\n  }\n  if (!kernelBound && getActiveBrepEngineId() === null) {\n    throw new Error(\n      `[compat:${name}] no BREP kernel bound; run host init/inject (e.g. initOcct + ` +\n        `register the occt brep engine) before the first compat.${name} call. ` +\n        `Library code must not install kernels itself.`\n    )\n  }\n}\n\n/** Signature of a projected compat op (inputs normalized before the call). */\nexport type CompatProjection = (...args: unknown[]) => unknown\n\n/**\n * Project a brepjs function onto the faijs TS compat face.\n *\n * The returned function is brepjs-shaped: positional arguments in, `Result`\n * (or whatever the brepjs function returns) out — no faijs `Shape`, no\n * adoption. Adoption and the statement-boundary unwrap are `compatOp`'s job\n * (§4.3.2 steps 4/5), which is why the script face can wrap the very same\n * projection the TS face exports.\n *\n * @param name      - op name (error messages + D11 discriminant context).\n * @param params    - machine parameter-name table (object form → positional).\n * @param formClass - D11 form class (A single-name dual-form / B1 options-only /\n *                    B2 two names).\n * @param impl      - the brepjs function.\n * @returns the projected compat op.\n */\nexport function projectBrepOp(\n  name: string,\n  params: string[],\n  formClass: FormClass,\n  impl: (...args: never[]) => unknown,\n): CompatProjection {\n  return (...args: unknown[]) => {\n    assertKernelBound(name)\n    const positional = resolveArgs(args, { name, params, formClass })\n    return callBrepjs(impl, positional)\n  }\n}\n"]}

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

@@ -1,118 +0,0 @@
-/**
- * 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`
- * 形态注册进 vendored registry，使 `vendoredRegistry.getKernel()` 返回当前引擎——
- * vendored 函数全部逻辑（命名/角色表/Result）原样保留、零改动。
- *
- * 边界规则（D8/R5）不变：本文件是 faijs 侧唯一把 vendored kernel registry 与
- * faijs 引擎接线的地方；core 侧只从 `api/` import vendored 树。
- *
- * 装配期完整性检查（方案 §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 { type BrepEngine } from '../brep/engine/registry.js';
-import type { KernelAdapter } from '@faicad/faijs-brepjs/kernel/types.js';
-/** occt-wasm 适配器在 vendored registry 中的注册 id。这是 vendored 注册表的
- * 槽位名（宿主侧判据 + D10 globalThis 单例兼容），**不是**引擎身份标识——
- * 实际引擎由注入的 adapter 决定（vendored 面全部无参 `getKernel()` 取默认）。 */
-export declare const VENDORED_OCCT_KERNEL_ID = "occt-wasm";
-/**
- * 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 declare function injectCurrentBrepEngineAsKernel(): Promise<KernelAdapter>;
-/**
- * 按引擎 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 declare function buildKernelAdapter(engine: BrepEngine): KernelAdapter;
-/**
- * 装配期完整性检查：KernelAdapter 胶水方法齐备断言。
- *
- * @param id - 引擎注册 id（报错时定位到引擎）。
- * @param adapter - 待注入 vendored registry 的 KernelAdapter。
- * @throws 缺失任一胶水方法 → 装配期报错（列出引擎 id 与缺失方法名）。
- */
-export declare function assertGlueMethodsComplete(id: string, adapter: KernelAdapter): void;
-/**
- * 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 declare function __resetKernelInjectionForTests(): void;
-/**
- * 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 declare function isKernelInjected(): boolean;
-/**
- * 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 declare function getBrepjsKernel(): KernelAdapter;
-/**
- * 固定绑定 occt 内核到 vendored registry（Phase 2 前的装配方式）。
- *
- * @deprecated Phase 2 P2-5：固定绑定已被引擎中立的 injectCurrentBrepEngineAsKernel
- * 取代。保留导出仅为兼容旧调用点（适配器层迁移期）；新代码一律用注入函数。
- * @returns 恒抛错——本函数已移除，仅保留签名占位。
- */
-export declare function bindOcctKernel(): KernelAdapter;
-/**
- * 旧 occt 专用注入判据（Phase 2 前语义：绑定且激活内核为 occt-wasm）。
- *
- * @deprecated Phase 2 P2-5：occt 专用判据已被引擎中立的 isKernelInjected() 取代。
- * @returns 当前是否已注入（透传 isKernelInjected()）。
- */
-export declare function isOcctKernelBound(): boolean;
-//# sourceMappingURL=occt-kernel-bridge.d.ts.map

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

@@ -1 +0,0 @@
-{"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,283 +0,0 @@
-/**
- * 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`
- * 形态注册进 vendored registry，使 `vendoredRegistry.getKernel()` 返回当前引擎——
- * vendored 函数全部逻辑（命名/角色表/Result）原样保留、零改动。
- *
- * 边界规则（D8/R5）不变：本文件是 faijs 侧唯一把 vendored kernel registry 与
- * faijs 引擎接线的地方；core 侧只从 `api/` import vendored 树。
- *
- * 装配期完整性检查（方案 §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 '@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()` 取默认）。 */
-export const VENDORED_OCCT_KERNEL_ID = 'occt-wasm';
-/**
- * 装配期完整性检查清单——vendored 面辅助构造/生命周期胶水方法。
- *
- * 这些方法不在 `BrepMethodKind` 能力名体系内（能力判定无法覆盖），但 vendored 面
- * 大量使用（kernelBoundary.ts / wrapperFns / castShape 等）。当前引擎的
- * KernelAdapter 包装必须全部具备，否则对应 compat op / TS compat 面会在执行期崩。
- *
- * Phase 0 盘点实证：36 个 compat op 的 vendored 函数（capability-map 64 方法）与
- * kernelBoundary 都不需要 createAxis*（2D sketcher / TS compat 面需要）——清单按
- * 「vendored 面实际触发面」保守枚举，缺即装配期报错。
- */
-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 (isKernelInjected())
-        return getVendoredKernel();
-    const engine = await getBrepEngine();
-    const adapter = buildKernelAdapter(engine);
-    assertGlueMethodsComplete(engine.id, adapter);
-    registerKernel(VENDORED_OCCT_KERNEL_ID, adapter);
-    freezeKernels();
-    _injected = true;
-    syncRegistryToGlobal();
-    return adapter;
-}
-/**
- * 按引擎 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') {
-        // 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);
-}
-/** No-op `delete` for synthesized glue objects (mirrors vendored `noop`). */
-const noop = () => { };
-/**
- * vendored 测量名 ↔ BrepEngineApi 能力映射（Phase 6 收口，D7）：
- * area/length 已映射到 L1 测量面（getSurfaceArea/getLength，Phase 4 D9 接线）；
- * linearCenterOfMass 无 L1 对应（L2 平台面，primitives.ts 注释），保留真实缺口——
- * 不补桩、不返回 0（静默 0 比崩溃更糟），测试内联钉住 undefined。
- */
-/** 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],
-        };
-    };
-    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.
-    // linearCenterOfMass（L2 平台面）无 L1 对应，保持 undefined（缺口由测试内联钉住）。
-}
-/**
- * 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 内核到 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 +0,0 @@
-{"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"]}