@vizejs/nuxt 0.426.3 → 0.428.0

package/dist/{addons-BLKAdEmK.d.mts → addons-7LzN4Qa1.d.mts}

@@ -1,6 +1,40 @@
 import { NuxtLintConfigItem, NuxtLintFeatures } from "@vizejs/nuxt-lint-config";
 import { MuseaOptions } from "@vizejs/vite-plugin-musea";
 
+//#region src/libraries.d.ts
+/** Options for auto-registering `@vizejs/ui` components (and its `use*` helpers). */
+interface VizeNuxtUiOptions {
+  /** Component name prefix, for example `"Vz"` for `<VzButton>`. @default "" */
+  prefix?: string;
+  /** Only register these families (package subpaths without `./`). @default every family */
+  include?: string[];
+  /** Never register these families. @default [] */
+  exclude?: string[];
+  /** Also auto-import the `use*` helpers exported by the included families. @default true */
+  composables?: boolean;
+  /** Resolve to the package or to `vize lib pull` copies. @default "package" */
+  source?: "local" | "package";
+  /** Lockfile path relative to the Nuxt root. @default "vize-lib.lock.json" */
+  lockfile?: string;
+  /** In local mode, fall back to the package for families that were not pulled. @default true */
+  fallback?: boolean;
+}
+/** Options for auto-importing `@vizejs/composable` exports. */
+interface VizeNuxtComposablesOptions {
+  /** Only import from these entries (for example `"use-toggle"`). @default every entry */
+  include?: string[];
+  /** Never import from these entries. @default [] */
+  exclude?: string[];
+  /** Only import these export names. @default every runtime export */
+  names?: string[];
+  /** Resolve to the package or to `vize lib pull` copies. @default "package" */
+  source?: "local" | "package";
+  /** Lockfile path relative to the Nuxt root. @default "vize-lib.lock.json" */
+  lockfile?: string;
+  /** In local mode, fall back to the package for entries that were not pulled. @default true */
+  fallback?: boolean;
+}
+//#endregion
 //#region src/compiler-options.d.ts
 type VizeNuxtPattern = string | RegExp;
 type VizeNuxtVueVersion = 0.11 | 1 | 2 | "2.7" | 3 | "legacy";
@@ -336,6 +370,21 @@ interface VizeNuxtOptions {
    * Real Nuxt composables are available via Nuxt's own plugin pipeline.
    */
   nuxtMusea?: NuxtMuseaOptions;
+  /**
+   * Auto-register every `@vizejs/ui` component (and auto-import its `use*`
+   * helpers) from the library catalog, as direct family subpath imports.
+   * Requires `@vizejs/ui` in the project. Opt-in.
+   *
+   * @default false
+   */
+  ui?: boolean | VizeNuxtUiOptions;
+  /**
+   * Auto-import every `@vizejs/composable` export from the library catalog,
+   * as direct entry subpath imports. Requires `@vizejs/composable`. Opt-in.
+   *
+   * @default false
+   */
+  composables?: boolean | VizeNuxtComposablesOptions;
 }
 //#endregion
 //#region src/lint/addons.d.ts
@@ -372,4 +421,4 @@ type ResolveNuxtLintConfigAddons = () => Promise<readonly NuxtLintConfigItem[]>;
  */
 declare function setupNuxtLintConfigAddons(nuxt: NuxtLintConfigAddonNuxt): ResolveNuxtLintConfigAddons;
 //#endregion
-export { VizeNuxtLintCheckerOptions as _, ResolveNuxtLintConfigAddons as a, VizeNuxtCompilerOptions as b, NuxtMuseaOptions as c, VizeNuxtDevOptions as d, VizeNuxtMajorVersion as f, ResolvedVizeNuxtLintCheckerOptions as g, VizeNuxtLintOptions as h, NuxtLintImport as i, VizeNuxtBridgeOptions as l, VizeNuxtUnoCssOptions as m, NuxtLintConfigAddon as n, VIZE_NUXT_LINT_CONFIG_ADDONS_HOOK as o, VizeNuxtOptions as p, NuxtLintConfigAddonNuxt as r, setupNuxtLintConfigAddons as s, NuxtLintAwaitable as t, VizeNuxtCompatibilityOptions as u, resolveNuxtLintCheckerOptions as v, VizeNuxtVueVersion as x, VizeNuxtCompilerCompatibilityOptions as y };
+export { VizeNuxtUiOptions as C, VizeNuxtComposablesOptions as S, VizeNuxtLintCheckerOptions as _, ResolveNuxtLintConfigAddons as a, VizeNuxtCompilerOptions as b, NuxtMuseaOptions as c, VizeNuxtDevOptions as d, VizeNuxtMajorVersion as f, ResolvedVizeNuxtLintCheckerOptions as g, VizeNuxtLintOptions as h, NuxtLintImport as i, VizeNuxtBridgeOptions as l, VizeNuxtUnoCssOptions as m, NuxtLintConfigAddon as n, VIZE_NUXT_LINT_CONFIG_ADDONS_HOOK as o, VizeNuxtOptions as p, NuxtLintConfigAddonNuxt as r, setupNuxtLintConfigAddons as s, NuxtLintAwaitable as t, VizeNuxtCompatibilityOptions as u, resolveNuxtLintCheckerOptions as v, VizeNuxtVueVersion as x, VizeNuxtCompilerCompatibilityOptions as y };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as VizeNuxtLintCheckerOptions, b as VizeNuxtCompilerOptions, c as NuxtMuseaOptions, d as VizeNuxtDevOptions, f as VizeNuxtMajorVersion, h as VizeNuxtLintOptions, l as VizeNuxtBridgeOptions, m as VizeNuxtUnoCssOptions, n as NuxtLintConfigAddon, p as VizeNuxtOptions, u as VizeNuxtCompatibilityOptions, x as VizeNuxtVueVersion, y as VizeNuxtCompilerCompatibilityOptions } from "./addons-BLKAdEmK.mjs";
+import { C as VizeNuxtUiOptions, S as VizeNuxtComposablesOptions, _ as VizeNuxtLintCheckerOptions, b as VizeNuxtCompilerOptions, c as NuxtMuseaOptions, d as VizeNuxtDevOptions, f as VizeNuxtMajorVersion, h as VizeNuxtLintOptions, l as VizeNuxtBridgeOptions, m as VizeNuxtUnoCssOptions, n as NuxtLintConfigAddon, p as VizeNuxtOptions, u as VizeNuxtCompatibilityOptions, x as VizeNuxtVueVersion, y as VizeNuxtCompilerCompatibilityOptions } from "./addons-7LzN4Qa1.mjs";
 import { MuseaOptions } from "@vizejs/vite-plugin-musea";
 
 //#region src/schema.d.ts
@@ -90,4 +90,4 @@ declare const vizeNuxtModule: ((this: VizeNuxtModuleContext | void, inlineOption
   };
 };
 //#endregion
-export { type MuseaOptions, type NuxtMuseaOptions, type VizeNuxtBridgeOptions, type VizeNuxtCompatibilityOptions, type VizeNuxtCompilerCompatibilityOptions, type VizeNuxtCompilerOptions, type VizeNuxtDevOptions, type VizeNuxtLintCheckerOptions, type VizeNuxtLintOptions, type VizeNuxtMajorVersion, type VizeNuxtOptions, type VizeNuxtUnoCssOptions, type VizeNuxtVueVersion, vizeNuxtModule as default };
+export { type MuseaOptions, type NuxtMuseaOptions, type VizeNuxtBridgeOptions, type VizeNuxtCompatibilityOptions, type VizeNuxtCompilerCompatibilityOptions, type VizeNuxtCompilerOptions, type VizeNuxtComposablesOptions, type VizeNuxtDevOptions, type VizeNuxtLintCheckerOptions, type VizeNuxtLintOptions, type VizeNuxtMajorVersion, type VizeNuxtOptions, type VizeNuxtUiOptions, type VizeNuxtUnoCssOptions, type VizeNuxtVueVersion, vizeNuxtModule as default };

package/dist/index.mjs

@@ -1,8 +1,9 @@
 import { i as setupLintInspector, l as setupNuxtLintChecker, n as setupNuxtLintConfigGeneration, p as isViteNuxtBuilder } from "./generation-0O5ZoaRp.mjs";
 import { createRequire } from "node:module";
 import fs from "node:fs";
-import path, { dirname, resolve } from "node:path";
+import path, { dirname, join, resolve } from "node:path";
 import { parseSync } from "vite";
+import { pathToFileURL } from "node:url";
 import { createHash } from "node:crypto";
 //#region src/components.ts
 const COMPONENT_CALL_RE = /_?resolveComponent\s*\(\s*["'`]([^"'`]+)["'`]\s*(?:,\s*[^)]+)?\)/g;
@@ -1090,6 +1091,88 @@ function createNuxtModuleResolver() {
 	const moduleDir = dirname(nodeRequire.resolve("@vizejs/nuxt"));
 	return { resolve: (...segments) => resolve(moduleDir, ...segments) };
 }
+//#endregion
+//#region src/libraries.ts
+function projectLoader(rootDir, specifier, option) {
+	return async () => {
+		const projectRequire = createRequire(join(rootDir, "package.json"));
+		let resolved;
+		try {
+			resolved = projectRequire.resolve(specifier);
+		} catch (error) {
+			throw new Error(`[@vizejs/nuxt] \`vize.${option}\` needs ${specifier.replace(/\/resolver$/, "")} installed in the project`, { cause: error });
+		}
+		return await import(pathToFileURL(resolved).href);
+	};
+}
+/** Resolve resolver modules from the Nuxt project, so the project's installed versions drive registration. */
+function createProjectLibraryLoaders(rootDir) {
+	return {
+		ui: projectLoader(rootDir, "@vizejs/ui/resolver", "ui"),
+		composables: projectLoader(rootDir, "@vizejs/composable/resolver", "composables")
+	};
+}
+function withoutUndefined(options) {
+	return Object.fromEntries(Object.entries(options).filter(([, value]) => value !== void 0));
+}
+/**
+* Plan component and import registrations from the library catalogs.
+* Everything resolves to direct family/entry subpaths, so tree shaking is
+* identical to hand-written imports; Nuxt generates the typed `.d.ts` files.
+*/
+async function planVizeLibraryIntegration(options, rootDir, loaders = createProjectLibraryLoaders(rootDir)) {
+	const plan = {
+		components: [],
+		imports: []
+	};
+	if (options.ui !== void 0 && options.ui !== false) {
+		const ui = options.ui === true ? {} : options.ui;
+		const resolverOptions = withoutUndefined({
+			prefix: ui.prefix,
+			include: ui.include,
+			exclude: ui.exclude,
+			source: ui.source,
+			lockfile: ui.lockfile,
+			fallback: ui.fallback,
+			root: rootDir
+		});
+		const module = await loaders.ui();
+		for (const item of module.listVizeUiComponents(resolverOptions)) plan.components.push({
+			name: item.as ?? item.name,
+			export: item.name,
+			filePath: item.from
+		});
+		if (ui.composables !== false) for (const item of module.listVizeUiComposables(resolverOptions)) plan.imports.push({
+			name: item.name,
+			from: item.from
+		});
+	}
+	if (options.composables !== void 0 && options.composables !== false) {
+		const composables = options.composables === true ? {} : options.composables;
+		const module = await loaders.composables();
+		const taken = new Set(plan.imports.map((item) => item.name));
+		for (const item of module.listVizeComposableImports(withoutUndefined({
+			...composables,
+			root: rootDir
+		}))) if (!taken.has(item.name)) plan.imports.push({
+			name: item.name,
+			from: item.from
+		});
+	}
+	return plan;
+}
+/** Register the planned components and imports with Nuxt. */
+async function setupVizeLibraries(options, rootDir, loadKit, loaders) {
+	if (!(options.ui !== void 0 && options.ui !== false || options.composables !== void 0 && options.composables !== false)) return {
+		components: [],
+		imports: []
+	};
+	const plan = await planVizeLibraryIntegration(options, rootDir, loaders);
+	const kit = await loadKit();
+	for (const component of plan.components) kit.addComponent(component);
+	if (plan.imports.length > 0) kit.addImports(plan.imports);
+	return plan;
+}
 function readTextFile(filePath) {
 	return fs.readFileSync(filePath, "utf-8");
 }
@@ -1114,6 +1197,23 @@ function appendOriginalVueSourceForUnoCss(code, normalizedId, options = {}) {
 	}
 }
 //#endregion
+//#region src/ssr-runtime.ts
+const VUE_SSR_EXTERNAL = [
+	"vue",
+	"vue/server-renderer",
+	"@vue/server-renderer"
+];
+function externalizeVueRuntimeForNuxtSsr(config) {
+	const rolldownOptions = config.build?.rolldownOptions;
+	if (!rolldownOptions) return;
+	const previous = rolldownOptions.external;
+	if (typeof previous === "function") {
+		rolldownOptions.external = (id, ...args) => VUE_SSR_EXTERNAL.some((specifier) => specifier === id) || previous(id, ...args);
+		return;
+	}
+	rolldownOptions.external = [...new Set([...previous == null ? [] : Array.isArray(previous) ? previous : [previous], ...VUE_SSR_EXTERNAL])];
+}
+//#endregion
 //#region src/index.ts
 const VIZE_NUXT_AUTO_IMPORT_PATCHED = "__vizeNuxtAutoImportPatched";
 const VUE_RUNTIME_DEDUPE = [
@@ -1250,6 +1350,10 @@ async function setupVizeNuxtModule(options, nuxt) {
 	const museaOptions = detectedNuxtMajor === 2 ? false : resolveNuxtMuseaOptions(options.musea);
 	const unocssOptions = resolveNuxtUnoCssOptions(options.unocss);
 	if (museaOptions !== false) nuxt.hook("components:dirs", appendMuseaArtComponentIgnore);
+	await setupVizeLibraries({
+		ui: options.ui,
+		composables: options.composables
+	}, nuxt.options.rootDir, loadNuxtKit);
 	const compilerOptions = resolveNuxtCompilerOptions(nuxt.options.rootDir, appBaseURL, buildAssetsDir, options.compiler, {
 		supportsViteCompiler,
 		vueVersion
@@ -1264,12 +1368,17 @@ async function setupVizeNuxtModule(options, nuxt) {
 	}
 	let isNuxtBuild = false;
 	let isViteBuild = false;
-	if (usesVizeCompiler) nuxt.hook("build:before", () => {
-		if (nuxt.options.dev !== false) return;
-		isNuxtBuild = true;
-		nuxt.options.vite ||= {};
-		dedupeVueRuntimePackages(nuxt.options.vite);
-	});
+	if (usesVizeCompiler) {
+		nuxt.hook("build:before", () => {
+			if (nuxt.options.dev !== false) return;
+			isNuxtBuild = true;
+			nuxt.options.vite ||= {};
+			dedupeVueRuntimePackages(nuxt.options.vite);
+		});
+		nuxt.hook("vite:extendConfig", (config, context) => {
+			if (nuxt.options.dev === false && context?.isServer) externalizeVueRuntimeForNuxtSsr(config);
+		});
+	}
 	if (usesVizeCompiler) {
 		if (nuxt.options.dev && devOptions.stylesheetLinks) {
 			const devAssetBase = compilerOptions.devUrlBase ?? buildNuxtDevAssetBase(appBaseURL, buildAssetsDir);

package/dist/lint/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as VizeNuxtLintCheckerOptions, a as ResolveNuxtLintConfigAddons, g as ResolvedVizeNuxtLintCheckerOptions, h as VizeNuxtLintOptions, i as NuxtLintImport, n as NuxtLintConfigAddon, o as VIZE_NUXT_LINT_CONFIG_ADDONS_HOOK, r as NuxtLintConfigAddonNuxt, s as setupNuxtLintConfigAddons, t as NuxtLintAwaitable, v as resolveNuxtLintCheckerOptions } from "../addons-BLKAdEmK.mjs";
+import { _ as VizeNuxtLintCheckerOptions, a as ResolveNuxtLintConfigAddons, g as ResolvedVizeNuxtLintCheckerOptions, h as VizeNuxtLintOptions, i as NuxtLintImport, n as NuxtLintConfigAddon, o as VIZE_NUXT_LINT_CONFIG_ADDONS_HOOK, r as NuxtLintConfigAddonNuxt, s as setupNuxtLintConfigAddons, t as NuxtLintAwaitable, v as resolveNuxtLintCheckerOptions } from "../addons-7LzN4Qa1.mjs";
 import { NuxtLintConfigItem, NuxtLintDirNames, NuxtLintLayer, NuxtLintProjectState } from "@vizejs/nuxt-lint-config";
 export * from "@vizejs/nuxt-lint-config";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizejs/nuxt",
-  "version": "0.426.3",
+  "version": "0.428.0",
   "description": "Nuxt module for Vize - compiler, musea gallery, linter, and type checker",
   "keywords": [
     "compiler",
@@ -49,12 +49,12 @@
   },
   "dependencies": {
     "@nuxt/kit": "3.11.2",
-    "@vizejs/native": "0.426.3",
-    "@vizejs/nuxt-lint-config": "0.426.3",
-    "@vizejs/vite-plugin": "0.426.3",
-    "@vizejs/vite-plugin-musea": "0.426.3",
-    "oxlint-plugin-vize": "0.426.3",
-    "vize": "0.426.3"
+    "@vizejs/native": "0.428.0",
+    "@vizejs/nuxt-lint-config": "0.428.0",
+    "@vizejs/vite-plugin": "0.428.0",
+    "@vizejs/vite-plugin-musea": "0.428.0",
+    "oxlint-plugin-vize": "0.428.0",
+    "vize": "0.428.0"
   },
   "devDependencies": {
     "jiti-nuxt2": "npm:jiti@1.21.7",