@weapp-vite/ast 6.8.0 → 6.9.0

package/README.md

@@ -63,15 +63,53 @@ const result = collectJsxAutoComponentsFromCode(code, {
 })
 ```
 
-## 导出能力
+## 稳定 API
+
+建议优先从根入口导入稳定 API：
 
 - `parseJsLikeWithEngine`
 - `collectComponentPropsFromCode`
 - `collectFeatureFlagsFromCode`
 - `collectJsxAutoComponentsFromCode`
+- `collectJsxImportedComponentsAndDefaultExportFromBabelAst`
+- `collectJsxTemplateTagsFromBabelExpression`
 - `mayContainPlatformApiAccess`
 - `collectRequireTokens`
 - `collectScriptSetupImportsFromCode`
+- `unwrapTypeScriptExpression`
+- `getObjectPropertyByKey`
+- `getRenderPropertyFromComponentOptions`
+- `resolveRenderExpressionFromComponentOptions`
+
+## 子路径导出
+
+如果需要更细粒度地按能力引用，也可以使用这些子路径导出：
+
+- `@weapp-vite/ast/babel`
+- `@weapp-vite/ast/babelNodes`
+- `@weapp-vite/ast/engine`
+- `@weapp-vite/ast/types`
+- `@weapp-vite/ast/operations/componentProps`
+- `@weapp-vite/ast/operations/featureFlags`
+- `@weapp-vite/ast/operations/jsxAutoComponents`
+- `@weapp-vite/ast/operations/platformApi`
+- `@weapp-vite/ast/operations/require`
+- `@weapp-vite/ast/operations/scriptSetupImports`
+
+默认建议：
+
+- 业务侧优先使用根入口
+- 只有在需要低层 helper 或做更细粒度 tree-shaking 时，再使用子路径导入
+
+## 发布校验
+
+包内可直接运行以下命令做独立校验：
+
+```bash
+pnpm build
+pnpm test
+pnpm run check:release
+```
 
 ## 相关链接
 

package/dist/babelCore.d.mts

@@ -0,0 +1,2 @@
+import core_default, { NodePath, TransformOptions } from "@babel/core";
+export { type NodePath, type TransformOptions, core_default as default };

package/dist/babelCore.mjs

@@ -0,0 +1,2 @@
+import core_default from "@babel/core";
+export { core_default as default };

package/dist/babelNodes.d.mts

@@ -5,6 +5,8 @@ import { Expression, ObjectExpression, ObjectMethod, ObjectProperty, PrivateName
 declare function unwrapTypeScriptExpression(exp: Expression): Expression;
 declare function toStaticObjectKey(key: Expression | PrivateName | t.Identifier): string | null;
 declare function getObjectPropertyByKey(node: ObjectExpression, key: string): ObjectMethod | ObjectProperty | null;
+declare function getRenderPropertyFromComponentOptions(componentExpr: Expression): ObjectMethod | ObjectProperty | null;
 declare function resolveRenderableExpression(node: ObjectMethod | ObjectProperty): Expression | null;
+declare function resolveRenderExpressionFromComponentOptions(componentExpr: Expression): Expression | null;
 //#endregion
-export { getObjectPropertyByKey, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression };
+export { getObjectPropertyByKey, getRenderPropertyFromComponentOptions, resolveRenderExpressionFromComponentOptions, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression };

package/dist/babelNodes.mjs

@@ -31,6 +31,13 @@ function getObjectPropertyByKey(node, key) {
 	}
 	return null;
 }
+function getRenderPropertyFromComponentOptions(componentExpr) {
+	if (!t.isObjectExpression(componentExpr)) return null;
+	const renderNode = getObjectPropertyByKey(componentExpr, "render");
+	if (!renderNode) return null;
+	if (!t.isObjectMethod(renderNode) && !t.isObjectProperty(renderNode)) return null;
+	return renderNode;
+}
 function resolveRenderableExpression(node) {
 	if (t.isObjectMethod(node)) {
 		for (const statement of node.body.body) if (t.isReturnStatement(statement) && statement.argument) return unwrapTypeScriptExpression(statement.argument);
@@ -50,5 +57,10 @@ function resolveRenderableExpression(node) {
 	}
 	return null;
 }
+function resolveRenderExpressionFromComponentOptions(componentExpr) {
+	const renderNode = getRenderPropertyFromComponentOptions(componentExpr);
+	if (!renderNode) return null;
+	return resolveRenderableExpression(renderNode);
+}
 //#endregion
-export { getObjectPropertyByKey, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression };
+export { getObjectPropertyByKey, getRenderPropertyFromComponentOptions, resolveRenderExpressionFromComponentOptions, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression };

package/dist/babelTraverse.d.mts

@@ -0,0 +1,2 @@
+import traverse_default, { HubInterface, NodePath, Scope, TraverseOptions, Visitor } from "@babel/traverse";
+export { type HubInterface, type NodePath, type Scope, type TraverseOptions, type Visitor, traverse_default as default };

package/dist/babelTraverse.mjs

@@ -0,0 +1,2 @@
+import traverse_default from "@babel/traverse";
+export { traverse_default as default };

package/dist/babelTypes.d.mts

@@ -0,0 +1 @@
+export * from "@babel/types";

package/dist/babelTypes.mjs

@@ -0,0 +1,2 @@
+export * from "@babel/types";
+export {};

package/dist/index.d.mts

@@ -1,13 +1,15 @@
 import { BABEL_TS_MODULE_PARSER_OPTIONS, BABEL_TS_MODULE_PLUGINS, generate, getVisitorKeys, parse, parseJsLike, traverse } from "./babel.mjs";
-import { getObjectPropertyByKey, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression } from "./babelNodes.mjs";
+import { getObjectPropertyByKey, getRenderPropertyFromComponentOptions, resolveRenderExpressionFromComponentOptions, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression } from "./babelNodes.mjs";
 import { AstEngineName, AstParserLike, WeappAstConfig } from "./types.mjs";
 import { parseJsLikeWithEngine } from "./engine.mjs";
 import { ComponentPropMap, collectComponentPropsFromCode } from "./operations/componentProps.mjs";
 import { FeatureFlagOptions, collectFeatureFlagsFromCode } from "./operations/featureFlags.mjs";
-import { JsxAutoComponentAnalysisOptions, JsxAutoComponentContext, JsxBabelModuleAnalysisOptions, JsxImportedComponent, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst } from "./operations/jsxAutoComponents.mjs";
+import { JsxAutoComponentAnalysisOptions, JsxAutoComponentContext, JsxBabelModuleAnalysisOptions, JsxImportedComponent, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectJsxTemplateTagsFromBabelExpression } from "./operations/jsxAutoComponents.mjs";
+import { collectOnPageScrollPerformanceWarnings } from "./operations/onPageScroll.mjs";
 import { mayContainPlatformApiAccess, platformApiIdentifiers } from "./operations/platformApi.mjs";
 import { RequireToken, collectRequireTokens, mayContainStaticRequireLiteral } from "./operations/require.mjs";
 import { ScriptSetupImport, collectScriptSetupImportsFromCode } from "./operations/scriptSetupImports.mjs";
+import { collectSetDataPickKeysFromTemplateCode } from "./operations/setDataPick.mjs";
 import * as _babel_types0 from "@babel/types";
 import * as oxc_parser0 from "oxc-parser";
 
@@ -29,4 +31,4 @@ declare const oxcAstEngine: {
   parseJsLike(code: string, filename?: string): oxc_parser0.Program;
 };
 //#endregion
-export { type AstEngineName, type AstParserLike, BABEL_TS_MODULE_PARSER_OPTIONS, BABEL_TS_MODULE_PLUGINS, type ComponentPropMap, type FeatureFlagOptions, type JsxAutoComponentAnalysisOptions, type JsxAutoComponentContext, type JsxBabelModuleAnalysisOptions, type JsxImportedComponent, type RequireToken, type ScriptSetupImport, type WeappAstConfig, babelAstEngine, collectComponentPropsFromCode, collectFeatureFlagsFromCode, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectRequireTokens, collectScriptSetupImportsFromCode, generate, getObjectPropertyByKey, getVisitorKeys, mayContainPlatformApiAccess, mayContainStaticRequireLiteral, oxcAstEngine, parse, parseJsLike, parseJsLikeWithEngine, platformApiIdentifiers, resolveRenderableExpression, toStaticObjectKey, traverse, unwrapTypeScriptExpression };
+export { type AstEngineName, type AstParserLike, BABEL_TS_MODULE_PARSER_OPTIONS, BABEL_TS_MODULE_PLUGINS, type ComponentPropMap, type FeatureFlagOptions, type JsxAutoComponentAnalysisOptions, type JsxAutoComponentContext, type JsxBabelModuleAnalysisOptions, type JsxImportedComponent, type RequireToken, type ScriptSetupImport, type WeappAstConfig, babelAstEngine, collectComponentPropsFromCode, collectFeatureFlagsFromCode, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectJsxTemplateTagsFromBabelExpression, collectOnPageScrollPerformanceWarnings, collectRequireTokens, collectScriptSetupImportsFromCode, collectSetDataPickKeysFromTemplateCode, generate, getObjectPropertyByKey, getRenderPropertyFromComponentOptions, getVisitorKeys, mayContainPlatformApiAccess, mayContainStaticRequireLiteral, oxcAstEngine, parse, parseJsLike, parseJsLikeWithEngine, platformApiIdentifiers, resolveRenderExpressionFromComponentOptions, resolveRenderableExpression, toStaticObjectKey, traverse, unwrapTypeScriptExpression };

package/dist/index.mjs

@@ -1,10 +1,12 @@
 import { BABEL_TS_MODULE_PARSER_OPTIONS, BABEL_TS_MODULE_PLUGINS, generate, getVisitorKeys, parse, parseJsLike, traverse } from "./babel.mjs";
-import { getObjectPropertyByKey, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression } from "./babelNodes.mjs";
+import { getObjectPropertyByKey, getRenderPropertyFromComponentOptions, resolveRenderExpressionFromComponentOptions, resolveRenderableExpression, toStaticObjectKey, unwrapTypeScriptExpression } from "./babelNodes.mjs";
 import { n as oxcAstEngine, r as babelAstEngine, t as parseJsLikeWithEngine } from "./engine-DHqNPCDA.mjs";
 import { collectComponentPropsFromCode } from "./operations/componentProps.mjs";
 import { collectFeatureFlagsFromCode } from "./operations/featureFlags.mjs";
-import { collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst } from "./operations/jsxAutoComponents.mjs";
+import { collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectJsxTemplateTagsFromBabelExpression } from "./operations/jsxAutoComponents.mjs";
+import { collectOnPageScrollPerformanceWarnings } from "./operations/onPageScroll.mjs";
 import { mayContainPlatformApiAccess, platformApiIdentifiers } from "./operations/platformApi.mjs";
 import { collectRequireTokens, mayContainStaticRequireLiteral } from "./operations/require.mjs";
 import { collectScriptSetupImportsFromCode } from "./operations/scriptSetupImports.mjs";
-export { BABEL_TS_MODULE_PARSER_OPTIONS, BABEL_TS_MODULE_PLUGINS, babelAstEngine, collectComponentPropsFromCode, collectFeatureFlagsFromCode, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectRequireTokens, collectScriptSetupImportsFromCode, generate, getObjectPropertyByKey, getVisitorKeys, mayContainPlatformApiAccess, mayContainStaticRequireLiteral, oxcAstEngine, parse, parseJsLike, parseJsLikeWithEngine, platformApiIdentifiers, resolveRenderableExpression, toStaticObjectKey, traverse, unwrapTypeScriptExpression };
+import { collectSetDataPickKeysFromTemplateCode } from "./operations/setDataPick.mjs";
+export { BABEL_TS_MODULE_PARSER_OPTIONS, BABEL_TS_MODULE_PLUGINS, babelAstEngine, collectComponentPropsFromCode, collectFeatureFlagsFromCode, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectJsxTemplateTagsFromBabelExpression, collectOnPageScrollPerformanceWarnings, collectRequireTokens, collectScriptSetupImportsFromCode, collectSetDataPickKeysFromTemplateCode, generate, getObjectPropertyByKey, getRenderPropertyFromComponentOptions, getVisitorKeys, mayContainPlatformApiAccess, mayContainStaticRequireLiteral, oxcAstEngine, parse, parseJsLike, parseJsLikeWithEngine, platformApiIdentifiers, resolveRenderExpressionFromComponentOptions, resolveRenderableExpression, toStaticObjectKey, traverse, unwrapTypeScriptExpression };

package/dist/operations/jsxAutoComponents.d.mts

@@ -28,9 +28,10 @@ declare function collectJsxImportedComponentsAndDefaultExportFromBabelAst(ast: t
   importedComponents: JsxImportedComponent[];
   exportDefaultExpression: null;
 };
+declare function collectJsxTemplateTagsFromBabelExpression(renderExpression: Expression, isCollectableTag: (tag: string) => boolean): Set<string>;
 /**
  * 从 JSX 源码中收集自动 usingComponents 所需的导入组件与模板标签。
  */
 declare function collectJsxAutoComponentsFromCode(source: string, options: JsxAutoComponentAnalysisOptions): JsxAutoComponentContext;
 //#endregion
-export { JsxAutoComponentAnalysisOptions, JsxAutoComponentContext, JsxBabelModuleAnalysisOptions, JsxImportedComponent, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst };
+export { JsxAutoComponentAnalysisOptions, JsxAutoComponentContext, JsxBabelModuleAnalysisOptions, JsxImportedComponent, collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectJsxTemplateTagsFromBabelExpression };

package/dist/operations/jsxAutoComponents.mjs

@@ -91,7 +91,7 @@ function collectJsxImportedComponentsAndDefaultExportFromBabelAst(ast, options =
 		exportDefaultExpression
 	};
 }
-function collectJsxTemplateTags(renderExpression, isCollectableTag) {
+function collectJsxTemplateTagsFromBabelExpression(renderExpression, isCollectableTag) {
 	const tags = /* @__PURE__ */ new Set();
 	function walk(node) {
 		if (t.isJSXElement(node)) {
@@ -209,7 +209,7 @@ function collectWithBabel(source, options) {
 		importedComponents
 	};
 	return {
-		templateTags: collectJsxTemplateTags(renderExpression, options.isCollectableTag),
+		templateTags: collectJsxTemplateTagsFromBabelExpression(renderExpression, options.isCollectableTag),
 		importedComponents
 	};
 }
@@ -302,4 +302,4 @@ function collectJsxAutoComponentsFromCode(source, options) {
 	}
 }
 //#endregion
-export { collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst };
+export { collectJsxAutoComponentsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectJsxTemplateTagsFromBabelExpression };

package/dist/operations/onPageScroll.d.mts

@@ -0,0 +1,11 @@
+import { AstEngineName } from "../types.mjs";
+
+//#region src/operations/onPageScroll.d.ts
+/**
+ * 静态检测 onPageScroll 中的常见性能风险并返回告警文案。
+ */
+declare function collectOnPageScrollPerformanceWarnings(code: string, filename: string, options?: {
+  engine?: AstEngineName;
+}): string[];
+//#endregion
+export { collectOnPageScrollPerformanceWarnings };

package/dist/operations/onPageScroll.mjs

@@ -0,0 +1,259 @@
+import { parseJsLike, traverse } from "../babel.mjs";
+import { t as parseJsLikeWithEngine } from "../engine-DHqNPCDA.mjs";
+//#region src/operations/onPageScroll.ts
+function isStaticPropertyName(key) {
+	if (key.type === "Identifier") return key.name;
+	if (key.type === "StringLiteral") return key.value;
+}
+function getMemberExpressionPropertyName(node) {
+	if (node.computed) return node.property.type === "StringLiteral" ? node.property.value : void 0;
+	return node.property.type === "Identifier" ? node.property.name : void 0;
+}
+function isOnPageScrollCallee(callee, hookNames, namespaceImports) {
+	if (callee.type === "Identifier") return hookNames.has(callee.name);
+	if (callee.type === "MemberExpression" || callee.type === "OptionalMemberExpression") {
+		const object = callee.object;
+		const propName = getMemberExpressionPropertyName(callee);
+		return object.type === "Identifier" && namespaceImports.has(object.name) && propName === "onPageScroll";
+	}
+	return false;
+}
+function getCallExpressionCalleeName(callee) {
+	if (callee.type === "Identifier") return callee.name;
+	if (callee.type === "MemberExpression" || callee.type === "OptionalMemberExpression") return getMemberExpressionPropertyName(callee);
+}
+function collectPageScrollInspection(functionPath, node) {
+	const inspection = {
+		empty: node.body.type === "BlockStatement" && node.body.body.length === 0,
+		hasSetDataCall: false,
+		syncApis: /* @__PURE__ */ new Set()
+	};
+	functionPath.traverse({
+		Function(innerPath) {
+			if (innerPath !== functionPath) innerPath.skip();
+		},
+		CallExpression(callPath) {
+			const callee = callPath.node.callee;
+			if (getCallExpressionCalleeName(callee) === "setData") inspection.hasSetDataCall = true;
+			if (callee.type === "MemberExpression" || callee.type === "OptionalMemberExpression") {
+				const object = callee.object;
+				if (object.type === "Identifier" && object.name === "wx") {
+					const propertyName = getMemberExpressionPropertyName(callee);
+					if (propertyName && propertyName.endsWith("Sync")) inspection.syncApis.add(`wx.${propertyName}`);
+				}
+			}
+		},
+		OptionalCallExpression(callPath) {
+			const callee = callPath.node.callee;
+			if (getCallExpressionCalleeName(callee) === "setData") inspection.hasSetDataCall = true;
+			if (callee.type === "MemberExpression" || callee.type === "OptionalMemberExpression") {
+				const object = callee.object;
+				if (object.type === "Identifier" && object.name === "wx") {
+					const propertyName = getMemberExpressionPropertyName(callee);
+					if (propertyName && propertyName.endsWith("Sync")) inspection.syncApis.add(`wx.${propertyName}`);
+				}
+			}
+		}
+	});
+	return inspection;
+}
+function createWarningPrefix(filename, line, column) {
+	return `[weapp-vite][onPageScroll] ${filename}:${typeof line === "number" && typeof column === "number" ? `${line}:${column}` : "?:?"}`;
+}
+function getOxcStaticPropertyName(node) {
+	if (!node) return;
+	if (node.type === "Identifier") return node.name;
+	if ((node.type === "StringLiteral" || node.type === "Literal") && typeof node.value === "string") return node.value;
+}
+function getOxcMemberExpressionPropertyName(node) {
+	if (!node || node.type !== "MemberExpression") return;
+	if (node.computed) return getOxcStaticPropertyName(node.property);
+	return node.property?.type === "Identifier" ? node.property.name : void 0;
+}
+function isOxcFunctionLike(node) {
+	return node?.type === "FunctionExpression" || node?.type === "ArrowFunctionExpression";
+}
+function isOxcOnPageScrollCallee(callee, hookNames, namespaceImports) {
+	if (!callee) return false;
+	if (callee.type === "Identifier") return hookNames.has(callee.name);
+	if (callee.type === "MemberExpression") {
+		const propName = getOxcMemberExpressionPropertyName(callee);
+		return callee.object?.type === "Identifier" && namespaceImports.has(callee.object.name) && propName === "onPageScroll";
+	}
+	return false;
+}
+function getOxcCallExpressionCalleeName(callee) {
+	if (!callee) return;
+	if (callee.type === "Identifier") return callee.name;
+	if (callee.type === "MemberExpression") return getOxcMemberExpressionPropertyName(callee);
+}
+function createLineStartOffsets(code) {
+	const offsets = [0];
+	for (let index = 0; index < code.length; index += 1) if (code.charCodeAt(index) === 10) offsets.push(index + 1);
+	return offsets;
+}
+function getLocationFromOffset(offset, lineStarts) {
+	if (typeof offset !== "number" || offset < 0) return;
+	let low = 0;
+	let high = lineStarts.length - 1;
+	while (low <= high) {
+		const mid = Math.floor((low + high) / 2);
+		if (lineStarts[mid] <= offset) low = mid + 1;
+		else high = mid - 1;
+	}
+	const lineIndex = Math.max(0, low - 1);
+	return {
+		line: lineIndex + 1,
+		column: offset - lineStarts[lineIndex] + 1
+	};
+}
+function collectPageScrollInspectionWithOxc(node) {
+	const inspection = {
+		empty: node.body?.type === "BlockStatement" && node.body.body.length === 0,
+		hasSetDataCall: false,
+		syncApis: /* @__PURE__ */ new Set()
+	};
+	const root = node.body?.type === "BlockStatement" ? node.body : node.body;
+	function visit(current, allowNestedFunctions = false) {
+		if (!current) return;
+		if (!allowNestedFunctions && (current.type === "FunctionExpression" || current.type === "ArrowFunctionExpression")) return;
+		if (current.type === "CallExpression") {
+			if (getOxcCallExpressionCalleeName(current.callee) === "setData") inspection.hasSetDataCall = true;
+			if (current.callee?.type === "MemberExpression" && current.callee.object?.type === "Identifier" && current.callee.object.name === "wx") {
+				const propertyName = getOxcMemberExpressionPropertyName(current.callee);
+				if (propertyName && propertyName.endsWith("Sync")) inspection.syncApis.add(`wx.${propertyName}`);
+			}
+		} else if (current.type === "ChainExpression") {
+			visit(current.expression, allowNestedFunctions);
+			return;
+		}
+		for (const value of Object.values(current)) {
+			if (!value) continue;
+			if (Array.isArray(value)) {
+				for (const child of value) if (child && typeof child === "object" && typeof child.type === "string") visit(child);
+			} else if (typeof value === "object" && typeof value.type === "string") visit(value);
+		}
+	}
+	if (root) visit(root, true);
+	return inspection;
+}
+function collectWithOxc(code, filename) {
+	const ast = parseJsLikeWithEngine(code, {
+		engine: "oxc",
+		filename: "inline.ts"
+	});
+	const onPageScrollHookNames = new Set(["onPageScroll"]);
+	const namespaceImports = /* @__PURE__ */ new Set();
+	for (const statement of ast.body ?? []) {
+		if (statement?.type !== "ImportDeclaration" || statement.source?.value !== "wevu") continue;
+		for (const specifier of statement.specifiers ?? []) if (specifier.type === "ImportSpecifier" && specifier.imported?.type === "Identifier" && specifier.imported.name === "onPageScroll" && specifier.local?.type === "Identifier") onPageScrollHookNames.add(specifier.local.name);
+		else if (specifier.type === "ImportNamespaceSpecifier" && specifier.local?.type === "Identifier") namespaceImports.add(specifier.local.name);
+	}
+	const lineStarts = createLineStartOffsets(code);
+	const warnings = [];
+	const warningSet = /* @__PURE__ */ new Set();
+	const addWarning = (warning) => {
+		if (warningSet.has(warning)) return;
+		warningSet.add(warning);
+		warnings.push(warning);
+	};
+	const reportInspection = (node, sourceLabel, startOffset = node.start) => {
+		const inspection = collectPageScrollInspectionWithOxc(node);
+		const loc = getLocationFromOffset(startOffset, lineStarts);
+		const prefix = createWarningPrefix(filename, loc?.line, loc?.column);
+		if (inspection.empty) addWarning(`${prefix} 检测到空的 ${sourceLabel} 回调，建议移除无效监听以降低滚动时调度开销。`);
+		if (inspection.hasSetDataCall) addWarning(`${prefix} 检测到 ${sourceLabel} 内调用 setData，建议改用节流、IntersectionObserver 或合并更新。`);
+		for (const syncApi of inspection.syncApis) addWarning(`${prefix} 检测到 ${sourceLabel} 内调用同步 API（${syncApi}），可能阻塞渲染线程。`);
+	};
+	function visit(node) {
+		if (!node) return;
+		if (node.type === "Property" && !node.computed && getOxcStaticPropertyName(node.key) === "onPageScroll" && isOxcFunctionLike(node.value)) {
+			const startOffset = node.method ? node.key?.end : node.value.start;
+			reportInspection(node.value, "onPageScroll", startOffset);
+		} else if (node.type === "CallExpression" && isOxcOnPageScrollCallee(node.callee, onPageScrollHookNames, namespaceImports)) {
+			const arg0 = node.arguments?.[0];
+			if (arg0 && arg0.type !== "SpreadElement" && isOxcFunctionLike(arg0)) reportInspection(arg0, "onPageScroll(...)");
+		} else if (node.type === "ChainExpression" && node.expression?.type === "CallExpression") {
+			const arg0 = node.expression.arguments?.[0];
+			if (isOxcOnPageScrollCallee(node.expression.callee, onPageScrollHookNames, namespaceImports) && arg0 && arg0.type !== "SpreadElement" && isOxcFunctionLike(arg0)) reportInspection(arg0, "onPageScroll(...)");
+		}
+		for (const value of Object.values(node)) {
+			if (!value) continue;
+			if (Array.isArray(value)) {
+				for (const child of value) if (child && typeof child === "object" && typeof child.type === "string") visit(child);
+			} else if (typeof value === "object" && typeof value.type === "string") visit(value);
+		}
+	}
+	visit(ast);
+	return warnings;
+}
+/**
+* 静态检测 onPageScroll 中的常见性能风险并返回告警文案。
+*/
+function collectOnPageScrollPerformanceWarnings(code, filename, options) {
+	if (options?.engine === "oxc") try {
+		return collectWithOxc(code, filename);
+	} catch {
+		return [];
+	}
+	let ast;
+	try {
+		ast = parseJsLike(code);
+	} catch {
+		return [];
+	}
+	const onPageScrollHookNames = new Set(["onPageScroll"]);
+	const namespaceImports = /* @__PURE__ */ new Set();
+	for (const statement of ast.program.body) {
+		if (statement.type !== "ImportDeclaration" || statement.source.value !== "wevu") continue;
+		for (const specifier of statement.specifiers) {
+			if (specifier.type === "ImportSpecifier" && specifier.imported.type === "Identifier" && specifier.imported.name === "onPageScroll") onPageScrollHookNames.add(specifier.local.name);
+			if (specifier.type === "ImportNamespaceSpecifier") namespaceImports.add(specifier.local.name);
+		}
+	}
+	const warnings = [];
+	const warningSet = /* @__PURE__ */ new Set();
+	const addWarning = (warning) => {
+		if (warningSet.has(warning)) return;
+		warningSet.add(warning);
+		warnings.push(warning);
+	};
+	const reportInspection = (functionPath, node, sourceLabel) => {
+		const inspection = collectPageScrollInspection(functionPath, node);
+		const line = node.loc?.start.line;
+		const prefix = createWarningPrefix(filename, line, typeof node.loc?.start.column === "number" ? node.loc.start.column + 1 : void 0);
+		if (inspection.empty) addWarning(`${prefix} 检测到空的 ${sourceLabel} 回调，建议移除无效监听以降低滚动时调度开销。`);
+		if (inspection.hasSetDataCall) addWarning(`${prefix} 检测到 ${sourceLabel} 内调用 setData，建议改用节流、IntersectionObserver 或合并更新。`);
+		for (const syncApi of inspection.syncApis) addWarning(`${prefix} 检测到 ${sourceLabel} 内调用同步 API（${syncApi}），可能阻塞渲染线程。`);
+	};
+	traverse(ast, {
+		ObjectMethod(path) {
+			if (isStaticPropertyName(path.node.key) !== "onPageScroll") return;
+			reportInspection(path, path.node, "onPageScroll");
+		},
+		ObjectProperty(path) {
+			if (path.node.computed) return;
+			if (isStaticPropertyName(path.node.key) !== "onPageScroll") return;
+			const value = path.node.value;
+			if (value.type !== "FunctionExpression" && value.type !== "ArrowFunctionExpression") return;
+			reportInspection(path.get("value"), value, "onPageScroll");
+		},
+		CallExpression(path) {
+			if (!isOnPageScrollCallee(path.node.callee, onPageScrollHookNames, namespaceImports)) return;
+			const arg0 = path.node.arguments[0];
+			if (!arg0 || arg0.type === "SpreadElement") return;
+			if (arg0.type !== "FunctionExpression" && arg0.type !== "ArrowFunctionExpression") return;
+			reportInspection(path.get("arguments.0"), arg0, "onPageScroll(...)");
+		},
+		OptionalCallExpression(path) {
+			if (!isOnPageScrollCallee(path.node.callee, onPageScrollHookNames, namespaceImports)) return;
+			const arg0 = path.node.arguments[0];
+			if (!arg0 || arg0.type === "SpreadElement") return;
+			if (arg0.type !== "FunctionExpression" && arg0.type !== "ArrowFunctionExpression") return;
+			reportInspection(path.get("arguments.0"), arg0, "onPageScroll(...)");
+		}
+	});
+	return warnings;
+}
+//#endregion
+export { collectOnPageScrollPerformanceWarnings };

package/dist/operations/setDataPick.d.mts

@@ -0,0 +1,13 @@
+import { AstEngineName } from "../types.mjs";
+
+//#region src/operations/setDataPick.d.ts
+/**
+ * 从编译后的 WXML 模板提取渲染相关的顶层 key。
+ *
+ * 根据 AST 引擎从编译后的 WXML 模板提取渲染相关的顶层 key。
+ */
+declare function collectSetDataPickKeysFromTemplateCode(template: string, options?: {
+  astEngine?: AstEngineName;
+}): string[];
+//#endregion
+export { collectSetDataPickKeysFromTemplateCode };

package/dist/operations/setDataPick.mjs

@@ -0,0 +1,287 @@
+import { BABEL_TS_MODULE_PARSER_OPTIONS, parse, traverse } from "../babel.mjs";
+import { t as parseJsLikeWithEngine } from "../engine-DHqNPCDA.mjs";
+//#region src/operations/setDataPick.ts
+const TEMPLATE_MUSTACHE_RE = /\{\{([\s\S]*?)\}\}/g;
+const WX_FOR_TAG_RE = /<[^>]*\bwx:for\s*=\s*(?:"[^"]*"|'[^']*')[^>]*>/g;
+const WX_FOR_ITEM_RE = /\bwx:for-item\s*=\s*(?:"([^"]+)"|'([^']+)')/;
+const WX_FOR_INDEX_RE = /\bwx:for-index\s*=\s*(?:"([^"]+)"|'([^']+)')/;
+const JS_GLOBAL_IDENTIFIERS = new Set([
+	"undefined",
+	"NaN",
+	"Infinity",
+	"globalThis",
+	"Math",
+	"Number",
+	"String",
+	"Boolean",
+	"Object",
+	"Array",
+	"Date",
+	"JSON",
+	"RegExp",
+	"Map",
+	"Set",
+	"WeakMap",
+	"WeakSet",
+	"parseInt",
+	"parseFloat",
+	"isNaN",
+	"isFinite",
+	"decodeURI",
+	"decodeURIComponent",
+	"encodeURI",
+	"encodeURIComponent"
+]);
+function collectLoopScopeAliases(template) {
+	const aliases = /* @__PURE__ */ new Set();
+	const tagMatches = template.match(WX_FOR_TAG_RE) ?? [];
+	for (const tag of tagMatches) {
+		const itemMatch = tag.match(WX_FOR_ITEM_RE);
+		if (itemMatch) {
+			const itemAlias = (itemMatch[1] ?? itemMatch[2] ?? "").trim();
+			if (itemAlias) aliases.add(itemAlias);
+		} else aliases.add("item");
+		const indexMatch = tag.match(WX_FOR_INDEX_RE);
+		if (indexMatch) {
+			const indexAlias = (indexMatch[1] ?? indexMatch[2] ?? "").trim();
+			if (indexAlias) aliases.add(indexAlias);
+		} else aliases.add("index");
+	}
+	return aliases;
+}
+function extractTemplateExpressions(template) {
+	const expressions = [];
+	let match = TEMPLATE_MUSTACHE_RE.exec(template);
+	while (match) {
+		const expression = (match[1] ?? "").trim();
+		if (expression) expressions.push(expression);
+		match = TEMPLATE_MUSTACHE_RE.exec(template);
+	}
+	TEMPLATE_MUSTACHE_RE.lastIndex = 0;
+	return expressions;
+}
+function collectIdentifiersFromExpression(expression) {
+	const collected = /* @__PURE__ */ new Set();
+	let ast;
+	try {
+		ast = parse(`const __weappViteExpr = (${expression});`, {
+			...BABEL_TS_MODULE_PARSER_OPTIONS,
+			sourceType: "module"
+		});
+	} catch {
+		return collected;
+	}
+	traverse(ast, {
+		Identifier(path) {
+			if (!path.isReferencedIdentifier()) return;
+			const name = path.node.name;
+			if (name === "__weappViteExpr") return;
+			if (path.scope.hasBinding(name, true)) return;
+			if (JS_GLOBAL_IDENTIFIERS.has(name)) return;
+			collected.add(name);
+		},
+		MemberExpression(path) {
+			const member = path.node;
+			if (member.computed || member.object.type !== "ThisExpression" || member.property.type !== "Identifier") return;
+			collected.add(member.property.name);
+		},
+		OptionalMemberExpression(path) {
+			const member = path.node;
+			if (member.computed || member.object.type !== "ThisExpression" || member.property.type !== "Identifier") return;
+			collected.add(member.property.name);
+		}
+	});
+	return collected;
+}
+function collectPatternBindingNames(node, bindings) {
+	if (!node) return;
+	if (node.type === "Identifier") {
+		bindings.add(node.name);
+		return;
+	}
+	if (node.type === "RestElement") {
+		collectPatternBindingNames(node.argument, bindings);
+		return;
+	}
+	if (node.type === "AssignmentPattern") {
+		collectPatternBindingNames(node.left, bindings);
+		return;
+	}
+	if (node.type === "ArrayPattern") {
+		for (const element of node.elements ?? []) collectPatternBindingNames(element, bindings);
+		return;
+	}
+	if (node.type === "ObjectPattern") for (const property of node.properties ?? []) if (property?.type === "RestElement") collectPatternBindingNames(property.argument, bindings);
+	else collectPatternBindingNames(property?.value, bindings);
+}
+function collectIdentifiersFromExpressionWithOxc(expression) {
+	const collected = /* @__PURE__ */ new Set();
+	let ast;
+	try {
+		ast = parseJsLikeWithEngine(`const __weappViteExpr = (${expression});`, {
+			engine: "oxc",
+			filename: "inline.ts"
+		});
+	} catch {
+		return collected;
+	}
+	const scopes = [/* @__PURE__ */ new Set()];
+	function hasBinding(name) {
+		return scopes.some((scope) => scope.has(name));
+	}
+	function visit(node) {
+		if (!node) return;
+		if (node.type === "ReturnStatement") {
+			visit(node.argument);
+			return;
+		}
+		if (node.type === "IfStatement") {
+			visit(node.test);
+			visit(node.consequent);
+			visit(node.alternate);
+			return;
+		}
+		switch (node.type) {
+			case "Program":
+				for (const statement of node.body ?? []) visit(statement);
+				return;
+			case "ExpressionStatement":
+				visit(node.expression);
+				return;
+			case "ParenthesizedExpression":
+			case "TSAsExpression":
+			case "TSSatisfiesExpression":
+			case "TSNonNullExpression":
+				visit(node.expression);
+				return;
+			case "VariableDeclaration":
+				for (const declaration of node.declarations ?? []) visit(declaration);
+				return;
+			case "VariableDeclarator": {
+				const bindings = /* @__PURE__ */ new Set();
+				collectPatternBindingNames(node.id, bindings);
+				const currentScope = scopes.at(-1);
+				for (const binding of bindings) currentScope?.add(binding);
+				visit(node.init);
+				return;
+			}
+			case "Identifier":
+				if (node.name !== "__weappViteExpr" && !hasBinding(node.name) && !JS_GLOBAL_IDENTIFIERS.has(node.name)) collected.add(node.name);
+				return;
+			case "ChainExpression":
+				visit(node.expression);
+				return;
+			case "MemberExpression":
+				if (node.object?.type === "ThisExpression" && !node.computed && node.property?.type === "Identifier") {
+					collected.add(node.property.name);
+					return;
+				}
+				visit(node.object);
+				if (node.computed) visit(node.property);
+				return;
+			case "CallExpression":
+			case "NewExpression":
+				visit(node.callee);
+				for (const argument of node.arguments ?? []) if (argument?.type === "SpreadElement") visit(argument.argument);
+				else visit(argument);
+				return;
+			case "ArrayExpression":
+				for (const element of node.elements ?? []) if (element?.type === "SpreadElement") visit(element.argument);
+				else visit(element);
+				return;
+			case "ObjectExpression":
+				for (const property of node.properties ?? []) visit(property);
+				return;
+			case "ObjectProperty":
+			case "Property":
+				if (node.computed) visit(node.key);
+				visit(node.value);
+				return;
+			case "SpreadProperty":
+			case "SpreadElement":
+				visit(node.argument);
+				return;
+			case "TemplateLiteral":
+				for (const expressionNode of node.expressions ?? []) visit(expressionNode);
+				return;
+			case "TaggedTemplateExpression":
+				visit(node.tag);
+				visit(node.quasi);
+				return;
+			case "UnaryExpression":
+			case "UpdateExpression":
+			case "AwaitExpression":
+				visit(node.argument);
+				return;
+			case "BinaryExpression":
+			case "LogicalExpression":
+			case "AssignmentExpression":
+				visit(node.left);
+				visit(node.right);
+				return;
+			case "ConditionalExpression":
+				visit(node.test);
+				visit(node.consequent);
+				visit(node.alternate);
+				return;
+			case "SequenceExpression":
+				for (const expressionNode of node.expressions ?? []) visit(expressionNode);
+				return;
+			case "ArrowFunctionExpression":
+			case "FunctionExpression": {
+				const nextScope = /* @__PURE__ */ new Set();
+				if (node.type === "FunctionExpression" && node.id?.type === "Identifier") nextScope.add(node.id.name);
+				for (const parameter of node.params ?? []) collectPatternBindingNames(parameter, nextScope);
+				scopes.unshift(nextScope);
+				visit(node.body);
+				scopes.shift();
+				return;
+			}
+			case "BlockStatement":
+				scopes.unshift(/* @__PURE__ */ new Set());
+				for (const statement of node.body ?? []) visit(statement);
+				scopes.shift();
+				break;
+			default: break;
+		}
+	}
+	visit(ast);
+	return collected;
+}
+function collectWithBabel(template) {
+	const templateExpressions = extractTemplateExpressions(template);
+	if (!templateExpressions.length) return [];
+	const loopAliases = collectLoopScopeAliases(template);
+	const keys = /* @__PURE__ */ new Set();
+	for (const expression of templateExpressions) {
+		const identifiers = collectIdentifiersFromExpression(expression);
+		for (const identifier of identifiers) if (!loopAliases.has(identifier)) keys.add(identifier);
+	}
+	return [...keys].sort((a, b) => a.localeCompare(b));
+}
+function collectWithOxc(template) {
+	const templateExpressions = extractTemplateExpressions(template);
+	if (!templateExpressions.length) return [];
+	const loopAliases = collectLoopScopeAliases(template);
+	const keys = /* @__PURE__ */ new Set();
+	for (const expression of templateExpressions) {
+		const identifiers = collectIdentifiersFromExpressionWithOxc(expression);
+		for (const identifier of identifiers) if (!loopAliases.has(identifier)) keys.add(identifier);
+	}
+	return [...keys].sort((a, b) => a.localeCompare(b));
+}
+/**
+* 从编译后的 WXML 模板提取渲染相关的顶层 key。
+*
+* 根据 AST 引擎从编译后的 WXML 模板提取渲染相关的顶层 key。
+*/
+function collectSetDataPickKeysFromTemplateCode(template, options) {
+	const engine = options?.astEngine ?? "babel";
+	try {
+		return engine === "oxc" ? collectWithOxc(template) : collectWithBabel(template);
+	} catch {
+		return [];
+	}
+}
+//#endregion
+export { collectSetDataPickKeysFromTemplateCode };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/ast",
   "type": "module",
-  "version": "6.8.0",
+  "version": "6.9.0",
   "description": "weapp-vite 共享 AST 分析工具包，统一 Babel/Oxc 解析与常用分析操作",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -32,6 +32,18 @@
       "types": "./dist/babel.d.mts",
       "import": "./dist/babel.mjs"
     },
+    "./babelCore": {
+      "types": "./dist/babelCore.d.mts",
+      "import": "./dist/babelCore.mjs"
+    },
+    "./babelTraverse": {
+      "types": "./dist/babelTraverse.d.mts",
+      "import": "./dist/babelTraverse.mjs"
+    },
+    "./babelTypes": {
+      "types": "./dist/babelTypes.d.mts",
+      "import": "./dist/babelTypes.mjs"
+    },
     "./babelNodes": {
       "types": "./dist/babelNodes.d.mts",
       "import": "./dist/babelNodes.mjs"
@@ -44,10 +56,15 @@
       "types": "./dist/types.d.mts",
       "import": "./dist/types.mjs"
     },
+    "./package.json": "./package.json",
     "./operations/platformApi": {
       "types": "./dist/operations/platformApi.d.mts",
       "import": "./dist/operations/platformApi.mjs"
     },
+    "./operations/onPageScroll": {
+      "types": "./dist/operations/onPageScroll.d.mts",
+      "import": "./dist/operations/onPageScroll.mjs"
+    },
     "./operations/componentProps": {
       "types": "./dist/operations/componentProps.d.mts",
       "import": "./dist/operations/componentProps.mjs"
@@ -67,21 +84,30 @@
     "./operations/scriptSetupImports": {
       "types": "./dist/operations/scriptSetupImports.d.mts",
       "import": "./dist/operations/scriptSetupImports.mjs"
+    },
+    "./operations/setDataPick": {
+      "types": "./dist/operations/setDataPick.d.mts",
+      "import": "./dist/operations/setDataPick.mjs"
     }
   },
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "files": [
+    "README.md",
     "dist"
   ],
+  "engines": {
+    "node": ">=20"
+  },
   "dependencies": {
+    "@babel/core": "^7.29.0",
     "@babel/generator": "^7.29.1",
     "@babel/parser": "^7.29.0",
     "@babel/traverse": "^7.29.0",
     "@babel/types": "^7.29.0",
-    "@oxc-project/types": "^0.119.0",
-    "oxc-parser": "^0.119.0",
+    "@oxc-project/types": "^0.120.0",
+    "oxc-parser": "^0.120.0",
     "oxc-walker": "^0.7.0"
   },
   "publishConfig": {
@@ -91,9 +117,10 @@
   "scripts": {
     "dev": "tsdown -w",
     "build": "tsdown",
-    "test": "vitest run",
-    "test:dev": "vitest",
-    "typecheck": "tsc --noEmit",
+    "check:release": "pnpm build && pnpm typecheck && pnpm test && npm pack --dry-run . --cache ../../.cache/npm",
+    "test": "vitest run --config ./vitest.config.ts",
+    "test:dev": "vitest --config ./vitest.config.ts",
+    "typecheck": "tsc --noEmit -p ./tsconfig.json",
     "release": "pnpm publish",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix"