@faicad/faijs 0.29.5 → 0.31.1

package/dist/brep/export/stl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stl.d.ts","sourceRoot":"","sources":["../../../src/brep/export/stl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,WAAW,CA+Eb"}
+{"version":3,"file":"stl.d.ts","sourceRoot":"","sources":["../../../src/brep/export/stl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAalE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAW1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,YAAY,EACvB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAAE,GACnB,WAAW,CAgFb"}

package/dist/brep/export/stl.js

@@ -16,15 +16,63 @@
  *     - vertex3:  3 × float32 (12 bytes)
  *     - attr:     2 bytes (0)
  */
+/**
+ * Compose two row-major 3×4 affine matrices (implicit homogeneous row [0,0,0,1]).
+ * Returns B∘A: apply A first, then B. Used to accumulate a node's local transform
+ * onto its parent's world transform during assembly flattening (方案 §2.1 / §5).
+ *
+ * @param a - 先应用的内层矩阵（子节点局部 transform）。
+ * @param b - 后应用的外层矩阵（父节点累积 transform）。
+ * @returns 复合后的行主序 3×4 仿射矩阵（12 元组）。
+ */
+export function composeMatrix12(a, b) {
+    const C = new Array(12).fill(0);
+    for (let r = 0; r < 3; r++) {
+        for (let c = 0; c < 3; c++) {
+            let s = 0;
+            for (let k = 0; k < 3; k++)
+                s += b[r * 4 + k] * a[k * 4 + c];
+            C[r * 4 + c] = s;
+        }
+        let t = 0;
+        for (let k = 0; k < 3; k++)
+            t += b[r * 4 + k] * a[k * 4 + 3];
+        C[r * 4 + 3] = t + b[r * 4 + 3];
+    }
+    return C;
+}
+/**
+ * Apply a row-major 3×4 affine matrix (implicit homogeneous [0,0,0,1]) to every
+ * vertex of an interleaved position buffer, returning a new buffer (STL 顶点烘焙).
+ *
+ * @param positions - 交错的顶点坐标缓冲（每顶点 x,y,z）。
+ * @param m - 行主序 3×4 仿射矩阵（12 元组，隐式齐次行 [0,0,0,1]）。
+ * @returns 烘焙后的新缓冲（不修改入参）。
+ */
+export function bakeMatrix12ToPositions(positions, m) {
+    const out = new Float32Array(positions.length);
+    for (let i = 0; i < positions.length; i += 3) {
+        const x = positions[i];
+        const y = positions[i + 1];
+        const z = positions[i + 2];
+        out[i] = m[0] * x + m[1] * y + m[2] * z + m[3];
+        out[i + 1] = m[4] * x + m[5] * y + m[6] * z + m[7];
+        out[i + 2] = m[8] * x + m[9] * y + m[10] * z + m[11];
+    }
+    return out;
+}
 /**
  * Build a binary STL buffer from raw positions and indices (no THREE dependency).
  * @param positions - the interleaved vertex positions (x,y,z per vertex).
  * @param indices - the triangle indices (3 indices per triangle).
  * @param header - optional 80-byte header text (defaults to 'Faicad STL').
+ * @param transform - optional row-major 3×4 affine matrix (12-tuple). When given,
+ *        every vertex is baked through it before writing (STL 顶点烘焙, 方案 §2.1 / §5).
  * @returns an ArrayBuffer holding the binary STL data.
  */
-export function buildStlBufferFromMesh(positions, indices, header) {
+export function buildStlBufferFromMesh(positions, indices, header, transform) {
     const triCount = indices.length / 3;
+    const pos = transform ? bakeMatrix12ToPositions(positions, transform) : positions;
     const headerSize = 80;
     const countSize = 4;
     const triByteSize = 50; // 12 (normal) + 12*3 (vertices) + 2 (attr)
@@ -44,15 +92,15 @@ export function buildStlBufferFromMesh(positions, indices, header) {
         const ia = indices[i * 3];
         const ib = indices[i * 3 + 1];
         const ic = indices[i * 3 + 2];
-        const ax = positions[ia * 3];
-        const ay = positions[ia * 3 + 1];
-        const az = positions[ia * 3 + 2];
-        const bx = positions[ib * 3];
-        const by = positions[ib * 3 + 1];
-        const bz = positions[ib * 3 + 2];
-        const cx = positions[ic * 3];
-        const cy = positions[ic * 3 + 1];
-        const cz = positions[ic * 3 + 2];
+        const ax = pos[ia * 3];
+        const ay = pos[ia * 3 + 1];
+        const az = pos[ia * 3 + 2];
+        const bx = pos[ib * 3];
+        const by = pos[ib * 3 + 1];
+        const bz = pos[ib * 3 + 2];
+        const cx = pos[ic * 3];
+        const cy = pos[ic * 3 + 1];
+        const cz = pos[ic * 3 + 2];
         // Compute face normal: cross(B-A, C-A)
         const ux = bx - ax;
         const uy = by - ay;

package/dist/brep/export/stl.js.map

@@ -1 +1 @@
-{"version":3,"file":"stl.js","sourceRoot":"","sources":["../../../src/brep/export/stl.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * buildStlBufferFromMesh — L1 纯数据 STL 导出（无 THREE 依赖）\n *\n *\n * 从原始 positions + indices 构建 binary STL buffer。\n * 与 src/renderer/lib/build-stl.ts 的 buildStlBuffer() 功能相同，\n * 但不依赖 THREE.BufferGeometry，可在 Node 环境直接使用。\n *\n * Binary STL format:\n *   bytes 0-79:    80-byte header\n *   bytes 80-83:   4-byte uint32 triangle count N\n *   bytes 84+:     N × 50-byte triangles\n *     - normal:   3 × float32 (12 bytes)\n *     - vertex1:  3 × float32 (12 bytes)\n *     - vertex2:  3 × float32 (12 bytes)\n *     - vertex3:  3 × float32 (12 bytes)\n *     - attr:     2 bytes (0)\n */\n\n/**\n * Build a binary STL buffer from raw positions and indices (no THREE dependency).\n * @param positions - the interleaved vertex positions (x,y,z per vertex).\n * @param indices - the triangle indices (3 indices per triangle).\n * @param header - optional 80-byte header text (defaults to 'Faicad STL').\n * @returns an ArrayBuffer holding the binary STL data.\n */\nexport function buildStlBufferFromMesh(\n  positions: Float32Array,\n  indices: Uint32Array,\n  header?: string,\n): ArrayBuffer {\n  const triCount = indices.length / 3\n\n  const headerSize = 80\n  const countSize = 4\n  const triByteSize = 50 // 12 (normal) + 12*3 (vertices) + 2 (attr)\n  const totalSize = headerSize + countSize + triCount * triByteSize\n\n  const buffer = new ArrayBuffer(totalSize)\n  const dv = new DataView(buffer)\n\n  // Header (80 bytes)\n  const headerStr = header ?? 'Faicad STL'\n  for (let i = 0; i < Math.min(headerStr.length, 80); i++) {\n    dv.setUint8(i, headerStr.charCodeAt(i))\n  }\n\n  // Triangle count\n  dv.setUint32(80, triCount, true)\n\n  // Triangles\n  for (let i = 0; i < triCount; i++) {\n    const base = 84 + i * 50\n    const ia = indices[i * 3]!\n    const ib = indices[i * 3 + 1]!\n    const ic = indices[i * 3 + 2]!\n\n    const ax = positions[ia * 3]\n    const ay = positions[ia * 3 + 1]\n    const az = positions[ia * 3 + 2]\n    const bx = positions[ib * 3]\n    const by = positions[ib * 3 + 1]\n    const bz = positions[ib * 3 + 2]\n    const cx = positions[ic * 3]\n    const cy = positions[ic * 3 + 1]\n    const cz = positions[ic * 3 + 2]\n\n    // Compute face normal: cross(B-A, C-A)\n    const ux = bx - ax\n    const uy = by - ay\n    const uz = bz - az\n    const vx = cx - ax\n    const vy = cy - ay\n    const vz = cz - az\n    let nx = uy * vz - uz * vy\n    let ny = uz * vx - ux * vz\n    let nz = ux * vy - uy * vx\n    const nlen = Math.sqrt(nx * nx + ny * ny + nz * nz)\n    if (nlen > 0) {\n      nx /= nlen\n      ny /= nlen\n      nz /= nlen\n    }\n\n    // Normal\n    dv.setFloat32(base + 0, nx, true)\n    dv.setFloat32(base + 4, ny, true)\n    dv.setFloat32(base + 8, nz, true)\n\n    // Vertex A\n    dv.setFloat32(base + 12, ax, true)\n    dv.setFloat32(base + 16, ay, true)\n    dv.setFloat32(base + 20, az, true)\n\n    // Vertex B\n    dv.setFloat32(base + 24, bx, true)\n    dv.setFloat32(base + 28, by, true)\n    dv.setFloat32(base + 32, bz, true)\n\n    // Vertex C\n    dv.setFloat32(base + 36, cx, true)\n    dv.setFloat32(base + 40, cy, true)\n    dv.setFloat32(base + 44, cz, true)\n\n    // Attribute (2 bytes, usually 0)\n    dv.setUint16(base + 48, 0, true)\n  }\n\n  return buffer\n}\n"]}
+{"version":3,"file":"stl.js","sourceRoot":"","sources":["../../../src/brep/export/stl.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * buildStlBufferFromMesh — L1 纯数据 STL 导出（无 THREE 依赖）\n *\n *\n * 从原始 positions + indices 构建 binary STL buffer。\n * 与 src/renderer/lib/build-stl.ts 的 buildStlBuffer() 功能相同，\n * 但不依赖 THREE.BufferGeometry，可在 Node 环境直接使用。\n *\n * Binary STL format:\n *   bytes 0-79:    80-byte header\n *   bytes 80-83:   4-byte uint32 triangle count N\n *   bytes 84+:     N × 50-byte triangles\n *     - normal:   3 × float32 (12 bytes)\n *     - vertex1:  3 × float32 (12 bytes)\n *     - vertex2:  3 × float32 (12 bytes)\n *     - vertex3:  3 × float32 (12 bytes)\n *     - attr:     2 bytes (0)\n */\n\n/**\n * Compose two row-major 3×4 affine matrices (implicit homogeneous row [0,0,0,1]).\n * Returns B∘A: apply A first, then B. Used to accumulate a node's local transform\n * onto its parent's world transform during assembly flattening (方案 §2.1 / §5).\n *\n * @param a - 先应用的内层矩阵（子节点局部 transform）。\n * @param b - 后应用的外层矩阵（父节点累积 transform）。\n * @returns 复合后的行主序 3×4 仿射矩阵（12 元组）。\n */\nexport function composeMatrix12(a: number[], b: number[]): number[] {\n  const C = new Array<number>(12).fill(0)\n  for (let r = 0; r < 3; r++) {\n    for (let c = 0; c < 3; c++) {\n      let s = 0\n      for (let k = 0; k < 3; k++) s += b[r * 4 + k]! * a[k * 4 + c]!\n      C[r * 4 + c] = s\n    }\n    let t = 0\n    for (let k = 0; k < 3; k++) t += b[r * 4 + k]! * a[k * 4 + 3]!\n    C[r * 4 + 3] = t + b[r * 4 + 3]!\n  }\n  return C\n}\n\n/**\n * Apply a row-major 3×4 affine matrix (implicit homogeneous [0,0,0,1]) to every\n * vertex of an interleaved position buffer, returning a new buffer (STL 顶点烘焙).\n *\n * @param positions - 交错的顶点坐标缓冲（每顶点 x,y,z）。\n * @param m - 行主序 3×4 仿射矩阵（12 元组，隐式齐次行 [0,0,0,1]）。\n * @returns 烘焙后的新缓冲（不修改入参）。\n */\nexport function bakeMatrix12ToPositions(positions: Float32Array, m: number[]): Float32Array {\n  const out = new Float32Array(positions.length)\n  for (let i = 0; i < positions.length; i += 3) {\n    const x = positions[i]!\n    const y = positions[i + 1]!\n    const z = positions[i + 2]!\n    out[i] = m[0]! * x + m[1]! * y + m[2]! * z + m[3]!\n    out[i + 1] = m[4]! * x + m[5]! * y + m[6]! * z + m[7]!\n    out[i + 2] = m[8]! * x + m[9]! * y + m[10]! * z + m[11]!\n  }\n  return out\n}\n\n/**\n * Build a binary STL buffer from raw positions and indices (no THREE dependency).\n * @param positions - the interleaved vertex positions (x,y,z per vertex).\n * @param indices - the triangle indices (3 indices per triangle).\n * @param header - optional 80-byte header text (defaults to 'Faicad STL').\n * @param transform - optional row-major 3×4 affine matrix (12-tuple). When given,\n *        every vertex is baked through it before writing (STL 顶点烘焙, 方案 §2.1 / §5).\n * @returns an ArrayBuffer holding the binary STL data.\n */\nexport function buildStlBufferFromMesh(\n  positions: Float32Array,\n  indices: Uint32Array,\n  header?: string,\n  transform?: number[],\n): ArrayBuffer {\n  const triCount = indices.length / 3\n  const pos = transform ? bakeMatrix12ToPositions(positions, transform) : positions\n\n  const headerSize = 80\n  const countSize = 4\n  const triByteSize = 50 // 12 (normal) + 12*3 (vertices) + 2 (attr)\n  const totalSize = headerSize + countSize + triCount * triByteSize\n\n  const buffer = new ArrayBuffer(totalSize)\n  const dv = new DataView(buffer)\n\n  // Header (80 bytes)\n  const headerStr = header ?? 'Faicad STL'\n  for (let i = 0; i < Math.min(headerStr.length, 80); i++) {\n    dv.setUint8(i, headerStr.charCodeAt(i))\n  }\n\n  // Triangle count\n  dv.setUint32(80, triCount, true)\n\n  // Triangles\n  for (let i = 0; i < triCount; i++) {\n    const base = 84 + i * 50\n    const ia = indices[i * 3]!\n    const ib = indices[i * 3 + 1]!\n    const ic = indices[i * 3 + 2]!\n\n    const ax = pos[ia * 3]\n    const ay = pos[ia * 3 + 1]\n    const az = pos[ia * 3 + 2]\n    const bx = pos[ib * 3]\n    const by = pos[ib * 3 + 1]\n    const bz = pos[ib * 3 + 2]\n    const cx = pos[ic * 3]\n    const cy = pos[ic * 3 + 1]\n    const cz = pos[ic * 3 + 2]\n\n    // Compute face normal: cross(B-A, C-A)\n    const ux = bx - ax\n    const uy = by - ay\n    const uz = bz - az\n    const vx = cx - ax\n    const vy = cy - ay\n    const vz = cz - az\n    let nx = uy * vz - uz * vy\n    let ny = uz * vx - ux * vz\n    let nz = ux * vy - uy * vx\n    const nlen = Math.sqrt(nx * nx + ny * ny + nz * nz)\n    if (nlen > 0) {\n      nx /= nlen\n      ny /= nlen\n      nz /= nlen\n    }\n\n    // Normal\n    dv.setFloat32(base + 0, nx, true)\n    dv.setFloat32(base + 4, ny, true)\n    dv.setFloat32(base + 8, nz, true)\n\n    // Vertex A\n    dv.setFloat32(base + 12, ax, true)\n    dv.setFloat32(base + 16, ay, true)\n    dv.setFloat32(base + 20, az, true)\n\n    // Vertex B\n    dv.setFloat32(base + 24, bx, true)\n    dv.setFloat32(base + 28, by, true)\n    dv.setFloat32(base + 32, bz, true)\n\n    // Vertex C\n    dv.setFloat32(base + 36, cx, true)\n    dv.setFloat32(base + 40, cy, true)\n    dv.setFloat32(base + 44, cz, true)\n\n    // Attribute (2 bytes, usually 0)\n    dv.setUint16(base + 48, 0, true)\n  }\n\n  return buffer\n}\n"]}

package/dist/brep/export/transform12.d.ts

@@ -0,0 +1,47 @@
+/**
+ * transform12 — 装配节点位姿 → 3×4 行主序矩阵（写出器共用件）
+ *
+ * `Shape.transform`（mesh/types.ts）到 12 元组的唯一换算点。消费方：
+ * - `export-model.ts`：3MF `<component transform>` / STL 顶点烘焙；
+ * - `export-step.ts`：c1 transform 非 identity 时烘进几何（首组件恒 identity）；
+ * - `api/export-stl.ts`：transform 烘焙进顶点。
+ *
+ * 12 元组约定（行主序 3×4，平移在末列）：`[r00,r01,r02,tx, r10,r11,r12,ty, r20,r21,r22,tz]`，
+ * 与加载器 `parseTransformAttr` / wasm `getLocation` 同约定。
+ */
+import type { Vec3 } from '../../mesh/types.js';
+/**
+ * 轴角（度）→ 3×3 行主序旋转矩阵（Rodrigues）。
+ *
+ * @param axis - 旋转轴（零向量回退 z 轴）。
+ * @param angleDeg - 旋转角（度）。
+ * @returns 行主序 3×3 旋转矩阵（9 元素）。
+ */
+export declare function rotationMatrix3x3(axis: Vec3, angleDeg: number): number[];
+/** 装配节点位姿（与 `Shape.transform` 同形态）。 */
+export interface NodeTransform {
+    translate?: Vec3;
+    rotate?: {
+        angle: number;
+        axis?: Vec3;
+    };
+    matrix?: number[];
+}
+/**
+ * 3MF `<component transform>` 的 12 元组（行主序 3×4，平移在末列），与加载器 `parseTransformAttr` 同约定。
+ *
+ * @param t - 节点位姿（`matrix` 12 元组优先，缺省时由 `rotate` / `translate` 合成）。
+ * @returns 行主序 3×4 仿射矩阵的 12 元组。
+ */
+export declare function transformToMatrix12(t: NodeTransform): number[];
+/**
+ * 位姿平移分量按单位刻度换算（旋转不变）。基准单位（mm）→ 目标声明单位刻度，
+ * 与几何缩放（`scalePositions` / `kernel.scale`）同一 `scale` 因子——
+ * 「声明单位 == 坐标刻度」不变式对组件位姿同样成立。
+ *
+ * @param t - 基准单位刻度的节点位姿。
+ * @param scale - 单位换算因子（`1 / UNIT_SCALE[unit]`）。
+ * @returns 平移已换算的位姿（不修改入参）。
+ */
+export declare function scaleTransform(t: NodeTransform, scale: number): NodeTransform;
+//# sourceMappingURL=transform12.d.ts.map

package/dist/brep/export/transform12.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform12.d.ts","sourceRoot":"","sources":["../../../src/brep/export/transform12.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAQ5C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAWxE;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,IAAI,CAAA;KAAE,CAAA;IACvC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CAa9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAY7E"}

package/dist/brep/export/transform12.js

@@ -0,0 +1,87 @@
+/**
+ * transform12 — 装配节点位姿 → 3×4 行主序矩阵（写出器共用件）
+ *
+ * `Shape.transform`（mesh/types.ts）到 12 元组的唯一换算点。消费方：
+ * - `export-model.ts`：3MF `<component transform>` / STL 顶点烘焙；
+ * - `export-step.ts`：c1 transform 非 identity 时烘进几何（首组件恒 identity）；
+ * - `api/export-stl.ts`：transform 烘焙进顶点。
+ *
+ * 12 元组约定（行主序 3×4，平移在末列）：`[r00,r01,r02,tx, r10,r11,r12,ty, r20,r21,r22,tz]`，
+ * 与加载器 `parseTransformAttr` / wasm `getLocation` 同约定。
+ */
+/** 归一化向量（零向量回退 z 轴）。 */
+function normalize3(v) {
+    const len = Math.hypot(v[0], v[1], v[2]);
+    return len === 0 ? [0, 0, 1] : [v[0] / len, v[1] / len, v[2] / len];
+}
+/**
+ * 轴角（度）→ 3×3 行主序旋转矩阵（Rodrigues）。
+ *
+ * @param axis - 旋转轴（零向量回退 z 轴）。
+ * @param angleDeg - 旋转角（度）。
+ * @returns 行主序 3×3 旋转矩阵（9 元素）。
+ */
+export function rotationMatrix3x3(axis, angleDeg) {
+    const [x, y, z] = normalize3(axis);
+    const a = (angleDeg * Math.PI) / 180;
+    const c = Math.cos(a);
+    const s = Math.sin(a);
+    const t = 1 - c;
+    return [
+        t * x * x + c, t * x * y - s * z, t * x * z + s * y,
+        t * x * y + s * z, t * y * y + c, t * y * z - s * x,
+        t * x * z - s * y, t * y * z + s * x, t * z * z + c,
+    ];
+}
+/**
+ * 3MF `<component transform>` 的 12 元组（行主序 3×4，平移在末列），与加载器 `parseTransformAttr` 同约定。
+ *
+ * @param t - 节点位姿（`matrix` 12 元组优先，缺省时由 `rotate` / `translate` 合成）。
+ * @returns 行主序 3×4 仿射矩阵的 12 元组。
+ */
+export function transformToMatrix12(t) {
+    if (t.matrix && t.matrix.length === 12)
+        return t.matrix.slice();
+    const m = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0];
+    if (t.rotate) {
+        const R = rotationMatrix3x3(t.rotate.axis ?? [0, 0, 1], t.rotate.angle);
+        m[0] = R[0];
+        m[1] = R[1];
+        m[2] = R[2];
+        m[4] = R[3];
+        m[5] = R[4];
+        m[6] = R[5];
+        m[8] = R[6];
+        m[9] = R[7];
+        m[10] = R[8];
+    }
+    if (t.translate) {
+        m[3] = t.translate[0];
+        m[7] = t.translate[1];
+        m[11] = t.translate[2];
+    }
+    return m;
+}
+/**
+ * 位姿平移分量按单位刻度换算（旋转不变）。基准单位（mm）→ 目标声明单位刻度，
+ * 与几何缩放（`scalePositions` / `kernel.scale`）同一 `scale` 因子——
+ * 「声明单位 == 坐标刻度」不变式对组件位姿同样成立。
+ *
+ * @param t - 基准单位刻度的节点位姿。
+ * @param scale - 单位换算因子（`1 / UNIT_SCALE[unit]`）。
+ * @returns 平移已换算的位姿（不修改入参）。
+ */
+export function scaleTransform(t, scale) {
+    if (t.matrix && t.matrix.length === 12) {
+        const m = t.matrix.slice();
+        m[3] = m[3] * scale;
+        m[7] = m[7] * scale;
+        m[11] = m[11] * scale;
+        return { matrix: m };
+    }
+    return {
+        ...(t.translate ? { translate: [t.translate[0] * scale, t.translate[1] * scale, t.translate[2] * scale] } : {}),
+        ...(t.rotate ? { rotate: t.rotate } : {}),
+    };
+}
+//# sourceMappingURL=transform12.js.map

package/dist/brep/export/transform12.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform12.js","sourceRoot":"","sources":["../../../src/brep/export/transform12.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * transform12 — 装配节点位姿 → 3×4 行主序矩阵（写出器共用件）\n *\n * `Shape.transform`（mesh/types.ts）到 12 元组的唯一换算点。消费方：\n * - `export-model.ts`：3MF `<component transform>` / STL 顶点烘焙；\n * - `export-step.ts`：c1 transform 非 identity 时烘进几何（首组件恒 identity）；\n * - `api/export-stl.ts`：transform 烘焙进顶点。\n *\n * 12 元组约定（行主序 3×4，平移在末列）：`[r00,r01,r02,tx, r10,r11,r12,ty, r20,r21,r22,tz]`，\n * 与加载器 `parseTransformAttr` / wasm `getLocation` 同约定。\n */\n\nimport type { Vec3 } from '../../mesh/types'\n\n/** 归一化向量（零向量回退 z 轴）。 */\nfunction normalize3(v: Vec3): Vec3 {\n  const len = Math.hypot(v[0], v[1], v[2])\n  return len === 0 ? [0, 0, 1] : [v[0] / len, v[1] / len, v[2] / len]\n}\n\n/**\n * 轴角（度）→ 3×3 行主序旋转矩阵（Rodrigues）。\n *\n * @param axis - 旋转轴（零向量回退 z 轴）。\n * @param angleDeg - 旋转角（度）。\n * @returns 行主序 3×3 旋转矩阵（9 元素）。\n */\nexport function rotationMatrix3x3(axis: Vec3, angleDeg: number): number[] {\n  const [x, y, z] = normalize3(axis)\n  const a = (angleDeg * Math.PI) / 180\n  const c = Math.cos(a)\n  const s = Math.sin(a)\n  const t = 1 - c\n  return [\n    t * x * x + c, t * x * y - s * z, t * x * z + s * y,\n    t * x * y + s * z, t * y * y + c, t * y * z - s * x,\n    t * x * z - s * y, t * y * z + s * x, t * z * z + c,\n  ]\n}\n\n/** 装配节点位姿（与 `Shape.transform` 同形态）。 */\nexport interface NodeTransform {\n  translate?: Vec3\n  rotate?: { angle: number; axis?: Vec3 }\n  matrix?: number[]\n}\n\n/**\n * 3MF `<component transform>` 的 12 元组（行主序 3×4，平移在末列），与加载器 `parseTransformAttr` 同约定。\n *\n * @param t - 节点位姿（`matrix` 12 元组优先，缺省时由 `rotate` / `translate` 合成）。\n * @returns 行主序 3×4 仿射矩阵的 12 元组。\n */\nexport function transformToMatrix12(t: NodeTransform): number[] {\n  if (t.matrix && t.matrix.length === 12) return t.matrix.slice()\n  const m = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0]\n  if (t.rotate) {\n    const R = rotationMatrix3x3(t.rotate.axis ?? [0, 0, 1], t.rotate.angle)\n    m[0] = R[0]; m[1] = R[1]; m[2] = R[2]\n    m[4] = R[3]; m[5] = R[4]; m[6] = R[5]\n    m[8] = R[6]; m[9] = R[7]; m[10] = R[8]\n  }\n  if (t.translate) {\n    m[3] = t.translate[0]; m[7] = t.translate[1]; m[11] = t.translate[2]\n  }\n  return m\n}\n\n/**\n * 位姿平移分量按单位刻度换算（旋转不变）。基准单位（mm）→ 目标声明单位刻度，\n * 与几何缩放（`scalePositions` / `kernel.scale`）同一 `scale` 因子——\n * 「声明单位 == 坐标刻度」不变式对组件位姿同样成立。\n *\n * @param t - 基准单位刻度的节点位姿。\n * @param scale - 单位换算因子（`1 / UNIT_SCALE[unit]`）。\n * @returns 平移已换算的位姿（不修改入参）。\n */\nexport function scaleTransform(t: NodeTransform, scale: number): NodeTransform {\n  if (t.matrix && t.matrix.length === 12) {\n    const m = t.matrix.slice()\n    m[3] = m[3]! * scale\n    m[7] = m[7]! * scale\n    m[11] = m[11]! * scale\n    return { matrix: m }\n  }\n  return {\n    ...(t.translate ? { translate: [t.translate[0] * scale, t.translate[1] * scale, t.translate[2] * scale] as Vec3 } : {}),\n    ...(t.rotate ? { rotate: t.rotate } : {}),\n  }\n}\n"]}

package/dist/brep/face-evolution.d.ts

@@ -167,6 +167,59 @@ export declare function scaleWithHashEvolution(kernel: BrepEngineApi, shape: Bre
     result: BrepHandle;
     evolution: HashEvolution;
 };
+/**
+ * 单轴旋转 + **权威**面演化：走内核 `rotateWithHistory`。
+ *
+ * 仅当旋转可由**单轴**表达时可用（内核只提供单轴 API）。多轴欧拉角
+ * `rotate_euler` 仍退回 `identityHashEvolution`（`face-evolution.ordering.test.ts` 钉住）。
+ *
+ * @param kernel    - the OCCT kernel.
+ * @param shape     - the input shape.
+ * @param axisPoint - a point on the rotation axis (the pivot).
+ * @param axisDir   - the unit rotation-axis direction.
+ * @param angleRad  - the rotation angle in radians.
+ * @returns the rotated handle plus the hash-keyed and ordinal-keyed evolutions.
+ */
+export declare function rotateWithHashEvolution(kernel: BrepEngineApi, shape: BrepHandle, axisPoint: readonly [number, number, number], axisDir: readonly [number, number, number], angleRad: number): {
+    result: BrepHandle;
+    evolution: HashEvolution;
+    faceEvolution: FaceEvolution;
+};
+/**
+ * 镜像 + **权威**面演化：走内核 `mirrorWithHistory`。
+ *
+ * 镜像不改变面数/顺序（刚体反射），内核给 1:1 映射；brepkit 侧无此能力时
+ * 由调用方显式回退 `identityHashEvolution`（**不报错**）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param shape  - the input shape.
+ * @param point  - a point on the mirror plane.
+ * @param normal - the mirror-plane normal.
+ * @returns the mirrored handle plus the hash-keyed and ordinal-keyed evolutions.
+ */
+export declare function mirrorWithHashEvolution(kernel: BrepEngineApi, shape: BrepHandle, point: readonly [number, number, number], normal: readonly [number, number, number]): {
+    result: BrepHandle;
+    evolution: HashEvolution;
+    faceEvolution: FaceEvolution;
+};
+/**
+ * 抽壳 + **权威**面演化：走内核 `shellWithHistory`。
+ *
+ * `shell` 是中立 op（L1 两引擎均有裸实现）——occt 走本函数的权威映射，
+ * brepkit 无 `shellWithHistory` 时由调用方显式回退裸 `shell`（**不报错**）。
+ *
+ * @param kernel    - the OCCT kernel.
+ * @param solid     - the input solid.
+ * @param faces     - the faces to remove (open faces).
+ * @param thickness - the wall thickness.
+ * @param tolerance - the tolerance.
+ * @returns the shelled handle plus both the hash-keyed and ordinal-keyed evolutions.
+ */
+export declare function shellWithHashEvolution(kernel: BrepEngineApi, solid: BrepHandle, faces: BrepHandle[], thickness: number, tolerance: number): {
+    result: BrepHandle;
+    evolution: HashEvolution;
+    faceEvolution: FaceEvolution;
+};
 /**
  * 双输入布尔 + roleTable 合流组合封装（§3.4，api boolean 链式调用用）。
  *

package/dist/brep/face-evolution.d.ts.map

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

package/dist/brep/face-evolution.js

@@ -230,6 +230,71 @@ export function scaleWithHashEvolution(kernel, shape, center, factor) {
     const evo = getOcctKernel().scaleWithHistory(shape, { x: center[0], y: center[1], z: center[2] }, factor, inputHashes, HASH_UPPER_BOUND);
     return { result: evo.result, evolution: decodeHashEvolution(evo) };
 }
+/**
+ * 单轴旋转 + **权威**面演化：走内核 `rotateWithHistory`。
+ *
+ * 仅当旋转可由**单轴**表达时可用（内核只提供单轴 API）。多轴欧拉角
+ * `rotate_euler` 仍退回 `identityHashEvolution`（`face-evolution.ordering.test.ts` 钉住）。
+ *
+ * @param kernel    - the OCCT kernel.
+ * @param shape     - the input shape.
+ * @param axisPoint - a point on the rotation axis (the pivot).
+ * @param axisDir   - the unit rotation-axis direction.
+ * @param angleRad  - the rotation angle in radians.
+ * @returns the rotated handle plus the hash-keyed and ordinal-keyed evolutions.
+ */
+export function rotateWithHashEvolution(kernel, shape, axisPoint, axisDir, angleRad) {
+    const inputHashes = getFaceHashes(kernel, shape);
+    const evo = getOcctKernel().rotateWithHistory(shape, { point: { x: axisPoint[0], y: axisPoint[1], z: axisPoint[2] }, direction: { x: axisDir[0], y: axisDir[1], z: axisDir[2] } }, angleRad, inputHashes, HASH_UPPER_BOUND);
+    return {
+        result: evo.result,
+        evolution: decodeHashEvolution(evo),
+        faceEvolution: decodeEvolution(kernel, evo, shape, evo.result),
+    };
+}
+/**
+ * 镜像 + **权威**面演化：走内核 `mirrorWithHistory`。
+ *
+ * 镜像不改变面数/顺序（刚体反射），内核给 1:1 映射；brepkit 侧无此能力时
+ * 由调用方显式回退 `identityHashEvolution`（**不报错**）。
+ *
+ * @param kernel - the OCCT kernel.
+ * @param shape  - the input shape.
+ * @param point  - a point on the mirror plane.
+ * @param normal - the mirror-plane normal.
+ * @returns the mirrored handle plus the hash-keyed and ordinal-keyed evolutions.
+ */
+export function mirrorWithHashEvolution(kernel, shape, point, normal) {
+    const inputHashes = getFaceHashes(kernel, shape);
+    const evo = getOcctKernel().mirrorWithHistory(shape, { x: point[0], y: point[1], z: point[2] }, { x: normal[0], y: normal[1], z: normal[2] }, inputHashes, HASH_UPPER_BOUND);
+    return {
+        result: evo.result,
+        evolution: decodeHashEvolution(evo),
+        faceEvolution: decodeEvolution(kernel, evo, shape, evo.result),
+    };
+}
+/**
+ * 抽壳 + **权威**面演化：走内核 `shellWithHistory`。
+ *
+ * `shell` 是中立 op（L1 两引擎均有裸实现）——occt 走本函数的权威映射，
+ * brepkit 无 `shellWithHistory` 时由调用方显式回退裸 `shell`（**不报错**）。
+ *
+ * @param kernel    - the OCCT kernel.
+ * @param solid     - the input solid.
+ * @param faces     - the faces to remove (open faces).
+ * @param thickness - the wall thickness.
+ * @param tolerance - the tolerance.
+ * @returns the shelled handle plus both the hash-keyed and ordinal-keyed evolutions.
+ */
+export function shellWithHashEvolution(kernel, solid, faces, thickness, tolerance) {
+    const inputHashes = getFaceHashes(kernel, solid);
+    const evo = getOcctKernel().shellWithHistory(solid, faces, thickness, tolerance, inputHashes, HASH_UPPER_BOUND);
+    return {
+        result: evo.result,
+        evolution: decodeHashEvolution(evo),
+        faceEvolution: decodeEvolution(kernel, evo, solid, evo.result),
+    };
+}
 /**
  * 双输入布尔 + roleTable 合流组合封装（§3.4，api boolean 链式调用用）。
  *