feat: support emit declaration files only (#253)

* feat: support only output dts

* chore: update api docs

---------

Co-authored-by: qmhc <40221744+qmhc@users.noreply.github.com>

README.md

@@ -286,6 +286,15 @@ export interface PluginOptions {
    */
   copyDtsFiles?: boolean,
 
+  /**
+   * Whether to emit declaration files only
+   *
+   * When `true`, all the original outputs of vite (rollup) will be force removed
+   *
+   * @default false
+   */
+  declarationOnly?: boolean,
+
   /**
    * Logging level for this plugin
    *

README.zh-CN.md

@@ -286,6 +286,15 @@ export interface PluginOptions {
    */
   copyDtsFiles?: boolean,
 
+  /**
+   * 是否只生成类型文件
+   *
+   * 当为 `true` 时会强制删除所有 Vite（Rollup）的原始产物
+   *
+   * @default false
+   */
+  declarationOnly?: boolean,
+
   /**
    * 指定插件的输出等级
    *

examples/ts/vite.config.ts

@@ -27,7 +27,8 @@ export default defineConfig({
       // aliasesExclude: [/^@components/],
       staticImport: true,
       // insertTypesEntry: true,
-      rollupTypes: true
+      rollupTypes: true,
+      declarationOnly: true
     })
   ]
 })

src/plugin.ts

@@ -76,6 +76,7 @@ export function dtsPlugin(options: PluginOptions = {}): import('vite').Plugin {
     pathsToAliases = true,
     aliasesExclude = [],
     copyDtsFiles = false,
+    declarationOnly = false,
     strictOutput = true,
     afterDiagnostic = noop,
     beforeWriteFile = noop,
@@ -691,6 +692,13 @@ export function dtsPlugin(options: PluginOptions = {}): import('vite').Plugin {
       logger.info(
         green(`${logPrefix} Declaration files built in ${timeRecord + Date.now() - startTime}ms.\n`)
       )
+    },
+    generateBundle(_, bundle) {
+      if (declarationOnly) {
+        for (const id of Object.keys(bundle)) {
+          delete bundle[id]
+        }
+      }
     }
   }
 }

src/types.ts

@@ -192,6 +192,15 @@ export interface PluginOptions {
    */
   copyDtsFiles?: boolean,
 
+  /**
+   * Whether to emit declaration files only
+   *
+   * When `true`, all the original outputs of vite (rollup) will be force removed
+   *
+   * @default false
+   */
+  declarationOnly?: boolean,
+
   /**
    * Logging level for this plugin
    *