@wevu/compiler 7.3.0 → 7.5.0

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-import { n as StaticRouteValue, t as StaticPageDeclaration } from "./public-DEO6JWFi.mjs";
+import { n as StaticPageMeta, r as StaticRouteValue, t as StaticPageDeclaration } from "./public-BqBfNRjA.mjs";
 import { WevuBindingUpdateMode, WevuBindingUpdateMode as WevuBindingUpdateMode$1, WevuRuntimeBindingManifestV1, WevuRuntimeBindingRecordV1 } from "@weapp-core/constants";
 import { LRUCache } from "lru-cache";
+import MagicString from "magic-string";
 import { SFCBlock, SFCDescriptor, SFCParseResult, SFCStyleBlock } from "vue/compiler-sfc";
 import * as t from "@weapp-vite/ast/babelTypes";
 import { Expression, File } from "@weapp-vite/ast/babelTypes";
@@ -134,6 +135,7 @@ export declare function createRuntimeBindingManifest(manifest: WevuBindingManife
 //#region src/constants.d.ts
 export declare const WE_VU_PAGE_HOOK_TO_FEATURE: {
   readonly onPageScroll: "enableOnPageScroll";
+  readonly usePageScrollRestoration: "enableOnPageScroll";
   readonly onPullDownRefresh: "enableOnPullDownRefresh";
   readonly onReachBottom: "enableOnReachBottom";
   readonly onRouteDone: "enableOnRouteDone";
@@ -180,6 +182,8 @@ export declare const WE_VU_RUNTIME_MODULE_IDS: readonly ["wevu", "wevu/internal-
  * 判断模块 ID 是否为 wevu 运行时入口。
  */
 export declare function isWevuRuntimeModuleId(moduleId: string): boolean;
+/** 页面特性可由独立 router 入口的适配器启用，但该入口不提供组件工厂。 */
+export declare function isWevuPageFeatureModuleId(moduleId: string): boolean;
 /**
  * wevu 运行时 API 名称映射。
  */
@@ -1895,6 +1899,10 @@ interface JsonMergeContext {
   filename?: string;
   kind?: 'app' | 'page' | 'component' | 'unknown';
   stage: JsonMergeStage;
+  /** 当前 SFC 页面的静态路由声明。 */
+  routeConfig?: StaticPageDeclaration;
+  /** 整个页面元信息对象可静态提取时提供。 */
+  pageMeta?: StaticPageMeta;
 }
 /**
  * JSON 合并函数。
@@ -1984,6 +1992,8 @@ interface MiniProgramDirectiveAttrs {
  */
 interface MiniProgramPlatform {
   name: string;
+  /** 非微信宿主复用 WXML 语法时，显式关闭原生插槽上下文协议。 */
+  nativeSlotContext?: boolean;
   directives: MiniProgramDirectiveAttrs;
   wrapIf: (exp: string, content: string, renderMustache: (exp: string) => string) => string;
   wrapElseIf: (exp: string, content: string, renderMustache: (exp: string) => string) => string;
@@ -2091,6 +2101,17 @@ interface ForParseResult {
   index?: string;
   key?: string;
   itemAliases?: Record<string, string>;
+  /** 原生声明寻址使用实际 wx:key，不重新计算用户 key 表达式。 */
+  effectiveNativeKey?: {
+    kind: 'field';
+    field: string;
+  } | {
+    kind: 'self';
+  } | {
+    kind: 'position';
+  };
+  /** 源码循环别名与避开祖先及编译器内建标识符的原生别名。 */
+  nativeAliases?: Record<string, string>;
   /** 需要在逻辑层完整执行的原始循环项模式。 */
   itemPattern?: string;
   /** 当前循环项模式是否需要投影，避免模板层近似执行。 */
@@ -2110,6 +2131,8 @@ interface TemplateCompileOptions {
   propsAliases?: Record<string, string>;
   propsDerivedKeys?: string[];
   scriptSetupBindings?: Record<string, unknown>;
+  /** 可能与宿主属性同名的 setup 绑定，通过独立计算字段交付模板。 */
+  scriptSetupPropConflicts?: readonly string[];
   htmlTagToWxml?: boolean | Record<string, string>;
   htmlTagToWxmlTagClass?: boolean;
   scopedSlotsCompiler?: ScopedSlotsCompilerMode;
@@ -2122,6 +2145,10 @@ interface TemplateCompileOptions {
   objectLiteralBindMode?: ObjectLiteralBindMode;
   mustacheInterpolation?: MustacheInterpolationMode;
   formatWxml?: boolean;
+  /**
+   * 保留模板注释，供最终产物阶段统一处理；默认移除。
+   */
+  preserveComments?: boolean;
   runtimeBindingManifest?: WevuRuntimeBindingManifestMode;
   wxsExtension?: string;
   classStyleWxsSrc?: string;
@@ -2309,6 +2336,8 @@ interface VueTransformResult {
   componentGenerics?: TemplateCompileResult['componentGenerics'];
   classStyleWxs?: boolean;
   meta?: {
+    routeConfig?: JsonMergeContext['routeConfig'];
+    pageMeta?: JsonMergeContext['pageMeta'];
     /** @internal */
     componentStyleOptions?: ComponentStyleOptions;
     /** @internal */
@@ -2318,6 +2347,8 @@ interface VueTransformResult {
     jsonMacroHash?: string;
     defineOptionsHash?: string;
     sfcSrcDeps?: string[];
+    /** 模板和脚本外部块的编译输入，变化时必须失效完整编译结果。@internal */
+    sfcSrcCompilationDeps?: string[];
     /** 已解析样式中的 CSS 变量表达式快照。@internal */
     cssVars?: string[];
     styleBlocks?: SFCStyleBlock[];
@@ -2814,6 +2845,12 @@ interface TransformScriptOptions {
    * 当前组件模板包含 scoped slot outlet，需要接收 scoped slot 桥接属性。
    */
   scopedSlotHostProperties?: boolean;
+  /**
+   * 微信原生插槽上下文协议，由 SFC 编译期平台与插槽配置决定。
+   *
+   * @internal
+   */
+  nativeSlotContext?: boolean;
   /**
    * 当前 SFC 的 CSS Modules 映射。
    */
@@ -3002,4 +3039,4 @@ interface CollectVueTemplateTagsOptions {
  */
 export declare function collectVueTemplateTags(template: string, options: CollectVueTemplateTagsOptions): Set<string>;
 //#endregion
-export { type AstEngineName, type AutoImportTagsOptions, type AutoUsingComponentsOptions, type BindingCondition, type ClassStyleBinding, type ClassStyleRuntime, type CollectVueTemplateTagsOptions, type CompileVueFileOptions, type CompilerAppShell, type CompilerDiagnostic, type CompilerDiagnosticCode, type CompilerDiagnosticSeverity, type CompilerDiagnosticSource, type CompilerLayoutPropValue, type CompilerPageLayout, type CompilerPageLayoutPlan, type ComponentStyleOptions, type ComponentStylePrimitive, type ExtractPageDeclarationWithDependenciesResult, type ForParseResult, type InlineExpressionAsset, type JsLikeLang, type JsonConfig, type JsonMergeContext, type JsonMergeStage, type JsonMergeStrategy, type MiniProgramPlatform, type ModuleResolver, type MpPlatform, type ReadAndParseSfcOptions, type ResolveSfcBlockSrcOptions, type ResolvedUsingComponentInfo, type ResolvedUsingComponentPath, type ScopedSlotComponentAsset, type SlotFallbackWrapperComponentAsset, type SlotFallbackWrapperStrategy, type SourcePosition, type SourceSpan, type StaticComponentStyleOption, type StaticPageDeclaration, type StaticRouteValue, type StyleCompileOptions, type StyleCompileResult, type TemplateCompileOptions, type TemplateCompileResult, type TemplateRefBinding, type TransformResult, type TransformScriptOptions, type TransformUniAppSourceOptions, type UniAppCompatibilityTarget, type VueSfcBlockChanges, type VueSfcBlockSignatures, type VueSfcBlockType, type VueSfcHmrSignatures, type VueTransformResult, type WevuBindingDependencyV1, type WevuBindingKind, type WevuBindingManifestFeaturesV1, type WevuBindingManifestV1, type WevuBindingRecordV1, type WevuBindingScopeV1, type WevuBindingUpdateMode, type WevuDefaults, type WevuRuntimeBindingManifestMode, type WevuRuntimeBindingManifestV1, type WevuRuntimeBindingRecordV1, compileVueFile as compileSfc, compileVueStyleToWxss as compileStyle, compileVueTemplateToWxml as compileTemplate, transformScript as transformSfcScript };
+export { type AstEngineName, type AutoImportTagsOptions, type AutoUsingComponentsOptions, type BindingCondition, type ClassStyleBinding, type ClassStyleRuntime, type CollectVueTemplateTagsOptions, type CompileVueFileOptions, type CompilerAppShell, type CompilerDiagnostic, type CompilerDiagnosticCode, type CompilerDiagnosticSeverity, type CompilerDiagnosticSource, type CompilerLayoutPropValue, type CompilerPageLayout, type CompilerPageLayoutPlan, type ComponentStyleOptions, type ComponentStylePrimitive, type ExtractPageDeclarationWithDependenciesResult, type ForParseResult, type InlineExpressionAsset, type JsLikeLang, type JsonConfig, type JsonMergeContext, type JsonMergeFunction, type JsonMergeStage, type JsonMergeStrategy, type MiniProgramPlatform, type ModuleResolver, type MpPlatform, type ReadAndParseSfcOptions, type ResolveSfcBlockSrcOptions, type ResolvedUsingComponentInfo, type ResolvedUsingComponentPath, type ScopedSlotComponentAsset, type SlotFallbackWrapperComponentAsset, type SlotFallbackWrapperStrategy, type SourcePosition, type SourceSpan, type StaticComponentStyleOption, type StaticPageDeclaration, type StaticPageMeta, type StaticRouteValue, type StyleCompileOptions, type StyleCompileResult, type TemplateCompileOptions, type TemplateCompileResult, type TemplateRefBinding, type TransformResult, type TransformScriptOptions, type TransformUniAppSourceOptions, type UniAppCompatibilityTarget, type VueSfcBlockChanges, type VueSfcBlockSignatures, type VueSfcBlockType, type VueSfcHmrSignatures, type VueTransformResult, type WevuBindingDependencyV1, type WevuBindingKind, type WevuBindingManifestFeaturesV1, type WevuBindingManifestV1, type WevuBindingRecordV1, type WevuBindingScopeV1, type WevuBindingUpdateMode, type WevuDefaults, type WevuRuntimeBindingManifestMode, type WevuRuntimeBindingManifestV1, type WevuRuntimeBindingRecordV1, compileVueFile as compileSfc, compileVueStyleToWxss as compileStyle, compileVueTemplateToWxml as compileTemplate, transformScript as transformSfcScript };