@wevu/compiler 6.16.19 → 6.16.21

package/dist/index.d.mts

@@ -276,6 +276,11 @@ interface ForParseResult {
  */
 interface TemplateCompileOptions {
   platform?: MiniProgramPlatform;
+  /**
+   * Vue `<script setup>` props 解构重命名映射，key 为模板中使用的本地别名，value 为原始 prop 名。
+   */
+  propsAliases?: Record<string, string>;
+  propsDerivedKeys?: string[];
   htmlTagToWxml?: boolean | Record<string, string>;
   htmlTagToWxmlTagClass?: boolean;
   scopedSlotsCompiler?: ScopedSlotsCompilerMode;
@@ -705,6 +710,14 @@ interface TransformScriptOptions {
    * 模板中作为组件 prop 传递的函数候选路径。
    */
   functionPropPaths?: string[];
+  /**
+   * Vue `<script setup>` props 解构重命名映射，key 为模板中使用的本地别名，value 为原始 prop 名。
+   */
+  propsAliases?: Record<string, string>;
+  /**
+   * Vue `<script setup>` 中直接来自 props 的绑定名，用于运行时区分 props-derived binding 与普通 setup state。
+   */
+  propsDerivedKeys?: string[];
   /**
    * 对 `<script setup>` 类型声明生成的结构化 props（如 Array/Object）放宽小程序运行时类型约束，
    * 以避免小程序属性校验对复杂表达式/代理值产生误报。

package/dist/index.mjs

@@ -13,7 +13,7 @@ import os from "node:os";
 import process from "node:process";
 import { collectFeatureFlagsFromCode, collectJsxImportedComponentsAndDefaultExportFromBabelAst, collectJsxTemplateTagsFromBabelExpression, getRenderPropertyFromComponentOptions, parseJsLikeWithEngine, resolveRenderExpressionFromComponentOptions, toStaticObjectKey, unwrapTypeScriptExpression } from "@weapp-vite/ast";
 import { LRUCache } from "lru-cache";
-import { WEVU_CLASS_STYLE_RUNTIME_FILE, WEVU_CLASS_STYLE_RUNTIME_MODULE, WEVU_EXPRESSION_ERROR_IDENTIFIER, WEVU_FUNCTION_PROP_PATHS_KEY, WEVU_INLINE_HANDLER, WEVU_INLINE_MAP_KEY, WEVU_IS_PAGE_KEY, WEVU_LAYOUT_HOSTS_KEY, WEVU_LAYOUT_HOST_ID_PREFIX, WEVU_LAYOUT_HOST_REF_PREFIX, WEVU_MODEL_HANDLER, WEVU_OWNER_HANDLER, WEVU_PROPS_KEY, WEVU_SLOT_NAMES_ATTR, WEVU_SLOT_NAMES_PROP, WEVU_SLOT_OWNER_ID_ATTR, WEVU_SLOT_OWNER_ID_KEY, WEVU_SLOT_OWNER_ID_PROP, WEVU_SLOT_OWNER_KEY, WEVU_SLOT_OWNER_PROXY_KEY, WEVU_SLOT_PROPS_ATTR, WEVU_SLOT_PROPS_DATA_KEY, WEVU_SLOT_PROPS_KEY, WEVU_SLOT_SCOPE_ATTR, WEVU_SLOT_SCOPE_KEY, WEVU_TEMPLATE_REFS_KEY } from "@weapp-core/constants";
+import { WEVU_CLASS_STYLE_RUNTIME_FILE, WEVU_CLASS_STYLE_RUNTIME_MODULE, WEVU_EXPRESSION_ERROR_IDENTIFIER, WEVU_FUNCTION_PROP_PATHS_KEY, WEVU_INLINE_HANDLER, WEVU_INLINE_MAP_KEY, WEVU_IS_PAGE_KEY, WEVU_LAYOUT_HOSTS_KEY, WEVU_LAYOUT_HOST_ID_PREFIX, WEVU_LAYOUT_HOST_REF_PREFIX, WEVU_MODEL_HANDLER, WEVU_OWNER_HANDLER, WEVU_PROPS_ALIASES_KEY, WEVU_PROPS_DERIVED_KEYS_KEY, WEVU_PROPS_KEY, WEVU_SLOT_NAMES_ATTR, WEVU_SLOT_NAMES_PROP, WEVU_SLOT_OWNER_ID_ATTR, WEVU_SLOT_OWNER_ID_KEY, WEVU_SLOT_OWNER_ID_PROP, WEVU_SLOT_OWNER_KEY, WEVU_SLOT_OWNER_PROXY_KEY, WEVU_SLOT_PROPS_ATTR, WEVU_SLOT_PROPS_DATA_KEY, WEVU_SLOT_PROPS_KEY, WEVU_SLOT_SCOPE_ATTR, WEVU_SLOT_SCOPE_KEY, WEVU_TEMPLATE_REFS_KEY } from "@weapp-core/constants";
 import { compileScript, parse } from "vue/compiler-sfc";
 import { fileURLToPath } from "node:url";
 import { parse as parse$1 } from "@vue/compiler-dom";
@@ -2241,6 +2241,41 @@ function buildConsoleErrorGuard(message, errorId) {
 function buildRuntimeExpressionErrorGuard(binding, errorId) {
 	return buildConsoleErrorGuard(`[wevu] 模板运行时表达式执行失败: ${binding.name} = ${binding.exp}`, errorId);
 }
+function shouldReportRuntimeExpressionError(binding) {
+	return binding.type === "bind";
+}
+function createDataPropsFallbackExpression(fallback) {
+	const propsObject = t.memberExpression(t.thisExpression(), t.identifier(WEVU_PROPS_KEY));
+	const propsAccess = t.memberExpression(propsObject, t.identifier("data"));
+	const hasPropsObject = t.binaryExpression("!=", propsObject, t.nullLiteral());
+	const hasPropsValue = t.logicalExpression("&&", hasPropsObject, t.logicalExpression("||", t.binaryExpression("!==", propsAccess, t.identifier("undefined")), t.callExpression(t.memberExpression(t.memberExpression(t.memberExpression(t.identifier("Object"), t.identifier("prototype")), t.identifier("hasOwnProperty")), t.identifier("call")), [propsObject, t.stringLiteral("data")])));
+	return t.conditionalExpression(hasPropsValue, propsAccess, fallback);
+}
+function createDataRuntimeAccess(helpers) {
+	const unrefHelper = helpers.unref ? t.cloneNode(helpers.unref) : t.identifier("unref");
+	return t.callExpression(unrefHelper, [createDataPropsFallbackExpression(t.memberExpression(t.thisExpression(), t.identifier("data")))]);
+}
+function rewriteDataAccessExpression(exp, helpers) {
+	if (t.isIdentifier(exp) && exp.name === "data") return createDataRuntimeAccess(helpers);
+	if (t.isMemberExpression(exp)) return t.memberExpression(rewriteDataAccessExpression(exp.object, helpers), t.cloneNode(exp.property), exp.computed);
+	if (t.isObjectExpression(exp)) return t.objectExpression(exp.properties.map((property) => {
+		if (!t.isObjectProperty(property) || !t.isExpression(property.value)) return t.cloneNode(property, true);
+		return t.objectProperty(t.cloneNode(property.key), rewriteDataAccessExpression(property.value, helpers), property.computed, property.shorthand);
+	}));
+	if (t.isArrayExpression(exp)) return t.arrayExpression(exp.elements.map((element) => {
+		if (!element || t.isSpreadElement(element)) return element ? t.cloneNode(element, true) : null;
+		return rewriteDataAccessExpression(element, helpers);
+	}));
+	if (t.isBinaryExpression(exp)) return t.isPrivateName(exp.left) || t.isPrivateName(exp.right) ? t.cloneNode(exp, true) : t.binaryExpression(exp.operator, rewriteDataAccessExpression(exp.left, helpers), rewriteDataAccessExpression(exp.right, helpers));
+	if (t.isLogicalExpression(exp)) return t.logicalExpression(exp.operator, rewriteDataAccessExpression(exp.left, helpers), rewriteDataAccessExpression(exp.right, helpers));
+	if (t.isConditionalExpression(exp)) return t.conditionalExpression(rewriteDataAccessExpression(exp.test, helpers), rewriteDataAccessExpression(exp.consequent, helpers), rewriteDataAccessExpression(exp.alternate, helpers));
+	if (t.isUnaryExpression(exp)) return t.unaryExpression(exp.operator, rewriteDataAccessExpression(exp.argument, helpers), exp.prefix);
+	if (t.isCallExpression(exp)) return t.callExpression(rewriteDataAccessExpression(exp.callee, helpers), exp.arguments.map((arg) => {
+		if (t.isSpreadElement(arg)) return t.cloneNode(arg, true);
+		return rewriteDataAccessExpression(arg, helpers);
+	}));
+	return t.cloneNode(exp, true);
+}
 function buildNormalizedExpression(binding, helpers) {
 	const errorId = t.identifier(WEVU_EXPRESSION_ERROR_IDENTIFIER);
 	if (binding.type === "bind") {
@@ -2249,9 +2284,9 @@ function buildNormalizedExpression(binding, helpers) {
 	}
 	const normalizeHelper = binding.type === "class" ? helpers.normalizeClass : helpers.normalizeStyle;
 	const errorFallback = binding.errorFallback ?? "";
-	const exp = binding.expAst ? t.cloneNode(binding.expAst, true) : t.stringLiteral("");
+	const exp = binding.expAst ? rewriteDataAccessExpression(binding.expAst, helpers) : t.stringLiteral("");
 	const normalizedCall = t.callExpression(t.cloneNode(normalizeHelper), [exp]);
-	return t.callExpression(t.arrowFunctionExpression([], t.blockStatement([t.tryStatement(t.blockStatement([t.returnStatement(normalizedCall)]), t.catchClause(t.cloneNode(errorId), t.blockStatement([buildRuntimeExpressionErrorGuard(binding, errorId), t.returnStatement(t.stringLiteral(errorFallback))])), null)])), []);
+	return t.callExpression(t.arrowFunctionExpression([], t.blockStatement([t.tryStatement(t.blockStatement([t.returnStatement(normalizedCall)]), t.catchClause(t.cloneNode(errorId), t.blockStatement([...shouldReportRuntimeExpressionError(binding) ? [buildRuntimeExpressionErrorGuard(binding, errorId)] : [], t.returnStatement(t.stringLiteral(errorFallback))])), null)])), []);
 }
 function buildArrayMapExpression(binding, forStack, level, listId, helpers) {
 	const itemParam = createValidIdentifier(forStack[level].item, `__wv_item_${level}`);
@@ -2318,11 +2353,37 @@ function buildComputedFunctionBody(binding, helpers) {
 }
 //#endregion
 //#region src/plugins/vue/transform/classStyleComputed.ts
-function buildClassStyleComputedEntries(bindings, helpers) {
+function createMemberAccess$2(target, prop) {
+	if (t.isValidIdentifier(prop)) return t.memberExpression(target, t.identifier(prop));
+	return t.memberExpression(target, t.stringLiteral(prop), true);
+}
+function applyPropsAliasesToExpression(expression, propsAliases) {
+	if (!propsAliases || !Object.keys(propsAliases).length) return expression;
+	const ast = t.file(t.program([t.expressionStatement(expression)]));
+	traverse(ast, { Identifier(path) {
+		if (!path.isReferencedIdentifier()) return;
+		const propName = propsAliases[path.node.name];
+		if (!propName || path.scope.hasBinding(path.node.name)) return;
+		const replacement = createMemberAccess$2(t.memberExpression(t.thisExpression(), t.identifier("__wevuProps")), propName);
+		const parent = path.parentPath;
+		if (parent.isObjectProperty() && parent.node.shorthand && parent.node.key === path.node) {
+			parent.node.shorthand = false;
+			parent.node.value = replacement;
+			return;
+		}
+		path.replaceWith(replacement);
+	} });
+	const statement = ast.program.body[0];
+	return t.isExpressionStatement(statement) ? statement.expression : expression;
+}
+function buildClassStyleComputedEntries(bindings, helpers, propsAliases) {
 	const entries = [];
 	for (const binding of bindings) {
 		const key = createStaticObjectKey(binding.name);
-		const body = buildComputedFunctionBody(binding, helpers);
+		const body = buildComputedFunctionBody({
+			...binding,
+			expAst: binding.expAst ? applyPropsAliasesToExpression(t.cloneNode(binding.expAst, true), propsAliases) : binding.expAst
+		}, helpers);
 		const fn = t.functionExpression(null, [], body);
 		entries.push(t.objectProperty(key, fn));
 	}
@@ -2347,14 +2408,15 @@ function buildClassStyleComputedCode(bindings, helpers) {
 }
 //#endregion
 //#region src/plugins/vue/transform/transformScript/rewrite/classStyle.ts
-function injectClassStyleComputed(optionsObject, bindings, warn) {
+function injectClassStyleComputed(optionsObject, bindings, propsAliases, warn) {
 	if (!bindings.length) return false;
 	const warnHandler = resolveWarnHandler(warn);
 	const entries = buildClassStyleComputedEntries(bindings, {
 		normalizeClass: t.identifier("__wevuNormalizeClass"),
 		normalizeStyle: t.identifier("__wevuNormalizeStyle"),
-		unref: t.identifier("__wevuUnref")
-	});
+		unref: t.identifier("__wevuUnref"),
+		resolvePropValue: t.identifier("__wevuResolvePropValue")
+	}, propsAliases);
 	if (!entries.length) return false;
 	const computedProp = getObjectPropertyByKey$1(optionsObject, "computed");
 	if (!computedProp) {
@@ -2376,6 +2438,7 @@ function ensureClassStyleRuntimeImports(program) {
 	ensureRuntimeImport(program, "normalizeClass", "__wevuNormalizeClass");
 	ensureRuntimeImport(program, "normalizeStyle", "__wevuNormalizeStyle");
 	ensureRuntimeImport(program, "unref", "__wevuUnref");
+	ensureRuntimeImport(program, "resolvePropValue", "__wevuResolvePropValue");
 }
 //#endregion
 //#region src/plugins/vue/transform/transformScript/rewrite/defaults.ts
@@ -2675,6 +2738,24 @@ function injectLayoutHosts(optionsObject, bindings, warn) {
 	return false;
 }
 //#endregion
+//#region src/plugins/vue/transform/transformScript/rewrite/propsAliases.ts
+function injectPropsAliases(optionsObject, propsAliases) {
+	const entries = Object.entries(propsAliases ?? {}).filter(([alias, propName]) => alias && propName).map(([alias, propName]) => {
+		return t.objectProperty(createStaticObjectKey$1(alias), t.stringLiteral(propName));
+	});
+	if (!entries.length) return false;
+	if (getObjectPropertyByKey$1(optionsObject, WEVU_PROPS_ALIASES_KEY)) return false;
+	optionsObject.properties.push(t.objectProperty(createStaticObjectKey$1(WEVU_PROPS_ALIASES_KEY), t.objectExpression(entries)));
+	return true;
+}
+function injectPropsDerivedKeys(optionsObject, propsDerivedKeys) {
+	const keys = [...new Set(propsDerivedKeys ?? [])].filter(Boolean);
+	if (!keys.length) return false;
+	if (getObjectPropertyByKey$1(optionsObject, WEVU_PROPS_DERIVED_KEYS_KEY)) return false;
+	optionsObject.properties.push(t.objectProperty(createStaticObjectKey$1(WEVU_PROPS_DERIVED_KEYS_KEY), t.arrayExpression(keys.map((key) => t.stringLiteral(key)))));
+	return true;
+}
+//#endregion
 //#region src/plugins/vue/transform/transformScript/rewrite/setupInitialData.ts
 function unwrapExpression(node) {
 	if (t.isTSAsExpression(node) || t.isTSSatisfiesExpression(node) || t.isTSNonNullExpression(node) || t.isTypeCastExpression(node) || t.isParenthesizedExpression(node)) return unwrapExpression(node.expression);
@@ -2936,10 +3017,14 @@ function rewriteDefaultExport(ast, state, options, enabledPageFeatures, serializ
 	}) || transformed;
 	if (componentOptionsObject) transformed = injectSetupInitialData(componentOptionsObject) || transformed;
 	if (componentOptionsObject && options?.relaxStructuredTypeOnlyProps) transformed = relaxStructuredTypeOnlyProps(componentOptionsObject) || transformed;
+	if (componentOptionsObject) {
+		transformed = injectPropsAliases(componentOptionsObject, options?.propsAliases) || transformed;
+		transformed = injectPropsDerivedKeys(componentOptionsObject, options?.propsDerivedKeys) || transformed;
+	}
 	const classStyleBindings = options?.classStyleBindings ?? [];
 	if (classStyleBindings.length) if (componentOptionsObject) {
 		ensureClassStyleRuntimeImports(ast.program);
-		transformed = injectClassStyleComputed(componentOptionsObject, classStyleBindings, warn) || transformed;
+		transformed = injectClassStyleComputed(componentOptionsObject, classStyleBindings, options?.propsAliases, warn) || transformed;
 	} else warn("无法自动注入 class/style 计算属性：组件选项不是对象字面量。");
 	const templateRefs = options?.templateRefs ?? [];
 	if (templateRefs.length) if (componentOptionsObject) transformed = injectTemplateRefs(componentOptionsObject, templateRefs, warn) || transformed;
@@ -5363,10 +5448,10 @@ function rewriteForAliasExpression(exp, context) {
 		if (!path.isReferencedIdentifier()) return;
 		const name = path.node.name;
 		if (path.scope.hasBinding(name)) return;
-		if (!hasOwn(forAliases, name)) return;
-		const aliasExp = parseBabelExpression(forAliases[name]);
-		if (!aliasExp) return;
-		replaceIdentifierWithExpression(path, t.cloneNode(aliasExp, true));
+		if (hasOwn(forAliases, name)) {
+			const aliasExp = parseBabelExpression(forAliases[name]);
+			if (aliasExp) replaceIdentifierWithExpression(path, t.cloneNode(aliasExp, true));
+		}
 	} });
 	const stmt = ast.program.body[0];
 	const updatedExpression = stmt && "expression" in stmt ? stmt.expression : null;
@@ -5683,6 +5768,7 @@ const JS_RUNTIME_GLOBALS = new Set([
 	"arguments",
 	"globalThis",
 	"__wevuUnref",
+	"__wevuResolvePropValue",
 	"getApp",
 	"getCurrentPages",
 	...getMiniProgramRuntimeGlobalKeys()
@@ -5714,11 +5800,35 @@ function createUnrefCall(exp) {
 function createHasOwnPropertyCall(target, key) {
 	return t.callExpression(t.memberExpression(t.memberExpression(t.memberExpression(t.identifier("Object"), t.identifier("prototype")), t.identifier("hasOwnProperty")), t.identifier("call")), [target, t.stringLiteral(key)]);
 }
-function createIdentifierAccessWithPropsFallback(name) {
+function createResolvePropValueCall(name, fallback, preferProps = false) {
+	const args = [
+		t.thisExpression(),
+		t.stringLiteral(name),
+		fallback
+	];
+	if (preferProps) args.push(t.booleanLiteral(true));
+	return t.callExpression(t.identifier("__wevuResolvePropValue"), args);
+}
+function createPropsKeyAccessFallback(name, fallback) {
+	const propsObject = createThisMemberAccess(WEVU_PROPS_KEY);
+	const propsAccess = createMemberAccess(propsObject, name);
+	const hasPropsObject = t.binaryExpression("!=", propsObject, t.nullLiteral());
+	const hasPropsValue = t.logicalExpression("&&", hasPropsObject, t.logicalExpression("||", t.binaryExpression("!==", propsAccess, t.identifier("undefined")), createHasOwnPropertyCall(propsObject, name)));
+	return t.conditionalExpression(hasPropsValue, propsAccess, fallback);
+}
+function createIdentifierAccessWithPropsFallback(name, context, useRuntimePropHelper = false) {
+	if (useRuntimePropHelper) {
+		if (name === "props") {
+			const propsObject = createThisMemberAccess(WEVU_PROPS_KEY);
+			return t.conditionalExpression(t.binaryExpression("!=", propsObject, t.nullLiteral()), propsObject, createThisMemberAccess("props"));
+		}
+		return createResolvePropValueCall(name, createThisMemberAccess(name));
+	}
 	if (name === "props") {
 		const propsObject = createThisMemberAccess(WEVU_PROPS_KEY);
 		return t.conditionalExpression(t.binaryExpression("!=", propsObject, t.nullLiteral()), propsObject, createThisMemberAccess("props"));
 	}
+	if (name === "data") return createPropsKeyAccessFallback(name, createThisMemberAccess(name));
 	const thisAccess = createThisMemberAccess(name);
 	const propsAccess = createMemberAccess(createThisMemberAccess(WEVU_PROPS_KEY), name);
 	const propsObject = createThisMemberAccess(WEVU_PROPS_KEY);
@@ -5730,10 +5840,14 @@ function createIdentifierAccessWithPropsFallback(name) {
 	const hasStateObject = t.binaryExpression("!=", stateObject, t.nullLiteral());
 	const hasStateKey = createHasOwnPropertyCall(stateObject, name);
 	const hasThisMember = t.binaryExpression("in", t.stringLiteral(name), t.thisExpression());
-	const shouldUseStateAccess = t.logicalExpression("&&", hasStateObject, hasStateKey);
-	const shouldUsePropsAccess = t.logicalExpression("&&", hasUsablePropsValue, t.unaryExpression("!", hasThisMember));
+	const isPropsDerivedKey = Boolean(context.propsDerivedKeys?.includes(name));
+	const shouldUseStateAccess = isPropsDerivedKey ? t.booleanLiteral(false) : t.logicalExpression("&&", hasStateObject, hasStateKey);
+	const shouldUsePropsAccess = t.logicalExpression("&&", hasUsablePropsValue, isPropsDerivedKey ? t.booleanLiteral(true) : t.unaryExpression("!", hasThisMember));
 	return t.conditionalExpression(shouldUseStateAccess, thisAccess, t.conditionalExpression(shouldUsePropsAccess, propsAccess, thisAccess));
 }
+function createAliasedPropsAccess(name, propName) {
+	return createResolvePropValueCall(propName, createThisMemberAccess(name), true);
+}
 function collectForAliasMapping(context) {
 	const mapping = {};
 	for (const forInfo of context.forStack) {
@@ -5782,14 +5896,19 @@ function normalizeJsExpressionWithContext(exp, context, options) {
 			replacement = createUnrefCall(prop ? createMemberAccess(base, prop) : base);
 		} else if (name === WEVU_SLOT_OWNER_KEY || name === WEVU_SLOT_PROPS_DATA_KEY || name === WEVU_SLOT_PROPS_KEY || name === WEVU_SLOT_SCOPE_KEY) replacement = createUnrefCall(createThisMemberAccess(name));
 		else replacement = createUnrefCall(createMemberAccess(createThisMemberAccess(WEVU_SLOT_OWNER_PROXY_KEY), name));
-		else replacement = createUnrefCall(createIdentifierAccessWithPropsFallback(name));
+		else {
+			const propsAlias = context.propsAliases?.[name];
+			replacement = createUnrefCall(propsAlias ? createAliasedPropsAccess(name, propsAlias) : createIdentifierAccessWithPropsFallback(name, context, options?.runtimePropAccess === "helper"));
+		}
 		const parent = path.parentPath;
 		if (parent.isObjectProperty() && parent.node.shorthand && parent.node.key === path.node) {
 			parent.node.shorthand = false;
 			parent.node.value = replacement;
+			path.skip();
 			return;
 		}
 		path.replaceWith(replacement);
+		path.skip();
 	} });
 	const stmt = ast.program.body[0];
 	return (stmt && "expression" in stmt ? stmt.expression : null) || null;
@@ -5825,7 +5944,10 @@ function shouldFallbackToRuntimeBinding(exp) {
 * 将复杂表达式注册为 JS 运行时计算绑定，返回可用于模板 mustache 的绑定引用。
 */
 function registerRuntimeBindingExpression(exp, context, options) {
-	const expAst = normalizeJsExpressionWithContext(exp, context, options);
+	const expAst = normalizeJsExpressionWithContext(exp, context, {
+		...options,
+		runtimePropAccess: "helper"
+	});
 	if (!expAst) return null;
 	const binding = {
 		name: `__wv_bind_${context.classStyleBindings.filter((item) => item.type === "bind").length}`,
@@ -5936,7 +6058,10 @@ function renderClassAttribute(staticClass, dynamicClassExp, context) {
 	}
 	const jsParts = [];
 	if (staticValue) jsParts.push(t.stringLiteral(staticValue));
-	const dynamicAst = normalizeJsExpressionWithContext(dynamicClassExp, context, { hint: "class 绑定" });
+	const dynamicAst = normalizeJsExpressionWithContext(dynamicClassExp, context, {
+		hint: "class 绑定",
+		runtimePropAccess: "helper"
+	});
 	if (dynamicAst) jsParts.push(dynamicAst);
 	const expAst = mergeJsExpressionParts(jsParts);
 	const binding = createClassStyleBinding(context, "class", generateExpressionCode(expAst), expAst, staticValue ?? "");
@@ -5965,11 +6090,17 @@ function renderStyleAttribute(staticStyle, dynamicStyleExp, vShowExp, context) {
 	const jsParts = [];
 	if (staticValue) jsParts.push(t.stringLiteral(staticValue));
 	if (dynamicStyleExp) {
-		const dynamicAst = normalizeJsExpressionWithContext(dynamicStyleExp, context, { hint: "style 绑定" });
+		const dynamicAst = normalizeJsExpressionWithContext(dynamicStyleExp, context, {
+			hint: "style 绑定",
+			runtimePropAccess: "helper"
+		});
 		if (dynamicAst) jsParts.push(dynamicAst);
 	}
 	if (vShowExp) {
-		const showAst = normalizeJsExpressionWithContext(vShowExp, context, { hint: "v-show" });
+		const showAst = normalizeJsExpressionWithContext(vShowExp, context, {
+			hint: "v-show",
+			runtimePropAccess: "helper"
+		});
 		if (showAst) jsParts.push(t.conditionalExpression(showAst, t.stringLiteral(""), t.stringLiteral("display: none")));
 	}
 	const expAst = mergeJsExpressionParts(jsParts);
@@ -6644,6 +6775,7 @@ function buildSlotDeclaration(name, propsExp, children, context, options) {
 		props: propsExp ? parseSlotPropsExpression(propsExp, context) : {},
 		children,
 		implicitDefault: options?.implicitDefault,
+		conditionKind: options?.conditionKind,
 		condition: options?.condition
 	};
 }
@@ -6737,6 +6869,9 @@ function isRenderableFallbackChild(child) {
 function renderSlotFallback(decl, context, transformNode) {
 	const slotAttr = renderSlotNameAttribute(decl.name, context, "slot");
 	const wrapCondition = (content) => {
+		if (decl.conditionKind === "else") return context.platform.wrapElse(content);
+		if (decl.conditionKind === "else-if" && decl.condition) return context.platform.wrapElseIf(decl.condition, content, (exp) => renderMustache(exp, context));
+		if (decl.conditionKind === "if" && decl.condition) return context.platform.wrapIf(decl.condition, content, (exp) => renderMustache(exp, context));
 		return decl.condition ? context.platform.wrapIf(decl.condition, content, (exp) => renderMustache(exp, context)) : content;
 	};
 	if (!slotAttr) {
@@ -6844,9 +6979,14 @@ function shouldAugmentPlainSlot(decl, context, ownerNode) {
 	return hasDirectComponentSlotChild(decl.children, context);
 }
 function resolveTemplateSlotCondition(node, context) {
-	const ifDirective = node.props.find((prop) => prop.type === NodeTypes.DIRECTIVE && prop.name === "if" && prop.exp?.type === NodeTypes.SIMPLE_EXPRESSION);
-	const rawExp = ifDirective?.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? ifDirective.exp.content : "";
-	return rawExp ? normalizeWxmlExpressionWithContext(rawExp, context) : void 0;
+	const directive = node.props.find((prop) => prop.type === NodeTypes.DIRECTIVE && (prop.name === "if" || prop.name === "else-if" || prop.name === "else") && (prop.name === "else" || prop.exp?.type === NodeTypes.SIMPLE_EXPRESSION));
+	if (!directive) return {};
+	if (directive.name === "else") return { conditionKind: "else" };
+	const rawExp = directive.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? directive.exp.content : "";
+	return {
+		conditionKind: directive.name === "else-if" ? "else-if" : "if",
+		condition: rawExp ? normalizeWxmlExpressionWithContext(rawExp, context) : void 0
+	};
 }
 function pushSlotNamesAttr(attrs, slotNames, context) {
 	if (!slotNames.length) return;
@@ -6905,7 +7045,9 @@ function transformComponentWithSlots(node, context, transformNode, options) {
 		if (child.type === NodeTypes.ELEMENT && child.tag === "template") {
 			const templateSlot = findSlotDirective(child);
 			if (templateSlot) {
-				const declaration = buildSlotDeclaration(resolveSlotNameFromDirective(templateSlot), templateSlot.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? templateSlot.exp.content : void 0, child.children, context, { condition: resolveTemplateSlotCondition(child, context) });
+				const slotName = resolveSlotNameFromDirective(templateSlot);
+				const templateSlotCondition = resolveTemplateSlotCondition(child, context);
+				const declaration = buildSlotDeclaration(slotName, templateSlot.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? templateSlot.exp.content : void 0, child.children, context, templateSlotCondition);
 				slotDeclarations.push(declaration);
 				renderItems.push({
 					type: "declaration",
@@ -7000,7 +7142,9 @@ function transformComponentWithSlotsFallback(node, context, transformNode, optio
 		if (child.type === NodeTypes.ELEMENT && child.tag === "template") {
 			const templateSlot = findSlotDirective(child);
 			if (templateSlot) {
-				const declaration = buildSlotDeclaration(resolveSlotNameFromDirective(templateSlot), templateSlot.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? templateSlot.exp.content : void 0, child.children, context, { condition: resolveTemplateSlotCondition(child, context) });
+				const slotName = resolveSlotNameFromDirective(templateSlot);
+				const templateSlotCondition = resolveTemplateSlotCondition(child, context);
+				const declaration = buildSlotDeclaration(slotName, templateSlot.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? templateSlot.exp.content : void 0, child.children, context, templateSlotCondition);
 				slotDeclarations.push(declaration);
 				renderItems.push({
 					type: "declaration",
@@ -7370,6 +7514,8 @@ function compileVueTemplateToWxml(template, filename, options) {
 			filename,
 			warnings,
 			platform: options?.platform ?? getMiniProgramTemplatePlatform(),
+			propsAliases: options?.propsAliases,
+			propsDerivedKeys: options?.propsDerivedKeys,
 			htmlTagToWxmlMap,
 			htmlTagToWxmlTagClass: options?.htmlTagToWxmlTagClass ?? true,
 			scopedSlotsCompiler: options?.scopedSlotsCompiler ?? "auto",
@@ -8228,18 +8374,91 @@ function composeSourceMaps(transformedMap, originalMap) {
 //#endregion
 //#region src/plugins/vue/transform/compileVueFile/script.ts
 const TYPE_ONLY_DEFINE_PROPS_RE = /\bdefineProps\s*</;
-async function compileScriptPhase(descriptor, descriptorForCompile, filename, options, _autoUsingComponents, templateCompiled, isAppFile, componentSourceInfo) {
+function resolveScriptSetupPropsAliases(bindings) {
+	const aliases = bindings?.__propsAliases;
+	if (!aliases || typeof aliases !== "object") return;
+	const resolved = {};
+	for (const [alias, propName] of Object.entries(aliases)) if (typeof propName === "string" && propName.length > 0) resolved[alias] = propName;
+	return Object.keys(resolved).length ? resolved : void 0;
+}
+function resolveScriptSetupPropsDerivedKeys(bindings) {
+	const keys = /* @__PURE__ */ new Set();
+	for (const [key, bindingType] of Object.entries(bindings ?? {})) {
+		if (key.startsWith("__") || bindingType !== "props" && bindingType !== "props-aliased") continue;
+		keys.add(key);
+	}
+	return keys.size ? [...keys] : void 0;
+}
+function collectScriptSetupReturnInfo(scriptCode) {
+	const keys = /* @__PURE__ */ new Set();
+	const propsObjectAliases = new Set(["__props"]);
+	const destructuredPropsKeys = /* @__PURE__ */ new Set();
+	try {
+		traverse(parseJsLike(scriptCode), {
+			VariableDeclarator(path) {
+				const init = path.node.init;
+				if (t.isIdentifier(path.node.id) && t.isIdentifier(init) && propsObjectAliases.has(init.name)) {
+					propsObjectAliases.add(path.node.id.name);
+					return;
+				}
+				if (!t.isObjectPattern(path.node.id) || !t.isIdentifier(init) || !propsObjectAliases.has(init.name)) return;
+				for (const property of path.node.id.properties) {
+					if (!t.isObjectProperty(property)) continue;
+					if (t.isIdentifier(property.value)) destructuredPropsKeys.add(property.value.name);
+					else if (t.isAssignmentPattern(property.value) && t.isIdentifier(property.value.left)) destructuredPropsKeys.add(property.value.left.name);
+				}
+			},
+			ObjectProperty(path) {
+				const objectPath = path.parentPath;
+				if (!objectPath.isObjectExpression() || !objectPath.parentPath.isVariableDeclarator() || !t.isIdentifier(objectPath.parentPath.node.id, { name: "__returned__" })) return;
+				const prop = path.node;
+				if (prop.computed) return;
+				if (t.isIdentifier(prop.key)) keys.add(prop.key.name);
+				else if (t.isStringLiteral(prop.key)) keys.add(prop.key.value);
+			}
+		});
+	} catch {
+		return {
+			returnedKeys: keys,
+			destructuredPropsKeys
+		};
+	}
+	return {
+		returnedKeys: keys,
+		destructuredPropsKeys
+	};
+}
+function resolveEffectivePropsDerivedKeys(bindings, scriptCode) {
+	const directKeys = resolveScriptSetupPropsDerivedKeys(bindings) ?? [];
+	const { returnedKeys, destructuredPropsKeys } = collectScriptSetupReturnInfo(scriptCode);
+	const aliases = resolveScriptSetupPropsAliases(bindings) ?? {};
+	const propsKeys = new Set(Object.entries(bindings ?? {}).filter(([key, bindingType]) => key && !key.startsWith("__") && bindingType === "props").map(([key]) => key));
+	const keys = /* @__PURE__ */ new Set();
+	for (const key of directKeys) keys.add(key);
+	for (const key of destructuredPropsKeys) keys.add(key);
+	for (const [alias, propName] of Object.entries(aliases)) {
+		if (!returnedKeys.has(alias)) keys.add(alias);
+		if (propsKeys.has(propName) && !returnedKeys.has(propName)) keys.add(propName);
+	}
+	for (const key of propsKeys) if (!returnedKeys.has(key)) keys.add(key);
+	return keys.size ? [...keys] : void 0;
+}
+async function compileScriptPhase(descriptor, descriptorForCompile, filename, options, _autoUsingComponents, templateCompiled, isAppFile, componentSourceInfo, precompiledScript) {
 	const autoUsingComponentsMap = { ...componentSourceInfo?.autoUsingComponentsMap ?? {} };
 	const autoComponentMeta = { ...componentSourceInfo?.autoComponentMeta ?? {} };
 	const relaxStructuredTypeOnlyProps = Boolean(descriptor.scriptSetup?.content && TYPE_ONLY_DEFINE_PROPS_RE.test(descriptor.scriptSetup.content));
 	let scriptCode;
 	let scriptMap = null;
+	let propsAliases = options?.template?.propsAliases;
+	let propsDerivedKeys;
 	if (descriptor.script || descriptor.scriptSetup) {
-		const scriptCompiled = compileScript(descriptorForCompile, {
+		const scriptCompiled = precompiledScript ?? compileScript(descriptorForCompile, {
 			id: filename,
 			isProd: false
 		});
+		propsAliases ??= resolveScriptSetupPropsAliases(scriptCompiled.bindings);
 		scriptCode = scriptCompiled.content;
+		propsDerivedKeys = resolveEffectivePropsDerivedKeys(scriptCompiled.bindings, scriptCode);
 		scriptMap = scriptCompiled.map && typeof scriptCompiled.map === "object" ? scriptCompiled.map : null;
 		if (scriptCode.includes("defineAppJson") || scriptCode.includes("definePageJson") || scriptCode.includes("defineComponentJson")) scriptCode = stripJsonMacroCallsFromCode(scriptCode, filename);
 		if (!isAppFile && !scriptCode.includes("export default")) scriptCode += "\nexport default {}";
@@ -8259,6 +8478,8 @@ async function compileScriptPhase(descriptor, descriptorForCompile, filename, op
 			layoutHosts: templateCompiled?.layoutHosts,
 			inlineExpressions: templateCompiled?.inlineExpressions,
 			functionPropPaths: templateCompiled?.functionPropPaths,
+			propsAliases,
+			propsDerivedKeys,
 			relaxStructuredTypeOnlyProps
 		});
 		return {
@@ -8343,10 +8564,22 @@ async function compileVueFile(source, filename, options) {
 		autoUsingComponents,
 		autoImportTags
 	});
+	const scriptCompiled = parsed.descriptor.script || parsed.descriptor.scriptSetup ? compileScript(parsed.descriptorForCompile, {
+		id: filename,
+		isProd: false
+	}) : void 0;
+	const propsAliases = scriptCompiled ? resolveScriptSetupPropsAliases(scriptCompiled.bindings) : void 0;
+	const propsDerivedKeys = scriptCompiled ? resolveEffectivePropsDerivedKeys(scriptCompiled.bindings, scriptCompiled.content) : void 0;
 	const baseTemplateOptions = parsed.isAppFile ? {
 		...options?.template,
+		propsAliases,
+		propsDerivedKeys,
 		scopedSlotsRequireProps: true
-	} : options?.template;
+	} : {
+		...options?.template,
+		propsAliases,
+		propsDerivedKeys
+	};
 	const templateOptions = componentSourceInfo.wevuComponentTags.size ? {
 		...baseTemplateOptions,
 		wevuComponentTags: componentSourceInfo.wevuComponentTags
@@ -8355,7 +8588,7 @@ async function compileVueFile(source, filename, options) {
 		wevuComponentTags: []
 	};
 	const templateCompiled = compileTemplatePhase(parsed.descriptor, filename, templateOptions, result);
-	const scriptPhase = await compileScriptPhase(parsed.descriptor, parsed.descriptorForCompile, filename, options, autoUsingComponents, templateCompiled, parsed.isAppFile, componentSourceInfo);
+	const scriptPhase = await compileScriptPhase(parsed.descriptor, parsed.descriptorForCompile, filename, options, autoUsingComponents, templateCompiled, parsed.isAppFile, componentSourceInfo, scriptCompiled);
 	result.script = scriptPhase.script;
 	result.scriptMap = scriptPhase.scriptMap;
 	compileStylePhase(parsed.descriptor, filename, result);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wevu/compiler",
   "type": "module",
-  "version": "6.16.19",
+  "version": "6.16.21",
   "description": "wevu 编译器基础包，面向小程序模板的编译与转换",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -50,9 +50,9 @@
     "merge": "^2.1.1",
     "pathe": "^2.0.3",
     "vue": "^3.5.34",
-    "@weapp-core/constants": "0.1.8",
+    "@weapp-core/constants": "0.1.9",
     "@weapp-core/shared": "3.0.4",
-    "@weapp-vite/ast": "6.16.19",
+    "@weapp-vite/ast": "6.16.21",
     "rolldown-require": "2.0.17"
   },
   "publishConfig": {