@faicad/faijs 0.16.1 → 0.18.0

package/dist/occt-kernel/hullOps.js

@@ -0,0 +1,52 @@
+/**
+ * Convex hull operations for the faijs occt kernel（第一方模块）。
+ *
+ * 2026-09-25 core-decouple Phase 2 §5.1：最小闭包移植——算法复制自 brepjs
+ * `src/kernel/occtWasm/hullOps.ts` + `src/kernel/occtWasm/constructionOps.ts#buildSolidFromFaces`，
+ * BREP 重建改为 core 的 occt-wasm 原生直调（`buildTriFace` / `sewAndSolidify` /
+ * `fixFaceOrientations` / `release`，occt-wasm index.d.ts 形态——ShapeHandle[]、
+ * Vec3 对象），**不 import brepjs**。occt-wasm 无原生 hull（Phase 0 实证），
+ * 故不直调原生 hull；QuickHull 由 `./hullGeometry` 承担。
+ */
+import { quickHull } from './hullGeometry.js';
+/**
+ * 由点集构造凸包实体（brepjs 原语义：quickHull → 三角面 → 缝合 → 修复朝向 → solid）。
+ *
+ * @param k - OCCT kernel used for BREP reconstruction.
+ * @param points - Input points to build the hull from.
+ * @param tolerance - Point coincidence tolerance for QuickHull.
+ * @returns The constructed hull solid handle.
+ * @throws 点数不足 4 或退化（面 < 4）——与 brepjs 原实现一致。
+ */
+export function hullFromPoints(k, points, tolerance) {
+    if (points.length < 4)
+        throw new Error('hullFromPoints: need at least 4 points');
+    const { points: hullPoints, faces } = quickHull(points, tolerance);
+    if (faces.length < 4)
+        throw new Error('hullFromPoints: degenerate hull (fewer than 4 faces)');
+    // Build triangle faces, sew them, and solidify（brepjs buildSolidFromFaces 原逻辑）。
+    const faceIds = [];
+    for (const [i0, i1, i2] of faces) {
+        const p0 = hullPoints[i0];
+        const p1 = hullPoints[i1];
+        const p2 = hullPoints[i2];
+        if (!p0 || !p1 || !p2)
+            continue;
+        faceIds.push(k.buildTriFace(p0, p1, p2));
+    }
+    try {
+        const sewn0 = k.sewAndSolidify(faceIds, tolerance);
+        const sewn = k.fixFaceOrientations(sewn0);
+        // fixFaceOrientations returns a fresh slot; release the pre-fix intermediate.
+        if (sewn !== sewn0)
+            k.release(sewn0);
+        return sewn;
+    }
+    finally {
+        // Each buildTriFace is a fresh arena slot consumed into the sewn solid
+        // (shared refcounted TShape); release the triangles once sewing is done.
+        for (const id of faceIds)
+            k.release(id);
+    }
+}
+//# sourceMappingURL=hullOps.js.map

package/dist/occt-kernel/hullOps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hullOps.js","sourceRoot":"","sources":["../../src/occt-kernel/hullOps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,SAAS,EAAa,MAAM,gBAAgB,CAAA;AAErD;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,CAAa,EACb,MAAc,EACd,SAAiB;IAEjB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IAChF,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAClE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IAE7F,gFAAgF;IAChF,MAAM,OAAO,GAAkB,EAAE,CAAA;IACjC,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;QACzB,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;QACzB,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;QACzB,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;YAAE,SAAQ;QAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;IAC1C,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAClD,MAAM,IAAI,GAAG,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;QACzC,8EAA8E;QAC9E,IAAI,IAAI,KAAK,KAAK;YAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QACpC,OAAO,IAA6B,CAAA;IACtC,CAAC;YAAS,CAAC;QACT,uEAAuE;QACvE,yEAAyE;QACzE,KAAK,MAAM,EAAE,IAAI,OAAO;YAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC;AACH,CAAC","sourcesContent":["/**\n * Convex hull operations for the faijs occt kernel（第一方模块）。\n *\n * 2026-09-25 core-decouple Phase 2 §5.1：最小闭包移植——算法复制自 brepjs\n * `src/kernel/occtWasm/hullOps.ts` + `src/kernel/occtWasm/constructionOps.ts#buildSolidFromFaces`，\n * BREP 重建改为 core 的 occt-wasm 原生直调（`buildTriFace` / `sewAndSolidify` /\n * `fixFaceOrientations` / `release`，occt-wasm index.d.ts 形态——ShapeHandle[]、\n * Vec3 对象），**不 import brepjs**。occt-wasm 无原生 hull（Phase 0 实证），\n * 故不直调原生 hull；QuickHull 由 `./hullGeometry` 承担。\n */\n\nimport type { OcctKernel, ShapeHandle } from 'occt-wasm'\nimport type { BrepHandle } from '../brep/engine/types'\nimport { quickHull, type Vec3 } from './hullGeometry'\n\n/**\n * 由点集构造凸包实体（brepjs 原语义：quickHull → 三角面 → 缝合 → 修复朝向 → solid）。\n *\n * @param k - OCCT kernel used for BREP reconstruction.\n * @param points - Input points to build the hull from.\n * @param tolerance - Point coincidence tolerance for QuickHull.\n * @returns The constructed hull solid handle.\n * @throws 点数不足 4 或退化（面 < 4）——与 brepjs 原实现一致。\n */\nexport function hullFromPoints(\n  k: OcctKernel,\n  points: Vec3[],\n  tolerance: number,\n): BrepHandle {\n  if (points.length < 4) throw new Error('hullFromPoints: need at least 4 points')\n  const { points: hullPoints, faces } = quickHull(points, tolerance)\n  if (faces.length < 4) throw new Error('hullFromPoints: degenerate hull (fewer than 4 faces)')\n\n  // Build triangle faces, sew them, and solidify（brepjs buildSolidFromFaces 原逻辑）。\n  const faceIds: ShapeHandle[] = []\n  for (const [i0, i1, i2] of faces) {\n    const p0 = hullPoints[i0]\n    const p1 = hullPoints[i1]\n    const p2 = hullPoints[i2]\n    if (!p0 || !p1 || !p2) continue\n    faceIds.push(k.buildTriFace(p0, p1, p2))\n  }\n  try {\n    const sewn0 = k.sewAndSolidify(faceIds, tolerance)\n    const sewn = k.fixFaceOrientations(sewn0)\n    // fixFaceOrientations returns a fresh slot; release the pre-fix intermediate.\n    if (sewn !== sewn0) k.release(sewn0)\n    return sewn as unknown as BrepHandle\n  } finally {\n    // Each buildTriFace is a fresh arena slot consumed into the sewn solid\n    // (shared refcounted TShape); release the triangles once sewing is done.\n    for (const id of faceIds) k.release(id)\n  }\n}\n"]}

package/dist/occt-kernel/occt-primitives.d.ts

@@ -0,0 +1,14 @@
+import type { AssertSatisfiesBrepEngineApi, BrepEngineApi } from '../brep/engine/primitives.js';
+/**
+ * Create the occt implementation of the L1 engine contract. Idempotent-friendly:
+ * the wasm kernel is a process-level singleton (see initOcctWasm), each call
+ * returns a fresh adapter object over the same kernel.
+ *
+ * @returns a BrepEngineApi implementation backed by the occt wasm kernel.
+ */
+export declare function createOcctPrimitives(): Promise<BrepEngineApi>;
+/** The occt primitives type (BrepEngineApi implementation). */
+export type OcctPrimitives = Awaited<ReturnType<typeof createOcctPrimitives>>;
+/** Compile-time assertion that OcctPrimitives satisfies BrepEngineApi. */
+export type _AssertOcctApi = AssertSatisfiesBrepEngineApi<OcctPrimitives>;
+//# sourceMappingURL=occt-primitives.d.ts.map

package/dist/occt-kernel/occt-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occt-primitives.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/occt-primitives.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAqE5F;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,CAkUnE;AAED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAA;AAI7E,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAA"}

package/dist/occt-kernel/occt-primitives.js

@@ -0,0 +1,351 @@
+import { initOcctWasm } from './occtKernel.js';
+import { hullFromPoints as hullFromPointsCore } from './hullOps.js';
+const asHandle = (h) => h;
+const asShape = (h) => h;
+const shapes = (hs) => hs.map(asShape);
+const v3 = (v) => ({ x: v.x, y: v.y, z: v.z });
+const rad = (deg) => (deg * Math.PI) / 180;
+/** brepjs topology layer uses this upper bound for face hashes (HASH_CODE_MAX). */
+const HASH_UPPER_BOUND = 2 ** 24;
+/**
+ * Build a large planar face (boolean tool) through `point`, oriented by
+ * `normal`. The face is constructed directly in the plane's own basis
+ * (u ⊥ v ⊥ normal, through point) — no post-rotation needed, any normal
+ * direction works (the Phase 1 probe only pinned +Z; this generalizes it).
+ */
+function makePlanarFaceTool(k, point, normal) {
+    const size = 500; // large enough to fully cut any reasonable solid
+    // Pick the axis component with the smallest magnitude to build a stable
+    // perpendicular basis (avoids degeneracy when normal is axis-aligned).
+    const ax = Math.abs(normal.x);
+    const ay = Math.abs(normal.y);
+    const az = Math.abs(normal.z);
+    let u;
+    if (ax <= ay && ax <= az)
+        u = { x: 0, y: -normal.z, z: normal.y };
+    else if (ay <= az)
+        u = { x: -normal.z, y: 0, z: normal.x };
+    else
+        u = { x: normal.y, y: -normal.x, z: 0 };
+    const ul = Math.hypot(u.x, u.y, u.z);
+    u = { x: u.x / ul, y: u.y / ul, z: u.z / ul };
+    const v = {
+        x: normal.y * u.z - normal.z * u.y,
+        y: normal.z * u.x - normal.x * u.z,
+        z: normal.x * u.y - normal.y * u.x,
+    };
+    const corner = (a, b) => ({
+        x: point.x + (u.x * a + v.x * b) * size,
+        y: point.y + (u.y * a + v.y * b) * size,
+        z: point.z + (u.z * a + v.z * b) * size,
+    });
+    const e1 = k.makeLineEdge(corner(-1, -1), corner(1, -1));
+    const e2 = k.makeLineEdge(corner(1, -1), corner(1, 1));
+    const e3 = k.makeLineEdge(corner(1, 1), corner(-1, 1));
+    const e4 = k.makeLineEdge(corner(-1, 1), corner(-1, -1));
+    const wire = k.makeWire([e1, e2, e3, e4]);
+    const face = k.makeFace(wire);
+    k.release(wire);
+    return face;
+}
+/**
+ * Create the occt implementation of the L1 engine contract. Idempotent-friendly:
+ * the wasm kernel is a process-level singleton (see initOcctWasm), each call
+ * returns a fresh adapter object over the same kernel.
+ *
+ * @returns a BrepEngineApi implementation backed by the occt wasm kernel.
+ */
+export async function createOcctPrimitives() {
+    const k = await initOcctWasm();
+    const raw = k;
+    // Capture native pattern methods BEFORE any wiring so gridPattern composes
+    // on true native semantics (old adapter GOTCHA: after overwriting, calling
+    // the property again recurses into the wrapper).
+    const nativeLinearPattern = raw.linearPattern.bind(k);
+    // 2026-09-25 core-decouple Phase 2（§5.1）：hull 最小闭包已移植进 occt-kernel/
+    // （hullGeometry + hullOps，occt-wasm 原生直调），此处不再经 vendored
+    // OcctWasmAdapter——core 自有引擎对 brepjs 适配器的最后一处依赖已拔除。
+    const splitCompoundToArray = (compound) => {
+        const parts = k.getSubShapes(compound, 'solid').map(asHandle);
+        k.release(compound);
+        return parts;
+    };
+    const toEvolution = (e) => ({
+        // occt-wasm's EvolutionData already carries the segmented
+        // [inHash, count, outHash…] encoding pinned by phase0-kernel-probes
+        // (its own docs claim flat maps — docs are wrong, data is segmented).
+        result: asHandle(e.result),
+        modified: e.modified,
+        generated: e.generated,
+        deleted: e.deleted,
+    });
+    const primitives = {
+        // ── lifecycle ──
+        release: (shape) => k.release(asShape(shape)),
+        dispose: (shape) => {
+            if (shape !== undefined)
+                k.release(asShape(shape));
+        },
+        // ── solids ──
+        makeBox: (dx, dy, dz) => asHandle(k.makeBox(dx, dy, dz)),
+        makeBoxFromCorners: (c1, c2) => asHandle(k.makeBoxFromCorners(c1, c2)),
+        makeCylinder: (radius, height) => asHandle(k.makeCylinder(radius, height)),
+        makeSphere: (radius) => asHandle(k.makeSphere(radius)),
+        makeCone: (r1, r2, height) => asHandle(k.makeCone(r1, r2, height)),
+        makeRectangle: (w, h) => asHandle(k.makeRectangle(w, h)),
+        makeEllipsoid: (rx, ry, rz) => asHandle(k.makeEllipsoid(rx, ry, rz)),
+        makeTorus: (major, minor) => asHandle(k.makeTorus(major, minor)),
+        makeVertex: (x, y, z) => asHandle(k.makeVertex(x, y, z)),
+        // ── shaping ──
+        extrude: (shape, dx, dy, dz) => asHandle(k.extrude(asShape(shape), dx, dy, dz)),
+        revolveVec: (shape, center, direction, angleDeg) => asHandle(k.revolve(asShape(shape), { point: center, direction }, rad(angleDeg))),
+        sew: (list, tolerance) => asHandle(k.sew(shapes(list), tolerance)),
+        sewAndSolidify: (faces, tolerance) => asHandle(k.sewAndSolidify(shapes(faces), tolerance)),
+        shell: (solid, facesToRemove, thickness, tolerance) => asHandle(k.shell(asShape(solid), shapes(facesToRemove), thickness, tolerance)),
+        hullFromPoints: (points, tolerance) => hullFromPointsCore(k, points, tolerance),
+        // ── booleans & splitting ──
+        fuse: (a, b) => asHandle(k.fuse(asShape(a), asShape(b))),
+        cut: (a, b) => asHandle(k.cut(asShape(a), asShape(b))),
+        common: (a, b) => asHandle(k.common(asShape(a), asShape(b))),
+        intersect: (a, b) => asHandle(k.intersect(asShape(a), asShape(b))),
+        fuseAll: (list) => asHandle(k.fuseAll(shapes(list))),
+        sectionByPlane: (shape, point, normal) => {
+            // Phase 1 probe A (phase1-semantic-probes.test.ts): a planar face used as
+            // the section tool yields the plane-section geometry. Downcast the result
+            // compound into edge/wire handles; a non-compound result passes through.
+            const tool = makePlanarFaceTool(k, point, normal);
+            try {
+                const result = k.section(asShape(shape), tool);
+                if (k.isNull(result))
+                    return [];
+                const out = [];
+                for (const t of ['edge', 'wire']) {
+                    for (const part of k.getSubShapes(result, t))
+                        out.push(asHandle(k.downcast(part, t)));
+                }
+                if (out.length === 0) {
+                    // No intersection: native section still yields an (empty) compound —
+                    // release it and return an empty list so callers can detect the miss
+                    // instead of adopting an empty compound as a "curve".
+                    k.release(result);
+                    return [];
+                }
+                k.release(result);
+                return out;
+            }
+            finally {
+                k.release(tool);
+            }
+        },
+        splitByPlane: (shape, point, normal) => {
+            // Phase 1 probe A: splitter with a planar face tool yields exactly 2 solids.
+            const tool = makePlanarFaceTool(k, point, normal);
+            try {
+                const result = k.split(asShape(shape), [tool]);
+                if (k.isNull(result))
+                    throw new Error('splitByPlane: splitter produced no result');
+                const solids = k.getSubShapes(result, 'solid').map(asHandle);
+                k.release(result);
+                if (solids.length !== 2) {
+                    throw new Error(`splitByPlane: expected 2 solids, got ${solids.length}`);
+                }
+                // Classify sides by centroid projection onto the plane normal.
+                const originDot = point.x * normal.x + point.y * normal.y + point.z * normal.z;
+                const side = (h) => {
+                    const c = k.getCenterOfMass(asShape(h));
+                    return c.x * normal.x + c.y * normal.y + c.z * normal.z - originDot;
+                };
+                const [a, b] = solids;
+                return side(a) >= side(b)
+                    ? { positive: a, negative: b }
+                    : { positive: b, negative: a };
+            }
+            finally {
+                k.release(tool);
+            }
+        },
+        // ── chamfer & fillet ──
+        chamfer: (solid, edgesList, distance) => asHandle(k.chamfer(asShape(solid), shapes(edgesList), distance)),
+        chamferDistAngle: (solid, edgesList, distance, angleDeg) => asHandle(k.chamferDistAngle(asShape(solid), shapes(edgesList), distance, angleDeg)),
+        fillet: (solid, edgesList, radius) => asHandle(k.fillet(asShape(solid), shapes(edgesList), radius)),
+        filletVariable: (solid, edge, startRadius, endRadius) => asHandle(k.filletVariable(asShape(solid), asShape(edge), startRadius, endRadius)),
+        filletWithHistory: (solid, edgesList, radius, inputFaceHashes, hashUpperBound) => toEvolution(k.filletWithHistory(asShape(solid), shapes(edgesList), radius, inputFaceHashes, hashUpperBound)),
+        // ── transforms (matrix convention: 3×4 row-major, 12 doubles) ──
+        translate: (shape, dx, dy, dz) => asHandle(k.translate(asShape(shape), dx, dy, dz)),
+        scale: (shape, center, factor) => asHandle(k.scale(asShape(shape), center, factor)),
+        transform: (shape, matrix) => asHandle(k.transform(asShape(shape), matrix)),
+        located: (shape, matrix) => asHandle(k.located(asShape(shape), matrix)),
+        locate: (shape, matrix) => asHandle(k.located(asShape(shape), matrix)),
+        generalTransform: (shape, matrix) => asHandle(k.generalTransform(asShape(shape), matrix)),
+        copy: (shape) => asHandle(k.copy(asShape(shape))),
+        copyShape: (shape) => asHandle(k.copy(asShape(shape))),
+        composeTransform: (m1, m2) => k.composeTransform(m1, m2),
+        mirror: (shape, point, normal) => asHandle(k.mirror(asShape(shape), point, normal)),
+        // ── patterns ──
+        // GOTCHA: occt-wasm native linearPattern/circularPattern return ONE compound
+        // handle (their d.ts type lies). Split it into per-replica handles here.
+        linearPattern: (shape, direction, spacing, count) => {
+            const compound = nativeLinearPattern(asShape(shape), direction, spacing, count);
+            return splitCompoundToArray(compound);
+        },
+        circularPattern: (shape, center, axis, angleStep, count) => {
+            // Empirically validated (old adapter + engine-switch-p2 parity): the wasm
+            // layer takes the angle in DEGREES here (unlike revolve's angleRad).
+            const compound = k.circularPattern.call(k, asShape(shape), center, axis, angleStep, count);
+            return splitCompoundToArray(compound);
+        },
+        gridPattern: (shape, directionX, directionY, spacingX, spacingY, countX, countY) => {
+            // Composed: native linearPattern along X per column, then along Y per row,
+            // fuse all replicas. Must use the CAPTURED native linearPattern (returns
+            // compound) — the adapter property above now returns arrays.
+            const colCompound = nativeLinearPattern(asShape(shape), directionX, spacingX, countX);
+            const cols = k.getSubShapes(colCompound, 'solid');
+            k.release(colCompound);
+            const all = [];
+            try {
+                for (const c of cols) {
+                    const rowCompound = nativeLinearPattern(c, directionY, spacingY, countY);
+                    try {
+                        all.push(...k.getSubShapes(rowCompound, 'solid'));
+                    }
+                    finally {
+                        k.release(rowCompound);
+                    }
+                }
+            }
+            finally {
+                for (const c of cols)
+                    k.release(c);
+            }
+            return asHandle(k.fuseAll(all));
+        },
+        // ── curve construction ──
+        makeLineEdge: (start, end) => asHandle(k.makeLineEdge(start, end)),
+        makeArcEdge: (start, mid, end) => asHandle(k.makeArcEdge(start, mid, end)),
+        makeBezierEdge: (controlPoints) => asHandle(k.makeBezierEdge(controlPoints)),
+        makeCircleEdge: (center, normal, radius) => asHandle(k.makeCircleEdge(center, normal, radius)),
+        // ── topology construction ──
+        makeWire: (edgesList) => asHandle(k.makeWire(shapes(edgesList))),
+        makeFace: (wire) => asHandle(k.makeFace(asShape(wire))),
+        makeCompound: (list) => asHandle(k.makeCompound(shapes(list))),
+        addHolesInFace: (face, holeWires) => asHandle(k.addHolesInFace(asShape(face), shapes(holeWires))),
+        buildTriFace: (a, b, c) => asHandle(k.buildTriFace(a, b, c)),
+        // ── tessellation (the only BREP→mesh exit) ──
+        meshShape: (shape, options) => {
+            const m = k.meshShape(asShape(shape), options);
+            return {
+                positions: m.positions,
+                normals: m.normals,
+                indices: m.indices,
+                vertexCount: m.vertexCount,
+                triangleCount: m.triangleCount,
+                faceGroups: m.faceGroups,
+                faceCount: m.faceCount,
+            };
+        },
+        wireframe: (shape, deflection) => {
+            const e = k.wireframe(asShape(shape), deflection);
+            return {
+                points: e.points,
+                edgeGroups: e.edgeGroups,
+                pointCount: e.pointCount,
+                edgeCount: e.edgeCount,
+            };
+        },
+        // ── topology queries ──
+        getSubShapes: (shape, type) => k.getSubShapes(asShape(shape), type).map(asHandle),
+        subShapeHashes: (shape, type, hashUpperBound) => k.subShapeHashes(asShape(shape), type, hashUpperBound),
+        hashCode: (shape, upperBound) => k.hashCode(asShape(shape), upperBound),
+        isSame: (a, b) => k.isSame(asShape(a), asShape(b)),
+        isSolid: (shape) => k.isSolid(asShape(shape)),
+        shapeType: (shape) => k.getShapeType(asShape(shape)),
+        shapeOrientation: (shape) => String(k.shapeOrientation(asShape(shape))),
+        edgeToFaceMap: (shape) => k.edgeToFaceMap(asShape(shape), HASH_UPPER_BOUND),
+        adjacentFaces: (shape, face) => k.adjacentFaces(asShape(shape), asShape(face)).map(asHandle),
+        sharedEdges: (a, b) => k.sharedEdges(asShape(a), asShape(b)).map(asHandle),
+        // ── geometry evaluation ──
+        curveType: (edge) => String(k.curveType(asShape(edge))),
+        curvePointAtParam: (edge, param) => v3(k.curvePointAtParam(asShape(edge), param)),
+        curveTangent: (edge, param) => v3(k.curveTangent(asShape(edge), param)),
+        curveParameters: (edge) => k.curveParameters(asShape(edge)),
+        curveIsClosed: (edge) => k.curveIsClosed(asShape(edge)),
+        curveLength: (edge) => k.curveLength(asShape(edge)),
+        surfaceType: (face) => String(k.surfaceType(asShape(face))),
+        surfaceNormal: (face, u, vv) => v3(k.surfaceNormal(asShape(face), u, vv)),
+        pointOnSurface: (face, u, vv) => v3(k.pointOnSurface(asShape(face), u, vv)),
+        uvBounds: (face) => k.uvBounds(asShape(face)),
+        surfaceCenterOfMass: (face) => v3(k.getSurfaceCenterOfMass(asShape(face))),
+        getFaceCylinderData: (face) => {
+            const d = k.getFaceCylinderData(asShape(face));
+            return d ? { radius: d.radius } : null;
+        },
+        getNurbsCurveData: (edge) => {
+            const d = k.getNurbsCurveData(asShape(edge));
+            return d ? { degree: d.degree, periodic: d.periodic, rational: d.rational } : null;
+        },
+        interpolatePoints: (points, degree) => {
+            // L1 contract takes an explicit degree; occt-wasm interpolates a cubic
+            // (or periodic) spline and ignores degree — honor only degree 3 and
+            // reject others loudly rather than silently producing wrong geometry.
+            if (degree !== 3) {
+                throw new Error(`occt interpolatePoints: only degree 3 supported, got ${degree}`);
+            }
+            return asHandle(k.interpolatePoints(points));
+        },
+        defeature: (shape, facesList) => asHandle(k.defeature(asShape(shape), shapes(facesList), 0)),
+        draft: (shape, facesList, pull, neutral, angleDeg) => {
+            // Native draft is single-face + radians, and has NO neutral-plane argument
+            // (occt-wasm index.d.ts:156 `draft(shape, face, angleRad, direction)`).
+            // Silently dropping a caller-supplied neutral plane would draft against the
+            // wrong plane, so reject loudly (same rule as `interpolatePoints` below).
+            // brepkit's L1 draft does consume the neutral point (brepkitKernel.ts:669).
+            if (neutral && (neutral.x !== 0 || neutral.y !== 0 || neutral.z !== 0)) {
+                throw new Error('occt draft: neutral plane is not supported by the native kernel ' +
+                    `(got neutral=(${neutral.x},${neutral.y},${neutral.z})); only the origin neutral is representable`);
+            }
+            // Native draft is single-face; fold N faces sequentially.
+            let current = asShape(shape);
+            for (const f of facesList) {
+                current = k.draft(current, asShape(f), rad(angleDeg), pull);
+            }
+            return asHandle(current);
+        },
+        removeHolesFromFace: (face) => {
+            // Native takes hole indices; removing ALL holes = all wires except outer.
+            const wires = k.getSubShapes(asShape(face), 'wire');
+            const indices = wires.map((_, i) => i).filter((i) => i > 0);
+            return asHandle(k.removeHolesFromFace(asShape(face), indices));
+        },
+        reverseShape: (shape) => asHandle(k.reverseShape(asShape(shape))),
+        projectEdges: (shape, origin, direction, xAxis, _hiddenLines, _deflection) => 
+        // Native projection has no hiddenLines/deflection flags in its signature —
+        // pass through the projection result; callers treat it as opaque (unknown).
+        k.projectEdges(asShape(shape), origin, direction, xAxis),
+        // ── measurement ──
+        getBoundingBox: (shape, useTriangulation) => k.getBoundingBox(asShape(shape), useTriangulation),
+        getVolume: (shape) => k.getVolume(asShape(shape)),
+        getCenterOfMass: (shape) => v3(k.getCenterOfMass(asShape(shape))),
+        getSurfaceArea: (shape) => k.getSurfaceArea(asShape(shape)),
+        getLength: (shape) => k.getLength(asShape(shape)),
+        // ── validation & repair ──
+        isValid: (shape) => k.isValid(asShape(shape)),
+        unifySameDomain: (shape) => asHandle(k.unifySameDomain(asShape(shape))),
+        healSolid: (shape, tolerance) => asHandle(k.healSolid(asShape(shape), tolerance)),
+        fixShape: (shape) => asHandle(k.fixShape(asShape(shape))),
+        fixFaceOrientations: (shape) => asHandle(k.fixFaceOrientations(asShape(shape))),
+        removeDegenerateEdges: (shape, _tolerance) => 
+        // Native takes no tolerance parameter (kernel-fixed tolerance).
+        asHandle(k.removeDegenerateEdges(asShape(shape))),
+        // ── IO ──
+        importStep: (data) => asHandle(k.importStep(data)),
+        exportStep: (shape) => k.exportStep(asShape(shape)),
+        importStl: (data) => asHandle(k.importStl(data)),
+        fromBREP: (data) => asHandle(k.fromBREP(data)),
+        // ── face evolution (L1 trio only) ──
+        cutWithHistory: (a, b, inputFaceHashes, hashUpperBound) => toEvolution(k.cutWithHistory(asShape(a), asShape(b), inputFaceHashes, hashUpperBound)),
+        fuseWithHistory: (a, b, inputFaceHashes, hashUpperBound) => toEvolution(k.fuseWithHistory(asShape(a), asShape(b), inputFaceHashes, hashUpperBound)),
+        intersectWithHistory: (a, b, inputFaceHashes, hashUpperBound) => toEvolution(k.intersectWithHistory(asShape(a), asShape(b), inputFaceHashes, hashUpperBound)),
+    };
+    return primitives;
+}
+//# sourceMappingURL=occt-primitives.js.map

package/dist/occt-kernel/occt-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occt-primitives.js","sourceRoot":"","sources":["../../src/occt-kernel/occt-primitives.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * occt-kernel/occt-primitives — `createOcctPrimitives()`: the L1 contract\n * (`BrepEngineApi`) adapter over the raw occt-wasm `OcctKernel` singleton.\n *\n * Plan Phase 3.2 (docs/plans/2026-09-24-brep-engine-api-narrowing-native-access.md):\n * explicit object literal, one method per L1 contract member — no monkey\n * patching, no cross-layer assertion lies, no unsupported() stubs. Every member\n * here is either a direct pass-through to the native kernel or an adapter-side\n * dialect digestion, both honestly implementing the contract.\n *\n * Occt-only capabilities (loft family, tool-entity section/split, *WithHistory\n * beyond the L1 trio, XCAF, SVG projection …) are deliberately NOT here —\n * platform code reaches them through the native face: `getOcctKernel()` (D3).\n */\nimport type {\n  EdgeData,\n  EvolutionData,\n  Mesh,\n  OcctKernel,\n  ShapeHandle,\n  Vec3,\n} from 'occt-wasm'\nimport { initOcctWasm } from './occtKernel'\nimport { hullFromPoints as hullFromPointsCore } from './hullOps'\nimport type { AssertSatisfiesBrepEngineApi, BrepEngineApi } from '../brep/engine/primitives'\nimport type {\n  BrepBoundingBox,\n  BrepCurveParameters,\n  BrepEdgeData,\n  BrepEvolutionData,\n  BrepHandle,\n  BrepMeshResult,\n  BrepUvBounds,\n  BrepVec3,\n} from '../brep/engine/types'\n\nconst asHandle = (h: number | ShapeHandle): BrepHandle => h as BrepHandle\nconst asShape = (h: BrepHandle): ShapeHandle => h as unknown as ShapeHandle\nconst shapes = (hs: BrepHandle[]): ShapeHandle[] => hs.map(asShape)\nconst v3 = (v: Vec3): BrepVec3 => ({ x: v.x, y: v.y, z: v.z })\nconst rad = (deg: number): number => (deg * Math.PI) / 180\n\n/** brepjs topology layer uses this upper bound for face hashes (HASH_CODE_MAX). */\nconst HASH_UPPER_BOUND = 2 ** 24\n\n/** occt-wasm native linearPattern/circularPattern return ONE compound handle\n * containing all replicas (the wasm d.ts type lies by claiming a plain handle).\n * The adapter captures the native methods, then splits the compound via\n * getSubShapes('solid') into the BrepHandle[] the L1 contract promises. */\ntype OcctPatternRaw = {\n  linearPattern(shape: ShapeHandle, direction: Vec3, spacing: number, count: number): ShapeHandle\n  circularPattern(shape: ShapeHandle, center: Vec3, axis: Vec3, angle: number, count: number): ShapeHandle\n}\n\n/**\n * Build a large planar face (boolean tool) through `point`, oriented by\n * `normal`. The face is constructed directly in the plane's own basis\n * (u ⊥ v ⊥ normal, through point) — no post-rotation needed, any normal\n * direction works (the Phase 1 probe only pinned +Z; this generalizes it).\n */\nfunction makePlanarFaceTool(k: OcctKernel, point: BrepVec3, normal: BrepVec3): ShapeHandle {\n  const size = 500 // large enough to fully cut any reasonable solid\n  // Pick the axis component with the smallest magnitude to build a stable\n  // perpendicular basis (avoids degeneracy when normal is axis-aligned).\n  const ax = Math.abs(normal.x)\n  const ay = Math.abs(normal.y)\n  const az = Math.abs(normal.z)\n  let u: BrepVec3\n  if (ax <= ay && ax <= az) u = { x: 0, y: -normal.z, z: normal.y }\n  else if (ay <= az) u = { x: -normal.z, y: 0, z: normal.x }\n  else u = { x: normal.y, y: -normal.x, z: 0 }\n  const ul = Math.hypot(u.x, u.y, u.z)\n  u = { x: u.x / ul, y: u.y / ul, z: u.z / ul }\n  const v: BrepVec3 = {\n    x: normal.y * u.z - normal.z * u.y,\n    y: normal.z * u.x - normal.x * u.z,\n    z: normal.x * u.y - normal.y * u.x,\n  }\n  const corner = (a: number, b: number): Vec3 => ({\n    x: point.x + (u.x * a + v.x * b) * size,\n    y: point.y + (u.y * a + v.y * b) * size,\n    z: point.z + (u.z * a + v.z * b) * size,\n  })\n  const e1 = k.makeLineEdge(corner(-1, -1), corner(1, -1))\n  const e2 = k.makeLineEdge(corner(1, -1), corner(1, 1))\n  const e3 = k.makeLineEdge(corner(1, 1), corner(-1, 1))\n  const e4 = k.makeLineEdge(corner(-1, 1), corner(-1, -1))\n  const wire = k.makeWire([e1, e2, e3, e4])\n  const face = k.makeFace(wire)\n  k.release(wire)\n  return face\n}\n\n/**\n * Create the occt implementation of the L1 engine contract. Idempotent-friendly:\n * the wasm kernel is a process-level singleton (see initOcctWasm), each call\n * returns a fresh adapter object over the same kernel.\n *\n * @returns a BrepEngineApi implementation backed by the occt wasm kernel.\n */\nexport async function createOcctPrimitives(): Promise<BrepEngineApi> {\n  const k = await initOcctWasm()\n  const raw = k as unknown as OcctPatternRaw\n  // Capture native pattern methods BEFORE any wiring so gridPattern composes\n  // on true native semantics (old adapter GOTCHA: after overwriting, calling\n  // the property again recurses into the wrapper).\n  const nativeLinearPattern = raw.linearPattern.bind(k)\n  // 2026-09-25 core-decouple Phase 2（§5.1）：hull 最小闭包已移植进 occt-kernel/\n  // （hullGeometry + hullOps，occt-wasm 原生直调），此处不再经 vendored\n  // OcctWasmAdapter——core 自有引擎对 brepjs 适配器的最后一处依赖已拔除。\n\n  const splitCompoundToArray = (compound: ShapeHandle): BrepHandle[] => {\n    const parts = k.getSubShapes(compound, 'solid').map(asHandle)\n    k.release(compound)\n    return parts\n  }\n\n  const toEvolution = (e: EvolutionData): BrepEvolutionData => ({\n    // occt-wasm's EvolutionData already carries the segmented\n    // [inHash, count, outHash…] encoding pinned by phase0-kernel-probes\n    // (its own docs claim flat maps — docs are wrong, data is segmented).\n    result: asHandle(e.result),\n    modified: e.modified,\n    generated: e.generated,\n    deleted: e.deleted,\n  })\n\n  const primitives: BrepEngineApi = {\n    // ── lifecycle ──\n    release: (shape) => k.release(asShape(shape)),\n    dispose: (shape) => {\n      if (shape !== undefined) k.release(asShape(shape))\n    },\n\n    // ── solids ──\n    makeBox: (dx, dy, dz) => asHandle(k.makeBox(dx, dy, dz)),\n    makeBoxFromCorners: (c1, c2) => asHandle(k.makeBoxFromCorners(c1, c2)),\n    makeCylinder: (radius, height) => asHandle(k.makeCylinder(radius, height)),\n    makeSphere: (radius) => asHandle(k.makeSphere(radius)),\n    makeCone: (r1, r2, height) => asHandle(k.makeCone(r1, r2, height)),\n    makeRectangle: (w, h) => asHandle(k.makeRectangle(w, h)),\n    makeEllipsoid: (rx, ry, rz) => asHandle(k.makeEllipsoid(rx, ry, rz)),\n    makeTorus: (major, minor) => asHandle(k.makeTorus(major, minor)),\n    makeVertex: (x, y, z) => asHandle(k.makeVertex(x, y, z)),\n\n    // ── shaping ──\n    extrude: (shape, dx, dy, dz) => asHandle(k.extrude(asShape(shape), dx, dy, dz)),\n    revolveVec: (shape, center, direction, angleDeg) =>\n      asHandle(k.revolve(asShape(shape), { point: center, direction }, rad(angleDeg))),\n    sew: (list, tolerance) => asHandle(k.sew(shapes(list), tolerance)),\n    sewAndSolidify: (faces, tolerance) => asHandle(k.sewAndSolidify(shapes(faces), tolerance)),\n    shell: (solid, facesToRemove, thickness, tolerance) =>\n      asHandle(k.shell(asShape(solid), shapes(facesToRemove), thickness, tolerance)),\n    hullFromPoints: (points, tolerance) => hullFromPointsCore(k, points as never, tolerance),\n\n    // ── booleans & splitting ──\n    fuse: (a, b) => asHandle(k.fuse(asShape(a), asShape(b))),\n    cut: (a, b) => asHandle(k.cut(asShape(a), asShape(b))),\n    common: (a, b) => asHandle(k.common(asShape(a), asShape(b))),\n    intersect: (a, b) => asHandle(k.intersect(asShape(a), asShape(b))),\n    fuseAll: (list) => asHandle(k.fuseAll(shapes(list))),\n    sectionByPlane: (shape, point, normal) => {\n      // Phase 1 probe A (phase1-semantic-probes.test.ts): a planar face used as\n      // the section tool yields the plane-section geometry. Downcast the result\n      // compound into edge/wire handles; a non-compound result passes through.\n      const tool = makePlanarFaceTool(k, point, normal)\n      try {\n        const result = k.section(asShape(shape), tool)\n        if (k.isNull(result)) return []\n        const out: BrepHandle[] = []\n        for (const t of ['edge', 'wire'] as const) {\n          for (const part of k.getSubShapes(result, t)) out.push(asHandle(k.downcast(part, t)))\n        }\n        if (out.length === 0) {\n          // No intersection: native section still yields an (empty) compound —\n          // release it and return an empty list so callers can detect the miss\n          // instead of adopting an empty compound as a \"curve\".\n          k.release(result)\n          return []\n        }\n        k.release(result)\n        return out\n      } finally {\n        k.release(tool)\n      }\n    },\n    splitByPlane: (shape, point, normal) => {\n      // Phase 1 probe A: splitter with a planar face tool yields exactly 2 solids.\n      const tool = makePlanarFaceTool(k, point, normal)\n      try {\n        const result = k.split(asShape(shape), [tool])\n        if (k.isNull(result)) throw new Error('splitByPlane: splitter produced no result')\n        const solids = k.getSubShapes(result, 'solid').map(asHandle)\n        k.release(result)\n        if (solids.length !== 2) {\n          throw new Error(`splitByPlane: expected 2 solids, got ${solids.length}`)\n        }\n        // Classify sides by centroid projection onto the plane normal.\n        const originDot = point.x * normal.x + point.y * normal.y + point.z * normal.z\n        const side = (h: BrepHandle): number => {\n          const c = k.getCenterOfMass(asShape(h))\n          return c.x * normal.x + c.y * normal.y + c.z * normal.z - originDot\n        }\n        const [a, b] = solids\n        return side(a) >= side(b)\n          ? { positive: a, negative: b }\n          : { positive: b, negative: a }\n      } finally {\n        k.release(tool)\n      }\n    },\n\n    // ── chamfer & fillet ──\n    chamfer: (solid, edgesList, distance) =>\n      asHandle(k.chamfer(asShape(solid), shapes(edgesList), distance)),\n    chamferDistAngle: (solid, edgesList, distance, angleDeg) =>\n      asHandle(k.chamferDistAngle(asShape(solid), shapes(edgesList), distance, angleDeg)),\n    fillet: (solid, edgesList, radius) =>\n      asHandle(k.fillet(asShape(solid), shapes(edgesList), radius)),\n    filletVariable: (solid, edge, startRadius, endRadius) =>\n      asHandle(k.filletVariable(asShape(solid), asShape(edge), startRadius, endRadius)),\n    filletWithHistory: (solid, edgesList, radius, inputFaceHashes, hashUpperBound) =>\n      toEvolution(k.filletWithHistory(asShape(solid), shapes(edgesList), radius, inputFaceHashes, hashUpperBound)),\n\n    // ── transforms (matrix convention: 3×4 row-major, 12 doubles) ──\n    translate: (shape, dx, dy, dz) => asHandle(k.translate(asShape(shape), dx, dy, dz)),\n    scale: (shape, center, factor) => asHandle(k.scale(asShape(shape), center, factor)),\n    transform: (shape, matrix) => asHandle(k.transform(asShape(shape), matrix)),\n    located: (shape, matrix) => asHandle(k.located(asShape(shape), matrix)),\n    locate: (shape, matrix) => asHandle(k.located(asShape(shape), matrix)),\n    generalTransform: (shape, matrix) => asHandle(k.generalTransform(asShape(shape), matrix)),\n    copy: (shape) => asHandle(k.copy(asShape(shape))),\n    copyShape: (shape) => asHandle(k.copy(asShape(shape))),\n    composeTransform: (m1, m2) => k.composeTransform(m1, m2),\n    mirror: (shape, point, normal) => asHandle(k.mirror(asShape(shape), point, normal)),\n\n    // ── patterns ──\n    // GOTCHA: occt-wasm native linearPattern/circularPattern return ONE compound\n    // handle (their d.ts type lies). Split it into per-replica handles here.\n    linearPattern: (shape, direction, spacing, count) => {\n      const compound = nativeLinearPattern(asShape(shape), direction, spacing, count)\n      return splitCompoundToArray(compound)\n    },\n    circularPattern: (shape, center, axis, angleStep, count) => {\n      // Empirically validated (old adapter + engine-switch-p2 parity): the wasm\n      // layer takes the angle in DEGREES here (unlike revolve's angleRad).\n      const compound = (k as unknown as OcctPatternRaw).circularPattern.call(\n        k, asShape(shape), center, axis, angleStep, count,\n      )\n      return splitCompoundToArray(compound)\n    },\n    gridPattern: (shape, directionX, directionY, spacingX, spacingY, countX, countY) => {\n      // Composed: native linearPattern along X per column, then along Y per row,\n      // fuse all replicas. Must use the CAPTURED native linearPattern (returns\n      // compound) — the adapter property above now returns arrays.\n      const colCompound = nativeLinearPattern(asShape(shape), directionX, spacingX, countX)\n      const cols = k.getSubShapes(colCompound, 'solid')\n      k.release(colCompound)\n      const all: ShapeHandle[] = []\n      try {\n        for (const c of cols) {\n          const rowCompound = nativeLinearPattern(c, directionY, spacingY, countY)\n          try {\n            all.push(...k.getSubShapes(rowCompound, 'solid'))\n          } finally {\n            k.release(rowCompound)\n          }\n        }\n      } finally {\n        for (const c of cols) k.release(c)\n      }\n      return asHandle(k.fuseAll(all))\n    },\n\n    // ── curve construction ──\n    makeLineEdge: (start, end) => asHandle(k.makeLineEdge(start, end)),\n    makeArcEdge: (start, mid, end) => asHandle(k.makeArcEdge(start, mid, end)),\n    makeBezierEdge: (controlPoints) => asHandle(k.makeBezierEdge(controlPoints)),\n    makeCircleEdge: (center, normal, radius) =>\n      asHandle(k.makeCircleEdge(center, normal, radius)),\n\n    // ── topology construction ──\n    makeWire: (edgesList) => asHandle(k.makeWire(shapes(edgesList))),\n    makeFace: (wire) => asHandle(k.makeFace(asShape(wire))),\n    makeCompound: (list) => asHandle(k.makeCompound(shapes(list))),\n    addHolesInFace: (face, holeWires) =>\n      asHandle(k.addHolesInFace(asShape(face), shapes(holeWires))),\n    buildTriFace: (a, b, c) => asHandle(k.buildTriFace(a, b, c)),\n\n    // ── tessellation (the only BREP→mesh exit) ──\n    meshShape: (shape, options): BrepMeshResult => {\n      const m: Mesh = k.meshShape(asShape(shape), options)\n      return {\n        positions: m.positions,\n        normals: m.normals,\n        indices: m.indices,\n        vertexCount: m.vertexCount,\n        triangleCount: m.triangleCount,\n        faceGroups: m.faceGroups,\n        faceCount: m.faceCount,\n      }\n    },\n    wireframe: (shape, deflection): BrepEdgeData => {\n      const e: EdgeData = k.wireframe(asShape(shape), deflection)\n      return {\n        points: e.points,\n        edgeGroups: e.edgeGroups,\n        pointCount: e.pointCount,\n        edgeCount: e.edgeCount,\n      }\n    },\n\n    // ── topology queries ──\n    getSubShapes: (shape, type) => k.getSubShapes(asShape(shape), type).map(asHandle),\n    subShapeHashes: (shape, type, hashUpperBound) =>\n      k.subShapeHashes(asShape(shape), type, hashUpperBound),\n    hashCode: (shape, upperBound) => k.hashCode(asShape(shape), upperBound),\n    isSame: (a, b) => k.isSame(asShape(a), asShape(b)),\n    isSolid: (shape) => k.isSolid(asShape(shape)),\n    shapeType: (shape) => k.getShapeType(asShape(shape)),\n    shapeOrientation: (shape) => String(k.shapeOrientation(asShape(shape))),\n    edgeToFaceMap: (shape) => k.edgeToFaceMap(asShape(shape), HASH_UPPER_BOUND),\n    adjacentFaces: (shape, face) =>\n      k.adjacentFaces(asShape(shape), asShape(face)).map(asHandle),\n    sharedEdges: (a, b) => k.sharedEdges(asShape(a), asShape(b)).map(asHandle),\n\n    // ── geometry evaluation ──\n    curveType: (edge) => String(k.curveType(asShape(edge))),\n    curvePointAtParam: (edge, param) => v3(k.curvePointAtParam(asShape(edge), param)),\n    curveTangent: (edge, param) => v3(k.curveTangent(asShape(edge), param)),\n    curveParameters: (edge): BrepCurveParameters => k.curveParameters(asShape(edge)),\n    curveIsClosed: (edge) => k.curveIsClosed(asShape(edge)),\n    curveLength: (edge) => k.curveLength(asShape(edge)),\n    surfaceType: (face) => String(k.surfaceType(asShape(face))),\n    surfaceNormal: (face, u, vv) => v3(k.surfaceNormal(asShape(face), u, vv)),\n    pointOnSurface: (face, u, vv) => v3(k.pointOnSurface(asShape(face), u, vv)),\n    uvBounds: (face): BrepUvBounds => k.uvBounds(asShape(face)),\n    surfaceCenterOfMass: (face) => v3(k.getSurfaceCenterOfMass(asShape(face))),\n    getFaceCylinderData: (face) => {\n      const d = k.getFaceCylinderData(asShape(face))\n      return d ? { radius: d.radius } : null\n    },\n    getNurbsCurveData: (edge) => {\n      const d = k.getNurbsCurveData(asShape(edge))\n      return d ? { degree: d.degree, periodic: d.periodic, rational: d.rational } : null\n    },\n    interpolatePoints: (points, degree) => {\n      // L1 contract takes an explicit degree; occt-wasm interpolates a cubic\n      // (or periodic) spline and ignores degree — honor only degree 3 and\n      // reject others loudly rather than silently producing wrong geometry.\n      if (degree !== 3) {\n        throw new Error(`occt interpolatePoints: only degree 3 supported, got ${degree}`)\n      }\n      return asHandle(k.interpolatePoints(points))\n    },\n\n    defeature: (shape, facesList) => asHandle(k.defeature(asShape(shape), shapes(facesList), 0)),\n    draft: (shape, facesList, pull, neutral, angleDeg) => {\n      // Native draft is single-face + radians, and has NO neutral-plane argument\n      // (occt-wasm index.d.ts:156 `draft(shape, face, angleRad, direction)`).\n      // Silently dropping a caller-supplied neutral plane would draft against the\n      // wrong plane, so reject loudly (same rule as `interpolatePoints` below).\n      // brepkit's L1 draft does consume the neutral point (brepkitKernel.ts:669).\n      if (neutral && (neutral.x !== 0 || neutral.y !== 0 || neutral.z !== 0)) {\n        throw new Error(\n          'occt draft: neutral plane is not supported by the native kernel ' +\n            `(got neutral=(${neutral.x},${neutral.y},${neutral.z})); only the origin neutral is representable`,\n        )\n      }\n      // Native draft is single-face; fold N faces sequentially.\n      let current = asShape(shape)\n      for (const f of facesList) {\n        current = k.draft(current, asShape(f), rad(angleDeg), pull)\n      }\n      return asHandle(current)\n    },\n    removeHolesFromFace: (face) => {\n      // Native takes hole indices; removing ALL holes = all wires except outer.\n      const wires = k.getSubShapes(asShape(face), 'wire')\n      const indices = wires.map((_, i) => i).filter((i) => i > 0)\n      return asHandle(k.removeHolesFromFace(asShape(face), indices))\n    },\n    reverseShape: (shape) => asHandle(k.reverseShape(asShape(shape))),\n    projectEdges: (shape, origin, direction, xAxis, _hiddenLines, _deflection) =>\n      // Native projection has no hiddenLines/deflection flags in its signature —\n      // pass through the projection result; callers treat it as opaque (unknown).\n      k.projectEdges(asShape(shape), origin, direction, xAxis),\n\n    // ── measurement ──\n    getBoundingBox: (shape, useTriangulation): BrepBoundingBox =>\n      k.getBoundingBox(asShape(shape), useTriangulation),\n    getVolume: (shape) => k.getVolume(asShape(shape)),\n    getCenterOfMass: (shape) => v3(k.getCenterOfMass(asShape(shape))),\n    getSurfaceArea: (shape) => k.getSurfaceArea(asShape(shape)),\n    getLength: (shape) => k.getLength(asShape(shape)),\n\n    // ── validation & repair ──\n    isValid: (shape) => k.isValid(asShape(shape)),\n    unifySameDomain: (shape) => asHandle(k.unifySameDomain(asShape(shape))),\n    healSolid: (shape, tolerance) => asHandle(k.healSolid(asShape(shape), tolerance)),\n    fixShape: (shape) => asHandle(k.fixShape(asShape(shape))),\n    fixFaceOrientations: (shape) => asHandle(k.fixFaceOrientations(asShape(shape))),\n    removeDegenerateEdges: (shape, _tolerance) =>\n      // Native takes no tolerance parameter (kernel-fixed tolerance).\n      asHandle(k.removeDegenerateEdges(asShape(shape))),\n\n    // ── IO ──\n    importStep: (data) => asHandle(k.importStep(data)),\n    exportStep: (shape) => k.exportStep(asShape(shape)),\n    importStl: (data) => asHandle(k.importStl(data)),\n    fromBREP: (data) => asHandle(k.fromBREP(data)),\n\n    // ── face evolution (L1 trio only) ──\n    cutWithHistory: (a, b, inputFaceHashes, hashUpperBound) =>\n      toEvolution(k.cutWithHistory(asShape(a), asShape(b), inputFaceHashes, hashUpperBound)),\n    fuseWithHistory: (a, b, inputFaceHashes, hashUpperBound) =>\n      toEvolution(k.fuseWithHistory(asShape(a), asShape(b), inputFaceHashes, hashUpperBound)),\n    intersectWithHistory: (a, b, inputFaceHashes, hashUpperBound) =>\n      toEvolution(k.intersectWithHistory(asShape(a), asShape(b), inputFaceHashes, hashUpperBound)),\n  }\n\n  return primitives\n}\n\n/** The occt primitives type (BrepEngineApi implementation). */\nexport type OcctPrimitives = Awaited<ReturnType<typeof createOcctPrimitives>>\n\n// §7.8 compile-time guard: the explicit literal must satisfy the L1 contract\n// member-by-member (this now has real verification power — no `as` escape).\n/** Compile-time assertion that OcctPrimitives satisfies BrepEngineApi. */\nexport type _AssertOcctApi = AssertSatisfiesBrepEngineApi<OcctPrimitives>"]}

package/dist/occt-kernel/occtKernel.d.ts

@@ -6,8 +6,6 @@
  * 利用 wireframe() 获取边折线数据，利用 edgeToFaceMap() 获取边→面关联。
  */
 import type { OcctKernel, ShapeHandle, Mesh, EdgeData, SurfaceKind, CurveKind, BoundingBox, Vec3, XCAFDocument, LabelInfo, LabelTag } from 'occt-wasm';
-import type { BrepHandle } from '../brep/engine/types.js';
-import type { BrepEngineApi } from '../brep/engine/primitives.js';
 /** A single tessellated mesh produced by the OCCT kernel. */
 export interface WasmTessellatedMesh {
     positions: Float32Array;
@@ -55,15 +53,23 @@ export declare function resolveOcctWasmPath(): string;
  * - Development: direct ESM import, Vite resolves node_modules. The WASM file is loaded from public/wasm/occt-wasm.wasm.
  * - Production: dynamically import the whole module + WASM from a CDN.
  *
- * @returns the initialized BREP engine API
+ * @returns the initialized raw OCCT kernel (native L2 face — NOT BrepEngineApi;
+ *          the L1 contract face is built separately by createOcctPrimitives()
+ *          in brep/engine/adapters/occt.ts as an explicit object literal).
  */
-export declare function initOcctWasm(): Promise<BrepEngineApi>;
+export declare function initOcctWasm(): Promise<OcctKernel>;
 /**
  * Get the initialized kernel instance (initOcctWasm must be called first).
  *
  * @returns the initialized OCCT kernel
  */
 export declare function getKernel(): OcctKernel;
+/**
+ * Native-face alias for getKernel() (plan D3 ②): symmetric with
+ * getBrepkitKernel() on the brepkit side. Platform-specific code uses this
+ * name; the original getKernel() stays for existing host code.
+ */
+export declare const getOcctKernel: typeof getKernel;
 /** Release the kernel instance (call when the app unloads). */
 export declare function disposeOcctWasm(): void;
 /** Options controlling mesh deflection during tessellation. */
@@ -83,7 +89,9 @@ export interface MeshDeflectionOptions {
  * @param options - the requested deflection options
  * @returns the effective linear and angular deflection values
  */
-export declare function computeEffectiveDeflection(kernel: BrepEngineApi, shape: BrepHandle, options?: MeshDeflectionOptions): {
+export declare function computeEffectiveDeflection<S>(kernel: {
+    getBoundingBox(shape: S, useTriangulation?: boolean): BoundingBox;
+}, shape: S, options?: MeshDeflectionOptions): {
     linearDeflection: number;
     angularDeflection: number;
 };
@@ -138,7 +146,7 @@ export declare function importAssemblyFromStep(stepData: ArrayBuffer | Uint8Arra
  * @param kernel - the OCCT kernel used to release handles
  * @param nodes - the assembly tree nodes to release
  */
-export declare function releaseAssemblyTree(kernel: BrepEngineApi, nodes: AssemblyPartNode[]): void;
+export declare function releaseAssemblyTree(kernel: OcctKernel, nodes: AssemblyPartNode[]): void;
 /** Collect all leaf (non-assembly) nodes from an assembly tree.
  *
  * @param nodes - the assembly tree nodes to traverse

package/dist/occt-kernel/occtKernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"occtKernel.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/occtKernel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"occtKernel.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/occtKernel.ts"],"names":[],"mappings":"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"}