feat: add package-manager environment configuration (#148)

Add `package-manager` for GitHub and GitLab, and `packageManager` for
Azure. Accept a boolean or a mapping of npm, pnpm, yarn, and bun to
booleans.

`false` runs `vp env off pm`; individual false entries run commands such
as `vp env off pnpm`. True and omitted entries leave the installer
default unchanged, without explicit enable commands. Any explicit
configuration requires Vite+ 0.3.1+; older versions remain supported
when the input is unset.

🤖 Generated with Codex

---------

Co-authored-by: MK (fengmk2) <fengmk2@gmail.com>

Author: liangmiQwQ

.github/workflows/test.yml

@@ -235,6 +235,55 @@ jobs:
             exit 1
           fi
 
+  test-package-manager:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        config:
+          - input: "true"
+            modes: '["managed", "managed", "managed", "managed"]'
+          - input: "false"
+            modes: '["system_first", "system_first", "system_first", "system_first"]'
+          - input: "{npm: false, pnpm: true, yarn: false}"
+            modes: '["system_first", "managed", "system_first", "managed"]'
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: taiki-e/checkout-action@7d1e50e93dc4fb3bba58f85018fadf77898aee8b # v1.4.2
+
+      - name: Setup Vite+ with package-manager configuration
+        uses: ./
+        with:
+          package-manager: ${{ matrix.config.input }}
+          run-install: false
+          cache: false
+
+      # Query the real CLI so this covers input parsing, installation, and mode
+      # changes, including true and omitted entries in a partial mapping.
+      - name: Verify package-manager modes and independent Node.js management
+        shell: bash
+        env:
+          EXPECTED_MODES: ${{ matrix.config.modes }}
+        run: |
+          node --input-type=module <<'NODE'
+          import assert from 'node:assert/strict';
+          import { execFileSync } from 'node:child_process';
+
+          const managers = ['npm', 'pnpm', 'yarn', 'bun'];
+          const modes = JSON.parse(process.env.EXPECTED_MODES);
+          for (const [index, manager] of managers.entries()) {
+            const { package_manager: current } = JSON.parse(
+              execFileSync('vp', ['env', 'current', manager, '--json'], { encoding: 'utf8' }),
+            );
+            console.log(`${manager}: ${current.mode}`);
+            assert.equal(current.mode, modes[index], `${manager} mode`);
+          }
+          const { node } = JSON.parse(
+            execFileSync('vp', ['env', 'current', 'node', '--json'], { encoding: 'utf8' }),
+          );
+          assert.equal(node.mode, 'managed', 'Node.js management must remain enabled');
+          NODE
+
   test-default-version:
     # End-to-end check of the default version-resolution logic: with no `version`
     # or `version-file` input, the action auto-detects the vite-plus version from

README.md

@@ -30,6 +30,10 @@ inputs:
   node-manager:
     description: "Control Vite+'s Node.js version manager. When unset, the Vite+ installer decides (enabled on CI). Set to `false` to keep the Node.js already on the runner (e.g. from actions/setup-node or the runner image): after installation, vp commands prefer the system Node.js. Set to `true` to leave the installer default unchanged. Cannot be `false` together with node-version or node-version-file."
     required: false
+  package-manager:
+    description: "Control Vite+ package-manager management (0.3.1+). Accepts true, false, or a YAML mapping of npm, pnpm, yarn, and bun to booleans. Unspecified managers keep the installer default (enabled on CI). Any explicit configuration requires 0.3.1+. False prefers the system package manager. Independent of node-manager."
+    required: false
+    default: ""
   working-directory:
     description: "Project directory to use for relative paths, lockfile auto-detection, environment checks, and default `vp install` execution."
     required: false

action.yml

@@ -23,6 +23,9 @@ parameters:
   - name: nodeVersion
     type: string
     default: 24.x
+  - name: packageManager
+    type: object
+    default: ""
   - name: nodeManager
     type: string
     default: ""
@@ -53,6 +56,7 @@ steps:
       SETUP_VP_WORKING_DIRECTORY: ${{ parameters.workingDirectory }}
       SETUP_VP_RUN_INSTALL: ${{ convertToJson(parameters.runInstall) }}
       SETUP_VP_SFW: ${{ iif(eq(parameters.sfw, true), 'true', 'false') }}
+      SETUP_VP_PACKAGE_MANAGER: ${{ convertToJson(parameters.packageManager) }}
       SETUP_VP_NODE_MANAGER: ${{ parameters.nodeManager }}
       SETUP_VP_REGISTRY_URL: ${{ parameters.registryUrl }}
       SETUP_VP_SCOPE: ${{ parameters.scope }}
@@ -75,6 +79,7 @@ steps:
       SETUP_VP_WORKING_DIRECTORY: ${{ parameters.workingDirectory }}
       SETUP_VP_RUN_INSTALL: ${{ convertToJson(parameters.runInstall) }}
       SETUP_VP_SFW: ${{ iif(eq(parameters.sfw, true), 'true', 'false') }}
+      SETUP_VP_PACKAGE_MANAGER: ${{ convertToJson(parameters.packageManager) }}
       SETUP_VP_NODE_MANAGER: ${{ parameters.nodeManager }}
       SETUP_VP_REGISTRY_URL: ${{ parameters.registryUrl }}
       SETUP_VP_SCOPE: ${{ parameters.scope }}

azure/setup-vp.yml

@@ -13,6 +13,9 @@ spec:
       description: "Wrap `vp install` with Socket Firewall Free (`sfw`) to block malicious dependency fetches."
       type: boolean
       default: false
+    package-manager:
+      description: 'Control Vite+ package-manager management (0.3.1+). Use "true", "false", or a YAML mapping of npm, pnpm, yarn, and bun to booleans. Unspecified managers keep the installer default (enabled on CI). Any explicit configuration requires 0.3.1+.'
+      default: ""
     node-manager:
       description: 'Control Vite+''s Node.js version manager. This is a string input: empty (default) lets the Vite+ installer decide (enabled on CI); "false" keeps the runner image''s Node.js (makes vp commands prefer the system Node.js after installation); "true" leaves the installer default unchanged.'
       default: ""
@@ -49,6 +52,7 @@ spec:
       export SETUP_VP_WORKING_DIRECTORY="${SETUP_VP_WORKING_DIRECTORY:-.}"
       export SETUP_VP_RUN_INSTALL="${SETUP_VP_RUN_INSTALL:-true}"
       export SETUP_VP_SFW="${SETUP_VP_SFW:-false}"
+      export SETUP_VP_PACKAGE_MANAGER="${SETUP_VP_PACKAGE_MANAGER:-}"
       export SETUP_VP_NODE_MANAGER="${SETUP_VP_NODE_MANAGER:-}"
       export SETUP_VP_REGISTRY_URL="${SETUP_VP_REGISTRY_URL:-}"
       export SETUP_VP_SCOPE="${SETUP_VP_SCOPE:-}"
@@ -87,6 +91,11 @@ spec:
       SETUP_VP_SFW_EOF
       )"
       export SETUP_VP_SFW
+      SETUP_VP_PACKAGE_MANAGER="$(cat <<'SETUP_VP_PACKAGE_MANAGER_EOF'
+      $[[ inputs.package-manager ]]
+      SETUP_VP_PACKAGE_MANAGER_EOF
+      )"
+      export SETUP_VP_PACKAGE_MANAGER
       SETUP_VP_NODE_MANAGER="$(cat <<'SETUP_VP_NODE_MANAGER_EOF'
       $[[ inputs.node-manager ]]
       SETUP_VP_NODE_MANAGER_EOF

dist/azure/index.mjs

@@ -82,6 +82,7 @@ describe("Azure lifecycle", () => {
       {
         SETUP_VP_VERSION: "latest",
         SETUP_VP_NODE_MANAGER: "false",
+        SETUP_VP_PACKAGE_MANAGER: version === "0.3.1" ? '{"pnpm":true,"bun":false}' : "",
         SYSTEM_DEFAULTWORKINGDIRECTORY: process.cwd(),
       },
       {
@@ -105,6 +106,10 @@ describe("Azure lifecycle", () => {
       "vp",
       version === "0.3.0" ? ["env", "off"] : ["env", "off", "node"],
     );
+    if (version === "0.3.1") {
+      expect(run).not.toHaveBeenCalledWith("vp", ["env", "on", "pm"]);
+      expect(run).toHaveBeenCalledWith("vp", ["env", "off", "bun"]);
+    }
   });
 
   it("prepare leaves the node manager alone when nodeManager is unset", async () => {

dist/gitlab/index.mjs

@@ -1,5 +1,6 @@
 import path from "node:path";
 import { pathToFileURL } from "node:url";
+import { packageManagerArgs } from "../ci/package-manager.js";
 import { nodeManagerOffArgs } from "../ci/node-manager.js";
 import { configureAuth } from "../ci/auth.js";
 import { prepareCacheMetadata } from "../ci/cache.js";
@@ -66,9 +67,19 @@ export async function runPrepare(
     logWarningFn: ports.logWarning,
   });
 
+  const versionOutput =
+    inputs.nodeManager === false || inputs.packageManager !== undefined
+      ? ports.getCommandOutput("vp", ["--version"]) || ""
+      : "";
+  const packageManagerCommands = packageManagerArgs(inputs.packageManager, versionOutput);
+
   // Switch to the agent's Node.js after installation, preserving package-manager management.
   if (inputs.nodeManager === false) {
-    ports.run("vp", nodeManagerOffArgs(ports.getCommandOutput("vp", ["--version"]) || ""));
+    ports.run("vp", nodeManagerOffArgs(versionOutput));
+  }
+
+  for (const args of packageManagerCommands) {
+    ports.run("vp", args);
   }
 
   const runtimePath = path.resolve(process.argv[1] || "");