@wevu/compiler 6.16.24 → 6.16.25

package/dist/index.d.mts

@@ -281,11 +281,13 @@ interface TemplateCompileOptions {
    */
   propsAliases?: Record<string, string>;
   propsDerivedKeys?: string[];
+  scriptSetupBindings?: Record<string, unknown>;
   htmlTagToWxml?: boolean | Record<string, string>;
   htmlTagToWxmlTagClass?: boolean;
   scopedSlotsCompiler?: ScopedSlotsCompilerMode;
   scopedSlotsRequireProps?: boolean;
   slotSingleRootNoWrapper?: boolean;
+  slotFallbackWrapper?: SlotFallbackWrapperConfig;
   slotMultipleInstance?: boolean;
   classStyleRuntime?: ClassStyleRuntime | 'auto';
   objectLiteralBindMode?: ObjectLiteralBindMode;
@@ -295,11 +297,36 @@ interface TemplateCompileOptions {
   classStyleWxsSrc?: string;
   functionPropNames?: Iterable<FunctionPropNameMatcher>;
   wevuComponentTags?: Iterable<string>;
+  componentNameMap?: Record<string, string>;
 }
 /**
  * 作用域插槽编译模式。
  */
 type ScopedSlotsCompilerMode = 'auto' | 'augmented' | 'off';
+/**
+ * 命名插槽 fallback 容器策略匹配器。
+ */
+type SlotFallbackWrapperMatcher = string | RegExp | Array<string | RegExp>;
+/**
+ * 命名插槽 fallback 容器规则。
+ */
+interface SlotFallbackWrapperRule {
+  component?: SlotFallbackWrapperMatcher;
+  componentName?: SlotFallbackWrapperMatcher;
+  slot?: SlotFallbackWrapperMatcher;
+  tag?: string;
+  attrs?: Record<string, string>;
+  singleRootNoWrapper?: boolean;
+}
+/**
+ * 命名插槽 fallback 容器配置。
+ */
+type SlotFallbackWrapperConfig = string | {
+  tag?: string;
+  attrs?: Record<string, string>;
+  singleRootNoWrapper?: boolean;
+  rules?: SlotFallbackWrapperRule[];
+};
 /**
  * class/style 运行时模式。
  */

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_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 { 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, WEVU_TEMPLATE_REF_CLASS_PREFIX } 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,11 +2241,31 @@ function buildConsoleErrorGuard(message, errorId) {
 function buildRuntimeExpressionErrorGuard(binding, errorId) {
 	return buildConsoleErrorGuard(`[wevu] 模板运行时表达式执行失败: ${binding.name} = ${binding.exp}`, errorId);
 }
+function isScopedSlotOwnerBinding(exp) {
+	if (!exp) return false;
+	const seen = /* @__PURE__ */ new WeakSet();
+	const visit = (node) => {
+		if (!node || typeof node !== "object") return false;
+		if (seen.has(node)) return false;
+		seen.add(node);
+		if (node.type === "MemberExpression") {
+			const member = node;
+			const property = member.property;
+			if (!member.computed && member.object?.type === "ThisExpression" && property?.type === "Identifier" && (property.name === WEVU_SLOT_OWNER_PROXY_KEY || property.name === WEVU_SLOT_OWNER_KEY)) return true;
+		}
+		for (const value of Object.values(node)) if (Array.isArray(value)) {
+			if (value.some((item) => visit(item))) return true;
+		} else if (visit(value)) return true;
+		return false;
+	};
+	return visit(exp);
+}
 function shouldReportRuntimeExpressionError(binding) {
-	return binding.type === "bind";
+	return binding.type === "bind" && !isScopedSlotOwnerBinding(binding.expAst);
 }
 function shouldReportForSourceError(info) {
-	return !(info.listExp?.trim() ?? "").startsWith(`${WEVU_SLOT_PROPS_DATA_KEY}.`);
+	const listExp = info.listExp?.trim() ?? "";
+	return !listExp.startsWith(`${WEVU_SLOT_PROPS_DATA_KEY}.`) && !listExp.startsWith(`${WEVU_SLOT_OWNER_KEY}.`) && !isScopedSlotOwnerBinding(info.listExpAst);
 }
 function createDataPropsFallbackExpression(fallback) {
 	const propsObject = t.memberExpression(t.thisExpression(), t.identifier(WEVU_PROPS_KEY));
@@ -2283,7 +2303,7 @@ function buildNormalizedExpression(binding, helpers) {
 	const errorId = t.identifier(WEVU_EXPRESSION_ERROR_IDENTIFIER);
 	if (binding.type === "bind") {
 		const exp = binding.expAst ? t.cloneNode(binding.expAst, true) : t.identifier("undefined");
-		return t.callExpression(t.arrowFunctionExpression([], t.blockStatement([t.tryStatement(t.blockStatement([t.returnStatement(exp)]), t.catchClause(t.cloneNode(errorId), t.blockStatement([buildRuntimeExpressionErrorGuard(binding, errorId), t.returnStatement(t.identifier("undefined"))])), null)])), []);
+		return t.callExpression(t.arrowFunctionExpression([], t.blockStatement([t.tryStatement(t.blockStatement([t.returnStatement(exp)]), t.catchClause(t.cloneNode(errorId), t.blockStatement([...shouldReportRuntimeExpressionError(binding) ? [buildRuntimeExpressionErrorGuard(binding, errorId)] : [], t.returnStatement(t.identifier("undefined"))])), null)])), []);
 	}
 	const normalizeHelper = binding.type === "class" ? helpers.normalizeClass : helpers.normalizeStyle;
 	const errorFallback = binding.errorFallback ?? "";
@@ -5394,7 +5414,7 @@ function collectForAliasMapping$2(context) {
 	}
 	return mapping;
 }
-function replaceIdentifierWithExpression(path, replacement) {
+function replaceIdentifierWithExpression$1(path, replacement) {
 	const parent = path.parentPath;
 	if (parent.isObjectProperty() && parent.node.shorthand && parent.node.key === path.node) {
 		parent.node.shorthand = false;
@@ -5425,16 +5445,16 @@ function rewriteScopedSlotExpression(exp, context) {
 		if (hasOwn(forAliases, name)) {
 			const aliasExp = parseBabelExpression(forAliases[name]);
 			if (aliasExp) {
-				replaceIdentifierWithExpression(path, t.cloneNode(aliasExp, true));
+				replaceIdentifierWithExpression$1(path, t.cloneNode(aliasExp, true));
 				return;
 			}
 		}
 		if (locals.has(name)) return;
 		if (hasOwn(slotProps, name)) {
-			replaceIdentifierWithExpression(path, createMemberAccess(WEVU_SLOT_PROPS_DATA_KEY, slotProps[name]));
+			replaceIdentifierWithExpression$1(path, createMemberAccess(WEVU_SLOT_PROPS_DATA_KEY, slotProps[name]));
 			return;
 		}
-		replaceIdentifierWithExpression(path, createMemberAccess(WEVU_SLOT_OWNER_KEY, name));
+		replaceIdentifierWithExpression$1(path, createMemberAccess(WEVU_SLOT_OWNER_KEY, name));
 	} });
 	const stmt = ast.program.body[0];
 	const updatedExpression = stmt && "expression" in stmt ? stmt.expression : null;
@@ -5453,7 +5473,7 @@ function rewriteForAliasExpression(exp, context) {
 		if (path.scope.hasBinding(name)) return;
 		if (hasOwn(forAliases, name)) {
 			const aliasExp = parseBabelExpression(forAliases[name]);
-			if (aliasExp) replaceIdentifierWithExpression(path, t.cloneNode(aliasExp, true));
+			if (aliasExp) replaceIdentifierWithExpression$1(path, t.cloneNode(aliasExp, true));
 		}
 	} });
 	const stmt = ast.program.body[0];
@@ -5613,10 +5633,20 @@ const INLINE_GLOBALS = new Set([
 ]);
 const IDENTIFIER_RE$2 = /^[A-Z_$][\w$]*$/i;
 const SIMPLE_PATH_RE = /^[A-Z_$][\w$]*(?:\.[A-Z_$][\w$]*)*$/i;
+const SCRIPT_SETUP_REF_BINDINGS = new Set(["setup-ref", "setup-maybe-ref"]);
 function createMemberAccess$1(target, prop) {
 	if (IDENTIFIER_RE$2.test(prop)) return t.memberExpression(t.identifier(target), t.identifier(prop));
 	return t.memberExpression(t.identifier(target), t.stringLiteral(prop), true);
 }
+function replaceIdentifierWithExpression(path, replacement) {
+	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);
+}
 function resolveSlotPropBinding(slotProps, name) {
 	if (!hasOwn(slotProps, name)) return null;
 	const prop = slotProps[name];
@@ -5633,11 +5663,11 @@ function rewriteExpressionAst(ast, locals, options) {
 			if (path.scope.getBinding(name)) return;
 			if (locals.has(name)) {
 				options?.markLocal?.(name);
-				path.replaceWith(createMemberAccess$1("scope", name));
+				replaceIdentifierWithExpression(path, createMemberAccess$1("scope", name));
 				return;
 			}
 			if (INLINE_GLOBALS.has(name)) return;
-			path.replaceWith(createMemberAccess$1("ctx", name));
+			replaceIdentifierWithExpression(path, createMemberAccess$1("ctx", name));
 		},
 		ThisExpression(path) {
 			path.replaceWith(t.identifier("ctx"));
@@ -5693,6 +5723,48 @@ function collectForAliasMapping$1(context) {
 	}
 	return mapping;
 }
+function getScriptSetupBindingType(context, name) {
+	const binding = context.scriptSetupBindings?.[name];
+	return typeof binding === "string" ? binding : void 0;
+}
+function isScriptSetupBinding(context, name) {
+	return Boolean(getScriptSetupBindingType(context, name));
+}
+function isScriptSetupRefLikeBinding(context, name) {
+	const bindingType = getScriptSetupBindingType(context, name);
+	return bindingType ? SCRIPT_SETUP_REF_BINDINGS.has(bindingType) : false;
+}
+function isRefLikeCtxMember(node, context) {
+	return t.isMemberExpression(node) && t.isIdentifier(node.object, { name: "ctx" }) && t.isIdentifier(node.property) && !node.computed && isScriptSetupRefLikeBinding(context, node.property.name);
+}
+function buildCtxValueAccess(member) {
+	return t.memberExpression(t.cloneNode(member), t.identifier("value"));
+}
+function isValueMemberObject(node, parent) {
+	return t.isMemberExpression(parent) && parent.object === node && t.isIdentifier(parent.property, { name: "value" }) && !parent.computed;
+}
+function rewriteTopLevelRefLikeAccess(ast, context) {
+	traverse(ast, {
+		AssignmentExpression(path) {
+			const left = path.node.left;
+			if (t.isIdentifier(left) && isScriptSetupRefLikeBinding(context, left.name)) path.node.left = buildCtxValueAccess(t.memberExpression(t.identifier("ctx"), t.identifier(left.name)));
+			else if (t.isIdentifier(left) && isScriptSetupBinding(context, left.name)) path.node.left = t.memberExpression(t.identifier("ctx"), t.identifier(left.name));
+			else if (isRefLikeCtxMember(left, context)) path.node.left = buildCtxValueAccess(left);
+		},
+		UpdateExpression(path) {
+			const arg = path.node.argument;
+			if (t.isIdentifier(arg) && isScriptSetupRefLikeBinding(context, arg.name)) path.node.argument = buildCtxValueAccess(t.memberExpression(t.identifier("ctx"), t.identifier(arg.name)));
+			else if (t.isIdentifier(arg) && isScriptSetupBinding(context, arg.name)) path.node.argument = t.memberExpression(t.identifier("ctx"), t.identifier(arg.name));
+			else if (isRefLikeCtxMember(arg, context)) path.node.argument = buildCtxValueAccess(arg);
+		}
+	});
+	traverse(ast, { MemberExpression(path) {
+		if (!isRefLikeCtxMember(path.node, context)) return;
+		if (isValueMemberObject(path.node, path.parentPath?.node)) return;
+		path.replaceWith(buildCtxValueAccess(path.node));
+		path.skip();
+	} });
+}
 function registerInlineExpression(exp, context) {
 	const parsed = parseBabelExpressionFile(exp);
 	if (!parsed) return null;
@@ -5708,6 +5780,7 @@ function registerInlineExpression(exp, context) {
 		usedLocals.push(name);
 	};
 	rewriteExpressionAst(ast, locals, { markLocal });
+	rewriteTopLevelRefLikeAccess(ast, context);
 	const forAliases = collectForAliasMapping$1(context);
 	const updatedStmt = ast.program.body[0];
 	const updatedExpressionNode = updatedStmt && "expression" in updatedStmt ? updatedStmt.expression : null;
@@ -6523,6 +6596,7 @@ function collectElementAttributes(node, context, options) {
 				else layoutHostKey = rawKey;
 				continue;
 			}
+			if (prop.name === "slot-wrapper" || prop.name.startsWith("slot-wrapper-") || prop.name.startsWith("slot-wrapper:") || prop.name === "slot-single-root-no-wrapper" || prop.name.startsWith("slot-single-root-no-wrapper-") || prop.name.startsWith("slot-single-root-no-wrapper:")) continue;
 			if (prop.name === "ref") {
 				if (prop.value?.type === NodeTypes.TEXT) {
 					const name = prop.value.content.trim();
@@ -6561,6 +6635,11 @@ function collectElementAttributes(node, context, options) {
 				context.warnings.push("暂不支持动态 layout-host，已忽略该绑定。");
 				continue;
 			}
+			if (prop.name === "bind" && prop.arg?.type === NodeTypes.SIMPLE_EXPRESSION && (prop.arg.content === "slot-wrapper" || prop.arg.content.startsWith("slot-wrapper-") || prop.arg.content.startsWith("slot-wrapper:") || prop.arg.content === "slot-single-root-no-wrapper" || prop.arg.content.startsWith("slot-single-root-no-wrapper-") || prop.arg.content.startsWith("slot-single-root-no-wrapper:"))) {
+				if (prop.arg.content.endsWith("-class") || prop.arg.content.endsWith(":class") || prop.arg.content.endsWith("-style") || prop.arg.content.endsWith(":style")) continue;
+				context.warnings.push(`暂不支持动态 ${prop.arg.content}，已忽略该绑定。`);
+				continue;
+			}
 			if (prop.name === "bind" && prop.arg?.type === NodeTypes.SIMPLE_EXPRESSION && prop.arg.content === "class") {
 				dynamicClassExp = getBindDirectiveExpression(prop) || void 0;
 				continue;
@@ -6584,7 +6663,7 @@ function collectElementAttributes(node, context, options) {
 	}
 	if (mappedTagClass) staticClass = prependStaticClass(staticClass, mappedTagClass);
 	if (templateRef) {
-		const className = `__wv-ref-${context.templateRefIndexSeed++}`;
+		const className = `${WEVU_TEMPLATE_REF_CLASS_PREFIX}${context.templateRefIndexSeed++}`;
 		staticClass = staticClass ? `${staticClass} ${className}` : className;
 		context.templateRefs.push({
 			selector: `.${className}`,
@@ -6779,7 +6858,8 @@ function buildSlotDeclaration(name, propsExp, children, context, options) {
 		children,
 		implicitDefault: options?.implicitDefault,
 		conditionKind: options?.conditionKind,
-		condition: options?.condition
+		condition: options?.condition,
+		wrapper: options?.wrapper
 	};
 }
 function createScopedSlotComponent(context, slotKey, props, children, transformNode, options) {
@@ -6828,7 +6908,8 @@ function createScopedSlotComponent(context, slotKey, props, children, transformN
 		slotKey
 	};
 }
-function injectAttributeIntoOpeningTag(source, attr) {
+function injectAttributesIntoOpeningTag(source, attrs) {
+	if (!attrs.length) return source;
 	if (!source.startsWith("<") || source.startsWith("</") || source.startsWith("<!--")) return null;
 	let tagNameEnd = 1;
 	while (tagNameEnd < source.length) {
@@ -6837,7 +6918,7 @@ function injectAttributeIntoOpeningTag(source, attr) {
 		tagNameEnd += 1;
 	}
 	if (tagNameEnd <= 1) return null;
-	return `${source.slice(0, tagNameEnd)} ${attr}${source.slice(tagNameEnd)}`;
+	return `${source.slice(0, tagNameEnd)} ${attrs.join(" ")}${source.slice(tagNameEnd)}`;
 }
 function createSlotAttributeNode(sourceNode, attr) {
 	const match = /^slot="([\s\S]*)"$/.exec(attr);
@@ -6854,22 +6935,119 @@ function createSlotAttributeNode(sourceNode, attr) {
 		loc: sourceNode.loc
 	};
 }
-function injectSlotAttributeIntoElementNode(child, slotAttr, transformNode, context) {
+function injectSlotAttributeIntoElementNode(child, slotAttr, extraAttrs, transformNode, context) {
 	if (child.type !== NodeTypes.ELEMENT || child.tag === "template") return null;
 	const sourceNode = child;
 	const slotAttribute = createSlotAttributeNode(sourceNode, slotAttr);
 	if (!slotAttribute) return null;
-	return transformNode({
+	return injectAttributesIntoOpeningTag(transformNode({
 		...sourceNode,
 		props: [slotAttribute, ...sourceNode.props]
-	}, context);
+	}, context), extraAttrs);
 }
 function isRenderableFallbackChild(child) {
 	if (child.type === NodeTypes.COMMENT) return false;
 	if (child.type === NodeTypes.TEXT) return child.content.trim().length > 0;
 	return true;
 }
-function renderSlotFallback(decl, context, transformNode) {
+function canInjectSlotAttributeIntoFallbackChild(child) {
+	if (child.type !== NodeTypes.ELEMENT) return true;
+	return child.tag !== "slot";
+}
+function matchesSlotFallbackWrapperMatcher(matcher, value) {
+	if (!matcher) return true;
+	if (!value) return false;
+	if (Array.isArray(matcher)) return matcher.some((item) => matchesSlotFallbackWrapperMatcher(item, value));
+	return typeof matcher === "string" ? matcher === value : matcher.test(value);
+}
+function normalizeSlotFallbackWrapperTag(tag, context) {
+	const normalized = tag?.trim() || "view";
+	if (normalized === "block") {
+		context.warnings.push("slot fallback wrapper 不支持配置为 block，已回退为 view。");
+		return "view";
+	}
+	return normalized;
+}
+function mergeSlotFallbackWrapperAttrs(base, override) {
+	if (!base) return override;
+	if (!override) return base;
+	return {
+		...base,
+		...override
+	};
+}
+function resolveSlotFallbackWrapper(context, info) {
+	const resolved = {
+		tag: normalizeSlotFallbackWrapperTag(context.slotFallbackWrapper.tag, context),
+		attrs: context.slotFallbackWrapper.attrs,
+		singleRootNoWrapper: context.slotFallbackWrapper.singleRootNoWrapper ?? context.slotSingleRootNoWrapper
+	};
+	for (const rule of context.slotFallbackWrapper.rules) if (matchesSlotFallbackWrapperMatcher(rule.component, info.component) && matchesSlotFallbackWrapperMatcher(rule.componentName, info.componentName) && matchesSlotFallbackWrapperMatcher(rule.slot, info.slot)) {
+		if (rule.tag) resolved.tag = normalizeSlotFallbackWrapperTag(rule.tag, context);
+		if (rule.attrs) resolved.attrs = mergeSlotFallbackWrapperAttrs(resolved.attrs, rule.attrs);
+		if (rule.singleRootNoWrapper !== void 0) resolved.singleRootNoWrapper = rule.singleRootNoWrapper;
+	}
+	if (info.local?.tag) resolved.tag = normalizeSlotFallbackWrapperTag(info.local.tag, context);
+	if (info.local?.staticClass !== void 0) resolved.staticClass = info.local.staticClass;
+	if (info.local?.dynamicClassExp !== void 0) resolved.dynamicClassExp = info.local.dynamicClassExp;
+	if (info.local?.staticStyle !== void 0) resolved.staticStyle = info.local.staticStyle;
+	if (info.local?.dynamicStyleExp !== void 0) resolved.dynamicStyleExp = info.local.dynamicStyleExp;
+	if (info.local?.singleRootNoWrapper !== void 0) resolved.singleRootNoWrapper = info.local.singleRootNoWrapper;
+	return resolved;
+}
+function createStaticAttributeNode(name, value) {
+	return {
+		type: NodeTypes.ATTRIBUTE,
+		name,
+		nameLoc: void 0,
+		value: {
+			type: NodeTypes.TEXT,
+			content: value,
+			loc: void 0
+		},
+		loc: void 0
+	};
+}
+function renderSlotFallbackWrapperAttrs(wrapper, context) {
+	const attrs = [];
+	for (const [name, value] of Object.entries(wrapper.attrs ?? {})) {
+		if (name === "class" && (wrapper.staticClass !== void 0 || wrapper.dynamicClassExp !== void 0)) continue;
+		if (name === "style" && (wrapper.staticStyle !== void 0 || wrapper.dynamicStyleExp !== void 0)) continue;
+		const attr = transformAttribute(createStaticAttributeNode(name, value), context);
+		if (attr) attrs.push(attr);
+	}
+	const classAttr = renderClassAttribute(wrapper.staticClass, wrapper.dynamicClassExp, context);
+	if (classAttr) attrs.push(classAttr);
+	const styleAttr = renderStyleAttribute(wrapper.staticStyle, wrapper.dynamicStyleExp, void 0, context);
+	if (styleAttr) attrs.push(styleAttr);
+	return attrs;
+}
+function renderPlainSlotOutlet(node, context, transformNode) {
+	const slotNameInfo = resolveSlotNameFromSlotElement(node);
+	const hasScopeBindings = node.props.some((prop) => {
+		if (prop.type === NodeTypes.DIRECTIVE && prop.name === "bind") return prop.arg?.type !== NodeTypes.SIMPLE_EXPRESSION || prop.arg.content !== "name";
+		return false;
+	});
+	if (hasScopeBindings) context.warnings.push("已禁用作用域插槽参数，插槽绑定将被忽略。");
+	const fallbackContent = node.children.map((child) => transformNode(child, context)).join("");
+	const slotAttrs = [];
+	const nameAttr = renderSlotNameAttribute(slotNameInfo, context, "name");
+	if (nameAttr) slotAttrs.push(nameAttr);
+	const slotAttrString = slotAttrs.length ? ` ${slotAttrs.join(" ")}` : "";
+	if (!hasScopeBindings && fallbackContent) {
+		const slotPresentExp = createSlotPresenceExpression(slotNameInfo);
+		if (slotPresentExp) {
+			const slotTag = `<slot${slotAttrString} />`;
+			return `${context.platform.wrapIf(slotPresentExp, slotTag, (exp) => renderMustache(exp, context))}${context.platform.wrapElse(fallbackContent)}`;
+		}
+	}
+	return fallbackContent ? `<slot${slotAttrString}>${fallbackContent}</slot>` : `<slot${slotAttrString} />`;
+}
+function transformFallbackChild(child, context, transformNode) {
+	if (child.type === NodeTypes.ELEMENT && child.tag === "slot") return renderPlainSlotOutlet(child, context, transformNode);
+	return transformNode(child, context);
+}
+function renderSlotFallback(decl, context, transformNode, options) {
 	const slotAttr = renderSlotNameAttribute(decl.name, context, "slot");
 	const wrapCondition = (content) => {
 		if (decl.conditionKind === "else") return context.platform.wrapElse(content);
@@ -6884,17 +7062,31 @@ function renderSlotFallback(decl, context, transformNode) {
 	}
 	const renderableChildren = decl.children.filter(isRenderableFallbackChild);
 	if (!renderableChildren.length) return "";
-	if (!context.slotSingleRootNoWrapper) {
-		const rawContent = decl.children.map((child) => transformNode(child, context)).join("");
+	const staticSlotName = resolveSlotStaticName(decl.name);
+	const wrapper = resolveSlotFallbackWrapper(context, {
+		component: options?.component,
+		componentName: options?.componentName,
+		slot: staticSlotName,
+		local: {
+			...options?.wrapper,
+			...decl.wrapper
+		}
+	});
+	const wrapperAttrs = renderSlotFallbackWrapperAttrs(wrapper, context);
+	const wrapperAttrString = wrapperAttrs.length ? ` ${wrapperAttrs.join(" ")}` : "";
+	if (!wrapper.singleRootNoWrapper) {
+		const rawContent = decl.children.map((child) => transformFallbackChild(child, context, transformNode)).join("");
 		if (!rawContent) return "";
-		return wrapCondition(`<view ${slotAttr}>${rawContent}</view>`);
+		return wrapCondition(`<${wrapper.tag} ${slotAttr}${wrapperAttrString}>${rawContent}</${wrapper.tag}>`);
 	}
 	if (renderableChildren.length === 1) {
 		const child = renderableChildren[0];
-		const projected = child.type === NodeTypes.ELEMENT && isStructuralDirective(child).type ? injectSlotAttributeIntoElementNode(child, slotAttr, transformNode, context) : injectAttributeIntoOpeningTag(transformNode(child, context), slotAttr);
+		let projected = null;
+		if (canInjectSlotAttributeIntoFallbackChild(child)) projected = child.type === NodeTypes.ELEMENT && isStructuralDirective(child).type ? injectSlotAttributeIntoElementNode(child, slotAttr, wrapperAttrs, transformNode, context) : injectAttributesIntoOpeningTag(transformNode(child, context), [slotAttr, ...wrapperAttrs]);
 		if (projected) return wrapCondition(projected);
 	}
-	return wrapCondition(`<view ${slotAttr}>${renderableChildren.map((child) => transformNode(child, context)).join("")}</view>`);
+	const content = renderableChildren.map((child) => transformFallbackChild(child, context, transformNode)).join("");
+	return wrapCondition(`<${wrapper.tag} ${slotAttr}${wrapperAttrString}>${content}</${wrapper.tag}>`);
 }
 function transformSlotElement(node, context, transformNode) {
 	if (isScopedSlotsDisabled(context)) return transformSlotElementPlain(node, context, transformNode);
@@ -6913,6 +7105,7 @@ function transformSlotElement(node, context, transformNode) {
 		else if (!slotPropsExp) slotTag = `<slot${slotAttrString}>${fallbackContent}</slot>`;
 	}
 	if (!slotPropsExp && (context.scopedSlotsRequireProps || slotNameInfo.type !== "default" && context.scopedSlotsCompiler !== "augmented")) return slotTag;
+	const hasScopeBindings = Boolean(slotPropsExp);
 	const genericKey = `scoped-slots-${resolveSlotKey(context, slotNameInfo)}`;
 	context.componentGenerics[genericKey] = true;
 	slotPropsExp = slotPropsExp ?? "[]";
@@ -6923,30 +7116,12 @@ function transformSlotElement(node, context, transformNode) {
 	];
 	if (context.slotMultipleInstance) scopedAttrs.push(`${WEVU_SLOT_SCOPE_ATTR}="${renderMustache(WEVU_SLOT_SCOPE_KEY, context)}"`);
 	const scopedTag = `<${genericKey}${scopedAttrs.length ? ` ${scopedAttrs.join(" ")}` : ""} />`;
-	const projectedContent = `${slotTag}${scopedTag}`;
+	const projectedContent = hasScopeBindings ? scopedTag : `${scopedTag}${context.platform.wrapElse(slotTag)}`;
 	if (fallbackContent && slotPresentExp) return `${context.platform.wrapIf(slotPresentExp, projectedContent, (exp) => renderMustache(exp, context))}${context.platform.wrapElse(fallbackContent)}`;
 	return projectedContent;
 }
 function transformSlotElementPlain(node, context, transformNode) {
-	const slotNameInfo = resolveSlotNameFromSlotElement(node);
-	const hasScopeBindings = node.props.some((prop) => {
-		if (prop.type === NodeTypes.DIRECTIVE && prop.name === "bind") return prop.arg?.type !== NodeTypes.SIMPLE_EXPRESSION || prop.arg.content !== "name";
-		return false;
-	});
-	if (hasScopeBindings) context.warnings.push("已禁用作用域插槽参数，插槽绑定将被忽略。");
-	const fallbackContent = node.children.map((child) => transformNode(child, context)).join("");
-	const slotAttrs = [];
-	const nameAttr = renderSlotNameAttribute(slotNameInfo, context, "name");
-	if (nameAttr) slotAttrs.push(nameAttr);
-	const slotAttrString = slotAttrs.length ? ` ${slotAttrs.join(" ")}` : "";
-	if (!hasScopeBindings && fallbackContent) {
-		const slotPresentExp = createSlotPresenceExpression(slotNameInfo);
-		if (slotPresentExp) {
-			const slotTag = `<slot${slotAttrString} />`;
-			return `${context.platform.wrapIf(slotPresentExp, slotTag, (exp) => renderMustache(exp, context))}${context.platform.wrapElse(fallbackContent)}`;
-		}
-	}
-	return fallbackContent ? `<slot${slotAttrString}>${fallbackContent}</slot>` : `<slot${slotAttrString} />`;
+	return renderPlainSlotOutlet(node, context, transformNode);
 }
 //#endregion
 //#region src/plugins/vue/compiler/template/elements/tag-component.ts
@@ -7022,11 +7197,82 @@ function pushSlotNamesAttr(attrs, slotNames, context) {
 function shouldExposePlainSlotPresence(node) {
 	return node.tag === "component";
 }
-function renderPlainSlotContentInSourceOrder(renderItems, plainSlotDeclarations, implicitDefaultDeclaration, context, transformNode) {
+function normalizeBooleanAttributeValue(value) {
+	if (value === void 0 || value === "") return true;
+	if (value === "true") return true;
+	if (value === "false") return false;
+}
+function isSlotFallbackWrapperName(name, baseName, slotName) {
+	return name === baseName || slotName !== void 0 && (name === `${baseName}-${slotName}` || name === `${baseName}:${slotName}`);
+}
+function isSlotFallbackWrapperAttr(name, baseName, slotName, attrName) {
+	if (!attrName) return isSlotFallbackWrapperName(name, baseName, slotName);
+	return name === `${baseName}-${attrName}` || slotName !== void 0 && (name === `${baseName}-${slotName}-${attrName}` || name === `${baseName}:${slotName}:${attrName}`);
+}
+function resolveLocalSlotFallbackWrapperConfig(node, context, slotName) {
+	const wrapper = {};
+	let hasConfig = false;
+	for (const prop of node.props) if (prop.type === NodeTypes.ATTRIBUTE) {
+		if (isSlotFallbackWrapperAttr(prop.name, "slot-wrapper", slotName)) {
+			const tag = prop.value?.type === NodeTypes.TEXT ? prop.value.content.trim() : "";
+			if (tag) {
+				wrapper.tag = tag;
+				hasConfig = true;
+			} else context.warnings.push("slot-wrapper 需要提供非空标签名，已忽略该配置。");
+		} else if (isSlotFallbackWrapperAttr(prop.name, "slot-single-root-no-wrapper", slotName)) {
+			const value = normalizeBooleanAttributeValue(prop.value?.type === NodeTypes.TEXT ? prop.value.content.trim() : void 0);
+			if (value === void 0) context.warnings.push("slot-single-root-no-wrapper 仅支持 true / false 静态值，已忽略该配置。");
+			else {
+				wrapper.singleRootNoWrapper = value;
+				hasConfig = true;
+			}
+		} else if (isSlotFallbackWrapperAttr(prop.name, "slot-wrapper", slotName, "class")) {
+			const value = prop.value?.type === NodeTypes.TEXT ? prop.value.content.trim() : "";
+			if (value) {
+				wrapper.staticClass = value;
+				hasConfig = true;
+			}
+		} else if (isSlotFallbackWrapperAttr(prop.name, "slot-wrapper", slotName, "style")) {
+			const value = prop.value?.type === NodeTypes.TEXT ? prop.value.content.trim() : "";
+			if (value) {
+				wrapper.staticStyle = value;
+				hasConfig = true;
+			}
+		}
+	} else if (prop.type === NodeTypes.DIRECTIVE && prop.name === "bind" && prop.arg?.type === NodeTypes.SIMPLE_EXPRESSION) {
+		if (isSlotFallbackWrapperAttr(prop.arg.content, "slot-wrapper", slotName, "class")) {
+			const exp = getBindDirectiveExpression(prop);
+			if (exp) {
+				wrapper.dynamicClassExp = exp;
+				hasConfig = true;
+			}
+		} else if (isSlotFallbackWrapperAttr(prop.arg.content, "slot-wrapper", slotName, "style")) {
+			const exp = getBindDirectiveExpression(prop);
+			if (exp) {
+				wrapper.dynamicStyleExp = exp;
+				hasConfig = true;
+			}
+		}
+	}
+	return hasConfig ? wrapper : void 0;
+}
+function mergeLocalSlotFallbackWrapperConfig(base, override) {
+	if (!base) return override;
+	if (!override) return base;
+	return {
+		...base,
+		...override
+	};
+}
+function renderPlainSlotContentInSourceOrder(renderItems, plainSlotDeclarations, implicitDefaultDeclaration, ownerComponent, ownerComponentName, ownerWrapper, context, transformNode) {
 	const plainSlots = new Set(plainSlotDeclarations);
 	const shouldRenderImplicitDefault = implicitDefaultDeclaration ? plainSlots.has(implicitDefaultDeclaration) : false;
 	return renderItems.map((item) => {
-		if (item.type === "declaration") return plainSlots.has(item.declaration) ? renderSlotFallback(item.declaration, context, transformNode) : "";
+		if (item.type === "declaration") return plainSlots.has(item.declaration) ? renderSlotFallback(item.declaration, context, transformNode, {
+			component: ownerComponent,
+			componentName: ownerComponentName,
+			wrapper: ownerWrapper
+		}) : "";
 		return shouldRenderImplicitDefault ? transformNode(item.child, context) : "";
 	}).join("");
 }
@@ -7042,6 +7288,7 @@ function transformComponentWithSlots(node, context, transformNode, options) {
 	const extraAttrs = options?.extraAttrs ?? [];
 	const slotDeclarations = [];
 	const slotDirective = findSlotDirective(node);
+	const ownerWrapper = resolveLocalSlotFallbackWrapperConfig(node, context);
 	const nonTemplateChildren = [];
 	const renderItems = [];
 	for (const child of node.children) {
@@ -7050,7 +7297,10 @@ function transformComponentWithSlots(node, context, transformNode, options) {
 			if (templateSlot) {
 				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);
+				const declaration = buildSlotDeclaration(slotName, templateSlot.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? templateSlot.exp.content : void 0, child.children, context, {
+					...templateSlotCondition,
+					wrapper: mergeLocalSlotFallbackWrapperConfig(resolveLocalSlotFallbackWrapperConfig(node, context, slotName.type === "static" ? slotName.value : void 0), resolveLocalSlotFallbackWrapperConfig(child, context))
+				});
 				slotDeclarations.push(declaration);
 				renderItems.push({
 					type: "declaration",
@@ -7070,7 +7320,7 @@ function transformComponentWithSlots(node, context, transformNode, options) {
 	if (slotDirective) {
 		if (slotDeclarations.length) context.warnings.push("组件上的 v-slot 与 <template v-slot> 不能同时使用；仅使用组件上的 v-slot。");
 		slotDeclarations.length = 0;
-		slotDeclarations.push(buildSlotDeclaration(resolveSlotNameFromDirective(slotDirective), slotDirective.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? slotDirective.exp.content : void 0, node.children, context));
+		slotDeclarations.push(buildSlotDeclaration(resolveSlotNameFromDirective(slotDirective), slotDirective.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? slotDirective.exp.content : void 0, node.children, context, { wrapper: ownerWrapper }));
 	} else if (slotDeclarations.length && defaultSlotChildren.length) if (slotDeclarations.some((decl) => decl.name.type === "default" || decl.name.type === "static" && decl.name.value === "default")) context.warnings.push("存在显式的 v-slot:default，默认插槽内容将被忽略。");
 	else {
 		implicitDefaultDeclaration = buildSlotDeclaration({ type: "default" }, void 0, defaultSlotChildren, context, { implicitDefault: true });
@@ -7100,6 +7350,7 @@ function transformComponentWithSlots(node, context, transformNode, options) {
 	else plainSlotDeclarations.push(decl);
 	const slotNames = [];
 	const slotGenericAttrs = [];
+	const ownerComponentName = context.componentNameMap?.[node.tag];
 	for (const decl of scopedSlotDeclarations) {
 		const slotKey = resolveSlotKey(context, decl.name);
 		const { componentName } = createScopedSlotComponent(context, slotKey, decl.props, decl.children, transformNode, { hostComponentName: node.tag });
@@ -7132,13 +7383,18 @@ function transformComponentWithSlots(node, context, transformNode, options) {
 	}
 	const attrString = mergedAttrs.length ? ` ${mergedAttrs.join(" ")}` : "";
 	const { tag } = node;
-	const plainSlotContent = slotDirective ? plainSlotDeclarations.map((decl) => renderSlotFallback(decl, context, transformNode)).join("") : renderPlainSlotContentInSourceOrder(renderItems, plainSlotDeclarations, implicitDefaultDeclaration, context, transformNode);
+	const plainSlotContent = slotDirective ? plainSlotDeclarations.map((decl) => renderSlotFallback(decl, context, transformNode, {
+		component: node.tag,
+		componentName: ownerComponentName,
+		wrapper: ownerWrapper
+	})).join("") : renderPlainSlotContentInSourceOrder(renderItems, plainSlotDeclarations, implicitDefaultDeclaration, node.tag, ownerComponentName, ownerWrapper, context, transformNode);
 	return plainSlotContent ? `<${tag}${attrString}>${plainSlotContent}</${tag}>` : `<${tag}${attrString} />`;
 }
 function transformComponentWithSlotsFallback(node, context, transformNode, options) {
 	const extraAttrs = options?.extraAttrs ?? [];
 	const slotDeclarations = [];
 	const slotDirective = findSlotDirective(node);
+	const ownerWrapper = resolveLocalSlotFallbackWrapperConfig(node, context);
 	const nonTemplateChildren = [];
 	const renderItems = [];
 	for (const child of node.children) {
@@ -7147,7 +7403,10 @@ function transformComponentWithSlotsFallback(node, context, transformNode, optio
 			if (templateSlot) {
 				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);
+				const declaration = buildSlotDeclaration(slotName, templateSlot.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? templateSlot.exp.content : void 0, child.children, context, {
+					...templateSlotCondition,
+					wrapper: mergeLocalSlotFallbackWrapperConfig(resolveLocalSlotFallbackWrapperConfig(node, context, slotName.type === "static" ? slotName.value : void 0), resolveLocalSlotFallbackWrapperConfig(child, context))
+				});
 				slotDeclarations.push(declaration);
 				renderItems.push({
 					type: "declaration",
@@ -7167,7 +7426,7 @@ function transformComponentWithSlotsFallback(node, context, transformNode, optio
 	if (slotDirective) {
 		if (slotDeclarations.length) context.warnings.push("组件上的 v-slot 与 <template v-slot> 不能同时使用；仅使用组件上的 v-slot。");
 		slotDeclarations.length = 0;
-		slotDeclarations.push(buildSlotDeclaration(resolveSlotNameFromDirective(slotDirective), slotDirective.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? slotDirective.exp.content : void 0, node.children, context));
+		slotDeclarations.push(buildSlotDeclaration(resolveSlotNameFromDirective(slotDirective), slotDirective.exp?.type === NodeTypes.SIMPLE_EXPRESSION ? slotDirective.exp.content : void 0, node.children, context, { wrapper: ownerWrapper }));
 	} else if (slotDeclarations.length && defaultSlotChildren.length) if (slotDeclarations.some((decl) => decl.name.type === "default" || decl.name.type === "static" && decl.name.value === "default")) context.warnings.push("存在显式的 v-slot:default，默认插槽内容将被忽略。");
 	else {
 		implicitDefaultDeclaration = buildSlotDeclaration({ type: "default" }, void 0, defaultSlotChildren, context);
@@ -7188,7 +7447,11 @@ function transformComponentWithSlotsFallback(node, context, transformNode, optio
 		return children ? `<${tag}${attrString}>${children}</${tag}>` : `<${tag}${attrString} />`;
 	}
 	if (slotDeclarations.some((decl) => Object.keys(decl.props).length)) context.warnings.push("已禁用作用域插槽参数，插槽绑定将被忽略。");
-	const renderedSlots = slotDirective ? slotDeclarations.map((decl) => renderSlotFallback(decl, context, transformNode)).join("") : renderPlainSlotContentInSourceOrder(renderItems, slotDeclarations, implicitDefaultDeclaration, context, transformNode);
+	const renderedSlots = slotDirective ? slotDeclarations.map((decl) => renderSlotFallback(decl, context, transformNode, {
+		component: node.tag,
+		componentName: context.componentNameMap?.[node.tag],
+		wrapper: ownerWrapper
+	})).join("") : renderPlainSlotContentInSourceOrder(renderItems, slotDeclarations, implicitDefaultDeclaration, node.tag, context.componentNameMap?.[node.tag], ownerWrapper, context, transformNode);
 	const { attrs } = collectElementAttributes(node, context, {
 		skipSlotDirective: true,
 		forInfo: options?.forInfo,
@@ -7260,7 +7523,7 @@ function resolveConditionExpression$1(rawExpValue, context, hint) {
 	return (context.rewriteScopedSlot || shouldFallbackToRuntimeBinding(rawExpValue) ? registerRuntimeBindingExpression(rawExpValue, context, { hint }) : null) ?? normalizeWxmlExpressionWithContext(rawExpValue, context);
 }
 function resolveListExpression(rawExpValue, context, hint) {
-	return (shouldFallbackToRuntimeBinding(rawExpValue) ? registerRuntimeBindingExpression(rawExpValue, context, { hint }) : null) ?? normalizeWxmlExpressionWithContext(rawExpValue, context);
+	return (context.rewriteScopedSlot || shouldFallbackToRuntimeBinding(rawExpValue) ? registerRuntimeBindingExpression(rawExpValue, context, { hint }) : null) ?? normalizeWxmlExpressionWithContext(rawExpValue, context);
 }
 function transformIfElement(node, context, transformNode) {
 	const renderTemplateMustache = (exp) => renderMustache(exp, context);
@@ -7327,12 +7590,17 @@ function transformForElement(node, context, transformNode) {
 		};
 		const extraAttrs = listExp ? context.platform.forAttrs(listExp, renderTemplateMustache, forInfo.item, forInfo.index) : [];
 		if (elementWithoutFor.tag === "slot") {
+			const keyDirective = elementWithoutFor.props.find((prop) => {
+				return prop.type === NodeTypes.DIRECTIVE && prop.name === "bind" && prop.arg?.type === NodeTypes.SIMPLE_EXPRESSION && prop.arg.content === "key";
+			});
 			const content = transformSlotElement({
 				...elementWithoutFor,
 				props: elementWithoutFor.props.filter((prop) => {
-					return !(prop.type === NodeTypes.DIRECTIVE && prop.name === "bind" && prop.arg?.type === NodeTypes.SIMPLE_EXPRESSION && prop.arg.content === "key");
+					return prop !== keyDirective;
 				})
 			}, context, transformNode);
+			const keyAttr = keyDirective ? transformBindDirective(keyDirective, context, forInfo) : null;
+			if (keyAttr) extraAttrs.push(keyAttr);
 			const attrString = extraAttrs.length ? ` ${extraAttrs.join(" ")}` : "";
 			return attrString ? `<block${attrString}>${content}</block>` : content;
 		}
@@ -7494,6 +7762,18 @@ const HTML_VOID_TAGS = new Set([
 	"track",
 	"wbr"
 ]);
+function resolveSlotFallbackWrapperConfig(config) {
+	if (typeof config === "string") return {
+		tag: config || "view",
+		rules: []
+	};
+	return {
+		tag: config?.tag || "view",
+		attrs: config?.attrs,
+		singleRootNoWrapper: config?.singleRootNoWrapper,
+		rules: config?.rules ?? []
+	};
+}
 /**
 * 将 Vue 模板编译为 WXML。
 */
@@ -7504,6 +7784,7 @@ function compileVueTemplateToWxml(template, filename, options) {
 	const wxsExtension = options?.wxsExtension;
 	const scopedSlotsRequireProps = options?.scopedSlotsRequireProps ?? options?.scopedSlotsCompiler !== "augmented";
 	const slotSingleRootNoWrapper = options?.slotSingleRootNoWrapper ?? false;
+	const slotFallbackWrapper = resolveSlotFallbackWrapperConfig(options?.slotFallbackWrapper);
 	const htmlTagToWxmlMap = resolveHtmlTagToWxmlMap(options?.htmlTagToWxml);
 	try {
 		const ast = parse$1(template, {
@@ -7519,14 +7800,17 @@ function compileVueTemplateToWxml(template, filename, options) {
 			platform: options?.platform ?? getMiniProgramTemplatePlatform(),
 			propsAliases: options?.propsAliases,
 			propsDerivedKeys: options?.propsDerivedKeys,
+			scriptSetupBindings: options?.scriptSetupBindings,
 			htmlTagToWxmlMap,
 			htmlTagToWxmlTagClass: options?.htmlTagToWxmlTagClass ?? true,
 			scopedSlotsCompiler: options?.scopedSlotsCompiler ?? "auto",
 			scopedSlotsRequireProps,
 			slotSingleRootNoWrapper,
+			slotFallbackWrapper,
 			slotMultipleInstance: options?.slotMultipleInstance ?? true,
 			scopedSlotComponents: [],
 			componentGenerics: {},
+			componentNameMap: options?.componentNameMap,
 			scopeStack: [],
 			slotPropStack: [],
 			rewriteScopedSlot: false,
@@ -7593,6 +7877,49 @@ function isVueSfcSource(source) {
 function pascalToKebab(name) {
 	return name.replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").toLowerCase();
 }
+function extractStringPropertyFromObject(node, keyName) {
+	for (const property of node.properties) {
+		if (!t.isObjectProperty(property)) continue;
+		const key = property.key;
+		if (!(t.isIdentifier(key) ? key.name === keyName : t.isStringLiteral(key) ? key.value === keyName : false) || !t.isStringLiteral(property.value)) continue;
+		return property.value.value;
+	}
+}
+function extractStaticDefineOptionsName(scriptSetupContent) {
+	let ast;
+	try {
+		ast = parse$3(scriptSetupContent, BABEL_TS_MODULE_PARSER_OPTIONS);
+	} catch {
+		return;
+	}
+	let componentName;
+	traverse(ast, { CallExpression(path) {
+		if (componentName) return;
+		const callee = path.node.callee;
+		if (!t.isIdentifier(callee, { name: "defineOptions" })) return;
+		const arg = path.node.arguments[0];
+		if (!t.isObjectExpression(arg)) return;
+		componentName = extractStringPropertyFromObject(arg, "name");
+	} });
+	return componentName;
+}
+async function resolveVueSfcComponentName(resolvedId, warn) {
+	if (!resolvedId?.endsWith(".vue")) return;
+	try {
+		const { descriptor, errors } = parse(await readFile$1(resolvedId, "utf8"), { filename: resolvedId });
+		if (errors.length > 0 || !descriptor.scriptSetup?.content) return;
+		return extractStaticDefineOptionsName(descriptor.scriptSetup.content);
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		warn?.(`[Vue 编译] 解析 ${resolvedId} 的 defineOptions.name 失败：${message}`);
+		return;
+	}
+}
+function registerComponentName(result, tag, componentName) {
+	if (!componentName) return;
+	result.componentNameMap[tag] = componentName;
+	result.componentNameMap[pascalToKebab(tag)] = componentName;
+}
 function collectTemplateComponentNames(template, filename, warn) {
 	const warnHandler = resolveWarnHandler(warn);
 	const tags = collectVueTemplateTags(template, {
@@ -7651,6 +7978,10 @@ async function collectScriptSetupUsingComponents(options) {
 				from: removeExtensionDeep(importSource),
 				resolvedId: importSource
 			};
+			if (!resolved?.resolvedId && isVueSfcSource(importSource) && importSource.startsWith(".")) resolved = {
+				...resolved ?? {},
+				resolvedId: path.resolve(path.dirname(filename), importSource)
+			};
 			if (resolved?.from) {
 				result.autoUsingComponentsMap[localName] = resolved.from;
 				result.autoComponentMeta[localName] = resolved.from;
@@ -7659,6 +7990,7 @@ async function collectScriptSetupUsingComponents(options) {
 				result.wevuComponentTags.add(localName);
 				result.wevuComponentTags.add(pascalToKebab(localName));
 			}
+			registerComponentName(result, localName, await resolveVueSfcComponentName(resolved?.resolvedId, autoUsingComponents?.warn ?? compileOptions?.warn));
 		}
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
@@ -7687,13 +8019,17 @@ async function collectAutoImportWevuComponents(options) {
 			result.wevuComponentTags.add(tag);
 			if (resolved.name) result.wevuComponentTags.add(resolved.name);
 		}
+		const componentName = await resolveVueSfcComponentName(resolved.resolvedId, autoImportTags.warn ?? warn);
+		registerComponentName(result, tag, componentName);
+		if (resolved.name) registerComponentName(result, resolved.name, componentName);
 	}
 }
 async function collectComponentSourceInfo(options) {
 	const result = {
 		autoUsingComponentsMap: {},
 		autoComponentMeta: {},
-		wevuComponentTags: /* @__PURE__ */ new Set()
+		wevuComponentTags: /* @__PURE__ */ new Set(),
+		componentNameMap: {}
 	};
 	await collectScriptSetupUsingComponents({
 		descriptor: options.descriptor,
@@ -8577,18 +8913,22 @@ async function compileVueFile(source, filename, options) {
 		...options?.template,
 		propsAliases,
 		propsDerivedKeys,
+		scriptSetupBindings: scriptCompiled?.bindings,
 		scopedSlotsRequireProps: true
 	} : {
 		...options?.template,
 		propsAliases,
-		propsDerivedKeys
+		propsDerivedKeys,
+		scriptSetupBindings: scriptCompiled?.bindings
 	};
 	const templateOptions = componentSourceInfo.wevuComponentTags.size ? {
 		...baseTemplateOptions,
-		wevuComponentTags: componentSourceInfo.wevuComponentTags
+		wevuComponentTags: componentSourceInfo.wevuComponentTags,
+		componentNameMap: componentSourceInfo.componentNameMap
 	} : {
 		...baseTemplateOptions,
-		wevuComponentTags: []
+		wevuComponentTags: [],
+		componentNameMap: componentSourceInfo.componentNameMap
 	};
 	const templateCompiled = compileTemplatePhase(parsed.descriptor, filename, templateOptions, result);
 	const scriptPhase = await compileScriptPhase(parsed.descriptor, parsed.descriptorForCompile, filename, options, autoUsingComponents, templateCompiled, parsed.isAppFile, componentSourceInfo, scriptCompiled);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wevu/compiler",
   "type": "module",
-  "version": "6.16.24",
+  "version": "6.16.25",
   "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.9",
+    "@weapp-core/constants": "0.1.10",
     "@weapp-core/shared": "3.0.4",
-    "@weapp-vite/ast": "6.16.24",
+    "@weapp-vite/ast": "6.16.25",
     "rolldown-require": "2.0.17"
   },
   "publishConfig": {