vite-plus 0.3.1 → 0.3.2

package/dist/oxlint-plugin.js

@@ -1,4 +1,4 @@
-import { n as VITE_PLUS_OXLINT_PLUGIN_NAME, t as PREFER_VITE_PLUS_IMPORTS_RULE_NAME } from "./oxlint-plugin-config-Drdl67Xp.js";
+import { n as VITE_PLUS_OXLINT_PLUGIN_NAME, t as PREFER_VITE_PLUS_IMPORTS_RULE_NAME } from "./oxlint-plugin-config-BU42tr8y.js";
 import path from "node:path";
 import fs from "node:fs";
 import { definePlugin, defineRule } from "@oxlint/plugins";
@@ -23,12 +23,33 @@ function isVitestFamilyDeclareModuleSpecifier(specifier) {
 	return specifier === "vitest" || specifier.startsWith("vitest/") || specifier === "@vitest/browser" || specifier.startsWith("@vitest/browser/") || specifier.startsWith("@vitest/browser-");
 }
 const VITE_CONFIG_FILE_BASENAMES = new Set(vite_config_entry_basenames_default);
+function isOxlintFamilyDeclareModuleSpecifier(specifier) {
+	return specifier === OXLINT_PACKAGE || specifier.startsWith(`${OXLINT_PACKAGE}/`) || specifier === OXLINT_PLUGINS_PACKAGE;
+}
 function isViteSpecifier(specifier) {
 	return specifier === "vite" || specifier.startsWith("vite/");
 }
 function isViteConfigFile(filename) {
 	return VITE_CONFIG_FILE_BASENAMES.has(path.basename(filename));
 }
+const OXLINT_PACKAGE = "oxlint";
+const OXLINT_PLUGINS_PACKAGE = "@oxlint/plugins";
+const OXLINT_PLUGINS_DEV_SUBPATH = "oxlint/plugins-dev";
+const VITE_PLUS_LINT_PLUGINS = "vite-plus/lint/plugins";
+const VITE_PLUS_LINT_PLUGINS_DEV = "vite-plus/lint/plugins-dev";
+const OXLINT_CONFIG_SURFACE_EXPORTS = /* @__PURE__ */ new Set([
+	"defineConfig",
+	"AllowWarnDeny",
+	"DummyRule",
+	"DummyRuleMap",
+	"ExternalPluginEntry",
+	"ExternalPluginsConfig",
+	"OxlintConfig",
+	"OxlintEnv",
+	"OxlintGlobals",
+	"OxlintOverride",
+	"RuleCategories"
+]);
 function rewriteVitePlusImportSpecifier(specifier) {
 	if (specifier === "vite") return "vite-plus";
 	if (specifier.startsWith("vite/")) return `vite-plus/${specifier.slice(5)}`;
@@ -54,17 +75,26 @@ function rewriteVitePlusImportSpecifier(specifier) {
 		if (specifier === `${prefix}/context`) return "vite-plus/test/browser/context";
 		if (specifier === `${prefix}/provider`) return `vite-plus/test/browser/providers/${provider}`;
 	}
+	if (specifier === OXLINT_PLUGINS_PACKAGE) return VITE_PLUS_LINT_PLUGINS;
+	if (specifier === OXLINT_PLUGINS_DEV_SUBPATH) return VITE_PLUS_LINT_PLUGINS_DEV;
 	return null;
 }
+function moduleBindingName(node) {
+	return node.type === "Identifier" ? node.name : node.value;
+}
+function importsOxlintPluginApi(node) {
+	return node.specifiers.length > 0 && node.specifiers.every((specifier) => specifier.type === "ImportSpecifier" && !OXLINT_CONFIG_SURFACE_EXPORTS.has(moduleBindingName(specifier.imported)));
+}
 function quoteSpecifier(literal, replacement) {
 	const quote = literal.raw?.startsWith("'") ? "'" : "\"";
 	return `${quote}${replacement}${quote}`;
 }
 const nuxtTestUtilsPackageCache = /* @__PURE__ */ new Map();
+const oxlintOwnerPackageCache = /* @__PURE__ */ new Map();
 function isUpstreamVitestSpecifier(specifier) {
 	return specifier === "vitest" || specifier.startsWith("vitest/");
 }
-function nearestPackageUsesNuxtTestUtils(filename) {
+function nearestPackageMatches(filename, cache, matchesPackage) {
 	if (!path.isAbsolute(filename)) return false;
 	let directory = path.dirname(filename);
 	while (true) {
@@ -74,34 +104,34 @@ function nearestPackageUsesNuxtTestUtils(filename) {
 			try {
 				mtimeMs = fs.statSync(packageJsonPath).mtimeMs;
 			} catch {}
-			const cached = mtimeMs === void 0 ? void 0 : nuxtTestUtilsPackageCache.get(packageJsonPath);
-			if (cached !== void 0 && cached.mtimeMs === mtimeMs) return cached.usesNuxtTestUtils;
-			let usesNuxtTestUtils = false;
+			const cached = mtimeMs === void 0 ? void 0 : cache.get(packageJsonPath);
+			if (cached !== void 0 && cached.mtimeMs === mtimeMs) return cached.matches;
+			let matches = false;
 			try {
-				const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
-				usesNuxtTestUtils = [
-					pkg.dependencies,
-					pkg.devDependencies,
-					pkg.optionalDependencies
-				].some((dependencies) => dependencies?.["@nuxt/test-utils"] !== void 0);
+				matches = matchesPackage(JSON.parse(fs.readFileSync(packageJsonPath, "utf8")));
 			} catch {}
-			if (mtimeMs !== void 0) nuxtTestUtilsPackageCache.set(packageJsonPath, {
+			if (mtimeMs !== void 0) cache.set(packageJsonPath, {
 				mtimeMs,
-				usesNuxtTestUtils
+				matches
 			});
-			return usesNuxtTestUtils;
+			return matches;
 		}
 		const parent = path.dirname(directory);
 		if (parent === directory) return false;
 		directory = parent;
 	}
 }
-function maybeReportLiteral(context, literal, preserveUpstreamVitest = false, fileIsViteConfig = false) {
-	if (!literal || literal.type !== "Literal" || typeof literal.value !== "string") return;
-	if (preserveUpstreamVitest && isUpstreamVitestSpecifier(literal.value)) return;
-	if (!fileIsViteConfig && isViteSpecifier(literal.value)) return;
-	const replacement = rewriteVitePlusImportSpecifier(literal.value);
-	if (!replacement) return;
+function nearestPackageUsesNuxtTestUtils(filename) {
+	return nearestPackageMatches(filename, nuxtTestUtilsPackageCache, (pkg) => [
+		pkg.dependencies,
+		pkg.devDependencies,
+		pkg.optionalDependencies
+	].some((dependencies) => dependencies?.["@nuxt/test-utils"] !== void 0));
+}
+function nearestPackageOwnsOxlintApi(filename) {
+	return nearestPackageMatches(filename, oxlintOwnerPackageCache, (pkg) => pkg.optionalDependencies?.[OXLINT_PLUGINS_PACKAGE] !== void 0 || [pkg.dependencies, pkg.peerDependencies].some((dependencies) => dependencies?.[OXLINT_PACKAGE] !== void 0 || dependencies?.[OXLINT_PLUGINS_PACKAGE] !== void 0));
+}
+function reportSpecifier(context, literal, replacement) {
 	context.report({
 		node: literal,
 		messageId: "preferVitePlusImports",
@@ -114,6 +144,30 @@ function maybeReportLiteral(context, literal, preserveUpstreamVitest = false, fi
 		}
 	});
 }
+function isOxlintApiSpecifier(specifier) {
+	return specifier === OXLINT_PLUGINS_PACKAGE || specifier === OXLINT_PLUGINS_DEV_SUBPATH;
+}
+function maybeReportLiteral(context, literal, { preserveUpstreamVitest, fileIsViteConfig, ownsOxlintApi }) {
+	if (!literal || literal.type !== "Literal" || typeof literal.value !== "string") return;
+	if (preserveUpstreamVitest && isUpstreamVitestSpecifier(literal.value)) return;
+	if (!fileIsViteConfig && isViteSpecifier(literal.value)) return;
+	const replacement = rewriteVitePlusImportSpecifier(literal.value);
+	if (!replacement) return;
+	if (ownsOxlintApi && isOxlintApiSpecifier(literal.value)) return;
+	reportSpecifier(context, literal, replacement);
+}
+function reportLegacyOxlintPluginApiExport(context, node, ownsOxlintApi) {
+	const literal = node.source;
+	if (!literal || literal.value !== OXLINT_PACKAGE || ownsOxlintApi) return;
+	if (node.specifiers.length === 0) return;
+	if (!node.specifiers.every((specifier) => !OXLINT_CONFIG_SURFACE_EXPORTS.has(moduleBindingName(specifier.local)))) return;
+	reportSpecifier(context, literal, VITE_PLUS_LINT_PLUGINS);
+}
+function reportLegacyOxlintPluginApiImport(context, node, ownsOxlintApi) {
+	const literal = node.source;
+	if (literal.value !== OXLINT_PACKAGE || ownsOxlintApi || !importsOxlintPluginApi(node)) return;
+	reportSpecifier(context, literal, VITE_PLUS_LINT_PLUGINS);
+}
 const preferVitePlusImportsRule = defineRule({
 	meta: {
 		type: "problem",
@@ -126,36 +180,43 @@ const preferVitePlusImportsRule = defineRule({
 		messages: { preferVitePlusImports: "Use '{{to}}' instead of '{{from}}' in Vite+ projects." }
 	},
 	createOnce(context) {
-		let preserveUpstreamVitest = false;
-		let fileIsViteConfig = false;
+		const options = {
+			preserveUpstreamVitest: false,
+			fileIsViteConfig: false,
+			ownsOxlintApi: false
+		};
 		return {
 			Program() {
-				preserveUpstreamVitest = nearestPackageUsesNuxtTestUtils(context.filename);
-				fileIsViteConfig = isViteConfigFile(context.filename);
+				options.preserveUpstreamVitest = nearestPackageUsesNuxtTestUtils(context.filename);
+				options.fileIsViteConfig = isViteConfigFile(context.filename);
+				options.ownsOxlintApi = nearestPackageOwnsOxlintApi(context.filename);
 			},
 			ImportDeclaration(node) {
-				maybeReportLiteral(context, node.source, preserveUpstreamVitest, fileIsViteConfig);
+				maybeReportLiteral(context, node.source, options);
+				reportLegacyOxlintPluginApiImport(context, node, options.ownsOxlintApi);
 			},
 			ExportAllDeclaration(node) {
-				maybeReportLiteral(context, node.source, preserveUpstreamVitest, fileIsViteConfig);
+				maybeReportLiteral(context, node.source, options);
 			},
 			ExportNamedDeclaration(node) {
-				maybeReportLiteral(context, node.source, preserveUpstreamVitest, fileIsViteConfig);
+				maybeReportLiteral(context, node.source, options);
+				reportLegacyOxlintPluginApiExport(context, node, options.ownsOxlintApi);
 			},
 			ImportExpression(node) {
-				maybeReportLiteral(context, node.source, preserveUpstreamVitest, fileIsViteConfig);
+				maybeReportLiteral(context, node.source, options);
 			},
 			TSImportType(node) {
-				maybeReportLiteral(context, node.source, preserveUpstreamVitest, fileIsViteConfig);
+				maybeReportLiteral(context, node.source, options);
 			},
 			TSExternalModuleReference(node) {
-				maybeReportLiteral(context, node.expression, preserveUpstreamVitest, fileIsViteConfig);
+				if (node.expression.type === "Literal" && typeof node.expression.value === "string" && isOxlintApiSpecifier(node.expression.value)) return;
+				maybeReportLiteral(context, node.expression, options);
 			},
 			TSModuleDeclaration(node) {
 				if (node.global) return;
 				const id = node.id;
-				if (id?.type === "Literal" && typeof id.value === "string" && isVitestFamilyDeclareModuleSpecifier(id.value)) return;
-				maybeReportLiteral(context, id, preserveUpstreamVitest, fileIsViteConfig);
+				if (id?.type === "Literal" && typeof id.value === "string" && (isVitestFamilyDeclareModuleSpecifier(id.value) || isOxlintFamilyDeclareModuleSpecifier(id.value))) return;
+				maybeReportLiteral(context, id, options);
 			}
 		};
 	}

package/dist/pack-bin.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { t as cac } from "./dist-DfmT__Aw.js";
-import { o as resolveViteConfig } from "./resolve-vite-config-CGks1xR7.js";
+import { o as resolveViteConfig } from "./resolve-vite-config-CHHjsjKJ.js";
 import module from "node:module";
 import { buildWithConfigs, enableDebug, globalLogger, resolveUserConfig } from "vite/pack";
 //#region src/pack-bin.ts

package/dist/{package-BZz2Ij68.js → package-BB-Jh_z3.js}

@@ -1,4 +1,4 @@
-import "./constants-0IAVgpox.js";
+import "./constants-IhOditRA.js";
 import { i as readJsonFile } from "./json-cULBl7Pi.js";
 import { createRequire } from "node:module";
 import path from "node:path";

package/dist/{prompts-CtzEgFY-.js → prompts-CujFOJXu.js}

@@ -1,6 +1,6 @@
 import { r as __toESM, t as __commonJSMin } from "./rolldown-runtime-CMFfr-1z.js";
 import { t as accent } from "./terminal-MKGAuy-p.js";
-import { f as VITE_PLUS_VERSION } from "./constants-0IAVgpox.js";
+import { f as VITE_PLUS_VERSION } from "./constants-IhOditRA.js";
 import { a as writeJsonFile, i as readJsonFile } from "./json-cULBl7Pi.js";
 import { t as require_semver } from "./semver-CaDAb8vV.js";
 import { n as runCommandSilently } from "./command-CguLh2KL.js";

package/dist/{resolve-vite-config-Dnmc-lBc.js → resolve-vite-config-6Nox70uP.js}

@@ -1,2 +1,2 @@
-import { a as resolveUniversalViteConfig } from "./resolve-vite-config-CGks1xR7.js";
+import { a as resolveUniversalViteConfig } from "./resolve-vite-config-CHHjsjKJ.js";
 export { resolveUniversalViteConfig };

package/dist/{resolve-vite-config-CGks1xR7.js → resolve-vite-config-CHHjsjKJ.js}

@@ -1,5 +1,5 @@
-import { l as VITE_CONFIG_FILES } from "./constants-0IAVgpox.js";
-import { u as withConfigMetadataResolution } from "./define-config-U3_xg7i-.js";
+import { l as VITE_CONFIG_FILES } from "./constants-IhOditRA.js";
+import { u as withConfigMetadataResolution } from "./define-config-DAaCa0U_.js";
 import path from "node:path";
 import fs from "node:fs";
 //#region src/resolve-vite-config.ts

package/dist/staged/bin.js

@@ -1,6 +1,6 @@
 import { r as __toESM, t as __commonJSMin } from "../rolldown-runtime-CMFfr-1z.js";
 import { i as log, n as errorMsg, o as printHeader } from "../terminal-MKGAuy-p.js";
-import { o as resolveViteConfig } from "../resolve-vite-config-CGks1xR7.js";
+import { o as resolveViteConfig } from "../resolve-vite-config-CHHjsjKJ.js";
 import { t as unwrapCliParseOutcome } from "../cli-parse-DHE8NrBU.js";
 import { createRequire } from "node:module";
 import path, { basename, delimiter, dirname, normalize, resolve } from "node:path";

package/dist/toolchain.js

@@ -4,7 +4,7 @@ export const toolchain = {
     {
       "id": "vite-plus",
       "name": "vite-plus",
-      "version": "0.3.1",
+      "version": "0.3.2",
       "kind": "package",
       "delivery": [
         "dependency"
@@ -14,7 +14,7 @@ export const toolchain = {
     {
       "id": "vite-plus-core",
       "name": "@voidzero-dev/vite-plus-core",
-      "version": "0.3.1",
+      "version": "0.3.2",
       "kind": "package",
       "delivery": [
         "dependency"
@@ -26,7 +26,7 @@ export const toolchain = {
     {
       "id": "vite",
       "name": "vite",
-      "version": "8.2.2",
+      "version": "8.3.0",
       "kind": "tool",
       "delivery": [
         "bundled"
@@ -36,7 +36,7 @@ export const toolchain = {
     {
       "id": "rolldown",
       "name": "rolldown",
-      "version": "1.2.7",
+      "version": "1.2.8",
       "kind": "tool",
       "delivery": [
         "bundled",
@@ -57,7 +57,7 @@ export const toolchain = {
     {
       "id": "oxlint",
       "name": "oxlint",
-      "version": "1.81.0",
+      "version": "1.82.0",
       "kind": "tool",
       "delivery": [
         "dependency"
@@ -67,7 +67,7 @@ export const toolchain = {
     {
       "id": "oxfmt",
       "name": "oxfmt",
-      "version": "0.66.0",
+      "version": "0.67.0",
       "kind": "tool",
       "delivery": [
         "dependency"
@@ -100,7 +100,7 @@ export const toolchain = {
       "id": "vite-task",
       "name": "vite-task",
       "revision": "d05b1dcdbaabaa69643ee0b89cebe3cd390957e9",
-      "builtAt": "2026-09-08T13:14:20Z",
+      "builtAt": "2026-09-14T14:39:37Z",
       "kind": "tool",
       "delivery": [
         "compiled"
@@ -110,7 +110,7 @@ export const toolchain = {
     {
       "id": "oxc",
       "name": "oxc",
-      "version": "0.148.0",
+      "version": "0.149.0",
       "kind": "engine",
       "delivery": [
         "compiled"

package/dist/toolchain.json

@@ -4,7 +4,7 @@
     {
       "id": "vite-plus",
       "name": "vite-plus",
-      "version": "0.3.1",
+      "version": "0.3.2",
       "kind": "package",
       "delivery": [
         "dependency"
@@ -14,7 +14,7 @@
     {
       "id": "vite-plus-core",
       "name": "@voidzero-dev/vite-plus-core",
-      "version": "0.3.1",
+      "version": "0.3.2",
       "kind": "package",
       "delivery": [
         "dependency"
@@ -26,7 +26,7 @@
     {
       "id": "vite",
       "name": "vite",
-      "version": "8.2.2",
+      "version": "8.3.0",
       "kind": "tool",
       "delivery": [
         "bundled"
@@ -36,7 +36,7 @@
     {
       "id": "rolldown",
       "name": "rolldown",
-      "version": "1.2.7",
+      "version": "1.2.8",
       "kind": "tool",
       "delivery": [
         "bundled",
@@ -57,7 +57,7 @@
     {
       "id": "oxlint",
       "name": "oxlint",
-      "version": "1.81.0",
+      "version": "1.82.0",
       "kind": "tool",
       "delivery": [
         "dependency"
@@ -67,7 +67,7 @@
     {
       "id": "oxfmt",
       "name": "oxfmt",
-      "version": "0.66.0",
+      "version": "0.67.0",
       "kind": "tool",
       "delivery": [
         "dependency"
@@ -100,7 +100,7 @@
       "id": "vite-task",
       "name": "vite-task",
       "revision": "d05b1dcdbaabaa69643ee0b89cebe3cd390957e9",
-      "builtAt": "2026-09-08T13:14:20Z",
+      "builtAt": "2026-09-14T14:39:37Z",
       "kind": "tool",
       "delivery": [
         "compiled"
@@ -110,7 +110,7 @@
     {
       "id": "oxc",
       "name": "oxc",
-      "version": "0.148.0",
+      "version": "0.149.0",
       "kind": "engine",
       "delivery": [
         "compiled"

package/dist/{tsconfig-CUggNuJR.js → tsconfig-DCtWfQPA.js}

@@ -1,6 +1,6 @@
-import { p as createBaseUrlTsconfigFixArgs, t as BASEURL_TSCONFIG_FIX_PACKAGE } from "./constants-0IAVgpox.js";
+import { p as createBaseUrlTsconfigFixArgs, t as BASEURL_TSCONFIG_FIX_PACKAGE } from "./constants-IhOditRA.js";
 import { c as parse, o as applyEdits, s as modify } from "./json-cULBl7Pi.js";
-import { S as log, b as confirm, k as isCancel, t as cancelAndExit } from "./prompts-CtzEgFY-.js";
+import { S as log, b as confirm, k as isCancel, t as cancelAndExit } from "./prompts-CujFOJXu.js";
 import { n as runCommandSilently } from "./command-CguLh2KL.js";
 import path from "node:path";
 import { styleText } from "node:util";

package/dist/{tsconfig-VAbm4ZzJ.js → tsconfig-MXktI3SX.js}

@@ -1,2 +1,2 @@
-import { a as hasBaseUrlInTsconfig, i as fixBaseUrlInTsconfig } from "./tsconfig-CUggNuJR.js";
+import { a as hasBaseUrlInTsconfig, i as fixBaseUrlInTsconfig } from "./tsconfig-DCtWfQPA.js";
 export { fixBaseUrlInTsconfig, hasBaseUrlInTsconfig };

package/dist/version.js

@@ -1,7 +1,7 @@
 import { t as renderCliDoc } from "./help-BmKpeOP9.js";
 import { i as log, o as printHeader, t as accent } from "./terminal-MKGAuy-p.js";
-import { _ as version } from "./constants-0IAVgpox.js";
-import { i as hasVitePlusDependency, n as detectPackageMetadata } from "./package-BZz2Ij68.js";
+import { _ as version } from "./constants-IhOditRA.js";
+import { i as hasVitePlusDependency, n as detectPackageMetadata } from "./package-BB-Jh_z3.js";
 import path from "node:path";
 import fs from "node:fs";
 //#region src/version.ts

package/dist/versions.js

@@ -1,9 +1,9 @@
 export const versions = {
-  "vite": "8.2.2",
-  "rolldown": "1.2.7",
+  "vite": "8.3.0",
+  "rolldown": "1.2.8",
   "vitest": "4.1.11",
-  "oxfmt": "0.66.0",
-  "oxlint": "1.81.0",
+  "oxfmt": "0.67.0",
+  "oxlint": "1.82.0",
   "oxlint-tsgolint": "7.0.2001",
   "tsdown": "0.23.0"
 };

package/docs/config/fmt.md

@@ -1,6 +1,6 @@
 # Format Config
 
-`vp fmt` and `vp check` read Oxfmt settings from the `fmt` block in `vite.config.ts`. See [Oxfmt's configuration](https://oxc.rs/docs/guide/usage/formatter/config.html) for details.
+`vp fmt` and `vp check` read Oxfmt settings from the `fmt` block in the root `vite.config.ts`. See [Oxfmt's configuration](https://oxc.rs/docs/guide/usage/formatter/config.html) for details.
 
 ## Example
 
@@ -17,4 +17,6 @@ export default defineConfig({
 });
 ```
 
-For package-specific formatting settings in a workspace, use [`fmt.overrides`](/guide/monorepo#format-overrides) from the root `vite.config.ts`.
+For file- or package-specific formatting settings, use [`fmt.overrides`](/guide/monorepo#format-overrides) from the root `vite.config.ts`.
+
+Vite+ does not currently support nested format configuration. See [troubleshooting](/guide/troubleshooting#nested-lint-or-format-config-is-not-applied) for details and how to give feedback on future support.

package/docs/config/lint.md

@@ -1,6 +1,6 @@
 # Lint Config
 
-`vp lint` and `vp check` read Oxlint settings from the `lint` block in `vite.config.ts`. See [Oxlint's configuration](https://oxc.rs/docs/guide/usage/linter/config.html) for details.
+`vp lint` and `vp check` read Oxlint settings from the `lint` block in the root `vite.config.ts`. See [Oxlint's configuration](https://oxc.rs/docs/guide/usage/linter/config.html) for details.
 
 ## Example
 
@@ -23,4 +23,6 @@ export default defineConfig({
 
 We recommend enabling both `options.typeAware` and `options.typeCheck` so `vp lint` and `vp check` can use the full type-aware path.
 
-For package-specific lint rules in a workspace, use [`lint.overrides`](/guide/monorepo#root-config-with-overrides) from the root `vite.config.ts`.
+For file- or package-specific lint rules, use [`lint.overrides`](/guide/monorepo#root-config-with-overrides) from the root `vite.config.ts`.
+
+Vite+ does not currently support nested lint configuration. See [troubleshooting](/guide/troubleshooting#nested-lint-or-format-config-is-not-applied) for details and how to give feedback on future support.

package/docs/guide/env.md

@@ -47,14 +47,36 @@ This setting also disables pnpm's automatic management of other declared runtime
 Package-manager selection uses this priority:
 
 1. Explicit command override
-2. `VP_PACKAGE_MANAGER` or the shell-session override
+2. `VP_PACKAGE_MANAGER`
 3. Top-level `packageManager`
 4. `devEngines.packageManager`
 5. Lockfile or manager-specific configuration
 6. The named package manager's global default version
 7. The named shim's latest release
 
-A selected manager controls only its named shims. For example, pnpm controls `pnpm` and `pnpx`; invoking `npm` still resolves npm independently. Alias pairs are `npm`/`npx`, `pnpm`/`pnpx`, `yarn`/`yarnpkg`, and `bun`/`bunx`. Without a matching project selection, a named shim uses its configured default version and otherwise uses the latest release without prompting. The resolved version is cached for one hour and an expired cache remains available when the registry cannot be reached. The directly invoked npm shim keeps its Node-bundled fallback, while an explicit `vp env ... npm` family scope uses standalone npm's latest release.
+`VP_PACKAGE_MANAGER` selects the manager and version for commands such as `vp install`. Direct package-manager shims ignore this variable and use independent version overrides:
+
+| Variable          | Shims             |
+| ----------------- | ----------------- |
+| `VP_NPM_VERSION`  | `npm`, `npx`      |
+| `VP_PNPM_VERSION` | `pnpm`, `pnpx`    |
+| `VP_YARN_VERSION` | `yarn`, `yarnpkg` |
+| `VP_BUN_VERSION`  | `bun`, `bunx`     |
+
+These variables accept a version or range, such as `10.18.0`, `10`, or `latest`, and override the matching shim's project and default versions. They do not change the manager or version selected by `vp install`.
+
+`vp env use pnpm@10.20.0` sets `VP_PNPM_VERSION` for the current shell, just as `vp env use node@22` sets `VP_NODE_VERSION`. Each package manager has its own override, so switching Yarn does not clear a pnpm override. `vp env use` does not set or clear `VP_PACKAGE_MANAGER`.
+
+Direct shims resolve their version from the matching environment variable, then the matching session file when no shell wrapper is available, then project configuration and the family default. `vp env current pnpm` and `vp env which pnpm` inspect this shim selection; `vp env current pm` reports the manager selected for vp commands.
+
+```bash
+VP_PACKAGE_MANAGER=pnpm@10.18.0 vp install
+VP_PNPM_VERSION=10.20.0 pnpm --version
+```
+
+The overrides apply in managed mode. A package manager can also perform its own version switching after Vite+ launches it; for example, pnpm's `managePackageManagerVersions` setting may switch back to the version in `package.json`.
+
+A project selection applies only to its matching shims. For example, pnpm controls `pnpm` and `pnpx`; invoking `npm` still resolves npm independently. Without a matching project selection, a named shim uses its configured default version and otherwise uses the latest release without prompting. The resolved version is cached for one hour and an expired cache remains available when the registry cannot be reached. The directly invoked npm shim keeps its Node-bundled fallback, while an explicit `vp env ... npm` family scope uses standalone npm's latest release.
 
 A fresh install uses the split platform layout by default. On Unix, Vite+
 stores managed runtimes and related files in `~/.local/share/vite-plus`. It
@@ -130,13 +152,14 @@ vp-use --unset
 Only `vp env use` needs this alternate command. Other `vp env` commands work normally in Command Prompt. `vp env setup` creates `vp-use.cmd` in the bin directory on Windows.
 
 In CI, `vp env use` can run without shell initialization. It writes a temporary
-Node.js or package-manager session file in the resolved state directory. Later
+session file per runtime or package manager in the resolved state directory,
+such as `.session-node-version` or `.session-pnpm-version`. Later
 shim calls in the same job use these files to resolve the same environment.
 
 ### Manage
 
 - `vp env default` shows the global Node.js default and each configured package-manager version. Bare versions set Node.js; qualified specs such as `pnpm@10.18.0` set that package manager's shim default without replacing the defaults for Bun, Yarn, or npm. `--unset` clears all defaults unless scoped.
-- `vp env pin` shows or writes project pins. Existing `.node-version` and top-level `packageManager` fields keep being updated for compatibility; otherwise Vite+ writes the matching `devEngines` entry. Use `--target node-version`, `--target dev-engines`, or `--target package-manager` to choose explicitly.
+- `vp env pin` shows or writes project pins. Existing `.node-version` and top-level `packageManager` fields keep being updated for compatibility. An existing `.nvmrc` is updated when it is the effective Node source in the current directory; its comments and other non-version content are preserved. Otherwise Vite+ writes the matching `devEngines` entry. Use `--target node-version`, `--target nvmrc`, `--target dev-engines`, or `--target package-manager` to choose explicitly. Pinning in a child directory does not modify an inherited `.nvmrc`.
 - `vp env unpin` removes both effective pins by default; append a selector to remove one. Lower-priority declarations are not deleted.
 - `vp env use` activates the complete project environment. Explicit specs override selected components; `--unset` clears both unless scoped.
 - `vp env install` installs the complete resolved environment, a selected component, or explicit specs.
@@ -175,7 +198,8 @@ vp env install                # Install the complete resolved environment
 vp env default node@24        # Set the global Node.js default
 vp env default pnpm@10        # Set pnpm's global default version
 vp env use 20 pnpm@10         # Override both components for this shell
-vp env use --unset pm         # Remove only the PM session override
+vp env use --unset pnpm       # Remove only the pnpm session version
+vp env use --unset pm         # Remove all package-manager session versions
 vp env clean                  # Remove unused managed Node.js and package manager versions
 
 # Inspect

package/docs/guide/fmt.md

@@ -18,7 +18,9 @@ vp fmt . --write
 
 ## Configuration
 
-Put formatting configuration directly in the `fmt` block in `vite.config.ts` so all your configuration stays in one place. We do not recommend using `.oxfmtrc.json` with Vite+.
+Put formatting configuration directly in the `fmt` block in the root `vite.config.ts` so all your configuration stays in one place. We do not recommend using `.oxfmtrc.json` with Vite+.
+
+Vite+ does not currently support nested format configuration. For now, use [`fmt.overrides`](/guide/monorepo#format-overrides) in the root `vite.config.ts` for file- or package-specific options. The long-term behavior is open for discussion; [share your use case and expectations](/guide/troubleshooting#nested-lint-or-format-config-is-not-applied) to help shape it.
 
 For editors, disable nested formatter configs so format-on-save uses the root Vite+ `fmt` block:
 

package/docs/guide/install.md

@@ -140,6 +140,7 @@ Use `vp add` and `vp remove` for day-to-day dependency edits instead of editing
 - `vp add -D typescript vitest`
 - `vp add -O fsevents`
 - `vp add --save-peer react`
+- `vp add react --ignore-scripts`
 - `vp remove react`
 - `vp remove --filter web react`
 

package/docs/guide/installer-env-vars.md

@@ -81,7 +81,7 @@ These variables control the installer scripts and the standalone Windows install
 
 ### `VP_NODE_MANAGER`
 
-- **Purpose**: Control Node.js version manager setup during installation
+- **Purpose**: Control Node.js version manager setup during installation.
 - **Values**: `yes` or `no`
 - **Default**: Auto-detected
 - **CLI equivalent**: `--no-node-manager` (inverted)
@@ -91,6 +91,40 @@ These variables control the installer scripts and the standalone Windows install
   curl -fsSL https://vite.plus | VP_NODE_MANAGER=no bash
   ```
 
+### `VP_PM_MANAGER`
+
+- **Purpose**: Set the management preference for all four package-manager
+  families: npm, pnpm, Yarn, and Bun.
+- **Values**: `yes` uses Vite+ management; `no` prefers system tools, with
+  managed tools as a fallback when a system tool is unavailable.
+- **Default**: Unset. The installer's combined Node.js and package-manager
+  choice remains the default. With the script installers, setting only
+  `VP_NODE_MANAGER` preserves existing package-manager preferences.
+
+### `VP_NPM_MANAGER` / `VP_PNPM_MANAGER` / `VP_YARN_MANAGER` / `VP_BUN_MANAGER`
+
+- **Purpose**: Set the management preference for an individual package-manager
+  family. Each variable overrides `VP_PM_MANAGER` for that family.
+- **Values**: `yes` or `no`, with the same meaning as `VP_PM_MANAGER`.
+- **Default**: Unset (use `VP_PM_MANAGER`, then the combined installer choice,
+  or preserve the existing preference).
+- **Example**:
+
+  ```bash
+  # Keep system Node.js and package managers, but let Vite+ manage pnpm.
+  curl -fsSL https://vite.plus | VP_NODE_MANAGER=no VP_PM_MANAGER=no VP_PNPM_MANAGER=yes bash
+  ```
+
+These management variables are installation choices, saved in Vite+'s config.
+The interactive prompt still controls both Node.js and package managers;
+explicit package-manager variables override that combined choice. The standalone
+`vp-setup` installer uses its existing combined option as the default for both
+variables, in interactive and silent installations alike.
+In-place upgrades preserve the saved choices. Unrecognized values are ignored.
+They select management behavior, not package-manager versions, and do not
+prevent the installer from creating shims. Older releases installed through
+the legacy installer retain their original behavior.
+
 ### `VP_PR_VERSION`
 
 - **Purpose**: Install a preview build from a pull request or commit SHA