allow disabling auto imports

Describe the feature

First mentioned here by @nikolay-zoteev and @cawa-93 in https://github.com/nuxt/framework/discussions/2271.

I would like to be able to disable auto import, so I can make explicit imports from respective vendor library required in the codebase.

import { ref } from '#imports'

Would become:

import { ref } from 'vue'

Additional, from https://github.com/nuxt/framework/discussions/2271#discussioncomment-2906232:

I still need a reliable and documented way to turn off auto-import.

• Auto-import does not work for the server part
• Auto-import doesn’t work for everyone. You still have business logic modules, helpers, utilities, services that you have to import on your own (actually IDE will do everything for you).
• Only top level files can be auto-imported.
• Auto-import of asynchronous components (such as those created by defineAsyncComponent) is not possible.

In addition

• Auto-import complicates IDE code analysis (jet brains have issues with deep import analysis)
• It takes twice as long to go from calling a component to declaring it

Additional information

• Would you be willing to help implement this feature?
• Could this feature be implemented as a module?

Final checks

• Read the contribution guide.
• Check existing discussions and issues.

[antfu]

In addition to @danielroe’s note:

Only top level files can be auto-imported.

Supported since https://github.com/nuxt/framework/pull/6025

[danielroe]

This is a reasonable request, but just to address some of your comments:

Only top level files can be auto-imported.

You can configure this with autoImports.dirs

Auto-import does not work for the server part

Auto imports can be configured for nitro within nitro.autoImport

Auto-import of asynchronous components

You can use resolveComponent('SomeAsyncComponent') if they are registered or marked as global components.