@nuxt/kit 3.20.2 → 3.21.0

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)

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 { 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 { 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) {
@@ -2587,7 +2588,7 @@ 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;
@@ -2642,8 +2643,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 +2663,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 +2686,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 +2701,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 +2798,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 +2811,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 +2825,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 +2838,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 +2908,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 +2944,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 +3098,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 +3171,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 +3223,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 +3257,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 +3281,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 +3305,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 +3373,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 +3562,7 @@ async function _generateTypes(nuxt) {
       moduleDetection: "force",
       isolatedModules: true,
       verbatimModuleSyntax: true,
+      allowArbitraryExtensions: true,
       /* Strictness */
       strict: nuxt.options.typescript?.strict ?? true,
       noUncheckedIndexedAccess: isV4,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nuxt/kit",
-  "version": "3.20.2",
+  "version": "3.21.0",
   "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",
@@ -41,28 +41,30 @@
     "scule": "^1.3.0",
     "semver": "^7.7.3",
     "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.2",
     "@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.22",
+    "nitro": "3.0.1-alpha.1",
+    "nitropack": "2.13.1",
     "unbuild": "3.6.1",
-    "unimport": "5.5.0",
-    "vite": "7.2.7",
+    "unimport": "5.6.0",
+    "vite": "7.3.1",
     "vitest": "3.2.4",
-    "webpack": "5.103.0",
-    "@nuxt/schema": "3.20.2"
+    "webpack": "5.104.1",
+    "@nuxt/schema": "3.21.0"
   },
   "engines": {
     "node": ">=18.12.0"
   },
   "scripts": {
+    "build:stub": "unbuild --stub",
     "test:attw": "attw --pack"
   }
 }