weapp-vite 6.11.3 → 6.11.5

package/README.md

@@ -85,6 +85,39 @@ function handleClick() {
 - Vite 插件识别 weapp-vite 宿主：https://vite.icebreaker.top/guide/vite-plugin-host
 - MCP 集成使用指南：[docs/mcp.md](./docs/mcp.md)
 
+## DevTools 日志桥接
+
+`weapp-vite` 现在支持把微信开发者工具里的小程序 `console` 输出桥接到当前终端。
+
+默认行为：
+
+- `weapp.forwardConsole` 默认是 `enabled: 'auto'`
+- 当检测到当前运行环境是 AI 终端时，`weapp-vite dev --open` 会自动尝试附加日志桥
+- 也可以手动进入持续监听模式
+
+配置示例：
+
+```ts
+import { defineConfig } from 'weapp-vite/config'
+
+export default defineConfig({
+  weapp: {
+    forwardConsole: {
+      enabled: 'auto',
+      logLevels: ['log', 'info', 'warn', 'error'],
+      unhandledErrors: true,
+    },
+  },
+})
+```
+
+手动启动持续监听：
+
+```sh
+weapp-vite ide logs
+weapp-vite ide logs --open
+```
+
 ## CLI 中调用 weapp-ide-cli
 
 `weapp-vite` 内置了对 `weapp-ide-cli` 的透传能力，除了 `dev/build/open/init/generate/analyze/npm` 等原生命令外，其它 IDE 相关命令都可以直接调用：
@@ -101,6 +134,7 @@ weapp-vite navigate pages/index/index --project ./dist/build/mp-weixin
 ```sh
 weapp-vite ide preview --project ./dist/build/mp-weixin
 weapp-vite ide config show
+weapp-vite ide logs --open
 ```
 
 ## CLI 启动 MCP

package/dist/auto-routes.mjs

@@ -1,6 +1,4 @@
-import { i as getCompilerContext } from "./createContext-DzgL8nmB.mjs";
-import "./logger-gutcwWKE.mjs";
-import "./file-D6dnM58g.mjs";
+import { i as getCompilerContext } from "./createContext-BzGZK60x.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 normalizeMiniPlatform, d as SHARED_CHUNK_VIRTUAL_PREFIX, f as resolveWeappConfigFile, g as isPathInside, h as createCjsConfigLoadError, l as resolveMiniPlatform, m as getProjectConfigFileName, n as syncProjectSupportFiles, o as formatBytes, p as checkRuntime, r as syncManagedTsconfigBootstrapFiles, s as DEFAULT_MP_PLATFORM, t as createCompilerContext, u as createSharedBuildConfig } from "./createContext-DzgL8nmB.mjs";
+import { c as normalizeMiniPlatform, d as SHARED_CHUNK_VIRTUAL_PREFIX, f as resolveWeappConfigFile, g as isPathInside, h as createCjsConfigLoadError, l as resolveMiniPlatform, m as getProjectConfigFileName, n as syncProjectSupportFiles, o as formatBytes, p as checkRuntime, r as syncManagedTsconfigBootstrapFiles, s as DEFAULT_MP_PLATFORM, t as createCompilerContext, u as createSharedBuildConfig } from "./createContext-BzGZK60x.mjs";
 import { r as logger_default, t as colors } from "./logger-gutcwWKE.mjs";
-import { f as VERSION } from "./file-D6dnM58g.mjs";
+import { f as VERSION } from "./file-CHBdQW3o.mjs";
 import { resolveWeappMcpConfig, startWeappViteMcpServer } from "./mcp.mjs";
 import { defu } from "@weapp-core/shared";
 import path, { posix } from "pathe";
@@ -8,12 +8,15 @@ import fs from "fs-extra";
 import process from "node:process";
 import { build, createServer, loadConfigFromFile } from "vite";
 import { getPackageInfoSync } from "local-pkg";
+import { execFile } from "node:child_process";
 import { Buffer } from "node:buffer";
 import fs$1 from "node:fs";
 import { cac } from "cac";
 import { resolveCommand } from "package-manager-detector/commands";
-import { formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, parse, waitForRetryKeypress } from "weapp-ide-cli";
+import { promisify } from "node:util";
+import { formatRetryHotkeyPrompt, formatWechatIdeLoginRequiredError, getConfig, isWeappIdeTopLevelCommand, isWechatIdeLoginRequiredError, parse, startForwardConsole, waitForRetryKeypress } from "weapp-ide-cli";
 import { generateJs, generateJson, generateWxml, generateWxss } from "@weapp-core/schematics";
+import { determineAgent } from "@vercel/detect-agent";
 import { initConfig } from "@weapp-core/init";
 //#region src/analyze/subpackages/classifier.ts
 const VIRTUAL_MODULE_INDICATOR = "\0";
@@ -759,12 +762,71 @@ function logBuildPackageSizeReport(options) {
 }
 //#endregion
 //#region src/cli/openIde.ts
+const execFileAsync = promisify(execFile);
 async function openIde(platform, projectPath) {
 	const argv = ["open", "-p"];
 	if (projectPath) argv.push(projectPath);
 	if (platform === "alipay") argv.push("--platform", platform);
 	await runWechatIdeOpenWithRetry(argv);
 }
+async function closeIde() {
+	const config = await getConfig();
+	const cliPath = config.cliPath?.trim() ? config.cliPath : null;
+	try {
+		await parse(["close"]);
+		return true;
+	} catch (error) {
+		if (isWechatIdeLoginRequiredError(error)) try {
+			await runWechatIdeOpenWithRetry(["close"]);
+			return true;
+		} catch (retryError) {
+			logger_default.error(retryError);
+		}
+		else {
+			logger_default.warn("微信开发者工具 CLI close 执行失败，尝试回退为系统级关闭。");
+			logger_default.error(error);
+		}
+		if (await closeIdeByAppleScript()) {
+			logger_default.info("已回退为系统级关闭微信开发者工具。");
+			return true;
+		}
+		if (await closeIdeByProcessKill(cliPath)) {
+			logger_default.info("已回退为进程级关闭微信开发者工具。");
+			return true;
+		}
+		return false;
+	}
+}
+/**
+* @description 解析 IDE 相关命令所需的平台、项目目录与配置上下文。
+*/
+async function resolveIdeCommandContext(options) {
+	const cwd = options.cwd ?? process.cwd();
+	let platform = options.platform;
+	let projectPath = options.projectPath;
+	if (!platform || !projectPath) try {
+		const ctx = await createCompilerContext({
+			cwd,
+			mode: options.mode ?? "development",
+			configFile: options.configFile,
+			inlineConfig: createInlineConfig(platform),
+			cliPlatform: options.cliPlatform
+		});
+		platform ??= ctx.configService.platform;
+		if (!projectPath) projectPath = resolveIdeProjectRoot(ctx.configService.mpDistRoot, ctx.configService.cwd);
+		return {
+			platform,
+			projectPath,
+			weappViteConfig: ctx.configService.weappViteConfig,
+			mpDistRoot: ctx.configService.mpDistRoot
+		};
+	} catch {}
+	if (!projectPath && platform === "alipay") projectPath = resolveIdeProjectRoot("dist/alipay/dist", cwd);
+	return {
+		platform,
+		projectPath
+	};
+}
 /**
 * @description 执行 IDE 打开流程，并在登录失效时允许按键重试。
 */
@@ -789,15 +851,41 @@ async function runWechatIdeOpenWithRetry(argv) {
 		logger_default.info(colors.bold(colors.green("正在重试连接微信开发者工具...")));
 	}
 }
+async function closeIdeByAppleScript() {
+	if (process.platform !== "darwin") return false;
+	const appName = process.env.WEAPP_DEVTOOLS_APP_NAME || "wechatwebdevtools";
+	try {
+		await execFileAsync("osascript", ["-e", `tell application "${appName}" to quit`]);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function closeIdeByProcessKill(cliPath) {
+	if (!cliPath) return false;
+	const appContentsRoot = cliPath.includes(".app/") ? cliPath.slice(0, cliPath.indexOf(".app/") + 4) : path.dirname(path.dirname(cliPath));
+	try {
+		await execFileAsync("pkill", ["-f", appContentsRoot]);
+		return true;
+	} catch {
+		return false;
+	}
+}
 /**
 * @description 根据 mpDistRoot 推导 IDE 项目目录（目录内应包含 project/mini 配置）
 */
 function resolveIdeProjectPath(mpDistRoot) {
 	if (!mpDistRoot || !mpDistRoot.trim()) return;
 	const parent = path.dirname(mpDistRoot);
-	if (!parent || parent === ".") return;
+	if (!parent || parent === "." || parent === "/") return;
 	return parent;
 }
+/**
+* @description 结合 mpDistRoot 与配置根目录解析最终 IDE 项目目录。
+*/
+function resolveIdeProjectRoot(mpDistRoot, cwd) {
+	return resolveIdeProjectPath(mpDistRoot) ?? cwd;
+}
 //#endregion
 //#region src/cli/commands/build.ts
 function registerBuildCommand(cli) {
@@ -858,6 +946,13 @@ function isSassEmbeddedChild(handle) {
 	return Boolean(handle && typeof handle === "object" && "kill" in handle && "spawnfile" in handle && typeof handle.spawnfile === "string" && handle.spawnfile?.includes("sass-embedded"));
 }
 //#endregion
+//#region src/cli/commands/close.ts
+function registerCloseCommand(cli) {
+	cli.command("close", "close Wechat DevTools").action(async () => {
+		if (!await closeIde()) throw new Error("关闭微信开发者工具失败。");
+	});
+}
+//#endregion
 //#region src/schematics.ts
 function composePath(outDir, filename) {
 	return `${outDir}${outDir ? "/" : ""}${filename}`;
@@ -1026,6 +1121,213 @@ function registerGenerateCommand(cli) {
 	});
 }
 //#endregion
+//#region src/cli/forwardConsole.ts
+const DEFAULT_FORWARD_CONSOLE_LEVELS = [
+	"log",
+	"info",
+	"warn",
+	"error"
+];
+let activeForwardConsoleSession;
+const FORWARD_CONSOLE_RETRY_DELAY_MS = 1e3;
+const FORWARD_CONSOLE_RETRY_TIMES = 5;
+/**
+* @description 解析 forwardConsole 配置，并在 auto 模式下检测 AI 终端。
+*/
+async function resolveForwardConsoleOptions(config) {
+	const rawConfig = config?.forwardConsole;
+	const defaults = {
+		logLevels: DEFAULT_FORWARD_CONSOLE_LEVELS,
+		unhandledErrors: true
+	};
+	if (rawConfig === false) return {
+		enabled: false,
+		...defaults
+	};
+	if (rawConfig === true) return {
+		enabled: true,
+		...defaults
+	};
+	const normalizedConfig = rawConfig ?? {};
+	const enabledMode = normalizedConfig.enabled ?? "auto";
+	const logLevels = normalizedConfig.logLevels?.length ? normalizedConfig.logLevels : defaults.logLevels;
+	const unhandledErrors = normalizedConfig.unhandledErrors ?? defaults.unhandledErrors;
+	if (enabledMode === true) return {
+		enabled: true,
+		logLevels,
+		unhandledErrors
+	};
+	if (enabledMode === false) return {
+		enabled: false,
+		logLevels,
+		unhandledErrors
+	};
+	const agentResult = await detectAgent();
+	return {
+		enabled: agentResult.isAgent,
+		agentName: agentResult.agentName,
+		logLevels,
+		unhandledErrors
+	};
+}
+/**
+* @description 在 weapp 开发态按需启动控制台转发。
+*/
+async function maybeStartForwardConsole(options) {
+	if (options.platform !== "weapp") return false;
+	const projectPath = resolveIdeProjectPath(options.mpDistRoot) ?? options.cwd;
+	if (!projectPath) return false;
+	const resolved = await resolveForwardConsoleOptions(options.weappViteConfig);
+	if (!resolved.enabled) return false;
+	if (activeForwardConsoleSession) return true;
+	try {
+		activeForwardConsoleSession = await startForwardConsoleBridge({
+			agentName: resolved.agentName,
+			projectPath,
+			logLevels: resolved.logLevels,
+			unhandledErrors: resolved.unhandledErrors,
+			onReadyMessage: "[forwardConsole] 已连接微信开发者工具日志"
+		});
+		return true;
+	} catch (error) {
+		activeForwardConsoleSession = void 0;
+		const message = error instanceof Error ? error.message : String(error);
+		logger_default.warn(`[forwardConsole] 启动失败，回退到普通 IDE 打开流程：${message}`);
+		return false;
+	}
+}
+/**
+* @description 统一启动 DevTools 日志桥，并在 IDE 刚启动时做短暂重试。
+*/
+async function startForwardConsoleBridge(options) {
+	return await withForwardConsoleRetry(async () => {
+		return await startForwardConsole({
+			projectPath: options.projectPath,
+			logLevels: options.logLevels,
+			unhandledErrors: options.unhandledErrors,
+			onReady: () => {
+				const suffix = options.agentName ? `（AI 终端：${options.agentName}）` : "";
+				logger_default.info(`${options.onReadyMessage}${suffix}`);
+			},
+			onLog: (event) => {
+				const line = `[mini:${event.level}] ${event.message}`;
+				if (event.level === "error") {
+					logger_default.error(line);
+					return;
+				}
+				if (event.level === "warn") {
+					logger_default.warn(line);
+					return;
+				}
+				if (event.level === "info") {
+					logger_default.info(line);
+					return;
+				}
+				logger_default.log(line);
+			}
+		});
+	});
+}
+async function detectAgent() {
+	try {
+		const result = await determineAgent();
+		return {
+			isAgent: result.isAgent,
+			agentName: result.isAgent ? result.agent.name : void 0
+		};
+	} catch {
+		return {
+			isAgent: false,
+			agentName: void 0
+		};
+	}
+}
+async function withForwardConsoleRetry(runner) {
+	let lastError;
+	for (let attempt = 0; attempt <= FORWARD_CONSOLE_RETRY_TIMES; attempt++) try {
+		return await runner();
+	} catch (error) {
+		lastError = error;
+		if (!isDevtoolsPortNotReadyError(error) || attempt === FORWARD_CONSOLE_RETRY_TIMES) break;
+		await sleep(FORWARD_CONSOLE_RETRY_DELAY_MS);
+	}
+	throw lastError instanceof Error ? lastError : new Error(String(lastError));
+}
+function isDevtoolsPortNotReadyError(error) {
+	return error instanceof Error && error.message === "DEVTOOLS_HTTP_PORT_ERROR";
+}
+function sleep(ms) {
+	return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//#endregion
+//#region src/cli/commands/ide.ts
+/**
+* @description 注册 IDE 相关子命令。
+*/
+function registerIdeCommand(cli) {
+	cli.command("ide [action] [root]", "forward Wechat DevTools console logs to terminal").option("-o, --open", "[boolean] open ide before attaching log bridge").option("-p, --platform <platform>", "[string] target platform (weapp | h5)").option("--project-config <path>", "[string] project config path (miniprogram only)").action(async (action, root, options) => {
+		await runIdeCommand(action, root, options);
+	});
+}
+/**
+* @description 执行 ide 子命令。
+*/
+async function runIdeCommand(action, root, options) {
+	if (action !== "logs") throw new Error(`未知 ide 子命令: ${action ?? "(empty)"}`);
+	filterDuplicateOptions(options);
+	const configFile = resolveConfigFile(options);
+	const targets = resolveRuntimeTargets(options);
+	const resolved = await resolveIdeCommandContext({
+		configFile,
+		mode: options.mode ?? "development",
+		platform: targets.mpPlatform,
+		projectPath: root,
+		cliPlatform: targets.rawPlatform
+	});
+	if (resolved.platform !== "weapp") throw new Error("`weapp-vite ide logs` 当前仅支持微信小程序平台。");
+	if (!resolved.projectPath) throw new Error("无法解析微信开发者工具项目目录，请显式传入 root 或检查 project.config.json。");
+	if (options.open) await openIde(resolved.platform, resolved.projectPath);
+	const forwardConsoleOptions = await resolveForwardConsoleOptions({
+		...resolved.weappViteConfig,
+		forwardConsole: resolved.weappViteConfig?.forwardConsole === false ? { enabled: true } : {
+			...typeof resolved.weappViteConfig?.forwardConsole === "object" ? resolved.weappViteConfig.forwardConsole : {},
+			enabled: true
+		}
+	});
+	const session = await startForwardConsoleBridge({
+		projectPath: resolved.projectPath,
+		agentName: void 0,
+		logLevels: forwardConsoleOptions.logLevels,
+		unhandledErrors: forwardConsoleOptions.unhandledErrors,
+		onReadyMessage: "[forwardConsole] 已进入持续监听模式，按 Ctrl+C 退出。"
+	});
+	await waitForTermination(async () => {
+		logger_default.info("[forwardConsole] 正在关闭日志桥接...");
+		await session.close();
+	});
+}
+async function waitForTermination(cleanup) {
+	await new Promise((resolve) => {
+		const signals = ["SIGINT", "SIGTERM"];
+		let cleaning = false;
+		const teardown = async () => {
+			if (cleaning) return;
+			cleaning = true;
+			for (const signal of signals) process.off(signal, handlers.get(signal));
+			await cleanup();
+			resolve();
+		};
+		const handlers = /* @__PURE__ */ new Map();
+		for (const signal of signals) {
+			const handler = () => {
+				teardown();
+			};
+			handlers.set(signal, handler);
+			process.on(signal, handler);
+		}
+	});
+}
+//#endregion
 //#region src/cli/commands/init.ts
 function registerInitCommand(cli) {
 	cli.command("init").action(async () => {
@@ -1076,21 +1378,14 @@ function registerOpenCommand(cli) {
 		filterDuplicateOptions(options);
 		const configFile = resolveConfigFile(options);
 		const targets = resolveRuntimeTargets(options);
-		let platform = targets.mpPlatform;
-		let projectPath = root;
-		if (targets.runMini && (!platform || !projectPath)) try {
-			const ctx = await createCompilerContext({
-				cwd: process.cwd(),
-				mode: options.mode ?? "development",
-				configFile,
-				inlineConfig: createInlineConfig(platform),
-				cliPlatform: targets.rawPlatform
-			});
-			platform ??= ctx.configService.platform;
-			if (!projectPath) projectPath = resolveIdeProjectPath(ctx.configService.mpDistRoot);
-		} catch {}
-		if (!projectPath && platform === "alipay") projectPath = resolveIdeProjectPath("dist/alipay/dist");
-		await openIde(platform, projectPath);
+		const { platform, projectPath, mpDistRoot } = await resolveIdeCommandContext({
+			configFile,
+			mode: options.mode ?? "development",
+			platform: targets.mpPlatform,
+			projectPath: root,
+			cliPlatform: targets.rawPlatform
+		});
+		await openIde(platform, projectPath ?? resolveIdeProjectRoot(mpDistRoot, process.cwd()));
 	});
 }
 //#endregion
@@ -1186,7 +1481,14 @@ function registerServeCommand(cli) {
 		}
 		if (targets.runMini) logBuildAppFinish(configService, webServer, { skipWeb: !targets.runWeb });
 		else if (targets.runWeb) logBuildAppFinish(configService, webServer, { skipMini: true });
-		if (options.open && targets.runMini) await openIde(configService.platform, resolveIdeProjectPath(configService.mpDistRoot));
+		if (options.open && targets.runMini) {
+			if (!await maybeStartForwardConsole({
+				platform: configService.platform,
+				mpDistRoot: configService.mpDistRoot,
+				cwd: configService.cwd,
+				weappViteConfig: configService.weappViteConfig
+			})) await openIde(configService.platform, resolveIdeProjectRoot(configService.mpDistRoot, configService.cwd));
+		}
 		if (analyzeHandle) await analyzeHandle.waitForExit();
 	});
 }
@@ -1238,6 +1540,7 @@ const WEAPP_VITE_NATIVE_COMMANDS = new Set([
 	"dev",
 	"serve",
 	"build",
+	"close",
 	"analyze",
 	"init",
 	"open",
@@ -1255,6 +1558,7 @@ async function tryRunIdeCommand(argv) {
 	const command = argv[0];
 	if (!command) return false;
 	if (command === "ide") {
+		if (argv[1] === "logs") return false;
 		await parse(argv.slice(1));
 		return true;
 	}
@@ -1349,8 +1653,9 @@ try {
 	});
 } catch {}
 cli.option("-c, --config <file>", `[string] use specified config file`).option("--base <path>", `[string] public base path (default: /)`, { type: [convertBase] }).option("-l, --logLevel <level>", `[string] info | warn | error | silent`).option("--clearScreen", `[boolean] allow/disable clear screen when logging`).option("-d, --debug [feat]", `[string | boolean] show debug logs`).option("-f, --filter <filter>", `[string] filter debug logs`).option("-m, --mode <mode>", `[string] set env mode`);
-registerServeCommand(cli);
+registerIdeCommand(cli);
 registerBuildCommand(cli);
+registerCloseCommand(cli);
 registerAnalyzeCommand(cli);
 registerInitCommand(cli);
 registerOpenCommand(cli);
@@ -1358,11 +1663,13 @@ registerPrepareCommand(cli);
 registerNpmCommand(cli);
 registerGenerateCommand(cli);
 registerMcpCommand(cli);
+registerServeCommand(cli);
 cli.help();
 cli.version(VERSION);
 const skipManagedTsconfigBootstrapCommands = new Set([
 	"g",
 	"generate",
+	"ide",
 	"init",
 	"mcp",
 	"npm"
@@ -1371,10 +1678,17 @@ function resolveManagedTsconfigBootstrapRoot(args) {
 	const [firstArg, secondArg] = args;
 	if (!firstArg || firstArg === "--help" || firstArg === "-h" || firstArg === "--version" || firstArg === "-v") return;
 	if (firstArg.startsWith("-")) return process.cwd();
-	if (skipManagedTsconfigBootstrapCommands.has(firstArg)) return;
+	if (skipManagedTsconfigBootstrapCommands.has(firstArg)) {
+		if (firstArg === "ide") {
+			const thirdArg = args[2];
+			if (secondArg === "logs" && thirdArg && !thirdArg.startsWith("-")) return path.resolve(thirdArg);
+		}
+		return;
+	}
 	if ([
 		"analyze",
 		"build",
+		"close",
 		"dev",
 		"open",
 		"prepare",

package/dist/{config-mYISi4CS.d.mts → config-DHz3M7If.d.mts}

@@ -12,8 +12,8 @@ import { WrapPluginOptions } from "vite-plugin-performance";
 import PQueue from "p-queue";
 import { ComputedDefinitions as ComputedDefinitions$1, MethodDefinitions as MethodDefinitions$1, PageLayoutMeta, Ref, WevuDefaults } from "wevu";
 import { App, App as App$1, Component, Component as Component$1, GenerateType, Page, Page as Page$1, Plugin, Sitemap, Sitemap as Sitemap$1, Theme, Theme as Theme$1 } from "@weapp-core/schematics";
-import { CompilerOptions } from "typescript";
 import { WeappWebPluginOptions } from "@weapp-vite/web/plugin";
+import { CompilerOptions } from "typescript";
 import { DetectResult } from "package-manager-detector";
 
 //#region src/pluginHost.d.ts
@@ -500,12 +500,45 @@ interface WeappDebugConfig {
   watchFiles?: (watchFiles: string[], subPackageMeta?: SubPackageMetaValue) => void;
   resolveId?: (id: string, subPackageMeta?: SubPackageMetaValue) => void;
   load?: (id: string, subPackageMeta?: SubPackageMetaValue) => void;
+  vueTransformTiming?: (timing: {
+    id: string;
+    isPage: boolean;
+    totalMs: number;
+    stages: Record<string, number>;
+  }) => void;
   inspect?: WrapPluginOptions;
 }
+type WeappForwardConsoleLogLevel = 'debug' | 'log' | 'info' | 'warn' | 'error';
+/**
+ * @description 微信开发者工具日志转发配置。
+ */
+interface WeappForwardConsoleConfig {
+  /**
+   * 是否启用日志转发。
+   * - `true`: 始终开启
+   * - `false`: 始终关闭
+   * - `'auto'`: 仅在检测到 AI 终端时开启
+   */
+  enabled?: boolean | 'auto';
+  /**
+   * 允许转发的日志级别。
+   */
+  logLevels?: WeappForwardConsoleLogLevel[];
+  /**
+   * 是否同时转发未捕获异常。
+   */
+  unhandledErrors?: boolean;
+}
 /**
  * @description weapp-vite 主配置
  */
 interface WeappViteConfig {
+  /**
+   * 开发态是否在启动构建前清空输出目录。
+   * 开发态默认 `true`，设置为 `false` 可跳过每次 dev 启动前的全量输出目录清理。
+   * 生产构建始终会清空输出目录。
+   */
+  cleanOutputsInDev?: boolean;
   /**
    * 应用入口目录（`app.json` 所在目录）。
    */
@@ -563,6 +596,7 @@ interface WeappViteConfig {
   routeRules?: WeappRouteRules;
   injectWeapi?: boolean | WeappInjectWeapiConfig;
   mcp?: boolean | WeappMcpConfig;
+  forwardConsole?: boolean | WeappForwardConsoleConfig;
   chunks?: ChunksConfig;
   json?: JsonConfig;
 }
@@ -1416,7 +1450,6 @@ type UserConfigFnObjectPlain<T extends UserConfig$1 = UserConfig$1> = (env: Conf
 type UserConfigFnObject<T extends UserConfig$1 = UserConfig$1> = (env: ConfigEnv) => T;
 type UserConfigFnPromise<T extends UserConfig$1 = UserConfig$1> = (env: ConfigEnv) => Promise<T>;
 type UserConfigFn<T extends UserConfig$1 = UserConfig$1> = (env: ConfigEnv) => T | Promise<T>;
-type UserConfigLoose = UserConfig$1 & Record<string, any>;
 type UserConfigExport<T extends UserConfig$1 = UserConfig$1> = T | Promise<T> | UserConfigFnNoEnv<T> | UserConfigFnObject<T> | UserConfigFnPromise<T> | UserConfigFn<T>;
 declare module 'vite' {
   interface UserConfig {
@@ -1431,11 +1464,8 @@ declare module 'vite' {
  */
 declare function defineConfig(config: UserConfig$1): UserConfig$1;
 declare function defineConfig(config: Promise<UserConfig$1>): Promise<UserConfig$1>;
-declare function defineConfig(config: UserConfigFnNoEnvPlain): UserConfigFnNoEnvPlain;
-declare function defineConfig(config: UserConfigFnNoEnv): UserConfigFnNoEnv;
 declare function defineConfig(config: UserConfigFnObjectPlain): UserConfigFnObjectPlain;
-declare function defineConfig(config: UserConfigFnPromise): UserConfigFnPromise;
 declare function defineConfig(config: UserConfigFn): UserConfigFn;
-declare function defineConfig(config: UserConfigLoose): UserConfigLoose;
+declare function defineConfig(config: UserConfigFnPromise): UserConfigFnPromise;
 //#endregion
-export { WeappDebugConfig as $, ResolvedAlias as $t, Ref as A, GenerateExtensionsOptions as At, BindingErrorLike as B, GenerateTemplateScope as Bt, LoadConfigOptions as C, WeappViteHostMeta as Cn, AliasOptions as Ct, MethodDefinitions$1 as D, isWeappViteHost as Dn, CopyGlobs as Dt, InlineConfig$1 as E, createWeappViteHostMeta as En, ChunksConfig as Et, RolldownPlugin as F, GenerateTemplateContext as Ft, EntryJsonFragment as G, JsonMergeFunction as Gt, BaseEntry as H, JsFormat as Ht, RolldownPluginOption as I, GenerateTemplateEntry as It, ScanComponentItem as J, MpPlatform as Jt, PageEntry as K, JsonMergeStage as Kt, RolldownWatchOptions as L, GenerateTemplateFactory as Lt, RolldownBuild as M, GenerateFilenamesOptions as Mt, RolldownOptions as N, GenerateOptions as Nt, Plugin$1 as O, resolveWeappViteHostMeta as On, CopyOptions as Ot, RolldownOutput$1 as P, GenerateTemplate as Pt, UserConfig$2 as Q, NpmSubPackageConfig as Qt, RolldownWatcher$1 as R, GenerateTemplateFileSource as Rt, CompilerContext as S, WEAPP_VITE_HOST_NAME as Sn, Alias as St, ConfigEnv$1 as T, applyWeappViteHostMeta as Tn, BuildNpmPackageMeta as Tt, ComponentEntry as U, JsonConfig as Ut, AppEntry as V, GenerateTemplatesConfig as Vt, Entry as W, JsonMergeContext as Wt, ProjectConfig as X, NpmMainPackageConfig as Xt, WxmlDep as Y, NpmBuildOptions as Yt, SubPackageMetaValue as Z, NpmPluginPackageConfig as Zt, definePageJson as _, WeappManagedNodeTsconfigConfig as _n, WeappSubPackageConfig as _t, UserConfigFnNoEnvPlain as a, SubPackageStyleConfigEntry as an, HandleWxmlOptions as at, ChangeEvent as b, WeappManagedTypeScriptConfig as bn, WeappWevuConfig as bt, UserConfigFnPromise as c, SubPackageStyleScope as cn, WeappAutoRoutesConfig as ct, Component$1 as d, WeappLibDtsOptions as dn, WeappHmrConfig as dt, SharedChunkDynamicImports as en, WeappViteConfig as et, Page$1 as f, WeappLibEntryContext as fn, WeappInjectWeapiConfig as ft, defineComponentJson as g, WeappManagedAppTsconfigConfig as gn, WeappRouteRules as gt, defineAppJson as h, WeappLibVueTscOptions as hn, WeappRouteRule as ht, UserConfigFnNoEnv as i, SubPackage as in, EnhanceWxmlOptions as it, ResolvedConfig as j, GenerateFileType as jt, PluginOption as k, GenerateDirsOptions as kt, defineConfig as l, WeappLibComponentJson as ln, WeappAutoRoutesInclude as lt, Theme$1 as m, WeappLibInternalDtsOptions as mn, WeappNpmConfig as mt, UserConfigExport as n, SharedChunkOverride as nn, AutoImportComponentsOption as nt, UserConfigFnObject as o, SubPackageStyleConfigObject as on, MultiPlatformConfig as ot, Sitemap$1 as p, WeappLibFileName as pn, WeappMcpConfig as pt, ComponentsMap as q, JsonMergeStrategy as qt, UserConfigFn as r, SharedChunkStrategy as rn, EnhanceOptions as rt, UserConfigFnObjectPlain as s, SubPackageStyleEntry as sn, ScanWxmlOptions as st, UserConfig$1 as t, SharedChunkMode as tn, AutoImportComponents as tt, App$1 as u, WeappLibConfig as un, WeappAutoRoutesIncludePattern as ut, defineSitemapJson as v, WeappManagedServerTsconfigConfig as vn, WeappVueConfig as vt, ComputedDefinitions$1 as w, WeappViteRuntime as wn, AlipayNpmMode as wt, WeappVitePluginApi as x, WeappWebConfig as xn, WeappWorkerConfig as xt, defineThemeJson as y, WeappManagedSharedTsconfigConfig as yn, WeappVueTemplateConfig as yt, ViteDevServer$1 as z, GenerateTemplateInlineSource as zt };
+export { WeappDebugConfig as $, NpmPluginPackageConfig as $t, Ref as A, resolveWeappViteHostMeta as An, CopyOptions as At, BindingErrorLike as B, GenerateTemplateFileSource as Bt, LoadConfigOptions as C, WeappWebConfig as Cn, WeappWorkerConfig as Ct, MethodDefinitions$1 as D, applyWeappViteHostMeta as Dn, BuildNpmPackageMeta as Dt, InlineConfig$1 as E, WeappViteRuntime as En, AlipayNpmMode as Et, RolldownPlugin as F, GenerateOptions as Ft, EntryJsonFragment as G, JsonConfig as Gt, BaseEntry as H, GenerateTemplateScope as Ht, RolldownPluginOption as I, GenerateTemplate as It, ScanComponentItem as J, JsonMergeStage as Jt, PageEntry as K, JsonMergeContext as Kt, RolldownWatchOptions as L, GenerateTemplateContext as Lt, RolldownBuild as M, GenerateExtensionsOptions as Mt, RolldownOptions as N, GenerateFileType as Nt, Plugin$1 as O, createWeappViteHostMeta as On, ChunksConfig as Ot, RolldownOutput$1 as P, GenerateFilenamesOptions as Pt, UserConfig$2 as Q, NpmMainPackageConfig as Qt, RolldownWatcher$1 as R, GenerateTemplateEntry as Rt, CompilerContext as S, WeappManagedTypeScriptConfig as Sn, WeappWevuConfig as St, ConfigEnv$1 as T, WeappViteHostMeta as Tn, AliasOptions as Tt, ComponentEntry as U, GenerateTemplatesConfig as Ut, AppEntry as V, GenerateTemplateInlineSource as Vt, Entry as W, JsFormat as Wt, ProjectConfig as X, MpPlatform as Xt, WxmlDep as Y, JsonMergeStrategy as Yt, SubPackageMetaValue as Z, NpmBuildOptions as Zt, definePageJson as _, WeappLibVueTscOptions as _n, WeappRouteRule as _t, UserConfigFnNoEnvPlain as a, SharedChunkStrategy as an, EnhanceOptions as at, ChangeEvent as b, WeappManagedServerTsconfigConfig as bn, WeappVueConfig as bt, UserConfigFnPromise as c, SubPackageStyleConfigObject as cn, MultiPlatformConfig as ct, Component$1 as d, WeappLibComponentJson as dn, WeappAutoRoutesInclude as dt, NpmSubPackageConfig as en, WeappForwardConsoleConfig as et, Page$1 as f, WeappLibConfig as fn, WeappAutoRoutesIncludePattern as ft, defineComponentJson as g, WeappLibInternalDtsOptions as gn, WeappNpmConfig as gt, defineAppJson as h, WeappLibFileName as hn, WeappMcpConfig as ht, UserConfigFnNoEnv as i, SharedChunkOverride as in, AutoImportComponentsOption as it, ResolvedConfig as j, GenerateDirsOptions as jt, PluginOption as k, isWeappViteHost as kn, CopyGlobs as kt, defineConfig as l, SubPackageStyleEntry as ln, ScanWxmlOptions as lt, Theme$1 as m, WeappLibEntryContext as mn, WeappInjectWeapiConfig as mt, UserConfigExport as n, SharedChunkDynamicImports as nn, WeappViteConfig as nt, UserConfigFnObject as o, SubPackage as on, EnhanceWxmlOptions as ot, Sitemap$1 as p, WeappLibDtsOptions as pn, WeappHmrConfig as pt, ComponentsMap as q, JsonMergeFunction as qt, UserConfigFn as r, SharedChunkMode as rn, AutoImportComponents as rt, UserConfigFnObjectPlain as s, SubPackageStyleConfigEntry as sn, HandleWxmlOptions as st, UserConfig$1 as t, ResolvedAlias as tn, WeappForwardConsoleLogLevel as tt, App$1 as u, SubPackageStyleScope as un, WeappAutoRoutesConfig as ut, defineSitemapJson as v, WeappManagedAppTsconfigConfig as vn, WeappRouteRules as vt, ComputedDefinitions$1 as w, WEAPP_VITE_HOST_NAME as wn, Alias as wt, WeappVitePluginApi as x, WeappManagedSharedTsconfigConfig as xn, WeappVueTemplateConfig as xt, defineThemeJson as y, WeappManagedNodeTsconfigConfig as yn, WeappSubPackageConfig as yt, ViteDevServer$1 as z, GenerateTemplateFactory as zt };

package/dist/config.d.mts

@@ -1,2 +1,2 @@
-import { Cn as WeappViteHostMeta, Dn as isWeappViteHost, En as createWeappViteHostMeta, On as resolveWeappViteHostMeta, Sn as WEAPP_VITE_HOST_NAME, Tn as applyWeappViteHostMeta, _ as definePageJson, a as UserConfigFnNoEnvPlain, c as UserConfigFnPromise, d as Component, et as WeappViteConfig, 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, wn as WeappViteRuntime, y as defineThemeJson } from "./config-mYISi4CS.mjs";
+import { An as resolveWeappViteHostMeta, Dn as applyWeappViteHostMeta, En as WeappViteRuntime, On as createWeappViteHostMeta, Tn as WeappViteHostMeta, _ as definePageJson, a as UserConfigFnNoEnvPlain, c as UserConfigFnPromise, d as Component, f as Page, g as defineComponentJson, h as defineAppJson, i as UserConfigFnNoEnv, kn as isWeappViteHost, 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, wn as WEAPP_VITE_HOST_NAME, y as defineThemeJson } from "./config-DHz3M7If.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 };