weapp-vite 6.7.6 → 6.8.0

package/dist/{config-BngmcXkt.d.ts → config-D8v221vL.d.ts}

@@ -1,12 +1,12 @@
 import { InlineConfig, UserConfig as UserConfig$2, ViteDevServer, build, ConfigEnv } from 'vite';
 import { GenerateType, Component, Theme, Sitemap, App, Page, Plugin } from '@weapp-core/schematics';
-import { WeappWebPluginOptions } from '@weapp-vite/web';
-import { InputOption, RolldownOutput, RolldownWatcher } from 'rolldown';
-import { Options } from 'rolldown-plugin-dts';
-import { CompilerOptions } from 'typescript';
 import { WrapPluginOptions } from 'vite-plugin-performance';
 import { PluginOptions } from 'vite-tsconfig-paths';
 import { WevuDefaults } from 'wevu';
+import { WeappWebPluginOptions } from '@weapp-vite/web/plugin';
+import { InputOption, RolldownOutput, RolldownWatcher } from 'rolldown';
+import { Options } from 'rolldown-plugin-dts';
+import { CompilerOptions } from 'typescript';
 import { R as Resolver, a as ResolvedValue } from './types-B6irZnLM.js';
 import { LoggerConfig } from '@weapp-core/logger';
 import PQueue from 'p-queue';
@@ -36,13 +36,28 @@ declare module 'vite' {
 }
 
 type NpmBuildOptions = InlineConfig;
+/**
+ * @description 支付宝平台本地 npm 输出模式
+ */
 type AlipayNpmMode = 'miniprogram_npm' | 'node_modules';
 interface Alias {
+    /**
+     * @description 被匹配的原始路径或正则
+     */
     find: string | RegExp;
+    /**
+     * @description 命中后的替换路径
+     */
     replacement: string;
 }
 interface ResolvedAlias {
+    /**
+     * @description 解析后的匹配条件
+     */
     find: string | RegExp;
+    /**
+     * @description 解析后的替换路径
+     */
     replacement: string;
 }
 interface AliasOptions {
@@ -56,16 +71,6 @@ interface AliasOptions {
      *   },
      * ]
      * ```
-     * 这样你就可以在 json 里面使用:
-     * ```json
-     * {
-     *   "usingComponents": {
-     *     "navigation-bar": "@/navigation-bar/navigation-bar",
-     *     "ice-avatar": "@/avatar/avatar"
-     *   }
-     * }
-     * ```
-     * 详见[json别名](/guide/alias.html#json-别名)文档
      */
     entries?: readonly Alias[] | {
         [find: string]: string;
@@ -73,12 +78,33 @@ interface AliasOptions {
 }
 type MpPlatform = 'weapp' | 'alipay' | 'tt' | 'swan' | 'jd' | 'xhs';
 interface SubPackage {
+    /**
+     * @description 分包内页面列表，路径相对于分包 root
+     */
     pages: string[];
+    /**
+     * @description 分包根目录
+     */
     root: string;
+    /**
+     * @description 是否为独立分包
+     */
     independent?: boolean;
+    /**
+     * @description 分包入口文件，也基于 root 解析
+     */
     entry?: string;
+    /**
+     * @description 分包名称
+     */
     name?: string;
+    /**
+     * @description 分包依赖范围控制
+     */
     dependencies?: (string | RegExp)[];
+    /**
+     * @description 分包级额外 inline Vite 配置
+     */
     inlineConfig?: Partial<InlineConfig>;
 }
 type SubPackageStyleScope = 'all' | 'pages' | 'components';
@@ -86,13 +112,7 @@ interface SubPackageStyleConfigObject {
     /** 样式文件路径，可以是相对分包 root、相对 `srcRoot` 或绝对路径 */
     source: string;
     /**
-     * 作用范围快捷配置：
-     *
-     * - `all`: 默认值，分包内所有页面与组件都会引入
-     * - `pages`: 仅匹配分包 `pages/**`
-     * - `components`: 仅匹配分包 `components/**`
-     *
-     * 可结合 `include` / `exclude` 进一步细分范围
+     * @description 作用范围快捷配置
      */
     scope?: SubPackageStyleScope;
     /** 自定义包含路径，支持传入单个 glob 或数组，默认覆盖分包内所有文件 */
@@ -102,33 +122,12 @@ interface SubPackageStyleConfigObject {
 }
 type SubPackageStyleConfigEntry = string | SubPackageStyleConfigObject;
 interface SubPackageStyleEntry {
-    /**
-     * 源配置字符串（便于诊断）
-     */
     source: string;
-    /**
-     * 原始样式文件的绝对路径
-     */
     absolutePath: string;
-    /**
-     * 相对于 `srcRoot` 的输出路径（已转换为目标平台样式后缀）
-     */
     outputRelativePath: string;
-    /**
-     * 源文件扩展名（包含 `.`）
-     */
     inputExtension: string;
-    /**
-     * 作用域快捷字段，便于诊断输出
-     */
     scope: SubPackageStyleScope;
-    /**
-     * 允许生效的 glob 列表（基于分包 root 的相对路径）
-     */
     include: string[];
-    /**
-     * 排除的 glob 列表（基于分包 root 的相对路径）
-     */
     exclude: string[];
 }
 type GenerateExtensionsOptions = Partial<{
@@ -169,21 +168,9 @@ type GenerateTemplateEntry = Partial<Record<GenerateFileType, GenerateTemplate>>
 type GenerateTemplateScope = GenerateType | 'shared';
 type GenerateTemplatesConfig = Partial<Record<GenerateTemplateScope, GenerateTemplateEntry>>;
 interface GenerateOptions {
-    /**
-     * 生成文件的扩展名
-     */
     extensions?: GenerateExtensionsOptions;
-    /**
-     * 默认生成文件的相对路径
-     */
     dirs?: GenerateDirsOptions;
-    /**
-     * 默认生成文件的名称
-     */
     filenames?: GenerateFilenamesOptions;
-    /**
-     * 自定义模板
-     */
     templates?: GenerateTemplatesConfig;
 }
 interface CopyOptions {
@@ -191,46 +178,16 @@ interface CopyOptions {
     exclude?: CopyGlobs;
     filter?: (filePath: string, index: number, array: string[]) => boolean;
 }
+/**
+ * @description 资源复制使用的 glob 列表
+ */
 type CopyGlobs = string[];
 interface WeappWebConfig {
-    /**
-     * @description 是否启用浏览器端运行时集成
-     * @default false
-     * @example
-     * enable: true
-     */
     enable?: boolean;
-    /**
-     * @description Web 侧项目根目录（即 index.html 所在目录）
-     * @default 项目根目录
-     * @example
-     * root: 'web'
-     */
     root?: string;
-    /**
-     * @description 小程序源码目录（相对于 `root`），默认与 `weapp.srcRoot` 保持一致
-     * @example
-     * srcDir: 'src'
-     */
     srcDir?: string;
-    /**
-     * @description Web 构建产物输出目录；相对路径基于 `root`
-     * @default "dist/web"
-     * @example
-     * outDir: 'dist/web'
-     */
     outDir?: string;
-    /**
-     * @description 传递给 `weappWebPlugin` 的额外参数（不包含 `srcDir`）
-     * @example
-     * pluginOptions: { runtime: { executionMode: 'safe' } }
-     */
     pluginOptions?: Partial<Omit<WeappWebPluginOptions, 'srcDir'>>;
-    /**
-     * @description 额外合并到 Web 构建中的 Vite 内联配置
-     * @example
-     * vite: { server: { host: true } }
-     */
     vite?: InlineConfig;
 }
 interface WeappLibEntryContext {
@@ -240,202 +197,39 @@ interface WeappLibEntryContext {
 type WeappLibFileName = string | ((context: WeappLibEntryContext) => string);
 type WeappLibComponentJson = boolean | 'auto' | ((context: WeappLibEntryContext) => Record<string, any>);
 interface WeappLibInternalDtsOptions {
-    /**
-     * @description internal 方案使用的 tsconfig 路径（false 表示不加载）
-     */
     tsconfig?: string | false;
-    /**
-     * @description internal 方案的 compilerOptions
-     */
     compilerOptions?: CompilerOptions;
-    /**
-     * @description internal 方案的 vueCompilerOptions
-     */
     vueCompilerOptions?: Record<string, any>;
 }
 interface WeappLibVueTscOptions {
-    /**
-     * @description 额外合并到 vue-tsc 的 tsconfig（浅合并）
-     */
     tsconfig?: Record<string, any>;
-    /**
-     * @description 传递给 vue-tsc 的 compilerOptions
-     */
     compilerOptions?: CompilerOptions;
-    /**
-     * @description 传递给 vue-tsc 的 vueCompilerOptions
-     */
     vueCompilerOptions?: Record<string, any>;
 }
 interface WeappLibDtsOptions {
-    /**
-     * @description 是否启用 lib 产物的 dts
-     * @default true
-     */
     enabled?: boolean;
-    /**
-     * @description Vue SFC dts 生成方式
-     * @default 'internal'
-     */
     mode?: 'internal' | 'vue-tsc';
-    /**
-     * @description internal 方案的配置
-     */
     internal?: WeappLibInternalDtsOptions;
-    /**
-     * @description 透传给 rolldown-plugin-dts 的配置（内置字段会被覆盖）
-     */
     rolldown?: Options;
-    /**
-     * @description 透传给 vue-tsc 的配置（会合并到临时 tsconfig）
-     */
     vueTsc?: WeappLibVueTscOptions;
 }
 interface WeappLibConfig {
-    /**
-     * @description 入口配置，支持 string/array/record 形式
-     * @example
-     * entry: 'components/button/index.ts'
-     * @example
-     * entry: ['components/button/index.ts', 'utils/index.ts']
-     * @example
-     * entry: { button: 'components/button/index.ts' }
-     */
     entry: string | string[] | Record<string, string>;
-    /**
-     * @description 库源码根目录，默认沿用 `weapp.srcRoot`
-     */
     root?: string;
-    /**
-     * @description 输出目录，默认沿用 `build.outDir`
-     */
     outDir?: string;
-    /**
-     * @description 是否保持输出路径与源码路径一致
-     * @default true
-     */
     preservePath?: boolean;
-    /**
-     * @description 自定义 JS 产物路径（不含扩展名）
-     */
     fileName?: WeappLibFileName;
-    /**
-     * @description 自动生成组件 JSON 配置
-     * @default 'auto'
-     */
     componentJson?: WeappLibComponentJson;
-    /**
-     * @description 是否生成 lib 产物的 dts
-     * @default true
-     * @example
-     * dts: false
-     * @example
-     * dts: { enabled: false }
-     * @example
-     * dts: { mode: 'vue-tsc' }
-     * @example
-     * dts: { rolldown: { tsconfigRaw: { compilerOptions: { declarationMap: true } } } }
-     * @example
-     * dts: { vueTsc: { compilerOptions: { declarationMap: true } } }
-     * @example
-     * dts: { internal: { compilerOptions: { declarationMap: true } } }
-     */
     dts?: boolean | WeappLibDtsOptions;
 }
-interface AutoImportComponents {
-    /**
-     * 自动导入组件
-     */
-    globs?: string[];
-    /**
-     * 自动导入组件解析器
-     */
-    resolvers?: Resolver[];
-    /**
-     * 自动导入组件清单输出路径，默认输出到 `vite.config.ts` 同级目录的 `auto-import-components.json`
-     * - `true` 或未指定: 按默认路径输出
-     * - 传入字符串: 指定输出路径 (支持绝对/相对路径)
-     * - `false`: 不生成清单文件
-     */
-    output?: string | boolean;
-    /**
-     * 生成 WXML 组件 props 类型声明文件。
-     * - `true`: 输出到 `vite.config.ts` 同级目录的 `typed-components.d.ts`
-     * - 传入字符串: 自定义输出路径 (支持绝对/相对路径)
-     * - `false` 或未配置: 不生成类型文件
-     */
-    typedComponents?: boolean | string;
-    /**
-     * 生成 VS Code HTML customData 用于模板补全。
-     * - `true`: 输出到 `vite.config.ts` 同级目录的 `mini-program.html-data.json`
-     * - 传入字符串: 自定义输出路径 (支持绝对/相对路径)
-     * - `false` 或未配置: 不生成 customData
-     */
-    htmlCustomData?: boolean | string;
-    /**
-     * 生成 Vue SFC 模板补全用的组件类型声明文件（`components.d.ts`）。
-     * - `true`: 输出到 `vite.config.ts` 同级目录的 `components.d.ts`
-     * - 传入字符串: 自定义输出路径 (支持绝对/相对路径)
-     * - `false` 或未配置: 不生成类型文件
-     */
-    vueComponents?: boolean | string;
-    /**
-     * 生成 `components.d.ts` 时使用的运行时模块名（`declare module 'xxx'`）。
-     * - 默认 `'vue'`
-     * - 使用 wevu 并设置 `vueCompilerOptions.lib = "wevu"` 时请改为 `'wevu'`
-     */
-    vueComponentsModule?: string;
-}
-type AutoImportComponentsOption = AutoImportComponents | false;
-type EnhanceWxmlOptions = ScanWxmlOptions & HandleWxmlOptions;
-interface ScanWxmlOptions {
-    excludeComponent?: (tagName: string) => boolean;
-    platform?: MpPlatform;
-}
-interface HandleWxmlOptions {
-    removeComment?: boolean;
-    transformEvent?: boolean;
-    scriptModuleExtension?: string;
-    scriptModuleTag?: string;
-    templateExtension?: string;
-}
-interface EnhanceOptions {
-    /**
-     * 增强：wxml
-     */
-    wxml?: boolean | (Partial<Omit<EnhanceWxmlOptions, 'platform'>>);
-    /**
-     * 增强：wxs
-     */
-    wxs?: boolean;
-    /**
-     * 自动导入小程序组件
-     */
-    autoImportComponents?: AutoImportComponentsOption;
-}
 interface BuildNpmPackageMeta {
     name: string;
     entry: InputOption;
 }
 interface NpmSubPackageConfig {
-    /**
-     * @description 分包本地 npm 依赖范围
-     *
-     * 当声明该字段后，会为对应分包输出本地 `miniprogram_npm`，
-     * 并将分包内命中的 npm 引用本地化到该目录。
-     */
     dependencies?: (string | RegExp)[];
 }
 interface NpmMainPackageConfig {
-    /**
-     * @description 主包 `miniprogram_npm` 依赖输出范围
-     * - `undefined`: 默认行为，按根 `package.json.dependencies` 全量输出到主包
-     * - `false`: 禁止输出主包 `miniprogram_npm`
-     * - `string[] | RegExp[]`: 仅输出命中的依赖到主包
-     *
-     * 适用于依赖只希望落在特定分包 `miniprogram_npm` 的场景，
-     * 需配合 `weapp.npm.subPackages.<root>.dependencies` 显式声明各分包依赖集。
-     */
     dependencies?: false | (string | RegExp)[];
 }
 type JsFormat = 'cjs' | 'esm';
@@ -455,495 +249,280 @@ interface JsonMergeContext {
 type JsonMergeFunction = (target: Record<string, any>, source: Record<string, any>, context: JsonMergeContext) => Record<string, any> | void;
 type JsonMergeStrategy = 'deep' | 'assign' | 'replace' | JsonMergeFunction;
 interface JsonConfig {
-    /**
-     * @description 产物 JSON 默认值（用于 app/page/component）
-     */
     defaults?: {
         app?: Record<string, any>;
         page?: Record<string, any>;
         component?: Record<string, any>;
     };
-    /**
-     * @description JSON 合并策略
-     * - `deep`: 深合并（默认）
-     * - `assign`: 浅合并（Object.assign）
-     * - `replace`: 直接替换
-     * - `function`: 自定义合并函数
-     */
     mergeStrategy?: JsonMergeStrategy;
 }
 interface ChunksConfig {
-    /**
-     * @description 控制跨分包共享代码的输出策略
-     * - `duplicate`: 默认策略，将共享代码复制到各自的分包中
-     * - `hoist`: 将共享代码提炼到主包中
-     * @default 'duplicate'
-     */
     sharedStrategy?: SharedChunkStrategy;
+    sharedMode?: SharedChunkMode;
+    sharedOverrides?: SharedChunkOverride[];
+    sharedPathRoot?: string;
+    dynamicImports?: SharedChunkDynamicImports;
+    logOptimization?: boolean;
+    forceDuplicatePatterns?: (string | RegExp)[];
+    duplicateWarningBytes?: number;
+}
+
+/**
+ * @description 自动导入组件配置
+ */
+interface AutoImportComponents {
     /**
-     * @description 控制共享模块的输出形态
-     * - `common`: 默认策略，复用模块会被抽到 common.js
-     * - `path`: 共享模块按源码相对路径输出（无 common.js）
-     * - `inline`: 禁用共享 chunk，复用模块将内联到引用方
-     * @default 'common'
+     * @description 组件扫描范围
      */
-    sharedMode?: SharedChunkMode;
+    globs?: string[];
     /**
-     * @description 针对特定模块/目录覆盖共享输出策略，支持 glob 或正则表达式。
-     * 匹配基于 srcRoot 的相对路径或绝对路径。
+     * @description 组件解析器列表
      */
-    sharedOverrides?: SharedChunkOverride[];
+    resolvers?: Resolver[];
     /**
-     * @description 当 sharedMode 为 `path` 时，用于计算输出路径的根目录（相对 cwd）。
-     * @default srcRoot
+     * @description 组件清单输出路径
      */
-    sharedPathRoot?: string;
+    output?: string | boolean;
     /**
-     * @description 动态 import 的处理方式
-     * - `preserve`: 保持独立 chunk
-     * - `inline`: 尝试内联动态 import
-     * @default 'preserve'
+     * @description WXML 组件 props 类型声明输出路径
      */
-    dynamicImports?: SharedChunkDynamicImports;
+    typedComponents?: boolean | string;
     /**
-     * @description 是否输出分包优化日志，帮助确认共享模块被复制或回退的位置
-     * @default true
+     * @description VS Code HTML customData 输出路径
      */
-    logOptimization?: boolean;
+    htmlCustomData?: boolean | string;
     /**
-     * @description 强制按分包复制的模块匹配规则。当共享模块的直接导入方命中这些规则时，
-     * 其「主包」身份会被忽略，继续沿用 duplicate 策略。支持字符串或正则表达式，默认基于 srcRoot 的相对路径匹配。
+     * @description Vue SFC 组件声明输出路径
      */
-    forceDuplicatePatterns?: (string | RegExp)[];
+    vueComponents?: boolean | string;
     /**
-     * @description 当共享模块复制后的冗余体积（字节）超过该阈值时输出警告。设置为 0 或 undefined 则禁用。
-     * @default 524288 (约 512 KB)
+     * @description 生成 `components.d.ts` 时使用的运行时模块名
      */
-    duplicateWarningBytes?: number;
+    vueComponentsModule?: string;
+}
+type AutoImportComponentsOption = AutoImportComponents | boolean;
+type EnhanceWxmlOptions = ScanWxmlOptions & HandleWxmlOptions;
+/**
+ * @description WXML 扫描阶段配置
+ */
+interface ScanWxmlOptions {
+    excludeComponent?: (tagName: string) => boolean;
+    platform?: MpPlatform;
 }
+/**
+ * @description WXML 处理阶段配置
+ */
+interface HandleWxmlOptions {
+    removeComment?: boolean;
+    transformEvent?: boolean;
+    scriptModuleExtension?: string;
+    scriptModuleTag?: string;
+    templateExtension?: string;
+}
+interface EnhanceOptions {
+    wxml?: boolean | Partial<Omit<EnhanceWxmlOptions, 'platform'>>;
+    wxs?: boolean;
+    autoImportComponents?: AutoImportComponentsOption;
+}
+/**
+ * @description 多平台 project.config 配置
+ */
 interface MultiPlatformConfig {
-    /**
-     * @description 是否启用多平台 project.config 解析
-     * @default true
-     * @example
-     * enabled: true
-     */
     enabled?: boolean;
-    /**
-     * @description 平台 project.config 目录根（实际读取 `${root}/${platform}/<platformConfigFile>`）
-     * @default 'config'
-     * @example
-     * projectConfigRoot: 'config'
-     */
     projectConfigRoot?: string;
 }
+/**
+ * @description MCP 服务配置
+ */
 interface WeappMcpConfig {
-    /**
-     * @description 是否启用 MCP 能力
-     * @default true
-     */
     enabled?: boolean;
-    /**
-     * @description 是否在 weapp-vite CLI 启动时自动拉起 MCP HTTP 服务
-     * @default false
-     */
     autoStart?: boolean;
-    /**
-     * @description MCP HTTP 服务监听主机
-     * @default '127.0.0.1'
-     */
     host?: string;
+    port?: number;
+    endpoint?: string;
+}
+/**
+ * @description 自动路由配置
+ */
+type WeappAutoRoutesIncludePattern = string | RegExp;
+/**
+ * @description 自动路由包含规则
+ */
+type WeappAutoRoutesInclude = WeappAutoRoutesIncludePattern | WeappAutoRoutesIncludePattern[];
+/**
+ * @description 自动路由配置
+ */
+interface WeappAutoRoutesConfig {
+    enabled?: boolean;
+    typedRouter?: boolean;
     /**
-     * @description MCP HTTP 服务监听端口
-     * @default 3088
+     * @description 自动路由扫描规则，支持字符串 glob、正则以及它们的数组
+     * @remarks 默认会扫描主包 `pages/**`，以及已声明分包 root 下的 `pages/**`
      */
-    port?: number;
+    include?: WeappAutoRoutesInclude;
     /**
-     * @description MCP HTTP 接口路径
-     * @default '/mcp'
+     * @description 是否启用自动路由持久化缓存，或指定自定义缓存文件路径
+     * @default false
      */
-    endpoint?: string;
+    persistentCache?: boolean | string;
+    watch?: boolean;
+}
+/**
+ * @description `@wevu/api` 注入配置
+ */
+interface WeappInjectWeapiConfig {
+    enabled?: boolean;
+    replaceWx?: boolean;
+    globalName?: string;
+}
+/**
+ * @description 本地 npm 构建配置
+ */
+interface WeappNpmConfig {
+    enable?: boolean;
+    cache?: boolean;
+    mainPackage?: NpmMainPackageConfig;
+    subPackages?: Record<string, NpmSubPackageConfig>;
+    buildOptions?: (options: NpmBuildOptions, pkgMeta: BuildNpmPackageMeta) => NpmBuildOptions | undefined;
+    alipayNpmMode?: AlipayNpmMode;
+}
+/**
+ * @description 分包级额外配置
+ */
+interface WeappSubPackageConfig {
+    independent?: boolean;
+    inlineConfig?: Partial<InlineConfig>;
+    autoImportComponents?: AutoImportComponentsOption;
+    watchSharedStyles?: boolean;
+    styles?: SubPackageStyleConfigEntry | SubPackageStyleConfigEntry[];
+}
+/**
+ * @description HMR 配置
+ */
+interface WeappHmrConfig {
+    sharedChunks?: 'full' | 'auto' | 'off';
+    touchAppWxss?: boolean | 'auto';
+}
+/**
+ * @description worker 构建配置
+ */
+interface WeappWorkerConfig {
+    entry?: string | string[];
+}
+/**
+ * @description Vue 模板编译配置
+ */
+interface WeappVueTemplateConfig {
+    removeComments?: boolean;
+    simplifyWhitespace?: boolean;
+    scopedSlotsCompiler?: 'auto' | 'augmented' | 'off';
+    scopedSlotsRequireProps?: boolean;
+    slotMultipleInstance?: boolean;
+    classStyleRuntime?: 'auto' | 'wxs' | 'js';
+    objectLiteralBindMode?: 'runtime' | 'inline';
+    mustacheInterpolation?: 'compact' | 'spaced';
+    classStyleWxsShared?: boolean;
+}
+/**
+ * @description Vue 支持配置
+ */
+interface WeappVueConfig {
+    enable?: boolean;
+    template?: WeappVueTemplateConfig;
+    autoImport?: boolean;
+}
+/**
+ * @description wevu 编译期默认值配置
+ */
+interface WeappWevuConfig {
+    preset?: 'performance';
+    defaults?: WevuDefaults;
+    autoSetDataPick?: boolean;
+}
+
+/**
+ * @description 分包元信息
+ */
+interface SubPackageMetaValue {
+    entries: string[];
+    subPackage: SubPackage;
+    autoImportComponents?: AutoImportComponentsOption;
+    styleEntries?: SubPackageStyleEntry[];
+    watchSharedStyles?: boolean;
+}
+/**
+ * @description 调试输出配置
+ */
+interface WeappDebugConfig {
+    watchFiles?: (watchFiles: string[], subPackageMeta?: SubPackageMetaValue) => void;
+    resolveId?: (id: string, subPackageMeta?: SubPackageMetaValue) => void;
+    load?: (id: string, subPackageMeta?: SubPackageMetaValue) => void;
+    inspect?: WrapPluginOptions;
 }
+/**
+ * @description weapp-vite 主配置
+ */
 interface WeappViteConfig {
     /**
      * 应用入口目录（`app.json` 所在目录）。
-     * 默认 js 模板在根目录 `.`，ts 模板在 `miniprogram` 目录；
-     * 你也可以把所有代码放在 `src` 目录下，并设置此选项为 `src`。
-     * @default '.'
-     * @example
-     * srcRoot: 'src'
      */
     srcRoot?: string;
     /**
-     * @description 是否启用自动路由模块 (`weapp-vite/auto-routes`)
-     * 默认关闭，需要显式启用后才会扫描 `pages/` 目录并生成路由清单。
-     * @default false
-     * @example
-     * autoRoutes: true
+     * 自动路由模块配置。
+     * - `undefined` / `false`: 默认关闭
+     * - `true`: 启用默认自动路由配置
+     * - `object`: 启用自动路由并允许细粒度控制
      */
-    autoRoutes?: boolean;
+    autoRoutes?: boolean | WeappAutoRoutesConfig;
     /**
-     * @description 插件入口目录 (plugin.json 所在的目录)
-     * @default undefined
-     * @example
-     * pluginRoot: 'plugin'
+     * 插件入口目录（`plugin.json` 所在目录）。
      */
     pluginRoot?: string;
     /**
-     * @description 日志输出配置（全局 + 按 tag 细分）
-     * @example
-     * logger: { level: 'info', tags: { build: true } }
+     * 日志输出配置。
      */
     logger?: LoggerConfig;
     /**
-     * @group json 配置
-     * 文件引入别名
-     * @example
-     * jsonAlias: {
-     *   '@': '/src',
-     * }
+     * 主包/分包体积告警阈值（字节）。
      */
+    packageSizeWarningBytes?: number;
     jsonAlias?: AliasOptions;
-    /**
-     *
-     * @group 构建 npm
-     */
-    npm?: {
-        /**
-         * @description 是否开启构建 npm 功能, 默认为 true
-         * @default true
-         * @example
-         * enable: true
-         */
-        enable?: boolean;
-        /**
-         * @description 是否开启缓存，默认为 true
-         * @default true
-         * @example
-         * cache: true
-         */
-        cache?: boolean;
-        /**
-         * @description 主包本地 npm 构建配置
-         */
-        mainPackage?: NpmMainPackageConfig;
-        /**
-         * @description 分包本地 npm 构建配置
-         *
-         * 配置后，命中的分包会输出自己的 `miniprogram_npm`，
-         * 并将分包内命中的 npm 引用本地化到分包目录。
-         */
-        subPackages?: Record<string, NpmSubPackageConfig>;
-        /**
-         * @description 构建 npm 的配置，可传入 Vite 的库模式配置，让不同的包走不同的配置
-         * - 返回值中的 `build.outDir` 同时影响二次 bundle 的依赖与直接复制 `miniprogram` 产物的依赖
-         * @example
-         * buildOptions: (options, pkg) => {
-         *   if (pkg.name === 'my-lib') return { ...options, minify: false }
-         * }
-         */
-        buildOptions?: (options: NpmBuildOptions, pkgMeta: BuildNpmPackageMeta) => NpmBuildOptions | undefined;
-        /**
-         * @description 支付宝平台 npm 依赖输出模式
-         * - `node_modules`: 输出到 dist/node_modules（默认，贴近支付宝 npm 管理语义）
-         * - `miniprogram_npm`: 输出到 dist/miniprogram_npm（兼容微信风格目录）
-         * @default 'node_modules'
-         */
-        alipayNpmMode?: AlipayNpmMode;
-    };
-    /**
-     * @group 生成脚手架配置
-     * 生成器（weapp-vite generate）相关配置
-     * @example
-     * generate: { dirs: { page: 'src/pages' } }
-     */
+    npm?: WeappNpmConfig;
     generate?: GenerateOptions;
-    /**
-     * @group 插件集成
-     * 传递给内置 [`vite-tsconfig-paths`](https://www.npmjs.com/package/vite-tsconfig-paths) 插件的参数
-     * - 传入 `false` 可显式禁用该插件（当项目没有 `paths/baseUrl` 时建议关闭以提速）
-     * @example
-     * tsconfigPaths: { projects: ['tsconfig.json'] }
-     */
     tsconfigPaths?: PluginOptions | false;
-    /**
-     * @group 分包配置
-     * 分包是否独立的 rollup 编译上下文
-     * 默认情况下，当一个分包设置了 independent: true 之后会默认启用
-     * 可以设置 key: 为 root, value: {independent:true} 来强制启用 独立的 rollup 编译上下文
-     */
-    subPackages?: Record<string, Pick<SubPackage, 'independent' | 'inlineConfig'> & {
-        autoImportComponents?: AutoImportComponentsOption;
-        /** 分包文件变更时是否强制重新生成共享样式产物，默认启用 */
-        watchSharedStyles?: boolean;
-        /**
-         * 分包共享样式入口，支持传入一个或多个 `wxss`/`css` 文件路径
-         * - 相对路径默认基于当前分包的 `root`
-         * - 也可以传入绝对路径或相对 `srcRoot` 的路径
-         * - 支持传入对象配置 `scope`/`include`/`exclude` 精准控制注入范围
-         * @example
-         * styles: [
-         *   'styles/shared.wxss',
-         *   { path: 'styles/sub.wxss', scope: 'page' },
-         * ]
-         */
-        styles?: SubPackageStyleConfigEntry | SubPackageStyleConfigEntry[];
-    }>;
-    /**
-     * 需要被额外包括的资源
-     * 默认情况下包括大部分的图片资源格式
-     * @example
-     * copy: ['static/**\\/*']
-     */
+    subPackages?: Record<string, WeappSubPackageConfig>;
     copy?: CopyOptions;
-    /**
-     * @group Web 运行时
-     * 浏览器端运行时相关配置
-     * @example
-     * web: { enabled: true, srcDir: 'src', outDir: 'dist/web' }
-     */
     web?: WeappWebConfig;
-    /**
-     * @group 库模式
-     * 用于构建组件库或小程序模块的 lib 模式配置
-     */
     lib?: WeappLibConfig;
-    /**
-     * @description 额外的 wxml 文件
-     * 把这个方法，扫描到的 `wxml` 添加到额外的 `wxml` 文件列表, **处理** 之后输出到最终的产物中
-     * @param wxmlFilePath
-     * @returns boolean
-     * @example
-     * isAdditionalWxml: (file) => file.includes('custom')
-     */
     isAdditionalWxml?: (wxmlFilePath: string) => boolean;
-    /**
-     * @description 编译目标平台
-     * @ignore
-     */
     platform?: MpPlatform;
-    /**
-     * @description 多平台 project.config 支持
-     * - `true` 等价于 `{ enabled: true, projectConfigRoot: 'config' }`
-     * - 启用后必须通过 CLI `--platform` 指定目标小程序平台
-     * @example
-     * multiPlatform: true
-     * @example
-     * multiPlatform: { enabled: true, projectConfigRoot: 'config' }
-     */
     multiPlatform?: boolean | MultiPlatformConfig;
-    /**
-     * @description 生成的 JS 模块格式
-     * - `cjs`: 输出 CommonJS
-     * - `esm`: 输出 ESM，需要在微信开发者工具中启用「ES6 转 ES5」
-     * @default 'cjs'
-     * @example
-     * jsFormat: 'cjs'
-     */
     jsFormat?: JsFormat;
     /**
-     * @description 是否启用基于 `@swc/core` 的 ES5 降级（仅支持 `jsFormat: 'cjs'`）
-     * @default false
-     * @example
-     * es5: true
+     * @deprecated 已废弃，不建议继续使用。请改为保持 `build.target >= es2020`，并在开发者工具中开启“将 JS 编译成 ES5”功能。
+     * 该选项依赖 `@swc/core` 做额外 ES5 降级，后续版本将移除。
      */
     es5?: boolean;
     wxml?: EnhanceOptions['wxml'];
-    /**
-     * 增强：wxs
-     */
     wxs?: EnhanceOptions['wxs'];
-    /**
-     * 自动导入小程序组件
-     */
     autoImportComponents?: AutoImportComponentsOption;
-    /**
-     * @deprecated 请改用顶层的 `wxml`、`wxs` 与 `autoImportComponents`
-     * 增强配置
-     */
     enhance?: EnhanceOptions;
-    debug?: {
-        watchFiles?: (watchFiles: string[], subPackageMeta?: SubPackageMetaValue) => void;
-        resolveId?: (id: string, subPackageMeta?: SubPackageMetaValue) => void;
-        load?: (id: string, subPackageMeta?: SubPackageMetaValue) => void;
-        inspect?: WrapPluginOptions;
-    };
-    /**
-     * @description 开发服务器相关配置
-     */
-    hmr?: {
-        /**
-         * @description HMR 期间共享 chunk 的处理策略
-         * - `full`: 每次更新都重新产出全部 entry（最稳定，速度较慢）
-         * - `auto`: 仅在共享 chunk 可能被部分覆盖时回退到 full（稳定与速度折中）
-         * - `off`: 仅更新变更 entry（最快，但可能导致共享 chunk 导出不一致）
-         * @default 'auto'
-         */
-        sharedChunks?: 'full' | 'auto' | 'off';
-        /**
-         * @description Dev 构建结束后触碰 app.wxss 以触发微信开发者工具热重载
-         * - `true`: 总是启用
-         * - `false`: 关闭
-         * - `auto`: 检测到安装 weapp-tailwindcss 时启用
-         * @default 'auto'
-         */
-        touchAppWxss?: boolean | 'auto';
-    };
-    /**
-     * @description 构建 worker 配置
-     */
-    worker?: {
-        /**
-         * @description 构建 worker 的入口
-         */
-        entry?: string | string[];
-    };
-    /**
-     * @description Vue 单文件组件支持配置
-     */
-    vue?: {
-        /**
-         * @description 是否启用 Vue 支持
-         * @default true
-         */
-        enable?: boolean;
-        /**
-         * @description 模板编译选项
-         */
-        template?: {
-            /**
-             * @description 是否移除注释
-             * @default true
-             */
-            removeComments?: boolean;
-            /**
-             * @description 是否简化空白符
-             * @default true
-             */
-            simplifyWhitespace?: boolean;
-            /**
-             * @description 作用域插槽编译策略
-             * - `auto`: 自动选择最小可用的 scoped slot 方案
-             * - `augmented`: 强制使用增强方案
-             * - `off`: 关闭 scoped slot 编译（仅保留原生 slot，不支持 slot props）
-             * @default 'auto'
-             */
-            scopedSlotsCompiler?: 'auto' | 'augmented' | 'off';
-            /**
-             * @description 是否仅在 slot 传递作用域参数时生成 scoped slot 组件
-             * - `true`: 仅对带作用域参数的 v-slot 生成 scoped slot 组件
-             * - `false`: 所有 v-slot 都生成 scoped slot 组件（旧行为）
-             * @default true
-             */
-            scopedSlotsRequireProps?: boolean;
-            /**
-             * @description v-for 下 scoped slot 多实例模式
-             * @default true
-             */
-            slotMultipleInstance?: boolean;
-            /**
-             * @description class/style 绑定运行时
-             * - `auto`: 平台支持 WXS 时优先 WXS，否则回退 JS
-             * - `wxs`: 强制使用 WXS（不可用时回退 JS 并告警）
-             * - `js`: 强制使用 JS（默认；用于获得更稳定的一致性）
-             * @default 'js'
-             */
-            classStyleRuntime?: 'auto' | 'wxs' | 'js';
-            /**
-             * @description 对象字面量 v-bind 编译模式
-             * - `runtime`: 通过运行时中间变量绑定（默认，当前行为）
-             * - `inline`: 直接内联输出对象字面量（会在插值两侧补空格以避免 `{{{`）
-             * @default 'runtime'
-             */
-            objectLiteralBindMode?: 'runtime' | 'inline';
-            /**
-             * @description Mustache 插值输出风格
-             * - `compact`: 紧凑输出（`{{expr}}`，默认，当前行为）
-             * - `spaced`: 空格友好输出（`{{ expr }}`）
-             * @default 'compact'
-             */
-            mustacheInterpolation?: 'compact' | 'spaced';
-            /**
-             * @description 是否复用 class/style WXS 运行时（主包与非独立分包共享，独立分包各自生成）
-             * @default true
-             */
-            classStyleWxsShared?: boolean;
-        };
-        /**
-         * @description 是否自动导入 Vue 组件
-         */
-        autoImport?: boolean;
-    };
-    /**
-     * @description wevu 运行时默认值（编译期注入）
-     */
-    wevu?: {
-        /**
-         * @description wevu 预设配置
-         * - `performance`：开启性能向默认项（如 patch + suspendWhenHidden + diagnostics=fallback + dev 高频告警），并默认启用 autoSetDataPick（可显式覆盖）
-         */
-        preset?: 'performance';
-        /**
-         * @description wevu createApp/defineComponent 默认值
-         */
-        defaults?: WevuDefaults;
-        /**
-         * @description 自动从编译后的模板表达式推导渲染相关顶层 key，并注入到组件/页面的 `setData.pick`
-         * @default false
-         */
-        autoSetDataPick?: boolean;
-    };
-    /**
-     * @description 全局注入 @wevu/api 的 wpi 实例
-     * - enabled 为 true 时会在 App 入口注入 wpi
-     * - replaceWx 为 true 时会用 wpi 替换全局 wx/my 以及当前平台全局对象
-     * @default { enabled: false, replaceWx: false, globalName: 'wpi' }
-     * @example
-     * injectWeapi: { enabled: true, replaceWx: false }
-     */
-    injectWeapi?: boolean | {
-        /**
-         * @description 是否启用全局注入
-         * @default false
-         */
-        enabled?: boolean;
-        /**
-         * @description 是否使用 wpi 替换全局 wx/my 以及当前平台全局对象
-         * @default false
-         */
-        replaceWx?: boolean;
-        /**
-         * @description 全局变量名
-         * @default 'wpi'
-         */
-        globalName?: string;
-    };
-    /**
-     * @description MCP 服务配置
-     * - `false`：完全关闭 MCP（包含自动启动）
-     * - `true`：启用默认 MCP 配置
-     * - `object`：细粒度配置
-     * @default { enabled: true, autoStart: false, host: '127.0.0.1', port: 3088, endpoint: '/mcp' }
-     * @example
-     * mcp: false
-     * @example
-     * mcp: { enabled: true, autoStart: false }
-     * @example
-     * mcp: { host: '127.0.0.1', port: 3199, endpoint: '/mcp' }
-     */
+    debug?: WeappDebugConfig;
+    hmr?: WeappHmrConfig;
+    worker?: WeappWorkerConfig;
+    vue?: WeappVueConfig;
+    wevu?: WeappWevuConfig;
+    injectWeapi?: boolean | WeappInjectWeapiConfig;
     mcp?: boolean | WeappMcpConfig;
-    /**
-     * @description 共享代码拆分策略配置
-     */
     chunks?: ChunksConfig;
-    /**
-     * @description JSON 产物合并配置
-     */
     json?: JsonConfig;
 }
 type UserConfig$1 = UserConfig$2 & {
     weapp?: WeappViteConfig;
 };
+/**
+ * @description 小程序 project.config 结构
+ */
 interface ProjectConfig {
     miniprogramRoot?: string;
     srcMiniprogramRoot?: string;
@@ -956,13 +535,6 @@ interface ProjectConfig {
         }[];
     };
 }
-interface SubPackageMetaValue {
-    entries: string[];
-    subPackage: SubPackage;
-    autoImportComponents?: AutoImportComponentsOption;
-    styleEntries?: SubPackageStyleEntry[];
-    watchSharedStyles?: boolean;
-}
 
 interface WxmlDep {
     tagName: string;
@@ -1267,6 +839,7 @@ interface RuntimeState {
         initialized: boolean;
         candidates: Map<string, AutoRoutesCandidateState>;
         needsFullRescan: boolean;
+        loadingAppConfig: boolean;
     };
     autoImport: {
         registry: Map<string, LocalAutoImportMatch>;
@@ -1475,4 +1048,4 @@ declare function defineConfig(config: UserConfigFnPromise): UserConfigFnPromise;
 declare function defineConfig(config: UserConfigFn): UserConfigFn;
 declare function defineConfig(config: UserConfigLoose): UserConfigLoose;
 
-export { type GenerateTemplateInlineSource as $, type Alias as A, type BaseEntry as B, type CompilerContext as C, type BuildNpmPackageMeta as D, type ChangeEvent as E, type ChunksConfig as F, type ComponentEntry as G, type ComponentsMap as H, type CopyGlobs as I, type CopyOptions as J, type EnhanceOptions as K, type LoadConfigOptions as L, type EnhanceWxmlOptions as M, type Entry as N, type EntryJsonFragment as O, type GenerateDirsOptions as P, type GenerateExtensionsOptions as Q, type GenerateFileType as R, type GenerateFilenamesOptions as S, type GenerateOptions as T, type UserConfig as U, type GenerateTemplate as V, WEAPP_VITE_HOST_NAME as W, type GenerateTemplateContext as X, type GenerateTemplateEntry as Y, type GenerateTemplateFactory as Z, type GenerateTemplateFileSource as _, type UserConfigExport as a, type GenerateTemplateScope as a0, type GenerateTemplatesConfig as a1, type HandleWxmlOptions as a2, type JsFormat as a3, type JsonConfig as a4, type JsonMergeContext as a5, type JsonMergeFunction as a6, type JsonMergeStage as a7, type JsonMergeStrategy as a8, type MpPlatform as a9, type WeappLibVueTscOptions as aA, type WeappVitePluginApi as aB, type WeappWebConfig as aC, type WxmlDep as aD, type MultiPlatformConfig as aa, type NpmBuildOptions as ab, type NpmMainPackageConfig as ac, type NpmSubPackageConfig as ad, type PageEntry as ae, type ProjectConfig as af, type ResolvedAlias as ag, type ScanComponentItem as ah, type ScanWxmlOptions as ai, type SharedChunkDynamicImports as aj, type SharedChunkMode as ak, type SharedChunkOverride as al, type SharedChunkStrategy as am, type SubPackage as an, type SubPackageMetaValue as ao, type SubPackageStyleConfigEntry as ap, type SubPackageStyleConfigObject as aq, type SubPackageStyleEntry as ar, type SubPackageStyleScope as as, type UserConfig$1 as at, type WeappLibComponentJson as au, type WeappLibConfig as av, type WeappLibDtsOptions as aw, type WeappLibEntryContext as ax, type WeappLibFileName as ay, type WeappLibInternalDtsOptions as az, type UserConfigFn as b, type UserConfigFnNoEnv as c, type UserConfigFnNoEnvPlain as d, type UserConfigFnObject as e, type UserConfigFnObjectPlain as f, type UserConfigFnPromise as g, type WeappViteConfig as h, type WeappViteHostMeta as i, type WeappViteRuntime as j, applyWeappViteHostMeta as k, createWeappViteHostMeta as l, defineAppJson as m, defineComponentJson as n, defineConfig as o, definePageJson as p, defineSitemapJson as q, defineThemeJson as r, isWeappViteHost as s, resolveWeappViteHostMeta as t, type WeappMcpConfig as u, type AliasOptions as v, type AlipayNpmMode as w, type AppEntry as x, type AutoImportComponents as y, type AutoImportComponentsOption as z };
+export { type GenerateTemplateInlineSource as $, type Alias as A, type BaseEntry as B, type CompilerContext as C, type BuildNpmPackageMeta as D, type ChangeEvent as E, type ChunksConfig as F, type ComponentEntry as G, type ComponentsMap as H, type CopyGlobs as I, type CopyOptions as J, type EnhanceOptions as K, type LoadConfigOptions as L, type EnhanceWxmlOptions as M, type Entry as N, type EntryJsonFragment as O, type GenerateDirsOptions as P, type GenerateExtensionsOptions as Q, type GenerateFileType as R, type GenerateFilenamesOptions as S, type GenerateOptions as T, type UserConfig as U, type GenerateTemplate as V, WEAPP_VITE_HOST_NAME as W, type GenerateTemplateContext as X, type GenerateTemplateEntry as Y, type GenerateTemplateFactory as Z, type GenerateTemplateFileSource as _, type UserConfigExport as a, type GenerateTemplateScope as a0, type GenerateTemplatesConfig as a1, type HandleWxmlOptions as a2, type JsFormat as a3, type JsonConfig as a4, type JsonMergeContext as a5, type JsonMergeFunction as a6, type JsonMergeStage as a7, type JsonMergeStrategy as a8, type MpPlatform as a9, type WeappLibComponentJson as aA, type WeappLibConfig as aB, type WeappLibDtsOptions as aC, type WeappLibEntryContext as aD, type WeappLibFileName as aE, type WeappLibInternalDtsOptions as aF, type WeappLibVueTscOptions as aG, type WeappNpmConfig as aH, type WeappSubPackageConfig as aI, type WeappVitePluginApi as aJ, type WeappVueConfig as aK, type WeappVueTemplateConfig as aL, type WeappWebConfig as aM, type WeappWevuConfig as aN, type WeappWorkerConfig as aO, type WxmlDep as aP, type MultiPlatformConfig as aa, type NpmBuildOptions as ab, type NpmMainPackageConfig as ac, type NpmSubPackageConfig as ad, type PageEntry as ae, type ProjectConfig as af, type ResolvedAlias as ag, type ScanComponentItem as ah, type ScanWxmlOptions as ai, type SharedChunkDynamicImports as aj, type SharedChunkMode as ak, type SharedChunkOverride as al, type SharedChunkStrategy as am, type SubPackage as an, type SubPackageMetaValue as ao, type SubPackageStyleConfigEntry as ap, type SubPackageStyleConfigObject as aq, type SubPackageStyleEntry as ar, type SubPackageStyleScope as as, type UserConfig$1 as at, type WeappAutoRoutesConfig as au, type WeappAutoRoutesInclude as av, type WeappAutoRoutesIncludePattern as aw, type WeappDebugConfig as ax, type WeappHmrConfig as ay, type WeappInjectWeapiConfig as az, type UserConfigFn as b, type UserConfigFnNoEnv as c, type UserConfigFnNoEnvPlain as d, type UserConfigFnObject as e, type UserConfigFnObjectPlain as f, type UserConfigFnPromise as g, type WeappViteConfig as h, type WeappViteHostMeta as i, type WeappViteRuntime as j, applyWeappViteHostMeta as k, createWeappViteHostMeta as l, defineAppJson as m, defineComponentJson as n, defineConfig as o, definePageJson as p, defineSitemapJson as q, defineThemeJson as r, isWeappViteHost as s, resolveWeappViteHostMeta as t, type WeappMcpConfig as u, type AliasOptions as v, type AlipayNpmMode as w, type AppEntry as x, type AutoImportComponents as y, type AutoImportComponentsOption as z };