weapp-vite 6.20.4 → 6.21.0

package/README.md

@@ -47,7 +47,7 @@ export default defineConfig({
 })
 ```
 
-未配置 `weapp.hmr.runtime` 时，`wv dev` 会在启动时读取 `project.private.config.json.setting.compileHotReLoad`：开启时使用 `stateful-experimental`，关闭或无法确认时使用 `classic`。启动日志会以 `HMR 模式` 和 `HMR 切换` 两行显示最终模式、选择来源和切换方法。显式设置 `classic` 或 `stateful-experimental` 会覆盖自动选择。修改 DevTools 设置后请重启 `wv dev`；CSS、资源、配置和不兼容更新会自动回退完整构建与当前路由重载。
+未配置 `weapp.hmr.runtime` 时，`wv dev` 会在启动时读取 `project.private.config.json.setting.compileHotReLoad`：开启时使用 `stateful-experimental`，关闭或无法确认时使用 `classic`。启动日志会以 `HMR 模式` 和 `HMR 切换` 两行显示最终模式、选择来源和切换方法。显式设置 `classic` 或 `stateful-experimental` 会覆盖自动选择，但 Skyline 例外：微信开发者工具暂不支持 Skyline 热重载，首次编译检测到任意应用或页面配置使用 `renderer: 'skyline'` 时，会显示兼容性警告、自动将项目私有配置中的 `compileHotReLoad` 设为 `false`，并强制降级到 `classic`。切回 WebView 后可按需手动重新开启热重载。修改 DevTools 设置后请重启 `wv dev`；CSS、资源、配置和不兼容更新会自动回退完整构建与当前路由重载。
 
 > 说明：CLI 同时支持完整命令 `weapp-vite` 与简写命令 `wv`，两者等价。下面的示例默认使用 `weapp-vite`，你也可以按个人习惯替换成 `wv`。
 

package/dist/auto-import-components/resolvers.mjs

@@ -1,2 +1,2 @@
-import { a as TDesignResolver, i as UviewPlusResolver, n as WeuiResolver, r as VantResolver, t as WotUiResolver } from "../resolvers-w4g7O94W.mjs";
+import { a as TDesignResolver, i as UviewPlusResolver, n as WeuiResolver, r as VantResolver, t as WotUiResolver } from "../resolvers-icNxkpcy.mjs";
 export { TDesignResolver, UviewPlusResolver, VantResolver, WeuiResolver, WotUiResolver };

package/dist/auto-routes.mjs

@@ -1,4 +1,4 @@
-import { n as getCompilerContext, v as getRouteRuntimeGlobalKeys } from "./createContext-DoH-W4mj.mjs";
+import { n as getCompilerContext, v as getRouteRuntimeGlobalKeys } from "./createContext-BE57_Xi7.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 parseCommentJson, D as isPathInside, E as shouldPassPlatformArgToIdeOpen, S as loadViteConfigFile, T as getDefaultIdeProjectRoot, _ as resolveHmrProfileJsonPath, a as formatBytes, b as checkRuntime, d as getBackendForCapability, f as resolveBackendExecution, g as SHARED_CHUNK_VIRTUAL_PREFIX, h as createSharedBuildConfig, m as syncManagedTsconfigBootstrapFiles, p as syncProjectSupportFiles, t as createCompilerContext, w as createCjsConfigLoadError, x as getProjectConfigFileName, y as resolveWeappConfigFile } from "./createContext-DoH-W4mj.mjs";
+import { A as shouldPassPlatformArgToIdeOpen, C as findPreloadRuleKey, D as parseCommentJson, E as loadViteConfigFile, O as createCjsConfigLoadError, S as collectPreloadPages, T as suggestPreloadRules, _ as resolveHmrProfileJsonPath, a as formatBytes, b as checkRuntime, d as getBackendForCapability, f as resolveBackendExecution, g as SHARED_CHUNK_VIRTUAL_PREFIX, h as createSharedBuildConfig, j as isPathInside, k as getDefaultIdeProjectRoot, m as syncManagedTsconfigBootstrapFiles, p as syncProjectSupportFiles, t as createCompilerContext, w as resolvePreloadPackageIdentifier, x as getProjectConfigFileName, y as resolveWeappConfigFile } from "./createContext-BE57_Xi7.mjs";
 import { r as logger_default, t as colors } from "./logger-mt4mSTqV.mjs";
-import { h as VERSION } from "./file-DnVj_L9_.mjs";
+import { h as VERSION, i as findJsEntry, o as findTemplateEntry, s as findVueEntry } from "./file-Byldwig4.mjs";
 import { c as startWeappViteMcpServer, l as detectAiDevelopmentEnvironment, s as resolveWeappMcpConfig } from "./mcp-BG6TliEg.mjs";
 import { createRequire } from "node:module";
 import fs from "node:fs";
@@ -8,6 +8,7 @@ import path, { posix } from "pathe";
 import path$1 from "node:path";
 import { defu } from "@weapp-core/shared";
 import { fs as fs$1 } from "@weapp-core/shared/fs";
+import { parse } from "vue/compiler-sfc";
 import process from "node:process";
 import fs$2, { mkdir, writeFile } from "node:fs/promises";
 import { build, createServer } from "vite";
@@ -15,7 +16,7 @@ import os from "node:os";
 import { execFile, spawn } from "node:child_process";
 import { Buffer } from "node:buffer";
 import { cac } from "cac";
-import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, createWechatIdeLoginRequiredExitError, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, formatAutomatorLoginError, getConfig, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, parse, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveProjectAutomatorPort, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
+import { RETRY_CANCEL_KEYS, RETRY_CONFIRM_KEYS, bootstrapWechatDevtoolsSettings, buildWechatIdeNpm, clearWechatIdeCache, clearWechatIdeCacheByAutomator, closeSharedMiniProgram, closeWechatIdeProject, compileWechatIdeByAutomator, connectOpenedAutomator, createSharedInputSession, createWechatIdeLoginRequiredExitError, defaultCustomConfigFilePath, detectWechatDevtoolsServicePort, dispatchWechatCliCommand, formatAutomatorLoginError, getConfig, getWechatIdeTestAccounts, getWechatIdeTicket, getWechatIdeToolInfo, isAutomatorLoginError, isWeappIdeTopLevelCommand, isWechatIdeEngineBuildEndpointMissingError, isWechatIdeLoggedIn, isWechatIdeLoginRequiredError, isWechatIdeLoginRequiredExitError, launchAutomator, parse as parse$1, promptRetryKeypress, promptWechatIdeLoginRetry, quitWechatIde, refreshWechatIdeTicket, resetWechatIdeFileUtilsByHttp, resolveCliPath, resolveProjectAutomatorPort, runRetryableCommand, runWechatIdeEngineBuild, runWithSuspendedSharedInput, setWechatIdeTicket, startForwardConsole, takeScreenshot } from "weapp-ide-cli";
 import { promisify } from "node:util";
 import { brotliCompressSync, gzipSync } from "node:zlib";
 import { resolveCommand } from "package-manager-detector/commands";
@@ -161,7 +162,7 @@ async function executeWechatIdeCliCommand(argv, options = {}) {
 			createCancelError: (error) => createWechatIdeLoginRequiredExitError(error, "cancelled"),
 			execute: async () => {
 				try {
-					await parse(argv);
+					await parse$1(argv);
 					return null;
 				} catch (error) {
 					if (isWechatIdeLoginRequiredExitError(error)) throw error;
@@ -1069,6 +1070,177 @@ async function analyzeHmrProfile(options) {
 	};
 }
 //#endregion
+//#region src/analyze/preload/budget.ts
+const PRELOAD_LIMIT_BYTES = 2097152;
+function createPackageSizeMap$1(result) {
+	return new Map((result?.packages ?? []).map((pkg) => [pkg.id, pkg.files.reduce((total, file) => total + (file.size ?? 0), 0)]));
+}
+function getConfiguredPackages(rule, appJson) {
+	if (!rule || typeof rule !== "object" || !("packages" in rule)) return [];
+	const packages = rule.packages;
+	if (!Array.isArray(packages)) return [];
+	return packages.flatMap((item) => typeof item === "string" ? [resolvePreloadPackageIdentifier(item, appJson)] : []).filter((item) => Boolean(item));
+}
+function createPreloadBudgets(appJson, result, configuredRules, packageAnalysis) {
+	const packageSizes = createPackageSizeMap$1(packageAnalysis);
+	const bySourcePackage = /* @__PURE__ */ new Map();
+	const ensureSourcePackage = (page) => {
+		const sourcePackage = page.packageRoot ?? "__main__";
+		let entry = bySourcePackage.get(sourcePackage);
+		if (!entry) {
+			entry = {
+				sourceType: page.packageRoot ? page.independent ? "independent" : "subpackage" : "main",
+				targets: /* @__PURE__ */ new Map()
+			};
+			bySourcePackage.set(sourcePackage, entry);
+		}
+		return entry;
+	};
+	for (const page of result.pages) {
+		const configuredKey = findPreloadRuleKey(page.route, configuredRules);
+		if (configuredKey === void 0) continue;
+		const entry = ensureSourcePackage(page);
+		for (const packageRoot of getConfiguredPackages(configuredRules[configuredKey], appJson)) {
+			const target = entry.targets.get(packageRoot) ?? {
+				configured: false,
+				suggested: false
+			};
+			target.configured = true;
+			entry.targets.set(packageRoot, target);
+		}
+	}
+	const pageByRoute = new Map(result.pages.map((page) => [page.route, page]));
+	for (const suggestion of result.suggestions) {
+		const page = pageByRoute.get(suggestion.page);
+		if (!page) continue;
+		const entry = ensureSourcePackage(page);
+		const target = entry.targets.get(suggestion.packageRoot) ?? {
+			configured: false,
+			suggested: false
+		};
+		target.suggested = true;
+		entry.targets.set(suggestion.packageRoot, target);
+	}
+	return [...bySourcePackage.entries()].map(([sourcePackage, entry]) => {
+		const targets = [...entry.targets.entries()].map(([packageRoot, state]) => {
+			const packageId = packageRoot === "__APP__" ? "__main__" : packageRoot;
+			return {
+				packageRoot,
+				bytes: packageSizes.get(packageId),
+				...state
+			};
+		}).sort((left, right) => left.packageRoot.localeCompare(right.packageRoot));
+		const unknownPackages = targets.filter((target) => target.bytes === void 0).map((target) => target.packageRoot);
+		const estimatedBytes = targets.reduce((total, target) => total + (target.bytes ?? 0), 0);
+		const status = estimatedBytes > PRELOAD_LIMIT_BYTES ? "exceeded" : unknownPackages.length > 0 ? "unknown" : "ok";
+		return {
+			sourcePackage,
+			sourceType: entry.sourceType,
+			limitBytes: PRELOAD_LIMIT_BYTES,
+			estimatedBytes,
+			remainingBytes: unknownPackages.length === 0 ? Math.max(0, PRELOAD_LIMIT_BYTES - estimatedBytes) : void 0,
+			status,
+			targets,
+			unknownPackages
+		};
+	}).sort((left, right) => left.sourcePackage.localeCompare(right.sourcePackage));
+}
+//#endregion
+//#region src/analyze/preload/index.ts
+async function readFileIfExists(filePath) {
+	if (!filePath) return;
+	try {
+		return await fs$1.readFile(filePath, "utf8");
+	} catch {
+		return;
+	}
+}
+function splitVueSource(source, filename) {
+	try {
+		const { descriptor } = parse(source, { filename });
+		return {
+			template: descriptor.template?.content,
+			script: [descriptor.script?.content, descriptor.scriptSetup?.content].filter((content) => Boolean(content)).join("\n")
+		};
+	} catch {
+		return {
+			template: source,
+			script: source
+		};
+	}
+}
+async function collectPageSources(ctx, route) {
+	const base = path.resolve(ctx.configService.absoluteSrcRoot, route);
+	const [templateEntry, scriptEntry, vueEntry] = await Promise.all([
+		findTemplateEntry(base, ctx.configService.platform),
+		findJsEntry(base),
+		findVueEntry(base)
+	]);
+	if (vueEntry) {
+		const source = await readFileIfExists(vueEntry);
+		return source ? splitVueSource(source, vueEntry) : {};
+	}
+	const [template, script] = await Promise.all([readFileIfExists(templateEntry.path), readFileIfExists(scriptEntry.path)]);
+	return {
+		template,
+		script
+	};
+}
+function aggregateSuggestions(result, configuredRules, appJson) {
+	const byPage = /* @__PURE__ */ new Map();
+	for (const suggestion of result.suggestions) {
+		const current = byPage.get(suggestion.page) ?? {
+			page: suggestion.page,
+			packages: [],
+			evidence: [],
+			alreadyConfigured: []
+		};
+		if (!current.packages.includes(suggestion.packageRoot)) current.packages.push(suggestion.packageRoot);
+		current.evidence.push({
+			target: suggestion.target,
+			packageRoot: suggestion.packageRoot,
+			source: suggestion.source
+		});
+		const configuredKey = findPreloadRuleKey(suggestion.page, configuredRules);
+		const existingRule = configuredKey === void 0 ? void 0 : configuredRules[configuredKey];
+		const existingPackages = existingRule && typeof existingRule === "object" && "packages" in existingRule ? existingRule.packages : void 0;
+		if ((Array.isArray(existingPackages) ? existingPackages.flatMap((item) => typeof item === "string" ? [resolvePreloadPackageIdentifier(item, appJson)] : []) : []).includes(suggestion.packageRoot)) current.alreadyConfigured.push(suggestion.packageRoot);
+		byPage.set(suggestion.page, current);
+	}
+	return [...byPage.values()].map((suggestion) => ({
+		...suggestion,
+		packages: suggestion.packages.sort(),
+		alreadyConfigured: [...new Set(suggestion.alreadyConfigured)].sort(),
+		evidence: suggestion.evidence.sort((left, right) => left.target.localeCompare(right.target))
+	}));
+}
+async function analyzePreloadRules(ctx, options = {}) {
+	const appJson = (await ctx.scanService.loadAppEntry()).json;
+	const pages = collectPreloadPages(appJson);
+	const pageSources = /* @__PURE__ */ new Map();
+	const sourceEntries = await Promise.all(pages.map(async (page) => [page.route, await collectPageSources(ctx, page.route)]));
+	for (const [route, source] of sourceEntries) pageSources.set(route, source);
+	const configuredRules = appJson.preloadRule && typeof appJson.preloadRule === "object" ? appJson.preloadRule : {};
+	const suggestions = suggestPreloadRules(appJson, pageSources);
+	return {
+		runtime: "mini",
+		kind: "preload",
+		generatedAt: (options.now ?? /* @__PURE__ */ new Date()).toISOString(),
+		platform: ctx.configService.platform,
+		pages: pages.map((page) => page.route),
+		configuredRules,
+		suggestions: aggregateSuggestions(suggestions, configuredRules, appJson),
+		budgets: createPreloadBudgets(appJson, suggestions, configuredRules, options.packageAnalysis),
+		uncoveredPages: suggestions.uncovered,
+		limitations: [
+			"仅分析静态路由字面量；动态路由、后端配置和运行时守卫不会被推断。",
+			"建议使用分包 root 作为 packages 值；预算按触发页所属包聚合，未知体积目标仍需人工复核。",
+			"静态跳转只能证明可达性，不能代表真实访问频率，正式启用前仍需结合业务数据确认。",
+			"该命令只提供可审计建议，不会自动修改源码或覆盖手写的 app.json.preloadRule。"
+		]
+	};
+}
+//#endregion
 //#region src/analyze/components/suggestions.ts
 function createComponentSuggestion(usage) {
 	if (usage.componentPackage !== "__main__" || usage.crossPackageUsageCount === 0) return;
@@ -2469,6 +2641,23 @@ async function startAnalyzeDashboard(result, options) {
 	await waitPromise;
 }
 //#endregion
+//#region src/cli/processCleanup.ts
+function isSassEmbeddedChild(handle) {
+	if (!handle || typeof handle !== "object") return false;
+	const child = handle;
+	const spawnfile = typeof child.spawnfile === "string" ? child.spawnfile : "";
+	const spawnargs = Array.isArray(child.spawnargs) ? child.spawnargs : [];
+	return Boolean("kill" in handle && "spawnfile" in handle && (spawnfile.includes("sass-embedded") || spawnfile.includes("dart-sass") && spawnargs.includes("--embedded")));
+}
+function terminateStaleSassEmbeddedProcess() {
+	const getHandles = process._getActiveHandles;
+	const handles = typeof getHandles === "function" ? getHandles() : void 0;
+	if (!Array.isArray(handles)) return;
+	for (const handle of handles) if (isSassEmbeddedChild(handle)) try {
+		handle.kill();
+	} catch {}
+}
+//#endregion
 //#region src/cli/commands/analyze.ts
 function normalizeDisplayPath(value) {
 	return value || ".";
@@ -2583,6 +2772,27 @@ function printWebAnalysisSummary(result) {
 	logger_default.warn(`- 未支持范围：${result.unsupportedScopes.join("；")}`);
 	for (const limitation of result.limitations) logger_default.warn(`- 限制：${limitation}`);
 }
+function printPreloadAnalysisSummary(result) {
+	logger_default.success("preloadRule 静态分析完成");
+	if (result.suggestions.length === 0) logger_default.info("未检测到可以证明的跨分包静态跳转。");
+	for (const suggestion of result.suggestions) {
+		const packages = suggestion.packages.join("、");
+		const covered = suggestion.alreadyConfigured.length > 0 ? `，已配置：${suggestion.alreadyConfigured.join("、")}` : "";
+		logger_default.info(`- ${suggestion.page} -> ${packages}${covered}`);
+		for (const evidence of suggestion.evidence.slice(0, 5)) logger_default.info(`  - ${evidence.source}：${evidence.target}`);
+	}
+	if (result.uncoveredPages.length > 0) logger_default.warn(`- 未找到可扫描源码的页面：${result.uncoveredPages.join("、")}`);
+	if (result.budgets.length > 0) {
+		logger_default.info("预下载额度：");
+		for (const budget of result.budgets) {
+			const size = `${formatAnalyzeBytes(budget.estimatedBytes)} / ${formatAnalyzeBytes(budget.limitBytes)}`;
+			const unknown = budget.unknownPackages.length > 0 ? `，未知：${budget.unknownPackages.join("、")}` : "";
+			const status = budget.status === "exceeded" ? "超限" : budget.status === "unknown" ? "待确认" : "正常";
+			logger_default.info(`- ${budget.sourcePackage}：${size}，${status}${unknown}`);
+		}
+	}
+	for (const limitation of result.limitations) logger_default.warn(`- 限制：${limitation}`);
+}
 async function writeAnalyzeResult(result, outputOption, configService, format = "json", previousResult) {
 	if (!outputOption) return;
 	const baseDir = configService.cwd;
@@ -2703,7 +2913,7 @@ function printHmrProfileAnalysisSummary(result, configService) {
 	}
 }
 function registerAnalyzeCommand(cli) {
-	cli.command("analyze [root]", "analyze 两端包体与源码映射").option("--hmr-profile [file]", `[string | boolean] 分析 HMR JSONL profile，省略值时优先读取配置，否则回退到默认路径`).option("--json", `[boolean] 输出 JSON 结果`).option("--markdown", `[boolean] 输出 Markdown 报告`).option("--report <type>", `[string] 输出指定报告类型（pr）`).option("--budget-check", `[boolean] 检查 analyze 预算，超过预算时返回非 0 退出码`).option("--output <file>", `[string] 将分析结果写入指定文件（JSON 或 Markdown）`).option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).action(async (root, options) => {
+	cli.command("analyze [root]", "analyze 两端包体与源码映射").option("--hmr-profile [file]", `[string | boolean] 分析 HMR JSONL profile，省略值时优先读取配置，否则回退到默认路径`).option("--json", `[boolean] 输出 JSON 结果`).option("--markdown", `[boolean] 输出 Markdown 报告`).option("--report <type>", `[string] 输出指定报告类型（pr）`).option("--budget-check", `[boolean] 检查 analyze 预算，超过预算时返回非 0 退出码`).option("--preload", `[boolean] 分析静态页面跳转、实际分包体积和 preloadRule 额度`).option("--output <file>", `[string] 将分析结果写入指定文件（JSON 或 Markdown）`).option("-p, --platform <platform>", `[string] target platform (weapp | web)`).option("--project-config <path>", `[string] project config path (miniprogram only)`).action(async (root, options) => {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const outputJson = coerceBooleanOption(options.json);
@@ -2714,8 +2924,9 @@ function registerAnalyzeCommand(cli) {
 		const budgetCheck = coerceBooleanOption(options.budgetCheck);
 		const targets = resolveRuntimeTargets(options);
 		const inlineConfig = createInlineConfig(targets);
+		let ctx;
 		try {
-			const ctx = await createCompilerContext({
+			ctx = await createCompilerContext({
 				cwd: root,
 				mode: options.mode ?? "production",
 				configFile,
@@ -2743,6 +2954,15 @@ function registerAnalyzeCommand(cli) {
 				} else printHmrProfileAnalysisSummary(hmrProfileResult, ctx.configService);
 				return;
 			}
+			if (coerceBooleanOption(options.preload)) {
+				if (targets.kind !== "miniprogram" || ctx.configService.platform !== "weapp") throw new Error("preloadRule 分析目前仅支持微信小程序平台。");
+				const packageAnalysis = await analyzeSubpackages(ctx);
+				const preloadResult = await analyzePreloadRules(ctx, { packageAnalysis });
+				const writtenPath = await writeAnalyzeResult(preloadResult, outputOption, ctx.configService);
+				if (outputJson && !writtenPath) process.stdout.write(`${JSON.stringify(preloadResult, null, 2)}\n`);
+				if (!outputJson && !writtenPath) printPreloadAnalysisSummary(preloadResult);
+				return;
+			}
 			if (getBackendForCapability(targets, "web", "analyze")) {
 				const webResult = createWebAnalyzeResult(ctx.configService, { platform: "web" });
 				const writtenPath = await writeAnalyzeResult(webResult, outputOption, ctx.configService);
@@ -2780,6 +3000,11 @@ function registerAnalyzeCommand(cli) {
 		} catch (error) {
 			logger_default.error(error);
 			process.exitCode = 1;
+		} finally {
+			if (ctx) {
+				for (const backend of [...targets.entries].reverse()) if (backend.descriptor.capabilities.analyze) await backend.driver?.close?.(ctx);
+			}
+			terminateStaleSassEmbeddedProcess();
 		}
 	});
 }
@@ -2881,17 +3106,6 @@ function setCommandNodeEnv(nodeEnv) {
 }
 //#endregion
 //#region src/cli/commands/build.ts
-function isSassEmbeddedChild(handle) {
-	return Boolean(handle && typeof handle === "object" && "kill" in handle && "spawnfile" in handle && typeof handle.spawnfile === "string" && handle.spawnfile?.includes("sass-embedded"));
-}
-function terminateStaleSassEmbeddedProcess() {
-	const getHandles = process._getActiveHandles;
-	const handles = typeof getHandles === "function" ? getHandles() : void 0;
-	if (!Array.isArray(handles)) return;
-	for (const handle of handles) if (isSassEmbeddedChild(handle)) try {
-		handle.kill();
-	} catch {}
-}
 function emitDashboardEvents$1(handle, events) {
 	handle?.emitRuntimeEvents(events);
 }
@@ -4731,7 +4945,7 @@ function resolveRunnableHotkeyDefinition(input) {
 }
 //#endregion
 //#region package.json
-var version = "6.20.4";
+var version = "6.21.0";
 //#endregion
 //#region src/cli/devHotkeys/format.ts
 const FULLWIDTH_ASCII_START = 65281;

package/dist/{config-C810aRQQ.d.mts → config-Pi3hdn_g.d.mts}

@@ -151,29 +151,36 @@ interface SubPackage {
    */
   inlineConfig?: Partial<InlineConfig>;
 }
-type SubPackageStyleScope = 'all' | 'pages' | 'components';
-interface SubPackageStyleConfigObject {
-  /** 样式文件路径，可以是相对分包 root、相对 `srcRoot` 或绝对路径 */
+type StyleScope = 'all' | 'pages' | 'components';
+interface StyleConfigObject {
+  /** 样式文件路径，可以是相对当前包 root、相对 `srcRoot` 或绝对路径 */
   source: string;
   /**
    * @description 作用范围快捷配置
    */
-  scope?: SubPackageStyleScope;
-  /** 自定义包含路径，支持传入单个 glob 或数组，默认覆盖分包内所有文件 */
+  scope?: StyleScope;
+  /** 自定义包含路径，支持传入单个 glob 或数组，默认覆盖当前包内所有文件 */
   include?: string | string[];
   /** 自定义排除路径，支持传入单个 glob 或数组 */
   exclude?: string | string[];
+  /** 是否自动向命中的页面或组件样式注入 `@import`，关闭后只生成独立样式文件 */
+  inject?: boolean;
 }
-type SubPackageStyleConfigEntry = string | SubPackageStyleConfigObject;
-interface SubPackageStyleEntry {
+type StyleConfigEntry = string | StyleConfigObject;
+interface StyleEntry {
   source: string;
   absolutePath: string;
   outputRelativePath: string;
   inputExtension: string;
-  scope: SubPackageStyleScope;
+  scope: StyleScope;
   include: string[];
   exclude: string[];
+  inject?: boolean;
 }
+type SubPackageStyleScope = StyleScope;
+type SubPackageStyleConfigObject = StyleConfigObject;
+type SubPackageStyleConfigEntry = StyleConfigEntry;
+type SubPackageStyleEntry = StyleEntry;
 type GenerateExtensionsOptions = Partial<{
   js: 'js' | 'ts' | (string & {});
   json: 'js' | 'ts' | 'json' | (string & {});
@@ -342,6 +349,10 @@ interface ChunksConfig {
   sharedMode?: SharedChunkMode;
   sharedOverrides?: SharedChunkOverride[];
   sharedPathRoot?: string;
+  /**
+   * @description 按 srcRoot 相对路径保留匹配源码模块的独立输出边界
+   */
+  preserveModules?: (string | RegExp)[];
   dynamicImports?: SharedChunkDynamicImports;
   logOptimization?: boolean;
   forceDuplicatePatterns?: (string | RegExp)[];
@@ -562,7 +573,7 @@ interface WeappSubPackageConfig {
   inlineConfig?: Partial<InlineConfig>;
   autoImportComponents?: AutoImportComponentsOption;
   watchSharedStyles?: boolean;
-  styles?: SubPackageStyleConfigEntry | SubPackageStyleConfigEntry[];
+  styles?: StyleConfigEntry | StyleConfigEntry[];
 }
 /**
  * @description HMR 配置
@@ -656,8 +667,17 @@ interface WeappReactConfig {
   renderMode?: 'auto' | 'dynamic' | 'static';
   devWarnings?: boolean;
 }
+type WeappPreloadNetwork = 'all' | 'wifi';
+/**
+ * @description 页面进入后的分包预下载规则。
+ */
+interface WeappPreloadRule {
+  packages: string[];
+  network?: WeappPreloadNetwork;
+}
 interface WeappRouteRule {
   appLayout?: PageLayoutMeta;
+  preload?: WeappPreloadRule;
 }
 type WeappRouteRules = Record<string, WeappRouteRule>;
 //#endregion
@@ -669,7 +689,7 @@ interface SubPackageMetaValue {
   entries: string[];
   subPackage: SubPackage;
   autoImportComponents?: AutoImportComponentsOption;
-  styleEntries?: SubPackageStyleEntry[];
+  styleEntries?: StyleEntry[];
   watchSharedStyles?: boolean;
 }
 /**
@@ -812,6 +832,10 @@ interface WeappViteConfig {
   npm?: WeappNpmConfig;
   generate?: GenerateOptions;
   tsconfigPaths?: boolean | PluginOptions;
+  /**
+   * 主包共享样式入口。生成独立样式文件，并按配置注入主包与普通分包页面或组件。
+   */
+  styles?: StyleConfigEntry | StyleConfigEntry[];
   subPackages?: Record<string, WeappSubPackageConfig>;
   copy?: CopyOptions;
   web?: WeappWebConfig;
@@ -1817,6 +1841,7 @@ interface RuntimeState {
     emittedCode: Map<string, string>;
   };
   scan: {
+    mainPackageStyleEntries?: StyleEntry[];
     subPackageMap: Map<string, SubPackageMetaValue>;
     independentSubPackageMap: Map<string, SubPackageMetaValue>;
     warnedMessages: Set<string>;
@@ -1844,6 +1869,7 @@ interface ScanService {
   appEntry?: AppEntry;
   pluginJson?: Plugin;
   pluginJsonPath?: string;
+  readonly mainPackageStyleEntries: StyleEntry[] | undefined;
   subPackageMap: Map<string, SubPackageMetaValue>;
   independentSubPackageMap: Map<string, SubPackageMetaValue>;
   loadAppEntry: () => Promise<AppEntry>;
@@ -2033,4 +2059,4 @@ declare module 'vite' {
  */
 declare function defineConfig<T extends UserConfigExport>(config: T): T;
 //#endregion
-export { WeappAnalyzeBudgetConfig as $, WeappViteRuntime as $n, GenerateTemplate as $t, Ref as A, WeappLibComponentJson as An, WeappRequestRuntimeConfig as At, BindingErrorLike as B, WeappManagedSharedTsconfigConfig as Bn, Alias as Bt, LoadConfigOptions as C, SharedChunkOverride as Cn, WeappInjectWeapiConfig as Ct, MethodDefinitions$1 as D, SubPackageStyleConfigObject as Dn, WeappNpmConfig as Dt, InlineConfig$1 as E, SubPackageStyleConfigEntry as En, WeappMcpConfig as Et, RolldownPlugin as F, WeappLibInternalDtsOptions as Fn, WeappVueConfig as Ft, EntryJsonFragment as G, applyWeappViteHostMeta as Gn, CopyGlobs as Gt, BaseEntry as H, WeappWebConfig as Hn, AlipayNpmMode as Ht, RolldownPluginOption as I, WeappLibVueTscOptions as In, WeappVueTemplateConfig as It, ScanComponentItem as J, resolveWeappViteHostMeta as Jn, GenerateDirsOptions as Jt, PageEntry as K, createWeappViteHostMeta as Kn, CopyOptions as Kt, RolldownWatchOptions as L, WeappManagedAppTsconfigConfig as Ln, WeappWebRuntimeConfig as Lt, RolldownBuild as M, WeappLibDtsOptions as Mn, WeappRouteRules as Mt, RolldownOptions as N, WeappLibEntryContext as Nn, WeappSubPackageConfig as Nt, Plugin$1 as O, SubPackageStyleEntry as On, WeappReactCompilerConfig as Ot, RolldownOutput$1 as P, WeappLibFileName as Pn, WeappUniAppConfig as Pt, UserConfig$2 as Q, WeappVitePlatform as Qn, GenerateOptions as Qt, RolldownWatcher$1 as R, WeappManagedNodeTsconfigConfig as Rn, WeappWevuConfig as Rt, CompilerContext as S, SharedChunkMode as Sn, WeappInjectRequestGlobalsTarget as St, ConfigEnv$1 as T, SubPackage as Tn, WeappInjectWebRuntimeGlobalsTarget as Tt, ComponentEntry as U, WEAPP_VITE_HOST_NAME as Un, BuildNpmPackageMeta as Ut, AppEntry as V, WeappManagedTypeScriptConfig as Vn, AliasOptions as Vt, Entry as W, WeappViteHostMeta as Wn, ChunksConfig as Wt, ProjectConfig as X, ResolvedWeappViteTarget as Xn, GenerateFileType as Xt, WxmlDep as Y, ResolveWeappViteTargetOptions as Yn, GenerateExtensionsOptions as Yt, SubPackageMetaValue as Z, WEB_PLATFORM_ALIASES as Zn, GenerateFilenamesOptions as Zt, definePageJson as _, NpmPluginPackageConfig as _n, WeappAutoRoutesIncludePattern as _t, UserConfigFnNoEnvPlain as a, GenerateTemplateScope as an, getSupportedWeappViteTargetDescriptors as ar, WeappViteConfig as at, ChangeEvent as b, ResolvedAlias as bn, WeappHmrConfig as bt, UserConfigFnPromise as c, JsonConfig as cn, EnhanceOptions as ct, Component$1 as d, JsonMergeStage as dn, MultiPlatformConfig as dt, GenerateTemplateContext as en, WeappViteTargetDescriptor as er, WeappAnalyzeConfig as et, Page$1 as f, JsonMergeStrategy as fn, ScanWxmlOptions as ft, defineComponentJson as g, NpmMainPackageConfig as gn, WeappAutoRoutesInclude as gt, defineAppJson as h, NpmDependencyPattern as hn, WeappAutoRoutesConfig as ht, UserConfigFnNoEnv as i, GenerateTemplateInlineSource as in, getSupportedWeappVitePlatforms as ir, WeappForwardConsoleLogLevel as it, ResolvedConfig as j, WeappLibConfig as jn, WeappRouteRule as jt, PluginOption as k, SubPackageStyleScope as kn, WeappReactConfig as kt, defineConfig as l, JsonMergeContext as ln, EnhanceWxmlOptions as lt, Theme$1 as m, NpmBuildOptions as mn, WeappAppPreludeMode as mt, UserConfigExport as n, GenerateTemplateFactory as nn, WeappViteTargetKind as nr, WeappDebugConfig as nt, UserConfigFnObject as o, GenerateTemplatesConfig as on, isWebPlatform as or, AutoImportComponents as ot, Sitemap$1 as p, MpPlatform$1 as pn, WeappAppPreludeConfig as pt, ComponentsMap as q, isWeappViteHost as qn, DeprecatedInlineDynamicImports as qt, UserConfigFn as r, GenerateTemplateFileSource as rn, WebPlatform as rr, WeappForwardConsoleConfig as rt, UserConfigFnObjectPlain as s, JsFormat as sn, resolveWeappViteTarget as sr, AutoImportComponentsOption as st, UserConfig$1 as t, GenerateTemplateEntry as tn, WeappViteTargetInput as tr, WeappAnalyzeHistoryConfig as tt, App$1 as u, JsonMergeFunction as un, HandleWxmlOptions as ut, defineSitemapJson as v, NpmStrategy as vn, WeappBuildScopeConfig as vt, ComputedDefinitions$1 as w, SharedChunkStrategy as wn, WeappInjectWebRuntimeGlobalsConfig as wt, WeappVitePluginApi as x, SharedChunkDynamicImports as xn, WeappInjectRequestGlobalsConfig as xt, defineThemeJson as y, NpmSubPackageConfig as yn, WeappBuildScopeObjectConfig as yt, ViteDevServer$1 as z, WeappManagedServerTsconfigConfig as zn, WeappWorkerConfig as zt };
+export { WeappAnalyzeBudgetConfig as $, isWeappViteHost as $n, GenerateFilenamesOptions as $t, Ref as A, StyleScope as An, WeappReactCompilerConfig as At, BindingErrorLike as B, WeappLibFileName as Bn, WeappWevuConfig as Bt, LoadConfigOptions as C, SharedChunkDynamicImports as Cn, WeappInjectWeapiConfig as Ct, MethodDefinitions$1 as D, StyleConfigEntry as Dn, WeappNpmConfig as Dt, InlineConfig$1 as E, SharedChunkStrategy as En, WeappMcpConfig as Et, RolldownPlugin as F, SubPackageStyleScope as Fn, WeappSubPackageConfig as Ft, EntryJsonFragment as G, WeappManagedServerTsconfigConfig as Gn, BuildNpmPackageMeta as Gt, BaseEntry as H, WeappLibVueTscOptions as Hn, Alias as Ht, RolldownPluginOption as I, WeappLibComponentJson as In, WeappUniAppConfig as It, ScanComponentItem as J, WeappWebConfig as Jn, CopyOptions as Jt, PageEntry as K, WeappManagedSharedTsconfigConfig as Kn, ChunksConfig as Kt, RolldownWatchOptions as L, WeappLibConfig as Ln, WeappVueConfig as Lt, RolldownBuild as M, SubPackageStyleConfigEntry as Mn, WeappRequestRuntimeConfig as Mt, RolldownOptions as N, SubPackageStyleConfigObject as Nn, WeappRouteRule as Nt, Plugin$1 as O, StyleConfigObject as On, WeappPreloadNetwork as Ot, RolldownOutput$1 as P, SubPackageStyleEntry as Pn, WeappRouteRules as Pt, UserConfig$2 as Q, createWeappViteHostMeta as Qn, GenerateFileType as Qt, RolldownWatcher$1 as R, WeappLibDtsOptions as Rn, WeappVueTemplateConfig as Rt, CompilerContext as S, ResolvedAlias as Sn, WeappInjectRequestGlobalsTarget as St, ConfigEnv$1 as T, SharedChunkOverride as Tn, WeappInjectWebRuntimeGlobalsTarget as Tt, ComponentEntry as U, WeappManagedAppTsconfigConfig as Un, AliasOptions as Ut, AppEntry as V, WeappLibInternalDtsOptions as Vn, WeappWorkerConfig as Vt, Entry as W, WeappManagedNodeTsconfigConfig as Wn, AlipayNpmMode as Wt, ProjectConfig as X, WeappViteHostMeta as Xn, GenerateDirsOptions as Xt, WxmlDep as Y, WEAPP_VITE_HOST_NAME as Yn, DeprecatedInlineDynamicImports as Yt, SubPackageMetaValue as Z, applyWeappViteHostMeta as Zn, GenerateExtensionsOptions as Zt, definePageJson as _, NpmDependencyPattern as _n, WeappAutoRoutesIncludePattern as _t, UserConfigFnNoEnvPlain as a, GenerateTemplateFileSource as an, WeappViteRuntime as ar, WeappViteConfig as at, ChangeEvent as b, NpmStrategy as bn, WeappHmrConfig as bt, UserConfigFnPromise as c, GenerateTemplatesConfig as cn, WeappViteTargetKind as cr, EnhanceOptions as ct, Component$1 as d, JsonMergeContext as dn, getSupportedWeappViteTargetDescriptors as dr, MultiPlatformConfig as dt, GenerateOptions as en, resolveWeappViteHostMeta as er, WeappAnalyzeConfig as et, Page$1 as f, JsonMergeFunction as fn, isWebPlatform as fr, ScanWxmlOptions as ft, defineComponentJson as g, NpmBuildOptions as gn, WeappAutoRoutesInclude as gt, defineAppJson as h, MpPlatform$1 as hn, WeappAutoRoutesConfig as ht, UserConfigFnNoEnv as i, GenerateTemplateFactory as in, WeappVitePlatform as ir, WeappForwardConsoleLogLevel as it, ResolvedConfig as j, SubPackage as jn, WeappReactConfig as jt, PluginOption as k, StyleEntry as kn, WeappPreloadRule as kt, defineConfig as l, JsFormat as ln, WebPlatform as lr, EnhanceWxmlOptions as lt, Theme$1 as m, JsonMergeStrategy as mn, WeappAppPreludeMode as mt, UserConfigExport as n, GenerateTemplateContext as nn, ResolvedWeappViteTarget as nr, WeappDebugConfig as nt, UserConfigFnObject as o, GenerateTemplateInlineSource as on, WeappViteTargetDescriptor as or, AutoImportComponents as ot, Sitemap$1 as p, JsonMergeStage as pn, resolveWeappViteTarget as pr, WeappAppPreludeConfig as pt, ComponentsMap as q, WeappManagedTypeScriptConfig as qn, CopyGlobs as qt, UserConfigFn as r, GenerateTemplateEntry as rn, WEB_PLATFORM_ALIASES as rr, WeappForwardConsoleConfig as rt, UserConfigFnObjectPlain as s, GenerateTemplateScope as sn, WeappViteTargetInput as sr, AutoImportComponentsOption as st, UserConfig$1 as t, GenerateTemplate as tn, ResolveWeappViteTargetOptions as tr, WeappAnalyzeHistoryConfig as tt, App$1 as u, JsonConfig as un, getSupportedWeappVitePlatforms as ur, HandleWxmlOptions as ut, defineSitemapJson as v, NpmMainPackageConfig as vn, WeappBuildScopeConfig as vt, ComputedDefinitions$1 as w, SharedChunkMode as wn, WeappInjectWebRuntimeGlobalsConfig as wt, WeappVitePluginApi as x, NpmSubPackageConfig as xn, WeappInjectRequestGlobalsConfig as xt, defineThemeJson as y, NpmPluginPackageConfig as yn, WeappBuildScopeObjectConfig as yt, ViteDevServer$1 as z, WeappLibEntryContext as zn, WeappWebRuntimeConfig as zt };

package/dist/config.d.mts

@@ -1,2 +1,2 @@
-import { $n as WeappViteRuntime, Gn as applyWeappViteHostMeta, Jn as resolveWeappViteHostMeta, Kn as createWeappViteHostMeta, Un as WEAPP_VITE_HOST_NAME, Wn as WeappViteHostMeta, _ 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, qn as isWeappViteHost, r as UserConfigFn, s as UserConfigFnObjectPlain, t as UserConfig, u as App, v as defineSitemapJson, y as defineThemeJson } from "./config-C810aRQQ.mjs";
+import { $n as isWeappViteHost, Qn as createWeappViteHostMeta, Xn as WeappViteHostMeta, Yn as WEAPP_VITE_HOST_NAME, Zn as applyWeappViteHostMeta, _ as definePageJson, a as UserConfigFnNoEnvPlain, ar as WeappViteRuntime, at as WeappViteConfig, c as UserConfigFnPromise, d as Component, er as resolveWeappViteHostMeta, 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 } from "./config-Pi3hdn_g.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 };