@faicad/faijs 0.30.9 → 0.32.2

package/dist/boolean/geo-convert.js

@@ -1,94 +1,38 @@
 /**
  * geo-convert — 纯数据转换函数（从 csg.ts 提取）
  *
- * THREE.BufferGeometry ↔ ManifoldMeshData 转换。
+ * { positions, indices } ↔ ManifoldMeshData 转换（焊接 + 法线派生）。
  * 不依赖 Worker / postMessage，可在 Node 和浏览器环境通用。
  */
-import * as THREE from 'three';
+import { weldMesh } from '../mesh/meshdata/weld.js';
 import { deriveNormals } from './deriveNormals.js';
-// ── 焊接重复顶点 ──
-function weldPositions(positions, indices, count) {
-    const mapX = new Map();
-    const weldedPosArr = [];
-    const weldedIdxArr = [];
-    for (let i = 0; i < count; i++) {
-        const vi = indices[i];
-        const x = positions[vi * 3];
-        const y = positions[vi * 3 + 1];
-        const z = positions[vi * 3 + 2];
-        const qx = Math.round(x * 1e6);
-        const qy = Math.round(y * 1e6);
-        const qz = Math.round(z * 1e6);
-        let mapY = mapX.get(qx);
-        if (mapY === undefined) {
-            mapY = new Map();
-            mapX.set(qx, mapY);
-        }
-        let mapZ = mapY.get(qy);
-        if (mapZ === undefined) {
-            mapZ = new Map();
-            mapY.set(qy, mapZ);
-        }
-        let ni = mapZ.get(qz);
-        if (ni === undefined) {
-            ni = weldedPosArr.length / 3;
-            mapZ.set(qz, ni);
-            weldedPosArr.push(x, y, z);
-        }
-        weldedIdxArr.push(ni);
-    }
-    return {
-        positions: new Float32Array(weldedPosArr),
-        indices: new Uint32Array(weldedIdxArr),
-    };
-}
-// ── THREE.BufferGeometry → ManifoldMeshData ──
+// ── { positions, indices } → ManifoldMeshData（焊接重复顶点）──
 /**
- * Convert a THREE.BufferGeometry into ManifoldMeshData, welding duplicate vertices.
- * @param geo - the source THREE.BufferGeometry with a position attribute (and optional index).
+ * Convert raw position+index data into ManifoldMeshData, welding duplicate vertices.
+ * @param data - the source mesh data with positions and indices.
  * @returns the converted mesh data with welded, unique vertices.
  */
-export function geoToManifoldMesh(geo) {
-    const pos = geo.getAttribute('position');
-    const arr = pos.array;
-    const positions = new Float32Array(arr);
-    let triCount;
-    let indices;
-    if (geo.index) {
-        const idx = geo.index;
-        triCount = idx.count;
-        const idxArr = idx.array;
-        indices = idxArr instanceof Uint32Array
-            ? new Uint32Array(idxArr.buffer, idxArr.byteOffset, idx.count)
-            : new Uint16Array(idxArr.buffer, idxArr.byteOffset, idx.count);
-    }
-    else {
-        triCount = pos.count;
-        const arr = new Uint32Array(triCount);
-        for (let i = 0; i < triCount; i++)
-            arr[i] = i;
-        indices = arr;
-    }
-    return weldPositions(positions, indices, triCount);
+export function geoToManifoldMesh(data) {
+    return weldMesh(data.positions, data.indices);
 }
-// ── ManifoldMeshData → THREE.BufferGeometry ──
+// ── ManifoldMeshData → Shape（含法线派生）──
 /**
- * Convert ManifoldMeshData into a THREE.BufferGeometry, optionally computing creased normals.
+ * Convert ManifoldMeshData into a Shape, optionally computing creased normals.
  * @param data - the source mesh data.
  * @param options - optional settings; computeNormals defaults to true and derives creased normals.
- * @returns the resulting THREE.BufferGeometry (empty when there are no positions or indices).
+ * @returns the resulting Shape (empty when there are no positions or indices).
  */
 export function manifoldMeshToGeo(data, options) {
-    let geo = new THREE.BufferGeometry();
     if (data.positions.length === 0 || data.indices.length === 0) {
-        return geo;
+        return { positions: new Float32Array(0), indices: new Uint32Array(0) };
     }
-    geo.setAttribute('position', new THREE.BufferAttribute(data.positions, 3));
-    geo.setIndex(new THREE.BufferAttribute(data.indices, 1));
+    const shape = {
+        positions: new Float32Array(data.positions),
+        indices: new Uint32Array(data.indices),
+    };
     if (options?.computeNormals !== false) {
-        geo = deriveNormals(geo);
+        return deriveNormals(shape);
     }
-    geo.computeBoundingBox();
-    return geo;
+    return shape;
 }
 //# sourceMappingURL=geo-convert.js.map

package/dist/boolean/geo-convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"geo-convert.js","sourceRoot":"","sources":["../../src/boolean/geo-convert.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * geo-convert — 纯数据转换函数（从 csg.ts 提取）\n *\n * THREE.BufferGeometry ↔ ManifoldMeshData 转换。\n * 不依赖 Worker / postMessage，可在 Node 和浏览器环境通用。\n */\n\nimport * as THREE from 'three'\nimport { deriveNormals } from './deriveNormals'\n\n// ── 类型（与 csg.ts 保持一致）──\n\n/** The set of supported boolean operations. */\nexport type BooleanOperation = 'union' | 'subtract' | 'intersect'\n\n/** Interchange mesh representation: interleaved positions with triangle indices. */\nexport interface ManifoldMeshData {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n/** Design parameters for a dovetail groove (depth, tolerances, width, flaps angle). */\nexport interface DovetailGrooveParams {\n  depth: number\n  depthTolerance: number\n  width: number\n  widthTolerance: number\n  flapsAngle: number\n}\n\n/** Design parameters for a dowel split (diameter, tolerances, height). */\nexport interface DowelSplitParams {\n  diameter: number\n  diameterTolerance: number\n  height: number\n  heightTolerance: number\n}\n\n/** Design parameters for a straight-tenon split (side length, tolerances, height). */\nexport interface StraightTenonSplitParams {\n  sideLength: number\n  sideLengthTolerance: number\n  height: number\n  heightTolerance: number\n}\n\n// ── 焊接重复顶点 ──\n\nfunction weldPositions(\n  positions: Float32Array,\n  indices: Uint32Array | Uint16Array,\n  count: number,\n): ManifoldMeshData {\n  const mapX = new Map<number, Map<number, Map<number, number>>>()\n  const weldedPosArr: number[] = []\n  const weldedIdxArr: number[] = []\n\n  for (let i = 0; i < count; i++) {\n    const vi = indices[i]\n    const x = positions[vi * 3]\n    const y = positions[vi * 3 + 1]\n    const z = positions[vi * 3 + 2]\n    const qx = Math.round(x * 1e6)\n    const qy = Math.round(y * 1e6)\n    const qz = Math.round(z * 1e6)\n\n    let mapY = mapX.get(qx)\n    if (mapY === undefined) {\n      mapY = new Map<number, Map<number, number>>()\n      mapX.set(qx, mapY)\n    }\n    let mapZ = mapY.get(qy)\n    if (mapZ === undefined) {\n      mapZ = new Map<number, number>()\n      mapY.set(qy, mapZ)\n    }\n    let ni = mapZ.get(qz)\n    if (ni === undefined) {\n      ni = weldedPosArr.length / 3\n      mapZ.set(qz, ni)\n      weldedPosArr.push(x, y, z)\n    }\n    weldedIdxArr.push(ni)\n  }\n\n  return {\n    positions: new Float32Array(weldedPosArr),\n    indices: new Uint32Array(weldedIdxArr),\n  }\n}\n\n// ── THREE.BufferGeometry → ManifoldMeshData ──\n\n/**\n * Convert a THREE.BufferGeometry into ManifoldMeshData, welding duplicate vertices.\n * @param geo - the source THREE.BufferGeometry with a position attribute (and optional index).\n * @returns the converted mesh data with welded, unique vertices.\n */\nexport function geoToManifoldMesh(geo: THREE.BufferGeometry): ManifoldMeshData {\n  const pos = geo.getAttribute('position') as THREE.BufferAttribute\n  const arr = (pos as unknown as { array: ArrayLike<number> }).array\n  const positions = new Float32Array(arr as Float32Array)\n\n  let triCount: number\n  let indices: Uint32Array | Uint16Array\n  if (geo.index) {\n    const idx = geo.index\n    triCount = idx.count\n    const idxArr = (idx as unknown as { array: Uint32Array | Uint16Array }).array\n    indices = idxArr instanceof Uint32Array\n      ? new Uint32Array(idxArr.buffer, idxArr.byteOffset, idx.count)\n      : new Uint16Array(idxArr.buffer, idxArr.byteOffset, idx.count)\n  } else {\n    triCount = pos.count\n    const arr = new Uint32Array(triCount)\n    for (let i = 0; i < triCount; i++) arr[i] = i\n    indices = arr\n  }\n\n  return weldPositions(positions, indices, triCount)\n}\n\n// ── ManifoldMeshData → THREE.BufferGeometry ──\n\n/**\n * Convert ManifoldMeshData into a THREE.BufferGeometry, optionally computing creased normals.\n * @param data - the source mesh data.\n * @param options - optional settings; computeNormals defaults to true and derives creased normals.\n * @returns the resulting THREE.BufferGeometry (empty when there are no positions or indices).\n */\nexport function manifoldMeshToGeo(\n  data: ManifoldMeshData,\n  options?: { computeNormals?: boolean },\n): THREE.BufferGeometry {\n  let geo = new THREE.BufferGeometry()\n  if (data.positions.length === 0 || data.indices.length === 0) {\n    return geo\n  }\n  geo.setAttribute('position', new THREE.BufferAttribute(data.positions, 3))\n  geo.setIndex(new THREE.BufferAttribute(data.indices, 1))\n  if (options?.computeNormals !== false) {\n    geo = deriveNormals(geo)\n  }\n  geo.computeBoundingBox()\n  return geo\n}\n"]}
+{"version":3,"file":"geo-convert.js","sourceRoot":"","sources":["../../src/boolean/geo-convert.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAuC/C,yDAAyD;AAEzD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAkE;IAElE,OAAO,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;AAC/C,CAAC;AAED,uCAAuC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAsB,EACtB,OAAsC;IAEtC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,SAAS,EAAE,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;IACxE,CAAC;IACD,MAAM,KAAK,GAAU;QACnB,SAAS,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,OAAO,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;KACvC,CAAA;IACD,IAAI,OAAO,EAAE,cAAc,KAAK,KAAK,EAAE,CAAC;QACtC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC","sourcesContent":["/**\n * geo-convert — 纯数据转换函数（从 csg.ts 提取）\n *\n * { positions, indices } ↔ ManifoldMeshData 转换（焊接 + 法线派生）。\n * 不依赖 Worker / postMessage，可在 Node 和浏览器环境通用。\n */\n\nimport { weldMesh } from '../mesh/meshdata/weld'\nimport { deriveNormals } from './deriveNormals'\nimport type { Shape } from '../mesh/types'\n\n// ── 类型（与 csg.ts 保持一致）──\n\n/** The set of supported boolean operations. */\nexport type BooleanOperation = 'union' | 'subtract' | 'intersect'\n\n/** Interchange mesh representation: interleaved positions with triangle indices. */\nexport interface ManifoldMeshData {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n/** Design parameters for a dovetail groove (depth, tolerances, width, flaps angle). */\nexport interface DovetailGrooveParams {\n  depth: number\n  depthTolerance: number\n  width: number\n  widthTolerance: number\n  flapsAngle: number\n}\n\n/** Design parameters for a dowel split (diameter, tolerances, height). */\nexport interface DowelSplitParams {\n  diameter: number\n  diameterTolerance: number\n  height: number\n  heightTolerance: number\n}\n\n/** Design parameters for a straight-tenon split (side length, tolerances, height). */\nexport interface StraightTenonSplitParams {\n  sideLength: number\n  sideLengthTolerance: number\n  height: number\n  heightTolerance: number\n}\n\n// ── { positions, indices } → ManifoldMeshData（焊接重复顶点）──\n\n/**\n * Convert raw position+index data into ManifoldMeshData, welding duplicate vertices.\n * @param data - the source mesh data with positions and indices.\n * @returns the converted mesh data with welded, unique vertices.\n */\nexport function geoToManifoldMesh(\n  data: { positions: ArrayLike<number>; indices: ArrayLike<number> },\n): ManifoldMeshData {\n  return weldMesh(data.positions, data.indices)\n}\n\n// ── ManifoldMeshData → Shape（含法线派生）──\n\n/**\n * Convert ManifoldMeshData into a Shape, optionally computing creased normals.\n * @param data - the source mesh data.\n * @param options - optional settings; computeNormals defaults to true and derives creased normals.\n * @returns the resulting Shape (empty when there are no positions or indices).\n */\nexport function manifoldMeshToGeo(\n  data: ManifoldMeshData,\n  options?: { computeNormals?: boolean },\n): Shape {\n  if (data.positions.length === 0 || data.indices.length === 0) {\n    return { positions: new Float32Array(0), indices: new Uint32Array(0) }\n  }\n  const shape: Shape = {\n    positions: new Float32Array(data.positions),\n    indices: new Uint32Array(data.indices),\n  }\n  if (options?.computeNormals !== false) {\n    return deriveNormals(shape)\n  }\n  return shape\n}\n"]}

package/dist/boolean/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * boolean — CSG/boolean auxiliary modules (public API surface).
+ *
+ * This index.ts aggregates the public exports of boolean/ submodules so that
+ * the umbrella entries (index.ts / browser.ts) can `export * from './boolean.js'`
+ * without hand-listing individual symbols.
+ *
+ * Internal-only symbols (SimpleUnionFind, createWedge, createDowel,
+ * computeCrossSectionWidth, etc.) are NOT re-exported here.
+ */
+export { computeSection, buildExtrudedProfile } from './cross-section.js';
+export { manifoldToMeshData, weldPositionsWorker, dovetailBooleanSplit, dowelOrTenonBooleanSplit, chainBoolean, meshToManifold, } from './csg-core.js';
+export { deriveNormals } from './deriveNormals.js';
+export { buildExtrudeParts, makeWorldPlane } from './extrude-helpers.js';
+export type { ExtrudeParts, ExtrudeOffsetMode } from './extrude-helpers.js';
+export { buildWedgeGeometry, buildDowelGeometry, buildStraightTenonGeometry, } from './joinery-shapes.js';
+export type { JoineryMeshData } from './joinery-shapes.js';
+export { setCsgBackend } from './csg-backend.js';
+export { geoToManifoldMesh, manifoldMeshToGeo } from './geo-convert.js';
+export type { ManifoldMeshData, BooleanOperation, DovetailGrooveParams, DowelSplitParams, StraightTenonSplitParams, } from './geo-convert.js';
+export { previewMeshIntersect } from './manifold-preview.js';
+export type { ManifoldMeshData as PreviewManifoldMeshData } from './manifold-preview.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/boolean/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACrE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAGxE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAG7C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,YAAY,EAAE,gBAAgB,IAAI,uBAAuB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/boolean/index.js

@@ -0,0 +1,27 @@
+/**
+ * boolean — CSG/boolean auxiliary modules (public API surface).
+ *
+ * This index.ts aggregates the public exports of boolean/ submodules so that
+ * the umbrella entries (index.ts / browser.ts) can `export * from './boolean.js'`
+ * without hand-listing individual symbols.
+ *
+ * Internal-only symbols (SimpleUnionFind, createWedge, createDowel,
+ * computeCrossSectionWidth, etc.) are NOT re-exported here.
+ */
+// cross-section
+export { computeSection, buildExtrudedProfile } from './cross-section.js';
+// csg-core
+export { manifoldToMeshData, weldPositionsWorker, dovetailBooleanSplit, dowelOrTenonBooleanSplit, chainBoolean, meshToManifold, } from './csg-core.js';
+// deriveNormals
+export { deriveNormals } from './deriveNormals.js';
+// extrude-helpers
+export { buildExtrudeParts, makeWorldPlane } from './extrude-helpers.js';
+// joinery-shapes
+export { buildWedgeGeometry, buildDowelGeometry, buildStraightTenonGeometry, } from './joinery-shapes.js';
+// csg-backend
+export { setCsgBackend } from './csg-backend.js';
+// geo-convert
+export { geoToManifoldMesh, manifoldMeshToGeo } from './geo-convert.js';
+// manifold-preview (ManifoldMeshData aliased to avoid clash with geo-convert's)
+export { previewMeshIntersect } from './manifold-preview.js';
+//# sourceMappingURL=index.js.map

package/dist/boolean/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gBAAgB;AAChB,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEtE,WAAW;AACX,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,gBAAgB;AAChB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,kBAAkB;AAClB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGrE,iBAAiB;AACjB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAA;AAGzB,cAAc;AACd,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AASpE,gFAAgF;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA","sourcesContent":["/**\n * boolean — CSG/boolean auxiliary modules (public API surface).\n *\n * This index.ts aggregates the public exports of boolean/ submodules so that\n * the umbrella entries (index.ts / browser.ts) can `export * from './boolean'`\n * without hand-listing individual symbols.\n *\n * Internal-only symbols (SimpleUnionFind, createWedge, createDowel,\n * computeCrossSectionWidth, etc.) are NOT re-exported here.\n */\n\n// cross-section\nexport { computeSection, buildExtrudedProfile } from './cross-section'\n\n// csg-core\nexport {\n  manifoldToMeshData,\n  weldPositionsWorker,\n  dovetailBooleanSplit,\n  dowelOrTenonBooleanSplit,\n  chainBoolean,\n  meshToManifold,\n} from './csg-core'\n\n// deriveNormals\nexport { deriveNormals } from './deriveNormals'\n\n// extrude-helpers\nexport { buildExtrudeParts, makeWorldPlane } from './extrude-helpers'\nexport type { ExtrudeParts, ExtrudeOffsetMode } from './extrude-helpers'\n\n// joinery-shapes\nexport {\n  buildWedgeGeometry,\n  buildDowelGeometry,\n  buildStraightTenonGeometry,\n} from './joinery-shapes'\nexport type { JoineryMeshData } from './joinery-shapes'\n\n// csg-backend\nexport { setCsgBackend } from './csg-backend'\n\n// geo-convert\nexport { geoToManifoldMesh, manifoldMeshToGeo } from './geo-convert'\nexport type {\n  ManifoldMeshData,\n  BooleanOperation,\n  DovetailGrooveParams,\n  DowelSplitParams,\n  StraightTenonSplitParams,\n} from './geo-convert'\n\n// manifold-preview (ManifoldMeshData aliased to avoid clash with geo-convert's)\nexport { previewMeshIntersect } from './manifold-preview'\nexport type { ManifoldMeshData as PreviewManifoldMeshData } from './manifold-preview'\n"]}

package/dist/brep/brep-chain.d.ts

@@ -11,7 +11,7 @@
  * 生命周期：由 executeScript / executePart 创建，执行结束后释放所有中间句柄。
  * 终端句柄（如果有）由调用方保留用于导出。
  */
-import type { BrepHandle, BrepMeshResult, BrepCapabilities } from './engine/types.js';
+import type { BrepHandle, BrepMeshResult } from './engine/types.js';
 import type { BrepEngineApi } from './engine/primitives.js';
 import type { PartName } from '../identity.js';
 /**
@@ -43,24 +43,6 @@ export interface BrepChainState {
     solidCache: Map<PartName, BrepHandle>;
     /** BREP 引擎实例（mesh 模式为 null —— 等价于「无 BREP 能力」）。 */
     kernel: BrepEngineApi | null;
-    /**
-     * 当前引擎的能力声明（§7.5；mesh 模式无引擎 → undefined）。
-     * 供能力路由静态判定（§8.4）：缺失的能力 → 依赖它的功能静态降级走 mesh。
-     */
-    capabilities?: BrepCapabilities;
-    /**
-     * 零件在世界空间中的平移偏移（来自 mesh.position / partTransforms）。
-     *
-     * BREP solid 在原始局部坐标系中（STEP 文件原始坐标），而用户交互
-     * 产生的 position（如钻孔 clickPosition）是世界坐标。使用此偏移
-     * 将世界坐标转换为局部坐标，确保 BREP 操作在正确的坐标系中执行。
-     *
-     * 由 executePart 从 useEngineStore.partTransforms[scopedId].position 填充。
-     */
-    partTransform?: {
-        position: [number, number, number];
-        scale?: [number, number, number];
-    };
     /**
      * P5-2: 面演化映射缓存（statementId → FaceEvolution）。
      *

package/dist/brep/brep-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"brep-chain.d.ts","sourceRoot":"","sources":["../../src/brep/brep-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAW3C;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAcT;AAID;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACrC,kDAAkD;IAClD,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAC/B;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;IACxF;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACzD;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACvC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;CAC/C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAQrD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAWlE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAUjE"}
+{"version":3,"file":"brep-chain.d.ts","sourceRoot":"","sources":["../../src/brep/brep-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAW3C;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,OAAO,GAChB,OAAO,CAcT;AAID;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;IACrC,kDAAkD;IAClD,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IAC5B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IACzD;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IACvC;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,GAAG,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAA;CAC/C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAQrD;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAUlE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAUjE"}

package/dist/brep/brep-chain.js

@@ -70,7 +70,6 @@ export async function initBrepChainState() {
     return {
         solidCache: new Map(),
         kernel: engine.primitives,
-        capabilities: engine.capabilities,
         faceEvolutionCache: new Map(),
         roleTableCache: new Map(),
         meshShapeCache: new Map(),

package/dist/brep/brep-chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"brep-chain.js","sourceRoot":"","sources":["../../src/brep/brep-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAGhE,qBAAqB;AAErB;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,IAA6B,EAC7B,QAAiB;IAEjB,sCAAsC;IACtC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3B,kBAAkB;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAA;IAChD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED,sCAAsC;IACtC,MAAM,SAAS,GAAI,IAAI,CAAC,IAA2B,IAAK,IAAI,CAAC,GAA0B,IAAI,EAAE,CAAA;IAC7F,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC3D,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC;AAmED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,MAAM,EAAE,IAAI;QACZ,kBAAkB,EAAE,IAAI,GAAG,EAAE;QAC7B,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,cAAc,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,uBAAuB,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAA;IACpC,OAAO;QACL,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC,UAAU;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,kBAAkB,EAAE,IAAI,GAAG,EAAE;QAC7B,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,cAAc,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACxB,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,CAAA;AAC/B,CAAC","sourcesContent":["/**\n * BREP 链状态管理\n *\n * 在语句重放过程中跟踪 OCCT 精确实体句柄。\n * - solidCache: statementId → ShapeHandle（OCCT 实体句柄）\n *\n * BREP 状态是「逐 part」的：一个 part 是否仍为 BREP，\n * 由 solidCache 里是否有它的句柄唯一决定。\n * 不存在全局 brepActive 标志——兄弟 part 互不污染。\n *\n * 生命周期：由 executeScript / executePart 创建，执行结束后释放所有中间句柄。\n * 终端句柄（如果有）由调用方保留用于导出。\n */\n\nimport type { BrepHandle, BrepMeshResult, BrepCapabilities } from './engine/types'\nimport type { BrepEngineApi } from './engine/primitives'\nimport { getBrepEngine } from './engine/registry'\nimport { ensureOcctDefaultEngine } from './engine/adapters/occt'\nimport type { PartName } from '../identity'\n\n// ─── CAD 格式静态判定 ───\n\n/**\n * CAD formats: files in these formats can be imported by the OCCT kernel as\n * exact solids (STEP/STP via importStep, BREP via fromBREP).\n * IGES is intentionally absent — occt-wasm does not link TKDEIGES.\n */\nconst CAD_FORMATS = new Set(['step', 'brep', 'stp'])\n\n/**\n * 静态判定 load 语句的源文件是否为 CAD 格式。\n *\n * 纯函数，按 args.format / 文件路径扩展名判定，\n * 不调用 OCCT、不 try-catch。\n *\n * @param args load 语句的参数表（key/path/url + format）\n * @param isSource buffer 是否为原始字节（可走 BREP 路径的前提）\n * @returns true 表示是 CAD 源（可走 BREP 路径）\n */\nexport function isCadFormat(\n  args: Record<string, unknown>,\n  isSource: boolean,\n): boolean {\n  // 非 source buffer 是转换后的网格数据 → 非 CAD 源\n  if (!isSource) return false\n\n  // 优先用显式 format 参数\n  const format = args.format as string | undefined\n  if (format) {\n    return CAD_FORMATS.has(format.toLowerCase())\n  }\n\n  // P4-1：按 path/url 的扩展名判定（fileRef 已移除）\n  const pathOrUrl = (args.path as string | undefined) ?? (args.url as string | undefined) ?? ''\n  const ext = pathOrUrl.split('.').pop()?.toLowerCase() ?? ''\n  return CAD_FORMATS.has(ext)\n}\n\n// ─── BREP 链状态 ───\n\n/**\n * BREP 链状态：在语句重放过程中跟踪 OCCT 实体句柄。\n *\n * BREP 状态是「逐 part」的：\n * - solidCache 中存在该 part 的句柄 → 该 part 仍为 BREP\n * - solidCache 中不存在该 part 的句柄 → 该 part 已降级为 mesh\n *\n * 不再有全局 brepActive / breakReason 字段。\n * 一个 part 失去 BREP 状态，当且仅当：\n *   - 它被 knurl/sdf（mesh-only op）产生（不写 solidCache），或\n *   - 它的上游输入中至少有一个没有 BREP 实体。\n * 兄弟 part 之间互不污染。\n */\nexport interface BrepChainState {\n  /** BREP 实体句柄缓存（PartName → BrepHandle）。存在即该 part 仍为 BREP；缺失即已降级为 mesh。 */\n  solidCache: Map<PartName, BrepHandle>\n  /** BREP 引擎实例（mesh 模式为 null —— 等价于「无 BREP 能力」）。 */\n  kernel: BrepEngineApi | null\n  /**\n   * 当前引擎的能力声明（§7.5；mesh 模式无引擎 → undefined）。\n   * 供能力路由静态判定（§8.4）：缺失的能力 → 依赖它的功能静态降级走 mesh。\n   */\n  capabilities?: BrepCapabilities\n  /**\n   * 零件在世界空间中的平移偏移（来自 mesh.position / partTransforms）。\n   *\n   * BREP solid 在原始局部坐标系中（STEP 文件原始坐标），而用户交互\n   * 产生的 position（如钻孔 clickPosition）是世界坐标。使用此偏移\n   * 将世界坐标转换为局部坐标，确保 BREP 操作在正确的坐标系中执行。\n   *\n   * 由 executePart 从 useEngineStore.partTransforms[scopedId].position 填充。\n   */\n  partTransform?: { position: [number, number, number]; scale?: [number, number, number] }\n  /**\n   * P5-2: 面演化映射缓存（statementId → FaceEvolution）。\n   *\n   * 每个布尔/变换操作执行后，存储面 ordinal 映射（输入 ordinal → 输出 ordinal 列表）。\n   * 用于面引用在确定性重放下的稳定性验证和未来的面迁移功能。\n   *\n   * FaceEvolution = Map<number, number[]>（inOrdinal → outOrdinal[]）\n   */\n  faceEvolutionCache?: Map<PartName, Map<number, number[]>>\n  /**\n   * 拓扑命名 RoleTable 持久缓存（PartName → RoleTable，§2.3 of\n   *\n   * 与 faceEvolutionCache 完全同生命周期：runtime 实例级持久、按语句增量同步、\n   * dispose 一并 clear。RoleTable 是执行内状态，不序列化、不进 .fai.js、不进\n   * ExecutionResult.naming（宿主只拿 §3.7 的纯数据）。hash 是会话内活句柄索引，\n   * 跨实例/会话重建时整体重建。\n   */\n  roleTableCache?: Map<PartName, unknown>\n  /**\n   * 三角化缓存：PartName → WasmMesh（含 faceGroups）。\n   *\n   * BREP op 调用 solidToShape 三角化后，把完整 WasmMesh 缓存到此 Map。\n   * buildBrepTopology 复用此缓存，避免二次 meshShape 导致拓扑 mesh ≠ 显示 mesh。\n   *\n   * 规则 1：拓扑数据生成所使用的 mesh，必须是当前用户看到的 mesh。\n   * 三角化和拓扑生成都是 faijs 的职责，宿主不参与。\n   */\n  meshShapeCache?: Map<PartName, BrepMeshResult>\n}\n\n/**\n * Create an empty BREP chain state with no cached solids and no kernel.\n * @returns a new empty BrepChainState.\n */\nexport function createBrepChainState(): BrepChainState {\n  return {\n    solidCache: new Map(),\n    kernel: null,\n    faceEvolutionCache: new Map(),\n    roleTableCache: new Map(),\n    meshShapeCache: new Map(),\n  }\n}\n\n/**\n * Initialize the BREP chain state asynchronously: resolve the active BREP\n * engine from the registry and initialize its kernel.\n * OCCT is the built-in default engine: when no engine is registered it is\n * assembled first (ensureOcctDefaultEngine is idempotent).\n * @returns a Promise resolving to an initialized BrepChainState.\n */\nexport async function initBrepChainState(): Promise<BrepChainState> {\n  await ensureOcctDefaultEngine()\n  const engine = await getBrepEngine()\n  return {\n    solidCache: new Map(),\n    kernel: engine.primitives,\n    capabilities: engine.capabilities,\n    faceEvolutionCache: new Map(),\n    roleTableCache: new Map(),\n    meshShapeCache: new Map(),\n  }\n}\n\n/**\n * 释放 BREP 链状态中的所有句柄并清空 solidCache。\n *\n * 释放只发生在「重算顶替 / dispose」，不再需要\"保留终端、释放中间\"的选择性语义，\n * 因此 keepIds 参数已删除——调用方想保留任何 solid 时，不应再调用本函数。\n *\n * @param state BREP 链状态\n */\nexport function releaseBrepChainState(state: BrepChainState): void {\n  for (const [, handle] of state.solidCache) {\n    try {\n      state.kernel?.release(handle)\n    } catch {\n      // 句柄可能已释放，忽略\n    }\n  }\n  state.solidCache.clear()\n  state.meshShapeCache?.clear()\n}\n"]}
+{"version":3,"file":"brep-chain.js","sourceRoot":"","sources":["../../src/brep/brep-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAGhE,qBAAqB;AAErB;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;AAEpD;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,IAA6B,EAC7B,QAAiB;IAEjB,sCAAsC;IACtC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAE3B,kBAAkB;IAClB,MAAM,MAAM,GAAG,IAAI,CAAC,MAA4B,CAAA;IAChD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED,sCAAsC;IACtC,MAAM,SAAS,GAAI,IAAI,CAAC,IAA2B,IAAK,IAAI,CAAC,GAA0B,IAAI,EAAE,CAAA;IAC7F,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAC3D,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC;AAoDD;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,MAAM,EAAE,IAAI;QACZ,kBAAkB,EAAE,IAAI,GAAG,EAAE;QAC7B,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,cAAc,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,uBAAuB,EAAE,CAAA;IAC/B,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAA;IACpC,OAAO;QACL,UAAU,EAAE,IAAI,GAAG,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC,UAAU;QACzB,kBAAkB,EAAE,IAAI,GAAG,EAAE;QAC7B,cAAc,EAAE,IAAI,GAAG,EAAE;QACzB,cAAc,EAAE,IAAI,GAAG,EAAE;KAC1B,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAqB;IACzD,KAAK,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC;YACH,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC;IACD,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACxB,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,CAAA;AAC/B,CAAC","sourcesContent":["/**\n * BREP 链状态管理\n *\n * 在语句重放过程中跟踪 OCCT 精确实体句柄。\n * - solidCache: statementId → ShapeHandle（OCCT 实体句柄）\n *\n * BREP 状态是「逐 part」的：一个 part 是否仍为 BREP，\n * 由 solidCache 里是否有它的句柄唯一决定。\n * 不存在全局 brepActive 标志——兄弟 part 互不污染。\n *\n * 生命周期：由 executeScript / executePart 创建，执行结束后释放所有中间句柄。\n * 终端句柄（如果有）由调用方保留用于导出。\n */\n\nimport type { BrepHandle, BrepMeshResult } from './engine/types'\nimport type { BrepEngineApi } from './engine/primitives'\nimport { getBrepEngine } from './engine/registry'\nimport { ensureOcctDefaultEngine } from './engine/adapters/occt'\nimport type { PartName } from '../identity'\n\n// ─── CAD 格式静态判定 ───\n\n/**\n * CAD formats: files in these formats can be imported by the OCCT kernel as\n * exact solids (STEP/STP via importStep, BREP via fromBREP).\n * IGES is intentionally absent — occt-wasm does not link TKDEIGES.\n */\nconst CAD_FORMATS = new Set(['step', 'brep', 'stp'])\n\n/**\n * 静态判定 load 语句的源文件是否为 CAD 格式。\n *\n * 纯函数，按 args.format / 文件路径扩展名判定，\n * 不调用 OCCT、不 try-catch。\n *\n * @param args load 语句的参数表（key/path/url + format）\n * @param isSource buffer 是否为原始字节（可走 BREP 路径的前提）\n * @returns true 表示是 CAD 源（可走 BREP 路径）\n */\nexport function isCadFormat(\n  args: Record<string, unknown>,\n  isSource: boolean,\n): boolean {\n  // 非 source buffer 是转换后的网格数据 → 非 CAD 源\n  if (!isSource) return false\n\n  // 优先用显式 format 参数\n  const format = args.format as string | undefined\n  if (format) {\n    return CAD_FORMATS.has(format.toLowerCase())\n  }\n\n  // P4-1：按 path/url 的扩展名判定（fileRef 已移除）\n  const pathOrUrl = (args.path as string | undefined) ?? (args.url as string | undefined) ?? ''\n  const ext = pathOrUrl.split('.').pop()?.toLowerCase() ?? ''\n  return CAD_FORMATS.has(ext)\n}\n\n// ─── BREP 链状态 ───\n\n/**\n * BREP 链状态：在语句重放过程中跟踪 OCCT 实体句柄。\n *\n * BREP 状态是「逐 part」的：\n * - solidCache 中存在该 part 的句柄 → 该 part 仍为 BREP\n * - solidCache 中不存在该 part 的句柄 → 该 part 已降级为 mesh\n *\n * 不再有全局 brepActive / breakReason 字段。\n * 一个 part 失去 BREP 状态，当且仅当：\n *   - 它被 knurl/sdf（mesh-only op）产生（不写 solidCache），或\n *   - 它的上游输入中至少有一个没有 BREP 实体。\n * 兄弟 part 之间互不污染。\n */\nexport interface BrepChainState {\n  /** BREP 实体句柄缓存（PartName → BrepHandle）。存在即该 part 仍为 BREP；缺失即已降级为 mesh。 */\n  solidCache: Map<PartName, BrepHandle>\n  /** BREP 引擎实例（mesh 模式为 null —— 等价于「无 BREP 能力」）。 */\n  kernel: BrepEngineApi | null\n  /**\n   * P5-2: 面演化映射缓存（statementId → FaceEvolution）。\n   *\n   * 每个布尔/变换操作执行后，存储面 ordinal 映射（输入 ordinal → 输出 ordinal 列表）。\n   * 用于面引用在确定性重放下的稳定性验证和未来的面迁移功能。\n   *\n   * FaceEvolution = Map<number, number[]>（inOrdinal → outOrdinal[]）\n   */\n  faceEvolutionCache?: Map<PartName, Map<number, number[]>>\n  /**\n   * 拓扑命名 RoleTable 持久缓存（PartName → RoleTable，§2.3 of\n   *\n   * 与 faceEvolutionCache 完全同生命周期：runtime 实例级持久、按语句增量同步、\n   * dispose 一并 clear。RoleTable 是执行内状态，不序列化、不进 .fai.js、不进\n   * ExecutionResult.naming（宿主只拿 §3.7 的纯数据）。hash 是会话内活句柄索引，\n   * 跨实例/会话重建时整体重建。\n   */\n  roleTableCache?: Map<PartName, unknown>\n  /**\n   * 三角化缓存：PartName → WasmMesh（含 faceGroups）。\n   *\n   * BREP op 调用 solidToShape 三角化后，把完整 WasmMesh 缓存到此 Map。\n   * buildBrepTopology 复用此缓存，避免二次 meshShape 导致拓扑 mesh ≠ 显示 mesh。\n   *\n   * 规则 1：拓扑数据生成所使用的 mesh，必须是当前用户看到的 mesh。\n   * 三角化和拓扑生成都是 faijs 的职责，宿主不参与。\n   */\n  meshShapeCache?: Map<PartName, BrepMeshResult>\n}\n\n/**\n * Create an empty BREP chain state with no cached solids and no kernel.\n * @returns a new empty BrepChainState.\n */\nexport function createBrepChainState(): BrepChainState {\n  return {\n    solidCache: new Map(),\n    kernel: null,\n    faceEvolutionCache: new Map(),\n    roleTableCache: new Map(),\n    meshShapeCache: new Map(),\n  }\n}\n\n/**\n * Initialize the BREP chain state asynchronously: resolve the active BREP\n * engine from the registry and initialize its kernel.\n * OCCT is the built-in default engine: when no engine is registered it is\n * assembled first (ensureOcctDefaultEngine is idempotent).\n * @returns a Promise resolving to an initialized BrepChainState.\n */\nexport async function initBrepChainState(): Promise<BrepChainState> {\n  await ensureOcctDefaultEngine()\n  const engine = await getBrepEngine()\n  return {\n    solidCache: new Map(),\n    kernel: engine.primitives,\n    faceEvolutionCache: new Map(),\n    roleTableCache: new Map(),\n    meshShapeCache: new Map(),\n  }\n}\n\n/**\n * 释放 BREP 链状态中的所有句柄并清空 solidCache。\n *\n * 释放只发生在「重算顶替 / dispose」，不再需要\"保留终端、释放中间\"的选择性语义，\n * 因此 keepIds 参数已删除——调用方想保留任何 solid 时，不应再调用本函数。\n *\n * @param state BREP 链状态\n */\nexport function releaseBrepChainState(state: BrepChainState): void {\n  for (const [, handle] of state.solidCache) {\n    try {\n      state.kernel?.release(handle)\n    } catch {\n      // 句柄可能已释放，忽略\n    }\n  }\n  state.solidCache.clear()\n  state.meshShapeCache?.clear()\n}\n"]}

package/dist/brep/brep-ops.d.ts

@@ -18,13 +18,14 @@
  *
  * 坐标系：Z-up、毫米，与 mesh 路径一致。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C, Mat4 } from '../math3d/index.js';
 import type { BrepHandle } from './engine/types.js';
 import type { BrepEngineApi } from './engine/primitives.js';
 import type { Shape, Vec3 } from '../mesh/types.js';
 import type { ImportAssemblyNode } from '../mesh/import-model.js';
 import type { BrepChainState } from './brep-chain.js';
 import type { PartName } from '../identity.js';
+import { type TessellationDensity } from '../runtime-state.js';
 /**
  * 将 OCCT solid 三角化为 Shape（供显示用）。
  *
@@ -37,9 +38,11 @@ import type { PartName } from '../identity.js';
  * @param segments   optional tessellation segment count (affects precision).
  * @param brepChain  optional - caches the BrepMeshResult when provided.
  * @param partName   optional - the part this solid belongs to, paired with brepChain as the cache key.
+ * @param defaultDeflection optional - per-call deflection fallback when `segments` is absent
+ *   (wins over the global tessellation knob; explicit `segments` still wins over both).
  * @returns the tessellated Shape.
  */
-export declare function solidToShape(kernel: BrepEngineApi, solid: BrepHandle, segments?: number, brepChain?: BrepChainState, partName?: PartName): Shape;
+export declare function solidToShape(kernel: BrepEngineApi, solid: BrepHandle, segments?: number, brepChain?: BrepChainState, partName?: PartName, defaultDeflection?: TessellationDensity): Shape;
 /**
  * BREP 平移：使用 OCCT translate（精确，不损失几何精度）。
  *
@@ -204,8 +207,8 @@ export interface DrillBrepParams {
 export interface DrillGeometry {
     readonly radius: number;
     readonly holeHeight: number;
-    readonly holeCenter: THREE.Vector3;
-    readonly direction: THREE.Vector3;
+    readonly holeCenter: Vec3C;
+    readonly direction: Vec3C;
 }
 /** 从 `DrillBrepParams` 推导钻孔几何（孔中心/高度/轴向）。供 `drillBrep` 与 role-table 路径共用。
  * @param kernel - BREP 引擎接口
@@ -383,12 +386,12 @@ export declare function loadBrepAssembly(kernel: BrepEngineApi, buffer: ArrayBuf
     multiSolidCount?: number;
 }>;
 /**
- * Convert a THREE.Matrix4 into the 3x4 row-major array (12 doubles) the OCCT
+ * Convert a Mat4 into the 3x4 row-major array (12 doubles) the OCCT
  * transform expects.
  *
  * OCCT transform accepts [r00,r01,r02,tx, r10,r11,r12,ty, r20,r21,r22,tz].
  * @param matrix - the source matrix to convert.
  * @returns the 3x4 row-major array of 12 doubles.
  */
-export declare function matrixToArray(matrix: THREE.Matrix4): number[];
+export declare function matrixToArray(matrix: Mat4): number[];
 //# sourceMappingURL=brep-ops.d.ts.map

package/dist/brep/brep-ops.d.ts.map

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

package/dist/brep/brep-ops.js

@@ -18,12 +18,11 @@
  *
  * 坐标系：Z-up、毫米，与 mesh 路径一致。
  */
-import * as THREE from 'three';
+import { Vec3 as Vec3C, Mat4, Euler, Quat } from '../math3d/index.js';
 import { getOcctKernel, importAssemblyFromStep, collectLeafParts, } from '../occt-kernel/occtKernel.js';
 import { getSolidColorsOrdered } from '../occt-kernel/stepColorParser.js';
 import { getSolidBoundingBox } from './brep-utils.js';
-import { DEFAULT_LINEAR_DEFLECTION } from '../tolerance.js';
-import { mm } from '../units.js';
+import { getTessellation } from '../runtime-state.js';
 // ─── 通用工具 ───
 /**
  * 将 OCCT solid 三角化为 Shape（供显示用）。
@@ -37,14 +36,19 @@ import { mm } from '../units.js';
  * @param segments   optional tessellation segment count (affects precision).
  * @param brepChain  optional - caches the BrepMeshResult when provided.
  * @param partName   optional - the part this solid belongs to, paired with brepChain as the cache key.
+ * @param defaultDeflection optional - per-call deflection fallback when `segments` is absent
+ *   (wins over the global tessellation knob; explicit `segments` still wins over both).
  * @returns the tessellated Shape.
  */
-export function solidToShape(kernel, solid, segments, brepChain, partName) {
+export function solidToShape(kernel, solid, segments, brepChain, partName, defaultDeflection) {
+    // Deflection precedence: explicit segments > per-call defaultDeflection > global
+    // tessellation (host-tunable via createRuntime, proposal 2026-10-07).
+    const fallback = defaultDeflection ?? getTessellation();
     const angularDeflection = segments
         ? (2 * Math.PI) / Math.max(3, segments)
-        : (2 * Math.PI) / 64; // 缺省 64 = brepjs standard 等效（§5.0/§5.1）
+        : fallback.angularDeflection;
     const mesh = kernel.meshShape(solid, {
-        linearDeflection: DEFAULT_LINEAR_DEFLECTION.as(mm),
+        linearDeflection: fallback.linearDeflection,
         angularDeflection,
     });
     // 规则 1：缓存完整 BrepMeshResult（含 faceGroups），供 buildBrepTopology 复用
@@ -82,11 +86,11 @@ export function translateBrep(kernel, solid, offset) {
  * @returns 新实体
  */
 export function rotateBrep(kernel, solid, angles, pivot) {
-    const euler = new THREE.Euler((angles[0] * Math.PI) / 180, (angles[1] * Math.PI) / 180, (angles[2] * Math.PI) / 180);
-    const matrix = new THREE.Matrix4().makeRotationFromEuler(euler);
+    const euler = new Euler((angles[0] * Math.PI) / 180, (angles[1] * Math.PI) / 180, (angles[2] * Math.PI) / 180);
+    const matrix = new Mat4().makeRotationFromEuler(euler);
     if (pivot) {
-        matrix.premultiply(new THREE.Matrix4().makeTranslation(pivot[0], pivot[1], pivot[2]));
-        matrix.multiply(new THREE.Matrix4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]));
+        matrix.premultiply(new Mat4().makeTranslation(pivot[0], pivot[1], pivot[2]));
+        matrix.multiply(new Mat4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]));
     }
     return kernel.transform(solid, matrixToArray(matrix));
 }
@@ -172,13 +176,13 @@ export function applyAffineBrep(kernel, solid, m12) {
  */
 export function scaleBrep(kernel, solid, factor, center) {
     const f = typeof factor === 'number' ? [factor, factor, factor] : factor;
-    const scale = new THREE.Matrix4().makeScale(f[0], f[1], f[2]);
+    const scale = new Mat4().makeScale(f[0], f[1], f[2]);
     // T(c)·S·T(−c)：不动点为 center；缺省时退化为原点缩放（现状行为）。
     const matrix = center
-        ? new THREE.Matrix4()
+        ? new Mat4()
             .makeTranslation(center[0], center[1], center[2])
             .multiply(scale)
-            .multiply(new THREE.Matrix4().makeTranslation(-center[0], -center[1], -center[2]))
+            .multiply(new Mat4().makeTranslation(-center[0], -center[1], -center[2]))
         : scale;
     return applyAffineBrep(kernel, solid, matrixToArray(matrix));
 }
@@ -200,13 +204,13 @@ export function scaleBrep(kernel, solid, factor, center) {
  * @returns 新实体（调用方负责释放输入实体）
  */
 export function applyTransformBrep(kernel, solid, quaternion, pivot, translation) {
-    const rotation = new THREE.Matrix4().makeRotationFromQuaternion(new THREE.Quaternion(quaternion[0], quaternion[1], quaternion[2], quaternion[3]));
+    const rotation = new Mat4().makeRotationFromQuaternion(new Quat(quaternion[0], quaternion[1], quaternion[2], quaternion[3]));
     // T(translation) · T(pivot) · R · T(-pivot) = T(pivot+translation) · R · T(-pivot)
     // 先绕 pivot 旋转，再平移 translation（与 mesh 路径 applyTransform 一致）
-    const matrix = new THREE.Matrix4()
+    const matrix = new Mat4()
         .makeTranslation(pivot[0] + translation[0], pivot[1] + translation[1], pivot[2] + translation[2])
         .multiply(rotation)
-        .multiply(new THREE.Matrix4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]));
+        .multiply(new Mat4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]));
     return kernel.transform(solid, matrixToArray(matrix));
 }
 // ─── 布尔操作 ───
@@ -251,25 +255,25 @@ export function commonBrep(kernel, a, b) {
  */
 export function computeDrillGeometry(kernel, solid, params) {
     const radius = params.diameter / 2;
-    const direction = new THREE.Vector3(...params.direction).normalize();
+    const direction = new Vec3C(...params.direction).normalize();
     // 确保方向指向材料内部
-    const faceNormal = new THREE.Vector3(...params.faceNormal);
+    const faceNormal = new Vec3C(...params.faceNormal);
     if (direction.dot(faceNormal) > 0) {
         direction.negate();
     }
     // 计算孔的高度和中心
     const bbox = getSolidBoundingBox(kernel, solid);
-    const bboxSize = new THREE.Vector3(bbox.max[0] - bbox.min[0], bbox.max[1] - bbox.min[1], bbox.max[2] - bbox.min[2]);
+    const bboxSize = new Vec3C(bbox.max[0] - bbox.min[0], bbox.max[1] - bbox.min[1], bbox.max[2] - bbox.min[2]);
     const bboxMax = Math.max(bboxSize.x, bboxSize.y, bboxSize.z);
     let holeHeight;
     let holeCenter;
-    const pos = new THREE.Vector3(...params.position);
+    const pos = new Vec3C(...params.position);
     // 通孔：depth <= 0（契约：depth<=0 表示通孔，与 mesh 路径 `depth>0 ? 'blind':'through'` 一致）。
     // ⚠️ 只判 `=== 0` 会让 depth<0 落入盲孔分支 → safeDepth=0 → 零高圆柱 → OCCT transform 崩溃。
     if (params.depth <= 0) {
         const d = direction.clone().normalize();
-        const bbMin = new THREE.Vector3(bbox.min[0], bbox.min[1], bbox.min[2]);
-        const bbMax = new THREE.Vector3(bbox.max[0], bbox.max[1], bbox.max[2]);
+        const bbMin = new Vec3C(bbox.min[0], bbox.min[1], bbox.min[2]);
+        const bbMax = new Vec3C(bbox.max[0], bbox.max[1], bbox.max[2]);
         let tNear = -Infinity;
         let tFar = Infinity;
         const axes = [
@@ -318,16 +322,16 @@ export function computeDrillGeometry(kernel, solid, params) {
 export function buildDrillToolSolid(kernel, geom) {
     const cylinder = kernel.makeCylinder(geom.radius, geom.holeHeight);
     // 计算从 Z 轴到 direction 的旋转
-    const zAxis = new THREE.Vector3(0, 0, 1);
-    const quat = new THREE.Quaternion().setFromUnitVectors(zAxis, geom.direction);
-    const rotMatrix = new THREE.Matrix4().makeRotationFromQuaternion(quat);
+    const zAxis = new Vec3C(0, 0, 1);
+    const quat = new Quat().setFromUnitVectors(zAxis, geom.direction);
+    const rotMatrix = new Mat4().makeRotationFromQuaternion(quat);
     // 平移矩阵：到孔中心，并减去 height/2（因为圆柱从 Z=0 开始）
-    const transMatrix = new THREE.Matrix4().makeTranslation(geom.holeCenter.x, geom.holeCenter.y, geom.holeCenter.z);
+    const transMatrix = new Mat4().makeTranslation(geom.holeCenter.x, geom.holeCenter.y, geom.holeCenter.z);
     // 组合：先旋转，再平移
-    const finalMatrix = new THREE.Matrix4().multiplyMatrices(transMatrix, rotMatrix);
+    const finalMatrix = new Mat4().multiplyMatrices(transMatrix, rotMatrix);
     // 还需要补偿圆柱的起始位置（从 Z=0 开始 → 需要先下移 height/2）
-    const offsetMatrix = new THREE.Matrix4().makeTranslation(0, 0, -geom.holeHeight / 2);
-    const fullMatrix = new THREE.Matrix4().multiplyMatrices(finalMatrix, offsetMatrix);
+    const offsetMatrix = new Mat4().makeTranslation(0, 0, -geom.holeHeight / 2);
+    const fullMatrix = new Mat4().multiplyMatrices(finalMatrix, offsetMatrix);
     const toolSolid = kernel.transform(cylinder, matrixToArray(fullMatrix));
     kernel.release(cylinder);
     return toolSolid;
@@ -369,23 +373,23 @@ export function drillBrep(kernel, solid, params) {
  */
 export function splitBrep(kernel, solid, params) {
     const bbox = getSolidBoundingBox(kernel, solid);
-    const bboxSize = new THREE.Vector3(bbox.max[0] - bbox.min[0], bbox.max[1] - bbox.min[1], bbox.max[2] - bbox.min[2]);
+    const bboxSize = new Vec3C(bbox.max[0] - bbox.min[0], bbox.max[1] - bbox.min[1], bbox.max[2] - bbox.min[2]);
     const bboxMax = Math.max(bboxSize.x, bboxSize.y, bboxSize.z);
     // 创建一个大的盒子代表法线正方向的半空间
-    const normal = new THREE.Vector3(...params.normal).normalize();
+    const normal = new Vec3C(...params.normal).normalize();
     const halfSize = bboxMax * 3; // 足够大
     // 先在局部坐标系（Z 轴 = 法线方向）创建盒子
     // 然后旋转到世界坐标系
-    const zAxis = new THREE.Vector3(0, 0, 1);
-    const quat = new THREE.Quaternion().setFromUnitVectors(zAxis, normal);
-    const rotMatrix = new THREE.Matrix4().makeRotationFromQuaternion(quat);
+    const zAxis = new Vec3C(0, 0, 1);
+    const quat = new Quat().setFromUnitVectors(zAxis, normal);
+    const rotMatrix = new Mat4().makeRotationFromQuaternion(quat);
     // 在局部坐标系中，盒子从 Z=0（切割平面）延伸到 Z=halfSize
     const localBox = kernel.makeBoxFromCorners({ x: -halfSize, y: -halfSize, z: 0 }, { x: halfSize, y: halfSize, z: halfSize });
     // 计算切割平面的世界坐标原点（planeCenter / planeDistance 二选一必填，
     // 都缺省直接报错，不隐式回退 bbox 中心）
     const planeOrigin = resolvePlaneOrigin(normal, params.planeCenter, params.planeDistance);
-    const transMatrix = new THREE.Matrix4().makeTranslation(planeOrigin.x, planeOrigin.y, planeOrigin.z);
-    const finalMatrix = new THREE.Matrix4().multiplyMatrices(transMatrix, rotMatrix);
+    const transMatrix = new Mat4().makeTranslation(planeOrigin.x, planeOrigin.y, planeOrigin.z);
+    const finalMatrix = new Mat4().multiplyMatrices(transMatrix, rotMatrix);
     const halfSpaceBox = kernel.transform(localBox, matrixToArray(finalMatrix));
     kernel.release(localBox);
     try {
@@ -413,7 +417,7 @@ export function splitBrep(kernel, solid, params) {
 /** 从 planeCenter / planeDistance 收敛出切割平面上的一个点（planeOrigin）。 */
 function resolvePlaneOrigin(normal, planeCenter, planeDistance) {
     if (planeCenter !== undefined) {
-        return new THREE.Vector3(...planeCenter);
+        return new Vec3C(...planeCenter);
     }
     if (planeDistance !== undefined) {
         // 平面方程 n·x = d 上的点：取法线上距原点 d 处（n 为单位向量）
@@ -439,7 +443,7 @@ function resolvePlaneOrigin(normal, planeCenter, planeDistance) {
  */
 export function extrudeBrep(kernel, solid, params) {
     const mode = params.mode ?? 'centered';
-    const normal = new THREE.Vector3(...params.normal).normalize();
+    const normal = new Vec3C(...params.normal).normalize();
     const length = params.length;
     // 1. 确定切割平面位置（世界系，来源静态：planeCenter 或 planeDistance，
     //    都缺省直接报错，不隐式回退 bbox 中心）
@@ -452,17 +456,17 @@ export function extrudeBrep(kernel, solid, params) {
     // 3. 获取截面
     // 使用 section 获取切割平面与实体的交线
     const bbox = getSolidBoundingBox(kernel, solid);
-    const zAxis = new THREE.Vector3(0, 0, 1);
-    const quat = new THREE.Quaternion().setFromUnitVectors(zAxis, normal);
-    const rotMatrix = new THREE.Matrix4().makeRotationFromQuaternion(quat);
-    const transMatrix = new THREE.Matrix4().makeTranslation(planeOrigin.x, planeOrigin.y, planeOrigin.z);
-    const planeMatrix = new THREE.Matrix4().multiplyMatrices(transMatrix, rotMatrix);
+    const zAxis = new Vec3C(0, 0, 1);
+    const quat = new Quat().setFromUnitVectors(zAxis, normal);
+    const rotMatrix = new Mat4().makeRotationFromQuaternion(quat);
+    const transMatrix = new Mat4().makeTranslation(planeOrigin.x, planeOrigin.y, planeOrigin.z);
+    const planeMatrix = new Mat4().multiplyMatrices(transMatrix, rotMatrix);
     // 创建一个大的矩形面作为切割平面
-    const bboxSize = new THREE.Vector3(bbox.max[0] - bbox.min[0], bbox.max[1] - bbox.min[1], bbox.max[2] - bbox.min[2]);
+    const bboxSize = new Vec3C(bbox.max[0] - bbox.min[0], bbox.max[1] - bbox.min[1], bbox.max[2] - bbox.min[2]);
     const planeSize = Math.max(bboxSize.x, bboxSize.y, bboxSize.z) * 3;
     const planeRect = kernel.makeRectangle(planeSize, planeSize);
     // makeRectangle creates a face from [0,0] to [width,height] — center it at origin first
-    const centerMatrix = new THREE.Matrix4().makeTranslation(-planeSize / 2, -planeSize / 2, 0);
+    const centerMatrix = new Mat4().makeTranslation(-planeSize / 2, -planeSize / 2, 0);
     const centeredRect = kernel.transform(planeRect, matrixToArray(centerMatrix));
     kernel.release(planeRect);
     const planeFace = kernel.transform(centeredRect, matrixToArray(planeMatrix));
@@ -793,7 +797,7 @@ function toImportAssemblyNode(nodes, leafIndex) {
 }
 // ─── 辅助函数 ───
 /**
- * Convert a THREE.Matrix4 into the 3x4 row-major array (12 doubles) the OCCT
+ * Convert a Mat4 into the 3x4 row-major array (12 doubles) the OCCT
  * transform expects.
  *
  * OCCT transform accepts [r00,r01,r02,tx, r10,r11,r12,ty, r20,r21,r22,tz].
@@ -802,7 +806,7 @@ function toImportAssemblyNode(nodes, leafIndex) {
  */
 export function matrixToArray(matrix) {
     const e = matrix.elements;
-    // THREE.Matrix4 是 column-major，OCCT 需要 row-major 3x4
+    // Mat4 是 column-major，OCCT 需要 row-major 3x4
     return [
         e[0], e[4], e[8], e[12],
         e[1], e[5], e[9], e[13],