@vizejs/nuxt 0.135.0 → 0.138.0

package/dist/index.d.mts

@@ -4,6 +4,7 @@ import { NuxtMuseaOptions, NuxtMuseaOptions as NuxtMuseaOptions$1 } from "@vizej
 
 //#region src/compiler-options.d.ts
 type VizeNuxtPattern = string | RegExp;
+type VizeNuxtVueVersion = 0.11 | 1 | 2 | 3 | "legacy";
 /**
  * Nuxt-facing mirror of the public `@vizejs/vite-plugin` options.
  *
@@ -12,6 +13,14 @@ type VizeNuxtPattern = string | RegExp;
  * during monorepo lint runs.
  */
 interface VizeNuxtCompilerOptions {
+  /**
+   * Vue major version for the host project.
+   *
+   * Legacy Vue projects keep the host Vue compiler in charge. When set to
+   * `0.11`, `1`, `2`, or `"legacy"`, the underlying Vite plugin runs in
+   * compatibility mode and does not intercept `.vue` files.
+   */
+  vueVersion?: VizeNuxtVueVersion;
   /** Override the public base used for dev-time asset URLs. */
   devUrlBase?: string;
   /** Files to include in compilation. */
@@ -47,6 +56,23 @@ interface VizeNuxtCompilerOptions {
 }
 //#endregion
 //#region src/options.d.ts
+type VizeNuxtMajorVersion = 2 | 3 | 4;
+interface VizeNuxtCompatibilityOptions {
+  /**
+   * Override the detected Nuxt major version.
+   *
+   * This exists for projects with unusual module wrappers. Most projects should
+   * leave it on automatic detection.
+   */
+  nuxtVersion?: VizeNuxtMajorVersion;
+  /**
+   * Override the detected Vue major version.
+   *
+   * Nuxt 2 defaults to Vue 2 compatibility mode; Nuxt 3/4 defaults to Vue 3.
+   * Vue 0.11, Vue 1, and Vue 2 all use host-compiler compatibility mode.
+   */
+  vueVersion?: VizeNuxtVueVersion;
+}
 interface VizeNuxtBridgeOptions {
   /**
    * Re-apply Nuxt auto-import injection to Vize virtual Vue modules.
@@ -97,6 +123,13 @@ interface VizeNuxtDevOptions {
   stylesheetLinks?: boolean;
 }
 interface VizeNuxtOptions {
+  /**
+   * Host framework compatibility overrides.
+   *
+   * These are usually inferred from Nuxt itself. Set `vueVersion: 0.11`, `1`,
+   * `2`, or `"legacy"` for setups that must keep the host compiler.
+   */
+  compatibility?: VizeNuxtCompatibilityOptions;
   /**
    * Enable/disable the Vize compiler (Vue SFC compilation via Vite plugin).
    * Pass an object to configure the underlying `@vizejs/vite-plugin`.
@@ -140,4 +173,4 @@ interface VizeNuxtOptions {
 //#region src/index.d.ts
 declare const _default: _$nuxt_schema0.NuxtModule<VizeNuxtOptions, VizeNuxtOptions, false>;
 //#endregion
-export { type MuseaOptions, type NuxtMuseaOptions, type VizeNuxtBridgeOptions, type VizeNuxtCompilerOptions, type VizeNuxtDevOptions, type VizeNuxtOptions, type VizeNuxtUnoCssOptions, _default as default };
+export { type MuseaOptions, type NuxtMuseaOptions, type VizeNuxtBridgeOptions, type VizeNuxtCompatibilityOptions, type VizeNuxtCompilerOptions, type VizeNuxtDevOptions, type VizeNuxtMajorVersion, type VizeNuxtOptions, type VizeNuxtUnoCssOptions, type VizeNuxtVueVersion, _default as default };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { createRequire } from "node:module";
-import { addServerPlugin, addVitePlugin, createResolver, defineNuxtModule } from "@nuxt/kit";
+import { addServerPlugin, addVitePlugin, createResolver, defineNuxtModule, getNuxtVersion, isNuxt2 } from "@nuxt/kit";
 import vize from "@vizejs/vite-plugin";
 import { musea } from "@vizejs/vite-plugin-musea";
 import fs from "node:fs";
@@ -330,9 +330,14 @@ const DEFAULT_NUXT_BRIDGE_OPTIONS = {
 };
 const DEFAULT_NUXT_UNOCSS_OPTIONS = { originalSource: {} };
 const DEFAULT_NUXT_DEV_OPTIONS = { stylesheetLinks: true };
-function resolveNuxtCompilerOptions(rootDir, baseURL, buildAssetsDir, compiler) {
+function resolveNuxtCompilerOptions(rootDir, baseURL, buildAssetsDir, compiler, compatibility = {}) {
 	if (compiler === false) return false;
-	return buildNuxtCompilerOptions(rootDir, baseURL, buildAssetsDir, typeof compiler === "object" && compiler != null ? compiler : {});
+	if (compatibility.supportsViteCompiler === false) return false;
+	const overrides = typeof compiler === "object" && compiler != null ? compiler : {};
+	return buildNuxtCompilerOptions(rootDir, baseURL, buildAssetsDir, {
+		vueVersion: compatibility.vueVersion,
+		...overrides
+	});
 }
 function resolveNuxtBridgeOptions(bridge) {
 	if (bridge === false) return {
@@ -402,6 +407,34 @@ function appendOriginalVueSourceForUnoCss(code, normalizedId, options = {}) {
 * - Linter: `vize lint` CLI command (via `vize` bin)
 * - Type Checker: `vize check` CLI command (via `vize` bin)
 */
+function getDetectedNuxtMajor(nuxt) {
+	try {
+		const version = getNuxtVersion(nuxt);
+		const major = Number.parseInt(version.split(".")[0] ?? "", 10);
+		return major === 2 || major === 3 || major === 4 ? major : null;
+	} catch {
+		return null;
+	}
+}
+function hasNuxtViteCompilerSupport(nuxt) {
+	const builder = nuxt.options.builder;
+	if (typeof builder === "string") return builder === "vite" || builder.includes("vite-builder");
+	if (nuxt.options.vite) return true;
+	try {
+		return !isNuxt2(nuxt);
+	} catch {
+		return true;
+	}
+}
+function getNuxtAppBaseURL(nuxt) {
+	return nuxt.options.app?.baseURL ?? nuxt.options.router?.base;
+}
+function getNuxtBuildAssetsDir(nuxt) {
+	return nuxt.options.app?.buildAssetsDir ?? nuxt.options.build?.publicPath;
+}
+function shouldUseVizeCompiler(compilerOptions) {
+	return compilerOptions !== false && (compilerOptions.vueVersion ?? 3) === 3;
+}
 function normalizeNuxtKeyedTransformResult(id, result) {
 	if (!isVizeVirtualVueModuleId(id) || result == null) return result;
 	if (typeof result === "string") return normalizeNuxtInjectedKeysForVizeVirtualModule(result, id);
@@ -438,19 +471,35 @@ var src_default = defineNuxtModule({
 	},
 	setup(options, nuxt) {
 		const resolver = createResolver(import.meta.url);
+		const detectedNuxtMajor = options.compatibility?.nuxtVersion ?? getDetectedNuxtMajor(nuxt) ?? 3;
+		const vueVersion = options.compatibility?.vueVersion ?? (detectedNuxtMajor === 2 ? 2 : 3);
+		const nuxtWithBuilderOptions = nuxt;
+		const supportsViteCompiler = hasNuxtViteCompilerSupport(nuxtWithBuilderOptions);
+		const appBaseURL = getNuxtAppBaseURL(nuxtWithBuilderOptions);
+		const buildAssetsDir = getNuxtBuildAssetsDir(nuxtWithBuilderOptions);
 		const bridgeOptions = resolveNuxtBridgeOptions(options.bridge);
 		const devOptions = resolveNuxtDevOptions(options.dev);
 		const museaOptions = resolveNuxtMuseaOptions(options.musea);
 		const unocssOptions = resolveNuxtUnoCssOptions(options.unocss);
-		nuxt.options.vite.plugins = nuxt.options.vite.plugins || [];
-		const compilerOptions = resolveNuxtCompilerOptions(nuxt.options.rootDir, nuxt.options.app.baseURL, nuxt.options.app.buildAssetsDir, options.compiler);
+		const compilerOptions = resolveNuxtCompilerOptions(nuxt.options.rootDir, appBaseURL, buildAssetsDir, options.compiler, {
+			supportsViteCompiler,
+			vueVersion
+		});
 		if (compilerOptions !== false) {
+			nuxt.options.vite ||= {};
+			nuxt.options.vite.plugins = nuxt.options.vite.plugins || [];
 			nuxt.options.vite.plugins.push(vize(compilerOptions));
+		}
+		const usesVizeCompiler = shouldUseVizeCompiler(compilerOptions);
+		if (usesVizeCompiler) {
 			if (nuxt.options.dev && devOptions.stylesheetLinks) {
-				const devAssetBase = compilerOptions.devUrlBase ?? buildNuxtDevAssetBase(nuxt.options.app.baseURL, nuxt.options.app.buildAssetsDir);
+				const devAssetBase = compilerOptions.devUrlBase ?? buildNuxtDevAssetBase(appBaseURL, buildAssetsDir);
+				nuxt.options.nitro ||= {};
 				nuxt.options.nitro.virtual ||= {};
-				nuxt.options.nitro.virtual["#vizejs/nuxt/dev-stylesheet-links-config"] = `export const devAssetBase = ${JSON.stringify(devAssetBase)};`;
-				addServerPlugin(resolver.resolve("./runtime/server/dev-stylesheet-links"));
+				if (nuxt.options.nitro.virtual) {
+					nuxt.options.nitro.virtual["#vizejs/nuxt/dev-stylesheet-links-config"] = `export const devAssetBase = ${JSON.stringify(devAssetBase)};`;
+					addServerPlugin(resolver.resolve("./runtime/server/dev-stylesheet-links"));
+				}
 			}
 			nuxt.hook("vite:configResolved", (config) => {
 				for (let i = config.plugins.length - 1; i >= 0; i--) {
@@ -462,10 +511,10 @@ var src_default = defineNuxtModule({
 			});
 		}
 		let unimportCtx = null;
-		if (bridgeOptions.autoImports) nuxt.hook("imports:context", (ctx) => {
+		if (usesVizeCompiler && bridgeOptions.autoImports) nuxt.hook("imports:context", (ctx) => {
 			unimportCtx = ctx;
 		});
-		const nuxtComponentResolver = bridgeOptions.components ? createNuxtComponentResolver({
+		const nuxtComponentResolver = usesVizeCompiler && bridgeOptions.components ? createNuxtComponentResolver({
 			buildDir: nuxt.options.buildDir,
 			moduleNames: nuxt.options.modules.filter((moduleName) => typeof moduleName === "string"),
 			rootDir: nuxt.options.rootDir
@@ -473,7 +522,7 @@ var src_default = defineNuxtModule({
 		if (nuxtComponentResolver) nuxt.hook("components:extend", (comps) => {
 			nuxtComponentResolver.register(comps);
 		});
-		if (bridgeOptions.autoImports || bridgeOptions.components || bridgeOptions.i18n || bridgeOptions.stableInjectedKeys) addVitePlugin({
+		if (usesVizeCompiler && (bridgeOptions.autoImports || bridgeOptions.components || bridgeOptions.i18n || bridgeOptions.stableInjectedKeys)) addVitePlugin({
 			name: "vizejs:nuxt-transform-bridge",
 			enforce: "post",
 			async transform(code, id) {
@@ -516,7 +565,7 @@ var src_default = defineNuxtModule({
 				};
 			}
 		});
-		if (unocssOptions !== false) addVitePlugin({
+		if (usesVizeCompiler && unocssOptions !== false) addVitePlugin({
 			name: "vizejs:unocss-bridge",
 			configResolved(config) {
 				for (const plugin of config.plugins) if (plugin.name?.startsWith("unocss:") && typeof plugin.transform === "function") {
@@ -534,8 +583,10 @@ var src_default = defineNuxtModule({
 				}
 			}
 		});
-		if (museaOptions !== false) {
+		if (museaOptions !== false && supportsViteCompiler) {
 			const museaBasePath = "basePath" in museaOptions ? museaOptions.basePath : "/__musea__";
+			nuxt.options.vite ||= {};
+			nuxt.options.vite.plugins = nuxt.options.vite.plugins || [];
 			nuxt.options.vite.plugins.push(...musea(museaOptions));
 			nuxt.hook("listen", (_server, listener) => {
 				const url = listener.url?.replace(/\/$/, "") || "http://localhost:3000";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/nuxt",
-  "version": "0.135.0",
+  "version": "0.138.0",
   "description": "Nuxt module for Vize - compiler, musea gallery, linter, and type checker",
   "keywords": [
     "compiler",
@@ -41,10 +41,10 @@
   },
   "dependencies": {
     "@nuxt/kit": "4.4.6",
-    "@vizejs/musea-nuxt": "0.135.0",
-    "@vizejs/vite-plugin": "0.135.0",
-    "@vizejs/vite-plugin-musea": "0.135.0",
-    "vize": "0.135.0"
+    "@vizejs/musea-nuxt": "0.138.0",
+    "@vizejs/vite-plugin": "0.138.0",
+    "@vizejs/vite-plugin-musea": "0.138.0",
+    "vize": "0.138.0"
   },
   "devDependencies": {
     "typescript": "6.0.3",
@@ -54,7 +54,7 @@
     "vue-router": "4.5.1"
   },
   "peerDependencies": {
-    "nuxt": "^3.0.0 || ^4.0.0"
+    "nuxt": "^2.16.0 || ^3.0.0 || ^4.0.0"
   },
   "engines": {
     "node": ">=22"