@faicad/faijs 0.30.9 → 0.32.2

package/dist/primitives/mesh-primitives.d.ts

@@ -1,4 +1,4 @@
-import * as THREE from 'three';
+import type { Shape } from '../mesh/types.js';
 import type { PrimitiveType } from './types.js';
 /** Default size in mm used when no explicit size is given. */
 export declare const DEFAULT_SIZE = 20;
@@ -7,16 +7,16 @@ export declare const DEFAULT_SEGMENTS = 32;
 /**
  * Build the base geometry for a primitive type, centred on the origin.
  *
- * Returns a BufferGeometry in Z-up coordinates. Cube/sphere/cylinder/cone
+ * Returns a Shape in Z-up coordinates. Cube/sphere/cylinder/cone
  * geometry is rotated from Y-up to Z-up; the wedge is constructed directly
  * in Z-up.
  *
  * @param type - the primitive type to build.
  * @param size - nominal size in mm (defaults to DEFAULT_SIZE).
  * @param segments - angular/height resolution for curved primitives (defaults to DEFAULT_SEGMENTS).
- * @returns the primitive BufferGeometry.
+ * @returns the primitive Shape.
  */
-export declare function makePrimitiveGeo(type: PrimitiveType, size?: number, segments?: number): THREE.BufferGeometry;
+export declare function makePrimitiveGeo(type: PrimitiveType, size?: number, segments?: number): Shape;
 /**
  * Translate geometry to the given world coordinates.
  * The geometry should already be centred on the origin (makePrimitiveGeo /
@@ -25,14 +25,14 @@ export declare function makePrimitiveGeo(type: PrimitiveType, size?: number, seg
  * @param geo - the geometry to translate.
  * @param x - the X offset in mm.
  * @param y - the Y offset in mm.
+ * @returns a new translated Shape.
  */
-export declare function applyPrimitiveOffset(geo: THREE.BufferGeometry, x: number, y: number): void;
+export declare function applyPrimitiveOffset(geo: Shape, x: number, y: number): Shape;
 /**
- * Merge multiple BufferGeometries into a single indexed geometry.
- * Automatically handles a mix of indexed and non-indexed inputs.
+ * Merge multiple Shapes into a single indexed Shape.
  *
- * @param geometries - the geometries to merge.
- * @returns a new BufferGeometry containing the combined vertices and triangles.
+ * @param geometries - the shapes to merge.
+ * @returns a new Shape containing the combined vertices and triangles.
  */
-export declare function mergeBufferGeometries(geometries: THREE.BufferGeometry[]): THREE.BufferGeometry;
+export declare function mergeBufferGeometries(geometries: Shape[]): Shape;
 //# sourceMappingURL=mesh-primitives.d.ts.map

package/dist/primitives/mesh-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mesh-primitives.d.ts","sourceRoot":"","sources":["../../src/primitives/mesh-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,8DAA8D;AAC9D,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAKlC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,KAAK,CAAC,cAAc,CAyEtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,KAAK,CAAC,cAAc,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,EAAE,GAAG,KAAK,CAAC,cAAc,CAqD9F"}
+{"version":3,"file":"mesh-primitives.d.ts","sourceRoot":"","sources":["../../src/primitives/mesh-primitives.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAG1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,8DAA8D;AAC9D,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAKlC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,KAAK,CA0EP;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,KAAK,EACV,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,KAAK,CAEP;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,KAAK,EAAE,GAAG,KAAK,CAEhE"}

package/dist/primitives/mesh-primitives.js

@@ -1,21 +1,23 @@
-import * as THREE from 'three';
+import { Mat4 } from '../math3d/index.js';
+import { boxGeometry, sphereGeometry, cylinderGeometry, coneGeometry } from '../mesh/meshdata/parametric.js';
+import { transformShape, translateShape, mergeShapes } from '../mesh/meshdata/ops.js';
 /** Default size in mm used when no explicit size is given. */
 export const DEFAULT_SIZE = 20;
 /** Default angular/height segment count used by curved primitives. */
 export const DEFAULT_SEGMENTS = 32;
 /** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */
-const ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2);
+const ROT_Y_TO_Z = new Mat4().makeRotationX(Math.PI / 2);
 /**
  * Build the base geometry for a primitive type, centred on the origin.
  *
- * Returns a BufferGeometry in Z-up coordinates. Cube/sphere/cylinder/cone
+ * Returns a Shape in Z-up coordinates. Cube/sphere/cylinder/cone
  * geometry is rotated from Y-up to Z-up; the wedge is constructed directly
  * in Z-up.
  *
  * @param type - the primitive type to build.
  * @param size - nominal size in mm (defaults to DEFAULT_SIZE).
  * @param segments - angular/height resolution for curved primitives (defaults to DEFAULT_SEGMENTS).
- * @returns the primitive BufferGeometry.
+ * @returns the primitive Shape.
  */
 export function makePrimitiveGeo(type, size, segments) {
     const s = size ?? DEFAULT_SIZE;
@@ -23,22 +25,26 @@ export function makePrimitiveGeo(type, size, segments) {
     let geo;
     switch (type) {
         case 'cube':
-        case 'box':
-            geo = new THREE.BoxGeometry(s, s, s);
-            geo.applyMatrix4(ROT_Y_TO_Z);
+        case 'box': {
+            const g = boxGeometry(s, s, s);
+            geo = transformShape(g, ROT_Y_TO_Z);
             break;
-        case 'sphere':
-            geo = new THREE.SphereGeometry(s / 2, segs, segs);
-            geo.applyMatrix4(ROT_Y_TO_Z);
+        }
+        case 'sphere': {
+            const g = sphereGeometry(s / 2, segs, segs);
+            geo = transformShape(g, ROT_Y_TO_Z);
             break;
-        case 'cylinder':
-            geo = new THREE.CylinderGeometry(s / 2, s / 2, s, segs);
-            geo.applyMatrix4(ROT_Y_TO_Z);
+        }
+        case 'cylinder': {
+            const g = cylinderGeometry(s / 2, s / 2, s, segs);
+            geo = transformShape(g, ROT_Y_TO_Z);
             break;
-        case 'cone':
-            geo = new THREE.ConeGeometry(s / 2, s, segs);
-            geo.applyMatrix4(ROT_Y_TO_Z);
+        }
+        case 'cone': {
+            const g = coneGeometry(s / 2, s, segs);
+            geo = transformShape(g, ROT_Y_TO_Z);
             break;
+        }
         case 'wedge': {
             // 楔形体：梯形棱柱，直接在 Z-up 中构建
             // 梯形在 YZ 平面（Y=宽度方向，Z=高度方向），拉升沿 X 轴
@@ -76,10 +82,7 @@ export function makePrimitiveGeo(type, size, segments) {
                 // 右侧面 (outward = +Y)
                 1, 6, 5, 1, 2, 6,
             ]);
-            geo = new THREE.BufferGeometry();
-            geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
-            geo.setIndex(new THREE.BufferAttribute(indices, 1));
-            // 楔形体直接在 Z-up 中构建，无需 ROT_Y_TO_Z
+            geo = { positions, indices };
             break;
         }
     }
@@ -93,68 +96,18 @@ export function makePrimitiveGeo(type, size, segments) {
  * @param geo - the geometry to translate.
  * @param x - the X offset in mm.
  * @param y - the Y offset in mm.
+ * @returns a new translated Shape.
  */
 export function applyPrimitiveOffset(geo, x, y) {
-    if (x === 0 && y === 0)
-        return;
-    geo.translate(x, y, 0);
+    return translateShape(geo, x, y, 0);
 }
 /**
- * Merge multiple BufferGeometries into a single indexed geometry.
- * Automatically handles a mix of indexed and non-indexed inputs.
+ * Merge multiple Shapes into a single indexed Shape.
  *
- * @param geometries - the geometries to merge.
- * @returns a new BufferGeometry containing the combined vertices and triangles.
+ * @param geometries - the shapes to merge.
+ * @returns a new Shape containing the combined vertices and triangles.
  */
 export function mergeBufferGeometries(geometries) {
-    if (geometries.length === 1)
-        return geometries[0].clone();
-    const merged = new THREE.BufferGeometry();
-    // Collect all position arrays
-    const allPositions = [];
-    const allIndices = [];
-    let vertexOffset = 0;
-    for (const geo of geometries) {
-        const pos = geo.getAttribute('position');
-        if (!pos)
-            continue;
-        allPositions.push(new Float32Array(pos.array));
-        const idx = geo.index;
-        if (idx) {
-            const shifted = new Uint32Array(idx.array.length);
-            for (let i = 0; i < idx.count; i++) {
-                shifted[i] = idx.array[i] + vertexOffset;
-            }
-            allIndices.push(shifted);
-        }
-        else {
-            // Non-indexed geometry: create sequential indices
-            const count = pos.count;
-            const indices = new Uint32Array(count);
-            for (let i = 0; i < count; i++)
-                indices[i] = i + vertexOffset;
-            allIndices.push(indices);
-        }
-        vertexOffset += pos.count;
-    }
-    // Concatenate positions
-    const totalPosLen = allPositions.reduce((s, a) => s + a.length, 0);
-    const mergedPos = new Float32Array(totalPosLen);
-    let posOffset = 0;
-    for (const arr of allPositions) {
-        mergedPos.set(arr, posOffset);
-        posOffset += arr.length;
-    }
-    merged.setAttribute('position', new THREE.BufferAttribute(mergedPos, 3));
-    // Concatenate indices
-    const totalIdxLen = allIndices.reduce((s, a) => s + a.length, 0);
-    const mergedIdx = new Uint32Array(totalIdxLen);
-    let idxOffset = 0;
-    for (const arr of allIndices) {
-        mergedIdx.set(arr, idxOffset);
-        idxOffset += arr.length;
-    }
-    merged.setIndex(new THREE.BufferAttribute(mergedIdx, 1));
-    return merged;
+    return mergeShapes(geometries);
 }
 //# sourceMappingURL=mesh-primitives.js.map

package/dist/primitives/mesh-primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"mesh-primitives.js","sourceRoot":"","sources":["../../src/primitives/mesh-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAC9B,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAElC,0EAA0E;AAC1E,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;AAEjE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAmB,EACnB,IAAa,EACb,QAAiB;IAEjB,MAAM,CAAC,GAAG,IAAI,IAAI,YAAY,CAAA;IAC9B,MAAM,IAAI,GAAG,QAAQ,IAAI,gBAAgB,CAAA;IAEzC,IAAI,GAAyB,CAAA;IAC7B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK;YACR,GAAG,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YACpC,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;YAC5B,MAAK;QACP,KAAK,QAAQ;YACX,GAAG,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;YACjD,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;YAC5B,MAAK;QACP,KAAK,UAAU;YACb,GAAG,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;YACvD,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;YAC5B,MAAK;QACP,KAAK,MAAM;YACT,GAAG,GAAG,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;YAC5C,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;YAC5B,MAAK;QACP,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,wBAAwB;YACxB,mCAAmC;YACnC,MAAM,KAAK,GAAG,CAAC,CAAA,CAAqB,YAAY;YAChD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAA,CAAgB,mBAAmB;YACvD,MAAM,QAAQ,GAAG,EAAE,CAAA,CAAiB,WAAW;YAC/C,MAAM,QAAQ,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAA;YAC3C,MAAM,WAAW,GAAG,EAAE,CAAA,CAAc,iBAAiB;YACrD,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,CAAA;YAEpB,qCAAqC;YACrC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;YAElE,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;gBACjC,yBAAyB;gBACzB,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAmB,iBAAiB;gBACxD,CAAC,WAAW,EAAG,EAAE,EAAE,CAAC,EAAmB,kBAAkB;gBACzD,CAAC,WAAW,EAAG,YAAY,EAAE,MAAM,EAAK,eAAe;gBACvD,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAK,cAAc;gBACtD,yBAAyB;gBACxB,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAmB,iBAAiB;gBACvD,WAAW,EAAG,EAAE,EAAE,CAAC,EAAmB,kBAAkB;gBACxD,WAAW,EAAG,YAAY,EAAE,MAAM,EAAK,eAAe;gBACtD,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAK,cAAc;aACvD,CAAC,CAAA;YAEF,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;gBAC9B,oDAAoD;gBACpD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,oDAAoD;gBACpD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,oBAAoB;gBACpB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,oBAAoB;gBACpB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,qBAAqB;gBACrB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,qBAAqB;gBACrB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;aAClB,CAAC,CAAA;YAEF,GAAG,GAAG,IAAI,KAAK,CAAC,cAAc,EAAE,CAAA;YAChC,GAAG,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;YACrE,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAA;YACnD,gCAAgC;YAChC,MAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAyB,EACzB,CAAS,EACT,CAAS;IAET,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAM;IAC9B,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkC;IACtE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAA;IAEzD,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,cAAc,EAAE,CAAA;IAEzC,8BAA8B;IAC9B,MAAM,YAAY,GAAmB,EAAE,CAAA;IACvC,MAAM,UAAU,GAAkB,EAAE,CAAA;IACpC,IAAI,YAAY,GAAG,CAAC,CAAA;IAEpB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAA0B,CAAA;QACjE,IAAI,CAAC,GAAG;YAAE,SAAQ;QAElB,YAAY,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;QAC9C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAA;QACrB,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBACnC,OAAO,CAAC,CAAC,CAAC,GAAI,GAAG,CAAC,KAAmC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAA;YACzE,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;aAAM,CAAC;YACN,kDAAkD;YAClD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAA;YACvB,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;YACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;gBAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,YAAY,CAAA;YAC7D,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;QACD,YAAY,IAAI,GAAG,CAAC,KAAK,CAAA;IAC3B,CAAC;IAED,wBAAwB;IACxB,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAClE,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,WAAW,CAAC,CAAA;IAC/C,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QAC7B,SAAS,IAAI,GAAG,CAAC,MAAM,CAAA;IACzB,CAAC;IACD,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,IAAI,KAAK,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;IAExE,sBAAsB;IACtB,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAChE,MAAM,SAAS,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAA;IAC9C,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;QAC7B,SAAS,IAAI,GAAG,CAAC,MAAM,CAAA;IACzB,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAA;IAExD,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["import * as THREE from 'three'\nimport type { PrimitiveType } from './types'\n\n/** Default size in mm used when no explicit size is given. */\nexport const DEFAULT_SIZE = 20\n/** Default angular/height segment count used by curved primitives. */\nexport const DEFAULT_SEGMENTS = 32\n\n/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */\nconst ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2)\n\n/**\n * Build the base geometry for a primitive type, centred on the origin.\n *\n * Returns a BufferGeometry in Z-up coordinates. Cube/sphere/cylinder/cone\n * geometry is rotated from Y-up to Z-up; the wedge is constructed directly\n * in Z-up.\n *\n * @param type - the primitive type to build.\n * @param size - nominal size in mm (defaults to DEFAULT_SIZE).\n * @param segments - angular/height resolution for curved primitives (defaults to DEFAULT_SEGMENTS).\n * @returns the primitive BufferGeometry.\n */\nexport function makePrimitiveGeo(\n  type: PrimitiveType,\n  size?: number,\n  segments?: number,\n): THREE.BufferGeometry {\n  const s = size ?? DEFAULT_SIZE\n  const segs = segments ?? DEFAULT_SEGMENTS\n\n  let geo: THREE.BufferGeometry\n  switch (type) {\n    case 'cube':\n    case 'box':\n      geo = new THREE.BoxGeometry(s, s, s)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'sphere':\n      geo = new THREE.SphereGeometry(s / 2, segs, segs)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'cylinder':\n      geo = new THREE.CylinderGeometry(s / 2, s / 2, s, segs)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'cone':\n      geo = new THREE.ConeGeometry(s / 2, s, segs)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'wedge': {\n      // 楔形体：梯形棱柱，直接在 Z-up 中构建\n      // 梯形在 YZ 平面（Y=宽度方向，Z=高度方向），拉升沿 X 轴\n      const width = s                     // 底边长度（沿 Y）\n      const height = s / 2                // 梯形高（沿 Z，默认 10mm）\n      const angleDeg = 60                 // 底边与斜边的夹角\n      const angleRad = (angleDeg * Math.PI) / 180\n      const halfExtrude = 25              // 拉升总长 50mm（沿 X）\n      const hw = width / 2\n\n      // 上边半宽 = 底边半宽 - 高 / tan(角度)，钳制到 >= 0\n      const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad))\n\n      const positions = new Float32Array([\n        // 前端面 (X = -halfExtrude)\n        -halfExtrude, -hw, 0,                  // p0: bottomLeft\n        -halfExtrude,  hw, 0,                  // p1: bottomRight\n        -halfExtrude,  halfTopWidth, height,    // p2: topRight\n        -halfExtrude, -halfTopWidth, height,    // p3: topLeft\n        // 后端面 (X = +halfExtrude)\n         halfExtrude, -hw, 0,                  // p4: bottomLeft\n         halfExtrude,  hw, 0,                  // p5: bottomRight\n         halfExtrude,  halfTopWidth, height,    // p6: topRight\n         halfExtrude, -halfTopWidth, height,    // p7: topLeft\n      ])\n\n      const indices = new Uint32Array([\n        // 前端面 (outward = -X, counterclockwise from outside)\n        0, 2, 1,  0, 3, 2,\n        // 后端面 (outward = +X, counterclockwise from outside)\n        4, 5, 6,  4, 6, 7,\n        // 底面 (outward = -Z)\n        0, 5, 4,  0, 1, 5,\n        // 顶面 (outward = +Z)\n        3, 6, 2,  3, 7, 6,\n        // 左侧面 (outward = -Y)\n        0, 7, 3,  0, 4, 7,\n        // 右侧面 (outward = +Y)\n        1, 6, 5,  1, 2, 6,\n      ])\n\n      geo = new THREE.BufferGeometry()\n      geo.setAttribute('position', new THREE.BufferAttribute(positions, 3))\n      geo.setIndex(new THREE.BufferAttribute(indices, 1))\n      // 楔形体直接在 Z-up 中构建，无需 ROT_Y_TO_Z\n      break\n    }\n  }\n\n  return geo\n}\n\n/**\n * Translate geometry to the given world coordinates.\n * The geometry should already be centred on the origin (makePrimitiveGeo /\n * makeScrew / createTextGeometry all produce centred geometry).\n *\n * @param geo - the geometry to translate.\n * @param x - the X offset in mm.\n * @param y - the Y offset in mm.\n */\nexport function applyPrimitiveOffset(\n  geo: THREE.BufferGeometry,\n  x: number,\n  y: number,\n): void {\n  if (x === 0 && y === 0) return\n  geo.translate(x, y, 0)\n}\n\n/**\n * Merge multiple BufferGeometries into a single indexed geometry.\n * Automatically handles a mix of indexed and non-indexed inputs.\n *\n * @param geometries - the geometries to merge.\n * @returns a new BufferGeometry containing the combined vertices and triangles.\n */\nexport function mergeBufferGeometries(geometries: THREE.BufferGeometry[]): THREE.BufferGeometry {\n  if (geometries.length === 1) return geometries[0].clone()\n\n  const merged = new THREE.BufferGeometry()\n\n  // Collect all position arrays\n  const allPositions: Float32Array[] = []\n  const allIndices: Uint32Array[] = []\n  let vertexOffset = 0\n\n  for (const geo of geometries) {\n    const pos = geo.getAttribute('position') as THREE.BufferAttribute\n    if (!pos) continue\n\n    allPositions.push(new Float32Array(pos.array))\n    const idx = geo.index\n    if (idx) {\n      const shifted = new Uint32Array(idx.array.length)\n      for (let i = 0; i < idx.count; i++) {\n        shifted[i] = (idx.array as Uint32Array | Uint16Array)[i] + vertexOffset\n      }\n      allIndices.push(shifted)\n    } else {\n      // Non-indexed geometry: create sequential indices\n      const count = pos.count\n      const indices = new Uint32Array(count)\n      for (let i = 0; i < count; i++) indices[i] = i + vertexOffset\n      allIndices.push(indices)\n    }\n    vertexOffset += pos.count\n  }\n\n  // Concatenate positions\n  const totalPosLen = allPositions.reduce((s, a) => s + a.length, 0)\n  const mergedPos = new Float32Array(totalPosLen)\n  let posOffset = 0\n  for (const arr of allPositions) {\n    mergedPos.set(arr, posOffset)\n    posOffset += arr.length\n  }\n  merged.setAttribute('position', new THREE.BufferAttribute(mergedPos, 3))\n\n  // Concatenate indices\n  const totalIdxLen = allIndices.reduce((s, a) => s + a.length, 0)\n  const mergedIdx = new Uint32Array(totalIdxLen)\n  let idxOffset = 0\n  for (const arr of allIndices) {\n    mergedIdx.set(arr, idxOffset)\n    idxOffset += arr.length\n  }\n  merged.setIndex(new THREE.BufferAttribute(mergedIdx, 1))\n\n  return merged\n}\n"]}
+{"version":3,"file":"mesh-primitives.js","sourceRoot":"","sources":["../../src/primitives/mesh-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AACzG,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAGlF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAC9B,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAElC,0EAA0E;AAC1E,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAmB,EACnB,IAAa,EACb,QAAiB;IAEjB,MAAM,CAAC,GAAG,IAAI,IAAI,YAAY,CAAA;IAC9B,MAAM,IAAI,GAAG,QAAQ,IAAI,gBAAgB,CAAA;IAEzC,IAAI,GAAU,CAAA;IACd,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;YAC9B,GAAG,GAAG,cAAc,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;YACnC,MAAK;QACP,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;YAC3C,GAAG,GAAG,cAAc,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;YACnC,MAAK;QACP,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;YACjD,GAAG,GAAG,cAAc,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;YACnC,MAAK;QACP,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAA;YACtC,GAAG,GAAG,cAAc,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;YACnC,MAAK;QACP,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,wBAAwB;YACxB,mCAAmC;YACnC,MAAM,KAAK,GAAG,CAAC,CAAA,CAAqB,YAAY;YAChD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAA,CAAgB,mBAAmB;YACvD,MAAM,QAAQ,GAAG,EAAE,CAAA,CAAiB,WAAW;YAC/C,MAAM,QAAQ,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAA;YAC3C,MAAM,WAAW,GAAG,EAAE,CAAA,CAAc,iBAAiB;YACrD,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC,CAAA;YAEpB,qCAAqC;YACrC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;YAElE,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;gBACjC,yBAAyB;gBACzB,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAmB,iBAAiB;gBACxD,CAAC,WAAW,EAAG,EAAE,EAAE,CAAC,EAAmB,kBAAkB;gBACzD,CAAC,WAAW,EAAG,YAAY,EAAE,MAAM,EAAK,eAAe;gBACvD,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAK,cAAc;gBACtD,yBAAyB;gBACxB,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,EAAmB,iBAAiB;gBACvD,WAAW,EAAG,EAAE,EAAE,CAAC,EAAmB,kBAAkB;gBACxD,WAAW,EAAG,YAAY,EAAE,MAAM,EAAK,eAAe;gBACtD,WAAW,EAAE,CAAC,YAAY,EAAE,MAAM,EAAK,cAAc;aACvD,CAAC,CAAA;YAEF,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;gBAC9B,oDAAoD;gBACpD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,oDAAoD;gBACpD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,oBAAoB;gBACpB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,oBAAoB;gBACpB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,qBAAqB;gBACrB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjB,qBAAqB;gBACrB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAG,CAAC,EAAE,CAAC,EAAE,CAAC;aAClB,CAAC,CAAA;YAEF,GAAG,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,CAAA;YAC5B,MAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAU,EACV,CAAS,EACT,CAAS;IAET,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAmB;IACvD,OAAO,WAAW,CAAC,UAAU,CAAC,CAAA;AAChC,CAAC","sourcesContent":["import { Mat4 } from '../math3d'\nimport type { Shape } from '../mesh/types'\nimport { boxGeometry, sphereGeometry, cylinderGeometry, coneGeometry } from '../mesh/meshdata/parametric'\nimport { transformShape, translateShape, mergeShapes } from '../mesh/meshdata/ops'\nimport type { PrimitiveType } from './types'\n\n/** Default size in mm used when no explicit size is given. */\nexport const DEFAULT_SIZE = 20\n/** Default angular/height segment count used by curved primitives. */\nexport const DEFAULT_SEGMENTS = 32\n\n/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */\nconst ROT_Y_TO_Z = new Mat4().makeRotationX(Math.PI / 2)\n\n/**\n * Build the base geometry for a primitive type, centred on the origin.\n *\n * Returns a Shape in Z-up coordinates. Cube/sphere/cylinder/cone\n * geometry is rotated from Y-up to Z-up; the wedge is constructed directly\n * in Z-up.\n *\n * @param type - the primitive type to build.\n * @param size - nominal size in mm (defaults to DEFAULT_SIZE).\n * @param segments - angular/height resolution for curved primitives (defaults to DEFAULT_SEGMENTS).\n * @returns the primitive Shape.\n */\nexport function makePrimitiveGeo(\n  type: PrimitiveType,\n  size?: number,\n  segments?: number,\n): Shape {\n  const s = size ?? DEFAULT_SIZE\n  const segs = segments ?? DEFAULT_SEGMENTS\n\n  let geo: Shape\n  switch (type) {\n    case 'cube':\n    case 'box': {\n      const g = boxGeometry(s, s, s)\n      geo = transformShape(g, ROT_Y_TO_Z)\n      break\n    }\n    case 'sphere': {\n      const g = sphereGeometry(s / 2, segs, segs)\n      geo = transformShape(g, ROT_Y_TO_Z)\n      break\n    }\n    case 'cylinder': {\n      const g = cylinderGeometry(s / 2, s / 2, s, segs)\n      geo = transformShape(g, ROT_Y_TO_Z)\n      break\n    }\n    case 'cone': {\n      const g = coneGeometry(s / 2, s, segs)\n      geo = transformShape(g, ROT_Y_TO_Z)\n      break\n    }\n    case 'wedge': {\n      // 楔形体：梯形棱柱，直接在 Z-up 中构建\n      // 梯形在 YZ 平面（Y=宽度方向，Z=高度方向），拉升沿 X 轴\n      const width = s                     // 底边长度（沿 Y）\n      const height = s / 2                // 梯形高（沿 Z，默认 10mm）\n      const angleDeg = 60                 // 底边与斜边的夹角\n      const angleRad = (angleDeg * Math.PI) / 180\n      const halfExtrude = 25              // 拉升总长 50mm（沿 X）\n      const hw = width / 2\n\n      // 上边半宽 = 底边半宽 - 高 / tan(角度)，钳制到 >= 0\n      const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad))\n\n      const positions = new Float32Array([\n        // 前端面 (X = -halfExtrude)\n        -halfExtrude, -hw, 0,                  // p0: bottomLeft\n        -halfExtrude,  hw, 0,                  // p1: bottomRight\n        -halfExtrude,  halfTopWidth, height,    // p2: topRight\n        -halfExtrude, -halfTopWidth, height,    // p3: topLeft\n        // 后端面 (X = +halfExtrude)\n         halfExtrude, -hw, 0,                  // p4: bottomLeft\n         halfExtrude,  hw, 0,                  // p5: bottomRight\n         halfExtrude,  halfTopWidth, height,    // p6: topRight\n         halfExtrude, -halfTopWidth, height,    // p7: topLeft\n      ])\n\n      const indices = new Uint32Array([\n        // 前端面 (outward = -X, counterclockwise from outside)\n        0, 2, 1,  0, 3, 2,\n        // 后端面 (outward = +X, counterclockwise from outside)\n        4, 5, 6,  4, 6, 7,\n        // 底面 (outward = -Z)\n        0, 5, 4,  0, 1, 5,\n        // 顶面 (outward = +Z)\n        3, 6, 2,  3, 7, 6,\n        // 左侧面 (outward = -Y)\n        0, 7, 3,  0, 4, 7,\n        // 右侧面 (outward = +Y)\n        1, 6, 5,  1, 2, 6,\n      ])\n\n      geo = { positions, indices }\n      break\n    }\n  }\n\n  return geo\n}\n\n/**\n * Translate geometry to the given world coordinates.\n * The geometry should already be centred on the origin (makePrimitiveGeo /\n * makeScrew / createTextGeometry all produce centred geometry).\n *\n * @param geo - the geometry to translate.\n * @param x - the X offset in mm.\n * @param y - the Y offset in mm.\n * @returns a new translated Shape.\n */\nexport function applyPrimitiveOffset(\n  geo: Shape,\n  x: number,\n  y: number,\n): Shape {\n  return translateShape(geo, x, y, 0)\n}\n\n/**\n * Merge multiple Shapes into a single indexed Shape.\n *\n * @param geometries - the shapes to merge.\n * @returns a new Shape containing the combined vertices and triangles.\n */\nexport function mergeBufferGeometries(geometries: Shape[]): Shape {\n  return mergeShapes(geometries)\n}\n"]}

package/dist/primitives/screw/screw.d.ts

@@ -1,4 +1,4 @@
-import * as THREE from 'three';
+import type { GeoData } from '../../mesh/meshdata/parametric.js';
 import type { ScrewParams } from './screw-db.js';
 /**
  * Generate screw geometry from parameters.
@@ -7,7 +7,7 @@ import type { ScrewParams } from './screw-db.js';
  * at a specific angular phase; vertices near that phase get larger radius.
  *
  * @param params - the screw parameters (system, spec, thread, length, head, resolution).
- * @returns a Z-up BufferGeometry of the screw.
+ * @returns a Z-up GeoData of the screw.
  */
-export declare function makeScrew(params: ScrewParams): THREE.BufferGeometry;
+export declare function makeScrew(params: ScrewParams): GeoData;
 //# sourceMappingURL=screw.d.ts.map

package/dist/primitives/screw/screw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screw.d.ts","sourceRoot":"","sources":["../../../src/primitives/screw/screw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA4B7C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CAAC,cAAc,CA8KnE"}
+{"version":3,"file":"screw.d.ts","sourceRoot":"","sources":["../../../src/primitives/screw/screw.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AA4B7C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CA6KtD"}

package/dist/primitives/screw/screw.js

@@ -1,11 +1,12 @@
-import * as THREE from 'three';
+import { Mat4 } from '../../math3d/index.js';
+import { transformShape } from '../../mesh/meshdata/ops.js';
 import { getScrewSpec, threadToPitchMm, SCREW_HEAD_DIMS } from './screw-db.js';
 /** Max axial rings */
 const N_AX_MAX = 3200;
 /** Rings per full turn */
 const N_PER_TURN = 32;
 /** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */
-const ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2);
+const ROT_Y_TO_Z = new Mat4().makeRotationX(Math.PI / 2);
 /**
  * Modulo that always returns a positive result.
  */
@@ -27,7 +28,7 @@ function threadProfileFactor(offset) {
  * at a specific angular phase; vertices near that phase get larger radius.
  *
  * @param params - the screw parameters (system, spec, thread, length, head, resolution).
- * @returns a Z-up BufferGeometry of the screw.
+ * @returns a Z-up GeoData of the screw.
  */
 export function makeScrew(params) {
     const { system, specIdx, thread, pitchCustom, length, head, nRad, } = params;
@@ -166,11 +167,11 @@ export function makeScrew(params) {
             tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext));
         }
     }
-    // ---- Build BufferGeometry and rotate to Z-up ----
-    const geo = new THREE.BufferGeometry();
-    geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(vPos), 3));
-    geo.setIndex(new THREE.BufferAttribute(new Uint32Array(tris), 1));
-    geo.applyMatrix4(ROT_Y_TO_Z);
-    return geo;
+    // ---- Build GeoData and rotate to Z-up ----
+    const geo = {
+        positions: new Float32Array(vPos),
+        indices: new Uint32Array(tris),
+    };
+    return transformShape(geo, ROT_Y_TO_Z);
 }
 //# sourceMappingURL=screw.js.map

package/dist/primitives/screw/screw.js.map

@@ -1 +1 @@
-{"version":3,"file":"screw.js","sourceRoot":"","sources":["../../../src/primitives/screw/screw.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\nimport type { ScrewParams } from './screw-db'\nimport { getScrewSpec, threadToPitchMm, SCREW_HEAD_DIMS } from './screw-db'\n\n/** Max axial rings */\nconst N_AX_MAX = 3200\n\n/** Rings per full turn */\nconst N_PER_TURN = 32\n\n/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */\nconst ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2)\n\n/**\n * Modulo that always returns a positive result.\n */\nfunction modPos(a: number, b: number): number {\n  return ((a % b) + b) % b\n}\n\n/**\n * Thread radial profile: returns radial factor [0..1] at a given angular offset\n * from the thread peak. offset=0 → crest, offset=±π → root.\n * Uses a sinusoidal profile.\n */\nfunction threadProfileFactor(offset: number): number {\n  return (1 + Math.cos(offset)) / 2\n}\n\n/**\n * Generate screw geometry from parameters.\n * Internally Y-up (NASSCAD convention), then rotated to Z-up.\n * Thread ridge follows a helix: at each axial position, the crest occurs\n * at a specific angular phase; vertices near that phase get larger radius.\n *\n * @param params - the screw parameters (system, spec, thread, length, head, resolution).\n * @returns a Z-up BufferGeometry of the screw.\n */\nexport function makeScrew(params: ScrewParams): THREE.BufferGeometry {\n  const {\n    system,\n    specIdx,\n    thread,\n    pitchCustom,\n    length,\n    head,\n    nRad,\n  } = params\n\n  const spec = getScrewSpec(system, specIdx)\n  const pitch = threadToPitchMm(system, spec, thread, pitchCustom)\n  const rCrest = spec.dia / 2\n  const rRoot = thread === 'none' ? rCrest : rCrest * 0.85\n\n  // Number of axial rings\n  const nAxial = pitch > 0\n    ? Math.min(Math.round(length / pitch * N_PER_TURN), N_AX_MAX)\n    : 4\n  const nAxialClamped = Math.max(3, nAxial)\n\n  // Fade region rings for lead-in/lead-out\n  const fadeRings = Math.min(N_PER_TURN, Math.max(2, Math.floor(nAxialClamped * 0.12)))\n\n  // Head geometry\n  const hasHead = head !== 'none'\n  const headRings = hasHead ? Math.max(4, Math.floor(nRad / 4)) : 0\n  const totalRings = nAxialClamped + headRings\n\n  // Head dimensions (shared with BREP path via SCREW_HEAD_DIMS)\n  const headHeight = hasHead\n    ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.heightFactor : SCREW_HEAD_DIMS.chc.heightFactor)\n    : 0\n  const headRadius = hasHead\n    ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.radiusFactor : SCREW_HEAD_DIMS.chc.radiusFactor)\n    : 0\n\n  const vPos: number[] = []\n  const tris: number[] = []\n\n  // ---- Generate body rings ----\n  // Shank is centered: Y from -length/2 to +length/2 (head at +length/2 end)\n  for (let i = 0; i < nAxialClamped; i++) {\n    const t = nAxialClamped > 1 ? i / (nAxialClamped - 1) : 0\n    const axialPos = t * length - length / 2  // Y position (centered)\n\n    // Thread helix phase at this axial position\n    const threadPhase = pitch > 0 ? (axialPos / pitch) * 2 * Math.PI : 0\n\n    // Fade factor: thread depth ramps up/down\n    let fade = 1\n    if (i < fadeRings) {\n      fade = i / fadeRings\n    } else if (i > nAxialClamped - fadeRings) {\n      fade = (nAxialClamped - 1 - i) / (fadeRings - 1)\n    }\n    fade = Math.max(0, Math.min(1, fade))\n\n    for (let j = 0; j < nRad; j++) {\n      const phi = (j / nRad) * 2 * Math.PI\n\n      let r: number\n      if (thread === 'none') {\n        r = rCrest\n      } else {\n        // Angular offset from thread peak\n        const offset = modPos(phi - threadPhase + Math.PI, 2 * Math.PI) - Math.PI\n        const profile = threadProfileFactor(offset)\n        r = rRoot + (rCrest - rRoot) * profile * fade\n      }\n\n      const x = r * Math.cos(phi)\n      const z = r * Math.sin(phi)\n      vPos.push(x, axialPos, z)\n    }\n  }\n\n  // ---- Generate head rings ----\n  if (hasHead) {\n    for (let i = 0; i < headRings; i++) {\n      const t = headRings > 1 ? i / (headRings - 1) : 0\n      const axialPos = length / 2 + t * headHeight\n\n      for (let j = 0; j < nRad; j++) {\n        const phi = (j / nRad) * 2 * Math.PI\n\n        // Head blends from body-top radius to larger head radius\n        const headR = headRadius\n        const blend = Math.min(1, t * 2)\n        const r = rCrest + (headR - rCrest) * blend\n\n        let rx = r * Math.cos(phi)\n        let rz = r * Math.sin(phi)\n\n        if (head === 'hex') {\n          // Hex head: truncate to flat sides every 60°\n          // Circumscribed circle r acts as the \"corner-to-corner\" radius;\n          // the flat-to-flat distance is r * sqrt(3)\n          const flatAngle = Math.PI / 3\n          const seg = Math.floor(phi / flatAngle)\n          const angleInSeg = phi - seg * flatAngle\n          // Distance from center to flat side at this angle\n          const cornerR = r\n          const flatDist = cornerR * Math.cos(Math.PI / 6)  // flat-to-center distance\n          const cosToFlat = Math.abs(Math.cos(angleInSeg - flatAngle / 2))\n          const sideR = flatDist / Math.max(cosToFlat, 0.01)\n          rx = sideR * Math.cos(phi)\n          rz = sideR * Math.sin(phi)\n        }\n\n        vPos.push(rx, axialPos, rz)\n      }\n    }\n  }\n\n  // ---- Generate triangle indices ----\n  function ringVertex(ring: number, seg: number): number {\n    return ring * nRad + seg\n  }\n\n  // Connect adjacent rings\n  for (let i = 0; i < totalRings - 1; i++) {\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      const a = ringVertex(i, j)\n      const b = ringVertex(i, jNext)\n      const c = ringVertex(i + 1, j)\n      const d = ringVertex(i + 1, jNext)\n      // Reversed winding: (a,c,b) and (c,d,b) → outward normals\n      tris.push(a, c, b)\n      tris.push(c, d, b)\n    }\n  }\n\n  // Close top (cap) if no head\n  if (!hasHead && nAxialClamped > 1) {\n    const topRing = nAxialClamped - 1\n    const centerIdx = vPos.length / 3\n    vPos.push(0, length / 2, 0)  // centered: top is at +length/2\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext))\n    }\n  }\n\n  // Close bottom (always cap)\n  if (nAxialClamped > 1) {\n    const centerIdx = vPos.length / 3\n    vPos.push(0, -length / 2, 0)  // centered: bottom is at -length/2\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(0, jNext), centerIdx, ringVertex(0, j))\n    }\n  }\n\n  // Close head top\n  if (hasHead) {\n    const topRing = totalRings - 1\n    const centerIdx = vPos.length / 3\n    vPos.push(0, length / 2 + headHeight, 0)  // centered: head top at length/2 + headHeight\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext))\n    }\n  }\n\n  // ---- Build BufferGeometry and rotate to Z-up ----\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(vPos), 3))\n  geo.setIndex(new THREE.BufferAttribute(new Uint32Array(tris), 1))\n  geo.applyMatrix4(ROT_Y_TO_Z)\n\n  return geo\n}\n"]}
+{"version":3,"file":"screw.js","sourceRoot":"","sources":["../../../src/primitives/screw/screw.ts"],"names":[],"mappings":"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","sourcesContent":["import { Mat4 } from '../../math3d'\nimport { transformShape } from '../../mesh/meshdata/ops'\nimport type { GeoData } from '../../mesh/meshdata/parametric'\nimport type { ScrewParams } from './screw-db'\nimport { getScrewSpec, threadToPitchMm, SCREW_HEAD_DIMS } from './screw-db'\n\n/** Max axial rings */\nconst N_AX_MAX = 3200\n\n/** Rings per full turn */\nconst N_PER_TURN = 32\n\n/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */\nconst ROT_Y_TO_Z = new Mat4().makeRotationX(Math.PI / 2)\n\n/**\n * Modulo that always returns a positive result.\n */\nfunction modPos(a: number, b: number): number {\n  return ((a % b) + b) % b\n}\n\n/**\n * Thread radial profile: returns radial factor [0..1] at a given angular offset\n * from the thread peak. offset=0 → crest, offset=±π → root.\n * Uses a sinusoidal profile.\n */\nfunction threadProfileFactor(offset: number): number {\n  return (1 + Math.cos(offset)) / 2\n}\n\n/**\n * Generate screw geometry from parameters.\n * Internally Y-up (NASSCAD convention), then rotated to Z-up.\n * Thread ridge follows a helix: at each axial position, the crest occurs\n * at a specific angular phase; vertices near that phase get larger radius.\n *\n * @param params - the screw parameters (system, spec, thread, length, head, resolution).\n * @returns a Z-up GeoData of the screw.\n */\nexport function makeScrew(params: ScrewParams): GeoData {\n  const {\n    system,\n    specIdx,\n    thread,\n    pitchCustom,\n    length,\n    head,\n    nRad,\n  } = params\n\n  const spec = getScrewSpec(system, specIdx)\n  const pitch = threadToPitchMm(system, spec, thread, pitchCustom)\n  const rCrest = spec.dia / 2\n  const rRoot = thread === 'none' ? rCrest : rCrest * 0.85\n\n  // Number of axial rings\n  const nAxial = pitch > 0\n    ? Math.min(Math.round(length / pitch * N_PER_TURN), N_AX_MAX)\n    : 4\n  const nAxialClamped = Math.max(3, nAxial)\n\n  // Fade region rings for lead-in/lead-out\n  const fadeRings = Math.min(N_PER_TURN, Math.max(2, Math.floor(nAxialClamped * 0.12)))\n\n  // Head geometry\n  const hasHead = head !== 'none'\n  const headRings = hasHead ? Math.max(4, Math.floor(nRad / 4)) : 0\n  const totalRings = nAxialClamped + headRings\n\n  // Head dimensions (shared with BREP path via SCREW_HEAD_DIMS)\n  const headHeight = hasHead\n    ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.heightFactor : SCREW_HEAD_DIMS.chc.heightFactor)\n    : 0\n  const headRadius = hasHead\n    ? spec.dia * (head === 'hex' ? SCREW_HEAD_DIMS.hex.radiusFactor : SCREW_HEAD_DIMS.chc.radiusFactor)\n    : 0\n\n  const vPos: number[] = []\n  const tris: number[] = []\n\n  // ---- Generate body rings ----\n  // Shank is centered: Y from -length/2 to +length/2 (head at +length/2 end)\n  for (let i = 0; i < nAxialClamped; i++) {\n    const t = nAxialClamped > 1 ? i / (nAxialClamped - 1) : 0\n    const axialPos = t * length - length / 2  // Y position (centered)\n\n    // Thread helix phase at this axial position\n    const threadPhase = pitch > 0 ? (axialPos / pitch) * 2 * Math.PI : 0\n\n    // Fade factor: thread depth ramps up/down\n    let fade = 1\n    if (i < fadeRings) {\n      fade = i / fadeRings\n    } else if (i > nAxialClamped - fadeRings) {\n      fade = (nAxialClamped - 1 - i) / (fadeRings - 1)\n    }\n    fade = Math.max(0, Math.min(1, fade))\n\n    for (let j = 0; j < nRad; j++) {\n      const phi = (j / nRad) * 2 * Math.PI\n\n      let r: number\n      if (thread === 'none') {\n        r = rCrest\n      } else {\n        // Angular offset from thread peak\n        const offset = modPos(phi - threadPhase + Math.PI, 2 * Math.PI) - Math.PI\n        const profile = threadProfileFactor(offset)\n        r = rRoot + (rCrest - rRoot) * profile * fade\n      }\n\n      const x = r * Math.cos(phi)\n      const z = r * Math.sin(phi)\n      vPos.push(x, axialPos, z)\n    }\n  }\n\n  // ---- Generate head rings ----\n  if (hasHead) {\n    for (let i = 0; i < headRings; i++) {\n      const t = headRings > 1 ? i / (headRings - 1) : 0\n      const axialPos = length / 2 + t * headHeight\n\n      for (let j = 0; j < nRad; j++) {\n        const phi = (j / nRad) * 2 * Math.PI\n\n        // Head blends from body-top radius to larger head radius\n        const headR = headRadius\n        const blend = Math.min(1, t * 2)\n        const r = rCrest + (headR - rCrest) * blend\n\n        let rx = r * Math.cos(phi)\n        let rz = r * Math.sin(phi)\n\n        if (head === 'hex') {\n          // Hex head: truncate to flat sides every 60°\n          // Circumscribed circle r acts as the \"corner-to-corner\" radius;\n          // the flat-to-flat distance is r * sqrt(3)\n          const flatAngle = Math.PI / 3\n          const seg = Math.floor(phi / flatAngle)\n          const angleInSeg = phi - seg * flatAngle\n          // Distance from center to flat side at this angle\n          const cornerR = r\n          const flatDist = cornerR * Math.cos(Math.PI / 6)  // flat-to-center distance\n          const cosToFlat = Math.abs(Math.cos(angleInSeg - flatAngle / 2))\n          const sideR = flatDist / Math.max(cosToFlat, 0.01)\n          rx = sideR * Math.cos(phi)\n          rz = sideR * Math.sin(phi)\n        }\n\n        vPos.push(rx, axialPos, rz)\n      }\n    }\n  }\n\n  // ---- Generate triangle indices ----\n  function ringVertex(ring: number, seg: number): number {\n    return ring * nRad + seg\n  }\n\n  // Connect adjacent rings\n  for (let i = 0; i < totalRings - 1; i++) {\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      const a = ringVertex(i, j)\n      const b = ringVertex(i, jNext)\n      const c = ringVertex(i + 1, j)\n      const d = ringVertex(i + 1, jNext)\n      // Reversed winding: (a,c,b) and (c,d,b) → outward normals\n      tris.push(a, c, b)\n      tris.push(c, d, b)\n    }\n  }\n\n  // Close top (cap) if no head\n  if (!hasHead && nAxialClamped > 1) {\n    const topRing = nAxialClamped - 1\n    const centerIdx = vPos.length / 3\n    vPos.push(0, length / 2, 0)  // centered: top is at +length/2\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext))\n    }\n  }\n\n  // Close bottom (always cap)\n  if (nAxialClamped > 1) {\n    const centerIdx = vPos.length / 3\n    vPos.push(0, -length / 2, 0)  // centered: bottom is at -length/2\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(0, jNext), centerIdx, ringVertex(0, j))\n    }\n  }\n\n  // Close head top\n  if (hasHead) {\n    const topRing = totalRings - 1\n    const centerIdx = vPos.length / 3\n    vPos.push(0, length / 2 + headHeight, 0)  // centered: head top at length/2 + headHeight\n    for (let j = 0; j < nRad; j++) {\n      const jNext = (j + 1) % nRad\n      tris.push(ringVertex(topRing, j), centerIdx, ringVertex(topRing, jNext))\n    }\n  }\n\n  // ---- Build GeoData and rotate to Z-up ----\n  const geo: GeoData = {\n    positions: new Float32Array(vPos),\n    indices: new Uint32Array(tris),\n  }\n  return transformShape(geo, ROT_Y_TO_Z) as GeoData\n}\n"]}

package/dist/runtime-state.d.ts

@@ -36,6 +36,18 @@ export interface ExecutionAnchor {
  * （2026-09-22 核实：无独立守卫测试。）
  */
 export type RuntimeExecutionMode = 'auto' | 'brep' | 'mesh';
+/**
+ * 宿主环境（与 src/cad-runtime/ports.ts 的 `HostEnv` 保持一致）。
+ *
+ * 重复定义的理由与 `RuntimeExecutionMode` 相同：本模块零依赖。一致性由
+ * `cad-runtime/runtime.ts` 的 `get hostEnv() { return portsOf().hostEnv }`
+ * 在编译期间接钉住——只给一侧加成员而另一侧不加 → 该行 tsc 报错。
+ *
+ * 用途：导出命令（`cad.exportStl` / `cad.exportBrep`）只在 `'node'` 宿主开放，
+ * 其余值（含未声明）执行即报 `E_HOST_UNSUPPORTED`。判据是端口装配期声明的事实，
+ * 不做运行期环境探测。
+ */
+export type RuntimeHostEnv = 'node' | 'browser' | 'weapp';
 /** 宿主注入的环境资源。字段类型用宽松结构，避免本模块依赖具体实现。 */
 export interface Backends {
     /** 契约版本（装配期校验，不兼容即抛错） */
@@ -43,38 +55,14 @@ export interface Backends {
     /** 执行配置（可变对象，宿主可在运行期切换） */
     readonly config: {
         mode: RuntimeExecutionMode;
-        /** 当前 BREP 引擎 id（注册表首个注册者；未注册为 null）。能力路由读（§8.4）。 */
+        /** 当前 BREP 引擎 id（注册表首个注册者；未注册为 null）。静态判据（引擎身份）读。 */
         brepEngineId?: string | null;
         /**
-         * 当前引擎能力声明（宽松结构，零依赖）。能力路由读（§8.4）。
-         *
-         * `evolution` = 本引擎**实际提供**的 `*WithHistory` 核函数名名单
-         * （`brep/engine/types.ts` 的 `BrepEvolutionKind`）。**不是**族级布尔——
-         * 族级布尔会多报能力、使静态判定失效（Phase 0.2）。
-         * 本模块须零依赖，故此处只写 `readonly string[]`；权威类型见
-         * `BrepCapabilities`，消费侧由 `backend-dispatch.engineCapabilitySet` 归一化。
+         * 宿主环境（端口装配期声明的事实；未声明 = undefined）。静态判据（导出命令的
+         * 宿主门，`api/internal/l3-bridge.ts#assertHostFor`）读；与执行模式 / 引擎身份
+         * 正交，不做运行期探测。
          */
-        brepCapabilities?: {
-            evolution?: readonly string[];
-            /**
-             * 非演化内核方法名（D5）：本引擎**实际提供**的 L1 中立方法名
-             * （`getBoundingBox` / `getVolume` / `getSurfaceArea` / `getLength` /
-             * `getCenterOfMass` 等）。2026-09-24 narrowing plan §2.4：与
-             * `backend-dispatch.EngineCapabilitiesLike` 对齐（该类型有 `methods`，
-             * 运行时配置镜像此前缺失——非字面量赋值不做 excess property 检查，
-             * `methods` 判定"能用但没被契约钉住"）。
-             */
-            methods?: readonly string[];
-            heal?: boolean;
-            directEdit?: boolean;
-            advSurface?: boolean;
-            assembly?: boolean;
-            meshLift?: boolean;
-        };
-        partTransform?: {
-            position: [number, number, number];
-            scale?: [number, number, number];
-        };
+        hostEnv?: RuntimeHostEnv;
     };
     /** 几何后端。brep 引擎异步初始化 → 用 getter。 */
     readonly kernel: {
@@ -152,6 +140,27 @@ export declare class MeshUnsupportedError extends Error {
     readonly stmt?: ExecutionAnchor;
     constructor(message: string, stmt?: ExecutionAnchor);
 }
+/**
+ * 宿主环境不支持错误——导出命令只在 node 宿主开放。
+ *
+ * 与 BrepUnsupportedError / MeshUnsupportedError 并列的第三类「执行前静态拒绝」：
+ * 由 API 侧的断言器（`api/internal/l3-bridge.ts#assertHostFor`）在实现体之前抛出，
+ * 不经 dispatchPath、不做运行期回退。CadRuntime 捕获后转换为
+ * ExecutionResult.failedAt，`failedAt.code` 取本类的 `code`。
+ *
+ * 定义在本层（零依赖）以便 L3 API 面与引擎共享同一类（instanceof 判定）。
+ *
+ * 判据是「脚本可由 AI 生成任意代码、属不受信输入」：导出把「往哪写、写几份、
+ * 写什么」的决定权交给脚本文本，浏览器 / 小程序里这种动作必须由宿主入口触发
+ * （用户点的按钮，或宿主自己调用的库面字节通道）。
+ */
+export declare class HostUnsupportedError extends Error {
+    /** 语句锚点（引擎在语句执行前设置，与兄弟错误类同构）。 */
+    readonly stmt?: ExecutionAnchor;
+    /** 稳定错误码（落进 ExecutionResult.failedAt.code，供宿主程序化区分错误种类）。 */
+    readonly code = "E_HOST_UNSUPPORTED";
+    constructor(message: string, stmt?: ExecutionAnchor);
+}
 /**
  * The global runtime state singleton: backend configuration, the currently
  * executing statement, and the Shape identity tables (constructor registry,
@@ -171,6 +180,8 @@ export interface FaijsRuntimeState {
     readonly shapeToName: WeakMap<object, PartName>;
     /** 同语句 lineage 去重标记（define-op 写入；语句边界 setCurrentStmt 重置）。 */
     registeredStmtId: StmtId | undefined;
+    /** 宿主配置的全局三角化密度（createRuntime 写入；未配置为 undefined）。 */
+    tessellation: TessellationDensity | undefined;
 }
 /** 进入函数 BREP 域（DirectExecutor 执行 local 语句 fn 之前调用）。 */
 export declare function enterFunctionBrep(): void;
@@ -280,6 +291,29 @@ export declare function takePendingAssemblyKinematics(): Array<{
  * @returns the shared global runtime state singleton.
  */
 export declare function getRuntimeState(): FaijsRuntimeState;
+/**
+ * Host-tunable tessellation density for BREP triangulation defaults.
+ * Maps to OpenSCAD $fa (angularDeflection, radians) / $fs (linearDeflection, mm).
+ */
+export interface TessellationDensity {
+    /** Angular deflection in radians (OpenSCAD $fa converted to rad). Default 2π/64. */
+    angularDeflection?: number;
+    /** Linear deflection in mm (OpenSCAD $fs). Default 0.1. */
+    linearDeflection?: number;
+}
+/**
+ * Read the host-configured tessellation density (missing fields fall back to
+ * the built-in defaults: 2π/64 rad angular, 0.1 mm linear). Pure read — no
+ * throw when unset (unlike getBackends, density is an optional tuning knob).
+ * @returns the effective density with both fields filled (never undefined).
+ */
+export declare function getTessellation(): Required<TessellationDensity>;
+/**
+ * Host/runtime sets the global tessellation density at construction time.
+ * Values must be positive; a mis-set knob is a host bug and must surface here.
+ * @param tessellation - the density to set; undefined fields keep the built-in default.
+ */
+export declare function configureTessellation(tessellation: TessellationDensity): void;
 /**
  * 宿主在启动时调用一次，注入环境资源。
  *

package/dist/runtime-state.d.ts.map

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

package/dist/runtime-state.js

@@ -68,6 +68,31 @@ export class MeshUnsupportedError extends Error {
         this.stmt = stmt;
     }
 }
+/**
+ * 宿主环境不支持错误——导出命令只在 node 宿主开放。
+ *
+ * 与 BrepUnsupportedError / MeshUnsupportedError 并列的第三类「执行前静态拒绝」：
+ * 由 API 侧的断言器（`api/internal/l3-bridge.ts#assertHostFor`）在实现体之前抛出，
+ * 不经 dispatchPath、不做运行期回退。CadRuntime 捕获后转换为
+ * ExecutionResult.failedAt，`failedAt.code` 取本类的 `code`。
+ *
+ * 定义在本层（零依赖）以便 L3 API 面与引擎共享同一类（instanceof 判定）。
+ *
+ * 判据是「脚本可由 AI 生成任意代码、属不受信输入」：导出把「往哪写、写几份、
+ * 写什么」的决定权交给脚本文本，浏览器 / 小程序里这种动作必须由宿主入口触发
+ * （用户点的按钮，或宿主自己调用的库面字节通道）。
+ */
+export class HostUnsupportedError extends Error {
+    /** 语句锚点（引擎在语句执行前设置，与兄弟错误类同构）。 */
+    stmt;
+    /** 稳定错误码（落进 ExecutionResult.failedAt.code，供宿主程序化区分错误种类）。 */
+    code = 'E_HOST_UNSUPPORTED';
+    constructor(message, stmt) {
+        super(message);
+        this.name = 'HostUnsupportedError';
+        this.stmt = stmt;
+    }
+}
 // ── 函数 BREP 域（控制流放松方案 §5.6 / D13） ──
 // 本机函数体内的瞬态 BREP 句柄：进入函数时开启登记域，op 输出句柄写入时经
 // registerFunctionBrep 登记；函数返回后引擎取走域、释放除返回值可到达句柄外的全部
@@ -198,10 +223,42 @@ export function getRuntimeState() {
         slots: new WeakMap(),
         shapeToName: new WeakMap(),
         registeredStmtId: undefined,
+        tessellation: undefined,
     };
     g[KEY] = created;
     return created;
 }
+const DEFAULT_TESSELLATION_ANGULAR = (2 * Math.PI) / 64;
+// Inlined 0.1 mm default — this file must not import src modules (zero-dep layer);
+// mirrors DEFAULT_LINEAR_DEFLECTION (tolerance.ts).
+const DEFAULT_TESSELLATION_LINEAR_MM = 0.1;
+/**
+ * Read the host-configured tessellation density (missing fields fall back to
+ * the built-in defaults: 2π/64 rad angular, 0.1 mm linear). Pure read — no
+ * throw when unset (unlike getBackends, density is an optional tuning knob).
+ * @returns the effective density with both fields filled (never undefined).
+ */
+export function getTessellation() {
+    const t = getRuntimeState().tessellation;
+    return {
+        angularDeflection: t?.angularDeflection ?? DEFAULT_TESSELLATION_ANGULAR,
+        linearDeflection: t?.linearDeflection ?? DEFAULT_TESSELLATION_LINEAR_MM,
+    };
+}
+/**
+ * Host/runtime sets the global tessellation density at construction time.
+ * Values must be positive; a mis-set knob is a host bug and must surface here.
+ * @param tessellation - the density to set; undefined fields keep the built-in default.
+ */
+export function configureTessellation(tessellation) {
+    if (tessellation.angularDeflection !== undefined && !(tessellation.angularDeflection > 0)) {
+        throw new Error('[faijs] tessellation.angularDeflection must be > 0');
+    }
+    if (tessellation.linearDeflection !== undefined && !(tessellation.linearDeflection > 0)) {
+        throw new Error('[faijs] tessellation.linearDeflection must be > 0');
+    }
+    getRuntimeState().tessellation = { ...tessellation };
+}
 // ── 后端配置读写 ──
 /**
  * 宿主在启动时调用一次，注入环境资源。