feat(pack): align CLI arguments with tsdown upstream (#672)

fengmk2 · web-flow · commit 01d0c5ca69d7 · 2026-03-03T11:46:25.000+08:00
- Rename `--external` to `--deps.never-bundle` to match tsdown's flag
- Update `--exe` description from experimental SEA to just 'Bundle as executable'
- Reorder `--exe` before `--workspace` to match upstream ordering
- Add snap test for `--deps.never-bundle` and legacy `--external` backward compat
diff --git a/packages/cli/snap-tests/command-helper/snap.txt b/packages/cli/snap-tests/command-helper/snap.txt
@@ -35,44 +35,44 @@ For more info, run any command with the `--help` flag:
   $ vp pack --help
 
 Options:
-  --config-loader <loader>  Config loader to use: auto, native, unrun (default: auto)
-  --no-config               Disable config file (default: true)
-  -f, --format <format>     Bundle format: esm, cjs, iife, umd (default: esm)
-  --clean                   Clean output directory, --no-clean to disable 
-  --external <module>       Mark dependencies as external 
-  --minify                  Minify output 
-  --devtools                Enable devtools integration 
-  --debug [feat]            Show debug logs 
-  --target <target>         Bundle target, e.g "es2015", "esnext" 
-  -l, --logLevel <level>    Set log level: info, warn, error, silent 
-  --fail-on-warn            Fail on warnings (default: true)
-  --no-write                Disable writing files to disk, incompatible with watch mode (default: true)
-  -d, --out-dir <dir>       Output directory (default: dist)
-  --treeshake               Tree-shake bundle (default: true)
-  --sourcemap               Generate source map (default: false)
-  --shims                   Enable cjs and esm shims (default: false)
-  --platform <platform>     Target platform (default: node)
-  --dts                     Generate dts files 
-  --publint                 Enable publint (default: false)
-  --attw                    Enable Are the types wrong integration (default: false)
-  --unused                  Enable unused dependencies check (default: false)
-  -w, --watch [path]        Watch mode 
-  --ignore-watch <path>     Ignore custom paths in watch mode 
-  --from-vite [vitest]      Reuse config from Vite or Vitest 
-  --report                  Size report (default: true)
-  --env.* <value>           Define compile-time env variables 
-  --env-file <file>         Load environment variables from a file, when used together with --env, variables in --env take precedence 
-  --env-prefix <prefix>     Prefix for env variables to inject into the bundle (default: VITE_PACK_,TSDOWN_)
-  --on-success <command>    Command to run on success 
-  --copy <dir>              Copy files to output dir 
-  --public-dir <dir>        Alias for --copy, deprecated 
-  --tsconfig <tsconfig>     Set tsconfig path 
-  --unbundle                Unbundle mode 
-  -W, --workspace [dir]     Enable workspace mode 
-  -F, --filter <pattern>    Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name 
-  --exports                 Generate export-related metadata for package.json (experimental) 
-  --exe                     Bundle as executable using Node.js SEA (experimental) 
-  -h, --help                Display this message 
+  --config-loader <loader>      Config loader to use: auto, native, unrun (default: auto)
+  --no-config                   Disable config file (default: true)
+  -f, --format <format>         Bundle format: esm, cjs, iife, umd (default: esm)
+  --clean                       Clean output directory, --no-clean to disable 
+  --deps.never-bundle <module>  Mark dependencies as external 
+  --minify                      Minify output 
+  --devtools                    Enable devtools integration 
+  --debug [feat]                Show debug logs 
+  --target <target>             Bundle target, e.g "es2015", "esnext" 
+  -l, --logLevel <level>        Set log level: info, warn, error, silent 
+  --fail-on-warn                Fail on warnings (default: true)
+  --no-write                    Disable writing files to disk, incompatible with watch mode (default: true)
+  -d, --out-dir <dir>           Output directory (default: dist)
+  --treeshake                   Tree-shake bundle (default: true)
+  --sourcemap                   Generate source map (default: false)
+  --shims                       Enable cjs and esm shims (default: false)
+  --platform <platform>         Target platform (default: node)
+  --dts                         Generate dts files 
+  --publint                     Enable publint (default: false)
+  --attw                        Enable Are the types wrong integration (default: false)
+  --unused                      Enable unused dependencies check (default: false)
+  -w, --watch [path]            Watch mode 
+  --ignore-watch <path>         Ignore custom paths in watch mode 
+  --from-vite [vitest]          Reuse config from Vite or Vitest 
+  --report                      Size report (default: true)
+  --env.* <value>               Define compile-time env variables 
+  --env-file <file>             Load environment variables from a file, when used together with --env, variables in --env take precedence 
+  --env-prefix <prefix>         Prefix for env variables to inject into the bundle (default: VITE_PACK_,TSDOWN_)
+  --on-success <command>        Command to run on success 
+  --copy <dir>                  Copy files to output dir 
+  --public-dir <dir>            Alias for --copy, deprecated 
+  --tsconfig <tsconfig>         Set tsconfig path 
+  --unbundle                    Unbundle mode 
+  --exe                         Bundle as executable 
+  -W, --workspace [dir]         Enable workspace mode 
+  -F, --filter <pattern>        Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name 
+  --exports                     Generate export-related metadata for package.json (experimental) 
+  -h, --help                    Display this message 
 
 > vp fmt -h # fmt help message
 Usage: [-c=PATH] [PATH]...
diff --git a/packages/cli/snap-tests/command-pack-external/package.json b/packages/cli/snap-tests/command-pack-external/package.json
@@ -0,0 +1,5 @@
+{
+  "name": "command-pack-external",
+  "version": "1.0.0",
+  "type": "module"
+}
diff --git a/packages/cli/snap-tests/command-pack-external/snap.txt b/packages/cli/snap-tests/command-pack-external/snap.txt
@@ -0,0 +1,17 @@
+> vp pack --deps.never-bundle node:path src/index.ts # should bundle with deps.never-bundle flag
+ℹ entry: src/index.ts
+ℹ Build start
+ℹ dist/index.mjs  <variable> kB │ gzip: <variable> kB
+ℹ 1 files, total: <variable> kB
+✔ Build complete in <variable>ms
+
+> vp pack --external node:path src/index.ts # should bundle with legacy external flag
+ℹ entry: src/index.ts
+
+ WARN  `external` is deprecated. Use `deps.neverBundle` instead.
+
+ℹ Build start
+ℹ Cleaning 1 files
+ℹ dist/index.mjs  <variable> kB │ gzip: <variable> kB
+ℹ 1 files, total: <variable> kB
+✔ Build complete in <variable>ms
diff --git a/packages/cli/snap-tests/command-pack-external/src/index.ts b/packages/cli/snap-tests/command-pack-external/src/index.ts
@@ -0,0 +1,3 @@
+import path from 'node:path';
+
+console.log(path.join('a', 'b'));
diff --git a/packages/cli/snap-tests/command-pack-external/steps.json b/packages/cli/snap-tests/command-pack-external/steps.json
@@ -0,0 +1,7 @@
+{
+  "ignoredPlatforms": ["win32"],
+  "commands": [
+    "vp pack --deps.never-bundle node:path src/index.ts # should bundle with deps.never-bundle flag",
+    "vp pack --external node:path src/index.ts # should bundle with legacy external flag"
+  ]
+}
diff --git a/packages/cli/snap-tests/command-pack/snap.txt b/packages/cli/snap-tests/command-pack/snap.txt
@@ -11,44 +11,44 @@ For more info, run any command with the `--help` flag:
   $ vp pack --help
 
 Options:
-  --config-loader <loader>  Config loader to use: auto, native, unrun (default: auto)
-  --no-config               Disable config file (default: true)
-  -f, --format <format>     Bundle format: esm, cjs, iife, umd (default: esm)
-  --clean                   Clean output directory, --no-clean to disable 
-  --external <module>       Mark dependencies as external 
-  --minify                  Minify output 
-  --devtools                Enable devtools integration 
-  --debug [feat]            Show debug logs 
-  --target <target>         Bundle target, e.g "es2015", "esnext" 
-  -l, --logLevel <level>    Set log level: info, warn, error, silent 
-  --fail-on-warn            Fail on warnings (default: true)
-  --no-write                Disable writing files to disk, incompatible with watch mode (default: true)
-  -d, --out-dir <dir>       Output directory (default: dist)
-  --treeshake               Tree-shake bundle (default: true)
-  --sourcemap               Generate source map (default: false)
-  --shims                   Enable cjs and esm shims (default: false)
-  --platform <platform>     Target platform (default: node)
-  --dts                     Generate dts files 
-  --publint                 Enable publint (default: false)
-  --attw                    Enable Are the types wrong integration (default: false)
-  --unused                  Enable unused dependencies check (default: false)
-  -w, --watch [path]        Watch mode 
-  --ignore-watch <path>     Ignore custom paths in watch mode 
-  --from-vite [vitest]      Reuse config from Vite or Vitest 
-  --report                  Size report (default: true)
-  --env.* <value>           Define compile-time env variables 
-  --env-file <file>         Load environment variables from a file, when used together with --env, variables in --env take precedence 
-  --env-prefix <prefix>     Prefix for env variables to inject into the bundle (default: VITE_PACK_,TSDOWN_)
-  --on-success <command>    Command to run on success 
-  --copy <dir>              Copy files to output dir 
-  --public-dir <dir>        Alias for --copy, deprecated 
-  --tsconfig <tsconfig>     Set tsconfig path 
-  --unbundle                Unbundle mode 
-  -W, --workspace [dir]     Enable workspace mode 
-  -F, --filter <pattern>    Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name 
-  --exports                 Generate export-related metadata for package.json (experimental) 
-  --exe                     Bundle as executable using Node.js SEA (experimental) 
-  -h, --help                Display this message 
+  --config-loader <loader>      Config loader to use: auto, native, unrun (default: auto)
+  --no-config                   Disable config file (default: true)
+  -f, --format <format>         Bundle format: esm, cjs, iife, umd (default: esm)
+  --clean                       Clean output directory, --no-clean to disable 
+  --deps.never-bundle <module>  Mark dependencies as external 
+  --minify                      Minify output 
+  --devtools                    Enable devtools integration 
+  --debug [feat]                Show debug logs 
+  --target <target>             Bundle target, e.g "es2015", "esnext" 
+  -l, --logLevel <level>        Set log level: info, warn, error, silent 
+  --fail-on-warn                Fail on warnings (default: true)
+  --no-write                    Disable writing files to disk, incompatible with watch mode (default: true)
+  -d, --out-dir <dir>           Output directory (default: dist)
+  --treeshake                   Tree-shake bundle (default: true)
+  --sourcemap                   Generate source map (default: false)
+  --shims                       Enable cjs and esm shims (default: false)
+  --platform <platform>         Target platform (default: node)
+  --dts                         Generate dts files 
+  --publint                     Enable publint (default: false)
+  --attw                        Enable Are the types wrong integration (default: false)
+  --unused                      Enable unused dependencies check (default: false)
+  -w, --watch [path]            Watch mode 
+  --ignore-watch <path>         Ignore custom paths in watch mode 
+  --from-vite [vitest]          Reuse config from Vite or Vitest 
+  --report                      Size report (default: true)
+  --env.* <value>               Define compile-time env variables 
+  --env-file <file>             Load environment variables from a file, when used together with --env, variables in --env take precedence 
+  --env-prefix <prefix>         Prefix for env variables to inject into the bundle (default: VITE_PACK_,TSDOWN_)
+  --on-success <command>        Command to run on success 
+  --copy <dir>                  Copy files to output dir 
+  --public-dir <dir>            Alias for --copy, deprecated 
+  --tsconfig <tsconfig>         Set tsconfig path 
+  --unbundle                    Unbundle mode 
+  --exe                         Bundle as executable 
+  -W, --workspace [dir]         Enable workspace mode 
+  -F, --filter <pattern>        Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name 
+  --exports                     Generate export-related metadata for package.json (experimental) 
+  -h, --help                    Display this message 
 
 > vp run pack # should build the library
 $ vp pack src/index.ts
diff --git a/packages/cli/src/pack-bin.ts b/packages/cli/src/pack-bin.ts
@@ -33,7 +33,7 @@ cli
     default: 'esm',
   })
   .option('--clean', 'Clean output directory, --no-clean to disable')
-  .option('--external <module>', 'Mark dependencies as external')
+  .option('--deps.never-bundle <module>', 'Mark dependencies as external')
   .option('--minify', 'Minify output')
   .option('--devtools', 'Enable devtools integration')
   .option('--debug [feat]', 'Show debug logs')
@@ -71,10 +71,10 @@ cli
   .option('--public-dir <dir>', 'Alias for --copy, deprecated')
   .option('--tsconfig <tsconfig>', 'Set tsconfig path')
   .option('--unbundle', 'Unbundle mode')
+  .option('--exe', 'Bundle as executable')
   .option('-W, --workspace [dir]', 'Enable workspace mode')
   .option('-F, --filter <pattern>', 'Filter configs (cwd or name), e.g. /pkg-name$/ or pkg-name')
   .option('--exports', 'Generate export-related metadata for package.json (experimental)')
-  .option('--exe', 'Bundle as executable using Node.js SEA (experimental)')
   .action(async (input: string[], flags: InlineConfig) => {
     if (input.length > 0) {
       flags.entry = input;

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+import path from 'node:path';`
	`2`	`+`
	`3`	`+console.log(path.join('a', 'b'));`