fe-stack 0.0.3 → 0.0.5

package/README.md

@@ -120,6 +120,11 @@ import { createBaseConfig } from 'fe-stack/vite.config.base';
 
 export default createBaseConfig(import.meta.dirname, {
   mode: 'lib',
+  dtsConfig: {
+    // 自定义 vite-plugin-dts 配置
+    exclude: ['**/*.test.ts', '**/*.spec.ts'],
+    insertTypesEntry: true,
+  },
   viteConfig: {
     build: {
       lib: {
@@ -135,6 +140,6 @@ export default createBaseConfig(import.meta.dirname, {
 **特性：**
 - ✅ 完整的 TypeScript 类型支持
 - ✅ 使用 `mergeConfig` 优雅合并配置
+- ✅ `dtsConfig` 直接配置 dts 插件选项
 - ✅ lib 模式自动配置 `vite-plugin-dts`
 - ✅ 默认打包为 ESM 格式
-- ✅ 所有配置通过 `viteConfig` 统一管理，简单直观

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "fe-stack",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "共享的配置文件集合，用于 Vite、Tailwind、Biome、Prettier 和 TypeScript",
   "type": "module",
   "exports": {
     "./vite.config.base": {
-      "types": "./vite.config.base.ts",
-      "import": "./vite.config.base.ts"
+      "types": "./vite.config.base.d.ts",
+      "import": "./vite.config.base.js"
     },
     "./tsconfig.*.json": "./tsconfig.*.json",
     "./biome.json": "./biome.json",
@@ -19,7 +19,8 @@
     "tailwind.config.js",
     "tsconfig.app.json",
     "tsconfig.node.json",
-    "vite.config.base.ts",
+    "vite.config.base.js",
+    "vite.config.base.d.ts",
     "README.md"
   ],
   "keywords": [

package/vite.config.base.d.ts

@@ -0,0 +1,32 @@
+import type { UserConfig } from 'vite';
+import type { PluginOptions as DtsPluginOptions } from 'vite-plugin-dts';
+
+export interface CreateBaseConfigOptions {
+  /**
+   * 构建模式
+   * - 'app': Vue 应用模式，包含 Vue Router、Auto Import 等
+   * - 'lib': 库打包模式，配置 vite-plugin-dts
+   */
+  mode?: 'app' | 'lib';
+
+  /**
+   * vite-plugin-dts 配置（仅 lib 模式）
+   * 会与默认配置合并，可以覆盖 include、exclude 等选项
+   */
+  dtsConfig?: Partial<DtsPluginOptions>;
+  /**
+   * 额外的 Vite 配置，会与基础配置合并
+   */
+  viteConfig?: UserConfig;
+}
+
+/**
+ * 创建基础 Vite 配置
+ * @param dirname - 项目根目录路径（通常使用 import.meta.dirname）
+ * @param options - 配置选项
+ * @returns Vite 配置
+ */
+export function createBaseConfig(
+  dirname: string,
+  options?: CreateBaseConfigOptions,
+): import('vite').UserConfigExport;

package/{vite.config.base.ts → vite.config.base.js}

@@ -4,22 +4,29 @@ import vue from '@vitejs/plugin-vue';
 import AutoImport from 'unplugin-auto-import/vite';
 import Components from 'unplugin-vue-components/vite';
 import VueRouter from 'unplugin-vue-router/vite';
-import type { UserConfig } from 'vite';
 import { defineConfig, mergeConfig } from 'vite';
 import dts from 'vite-plugin-dts';
 
-export interface CreateBaseConfigOptions {
-  mode?: 'app' | 'lib';
-  viteConfig?: UserConfig;
-}
+/**
+ * @typedef {import('vite').UserConfig} UserConfig
+ * @typedef {import('vite-plugin-dts').PluginOptions} DtsPluginOptions
+ * @typedef {Object} CreateBaseConfigOptions
+ * @property {'app' | 'lib'} [mode] - 构建模式：'app' 为 Vue 应用，'lib' 为库打包
+ * @property {Partial<DtsPluginOptions>} [dtsConfig] - vite-plugin-dts 配置（仅 lib 模式），会与默认配置合并
+ * @property {UserConfig} [viteConfig] - 额外的 Vite 配置，会与基础配置合并
+ */
 
-export function createBaseConfig(
-  dirname: string,
-  options: CreateBaseConfigOptions = {},
-) {
-  const { mode = 'app', viteConfig = {} } = options;
+/**
+ * 创建基础 Vite 配置
+ * @param {string} dirname - 项目根目录路径
+ * @param {CreateBaseConfigOptions} [options] - 配置选项
+ * @returns {import('vite').UserConfigExport} Vite 配置
+ */
+export function createBaseConfig(dirname, options = {}) {
+  const { mode = 'app', dtsConfig = {}, viteConfig = {} } = options;
 
-  const baseConfig: UserConfig = {
+  /** @type {UserConfig} */
+  const baseConfig = {
     resolve: {
       alias: {
         '@': path.resolve(dirname, './src'),
@@ -36,11 +43,19 @@ export function createBaseConfig(
       ],
     },
     plugins: [],
+    worker: {
+      format: 'es',
+      rollupOptions: {
+        output: {
+          format: 'es',
+        },
+      },
+    },
   };
 
   // App mode: 包含 Vue 全家桶
   if (mode === 'app') {
-    baseConfig.plugins!.push(
+    baseConfig.plugins.push(
       VueRouter({
         dts: './src/typed-router.d.ts',
       }),
@@ -67,12 +82,13 @@ export function createBaseConfig(
       },
     };
 
-    // 默认添加 dts 插件
-    baseConfig.plugins!.push(
+    // 添加 dts 插件，用户配置会覆盖默认配置
+    baseConfig.plugins.push(
       dts({
         include: ['src/**/*.ts'],
         root: dirname,
         rollupTypes: true,
+        ...dtsConfig,
       }),
     );
   }