feat: add esm-register for node>20.6 (#748)

Author: yeliex

.gitignore

@@ -162,6 +162,9 @@ dist
 #/target
 Cargo.lock
 
+# idea
+.idea/
+
 *.node
 lib
 artifacts

README.md

@@ -17,7 +17,8 @@ Run TypeScript with node, without compilation or typechecking:
 ```bash
 npm i -D @swc-node/register
 node -r @swc-node/register script.ts
-node --loader @swc-node/register/esm script.ts # for esm project
+node --import @swc-node/register/esm-register script.ts # for esm project with node>=20.6
+node --loader @swc-node/register/esm script.ts # for esm project with node<=20.5, deprecated
 ```
 
 Set environment variable SWCRC=true when you would like to load .swcrc file
@@ -26,6 +27,14 @@ Set environment variable SWCRC=true when you would like to load .swcrc file
 SWCRC=true node -r @swc-node/register script.ts
 ```
 
+```typescript
+#!/usr/bin/env node --import swc-register-esm
+
+// your code
+```
+
+run with shebang, add `TS_NODE_PROJECT=null`(`#!/usr/bin/env TS_NODE_PROJECT=null node --import swc-register-esm`) to use ignore tsconfig.json
+
 ## @swc-node/core
 
 Fastest `TypeScript` transformer.

package.json

@@ -46,7 +46,7 @@
     "@types/babel__core": "^7.20.1",
     "@types/benchmark": "^2.1.2",
     "@types/lodash": "^4.14.197",
-    "@types/node": "^20.5.0",
+    "@types/node": "^20.11.0",
     "@types/sinon": "^10.0.16",
     "@typescript-eslint/eslint-plugin": "^6.4.0",
     "@typescript-eslint/parser": "^6.4.0",

packages/register/esm-register.mts

@@ -0,0 +1,4 @@
+import { register } from 'node:module'
+import { pathToFileURL } from 'node:url'
+
+register('@swc-node/register/esm', pathToFileURL('./').toString())

packages/register/package.json

@@ -75,6 +75,9 @@
     },
     "./esm": {
       "import": "./esm/esm.mjs"
+    },
+    "./esm-register": {
+      "import": "./esm/esm-register.mjs"
     }
   }
 }

packages/register/tsconfig.esm.json

@@ -5,5 +5,5 @@
     "outDir": "esm"
   },
   "include": [],
-  "files": ["./esm.mts", "register.d.ts", "./read-default-tsconfig.d.ts"]
+  "files": ["./esm.mts", "./esm-register.mts", "register.d.ts", "./read-default-tsconfig.d.ts"]
 }