feat(kit): support prepend option for addComponentsDir

[sadeghbarati]

🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation, readme or JSdoc annotations)
• 🐞 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)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Default Nuxt config for auto-import directories

[
  { priority: 1, path: 'D:/Test/nuxt-test/components/islands', island: true },
  { priority: 1, path: 'D:/Test/nuxt-test/components/global', global: true },
  { priority: 1, path: 'D:/Test/nuxt-test/components' },
]

In Nuxt website it's says

You can also selectively register some components globally by placing them in a ~/components/global directory.

But if I add components.dirs[] options in nuxt.config.ts default config will disposed, and in order to have global directory I have to define it again

components: {
    dirs: [
        {
          path: '~/components/ui',
          prefix: 'Ui',
          pathPrefix: false
        }
    ]
}

I want to add a new dir to auto-import directories, to keep the default auto-import directories I prefer using

• "components:dirs" hooks (nuxt.config and defineNuxtModule)
• addComponentsDir in setup function (defineNuxtModule)

In the hook way, I can push/unshift directories but in addComponentsDir way it only has the push method

📝 Checklist

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

[stackblitz]

Run & review this pull request in StackBlitz Codeflow.

[sadeghbarati]

Sry for trouble 🙏

BTW how can I change the branch name while in PR?

[danielroe]

No problem - and don't worry about the branch name...

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

❗ No coverage uploaded for pull request base (main@37d64a6). Click here to learn what that means.

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #24309   +/-   ##
=======================================
  Coverage        ?   58.76%           
=======================================
  Files           ?        5           
  Lines           ?      861           
  Branches        ?       46           
=======================================
  Hits            ?      506           
  Misses          ?      355           
  Partials        ?        0           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.