nodejs · github-actions · Jun 9, 2025 · Jun 9, 2025 · Jun 9, 2025 · Jun 9, 2025
diff --git a/.github/workflows/commit-queue.yml b/.github/workflows/commit-queue.yml
@@ -1,6 +1,6 @@
 # This action requires the following secrets to be set on the repository:
-#   GH_USER_NAME: GitHub user whose Jenkins and GitHub token are defined below
 #   GH_USER_TOKEN: GitHub user token, to be used by ncu and to push changes
+#   JENKINS_USER: GitHub user whose Jenkins token is defined below
 #   JENKINS_TOKEN: Jenkins token, to be used to check CI status
 
 name: Commit Queue
@@ -34,24 +34,24 @@ jobs:
         id: get_mergeable_prs
         run: |
           prs=$(gh pr list \
-                  --repo ${{ github.repository }} \
-                  --base ${{ github.ref_name }} \
+                  --repo "$GITHUB_REPOSITORY" \
+                  --base "$GITHUB_REF_NAME" \
                   --label 'commit-queue' \
                   --json 'number' \
                   --search "created:<=$(date --date="2 days ago"  +"%Y-%m-%dT%H:%M:%S%z") -label:blocked" \
                   -t '{{ range . }}{{ .number }} {{ end }}' \
                   --limit 100)
           fast_track_prs=$(gh pr list \
-                  --repo ${{ github.repository }} \
-                  --base ${{ github.ref_name }} \
+                  --repo "$GITHUB_REPOSITORY" \
+                  --base "$GITHUB_REF_NAME" \
                   --label 'commit-queue' \
                   --label 'fast-track' \
                   --search "-label:blocked" \
                   --json 'number' \
                   -t '{{ range . }}{{ .number }} {{ end }}' \
                   --limit 100)
           numbers=$(echo $prs' '$fast_track_prs | jq -r -s 'unique | join(" ")')
-          echo "numbers=$numbers" >> $GITHUB_OUTPUT
+          echo "numbers=$numbers" >> "$GITHUB_OUTPUT"
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
   commitQueue:
@@ -61,9 +61,6 @@ jobs:
     steps:
       - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683  # v4.2.2
         with:
-          # Needs the whole git history for ncu to work
-          # See https://github.com/nodejs/node-core-utils/pull/486
-          fetch-depth: 0
           # A personal token is required because pushing with GITHUB_TOKEN will
           # prevent commits from running CI after they land. It needs
           # to be set here because `checkout` configures GitHub authentication
@@ -80,24 +77,23 @@ jobs:
 
       - name: Set variables
         run: |
-          echo "REPOSITORY=$(echo ${{ github.repository }} | cut -d/ -f2)" >> $GITHUB_ENV
-          echo "OWNER=${{ github.repository_owner }}" >> $GITHUB_ENV
+          echo "REPOSITORY=$(echo "$GITHUB_REPOSITORY" | cut -d/ -f2)" >> "$GITHUB_ENV"
 
       - name: Configure @node-core/utils
         run: |
-          ncu-config set branch ${GITHUB_REF_NAME}
+          ncu-config set branch "${GITHUB_REF_NAME}"
           ncu-config set upstream origin
           ncu-config set username "$USERNAME"
-          ncu-config set token "$GH_TOKEN"
+          ncu-config set token "$GITHUB_TOKEN"
           ncu-config set jenkins_token "$JENKINS_TOKEN"
           ncu-config set repo "${REPOSITORY}"
-          ncu-config set owner "${OWNER}"
+          ncu-config set owner "${GITHUB_REPOSITORY_OWNER}"
         env:
           USERNAME: ${{ secrets.JENKINS_USER }}
-          GH_TOKEN: ${{ secrets.GH_USER_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GH_USER_TOKEN }}
           JENKINS_TOKEN: ${{ secrets.JENKINS_TOKEN }}
 
       - name: Start the Commit Queue
-        run: ./tools/actions/commit-queue.sh ${{ env.OWNER }} ${{ env.REPOSITORY }} ${{ needs.get_mergeable_prs.outputs.numbers }}
+        run: ./tools/actions/commit-queue.sh "${GITHUB_REPOSITORY_OWNER}" "${REPOSITORY}" ${{ needs.get_mergeable_prs.outputs.numbers }}
         env:
           GITHUB_TOKEN: ${{ secrets.GH_USER_TOKEN }}
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -40,7 +40,8 @@ release.
 </tr>
 <tr>
   <td valign="top">
-<b><a href="doc/changelogs/CHANGELOG_V24.md#24.2.0">24.2.0</a></b><br/>
+<b><a href="doc/changelogs/CHANGELOG_V24.md#24.3.0">24.3.0</a></b><br/>
+<a href="doc/changelogs/CHANGELOG_V24.md#24.2.0">24.2.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V24.md#24.1.0">24.1.0</a><br/>
 <a href="doc/changelogs/CHANGELOG_V24.md#24.0.2">24.0.2</a><br/>
 <a href="doc/changelogs/CHANGELOG_V24.md#24.0.1">24.0.1</a><br/>

diff --git a/LICENSE b/LICENSE
@@ -1545,9 +1545,9 @@ The externally maintained libraries used by Node.js are:
 - zlib, located at deps/zlib, is licensed as follows:
   """
     zlib.h -- interface of the 'zlib' general purpose compression library
-    version 1.3.0.1, August xxth, 2023
+    version 1.3.1, January 22nd, 2024
 
-    Copyright (C) 1995-2023 Jean-loup Gailly and Mark Adler
+    Copyright (C) 1995-2024 Jean-loup Gailly and Mark Adler
 
     This software is provided 'as-is', without any express or implied
     warranty.  In no event will the authors be held liable for any damages

diff --git a/Makefile b/Makefile
@@ -220,7 +220,7 @@ testclean: ## Remove test artifacts.
 distclean: ## Remove all build and test artifacts.
 	$(RM) -r out
 	$(RM) config.gypi icu_config.gypi
-	$(RM) config.mk
+	$(RM) config.mk config.status
 	$(RM) -r $(NODE_EXE) $(NODE_G_EXE)
 	$(RM) -r node_modules
 	$(RM) -r deps/icu

diff --git a/README.md b/README.md
@@ -355,6 +355,8 @@ For information about the governance of the Node.js project, see
   **Harshitha K P** <<harshitha014@gmail.com>> (she/her)
 * [himself65](https://github.com/himself65) -
   **Zeyu "Alex" Yang** <<himself65@outlook.com>> (he/him)
+* [islandryu](https://github.com/islandryu) -
+  **Ryuhei Shima** <<shimaryuhei@gmail.com>> (he/him)
 * [jakecastelli](https://github.com/jakecastelli) -
   **Jake Yuesong Li** <<jake.yuesong@gmail.com>> (he/him)
 * [JakobJingleheimer](https://github.com/JakobJingleheimer) -

diff --git a/common.gypi b/common.gypi
@@ -38,7 +38,7 @@
 
     # Reset this number to 0 on major V8 upgrades.
     # Increment by one for each non-official patch applied to deps/v8.
-    'v8_embedder_string': '-node.17',
+    'v8_embedder_string': '-node.18',
 
     ##### V8 defaults for Node.js #####
 

diff --git a/deps/amaro/README.md b/deps/amaro/README.md
@@ -1,11 +1,12 @@
 # Amaro
 
 Amaro is a wrapper around `@swc/wasm-typescript`, a WebAssembly port of the SWC TypeScript parser.
-It's currently used as an internal in Node.js for [Type Stripping](https://github.com/nodejs/loaders/issues/208), but in the future it will be possible to be upgraded separately by users.
-The main goal of this package is to provide a stable API for TypeScript parser, which is unstable and subject to change.
+It's used as an internal in Node.js for [Type Stripping](https://nodejs.org/api/typescript.html#type-stripping) but can also be used as a standalone package.
 
 > Amaro means "bitter" in Italian. It's a reference to [Mount Amaro](https://en.wikipedia.org/wiki/Monte_Amaro_(Abruzzo)) on whose slopes this package was conceived.
 
+This package provides a stable API for the TypeScript parser and allows users to upgrade to the latest version of TypeScript transpiler independently from the one used internally in Node.js.
+
 ## How to Install
 
 To install Amaro, run:
@@ -31,25 +32,48 @@ It is possible to use Amaro as an external loader to execute TypeScript files.
 This allows the installed Amaro to override the Amaro version used by Node.js.
 In order to use Amaro as an external loader, type stripping needs to be enabled.
 
-```bash
-node --experimental-strip-types --import="amaro/register" script.ts
-```
-
-Or with the alias:
+In node v23 and later you can omit the `--experimental-strip-types` flag, as it is enabled by default.
 
 ```bash
-node --experimental-strip-types --import="amaro/strip" script.ts
+node --experimental-strip-types --import="amaro/strip" file.ts
 ```
 
 Enabling TypeScript feature transformation:
 
 ```bash
-node --experimental-transform-types --import="amaro/transform" script.ts
+node --experimental-transform-types --import="amaro/transform" file.ts
 ```
 
 > Note that the "amaro/transform" loader should be used with `--experimental-transform-types` flag, or
 > at least with `--enable-source-maps` flag, to preserve the original source maps.
 
+#### Type stripping in dependencies
+
+Contrary to the Node.js [TypeScript support](https://nodejs.org/docs/latest/api/typescript.html#type-stripping-in-dependencies), when used as a loader, Amaro handles TypeScript files inside folders under a `node_modules` path.
+
+### Monorepo usage
+
+Amaro makes working in monorepos smoother by removing the need to rebuild internal packages during development. When used with the [`--conditions`](https://nodejs.org/docs/latest/api/cli.html#-c-condition---conditionscondition) flag, you can reference TypeScript source files directly in exports:
+
+```json
+"exports": {
+  ".": {
+    "typescript": "./src/index.ts",
+    "types": "./dist/index.d.ts",
+    "require": "./dist/index.js",
+    "import": "./dist/index.js"
+ }
+}
+```
+
+Then run your app with:
+
+```bash
+node --watch --import="amaro/strip" --conditions=typescript ./src/index.ts
+```
+
+This setup allows Node.js to load TypeScript files from linked packages without a build step. Changes to any package are picked up immediately, speeding up and simplifying local development in monorepos.
+
 ### TypeScript Version
 
 The supported TypeScript version is 5.8.

diff --git a/deps/amaro/dist/errors.d.ts b/deps/amaro/dist/errors.d.ts
@@ -0,0 +1,13 @@
+type SwcError = {
+    code: "UnsupportedSyntax" | "InvalidSyntax";
+    message: string;
+    startColumn: number;
+    startLine: number;
+    snippet: string;
+    filename: string;
+    endColumn: number;
+    endLine: number;
+};
+export declare function isSwcError(error: unknown): error is SwcError;
+export declare function wrapAndReThrowSwcError(error: SwcError): never;
+export {};
diff --git a/deps/amaro/dist/index.d.ts b/deps/amaro/dist/index.d.ts
@@ -0,0 +1 @@
+export { transformSync } from "./transform.ts";
diff --git a/deps/amaro/dist/index.js b/deps/amaro/dist/index.js
diff --git a/deps/amaro/dist/package.json b/deps/amaro/dist/package.json
@@ -4,7 +4,7 @@
     "강동윤 <kdy1997.dev@gmail.com>"
   ],
   "description": "wasm module for swc",
-  "version": "1.11.24",
+  "version": "1.12.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",

diff --git a/deps/amaro/dist/strip-loader.d.ts b/deps/amaro/dist/strip-loader.d.ts
@@ -0,0 +1,2 @@
+import type { LoadFnOutput, LoadHookContext } from "node:module";
+export declare function load(url: string, context: LoadHookContext, nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput | Promise<LoadFnOutput>): Promise<LoadFnOutput>;
diff --git a/deps/amaro/dist/transform-loader.d.ts b/deps/amaro/dist/transform-loader.d.ts
@@ -0,0 +1,2 @@
+import type { LoadFnOutput, LoadHookContext } from "node:module";
+export declare function load(url: string, context: LoadHookContext, nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput | Promise<LoadFnOutput>): Promise<LoadFnOutput>;
diff --git a/deps/amaro/dist/transform.d.ts b/deps/amaro/dist/transform.d.ts
@@ -0,0 +1,2 @@
+import type { Options, TransformOutput } from "../lib/wasm";
+export declare function transformSync(source: string, options?: Options): TransformOutput;
diff --git a/deps/amaro/lib/wasm.d.ts b/deps/amaro/lib/wasm.d.ts
@@ -0,0 +1,59 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export declare function transform(src: string | Uint8Array, opts?: Options): Promise<TransformOutput>;
+export declare function transformSync(src: string | Uint8Array, opts?: Options): TransformOutput;
+export type { Options, TransformOutput };
+
+
+
+interface Options {
+    module?: boolean;
+    filename?: string;
+    mode?: Mode;
+    transform?: TransformConfig;
+    deprecatedTsModuleAsError?: boolean;
+    sourceMap?: boolean;
+}
+
+interface TransformConfig {
+    /**
+     * @see https://www.typescriptlang.org/tsconfig#verbatimModuleSyntax
+     */
+    verbatimModuleSyntax?: boolean;
+    /**
+     * Native class properties support
+     */
+    nativeClassProperties?: boolean;
+    importNotUsedAsValues?: "remove" | "preserve";
+    /**
+     * Don't create `export {}`.
+     * By default, strip creates `export {}` for modules to preserve module
+     * context.
+     * 
+     * @see https://github.com/swc-project/swc/issues/1698
+     */
+    noEmptyExport?: boolean;
+    importExportAssignConfig?: "Classic" | "Preserve" | "NodeNext" | "EsNext";
+    /**
+     * Disables an optimization that inlines TS enum member values
+     * within the same module that assumes the enum member values
+     * are never modified.
+     * 
+     * Defaults to false.
+     */
+    tsEnumIsMutable?: boolean;
+}
+
+
+
+type Mode = "strip-only" | "transform";
+
+
+
+interface TransformOutput {
+    code: string;
+    map?: string;
+}
+
+
diff --git a/deps/amaro/lib/wasm_bg.wasm.d.ts b/deps/amaro/lib/wasm_bg.wasm.d.ts
@@ -0,0 +1,12 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const transform: (a: number, b: number) => number;
+export const transformSync: (a: number, b: number, c: number) => void;
+export const __wbindgen_export_0: (a: number) => void;
+export const __wbindgen_export_1: WebAssembly.Table;
+export const __wbindgen_export_2: (a: number, b: number) => number;
+export const __wbindgen_export_3: (a: number, b: number, c: number, d: number) => number;
+export const __wbindgen_add_to_stack_pointer: (a: number) => number;
+export const __wbindgen_export_4: (a: number, b: number, c: number) => void;
+export const __wbindgen_export_5: (a: number, b: number, c: number, d: number) => void;
diff --git a/deps/amaro/package.json b/deps/amaro/package.json
@@ -1,10 +1,11 @@
 {
 	"name": "amaro",
-	"version": "0.5.3",
+	"version": "1.1.0",
 	"description": "Node.js TypeScript wrapper",
 	"license": "MIT",
 	"type": "commonjs",
 	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
 	"homepage": "https://github.com/nodejs/amaro#readme",
 	"bugs": {
 		"url": "https://github.com/nodejs/amaro/issues"
@@ -13,6 +14,12 @@
 		"type": "git",
 		"url": "https://github.com/nodejs/amaro.git"
 	},
+	"keywords": [
+		"typescript",
+		"nodejs",
+		"type stripping",
+		"strip-types"
+	],
 	"scripts": {
 		"clean": "rimraf dist",
 		"lint": "biome lint --write",
@@ -21,7 +28,7 @@
 		"ci:fix": "biome check --write",
 		"prepack": "npm run build",
 		"postpack": "npm run clean",
-		"build": "node esbuild.config.mjs",
+		"build": "node esbuild.config.mjs && tsc --noCheck",
 		"build:wasm": "node tools/build-wasm.js",
 		"typecheck": "tsc --noEmit",
 		"test": "node --test \"**/*.test.js\"",
@@ -37,12 +44,12 @@
 	},
 	"exports": {
 		".": "./dist/index.js",
-		"./register": "./dist/register-strip.mjs",
 		"./strip": "./dist/register-strip.mjs",
 		"./transform": "./dist/register-transform.mjs"
 	},
 	"files": [
 		"dist",
+		"lib/**/*.d.ts",
 		"LICENSE.md"
 	],
 	"engines": {

diff --git a/deps/npm/bin/npm.ps1 b/deps/npm/bin/npm.ps1
@@ -22,11 +22,27 @@ if (Test-Path $NPM_PREFIX_NPM_CLI_JS) {
   $NPM_CLI_JS=$NPM_PREFIX_NPM_CLI_JS
 }
 
-# Support pipeline input
-if ($MyInvocation.ExpectingInput) {
+if ($MyInvocation.ExpectingInput) { # takes pipeline input
   $input | & $NODE_EXE $NPM_CLI_JS $args
-} else {
+} elseif (-not $MyInvocation.Line) { # used "-File" argument
   & $NODE_EXE $NPM_CLI_JS $args
+} else { # used "-Command" argument
+  if ($MyInvocation.Statement) {
+    $NPM_ORIGINAL_COMMAND = $MyInvocation.Statement
+  } else {
+    $NPM_ORIGINAL_COMMAND = (
+      [Management.Automation.InvocationInfo].GetProperty('ScriptPosition', [Reflection.BindingFlags] 'Instance, NonPublic')
+    ).GetValue($MyInvocation).Text
+  }
+
+  $NODE_EXE = $NODE_EXE.Replace("``", "````")
+  $NPM_CLI_JS = $NPM_CLI_JS.Replace("``", "````")
+
+  $NPM_NO_REDIRECTS_COMMAND = [Management.Automation.Language.Parser]::ParseInput($NPM_ORIGINAL_COMMAND, [ref] $null, [ref] $null).
+    EndBlock.Statements.PipelineElements.CommandElements.Extent.Text -join ' '
+  $NPM_ARGS = $NPM_NO_REDIRECTS_COMMAND.Substring($MyInvocation.InvocationName.Length).Trim()
+
+  Invoke-Expression "& `"$NODE_EXE`" `"$NPM_CLI_JS`" $NPM_ARGS"
 }
 
 exit $LASTEXITCODE
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		export { transformSync } from "./transform.ts";
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		import type { LoadFnOutput, LoadHookContext } from "node:module";
		export declare function load(url: string, context: LoadHookContext, nextLoad: (url: string, context?: LoadHookContext) => LoadFnOutput \| Promise<LoadFnOutput>): Promise<LoadFnOutput>;
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		import type { Options, TransformOutput } from "../lib/wasm";
		export declare function transformSync(source: string, options?: Options): TransformOutput;