weapp-vite 6.16.24 → 6.16.25

package/README.md

@@ -60,6 +60,8 @@ export default defineConfig({
   把 `div/span/img/a/h1...` 等常见 HTML 标签映射成小程序内置标签。
 - `weapp.vue.template.htmlTagToWxmlTagClass`
   默认开启。在映射发生时追加原标签名 class，例如 `h3 -> <view class="h3">`、`br -> <view class="br" />`，便于你自己写 CSS 低成本恢复默认外观；不需要时可设为 `false`。
+- `weapp.vue.template.slotFallbackWrapper`
+  配置普通具名插槽 fallback 的真实 wrapper，支持全局默认、按模板标签名 `component` / 子组件静态 `defineOptions({ name })` 的 `componentName` / slot 规则，以及组件内 `slot-wrapper` / `slot-wrapper-class` 静态覆盖。单个 slot 的局部策略更推荐写在对应的 `<template #xxx>` 上，例如 `<template #header slot-wrapper="cover-view">`。转发 `<slot />` 时不要使用 `<block slot="...">` 作为 wrapper，真实 DevTools 运行时会丢内容。
 
 ```vue
 <!-- App.vue -->

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { g as getRouteRuntimeGlobalKeys, i as getCompilerContext } from "./createContext-NXrQuj5y.mjs";
+import { g as getRouteRuntimeGlobalKeys, i as getCompilerContext } from "./createContext-D64s5KsN.mjs";
 //#region src/auto-routes.ts
 const ROUTE_RUNTIME_OVERRIDE_KEY = Symbol.for("weapp-vite.route-runtime");
 function createGetter(resolver) {

package/dist/cli.mjs

@@ -1,6 +1,6 @@
-import { C as createCjsConfigLoadError, E as isPathInside, S as parseCommentJson, T as shouldPassPlatformArgToIdeOpen, _ as createBuildScopeConfigFromCli, b as getProjectConfigFileName, f as resolveWeappViteTarget, h as resolveHmrProfileJsonPath, m as SHARED_CHUNK_VIRTUAL_PREFIX, n as syncProjectSupportFiles, p as createSharedBuildConfig, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, v as resolveWeappConfigFile, w as getDefaultIdeProjectRoot, x as loadViteConfigFile, y as checkRuntime } from "./createContext-NXrQuj5y.mjs";
+import { C as createCjsConfigLoadError, E as isPathInside, S as parseCommentJson, T as shouldPassPlatformArgToIdeOpen, _ as createBuildScopeConfigFromCli, b as getProjectConfigFileName, f as resolveWeappViteTarget, h as resolveHmrProfileJsonPath, m as SHARED_CHUNK_VIRTUAL_PREFIX, n as syncProjectSupportFiles, p as createSharedBuildConfig, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, v as resolveWeappConfigFile, w as getDefaultIdeProjectRoot, x as loadViteConfigFile, y as checkRuntime } from "./createContext-D64s5KsN.mjs";
 import { r as logger_default, t as colors } from "./logger-mt4mSTqV.mjs";
-import { h as VERSION } from "./file-C-eN8D-v.mjs";
+import { h as VERSION } from "./file-B8gSIRd0.mjs";
 import { o as resolveWeappMcpConfig, s as startWeappViteMcpServer } from "./mcp-qmDOTH07.mjs";
 import { createRequire } from "node:module";
 import path, { posix } from "pathe";
@@ -3708,7 +3708,7 @@ function resolveRunnableHotkeyDefinition(input) {
 }
 //#endregion
 //#region package.json
-var version = "6.16.24";
+var version = "6.16.25";
 //#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;

package/dist/{config-DBTZvwxw.d.mts → config-DJ3SOkf9.d.mts}

@@ -581,6 +581,19 @@ interface WeappVueTemplateConfig {
   scopedSlotsCompiler?: 'auto' | 'augmented' | 'off';
   scopedSlotsRequireProps?: boolean;
   slotSingleRootNoWrapper?: boolean;
+  slotFallbackWrapper?: string | {
+    tag?: string;
+    attrs?: Record<string, string>;
+    singleRootNoWrapper?: boolean;
+    rules?: Array<{
+      component?: string | RegExp | Array<string | RegExp>;
+      componentName?: string | RegExp | Array<string | RegExp>;
+      slot?: string | RegExp | Array<string | RegExp>;
+      tag?: string;
+      attrs?: Record<string, string>;
+      singleRootNoWrapper?: boolean;
+    }>;
+  };
   slotMultipleInstance?: boolean;
   classStyleRuntime?: 'auto' | 'wxs' | 'js';
   objectLiteralBindMode?: 'runtime' | 'inline';
@@ -1259,6 +1272,7 @@ interface LoadConfigResult {
   srcRoot: string;
   pluginOnly?: boolean;
   configFilePath?: string;
+  configFileDependencies: string[];
   currentSubPackageRoot?: string;
   weappWeb?: ResolvedWeappWebConfig;
   configMergeInfo?: ResolvedConfigMergeInfo;
@@ -1325,6 +1339,7 @@ interface ConfigService {
   readonly aliasEntries: ResolvedAlias[];
   readonly platform: MpPlatform$1;
   readonly configFilePath?: string;
+  readonly configFileDependencies: string[];
   readonly weappWebConfig?: ResolvedWeappWebConfig;
   readonly weappLibConfig?: ResolvedWeappLibConfig;
   readonly weappLibOutputMap?: Map<string, string>;
@@ -1509,6 +1524,7 @@ interface RuntimeState {
       dirtyEntrySet: Set<string>;
       dirtyEntryReasons: Map<string, 'direct' | 'dependency' | 'metadata'>;
       resolvedEntryMap: Map<string, ResolvedId>;
+      externalComponentEntryMap: Map<string, string>;
       entriesMap: Map<string, Entry | undefined>;
       layoutEntryDependents: Map<string, Set<string>>;
       entryLayoutDependencies: Map<string, Set<string>>;

package/dist/config.d.mts

@@ -1,2 +1,2 @@
-import { Bn as WeappViteHostMeta, Hn as createWeappViteHostMeta, Un as isWeappViteHost, Vn as applyWeappViteHostMeta, Wn as resolveWeappViteHostMeta, Yn as WeappViteRuntime, _ as definePageJson, a as UserConfigFnNoEnvPlain, at as WeappViteConfig, c as UserConfigFnPromise, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, l as defineConfig, m as Theme, n as UserConfigExport, o as UserConfigFnObject, p as Sitemap, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson, zn as WEAPP_VITE_HOST_NAME } from "./config-DBTZvwxw.mjs";
+import { Bn as WeappViteHostMeta, Hn as createWeappViteHostMeta, Un as isWeappViteHost, Vn as applyWeappViteHostMeta, Wn as resolveWeappViteHostMeta, Yn as WeappViteRuntime, _ as definePageJson, a as UserConfigFnNoEnvPlain, at as WeappViteConfig, c as UserConfigFnPromise, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, l as defineConfig, m as Theme, n as UserConfigExport, o as UserConfigFnObject, p as Sitemap, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson, zn as WEAPP_VITE_HOST_NAME } from "./config-DJ3SOkf9.mjs";
 export { type App, type Component, type Page, type Sitemap, type Theme, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnNoEnv, UserConfigFnNoEnvPlain, UserConfigFnObject, UserConfigFnObjectPlain, UserConfigFnPromise, WEAPP_VITE_HOST_NAME, type WeappViteConfig, WeappViteHostMeta, type WeappViteRuntime, applyWeappViteHostMeta, createWeappViteHostMeta, defineAppJson, defineComponentJson, defineConfig, definePageJson, defineSitemapJson, defineThemeJson, isWeappViteHost, resolveWeappViteHostMeta };

package/dist/{createContext-NXrQuj5y.mjs → createContext-D64s5KsN.mjs}

@@ -1,6 +1,6 @@
 import { n as applyWeappViteHostMeta } from "./pluginHost--CaeyWpA.mjs";
 import { n as configureLogger, r as logger_default } from "./logger-mt4mSTqV.mjs";
-import { _ as jsExtensions, a as findJsonEntry, b as vueExtensions, c as isJsOrTs, d as touch, g as configExtensions, i as findJsEntry, l as isTemplate, n as changeFileExtension, o as findTemplateEntry, p as inlineAutoRoutesImports, r as findCssEntry, s as findVueEntry, t as extractConfigFromVue, v as supportedCssLangs, y as templateExtensions } from "./file-C-eN8D-v.mjs";
+import { _ as jsExtensions, a as findJsonEntry, b as vueExtensions, c as isJsOrTs, d as touch, g as configExtensions, i as findJsEntry, l as isTemplate, n as changeFileExtension, o as findTemplateEntry, p as inlineAutoRoutesImports, r as findCssEntry, s as findVueEntry, t as extractConfigFromVue, v as supportedCssLangs, y as templateExtensions } from "./file-B8gSIRd0.mjs";
 import { createRequire, isBuiltin } from "node:module";
 import path, { posix } from "pathe";
 import path$1, { normalize, relative, win32 } from "node:path";
@@ -9169,6 +9169,13 @@ function assertModuleScopedToRoot(options) {
 }
 //#endregion
 //#region src/runtime/chunkStrategy/sourcemap.ts
+function isSourceLike(source) {
+	return typeof source === "string" || source instanceof Uint8Array || Buffer.isBuffer(source);
+}
+function cloneSourceLike(source) {
+	if (typeof source === "string") return source;
+	return Buffer.from(source);
+}
 function collectSourceMapKeys(fileName, chunk) {
 	const keys = /* @__PURE__ */ new Set();
 	if (fileName) keys.add(`${fileName}.map`);
@@ -9196,11 +9203,12 @@ function resolveSourceMapSource(originalMap, assetSource) {
 function emitSourceMapAsset(ctx, targetFileName, sourceMapAssetInfo, fallbackSource) {
 	if (!targetFileName) return;
 	if (sourceMapAssetInfo?.asset && isSourceLike(sourceMapAssetInfo.asset.source)) {
+		const [name] = sourceMapAssetInfo.asset.names ?? [];
 		ctx.emitFile({
 			type: "asset",
 			fileName: targetFileName,
 			source: cloneSourceLike(sourceMapAssetInfo.asset.source),
-			name: sourceMapAssetInfo.asset.name
+			...name ? { name } : {}
 		});
 		return;
 	}
@@ -9210,13 +9218,6 @@ function emitSourceMapAsset(ctx, targetFileName, sourceMapAssetInfo, fallbackSou
 		source: cloneSourceLike(fallbackSource)
 	});
 }
-function isSourceLike(source) {
-	return typeof source === "string" || source instanceof Uint8Array || Buffer.isBuffer(source);
-}
-function cloneSourceLike(source) {
-	if (typeof source === "string") return source;
-	return Buffer.from(source);
-}
 //#endregion
 //#region src/runtime/chunkStrategy/apply/runtime.ts
 const ROLLDOWN_RUNTIME_FILE_NAME$2 = "rolldown-runtime.js";
@@ -11948,6 +11949,23 @@ function shouldReuseLoadedWeappConfig(weappConfigFilePath, loadedPath) {
 	if (!weappConfigFilePath || !loadedPath) return false;
 	return path.resolve(loadedPath) === path.resolve(weappConfigFilePath);
 }
+function collectConfigFileDependencies(cwd, ...entries) {
+	const dependencySet = /* @__PURE__ */ new Set();
+	const add = (filePath) => {
+		if (!filePath) return;
+		dependencySet.add(path.isAbsolute(filePath) ? path.normalize(filePath) : path.resolve(cwd, filePath));
+	};
+	for (const entry of entries) {
+		if (!entry) continue;
+		if (typeof entry === "string") {
+			add(entry);
+			continue;
+		}
+		add(entry.path);
+		for (const dependency of entry.dependencies ?? []) add(dependency);
+	}
+	return Array.from(dependencySet);
+}
 function injectDefaultSrcAlias(config, cwd, srcRoot) {
 	if (!srcRoot) return;
 	const resolve = config.resolve ?? (config.resolve = {});
@@ -12192,6 +12210,7 @@ function createLoadConfig(options) {
 			}
 		}
 		const configFilePath = weappLoaded?.path ?? loaded?.path ?? resolvedConfigFile;
+		const configFileDependencies = collectConfigFileDependencies(cwd, loaded, weappLoaded, resolvedConfigFile);
 		const configMergeInfo = loaded?.path && weappLoaded?.path && !shouldReuseLoadedWeappConfig(weappLoaded.path, loaded.path) ? {
 			merged: true,
 			viteConfigPath: loaded.path,
@@ -12227,6 +12246,7 @@ function createLoadConfig(options) {
 			srcRoot,
 			pluginOnly,
 			configFilePath,
+			configFileDependencies,
 			currentSubPackageRoot: void 0,
 			weappWeb: resolvedWebConfig,
 			weappLib: resolvedLibConfig,
@@ -15022,7 +15042,7 @@ function addNormalizedWatchFile(pluginCtx, file) {
 }
 function addNormalizedWatchFiles(pluginCtx, files) {
 	let count = 0;
-	for (const file of files) if (addNormalizedWatchFile(pluginCtx, file)) count += 1;
+	for (const file of files ?? []) if (addNormalizedWatchFile(pluginCtx, file)) count += 1;
 	return count;
 }
 //#endregion
@@ -15320,7 +15340,7 @@ function prepareNormalizedEntries(options) {
 	return normalizedEntries;
 }
 async function emitEntryOutput(options) {
-	const { pluginCtx, id, type, json: initialJson, jsonPath, templatePath, isPluginBuild, normalizedEntries, pluginResolvedRecords, pluginJsonPathForRegistration, pluginJsonForRegistration, resolveEntriesWithCache, entryResolveRoot, configService, wxmlService, resolvedEntryMap, loadedEntrySet, dirtyEntrySet, forceEmitEntrySet, replaceLayoutDependencies, emitEntriesChunks, registerJsonAsset, existsCache, pathExistsTtlMs, debug, relativeCwdId, getTime, emittedWxmlCodeCache } = options;
+	const { pluginCtx, id, type, json: initialJson, jsonPath, templatePath, isPluginBuild, normalizedEntries, pluginResolvedRecords, pluginJsonPathForRegistration, pluginJsonForRegistration, resolveEntriesWithCache, resolveMappedEntry, entryResolveRoot, configService, wxmlService, resolvedEntryMap, loadedEntrySet, dirtyEntrySet, forceEmitEntrySet, replaceLayoutDependencies, emitEntriesChunks, registerJsonAsset, existsCache, pathExistsTtlMs, debug, relativeCwdId, getTime, emittedWxmlCodeCache } = options;
 	let json = initialJson;
 	async function emitNativeLayoutAssets(layoutBasePath) {
 		if (typeof pluginCtx.emitFile !== "function") return;
@@ -15393,7 +15413,10 @@ async function emitEntryOutput(options) {
 		});
 	}
 	const shouldSkipEntries = Boolean(options.skipEntries);
-	const resolvedIds = shouldSkipEntries ? [] : normalizedEntries.length ? await resolveEntriesWithCache(pluginCtx, normalizedEntries, entryResolveRoot) : [];
+	const resolvedIds = shouldSkipEntries ? [] : normalizedEntries.length ? await resolveEntriesWithCache(pluginCtx, normalizedEntries, entryResolveRoot, {
+		fallbackRoots: [configService.cwd],
+		resolveMappedEntry
+	}) : [];
 	debug?.(`resolvedIds ${relativeCwdId} 耗时 ${getTime()}`);
 	const pendingResolvedIds = [];
 	const combinedResolved = shouldSkipEntries ? [] : pluginResolvedRecords ? isPluginBuild ? pluginResolvedRecords : [...resolvedIds, ...pluginResolvedRecords] : resolvedIds;
@@ -15491,11 +15514,22 @@ function createEntryResolver(configService) {
 		if (resolvedId || !configService?.isDev) entryResolutionCache.set(normalized, resolvedId);
 		return resolvedId;
 	}
-	async function resolveEntriesWithCache(pluginCtx, entries, absoluteRoot) {
+	async function resolveEntriesWithCache(pluginCtx, entries, absoluteRoot, options) {
 		return Promise.all(entries.filter((entry) => !entry.includes(":")).map(async (entry) => {
+			const cleanedEntry = entry.replace(LEADING_ROOT_SLASH_RE, "");
+			const mappedEntry = options?.resolveMappedEntry?.(cleanedEntry);
+			if (mappedEntry) return {
+				entry,
+				resolvedId: await resolveEntryWithCache(pluginCtx, mappedEntry)
+			};
+			let resolvedId = await resolveEntryWithCache(pluginCtx, path.isAbsolute(entry) && await fs.pathExists(entry) ? entry : path.resolve(absoluteRoot, cleanedEntry));
+			if (!resolvedId) for (const fallbackRoot of options?.fallbackRoots ?? []) {
+				resolvedId = await resolveEntryWithCache(pluginCtx, path.resolve(fallbackRoot, cleanedEntry));
+				if (resolvedId) break;
+			}
 			return {
 				entry,
-				resolvedId: await resolveEntryWithCache(pluginCtx, path.isAbsolute(entry) && await fs.pathExists(entry) ? entry : path.resolve(absoluteRoot, entry.replace(LEADING_ROOT_SLASH_RE, "")))
+				resolvedId
 			};
 		}));
 	}
@@ -15604,7 +15638,7 @@ async function scanTemplateEntry(pluginCtx, id, scanTemplateEntryFn, existsCache
 	return ensureTemplateScanned(pluginCtx, id, scanTemplateEntryFn, existsCache, ttlMs);
 }
 async function applyScriptSetupUsingComponents(options) {
-	const { pluginCtx, vueEntryPath, templatePath, json, configService, wxmlService, reExportResolutionCache } = options;
+	const { pluginCtx, vueEntryPath, templatePath, json, configService, wxmlService, reExportResolutionCache, externalComponentEntryMap } = options;
 	try {
 		const { descriptor, errors } = await readAndParseSfc(vueEntryPath, { ...createReadAndParseSfcOptions(pluginCtx, configService) });
 		if (!errors?.length && descriptor?.template && !templatePath) {
@@ -15625,16 +15659,18 @@ async function applyScriptSetupUsingComponents(options) {
 				if (imports.length) {
 					const usingComponents = json && typeof json.usingComponents === "object" && json.usingComponents && !Array.isArray(json.usingComponents) ? json.usingComponents : {};
 					for (const { localName, importSource, importedName, kind } of imports) {
-						let { from } = await resolveUsingComponentReference(pluginCtx, configService, reExportResolutionCache, importSource, vueEntryPath, {
+						const resolved = await resolveUsingComponentReference(pluginCtx, configService, reExportResolutionCache, importSource, vueEntryPath, {
 							localName,
 							kind,
 							importedName,
 							fallbackRelativeImporterDir: true
 						});
+						let { from } = resolved;
 						if (!from && importSource.startsWith("/")) from = removeExtensionDeep(importSource);
 						if (!from) continue;
 						if (Reflect.has(usingComponents, localName) && usingComponents[localName] !== from) logger_default.warn(`[自动 usingComponents] 冲突：${vueEntryPath} 中 usingComponents['${localName}']='${usingComponents[localName]}' 将被 <script setup> 导入覆盖为 '${from}'`);
 						usingComponents[localName] = from;
+						if (resolved.resolvedId) externalComponentEntryMap?.set(removeExtensionDeep(from).replace(/^\/+/, ""), resolved.resolvedId);
 					}
 					json.usingComponents = usingComponents;
 				}
@@ -15830,7 +15866,8 @@ function createEntryLoader(options) {
 					json,
 					configService,
 					wxmlService,
-					reExportResolutionCache
+					reExportResolutionCache,
+					externalComponentEntryMap: ctx.runtimeState.build.hmr.externalComponentEntryMap
 				});
 				if (type === "page") {
 					const vueSource = await readVueSource();
@@ -15902,6 +15939,7 @@ function createEntryLoader(options) {
 			pluginJsonPathForRegistration,
 			pluginJsonForRegistration,
 			resolveEntriesWithCache: entryResolver.resolveEntriesWithCache,
+			resolveMappedEntry: (entry) => ctx.runtimeState.build.hmr.externalComponentEntryMap.get(entry),
 			entryResolveRoot,
 			configService,
 			wxmlService,
@@ -17634,7 +17672,7 @@ function injectRequestGlobalsIntoSfc(source, targets, options) {
 //#endregion
 //#region src/plugins/outputFinalizer.ts
 const PREPROCESSOR_STYLE_ASSET_RE = /\.(?:less|sass|scss|styl|stylus|pcss|postcss|sss)$/i;
-function normalizePreprocessorStyleAssets(bundle, styleExtension) {
+function normalizePreprocessorStyleAssets(bundle, styleExtension, emitAsset) {
 	if (!styleExtension) return;
 	for (const [bundleFileName, output] of Object.entries(bundle)) {
 		if (output?.type !== "asset") continue;
@@ -17646,7 +17684,15 @@ function normalizePreprocessorStyleAssets(bundle, styleExtension) {
 		delete bundle[bundleFileName];
 		if (existingOutput) continue;
 		output.fileName = outputFileName;
-		bundle[outputFileName] = output;
+		const [name] = output.names ?? [];
+		const [originalFileName] = output.originalFileNames ?? [];
+		emitAsset({
+			type: "asset",
+			fileName: outputFileName,
+			...name ? { name } : {},
+			...originalFileName ? { originalFileName } : {},
+			source: output.source
+		});
 	}
 }
 function createOutputFinalizerPlugin(ctx) {
@@ -17654,7 +17700,7 @@ function createOutputFinalizerPlugin(ctx) {
 		name: "weapp-vite:output-finalizer",
 		enforce: "post",
 		generateBundle(_options, bundle) {
-			normalizePreprocessorStyleAssets(bundle, ctx.configService.outputExtensions?.wxss);
+			normalizePreprocessorStyleAssets(bundle, ctx.configService.outputExtensions?.wxss, (asset) => this.emitFile(asset));
 		}
 	};
 }
@@ -18806,7 +18852,7 @@ function createGenerateBundleHook(state, isPluginBuild) {
 				});
 				rewriteJsonNpmImportsToLocalRoot(rolldownBundle, "", void 0, npmBuildCandidateDependencies, configService.cwd);
 			}
-			normalizePreprocessorStyleAssets(rolldownBundle, state.ctx.configService.outputExtensions?.wxss);
+			normalizePreprocessorStyleAssets(rolldownBundle, state.ctx.configService.outputExtensions?.wxss, (asset) => this.emitFile(asset));
 			return;
 		}
 		if (!subPackageMeta) {
@@ -18968,7 +19014,7 @@ function createGenerateBundleHook(state, isPluginBuild) {
 		stabilizeWevuRuntimeChunkAccess(rolldownBundle);
 		syncChunkImportsFromRequireCalls(rolldownBundle);
 		prunePartialHmrStableSharedChunks(rolldownBundle, state);
-		normalizePreprocessorStyleAssets(rolldownBundle, state.ctx.configService.outputExtensions?.wxss);
+		normalizePreprocessorStyleAssets(rolldownBundle, state.ctx.configService.outputExtensions?.wxss, (asset) => this.emitFile(asset));
 		refreshModuleGraph(this, state);
 		if (configService.weappViteConfig?.debug?.watchFiles) {
 			const watcherService = ctx.watcherService;
@@ -19375,13 +19421,14 @@ function resolveInjectWeapiOptions(configService) {
 	if (!(typeof injectWeapi === "object" ? injectWeapi.enabled === true : injectWeapi === true) || typeof injectWeapi !== "object" || injectWeapi.replaceWx !== true) return null;
 	return { globalName: injectWeapi.globalName?.trim() || "wpi" };
 }
-function shouldTransformId(id, absoluteSrcRoot) {
+function shouldTransformId(id, options) {
 	if (isCSSRequest(id)) return false;
 	if (parseRequest(id).query.type === "style") return false;
 	const sourceId = normalizeFsResolvedId(id);
-	if (!sourceId || sourceId.includes("/node_modules/")) return false;
-	if (sourceId === absoluteSrcRoot) return true;
-	return sourceId.startsWith(`${absoluteSrcRoot}/`);
+	if (!sourceId) return false;
+	if (sourceId === options.absoluteSrcRoot) return true;
+	if (sourceId.startsWith(`${options.absoluteSrcRoot}/`)) return true;
+	return options.isEntry?.(sourceId) === true;
 }
 //#endregion
 //#region src/plugins/core/lifecycle/transform/index.ts
@@ -19419,7 +19466,10 @@ function createTransformHook(state) {
 	}
 	return async function transform(code, id) {
 		const injectOptions = resolveInjectWeapiOptions(configService);
-		if (!shouldTransformId(id, configService.absoluteSrcRoot)) return null;
+		if (!shouldTransformId(id, {
+			absoluteSrcRoot: configService.absoluteSrcRoot,
+			isEntry: (sourceId) => state.loadedEntrySet?.has(sourceId) === true || state.resolvedEntryMap?.has(sourceId) === true
+		})) return null;
 		const startedAt = performance.now();
 		try {
 			const sourceId = normalizeFsResolvedId(id);
@@ -19868,11 +19918,14 @@ function createBuildStartHook(state) {
 	const isPluginBuild = buildTarget === "plugin";
 	return async function buildStart() {
 		resetTakeImportRegistry({ preserveSharedChunkNameCache: configService.isDev });
-		if (configService.isDev) if (isPluginBuild) {
-			if (configService.absolutePluginRoot) ensureSidecarWatcher(ctx, configService.absolutePluginRoot);
-		} else {
-			ensureSidecarWatcher(ctx, subPackageMeta ? path.resolve(configService.absoluteSrcRoot, subPackageMeta.subPackage.root) : configService.absoluteSrcRoot);
-			if (!subPackageMeta && configService.absolutePluginRoot) ensureSidecarWatcher(ctx, configService.absolutePluginRoot);
+		if (configService.isDev) {
+			addNormalizedWatchFiles(this, configService.configFileDependencies);
+			if (isPluginBuild) {
+				if (configService.absolutePluginRoot) ensureSidecarWatcher(ctx, configService.absolutePluginRoot);
+			} else {
+				ensureSidecarWatcher(ctx, subPackageMeta ? path.resolve(configService.absoluteSrcRoot, subPackageMeta.subPackage.root) : configService.absoluteSrcRoot);
+				if (!subPackageMeta && configService.absolutePluginRoot) ensureSidecarWatcher(ctx, configService.absolutePluginRoot);
+			}
 		}
 		await emitDirtyEntries.call(this);
 	};
@@ -20966,6 +21019,7 @@ function buildCompileVueFileOptions(ctx, pluginCtx, vuePath, isPage, isApp, conf
 	const scopedSlotsCompiler = configService.weappViteConfig?.vue?.template?.scopedSlotsCompiler ?? "auto";
 	const scopedSlotsRequireProps = configService.weappViteConfig?.vue?.template?.scopedSlotsRequireProps ?? false;
 	const slotSingleRootNoWrapper = configService.weappViteConfig?.vue?.template?.slotSingleRootNoWrapper ?? false;
+	const slotFallbackWrapper = configService.weappViteConfig?.vue?.template?.slotFallbackWrapper;
 	const slotMultipleInstance = configService.weappViteConfig?.vue?.template?.slotMultipleInstance ?? true;
 	const htmlTagToWxml = configService.weappViteConfig?.vue?.template?.htmlTagToWxml;
 	const htmlTagToWxmlTagClass = configService.weappViteConfig?.vue?.template?.htmlTagToWxmlTagClass ?? true;
@@ -21056,6 +21110,7 @@ function buildCompileVueFileOptions(ctx, pluginCtx, vuePath, isPage, isApp, conf
 			scopedSlotsCompiler,
 			scopedSlotsRequireProps,
 			slotSingleRootNoWrapper,
+			slotFallbackWrapper,
 			slotMultipleInstance,
 			classStyleRuntime: templatePlatformOptions.classStyleRuntime,
 			objectLiteralBindMode,
@@ -23116,10 +23171,10 @@ function createAbsolutePathPattern(value) {
 	return value.split(PATH_SEPARATOR_SPLIT_REGEX).map((segment) => escapeRegex(segment)).join("[/\\\\]+");
 }
 function normalizeInlineConfigAfterDefu(inline, options) {
-	const { ctx, platform, rolldownOptions, subPackageMeta } = options;
+	const { cwd, ctx, platform, rolldownOptions, subPackageMeta } = options;
 	const build = inline.build ?? (inline.build = {});
 	const userRolldownOptions = build.rolldownOptions;
-	build.rolldownOptions = {
+	const mergedRolldownOptions = {
 		...userRolldownOptions ?? {},
 		...rolldownOptions,
 		output: {
@@ -23127,6 +23182,9 @@ function normalizeInlineConfigAfterDefu(inline, options) {
 			...userRolldownOptions?.output ?? {}
 		}
 	};
+	const rootTsconfig = path.resolve(cwd, "tsconfig.json");
+	if (!Object.prototype.hasOwnProperty.call(mergedRolldownOptions, "tsconfig") && !mergedRolldownOptions.resolve?.tsconfigFilename && existsSync(rootTsconfig)) mergedRolldownOptions.tsconfig = rootTsconfig;
+	build.rolldownOptions = mergedRolldownOptions;
 	inline.define = {
 		...inline.define ?? {},
 		__VITE_IS_MODERN__: "false"
@@ -23137,16 +23195,25 @@ function normalizeInlineConfigAfterDefu(inline, options) {
 }
 function resolveMiniprogramWatchInclude(options) {
 	const srcRoot = path.join(options.cwd, options.srcRoot);
-	const watchInclude = options.buildScope?.enabled ? [...options.buildScope.includeMainPackage ? [path.join(srcRoot, "pages", "**")] : [], ...options.buildScope.subPackageRoots.map((root) => path.join(srcRoot, root, "**"))] : [path.join(srcRoot, "**")];
-	if (!options.pluginRoot) return watchInclude;
-	const absolutePluginRoot = path.resolve(options.cwd, options.pluginRoot);
-	const relativeToSrc = path.relative(path.resolve(options.cwd, options.srcRoot), absolutePluginRoot);
-	const pluginPatternBase = relativeToSrc.startsWith("..") ? absolutePluginRoot : path.join(options.cwd, options.srcRoot, relativeToSrc);
-	watchInclude.push(path.join(pluginPatternBase, "**"));
-	return watchInclude;
+	const watchInclude = ["**", ...options.buildScope?.enabled ? [...options.buildScope.includeMainPackage ? [path.join(srcRoot, "pages", "**")] : [], ...options.buildScope.subPackageRoots.map((root) => path.join(srcRoot, root, "**"))] : [path.join(srcRoot, "**")]];
+	if (options.pluginRoot) {
+		const absolutePluginRoot = path.resolve(options.cwd, options.pluginRoot);
+		const relativeToSrc = path.relative(path.resolve(options.cwd, options.srcRoot), absolutePluginRoot);
+		const pluginPatternBase = relativeToSrc.startsWith("..") ? absolutePluginRoot : path.join(options.cwd, options.srcRoot, relativeToSrc);
+		watchInclude.push(path.join(pluginPatternBase, "**"));
+	}
+	for (const dependency of options.configFileDependencies ?? []) watchInclude.push(dependency);
+	const userInclude = Array.isArray(options.userInclude) ? options.userInclude : options.userInclude ? [options.userInclude] : [];
+	const seen = /* @__PURE__ */ new Set();
+	return [...userInclude, ...watchInclude].filter((item) => {
+		if (typeof item !== "string") return true;
+		if (seen.has(item)) return false;
+		seen.add(item);
+		return true;
+	});
 }
 function mergeMiniprogram(options, ...configs) {
-	const { ctx, subPackageMeta, config, cwd, srcRoot, mpDistRoot, packageJson, isDev, applyRuntimePlatform, injectBuiltinAliases, getDefineImportMetaEnv, setOptions, oxcRolldownPlugin } = options;
+	const { ctx, subPackageMeta, config, cwd, srcRoot, mpDistRoot, configFileDependencies = [], packageJson, isDev, applyRuntimePlatform, injectBuiltinAliases, getDefineImportMetaEnv, setOptions, oxcRolldownPlugin } = options;
 	const platform = ctx.configService?.platform;
 	applyRuntimePlatform("miniprogram");
 	const createMiniprogramCustomLogger = () => {
@@ -23181,7 +23248,8 @@ function mergeMiniprogram(options, ...configs) {
 			cwd,
 			srcRoot,
 			pluginRoot: config.weapp?.pluginRoot,
-			buildScope: resolveBuildScope(config.weapp?.buildScope)
+			buildScope: resolveBuildScope(config.weapp?.buildScope),
+			configFileDependencies
 		});
 		const inline = defu(config, ...configs, {
 			root: cwd,
@@ -23202,6 +23270,7 @@ function mergeMiniprogram(options, ...configs) {
 			}
 		});
 		normalizeInlineConfigAfterDefu(inline, {
+			cwd,
 			ctx,
 			platform,
 			rolldownOptions,
@@ -23222,6 +23291,7 @@ function mergeMiniprogram(options, ...configs) {
 		}
 	});
 	normalizeInlineConfigAfterDefu(inlineConfig, {
+		cwd,
 		ctx,
 		platform,
 		rolldownOptions,
@@ -23348,6 +23418,7 @@ function createMergeFactories(options) {
 			cwd: currentOptions.cwd,
 			srcRoot: currentOptions.srcRoot,
 			mpDistRoot: currentOptions.mpDistRoot,
+			configFileDependencies: currentOptions.configFileDependencies,
 			packageJson: currentOptions.packageJson,
 			isDev: currentOptions.isDev,
 			applyRuntimePlatform,
@@ -23466,6 +23537,12 @@ function createConfigService(ctx) {
 		}
 		return normalizedRelative;
 	};
+	const resolveExternalOutputPath = (filePath) => {
+		const normalizedPath = normalizeComparablePath(filePath);
+		const normalizedDir = path.dirname(normalizedPath);
+		const dirHash = createHash("sha256").update(normalizedDir).digest("hex").slice(0, 10);
+		return normalizeRelativePath$1(path.join("__weapp_vite_external__", dirHash, path.basename(normalizedPath)));
+	};
 	function setOptions(value) {
 		options = value;
 		configState.options = value;
@@ -23546,7 +23623,8 @@ function createConfigService(ctx) {
 			multiPlatform: resolveMultiPlatformConfig(false),
 			configFilePath: void 0,
 			currentSubPackageRoot: void 0,
-			weappWeb: void 0
+			weappWeb: void 0,
+			configFileDependencies: []
 		});
 		setOptions(resolvedConfig);
 		configureLogger(resolvedConfig.config.weapp?.logger);
@@ -23682,6 +23760,9 @@ function createConfigService(ctx) {
 		get configFilePath() {
 			return options.configFilePath;
 		},
+		get configFileDependencies() {
+			return options.configFileDependencies;
+		},
 		get weappWebConfig() {
 			return options.weappWeb;
 		},
@@ -23717,6 +23798,7 @@ function createConfigService(ctx) {
 		relativeOutputPath(p) {
 			const relative = this.relativeAbsoluteSrcRoot(p);
 			if (!relative) return relative;
+			if (relative.startsWith("..") || relative === "node_modules" || relative.startsWith("node_modules/")) return resolveExternalOutputPath(p);
 			const libOutputMap = options.weappLibOutputMap;
 			if (libOutputMap && libOutputMap.size > 0) {
 				const base = normalizeRelativePath$1(removeExtensionDeep(relative));
@@ -23943,6 +24025,7 @@ function createDefaultLoadConfigResult() {
 		platform: DEFAULT_MP_PLATFORM,
 		srcRoot: "",
 		configFilePath: void 0,
+		configFileDependencies: [],
 		weappWeb: void 0,
 		configMergeInfo: void 0
 	};
@@ -23995,6 +24078,7 @@ function createRuntimeState() {
 				dirtyEntrySet: /* @__PURE__ */ new Set(),
 				dirtyEntryReasons: /* @__PURE__ */ new Map(),
 				resolvedEntryMap: /* @__PURE__ */ new Map(),
+				externalComponentEntryMap: /* @__PURE__ */ new Map(),
 				entriesMap: /* @__PURE__ */ new Map(),
 				layoutEntryDependents: /* @__PURE__ */ new Map(),
 				entryLayoutDependencies: /* @__PURE__ */ new Map(),
@@ -24189,7 +24273,7 @@ async function loadAppEntry(ctx, scanState) {
 	const vueAppPath = await findVueEntry(appBasename);
 	let configFromVue;
 	if (!appConfigFile && vueAppPath) {
-		const { extractConfigFromVue } = await import("./file-S0TAbkhK.mjs");
+		const { extractConfigFromVue } = await import("./file-Cjctfg-V.mjs");
 		configFromVue = await extractConfigFromVue(vueAppPath);
 		if (configFromVue) appConfigFile = vueAppPath;
 	}

package/dist/docs/README.md

@@ -60,6 +60,8 @@ export default defineConfig({
   把 `div/span/img/a/h1...` 等常见 HTML 标签映射成小程序内置标签。
 - `weapp.vue.template.htmlTagToWxmlTagClass`
   默认开启。在映射发生时追加原标签名 class，例如 `h3 -> <view class="h3">`、`br -> <view class="br" />`，便于你自己写 CSS 低成本恢复默认外观；不需要时可设为 `false`。
+- `weapp.vue.template.slotFallbackWrapper`
+  配置普通具名插槽 fallback 的真实 wrapper，支持全局默认、按模板标签名 `component` / 子组件静态 `defineOptions({ name })` 的 `componentName` / slot 规则，以及组件内 `slot-wrapper` / `slot-wrapper-class` 静态覆盖。单个 slot 的局部策略更推荐写在对应的 `<template #xxx>` 上，例如 `<template #header slot-wrapper="cover-view">`。转发 `<slot />` 时不要使用 `<block slot="...">` 作为 wrapper，真实 DevTools 运行时会丢内容。
 
 ```vue
 <!-- App.vue -->

package/dist/docs/vue-sfc.md

@@ -67,6 +67,225 @@
 <view class="br" />
 ```
 
+## 具名插槽透传 wrapper
+
+当你把当前组件的 `<slot />` 转发到子组件的具名插槽时：
+
+```vue
+<IssueCard>
+  <template #header>
+    <slot />
+  </template>
+</IssueCard>
+```
+
+编译器会使用真实节点 wrapper，默认类似：
+
+```wxml
+<view slot="header">
+  <slot />
+</view>
+```
+
+不要改成 `<block slot="header"><slot /></block>`。真实 WeChat DevTools 运行时里，这种写法会出现宿主 header，但转发内容不会渲染。
+
+如果需要自定义 wrapper，可以在组件使用处写静态属性。组件内配置推荐使用普通 kebab-case 静态属性，避免和 Vue 指令参数语法混淆。
+
+`slot-wrapper` 是当前组件所有普通具名插槽的默认 wrapper：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header>
+      <slot />
+    </template>
+    <template #footer>
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物：
+
+```wxml
+<IssueCard>
+  <cover-view slot="header">
+    <slot />
+  </cover-view>
+  <cover-view slot="footer">
+    <slot name="footer" />
+  </cover-view>
+</IssueCard>
+```
+
+`slot-wrapper-<slotName>` 只覆盖指定具名插槽；单个 slot 的覆盖更推荐直接写在对应的 `<template #xxx>` 上：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header>
+      <slot />
+    </template>
+    <template #footer slot-wrapper="view">
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物中 `header` 使用 `slot-wrapper="cover-view"`，`footer` 在对应的 `<template #footer>` 上覆盖：
+
+```wxml
+<IssueCard>
+  <cover-view slot="header">
+    <slot />
+  </cover-view>
+  <view slot="footer">
+    <slot name="footer" />
+  </view>
+</IssueCard>
+```
+
+只覆盖单个 slot 时，更推荐把配置写在对应的 `<template #xxx>` 上。这个写法最靠近 slot 内容，优先级高于父组件标签上的默认值和 `slot-wrapper-<slotName>`：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header slot-wrapper="text" slot-wrapper-class="slot-header">
+      <slot />
+    </template>
+    <template #footer>
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物：
+
+```wxml
+<IssueCard>
+  <text slot="header" class="slot-header">
+    <slot />
+  </text>
+  <cover-view slot="footer">
+    <slot name="footer" />
+  </cover-view>
+</IssueCard>
+```
+
+在 `<template #header>` 上配置时，属性仍写 `slot-wrapper` / `slot-wrapper-class` / `slot-wrapper-style` / `slot-single-root-no-wrapper`，不需要再带 `header` 后缀。
+
+也可以把 class/style 加到生成的 wrapper 上，而不是加到组件本身：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header slot-wrapper="cover-view" slot-wrapper-class="slot-default" slot-wrapper-style="padding: 8px">
+      <slot />
+    </template>
+    <template
+      #footer
+      slot-wrapper="view"
+      slot-wrapper-class="slot-footer"
+      slot-wrapper-style="margin-top: 12px"
+    >
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物：
+
+```wxml
+<IssueCard>
+  <cover-view slot="header" class="slot-default" style="padding: 8px">
+    <slot />
+  </cover-view>
+  <view slot="footer" class="slot-footer" style="margin-top: 12px">
+    <slot name="footer" />
+  </view>
+</IssueCard>
+```
+
+动态绑定也支持，例如父组件标签上的 `:slot-wrapper-class="headerClass"` / `:slot-wrapper-style="headerStyle"`，以及 `<template #footer :slot-wrapper-class="footerClass">` 这种单 slot 就近覆盖。
+
+`slot-single-root-no-wrapper-<slotName>` 可以让指定插槽在单根真实节点场景下尽量下推 `slot="..."`：
+
+```vue
+<template>
+  <IssueCard slot-single-root-no-wrapper-icon>
+    <template #icon>
+      <image src="/assets/icon.png" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物：
+
+```wxml
+<IssueCard>
+  <image slot="icon" src="/assets/icon.png" />
+</IssueCard>
+```
+
+这个下推策略不适用于转发 `<slot />`。转发内容仍会保留真实 wrapper：
+
+```vue
+<template>
+  <IssueCard slot-single-root-no-wrapper-header>
+    <template #header>
+      <slot />
+    </template>
+  </IssueCard>
+</template>
+```
+
+```wxml
+<IssueCard>
+  <view slot="header">
+    <slot />
+  </view>
+</IssueCard>
+```
+
+`block` 会被编译器拒绝并回退到 `view`。例如全局配置 `slotFallbackWrapper: 'block'` 后，转发 `<slot />` 的场景仍会生成：
+
+```wxml
+<IssueCard>
+  <view slot="header">
+    <slot />
+  </view>
+</IssueCard>
+```
+
+编译器会输出 warning：`slot fallback wrapper 不支持配置为 block，已回退为 view。`
+
+你选择的 wrapper 必须能承载实际内容。比如下面的写法会让 `text` 包裹 `view`，这不适合真实运行时：
+
+```vue
+<template>
+  <IssueCard>
+    <template #header slot-wrapper="text">
+      <view>Header</view>
+    </template>
+  </IssueCard>
+</template>
+```
+
+```wxml
+<IssueCard>
+  <text slot="header">
+    <view>Header</view>
+  </text>
+</IssueCard>
+```
+
+也可以通过 `weapp.vue.template.slotFallbackWrapper` 全局配置，按组件和具名插槽匹配。`rules[].component` 匹配使用处模板标签名；`rules[].componentName` 匹配子组件里的静态 `defineOptions({ name: 'HelloWorld' })`。`componentName` 需要编译器能解析到被引用的 Vue SFC，原生小程序组件继续用 `component`。
+
 ## 何时继续看其他文档
 
 - 需要更完整的编辑器提示说明：[`../volar.md`](../volar.md)

package/dist/docs/weapp-config.md

@@ -72,6 +72,203 @@ export default defineConfig({
 
 格式化只处理标签层级缩进，含文本内容的元素会保持单行，避免重排文本空白语义。
 
+### `vue.template.slotFallbackWrapper`
+
+用于配置普通具名插槽 fallback 的真实 wrapper。默认是 `view`。
+
+当组件把自己的默认 `<slot />` 继续透传到子组件的具名插槽时，编译器不能生成 `<slot slot="header" />`，也不能稳定使用 `<block slot="header"><slot /></block>`。真实 WeChat DevTools 运行时中，`block` 路径会丢失转发内容。因此默认产物是：
+
+```wxml
+<view slot="header">
+  <slot />
+</view>
+```
+
+全局配置示例：
+
+```ts
+import { defineConfig } from 'weapp-vite/config'
+
+export default defineConfig({
+  weapp: {
+    vue: {
+      template: {
+        slotFallbackWrapper: {
+          tag: 'view',
+          attrs: {
+            class: 'slot-wrapper',
+          },
+          rules: [
+            { component: 'IssueCard', slot: 'header', tag: 'cover-view' },
+            { componentName: 'HelloWorld', slot: 'header', tag: 'cover-view' },
+            { component: 'IssueCard', slot: 'footer', attrs: { class: 'slot-footer' } },
+            { component: /^Van/, slot: ['title', 'label'], tag: 'view' },
+          ],
+        },
+      },
+    },
+  },
+})
+```
+
+`component` 匹配使用处模板标签名，例如 `<IssueCard>` 对应 `IssueCard`，`<issue-card>` 对应 `issue-card`。如果要按子组件自己的名字匹配，让子组件写静态 `defineOptions({ name: 'HelloWorld' })`，然后使用 `componentName: 'HelloWorld'`。`componentName` 需要编译器能解析到被引用的 Vue SFC；原生小程序组件或第三方小程序组件继续用 `component`。
+
+组件内也可以用静态属性覆盖。`slot-wrapper` 是当前组件所有普通具名插槽的默认 wrapper：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header>
+      <slot />
+    </template>
+    <template #footer>
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物：
+
+```wxml
+<IssueCard>
+  <cover-view slot="header">
+    <slot />
+  </cover-view>
+  <cover-view slot="footer">
+    <slot name="footer" />
+  </cover-view>
+</IssueCard>
+```
+
+`slot-wrapper-<slotName>` 覆盖指定具名插槽。单个 slot 的覆盖更推荐直接写在对应的 `<template #xxx>` 上：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header>
+      <slot />
+    </template>
+    <template #footer slot-wrapper="view">
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物：
+
+```wxml
+<IssueCard>
+  <cover-view slot="header">
+    <slot />
+  </cover-view>
+  <view slot="footer">
+    <slot name="footer" />
+  </view>
+</IssueCard>
+```
+
+也可以把单个 slot 的覆盖配置写在对应的 `<template #xxx>` 上。这个写法最靠近 slot 内容，也更适合单个 slot 的局部策略：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header slot-wrapper="text" slot-wrapper-class="slot-header">
+      <slot />
+    </template>
+    <template #footer>
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+`<template #header>` 上的 `slot-wrapper` / `slot-wrapper-class` / `slot-wrapper-style` / `slot-single-root-no-wrapper` 是该 slot 的就近覆盖，优先级高于父组件标签上的默认值和 `slot-wrapper-header`。
+
+组件内还可以把 class/style 加到生成的 wrapper 上：
+
+```vue
+<template>
+  <IssueCard slot-wrapper="cover-view">
+    <template #header slot-wrapper="cover-view" slot-wrapper-class="slot-default" slot-wrapper-style="padding: 8px">
+      <slot />
+    </template>
+    <template
+      #footer
+      slot-wrapper="view"
+      slot-wrapper-class="slot-footer"
+      slot-wrapper-style="margin-top: 12px"
+    >
+      <slot name="footer" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+```wxml
+<IssueCard>
+  <cover-view slot="header" class="slot-default" style="padding: 8px">
+    <slot />
+  </cover-view>
+  <view slot="footer" class="slot-footer" style="margin-top: 12px">
+    <slot name="footer" />
+  </view>
+</IssueCard>
+```
+
+也支持 `:slot-wrapper-class="headerClass"` / `:slot-wrapper-style="headerStyle"` 这类动态绑定；单个 slot 更推荐写成 `<template #footer :slot-wrapper-class="footerClass">` 这种就近覆盖。参数名必须是静态的。
+
+`slot-single-root-no-wrapper-<slotName>` 可以让指定插槽在单根真实节点场景下尽量下推 `slot="..."`：
+
+```vue
+<template>
+  <IssueCard slot-single-root-no-wrapper-icon>
+    <template #icon>
+      <image src="/assets/icon.png" />
+    </template>
+  </IssueCard>
+</template>
+```
+
+产物：
+
+```wxml
+<IssueCard>
+  <image slot="icon" src="/assets/icon.png" />
+</IssueCard>
+```
+
+如果插槽内容是转发 `<slot />`，即使配置了 `slot-single-root-no-wrapper-header`，仍会保留 wrapper：
+
+```wxml
+<IssueCard>
+  <view slot="header">
+    <slot />
+  </view>
+</IssueCard>
+```
+
+`block` 不允许作为 wrapper，会回退到 `view` 并输出 warning。自定义 wrapper 必须是目标小程序运行时可渲染、并且能承载当前 slot 内容的真实节点或组件。例如下面的写法会生成 `text` 包裹 `view`，这不适合真实运行时：
+
+```vue
+<template>
+  <IssueCard>
+    <template #header slot-wrapper="text">
+      <view>Header</view>
+    </template>
+  </IssueCard>
+</template>
+```
+
+```wxml
+<IssueCard>
+  <text slot="header">
+    <view>Header</view>
+  </text>
+</IssueCard>
+```
+
 ### `layout`
 
 页面 layout 既可能来自项目级规则，也可能来自页面侧 `definePageMeta`。排查时先确认是哪一层生效。

package/dist/{file-C-eN8D-v.mjs → file-B8gSIRd0.mjs}

@@ -84,7 +84,7 @@ function resolveAutoRoutesMacroImportPath() {
 }
 async function resolveAutoRoutesInlineSnapshot() {
 	try {
-		const { getCompilerContext } = await import("./getInstance-MmgTcalc.mjs");
+		const { getCompilerContext } = await import("./getInstance-CjO8kDWJ.mjs");
 		const compilerContext = getCompilerContext();
 		const service = compilerContext.autoRoutesService;
 		const reference = service?.getReference?.();

package/dist/file-Cjctfg-V.mjs

@@ -0,0 +1,2 @@
+import { t as extractConfigFromVue } from "./file-B8gSIRd0.mjs";
+export { extractConfigFromVue };

package/dist/getInstance-CjO8kDWJ.mjs

@@ -0,0 +1,2 @@
+import { i as getCompilerContext } from "./createContext-D64s5KsN.mjs";
+export { getCompilerContext };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { $n as WebPlatform, A as Ref, Bn as WeappViteHostMeta, C as LoadConfigOptions, D as MethodDefinitions, E as InlineConfig, F as RolldownPlugin, Gn as ResolveWeappViteTargetOptions, Hn as createWeappViteHostMeta, I as RolldownPluginOption, Jn as WeappVitePlatform, Kn as ResolvedWeappViteTarget, L as RolldownWatchOptions, M as RolldownBuild, N as RolldownOptions, O as Plugin, P as RolldownOutput, Qn as WeappViteTargetKind, R as RolldownWatcher, S as CompilerContext, T as ConfigEnv, Un as isWeappViteHost, Vn as applyWeappViteHostMeta, Wn as resolveWeappViteHostMeta, Xn as WeappViteTargetDescriptor, Yn as WeappViteRuntime, Zn as WeappViteTargetInput, _ as definePageJson, a as UserConfigFnNoEnvPlain, at as WeappViteConfig, c as UserConfigFnPromise, d as Component, er as getSupportedWeappVitePlatforms, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, j as ResolvedConfig, k as PluginOption, l as defineConfig, m as Theme, n as UserConfigExport, nr as isWebPlatform, o as UserConfigFnObject, p as Sitemap, qn as WEB_PLATFORM_ALIASES, r as UserConfigFn, rr as resolveWeappViteTarget, s as UserConfigFnObjectPlain, t as UserConfig, tr as getSupportedWeappViteTargetDescriptors, u as App, v as defineSitemapJson, w as ComputedDefinitions, y as defineThemeJson, z as ViteDevServer, zn as WEAPP_VITE_HOST_NAME } from "./config-DBTZvwxw.mjs";
+import { $n as WebPlatform, A as Ref, Bn as WeappViteHostMeta, C as LoadConfigOptions, D as MethodDefinitions, E as InlineConfig, F as RolldownPlugin, Gn as ResolveWeappViteTargetOptions, Hn as createWeappViteHostMeta, I as RolldownPluginOption, Jn as WeappVitePlatform, Kn as ResolvedWeappViteTarget, L as RolldownWatchOptions, M as RolldownBuild, N as RolldownOptions, O as Plugin, P as RolldownOutput, Qn as WeappViteTargetKind, R as RolldownWatcher, S as CompilerContext, T as ConfigEnv, Un as isWeappViteHost, Vn as applyWeappViteHostMeta, Wn as resolveWeappViteHostMeta, Xn as WeappViteTargetDescriptor, Yn as WeappViteRuntime, Zn as WeappViteTargetInput, _ as definePageJson, a as UserConfigFnNoEnvPlain, at as WeappViteConfig, c as UserConfigFnPromise, d as Component, er as getSupportedWeappVitePlatforms, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, j as ResolvedConfig, k as PluginOption, l as defineConfig, m as Theme, n as UserConfigExport, nr as isWebPlatform, o as UserConfigFnObject, p as Sitemap, qn as WEB_PLATFORM_ALIASES, r as UserConfigFn, rr as resolveWeappViteTarget, s as UserConfigFnObjectPlain, t as UserConfig, tr as getSupportedWeappViteTargetDescriptors, u as App, v as defineSitemapJson, w as ComputedDefinitions, y as defineThemeJson, z as ViteDevServer, zn as WEAPP_VITE_HOST_NAME } from "./config-DJ3SOkf9.mjs";
 import { a as createWevuComponent, i as WevuComponentOptions, n as defineProps, r as setPageLayout, t as defineEmits } from "./runtime-CDNs17Qq.mjs";
 
 //#region src/createContext.d.ts

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { a as defineThemeJson, i as defineSitemapJson, n as defineComponentJson, r as definePageJson, t as defineAppJson } from "./json-BL8Dhhk6.mjs";
 import { a as resolveWeappViteHostMeta, i as isWeappViteHost, n as applyWeappViteHostMeta, r as createWeappViteHostMeta, t as WEAPP_VITE_HOST_NAME } from "./pluginHost--CaeyWpA.mjs";
 import { t as defineConfig } from "./config-DRGcCi3h.mjs";
-import { c as WEB_PLATFORM_ALIASES, d as isWebPlatform, f as resolveWeappViteTarget, l as getSupportedWeappVitePlatforms, t as createCompilerContext, u as getSupportedWeappViteTargetDescriptors } from "./createContext-NXrQuj5y.mjs";
+import { c as WEB_PLATFORM_ALIASES, d as isWebPlatform, f as resolveWeappViteTarget, l as getSupportedWeappVitePlatforms, t as createCompilerContext, u as getSupportedWeappViteTargetDescriptors } from "./createContext-D64s5KsN.mjs";
 import { i as createWevuComponent, n as defineProps, r as setPageLayout, t as defineEmits } from "./runtime-C3z9pDQB.mjs";
 export { WEAPP_VITE_HOST_NAME, WEB_PLATFORM_ALIASES, applyWeappViteHostMeta, createCompilerContext, createWeappViteHostMeta, createWevuComponent, defineAppJson, defineComponentJson, defineConfig, defineEmits, definePageJson, defineProps, defineSitemapJson, defineThemeJson, getSupportedWeappVitePlatforms, getSupportedWeappViteTargetDescriptors, isWeappViteHost, isWebPlatform, resolveWeappViteHostMeta, resolveWeappViteTarget, setPageLayout };

package/dist/json.d.mts

@@ -1,2 +1,2 @@
-import { _ as definePageJson, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, m as Theme, p as Sitemap, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-DBTZvwxw.mjs";
+import { _ as definePageJson, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, m as Theme, p as Sitemap, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-DJ3SOkf9.mjs";
 export { type App, type Component, type Page, type Sitemap, type Theme, defineAppJson, defineComponentJson, definePageJson, defineSitemapJson, defineThemeJson };

package/dist/mcp.d.mts

@@ -1,4 +1,4 @@
-import { Et as WeappMcpConfig } from "./config-DBTZvwxw.mjs";
+import { Et as WeappMcpConfig } from "./config-DJ3SOkf9.mjs";
 import { CreateServerOptions, DEFAULT_MCP_ENDPOINT, DEFAULT_MCP_HOST, DEFAULT_MCP_PORT, DEFAULT_RUNTIME_REST_ENDPOINT, McpServerHandle, StartMcpServerOptions, createWeappViteMcpServer } from "@weapp-vite/mcp";
 
 //#region src/mcp.d.ts

package/dist/types.d.mts

@@ -1,4 +1,4 @@
 import { c as Resolver } from "./index-Bmclyjw8.mjs";
 import { n as AutoRoutesSubPackage, t as AutoRoutes } from "./routes-C7fCmf92.mjs";
-import { $ as WeappAnalyzeBudgetConfig, $t as GenerateTemplateFileSource, A as Ref, An as WeappLibFileName, At as WeappRouteRules, B as BindingErrorLike, Bn as WeappViteHostMeta, Bt as BuildNpmPackageMeta, Cn as SubPackageStyleConfigObject, Ct as WeappInjectWeapiConfig, D as MethodDefinitions, Dn as WeappLibConfig, Dt as WeappNpmConfig, E as InlineConfig, En as WeappLibComponentJson, Et as WeappMcpConfig, F as RolldownPlugin, Fn as WeappManagedServerTsconfigConfig, Ft as WeappWevuConfig, G as EntryJsonFragment, Gt as GenerateExtensionsOptions, H as BaseEntry, Ht as CopyGlobs, I as RolldownPluginOption, In as WeappManagedSharedTsconfigConfig, It as WeappWorkerConfig, J as ScanComponentItem, Jt as GenerateOptions, K as PageEntry, Kt as GenerateFileType, L as RolldownWatchOptions, Ln as WeappManagedTypeScriptConfig, Lt as Alias, M as RolldownBuild, Mn as WeappLibVueTscOptions, Mt as WeappVueConfig, N as RolldownOptions, Nn as WeappManagedAppTsconfigConfig, Nt as WeappVueTemplateConfig, O as Plugin, On as WeappLibDtsOptions, Ot as WeappRequestRuntimeConfig, P as RolldownOutput, Pn as WeappManagedNodeTsconfigConfig, Pt as WeappWebRuntimeConfig, Q as UserConfig, Qt as GenerateTemplateFactory, R as RolldownWatcher, Rn as WeappWebConfig, Rt as AliasOptions, Sn as SubPackageStyleConfigEntry, St as WeappInjectRequestGlobalsTarget, T as ConfigEnv, Tn as SubPackageStyleScope, Tt as WeappInjectWebRuntimeGlobalsTarget, U as ComponentEntry, Ut as CopyOptions, V as AppEntry, Vt as ChunksConfig, W as Entry, Wt as GenerateDirsOptions, X as ProjectConfig, Xt as GenerateTemplateContext, Y as WxmlDep, Yn as WeappViteRuntime, Yt as GenerateTemplate, Z as SubPackageMetaValue, Zt as GenerateTemplateEntry, _n as SharedChunkDynamicImports, _t as WeappAutoRoutesIncludePattern, an as JsonMergeContext, at as WeappViteConfig, b as ChangeEvent, bn as SharedChunkStrategy, bt as WeappHmrConfig, cn as JsonMergeStrategy, ct as EnhanceOptions, dn as NpmDependencyPattern, dt as MultiPlatformConfig, en as GenerateTemplateInlineSource, et as WeappAnalyzeConfig, fn as NpmMainPackageConfig, ft as ScanWxmlOptions, gn as ResolvedAlias, gt as WeappAutoRoutesInclude, hn as NpmSubPackageConfig, ht as WeappAutoRoutesConfig, in as JsonConfig, it as WeappForwardConsoleLogLevel, j as ResolvedConfig, jn as WeappLibInternalDtsOptions, jt as WeappSubPackageConfig, k as PluginOption, kn as WeappLibEntryContext, kt as WeappRouteRule, ln as MpPlatform, lt as EnhanceWxmlOptions, mn as NpmStrategy, mt as WeappAppPreludeMode, nn as GenerateTemplatesConfig, nt as WeappDebugConfig, on as JsonMergeFunction, ot as AutoImportComponents, pn as NpmPluginPackageConfig, pt as WeappAppPreludeConfig, q as ComponentsMap, qt as GenerateFilenamesOptions, rn as JsFormat, rt as WeappForwardConsoleConfig, sn as JsonMergeStage, st as AutoImportComponentsOption, tn as GenerateTemplateScope, tt as WeappAnalyzeHistoryConfig, un as NpmBuildOptions, ut as HandleWxmlOptions, vn as SharedChunkMode, vt as WeappBuildScopeConfig, w as ComputedDefinitions, wn as SubPackageStyleEntry, wt as WeappInjectWebRuntimeGlobalsConfig, x as WeappVitePluginApi, xn as SubPackage, xt as WeappInjectRequestGlobalsConfig, yn as SharedChunkOverride, yt as WeappBuildScopeObjectConfig, z as ViteDevServer, zt as AlipayNpmMode } from "./config-DBTZvwxw.mjs";
+import { $ as WeappAnalyzeBudgetConfig, $t as GenerateTemplateFileSource, A as Ref, An as WeappLibFileName, At as WeappRouteRules, B as BindingErrorLike, Bn as WeappViteHostMeta, Bt as BuildNpmPackageMeta, Cn as SubPackageStyleConfigObject, Ct as WeappInjectWeapiConfig, D as MethodDefinitions, Dn as WeappLibConfig, Dt as WeappNpmConfig, E as InlineConfig, En as WeappLibComponentJson, Et as WeappMcpConfig, F as RolldownPlugin, Fn as WeappManagedServerTsconfigConfig, Ft as WeappWevuConfig, G as EntryJsonFragment, Gt as GenerateExtensionsOptions, H as BaseEntry, Ht as CopyGlobs, I as RolldownPluginOption, In as WeappManagedSharedTsconfigConfig, It as WeappWorkerConfig, J as ScanComponentItem, Jt as GenerateOptions, K as PageEntry, Kt as GenerateFileType, L as RolldownWatchOptions, Ln as WeappManagedTypeScriptConfig, Lt as Alias, M as RolldownBuild, Mn as WeappLibVueTscOptions, Mt as WeappVueConfig, N as RolldownOptions, Nn as WeappManagedAppTsconfigConfig, Nt as WeappVueTemplateConfig, O as Plugin, On as WeappLibDtsOptions, Ot as WeappRequestRuntimeConfig, P as RolldownOutput, Pn as WeappManagedNodeTsconfigConfig, Pt as WeappWebRuntimeConfig, Q as UserConfig, Qt as GenerateTemplateFactory, R as RolldownWatcher, Rn as WeappWebConfig, Rt as AliasOptions, Sn as SubPackageStyleConfigEntry, St as WeappInjectRequestGlobalsTarget, T as ConfigEnv, Tn as SubPackageStyleScope, Tt as WeappInjectWebRuntimeGlobalsTarget, U as ComponentEntry, Ut as CopyOptions, V as AppEntry, Vt as ChunksConfig, W as Entry, Wt as GenerateDirsOptions, X as ProjectConfig, Xt as GenerateTemplateContext, Y as WxmlDep, Yn as WeappViteRuntime, Yt as GenerateTemplate, Z as SubPackageMetaValue, Zt as GenerateTemplateEntry, _n as SharedChunkDynamicImports, _t as WeappAutoRoutesIncludePattern, an as JsonMergeContext, at as WeappViteConfig, b as ChangeEvent, bn as SharedChunkStrategy, bt as WeappHmrConfig, cn as JsonMergeStrategy, ct as EnhanceOptions, dn as NpmDependencyPattern, dt as MultiPlatformConfig, en as GenerateTemplateInlineSource, et as WeappAnalyzeConfig, fn as NpmMainPackageConfig, ft as ScanWxmlOptions, gn as ResolvedAlias, gt as WeappAutoRoutesInclude, hn as NpmSubPackageConfig, ht as WeappAutoRoutesConfig, in as JsonConfig, it as WeappForwardConsoleLogLevel, j as ResolvedConfig, jn as WeappLibInternalDtsOptions, jt as WeappSubPackageConfig, k as PluginOption, kn as WeappLibEntryContext, kt as WeappRouteRule, ln as MpPlatform, lt as EnhanceWxmlOptions, mn as NpmStrategy, mt as WeappAppPreludeMode, nn as GenerateTemplatesConfig, nt as WeappDebugConfig, on as JsonMergeFunction, ot as AutoImportComponents, pn as NpmPluginPackageConfig, pt as WeappAppPreludeConfig, q as ComponentsMap, qt as GenerateFilenamesOptions, rn as JsFormat, rt as WeappForwardConsoleConfig, sn as JsonMergeStage, st as AutoImportComponentsOption, tn as GenerateTemplateScope, tt as WeappAnalyzeHistoryConfig, un as NpmBuildOptions, ut as HandleWxmlOptions, vn as SharedChunkMode, vt as WeappBuildScopeConfig, w as ComputedDefinitions, wn as SubPackageStyleEntry, wt as WeappInjectWebRuntimeGlobalsConfig, x as WeappVitePluginApi, xn as SubPackage, xt as WeappInjectRequestGlobalsConfig, yn as SharedChunkOverride, yt as WeappBuildScopeObjectConfig, z as ViteDevServer, zt as AlipayNpmMode } from "./config-DJ3SOkf9.mjs";
 export { Alias, AliasOptions, AlipayNpmMode, AppEntry, AutoImportComponents, AutoImportComponentsOption, AutoRoutes, AutoRoutesSubPackage, BaseEntry, BindingErrorLike, BuildNpmPackageMeta, ChangeEvent, ChunksConfig, ComponentEntry, ComponentsMap, type ComputedDefinitions, type ConfigEnv, CopyGlobs, CopyOptions, EnhanceOptions, EnhanceWxmlOptions, Entry, EntryJsonFragment, GenerateDirsOptions, GenerateExtensionsOptions, GenerateFileType, GenerateFilenamesOptions, GenerateOptions, GenerateTemplate, GenerateTemplateContext, GenerateTemplateEntry, GenerateTemplateFactory, GenerateTemplateFileSource, GenerateTemplateInlineSource, GenerateTemplateScope, GenerateTemplatesConfig, HandleWxmlOptions, type InlineConfig, JsFormat, JsonConfig, JsonMergeContext, JsonMergeFunction, JsonMergeStage, JsonMergeStrategy, type MethodDefinitions, MpPlatform, MultiPlatformConfig, NpmBuildOptions, NpmDependencyPattern, NpmMainPackageConfig, NpmPluginPackageConfig, NpmStrategy, NpmSubPackageConfig, PageEntry, type Plugin, type PluginOption, ProjectConfig, type Ref, ResolvedAlias, type ResolvedConfig, type Resolver, type RolldownBuild, type RolldownOptions, type RolldownOutput, type RolldownPlugin, type RolldownPluginOption, type RolldownWatchOptions, type RolldownWatcher, ScanComponentItem, ScanWxmlOptions, SharedChunkDynamicImports, SharedChunkMode, SharedChunkOverride, SharedChunkStrategy, SubPackage, SubPackageMetaValue, SubPackageStyleConfigEntry, SubPackageStyleConfigObject, SubPackageStyleEntry, SubPackageStyleScope, UserConfig, type ViteDevServer, WeappAnalyzeBudgetConfig, WeappAnalyzeConfig, WeappAnalyzeHistoryConfig, WeappAppPreludeConfig, WeappAppPreludeMode, WeappAutoRoutesConfig, WeappAutoRoutesInclude, WeappAutoRoutesIncludePattern, WeappBuildScopeConfig, WeappBuildScopeObjectConfig, WeappDebugConfig, WeappForwardConsoleConfig, WeappForwardConsoleLogLevel, WeappHmrConfig, WeappInjectRequestGlobalsConfig, WeappInjectRequestGlobalsTarget, WeappInjectWeapiConfig, WeappInjectWebRuntimeGlobalsConfig, WeappInjectWebRuntimeGlobalsTarget, WeappLibComponentJson, WeappLibConfig, WeappLibDtsOptions, WeappLibEntryContext, WeappLibFileName, WeappLibInternalDtsOptions, WeappLibVueTscOptions, WeappManagedAppTsconfigConfig, WeappManagedNodeTsconfigConfig, WeappManagedServerTsconfigConfig, WeappManagedSharedTsconfigConfig, WeappManagedTypeScriptConfig, WeappMcpConfig, WeappNpmConfig, WeappRequestRuntimeConfig, WeappRouteRule, WeappRouteRules, WeappSubPackageConfig, WeappViteConfig, type WeappViteHostMeta, WeappVitePluginApi, type WeappViteRuntime, WeappVueConfig, WeappVueTemplateConfig, WeappWebConfig, WeappWebRuntimeConfig, WeappWevuConfig, WeappWorkerConfig, WxmlDep };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-vite",
   "type": "module",
-  "version": "6.16.24",
+  "version": "6.16.25",
   "description": "weapp-vite 一个现代化的小程序打包工具",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -93,7 +93,7 @@
     "@jridgewell/remapping": "^2.3.5",
     "@vercel/detect-agent": "^1.2.3",
     "@volar/typescript": "^2.4.28",
-    "@vue/language-core": "^3.3.1",
+    "@vue/language-core": "^3.3.2",
     "cac": "^7.0.0",
     "chokidar": "^5.0.0",
     "comment-json": "^5.0.0",
@@ -116,23 +116,23 @@
     "vite": "8.0.14",
     "vite-tsconfig-paths": "^6.1.1",
     "vue": "^3.5.34",
-    "vue-tsc": "^3.3.1",
-    "@weapp-core/constants": "0.1.9",
+    "vue-tsc": "^3.3.2",
+    "@weapp-core/constants": "0.1.10",
     "@weapp-core/init": "6.0.9",
     "@weapp-core/logger": "3.1.1",
     "@weapp-core/schematics": "6.0.4",
     "@weapp-core/shared": "3.0.4",
-    "@weapp-vite/ast": "6.16.24",
+    "@weapp-vite/ast": "6.16.25",
     "@weapp-vite/mcp": "1.3.6",
     "@weapp-vite/miniprogram-automator": "1.1.3",
     "@weapp-vite/volar": "2.1.0",
-    "@weapp-vite/web": "1.3.25",
+    "@weapp-vite/web": "1.3.26",
     "@wevu/api": "0.2.9",
-    "@wevu/web-apis": "1.2.16",
+    "@wevu/web-apis": "1.2.17",
     "rolldown-require": "2.0.17",
     "vite-plugin-performance": "2.0.1",
     "weapp-ide-cli": "5.3.2",
-    "wevu": "6.16.24"
+    "wevu": "6.16.25"
   },
   "publishConfig": {
     "access": "public",

package/dist/file-S0TAbkhK.mjs

@@ -1,2 +0,0 @@
-import { t as extractConfigFromVue } from "./file-C-eN8D-v.mjs";
-export { extractConfigFromVue };

package/dist/getInstance-MmgTcalc.mjs

@@ -1,2 +0,0 @@
-import { i as getCompilerContext } from "./createContext-NXrQuj5y.mjs";
-export { getCompilerContext };