@faicad/faijs 0.13.2 → 0.16.0

package/dist/mesh/decoration-provider.d.ts

@@ -0,0 +1,53 @@
+/**
+ * decoration-provider — host-injectable text/SVG decoration geometry.
+ *
+ * The `cad.engrave` op is a platform op (plan §4.2 C) but its decoration input
+ * is text or SVG, whose mesh geometry is produced by three's non-basic chain
+ * (`Shape` / `ExtrudeGeometry` / `SVGLoader`). That chain now lives in
+ * `@faicad/faijs-extra`, so core asks the host for the decoration geometry
+ * instead of importing it — the same capability-injection shape as
+ * `setFontLoader` / `setKnurlTextureLoader`.
+ *
+ * With no provider installed, `cad.engrave` still works on its BREP path
+ * (OCCT `textToSolid` / `svgToSolid`, zero three); only the **mesh** path needs
+ * a provider, and it reports a precise error instead of failing obscurely.
+ */
+import type * as THREE from 'three';
+/** Decoration inputs `cad.engrave` passes to the provider. */
+export interface EngraveDecorationParams {
+    /** Text to engrave (mutually exclusive with `svg`). */
+    text?: string;
+    /** Text size in mm. */
+    textSize?: number;
+    /** SVG source text (mutually exclusive with `text`). */
+    svg?: string;
+    /** SVG long-side target size in mm. */
+    svgSize?: number;
+    /** SVG logical width, used for the scale factor. */
+    svgNaturalWidth?: number;
+    /** SVG logical height, used for the scale factor. */
+    svgNaturalHeight?: number;
+    /** Extrusion depth in mm. */
+    depth: number;
+}
+/**
+ * Produces the decoration geometry (local space, `+Z` = extrusion direction) for
+ * `cad.engrave`'s mesh path.
+ */
+export type EngraveDecorationProvider = (params: EngraveDecorationParams) => Promise<THREE.BufferGeometry>;
+/**
+ * Install (or clear, with `null`) the mesh-decoration provider.
+ * @param next - the provider, or null to uninstall.
+ */
+export declare function setEngraveDecorationProvider(next: EngraveDecorationProvider | null): void;
+/**
+ * Read the installed mesh-decoration provider.
+ *
+ * `cad.engrave`'s mesh path calls this; a null result means the host installed
+ * no provider and the op reports the precise "install a provider" error rather
+ * than failing obscurely.
+ *
+ * @returns the installed mesh-decoration provider, or null when none is set.
+ */
+export declare function getEngraveDecorationProvider(): EngraveDecorationProvider | null;
+//# sourceMappingURL=decoration-provider.d.ts.map

package/dist/mesh/decoration-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoration-provider.d.ts","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC,8DAA8D;AAC9D,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,MAAM,EAAE,uBAAuB,KAC5B,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;AAIlC;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAEzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,IAAI,yBAAyB,GAAG,IAAI,CAE/E"}

package/dist/mesh/decoration-provider.js

@@ -0,0 +1,21 @@
+let provider = null;
+/**
+ * Install (or clear, with `null`) the mesh-decoration provider.
+ * @param next - the provider, or null to uninstall.
+ */
+export function setEngraveDecorationProvider(next) {
+    provider = next;
+}
+/**
+ * Read the installed mesh-decoration provider.
+ *
+ * `cad.engrave`'s mesh path calls this; a null result means the host installed
+ * no provider and the op reports the precise "install a provider" error rather
+ * than failing obscurely.
+ *
+ * @returns the installed mesh-decoration provider, or null when none is set.
+ */
+export function getEngraveDecorationProvider() {
+    return provider;
+}
+//# sourceMappingURL=decoration-provider.js.map

package/dist/mesh/decoration-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoration-provider.js","sourceRoot":"","sources":["../../src/mesh/decoration-provider.ts"],"names":[],"mappings":"AA0CA,IAAI,QAAQ,GAAqC,IAAI,CAAA;AAErD;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAsC;IACjF,QAAQ,GAAG,IAAI,CAAA;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,QAAQ,CAAA;AACjB,CAAC","sourcesContent":["/**\n * decoration-provider — host-injectable text/SVG decoration geometry.\n *\n * The `cad.engrave` op is a platform op (plan §4.2 C) but its decoration input\n * is text or SVG, whose mesh geometry is produced by three's non-basic chain\n * (`Shape` / `ExtrudeGeometry` / `SVGLoader`). That chain now lives in\n * `@faicad/faijs-extra`, so core asks the host for the decoration geometry\n * instead of importing it — the same capability-injection shape as\n * `setFontLoader` / `setKnurlTextureLoader`.\n *\n * With no provider installed, `cad.engrave` still works on its BREP path\n * (OCCT `textToSolid` / `svgToSolid`, zero three); only the **mesh** path needs\n * a provider, and it reports a precise error instead of failing obscurely.\n */\nimport type * as THREE from 'three'\n\n/** Decoration inputs `cad.engrave` passes to the provider. */\nexport interface EngraveDecorationParams {\n  /** Text to engrave (mutually exclusive with `svg`). */\n  text?: string\n  /** Text size in mm. */\n  textSize?: number\n  /** SVG source text (mutually exclusive with `text`). */\n  svg?: string\n  /** SVG long-side target size in mm. */\n  svgSize?: number\n  /** SVG logical width, used for the scale factor. */\n  svgNaturalWidth?: number\n  /** SVG logical height, used for the scale factor. */\n  svgNaturalHeight?: number\n  /** Extrusion depth in mm. */\n  depth: number\n}\n\n/**\n * Produces the decoration geometry (local space, `+Z` = extrusion direction) for\n * `cad.engrave`'s mesh path.\n */\nexport type EngraveDecorationProvider = (\n  params: EngraveDecorationParams,\n) => Promise<THREE.BufferGeometry>\n\nlet provider: EngraveDecorationProvider | null = null\n\n/**\n * Install (or clear, with `null`) the mesh-decoration provider.\n * @param next - the provider, or null to uninstall.\n */\nexport function setEngraveDecorationProvider(next: EngraveDecorationProvider | null): void {\n  provider = next\n}\n\n/**\n * Read the installed mesh-decoration provider.\n *\n * `cad.engrave`'s mesh path calls this; a null result means the host installed\n * no provider and the op reports the precise \"install a provider\" error rather\n * than failing obscurely.\n *\n * @returns the installed mesh-decoration provider, or null when none is set.\n */\nexport function getEngraveDecorationProvider(): EngraveDecorationProvider | null {\n  return provider\n}\n"]}

package/dist/mesh/engrave.d.ts

@@ -17,6 +17,10 @@ import type { Shape, EngraveParams, KnurlParams } from './types.js';
  * position it onto a face, then run a boolean union (convex) or subtract
  * (concave).
  *
+ * The decoration geometry itself comes from the host-installed provider
+ * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`
+ * chain belongs to `@faicad/faijs-extra`, not to the platform surface.
+ *
  * @param shape - the world-space target shape.
  * @param params - engrave parameters (text/svg, depth, face, mode).
  * @returns the engraved shape in world space.

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

@@ -1 +1 @@
-{"version":3,"file":"engrave.d.ts","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEhE;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CA0EjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA8E7E"}
+{"version":3,"file":"engrave.d.ts","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAEhE;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAyDjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA8E7E"}

package/dist/mesh/engrave.js

@@ -13,50 +13,41 @@
  */
 import * as THREE from 'three';
 import { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend.js';
-import { svgToExtrudedGeometry } from '../primitives/svg-extrude.js';
+import { getEngraveDecorationProvider } from './decoration-provider.js';
 /**
  * Execute an engraving: generate the decoration geometry (text or SVG),
  * position it onto a face, then run a boolean union (convex) or subtract
  * (concave).
  *
+ * The decoration geometry itself comes from the host-installed provider
+ * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`
+ * chain belongs to `@faicad/faijs-extra`, not to the platform surface.
+ *
  * @param shape - the world-space target shape.
  * @param params - engrave parameters (text/svg, depth, face, mode).
  * @returns the engraved shape in world space.
  */
 export async function engrave(shape, params) {
     // 1. 生成装饰几何（局部空间，+Z = 挤出方向）
-    let decorationGeo;
-    if (params.text) {
-        if (!params.text)
-            throw new Error('Text is empty');
-        const { getOpentypeFont, createTextGeometry } = await import('../primitives/text-geometry.js');
-        const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import('../primitives/text/cjk.js');
-        const font = await getOpentypeFont();
-        if (containsCjk(params.text)) {
-            const cjkFont = await loadSystemCjkFont();
-            if (cjkFont) {
-                decorationGeo = await createMixedTextGeometry(params.text, params.textSize ?? 10, params.depth, cjkFont.font, font);
-            }
-            else {
-                decorationGeo = await createTextGeometry(params.text, params.textSize ?? 10, params.depth, font);
-            }
-        }
-        else {
-            decorationGeo = await createTextGeometry(params.text, params.textSize ?? 10, params.depth, font);
-        }
-    }
-    else if (params.svg) {
-        // logo / SVG
-        decorationGeo = svgToExtrudedGeometry(params.svg, {
-            depth: params.depth,
-            targetLongSide: params.svgSize,
-            naturalWidth: params.svgNaturalWidth ?? 0,
-            naturalHeight: params.svgNaturalHeight ?? 0,
-        });
-    }
-    else {
+    if (!params.text && !params.svg) {
         throw new Error('engrave requires either text or svg');
     }
+    const provider = getEngraveDecorationProvider();
+    if (!provider) {
+        throw new Error('engrave: no mesh decoration provider installed — the text/SVG geometry chain ' +
+            'lives in @faicad/faijs-extra; call setEngraveDecorationProvider() (or ' +
+            'installEditorMeshProviders() from @faicad/faijs-extra) before engraving in mesh mode, ' +
+            'or run the op on the BREP path');
+    }
+    const decorationGeo = await provider({
+        text: params.text,
+        textSize: params.textSize,
+        svg: params.svg,
+        svgSize: params.svgSize,
+        svgNaturalWidth: params.svgNaturalWidth,
+        svgNaturalHeight: params.svgNaturalHeight,
+        depth: params.depth,
+    });
     // 2. 定位装饰几何到面
     const faceCenter = new THREE.Vector3(...params.face.center);
     const faceNormal = new THREE.Vector3(...params.face.normal);

package/dist/mesh/engrave.js.map

@@ -1 +1 @@
-{"version":3,"file":"engrave.js","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 雕刻 API\n *\n * 提取来源：engine/components/engraving/EngravingCore.ts\n *\n * 从 executeEngraving 中提取纯几何计算部分：\n * 1. 生成装饰几何（文字或 SVG）\n * 2. 定位到面\n * 3. 布尔运算（凸=union，凹=subtract）\n *\n * 不包含：store 读写、commitGeometry、undo snapshot、toast。\n * 这些由执行器负责（P1 不改变现有执行器行为）。\n */\n\nimport * as THREE from 'three'\nimport { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend'\nimport { svgToExtrudedGeometry } from '../primitives/svg-extrude'\nimport type { Shape, EngraveParams, KnurlParams } from './types'\n\n/**\n * Execute an engraving: generate the decoration geometry (text or SVG),\n * position it onto a face, then run a boolean union (convex) or subtract\n * (concave).\n *\n * @param shape - the world-space target shape.\n * @param params - engrave parameters (text/svg, depth, face, mode).\n * @returns the engraved shape in world space.\n */\nexport async function engrave(shape: Shape, params: EngraveParams): Promise<Shape> {\n  // 1. 生成装饰几何（局部空间，+Z = 挤出方向）\n  let decorationGeo: THREE.BufferGeometry\n\n  if (params.text) {\n    if (!params.text) throw new Error('Text is empty')\n    const { getOpentypeFont, createTextGeometry } = await import(\n      '../primitives/text-geometry'\n    )\n    const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import(\n      '../primitives/text/cjk'\n    )\n    const font = await getOpentypeFont()\n    if (containsCjk(params.text)) {\n      const cjkFont = await loadSystemCjkFont()\n      if (cjkFont) {\n        decorationGeo = await createMixedTextGeometry(\n          params.text, params.textSize ?? 10, params.depth, cjkFont.font, font,\n        )\n      } else {\n        decorationGeo = await createTextGeometry(\n          params.text, params.textSize ?? 10, params.depth, font,\n        )\n      }\n    } else {\n      decorationGeo = await createTextGeometry(\n        params.text, params.textSize ?? 10, params.depth, font,\n      )\n    }\n  } else if (params.svg) {\n    // logo / SVG\n    decorationGeo = svgToExtrudedGeometry(params.svg, {\n      depth: params.depth,\n      targetLongSide: params.svgSize,\n      naturalWidth: params.svgNaturalWidth ?? 0,\n      naturalHeight: params.svgNaturalHeight ?? 0,\n    })\n  } else {\n    throw new Error('engrave requires either text or svg')\n  }\n\n  // 2. 定位装饰几何到面\n  const faceCenter = new THREE.Vector3(...params.face.center)\n  const faceNormal = new THREE.Vector3(...params.face.normal)\n\n  // Center geometry at origin\n  decorationGeo.computeBoundingBox()\n  const center = new THREE.Vector3()\n  decorationGeo.boundingBox!.getCenter(center)\n  decorationGeo.translate(-center.x, -center.y, -center.z)\n\n  // Rotate +Z to align with face normal\n  const quat = new THREE.Quaternion().setFromUnitVectors(\n    new THREE.Vector3(0, 0, 1),\n    faceNormal,\n  )\n  decorationGeo.applyQuaternion(quat)\n\n  // Offset along normal (convex = outward, concave = inward)\n  const offset = params.mode === 'convex' ? params.depth / 2 : -params.depth / 2\n  const pos = faceCenter.clone().add(faceNormal.clone().multiplyScalar(offset))\n  decorationGeo.translate(pos.x, pos.y, pos.z)\n\n  // 3. 转换为 ManifoldMeshData\n  const decorationData = geoToManifoldMesh(decorationGeo)\n\n  // 4. 布尔运算\n  const op = params.mode === 'convex' ? 'union' : 'subtract'\n  const result = await computeBoolean([shape, decorationData], op)\n\n  // 5. 清理\n  decorationGeo.dispose()\n\n  return result\n}\n\n/**\n * Apply a knurling texture displacement to a shape (vertex displacement, not a\n * boolean op). The replay path approximates UI face selection by excluding\n * faces whose normal deviates from the given face normal; the angle limits act\n * as an angular mask.\n *\n * @param shape - the world-space shape to knurl.\n * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).\n * @returns the displaced shape in world space.\n */\nexport async function knurl(shape: Shape, params: KnurlParams): Promise<Shape> {\n  const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import(\n    './knurl/KnurlGenerator'\n  )\n\n  // 1. Shape → THREE.BufferGeometry\n  const geo = manifoldMeshToGeo(shape, { computeNormals: true })\n\n  // 2. 计算面排除权重：法向与 face.normal 不接近的面标记为排除\n  const posAttr = geo.getAttribute('position')\n  const triCount = posAttr.count / 3\n  const faceNormal = new THREE.Vector3(...params.face.normal).normalize()\n\n  // 计算每个三角形的法向\n  const positions = posAttr.array as Float32Array\n  const indices = geo.index ? (geo.index.array as Uint32Array) : null\n  const faceWeights = new Float32Array(posAttr.count)\n\n  const v0 = new THREE.Vector3()\n  const v1 = new THREE.Vector3()\n  const v2 = new THREE.Vector3()\n  const edge1 = new THREE.Vector3()\n  const edge2 = new THREE.Vector3()\n  const triNormal = new THREE.Vector3()\n\n  for (let t = 0; t < triCount; t++) {\n    const i0 = indices ? indices[t * 3] : t * 3\n    const i1 = indices ? indices[t * 3 + 1] : t * 3 + 1\n    const i2 = indices ? indices[t * 3 + 2] : t * 3 + 2\n\n    v0.set(positions[i0 * 3], positions[i0 * 3 + 1], positions[i0 * 3 + 2])\n    v1.set(positions[i1 * 3], positions[i1 * 3 + 1], positions[i1 * 3 + 2])\n    v2.set(positions[i2 * 3], positions[i2 * 3 + 1], positions[i2 * 3 + 2])\n\n    edge1.subVectors(v1, v0)\n    edge2.subVectors(v2, v0)\n    triNormal.crossVectors(edge1, edge2).normalize()\n\n    // 法向相似度：dot > 0.5 (~60° within) → 不排除\n    const dot = triNormal.dot(faceNormal)\n    if (dot < 0.5) {\n      faceWeights[t * 3] = 1.0\n      faceWeights[t * 3 + 1] = 1.0\n      faceWeights[t * 3 + 2] = 1.0\n    }\n  }\n\n  // 3. 计算包围盒\n  geo.computeBoundingBox()\n  const bb = geo.boundingBox!\n  const partBounds = {\n    min: bb.min.clone(),\n    max: bb.max.clone(),\n    size: new THREE.Vector3().subVectors(bb.max, bb.min),\n    center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),\n  }\n\n  // 4. 调用 applyKnurlDisplacement\n  const resultGeo = await applyKnurlDisplacement(\n    geo,\n    {\n      ...KNURL_DEFAULTS,\n      textureHeight: params.knurlTextureHeight,\n      invertDisplacement: params.knurlInvertDisplacement,\n      refineLength: params.knurlRefineLength,\n      scaleU: params.knurlScaleU,\n      scaleV: params.knurlScaleV,\n      mappingMode: params.knurlMappingMode,\n      faceWeights,\n    },\n    undefined,\n    partBounds,\n  )\n\n  geo.dispose()\n\n  // 5. THREE.BufferGeometry → Shape\n  return geoToManifoldMesh(resultGeo)\n}\n"]}
+{"version":3,"file":"engrave.js","sourceRoot":"","sources":["../../src/mesh/engrave.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 雕刻 API\n *\n * 提取来源：engine/components/engraving/EngravingCore.ts\n *\n * 从 executeEngraving 中提取纯几何计算部分：\n * 1. 生成装饰几何（文字或 SVG）\n * 2. 定位到面\n * 3. 布尔运算（凸=union，凹=subtract）\n *\n * 不包含：store 读写、commitGeometry、undo snapshot、toast。\n * 这些由执行器负责（P1 不改变现有执行器行为）。\n */\n\nimport * as THREE from 'three'\nimport { computeBoolean, geoToManifoldMesh, manifoldMeshToGeo } from '../boolean/csg-backend'\nimport { getEngraveDecorationProvider } from './decoration-provider'\nimport type { Shape, EngraveParams, KnurlParams } from './types'\n\n/**\n * Execute an engraving: generate the decoration geometry (text or SVG),\n * position it onto a face, then run a boolean union (convex) or subtract\n * (concave).\n *\n * The decoration geometry itself comes from the host-installed provider\n * (`setEngraveDecorationProvider`) — three's `Shape`/`ExtrudeGeometry`/`SVGLoader`\n * chain belongs to `@faicad/faijs-extra`, not to the platform surface.\n *\n * @param shape - the world-space target shape.\n * @param params - engrave parameters (text/svg, depth, face, mode).\n * @returns the engraved shape in world space.\n */\nexport async function engrave(shape: Shape, params: EngraveParams): Promise<Shape> {\n  // 1. 生成装饰几何（局部空间，+Z = 挤出方向）\n  if (!params.text && !params.svg) {\n    throw new Error('engrave requires either text or svg')\n  }\n  const provider = getEngraveDecorationProvider()\n  if (!provider) {\n    throw new Error(\n      'engrave: no mesh decoration provider installed — the text/SVG geometry chain ' +\n      'lives in @faicad/faijs-extra; call setEngraveDecorationProvider() (or ' +\n      'installEditorMeshProviders() from @faicad/faijs-extra) before engraving in mesh mode, ' +\n      'or run the op on the BREP path',\n    )\n  }\n  const decorationGeo: THREE.BufferGeometry = await provider({\n    text: params.text,\n    textSize: params.textSize,\n    svg: params.svg,\n    svgSize: params.svgSize,\n    svgNaturalWidth: params.svgNaturalWidth,\n    svgNaturalHeight: params.svgNaturalHeight,\n    depth: params.depth,\n  })\n\n  // 2. 定位装饰几何到面\n  const faceCenter = new THREE.Vector3(...params.face.center)\n  const faceNormal = new THREE.Vector3(...params.face.normal)\n\n  // Center geometry at origin\n  decorationGeo.computeBoundingBox()\n  const center = new THREE.Vector3()\n  decorationGeo.boundingBox!.getCenter(center)\n  decorationGeo.translate(-center.x, -center.y, -center.z)\n\n  // Rotate +Z to align with face normal\n  const quat = new THREE.Quaternion().setFromUnitVectors(\n    new THREE.Vector3(0, 0, 1),\n    faceNormal,\n  )\n  decorationGeo.applyQuaternion(quat)\n\n  // Offset along normal (convex = outward, concave = inward)\n  const offset = params.mode === 'convex' ? params.depth / 2 : -params.depth / 2\n  const pos = faceCenter.clone().add(faceNormal.clone().multiplyScalar(offset))\n  decorationGeo.translate(pos.x, pos.y, pos.z)\n\n  // 3. 转换为 ManifoldMeshData\n  const decorationData = geoToManifoldMesh(decorationGeo)\n\n  // 4. 布尔运算\n  const op = params.mode === 'convex' ? 'union' : 'subtract'\n  const result = await computeBoolean([shape, decorationData], op)\n\n  // 5. 清理\n  decorationGeo.dispose()\n\n  return result\n}\n\n/**\n * Apply a knurling texture displacement to a shape (vertex displacement, not a\n * boolean op). The replay path approximates UI face selection by excluding\n * faces whose normal deviates from the given face normal; the angle limits act\n * as an angular mask.\n *\n * @param shape - the world-space shape to knurl.\n * @param params - knurl parameters (texture height, refine length, UV scale, mapping mode).\n * @returns the displaced shape in world space.\n */\nexport async function knurl(shape: Shape, params: KnurlParams): Promise<Shape> {\n  const { applyKnurlDisplacement, KNURL_DEFAULTS } = await import(\n    './knurl/KnurlGenerator'\n  )\n\n  // 1. Shape → THREE.BufferGeometry\n  const geo = manifoldMeshToGeo(shape, { computeNormals: true })\n\n  // 2. 计算面排除权重：法向与 face.normal 不接近的面标记为排除\n  const posAttr = geo.getAttribute('position')\n  const triCount = posAttr.count / 3\n  const faceNormal = new THREE.Vector3(...params.face.normal).normalize()\n\n  // 计算每个三角形的法向\n  const positions = posAttr.array as Float32Array\n  const indices = geo.index ? (geo.index.array as Uint32Array) : null\n  const faceWeights = new Float32Array(posAttr.count)\n\n  const v0 = new THREE.Vector3()\n  const v1 = new THREE.Vector3()\n  const v2 = new THREE.Vector3()\n  const edge1 = new THREE.Vector3()\n  const edge2 = new THREE.Vector3()\n  const triNormal = new THREE.Vector3()\n\n  for (let t = 0; t < triCount; t++) {\n    const i0 = indices ? indices[t * 3] : t * 3\n    const i1 = indices ? indices[t * 3 + 1] : t * 3 + 1\n    const i2 = indices ? indices[t * 3 + 2] : t * 3 + 2\n\n    v0.set(positions[i0 * 3], positions[i0 * 3 + 1], positions[i0 * 3 + 2])\n    v1.set(positions[i1 * 3], positions[i1 * 3 + 1], positions[i1 * 3 + 2])\n    v2.set(positions[i2 * 3], positions[i2 * 3 + 1], positions[i2 * 3 + 2])\n\n    edge1.subVectors(v1, v0)\n    edge2.subVectors(v2, v0)\n    triNormal.crossVectors(edge1, edge2).normalize()\n\n    // 法向相似度：dot > 0.5 (~60° within) → 不排除\n    const dot = triNormal.dot(faceNormal)\n    if (dot < 0.5) {\n      faceWeights[t * 3] = 1.0\n      faceWeights[t * 3 + 1] = 1.0\n      faceWeights[t * 3 + 2] = 1.0\n    }\n  }\n\n  // 3. 计算包围盒\n  geo.computeBoundingBox()\n  const bb = geo.boundingBox!\n  const partBounds = {\n    min: bb.min.clone(),\n    max: bb.max.clone(),\n    size: new THREE.Vector3().subVectors(bb.max, bb.min),\n    center: new THREE.Vector3().addVectors(bb.min, bb.max).multiplyScalar(0.5),\n  }\n\n  // 4. 调用 applyKnurlDisplacement\n  const resultGeo = await applyKnurlDisplacement(\n    geo,\n    {\n      ...KNURL_DEFAULTS,\n      textureHeight: params.knurlTextureHeight,\n      invertDisplacement: params.knurlInvertDisplacement,\n      refineLength: params.knurlRefineLength,\n      scaleU: params.knurlScaleU,\n      scaleV: params.knurlScaleV,\n      mappingMode: params.knurlMappingMode,\n      faceWeights,\n    },\n    undefined,\n    partBounds,\n  )\n\n  geo.dispose()\n\n  // 5. THREE.BufferGeometry → Shape\n  return geoToManifoldMesh(resultGeo)\n}\n"]}

package/dist/mesh/index.d.ts

@@ -16,17 +16,17 @@ import * as primitives from './primitives.js';
 import * as brepPrimitives from '../brep/primitives-brep.js';
 import * as brepOps from '../brep/index.js';
 import * as booleanOps from './boolean.js';
-import * as splitOps from './fai_split.js';
-import * as drillOps from './fai_drill.js';
-import * as extrudeOps from './fai_extrude.js';
 import * as engraveOps from './engrave.js';
 import * as transformOps from './transform.js';
 import * as queryOps from './query.js';
 import * as ioOps from './io.js';
 /**
  * Unified `cad` API object aggregating the pure-data mesh operations: mesh and
- * BREP primitives, transforms, booleans, splits, drill/extrude/engrave/knurl,
- * geometry queries, file IO, and BREP feature operations.
+ * BREP primitives, transforms, booleans, engrave/knurl, geometry queries, file
+ * IO, and BREP feature operations.
+ *
+ * D1（2026-09-23 扩展库拆分）：`text` / `svgExtrude` / `fai_*` 键已随
+ * `@faicad/faijs-extra` 迁出——它们的实现在扩展库的 mesh 面（`editorCad`）。
  */
 export declare const cad: {
     box: typeof primitives.box;
@@ -34,9 +34,7 @@ export declare const cad: {
     cylinder: typeof primitives.cylinder;
     cone: typeof primitives.cone;
     wedge: typeof primitives.wedge;
-    text: typeof primitives.text;
     screw: typeof primitives.screw;
-    svgExtrude: typeof primitives.svgExtrude;
     sdf: typeof primitives.sdf;
     boxBrep: typeof brepPrimitives.boxBrep;
     sphereBrep: typeof brepPrimitives.sphereBrep;
@@ -51,13 +49,6 @@ export declare const cad: {
     union: typeof booleanOps.union;
     subtract: typeof booleanOps.subtract;
     intersect: typeof booleanOps.intersect;
-    fai_split: typeof splitOps.split;
-    fai_splitWithParams: typeof splitOps.splitWithParams;
-    dovetailSplit: typeof splitOps.dovetailSplit;
-    dowelSplit: typeof splitOps.dowelSplit;
-    tenonSplit: typeof splitOps.tenonSplit;
-    fai_drill: typeof drillOps.drill;
-    fai_extrude: typeof extrudeOps.extrude;
     engrave: typeof engraveOps.engrave;
     knurl: typeof engraveOps.knurl;
     boundingBox: typeof queryOps.boundingBox;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,aAAa,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,YAAY,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,MAAM,CAAA;AAI7B;;;;GAIG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEf,CAAA;AAID,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACvE,YAAY,EACV,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAChE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EACvC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EACtD,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,GACjF,MAAM,SAAS,CAAA;AAGhB,YAAY,EACV,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EACjE,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,oBAAoB,EAAE,kBAAkB,EAAE,qBAAqB,EAC/D,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,YAAY,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,MAAM,CAAA;AAI7B;;;;;;;GAOG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0Df,CAAA;AAID,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACvE,YAAY,EACV,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAChE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EACvC,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EACtD,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,gBAAgB,GACjF,MAAM,SAAS,CAAA;AAGhB,YAAY,EACV,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EACjE,iBAAiB,GAClB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,oBAAoB,EAAE,kBAAkB,EAAE,qBAAqB,EAC/D,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA"}

package/dist/mesh/index.js

@@ -16,9 +16,6 @@ import * as primitives from './primitives.js';
 import * as brepPrimitives from '../brep/primitives-brep.js';
 import * as brepOps from '../brep/index.js';
 import * as booleanOps from './boolean.js';
-import * as splitOps from './fai_split.js';
-import * as drillOps from './fai_drill.js';
-import * as extrudeOps from './fai_extrude.js';
 import * as engraveOps from './engrave.js';
 import * as transformOps from './transform.js';
 import * as queryOps from './query.js';
@@ -26,8 +23,11 @@ import * as ioOps from './io.js';
 // ── 统一 cad API 对象 ──
 /**
  * Unified `cad` API object aggregating the pure-data mesh operations: mesh and
- * BREP primitives, transforms, booleans, splits, drill/extrude/engrave/knurl,
- * geometry queries, file IO, and BREP feature operations.
+ * BREP primitives, transforms, booleans, engrave/knurl, geometry queries, file
+ * IO, and BREP feature operations.
+ *
+ * D1（2026-09-23 扩展库拆分）：`text` / `svgExtrude` / `fai_*` 键已随
+ * `@faicad/faijs-extra` 迁出——它们的实现在扩展库的 mesh 面（`editorCad`）。
  */
 export const cad = {
     // 创建（mesh 路径）
@@ -36,9 +36,7 @@ export const cad = {
     cylinder: primitives.cylinder,
     cone: primitives.cone,
     wedge: primitives.wedge,
-    text: primitives.text,
     screw: primitives.screw,
-    svgExtrude: primitives.svgExtrude,
     sdf: primitives.sdf,
     // 创建（BREP 路径 — OCCT 精确实体三角化）
     boxBrep: brepPrimitives.boxBrep,
@@ -57,17 +55,8 @@ export const cad = {
     subtract: booleanOps.subtract,
     intersect: booleanOps.intersect,
     // 分割
-    // fai_* 键为 mesh 侧实现入口。DEPRECATED：`fai_` 前缀 op 是 ../3d_editor 项目
-    // 特有的操作，将来迁出并从 faijs 删除（见 api/fai_*.ts 的 @deprecated）。
-    fai_split: splitOps.split,
-    fai_splitWithParams: splitOps.splitWithParams,
-    dovetailSplit: splitOps.dovetailSplit,
-    dowelSplit: splitOps.dowelSplit,
-    tenonSplit: splitOps.tenonSplit,
-    // 钻孔
-    fai_drill: drillOps.drill,
-    // 拉伸
-    fai_extrude: extrudeOps.extrude,
+    // `fai_*` 键（编辑器消费面）已随扩展库迁出：@faicad/faijs-extra 的 mesh 面
+    // 经 `mesh/fai_split.ts` / `mesh/fai_drill.ts` / `mesh/fai_extrude.ts` 提供。
     // 雕刻
     engrave: engraveOps.engrave,
     knurl: engraveOps.knurl,

package/dist/mesh/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh — 纯数据几何 API 统一入口\n *\n * See docs/api-contract.md §1 (architecture layers) and §10 (stdlib function catalog).\n *\n * 原则（§5.1）：\n * 1. 全部纯数据：输入输出是 Shape (ManifoldMeshData)，不碰 THREE 场景、不读 store\n * 2. 不可变：每个 API 返回新几何，不修改输入\n * 3. 同步签名、异步执行：API 签名同步（或 async）；worker 边界由 ScriptEngine 处理\n * 4. 坐标系：右手系 +Z 向上、毫米、角度用度\n *\n * P1 阶段：mesh 是对现有纯函数的薄包装层，行为完全不变。\n * P3+ 阶段：mesh 将由 ScriptEngine 驱动，在 worker 中执行。\n */\n\nimport * as primitives from './primitives'\nimport * as brepPrimitives from '../brep/primitives-brep'\nimport * as brepOps from '../brep'\nimport * as booleanOps from './boolean'\nimport * as splitOps from './fai_split'\nimport * as drillOps from './fai_drill'\nimport * as extrudeOps from './fai_extrude'\nimport * as engraveOps from './engrave'\nimport * as transformOps from './transform'\nimport * as queryOps from './query'\nimport * as ioOps from './io'\n\n// ── 统一 cad API 对象 ──\n\n/**\n * Unified `cad` API object aggregating the pure-data mesh operations: mesh and\n * BREP primitives, transforms, booleans, splits, drill/extrude/engrave/knurl,\n * geometry queries, file IO, and BREP feature operations.\n */\nexport const cad = {\n  // 创建（mesh 路径）\n  box: primitives.box,\n  sphere: primitives.sphere,\n  cylinder: primitives.cylinder,\n  cone: primitives.cone,\n  wedge: primitives.wedge,\n  text: primitives.text,\n  screw: primitives.screw,\n  svgExtrude: primitives.svgExtrude,\n  sdf: primitives.sdf,\n\n  // 创建（BREP 路径 — OCCT 精确实体三角化）\n  boxBrep: brepPrimitives.boxBrep,\n  sphereBrep: brepPrimitives.sphereBrep,\n  cylinderBrep: brepPrimitives.cylinderBrep,\n  coneBrep: brepPrimitives.coneBrep,\n  wedgeBrep: brepPrimitives.wedgeBrep,\n\n  // 变换\n  translate: transformOps.translate,\n  rotate_euler: transformOps.rotate_euler,\n  scale: transformOps.scale,\n  scale3d: transformOps.scale3d,\n  transformMatrix: transformOps.transformMatrix,\n\n  // 布尔\n  union: booleanOps.union,\n  subtract: booleanOps.subtract,\n  intersect: booleanOps.intersect,\n\n  // 分割\n  // fai_* 键为 mesh 侧实现入口。DEPRECATED：`fai_` 前缀 op 是 ../3d_editor 项目\n  // 特有的操作，将来迁出并从 faijs 删除（见 api/fai_*.ts 的 @deprecated）。\n  fai_split: splitOps.split,\n  fai_splitWithParams: splitOps.splitWithParams,\n  dovetailSplit: splitOps.dovetailSplit,\n  dowelSplit: splitOps.dowelSplit,\n  tenonSplit: splitOps.tenonSplit,\n\n  // 钻孔\n  fai_drill: drillOps.drill,\n\n  // 拉伸\n  fai_extrude: extrudeOps.extrude,\n\n  // 雕刻\n  engrave: engraveOps.engrave,\n  knurl: engraveOps.knurl,\n\n  // 查询\n  boundingBox: queryOps.boundingBox,\n  bboxCenter: queryOps.bboxCenter,\n  volume: queryOps.volume,\n  faceAt: queryOps.faceAt,\n\n  // IO\n  load: ioOps.importFile,\n\n  // BREP 特征操作（Phase 2 — OCCT 精确实体运算）\n  translateBrep: brepOps.translateBrep,\n  rotateBrep: brepOps.rotateBrep,\n  scaleBrep: brepOps.scaleBrep,\n  fuseBrep: brepOps.fuseBrep,\n  cutBrep: brepOps.cutBrep,\n  commonBrep: brepOps.commonBrep,\n  drillBrep: brepOps.drillBrep,\n  splitBrep: brepOps.splitBrep,\n  extrudeBrep: brepOps.extrudeBrep,\n  loadBrep: brepOps.loadBrep,\n  solidToShape: brepOps.solidToShape,\n}\n\n// ── 类型导出 ──\n\nexport type { Shape, Vec3, BoundingBox, FaceDescriptor } from './types'\nexport type {\n  BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams,\n  TextParams, SvgExtrudeParams, SdfParams,\n  DrillParams, ExtrudeParams, EngraveParams, KnurlParams,\n  SplitPlane, SplitResult, DovetailSplitParams, DowelSplitParams, TenonSplitParams,\n} from './types'\n\n// BREP ops 类型导出\nexport type {\n  BrepChainState, DrillBrepParams, SplitBrepParams, SplitBrepResult,\n  ExtrudeBrepParams,\n} from '../brep'\nexport {\n  createBrepChainState, initBrepChainState, releaseBrepChainState,\n  solidToShape,\n  isCadFormat,\n} from '../brep'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mesh/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA;AAC1C,OAAO,KAAK,cAAc,MAAM,yBAAyB,CAAA;AACzD,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA;AAClC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,UAAU,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,YAAY,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,SAAS,CAAA;AACnC,OAAO,KAAK,KAAK,MAAM,MAAM,CAAA;AAE7B,sBAAsB;AAEtB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,cAAc;IACd,GAAG,EAAE,UAAU,CAAC,GAAG;IACnB,MAAM,EAAE,UAAU,CAAC,MAAM;IACzB,QAAQ,EAAE,UAAU,CAAC,QAAQ;IAC7B,IAAI,EAAE,UAAU,CAAC,IAAI;IACrB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,GAAG,EAAE,UAAU,CAAC,GAAG;IAEnB,6BAA6B;IAC7B,OAAO,EAAE,cAAc,CAAC,OAAO;IAC/B,UAAU,EAAE,cAAc,CAAC,UAAU;IACrC,YAAY,EAAE,cAAc,CAAC,YAAY;IACzC,QAAQ,EAAE,cAAc,CAAC,QAAQ;IACjC,SAAS,EAAE,cAAc,CAAC,SAAS;IAEnC,KAAK;IACL,SAAS,EAAE,YAAY,CAAC,SAAS;IACjC,YAAY,EAAE,YAAY,CAAC,YAAY;IACvC,KAAK,EAAE,YAAY,CAAC,KAAK;IACzB,OAAO,EAAE,YAAY,CAAC,OAAO;IAC7B,eAAe,EAAE,YAAY,CAAC,eAAe;IAE7C,KAAK;IACL,KAAK,EAAE,UAAU,CAAC,KAAK;IACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;IAC7B,SAAS,EAAE,UAAU,CAAC,SAAS;IAE/B,KAAK;IACL,wDAAwD;IACxD,0EAA0E;IAE1E,KAAK;IACL,OAAO,EAAE,UAAU,CAAC,OAAO;IAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;IAEvB,KAAK;IACL,WAAW,EAAE,QAAQ,CAAC,WAAW;IACjC,UAAU,EAAE,QAAQ,CAAC,UAAU;IAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;IACvB,MAAM,EAAE,QAAQ,CAAC,MAAM;IAEvB,KAAK;IACL,IAAI,EAAE,KAAK,CAAC,UAAU;IAEtB,mCAAmC;IACnC,aAAa,EAAE,OAAO,CAAC,aAAa;IACpC,UAAU,EAAE,OAAO,CAAC,UAAU;IAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;IAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;IACxB,UAAU,EAAE,OAAO,CAAC,UAAU;IAC9B,SAAS,EAAE,OAAO,CAAC,SAAS;IAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;IAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;IAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,YAAY,EAAE,OAAO,CAAC,YAAY;CACnC,CAAA;AAiBD,OAAO,EACL,oBAAoB,EAAE,kBAAkB,EAAE,qBAAqB,EAC/D,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA","sourcesContent":["/**\n * mesh — 纯数据几何 API 统一入口\n *\n * See docs/api-contract.md §1 (architecture layers) and §10 (stdlib function catalog).\n *\n * 原则（§5.1）：\n * 1. 全部纯数据：输入输出是 Shape (ManifoldMeshData)，不碰 THREE 场景、不读 store\n * 2. 不可变：每个 API 返回新几何，不修改输入\n * 3. 同步签名、异步执行：API 签名同步（或 async）；worker 边界由 ScriptEngine 处理\n * 4. 坐标系：右手系 +Z 向上、毫米、角度用度\n *\n * P1 阶段：mesh 是对现有纯函数的薄包装层，行为完全不变。\n * P3+ 阶段：mesh 将由 ScriptEngine 驱动，在 worker 中执行。\n */\n\nimport * as primitives from './primitives'\nimport * as brepPrimitives from '../brep/primitives-brep'\nimport * as brepOps from '../brep'\nimport * as booleanOps from './boolean'\nimport * as engraveOps from './engrave'\nimport * as transformOps from './transform'\nimport * as queryOps from './query'\nimport * as ioOps from './io'\n\n// ── 统一 cad API 对象 ──\n\n/**\n * Unified `cad` API object aggregating the pure-data mesh operations: mesh and\n * BREP primitives, transforms, booleans, engrave/knurl, geometry queries, file\n * IO, and BREP feature operations.\n *\n * D1（2026-09-23 扩展库拆分）：`text` / `svgExtrude` / `fai_*` 键已随\n * `@faicad/faijs-extra` 迁出——它们的实现在扩展库的 mesh 面（`editorCad`）。\n */\nexport const cad = {\n  // 创建（mesh 路径）\n  box: primitives.box,\n  sphere: primitives.sphere,\n  cylinder: primitives.cylinder,\n  cone: primitives.cone,\n  wedge: primitives.wedge,\n  screw: primitives.screw,\n  sdf: primitives.sdf,\n\n  // 创建（BREP 路径 — OCCT 精确实体三角化）\n  boxBrep: brepPrimitives.boxBrep,\n  sphereBrep: brepPrimitives.sphereBrep,\n  cylinderBrep: brepPrimitives.cylinderBrep,\n  coneBrep: brepPrimitives.coneBrep,\n  wedgeBrep: brepPrimitives.wedgeBrep,\n\n  // 变换\n  translate: transformOps.translate,\n  rotate_euler: transformOps.rotate_euler,\n  scale: transformOps.scale,\n  scale3d: transformOps.scale3d,\n  transformMatrix: transformOps.transformMatrix,\n\n  // 布尔\n  union: booleanOps.union,\n  subtract: booleanOps.subtract,\n  intersect: booleanOps.intersect,\n\n  // 分割\n  // `fai_*` 键（编辑器消费面）已随扩展库迁出：@faicad/faijs-extra 的 mesh 面\n  // 经 `mesh/fai_split.ts` / `mesh/fai_drill.ts` / `mesh/fai_extrude.ts` 提供。\n\n  // 雕刻\n  engrave: engraveOps.engrave,\n  knurl: engraveOps.knurl,\n\n  // 查询\n  boundingBox: queryOps.boundingBox,\n  bboxCenter: queryOps.bboxCenter,\n  volume: queryOps.volume,\n  faceAt: queryOps.faceAt,\n\n  // IO\n  load: ioOps.importFile,\n\n  // BREP 特征操作（Phase 2 — OCCT 精确实体运算）\n  translateBrep: brepOps.translateBrep,\n  rotateBrep: brepOps.rotateBrep,\n  scaleBrep: brepOps.scaleBrep,\n  fuseBrep: brepOps.fuseBrep,\n  cutBrep: brepOps.cutBrep,\n  commonBrep: brepOps.commonBrep,\n  drillBrep: brepOps.drillBrep,\n  splitBrep: brepOps.splitBrep,\n  extrudeBrep: brepOps.extrudeBrep,\n  loadBrep: brepOps.loadBrep,\n  solidToShape: brepOps.solidToShape,\n}\n\n// ── 类型导出 ──\n\nexport type { Shape, Vec3, BoundingBox, FaceDescriptor } from './types'\nexport type {\n  BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams,\n  TextParams, SvgExtrudeParams, SdfParams,\n  DrillParams, ExtrudeParams, EngraveParams, KnurlParams,\n  SplitPlane, SplitResult, DovetailSplitParams, DowelSplitParams, TenonSplitParams,\n} from './types'\n\n// BREP ops 类型导出\nexport type {\n  BrepChainState, DrillBrepParams, SplitBrepParams, SplitBrepResult,\n  ExtrudeBrepParams,\n} from '../brep'\nexport {\n  createBrepChainState, initBrepChainState, releaseBrepChainState,\n  solidToShape,\n  isCadFormat,\n} from '../brep'\n"]}

package/dist/mesh/io.d.ts

@@ -2,7 +2,8 @@
  * mesh IO API — headless 文件加载
  *
  * 替代浏览器版的 io.ts（依赖 fileBlobStore / formatLoaders / model-store）。
- * 仅使用 THREE.js 的 loader（STLLoader）解析文件字节为 Shape。
+ * STL 由 core 自持的 `mesh/stl-loader.ts` 解析（零 three addons——`three/examples`
+ * 不在 three 的版本兼容承诺内，且会把不可控模块带进每个消费方，含小程序 worker）。
  */
 import type { Shape } from './types.js';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC,CAiBhB"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,CAAC,CAahB"}

package/dist/mesh/io.js

@@ -2,9 +2,11 @@
  * mesh IO API — headless 文件加载
  *
  * 替代浏览器版的 io.ts（依赖 fileBlobStore / formatLoaders / model-store）。
- * 仅使用 THREE.js 的 loader（STLLoader）解析文件字节为 Shape。
+ * STL 由 core 自持的 `mesh/stl-loader.ts` 解析（零 three addons——`three/examples`
+ * 不在 three 的版本兼容承诺内，且会把不可控模块带进每个消费方，含小程序 worker）。
  */
 import { geoToManifoldMesh } from '../boolean/geo-convert.js';
+import { parseStl } from './stl-loader.js';
 /**
  * Load geometry from raw file bytes (headless variant). STL is parsed
  * directly; unsupported formats fall back to STL parsing.
@@ -16,15 +18,11 @@ import { geoToManifoldMesh } from '../boolean/geo-convert.js';
 export async function importFile(buffer, format) {
     const fmt = (format ?? 'stl').toLowerCase();
     if (fmt === 'stl') {
-        const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js');
-        const geo = new STLLoader().parse(buffer);
-        return geoToManifoldMesh(geo);
+        return geoToManifoldMesh(parseStl(buffer));
     }
     // For other formats, try STL as fallback
     try {
-        const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js');
-        const geo = new STLLoader().parse(buffer);
-        return geoToManifoldMesh(geo);
+        return geoToManifoldMesh(parseStl(buffer));
     }
     catch {
         throw new Error(`[mesh/io] unsupported format: ${fmt}`);

package/dist/mesh/io.js.map

@@ -1 +1 @@
-{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAG1D;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAmB,EACnB,MAAe;IAEf,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAE3C,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAA;QAC7E,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACzC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,yCAAyC,CAAC,CAAA;QAC7E,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QACzC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;IACzD,CAAC;AACH,CAAC","sourcesContent":["/**\n * mesh IO API — headless 文件加载\n *\n * 替代浏览器版的 io.ts（依赖 fileBlobStore / formatLoaders / model-store）。\n * 仅使用 THREE.js 的 loader（STLLoader）解析文件字节为 Shape。\n */\n\nimport { geoToManifoldMesh } from '../boolean/geo-convert'\nimport type { Shape } from './types'\n\n/**\n * Load geometry from raw file bytes (headless variant). STL is parsed\n * directly; unsupported formats fall back to STL parsing.\n *\n * @param buffer - the raw file bytes to parse.\n * @param format - format identifier such as 'stl' (defaults to 'stl').\n * @returns the loaded shape.\n */\nexport async function importFile(\n  buffer: ArrayBuffer,\n  format?: string,\n): Promise<Shape> {\n  const fmt = (format ?? 'stl').toLowerCase()\n\n  if (fmt === 'stl') {\n    const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js')\n    const geo = new STLLoader().parse(buffer)\n    return geoToManifoldMesh(geo)\n  }\n\n  // For other formats, try STL as fallback\n  try {\n    const { STLLoader } = await import('three/examples/jsm/loaders/STLLoader.js')\n    const geo = new STLLoader().parse(buffer)\n    return geoToManifoldMesh(geo)\n  } catch {\n    throw new Error(`[mesh/io] unsupported format: ${fmt}`)\n  }\n}\n"]}
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../src/mesh/io.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAGvC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAmB,EACnB,MAAe;IAEf,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAA;IAE3C,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,OAAO,iBAAiB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;IACzD,CAAC;AACH,CAAC","sourcesContent":["/**\n * mesh IO API — headless 文件加载\n *\n * 替代浏览器版的 io.ts（依赖 fileBlobStore / formatLoaders / model-store）。\n * STL 由 core 自持的 `mesh/stl-loader.ts` 解析（零 three addons——`three/examples`\n * 不在 three 的版本兼容承诺内，且会把不可控模块带进每个消费方，含小程序 worker）。\n */\n\nimport { geoToManifoldMesh } from '../boolean/geo-convert'\nimport { parseStl } from './stl-loader'\nimport type { Shape } from './types'\n\n/**\n * Load geometry from raw file bytes (headless variant). STL is parsed\n * directly; unsupported formats fall back to STL parsing.\n *\n * @param buffer - the raw file bytes to parse.\n * @param format - format identifier such as 'stl' (defaults to 'stl').\n * @returns the loaded shape.\n */\nexport async function importFile(\n  buffer: ArrayBuffer,\n  format?: string,\n): Promise<Shape> {\n  const fmt = (format ?? 'stl').toLowerCase()\n\n  if (fmt === 'stl') {\n    return geoToManifoldMesh(parseStl(buffer))\n  }\n\n  // For other formats, try STL as fallback\n  try {\n    return geoToManifoldMesh(parseStl(buffer))\n  } catch {\n    throw new Error(`[mesh/io] unsupported format: ${fmt}`)\n  }\n}\n"]}

package/dist/mesh/primitives.d.ts

@@ -3,14 +3,16 @@
  *
  * 提取来源（§5.7）：
  * - box/sphere/cylinder/cone/wedge ← engine/primitives/mesh-primitives.ts (makePrimitiveGeo)
- * - text ← engine/components/engraving/EngravingCore.ts (createTextGeometry)
  * - screw ← engine/primitives/screw/screw.ts (makeScrew)
- * - svgExtrude ← engine/primitives/svg-extrude/ (svgToExtrudedGeometry)
+ *
+ * `text` / `svgExtrude`（three 的 Shape / ExtrudeGeometry / SVGLoader 链）已随
+ * B 组迁到 `@faicad/faijs-extra` 的 `mesh/primitives.ts`，core 的 mesh 面不再
+ * 承载 three 的非基础几何生成链。
  *
  * 所有函数返回 Shape (ManifoldMeshData)：THREE.BufferGeometry → geoToManifoldMesh 转换。
  * 坐标系：Z-up、毫米。
  */
-import type { Shape, BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams, TextParams, SvgExtrudeParams, SdfParams } from './types.js';
+import type { Shape, BoxParams, SphereParams, CylinderParams, ConeParams, WedgeParams, SdfParams } from './types.js';
 /**
  * Create a box solid (brepjs contract, §4.1 A 决策).
  *
@@ -63,14 +65,6 @@ export declare function cone(params: ConeParams): Shape;
  * @returns the wedge shape.
  */
 export declare function wedge(params: WedgeParams): Shape;
-/**
- * Create text geometry. Font loading is asynchronous, so this function is
- * async; CJK text is rendered with the system font when one is available.
- *
- * @param params - text parameters (text, size, depth).
- * @returns the text shape.
- */
-export declare function text(params: TextParams): Promise<Shape>;
 /**
  * Create a screw (threaded) geometry.
  *
@@ -86,13 +80,6 @@ export declare function screw(params: {
     head: 'hex' | 'chc' | 'none';
     nRad?: number;
 }): Promise<Shape>;
-/**
- * Create an extruded geometry from an SVG source.
- *
- * @param params - SVG extrude parameters (svg, depth, target size, optional natural size).
- * @returns the extruded shape.
- */
-export declare function svgExtrude(params: SvgExtrudeParams): Shape;
 /**
  * Create a mesh from SDF (signed distance field) code, sampling the field with
  * marching cubes.

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

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/mesh/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAY/I;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAsB5C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAOlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAWtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CA8B9C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA0DhD;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAwB7D;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE;IAClC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC,KAAK,CAAC,CAYjB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,CAQ1D;AAED;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAc3D"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/mesh/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAYjH;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAsB5C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAOlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CAWtD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CA8B9C;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK,CA0DhD;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE;IAClC,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,OAAO,CAAC,KAAK,CAAC,CAYjB;AAED;;;;;;GAMG;AACH,wBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAc3D"}

package/dist/mesh/primitives.js

@@ -3,9 +3,11 @@
  *
  * 提取来源（§5.7）：
  * - box/sphere/cylinder/cone/wedge ← engine/primitives/mesh-primitives.ts (makePrimitiveGeo)
- * - text ← engine/components/engraving/EngravingCore.ts (createTextGeometry)
  * - screw ← engine/primitives/screw/screw.ts (makeScrew)
- * - svgExtrude ← engine/primitives/svg-extrude/ (svgToExtrudedGeometry)
+ *
+ * `text` / `svgExtrude`（three 的 Shape / ExtrudeGeometry / SVGLoader 链）已随
+ * B 组迁到 `@faicad/faijs-extra` 的 `mesh/primitives.ts`，core 的 mesh 面不再
+ * 承载 three 的非基础几何生成链。
  *
  * 所有函数返回 Shape (ManifoldMeshData)：THREE.BufferGeometry → geoToManifoldMesh 转换。
  * 坐标系：Z-up、毫米。
@@ -13,7 +15,6 @@
 import * as THREE from 'three';
 import { makePrimitiveGeo } from '../primitives/mesh-primitives.js';
 import { geoToManifoldMesh } from '../boolean/csg-backend.js';
-import { svgToExtrudedGeometry } from '../primitives/svg-extrude.js';
 import { clampNRad } from './types.js';
 // ── 内部工具 ──
 /** THREE.BufferGeometry → Shape (ManifoldMeshData) */
@@ -191,36 +192,6 @@ export function wedge(params) {
     }
     return geoToShape(geo);
 }
-/**
- * Create text geometry. Font loading is asynchronous, so this function is
- * async; CJK text is rendered with the system font when one is available.
- *
- * @param params - text parameters (text, size, depth).
- * @returns the text shape.
- */
-export async function text(params) {
-    const { getOpentypeFont, createTextGeometry } = await import('../primitives/text-geometry.js');
-    const { containsCjk, loadSystemCjkFont, createMixedTextGeometry } = await import('../primitives/text/cjk.js');
-    const font = await getOpentypeFont();
-    let geo;
-    if (containsCjk(params.text)) {
-        const cjkFont = await loadSystemCjkFont();
-        if (cjkFont) {
-            geo = await createMixedTextGeometry(params.text, params.size, params.depth, cjkFont.font, font);
-        }
-        else {
-            // No CJK font available: replace CJK chars with '?' so geometry still
-            // can be created (graceful degradation). Without this, createTextGeometry
-            // would throw because CJK glyphs are .notdef in OpenSans Regular.
-            const fallback = params.text.replace(/[\u4E00-\u9FFF\u3400-\u4DBF\u2F800-\u2FA1F\u3000-\u303F\uFF00-\uFFEF]/g, '?');
-            geo = await createTextGeometry(fallback, params.size, params.depth, font);
-        }
-    }
-    else {
-        geo = await createTextGeometry(params.text, params.size, params.depth, font);
-    }
-    return geoToShape(geo);
-}
 /**
  * Create a screw (threaded) geometry.
  *
@@ -240,21 +211,6 @@ export async function screw(params) {
     });
     return geoToShape(geo);
 }
-/**
- * Create an extruded geometry from an SVG source.
- *
- * @param params - SVG extrude parameters (svg, depth, target size, optional natural size).
- * @returns the extruded shape.
- */
-export function svgExtrude(params) {
-    const geo = svgToExtrudedGeometry(params.svg, {
-        depth: params.depth,
-        targetLongSide: params.targetLongSide ?? 20,
-        naturalWidth: params.naturalWidth ?? 0,
-        naturalHeight: params.naturalHeight ?? 0,
-    });
-    return geoToShape(geo);
-}
 /**
  * Create a mesh from SDF (signed distance field) code, sampling the field with
  * marching cubes.