fix: should dynamic load api-extractor when bundling

fix #435

Author: qmhc

README.md

@@ -222,6 +222,7 @@ await build({
 </details>
 
 <br />
+
 By default, the generated declaration files are following the source structure.
 
 Fortunately, with the help of [API Extractor](https://api-extractor.com/), the plugin can bundle all types into a single file. You just need to install `@microsoft/api-extractor` and set `bundleTypes: true`:

README.zh-CN.md

@@ -222,6 +222,7 @@ await build({
 </details>
 
 <br />
+
 默认情况，生成的类型文件会跟随源文件的结构。
 
 好在插件借助 [API Extractor](https://api-extractor.com/) 提供了汇总所有类型到一个文件的能力，只需安装 `@microsoft/api-extractor` 并指定 `bundleTypes: true`：

packages/unplugin-dts/src/core/bundle.ts

@@ -1,5 +1,4 @@
-import { Extractor, ExtractorConfig } from '@microsoft/api-extractor'
-import { resolve, tryGetPkgPath } from './utils'
+import { resolve, tryGetPackageInfo, tryGetPkgPath } from './utils'
 
 import type { ExtractorLogLevel, IExtractorInvokeOptions } from '@microsoft/api-extractor'
 import type { BundleConfig } from './types'
@@ -17,9 +16,15 @@ export interface BundleDtsOptions {
   invokeOptions?: IExtractorInvokeOptions
 }
 
+let hasExtractor: boolean | undefined
+
+export function getHasExtractor() {
+  return typeof hasExtractor !== 'undefined' ? hasExtractor : (hasExtractor = !!tryGetPackageInfo('@microsoft/api-extractor'))
+}
+
 const dtsRE = /\.d\.(m|c)?tsx?$/
 
-export function bundleDtsFiles({
+export async function bundleDtsFiles({
   root,
   configPath,
   compilerOptions,
@@ -31,6 +36,8 @@ export function bundleDtsFiles({
   bundledPackages,
   invokeOptions = {},
 }: BundleDtsOptions) {
+  const { Extractor, ExtractorConfig } = await import('@microsoft/api-extractor')
+
   const configObjectFullPath = resolve(root, 'api-extractor.json')
 
   if (!dtsRE.test(fileName)) {

packages/unplugin-dts/src/core/runtime.ts

@@ -5,11 +5,11 @@ import { cpus } from 'node:os'
 
 import ts from 'typescript'
 import { createFilter } from '@rollup/pluginutils'
-import { green, yellow } from 'kolorist'
+import { green, red, yellow } from 'kolorist'
 import { loadProgramProcesses } from './program'
 import { JsonResolver, SvelteResolver, VueResolver, parseResolvers } from './resolvers'
 import { hasExportDefault, hasNormalExport, normalizeGlob, transformCode } from './transform'
-import { bundleDtsFiles } from './bundle'
+import { bundleDtsFiles, getHasExtractor } from './bundle'
 import {
   defaultIndex,
   dtsRE,
@@ -657,58 +657,67 @@ export class Runtime {
       handleDebug('insert index')
 
       if (bundleTypes) {
-        logger.info(green(`${logPrefix} Start rollup declaration files...`))
-  
-        const rollupFiles = new Set<string>()
-        const compilerOptions = configPath
-          ? getTsConfig(configPath, this.host.readFile).compilerOptions
-          : rawCompilerOptions
-  
-        const rollup = async (path: string) => {
-          const result = bundleDtsFiles({
-            root,
-            configPath,
-            compilerOptions,
-            outDir,
-            entryPath: path,
-            fileName: basename(path),
-            libFolder: getTsLibFolder(),
-            extractorConfig,
-            bundledPackages,
-            invokeOptions,
-          })
-  
-          emittedFiles.delete(path)
-          rollupFiles.add(path)
-  
-          if (typeof afterRollup === 'function') {
-            await unwrapPromise(afterRollup(result))
+        logger.info(green(`${logPrefix} Start bundling declaration files...`))
+
+        if (!getHasExtractor()) {
+          logger.error(
+            `\n${logPrefix} ${red("Failed to load '@microsoft/api-extractor', have you installed it?")}\n`,
+          )
+          logger.warn(
+            `\n${logPrefix} ${yellow('Error occurred, skip bundle declaration files.')}\n`,
+          )
+        } else {
+          const rollupFiles = new Set<string>()
+          const compilerOptions = configPath
+            ? getTsConfig(configPath, this.host.readFile).compilerOptions
+            : rawCompilerOptions
+    
+          const rollup = async (path: string) => {
+            const result = await bundleDtsFiles({
+              root,
+              configPath,
+              compilerOptions,
+              outDir,
+              entryPath: path,
+              fileName: basename(path),
+              libFolder: getTsLibFolder(),
+              extractorConfig,
+              bundledPackages,
+              invokeOptions,
+            })
+    
+            emittedFiles.delete(path)
+            rollupFiles.add(path)
+    
+            if (typeof afterRollup === 'function') {
+              await unwrapPromise(afterRollup(result))
+            }
           }
-        }
-  
-        if (multiple) {
-          await runParallel(cpus().length, entryNames, async name => {
-            await rollup(cleanPath(resolve(outDir, tsToDts(name)), emittedFiles))
+    
+          if (multiple) {
+            await runParallel(cpus().length, entryNames, async name => {
+              await rollup(cleanPath(resolve(outDir, tsToDts(name)), emittedFiles))
+            })
+          } else {
+            await rollup(typesPath)
+          }
+    
+          await runParallel(cpus().length, Array.from(emittedFiles.keys()), f => unlink(f))
+          removeDirIfEmpty(outDir)
+          emittedFiles.clear()
+    
+          const declared = declareModules.join('\n')
+    
+          await runParallel(cpus().length, [...rollupFiles], async filePath => {
+            await writeOutput(
+              filePath,
+              (await readFile(filePath, 'utf-8')) + (declared ? `\n${declared}` : ''),
+              dirname(filePath),
+            )
           })
-        } else {
-          await rollup(typesPath)
+    
+          handleDebug('rollup output')
         }
-  
-        await runParallel(cpus().length, Array.from(emittedFiles.keys()), f => unlink(f))
-        removeDirIfEmpty(outDir)
-        emittedFiles.clear()
-  
-        const declared = declareModules.join('\n')
-  
-        await runParallel(cpus().length, [...rollupFiles], async filePath => {
-          await writeOutput(
-            filePath,
-            (await readFile(filePath, 'utf-8')) + (declared ? `\n${declared}` : ''),
-            dirname(filePath),
-          )
-        })
-  
-        handleDebug('rollup output')
       }
     }