@faicad/faijs 0.13.0

package/dist/mesh/transform.d.ts

@@ -0,0 +1,57 @@
+/**
+ * mesh 变换 API
+ *
+ * 提取来源：
+ * - engine/mesh-simplify/proxy-mesh-cache.ts (transformMeshData)
+ * - engine-store.partTransforms
+ *
+ * 变换语义（烘焙执行引擎）：
+ * - translate/rotate_euler/scale3d 直接烘焙顶点（修改 positions）
+ * - 执行器（dispatcher / runtime.execute）调用这些函数将变换烘焙进几何
+ * - 交互拖拽期间的预览仍由 partTransforms（渲染层瞬态）承担
+ *   确认后由引擎重放语句完成烘焙（P2）
+ */
+import * as THREE from 'three';
+import type { Shape, Vec3 } from './types.js';
+/**
+ * Translate a mesh shape by baking the offset into its vertices.
+ * @param shape - the mesh shape to translate.
+ * @param offset - translation vector in mm.
+ * @returns a new shape moved by the given offset.
+ */
+export declare function translate(shape: Shape, offset: Vec3): Shape;
+/**
+ * Rotate a mesh shape by baking the rotation into its vertices (angles in
+ * degrees, optionally about a pivot).
+ * @param shape - the mesh shape to rotate.
+ * @param anglesDeg - XYZ Euler angles in degrees.
+ * @param pivot - optional rotation pivot point in mm.
+ * @returns a new shape with rotated vertices.
+ */
+export declare function rotate_euler(shape: Shape, anglesDeg: Vec3, pivot?: Vec3): Shape;
+/**
+ * Scale a mesh shape by baking the factor into its vertices.
+ * @param shape - the mesh shape to scale.
+ * @param factor - uniform scale factor or per-axis (x, y, z) factors.
+ * @param center - optional fixed point of the scaling (P6 §4.6; default origin).
+ * @returns a new shape with scaled vertices.
+ */
+export declare function scale3d(shape: Shape, factor: number | Vec3, center?: Vec3): Shape;
+/**
+ * Uniformly scale a mesh shape (brepjs `scale` 契约，P6 §4.6)。后台用
+ * `scale3d` 的等比参数；`center` 为缩放不动的点，默认原点。
+ * @param shape - the mesh shape to scale.
+ * @param factor - uniform scale factor (> 0).
+ * @param center - optional fixed point of the scaling (default origin).
+ * @returns a new shape with uniformly scaled vertices.
+ */
+export declare function scale(shape: Shape, factor: number, center?: Vec3): Shape;
+/**
+ * Transform a mesh shape with an arbitrary THREE.Matrix4 (corresponds to the
+ * existing transformMeshData function).
+ * @param shape - the mesh shape to transform.
+ * @param matrix - the 4x4 transform matrix to apply.
+ * @returns a new shape with transformed vertices.
+ */
+export declare function transformMatrix(shape: Shape, matrix: THREE.Matrix4): Shape;
+//# sourceMappingURL=transform.d.ts.map

package/dist/mesh/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/mesh/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAE1C;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAG,KAAK,CAQ3D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAY/E;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,KAAK,CAIjF;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,KAAK,CAExE;AA0BD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAE1E"}

package/dist/mesh/transform.js

@@ -0,0 +1,102 @@
+/**
+ * mesh 变换 API
+ *
+ * 提取来源：
+ * - engine/mesh-simplify/proxy-mesh-cache.ts (transformMeshData)
+ * - engine-store.partTransforms
+ *
+ * 变换语义（烘焙执行引擎）：
+ * - translate/rotate_euler/scale3d 直接烘焙顶点（修改 positions）
+ * - 执行器（dispatcher / runtime.execute）调用这些函数将变换烘焙进几何
+ * - 交互拖拽期间的预览仍由 partTransforms（渲染层瞬态）承担
+ *   确认后由引擎重放语句完成烘焙（P2）
+ */
+import * as THREE from 'three';
+/**
+ * Translate a mesh shape by baking the offset into its vertices.
+ * @param shape - the mesh shape to translate.
+ * @param offset - translation vector in mm.
+ * @returns a new shape moved by the given offset.
+ */
+export function translate(shape, offset) {
+    const positions = new Float32Array(shape.positions);
+    for (let i = 0; i < positions.length; i += 3) {
+        positions[i] += offset[0];
+        positions[i + 1] += offset[1];
+        positions[i + 2] += offset[2];
+    }
+    return { positions, indices: shape.indices };
+}
+/**
+ * Rotate a mesh shape by baking the rotation into its vertices (angles in
+ * degrees, optionally about a pivot).
+ * @param shape - the mesh shape to rotate.
+ * @param anglesDeg - XYZ Euler angles in degrees.
+ * @param pivot - optional rotation pivot point in mm.
+ * @returns a new shape with rotated vertices.
+ */
+export function rotate_euler(shape, anglesDeg, pivot) {
+    const euler = new THREE.Euler((anglesDeg[0] * Math.PI) / 180, (anglesDeg[1] * Math.PI) / 180, (anglesDeg[2] * Math.PI) / 180);
+    const matrix = new THREE.Matrix4().makeRotationFromEuler(euler);
+    if (pivot) {
+        matrix.premultiply(new THREE.Matrix4().makeTranslation(pivot[0], pivot[1], pivot[2]));
+        matrix.multiply(new THREE.Matrix4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]));
+    }
+    return applyMatrix(shape, matrix);
+}
+/**
+ * Scale a mesh shape by baking the factor into its vertices.
+ * @param shape - the mesh shape to scale.
+ * @param factor - uniform scale factor or per-axis (x, y, z) factors.
+ * @param center - optional fixed point of the scaling (P6 §4.6; default origin).
+ * @returns a new shape with scaled vertices.
+ */
+export function scale3d(shape, factor, center) {
+    const f = typeof factor === 'number' ? [factor, factor, factor] : [factor[0], factor[1], factor[2]];
+    return applyMatrix(shape, scaleMatrix(f, center));
+}
+/**
+ * Uniformly scale a mesh shape (brepjs `scale` 契约，P6 §4.6)。后台用
+ * `scale3d` 的等比参数；`center` 为缩放不动的点，默认原点。
+ * @param shape - the mesh shape to scale.
+ * @param factor - uniform scale factor (> 0).
+ * @param center - optional fixed point of the scaling (default origin).
+ * @returns a new shape with uniformly scaled vertices.
+ */
+export function scale(shape, factor, center) {
+    return applyMatrix(shape, scaleMatrix([factor, factor, factor], center));
+}
+/** 缩放矩阵：围绕 `center`（缺省原点）构造 T(c)·S·T(−c)。 */
+function scaleMatrix(f, center) {
+    const s = new THREE.Matrix4().makeScale(f[0], f[1], f[2]);
+    if (!center)
+        return s;
+    return new THREE.Matrix4()
+        .makeTranslation(center[0], center[1], center[2])
+        .multiply(s)
+        .multiply(new THREE.Matrix4().makeTranslation(-center[0], -center[1], -center[2]));
+}
+/** 用 THREE.Matrix4 变换几何 */
+function applyMatrix(shape, matrix) {
+    const positions = new Float32Array(shape.positions);
+    const v = new THREE.Vector3();
+    for (let i = 0; i < positions.length; i += 3) {
+        v.set(positions[i], positions[i + 1], positions[i + 2]);
+        v.applyMatrix4(matrix);
+        positions[i] = v.x;
+        positions[i + 1] = v.y;
+        positions[i + 2] = v.z;
+    }
+    return { positions, indices: shape.indices };
+}
+/**
+ * Transform a mesh shape with an arbitrary THREE.Matrix4 (corresponds to the
+ * existing transformMeshData function).
+ * @param shape - the mesh shape to transform.
+ * @param matrix - the 4x4 transform matrix to apply.
+ * @returns a new shape with transformed vertices.
+ */
+export function transformMatrix(shape, matrix) {
+    return applyMatrix(shape, matrix);
+}
+//# sourceMappingURL=transform.js.map

package/dist/mesh/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/mesh/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAY,EAAE,MAAY;IAClD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,SAAS,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;QACzB,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;QAC7B,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;AAC9C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAY,EAAE,SAAe,EAAE,KAAY;IACtE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAC3B,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,EAC9B,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,EAC9B,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAC/B,CAAA;IACD,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAC/D,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACrF,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AACnC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAY,EAAE,MAAqB,EAAE,MAAa;IACxE,MAAM,CAAC,GACL,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3F,OAAO,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,KAAY,EAAE,MAAc,EAAE,MAAa;IAC/D,OAAO,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED,6CAA6C;AAC7C,SAAS,WAAW,CAAC,CAA2B,EAAE,MAAa;IAC7D,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACzD,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,CAAA;IACrB,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;SACvB,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;SAChD,QAAQ,CAAC,CAAC,CAAC;SACX,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACtF,CAAC;AAED,2BAA2B;AAC3B,SAAS,WAAW,CAAC,KAAY,EAAE,MAAqB;IACtD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IACnD,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAA;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACvD,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;QACtB,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAClB,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QACtB,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAA;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAY,EAAE,MAAqB;IACjE,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AACnC,CAAC","sourcesContent":["/**\n * mesh 变换 API\n *\n * 提取来源：\n * - engine/mesh-simplify/proxy-mesh-cache.ts (transformMeshData)\n * - engine-store.partTransforms\n *\n * 变换语义（烘焙执行引擎）：\n * - translate/rotate_euler/scale3d 直接烘焙顶点（修改 positions）\n * - 执行器（dispatcher / runtime.execute）调用这些函数将变换烘焙进几何\n * - 交互拖拽期间的预览仍由 partTransforms（渲染层瞬态）承担\n *   确认后由引擎重放语句完成烘焙（P2）\n */\n\nimport * as THREE from 'three'\nimport type { Shape, Vec3 } from './types'\n\n/**\n * Translate a mesh shape by baking the offset into its vertices.\n * @param shape - the mesh shape to translate.\n * @param offset - translation vector in mm.\n * @returns a new shape moved by the given offset.\n */\nexport function translate(shape: Shape, offset: Vec3): Shape {\n  const positions = new Float32Array(shape.positions)\n  for (let i = 0; i < positions.length; i += 3) {\n    positions[i] += offset[0]\n    positions[i + 1] += offset[1]\n    positions[i + 2] += offset[2]\n  }\n  return { positions, indices: shape.indices }\n}\n\n/**\n * Rotate a mesh shape by baking the rotation into its vertices (angles in\n * degrees, optionally about a pivot).\n * @param shape - the mesh shape to rotate.\n * @param anglesDeg - XYZ Euler angles in degrees.\n * @param pivot - optional rotation pivot point in mm.\n * @returns a new shape with rotated vertices.\n */\nexport function rotate_euler(shape: Shape, anglesDeg: Vec3, pivot?: Vec3): Shape {\n  const euler = new THREE.Euler(\n    (anglesDeg[0] * Math.PI) / 180,\n    (anglesDeg[1] * Math.PI) / 180,\n    (anglesDeg[2] * Math.PI) / 180,\n  )\n  const matrix = new THREE.Matrix4().makeRotationFromEuler(euler)\n  if (pivot) {\n    matrix.premultiply(new THREE.Matrix4().makeTranslation(pivot[0], pivot[1], pivot[2]))\n    matrix.multiply(new THREE.Matrix4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]))\n  }\n  return applyMatrix(shape, matrix)\n}\n\n/**\n * Scale a mesh shape by baking the factor into its vertices.\n * @param shape - the mesh shape to scale.\n * @param factor - uniform scale factor or per-axis (x, y, z) factors.\n * @param center - optional fixed point of the scaling (P6 §4.6; default origin).\n * @returns a new shape with scaled vertices.\n */\nexport function scale3d(shape: Shape, factor: number | Vec3, center?: Vec3): Shape {\n  const f: [number, number, number] =\n    typeof factor === 'number' ? [factor, factor, factor] : [factor[0], factor[1], factor[2]]\n  return applyMatrix(shape, scaleMatrix(f, center))\n}\n\n/**\n * Uniformly scale a mesh shape (brepjs `scale` 契约，P6 §4.6)。后台用\n * `scale3d` 的等比参数；`center` 为缩放不动的点，默认原点。\n * @param shape - the mesh shape to scale.\n * @param factor - uniform scale factor (> 0).\n * @param center - optional fixed point of the scaling (default origin).\n * @returns a new shape with uniformly scaled vertices.\n */\nexport function scale(shape: Shape, factor: number, center?: Vec3): Shape {\n  return applyMatrix(shape, scaleMatrix([factor, factor, factor], center))\n}\n\n/** 缩放矩阵：围绕 `center`（缺省原点）构造 T(c)·S·T(−c)。 */\nfunction scaleMatrix(f: [number, number, number], center?: Vec3): THREE.Matrix4 {\n  const s = new THREE.Matrix4().makeScale(f[0], f[1], f[2])\n  if (!center) return s\n  return new THREE.Matrix4()\n    .makeTranslation(center[0], center[1], center[2])\n    .multiply(s)\n    .multiply(new THREE.Matrix4().makeTranslation(-center[0], -center[1], -center[2]))\n}\n\n/** 用 THREE.Matrix4 变换几何 */\nfunction applyMatrix(shape: Shape, matrix: THREE.Matrix4): Shape {\n  const positions = new Float32Array(shape.positions)\n  const v = new THREE.Vector3()\n  for (let i = 0; i < positions.length; i += 3) {\n    v.set(positions[i], positions[i + 1], positions[i + 2])\n    v.applyMatrix4(matrix)\n    positions[i] = v.x\n    positions[i + 1] = v.y\n    positions[i + 2] = v.z\n  }\n  return { positions, indices: shape.indices }\n}\n\n/**\n * Transform a mesh shape with an arbitrary THREE.Matrix4 (corresponds to the\n * existing transformMeshData function).\n * @param shape - the mesh shape to transform.\n * @param matrix - the 4x4 transform matrix to apply.\n * @returns a new shape with transformed vertices.\n */\nexport function transformMatrix(shape: Shape, matrix: THREE.Matrix4): Shape {\n  return applyMatrix(shape, matrix)\n}\n"]}

package/dist/mesh/types.d.ts

@@ -0,0 +1,279 @@
+/**
+ * mesh 类型定义 — 纯数据几何 API 的类型契约
+ *
+ * 设计原则（§5.1）：
+ * - 全部纯数据：输入输出是 ManifoldMeshData 或 JSON 值，不碰 THREE 场景、不读 store
+ * - 不可变：每个 API 返回新几何，不修改输入
+ * - 坐标系：右手系 +Z 向上、毫米、角度用度
+ * - 坐标空间：所有 API 输入/输出均为**世界空间** ManifoldMeshData
+ *   （局部↔世界变换由执行器负责，mesh 不感知 mesh.matrixWorld）
+ *
+ * P1 阶段 Shape = ManifoldMeshData（无 worker）。
+ * P3+ 阶段 Shape 将变为 worker 内 Manifold 对象的句柄。
+ */
+export type Vec3 = [number, number, number];
+/**
+ * A JSON-serializable value: scalar, null, array, or plain object.
+ */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [k: string]: JsonValue;
+};
+/**
+ * A mesh shape — the core data type of the mesh API.
+ *
+ * Shape is defined directly in mesh/types.ts rather than re-exported from
+ * ops/types.ts; ops/types.ts imports it from here, removing the type cycle.
+ */
+export interface Shape {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * Structural guard: returns true when the value looks like a mesh Shape
+ * (duck-typed via positions/indices, with no requirements on third-party
+ * types).
+ *
+ * Per the keep-syntax design, hosts use this guard to distinguish mesh Shapes
+ * from compounds when consuming ExecutionResult.outputs, in the same style as
+ * the runtime-internal isShapeLike.
+ * @param v - the value to test.
+ * @returns true when the value is a mesh Shape.
+ */
+export declare function isMeshShape(v: unknown): v is Shape;
+/** Default radial segment count used for rounded geometry. */
+export declare const NRAD_DEFAULT = 64;
+/** Minimum allowed radial segment count. */
+export declare const NRAD_MIN = 3;
+/** Maximum allowed radial segment count. */
+export declare const NRAD_MAX = 128;
+/**
+ * Clamp an nRad value into the legal range [NRAD_MIN, NRAD_MAX], rounding to
+ * the nearest integer; undefined falls back to NRAD_DEFAULT.
+ * @param n - the requested radial segment count, or undefined.
+ * @returns the clamped radial segment count.
+ */
+export declare function clampNRad(n: number | undefined): number;
+/**
+ * Parameters for creating a box (brepjs `box(width, depth, height, {at?, centered?, segments?})`
+ * contract, §4.1 A 决策). Default: min-corner at the origin. `centered: true` shifts so the
+ * box is centered at the origin; `at` is CENTER semantics and takes precedence over `centered`.
+ */
+export interface BoxParams {
+    /** Side length along X (mm). */
+    width: number;
+    /** Side length along Y (mm). */
+    depth: number;
+    /** Side length along Z (mm). */
+    height: number;
+    /** Center position (brepjs `at`, CENTER semantics); takes precedence over `centered`. */
+    at?: Vec3;
+    /** Center the box at the origin when `at` is absent. Default: false (min-corner at origin). */
+    centered?: boolean;
+    /** Tessellation segment count (box: affects only brep/mesh tessellation, not topology). */
+    segments?: number;
+    /** Internal historical alias for `segments` (accepted by clampNRad, §5.1). */
+    nRad?: number;
+}
+/** Parameters for creating a sphere. */
+export interface SphereParams {
+    radius: number;
+    segments?: number;
+    center?: Vec3;
+    nRad?: number;
+}
+/** Parameters for creating a cylinder (brepjs contract, §4.3 A). */
+export interface CylinderParams {
+    /** Radius (mm). */
+    radius: number;
+    /** Height along +Z (mm). */
+    height: number;
+    /** Base circle center (brepjs `at`, BASE semantics; default [0, 0, 0]). */
+    at?: Vec3;
+    /** Center the cylinder (base at −h/2 / center at `at`) instead of base at `at`/origin. */
+    centered?: boolean;
+    /** Tessellation segment count (cylinder: affects only tessellation, not topology). */
+    segments?: number;
+    /** Internal historical alias for `segments` (accepted by clampNRad, §5.1). */
+    nRad?: number;
+}
+/** Parameters for creating a cone (or a truncated cone). */
+export interface ConeParams {
+    /** Radius at the base (mm). */
+    radiusBottom: number;
+    /** Radius at the top (mm); 0 for a pointed cone, === radiusBottom for a cylinder. */
+    radiusTop: number;
+    /** Height along +Z (mm). */
+    height: number;
+    /** Base circle center (brepjs `at`, BASE semantics; default [0, 0, 0]). */
+    at?: Vec3;
+    /** Center the cone (base at −h/2 / center at `at`) instead of base at `at`/origin. */
+    centered?: boolean;
+    /** Tessellation segment count (cone: affects only mere tessellation, not topology). */
+    segments?: number;
+    /** Internal historical alias for `segments` (accepted by clampNRad, §5.1). */
+    nRad?: number;
+}
+/**
+ * Parameters for creating a wedge (trapezoidal prism).
+ */
+export interface WedgeParams {
+    /** Width of the base edge (mm), along the Y axis. */
+    width: number;
+    /** Height of the trapezoid (mm), along the Z axis. */
+    height: number;
+    /** Angle between the base edge and the slope (degrees). */
+    angle: number;
+    /** Total extrusion length (mm), along the X axis. */
+    length: number;
+    center?: Vec3;
+    nRad?: number;
+}
+/** Parameters for creating 3D text. */
+export interface TextParams {
+    text: string;
+    size: number;
+    depth: number;
+}
+/** Parameters for extruding an SVG into a solid. */
+export interface SvgExtrudeParams {
+    svg: string;
+    depth: number;
+    targetLongSide: number;
+    naturalWidth?: number;
+    naturalHeight?: number;
+}
+/** Parameters for building a solid from an SDF (signed distance function). */
+export interface SdfParams {
+    code: string;
+    box?: [Vec3, Vec3];
+    resolution?: number;
+    params?: Record<string, number>;
+}
+/** Parameters for translating a shape. */
+export interface TranslateParams {
+    offset: Vec3;
+}
+/** Parameters for rotating a shape. */
+export interface RotateParams {
+    anglesDeg: Vec3;
+    pivot?: Vec3;
+}
+/** Parameters for scaling a shape. */
+export interface ScaleParams {
+    factor: number | Vec3;
+}
+/** Kinds of binary boolean operations. */
+export type BooleanOperation = 'union' | 'subtract' | 'intersect';
+/** A cutting plane defined by a unit normal and a signed offset. */
+export interface SplitPlane {
+    normal: Vec3;
+    offset: number;
+}
+/** Parameters for a dovetail split, including the cutting plane setup. */
+export interface DovetailSplitParams {
+    plane: SplitPlane;
+    planeCenter: Vec3;
+    widthDir: Vec3;
+    bboxWidthOnWidthDir: number;
+    groove: {
+        depth: number;
+        depthTolerance: number;
+        width: number;
+        widthTolerance: number;
+        flapsAngle: number;
+    };
+}
+/** Parameters for a dowel-pin split, including the cutting plane setup. */
+export interface DowelSplitParams {
+    plane: SplitPlane;
+    planeCenter: Vec3;
+    widthDir: Vec3;
+    dowel: {
+        diameter: number;
+        diameterTolerance: number;
+        height: number;
+        heightTolerance: number;
+    };
+    selectedSections?: number[] | null;
+}
+/** Parameters for a straight-tenon split, including the cutting plane setup. */
+export interface TenonSplitParams {
+    plane: SplitPlane;
+    planeCenter: Vec3;
+    widthDir: Vec3;
+    tenon: {
+        sideLength: number;
+        sideLengthTolerance: number;
+        height: number;
+        heightTolerance: number;
+    };
+    selectedSections?: number[] | null;
+}
+/** Result of a joinery split: the two halves plus the cut-out wedge. */
+export interface SplitResult {
+    front: Shape;
+    back: Shape;
+    wedge: Shape | null;
+}
+/** Parameters for drilling a hole. */
+export interface DrillParams {
+    diameter: number;
+    depth?: number;
+    type: 'through' | 'blind';
+    position: Vec3;
+    direction: Vec3;
+    faceNormal: Vec3;
+    tolerance?: number;
+    holeType?: 'simple' | 'screw';
+    screwSystem?: string;
+    screwSpecIdx?: number;
+    screwThread?: string;
+    screwHead?: string;
+}
+/** Parameters for extruding a face bounded by a plane. */
+export interface ExtrudeParams {
+    normal: Vec3;
+    originOffset: number;
+    length: number;
+    mode?: 'centered' | 'forward' | 'backward';
+}
+/** Parameters for engraving text or an SVG onto a face. */
+export interface EngraveParams {
+    mode: 'convex' | 'concave';
+    depth: number;
+    face: {
+        center: Vec3;
+        normal: Vec3;
+    };
+    text?: string;
+    textSize?: number;
+    svg?: string;
+    svgNaturalWidth?: number;
+    svgNaturalHeight?: number;
+    svgSize?: number;
+}
+/** Parameters for applying a knurl texture to a face. */
+export interface KnurlParams {
+    face: {
+        center: Vec3;
+        normal: Vec3;
+    };
+    knurlTextureHeight: number;
+    knurlInvertDisplacement: boolean;
+    knurlRefineLength: number;
+    knurlScaleU: number;
+    knurlScaleV: number;
+    knurlMappingMode: number;
+}
+/** Axis-aligned bounding box in world space. */
+export interface BoundingBox {
+    min: Vec3;
+    max: Vec3;
+}
+/** Description of a face on a shape: center, normal and area. */
+export interface FaceDescriptor {
+    center: Vec3;
+    normal: Vec3;
+    area: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mesh/types.d.ts.map

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

package/dist/mesh/types.js

@@ -0,0 +1,46 @@
+/**
+ * mesh 类型定义 — 纯数据几何 API 的类型契约
+ *
+ * 设计原则（§5.1）：
+ * - 全部纯数据：输入输出是 ManifoldMeshData 或 JSON 值，不碰 THREE 场景、不读 store
+ * - 不可变：每个 API 返回新几何，不修改输入
+ * - 坐标系：右手系 +Z 向上、毫米、角度用度
+ * - 坐标空间：所有 API 输入/输出均为**世界空间** ManifoldMeshData
+ *   （局部↔世界变换由执行器负责，mesh 不感知 mesh.matrixWorld）
+ *
+ * P1 阶段 Shape = ManifoldMeshData（无 worker）。
+ * P3+ 阶段 Shape 将变为 worker 内 Manifold 对象的句柄。
+ */
+/**
+ * Structural guard: returns true when the value looks like a mesh Shape
+ * (duck-typed via positions/indices, with no requirements on third-party
+ * types).
+ *
+ * Per the keep-syntax design, hosts use this guard to distinguish mesh Shapes
+ * from compounds when consuming ExecutionResult.outputs, in the same style as
+ * the runtime-internal isShapeLike.
+ * @param v - the value to test.
+ * @returns true when the value is a mesh Shape.
+ */
+export function isMeshShape(v) {
+    return !!v && typeof v === 'object' && 'positions' in v && 'indices' in v;
+}
+// ── 创建参数 ──
+/** Default radial segment count used for rounded geometry. */
+export const NRAD_DEFAULT = 64;
+/** Minimum allowed radial segment count. */
+export const NRAD_MIN = 3;
+/** Maximum allowed radial segment count. */
+export const NRAD_MAX = 128;
+/**
+ * Clamp an nRad value into the legal range [NRAD_MIN, NRAD_MAX], rounding to
+ * the nearest integer; undefined falls back to NRAD_DEFAULT.
+ * @param n - the requested radial segment count, or undefined.
+ * @returns the clamped radial segment count.
+ */
+export function clampNRad(n) {
+    if (n === undefined)
+        return NRAD_DEFAULT;
+    return Math.max(NRAD_MIN, Math.min(NRAD_MAX, Math.round(n)));
+}
+//# sourceMappingURL=types.js.map

package/dist/mesh/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mesh/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA8BH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,WAAW,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,CAAA;AAC3E,CAAC;AAED,aAAa;AAEb,8DAA8D;AAC9D,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAA;AAC9B,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAA;AACzB,4CAA4C;AAC5C,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,CAAA;AAE3B;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,CAAqB;IAC7C,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,YAAY,CAAA;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9D,CAAC","sourcesContent":["/**\n * mesh 类型定义 — 纯数据几何 API 的类型契约\n *\n * 设计原则（§5.1）：\n * - 全部纯数据：输入输出是 ManifoldMeshData 或 JSON 值，不碰 THREE 场景、不读 store\n * - 不可变：每个 API 返回新几何，不修改输入\n * - 坐标系：右手系 +Z 向上、毫米、角度用度\n * - 坐标空间：所有 API 输入/输出均为**世界空间** ManifoldMeshData\n *   （局部↔世界变换由执行器负责，mesh 不感知 mesh.matrixWorld）\n *\n * P1 阶段 Shape = ManifoldMeshData（无 worker）。\n * P3+ 阶段 Shape 将变为 worker 内 Manifold 对象的句柄。\n */\n\n// ── 基础类型 ──\n\nexport type Vec3 = [number, number, number]\n\n/**\n * A JSON-serializable value: scalar, null, array, or plain object.\n */\nexport type JsonValue =\n  | string\n  | number\n  | boolean\n  | null\n  | JsonValue[]\n  | { [k: string]: JsonValue }\n\n// ── Shape ──\n\n/**\n * A mesh shape — the core data type of the mesh API.\n *\n * Shape is defined directly in mesh/types.ts rather than re-exported from\n * ops/types.ts; ops/types.ts imports it from here, removing the type cycle.\n */\nexport interface Shape {\n  positions: Float32Array\n  indices: Uint32Array\n}\n\n/**\n * Structural guard: returns true when the value looks like a mesh Shape\n * (duck-typed via positions/indices, with no requirements on third-party\n * types).\n *\n * Per the keep-syntax design, hosts use this guard to distinguish mesh Shapes\n * from compounds when consuming ExecutionResult.outputs, in the same style as\n * the runtime-internal isShapeLike.\n * @param v - the value to test.\n * @returns true when the value is a mesh Shape.\n */\nexport function isMeshShape(v: unknown): v is Shape {\n  return !!v && typeof v === 'object' && 'positions' in v && 'indices' in v\n}\n\n// ── 创建参数 ──\n\n/** Default radial segment count used for rounded geometry. */\nexport const NRAD_DEFAULT = 64\n/** Minimum allowed radial segment count. */\nexport const NRAD_MIN = 3\n/** Maximum allowed radial segment count. */\nexport const NRAD_MAX = 128\n\n/**\n * Clamp an nRad value into the legal range [NRAD_MIN, NRAD_MAX], rounding to\n * the nearest integer; undefined falls back to NRAD_DEFAULT.\n * @param n - the requested radial segment count, or undefined.\n * @returns the clamped radial segment count.\n */\nexport function clampNRad(n: number | undefined): number {\n  if (n === undefined) return NRAD_DEFAULT\n  return Math.max(NRAD_MIN, Math.min(NRAD_MAX, Math.round(n)))\n}\n\n/**\n * Parameters for creating a box (brepjs `box(width, depth, height, {at?, centered?, segments?})`\n * contract, §4.1 A 决策). Default: min-corner at the origin. `centered: true` shifts so the\n * box is centered at the origin; `at` is CENTER semantics and takes precedence over `centered`.\n */\nexport interface BoxParams {\n  /** Side length along X (mm). */\n  width: number\n  /** Side length along Y (mm). */\n  depth: number\n  /** Side length along Z (mm). */\n  height: number\n  /** Center position (brepjs `at`, CENTER semantics); takes precedence over `centered`. */\n  at?: Vec3\n  /** Center the box at the origin when `at` is absent. Default: false (min-corner at origin). */\n  centered?: boolean\n  /** Tessellation segment count (box: affects only brep/mesh tessellation, not topology). */\n  segments?: number\n  /** Internal historical alias for `segments` (accepted by clampNRad, §5.1). */\n  nRad?: number\n}\n\n/** Parameters for creating a sphere. */\nexport interface SphereParams {\n  radius: number\n  segments?: number\n  center?: Vec3\n  nRad?: number\n}\n\n/** Parameters for creating a cylinder (brepjs contract, §4.3 A). */\nexport interface CylinderParams {\n  /** Radius (mm). */\n  radius: number\n  /** Height along +Z (mm). */\n  height: number\n  /** Base circle center (brepjs `at`, BASE semantics; default [0, 0, 0]). */\n  at?: Vec3\n  /** Center the cylinder (base at −h/2 / center at `at`) instead of base at `at`/origin. */\n  centered?: boolean\n  /** Tessellation segment count (cylinder: affects only tessellation, not topology). */\n  segments?: number\n  /** Internal historical alias for `segments` (accepted by clampNRad, §5.1). */\n  nRad?: number\n}\n\n/** Parameters for creating a cone (or a truncated cone). */\nexport interface ConeParams {\n  /** Radius at the base (mm). */\n  radiusBottom: number\n  /** Radius at the top (mm); 0 for a pointed cone, === radiusBottom for a cylinder. */\n  radiusTop: number\n  /** Height along +Z (mm). */\n  height: number\n  /** Base circle center (brepjs `at`, BASE semantics; default [0, 0, 0]). */\n  at?: Vec3\n  /** Center the cone (base at −h/2 / center at `at`) instead of base at `at`/origin. */\n  centered?: boolean\n  /** Tessellation segment count (cone: affects only mere tessellation, not topology). */\n  segments?: number\n  /** Internal historical alias for `segments` (accepted by clampNRad, §5.1). */\n  nRad?: number\n}\n\n/**\n * Parameters for creating a wedge (trapezoidal prism).\n */\nexport interface WedgeParams {\n  /** Width of the base edge (mm), along the Y axis. */\n  width: number\n  /** Height of the trapezoid (mm), along the Z axis. */\n  height: number\n  /** Angle between the base edge and the slope (degrees). */\n  angle: number\n  /** Total extrusion length (mm), along the X axis. */\n  length: number\n  center?: Vec3\n  nRad?: number\n}\n\n/** Parameters for creating 3D text. */\nexport interface TextParams {\n  text: string\n  size: number\n  depth: number\n}\n\n/** Parameters for extruding an SVG into a solid. */\nexport interface SvgExtrudeParams {\n  svg: string\n  depth: number\n  targetLongSide: number\n  naturalWidth?: number\n  naturalHeight?: number\n}\n\n/** Parameters for building a solid from an SDF (signed distance function). */\nexport interface SdfParams {\n  code: string\n  box?: [Vec3, Vec3]\n  resolution?: number\n  params?: Record<string, number>\n}\n\n// ── 变换参数 ──\n\n/** Parameters for translating a shape. */\nexport interface TranslateParams {\n  offset: Vec3\n}\n\n/** Parameters for rotating a shape. */\nexport interface RotateParams {\n  anglesDeg: Vec3\n  pivot?: Vec3\n}\n\n/** Parameters for scaling a shape. */\nexport interface ScaleParams {\n  factor: number | Vec3\n}\n\n// ── 布尔参数 ──\n\n/** Kinds of binary boolean operations. */\nexport type BooleanOperation = 'union' | 'subtract' | 'intersect'\n\n// ── 分割参数 ──\n\n/** A cutting plane defined by a unit normal and a signed offset. */\nexport interface SplitPlane {\n  normal: Vec3\n  offset: number\n}\n\n/** Parameters for a dovetail split, including the cutting plane setup. */\nexport interface DovetailSplitParams {\n  plane: SplitPlane\n  planeCenter: Vec3\n  widthDir: Vec3\n  bboxWidthOnWidthDir: number\n  groove: {\n    depth: number\n    depthTolerance: number\n    width: number\n    widthTolerance: number\n    flapsAngle: number\n  }\n}\n\n/** Parameters for a dowel-pin split, including the cutting plane setup. */\nexport interface DowelSplitParams {\n  plane: SplitPlane\n  planeCenter: Vec3\n  widthDir: Vec3\n  dowel: {\n    diameter: number\n    diameterTolerance: number\n    height: number\n    heightTolerance: number\n  }\n  selectedSections?: number[] | null\n}\n\n/** Parameters for a straight-tenon split, including the cutting plane setup. */\nexport interface TenonSplitParams {\n  plane: SplitPlane\n  planeCenter: Vec3\n  widthDir: Vec3\n  tenon: {\n    sideLength: number\n    sideLengthTolerance: number\n    height: number\n    heightTolerance: number\n  }\n  selectedSections?: number[] | null\n}\n\n/** Result of a joinery split: the two halves plus the cut-out wedge. */\nexport interface SplitResult {\n  front: Shape\n  back: Shape\n  wedge: Shape | null\n}\n\n// ── 钻孔参数 ──\n\n/** Parameters for drilling a hole. */\nexport interface DrillParams {\n  diameter: number\n  depth?: number\n  type: 'through' | 'blind'\n  position: Vec3\n  direction: Vec3\n  faceNormal: Vec3\n  tolerance?: number\n  holeType?: 'simple' | 'screw'\n  screwSystem?: string\n  screwSpecIdx?: number\n  screwThread?: string\n  screwHead?: string\n}\n\n// ── 拉伸参数 ──\n\n/** Parameters for extruding a face bounded by a plane. */\nexport interface ExtrudeParams {\n  normal: Vec3\n  originOffset: number\n  length: number\n  mode?: 'centered' | 'forward' | 'backward'\n}\n\n// ── 雕刻参数 ──\n\n/** Parameters for engraving text or an SVG onto a face. */\nexport interface EngraveParams {\n  mode: 'convex' | 'concave'\n  depth: number\n  face: {\n    center: Vec3\n    normal: Vec3\n  }\n  text?: string\n  textSize?: number\n  svg?: string\n  svgNaturalWidth?: number\n  svgNaturalHeight?: number\n  svgSize?: number\n}\n\n/** Parameters for applying a knurl texture to a face. */\nexport interface KnurlParams {\n  face: {\n    center: Vec3\n    normal: Vec3\n  }\n  knurlTextureHeight: number\n  knurlInvertDisplacement: boolean\n  knurlRefineLength: number\n  knurlScaleU: number\n  knurlScaleV: number\n  knurlMappingMode: number\n}\n\n// ── 查询结果 ──\n\n/** Axis-aligned bounding box in world space. */\nexport interface BoundingBox {\n  min: Vec3\n  max: Vec3\n}\n\n/** Description of a face on a shape: center, normal and area. */\nexport interface FaceDescriptor {\n  center: Vec3\n  normal: Vec3\n  area: number\n}\n"]}

package/dist/module-resolver/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * module-resolver — 公开导出（channel ③，V5.2）
+ *
+ * 见 `./resolver` 与 `./version` 的头注释。
+ */
+export { resolveImports, splitVersionRange, ModuleResolverError, UnresolvedImportError, ImportVersionError, type ResolverValue, type ResolveImportsOptions, type ResolveResult, } from './resolver.js';
+export { satisfies, assertSatisfies, parseVersion, type ParsedVersion } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/module-resolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/module-resolver/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA"}

package/dist/module-resolver/index.js

@@ -0,0 +1,8 @@
+/**
+ * module-resolver — 公开导出（channel ③，V5.2）
+ *
+ * 见 `./resolver` 与 `./version` 的头注释。
+ */
+export { resolveImports, splitVersionRange, ModuleResolverError, UnresolvedImportError, ImportVersionError, } from './resolver.js';
+export { satisfies, assertSatisfies, parseVersion } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/module-resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/module-resolver/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GAInB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAsB,MAAM,WAAW,CAAA","sourcesContent":["/**\n * module-resolver — 公开导出（channel ③，V5.2）\n *\n * 见 `./resolver` 与 `./version` 的头注释。\n */\n\nexport {\n  resolveImports,\n  splitVersionRange,\n  ModuleResolverError,\n  UnresolvedImportError,\n  ImportVersionError,\n  type ResolverValue,\n  type ResolveImportsOptions,\n  type ResolveResult,\n} from './resolver'\n\nexport { satisfies, assertSatisfies, parseVersion, type ParsedVersion } from './version'"]}