@vizejs/nuxt 0.108.0 → 0.112.0

package/dist/index.d.mts

@@ -2,19 +2,132 @@ import { MuseaOptions, MuseaOptions as MuseaOptions$1 } from "@vizejs/vite-plugi
 import * as _$nuxt_schema0 from "nuxt/schema";
 import { NuxtMuseaOptions, NuxtMuseaOptions as NuxtMuseaOptions$1 } from "@vizejs/musea-nuxt";
 
-//#region src/index.d.ts
+//#region src/compiler-options.d.ts
+type VizeNuxtPattern = string | RegExp;
+/**
+ * Nuxt-facing mirror of the public `@vizejs/vite-plugin` options.
+ *
+ * Keeping this shape local lets the Nuxt module expose compiler configuration
+ * without requiring the sibling package's generated declaration files to exist
+ * during monorepo lint runs.
+ */
+interface VizeNuxtCompilerOptions {
+  /** Override the public base used for dev-time asset URLs. */
+  devUrlBase?: string;
+  /** Files to include in compilation. */
+  include?: VizeNuxtPattern | VizeNuxtPattern[];
+  /** Files to exclude from compilation. */
+  exclude?: VizeNuxtPattern | VizeNuxtPattern[];
+  /** Force production mode. */
+  isProduction?: boolean;
+  /** Enable SSR mode. */
+  ssr?: boolean;
+  /** Enable source map generation. */
+  sourceMap?: boolean;
+  /** Enable Vapor mode compilation. */
+  vapor?: boolean;
+  /** Treat lowercase non-HTML tags as custom renderer elements. */
+  customRenderer?: boolean;
+  /** Root directory to scan for .vue files. */
+  root?: string;
+  /** Glob patterns to scan for .vue files during pre-compilation. */
+  scanPatterns?: string[];
+  /** Maximum number of Vue files to compile in a single native batch. */
+  precompileBatchSize?: number;
+  /** Glob patterns to ignore during pre-compilation. */
+  ignorePatterns?: string[];
+  /** Config file search mode. */
+  configMode?: "root" | "auto" | false;
+  /** Custom config file path. */
+  configFile?: string;
+  /** Handle .vue files in node_modules during on-demand compilation. */
+  handleNodeModulesVue?: boolean;
+  /** Enable debug logging. */
+  debug?: boolean;
+}
+//#endregion
+//#region src/options.d.ts
+interface VizeNuxtBridgeOptions {
+  /**
+   * Re-apply Nuxt auto-import injection to Vize virtual Vue modules.
+   * @default true
+   */
+  autoImports?: boolean;
+  /**
+   * Re-apply Nuxt component auto-import resolution to Vize virtual Vue modules.
+   * @default true
+   */
+  components?: boolean;
+  /**
+   * Re-apply @nuxtjs/i18n helper injection to Vize virtual Vue modules.
+   * @default true
+   */
+  i18n?: boolean;
+  /**
+   * Stabilize Nuxt generated async-data keys between client and SSR transforms.
+   * @default true
+   */
+  stableInjectedKeys?: boolean;
+}
+interface VizeNuxtUnoCssOptions {
+  /**
+   * Feed the original .vue source to UnoCSS extraction-only plugins so
+   * attributify syntax survives Vize's render-function output.
+   *
+   * Set to `false` to skip reading SFC source files. Use an object to tune the
+   * maximum source size read into Node.
+   *
+   * @default true
+   */
+  originalSource?: boolean | {
+    /**
+     * Maximum original .vue source size to append for UnoCSS extraction.
+     * @default 2097152
+     */
+    maxBytes?: number;
+  };
+}
+interface VizeNuxtDevOptions {
+  /**
+   * Remove broken duplicate/unsafe stylesheet links from Nuxt dev SSR HTML
+   * when Vize is the Vue compiler.
+   *
+   * @default true
+   */
+  stylesheetLinks?: boolean;
+}
 interface VizeNuxtOptions {
   /**
    * Enable/disable the Vize compiler (Vue SFC compilation via Vite plugin).
-   * Set to `false` to use Vue's default SFC compiler instead.
+   * Pass an object to configure the underlying `@vizejs/vite-plugin`.
+   *
    * @default true
    */
-  compiler?: boolean;
+  compiler?: boolean | VizeNuxtCompilerOptions;
+  /**
+   * Nuxt compatibility bridges for transforms that normally skip Rollup
+   * virtual module ids.
+   *
+   * @default true
+   */
+  bridge?: boolean | VizeNuxtBridgeOptions;
+  /**
+   * UnoCSS bridge options for Vize virtual Vue modules.
+   *
+   * @default true
+   */
+  unocss?: boolean | VizeNuxtUnoCssOptions;
+  /**
+   * Dev-server integration options.
+   */
+  dev?: VizeNuxtDevOptions;
   /**
    * Musea gallery options.
-   * Set to `false` to disable musea.
+   * Set to `true` to enable Musea with default options.
+   *
+   * @default false
    */
-  musea?: MuseaOptions$1 | false;
+  musea?: boolean | MuseaOptions$1;
   /**
    * Nuxt mock options for musea gallery.
    * NOTE: In Nuxt context, nuxtMusea mocks are NOT added as a global Vite plugin
@@ -23,6 +136,8 @@ interface VizeNuxtOptions {
    */
   nuxtMusea?: NuxtMuseaOptions$1;
 }
+//#endregion
+//#region src/index.d.ts
 declare const _default: _$nuxt_schema0.NuxtModule<VizeNuxtOptions, VizeNuxtOptions, false>;
 //#endregion
-export { type MuseaOptions, type NuxtMuseaOptions, VizeNuxtOptions, _default as default };
+export { type MuseaOptions, type NuxtMuseaOptions, type VizeNuxtBridgeOptions, type VizeNuxtCompilerOptions, type VizeNuxtDevOptions, type VizeNuxtOptions, type VizeNuxtUnoCssOptions, _default as default };

package/dist/index.mjs

@@ -292,12 +292,14 @@ function buildNuxtDevAssetBase(baseURL = "/", buildAssetsDir = "/_nuxt/") {
 	const normalizedAssetsDir = normalizeUrlPrefix(buildAssetsDir);
 	return normalizedBase === "/" ? normalizedAssetsDir : normalizeUrlPrefix(`${normalizedBase}${normalizedAssetsDir.replace(/^\//, "")}`);
 }
-function buildNuxtCompilerOptions(rootDir, baseURL = "/", buildAssetsDir = "/_nuxt/") {
-	return {
+function buildNuxtCompilerOptions(rootDir, baseURL = "/", buildAssetsDir = "/_nuxt/", overrides = {}) {
+	const defaults = {
 		devUrlBase: buildNuxtDevAssetBase(baseURL, buildAssetsDir),
 		root: rootDir,
 		scanPatterns: []
 	};
+	for (const [key, value] of Object.entries(overrides)) if (value !== void 0) defaults[key] = value;
+	return defaults;
 }
 function isVizeVirtualVueModuleId(id) {
 	return id.startsWith("\0") && /\.vue\.ts(?:\?|$)/.test(id);
@@ -318,6 +320,54 @@ function normalizeNuxtInjectedKeysForVizeVirtualModule(code, id) {
 		return `'$${buildStableNuxtKey(normalizedId, index)}' ${NUXT_INJECTED_MARKER}`;
 	});
 }
+//#endregion
+//#region src/options.ts
+const DEFAULT_NUXT_BRIDGE_OPTIONS = {
+	autoImports: true,
+	components: true,
+	i18n: true,
+	stableInjectedKeys: true
+};
+const DEFAULT_NUXT_UNOCSS_OPTIONS = { originalSource: {} };
+const DEFAULT_NUXT_DEV_OPTIONS = { stylesheetLinks: true };
+function resolveNuxtCompilerOptions(rootDir, baseURL, buildAssetsDir, compiler) {
+	if (compiler === false) return false;
+	return buildNuxtCompilerOptions(rootDir, baseURL, buildAssetsDir, typeof compiler === "object" && compiler != null ? compiler : {});
+}
+function resolveNuxtBridgeOptions(bridge) {
+	if (bridge === false) return {
+		autoImports: false,
+		components: false,
+		i18n: false,
+		stableInjectedKeys: false
+	};
+	if (bridge === true || bridge == null) return { ...DEFAULT_NUXT_BRIDGE_OPTIONS };
+	return {
+		autoImports: bridge.autoImports ?? DEFAULT_NUXT_BRIDGE_OPTIONS.autoImports,
+		components: bridge.components ?? DEFAULT_NUXT_BRIDGE_OPTIONS.components,
+		i18n: bridge.i18n ?? DEFAULT_NUXT_BRIDGE_OPTIONS.i18n,
+		stableInjectedKeys: bridge.stableInjectedKeys ?? DEFAULT_NUXT_BRIDGE_OPTIONS.stableInjectedKeys
+	};
+}
+function resolveNuxtUnoCssOptions(unocss) {
+	if (unocss === false) return false;
+	if (unocss === true || unocss == null) return { ...DEFAULT_NUXT_UNOCSS_OPTIONS };
+	const originalSource = unocss.originalSource;
+	if (originalSource === false) return { originalSource: false };
+	if (originalSource === true || originalSource == null) return { originalSource: {} };
+	return { originalSource };
+}
+function resolveNuxtDevOptions(dev) {
+	return {
+		...DEFAULT_NUXT_DEV_OPTIONS,
+		...dev
+	};
+}
+function resolveNuxtMuseaOptions(musea) {
+	if (musea === true) return {};
+	if (musea === false || musea == null) return false;
+	return musea;
+}
 function readTextFile(filePath) {
 	return fs.readFileSync(filePath, "utf-8");
 }
@@ -383,21 +433,23 @@ var src_default = defineNuxtModule({
 		configKey: "vize"
 	},
 	defaults: {
-		musea: {
-			include: ["**/*.art.vue"],
-			inlineArt: false
-		},
+		musea: false,
 		nuxtMusea: { route: { path: "/" } }
 	},
 	setup(options, nuxt) {
 		const resolver = createResolver(import.meta.url);
+		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 || [];
-		if (options.compiler !== false) {
-			const compilerOptions = buildNuxtCompilerOptions(nuxt.options.rootDir, nuxt.options.app.baseURL, nuxt.options.app.buildAssetsDir);
+		const compilerOptions = resolveNuxtCompilerOptions(nuxt.options.rootDir, nuxt.options.app.baseURL, nuxt.options.app.buildAssetsDir, options.compiler);
+		if (compilerOptions !== false) {
 			nuxt.options.vite.plugins.push(vize(compilerOptions));
-			if (nuxt.options.dev) {
+			if (nuxt.options.dev && devOptions.stylesheetLinks) {
+				const devAssetBase = compilerOptions.devUrlBase ?? buildNuxtDevAssetBase(nuxt.options.app.baseURL, nuxt.options.app.buildAssetsDir);
 				nuxt.options.nitro.virtual ||= {};
-				nuxt.options.nitro.virtual["#vizejs/nuxt/dev-stylesheet-links-config"] = `export const devAssetBase = ${JSON.stringify(compilerOptions.devUrlBase)};`;
+				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) => {
@@ -405,40 +457,44 @@ var src_default = defineNuxtModule({
 					const p = config.plugins[i];
 					const name = p && typeof p === "object" && "name" in p ? p.name : "";
 					if (name === "vite:vue") config.plugins.splice(i, 1);
-					else if (name === "nuxt:compiler:keyed-functions") patchNuxtKeyedFunctionsPlugin(p);
+					else if (bridgeOptions.stableInjectedKeys && name === "nuxt:compiler:keyed-functions") patchNuxtKeyedFunctionsPlugin(p);
 				}
 			});
 		}
 		let unimportCtx = null;
-		nuxt.hook("imports:context", (ctx) => {
+		if (bridgeOptions.autoImports) nuxt.hook("imports:context", (ctx) => {
 			unimportCtx = ctx;
 		});
-		const nuxtComponentResolver = createNuxtComponentResolver({
+		const nuxtComponentResolver = bridgeOptions.components ? createNuxtComponentResolver({
 			buildDir: nuxt.options.buildDir,
 			moduleNames: nuxt.options.modules.filter((moduleName) => typeof moduleName === "string"),
 			rootDir: nuxt.options.rootDir
-		});
-		nuxt.hook("components:extend", (comps) => {
+		}) : null;
+		if (nuxtComponentResolver) nuxt.hook("components:extend", (comps) => {
 			nuxtComponentResolver.register(comps);
 		});
-		addVitePlugin({
+		if (bridgeOptions.autoImports || bridgeOptions.components || bridgeOptions.i18n || bridgeOptions.stableInjectedKeys) addVitePlugin({
 			name: "vizejs:nuxt-transform-bridge",
 			enforce: "post",
 			async transform(code, id) {
 				if (!isVizeVirtualVueModuleId(id)) return;
 				let result = code;
 				let changed = false;
-				const nextComponentResult = injectNuxtComponentImports(result, (name) => {
-					return nuxtComponentResolver.resolve(name);
-				});
-				if (nextComponentResult !== result) {
-					result = nextComponentResult;
-					changed = true;
+				if (nuxtComponentResolver) {
+					const nextComponentResult = injectNuxtComponentImports(result, (name) => {
+						return nuxtComponentResolver.resolve(name);
+					});
+					if (nextComponentResult !== result) {
+						result = nextComponentResult;
+						changed = true;
+					}
 				}
-				const nextResult = injectNuxtI18nHelpers(result);
-				if (nextResult !== result) {
-					result = nextResult;
-					changed = true;
+				if (bridgeOptions.i18n) {
+					const nextResult = injectNuxtI18nHelpers(result);
+					if (nextResult !== result) {
+						result = nextResult;
+						changed = true;
+					}
 				}
 				if (unimportCtx) try {
 					const injected = await unimportCtx.injectImports(result, id);
@@ -447,10 +503,12 @@ var src_default = defineNuxtModule({
 						changed = true;
 					}
 				} catch {}
-				const stableKeyResult = normalizeNuxtInjectedKeysForVizeVirtualModule(result, id);
-				if (stableKeyResult !== result) {
-					result = stableKeyResult;
-					changed = true;
+				if (bridgeOptions.stableInjectedKeys) {
+					const stableKeyResult = normalizeNuxtInjectedKeysForVizeVirtualModule(result, id);
+					if (stableKeyResult !== result) {
+						result = stableKeyResult;
+						changed = true;
+					}
 				}
 				if (changed) return {
 					code: result,
@@ -458,7 +516,7 @@ var src_default = defineNuxtModule({
 				};
 			}
 		});
-		addVitePlugin({
+		if (unocssOptions !== false) addVitePlugin({
 			name: "vizejs:unocss-bridge",
 			configResolved(config) {
 				for (const plugin of config.plugins) if (plugin.name?.startsWith("unocss:") && typeof plugin.transform === "function") {
@@ -468,7 +526,7 @@ var src_default = defineNuxtModule({
 						if (isVizeVirtualVueModuleId(id)) {
 							const normalizedId = normalizeVizeVirtualVueModuleId(id);
 							let effectiveCode = code;
-							if (isExtractionOnly) effectiveCode = appendOriginalVueSourceForUnoCss(code, normalizedId);
+							if (isExtractionOnly && unocssOptions.originalSource !== false) effectiveCode = appendOriginalVueSourceForUnoCss(code, normalizedId, { maxBytes: unocssOptions.originalSource.maxBytes });
 							return origTransform.call(this, effectiveCode, normalizedId, ...args);
 						}
 						return origTransform.call(this, code, id, ...args);
@@ -476,9 +534,9 @@ var src_default = defineNuxtModule({
 				}
 			}
 		});
-		if (options.musea !== false) {
-			const museaBasePath = options.musea && typeof options.musea === "object" && "basePath" in options.musea ? options.musea.basePath : "/__musea__";
-			nuxt.options.vite.plugins.push(...musea(options.musea || {}));
+		if (museaOptions !== false) {
+			const museaBasePath = "basePath" in museaOptions ? museaOptions.basePath : "/__musea__";
+			nuxt.options.vite.plugins.push(...musea(museaOptions));
 			nuxt.hook("listen", (_server, listener) => {
 				const url = listener.url?.replace(/\/$/, "") || "http://localhost:3000";
 				console.log(`  \x1b[36m➜\x1b[0m  \x1b[1mMusea Gallery:\x1b[0m \x1b[36m${url}${museaBasePath}\x1b[0m`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/nuxt",
-  "version": "0.108.0",
+  "version": "0.112.0",
   "description": "Nuxt module for Vize - compiler, musea gallery, linter, and type checker",
   "keywords": [
     "compiler",
@@ -40,11 +40,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@nuxt/kit": "4.4.5",
-    "@vizejs/musea-nuxt": "0.108.0",
-    "@vizejs/vite-plugin": "0.108.0",
-    "@vizejs/vite-plugin-musea": "0.108.0",
-    "vize": "0.108.0"
+    "@nuxt/kit": "4.4.6",
+    "@vizejs/musea-nuxt": "0.112.0",
+    "@vizejs/vite-plugin": "0.112.0",
+    "@vizejs/vite-plugin-musea": "0.112.0",
+    "vize": "0.112.0"
   },
   "devDependencies": {
     "typescript": "6.0.3",