feat(types): drop Node 20, require Node >= 22

- Bump engines.node from >=20 to >=22
- Remove Node 20 from CI test matrix
- Bump native build Node from 20 to 22
- Replace old JS ESM loader hooks with 2 TypeScript hooks
  (ts-resolve-loader.ts + ts-resolve-hooks.ts) that resolve .js→.ts
  import specifiers at runtime
- Remove canStripTypes helper and version guards from tests
- Update src/index.cjs to import('./index.ts') for dev; build step
  produces dist/index.cjs with ./index.js for published package
- Simplify vitest.config.ts to use --experimental-strip-types only
- Update child-process test invocations to use --import loader flag
- Rewrite scripts/gen-deps.cjs as ESM TypeScript
- Rename scripts/build-wasm.js → .ts

Impact: 1 functions changed, 1 affected

Author: carlos-alm

.github/workflows/build-native.yml

@@ -60,7 +60,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 22
 
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable

.github/workflows/ci.yml

@@ -43,7 +43,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        node-version: [20, 22]
+        node-version: [22]
 
     runs-on: ${{ matrix.os }}
     name: Test Node ${{ matrix.node-version }} (${{ matrix.os }})

.github/workflows/publish.yml

@@ -142,7 +142,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version: 22
 
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable

package.json

@@ -26,23 +26,23 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "scripts": {
-    "build": "tsc",
-    "build:wasm": "node scripts/build-wasm.js",
+    "build": "tsc && node -e \"require('fs').writeFileSync('dist/index.cjs',require('fs').readFileSync('src/index.cjs','utf8').replace('./index.ts','./index.js'))\"",
+    "build:wasm": "node --experimental-strip-types scripts/build-wasm.ts",
     "typecheck": "tsc --noEmit",
     "verify-imports": "node --experimental-strip-types scripts/verify-imports.ts",
-    "test": "node scripts/test.js run",
-    "test:watch": "node scripts/test.js",
-    "test:coverage": "node scripts/test.js run --coverage",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "lint": "biome check src/ tests/",
     "lint:fix": "biome check --write src/ tests/",
     "format": "biome format --write src/ tests/",
     "prepack": "npm run build",
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true});require('fs').rmSync('.tsbuildinfo',{force:true})\"",
     "prepare": "npm run build:wasm && npm run build && husky && npm run deps:tree",
-    "deps:tree": "node scripts/gen-deps.cjs",
+    "deps:tree": "node --experimental-strip-types scripts/gen-deps.ts",
     "release": "commit-and-tag-version",
     "release:dry-run": "commit-and-tag-version --dry-run",
     "version": "node --experimental-strip-types scripts/sync-native-versions.ts && git add package.json crates/codegraph-core/Cargo.toml"

scripts/build-wasm.js scripts/build-wasm.tsscripts/build-wasm.js renamed to scripts/build-wasm.ts

@@ -1,18 +1,19 @@
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
+#!/usr/bin/env node
+import { execSync } from 'node:child_process';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 
-const outFile = path.join('generated', 'DEPENDENCIES.md');
-fs.mkdirSync(path.dirname(outFile), { recursive: true });
+const outFile = join('generated', 'DEPENDENCIES.md');
+mkdirSync(dirname(outFile), { recursive: true });
 
 try {
   const tree = execSync('npm ls --all --omit=dev', { encoding: 'utf8' });
-  fs.writeFileSync(outFile, '# Dependencies\n\n```\n' + tree + '```\n');
-} catch (err) {
+  writeFileSync(outFile, '# Dependencies\n\n```\n' + tree + '```\n');
+} catch (err: any) {
   // npm ls exits non-zero on ELSPROBLEMS (version mismatches in optional deps).
   // If stdout still has content, write it; otherwise skip silently.
   if (err.stdout) {
-    fs.writeFileSync(
+    writeFileSync(
       outFile,
       '# Dependencies\n\n```\n' + err.stdout + '```\n',
     );

scripts/gen-deps.cjs scripts/gen-deps.tsscripts/gen-deps.cjs renamed to scripts/gen-deps.ts

@@ -0,0 +1,28 @@
+/**
+ * ESM resolve hook — rewrites .js specifiers to .ts when the .js file
+ * does not exist on disk. Needed because TypeScript's moduleResolution
+ * "nodenext" convention uses .js extensions in imports, but at runtime
+ * the source files are .ts.
+ *
+ * Loaded via module.register() from ts-resolve-loader.ts.
+ */
+
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+export async function resolve(
+  specifier: string,
+  context: { parentURL?: string; conditions: string[] },
+  nextResolve: Function,
+): Promise<{ url: string; shortCircuit?: boolean }> {
+  try {
+    return await nextResolve(specifier, context);
+  } catch (err: any) {
+    // Only attempt .js → .ts fallback for file-relative specifiers
+    if (err?.code === 'ERR_MODULE_NOT_FOUND' && specifier.endsWith('.js')) {
+      const tsSpecifier = specifier.slice(0, -3) + '.ts';
+      return nextResolve(tsSpecifier, context);
+    }
+    throw err;
+  }
+}

scripts/ts-resolve-hooks.ts

@@ -0,0 +1,9 @@
+/**
+ * Registers the .js → .ts ESM resolve hook.
+ *
+ * Usage: node --experimental-strip-types --import ./scripts/ts-resolve-loader.ts src/cli.ts
+ */
+
+import { register } from 'node:module';
+
+register(new URL('./ts-resolve-hooks.ts', import.meta.url));

scripts/ts-resolve-loader.ts

@@ -13,4 +13,4 @@
 // Note: if import() rejects (e.g. missing dependency), the rejected Promise is cached
 // by the CJS module system and every subsequent require() call will re-surface the same
 // rejection without re-attempting the load.
-module.exports = import('./index.js');
+module.exports = import('./index.ts');