nuxt · danielroe · May 9, 2023
@@ -8,7 +8,7 @@ import { defineNuxtCommand } from './index'
 export default defineNuxtCommand({
   meta: {
     name: 'prepare',
-    usage: 'npx nuxi prepare [--log-level] [rootDir]',
+    usage: 'npx nuxi prepare [--log-level] [--module] [rootDir]',
     description: 'Prepare nuxt for development/build'
   },
   async invoke (args) {
@@ -20,7 +20,10 @@ export default defineNuxtCommand({
       rootDir,
       overrides: {
         _prepare: true,
-        logLevel: args['log-level']
+        logLevel: args['log-level'],
+        experimental: {
+          moduleBuilderMode: 'module' in args
+        }
       }
     })
     await clearBuildDir(nuxt.options.buildDir)

@@ -48,7 +48,7 @@ export async function generateApp (nuxt: Nuxt, app: NuxtApp, options: { filter?:
         nuxt.vfs[fullPath.replace(/\//g, '\\')] = contents
       }
 
-      if (template.write) {
+      if (template.write || nuxt.options.experimental.moduleBuilderMode) {
         await fsp.mkdir(dirname(fullPath), { recursive: true })
         await fsp.writeFile(fullPath, contents, 'utf8')
       }

@@ -161,7 +161,7 @@ function addDeclarationTemplates (ctx: Unimport, options: Partial<ImportsOptions
   addTemplate({
     filename: 'types/imports.d.ts',
     getContents: async () => '// Generated by auto imports\n' + (
-      options.autoImport
+      options.autoImport && !nuxt.options.experimental.moduleBuilderMode
         ? await ctx.generateTypeDeclarations({ resolvePath: r })
         : '// Implicit auto importing is disabled, you can use explicitly import from `#imports` instead.'
     )

@@ -39,6 +39,7 @@
   "dependencies": {
     "defu": "^6.1.2",
     "hookable": "^5.5.3",
+    "mlly": "^1.2.0",
     "pathe": "^1.1.0",
     "pkg-types": "^1.0.3",
     "postcss-import-resolver": "^2.0.0",

@@ -1,5 +1,6 @@
 import { defineUntypedSchema } from 'untyped'
 import { join, resolve } from 'pathe'
+import { resolvePath } from 'mlly'
 import { isDebug, isDevelopment } from 'std-env'
 import { defu } from 'defu'
 import { findWorkspaceDir } from 'pkg-types'
@@ -145,7 +146,7 @@ export default defineUntypedSchema({
    * If a relative path is specified, it will be relative to your `rootDir`.
    */
   analyzeDir: {
-    $resolve: async (val, get) => val 
+    $resolve: async (val, get) => val
       ? resolve(await get('rootDir'), val)
       : resolve(await get('buildDir'), 'analyze')
   },
@@ -208,7 +209,16 @@ export default defineUntypedSchema({
    * @type {(typeof import('../src/types/module').NuxtModule | string | [typeof import('../src/types/module').NuxtModule | string, Record<string, any>] | undefined | null | false)[]}
    */
   modules: {
-    $resolve: val => [].concat(val).filter(Boolean)
+    $resolve: async (val, get) => {
+      const modules = ([] as string[]).concat(val)
+      if (await get('experimental.moduleBuilderMode')) {
+        const path = await resolvePath("./src/module", { url: await get('rootDir'), extensions: await get('extensions') }).catch(() => null)
+        if (path) {
+          modules.push(path)
+        }
+      }
+      return modules.filter(Boolean)
+    }
   },
 
   /**

@@ -159,6 +159,13 @@ export default defineUntypedSchema({
     /** Enable the new experimental typed router using [unplugin-vue-router](https://github.com/posva/unplugin-vue-router). */
     typedPages: false,
 
+    /**
+     * Enable 'module builder' mode which sets up a number of features specifically for module authors.
+     */
+    moduleBuilderMode: {
+      $resolve: async (val, get) => val ?? false
+    },
+
     /**
      * Set an alternative watcher that will be used as the watching service for Nuxt.
      *