@wevu/compiler 7.4.0 → 7.6.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";
@@ -228,6 +229,7 @@ interface EncodedSourceMapLike {
  */
 interface ResolveSfcBlockSrcOptions {
   resolveId?: (source: string, importer?: string) => Promise<string | undefined>;
+  /** 自定义读取器的异常原样传出，保留调用方用于重试或重新同步的控制流。 */
   readFile?: (id: string, options?: {
     checkMtime?: boolean;
   }) => Promise<string>;
@@ -1898,6 +1900,10 @@ interface JsonMergeContext {
   filename?: string;
   kind?: 'app' | 'page' | 'component' | 'unknown';
   stage: JsonMergeStage;
+  /** 当前 SFC 页面的静态路由声明。 */
+  routeConfig?: StaticPageDeclaration;
+  /** 整个页面元信息对象可静态提取时提供。 */
+  pageMeta?: StaticPageMeta;
 }
 /**
  * JSON 合并函数。
@@ -1987,6 +1993,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;
@@ -2094,6 +2102,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;
   /** 当前循环项模式是否需要投影，避免模板层近似执行。 */
@@ -2113,10 +2132,16 @@ 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;
   scopedSlotsRequireProps?: boolean;
+  /** 显式启用微信原生普通插槽的声明上下文协议；默认关闭。 */
+  nativeSlotContext?: boolean;
+  /** 上下文分析后需要声明协议的组件标签；未提供时保守保留全部 wevu 组件。@internal */
+  nativeSlotContextTags?: ReadonlySet<string>;
   slotSingleRootNoWrapper?: boolean;
   slotFallbackWrapper?: SlotFallbackWrapperConfig;
   slotFallbackWrapperStrategy?: SlotFallbackWrapperStrategy;
@@ -2292,6 +2317,16 @@ export declare function getMiniProgramTemplatePlatform(platform?: MpPlatform): M
  */
 export declare function compileVueTemplateToWxml(template: string, filename: string, options?: TemplateCompileOptions): TemplateCompileResult;
 //#endregion
+//#region src/plugins/vue/transform/compileVueFile/nativeSlotContext/source.d.ts
+interface SourceFacts {
+  source: string;
+  descriptor?: SFCDescriptor;
+  invalid?: boolean;
+  ast?: File;
+}
+/** 缓存单个源文件的原始输入与解析事实，不保存递归分类或递归任务。 */
+type NativeSlotContextAnalysisCache = Map<string, Promise<SourceFacts | undefined>>;
+//#endregion
 //#region src/plugins/vue/transform/compileVueFile/types.d.ts
 interface ResolvedUsingComponentInfo {
   from?: string;
@@ -2316,8 +2351,12 @@ interface VueTransformResult {
   componentGenerics?: TemplateCompileResult['componentGenerics'];
   classStyleWxs?: boolean;
   meta?: {
+    routeConfig?: JsonMergeContext['routeConfig'];
+    pageMeta?: JsonMergeContext['pageMeta'];
     /** @internal */
     componentStyleOptions?: ComponentStyleOptions;
+    /** 已解析模板和计算绑定的注册签名；包含外部模板与静态 JSX 展开。@internal */
+    templateRegistrationSignature?: string;
     /** @internal */
     runtimeCapabilities?: WevuRuntimeCapabilityMetadata;
     hasScriptSetup?: boolean;
@@ -2325,6 +2364,10 @@ interface VueTransformResult {
     jsonMacroHash?: string;
     defineOptionsHash?: string;
     sfcSrcDeps?: string[];
+    /** 模板和脚本外部块的编译输入，变化时必须失效完整编译结果。@internal */
+    sfcSrcCompilationDeps?: string[];
+    /** 原生插槽上下文分析读取的源码依赖，变化时必须重新编译引用方。@internal */
+    nativeSlotContextDeps?: string[];
     /** 已解析样式中的 CSS 变量表达式快照。@internal */
     cssVars?: string[];
     styleBlocks?: SFCStyleBlock[];
@@ -2447,11 +2490,17 @@ interface CompileVueFileOptions {
     mergeStrategy?: JsonMergeStrategy;
   };
   sfcSrc?: ResolveSfcBlockSrcOptions;
+  /** JSX/TSX 跨文件静态展开的同步源码读取；未提供时读取磁盘。 */
+  jsx?: {
+    readFile: (filename: string) => string;
+  };
   wevuDefaults?: WevuDefaults;
   /**
    * 缓存被当前 SFC 引用的 Vue 组件静态元信息，避免重复读取和解析同一组件。
    */
   componentMetaCache?: Map<string, Promise<VueSfcStaticComponentMeta>>;
+  /** 原生插槽上下文分析的单文件事实缓存，不缓存传递闭包。@internal */
+  nativeSlotContextCache?: NativeSlotContextAnalysisCache;
 }
 //#endregion
 //#region src/plugins/jsx/compileJsxFile.d.ts
@@ -2821,6 +2870,12 @@ interface TransformScriptOptions {
    * 当前组件模板包含 scoped slot outlet，需要接收 scoped slot 桥接属性。
    */
   scopedSlotHostProperties?: boolean;
+  /**
+   * 微信原生插槽上下文协议，由 SFC 编译期平台与插槽配置决定。
+   *
+   * @internal
+   */
+  nativeSlotContext?: boolean;
   /**
    * 当前 SFC 的 CSS Modules 映射。
    */
@@ -3009,4 +3064,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 };