weapp-vite 7.3.0 → 7.5.0

package/dist/{config-1J4rToMR.d.mts → config-V0L-IAJf.d.mts}

@@ -6,23 +6,24 @@ import { WeappAstConfig } from "@weapp-vite/ast";
 import "@weapp-vite/ast/operations/onPageScroll";
 import { LoggerConfig } from "@weapp-core/logger";
 import "@weapp-vite/ast/babel";
-import { ComponentStyleOptions, ResolveSfcBlockSrcOptions, StaticRouteValue, VueSfcBlockSignatures } from "wevu/compiler";
-import { ConfigEnv, ConfigEnv as ConfigEnv$1, InlineConfig, InlineConfig as InlineConfig$1, Plugin as Plugin$1, PluginOption, ResolvedConfig, ResolvedConfig as ResolvedConfig$1, UserConfig, ViteDevServer, ViteDevServer as ViteDevServer$1, build } from "vite";
+import { ComponentStyleOptions, JsonConfig, JsonMergeContext, JsonMergeFunction, JsonMergeStage, JsonMergeStrategy, ResolveSfcBlockSrcOptions, StaticRouteValue, VueSfcBlockSignatures } from "wevu/compiler";
+import { ConfigEnv, ConfigEnv as ConfigEnv$1, InlineConfig, InlineConfig as InlineConfig$1, Plugin, Plugin as Plugin$2, PluginOption, ResolvedConfig, ResolvedConfig as ResolvedConfig$1, UserConfig, ViteDevServer, ViteDevServer as ViteDevServer$1, build } from "vite";
 import { LRUCache } from "lru-cache";
 import { fdir } from "fdir";
-import { InputOption, OutputBundle, ResolvedId, RolldownBuild, RolldownOptions, RolldownOutput, RolldownOutput as RolldownOutput$1, RolldownPlugin, RolldownPluginOption, RolldownWatcher, RolldownWatcher as RolldownWatcher$1, WatchOptions as RolldownWatchOptions } from "rolldown";
-import { Options } from "rolldown-plugin-dts";
+import { HmrCompilerAsset as WeappCompilerHmrAsset, HmrCompilerPreparation, HmrCompilerPreparation as WeappCompilerHmrPreparation, HmrCompilerRequest, HmrCompilerRequest as WeappCompilerHmrRequest } from "@weapp-vite/hmr";
 import PQueue from "p-queue";
 import { Buffer } from "node:buffer";
-import { PluginOptions } from "vite-tsconfig-paths";
 import { WrapPluginOptions } from "vite-plugin-performance";
+import { Options } from "rolldown-plugin-dts";
 import { ComputedDefinitions as ComputedDefinitions$1, MethodDefinitions as MethodDefinitions$1, PageLayoutMeta, Ref, WevuDefaults } from "wevu";
 import { MiniProgramNetworkDefaults } from "@wevu/web-apis";
-import { App, App as App$1, Component, Component as Component$1, GenerateType, Page, Page as Page$1, Plugin, Sitemap, Sitemap as Sitemap$1, Theme, Theme as Theme$1 } from "@weapp-core/schematics";
+import { App, App as App$1, Component, Component as Component$1, GenerateType, Page, Page as Page$1, Plugin as Plugin$1, Sitemap, Sitemap as Sitemap$1, Theme, Theme as Theme$1 } from "@weapp-core/schematics";
+import { InputOption, OutputBundle, OutputChunk, ResolvedId, RolldownBuild, RolldownOptions, RolldownOutput, RolldownOutput as RolldownOutput$1, RolldownPlugin, RolldownPluginOption, RolldownWatcher, RolldownWatcher as RolldownWatcher$1, WatchOptions as RolldownWatchOptions } from "rolldown";
 import { WeappWebPluginOptions } from "@weapp-vite/web/plugin";
 import { CompilerOptions } from "typescript";
 import { CreateCompilerOptions } from "weapp-tailwindcss/core";
 import { UserDefinedOptions } from "weapp-tailwindcss/types";
+import { PluginOptions } from "vite-tsconfig-paths";
 import { DetectResult } from "package-manager-detector";
 //#region src/runtimeTarget.d.ts
 type WebPlatform = 'web';
@@ -337,22 +338,6 @@ interface SharedChunkOverride {
   test: string | RegExp;
   mode: SharedChunkMode;
 }
-type JsonMergeStage = 'defaults' | 'json-block' | 'auto-using-components' | 'component-generics' | 'macro' | 'emit' | 'merge-existing';
-interface JsonMergeContext {
-  filename?: string;
-  kind?: 'app' | 'page' | 'component' | 'unknown';
-  stage: JsonMergeStage;
-}
-type JsonMergeFunction = (target: Record<string, any>, source: Record<string, any>, context: JsonMergeContext) => Record<string, any> | void;
-type JsonMergeStrategy = 'deep' | 'assign' | 'replace' | JsonMergeFunction;
-interface JsonConfig {
-  defaults?: {
-    app?: Record<string, any>;
-    page?: Record<string, any>;
-    component?: Record<string, any>;
-  };
-  mergeStrategy?: JsonMergeStrategy;
-}
 interface ChunksConfig {
   sharedStrategy?: SharedChunkStrategy;
   sharedMode?: SharedChunkMode;
@@ -368,6 +353,241 @@ interface ChunksConfig {
   duplicateWarningBytes?: number;
 }
 //#endregion
+//#region src/types/config/projectConfig.d.ts
+/** 保留原生工具新增字段，已声明字段仍提供类型检查与补全。 */
+interface NativeOptions {
+  [key: string]: unknown;
+}
+/** 内联配置的公共入口；平台字段由 `MultiPlatformProjectConfigs` 按平台提供。 */
+interface MultiPlatformProjectConfig extends NativeOptions {
+  appid?: string;
+  appId?: string;
+  /** 代码输出目录由构建器管理，请使用 `build.outDir`。 */
+  miniprogramRoot?: never;
+  srcMiniprogramRoot?: never;
+  smartProgramRoot?: never;
+}
+interface PackRule<ExtraType extends string = never> extends NativeOptions {
+  type?: 'file' | 'folder' | 'suffix' | 'prefix' | 'regexp' | ExtraType | (string & {});
+  value?: string;
+}
+interface PackOptions<ExtraType extends string = never> extends NativeOptions {
+  ignore?: PackRule<ExtraType>[];
+  include?: PackRule<ExtraType>[];
+}
+/**
+ * 微信开发者工具配置；不替代 Vite 的构建设置。
+ * @see https://developers.weixin.qq.com/miniprogram/dev/devtools/projectconfig.html
+ */
+interface WeappProjectConfig extends MultiPlatformProjectConfig {
+  projectname?: string;
+  description?: string;
+  compileType?: 'miniprogram' | 'plugin' | (string & {});
+  libVersion?: 'latest' | 'trial' | 'widelyUsed' | (string & {});
+  packOptions?: PackOptions;
+  setting?: NativeOptions & {
+    es6?: boolean;
+    enhance?: boolean;
+    postcss?: boolean;
+    minified?: boolean;
+    minifyWXSS?: boolean;
+    minifyWXML?: boolean;
+    urlCheck?: boolean;
+    compileHotReLoad?: boolean;
+    ignoreUploadUnusedFiles?: boolean;
+    packNpmManually?: boolean;
+    uploadWithSourceMap?: boolean;
+    useCompilerPlugins?: string[] | false;
+    babelSetting?: NativeOptions & {
+      ignore?: string[];
+      outputPath?: string;
+    };
+  };
+}
+/**
+ * 支付宝 format 2 项目配置；编译选项属于 `compileOptions`，而非微信的 `setting`。
+ * @see https://opendocs.alipay.com/mini/03dbc3
+ */
+interface AlipayProjectConfig extends MultiPlatformProjectConfig {
+  format?: number;
+  compileType?: 'mini' | 'plugin' | (string & {});
+  uploadExclude?: string[];
+  assetsInclude?: string[];
+  compileOptions?: NativeOptions & {
+    component2?: boolean;
+    typescript?: boolean;
+    less?: boolean;
+    treeShaking?: boolean;
+    resolveAlias?: Record<string, string>;
+    globalObjectMode?: 'legacy' | 'enable' | 'fake' | (string & {});
+    transpile?: NativeOptions & {
+      script?: NativeOptions & {
+        ignore?: string[];
+      };
+    };
+  };
+  developOptions?: NativeOptions & {
+    hotReload?: boolean;
+    parallel?: boolean;
+    sourcemap?: boolean;
+    minify?: boolean;
+    skipTranspile?: boolean;
+    lazyCompile?: boolean;
+  };
+  scripts?: NativeOptions & {
+    watch?: string;
+    beforeCompile?: string;
+    beforePreview?: string;
+    beforeUpload?: string;
+  };
+}
+/**
+ * 抖音开发者工具配置，保留平台自己的字段名称和类型。
+ * @see https://developer.open-douyin.com/docs/resource/zh-CN/mini-app/develop/framework/general-configuration
+ */
+interface TtProjectConfig extends MultiPlatformProjectConfig {
+  projectname?: string;
+  disablePrivate?: boolean;
+  packOptions?: PackOptions<'glob'>;
+  setting?: NativeOptions & {
+    es6?: boolean;
+    urlCheck?: boolean;
+    autoCompile?: boolean;
+    mockUpdate?: boolean;
+    scripts?: boolean;
+    mockLogin?: boolean;
+    compileHotReLoad?: boolean;
+    nativeCompile?: boolean;
+    IDEPreviewHotRestartCache?: boolean;
+    bigPackageSizeSupport?: boolean;
+    webDetect?: boolean;
+    useCompilerPlugins?: string[];
+  };
+}
+/**
+ * 小红书公开 SDK 默认配置中的稳定字段；未列出的原生字段仍可透传。
+ * @see https://unpkg.com/xhs-mp-project@2.1.6/dist/index.js
+ */
+interface XhsProjectConfig extends MultiPlatformProjectConfig {
+  projectname?: string;
+  description?: string;
+  compileType?: 'miniprogram' | (string & {});
+  libVersion?: 'latest' | (string & {});
+  setting?: NativeOptions & {
+    minified?: boolean;
+    urlCheck?: boolean;
+  };
+}
+/**
+ * 百度智能小程序配置；编译参数属于 `compilation-args.common`。
+ * @see https://unpkg.com/swan-toolkit@3.23.1-beta.1/sdk/program/sdk-impl/compile-impl.js
+ */
+interface SwanProjectConfig extends MultiPlatformProjectConfig {
+  'compileType'?: string;
+  'developType'?: string;
+  'setting'?: NativeOptions & {
+    urlCheck?: boolean;
+  };
+  'compilation-args'?: NativeOptions & {
+    common?: NativeOptions & {
+      ignoreTransJs?: boolean;
+      ignorePrefixCss?: boolean;
+    };
+  };
+}
+/** 六端内联配置映射；按平台补全原生字段，同时允许原生扩展字段。 */
+interface MultiPlatformProjectConfigs {
+  /** 微信：生成 `project.config.json`。 */
+  weapp?: WeappProjectConfig;
+  /** 支付宝：生成 `mini.project.json`。 */
+  alipay?: AlipayProjectConfig;
+  /** 抖音：生成 `project.config.json`。 */
+  tt?: TtProjectConfig;
+  /** 小红书：生成 `project.config.json`。 */
+  xhs?: XhsProjectConfig;
+  /** 京东：生成 `project.config.json`；未建立原生设置 schema 的字段保持透传。 */
+  jd?: MultiPlatformProjectConfig;
+  /** 百度：生成 `project.swan.json`。 */
+  swan?: SwanProjectConfig;
+}
+//#endregion
+//#region src/types/config/wxmlTransform.d.ts
+/** 模板属性的新值；字符串为字面量，表达式只生成绑定而不在构建端求值。 */
+type WxmlAttributeValue = string | number | boolean | {
+  expression: string;
+};
+/** 源码位置使用从零开始的偏移及从一开始的行列。 */
+interface WxmlSourceLocation {
+  readonly offset: number;
+  readonly line: number;
+  readonly column: number;
+}
+/** 原始属性内容不解码、不求值；无值属性的 rawValue 为 null。 */
+interface WxmlAttribute {
+  readonly name: string;
+  readonly rawValue: string | null;
+  readonly quote: string | undefined;
+}
+/** 父节点只提供观察接口，不允许通过子节点改写父树。 */
+interface WxmlElementInfo {
+  /** 当前未删除的直接子标签；不包含文本、注释或脚本模块内容。 */
+  readonly children: readonly WxmlElementInfo[];
+  readonly tagName: string;
+  readonly attributes: readonly WxmlAttribute[];
+  readonly parent: WxmlElementInfo | undefined;
+  readonly location: WxmlSourceLocation;
+  hasAttribute: (name: string) => boolean;
+  getAttribute: (name: string) => WxmlAttribute | undefined;
+}
+/** 当前节点的编辑句柄仅在本次 edit 调用中有效。 */
+interface WxmlTransformNode extends WxmlElementInfo {
+  readonly children: readonly WxmlTransformNode[];
+  /** 按源码深度优先顺序遍历后代，不含自身；必须等待完成。 */
+  walk: (visitor: WxmlTransformVisitor) => Promise<void>;
+  /** 只跳过当前回调所属遍历的后代，不改变其他遍历。 */
+  skipChildren: () => void;
+  setAttribute: (name: string, value: WxmlAttributeValue) => void;
+  setBooleanAttribute: (name: string) => void;
+  renameAttribute: (from: string, to: string) => void;
+  removeAttribute: (name: string) => void;
+  renameTag: (name: string) => void;
+  remove: () => void;
+}
+type WxmlTransformVisitor = (node: WxmlTransformNode) => void | Promise<void>;
+type WxmlTransformResult = string | null | void;
+/** 函数接收当前平台的输出模板；源码阶段依赖由原有组件配置负责。 */
+interface WxmlTransformContext {
+  readonly fileName: string;
+  readonly root: string;
+  readonly platform: MpPlatform$1;
+  readonly mode: string;
+  readonly isDev: boolean;
+  readonly subPackageRoot: string | undefined;
+  edit: (code: string, visitor: WxmlTransformVisitor) => Promise<string>;
+  addWatchFile: (file: string) => void;
+  warn: (message: string) => void;
+  error: (message: string) => never;
+}
+type WxmlTransform = (code: string, context: WxmlTransformContext) => WxmlTransformResult | Promise<WxmlTransformResult>;
+//#endregion
+//#region src/types/config/wxmlValidate.d.ts
+/** 诊断位置对应最终输出模板；不映射回 Vue 等源文件。 */
+interface WxmlValidationDiagnostic {
+  severity: 'warning' | 'error';
+  code?: string;
+  message: string;
+  location?: WxmlSourceLocation;
+}
+/** 校验只观察模板，不能通过节点改写产物。 */
+type WxmlValidationVisitor = (node: WxmlElementInfo) => void | Promise<void>;
+/** 所有回调观察同一份完成输出转换的模板。 */
+interface WxmlValidationContext extends Pick<WxmlTransformContext, 'fileName' | 'root' | 'platform' | 'mode' | 'isDev' | 'subPackageRoot' | 'addWatchFile'> {
+  walk: (visitor: WxmlValidationVisitor) => Promise<void>;
+  report: (diagnostic: WxmlValidationDiagnostic) => void;
+}
+/** 返回值不用于转换；非 undefined 返回值会作为配置错误报告。 */
+type WxmlValidate = (code: string, context: WxmlValidationContext) => void | Promise<void>;
+//#endregion
 //#region src/types/config/features.d.ts
 /**
  * @description 自动导入组件配置
@@ -412,7 +632,27 @@ interface WeappUniAppConfig {
    */
   include: string[];
 }
-type EnhanceWxmlOptions = ScanWxmlOptions & HandleWxmlOptions;
+/** 最终模板中的标签限定属性删除规则，名称区分大小写并支持 `*`。 */
+interface WxmlRemoveAttrRule {
+  tag: string | string[];
+  name: string | string[];
+}
+/** 最终模板的可选清理；对象形式只执行显式配置，不叠加预设。 */
+interface WxmlRemoveOptions {
+  attr?: Array<string | WxmlRemoveAttrRule>;
+  tag?: string[];
+  comment?: boolean;
+}
+type EnhanceWxmlOptions = ScanWxmlOptions & Omit<HandleWxmlOptions, 'removeComment'> & {
+  /** @deprecated 仅保留类型兼容，未接入编译流程；请使用 `weapp.wxml.remove.comment`。 */
+  removeComment?: boolean;
+  /** `true` 删除四种测试属性及普通注释；环境由用户配置控制。 */
+  remove?: boolean | WxmlRemoveOptions;
+  /** 在最终模板清理前按顺序执行同步或异步转换。 */
+  transform?: WxmlTransform | WxmlTransform[];
+  /** 在输出插件处理后、HMR 比较及发布前检查最终模板。 */
+  validate?: WxmlValidate | WxmlValidate[];
+};
 /**
  * @description WXML 扫描阶段配置
  */
@@ -447,7 +687,11 @@ interface MultiPlatformConfig {
   enabled?: boolean;
   projectConfigRoot?: string;
   /**
-   * @description 多平台模式下允许参与构建/开发的目标平台集合
+   * @description 各平台的原生项目配置；不可与 `projectConfigRoot` 同时设置。
+   */
+  projectConfigs?: MultiPlatformProjectConfigs;
+  /**
+   * @description 多平台模式下允许参与构建/开发的目标平台集合；省略时从 `projectConfigs` 的平台键推断。
    */
   targets?: 'all' | readonly MpPlatform$1[];
 }
@@ -484,6 +728,8 @@ interface WeappAutoRoutesConfig {
    * @remarks 默认会扫描主包 `pages/**`，以及已声明分包 root 下的 `pages/**`
    */
   include?: WeappAutoRoutesInclude;
+  /** 页面入口扩展名（可带前导点）；未设置或为空时沿用默认解析。 */
+  extensions?: string[];
   /**
    * @description 是否启用自动路由持久化缓存，或指定自定义缓存文件路径
    * @default false
@@ -573,7 +819,7 @@ interface WeappNpmConfig {
   subPackages?: Record<string, NpmSubPackageConfig>;
   /** 按包名限制原生小程序 npm 包复制到产物中的文件 */
   packageFiles?: Record<string, NpmPackageFilesConfig>;
-  buildOptions?: (options: NpmBuildOptions, pkgMeta: BuildNpmPackageMeta) => NpmBuildOptions | undefined;
+  buildOptions?: (options: NpmBuildOptions, pkgMeta: BuildNpmPackageMeta) => NpmBuildOptions | false | undefined;
   alipayNpmMode?: AlipayNpmMode;
 }
 /**
@@ -618,6 +864,7 @@ interface WeappWorkerConfig {
  * @description Vue 模板编译配置
  */
 interface WeappVueTemplateConfig {
+  /** @deprecated 仅保留类型兼容，未接入编译流程；请使用 `weapp.wxml.remove.comment`。 */
   removeComments?: boolean;
   simplifyWhitespace?: boolean;
   formatWxml?: boolean | 'auto';
@@ -695,6 +942,13 @@ interface WeappRouteRule {
 }
 type WeappRouteRules = Record<string, WeappRouteRule>;
 //#endregion
+//#region src/types/config/tsconfigPaths.d.ts
+/** 高级路径适配选项，保留旧配置的类型兼容。 */
+interface TsconfigPathsOptions extends PluginOptions {
+  /** @deprecated 解析器已统一处理继承和路径，此选项仅兼容旧配置，不再加载 TypeScript 编译器。 */
+  parseNative?: boolean;
+}
+//#endregion
 //#region src/types/config/main.d.ts
 type WeappTailwindcssOptions = UserDefinedOptions & Pick<CreateCompilerOptions, 'compiler'>;
 /**
@@ -763,6 +1017,10 @@ interface WeappAnalyzeBudgetConfig {
    * 独立分包预算阈值（字节）。
    */
   independentBytes?: number;
+  /** 包含已识别 runtime 模块的文件字节上界预算，包含混合 chunk 的业务部分。 */
+  runtimeBytes?: number;
+  /** 按分包 root 覆盖单包预算；主包使用 __main__。 */
+  packageBytes?: Record<string, number>;
   /**
    * 预算预警比例，默认 0.85。
    */
@@ -798,6 +1056,19 @@ interface WeappAnalyzeConfig {
    */
   history?: boolean | WeappAnalyzeHistoryConfig;
 }
+/**
+ * @description 显式执行 build --upload 或 upload 命令时使用的默认参数，不会触发自动上传。
+ */
+interface WeappUploadConfig {
+  /**
+   * 上传版本；CLI --uv 优先，未配置时读取 package.json.version。
+   */
+  version?: string;
+  /**
+   * 上传说明；CLI --desc 优先，未配置时使用项目名称与版本。
+   */
+  desc?: string;
+}
 /**
  * @description weapp-vite 主配置
  */
@@ -853,6 +1124,11 @@ interface WeappViteConfig {
    * analyze 报告配置。
    */
   analyze?: WeappAnalyzeConfig;
+  /**
+   * 上传默认参数。仅在显式执行 build --upload 或 upload 且构建与产物校验成功后上传；
+   * 普通 build、dev/HMR、preview 和上传 dry-run 不触发上传。
+   */
+  upload?: WeappUploadConfig;
   /**
    * 局部构建范围。默认不启用，启用后只构建主包和指定分包。
    */
@@ -860,7 +1136,7 @@ interface WeappViteConfig {
   jsonAlias?: AliasOptions | false;
   npm?: WeappNpmConfig;
   generate?: GenerateOptions;
-  tsconfigPaths?: boolean | PluginOptions;
+  tsconfigPaths?: boolean | TsconfigPathsOptions;
   /**
    * 主包共享样式入口。生成独立样式文件，并按配置注入主包与普通分包页面或组件。
    */
@@ -871,7 +1147,7 @@ interface WeappViteConfig {
   typescript?: WeappManagedTypeScriptConfig;
   lib?: WeappLibConfig;
   isAdditionalWxml?: (wxmlFilePath: string) => boolean;
-  platform?: MpPlatform$1;
+  platform?: MpPlatform$1 | 'web';
   multiPlatform?: boolean | MultiPlatformConfig;
   jsFormat?: JsFormat;
   /**
@@ -984,6 +1260,8 @@ interface WeappCompilerOutputRequest {
   state?: unknown;
 }
 interface WeappCompilerPluginController {
+  /** 同批次资产与脚本必须使用此调用持有的固定状态。 */
+  prepareHmr?: (request: HmrCompilerRequest) => HmrCompilerPreparation | Promise<HmrCompilerPreparation>;
   buildStart?: () => void | Promise<void>;
   claimSource?: (request: WeappCompilerSourceRequest) => boolean | WeappCompilerSourceClaim | Promise<boolean | WeappCompilerSourceClaim | null> | null;
   transformSource?: (request: WeappCompilerSourceRequest) => WeappCompilerTransformResult | null | Promise<WeappCompilerTransformResult | null>;
@@ -1030,6 +1308,8 @@ interface BaseEntry {
   path: string;
   jsonPath?: string;
   json?: object;
+  /** 自动导入增强前的入口声明，供逻辑入口建立稳定的配置依赖。 */
+  declaredJson?: object;
   type: 'app' | 'page' | 'component' | (string & {});
 }
 type Entry = AppEntry | PageEntry | ComponentEntry;
@@ -1111,12 +1391,19 @@ interface DevModuleGraph {
   idToModuleMap?: Map<string, DevModuleNode>;
   invalidateModule(module: DevModuleNode): void;
 }
+interface DevResolverContainer {
+  resolveId: (source: string, importer?: string) => Promise<{
+    id: string;
+  } | null>;
+}
 interface DevServerGraphHost {
   environments?: {
     client?: {
       bundledDev?: unknown;
+      pluginContainer?: DevResolverContainer;
     };
   };
+  pluginContainer?: DevResolverContainer;
   moduleGraph: DevModuleGraph;
   transformRequest?: (url: string) => Promise<unknown>;
 }
@@ -1161,6 +1448,8 @@ interface ModuleGraphService {
     id: string;
   } | null>;
   syncDevGraph: (context: BuildGraphContext) => Promise<void>;
+  getTransformDependencies: (sourceId: string) => readonly string[];
+  replaceTransformDependencies: (sourceId: string, dependencies: Iterable<string>) => void;
   getEntryDependencies: (ownerId: string) => Array<{
     kind: SidecarModuleKind;
     sourceId: string;
@@ -1481,6 +1770,7 @@ interface ResolvedMultiPlatformConfig {
   enabled: boolean;
   projectConfigRoot: string;
   targets: readonly MpPlatform$1[];
+  projectConfigs?: MultiPlatformProjectConfigs;
 }
 //#endregion
 //#region src/utils/json.d.ts
@@ -1501,6 +1791,12 @@ interface LoadConfigOptions {
   emitDefaultAutoImportOutputs?: boolean;
   outputRoot?: string;
   pluginOnly?: boolean;
+  /** 宿主已执行的配置；存在时跳过 vite/weapp-vite 配置文件发现与加载。 */
+  hostConfig?: {
+    config: InlineConfig;
+    path?: string;
+    dependencies?: string[];
+  };
   inlineConfig?: InlineConfig;
   configFile?: string;
   configLoader?: ViteConfigLoader;
@@ -1509,6 +1805,8 @@ interface LoadConfigOptions {
 }
 interface LoadConfigResult {
   loadOptions: LoadConfigOptions;
+  /** 本次加载的用户配置，供隔离子会话重新归一化，避免重复执行配置文件。 */
+  sourceConfig?: InlineConfig;
   config: InlineConfig;
   aliasEntries: ResolvedAlias[];
   outputExtensions: OutputExtensions;
@@ -1648,6 +1946,31 @@ interface JsonService {
   cache: FileCache<any>;
 }
 //#endregion
+//#region src/runtime/npmPlugin/builder/packageBuilder.d.ts
+interface PackageBuilder {
+  isMiniprogramPackage: (pkg: PackageJson) => boolean;
+  shouldSkipBuild: (outDir: string, isOutdated: boolean) => Promise<boolean>;
+  bundleBuild: (args: {
+    entry: InputOption;
+    name: string;
+    options?: NpmBuildOptions;
+    outDir: string;
+  }) => Promise<void>;
+  copyBuild: (args: {
+    from: string;
+    to: string;
+    name: string;
+  }) => Promise<void>;
+  buildPackage: (args: BuildPackageArgs) => Promise<void>;
+}
+interface BuildPackageArgs {
+  dep: string;
+  outDir: string;
+  resolveFrom?: string;
+  options?: NpmBuildOptions;
+  isDependenciesCacheOutdate: boolean;
+}
+//#endregion
 //#region src/runtime/npmPlugin/service/types.d.ts
 interface NpmService {
   getDependenciesCacheFilePath: (key?: string) => string;
@@ -1668,12 +1991,7 @@ interface NpmService {
     to: string;
     name: string;
   }) => Promise<void>;
-  buildPackage: (args: {
-    dep: string;
-    outDir: string;
-    options?: NpmBuildOptions;
-    isDependenciesCacheOutdate: boolean;
-  }) => Promise<void>;
+  buildPackage: PackageBuilder['buildPackage'];
   getPackNpmRelationList: () => {
     packageJsonPath: string;
     miniprogramNpmDistDir: string;
@@ -1701,6 +2019,16 @@ interface GlassEaselAnalysisFact {
   diagnostics: Map<string, GlassEaselDiagnostic>;
   sourceIds: Set<string>;
 }
+interface GlassEaselAnalyzeResult {
+  detected: boolean;
+  minimumBaseLibrary: '3.8.12';
+  migrationGuide: string;
+  diagnostics: GlassEaselDiagnostic[];
+  summary: {
+    errors: number;
+    warnings: number;
+  };
+}
 interface GlassEaselTemplateFinding {
   code: Extract<GlassEaselDiagnosticCode, 'GE002' | 'GE003' | 'GE004'>;
   severity: GlassEaselDiagnosticSeverity;
@@ -1709,6 +2037,21 @@ interface GlassEaselTemplateFinding {
   normalized?: boolean;
 }
 //#endregion
+//#region src/utils/hmrProfile/provenance.d.ts
+interface HmrProfileSourceEvent {
+  eventId: string;
+  event?: ChangeEvent;
+  file?: string;
+  receivedAtMs: number;
+}
+interface HmrProfileProvenance {
+  buildId?: string;
+  batchId?: string;
+  sourceEvents?: HmrProfileSourceEvent[];
+  batchWaitMs?: number;
+  queueWaitMs?: number;
+}
+//#endregion
 //#region src/wxml/shared.d.ts
 interface Token {
   start: number;
@@ -1758,6 +2101,21 @@ interface WxmlToken {
 declare function scanWxml(wxml: string | Buffer, options?: ScanWxmlOptions): WxmlToken;
 type ScanWxmlResult = ReturnType<typeof scanWxml>;
 //#endregion
+//#region src/wxml/processing/registry.d.ts
+type TemplateDependencies = Map<string, Set<string>>;
+type ProcessingStage = 'transform' | 'validate';
+interface WxmlDependencyRegistry {
+  dependencies: Map<string, TemplateDependencies>;
+  pending: Map<symbol, {
+    scope: string;
+    stage: ProcessingStage;
+    templates: TemplateDependencies;
+  }>;
+  failed: Map<string, TemplateDependencies>;
+  references: Map<string, number>;
+  listeners: Set<(files: string[]) => void>;
+}
+//#endregion
 //#region src/runtime/autoImport/types.d.ts
 interface LocalAutoImportMatch {
   kind: 'local';
@@ -1799,6 +2157,7 @@ interface LibEntryState {
   relativeBase: string;
 }
 interface RuntimeState {
+  wxmlProcessing: WxmlDependencyRegistry;
   glassEasel: {
     analysisByOwner: Map<string, GlassEaselAnalysisFact>;
     warnedDiagnostics: Set<string>;
@@ -1841,10 +2200,14 @@ interface RuntimeState {
     npmBuilt: boolean;
     independent: {
       outputs: Map<string, RolldownOutput>;
+      watchFiles: Map<string, Set<string>>;
+      watchListeners: Set<(files: string[]) => void>;
       pendingOutputs: Promise<RolldownOutput>[];
     };
     output: {
       emittedSource: Map<string, string>;
+      /** 仅 analyze 启用，保留转为 asset 的 chunk 模块来源。 */
+      analysisChunks?: Map<string, OutputChunk>;
       wevuInternalRuntimeFileName?: string;
       wevuInternalRuntimeFileNames?: Map<string, string>;
     };
@@ -1868,6 +2231,10 @@ interface RuntimeState {
       vueEntryTailwindScriptContentSignatures: Map<string, string>;
       appEntryAutoRoutesSignature?: string;
       dirtyVueEntryIds: Set<string>;
+      /** 当前构建是否为已有输出的后续发布，不依赖单文件诊断事件。 */
+      isRebuild: boolean;
+      /** 当前快照从根入口重建可达图；完整发布后才撤销旧产物。 */
+      fullEntryScan?: boolean;
       didEmitAllEntries: boolean;
       lastHmrEntryIds: Set<string>;
       lastEmittedEntryIds: Set<string>;
@@ -1924,6 +2291,12 @@ interface RuntimeState {
         snapshotResolveMs?: number;
         snapshotBuildMs?: number;
         writeMs?: number;
+        finalizePrepareMs?: number;
+        finalizeTemplateMs?: number;
+        finalizePublishMs?: number;
+        publicationValidateMs?: number;
+        publicationIndependentMs?: number;
+        publicationPruneMs?: number;
         watchToDirtyMs?: number;
         emitMs?: number;
         sharedChunkResolveMs?: number;
@@ -1937,7 +2310,7 @@ interface RuntimeState {
         dirtyReasonSummary?: string[];
         pendingReasonSummary?: string[];
       }>;
-      profile: {
+      profile: HmrProfileProvenance & {
         eventId?: string;
         event?: ChangeEvent;
         file?: string;
@@ -1982,6 +2355,12 @@ interface RuntimeState {
         snapshotResolveMs?: number;
         snapshotBuildMs?: number;
         writeMs?: number;
+        finalizePrepareMs?: number;
+        finalizeTemplateMs?: number;
+        finalizePublishMs?: number;
+        publicationValidateMs?: number;
+        publicationIndependentMs?: number;
+        publicationPruneMs?: number;
         watchToDirtyMs?: number;
         emitMs?: number;
         sharedChunkResolveMs?: number;
@@ -2037,7 +2416,7 @@ interface RuntimeState {
     independentSubPackageMap: Map<string, SubPackageMetaValue>;
     warnedMessages: Set<string>;
     appEntry?: AppEntry;
-    pluginJson?: Plugin;
+    pluginJson?: Plugin$1;
     pluginJsonPath?: string;
     isDirty: boolean;
     independentDirtyRoots: Set<string>;
@@ -2058,7 +2437,7 @@ interface RuntimeState {
 //#region src/runtime/scanPlugin/service/index.d.ts
 interface ScanService {
   appEntry?: AppEntry;
-  pluginJson?: Plugin;
+  pluginJson?: Plugin$1;
   pluginJsonPath?: string;
   readonly mainPackageStyleEntries: StyleEntry[] | undefined;
   subPackageMap: Map<string, SubPackageMetaValue>;
@@ -2165,7 +2544,8 @@ type AutoRoutesFileEvent = ChangeEvent | 'rename';
 //#region src/runtime/autoRoutesPlugin/service.d.ts
 type PageDeclarationSourceResolver = NonNullable<ScanRoutesOptions['resolvePageDeclarationSource']>;
 interface AutoRoutesService {
-  ensureFresh: () => Promise<void>;
+  /** 活动构建解析器只参与本次刷新，不替换服务持有的长期解析器。 */
+  ensureFresh: (resolve?: PageDeclarationSourceResolver) => Promise<void>;
   markDirty: () => void;
   getSnapshot: () => AutoRoutes;
   getReference: () => AutoRoutes;
@@ -2180,7 +2560,7 @@ interface AutoRoutesService {
   isPageSource: (filePath: string) => boolean;
   /** 判断文件是否属于逻辑页面声明或其外部脚本依赖。 */
   isPageDeclarationSource: (filePath: string) => boolean;
-  /** 注册当前构建上下文已有的模块解析器。 */
+  /** 注册服务持有的长期解析器；构建钩子通过 ensureFresh 参数提供临时解析器。 */
   setPageDeclarationSourceResolver: (resolve?: PageDeclarationSourceResolver) => void;
   handleFileChange: (filePath: string, event?: AutoRoutesFileEvent) => Promise<boolean>;
   isInitialized: () => boolean;
@@ -2264,4 +2644,4 @@ declare module 'vite' {
  */
 declare function defineConfig<T extends UserConfigExport>(config: T): T;
 //#endregion
-export { WeappCompilerPluginContext as $, WeappLibEntryContext as $n, WeappWevuConfig as $t, Ref as A, NpmDependencyPattern as An, WeappAutoRoutesIncludePattern as At, BindingErrorLike as B, SharedChunkStrategy as Bn, WeappNpmConfig as Bt, LoadConfigOptions as C, JsonConfig as Cn, WebPlatform as Cr, HandleWxmlOptions as Ct, MethodDefinitions$1 as D, JsonMergeStrategy as Dn, resolveWeappViteTarget as Dr, WeappAppPreludeMode as Dt, InlineConfig$1 as E, JsonMergeStage as En, isWebPlatform as Er, WeappAppPreludeConfig as Et, RolldownPlugin as F, NpmSubPackageConfig as Fn, WeappInjectRequestGlobalsTarget as Ft, EntryJsonFragment as G, SubPackage as Gn, WeappRequestRuntimeConfig as Gt, BaseEntry as H, StyleConfigObject as Hn, WeappPreloadRule as Ht, RolldownPluginOption as I, ResolvedAlias as In, WeappInjectWeapiConfig as It, ScanComponentItem as J, SubPackageStyleEntry as Jn, WeappSubPackageConfig as Jt, PageEntry as K, SubPackageStyleConfigEntry as Kn, WeappRouteRule as Kt, RolldownWatchOptions as L, SharedChunkDynamicImports as Ln, WeappInjectWebRuntimeGlobalsConfig as Lt, RolldownBuild as M, NpmPackageFilesConfig as Mn, WeappBuildScopeObjectConfig as Mt, RolldownOptions as N, NpmPluginPackageConfig as Nn, WeappHmrConfig as Nt, Plugin$1 as O, MpPlatform$1 as On, WeappAutoRoutesConfig as Ot, RolldownOutput$1 as P, NpmStrategy as Pn, WeappInjectRequestGlobalsConfig as Pt, WeappCompilerPluginCapabilities as Q, WeappLibDtsOptions as Qn, WeappWebRuntimeConfig as Qt, RolldownWatcher$1 as R, SharedChunkMode as Rn, WeappInjectWebRuntimeGlobalsTarget as Rt, CompilerContext as S, JsFormat as Sn, WeappViteTargetKind as Sr, EnhanceWxmlOptions as St, ConfigEnv$1 as T, JsonMergeFunction as Tn, getSupportedWeappViteTargetDescriptors as Tr, ScanWxmlOptions as Tt, ComponentEntry as U, StyleEntry as Un, WeappReactCompilerConfig as Ut, AppEntry as V, StyleConfigEntry as Vn, WeappPreloadNetwork as Vt, Entry as W, StyleScope as Wn, WeappReactConfig as Wt, WeappCompilerOutputRequest as X, WeappLibComponentJson as Xn, WeappVueConfig as Xt, WxmlDep as Y, SubPackageStyleScope as Yn, WeappUniAppConfig as Yt, WeappCompilerPlugin as Z, WeappLibConfig as Zn, WeappVueTemplateConfig as Zt, definePageJson as _, GenerateTemplateFactory as _n, WEB_PLATFORM_ALIASES as _r, WeappTailwindcssOptions as _t, UserConfigFnNoEnvPlain as a, ChunksConfig as an, WeappManagedServerTsconfigConfig as ar, WeappCompilerSourceClaim as at, ChangeEvent as b, GenerateTemplateScope as bn, WeappViteTargetDescriptor as br, AutoImportComponentsOption as bt, UserConfigFnPromise as c, DeprecatedInlineDynamicImports as cn, WeappWebConfig as cr, ProjectConfig as ct, Component$1 as d, GenerateFileType as dn, applyWeappViteHostMeta as dr, WeappAnalyzeBudgetConfig as dt, WeappWorkerConfig as en, WeappLibFileName as er, WeappCompilerPluginController as et, Page$1 as f, GenerateFilenamesOptions as fn, createWeappViteHostMeta as fr, WeappAnalyzeConfig as ft, defineComponentJson as g, GenerateTemplateEntry as gn, ResolvedWeappViteTarget as gr, WeappForwardConsoleLogLevel as gt, defineAppJson as h, GenerateTemplateContext as hn, ResolveWeappViteTargetOptions as hr, WeappForwardConsoleConfig as ht, UserConfigFnNoEnv as i, BuildNpmPackageMeta as in, WeappManagedNodeTsconfigConfig as ir, WeappCompilerResourceKind as it, ResolvedConfig$1 as j, NpmMainPackageConfig as jn, WeappBuildScopeConfig as jt, PluginOption as k, NpmBuildOptions as kn, WeappAutoRoutesInclude as kt, defineConfig as l, GenerateDirsOptions as ln, WEAPP_VITE_HOST_NAME as lr, SubPackageMetaValue as lt, Theme$1 as m, GenerateTemplate as mn, resolveWeappViteHostMeta as mr, WeappDebugConfig as mt, UserConfigExport as n, AliasOptions as nn, WeappLibVueTscOptions as nr, WeappCompilerPluginOption as nt, UserConfigFnObject as o, CopyGlobs as on, WeappManagedSharedTsconfigConfig as or, WeappCompilerSourceRequest as ot, Sitemap$1 as p, GenerateOptions as pn, isWeappViteHost as pr, WeappAnalyzeHistoryConfig as pt, ComponentsMap as q, SubPackageStyleConfigObject as qn, WeappRouteRules as qt, UserConfigFn as r, AlipayNpmMode as rn, WeappManagedAppTsconfigConfig as rr, WeappCompilerPluginPhase as rt, UserConfigFnObjectPlain as s, CopyOptions as sn, WeappManagedTypeScriptConfig as sr, WeappCompilerTransformResult as st, UserConfig$1 as t, Alias as tn, WeappLibInternalDtsOptions as tr, WeappCompilerPluginFactory as tt, App$1 as u, GenerateExtensionsOptions as un, WeappViteHostMeta as ur, UserConfig$2 as ut, defineSitemapJson as v, GenerateTemplateFileSource as vn, WeappVitePlatform as vr, WeappViteConfig as vt, ComputedDefinitions$1 as w, JsonMergeContext as wn, getSupportedWeappVitePlatforms as wr, MultiPlatformConfig as wt, WeappVitePluginApi as x, GenerateTemplatesConfig as xn, WeappViteTargetInput as xr, EnhanceOptions as xt, defineThemeJson as y, GenerateTemplateInlineSource as yn, WeappViteRuntime as yr, AutoImportComponents as yt, ViteDevServer$1 as z, SharedChunkOverride as zn, WeappMcpConfig as zt };
+export { WeappCompilerHmrRequest as $, NpmMainPackageConfig as $n, WeappSubPackageConfig as $t, PluginOption as A, DeprecatedInlineDynamicImports as An, WeappWebConfig as Ar, ScanWxmlOptions as At, ViteDevServer$1 as B, GenerateTemplateFileSource as Bn, WeappVitePlatform as Br, WeappInjectRequestGlobalsTarget as Bt, GlassEaselAnalyzeResult as C, Alias as Cn, WeappLibInternalDtsOptions as Cr, WeappViteConfig as Ct, InlineConfig$1 as D, ChunksConfig as Dn, WeappManagedServerTsconfigConfig as Dr, EnhanceWxmlOptions as Dt, ConfigEnv$1 as E, BuildNpmPackageMeta as En, WeappManagedNodeTsconfigConfig as Er, EnhanceOptions as Et, RolldownOutput$1 as F, GenerateOptions as Fn, isWeappViteHost as Fr, WeappAutoRoutesIncludePattern as Ft, Entry as G, JsonConfig as Gn, WebPlatform as Gr, WeappNpmConfig as Gt, AppEntry as H, GenerateTemplateScope as Hn, WeappViteTargetDescriptor as Hr, WeappInjectWebRuntimeGlobalsConfig as Ht, RolldownPlugin as I, GenerateTemplate as In, resolveWeappViteHostMeta as Ir, WeappBuildScopeConfig as It, ComponentsMap as J, JsonMergeStage as Jn, isWebPlatform as Jr, WeappReactCompilerConfig as Jt, EntryJsonFragment as K, JsonMergeContext as Kn, getSupportedWeappVitePlatforms as Kr, WeappPreloadNetwork as Kt, RolldownPluginOption as L, GenerateTemplateContext as Ln, ResolveWeappViteTargetOptions as Lr, WeappBuildScopeObjectConfig as Lt, ResolvedConfig$1 as M, GenerateExtensionsOptions as Mn, WeappViteHostMeta as Mr, WeappAppPreludeMode as Mt, RolldownBuild as N, GenerateFileType as Nn, applyWeappViteHostMeta as Nr, WeappAutoRoutesConfig as Nt, MethodDefinitions$1 as O, CopyGlobs as On, WeappManagedSharedTsconfigConfig as Or, HandleWxmlOptions as Ot, RolldownOptions as P, GenerateFilenamesOptions as Pn, createWeappViteHostMeta as Pr, WeappAutoRoutesInclude as Pt, WeappCompilerHmrPreparation as Q, NpmDependencyPattern as Qn, WeappRouteRules as Qt, RolldownWatchOptions as R, GenerateTemplateEntry as Rn, ResolvedWeappViteTarget as Rr, WeappHmrConfig as Rt, CompilerContext as S, MultiPlatformProjectConfigs as Sn, WeappLibFileName as Sr, WeappUploadConfig as St, ComputedDefinitions$1 as T, AlipayNpmMode as Tn, WeappManagedAppTsconfigConfig as Tr, AutoImportComponentsOption as Tt, BaseEntry as U, GenerateTemplatesConfig as Un, WeappViteTargetInput as Ur, WeappInjectWebRuntimeGlobalsTarget as Ut, BindingErrorLike as V, GenerateTemplateInlineSource as Vn, WeappViteRuntime as Vr, WeappInjectWeapiConfig as Vt, ComponentEntry as W, JsFormat as Wn, WeappViteTargetKind as Wr, WeappMcpConfig as Wt, WxmlDep as X, MpPlatform$1 as Xn, WeappRequestRuntimeConfig as Xt, ScanComponentItem as Y, JsonMergeStrategy as Yn, resolveWeappViteTarget as Yr, WeappReactConfig as Yt, WeappCompilerHmrAsset as Z, NpmBuildOptions as Zn, WeappRouteRule as Zt, definePageJson as _, WxmlTransformContext as _n, SubPackageStyleScope as _r, WeappAnalyzeHistoryConfig as _t, UserConfigFnNoEnvPlain as a, WeappWorkerConfig as an, SharedChunkDynamicImports as ar, WeappCompilerPluginFactory as at, ChangeEvent as b, WxmlTransformVisitor as bn, WeappLibDtsOptions as br, WeappForwardConsoleLogLevel as bt, UserConfigFnPromise as c, WxmlValidate as cn, SharedChunkStrategy as cr, WeappCompilerResourceKind as ct, Component$1 as d, WxmlValidationVisitor as dn, StyleEntry as dr, WeappCompilerTransformResult as dt, WeappUniAppConfig as en, NpmPackageFilesConfig as er, WeappCompilerOutputRequest as et, Page$1 as f, WxmlAttribute as fn, StyleScope as fr, ProjectConfig as ft, defineComponentJson as g, WxmlTransform as gn, SubPackageStyleEntry as gr, WeappAnalyzeConfig as gt, defineAppJson as h, WxmlSourceLocation as hn, SubPackageStyleConfigObject as hr, WeappAnalyzeBudgetConfig as ht, UserConfigFnNoEnv as i, WeappWevuConfig as in, ResolvedAlias as ir, WeappCompilerPluginController as it, Ref as j, GenerateDirsOptions as jn, WEAPP_VITE_HOST_NAME as jr, WeappAppPreludeConfig as jt, Plugin$2 as k, CopyOptions as kn, WeappManagedTypeScriptConfig as kr, MultiPlatformConfig as kt, defineConfig as l, WxmlValidationContext as ln, StyleConfigEntry as lr, WeappCompilerSourceClaim as lt, Theme$1 as m, WxmlElementInfo as mn, SubPackageStyleConfigEntry as mr, UserConfig$2 as mt, UserConfigExport as n, WeappVueTemplateConfig as nn, NpmStrategy as nr, WeappCompilerPluginCapabilities as nt, UserConfigFnObject as o, WxmlRemoveAttrRule as on, SharedChunkMode as or, WeappCompilerPluginOption as ot, Sitemap$1 as p, WxmlAttributeValue as pn, SubPackage as pr, SubPackageMetaValue as pt, PageEntry as q, JsonMergeFunction as qn, getSupportedWeappViteTargetDescriptors as qr, WeappPreloadRule as qt, UserConfigFn as r, WeappWebRuntimeConfig as rn, NpmSubPackageConfig as rr, WeappCompilerPluginContext as rt, UserConfigFnObjectPlain as s, WxmlRemoveOptions as sn, SharedChunkOverride as sr, WeappCompilerPluginPhase as st, UserConfig$1 as t, WeappVueConfig as tn, NpmPluginPackageConfig as tr, WeappCompilerPlugin as tt, App$1 as u, WxmlValidationDiagnostic as un, StyleConfigObject as ur, WeappCompilerSourceRequest as ut, defineSitemapJson as v, WxmlTransformNode as vn, WeappLibComponentJson as vr, WeappDebugConfig as vt, LoadConfigOptions as w, AliasOptions as wn, WeappLibVueTscOptions as wr, AutoImportComponents as wt, WeappVitePluginApi as x, MultiPlatformProjectConfig as xn, WeappLibEntryContext as xr, WeappTailwindcssOptions as xt, defineThemeJson as y, WxmlTransformResult as yn, WeappLibConfig as yr, WeappForwardConsoleConfig as yt, RolldownWatcher$1 as z, GenerateTemplateFactory as zn, WEB_PLATFORM_ALIASES as zr, WeappInjectRequestGlobalsConfig as zt };