@faicad/faijs 0.31.1 → 0.32.3

package/dist/mesh/stl-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"stl-loader.js","sourceRoot":"","sources":["../../src/mesh/stl-loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stl-loader — minimal STL parser (binary + ASCII), zero addons.\n *\n * Why hand-written: three's `STLLoader` lives in `three/examples/jsm/`, which is\n * outside three's version-compatibility promise and would pull a second,\n * unpinnable module into every faijs consumer — including the weapp worker,\n * whose bundle must stay free of the addons. Precedent: `mesh/creased-normals.ts`\n * ports three's `toCreasedNormals` for exactly this reason.\n *\n * Output matches `STLLoader.parse()`: a non-indexed `BufferGeometry` carrying\n * `position` (one vertex triple per triangle, duplicates preserved) and `normal`\n * attributes, so callers can keep using `geoToManifoldMesh` for welding.\n */\nimport * as THREE from 'three'\n\n/** Binary STL layout: 80-byte header + uint32 count + 50 bytes per triangle. */\nconst BINARY_HEADER_BYTES = 80\nconst BINARY_TRIANGLE_BYTES = 50\n\n/**\n * Decide whether `buffer` is a binary STL by checking the declared triangle\n * count against the file size (the same test `STLLoader` uses).\n *\n * @param buffer - the raw file bytes.\n * @returns true when the buffer is binary STL.\n */\nfunction isBinaryStl(buffer: ArrayBuffer): boolean {\n  if (buffer.byteLength < BINARY_HEADER_BYTES + 4) return false\n  const view = new DataView(buffer)\n  const triangles = view.getUint32(BINARY_HEADER_BYTES, true)\n  if (triangles === 0) return false\n  return BINARY_HEADER_BYTES + 4 + triangles * BINARY_TRIANGLE_BYTES === buffer.byteLength\n}\n\n/** Normalize a triangle normal, falling back to the geometric one. */\nfunction normalOf(\n  ax: number, ay: number, az: number,\n  bx: number, by: number, bz: number,\n  cx: number, cy: number, cz: number,\n): [number, number, number] {\n  const ux = bx - ax, uy = by - ay, uz = bz - az\n  const vx = cx - ax, vy = cy - ay, vz = cz - az\n  const nx = uy * vz - uz * vy\n  const ny = uz * vx - ux * vz\n  const nz = ux * vy - uy * vx\n  const len = Math.hypot(nx, ny, nz)\n  if (len < 1e-20) return [0, 0, 0]\n  return [nx / len, ny / len, nz / len]\n}\n\nfunction parseBinary(buffer: ArrayBuffer): THREE.BufferGeometry {\n  const view = new DataView(buffer)\n  const triangles = view.getUint32(BINARY_HEADER_BYTES, true)\n  const positions = new Float32Array(triangles * 9)\n  const normals = new Float32Array(triangles * 9)\n  let offset = BINARY_HEADER_BYTES + 4\n  for (let t = 0; t < triangles; t++) {\n    // Stored facet normal — used when it is a usable unit vector.\n    let nx = view.getFloat32(offset, true)\n    let ny = view.getFloat32(offset + 4, true)\n    let nz = view.getFloat32(offset + 8, true)\n    const stored = Math.hypot(nx, ny, nz)\n    offset += 12\n    const base = t * 9\n    for (let v = 0; v < 3; v++) {\n      positions[base + v * 3] = view.getFloat32(offset, true)\n      positions[base + v * 3 + 1] = view.getFloat32(offset + 4, true)\n      positions[base + v * 3 + 2] = view.getFloat32(offset + 8, true)\n      offset += 12\n    }\n    if (stored < 1e-20) {\n      ;[nx, ny, nz] = normalOf(\n        positions[base], positions[base + 1], positions[base + 2],\n        positions[base + 3], positions[base + 4], positions[base + 5],\n        positions[base + 6], positions[base + 7], positions[base + 8],\n      )\n    } else {\n      nx /= stored; ny /= stored; nz /= stored\n    }\n    for (let v = 0; v < 3; v++) {\n      normals[base + v * 3] = nx\n      normals[base + v * 3 + 1] = ny\n      normals[base + v * 3 + 2] = nz\n    }\n    offset += 2 // attribute byte count\n  }\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3))\n  geo.setAttribute('normal', new THREE.BufferAttribute(normals, 3))\n  return geo\n}\n\nfunction parseAscii(buffer: ArrayBuffer): THREE.BufferGeometry {\n  const text = new TextDecoder().decode(new Uint8Array(buffer))\n  const vertices: number[] = []\n  const normals: number[] = []\n  let facetNormal: [number, number, number] | null = null\n  const pending: number[] = []\n\n  const flush = (): void => {\n    if (pending.length !== 9) return\n    vertices.push(...pending)\n    const n = facetNormal ?? normalOf(\n      pending[0], pending[1], pending[2],\n      pending[3], pending[4], pending[5],\n      pending[6], pending[7], pending[8],\n    )\n    for (let v = 0; v < 3; v++) normals.push(n[0], n[1], n[2])\n    pending.length = 0\n  }\n\n  for (const rawLine of text.split('\\n')) {\n    const line = rawLine.trim()\n    if (line.startsWith('facet normal')) {\n      flush()\n      const parts = line.split(/\\s+/)\n      facetNormal = [Number(parts[2]), Number(parts[3]), Number(parts[4])]\n      continue\n    }\n    if (line.startsWith('vertex')) {\n      const parts = line.split(/\\s+/)\n      pending.push(Number(parts[1]), Number(parts[2]), Number(parts[3]))\n      continue\n    }\n    if (line.startsWith('endfacet')) {\n      flush()\n      facetNormal = null\n    }\n  }\n  flush()\n\n  const geo = new THREE.BufferGeometry()\n  geo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(vertices), 3))\n  geo.setAttribute('normal', new THREE.BufferAttribute(new Float32Array(normals), 3))\n  return geo\n}\n\n/**\n * Parse STL bytes into a non-indexed BufferGeometry.\n *\n * @param buffer - the raw STL file bytes (binary or ASCII).\n * @returns the parsed geometry (empty when the file holds no triangle).\n * @throws when the buffer is neither a well-formed binary nor ASCII STL.\n */\nexport function parseStl(buffer: ArrayBuffer): THREE.BufferGeometry {\n  if (buffer.byteLength === 0) {\n    throw new Error('[mesh/stl-loader] empty STL buffer')\n  }\n  return isBinaryStl(buffer) ? parseBinary(buffer) : parseAscii(buffer)\n}\n"]}
+{"version":3,"file":"stl-loader.js","sourceRoot":"","sources":["../../src/mesh/stl-loader.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * stl-loader — minimal STL parser (binary + ASCII), zero addons.\n *\n * Why hand-written: three's `STLLoader` lives in `three/examples/jsm/`, which is\n * outside three's version-compatibility promise and would pull a second,\n * unpinnable module into every faijs consumer — including the weapp worker,\n * whose bundle must stay free of the addons. Precedent: `mesh/creased-normals.ts`\n * ports three's `toCreasedNormals` for exactly this reason.\n *\n * Output: a non-indexed `Shape` carrying `positions` (one vertex triple per\n * triangle, duplicates preserved), sequential `indices`, and `normals`,\n * so callers can keep using `geoToManifoldMesh` for welding.\n */\nimport type { Shape } from './types'\n\n/** Binary STL layout: 80-byte header + uint32 count + 50 bytes per triangle. */\nconst BINARY_HEADER_BYTES = 80\nconst BINARY_TRIANGLE_BYTES = 50\n\n/**\n * Decide whether `buffer` is a binary STL by checking the declared triangle\n * count against the file size (the same test `STLLoader` uses).\n *\n * @param buffer - the raw file bytes.\n * @returns true when the buffer is binary STL.\n */\nfunction isBinaryStl(buffer: ArrayBuffer): boolean {\n  if (buffer.byteLength < BINARY_HEADER_BYTES + 4) return false\n  const view = new DataView(buffer)\n  const triangles = view.getUint32(BINARY_HEADER_BYTES, true)\n  if (triangles === 0) return false\n  return BINARY_HEADER_BYTES + 4 + triangles * BINARY_TRIANGLE_BYTES === buffer.byteLength\n}\n\n/** Normalize a triangle normal, falling back to the geometric one. */\nfunction normalOf(\n  ax: number, ay: number, az: number,\n  bx: number, by: number, bz: number,\n  cx: number, cy: number, cz: number,\n): [number, number, number] {\n  const ux = bx - ax, uy = by - ay, uz = bz - az\n  const vx = cx - ax, vy = cy - ay, vz = cz - az\n  const nx = uy * vz - uz * vy\n  const ny = uz * vx - ux * vz\n  const nz = ux * vy - uy * vx\n  const len = Math.hypot(nx, ny, nz)\n  if (len < 1e-20) return [0, 0, 0]\n  return [nx / len, ny / len, nz / len]\n}\n\n/** Build a non-indexed Shape from positions + normals (sequential indices). */\nfunction makeShape(positions: Float32Array, normals: Float32Array): Shape {\n  const vertCount = positions.length / 3\n  const indices = new Uint32Array(vertCount)\n  for (let i = 0; i < vertCount; i++) indices[i] = i\n  return { positions, indices, normals }\n}\n\nfunction parseBinary(buffer: ArrayBuffer): Shape {\n  const view = new DataView(buffer)\n  const triangles = view.getUint32(BINARY_HEADER_BYTES, true)\n  const positions = new Float32Array(triangles * 9)\n  const normals = new Float32Array(triangles * 9)\n  let offset = BINARY_HEADER_BYTES + 4\n  for (let t = 0; t < triangles; t++) {\n    // Stored facet normal — used when it is a usable unit vector.\n    let nx = view.getFloat32(offset, true)\n    let ny = view.getFloat32(offset + 4, true)\n    let nz = view.getFloat32(offset + 8, true)\n    const stored = Math.hypot(nx, ny, nz)\n    offset += 12\n    const base = t * 9\n    for (let v = 0; v < 3; v++) {\n      positions[base + v * 3] = view.getFloat32(offset, true)\n      positions[base + v * 3 + 1] = view.getFloat32(offset + 4, true)\n      positions[base + v * 3 + 2] = view.getFloat32(offset + 8, true)\n      offset += 12\n    }\n    if (stored < 1e-20) {\n      ;[nx, ny, nz] = normalOf(\n        positions[base], positions[base + 1], positions[base + 2],\n        positions[base + 3], positions[base + 4], positions[base + 5],\n        positions[base + 6], positions[base + 7], positions[base + 8],\n      )\n    } else {\n      nx /= stored; ny /= stored; nz /= stored\n    }\n    for (let v = 0; v < 3; v++) {\n      normals[base + v * 3] = nx\n      normals[base + v * 3 + 1] = ny\n      normals[base + v * 3 + 2] = nz\n    }\n    offset += 2 // attribute byte count\n  }\n  return makeShape(positions, normals)\n}\n\nfunction parseAscii(buffer: ArrayBuffer): Shape {\n  const text = new TextDecoder().decode(new Uint8Array(buffer))\n  const vertices: number[] = []\n  const normals: number[] = []\n  let facetNormal: [number, number, number] | null = null\n  const pending: number[] = []\n\n  const flush = (): void => {\n    if (pending.length !== 9) return\n    vertices.push(...pending)\n    const n = facetNormal ?? normalOf(\n      pending[0], pending[1], pending[2],\n      pending[3], pending[4], pending[5],\n      pending[6], pending[7], pending[8],\n    )\n    for (let v = 0; v < 3; v++) normals.push(n[0], n[1], n[2])\n    pending.length = 0\n  }\n\n  for (const rawLine of text.split('\\n')) {\n    const line = rawLine.trim()\n    if (line.startsWith('facet normal')) {\n      flush()\n      const parts = line.split(/\\s+/)\n      facetNormal = [Number(parts[2]), Number(parts[3]), Number(parts[4])]\n      continue\n    }\n    if (line.startsWith('vertex')) {\n      const parts = line.split(/\\s+/)\n      pending.push(Number(parts[1]), Number(parts[2]), Number(parts[3]))\n      continue\n    }\n    if (line.startsWith('endfacet')) {\n      flush()\n      facetNormal = null\n    }\n  }\n  flush()\n\n  return makeShape(new Float32Array(vertices), new Float32Array(normals))\n}\n\n/**\n * Parse STL bytes into a non-indexed Shape.\n *\n * @param buffer - the raw STL file bytes (binary or ASCII).\n * @returns the parsed shape (empty when the file holds no triangle).\n * @throws when the buffer is neither a well-formed binary nor ASCII STL.\n */\nexport function parseStl(buffer: ArrayBuffer): Shape {\n  if (buffer.byteLength === 0) {\n    throw new Error('[mesh/stl-loader] empty STL buffer')\n  }\n  return isBinaryStl(buffer) ? parseBinary(buffer) : parseAscii(buffer)\n}\n"]}

package/dist/mesh/threemf-view.d.ts

@@ -11,12 +11,12 @@
  * target pose we need
  *   delta = M_target × M_build⁻¹   (component-level transforms cancel).
  *
- * Matrices are `THREE.Matrix4` — core already depends on three as a peer dep
+ * Matrices are `Mat4` — core already depends on three as a peer dep
  * (io.ts imports THREE.BufferAttribute, brep imports occt-wasm) and the host
  * resolves it. This module is only reachable from the web display path
  * (`@faicad/faijs/mesh/threemf-view`); the weapp bundle never imports it.
  */
-import * as THREE from 'three';
+import { Mat4 } from '../math3d/index.js';
 import type { Bambu3mfMetadata } from './threemf-bambu.js';
 /** Bambu view layout: the pose a part carries on the plate / assembled / import. */
 export type ViewMode = 'print' | 'assembly' | 'import';
@@ -26,29 +26,29 @@ export interface ViewPartInfo {
     scopedId?: string;
 }
 type ViewMetadata = Pick<Bambu3mfMetadata, 'buildItems' | 'assembleTransforms' | 'importTransforms'>;
-/** Convert a 12-value 4×3 column-major transform (3MF §3.5.1) to THREE.Matrix4.
+/** Convert a 12-value 4×3 column-major transform (3MF §3.5.1) to Mat4.
  *
  *  Per 3MF spec (Section 3.5.1) the 12 values are column-major:
  *    Col 0: [v0,v1,v2], Col 1: [v3,v4,v5], Col 2: [v6,v7,v8],
  *    Col 3: [v9,v10,v11] (translation).
- *  THREE.Matrix4.set() takes row-major args, so we transpose.
+ *  Mat4.set() takes row-major args, so we transpose.
  *
  * @param v - the 12 column-major transform values (3MF §3.5.1).
- * @returns the equivalent column-major 4×4 THREE.Matrix4.
+ * @returns the equivalent column-major 4×4 Mat4.
  */
-export declare function mat4From12Values(v: number[]): THREE.Matrix4;
-/** Convert a 16-value 4×4 row-major array to THREE.Matrix4.
+export declare function mat4From12Values(v: number[]): Mat4;
+/** Convert a 16-value 4×4 row-major array to Mat4.
  *
  * @param v - the 16 row-major matrix values.
- * @returns the equivalent THREE.Matrix4.
+ * @returns the equivalent Mat4.
  */
-export declare function mat4From16Values(v: number[]): THREE.Matrix4;
+export declare function mat4From16Values(v: number[]): Mat4;
 /** Create a translation-only matrix.
  *
  * @param t - the translation [x, y, z].
  * @returns the 4×4 translation matrix.
  */
-export declare function makeTranslationMatrix(t: [number, number, number]): THREE.Matrix4;
+export declare function makeTranslationMatrix(t: [number, number, number]): Mat4;
 /**
  * Compute the delta matrix to transform a mesh from print-view to the target
  * view: delta = M_target × M_build⁻¹. Returns null when the target view has no
@@ -59,7 +59,7 @@ export declare function makeTranslationMatrix(t: [number, number, number]): THRE
  * @param partInfo - the part's objectId/scopedId used to key into `bambuMeta`.
  * @returns the delta matrix, or null when the target view has no data for the part.
  */
-export declare function computeViewDelta(viewMode: ViewMode, bambuMeta: ViewMetadata, partInfo: ViewPartInfo): THREE.Matrix4 | null;
+export declare function computeViewDelta(viewMode: ViewMode, bambuMeta: ViewMetadata, partInfo: ViewPartInfo): Mat4 | null;
 /** Whether a view mode is available for a given bambu metadata object.
  *
  * @param viewMode - the target view ('print' | 'assembly' | 'import').

package/dist/mesh/threemf-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"threemf-view.d.ts","sourceRoot":"","sources":["../../src/mesh/threemf-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEtD,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,KAAK,YAAY,GAAG,IAAI,CACtB,gBAAgB,EAChB,YAAY,GAAG,oBAAoB,GAAG,kBAAkB,CACzD,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAO3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAO3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAEhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,YAAY,GACrB,KAAK,CAAC,OAAO,GAAG,IAAI,CAyBtB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,GAC3E,OAAO,CAKT"}
+{"version":3,"file":"threemf-view.d.ts","sourceRoot":"","sources":["../../src/mesh/threemf-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEvD,oFAAoF;AACpF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEtD,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,KAAK,YAAY,GAAG,IAAI,CACtB,gBAAgB,EAChB,YAAY,GAAG,oBAAoB,GAAG,kBAAkB,CACzD,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAOlD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAEvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,YAAY,GACrB,IAAI,GAAG,IAAI,CAyBb;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,oBAAoB,GAAG,kBAAkB,CAAC,GAC3E,OAAO,CAKT"}

package/dist/mesh/threemf-view.js

@@ -11,32 +11,32 @@
  * target pose we need
  *   delta = M_target × M_build⁻¹   (component-level transforms cancel).
  *
- * Matrices are `THREE.Matrix4` — core already depends on three as a peer dep
+ * Matrices are `Mat4` — core already depends on three as a peer dep
  * (io.ts imports THREE.BufferAttribute, brep imports occt-wasm) and the host
  * resolves it. This module is only reachable from the web display path
  * (`@faicad/faijs/mesh/threemf-view`); the weapp bundle never imports it.
  */
-import * as THREE from 'three';
-/** Convert a 12-value 4×3 column-major transform (3MF §3.5.1) to THREE.Matrix4.
+import { Mat4 } from '../math3d/index.js';
+/** Convert a 12-value 4×3 column-major transform (3MF §3.5.1) to Mat4.
  *
  *  Per 3MF spec (Section 3.5.1) the 12 values are column-major:
  *    Col 0: [v0,v1,v2], Col 1: [v3,v4,v5], Col 2: [v6,v7,v8],
  *    Col 3: [v9,v10,v11] (translation).
- *  THREE.Matrix4.set() takes row-major args, so we transpose.
+ *  Mat4.set() takes row-major args, so we transpose.
  *
  * @param v - the 12 column-major transform values (3MF §3.5.1).
- * @returns the equivalent column-major 4×4 THREE.Matrix4.
+ * @returns the equivalent column-major 4×4 Mat4.
  */
 export function mat4From12Values(v) {
-    return new THREE.Matrix4().set(v[0], v[3], v[6], v[9], v[1], v[4], v[7], v[10], v[2], v[5], v[8], v[11], 0, 0, 0, 1);
+    return new Mat4().set(v[0], v[3], v[6], v[9], v[1], v[4], v[7], v[10], v[2], v[5], v[8], v[11], 0, 0, 0, 1);
 }
-/** Convert a 16-value 4×4 row-major array to THREE.Matrix4.
+/** Convert a 16-value 4×4 row-major array to Mat4.
  *
  * @param v - the 16 row-major matrix values.
- * @returns the equivalent THREE.Matrix4.
+ * @returns the equivalent Mat4.
  */
 export function mat4From16Values(v) {
-    return new THREE.Matrix4().set(v[0], v[1], v[2], v[3], v[4], v[5], v[6], v[7], v[8], v[9], v[10], v[11], v[12], v[13], v[14], v[15]);
+    return new Mat4().set(v[0], v[1], v[2], v[3], v[4], v[5], v[6], v[7], v[8], v[9], v[10], v[11], v[12], v[13], v[14], v[15]);
 }
 /** Create a translation-only matrix.
  *
@@ -44,7 +44,7 @@ export function mat4From16Values(v) {
  * @returns the 4×4 translation matrix.
  */
 export function makeTranslationMatrix(t) {
-    return new THREE.Matrix4().makeTranslation(t[0], t[1], t[2]);
+    return new Mat4().makeTranslation(t[0], t[1], t[2]);
 }
 /**
  * Compute the delta matrix to transform a mesh from print-view to the target

package/dist/mesh/threemf-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"threemf-view.js","sourceRoot":"","sources":["../../src/mesh/threemf-view.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * threemf-view — Bambu view-mode deltas (moved up from 3d_editor's\n * `viewTransforms.ts`, plan §8 decision 2).\n *\n * Bambu stores per-object transforms for three view modes:\n *   print    — the build `<item transform>` (pose on the plate).\n *   assembly — an extra `<assemble_item transform>` + offset (assembled pose).\n *   import   — a per-part 4×4 `matrix` in `model_settings.config` (import pose).\n *\n * To carry a mesh that already has M_build baked in (from `parseThreemf`) to the\n * target pose we need\n *   delta = M_target × M_build⁻¹   (component-level transforms cancel).\n *\n * Matrices are `THREE.Matrix4` — core already depends on three as a peer dep\n * (io.ts imports THREE.BufferAttribute, brep imports occt-wasm) and the host\n * resolves it. This module is only reachable from the web display path\n * (`@faicad/faijs/mesh/threemf-view`); the weapp bundle never imports it.\n */\nimport * as THREE from 'three'\nimport type { Bambu3mfMetadata } from './threemf-bambu'\n\n/** Bambu view layout: the pose a part carries on the plate / assembled / import. */\nexport type ViewMode = 'print' | 'assembly' | 'import'\n\n/** Narrowed part identity the view layer keys on (host passes its PartInfo). */\nexport interface ViewPartInfo {\n  objectId?: string\n  scopedId?: string\n}\n\ntype ViewMetadata = Pick<\n  Bambu3mfMetadata,\n  'buildItems' | 'assembleTransforms' | 'importTransforms'\n>\n\n/** Convert a 12-value 4×3 column-major transform (3MF §3.5.1) to THREE.Matrix4.\n *\n *  Per 3MF spec (Section 3.5.1) the 12 values are column-major:\n *    Col 0: [v0,v1,v2], Col 1: [v3,v4,v5], Col 2: [v6,v7,v8],\n *    Col 3: [v9,v10,v11] (translation).\n *  THREE.Matrix4.set() takes row-major args, so we transpose.\n *\n * @param v - the 12 column-major transform values (3MF §3.5.1).\n * @returns the equivalent column-major 4×4 THREE.Matrix4.\n */\nexport function mat4From12Values(v: number[]): THREE.Matrix4 {\n  return new THREE.Matrix4().set(\n    v[0], v[3], v[6], v[9],\n    v[1], v[4], v[7], v[10],\n    v[2], v[5], v[8], v[11],\n    0, 0, 0, 1,\n  )\n}\n\n/** Convert a 16-value 4×4 row-major array to THREE.Matrix4.\n *\n * @param v - the 16 row-major matrix values.\n * @returns the equivalent THREE.Matrix4.\n */\nexport function mat4From16Values(v: number[]): THREE.Matrix4 {\n  return new THREE.Matrix4().set(\n    v[0], v[1], v[2], v[3],\n    v[4], v[5], v[6], v[7],\n    v[8], v[9], v[10], v[11],\n    v[12], v[13], v[14], v[15],\n  )\n}\n\n/** Create a translation-only matrix.\n *\n * @param t - the translation [x, y, z].\n * @returns the 4×4 translation matrix.\n */\nexport function makeTranslationMatrix(t: [number, number, number]): THREE.Matrix4 {\n  return new THREE.Matrix4().makeTranslation(t[0], t[1], t[2])\n}\n\n/**\n * Compute the delta matrix to transform a mesh from print-view to the target\n * view: delta = M_target × M_build⁻¹. Returns null when the target view has no\n * data for this object (the caller leaves the mesh as-is).\n *\n * @param viewMode - the target view ('print' | 'assembly' | 'import').\n * @param bambuMeta - Bambu build/assemble/import transform lookups.\n * @param partInfo - the part's objectId/scopedId used to key into `bambuMeta`.\n * @returns the delta matrix, or null when the target view has no data for the part.\n */\nexport function computeViewDelta(\n  viewMode: ViewMode,\n  bambuMeta: ViewMetadata,\n  partInfo: ViewPartInfo,\n): THREE.Matrix4 | null {\n  const objectId = partInfo.objectId\n  if (!objectId) return null\n\n  const buildItem = bambuMeta.buildItems?.find(b => b.objectId === objectId)\n  if (!buildItem?.transform) return null\n  const buildMatrix = mat4From12Values(buildItem.transform)\n\n  if (viewMode === 'assembly') {\n    const assembleItem = bambuMeta.assembleTransforms?.get(objectId)\n    if (!assembleItem) return null\n    const assembleMatrix = mat4From12Values(assembleItem.transform)\n    return assembleMatrix.multiply(buildMatrix.clone().invert())\n  }\n\n  if (viewMode === 'import') {\n    const scopedId = partInfo.scopedId ?? '0'\n    const importItem = bambuMeta.importTransforms?.get(`${objectId}:${scopedId}`)\n    if (!importItem) return null\n    const importMatrix = mat4From16Values(importItem.matrix)\n    importMatrix.multiply(makeTranslationMatrix(importItem.sourceOffset))\n    return importMatrix.multiply(buildMatrix.clone().invert())\n  }\n\n  return null\n}\n\n/** Whether a view mode is available for a given bambu metadata object.\n *\n * @param viewMode - the target view ('print' | 'assembly' | 'import').\n * @param bambuMeta - Bambu assemble/import transform lookups.\n * @returns true when `viewMode` has data available (print always does).\n */\nexport function hasViewData(\n  viewMode: ViewMode,\n  bambuMeta: Pick<Bambu3mfMetadata, 'assembleTransforms' | 'importTransforms'>,\n): boolean {\n  if (viewMode === 'print') return true\n  if (viewMode === 'assembly') return (bambuMeta.assembleTransforms?.size ?? 0) > 0\n  if (viewMode === 'import') return (bambuMeta.importTransforms?.size ?? 0) > 0\n  return false\n}"]}
+{"version":3,"file":"threemf-view.js","sourceRoot":"","sources":["../../src/mesh/threemf-view.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * threemf-view — Bambu view-mode deltas (moved up from 3d_editor's\n * `viewTransforms.ts`, plan §8 decision 2).\n *\n * Bambu stores per-object transforms for three view modes:\n *   print    — the build `<item transform>` (pose on the plate).\n *   assembly — an extra `<assemble_item transform>` + offset (assembled pose).\n *   import   — a per-part 4×4 `matrix` in `model_settings.config` (import pose).\n *\n * To carry a mesh that already has M_build baked in (from `parseThreemf`) to the\n * target pose we need\n *   delta = M_target × M_build⁻¹   (component-level transforms cancel).\n *\n * Matrices are `Mat4` — core already depends on three as a peer dep\n * (io.ts imports THREE.BufferAttribute, brep imports occt-wasm) and the host\n * resolves it. This module is only reachable from the web display path\n * (`@faicad/faijs/mesh/threemf-view`); the weapp bundle never imports it.\n */\nimport { Mat4 } from '../math3d'\nimport type { Bambu3mfMetadata } from './threemf-bambu'\n\n/** Bambu view layout: the pose a part carries on the plate / assembled / import. */\nexport type ViewMode = 'print' | 'assembly' | 'import'\n\n/** Narrowed part identity the view layer keys on (host passes its PartInfo). */\nexport interface ViewPartInfo {\n  objectId?: string\n  scopedId?: string\n}\n\ntype ViewMetadata = Pick<\n  Bambu3mfMetadata,\n  'buildItems' | 'assembleTransforms' | 'importTransforms'\n>\n\n/** Convert a 12-value 4×3 column-major transform (3MF §3.5.1) to Mat4.\n *\n *  Per 3MF spec (Section 3.5.1) the 12 values are column-major:\n *    Col 0: [v0,v1,v2], Col 1: [v3,v4,v5], Col 2: [v6,v7,v8],\n *    Col 3: [v9,v10,v11] (translation).\n *  Mat4.set() takes row-major args, so we transpose.\n *\n * @param v - the 12 column-major transform values (3MF §3.5.1).\n * @returns the equivalent column-major 4×4 Mat4.\n */\nexport function mat4From12Values(v: number[]): Mat4 {\n  return new Mat4().set(\n    v[0], v[3], v[6], v[9],\n    v[1], v[4], v[7], v[10],\n    v[2], v[5], v[8], v[11],\n    0, 0, 0, 1,\n  )\n}\n\n/** Convert a 16-value 4×4 row-major array to Mat4.\n *\n * @param v - the 16 row-major matrix values.\n * @returns the equivalent Mat4.\n */\nexport function mat4From16Values(v: number[]): Mat4 {\n  return new Mat4().set(\n    v[0], v[1], v[2], v[3],\n    v[4], v[5], v[6], v[7],\n    v[8], v[9], v[10], v[11],\n    v[12], v[13], v[14], v[15],\n  )\n}\n\n/** Create a translation-only matrix.\n *\n * @param t - the translation [x, y, z].\n * @returns the 4×4 translation matrix.\n */\nexport function makeTranslationMatrix(t: [number, number, number]): Mat4 {\n  return new Mat4().makeTranslation(t[0], t[1], t[2])\n}\n\n/**\n * Compute the delta matrix to transform a mesh from print-view to the target\n * view: delta = M_target × M_build⁻¹. Returns null when the target view has no\n * data for this object (the caller leaves the mesh as-is).\n *\n * @param viewMode - the target view ('print' | 'assembly' | 'import').\n * @param bambuMeta - Bambu build/assemble/import transform lookups.\n * @param partInfo - the part's objectId/scopedId used to key into `bambuMeta`.\n * @returns the delta matrix, or null when the target view has no data for the part.\n */\nexport function computeViewDelta(\n  viewMode: ViewMode,\n  bambuMeta: ViewMetadata,\n  partInfo: ViewPartInfo,\n): Mat4 | null {\n  const objectId = partInfo.objectId\n  if (!objectId) return null\n\n  const buildItem = bambuMeta.buildItems?.find(b => b.objectId === objectId)\n  if (!buildItem?.transform) return null\n  const buildMatrix = mat4From12Values(buildItem.transform)\n\n  if (viewMode === 'assembly') {\n    const assembleItem = bambuMeta.assembleTransforms?.get(objectId)\n    if (!assembleItem) return null\n    const assembleMatrix = mat4From12Values(assembleItem.transform)\n    return assembleMatrix.multiply(buildMatrix.clone().invert())\n  }\n\n  if (viewMode === 'import') {\n    const scopedId = partInfo.scopedId ?? '0'\n    const importItem = bambuMeta.importTransforms?.get(`${objectId}:${scopedId}`)\n    if (!importItem) return null\n    const importMatrix = mat4From16Values(importItem.matrix)\n    importMatrix.multiply(makeTranslationMatrix(importItem.sourceOffset))\n    return importMatrix.multiply(buildMatrix.clone().invert())\n  }\n\n  return null\n}\n\n/** Whether a view mode is available for a given bambu metadata object.\n *\n * @param viewMode - the target view ('print' | 'assembly' | 'import').\n * @param bambuMeta - Bambu assemble/import transform lookups.\n * @returns true when `viewMode` has data available (print always does).\n */\nexport function hasViewData(\n  viewMode: ViewMode,\n  bambuMeta: Pick<Bambu3mfMetadata, 'assembleTransforms' | 'importTransforms'>,\n): boolean {\n  if (viewMode === 'print') return true\n  if (viewMode === 'assembly') return (bambuMeta.assembleTransforms?.size ?? 0) > 0\n  if (viewMode === 'import') return (bambuMeta.importTransforms?.size ?? 0) > 0\n  return false\n}"]}

package/dist/mesh/transform.d.ts

@@ -10,16 +10,19 @@
  * - 执行器（dispatcher / runtime.execute）调用这些函数将变换烘焙进几何
  * - 交互拖拽期间的预览仍由 partTransforms（渲染层瞬态）承担
  *   确认后由引擎重放语句完成烘焙（P2）
+ *
+ * 数学层：three 已由 `../math3d` 替代（Vec3/Mat4/Euler 为 r162 逐位移植）。
  */
-import * as THREE from 'three';
-import type { Shape, Vec3 } from './types.js';
+import { type MatrixLike } from '../math3d/index.js';
+import type { Shape } from './types.js';
+import type { Vec3 as Vec3Tuple } 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;
+export declare function translate(shape: Shape, offset: Vec3Tuple): Shape;
 /**
  * Rotate a mesh shape by baking the rotation into its vertices (angles in
  * degrees, optionally about a pivot).
@@ -28,7 +31,7 @@ export declare function translate(shape: Shape, offset: Vec3): Shape;
  * @param pivot - optional rotation pivot point in mm.
  * @returns a new shape with rotated vertices.
  */
-export declare function rotate_euler(shape: Shape, angles: Vec3, pivot?: Vec3): Shape;
+export declare function rotate_euler(shape: Shape, angles: Vec3Tuple, pivot?: Vec3Tuple): Shape;
 /**
  * Scale a mesh shape by baking the factor into its vertices.
  * @param shape - the mesh shape to scale.
@@ -36,7 +39,7 @@ export declare function rotate_euler(shape: Shape, angles: Vec3, pivot?: Vec3):
  * @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;
+export declare function scale3d(shape: Shape, factor: number | Vec3Tuple, center?: Vec3Tuple): Shape;
 /**
  * Uniformly scale a mesh shape (原 brepjs `scale` 契约，P6 §4.6)。后台用
  * `scale3d` 的等比参数；`center` 为缩放不动的点，默认原点。
@@ -45,13 +48,16 @@ export declare function scale3d(shape: Shape, factor: number | Vec3, center?: Ve
  * @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;
+export declare function scale(shape: Shape, factor: number, center?: Vec3Tuple): Shape;
 /**
- * Transform a mesh shape with an arbitrary THREE.Matrix4 (corresponds to the
+ * Transform a mesh shape with an arbitrary 4x4 matrix (corresponds to the
  * existing transformMeshData function).
+ *
+ * 参数类型为结构化的 `MatrixLike`（`{ elements: number[] }`）——three.Matrix4
+ * 与 core 的 `Mat4` 都满足，避免把公开 API 绑死在某一个矩阵类上。
  * @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;
+export declare function transformMatrix(shape: Shape, matrix: MatrixLike): Shape;
 //# sourceMappingURL=transform.d.ts.map

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

@@ -1 +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,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAY5E;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"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/mesh/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,KAAK,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,SAAS,CAAA;AAEhD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAG,KAAK,CAQhE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,CAYtF;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,CAI3F;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,CAE7E;AA0BD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,GAAG,KAAK,CAEvE"}

package/dist/mesh/transform.js

@@ -10,8 +10,10 @@
  * - 执行器（dispatcher / runtime.execute）调用这些函数将变换烘焙进几何
  * - 交互拖拽期间的预览仍由 partTransforms（渲染层瞬态）承担
  *   确认后由引擎重放语句完成烘焙（P2）
+ *
+ * 数学层：three 已由 `../math3d` 替代（Vec3/Mat4/Euler 为 r162 逐位移植）。
  */
-import * as THREE from 'three';
+import { Vec3, Mat4, Euler } from '../math3d/index.js';
 /**
  * Translate a mesh shape by baking the offset into its vertices.
  * @param shape - the mesh shape to translate.
@@ -25,7 +27,7 @@ export function translate(shape, offset) {
         positions[i + 1] += offset[1];
         positions[i + 2] += offset[2];
     }
-    return { positions, indices: shape.indices };
+    return { ...shape, positions };
 }
 /**
  * Rotate a mesh shape by baking the rotation into its vertices (angles in
@@ -36,11 +38,11 @@ export function translate(shape, offset) {
  * @returns a new shape with rotated vertices.
  */
 export function rotate_euler(shape, angles, pivot) {
-    const euler = new THREE.Euler((angles[0] * Math.PI) / 180, (angles[1] * Math.PI) / 180, (angles[2] * Math.PI) / 180);
-    const matrix = new THREE.Matrix4().makeRotationFromEuler(euler);
+    const euler = new Euler((angles[0] * Math.PI) / 180, (angles[1] * Math.PI) / 180, (angles[2] * Math.PI) / 180);
+    const matrix = new Mat4().makeRotationFromEuler(euler);
     if (pivot) {
-        matrix.premultiply(new THREE.Matrix4().makeTranslation(pivot[0], pivot[1], pivot[2]));
-        matrix.multiply(new THREE.Matrix4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]));
+        matrix.premultiply(new Mat4().makeTranslation(pivot[0], pivot[1], pivot[2]));
+        matrix.multiply(new Mat4().makeTranslation(-pivot[0], -pivot[1], -pivot[2]));
     }
     return applyMatrix(shape, matrix);
 }
@@ -68,18 +70,18 @@ export function scale(shape, factor, center) {
 }
 /** 缩放矩阵：围绕 `center`（缺省原点）构造 T(c)·S·T(−c)。 */
 function scaleMatrix(f, center) {
-    const s = new THREE.Matrix4().makeScale(f[0], f[1], f[2]);
+    const s = new Mat4().makeScale(f[0], f[1], f[2]);
     if (!center)
         return s;
-    return new THREE.Matrix4()
+    return new Mat4()
         .makeTranslation(center[0], center[1], center[2])
         .multiply(s)
-        .multiply(new THREE.Matrix4().makeTranslation(-center[0], -center[1], -center[2]));
+        .multiply(new Mat4().makeTranslation(-center[0], -center[1], -center[2]));
 }
-/** 用 THREE.Matrix4 变换几何 */
+/** 用 4x4 矩阵变换几何 */
 function applyMatrix(shape, matrix) {
     const positions = new Float32Array(shape.positions);
-    const v = new THREE.Vector3();
+    const v = new Vec3();
     for (let i = 0; i < positions.length; i += 3) {
         v.set(positions[i], positions[i + 1], positions[i + 2]);
         v.applyMatrix4(matrix);
@@ -87,11 +89,14 @@ function applyMatrix(shape, matrix) {
         positions[i + 1] = v.y;
         positions[i + 2] = v.z;
     }
-    return { positions, indices: shape.indices };
+    return { ...shape, positions };
 }
 /**
- * Transform a mesh shape with an arbitrary THREE.Matrix4 (corresponds to the
+ * Transform a mesh shape with an arbitrary 4x4 matrix (corresponds to the
  * existing transformMeshData function).
+ *
+ * 参数类型为结构化的 `MatrixLike`（`{ elements: number[] }`）——three.Matrix4
+ * 与 core 的 `Mat4` 都满足，避免把公开 API 绑死在某一个矩阵类上。
  * @param shape - the mesh shape to transform.
  * @param matrix - the 4x4 transform matrix to apply.
  * @returns a new shape with transformed vertices.

package/dist/mesh/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/mesh/transform.ts"],"names":[],"mappings":"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","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 angles - 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, angles: Vec3, pivot?: Vec3): Shape {\n  const euler = new THREE.Euler(\n    (angles[0] * Math.PI) / 180,\n    (angles[1] * Math.PI) / 180,\n    (angles[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"]}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/mesh/transform.ts"],"names":[],"mappings":"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","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 * 数学层：three 已由 `../math3d` 替代（Vec3/Mat4/Euler 为 r162 逐位移植）。\n */\n\nimport { Vec3, Mat4, Euler, type MatrixLike } from '../math3d'\nimport type { Shape } from './types'\nimport type { Vec3 as Vec3Tuple } 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: Vec3Tuple): 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 { ...shape, positions }\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 angles - 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, angles: Vec3Tuple, pivot?: Vec3Tuple): Shape {\n  const euler = new Euler(\n    (angles[0] * Math.PI) / 180,\n    (angles[1] * Math.PI) / 180,\n    (angles[2] * Math.PI) / 180,\n  )\n  const matrix = new Mat4().makeRotationFromEuler(euler)\n  if (pivot) {\n    matrix.premultiply(new Mat4().makeTranslation(pivot[0], pivot[1], pivot[2]))\n    matrix.multiply(new Mat4().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 | Vec3Tuple, center?: Vec3Tuple): 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?: Vec3Tuple): 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?: Vec3Tuple): Mat4 {\n  const s = new Mat4().makeScale(f[0], f[1], f[2])\n  if (!center) return s\n  return new Mat4()\n    .makeTranslation(center[0], center[1], center[2])\n    .multiply(s)\n    .multiply(new Mat4().makeTranslation(-center[0], -center[1], -center[2]))\n}\n\n/** 用 4x4 矩阵变换几何 */\nfunction applyMatrix(shape: Shape, matrix: MatrixLike): Shape {\n  const positions = new Float32Array(shape.positions)\n  const v = new Vec3()\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 { ...shape, positions }\n}\n\n/**\n * Transform a mesh shape with an arbitrary 4x4 matrix (corresponds to the\n * existing transformMeshData function).\n *\n * 参数类型为结构化的 `MatrixLike`（`{ elements: number[] }`）——three.Matrix4\n * 与 core 的 `Mat4` 都满足，避免把公开 API 绑死在某一个矩阵类上。\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: MatrixLike): Shape {\n  return applyMatrix(shape, matrix)\n}\n"]}

package/dist/mesh/types.d.ts

@@ -36,6 +36,8 @@ export type JsonValue = string | number | boolean | null | JsonValue[] | {
 export interface Shape {
     positions: Float32Array;
     indices: Uint32Array;
+    /** Per-vertex normals (x, y, z interleaved), length = positions.length. Optional; derived via creased-normals when absent. */
+    normals?: Float32Array;
     /** 可选：形状级外观（mesh/brep 双链路产物自解释；worker 序列化保留字段、不保留方法）。 */
     appearance?: PbrAppearance;
     /** Phase 2：面级外观分组 [三角形起始, 数量, 外观]；存在时优先于 appearance 作为未分组默认。 */

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

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

package/dist/mesh/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mesh/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqFH;;;;;;;;;;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\nimport type { PbrAppearance } from '../api/appearance'\nimport type { ShapeMeta } from '../api/meta'\n\n// ── 基础类型 ──\n\n/** 三维坐标 / RGB 颜色元组（分量 sRGB 0–1）。 */\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 *\n * 外观（PBR）：`appearance` 为可选数据字段（设计文档 2026-10-05 v2 §4.2），\n * 双链路产物自解释、可序列化；外观设置是 Shape **方法**（非 op，见\n * `api/appearance.ts` 的 `ShapeAppearanceMethods` / `attachAppearanceMethods`），\n * 方法只挂载在产物构造点（solid/curve）返回的实例上，基础 Shape 保持纯数据\n * 契约——因此本接口**不** extends 方法接口，`isMeshShape` 鸭子判定不受影响。\n */\nexport interface Shape {\n  positions: Float32Array\n  indices: Uint32Array\n  /** 可选：形状级外观（mesh/brep 双链路产物自解释；worker 序列化保留字段、不保留方法）。 */\n  appearance?: PbrAppearance\n  /** Phase 2：面级外观分组 [三角形起始, 数量, 外观]；存在时优先于 appearance 作为未分组默认。 */\n  materialGroups?: Array<{ start: number; count: number; appearance: PbrAppearance }>\n  /** Phase 2：顶点颜色（3MF colorgroup / 面级 mesh 链），sRGB 0–1，长度 = positions 长度。 */\n  vertexColors?: Float32Array\n  /**\n   * 零件级说明性元数据（设计文档 2026-10-05-meta §4.3）：名称/描述/料号/自定义\n   * 键值，随 Shape 走 mesh/brep 双链路、JSON 可序列化。设置方法是 Shape 实例\n   * 方法（非 op，见 `api/meta.ts` 的 `ShapeMetaMethods` / `attachMetaMethods`），\n   * 方法只挂载在产物构造点（solid/curve）返回的实例上，基础 Shape 保持纯数据\n   * 契约——因此本接口**不** extends 方法接口，`isMeshShape` 鸭子判定不受影响。\n   */\n  meta?: ShapeMeta\n  /**\n   * 装配节点位姿（方案 2026-10-08 §2.1「装配模型 = 节点属性，单一真源」）：节点\n   * **相对其父**的位置/姿态。可选、纯数据、JSON 可序列化——与 `appearance` /\n   * `meta` 同为**字段**而非方法，随 Shape 一起过 worker 序列化与 `structuredClone`\n   * （`isMeshShape` 鸭子判定不看本字段）。装配层级就是 Shape / CompoundShape\n   * 自身的 `children` + 本字段，**没有**平行的装配树。\n   *\n   * 取值形态（三种等价书写，均为可序列化纯数据）：`translate` 平移；`rotate`\n   * 单一轴角（`angle` 按本文件约定用**度**，`axis` 为轴向量）；`matrix` 3×4\n   * 行主序 12 元组——即 3MF `<component transform>` 与 XCAF location 的直接形态。\n   * 三者的复合顺序与形态间优先级由读侧实现固定（§5 第 4、5 步），本字段只定\n   * 义取值形态。\n   *\n   * 写入方两个、写回同一字段：导入侧（XCAF location / 3MF component transform）\n   * 与求解侧（`AssemblyTransform[]`）。导出侧**只读**它：STL 顶点烘焙、3MF\n   * `<component transform>`、STEP XCAF location（§2.1 映射表）。分量刻度与\n   * `positions` 同（基准单位），换算到声明单位由写出器成对完成（§2.1）。\n   *\n   * 阶段说明：本字段随 §5 第 3 步引入；写出器在 §5 第 4（3MF components）、第 5\n   * （导入归一 / STL 烘焙）步之前不消费它（`export-model.test.ts` 用「带与不带\n   * `transform` 的导出字节相等」钉住这一当前事实，届时翻转）。\n   */\n  transform?: { translate?: Vec3; rotate?: { angle: number; axis?: Vec3 }; matrix?: number[] }\n  /**\n   * 面结构元数据：面序号 → 三角形区间 [start, count)（start/count 为三角形索引，\n   * 对应 positions/indices 焊接后的三角形序列）。仅参数化 primitives 构造时记录\n   * （面结构构造时已知、三角形顺序固定）；manifold 布尔/组合/导入后无 CAD 面\n   * 概念，本字段不存在。`setFaceColor`/`setFaceMaterial` 依赖本字段把面序号映射\n   * 到三角形区间并写入 materialGroups。\n   */\n  faceRanges?: Array<{ start: number; count: number }>\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  angles: 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  planeDistance: 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"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mesh/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuFH;;;;;;;;;;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\nimport type { PbrAppearance } from '../api/appearance'\nimport type { ShapeMeta } from '../api/meta'\n\n// ── 基础类型 ──\n\n/** 三维坐标 / RGB 颜色元组（分量 sRGB 0–1）。 */\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 *\n * 外观（PBR）：`appearance` 为可选数据字段（设计文档 2026-10-05 v2 §4.2），\n * 双链路产物自解释、可序列化；外观设置是 Shape **方法**（非 op，见\n * `api/appearance.ts` 的 `ShapeAppearanceMethods` / `attachAppearanceMethods`），\n * 方法只挂载在产物构造点（solid/curve）返回的实例上，基础 Shape 保持纯数据\n * 契约——因此本接口**不** extends 方法接口，`isMeshShape` 鸭子判定不受影响。\n */\nexport interface Shape {\n  positions: Float32Array\n  indices: Uint32Array\n  /** Per-vertex normals (x, y, z interleaved), length = positions.length. Optional; derived via creased-normals when absent. */\n  normals?: Float32Array\n  /** 可选：形状级外观（mesh/brep 双链路产物自解释；worker 序列化保留字段、不保留方法）。 */\n  appearance?: PbrAppearance\n  /** Phase 2：面级外观分组 [三角形起始, 数量, 外观]；存在时优先于 appearance 作为未分组默认。 */\n  materialGroups?: Array<{ start: number; count: number; appearance: PbrAppearance }>\n  /** Phase 2：顶点颜色（3MF colorgroup / 面级 mesh 链），sRGB 0–1，长度 = positions 长度。 */\n  vertexColors?: Float32Array\n  /**\n   * 零件级说明性元数据（设计文档 2026-10-05-meta §4.3）：名称/描述/料号/自定义\n   * 键值，随 Shape 走 mesh/brep 双链路、JSON 可序列化。设置方法是 Shape 实例\n   * 方法（非 op，见 `api/meta.ts` 的 `ShapeMetaMethods` / `attachMetaMethods`），\n   * 方法只挂载在产物构造点（solid/curve）返回的实例上，基础 Shape 保持纯数据\n   * 契约——因此本接口**不** extends 方法接口，`isMeshShape` 鸭子判定不受影响。\n   */\n  meta?: ShapeMeta\n  /**\n   * 装配节点位姿（方案 2026-10-08 §2.1「装配模型 = 节点属性，单一真源」）：节点\n   * **相对其父**的位置/姿态。可选、纯数据、JSON 可序列化——与 `appearance` /\n   * `meta` 同为**字段**而非方法，随 Shape 一起过 worker 序列化与 `structuredClone`\n   * （`isMeshShape` 鸭子判定不看本字段）。装配层级就是 Shape / CompoundShape\n   * 自身的 `children` + 本字段，**没有**平行的装配树。\n   *\n   * 取值形态（三种等价书写，均为可序列化纯数据）：`translate` 平移；`rotate`\n   * 单一轴角（`angle` 按本文件约定用**度**，`axis` 为轴向量）；`matrix` 3×4\n   * 行主序 12 元组——即 3MF `<component transform>` 与 XCAF location 的直接形态。\n   * 三者的复合顺序与形态间优先级由读侧实现固定（§5 第 4、5 步），本字段只定\n   * 义取值形态。\n   *\n   * 写入方两个、写回同一字段：导入侧（XCAF location / 3MF component transform）\n   * 与求解侧（`AssemblyTransform[]`）。导出侧**只读**它：STL 顶点烘焙、3MF\n   * `<component transform>`、STEP XCAF location（§2.1 映射表）。分量刻度与\n   * `positions` 同（基准单位），换算到声明单位由写出器成对完成（§2.1）。\n   *\n   * 阶段说明：本字段随 §5 第 3 步引入；写出器在 §5 第 4（3MF components）、第 5\n   * （导入归一 / STL 烘焙）步之前不消费它（`export-model.test.ts` 用「带与不带\n   * `transform` 的导出字节相等」钉住这一当前事实，届时翻转）。\n   */\n  transform?: { translate?: Vec3; rotate?: { angle: number; axis?: Vec3 }; matrix?: number[] }\n  /**\n   * 面结构元数据：面序号 → 三角形区间 [start, count)（start/count 为三角形索引，\n   * 对应 positions/indices 焊接后的三角形序列）。仅参数化 primitives 构造时记录\n   * （面结构构造时已知、三角形顺序固定）；manifold 布尔/组合/导入后无 CAD 面\n   * 概念，本字段不存在。`setFaceColor`/`setFaceMaterial` 依赖本字段把面序号映射\n   * 到三角形区间并写入 materialGroups。\n   */\n  faceRanges?: Array<{ start: number; count: number }>\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  angles: 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  planeDistance: 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/occt-kernel/occt-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"occt-primitives.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/occt-primitives.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAqE5F;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,CA4XnE;AAED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAA;AAI7E,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAA"}
+{"version":3,"file":"occt-primitives.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/occt-primitives.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,4BAA4B,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAqE5F;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,aAAa,CAAC,CA8YnE;AAED,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAA;AAI7E,0EAA0E;AAC1E,MAAM,MAAM,cAAc,GAAG,4BAA4B,CAAC,cAAc,CAAC,CAAA"}

package/dist/occt-kernel/occt-primitives.js

@@ -99,6 +99,26 @@ export async function createOcctPrimitives() {
         // ── shaping ──
         extrude: (shape, dx, dy, dz) => asHandle(k.extrude(asShape(shape), dx, dy, dz)),
         revolveVec: (shape, center, direction, angleDeg) => asHandle(k.revolve(asShape(shape), { point: center, direction }, rad(angleDeg))),
+        // L1 中立 sweep：occt 侧 native sweepPipeShell 的 (profile, spine) 与 L1 同形，
+        // 只补齐两个默认开关（freenet=false / smooth=false，与旧 sweepFns 的默认路径
+        // 逐字节一致）；brepkit 侧的 face/NURBS 适配在 brepkitKernel 内。
+        // ⚠️ 不用 native `simplePipe`：实测它对本用例的 8×8 方截面沿 +Z 扫 50 产出
+        // 体积 2133.33，而 sweepPipeShell 产出解析值 3200（`test/api/sweep-loft.test.ts`
+        // 的「两个 2D 面截面」用例即为该真值）——基础 sweep 必须与既有行为一致。
+        sweep: (profile, spine) => asHandle(k.sweepPipeShell(asShape(profile), asShape(spine), false, false)),
+        // L1 中立 loft：occt 原生 loft 吃 wire，只作 endPoint → loftWithVertices 的退化解。
+        loft: (sections, ruled, endPoint) => {
+            const wires = shapes(sections);
+            if (endPoint === undefined)
+                return asHandle(k.loft(wires, true, ruled));
+            const end = k.makeVertex(endPoint.x, endPoint.y, endPoint.z);
+            try {
+                return asHandle(k.loftWithVertices(wires, true, ruled, undefined, end));
+            }
+            finally {
+                k.release(end);
+            }
+        },
         sew: (list, tolerance) => asHandle(k.sew(shapes(list), tolerance)),
         sewAndSolidify: (faces, tolerance) => asHandle(k.sewAndSolidify(shapes(faces), tolerance)),
         shell: (solid, facesToRemove, thickness, tolerance) => asHandle(k.shell(asShape(solid), shapes(facesToRemove), thickness, tolerance)),