@nuxt/kit-nightly 4.5.1-29752449.30d24817 → 4.5.2-2610052030-052d82e

package/dist/index.d.mts

@@ -1,48 +1,16 @@
-import { ConsolaInstance, ConsolaOptions } from "consola";
-import { UseContext } from "unctx";
-import { GlobOptions } from "tinyglobby";
-import { LoadConfigOptions } from "c12";
-import { Component, ComponentsDir, ModuleDefinition, ModuleMeta, ModuleOptions, Nuxt, NuxtAppConfig, NuxtBuildOutputs, NuxtCompatibility, NuxtCompatibilityIssues, NuxtConfig, NuxtHooks, NuxtMiddleware, NuxtModule, NuxtOptions, NuxtPlugin, NuxtPluginTemplate, NuxtServerTemplate, NuxtTemplate, NuxtTypeTemplate, ResolvedNuxtTemplate, SchemaDefinition } from "@nuxt/schema";
-import { Import, Preset } from "unimport";
-import { Configuration, WebpackPluginInstance } from "webpack";
-import { Plugin, UserConfig } from "vite";
-import { Nitro, NitroDevEventHandler, NitroEventHandler, NitroRouteConfig } from "nitropack/types";
-
+import { a as addServerHandler, b as resolveModuleWithOptions, c as addServerPlugin, f as resolveServerVariant, g as installModule, h as getDirectory, i as addPrerenderRoutes, l as addServerScanDir, m as useNitro, n as addDevServerHandler, o as addServerImports, p as tryUseNitro, r as addNitroPlugin, s as addServerImportsDir, t as ServerImportInput, v as loadNuxtModuleInstance, y as normalizeModuleTranspilePath } from "./nitro-C_Sq_oVQ.mjs";
+import "exsolve";
+import { Component, ComponentsDir, ModuleDefinition, ModuleOptions, NitroInstance, NitroInstanceOptions, Nuxt, NuxtAppConfig, NuxtBuildOutputs, NuxtCompatibility, NuxtCompatibilityIssues, NuxtConfig, NuxtConfigLayer, NuxtConfigLayerMeta, NuxtDotenvOptions, NuxtHooks, NuxtImport, NuxtImportPresetSource, NuxtMiddleware, NuxtModule, NuxtOptions, NuxtPlugin, NuxtPluginTemplate, NuxtServerTemplate, NuxtTemplate, NuxtTypeTemplate, ResolvedNuxtTemplate, SchemaDefinition, ViteConfig, VitePlugin, WebpackConfig, WebpackPluginInstance } from "@nuxt/schema";
 //#region src/module/define.d.ts
 /**
  * Define a Nuxt module, automatically merging defaults with user provided options, installing
  * any hooks that are provided, and calling an optional setup function for full control.
  */
-declare function defineNuxtModule<TOptions extends ModuleOptions>(definition: ModuleDefinition<TOptions, Partial<TOptions>, false> | NuxtModule<TOptions, Partial<TOptions>, false>): NuxtModule<TOptions, TOptions, false>;
-declare function defineNuxtModule<TOptions extends ModuleOptions>(): {
+export declare function defineNuxtModule<TOptions extends ModuleOptions>(definition: ModuleDefinition<TOptions, Partial<TOptions>, false> | NuxtModule<TOptions, Partial<TOptions>, false>): NuxtModule<TOptions, TOptions, false>;
+export declare function defineNuxtModule<TOptions extends ModuleOptions>(): {
   with: <TOptionsDefaults extends Partial<TOptions>>(definition: ModuleDefinition<TOptions, TOptionsDefaults, true> | NuxtModule<TOptions, TOptionsDefaults, true>) => NuxtModule<TOptions, TOptionsDefaults, true>;
 };
 //#endregion
-//#region src/module/install.d.ts
-type ModuleToInstall = string | NuxtModule<ModuleOptions, Partial<ModuleOptions>, false>;
-/**
- * Installs a set of modules on a Nuxt instance.
- * @internal
- */
-declare function installModules(modulesToInstall: Map<ModuleToInstall, Record<string, any>>, resolvedModulePaths: Set<string>, nuxt?: Nuxt): Promise<void>;
-/**
- * Installs a module on a Nuxt instance.
- * @deprecated Use module dependencies.
- */
-declare function installModule<T extends string | NuxtModule, Config extends Extract<NonNullable<NuxtConfig['modules']>[number], [T, any]>>(moduleToInstall: T, inlineOptions?: [Config] extends [never] ? any : Config[1], nuxt?: Nuxt): Promise<void>;
-declare function resolveModuleWithOptions(definition: NuxtModule<any> | string | false | undefined | null | [(NuxtModule | string)?, Record<string, any>?], nuxt: Nuxt): {
-  resolvedPath?: string;
-  module: string | NuxtModule<any>;
-  options: Record<string, any>;
-} | undefined;
-declare function loadNuxtModuleInstance(nuxtModule: string | NuxtModule, nuxt?: Nuxt): Promise<{
-  nuxtModule: NuxtModule<any>;
-  buildTimeModuleMeta: ModuleMeta;
-  resolvedModulePath?: string;
-}>;
-declare function getDirectory(p: string): string;
-declare const normalizeModuleTranspilePath: (p: string) => string;
-//#endregion
 //#region src/module/compatibility.d.ts
 /**
  * Check if a Nuxt module is installed by name.
@@ -50,26 +18,150 @@ declare const normalizeModuleTranspilePath: (p: string) => string;
  * This will check both the installed modules and the modules to be installed. Note
  * that it cannot detect if a module is _going to be_ installed programmatically by another module.
  */
-declare function hasNuxtModule(moduleName: string, nuxt?: Nuxt): boolean;
+export declare function hasNuxtModule(moduleName: string, nuxt?: Nuxt): boolean;
 /**
  * Checks if a Nuxt module is compatible with a given semver version.
  */
-declare function hasNuxtModuleCompatibility(module: string | NuxtModule, semverVersion: string, nuxt?: Nuxt): Promise<boolean>;
+export declare function hasNuxtModuleCompatibility(module: string | NuxtModule, semverVersion: string, nuxt?: Nuxt): Promise<boolean>;
 /**
  * Get the version of a Nuxt module.
  *
  * Scans installed modules for the version, if it's not found it will attempt to load the module instance and get the version from there.
  */
-declare function getNuxtModuleVersion(module: string | NuxtModule, nuxt?: Nuxt | any): Promise<string | false>;
+export declare function getNuxtModuleVersion(module: string | NuxtModule, nuxt?: Nuxt | any): Promise<string | false>;
 //#endregion
 //#region src/loader/config.d.ts
-interface LoadNuxtConfigOptions extends Omit<LoadConfigOptions<NuxtConfig>, 'overrides'> {
-  overrides?: Exclude<LoadConfigOptions<NuxtConfig>['overrides'], Promise<any> | Function>;
+/**
+ * Context handed to `onConfigResolved` after configuration has loaded successfully.
+ */
+interface ResolvedNuxtConfigContext {
+  /**
+   * User configuration merged across all layers, with no schema defaults applied and with
+   * `overrides`, `defaults` and `defaultConfig` from the load options excluded, so repeated
+   * loads of an unchanged project produce an unchanged snapshot. Two snapshots from separate
+   * `loadNuxtConfig` calls can be compared with `diffNuxtConfig`.
+   */
+  rawConfig: NuxtConfig;
+  /** Resolved config layers, highest priority first. */
+  layers: NuxtConfigLayer[];
+  /** Absolute path of the root `nuxt.config` file, if one was found. */
+  configFile?: string;
+  /** Directory the configuration was loaded from. */
+  cwd: string;
+}
+/** A layer produced by a custom {@link LoadNuxtConfigOptions.resolve} implementation. */
+interface ResolvedNuxtLayer {
+  /** The layer's configuration. Return an empty object to contribute nothing to the merge. */
+  config: NuxtConfig;
+  /** Absolute path of the directory the layer was loaded from. */
+  cwd?: string;
+  /** Absolute path of the layer's config file, if it has one. */
+  configFile?: string;
+  /** The `extends` entry this layer was resolved from. */
+  source?: string;
+  /** Metadata to attach to the layer. */
+  meta?: NuxtConfigLayerMeta;
+}
+/** Context passed to a custom {@link LoadNuxtConfigOptions.resolve} implementation. */
+interface NuxtLayerResolverContext {
+  /** Directory the layer source should be resolved relative to. */
+  cwd?: string;
+  /**
+   * The importer in use for the current load, if one has been established. Pass it to any
+   * nested load so a layer is not loaded through a second, differently configured importer.
+   */
+  import?: (id: string) => Promise<unknown>;
 }
-declare function loadNuxtConfig(opts: LoadNuxtConfigOptions): Promise<NuxtOptions>;
+interface LoadNuxtConfigOptions {
+  /** Directory to load `nuxt.config` from. @default process.cwd() */
+  cwd?: string;
+  /**
+   * Name of the config file to load, without an extension.
+   * @default 'nuxt.config'
+   */
+  configFile?: string;
+  /**
+   * Name of the `.rc` file to load alongside the config file, or `false` to load none.
+   * @default '.nuxtrc'
+   */
+  rcFile?: string | false;
+  /**
+   * Also load the user-level and workspace-level `.nuxtrc` files.
+   * @default true
+   */
+  globalRc?: boolean;
+  /**
+   * Configuration applied above every layer, including the root project's own `nuxt.config`.
+   * Excluded from the `rawConfig` snapshot passed to `onConfigResolved`.
+   */
+  overrides?: NuxtConfig;
+  /**
+   * Configuration applied below every layer, before schema defaults. Excluded from the
+   * `rawConfig` snapshot passed to `onConfigResolved`.
+   */
+  defaults?: NuxtConfig;
+  /**
+   * Load `.env` files into `process.env` before resolving configuration. Set to `false` when
+   * the environment has already been populated.
+   * @default true
+   */
+  dotenv?: boolean | NuxtDotenvOptions;
+  /**
+   * Environment name used to select `$env.*` configuration overrides. Takes precedence over
+   * `envName` set in `nuxt.config`.
+   */
+  envName?: string | false;
+  /**
+   * Resolve an `extends` entry to a layer yourself. Return a nullish value to fall back to the
+   * default resolution for that source.
+   */
+  resolve?: (source: string, context: NuxtLayerResolverContext) => ResolvedNuxtLayer | null | undefined | Promise<ResolvedNuxtLayer | null | undefined>;
+  /**
+   * Import config files with a custom loader rather than the default one. Supply this to load
+   * TypeScript config without Nuxt reaching for `jiti`.
+   */
+  import?: (id: string) => Promise<unknown>;
+  /**
+   * Called once, awaited, after configuration has loaded successfully. Callers watching config
+   * files themselves can keep the previous `rawConfig` and pass both snapshots to
+   * `diffNuxtConfig` to find out which keys changed. Not called if loading throws.
+   */
+  onConfigResolved?: (context: ResolvedNuxtConfigContext) => void | Promise<void>;
+}
+interface NuxtConfigDiffLocation {
+  /**
+   * Property path of the changed value, with array indices as numbers: `['modules']`,
+   * `['runtimeConfig', 'public', 'foo']`, `['modules', 0]`. Prefer this over {@link label} when
+   * reading the value back out of a config object.
+   */
+  path: Array<string | number>;
+  /**
+   * {@link path} written as a property accessor, for display and for matching against a known
+   * key: `ssr`, `runtimeConfig.public.foo`, `modules[0]`, `nitro.routeRules["/index.html"].ssr`.
+   */
+  label: string;
+}
+/** A single difference between two resolved Nuxt configurations. */
+type NuxtConfigDiffEntry = (NuxtConfigDiffLocation & {
+  type: 'added';
+  newValue: unknown;
+}) | (NuxtConfigDiffLocation & {
+  type: 'removed';
+  oldValue: unknown;
+}) | (NuxtConfigDiffLocation & {
+  type: 'changed';
+  newValue: unknown;
+  oldValue: unknown;
+});
+/**
+ * Compare two `rawConfig` snapshots (as provided to `onConfigResolved`) and return the
+ * differences between them.
+ */
+export declare function diffNuxtConfig(oldConfig: NuxtConfig, newConfig: NuxtConfig): NuxtConfigDiffEntry[];
+export declare function loadNuxtConfig(opts: LoadNuxtConfigOptions): Promise<NuxtOptions>;
 //#endregion
 //#region src/loader/schema.d.ts
-declare function extendNuxtSchema(def: SchemaDefinition | (() => SchemaDefinition)): void;
+export declare function extendNuxtSchema(def: SchemaDefinition | (() => SchemaDefinition)): void;
 //#endregion
 //#region src/loader/nuxt.d.ts
 interface LoadNuxtOptions extends LoadNuxtConfigOptions {
@@ -78,14 +170,14 @@ interface LoadNuxtOptions extends LoadNuxtConfigOptions {
   /** Use lazy initialization of nuxt if set to false */
   ready?: boolean;
 }
-declare function loadNuxt(opts: LoadNuxtOptions): Promise<Nuxt>;
-declare function buildNuxt(nuxt: Nuxt): Promise<any>;
+export declare function loadNuxt(opts: LoadNuxtOptions): Promise<Nuxt>;
+export declare function buildNuxt(nuxt: Nuxt): Promise<any>;
 //#endregion
 //#region src/layers.d.ts
 interface LayerDirectories {
   /** Nuxt rootDir (`/` by default) */
   readonly root: string;
-  /** Nitro source directory (`/server` by default) */
+  /** Server source directory (`/server` by default) */
   readonly server: string;
   /** Local modules directory (`/modules` by default) */
   readonly modules: string;
@@ -115,33 +207,24 @@ 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): LayerDirectories[];
-//#endregion
-//#region src/constants.d.ts
-/**
- * Default extensions for files that may contain JSX.
- * @internal
- */
-declare const DEFAULT_JSX_FILE_EXTENSIONS: string[];
-/** Default extensions for JavaScript/TypeScript files, in order of resolution priority. */
-declare const DEFAULT_JS_FILE_EXTENSIONS: string[];
+export declare function getLayerDirectories(nuxt?: Nuxt): LayerDirectories[];
 //#endregion
 //#region src/head.d.ts
-declare function setGlobalHead(head: NuxtAppConfig['head']): void;
+export declare function setGlobalHead(head: NuxtAppConfig['head']): void;
 //#endregion
 //#region src/imports.d.ts
-declare function addImports(imports: Import | Import[]): void;
-declare function addImportsDir(dirs: string | string[], opts?: {
+export declare function addImports(imports: NuxtImport | NuxtImport[]): void;
+export declare function addImportsDir(dirs: string | string[], opts?: {
   prepend?: boolean;
 }): void;
-declare function addImportsSources(presets: Preset | Preset[]): void;
+export declare function addImportsSources(presets: NuxtImportPresetSource | NuxtImportPresetSource[]): void;
 //#endregion
 //#region src/app-config.d.ts
 /**
  * Update Nuxt app configuration.
  * @since 4.5.0
  */
-declare function updateAppConfig(appConfig: Record<string, unknown>): void;
+export declare function updateAppConfig(appConfig: Record<string, unknown>): void;
 //#endregion
 //#region src/runtime-config.d.ts
 /**
@@ -149,11 +232,11 @@ declare function updateAppConfig(appConfig: Record<string, unknown>): void;
  *
  * This mirrors the runtime behavior of Nitro.
  */
-declare function useRuntimeConfig(): Record<string, any>;
+export declare function useRuntimeConfig(): Record<string, any>;
 /**
  * Update Nuxt runtime configuration.
  */
-declare function updateRuntimeConfig(runtimeConfig: Record<string, unknown>): void | Promise<void>;
+export declare function updateRuntimeConfig(runtimeConfig: Record<string, unknown>): void | Promise<void>;
 //#endregion
 //#region src/build.d.ts
 type Arrayable<T> = T | T[];
@@ -207,85 +290,98 @@ interface ExtendViteConfigOptions extends Omit<ExtendConfigOptions, 'server' | '
    */
   client?: boolean;
 }
-type ExtendWebpacklikeConfig = (fn: (config: Configuration) => void, options?: ExtendWebpackConfigOptions) => void;
+type ExtendWebpacklikeConfig = (fn: (config: WebpackConfig) => 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: ExtendWebpacklikeConfig;
+export 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: ExtendWebpacklikeConfig;
+export declare const extendRspackConfig: ExtendWebpacklikeConfig;
 /**
  * Extend Vite config
  */
-declare function extendViteConfig(fn: ((config: UserConfig) => Thenable<void>), options?: ExtendViteConfigOptions): (() => void) | undefined;
+export declare function extendViteConfig(fn: ((config: ViteConfig) => Thenable<void>), options?: ExtendViteConfigOptions): (() => void) | undefined;
 /**
  * Append webpack plugin to the config.
  */
-declare function addWebpackPlugin(pluginOrGetter: Arrayable<WebpackPluginInstance> | (() => Thenable<Arrayable<WebpackPluginInstance>>), options?: ExtendWebpackConfigOptions): void;
+export declare function addWebpackPlugin(pluginOrGetter: Arrayable<WebpackPluginInstance> | (() => Thenable<Arrayable<WebpackPluginInstance>>), options?: ExtendWebpackConfigOptions): void;
 /**
  * Append rspack plugin to the config.
  */
-declare function addRspackPlugin(pluginOrGetter: Arrayable<RspackCompatiblePluginInstance> | (() => Thenable<Arrayable<RspackCompatiblePluginInstance>>), options?: ExtendWebpackConfigOptions): void;
+export declare function addRspackPlugin(pluginOrGetter: Arrayable<RspackCompatiblePluginInstance> | (() => Thenable<Arrayable<RspackCompatiblePluginInstance>>), options?: ExtendWebpackConfigOptions): void;
 /**
  * Append Vite plugin to the config.
  */
-declare function addVitePlugin(pluginOrGetter: Arrayable<Plugin> | (() => Thenable<Arrayable<Plugin>>), options?: ExtendConfigOptions): void;
+export declare function addVitePlugin(pluginOrGetter: Arrayable<VitePlugin> | (() => Thenable<Arrayable<VitePlugin>>), options?: ExtendConfigOptions): void;
 interface AddBuildPluginFactory {
-  vite?: () => Thenable<Arrayable<Plugin>>;
+  vite?: () => Thenable<Arrayable<VitePlugin>>;
   webpack?: () => Thenable<Arrayable<WebpackPluginInstance>>;
   rspack?: () => Thenable<Arrayable<RspackCompatiblePluginInstance>>;
 }
-declare function addBuildPlugin(pluginFactory: AddBuildPluginFactory, options?: ExtendConfigOptions): void;
+export declare function addBuildPlugin(pluginFactory: AddBuildPluginFactory, options?: ExtendConfigOptions): void;
 /**
  * Set the build output for the given key. See {@link NuxtBuildOutputs}.
  */
-declare function setBuildOutput<K extends keyof NuxtBuildOutputs>(key: K, provider: NuxtBuildOutputs[K], nuxt?: Nuxt): void;
+export declare function setBuildOutput<K extends keyof NuxtBuildOutputs>(key: K, provider: NuxtBuildOutputs[K], nuxt?: Nuxt): void;
 //#endregion
 //#region src/compatibility.d.ts
-declare function normalizeSemanticVersion(version: string): string;
+export declare function normalizeSemanticVersion(version: string): string;
 /**
  * Check version constraints and return incompatibility issues as an array
  */
-declare function checkNuxtCompatibility(constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<NuxtCompatibilityIssues>;
+export declare function checkNuxtCompatibility(constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<NuxtCompatibilityIssues>;
 /**
  * Check version constraints and throw a detailed error if has any, otherwise returns true
  */
-declare function assertNuxtCompatibility(constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<true>;
+export declare function assertNuxtCompatibility(constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<true>;
 /**
  * Check version constraints and return true if passed, otherwise returns false
  */
-declare function hasNuxtCompatibility(constraints: NuxtCompatibility, nuxt?: Nuxt): Promise<boolean>;
+export 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: NuxtMajorVersion, nuxt?: Nuxt): boolean;
+export 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.
  */
-declare function isNuxt2(nuxt?: Nuxt): boolean;
+export declare function isNuxt2(nuxt?: Nuxt): boolean;
 /**
  * @deprecated Use `isNuxtMajorVersion(3, nuxt)` instead. This may be removed in \@nuxt/kit v5 or a future major version.
  */
-declare function isNuxt3(nuxt?: Nuxt): boolean;
+export declare function isNuxt3(nuxt?: Nuxt): boolean;
+/**
+ * Get the major version of nitro used by the current Nuxt instance.
+ *
+ * Resolution order:
+ *
+ * 1. `nuxt.options._nitroMajor`, stamped by the host before any module runs.
+ * 2. `nuxt._nitro.meta.majorVersion` from the initialized nitro instance.
+ * 3. Resolving the `nitro` / `nitropack` package from the project, which is correct on
+ *    older hosts where the package is a direct dependency.
+ *
+ * Returns `undefined` when no nitro version can be determined; it never throws.
+ */
+export declare function getNitroVersion(nuxt?: Nuxt): number | undefined;
 /**
  * Get nuxt version
  */
-declare function getNuxtVersion(nuxt?: Nuxt | any): string;
+export declare function getNuxtVersion(nuxt?: Nuxt | any): string;
 //#endregion
 //#region src/components.d.ts
 /**
  * Register a directory to be scanned for components and imported only when used.
  */
-declare function addComponentsDir(dir: ComponentsDir, opts?: {
+export declare function addComponentsDir(dir: ComponentsDir, opts?: {
   prepend?: boolean;
 }): void;
 type AddComponentOptions = {
@@ -295,22 +391,40 @@ type AddComponentOptions = {
 /**
  * This utility takes a file path or npm package that is scanned for named exports, which are get added automatically
  */
-declare function addComponentExports(opts: Omit<AddComponentOptions, 'name'> & {
+export declare function addComponentExports(opts: Omit<AddComponentOptions, 'name'> & {
   prefix?: string;
 }): void;
 /**
  * Register a component by its name and filePath.
  */
-declare function addComponent(opts: AddComponentOptions): void;
+export declare function addComponent(opts: AddComponentOptions): void;
 //#endregion
 //#region src/context.d.ts
 /**
- * Direct access to the Nuxt global context - see https://github.com/unjs/unctx.
+ * A handle to the global Nuxt instance context.
  * @deprecated Use `getNuxtCtx` instead
  */
-declare const nuxtCtx: UseContext<Nuxt>;
+interface NuxtContext {
+  /** Get the current Nuxt instance. Throws if none is set. */
+  use: () => Nuxt;
+  /** Get the current Nuxt instance, or `null` when none is set. */
+  tryUse: () => Nuxt | null;
+  /** Set the current Nuxt instance. */
+  set: (instance?: Nuxt, replace?: boolean) => void;
+  /** Clear the current Nuxt instance. */
+  unset: () => void;
+  /** Run a synchronous function with the provided Nuxt instance set. */
+  call: <R>(instance: Nuxt, callback: () => R) => R;
+  /** Run an asynchronous function with the provided Nuxt instance set. */
+  callAsync: <R>(instance: Nuxt, callback: () => R | Promise<R>) => Promise<R>;
+}
+/**
+ * Direct access to the Nuxt global context.
+ * @deprecated Use `getNuxtCtx` instead
+ */
+export declare const nuxtCtx: NuxtContext;
 /** Direct access to the Nuxt context with asyncLocalStorage - see https://github.com/unjs/unctx. */
-declare const getNuxtCtx: () => Nuxt | null;
+export declare const getNuxtCtx: () => Nuxt | null;
 /**
  * Get access to Nuxt instance.
  *
@@ -320,7 +434,7 @@ declare const getNuxtCtx: () => Nuxt | null;
  * const nuxt = useNuxt()
  * ```
  */
-declare function useNuxt(): Nuxt;
+export declare function useNuxt(): Nuxt;
 /**
  * Get access to Nuxt instance.
  *
@@ -333,22 +447,82 @@ declare function useNuxt(): Nuxt;
  * }
  * ```
  */
-declare function tryUseNuxt(): Nuxt | null;
-declare function runWithNuxtContext<T extends (...args: any[]) => any>(nuxt: Nuxt, fn: T): ReturnType<T>;
+export declare function tryUseNuxt(): Nuxt | null;
+export declare function runWithNuxtContext<T extends (...args: any[]) => any>(nuxt: Nuxt, fn: T): ReturnType<T>;
 //#endregion
 //#region src/ignore.d.ts
-declare function createIsIgnored(nuxt?: Nuxt | null | undefined): (pathname: string, stats?: unknown) => boolean;
+export 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 | null | undefined): boolean;
-declare function resolveIgnorePatterns(relativePath?: string): string[];
+export declare function isIgnored(pathname: string, _stats?: unknown, nuxt?: Nuxt | null | undefined): boolean;
+export declare function resolveIgnorePatterns(relativePath?: string): string[];
 //#endregion
 //#region src/layout.d.ts
-declare function addLayout(template: NuxtTemplate | string, name?: string): void;
+export declare function addLayout(template: NuxtTemplate | string, name?: string): void;
+//#endregion
+//#region src/nitro-types.d.ts
+/**
+ * Minimal structural types for the route rules accepted by this package, covering the nitro
+ * majors supported by Nuxt.
+ *
+ * These are inlined (rather than imported from `nitropack`/`nitro`) so that `@nuxt/kit` does not
+ * depend on either package being installed. Server registrations are typed by `@nuxt/schema`,
+ * which owns them, and normalised by the configured `server.builder`.
+ */
+/**
+ * Route rules common to both nitro majors.
+ *
+ * Route rules are augmentable upstream and these types are inlined, so the index signature is
+ * what lets a module set a rule neither nitro declares (`ssr`, `appMiddleware`, its own).
+ */
+interface NitroRouteConfigBase {
+  cache?: Record<string, any> | false;
+  headers?: Record<string, string>;
+  prerender?: boolean;
+  isr?: number | boolean | Record<string, any>;
+  swr?: boolean | number;
+  static?: boolean | number;
+  /** Additional route options, including framework-specific route rules. */
+  [key: string]: any;
+}
+/** Route rule shape accepted by nitro v2 (`nitropack`). */
+interface NitroRouteConfigV2 extends NitroRouteConfigBase {
+  /** A plain string defaults to status `302`. */
+  redirect?: string | {
+    to: string;
+    statusCode?: number;
+  };
+  proxy?: string | ({
+    to: string;
+  } & Record<string, any>);
+  cors?: boolean;
+}
+/** Route rule shape accepted by nitro v3 (`nitro`). */
+interface NitroRouteConfigV3 extends NitroRouteConfigBase {
+  /** A plain string defaults to status `307`. */
+  redirect?: string | {
+    to: string;
+    status?: number;
+  } | false;
+  /** `false` resets a rule inherited from a less specific pattern. */
+  proxy?: string | ({
+    to: string;
+  } & Record<string, any>) | false;
+  cors?: Record<string, any> | boolean;
+}
+/**
+ * A route rule accepted by either supported nitro major.
+ *
+ * A union rather than one merged shape, so that a rule written as an object literal has to match
+ * one major as a whole and excess property checking rejects a literal mixing the two. Anything
+ * valid in either is accepted, since the host's nitro major is not visible here; name
+ * {@link NitroRouteConfigV2} or {@link NitroRouteConfigV3} to be held to one.
+ */
+type NitroRouteConfig = NitroRouteConfigV2 | NitroRouteConfigV3;
 //#endregion
 //#region src/pages.d.ts
-declare function extendPages(cb: NuxtHooks['pages:extend']): void;
+export declare function extendPages(cb: NuxtHooks['pages:extend']): void;
 interface ExtendRouteRulesOptions {
   /**
    * Override route rule config
@@ -356,7 +530,7 @@ interface ExtendRouteRulesOptions {
    */
   override?: boolean;
 }
-declare function extendRouteRules(route: string, rule: NitroRouteConfig, options?: ExtendRouteRulesOptions): void;
+export declare function extendRouteRules(route: string, rule: NitroRouteConfig, options?: ExtendRouteRulesOptions): void;
 interface AddRouteMiddlewareOptions {
   /**
    * Override existing middleware with the same name, if it exists
@@ -369,10 +543,10 @@ interface AddRouteMiddlewareOptions {
    */
   prepend?: boolean;
 }
-declare function addRouteMiddleware(input: NuxtMiddleware | NuxtMiddleware[], options?: AddRouteMiddlewareOptions): void;
+export declare function addRouteMiddleware(input: NuxtMiddleware | NuxtMiddleware[], options?: AddRouteMiddlewareOptions): void;
 //#endregion
 //#region src/plugin.d.ts
-declare function normalizePlugin(plugin: NuxtPlugin | string): NuxtPlugin;
+export declare function normalizePlugin(plugin: NuxtPlugin | string): NuxtPlugin;
 /**
  * Registers a nuxt plugin and to the plugins array.
  *
@@ -394,11 +568,11 @@ declare function normalizePlugin(plugin: NuxtPlugin | string): NuxtPlugin;
 interface AddPluginOptions {
   append?: boolean;
 }
-declare function addPlugin(_plugin: NuxtPlugin | string, opts?: AddPluginOptions): NuxtPlugin;
+export declare function addPlugin(_plugin: NuxtPlugin | string, opts?: AddPluginOptions): NuxtPlugin;
 /**
  * Adds a template and registers as a nuxt plugin.
  */
-declare function addPluginTemplate(plugin: NuxtPluginTemplate | string, opts?: AddPluginOptions): NuxtPlugin;
+export declare function addPluginTemplate(plugin: NuxtPluginTemplate | string, opts?: AddPluginOptions): NuxtPlugin;
 //#endregion
 //#region src/resolve.d.ts
 interface ResolvePathOptions {
@@ -435,15 +609,15 @@ interface ResolvePathOptions {
  * If a path cannot be resolved, normalized input will be returned unless the `fallbackToOriginal` option is set to `true`,
  * in which case the original input path will be returned.
  */
-declare function resolvePath(path: string, opts?: ResolvePathOptions): Promise<string>;
+export declare function resolvePath(path: string, opts?: ResolvePathOptions): Promise<string>;
 /**
  * Try to resolve first existing file in paths
  */
-declare function findPath(paths: string | string[], opts?: ResolvePathOptions, pathType?: PathType): Promise<string | null>;
+export declare function findPath(paths: string | string[], opts?: ResolvePathOptions, pathType?: PathType): Promise<string | null>;
 /**
  * Resolve path aliases respecting Nuxt alias options
  */
-declare function resolveAlias(path: string, alias?: Record<string, string>): string;
+export declare function resolveAlias(path: string, alias?: Record<string, string>): string;
 interface Resolver {
   resolve(...path: string[]): string;
   resolvePath(path: string, opts?: ResolvePathOptions): Promise<string>;
@@ -451,8 +625,8 @@ interface Resolver {
 /**
  * Create a relative resolver
  */
-declare function createResolver(base: string | URL): Resolver;
-declare function resolveNuxtModule(base: string, paths: string[]): Promise<string[]>;
+export declare function createResolver(base: string | URL): Resolver;
+export declare function resolveNuxtModule(base: string, paths: string[]): Promise<string[]>;
 type PathType = 'file' | 'dir';
 /**
  * Resolve absolute file paths in the provided directory with respect to `.nuxtignore` and return them sorted.
@@ -463,81 +637,29 @@ type PathType = 'file' | 'dir';
  * @param opts.ignore additional glob patterns to ignore
  * @returns sorted array of absolute file paths
  */
-declare function resolveFiles(path: string, pattern: string | string[], opts?: {
+export declare function resolveFiles(path: string, pattern: string | string[], opts?: {
   followSymbolicLinks?: boolean;
-  ignore?: GlobOptions['ignore'];
+  ignore?: string | readonly string[];
 }): Promise<string[]>;
 //#endregion
-//#region src/nitro.d.ts
-/**
- * Adds a nitro server handler
- *
- */
-declare function addServerHandler(handler: NitroEventHandler): void;
-/**
- * Adds a nitro server handler for development-only
- *
- */
-declare function addDevServerHandler(handler: NitroDevEventHandler): void;
-/**
- * Adds a Nitro plugin
- */
-declare function addServerPlugin(plugin: string): void;
-/**
- * Adds routes to be prerendered
- */
-declare function addPrerenderRoutes(routes: string | string[]): void;
-/**
- * Access to the Nitro instance
- *
- * **Note:** You can call `useNitro()` only after `ready` hook.
- *
- * **Note:** Changes to the Nitro instance configuration are not applied.
- * @example
- *
- * ```ts
- * nuxt.hook('ready', () => {
- *   console.log(useNitro())
- * })
- * ```
- */
-declare function useNitro(): Nitro;
-/**
- * Add server imports to be auto-imported by Nitro
- */
-declare function addServerImports(imports: Import | Import[]): void;
-/**
- * Add directories to be scanned for auto-imports by Nitro
- */
-declare function addServerImportsDir(dirs: string | string[], opts?: {
-  prepend?: boolean;
-}): void;
-/**
- * Add directories to be scanned by Nitro. It will check for subdirectories,
- * which will be registered just like the `~~/server` folder is.
- */
-declare function addServerScanDir(dirs: string | string[], opts?: {
-  prepend?: boolean;
-}): void;
-//#endregion
 //#region src/template.d.ts
 /**
  * Renders given template during build into the virtual file system (and optionally to disk in the project `buildDir`)
  */
-declare function addTemplate<T>(_template: NuxtTemplate<T> | string): ResolvedNuxtTemplate<T>;
+export declare function addTemplate<T>(_template: NuxtTemplate<T> | string): ResolvedNuxtTemplate<T>;
 /**
- * Adds a virtual file that can be used within the Nuxt Nitro server build.
+ * Adds a virtual file that can be used within the server build.
  */
-declare function addServerTemplate(template: NuxtServerTemplate): NuxtServerTemplate;
+export declare function addServerTemplate(template: NuxtServerTemplate): NuxtServerTemplate;
 /**
- * Renders given types during build to disk in the project `buildDir`
+ * Renders given types during build to disk in the project `typesDir`
  * and register them as types.
  *
  * You can pass a second context object to specify in which context the type should be added.
  *
  * If no context object is passed, then it will only be added to the nuxt context.
  */
-declare function addTypeTemplate<T>(_template: NuxtTypeTemplate<T>, context?: {
+export declare function addTypeTemplate<T>(_template: NuxtTypeTemplate<T>, context?: {
   nitro?: boolean;
   nuxt?: boolean;
   node?: boolean;
@@ -546,16 +668,21 @@ declare function addTypeTemplate<T>(_template: NuxtTypeTemplate<T>, context?: {
 /**
  * Normalize a nuxt template object
  */
-declare function normalizeTemplate<T>(template: NuxtTemplate<T> | string, buildDir?: string): ResolvedNuxtTemplate<T>;
+export declare function normalizeTemplate<T>(template: NuxtTemplate<T> | string, buildDir?: string): ResolvedNuxtTemplate<T>;
 /**
  * Trigger rebuilding Nuxt templates
  *
  * You can pass a filter within the options to selectively regenerate a subset of templates.
  */
-declare function updateTemplates(options?: {
+export declare function updateTemplates(options?: {
   filter?: (template: ResolvedNuxtTemplate<any>) => boolean;
 }): Promise<void>;
-declare function writeTypes(nuxt: Nuxt): Promise<void>;
+/**
+ * Writes the generated `tsconfig` and declaration files to `typesDir`.
+ *
+ * When a production build uses a `buildDir` other than `typesDir`, existing files are left untouched.
+ */
+export declare function writeTypes(nuxt: Nuxt): Promise<void>;
 //#endregion
 //#region src/types.d.ts
 /**
@@ -566,9 +693,18 @@ declare function writeTypes(nuxt: Nuxt): Promise<void>;
  * A `.mjs` / `.cjs` / `.mts` / `.cts` runtime path is rewritten to an adjacent declaration
  * sibling when one exists; otherwise it is returned as-is for the caller to handle.
  */
-declare function resolveDeclarationPath(absolutePath: string): Promise<string>;
+export declare function resolveDeclarationPath(absolutePath: string): Promise<string>;
 /** Extract the package name (including scope) from a (possibly subpath) module specifier. */
-declare function packageName(specifier: string): string;
+export declare function packageName(specifier: string): string;
+interface ResolveTypePathsOptions {
+  /**
+   * Resolve a bare package to the file its entry resolves to, rather than to the package root.
+   *
+   * A `paths` substitution naming a directory is only followed under `bundler` resolution.
+   * `nodenext`, which the `node` environment's tsconfig uses, requires it to name a file.
+   */
+  entry?: boolean;
+}
 /**
  * Resolve auto-import / `tsConfig.paths` entries to the path TypeScript should load types from.
  *
@@ -579,765 +715,273 @@ declare function packageName(specifier: string): string;
  *
  * Returns `[specifier, absolutePath]` pairs, omitting any specifier that cannot be resolved.
  */
-declare function resolveTypePaths(packages: string[], searchPaths: string[]): Promise<Array<[string, string]>>;
+export declare function resolveTypePaths(packages: string[], searchPaths: string[], options?: ResolveTypePathsOptions): Promise<Array<[string, string]>>;
 //#endregion
-//#region src/logger.d.ts
-declare const logger: ConsolaInstance;
-declare function useLogger(tag?: string, options?: Partial<ConsolaOptions>): ConsolaInstance;
-//#endregion
-//#region src/diagnostics/build.d.ts
+//#region src/watch.d.ts
+/**
+ * The subset of a chokidar `FSWatcher` this helper needs. Callers hold
+ * different chokidar majors (Nuxt core watches with v5, Vite bundles v3), so
+ * the parameter is structural rather than an import of either package.
+ */
+interface RecoverableWatcher {
+  on: (event: any, listener: (...args: any[]) => void) => any;
+  emit: (event: any, ...args: any[]) => any;
+  options?: {
+    cwd?: string | undefined;
+  } | undefined;
+}
 /**
- * B1xxx
- * Build / compilation diagnostics.
+ * chokidar suppresses a `change` event that lands within 50ms of the previous
+ * `change` for the same path, and never replays it. A save that follows a fast
+ * HMR round trip is therefore silently lost until the file is touched again,
+ * which looks exactly like broken HMR. This is true of every chokidar major
+ * Nuxt uses.
  *
- * @internal
- */
-declare const buildDiagnostics: import("nostics").Diagnostics<{
-  readonly NUXT_B1001: {
-    readonly why: (p: {
-      filename: string;
-    }) => string;
-    readonly fix: (p: {
-      src?: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B1002: {
-    readonly why: (p: {
-      src: string;
-    }) => string;
-    readonly fix: "Check that the template `src` path exists and is readable.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1003: {
-    readonly why: "Invalid template. Templates must have either `src` or `getContents`.";
-    readonly fix: "Add a `getContents` function or a `src` path to the `addTemplate()` call.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1004: {
-    readonly why: "Failed to install dependencies.";
-    readonly fix: (p: {
-      packages: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B1005: {
-    readonly why: (p: {
-      plugin: string;
-      file: string;
-    }) => string;
-    readonly fix: "Check the file for syntax errors, or report this issue to the plugin author.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1006: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "Check that the file exists and has correct permissions.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1007: {
-    readonly why: (p: {
-      plugin: string;
-    }) => string;
-    readonly fix: "Check the plugin implementation or report this issue to the plugin author.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1008: {
-    readonly why: (p: {
-      function: string;
-      file: string;
-    }) => string;
-    readonly fix: "Please report this issue at https://github.com/nuxt/nuxt/issues with the file contents.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1009: {
-    readonly why: (p: {
-      functionName: string;
-      name?: string;
-      source?: string;
-    }) => string;
-    readonly fix: "Ensure each keyed function has a unique name, or use a different source to distinguish them.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1010: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "The file was modified while being read, usually by a concurrent process writing to it. Try restarting the build.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1011: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "Check that the file exists and is readable, or try clearing the build cache with `nuxt clean`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1012: {
-    readonly why: (p: {
-      path: string;
-    }) => string;
-    readonly fix: "Delete the cache with `nuxt clean` and rebuild.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1013: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "Try clearing the build cache with `nuxt clean` and rebuilding from scratch.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1014: {
-    readonly why: "Problem checking for external configuration files.";
-    readonly fix: "This is likely a transient file system error. If it persists, check file permissions in your project root.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1015: {
-    readonly why: "Falling back to `chokidar-granular` as `@parcel/watcher` cannot be resolved in your project.";
-    readonly fix: "Install `@parcel/watcher` for better performance: `npm install -D @parcel/watcher`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1016: {
-    readonly why: "Failed to set up the `@parcel/watcher` file watcher.";
-    readonly fix: "This is likely an environment or file system issue. Watching for file changes may not work; restart the dev server and, if the problem persists, report it.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1017: {
-    readonly why: (p: {
-      builder: string;
-    }) => string;
-    readonly fix: (p: {
-      builder: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B1018: {
-    readonly why: (p: {
-      builder: string;
-    }) => string;
-    readonly fix: (p: {
-      builder: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B1019: {
-    readonly why: (p: {
-      mode: string;
-    }) => string;
-    readonly fix: "If you are a module author, ensure the component `mode` is set to `client`, `server`, or `all`. Otherwise, please report this issue.";
-    readonly docs: false;
-  };
-  readonly NUXT_B1020: {
-    readonly why: "`experimental.watcher: \"builder\"` is set but the active builder does not implement `setupWatcher`. Falling back to the default file watcher.";
-    readonly fix: "Remove `experimental.watcher` from your `nuxt.config`, or use a builder that supports its own watcher.";
-    readonly docs: false;
-  };
-}, readonly [import("nostics").DiagnosticReporter<{
-  method?: import("nostics").ConsoleMethod;
-}>]>;
-//#endregion
-//#region src/diagnostics/plugins.d.ts
-/**
- * B2xxx
- * Plugin diagnostics (`addPlugin`, plugin metadata, plugin ordering).
+ * Raw fs events are not throttled, so once chokidar has reported a file at
+ * least once we can use them to notice a modification that never surfaced as a
+ * `change` event, and re-emit it after the throttle window has passed.
  *
- * @internal
+ * @param watcher the chokidar watcher to patch
+ * @returns a disposer releasing the recovery state; call it when the watcher closes
  */
-declare const pluginDiagnostics: import("nostics").Diagnostics<{
-  readonly NUXT_B2001: {
-    readonly why: (p: {
-      type: string;
-      name: string;
-    }) => string;
-    readonly fix: "Pass an object literal as the second argument, e.g. `defineNuxtPlugin(() => {}, { name: 'my-plugin' })`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2002: {
-    readonly why: "Plugin options contain spread elements or computed keys, which are not supported.";
-    readonly fix: "Use static properties instead.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2003: {
-    readonly why: "`dependsOn` is not an array of string literals.";
-    readonly fix: "Use string literals in the `dependsOn` array, e.g. `dependsOn: ['my-plugin']`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2004: {
-    readonly why: (p: {
-      src: string;
-    }) => string;
-    readonly fix: "Add content to the plugin file, or remove it from the `plugins/` directory.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2005: {
-    readonly why: (p: {
-      src: string;
-    }) => string;
-    readonly fix: "Add `export default defineNuxtPlugin(() => {})` to your plugin.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2006: {
-    readonly why: (p: {
-      src: string;
-    }) => string;
-    readonly fix: "Check the plugin file for syntax errors.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2007: {
-    readonly why: (p: {
-      src: string;
-    }) => string;
-    readonly fix: "Wrap your plugin with `defineNuxtPlugin`. This may enable enhancements in future.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2008: {
-    readonly why: (p: {
-      name: string;
-      missing: string;
-    }) => string;
-    readonly fix: "Register the missing dependency plugins, or remove them from the `dependsOn` array.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2009: {
-    readonly why: (p: {
-      cycle: string;
-    }) => string;
-    readonly fix: "Restructure the plugin `dependsOn` declarations to break the cycle.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2010: {
-    readonly why: (p: {
-      src: string;
-    }) => string;
-    readonly fix: "Use an object literal with static values as the second argument to `defineNuxtPlugin()`, and check the plugin file for syntax errors or unsupported constructs in the metadata.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2011: {
-    readonly why: (p: {
-      src: string;
-    }) => string;
-    readonly fix: "Pass a string path, or an object with a `src` property, to `addPlugin()`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B2012: {
-    readonly why: (p: {
-      name: string;
-      dependencies: string[];
-      mode: "client" | "server";
-    }) => string;
-    readonly fix: "Do not depend on plugins that are unavailable in the same build environment; remove them from the `dependsOn` array.";
-    readonly docs: false;
-  };
-}, readonly [import("nostics").DiagnosticReporter<{
-  method?: import("nostics").ConsoleMethod;
-}>]>;
+export declare function recoverThrottledChanges(watcher: RecoverableWatcher): () => void;
 //#endregion
-//#region src/diagnostics/components.d.ts
-/**
- * B3xxx
- * Component diagnostics.
- *
- * @internal
- */
-declare const componentDiagnostics: import("nostics").Diagnostics<{
-  readonly NUXT_B3001: {
-    readonly why: (p: {
-      dirPath: string;
-    }) => string;
-    readonly fix: "If this is intentional, remove it from `components.dirs` in your `nuxt.config`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3002: {
-    readonly why: (p: {
-      component: string;
-    }) => string;
-    readonly fix: "Set `experimental.componentIslands` to `true` in your `nuxt.config`, or convert the component to a client component.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3003: {
-    readonly why: (p: {
-      component: string;
-    }) => string;
-    readonly fix: "Set `experimental.componentIslands` to `true` in your `nuxt.config`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3004: {
-    readonly why: (p: {
-      file: string;
-      component: string;
-      requiredModule: string;
-    }) => string;
-    readonly fix: (p: {
-      requiredModule: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B3005: {
-    readonly why: (p: {
-      component: string;
-      file: string;
-    }) => string;
-    readonly fix: "Use only one hydration strategy attribute (e.g. `hydrate-on-visible` or `hydrate-on-idle`) per component.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3006: {
-    readonly why: (p: {
-      component: string;
-      file: string;
-    }) => string;
-    readonly fix: (p: {
-      lazyName: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B3007: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "Set `experimental.componentIslands.selectiveClient` to `true` in your `nuxt.config`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3008: {
-    readonly why: (p: {
-      scannedPath: string;
-    }) => string;
-    readonly fix: (p: {
-      scannedPath: string;
-      expectedPath: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B3009: {
-    readonly why: (p: {
-      component: string;
-      filePath: string;
-    }) => string;
-    readonly fix: "Rename the component to avoid the `Lazy` prefix.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3010: {
-    readonly why: (p: {
-      filePath: string;
-    }) => string;
-    readonly fix: "Rename the component file to something other than `index` (e.g. `MyComponent.vue`).";
-    readonly docs: false;
-  };
-  readonly NUXT_B3011: {
-    readonly why: (p: {
-      component: string;
-      filePath: string;
-      duplicatePath: string;
-    }) => string;
-    readonly fix: "Rename one of the files or adjust the `components.dirs` prefix settings in your `nuxt.config`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3012: {
-    readonly why: (p: {
-      name: string;
-    }) => string;
-    readonly fix: "Specify a `priority` option when calling `addComponent` to avoid this warning.";
-    readonly docs: false;
-  };
-  readonly NUXT_B3013: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "Switch to the Vite builder with `builder: 'vite'` in your `nuxt.config`.";
-    readonly docs: false;
+//#region src/logger.d.ts
+/** Numeric verbosity threshold: `0` (fatal/error) through `5` (trace). */
+type NuxtLogLevel = 0 | 1 | 2 | 3 | 4 | 5 | (number & {});
+/** The kind of message being logged, which determines how it is rendered. */
+type NuxtLogType = 'silent' | 'fatal' | 'error' | 'warn' | 'log' | 'info' | 'success' | 'fail' | 'ready' | 'start' | 'box' | 'debug' | 'trace' | 'verbose';
+/** A structured message, usable in place of a string when logging. */
+interface NuxtLogInput {
+  level?: NuxtLogLevel;
+  tag?: string;
+  type?: NuxtLogType;
+  message?: string;
+  additional?: string | string[];
+  args?: unknown[];
+  date?: Date;
+}
+/** A fully resolved log record, as passed to reporters. */
+interface NuxtLogObject extends NuxtLogInput {
+  level: NuxtLogLevel;
+  type: NuxtLogType;
+  tag: string;
+  args: unknown[];
+  date: Date;
+  [key: string]: unknown;
+}
+interface NuxtLogReporter {
+  /** Declared with method syntax so implementations may narrow the context type. */
+  log(logObject: NuxtLogObject, ctx: {
+    options: NuxtLoggerOptions;
+  }): void;
+}
+interface NuxtLogFn {
+  (message: NuxtLogInput | unknown, ...args: unknown[]): void;
+  /** Log the arguments verbatim, bypassing formatting. */
+  raw: (...args: unknown[]) => void;
+}
+interface NuxtLoggerOptions {
+  level?: NuxtLogLevel;
+  reporters?: NuxtLogReporter[];
+  /** Default log fields applied to every message. */
+  defaults?: NuxtLogInput;
+  /** Per-type defaults, keyed by log type. */
+  types?: Record<NuxtLogType, NuxtLogInput>;
+  /** How many times an identical message may repeat before it is throttled. */
+  throttle?: number;
+  /** How long, in milliseconds, a throttled message is suppressed for. */
+  throttleMin?: number;
+  stdout?: NodeJS.WriteStream;
+  stderr?: NodeJS.WriteStream;
+  /** Replace each log method, for tests. */
+  mockFn?: (type: NuxtLogType, defaults: NuxtLogInput) => (...args: any[]) => void;
+  /** Replace the prompt implementation. */
+  prompt?: (message: string, options?: any) => Promise<any>;
+  formatOptions?: {
+    columns?: number;
+    date?: boolean;
+    colors?: boolean;
+    compact?: boolean | number;
+    errorLevel?: number;
+    [key: string]: unknown;
   };
-}, readonly [import("nostics").DiagnosticReporter<{
-  method?: import("nostics").ConsoleMethod;
-}>]>;
+}
+interface NuxtPromptCommonOptions {
+  name?: string;
+  /** How a cancelled prompt (for example, Ctrl+C) resolves. */
+  cancel?: 'default' | 'undefined' | 'null' | 'symbol' | 'reject';
+}
+type NuxtTextPromptOptions = NuxtPromptCommonOptions & {
+  type?: 'text';
+  default?: string;
+  placeholder?: string;
+  initial?: string;
+};
+type NuxtConfirmPromptOptions = NuxtPromptCommonOptions & {
+  type: 'confirm';
+  initial?: boolean;
+};
+type NuxtSelectPromptOptions = NuxtPromptCommonOptions & {
+  type: 'select';
+  initial?: string;
+  options: (string | {
+    label: string;
+    value?: string;
+    hint?: string;
+  })[];
+};
+type NuxtMultiSelectPromptOptions = NuxtPromptCommonOptions & {
+  type: 'multiselect';
+  initial?: string[];
+  options: (string | {
+    label: string;
+    value?: string;
+    hint?: string;
+  })[];
+  required?: boolean;
+};
+type NuxtPromptOptions = NuxtTextPromptOptions | NuxtConfirmPromptOptions | NuxtSelectPromptOptions | NuxtMultiSelectPromptOptions;
+/**
+ * The logger interface exposed by Nuxt. Structurally satisfied by `consola`,
+ * but Nuxt only guarantees the members declared here.
+ */
+interface NuxtLogger extends Record<NuxtLogType, NuxtLogFn> {
+  /** Current verbosity threshold. Assignable to change what is emitted. */
+  level: NuxtLogLevel;
+  /** The options this logger was created with. */
+  options: NuxtLoggerOptions;
+  /** Create a derived logger with the given options. */
+  create: (options: NuxtLoggerOptions) => NuxtLogger;
+  /** Create a derived logger that prefixes every message with `tag`. */
+  withTag: (tag: string) => NuxtLogger;
+  /** Create a derived logger with default log fields applied. */
+  withDefaults: (defaults: NuxtLogInput) => NuxtLogger;
+  addReporter: (reporter: NuxtLogReporter) => unknown;
+  removeReporter: (reporter: NuxtLogReporter) => unknown;
+  setReporters: (reporters: NuxtLogReporter[]) => unknown;
+  /** Route `console.*` calls through this logger. */
+  wrapConsole: () => void;
+  /** Undo `wrapConsole`. */
+  restoreConsole: () => void;
+  /** Route `console.*`, `process.stdout` and `process.stderr` through this logger. */
+  wrapAll: () => void;
+  /** Undo `wrapAll`. */
+  restoreAll: () => void;
+  /** Route `process.stdout` and `process.stderr` through this logger. */
+  wrapStd: () => void;
+  /** Undo `wrapStd`. */
+  restoreStd: () => void;
+  /** Buffer log output until `resumeLogs` is called. */
+  pauseLogs: () => void;
+  resumeLogs: () => void;
+  /** Replace every log method, for tests. */
+  mockTypes: (mockFn?: NuxtLoggerOptions['mockFn']) => void;
+  /**
+   * Prompt the user for input. The resolved value depends on `options.type`
+   * (`text` -> `string`, `confirm` -> `boolean`, `select` -> the chosen option,
+   * `multiselect` -> an array of chosen options), and on `options.cancel` when
+   * the prompt is dismissed.
+   *
+   * Declared with method syntax so implementations may narrow the options type.
+   */
+  prompt(message: string, options?: NuxtPromptOptions): Promise<any>;
+}
+export declare const logger: NuxtLogger;
+export declare function useLogger(tag?: string, options?: NuxtLoggerOptions): NuxtLogger;
 //#endregion
-//#region src/diagnostics/pages.d.ts
+//#region src/terminal.d.ts
+/** A unit of long-running work, rendered on the host's status surface where available. */
+interface NuxtTerminalTask {
+  /** Change the label of the running task. */
+  update: (label: string) => void;
+  /** Finish the task, optionally with a closing message. Defaults to a successful outcome. */
+  stop: (message?: string, outcome?: 'success' | 'failure') => void;
+}
+interface NuxtTerminalNotification {
+  title?: string;
+  message: string;
+  level?: 'info' | 'warn';
+}
+interface NuxtTerminalNotice {
+  /** Retract the notice. */
+  dismiss: () => void;
+  /** Settles once the notice is gone: acknowledged by the user or retracted. */
+  dismissed: Promise<void>;
+}
+interface NuxtTerminal {
+  /**
+   * Whether an interactive host (such as the `nuxt dev` TUI) is present. `false` means the
+   * primitives below fall back to plain logging on the current process streams.
+   */
+  readonly interactive: boolean;
+  /**
+   * Borrow the terminal for the duration of `work`: any host UI is suspended and stdin is
+   * released, so `work` may read from stdin and write directly to the terminal.
+   *
+   * Concurrent callers are serialised by the host; a nested call from within a borrow runs
+   * immediately.
+   */
+  withTerminal: <T>(work: () => Promise<T>) => Promise<T>;
+  /** Ask the user a question, taking over the terminal for as long as the prompt is open. */
+  prompt: (message: string, options?: NuxtPromptOptions) => Promise<any>;
+  /** Start a task, to be finished with `task.stop()`. */
+  startTask: (label: string) => NuxtTerminalTask;
+  /** Show a message and hold it on screen until it is acknowledged or retracted. */
+  notify: (notification: NuxtTerminalNotification) => NuxtTerminalNotice;
+}
 /**
- * B4xxx
- * Pages / routing diagnostics.
+ * Access the terminal, cooperating with the host UI (such as the `nuxt dev` TUI) when one is
+ * running, and falling back to logging when it is not.
  *
- * @internal
+ * Use this instead of writing to `process.stdout` or prompting directly, so that prompts are
+ * answerable, tasks are rendered in one place, and nothing is lost to a captured stream.
  */
-declare const pageDiagnostics: import("nostics").Diagnostics<{
-  readonly NUXT_B4001: {
-    readonly why: (p: {
-      pathname: string;
-    }) => string;
-    readonly fix: "Add a `<template>` block to the page file, or remove the empty file from the `pages/` directory.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4002: {
-    readonly why: "An `await` expression is used in a variable referenced by `definePageMeta`, which runs synchronously.";
-    readonly fix: (p: {
-      codeSnippet: string;
-      offset: number;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B4003: {
-    readonly why: (p: {
-      callCount: number;
-      file: string;
-    }) => string;
-    readonly fix: "Merge all `definePageMeta()` calls into a single call.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4004: {
-    readonly why: (p: {
-      file: string;
-      existingFile: string;
-    }) => string;
-    readonly fix: "Set a custom name using `definePageMeta` within one of the page files.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4005: {
-    readonly why: (p: {
-      fnName: string;
-      file: string;
-      receivedType: string;
-    }) => string;
-    readonly fix: (p: {
-      fnName: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B4006: {
-    readonly why: (p: {
-      fnName: string;
-      file: string;
-    }) => string;
-    readonly fix: "Use only JSON-serializable values (strings, numbers, booleans, arrays, plain objects) in `defineRouteRules()`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4008: {
-    readonly why: "Server pages with `ssr: false` are not supported while component islands are auto-detected.";
-    readonly fix: "Set `experimental.componentIslands` to `true`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4009: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "Rename the layout file to something other than `index` (e.g. `layouts/default.vue`).";
-    readonly docs: false;
-  };
-  readonly NUXT_B4010: {
-    readonly why: (p: {
-      file: string;
-    }) => string;
-    readonly fix: "Rename the middleware file to something other than `index` (e.g. `middleware/auth.ts`).";
-    readonly docs: false;
-  };
-  readonly NUXT_B4011: {
-    readonly why: (p: {
-      message: string;
-    }) => string;
-    readonly fix: "Check the page file naming and directory structure for issues.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4012: {
-    readonly why: (p: {
-      event: string;
-      path: string;
-    }) => string;
-    readonly fix: "This is usually harmless: the full rebuild will recover. If it happens repeatedly, check for unusual file naming in `pages/`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4013: {
-    readonly why: (p: {
-      name: string;
-      foundPath: string;
-    }) => string;
-    readonly fix: "Set `override: true` to replace it.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4014: {
-    readonly why: (p: {
-      layoutName: string;
-      existingPath: string;
-      newPath: string;
-    }) => string;
-    readonly fix: "Rename one of the layouts, or remove the duplicate layout registration.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4016: {
-    readonly why: (p: {
-      path: string;
-      detail: string;
-    }) => string;
-    readonly fix: "Define the affected route rules explicitly in `nitro.routeRules`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B4017: {
-    readonly why: (p: {
-      path: string;
-      pattern: string;
-    }) => string;
-    readonly fix: "The later inline route rules override the earlier ones. Use distinct routes, or define the rules explicitly in `nitro.routeRules`.";
-    readonly docs: false;
-  };
-}, readonly [import("nostics").DiagnosticReporter<{
-  method?: import("nostics").ConsoleMethod;
-}>]>;
+export declare function useTerminal(): NuxtTerminal;
 //#endregion
-//#region src/diagnostics/config.d.ts
+//#region src/dependency.d.ts
+interface EnsureDependencyInstalledOptions {
+  rootDir?: string;
+  searchPaths?: string[];
+  /**
+   * Additional URL or path to resolve packages from (e.g. `import.meta.url`).
+   * Useful when the calling package ships optional deps as peer dependencies.
+   */
+  from?: string;
+  /**
+   * Whether to prompt the user to install the dependency.
+   *
+   * - `true`: always prompt
+   * - `false`: never prompt (install automatically on StackBlitz)
+   * - `undefined`: prompt unless on StackBlitz
+   */
+  prompt?: boolean;
+}
 /**
- * B5xxx
- * Configuration diagnostics.
+ * Ensure one or more dependencies are installed, prompting the user to install any that are missing.
  *
- * @internal
- */
-declare const configDiagnostics: import("nostics").Diagnostics<{
-  readonly NUXT_B5001: {
-    readonly why: (p: {
-      fallback: string;
-    }) => string;
-    readonly fix: (p: {
-      latest: string;
-    }) => string;
-  };
-  readonly NUXT_B5002: {
-    readonly why: (p: {
-      rootDir: string;
-    }) => string;
-    readonly fix: "Install it manually with `npm install -D @nuxt/webpack-builder`, or change the `builder` option to `vite` in `nuxt.config`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B5003: {
-    readonly why: (p: {
-      key: string;
-    }) => string;
-    readonly fix: "Move the key to `runtimeConfig.public` or a custom namespace.";
-  };
-  readonly NUXT_B5004: {
-    readonly why: (p: {
-      files: string;
-    }) => string;
-    readonly fix: "Move these configurations into `nuxt.config.ts` and delete the external config files.";
-  };
-  readonly NUXT_B5005: {
-    readonly why: (p: {
-      filePath: string;
-    }) => string;
-    readonly fix: "Ensure the file exports a valid object with `defineNuxtSchema()` or as a plain object.";
-    readonly docs: false;
-  };
-  readonly NUXT_B5006: {
-    readonly why: (p: {
-      option: string;
-    }) => string;
-    readonly fix: "Remove the hash option from your webpack config.";
-    readonly docs: false;
-  };
-  readonly NUXT_B5007: {
-    readonly why: "The webpack server config `target` is not set to \"node\".";
-    readonly fix: "Set `target: \"node\"` in your webpack server configuration.";
-    readonly docs: false;
-  };
-  readonly NUXT_B5009: {
-    readonly why: "`@parcel/watcher` cannot be resolved in your project, so `chokidar` is being used instead.";
-    readonly fix: "Install `@parcel/watcher` for better file watching: `npm install -D @parcel/watcher`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B5010: {
-    readonly why: (p: {
-      names: string;
-    }) => string;
-    readonly fix: (p: {
-      install: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B5011: {
-    readonly why: (p: {
-      name: string;
-    }) => string;
-    readonly fix: (p: {
-      name: string;
-    }) => string;
-    readonly docs: false;
-  };
-}, readonly [import("nostics").DiagnosticReporter<{
-  method?: import("nostics").ConsoleMethod;
-}>]>;
-//#endregion
-//#region src/diagnostics/head.d.ts
-/**
- * B6xxx
- * Head / auto-import diagnostics.
+ * When called with a single package name (string), returns `true` if available, `false` if not.
  *
- * @internal
+ * When called with an array, returns `true` if all are available, or an array of
+ * package names that are still missing (user declined, install failed, or CI).
+ *
+ * @param names - One or more package names to check and potentially install
+ * @param options - Configuration options
  */
-declare const headDiagnostics: import("nostics").Diagnostics<{
-  readonly NUXT_B6001: {
-    readonly why: (p: {
-      module: string;
-      file: string;
-    }) => string;
-    readonly fix: "Import from `#imports` instead.";
-    readonly docs: false;
-  };
-  readonly NUXT_B6002: {
-    readonly why: (p: {
-      name: string;
-    }) => string;
-    readonly fix: (p: {
-      name: string;
-      file: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B6003: {
-    readonly why: "`unhead.legacy` is deprecated and will be removed.";
-    readonly fix: "Remove deprecated head patterns (`hid`, `vmid`, `children`, `body: true`) and resolve promise values before passing them to `useHead`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B6004: {
-    readonly why: "`experimental.headNext` is deprecated. CAPO sorting is now the default.";
-    readonly fix: "Remove `experimental.headNext` from your `nuxt.config`, or set `unhead.legacy: true` to opt out temporarily.";
-    readonly docs: false;
-  };
-  readonly NUXT_B6005: {
-    readonly why: (p: {
-      name: string;
-      from: string;
-    }) => string;
-    readonly fix: "Check the `from` path in `imports.presets` (or the module that registered this import). Auto-imports from an unresolvable module are silently skipped and can surface as unrelated type errors elsewhere.";
-    readonly docs: false;
-  };
-}, readonly [import("nostics").DiagnosticReporter<{
-  method?: import("nostics").ConsoleMethod;
-}>]>;
-//#endregion
-//#region src/diagnostics/bundler.d.ts
+export declare function ensureDependencyInstalled(names: string, options?: EnsureDependencyInstalledOptions): Promise<boolean>;
+export declare function ensureDependencyInstalled(names: string[], options?: EnsureDependencyInstalledOptions): Promise<true | string[]>;
 /**
- * B7xxx
- * Bundler (Vite / webpack / Nitro) diagnostics.
+ * Get the command a user should run to add dependencies to their project, using the
+ * package manager detected from `cwd` (falling back to `npm`).
  *
- * @internal
+ * @param names - One or more package names to install
+ * @param cwd - Directory to detect the package manager from
+ * @param options - Options for the install command
+ * @param options.dev - Whether the command should install as a dev dependency
  */
-declare const bundlerDiagnostics: import("nostics").Diagnostics<{
-  readonly NUXT_B7001: {
-    readonly why: "`rollup-plugin-visualizer` is not installed, so bundle analysis cannot run.";
-    readonly fix: "Run `npm install -D rollup-plugin-visualizer` to enable bundle analysis.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7002: {
-    readonly why: (p: {
-      deps: string;
-    }) => string;
-    readonly fix: "Remove or correct these entries in the `vite.optimizeDeps.include` array of your `nuxt.config.ts`. Report entries added by a Nuxt module to the module author.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7003: {
-    readonly why: "The server-side bundle produced more than one JS entry file.";
-    readonly fix: "Avoid using `optimization.splitChunks` in the server config.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7004: {
-    readonly why: (p: {
-      entryName: string;
-    }) => string;
-    readonly fix: (p: {
-      entryName: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B7005: {
-    readonly why: (p: {
-      input: string;
-    }) => string;
-    readonly fix: "Set `vite.build.rollupOptions.input` to a string or an object with an `entry` key in your `nuxt.config`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7006: {
-    readonly why: (p: {
-      input: string;
-    }) => string;
-    readonly fix: "Set `vite.build.rollupOptions.input` to a string or an object with a `server` key in your `nuxt.config`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7007: {
-    readonly why: (p: {
-      pluginName: string;
-    }) => string;
-    readonly fix: (p: {
-      pluginName: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B7008: {
-    readonly why: "`@vitejs/plugin-vue-jsx` is not installed, so JSX support is unavailable.";
-    readonly fix: "Run `npm install -D @vitejs/plugin-vue-jsx` to install it.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7009: {
-    readonly why: (p: {
-      deps: string;
-    }) => string;
-    readonly fix: (p: {
-      install: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B7011: {
-    readonly why: (p: {
-      pluginName: string;
-    }) => string;
-    readonly fix: (p: {
-      pluginName: string;
-    }) => string;
-    readonly docs: false;
-  };
-  readonly NUXT_B7012: {
-    readonly why: (p: {
-      requiredSize: number;
-      maxSize: number;
-    }) => string;
-    readonly fix: "Reduce the payload size sent through the ViteNode socket.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7013: {
-    readonly why: "The ViteNode socket server was started without a configured socket path.";
-    readonly fix: "This is likely an internal Nuxt bug. Please report it at https://github.com/nuxt/nuxt/issues.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7014: {
-    readonly why: (p: {
-      name: string;
-    }) => string;
-    readonly fix: "Fix the build errors listed above. If the errors are unclear, try running `nuxt cleanup` and rebuilding.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7015: {
-    readonly why: "Payload extraction is disabled, which is suboptimal for full-static output.";
-    readonly fix: "Set `experimental.payloadExtraction` to `true` or `'client'`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7016: {
-    readonly why: (p: {
-      path: string;
-    }) => string;
-    readonly fix: "Point `spaLoadingTemplate` in `nuxt.config` at an existing HTML file, or set it to `true` to use the default template.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7017: {
-    readonly why: "Could not find the Nuxt dev server to attach Rspack HMR to; hot module replacement will be disabled.";
-    readonly fix: "This is likely an internal Nuxt bug. Please report it with a reproduction.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7018: {
-    readonly why: "Failed to restrict vite-node socket permissions; closing the socket.";
-    readonly fix: "Check that the temporary directory used for the vite-node socket is writable and supports `chmod`.";
-    readonly docs: false;
-  };
-  readonly NUXT_B7019: {
-    readonly why: "The server webpack build does not externalize dependencies.";
-    readonly fix: "Externalize dependencies in the server build (`externals`) for better build performance.";
-    readonly docs: false;
-  };
-}, readonly [import("nostics").DiagnosticReporter<{
-  method?: import("nostics").ConsoleMethod;
-}>]>;
+export declare function getAddDependencyCommand(names: string | string[], cwd: string, options?: {
+  dev?: boolean;
+}): Promise<string>;
 //#endregion
 //#region src/internal/esm.d.ts
 interface ResolveModuleOptions {
@@ -1347,30 +991,34 @@ interface ResolveModuleOptions {
   /** @default ['.mjs', '.js', '.cjs', '.mts', '.ts', '.cts', '.tsx', '.jsx'] */
   extensions?: string[];
 }
-declare function directoryToURL(dir: string): URL;
+export declare function directoryToURL(dir: string): URL;
 /**
  * Resolve a module from a given root path using an algorithm patterned on
  * the upcoming `import.meta.resolve`. It returns a file URL
- *
- * @internal
  */
-declare function tryResolveModule(id: string, url: URL | URL[]): Promise<string | undefined>;
+export declare function tryResolveModule(id: string, url: URL | URL[]): Promise<string | undefined>;
 /** @deprecated pass URLs pointing at files */
-declare function tryResolveModule(id: string, url: string | string[]): Promise<string | undefined>;
-declare function resolveModule(id: string, options?: ResolveModuleOptions): string;
+export declare function tryResolveModule(id: string, url: string | string[]): Promise<string | undefined>;
+export declare function resolveModule(id: string, options?: ResolveModuleOptions): string;
 interface ImportModuleOptions extends ResolveModuleOptions {
   /** Automatically de-default the result of requiring the module. */
   interopDefault?: boolean;
 }
-declare function importModule<T = unknown>(id: string, opts?: ImportModuleOptions): Promise<T>;
-declare function tryImportModule<T = unknown>(id: string, opts?: ImportModuleOptions): Promise<T | undefined> | undefined;
+export declare function importModule<T = unknown>(id: string, opts?: ImportModuleOptions): Promise<T>;
+export declare function tryImportModule<T = unknown>(id: string, opts?: ImportModuleOptions): Promise<T | undefined> | undefined;
 /**
  * @deprecated Please use `importModule` instead.
  */
-declare function requireModule<T = unknown>(id: string, opts?: ImportModuleOptions): T;
+export declare function requireModule<T = unknown>(id: string, opts?: ImportModuleOptions): T;
 /**
  * @deprecated Please use `tryImportModule` instead.
  */
-declare function tryRequireModule<T = unknown>(id: string, opts?: ImportModuleOptions): T | undefined;
+export declare function tryRequireModule<T = unknown>(id: string, opts?: ImportModuleOptions): T | undefined;
+//#endregion
+//#region src/index.d.ts
+/** @deprecated Internal. Import from `@nuxt/kit/internal` instead. */
+export declare const DEFAULT_JS_FILE_EXTENSIONS: string[];
+/** @deprecated Internal. Import from `@nuxt/kit/internal` instead. */
+export declare const DEFAULT_JSX_FILE_EXTENSIONS: string[];
 //#endregion
-export { type AddComponentOptions, type AddPluginOptions, type AddRouteMiddlewareOptions, DEFAULT_JSX_FILE_EXTENSIONS, DEFAULT_JS_FILE_EXTENSIONS, type ExtendConfigOptions, type ExtendRouteRulesOptions, type ExtendViteConfigOptions, type ExtendWebpackConfigOptions, type ImportModuleOptions, type LayerDirectories, type LoadNuxtConfigOptions, type LoadNuxtOptions, type NuxtMajorVersion, type ResolveModuleOptions, type ResolvePathOptions, type Resolver, 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, buildDiagnostics, buildNuxt, bundlerDiagnostics, checkNuxtCompatibility, componentDiagnostics, configDiagnostics, createIsIgnored, createResolver, defineNuxtModule, directoryToURL, extendNuxtSchema, extendPages, extendRouteRules, extendRspackConfig, extendViteConfig, extendWebpackConfig, findPath, getDirectory, getLayerDirectories, getNuxtCtx, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, headDiagnostics, importModule, installModule, installModules, isIgnored, isNuxt2, isNuxt3, isNuxtMajorVersion, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, packageName, pageDiagnostics, pluginDiagnostics, requireModule, resolveAlias, resolveDeclarationPath, resolveFiles, resolveIgnorePatterns, resolveModule, resolveModuleWithOptions, resolveNuxtModule, resolvePath, resolveTypePaths, runWithNuxtContext, setBuildOutput, setGlobalHead, tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateAppConfig, updateRuntimeConfig, updateTemplates, useLogger, useNitro, useNuxt, useRuntimeConfig, writeTypes };
+export { type AddComponentOptions, type AddPluginOptions, type AddRouteMiddlewareOptions, type EnsureDependencyInstalledOptions, type ExtendConfigOptions, type ExtendRouteRulesOptions, type ExtendViteConfigOptions, type ExtendWebpackConfigOptions, type ImportModuleOptions, type LayerDirectories, type LoadNuxtConfigOptions, type LoadNuxtOptions, type NitroInstance, type NitroInstanceOptions, type NitroRouteConfig, type NitroRouteConfigV2, type NitroRouteConfigV3, type NuxtConfigDiffEntry, type NuxtContext, type NuxtLogFn, type NuxtLogInput, type NuxtLogLevel, type NuxtLogObject, type NuxtLogReporter, type NuxtLogType, type NuxtLogger, type NuxtLoggerOptions, type NuxtMajorVersion, type NuxtPromptOptions, type NuxtTerminal, type NuxtTerminalNotice, type NuxtTerminalNotification, type NuxtTerminalTask, type RecoverableWatcher, type ResolveModuleOptions, type ResolvePathOptions, type ResolveTypePathsOptions, type ResolvedNuxtConfigContext, type Resolver, type ServerImportInput, addDevServerHandler, addNitroPlugin, addPrerenderRoutes, addServerHandler, addServerImports, addServerImportsDir, addServerPlugin, addServerScanDir, getDirectory, installModule, loadNuxtModuleInstance, normalizeModuleTranspilePath, resolveModuleWithOptions, resolveServerVariant, tryUseNitro, useNitro };