@faicad/faijs 0.30.9 → 0.32.2

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 作为未分组默认。 */
@@ -54,6 +56,36 @@ export interface Shape {
      * 契约——因此本接口**不** extends 方法接口，`isMeshShape` 鸭子判定不受影响。
      */
     meta?: ShapeMeta;
+    /**
+     * 装配节点位姿（方案 2026-10-08 §2.1「装配模型 = 节点属性，单一真源」）：节点
+     * **相对其父**的位置/姿态。可选、纯数据、JSON 可序列化——与 `appearance` /
+     * `meta` 同为**字段**而非方法，随 Shape 一起过 worker 序列化与 `structuredClone`
+     * （`isMeshShape` 鸭子判定不看本字段）。装配层级就是 Shape / CompoundShape
+     * 自身的 `children` + 本字段，**没有**平行的装配树。
+     *
+     * 取值形态（三种等价书写，均为可序列化纯数据）：`translate` 平移；`rotate`
+     * 单一轴角（`angle` 按本文件约定用**度**，`axis` 为轴向量）；`matrix` 3×4
+     * 行主序 12 元组——即 3MF `<component transform>` 与 XCAF location 的直接形态。
+     * 三者的复合顺序与形态间优先级由读侧实现固定（§5 第 4、5 步），本字段只定
+     * 义取值形态。
+     *
+     * 写入方两个、写回同一字段：导入侧（XCAF location / 3MF component transform）
+     * 与求解侧（`AssemblyTransform[]`）。导出侧**只读**它：STL 顶点烘焙、3MF
+     * `<component transform>`、STEP XCAF location（§2.1 映射表）。分量刻度与
+     * `positions` 同（基准单位），换算到声明单位由写出器成对完成（§2.1）。
+     *
+     * 阶段说明：本字段随 §5 第 3 步引入；写出器在 §5 第 4（3MF components）、第 5
+     * （导入归一 / STL 烘焙）步之前不消费它（`export-model.test.ts` 用「带与不带
+     * `transform` 的导出字节相等」钉住这一当前事实，届时翻转）。
+     */
+    transform?: {
+        translate?: Vec3;
+        rotate?: {
+            angle: number;
+            axis?: Vec3;
+        };
+        matrix?: number[];
+    };
     /**
      * 面结构元数据：面序号 → 三角形区间 [start, count)（start/count 为三角形索引，
      * 对应 positions/indices 焊接后的三角形序列）。仅参数化 primitives 构造时记录

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;AA8DH;;;;;;;;;;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   * 面结构元数据：面序号 → 三角形区间 [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/node-host/execute-script.d.ts

@@ -5,7 +5,8 @@
  * 发布 tarball 不含 `scripts/`，此前没有「给 `.fai.js` 源码字符串 → 直接拿到产物」的
  * 公开函数，每个下游各自内联 CLI 包装器，并各自重复踩 Host 装配的三个坑
  * （不 registerOcctBrepEngine → BREP engine API not available；configureBackends 漏
- * brepCapabilities → E_BREP_UNSUPPORTED；把 defineOp 返回的 Promise<Shape> 当 Result 判）。
+ * `config.brepEngineId` → 平台 op 静态被拒 `E_BREP_UNSUPPORTED`；把 defineOp 返回的
+ * Promise<Shape> 当 Result 判）。
  * 本函数把装配知识固化在一处（与 cliRun 同一套装配）。
  *
  * 仅 Node.js：经 `@faicad/faijs/node` 导入，不要进浏览器构建（依赖 node-host）。

package/dist/node-host/execute-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute-script.d.ts","sourceRoot":"","sources":["../../src/node-host/execute-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAKpD,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACpC;AAED,yBAAyB;AACzB,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,kBAAkB;IAClB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAkB9B"}
+{"version":3,"file":"execute-script.d.ts","sourceRoot":"","sources":["../../src/node-host/execute-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAKpD,yBAAyB;AACzB,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CACpC;AAED,yBAAyB;AACzB,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAA;IAC1B,kBAAkB;IAClB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAkB9B"}

package/dist/node-host/execute-script.js

@@ -5,14 +5,15 @@
  * 发布 tarball 不含 `scripts/`，此前没有「给 `.fai.js` 源码字符串 → 直接拿到产物」的
  * 公开函数，每个下游各自内联 CLI 包装器，并各自重复踩 Host 装配的三个坑
  * （不 registerOcctBrepEngine → BREP engine API not available；configureBackends 漏
- * brepCapabilities → E_BREP_UNSUPPORTED；把 defineOp 返回的 Promise<Shape> 当 Result 判）。
+ * `config.brepEngineId` → 平台 op 静态被拒 `E_BREP_UNSUPPORTED`；把 defineOp 返回的
+ * Promise<Shape> 当 Result 判）。
  * 本函数把装配知识固化在一处（与 cliRun 同一套装配）。
  *
  * 仅 Node.js：经 `@faicad/faijs/node` 导入，不要进浏览器构建（依赖 node-host）。
  */
-// The facade-level createRuntime (cad-runtime/createRuntimeWithCad) self-registers
-// the built-in cad namespace; the bare cad-runtime/runtime one does not (D1).
-import { createRuntime } from '../cad-runtime/createRuntimeWithCad.js';
+// createRuntime (cad-runtime/runtime) auto-registers the built-in cad
+// namespace as the default lib (D1, facade-refactor 2026-10-08).
+import { createRuntime } from '../cad-runtime/runtime.js';
 import { registerOcctBrepEngine } from '../brep/engine/adapters/occt.js';
 import { createNodePorts } from './index.js';
 import { withCliLibLoader } from './cli.js';

package/dist/node-host/execute-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute-script.js","sourceRoot":"","sources":["../../src/node-host/execute-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,mFAAmF;AACnF,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAA;AAKnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAyBxC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,IAA2B;IAE3B,uFAAuF;IACvF,MAAM,sBAAsB,EAAE,CAAA;IAE9B,MAAM,KAAK,GAAG,gBAAgB,CAAC,eAAe,EAAE,CAAC,CAAA;IACjD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAEtE,+EAA+E;IAC/E,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAA;IAC5F,CAAC;IAED,MAAM,UAAU,GAAoB,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,SAAS,IAAI,EAAE;QACrC,WAAW,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE;QACnC,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAA;AACH,CAAC","sourcesContent":["/**\n * execute-script — 一等「代码字符串 → 产物」执行 API（计划 B6，2026-10-06）。\n *\n * 动机：\n * 发布 tarball 不含 `scripts/`，此前没有「给 `.fai.js` 源码字符串 → 直接拿到产物」的\n * 公开函数，每个下游各自内联 CLI 包装器，并各自重复踩 Host 装配的三个坑\n * （不 registerOcctBrepEngine → BREP engine API not available；configureBackends 漏\n * brepCapabilities → E_BREP_UNSUPPORTED；把 defineOp 返回的 Promise<Shape> 当 Result 判）。\n * 本函数把装配知识固化在一处（与 cliRun 同一套装配）。\n *\n * 仅 Node.js：经 `@faicad/faijs/node` 导入，不要进浏览器构建（依赖 node-host）。\n */\n\n// The facade-level createRuntime (cad-runtime/createRuntimeWithCad) self-registers\n// the built-in cad namespace; the bare cad-runtime/runtime one does not (D1).\nimport { createRuntime } from '../cad-runtime/createRuntimeWithCad'\nimport type { ExecutionResult } from '../cad-runtime/runtime'\nimport type { ExecutionMode, LibLoader } from '../cad-runtime/ports'\nimport type { TerminalShape } from '../lang/types'\nimport type { LibNamespace } from '../runtime-state'\nimport { registerOcctBrepEngine } from '../brep/engine/adapters/occt'\nimport { createNodePorts } from './index'\nimport { withCliLibLoader } from './cli'\n\n/** executeScript 的选项。 */\nexport interface ExecuteScriptOptions {\n  /** 执行模式（缺省 `auto`）。 */\n  mode?: ExecutionMode\n  /** 第三方库装载器（缺省：`@faicad/*` scoped 包动态 import，与 CLI 相同）。 */\n  libLoader?: LibLoader\n  /**\n   * 额外登记的库命名空间（如 cad 面的 sketch 扩展）。key 为 specifier 短名。\n   * `cad` 项以 default 命名空间登记（脚本可免 import 使用）。\n   */\n  libs?: Record<string, LibNamespace>\n}\n\n/** executeScript 的产物。 */\nexport interface ExecuteScriptResult {\n  /** 终端形状（几何产物；失败时为空数组）。 */\n  terminals: TerminalShape[]\n  /** 确定性警告等诊断信息。 */\n  diagnostics: string[]\n  /** 失败时的语句定位（与 ExecutionResult.failedAt 一致）；成功为 undefined。 */\n  failedAt?: { index: number; callee: string; message: string; lineNo?: number; code?: string }\n}\n\n/**\n * 执行一段 `.fai.js` 源码字符串并返回产物。\n *\n * 内部完成完整 Host 装配（node ports + libLoader + OCCT BREP 引擎注册），\n * 调用方无需再自行装配——这正是 B4 三个装配坑的固化出口。\n *\n * @param code `.fai.js` 源码字符串\n * @param opts 可选：执行模式、库装载器、额外库命名空间\n * @returns 终端形状、诊断信息与失败定位（`Promise<ExecuteScriptResult>`）；\n *          执行失败以 `failedAt` 结构化返回，不抛异常。\n */\nexport async function executeScript(\n  code: string,\n  opts?: ExecuteScriptOptions,\n): Promise<ExecuteScriptResult> {\n  // registerOcctBrepEngine is idempotent and itself boots initOcctWasm (same as cliRun).\n  await registerOcctBrepEngine()\n\n  const ports = withCliLibLoader(createNodePorts())\n  const runtime = createRuntime(ports, opts?.mode ?? 'auto', opts?.libs)\n\n  // cad 经 registerLib 声明 packageName，脚本可 `import * as cad from '@faicad/faijs'`。\n  if (opts?.libs?.cad) {\n    runtime.registerLib('cad', opts.libs.cad, { default: true, packageName: '@faicad/faijs' })\n  }\n\n  const execResult: ExecutionResult = await runtime.execute(code)\n  return {\n    terminals: execResult.terminals ?? [],\n    diagnostics: execResult.infos ?? [],\n    failedAt: execResult.failedAt,\n  }\n}\n"]}
+{"version":3,"file":"execute-script.js","sourceRoot":"","sources":["../../src/node-host/execute-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,sEAAsE;AACtE,iEAAiE;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAKtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAyBxC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,IAA2B;IAE3B,uFAAuF;IACvF,MAAM,sBAAsB,EAAE,CAAA;IAE9B,MAAM,KAAK,GAAG,gBAAgB,CAAC,eAAe,EAAE,CAAC,CAAA;IACjD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAEtE,+EAA+E;IAC/E,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC,CAAA;IAC5F,CAAC;IAED,MAAM,UAAU,GAAoB,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/D,OAAO;QACL,SAAS,EAAE,UAAU,CAAC,SAAS,IAAI,EAAE;QACrC,WAAW,EAAE,UAAU,CAAC,KAAK,IAAI,EAAE;QACnC,QAAQ,EAAE,UAAU,CAAC,QAAQ;KAC9B,CAAA;AACH,CAAC","sourcesContent":["/**\n * execute-script — 一等「代码字符串 → 产物」执行 API（计划 B6，2026-10-06）。\n *\n * 动机：\n * 发布 tarball 不含 `scripts/`，此前没有「给 `.fai.js` 源码字符串 → 直接拿到产物」的\n * 公开函数，每个下游各自内联 CLI 包装器，并各自重复踩 Host 装配的三个坑\n * （不 registerOcctBrepEngine → BREP engine API not available；configureBackends 漏\n * `config.brepEngineId` → 平台 op 静态被拒 `E_BREP_UNSUPPORTED`；把 defineOp 返回的\n * Promise<Shape> 当 Result 判）。\n * 本函数把装配知识固化在一处（与 cliRun 同一套装配）。\n *\n * 仅 Node.js：经 `@faicad/faijs/node` 导入，不要进浏览器构建（依赖 node-host）。\n */\n\n// createRuntime (cad-runtime/runtime) auto-registers the built-in cad\n// namespace as the default lib (D1, facade-refactor 2026-10-08).\nimport { createRuntime } from '../cad-runtime/runtime'\nimport type { ExecutionResult } from '../cad-runtime/runtime'\nimport type { ExecutionMode, LibLoader } from '../cad-runtime/ports'\nimport type { TerminalShape } from '../lang/types'\nimport type { LibNamespace } from '../runtime-state'\nimport { registerOcctBrepEngine } from '../brep/engine/adapters/occt'\nimport { createNodePorts } from './index'\nimport { withCliLibLoader } from './cli'\n\n/** executeScript 的选项。 */\nexport interface ExecuteScriptOptions {\n  /** 执行模式（缺省 `auto`）。 */\n  mode?: ExecutionMode\n  /** 第三方库装载器（缺省：`@faicad/*` scoped 包动态 import，与 CLI 相同）。 */\n  libLoader?: LibLoader\n  /**\n   * 额外登记的库命名空间（如 cad 面的 sketch 扩展）。key 为 specifier 短名。\n   * `cad` 项以 default 命名空间登记（脚本可免 import 使用）。\n   */\n  libs?: Record<string, LibNamespace>\n}\n\n/** executeScript 的产物。 */\nexport interface ExecuteScriptResult {\n  /** 终端形状（几何产物；失败时为空数组）。 */\n  terminals: TerminalShape[]\n  /** 确定性警告等诊断信息。 */\n  diagnostics: string[]\n  /** 失败时的语句定位（与 ExecutionResult.failedAt 一致）；成功为 undefined。 */\n  failedAt?: { index: number; callee: string; message: string; lineNo?: number; code?: string }\n}\n\n/**\n * 执行一段 `.fai.js` 源码字符串并返回产物。\n *\n * 内部完成完整 Host 装配（node ports + libLoader + OCCT BREP 引擎注册），\n * 调用方无需再自行装配——这正是 B4 三个装配坑的固化出口。\n *\n * @param code `.fai.js` 源码字符串\n * @param opts 可选：执行模式、库装载器、额外库命名空间\n * @returns 终端形状、诊断信息与失败定位（`Promise<ExecuteScriptResult>`）；\n *          执行失败以 `failedAt` 结构化返回，不抛异常。\n */\nexport async function executeScript(\n  code: string,\n  opts?: ExecuteScriptOptions,\n): Promise<ExecuteScriptResult> {\n  // registerOcctBrepEngine is idempotent and itself boots initOcctWasm (same as cliRun).\n  await registerOcctBrepEngine()\n\n  const ports = withCliLibLoader(createNodePorts())\n  const runtime = createRuntime(ports, opts?.mode ?? 'auto', opts?.libs)\n\n  // cad 经 registerLib 声明 packageName，脚本可 `import * as cad from '@faicad/faijs'`。\n  if (opts?.libs?.cad) {\n    runtime.registerLib('cad', opts.libs.cad, { default: true, packageName: '@faicad/faijs' })\n  }\n\n  const execResult: ExecutionResult = await runtime.execute(code)\n  return {\n    terminals: execResult.terminals ?? [],\n    diagnostics: execResult.infos ?? [],\n    failedAt: execResult.failedAt,\n  }\n}\n"]}

package/dist/node-host/index.d.ts

@@ -43,6 +43,7 @@ export interface CreateNodePortsOptions {
  * - fonts: NodeFontProvider (fs font loading)
  * - assets: FsAssetResolver (fs asset resolution)
  * - events: CliEventSink (writes to stderr + collects)
+ * - hostEnv: 'node' (script-face export commands are open on this host)
  *
  * Also connects the NodeFontProvider to fontRegistry (setFontLoader), so that
  * brep/text's ensureDefaultFont() can load fonts via the filesystem.

package/dist/node-host/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAQrD,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAsBxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node-host/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAQrD,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yFAAyF;IACzF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAyBxE"}

package/dist/node-host/index.js

@@ -27,6 +27,7 @@ import { setFontLoader } from '../brep/text/fontRegistry.js';
  * - fonts: NodeFontProvider (fs font loading)
  * - assets: FsAssetResolver (fs asset resolution)
  * - events: CliEventSink (writes to stderr + collects)
+ * - hostEnv: 'node' (script-face export commands are open on this host)
  *
  * Also connects the NodeFontProvider to fontRegistry (setFontLoader), so that
  * brep/text's ensureDefaultFont() can load fonts via the filesystem.
@@ -52,6 +53,9 @@ export function createNodePorts(opts) {
         fonts: fontProvider,
         assets,
         events: new CliEventSink(),
+        // 宿主环境声明：Node.js 进程 → 脚本面导出命令（cad.exportStl / cad.exportBrep）
+        // 在此开放；落盘发生在用户自己的机器上。见 cad-runtime/ports.ts#HostEnv。
+        hostEnv: 'node',
     };
 }
 //# sourceMappingURL=index.js.map