vite-plugin-dts 1.3.0 → 1.3.1

package/README.md

@@ -2,7 +2,7 @@
 
 **English** | [中文](./README.zh-CN.md)
 
-A vite plugin that generates declaration files (`*.d.ts`) from `.ts` or `.vue` source files when using vite in [library mode](https://vitejs.dev/guide/build.html#library-mode).
+A vite plugin that generates declaration files (`*.d.ts`) from `.ts(x)` or `.vue` source files when using vite in [library mode](https://vitejs.dev/guide/build.html#library-mode).
 
 ## Install
 
@@ -79,8 +79,9 @@ export interface PluginOptions {
   root?: string
 
   // Declaration files output directory
+  // Can be specified a array to output to multiple directories
   // Defaults base on your vite config output options
-  outputDir?: string
+  outputDir?: string | string[]
 
   // Manually set the root path of the entry files
   // The output path of each file will be caculated base on it
@@ -187,6 +188,21 @@ This is usually caused by using `defineComponent` function in both `script` and
 
 Here is a simple [example](https://github.com/qmhc/vite-plugin-dts/blob/main/example/components/BothScripts.vue), you should remove the `defineComponent` which in `script` and export a native object directly.
 
+### Take errors that unable to infer types from packages which under `node_modules`
+
+This is a exist issue when TypeScript inferring types from packages which under `node_modules` through soft links (pnpm), you can refer to this [issue](https://github.com/microsoft/TypeScript/issues/42873). Currently has a workaround that add `baseUrl` to your `tsconfig.json` and specify the `paths` for these packages:
+
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "third-lib": ["node_modules/third-lib"]
+    }
+  }
+}
+```
+
 ## License
 
 MIT License.

package/README.zh-CN.md

@@ -1,191 +1,207 @@
-# vite-plugin-dts
-
-**中文** | [English](./README.md)
-
-一款用于在 [库模式](https://cn.vitejs.dev/guide/build.html#library-mode) 中，从 `.ts` 或 `.vue` 源文件生成类型文件（`.d.ts`）的 Vite 插件。
-
-## 安装
-
-```sh
-pnpm add vite-plugin-dts -D
-```
-
-## 使用
-
-在 `vite.config.ts`:
-
-```ts
-import { resolve } from 'path'
-import { defineConfig } from 'vite'
-import dts from 'vite-plugin-dts'
-
-export default defineConfig({
-  build: {
-    lib: {
-      entry: resolve(__dirname, 'src/index.ts'),
-      name: 'MyLib',
-      formats: ['es'],
-      fileName: 'my-lib'
-    }
-  },
-  plugins: [dts()]
-})
-```
-
-在你的组件中:
-
-```vue
-<template>
-  <div></div>
-</template>
-
-<script lang="ts">
-// 使用 defineComponent 来进行类型推断
-import { defineComponent } from 'vue'
-
-export default defineComponent({
-  name: 'Component'
-})
-</script>
-```
-
-```vue
-<script setup lang="ts">
-// 尽管没有直接使用 props，你仍需要接收 defineProps 的返回值
-const props = defineProps<{
-  color: 'blue' | 'red'
-}>()
-</script>
-
-<template>
-  <div>{{ color }}</div>
-</template>
-```
-
-## 选项
-
-```ts
-import type { ts, Diagnostic } from 'ts-morph'
-
-interface TransformWriteFile {
-  filePath?: string
-  content?: string
-}
-
-export interface PluginOptions {
-  // 执行的根目录
-  // 默认基于 vite 配置的 root 选项
-  root?: string
-
-  // 声明文件的输出目录
-  // 默认基于 vite 配置的输出目录
-  outputDir?: string
-
-  // 用于手动设置入口文件的根路径
-  // 在计算每个文件的输出路径时将基于该路径
-  // 默认为所有文件的最小公共路径
-  entryRoot?: string
-
-  // 提供给 ts-morph Project 初始化的 compilerOptions 选项
-  // 默认值: null
-  compilerOptions?: ts.CompilerOptions | null
-
-  // 提供给 ts-morph Project 初始化的 tsconfig.json 路径
-  // 插件也会读取 tsconfig.json 的 incldue 和 exclude 选项来解析文件
-  // 默认值: 'tsconfig.json'
-  tsConfigFilePath?: string
-
-  // 是否将 '.vue.d.ts' 文件名转换为 '.d.ts'
-  // 默认值: false
-  cleanVueFileName?: boolean
-
-  //是否将动态引入转换为静态
-  // 当开启打包类型文件时强制为 true
-  // eg. 'import('vue').DefineComponent' 转换为 'import { DefineComponent } from "vue"'
-  // 默认值: false
-  staticImport?: boolean
-
-  // 手动设置包含路径的 glob
-  // 默认基于 tsconfig.json 的 include 选项
-  include?: string | string[]
-
-  // 手动设置排除路径的 glob
-  // 默认基于 tsconfig.json 的 exclude 选线，未设置时为 'node_module/**'
-  exclude?: string | string[]
-
-  // 是否生成类型声明入口
-  // 当为 true 时会基于 package.json 的 types 字段生成，或者 `${outputDir}/index.d.ts`
-  // 当开启打包类型文件时强制为 true
-  // 默认值: false
-  insertTypesEntry?: boolean
-
-  // 设置是否在发出类型文件后将其打包
-  // 基于 `@microsoft/api-extractor`，由于这开启了一个新的进程，将会消耗一些时间
-  // 默认值: false
-  rollupTypes?: boolean
-
-  // 是否将源码里的 .d.ts 文件复制到 outputDir
-  // 默认值: true
-  copyDtsFiles?: boolean
-
-  // 出现类型诊断信息时不生成类型文件
-  // 默认值: false
-  noEmitOnError?: boolean
-
-  // 是否跳过类型诊断
-  // 跳过类型诊断意味着出现错误时不会中断打包进程的执行
-  // 但对于出现错误的源文件，将无法生成相应的类型文件
-  // 默认值: true
-  skipDiagnostics?: boolean
-
-  // 是否打印类型诊断信息
-  // 当跳过类型诊断时该属性将不会生效
-  // 默认值: false
-  logDiagnostics?: boolean
-
-  // 获取诊断信息后的钩子
-  // 可以根据参数 length 来判断有误类型错误
-  // 默认值: () => {}
-  afterDiagnostic?: (diagnostics: Diagnostic[]) => void | Promise<void>
-
-  // 类型声明文件被写入前的钩子
-  // 可以在钩子里转换文件路径和文件内容
-  // 默认值: () => {}
-  beforeWriteFile?: (filePath: string, content: string) => void | TransformWriteFile
-
-  // 构建后回调钩子
-  // 将会在所有类型文件被写入后调用
-  // 默认值: () => {}
-  afterBuild?: () => void | Promise<void>
-}
-```
-
-## 示例
-
-克隆项目然后执行下列命令：
-
-```sh
-pnpm run test:e2e
-```
-
-然后检查 `example/types` 目录。
-
-## 常见问题
-
-此处将收录一些常见的问题并提供一些解决方案。
-
-### 打包后出现类型文件缺失
-
-默认情况下 `skipDiagnostics` 选项的值为 `true`，这意味着打包过程中将跳过类型检查（一些项目通常有 `vue-tsc` 等的类型检查工具），这时如果出现存在类型错误的文件，并且这是错误会中断打包过程，那么这些文件对应的类型文件将不会被生成。
-
-如果您的项目没有依赖外部的类型检查工具，这时候可以您可以设置 `skipDiagnostics: false` 和 `logDiagnostics: true` 来打开插件的诊断与输出功能，这将帮助您检查打包过程中出现的类型错误并将错误信息输出至终端。
-
-### Vue 组件中同时使用了 `script` 和 `setup-script` 后出现类型错误
-
-这通常是由于分别在 `script` 和 `setup-script` 中同时使用了 `defineComponent` 方法导致的。 `vue/compiler-sfc` 为这类文件编译时会将 `script` 中的默认导出结果合并到 `setup-script` 的 `defineComponent` 的参数定义中，而 `defineComponent` 的参数类型与结果类型并不兼容，这一行为将会导致类型错误。
-
-这是一个简单的[示例](https://github.com/qmhc/vite-plugin-dts/blob/main/example/components/BothScripts.vue)，您应该将位于 `script` 中的 `defineComponent` 方法移除，直接导出一个原始的对象。
-
-## 授权
-
-MIT 授权。
+# vite-plugin-dts
+
+**中文** | [English](./README.md)
+
+一款用于在 [库模式](https://cn.vitejs.dev/guide/build.html#library-mode) 中，从 `.ts(x)` 或 `.vue` 源文件生成类型文件（`.d.ts`）的 Vite 插件。
+
+## 安装
+
+```sh
+pnpm add vite-plugin-dts -D
+```
+
+## 使用
+
+在 `vite.config.ts`:
+
+```ts
+import { resolve } from 'path'
+import { defineConfig } from 'vite'
+import dts from 'vite-plugin-dts'
+
+export default defineConfig({
+  build: {
+    lib: {
+      entry: resolve(__dirname, 'src/index.ts'),
+      name: 'MyLib',
+      formats: ['es'],
+      fileName: 'my-lib'
+    }
+  },
+  plugins: [dts()]
+})
+```
+
+在你的组件中:
+
+```vue
+<template>
+  <div></div>
+</template>
+
+<script lang="ts">
+// 使用 defineComponent 来进行类型推断
+import { defineComponent } from 'vue'
+
+export default defineComponent({
+  name: 'Component'
+})
+</script>
+```
+
+```vue
+<script setup lang="ts">
+// 尽管没有直接使用 props，你仍需要接收 defineProps 的返回值
+const props = defineProps<{
+  color: 'blue' | 'red'
+}>()
+</script>
+
+<template>
+  <div>{{ color }}</div>
+</template>
+```
+
+## 选项
+
+```ts
+import type { ts, Diagnostic } from 'ts-morph'
+
+interface TransformWriteFile {
+  filePath?: string
+  content?: string
+}
+
+export interface PluginOptions {
+  // 执行的根目录
+  // 默认基于 vite 配置的 root 选项
+  root?: string
+
+  // 声明文件的输出目录
+  // 可以指定一个数组来输出到多个目录中
+  // 默认基于 vite 配置的输出目录
+  outputDir?: string | string[]
+
+  // 用于手动设置入口文件的根路径
+  // 在计算每个文件的输出路径时将基于该路径
+  // 默认为所有文件的最小公共路径
+  entryRoot?: string
+
+  // 提供给 ts-morph Project 初始化的 compilerOptions 选项
+  // 默认值: null
+  compilerOptions?: ts.CompilerOptions | null
+
+  // 提供给 ts-morph Project 初始化的 tsconfig.json 路径
+  // 插件也会读取 tsconfig.json 的 incldue 和 exclude 选项来解析文件
+  // 默认值: 'tsconfig.json'
+  tsConfigFilePath?: string
+
+  // 是否将 '.vue.d.ts' 文件名转换为 '.d.ts'
+  // 默认值: false
+  cleanVueFileName?: boolean
+
+  //是否将动态引入转换为静态
+  // 当开启打包类型文件时强制为 true
+  // eg. 'import('vue').DefineComponent' 转换为 'import { DefineComponent } from "vue"'
+  // 默认值: false
+  staticImport?: boolean
+
+  // 手动设置包含路径的 glob
+  // 默认基于 tsconfig.json 的 include 选项
+  include?: string | string[]
+
+  // 手动设置排除路径的 glob
+  // 默认基于 tsconfig.json 的 exclude 选线，未设置时为 'node_module/**'
+  exclude?: string | string[]
+
+  // 是否生成类型声明入口
+  // 当为 true 时会基于 package.json 的 types 字段生成，或者 `${outputDir}/index.d.ts`
+  // 当开启打包类型文件时强制为 true
+  // 默认值: false
+  insertTypesEntry?: boolean
+
+  // 设置是否在发出类型文件后将其打包
+  // 基于 `@microsoft/api-extractor`，由于这开启了一个新的进程，将会消耗一些时间
+  // 默认值: false
+  rollupTypes?: boolean
+
+  // 是否将源码里的 .d.ts 文件复制到 outputDir
+  // 默认值: true
+  copyDtsFiles?: boolean
+
+  // 出现类型诊断信息时不生成类型文件
+  // 默认值: false
+  noEmitOnError?: boolean
+
+  // 是否跳过类型诊断
+  // 跳过类型诊断意味着出现错误时不会中断打包进程的执行
+  // 但对于出现错误的源文件，将无法生成相应的类型文件
+  // 默认值: true
+  skipDiagnostics?: boolean
+
+  // 是否打印类型诊断信息
+  // 当跳过类型诊断时该属性将不会生效
+  // 默认值: false
+  logDiagnostics?: boolean
+
+  // 获取诊断信息后的钩子
+  // 可以根据参数 length 来判断有误类型错误
+  // 默认值: () => {}
+  afterDiagnostic?: (diagnostics: Diagnostic[]) => void | Promise<void>
+
+  // 类型声明文件被写入前的钩子
+  // 可以在钩子里转换文件路径和文件内容
+  // 默认值: () => {}
+  beforeWriteFile?: (filePath: string, content: string) => void | TransformWriteFile
+
+  // 构建后回调钩子
+  // 将会在所有类型文件被写入后调用
+  // 默认值: () => {}
+  afterBuild?: () => void | Promise<void>
+}
+```
+
+## 示例
+
+克隆项目然后执行下列命令：
+
+```sh
+pnpm run test:e2e
+```
+
+然后检查 `example/types` 目录。
+
+## 常见问题
+
+此处将收录一些常见的问题并提供一些解决方案。
+
+### 打包后出现类型文件缺失
+
+默认情况下 `skipDiagnostics` 选项的值为 `true`，这意味着打包过程中将跳过类型检查（一些项目通常有 `vue-tsc` 等的类型检查工具），这时如果出现存在类型错误的文件，并且这是错误会中断打包过程，那么这些文件对应的类型文件将不会被生成。
+
+如果您的项目没有依赖外部的类型检查工具，这时候可以您可以设置 `skipDiagnostics: false` 和 `logDiagnostics: true` 来打开插件的诊断与输出功能，这将帮助您检查打包过程中出现的类型错误并将错误信息输出至终端。
+
+### Vue 组件中同时使用了 `script` 和 `setup-script` 后出现类型错误
+
+这通常是由于分别在 `script` 和 `setup-script` 中同时使用了 `defineComponent` 方法导致的。 `vue/compiler-sfc` 为这类文件编译时会将 `script` 中的默认导出结果合并到 `setup-script` 的 `defineComponent` 的参数定义中，而 `defineComponent` 的参数类型与结果类型并不兼容，这一行为将会导致类型错误。
+
+这是一个简单的[示例](https://github.com/qmhc/vite-plugin-dts/blob/main/example/components/BothScripts.vue)，您应该将位于 `script` 中的 `defineComponent` 方法移除，直接导出一个原始的对象。
+
+### 打包时出现了无法从 `node_modules` 的包中推断类型的错误
+
+这是 TypeScript 通过软链接 (pnpm) 读取 `node_modules` 中过的类型时会出现的一个已知的问题，可以参考这个 [issue](https://github.com/microsoft/TypeScript/issues/42873)，目前已有的一个解决方案，在你的 `tsconfig.json` 中添加 `baseUrl` 以及在 `paths` 添加这些包的路径：
+
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "third-lib": ["node_modules/third-lib"]
+    }
+  }
+}
+```
+
+## 授权
+
+MIT 授权。

package/dist/index.js

@@ -438,6 +438,7 @@ function dtsPlugin(options = {}) {
   const compilerOptions = (_a = options.compilerOptions) != null ? _a : {};
   let root;
   let entryRoot = (_b = options.entryRoot) != null ? _b : "";
+  let libName;
   let indexName;
   let aliases;
   let entries;
@@ -481,9 +482,11 @@ function dtsPlugin(options = {}) {
         logger.warn(import_chalk.default.yellow(`
 ${import_chalk.default.cyan("[vite:dts]")} You building not a library that may not need to generate declaration files.
 `));
+        libName = "_default";
         indexName = defaultIndex;
       } else {
         const filename = (_a2 = config.build.lib.fileName) != null ? _a2 : defaultIndex;
+        libName = config.build.lib.name || "_default";
         indexName = typeof filename === "string" ? filename : filename("es");
         if (!dtsRE2.test(indexName)) {
           indexName = `${tjsRE.test(indexName) ? indexName.replace(tjsRE, "") : indexName}.d.ts`;
@@ -647,11 +650,20 @@ ${logPrefix} Start generate declaration files...`));
         let typesPath = types ? (0, import_path4.resolve)(root, types) : (0, import_path4.resolve)(outputDir, indexName);
         if (!import_fs_extra.default.existsSync(typesPath)) {
           const entry = entries[0];
-          let filePath = (0, import_vite2.normalizePath)((0, import_path4.relative)((0, import_path4.dirname)(typesPath), (0, import_path4.resolve)(outputDir, (0, import_path4.relative)(entryRoot, entry))));
-          filePath = filePath.replace(tsRE, "");
+          const outputIndex = (0, import_path4.resolve)(outputDir, (0, import_path4.relative)(entryRoot, entry.replace(tsRE, ".d.ts")));
+          let filePath = (0, import_vite2.normalizePath)((0, import_path4.relative)((0, import_path4.dirname)(typesPath), outputIndex));
+          filePath = filePath.replace(dtsRE2, "");
           filePath = fullRelativeRE.test(filePath) ? filePath : `./${filePath}`;
           let content = `export * from '${filePath}'
 `;
+          if (import_fs_extra.default.existsSync(outputIndex)) {
+            const entryCodes = await import_fs_extra.default.readFile(outputIndex, "utf-8");
+            if (entryCodes.includes("export default")) {
+              content += `import ${libName} from '${filePath}'
+export default ${libName}
+`;
+            }
+          }
           if (typeof beforeWriteFile === "function") {
             const result = beforeWriteFile(typesPath, content);
             if (result && isNativeObj(result)) {
@@ -660,6 +672,7 @@ ${logPrefix} Start generate declaration files...`));
             }
           }
           await import_fs_extra.default.writeFile(typesPath, content, "utf-8");
+          wroteFiles.add((0, import_vite2.normalizePath)(typesPath));
         }
         bundleDebug("insert index");
         if (rollupTypes) {

package/dist/index.mjs

@@ -420,6 +420,7 @@ function dtsPlugin(options = {}) {
   const compilerOptions = (_a = options.compilerOptions) != null ? _a : {};
   let root;
   let entryRoot = (_b = options.entryRoot) != null ? _b : "";
+  let libName;
   let indexName;
   let aliases;
   let entries;
@@ -463,9 +464,11 @@ function dtsPlugin(options = {}) {
         logger.warn(chalk.yellow(`
 ${chalk.cyan("[vite:dts]")} You building not a library that may not need to generate declaration files.
 `));
+        libName = "_default";
         indexName = defaultIndex;
       } else {
         const filename = (_a2 = config.build.lib.fileName) != null ? _a2 : defaultIndex;
+        libName = config.build.lib.name || "_default";
         indexName = typeof filename === "string" ? filename : filename("es");
         if (!dtsRE2.test(indexName)) {
           indexName = `${tjsRE.test(indexName) ? indexName.replace(tjsRE, "") : indexName}.d.ts`;
@@ -629,11 +632,20 @@ ${logPrefix} Start generate declaration files...`));
         let typesPath = types ? resolve3(root, types) : resolve3(outputDir, indexName);
         if (!fs.existsSync(typesPath)) {
           const entry = entries[0];
-          let filePath = normalizePath2(relative2(dirname3(typesPath), resolve3(outputDir, relative2(entryRoot, entry))));
-          filePath = filePath.replace(tsRE, "");
+          const outputIndex = resolve3(outputDir, relative2(entryRoot, entry.replace(tsRE, ".d.ts")));
+          let filePath = normalizePath2(relative2(dirname3(typesPath), outputIndex));
+          filePath = filePath.replace(dtsRE2, "");
           filePath = fullRelativeRE.test(filePath) ? filePath : `./${filePath}`;
           let content = `export * from '${filePath}'
 `;
+          if (fs.existsSync(outputIndex)) {
+            const entryCodes = await fs.readFile(outputIndex, "utf-8");
+            if (entryCodes.includes("export default")) {
+              content += `import ${libName} from '${filePath}'
+export default ${libName}
+`;
+            }
+          }
           if (typeof beforeWriteFile === "function") {
             const result = beforeWriteFile(typesPath, content);
             if (result && isNativeObj(result)) {
@@ -642,6 +654,7 @@ ${logPrefix} Start generate declaration files...`));
             }
           }
           await fs.writeFile(typesPath, content, "utf-8");
+          wroteFiles.add(normalizePath2(typesPath));
         }
         bundleDebug("insert index");
         if (rollupTypes) {

package/package.json

@@ -93,5 +93,5 @@
     "test:e2e": "cd example && cross-env DEBUG=\"vite-plugin-dts:bundle\" vite build"
   },
   "types": "dist/index.d.ts",
-  "version": "1.3.0"
+  "version": "1.3.1"
 }