@vizejs/vite-plugin 0.134.0 → 0.137.0

package/README.md

@@ -149,6 +149,13 @@ export default defineNuxtConfig({
 
 ```ts
 interface VizeNativeOptions {
+  /**
+   * Vue major version for the host project.
+   * Set to 0.11, 1, 2, or "legacy" to let the existing compiler plugin/loader handle SFCs.
+   * @default 3
+   */
+  vueVersion?: 0.11 | 1 | 2 | 3 | "legacy";
+
   /**
    * Files to include in compilation
    * @default /\.vue$/
@@ -205,6 +212,19 @@ interface VizeNativeOptions {
 }
 ```
 
+### Legacy Vue / Nuxt 2 compatibility
+
+Vize's native SFC compiler targets Vue 3 runtime output. In Vue 0.11, Vue 1, Vue 2,
+and Nuxt 2 projects, keep the existing host compiler in charge and set:
+
+```ts
+vize({ vueVersion: 2 });
+```
+
+Use `0.11`, `1`, `2`, or `"legacy"` for the same host-compiler compatibility mode. This makes the
+plugin non-invasive: it does not intercept `.vue` requests, does not expose the Vue 3 `vite:vue`
+compatibility API, and does not inject Vue 3 bundler feature flags.
+
 ## How It Works
 
 ### Pre-compilation at Startup

package/dist/index.d.mts

@@ -584,12 +584,24 @@ interface MacroArtifact {
   start: number;
   end: number;
 }
+type VizeVueVersion = 0.11 | 1 | 2 | 3 | "legacy";
 interface VizeOptions {
   /**
    * Inline shared Vize config for Vite Plus-first projects.
    * Direct plugin options still take precedence over these values.
    */
   config?: UserConfigExport;
+  /**
+   * Vue major version for the host project.
+   *
+   * Legacy Vue projects must keep their existing compiler plugin/loader in
+   * charge of SFC compilation. Set this to `0.11`, `1`, `2`, or `"legacy"` to
+   * make Vize a non-invasive compatibility plugin that does not intercept
+   * `.vue` requests or inject Vue 3 bundler defines.
+   *
+   * @default 3
+   */
+  vueVersion?: VizeVueVersion;
   /**
    * Override the public base used for dev-time asset URLs such as /@fs paths.
    * Useful for frameworks like Nuxt that serve Vite from a subpath (e.g. /_nuxt/).
@@ -742,4 +754,4 @@ declare const __internal: {
   rewriteStaticAssetUrls: typeof rewriteStaticAssetUrls;
 };
 //#endregion
-export { type CompiledModule, type LoadConfigOptions, type MacroArtifact, type ResolvedVizeConfig, type UserConfigExport, type VizeConfig, type VizeOptions, __internal, rewriteStaticAssetUrls as __internal_rewriteStaticAssetUrls, vize as default, vize, defineConfig, loadConfig, resolveConfigExport, vizeConfigStore };
+export { type CompiledModule, type LoadConfigOptions, type MacroArtifact, type ResolvedVizeConfig, type UserConfigExport, type VizeConfig, type VizeOptions, type VizeVueVersion, __internal, rewriteStaticAssetUrls as __internal_rewriteStaticAssetUrls, vize as default, vize, defineConfig, loadConfig, resolveConfigExport, vizeConfigStore };

package/dist/index.mjs

@@ -581,9 +581,12 @@ function shouldCompileVueSfcRequest(request) {
 	if (params.has("raw") || params.has("url") || params.has("worker") || params.has("sharedworker")) return false;
 	return params.has("nuxt_component");
 }
-async function resolveAliasedVueImport(ctx, state, id, importer, isSsrRequest, handleNodeModules) {
+function hasNuxtComponentQuery$1(request) {
+	if (!request.querySuffix) return false;
+	return new URLSearchParams(request.querySuffix.slice(1)).has("nuxt_component");
+}
+async function resolveAliasedVueImport(ctx, state, id, importer, isSsrRequest, handleNodeModules, querySuffix, preserveQueryAsPath) {
 	if (path.isAbsolute(id)) return null;
-	const request = classifyVitePluginRequest(id);
 	const viteImporter = normalizeViteRequireBase(importer) ?? importer;
 	const viteResolved = await ctx.resolve(id, viteImporter, { skipSelf: true });
 	const realPath = viteResolved ? normalizeResolvedVuePath(viteResolved.id) : null;
@@ -599,7 +602,7 @@ async function resolveAliasedVueImport(ctx, state, id, importer, isSsrRequest, h
 	}
 	if (state.cache.has(realPath) || fs.existsSync(realPath)) {
 		state.logger.log(`resolveId: resolved via Vite fallback ${id} to ${realPath}`);
-		return `${toVirtualId(realPath, isSsrRequest)}${request.querySuffix}`;
+		return preserveQueryAsPath ? `${realPath}${querySuffix}` : `${toVirtualId(realPath, isSsrRequest)}${querySuffix}`;
 	}
 	return null;
 }
@@ -649,7 +652,17 @@ async function resolveIdHook(ctx, state, id, importer, options) {
 		const resolved = resolveVuePath(state, request.path, importer);
 		if (resolved && fs.existsSync(resolved)) return `\0${resolved}${request.querySuffix}`;
 	}
-	if (request.isVueStyleQuery && request.styleVirtualSuffix) return `\0${id}${request.styleVirtualSuffix}`;
+	if (request.isVueStyleQuery && request.styleVirtualSuffix) {
+		if (id.includes("vitepress-plugin-llms")) {
+			state.logger.log(`resolveId: skipping vitepress-plugin-llms style import ${id}`);
+			return null;
+		}
+		if (!(state.mergedOptions.handleNodeModulesVue ?? true) && request.path.includes("node_modules")) {
+			state.logger.log(`resolveId: skipping node_modules style import ${id}`);
+			return null;
+		}
+		return `\0${id}${request.styleVirtualSuffix}`;
+	}
 	const isMacroImporter = importerRequest?.isMacroVirtualId ?? false;
 	const isVizeVirtualImporter = importerRequest?.isVizeVirtual ?? false;
 	if (importer && (isVizeVirtualImporter || isMacroImporter)) {
@@ -783,7 +796,8 @@ async function resolveIdHook(ctx, state, id, importer, options) {
 		}
 	}
 	if (shouldCompileVueSfcRequest(request)) {
-		const handleNodeModules = state.initialized ? state.mergedOptions.handleNodeModulesVue ?? true : true;
+		const handleNodeModules = state.mergedOptions.handleNodeModulesVue ?? true;
+		const preserveQueryAsPath = hasNuxtComponentQuery$1(request);
 		const vueRequestPath = request.path;
 		if (!handleNodeModules && vueRequestPath.includes("node_modules")) {
 			state.logger.log(`resolveId: skipping node_modules import ${id}`);
@@ -792,7 +806,7 @@ async function resolveIdHook(ctx, state, id, importer, options) {
 		const resolved = resolveVuePath(state, vueRequestPath, importer);
 		const fileExists = fs.existsSync(resolved);
 		if (!fileExists) {
-			const aliased = await resolveAliasedVueImport(ctx, state, id, importer, isSsrRequest, handleNodeModules);
+			const aliased = await resolveAliasedVueImport(ctx, state, id, importer, isSsrRequest, handleNodeModules, request.querySuffix, preserveQueryAsPath);
 			if (aliased) return aliased;
 		}
 		const isNodeModulesPath = resolved.includes("node_modules");
@@ -806,7 +820,10 @@ async function resolveIdHook(ctx, state, id, importer, options) {
 		}
 		const hasCache = state.cache.has(resolved);
 		state.logger.log(`resolveId: id=${id}, resolved=${resolved}, hasCache=${hasCache}, fileExists=${fileExists}, importer=${importer ?? "none"}`);
-		if (hasCache || fileExists) return `${toVirtualId(resolved, isSsrRequest)}${request.querySuffix}`;
+		if (hasCache || fileExists) {
+			if (preserveQueryAsPath) return `${resolved}${request.querySuffix}`;
+			return `${toVirtualId(resolved, isSsrRequest)}${request.querySuffix}`;
+		}
 	}
 	return null;
 }
@@ -855,6 +872,48 @@ function findMacroArtifactModule(state, realPath, ssr, kind) {
 	}
 	return compiled?.macroArtifacts?.find((artifact) => artifact.kind === kind)?.moduleCode ?? null;
 }
+function hasNuxtComponentQuery(request) {
+	if (!request.querySuffix) return false;
+	return new URLSearchParams(request.querySuffix.slice(1)).has("nuxt_component");
+}
+function loadCompiledSfcModule(state, realPath, isSsr, currentBase, loadOptions) {
+	const placeholderCode = getBoundaryPlaceholderCode(realPath, !!loadOptions?.ssr);
+	if (placeholderCode) {
+		state.logger.log(`load: using boundary placeholder for ${realPath}`);
+		return {
+			code: placeholderCode,
+			map: null
+		};
+	}
+	const cache = getEnvironmentCache(state, isSsr);
+	let compiled = cache.get(realPath);
+	if (!compiled && fs.existsSync(realPath)) {
+		state.logger.log(`load: on-demand compiling ${realPath}`);
+		compiled = compileFile(realPath, cache, getCompileOptionsForRequest(state, isSsr));
+		syncCollectedCssForFile(state, realPath, compiled);
+	}
+	if (!compiled) return null;
+	const hasDelegated = hasDelegatedStyles(compiled);
+	const pendingHmrUpdateType = loadOptions?.ssr ? void 0 : state.pendingHmrUpdateTypes.get(realPath);
+	if (compiled.css && !hasDelegated) compiled = {
+		...compiled,
+		css: resolveCssImports(compiled.css, realPath, state.cssAliasRules, state.server !== null, currentBase)
+	};
+	const generatedOutput = generateOutput(compiled, {
+		isProduction: state.isProduction,
+		isDev: state.server !== null && !isSsr,
+		ssr: isSsr,
+		hmrUpdateType: pendingHmrUpdateType,
+		extractCss: state.extractCss,
+		filePath: realPath
+	});
+	const output = rewriteStaticAssetUrls(rewriteDynamicTemplateImports(isSsr ? normalizeVueServerRendererImport(generatedOutput) : generatedOutput, state.dynamicImportAliasRules), state.dynamicImportAliasRules);
+	if (!loadOptions?.ssr) state.pendingHmrUpdateTypes.delete(realPath);
+	return {
+		code: output,
+		map: null
+	};
+}
 function loadDefinePageArtifact(state, realPath, ssr) {
 	return {
 		code: findMacroArtifactModule(state, realPath, ssr, "vue-router.definePage") ?? "export default {}",
@@ -869,9 +928,11 @@ function loadDefinePageMetaArtifact(state, realPath, ssr) {
 	} : null;
 }
 function loadHook(state, id, loadOptions) {
-	if (id !== "\0vize:all-styles.css" && !id.startsWith("\0")) return null;
-	const currentBase = loadOptions?.ssr ? state.serverViteBase : state.clientViteBase;
 	const request = classifyVitePluginRequest(id);
+	if (id !== "\0vize:all-styles.css" && !id.startsWith("\0")) {
+		if (!request.isVueSfcPath || !hasNuxtComponentQuery(request)) return null;
+	}
+	const currentBase = loadOptions?.ssr ? state.serverViteBase : state.clientViteBase;
 	if (id === "\0vize:all-styles.css") {
 		let allCss = "";
 		for (const css of state.collectedCss.values()) allCss += allCss ? `\n\n${css}` : css;
@@ -921,43 +982,11 @@ function loadHook(state, id, loadOptions) {
 			state.logger.log(`load: skipping non-vue virtual module ${realPath}`);
 			return null;
 		}
-		const placeholderCode = getBoundaryPlaceholderCode(realPath, !!loadOptions?.ssr);
-		if (placeholderCode) {
-			state.logger.log(`load: using boundary placeholder for ${realPath}`);
-			return {
-				code: placeholderCode,
-				map: null
-			};
-		}
-		const cache = getEnvironmentCache(state, isSsr);
-		let compiled = cache.get(realPath);
-		if (!compiled && fs.existsSync(realPath)) {
-			state.logger.log(`load: on-demand compiling ${realPath}`);
-			compiled = compileFile(realPath, cache, getCompileOptionsForRequest(state, isSsr));
-			syncCollectedCssForFile(state, realPath, compiled);
-		}
-		if (compiled) {
-			const hasDelegated = hasDelegatedStyles(compiled);
-			const pendingHmrUpdateType = loadOptions?.ssr ? void 0 : state.pendingHmrUpdateTypes.get(realPath);
-			if (compiled.css && !hasDelegated) compiled = {
-				...compiled,
-				css: resolveCssImports(compiled.css, realPath, state.cssAliasRules, state.server !== null, currentBase)
-			};
-			const generatedOutput = generateOutput(compiled, {
-				isProduction: state.isProduction,
-				isDev: state.server !== null && !isSsr,
-				ssr: isSsr,
-				hmrUpdateType: pendingHmrUpdateType,
-				extractCss: state.extractCss,
-				filePath: realPath
-			});
-			const output = rewriteStaticAssetUrls(rewriteDynamicTemplateImports(isSsr ? normalizeVueServerRendererImport(generatedOutput) : generatedOutput, state.dynamicImportAliasRules), state.dynamicImportAliasRules);
-			if (!loadOptions?.ssr) state.pendingHmrUpdateTypes.delete(realPath);
-			return {
-				code: output,
-				map: null
-			};
-		}
+		return loadCompiledSfcModule(state, realPath, isSsr, currentBase, loadOptions);
+	}
+	if (request.isVueSfcPath && hasNuxtComponentQuery(request)) {
+		const realPath = classifyVitePluginRequest(request.normalizedFsId ?? request.path).normalizedVuePath;
+		return loadCompiledSfcModule(state, realPath, !!loadOptions?.ssr, currentBase, loadOptions);
 	}
 	if (id.startsWith("\0")) {
 		const afterPrefix = id.startsWith("\0vize:") ? id.slice(6) : id.slice(1);
@@ -1244,6 +1273,19 @@ function installVirtualAssetMiddleware(devServer, state) {
 	});
 }
 //#endregion
+//#region src/plugin/vue-version.ts
+function isLegacyVueCompatibilityMode(options) {
+	return options.vueVersion !== void 0 && options.vueVersion !== 3;
+}
+function createLegacyVueCompatibilityPlugin(options) {
+	return {
+		name: "vite-plugin-vize:legacy-vue-compat",
+		configResolved(resolvedConfig) {
+			createLogger(options.debug ?? false).log(`Legacy Vue compatibility mode is active for ${resolvedConfig.root}; Vize will not compile .vue files.`);
+		}
+	};
+}
+//#endregion
 //#region src/plugin/index.ts
 function aliasSortKey(find) {
 	return typeof find === "string" ? find.length : find.source.length;
@@ -1290,6 +1332,7 @@ function mergeSharedConfig(baseConfig, overrideConfig) {
 	};
 }
 function vize(options = {}) {
+	if (isLegacyVueCompatibilityMode(options)) return [createLegacyVueCompatibilityPlugin(options)];
 	const state = {
 		cache: /* @__PURE__ */ new Map(),
 		ssrCache: /* @__PURE__ */ new Map(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/vite-plugin",
-  "version": "0.134.0",
+  "version": "0.137.0",
   "description": "High-performance native Vite plugin for Vue SFC compilation powered by Vize",
   "keywords": [
     "compiler",
@@ -39,9 +39,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@vizejs/native": "0.134.0",
+    "@vizejs/native": "0.137.0",
     "tinyglobby": "0.2.16",
-    "vize": "0.134.0"
+    "vize": "0.137.0"
   },
   "devDependencies": {
     "@types/node": "25.7.0",