@faicad/faijs 0.13.0

package/dist/occt-kernel/occtKernel.js

@@ -0,0 +1,400 @@
+import { getSolidColorsOrdered } from './stepColorParser.js';
+let kernelInstance = null;
+let initPromise = null;
+// F5 设计意图说明：
+// kernelInstance / initPromise 是环境级单例，不是实例级。
+// 在整个浏览器页面/Node 进程中，OCCT WASM 只应初始化一次。
+// 多个 CadRuntime 实例共享同一个 kernel 是正确的行为。
+/** 浏览器 host 注入的 OCCT 初始化函数 */
+let customInitFn = null;
+/**
+ * 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 function setOcctWasmInitFn(fn) {
+    customInitFn = fn;
+}
+/**
+ * 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 function resolveOcctWasmPath() {
+    const builtin = process.getBuiltinModule?.('node:module');
+    if (!builtin) {
+        throw new Error('[faijs] resolveOcctWasmPath requires Node.js (process.getBuiltinModule)');
+    }
+    return builtin.createRequire(import.meta.url).resolve('occt-wasm/dist/occt-wasm.wasm');
+}
+/**
+ * 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 async function initOcctWasm() {
+    if (kernelInstance)
+        return kernelInstance;
+    if (initPromise)
+        return initPromise;
+    initPromise = (async () => {
+        // 优先使用浏览器 host 注入的初始化函数
+        if (customInitFn) {
+            kernelInstance = await customInitFn();
+            return kernelInstance;
+        }
+        // Node.js 环境：从 node_modules 读取 WASM 文件
+        if (typeof process !== 'undefined' && process.versions?.node) {
+            const { OcctKernel: Ctor } = await import('occt-wasm');
+            const { readFileSync } = await import('node:fs');
+            const wasmPath = resolveOcctWasmPath();
+            const buf = readFileSync(wasmPath);
+            const wasmBinary = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+            kernelInstance = await Ctor.init({ wasm: wasmBinary });
+            return kernelInstance;
+        }
+        throw new Error('initOcctWasm: no init function set and not in Node environment. Call setOcctWasmInitFn() first.');
+    })();
+    return initPromise;
+}
+/**
+ * Get the initialized kernel instance (initOcctWasm must be called first).
+ *
+ * @returns the initialized OCCT kernel
+ */
+export function getKernel() {
+    if (!kernelInstance)
+        throw new Error('occt-wasm kernel not initialized — call initOcctWasm() first');
+    return kernelInstance;
+}
+/** Release the kernel instance (call when the app unloads). */
+export function disposeOcctWasm() {
+    if (kernelInstance) {
+        kernelInstance[Symbol.dispose]();
+        kernelInstance = null;
+        initPromise = null;
+    }
+}
+/**
+ * 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 function computeEffectiveDeflection(kernel, shape, options = {}) {
+    const ld = options.linearDeflection ?? 0.1;
+    const ad = options.angularDeflection ?? 0.5;
+    const relative = options.relative ?? false;
+    if (!relative)
+        return { linearDeflection: ld, angularDeflection: ad };
+    // OCCT: BRepBndLib::AddOptimal → bbox diagonal → deflection *= diagonal
+    // 浏览器 WASM 中 compound shape 可能使 getBoundingBox 抛异常，需要容错
+    let bb;
+    try {
+        bb = kernel.getBoundingBox(shape, false);
+    }
+    catch {
+        try {
+            bb = kernel.getBoundingBox(shape, true);
+        }
+        catch {
+            // 无法获取 bbox → 返回非相对模式的默认值
+            return { linearDeflection: ld, angularDeflection: ad };
+        }
+    }
+    const dx = bb.xmax - bb.xmin;
+    const dy = bb.ymax - bb.ymin;
+    const dz = bb.zmax - bb.zmin;
+    const diag = Math.sqrt(dx * dx + dy * dy + dz * dz);
+    return { linearDeflection: ld * diag, angularDeflection: ad };
+}
+/**
+ * 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 async function importStepToMesh(stepData, deflection) {
+    const kernel = (await initOcctWasm());
+    const ab = stepData instanceof Uint8Array ? stepData.buffer.slice(stepData.byteOffset, stepData.byteOffset + stepData.byteLength) : stepData;
+    const shape = kernel.importStep(ab);
+    const eff = computeEffectiveDeflection(kernel, shape, deflection);
+    const mesh = kernel.meshShape(shape, { linearDeflection: eff.linearDeflection, angularDeflection: eff.angularDeflection });
+    return {
+        shapeHandle: shape,
+        meshes: [{
+                positions: mesh.positions,
+                normals: mesh.normals,
+                indices: mesh.indices,
+            }],
+        meshWithGroups: mesh,
+    };
+}
+const IDENTITY_MATRIX = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0];
+/**
+ * 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 async function importAssemblyFromStep(stepData) {
+    const kernel = (await initOcctWasm());
+    const stepText = stepData instanceof Uint8Array
+        ? new TextDecoder().decode(stepData)
+        : new TextDecoder().decode(new Uint8Array(stepData));
+    // Parse sub-shape colors from STEP text (fallback for when XCAF label has no color).
+    // STEP files from NX/SolidWorks often store colors as STYLED_ITEM on individual
+    // solids rather than on XCAF labels, so getLabelInfo returns hasColor=false.
+    const solidColors = getSolidColorsOrdered(stepText);
+    // XCAFDocument.fromSTEP uses STEPCAFControl_Reader with color/name/layer modes
+    const doc = kernel.importXCAFFromSTEP(stepText);
+    try {
+        const rootTags = doc.getRoots();
+        const nodes = [];
+        const cursor = { idx: 0 };
+        for (let i = 0; i < rootTags.length; i++) {
+            nodes.push(walkLabel(kernel, doc, rootTags[i], `o${i}`, solidColors, cursor));
+        }
+        return nodes;
+    }
+    finally {
+        doc.close();
+    }
+}
+function walkLabel(kernel, doc, tag, path, solidColors, ctx) {
+    const info = doc.getLabelInfo(tag);
+    const name = info.name || path;
+    const color = info.hasColor ? [info.color[0], info.color[1], info.color[2]] : null;
+    if (info.isAssembly) {
+        const childTags = doc.getChildren(tag);
+        const children = [];
+        for (let i = 0; i < childTags.length; i++) {
+            children.push(walkLabel(kernel, doc, childTags[i], `${path}.o${i}`, solidColors, ctx));
+        }
+        // Assembly nodes have no shape of their own; release if one was returned
+        if (info.shapeHandle)
+            kernel.release(info.shapeHandle);
+        return {
+            labelPath: path,
+            name,
+            isAssembly: true,
+            isComponent: false,
+            shapeHandle: null,
+            prototypeKey: null,
+            color,
+            children,
+        };
+    }
+    // Leaf component — shapeHandle has location baked in (OCCT GetShape semantics)
+    // Check if this is a compound with multiple solids — if so, split into
+    // separate child nodes so each solid becomes its own mesh/scene-tree node.
+    // This handles STEP files that have a single PRODUCT containing a compound
+    // of multiple MANIFOLD_SOLID_BREP entities (common in NX/SolidWorks exports).
+    if (info.shapeHandle) {
+        const solids = kernel.getSubShapes(info.shapeHandle, 'solid');
+        if (solids.length > 1) {
+            // Multi-solid compound → split into virtual assembly children
+            // Each child gets its own solid shapeHandle (already at correct location
+            // because getSubShapes extracts from the located compound).
+            const children = [];
+            for (let si = 0; si < solids.length; si++) {
+                const childPath = `${path}.s${si}`;
+                const childName = `${name} [${si + 1}]`;
+                let childProtoKey;
+                try {
+                    childProtoKey = String(kernel.hashCode(solids[si], 2147483647));
+                }
+                catch {
+                    childProtoKey = null;
+                }
+                // Use STEP-parsed color if label has no color (sub-shape level color)
+                const childColor = color ?? (solidColors[ctx.idx] ?? null);
+                ctx.idx++;
+                children.push({
+                    labelPath: childPath,
+                    name: childName,
+                    isAssembly: false,
+                    isComponent: true,
+                    shapeHandle: solids[si],
+                    prototypeKey: childProtoKey,
+                    color: childColor,
+                    children: [],
+                });
+            }
+            // Release the compound shape itself — children hold individual solids
+            kernel.release(info.shapeHandle);
+            return {
+                labelPath: path,
+                name,
+                isAssembly: true, // mark as assembly so it becomes a group node
+                isComponent: false,
+                shapeHandle: null,
+                prototypeKey: null,
+                color,
+                children,
+            };
+        }
+        // Single solid (or non-solid) — release the extra sub-shape handles
+        for (const s of solids)
+            kernel.release(s);
+    }
+    let prototypeKey = null;
+    if (info.shapeHandle) {
+        // Get un-located shape for dedup (located with identity = remove location)
+        try {
+            const unlocated = kernel.located(info.shapeHandle, IDENTITY_MATRIX);
+            prototypeKey = String(kernel.hashCode(unlocated, 2147483647));
+            kernel.release(unlocated);
+        }
+        catch {
+            // Fallback: use shapeHandle hash directly (less accurate dedup)
+            prototypeKey = String(kernel.hashCode(info.shapeHandle, 2147483647));
+        }
+    }
+    // For single-solid leaf parts, also try STEP-parsed color as fallback
+    const finalColor = color ?? (solidColors[ctx.idx] ?? null);
+    ctx.idx++;
+    return {
+        labelPath: path,
+        name,
+        isAssembly: false,
+        isComponent: info.isComponent,
+        shapeHandle: info.shapeHandle,
+        prototypeKey,
+        color: finalColor,
+        children: [],
+    };
+}
+/** 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 function releaseAssemblyTree(kernel, nodes) {
+    for (const node of nodes) {
+        if (node.shapeHandle)
+            kernel.release(node.shapeHandle);
+        if (node.children.length > 0)
+            releaseAssemblyTree(kernel, node.children);
+    }
+}
+/** 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 function collectLeafParts(nodes) {
+    const leaves = [];
+    function walk(node) {
+        if (node.isAssembly) {
+            for (const child of node.children)
+                walk(child);
+        }
+        else {
+            leaves.push(node);
+        }
+    }
+    for (const node of nodes)
+        walk(node);
+    return leaves;
+}
+/**
+ * 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 async function importBrepToMesh(brepData, deflection) {
+    const kernel = (await initOcctWasm());
+    const shape = kernel.fromBREP(brepData);
+    const eff = computeEffectiveDeflection(kernel, shape, deflection);
+    const mesh = kernel.meshShape(shape, { linearDeflection: eff.linearDeflection, angularDeflection: eff.angularDeflection });
+    return {
+        shapeHandle: shape,
+        meshes: [{
+                positions: mesh.positions,
+                normals: mesh.normals,
+                indices: mesh.indices,
+            }],
+        meshWithGroups: mesh,
+    };
+}
+/**
+ * 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 function meshesToStep(positions, indices, tolerance = 0.01) {
+    const kernel = getKernel();
+    const faces = [];
+    let solid = null;
+    try {
+        for (let i = 0; i < indices.length; i += 3) {
+            const ia = indices[i] * 3;
+            const ib = indices[i + 1] * 3;
+            const ic = indices[i + 2] * 3;
+            const face = kernel.buildTriFace({ x: positions[ia], y: positions[ia + 1], z: positions[ia + 2] }, { x: positions[ib], y: positions[ib + 1], z: positions[ib + 2] }, { x: positions[ic], y: positions[ic + 1], z: positions[ic + 2] });
+            faces.push(face);
+        }
+        solid = kernel.sewAndSolidify(faces, tolerance);
+        const unified = kernel.unifySameDomain(solid);
+        kernel.release(solid);
+        solid = unified;
+        return kernel.exportStep(solid);
+    }
+    finally {
+        if (solid !== null)
+            kernel.release(solid);
+        for (const f of faces)
+            kernel.release(f);
+    }
+}
+/**
+ * Release a shape handle.
+ *
+ * @param handle - the shape handle to release
+ */
+export function releaseShape(handle) {
+    if (kernelInstance)
+        kernelInstance.release(handle);
+}
+//# sourceMappingURL=occtKernel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"occtKernel.js","sourceRoot":"","sources":["../../src/occt-kernel/occtKernel.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * occt-wasm 封装层 — 替代 occt-import-js\n *\n * 提供 STEP/BREP → Mesh 转换和 Mesh → STEP 导出能力。\n * 利用 occt-wasm 的 meshShape() 获取 faceGroups（面→三角形映射），\n * 利用 wireframe() 获取边折线数据，利用 edgeToFaceMap() 获取边→面关联。\n */\nimport type { OcctKernel, ShapeHandle, Mesh, EdgeData, SurfaceKind, CurveKind, BoundingBox, Vec3, XCAFDocument, LabelInfo, LabelTag } from 'occt-wasm'\nimport type { BrepHandle } from '../brep/engine/types'\nimport type { BrepEngineApi } from '../brep/engine/primitives'\nimport { getSolidColorsOrdered } from './stepColorParser'\n\n/** A single tessellated mesh produced by the OCCT kernel. */\nexport interface WasmTessellatedMesh {\n  positions: Float32Array\n  normals: Float32Array\n  indices: Uint32Array\n}\n\n/** Result of importing a shape into the OCCT kernel. */\nexport interface WasmImportResult {\n  shapeHandle: ShapeHandle\n  meshes: WasmTessellatedMesh[]\n  meshWithGroups: Mesh\n}\n\nlet kernelInstance: OcctKernel | null = null\nlet initPromise: Promise<BrepEngineApi> | null = null\n\n// F5 设计意图说明：\n// kernelInstance / initPromise 是环境级单例，不是实例级。\n// 在整个浏览器页面/Node 进程中，OCCT WASM 只应初始化一次。\n// 多个 CadRuntime 实例共享同一个 kernel 是正确的行为。\n\n/** 浏览器 host 注入的 OCCT 初始化函数 */\nlet customInitFn: (() => Promise<OcctKernel>) | null = null\n\n/**\n * Let the browser host inject the OCCT initialization function.\n *\n * The browser host calls this to register its own init logic (dev/prod/CDN/e2e\n * branches); faijs's initOcctWasm() prefers the injected function.\n *\n * When nothing is injected, initOcctWasm() reads the WASM from node_modules in\n * a Node environment.\n *\n * @param fn - the initialization function to use, or null to clear\n */\nexport function setOcctWasmInitFn(fn: (() => Promise<OcctKernel>) | null): void {\n  customInitFn = fn\n}\n\n/**\n * Resolve the occt-wasm WASM file path (linker-agnostic).\n *\n * Walks the package exports (occt-wasm@3.8.4 exports \"./dist/occt-wasm.wasm\"),\n * independent of cwd / hoisting / pnpm|npm linker (verified pattern C).\n * Replaces the old 4-level `..` path guessing + process.cwd() fallback.\n *\n * Lazy-fetches node:module (Node >= 20.16 process.getBuiltinModule): a static\n * `import { createRequire } from 'node:module'` must not be used — occtKernel is\n * on the browser build's (demo vite build) import chain, and a static node:*\n * import would be externalized and error. This function is only called in the\n * Node branch (initOcctWasm); it never runs in a browser environment.\n *\n * @returns the resolved WASM file path\n */\nexport function resolveOcctWasmPath(): string {\n  const builtin = (process as { getBuiltinModule?: (id: string) => unknown }).getBuiltinModule?.('node:module') as\n    | { createRequire: (filename: string) => { resolve: (id: string) => string } }\n    | undefined\n  if (!builtin) {\n    throw new Error('[faijs] resolveOcctWasmPath requires Node.js (process.getBuiltinModule)')\n  }\n  return builtin.createRequire(import.meta.url).resolve('occt-wasm/dist/occt-wasm.wasm')\n}\n\n/**\n * Initialize the occt-wasm kernel (singleton).\n *\n * - Node.js test environment: read the WASM file from node_modules, pass an ArrayBuffer.\n * - Development: direct ESM import, Vite resolves node_modules. The WASM file is loaded from public/wasm/occt-wasm.wasm.\n * - Production: dynamically import the whole module + WASM from a CDN.\n *\n * @returns the initialized BREP engine API\n */\nexport async function initOcctWasm(): Promise<BrepEngineApi> {\n  if (kernelInstance) return kernelInstance as unknown as BrepEngineApi\n  if (initPromise) return initPromise as unknown as Promise<BrepEngineApi>\n\n  initPromise = (async () => {\n    // 优先使用浏览器 host 注入的初始化函数\n    if (customInitFn) {\n      kernelInstance = await customInitFn()\n      return kernelInstance as unknown as BrepEngineApi\n    }\n\n    // Node.js 环境：从 node_modules 读取 WASM 文件\n    if (typeof process !== 'undefined' && process.versions?.node) {\n      const { OcctKernel: Ctor } = await import('occt-wasm')\n      const { readFileSync } = await import('node:fs')\n      const wasmPath = resolveOcctWasmPath()\n      const buf = readFileSync(wasmPath)\n      const wasmBinary = buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength) as ArrayBuffer\n      kernelInstance = await Ctor.init({ wasm: wasmBinary })\n      return kernelInstance as unknown as BrepEngineApi\n    }\n\n    throw new Error('initOcctWasm: no init function set and not in Node environment. Call setOcctWasmInitFn() first.')\n  })()\n\n  return initPromise as unknown as Promise<BrepEngineApi>\n}\n\n/**\n * Get the initialized kernel instance (initOcctWasm must be called first).\n *\n * @returns the initialized OCCT kernel\n */\nexport function getKernel(): OcctKernel {\n  if (!kernelInstance) throw new Error('occt-wasm kernel not initialized — call initOcctWasm() first')\n  return kernelInstance\n}\n\n/** Release the kernel instance (call when the app unloads). */\nexport function disposeOcctWasm(): void {\n  if (kernelInstance) {\n    kernelInstance[Symbol.dispose]()\n    kernelInstance = null\n    initPromise = null\n  }\n}\n\n/** Options controlling mesh deflection during tessellation. */\nexport interface MeshDeflectionOptions {\n  linearDeflection?: number\n  angularDeflection?: number\n  /** If true, linearDeflection is multiplied by the bounding-box diagonal\n   *  (matches OCCT's BRepMesh_IncrementalMesh relative=true behaviour). */\n  relative?: boolean\n}\n\n/**\n * Compute the effective linear deflection, applying relative scaling\n * exactly as OCCT does internally: `linDefl * bboxDiagonal` when relative=true.\n *\n * @param kernel - the OCCT kernel\n * @param shape - the shape whose bounding box drives relative scaling\n * @param options - the requested deflection options\n * @returns the effective linear and angular deflection values\n */\nexport function computeEffectiveDeflection(\n  kernel: BrepEngineApi,\n  shape: BrepHandle,\n  options: MeshDeflectionOptions = {},\n): { linearDeflection: number; angularDeflection: number } {\n  const ld = options.linearDeflection ?? 0.1\n  const ad = options.angularDeflection ?? 0.5\n  const relative = options.relative ?? false\n  if (!relative) return { linearDeflection: ld, angularDeflection: ad }\n\n  // OCCT: BRepBndLib::AddOptimal → bbox diagonal → deflection *= diagonal\n  // 浏览器 WASM 中 compound shape 可能使 getBoundingBox 抛异常，需要容错\n  let bb: BoundingBox\n  try {\n    bb = kernel.getBoundingBox(shape, false)\n  } catch {\n    try {\n      bb = kernel.getBoundingBox(shape, true)\n    } catch {\n      // 无法获取 bbox → 返回非相对模式的默认值\n      return { linearDeflection: ld, angularDeflection: ad }\n    }\n  }\n  const dx = bb.xmax - bb.xmin\n  const dy = bb.ymax - bb.ymin\n  const dz = bb.zmax - bb.zmin\n  const diag = Math.sqrt(dx * dx + dy * dy + dz * dz)\n  return { linearDeflection: ld * diag, angularDeflection: ad }\n}\n\n/**\n * Import a STEP file to ShapeHandle + Mesh (including face groups).\n *\n * Uses meshShape() rather than tessellate(), so face-group data is available\n * (each face's triangle range [triStart, triCount, faceHash]).\n *\n * @param stepData - STEP file bytes\n * @param deflection - optional mesh deflection options\n * @returns the import result with shape handle and meshes\n */\nexport async function importStepToMesh(\n  stepData: ArrayBuffer | Uint8Array,\n  deflection?: MeshDeflectionOptions,\n): Promise<WasmImportResult> {\n  const kernel = (await initOcctWasm()) as unknown as OcctKernel\n  const ab = stepData instanceof Uint8Array ? stepData.buffer.slice(stepData.byteOffset, stepData.byteOffset + stepData.byteLength) as ArrayBuffer : stepData\n  const shape = kernel.importStep(ab)\n\n  const eff = computeEffectiveDeflection(kernel as unknown as BrepEngineApi, shape as unknown as BrepHandle, deflection)\n  const mesh = kernel.meshShape(shape, { linearDeflection: eff.linearDeflection, angularDeflection: eff.angularDeflection })\n\n  return {\n    shapeHandle: shape,\n    meshes: [{\n      positions: mesh.positions,\n      normals: mesh.normals,\n      indices: mesh.indices,\n    }],\n    meshWithGroups: mesh,\n  }\n}\n\n// ── Assembly (XCAF) support ──\n\n/** A node in the XCAF assembly tree (mirrors the STEP_T occurrence concept). */\nexport interface AssemblyPartNode {\n  /** Dotted path: 'o0', 'o0.o1', 'o0.o1.o2' — matches STEP_T occurrence path. */\n  labelPath: string\n  /** XCAF label name (falls back to labelPath if empty). */\n  name: string\n  /** True if this node is an assembly (has child components). */\n  isAssembly: boolean\n  /** True if this node is a component reference (leaf part with location). */\n  isComponent: boolean\n  /** Shape handle with location baked in (for components) or raw shape (for roots).\n   *  Caller must release this handle. Null for empty assembly labels. */\n  shapeHandle: ShapeHandle | null\n  /** Deduplication key for prototype shapes (same geometry = same key).\n   *  Only set for leaf (non-assembly) nodes. */\n  prototypeKey: string | null\n  /** RGB color [r,g,b] in 0..1 range, or null if no color. */\n  color: [number, number, number] | null\n  /** Child nodes (recursive). Empty for leaf parts. */\n  children: AssemblyPartNode[]\n}\n\nconst IDENTITY_MATRIX = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0]\n\n/**\n * Import a STEP file via XCAF (STEPCAFControl_Reader), preserving the assembly\n * tree, names, colors, and per-component locations.\n *\n * Unlike `importStepToMesh` (which flattens via STEPControl_Reader.OneShape()),\n * this function returns the full assembly tree structure.\n *\n * The caller is responsible for releasing all shapeHandle values in the tree\n * (use `releaseAssemblyTree`).\n *\n * @param stepData - STEP file bytes\n * @returns the root assembly-part nodes\n */\nexport async function importAssemblyFromStep(\n  stepData: ArrayBuffer | Uint8Array,\n): Promise<AssemblyPartNode[]> {\n  const kernel = (await initOcctWasm()) as unknown as OcctKernel\n  const stepText = stepData instanceof Uint8Array\n    ? new TextDecoder().decode(stepData)\n    : new TextDecoder().decode(new Uint8Array(stepData))\n\n  // Parse sub-shape colors from STEP text (fallback for when XCAF label has no color).\n  // STEP files from NX/SolidWorks often store colors as STYLED_ITEM on individual\n  // solids rather than on XCAF labels, so getLabelInfo returns hasColor=false.\n  const solidColors = getSolidColorsOrdered(stepText)\n\n  // XCAFDocument.fromSTEP uses STEPCAFControl_Reader with color/name/layer modes\n  const doc = kernel.importXCAFFromSTEP(stepText)\n  try {\n    const rootTags = doc.getRoots()\n    const nodes: AssemblyPartNode[] = []\n    const cursor = { idx: 0 }\n    for (let i = 0; i < rootTags.length; i++) {\n      nodes.push(walkLabel(kernel, doc, rootTags[i], `o${i}`, solidColors, cursor))\n    }\n    return nodes\n  } finally {\n    doc.close()\n  }\n}\n\n/** Walk-context: tracks the current position in the solidColors array across\n *  recursive walkLabel calls so that multi-solid compounds consume colors in order. */\ninterface WalkCtx {\n  idx: number\n}\n\nfunction walkLabel(\n  kernel: OcctKernel,\n  doc: XCAFDocument,\n  tag: LabelTag,\n  path: string,\n  solidColors: ([number, number, number] | null)[],\n  ctx: WalkCtx,\n): AssemblyPartNode {\n  const info: LabelInfo = doc.getLabelInfo(tag)\n  const name = info.name || path\n  const color = info.hasColor ? [info.color[0], info.color[1], info.color[2]] as [number, number, number] : null\n\n  if (info.isAssembly) {\n    const childTags = doc.getChildren(tag)\n    const children: AssemblyPartNode[] = []\n    for (let i = 0; i < childTags.length; i++) {\n      children.push(walkLabel(kernel, doc, childTags[i], `${path}.o${i}`, solidColors, ctx))\n    }\n    // Assembly nodes have no shape of their own; release if one was returned\n    if (info.shapeHandle) kernel.release(info.shapeHandle)\n    return {\n      labelPath: path,\n      name,\n      isAssembly: true,\n      isComponent: false,\n      shapeHandle: null,\n      prototypeKey: null,\n      color,\n      children,\n    }\n  }\n\n  // Leaf component — shapeHandle has location baked in (OCCT GetShape semantics)\n  // Check if this is a compound with multiple solids — if so, split into\n  // separate child nodes so each solid becomes its own mesh/scene-tree node.\n  // This handles STEP files that have a single PRODUCT containing a compound\n  // of multiple MANIFOLD_SOLID_BREP entities (common in NX/SolidWorks exports).\n  if (info.shapeHandle) {\n    const solids = kernel.getSubShapes(info.shapeHandle, 'solid')\n    if (solids.length > 1) {\n      // Multi-solid compound → split into virtual assembly children\n      // Each child gets its own solid shapeHandle (already at correct location\n      // because getSubShapes extracts from the located compound).\n      const children: AssemblyPartNode[] = []\n      for (let si = 0; si < solids.length; si++) {\n        const childPath = `${path}.s${si}`\n        const childName = `${name} [${si + 1}]`\n        let childProtoKey: string | null\n        try {\n          childProtoKey = String(kernel.hashCode(solids[si], 2147483647))\n        } catch {\n          childProtoKey = null\n        }\n        // Use STEP-parsed color if label has no color (sub-shape level color)\n        const childColor = color ?? (solidColors[ctx.idx] ?? null)\n        ctx.idx++\n        children.push({\n          labelPath: childPath,\n          name: childName,\n          isAssembly: false,\n          isComponent: true,\n          shapeHandle: solids[si],\n          prototypeKey: childProtoKey,\n          color: childColor,\n          children: [],\n        })\n      }\n      // Release the compound shape itself — children hold individual solids\n      kernel.release(info.shapeHandle)\n      return {\n        labelPath: path,\n        name,\n        isAssembly: true, // mark as assembly so it becomes a group node\n        isComponent: false,\n        shapeHandle: null,\n        prototypeKey: null,\n        color,\n        children,\n      }\n    }\n    // Single solid (or non-solid) — release the extra sub-shape handles\n    for (const s of solids) kernel.release(s)\n  }\n\n  let prototypeKey: string | null = null\n  if (info.shapeHandle) {\n    // Get un-located shape for dedup (located with identity = remove location)\n    try {\n      const unlocated = kernel.located(info.shapeHandle, IDENTITY_MATRIX)\n      prototypeKey = String(kernel.hashCode(unlocated, 2147483647))\n      kernel.release(unlocated)\n    } catch {\n      // Fallback: use shapeHandle hash directly (less accurate dedup)\n      prototypeKey = String(kernel.hashCode(info.shapeHandle, 2147483647))\n    }\n  }\n\n  // For single-solid leaf parts, also try STEP-parsed color as fallback\n  const finalColor = color ?? (solidColors[ctx.idx] ?? null)\n  ctx.idx++\n\n  return {\n    labelPath: path,\n    name,\n    isAssembly: false,\n    isComponent: info.isComponent,\n    shapeHandle: info.shapeHandle,\n    prototypeKey,\n    color: finalColor,\n    children: [],\n  }\n}\n\n/** Recursively release all shapeHandle values in an assembly tree.\n *\n * @param kernel - the OCCT kernel used to release handles\n * @param nodes - the assembly tree nodes to release\n */\nexport function releaseAssemblyTree(kernel: BrepEngineApi, nodes: AssemblyPartNode[]): void {\n  for (const node of nodes) {\n    if (node.shapeHandle) kernel.release(node.shapeHandle as unknown as BrepHandle)\n    if (node.children.length > 0) releaseAssemblyTree(kernel, node.children)\n  }\n}\n\n/** Collect all leaf (non-assembly) nodes from an assembly tree.\n *\n * @param nodes - the assembly tree nodes to traverse\n * @returns the collected leaf part nodes in depth-first order\n */\nexport function collectLeafParts(nodes: AssemblyPartNode[]): AssemblyPartNode[] {\n  const leaves: AssemblyPartNode[] = []\n  function walk(node: AssemblyPartNode) {\n    if (node.isAssembly) {\n      for (const child of node.children) walk(child)\n    } else {\n      leaves.push(node)\n    }\n  }\n  for (const node of nodes) walk(node)\n  return leaves\n}\n\n/**\n * Import BREP text to ShapeHandle + Mesh.\n *\n * @param brepData - BREP file content as a string\n * @param deflection - optional mesh deflection options\n * @returns the import result with shape handle and meshes\n */\nexport async function importBrepToMesh(\n  brepData: string,\n  deflection?: MeshDeflectionOptions,\n): Promise<WasmImportResult> {\n  const kernel = (await initOcctWasm()) as unknown as OcctKernel\n  const shape = kernel.fromBREP(brepData)\n\n  const eff = computeEffectiveDeflection(kernel as unknown as BrepEngineApi, shape as unknown as BrepHandle, deflection)\n  const mesh = kernel.meshShape(shape, { linearDeflection: eff.linearDeflection, angularDeflection: eff.angularDeflection })\n\n  return {\n    shapeHandle: shape,\n    meshes: [{\n      positions: mesh.positions,\n      normals: mesh.normals,\n      indices: mesh.indices,\n    }],\n    meshWithGroups: mesh,\n  }\n}\n\n/**\n * Mesh → STEP export: rebuild a STEP solid from a triangle mesh.\n * Follows the pattern from occt-wasm/examples/stl2step.mjs.\n *\n * @param positions - vertex array [x0,y0,z0, x1,y1,z1, ...]\n * @param indices - index array [i0,i1,i2, i3,i4,i5, ...]\n * @param tolerance - sewing tolerance in mm (default 0.01)\n * @returns the STEP file content string\n */\nexport function meshesToStep(\n  positions: Float32Array,\n  indices: Uint32Array,\n  tolerance = 0.01,\n): string {\n  const kernel = getKernel()\n  const faces: ShapeHandle[] = []\n  let solid: ShapeHandle | null = null\n\n  try {\n    for (let i = 0; i < indices.length; i += 3) {\n      const ia = indices[i] * 3\n      const ib = indices[i + 1] * 3\n      const ic = indices[i + 2] * 3\n      const face = kernel.buildTriFace(\n        { x: positions[ia], y: positions[ia + 1], z: positions[ia + 2] },\n        { x: positions[ib], y: positions[ib + 1], z: positions[ib + 2] },\n        { x: positions[ic], y: positions[ic + 1], z: positions[ic + 2] },\n      )\n      faces.push(face)\n    }\n\n    solid = kernel.sewAndSolidify(faces, tolerance)\n    const unified = kernel.unifySameDomain(solid)\n    kernel.release(solid)\n    solid = unified\n    return kernel.exportStep(solid)\n  } finally {\n    if (solid !== null) kernel.release(solid)\n    for (const f of faces) kernel.release(f)\n  }\n}\n\n/**\n * Release a shape handle.\n *\n * @param handle - the shape handle to release\n */\nexport function releaseShape(handle: ShapeHandle): void {\n  if (kernelInstance) kernelInstance.release(handle)\n}\n\n/** 导出类型供外部使用 */\nexport type { OcctKernel, ShapeHandle, Mesh, EdgeData, SurfaceKind, CurveKind, BoundingBox, Vec3, XCAFDocument, LabelInfo, LabelTag }\n"]}

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

@@ -0,0 +1,54 @@
+/**
+ * STEP 颜色解析器 — 从 STEP 文本中提取每个 solid 的颜色。
+ *
+ * STEP 文件中的颜色引用链：
+ *   STYLED_ITEM → PRESENTATION_STYLE_ASSIGNMENT → SURFACE_STYLE_USAGE
+ *   → SURFACE_SIDE_STYLE → SURFACE_STYLE_FILL_AREA → FILL_AREA_STYLE
+ *   → FILL_AREA_STYLE_COLOUR → COLOUR_RGB
+ *
+ * STYLED_ITEM 的第三个参数引用被着色的 shape entity（通常是 MANIFOLD_SOLID_BREP）。
+ * 我们解析这个引用链，建立 solid entity ID → color 的映射。
+ *
+ * 当 OCCT XCAF 的 getLabelInfo 返回 hasColor=false 时（颜色存储在 sub-shape 层级
+ * 而非 label 层级），此解析器作为后备方案提取颜色。
+ */
+export interface StepEntity {
+    id: number;
+    type: string;
+    /** Raw parameter string (between parentheses). */
+    params: string;
+}
+/** A solid's color parsed from STEP text. */
+export interface SolidColor {
+    /** STEP entity ID of the MANIFOLD_SOLID_BREP. */
+    solidId: number;
+    /** RGB color in 0..1 range. */
+    color: [number, number, number];
+}
+/**
+ * Parse STEP text and extract colors for each solid.
+ *
+ * @param stepText Raw STEP file content
+ * @returns Map<solidEntityId, [r, g, b]> where r,g,b are in 0..1 range
+ */
+export declare function parseStepColors(stepText: string): Map<number, [number, number, number]>;
+/**
+ * Parse STEP text and return the ordered list of solid entity IDs.
+ *
+ * This order should match OCCT's getSubShapes(compound, 'solid') order,
+ * because both iterate the compound's sub-shapes in the same order
+ * they appear in the STEP file.
+ *
+ * @param stepText - raw STEP file content
+ * @returns the ordered MANIFOLD_SOLID_BREP entity IDs
+ */
+export declare function parseStepSolidOrder(stepText: string): number[];
+/**
+ * Get colors for each solid in order.
+ *
+ * @param stepText Raw STEP file content
+ * @returns Array of colors [r,g,b] in 0..1, or null for solids without color.
+ *          Length matches the number of MANIFOLD_SOLID_BREP entities.
+ */
+export declare function getSolidColorsOrdered(stepText: string): ([number, number, number] | null)[];
+//# sourceMappingURL=stepColorParser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stepColorParser.d.ts","sourceRoot":"","sources":["../../src/occt-kernel/stepColorParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAA;CACf;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAsED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CA2BvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAS9D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,CAI3F"}

package/dist/occt-kernel/stepColorParser.js

@@ -0,0 +1,139 @@
+/**
+ * STEP 颜色解析器 — 从 STEP 文本中提取每个 solid 的颜色。
+ *
+ * STEP 文件中的颜色引用链：
+ *   STYLED_ITEM → PRESENTATION_STYLE_ASSIGNMENT → SURFACE_STYLE_USAGE
+ *   → SURFACE_SIDE_STYLE → SURFACE_STYLE_FILL_AREA → FILL_AREA_STYLE
+ *   → FILL_AREA_STYLE_COLOUR → COLOUR_RGB
+ *
+ * STYLED_ITEM 的第三个参数引用被着色的 shape entity（通常是 MANIFOLD_SOLID_BREP）。
+ * 我们解析这个引用链，建立 solid entity ID → color 的映射。
+ *
+ * 当 OCCT XCAF 的 getLabelInfo 返回 hasColor=false 时（颜色存储在 sub-shape 层级
+ * 而非 label 层级），此解析器作为后备方案提取颜色。
+ */
+/** Parse all entities from STEP text into a Map<id, StepEntity>. */
+function parseStepEntities(stepText) {
+    const entities = new Map();
+    // Match lines like: #123=ENTITY_TYPE(params);
+    // STEP entities can span multiple lines, but the closing ); is always at end
+    const regex = /#(\d+)\s*=\s*([A-Z_]+)\s*\(([^;]*)\)/g;
+    let match;
+    while ((match = regex.exec(stepText)) !== null) {
+        const id = parseInt(match[1], 10);
+        const type = match[2];
+        const params = match[3];
+        entities.set(id, { id, type, params });
+    }
+    return entities;
+}
+/** Extract all # references from a parameter string. Returns array of IDs. */
+function extractRefs(params) {
+    const refs = [];
+    const regex = /#(\d+)/g;
+    let match;
+    while ((match = regex.exec(params)) !== null) {
+        refs.push(parseInt(match[1], 10));
+    }
+    return refs;
+}
+/**
+ * Resolve the color reference chain starting from a STYLED_ITEM.
+ * Returns the COLOUR_RGB values if found, or null if the chain is broken.
+ */
+function resolveColorChain(entityId, entities, visited = new Set()) {
+    if (visited.has(entityId))
+        return null; // cycle guard
+    visited.add(entityId);
+    const entity = entities.get(entityId);
+    if (!entity)
+        return null;
+    if (entity.type === 'COLOUR_RGB') {
+        // Parse: 'name', r, g, b
+        const parts = entity.params.split(',');
+        // Color values start after the name (which may contain commas if quoted)
+        // Find the last 3 numeric values
+        const nums = [];
+        for (let i = parts.length - 1; i >= 0 && nums.length < 3; i--) {
+            const n = parseFloat(parts[i].trim());
+            if (!isNaN(n))
+                nums.unshift(n);
+        }
+        if (nums.length === 3) {
+            return [nums[0], nums[1], nums[2]];
+        }
+        return null;
+    }
+    // For all intermediate types, follow # references
+    const refs = extractRefs(entity.params);
+    for (const ref of refs) {
+        const color = resolveColorChain(ref, entities, visited);
+        if (color)
+            return color;
+    }
+    return null;
+}
+/**
+ * Parse STEP text and extract colors for each solid.
+ *
+ * @param stepText Raw STEP file content
+ * @returns Map<solidEntityId, [r, g, b]> where r,g,b are in 0..1 range
+ */
+export function parseStepColors(stepText) {
+    const entities = parseStepEntities(stepText);
+    const colorMap = new Map();
+    for (const [, entity] of entities) {
+        if (entity.type === 'STYLED_ITEM') {
+            // STYLED_ITEM('', (#styleRef), #shapeRef)
+            // The last # reference is the shape being styled
+            const refs = extractRefs(entity.params);
+            if (refs.length < 2)
+                continue;
+            const shapeRef = refs[refs.length - 1]; // last ref = styled shape
+            const styleRef = refs[0]; // first ref = presentation style
+            // Verify the shape ref is a MANIFOLD_SOLID_BREP (or ADVANCED_BREP_SHAPE_REPRESENTATION)
+            const shapeEntity = entities.get(shapeRef);
+            if (!shapeEntity)
+                continue;
+            // Resolve color from the style reference chain
+            const color = resolveColorChain(styleRef, entities);
+            if (color) {
+                colorMap.set(shapeRef, color);
+            }
+        }
+    }
+    return colorMap;
+}
+/**
+ * Parse STEP text and return the ordered list of solid entity IDs.
+ *
+ * This order should match OCCT's getSubShapes(compound, 'solid') order,
+ * because both iterate the compound's sub-shapes in the same order
+ * they appear in the STEP file.
+ *
+ * @param stepText - raw STEP file content
+ * @returns the ordered MANIFOLD_SOLID_BREP entity IDs
+ */
+export function parseStepSolidOrder(stepText) {
+    const entities = parseStepEntities(stepText);
+    const solids = [];
+    for (const [id, entity] of entities) {
+        if (entity.type === 'MANIFOLD_SOLID_BREP') {
+            solids.push(id);
+        }
+    }
+    return solids;
+}
+/**
+ * Get colors for each solid in order.
+ *
+ * @param stepText Raw STEP file content
+ * @returns Array of colors [r,g,b] in 0..1, or null for solids without color.
+ *          Length matches the number of MANIFOLD_SOLID_BREP entities.
+ */
+export function getSolidColorsOrdered(stepText) {
+    const colorMap = parseStepColors(stepText);
+    const solidOrder = parseStepSolidOrder(stepText);
+    return solidOrder.map(id => colorMap.get(id) ?? null);
+}
+//# sourceMappingURL=stepColorParser.js.map