feat: introduce dumpUnimportItems option

.gitignore

@@ -81,5 +81,5 @@ dist
 .idea
 auto-imports.d.ts
 .eslintrc-auto-import.json
-
-.vscode
+.unimport-items.json
+.vscode

README.md

@@ -331,6 +331,9 @@ AutoImport({
     enabled: false, // Default `false`
     filepath: './.biomelintrc-auto-import.json', // Default `./.biomelintrc-auto-import.json`
   },
+
+  // Save unimport items into a JSON file for other tools to consume
+  dumpUnimportItems: './auto-imports.json', // Default `false`
 })
 ```
 

playground/vite.config.ts

@@ -23,6 +23,7 @@ export default defineConfig({
           return normalizeImportFrom.includes('/directives/')
         },
       },
+      dumpUnimportItems: true,
     }),
   ],
 })

src/core/ctx.ts

@@ -52,6 +52,10 @@ export function createContext(options: Options = {}, root = process.cwd()) {
   biomelintrc.enabled = biomelintrc.enabled !== undefined
   biomelintrc.filepath = biomelintrc.filepath || './.biomelintrc-auto-import.json'
 
+  const dumpUnimportItems = options.dumpUnimportItems === true
+    ? './.unimport-items.json'
+    : options.dumpUnimportItems ?? false
+
   const resolvers = options.resolvers ? [options.resolvers].flat(2) : []
 
   // When "options.injectAtEnd" is undefined or true, it's true.
@@ -201,6 +205,7 @@ ${dts}`.trim()}\n`
   let lastDTS: string | undefined
   let lastESLint: string | undefined
   let lastBiomeLint: string | undefined
+  let lastUnimportItems: string | undefined
 
   async function writeConfigFiles() {
     const promises: any[] = []
@@ -243,6 +248,20 @@ ${dts}`.trim()}\n`
       )
     }
 
+    if (dumpUnimportItems) {
+      promises.push(
+        unimport.getImports().then((items) => {
+          if (!dumpUnimportItems)
+            return
+          const content = JSON.stringify(items, null, 2)
+          if (content !== lastUnimportItems) {
+            lastUnimportItems = content
+            return writeFile(dumpUnimportItems, content)
+          }
+        }),
+      )
+    }
+
     return Promise.all(promises)
   }
 

src/types.ts

@@ -199,6 +199,16 @@ export interface Options {
    */
   biomelintrc?: BiomeLintrc
 
+  /**
+   * Save unimport items into a JSON file for other tools to consume.
+   * Provide a filepath to save the JSON file.
+   *
+   * When set to `true`, it will save to `./.unimport-items.json`
+   *
+   * @default false
+   */
+  dumpUnimportItems?: boolean | string
+
   /**
    * Include auto-imported packages in Vite's `optimizeDeps` option
    *