vite-plus 0.3.1 → 0.3.3

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-BVqEe9KY.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-BqvS2P98.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-CHH8jWan.js}

@@ -1,4 +1,4 @@
-import "./constants-0IAVgpox.js";
+import "./constants-C2dTOTe-.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-k14KgthC.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-C2dTOTe-.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-CGks1xR7.js → resolve-vite-config-BqvS2P98.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-C2dTOTe-.js";
+import { u as withConfigMetadataResolution } from "./define-config-IgzmnvvV.js";
 import path from "node:path";
 import fs from "node:fs";
 //#region src/resolve-vite-config.ts

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

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

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-BqvS2P98.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.3",
       "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.3",
       "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.9",
       "kind": "tool",
       "delivery": [
         "bundled",
@@ -57,7 +57,7 @@ export const toolchain = {
     {
       "id": "oxlint",
       "name": "oxlint",
-      "version": "1.81.0",
+      "version": "1.83.0",
       "kind": "tool",
       "delivery": [
         "dependency"
@@ -67,7 +67,7 @@ export const toolchain = {
     {
       "id": "oxfmt",
       "name": "oxfmt",
-      "version": "0.66.0",
+      "version": "0.68.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-18T02:37:51Z",
       "kind": "tool",
       "delivery": [
         "compiled"
@@ -110,7 +110,7 @@ export const toolchain = {
     {
       "id": "oxc",
       "name": "oxc",
-      "version": "0.148.0",
+      "version": "0.150.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.3",
       "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.3",
       "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.9",
       "kind": "tool",
       "delivery": [
         "bundled",
@@ -57,7 +57,7 @@
     {
       "id": "oxlint",
       "name": "oxlint",
-      "version": "1.81.0",
+      "version": "1.83.0",
       "kind": "tool",
       "delivery": [
         "dependency"
@@ -67,7 +67,7 @@
     {
       "id": "oxfmt",
       "name": "oxfmt",
-      "version": "0.66.0",
+      "version": "0.68.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-18T02:37:51Z",
       "kind": "tool",
       "delivery": [
         "compiled"
@@ -110,7 +110,7 @@
     {
       "id": "oxc",
       "name": "oxc",
-      "version": "0.148.0",
+      "version": "0.150.0",
       "kind": "engine",
       "delivery": [
         "compiled"

package/dist/{tsconfig-CUggNuJR.js → tsconfig-C3h9CVTA.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-C2dTOTe-.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-k14KgthC.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-euB-GmIE.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-C3h9CVTA.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-C2dTOTe-.js";
+import { i as hasVitePlusDependency, n as detectPackageMetadata } from "./package-CHH8jWan.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.9",
   "vitest": "4.1.11",
-  "oxfmt": "0.66.0",
-  "oxlint": "1.81.0",
+  "oxfmt": "0.68.0",
+  "oxlint": "1.83.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/config/staged.md

@@ -1,7 +1,6 @@
 # Staged Config
 
-`vp staged` reads 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/ci.md

@@ -10,37 +10,7 @@ You can use `voidzero-dev/setup-vp` to use Vite+ in CI environments.
 
 Set `<setup-vp-version>` in each example to an exact version from the [`setup-vp` releases page](https://github.com/voidzero-dev/setup-vp/releases). You can use a commit SHA instead. Do not use the `v1` tag. The `v1` tag no longer receives updates.
 
-Run `vp migrate` to replace exact `voidzero-dev/setup-vp@v1` references in
-GitHub Actions workflows and composite actions under `.github` with the latest
-exact release known to your Vite+ version. Existing exact versions and commit
-SHAs remain unchanged.
-
-### Automatic Version Updates
-
-Dependabot and Renovate can update exact versions in GitHub Actions workflows.
-
-To use [Dependabot version updates](https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates), add a `github-actions` entry to `.github/dependabot.yml`:
-
-```yaml [.github/dependabot.yml]
-version: 2
-updates:
-  - package-ecosystem: github-actions
-    directory: /
-    schedule:
-      interval: weekly
-```
-
-Dependabot checks `uses:` entries in `.github/workflows` each week.
-
-[Renovate's GitHub Actions manager](https://docs.renovatebot.com/modules/manager/github-actions/) detects `uses:` entries by default. You do not need a package rule for `setup-vp`.
-
-When you use a commit SHA, add the exact release tag in a comment. Renovate uses the comment to find updates:
-
-```yaml
-- uses: voidzero-dev/setup-vp@<commit-sha> # <setup-vp-version>
-```
-
-These settings apply only to GitHub Actions workflows. For GitLab CI/CD and Azure Pipelines, update both version values together.
+Run `vp migrate` to replace exact `voidzero-dev/setup-vp@v1` references in GitHub Actions workflows and composite actions under `.github` with the latest exact release known to your Vite+ version. Existing exact versions and commit SHAs remain unchanged.
 
 ## GitHub Actions
 
@@ -125,6 +95,33 @@ The Azure Pipelines template supports Microsoft-hosted Linux, macOS, and Windows
 
 For advanced configuration and the complete parameter reference, see the [`setup-vp` Azure Pipelines documentation](https://github.com/voidzero-dev/setup-vp#azure-pipelines).
 
+## Automatic Version Updates
+
+Dependabot and Renovate can update exact versions in GitHub Actions workflows.
+
+To use [Dependabot version updates](https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuring-dependabot-version-updates), add a `github-actions` entry to `.github/dependabot.yml`:
+
+```yaml [.github/dependabot.yml]
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+```
+
+Dependabot checks `uses:` entries in `.github/workflows` each week.
+
+[Renovate's GitHub Actions manager](https://docs.renovatebot.com/modules/manager/github-actions/) detects `uses:` entries by default. You do not need a package rule for `setup-vp`.
+
+When you use a commit SHA, add the exact release tag in a comment. Renovate uses the comment to find updates:
+
+```yaml
+- uses: voidzero-dev/setup-vp@<commit-sha> # <setup-vp-version>
+```
+
+These settings apply only to GitHub Actions workflows. For GitLab CI/CD and Azure Pipelines, update both version values together.
+
 ## Simplifying Existing Workflows
 
 If you are migrating an existing GitHub Actions workflow, you can often replace large blocks of Node, package-manager, and cache setup with a single `setup-vp` step.