@nuxt/kit 3.7.4 → 3.8.0

package/README.md

@@ -17,7 +17,7 @@ It provides a number of features that make it easy to build fast, SEO-friendly,
 - Automatic routing with code-splitting
 - State management
 - SEO Optimization
-- Extandable with [100+ modules](https://nuxt.com/modules)
+- Extensible with [100+ modules](https://nuxt.com/modules)
 - Deployment to a variety of hosting platforms
 - ...[and much more](https://nuxt.com) 🚀
 
@@ -50,7 +50,7 @@ Here are a few ways you can get involved:
 
 ## Local Development
 
-Follow the docs to [Set Up Your Local Development Environment](https://nuxt.com/docs/community/framework-contribution#set-up-your-local-development-environment) to contribute to the framework and documentation.
+Follow the docs to [Set Up Your Local Development Environment](https://nuxt.com/docs/community/framework-contribution#setup) to contribute to the framework and documentation.
 
 ## Nuxt 2
 

package/dist/index.d.mts

@@ -68,30 +68,26 @@ declare function addImportsSources(presets: ImportPresetWithDeprecation | Import
 interface ExtendConfigOptions {
     /**
      * Install plugin on dev
-     *
      * @default true
      */
     dev?: boolean;
     /**
      * Install plugin on build
-     *
      * @default true
      */
     build?: boolean;
     /**
      * Install plugin on server side
-     *
      * @default true
      */
     server?: boolean;
     /**
      * Install plugin on client side
-     *
      * @default true
      */
     client?: boolean;
     /**
-     * Prepends the plugin to the array with `unshit()` instead of `push()`.
+     * Prepends the plugin to the array with `unshift()` instead of `push()`.
      */
     prepend?: boolean;
 }
@@ -173,7 +169,6 @@ declare const nuxtCtx: unctx_index.UseContext<Nuxt>;
  * Get access to Nuxt instance.
  *
  * Throws an error if Nuxt instance is unavailable.
- *
  * @example
  * ```js
  * const nuxt = useNuxt()
@@ -184,7 +179,6 @@ declare function useNuxt(): Nuxt;
  * Get access to Nuxt instance.
  *
  * Returns null if Nuxt instance is unavailable.
- *
  * @example
  * ```js
  * const nuxt = tryUseNuxt()
@@ -207,7 +201,6 @@ declare function extendPages(cb: NuxtHooks['pages:extend']): void;
 interface ExtendRouteRulesOptions {
     /**
      * Override route rule config
-     *
      * @default false
      */
     override?: boolean;
@@ -216,7 +209,6 @@ declare function extendRouteRules(route: string, rule: NitroRouteConfig, options
 interface AddRouteMiddlewareOptions {
     /**
      * Override existing middleware with the same name, if it exists
-     *
      * @default false
      */
     override?: boolean;
@@ -234,7 +226,6 @@ declare function normalizePlugin(plugin: NuxtPlugin | string): NuxtPlugin;
  * to use plugin only in client or server side.
  *
  * Note: By default plugin is prepended to the plugins array. You can use second argument to append (push) instead.
- *
  * @example
  * ```js
  * addPlugin({
@@ -311,7 +302,6 @@ declare function addPrerenderRoutes(routes: string | string[]): void;
  * **Note:** You can call `useNitro()` only after `ready` hook.
  *
  * **Note:** Changes to the Nitro instance configuration are not applied.
- *
  * @example
  *
  * ```ts
@@ -321,6 +311,16 @@ declare function addPrerenderRoutes(routes: string | string[]): void;
  * ```
  */
 declare function useNitro(): Nitro;
+/**
+ * Add server imports to be auto-imported by Nitro
+ */
+declare function addServerImports(imports: Import[]): void;
+/**
+ * Add directories to be scanned by Nitro
+ */
+declare function addServerImportsDir(dirs: string | string[], opts?: {
+    prepend?: boolean;
+}): void;
 
 /**
  * Renders given template using lodash template during build into the project buildDir
@@ -389,4 +389,4 @@ declare const templateUtils: {
     }) => string;
 };
 
-export { type AddComponentOptions, type AddPluginOptions, type AddRouteMiddlewareOptions, type ExtendConfigOptions, type ExtendRouteRulesOptions, type ExtendViteConfigOptions, type ExtendWebpackConfigOptions, type LoadNuxtConfigOptions, type LoadNuxtOptions, type RequireModuleOptions, type ResolveModuleOptions, type ResolvePathOptions, type Resolver, addBuildPlugin, addComponent, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addServerHandler, addServerPlugin, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createResolver, defineNuxtModule, extendNuxtSchema, extendPages, extendRouteRules, extendViteConfig, extendWebpackConfig, findPath, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule, installModule, isIgnored, isNuxt2, isNuxt3, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveNuxtModule, resolvePath, templateUtils, tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateTemplates, useLogger, useNitro, useNuxt, writeTypes };
+export { type AddComponentOptions, type AddPluginOptions, type AddRouteMiddlewareOptions, type ExtendConfigOptions, type ExtendRouteRulesOptions, type ExtendViteConfigOptions, type ExtendWebpackConfigOptions, type LoadNuxtConfigOptions, type LoadNuxtOptions, type RequireModuleOptions, type ResolveModuleOptions, type ResolvePathOptions, type Resolver, addBuildPlugin, addComponent, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addServerHandler, addServerImports, addServerImportsDir, addServerPlugin, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createResolver, defineNuxtModule, extendNuxtSchema, extendPages, extendRouteRules, extendViteConfig, extendWebpackConfig, findPath, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule, installModule, isIgnored, isNuxt2, isNuxt3, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveNuxtModule, resolvePath, templateUtils, tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateTemplates, useLogger, useNitro, useNuxt, writeTypes };

package/dist/index.d.ts

@@ -68,30 +68,26 @@ declare function addImportsSources(presets: ImportPresetWithDeprecation | Import
 interface ExtendConfigOptions {
     /**
      * Install plugin on dev
-     *
      * @default true
      */
     dev?: boolean;
     /**
      * Install plugin on build
-     *
      * @default true
      */
     build?: boolean;
     /**
      * Install plugin on server side
-     *
      * @default true
      */
     server?: boolean;
     /**
      * Install plugin on client side
-     *
      * @default true
      */
     client?: boolean;
     /**
-     * Prepends the plugin to the array with `unshit()` instead of `push()`.
+     * Prepends the plugin to the array with `unshift()` instead of `push()`.
      */
     prepend?: boolean;
 }
@@ -173,7 +169,6 @@ declare const nuxtCtx: unctx_index.UseContext<Nuxt>;
  * Get access to Nuxt instance.
  *
  * Throws an error if Nuxt instance is unavailable.
- *
  * @example
  * ```js
  * const nuxt = useNuxt()
@@ -184,7 +179,6 @@ declare function useNuxt(): Nuxt;
  * Get access to Nuxt instance.
  *
  * Returns null if Nuxt instance is unavailable.
- *
  * @example
  * ```js
  * const nuxt = tryUseNuxt()
@@ -207,7 +201,6 @@ declare function extendPages(cb: NuxtHooks['pages:extend']): void;
 interface ExtendRouteRulesOptions {
     /**
      * Override route rule config
-     *
      * @default false
      */
     override?: boolean;
@@ -216,7 +209,6 @@ declare function extendRouteRules(route: string, rule: NitroRouteConfig, options
 interface AddRouteMiddlewareOptions {
     /**
      * Override existing middleware with the same name, if it exists
-     *
      * @default false
      */
     override?: boolean;
@@ -234,7 +226,6 @@ declare function normalizePlugin(plugin: NuxtPlugin | string): NuxtPlugin;
  * to use plugin only in client or server side.
  *
  * Note: By default plugin is prepended to the plugins array. You can use second argument to append (push) instead.
- *
  * @example
  * ```js
  * addPlugin({
@@ -311,7 +302,6 @@ declare function addPrerenderRoutes(routes: string | string[]): void;
  * **Note:** You can call `useNitro()` only after `ready` hook.
  *
  * **Note:** Changes to the Nitro instance configuration are not applied.
- *
  * @example
  *
  * ```ts
@@ -321,6 +311,16 @@ declare function addPrerenderRoutes(routes: string | string[]): void;
  * ```
  */
 declare function useNitro(): Nitro;
+/**
+ * Add server imports to be auto-imported by Nitro
+ */
+declare function addServerImports(imports: Import[]): void;
+/**
+ * Add directories to be scanned by Nitro
+ */
+declare function addServerImportsDir(dirs: string | string[], opts?: {
+    prepend?: boolean;
+}): void;
 
 /**
  * Renders given template using lodash template during build into the project buildDir
@@ -389,4 +389,4 @@ declare const templateUtils: {
     }) => string;
 };
 
-export { type AddComponentOptions, type AddPluginOptions, type AddRouteMiddlewareOptions, type ExtendConfigOptions, type ExtendRouteRulesOptions, type ExtendViteConfigOptions, type ExtendWebpackConfigOptions, type LoadNuxtConfigOptions, type LoadNuxtOptions, type RequireModuleOptions, type ResolveModuleOptions, type ResolvePathOptions, type Resolver, addBuildPlugin, addComponent, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addServerHandler, addServerPlugin, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createResolver, defineNuxtModule, extendNuxtSchema, extendPages, extendRouteRules, extendViteConfig, extendWebpackConfig, findPath, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule, installModule, isIgnored, isNuxt2, isNuxt3, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveNuxtModule, resolvePath, templateUtils, tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateTemplates, useLogger, useNitro, useNuxt, writeTypes };
+export { type AddComponentOptions, type AddPluginOptions, type AddRouteMiddlewareOptions, type ExtendConfigOptions, type ExtendRouteRulesOptions, type ExtendViteConfigOptions, type ExtendWebpackConfigOptions, type LoadNuxtConfigOptions, type LoadNuxtOptions, type RequireModuleOptions, type ResolveModuleOptions, type ResolvePathOptions, type Resolver, addBuildPlugin, addComponent, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addServerHandler, addServerImports, addServerImportsDir, addServerPlugin, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createResolver, defineNuxtModule, extendNuxtSchema, extendPages, extendRouteRules, extendViteConfig, extendWebpackConfig, findPath, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule, installModule, isIgnored, isNuxt2, isNuxt3, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveNuxtModule, resolvePath, templateUtils, tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateTemplates, useLogger, useNitro, useNuxt, writeTypes };

package/dist/index.mjs

@@ -2572,7 +2572,7 @@ async function loadNuxt(opts) {
   opts.cwd = opts.cwd || opts.rootDir;
   opts.overrides = opts.overrides || opts.config || {};
   opts.overrides.dev = !!opts.dev;
-  const nearestNuxtPkg = await Promise.all(["nuxt3", "nuxt", "nuxt-edge"].map((pkg2) => resolvePackageJSON(pkg2, { url: opts.cwd }).catch(() => null))).then((r) => r.filter(Boolean).sort((a, b) => b.length - a.length)[0]);
+  const nearestNuxtPkg = await Promise.all(["nuxt-nightly", "nuxt3", "nuxt", "nuxt-edge"].map((pkg2) => resolvePackageJSON(pkg2, { url: opts.cwd }).catch(() => null))).then((r) => r.filter(Boolean).sort((a, b) => b.length - a.length)[0]);
   if (!nearestNuxtPkg) {
     throw new Error(`Cannot find any nuxt version from ${opts.cwd}`);
   }
@@ -2593,12 +2593,22 @@ async function loadNuxt(opts) {
     envConfig: opts.dotenv
     // TODO: Backward format conversion
   });
+  nuxt.removeHook || (nuxt.removeHook = nuxt.clearHook.bind(nuxt));
+  nuxt.removeAllHooks || (nuxt.removeAllHooks = nuxt.clearHooks.bind(nuxt));
+  nuxt.hookOnce || (nuxt.hookOnce = (name, fn, ...hookArgs) => {
+    const unsub = nuxt.hook(name, (...args) => {
+      unsub();
+      return fn(...args);
+    }, ...hookArgs);
+    return unsub;
+  });
+  nuxt.hooks || (nuxt.hooks = nuxt);
   return nuxt;
 }
 async function buildNuxt(nuxt) {
   const rootDir = pathToFileURL(nuxt.options.rootDir).href;
   if (nuxt.options._majorVersion === 3) {
-    const { build: build2 } = await tryImportModule("nuxt3", rootDir) || await importModule("nuxt", rootDir);
+    const { build: build2 } = await tryImportModule("nuxt-nightly", rootDir) || await tryImportModule("nuxt3", rootDir) || await importModule("nuxt", rootDir);
     return build2(nuxt);
   }
   const { build } = await tryImportModule("nuxt-edge", rootDir) || await importModule("nuxt", rootDir);
@@ -2824,9 +2834,8 @@ async function writeTypes(nuxt) {
       strict: nuxt.options.typescript?.strict ?? true,
       noImplicitThis: true,
       esModuleInterop: true,
-      // TODO: enable by default in v3.8
-      // types: [],
-      // verbatimModuleSyntax: true,
+      types: [],
+      verbatimModuleSyntax: true,
       allowJs: true,
       noEmit: true,
       resolveJsonModule: true,
@@ -3022,7 +3031,7 @@ function normalizePlugin(plugin) {
   }
   const nonTopLevelPlugin = plugin.src.match(/\/plugins\/[^/]+\/index\.[^/]+$/i);
   if (nonTopLevelPlugin && nonTopLevelPlugin.length > 0 && !useNuxt().options.plugins.find((i) => (typeof i === "string" ? i : i.src).endsWith(nonTopLevelPlugin[0]))) {
-    logger.warn(`[deprecation] You are using a plugin that is within a subfolder of your plugins directory without adding it to your config explicitly. You can move it to the top-level plugins directory, or include the file '~${nonTopLevelPlugin[0]}' in your plugins config (https://nuxt.com/docs/api/configuration/nuxt-config#plugins-1) to remove this warning.`);
+    logger.warn(`[deprecation] You are using a plugin that is within a subfolder of your plugins directory without adding it to your config explicitly. You can move it to the top-level plugins directory, or include the file '~${nonTopLevelPlugin[0]}' in your plugins config (https://nuxt.com/docs/api/nuxt-config#plugins-1) to remove this warning.`);
   }
   plugin.src = normalize(resolveAlias(plugin.src));
   if (plugin.ssr) {
@@ -3087,5 +3096,25 @@ function useNitro() {
   }
   return nuxt._nitro;
 }
+function addServerImports(imports) {
+  const nuxt = useNuxt();
+  nuxt.hook("nitro:config", (config) => {
+    config.imports = config.imports || {};
+    if (Array.isArray(config.imports.imports)) {
+      config.imports.imports.push(...imports);
+    } else {
+      config.imports.imports = [config.imports.imports, ...imports];
+    }
+  });
+}
+function addServerImportsDir(dirs, opts = {}) {
+  const nuxt = useNuxt();
+  nuxt.hook("nitro:config", (config) => {
+    config.scanDirs = config.scanDirs || [];
+    for (const dir of Array.isArray(dirs) ? dirs : [dirs]) {
+      config.scanDirs[opts.prepend ? "unshift" : "push"](dir);
+    }
+  });
+}
 
-export { addBuildPlugin, addComponent, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addServerHandler, addServerPlugin, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createResolver, defineNuxtModule, extendNuxtSchema, extendPages, extendRouteRules, extendViteConfig, extendWebpackConfig, findPath, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule$1 as importModule, installModule, isIgnored, isNuxt2, isNuxt3, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveNuxtModule, resolvePath, templateUtils, tryImportModule$1 as tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateTemplates, useLogger, useNitro, useNuxt, writeTypes };
+export { addBuildPlugin, addComponent, addComponentsDir, addDevServerHandler, addImports, addImportsDir, addImportsSources, addLayout, addPlugin, addPluginTemplate, addPrerenderRoutes, addRouteMiddleware, addServerHandler, addServerImports, addServerImportsDir, addServerPlugin, addTemplate, addTypeTemplate, addVitePlugin, addWebpackPlugin, assertNuxtCompatibility, buildNuxt, checkNuxtCompatibility, compileTemplate, createResolver, defineNuxtModule, extendNuxtSchema, extendPages, extendRouteRules, extendViteConfig, extendWebpackConfig, findPath, getNuxtModuleVersion, getNuxtVersion, hasNuxtCompatibility, hasNuxtModule, hasNuxtModuleCompatibility, importModule$1 as importModule, installModule, isIgnored, isNuxt2, isNuxt3, loadNuxt, loadNuxtConfig, loadNuxtModuleInstance, logger, normalizeModuleTranspilePath, normalizePlugin, normalizeSemanticVersion, normalizeTemplate, nuxtCtx, requireModule, resolveAlias, resolveFiles, resolveIgnorePatterns, resolveModule, resolveNuxtModule, resolvePath, templateUtils, tryImportModule$1 as tryImportModule, tryRequireModule, tryResolveModule, tryUseNuxt, updateTemplates, useLogger, useNitro, useNuxt, writeTypes };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@nuxt/kit",
-  "version": "3.7.4",
+  "version": "3.8.0",
   "repository": "nuxt/nuxt",
+  "description": "Toolkit for authoring modules and interacting with Nuxt",
   "license": "MIT",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -17,7 +18,7 @@
     "dist"
   ],
   "dependencies": {
-    "c12": "^1.4.2",
+    "c12": "^1.5.1",
     "consola": "^3.2.3",
     "defu": "^6.1.2",
     "globby": "^13.2.2",
@@ -30,22 +31,22 @@
     "pkg-types": "^1.0.3",
     "scule": "^1.0.0",
     "semver": "^7.5.4",
-    "ufo": "^1.3.0",
+    "ufo": "^1.3.1",
     "unctx": "^2.3.1",
-    "unimport": "^3.3.0",
+    "unimport": "^3.4.0",
     "untyped": "^1.4.0",
-    "@nuxt/schema": "3.7.4"
+    "@nuxt/schema": "3.8.0"
   },
   "devDependencies": {
-    "@types/hash-sum": "1.0.0",
-    "@types/lodash-es": "4.17.9",
-    "@types/semver": "7.5.3",
+    "@types/hash-sum": "1.0.1",
+    "@types/lodash-es": "4.17.10",
+    "@types/semver": "7.5.4",
     "lodash-es": "4.17.21",
-    "nitropack": "2.6.3",
+    "nitropack": "2.7.0",
     "unbuild": "latest",
-    "vite": "4.4.9",
+    "vite": "4.5.0",
     "vitest": "0.33.0",
-    "webpack": "5.88.2"
+    "webpack": "5.89.0"
   },
   "engines": {
     "node": "^14.18.0 || >=16.10.0"