feat(nuxt): auto-import utils/ directory

docs/content/2.guide/2.directory-structure/1.composables.md

@@ -5,9 +5,9 @@ head.title: Composables
 description: Use the composables/ directory to auto-import your Vue composables into your application.
 ---
 
-# Composables Directory
+# Composables Directories
 
-Nuxt 3 uses the `composables/` directory to automatically import your Vue composables into your application using [auto-imports](/guide/concepts/auto-imports)!
+Nuxt 3 uses the `composables/` and `utils/` directories to automatically import your Vue composables into your application using [auto-imports](/guide/concepts/auto-imports)!
 
 Under the hood, Nuxt auto generates the file `.nuxt/imports.d.ts` to declare the types.
 

docs/content/2.guide/2.directory-structure/1.utils.md

@@ -0,0 +1,5 @@
+---
+navigation.icon: IconDirectory
+title: 'utils'
+redirect: /guide/directory-structure/composables
+---

docs/public/_redirects

@@ -7,6 +7,7 @@
 /bridge                           /bridge/overview 302!
 /guide                            /guide/concepts/auto-imports 302!
 /guide/concepts                   /guide/concepts/auto-imports 302!
+/guide/directory-structure/utils  /guide/directory-structure/composables 302!
 
 # Concepts
 /concepts/introduction            /getting-started/introduction 302!

packages/nuxi/src/commands/dev.ts

@@ -131,7 +131,7 @@ export default defineNuxtCommand({
       const isDirChange = ['addDir', 'unlinkDir'].includes(event)
       const isFileChange = ['add', 'unlink'].includes(event)
       const pagesDir = resolve(currentNuxt.options.srcDir, currentNuxt.options.dir.pages)
-      const reloadDirs = ['components', 'composables'].map(d => resolve(currentNuxt.options.srcDir, d))
+      const reloadDirs = ['components', 'composables', 'utils'].map(d => resolve(currentNuxt.options.srcDir, d))
 
       if (isDirChange) {
         if (reloadDirs.includes(file)) {

packages/nuxt/src/imports/module.ts

@@ -59,6 +59,7 @@ export default defineNuxtModule<Partial<ImportsOptions>>({
     let composablesDirs: string[] = []
     for (const layer of nuxt.options._layers) {
       composablesDirs.push(resolve(layer.config.srcDir, 'composables'))
+      composablesDirs.push(resolve(layer.config.srcDir, 'utils'))
       for (const dir of (layer.config.imports?.dirs ?? [])) {
         if (!dir) {
           continue

packages/schema/src/types/imports.ts

@@ -13,7 +13,7 @@ export interface ImportsOptions extends UnimportOptions {
    * Directories to scan for auto imports.
    *
    * @see https://v3.nuxtjs.org/guide/directory-structure/composables/#how-files-are-scanned
-   * @default ['./composables']
+   * @default ['./composables', './utils']
    */
   dirs?: string[]