weapp-vite 6.15.4 → 6.15.5

package/README.md

@@ -36,7 +36,7 @@
 ### Vue 项目
 
 ```typescript
-// vite.config.ts
+// vite.config.ts 或 weapp-vite.config.ts
 import { defineConfig } from 'weapp-vite/config'
 
 export default defineConfig({
@@ -46,12 +46,21 @@ export default defineConfig({
       enable: true,
       template: {
         removeComments: true,
+        htmlTagToWxml: true,
+        htmlTagToWxmlTagClass: true,
       },
     },
   },
 })
 ```
 
+如果你在把传统 HTML/Vue 模板迁移到小程序 `.vue`，这两个模板配置通常最有用：
+
+- `weapp.vue.template.htmlTagToWxml`
+  把 `div/span/img/a/h1...` 等常见 HTML 标签映射成小程序内置标签。
+- `weapp.vue.template.htmlTagToWxmlTagClass`
+  默认开启。在映射发生时追加原标签名 class，例如 `h3 -> <view class="h3">`、`br -> <view class="br" />`，便于你自己写 CSS 低成本恢复默认外观；不需要时可设为 `false`。
+
 ```vue
 <!-- App.vue -->
 <script setup>
@@ -239,7 +248,7 @@ weapp-vite mcp --workspace-root /absolute/path/to/weapp-vite
 wv mcp --workspace-root /absolute/path/to/weapp-vite
 ```
 
-在 `vite.config.ts` 中开启自动启动：
+在 `vite.config.ts` 或 `weapp-vite.config.ts` 中开启自动启动：
 
 ```ts
 import { defineConfig } from 'weapp-vite/config'

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { i as getCompilerContext, u as getRouteRuntimeGlobalKeys } from "./createContext-BuwQryVc.mjs";
+import { i as getCompilerContext, u as getRouteRuntimeGlobalKeys } from "./createContext-BJXXIcT5.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 { S as isPathInside, _ as DEFAULT_MP_PLATFORM, b as resolveMiniPlatform, c as createSharedBuildConfig, d as resolveWeappConfigFile, f as checkRuntime, g as createCjsConfigLoadError, h as parseCommentJson, l as SHARED_CHUNK_VIRTUAL_PREFIX, m as loadViteConfigFile, n as syncProjectSupportFiles, p as getProjectConfigFileName, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, v as getDefaultIdeProjectRoot, x as shouldPassPlatformArgToIdeOpen, y as normalizeMiniPlatform } from "./createContext-BuwQryVc.mjs";
+import { S as isPathInside, _ as DEFAULT_MP_PLATFORM, b as resolveMiniPlatform, c as createSharedBuildConfig, d as resolveWeappConfigFile, f as checkRuntime, g as createCjsConfigLoadError, h as parseCommentJson, l as SHARED_CHUNK_VIRTUAL_PREFIX, m as loadViteConfigFile, n as syncProjectSupportFiles, p as getProjectConfigFileName, r as syncManagedTsconfigBootstrapFiles, s as formatBytes, t as createCompilerContext, v as getDefaultIdeProjectRoot, x as shouldPassPlatformArgToIdeOpen, y as normalizeMiniPlatform } from "./createContext-BJXXIcT5.mjs";
 import { r as logger_default, t as colors } from "./logger-CgxdNjvb.mjs";
-import { h as VERSION } from "./file-x_pM3sdN.mjs";
+import { h as VERSION } from "./file-DllJX3aP.mjs";
 import { a as resolveWeappMcpConfig, o as startWeappViteMcpServer } from "./mcp-DRlj32v4.mjs";
 import { createRequire } from "node:module";
 import path, { posix } from "pathe";
@@ -1076,8 +1076,27 @@ async function tryReuseOpenedWechatIde(projectPath) {
 		reused: false
 	};
 }
+async function reopenOpenedWechatIde(projectPath) {
+	let miniProgram;
+	try {
+		miniProgram = await connectOpenedAutomator({
+			projectPath,
+			timeout: 3e3
+		});
+	} catch {
+		return false;
+	}
+	miniProgram.disconnect();
+	logger_default.info("目标项目已在微信开发者工具中打开，当前命令将主动重开以刷新最新构建产物。");
+	if (!await closeIde()) logger_default.warn("关闭当前微信开发者工具失败，仍继续尝试重新打开目标项目。");
+	await openWechatIdeByAutomator(projectPath);
+	return true;
+}
 async function openIde(platform, projectPath, options = {}) {
 	if (platform === "weapp" && projectPath && options.trustProject !== false) try {
+		if (options.reuseOpenedProject === false) {
+			if (await reopenOpenedWechatIde(projectPath)) return;
+		}
 		const reuseResult = await tryReuseOpenedWechatIde(projectPath);
 		if (reuseResult?.reused || reuseResult?.reopened) return;
 		await openWechatIdeByAutomator(projectPath);
@@ -2077,7 +2096,7 @@ function registerPrepareCommand(cli) {
 }
 //#endregion
 //#region package.json
-var version = "6.15.4";
+var version = "6.15.5";
 //#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;
@@ -2781,7 +2800,10 @@ function registerServeCommand(cli) {
 					mpDistRoot: configService.mpDistRoot,
 					cwd: configService.cwd,
 					weappViteConfig: configService.weappViteConfig
-				})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd), { trustProject: options.trustProject });
+				})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd), {
+					reuseOpenedProject: false,
+					trustProject: options.trustProject
+				});
 				devHotkeysSession?.restore();
 			}
 			if (analyzeHandle) await analyzeController.waitForExit();

package/dist/{config-B5YFoO3u.d.mts → config-BbL8Gqez.d.mts}

@@ -496,6 +496,7 @@ interface WeappVueTemplateConfig {
   removeComments?: boolean;
   simplifyWhitespace?: boolean;
   htmlTagToWxml?: boolean | Record<string, string>;
+  htmlTagToWxmlTagClass?: boolean;
   scopedSlotsCompiler?: 'auto' | 'augmented' | 'off';
   scopedSlotsRequireProps?: boolean;
   slotMultipleInstance?: boolean;
@@ -1092,6 +1093,12 @@ interface LoadConfigResult {
   configFilePath?: string;
   currentSubPackageRoot?: string;
   weappWeb?: ResolvedWeappWebConfig;
+  configMergeInfo?: ResolvedConfigMergeInfo;
+}
+interface ResolvedConfigMergeInfo {
+  merged: boolean;
+  viteConfigPath?: string;
+  weappConfigPath?: string;
 }
 interface ResolvedWeappLibConfig {
   enabled: boolean;

package/dist/config.d.mts

@@ -1,2 +1,2 @@
-import { Bn as resolveWeappViteHostMeta, Fn as WeappViteHostMeta, In as WeappViteRuntime, Ln as applyWeappViteHostMeta, Pn as WEAPP_VITE_HOST_NAME, Rn as createWeappViteHostMeta, _ as definePageJson, a as UserConfigFnNoEnvPlain, 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, nt as WeappViteConfig, 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 isWeappViteHost } from "./config-B5YFoO3u.mjs";
+import { Bn as resolveWeappViteHostMeta, Fn as WeappViteHostMeta, In as WeappViteRuntime, Ln as applyWeappViteHostMeta, Pn as WEAPP_VITE_HOST_NAME, Rn as createWeappViteHostMeta, _ as definePageJson, a as UserConfigFnNoEnvPlain, 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, nt as WeappViteConfig, 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 isWeappViteHost } from "./config-BbL8Gqez.mjs";
 export { App, Component, Page, Sitemap, Theme, UserConfig, UserConfigExport, UserConfigFn, UserConfigFnNoEnv, UserConfigFnNoEnvPlain, UserConfigFnObject, UserConfigFnObjectPlain, UserConfigFnPromise, WEAPP_VITE_HOST_NAME, WeappViteConfig, WeappViteHostMeta, WeappViteRuntime, applyWeappViteHostMeta, createWeappViteHostMeta, defineAppJson, defineComponentJson, defineConfig, definePageJson, defineSitemapJson, defineThemeJson, isWeappViteHost, resolveWeappViteHostMeta };

package/dist/{createContext-BuwQryVc.mjs → createContext-BJXXIcT5.mjs}

@@ -1,6 +1,6 @@
 import { n as applyWeappViteHostMeta } from "./pluginHost-BzPJL4F-.mjs";
 import { n as configureLogger, r as logger_default } from "./logger-CgxdNjvb.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-x_pM3sdN.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-DllJX3aP.mjs";
 import { createRequire, isBuiltin } from "node:module";
 import path, { posix } from "pathe";
 import { normalize, relative, win32 } from "node:path";
@@ -4944,6 +4944,10 @@ const DEFAULT_VITE_CONFIG_FILES = [
 	"vite.config.mjs",
 	"vite.config.cjs"
 ];
+const DEFAULT_VITE_CONFIG_FILE_SET = new Set(DEFAULT_VITE_CONFIG_FILES);
+function isDefaultViteConfigBasename(filePath) {
+	return DEFAULT_VITE_CONFIG_FILE_SET.has(path.basename(filePath));
+}
 async function resolveImplicitConfigFile(configRoot) {
 	for (const fileName of DEFAULT_VITE_CONFIG_FILES) {
 		const filePath = path.resolve(configRoot, fileName);
@@ -5258,6 +5262,9 @@ function resolveSpecifiedWeappConfigPath(root, specified) {
 function isWeappConfigBasename(filePath) {
 	return WEAPP_VITE_CONFIG_SET.has(path.basename(filePath));
 }
+function isExplicitCustomConfigFile(filePath) {
+	return path.basename(filePath).includes(".config.") && !isDefaultViteConfigBasename(filePath) && !isWeappConfigBasename(filePath);
+}
 async function findWeappConfigInDirectory(directory) {
 	for (const filename of WEAPP_VITE_CONFIG_CANDIDATES) {
 		const candidatePath = path.resolve(directory, filename);
@@ -5272,6 +5279,7 @@ async function resolveWeappConfigFile(options) {
 			if (await fs.pathExists(resolvedSpecified)) return resolvedSpecified;
 			return;
 		}
+		if (isExplicitCustomConfigFile(resolvedSpecified)) return;
 		const fromSpecifiedDirectory = await findWeappConfigInDirectory(path.dirname(resolvedSpecified));
 		if (fromSpecifiedDirectory) return fromSpecifiedDirectory;
 	}
@@ -9687,6 +9695,7 @@ function createAdvancedChunkNameResolver(options) {
 const REG_NODE_MODULES_DIR = /[\\/]node_modules[\\/]/gi;
 const REG_COMMONJS_HELPERS = /commonjsHelpers\.js$/;
 const REG_REQUEST_GLOBAL_RUNTIME_VENDOR_ID = /(?:^|[/\\])(?:@wevu[/\\]web-apis|web-apis[/\\]dist[/\\]index\.(?:m?js|cjs)|weapp-vite[/\\](?:dist[/\\]web-apis\.mjs|src[/\\](?:webApis\.ts|runtime[/\\]webApis[/\\]index\.ts)))(?:$|[?#])/;
+const REG_HASHED_DIST_CHUNK_ID = /(?:^|[/\\])dist[/\\]([^/\\]+)-(\w{6,})\.(?:m?js|cjs)(?:$|[?#])/;
 function resolveSharedPathRoot(configService, sharedPathRoot) {
 	const absoluteSrcRoot = configService.absoluteSrcRoot;
 	const configuredRoot = sharedPathRoot ? path.resolve(configService.cwd, sharedPathRoot) : absoluteSrcRoot;
@@ -9773,6 +9782,35 @@ function isRequestGlobalsRuntimeChunk(chunk) {
 		return REG_REQUEST_GLOBAL_RUNTIME_VENDOR_ID.test(id);
 	});
 }
+function sanitizePackageToken(value) {
+	return value.replace(/^@/, "").replaceAll(/[\\/]/g, "-").replaceAll(/[^\w-]/g, "-").replaceAll(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function resolveDistChunkPackageToken(cleanedAbsoluteId) {
+	const npmRelativePath = resolveNodeModulesSharedPath(cleanedAbsoluteId);
+	if (npmRelativePath) {
+		const [packagePath] = npmRelativePath.split("/dist/");
+		if (packagePath) return sanitizePackageToken(packagePath);
+	}
+	const segments = cleanedAbsoluteId.replaceAll("\\", "/").split("/");
+	const distIndex = segments.lastIndexOf("dist");
+	if (distIndex <= 0) return;
+	const packageToken = segments[distIndex - 1];
+	if (!packageToken) return;
+	return sanitizePackageToken(packageToken);
+}
+function resolveStableHashedDistChunkFileName(chunk) {
+	const candidateIds = [chunk.facadeModuleId, ...chunk.moduleIds ?? []].filter((id) => typeof id === "string");
+	for (const id of candidateIds) {
+		const cleanedAbsoluteId = normalizeSharedPathCandidate(id);
+		if (!path.isAbsolute(cleanedAbsoluteId)) continue;
+		const matched = cleanedAbsoluteId.match(REG_HASHED_DIST_CHUNK_ID);
+		if (!matched) continue;
+		const baseName = matched[1];
+		const packageToken = resolveDistChunkPackageToken(cleanedAbsoluteId);
+		if (!baseName || !packageToken) continue;
+		return `weapp-vendors/${packageToken}-${baseName}.js`;
+	}
+}
 function createSharedBuildResolver(configService, getSubPackageRoots) {
 	const nodeModulesDeps = [REG_NODE_MODULES_DIR];
 	const commonjsHelpersDeps = [REG_COMMONJS_HELPERS];
@@ -9797,6 +9835,8 @@ function createSharedBuildOutput(configService, getSubPackageRoots) {
 		codeSplitting: { groups: [{ name: (id, ctx) => resolveAdvancedChunkName(id, ctx) }] },
 		chunkFileNames: (chunk) => {
 			if (isRequestGlobalsRuntimeChunk(chunk)) return REQUEST_GLOBAL_RUNTIME_CHUNK_FILE_BASENAME;
+			const stableHashedDistChunkFileName = resolveStableHashedDistChunkFileName(chunk);
+			if (stableHashedDistChunkFileName) return stableHashedDistChunkFileName;
 			return "[name].js";
 		}
 	};
@@ -10081,9 +10121,9 @@ function checkWorkersOptions(target, configService, scanService) {
 	const workersDir = scanService.workersDir;
 	const hasWorkersDir = Boolean(workersDir);
 	if (hasWorkersDir && configService.weappViteConfig?.worker?.entry === void 0) {
-		logger_default.error("检测到已经开启了 `worker`，请在 `vite.config.ts` 中设置 `weapp.worker.entry` 路径");
+		logger_default.error("检测到已经开启了 `worker`，请在 `vite.config.ts` / `weapp-vite.config.ts` 中设置 `weapp.worker.entry` 路径");
 		logger_default.error("比如引入的 `worker` 路径为 `workers/index`, 此时 `weapp.worker.entry` 设置为 `[index]` ");
-		throw new Error("请在 `vite.config.ts` 中设置 `weapp.worker.entry` 路径");
+		throw new Error("请在 `vite.config.ts` / `weapp-vite.config.ts` 中设置 `weapp.worker.entry` 路径");
 	}
 	return {
 		hasWorkersDir,
@@ -11234,6 +11274,15 @@ function createLoadConfig(options) {
 			config.resolve.tsconfigPaths ??= true;
 		}
 		const configFilePath = weappLoaded?.path ?? loaded?.path ?? resolvedConfigFile;
+		const configMergeInfo = loaded?.path && weappLoaded?.path && !shouldReuseLoadedWeappConfig(weappLoaded.path, loaded.path) ? {
+			merged: true,
+			viteConfigPath: loaded.path,
+			weappConfigPath: weappLoaded.path
+		} : {
+			merged: false,
+			viteConfigPath: loaded?.path,
+			weappConfigPath: shouldReuseLoadedWeappConfig(weappLoaded?.path, loaded?.path) ? void 0 : weappLoaded?.path
+		};
 		const outputExtensions = getOutputExtensions(platform);
 		const relativeSrcRoot = (p) => {
 			if (srcRoot) return path.relative(srcRoot, p);
@@ -11261,7 +11310,8 @@ function createLoadConfig(options) {
 			configFilePath,
 			currentSubPackageRoot: void 0,
 			weappWeb: resolvedWebConfig,
-			weappLib: resolvedLibConfig
+			weappLib: resolvedLibConfig,
+			configMergeInfo
 		};
 	};
 }
@@ -32393,6 +32443,7 @@ function createCompileVueFileOptions(ctx, pluginCtx, vuePath, isPage, isApp, con
 	const scopedSlotsRequireProps = configService.weappViteConfig?.vue?.template?.scopedSlotsRequireProps ?? scopedSlotsCompiler !== "augmented";
 	const slotMultipleInstance = configService.weappViteConfig?.vue?.template?.slotMultipleInstance ?? true;
 	const htmlTagToWxml = configService.weappViteConfig?.vue?.template?.htmlTagToWxml;
+	const htmlTagToWxmlTagClass = configService.weappViteConfig?.vue?.template?.htmlTagToWxmlTagClass ?? true;
 	const classStyleRuntimeConfig = configService.weappViteConfig?.vue?.template?.classStyleRuntime ?? "js";
 	const objectLiteralBindMode = configService.weappViteConfig?.vue?.template?.objectLiteralBindMode ?? "runtime";
 	const mustacheInterpolation = configService.weappViteConfig?.vue?.template?.mustacheInterpolation ?? "compact";
@@ -32431,6 +32482,7 @@ function createCompileVueFileOptions(ctx, pluginCtx, vuePath, isPage, isApp, con
 		template: {
 			platform: templatePlatformOptions.templatePlatform,
 			htmlTagToWxml,
+			htmlTagToWxmlTagClass,
 			scopedSlotsCompiler,
 			scopedSlotsRequireProps,
 			slotMultipleInstance,
@@ -34397,6 +34449,11 @@ function createConfigService(ctx) {
 		oxcRolldownPlugin: oxcRuntimeSupport.rolldownPlugin,
 		oxcVitePlugin: oxcRuntimeSupport.vitePlugin
 	});
+	function formatConfigDisplayPath(filePath) {
+		if (!filePath) return;
+		const relative = normalizeRelativePath(path.relative(options.cwd, filePath));
+		return relative && relative !== "" ? relative : path.basename(filePath);
+	}
 	async function load(optionsInput) {
 		const defaultCwd = process$1.cwd();
 		const input = defu(optionsInput, {
@@ -34419,6 +34476,11 @@ function createConfigService(ctx) {
 		});
 		setOptions(resolvedConfig);
 		configureLogger(resolvedConfig.config.weapp?.logger);
+		if (resolvedConfig.configMergeInfo?.merged) {
+			const weappConfigDisplay = formatConfigDisplayPath(resolvedConfig.configMergeInfo.weappConfigPath) ?? "weapp-vite.config.ts";
+			const viteConfigDisplay = formatConfigDisplayPath(resolvedConfig.configMergeInfo.viteConfigPath) ?? "vite.config.ts";
+			logger_default.info(`[config] 检测到同时存在 ${weappConfigDisplay} 与 ${viteConfigDisplay}，已合并其中的 \`weapp\` 配置，优先级：${weappConfigDisplay} > ${viteConfigDisplay}`);
+		}
 		packageManager = await detect() ?? {
 			agent: "npm",
 			name: "npm"
@@ -34781,7 +34843,8 @@ function createDefaultLoadConfigResult() {
 		platform: "weapp",
 		srcRoot: "",
 		configFilePath: void 0,
-		weappWeb: void 0
+		weappWeb: void 0,
+		configMergeInfo: void 0
 	};
 }
 function createDefaultPackageInfo() {
@@ -34996,7 +35059,7 @@ async function loadAppEntry(ctx, scanState) {
 	const vueAppPath = await findVueEntry(appBasename);
 	let configFromVue;
 	if (!appConfigFile && vueAppPath) {
-		const { extractConfigFromVue } = await import("./file-BVlUDAip.mjs");
+		const { extractConfigFromVue } = await import("./file-D-LpaSgY.mjs");
 		configFromVue = await extractConfigFromVue(vueAppPath);
 		if (configFromVue) appConfigFile = vueAppPath;
 	}
@@ -35047,7 +35110,7 @@ async function loadAppEntry(ctx, scanState) {
 		}
 		throw new Error("`app.json` 解析失败，请确保 `app.json` 文件格式正确");
 	}
-	throw new Error(`在 ${appDirname} 目录下没有找到 \`app.json\` 或 \`app.vue\`，请确保你初始化了小程序项目，或者在 \`vite.config.ts\` 中设置的正确的 \`weapp.srcRoot\` 配置路径`);
+	throw new Error(`在 ${appDirname} 目录下没有找到 \`app.json\` 或 \`app.vue\`，请确保你初始化了小程序项目，或者在 \`vite.config.ts\` / \`weapp-vite.config.ts\` 中设置正确的 \`weapp.srcRoot\` 配置路径`);
 }
 //#endregion
 //#region src/runtime/scanPlugin/styleEntries/config.ts
@@ -35364,7 +35427,7 @@ function loadSubPackages(ctx) {
 		scanState.isDirty = false;
 	} else for (const meta of subPackageMap.values()) meta.entries = resolveSubPackageEntries(meta.subPackage);
 	if (scanState.appEntry) return [...subPackageMap.values()];
-	throw new Error(`在 ${configService.absoluteSrcRoot} 目录下没有找到 \`app.json\`, 请确保你初始化了小程序项目，或者在 \`vite.config.ts\` 中设置的正确的 \`weapp.srcRoot\` 配置路径  `);
+	throw new Error(`在 ${configService.absoluteSrcRoot} 目录下没有找到 \`app.json\`, 请确保你初始化了小程序项目，或者在 \`vite.config.ts\` / \`weapp-vite.config.ts\` 中设置正确的 \`weapp.srcRoot\` 配置路径`);
 }
 //#endregion
 //#region src/runtime/scanPlugin/service/index.ts
@@ -35901,6 +35964,10 @@ const DEFAULT_NODE_INCLUDE = [
 	"../vite.config.*.ts",
 	"../vite.config.mts",
 	"../vite.config.*.mts",
+	"../weapp-vite.config.ts",
+	"../weapp-vite.config.*.ts",
+	"../weapp-vite.config.mts",
+	"../weapp-vite.config.*.mts",
 	"../*.config.ts",
 	"../*.config.mts",
 	"../config/**/*.ts",

package/dist/docs/README.md

@@ -36,7 +36,7 @@
 ### Vue 项目
 
 ```typescript
-// vite.config.ts
+// vite.config.ts 或 weapp-vite.config.ts
 import { defineConfig } from 'weapp-vite/config'
 
 export default defineConfig({
@@ -46,12 +46,21 @@ export default defineConfig({
       enable: true,
       template: {
         removeComments: true,
+        htmlTagToWxml: true,
+        htmlTagToWxmlTagClass: true,
       },
     },
   },
 })
 ```
 
+如果你在把传统 HTML/Vue 模板迁移到小程序 `.vue`，这两个模板配置通常最有用：
+
+- `weapp.vue.template.htmlTagToWxml`
+  把 `div/span/img/a/h1...` 等常见 HTML 标签映射成小程序内置标签。
+- `weapp.vue.template.htmlTagToWxmlTagClass`
+  默认开启。在映射发生时追加原标签名 class，例如 `h3 -> <view class="h3">`、`br -> <view class="br" />`，便于你自己写 CSS 低成本恢复默认外观；不需要时可设为 `false`。
+
 ```vue
 <!-- App.vue -->
 <script setup>
@@ -239,7 +248,7 @@ weapp-vite mcp --workspace-root /absolute/path/to/weapp-vite
 wv mcp --workspace-root /absolute/path/to/weapp-vite
 ```
 
-在 `vite.config.ts` 中开启自动启动：
+在 `vite.config.ts` 或 `weapp-vite.config.ts` 中开启自动启动：
 
 ```ts
 import { defineConfig } from 'weapp-vite/config'

package/dist/docs/vue-sfc.md

@@ -38,6 +38,33 @@
 
 当你在页面或组件里需要显式注册原生小程序组件时，优先明确当前文件使用的 JSON 宏与配置来源，避免多个入口互相覆盖。
 
+## HTML 标签迁移辅助
+
+如果你把偏 Web 风格的模板迁到 `.vue`，可以优先关注这两个配置：
+
+- `weapp.vue.template.htmlTagToWxml`
+  把常见 HTML 标签映射为小程序内置标签。
+- `weapp.vue.template.htmlTagToWxmlTagClass`
+  默认开启。映射发生时，会再补一个原标签名 class，方便你自己用 CSS 恢复默认外观。
+
+例如：
+
+```vue
+<template>
+  <h3 class="title">
+    标题
+  </h3>
+  <br>
+</template>
+```
+
+启用默认行为后，会得到类似：
+
+```wxml
+<view class="h3 title">标题</view>
+<view class="br" />
+```
+
 ## 何时继续看其他文档
 
 - 需要更完整的编辑器提示说明：[`../volar.md`](../volar.md)

package/dist/docs/weapp-config.md

@@ -32,6 +32,16 @@ export default defineConfig({
 
 用于给页面路由追加规则，例如 layout、运行时行为等。它属于项目级编排，而不是组件内部语义。
 
+### `vue.template.htmlTagToWxml`
+
+适合从 Web/Vue 模板迁移到小程序 `.vue` 的项目。开启后，会把常见 HTML 标签映射成小程序内置标签，例如 `div -> view`、`span -> text`、`img -> image`、`a -> navigator`，也包含 `br/hr` 这类容易在迁移时“消失”的标签。
+
+### `vue.template.htmlTagToWxmlTagClass`
+
+默认开启。仅当 `htmlTagToWxml` 发生标签映射时，为输出节点追加原标签名 class，例如 `h3 -> <view class="h3">`、`br -> <view class="br" />`。
+
+如果你的迁移策略是“先跑通，再用 CSS 逐步恢复默认外观”，这个开关很有价值；如果不希望产物里自动带这层语义 class，可以显式设为 `false`。
+
 ### `layout`
 
 页面 layout 既可能来自项目级规则，也可能来自页面侧 `definePageMeta`。排查时先确认是哪一层生效。

package/dist/file-D-LpaSgY.mjs

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

package/dist/{file-x_pM3sdN.mjs → file-DllJX3aP.mjs}

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

package/dist/getInstance-BuIdW4Wd.mjs

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

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as Ref, Bn as resolveWeappViteHostMeta, C as LoadConfigOptions, D as MethodDefinitions, E as InlineConfig, F as RolldownPlugin, Fn as WeappViteHostMeta, I as RolldownPluginOption, In as WeappViteRuntime, L as RolldownWatchOptions, Ln as applyWeappViteHostMeta, M as RolldownBuild, N as RolldownOptions, O as Plugin, P as RolldownOutput, Pn as WEAPP_VITE_HOST_NAME, R as RolldownWatcher, Rn as createWeappViteHostMeta, S as CompilerContext, T as ConfigEnv, _ as definePageJson, a as UserConfigFnNoEnvPlain, c as UserConfigFnPromise, d as Component, 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, nt as WeappViteConfig, o as UserConfigFnObject, p as Sitemap, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, w as ComputedDefinitions, y as defineThemeJson, z as ViteDevServer, zn as isWeappViteHost } from "./config-B5YFoO3u.mjs";
+import { A as Ref, Bn as resolveWeappViteHostMeta, C as LoadConfigOptions, D as MethodDefinitions, E as InlineConfig, F as RolldownPlugin, Fn as WeappViteHostMeta, I as RolldownPluginOption, In as WeappViteRuntime, L as RolldownWatchOptions, Ln as applyWeappViteHostMeta, M as RolldownBuild, N as RolldownOptions, O as Plugin, P as RolldownOutput, Pn as WEAPP_VITE_HOST_NAME, R as RolldownWatcher, Rn as createWeappViteHostMeta, S as CompilerContext, T as ConfigEnv, _ as definePageJson, a as UserConfigFnNoEnvPlain, c as UserConfigFnPromise, d as Component, 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, nt as WeappViteConfig, o as UserConfigFnObject, p as Sitemap, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, w as ComputedDefinitions, y as defineThemeJson, z as ViteDevServer, zn as isWeappViteHost } from "./config-BbL8Gqez.mjs";
 import { a as createWevuComponent, i as WevuComponentOptions, n as defineProps, r as setPageLayout, t as defineEmits } from "./runtime-DSLk7kWi.mjs";
 
 //#region src/createContext.d.ts

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as createCompilerContext } from "./createContext-BuwQryVc.mjs";
+import { t as createCompilerContext } from "./createContext-BJXXIcT5.mjs";
 import { a as defineThemeJson, i as defineSitemapJson, n as defineComponentJson, r as definePageJson, t as defineAppJson } from "./json-wnfVS9jE.mjs";
 import { a as resolveWeappViteHostMeta, i as isWeappViteHost, n as applyWeappViteHostMeta, r as createWeappViteHostMeta, t as WEAPP_VITE_HOST_NAME } from "./pluginHost-BzPJL4F-.mjs";
 import { t as defineConfig } from "./config-B2xtjEug.mjs";

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-B5YFoO3u.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-BbL8Gqez.mjs";
 export { App, Component, Page, Sitemap, Theme, defineAppJson, defineComponentJson, definePageJson, defineSitemapJson, defineThemeJson };

package/dist/mcp.d.mts

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-vite",
   "type": "module",
-  "version": "6.15.4",
+  "version": "6.15.5",
   "description": "weapp-vite 一个现代化的小程序打包工具",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -117,21 +117,21 @@
     "vue": "^3.5.32",
     "vue-tsc": "^3.2.6",
     "@weapp-core/constants": "^0.1.1",
-    "@weapp-core/init": "6.0.6",
+    "@weapp-core/init": "6.0.7",
     "@weapp-core/logger": "3.1.1",
     "@weapp-core/schematics": "6.0.4",
     "@weapp-core/shared": "3.0.3",
-    "@weapp-vite/ast": "6.15.4",
+    "@weapp-vite/ast": "6.15.5",
     "@weapp-vite/mcp": "1.2.1",
     "@weapp-vite/miniprogram-automator": "1.0.2",
     "@weapp-vite/volar": "2.0.8",
     "@weapp-vite/web": "1.3.15",
     "@wevu/api": "0.2.3",
-    "@wevu/web-apis": "1.2.6",
+    "@wevu/web-apis": "1.2.7",
     "rolldown-require": "2.0.13",
     "vite-plugin-performance": "2.0.1",
     "weapp-ide-cli": "5.2.2",
-    "wevu": "6.15.4"
+    "wevu": "6.15.5"
   },
   "publishConfig": {
     "access": "public",

package/dist/file-BVlUDAip.mjs

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

package/dist/getInstance-DPy6RmDl.mjs

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