weapp-vite 6.19.1 → 6.19.2

package/dist/{createContext-DrwOUlDX.mjs → createContext-D9HCnUmH.mjs}

@@ -1,10 +1,10 @@
 import { n as applyWeappViteHostMeta } from "./pluginHost--CaeyWpA.mjs";
 import { n as configureLogger, r as logger_default } from "./logger-mt4mSTqV.mjs";
-import { _ as jsExtensions, a as findJsonEntry, b as vueExtensions, c as isJsOrTs, d as touch, g as configExtensions, i as findJsEntry, l as isTemplate, n as changeFileExtension, o as findTemplateEntry, p as inlineAutoRoutesImports, r as findCssEntry, s as findVueEntry, t as extractConfigFromVue, v as supportedCssLangs, y as templateExtensions } from "./file-CdNDPmkx.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-CFQYYS_3.mjs";
 import { createRequire, isBuiltin } from "node:module";
 import { createDebug } from "obug";
 import fs, { existsSync, readFileSync, realpathSync } from "node:fs";
-import { APP_PRELUDE_CHUNK_MARKER, APP_PRELUDE_GUARD_KEY, APP_PRELUDE_REQUIRE_MARKER, REQUEST_GLOBAL_ACTUALS_KEY, REQUEST_GLOBAL_BUNDLE_HOST_REF, REQUEST_GLOBAL_BUNDLE_MARKER, REQUEST_GLOBAL_CHUNK_HOST_REF, REQUEST_GLOBAL_CHUNK_MODULE_REF, REQUEST_GLOBAL_EXPOSE_HELPER, REQUEST_GLOBAL_INSTALLER_HOST_REF, REQUEST_GLOBAL_LAZY_CONSTRUCTOR_HELPER, REQUEST_GLOBAL_LAZY_FUNCTION_HELPER, REQUEST_GLOBAL_LOCAL_BINDINGS_MARKER, REQUEST_GLOBAL_MARK_PLACEHOLDER_HELPER, REQUEST_GLOBAL_PASSIVE_BINDINGS_MARKER, REQUEST_GLOBAL_PASSIVE_BINDINGS_MARKER as REQUEST_GLOBAL_PASSIVE_BINDINGS_MARKER$1, REQUEST_GLOBAL_PLACEHOLDER_KEY, REQUEST_GLOBAL_PRELUDE_GUARD_KEY, REQUEST_GLOBAL_PRELUDE_MARKER, REQUEST_GLOBAL_SYNTHETIC_EXPORT_NAME, REQUEST_GLOBAL_USABLE_CONSTRUCTOR_HELPER, WEAPP_VITE_EXTERNAL_OUTPUT_DIRECTORY, WEAPP_VITE_IMPORT_META_ENV_KEY, WEAPP_VITE_INJECTED_API_IDENTIFIER, WEAPP_VITE_LOGICAL_ENTRY_RESOLVED_PREFIX, WEAPP_VITE_LOGICAL_ENTRY_VIRTUAL_PREFIX, WEAPP_VITE_RUNTIME_CONTRACT_VERSION, WEAPP_VITE_RUNTIME_REACTIVITY_VIRTUAL_ID, WEAPP_VITE_RUNTIME_TEMPLATE_VIRTUAL_ID, WEAPP_VITE_RUNTIME_VIRTUAL_ID, WEAPP_VITE_RUNTIME_VIRTUAL_IDS, WEAPP_VITE_SIDECAR_OWNER_QUERY_MARKER, WEAPP_VITE_SIDECAR_QUERY_MARKER, WEAPP_VITE_SIDECAR_RESOLVED_PREFIX, WEAPP_VITE_SIDECAR_VIRTUAL_PREFIX, WEAPP_VITE_STATEFUL_HMR_BRIDGE_KEY, WEAPP_VITE_STATEFUL_HMR_CLIENT_KEY, WEAPP_VITE_STATEFUL_HMR_CONTROL_FILE, WEAPP_VITE_STATEFUL_HMR_CONTROL_KEY, WEAPP_VITE_STATEFUL_HMR_PRELOAD_FILE, WEAPP_VITE_STATEFUL_HMR_UPDATE_FILE, WEVU_APP_SHELL_COMPONENT_BASE, WEVU_APP_SHELL_TAG_NAME, WEVU_EXPRESSION_ERROR_IDENTIFIER, WEVU_INTERNAL_KEY_IDENTIFIER, WEVU_LAYOUT_BIND_PREFIX, WEVU_PAGE_LAYOUT_CURRENT_NAME_IDENTIFIER, WEVU_PAGE_LAYOUT_CURRENT_PROPS_IDENTIFIER, WEVU_PAGE_LAYOUT_NAME_KEY, WEVU_PAGE_LAYOUT_NEXT_NAME_IDENTIFIER, WEVU_PAGE_LAYOUT_NEXT_PROPS_IDENTIFIER, WEVU_PAGE_LAYOUT_NONE, WEVU_PAGE_LAYOUT_PROPS_KEY, WEVU_PAGE_LAYOUT_SETTER_KEY, WEVU_SCOPED_SLOT_CREATOR_KEY, WEVU_SLOT_FALLBACK_VIRTUAL_HOST_BASE, WEVU_SLOT_FALLBACK_VIRTUAL_HOST_GLOBAL_PATH, WEVU_SLOT_FALLBACK_VIRTUAL_HOST_TAG_NAME, WEVU_SLOT_NAMES_PROP, WEVU_SLOT_OWNER_ID_ATTR, WEVU_SLOT_OWNER_ID_KEY, WEVU_SLOT_OWNER_ID_PROP, WEVU_SLOT_PROPS_ATTR, WEVU_SLOT_SCOPE_ATTR, WEVU_SLOT_SCOPE_KEY } from "@weapp-core/constants";
+import { APP_PRELUDE_CHUNK_MARKER, APP_PRELUDE_GUARD_KEY, APP_PRELUDE_REQUIRE_MARKER, REQUEST_GLOBAL_ACTUALS_KEY, REQUEST_GLOBAL_BUNDLE_HOST_REF, REQUEST_GLOBAL_BUNDLE_MARKER, REQUEST_GLOBAL_BUNDLE_MARKER as REQUEST_GLOBAL_BUNDLE_MARKER$1, REQUEST_GLOBAL_CHUNK_HOST_REF, REQUEST_GLOBAL_CHUNK_MODULE_REF, REQUEST_GLOBAL_EXPOSE_HELPER, REQUEST_GLOBAL_INSTALLER_HOST_REF, REQUEST_GLOBAL_LAZY_CONSTRUCTOR_HELPER, REQUEST_GLOBAL_LAZY_FUNCTION_HELPER, REQUEST_GLOBAL_LOCAL_BINDINGS_MARKER, REQUEST_GLOBAL_LOCAL_BINDINGS_MARKER as REQUEST_GLOBAL_LOCAL_BINDINGS_MARKER$1, REQUEST_GLOBAL_MARK_PLACEHOLDER_HELPER, REQUEST_GLOBAL_PASSIVE_BINDINGS_MARKER, REQUEST_GLOBAL_PASSIVE_BINDINGS_MARKER as REQUEST_GLOBAL_PASSIVE_BINDINGS_MARKER$1, REQUEST_GLOBAL_PLACEHOLDER_KEY, REQUEST_GLOBAL_PRELUDE_GUARD_KEY, REQUEST_GLOBAL_PRELUDE_MARKER, REQUEST_GLOBAL_SYNTHETIC_EXPORT_NAME, REQUEST_GLOBAL_USABLE_CONSTRUCTOR_HELPER, WEAPP_VITE_EXTERNAL_OUTPUT_DIRECTORY, WEAPP_VITE_IMPORT_META_ENV_KEY, WEAPP_VITE_INJECTED_API_IDENTIFIER, WEAPP_VITE_LOGICAL_ENTRY_RESOLVED_PREFIX, WEAPP_VITE_LOGICAL_ENTRY_VIRTUAL_PREFIX, WEAPP_VITE_RUNTIME_CONTRACT_VERSION, WEAPP_VITE_RUNTIME_REACTIVITY_VIRTUAL_ID, WEAPP_VITE_RUNTIME_TEMPLATE_VIRTUAL_ID, WEAPP_VITE_RUNTIME_VIRTUAL_ID, WEAPP_VITE_RUNTIME_VIRTUAL_IDS, WEAPP_VITE_SIDECAR_OWNER_QUERY_MARKER, WEAPP_VITE_SIDECAR_QUERY_MARKER, WEAPP_VITE_SIDECAR_RESOLVED_PREFIX, WEAPP_VITE_SIDECAR_VIRTUAL_PREFIX, WEAPP_VITE_STATEFUL_HMR_BRIDGE_KEY, WEAPP_VITE_STATEFUL_HMR_CLIENT_KEY, WEAPP_VITE_STATEFUL_HMR_CONTROL_FILE, WEAPP_VITE_STATEFUL_HMR_CONTROL_KEY, WEAPP_VITE_STATEFUL_HMR_PRELOAD_FILE, WEAPP_VITE_STATEFUL_HMR_UPDATE_FILE, WEVU_APP_SHELL_COMPONENT_BASE, WEVU_APP_SHELL_TAG_NAME, WEVU_EXPRESSION_ERROR_IDENTIFIER, WEVU_INTERNAL_KEY_IDENTIFIER, WEVU_LAYOUT_BIND_PREFIX, WEVU_PAGE_LAYOUT_CURRENT_NAME_IDENTIFIER, WEVU_PAGE_LAYOUT_CURRENT_PROPS_IDENTIFIER, WEVU_PAGE_LAYOUT_NAME_KEY, WEVU_PAGE_LAYOUT_NEXT_NAME_IDENTIFIER, WEVU_PAGE_LAYOUT_NEXT_PROPS_IDENTIFIER, WEVU_PAGE_LAYOUT_NONE, WEVU_PAGE_LAYOUT_PROPS_KEY, WEVU_PAGE_LAYOUT_SETTER_KEY, WEVU_SCOPED_SLOT_CREATOR_KEY, WEVU_SLOT_FALLBACK_VIRTUAL_HOST_BASE, WEVU_SLOT_FALLBACK_VIRTUAL_HOST_GLOBAL_PATH, WEVU_SLOT_FALLBACK_VIRTUAL_HOST_TAG_NAME, WEVU_SLOT_NAMES_PROP, WEVU_SLOT_OWNER_ID_ATTR, WEVU_SLOT_OWNER_ID_KEY, WEVU_SLOT_OWNER_ID_PROP, WEVU_SLOT_PROPS_ATTR, WEVU_SLOT_SCOPE_ATTR, WEVU_SLOT_SCOPE_KEY } from "@weapp-core/constants";
 import path, { posix } from "pathe";
 import { fileURLToPath } from "node:url";
 import path$1, { normalize, relative, win32 } from "node:path";
@@ -5303,6 +5303,17 @@ async function loadViteConfigFile(configEnv, configFile, configRoot, configFileD
 }
 //#endregion
 //#region src/utils/projectConfig.ts
+async function readProjectConfigFile(filePath, required) {
+	if (!await fs$1.pathExists(filePath)) {
+		if (required) throw new Error(`找不到项目配置文件：${filePath}`);
+		return {};
+	}
+	try {
+		return await fs$1.readJson(filePath) || {};
+	} catch {
+		throw new Error(`解析 json 格式失败, ${filePath} 为非法的 json 格式`);
+	}
+}
 const DEFAULT_PROJECT_PRIVATE_CONFIG_FILE_NAME = "project.private.config.json";
 function getProjectConfigFileName(platform) {
 	return getProjectPlatformOptions(platform).projectConfigFileName;
@@ -5323,23 +5334,13 @@ function resolveProjectConfigRoot(projectConfig, platform) {
 async function getProjectConfig(root, options) {
 	const baseJsonPath = path.resolve(root, options?.basePath ?? "project.config.json");
 	const privateJsonPath = path.resolve(root, options?.privatePath ?? "project.private.config.json");
-	let baseJson = {};
-	let privateJson = {};
-	if (await fs$1.pathExists(baseJsonPath)) try {
-		baseJson = await fs$1.readJson(baseJsonPath) || {};
-	} catch {
-		throw new Error(`解析 json 格式失败, ${baseJsonPath} 为非法的 json 格式`);
-	}
-	else throw new Error(`找不到项目配置文件：${baseJsonPath}`);
-	if (!options?.ignorePrivate) {
-		if (await fs$1.pathExists(privateJsonPath)) try {
-			privateJson = await fs$1.readJson(privateJsonPath) || {};
-		} catch {
-			throw new Error(`解析 json 格式失败, ${privateJsonPath} 为非法的 json 格式`);
-		}
-	}
+	const baseJson = await readProjectConfigFile(baseJsonPath, true);
+	const privateJson = options?.ignorePrivate ? {} : await readProjectConfigFile(privateJsonPath, false);
 	return Object.assign({}, privateJson, baseJson);
 }
+async function getProjectPrivateConfig(root, options) {
+	return await readProjectConfigFile(path.resolve(root, options?.privatePath ?? "project.private.config.json"), false);
+}
 function resolveProjectConfigSyncDirs(options) {
 	const outputRoot = path.dirname(options.outDir);
 	const sourceBasePath = path.resolve(options.projectConfigPath);
@@ -5734,7 +5735,7 @@ function createRegistryHelpers(state) {
 }
 //#endregion
 //#region src/runtime/autoImport/service/resolver.ts
-const require$1 = createRequire(import.meta.url);
+const require$2 = createRequire(import.meta.url);
 const COMPONENT_HAS_UPPER_RE = /[A-Z]/;
 const CAMEL_TO_KEBAB_RE$1 = /([a-z0-9])([A-Z])/g;
 const MULTI_UPPER_TO_KEBAB_RE = /([A-Z]+)([A-Z][a-z])/g;
@@ -5812,7 +5813,7 @@ function createResolverHelpers(state) {
 	function getMiniprogramDir(pkgName, cwd) {
 		if (miniprogramDirCache.has(pkgName)) return miniprogramDirCache.get(pkgName);
 		try {
-			const packageJsonPath = require$1.resolve(`${pkgName}/package.json`, { paths: [cwd] });
+			const packageJsonPath = require$2.resolve(`${pkgName}/package.json`, { paths: [cwd] });
 			const raw = fs$1.readJsonSync(packageJsonPath, { throws: false });
 			const normalized = (typeof raw?.miniprogram === "string" ? raw.miniprogram.trim() : void 0)?.replace(TRAILING_RELATIVE_PREFIX_RE, "").replace(TRAILING_SLASH_RE$1, "");
 			miniprogramDirCache.set(pkgName, normalized || void 0);
@@ -5827,7 +5828,7 @@ function createResolverHelpers(state) {
 		const cached = packageRootCache.get(cacheKey);
 		if (cached) return cached;
 		try {
-			const packageJsonPath = require$1.resolve(`${pkgName}/package.json`, { paths: [cwd] });
+			const packageJsonPath = require$2.resolve(`${pkgName}/package.json`, { paths: [cwd] });
 			const packageRoot = path.dirname(packageJsonPath);
 			packageRootCache.set(cacheKey, packageRoot);
 			return packageRoot;
@@ -5859,7 +5860,7 @@ function createResolverHelpers(state) {
 			candidates.push(`${withMiniprogramDir}/index.js`);
 		} else candidates.push(withMiniprogramDir);
 		for (const candidate of candidates) try {
-			require$1.resolve(candidate, { paths: [cwd] });
+			require$2.resolve(candidate, { paths: [cwd] });
 			navigationImportCache.set(from, candidate);
 			return candidate;
 		} catch {}
@@ -6521,8 +6522,10 @@ async function collectCandidateFilesFromRoots(absoluteSrcRoot, matcher, roots, o
 async function collectCandidates(absoluteSrcRoot, include, subPackageRoots, searchRoots) {
 	const matcher = createAutoRoutesMatcher(include, subPackageRoots);
 	const roots = resolveCandidateSearchRoots(absoluteSrcRoot, matcher, searchRoots) ?? [];
-	if (!searchRoots) if (matcher.isDefault) roots.push(...await resolveDefaultSearchRoots(absoluteSrcRoot, subPackageRoots));
-	else roots.push(...matcher.getSearchRoots(absoluteSrcRoot));
+	if (!searchRoots) {
+		if (matcher.isDefault) roots.push(...await resolveDefaultSearchRoots(absoluteSrcRoot, subPackageRoots));
+		else roots.push(...matcher.getSearchRoots(absoluteSrcRoot));
+	}
 	const createCrawler = () => new fdir({
 		includeDirs: false,
 		pathSeparator: "/",
@@ -7860,6 +7863,22 @@ function resolveCompilerOutputExtensions(outputExtensions) {
 	return resolveOutputExtensions(outputExtensions, { scriptModuleExtensionFallback: "wxs" });
 }
 //#endregion
+//#region src/runtime/hmrRuntime.ts
+function resolveHmrRuntime(options) {
+	if (options.configured === "classic" || options.configured === "stateful-experimental") return options.configured;
+	if (options.platform === "weapp" && options.compileHotReLoad === true) return "stateful-experimental";
+	return "classic";
+}
+function formatHmrRuntimeStartupMessages(options) {
+	if (options.configured === "classic" || options.configured === "stateful-experimental") {
+		const alternative = options.runtime === "classic" ? "stateful-experimental" : "classic";
+		return [`HMR 模式：${options.runtime}（weapp.hmr.runtime 显式配置）`, `切换模式：将 weapp.hmr.runtime 改为 auto 或 ${alternative}，并重启 wv dev。`];
+	}
+	if (options.platform !== "weapp") return ["HMR 模式：classic（auto：stateful-experimental 仅支持微信小程序）", "切换模式：可通过 weapp.hmr.runtime 显式锁定 classic；stateful-experimental 仅支持微信小程序。"];
+	if (options.compileHotReLoad === true) return ["HMR 模式：stateful-experimental（auto：微信开发者工具热重载已开启）", "切换模式：在微信开发者工具中关闭“热重载”并重启 wv dev，可切换为 classic；也可通过 weapp.hmr.runtime 显式锁定模式。"];
+	return ["HMR 模式：classic（auto：微信开发者工具热重载未开启或无法确认）", "切换模式：在微信开发者工具中开启“热重载”并重启 wv dev，可切换为 stateful-experimental；也可通过 weapp.hmr.runtime 显式锁定模式。"];
+}
+//#endregion
 //#region src/runtime/lib.ts
 function hasLibEntry(entry) {
 	if (!entry) return false;
@@ -8450,8 +8469,10 @@ async function generateLibDts(configService) {
 		});
 		await normalizeRolldownDtsOutput(tsEntries, configService.outDir);
 	}
-	if (vueEntries.length > 0) if (dtsOptions?.mode === "vue-tsc") await generateVueDtsWithVueTsc(configService, libConfig, vueEntries, dtsOptions);
-	else await generateVueDtsWithInternal(configService, vueEntries, dtsOptions);
+	if (vueEntries.length > 0) {
+		if (dtsOptions?.mode === "vue-tsc") await generateVueDtsWithVueTsc(configService, libConfig, vueEntries, dtsOptions);
+		else await generateVueDtsWithInternal(configService, vueEntries, dtsOptions);
+	}
 	await Promise.all(entries.map((entry) => ensureStub(entry, configService.outDir)));
 	if (vueEntries.length > 0) {
 		if (shouldRewriteWevuComponentType(dtsOptions?.mode === "vue-tsc" ? getVueCompilerLibOrUndefined(dtsOptions?.vueTsc?.vueCompilerOptions?.lib) : getVueCompilerLibOrUndefined(dtsOptions?.internal?.vueCompilerOptions?.lib))) await Promise.all(vueEntries.map(async (entry) => {
@@ -8631,7 +8652,7 @@ function getWeappViteConfig() {
 			alipayNpmMode: "node_modules"
 		},
 		hmr: {
-			runtime: "classic",
+			runtime: "auto",
 			sharedChunks: "auto",
 			touchAppWxss: "auto",
 			logLevel: "default",
@@ -8765,6 +8786,7 @@ function createDefaultLoadConfigResult() {
 		emitDefaultAutoImportOutputs: true,
 		projectConfig: {},
 		projectConfigPath: void 0,
+		projectPrivateConfig: {},
 		projectPrivateConfigPath: void 0,
 		mpDistRoot: "",
 		multiPlatform: resolveMultiPlatformConfig(false),
@@ -8864,6 +8886,7 @@ function createRuntimeState() {
 		css: {
 			importerToDependencies: /* @__PURE__ */ new Map(),
 			dependencyToImporters: /* @__PURE__ */ new Map(),
+			transformedSidecarSource: /* @__PURE__ */ new Map(),
 			emittedSource: /* @__PURE__ */ new Map(),
 			sidecarImports: /* @__PURE__ */ new Set()
 		},
@@ -8939,6 +8962,7 @@ function resetRuntimeStateForFreshBuild(runtimeState) {
 	const css = runtimeState.css;
 	css.importerToDependencies.clear();
 	css.dependencyToImporters.clear();
+	css.transformedSidecarSource.clear();
 	css.emittedSource.clear();
 	const wxml = runtimeState.wxml;
 	wxml.depsMap.clear();
@@ -10548,45 +10572,6 @@ function createSharedBuildConfig(configService, scanService) {
 	return { build: { rolldownOptions: { output: createSharedBuildOutput(configService, () => scanService.subPackageMap.keys()) } } };
 }
 //#endregion
-//#region src/runtime/statefulHmr/outputWriter.ts
-/**
-* @description 通过独立的 Vite write 阶段持久化 DevEngine 已生成的文件，不重新解析业务源码。
-*/
-async function writeStatefulHmrOutput(outDir, output) {
-	const virtualEntry = "\0weapp-vite-stateful-hmr-output";
-	await build({
-		configFile: false,
-		logLevel: "silent",
-		build: {
-			emptyOutDir: false,
-			minify: false,
-			outDir,
-			rolldownOptions: { input: virtualEntry },
-			write: true
-		},
-		plugins: [{
-			name: "weapp-vite:stateful-hmr-output-writer",
-			resolveId(id) {
-				return id === virtualEntry ? virtualEntry : void 0;
-			},
-			load(id) {
-				return id === virtualEntry ? "export {}" : void 0;
-			},
-			buildStart() {
-				for (const item of output) this.emitFile({
-					type: "asset",
-					fileName: item.fileName.replaceAll("\\", "/"),
-					source: item.type === "chunk" ? item.code : item.source
-				});
-			},
-			generateBundle(_options, bundle) {
-				for (const [fileName, item] of Object.entries(bundle)) if (item.type === "chunk" && item.facadeModuleId === virtualEntry) delete bundle[fileName];
-			}
-		}],
-		root: path$1.dirname(outDir)
-	});
-}
-//#endregion
 //#region src/runtime/statefulHmr/runtimeSource.ts
 const statefulHmrRolldownRuntimeSource = `
 var BaseDevRuntime = DevRuntime;
@@ -10617,7 +10602,6 @@ class WeappViteDevRuntime extends BaseDevRuntime {
   registrationModuleId = '';
   createEsmInitializer = (id, initialize, _deduplicate, result) => () => {
     if (!initialize) return result;
-    if (!this.applyingPatch && this.patchedModules.has(id)) return result;
     const callback = initialize;
     initialize = undefined;
     const previousId = this.currentModuleId;
@@ -10629,7 +10613,6 @@ class WeappViteDevRuntime extends BaseDevRuntime {
   };
   createCjsInitializer = (id, initialize, _deduplicate, module) => () => {
     if (module) return module.exports;
-    if (!this.applyingPatch && this.patchedModules.has(id)) return this.loadExports(id);
     module = { exports: {} };
     const previousId = this.currentModuleId;
     this.currentModuleId = id;
@@ -10652,6 +10635,16 @@ class WeappViteDevRuntime extends BaseDevRuntime {
     this.registrationModuleId = id;
     return super.registerModule(id, exportsHolder);
   }
+  initModule(id) {
+    const previousId = this.currentModuleId;
+    this.currentModuleId = id;
+    try {
+      const result = super.initModule(id);
+      if (this.applyingPatch) this.patchedModules.add(id);
+      return result;
+    }
+    finally { this.currentModuleId = previousId; }
+  }
   beginPatch() { this.applyingPatch = true; }
   endPatch() { this.applyingPatch = false; }
   applyUpdates(boundaries) {
@@ -10945,7 +10938,7 @@ function createStatefulHmrControlSource(control) {
 globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CONTROL_KEY)}] = ${JSON.stringify(control)};
 (() => {
   const control = globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CONTROL_KEY)}];
-  if (globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CLIENT_KEY)}]) return;
+  globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CLIENT_KEY)}]?.stop?.();
   let version = 0;
   let phase = 'registering';
   let pendingBatch;
@@ -11003,7 +10996,38 @@ globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CONTROL_KEY)}] = ${JSON.stri
     wx.reLaunch({ url: '/' + route + (query ? '?' + query : ''), complete: () => send('poll') });
   };
   globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CLIENT_KEY)}] = {
+    lastApply: undefined,
     getVersion() { return version; },
+    getLastApply() { return this.lastApply; },
+    stop() {
+      phase = 'stopped';
+      if (timer) {
+        clearTimeout(timer);
+        timer = undefined;
+      }
+      activeRequest?.abort?.();
+      activeRequest = undefined;
+    },
+    applyChangedModules(changedIds) {
+      const runtime = globalThis.__rolldown_runtime__;
+      if (!runtime || !Array.isArray(changedIds)) return;
+      const uniqueIds = [...new Set(changedIds.filter((id) => typeof id === 'string'))];
+      const summary = { changedIds: uniqueIds, initialized: [], missing: [], executedBefore: [], executedAfterRemove: [] };
+      for (const id of uniqueIds) {
+        if (typeof runtime.isExecuted === 'function' && runtime.isExecuted(id)) summary.executedBefore.push(id);
+        if (typeof runtime.removeModuleCache === 'function') runtime.removeModuleCache.call(runtime, id);
+        if (typeof runtime.isExecuted === 'function' && runtime.isExecuted(id)) summary.executedAfterRemove.push(id);
+      }
+      for (const id of uniqueIds) {
+        if (typeof runtime.hasFactory === 'function' && !runtime.hasFactory(id)) {
+          summary.missing.push(id);
+          continue;
+        }
+        if (typeof runtime.initModule === 'function') runtime.initModule.call(runtime, id);
+        summary.initialized.push(id);
+      }
+      this.lastApply = summary;
+    },
     receiveBatch(meta, apply) {
       if (phase === 'registering') {
         pendingBatch = { meta, apply };
@@ -11020,6 +11044,7 @@ globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CONTROL_KEY)}] = ${JSON.stri
       bridge.beginUpdate?.();
       try {
         apply();
+        globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CLIENT_KEY)}].applyChangedModules(meta.changedIds);
         version = meta.targetVersion;
         phase = meta.compatible === false ? 'relaunching' : 'polling';
       } catch (error) {
@@ -11038,6 +11063,148 @@ globalThis[${JSON.stringify(WEAPP_VITE_STATEFUL_HMR_CONTROL_KEY)}] = ${JSON.stri
 `;
 }
 //#endregion
+//#region src/runtime/statefulHmr/commonRuntime.ts
+const require$1 = createRequire(import.meta.url);
+const STATIC_IMPORT_RE = /^import\s+(?:\{[^}\n]*\}|[A-Za-z_$][\w$]*)\s+from\s+['"]([^'"]+)['"](?:;\s*)?$/gm;
+const EXPORT_PREFIX_RE = /^export\s+/gm;
+const STATEFUL_HMR_RUNTIME_COMPATIBILITY_ERROR_CODE = "WEAPP_VITE_STATEFUL_HMR_RUNTIME_INCOMPATIBLE";
+var StatefulHmrRuntimeCompatibilityError = class extends Error {
+	code = STATEFUL_HMR_RUNTIME_COMPATIBILITY_ERROR_CODE;
+	constructor(message) {
+		super(message);
+		this.name = "StatefulHmrRuntimeCompatibilityError";
+	}
+};
+function readRolldownRuntimeSource(subpath) {
+	try {
+		const filePath = require$1.resolve(subpath);
+		return {
+			filePath,
+			source: readFileSync(filePath, "utf8")
+		};
+	} catch (error) {
+		throw new StatefulHmrRuntimeCompatibilityError(`无法读取 Rolldown 状态保持 HMR 基础运行时 ${subpath}：${error instanceof Error ? error.message : String(error)}`);
+	}
+}
+function stripModuleSyntax(source) {
+	return source.replace(STATIC_IMPORT_RE, "").replace(EXPORT_PREFIX_RE, "");
+}
+function resolveRuntimeHelpers(runtime) {
+	return [...runtime.source.matchAll(STATIC_IMPORT_RE)].map((match) => match[1]).filter((specifier) => Boolean(specifier && specifier.startsWith("."))).map((specifier) => {
+		const helperPath = path$1.resolve(path$1.dirname(runtime.filePath), specifier);
+		try {
+			return readFileSync(helperPath, "utf8");
+		} catch (error) {
+			throw new StatefulHmrRuntimeCompatibilityError(`无法读取 Rolldown dev runtime helper ${specifier}：${error instanceof Error ? error.message : String(error)}`);
+		}
+	}).map(stripModuleSyntax).join("\n");
+}
+function assertRolldownRuntimeContract(runtime, helpers) {
+	const missing = [
+		[
+			runtime.source,
+			/(?:class\s+DevRuntime|(?:var|let|const)\s+DevRuntime\s*=)/,
+			"DevRuntime"
+		],
+		[
+			runtime.source,
+			/(?:class\s+Module|(?:var|let|const)\s+Module\s*=)/,
+			"Module"
+		],
+		[
+			helpers,
+			/(?:var|let|const)\s+__exportAll\s*=|function\s+__exportAll\b/,
+			"common runtime helpers"
+		]
+	].filter(([source, pattern]) => !pattern.test(source));
+	if (missing.length > 0) throw new StatefulHmrRuntimeCompatibilityError(`Rolldown dev runtime ${runtime.filePath} 缺少稳定契约：${missing.map(([, , name]) => name).join("、")}。`);
+}
+function composeStatefulHmrRuntimeSource(runtime, helpers) {
+	assertRolldownRuntimeContract(runtime, helpers);
+	return `${helpers}\n${stripModuleSyntax(runtime.source)}\n${statefulHmrRolldownRuntimeSource}`;
+}
+function createStatefulHmrRolldownRuntimeSource() {
+	const runtime = readRolldownRuntimeSource("rolldown/experimental/runtime");
+	return composeStatefulHmrRuntimeSource(runtime, resolveRuntimeHelpers(runtime));
+}
+function assertStatefulHmrRuntimeOutput(output) {
+	const runtime = output.find((item) => item.type === "chunk" && item.fileName === "rolldown-runtime.js");
+	if (!runtime || runtime.type !== "chunk") throw new StatefulHmrRuntimeCompatibilityError("stateful HMR 初始构建未生成 rolldown-runtime.js。");
+	const missing = [
+		/(?:class|var) DevRuntime(?:\s*=\s*class)?/,
+		/(?:class|var) WeappViteDevRuntime(?:\s*=\s*class)?/,
+		"new WeappViteDevRuntime",
+		"__WEAPP_VITE_STATEFUL_HMR_BRIDGE__"
+	].filter((contract) => typeof contract === "string" ? !runtime.code.includes(contract) : !contract.test(runtime.code));
+	if (missing.length > 0) throw new StatefulHmrRuntimeCompatibilityError(`stateful HMR runtime 不完整，缺少 ${missing.length} 项必要契约。`);
+}
+function isStatefulHmrRuntimeCompatibilityError(error) {
+	return error instanceof StatefulHmrRuntimeCompatibilityError || typeof error === "object" && error !== null && Reflect.get(error, "code") === "WEAPP_VITE_STATEFUL_HMR_RUNTIME_INCOMPATIBLE";
+}
+//#endregion
+//#region src/runtime/statefulHmr/outputWriter.ts
+/**
+* @description 通过独立的 Vite write 阶段持久化 DevEngine 已生成的文件，不重新解析业务源码。
+*/
+async function writeStatefulHmrOutput(outDir, output) {
+	const virtualEntry = "\0weapp-vite-stateful-hmr-output";
+	await build({
+		configFile: false,
+		logLevel: "silent",
+		build: {
+			emptyOutDir: false,
+			minify: false,
+			outDir,
+			rolldownOptions: { input: virtualEntry },
+			write: true
+		},
+		plugins: [{
+			name: "weapp-vite:stateful-hmr-output-writer",
+			resolveId(id) {
+				return id === virtualEntry ? virtualEntry : void 0;
+			},
+			load(id) {
+				return id === virtualEntry ? "export {}" : void 0;
+			},
+			buildStart() {
+				for (const item of output) this.emitFile({
+					type: "asset",
+					fileName: item.fileName.replaceAll("\\", "/"),
+					source: item.type === "chunk" ? item.code : item.source
+				});
+			},
+			generateBundle(_options, bundle) {
+				for (const [fileName, item] of Object.entries(bundle)) if (item.type === "chunk" && item.facadeModuleId === virtualEntry) delete bundle[fileName];
+			}
+		}],
+		root: path$1.dirname(outDir)
+	});
+}
+//#endregion
+//#region src/runtime/statefulHmr/sidecarPlugin.ts
+function createStatefulHmrSidecarModuleCode(id, source) {
+	const request = parseSidecarSourceRequest(id);
+	if (!request || request.kind === "style") return;
+	const digest = createHash("sha256").update(source).digest("hex");
+	return `export default ${JSON.stringify(digest)};\n`;
+}
+function createStatefulHmrSidecarPlugin() {
+	return {
+		name: "weapp-vite:stateful-hmr-sidecar",
+		enforce: "pre",
+		async load(id) {
+			const request = parseSidecarSourceRequest(id);
+			if (!request || request.kind === "style") return;
+			this.addWatchFile(request.sourceId);
+			const code = createStatefulHmrSidecarModuleCode(id, await readFile(request.sourceId, "utf8"));
+			return code ? {
+				code,
+				moduleSideEffects: "no-treeshake"
+			} : void 0;
+		}
+	};
+}
+//#endregion
 //#region src/runtime/statefulHmr/serverState.ts
 function createStatefulHmrServerState(buildId) {
 	return {
@@ -11055,6 +11222,7 @@ function transitionStatefulHmrServer(state, event) {
 			return unchanged({
 				...state,
 				deltas: [...state.deltas, {
+					changedIds: event.changedIds,
 					code: event.code,
 					version
 				}],
@@ -11199,10 +11367,11 @@ var StatefulHmrTransport = class {
 		this.closed = true;
 		this.respondToAll({ type: "rebuilding" });
 	}
-	addDelta(code) {
+	addDelta(code, changedIds) {
 		this.apply({
 			type: "delta-added",
 			bytes: Buffer.byteLength(code),
+			changedIds,
 			code
 		});
 		this.respondToAll({ type: "changed" });
@@ -11321,8 +11490,10 @@ var StatefulHmrTransport = class {
 	}
 };
 function renderBatch(batch, nonce) {
+	const changedIds = [...new Set(batch.deltas.flatMap((delta) => delta.changedIds))];
 	const metadata = {
 		buildId: batch.buildId,
+		changedIds,
 		compatible: true,
 		fromVersion: batch.fromVersion,
 		targetVersion: batch.targetVersion
@@ -11367,6 +11538,7 @@ var StatefulHmrViteAdapter = class {
 	server;
 	callbacks;
 	bundledDev;
+	initialOutputError;
 	constructor(config, server, callbacks) {
 		this.config = config;
 		this.server = server;
@@ -11382,32 +11554,45 @@ var StatefulHmrViteAdapter = class {
 		this.installPatches(bundledDev);
 		this.installListener(bundledDev);
 	}
-	async rebuild() {
+	async rebuild(prepare) {
 		const engine = this.bundledDev?._devEngine;
-		if (!engine) return;
+		if (!engine) throw new Error("Vite DevEngine 未初始化，无法执行 stateful HMR 完整刷新。");
+		await prepare?.();
 		engine.triggerFullBuild();
 		await engine.ensureLatestBuildOutput();
 	}
-	registerBundleModules(output) {
+	async registerBundleModules(output) {
 		const moduleIds = /* @__PURE__ */ new Set();
+		const payloadFilenames = [];
 		for (const item of output) {
 			if (item.type !== "chunk") continue;
+			payloadFilenames.push(item.fileName);
 			for (const match of item.code.matchAll(/registerModule\("([^"]+)"/g)) moduleIds.add(match[1]);
 			for (const id of Object.keys(item.modules ?? {})) {
 				const normalized = toStableModuleId(id, this.config.root);
 				if (!moduleIds.has(normalized)) moduleIds.add(normalized);
 			}
 		}
-		this.registerModules([...moduleIds]);
+		await this.registerModules([...moduleIds]);
+		await this.markPayloadsDelivered(payloadFilenames);
 		return moduleIds.size;
 	}
-	registerPatchModules(code) {
+	async registerPatchModules(code) {
 		const moduleIds = /* @__PURE__ */ new Set();
 		for (const match of code.matchAll(/create(?:Esm|Cjs)Initializer\("([^"]+)"/g)) moduleIds.add(match[1]);
-		this.registerModules([...moduleIds]);
+		await this.registerModules([...moduleIds]);
 	}
-	registerModules(moduleIds) {
-		if (moduleIds.length) this.bundledDev?._devEngine?.registerModules(clientId, moduleIds);
+	async markPayloadDelivered(filename) {
+		await this.markPayloadsDelivered([filename]);
+	}
+	async registerModules(moduleIds) {
+		const engine = this.bundledDev?._devEngine;
+		if (moduleIds.length && typeof engine?.registerModules === "function") await engine.registerModules(clientId, moduleIds);
+	}
+	async markPayloadsDelivered(filenames) {
+		const engine = this.bundledDev?._devEngine;
+		if (typeof engine?.notifyPayloadDelivered !== "function") return;
+		for (const filename of filenames) await engine.notifyPayloadDelivered(filename);
 	}
 	installOptions(bundledDev) {
 		const original = bundledDev.getRolldownOptions.bind(bundledDev);
@@ -11434,8 +11619,9 @@ var StatefulHmrViteAdapter = class {
 			options.experimental ??= {};
 			options.experimental.devMode = {
 				...typeof options.experimental.devMode === "object" ? options.experimental.devMode : {},
-				implement: statefulHmrRolldownRuntimeSource,
-				lazy: false
+				implement: createStatefulHmrRolldownRuntimeSource(),
+				lazy: false,
+				skipCommonRuntimeInjection: true
 			};
 			return options;
 		};
@@ -11443,14 +11629,23 @@ var StatefulHmrViteAdapter = class {
 	installOutput(bundledDev) {
 		const original = bundledDev.storeOutputFiles.bind(bundledDev);
 		bundledDev.storeOutputFiles = (output) => {
-			original(output);
-			this.callbacks.onOutput(output);
+			try {
+				if (output.some((item) => item.fileName === "app.js")) assertStatefulHmrRuntimeOutput(output);
+				original(output);
+				this.callbacks.onOutput(output);
+			} catch (error) {
+				this.initialOutputError = error instanceof Error ? error : new Error(String(error));
+				throw error;
+			}
 		};
 	}
 	installPatches(bundledDev) {
 		const original = bundledDev.handleHmrOutput.bind(bundledDev);
 		bundledDev.handleHmrOutput = (client, files, output, info) => {
-			if (output.type === "Noop") return;
+			if (output.type === "Noop") {
+				this.callbacks.onPatch(files, output);
+				return;
+			}
 			if (this.callbacks.onPatch(files, output)) original(client, files, output, info);
 		};
 	}
@@ -11461,7 +11656,9 @@ var StatefulHmrViteAdapter = class {
 			bundledDev.clients.setupIfNeeded({ send: (payload) => this.handlePayload(payload) }, clientId);
 			const engine = bundledDev._devEngine;
 			if (!engine) throw new Error("Vite 未初始化微信状态保持 HMR 所需的 DevEngine。");
+			await engine.registerClient?.(clientId);
 			await engine.ensureCurrentBuildFinish();
+			if (this.initialOutputError) throw this.initialOutputError;
 			if ((await engine.getBundleState()).lastBuildErrored) throw new Error("微信状态保持 HMR 初次构建失败。");
 			await this.callbacks.waitForInitialBundle();
 		};
@@ -11501,7 +11698,7 @@ function toStableModuleId(id, root) {
 //#region src/runtime/statefulHmr/session.ts
 const maxRetainedDeltaCount = 1e3;
 const maxRetainedDeltaBytes = 16777216;
-async function runStatefulHmrDev(ctx, buildOptions, restart) {
+async function runStatefulHmrDev(ctx, buildOptions, restart, snapshots) {
 	const configService = ctx.configService;
 	if (configService.platform !== "weapp") throw new Error("weapp.hmr.runtime=\"stateful-experimental\" 目前仅支持微信小程序平台。");
 	let session;
@@ -11509,12 +11706,12 @@ async function runStatefulHmrDev(ctx, buildOptions, restart) {
 		name: "weapp-vite:stateful-hmr-session",
 		enforce: "post",
 		configureServer(server) {
-			const currentSession = new StatefulHmrSession(ctx, server, restart);
+			const currentSession = new StatefulHmrSession(ctx, server, restart, snapshots);
 			session = currentSession;
 			currentSession.install();
 		},
 		transform(code, id) {
-			if (!isStatefulHmrBoundary(id, configService.absoluteSrcRoot) || code.includes("import.meta.hot.accept")) return;
+			if (!isStatefulHmrBoundary(id, configService.absoluteSrcRoot, ctx.runtimeState.build.hmr.resolvedEntryMap.keys()) || code.includes("import.meta.hot.accept")) return;
 			return `${id.endsWith(".vue") ? code : redirectNativeComponentRegistration(code)}\nif (import.meta.hot) import.meta.hot.accept();\n`;
 		}
 	};
@@ -11531,7 +11728,11 @@ async function runStatefulHmrDev(ctx, buildOptions, restart) {
 			...buildOptions.experimental ?? {},
 			bundledDev: true
 		},
-		plugins: [installPlugin, ...buildOptions.plugins ?? []],
+		plugins: [
+			createStatefulHmrSidecarPlugin(),
+			installPlugin,
+			...buildOptions.plugins ?? []
+		],
 		server: {
 			...buildOptions.server ?? {},
 			host: "127.0.0.1",
@@ -11543,28 +11744,40 @@ async function runStatefulHmrDev(ctx, buildOptions, restart) {
 			write: false
 		}
 	});
-	await server.listen();
-	if (!session) {
-		await server.close();
-		throw new Error("微信状态保持 HMR session 未完成初始化。");
+	try {
+		await server.listen();
+		if (!session) throw new Error("微信状态保持 HMR session 未完成初始化。");
+		await session.refreshControl();
+		return createWatcherAdapter(server, session);
+	} catch (error) {
+		await session?.close().catch(() => {});
+		await server.close().catch(() => {});
+		throw error;
 	}
-	await session.refreshControl();
-	return createWatcherAdapter(server, session);
 }
 var StatefulHmrSession = class {
 	ctx;
 	server;
 	restart;
+	snapshots;
 	adapter;
 	initialBundle = Promise.withResolvers();
 	transport;
+	fullBuildTimer;
 	outputChain = Promise.resolve();
-	rebuildTimer;
 	restartTimer;
-	constructor(ctx, server, restart) {
+	snapshotTimer;
+	snapshotFiles = /* @__PURE__ */ new Set();
+	snapshotAssets = /* @__PURE__ */ new Map();
+	sourceChangeListener = (file, dirtyReasonSummary) => {
+		this.handleSourceUpdate(file, dirtyReasonSummary);
+	};
+	constructor(ctx, server, restart, snapshots) {
 		this.ctx = ctx;
 		this.server = server;
 		this.restart = restart;
+		this.snapshots = snapshots;
+		this.replaceSnapshotAssets(snapshots.initial);
 		this.transport = new StatefulHmrTransport(server, async (buildId, source) => {
 			await this.enqueueOutput(async () => {
 				if (!this.transport.isCurrentBuild(buildId)) return;
@@ -11585,10 +11798,13 @@ var StatefulHmrSession = class {
 	install() {
 		this.transport.install();
 		this.adapter.install();
+		this.ctx.onStatefulHmrSourceChange = this.sourceChangeListener;
 	}
 	async close() {
-		if (this.rebuildTimer) clearTimeout(this.rebuildTimer);
+		if (this.fullBuildTimer) clearTimeout(this.fullBuildTimer);
+		if (this.snapshotTimer) clearTimeout(this.snapshotTimer);
 		if (this.restartTimer) clearTimeout(this.restartTimer);
+		if (this.ctx.onStatefulHmrSourceChange === this.sourceChangeListener) this.ctx.onStatefulHmrSourceChange = void 0;
 		this.transport.close();
 		await this.outputChain;
 	}
@@ -11601,13 +11817,28 @@ var StatefulHmrSession = class {
 			}]);
 		});
 	}
+	handleSourceUpdate(file, dirtyReasonSummary = []) {
+		const normalizedFile = normalizeFsResolvedId(path.isAbsolute(file) ? file : path.resolve(this.server.config.root, file));
+		const normalizedOutDir = normalizeFsResolvedId(this.ctx.configService.outDir).replace(/\/$/, "");
+		if (normalizedFile === normalizedOutDir || normalizedFile.startsWith(`${normalizedOutDir}/`)) return;
+		if (shouldRestartStatefulHmrServer([normalizedFile], this.ctx.configService?.configFileDependencies)) {
+			this.requestServerRestart();
+			return;
+		}
+		if (requiresStatefulHmrSnapshot(normalizedFile, dirtyReasonSummary)) {
+			if (!this.snapshotTimer && !this.fullBuildTimer) logger_default.info("微信状态保持 HMR 正在刷新模板、样式与静态资源产物...");
+			this.requestSnapshotRefresh([normalizedFile]);
+		}
+	}
 	handleOutput(output) {
 		this.enqueueOutput(async () => {
 			const compatibleOutput = await transformOutput(output);
 			const fullBuild = compatibleOutput.some((item) => item.fileName === "app.js");
 			if (fullBuild) {
+				mergeStatefulHmrSnapshotAssets(compatibleOutput, this.snapshotAssets.values());
 				const buildId = this.transport.createBuildId();
 				this.transport.commitFullBuild(buildId);
+				stampStatefulHmrFullBuild(compatibleOutput, buildId);
 				setAsset(compatibleOutput, WEAPP_VITE_STATEFUL_HMR_CONTROL_FILE, createStatefulHmrControlSource({
 					...this.transport.createControl(),
 					buildId
@@ -11617,39 +11848,59 @@ var StatefulHmrSession = class {
 			}
 			await writeStatefulHmrOutput(this.ctx.configService.outDir, compatibleOutput);
 			if (fullBuild) {
-				const moduleCount = this.adapter.registerBundleModules(compatibleOutput);
+				const moduleCount = await this.adapter.registerBundleModules(compatibleOutput);
 				this.server.config.logger.info(`[weapp-vite] 微信状态保持 HMR 已就绪（${moduleCount} modules）`);
 				this.initialBundle.resolve();
 			}
 		});
 	}
 	handlePatch(files, output) {
-		if (!isSafeJavaScriptPatch(files, output, this.ctx.runtimeState.build.hmr.profile.dirtyReasonSummary)) {
-			this.requestServerRestart();
+		if (output.type === "Noop") return false;
+		if (!isSafeJavaScriptPatch(files, output, this.ctx.runtimeState.build.hmr.profile.dirtyReasonSummary, this.ctx.runtimeState.build.hmr.resolvedEntryMap.keys(), this.server.config.root)) {
+			if (shouldRestartStatefulHmrServer(files, this.ctx.configService?.configFileDependencies)) this.requestServerRestart();
+			else this.requestFullBuild(files);
 			return false;
 		}
-		this.adapter.registerPatchModules(output.code);
-		transformJavaScript(output.code, output.filename).then((code) => {
+		this.adapter.registerPatchModules(output.code).then(async () => {
+			const code = await transformJavaScript(output.code, output.filename);
 			if (shouldResetStatefulHmrRetention(this.transport.retainedDeltaCount, this.transport.retainedDeltaBytes, Buffer.byteLength(code))) {
 				this.requestFullBuild();
 				return;
 			}
-			this.transport.addDelta(code);
+			this.transport.addDelta(code, output.changedIds ?? []);
+			return this.adapter.markPayloadDelivered(output.filename);
 		}).catch((error) => {
 			this.server.config.logger.error("[weapp-vite] stateful HMR patch transform failed", { error });
 			this.requestFullBuild();
 		});
 		return true;
 	}
-	requestFullBuild() {
-		if (this.rebuildTimer) return;
-		this.rebuildTimer = setTimeout(() => {
-			this.rebuildTimer = void 0;
-			this.adapter.rebuild().catch((error) => {
+	requestFullBuild(files = []) {
+		for (const file of files) this.snapshotFiles.add(file);
+		if (this.snapshotTimer) {
+			clearTimeout(this.snapshotTimer);
+			this.snapshotTimer = void 0;
+		}
+		if (this.fullBuildTimer) return;
+		this.fullBuildTimer = setTimeout(() => {
+			this.fullBuildTimer = void 0;
+			const snapshotFiles = this.takeSnapshotFiles();
+			this.rebuildFromSnapshot(snapshotFiles).catch((error) => {
 				this.server.config.logger.error("[weapp-vite] stateful HMR full rebuild failed", { error });
 			});
 		}, 100);
 	}
+	requestSnapshotRefresh(files = []) {
+		for (const file of files) this.snapshotFiles.add(file);
+		if (this.fullBuildTimer || this.snapshotTimer) return;
+		this.snapshotTimer = setTimeout(() => {
+			this.snapshotTimer = void 0;
+			const snapshotFiles = this.takeSnapshotFiles();
+			this.refreshSnapshotAssets(snapshotFiles).catch((error) => {
+				this.server.config.logger.error("[weapp-vite] stateful HMR snapshot refresh failed", { error });
+			});
+		}, 100);
+	}
 	requestServerRestart() {
 		if (this.restartTimer) return;
 		this.restartTimer = setTimeout(() => {
@@ -11661,15 +11912,43 @@ var StatefulHmrSession = class {
 	}
 	enqueueOutput(task) {
 		this.outputChain = this.outputChain.then(task, task).catch((error) => {
-			this.server.config.logger.error("[weapp-vite] stateful HMR output failed", { error });
+			this.server.config.logger.error(`[weapp-vite] stateful HMR output failed: ${formatStatefulHmrError(error)}`);
 		});
 		return this.outputChain;
 	}
+	async rebuildFromSnapshot(files) {
+		await this.adapter.rebuild(async () => {
+			this.replaceSnapshotAssets(await this.snapshots.rebuild(files));
+		});
+	}
+	async refreshSnapshotAssets(files) {
+		this.replaceSnapshotAssets(await this.snapshots.rebuild(files));
+	}
+	takeSnapshotFiles() {
+		const files = [...this.snapshotFiles];
+		this.snapshotFiles.clear();
+		return files;
+	}
+	replaceSnapshotAssets(output) {
+		this.snapshotAssets = new Map(output.filter((item) => item.type === "asset").map((item) => [item.fileName, item]));
+	}
 	async waitForInitialBundle() {
 		await this.initialBundle.promise;
 		await this.outputChain;
 	}
 };
+function shouldRestartStatefulHmrServer(files, configFileDependencies = []) {
+	const normalizedConfigDependencies = new Set(Array.from(configFileDependencies, (dependency) => normalizeFsResolvedId(dependency)));
+	return Array.from(files).some((file) => normalizedConfigDependencies.has(normalizeFsResolvedId(file)));
+}
+function mergeStatefulHmrSnapshotAssets(output, snapshotAssets) {
+	for (const asset of snapshotAssets) {
+		if (asset.type !== "asset") continue;
+		const index = output.findIndex((item) => item.fileName === asset.fileName);
+		if (index >= 0) output[index] = asset;
+		else output.push(asset);
+	}
+}
 function createWatcherAdapter(server, session) {
 	return {
 		close: async () => {
@@ -11681,13 +11960,16 @@ function createWatcherAdapter(server, session) {
 		}
 	};
 }
-function isStatefulHmrBoundary(id, srcRoot) {
+function isStatefulHmrBoundary(id, srcRoot, entryIds) {
 	const sidecar = parseSidecarSourceRequest(id);
 	const sourceId = sidecar?.kind === "script" ? sidecar.sourceId : id.includes("?") ? void 0 : id;
 	if (!sourceId) return false;
-	const normalizedSourceId = sourceId.replaceAll("\\", "/");
-	const normalizedSrcRoot = srcRoot.replaceAll("\\", "/").replace(/\/$/, "");
-	return normalizedSourceId.startsWith(`${normalizedSrcRoot}/`) && /\.(?:[cm]?[jt]sx?|vue)$/.test(normalizedSourceId);
+	const normalizedSourceId = normalizeFsResolvedId(sourceId);
+	const normalizedSrcRoot = normalizeFsResolvedId(srcRoot).replace(/\/$/, "");
+	if (!normalizedSourceId.startsWith(`${normalizedSrcRoot}/`) || !/\.(?:[cm]?[jt]sx?|vue)$/.test(normalizedSourceId)) return false;
+	if (!entryIds) return true;
+	for (const entryId of entryIds) if (normalizeFsResolvedId(entryId) === normalizedSourceId) return true;
+	return false;
 }
 function redirectNativeComponentRegistration(code) {
 	if (!code.includes("Component")) return code;
@@ -11702,8 +11984,22 @@ function redirectNativeComponentRegistration(code) {
 	} });
 	return changed ? magicString.toString() : code;
 }
-function isSafeJavaScriptPatch(files, output, dirtyReasonSummary = []) {
-	return output.type === "Patch" && output.hmrBoundaries.length > 0 && files.every((file) => /\.(?:[cm]?[jt]sx?|vue)$/.test(file)) && !dirtyReasonSummary.some((reason) => /^(?:entry-json-only|entry-local-asset|entry-style-only):/.test(reason));
+function isSafeJavaScriptPatch(files, output, dirtyReasonSummary = [], entryIds, root) {
+	const normalizedEntryIds = entryIds ? new Set(Array.from(entryIds, (entryId) => normalizeFsResolvedId(entryId))) : void 0;
+	return output.type === "Patch" && files.every((file) => /\.(?:[cm]?[jt]sx?|vue)$/.test(file)) && (!normalizedEntryIds || files.every((file) => {
+		const absoluteFile = path.isAbsolute(file) || !root ? file : path.resolve(root, file);
+		return normalizedEntryIds.has(normalizeFsResolvedId(absoluteFile));
+	})) && !output.changedIds?.some(isNonJavaScriptSidecarId) && !dirtyReasonSummary.some(isUnsafeStatefulHmrReason);
+}
+function requiresStatefulHmrSnapshot(file, dirtyReasonSummary = []) {
+	return !/\.(?:[cm]?[jt]sx?|vue)$/.test(file) || dirtyReasonSummary.some(isUnsafeStatefulHmrReason);
+}
+function isUnsafeStatefulHmrReason(reason) {
+	return /^(?:entry-json-only|entry-local-asset|entry-style-only|tailwind-content):/.test(reason);
+}
+function isNonJavaScriptSidecarId(id) {
+	const sidecar = parseSidecarSourceRequest(id) ?? parseSidecarModuleId(id);
+	return sidecar !== void 0 && sidecar.kind !== "script";
 }
 function shouldResetStatefulHmrRetention(retainedDeltaCount, retainedDeltaBytes, nextDeltaBytes) {
 	return retainedDeltaCount >= maxRetainedDeltaCount || retainedDeltaBytes + nextDeltaBytes >= maxRetainedDeltaBytes;
@@ -11735,6 +12031,13 @@ function setAsset(output, fileName, source) {
 	if (index >= 0) output[index] = asset;
 	else output.push(asset);
 }
+function stampStatefulHmrFullBuild(output, buildId) {
+	for (const item of output) if (item.type === "chunk" && item.fileName.endsWith(".js")) item.code = `// weapp-vite-stateful-build:${buildId}\n${item.code}`;
+}
+function formatStatefulHmrError(error) {
+	if (error instanceof Error) return error.stack || error.message;
+	return String(error);
+}
 //#endregion
 //#region src/runtime/watch/options.ts
 function resolvePollingWatchConfig(configService) {
@@ -12983,8 +13286,10 @@ function parseWxml(options) {
 				};
 				if (Array.isArray(autoImportComponents[componentName])) autoImportComponents[componentName].push(range);
 				else autoImportComponents[componentName] = [range];
-				if (!excludeComponent(currentTagName)) if (Array.isArray(components[componentName])) components[componentName].push(range);
-				else components[componentName] = [range];
+				if (!excludeComponent(currentTagName)) {
+					if (Array.isArray(components[componentName])) components[componentName].push(range);
+					else components[componentName] = [range];
+				}
 			}
 			if (normalizeComponentTagName && shouldNormalizeTagName(name)) {
 				const normalized = toKebabCaseTagName(name);
@@ -13868,6 +14173,7 @@ function resetEmittedOutputCaches(runtimeState) {
 	runtimeState.asset.scopedSlotGenerics.clear();
 	runtimeState.build?.output?.emittedSource.clear();
 	runtimeState.css.emittedSource.clear();
+	runtimeState.css.transformedSidecarSource.clear();
 	runtimeState.wxml.emittedCode.clear();
 }
 async function cleanOutputs(configService) {
@@ -13976,6 +14282,10 @@ function watchWorkers(configService, watcherService, workersDir) {
 }
 //#endregion
 //#region src/runtime/buildPlugin/service.ts
+function toStatefulHmrOutput(output) {
+	if (!Array.isArray(output) && !("output" in output)) throw new TypeError("stateful HMR snapshot build unexpectedly returned a watcher");
+	return (Array.isArray(output) ? output : [output]).flatMap((result) => result.output);
+}
 function resolveSnapshotSidecarDirtySummary(filePath, affectedEntries) {
 	const normalizedFile = normalizeFsResolvedId(filePath);
 	if (configSuffixes.find((suffix) => normalizedFile.endsWith(suffix))) return "json-sidecar:1";
@@ -14087,6 +14397,8 @@ function createSnapshotSidecarIgnoredMatcher(ctx) {
 }
 function createBuildService(ctx) {
 	let lastHmrSlowTipProfileCount = 0;
+	let devHmrRuntime;
+	let devHmrRuntimeNoticeLogged = false;
 	function createHmrProfileJsonSample(totalMs) {
 		const profile = ctx.runtimeState.build.hmr.profile;
 		const relativeFile = profile.file && ctx.configService ? ctx.configService.relativeCwd(profile.file) : void 0;
@@ -14653,7 +14965,25 @@ function createBuildService(ctx) {
 			...buildOptions.build ?? {},
 			write: true
 		};
-		if (target === "app" && configService.weappViteConfig.hmr?.runtime === "stateful-experimental") {
+		const configuredHmrRuntime = configService.weappViteConfig.hmr?.runtime;
+		const compileHotReLoad = configService.projectPrivateConfig.setting?.compileHotReLoad;
+		devHmrRuntime ??= resolveHmrRuntime({
+			platform: configService.platform,
+			configured: configuredHmrRuntime,
+			compileHotReLoad
+		});
+		const hmrRuntime = devHmrRuntime;
+		if (target === "app" && !devHmrRuntimeNoticeLogged) {
+			devHmrRuntimeNoticeLogged = true;
+			const messages = formatHmrRuntimeStartupMessages({
+				platform: configService.platform,
+				configured: configuredHmrRuntime,
+				compileHotReLoad,
+				runtime: hmrRuntime
+			});
+			for (const message of messages) logger_default.info(message);
+		}
+		if (target === "app" && hmrRuntime === "stateful-experimental") try {
 			const snapshotBuildOptions = {
 				...buildOptions,
 				build: {
@@ -14661,7 +14991,8 @@ function createBuildService(ctx) {
 					watch: void 0
 				}
 			};
-			await build(snapshotBuildOptions);
+			const initialSnapshot = toStatefulHmrOutput(await build(snapshotBuildOptions));
+			await configService.load(configService.loadOptions);
 			resetRuntimeStateForFreshBuild(ctx.runtimeState);
 			await scanService.loadAppEntry();
 			scanService.loadSubPackages();
@@ -14676,14 +15007,49 @@ function createBuildService(ctx) {
 				await statefulWatcher?.close();
 				logger_default.info("检测到非兼容更新，正在重启微信状态保持 HMR 构建...");
 				resetRuntimeStateForFreshBuild(ctx.runtimeState);
+				await configService.load(configService.loadOptions);
 				await scanService.loadAppEntry();
 				scanService.loadSubPackages();
 				await runDev(target);
 				logger_default.success("微信状态保持 HMR 构建已完成完整重载。");
+			}, {
+				initial: initialSnapshot,
+				rebuild: async (files) => {
+					for (const file of files) invalidateFileCache(file);
+					resetRuntimeStateForFreshBuild(ctx.runtimeState);
+					await configService.load(configService.loadOptions);
+					await scanService.loadAppEntry();
+					scanService.loadSubPackages();
+					const snapshotOptions = createDevBuildOptions();
+					snapshotOptions.build = {
+						...snapshotOptions.build ?? {},
+						emptyOutDir: false,
+						watch: void 0,
+						write: true
+					};
+					snapshotOptions.plugins = [...snapshotOptions.plugins ?? [], {
+						name: "weapp-vite:stateful-hmr-snapshot-assets",
+						enforce: "post",
+						generateBundle(_options, bundle) {
+							for (const [fileName, item] of Object.entries(bundle)) if (item.type === "chunk") delete bundle[fileName];
+						}
+					}];
+					return toStatefulHmrOutput(await build(snapshotOptions));
+				}
 			}), workerPromise]);
 			statefulWatcher = watcher;
 			watcherService.setRollupWatcher(watcher, "/");
 			return watcher;
+		} catch (error) {
+			if (configuredHmrRuntime !== "auto" || !isStatefulHmrRuntimeCompatibilityError(error)) throw error;
+			devHmrRuntime = "classic";
+			logger_default.warn(`微信状态保持 HMR 运行时不可用，已自动降级为 classic：${error instanceof Error ? error.message : String(error)}`);
+			logger_default.info("HMR 模式：classic（auto fallback：stateful runtime compatibility check failed）");
+			resetRuntimeStateForFreshBuild(ctx.runtimeState);
+			await configService.load(configService.loadOptions);
+			await scanService.loadAppEntry();
+			scanService.loadSubPackages();
+			return await runDev(target);
 		}
 		const snapshotBuildOptions = {
 			...buildOptions,
@@ -15940,13 +16306,15 @@ function configureBuildAndPlugins(options) {
 	}
 	if (resolvedLibConfig?.enabled) {
 		const entryFileNames = createLibEntryFileNameResolver(resolvedLibConfig);
-		if (entryFileNames) if (Array.isArray(rdOptions.output)) rdOptions.output = rdOptions.output.map((output) => ({
-			...output,
-			entryFileNames
-		}));
-		else {
-			const output = rdOptions.output ?? (rdOptions.output = {});
-			output.entryFileNames = entryFileNames;
+		if (entryFileNames) {
+			if (Array.isArray(rdOptions.output)) rdOptions.output = rdOptions.output.map((output) => ({
+				...output,
+				entryFileNames
+			}));
+			else {
+				const output = rdOptions.output ?? (rdOptions.output = {});
+				output.entryFileNames = entryFileNames;
+			}
 		}
 	}
 	const rawPlugins = rdOptions.plugins;
@@ -16251,20 +16619,22 @@ function createLoadConfig(options) {
 		}
 		const loadedConfig = loaded?.config ?? {};
 		let weappLoaded;
-		if (weappConfigFilePath) if (shouldReuseLoadedWeappConfig(weappConfigFilePath, loaded?.path)) weappLoaded = loaded;
-		else try {
-			weappLoaded = await loadConfigFileWithFallback({
-				command: isDev ? "serve" : "build",
-				mode
-			}, weappConfigFilePath, cwd, configLoader);
-		} catch (error) {
-			const cjsError = createCjsConfigLoadError({
-				error,
-				configPath: weappConfigFilePath,
-				cwd
-			});
-			if (cjsError) throw cjsError;
-			throw error;
+		if (weappConfigFilePath) {
+			if (shouldReuseLoadedWeappConfig(weappConfigFilePath, loaded?.path)) weappLoaded = loaded;
+			else try {
+				weappLoaded = await loadConfigFileWithFallback({
+					command: isDev ? "serve" : "build",
+					mode
+				}, weappConfigFilePath, cwd, configLoader);
+			} catch (error) {
+				const cjsError = createCjsConfigLoadError({
+					error,
+					configPath: weappConfigFilePath,
+					cwd
+				});
+				if (cjsError) throw cjsError;
+				throw error;
+			}
 		}
 		const mergedLoadedConfig = weappLoaded?.config ? defu(weappLoaded.config, loadedConfig) : loadedConfig;
 		const config = defu(inlineConfig, {
@@ -16353,6 +16723,7 @@ function createLoadConfig(options) {
 			cwd
 		});
 		let projectConfig = {};
+		let projectPrivateConfig = {};
 		let projectConfigPathResolved;
 		let projectPrivateConfigPathResolved;
 		let mpDistRoot = "";
@@ -16368,6 +16739,7 @@ function createLoadConfig(options) {
 				basePath,
 				privatePath
 			});
+			projectPrivateConfig = await getProjectPrivateConfig(cwd, { privatePath });
 			mpDistRoot = resolveProjectConfigRoot(projectConfig, platform) ?? "";
 			if (!mpDistRoot) {
 				const displayPath = formatProjectConfigPath(cwd, basePath ?? getProjectConfigFileName(platform));
@@ -16428,6 +16800,7 @@ function createLoadConfig(options) {
 			emitDefaultAutoImportOutputs: opts.emitDefaultAutoImportOutputs ?? true,
 			chunksConfigured,
 			projectConfig,
+			projectPrivateConfig,
 			projectConfigPath: projectConfigPathResolved,
 			projectPrivateConfigPath: projectPrivateConfigPathResolved,
 			mpDistRoot,
@@ -20615,6 +20988,7 @@ async function invalidateEntryForSidecar(ctx, filePath, event = "update") {
 	}
 	const isCssSidecar = Boolean(ext && watchedCssExts.has(ext));
 	const isTemplateSidecar = Boolean(ext && watchedTemplateExts.has(ext));
+	if (isCssSidecar) ctx.runtimeState?.css?.transformedSidecarSource.delete(normalizedPath);
 	const sidecarCause = configSuffix ? "json-sidecar" : isCssSidecar ? "style-sidecar" : "sidecar-direct";
 	const configService = ctx.configService;
 	const relativeSource = configService.relativeCwd(normalizedPath);
@@ -23409,6 +23783,10 @@ function hasCustomAutoRuleConfig(config) {
 function hasConfiguredNetworkDefaults(config) {
 	return Boolean(config && typeof config === "object" && hasOwn$5(config, "networkDefaults"));
 }
+function resolveAutoPrelude(config) {
+	if (!config || typeof config !== "object" || !hasOwn$5(config, "prelude")) return true;
+	return config.prelude === true;
+}
 function resolveAutoRules(config) {
 	if (hasCustomAutoRuleConfig(config)) return [{
 		dependencyPatterns: resolveDependencyPatterns(config),
@@ -23447,7 +23825,7 @@ function resolveInjectRequestGlobalsOptions(config, packageJson) {
 	return {
 		mode: "auto",
 		targets: [...matchedTargets],
-		prelude: config && typeof config === "object" ? config.prelude === true : false
+		prelude: resolveAutoPrelude(config)
 	};
 }
 function resolveRequestRuntimeOptions(input, packageJson, warn) {
@@ -23803,18 +24181,20 @@ function removeConditionalBlock(start) {
 	while (node && depth > 0) {
 		if (node.type === "comment") {
 			const directive = parseDirective(node.text);
-			if (directive) if (directive.type === "endif") {
-				depth -= 1;
-				const comment = node;
-				node = comment.next();
-				comment.remove();
-				continue;
-			} else {
-				depth += 1;
-				const comment = node;
-				node = comment.next();
-				comment.remove();
-				continue;
+			if (directive) {
+				if (directive.type === "endif") {
+					depth -= 1;
+					const comment = node;
+					node = comment.next();
+					comment.remove();
+					continue;
+				} else {
+					depth += 1;
+					const comment = node;
+					node = comment.next();
+					comment.remove();
+					continue;
+				}
 			}
 		}
 		const next = node.next();
@@ -23836,10 +24216,12 @@ const postCreator = (options = { platform: "weapp" }) => {
 						atRule.name = "import";
 						return;
 					}
-					if (atRule.name === `wv-if`) if (![...atRule.params.matchAll(/\(([^)]+)\)/g)].some((match) => {
-						return match[1].trim() === platform;
-					})) atRule.remove();
-					else atRule.replaceWith(atRule.nodes);
+					if (atRule.name === `wv-if`) {
+						if (![...atRule.params.matchAll(/\(([^)]+)\)/g)].some((match) => {
+							return match[1].trim() === platform;
+						})) atRule.remove();
+						else atRule.replaceWith(atRule.nodes);
+					}
 				},
 				Comment(comment) {
 					const directive = parseDirective(comment.text);
@@ -24164,6 +24546,16 @@ async function readStyleGraphSource(stylePath, fallback) {
 		return fallback;
 	}
 }
+async function resolveMemoryStyleSource(ctx, stylePath) {
+	const sourceId = normalizeFsResolvedId(stylePath, { stripLeadingNullByte: true });
+	const cache = ctx.runtimeState?.css?.transformedSidecarSource;
+	const cached = cache?.get(sourceId);
+	if (!cached) return;
+	try {
+		if (await fs$1.readFile(stylePath, "utf8") === cached.diskSource) return cached.code;
+	} catch {}
+	cache?.delete(sourceId);
+}
 function resolveOutputStyleFileName(configService, stylePath) {
 	return configService.relativeOutputPath(changeFileExtension(stylePath, configService.outputExtensions.wxss));
 }
@@ -24267,7 +24659,7 @@ async function emitStyleSidecarAsset(ctx, pluginCtx, bundle, stylePath, resolved
 	const { configService } = ctx;
 	const fileName = resolveOutputStyleFileName(configService, stylePath);
 	if (!fileName) return false;
-	const rawCss = await fs$1.readFile(stylePath, "utf8");
+	const rawCss = await resolveMemoryStyleSource(ctx, stylePath) ?? await fs$1.readFile(stylePath, "utf8");
 	const { css, dependencies } = await preprocessStyleSource(rawCss, stylePath, resolvedConfig);
 	syncCssImportDependencies(ctx, stylePath, rawCss, dependencies);
 	if (typeof pluginCtx.addWatchFile === "function") for (const dependency of dependencies) pluginCtx.addWatchFile(normalizeWatchPath(dependency));
@@ -24323,7 +24715,7 @@ async function handleBundleEntry(ctx, bundle, bundleKey, asset, configService, s
 			const normalizedFileName = toPosixPath(fileName);
 			const freshHmrStyleSourcePath = resolveFreshHmrStyleSourcePath(ctx, normalizedFileName);
 			const preprocessId = freshHmrStyleSourcePath ?? absOriginal;
-			const preprocessInput = freshHmrStyleSourcePath ? await readStyleGraphSource(freshHmrStyleSourcePath, canonicalSource) : canonicalSource;
+			const preprocessInput = freshHmrStyleSourcePath ? await resolveMemoryStyleSource(ctx, freshHmrStyleSourcePath) ?? await readStyleGraphSource(freshHmrStyleSourcePath, canonicalSource) : canonicalSource;
 			const { css, dependencies } = await preprocessStyleSource(preprocessInput, preprocessId, resolvedConfig, { enabled: shouldPreprocessWithVite(preprocessId) });
 			syncCssImportDependencies(ctx, preprocessId, freshHmrStyleSourcePath ? preprocessInput : await readStyleGraphSource(absOriginal, canonicalSource), dependencies);
 			if (typeof this.addWatchFile === "function") for (const dependency of dependencies) this.addWatchFile(normalizeWatchPath(dependency));
@@ -24470,6 +24862,23 @@ function css(ctx) {
 			await generateBundleSharedCss.call(this, ctx, configService, bundle, styleAnalysis, resolvedConfig);
 			await emitCollectedStyleSidecars.call(this, ctx, rolldownBundle, resolvedConfig);
 		}
+	}, {
+		name: "weapp-vite:css-sidecar-source",
+		async transform(code, id) {
+			const sidecar = parseSidecarSourceRequest(id);
+			if (!sidecar || sidecar.kind !== "style") return null;
+			const sourceId = normalizeFsResolvedId(sidecar.sourceId, { stripLeadingNullByte: true });
+			try {
+				const diskSource = await fs$1.readFile(sourceId, "utf8");
+				ctx.runtimeState?.css?.transformedSidecarSource.set(sourceId, {
+					code,
+					diskSource
+				});
+			} catch {
+				ctx.runtimeState?.css?.transformedSidecarSource.delete(sourceId);
+			}
+			return null;
+		}
 	}];
 }
 //#endregion
@@ -24892,12 +25301,6 @@ function setRequireImportLiteral(node, nextValue) {
 function normalizeRelativeChunkImport(fileName, importee) {
 	return toPosixPath(path.normalize(path.join(path.dirname(fileName), importee)));
 }
-function prependChunkCodePreservingDirectives(code, injectedCode) {
-	const directiveMatch = code.match(DIRECTIVE_PROLOGUE_RE);
-	if (!directiveMatch?.[0]) return `${injectedCode}\n${code}`;
-	const directivePrologue = directiveMatch[0];
-	return `${directivePrologue}${injectedCode}\n${code.slice(directivePrologue.length)}`;
-}
 //#endregion
 //#region src/utils/weapi.ts
 function getWeapiGlobalRootCandidateItems() {
@@ -25141,14 +25544,14 @@ function composeSourceMaps(transformedMap, originalMap) {
 }
 //#endregion
 //#region src/plugins/core/lifecycle/emit/rewrite/sourcemap.ts
-function applyMagicStringChunkRewrite(chunk, magicString) {
+function applyMagicStringChunkRewrite(chunk, magicString, options) {
 	const previousCode = chunk.code;
 	const nextCode = magicString.toString();
 	if (nextCode === previousCode) return false;
 	const previousMap = normalizeEncodedSourceMapLike(chunk.map);
 	chunk.code = nextCode;
 	if (previousMap) chunk.map = composeSourceMaps(magicString.generateMap({
-		hires: "boundary",
+		hires: options?.hires ?? "boundary",
 		includeContent: true,
 		source: chunk.fileName
 	}), previousMap);
@@ -25337,6 +25740,9 @@ const REQUEST_GLOBAL_APP_MODULE_KEY_PREFIX = "__weappViteRequestGlobalsModule:";
 function resolveChunkRequestGlobalsTargets(code, targets, mode) {
 	return mode === "auto" ? resolveAutoRequestGlobalsTargets(code, targets) : targets;
 }
+function resolvePreludeRequestGlobalsTargets(code, targets, mode) {
+	return mode === "auto" ? targets : resolveChunkRequestGlobalsTargets(code, targets, mode);
+}
 function collectTopLevelDeclaredIdentifiers(code) {
 	const identifiers = /* @__PURE__ */ new Set();
 	try {
@@ -25760,7 +26166,7 @@ function inlineRequestGlobalsAppRegisteredInstallerChunks(bundle, installerChunk
 	appChunk.code = `${inlinedModules.join("\n")}\n${appChunk.code}`;
 }
 function createRequestGlobalsPreludeCode(chunk, installerChunks, targets, mode, networkDefaults) {
-	const chunkTargets = resolveChunkRequestGlobalsTargets(chunk.code, targets, mode);
+	const chunkTargets = resolvePreludeRequestGlobalsTargets(chunk.code, targets, mode);
 	if (chunkTargets.length === 0 || chunk.code.includes(REQUEST_GLOBAL_PRELUDE_MARKER)) return;
 	const bindingTargets = resolveRequestGlobalsBindingTargets(chunkTargets);
 	if (bindingTargets.length === 0) return;
@@ -25788,13 +26194,22 @@ function createRequestGlobalsPreludeCode(chunk, installerChunks, targets, mode,
 	].join("\n");
 }
 function createRequestGlobalsPreludeAssetCode(preludeFileName, chunk, installerChunks, targets, mode, networkDefaults) {
-	const chunkTargets = resolveChunkRequestGlobalsTargets(chunk.code, targets, mode);
+	const chunkTargets = resolvePreludeRequestGlobalsTargets(chunk.code, targets, mode);
 	if (chunkTargets.length === 0) return;
 	const bindingTargets = resolveRequestGlobalsBindingTargets(chunkTargets);
 	if (bindingTargets.length === 0) return;
 	const installerImport = resolveRequestGlobalsInstallerImport(chunk, installerChunks);
-	if (!installerImport?.installerChunkFileName || !installerImport.exportName) return;
-	const installerHostCode = `${toRequestGlobalsInstallerModuleExpression(preludeFileName, installerImport.installerChunkFileName, { appRegisteredModule: false })}[${JSON.stringify(installerImport.exportName)}](${createRequestGlobalsInstallerOptionsCode(chunkTargets, networkDefaults)}) || globalThis`;
+	let installerChunkFileName = installerImport?.installerChunkFileName;
+	let exportName = installerImport?.exportName;
+	if (!installerChunkFileName || !exportName) {
+		const ownExportName = installerChunks.get(toPosixPath(chunk.fileName));
+		if (ownExportName) {
+			installerChunkFileName = chunk.fileName;
+			exportName = ownExportName;
+		}
+	}
+	if (!installerChunkFileName || !exportName) return;
+	const installerHostCode = `${toRequestGlobalsInstallerModuleExpression(preludeFileName, installerChunkFileName, { appRegisteredModule: false })}[${JSON.stringify(exportName)}](${createRequestGlobalsInstallerOptionsCode(chunkTargets, networkDefaults)}) || globalThis`;
 	return [
 		`/* ${REQUEST_GLOBAL_PRELUDE_MARKER} */`,
 		`(() => {`,
@@ -25917,9 +26332,20 @@ function createAppPreludeRequireStatement(chunkFileName, preludeFileName) {
 	const requestPath = relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
 	return `/* ${APP_PRELUDE_REQUIRE_MARKER} */require(${JSON.stringify(requestPath)})`;
 }
+function prependChunkCodeWithSourcemap(chunk, injectedCode) {
+	const directiveMatch = chunk.code.match(DIRECTIVE_PROLOGUE_RE);
+	const insertIndex = directiveMatch?.[0] ? directiveMatch[0].length : 0;
+	const magicString = new MagicString(chunk.code);
+	magicString.prependLeft(insertIndex, `${injectedCode}\n`);
+	applyMagicStringChunkRewrite(chunk, magicString, { hires: true });
+}
+function hasRequestGlobalsPreludeDependency(chunk, requestGlobalsPreludeOptions) {
+	if (!requestGlobalsPreludeOptions.enabled) return false;
+	return requestGlobalsPreludeOptions.installerChunks.has(toPosixPath(chunk.fileName)) || Boolean(resolveRequestGlobalsInstallerImport(chunk, requestGlobalsPreludeOptions.installerChunks)) || chunk.code.includes(REQUEST_GLOBAL_BUNDLE_MARKER$1) || chunk.code.includes(REQUEST_GLOBAL_LOCAL_BINDINGS_MARKER$1) || chunk.code.includes(REQUEST_GLOBAL_PASSIVE_BINDINGS_MARKER$1);
+}
 function emitAppPreludeRequireAssets(bundle, appPreludeCode, state, requestGlobalsPreludeOptions, emitFile) {
 	const preservedRequestGlobalsInstallerChunks = /* @__PURE__ */ new Set();
-	if (!appPreludeCode) return preservedRequestGlobalsInstallerChunks;
+	if (!appPreludeCode && !requestGlobalsPreludeOptions.enabled) return preservedRequestGlobalsInstallerChunks;
 	const preludeFileNames = /* @__PURE__ */ new Set();
 	if (state.subPackageMeta?.subPackage.root) preludeFileNames.add(`${state.subPackageMeta.subPackage.root}/${APP_PRELUDE_REQUIRE_FILE_BASENAME}`);
 	else {
@@ -25931,7 +26357,8 @@ function emitAppPreludeRequireAssets(bundle, appPreludeCode, state, requestGloba
 		const scopeChunks = Object.values(bundle).filter((output) => {
 			return output?.type === "chunk" && resolveAppPreludeRequireFileName(output.fileName, state) === fileName;
 		});
-		const requestGlobalsPreludeCode = requestGlobalsPreludeOptions.enabled ? scopeChunks.map((chunk) => createRequestGlobalsPreludeAssetCode(fileName, chunk, requestGlobalsPreludeOptions.installerChunks, requestGlobalsPreludeOptions.targets, requestGlobalsPreludeOptions.mode, requestGlobalsPreludeOptions.networkDefaults)).find(Boolean) : void 0;
+		const sortedScopeChunks = [...scopeChunks.filter((chunk) => !requestGlobalsPreludeOptions.installerChunks.has(toPosixPath(chunk.fileName))), ...scopeChunks.filter((chunk) => requestGlobalsPreludeOptions.installerChunks.has(toPosixPath(chunk.fileName)))];
+		const requestGlobalsPreludeCode = requestGlobalsPreludeOptions.enabled ? sortedScopeChunks.map((chunk) => createRequestGlobalsPreludeAssetCode(fileName, chunk, requestGlobalsPreludeOptions.installerChunks, requestGlobalsPreludeOptions.targets, requestGlobalsPreludeOptions.mode, requestGlobalsPreludeOptions.networkDefaults)).find(Boolean) : void 0;
 		if (requestGlobalsPreludeCode) {
 			const installerImport = scopeChunks.map((chunk) => resolveRequestGlobalsInstallerImport(chunk, requestGlobalsPreludeOptions.installerChunks)).find(Boolean);
 			if (installerImport?.installerChunkFileName) preservedRequestGlobalsInstallerChunks.add(installerImport.installerChunkFileName);
@@ -25949,16 +26376,18 @@ function injectAppPreludeCode(bundle, appPreludeCode, options, state, requestGlo
 	let preservedRequestGlobalsInstallerChunks = /* @__PURE__ */ new Set();
 	if (!options.enabled) return preservedRequestGlobalsInstallerChunks;
 	const entryChunkFileNames = options.mode === "entry" ? collectAppPreludeEntryChunkFileNames(state) : void 0;
-	if (options.mode === "require" && appPreludeCode) preservedRequestGlobalsInstallerChunks = emitAppPreludeRequireAssets(bundle, appPreludeCode, state, requestGlobalsPreludeOptions, emitFile);
+	if (options.mode === "require" && (appPreludeCode || requestGlobalsPreludeOptions.enabled)) preservedRequestGlobalsInstallerChunks = emitAppPreludeRequireAssets(bundle, appPreludeCode, state, requestGlobalsPreludeOptions, emitFile);
 	for (const output of Object.values(bundle)) {
 		if (output?.type !== "chunk") continue;
 		const chunk = output;
 		if (chunk.code.includes(APP_PRELUDE_CHUNK_MARKER) || chunk.code.includes(APP_PRELUDE_REQUIRE_MARKER)) continue;
 		const isTargetEntryChunk = chunk.isEntry === true || entryChunkFileNames?.has(chunk.fileName) === true;
 		if (entryChunkFileNames && !isTargetEntryChunk) continue;
-		const injectedCode = [requestGlobalsPreludeOptions.enabled && options.mode !== "require" ? createRequestGlobalsPreludeCode(chunk, requestGlobalsPreludeOptions.installerChunks, requestGlobalsPreludeOptions.targets, requestGlobalsPreludeOptions.mode, requestGlobalsPreludeOptions.networkDefaults) : void 0, options.mode === "require" ? appPreludeCode ? createAppPreludeRequireStatement(chunk.fileName, resolveAppPreludeRequireFileName(chunk.fileName, state)) : void 0 : appPreludeCode].filter(Boolean).join("\n");
+		const requestGlobalsPreludeCode = requestGlobalsPreludeOptions.enabled && options.mode !== "require" ? createRequestGlobalsPreludeCode(chunk, requestGlobalsPreludeOptions.installerChunks, requestGlobalsPreludeOptions.targets, requestGlobalsPreludeOptions.mode, requestGlobalsPreludeOptions.networkDefaults) : void 0;
+		const shouldInjectRequirePrelude = appPreludeCode || hasRequestGlobalsPreludeDependency(chunk, requestGlobalsPreludeOptions);
+		const injectedCode = [requestGlobalsPreludeCode, options.mode === "require" ? shouldInjectRequirePrelude ? createAppPreludeRequireStatement(chunk.fileName, resolveAppPreludeRequireFileName(chunk.fileName, state)) : void 0 : appPreludeCode].filter(Boolean).join("\n");
 		if (!injectedCode) continue;
-		chunk.code = prependChunkCodePreservingDirectives(chunk.code, injectedCode);
+		prependChunkCodeWithSourcemap(chunk, injectedCode);
 	}
 	return preservedRequestGlobalsInstallerChunks;
 }
@@ -26372,7 +26801,7 @@ function createGenerateBundleHook(state, isPluginBuild) {
 				collapseRequestGlobalsRuntimeSupportChunk(rolldownBundle);
 			}
 			const appPreludePath = scanService.appEntry?.preludePath;
-			const shouldInjectRequestGlobalsPrelude = injectRequestGlobalsOptions?.prelude === true;
+			const shouldInjectRequestGlobalsPrelude = injectRequestGlobalsOptions?.prelude === true && Boolean(scanService.appEntry || subPackageMeta);
 			const appPreludeOptions = resolveAppPreludeOptions(state);
 			const preservedRequestGlobalsInstallerChunks = appPreludeOptions.enabled && Boolean(appPreludePath) || shouldInjectRequestGlobalsPrelude ? injectAppPreludeCode(rolldownBundle, await resolveAppPreludeCode(appPreludePath, {
 				importMetaDefineRegistry: configService.importMetaDefineRegistry,
@@ -27718,6 +28147,7 @@ function createWatchChangeHook(state) {
 			watchToDirtyMs: performance.now() - startedAt,
 			dirtyReasonSummary
 		};
+		state.ctx.onStatefulHmrSourceChange?.(normalizedId, dirtyReasonSummary ?? []);
 	};
 }
 //#endregion
@@ -31170,15 +31600,17 @@ function hasTsconfigReference(tsconfig, target) {
 		return false;
 	}
 }
-function resolveDefaultRolldownTsconfig(cwd) {
-	const appTsconfig = path.resolve(cwd, ".weapp-vite/tsconfig.app.json");
-	const rootTsconfig = path.resolve(cwd, "tsconfig.json");
+function resolveDefaultRolldownTsconfig(cwd, configFilePath) {
+	const configRoot = configFilePath ? path.dirname(configFilePath) : void 0;
+	const projectRoot = configRoot && existsSync(path.resolve(configRoot, ".weapp-vite/tsconfig.app.json")) ? configRoot : cwd;
+	const appTsconfig = path.resolve(projectRoot, ".weapp-vite/tsconfig.app.json");
+	const rootTsconfig = path.resolve(projectRoot, "tsconfig.json");
 	if (existsSync(appTsconfig)) return appTsconfig;
 	if (hasTsconfigReference(rootTsconfig, appTsconfig)) return appTsconfig;
 	if (existsSync(rootTsconfig)) return rootTsconfig;
 }
 function normalizeInlineConfigAfterDefu(inline, options) {
-	const { cwd, ctx, platform, rolldownOptions, subPackageMeta } = options;
+	const { cwd, configFilePath, ctx, platform, rolldownOptions, subPackageMeta } = options;
 	const build = inline.build ?? (inline.build = {});
 	const userRolldownOptions = build.rolldownOptions;
 	const mergedRolldownOptions = {
@@ -31189,8 +31621,11 @@ function normalizeInlineConfigAfterDefu(inline, options) {
 			...userRolldownOptions?.output ?? {}
 		}
 	};
-	const defaultTsconfig = resolveDefaultRolldownTsconfig(cwd);
-	if (!Object.prototype.hasOwnProperty.call(mergedRolldownOptions, "tsconfig") && !mergedRolldownOptions.resolve?.tsconfigFilename && defaultTsconfig) mergedRolldownOptions.tsconfig = defaultTsconfig;
+	const defaultTsconfig = resolveDefaultRolldownTsconfig(cwd, configFilePath);
+	const resolveOptions = mergedRolldownOptions.resolve;
+	if (defaultTsconfig) {
+		if (!Object.prototype.hasOwnProperty.call(mergedRolldownOptions, "tsconfig")) mergedRolldownOptions.tsconfig = configFilePath && !resolveOptions?.tsconfigFilename ? false : defaultTsconfig;
+	} else if (!Object.prototype.hasOwnProperty.call(mergedRolldownOptions, "tsconfig") && !resolveOptions?.tsconfigFilename) mergedRolldownOptions.tsconfig = false;
 	build.rolldownOptions = mergedRolldownOptions;
 	inline.define = {
 		...inline.define ?? {},
@@ -31220,7 +31655,7 @@ function resolveMiniprogramWatchInclude(options) {
 	});
 }
 function mergeMiniprogram(options, ...configs) {
-	const { ctx, subPackageMeta, config, cwd, srcRoot, mpDistRoot, configFileDependencies = [], packageJson, isDev, applyRuntimePlatform, injectBuiltinAliases, getDefineImportMetaEnv, setOptions, oxcRolldownPlugin } = options;
+	const { ctx, subPackageMeta, config, cwd, srcRoot, mpDistRoot, configFileDependencies = [], configFilePath, packageJson, isDev, applyRuntimePlatform, injectBuiltinAliases, getDefineImportMetaEnv, setOptions, oxcRolldownPlugin } = options;
 	const platform = ctx.configService?.platform;
 	applyRuntimePlatform("miniprogram");
 	const createMiniprogramCustomLogger = () => {
@@ -31289,6 +31724,7 @@ function mergeMiniprogram(options, ...configs) {
 		});
 		normalizeInlineConfigAfterDefu(inline, {
 			cwd,
+			configFilePath,
 			ctx,
 			platform,
 			rolldownOptions,
@@ -31311,6 +31747,7 @@ function mergeMiniprogram(options, ...configs) {
 	if (inlineConfig.build) delete inlineConfig.build.watch;
 	normalizeInlineConfigAfterDefu(inlineConfig, {
 		cwd,
+		configFilePath,
 		ctx,
 		platform,
 		rolldownOptions,
@@ -31466,6 +31903,7 @@ function createMergeFactories(options) {
 			srcRoot: currentOptions.srcRoot,
 			mpDistRoot: currentOptions.mpDistRoot,
 			configFileDependencies: currentOptions.configFileDependencies,
+			configFilePath: currentOptions.configFilePath,
 			packageJson: currentOptions.packageJson,
 			isDev: currentOptions.isDev,
 			applyRuntimePlatform,
@@ -31675,6 +32113,7 @@ function createConfigService(ctx) {
 			isDev: false,
 			emitDefaultAutoImportOutputs: true,
 			projectConfig: {},
+			projectPrivateConfig: {},
 			config: {},
 			loadOptions: input,
 			packageJson: {},
@@ -31786,6 +32225,9 @@ function createConfigService(ctx) {
 		get projectConfig() {
 			return options.projectConfig;
 		},
+		get projectPrivateConfig() {
+			return options.projectPrivateConfig;
+		},
 		get projectConfigPath() {
 			return options.projectConfigPath;
 		},
@@ -32095,7 +32537,7 @@ async function loadAppEntry(ctx, scanState) {
 	const { path: appEntryPath } = appEntry;
 	let configFromVue;
 	if (!appConfigFile && vueAppPath) {
-		const { extractConfigFromVue } = await import("./file-TBExd8Jd.mjs");
+		const { extractConfigFromVue } = await import("./file-BTZg_nyD.mjs");
 		configFromVue = await extractConfigFromVue(vueAppPath);
 		if (configFromVue) appConfigFile = vueAppPath;
 	}