@nuxt/kit 3.20.2 → 3.21.1

package/README.md

@@ -6,9 +6,11 @@
   <a href="https://www.npmjs.com/package/nuxt"><img src="https://img.shields.io/npm/v/nuxt.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="Version"></a>
   <a href="https://www.npmjs.com/package/nuxt"><img src="https://img.shields.io/npm/dm/nuxt.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="Downloads"></a>
   <a href="https://github.com/nuxt/nuxt/blob/main/LICENSE"><img src="https://img.shields.io/github/license/nuxt/nuxt.svg?style=flat&colorA=18181B&colorB=28CF8D" alt="License"></a>
+  <a href="https://nuxt.com/modules"><img src="https://img.shields.io/badge/dynamic/json?url=https://nuxt.com/api/v1/modules&query=$.stats.modules&label=Modules&style=flat&colorA=18181B&colorB=28CF8D" alt="Modules"></a>
   <a href="https://nuxt.com"><img src="https://img.shields.io/badge/Nuxt%20Docs-18181B?logo=nuxt" alt="Website"></a>
   <a href="https://chat.nuxt.dev"><img src="https://img.shields.io/badge/Nuxt%20Discord-18181B?logo=discord" alt="Discord"></a>
   <a href="https://securityscorecards.dev/"><img src="https://api.securityscorecards.dev/projects/github.com/nuxt/nuxt/badge" alt="Nuxt openssf scorecard score"></a>
+  <a href="https://deepwiki.com/nuxt/nuxt"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </p>
 
 Nuxt is a free and open-source framework with an intuitive and extendable way to create type-safe, performant and production-grade full-stack web applications and websites with Vue.js.
@@ -21,14 +23,14 @@ It provides a number of features that make it easy to build fast, SEO-friendly,
 - Auto imports of components, composables and utils
 - TypeScript with zero configuration
 - Go full-stack with our server/ directory
-- Extensible with [200+ modules](https://nuxt.com/modules)
+- Extensible with [300+ modules](https://nuxt.com/modules)
 - Deployment to a variety of [hosting platforms](https://nuxt.com/deploy)
 - ...[and much more](https://nuxt.com) 🚀
 
 ### Table of Contents
 
 - 🚀 [Getting Started](#getting-started)
-- 💻 [ Vue Development](#vue-development)
+- 💻 [Vue Development](#vue-development)
 - 📖 [Documentation](#documentation)
 - 🧩 [Modules](#modules)
 - ❤️ [Contribute](#contribute)
@@ -109,7 +111,7 @@ Follow the docs to [Set Up Your Local Development Environment](https://nuxt.com/
 ## <a name="follow-us">🔗 Follow Us</a>
 
 <p valign="center">
-  <a href="https://go.nuxt.com/discord"><img width="20px" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/discord.svg" alt="Discord"></a>&nbsp;&nbsp;<a href="https://go.nuxt.com/x"><img width="20px" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/twitter.svg" alt="Twitter"></a>&nbsp;&nbsp;<a href="https://go.nuxt.com/github"><img width="20px" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/github.svg" alt="GitHub"></a>&nbsp;&nbsp;<a href="https://go.nuxt.com/bluesky"><img width="20px" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/bluesky.svg" alt="Bluesky"></a>
+  <a href="https://go.nuxt.com/discord"><img width="20" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/discord.svg" alt="Discord"></a>&nbsp;&nbsp;<a href="https://go.nuxt.com/x"><img width="20" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/twitter.svg" alt="Twitter"></a>&nbsp;&nbsp;<a href="https://go.nuxt.com/github"><img width="20" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/github.svg" alt="GitHub"></a>&nbsp;&nbsp;<a href="https://go.nuxt.com/bluesky"><img width="20" src="https://github.com/nuxt/nuxt/blob/main/.github/assets/bluesky.svg" alt="Bluesky"></a>
 </p>
 
 ## <a name="license">⚖️ License</a>

package/dist/index.d.mts

@@ -1,15 +1,14 @@
-import * as _nuxt_schema from '@nuxt/schema';
-import { ModuleOptions, ModuleDefinition, NuxtModule, NuxtConfig, Nuxt, ModuleMeta, NuxtOptions, SchemaDefinition, NuxtAppConfig, NuxtCompatibility, NuxtCompatibilityIssues, Component, ComponentsDir, NuxtTemplate, NuxtMiddleware, NuxtHooks, NuxtPlugin, NuxtPluginTemplate, ResolvedNuxtTemplate, NuxtServerTemplate, NuxtTypeTemplate } from '@nuxt/schema';
+import { ModuleOptions, ModuleDefinition, NuxtModule, NuxtConfig, Nuxt, ModuleMeta, NuxtOptions, SchemaDefinition, NuxtAppConfig, NuxtCompatibility, NuxtCompatibilityIssues, Component, ComponentsDir, NuxtTemplate, NuxtMiddleware, NuxtHooks, NuxtPlugin, NuxtPluginTemplate, NuxtServerTemplate, ResolvedNuxtTemplate, NuxtTypeTemplate } from '@nuxt/schema';
 import { LoadConfigOptions } from 'c12';
 import { Import, InlinePreset } from 'unimport';
 import { WebpackPluginInstance, Configuration } from 'webpack';
 import { RspackPluginInstance } from '@rspack/core';
 import { Plugin, UserConfig } from 'vite';
-import * as unctx from 'unctx';
-import { NitroRouteConfig, NitroEventHandler, NitroDevEventHandler, Nitro } from 'nitropack';
+import { UseContext } from 'unctx';
+import * as NitroV2 from 'nitropack/types';
+import * as NitroV3 from 'nitro/types';
 import { GlobOptions } from 'tinyglobby';
-import * as consola from 'consola';
-import { ConsolaOptions } from 'consola';
+import { ConsolaInstance, ConsolaOptions } from 'consola';
 import { genSafeVariableName } from 'knitwork';
 
 /**
@@ -53,7 +52,7 @@ declare const normalizeModuleTranspilePath: (p: string) => string;
  */
 declare function hasNuxtModule(moduleName: string, nuxt?: Nuxt): boolean;
 /**
- * Checks if a Nuxt Module is compatible with a given semver version.
+ * Checks if a Nuxt module is compatible with a given semver version.
  */
 declare function hasNuxtModuleCompatibility(module: string | NuxtModule, semverVersion: string, nuxt?: Nuxt): Promise<boolean>;
 /**
@@ -116,7 +115,7 @@ interface LayerDirectories {
  * @param nuxt - The Nuxt instance to get layers from. Defaults to the current Nuxt context.
  * @returns Array of LayerDirectories objects, ordered by priority (user layer first)
  */
-declare function getLayerDirectories(nuxt?: _nuxt_schema.Nuxt): LayerDirectories[];
+declare function getLayerDirectories(nuxt?: Nuxt): LayerDirectories[];
 
 declare function setGlobalHead(head: NuxtAppConfig['head']): void;
 
@@ -137,6 +136,8 @@ declare function useRuntimeConfig(): Record<string, any>;
  */
 declare function updateRuntimeConfig(runtimeConfig: Record<string, unknown>): void | Promise<void>;
 
+type Arrayable<T> = T | T[];
+type Thenable<T> = T | Promise<T>;
 interface ExtendConfigOptions {
     /**
      * Install plugin on dev
@@ -183,40 +184,41 @@ interface ExtendViteConfigOptions extends Omit<ExtendConfigOptions, 'server' | '
      */
     client?: boolean;
 }
+type ExtendWebpacklikeConfig = (fn: (config: Configuration) => void, options?: ExtendWebpackConfigOptions) => void;
 /**
  * Extend webpack config
  *
  * The fallback function might be called multiple times
  * when applying to both client and server builds.
  */
-declare const extendWebpackConfig: (fn: ((config: Configuration) => void), options?: ExtendWebpackConfigOptions) => void;
+declare const extendWebpackConfig: ExtendWebpacklikeConfig;
 /**
  * Extend rspack config
  *
  * The fallback function might be called multiple times
  * when applying to both client and server builds.
  */
-declare const extendRspackConfig: (fn: ((config: Configuration) => void), options?: ExtendWebpackConfigOptions) => void;
+declare const extendRspackConfig: ExtendWebpacklikeConfig;
 /**
  * Extend Vite config
  */
-declare function extendViteConfig(fn: ((config: UserConfig) => void), options?: ExtendViteConfigOptions): (() => void) | undefined;
+declare function extendViteConfig(fn: ((config: UserConfig) => Thenable<void>), options?: ExtendViteConfigOptions): (() => void) | undefined;
 /**
  * Append webpack plugin to the config.
  */
-declare function addWebpackPlugin(pluginOrGetter: WebpackPluginInstance | WebpackPluginInstance[] | (() => WebpackPluginInstance | WebpackPluginInstance[]), options?: ExtendWebpackConfigOptions): void;
+declare function addWebpackPlugin(pluginOrGetter: Arrayable<WebpackPluginInstance> | (() => Thenable<Arrayable<WebpackPluginInstance>>), options?: ExtendWebpackConfigOptions): void;
 /**
  * Append rspack plugin to the config.
  */
-declare function addRspackPlugin(pluginOrGetter: RspackPluginInstance | RspackPluginInstance[] | (() => RspackPluginInstance | RspackPluginInstance[]), options?: ExtendWebpackConfigOptions): void;
+declare function addRspackPlugin(pluginOrGetter: Arrayable<RspackPluginInstance> | (() => Thenable<Arrayable<RspackPluginInstance>>), options?: ExtendWebpackConfigOptions): void;
 /**
  * Append Vite plugin to the config.
  */
-declare function addVitePlugin(pluginOrGetter: Plugin | Plugin[] | (() => Plugin | Plugin[]), options?: ExtendConfigOptions): void;
+declare function addVitePlugin(pluginOrGetter: Arrayable<Plugin> | (() => Thenable<Arrayable<Plugin>>), options?: ExtendConfigOptions): void;
 interface AddBuildPluginFactory {
-    vite?: () => Plugin | Plugin[];
-    webpack?: () => WebpackPluginInstance | WebpackPluginInstance[];
-    rspack?: () => RspackPluginInstance | RspackPluginInstance[];
+    vite?: () => Thenable<Arrayable<Plugin>>;
+    webpack?: () => Thenable<Arrayable<WebpackPluginInstance>>;
+    rspack?: () => Thenable<Arrayable<RspackPluginInstance>>;
 }
 declare function addBuildPlugin(pluginFactory: AddBuildPluginFactory, options?: ExtendConfigOptions): void;
 
@@ -233,10 +235,11 @@ declare function assertNuxtCompatibility(constraints: NuxtCompatibility, nuxt?:
  * Check version constraints and return true if passed, otherwise returns false
  */
 declare function hasNuxtCompatibility(constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<boolean>;
+type NuxtMajorVersion = 2 | 3 | 4;
 /**
  * Check if current Nuxt instance is of specified major version
  */
-declare function isNuxtMajorVersion(majorVersion: 2 | 3 | 4, nuxt?: Nuxt): boolean;
+declare function isNuxtMajorVersion(majorVersion: NuxtMajorVersion, nuxt?: Nuxt): boolean;
 /**
  * @deprecated Use `isNuxtMajorVersion(2, nuxt)` instead. This may be removed in \@nuxt/kit v5 or a future major version.
  */
@@ -279,7 +282,7 @@ declare function addComponent(opts: AddComponentOptions): void;
  * Direct access to the Nuxt global context - see https://github.com/unjs/unctx.
  * @deprecated Use `getNuxtCtx` instead
  */
-declare const nuxtCtx: unctx.UseContext<Nuxt>;
+declare const nuxtCtx: UseContext<Nuxt>;
 /** Direct access to the Nuxt context with asyncLocalStorage - see https://github.com/unjs/unctx. */
 declare const getNuxtCtx: () => Nuxt | null;
 /**
@@ -307,15 +310,22 @@ declare function useNuxt(): Nuxt;
 declare function tryUseNuxt(): Nuxt | null;
 declare function runWithNuxtContext<T extends (...args: any[]) => any>(nuxt: Nuxt, fn: T): ReturnType<T>;
 
-declare function createIsIgnored(nuxt?: _nuxt_schema.Nuxt | null): (pathname: string, stats?: unknown) => boolean;
+declare function createIsIgnored(nuxt?: Nuxt | null | undefined): (pathname: string, stats?: unknown) => boolean;
 /**
  * Return a filter function to filter an array of paths
  */
-declare function isIgnored(pathname: string, _stats?: unknown, nuxt?: _nuxt_schema.Nuxt | null): boolean;
+declare function isIgnored(pathname: string, _stats?: unknown, nuxt?: Nuxt | null | undefined): boolean;
 declare function resolveIgnorePatterns(relativePath?: string): string[];
 
 declare function addLayout(this: any, template: NuxtTemplate | string, name?: string): void;
 
+type isNitroV2 = 'options' extends keyof NitroV2.Nitro ? '___INVALID' extends keyof NitroV2.Nitro ? false : true : false;
+type isNitroV3 = 'options' extends keyof NitroV3.Nitro ? '___INVALID' extends keyof NitroV3.Nitro ? false : true : false;
+type Nitro = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.Nitro | NitroV3.Nitro : NitroV2.Nitro : NitroV3.Nitro;
+type NitroDevEventHandler = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroDevEventHandler | NitroV3.NitroDevEventHandler : NitroV2.NitroDevEventHandler : NitroV3.NitroDevEventHandler;
+type NitroEventHandler = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroEventHandler | NitroV3.NitroEventHandler : NitroV2.NitroEventHandler : NitroV3.NitroEventHandler;
+type NitroRouteConfig = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroRouteConfig | NitroV3.NitroRouteConfig : NitroV2.NitroRouteConfig : NitroV3.NitroRouteConfig;
+
 declare function extendPages(cb: NuxtHooks['pages:extend']): void;
 interface ExtendRouteRulesOptions {
     /**
@@ -516,11 +526,11 @@ declare function normalizeTemplate<T>(template: NuxtTemplate<T> | string, buildD
  */
 declare function updateTemplates(options?: {
     filter?: (template: ResolvedNuxtTemplate<any>) => boolean;
-}): Promise<any>;
+}): Promise<void>;
 declare function writeTypes(nuxt: Nuxt): Promise<void>;
 
-declare const logger: consola.ConsolaInstance;
-declare function useLogger(tag?: string, options?: Partial<ConsolaOptions>): consola.ConsolaInstance;
+declare const logger: ConsolaInstance;
+declare function useLogger(tag?: string, options?: Partial<ConsolaOptions>): ConsolaInstance;
 
 interface ResolveModuleOptions {
     /** @deprecated use `url` with URLs pointing at a file - never a directory */
@@ -567,4 +577,4 @@ declare const templateUtils: {
 };
 
 export { addBuildPlugin, addComponent, addComponentExports, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addRspackPlugin, addServerHandler, addServerImports, addServerImportsDir, addServerPlugin, addServerScanDir, addServerTemplate, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createIsIgnored, createResolver, defineNuxtModule, directoryToURL, extendNuxtSchema, extendPages, extendRouteRules, extendRspackConfig, extendViteConfig, extendWebpackConfig, findPath, getDirectory, getLayerDirectories, getNuxtCtx, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule, installModule, installModules, isIgnored, isNuxt2, isNuxt3, isNuxtMajorVersion, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveModuleWithOptions, resolveNuxtModule, resolvePath, runWithNuxtContext, setGlobalHead, templateUtils, tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateRuntimeConfig, updateTemplates, useLogger, useNitro, useNuxt, useRuntimeConfig, writeTypes };
-export type { AddComponentOptions, AddPluginOptions, AddRouteMiddlewareOptions, ExtendConfigOptions, ExtendRouteRulesOptions, ExtendViteConfigOptions, ExtendWebpackConfigOptions, ImportModuleOptions, LayerDirectories, LoadNuxtConfigOptions, LoadNuxtOptions, ResolveModuleOptions, ResolvePathOptions, Resolver };
+export type { AddComponentOptions, AddPluginOptions, AddRouteMiddlewareOptions, ExtendConfigOptions, ExtendRouteRulesOptions, ExtendViteConfigOptions, ExtendWebpackConfigOptions, ImportModuleOptions, LayerDirectories, LoadNuxtConfigOptions, LoadNuxtOptions, NuxtMajorVersion, ResolveModuleOptions, ResolvePathOptions, Resolver };

package/dist/index.d.ts

@@ -1,15 +1,14 @@
-import * as _nuxt_schema from '@nuxt/schema';
-import { ModuleOptions, ModuleDefinition, NuxtModule, NuxtConfig, Nuxt, ModuleMeta, NuxtOptions, SchemaDefinition, NuxtAppConfig, NuxtCompatibility, NuxtCompatibilityIssues, Component, ComponentsDir, NuxtTemplate, NuxtMiddleware, NuxtHooks, NuxtPlugin, NuxtPluginTemplate, ResolvedNuxtTemplate, NuxtServerTemplate, NuxtTypeTemplate } from '@nuxt/schema';
+import { ModuleOptions, ModuleDefinition, NuxtModule, NuxtConfig, Nuxt, ModuleMeta, NuxtOptions, SchemaDefinition, NuxtAppConfig, NuxtCompatibility, NuxtCompatibilityIssues, Component, ComponentsDir, NuxtTemplate, NuxtMiddleware, NuxtHooks, NuxtPlugin, NuxtPluginTemplate, NuxtServerTemplate, ResolvedNuxtTemplate, NuxtTypeTemplate } from '@nuxt/schema';
 import { LoadConfigOptions } from 'c12';
 import { Import, InlinePreset } from 'unimport';
 import { WebpackPluginInstance, Configuration } from 'webpack';
 import { RspackPluginInstance } from '@rspack/core';
 import { Plugin, UserConfig } from 'vite';
-import * as unctx from 'unctx';
-import { NitroRouteConfig, NitroEventHandler, NitroDevEventHandler, Nitro } from 'nitropack';
+import { UseContext } from 'unctx';
+import * as NitroV2 from 'nitropack/types';
+import * as NitroV3 from 'nitro/types';
 import { GlobOptions } from 'tinyglobby';
-import * as consola from 'consola';
-import { ConsolaOptions } from 'consola';
+import { ConsolaInstance, ConsolaOptions } from 'consola';
 import { genSafeVariableName } from 'knitwork';
 
 /**
@@ -53,7 +52,7 @@ declare const normalizeModuleTranspilePath: (p: string) => string;
  */
 declare function hasNuxtModule(moduleName: string, nuxt?: Nuxt): boolean;
 /**
- * Checks if a Nuxt Module is compatible with a given semver version.
+ * Checks if a Nuxt module is compatible with a given semver version.
  */
 declare function hasNuxtModuleCompatibility(module: string | NuxtModule, semverVersion: string, nuxt?: Nuxt): Promise<boolean>;
 /**
@@ -116,7 +115,7 @@ interface LayerDirectories {
  * @param nuxt - The Nuxt instance to get layers from. Defaults to the current Nuxt context.
  * @returns Array of LayerDirectories objects, ordered by priority (user layer first)
  */
-declare function getLayerDirectories(nuxt?: _nuxt_schema.Nuxt): LayerDirectories[];
+declare function getLayerDirectories(nuxt?: Nuxt): LayerDirectories[];
 
 declare function setGlobalHead(head: NuxtAppConfig['head']): void;
 
@@ -137,6 +136,8 @@ declare function useRuntimeConfig(): Record<string, any>;
  */
 declare function updateRuntimeConfig(runtimeConfig: Record<string, unknown>): void | Promise<void>;
 
+type Arrayable<T> = T | T[];
+type Thenable<T> = T | Promise<T>;
 interface ExtendConfigOptions {
     /**
      * Install plugin on dev
@@ -183,40 +184,41 @@ interface ExtendViteConfigOptions extends Omit<ExtendConfigOptions, 'server' | '
      */
     client?: boolean;
 }
+type ExtendWebpacklikeConfig = (fn: (config: Configuration) => void, options?: ExtendWebpackConfigOptions) => void;
 /**
  * Extend webpack config
  *
  * The fallback function might be called multiple times
  * when applying to both client and server builds.
  */
-declare const extendWebpackConfig: (fn: ((config: Configuration) => void), options?: ExtendWebpackConfigOptions) => void;
+declare const extendWebpackConfig: ExtendWebpacklikeConfig;
 /**
  * Extend rspack config
  *
  * The fallback function might be called multiple times
  * when applying to both client and server builds.
  */
-declare const extendRspackConfig: (fn: ((config: Configuration) => void), options?: ExtendWebpackConfigOptions) => void;
+declare const extendRspackConfig: ExtendWebpacklikeConfig;
 /**
  * Extend Vite config
  */
-declare function extendViteConfig(fn: ((config: UserConfig) => void), options?: ExtendViteConfigOptions): (() => void) | undefined;
+declare function extendViteConfig(fn: ((config: UserConfig) => Thenable<void>), options?: ExtendViteConfigOptions): (() => void) | undefined;
 /**
  * Append webpack plugin to the config.
  */
-declare function addWebpackPlugin(pluginOrGetter: WebpackPluginInstance | WebpackPluginInstance[] | (() => WebpackPluginInstance | WebpackPluginInstance[]), options?: ExtendWebpackConfigOptions): void;
+declare function addWebpackPlugin(pluginOrGetter: Arrayable<WebpackPluginInstance> | (() => Thenable<Arrayable<WebpackPluginInstance>>), options?: ExtendWebpackConfigOptions): void;
 /**
  * Append rspack plugin to the config.
  */
-declare function addRspackPlugin(pluginOrGetter: RspackPluginInstance | RspackPluginInstance[] | (() => RspackPluginInstance | RspackPluginInstance[]), options?: ExtendWebpackConfigOptions): void;
+declare function addRspackPlugin(pluginOrGetter: Arrayable<RspackPluginInstance> | (() => Thenable<Arrayable<RspackPluginInstance>>), options?: ExtendWebpackConfigOptions): void;
 /**
  * Append Vite plugin to the config.
  */
-declare function addVitePlugin(pluginOrGetter: Plugin | Plugin[] | (() => Plugin | Plugin[]), options?: ExtendConfigOptions): void;
+declare function addVitePlugin(pluginOrGetter: Arrayable<Plugin> | (() => Thenable<Arrayable<Plugin>>), options?: ExtendConfigOptions): void;
 interface AddBuildPluginFactory {
-    vite?: () => Plugin | Plugin[];
-    webpack?: () => WebpackPluginInstance | WebpackPluginInstance[];
-    rspack?: () => RspackPluginInstance | RspackPluginInstance[];
+    vite?: () => Thenable<Arrayable<Plugin>>;
+    webpack?: () => Thenable<Arrayable<WebpackPluginInstance>>;
+    rspack?: () => Thenable<Arrayable<RspackPluginInstance>>;
 }
 declare function addBuildPlugin(pluginFactory: AddBuildPluginFactory, options?: ExtendConfigOptions): void;
 
@@ -233,10 +235,11 @@ declare function assertNuxtCompatibility(constraints: NuxtCompatibility, nuxt?:
  * Check version constraints and return true if passed, otherwise returns false
  */
 declare function hasNuxtCompatibility(constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<boolean>;
+type NuxtMajorVersion = 2 | 3 | 4;
 /**
  * Check if current Nuxt instance is of specified major version
  */
-declare function isNuxtMajorVersion(majorVersion: 2 | 3 | 4, nuxt?: Nuxt): boolean;
+declare function isNuxtMajorVersion(majorVersion: NuxtMajorVersion, nuxt?: Nuxt): boolean;
 /**
  * @deprecated Use `isNuxtMajorVersion(2, nuxt)` instead. This may be removed in \@nuxt/kit v5 or a future major version.
  */
@@ -279,7 +282,7 @@ declare function addComponent(opts: AddComponentOptions): void;
  * Direct access to the Nuxt global context - see https://github.com/unjs/unctx.
  * @deprecated Use `getNuxtCtx` instead
  */
-declare const nuxtCtx: unctx.UseContext<Nuxt>;
+declare const nuxtCtx: UseContext<Nuxt>;
 /** Direct access to the Nuxt context with asyncLocalStorage - see https://github.com/unjs/unctx. */
 declare const getNuxtCtx: () => Nuxt | null;
 /**
@@ -307,15 +310,22 @@ declare function useNuxt(): Nuxt;
 declare function tryUseNuxt(): Nuxt | null;
 declare function runWithNuxtContext<T extends (...args: any[]) => any>(nuxt: Nuxt, fn: T): ReturnType<T>;
 
-declare function createIsIgnored(nuxt?: _nuxt_schema.Nuxt | null): (pathname: string, stats?: unknown) => boolean;
+declare function createIsIgnored(nuxt?: Nuxt | null | undefined): (pathname: string, stats?: unknown) => boolean;
 /**
  * Return a filter function to filter an array of paths
  */
-declare function isIgnored(pathname: string, _stats?: unknown, nuxt?: _nuxt_schema.Nuxt | null): boolean;
+declare function isIgnored(pathname: string, _stats?: unknown, nuxt?: Nuxt | null | undefined): boolean;
 declare function resolveIgnorePatterns(relativePath?: string): string[];
 
 declare function addLayout(this: any, template: NuxtTemplate | string, name?: string): void;
 
+type isNitroV2 = 'options' extends keyof NitroV2.Nitro ? '___INVALID' extends keyof NitroV2.Nitro ? false : true : false;
+type isNitroV3 = 'options' extends keyof NitroV3.Nitro ? '___INVALID' extends keyof NitroV3.Nitro ? false : true : false;
+type Nitro = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.Nitro | NitroV3.Nitro : NitroV2.Nitro : NitroV3.Nitro;
+type NitroDevEventHandler = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroDevEventHandler | NitroV3.NitroDevEventHandler : NitroV2.NitroDevEventHandler : NitroV3.NitroDevEventHandler;
+type NitroEventHandler = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroEventHandler | NitroV3.NitroEventHandler : NitroV2.NitroEventHandler : NitroV3.NitroEventHandler;
+type NitroRouteConfig = isNitroV2 extends true ? isNitroV3 extends true ? NitroV2.NitroRouteConfig | NitroV3.NitroRouteConfig : NitroV2.NitroRouteConfig : NitroV3.NitroRouteConfig;
+
 declare function extendPages(cb: NuxtHooks['pages:extend']): void;
 interface ExtendRouteRulesOptions {
     /**
@@ -516,11 +526,11 @@ declare function normalizeTemplate<T>(template: NuxtTemplate<T> | string, buildD
  */
 declare function updateTemplates(options?: {
     filter?: (template: ResolvedNuxtTemplate<any>) => boolean;
-}): Promise<any>;
+}): Promise<void>;
 declare function writeTypes(nuxt: Nuxt): Promise<void>;
 
-declare const logger: consola.ConsolaInstance;
-declare function useLogger(tag?: string, options?: Partial<ConsolaOptions>): consola.ConsolaInstance;
+declare const logger: ConsolaInstance;
+declare function useLogger(tag?: string, options?: Partial<ConsolaOptions>): ConsolaInstance;
 
 interface ResolveModuleOptions {
     /** @deprecated use `url` with URLs pointing at a file - never a directory */
@@ -567,4 +577,4 @@ declare const templateUtils: {
 };
 
 export { addBuildPlugin, addComponent, addComponentExports, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addRspackPlugin, addServerHandler, addServerImports, addServerImportsDir, addServerPlugin, addServerScanDir, addServerTemplate, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createIsIgnored, createResolver, defineNuxtModule, directoryToURL, extendNuxtSchema, extendPages, extendRouteRules, extendRspackConfig, extendViteConfig, extendWebpackConfig, findPath, getDirectory, getLayerDirectories, getNuxtCtx, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule, installModule, installModules, isIgnored, isNuxt2, isNuxt3, isNuxtMajorVersion, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveModuleWithOptions, resolveNuxtModule, resolvePath, runWithNuxtContext, setGlobalHead, templateUtils, tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateRuntimeConfig, updateTemplates, useLogger, useNitro, useNuxt, useRuntimeConfig, writeTypes };
-export type { AddComponentOptions, AddPluginOptions, AddRouteMiddlewareOptions, ExtendConfigOptions, ExtendRouteRulesOptions, ExtendViteConfigOptions, ExtendWebpackConfigOptions, ImportModuleOptions, LayerDirectories, LoadNuxtConfigOptions, LoadNuxtOptions, ResolveModuleOptions, ResolvePathOptions, Resolver };
+export type { AddComponentOptions, AddPluginOptions, AddRouteMiddlewareOptions, ExtendConfigOptions, ExtendRouteRulesOptions, ExtendViteConfigOptions, ExtendWebpackConfigOptions, ImportModuleOptions, LayerDirectories, LoadNuxtConfigOptions, LoadNuxtOptions, NuxtMajorVersion, ResolveModuleOptions, ResolvePathOptions, Resolver };

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { promises, existsSync, readFileSync, lstatSync } from 'node:fs';
 import { performance } from 'node:perf_hooks';
-import defu$1, { defu } from 'defu';
+import { defu } from 'defu';
 import { applyDefaults } from 'untyped';
 import { dirname, resolve, relative, join, normalize, isAbsolute, basename, parse } from 'pathe';
 import { consola } from 'consola';
@@ -13,7 +13,7 @@ import { fileURLToPath, pathToFileURL } from 'node:url';
 import { createJiti } from 'jiti';
 import { parseNodeModulePath, interopDefault, lookupNodeModuleSubpath, resolveModuleExportNames } from 'mlly';
 import { resolveModulePath, resolveModuleURL } from 'exsolve';
-import { isRelative, withTrailingSlash as withTrailingSlash$2 } from 'ufo';
+import { isRelative, withTrailingSlash as withTrailingSlash$2, withoutTrailingSlash } from 'ufo';
 import { read, update } from 'rc9';
 import semver, { gte } from 'semver';
 import { captureStackTrace } from 'errx';
@@ -2565,6 +2565,7 @@ function tryRequireModule(id, opts) {
 }
 
 const NODE_MODULES_RE = /[/\\]node_modules[/\\]/;
+const ignoredConfigKeys = /* @__PURE__ */ new Set(["components", "imports", "pages", "devtools", "telemetry"]);
 async function installModules(modulesToInstall, resolvedModulePaths, nuxt = useNuxt()) {
   const localLayerModuleDirs = [];
   for (const l of nuxt.options._layers) {
@@ -2575,8 +2576,23 @@ async function installModules(modulesToInstall, resolvedModulePaths, nuxt = useN
   }
   nuxt._moduleOptionsFunctions ||= /* @__PURE__ */ new Map();
   const resolvedModules = [];
+  const modulesByMetaName = /* @__PURE__ */ new Map();
   const inlineConfigKeys = new Set(
-    await Promise.all([...modulesToInstall].map(([mod]) => typeof mod !== "string" && Promise.resolve(mod.getMeta?.())?.then((r) => r?.configKey)))
+    await Promise.all([...modulesToInstall].map(async ([mod]) => {
+      if (typeof mod === "string") {
+        return;
+      }
+      const meta = await Promise.resolve(mod.getMeta?.());
+      if (meta?.name) {
+        modulesByMetaName.set(meta.name, mod);
+      }
+      if (meta?.configKey) {
+        if (meta.configKey !== meta.name) {
+          modulesByMetaName.set(meta.configKey, mod);
+        }
+        return meta.configKey;
+      }
+    }))
   );
   let error;
   const dependencyMap = /* @__PURE__ */ new Map();
@@ -2587,12 +2603,12 @@ async function installModules(modulesToInstall, resolvedModulePaths, nuxt = useN
       }
       throw err;
     });
-    const dependencyMeta = res.nuxtModule.getModuleDependencies?.(nuxt) || {};
+    const dependencyMeta = await res.nuxtModule.getModuleDependencies?.(nuxt) || {};
     for (const [name, value] of Object.entries(dependencyMeta)) {
       if (!value.overrides && !value.defaults && !value.version && value.optional) {
         continue;
       }
-      const resolvedModule = resolveModuleWithOptions(name, nuxt);
+      const resolvedModule = modulesByMetaName.has(name) ? resolveModuleWithOptions(modulesByMetaName.get(name), nuxt) : resolveModuleWithOptions(name, nuxt);
       const moduleToAttribute = typeof key === "string" ? `\`${key}\`` : "a module in `nuxt.options`";
       if (!resolvedModule?.module) {
         const message = `Could not resolve \`${name}\` (specified as a dependency of ${moduleToAttribute}).`;
@@ -2602,7 +2618,7 @@ async function installModules(modulesToInstall, resolvedModulePaths, nuxt = useN
       if (value.version) {
         const resolvePaths = [res.resolvedModulePath, ...nuxt.options.modulesDir].filter(Boolean);
         const pkg = await readPackageJSON(name, { from: resolvePaths }).catch(() => null);
-        if (pkg?.version && !semver.satisfies(pkg.version, value.version)) {
+        if (pkg?.version && !semver.satisfies(pkg.version, value.version, { includePrerelease: true })) {
           const message = `Module \`${name}\` version (\`${pkg.version}\`) does not satisfy \`${value.version}\` (requested by ${moduleToAttribute}).`;
           error = new TypeError(message);
         }
@@ -2642,8 +2658,8 @@ async function installModules(modulesToInstall, resolvedModulePaths, nuxt = useN
   if (error) {
     throw error;
   }
-  for (const { nuxtModule, meta, moduleToInstall, buildTimeModuleMeta, resolvedModulePath, inlineOptions } of resolvedModules) {
-    const configKey = meta?.configKey;
+  for (const { nuxtModule, meta = {}, moduleToInstall, buildTimeModuleMeta, resolvedModulePath, inlineOptions: inlineOptions2 } of resolvedModules) {
+    const configKey = meta.configKey;
     const optionsFns = [
       ...nuxt._moduleOptionsFunctions.get(moduleToInstall) || [],
       ...meta?.name ? nuxt._moduleOptionsFunctions.get(meta.name) || [] : [],
@@ -2662,12 +2678,21 @@ async function installModules(modulesToInstall, resolvedModulePaths, nuxt = useN
         nuxt.options[configKey] = defu(...overrides, nuxt.options[configKey], ...defaults);
       }
     }
-    await callLifecycleHooks(nuxtModule, meta, inlineOptions, nuxt);
-    await callModule(nuxtModule, meta, inlineOptions, resolvedModulePath, moduleToInstall, localLayerModuleDirs, buildTimeModuleMeta, nuxt);
+    const isDisabled = configKey && !ignoredConfigKeys.has(configKey) && nuxt.options[configKey] === false;
+    if (!isDisabled) {
+      await callLifecycleHooks(nuxtModule, meta, inlineOptions2, nuxt);
+    }
+    const path = typeof moduleToInstall === "string" ? moduleToInstall : void 0;
+    await callModule(nuxt, nuxtModule, inlineOptions2, {
+      meta: defu({ disabled: isDisabled }, meta, buildTimeModuleMeta),
+      nameOrPath: path,
+      modulePath: resolvedModulePath || path,
+      localLayerModuleDirs
+    });
   }
   delete nuxt._moduleOptionsFunctions;
 }
-async function installModule(moduleToInstall, inlineOptions, nuxt = useNuxt()) {
+async function installModule(moduleToInstall, inlineOptions2, nuxt = useNuxt()) {
   const { nuxtModule, buildTimeModuleMeta, resolvedModulePath } = await loadNuxtModuleInstance(moduleToInstall, nuxt);
   const localLayerModuleDirs = [];
   for (const dirs of getLayerDirectories(nuxt)) {
@@ -2676,7 +2701,7 @@ async function installModule(moduleToInstall, inlineOptions, nuxt = useNuxt()) {
     }
   }
   const meta = await nuxtModule.getMeta?.();
-  let mergedOptions = inlineOptions;
+  let mergedOptions = inlineOptions2;
   const configKey = meta?.configKey;
   if (configKey && nuxt._moduleOptionsFunctions) {
     const optionsFns = [
@@ -2691,12 +2716,21 @@ async function installModule(moduleToInstall, inlineOptions, nuxt = useNuxt()) {
         overrides.push(options.overrides);
         defaults.push(options.defaults);
       }
-      mergedOptions = defu(inlineOptions, ...overrides, nuxt.options[configKey], ...defaults);
+      mergedOptions = defu(inlineOptions2, ...overrides, nuxt.options[configKey], ...defaults);
       nuxt.options[configKey] = mergedOptions;
     }
   }
-  await callLifecycleHooks(nuxtModule, meta, mergedOptions, nuxt);
-  await callModule(nuxtModule, meta, mergedOptions, resolvedModulePath, moduleToInstall, localLayerModuleDirs, buildTimeModuleMeta, nuxt);
+  const isDisabled = configKey && !ignoredConfigKeys.has(configKey) && nuxt.options[configKey] === false;
+  if (!isDisabled) {
+    await callLifecycleHooks(nuxtModule, meta, mergedOptions, nuxt);
+  }
+  const path = typeof moduleToInstall === "string" ? moduleToInstall : void 0;
+  await callModule(nuxt, nuxtModule, mergedOptions, {
+    meta: defu({ disabled: isDisabled }, meta, buildTimeModuleMeta),
+    nameOrPath: path,
+    modulePath: resolvedModulePath || path,
+    localLayerModuleDirs
+  });
 }
 function resolveModuleWithOptions(definition, nuxt) {
   const [module, options = {}] = Array.isArray(definition) ? definition : [definition, {}];
@@ -2779,7 +2813,7 @@ const normalizeModuleTranspilePath = (p) => {
   return getDirectory(p).split("node_modules/").pop();
 };
 const MissingModuleMatcher = /Cannot find module\s+['"]?([^'")\s]+)['"]?/i;
-async function callLifecycleHooks(nuxtModule, meta = {}, inlineOptions, nuxt = useNuxt()) {
+async function callLifecycleHooks(nuxtModule, meta = {}, inlineOptions2, nuxt = useNuxt()) {
   if (!meta.name || !meta.version) {
     return;
   }
@@ -2792,7 +2826,7 @@ async function callLifecycleHooks(nuxtModule, meta = {}, inlineOptions, nuxt = u
     if (!previousVersion) {
       await nuxtModule.onInstall?.(nuxt);
     } else if (semver.gt(meta.version, previousVersion)) {
-      await nuxtModule.onUpgrade?.(inlineOptions, nuxt, previousVersion);
+      await nuxtModule.onUpgrade?.(nuxt, inlineOptions2, previousVersion);
     }
     if (previousVersion !== meta.version) {
       update(
@@ -2806,12 +2840,12 @@ async function callLifecycleHooks(nuxtModule, meta = {}, inlineOptions, nuxt = u
     );
   }
 }
-async function callModule(nuxtModule, meta = {}, inlineOptions, resolvedModulePath, moduleToInstall, localLayerModuleDirs, buildTimeModuleMeta, nuxt = useNuxt()) {
-  const res = (isNuxtMajorVersion(2, nuxt) ? await nuxtModule.call(nuxt.moduleContainer, inlineOptions, nuxt) : nuxt.options.experimental?.debugModuleMutation && nuxt._asyncLocalStorageModule ? await nuxt._asyncLocalStorageModule.run(nuxtModule, () => nuxtModule(inlineOptions || {}, nuxt)) : await nuxtModule(inlineOptions || {}, nuxt)) ?? {};
-  if (res === false) {
-    return;
-  }
-  const modulePath = resolvedModulePath || moduleToInstall;
+async function callModule(nuxt, nuxtModule, moduleOptions = {}, options) {
+  const modulePath = options.modulePath;
+  const nameOrPath = options.nameOrPath;
+  const localLayerModuleDirs = options.localLayerModuleDirs;
+  const fn = () => isNuxtMajorVersion(2, nuxt) ? nuxtModule.call(nuxt.moduleContainer, inlineOptions, nuxt) : nuxt.options.experimental?.debugModuleMutation && nuxt._asyncLocalStorageModule ? nuxt._asyncLocalStorageModule.run(nuxtModule, () => nuxtModule(moduleOptions, nuxt)) : nuxtModule(moduleOptions, nuxt);
+  const res = options.meta.disabled ? false : await fn();
   let entryPath;
   if (typeof modulePath === "string") {
     const parsed = parseNodeModulePath(modulePath);
@@ -2819,22 +2853,26 @@ async function callModule(nuxtModule, meta = {}, inlineOptions, resolvedModulePa
       const subpath = await lookupNodeModuleSubpath(modulePath) || ".";
       entryPath = join(parsed.name, subpath === "./" ? "." : subpath);
     }
-    const moduleRoot = parsed.dir ? parsed.dir + parsed.name : await resolvePackageJSON(modulePath, { try: true }).then((r) => r ? dirname(r) : modulePath);
-    nuxt.options.build.transpile.push(normalizeModuleTranspilePath(moduleRoot));
-    const directory = moduleRoot.replace(/\/?$/, "/");
-    if (moduleRoot !== moduleToInstall && !localLayerModuleDirs.some((dir) => directory.startsWith(dir))) {
-      nuxt.options.modulesDir.push(join(moduleRoot, "node_modules"));
+    if (res !== false) {
+      const moduleRoot = parsed.dir ? parsed.dir + parsed.name : await resolvePackageJSON(modulePath, { try: true }).then((r) => r ? dirname(r) : modulePath);
+      nuxt.options.build.transpile.push(normalizeModuleTranspilePath(moduleRoot));
+      const directory = moduleRoot.replace(/\/?$/, "/");
+      if (moduleRoot !== nameOrPath && !localLayerModuleDirs.some((dir) => directory.startsWith(dir))) {
+        nuxt.options.modulesDir.push(join(moduleRoot, "node_modules"));
+      }
     }
   }
-  nuxt.options._installedModules ||= [];
-  entryPath ||= typeof moduleToInstall === "string" ? resolveAlias(moduleToInstall, nuxt.options.alias) : void 0;
-  if (typeof moduleToInstall === "string" && entryPath !== moduleToInstall) {
-    buildTimeModuleMeta.rawPath = moduleToInstall;
+  if (nameOrPath) {
+    entryPath ||= resolveAlias(nameOrPath, nuxt.options.alias);
+    if (entryPath !== nameOrPath) {
+      options.meta.rawPath = nameOrPath;
+    }
   }
+  nuxt.options._installedModules ||= [];
   nuxt.options._installedModules.push({
-    meta: defu(meta, buildTimeModuleMeta),
+    meta: options.meta,
     module: nuxtModule,
-    timings: res.timings,
+    timings: (res || {}).timings,
     entryPath
   });
 }
@@ -2885,8 +2923,8 @@ async function loadNuxtConfig(opts) {
   const localLayers = (await glob("layers/*", {
     onlyDirectories: true,
     cwd: opts.cwd || process.cwd()
-  })).map((d) => d.endsWith("/") ? d.substring(0, d.length - 1) : d).sort((a, b) => b.localeCompare(a));
-  opts.overrides = defu$1(opts.overrides, { _extends: localLayers });
+  })).map((d) => withTrailingSlash$2(d)).sort((a, b) => b.localeCompare(a));
+  opts.overrides = defu(opts.overrides, { _extends: localLayers });
   const { configFile, layers = [], cwd, config: nuxtConfig, meta } = await withDefineNuxtConfig(
     () => loadConfig({
       name: "nuxt",
@@ -2921,7 +2959,7 @@ async function loadNuxtConfig(opts) {
   }
   const _layers = [];
   const processedLayers = /* @__PURE__ */ new Set();
-  const localRelativePaths = new Set(localLayers);
+  const localRelativePaths = new Set(localLayers.map((layer) => withoutTrailingSlash(layer)));
   for (const layer of layers) {
     const resolvedRootDir = layer.config?.rootDir ?? layer.cwd;
     layer.config = {
@@ -3075,7 +3113,7 @@ const HANDLER_METHOD_RE = /\.(get|head|patch|post|put|delete|connect|options|tra
 function normalizeHandlerMethod(handler) {
   const [, method = void 0] = handler.handler.match(HANDLER_METHOD_RE) || [];
   return {
-    method,
+    method: method?.toUpperCase(),
     ...handler,
     handler: normalize(handler.handler)
   };
@@ -3148,7 +3186,7 @@ function useRuntimeConfig() {
 }
 function updateRuntimeConfig(runtimeConfig) {
   const nuxt = useNuxt();
-  Object.assign(nuxt.options.nitro.runtimeConfig, defu$1(runtimeConfig, nuxt.options.nitro.runtimeConfig));
+  Object.assign(nuxt.options.nitro.runtimeConfig, defu(runtimeConfig, nuxt.options.nitro.runtimeConfig));
   try {
     return useNitro().updateConfig({ runtimeConfig });
   } catch {
@@ -3200,17 +3238,17 @@ const extendWebpackCompatibleConfig = (builder) => (fn, options = {}) => {
   if (options.build === false && nuxt.options.build) {
     return;
   }
-  nuxt.hook(`${builder}:config`, (configs) => {
+  nuxt.hook(`${builder}:config`, async (configs) => {
     if (options.server !== false) {
       const config = configs.find((i) => i.name === "server");
       if (config) {
-        fn(config);
+        await fn(config);
       }
     }
     if (options.client !== false) {
       const config = configs.find((i) => i.name === "client");
       if (config) {
-        fn(config);
+        await fn(config);
       }
     }
   });
@@ -3234,17 +3272,17 @@ function extendViteConfig(fn, options = {}) {
   return nuxt.hook("vite:extend", ({ config }) => fn(config));
 }
 function addWebpackPlugin(pluginOrGetter, options) {
-  extendWebpackConfig((config) => {
+  extendWebpackConfig(async (config) => {
     const method = options?.prepend ? "unshift" : "push";
-    const plugin = typeof pluginOrGetter === "function" ? pluginOrGetter() : pluginOrGetter;
+    const plugin = typeof pluginOrGetter === "function" ? await pluginOrGetter() : pluginOrGetter;
     config.plugins ||= [];
     config.plugins[method](...toArray(plugin));
   }, options);
 }
 function addRspackPlugin(pluginOrGetter, options) {
-  extendRspackConfig((config) => {
+  extendRspackConfig(async (config) => {
     const method = options?.prepend ? "unshift" : "push";
-    const plugin = typeof pluginOrGetter === "function" ? pluginOrGetter() : pluginOrGetter;
+    const plugin = typeof pluginOrGetter === "function" ? await pluginOrGetter() : pluginOrGetter;
     config.plugins ||= [];
     config.plugins[method](...toArray(plugin));
   }, options);
@@ -3258,9 +3296,9 @@ function addVitePlugin(pluginOrGetter, options = {}) {
     return;
   }
   let needsEnvInjection = false;
-  nuxt.hook("vite:extend", ({ config }) => {
+  nuxt.hook("vite:extend", async ({ config }) => {
     config.plugins ||= [];
-    const plugin = toArray(typeof pluginOrGetter === "function" ? pluginOrGetter() : pluginOrGetter);
+    const plugin = toArray(typeof pluginOrGetter === "function" ? await pluginOrGetter() : pluginOrGetter);
     if (options.server !== false && options.client !== false) {
       const method = options?.prepend ? "unshift" : "push";
       config.plugins[method](...plugin);
@@ -3282,11 +3320,11 @@ function addVitePlugin(pluginOrGetter, options = {}) {
       }
     });
   });
-  nuxt.hook("vite:extendConfig", (config, env) => {
+  nuxt.hook("vite:extendConfig", async (config, env) => {
     if (!needsEnvInjection) {
       return;
     }
-    const plugin = toArray(typeof pluginOrGetter === "function" ? pluginOrGetter() : pluginOrGetter);
+    const plugin = toArray(typeof pluginOrGetter === "function" ? await pluginOrGetter() : pluginOrGetter);
     const method = options?.prepend ? "unshift" : "push";
     if (env.isClient && options.server === false) {
       config.plugins[method](...plugin);
@@ -3350,7 +3388,7 @@ function addComponents(addedComponents) {
         const existingPriority = existingComponent.priority ?? 0;
         const newPriority = component.priority ?? 0;
         if (newPriority < existingPriority) {
-          return;
+          continue;
         }
         if (newPriority === existingPriority) {
           const name = existingComponent.pascalName || existingComponent.kebabName;
@@ -3539,6 +3577,7 @@ async function _generateTypes(nuxt) {
       moduleDetection: "force",
       isolatedModules: true,
       verbatimModuleSyntax: true,
+      allowArbitraryExtensions: true,
       /* Strictness */
       strict: nuxt.options.typescript?.strict ?? true,
       noUncheckedIndexedAccess: isV4,
@@ -3652,12 +3691,7 @@ async function _generateTypes(nuxt) {
   tsConfig.include = [...new Set(tsConfig.include.map((p) => isAbsolute(p) ? relativeWithDot(nuxt.options.buildDir, p) : p))];
   tsConfig.exclude = [...new Set(tsConfig.exclude.map((p) => isAbsolute(p) ? relativeWithDot(nuxt.options.buildDir, p) : p))];
   const declaration = [
-    ...references.map((ref) => {
-      if ("path" in ref && isAbsolute(ref.path)) {
-        ref.path = relative(nuxt.options.buildDir, ref.path);
-      }
-      return `/// <reference ${renderAttrs(ref)} />`;
-    }),
+    ...references.map((ref) => renderReference(ref, nuxt.options.buildDir)),
     ...declarations,
     "",
     "export {}",
@@ -3689,15 +3723,9 @@ function sortTsPaths(paths) {
     }
   }
 }
-function renderAttrs(obj) {
-  const attrs = [];
-  for (const key in obj) {
-    attrs.push(renderAttr(key, obj[key]));
-  }
-  return attrs.join(" ");
-}
-function renderAttr(key, value) {
-  return value ? `${key}="${value}"` : "";
+function renderReference(ref, baseDir) {
+  const stuff = "path" in ref ? `path="${isAbsolute(ref.path) ? relative(baseDir, ref.path) : ref.path}"` : `types="${ref.types}"`;
+  return `/// <reference ${stuff} />`;
 }
 const RELATIVE_WITH_DOT_RE = /^([^.])/;
 function relativeWithDot(from, to) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/kit",
-  "version": "3.20.2",
+  "version": "3.21.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuxt/nuxt.git",
@@ -23,7 +23,7 @@
     "dist"
   ],
   "dependencies": {
-    "c12": "^3.3.2",
+    "c12": "^3.3.3",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
     "destr": "^2.0.5",
@@ -37,32 +37,34 @@
     "ohash": "^2.0.11",
     "pathe": "^2.0.3",
     "pkg-types": "^2.3.0",
-    "rc9": "^2.1.2",
+    "rc9": "^3.0.0",
     "scule": "^1.3.0",
-    "semver": "^7.7.3",
+    "semver": "^7.7.4",
     "tinyglobby": "^0.2.15",
-    "ufo": "^1.6.1",
-    "unctx": "^2.4.1",
+    "ufo": "^1.6.3",
+    "unctx": "^2.5.0",
     "untyped": "^2.0.0"
   },
   "devDependencies": {
-    "@rspack/core": "1.6.7",
+    "@rspack/core": "1.7.5",
     "@types/lodash-es": "4.17.12",
     "@types/semver": "7.7.1",
     "hookable": "5.5.3",
-    "lodash-es": "4.17.21",
-    "nitropack": "2.12.9",
+    "lodash-es": "4.17.23",
+    "nitro": "3.0.1-alpha.2",
+    "nitropack": "2.13.1",
     "unbuild": "3.6.1",
-    "unimport": "5.5.0",
-    "vite": "7.2.7",
-    "vitest": "3.2.4",
-    "webpack": "5.103.0",
-    "@nuxt/schema": "3.20.2"
+    "unimport": "5.6.0",
+    "vite": "7.3.1",
+    "vitest": "4.0.18",
+    "webpack": "5.105.0",
+    "@nuxt/schema": "3.21.1"
   },
   "engines": {
     "node": ">=18.12.0"
   },
   "scripts": {
+    "build:stub": "unbuild --stub",
     "test:attw": "attw --pack"
   }
 }