feat(auto-import): custom include option

[antfu]

🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Allowing auto import / components to work with custom extension files.

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[netlify]

✅ Deploy Preview for nuxt3-docs canceled.

Name	Link
🔨 Latest commit	ec13db4
🔍 Latest deploy log	https://app.netlify.com/sites/nuxt3-docs/deploys/6274e4cbf047630008ccf1d1

[pi0]

The new option looks good to me but can you please elaborate more about "to work with custom extension files" usecase?

[antfu]

Here is an example, in UnoCSS's docs, we'd like to use markdown files as Vue components so we installed vite-plugin-md to transform md to Vue SFC and let Vue's compiler handle the rest. We could configure Vue by this so it treats .md as Vue SFC:

https://github.com/antfu/unocss/blob/9a2bed77e8a3433454aab66f9c3ea2b2bbb7bcf6/interactive/nuxt.config.ts#L33-L35

https://github.com/antfu/unocss/blob/6aa5f9fad9dda65ffceef1455566b4233f7db278/interactive/modules/markdown.ts

With this we could get it work, but the .md will not be processed by auto imports thus you lost the capability of using components in the markdown. This PR simply expose those options for that capability.

[pi0]

Thanks for explaining @antfu. What do you think to integrate include option to auto-include options.extensions

[antfu]

For API auto import I think it might make sense, but probably not for Components right?

Or should we have options.vueExtensions that we also pass to Vue's compiler?

[pi0]

probably not for Components right?

It could be also useful for building components with markdown (https://mdxjs.com/https://mdx.nuxtjs.org/)