vite-plugin-dts 0.9.9 → 0.9.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,180 +1,180 @@
1
- # vite-plugin-dts
2
-
3
- **English** | [中文](./README.zh-CN.md)
4
-
5
- A vite plugin that generate `.d.ts` files from `.ts` or `.vue` source files for lib.
6
-
7
- ## Install
8
-
9
- ```sh
10
- pnpm add vite-plugin-dts -D
11
- ```
12
-
13
- ## Usage
14
-
15
- In `vite.config.ts`:
16
-
17
- ```ts
18
- import { resolve } from 'path'
19
- import { defineConfig } from 'vite'
20
- import dts from 'vite-plugin-dts'
21
-
22
- export default defineConfig({
23
- build: {
24
- lib: {
25
- entry: resolve(__dirname, 'src/index.ts'),
26
- name: 'MyLib',
27
- formats: ['es'],
28
- fileName: 'my-lib'
29
- }
30
- },
31
- plugins: [dts()]
32
- })
33
- ```
34
-
35
- In your component:
36
-
37
- ```vue
38
- <template>
39
- <div></div>
40
- </template>
41
-
42
- <script lang="ts">
43
- // using defineComponent for inferring types
44
- import { defineComponent } from 'vue'
45
-
46
- export default defineComponent({
47
- name: 'Component'
48
- })
49
- </script>
50
- ```
51
-
52
- ```vue
53
- <script setup lang="ts">
54
- // Need to access the defineProps returned value to
55
- // infer types although you never use the props directly
56
- const props = defineProps<{
57
- color: 'blue' | 'red'
58
- }>()
59
- </script>
60
-
61
- <template>
62
- <div>{{ color }}</div>
63
- </template>
64
- ```
65
-
66
- ## Options
67
-
68
- ```ts
69
- import type { ts, Diagnostic } from 'ts-morph'
70
-
71
- interface TransformWriteFile {
72
- filePath?: string
73
- content?: string
74
- }
75
-
76
- export interface PluginOptions {
77
- // Depends on the root directory
78
- // Defaults base on your vite config root options
79
- root?: string
80
-
81
- // Declaration files output directory
82
- // Defaults base on your vite config output options
83
- outputDir?: string
84
-
85
- // Project init compilerOptions using by ts-morph
86
- // Default: null
87
- compilerOptions?: ts.CompilerOptions | null
88
-
89
- // Project init tsconfig.json file path by ts-morph
90
- // Plugin also resolve incldue and exclude files from tsconfig.json
91
- // Default: 'tsconfig.json'
92
- tsConfigFilePath?: string
93
-
94
- // Whether transform file name '.vue.d.ts' to '.d.ts'
95
- // Default: false
96
- cleanVueFileName?: boolean
97
-
98
- // Whether transform dynamic import to static
99
- // eg. 'import('vue').DefineComponent' to 'import { DefineComponent } from "vue"'
100
- // Default: false
101
- staticImport?: boolean
102
-
103
- // Manual set include glob
104
- // Defaults base on your tsconfig.json include option
105
- include?: string | string[]
106
-
107
- // Manual set exclude glob
108
- // Defaults base on your tsconfig.json exclude option, be 'node_module/**' when empty
109
- exclude?: string | string[]
110
-
111
- // Whether generate types entry file
112
- // When true will from package.json types field if exists or `${outputDir}/index.d.ts`
113
- // Default: false
114
- insertTypesEntry?: boolean
115
-
116
- // Whether copy .d.ts source files into outputDir
117
- // Default: true
118
- copyDtsFiles?: boolean
119
-
120
- // Whether emit nothing when has any diagnostic
121
- // Default: false
122
- noEmitOnError?: boolean
123
-
124
- // Whether skip typescript diagnostics
125
- // Skip type diagnostics means that type errors will not interrupt the build process
126
- // But for the source files with type errors will not be emitted
127
- // Default: true
128
- skipDiagnostics?: boolean
129
-
130
- // Whether log diagnostic informations
131
- // Not effective when `skipDiagnostics` is true
132
- // Default: false
133
- logDiagnostics?: boolean
134
-
135
- // After emit diagnostic hook
136
- // According to the length to judge whether there is any type error
137
- // Default: () => {}
138
- afterDiagnostic?: (diagnostics: Diagnostic[]) => void | Promise<void>
139
-
140
- // Before declaration file be writed hook
141
- // You can transform declaration file-path and content through it
142
- // Default: () => {}
143
- beforeWriteFile?: (filePath: string, content: string) => void | TransformWriteFile
144
-
145
- // After build hook
146
- // It wil be called after all declaration files are written
147
- // Default: () => {}
148
- afterBuild?: () => void | Promise<void>
149
- }
150
- ```
151
-
152
- ## Example
153
-
154
- Clone and run the following script:
155
-
156
- ```sh
157
- pnpm run test:e2e
158
- ```
159
-
160
- Then check `example/types`.
161
-
162
- ## FAQ
163
-
164
- Here will include some FAQ's and provide some solutions.
165
-
166
- ### Missing some declaration files after build
167
-
168
- By default `skipDiagnostics` option is `true`, which means that type diagnostic will be skipped during the build process (some projects may have diagnostic tool such as `vue-tsc`). If there are some files with type errors which will interrupt the build process, these files will not be emitted (not generate declaration files).
169
-
170
- If your project has not type diagnostic tools, you can set `skipDiagnostics: false` and `logDiagnostics: true` to turn on the diagnostic and log features of this plugin. It will help you to check the type errors during build and log error information to the terminal.
171
-
172
- ### Take type error when using both `script` and `setup-script` in vue component
173
-
174
- This is usually caused by using `defineComponent` function in both `script` and `setup-script`. When `vue/compiler-sfc` compiles these files, the default export result in `script` will be merged into the parameter object of `defineComponent` that in `setup-script`, but there is incompatible of `defineComponent` returned types and parameter types, then a type error is caused.
175
-
176
- 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.
177
-
178
- ## License
179
-
180
- MIT License.
1
+ # vite-plugin-dts
2
+
3
+ **English** | [中文](./README.zh-CN.md)
4
+
5
+ A vite plugin that generate `.d.ts` files from `.ts` or `.vue` source files for lib.
6
+
7
+ ## Install
8
+
9
+ ```sh
10
+ pnpm add vite-plugin-dts -D
11
+ ```
12
+
13
+ ## Usage
14
+
15
+ In `vite.config.ts`:
16
+
17
+ ```ts
18
+ import { resolve } from 'path'
19
+ import { defineConfig } from 'vite'
20
+ import dts from 'vite-plugin-dts'
21
+
22
+ export default defineConfig({
23
+ build: {
24
+ lib: {
25
+ entry: resolve(__dirname, 'src/index.ts'),
26
+ name: 'MyLib',
27
+ formats: ['es'],
28
+ fileName: 'my-lib'
29
+ }
30
+ },
31
+ plugins: [dts()]
32
+ })
33
+ ```
34
+
35
+ In your component:
36
+
37
+ ```vue
38
+ <template>
39
+ <div></div>
40
+ </template>
41
+
42
+ <script lang="ts">
43
+ // using defineComponent for inferring types
44
+ import { defineComponent } from 'vue'
45
+
46
+ export default defineComponent({
47
+ name: 'Component'
48
+ })
49
+ </script>
50
+ ```
51
+
52
+ ```vue
53
+ <script setup lang="ts">
54
+ // Need to access the defineProps returned value to
55
+ // infer types although you never use the props directly
56
+ const props = defineProps<{
57
+ color: 'blue' | 'red'
58
+ }>()
59
+ </script>
60
+
61
+ <template>
62
+ <div>{{ color }}</div>
63
+ </template>
64
+ ```
65
+
66
+ ## Options
67
+
68
+ ```ts
69
+ import type { ts, Diagnostic } from 'ts-morph'
70
+
71
+ interface TransformWriteFile {
72
+ filePath?: string
73
+ content?: string
74
+ }
75
+
76
+ export interface PluginOptions {
77
+ // Depends on the root directory
78
+ // Defaults base on your vite config root options
79
+ root?: string
80
+
81
+ // Declaration files output directory
82
+ // Defaults base on your vite config output options
83
+ outputDir?: string
84
+
85
+ // Project init compilerOptions using by ts-morph
86
+ // Default: null
87
+ compilerOptions?: ts.CompilerOptions | null
88
+
89
+ // Project init tsconfig.json file path by ts-morph
90
+ // Plugin also resolve incldue and exclude files from tsconfig.json
91
+ // Default: 'tsconfig.json'
92
+ tsConfigFilePath?: string
93
+
94
+ // Whether transform file name '.vue.d.ts' to '.d.ts'
95
+ // Default: false
96
+ cleanVueFileName?: boolean
97
+
98
+ // Whether transform dynamic import to static
99
+ // eg. 'import('vue').DefineComponent' to 'import { DefineComponent } from "vue"'
100
+ // Default: false
101
+ staticImport?: boolean
102
+
103
+ // Manual set include glob
104
+ // Defaults base on your tsconfig.json include option
105
+ include?: string | string[]
106
+
107
+ // Manual set exclude glob
108
+ // Defaults base on your tsconfig.json exclude option, be 'node_module/**' when empty
109
+ exclude?: string | string[]
110
+
111
+ // Whether generate types entry file
112
+ // When true will from package.json types field if exists or `${outputDir}/index.d.ts`
113
+ // Default: false
114
+ insertTypesEntry?: boolean
115
+
116
+ // Whether copy .d.ts source files into outputDir
117
+ // Default: true
118
+ copyDtsFiles?: boolean
119
+
120
+ // Whether emit nothing when has any diagnostic
121
+ // Default: false
122
+ noEmitOnError?: boolean
123
+
124
+ // Whether skip typescript diagnostics
125
+ // Skip type diagnostics means that type errors will not interrupt the build process
126
+ // But for the source files with type errors will not be emitted
127
+ // Default: true
128
+ skipDiagnostics?: boolean
129
+
130
+ // Whether log diagnostic informations
131
+ // Not effective when `skipDiagnostics` is true
132
+ // Default: false
133
+ logDiagnostics?: boolean
134
+
135
+ // After emit diagnostic hook
136
+ // According to the length to judge whether there is any type error
137
+ // Default: () => {}
138
+ afterDiagnostic?: (diagnostics: Diagnostic[]) => void | Promise<void>
139
+
140
+ // Before declaration file be writed hook
141
+ // You can transform declaration file-path and content through it
142
+ // Default: () => {}
143
+ beforeWriteFile?: (filePath: string, content: string) => void | TransformWriteFile
144
+
145
+ // After build hook
146
+ // It wil be called after all declaration files are written
147
+ // Default: () => {}
148
+ afterBuild?: () => void | Promise<void>
149
+ }
150
+ ```
151
+
152
+ ## Example
153
+
154
+ Clone and run the following script:
155
+
156
+ ```sh
157
+ pnpm run test:e2e
158
+ ```
159
+
160
+ Then check `example/types`.
161
+
162
+ ## FAQ
163
+
164
+ Here will include some FAQ's and provide some solutions.
165
+
166
+ ### Missing some declaration files after build
167
+
168
+ By default `skipDiagnostics` option is `true`, which means that type diagnostic will be skipped during the build process (some projects may have diagnostic tool such as `vue-tsc`). If there are some files with type errors which will interrupt the build process, these files will not be emitted (not generate declaration files).
169
+
170
+ If your project has not type diagnostic tools, you can set `skipDiagnostics: false` and `logDiagnostics: true` to turn on the diagnostic and log features of this plugin. It will help you to check the type errors during build and log error information to the terminal.
171
+
172
+ ### Take type error when using both `script` and `setup-script` in vue component
173
+
174
+ This is usually caused by using `defineComponent` function in both `script` and `setup-script`. When `vue/compiler-sfc` compiles these files, the default export result in `script` will be merged into the parameter object of `defineComponent` that in `setup-script`, but there is incompatible of `defineComponent` returned types and parameter types, then a type error is caused.
175
+
176
+ 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.
177
+
178
+ ## License
179
+
180
+ MIT License.
package/README.zh-CN.md CHANGED
@@ -1,179 +1,179 @@
1
- # vite-plugin-dts
2
-
3
- **中文** | [English](./README.md)
4
-
5
- 一款用于从 `.ts` 或 `.vue` 源文件生成 `.d.ts` 文件的 Vite 插件。
6
-
7
- ## 安装
8
-
9
- ```sh
10
- pnpm add vite-plugin-dts -D
11
- ```
12
-
13
- ## 使用
14
-
15
- 在 `vite.config.ts`:
16
-
17
- ```ts
18
- import { resolve } from 'path'
19
- import { defineConfig } from 'vite'
20
- import dts from 'vite-plugin-dts'
21
-
22
- export default defineConfig({
23
- build: {
24
- lib: {
25
- entry: resolve(__dirname, 'src/index.ts'),
26
- name: 'MyLib',
27
- formats: ['es'],
28
- fileName: 'my-lib'
29
- }
30
- },
31
- plugins: [dts()]
32
- })
33
- ```
34
-
35
- 在你的组件中:
36
-
37
- ```vue
38
- <template>
39
- <div></div>
40
- </template>
41
-
42
- <script lang="ts">
43
- // 使用 defineComponent 来进行类型推断
44
- import { defineComponent } from 'vue'
45
-
46
- export default defineComponent({
47
- name: 'Component'
48
- })
49
- </script>
50
- ```
51
-
52
- ```vue
53
- <script setup lang="ts">
54
- // 尽管没有直接使用 props,你仍需要接收 defineProps 的返回值
55
- const props = defineProps<{
56
- color: 'blue' | 'red'
57
- }>()
58
- </script>
59
-
60
- <template>
61
- <div>{{ color }}</div>
62
- </template>
63
- ```
64
-
65
- ## 选项
66
-
67
- ```ts
68
- import type { ts, Diagnostic } from 'ts-morph'
69
-
70
- interface TransformWriteFile {
71
- filePath?: string
72
- content?: string
73
- }
74
-
75
- export interface PluginOptions {
76
- // 执行的根目录
77
- // 默认基于 vite 配置的 root 选项
78
- root?: string
79
-
80
- // 声明文件的输出目录
81
- // 默认基于 vite 配置的输出目录
82
- outputDir?: string
83
-
84
- // 提供给 ts-morph Project 初始化的 compilerOptions 选项
85
- // 默认值: null
86
- compilerOptions?: ts.CompilerOptions | null
87
-
88
- // 提供给 ts-morph Project 初始化的 tsconfig.json 路径
89
- // 插件也会读取 tsconfig.json 的 incldue 和 exclude 选项来解析文件
90
- // 默认值: 'tsconfig.json'
91
- tsConfigFilePath?: string
92
-
93
- // 是否将 '.vue.d.ts' 文件名转换为 '.d.ts'
94
- // 默认值: false
95
- cleanVueFileName?: boolean
96
-
97
- //是否将动态引入转换为静态
98
- // eg. 'import('vue').DefineComponent' 转换为 'import { DefineComponent } from "vue"'
99
- // 默认值: false
100
- staticImport?: boolean
101
-
102
- // 手动设置包含路径的 glob
103
- // 默认基于 tsconfig.json 的 include 选项
104
- include?: string | string[]
105
-
106
- // 手动设置排除路径的 glob
107
- // 默认基于 tsconfig.json 的 exclude 选线,未设置时为 'node_module/**'
108
- exclude?: string | string[]
109
-
110
- // 是否生成类型声明入口
111
- // 当为 true 时会基于 package.json 的 tpyes 字段生成,或者 `${outputDir}/index.d.ts`
112
- // 默认值: false
113
- insertTypesEntry?: boolean
114
-
115
- // 是否将源码里的 .d.ts 文件复制到 outputDir
116
- // 默认值: true
117
- copyDtsFiles?: boolean
118
-
119
- // 出现类型诊断信息时不生成类型文件
120
- // 默认值: false
121
- noEmitOnError?: boolean
122
-
123
- // 是否跳过类型诊断
124
- // 跳过类型诊断意味着出现错误时不会中断打包进程的执行
125
- // 但对于出现错误的源文件,将无法生成相应的类型文件
126
- // 默认值: true
127
- skipDiagnostics?: boolean
128
-
129
- // 是否打印类型诊断信息
130
- // 当跳过类型诊断时该属性将不会生效
131
- // 默认值: false
132
- logDiagnostics?: boolean
133
-
134
- // 获取诊断信息后的钩子
135
- // 可以根据参数 length 来判断有误类型错误
136
- // 默认值: () => {}
137
- afterDiagnostic?: (diagnostics: Diagnostic[]) => void | Promise<void>
138
-
139
- // 类型声明文件被写入前的钩子
140
- // 可以在钩子里转换文件路径和文件内容
141
- // 默认值: () => {}
142
- beforeWriteFile?: (filePath: string, content: string) => void | TransformWriteFile
143
-
144
- // 构建后回调钩子
145
- // 将会在所有类型文件被写入后调用
146
- // 默认值: () => {}
147
- afterBuild?: () => void | Promise<void>
148
- }
149
- ```
150
-
151
- ## 示例
152
-
153
- 克隆项目然后执行下列命令:
154
-
155
- ```sh
156
- pnpm run test:e2e
157
- ```
158
-
159
- 然后检查 `example/types` 目录。
160
-
161
- ## 常见问题
162
-
163
- 此处将收录一些常见的问题并提供一些解决方案。
164
-
165
- ### 打包后出现类型文件缺失
166
-
167
- 默认情况下 `skipDiagnostics` 选项的值为 `true`,这意味着打包过程中将跳过类型检查(一些项目通常有 `vue-tsc` 等的类型检查工具),这时如果出现存在类型错误的文件,并且这是错误会中断打包过程,那么这些文件对应的类型文件将不会被生成。
168
-
169
- 如果您的项目没有依赖外部的类型检查工具,这时候可以您可以设置 `skipDiagnostics: false` 和 `logDiagnostics: true` 来打开插件的诊断与输出功能,这将帮助您检查打包过程中出现的类型错误并将错误信息输出至终端。
170
-
171
- ### Vue 组件中同时使用了 `script` 和 `setup-script` 后出现类型错误
172
-
173
- 这通常是由于分别在 `script` 和 `setup-script` 中同时使用了 `defineComponent` 方法导致的。 `vue/compiler-sfc` 为这类文件编译时会将 `script` 中的默认导出结果合并到 `setup-script` 的 `defineComponent` 的参数定义中,而 `defineComponent` 的参数类型与结果类型并不兼容,这一行为将会导致类型错误。
174
-
175
- 这是一个简单的[示例](https://github.com/qmhc/vite-plugin-dts/blob/main/example/components/BothScripts.vue),您应该将位于 `script` 中的 `defineComponent` 方法移除,直接导出一个原始的对象。
176
-
177
- ## 授权
178
-
179
- MIT 授权。
1
+ # vite-plugin-dts
2
+
3
+ **中文** | [English](./README.md)
4
+
5
+ 一款用于从 `.ts` 或 `.vue` 源文件生成 `.d.ts` 文件的 Vite 插件。
6
+
7
+ ## 安装
8
+
9
+ ```sh
10
+ pnpm add vite-plugin-dts -D
11
+ ```
12
+
13
+ ## 使用
14
+
15
+ 在 `vite.config.ts`:
16
+
17
+ ```ts
18
+ import { resolve } from 'path'
19
+ import { defineConfig } from 'vite'
20
+ import dts from 'vite-plugin-dts'
21
+
22
+ export default defineConfig({
23
+ build: {
24
+ lib: {
25
+ entry: resolve(__dirname, 'src/index.ts'),
26
+ name: 'MyLib',
27
+ formats: ['es'],
28
+ fileName: 'my-lib'
29
+ }
30
+ },
31
+ plugins: [dts()]
32
+ })
33
+ ```
34
+
35
+ 在你的组件中:
36
+
37
+ ```vue
38
+ <template>
39
+ <div></div>
40
+ </template>
41
+
42
+ <script lang="ts">
43
+ // 使用 defineComponent 来进行类型推断
44
+ import { defineComponent } from 'vue'
45
+
46
+ export default defineComponent({
47
+ name: 'Component'
48
+ })
49
+ </script>
50
+ ```
51
+
52
+ ```vue
53
+ <script setup lang="ts">
54
+ // 尽管没有直接使用 props,你仍需要接收 defineProps 的返回值
55
+ const props = defineProps<{
56
+ color: 'blue' | 'red'
57
+ }>()
58
+ </script>
59
+
60
+ <template>
61
+ <div>{{ color }}</div>
62
+ </template>
63
+ ```
64
+
65
+ ## 选项
66
+
67
+ ```ts
68
+ import type { ts, Diagnostic } from 'ts-morph'
69
+
70
+ interface TransformWriteFile {
71
+ filePath?: string
72
+ content?: string
73
+ }
74
+
75
+ export interface PluginOptions {
76
+ // 执行的根目录
77
+ // 默认基于 vite 配置的 root 选项
78
+ root?: string
79
+
80
+ // 声明文件的输出目录
81
+ // 默认基于 vite 配置的输出目录
82
+ outputDir?: string
83
+
84
+ // 提供给 ts-morph Project 初始化的 compilerOptions 选项
85
+ // 默认值: null
86
+ compilerOptions?: ts.CompilerOptions | null
87
+
88
+ // 提供给 ts-morph Project 初始化的 tsconfig.json 路径
89
+ // 插件也会读取 tsconfig.json 的 incldue 和 exclude 选项来解析文件
90
+ // 默认值: 'tsconfig.json'
91
+ tsConfigFilePath?: string
92
+
93
+ // 是否将 '.vue.d.ts' 文件名转换为 '.d.ts'
94
+ // 默认值: false
95
+ cleanVueFileName?: boolean
96
+
97
+ //是否将动态引入转换为静态
98
+ // eg. 'import('vue').DefineComponent' 转换为 'import { DefineComponent } from "vue"'
99
+ // 默认值: false
100
+ staticImport?: boolean
101
+
102
+ // 手动设置包含路径的 glob
103
+ // 默认基于 tsconfig.json 的 include 选项
104
+ include?: string | string[]
105
+
106
+ // 手动设置排除路径的 glob
107
+ // 默认基于 tsconfig.json 的 exclude 选线,未设置时为 'node_module/**'
108
+ exclude?: string | string[]
109
+
110
+ // 是否生成类型声明入口
111
+ // 当为 true 时会基于 package.json 的 tpyes 字段生成,或者 `${outputDir}/index.d.ts`
112
+ // 默认值: false
113
+ insertTypesEntry?: boolean
114
+
115
+ // 是否将源码里的 .d.ts 文件复制到 outputDir
116
+ // 默认值: true
117
+ copyDtsFiles?: boolean
118
+
119
+ // 出现类型诊断信息时不生成类型文件
120
+ // 默认值: false
121
+ noEmitOnError?: boolean
122
+
123
+ // 是否跳过类型诊断
124
+ // 跳过类型诊断意味着出现错误时不会中断打包进程的执行
125
+ // 但对于出现错误的源文件,将无法生成相应的类型文件
126
+ // 默认值: true
127
+ skipDiagnostics?: boolean
128
+
129
+ // 是否打印类型诊断信息
130
+ // 当跳过类型诊断时该属性将不会生效
131
+ // 默认值: false
132
+ logDiagnostics?: boolean
133
+
134
+ // 获取诊断信息后的钩子
135
+ // 可以根据参数 length 来判断有误类型错误
136
+ // 默认值: () => {}
137
+ afterDiagnostic?: (diagnostics: Diagnostic[]) => void | Promise<void>
138
+
139
+ // 类型声明文件被写入前的钩子
140
+ // 可以在钩子里转换文件路径和文件内容
141
+ // 默认值: () => {}
142
+ beforeWriteFile?: (filePath: string, content: string) => void | TransformWriteFile
143
+
144
+ // 构建后回调钩子
145
+ // 将会在所有类型文件被写入后调用
146
+ // 默认值: () => {}
147
+ afterBuild?: () => void | Promise<void>
148
+ }
149
+ ```
150
+
151
+ ## 示例
152
+
153
+ 克隆项目然后执行下列命令:
154
+
155
+ ```sh
156
+ pnpm run test:e2e
157
+ ```
158
+
159
+ 然后检查 `example/types` 目录。
160
+
161
+ ## 常见问题
162
+
163
+ 此处将收录一些常见的问题并提供一些解决方案。
164
+
165
+ ### 打包后出现类型文件缺失
166
+
167
+ 默认情况下 `skipDiagnostics` 选项的值为 `true`,这意味着打包过程中将跳过类型检查(一些项目通常有 `vue-tsc` 等的类型检查工具),这时如果出现存在类型错误的文件,并且这是错误会中断打包过程,那么这些文件对应的类型文件将不会被生成。
168
+
169
+ 如果您的项目没有依赖外部的类型检查工具,这时候可以您可以设置 `skipDiagnostics: false` 和 `logDiagnostics: true` 来打开插件的诊断与输出功能,这将帮助您检查打包过程中出现的类型错误并将错误信息输出至终端。
170
+
171
+ ### Vue 组件中同时使用了 `script` 和 `setup-script` 后出现类型错误
172
+
173
+ 这通常是由于分别在 `script` 和 `setup-script` 中同时使用了 `defineComponent` 方法导致的。 `vue/compiler-sfc` 为这类文件编译时会将 `script` 中的默认导出结果合并到 `setup-script` 的 `defineComponent` 的参数定义中,而 `defineComponent` 的参数类型与结果类型并不兼容,这一行为将会导致类型错误。
174
+
175
+ 这是一个简单的[示例](https://github.com/qmhc/vite-plugin-dts/blob/main/example/components/BothScripts.vue),您应该将位于 `script` 中的 `defineComponent` 方法移除,直接导出一个原始的对象。
176
+
177
+ ## 授权
178
+
179
+ MIT 授权。
package/dist/index.js CHANGED
@@ -141400,7 +141400,7 @@ ${import_chalk.default.cyan("[vite:dts]")} Can not resolve declaration directory
141400
141400
  }
141401
141401
  },
141402
141402
  async closeBundle() {
141403
- var _a2, _b, _c, _d, _e;
141403
+ var _a2, _b, _c, _d, _e, _f;
141404
141404
  if (!outputDir || !project || isBundle)
141405
141405
  return;
141406
141406
  logger.info(import_chalk.default.green(`
@@ -141410,8 +141410,8 @@ ${import_chalk.default.cyan("[vite:dts]")} Start generate declaration files...`)
141410
141410
  sourceDtsFiles.clear();
141411
141411
  const startTime = Date.now();
141412
141412
  const tsConfig = (_a2 = (0, import_typescript.readConfigFile)(tsConfigPath, project.getFileSystem().readFileSync).config) != null ? _a2 : {};
141413
- const include = (_b = options.include) != null ? _b : tsConfig.include;
141414
- const exclude = (_c = options.exclude) != null ? _c : tsConfig.exclude;
141413
+ const include = (_c = (_b = options.include) != null ? _b : tsConfig.include) != null ? _c : "**/*";
141414
+ const exclude = (_d = options.exclude) != null ? _d : tsConfig.exclude;
141415
141415
  bundleDebug("read config");
141416
141416
  const includedFileSet = new Set();
141417
141417
  if (include && include.length) {
@@ -141500,8 +141500,8 @@ ${import_chalk.default.cyan("[vite:dts]")} Start generate declaration files...`)
141500
141500
  if (typeof beforeWriteFile === "function") {
141501
141501
  const result = beforeWriteFile(typesPath, content);
141502
141502
  if (result && isNativeObj(result)) {
141503
- typesPath = (_d = result.filePath) != null ? _d : typesPath;
141504
- content = (_e = result.content) != null ? _e : content;
141503
+ typesPath = (_e = result.filePath) != null ? _e : typesPath;
141504
+ content = (_f = result.content) != null ? _f : content;
141505
141505
  }
141506
141506
  }
141507
141507
  await import_fs_extra.default.writeFile(typesPath, content, "utf-8");
package/dist/index.mjs CHANGED
@@ -141351,7 +141351,7 @@ ${import_chalk.default.cyan("[vite:dts]")} Can not resolve declaration directory
141351
141351
  }
141352
141352
  },
141353
141353
  async closeBundle() {
141354
- var _a2, _b, _c, _d, _e;
141354
+ var _a2, _b, _c, _d, _e, _f;
141355
141355
  if (!outputDir || !project || isBundle)
141356
141356
  return;
141357
141357
  logger.info(import_chalk.default.green(`
@@ -141361,8 +141361,8 @@ ${import_chalk.default.cyan("[vite:dts]")} Start generate declaration files...`)
141361
141361
  sourceDtsFiles.clear();
141362
141362
  const startTime = Date.now();
141363
141363
  const tsConfig = (_a2 = (0, import_typescript.readConfigFile)(tsConfigPath, project.getFileSystem().readFileSync).config) != null ? _a2 : {};
141364
- const include = (_b = options.include) != null ? _b : tsConfig.include;
141365
- const exclude = (_c = options.exclude) != null ? _c : tsConfig.exclude;
141364
+ const include = (_c = (_b = options.include) != null ? _b : tsConfig.include) != null ? _c : "**/*";
141365
+ const exclude = (_d = options.exclude) != null ? _d : tsConfig.exclude;
141366
141366
  bundleDebug("read config");
141367
141367
  const includedFileSet = new Set();
141368
141368
  if (include && include.length) {
@@ -141451,8 +141451,8 @@ ${import_chalk.default.cyan("[vite:dts]")} Start generate declaration files...`)
141451
141451
  if (typeof beforeWriteFile === "function") {
141452
141452
  const result = beforeWriteFile(typesPath, content);
141453
141453
  if (result && isNativeObj(result)) {
141454
- typesPath = (_d = result.filePath) != null ? _d : typesPath;
141455
- content = (_e = result.content) != null ? _e : content;
141454
+ typesPath = (_e = result.filePath) != null ? _e : typesPath;
141455
+ content = (_f = result.content) != null ? _f : content;
141456
141456
  }
141457
141457
  }
141458
141458
  await fs.writeFile(typesPath, content, "utf-8");
package/package.json CHANGED
@@ -91,5 +91,5 @@
91
91
  "test:e2e": "cd example && cross-env DEBUG=\"vite-plugin-dts:bundle\" vite build"
92
92
  },
93
93
  "types": "dist/index.d.ts",
94
- "version": "0.9.9"
94
+ "version": "0.9.10"
95
95
  }