feat(kit): add prepend option to addImportsDir (#20307)

docs/3.api/4.advanced/2.kit.md

@@ -40,7 +40,7 @@ description: Nuxt Kit provides composable utilities to help interacting with Nux
 [source code](https://github.com/nuxt/nuxt/blob/main/packages/kit/src/imports.ts)
 
 - `addImports(imports)`
-- `addImportsDir(importDirs)`
+- `addImportsDir(importDirs, { prepend? })`
 - `addImportsSources(importSources)`
 
 ### Components

packages/kit/src/imports.ts

@@ -11,12 +11,12 @@ export function addImports (imports: Import | Import[]) {
   })
 }
 
-export function addImportsDir (dirs: string | string[]) {
+export function addImportsDir (dirs: string | string[], opts: { prepend?: boolean } = {}) {
   assertNuxtCompatibility({ bridge: true })
 
   useNuxt().hook('imports:dirs', (_dirs: string[]) => {
     for (const dir of (Array.isArray(dirs) ? dirs : [dirs])) {
-      _dirs.push(dir)
+      _dirs[opts.prepend ? 'unshift' : 'push'](dir)
     }
   })
 }