Skip to content

v0.9.3 - Node 24 Compatibility Fix

Choose a tag to compare

@GlitterKill GlitterKill released this 24 Mar 02:08
· 460 commits to main since this release

Fix: Node 24 compatibility for tree-sitter native addon

Problem

Installing sdl-mcp on Node.js 24 failed during the tree-sitter native addon compilation:

v8config.h(13,1): error C1189: #error: "C++20 or later required."

The upstream tree-sitter 0.25.0 npm package forces /std:c++17 in its binding.gyp, but Node 24's V8 headers require C++20. The upstream package has not been updated to match the library's 0.26.x releases.

Fix

Switched to the @keqingmoe/tree-sitter community fork (v0.26.2) via npm alias. This fork includes the merged C++20 fix and compiles cleanly on Node 24.

Changes

  • package.json: alias tree-sitter to npm:@keqingmoe/tree-sitter@0.26.2
  • src/types/tree-sitter.d.ts: type shim to bridge the ambient module declaration

Notes

  • Zero source code changes — all existing imports continue to work unchanged
  • Same API surface — the fork is a drop-in replacement
  • Users on Node 22 are unaffected (both versions work on Node 22)
  • This is a patch release branched from v0.9.2; no other changes are included

Full Changelog: v0.9.2...v0.9.3