weapp-vite 7.2.2 → 7.4.0

package/dist/{config-JdEU9lCP.d.mts → config-Dbvj5yK7.d.mts}

@@ -7,10 +7,11 @@ 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, UserConfig, ViteDevServer, ViteDevServer as ViteDevServer$1, build } from "vite";
+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, ResolvedId, RolldownBuild, RolldownOptions, RolldownOutput, RolldownOutput as RolldownOutput$1, RolldownPlugin, RolldownPluginOption, RolldownWatcher, RolldownWatcher as RolldownWatcher$1, WatchOptions as RolldownWatchOptions } from "rolldown";
+import { HmrCompilerAsset as WeappCompilerHmrAsset, HmrCompilerPreparation, HmrCompilerPreparation as WeappCompilerHmrPreparation, HmrCompilerRequest, HmrCompilerRequest as WeappCompilerHmrRequest } from "@weapp-vite/hmr";
+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 PQueue from "p-queue";
 import { Buffer } from "node:buffer";
@@ -18,7 +19,7 @@ import { PluginOptions } from "vite-tsconfig-paths";
 import { WrapPluginOptions } from "vite-plugin-performance";
 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 { WeappWebPluginOptions } from "@weapp-vite/web/plugin";
 import { CompilerOptions } from "typescript";
 import { CreateCompilerOptions } from "weapp-tailwindcss/core";
@@ -368,6 +369,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 +648,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 +703,11 @@ interface MultiPlatformConfig {
   enabled?: boolean;
   projectConfigRoot?: string;
   /**
-   * @description 多平台模式下允许参与构建/开发的目标平台集合
+   * @description 各平台的原生项目配置；不可与 `projectConfigRoot` 同时设置。
+   */
+  projectConfigs?: MultiPlatformProjectConfigs;
+  /**
+   * @description 多平台模式下允许参与构建/开发的目标平台集合；省略时从 `projectConfigs` 的平台键推断。
    */
   targets?: 'all' | readonly MpPlatform$1[];
 }
@@ -618,6 +878,7 @@ interface WeappWorkerConfig {
  * @description Vue 模板编译配置
  */
 interface WeappVueTemplateConfig {
+  /** @deprecated 仅保留类型兼容，未接入编译流程；请使用 `weapp.wxml.remove.comment`。 */
   removeComments?: boolean;
   simplifyWhitespace?: boolean;
   formatWxml?: boolean | 'auto';
@@ -798,6 +1059,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 主配置
  */
@@ -814,6 +1088,10 @@ interface WeappViteConfig {
    * - `object`: 启用并传入 weapp-tailwindcss core options
    */
   tailwindcss?: boolean | WeappTailwindcssOptions;
+  /**
+   * 可扩展的底层编译插件。插件负责声明源码所有权，并可参与 CSS、WXML、JavaScript、bundle 和 HMR 生命周期。
+   */
+  compilerPlugins?: WeappCompilerPluginOption | WeappCompilerPluginOption[];
   /**
    * 应用入口目录（`app.json` 所在目录）。
    */
@@ -849,6 +1127,11 @@ interface WeappViteConfig {
    * analyze 报告配置。
    */
   analyze?: WeappAnalyzeConfig;
+  /**
+   * 上传默认参数。仅在显式执行 build --upload 或 upload 且构建与产物校验成功后上传；
+   * 普通 build、dev/HMR、preview 和上传 dry-run 不触发上传。
+   */
+  upload?: WeappUploadConfig;
   /**
    * 局部构建范围。默认不启用，启用后只构建主包和指定分包。
    */
@@ -921,6 +1204,92 @@ interface ProjectConfig {
   };
 }
 //#endregion
+//#region src/types/compilerPlugin.d.ts
+type WeappCompilerPluginPhase = 'source' | 'output';
+type WeappCompilerResourceKind = 'style' | 'template' | 'script';
+interface WeappCompilerPluginCapabilities {
+  bundle?: boolean;
+  style?: boolean;
+  template?: boolean;
+  script?: boolean;
+  content?: boolean;
+  hmr?: boolean;
+}
+interface WeappCompilerPluginContext {
+  root: string;
+  srcRoot: string;
+  platform: MpPlatform$1;
+  outputExtensions: OutputExtensions;
+  isDev: boolean;
+  resolvedConfig?: ResolvedConfig;
+  readFile: (id: string) => Promise<string>;
+  resolve: (source: string, importer?: string, options?: {
+    skipSelf?: boolean;
+  }) => Promise<{
+    id: string;
+  } | null>;
+  addWatchFile: (id: string) => void;
+  invalidate: (id: string) => void;
+  warn: (message: string) => void;
+  error: (message: string) => never;
+  claimSource: (id: string, owner: string) => void;
+  getSourceOwner: (id: string) => string | undefined;
+}
+interface WeappCompilerSourceRequest {
+  id: string;
+  code: string;
+  kind: WeappCompilerResourceKind;
+}
+interface WeappCompilerTransformResult {
+  code: string;
+  /** 与产物关联的稳定入口标识；未提供时由 host 使用源码 id。 */
+  entryId?: string;
+  map?: unknown;
+  dependencies?: string[];
+  /** provider 需要 host 重新处理的文件集合。 */
+  invalidated?: string[];
+  handled?: boolean;
+  state?: unknown;
+}
+interface WeappCompilerSourceClaim {
+  id?: string;
+  entryId?: string;
+  dependencies?: string[];
+}
+interface WeappCompilerOutputRequest {
+  fileName: string;
+  code: string;
+  entryId?: string;
+  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>;
+  generateBundle?: (bundle: OutputBundle, context: WeappCompilerPluginContext) => void | Promise<void>;
+  transformCss?: (request: WeappCompilerOutputRequest) => WeappCompilerTransformResult | null | Promise<WeappCompilerTransformResult | null>;
+  transformTemplate?: (request: WeappCompilerOutputRequest) => WeappCompilerTransformResult | null | Promise<WeappCompilerTransformResult | null>;
+  transformJavaScript?: (request: WeappCompilerOutputRequest) => WeappCompilerTransformResult | null | Promise<WeappCompilerTransformResult | null>;
+  watchChange?: (id: string, change: {
+    event: 'create' | 'update' | 'delete';
+  }) => void | Promise<void>;
+  handleHotUpdate?: (file: string) => string[] | void | Promise<string[] | void>;
+  buildEnd?: (error?: Error) => void | Promise<void>;
+  closeWatcher?: () => void | Promise<void>;
+  closeBundle?: () => void | Promise<void>;
+  dispose?: () => void | Promise<void>;
+}
+interface WeappCompilerPlugin {
+  name: string;
+  phase?: WeappCompilerPluginPhase;
+  capabilities?: WeappCompilerPluginCapabilities;
+  create: (context: WeappCompilerPluginContext) => WeappCompilerPluginController | Promise<WeappCompilerPluginController>;
+}
+type WeappCompilerPluginFactory = (context: WeappCompilerPluginContext) => WeappCompilerPlugin | Promise<WeappCompilerPlugin>;
+type WeappCompilerPluginOption = WeappCompilerPlugin | WeappCompilerPluginFactory;
+//#endregion
 //#region src/types/context.d.ts
 interface WxmlDep {
   tagName: string;
@@ -1039,9 +1408,15 @@ interface TopologyRescanRequest {
 //#endregion
 //#region src/moduleGraph/service.d.ts
 interface ModuleGraphService {
-  bindBuildContext: (scope: object, context: BuildGraphContext) => void;
-  bindDevServer: (server: DevServerGraphHost | undefined) => void;
-  bindPluginContext: (context: BuildGraphContext) => void;
+  /** 只替换指定 scope；返回仅对应本次绑定的释放器。 */
+  bindBuildContext: (scope: object, context: BuildGraphContext) => () => void;
+  /** 撤销 scope 的图和插件上下文；传入 context 时仅释放仍归该 context 所有的绑定。 */
+  unbindBuildContext: (scope: object, context?: BuildGraphContext) => void;
+  /** 返回仅对应本次绑定的释放器，避免旧 server 的异步关闭解绑新 server。 */
+  bindDevServer: (server: DevServerGraphHost | undefined) => () => void;
+  bindPluginContext: (scope: object, context: BuildGraphContext) => void;
+  /** 仅用于整个会话关闭或替换，不用于普通增量构建或临时 snapshot。 */
+  resetSession: () => void;
   collectAffectedEntries: (file: string) => Set<string>;
   getPendingChanges: () => Array<{
     event: string;
@@ -1056,6 +1431,8 @@ interface ModuleGraphService {
     resolveDependencies?: boolean;
   }) => Promise<BuildModuleInfo>;
   replaceEntryDependencies: (ownerId: string, kind: SidecarModuleKind, sourceIds: Iterable<string>) => void;
+  /** 释放 owner 自己的依赖声明；实际 import graph 的更新仍由构建引擎负责。 */
+  removeEntryDependencies: (ownerId: string) => void;
   recordChangedFile: (file: string, event: string) => void;
   clearPendingChanges: () => void;
   requestTopologyRescan: (reason: string, file: string) => void;
@@ -1385,6 +1762,7 @@ interface ResolvedMultiPlatformConfig {
   enabled: boolean;
   projectConfigRoot: string;
   targets: readonly MpPlatform$1[];
+  projectConfigs?: MultiPlatformProjectConfigs;
 }
 //#endregion
 //#region src/utils/json.d.ts
@@ -1597,6 +1975,24 @@ interface GlassEaselDiagnostic {
   column?: number;
   normalized?: boolean;
 }
+/** 每个 source/output owner 的最近分析事实；日志去重状态不属于当前事实。 */
+interface GlassEaselAnalysisFact {
+  kind: 'output' | 'source';
+  scope?: string;
+  detected: boolean;
+  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;
@@ -1654,6 +2050,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';
@@ -1695,9 +2106,9 @@ interface LibEntryState {
   relativeBase: string;
 }
 interface RuntimeState {
+  wxmlProcessing: WxmlDependencyRegistry;
   glassEasel: {
-    detected: boolean;
-    diagnostics: Map<string, GlassEaselDiagnostic>;
+    analysisByOwner: Map<string, GlassEaselAnalysisFact>;
     warnedDiagnostics: Set<string>;
     silent: boolean;
   };
@@ -1738,6 +2149,8 @@ interface RuntimeState {
     npmBuilt: boolean;
     independent: {
       outputs: Map<string, RolldownOutput>;
+      watchFiles: Map<string, Set<string>>;
+      watchListeners: Set<(files: string[]) => void>;
       pendingOutputs: Promise<RolldownOutput>[];
     };
     output: {
@@ -1756,6 +2169,10 @@ interface RuntimeState {
       vueEntryHasTemplate: Map<string, boolean>;
       vueEntrySfcSignatures: Map<string, VueSfcBlockSignatures>;
       vueEntryStyleBindings: Map<string, VueEntryStyleBindings>;
+      /** 编译 provider 内容签名；key 为入口，value 的 key 为 provider 名称。 */
+      vueEntryContentSignatures?: Map<string, Readonly<Record<string, string>>>;
+      vueEntryTemplateContentSignatures?: Map<string, Readonly<Record<string, string>>>;
+      vueEntryScriptContentSignatures?: Map<string, Readonly<Record<string, string>>>;
       vueEntryTailwindContentSignatures: Map<string, string>;
       vueEntryTailwindTemplateContentSignatures: Map<string, string>;
       vueEntryTailwindScriptContentSignatures: Map<string, string>;
@@ -1766,6 +2183,7 @@ interface RuntimeState {
       lastEmittedEntryIds: Set<string>;
       lastEmittedChunkFileNames: Set<string>;
       forceEmitUnchangedChunks: boolean;
+      forceFullSharedChunkRefresh: boolean;
       sharedChunkSourceModuleIds: Set<string>;
       recentProfiles: Array<{
         timestamp?: string;
@@ -1816,6 +2234,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;
@@ -1874,6 +2298,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;
@@ -1929,7 +2359,7 @@ interface RuntimeState {
     independentSubPackageMap: Map<string, SubPackageMetaValue>;
     warnedMessages: Set<string>;
     appEntry?: AppEntry;
-    pluginJson?: Plugin;
+    pluginJson?: Plugin$1;
     pluginJsonPath?: string;
     isDirty: boolean;
     independentDirtyRoots: Set<string>;
@@ -1950,7 +2380,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>;
@@ -2057,7 +2487,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;
@@ -2072,7 +2503,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;
@@ -2156,4 +2587,4 @@ declare module 'vite' {
  */
 declare function defineConfig<T extends UserConfigExport>(config: T): T;
 //#endregion
-export { WeappAnalyzeBudgetConfig as $, applyWeappViteHostMeta as $n, GenerateFileType as $t, Ref as A, StyleConfigObject as An, WeappPreloadRule as At, BindingErrorLike as B, WeappLibDtsOptions as Bn, WeappWebRuntimeConfig as Bt, LoadConfigOptions as C, NpmSubPackageConfig as Cn, WeappInjectRequestGlobalsTarget as Ct, MethodDefinitions$1 as D, SharedChunkOverride as Dn, WeappMcpConfig as Dt, InlineConfig$1 as E, SharedChunkMode as En, WeappInjectWebRuntimeGlobalsTarget as Et, RolldownPlugin as F, SubPackageStyleConfigObject as Fn, WeappRouteRules as Ft, EntryJsonFragment as G, WeappManagedAppTsconfigConfig as Gn, AlipayNpmMode as Gt, BaseEntry as H, WeappLibFileName as Hn, WeappWorkerConfig as Ht, RolldownPluginOption as I, SubPackageStyleEntry as In, WeappSubPackageConfig as It, ScanComponentItem as J, WeappManagedSharedTsconfigConfig as Jn, CopyGlobs as Jt, PageEntry as K, WeappManagedNodeTsconfigConfig as Kn, BuildNpmPackageMeta as Kt, RolldownWatchOptions as L, SubPackageStyleScope as Ln, WeappUniAppConfig as Lt, RolldownBuild as M, StyleScope as Mn, WeappReactConfig as Mt, RolldownOptions as N, SubPackage as Nn, WeappRequestRuntimeConfig as Nt, Plugin$1 as O, SharedChunkStrategy as On, WeappNpmConfig as Ot, RolldownOutput$1 as P, SubPackageStyleConfigEntry as Pn, WeappRouteRule as Pt, UserConfig$2 as Q, WeappViteHostMeta as Qn, GenerateExtensionsOptions as Qt, RolldownWatcher$1 as R, WeappLibComponentJson as Rn, WeappVueConfig as Rt, CompilerContext as S, NpmStrategy as Sn, WeappInjectRequestGlobalsConfig as St, ConfigEnv$1 as T, SharedChunkDynamicImports as Tn, WeappInjectWebRuntimeGlobalsConfig as Tt, ComponentEntry as U, WeappLibInternalDtsOptions as Un, Alias as Ut, AppEntry as V, WeappLibEntryContext as Vn, WeappWevuConfig as Vt, Entry as W, WeappLibVueTscOptions as Wn, AliasOptions as Wt, ProjectConfig as X, WeappWebConfig as Xn, DeprecatedInlineDynamicImports as Xt, WxmlDep as Y, WeappManagedTypeScriptConfig as Yn, CopyOptions as Yt, SubPackageMetaValue as Z, WEAPP_VITE_HOST_NAME as Zn, GenerateDirsOptions as Zt, definePageJson as _, NpmBuildOptions as _n, WeappAutoRoutesInclude as _t, UserConfigFnNoEnvPlain as a, GenerateTemplateFactory as an, WEB_PLATFORM_ALIASES as ar, WeappTailwindcssOptions as at, ChangeEvent as b, NpmPackageFilesConfig as bn, WeappBuildScopeObjectConfig as bt, UserConfigFnPromise as c, GenerateTemplateScope as cn, WeappViteTargetDescriptor as cr, AutoImportComponentsOption as ct, Component$1 as d, JsonConfig as dn, WebPlatform as dr, HandleWxmlOptions as dt, GenerateFilenamesOptions as en, createWeappViteHostMeta as er, WeappAnalyzeConfig as et, Page$1 as f, JsonMergeContext as fn, getSupportedWeappVitePlatforms as fr, MultiPlatformConfig as ft, defineComponentJson as g, MpPlatform$1 as gn, WeappAutoRoutesConfig as gt, defineAppJson as h, JsonMergeStrategy as hn, resolveWeappViteTarget as hr, WeappAppPreludeMode as ht, UserConfigFnNoEnv as i, GenerateTemplateEntry as in, ResolvedWeappViteTarget as ir, WeappForwardConsoleLogLevel as it, ResolvedConfig as j, StyleEntry as jn, WeappReactCompilerConfig as jt, PluginOption as k, StyleConfigEntry as kn, WeappPreloadNetwork as kt, defineConfig as l, GenerateTemplatesConfig as ln, WeappViteTargetInput as lr, EnhanceOptions as lt, Theme$1 as m, JsonMergeStage as mn, isWebPlatform as mr, WeappAppPreludeConfig as mt, UserConfigExport as n, GenerateTemplate as nn, resolveWeappViteHostMeta as nr, WeappDebugConfig as nt, UserConfigFnObject as o, GenerateTemplateFileSource as on, WeappVitePlatform as or, WeappViteConfig as ot, Sitemap$1 as p, JsonMergeFunction as pn, getSupportedWeappViteTargetDescriptors as pr, ScanWxmlOptions as pt, ComponentsMap as q, WeappManagedServerTsconfigConfig as qn, ChunksConfig as qt, UserConfigFn as r, GenerateTemplateContext as rn, ResolveWeappViteTargetOptions as rr, WeappForwardConsoleConfig as rt, UserConfigFnObjectPlain as s, GenerateTemplateInlineSource as sn, WeappViteRuntime as sr, AutoImportComponents as st, UserConfig$1 as t, GenerateOptions as tn, isWeappViteHost as tr, WeappAnalyzeHistoryConfig as tt, App$1 as u, JsFormat as un, WeappViteTargetKind as ur, EnhanceWxmlOptions as ut, defineSitemapJson as v, NpmDependencyPattern as vn, WeappAutoRoutesIncludePattern as vt, ComputedDefinitions$1 as w, ResolvedAlias as wn, WeappInjectWeapiConfig as wt, WeappVitePluginApi as x, NpmPluginPackageConfig as xn, WeappHmrConfig as xt, defineThemeJson as y, NpmMainPackageConfig as yn, WeappBuildScopeConfig as yt, ViteDevServer$1 as z, WeappLibConfig as zn, WeappVueTemplateConfig 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 };

package/dist/config.d.mts

@@ -1,3 +1,3 @@
-import { $n as applyWeappViteHostMeta, Qn as WeappViteHostMeta, Zn as WEAPP_VITE_HOST_NAME, _ as definePageJson, a as UserConfigFnNoEnvPlain, c as UserConfigFnPromise, d as Component, er as createWeappViteHostMeta, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, l as defineConfig, m as Theme, n as UserConfigExport, nr as resolveWeappViteHostMeta, o as UserConfigFnObject, ot as WeappViteConfig, p as Sitemap, r as UserConfigFn, s as UserConfigFnObjectPlain, sr as WeappViteRuntime, t as UserConfig, tr as isWeappViteHost, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-JdEU9lCP.mjs";
+import { $ as WeappCompilerHmrRequest, Ct as WeappViteConfig, Fr as isWeappViteHost, Ir as resolveWeappViteHostMeta, Mr as WeappViteHostMeta, Nr as applyWeappViteHostMeta, Pr as createWeappViteHostMeta, Q as WeappCompilerHmrPreparation, Sn as MultiPlatformProjectConfigs, Vr as WeappViteRuntime, Z as WeappCompilerHmrAsset, _ as definePageJson, _n as WxmlTransformContext, a as UserConfigFnNoEnvPlain, bn as WxmlTransformVisitor, c as UserConfigFnPromise, cn as WxmlValidate, d as Component, dn as WxmlValidationVisitor, f as Page, fn as WxmlAttribute, g as defineComponentJson, gn as WxmlTransform, h as defineAppJson, hn as WxmlSourceLocation, i as UserConfigFnNoEnv, it as WeappCompilerPluginController, jr as WEAPP_VITE_HOST_NAME, l as defineConfig, ln as WxmlValidationContext, m as Theme, mn as WxmlElementInfo, n as UserConfigExport, nt as WeappCompilerPluginCapabilities, o as UserConfigFnObject, on as WxmlRemoveAttrRule, ot as WeappCompilerPluginOption, p as Sitemap, pn as WxmlAttributeValue, r as UserConfigFn, rt as WeappCompilerPluginContext, s as UserConfigFnObjectPlain, sn as WxmlRemoveOptions, t as UserConfig, tt as WeappCompilerPlugin, u as App, un as WxmlValidationDiagnostic, v as defineSitemapJson, vn as WxmlTransformNode, xn as MultiPlatformProjectConfig, y as defineThemeJson, yn as WxmlTransformResult } from "./config-Dbvj5yK7.mjs";
 import { t as WeappI18nConfig } from "./types-CgZn5X6j.mjs";
-export { type App, type Component, type Page, type Sitemap, type Theme, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnNoEnv, UserConfigFnNoEnvPlain, UserConfigFnObject, UserConfigFnObjectPlain, UserConfigFnPromise, WEAPP_VITE_HOST_NAME, type WeappI18nConfig, type WeappViteConfig, WeappViteHostMeta, type WeappViteRuntime, applyWeappViteHostMeta, createWeappViteHostMeta, defineAppJson, defineComponentJson, defineConfig, definePageJson, defineSitemapJson, defineThemeJson, isWeappViteHost, resolveWeappViteHostMeta };
+export { type App, type Component, type MultiPlatformProjectConfig, type MultiPlatformProjectConfigs, type Page, type Sitemap, type Theme, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnNoEnv, UserConfigFnNoEnvPlain, UserConfigFnObject, UserConfigFnObjectPlain, UserConfigFnPromise, WEAPP_VITE_HOST_NAME, type WeappCompilerHmrAsset, type WeappCompilerHmrPreparation, type WeappCompilerHmrRequest, type WeappCompilerPlugin, type WeappCompilerPluginCapabilities, type WeappCompilerPluginContext, type WeappCompilerPluginController, type WeappCompilerPluginOption, type WeappI18nConfig, type WeappViteConfig, WeappViteHostMeta, type WeappViteRuntime, type WxmlAttribute, type WxmlAttributeValue, type WxmlElementInfo, type WxmlRemoveAttrRule, type WxmlRemoveOptions, type WxmlSourceLocation, type WxmlTransform, type WxmlTransformContext, type WxmlTransformNode, type WxmlTransformResult, type WxmlTransformVisitor, type WxmlValidate, type WxmlValidationContext, type WxmlValidationDiagnostic, type WxmlValidationVisitor, applyWeappViteHostMeta, createWeappViteHostMeta, defineAppJson, defineComponentJson, defineConfig, definePageJson, defineSitemapJson, defineThemeJson, isWeappViteHost, resolveWeappViteHostMeta };