@moluoxixi/vite-config 0.0.37

package/dist/index.d.ts

@@ -0,0 +1,138 @@
+import { AutoImportAddonOptions } from './addons/auto-import.js';
+export { defineAutoImportAddonOptions } from './addons/auto-import.js';
+import { ComponentsAddonOptions } from './addons/components.js';
+export { defineComponentsAddonOptions } from './addons/components.js';
+import { DevtoolsAddonOptions } from './addons/devtools.js';
+export { defineDevtoolsAddonOptions } from './addons/devtools.js';
+import { I18nAddonOptions } from './addons/i18n.js';
+export { defineI18nAddonOptions } from './addons/i18n.js';
+import { VueLayoutsAddonOptions } from './addons/layouts.js';
+export { defineVueLayoutsAddonOptions } from './addons/layouts.js';
+import { MarkdownAddonOptions } from './addons/markdown.js';
+export { defineMarkdownAddonOptions } from './addons/markdown.js';
+import { PwaAddonOptions } from './addons/pwa.js';
+export { definePwaAddonOptions } from './addons/pwa.js';
+import { ReactAddonOptions } from './addons/react.js';
+export { defineReactAddonOptions } from './addons/react.js';
+import { TailwindCssAddonOptions } from './addons/tailwindcss.js';
+export { defineTailwindCssAddonOptions } from './addons/tailwindcss.js';
+import { UnoCssAddonOptions } from './addons/unocss.js';
+export { defineUnoCssAddonOptions } from './addons/unocss.js';
+import { ViteSsgAddonOptions } from './addons/vite-ssg.js';
+export { defineViteSsgAddonOptions } from './addons/vite-ssg.js';
+import { VitestAddonOptions } from './addons/vitest.js';
+export { defineVitestAddonOptions } from './addons/vitest.js';
+import { VueAddonOptions } from './addons/vue.js';
+export { defineVueAddonOptions } from './addons/vue.js';
+import { VueRouterAddonOptions } from './addons/vue-router.js';
+export { defineVueRouterAddonOptions } from './addons/vue-router.js';
+import { LibraryOptions, UserConfig, ConfigEnv, UserConfigExport } from 'vite';
+import 'unplugin-auto-import/types';
+import 'unplugin-vue-components/types';
+import 'vite-plugin-vue-devtools';
+import '@intlify/unplugin-vue-i18n';
+import 'vite-plugin-vue-layouts';
+import 'unplugin-vue-markdown/types';
+import 'vite-plugin-pwa';
+import '@vitejs/plugin-react';
+import '@tailwindcss/vite';
+import 'unocss/vite';
+import 'vitest';
+import '@vitejs/plugin-vue';
+import 'unplugin-vue-router/types';
+
+/**
+ * All supported addon identifiers (camelCase, matches ViteConfigOptions keys)
+ */
+type AddonName = 'vue' | 'react' | 'unocss' | 'tailwindcss' | 'vueRouter' | 'vueLayouts' | 'autoImport' | 'components' | 'i18n' | 'devtools' | 'pwa' | 'markdown' | 'vitest' | 'viteSsg';
+type AddonConfig<TOptions> = TOptions | boolean;
+/**
+ * Addon 配置映射。
+ * 对象使用对应 addon 的真实配置类型，`true` 表示显式启用，`false` 表示显式关闭。
+ */
+interface ViteConfigOptions {
+    /** Library mode entry used by createLibConfig; relative paths resolve from viteConfig.root. */
+    entry?: LibraryOptions['entry'];
+    viteConfig?: UserConfig;
+    vue?: AddonConfig<VueAddonOptions>;
+    react?: AddonConfig<ReactAddonOptions>;
+    unocss?: AddonConfig<UnoCssAddonOptions>;
+    /** Tailwind CSS 只自动接入官方 Vite/PostCSS 集成包，不把裸 tailwindcss 包当作插件入口。 */
+    tailwindcss?: AddonConfig<TailwindCssAddonOptions>;
+    vueRouter?: AddonConfig<VueRouterAddonOptions>;
+    /** Layouts 插件保持 optional peer，不在本仓库绑定其过期 Vite peer 范围。 */
+    vueLayouts?: AddonConfig<VueLayoutsAddonOptions>;
+    autoImport?: AddonConfig<AutoImportAddonOptions>;
+    components?: AddonConfig<ComponentsAddonOptions>;
+    i18n?: AddonConfig<I18nAddonOptions>;
+    devtools?: AddonConfig<DevtoolsAddonOptions>;
+    /** PWA 运行时仍由调用方项目安装；本包 devDependency 只服务源码类型检查和声明文件构建。 */
+    pwa?: AddonConfig<PwaAddonOptions>;
+    markdown?: AddonConfig<MarkdownAddonOptions>;
+    vitest?: AddonConfig<VitestAddonOptions>;
+    viteSsg?: AddonConfig<ViteSsgAddonOptions>;
+}
+/**
+ * 与 defineConfig 对齐的配置导出类型
+ * - 对象形式：直接传入 ViteConfigOptions
+ * - 函数形式：接收 Vite 的 ConfigEnv，返回 ViteConfigOptions
+ */
+type ViteConfigExport = ViteConfigOptions | ((env: ConfigEnv) => ViteConfigOptions | Promise<ViteConfigOptions>);
+
+/**
+ * 构建 Web App 应用专用的 Vite 配置文件
+ *
+ * @example
+ * // 对象形式
+ * export default createAppConfig({ vue: true })
+ *
+ * export default createAppConfig(({ mode }) => ({
+ *   vue: true,
+ *   viteConfig: {
+ *     base: mode === 'development' ? '/' : '/app/',
+ *   }
+ * }))
+ */
+declare function createAppConfig(config?: ViteConfigExport): UserConfigExport;
+
+type ViteFeatureEnableReason = 'dependency-detected' | 'explicit-disabled' | 'explicit-enabled' | 'dependency-missing';
+interface ViteFeatureInspection {
+    name: AddonName;
+    enabled: boolean;
+    reason: ViteFeatureEnableReason;
+    triggers: string[];
+    matchedTriggers: string[];
+    requires: string[];
+    missingRequires: string[];
+}
+interface ViteFeatureInspectionResult {
+    root: string;
+    features: ViteFeatureInspection[];
+}
+
+/**
+ * 基于目标 root 输出 addon 决策报告；只做依赖图检查，不加载插件模块。
+ */
+declare function inspectViteFeatures(options?: ViteConfigOptions): ViteFeatureInspectionResult;
+
+/**
+ * 获取全局通用基础配置
+ */
+declare function getBaseConfig(options?: ViteConfigOptions): Promise<UserConfig>;
+
+/**
+ * 构建 Library（库项目）专用的 Vite 配置文件
+ *
+ * @example
+ * // 对象形式
+ * export default createLibConfig()
+ *
+ * export default createLibConfig(({ mode }) => ({
+ *   viteConfig: {
+ *     build: { sourcemap: mode !== 'production' },
+ *   }
+ * }))
+ */
+declare function createLibConfig(config?: ViteConfigExport): UserConfigExport;
+
+export { type AddonName, AutoImportAddonOptions, ComponentsAddonOptions, DevtoolsAddonOptions, I18nAddonOptions, MarkdownAddonOptions, PwaAddonOptions, ReactAddonOptions, TailwindCssAddonOptions, UnoCssAddonOptions, type ViteConfigExport, type ViteConfigOptions, type ViteFeatureInspection, type ViteFeatureInspectionResult, ViteSsgAddonOptions, VitestAddonOptions, VueAddonOptions, VueLayoutsAddonOptions, VueRouterAddonOptions, createAppConfig, createLibConfig, getBaseConfig, inspectViteFeatures };