@faicad/faijs 0.33.1 → 0.35.2

package/dist/extra/mesh/fai_extrude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_extrude.d.ts","sourceRoot":"","sources":["../../../src/extra/mesh/fai_extrude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAE5D;;;;;;;;GAQG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CA2BjF"}

package/dist/extra/mesh/fai_extrude.js

@@ -0,0 +1,42 @@
+/**
+ * mesh 拉伸 API
+ *
+ * 提取来源：engine/boolean/extrude-helpers.ts (buildExtrudeParts)
+ * 已是纯数据函数（ManifoldMeshData 输入输出），直接包装。
+ *
+ * 拉伸语义（三段模型）：
+ * - back（下半）：沿法线 N 平移 offsetBack
+ * - middle（中段）：平面处的截面沿 N 挤出 L
+ * - front（上半）：沿法线 N 平移 offsetFront
+ * 其中 offsetFront - offsetBack === length 恒成立。
+ */
+import { computeBoolean } from '../../boolean/csg-backend.js';
+import { buildExtrudeParts } from '../../boolean/extrude-helpers.js';
+/**
+ * Execute a face extrude: cut the model at the cutting plane and extrude the
+ * middle section by `length` along the plane normal, then union the three
+ * segments back into a single solid.
+ *
+ * @param shape - the world-space shape to extrude.
+ * @param params - extrude parameters (normal, planeDistance, length, mode).
+ * @returns the extruded shape in world space.
+ */
+export async function extrude(shape, params) {
+    const mode = params.mode ?? 'centered';
+    const { front, back, extruded } = await buildExtrudeParts(shape, params.normal, params.planeDistance, params.length, mode);
+    // Union 三段为单体
+    const meshesToUnion = [];
+    for (const part of [front, extruded, back]) {
+        if (!part || part.indices.length === 0)
+            continue;
+        meshesToUnion.push(part);
+    }
+    if (meshesToUnion.length === 0) {
+        throw new Error('No valid geometry to extrude');
+    }
+    if (meshesToUnion.length === 1) {
+        return meshesToUnion[0];
+    }
+    return computeBoolean(meshesToUnion, 'union');
+}
+//# sourceMappingURL=fai_extrude.js.map

package/dist/extra/mesh/fai_extrude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_extrude.js","sourceRoot":"","sources":["../../../src/extra/mesh/fai_extrude.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAIjE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAY,EAAE,MAAqB;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,UAAU,CAAA;IAEtC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,iBAAiB,CACvD,KAAyB,EACzB,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,MAAM,EACb,IAAI,CACL,CAAA;IAED,cAAc;IACd,MAAM,aAAa,GAAuB,EAAE,CAAA;IAC5C,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QAChD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,aAAa,CAAC,CAAC,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;AAC/C,CAAC","sourcesContent":["/**\n * mesh 拉伸 API\n *\n * 提取来源：engine/boolean/extrude-helpers.ts (buildExtrudeParts)\n * 已是纯数据函数（ManifoldMeshData 输入输出），直接包装。\n *\n * 拉伸语义（三段模型）：\n * - back（下半）：沿法线 N 平移 offsetBack\n * - middle（中段）：平面处的截面沿 N 挤出 L\n * - front（上半）：沿法线 N 平移 offsetFront\n * 其中 offsetFront - offsetBack === length 恒成立。\n */\n\nimport { computeBoolean } from '../../boolean/csg-backend'\nimport { buildExtrudeParts } from '../../boolean/extrude-helpers'\nimport type { ManifoldMeshData } from '../../boolean/csg-backend'\nimport type { Shape, ExtrudeParams } from '../../mesh/types'\n\n/**\n * Execute a face extrude: cut the model at the cutting plane and extrude the\n * middle section by `length` along the plane normal, then union the three\n * segments back into a single solid.\n *\n * @param shape - the world-space shape to extrude.\n * @param params - extrude parameters (normal, planeDistance, length, mode).\n * @returns the extruded shape in world space.\n */\nexport async function extrude(shape: Shape, params: ExtrudeParams): Promise<Shape> {\n  const mode = params.mode ?? 'centered'\n\n  const { front, back, extruded } = await buildExtrudeParts(\n    shape as ManifoldMeshData,\n    params.normal,\n    params.planeDistance,\n    params.length,\n    mode,\n  )\n\n  // Union 三段为单体\n  const meshesToUnion: ManifoldMeshData[] = []\n  for (const part of [front, extruded, back]) {\n    if (!part || part.indices.length === 0) continue\n    meshesToUnion.push(part)\n  }\n\n  if (meshesToUnion.length === 0) {\n    throw new Error('No valid geometry to extrude')\n  }\n\n  if (meshesToUnion.length === 1) {\n    return meshesToUnion[0]\n  }\n\n  return computeBoolean(meshesToUnion, 'union')\n}\n"]}

package/dist/extra/mesh/fai_split.d.ts

@@ -0,0 +1,164 @@
+/**
+ * mesh 分割 API
+ *
+ * 提取来源：engine/boolean/csg.ts (computeSplit/computeDovetailSplit/...)
+ * 已是纯数据函数，直接包装。
+ *
+ * splitWithParams 是 UI 与重放共用的唯一分割入口：
+ * 参数编排（planeParams / planeBasis / 爆炸位移 / 世界坐标变换）
+ * 全部在此函数内部完成，调用方只需传入 cutMode + normal/offset/inPlaneAngle + bbCenter
+ * 以及各 cutMode 专属参数。
+ */
+import type { Shape, SplitResult, SplitPlane, DovetailSplitParams, DowelSplitParams, TenonSplitParams, Vec3 } from '../../mesh/types.js';
+/**
+ * Derive the cutting-plane parameters from Euler angles (in degrees), the
+ * plane position and the bounding-box center. Behavior is identical to the
+ * former split-store.computePlaneParams.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @param planePosition - offset of the cutting plane along the plane normal.
+ * @param bbCenter - world-space bounding-box center of the source mesh.
+ * @returns the plane normal, the plane's signed distance from the origin, and its center.
+ */
+export declare function computePlaneParams(rotationX: number, rotationY: number, rotationZ: number, planePosition: number, bbCenter: Vec3): {
+    normal: Vec3;
+    planeDistance: number;
+    planeCenter: Vec3;
+};
+/**
+ * Derive the plane basis vectors from Euler angles (in degrees). Behavior is
+ * identical to the former split-store.computePlaneBasis.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @returns the plane normal plus the in-plane width and depth directions.
+ */
+export declare function computePlaneBasis(rotationX: number, rotationY: number, rotationZ: number): {
+    normal: Vec3;
+    widthDir: Vec3;
+    depthDir: Vec3;
+};
+/**
+ * Derive widthDir/depthDir from the cutting-plane normal and the in-plane
+ * rotation angle. Matches computePlaneBasis(rx, ry, rz) with
+ * normal = eulerXYZToNormal(rx, ry, 0) and inPlaneAngle = rz: the rx/ry
+ * Euler XYZ decomposition is recovered from the normal, then the rz rotation
+ * is applied.
+ *
+ * normal = [sin(ry), -sin(rx)*cos(ry), cos(rx)*cos(ry)]
+ *   ry = asin(normal[0])
+ *   rx = atan2(-normal[1], normal[2])  (when cos(ry) !== 0)
+ * @param normal - cutting-plane unit normal.
+ * @param inPlaneAngle - in-plane rotation about the normal, in degrees.
+ * @returns the in-plane width and depth directions.
+ */
+export declare function computeBasisFromNormal(normal: Vec3, inPlaneAngle: number): {
+    widthDir: Vec3;
+    depthDir: Vec3;
+};
+/**
+ * Input parameters for splitWithParams.
+ */
+export interface SplitWithParamsInput {
+    /** 源几何（已在世界空间） */
+    shape: Shape;
+    /** 分割模式 */
+    cutMode: 'plane' | 'dovetail' | 'dowel' | 'straight-tenon' | 'tenon' | 'straight';
+    /** 切割面法线 */
+    normal: Vec3;
+    /** 切割面沿法线方向相对 bbCenter 的偏移（标量） */
+    offset: number;
+    /** 切割面绕法线的面内旋转（角度制，承载原 planeRotation 的 rz 分量） */
+    inPlaneAngle: number;
+    /** 源 mesh 的世界空间包围盒中心 */
+    bbCenter: Vec3;
+    /** 源 mesh 的世界空间包围盒尺寸（用于计算 bboxWidthOnWidthDir 和爆炸位移） */
+    bboxSize: Vec3;
+    /** 燕尾参数（cutMode='dovetail' 时需要） */
+    groove?: {
+        depth: number;
+        depthTolerance: number;
+        width: number;
+        widthTolerance: number;
+        flapsAngle: number;
+    };
+    /** 定位销参数（cutMode='dowel' 时需要） */
+    dowel?: {
+        diameter: number;
+        diameterTolerance: number;
+        height: number;
+        heightTolerance: number;
+    };
+    /** 直榫参数（cutMode='straight-tenon' 时需要） */
+    tenon?: {
+        sideLength: number;
+        sideLengthTolerance: number;
+        height: number;
+        heightTolerance: number;
+    };
+    /** 选择的截面（dowel/straight-tenon 用） */
+    selectedSections?: number[] | null;
+    /** 是否应用爆炸位移（默认 true；导出/重放纯几何时可设 false） */
+    applyExplode?: boolean;
+}
+/**
+ * Output of splitWithParams: the two halves plus the derived splitting data.
+ */
+export interface SplitWithParamsResult {
+    front: Shape;
+    back: Shape;
+    /** 实际使用的法线（派生量，供调用方记录/调试） */
+    normal: Vec3;
+    /** 实际使用的 planeDistance（派生量） */
+    planeDistance: number;
+    /** 实际使用的 planeCenter（派生量） */
+    planeCenter: Vec3;
+    /** 实际使用的 widthDir（派生量） */
+    widthDir: Vec3;
+    /** 爆炸位移（front 正、back 负） */
+    frontExplodeOffset: number;
+    backExplodeOffset: number;
+}
+/**
+ * Unified split entry point: the single split function shared by the UI
+ * executor and script replay. All parameter orchestration (planeParams,
+ * planeBasis, bboxWidthOnWidthDir, explode offset) happens inside this
+ * function; callers pass only semantic parameters. Both interaction paths
+ * (mouse / code) converge here, so the geometry result is identical.
+ * @param input - the split mode-specific input (shape, plane, mode params).
+ * @returns the split result with front/back halves and derived plane data.
+ */
+export declare function splitWithParams(input: SplitWithParamsInput): Promise<SplitWithParamsResult>;
+/**
+ * Plane split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param plane - the cutting plane (normal + offset).
+ * @returns the front and back halves of the shape.
+ */
+export declare function split(shape: Shape, plane: SplitPlane): Promise<{
+    front: Shape;
+    back: Shape;
+}>;
+/**
+ * Dovetail split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dovetail groove parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dovetail wedge.
+ */
+export declare function dovetailSplit(shape: Shape, params: DovetailSplitParams): Promise<SplitResult>;
+/**
+ * Dowel-pin split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dowel parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dowel wedge.
+ */
+export declare function dowelSplit(shape: Shape, params: DowelSplitParams): Promise<SplitResult>;
+/**
+ * Straight-tenon split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - tenon parameters plus the cutting plane setup.
+ * @returns the front/back halves and the tenon wedge.
+ */
+export declare function tenonSplit(shape: Shape, params: TenonSplitParams): Promise<SplitResult>;
+//# sourceMappingURL=fai_split.d.ts.map

package/dist/extra/mesh/fai_split.d.ts.map

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

package/dist/extra/mesh/fai_split.js

@@ -0,0 +1,269 @@
+/**
+ * mesh 分割 API
+ *
+ * 提取来源：engine/boolean/csg.ts (computeSplit/computeDovetailSplit/...)
+ * 已是纯数据函数，直接包装。
+ *
+ * splitWithParams 是 UI 与重放共用的唯一分割入口：
+ * 参数编排（planeParams / planeBasis / 爆炸位移 / 世界坐标变换）
+ * 全部在此函数内部完成，调用方只需传入 cutMode + normal/offset/inPlaneAngle + bbCenter
+ * 以及各 cutMode 专属参数。
+ */
+import { computeSplit, computeDovetailSplit, computeDowelSplit, computeStraightTenonSplit, } from '../../boolean/csg-backend.js';
+import { Euler, Quat, Vec3 as Vec3C } from '../../math3d/index.js';
+// ── 派生量计算（从 split-store 下沉，UI 与重放共用同一份公式） ──
+/**
+ * Derive the cutting-plane parameters from Euler angles (in degrees), the
+ * plane position and the bounding-box center. Behavior is identical to the
+ * former split-store.computePlaneParams.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @param planePosition - offset of the cutting plane along the plane normal.
+ * @param bbCenter - world-space bounding-box center of the source mesh.
+ * @returns the plane normal, the plane's signed distance from the origin, and its center.
+ */
+export function computePlaneParams(rotationX, rotationY, rotationZ, planePosition, bbCenter) {
+    const rx = (rotationX * Math.PI) / 180;
+    const ry = (rotationY * Math.PI) / 180;
+    const rz = (rotationZ * Math.PI) / 180;
+    const euler = new Euler(rx, ry, rz, 'XYZ');
+    const quat = new Quat().setFromEuler(euler);
+    const normalVec = new Vec3C(0, 0, 1).applyQuaternion(quat);
+    const normal = [normalVec.x, normalVec.y, normalVec.z];
+    const planeCenter = [
+        bbCenter[0] + planePosition * normal[0],
+        bbCenter[1] + planePosition * normal[1],
+        bbCenter[2] + planePosition * normal[2],
+    ];
+    const planeDistance = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2];
+    return { normal, planeDistance, planeCenter };
+}
+/**
+ * Derive the plane basis vectors from Euler angles (in degrees). Behavior is
+ * identical to the former split-store.computePlaneBasis.
+ * @param rotationX - rotation about X in degrees.
+ * @param rotationY - rotation about Y in degrees.
+ * @param rotationZ - rotation about Z in degrees.
+ * @returns the plane normal plus the in-plane width and depth directions.
+ */
+export function computePlaneBasis(rotationX, rotationY, rotationZ) {
+    const rx = (rotationX * Math.PI) / 180;
+    const ry = (rotationY * Math.PI) / 180;
+    const rz = (rotationZ * Math.PI) / 180;
+    const euler = new Euler(rx, ry, rz, 'XYZ');
+    const quat = new Quat().setFromEuler(euler);
+    const normalVec = new Vec3C(0, 0, 1).applyQuaternion(quat);
+    const widthVec = new Vec3C(1, 0, 0).applyQuaternion(quat);
+    const depthVec = new Vec3C(0, 1, 0).applyQuaternion(quat);
+    return {
+        normal: [normalVec.x, normalVec.y, normalVec.z],
+        widthDir: [widthVec.x, widthVec.y, widthVec.z],
+        depthDir: [depthVec.x, depthVec.y, depthVec.z],
+    };
+}
+// ── 从法线 + 面内旋转推导基向量（纯数学，无 THREE 依赖） ──
+/**
+ * Derive widthDir/depthDir from the cutting-plane normal and the in-plane
+ * rotation angle. Matches computePlaneBasis(rx, ry, rz) with
+ * normal = eulerXYZToNormal(rx, ry, 0) and inPlaneAngle = rz: the rx/ry
+ * Euler XYZ decomposition is recovered from the normal, then the rz rotation
+ * is applied.
+ *
+ * normal = [sin(ry), -sin(rx)*cos(ry), cos(rx)*cos(ry)]
+ *   ry = asin(normal[0])
+ *   rx = atan2(-normal[1], normal[2])  (when cos(ry) !== 0)
+ * @param normal - cutting-plane unit normal.
+ * @param inPlaneAngle - in-plane rotation about the normal, in degrees.
+ * @returns the in-plane width and depth directions.
+ */
+export function computeBasisFromNormal(normal, inPlaneAngle) {
+    const sinRy = Math.max(-1, Math.min(1, normal[0]));
+    const ry = Math.asin(sinRy);
+    const cosRy = Math.cos(ry);
+    let rx;
+    if (Math.abs(cosRy) < 1e-10) {
+        // 万向锁：ry = ±90°，rx 与 rz 耦合，设 rx = 0
+        rx = 0;
+    }
+    else {
+        rx = Math.atan2(-normal[1], normal[2]);
+    }
+    const rz = (inPlaneAngle * Math.PI) / 180;
+    // R = RX(rx) · RY(ry)（不含 rz 的部分）
+    // widthDir = R · (cos(rz), sin(rz), 0)
+    // depthDir = R · (-sin(rz), cos(rz), 0)
+    const cr = Math.cos(ry), sr = Math.sin(ry);
+    const cx = Math.cos(rx), sx = Math.sin(rx);
+    const cosRz = Math.cos(rz), sinRz = Math.sin(rz);
+    const widthDir = [
+        cr * cosRz,
+        sx * sr * cosRz + cx * sinRz,
+        -cx * sr * cosRz + sx * sinRz,
+    ];
+    const depthDir = [
+        -cr * sinRz,
+        -sx * sr * sinRz + cx * cosRz,
+        cx * sr * sinRz + sx * cosRz,
+    ];
+    return { widthDir, depthDir };
+}
+/**
+ * Unified split entry point: the single split function shared by the UI
+ * executor and script replay. All parameter orchestration (planeParams,
+ * planeBasis, bboxWidthOnWidthDir, explode offset) happens inside this
+ * function; callers pass only semantic parameters. Both interaction paths
+ * (mouse / code) converge here, so the geometry result is identical.
+ * @param input - the split mode-specific input (shape, plane, mode params).
+ * @returns the split result with front/back halves and derived plane data.
+ */
+export async function splitWithParams(input) {
+    const { shape, cutMode, normal, offset, inPlaneAngle, bbCenter, bboxSize } = input;
+    // 1. 从 normal + offset + bbCenter 派生切割平面参数
+    const planeCenter = [
+        bbCenter[0] + offset * normal[0],
+        bbCenter[1] + offset * normal[1],
+        bbCenter[2] + offset * normal[2],
+    ];
+    const planeDistance = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2];
+    // 2. 从 normal + inPlaneAngle 派生基向量
+    const { widthDir } = computeBasisFromNormal(normal, inPlaneAngle);
+    // 3. 按 cutMode 分发
+    let front;
+    let back;
+    if (cutMode === 'dovetail') {
+        const bboxWidthOnWidthDir = Math.abs(bboxSize[0] * widthDir[0]) +
+            Math.abs(bboxSize[1] * widthDir[1]) +
+            Math.abs(bboxSize[2] * widthDir[2]);
+        const groove = input.groove ?? {
+            depth: 0, depthTolerance: 0, width: 0, widthTolerance: 0, flapsAngle: 0,
+        };
+        const result = await computeDovetailSplit(shape, normal, planeDistance, planeCenter, widthDir, bboxWidthOnWidthDir, groove);
+        front = result.front;
+        back = result.back;
+        const result2 = await finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input);
+        return result2;
+    }
+    else if (cutMode === 'dowel') {
+        const dowel = input.dowel ?? {
+            diameter: 0, diameterTolerance: 0, height: 0, heightTolerance: 0,
+        };
+        const result = await computeDowelSplit(shape, normal, planeDistance, planeCenter, widthDir, dowel, input.selectedSections ?? null);
+        front = result.front;
+        back = result.back;
+        return finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input);
+    }
+    else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {
+        const tenon = input.tenon ?? {
+            sideLength: 0, sideLengthTolerance: 0, height: 0, heightTolerance: 0,
+        };
+        const result = await computeStraightTenonSplit(shape, normal, planeDistance, planeCenter, widthDir, tenon, input.selectedSections ?? null);
+        front = result.front;
+        back = result.back;
+        return finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input);
+    }
+    else {
+        // plane / straight / default
+        const result = await computeSplit(shape, normal, planeDistance);
+        front = result.front;
+        back = result.back;
+        return finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input);
+    }
+}
+/** 计算爆炸位移并应用到 front/back */
+async function finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input) {
+    const applyExplode = input.applyExplode ?? true;
+    // 爆炸位移：包围盒对角线的 2% + joinery 深度的一半
+    const bboxDiagonal = Math.sqrt(bboxSize[0] * bboxSize[0] + bboxSize[1] * bboxSize[1] + bboxSize[2] * bboxSize[2]);
+    const baseOffset = bboxDiagonal * 0.02;
+    let joineryOffset = 0;
+    if (cutMode === 'dovetail') {
+        joineryOffset = (input.groove?.depth ?? 0) / 2;
+    }
+    else if (cutMode === 'dowel') {
+        joineryOffset = (input.dowel?.height ?? 0) / 2;
+    }
+    else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {
+        joineryOffset = (input.tenon?.height ?? 0) / 2;
+    }
+    const frontOffset = baseOffset + joineryOffset;
+    const backOffset = -(baseOffset + joineryOffset);
+    if (applyExplode) {
+        front = { positions: offsetPositions(front.positions, normal, frontOffset), indices: front.indices };
+        back = { positions: offsetPositions(back.positions, normal, backOffset), indices: back.indices };
+    }
+    return {
+        front,
+        back,
+        normal,
+        planeDistance,
+        planeCenter,
+        widthDir,
+        frontExplodeOffset: applyExplode ? frontOffset : 0,
+        backExplodeOffset: applyExplode ? backOffset : 0,
+    };
+}
+/** 沿法线方向偏移所有顶点 */
+function offsetPositions(positions, normal, offset) {
+    const out = new Float32Array(positions);
+    for (let i = 0; i < out.length; i += 3) {
+        out[i] += normal[0] * offset;
+        out[i + 1] += normal[1] * offset;
+        out[i + 2] += normal[2] * offset;
+    }
+    return out;
+}
+// ── 低级 API（保留向后兼容） ──
+/**
+ * Plane split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param plane - the cutting plane (normal + offset).
+ * @returns the front and back halves of the shape.
+ */
+export async function split(shape, plane) {
+    const result = await computeSplit(shape, plane.normal, plane.offset);
+    return { front: result.front, back: result.back };
+}
+/**
+ * Dovetail split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dovetail groove parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dovetail wedge.
+ */
+export async function dovetailSplit(shape, params) {
+    const result = await computeDovetailSplit(shape, params.plane.normal, params.plane.offset, params.planeCenter, params.widthDir, params.bboxWidthOnWidthDir, params.groove);
+    return {
+        front: result.front,
+        back: result.back,
+        wedge: result.wedge,
+    };
+}
+/**
+ * Dowel-pin split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - dowel parameters plus the cutting plane setup.
+ * @returns the front/back halves and the dowel wedge.
+ */
+export async function dowelSplit(shape, params) {
+    const result = await computeDowelSplit(shape, params.plane.normal, params.plane.offset, params.planeCenter, params.widthDir, params.dowel, params.selectedSections);
+    return {
+        front: result.front,
+        back: result.back,
+        wedge: result.wedge,
+    };
+}
+/**
+ * Straight-tenon split of a mesh shape.
+ * @param shape - the mesh shape to split.
+ * @param params - tenon parameters plus the cutting plane setup.
+ * @returns the front/back halves and the tenon wedge.
+ */
+export async function tenonSplit(shape, params) {
+    const result = await computeStraightTenonSplit(shape, params.plane.normal, params.plane.offset, params.planeCenter, params.widthDir, params.tenon, params.selectedSections);
+    return {
+        front: result.front,
+        back: result.back,
+        wedge: result.wedge,
+    };
+}
+//# sourceMappingURL=fai_split.js.map

package/dist/extra/mesh/fai_split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fai_split.js","sourceRoot":"","sources":["../../../src/extra/mesh/fai_split.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mesh 分割 API\n *\n * 提取来源：engine/boolean/csg.ts (computeSplit/computeDovetailSplit/...)\n * 已是纯数据函数，直接包装。\n *\n * splitWithParams 是 UI 与重放共用的唯一分割入口：\n * 参数编排（planeParams / planeBasis / 爆炸位移 / 世界坐标变换）\n * 全部在此函数内部完成，调用方只需传入 cutMode + normal/offset/inPlaneAngle + bbCenter\n * 以及各 cutMode 专属参数。\n */\n\nimport {\n  computeSplit,\n  computeDovetailSplit,\n  computeDowelSplit,\n  computeStraightTenonSplit,\n} from '../../boolean/csg-backend'\nimport { Euler, Quat, Vec3 as Vec3C } from '../../math3d'\nimport type { Shape, SplitResult, SplitPlane, DovetailSplitParams, DowelSplitParams, TenonSplitParams, Vec3 } from '../../mesh/types'\n\n// ── 派生量计算（从 split-store 下沉，UI 与重放共用同一份公式） ──\n\n/**\n * Derive the cutting-plane parameters from Euler angles (in degrees), the\n * plane position and the bounding-box center. Behavior is identical to the\n * former split-store.computePlaneParams.\n * @param rotationX - rotation about X in degrees.\n * @param rotationY - rotation about Y in degrees.\n * @param rotationZ - rotation about Z in degrees.\n * @param planePosition - offset of the cutting plane along the plane normal.\n * @param bbCenter - world-space bounding-box center of the source mesh.\n * @returns the plane normal, the plane's signed distance from the origin, and its center.\n */\nexport function computePlaneParams(\n  rotationX: number,\n  rotationY: number,\n  rotationZ: number,\n  planePosition: number,\n  bbCenter: Vec3,\n): { normal: Vec3; planeDistance: number; planeCenter: Vec3 } {\n  const rx = (rotationX * Math.PI) / 180\n  const ry = (rotationY * Math.PI) / 180\n  const rz = (rotationZ * Math.PI) / 180\n\n  const euler = new Euler(rx, ry, rz, 'XYZ')\n  const quat = new Quat().setFromEuler(euler)\n  const normalVec = new Vec3C(0, 0, 1).applyQuaternion(quat)\n\n  const normal: Vec3 = [normalVec.x, normalVec.y, normalVec.z]\n\n  const planeCenter: Vec3 = [\n    bbCenter[0] + planePosition * normal[0],\n    bbCenter[1] + planePosition * normal[1],\n    bbCenter[2] + planePosition * normal[2],\n  ]\n\n  const planeDistance = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2]\n\n  return { normal, planeDistance, planeCenter }\n}\n\n/**\n * Derive the plane basis vectors from Euler angles (in degrees). Behavior is\n * identical to the former split-store.computePlaneBasis.\n * @param rotationX - rotation about X in degrees.\n * @param rotationY - rotation about Y in degrees.\n * @param rotationZ - rotation about Z in degrees.\n * @returns the plane normal plus the in-plane width and depth directions.\n */\nexport function computePlaneBasis(\n  rotationX: number,\n  rotationY: number,\n  rotationZ: number,\n): { normal: Vec3; widthDir: Vec3; depthDir: Vec3 } {\n  const rx = (rotationX * Math.PI) / 180\n  const ry = (rotationY * Math.PI) / 180\n  const rz = (rotationZ * Math.PI) / 180\n\n  const euler = new Euler(rx, ry, rz, 'XYZ')\n  const quat = new Quat().setFromEuler(euler)\n\n  const normalVec = new Vec3C(0, 0, 1).applyQuaternion(quat)\n  const widthVec = new Vec3C(1, 0, 0).applyQuaternion(quat)\n  const depthVec = new Vec3C(0, 1, 0).applyQuaternion(quat)\n\n  return {\n    normal: [normalVec.x, normalVec.y, normalVec.z],\n    widthDir: [widthVec.x, widthVec.y, widthVec.z],\n    depthDir: [depthVec.x, depthVec.y, depthVec.z],\n  }\n}\n\n// ── 从法线 + 面内旋转推导基向量（纯数学，无 THREE 依赖） ──\n\n/**\n * Derive widthDir/depthDir from the cutting-plane normal and the in-plane\n * rotation angle. Matches computePlaneBasis(rx, ry, rz) with\n * normal = eulerXYZToNormal(rx, ry, 0) and inPlaneAngle = rz: the rx/ry\n * Euler XYZ decomposition is recovered from the normal, then the rz rotation\n * is applied.\n *\n * normal = [sin(ry), -sin(rx)*cos(ry), cos(rx)*cos(ry)]\n *   ry = asin(normal[0])\n *   rx = atan2(-normal[1], normal[2])  (when cos(ry) !== 0)\n * @param normal - cutting-plane unit normal.\n * @param inPlaneAngle - in-plane rotation about the normal, in degrees.\n * @returns the in-plane width and depth directions.\n */\nexport function computeBasisFromNormal(\n  normal: Vec3,\n  inPlaneAngle: number,\n): { widthDir: Vec3; depthDir: Vec3 } {\n  const sinRy = Math.max(-1, Math.min(1, normal[0]))\n  const ry = Math.asin(sinRy)\n  const cosRy = Math.cos(ry)\n\n  let rx: number\n  if (Math.abs(cosRy) < 1e-10) {\n    // 万向锁：ry = ±90°，rx 与 rz 耦合，设 rx = 0\n    rx = 0\n  } else {\n    rx = Math.atan2(-normal[1], normal[2])\n  }\n\n  const rz = (inPlaneAngle * Math.PI) / 180\n\n  // R = RX(rx) · RY(ry)（不含 rz 的部分）\n  // widthDir = R · (cos(rz), sin(rz), 0)\n  // depthDir = R · (-sin(rz), cos(rz), 0)\n  const cr = Math.cos(ry), sr = Math.sin(ry)\n  const cx = Math.cos(rx), sx = Math.sin(rx)\n  const cosRz = Math.cos(rz), sinRz = Math.sin(rz)\n\n  const widthDir: Vec3 = [\n    cr * cosRz,\n    sx * sr * cosRz + cx * sinRz,\n    -cx * sr * cosRz + sx * sinRz,\n  ]\n\n  const depthDir: Vec3 = [\n    -cr * sinRz,\n    -sx * sr * sinRz + cx * cosRz,\n    cx * sr * sinRz + sx * cosRz,\n  ]\n\n  return { widthDir, depthDir }\n}\n\n// ── 统一分割入口 ──\n\n/**\n * Input parameters for splitWithParams.\n */\nexport interface SplitWithParamsInput {\n  /** 源几何（已在世界空间） */\n  shape: Shape\n  /** 分割模式 */\n  cutMode: 'plane' | 'dovetail' | 'dowel' | 'straight-tenon' | 'tenon' | 'straight'\n  /** 切割面法线 */\n  normal: Vec3\n  /** 切割面沿法线方向相对 bbCenter 的偏移（标量） */\n  offset: number\n  /** 切割面绕法线的面内旋转（角度制，承载原 planeRotation 的 rz 分量） */\n  inPlaneAngle: number\n  /** 源 mesh 的世界空间包围盒中心 */\n  bbCenter: Vec3\n  /** 源 mesh 的世界空间包围盒尺寸（用于计算 bboxWidthOnWidthDir 和爆炸位移） */\n  bboxSize: Vec3\n  /** 燕尾参数（cutMode='dovetail' 时需要） */\n  groove?: {\n    depth: number\n    depthTolerance: number\n    width: number\n    widthTolerance: number\n    flapsAngle: number\n  }\n  /** 定位销参数（cutMode='dowel' 时需要） */\n  dowel?: {\n    diameter: number\n    diameterTolerance: number\n    height: number\n    heightTolerance: number\n  }\n  /** 直榫参数（cutMode='straight-tenon' 时需要） */\n  tenon?: {\n    sideLength: number\n    sideLengthTolerance: number\n    height: number\n    heightTolerance: number\n  }\n  /** 选择的截面（dowel/straight-tenon 用） */\n  selectedSections?: number[] | null\n  /** 是否应用爆炸位移（默认 true；导出/重放纯几何时可设 false） */\n  applyExplode?: boolean\n}\n\n/**\n * Output of splitWithParams: the two halves plus the derived splitting data.\n */\nexport interface SplitWithParamsResult {\n  front: Shape\n  back: Shape\n  /** 实际使用的法线（派生量，供调用方记录/调试） */\n  normal: Vec3\n  /** 实际使用的 planeDistance（派生量） */\n  planeDistance: number\n  /** 实际使用的 planeCenter（派生量） */\n  planeCenter: Vec3\n  /** 实际使用的 widthDir（派生量） */\n  widthDir: Vec3\n  /** 爆炸位移（front 正、back 负） */\n  frontExplodeOffset: number\n  backExplodeOffset: number\n}\n\n/**\n * Unified split entry point: the single split function shared by the UI\n * executor and script replay. All parameter orchestration (planeParams,\n * planeBasis, bboxWidthOnWidthDir, explode offset) happens inside this\n * function; callers pass only semantic parameters. Both interaction paths\n * (mouse / code) converge here, so the geometry result is identical.\n * @param input - the split mode-specific input (shape, plane, mode params).\n * @returns the split result with front/back halves and derived plane data.\n */\nexport async function splitWithParams(input: SplitWithParamsInput): Promise<SplitWithParamsResult> {\n  const { shape, cutMode, normal, offset, inPlaneAngle, bbCenter, bboxSize } = input\n\n  // 1. 从 normal + offset + bbCenter 派生切割平面参数\n  const planeCenter: Vec3 = [\n    bbCenter[0] + offset * normal[0],\n    bbCenter[1] + offset * normal[1],\n    bbCenter[2] + offset * normal[2],\n  ]\n  const planeDistance = normal[0] * planeCenter[0] + normal[1] * planeCenter[1] + normal[2] * planeCenter[2]\n\n  // 2. 从 normal + inPlaneAngle 派生基向量\n  const { widthDir } = computeBasisFromNormal(normal, inPlaneAngle)\n\n  // 3. 按 cutMode 分发\n  let front: Shape\n  let back: Shape\n\n  if (cutMode === 'dovetail') {\n    const bboxWidthOnWidthDir =\n      Math.abs(bboxSize[0] * widthDir[0]) +\n      Math.abs(bboxSize[1] * widthDir[1]) +\n      Math.abs(bboxSize[2] * widthDir[2])\n    const groove = input.groove ?? {\n      depth: 0, depthTolerance: 0, width: 0, widthTolerance: 0, flapsAngle: 0,\n    }\n    const result = await computeDovetailSplit(shape, normal, planeDistance, planeCenter, widthDir, bboxWidthOnWidthDir, groove)\n    front = result.front; back = result.back\n\n    const result2: SplitWithParamsResult = await finalizeExplode(\n      front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input,\n    )\n    return result2\n  } else if (cutMode === 'dowel') {\n    const dowel = input.dowel ?? {\n      diameter: 0, diameterTolerance: 0, height: 0, heightTolerance: 0,\n    }\n    const result = await computeDowelSplit(shape, normal, planeDistance, planeCenter, widthDir, dowel, input.selectedSections ?? null)\n    front = result.front; back = result.back\n    return finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input)\n  } else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {\n    const tenon = input.tenon ?? {\n      sideLength: 0, sideLengthTolerance: 0, height: 0, heightTolerance: 0,\n    }\n    const result = await computeStraightTenonSplit(shape, normal, planeDistance, planeCenter, widthDir, tenon, input.selectedSections ?? null)\n    front = result.front; back = result.back\n    return finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input)\n  } else {\n    // plane / straight / default\n    const result = await computeSplit(shape, normal, planeDistance)\n    front = result.front; back = result.back\n    return finalizeExplode(front, back, normal, planeDistance, planeCenter, widthDir, bboxSize, cutMode, input)\n  }\n}\n\n/** 计算爆炸位移并应用到 front/back */\nasync function finalizeExplode(\n  front: Shape,\n  back: Shape,\n  normal: Vec3,\n  planeDistance: number,\n  planeCenter: Vec3,\n  widthDir: Vec3,\n  bboxSize: Vec3,\n  cutMode: string,\n  input: SplitWithParamsInput,\n): Promise<SplitWithParamsResult> {\n  const applyExplode = input.applyExplode ?? true\n\n  // 爆炸位移：包围盒对角线的 2% + joinery 深度的一半\n  const bboxDiagonal = Math.sqrt(\n    bboxSize[0] * bboxSize[0] + bboxSize[1] * bboxSize[1] + bboxSize[2] * bboxSize[2],\n  )\n  const baseOffset = bboxDiagonal * 0.02\n  let joineryOffset = 0\n  if (cutMode === 'dovetail') {\n    joineryOffset = (input.groove?.depth ?? 0) / 2\n  } else if (cutMode === 'dowel') {\n    joineryOffset = (input.dowel?.height ?? 0) / 2\n  } else if (cutMode === 'straight-tenon' || cutMode === 'tenon') {\n    joineryOffset = (input.tenon?.height ?? 0) / 2\n  }\n  const frontOffset = baseOffset + joineryOffset\n  const backOffset = -(baseOffset + joineryOffset)\n\n  if (applyExplode) {\n    front = { positions: offsetPositions(front.positions, normal, frontOffset), indices: front.indices }\n    back = { positions: offsetPositions(back.positions, normal, backOffset), indices: back.indices }\n  }\n\n  return {\n    front,\n    back,\n    normal,\n    planeDistance,\n    planeCenter,\n    widthDir,\n    frontExplodeOffset: applyExplode ? frontOffset : 0,\n    backExplodeOffset: applyExplode ? backOffset : 0,\n  }\n}\n\n/** 沿法线方向偏移所有顶点 */\nfunction offsetPositions(\n  positions: Float32Array,\n  normal: Vec3,\n  offset: number,\n): Float32Array {\n  const out = new Float32Array(positions)\n  for (let i = 0; i < out.length; i += 3) {\n    out[i]     += normal[0] * offset\n    out[i + 1] += normal[1] * offset\n    out[i + 2] += normal[2] * offset\n  }\n  return out\n}\n\n// ── 低级 API（保留向后兼容） ──\n\n/**\n * Plane split of a mesh shape.\n * @param shape - the mesh shape to split.\n * @param plane - the cutting plane (normal + offset).\n * @returns the front and back halves of the shape.\n */\nexport async function split(shape: Shape, plane: SplitPlane): Promise<{ front: Shape; back: Shape }> {\n  const result = await computeSplit(shape, plane.normal, plane.offset)\n  return { front: result.front, back: result.back }\n}\n\n/**\n * Dovetail split of a mesh shape.\n * @param shape - the mesh shape to split.\n * @param params - dovetail groove parameters plus the cutting plane setup.\n * @returns the front/back halves and the dovetail wedge.\n */\nexport async function dovetailSplit(shape: Shape, params: DovetailSplitParams): Promise<SplitResult> {\n  const result = await computeDovetailSplit(\n    shape,\n    params.plane.normal,\n    params.plane.offset,\n    params.planeCenter,\n    params.widthDir,\n    params.bboxWidthOnWidthDir,\n    params.groove,\n  )\n  return {\n    front: result.front,\n    back: result.back,\n    wedge: result.wedge,\n  }\n}\n\n/**\n * Dowel-pin split of a mesh shape.\n * @param shape - the mesh shape to split.\n * @param params - dowel parameters plus the cutting plane setup.\n * @returns the front/back halves and the dowel wedge.\n */\nexport async function dowelSplit(shape: Shape, params: DowelSplitParams): Promise<SplitResult> {\n  const result = await computeDowelSplit(\n    shape,\n    params.plane.normal,\n    params.plane.offset,\n    params.planeCenter,\n    params.widthDir,\n    params.dowel,\n    params.selectedSections,\n  )\n  return {\n    front: result.front,\n    back: result.back,\n    wedge: result.wedge,\n  }\n}\n\n/**\n * Straight-tenon split of a mesh shape.\n * @param shape - the mesh shape to split.\n * @param params - tenon parameters plus the cutting plane setup.\n * @returns the front/back halves and the tenon wedge.\n */\nexport async function tenonSplit(shape: Shape, params: TenonSplitParams): Promise<SplitResult> {\n  const result = await computeStraightTenonSplit(\n    shape,\n    params.plane.normal,\n    params.plane.offset,\n    params.planeCenter,\n    params.widthDir,\n    params.tenon,\n    params.selectedSections,\n  )\n  return {\n    front: result.front,\n    back: result.back,\n    wedge: result.wedge,\n  }\n}\n"]}

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

@@ -0,0 +1,29 @@
+/**
+ * mesh primitives — editor extension mesh-path creators.
+ *
+ * `text` and `svgExtrude` are the two creators whose mesh implementations
+ * used to carry three's non-basic geometry chain (`Shape` / `ExtrudeGeometry` /
+ * `SVGLoader`). They moved here from core's `mesh/primitives.ts` so the
+ * platform mesh entry no longer drags that chain (nor `three/examples/**`)
+ * into every consumer.
+ *
+ * Both return core `Shape` directly: text/SVG → Contour[] → `extrudeShape`
+ * (three-free). Coordinates: Z-up, millimetres.
+ */
+import type { Shape, TextParams, SvgExtrudeParams } from '../../mesh/types.js';
+/**
+ * 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 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;
+//# sourceMappingURL=primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/extra/mesh/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAM3E;;;;;;GAMG;AACH,wBAAsB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAc7D;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,CAO1D"}

package/dist/extra/mesh/primitives.js

@@ -0,0 +1,41 @@
+import { svgToExtrudedGeometry } from '../extras/svg-extrude.js';
+import { createTextGeometry, getOpentypeFont } from '../extras/text-geometry.js';
+import { createMixedTextGeometry } from '../extras/text-cjk.js';
+import { containsCjk, loadSystemCjkFont } from '../../primitives/text/cjk-font.js';
+/**
+ * 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 font = await getOpentypeFont();
+    if (containsCjk(params.text)) {
+        const cjkFont = await loadSystemCjkFont();
+        if (cjkFont) {
+            return createMixedTextGeometry(params.text, params.size, params.depth, cjkFont.font, font);
+        }
+        // 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, '?');
+        return createTextGeometry(fallback, params.size, params.depth, font);
+    }
+    return createTextGeometry(params.text, params.size, params.depth, font);
+}
+/**
+ * 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) {
+    return svgToExtrudedGeometry(params.svg, {
+        depth: params.depth,
+        targetLongSide: params.targetLongSide ?? 20,
+        naturalWidth: params.naturalWidth ?? 0,
+        naturalHeight: params.naturalHeight ?? 0,
+    });
+}
+//# sourceMappingURL=primitives.js.map

package/dist/extra/mesh/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/extra/mesh/primitives.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,MAAkB;IAC3C,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAA;IACpC,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAA;QACzC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC5F,CAAC;QACD,sEAAsE;QACtE,0EAA0E;QAC1E,kEAAkE;QAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,wEAAwE,EAAE,GAAG,CAAC,CAAA;QACnH,OAAO,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACtE,CAAC;IACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,MAAwB;IACjD,OAAO,qBAAqB,CAAC,MAAM,CAAC,GAAG,EAAE;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,EAAE;QAC3C,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC;QACtC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC;KACzC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["/**\n * mesh primitives — editor extension mesh-path creators.\n *\n * `text` and `svgExtrude` are the two creators whose mesh implementations\n * used to carry three's non-basic geometry chain (`Shape` / `ExtrudeGeometry` /\n * `SVGLoader`). They moved here from core's `mesh/primitives.ts` so the\n * platform mesh entry no longer drags that chain (nor `three/examples/**`)\n * into every consumer.\n *\n * Both return core `Shape` directly: text/SVG → Contour[] → `extrudeShape`\n * (three-free). Coordinates: Z-up, millimetres.\n */\nimport type { Shape, TextParams, SvgExtrudeParams } from '../../mesh/types'\nimport { svgToExtrudedGeometry } from '../extras/svg-extrude'\nimport { createTextGeometry, getOpentypeFont } from '../extras/text-geometry'\nimport { createMixedTextGeometry } from '../extras/text-cjk'\nimport { containsCjk, loadSystemCjkFont } from '../../primitives/text/cjk-font'\n\n/**\n * Create text geometry. Font loading is asynchronous, so this function is\n * async; CJK text is rendered with the system font when one is available.\n *\n * @param params - text parameters (text, size, depth).\n * @returns the text shape.\n */\nexport async function text(params: TextParams): Promise<Shape> {\n  const font = await getOpentypeFont()\n  if (containsCjk(params.text)) {\n    const cjkFont = await loadSystemCjkFont()\n    if (cjkFont) {\n      return createMixedTextGeometry(params.text, params.size, params.depth, cjkFont.font, font)\n    }\n    // No CJK font available: replace CJK chars with '?' so geometry still\n    // can be created (graceful degradation). Without this, createTextGeometry\n    // would throw because CJK glyphs are .notdef in OpenSans Regular.\n    const fallback = params.text.replace(/[\\u4E00-\\u9FFF\\u3400-\\u4DBF\\u2F800-\\u2FA1F\\u3000-\\u303F\\uFF00-\\uFFEF]/g, '?')\n    return createTextGeometry(fallback, params.size, params.depth, font)\n  }\n  return createTextGeometry(params.text, params.size, params.depth, font)\n}\n\n/**\n * Create an extruded geometry from an SVG source.\n *\n * @param params - SVG extrude parameters (svg, depth, target size, optional natural size).\n * @returns the extruded shape.\n */\nexport function svgExtrude(params: SvgExtrudeParams): Shape {\n  return svgToExtrudedGeometry(params.svg, {\n    depth: params.depth,\n    targetLongSide: params.targetLongSide ?? 20,\n    naturalWidth: params.naturalWidth ?? 0,\n    naturalHeight: params.naturalHeight ?? 0,\n  })\n}\n"]}