@faicad/faijs 0.13.0

package/dist/primitives/brep-primitives.js

@@ -0,0 +1,297 @@
+/**
+ * Primitive → CAD 实体转换。
+ *
+ * 将本项目的各种 primitive（cube, sphere, cylinder, cone, wedge, screw）
+ * 转换为 OCCT CAD 实体（Solid），并支持导出为 BREP 格式的 STEP 文件。
+ *
+ * 两条路径：
+ *
+ * 1. **直接构造路径**（primitive path）：
+ *    对于有 OCCT 直接对应的基本体（cube, sphere, cylinder, cone, wedge），
+ *    直接调用 OCCT 构造函数（makeBox, makeSphere, makeCylinder, makeCone）
+ *    或用 extrude 从 2D 轮廓构造（wedge）。
+ *    产出精确 BREP——平面是 PLANE，圆柱面是 CYLINDRICAL_SURFACE，等。
+ *
+ * 2. **Mesh 重建路径**（mesh path）：
+ *    对于无 OCCT 直接对应的复杂形状（screw, text），从 THREE.js BufferGeometry
+ *    提取三角网格，经 meshReconstruct.ts 的多阶段愈合管线重建为 Solid。
+ *    产出仍为 BREP，但曲面由多个小三角平面近似（faceted）。在本项目里，默认brep模型不包含此类近似的到的模型。
+ *
+ * 坐标系：本项目 primitive 为 Z-up（经过 ROT_Y_TO_Z 旋转），
+ * OCCT 默认也是 Z-up，因此直接对应，无需额外轴转换。
+ */
+import { reconstructSolidFromMesh } from '../occt-kernel/meshReconstruct.js';
+// ─── 辅助：从 BufferGeometry 提取网格数据 ───
+/**
+ * Extract positions + indices from a THREE.BufferGeometry for the mesh reconstruction path.
+ *
+ * Handles both indexed and non-indexed geometry.
+ * Sequential indices are created automatically for non-indexed geometry.
+ *
+ * @param geo - the source THREE.BufferGeometry.
+ * @returns the extracted positions and indices arrays.
+ */
+export function extractMeshData(geo) {
+    const posAttr = geo.getAttribute('position');
+    if (!posAttr)
+        throw new Error('Geometry has no position attribute');
+    const positions = new Float32Array(posAttr.array);
+    const idxAttr = geo.getIndex();
+    let indices;
+    if (idxAttr) {
+        indices = new Uint32Array(idxAttr.array);
+    }
+    else {
+        // Non-indexed: create sequential indices
+        indices = new Uint32Array(posAttr.count);
+        for (let i = 0; i < posAttr.count; i++)
+            indices[i] = i;
+    }
+    return { positions, indices };
+}
+// ─── 直接构造路径 ───
+/** 应用 center 偏移到 OCCT solid（如果有 center 参数）。 */
+function applyCenter(kernel, solid, center) {
+    if (!center)
+        return solid;
+    const translated = kernel.translate(solid, center[0], center[1], center[2]);
+    kernel.release(solid);
+    return translated;
+}
+/**
+ * 用 OCCT 直接构造一个长方体 Solid（brepjs `box(width, depth, height,
+ * {at?, centered?})` 契约，§4.1 A 决策；与 mesh 路径逐点对齐）。
+ *
+ * 几何语义与 vendored `primitiveFns.box` 完全一致：
+ * 默认 min 角点在原点；`centered:true`（无 at 时）居中到原点；`at` 为中心
+ * 语义且优先于 `centered`。
+ */
+function cubeToCadSolid(kernel, params) {
+    const w = params.width;
+    const d = params.depth;
+    const h = params.height;
+    // brepjs box: center = at ?? (centered ? [0,0,0] : undefined)；未给 center →
+    // 构造角点实体不平移（这里统一中心构造 + 平移量，等价）。
+    const center = params.at !== undefined
+        ? params.at
+        : params.centered
+            ? [0, 0, 0]
+            : [w / 2, d / 2, h / 2];
+    const solid = kernel.makeBoxFromCorners({ x: -w / 2, y: -d / 2, z: -h / 2 }, { x: w / 2, y: d / 2, z: h / 2 });
+    return applyCenter(kernel, solid, center);
+}
+/**
+ * 用 OCCT 直接构造一个球体 Solid。
+ *
+ * 接收完整 SphereParams：radius 是球体半径，segments 不影响 BREP（仅影响 mesh 离散化）。
+ */
+function sphereToCadSolid(kernel, params) {
+    const solid = kernel.makeSphere(params.radius);
+    return applyCenter(kernel, solid, params.center);
+}
+/**
+ * 用 OCCT 直接构造一个圆柱体 Solid（brepjs `cylinder(radius, height, {
+ * at, centered })` 契约，§4.3 A 决策；与 mesh 路径逐点对齐）。
+ *
+ * 锚点同 vendored `primitiveFns.cylinder`：`at` 是底面轴心（BASE）语义（默认
+ * [0,0,0]），OCCT makeCylinder 原生从 z=0 沿 +Z 建高 → 无需重居中；`centered:true`
+ * 指底面沿轴下移 −h/2（无 at 时居中到原点；与 `at` 同给时以 `at` 为中心）。
+ */
+function cylinderToCadSolid(kernel, params) {
+    const solid = kernel.makeCylinder(params.radius, params.height);
+    const baseX = params.at?.[0] ?? 0;
+    const baseY = params.at?.[1] ?? 0;
+    const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0);
+    if (baseX !== 0 || baseY !== 0 || baseZ !== 0) {
+        const translated = kernel.translate(solid, baseX, baseY, baseZ);
+        kernel.release(solid);
+        return translated;
+    }
+    return solid;
+}
+/**
+ * 用 OCCT 直接构造一个圆锥体 Solid（brepjs `cone(bottomRadius, topRadius,
+ * height, { at, centered })` 契约，§4.1 P 决策；与 mesh 路径逐点对齐）。
+ *
+ * 锚点同 vendored `primitiveFns.cone`：`at` 是底面轴心（BASE）语义（默认
+ * [0,0,0]），OCCT makeCone 原生从 z=0 沿 +Z 建高 → 无需重居中；`centered:true`
+ * 指底面沿轴下移 −h/2（无 at 时居中到原点；与 `at` 同给时以 `at` 为中心）。
+ */
+function coneToCadSolid(kernel, params) {
+    const solid = kernel.makeCone(params.radiusBottom, params.radiusTop, params.height);
+    const baseX = params.at?.[0] ?? 0;
+    const baseY = params.at?.[1] ?? 0;
+    const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0);
+    if (baseX !== 0 || baseY !== 0 || baseZ !== 0) {
+        const translated = kernel.translate(solid, baseX, baseY, baseZ);
+        kernel.release(solid);
+        return translated;
+    }
+    return solid;
+}
+/**
+ * 用 OCCT 从 2D 梯形轮廓拉伸构造楔形体 Solid。
+ *
+ * 支持全参数（width/height/angle/length），向后兼容旧式 { size: number }。
+ *
+ * 参数（来自 WedgePanel.buildWedgeGeometry）：
+ * - 底边宽度 width（沿 Y）
+ * - 高度 height（沿 Z）
+ * - 底边与斜边的夹角 angleDeg
+ * - 拉伸总长 length（沿 X，从 -length/2 到 +length/2）
+ *
+ * 构造步骤：
+ * 1. 在 YZ 平面创建梯形 wire（4 个顶点，4 条边）
+ * 2. 从 wire 创建 planar face
+ * 3. 沿 X 轴拉伸
+ * 4. 平移使 X 方向居中
+ */
+function wedgeToCadSolid(kernel, params) {
+    const width = params.width; // 底边长度（沿 Y）
+    const height = params.height; // 梯形高（沿 Z）
+    const angleDeg = params.angle; // 底边与斜边的夹角
+    const length = params.length; // 拉伸总长（沿 X）
+    const angleRad = (angleDeg * Math.PI) / 180;
+    const halfExtrude = length / 2;
+    const hw = width / 2;
+    // 上边半宽 = 底边半宽 - 高 / tan(角度)
+    const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad));
+    // 在 YZ 平面创建梯形 wire（X=0）。顶边塌缩（halfTopWidth≈0，斜坡已在宽度内到顶）
+    // 时退化为三角棱柱——不能再保留零长顶边（两个重合顶点会让 OCCT makeLineEdge
+    // 报 CONSTRUCTION_FAILED，即 P23 实测的 wedge 退化参数失败）。
+    const edges = [];
+    if (halfTopWidth > 1e-12) {
+        // 梯形：底边 (±hw,0) + 上边 (±halfTopWidth,height)
+        edges.push(kernel.makeLineEdge({ x: 0, y: -hw, z: 0 }, { x: 0, y: hw, z: 0 }), kernel.makeLineEdge({ x: 0, y: hw, z: 0 }, { x: 0, y: halfTopWidth, z: height }), kernel.makeLineEdge({ x: 0, y: halfTopWidth, z: height }, { x: 0, y: -halfTopWidth, z: height }), kernel.makeLineEdge({ x: 0, y: -halfTopWidth, z: height }, { x: 0, y: -hw, z: 0 }));
+    }
+    else {
+        // 三角棱柱：(−hw,0) → (hw,0) → (0,height)
+        edges.push(kernel.makeLineEdge({ x: 0, y: -hw, z: 0 }, { x: 0, y: hw, z: 0 }), kernel.makeLineEdge({ x: 0, y: hw, z: 0 }, { x: 0, y: 0, z: height }), kernel.makeLineEdge({ x: 0, y: 0, z: height }, { x: 0, y: -hw, z: 0 }));
+    }
+    const wire = kernel.makeWire(edges);
+    const face = kernel.makeFace(wire);
+    const extruded = kernel.extrude(face, 2 * halfExtrude, 0, 0);
+    // 平移使 X 方向居中
+    const centered = kernel.translate(extruded, -halfExtrude, 0, 0);
+    // 释放中间句柄
+    for (const e of edges)
+        kernel.release(e);
+    kernel.release(wire);
+    kernel.release(face);
+    kernel.release(extruded);
+    return applyCenter(kernel, centered, params.center);
+}
+/**
+ * 将旧的 size 数字转换为对应类型的完整 params（向后兼容）。
+ *
+ * - cube: { size: size }
+ * - wedge:   { width: size, height: size/2, angle: 60, length: 50 }
+ * - sphere:     { radius: size / 2 }
+ * - cylinder:   { radius: size / 2, height: size }
+ * - cone:       { radiusBottom: size / 2, radiusTop: 0, height: size }
+ */
+function sizeToParams(type, size) {
+    switch (type) {
+        case 'cube':
+        case 'box':
+            return { width: size, depth: size, height: size };
+        case 'sphere':
+            return { radius: size / 2 };
+        case 'cylinder':
+            return { radius: size / 2, height: size };
+        case 'cone':
+            return { radiusBottom: size / 2, radiusTop: 0, height: size };
+        case 'wedge':
+            return { width: size, height: size / 2, angle: 60, length: 50 };
+        default:
+            throw new Error(`sizeToParams does not support primitive type "${type}" (use geometry data)`);
+    }
+}
+/**
+ * Convert a project primitive to an OCCT CAD solid.
+ *
+ * - cube, sphere, cylinder, cone, wedge: constructed directly with OCCT (exact BREP)
+ * - screw, text: use the mesh reconstruction path (faceted BREP)
+ *
+ * @param kernel - the initialized OCCT kernel.
+ * @param type - the primitive type.
+ * @param params - a full parameter object (BoxParams etc.), or a size number (backwards-compatible, default 20mm).
+ * @returns the CAD solid plus path information.
+ */
+export function primitiveToBrepSolid(kernel, type, params) {
+    const fullParams = typeof params === 'number' || params === undefined
+        ? sizeToParams(type, params ?? 20)
+        : params;
+    switch (type) {
+        case 'cube':
+        case 'box':
+            return { solid: cubeToCadSolid(kernel, fullParams), path: 'primitive', type };
+        case 'sphere':
+            return { solid: sphereToCadSolid(kernel, fullParams), path: 'primitive', type };
+        case 'cylinder':
+            return { solid: cylinderToCadSolid(kernel, fullParams), path: 'primitive', type };
+        case 'cone':
+            return { solid: coneToCadSolid(kernel, fullParams), path: 'primitive', type };
+        case 'wedge':
+            return { solid: wedgeToCadSolid(kernel, fullParams), path: 'primitive', type };
+        case 'screw':
+        case 'text': {
+            // Mesh 重建路径：从 THREE.js 几何体提取网格数据
+            // 对于 screw/text，调用方应使用 geometryToBrepSolid
+            throw new Error(`${type} requires geometry data — use geometryToBrepSolid() instead`);
+        }
+        default:
+            throw new Error(`Unsupported primitive type: ${type}`);
+    }
+}
+/**
+ * Create a CAD solid from a THREE.BufferGeometry via the mesh reconstruction path.
+ *
+ * Suitable for complex shapes that cannot be constructed directly
+ * (screw, text, SVG extrusion, etc.).
+ *
+ * @param kernel - the initialized OCCT kernel.
+ * @param geo - the THREE.js BufferGeometry.
+ * @returns the CAD solid plus path information.
+ */
+export function geometryToBrepSolid(kernel, geo) {
+    const { positions, indices } = extractMeshData(geo);
+    const solid = reconstructSolidFromMesh(kernel, positions, indices);
+    return { solid, path: 'mesh', type: 'screw' };
+}
+/**
+ * Export a CAD solid as a BREP-format STEP string.
+ *
+ * OCCT's exportStep produces a standard ISO-10303-21 STEP file using
+ * ADVANCED_FACE with exact surfaces (PLANE, CYLINDRICAL_SURFACE, etc.)
+ * rather than a faceted representation (POLYGONAL_FACE).
+ *
+ * @param kernel - the initialized OCCT kernel.
+ * @param solid - the CAD solid handle.
+ * @returns the STEP file content as a string.
+ */
+export function brepSolidToStep(kernel, solid) {
+    return kernel.exportStep(solid);
+}
+/**
+ * Convenience method: convert a primitive directly to a STEP string.
+ *
+ * Internally calls primitiveToBrepSolid + brepSolidToStep and manages the
+ * handle lifecycle automatically.
+ *
+ * @param kernel - the initialized OCCT kernel.
+ * @param type - the primitive type.
+ * @param params - a full parameter object, or a size number (backwards-compatible, default 20mm).
+ * @returns the STEP file content string plus the path used.
+ */
+export function primitiveToBrepStep(kernel, type, params) {
+    const result = primitiveToBrepSolid(kernel, type, params);
+    try {
+        const step = brepSolidToStep(kernel, result.solid);
+        return { step, path: result.path };
+    }
+    finally {
+        kernel.release(result.solid);
+    }
+}
+//# sourceMappingURL=brep-primitives.js.map

package/dist/primitives/brep-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brep-primitives.js","sourceRoot":"","sources":["../../src/primitives/brep-primitives.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Primitive → CAD 实体转换。\n *\n * 将本项目的各种 primitive（cube, sphere, cylinder, cone, wedge, screw）\n * 转换为 OCCT CAD 实体（Solid），并支持导出为 BREP 格式的 STEP 文件。\n *\n * 两条路径：\n *\n * 1. **直接构造路径**（primitive path）：\n *    对于有 OCCT 直接对应的基本体（cube, sphere, cylinder, cone, wedge），\n *    直接调用 OCCT 构造函数（makeBox, makeSphere, makeCylinder, makeCone）\n *    或用 extrude 从 2D 轮廓构造（wedge）。\n *    产出精确 BREP——平面是 PLANE，圆柱面是 CYLINDRICAL_SURFACE，等。\n *\n * 2. **Mesh 重建路径**（mesh path）：\n *    对于无 OCCT 直接对应的复杂形状（screw, text），从 THREE.js BufferGeometry\n *    提取三角网格，经 meshReconstruct.ts 的多阶段愈合管线重建为 Solid。\n *    产出仍为 BREP，但曲面由多个小三角平面近似（faceted）。在本项目里，默认brep模型不包含此类近似的到的模型。\n *\n * 坐标系：本项目 primitive 为 Z-up（经过 ROT_Y_TO_Z 旋转），\n * OCCT 默认也是 Z-up，因此直接对应，无需额外轴转换。\n */\n\nimport type * as THREE from 'three'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport type { PrimitiveType } from './types'\nimport { reconstructSolidFromMesh } from '../occt-kernel/meshReconstruct'\nimport type {\n  BoxParams,\n  SphereParams,\n  CylinderParams,\n  ConeParams,\n  WedgeParams,\n} from '../mesh/types'\n\n// ─── 辅助：从 BufferGeometry 提取网格数据 ───\n\n/**\n * Extract positions + indices from a THREE.BufferGeometry for the mesh reconstruction path.\n *\n * Handles both indexed and non-indexed geometry.\n * Sequential indices are created automatically for non-indexed geometry.\n *\n * @param geo - the source THREE.BufferGeometry.\n * @returns the extracted positions and indices arrays.\n */\nexport function extractMeshData(geo: THREE.BufferGeometry): {\n  positions: Float32Array\n  indices: Uint32Array\n} {\n  const posAttr = geo.getAttribute('position') as THREE.BufferAttribute\n  if (!posAttr) throw new Error('Geometry has no position attribute')\n\n  const positions = new Float32Array(posAttr.array)\n\n  const idxAttr = geo.getIndex()\n  let indices: Uint32Array\n  if (idxAttr) {\n    indices = new Uint32Array(idxAttr.array)\n  } else {\n    // Non-indexed: create sequential indices\n    indices = new Uint32Array(posAttr.count)\n    for (let i = 0; i < posAttr.count; i++) indices[i] = i\n  }\n\n  return { positions, indices }\n}\n\n// ─── 直接构造路径 ───\n\n/** 应用 center 偏移到 OCCT solid（如果有 center 参数）。 */\nfunction applyCenter(kernel: BrepEngineApi, solid: BrepHandle, center?: [number, number, number]): BrepHandle {\n  if (!center) return solid\n  const translated = kernel.translate(solid, center[0], center[1], center[2])\n  kernel.release(solid)\n  return translated\n}\n\n/**\n * 用 OCCT 直接构造一个长方体 Solid（brepjs `box(width, depth, height,\n * {at?, centered?})` 契约，§4.1 A 决策；与 mesh 路径逐点对齐）。\n *\n * 几何语义与 vendored `primitiveFns.box` 完全一致：\n * 默认 min 角点在原点；`centered:true`（无 at 时）居中到原点；`at` 为中心\n * 语义且优先于 `centered`。\n */\nfunction cubeToCadSolid(kernel: BrepEngineApi, params: BoxParams): BrepHandle {\n  const w = params.width\n  const d = params.depth\n  const h = params.height\n  // brepjs box: center = at ?? (centered ? [0,0,0] : undefined)；未给 center →\n  // 构造角点实体不平移（这里统一中心构造 + 平移量，等价）。\n  const center = params.at !== undefined\n    ? params.at\n    : params.centered\n      ? ([0, 0, 0] as [number, number, number])\n      : ([w / 2, d / 2, h / 2] as [number, number, number])\n  const solid = kernel.makeBoxFromCorners(\n    { x: -w / 2, y: -d / 2, z: -h / 2 },\n    { x: w / 2, y: d / 2, z: h / 2 },\n  )\n  return applyCenter(kernel, solid, center)\n}\n\n/**\n * 用 OCCT 直接构造一个球体 Solid。\n *\n * 接收完整 SphereParams：radius 是球体半径，segments 不影响 BREP（仅影响 mesh 离散化）。\n */\nfunction sphereToCadSolid(kernel: BrepEngineApi, params: SphereParams): BrepHandle {\n  const solid = kernel.makeSphere(params.radius)\n  return applyCenter(kernel, solid, params.center)\n}\n\n/**\n * 用 OCCT 直接构造一个圆柱体 Solid（brepjs `cylinder(radius, height, {\n * at, centered })` 契约，§4.3 A 决策；与 mesh 路径逐点对齐）。\n *\n * 锚点同 vendored `primitiveFns.cylinder`：`at` 是底面轴心（BASE）语义（默认\n * [0,0,0]），OCCT makeCylinder 原生从 z=0 沿 +Z 建高 → 无需重居中；`centered:true`\n * 指底面沿轴下移 −h/2（无 at 时居中到原点；与 `at` 同给时以 `at` 为中心）。\n */\nfunction cylinderToCadSolid(kernel: BrepEngineApi, params: CylinderParams): BrepHandle {\n  const solid = kernel.makeCylinder(params.radius, params.height)\n  const baseX = params.at?.[0] ?? 0\n  const baseY = params.at?.[1] ?? 0\n  const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0)\n  if (baseX !== 0 || baseY !== 0 || baseZ !== 0) {\n    const translated = kernel.translate(solid, baseX, baseY, baseZ)\n    kernel.release(solid)\n    return translated\n  }\n  return solid\n}\n\n/**\n * 用 OCCT 直接构造一个圆锥体 Solid（brepjs `cone(bottomRadius, topRadius,\n * height, { at, centered })` 契约，§4.1 P 决策；与 mesh 路径逐点对齐）。\n *\n * 锚点同 vendored `primitiveFns.cone`：`at` 是底面轴心（BASE）语义（默认\n * [0,0,0]），OCCT makeCone 原生从 z=0 沿 +Z 建高 → 无需重居中；`centered:true`\n * 指底面沿轴下移 −h/2（无 at 时居中到原点；与 `at` 同给时以 `at` 为中心）。\n */\nfunction coneToCadSolid(kernel: BrepEngineApi, params: ConeParams): BrepHandle {\n  const solid = kernel.makeCone(params.radiusBottom, params.radiusTop, params.height)\n  const baseX = params.at?.[0] ?? 0\n  const baseY = params.at?.[1] ?? 0\n  const baseZ = (params.at?.[2] ?? 0) - (params.centered === true ? params.height / 2 : 0)\n  if (baseX !== 0 || baseY !== 0 || baseZ !== 0) {\n    const translated = kernel.translate(solid, baseX, baseY, baseZ)\n    kernel.release(solid)\n    return translated\n  }\n  return solid\n}\n\n/**\n * 用 OCCT 从 2D 梯形轮廓拉伸构造楔形体 Solid。\n *\n * 支持全参数（width/height/angle/length），向后兼容旧式 { size: number }。\n *\n * 参数（来自 WedgePanel.buildWedgeGeometry）：\n * - 底边宽度 width（沿 Y）\n * - 高度 height（沿 Z）\n * - 底边与斜边的夹角 angleDeg\n * - 拉伸总长 length（沿 X，从 -length/2 到 +length/2）\n *\n * 构造步骤：\n * 1. 在 YZ 平面创建梯形 wire（4 个顶点，4 条边）\n * 2. 从 wire 创建 planar face\n * 3. 沿 X 轴拉伸\n * 4. 平移使 X 方向居中\n */\nfunction wedgeToCadSolid(kernel: BrepEngineApi, params: WedgeParams): BrepHandle {\n  const width = params.width                    // 底边长度（沿 Y）\n  const height = params.height                  // 梯形高（沿 Z）\n  const angleDeg = params.angle                 // 底边与斜边的夹角\n  const length = params.length                  // 拉伸总长（沿 X）\n  const angleRad = (angleDeg * Math.PI) / 180\n  const halfExtrude = length / 2\n  const hw = width / 2\n\n  // 上边半宽 = 底边半宽 - 高 / tan(角度)\n  const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad))\n\n  // 在 YZ 平面创建梯形 wire（X=0）。顶边塌缩（halfTopWidth≈0，斜坡已在宽度内到顶）\n  // 时退化为三角棱柱——不能再保留零长顶边（两个重合顶点会让 OCCT makeLineEdge\n  // 报 CONSTRUCTION_FAILED，即 P23 实测的 wedge 退化参数失败）。\n  const edges: BrepHandle[] = []\n  if (halfTopWidth > 1e-12) {\n    // 梯形：底边 (±hw,0) + 上边 (±halfTopWidth,height)\n    edges.push(\n      kernel.makeLineEdge({ x: 0, y: -hw, z: 0 }, { x: 0, y: hw, z: 0 }),\n      kernel.makeLineEdge({ x: 0, y: hw, z: 0 }, { x: 0, y: halfTopWidth, z: height }),\n      kernel.makeLineEdge({ x: 0, y: halfTopWidth, z: height }, { x: 0, y: -halfTopWidth, z: height }),\n      kernel.makeLineEdge({ x: 0, y: -halfTopWidth, z: height }, { x: 0, y: -hw, z: 0 }),\n    )\n  } else {\n    // 三角棱柱：(−hw,0) → (hw,0) → (0,height)\n    edges.push(\n      kernel.makeLineEdge({ x: 0, y: -hw, z: 0 }, { x: 0, y: hw, z: 0 }),\n      kernel.makeLineEdge({ x: 0, y: hw, z: 0 }, { x: 0, y: 0, z: height }),\n      kernel.makeLineEdge({ x: 0, y: 0, z: height }, { x: 0, y: -hw, z: 0 }),\n    )\n  }\n\n  const wire = kernel.makeWire(edges)\n  const face = kernel.makeFace(wire)\n  const extruded = kernel.extrude(face, 2 * halfExtrude, 0, 0)\n  // 平移使 X 方向居中\n  const centered = kernel.translate(extruded, -halfExtrude, 0, 0)\n\n  // 释放中间句柄\n  for (const e of edges) kernel.release(e)\n  kernel.release(wire)\n  kernel.release(face)\n  kernel.release(extruded)\n\n  return applyCenter(kernel, centered, params.center)\n}\n\n// ─── 统一入口 ───\n\n/**\n * Conversion result: the CAD solid handle and the construction path used.\n */\nexport interface PrimitiveToBrepResult {\n  /** CAD solid handle (the caller is responsible for releasing it). */\n  solid: BrepHandle\n  /** The construction path used. */\n  path: 'primitive' | 'mesh'\n  /** The primitive type. */\n  type: PrimitiveType | 'screw' | 'text'\n}\n\n/** Union type of the primitive parameter objects. */\nexport type PrimitiveParams = BoxParams | SphereParams | CylinderParams | ConeParams | WedgeParams\n\n/**\n * 将旧的 size 数字转换为对应类型的完整 params（向后兼容）。\n *\n * - cube: { size: size }\n * - wedge:   { width: size, height: size/2, angle: 60, length: 50 }\n * - sphere:     { radius: size / 2 }\n * - cylinder:   { radius: size / 2, height: size }\n * - cone:       { radiusBottom: size / 2, radiusTop: 0, height: size }\n */\nfunction sizeToParams(type: PrimitiveType | 'screw' | 'text', size: number): PrimitiveParams {\n  switch (type) {\n    case 'cube':\n    case 'box':\n      return { width: size, depth: size, height: size }\n    case 'sphere':\n      return { radius: size / 2 }\n    case 'cylinder':\n      return { radius: size / 2, height: size }\n    case 'cone':\n      return { radiusBottom: size / 2, radiusTop: 0, height: size }\n    case 'wedge':\n      return { width: size, height: size / 2, angle: 60, length: 50 }\n    default:\n      throw new Error(`sizeToParams does not support primitive type \"${type}\" (use geometry data)`)\n  }\n}\n\n/**\n * Convert a project primitive to an OCCT CAD solid.\n *\n * - cube, sphere, cylinder, cone, wedge: constructed directly with OCCT (exact BREP)\n * - screw, text: use the mesh reconstruction path (faceted BREP)\n *\n * @param kernel - the initialized OCCT kernel.\n * @param type - the primitive type.\n * @param params - a full parameter object (BoxParams etc.), or a size number (backwards-compatible, default 20mm).\n * @returns the CAD solid plus path information.\n */\nexport function primitiveToBrepSolid(\n  kernel: BrepEngineApi,\n  type: PrimitiveType | 'screw' | 'text',\n  params?: PrimitiveParams | number,\n): PrimitiveToBrepResult {\n  const fullParams = typeof params === 'number' || params === undefined\n    ? sizeToParams(type, params ?? 20)\n    : params\n\n  switch (type) {\n    case 'cube':\n    case 'box':\n      return { solid: cubeToCadSolid(kernel, fullParams as BoxParams), path: 'primitive', type }\n\n    case 'sphere':\n      return { solid: sphereToCadSolid(kernel, fullParams as SphereParams), path: 'primitive', type }\n\n    case 'cylinder':\n      return { solid: cylinderToCadSolid(kernel, fullParams as CylinderParams), path: 'primitive', type }\n\n    case 'cone':\n      return { solid: coneToCadSolid(kernel, fullParams as ConeParams), path: 'primitive', type }\n\n    case 'wedge':\n      return { solid: wedgeToCadSolid(kernel, fullParams as WedgeParams), path: 'primitive', type }\n\n    case 'screw':\n    case 'text': {\n      // Mesh 重建路径：从 THREE.js 几何体提取网格数据\n      // 对于 screw/text，调用方应使用 geometryToBrepSolid\n      throw new Error(\n        `${type} requires geometry data — use geometryToBrepSolid() instead`,\n      )\n    }\n\n    default:\n      throw new Error(`Unsupported primitive type: ${type}`)\n  }\n}\n\n/**\n * Create a CAD solid from a THREE.BufferGeometry via the mesh reconstruction path.\n *\n * Suitable for complex shapes that cannot be constructed directly\n * (screw, text, SVG extrusion, etc.).\n *\n * @param kernel - the initialized OCCT kernel.\n * @param geo - the THREE.js BufferGeometry.\n * @returns the CAD solid plus path information.\n */\nexport function geometryToBrepSolid(\n  kernel: BrepEngineApi,\n  geo: THREE.BufferGeometry,\n): PrimitiveToBrepResult {\n  const { positions, indices } = extractMeshData(geo)\n  const solid = reconstructSolidFromMesh(kernel, positions, indices)\n  return { solid, path: 'mesh', type: 'screw' }\n}\n\n/**\n * Export a CAD solid as a BREP-format STEP string.\n *\n * OCCT's exportStep produces a standard ISO-10303-21 STEP file using\n * ADVANCED_FACE with exact surfaces (PLANE, CYLINDRICAL_SURFACE, etc.)\n * rather than a faceted representation (POLYGONAL_FACE).\n *\n * @param kernel - the initialized OCCT kernel.\n * @param solid - the CAD solid handle.\n * @returns the STEP file content as a string.\n */\nexport function brepSolidToStep(kernel: BrepEngineApi, solid: BrepHandle): string {\n  return kernel.exportStep(solid)\n}\n\n/**\n * Convenience method: convert a primitive directly to a STEP string.\n *\n * Internally calls primitiveToBrepSolid + brepSolidToStep and manages the\n * handle lifecycle automatically.\n *\n * @param kernel - the initialized OCCT kernel.\n * @param type - the primitive type.\n * @param params - a full parameter object, or a size number (backwards-compatible, default 20mm).\n * @returns the STEP file content string plus the path used.\n */\nexport function primitiveToBrepStep(\n  kernel: BrepEngineApi,\n  type: PrimitiveType,\n  params?: PrimitiveParams | number,\n): { step: string; path: 'primitive' | 'mesh' } {\n  const result = primitiveToBrepSolid(kernel, type, params)\n  try {\n    const step = brepSolidToStep(kernel, result.solid)\n    return { step, path: result.path }\n  } finally {\n    kernel.release(result.solid)\n  }\n}\n"]}

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

@@ -0,0 +1,38 @@
+import * as THREE from 'three';
+import type { PrimitiveType } from './types.js';
+/** Default size in mm used when no explicit size is given. */
+export declare const DEFAULT_SIZE = 20;
+/** Default angular/height segment count used by curved primitives. */
+export declare const DEFAULT_SEGMENTS = 32;
+/**
+ * Build the base geometry for a primitive type, centred on the origin.
+ *
+ * Returns a BufferGeometry in Z-up coordinates. Cube/sphere/cylinder/cone
+ * geometry is rotated from Y-up to Z-up; the wedge is constructed directly
+ * in Z-up.
+ *
+ * @param type - the primitive type to build.
+ * @param size - nominal size in mm (defaults to DEFAULT_SIZE).
+ * @param segments - angular/height resolution for curved primitives (defaults to DEFAULT_SEGMENTS).
+ * @returns the primitive BufferGeometry.
+ */
+export declare function makePrimitiveGeo(type: PrimitiveType, size?: number, segments?: number): THREE.BufferGeometry;
+/**
+ * Translate geometry to the given world coordinates.
+ * The geometry should already be centred on the origin (makePrimitiveGeo /
+ * makeScrew / createTextGeometry all produce centred geometry).
+ *
+ * @param geo - the geometry to translate.
+ * @param x - the X offset in mm.
+ * @param y - the Y offset in mm.
+ */
+export declare function applyPrimitiveOffset(geo: THREE.BufferGeometry, x: number, y: number): void;
+/**
+ * Merge multiple BufferGeometries into a single indexed geometry.
+ * Automatically handles a mix of indexed and non-indexed inputs.
+ *
+ * @param geometries - the geometries to merge.
+ * @returns a new BufferGeometry containing the combined vertices and triangles.
+ */
+export declare function mergeBufferGeometries(geometries: THREE.BufferGeometry[]): THREE.BufferGeometry;
+//# sourceMappingURL=mesh-primitives.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-primitives.d.ts","sourceRoot":"","sources":["../../src/primitives/mesh-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,8DAA8D;AAC9D,eAAO,MAAM,YAAY,KAAK,CAAA;AAC9B,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAKlC;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,MAAM,GAChB,KAAK,CAAC,cAAc,CAyEtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,KAAK,CAAC,cAAc,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC,cAAc,EAAE,GAAG,KAAK,CAAC,cAAc,CAqD9F"}

package/dist/primitives/mesh-primitives.js

@@ -0,0 +1,160 @@
+import * as THREE from 'three';
+/** Default size in mm used when no explicit size is given. */
+export const DEFAULT_SIZE = 20;
+/** Default angular/height segment count used by curved primitives. */
+export const DEFAULT_SEGMENTS = 32;
+/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */
+const ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2);
+/**
+ * Build the base geometry for a primitive type, centred on the origin.
+ *
+ * Returns a BufferGeometry in Z-up coordinates. Cube/sphere/cylinder/cone
+ * geometry is rotated from Y-up to Z-up; the wedge is constructed directly
+ * in Z-up.
+ *
+ * @param type - the primitive type to build.
+ * @param size - nominal size in mm (defaults to DEFAULT_SIZE).
+ * @param segments - angular/height resolution for curved primitives (defaults to DEFAULT_SEGMENTS).
+ * @returns the primitive BufferGeometry.
+ */
+export function makePrimitiveGeo(type, size, segments) {
+    const s = size ?? DEFAULT_SIZE;
+    const segs = segments ?? DEFAULT_SEGMENTS;
+    let geo;
+    switch (type) {
+        case 'cube':
+        case 'box':
+            geo = new THREE.BoxGeometry(s, s, s);
+            geo.applyMatrix4(ROT_Y_TO_Z);
+            break;
+        case 'sphere':
+            geo = new THREE.SphereGeometry(s / 2, segs, segs);
+            geo.applyMatrix4(ROT_Y_TO_Z);
+            break;
+        case 'cylinder':
+            geo = new THREE.CylinderGeometry(s / 2, s / 2, s, segs);
+            geo.applyMatrix4(ROT_Y_TO_Z);
+            break;
+        case 'cone':
+            geo = new THREE.ConeGeometry(s / 2, s, segs);
+            geo.applyMatrix4(ROT_Y_TO_Z);
+            break;
+        case 'wedge': {
+            // 楔形体：梯形棱柱，直接在 Z-up 中构建
+            // 梯形在 YZ 平面（Y=宽度方向，Z=高度方向），拉升沿 X 轴
+            const width = s; // 底边长度（沿 Y）
+            const height = s / 2; // 梯形高（沿 Z，默认 10mm）
+            const angleDeg = 60; // 底边与斜边的夹角
+            const angleRad = (angleDeg * Math.PI) / 180;
+            const halfExtrude = 25; // 拉升总长 50mm（沿 X）
+            const hw = width / 2;
+            // 上边半宽 = 底边半宽 - 高 / tan(角度)，钳制到 >= 0
+            const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad));
+            const positions = new Float32Array([
+                // 前端面 (X = -halfExtrude)
+                -halfExtrude, -hw, 0, // p0: bottomLeft
+                -halfExtrude, hw, 0, // p1: bottomRight
+                -halfExtrude, halfTopWidth, height, // p2: topRight
+                -halfExtrude, -halfTopWidth, height, // p3: topLeft
+                // 后端面 (X = +halfExtrude)
+                halfExtrude, -hw, 0, // p4: bottomLeft
+                halfExtrude, hw, 0, // p5: bottomRight
+                halfExtrude, halfTopWidth, height, // p6: topRight
+                halfExtrude, -halfTopWidth, height, // p7: topLeft
+            ]);
+            const indices = new Uint32Array([
+                // 前端面 (outward = -X, counterclockwise from outside)
+                0, 2, 1, 0, 3, 2,
+                // 后端面 (outward = +X, counterclockwise from outside)
+                4, 5, 6, 4, 6, 7,
+                // 底面 (outward = -Z)
+                0, 5, 4, 0, 1, 5,
+                // 顶面 (outward = +Z)
+                3, 6, 2, 3, 7, 6,
+                // 左侧面 (outward = -Y)
+                0, 7, 3, 0, 4, 7,
+                // 右侧面 (outward = +Y)
+                1, 6, 5, 1, 2, 6,
+            ]);
+            geo = new THREE.BufferGeometry();
+            geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+            geo.setIndex(new THREE.BufferAttribute(indices, 1));
+            // 楔形体直接在 Z-up 中构建，无需 ROT_Y_TO_Z
+            break;
+        }
+    }
+    return geo;
+}
+/**
+ * Translate geometry to the given world coordinates.
+ * The geometry should already be centred on the origin (makePrimitiveGeo /
+ * makeScrew / createTextGeometry all produce centred geometry).
+ *
+ * @param geo - the geometry to translate.
+ * @param x - the X offset in mm.
+ * @param y - the Y offset in mm.
+ */
+export function applyPrimitiveOffset(geo, x, y) {
+    if (x === 0 && y === 0)
+        return;
+    geo.translate(x, y, 0);
+}
+/**
+ * Merge multiple BufferGeometries into a single indexed geometry.
+ * Automatically handles a mix of indexed and non-indexed inputs.
+ *
+ * @param geometries - the geometries to merge.
+ * @returns a new BufferGeometry containing the combined vertices and triangles.
+ */
+export function mergeBufferGeometries(geometries) {
+    if (geometries.length === 1)
+        return geometries[0].clone();
+    const merged = new THREE.BufferGeometry();
+    // Collect all position arrays
+    const allPositions = [];
+    const allIndices = [];
+    let vertexOffset = 0;
+    for (const geo of geometries) {
+        const pos = geo.getAttribute('position');
+        if (!pos)
+            continue;
+        allPositions.push(new Float32Array(pos.array));
+        const idx = geo.index;
+        if (idx) {
+            const shifted = new Uint32Array(idx.array.length);
+            for (let i = 0; i < idx.count; i++) {
+                shifted[i] = idx.array[i] + vertexOffset;
+            }
+            allIndices.push(shifted);
+        }
+        else {
+            // Non-indexed geometry: create sequential indices
+            const count = pos.count;
+            const indices = new Uint32Array(count);
+            for (let i = 0; i < count; i++)
+                indices[i] = i + vertexOffset;
+            allIndices.push(indices);
+        }
+        vertexOffset += pos.count;
+    }
+    // Concatenate positions
+    const totalPosLen = allPositions.reduce((s, a) => s + a.length, 0);
+    const mergedPos = new Float32Array(totalPosLen);
+    let posOffset = 0;
+    for (const arr of allPositions) {
+        mergedPos.set(arr, posOffset);
+        posOffset += arr.length;
+    }
+    merged.setAttribute('position', new THREE.BufferAttribute(mergedPos, 3));
+    // Concatenate indices
+    const totalIdxLen = allIndices.reduce((s, a) => s + a.length, 0);
+    const mergedIdx = new Uint32Array(totalIdxLen);
+    let idxOffset = 0;
+    for (const arr of allIndices) {
+        mergedIdx.set(arr, idxOffset);
+        idxOffset += arr.length;
+    }
+    merged.setIndex(new THREE.BufferAttribute(mergedIdx, 1));
+    return merged;
+}
+//# sourceMappingURL=mesh-primitives.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-primitives.js","sourceRoot":"","sources":["../../src/primitives/mesh-primitives.ts"],"names":[],"mappings":"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","sourcesContent":["import * as THREE from 'three'\nimport type { PrimitiveType } from './types'\n\n/** Default size in mm used when no explicit size is given. */\nexport const DEFAULT_SIZE = 20\n/** Default angular/height segment count used by curved primitives. */\nexport const DEFAULT_SEGMENTS = 32\n\n/** Rotation matrix: +90° around X — converts Y-up vertex data to Z-up. */\nconst ROT_Y_TO_Z = new THREE.Matrix4().makeRotationX(Math.PI / 2)\n\n/**\n * Build the base geometry for a primitive type, centred on the origin.\n *\n * Returns a BufferGeometry in Z-up coordinates. Cube/sphere/cylinder/cone\n * geometry is rotated from Y-up to Z-up; the wedge is constructed directly\n * in Z-up.\n *\n * @param type - the primitive type to build.\n * @param size - nominal size in mm (defaults to DEFAULT_SIZE).\n * @param segments - angular/height resolution for curved primitives (defaults to DEFAULT_SEGMENTS).\n * @returns the primitive BufferGeometry.\n */\nexport function makePrimitiveGeo(\n  type: PrimitiveType,\n  size?: number,\n  segments?: number,\n): THREE.BufferGeometry {\n  const s = size ?? DEFAULT_SIZE\n  const segs = segments ?? DEFAULT_SEGMENTS\n\n  let geo: THREE.BufferGeometry\n  switch (type) {\n    case 'cube':\n    case 'box':\n      geo = new THREE.BoxGeometry(s, s, s)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'sphere':\n      geo = new THREE.SphereGeometry(s / 2, segs, segs)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'cylinder':\n      geo = new THREE.CylinderGeometry(s / 2, s / 2, s, segs)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'cone':\n      geo = new THREE.ConeGeometry(s / 2, s, segs)\n      geo.applyMatrix4(ROT_Y_TO_Z)\n      break\n    case 'wedge': {\n      // 楔形体：梯形棱柱，直接在 Z-up 中构建\n      // 梯形在 YZ 平面（Y=宽度方向，Z=高度方向），拉升沿 X 轴\n      const width = s                     // 底边长度（沿 Y）\n      const height = s / 2                // 梯形高（沿 Z，默认 10mm）\n      const angleDeg = 60                 // 底边与斜边的夹角\n      const angleRad = (angleDeg * Math.PI) / 180\n      const halfExtrude = 25              // 拉升总长 50mm（沿 X）\n      const hw = width / 2\n\n      // 上边半宽 = 底边半宽 - 高 / tan(角度)，钳制到 >= 0\n      const halfTopWidth = Math.max(0, hw - height / Math.tan(angleRad))\n\n      const positions = new Float32Array([\n        // 前端面 (X = -halfExtrude)\n        -halfExtrude, -hw, 0,                  // p0: bottomLeft\n        -halfExtrude,  hw, 0,                  // p1: bottomRight\n        -halfExtrude,  halfTopWidth, height,    // p2: topRight\n        -halfExtrude, -halfTopWidth, height,    // p3: topLeft\n        // 后端面 (X = +halfExtrude)\n         halfExtrude, -hw, 0,                  // p4: bottomLeft\n         halfExtrude,  hw, 0,                  // p5: bottomRight\n         halfExtrude,  halfTopWidth, height,    // p6: topRight\n         halfExtrude, -halfTopWidth, height,    // p7: topLeft\n      ])\n\n      const indices = new Uint32Array([\n        // 前端面 (outward = -X, counterclockwise from outside)\n        0, 2, 1,  0, 3, 2,\n        // 后端面 (outward = +X, counterclockwise from outside)\n        4, 5, 6,  4, 6, 7,\n        // 底面 (outward = -Z)\n        0, 5, 4,  0, 1, 5,\n        // 顶面 (outward = +Z)\n        3, 6, 2,  3, 7, 6,\n        // 左侧面 (outward = -Y)\n        0, 7, 3,  0, 4, 7,\n        // 右侧面 (outward = +Y)\n        1, 6, 5,  1, 2, 6,\n      ])\n\n      geo = new THREE.BufferGeometry()\n      geo.setAttribute('position', new THREE.BufferAttribute(positions, 3))\n      geo.setIndex(new THREE.BufferAttribute(indices, 1))\n      // 楔形体直接在 Z-up 中构建，无需 ROT_Y_TO_Z\n      break\n    }\n  }\n\n  return geo\n}\n\n/**\n * Translate geometry to the given world coordinates.\n * The geometry should already be centred on the origin (makePrimitiveGeo /\n * makeScrew / createTextGeometry all produce centred geometry).\n *\n * @param geo - the geometry to translate.\n * @param x - the X offset in mm.\n * @param y - the Y offset in mm.\n */\nexport function applyPrimitiveOffset(\n  geo: THREE.BufferGeometry,\n  x: number,\n  y: number,\n): void {\n  if (x === 0 && y === 0) return\n  geo.translate(x, y, 0)\n}\n\n/**\n * Merge multiple BufferGeometries into a single indexed geometry.\n * Automatically handles a mix of indexed and non-indexed inputs.\n *\n * @param geometries - the geometries to merge.\n * @returns a new BufferGeometry containing the combined vertices and triangles.\n */\nexport function mergeBufferGeometries(geometries: THREE.BufferGeometry[]): THREE.BufferGeometry {\n  if (geometries.length === 1) return geometries[0].clone()\n\n  const merged = new THREE.BufferGeometry()\n\n  // Collect all position arrays\n  const allPositions: Float32Array[] = []\n  const allIndices: Uint32Array[] = []\n  let vertexOffset = 0\n\n  for (const geo of geometries) {\n    const pos = geo.getAttribute('position') as THREE.BufferAttribute\n    if (!pos) continue\n\n    allPositions.push(new Float32Array(pos.array))\n    const idx = geo.index\n    if (idx) {\n      const shifted = new Uint32Array(idx.array.length)\n      for (let i = 0; i < idx.count; i++) {\n        shifted[i] = (idx.array as Uint32Array | Uint16Array)[i] + vertexOffset\n      }\n      allIndices.push(shifted)\n    } else {\n      // Non-indexed geometry: create sequential indices\n      const count = pos.count\n      const indices = new Uint32Array(count)\n      for (let i = 0; i < count; i++) indices[i] = i + vertexOffset\n      allIndices.push(indices)\n    }\n    vertexOffset += pos.count\n  }\n\n  // Concatenate positions\n  const totalPosLen = allPositions.reduce((s, a) => s + a.length, 0)\n  const mergedPos = new Float32Array(totalPosLen)\n  let posOffset = 0\n  for (const arr of allPositions) {\n    mergedPos.set(arr, posOffset)\n    posOffset += arr.length\n  }\n  merged.setAttribute('position', new THREE.BufferAttribute(mergedPos, 3))\n\n  // Concatenate indices\n  const totalIdxLen = allIndices.reduce((s, a) => s + a.length, 0)\n  const mergedIdx = new Uint32Array(totalIdxLen)\n  let idxOffset = 0\n  for (const arr of allIndices) {\n    mergedIdx.set(arr, idxOffset)\n    idxOffset += arr.length\n  }\n  merged.setIndex(new THREE.BufferAttribute(mergedIdx, 1))\n\n  return merged\n}\n"]}

package/dist/primitives/parse-svg-size.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Parse the natural size of an SVG (single source of truth).
+ *
+ * Both the BREP path (svg-to-solid.svgToSolid) and the mesh path
+ * (svgToExtrudedGeometry) share this function so the same SVG scales
+ * identically on both paths.
+ *
+ * viewBox takes priority, falling back to width/height; if neither exists,
+ * returns 0 (no scaling).
+ *
+ * @param svgString - the SVG source text.
+ * @returns the natural width and height of the SVG.
+ */
+export declare function parseSvgNaturalSize(svgString: string): {
+    naturalWidth: number;
+    naturalHeight: number;
+};
+//# sourceMappingURL=parse-svg-size.d.ts.map

package/dist/primitives/parse-svg-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-svg-size.d.ts","sourceRoot":"","sources":["../../src/primitives/parse-svg-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAgBtG"}

package/dist/primitives/parse-svg-size.js

@@ -0,0 +1,31 @@
+/**
+ * Parse the natural size of an SVG (single source of truth).
+ *
+ * Both the BREP path (svg-to-solid.svgToSolid) and the mesh path
+ * (svgToExtrudedGeometry) share this function so the same SVG scales
+ * identically on both paths.
+ *
+ * viewBox takes priority, falling back to width/height; if neither exists,
+ * returns 0 (no scaling).
+ *
+ * @param svgString - the SVG source text.
+ * @returns the natural width and height of the SVG.
+ */
+export function parseSvgNaturalSize(svgString) {
+    // viewBox 优先
+    const vbMatch = svgString.match(/viewBox=["']([^"']+)["']/i);
+    if (vbMatch) {
+        const parts = vbMatch[1].split(/[\s,]+/).map(Number);
+        if (parts.length === 4 && parts[2] > 0 && parts[3] > 0) {
+            return { naturalWidth: parts[2], naturalHeight: parts[3] };
+        }
+    }
+    // 回退到 width/height
+    const wMatch = svgString.match(/<svg[^>]*\swidth=["'](\d+(?:\.\d+)?)["']/i);
+    const hMatch = svgString.match(/<svg[^>]*\sheight=["'](\d+(?:\.\d+)?)["']/i);
+    if (wMatch && hMatch) {
+        return { naturalWidth: parseFloat(wMatch[1]), naturalHeight: parseFloat(hMatch[1]) };
+    }
+    return { naturalWidth: 0, naturalHeight: 0 };
+}
+//# sourceMappingURL=parse-svg-size.js.map

package/dist/primitives/parse-svg-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-svg-size.js","sourceRoot":"","sources":["../../src/primitives/parse-svg-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,aAAa;IACb,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC5D,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QACpD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAA;QAC5D,CAAC;IACH,CAAC;IACD,mBAAmB;IACnB,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAA;IAC3E,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC5E,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACtF,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAA;AAC9C,CAAC","sourcesContent":["/**\n * Parse the natural size of an SVG (single source of truth).\n *\n * Both the BREP path (svg-to-solid.svgToSolid) and the mesh path\n * (svgToExtrudedGeometry) share this function so the same SVG scales\n * identically on both paths.\n *\n * viewBox takes priority, falling back to width/height; if neither exists,\n * returns 0 (no scaling).\n *\n * @param svgString - the SVG source text.\n * @returns the natural width and height of the SVG.\n */\n\nexport function parseSvgNaturalSize(svgString: string): { naturalWidth: number; naturalHeight: number } {\n  // viewBox 优先\n  const vbMatch = svgString.match(/viewBox=[\"']([^\"']+)[\"']/i)\n  if (vbMatch) {\n    const parts = vbMatch[1].split(/[\\s,]+/).map(Number)\n    if (parts.length === 4 && parts[2] > 0 && parts[3] > 0) {\n      return { naturalWidth: parts[2], naturalHeight: parts[3] }\n    }\n  }\n  // 回退到 width/height\n  const wMatch = svgString.match(/<svg[^>]*\\swidth=[\"'](\\d+(?:\\.\\d+)?)[\"']/i)\n  const hMatch = svgString.match(/<svg[^>]*\\sheight=[\"'](\\d+(?:\\.\\d+)?)[\"']/i)\n  if (wMatch && hMatch) {\n    return { naturalWidth: parseFloat(wMatch[1]), naturalHeight: parseFloat(hMatch[1]) }\n  }\n  return { naturalWidth: 0, naturalHeight: 0 }\n}\n"]}