@faicad/faijs 0.13.0

package/dist/occt-kernel/meshReconstruct.js

@@ -0,0 +1,196 @@
+/**
+ * Mesh → CAD 实体重建管线。
+ *
+ * 移植自 SketchForge-3D 项目的 `cadModifier.worker.ts` 中的 mesh 路径
+ * (ported from SketchForge-3D cadModifier.worker.ts).
+ *
+ * 核心流程：
+ * 1. 三角网格 → ASCII STL 文本 → OCCT importStl
+ * 2. 首次修复 fixShape
+ * 3. 若 isSolid → 直接愈合管线（healSolid + fixFaceOrientations + removeDegenerateEdges + unifySameDomain）
+ * 4. 若失败 → 面缝合管线（多容差 sewAndSolidify 循环）
+ *
+ * 与 occtWasmKernel.ts 中已有的 meshesToStep() 相比，此管线更健壮：
+ * - 使用 importStl（而非逐三角形 buildTriFace）
+ * - 多阶段愈合（fixShape → healSolid → fixFaceOrientations → removeDegenerateEdges → unifySameDomain）
+ * - 多容差面缝合回退（1e-5 → 1e-4 → 1e-3 → 1e-2）
+ * - isValid 验证
+ */
+// ─── 验证 ───
+/**
+ * Validate whether an OCCT shape is a legal topology.
+ * Calls kernel.isValid() to check: solid closedness, each edge belongs to exactly
+ * two faces, consistent face orientation, etc.
+ *
+ * @param kernel - the initialized OCCT kernel
+ * @param shape - the shape to validate
+ * @returns true when the shape is valid, false otherwise
+ */
+export function cadShapeIsValid(kernel, shape) {
+    try {
+        return kernel.isValid(shape);
+    }
+    catch {
+        return false;
+    }
+}
+// ─── STL 序列化 ───
+/**
+ * Serialize triangle mesh data as ASCII STL text.
+ *
+ * OCCT's importStl accepts a string input, so ASCII STL can be built directly
+ * without any File/Blob dependency.
+ *
+ * Each triangle emits a facet block containing a normal and three vertex
+ * coordinates. The normal is computed via cross product and normalized (OCCT
+ * recomputes normals after import; this is only temporary).
+ *
+ * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]
+ * @param indices - triangle index array [i0,i1,i2, i3,i4,i5, ...]
+ * @returns the ASCII STL text
+ */
+export function meshToAsciiStl(positions, indices) {
+    if (!positions || positions.length === 0 || !indices || indices.length === 0) {
+        throw new Error('The selected object has no mesh data');
+    }
+    const lines = ['solid mesh_reconstruct'];
+    for (let offset = 0; offset + 2 < indices.length; offset += 3) {
+        const ai = indices[offset] * 3;
+        const bi = indices[offset + 1] * 3;
+        const ci = indices[offset + 2] * 3;
+        const ax = positions[ai], ay = positions[ai + 1], az = positions[ai + 2];
+        const bx = positions[bi], by = positions[bi + 1], bz = positions[bi + 2];
+        const cx = positions[ci], cy = positions[ci + 1], cz = positions[ci + 2];
+        // 叉积计算面法线
+        const abx = bx - ax, aby = by - ay, abz = bz - az;
+        const acx = cx - ax, acy = cy - ay, acz = cz - az;
+        let nx = aby * acz - abz * acy;
+        let ny = abz * acx - abx * acz;
+        let nz = abx * acy - aby * acx;
+        const length = Math.hypot(nx, ny, nz) || 1;
+        nx /= length;
+        ny /= length;
+        nz /= length;
+        lines.push(`facet normal ${nx} ${ny} ${nz}`, ' outer loop', `  vertex ${ax} ${ay} ${az}`, `  vertex ${bx} ${by} ${bz}`, `  vertex ${cx} ${cy} ${cz}`, ' endloop', 'endfacet');
+    }
+    lines.push('endsolid mesh_reconstruct');
+    return lines.join('\n');
+}
+// ─── 重建管线 ───
+/**
+ * Rebuild a CAD solid from a triangle mesh.
+ *
+ * Full flow:
+ * 1. mesh → ASCII STL → OCCT importStl
+ * 2. fixShape base repair
+ * 3. if isSolid → direct healing pipeline
+ * 4. on failure → multi-tolerance face-sewing pipeline
+ *
+ * @param kernel - the initialized OCCT kernel
+ * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]
+ * @param indices - triangle index array [i0,j0,k0, i1,j1,k1, ...]
+ * @returns the reconstructed solid shape handle (caller is responsible for releasing)
+ * @throws if the mesh is open or non-manifold
+ */
+export function reconstructSolidFromMesh(kernel, positions, indices) {
+    // 步骤①: 三角网格 → ASCII STL → OCCT 导入
+    const stlText = meshToAsciiStl(positions, indices);
+    const imported = kernel.importStl(stlText);
+    // 步骤②: 首次修复
+    let shape = kernel.fixShape(imported);
+    // 步骤③: 若已是 Solid → 直接愈合管线
+    if (kernel.isSolid(shape)) {
+        try {
+            shape = kernel.healSolid(shape, 1e-4);
+            shape = kernel.fixFaceOrientations(shape);
+            shape = kernel.removeDegenerateEdges(shape);
+            shape = kernel.unifySameDomain(shape);
+        }
+        catch {
+            // 愈合失败 → 降级到面缝合
+        }
+        if (kernel.isSolid(shape) && cadShapeIsValid(kernel, shape)) {
+            kernel.release(imported);
+            return shape;
+        }
+    }
+    // 步骤④: 面缝合管线（多容差尝试）
+    const faces = kernel.getSubShapes(imported, 'face');
+    if (faces.length === 0) {
+        kernel.release(imported);
+        try {
+            kernel.release(shape);
+        }
+        catch { /* 已释放 */ }
+        throw new Error('The selected object has no closed faces');
+    }
+    try {
+        for (const tolerance of [1e-5, 1e-4, 1e-3, 1e-2]) {
+            try {
+                let candidate = kernel.sewAndSolidify(faces, tolerance);
+                candidate = kernel.fixShape(candidate);
+                if (kernel.isSolid(candidate))
+                    candidate = kernel.healSolid(candidate, tolerance);
+                candidate = kernel.fixFaceOrientations(candidate);
+                candidate = kernel.removeDegenerateEdges(candidate);
+                candidate = kernel.unifySameDomain(candidate);
+                if (kernel.isSolid(candidate) && cadShapeIsValid(kernel, candidate)) {
+                    kernel.release(imported);
+                    try {
+                        kernel.release(shape);
+                    }
+                    catch { /* 已释放 */ }
+                    return candidate;
+                }
+                // 未通过，释放候选
+                try {
+                    kernel.release(candidate);
+                }
+                catch { /* ignore */ }
+            }
+            catch {
+                // 尝试下一个更大的容差
+            }
+        }
+    }
+    finally {
+        // getSubShapes 返回的每个面都是独立 arena 句柄，缝合完成后批量释放——
+        // 否则每次 mesh→brep 重建泄漏 faceCount 个存活句柄（与 compat e2e ⑦
+        // 同类泄漏，getSubShapes 复制产物未回收）。
+        for (const f of faces) {
+            try {
+                kernel.release(f);
+            }
+            catch { /* 已释放 */ }
+        }
+    }
+    kernel.release(imported);
+    try {
+        kernel.release(shape);
+    }
+    catch { /* 已释放 */ }
+    throw new Error('The selected mesh is open or non-manifold. Repair it before converting to CAD.');
+}
+// ─── 便捷导出 ───
+/**
+ * Rebuild a CAD solid from a triangle mesh and export it as a STEP string.
+ *
+ * Internally calls reconstructSolidFromMesh, then exportStep.
+ * The returned STEP uses a BREP representation (ADVANCED_FACE + exact surfaces)
+ * rather than a faceted representation (POLYGONAL_FACE).
+ *
+ * @param kernel - the initialized OCCT kernel
+ * @param positions - vertex array
+ * @param indices - triangle index array
+ * @returns the STEP file content string
+ */
+export function meshToStepBrep(kernel, positions, indices) {
+    const solid = reconstructSolidFromMesh(kernel, positions, indices);
+    try {
+        return kernel.exportStep(solid);
+    }
+    finally {
+        kernel.release(solid);
+    }
+}
+//# sourceMappingURL=meshReconstruct.js.map

package/dist/occt-kernel/meshReconstruct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meshReconstruct.js","sourceRoot":"","sources":["../../src/occt-kernel/meshReconstruct.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Mesh → CAD 实体重建管线。\n *\n * 移植自 SketchForge-3D 项目的 `cadModifier.worker.ts` 中的 mesh 路径\n * (ported from SketchForge-3D cadModifier.worker.ts).\n *\n * 核心流程：\n * 1. 三角网格 → ASCII STL 文本 → OCCT importStl\n * 2. 首次修复 fixShape\n * 3. 若 isSolid → 直接愈合管线（healSolid + fixFaceOrientations + removeDegenerateEdges + unifySameDomain）\n * 4. 若失败 → 面缝合管线（多容差 sewAndSolidify 循环）\n *\n * 与 occtWasmKernel.ts 中已有的 meshesToStep() 相比，此管线更健壮：\n * - 使用 importStl（而非逐三角形 buildTriFace）\n * - 多阶段愈合（fixShape → healSolid → fixFaceOrientations → removeDegenerateEdges → unifySameDomain）\n * - 多容差面缝合回退（1e-5 → 1e-4 → 1e-3 → 1e-2）\n * - isValid 验证\n */\n\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\n\n// ─── 验证 ───\n\n/**\n * Validate whether an OCCT shape is a legal topology.\n * Calls kernel.isValid() to check: solid closedness, each edge belongs to exactly\n * two faces, consistent face orientation, etc.\n *\n * @param kernel - the initialized OCCT kernel\n * @param shape - the shape to validate\n * @returns true when the shape is valid, false otherwise\n */\nexport function cadShapeIsValid(kernel: BrepEngineApi, shape: BrepHandle): boolean {\n  try {\n    return kernel.isValid(shape)\n  } catch {\n    return false\n  }\n}\n\n// ─── STL 序列化 ───\n\n/**\n * Serialize triangle mesh data as ASCII STL text.\n *\n * OCCT's importStl accepts a string input, so ASCII STL can be built directly\n * without any File/Blob dependency.\n *\n * Each triangle emits a facet block containing a normal and three vertex\n * coordinates. The normal is computed via cross product and normalized (OCCT\n * recomputes normals after import; this is only temporary).\n *\n * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]\n * @param indices - triangle index array [i0,i1,i2, i3,i4,i5, ...]\n * @returns the ASCII STL text\n */\nexport function meshToAsciiStl(positions: Float32Array, indices: Uint32Array): string {\n  if (!positions || positions.length === 0 || !indices || indices.length === 0) {\n    throw new Error('The selected object has no mesh data')\n  }\n\n  const lines: string[] = ['solid mesh_reconstruct']\n\n  for (let offset = 0; offset + 2 < indices.length; offset += 3) {\n    const ai = indices[offset] * 3\n    const bi = indices[offset + 1] * 3\n    const ci = indices[offset + 2] * 3\n\n    const ax = positions[ai], ay = positions[ai + 1], az = positions[ai + 2]\n    const bx = positions[bi], by = positions[bi + 1], bz = positions[bi + 2]\n    const cx = positions[ci], cy = positions[ci + 1], cz = positions[ci + 2]\n\n    // 叉积计算面法线\n    const abx = bx - ax, aby = by - ay, abz = bz - az\n    const acx = cx - ax, acy = cy - ay, acz = cz - az\n    let nx = aby * acz - abz * acy\n    let ny = abz * acx - abx * acz\n    let nz = abx * acy - aby * acx\n    const length = Math.hypot(nx, ny, nz) || 1\n    nx /= length; ny /= length; nz /= length\n\n    lines.push(\n      `facet normal ${nx} ${ny} ${nz}`,\n      ' outer loop',\n      `  vertex ${ax} ${ay} ${az}`,\n      `  vertex ${bx} ${by} ${bz}`,\n      `  vertex ${cx} ${cy} ${cz}`,\n      ' endloop',\n      'endfacet',\n    )\n  }\n\n  lines.push('endsolid mesh_reconstruct')\n  return lines.join('\\n')\n}\n\n// ─── 重建管线 ───\n\n/**\n * Rebuild a CAD solid from a triangle mesh.\n *\n * Full flow:\n * 1. mesh → ASCII STL → OCCT importStl\n * 2. fixShape base repair\n * 3. if isSolid → direct healing pipeline\n * 4. on failure → multi-tolerance face-sewing pipeline\n *\n * @param kernel - the initialized OCCT kernel\n * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]\n * @param indices - triangle index array [i0,j0,k0, i1,j1,k1, ...]\n * @returns the reconstructed solid shape handle (caller is responsible for releasing)\n * @throws if the mesh is open or non-manifold\n */\nexport function reconstructSolidFromMesh(\n  kernel: BrepEngineApi,\n  positions: Float32Array,\n  indices: Uint32Array,\n): BrepHandle {\n  // 步骤①: 三角网格 → ASCII STL → OCCT 导入\n  const stlText = meshToAsciiStl(positions, indices)\n  const imported = kernel.importStl(stlText)\n\n  // 步骤②: 首次修复\n  let shape = kernel.fixShape(imported)\n\n  // 步骤③: 若已是 Solid → 直接愈合管线\n  if (kernel.isSolid(shape)) {\n    try {\n      shape = kernel.healSolid(shape, 1e-4)\n      shape = kernel.fixFaceOrientations(shape)\n      shape = kernel.removeDegenerateEdges(shape)\n      shape = kernel.unifySameDomain(shape)\n    } catch {\n      // 愈合失败 → 降级到面缝合\n    }\n    if (kernel.isSolid(shape) && cadShapeIsValid(kernel, shape)) {\n      kernel.release(imported)\n      return shape\n    }\n  }\n\n  // 步骤④: 面缝合管线（多容差尝试）\n  const faces = kernel.getSubShapes(imported, 'face')\n  if (faces.length === 0) {\n    kernel.release(imported)\n    try { kernel.release(shape) } catch { /* 已释放 */ }\n    throw new Error('The selected object has no closed faces')\n  }\n\n  try {\n    for (const tolerance of [1e-5, 1e-4, 1e-3, 1e-2]) {\n      try {\n        let candidate = kernel.sewAndSolidify(faces, tolerance)\n        candidate = kernel.fixShape(candidate)\n        if (kernel.isSolid(candidate)) candidate = kernel.healSolid(candidate, tolerance)\n        candidate = kernel.fixFaceOrientations(candidate)\n        candidate = kernel.removeDegenerateEdges(candidate)\n        candidate = kernel.unifySameDomain(candidate)\n        if (kernel.isSolid(candidate) && cadShapeIsValid(kernel, candidate)) {\n          kernel.release(imported)\n          try { kernel.release(shape) } catch { /* 已释放 */ }\n          return candidate\n        }\n        // 未通过，释放候选\n        try { kernel.release(candidate) } catch { /* ignore */ }\n      } catch {\n        // 尝试下一个更大的容差\n      }\n    }\n  } finally {\n    // getSubShapes 返回的每个面都是独立 arena 句柄，缝合完成后批量释放——\n    // 否则每次 mesh→brep 重建泄漏 faceCount 个存活句柄（与 compat e2e ⑦\n    // 同类泄漏，getSubShapes 复制产物未回收）。\n    for (const f of faces) {\n      try { kernel.release(f) } catch { /* 已释放 */ }\n    }\n  }\n\n  kernel.release(imported)\n  try { kernel.release(shape) } catch { /* 已释放 */ }\n  throw new Error('The selected mesh is open or non-manifold. Repair it before converting to CAD.')\n}\n\n// ─── 便捷导出 ───\n\n/**\n * Rebuild a CAD solid from a triangle mesh and export it as a STEP string.\n *\n * Internally calls reconstructSolidFromMesh, then exportStep.\n * The returned STEP uses a BREP representation (ADVANCED_FACE + exact surfaces)\n * rather than a faceted representation (POLYGONAL_FACE).\n *\n * @param kernel - the initialized OCCT kernel\n * @param positions - vertex array\n * @param indices - triangle index array\n * @returns the STEP file content string\n */\nexport function meshToStepBrep(\n  kernel: BrepEngineApi,\n  positions: Float32Array,\n  indices: Uint32Array,\n): string {\n  const solid = reconstructSolidFromMesh(kernel, positions, indices)\n  try {\n    return kernel.exportStep(solid)\n  } finally {\n    kernel.release(solid)\n  }\n}\n"]}

package/dist/occt-kernel/occtKernel.d.ts

@@ -0,0 +1,174 @@
+/**
+ * occt-wasm 封装层 — 替代 occt-import-js
+ *
+ * 提供 STEP/BREP → Mesh 转换和 Mesh → STEP 导出能力。
+ * 利用 occt-wasm 的 meshShape() 获取 faceGroups（面→三角形映射），
+ * 利用 wireframe() 获取边折线数据，利用 edgeToFaceMap() 获取边→面关联。
+ */
+import type { OcctKernel, ShapeHandle, Mesh, EdgeData, SurfaceKind, CurveKind, BoundingBox, Vec3, XCAFDocument, LabelInfo, LabelTag } from 'occt-wasm';
+import type { BrepHandle } from '../brep/engine/types.js';
+import type { BrepEngineApi } from '../brep/engine/primitives.js';
+/** A single tessellated mesh produced by the OCCT kernel. */
+export interface WasmTessellatedMesh {
+    positions: Float32Array;
+    normals: Float32Array;
+    indices: Uint32Array;
+}
+/** Result of importing a shape into the OCCT kernel. */
+export interface WasmImportResult {
+    shapeHandle: ShapeHandle;
+    meshes: WasmTessellatedMesh[];
+    meshWithGroups: Mesh;
+}
+/**
+ * Let the browser host inject the OCCT initialization function.
+ *
+ * The browser host calls this to register its own init logic (dev/prod/CDN/e2e
+ * branches); faijs's initOcctWasm() prefers the injected function.
+ *
+ * When nothing is injected, initOcctWasm() reads the WASM from node_modules in
+ * a Node environment.
+ *
+ * @param fn - the initialization function to use, or null to clear
+ */
+export declare function setOcctWasmInitFn(fn: (() => Promise<OcctKernel>) | null): void;
+/**
+ * Resolve the occt-wasm WASM file path (linker-agnostic).
+ *
+ * Walks the package exports (occt-wasm@3.8.4 exports "./dist/occt-wasm.wasm"),
+ * independent of cwd / hoisting / pnpm|npm linker (verified pattern C).
+ * Replaces the old 4-level `..` path guessing + process.cwd() fallback.
+ *
+ * Lazy-fetches node:module (Node >= 20.16 process.getBuiltinModule): a static
+ * `import { createRequire } from 'node:module'` must not be used — occtKernel is
+ * on the browser build's (demo vite build) import chain, and a static node:*
+ * import would be externalized and error. This function is only called in the
+ * Node branch (initOcctWasm); it never runs in a browser environment.
+ *
+ * @returns the resolved WASM file path
+ */
+export declare function resolveOcctWasmPath(): string;
+/**
+ * Initialize the occt-wasm kernel (singleton).
+ *
+ * - Node.js test environment: read the WASM file from node_modules, pass an ArrayBuffer.
+ * - Development: direct ESM import, Vite resolves node_modules. The WASM file is loaded from public/wasm/occt-wasm.wasm.
+ * - Production: dynamically import the whole module + WASM from a CDN.
+ *
+ * @returns the initialized BREP engine API
+ */
+export declare function initOcctWasm(): Promise<BrepEngineApi>;
+/**
+ * Get the initialized kernel instance (initOcctWasm must be called first).
+ *
+ * @returns the initialized OCCT kernel
+ */
+export declare function getKernel(): OcctKernel;
+/** Release the kernel instance (call when the app unloads). */
+export declare function disposeOcctWasm(): void;
+/** Options controlling mesh deflection during tessellation. */
+export interface MeshDeflectionOptions {
+    linearDeflection?: number;
+    angularDeflection?: number;
+    /** If true, linearDeflection is multiplied by the bounding-box diagonal
+     *  (matches OCCT's BRepMesh_IncrementalMesh relative=true behaviour). */
+    relative?: boolean;
+}
+/**
+ * Compute the effective linear deflection, applying relative scaling
+ * exactly as OCCT does internally: `linDefl * bboxDiagonal` when relative=true.
+ *
+ * @param kernel - the OCCT kernel
+ * @param shape - the shape whose bounding box drives relative scaling
+ * @param options - the requested deflection options
+ * @returns the effective linear and angular deflection values
+ */
+export declare function computeEffectiveDeflection(kernel: BrepEngineApi, shape: BrepHandle, options?: MeshDeflectionOptions): {
+    linearDeflection: number;
+    angularDeflection: number;
+};
+/**
+ * Import a STEP file to ShapeHandle + Mesh (including face groups).
+ *
+ * Uses meshShape() rather than tessellate(), so face-group data is available
+ * (each face's triangle range [triStart, triCount, faceHash]).
+ *
+ * @param stepData - STEP file bytes
+ * @param deflection - optional mesh deflection options
+ * @returns the import result with shape handle and meshes
+ */
+export declare function importStepToMesh(stepData: ArrayBuffer | Uint8Array, deflection?: MeshDeflectionOptions): Promise<WasmImportResult>;
+/** A node in the XCAF assembly tree (mirrors the STEP_T occurrence concept). */
+export interface AssemblyPartNode {
+    /** Dotted path: 'o0', 'o0.o1', 'o0.o1.o2' — matches STEP_T occurrence path. */
+    labelPath: string;
+    /** XCAF label name (falls back to labelPath if empty). */
+    name: string;
+    /** True if this node is an assembly (has child components). */
+    isAssembly: boolean;
+    /** True if this node is a component reference (leaf part with location). */
+    isComponent: boolean;
+    /** Shape handle with location baked in (for components) or raw shape (for roots).
+     *  Caller must release this handle. Null for empty assembly labels. */
+    shapeHandle: ShapeHandle | null;
+    /** Deduplication key for prototype shapes (same geometry = same key).
+     *  Only set for leaf (non-assembly) nodes. */
+    prototypeKey: string | null;
+    /** RGB color [r,g,b] in 0..1 range, or null if no color. */
+    color: [number, number, number] | null;
+    /** Child nodes (recursive). Empty for leaf parts. */
+    children: AssemblyPartNode[];
+}
+/**
+ * Import a STEP file via XCAF (STEPCAFControl_Reader), preserving the assembly
+ * tree, names, colors, and per-component locations.
+ *
+ * Unlike `importStepToMesh` (which flattens via STEPControl_Reader.OneShape()),
+ * this function returns the full assembly tree structure.
+ *
+ * The caller is responsible for releasing all shapeHandle values in the tree
+ * (use `releaseAssemblyTree`).
+ *
+ * @param stepData - STEP file bytes
+ * @returns the root assembly-part nodes
+ */
+export declare function importAssemblyFromStep(stepData: ArrayBuffer | Uint8Array): Promise<AssemblyPartNode[]>;
+/** Recursively release all shapeHandle values in an assembly tree.
+ *
+ * @param kernel - the OCCT kernel used to release handles
+ * @param nodes - the assembly tree nodes to release
+ */
+export declare function releaseAssemblyTree(kernel: BrepEngineApi, nodes: AssemblyPartNode[]): void;
+/** Collect all leaf (non-assembly) nodes from an assembly tree.
+ *
+ * @param nodes - the assembly tree nodes to traverse
+ * @returns the collected leaf part nodes in depth-first order
+ */
+export declare function collectLeafParts(nodes: AssemblyPartNode[]): AssemblyPartNode[];
+/**
+ * Import BREP text to ShapeHandle + Mesh.
+ *
+ * @param brepData - BREP file content as a string
+ * @param deflection - optional mesh deflection options
+ * @returns the import result with shape handle and meshes
+ */
+export declare function importBrepToMesh(brepData: string, deflection?: MeshDeflectionOptions): Promise<WasmImportResult>;
+/**
+ * Mesh → STEP export: rebuild a STEP solid from a triangle mesh.
+ * Follows the pattern from occt-wasm/examples/stl2step.mjs.
+ *
+ * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]
+ * @param indices - index array [i0,i1,i2, i3,i4,i5, ...]
+ * @param tolerance - sewing tolerance in mm (default 0.01)
+ * @returns the STEP file content string
+ */
+export declare function meshesToStep(positions: Float32Array, indices: Uint32Array, tolerance?: number): string;
+/**
+ * Release a shape handle.
+ *
+ * @param handle - the shape handle to release
+ */
+export declare function releaseShape(handle: ShapeHandle): void;
+/** 导出类型供外部使用 */
+export type { OcctKernel, ShapeHandle, Mesh, EdgeData, SurfaceKind, CurveKind, BoundingBox, Vec3, XCAFDocument, LabelInfo, LabelTag };
+//# sourceMappingURL=occtKernel.d.ts.map

package/dist/occt-kernel/occtKernel.d.ts.map

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