@faicad/faijs 0.13.0

package/dist/boolean/joinery-shapes.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Joinery shape construction — pure geometry functions shared by:
+ * - Main thread (split preview): builds THREE.BufferGeometry from {positions, indices}
+ * - Worker (csg-worker.ts): wraps with Manifold.ofMesh for CSG operations
+ *
+ * Extracted from csg-worker.ts createWedge / createDowel / createStraightTenon.
+ * The construction logic is identical — only the Manifold.ofMesh wrapper is removed.
+ *
+ * These functions do NOT depend on THREE.js, Manifold, or `self`.
+ * They return plain { positions: Float32Array, indices: Uint32Array }.
+ */
+import { type Vec3 } from './dovetail-math.js';
+/** Interchange joinery mesh representation: interleaved positions with triangle indices. */
+export interface JoineryMeshData {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * Build wedge (trapezoidal prism) vertex/index data.
+ *
+ * The wedge cross-section is a trapezoid in the normal-depthDir plane:
+ *
+ * ```
+ *          ↑ cutting plane (top edge, narrower)
+ *     ┌──────┐
+ *    /        \       ↑
+ *   / θ      θ \      │ depth
+ *  └────────────┘     │
+ *   ←── width ──→    (bottom edge, wider, at -depth from cutting plane)
+ * ```
+ *
+ * Extrusion is along widthDir, centered at planeCenter.
+ *
+ * @param planeCenter   Center of the cutting plane
+ * @param normal        Cutting plane normal (unit vector, points "up")
+ * @param widthDir      Extrusion direction (unit vector)
+ * @param depth         Trapezoid height (mm), bottom edge is this far below the cutting plane
+ * @param width         Bottom edge length (mm)
+ * @param angleDeg      Angle between bottom edge and slanted side (degrees)
+ * @param extrudeLength Total extrusion length along widthDir (mm)
+ * @returns the wedge mesh data (positions and triangle indices).
+ */
+export declare function buildWedgeGeometry(planeCenter: Vec3, normal: Vec3, widthDir: Vec3, depth: number, width: number, angleDeg: number, extrudeLength: number): JoineryMeshData;
+/**
+ * Build cylindrical vertex/index data for the dowel tenon.
+ *
+ * The circle is in the widthDir-depthDir plane, centered at `centroid`.
+ * The cylinder extends from the cutting plane downward by `height` along `-normal`.
+ *
+ * @param centroid   Center of the cylinder
+ * @param normal     Cutting plane normal (unit vector, points "up")
+ * @param widthDir   Width direction in the cutting plane (unit vector)
+ * @param depthDir   Depth direction in the cutting plane (unit vector)
+ * @param diameter   Cylinder diameter (mm)
+ * @param height     Cylinder height (mm), extends along -normal
+ * @param segments   Number of circular segments (default 32)
+ * @returns the cylindrical mesh data (positions and triangle indices).
+ */
+export declare function buildDowelGeometry(centroid: Vec3, normal: Vec3, widthDir: Vec3, depthDir: Vec3, diameter: number, height: number, segments?: number): JoineryMeshData;
+/**
+ * Build box-shaped vertex/index data for the straight tenon.
+ *
+ * The square cross-section is in the widthDir-depthDir plane,
+ * centered at `centroid`. The box extends from the cutting plane
+ * downward by `height` along `-normal`.
+ *
+ * @param centroid    Center of the box
+ * @param normal      Cutting plane normal (unit vector, points "up")
+ * @param widthDir    Width direction in the cutting plane (unit vector)
+ * @param depthDir    Depth direction in the cutting plane (unit vector)
+ * @param sideLength  Square side length (mm)
+ * @param height      Box height (mm), extends along -normal
+ * @returns the box mesh data (positions and triangle indices).
+ */
+export declare function buildStraightTenonGeometry(centroid: Vec3, normal: Vec3, widthDir: Vec3, depthDir: Vec3, sideLength: number, height: number): JoineryMeshData;
+//# sourceMappingURL=joinery-shapes.d.ts.map

package/dist/boolean/joinery-shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinery-shapes.d.ts","sourceRoot":"","sources":["../../src/boolean/joinery-shapes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAEL,KAAK,IAAI,EACV,MAAM,iBAAiB,CAAA;AAExB,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,IAAI,EACjB,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,IAAI,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,eAAe,CA+CjB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,IAAI,EACd,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,IAAI,EACd,QAAQ,EAAE,IAAI,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAW,GACpB,eAAe,CA+DjB;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,IAAI,EACd,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,IAAI,EACd,QAAQ,EAAE,IAAI,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,eAAe,CAiDjB"}

package/dist/boolean/joinery-shapes.js

@@ -0,0 +1,205 @@
+/**
+ * Joinery shape construction — pure geometry functions shared by:
+ * - Main thread (split preview): builds THREE.BufferGeometry from {positions, indices}
+ * - Worker (csg-worker.ts): wraps with Manifold.ofMesh for CSG operations
+ *
+ * Extracted from csg-worker.ts createWedge / createDowel / createStraightTenon.
+ * The construction logic is identical — only the Manifold.ofMesh wrapper is removed.
+ *
+ * These functions do NOT depend on THREE.js, Manifold, or `self`.
+ * They return plain { positions: Float32Array, indices: Uint32Array }.
+ */
+import { vec3Cross, vec3Normalize, vec3Scale, vec3Add, vec3Sub, } from './dovetail-math.js';
+// ── Wedge (trapezoidal prism) ──
+/**
+ * Build wedge (trapezoidal prism) vertex/index data.
+ *
+ * The wedge cross-section is a trapezoid in the normal-depthDir plane:
+ *
+ * ```
+ *          ↑ cutting plane (top edge, narrower)
+ *     ┌──────┐
+ *    /        \       ↑
+ *   / θ      θ \      │ depth
+ *  └────────────┘     │
+ *   ←── width ──→    (bottom edge, wider, at -depth from cutting plane)
+ * ```
+ *
+ * Extrusion is along widthDir, centered at planeCenter.
+ *
+ * @param planeCenter   Center of the cutting plane
+ * @param normal        Cutting plane normal (unit vector, points "up")
+ * @param widthDir      Extrusion direction (unit vector)
+ * @param depth         Trapezoid height (mm), bottom edge is this far below the cutting plane
+ * @param width         Bottom edge length (mm)
+ * @param angleDeg      Angle between bottom edge and slanted side (degrees)
+ * @param extrudeLength Total extrusion length along widthDir (mm)
+ * @returns the wedge mesh data (positions and triangle indices).
+ */
+export function buildWedgeGeometry(planeCenter, normal, widthDir, depth, width, angleDeg, extrudeLength) {
+    const depthDir = vec3Normalize(vec3Cross(normal, widthDir));
+    const angleRad = (angleDeg * Math.PI) / 180;
+    const halfWidth = width / 2;
+    const halfTopWidth = Math.max(0, halfWidth - depth / Math.tan(angleRad));
+    const halfExtrude = extrudeLength / 2;
+    const positions = new Float32Array(8 * 3);
+    function setVert(i, pos) {
+        positions[i * 3] = pos[0];
+        positions[i * 3 + 1] = pos[1];
+        positions[i * 3 + 2] = pos[2];
+    }
+    const bottomCenter = vec3Sub(planeCenter, vec3Scale(normal, depth));
+    // Front face (X = -halfExtrude along widthDir)
+    setVert(0, vec3Add(vec3Sub(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfWidth))); // bottomLeft
+    setVert(1, vec3Add(vec3Sub(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, halfWidth))); // bottomRight
+    setVert(2, vec3Add(vec3Sub(planeCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, halfTopWidth))); // topRight
+    setVert(3, vec3Add(vec3Sub(planeCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfTopWidth))); // topLeft
+    // Back face (X = +halfExtrude along widthDir)
+    setVert(4, vec3Add(vec3Add(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfWidth))); // bottomLeft
+    setVert(5, vec3Add(vec3Add(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, halfWidth))); // bottomRight
+    setVert(6, vec3Add(vec3Add(planeCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, halfTopWidth))); // topRight
+    setVert(7, vec3Add(vec3Add(planeCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfTopWidth))); // topLeft
+    // 12 triangles (36 indices), all counterclockwise when viewed from outside
+    const indices = new Uint32Array([
+        // Front face (outward = -widthDir)
+        0, 2, 1, 0, 3, 2,
+        // Back face (outward = +widthDir)
+        4, 5, 6, 4, 6, 7,
+        // Bottom face (outward = -normal)
+        0, 5, 4, 0, 1, 5,
+        // Top face (outward = +normal)
+        3, 6, 2, 3, 7, 6,
+        // Left face (outward = -depthDir)
+        0, 7, 3, 0, 4, 7,
+        // Right face (outward = +depthDir)
+        1, 6, 5, 1, 2, 6,
+    ]);
+    return { positions, indices };
+}
+// ── Dowel (cylinder) ──
+/**
+ * Build cylindrical vertex/index data for the dowel tenon.
+ *
+ * The circle is in the widthDir-depthDir plane, centered at `centroid`.
+ * The cylinder extends from the cutting plane downward by `height` along `-normal`.
+ *
+ * @param centroid   Center of the cylinder
+ * @param normal     Cutting plane normal (unit vector, points "up")
+ * @param widthDir   Width direction in the cutting plane (unit vector)
+ * @param depthDir   Depth direction in the cutting plane (unit vector)
+ * @param diameter   Cylinder diameter (mm)
+ * @param height     Cylinder height (mm), extends along -normal
+ * @param segments   Number of circular segments (default 32)
+ * @returns the cylindrical mesh data (positions and triangle indices).
+ */
+export function buildDowelGeometry(centroid, normal, widthDir, depthDir, diameter, height, segments = 32) {
+    const radius = diameter / 2;
+    const vertCount = segments * 2 + 2;
+    const positions = new Float32Array(vertCount * 3);
+    function setVert(i, pos) {
+        positions[i * 3] = pos[0];
+        positions[i * 3 + 1] = pos[1];
+        positions[i * 3 + 2] = pos[2];
+    }
+    const bottomCenter = vec3Sub(centroid, vec3Scale(normal, height));
+    // Top circle (0..segments-1): at cutting plane
+    for (let i = 0; i < segments; i++) {
+        const angle = (2 * Math.PI * i) / segments;
+        const lx = radius * Math.cos(angle);
+        const ly = radius * Math.sin(angle);
+        setVert(i, vec3Add(centroid, vec3Add(vec3Scale(widthDir, lx), vec3Scale(depthDir, ly))));
+    }
+    // Bottom circle (segments..2*segments-1): height below cutting plane
+    for (let i = 0; i < segments; i++) {
+        const angle = (2 * Math.PI * i) / segments;
+        const lx = radius * Math.cos(angle);
+        const ly = radius * Math.sin(angle);
+        setVert(segments + i, vec3Add(bottomCenter, vec3Add(vec3Scale(widthDir, lx), vec3Scale(depthDir, ly))));
+    }
+    // Center vertices for caps
+    setVert(2 * segments, centroid); // top center
+    setVert(2 * segments + 1, bottomCenter); // bottom center
+    // Build triangle indices
+    const triCount = segments * 4;
+    const indices = new Uint32Array(triCount * 3);
+    let idx = 0;
+    for (let i = 0; i < segments; i++) {
+        const next = (i + 1) % segments;
+        // Side face
+        indices[idx++] = i;
+        indices[idx++] = segments + next;
+        indices[idx++] = next;
+        indices[idx++] = i;
+        indices[idx++] = segments + i;
+        indices[idx++] = segments + next;
+        // Top cap
+        indices[idx++] = 2 * segments;
+        indices[idx++] = i;
+        indices[idx++] = next;
+        // Bottom cap
+        indices[idx++] = 2 * segments + 1;
+        indices[idx++] = segments + next;
+        indices[idx++] = segments + i;
+    }
+    return { positions, indices };
+}
+// ── Straight tenon (box) ──
+/**
+ * Build box-shaped vertex/index data for the straight tenon.
+ *
+ * The square cross-section is in the widthDir-depthDir plane,
+ * centered at `centroid`. The box extends from the cutting plane
+ * downward by `height` along `-normal`.
+ *
+ * @param centroid    Center of the box
+ * @param normal      Cutting plane normal (unit vector, points "up")
+ * @param widthDir    Width direction in the cutting plane (unit vector)
+ * @param depthDir    Depth direction in the cutting plane (unit vector)
+ * @param sideLength  Square side length (mm)
+ * @param height      Box height (mm), extends along -normal
+ * @returns the box mesh data (positions and triangle indices).
+ */
+export function buildStraightTenonGeometry(centroid, normal, widthDir, depthDir, sideLength, height) {
+    const half = sideLength / 2;
+    const positions = new Float32Array(8 * 3);
+    function setVert(i, pos) {
+        positions[i * 3] = pos[0];
+        positions[i * 3 + 1] = pos[1];
+        positions[i * 3 + 2] = pos[2];
+    }
+    const hw = vec3Scale(widthDir, half);
+    const hd = vec3Scale(depthDir, half);
+    const hn = vec3Scale(normal, height);
+    // Top face (at cutting plane): centroid ± hw ± hd
+    const t0 = vec3Sub(vec3Sub(centroid, hw), hd); // front-left
+    const t1 = vec3Add(vec3Sub(centroid, hw), hd); // front-right
+    const t2 = vec3Add(vec3Add(centroid, hw), hd); // back-right
+    const t3 = vec3Sub(vec3Add(centroid, hw), hd); // back-left
+    setVert(0, t0);
+    setVert(1, t1);
+    setVert(2, t2);
+    setVert(3, t3);
+    // Bottom face (height below): top - hn
+    setVert(4, vec3Sub(t0, hn));
+    setVert(5, vec3Sub(t1, hn));
+    setVert(6, vec3Sub(t2, hn));
+    setVert(7, vec3Sub(t3, hn));
+    // 12 triangles (36 indices)
+    const indices = new Uint32Array([
+        // Top face (outward = +normal)
+        0, 2, 1, 0, 3, 2,
+        // Bottom face (outward = -normal)
+        4, 5, 6, 4, 6, 7,
+        // Side faces
+        // Front (outward = -widthDir)
+        0, 1, 5, 0, 5, 4,
+        // Right (outward = +depthDir)
+        1, 2, 6, 1, 6, 5,
+        // Back (outward = +widthDir)
+        2, 3, 7, 2, 7, 6,
+        // Left (outward = -depthDir)
+        3, 0, 4, 3, 4, 7,
+    ]);
+    return { positions, indices };
+}
+//# sourceMappingURL=joinery-shapes.js.map

package/dist/boolean/joinery-shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinery-shapes.js","sourceRoot":"","sources":["../../src/boolean/joinery-shapes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Joinery shape construction — pure geometry functions shared by:\n * - Main thread (split preview): builds THREE.BufferGeometry from {positions, indices}\n * - Worker (csg-worker.ts): wraps with Manifold.ofMesh for CSG operations\n *\n * Extracted from csg-worker.ts createWedge / createDowel / createStraightTenon.\n * The construction logic is identical — only the Manifold.ofMesh wrapper is removed.\n *\n * These functions do NOT depend on THREE.js, Manifold, or `self`.\n * They return plain { positions: Float32Array, indices: Uint32Array }.\n */\nimport {\n  vec3Cross, vec3Normalize, vec3Scale, vec3Add, vec3Sub,\n  type Vec3,\n} from './dovetail-math'\n\n/** Interchange joinery mesh representation: interleaved positions with triangle indices. */\nexport interface JoineryMeshData {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n// ── Wedge (trapezoidal prism) ──\n\n/**\n * Build wedge (trapezoidal prism) vertex/index data.\n *\n * The wedge cross-section is a trapezoid in the normal-depthDir plane:\n *\n * ```\n *          ↑ cutting plane (top edge, narrower)\n *     ┌──────┐\n *    /        \\       ↑\n *   / θ      θ \\      │ depth\n *  └────────────┘     │\n *   ←── width ──→    (bottom edge, wider, at -depth from cutting plane)\n * ```\n *\n * Extrusion is along widthDir, centered at planeCenter.\n *\n * @param planeCenter   Center of the cutting plane\n * @param normal        Cutting plane normal (unit vector, points \"up\")\n * @param widthDir      Extrusion direction (unit vector)\n * @param depth         Trapezoid height (mm), bottom edge is this far below the cutting plane\n * @param width         Bottom edge length (mm)\n * @param angleDeg      Angle between bottom edge and slanted side (degrees)\n * @param extrudeLength Total extrusion length along widthDir (mm)\n * @returns the wedge mesh data (positions and triangle indices).\n */\nexport function buildWedgeGeometry(\n  planeCenter: Vec3,\n  normal: Vec3,\n  widthDir: Vec3,\n  depth: number,\n  width: number,\n  angleDeg: number,\n  extrudeLength: number,\n): JoineryMeshData {\n  const depthDir = vec3Normalize(vec3Cross(normal, widthDir))\n  const angleRad = (angleDeg * Math.PI) / 180\n\n  const halfWidth = width / 2\n  const halfTopWidth = Math.max(0, halfWidth - depth / Math.tan(angleRad))\n  const halfExtrude = extrudeLength / 2\n\n  const positions = new Float32Array(8 * 3)\n\n  function setVert(i: number, pos: Vec3) {\n    positions[i * 3] = pos[0]\n    positions[i * 3 + 1] = pos[1]\n    positions[i * 3 + 2] = pos[2]\n  }\n\n  const bottomCenter: Vec3 = vec3Sub(planeCenter, vec3Scale(normal, depth))\n\n  // Front face (X = -halfExtrude along widthDir)\n  setVert(0, vec3Add(vec3Sub(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfWidth)))  // bottomLeft\n  setVert(1, vec3Add(vec3Sub(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir,  halfWidth)))  // bottomRight\n  setVert(2, vec3Add(vec3Sub(planeCenter,   vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir,  halfTopWidth))) // topRight\n  setVert(3, vec3Add(vec3Sub(planeCenter,   vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfTopWidth))) // topLeft\n\n  // Back face (X = +halfExtrude along widthDir)\n  setVert(4, vec3Add(vec3Add(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfWidth)))  // bottomLeft\n  setVert(5, vec3Add(vec3Add(bottomCenter, vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir,  halfWidth)))  // bottomRight\n  setVert(6, vec3Add(vec3Add(planeCenter,   vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir,  halfTopWidth))) // topRight\n  setVert(7, vec3Add(vec3Add(planeCenter,   vec3Scale(widthDir, halfExtrude)), vec3Scale(depthDir, -halfTopWidth))) // topLeft\n\n  // 12 triangles (36 indices), all counterclockwise when viewed from outside\n  const indices = new Uint32Array([\n    // Front face (outward = -widthDir)\n    0, 2, 1,  0, 3, 2,\n    // Back face (outward = +widthDir)\n    4, 5, 6,  4, 6, 7,\n    // Bottom face (outward = -normal)\n    0, 5, 4,  0, 1, 5,\n    // Top face (outward = +normal)\n    3, 6, 2,  3, 7, 6,\n    // Left face (outward = -depthDir)\n    0, 7, 3,  0, 4, 7,\n    // Right face (outward = +depthDir)\n    1, 6, 5,  1, 2, 6,\n  ])\n\n  return { positions, indices }\n}\n\n// ── Dowel (cylinder) ──\n\n/**\n * Build cylindrical vertex/index data for the dowel tenon.\n *\n * The circle is in the widthDir-depthDir plane, centered at `centroid`.\n * The cylinder extends from the cutting plane downward by `height` along `-normal`.\n *\n * @param centroid   Center of the cylinder\n * @param normal     Cutting plane normal (unit vector, points \"up\")\n * @param widthDir   Width direction in the cutting plane (unit vector)\n * @param depthDir   Depth direction in the cutting plane (unit vector)\n * @param diameter   Cylinder diameter (mm)\n * @param height     Cylinder height (mm), extends along -normal\n * @param segments   Number of circular segments (default 32)\n * @returns the cylindrical mesh data (positions and triangle indices).\n */\nexport function buildDowelGeometry(\n  centroid: Vec3,\n  normal: Vec3,\n  widthDir: Vec3,\n  depthDir: Vec3,\n  diameter: number,\n  height: number,\n  segments: number = 32,\n): JoineryMeshData {\n  const radius = diameter / 2\n  const vertCount = segments * 2 + 2\n  const positions = new Float32Array(vertCount * 3)\n\n  function setVert(i: number, pos: Vec3) {\n    positions[i * 3] = pos[0]\n    positions[i * 3 + 1] = pos[1]\n    positions[i * 3 + 2] = pos[2]\n  }\n\n  const bottomCenter: Vec3 = vec3Sub(centroid, vec3Scale(normal, height))\n\n  // Top circle (0..segments-1): at cutting plane\n  for (let i = 0; i < segments; i++) {\n    const angle = (2 * Math.PI * i) / segments\n    const lx = radius * Math.cos(angle)\n    const ly = radius * Math.sin(angle)\n    setVert(i, vec3Add(centroid,\n      vec3Add(vec3Scale(widthDir, lx), vec3Scale(depthDir, ly))))\n  }\n\n  // Bottom circle (segments..2*segments-1): height below cutting plane\n  for (let i = 0; i < segments; i++) {\n    const angle = (2 * Math.PI * i) / segments\n    const lx = radius * Math.cos(angle)\n    const ly = radius * Math.sin(angle)\n    setVert(segments + i, vec3Add(bottomCenter,\n      vec3Add(vec3Scale(widthDir, lx), vec3Scale(depthDir, ly))))\n  }\n\n  // Center vertices for caps\n  setVert(2 * segments, centroid)        // top center\n  setVert(2 * segments + 1, bottomCenter) // bottom center\n\n  // Build triangle indices\n  const triCount = segments * 4\n  const indices = new Uint32Array(triCount * 3)\n\n  let idx = 0\n  for (let i = 0; i < segments; i++) {\n    const next = (i + 1) % segments\n    // Side face\n    indices[idx++] = i\n    indices[idx++] = segments + next\n    indices[idx++] = next\n\n    indices[idx++] = i\n    indices[idx++] = segments + i\n    indices[idx++] = segments + next\n\n    // Top cap\n    indices[idx++] = 2 * segments\n    indices[idx++] = i\n    indices[idx++] = next\n\n    // Bottom cap\n    indices[idx++] = 2 * segments + 1\n    indices[idx++] = segments + next\n    indices[idx++] = segments + i\n  }\n\n  return { positions, indices }\n}\n\n// ── Straight tenon (box) ──\n\n/**\n * Build box-shaped vertex/index data for the straight tenon.\n *\n * The square cross-section is in the widthDir-depthDir plane,\n * centered at `centroid`. The box extends from the cutting plane\n * downward by `height` along `-normal`.\n *\n * @param centroid    Center of the box\n * @param normal      Cutting plane normal (unit vector, points \"up\")\n * @param widthDir    Width direction in the cutting plane (unit vector)\n * @param depthDir    Depth direction in the cutting plane (unit vector)\n * @param sideLength  Square side length (mm)\n * @param height      Box height (mm), extends along -normal\n * @returns the box mesh data (positions and triangle indices).\n */\nexport function buildStraightTenonGeometry(\n  centroid: Vec3,\n  normal: Vec3,\n  widthDir: Vec3,\n  depthDir: Vec3,\n  sideLength: number,\n  height: number,\n): JoineryMeshData {\n  const half = sideLength / 2\n  const positions = new Float32Array(8 * 3)\n\n  function setVert(i: number, pos: Vec3) {\n    positions[i * 3] = pos[0]\n    positions[i * 3 + 1] = pos[1]\n    positions[i * 3 + 2] = pos[2]\n  }\n\n  const hw = vec3Scale(widthDir, half)\n  const hd = vec3Scale(depthDir, half)\n  const hn = vec3Scale(normal, height)\n\n  // Top face (at cutting plane): centroid ± hw ± hd\n  const t0: Vec3 = vec3Sub(vec3Sub(centroid, hw), hd)  // front-left\n  const t1: Vec3 = vec3Add(vec3Sub(centroid, hw), hd)  // front-right\n  const t2: Vec3 = vec3Add(vec3Add(centroid, hw), hd)  // back-right\n  const t3: Vec3 = vec3Sub(vec3Add(centroid, hw), hd)  // back-left\n\n  setVert(0, t0)\n  setVert(1, t1)\n  setVert(2, t2)\n  setVert(3, t3)\n\n  // Bottom face (height below): top - hn\n  setVert(4, vec3Sub(t0, hn))\n  setVert(5, vec3Sub(t1, hn))\n  setVert(6, vec3Sub(t2, hn))\n  setVert(7, vec3Sub(t3, hn))\n\n  // 12 triangles (36 indices)\n  const indices = new Uint32Array([\n    // Top face (outward = +normal)\n    0, 2, 1,  0, 3, 2,\n    // Bottom face (outward = -normal)\n    4, 5, 6,  4, 6, 7,\n    // Side faces\n    // Front (outward = -widthDir)\n    0, 1, 5,  0, 5, 4,\n    // Right (outward = +depthDir)\n    1, 2, 6,  1, 6, 5,\n    // Back (outward = +widthDir)\n    2, 3, 7,  2, 7, 6,\n    // Left (outward = -depthDir)\n    3, 0, 4,  3, 4, 7,\n  ])\n\n  return { positions, indices }\n}\n"]}

package/dist/boolean/manifold-preview.d.ts

@@ -0,0 +1,26 @@
+/**
+ * manifold-preview — 主线程 CSG 预览辅助（D 类）
+ *
+ * E12.4：宿主不得自行调 getManifoldModule / manifold-3d API。
+ * 交互预览所需的单次主线程布尔运算封装在此，由 faijs 内部加载
+ * manifold 单例并管理内存，宿主只传 mesh 数据往返。
+ *
+ * 仅用于预览/辅助计算，绝不用于提交几何（提交走脚本语句执行）。
+ */
+/** Interchange mesh representation for preview operations: positions with triangle indices. */
+export interface ManifoldMeshData {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * 主线程求两个 mesh 的布尔交集（预览用）。
+ *
+ * 与 computeDovetailSplit 等执行路径不同，这里只做一次三元操作并返回
+ * mesh 数据；任一侧为空或 CSG 失败时返回 null（宿主回退到简单预览）。
+ * 内部负责 Manifold/Mesh 的 delete（WASM 内存安全）。
+ * @param a - the first input mesh data.
+ * @param b - the second input mesh data.
+ * @returns the intersecting mesh data, or null when either input is empty or the CSG operation fails.
+ */
+export declare function previewMeshIntersect(a: ManifoldMeshData, b: ManifoldMeshData): Promise<ManifoldMeshData | null>;
+//# sourceMappingURL=manifold-preview.d.ts.map

package/dist/boolean/manifold-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifold-preview.d.ts","sourceRoot":"","sources":["../../src/boolean/manifold-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,YAAY,CAAA;IACvB,OAAO,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,CAAC,EAAE,gBAAgB,EACnB,CAAC,EAAE,gBAAgB,GAClB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAsBlC"}

package/dist/boolean/manifold-preview.js

@@ -0,0 +1,48 @@
+/**
+ * manifold-preview — 主线程 CSG 预览辅助（D 类）
+ *
+ * E12.4：宿主不得自行调 getManifoldModule / manifold-3d API。
+ * 交互预览所需的单次主线程布尔运算封装在此，由 faijs 内部加载
+ * manifold 单例并管理内存，宿主只传 mesh 数据往返。
+ *
+ * 仅用于预览/辅助计算，绝不用于提交几何（提交走脚本语句执行）。
+ */
+import { getManifoldModule } from '../mesh/manifold-loader.js';
+import { meshToManifold, manifoldToMeshData } from './csg-core.js';
+/**
+ * 主线程求两个 mesh 的布尔交集（预览用）。
+ *
+ * 与 computeDovetailSplit 等执行路径不同，这里只做一次三元操作并返回
+ * mesh 数据；任一侧为空或 CSG 失败时返回 null（宿主回退到简单预览）。
+ * 内部负责 Manifold/Mesh 的 delete（WASM 内存安全）。
+ * @param a - the first input mesh data.
+ * @param b - the second input mesh data.
+ * @returns the intersecting mesh data, or null when either input is empty or the CSG operation fails.
+ */
+export async function previewMeshIntersect(a, b) {
+    try {
+        const { Manifold, Mesh } = await getManifoldModule();
+        const am = meshToManifold(Manifold, Mesh, a);
+        const bm = meshToManifold(Manifold, Mesh, b);
+        try {
+            if (am.isEmpty() || bm.isEmpty())
+                return null;
+            const result = am.intersect(bm);
+            if (result.isEmpty()) {
+                result.delete();
+                return null;
+            }
+            const data = manifoldToMeshData(result);
+            result.delete();
+            return data;
+        }
+        finally {
+            am.delete();
+            bm.delete();
+        }
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=manifold-preview.js.map

package/dist/boolean/manifold-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifold-preview.js","sourceRoot":"","sources":["../../src/boolean/manifold-preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAQ/D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,CAAmB,EACnB,CAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAiB,EAAE,CAAA;QACpD,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5C,MAAM,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAC5C,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;gBAAE,OAAO,IAAI,CAAA;YAC7C,MAAM,MAAM,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;YAC/B,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;gBACrB,MAAM,CAAC,MAAM,EAAE,CAAA;gBACf,OAAO,IAAI,CAAA;YACb,CAAC;YACD,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;YACvC,MAAM,CAAC,MAAM,EAAE,CAAA;YACf,OAAO,IAAI,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,MAAM,EAAE,CAAA;YACX,EAAE,CAAC,MAAM,EAAE,CAAA;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC","sourcesContent":["/**\n * manifold-preview — 主线程 CSG 预览辅助（D 类）\n *\n * E12.4：宿主不得自行调 getManifoldModule / manifold-3d API。\n * 交互预览所需的单次主线程布尔运算封装在此，由 faijs 内部加载\n * manifold 单例并管理内存，宿主只传 mesh 数据往返。\n *\n * 仅用于预览/辅助计算，绝不用于提交几何（提交走脚本语句执行）。\n */\n\nimport { getManifoldModule } from '../mesh/manifold-loader'\nimport { meshToManifold, manifoldToMeshData } from './csg-core'\n\n/** Interchange mesh representation for preview operations: positions with triangle indices. */\nexport interface ManifoldMeshData {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n/**\n * 主线程求两个 mesh 的布尔交集（预览用）。\n *\n * 与 computeDovetailSplit 等执行路径不同，这里只做一次三元操作并返回\n * mesh 数据；任一侧为空或 CSG 失败时返回 null（宿主回退到简单预览）。\n * 内部负责 Manifold/Mesh 的 delete（WASM 内存安全）。\n * @param a - the first input mesh data.\n * @param b - the second input mesh data.\n * @returns the intersecting mesh data, or null when either input is empty or the CSG operation fails.\n */\nexport async function previewMeshIntersect(\n  a: ManifoldMeshData,\n  b: ManifoldMeshData,\n): Promise<ManifoldMeshData | null> {\n  try {\n    const { Manifold, Mesh } = await getManifoldModule()\n    const am = meshToManifold(Manifold, Mesh, a)\n    const bm = meshToManifold(Manifold, Mesh, b)\n    try {\n      if (am.isEmpty() || bm.isEmpty()) return null\n      const result = am.intersect(bm)\n      if (result.isEmpty()) {\n        result.delete()\n        return null\n      }\n      const data = manifoldToMeshData(result)\n      result.delete()\n      return data\n    } finally {\n      am.delete()\n      bm.delete()\n    }\n  } catch {\n    return null\n  }\n}"]}

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

@@ -0,0 +1,115 @@
+/**
+ * BREP 链状态管理
+ *
+ * 在语句重放过程中跟踪 OCCT 精确实体句柄。
+ * - solidCache: statementId → ShapeHandle（OCCT 实体句柄）
+ *
+ * BREP 状态是「逐 part」的：一个 part 是否仍为 BREP，
+ * 由 solidCache 里是否有它的句柄唯一决定。
+ * 不存在全局 brepActive 标志——兄弟 part 互不污染。
+ *
+ * 生命周期：由 executeScript / executePart 创建，执行结束后释放所有中间句柄。
+ * 终端句柄（如果有）由调用方保留用于导出。
+ */
+import type { BrepHandle, BrepMeshResult, BrepCapabilities } from './engine/types.js';
+import type { BrepEngineApi } from './engine/primitives.js';
+import type { PartName } from '../identity.js';
+/**
+ * 静态判定 load 语句的源文件是否为 CAD 格式。
+ *
+ * 纯函数，按 args.format / 文件路径扩展名判定，
+ * 不调用 OCCT、不 try-catch。
+ *
+ * @param args load 语句的参数表（key/path/url + format）
+ * @param isSource buffer 是否为原始字节（可走 BREP 路径的前提）
+ * @returns true 表示是 CAD 源（可走 BREP 路径）
+ */
+export declare function isCadFormat(args: Record<string, unknown>, isSource: boolean): boolean;
+/**
+ * BREP 链状态：在语句重放过程中跟踪 OCCT 实体句柄。
+ *
+ * BREP 状态是「逐 part」的：
+ * - solidCache 中存在该 part 的句柄 → 该 part 仍为 BREP
+ * - solidCache 中不存在该 part 的句柄 → 该 part 已降级为 mesh
+ *
+ * 不再有全局 brepActive / breakReason 字段。
+ * 一个 part 失去 BREP 状态，当且仅当：
+ *   - 它被 knurl/sdf（mesh-only op）产生（不写 solidCache），或
+ *   - 它的上游输入中至少有一个没有 BREP 实体。
+ * 兄弟 part 之间互不污染。
+ */
+export interface BrepChainState {
+    /** BREP 实体句柄缓存（PartName → BrepHandle）。存在即该 part 仍为 BREP；缺失即已降级为 mesh。 */
+    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）。
+     *
+     * 每个布尔/变换操作执行后，存储面 ordinal 映射（输入 ordinal → 输出 ordinal 列表）。
+     * 用于面引用在确定性重放下的稳定性验证和未来的面迁移功能。
+     *
+     * FaceEvolution = Map<number, number[]>（inOrdinal → outOrdinal[]）
+     */
+    faceEvolutionCache?: Map<PartName, Map<number, number[]>>;
+    /**
+     * 拓扑命名 RoleTable 持久缓存（PartName → RoleTable，§2.3 of
+     *
+     * 与 faceEvolutionCache 完全同生命周期：runtime 实例级持久、按语句增量同步、
+     * dispose 一并 clear。RoleTable 是执行内状态，不序列化、不进 .fai.js、不进
+     * ExecutionResult.naming（宿主只拿 §3.7 的纯数据）。hash 是会话内活句柄索引，
+     * 跨实例/会话重建时整体重建。
+     */
+    roleTableCache?: Map<PartName, unknown>;
+    /**
+     * 三角化缓存：PartName → WasmMesh（含 faceGroups）。
+     *
+     * BREP op 调用 solidToShape 三角化后，把完整 WasmMesh 缓存到此 Map。
+     * buildBrepTopology 复用此缓存，避免二次 meshShape 导致拓扑 mesh ≠ 显示 mesh。
+     *
+     * 规则 1：拓扑数据生成所使用的 mesh，必须是当前用户看到的 mesh。
+     * 三角化和拓扑生成都是 faijs 的职责，宿主不参与。
+     */
+    meshShapeCache?: Map<PartName, BrepMeshResult>;
+}
+/**
+ * Create an empty BREP chain state with no cached solids and no kernel.
+ * @returns a new empty BrepChainState.
+ */
+export declare function createBrepChainState(): BrepChainState;
+/**
+ * Initialize the BREP chain state asynchronously: resolve the active BREP
+ * engine from the registry and initialize its kernel.
+ * OCCT is the built-in default engine: when no engine is registered it is
+ * assembled first (ensureOcctDefaultEngine is idempotent).
+ * @returns a Promise resolving to an initialized BrepChainState.
+ */
+export declare function initBrepChainState(): Promise<BrepChainState>;
+/**
+ * 释放 BREP 链状态中的所有句柄并清空 solidCache。
+ *
+ * 释放只发生在「重算顶替 / dispose」，不再需要"保留终端、释放中间"的选择性语义，
+ * 因此 keepIds 参数已删除——调用方想保留任何 solid 时，不应再调用本函数。
+ *
+ * @param state BREP 链状态
+ */
+export declare function releaseBrepChainState(state: BrepChainState): void;
+//# sourceMappingURL=brep-chain.d.ts.map

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

@@ -0,0 +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"}

package/dist/brep/brep-chain.js

@@ -0,0 +1,99 @@
+/**
+ * BREP 链状态管理
+ *
+ * 在语句重放过程中跟踪 OCCT 精确实体句柄。
+ * - solidCache: statementId → ShapeHandle（OCCT 实体句柄）
+ *
+ * BREP 状态是「逐 part」的：一个 part 是否仍为 BREP，
+ * 由 solidCache 里是否有它的句柄唯一决定。
+ * 不存在全局 brepActive 标志——兄弟 part 互不污染。
+ *
+ * 生命周期：由 executeScript / executePart 创建，执行结束后释放所有中间句柄。
+ * 终端句柄（如果有）由调用方保留用于导出。
+ */
+import { getBrepEngine } from './engine/registry.js';
+import { ensureOcctDefaultEngine } from './engine/adapters/occt.js';
+// ─── CAD 格式静态判定 ───
+/**
+ * CAD formats: files in these formats can be imported by the OCCT kernel as
+ * exact solids (STEP/STP via importStep, BREP via fromBREP).
+ * IGES is intentionally absent — occt-wasm does not link TKDEIGES.
+ */
+const CAD_FORMATS = new Set(['step', 'brep', 'stp']);
+/**
+ * 静态判定 load 语句的源文件是否为 CAD 格式。
+ *
+ * 纯函数，按 args.format / 文件路径扩展名判定，
+ * 不调用 OCCT、不 try-catch。
+ *
+ * @param args load 语句的参数表（key/path/url + format）
+ * @param isSource buffer 是否为原始字节（可走 BREP 路径的前提）
+ * @returns true 表示是 CAD 源（可走 BREP 路径）
+ */
+export function isCadFormat(args, isSource) {
+    // 非 source buffer 是转换后的网格数据 → 非 CAD 源
+    if (!isSource)
+        return false;
+    // 优先用显式 format 参数
+    const format = args.format;
+    if (format) {
+        return CAD_FORMATS.has(format.toLowerCase());
+    }
+    // P4-1：按 path/url 的扩展名判定（fileRef 已移除）
+    const pathOrUrl = args.path ?? args.url ?? '';
+    const ext = pathOrUrl.split('.').pop()?.toLowerCase() ?? '';
+    return CAD_FORMATS.has(ext);
+}
+/**
+ * Create an empty BREP chain state with no cached solids and no kernel.
+ * @returns a new empty BrepChainState.
+ */
+export function createBrepChainState() {
+    return {
+        solidCache: new Map(),
+        kernel: null,
+        faceEvolutionCache: new Map(),
+        roleTableCache: new Map(),
+        meshShapeCache: new Map(),
+    };
+}
+/**
+ * Initialize the BREP chain state asynchronously: resolve the active BREP
+ * engine from the registry and initialize its kernel.
+ * OCCT is the built-in default engine: when no engine is registered it is
+ * assembled first (ensureOcctDefaultEngine is idempotent).
+ * @returns a Promise resolving to an initialized BrepChainState.
+ */
+export async function initBrepChainState() {
+    await ensureOcctDefaultEngine();
+    const engine = await getBrepEngine();
+    return {
+        solidCache: new Map(),
+        kernel: engine.primitives,
+        capabilities: engine.capabilities,
+        faceEvolutionCache: new Map(),
+        roleTableCache: new Map(),
+        meshShapeCache: new Map(),
+    };
+}
+/**
+ * 释放 BREP 链状态中的所有句柄并清空 solidCache。
+ *
+ * 释放只发生在「重算顶替 / dispose」，不再需要"保留终端、释放中间"的选择性语义，
+ * 因此 keepIds 参数已删除——调用方想保留任何 solid 时，不应再调用本函数。
+ *
+ * @param state BREP 链状态
+ */
+export function releaseBrepChainState(state) {
+    for (const [, handle] of state.solidCache) {
+        try {
+            state.kernel?.release(handle);
+        }
+        catch {
+            // 句柄可能已释放，忽略
+        }
+    }
+    state.solidCache.clear();
+    state.meshShapeCache?.clear();
+}
+//# sourceMappingURL=brep-chain.js.map

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

@@ -0,0 +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"]}