occt-gltf-addon 0.1.0

package/CMakeLists.txt

@@ -0,0 +1,183 @@
+cmake_minimum_required(VERSION 3.16)
+
+project(occt_gltf_addon LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# --- Node / N-API via cmake-js ---
+# cmake-js provides:
+# - CMAKE_JS_INC: include dirs for Node headers
+# - CMAKE_JS_LIB: link library for Node
+if(NOT DEFINED CMAKE_JS_INC OR NOT DEFINED CMAKE_JS_LIB)
+  message(FATAL_ERROR "This project is intended to be built with cmake-js. Run: npm run build")
+endif()
+
+# node-addon-api include dir (header-only)
+execute_process(
+  COMMAND node -p "require('node-addon-api').include"
+  WORKING_DIRECTORY ${CMAKE_CURRENT_LIST_DIR}
+  OUTPUT_VARIABLE NODE_ADDON_API_DIR
+  OUTPUT_STRIP_TRAILING_WHITESPACE
+)
+# node-addon-api returns a quoted string; strip quotes if present
+string(REPLACE "\"" "" NODE_ADDON_API_DIR ${NODE_ADDON_API_DIR})
+
+# --- OCCT ---
+# You can override by exporting OCCT_ROOT=/path/to/your/occt/install-prefix
+if(DEFINED ENV{OCCT_ROOT} AND NOT "$ENV{OCCT_ROOT}" STREQUAL "")
+  set(OCCT_ROOT "$ENV{OCCT_ROOT}" CACHE PATH "OCCT install prefix" FORCE)
+else()
+  if(APPLE)
+    set(OCCT_ROOT "/opt/homebrew" CACHE PATH "OCCT install prefix (e.g. /opt/homebrew or /usr/local)")
+  else()
+    set(OCCT_ROOT "/usr" CACHE PATH "OCCT install prefix (e.g. /usr, /usr/local, or your custom install)")
+  endif()
+endif()
+
+find_path(OCCT_INCLUDE_DIR
+  NAMES Standard.hxx
+  PATHS
+    "${OCCT_ROOT}/include/opencascade"
+    "${OCCT_ROOT}/include"
+  NO_DEFAULT_PATH
+)
+if(NOT OCCT_INCLUDE_DIR)
+  message(FATAL_ERROR "OCCT headers not found. Expected Standard.hxx under ${OCCT_ROOT}/include/opencascade. Set -DOCCT_ROOT=...")
+endif()
+
+set(_OCCT_LIBDIRS
+  "${OCCT_ROOT}/lib"
+  "${OCCT_ROOT}/lib64"
+  "${OCCT_ROOT}/lib/x86_64-linux-gnu"
+  "${OCCT_ROOT}/lib/aarch64-linux-gnu"
+  "${OCCT_ROOT}/lib/arm64-linux-gnu"
+)
+
+function(_occt_find_lib outvar name)
+  find_library(${outvar}
+    NAMES ${name}
+    PATHS ${_OCCT_LIBDIRS}
+    NO_DEFAULT_PATH
+  )
+  if(NOT ${outvar})
+    message(FATAL_ERROR "OCCT library ${name} not found under ${OCCT_ROOT}. Set OCCT_ROOT=/path/to/occt.")
+  endif()
+endfunction()
+
+# Find one of multiple possible toolkit names (OCCT version differences).
+function(_occt_find_lib_any outvar)
+  set(_names ${ARGN})
+  find_library(${outvar}
+    NAMES ${_names}
+    PATHS ${_OCCT_LIBDIRS}
+    NO_DEFAULT_PATH
+  )
+  if(NOT ${outvar})
+    string(JOIN ", " _namesStr ${_names})
+    message(FATAL_ERROR "OCCT library not found. Tried: ${_namesStr} under ${OCCT_ROOT}. Set OCCT_ROOT=/path/to/occt.")
+  endif()
+endfunction()
+
+# Minimal set for STEP reading + meshing + topology
+_occt_find_lib(OCCT_TKernel TKernel)
+_occt_find_lib(OCCT_TKMath TKMath)
+_occt_find_lib(OCCT_TKG2d TKG2d)
+_occt_find_lib(OCCT_TKG3d TKG3d)
+_occt_find_lib(OCCT_TKGeomBase TKGeomBase)
+_occt_find_lib(OCCT_TKBRep TKBRep)
+_occt_find_lib(OCCT_TKTopAlgo TKTopAlgo)
+_occt_find_lib(OCCT_TKMesh TKMesh)
+_occt_find_lib(OCCT_TKXSBase TKXSBase)
+
+# OCCT 8.x puts STEPControl_Reader into TKDESTEP; older OCCT uses TKSTEP (+ STEPBase/STEPAttr).
+_occt_find_lib_any(OCCT_TKSTEP_LIKE TKDESTEP TKSTEP)
+
+# XDE / OCAF toolkits for STEPCAFControl_Reader + document/labels/names
+_occt_find_lib(OCCT_TKCDF TKCDF)
+_occt_find_lib(OCCT_TKLCAF TKLCAF)
+_occt_find_lib(OCCT_TKCAF TKCAF)
+_occt_find_lib(OCCT_TKXCAF TKXCAF)
+
+add_library(${PROJECT_NAME} SHARED
+  src/addon.cpp
+  src/convert_worker.cpp
+  src/occt_convert_xde.cpp
+  src/gltf_writer_scene.cpp
+)
+
+# --- Optional: Draco (KHR_draco_mesh_compression) ---
+option(OCCT_GLTF_ADDON_ENABLE_DRACO "Enable Draco mesh compression support" ON)
+if(OCCT_GLTF_ADDON_ENABLE_DRACO)
+  if(DEFINED ENV{DRACO_ROOT} AND NOT "$ENV{DRACO_ROOT}" STREQUAL "")
+    set(DRACO_ROOT "$ENV{DRACO_ROOT}" CACHE PATH "Draco install prefix" FORCE)
+  else()
+    set(DRACO_ROOT "" CACHE PATH "Draco install prefix (optional)")
+  endif()
+
+  find_path(DRACO_INCLUDE_DIR
+    NAMES draco/compression/encode.h
+    PATHS
+      "${DRACO_ROOT}/include"
+      "/usr/include"
+      "/opt/homebrew/include"
+      "/usr/local/include"
+  )
+  find_library(DRACO_LIBRARY
+    NAMES draco
+    PATHS
+      "${DRACO_ROOT}/lib"
+      "/usr/lib"
+      "/usr/lib/x86_64-linux-gnu"
+      "/opt/homebrew/lib"
+      "/usr/local/lib"
+  )
+
+  if(DRACO_INCLUDE_DIR AND DRACO_LIBRARY)
+    message(STATUS "Draco enabled: ${DRACO_LIBRARY}")
+    target_include_directories(${PROJECT_NAME} PRIVATE ${DRACO_INCLUDE_DIR})
+    target_link_libraries(${PROJECT_NAME} PRIVATE ${DRACO_LIBRARY})
+    target_compile_definitions(${PROJECT_NAME} PRIVATE OCCT_GLTF_WITH_DRACO=1)
+  else()
+    message(STATUS "Draco not found; building without Draco support. Install via 'brew install draco' or set DRACO_ROOT.")
+  endif()
+endif()
+
+target_include_directories(${PROJECT_NAME} PRIVATE
+  ${CMAKE_JS_INC}
+  ${NODE_ADDON_API_DIR}
+  ${OCCT_INCLUDE_DIR}
+  ${CMAKE_CURRENT_LIST_DIR}/src
+)
+
+target_compile_definitions(${PROJECT_NAME} PRIVATE
+  NAPI_CPP_EXCEPTIONS
+)
+
+target_link_libraries(${PROJECT_NAME} PRIVATE
+  ${CMAKE_JS_LIB}
+  ${OCCT_TKXSBase}
+  ${OCCT_TKSTEP_LIKE}
+  ${OCCT_TKXCAF}
+  ${OCCT_TKCAF}
+  ${OCCT_TKLCAF}
+  ${OCCT_TKCDF}
+  ${OCCT_TKMesh}
+  ${OCCT_TKTopAlgo}
+  ${OCCT_TKBRep}
+  ${OCCT_TKGeomBase}
+  ${OCCT_TKG3d}
+  ${OCCT_TKG2d}
+  ${OCCT_TKMath}
+  ${OCCT_TKernel}
+)
+
+# Ensure the loaded addon can locate OCCT dylibs at runtime.
+set_target_properties(${PROJECT_NAME} PROPERTIES
+  PREFIX ""
+  SUFFIX ".node"
+  BUILD_RPATH "${_OCCT_LIBDIRS}"
+  INSTALL_RPATH "${_OCCT_LIBDIRS}"
+)
+

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,74 @@
+### occt-gltf-addon
+
+Node.js N-API 原生扩展：使用 OpenCascade (OCCT) 将 **STEP (.step/.stp)** 转换为 **glTF 2.0 (GLB)**。
+
+#### 安装（从 npm 安装会本地编译）
+
+这个包默认会在 `npm install` 时执行本地编译（`cmake-js`）。
+
+你需要：
+- **CMake + C++ 编译器 + Python3**
+- **OCCT 安装**（共享库 + headers）
+
+通过环境变量指定 OCCT 安装前缀：
+
+```bash
+export OCCT_ROOT=/path/to/occt/prefix
+npm i occt-gltf-addon
+```
+
+可选（启用 Draco 压缩需要开发包）：
+- `brew install draco` / `apt-get install libdraco-dev`
+
+如需跳过编译（不推荐，运行时会找不到 `.node`）：
+
+```bash
+OCCT_GLTF_ADDON_SKIP_BUILD=1 npm i occt-gltf-addon
+```
+
+---
+
+#### API
+
+```js
+const { convertSTEPToGLTF } = require('occt-gltf-addon');
+
+await convertSTEPToGLTF({
+  inputPath: '/abs/in.step',
+  outputPath: '/abs/out.glb',
+  tessellation: { linearDeflection: 0.1, angularDeflection: 0.5 },
+});
+```
+
+支持一次调用输出多个变体（只做一次 STEP read + XDE transfer）：
+
+```js
+await convertSTEPToGLTF({
+  inputPath,
+  logLevel: 'info',
+  variants: [
+    { outputPath: 'out.min.glb', tessellation: { linearDeflection: 5, angularDeflection: Math.PI/3 } },
+    { outputPath: 'out.glb',     tessellation: { linearDeflection: 0.1, angularDeflection: 0.5 } },
+  ],
+});
+```
+
+---
+
+#### 关键选项说明（简版）
+
+- **tessellation.linearDeflection / angularDeflection**：B-Rep 三角化精度
+- **tessellation.smoothNormals / normalCreaseAngle**：平滑法线（默认开，60° crease）
+- **filter.minBBoxDiagonal**：按包围盒对角线过滤小零件（单位为 STEP/OCCT 导入后的单位，通常 mm）
+- **output.unit**：`'m'|'cm'|'mm'`（默认导出为米）
+- **output.bakeTransforms**：把节点变换烘焙进顶点并把 node matrix 归零（类似 Blender Apply）
+- **output.center**：`'none'|'xy'|'xz'|'yz'`（配合 bake 使用；Y-up 时 `xz` 会 ground 到 `minY=0`；Z-up 时 `xy` 会 ground 到 `minZ=0`）
+- **output.zUp**：导出为 **Z-up 坐标**（适配 three.js `THREE.Object3D.DEFAULT_UP.set(0,0,1)`）；注意这会变成 **非标准 glTF（标准是 Y-up）**
+- **output.draco**：启用 `KHR_draco_mesh_compression`（部分导入器不支持）
+
+---
+
+#### License
+
+本 addon 代码以 MIT 发布；运行时依赖 OCCT（LGPL 2.1）与可选 Draco（Apache 2.0）。
+

package/example.js

@@ -0,0 +1,81 @@
+const path = require('path');
+const { convertSTEPToGLTF } = require('./index');
+
+function ensureGlbExt(p) {
+  const parsed = path.parse(p);
+  if (!parsed.ext) return `${p}.glb`;
+  return p;
+}
+
+async function main() {
+  const inputPath = process.argv[2];
+  if (!inputPath) {
+    console.error('Usage: node example.js <input.step> [output.glb]');
+    console.error('  It will write 2 files: <output>.min.glb and <output>.glb');
+    process.exit(1);
+  }
+  const outputPathArg = process.argv[3] || path.join(process.cwd(), 'out.glb');
+  const outputPath = ensureGlbExt(outputPathArg);
+  const parsed = path.parse(outputPath);
+  const outputPathMin = path.join(parsed.dir, `${parsed.name}.min${parsed.ext}`);
+
+  // “正常”参数：你可以在这里调整成你想要的默认精度
+  const tessNormal = {
+    linearDeflection: 0.1,
+    angularDeflection: 0.5,
+  };
+
+  // “极简”参数：基于正常参数做粗化（更少三角面，更快）
+  const tessMin = {
+    linearDeflection: 5,
+    angularDeflection: Math.PI / 3,
+  };
+  const filterMin = { 
+    minBBoxDiagonal: 60 
+  };
+  const outputOpts = {
+    unit: 'm',
+    bakeTransforms: true,
+    center: 'xy', // 'none' | 'xy' | 'xz' | 'yz'
+    // If your runtime uses Z-up world (e.g. three.js: THREE.Object3D.DEFAULT_UP.set(0,0,1)),
+    // enable this to export Z-up coordinates (note: non-standard glTF; Y-up viewers may show it rotated).
+    zUp: true,
+    // Draco (KHR_draco_mesh_compression). NOTE: some importers (e.g. Blender) may not support Draco.
+    // draco: { enabled: true, compressionLevel: 7, quantizationBitsPosition: 14, quantizationBitsNormal: 10 },
+    draco: {
+      enabled: true,
+      compressionLevel: 7,           // 0..10 (越大越小/越慢)
+      quantizationBitsPosition: 14,  // 1..30
+      quantizationBitsNormal: 10,    // 1..30
+    }
+  };
+
+  console.log('Writing (min):', outputPathMin);
+  console.log('Writing (normal):', outputPath);
+  await convertSTEPToGLTF({
+    inputPath,
+    logLevel: 'info', // 'quiet' | 'info' | 'debug'
+    variants: [
+      {
+        outputPath: outputPathMin,
+        tessellation: tessMin,
+        filter: filterMin,
+        output: outputOpts,
+      },
+      {
+        outputPath,
+        tessellation: tessNormal,
+        output: outputOpts,
+      },
+    ],
+  });
+
+  console.log('Wrote:', outputPathMin);
+  console.log('Wrote:', outputPath);
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});
+

package/index.d.ts

@@ -0,0 +1,71 @@
+export as namespace OcctGltfAddon;
+export = OcctGltfAddon;
+
+declare namespace OcctGltfAddon {
+  type LogLevel = 0 | 1 | 2 | 'quiet' | 'info' | 'debug';
+
+  interface TessellationOptions {
+    linearDeflection?: number;
+    angularDeflection?: number; // radians
+    smoothNormals?: boolean;
+    normalCreaseAngle?: number; // radians
+  }
+
+  interface FilterOptions {
+    minBBoxDiagonal?: number;
+  }
+
+  type OutputUnit = 'm' | 'cm' | 'mm';
+  type CenterMode = 'none' | 'xy' | 'xz' | 'yz';
+
+  interface DracoOptions {
+    enabled?: boolean;
+    compressionLevel?: number; // 0..10
+    quantizationBitsPosition?: number; // 1..30
+    quantizationBitsNormal?: number; // 1..30
+  }
+
+  interface OutputOptions {
+    unit?: OutputUnit;
+    unitScale?: number;
+
+    bakeTransforms?: boolean;
+    center?: CenterMode;
+    // legacy booleans
+    centerXY?: boolean;
+    centerXZ?: boolean;
+    centerYZ?: boolean;
+
+    // Export Z-up coordinates (useful for three.js Z-up worlds). Non-standard glTF.
+    zUp?: boolean;
+    zup?: boolean;
+
+    // KHR_draco_mesh_compression
+    draco?: boolean | DracoOptions;
+  }
+
+  interface VariantOptions {
+    outputPath: string;
+    tessellation?: TessellationOptions;
+    filter?: FilterOptions;
+    output?: OutputOptions;
+  }
+
+  interface ConvertOptions {
+    inputPath: string;
+
+    // Single-output mode
+    outputPath?: string;
+    tessellation?: TessellationOptions;
+    filter?: FilterOptions;
+    output?: OutputOptions;
+
+    // Multi-output mode
+    variants?: VariantOptions[];
+
+    logLevel?: LogLevel;
+  }
+
+  function convertSTEPToGLTF(options: ConvertOptions): Promise<void>;
+}
+

package/index.js

@@ -0,0 +1,52 @@
+// CommonJS entrypoint. cmake-js outputs: build/<Config>/<target>.node
+const fs = require('fs');
+const path = require('path');
+
+// Prefer prebuilt, platform-specific package when available (fast install, no local compile).
+if (!process.env.OCCT_GLTF_ADDON_BINDING_PATH) {
+  try {
+    if (process.platform === 'linux' && process.arch === 'x64') {
+      // eslint-disable-next-line import/no-dynamic-require, global-require
+      module.exports = require('occt-gltf-addon-linux-x64');
+      return;
+    }
+  } catch (e) {
+    // ignore and fall back to local build output
+  }
+}
+
+const overridePath = process.env.OCCT_GLTF_ADDON_BINDING_PATH;
+const candidates = overridePath
+  ? [overridePath]
+  : [
+      path.join(__dirname, 'build', 'Release', 'occt_gltf_addon.node'),
+      path.join(__dirname, 'build', 'RelWithDebInfo', 'occt_gltf_addon.node'),
+      path.join(__dirname, 'build', 'Debug', 'occt_gltf_addon.node'),
+    ];
+
+let lastErr = null;
+for (const p of candidates) {
+  try {
+    if (!fs.existsSync(p)) continue;
+    // eslint-disable-next-line import/no-dynamic-require, global-require
+    module.exports = require(p);
+    return;
+  } catch (e) {
+    lastErr = e;
+  }
+}
+
+const msg = [
+  '[occt-gltf-addon] Failed to load native addon (.node).',
+  `Tried: ${candidates.map((p) => JSON.stringify(p)).join(', ')}`,
+  '',
+  'If you installed from npm, ensure native build succeeded:',
+  '- CMake + C++ toolchain are installed',
+  "- OCCT is installed and OCCT_ROOT points to its install prefix (e.g. '/opt/homebrew', '/usr', '/usr/local', or your custom install)",
+  '',
+  "You can try: 'npm rebuild occt-gltf-addon' (with OCCT_ROOT exported).",
+].join('\n');
+
+// Preserve original error for debugging.
+throw new Error(`${msg}\n\n${String(lastErr && (lastErr.stack || lastErr.message || lastErr))}`);
+

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "occt-gltf-addon",
+  "version": "0.1.0",
+  "description": "STEP (.step/.stp) to glTF (GLB) converter using OpenCascade (OCCT) via a Node.js N-API addon",
+  "type": "commonjs",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Open-Cascade-SAS/OCCT.git",
+    "directory": "occt-gltf-addon"
+  },
+  "bugs": {
+    "url": "https://github.com/Open-Cascade-SAS/OCCT/issues"
+  },
+  "homepage": "https://github.com/Open-Cascade-SAS/OCCT/tree/master/occt-gltf-addon",
+  "keywords": [
+    "occt",
+    "opencascade",
+    "step",
+    "stp",
+    "gltf",
+    "glb",
+    "cad",
+    "napi",
+    "node-addon-api",
+    "addon"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "files": [
+    "index.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE",
+    "CMakeLists.txt",
+    "src/**",
+    "scripts/**",
+    "example.js"
+  ],
+  "scripts": {
+    "install": "node scripts/install.js",
+    "build": "cmake-js compile -O build",
+    "clean": "rm -rf build",
+    "rebuild": "npm run clean && npm run build",
+    "example": "node example.js",
+    "test": "node -e \"console.log('no tests')\"",
+
+    "docker:build:linux-amd64": "bash docker/build-linux-amd64.sh",
+    "docker:image:linux-amd64": "docker buildx build --platform linux/amd64 -f docker/Dockerfile.linux-amd64 -t occt-addon-build:linux-amd64 ../..",
+    "docker:image:linux-amd64:nocache": "docker buildx build --no-cache --platform linux/amd64 -f docker/Dockerfile.linux-amd64 -t occt-addon-build:linux-amd64 ../.."
+  },
+  "optionalDependencies": {
+    "occt-gltf-addon-linux-x64": "0.1.0"
+  },
+  "dependencies": {
+    "cmake-js": "^7.3.1",
+    "node-addon-api": "^7.1.0"
+  }
+}
+

package/scripts/install.js

@@ -0,0 +1,79 @@
+/* eslint-disable no-console */
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+function run(cmd, args, opts) {
+  const r = spawnSync(cmd, args, { stdio: 'inherit', ...opts });
+  if (r.error) throw r.error;
+  if (r.status !== 0) {
+    const e = new Error(`${cmd} exited with code ${r.status}`);
+    e.code = r.status;
+    throw e;
+  }
+}
+
+function note(msg) {
+  console.error(`[occt-gltf-addon] ${msg}`);
+}
+
+function main() {
+  if (process.env.OCCT_GLTF_ADDON_SKIP_BUILD === '1') {
+    note('Skipping native build (OCCT_GLTF_ADDON_SKIP_BUILD=1).');
+    return;
+  }
+
+  if (process.platform === 'win32') {
+    note('Windows is not supported by this package at the moment.');
+    process.exit(1);
+  }
+
+  const pkgRoot = path.join(__dirname, '..');
+
+  // If a platform-specific prebuilt package is installed and loadable, skip building from source.
+  // This avoids expensive compilation during "npm install".
+  const prebuiltName =
+    process.platform === 'linux' && process.arch === 'x64'
+      ? 'occt-gltf-addon-linux-x64'
+      : null;
+  if (prebuiltName) {
+    try {
+      // eslint-disable-next-line import/no-dynamic-require, global-require
+      require(prebuiltName);
+      note(`Using prebuilt binary from ${prebuiltName}; skipping local build.`);
+      return;
+    } catch (e) {
+      // Prebuilt missing or not loadable (e.g. GLIBC mismatch). Fall back to local build.
+      note(`Prebuilt package ${prebuiltName} not usable; falling back to local build.`);
+    }
+  }
+
+  // Helpful hint for first-time users.
+  if (!process.env.OCCT_ROOT) {
+    note("OCCT_ROOT is not set. If build fails, set OCCT_ROOT to your OCCT install prefix (e.g. '/opt/homebrew', '/usr', '/usr/local', or your custom install).");
+  }
+
+  // Use the locally installed cmake-js (dependency).
+  const cmakeJsBin = path.join(pkgRoot, 'node_modules', '.bin', process.platform === 'win32' ? 'cmake-js.cmd' : 'cmake-js');
+  if (!fs.existsSync(cmakeJsBin)) {
+    note(`cmake-js not found at ${cmakeJsBin}. Try: 'npm install' again.`);
+    process.exit(1);
+  }
+
+  note('Building native addon with cmake-js...');
+  run(cmakeJsBin, ['compile', '-O', 'build'], { cwd: pkgRoot, env: process.env });
+}
+
+try {
+  main();
+} catch (e) {
+  note('Native build failed.');
+  note(String(e && (e.stack || e.message || e)));
+  note('Troubleshooting:');
+  note('- Ensure you have a C++ toolchain + CMake installed');
+  note('- Ensure OCCT is installed and OCCT_ROOT points to its prefix');
+  note('- On macOS (Apple Silicon): Homebrew OCCT is typically under /opt/homebrew');
+  note("- To skip building (not recommended): set OCCT_GLTF_ADDON_SKIP_BUILD=1");
+  process.exit(1);
+}
+