refactor(cli): rename vp lib to vp pack (#575)

Rename the `lib` command to `pack` across the entire codebase:
- CLI command definition and dispatch (Rust + NAPI bindings)
- TypeScript resolver, bin entry, types, and module augmentation
- Package exports (`vite-plus/lib` → `vite-plus/pack`, `vite-plus-core/lib` → `vite-plus-core/pack`)
- Config key (`lib:` → `pack:` in vite.config.ts)
- Environment prefix (`VITE_LIB_` → `VITE_PACK_`)
- Migration rules (tsdown → `vite pack`, import rewriter → `vite-plus/pack`)
- All snap tests and test assertions
- Documentation

Author: fengmk2

crates/vite_global_cli/src/cli.rs

@@ -565,6 +565,13 @@ pub enum Commands {
         args: Vec<String>,
     },
 
+    /// Build library
+    Pack {
+        /// Additional arguments
+        #[arg(trailing_var_arg = true, allow_hyphen_values = true)]
+        args: Vec<String>,
+    },
+
     /// Run tasks
     Run {
         /// Additional arguments
@@ -1539,6 +1546,8 @@ pub async fn run_command(cwd: AbsolutePathBuf, args: Args) -> Result<ExitStatus,
 
         Commands::Fmt { args } => commands::delegate::execute(cwd, "fmt", &args).await,
 
+        Commands::Pack { args } => commands::delegate::execute(cwd, "pack", &args).await,
+
         Commands::Run { args } => commands::run_or_delegate::execute(cwd, &args).await,
 
         Commands::Preview { args } => commands::delegate::execute(cwd, "preview", &args).await,
@@ -1591,17 +1600,18 @@ fn apply_custom_help(cmd: clap::Command) -> clap::Command {
 
     let after_help = format!(
         "{bold_underline}Core Commands:{reset}
-  {bold}create{reset}     Create a new project from a template
-  {bold}dev{reset}        Run the development server
-  {bold}build{reset}      Build for production
-  {bold}test{reset}       Run tests
-  {bold}lint{reset}       Lint code
-  {bold}fmt{reset}        Format code
-  {bold}run{reset}        Run tasks
-  {bold}preview{reset}    Preview production build
-  {bold}env{reset}        Manage Node.js versions
-  {bold}migrate{reset}    Migrate an existing project to Vite+
-  {bold}cache{reset}      Manage the task cache
+  {bold}create{reset}                         Create a new project from a template
+  {bold}dev{reset}                            Run the development server
+  {bold}build{reset}                          Build for production
+  {bold}test{reset}                           Run tests
+  {bold}lint{reset}                           Lint code
+  {bold}fmt{reset}                            Format code
+  {bold}pack{reset}                           Build library
+  {bold}run{reset}                            Run tasks
+  {bold}preview{reset}                        Preview production build
+  {bold}env{reset}                            Manage Node.js versions
+  {bold}migrate{reset}                        Migrate an existing project to Vite+
+  {bold}cache{reset}                          Manage the task cache
 
 {bold_underline}Package Manager Commands:{reset}
   {bold}install, i{reset}                     Install all dependencies, or add packages if package names are provided

crates/vite_migration/src/import_rewriter.rs

@@ -238,8 +238,8 @@ fix: $NEW_IMPORT
 /// ast-grep rules for rewriting tsdown imports and declare module statements
 ///
 /// This rewrites:
-/// - `import { ... } from 'tsdown'` → `import { ... } from 'vite-plus/lib'`
-/// - `declare module 'tsdown' { ... }` → `declare module 'vite-plus/lib' { ... }`
+/// - `import { ... } from 'tsdown'` → `import { ... } from 'vite-plus/pack'`
+/// - `declare module 'tsdown' { ... }` → `declare module 'vite-plus/pack' { ... }`
 const REWRITE_TSDOWN_RULES: &str = r#"---
 id: rewrite-tsdown-import
 language: TypeScript
@@ -254,7 +254,7 @@ transform:
     replace:
       source: $STR
       replace: tsdown
-      by: "vite-plus/lib"
+      by: "vite-plus/pack"
 fix: $NEW_IMPORT
 ---
 id: rewrite-declare-module-tsdown
@@ -270,7 +270,7 @@ transform:
     replace:
       source: $STR
       replace: tsdown
-      by: "vite-plus/lib"
+      by: "vite-plus/pack"
 fix: $NEW_IMPORT
 "#;
 
@@ -1569,7 +1569,7 @@ export default defineConfig({
         assert!(result.updated);
         assert_eq!(
             result.content,
-            r#"import { defineConfig } from 'vite-plus/lib';
+            r#"import { defineConfig } from 'vite-plus/pack';
 
 export default defineConfig({
   entry: 'src/index.ts',
@@ -1589,7 +1589,7 @@ export default defineConfig({
         assert!(result.updated);
         assert_eq!(
             result.content,
-            r#"import { defineConfig } from "vite-plus/lib";
+            r#"import { defineConfig } from "vite-plus/pack";
 
 export default defineConfig({
   entry: "src/index.ts",
@@ -1609,7 +1609,7 @@ export default defineConfig({
         assert!(result.updated);
         assert_eq!(
             result.content,
-            r#"declare module 'vite-plus/lib' {
+            r#"declare module 'vite-plus/pack' {
   interface BuildConfig {
     custom?: boolean;
   }
@@ -1629,7 +1629,7 @@ export default defineConfig({
         assert!(result.updated);
         assert_eq!(
             result.content,
-            r#"declare module "vite-plus/lib" {
+            r#"declare module "vite-plus/pack" {
   interface BuildConfig {
     custom?: boolean;
   }

crates/vite_migration/src/package.rs

@@ -125,7 +125,7 @@ fix: vite test
         assert_eq!(rewrite_script("vite test", &rules), "vite test");
         assert_eq!(rewrite_script("vite lint", &rules), "vite lint");
         assert_eq!(rewrite_script("vite fmt", &rules), "vite fmt");
-        assert_eq!(rewrite_script("vite lib", &rules), "vite lib");
+        assert_eq!(rewrite_script("vite pack", &rules), "vite pack");
         assert_eq!(rewrite_script("vite preview", &rules), "vite preview");
         assert_eq!(rewrite_script("vite optimize", &rules), "vite optimize");
         assert_eq!(rewrite_script("vite build -r", &rules), "vite build -r");

crates/vite_migration/src/vite_config.rs

@@ -269,7 +269,7 @@ fn indent_multiline(s: &str, spaces: usize) -> String {
 /// Merge tsdown config into vite.config.ts by importing it
 ///
 /// This function adds an import statement for the tsdown config file
-/// and adds `lib: tsdownConfig` to the defineConfig.
+/// and adds `pack: tsdownConfig` to the defineConfig.
 ///
 /// # Arguments
 ///
@@ -291,7 +291,7 @@ pub fn merge_tsdown_config(
 ///
 /// This adds:
 /// 1. An import statement: `import tsdownConfig from './tsdown.config.ts'`
-/// 2. The lib config in defineConfig: `lib: tsdownConfig`
+/// 2. The pack config in defineConfig: `pack: tsdownConfig`
 ///
 /// This function is idempotent - running it multiple times will not create duplicates.
 fn merge_tsdown_config_content(
@@ -324,9 +324,9 @@ fn merge_tsdown_config_content(
     let content_with_import =
         format!("import tsdownConfig from '{import_path}';\n\n{vite_config_content}");
 
-    // Step 2: Add lib: tsdownConfig to defineConfig
-    let lib_rule = generate_merge_rule("tsdownConfig", "lib");
-    let (final_content, _) = ast_grep::apply_rules(&content_with_import, &lib_rule)?;
+    // Step 2: Add pack: tsdownConfig to defineConfig
+    let pack_rule = generate_merge_rule("tsdownConfig", "pack");
+    let (final_content, _) = ast_grep::apply_rules(&content_with_import, &pack_rule)?;
 
     Ok(MergeResult { content: final_content, updated: true, uses_function_callback })
 }
@@ -966,7 +966,7 @@ export default defineConfig({
 import { defineConfig } from 'vite-plus';
 
 export default defineConfig({
-  lib: tsdownConfig,
+  pack: tsdownConfig,
   plugins: [],
 });"#
         );
@@ -992,7 +992,7 @@ import { defineConfig } from 'vite-plus';
 import react from '@vitejs/plugin-react';
 
 export default defineConfig({
-  lib: tsdownConfig,
+  pack: tsdownConfig,
   plugins: [react()],
 });"#
         );
@@ -1016,7 +1016,7 @@ export default defineConfig((env) => ({
 import { defineConfig } from 'vite-plus';
 
 export default defineConfig((env) => ({
-  lib: tsdownConfig,
+  pack: tsdownConfig,
   plugins: [],
 }));"#
         );
@@ -1030,7 +1030,7 @@ export default defineConfig((env) => ({
 import { defineConfig } from 'vite-plus';
 
 export default defineConfig({
-  lib: tsdownConfig,
+  pack: tsdownConfig,
   plugins: [],
 });"#;
 
@@ -1050,7 +1050,7 @@ export default defineConfig({
 import { defineConfig } from 'vite-plus';
 
 export default defineConfig({
-  lib: tsdownConfig,
+  pack: tsdownConfig,
   plugins: [],
 });"#;
 
@@ -1080,15 +1080,15 @@ export default defineConfig({
             r#"import tsdownConfig from './tsdown.config.js';
 
 export default {
-  lib: tsdownConfig,
+  pack: tsdownConfig,
   server: { port: 3000 }
 }"#
         );
     }
 
     #[test]
     fn test_merge_tsdown_config_content_no_false_positive_stdlib() {
-        // "stdlib:" should not be detected as "lib:" key
+        // "stdlib:" should not be detected as "pack:" key
         let vite_config = r#"import { defineConfig } from 'vite-plus';
 
 export default defineConfig({
@@ -1098,7 +1098,7 @@ export default defineConfig({
         let result = merge_tsdown_config_content(vite_config, "./tsdown.config.ts").unwrap();
         assert!(result.updated);
         assert!(result.content.contains("import tsdownConfig from './tsdown.config.js'"));
-        assert!(result.content.contains("lib: tsdownConfig"));
+        assert!(result.content.contains("pack: tsdownConfig"));
         assert!(result.content.contains("stdlib: 'some-value'"));
     }
 

docs/vite/guide/cli.md

@@ -100,22 +100,22 @@ vp build [root] [OPTIONS]
 
 ## Build Library
 
-### `vp lib`
+### `vp pack`
 
 Build a library using tsdown.
 
 #### Usage
 
 ```bash
-vp lib [<ARGS>...]
+vp pack [<ARGS>...]
 ```
 
 #### Examples
 
 ```bash
-vp lib
-vp lib --watch
-vp lib --outdir dist
+vp pack
+vp pack --watch
+vp pack --outdir dist
 ```
 
 ## Build Documentation
@@ -453,7 +453,7 @@ vp build
 vp dev
 
 # Build library
-vp lib
+vp pack
 
 # Build docs
 vp doc build

packages/cli/binding/index.d.cts

@@ -6,7 +6,7 @@ export interface CliOptions {
   fmt: (err: Error | null) => Promise<JsCommandResolvedResult>;
   vite: (err: Error | null) => Promise<JsCommandResolvedResult>;
   test: (err: Error | null) => Promise<JsCommandResolvedResult>;
-  lib: (err: Error | null) => Promise<JsCommandResolvedResult>;
+  pack: (err: Error | null) => Promise<JsCommandResolvedResult>;
   doc: (err: Error | null) => Promise<JsCommandResolvedResult>;
   cwd?: string;
   /** CLI arguments (should be process.argv.slice(2) from JavaScript) */

packages/cli/binding/src/cli.rs

@@ -71,7 +71,7 @@ pub enum SynthesizableSubcommand {
     },
     /// Build library
     #[command(disable_help_flag = true)]
-    Lib {
+    Pack {
         #[clap(allow_hyphen_values = true, trailing_var_arg = true)]
         args: Vec<String>,
     },
@@ -133,7 +133,7 @@ pub struct CliOptions {
     pub fmt: BoxedResolverFn,
     pub vite: BoxedResolverFn,
     pub test: BoxedResolverFn,
-    pub lib: BoxedResolverFn,
+    pub pack: BoxedResolverFn,
     pub doc: BoxedResolverFn,
     pub resolve_universal_vite_config: ViteConfigResolverFn,
 }
@@ -407,16 +407,16 @@ impl SubcommandResolver {
                     envs: merge_resolved_envs(envs, resolved.envs),
                 })
             }
-            SynthesizableSubcommand::Lib { args } => {
+            SynthesizableSubcommand::Pack { args } => {
                 let cli_options = self
                     .cli_options
                     .as_ref()
-                    .ok_or_else(|| anyhow::anyhow!("CLI options required for lib command"))?;
-                let resolved = (cli_options.lib)().await?;
+                    .ok_or_else(|| anyhow::anyhow!("CLI options required for pack command"))?;
+                let resolved = (cli_options.pack)().await?;
                 let js_path = resolved.bin_path;
                 let js_path_str = js_path
                     .to_str()
-                    .ok_or_else(|| anyhow::anyhow!("lib JS path is not valid UTF-8"))?;
+                    .ok_or_else(|| anyhow::anyhow!("pack JS path is not valid UTF-8"))?;
 
                 Ok(ResolvedSubcommand {
                     program: Arc::from(OsStr::new("node")),
@@ -857,7 +857,7 @@ fn print_help() {
   {bold}lint{reset}       Lint code
   {bold}test{reset}       Run tests
   {bold}fmt{reset}        Format code
-  {bold}lib{reset}        Build library
+  {bold}pack{reset}       Build library
   {bold}run{reset}        Run tasks
   {bold}cache{reset}      Manage the task cache
 

packages/cli/binding/src/lib.rs

@@ -32,7 +32,7 @@ pub struct CliOptions {
     pub fmt: Arc<ThreadsafeFunction<(), Promise<JsCommandResolvedResult>>>,
     pub vite: Arc<ThreadsafeFunction<(), Promise<JsCommandResolvedResult>>>,
     pub test: Arc<ThreadsafeFunction<(), Promise<JsCommandResolvedResult>>>,
-    pub lib: Arc<ThreadsafeFunction<(), Promise<JsCommandResolvedResult>>>,
+    pub pack: Arc<ThreadsafeFunction<(), Promise<JsCommandResolvedResult>>>,
     pub doc: Arc<ThreadsafeFunction<(), Promise<JsCommandResolvedResult>>>,
     pub cwd: Option<String>,
     /// CLI arguments (should be process.argv.slice(2) from JavaScript)
@@ -120,7 +120,7 @@ pub async fn run(options: CliOptions) -> Result<i32> {
     let fmt_tsf = options.fmt;
     let vite_tsf = options.vite;
     let test_tsf = options.test;
-    let lib_tsf = options.lib;
+    let pack_tsf = options.pack;
     let doc_tsf = options.doc;
     let resolve_universal_vite_config_tsf = options.resolve_universal_vite_config;
     let args = options.args;
@@ -138,7 +138,7 @@ pub async fn run(options: CliOptions) -> Result<i32> {
             fmt: create_resolver(fmt_tsf, "Failed to resolve fmt command"),
             vite: create_resolver(vite_tsf, "Failed to resolve vite command"),
             test: create_resolver(test_tsf, "Failed to resolve test command"),
-            lib: create_resolver(lib_tsf, "Failed to resolve lib command"),
+            pack: create_resolver(pack_tsf, "Failed to resolve pack command"),
             doc: create_resolver(doc_tsf, "Failed to resolve doc command"),
             resolve_universal_vite_config: create_vite_config_resolver(
                 resolve_universal_vite_config_tsf,

packages/cli/package.json

@@ -50,9 +50,9 @@
       "require": "./binding/index.cjs"
     },
     "./package.json": "./package.json",
-    "./lib": {
-      "types": "./dist/lib.d.ts",
-      "import": "./dist/lib.js"
+    "./pack": {
+      "types": "./dist/pack.d.ts",
+      "import": "./dist/pack.js"
     },
     "./test": {
       "import": {