feat: support override the config of api-extractor

Author: qmhc

README.md

@@ -80,10 +80,19 @@ This is an existing [TypeScript issue](https://github.com/microsoft/TypeScript/i
 
 ```ts
 import type ts from 'typescript'
+import type { IExtractorConfigPrepareOptions } from '@microsoft/api-extractor'
 import type { LogLevel } from 'vite'
 
 type MaybePromise<T> = T | Promise<T>
 
+export type RollupConfig = Omit<
+  IExtractorConfigPrepareOptions['configObject'],
+  | 'projectFolder'
+  | 'mainEntryPointFilePath'
+  | 'compiler'
+  | 'dtsRollup'
+  >
+
 export interface Resolver {
   /**
    * The name of the resolver
@@ -251,6 +260,14 @@ export interface PluginOptions {
    */
   bundledPackages?: string[],
 
+  /**
+   * Override the config of `@microsoft/api-extractor`
+   *
+   * @default null
+   * @see https://api-extractor.com/pages/setup/configure_api_report/
+   */
+  rollupConfig?: RollupConfig,
+
   /**
    * Whether to copy .d.ts source files to `outDir`
    *

README.zh-CN.md

@@ -80,10 +80,19 @@ export default defineConfig({
 
 ```ts
 import type ts from 'typescript'
+import type { IExtractorConfigPrepareOptions } from '@microsoft/api-extractor'
 import type { LogLevel } from 'vite'
 
 type MaybePromise<T> = T | Promise<T>
 
+export type RollupConfig = Omit<
+  IExtractorConfigPrepareOptions['configObject'],
+  | 'projectFolder'
+  | 'mainEntryPointFilePath'
+  | 'compiler'
+  | 'dtsRollup'
+  >
+
 export interface Resolver {
   /**
    * 解析器的名称
@@ -251,6 +260,14 @@ export interface PluginOptions {
    */
   bundledPackages?: string[],
 
+  /**
+   * 覆写 `@microsoft/api-extractor` 的配置
+   *
+   * @default null
+   * @see https://api-extractor.com/pages/setup/configure_api_report/
+   */
+  rollupConfig?: RollupConfig,
+
   /**
    * 是否将源码里的 .d.ts 文件复制到 `outDir`
    *

examples/vue/.gitignore

@@ -2,3 +2,4 @@ types/
 dist/
 node_modules/
 components/*.d.ts
+docs/

examples/vue/vite.config.ts

@@ -38,10 +38,16 @@ export default defineConfig({
       // include: ['src/index.ts'],
       exclude: ['src/ignore'],
       staticImport: true,
-      // rollupTypes: true,
-      insertTypesEntry: true,
+      rollupTypes: true,
+      // insertTypesEntry: true,
       compilerOptions: {
         declarationMap: true
+      },
+      rollupConfig: {
+        docModel: {
+          enabled: true,
+          apiJsonFilePath: '<projectFolder>/docs/<unscopedPackageName>.api.json'
+        }
       }
     }),
     vue(),

src/plugin.ts

@@ -73,7 +73,6 @@ export function dtsPlugin(options: PluginOptions = {}): import('vite').Plugin {
     cleanVueFileName = false,
     insertTypesEntry = false,
     rollupTypes = false,
-    bundledPackages = [],
     pathsToAliases = true,
     aliasesExclude = [],
     copyDtsFiles = false,
@@ -116,6 +115,9 @@ export function dtsPlugin(options: PluginOptions = {}): import('vite').Plugin {
   const rootFiles = new Set<string>()
   const outputFiles = new Map<string, string>()
 
+  const rollupConfig = { ...(options.rollupConfig || {}) }
+  rollupConfig.bundledPackages = rollupConfig.bundledPackages || options.bundledPackages || []
+
   return {
     name: 'vite:dts',
 
@@ -606,7 +608,7 @@ export function dtsPlugin(options: PluginOptions = {}): import('vite').Plugin {
                 entryPath: path,
                 fileName: basename(path),
                 libFolder,
-                bundledPackages
+                rollupConfig
               })
 
               emittedFiles.delete(path)
@@ -621,7 +623,7 @@ export function dtsPlugin(options: PluginOptions = {}): import('vite').Plugin {
               entryPath: typesPath,
               fileName: basename(typesPath),
               libFolder,
-              bundledPackages
+              rollupConfig
             })
 
             emittedFiles.delete(typesPath)

src/rollup.ts

@@ -3,8 +3,9 @@ import { resolve } from 'node:path'
 import { Extractor, ExtractorConfig } from '@microsoft/api-extractor'
 import { tryGetPkgPath } from './utils'
 
-import type { ExtractorLogLevel } from '@microsoft/api-extractor'
 import type ts from 'typescript'
+import type { ExtractorLogLevel } from '@microsoft/api-extractor'
+import type { RollupConfig } from './types'
 
 export interface BundleOptions {
   root: string,
@@ -14,7 +15,7 @@ export interface BundleOptions {
   entryPath: string,
   fileName: string,
   libFolder?: string,
-  bundledPackages?: string[]
+  rollupConfig?: RollupConfig
 }
 
 const dtsRE = /\.d\.tsx?$/
@@ -27,7 +28,7 @@ export function rollupDeclarationFiles({
   entryPath,
   fileName,
   libFolder,
-  bundledPackages
+  rollupConfig = {}
 }: BundleOptions) {
   const configObjectFullPath = resolve(root, 'api-extractor.json')
 
@@ -37,9 +38,9 @@ export function rollupDeclarationFiles({
 
   const extractorConfig = ExtractorConfig.prepare({
     configObject: {
+      ...rollupConfig,
       projectFolder: root,
       mainEntryPointFilePath: entryPath,
-      bundledPackages,
       compiler: {
         tsconfigFilePath: configPath,
         overrideTsconfig: {
@@ -49,17 +50,20 @@ export function rollupDeclarationFiles({
       },
       apiReport: {
         enabled: false,
-        reportFileName: '<unscopedPackageName>.api.md'
+        reportFileName: '<unscopedPackageName>.api.md',
+        ...rollupConfig.apiReport
       },
       docModel: {
-        enabled: false
+        enabled: false,
+        ...rollupConfig.docModel
       },
       dtsRollup: {
         enabled: true,
         publicTrimmedFilePath: resolve(outDir, fileName)
       },
       tsdocMetadata: {
-        enabled: false
+        enabled: false,
+        ...rollupConfig.tsdocMetadata
       },
       messages: {
         compilerMessageReporting: {
@@ -71,7 +75,8 @@ export function rollupDeclarationFiles({
           default: {
             logLevel: 'none' as ExtractorLogLevel.None
           }
-        }
+        },
+        ...rollupConfig.messages
       }
     },
     configObjectFullPath,

src/types.ts

@@ -1,8 +1,14 @@
 import type ts from 'typescript'
+import type { IExtractorConfigPrepareOptions } from '@microsoft/api-extractor'
 import type { LogLevel } from 'vite'
 
 type MaybePromise<T> = T | Promise<T>
 
+export type RollupConfig = Omit<
+  IExtractorConfigPrepareOptions['configObject'],
+  'projectFolder' | 'mainEntryPointFilePath' | 'compiler' | 'dtsRollup'
+>
+
 export interface Resolver {
   /**
    * The name of the resolver
@@ -170,6 +176,14 @@ export interface PluginOptions {
    */
   bundledPackages?: string[],
 
+  /**
+   * Override the config of `@microsoft/api-extractor`
+   *
+   * @default null
+   * @see https://api-extractor.com/pages/setup/configure_api_report/
+   */
+  rollupConfig?: RollupConfig,
+
   /**
    * Whether to copy .d.ts source files to `outDir`
    *