vite-plus 0.2.7 → 0.2.8

package/dist/{rolldown-runtime-C7HZzL1F.js → rolldown-runtime-CMFfr-1z.js}

@@ -17,7 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

package/dist/staged/bin.js

@@ -1,19 +1,18 @@
-import { r as __toESM, t as __commonJSMin } from "../rolldown-runtime-C7HZzL1F.js";
-import { a as printHeader, n as errorMsg, r as log } from "../terminal-uTv0ZaMr.js";
-import { a as resolveViteConfig } from "../resolve-vite-config-BiuLZnn8.js";
+import { r as __toESM, t as __commonJSMin } from "../rolldown-runtime-CMFfr-1z.js";
+import { a as printHeader, c as renderCliDoc, n as errorMsg, r as log } from "../terminal-CrqqK8WT.js";
+import { a as resolveViteConfig } from "../resolve-vite-config-EWXclqvV.js";
 import { t as lib_default } from "../lib-L3DWSRQp.js";
-import { t as renderCliDoc } from "../help-YP84FSEz.js";
 import { createRequire } from "node:module";
 import path, { basename, delimiter, dirname, normalize, resolve } from "node:path";
-import { closeSync, constants, openSync, readSync, statSync } from "node:fs";
 import { formatWithOptions, inspect, promisify } from "node:util";
+import { closeSync, constants, openSync, readSync, statSync } from "node:fs";
+import { EOL } from "node:os";
 import { cwd } from "node:process";
 import l__default from "node:readline";
 import nodeTty from "node:tty";
 import crypto from "node:crypto";
 import { pathToFileURL } from "node:url";
-import { EOL } from "node:os";
-import fsPromises, { constants as constants$1 } from "node:fs/promises";
+import fsPromises, { constants as constants$2 } from "node:fs/promises";
 import { PassThrough, Writable } from "node:stream";
 import { exec, spawn } from "node:child_process";
 import { pipeline } from "node:stream/promises";
@@ -1545,8 +1544,8 @@ var DefaultRenderer = class DefaultRenderer {
 		this.logger.options.color = this.options.color;
 	}
 	async render() {
-		const { createLogUpdate } = await import("../log-update-DHZRyJ2m.js");
-		const { default: truncate } = await import("../cli-truncate-BVOlIIPy.js");
+		const { createLogUpdate } = await import("../log-update-CoW8Z4Dl.js");
+		const { default: truncate } = await import("../cli-truncate-Bg3RDXpi.js");
 		const { default: wrap } = await import("../wrap-ansi-DUi52C6W.js");
 		this.updater = createLogUpdate(this.logger.process.stdout);
 		this.truncate = truncate;
@@ -1753,9 +1752,7 @@ var DefaultRenderer = class DefaultRenderer {
 			});
 			task.on(ListrTaskEventType.STATE, (state) => {
 				switch (state) {
-					case ListrTaskState.RETRY || ListrTaskState.ROLLING_BACK:
-						this.buffer.bottom.delete(task.id);
-						break;
+					case ListrTaskState.RETRY || ListrTaskState.ROLLING_BACK: this.buffer.bottom.delete(task.id);
 				}
 			});
 		} else if (this.shouldOutputToOutputBar(task) && !this.buffer.output.has(task.id)) {
@@ -1765,9 +1762,7 @@ var DefaultRenderer = class DefaultRenderer {
 			});
 			task.on(ListrTaskEventType.STATE, (state) => {
 				switch (state) {
-					case ListrTaskState.RETRY || ListrTaskState.ROLLING_BACK:
-						this.buffer.output.delete(task.id);
-						break;
+					case ListrTaskState.RETRY || ListrTaskState.ROLLING_BACK: this.buffer.output.delete(task.id);
 				}
 			});
 		}
@@ -3012,7 +3007,7 @@ var require_constants = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 	};
 	module.exports = {
 		DEFAULT_MAX_EXTGLOB_RECURSION,
-		MAX_LENGTH: 1024 * 64,
+		MAX_LENGTH: 65536,
 		POSIX_REGEX_SOURCE: {
 			__proto__: null,
 			alnum: "a-zA-Z0-9",
@@ -4898,13 +4893,14 @@ const generateTasks = ({ config, cwd = process.cwd(), files, relative = false })
 	}));
 	return Object.entries(config).map(([pattern, commands]) => {
 		const isParentDirPattern = pattern.startsWith("../");
+		const includedFiles = relativeFiles.filter((file) => {
+			if (isParentDirPattern) return true;
+			return !file.filepath.startsWith("..") && !path.isAbsolute(file.filepath);
+		});
 		const task = {
 			pattern,
 			commands,
-			fileList: matchFiles(relativeFiles.filter((file) => {
-				if (isParentDirPattern) return true;
-				return !file.filepath.startsWith("..") && !path.isAbsolute(file.filepath);
-			}), pattern, cwd).map((file) => ({
+			fileList: matchFiles(includedFiles, pattern, cwd).map((file) => ({
 				filepath: normalizePath(relative ? file.filepath : path.resolve(cwd, file.filepath)),
 				status: file.status
 			}))
@@ -5946,7 +5942,7 @@ const jsonParse = async (filename) => {
 const yamlParse = async (filename) => {
 	const isPackageFile = PACKAGE_YAML_FILES.includes(path.basename(filename));
 	try {
-		const [YAML, content] = await Promise.all([import("../dist-CtM2JRbM.js").then((m) => /* @__PURE__ */ __toESM(m.default, 1)), readFile(filename)]);
+		const [YAML, content] = await Promise.all([import("../dist-DT25H9pj.js").then((m) => /* @__PURE__ */ __toESM(m.default, 1)), readFile(filename)]);
 		const yaml = YAML.parse(content);
 		return isPackageFile ? yaml[CONFIG_NAME] : yaml;
 	} catch (error) {
@@ -6206,7 +6202,7 @@ const listConfigFilesFromFs = async ({ cwd }) => {
 	debugLog$3("Listing possible configs from filesystem starting from \"%s\"...", cwd);
 	const possibleConfigFiles = (await Promise.allSettled(CONFIG_FILE_NAMES.map(async (f) => {
 		const filepath = path.join(cwd, f);
-		await fsPromises.access(filepath, constants$1.F_OK);
+		await fsPromises.access(filepath, constants$2.F_OK);
 		return filepath;
 	}))).flatMap((r) => r.status === "fulfilled" ? [normalizePath(r.value)] : []);
 	if (possibleConfigFiles.length > 0) {
@@ -6752,7 +6748,8 @@ if (args.help) {
 	try {
 		stagedConfig = (await resolveViteConfig(args.cwd ?? process.cwd())).staged;
 	} catch (err) {
-		log(`Failed to load vite.config: ${err instanceof Error ? err.message : String(err)}`);
+		const message = err instanceof Error ? err.message : String(err);
+		log(`Failed to load vite.config: ${message}`);
 		process.exit(1);
 	}
 	if (stagedConfig) options.config = stagedConfig;

package/dist/{help-YP84FSEz.js → terminal-CrqqK8WT.js}

@@ -1,3 +1,4 @@
+import { shouldPrintVitePlusHeader, vitePlusHeader } from "../binding/index.js";
 import { stripVTControlCharacters, styleText } from "node:util";
 //#region src/utils/help.ts
 function toLines(value) {
@@ -31,6 +32,12 @@ function heading(label, color) {
 	if (!color) return `${label}:`;
 	return label === "Usage" ? styleText("bold", `${label}:`) : styleText(["blue", "bold"], `${label}:`);
 }
+function renderMutedCommentSuffix(line, color) {
+	if (!color) return line;
+	const commentIndex = line.indexOf(" #");
+	if (commentIndex === -1) return line;
+	return `${line.slice(0, commentIndex)}${styleText("gray", line.slice(commentIndex))}`;
+}
 function renderCliDoc(doc, options = {}) {
 	const color = options.color ?? true;
 	const output = [];
@@ -47,7 +54,7 @@ function renderCliDoc(doc, options = {}) {
 		if (output.length > 0) output.push("");
 		output.push(heading(section.title, color));
 		const lines = toLines(section.lines);
-		if (lines.length > 0) output.push(...lines);
+		if (lines.length > 0) output.push(...lines.map((line) => renderMutedCommentSuffix(line, color)));
 		if (section.rows && section.rows.length > 0) output.push(...renderRows(section.rows));
 	}
 	if (doc.documentationUrl) {
@@ -58,4 +65,34 @@ function renderCliDoc(doc, options = {}) {
 	return output.join("\n");
 }
 //#endregion
-export { renderCliDoc as t };
+//#region src/utils/terminal.ts
+function log(message) {
+	console.log(message);
+}
+/**
+* Emit the Vite+ banner (header line + trailing blank line) to stdout.
+* Gating (non-TTY, git hooks) lives in `shouldPrintVitePlusHeader` on the
+* Rust side so both CLIs stay in sync.
+*/
+function printHeader() {
+	if (!shouldPrintVitePlusHeader()) return;
+	log(vitePlusHeader());
+	log("");
+}
+function accent(text) {
+	return styleText("blue", text);
+}
+function muted(text) {
+	return styleText("gray", text);
+}
+function success(text) {
+	return styleText("green", text);
+}
+function warnMsg(msg) {
+	console.error(styleText(["yellow", "bold"], "warn:"), msg);
+}
+function errorMsg(msg) {
+	console.error(styleText(["red", "bold"], "error:"), msg);
+}
+//#endregion
+export { printHeader as a, renderCliDoc as c, muted as i, errorMsg as n, success as o, log as r, warnMsg as s, accent as t };

package/dist/tsconfig-CVUKLfL8.js

@@ -0,0 +1,151 @@
+import { t as BASEURL_TSCONFIG_FIX_PACKAGE, u as createBaseUrlTsconfigFixArgs } from "./constants-BppDcRc1.js";
+import { A as isCancel, C as log, M as runCommandSilently, t as cancelAndExit, x as confirm } from "./prompts-DYap08te.js";
+import { c as parse, o as applyEdits, s as modify } from "./json-BU88uu6o.js";
+import path from "node:path";
+import { styleText } from "node:util";
+import fs from "node:fs";
+//#region src/utils/tsconfig.ts
+/**
+* Check if tsconfig.json has compilerOptions.baseUrl set.
+* oxlint's TypeScript checker (tsgolint) does not support baseUrl,
+* so typeAware/typeCheck must be disabled when it is present.
+*/
+function hasBaseUrlInTsconfigFile(filePath) {
+	try {
+		return parse(fs.readFileSync(filePath, "utf-8"))?.compilerOptions?.baseUrl != null;
+	} catch {
+		return false;
+	}
+}
+const TSCONFIG_FILE_RE = /^tsconfig(\.[\w-]+)?\.json$/i;
+function findTsconfigFiles(projectPath) {
+	try {
+		return fs.readdirSync(projectPath).filter((name) => TSCONFIG_FILE_RE.test(name)).map((name) => path.join(projectPath, name));
+	} catch {
+		return [];
+	}
+}
+function hasBaseUrlInTsconfig(projectPath) {
+	return findTsconfigFiles(projectPath).some((filePath) => hasBaseUrlInTsconfigFile(filePath));
+}
+function findTsconfigFilesWithBaseUrl(projectPath) {
+	return findTsconfigFiles(projectPath).filter((filePath) => hasBaseUrlInTsconfigFile(filePath));
+}
+async function confirmBaseUrlFix(interactive) {
+	if (!interactive) return true;
+	const command = [BASEURL_TSCONFIG_FIX_PACKAGE, ...createBaseUrlTsconfigFixArgs("<tsconfig path>")].join(" ");
+	const confirmed = await confirm({
+		message: "Your tsconfig contains `baseUrl`, which prevents enabling type-aware linting.\n  " + styleText("gray", "`baseUrl` is deprecated in TypeScript 6.0 and removed in TypeScript 7.0.") + `\n  Download and run the external \`${BASEURL_TSCONFIG_FIX_PACKAGE}\` fixer now?\n  ` + styleText("gray", `Equivalent command: \`vp dlx ${command}\``),
+		initialValue: true
+	});
+	if (isCancel(confirmed)) cancelAndExit();
+	return confirmed;
+}
+async function fixBaseUrlInTsconfig(projectPath, options) {
+	const files = findTsconfigFilesWithBaseUrl(projectPath);
+	if (files.length === 0) return "not-needed";
+	if (!(options?.confirmed ?? await confirmBaseUrlFix(options?.interactive ?? false))) {
+		options?.onStatus?.("declined", projectPath);
+		return "declined";
+	}
+	try {
+		for (const filePath of files) {
+			const target = path.relative(projectPath, filePath) || filePath;
+			const fixArgs = createBaseUrlTsconfigFixArgs(target);
+			if (!options?.silent) log.info(`Running vp dlx ${BASEURL_TSCONFIG_FIX_PACKAGE} ${fixArgs.join(" ")}`);
+			const result = await runCommandSilently({
+				command: process.env.VP_CLI_BIN ?? "vp",
+				args: [
+					"dlx",
+					BASEURL_TSCONFIG_FIX_PACKAGE,
+					...fixArgs
+				],
+				cwd: projectPath,
+				envs: process.env
+			});
+			if (result.exitCode !== 0) {
+				if (!options?.silent) {
+					const output = `${result.stdout.toString()}${result.stderr.toString()}`.trim();
+					if (output) log.warn(output);
+				}
+				options?.onStatus?.("failed", projectPath);
+				return "failed";
+			}
+		}
+		if (hasBaseUrlInTsconfig(projectPath)) {
+			if (!options?.silent) log.warn("tsconfig still contains baseUrl after running the fixer.");
+			options?.onStatus?.("failed", projectPath);
+			return "failed";
+		}
+	} catch (error) {
+		if (!options?.silent && error instanceof Error) log.warn(error.message);
+		options?.onStatus?.("failed", projectPath);
+		return "failed";
+	}
+	options?.onStatus?.("fixed", projectPath);
+	return "fixed";
+}
+function removeDeprecatedTsconfigFalseOption(filePath, optionName) {
+	let text;
+	try {
+		text = fs.readFileSync(filePath, "utf-8");
+	} catch {
+		return false;
+	}
+	if (parse(text)?.compilerOptions?.[optionName] !== false) return false;
+	const edits = modify(text, ["compilerOptions", optionName], void 0, {});
+	if (edits.length === 0) return false;
+	const newText = applyEdits(text, edits);
+	fs.writeFileSync(filePath, newText);
+	return true;
+}
+const TSCONFIG_TYPE_REPLACEMENTS = { "tsdown/client": "vite-plus/pack/client" };
+function hasTypesToRewriteInTsconfig(filePath) {
+	let text;
+	try {
+		text = fs.readFileSync(filePath, "utf-8");
+	} catch {
+		return false;
+	}
+	const types = parse(text)?.compilerOptions?.types;
+	return Array.isArray(types) && types.some((t) => typeof t === "string" && t in TSCONFIG_TYPE_REPLACEMENTS);
+}
+function hasVitestTypesInTsconfig(filePath) {
+	let text;
+	try {
+		text = fs.readFileSync(filePath, "utf-8");
+	} catch {
+		return false;
+	}
+	const types = parse(text)?.compilerOptions?.types;
+	return Array.isArray(types) && types.some((type) => typeof type === "string" ? type === "vitest" || type.startsWith("vitest/") : false);
+}
+function rewriteTypesInTsconfig(filePath) {
+	let text;
+	try {
+		text = fs.readFileSync(filePath, "utf-8");
+	} catch {
+		return false;
+	}
+	const types = parse(text)?.compilerOptions?.types;
+	if (!Array.isArray(types)) return false;
+	const toReplace = types.map((t, i) => typeof t === "string" && t in TSCONFIG_TYPE_REPLACEMENTS ? {
+		i,
+		newVal: TSCONFIG_TYPE_REPLACEMENTS[t]
+	} : null).filter((x) => x !== null);
+	if (toReplace.length === 0) return false;
+	let currentText = text;
+	for (let j = toReplace.length - 1; j >= 0; j--) {
+		const { i, newVal } = toReplace[j];
+		const edits = modify(currentText, [
+			"compilerOptions",
+			"types",
+			i
+		], newVal, {});
+		if (edits.length > 0) currentText = applyEdits(currentText, edits);
+	}
+	fs.writeFileSync(filePath, currentText);
+	return true;
+}
+//#endregion
+export { hasTypesToRewriteInTsconfig as a, rewriteTypesInTsconfig as c, hasBaseUrlInTsconfig as i, findTsconfigFiles as n, hasVitestTypesInTsconfig as o, fixBaseUrlInTsconfig as r, removeDeprecatedTsconfigFalseOption as s, confirmBaseUrlFix as t };

package/dist/{tsgolint-path-B-yOos8p.js → tsgolint-path-eMZT-oea.js}

@@ -14,7 +14,8 @@ function resolveTsgolintExecutable(tsgolintBinPath, scriptUrl) {
 	if (process.platform !== "win32") return tsgolintBinPath;
 	const scriptDir = dirname(fileURLToPath(scriptUrl));
 	const localBinDir = join(scriptDir, "..", "node_modules", ".bin");
-	const projectBinDir = join(dirname(dirname(tsgolintBinPath)), "..", ".bin");
+	const oxlintTsgolintPackagePath = dirname(dirname(tsgolintBinPath));
+	const projectBinDir = join(oxlintTsgolintPackagePath, "..", ".bin");
 	return resolveWindowsTsgolintExecutable([
 		join(localBinDir, "tsgolint.exe"),
 		join(localBinDir, "tsgolint.cmd"),
@@ -23,7 +24,8 @@ function resolveTsgolintExecutable(tsgolintBinPath, scriptUrl) {
 	], {
 		exists: existsSync,
 		getRealpathCandidates: () => {
-			const realBinDir = join(dirname(realpathSync(join(scriptDir, ".."))), ".bin");
+			const realPkgDir = realpathSync(join(scriptDir, ".."));
+			const realBinDir = join(dirname(realPkgDir), ".bin");
 			return [join(realBinDir, "tsgolint.exe"), join(realBinDir, "tsgolint.cmd")];
 		}
 	});

package/dist/tsgolint-path.js

@@ -1,2 +1,2 @@
-import { n as resolveWindowsTsgolintExecutable, t as resolveTsgolintExecutable } from "./tsgolint-path-B-yOos8p.js";
+import { n as resolveWindowsTsgolintExecutable, t as resolveTsgolintExecutable } from "./tsgolint-path-eMZT-oea.js";
 export { resolveTsgolintExecutable, resolveWindowsTsgolintExecutable };

package/dist/version.js

@@ -1,7 +1,6 @@
-import { m as version } from "./constants-BsuzPowC.js";
-import { a as printHeader, r as log, t as accent } from "./terminal-uTv0ZaMr.js";
-import { i as hasVitePlusDependency, n as detectPackageMetadata } from "./package-Ds3uThLb.js";
-import { t as renderCliDoc } from "./help-YP84FSEz.js";
+import { a as printHeader, c as renderCliDoc, r as log, t as accent } from "./terminal-CrqqK8WT.js";
+import { m as version } from "./constants-BppDcRc1.js";
+import { i as hasVitePlusDependency, n as detectPackageMetadata } from "./package-hV-77cBb.js";
 import path from "node:path";
 import fs from "node:fs";
 //#region src/version.ts
@@ -30,7 +29,8 @@ function isVitePlusDeclaredInAncestors(cwd) {
 	while (true) {
 		const packageJsonPath = path.join(currentDir, "package.json");
 		try {
-			if (hasVitePlusDependency(JSON.parse(fs.readFileSync(packageJsonPath, "utf8")))) return true;
+			const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+			if (hasVitePlusDependency(pkg)) return true;
 		} catch {}
 		const parentDir = path.dirname(currentDir);
 		if (parentDir === currentDir) break;

package/dist/versions.js

@@ -1,9 +1,9 @@
 export const versions = {
-  "vite": "8.1.5",
-  "rolldown": "1.2.0",
+  "vite": "8.2.0",
+  "rolldown": "1.2.2",
   "tsdown": "0.22.14",
-  "oxlint": "1.75.0",
-  "oxfmt": "0.60.0",
+  "oxlint": "1.76.0",
+  "oxfmt": "0.61.0",
   "oxlint-tsgolint": "7.0.2001",
   "vitest": "4.1.10"
 };

package/docs/config/index.md

@@ -33,3 +33,16 @@ Vite+ extends the basic Vite configuration with these additions:
 - [`test`](/config/test) for Vitest
 - [`pack`](/config/pack) for tsdown
 - [`staged`](/config/staged) for staged-file checks
+- [`defaultPackage`](#defaultpackage) for the default target of bare app commands at a workspace root
+
+## defaultPackage
+
+Default target directory for `vp dev` / `vp build` / `vp preview` / `vp pack` when you invoke them bare in the directory containing the config, an implicit [`vp -C <dir>`](/guide/monorepo#app-commands):
+
+```ts [vite.config.ts]
+export default {
+  defaultPackage: './frontend',
+};
+```
+
+vp reads the values without executing the config, so `defaultPackage` also works at repository roots with no vite-plus dependency (for example a Laravel or Rails repo whose Vite app lives in `frontend/`, with vite-plus installed only there). That static read is why the values must stay plain string literals rather than expressions. An explicit `-C` or positional target always wins over the config.

package/docs/config/staged.md

@@ -1,6 +1,7 @@
 # Staged Config
 
-`vp staged` and `vp config` read staged-file rules from the `staged` block in `vite.config.ts`. See the [Commit hooks guide](/guide/commit-hooks).
+`vp staged` reads staged-file rules from the `staged` block in `vite.config.ts`. See the
+[Commit hooks guide](/guide/commit-hooks).
 
 ## Example
 

package/docs/guide/commit-hooks.md

@@ -1,6 +1,7 @@
 # Commit Hooks
 
-Use `vp config` to install commit hooks, and `vp staged` to run checks on staged files.
+Use `vp config` to install the Git hook dispatcher, and `vp staged` to run checks on staged
+files.
 
 ## Overview
 
@@ -8,7 +9,7 @@ Vite+ supports commit hooks and staged-file checks without additional tooling.
 
 Use:
 
-- `vp config` to set up project hooks and related integrations
+- `vp config` to install generated hook infrastructure and related integrations
 - `vp staged` to run checks against the files currently staged in Git
 
 If you use [`vp create`](/guide/create) or [`vp migrate`](/guide/migrate), Vite+ prompts you to set this up for your project automatically.
@@ -17,7 +18,9 @@ If you use [`vp create`](/guide/create) or [`vp migrate`](/guide/migrate), Vite+
 
 ### `vp config`
 
-`vp config` configures Vite+ for the current project. It installs Git hooks, sets up the hook directory, and can also handle related project integration such as agent setup. By default, hooks are written to `.vite-hooks`:
+`vp config` configures Vite+ for the current project. It installs the generated Git hook
+dispatcher and can also handle related project integration such as agent setup. By default,
+project hooks are read from `.vite-hooks`:
 
 ```bash
 vp config
@@ -26,16 +29,21 @@ vp config --no-hooks
 vp config --no-agent
 ```
 
-Use `--no-hooks` when you want `vp config` to leave existing Git hook setup unchanged. Use
-`--no-agent` when you want it to skip updates to existing coding agent instruction files. You
-can pass both flags when you want `vp config` to skip both setup steps.
+Use `--no-hooks` when you want `vp config` to leave the Git hook dispatcher unchanged. Use
+`--no-agent` when you want it to skip updates to existing coding agent instruction files. You can
+pass both flags when you want `vp config` to skip both setup steps.
 
-You can also set `VITE_GIT_HOOKS=0` to disable hook installation from lifecycle scripts such as
+You can also set `VP_GIT_HOOKS=0` to disable hook installation from lifecycle scripts such as
 `prepare` or `postinstall`.
 
+Project-owned hook scripts such as `.vite-hooks/pre-commit` should be committed to the repository.
+The generated dispatcher and shims under `.vite-hooks/_` are ignored and recreated by `vp config`.
+`vp config` does not create or modify project hook scripts or staged-file configuration.
+
 ### `vp staged`
 
-`vp staged` runs staged-file checks using the `staged` config from `vite.config.ts`. If you set up Vite+ to handle your commit hooks, it will automatically run when you commit your local changes.
+`vp staged` runs staged-file checks using the `staged` config from `vite.config.ts`. To run it
+before each commit, add it to the project-owned pre-commit hook:
 
 ```bash
 vp staged
@@ -43,6 +51,10 @@ vp staged --verbose
 vp staged --fail-on-changes
 ```
 
+```sh [.vite-hooks/pre-commit]
+vp staged
+```
+
 ## Configuration
 
 Define staged-file checks in the `staged` block in `vite.config.ts`:
@@ -57,7 +69,12 @@ export default defineConfig({
 });
 ```
 
-This is the default Vite+ approach and should replace separate `lint-staged` configuration in most projects. Because `vp staged` reads from `vite.config.ts`, your staged-file checks stay in the same place as your lint, format, test, build, and task-runner config.
+This is the default Vite+ approach and should replace separate `lint-staged` configuration in most
+projects. When you opt into hooks during `vp create`, Vite+ scaffolds both this configuration and
+the corresponding pre-commit hook. During `vp migrate`, existing hook policy is preserved, and
+the default is introduced only when no existing hook policy is found. Because
+`vp staged` reads from `vite.config.ts`, your staged-file checks stay in the same place as your
+lint, format, test, build, and task-runner config.
 
 ## Disabling Hooks in Specific Environments
 
@@ -65,13 +82,13 @@ The installed hooks check the environment on every run, so you can disable them
 
 ### Environment variable
 
-Set `VITE_GIT_HOOKS=0` in the environment of the process that runs `git commit`, and every Vite+ hook exits immediately without running:
+Set `VP_GIT_HOOKS=0` in the environment of the process that runs `git commit`, and every Vite+ hook exits immediately without running:
 
 ```bash
-VITE_GIT_HOOKS=0 git commit -m "content update"
+VP_GIT_HOOKS=0 git commit -m "content update"
 ```
 
-`HUSKY=0` is honored the same way for ecosystem tooling compatibility. Setting `VITE_GIT_HOOKS=0` in an environment also keeps `vp config` from reinstalling hooks there when a lifecycle script such as `prepare` runs.
+`HUSKY=0` is honored the same way for ecosystem tooling compatibility. Setting `VP_GIT_HOOKS=0` in an environment also keeps `vp config` from reinstalling hooks there when a lifecycle script such as `prepare` runs.
 
 ### Init script
 
@@ -83,27 +100,28 @@ Before checking the environment variable, each hook sources an init script if on
 To disable hooks for a whole machine, create the init script and export the variable there:
 
 ```sh [~/.config/vite-plus/hooks-init.sh]
-export VITE_GIT_HOOKS=0
+export VP_GIT_HOOKS=0
 ```
 
 Because the hook itself reads this file, it works even when the committing process does not inherit your shell environment, for example if a daemon or web server is making commits.
 
 ## Removing commit hooks
 
-To fully remove Vite+ commit hooks, undo each thing `vp config` set up:
+To stop using the Vite+ hook dispatcher:
+
+1. Remove `vp config` from the `prepare` or `postinstall` script in `package.json`.
 
-1. Unset the Git hooks path that points at the Vite+ dispatcher:
+2. Unset the Git hooks path that points at the Vite+ dispatcher:
 
 ```bash
 git config --unset core.hooksPath
 ```
 
-2. Remove the hooks directory (use your `--hooks-dir` value if you changed it):
+3. Remove the generated dispatcher directory (use your `--hooks-dir` value if you changed it):
 
 ```bash
-rm -rf .vite-hooks
+rm -rf .vite-hooks/_
 ```
 
-3. Remove `vp config` from the `prepare` script in `package.json`. Otherwise the next install re-runs `vp config` and reinstalls the hooks.
-
-4. Remove the `staged` block from `vite.config.ts` if it exists
+Project-owned scripts such as `.vite-hooks/pre-commit` and the `staged` block in `vite.config.ts`
+can remain for later use, or you can remove them separately if the project no longer needs them.

package/docs/guide/env.md

@@ -6,12 +6,16 @@
 
 Managed mode is on by default, so `node`, `npm`, and related shims resolve through Vite+ and pick the right Node.js version for the current project.
 
-The project Node.js version is resolved from these sources, in priority order:
+Vite+ checks the current directory first, then walks up through its parents. The nearest directory
+with a supported declaration wins. Within each directory, sources are checked in this order:
 
-1. `.node-version` file (current or parent directories)
+1. `.node-version` file
 2. `devEngines.runtime` in `package.json` (the [devEngines standard](https://docs.npmjs.com/cli/v11/configuring-npm/package-json#devengines))
 3. `engines.node` in `package.json`
-4. The global default (`vp env default`), then the latest LTS
+4. `.nvmrc` file
+
+If no directory declares a version, Vite+ uses the global default (`vp env default`) and then the
+latest LTS.
 
 `devEngines.runtime` ranks above `engines.node` because it declares the development-environment requirement, while `engines.node` is a consumer-facing support range. `vp env doctor` warns when declared sources conflict.
 
@@ -112,7 +116,7 @@ vp env print                  # Print shell snippet for this session
 
 # Manage
 vp env pin lts                # Pin the project to the latest LTS release
-vp env install                # Install the version from .node-version or package.json
+vp env install                # Install the version from .node-version, package.json, or .nvmrc
 vp env default lts            # Set the global default version
 vp env use 20                 # Use Node.js 20 for the current shell session
 vp env use --unset            # Remove the session override

package/docs/guide/index.md

@@ -92,7 +92,7 @@ Vite+ can handle the entire local frontend development cycle from starting a pro
 
 - [`vp create`](/guide/create) creates new apps, packages, and monorepos.
 - [`vp migrate`](/guide/migrate) moves existing projects onto Vite+.
-- [`vp config`](/guide/commit-hooks) configures commit hooks and agent integration.
+- [`vp config`](/guide/commit-hooks) installs the Git hook dispatcher and configures agent integration.
 - [`vp staged`](/guide/commit-hooks) runs checks on staged files.
 - [`vp install`](/guide/install) installs dependencies with the right package manager.
 - [`vp env`](/guide/env) manages Node.js versions.

package/docs/guide/install.md

@@ -69,6 +69,8 @@ Use the `-g` flag for installing, updating or removing globally installed packag
 - `vp list -g [pkg]` lists global packages
 - `vp outdated -g [pkg]` prints outdated packages
 
+Updates keep the version spec a package was installed with: a package installed from a dist-tag (e.g. `vp install -g some-pkg@nightly`) updates to the newest version of that tag, and a version range stays within the range. Reinstall with a different spec (e.g. `vp update -g some-pkg@latest`) to switch, or pass `--latest` to `vp update -g` to move packages to the `latest` tag and clear their recorded specs. `vp outdated -g` reports both the newest version matching the recorded spec (`Wanted`) and the newest version on the `latest` tag.
+
 ::: warning
 These commands do **NOT** interact with the underlying package manager's global installation directory.
 

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

@@ -147,14 +147,14 @@ Vite+ sets additional `VP_*` variables during shim dispatch and shell integratio
 
 ## Logging and Debugging
 
-### `VITE_LOG`
+### `VP_LOG`
 
 - **Purpose**: Log filter string for `tracing_subscriber`
 - **Default**: None
 - **Example**:
   ```bash
-  VITE_LOG=debug vp dev
-  VITE_LOG=vite_task=trace vp build
+  VP_LOG=debug vp dev
+  VP_LOG=vite_task=trace vp build
   ```
 
 ### `VP_DEBUG_SHIM`

package/docs/guide/migrate.md

@@ -168,11 +168,19 @@ export default defineConfig({
 });
 ```
 
-After migrating, remove lint-staged from your dependencies and delete any lint-staged config files. See the [Commit hooks guide](/guide/commit-hooks) and [Staged config reference](/config/staged) for details.
+When no existing hook policy owns the workflow, `vp migrate` can move supported lint-staged rules
+and remove the old configuration and dependency. If an existing hook tool is preserved, keep
+lint-staged in place until you convert that hook policy manually. See the
+[Commit hooks guide](/guide/commit-hooks) and [Staged config reference](/config/staged) for details.
 
 ### Git hook tools
 
-The `vp migrate` command can set up Vite+ commit hooks for you, but it doesn't automatically migrate every type of Git hook tool. This automatic migration path is specifically designed to handle Husky v9+ and lint-staged-style setups. Projects using Husky versions older than 9.0.0 are skipped and should upgrade to Husky v9 before using the automatic migration path.
+The `vp migrate` command does not automatically convert Husky setups. When Husky is detected,
+Vite+ leaves its hooks, lifecycle scripts, configuration, and dependencies unchanged and shows a
+warning. You can migrate the project manually using the [Commit hooks guide](/guide/commit-hooks).
+
+Existing project-owned Vite+ hooks are also preserved. The default staged workflow is introduced
+only when no existing hook policy is found.
 
 If your project currently uses `lefthook`, `simple-git-hooks`, or `yorkie`, `vp migrate` will leave your existing configuration alone and show a warning. This happens even if you choose to set up hooks during the prompt or include the `--hooks` flag.