@faicad/faijs 0.30.9 → 0.32.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@faicad/faijs",
-  "version": "0.30.9",
+  "version": "0.32.2",
   "type": "module",
   "license": "Apache-2.0",
   "repository": {
@@ -78,17 +78,69 @@
       "types": "./dist/module-resolver/index.d.ts",
       "default": "./dist/module-resolver/index.js"
     },
-    "./module-resolver/*": {
-      "types": "./dist/module-resolver/*.d.ts",
-      "default": "./dist/module-resolver/*.js"
-    },
     "./mesh": {
       "types": "./dist/mesh/index.d.ts",
       "default": "./dist/mesh/index.js"
     },
-    "./mesh/*": {
-      "types": "./dist/mesh/*.d.ts",
-      "default": "./dist/mesh/*.js"
+    "./mesh/boolean": {
+      "types": "./dist/mesh/boolean.d.ts",
+      "default": "./dist/mesh/boolean.js"
+    },
+    "./mesh/decoration-provider": {
+      "types": "./dist/mesh/decoration-provider.d.ts",
+      "default": "./dist/mesh/decoration-provider.js"
+    },
+    "./mesh/engrave": {
+      "types": "./dist/mesh/engrave.d.ts",
+      "default": "./dist/mesh/engrave.js"
+    },
+    "./mesh/stl-loader": {
+      "types": "./dist/mesh/stl-loader.d.ts",
+      "default": "./dist/mesh/stl-loader.js"
+    },
+    "./mesh/import-model": {
+      "types": "./dist/mesh/import-model.d.ts",
+      "default": "./dist/mesh/import-model.js"
+    },
+    "./mesh/io": {
+      "types": "./dist/mesh/io.d.ts",
+      "default": "./dist/mesh/io.js"
+    },
+    "./mesh/manifold-loader": {
+      "types": "./dist/mesh/manifold-loader.d.ts",
+      "default": "./dist/mesh/manifold-loader.js"
+    },
+    "./mesh/primitives": {
+      "types": "./dist/mesh/primitives.d.ts",
+      "default": "./dist/mesh/primitives.js"
+    },
+    "./mesh/query": {
+      "types": "./dist/mesh/query.d.ts",
+      "default": "./dist/mesh/query.js"
+    },
+    "./mesh/rigid-transform": {
+      "types": "./dist/mesh/rigid-transform.d.ts",
+      "default": "./dist/mesh/rigid-transform.js"
+    },
+    "./mesh/stl-unit": {
+      "types": "./dist/mesh/stl-unit.d.ts",
+      "default": "./dist/mesh/stl-unit.js"
+    },
+    "./mesh/threemf-bambu": {
+      "types": "./dist/mesh/threemf-bambu.d.ts",
+      "default": "./dist/mesh/threemf-bambu.js"
+    },
+    "./mesh/threemf-view": {
+      "types": "./dist/mesh/threemf-view.d.ts",
+      "default": "./dist/mesh/threemf-view.js"
+    },
+    "./mesh/transform": {
+      "types": "./dist/mesh/transform.d.ts",
+      "default": "./dist/mesh/transform.js"
+    },
+    "./mesh/types": {
+      "types": "./dist/mesh/types.d.ts",
+      "default": "./dist/mesh/types.js"
     },
     "./io": {
       "types": "./dist/io/index.d.ts",
@@ -98,49 +150,237 @@
       "types": "./dist/io/fai-zip/index.d.ts",
       "default": "./dist/io/fai-zip/index.js"
     },
-    "./io/*": {
-      "types": "./dist/io/*.d.ts",
-      "default": "./dist/io/*.js"
+    "./io/bytes-node": {
+      "types": "./dist/io/bytes-node.d.ts",
+      "default": "./dist/io/bytes-node.js"
+    },
+    "./io/zip": {
+      "types": "./dist/io/zip.d.ts",
+      "default": "./dist/io/zip.js"
+    },
+    "./brep/brep-chain": {
+      "types": "./dist/brep/brep-chain.d.ts",
+      "default": "./dist/brep/brep-chain.js"
+    },
+    "./brep/brep-ops": {
+      "types": "./dist/brep/brep-ops.d.ts",
+      "default": "./dist/brep/brep-ops.js"
+    },
+    "./brep/brep-utils": {
+      "types": "./dist/brep/brep-utils.d.ts",
+      "default": "./dist/brep/brep-utils.js"
+    },
+    "./brep/engine/adapters/brepkit": {
+      "types": "./dist/brep/engine/adapters/brepkit.d.ts",
+      "default": "./dist/brep/engine/adapters/brepkit.js"
+    },
+    "./brep/engine/adapters/occt": {
+      "types": "./dist/brep/engine/adapters/occt.d.ts",
+      "default": "./dist/brep/engine/adapters/occt.js"
+    },
+    "./brep/engine/primitives": {
+      "types": "./dist/brep/engine/primitives.d.ts",
+      "default": "./dist/brep/engine/primitives.js"
+    },
+    "./brep/engine/registry": {
+      "types": "./dist/brep/engine/registry.d.ts",
+      "default": "./dist/brep/engine/registry.js"
+    },
+    "./brep/engine/types": {
+      "types": "./dist/brep/engine/types.d.ts",
+      "default": "./dist/brep/engine/types.js"
+    },
+    "./brep/export/export-model": {
+      "types": "./dist/brep/export/export-model.d.ts",
+      "default": "./dist/brep/export/export-model.js"
+    },
+    "./brep/export/step": {
+      "types": "./dist/brep/export/step.d.ts",
+      "default": "./dist/brep/export/step.js"
+    },
+    "./brep/export/stl": {
+      "types": "./dist/brep/export/stl.d.ts",
+      "default": "./dist/brep/export/stl.js"
+    },
+    "./brep/face-evolution": {
+      "types": "./dist/brep/face-evolution.d.ts",
+      "default": "./dist/brep/face-evolution.js"
+    },
+    "./brep/handle-bridge": {
+      "types": "./dist/brep/handle-bridge.d.ts",
+      "default": "./dist/brep/handle-bridge.js"
+    },
+    "./brep/mesh-solid": {
+      "types": "./dist/brep/mesh-solid.d.ts",
+      "default": "./dist/brep/mesh-solid.js"
     },
-    "./brep/*": {
-      "types": "./dist/brep/*.d.ts",
-      "default": "./dist/brep/*.js"
+    "./brep/primitives-brep": {
+      "types": "./dist/brep/primitives-brep.d.ts",
+      "default": "./dist/brep/primitives-brep.js"
     },
-    "./brepkit-kernel/*": {
-      "types": "./dist/brepkit-kernel/*.d.ts",
-      "default": "./dist/brepkit-kernel/*.js"
+    "./brep/svg/svg-to-solid": {
+      "types": "./dist/brep/svg/svg-to-solid.d.ts",
+      "default": "./dist/brep/svg/svg-to-solid.js"
     },
-    "./primitives/*": {
-      "types": "./dist/primitives/*.d.ts",
-      "default": "./dist/primitives/*.js"
+    "./brep/text/fontRegistry": {
+      "types": "./dist/brep/text/fontRegistry.d.ts",
+      "default": "./dist/brep/text/fontRegistry.js"
     },
-    "./cad-runtime/*": {
-      "types": "./dist/cad-runtime/*.d.ts",
-      "default": "./dist/cad-runtime/*.js"
+    "./brep/text/text-to-solid": {
+      "types": "./dist/brep/text/text-to-solid.d.ts",
+      "default": "./dist/brep/text/text-to-solid.js"
     },
-    "./occt-kernel/*": {
-      "types": "./dist/occt-kernel/*.d.ts",
-      "default": "./dist/occt-kernel/*.js"
+    "./brepkit-kernel/brepkitWasm": {
+      "types": "./dist/brepkit-kernel/brepkitWasm.d.ts",
+      "default": "./dist/brepkit-kernel/brepkitWasm.js"
+    },
+    "./primitives/brep-primitives": {
+      "types": "./dist/primitives/brep-primitives.d.ts",
+      "default": "./dist/primitives/brep-primitives.js"
+    },
+    "./primitives/mesh-primitives": {
+      "types": "./dist/primitives/mesh-primitives.d.ts",
+      "default": "./dist/primitives/mesh-primitives.js"
+    },
+    "./primitives/parse-svg-size": {
+      "types": "./dist/primitives/parse-svg-size.d.ts",
+      "default": "./dist/primitives/parse-svg-size.js"
+    },
+    "./primitives/screw/screw": {
+      "types": "./dist/primitives/screw/screw.d.ts",
+      "default": "./dist/primitives/screw/screw.js"
+    },
+    "./primitives/screw/screw-db": {
+      "types": "./dist/primitives/screw/screw-db.d.ts",
+      "default": "./dist/primitives/screw/screw-db.js"
+    },
+    "./primitives/text/cjk-font": {
+      "types": "./dist/primitives/text/cjk-font.d.ts",
+      "default": "./dist/primitives/text/cjk-font.js"
+    },
+    "./primitives/types": {
+      "types": "./dist/primitives/types.d.ts",
+      "default": "./dist/primitives/types.js"
+    },
+    "./cad-runtime/backend-dispatch": {
+      "types": "./dist/cad-runtime/backend-dispatch.d.ts",
+      "default": "./dist/cad-runtime/backend-dispatch.js"
+    },
+    "./cad-runtime/browser-lib-loader": {
+      "types": "./dist/cad-runtime/browser-lib-loader.d.ts",
+      "default": "./dist/cad-runtime/browser-lib-loader.js"
+    },
+    "./cad-runtime/content-key": {
+      "types": "./dist/cad-runtime/content-key.d.ts",
+      "default": "./dist/cad-runtime/content-key.js"
+    },
+    "./cad-runtime/direct-executor": {
+      "types": "./dist/cad-runtime/direct-executor.d.ts",
+      "default": "./dist/cad-runtime/direct-executor.js"
+    },
+    "./cad-runtime/live-shapes": {
+      "types": "./dist/cad-runtime/live-shapes.d.ts",
+      "default": "./dist/cad-runtime/live-shapes.js"
+    },
+    "./cad-runtime/ports": {
+      "types": "./dist/cad-runtime/ports.d.ts",
+      "default": "./dist/cad-runtime/ports.js"
+    },
+    "./cad-runtime/preview-exec": {
+      "types": "./dist/cad-runtime/preview-exec.d.ts",
+      "default": "./dist/cad-runtime/preview-exec.js"
+    },
+    "./cad-runtime/runtime": {
+      "types": "./dist/cad-runtime/runtime.d.ts",
+      "default": "./dist/cad-runtime/runtime.js"
+    },
+    "./occt-kernel/highLevelApi": {
+      "types": "./dist/occt-kernel/highLevelApi.d.ts",
+      "default": "./dist/occt-kernel/highLevelApi.js"
+    },
+    "./occt-kernel/meshReconstruct": {
+      "types": "./dist/occt-kernel/meshReconstruct.d.ts",
+      "default": "./dist/occt-kernel/meshReconstruct.js"
+    },
+    "./occt-kernel/occtKernel": {
+      "types": "./dist/occt-kernel/occtKernel.d.ts",
+      "default": "./dist/occt-kernel/occtKernel.js"
+    },
+    "./occt-kernel/topologyExt": {
+      "types": "./dist/occt-kernel/topologyExt.d.ts",
+      "default": "./dist/occt-kernel/topologyExt.js"
     },
     "./topology/naming": {
       "types": "./dist/topology/naming/index.d.ts",
       "default": "./dist/topology/naming/index.js"
     },
-    "./topology/*": {
-      "types": "./dist/topology/*.d.ts",
-      "default": "./dist/topology/*.js"
+    "./topology/naming/lineage": {
+      "types": "./dist/topology/naming/lineage.d.ts",
+      "default": "./dist/topology/naming/lineage.js"
+    },
+    "./topology/naming/resolve-face": {
+      "types": "./dist/topology/naming/resolve-face.d.ts",
+      "default": "./dist/topology/naming/resolve-face.js"
+    },
+    "./topology/naming/roles": {
+      "types": "./dist/topology/naming/roles.d.ts",
+      "default": "./dist/topology/naming/roles.js"
+    },
+    "./topology/naming/types": {
+      "types": "./dist/topology/naming/types.d.ts",
+      "default": "./dist/topology/naming/types.js"
+    },
+    "./topology/build-face-ids": {
+      "types": "./dist/topology/build-face-ids.d.ts",
+      "default": "./dist/topology/build-face-ids.js"
+    },
+    "./topology/build-selector-runtime": {
+      "types": "./dist/topology/build-selector-runtime.d.ts",
+      "default": "./dist/topology/build-selector-runtime.js"
+    },
+    "./topology/types": {
+      "types": "./dist/topology/types.d.ts",
+      "default": "./dist/topology/types.js"
+    },
+    "./boolean/csg-backend": {
+      "types": "./dist/boolean/csg-backend.d.ts",
+      "default": "./dist/boolean/csg-backend.js"
+    },
+    "./boolean/csg-core": {
+      "types": "./dist/boolean/csg-core.d.ts",
+      "default": "./dist/boolean/csg-core.js"
+    },
+    "./boolean/cross-section": {
+      "types": "./dist/boolean/cross-section.d.ts",
+      "default": "./dist/boolean/cross-section.js"
+    },
+    "./boolean/deriveNormals": {
+      "types": "./dist/boolean/deriveNormals.d.ts",
+      "default": "./dist/boolean/deriveNormals.js"
+    },
+    "./boolean/extrude-helpers": {
+      "types": "./dist/boolean/extrude-helpers.d.ts",
+      "default": "./dist/boolean/extrude-helpers.js"
+    },
+    "./boolean/geo-convert": {
+      "types": "./dist/boolean/geo-convert.d.ts",
+      "default": "./dist/boolean/geo-convert.js"
+    },
+    "./boolean/joinery-shapes": {
+      "types": "./dist/boolean/joinery-shapes.d.ts",
+      "default": "./dist/boolean/joinery-shapes.js"
     },
-    "./boolean/*": {
-      "types": "./dist/boolean/*.d.ts",
-      "default": "./dist/boolean/*.js"
+    "./boolean/manifold-preview": {
+      "types": "./dist/boolean/manifold-preview.d.ts",
+      "default": "./dist/boolean/manifold-preview.js"
     },
     "./geometry2d": {
       "types": "./dist/geometry2d/index.d.ts",
       "default": "./dist/geometry2d/index.js"
     },
-    "./geometry2d/*": {
-      "types": "./dist/geometry2d/*.d.ts",
-      "default": "./dist/geometry2d/*.js"
+    "./geometry2d/bridge/plane": {
+      "types": "./dist/geometry2d/bridge/plane.d.ts",
+      "default": "./dist/geometry2d/bridge/plane.js"
     },
     "./env-agnostic": {
       "types": "./dist/env-agnostic.d.ts",
@@ -159,19 +399,18 @@
   "dependencies": {
     "@xmldom/xmldom": "^0.9.8",
     "acorn": "^8.18.0",
+    "earcut": "^3.2.4",
     "fflate": "^0.8.3",
     "manifold-3d": "^3.5.1",
     "opentype.js": "^1.3.4"
   },
   "peerDependencies": {
-    "occt-wasm": "^5.6.0",
-    "three": "^0.162.0 || ^0.184.0"
+    "occt-wasm": "^5.6.0"
   },
   "devDependencies": {
     "@types/three": "^0.184.1",
     "brepkit-wasm": "^3.4.18",
     "sucrase": "^3.35.1",
-    "three": "^0.184.0",
     "three-162": "npm:three@^0.162.0",
     "typescript": "*",
     "vitest": "*"

package/dist/api/brep-mirror/booleanFns.d.ts

@@ -1,40 +0,0 @@
-/**
- * Self-hosted compat-op implementations — boolean / section
- * (core-decouple Phase 3, §5.4).
- *
- * @platform occt
- *
- * Brep-shaped implementation for `section`. Semantics mirror brepjs
- * `topology/booleanFns.ts` `section` (NULL_SHAPE_INPUT guard, plane resolution
- * from PlaneInput, kernel section via a planar tool, compound result) using the
- * L1 `sectionByPlane` (occt-wasm `BRepAlgoAPI_Section` + edge/wire downcast).
- */
-import type { BrepHandle } from '../../brep/engine/types.js';
-import { type Result } from '../../result/result.js';
-/**
- * Section a shape with a plane (brepjs `section(shape, plane, options?)`).
- *
- * The plane is resolved from `PlaneInput` (named plane or explicit Plane); the
- * L1 `sectionByPlane` builds the planar tool, runs `BRepAlgoAPI_Section`, and
- * downcasts the result compound to edge/wire handles, which are re-combined
- * into a compound to match the brepjs product shape. `options` (approximation
- * / planeSize) is accepted for signature compatibility; the occt native
- * section uses its default approximation.
- *
- * @param args - Resolved arguments (shape, plane).
- * @returns The section result compound as a `BrepHandle`.
- */
-export declare function sectionBrep(...args: unknown[]): Result<BrepHandle>;
-/**
- * Fuse (union) two shapes into one.
- * @param args - Resolved arguments (a, b).
- * @returns The fused shape as a `BrepHandle`.
- */
-export declare function fuseBrep(...args: unknown[]): Result<BrepHandle>;
-/**
- * Split a shape with one or more tool shapes.
- * @param args - Resolved arguments (shape, tools).
- * @returns The split result as a `BrepHandle`.
- */
-export declare function splitBrep(...args: unknown[]): Result<BrepHandle>;
-//# sourceMappingURL=booleanFns.d.ts.map

package/dist/api/brep-mirror/booleanFns.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"booleanFns.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/booleanFns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGzD,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAU1D;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAiClE;AASD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAW/D;AAQD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAoBhE"}

package/dist/api/brep-mirror/booleanFns.js

@@ -1,104 +0,0 @@
-/**
- * Self-hosted compat-op implementations — boolean / section
- * (core-decouple Phase 3, §5.4).
- *
- * @platform occt
- *
- * Brep-shaped implementation for `section`. Semantics mirror brepjs
- * `topology/booleanFns.ts` `section` (NULL_SHAPE_INPUT guard, plane resolution
- * from PlaneInput, kernel section via a planar tool, compound result) using the
- * L1 `sectionByPlane` (occt-wasm `BRepAlgoAPI_Section` + edge/wire downcast).
- */
-import { getBrepApi } from '../../brep/handle-bridge.js';
-import { getOcctKernel } from '../../occt-kernel/occtKernel.js';
-import { ok, err } from '../../result/result.js';
-import { kernelError } from '../../result/errors.js';
-import { resolveArgs } from '../internal/dual-form-args.js';
-import { resolvePlane } from '../brepjs-compat/planeOps.js';
-import { brepHandleOf } from './brepHelpers.js';
-const SECTION_PARAMS = { name: 'section', params: ['shape', 'plane'], formClass: 'A' };
-/**
- * Section a shape with a plane (brepjs `section(shape, plane, options?)`).
- *
- * The plane is resolved from `PlaneInput` (named plane or explicit Plane); the
- * L1 `sectionByPlane` builds the planar tool, runs `BRepAlgoAPI_Section`, and
- * downcasts the result compound to edge/wire handles, which are re-combined
- * into a compound to match the brepjs product shape. `options` (approximation
- * / planeSize) is accepted for signature compatibility; the occt native
- * section uses its default approximation.
- *
- * @param args - Resolved arguments (shape, plane).
- * @returns The section result compound as a `BrepHandle`.
- */
-export function sectionBrep(...args) {
-    const [shape, plane] = resolveArgs(args, SECTION_PARAMS);
-    const kernel = getBrepApi();
-    const h = brepHandleOf(shape);
-    // NOTE: 2026-09-26 brepkit 降级——移除 getOcctKernel().IsNull 平台耦合。
-    // 空/坏句柄由下游 sectionByPlane 内核抛错并被下方 try/catch 捕获为 SECTION_FAILED
-    // （occt 的 sectionByPlane 对空结果本就返回 []，行为等价；brepkit 对坏句柄抛
-    // "invalid solid handle"，诚实报错而非崩溃）。
-    const resolved = resolvePlane(plane);
-    if (!resolved.ok)
-        return resolved;
-    const p = resolved.value;
-    try {
-        const parts = kernel.sectionByPlane(h, { x: p.origin[0], y: p.origin[1], z: p.origin[2] }, { x: p.zDir[0], y: p.zDir[1], z: p.zDir[2] });
-        // 语义差异（如实登记）：occt sectionByPlane 返回 edge/wire 句柄组（1D 剖面线）；
-        // brepkit sectionByPlane 返回 face 句柄组（2D 剖面面）。两侧都包成 compound 产物，
-        // 下游 meshShape/wireframe 已按已知集合分发（brepkit makeCompound 对非 solid 子句柄走
-        // 虚拟 compound 路径）。
-        return ok(kernel.makeCompound(parts));
-    }
-    catch (e) {
-        return err(kernelError('SECTION_FAILED', `Section with plane failed: ${e instanceof Error ? e.message : String(e)}`, e, { operation: 'section' }, 'The cutting plane may not intersect the shape. Verify plane position relative to shape bounds.'));
-    }
-}
-// ---------------------------------------------------------------------------
-// fuse — union two shapes (brepjs topology/booleanFns.ts#fuse)
-// ---------------------------------------------------------------------------
-const FUSE_PARAMS = { name: 'fuse', params: ['a', 'b', 'options'], formClass: 'A' };
-/**
- * Fuse (union) two shapes into one.
- * @param args - Resolved arguments (a, b).
- * @returns The fused shape as a `BrepHandle`.
- */
-export function fuseBrep(...args) {
-    const [a, b] = resolveArgs(args, FUSE_PARAMS);
-    const kernel = getBrepApi();
-    const ha = brepHandleOf(a);
-    const hb = brepHandleOf(b);
-    try {
-        return ok(kernel.fuse(ha, hb));
-    }
-    catch (e) {
-        const raw = e instanceof Error ? e.message : String(e);
-        return err(kernelError('FUSE_FAILED', `fuse failed: ${raw}`, e));
-    }
-}
-// ---------------------------------------------------------------------------
-// split — split a shape with tool(s) (brepjs topology/api.ts#split → booleanFns.split)
-// ---------------------------------------------------------------------------
-const SPLIT_PARAMS = { name: 'split', params: ['shape', 'tools'], formClass: 'A' };
-/**
- * Split a shape with one or more tool shapes.
- * @param args - Resolved arguments (shape, tools).
- * @returns The split result as a `BrepHandle`.
- */
-export function splitBrep(...args) {
-    const [shape, toolsRaw] = resolveArgs(args, SPLIT_PARAMS);
-    const h = brepHandleOf(shape);
-    const tools = (toolsRaw ?? []);
-    if (tools.length === 0)
-        return ok(h);
-    const toolHandles = tools.map((t) => brepHandleOf(t));
-    try {
-        const result = getOcctKernel().split(h, toolHandles);
-        return ok(result);
-    }
-    catch (e) {
-        const raw = e instanceof Error ? e.message : String(e);
-        return err(kernelError('SPLIT_FAILED', `Split operation failed on ${tools.length} tool(s): ${raw}`, e, { operation: 'split', toolCount: tools.length }));
-    }
-}
-//# sourceMappingURL=booleanFns.js.map

package/dist/api/brep-mirror/booleanFns.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"booleanFns.js","sourceRoot":"","sources":["../../../src/api/brep-mirror/booleanFns.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Self-hosted compat-op implementations — boolean / section\n * (core-decouple Phase 3, §5.4).\n *\n * @platform occt\n *\n * Brep-shaped implementation for `section`. Semantics mirror brepjs\n * `topology/booleanFns.ts` `section` (NULL_SHAPE_INPUT guard, plane resolution\n * from PlaneInput, kernel section via a planar tool, compound result) using the\n * L1 `sectionByPlane` (occt-wasm `BRepAlgoAPI_Section` + edge/wire downcast).\n */\n\nimport type { BrepHandle } from '../../brep/engine/types'\nimport { getBrepApi } from '../../brep/handle-bridge'\nimport { getOcctKernel } from '../../occt-kernel/occtKernel'\nimport { ok, err, type Result } from '../../result/result'\nimport { kernelError } from '../../result/errors'\nimport type { FormClass } from '../internal/dual-form-args'\nimport { resolveArgs } from '../internal/dual-form-args'\nimport type { PlaneInput } from '../brepjs-compat/planeTypes'\nimport { resolvePlane } from '../brepjs-compat/planeOps'\nimport { brepHandleOf } from './brepHelpers'\n\nconst SECTION_PARAMS = { name: 'section', params: ['shape', 'plane'], formClass: 'A' as FormClass }\n\n/**\n * Section a shape with a plane (brepjs `section(shape, plane, options?)`).\n *\n * The plane is resolved from `PlaneInput` (named plane or explicit Plane); the\n * L1 `sectionByPlane` builds the planar tool, runs `BRepAlgoAPI_Section`, and\n * downcasts the result compound to edge/wire handles, which are re-combined\n * into a compound to match the brepjs product shape. `options` (approximation\n * / planeSize) is accepted for signature compatibility; the occt native\n * section uses its default approximation.\n *\n * @param args - Resolved arguments (shape, plane).\n * @returns The section result compound as a `BrepHandle`.\n */\nexport function sectionBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, plane] = resolveArgs(args, SECTION_PARAMS)\n  const kernel = getBrepApi()\n  const h = brepHandleOf(shape)\n  // NOTE: 2026-09-26 brepkit 降级——移除 getOcctKernel().IsNull 平台耦合。\n  // 空/坏句柄由下游 sectionByPlane 内核抛错并被下方 try/catch 捕获为 SECTION_FAILED\n  // （occt 的 sectionByPlane 对空结果本就返回 []，行为等价；brepkit 对坏句柄抛\n  // \"invalid solid handle\"，诚实报错而非崩溃）。\n  const resolved = resolvePlane(plane as PlaneInput)\n  if (!resolved.ok) return resolved\n  const p = resolved.value\n  try {\n    const parts = kernel.sectionByPlane(\n      h,\n      { x: p.origin[0], y: p.origin[1], z: p.origin[2] },\n      { x: p.zDir[0], y: p.zDir[1], z: p.zDir[2] },\n    )\n    // 语义差异（如实登记）：occt sectionByPlane 返回 edge/wire 句柄组（1D 剖面线）；\n    // brepkit sectionByPlane 返回 face 句柄组（2D 剖面面）。两侧都包成 compound 产物，\n    // 下游 meshShape/wireframe 已按已知集合分发（brepkit makeCompound 对非 solid 子句柄走\n    // 虚拟 compound 路径）。\n    return ok(kernel.makeCompound(parts))\n  } catch (e) {\n    return err(\n      kernelError(\n        'SECTION_FAILED',\n        `Section with plane failed: ${e instanceof Error ? e.message : String(e)}`,\n        e,\n        { operation: 'section' },\n        'The cutting plane may not intersect the shape. Verify plane position relative to shape bounds.',\n      ),\n    )\n  }\n}\n\n\n// ---------------------------------------------------------------------------\n// fuse — union two shapes (brepjs topology/booleanFns.ts#fuse)\n// ---------------------------------------------------------------------------\n\nconst FUSE_PARAMS = { name: 'fuse', params: ['a', 'b', 'options'], formClass: 'A' as FormClass }\n\n/**\n * Fuse (union) two shapes into one.\n * @param args - Resolved arguments (a, b).\n * @returns The fused shape as a `BrepHandle`.\n */\nexport function fuseBrep(...args: unknown[]): Result<BrepHandle> {\n  const [a, b] = resolveArgs(args, FUSE_PARAMS)\n  const kernel = getBrepApi()\n  const ha = brepHandleOf(a)\n  const hb = brepHandleOf(b)\n  try {\n    return ok(kernel.fuse(ha, hb))\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(kernelError('FUSE_FAILED', `fuse failed: ${raw}`, e))\n  }\n}\n\n// ---------------------------------------------------------------------------\n// split — split a shape with tool(s) (brepjs topology/api.ts#split → booleanFns.split)\n// ---------------------------------------------------------------------------\n\nconst SPLIT_PARAMS = { name: 'split', params: ['shape', 'tools'], formClass: 'A' as FormClass }\n\n/**\n * Split a shape with one or more tool shapes.\n * @param args - Resolved arguments (shape, tools).\n * @returns The split result as a `BrepHandle`.\n */\nexport function splitBrep(...args: unknown[]): Result<BrepHandle> {\n  const [shape, toolsRaw] = resolveArgs(args, SPLIT_PARAMS)\n  const h = brepHandleOf(shape)\n  const tools = (toolsRaw ?? []) as unknown[]\n  if (tools.length === 0) return ok(h)\n  const toolHandles = tools.map((t) => brepHandleOf(t))\n  try {\n    const result = getOcctKernel().split(h as never, toolHandles as never)\n    return ok(result as unknown as BrepHandle)\n  } catch (e) {\n    const raw = e instanceof Error ? e.message : String(e)\n    return err(\n      kernelError(\n        'SPLIT_FAILED',\n        `Split operation failed on ${tools.length} tool(s): ${raw}`,\n        e,\n        { operation: 'split', toolCount: tools.length },\n      ),\n    )\n  }\n}\n"]}

package/dist/api/brep-mirror/brepHelpers.d.ts

@@ -1,55 +0,0 @@
-/**
- * brep-mirror helpers — shared utilities for self-hosted compat-op implementations
- * (core-decouple Phase 3, §5.4).
- *
- * @module
- */
-import type { BrepHandle } from '../../brep/engine/types.js';
-/**
- * Extract a core BREP handle from an op argument.
- *
- * Accepts (in order of preference):
- *  - a raw branded number (BrepHandle),
- *  - a brepjs-style kernel handle object `{ id }`,
- *  - a brepjs-style shape wrapper `{ wrapped }`,
- *  - a faijs Shape whose brep slot carries the handle.
- *
- * @param v - the op argument (positional, post D11 normalization).
- * @returns the numeric BREP handle.
- * @throws when no handle can be extracted (E_BREP_INPUT).
- */
-export declare function brepHandleOf(v: unknown): BrepHandle;
-/** Identity 3×4 row-major affine matrix (12 elements). */
-export declare const IDENTITY_3X4: readonly number[];
-/**
- * Compose two 3×4 row-major affine matrices: `a` applied first, then `b`
- * (column-vector convention: p' = b·(a·p)).
- *
- * @param a - first matrix (12 elements).
- * @param b - second matrix (12 elements).
- * @returns the composed 12-element matrix.
- */
-export declare function composeAffine(a: readonly number[], b: readonly number[]): number[];
-/**
- * 3×4 translation matrix for a vector.
- * @param v - Translation vector.
- * @returns The 3×4 translation matrix.
- */
-export declare function translationMatrix(v: readonly [number, number, number]): number[];
-/**
- * 3×4 rotation matrix rotating `angleDeg` degrees around the axis (unit-ized)
- * passing through `center`. Rodrigues formula, column-vector convention.
- *
- * @param axis - Rotation axis (unit-ized internally).
- * @param center - Point the rotation passes through.
- * @param angleDeg - Rotation angle in degrees.
- * @returns The 3×4 rotation matrix.
- */
-export declare function rotationMatrix(axis: readonly [number, number, number], center: readonly [number, number, number], angleDeg: number): number[];
-/**
- * 3×4 matrix rotating the +Z axis onto `axis` (unit-ized), origin-centered.
- * @param axis - Target axis direction.
- * @returns The 3×4 rotation matrix.
- */
-export declare function rotationZTo(axis: readonly [number, number, number]): number[];
-//# sourceMappingURL=brepHelpers.d.ts.map

package/dist/api/brep-mirror/brepHelpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"brepHelpers.d.ts","sourceRoot":"","sources":["../../../src/api/brep-mirror/brepHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,UAAU,CAUnD;AAED,0DAA0D;AAC1D,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAyC,CAAA;AAEnF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAEhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACvC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACzC,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CA4BV;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAsB7E"}