@wevu/compiler 7.0.4 → 7.1.1

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import { WevuBindingUpdateMode, WevuBindingUpdateMode as WevuBindingUpdateMode$1, WevuRuntimeBindingManifestV1, WevuRuntimeBindingRecordV1 } from "@weapp-core/constants";
 import { MpPlatform } from "@weapp-core/shared";
 import * as t from "@weapp-vite/ast/babelTypes";
 import { Expression } from "@weapp-vite/ast/babelTypes";
@@ -15,6 +16,106 @@ export declare const builtinComponentsSet: Set<string>;
  */
 export declare function isBuiltinComponent(tag: string): boolean;
 //#endregion
+//#region src/types/diagnostics.d.ts
+type CompilerDiagnosticCode = 'WV1002' | 'WV1003' | 'WV2002' | 'WV2001' | 'WV1001';
+type CompilerDiagnosticSeverity = 'error' | 'warning';
+type CompilerDiagnosticSource = 'expression' | 'jsx' | 'script' | 'sfc' | 'style' | 'template';
+/**
+ * 编译源码中的位置。行号和列号均从 1 开始，偏移量从 0 开始。
+ */
+interface SourcePosition {
+  offset: number;
+  line: number;
+  column: number;
+}
+/**
+ * 编译源码中的半开区间，结束位置不包含在范围内。
+ */
+interface SourceSpan {
+  start: SourcePosition;
+  end: SourcePosition;
+}
+/**
+ * 可供构建工具和编辑器稳定消费的编译诊断。
+ */
+interface CompilerDiagnostic {
+  code: CompilerDiagnosticCode;
+  severity: CompilerDiagnosticSeverity;
+  message: string;
+  filename: string;
+  source: CompilerDiagnosticSource;
+  loc?: SourceSpan;
+}
+//#endregion
+//#region src/types/bindingManifest.d.ts
+/**
+ * 模板绑定的语义类型。
+ */
+type WevuBindingKind = 'text' | 'attribute' | 'class' | 'style' | 'if' | 'for' | 'component-prop';
+/**
+ * 单个源码依赖及其独立更新策略。
+ */
+interface WevuBindingDependencyV1 {
+  root: string;
+  path?: string;
+  updateMode: WevuBindingUpdateMode$1;
+}
+/**
+ * 模板绑定所在的词法作用域。
+ */
+interface WevuBindingScopeV1 {
+  kind: 'root' | 'for' | 'slot-owner' | 'slot-props';
+  depth: number;
+  locals?: string[];
+}
+/**
+ * 单个模板输出与其源码依赖之间的稳定映射。
+ */
+interface WevuBindingRecordV1 {
+  id: string;
+  kind: WevuBindingKind;
+  outputPath: string;
+  /** 仅在绑定源码归属不同于清单默认文件时记录。 */
+  sourceFile?: string;
+  sourceRoots: string[];
+  sourcePaths?: string[];
+  dependencies: WevuBindingDependencyV1[];
+  scopes: WevuBindingScopeV1[];
+  updateMode: WevuBindingUpdateMode$1;
+  sourceLocation?: SourceSpan;
+}
+/**
+ * 当前模板使用的按需编译能力。
+ */
+interface WevuBindingManifestFeaturesV1 {
+  inlineEvents?: true;
+  templateRefs?: true;
+  scopedSlots?: true;
+  model?: true;
+  layout?: true;
+  functionProps?: true;
+  jsxIslands?: true;
+}
+/**
+ * 由编译器拥有的第一版完整模板绑定 IR。
+ */
+interface WevuBindingManifestV1 {
+  version: 1;
+  sourceFile: string;
+  bindings: WevuBindingRecordV1[];
+  features: WevuBindingManifestFeaturesV1;
+}
+/**
+ * 注入运行时的 Binding Manifest 精简级别。
+ */
+type WevuRuntimeBindingManifestMode = 'compact' | 'diagnostic';
+//#endregion
+//#region src/bindingManifest.d.ts
+/**
+ * 将编译期完整 IR 投影为运行时更新和诊断所需的最小元数据。
+ */
+export declare function createRuntimeBindingManifest(manifest: WevuBindingManifestV1, mode?: WevuRuntimeBindingManifestMode): WevuRuntimeBindingManifestV1;
+//#endregion
 //#region src/constants.d.ts
 export declare const WE_VU_PAGE_HOOK_TO_FEATURE: {
   readonly onPageScroll: "enableOnPageScroll";
@@ -82,7 +183,7 @@ export type WevuRuntimeApiName = (typeof WE_VU_RUNTIME_APIS)[keyof typeof WE_VU_
 /**
  * wevu 内部响应式 API 名称。
  */
-export declare const WE_VU_INTERNAL_REACTIVITY_APIS: readonly ["addMutationRecorder", "batch", "computed", "customRef", "effect", "effectScope", "endBatch", "getCurrentScope", "getDeepWatchStrategy", "getReactiveVersion", "isProxy", "isRaw", "isReactive", "isReadonly", "isRef", "isShallowReactive", "isShallowRef", "markRaw", "nextTick", "onScopeDispose", "prelinkReactiveTree", "reactive", "readonly", "ref", "removeMutationRecorder", "setDeepWatchStrategy", "shallowReactive", "shallowReadonly", "shallowRef", "startBatch", "stop", "toRaw", "toRef", "toRefs", "toValue", "touchReactive", "traverse", "triggerRef", "unref", "watch", "watchEffect", "watchPostEffect", "watchSyncEffect"];
+export declare const WE_VU_INTERNAL_REACTIVITY_APIS: readonly ["addMutationRecorder", "batch", "computed", "customRef", "effect", "effectScope", "endBatch", "getCurrentScope", "getDeepWatchStrategy", "getReactiveVersion", "isProxy", "isRaw", "isReactive", "isReadonly", "isRef", "isShallowReactive", "isShallowRef", "markRaw", "nextTick", "onScopeDispose", "prelinkReactiveTree", "reactive", "readonly", "ref", "removeMutationRecorder", "setDeepWatchStrategy", "shallowReactive", "shallowReadonly", "shallowRef", "startBatch", "stop", "toRaw", "toRef", "toRefs", "toValue", "touchReactive", "traverse", "triggerRef", "unref", "useAsyncDerivation", "watch", "watchEffect", "watchPostEffect", "watchSyncEffect"];
 /**
  * wevu 内部模板工具 API 名称。
  */
@@ -92,35 +193,45 @@ export declare const WE_VU_INTERNAL_TEMPLATE_APIS: readonly ["normalizeClass", "
  */
 export declare function resolveWevuInternalImportModuleId(apiName: string): "virtual:weapp-vite/runtime" | "virtual:weapp-vite/runtime/reactivity" | "virtual:weapp-vite/runtime/template";
 //#endregion
-//#region src/types/diagnostics.d.ts
-type CompilerDiagnosticCode = 'WV1002' | 'WV1003' | 'WV2002' | 'WV2001' | 'WV1001';
-type CompilerDiagnosticSeverity = 'error' | 'warning';
-type CompilerDiagnosticSource = 'expression' | 'jsx' | 'script' | 'sfc' | 'style' | 'template';
+//#region src/runtimeCapabilities.d.ts
 /**
- * 编译源码中的位置。行号和列号均从 1 开始，偏移量从 0 开始。
+ * wevu 编译器内部使用的运行时能力规范顺序。
+ *
+ * @internal
  */
-interface SourcePosition {
-  offset: number;
-  line: number;
-  column: number;
-}
+declare const WE_VU_RUNTIME_CAPABILITY_ORDER: readonly ["patchStrategy", "templateRefs", "inlineEvents", "setDataHighFrequencyWarning", "scopedSlots", "layout"];
 /**
- * 编译源码中的半开区间，结束位置不包含在范围内。
+ * wevu 编译器内部使用的运行时能力名称。
+ *
+ * @internal
  */
-interface SourceSpan {
-  start: SourcePosition;
-  end: SourcePosition;
-}
+type WevuRuntimeCapabilityName = (typeof WE_VU_RUNTIME_CAPABILITY_ORDER)[number];
 /**
- * 可供构建工具和编辑器稳定消费的编译诊断。
+ * compiler 各阶段与 bundler 之间传递的内部运行时能力元数据。
+ *
+ * @internal
  */
-interface CompilerDiagnostic {
-  code: CompilerDiagnosticCode;
-  severity: CompilerDiagnosticSeverity;
-  message: string;
-  filename: string;
-  source: CompilerDiagnosticSource;
-  loc?: SourceSpan;
+interface WevuRuntimeCapabilityMetadata {
+  required: WevuRuntimeCapabilityName[];
+  conservative?: WevuRuntimeCapabilityName[];
+}
+//#endregion
+//#region src/types/componentStyleOptions.d.ts
+/** 编译期可证明的静态原语；显式 undefined 与属性缺失分别保留。 */
+type ComponentStylePrimitive = string | boolean | number | null | undefined;
+/** 小程序组件样式选项的静态解析状态。 */
+type StaticComponentStyleOption = {
+  kind: 'absent';
+} | {
+  kind: 'unknown';
+} | {
+  kind: 'known';
+  value: ComponentStylePrimitive;
+};
+/** Component 注册 options 的静态样式信息；定义过滤器等可能修改宿主配置时不产出此元数据。 */
+interface ComponentStyleOptions {
+  styleIsolation: StaticComponentStyleOption;
+  addGlobalClass: StaticComponentStyleOption;
 }
 //#endregion
 //#region src/types/json.d.ts
@@ -166,6 +277,40 @@ interface JsonConfig {
   mergeStrategy?: JsonMergeStrategy;
 }
 //#endregion
+//#region src/types/pageLayout.d.ts
+/**
+ * 页面布局属性可序列化值。
+ */
+type CompilerLayoutPropValue = string | number | boolean | null | {
+  kind: 'expression';
+  expression: string;
+};
+/**
+ * 编译阶段需要的单个页面布局描述。
+ */
+interface CompilerPageLayout {
+  importPath: string;
+  layoutName: string;
+  tagName: string;
+  props?: Record<string, CompilerLayoutPropValue>;
+}
+/**
+ * 构建工具解析后传给编译器的页面布局计划。
+ */
+interface CompilerPageLayoutPlan {
+  currentLayout?: CompilerPageLayout;
+  dynamicSwitch: boolean;
+  layouts: CompilerPageLayout[];
+  dynamicPropKeys: string[];
+}
+/**
+ * 构建工具解析后传给编译器的应用外壳描述。
+ */
+interface CompilerAppShell {
+  importPath: string;
+  tagName: string;
+}
+//#endregion
 //#region src/types/wevu.d.ts
 /**
  * wevu JSON 默认值配置（app/component）。
@@ -286,6 +431,7 @@ interface MiniProgramPlatform {
   keyThisValue: string;
   keyAttr: (value: string) => string;
   mapEventName: (eventName: string) => string;
+  eventBindingAlias?: (eventName: string, tagName?: string) => string | undefined;
   eventBindingAttr: (eventName: string) => string;
 }
 //#endregion
@@ -300,11 +446,16 @@ interface ScopedSlotComponentAsset {
   hostComponentName?: string;
   slotKey: string;
   template: string;
+  script: string;
+  scriptMap?: EncodedSourceMapLike | null;
+  bindingManifest: WevuBindingManifestV1;
   componentGenerics?: Record<string, true>;
-  classStyleBindings?: ClassStyleBinding[];
   classStyleWxs?: boolean;
   inlineExpressions?: InlineExpressionAsset[];
   templateRefs?: TemplateRefBinding[];
+  layoutHosts?: LayoutHostBinding[];
+  /** @internal */
+  runtimeCapabilities?: WevuRuntimeCapabilityMetadata;
 }
 /**
  * 内联表达式资源描述。
@@ -336,6 +487,7 @@ interface InlineExpressionAsset {
 interface TemplateCompileResult {
   code: string;
   diagnostics: CompilerDiagnostic[];
+  bindingManifest: WevuBindingManifestV1;
   scopedSlotComponents?: ScopedSlotComponentAsset[];
   slotFallbackWrapperComponent?: SlotFallbackWrapperComponentAsset;
   componentGenerics?: Record<string, true>;
@@ -345,7 +497,10 @@ interface TemplateCompileResult {
   templateRefs?: TemplateRefBinding[];
   layoutHosts?: LayoutHostBinding[];
   inlineExpressions?: InlineExpressionAsset[];
+  /** @internal */
+  runtimeCapabilities?: WevuRuntimeCapabilityMetadata;
   functionPropPaths?: string[];
+  hasSlotOutlet?: boolean;
 }
 /**
  * v-for 解析结果。
@@ -354,6 +509,8 @@ interface ForParseResult {
   listExp?: string;
   rawListExp?: string;
   listExpAst?: Expression;
+  /** 保留祖先循环原始项访问，供 key 投影计算遍历使用。 */
+  rawListExpAst?: Expression;
   projectedListExp?: string;
   projectedListExpAst?: Expression;
   item?: string;
@@ -386,6 +543,7 @@ interface TemplateCompileOptions {
   objectLiteralBindMode?: ObjectLiteralBindMode;
   mustacheInterpolation?: MustacheInterpolationMode;
   formatWxml?: boolean;
+  runtimeBindingManifest?: WevuRuntimeBindingManifestMode;
   wxsExtension?: string;
   classStyleWxsSrc?: string;
   functionPropNames?: Iterable<FunctionPropNameMatcher>;
@@ -454,6 +612,16 @@ type ObjectLiteralBindMode = 'runtime' | 'inline';
  * Mustache 输出风格。
  */
 type MustacheInterpolationMode = 'compact' | 'spaced';
+/**
+ * 运行时绑定的条件分支及其循环作用域。
+ */
+interface BindingCondition {
+  expAst: Expression;
+  /** 键投影遍历原始项时使用的条件。 */
+  rawExpAst?: Expression;
+  /** 条件必须在对应循环深度进入下一层列表之前求值。 */
+  forDepth: number;
+}
 /**
  * class/style 绑定信息。
  */
@@ -464,6 +632,7 @@ interface ClassStyleBinding {
   expAst?: Expression;
   errorFallback?: string;
   forStack: ForParseResult[];
+  conditions?: BindingCondition[];
 }
 /**
  * template ref 绑定信息。
@@ -553,6 +722,7 @@ interface VueTransformResult {
   template?: string;
   style?: string;
   config?: string;
+  bindingManifest?: WevuBindingManifestV1;
   diagnostics?: CompilerDiagnostic[];
   cssModules?: Record<string, Record<string, string>>;
   scopedSlotComponents?: TemplateCompileResult['scopedSlotComponents'];
@@ -560,6 +730,10 @@ interface VueTransformResult {
   componentGenerics?: TemplateCompileResult['componentGenerics'];
   classStyleWxs?: boolean;
   meta?: {
+    /** @internal */
+    componentStyleOptions?: ComponentStyleOptions;
+    /** @internal */
+    runtimeCapabilities?: WevuRuntimeCapabilityMetadata;
     hasScriptSetup?: boolean;
     hasSetupOption?: boolean;
     jsonMacroHash?: string;
@@ -635,6 +809,26 @@ interface CompileVueFileOptions {
    * 是否生成脚本 sourcemap。默认开启；构建工具可在未启用 sourcemap 时显式关闭以减少 codegen 成本。
    */
   sourceMap?: boolean;
+  /**
+   * 是否根据绑定清单自动合并 setData.pick。
+   */
+  autoSetDataPick?: boolean;
+  /**
+   * 绑定清单中记录的源码文件名；默认使用当前编译文件名。
+   */
+  bindingManifestSourceFile?: string;
+  /**
+   * 注入组件脚本的 Binding Manifest 精简级别；默认仅保留运行时必要字段。
+   */
+  runtimeBindingManifest?: WevuRuntimeBindingManifestMode;
+  /**
+   * 构建工具预先解析的可序列化页面布局计划。
+   */
+  pageLayout?: CompilerPageLayoutPlan;
+  /**
+   * 页面布局外层的应用外壳。
+   */
+  appShell?: CompilerAppShell;
   warn?: (message: string) => void;
   autoUsingComponents?: AutoUsingComponentsOptions;
   autoImportTags?: AutoImportTagsOptions;
@@ -699,18 +893,15 @@ export declare function transformUniAppSource(source: string, options: Transform
 export declare function isUniAppCompatibilityFile(filename: string, srcRoot: string, include: readonly string[]): boolean;
 //#endregion
 //#region src/plugins/utils/cache.d.ts
-export declare const mtimeCache: Map<string, {
+interface FileSignature {
   ctimeMs: number;
   ino: number;
   mtimeMs: number;
   size: number;
-}>;
+}
+export declare const mtimeCache: Map<string, FileSignature>;
 export declare const loadCache: LRUCache<string, string, unknown>;
-/**
- * 返回 true 的时候需要重新 fs 读取
- * @param id 文件路径
- * @returns {Promise<boolean>} 当文件需要重新读取时返回 true
- */
+/** 检查文件签名是否变化；签名观察不能单独证明缓存内容已更新。 */
 export declare function isInvalidate(id: string): Promise<boolean>;
 export declare function readFile(id: string, options?: {
   checkMtime?: boolean;
@@ -732,9 +923,7 @@ export declare function invalidateFileCache(id: string): void;
 export declare function clearFileCaches(): void;
 //#endregion
 //#region src/plugins/vue/compiler/wxss.d.ts
-/**
- * 压平 WXSS 不接受的嵌套 CSS 变量回退值。
- */
+/** 保留兼容入口；WXSS 支持嵌套变量回退，不得丢弃依赖级联的内层变量。 */
 export declare function transformNestedWxssVars(source: string): string;
 //#endregion
 //#region src/plugins/vue/compiler/style.d.ts
@@ -923,6 +1112,10 @@ interface TransformResult {
   code: string;
   transformed: boolean;
   map?: EncodedSourceMapLike | null;
+  /** @internal */
+  runtimeCapabilities?: WevuRuntimeCapabilityMetadata;
+  /** @internal */
+  componentStyleOptions?: ComponentStyleOptions;
 }
 interface TransformScriptOptions {
   /**
@@ -985,6 +1178,24 @@ interface TransformScriptOptions {
    * 内联表达式元数据（用于事件处理）
    */
   inlineExpressions?: InlineExpressionAsset[];
+  /**
+   * 模板遍历产生的版本化绑定清单。
+   */
+  bindingManifest?: WevuBindingManifestV1;
+  /**
+   * 注入组件脚本的 Binding Manifest 精简级别。
+   */
+  runtimeBindingManifest?: WevuRuntimeBindingManifestMode;
+  /**
+   * 是否根据绑定清单自动合并 setData.pick。
+   */
+  autoSetDataPick?: boolean;
+  /**
+   * 当前页面的编译期布局计划。
+   */
+  pageLayout?: CompilerPageLayoutPlan;
+  /** @internal */
+  runtimeCapabilities?: WevuRuntimeCapabilityMetadata;
   /**
    * 模板中作为组件 prop 传递的函数候选路径。
    */
@@ -1188,4 +1399,4 @@ interface CollectVueTemplateTagsOptions {
  */
 export declare function collectVueTemplateTags(template: string, options: CollectVueTemplateTagsOptions): Set<string>;
 //#endregion
-export { type AstEngineName, type AutoImportTagsOptions, type AutoUsingComponentsOptions, type ClassStyleBinding, type ClassStyleRuntime, type CollectVueTemplateTagsOptions, type CompileVueFileOptions, type CompilerDiagnostic, type CompilerDiagnosticCode, type CompilerDiagnosticSeverity, type CompilerDiagnosticSource, 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 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 WevuDefaults, 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 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 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 };