weapp-vite 7.1.4 → 7.2.1

package/dist/{createContext-CsYIo9DO.mjs → createContext-403iJEyy.mjs}

@@ -1,10 +1,10 @@
 import { n as applyWeappViteHostMeta } from "./pluginHost--CaeyWpA.mjs";
-import { E as MINI_PROGRAM_PLATFORM_ADAPTERS, _ as templateExtensions, a as findJsonEntry, b as isNativeTemplateSource, c as isJsOrTs, d as touch, g as supportedCssLangs, h as scriptExtensions, i as findJsEntry, l as isTemplate, m as jsExtensions, n as changeFileExtension, o as findTemplateEntry, p as configExtensions, r as findCssEntry, s as findVueEntry, t as extractConfigFromVue, v as vueExtensions, w as inlineAutoRoutesImports, x as isSourceStyleExtension, y as ALL_NATIVE_STYLE_RESOLVER_EXTENSIONS } from "./file-CHisoC18.mjs";
+import { E as MINI_PROGRAM_PLATFORM_ADAPTERS, _ as templateExtensions, a as findJsonEntry, b as isNativeTemplateSource, c as isJsOrTs, d as touch, g as supportedCssLangs, h as scriptExtensions, i as findJsEntry, l as isTemplate, m as jsExtensions, n as changeFileExtension, o as findTemplateEntry, p as configExtensions, r as findCssEntry, s as findVueEntry, t as extractConfigFromVue, v as vueExtensions, w as inlineAutoRoutesImports, x as isSourceStyleExtension, y as ALL_NATIVE_STYLE_RESOLVER_EXTENSIONS } from "./file-CfgcKGLR.mjs";
 import { n as configureLogger, r as logger_default } from "./logger-mt4mSTqV.mjs";
 import { createRequire, isBuiltin } from "node:module";
 import { createDebug } from "obug";
 import fs, { existsSync, readFileSync, realpathSync, statSync } 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_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_I18N_JS_FILE, WEAPP_I18N_LOCALE_DATA_KEY, WEAPP_I18N_PUBLIC_MODULE_ID, WEAPP_I18N_RUNTIME_MARKER, WEAPP_I18N_VIRTUAL_MODULE_ID, WEAPP_I18N_WXS_FILE, WEAPP_REACT_EVENT_METHOD_NAME, 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_GLOBAL_STYLE_BASENAME, WEAPP_VITE_STATEFUL_HMR_PRELOAD_FILE, WEAPP_VITE_STATEFUL_HMR_UPDATE_FILE, WEVU_APP_SHELL_COMPONENT_BASE, WEVU_APP_SHELL_TAG_NAME, 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_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_I18N_JS_FILE, WEAPP_I18N_LOCALE_DATA_KEY, WEAPP_I18N_PUBLIC_MODULE_ID, WEAPP_I18N_RUNTIME_MARKER, WEAPP_I18N_VIRTUAL_MODULE_ID, WEAPP_I18N_WXS_FILE, WEAPP_REACT_EVENT_METHOD_NAME, 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_GLOBAL_STYLE_BASENAME, WEAPP_VITE_STATEFUL_HMR_PRELOAD_FILE, WEAPP_VITE_STATEFUL_HMR_UPDATE_FILE, WEVU_APP_SHELL_COMPONENT_BASE, WEVU_APP_SHELL_TAG_NAME, WEVU_AUTO_ROUTES_MODULE_ID, WEVU_AUTO_ROUTES_MODULE_ID as WEVU_AUTO_ROUTES_MODULE_ID$1, WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID, WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID as WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID$1, WEVU_AUTO_ROUTES_VIRTUAL_MODULE_ID, WEVU_AUTO_ROUTES_VIRTUAL_MODULE_ID as WEVU_AUTO_ROUTES_VIRTUAL_MODULE_ID$1, WEVU_DEFINE_PAGE_META_MACRO, 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_ROUTER_MODULE_ID, 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, pathToFileURL } from "node:url";
 import path$1, { normalize, posix as posix$1, relative, win32 } from "node:path";
@@ -18,15 +18,16 @@ import { collectOnPageScrollPerformanceWarnings } from "@weapp-vite/ast/operatio
 import { BABEL_TS_MODULE_PARSER_OPTIONS as BABEL_TS_MODULE_PARSER_OPTIONS$1, generate as generate$1, parse as parse$3, parseJsLike, traverse } from "@weapp-vite/ast/babel";
 import * as t from "@weapp-vite/ast/babelTypes";
 import picomatch from "picomatch";
-import { VUE_COMPONENT_TAG_RE, classifyVueSfcBlockChanges, collectVueTemplateTags, compileJsxFile, compileVueFile, compileVueStyleToWxss, createJsonMerger, createPageEntryMatcher, createPageEntryMatcher as createPageEntryMatcher$1, generateScopedId, getClassStyleWxsSource, getMiniProgramTemplatePlatform, getSfcCheckMtime, injectWevuPageFeaturesInJsWithResolver, invalidateFileCache, isAutoImportCandidateTag, isBuiltinComponent, isUniAppCompatibilityFile, pathExists, readAndParseSfc, readFile as readFile$1, refreshVueFileJsonConfig, resolveClassStyleWxsLocation, resolveVueSfcHmrSignatures, resolveVueSfcStyleIndependentSignature, transformNestedWxssVars, transformUniAppSource, transformVueDeepSelectors } from "wevu/compiler";
+import { VUE_COMPONENT_TAG_RE, classifyVueSfcBlockChanges, collectPageMetaCallsFromPrograms, collectVueTemplateTags, compileJsxFile, compileVueFile, compileVueStyleToWxss, createJsonMerger, createPageEntryMatcher, createPageEntryMatcher as createPageEntryMatcher$1, extractPageDeclarationWithDependencies, generateScopedId, getClassStyleWxsSource, getMiniProgramTemplatePlatform, getSfcCheckMtime, injectWevuPageFeaturesInJsWithResolver, invalidateFileCache, isAutoImportCandidateTag, isBuiltinComponent, isUniAppCompatibilityFile, mayContainPageDeclaration, mayContainPageMeta, pathExists, readAndParseSfc, readAndParseSfc as readAndParseSfc$1, readFile as readFile$1, refreshVueFileJsonConfig, resolveClassStyleWxsLocation, resolveVueSfcHmrSignatures, resolveVueSfcStyleIndependentSignature, stripPageDeclaration, transformNestedWxssVars, transformUniAppSource, transformVueDeepSelectors } from "wevu/compiler";
 import fs$2, { appendFile, copyFile, mkdir, readFile, readdir, rm } from "node:fs/promises";
-import { build, createLogger, createServer, loadConfigFromFile, preprocessCSS, transformWithOxc } from "vite";
+import { BuildEnvironment, build, createIdResolver, createLogger, createServer, loadConfigFromFile, preprocessCSS, resolveConfig, transformWithOxc } from "vite";
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import semverGte from "semver/functions/gte.js";
 import semverSatisfies from "semver/functions/satisfies.js";
 import semverValid from "semver/functions/valid.js";
 import { LRUCache } from "lru-cache";
 import { fdir } from "fdir";
+import { isDeepStrictEqual } from "node:util";
 import chokidar from "chokidar";
 import { getPackageInfo, getPackageInfoSync, resolveModule } from "local-pkg";
 import { build as build$1 } from "rolldown";
@@ -50,6 +51,7 @@ import tsconfigPaths from "vite-tsconfig-paths";
 import { wrapPlugin } from "vite-plugin-performance";
 import { performance as performance$1 } from "node:perf_hooks";
 import { compileI18nCatalog, generateI18nCatalogModuleSource, generateI18nRuntimeSource, generateI18nWxsSource } from "@weapp-vite/i18n/compiler";
+import selectorParser from "postcss-selector-parser";
 import { weappWebPlugin } from "@weapp-vite/web";
 import { bundleRequire } from "rolldown-require";
 //#region src/debugger.ts
@@ -355,8 +357,9 @@ function createModuleGraphService() {
 		const queue = [id];
 		const visited = /* @__PURE__ */ new Set();
 		for (let index = 0; index < queue.length; index += 1) {
-			const request = queue[index];
-			if (visited.has(request)) continue;
+			const target = queue[index];
+			const request = typeof target === "string" ? target : target.url ?? target.id;
+			if (!request || visited.has(request)) continue;
 			visited.add(request);
 			try {
 				await devServer.transformRequest(request);
@@ -364,10 +367,10 @@ function createModuleGraphService() {
 				debug$3?.(`dev graph 预热跳过无法展开的 external 终点 ${request}: ${String(error)}`);
 				continue;
 			}
-			const module = devServer.moduleGraph.getModuleById(request);
+			const module = typeof target === "string" ? devServer.moduleGraph.getModuleById(request) : target;
 			for (const dependency of module?.importedModules ?? []) {
 				const dependencyRequest = dependency.url ?? dependency.id;
-				if (dependencyRequest && !visited.has(dependencyRequest)) queue.push(dependencyRequest);
+				if (dependencyRequest && !visited.has(dependencyRequest)) queue.push(dependency);
 			}
 		}
 	};
@@ -8990,17 +8993,46 @@ function formatSubPackagesTuple(subPackages, baseIndent = "") {
 	lines.push(`${baseIndent}]`);
 	return lines.join("\n");
 }
-function createTypedRouterDefinition(routes) {
+function formatStaticRouteType(value, baseIndent) {
+	if (value === null) return "null";
+	if (typeof value === "string") return "string";
+	if (typeof value === "number") return "number";
+	if (typeof value === "boolean") return "boolean";
+	if (Array.isArray(value)) {
+		if (value.length === 0) return "unknown[]";
+		return `Array<${[...new Set(value.map((item) => formatStaticRouteType(item, baseIndent)))].join(" | ")}>`;
+	}
+	const entries = Object.entries(value);
+	if (entries.length === 0) return "{}";
+	const propertyIndent = `${baseIndent}${INDENT}`;
+	return `{\n${entries.map(([key, propertyValue]) => {
+		return `${propertyIndent}${JSON.stringify(key)}: ${formatStaticRouteType(propertyValue, propertyIndent)};`;
+	}).join("\n")}\n${baseIndent}}`;
+}
+function formatNamedRouteMapEntries(routes) {
+	const routeIndent = `${INDENT}${INDENT}`;
+	const fieldIndent = `${routeIndent}${INDENT}`;
+	return routes.map((route) => {
+		return [
+			`${routeIndent}${JSON.stringify(route.name)}: {`,
+			`${fieldIndent}path: ${JSON.stringify(route.path)};`,
+			`${fieldIndent}meta: ${formatStaticRouteType(route.meta, fieldIndent)};`,
+			`${routeIndent}};`
+		].join("\n");
+	});
+}
+function createTypedRouterDefinition(routes, namedRoutes = []) {
 	const pagesType = formatTuple(routes.pages, INDENT);
 	const entriesType = formatTuple(routes.entries, INDENT);
 	const subPackagesType = formatSubPackagesTuple(routes.subPackages, INDENT);
+	const namedRouteMapEntries = formatNamedRouteMapEntries(namedRoutes);
 	return [
 		"/* eslint-disable */",
 		"// biome-ignore lint: disable",
 		"// oxlint-disable",
 		"// ------",
 		"// 由 weapp-vite 自动生成，请勿编辑。",
-		"import 'wevu/router';",
+		`import '${WEVU_ROUTER_MODULE_ID}';`,
 		"",
 		"declare module 'weapp-vite/auto-routes' {",
 		`    export type AutoRoutesPages = ${pagesType};`,
@@ -9036,10 +9068,13 @@ function createTypedRouterDefinition(routes) {
 		"    export default routes;",
 		"}",
 		"",
-		"declare module 'wevu/router' {",
+		`declare module '${WEVU_ROUTER_MODULE_ID}' {`,
 		"    interface WevuTypedRouterRouteMap {",
 		"        entries: import('weapp-vite/auto-routes').AutoRoutesEntries[number];",
 		"    }",
+		"    interface WevuNamedRouteMap {",
+		...namedRouteMapEntries,
+		"    }",
 		"}",
 		""
 	].join("\n");
@@ -9225,6 +9260,34 @@ function applyBuildScopeToAutoRoutes(routes, scope) {
 	};
 }
 //#endregion
+//#region src/runtime/config/internal/alias.ts
+function normalizeAliasOptions(alias) {
+	if (!alias) return [];
+	if (Array.isArray(alias)) return alias.filter((entry) => {
+		return Boolean(entry && typeof entry === "object" && "find" in entry && "replacement" in entry);
+	});
+	return Object.entries(alias).map(([find, replacement]) => {
+		return {
+			find,
+			replacement
+		};
+	});
+}
+function createAliasManager(oxcAlias, defaultBuiltinAliases) {
+	function injectBuiltinAliases(config, builtinAliases = defaultBuiltinAliases) {
+		const resolve = config.resolve ?? (config.resolve = {});
+		const aliasArray = normalizeAliasOptions(resolve.alias);
+		if (!aliasArray.some((entry) => {
+			return entry.find instanceof RegExp && entry.find.source === oxcAlias.find.source;
+		})) aliasArray.unshift(oxcAlias);
+		for (const builtin of builtinAliases) if (!aliasArray.some((entry) => {
+			return typeof entry.find === "string" && entry.find === builtin.find;
+		})) aliasArray.unshift(builtin);
+		resolve.alias = aliasArray;
+	}
+	return { injectBuiltinAliases };
+}
+//#endregion
 //#region src/utils/miniProgramGlobals.ts
 function getMiniProgramGlobalKeys() {
 	return [...getMiniProgramRuntimeGlobalKeysByResolvePriority()];
@@ -9261,6 +9324,13 @@ function updateWatchTargets(target, next) {
 	target.clear();
 	for (const item of next) target.add(item);
 }
+function updatePageDeclarationDependencies(target, next) {
+	target.clear();
+	for (const [dependency, owners] of next) target.set(dependency, new Set(owners));
+}
+function createAutoRoutesSourceFingerprint(source) {
+	return createHash("sha256").update(source).digest("hex");
+}
 function createEmptyAutoRoutesSnapshot() {
 	return {
 		pages: [],
@@ -9305,21 +9375,39 @@ function createAutoRoutesModuleCode(serialized) {
 		...createAutoRoutesRuntimeLines()
 	].join("\n");
 }
-function createAutoRoutesArtifacts(snapshot) {
+function createNamedAutoRoutesModuleCode(serialized) {
+	return `export const routes = JSON.parse(${JSON.stringify(serialized)});\n`;
+}
+function createAutoRoutesArtifacts(snapshot, namedRoutes = []) {
 	const serialized = JSON.stringify(snapshot, null, 2);
+	const namedRoutesSerialized = JSON.stringify(namedRoutes, null, 2);
 	return {
 		serialized,
 		moduleCode: createAutoRoutesModuleCode(serialized),
-		typedDefinition: createTypedRouterDefinition(snapshot)
+		namedModuleCode: createNamedAutoRoutesModuleCode(namedRoutesSerialized),
+		signature: JSON.stringify({
+			routes: snapshot,
+			namedRoutes
+		}),
+		typedDefinition: createTypedRouterDefinition(snapshot, namedRoutes)
 	};
 }
 function resetAutoRoutesState(state) {
 	const emptySnapshot = createEmptyAutoRoutesSnapshot();
 	const artifacts = createAutoRoutesArtifacts(emptySnapshot);
 	updateRoutesReference(state.routes, emptySnapshot);
+	state.namedRoutes = [];
 	state.serialized = artifacts.serialized;
 	state.typedDefinition = artifacts.typedDefinition;
 	state.moduleCode = artifacts.moduleCode;
+	state.namedModuleCode = artifacts.namedModuleCode;
+	state.signature = artifacts.signature;
+	state.topologyKey = "";
+	state.pageDeclarationDependencies.clear();
+	state.pageDeclarationFingerprints.clear();
+	state.usesOpaquePageDeclarationResolver = false;
+	updateWatchTargets(state.pageSourceFiles, /* @__PURE__ */ new Set());
+	updateWatchTargets(state.namedRouteSourceFiles, /* @__PURE__ */ new Set());
 	updateWatchTargets(state.watchFiles, /* @__PURE__ */ new Set());
 	updateWatchTargets(state.watchDirs, /* @__PURE__ */ new Set());
 	state.dirty = false;
@@ -9335,24 +9423,38 @@ function resolvePersistentCacheBaseDir(configService) {
 	return (typeof configService.configFilePath === "string" ? path.dirname(configService.configFilePath) : configService.cwd) || void 0;
 }
 function applyPersistentCache(state, cache) {
-	const watchFiles = Array.isArray(cache.watchFiles) ? cache.watchFiles : [];
+	const artifacts = createAutoRoutesArtifacts(cache.snapshot, cache.namedRoutes);
 	updateRoutesReference(state.routes, cache.snapshot);
-	state.serialized = cache.serialized;
-	state.moduleCode = cache.moduleCode;
-	state.typedDefinition = cache.typedDefinition;
-	updateWatchTargets(state.watchFiles, new Set(watchFiles));
-	updateWatchTargets(state.watchDirs, new Set(Array.isArray(cache.watchDirs) ? cache.watchDirs : []));
+	state.namedRoutes = cache.namedRoutes;
+	state.serialized = artifacts.serialized;
+	state.moduleCode = artifacts.moduleCode;
+	state.namedModuleCode = artifacts.namedModuleCode;
+	state.signature = `${artifacts.signature}\n${cache.topologyKey}`;
+	state.typedDefinition = artifacts.typedDefinition;
+	state.topologyKey = cache.topologyKey;
+	updatePageDeclarationDependencies(state.pageDeclarationDependencies, new Map(Object.entries(cache.pageDeclarationDependencies).map(([dependency, owners]) => [dependency, new Set(owners)])));
+	state.pageDeclarationFingerprints.clear();
+	for (const [sourceFile, fingerprint] of Object.entries(cache.pageDeclarationFingerprints)) state.pageDeclarationFingerprints.set(sourceFile, fingerprint);
+	state.usesOpaquePageDeclarationResolver = cache.usesOpaquePageDeclarationResolver;
+	updateWatchTargets(state.pageSourceFiles, new Set(cache.pageSourceFiles));
+	updateWatchTargets(state.namedRouteSourceFiles, new Set(cache.namedRouteSourceFiles));
+	updateWatchTargets(state.watchFiles, new Set(cache.watchFiles));
+	updateWatchTargets(state.watchDirs, new Set(cache.watchDirs));
 	state.dirty = false;
 	state.initialized = true;
-	state.needsFullRescan = true;
+	state.needsFullRescan = false;
 }
 function createPersistentCachePayload(state, fileMtims) {
 	return {
-		version: 1,
+		version: 6,
 		snapshot: cloneRoutes(state.routes),
-		serialized: state.serialized,
-		moduleCode: state.moduleCode,
-		typedDefinition: state.typedDefinition,
+		namedRoutes: state.namedRoutes,
+		topologyKey: state.topologyKey,
+		pageDeclarationDependencies: Object.fromEntries([...state.pageDeclarationDependencies].map(([dependency, owners]) => [dependency, [...owners]])),
+		pageDeclarationFingerprints: Object.fromEntries(state.pageDeclarationFingerprints),
+		usesOpaquePageDeclarationResolver: state.usesOpaquePageDeclarationResolver,
+		pageSourceFiles: [...state.pageSourceFiles],
+		namedRouteSourceFiles: [...state.namedRouteSourceFiles],
 		watchFiles: [...state.watchFiles],
 		watchDirs: [...state.watchDirs],
 		fileMtims
@@ -9460,6 +9562,7 @@ function isAutoRoutesCandidateUnchanged(previous, candidate) {
 }
 //#endregion
 //#region src/runtime/autoRoutesPlugin/routes/scan.ts
+const PAGE_SOURCE_EXTENSIONS = [...scriptExtensions, ...vueExtensions];
 function sortAutoRoutesEntries(values) {
 	values.sort((a, b) => {
 		if (a === "pages/index/index") return -1;
@@ -9488,7 +9591,136 @@ function shouldIncludeScanCandidate(candidate, json, route) {
 	}
 	return candidate.hasScript || candidate.hasTemplate || Boolean(candidate.jsonPath);
 }
-async function scanRoutes(ctx, candidatesMap) {
+function resolvePageDeclarationAliases(ctx) {
+	const configService = ctx.configService;
+	if (!configService) return [];
+	return [...normalizeAliasOptions(configService.inlineConfig?.resolve?.alias), ...configService.aliasEntries ?? []];
+}
+function resolveCandidatePageSources(ctx, candidate) {
+	const sourceFiles = PAGE_SOURCE_EXTENSIONS.map((extension) => `${candidate.base}.${extension}`).filter((sourceFile) => candidate.files.has(sourceFile));
+	const nativeSource = sourceFiles[0];
+	if (!nativeSource) return [];
+	if (ctx.configService?.weappWebConfig?.enabled !== true) return [nativeSource];
+	return [nativeSource, ...sourceFiles.filter((sourceFile) => sourceFile !== nativeSource)];
+}
+async function collectNamedRoutes(ctx, candidates, scopedEntries, options) {
+	const pageDeclarationAliases = resolvePageDeclarationAliases(ctx);
+	const configService = ctx.configService;
+	const scopedCandidates = candidates.filter((candidate) => scopedEntries.has(candidate.entry)).sort((a, b) => a.entry.localeCompare(b.entry));
+	const sourceCache = /* @__PURE__ */ new Map();
+	const readSource = (sourceFile) => {
+		let pending = sourceCache.get(sourceFile);
+		if (!pending) {
+			pending = fs$1.readFile(sourceFile, "utf8");
+			sourceCache.set(sourceFile, pending);
+		}
+		return pending;
+	};
+	const resolveSource = async (source, importer) => {
+		const resolved = await options.resolvePageDeclarationSource?.(source, importer);
+		if (resolved) return resolved;
+		if (!importer) return;
+		const aliased = resolveImportee$1(source, importer, pageDeclarationAliases);
+		return aliased === source ? void 0 : aliased;
+	};
+	const declarations = await Promise.all(scopedCandidates.map(async ({ candidate, entry }) => {
+		const sourceFiles = resolveCandidatePageSources(ctx, candidate);
+		const sources = await Promise.all(sourceFiles.map(async (sourceFile) => {
+			const source = await readSource(sourceFile);
+			return {
+				...await extractPageDeclarationWithDependencies(source, sourceFile, {
+					readFile: readSource,
+					resolveId: resolveSource
+				}),
+				sourceFile
+			};
+		}));
+		const primary = sources[0];
+		for (const alternate of sources.slice(1)) if (!isDeepStrictEqual(primary?.declaration, alternate.declaration)) {
+			const first = toPosixPath(path.relative(configService.cwd, primary.sourceFile));
+			const second = toPosixPath(path.relative(configService.cwd, alternate.sourceFile));
+			throw new Error(`[auto-routes] 页面 ${entry} 的候选源文件页面声明不一致：${first} 与 ${second}`);
+		}
+		return {
+			entry,
+			primary,
+			sources
+		};
+	}));
+	const namedRoutes = [];
+	const pageSourceFiles = /* @__PURE__ */ new Set();
+	const namedRouteSourceFiles = /* @__PURE__ */ new Set();
+	const pageDeclarationDependencies = /* @__PURE__ */ new Map();
+	const sourceByName = /* @__PURE__ */ new Map();
+	for (const { entry, primary, sources } of declarations) {
+		for (const source of sources) {
+			pageSourceFiles.add(source.sourceFile);
+			for (const dependency of source.dependencies) {
+				let owners = pageDeclarationDependencies.get(dependency);
+				if (!owners) {
+					owners = /* @__PURE__ */ new Set();
+					pageDeclarationDependencies.set(dependency, owners);
+				}
+				owners.add(source.sourceFile);
+			}
+		}
+		const declaration = primary?.declaration;
+		if (!declaration || !primary) continue;
+		const routeSourceFile = primary.declarationSourceFile ?? primary.sourceFile;
+		const duplicateSource = sourceByName.get(declaration.name);
+		if (duplicateSource) {
+			const first = toPosixPath(path.relative(configService.cwd, duplicateSource));
+			const second = toPosixPath(path.relative(configService.cwd, routeSourceFile));
+			throw new Error(`[auto-routes] 页面路由名称 ${JSON.stringify(declaration.name)} 重复：${first} 与 ${second}`);
+		}
+		sourceByName.set(declaration.name, routeSourceFile);
+		for (const source of sources) namedRouteSourceFiles.add(source.sourceFile);
+		namedRoutes.push({
+			name: declaration.name,
+			path: `/${entry}`,
+			meta: declaration.meta ?? {}
+		});
+	}
+	const pageDeclarationFingerprints = /* @__PURE__ */ new Map();
+	await Promise.all([...sourceCache].map(async ([sourceFile, pendingSource]) => {
+		pageDeclarationFingerprints.set(sourceFile, createAutoRoutesSourceFingerprint(await pendingSource));
+	}));
+	return {
+		namedRoutes,
+		namedRouteSourceFiles,
+		pageDeclarationDependencies,
+		pageDeclarationFingerprints,
+		pageSourceFiles
+	};
+}
+function createAutoRoutesTopologyKey(ctx, candidatesMap) {
+	const configService = ctx.configService;
+	if (!configService) return "";
+	const candidates = [...candidatesMap.values()].map((candidate) => ({
+		base: toPosixPath(path.relative(configService.absoluteSrcRoot, candidate.base)),
+		files: [...candidate.files].map((filePath) => toPosixPath(path.relative(configService.absoluteSrcRoot, filePath))).sort((a, b) => a.localeCompare(b))
+	})).sort((a, b) => a.base.localeCompare(b.base));
+	const { subPackageRoots } = resolveAutoRoutesMatcherContext(ctx);
+	const pageDeclarationAliases = resolvePageDeclarationAliases(ctx).map((alias) => ({
+		find: typeof alias.find === "string" ? {
+			kind: "string",
+			value: alias.find
+		} : {
+			flags: alias.find.flags,
+			kind: "regexp",
+			value: alias.find.source
+		},
+		replacement: alias.replacement
+	}));
+	return JSON.stringify({
+		buildScope: resolveBuildScope(configService.weappViteConfig.buildScope),
+		webSiblingValidation: configService.weappWebConfig?.enabled === true,
+		pageDeclarationAliases,
+		candidates,
+		subPackageRoots: [...subPackageRoots].sort((a, b) => a.localeCompare(b))
+	});
+}
+async function scanRoutes(ctx, candidatesMap, options = {}) {
 	const configService = ctx.configService;
 	const jsonService = ctx.jsonService;
 	if (!configService || !jsonService) throw new Error("扫描路由前必须初始化 configService/jsonService。");
@@ -9499,7 +9731,12 @@ async function scanRoutes(ctx, candidatesMap) {
 	const subPackages = /* @__PURE__ */ new Map();
 	const watchFiles = /* @__PURE__ */ new Set();
 	const watchDirs = /* @__PURE__ */ new Set();
-	const candidateList = [...candidatesMap.values()];
+	const includedCandidates = [];
+	const candidatesSnapshot = new Map([...candidatesMap].map(([base, candidate]) => [base, {
+		...candidate,
+		files: new Set(candidate.files)
+	}]));
+	const candidateList = [...candidatesSnapshot.values()];
 	const jsonEntries = await Promise.all(candidateList.map(async (candidate) => {
 		if (!candidate.jsonPath) return {
 			candidate,
@@ -9523,6 +9760,10 @@ async function scanRoutes(ctx, candidatesMap) {
 		entriesSet.add(route.entry);
 		if (route.root) ensureSubPackage(subPackages, route.root).add(route.pagePath);
 		else pagesSet.add(route.pagePath);
+		includedCandidates.push({
+			candidate,
+			entry: route.entry
+		});
 	}
 	for (const dir of matcher.getWatchRoots(absoluteSrcRoot)) watchDirs.add(dir);
 	const pages = [...pagesSet];
@@ -9543,12 +9784,27 @@ async function scanRoutes(ctx, candidatesMap) {
 		entries,
 		subPackages: subPackageList
 	}, resolveBuildScope(configService.weappViteConfig.buildScope));
-	const { serialized, moduleCode, typedDefinition } = createAutoRoutesArtifacts(snapshot);
+	const { namedRoutes, namedRouteSourceFiles, pageDeclarationDependencies, pageDeclarationFingerprints, pageSourceFiles } = await collectNamedRoutes(ctx, includedCandidates, new Set(snapshot.entries), options);
+	for (const dependency of pageDeclarationDependencies.keys()) {
+		watchFiles.add(dependency);
+		watchDirs.add(path.dirname(dependency));
+	}
+	const { serialized, moduleCode, namedModuleCode, signature: routeSignature, typedDefinition } = createAutoRoutesArtifacts(snapshot, namedRoutes);
+	const topologyKey = createAutoRoutesTopologyKey(ctx, candidatesSnapshot);
 	return {
 		snapshot,
+		namedRoutes,
 		serialized,
 		moduleCode,
+		namedModuleCode,
+		signature: `${routeSignature}\n${topologyKey}`,
 		typedDefinition,
+		topologyKey,
+		namedRouteSourceFiles,
+		pageDeclarationDependencies,
+		pageDeclarationFingerprints,
+		usesOpaquePageDeclarationResolver: Boolean(options.resolvePageDeclarationSource && pageDeclarationDependencies.size > 0),
+		pageSourceFiles,
 		watchFiles,
 		watchDirs
 	};
@@ -9591,6 +9847,24 @@ function cloneRoutes(routes) {
 function getResolvedConfig(ctx) {
 	return resolveWeappAutoRoutesConfig(ctx.configService?.weappViteConfig?.autoRoutes);
 }
+function isStringArray(value) {
+	return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function isStringArrayRecord(value) {
+	return isObject(value) && !Array.isArray(value) && Object.values(value).every(isStringArray);
+}
+function isStringRecord(value) {
+	return isObject(value) && !Array.isArray(value) && Object.values(value).every((item) => typeof item === "string");
+}
+function isPersistentCache(value, topologyKey) {
+	if (!isObject(value) || Array.isArray(value) || !isObject(value.snapshot) || Array.isArray(value.snapshot) || !isObject(value.fileMtims) || Array.isArray(value.fileMtims) || !isStringArrayRecord(value.pageDeclarationDependencies) || !isStringRecord(value.pageDeclarationFingerprints)) return false;
+	const subPackages = value.snapshot.subPackages;
+	const namedRoutes = value.namedRoutes;
+	const pageSourceFiles = value.pageSourceFiles;
+	const dependencyEntries = Object.entries(value.pageDeclarationDependencies);
+	const fingerprints = value.pageDeclarationFingerprints;
+	return value.version === 6 && value.topologyKey === topologyKey && typeof value.usesOpaquePageDeclarationResolver === "boolean" && isStringArray(value.snapshot.pages) && isStringArray(value.snapshot.entries) && Array.isArray(subPackages) && subPackages.every((pkg) => isObject(pkg) && !Array.isArray(pkg) && typeof pkg.root === "string" && isStringArray(pkg.pages)) && Array.isArray(namedRoutes) && namedRoutes.every((route) => isObject(route) && !Array.isArray(route) && typeof route.name === "string" && typeof route.path === "string" && isObject(route.meta) && !Array.isArray(route.meta)) && isStringArray(pageSourceFiles) && isStringArray(value.namedRouteSourceFiles) && isStringArray(value.watchFiles) && isStringArray(value.watchDirs) && dependencyEntries.every(([, owners]) => isStringArray(owners)) && Object.values(fingerprints).every((fingerprint) => typeof fingerprint === "string") && pageSourceFiles.every((sourceFile) => Object.hasOwn(fingerprints, sourceFile)) && dependencyEntries.every(([dependency, owners]) => Object.hasOwn(fingerprints, dependency) && owners.every((owner) => pageSourceFiles.includes(owner))) && Object.values(value.fileMtims).every((mtime) => typeof mtime === "number" && Number.isFinite(mtime));
+}
 function resolvePersistentCachePath(ctx) {
 	const autoRoutesConfig = getResolvedConfig(ctx);
 	if (!autoRoutesConfig.persistentCache) return;
@@ -9629,22 +9903,26 @@ async function collectWatchFileMtims(watchFiles) {
 	}));
 	return Object.fromEntries(entries);
 }
-async function restorePersistentCache(ctx, state) {
+async function restorePersistentCache(ctx, state, topologyKey, isCurrent = () => true, hasOpaquePageDeclarationSourceResolver = false) {
 	if (!getResolvedConfig(ctx).persistentCache) return false;
 	const cachePath = resolvePersistentCachePath(ctx);
 	if (!cachePath || !await fs$1.pathExists(cachePath)) return false;
 	try {
-		const cache = await fs$1.readJson(cachePath);
-		if (cache?.version !== 1) return false;
-		const watchFiles = Array.isArray(cache.watchFiles) ? cache.watchFiles : [];
+		const cached = await fs$1.readJson(cachePath);
+		if (!isPersistentCache(cached, topologyKey)) return false;
+		const cache = cached;
+		if (Object.keys(cache.pageDeclarationDependencies).length > 0 && (cache.usesOpaquePageDeclarationResolver || hasOpaquePageDeclarationSourceResolver)) return false;
+		const watchFiles = cache.watchFiles;
 		if (watchFiles.length === 0) return false;
 		const cachedMtims = cache.fileMtims;
-		if (!cachedMtims) return false;
 		const fileMtims = await collectWatchFileMtims(watchFiles);
 		for (const filePath of watchFiles) {
 			const expectedMtime = cachedMtims[filePath];
 			if (typeof expectedMtime !== "number" || !Number.isFinite(expectedMtime) || fileMtims[filePath] !== expectedMtime) return false;
 		}
+		if ((await Promise.all(Object.entries(cache.pageDeclarationFingerprints).map(async ([sourceFile, expectedFingerprint]) => {
+			return [expectedFingerprint, createAutoRoutesSourceFingerprint(await fs$1.readFile(sourceFile, "utf8"))];
+		}))).some(([expected, current]) => expected !== current) || !isCurrent()) return false;
 		applyPersistentCache(state, cache);
 		return true;
 	} catch {
@@ -9654,14 +9932,13 @@ async function restorePersistentCache(ctx, state) {
 async function writePersistentCache(ctx, state) {
 	const cachePath = resolvePersistentCachePath(ctx);
 	if (!cachePath || !state.initialized || !getResolvedConfig(ctx).persistentCache) return;
-	let fileMtims;
+	const payload = createPersistentCachePayload(state, {});
 	try {
-		fileMtims = await collectWatchFileMtims(state.watchFiles);
+		payload.fileMtims = await collectWatchFileMtims(payload.watchFiles);
 	} catch {
 		return;
 	}
 	try {
-		const payload = createPersistentCachePayload(state, fileMtims);
 		if (await hasSamePersistentCachePayload(cachePath, payload)) return;
 		await fs$1.outputJson(cachePath, payload, { spaces: 2 });
 	} catch (error) {
@@ -9813,7 +10090,9 @@ async function updateCandidateFromFile(ctx, stateCandidates, filePath, event, ma
 function createAutoRoutesService(ctx) {
 	const state = ctx.runtimeState.autoRoutes;
 	let pendingScan;
+	let pendingRefresh;
 	let lastWrittenTypedDefinition;
+	let resolvePageDeclarationSource;
 	let mutationVersion = 0;
 	function flagDirty() {
 		mutationVersion += 1;
@@ -9836,6 +10115,22 @@ function createAutoRoutesService(ctx) {
 	function markNeedsFullRescan() {
 		state.needsFullRescan = true;
 	}
+	async function mayChangePageDeclaration(sourcePath) {
+		if (!state.pageSourceFiles.has(sourcePath)) return false;
+		if (state.namedRouteSourceFiles.has(sourcePath)) return true;
+		try {
+			const source = await fs$1.readFile(sourcePath, "utf8");
+			return mayContainPageDeclaration(source);
+		} catch {
+			return true;
+		}
+	}
+	function getPageDeclarationOwners(filePath) {
+		const sourcePath = normalizeFsResolvedId(filePath);
+		const dependencyOwners = state.pageDeclarationDependencies.get(sourcePath);
+		if (dependencyOwners) return [...dependencyOwners];
+		return state.pageSourceFiles.has(sourcePath) ? [sourcePath] : [];
+	}
 	async function ensureCandidateRegistry() {
 		const configService = requireConfigService(ctx, "扫描路由前必须初始化 configService。");
 		if (!isEnabled()) {
@@ -9857,46 +10152,76 @@ function createAutoRoutesService(ctx) {
 		state.needsFullRescan = false;
 		return true;
 	}
-	async function ensureFresh() {
+	async function refresh() {
 		if (!isEnabled()) {
-			if (state.dirty || !state.initialized || state.routes.pages.length > 0 || state.routes.entries.length > 0 || state.routes.subPackages.length > 0) resetState();
+			if (state.dirty || !state.initialized || state.routes.pages.length > 0 || state.routes.entries.length > 0 || state.routes.subPackages.length > 0 || state.namedRoutes.length > 0) resetState();
 			if (await removeTypedRouterDefinition(ctx)) lastWrittenTypedDefinition = void 0;
 			await removePersistentCache(ctx);
 			return;
 		}
 		if (!getResolvedConfig().persistentCache) await removePersistentCache(ctx);
+		let registryUpdated = false;
 		if (!state.initialized && state.needsFullRescan) {
-			if (await restorePersistentCache(ctx, state)) {
+			registryUpdated = await ensureCandidateRegistry();
+			const topologyKey = createAutoRoutesTopologyKey(ctx, state.candidates);
+			const restoreVersion = mutationVersion;
+			const isRestoreCurrent = () => {
+				return mutationVersion === restoreVersion && topologyKey === createAutoRoutesTopologyKey(ctx, state.candidates);
+			};
+			if (await restorePersistentCache(ctx, state, topologyKey, isRestoreCurrent, Boolean(resolvePageDeclarationSource)) && isRestoreCurrent()) {
 				lastWrittenTypedDefinition = await writeTypedRouterDefinition(ctx, state.typedDefinition, lastWrittenTypedDefinition);
-				return;
+				if (isRestoreCurrent()) return;
 			}
 		}
-		if (await ensureCandidateRegistry()) flagDirty();
+		if (!registryUpdated) registryUpdated = await ensureCandidateRegistry();
+		if (registryUpdated) flagDirty();
 		if (!state.dirty) {
 			await (pendingScan ?? Promise.resolve());
-			lastWrittenTypedDefinition = await writeTypedRouterDefinition(ctx, state.typedDefinition, lastWrittenTypedDefinition);
+			if (!state.dirty) lastWrittenTypedDefinition = await writeTypedRouterDefinition(ctx, state.typedDefinition, lastWrittenTypedDefinition);
 			return;
 		}
 		while (state.dirty) {
 			if (!pendingScan) {
 				const versionSnapshot = mutationVersion;
-				pendingScan = scanRoutes(ctx, state.candidates).then((result) => {
+				pendingScan = scanRoutes(ctx, state.candidates, { resolvePageDeclarationSource }).then((result) => {
+					if (mutationVersion !== versionSnapshot) return;
 					updateRoutesReference(state.routes, result.snapshot);
+					state.namedRoutes = result.namedRoutes;
 					state.serialized = result.serialized;
 					state.moduleCode = result.moduleCode;
+					state.namedModuleCode = result.namedModuleCode;
+					state.signature = result.signature;
 					state.typedDefinition = result.typedDefinition;
+					state.topologyKey = result.topologyKey;
+					updatePageDeclarationDependencies(state.pageDeclarationDependencies, result.pageDeclarationDependencies);
+					state.pageDeclarationFingerprints.clear();
+					for (const [sourceFile, fingerprint] of result.pageDeclarationFingerprints) state.pageDeclarationFingerprints.set(sourceFile, fingerprint);
+					state.usesOpaquePageDeclarationResolver = result.usesOpaquePageDeclarationResolver;
+					updateWatchTargets(state.pageSourceFiles, result.pageSourceFiles);
+					updateWatchTargets(state.namedRouteSourceFiles, result.namedRouteSourceFiles);
 					updateWatchTargets(state.watchFiles, result.watchFiles);
 					updateWatchTargets(state.watchDirs, result.watchDirs);
-					if (mutationVersion === versionSnapshot) state.dirty = false;
+					state.dirty = false;
 					state.initialized = true;
+				}).catch((error) => {
+					if (mutationVersion === versionSnapshot) throw error;
 				}).finally(() => {
 					pendingScan = void 0;
 				});
 			}
 			await pendingScan;
-			lastWrittenTypedDefinition = await writeTypedRouterDefinition(ctx, state.typedDefinition, lastWrittenTypedDefinition);
-			await writePersistentCache(ctx, state);
 		}
+		const publicationVersion = mutationVersion;
+		if (!state.dirty) lastWrittenTypedDefinition = await writeTypedRouterDefinition(ctx, state.typedDefinition, lastWrittenTypedDefinition);
+		if (!state.dirty && mutationVersion === publicationVersion) await writePersistentCache(ctx, state);
+	}
+	async function ensureFresh() {
+		do {
+			pendingRefresh ??= refresh().finally(() => {
+				pendingRefresh = void 0;
+			});
+			await pendingRefresh;
+		} while (state.dirty);
 	}
 	return {
 		async ensureFresh() {
@@ -9913,24 +10238,46 @@ function createAutoRoutesService(ctx) {
 			return state.routes;
 		},
 		getSignature() {
-			return state.serialized;
+			return state.signature;
 		},
 		getModuleCode() {
 			return state.moduleCode;
 		},
+		getNamedModuleCode() {
+			return state.namedModuleCode;
+		},
 		getWatchFiles() {
 			return state.watchFiles.values();
 		},
 		getWatchDirectories() {
 			return state.watchDirs.values();
 		},
+		getPageDeclarationOwners(filePath) {
+			return isEnabled() ? getPageDeclarationOwners(filePath) : [];
+		},
 		isRouteFile(filePath) {
-			return isEnabled() && matchesRouteFile(ctx, filePath);
+			return isEnabled() && (getPageDeclarationOwners(filePath).length > 0 || matchesRouteFile(ctx, filePath));
+		},
+		isPageSource(filePath) {
+			const sourcePath = normalizeFsResolvedId(filePath);
+			return isEnabled() && state.pageSourceFiles.has(sourcePath);
+		},
+		isPageDeclarationSource(filePath) {
+			return isEnabled() && getPageDeclarationOwners(filePath).length > 0;
+		},
+		setPageDeclarationSourceResolver(resolve) {
+			resolvePageDeclarationSource = resolve;
 		},
 		async handleFileChange(filePath, event) {
 			if (!isEnabled()) return false;
+			const sourcePath = normalizeFsResolvedId(filePath);
+			if (state.pageDeclarationDependencies.has(sourcePath)) {
+				flagDirty();
+				await ensureFresh();
+				return true;
+			}
 			if (!matchesRouteFile(ctx, filePath)) return false;
-			if (!await updateCandidateFromFile(ctx, state.candidates, filePath, event, markNeedsFullRescan) && !state.needsFullRescan) return false;
+			if (!await updateCandidateFromFile(ctx, state.candidates, filePath, event, markNeedsFullRescan) && !state.needsFullRescan && !state.dirty && !await mayChangePageDeclaration(sourcePath)) return false;
 			flagDirty();
 			await ensureFresh();
 			return true;
@@ -9944,12 +10291,162 @@ function createAutoRoutesService(ctx) {
 	};
 }
 //#endregion
+//#region src/runtime/autoRoutesPlugin/service/resolver.ts
+function createDefaultPageDeclarationSourceResolver(ctx) {
+	let currentConfig;
+	let pendingResolver;
+	return async (source, importer) => {
+		const configService = ctx.configService;
+		if (!configService) return;
+		if (!pendingResolver || currentConfig !== configService.inlineConfig) {
+			currentConfig = configService.inlineConfig;
+			pendingResolver = resolveConfig({
+				root: configService.cwd,
+				configFile: false,
+				mode: configService.mode,
+				resolve: currentConfig?.resolve,
+				environments: currentConfig?.environments
+			}, configService.isDev ? "serve" : "build", configService.mode, configService.isDev ? "development" : "production").then((config) => {
+				const environment = new BuildEnvironment("client", config);
+				const resolveId = createIdResolver(config);
+				return (id, importer) => resolveId(environment, id, importer);
+			});
+		}
+		return await (await pendingResolver)(source, importer);
+	};
+}
+//#endregion
 //#region src/runtime/autoRoutesPlugin/index.ts
 function createAutoRoutesServicePlugin(ctx) {
-	ctx.autoRoutesService = createAutoRoutesService(ctx);
+	const service = createAutoRoutesService(ctx);
+	service.setPageDeclarationSourceResolver(createDefaultPageDeclarationSourceResolver(ctx));
+	ctx.autoRoutesService = service;
 	return { name: "weapp-runtime:auto-routes-service" };
 }
 //#endregion
+//#region src/plugins/autoRoutes.shared.ts
+const AUTO_ROUTES_ID$1 = "weapp-vite/auto-routes";
+const VIRTUAL_MODULE_ID = "virtual:weapp-vite-auto-routes";
+const RESOLVED_VIRTUAL_ID = "\0weapp-vite:auto-routes";
+/**
+* 判断当前是否应按 watch 模式为 auto-routes 注册依赖文件。
+*/
+function isAutoRoutesWatchMode(configService) {
+	return Boolean(configService?.isDev || configService?.inlineConfig?.build?.watch);
+}
+/**
+* 合并 service 与 matcher 提供的监听目录，并去重保留顺序。
+*/
+function collectAutoRoutesWatchDirs(watchDirectories, matcherWatchRoots) {
+	const watchDirs = /* @__PURE__ */ new Set();
+	for (const dir of watchDirectories) watchDirs.add(dir);
+	for (const dir of matcherWatchRoots) watchDirs.add(dir);
+	return [...watchDirs];
+}
+/**
+* 过滤出真正需要交给 auto-routes watcher 处理的路由源文件。
+* 已知声明依赖不受普通页面发现扩展名限制，其他文件仍沿用发现规则。
+*/
+function isAutoRoutesWatchFile(filePath, allowedExtensions, isPagesRelatedPath, isPageDeclarationSource) {
+	if (isAutoRoutesGeneratedFileName(path.basename(filePath))) return false;
+	if (isPageDeclarationSource(filePath)) return true;
+	return allowedExtensions.has(path.extname(filePath)) && isPagesRelatedPath(filePath);
+}
+/**
+* 判断是否满足 auto-routes sidecar watcher 的启动前置条件。
+*/
+function shouldStartAutoRoutesWatcher(options) {
+	if (options.routeWatcherStarted) return false;
+	if (!options.isDev) return false;
+	if (!options.autoRoutesEnabled || !options.autoRoutesWatch || !options.serviceEnabled) return false;
+	return options.watchDirsLength > 0;
+}
+/**
+* 生成 sidecar watcher map 使用的关闭句柄。
+*/
+function createAutoRoutesSidecarWatcher(watcher) {
+	return { close: async () => {
+		await watcher.close();
+	} };
+}
+/**
+* 向插件上下文注册 auto-routes 相关 watch 目标，忽略单个 addWatchFile 失败。
+*/
+function addAutoRoutesWatchTargets(pluginCtx, targets) {
+	for (const file of targets.files) try {
+		pluginCtx.addWatchFile?.(normalizeWatchPath(file));
+	} catch {}
+	for (const dir of targets.directories) try {
+		pluginCtx.addWatchFile?.(normalizeWatchPath(dir));
+	} catch {}
+}
+function invalidateAutoRoutesVirtualModules(server, resolvedIds) {
+	if (!server) return;
+	const seen = /* @__PURE__ */ new Set();
+	const invalidateModuleWithImporters = (module) => {
+		if (seen.has(module)) return;
+		seen.add(module);
+		server.moduleGraph.invalidateModule(module);
+		for (const importer of module.importers) invalidateModuleWithImporters(importer);
+	};
+	for (const id of resolvedIds) {
+		const virtualModule = server.moduleGraph.getModuleById(id);
+		if (virtualModule) invalidateModuleWithImporters(virtualModule);
+	}
+}
+/**
+* 统一解析 auto-routes 虚拟模块与 alias 入口的命中关系。
+*/
+function resolveAutoRoutesVirtualId(id, aliasTargets) {
+	if (id === WEVU_AUTO_ROUTES_MODULE_ID$1 || id === WEVU_AUTO_ROUTES_VIRTUAL_MODULE_ID$1 || id === WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID$1) return WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID$1;
+	if (id === "weapp-vite/auto-routes" || id === "virtual:weapp-vite-auto-routes" || id === "\0weapp-vite:auto-routes") return RESOLVED_VIRTUAL_ID;
+	return aliasTargets?.has(id) ? RESOLVED_VIRTUAL_ID : null;
+}
+/**
+* 将 create/delete 这类结构性变化映射为 auto-routes 的全量重扫语义。
+*/
+function resolveAutoRoutesWatchChangeEvent(event) {
+	if (event === "create" || event === "delete") return "rename";
+}
+/**
+* 判断某次热更新是否需要触发 auto-routes 虚拟模块失效。
+*/
+function resolveAutoRoutesHotUpdateAction(command, options) {
+	if (command === "serve") return options.isRouteFile ? {
+		shouldHandle: true,
+		shouldUpdateRouteFile: true
+	} : {
+		shouldHandle: false,
+		shouldUpdateRouteFile: false
+	};
+	if (options.isRouteFile || options.isPagesRelatedPath) return {
+		shouldHandle: true,
+		shouldUpdateRouteFile: false
+	};
+	return {
+		shouldHandle: false,
+		shouldUpdateRouteFile: false
+	};
+}
+/**
+* Web 路由表在创建 router 时完成快照，必须越过 SFC 自接受边界重新加载入口。
+* 入口排在前面，避免依赖失效先将生成的入口降为仅更新时间戳的软失效。
+*/
+function collectAutoRoutesReloadModules(modules) {
+	const pending = [...modules];
+	const visited = new Set(pending);
+	const reloadModules = /* @__PURE__ */ new Set();
+	for (const module of pending) {
+		if (module.importers.size === 0) reloadModules.add(module);
+		for (const importer of module.importers) if (!visited.has(importer)) {
+			visited.add(importer);
+			pending.push(importer);
+		}
+	}
+	for (const module of modules) reloadModules.add(module);
+	return [...reloadModules];
+}
+//#endregion
 //#region src/runtime/npmPlugin/service/dependencies.ts
 const DEFAULT_NPM_STRATEGY = "explicit";
 function dedupeDependencies(dependencies) {
@@ -10124,10 +10621,10 @@ function collectResolverPlugins(config) {
 	return (Array.isArray(config.plugins) ? config.plugins : config.plugins ? [config.plugins] : []).filter((plugin) => !isInternalPlugin(plugin));
 }
 async function transformVueSource(code, id, config) {
-	const { descriptor, errors } = parse$1(code, { filename: id });
+	const { descriptor, errors } = await readAndParseSfc(id, { source: code });
 	if (errors.length) throw errors[0];
-	const blocks = [descriptor.script, descriptor.scriptSetup].filter((block) => block?.content);
-	const source = blocks.map((block) => block.content).join("\n") || "export default {}";
+	const blocks = [descriptor.script, descriptor.scriptSetup].filter((block) => block?.content || block?.src);
+	const source = blocks.map((block) => block.src ? `import ${JSON.stringify(block.src)};` : block.content).join("\n") || "export default {}";
 	const lang = blocks.some((block) => block?.lang === "tsx") ? "tsx" : blocks.some((block) => block?.lang === "ts") ? "ts" : "js";
 	return await transformWithOxc(source, id, {
 		lang,
@@ -10151,7 +10648,18 @@ function createProviderPlugin(ctx, config, onChange) {
 	return {
 		name: "weapp-vite:module-graph-provider",
 		enforce: "pre",
+		config() {
+			return { resolve: { alias: [{
+				find: WEVU_AUTO_ROUTES_MODULE_ID$1,
+				replacement: WEVU_AUTO_ROUTES_VIRTUAL_MODULE_ID$1
+			}, {
+				find: AUTO_ROUTES_ID$1,
+				replacement: VIRTUAL_MODULE_ID
+			}] } };
+		},
 		async resolveId(id, importer) {
+			const autoRoutesId = resolveAutoRoutesVirtualId(id);
+			if (autoRoutesId) return autoRoutesId;
 			const virtualId = resolveVirtualModuleId(id);
 			if (virtualId) return virtualId;
 			if (parseSidecarSourceRequest(id)) return id;
@@ -10165,6 +10673,9 @@ function createProviderPlugin(ctx, config, onChange) {
 			return null;
 		},
 		load(id) {
+			const autoRoutesId = resolveAutoRoutesVirtualId(id);
+			const service = ctx.autoRoutesService;
+			if (autoRoutesId && service) return service.ensureFresh().then(() => autoRoutesId === WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID$1 ? service.getNamedModuleCode() : service.getModuleCode());
 			if (id.startsWith(DEV_EXTERNAL_PREFIX)) return "export default {}";
 			const logicalEntry = parseLogicalEntryId(id);
 			if (logicalEntry) return createLogicalEntryModuleCode(logicalEntry, ctx.moduleGraphService.getEntryDependencies(logicalEntry.sourceId));
@@ -10292,7 +10803,7 @@ async function collectVueStyleScriptChanges(ctx, filename, configService) {
 	const changedEntries = /* @__PURE__ */ new Set();
 	for (const [entryId, bindings] of ctx.runtimeState.build.hmr.vueEntryStyleBindings) {
 		if (!bindings.sources.some((source) => normalizeFsResolvedId(source) === filename)) continue;
-		const { descriptor } = await readAndParseSfc(entryId, createReadAndParseSfcOptions(ctx.moduleGraphService, configService));
+		const { descriptor } = await readAndParseSfc$1(entryId, createReadAndParseSfcOptions(ctx.moduleGraphService, configService));
 		if (!hasSameCssVars(bindings.expressions, descriptor.cssVars)) changedEntries.add(entryId);
 	}
 	return changedEntries;
@@ -11476,9 +11987,18 @@ function createRuntimeState() {
 		},
 		autoRoutes: {
 			routes: emptyAutoRoutesSnapshot,
+			namedRoutes: [],
 			serialized: emptyAutoRoutesArtifacts.serialized,
 			moduleCode: emptyAutoRoutesArtifacts.moduleCode,
+			namedModuleCode: emptyAutoRoutesArtifacts.namedModuleCode,
+			signature: emptyAutoRoutesArtifacts.signature,
+			topologyKey: "",
 			typedDefinition: "",
+			pageDeclarationDependencies: /* @__PURE__ */ new Map(),
+			pageDeclarationFingerprints: /* @__PURE__ */ new Map(),
+			usesOpaquePageDeclarationResolver: false,
+			pageSourceFiles: /* @__PURE__ */ new Set(),
+			namedRouteSourceFiles: /* @__PURE__ */ new Set(),
 			watchFiles: /* @__PURE__ */ new Set(),
 			watchDirs: /* @__PURE__ */ new Set(),
 			dirty: true,
@@ -11528,6 +12048,7 @@ function createRuntimeState() {
 				lastHmrEntryIds: /* @__PURE__ */ new Set(),
 				lastEmittedEntryIds: /* @__PURE__ */ new Set(),
 				lastEmittedChunkFileNames: /* @__PURE__ */ new Set(),
+				forceEmitUnchangedChunks: true,
 				sharedChunkSourceModuleIds: /* @__PURE__ */ new Set(),
 				recentProfiles: [],
 				profile: {}
@@ -11594,18 +12115,7 @@ function resetRuntimeStateForFreshBuild(runtimeState) {
 	runtimeState.glassEasel.diagnostics.clear();
 	runtimeState.glassEasel.warnedDiagnostics.clear();
 	runtimeState.glassEasel.silent = false;
-	const autoRoutes = runtimeState.autoRoutes;
-	autoRoutes.routes = fresh.autoRoutes.routes;
-	autoRoutes.serialized = fresh.autoRoutes.serialized;
-	autoRoutes.moduleCode = fresh.autoRoutes.moduleCode;
-	autoRoutes.typedDefinition = fresh.autoRoutes.typedDefinition;
-	autoRoutes.watchFiles.clear();
-	autoRoutes.watchDirs.clear();
-	autoRoutes.dirty = fresh.autoRoutes.dirty;
-	autoRoutes.initialized = fresh.autoRoutes.initialized;
-	autoRoutes.candidates.clear();
-	autoRoutes.needsFullRescan = fresh.autoRoutes.needsFullRescan;
-	autoRoutes.loadingAppConfig = fresh.autoRoutes.loadingAppConfig;
+	Object.assign(runtimeState.autoRoutes, fresh.autoRoutes);
 	const autoImport = runtimeState.autoImport;
 	autoImport.registry.clear();
 	autoImport.normalizedLocalComponents.clear();
@@ -13258,6 +13768,15 @@ function normalizeModuleId(id) {
 		stripLeadingNullByte: true
 	}).replaceAll("\\", "/");
 }
+function isWevuOwnedModuleId(id) {
+	if (WEVU_RUNTIME_MODULE_IDS.includes(id)) return true;
+	const normalized = normalizeModuleId(id);
+	const workspaceIndex = normalized.lastIndexOf("/packages-runtime/wevu/");
+	if (workspaceIndex >= 0) return !normalized.slice(workspaceIndex + 23).split("/").includes("node_modules");
+	const nodeModulesIndex = normalized.lastIndexOf("/node_modules/");
+	if (nodeModulesIndex < 0) return false;
+	return normalized.slice(nodeModulesIndex + 14).split("/", 1)[0] === "wevu";
+}
 function resolveWevuPreservedModulePath(id) {
 	const normalized = normalizeModuleId(id);
 	const sourceMarker = "/packages-runtime/wevu/src/";
@@ -13316,6 +13835,7 @@ const REG_COMMONJS_HELPERS = /commonjsHelpers\.js$/;
 const REG_REQUEST_GLOBAL_RUNTIME_VENDOR_ID = /(?:^|[/\\])(?:@wevu[/\\]web-apis|web-apis[/\\]dist[/\\]index\.(?:m?js|cjs)|weapp-vite[/\\](?:dist[/\\]web-apis\.mjs|src[/\\](?:webApis\.ts|runtime[/\\]webApis[/\\]index\.ts)))(?:$|[?#])/;
 const REG_WEAPP_VITE_RUNTIME_VENDOR_ID = /(?:^|[/\\])weapp-vite[/\\](?:dist[/\\]runtime\.mjs|src[/\\]plugins[/\\]vue[/\\]runtime\.ts)(?:$|[?#])/;
 const REG_HASHED_DIST_CHUNK_ID = /(?:^|[/\\])dist[/\\](?:dev[/\\])?([^/\\-]+)-([\w-]{6,})\.(?:m?js|cjs)(?:$|[?#])/;
+const REG_WEVU_RUNTIME_SUPPORT_ID = /(?:^|\/)@weapp-core\/(?:constants|shared)\/dist\//;
 const STABLE_HASHED_DIST_CHUNK_PRIORITY = ["src"];
 const STABLE_HASHED_DIST_CHUNK_PRIORITY_BY_PACKAGE = { wevu: [
 	"index",
@@ -13443,14 +13963,24 @@ function isWeappViteRuntimeModuleId(id) {
 	REG_WEAPP_VITE_RUNTIME_VENDOR_ID.lastIndex = 0;
 	return REG_WEAPP_VITE_RUNTIME_VENDOR_ID.test(cleanedAbsoluteId);
 }
+function isPackagedRuntimeModuleId(id) {
+	const cleanedAbsoluteId = normalizeSharedPathCandidate(id);
+	REG_NODE_MODULES_DIR.lastIndex = 0;
+	return REG_NODE_MODULES_DIR.test(cleanedAbsoluteId) || Boolean(resolveDistChunkPackageToken(cleanedAbsoluteId));
+}
+function isWevuRuntimeSupportModuleId(id) {
+	return REG_WEVU_RUNTIME_SUPPORT_ID.test(normalizeSharedPathCandidate(id));
+}
 function resolveStableHashedDistChunkFileName(chunk) {
 	const candidateIds = [chunk.facadeModuleId, ...chunk.moduleIds ?? []].filter((id) => typeof id === "string");
 	const matchedChunks = [];
 	let facadeMatchedChunk;
-	for (const id of candidateIds) {
-		const fileName = resolveWevuStableVendorFileName(id);
-		if (fileName) return fileName;
-	}
+	const wevuOwnedCandidates = candidateIds.map((id) => isWevuOwnedModuleId(id));
+	const hasWevuOwnedCandidate = wevuOwnedCandidates.some(Boolean);
+	const hasOtherPackagedCandidate = candidateIds.some((id, index) => !wevuOwnedCandidates[index] && !isWevuRuntimeSupportModuleId(id) && isPackagedRuntimeModuleId(id));
+	if (hasWevuOwnedCandidate && hasOtherPackagedCandidate) return "weapp-vendors/common.js";
+	const firstWevuVendorFileName = candidateIds.map((id) => resolveWevuStableVendorFileName(id)).find((fileName) => Boolean(fileName));
+	if (firstWevuVendorFileName) return firstWevuVendorFileName;
 	for (const id of candidateIds) {
 		if (isWeappViteRuntimeModuleId(id)) return "weapp-vendors/weapp-vite-runtime.js";
 		const cleanedAbsoluteId = normalizeSharedPathCandidate(id);
@@ -18842,7 +19372,7 @@ async function applyScriptSetupUsingComponents(options) {
 	const { pluginCtx, vueEntryPath, source, templatePath, json, configService, wxmlService, reExportResolutionCache, externalComponentEntryMap } = options;
 	try {
 		if (source !== void 0 && !hasTemplateComponentTagHint(source)) return;
-		const { descriptor, errors } = await readAndParseSfc(vueEntryPath, { ...createReadAndParseSfcOptions(pluginCtx, configService, source === void 0 ? void 0 : { source }) });
+		const { descriptor, errors } = await readAndParseSfc$1(vueEntryPath, { ...createReadAndParseSfcOptions(pluginCtx, configService, source === void 0 ? void 0 : { source }) });
 		if (!errors?.length && descriptor?.template && !templatePath) {
 			const tags = collectVueTemplateAutoImportTags(descriptor.template.content, vueEntryPath);
 			if (tags.size) {
@@ -20194,7 +20724,7 @@ async function syncManagedTsconfigSupportFiles(ctx) {
 	};
 }
 async function syncAutoRoutesSupportFiles(ctx) {
-	if (ctx.autoRoutesService?.isEnabled()) await ctx.autoRoutesService.ensureFresh();
+	await ctx.autoRoutesService?.ensureFresh();
 }
 async function syncAutoImportSupportFiles(ctx, syncAutoImport, configService) {
 	const autoImportConfig = syncAutoImport ? getAutoImportConfig(configService) : void 0;
@@ -20640,10 +21170,24 @@ async function cleanOutputs(configService) {
 //#endregion
 //#region src/runtime/buildPlugin/snapshotSources.ts
 /** 一次性 snapshot 不经过 watchChange，构建前必须刷新整个批次的真实源状态。 */
-async function refreshSnapshotSources(ctx, files) {
+async function refreshSnapshotSources(ctx, files, emittedRouteSignature) {
 	const changedFiles = new Set(Array.from(files, (file) => normalizeFsResolvedId(file)));
 	for (const file of changedFiles) invalidateFileCache(file);
-	for (const file of changedFiles) if (isTemplate(file)) await ctx.wxmlService?.scan(file);
+	for (const file of changedFiles) {
+		await ctx.autoRoutesService?.handleFileChange(file);
+		if (isTemplate(file)) await ctx.wxmlService?.scan(file);
+	}
+	const routeSignature = ctx.autoRoutesService?.getSignature();
+	const routeDependentEntries = /* @__PURE__ */ new Set();
+	if (emittedRouteSignature !== routeSignature) for (const id of [RESOLVED_VIRTUAL_ID, WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID]) {
+		invalidateFileCache(id);
+		ctx.moduleGraphService.recordChangedFile(id, "update");
+		for (const entry of ctx.moduleGraphService.invalidate(id)) routeDependentEntries.add(entry);
+	}
+	return {
+		routeSignature,
+		routeDependentEntries
+	};
 }
 //#endregion
 //#region src/runtime/buildPlugin/touchAppWxss.ts
@@ -21585,6 +22129,7 @@ function createBuildService(ctx) {
 		let pendingSnapshotBatch;
 		let failedSnapshotReasons = [];
 		let snapshotBatchTimer;
+		let emittedAutoRoutesSignature;
 		const devBuildWatcher = target === "app" ? createDevBuildWatcher() : void 0;
 		function markSnapshotEntriesFullDirty() {
 			for (const entryId of ctx.runtimeState.build.hmr.resolvedEntryMap.keys()) {
@@ -21645,7 +22190,9 @@ function createBuildService(ctx) {
 				recordHmrProfileDuration(ctx.runtimeState.build.hmr.profile, "snapshotResolveMs", performance.now() - snapshotResolveStartedAt);
 				const snapshotBuildStartedAt = performance.now();
 				const requiresFullRescan = batchReasons.some((batchReason) => batchReason.forceFullRescan || batchReason.event === "create" || batchReason.event === "delete");
-				await refreshSnapshotSources(ctx, batchReasons.flatMap((batchReason) => batchReason.file ? [batchReason.file] : []));
+				const { routeSignature, routeDependentEntries } = await refreshSnapshotSources(ctx, batchReasons.flatMap((batchReason) => batchReason.file ? [batchReason.file] : []), emittedAutoRoutesSignature);
+				for (const entryId of graphAffectedEntries) routeDependentEntries.delete(entryId);
+				for (const entryId of routeDependentEntries) graphAffectedEntries.add(entryId);
 				const styleScriptChanges = /* @__PURE__ */ new Set();
 				for (const batchReason of batchReasons) {
 					if (!batchReason.file) continue;
@@ -21657,7 +22204,7 @@ function createBuildService(ctx) {
 				if (!requiresFullRescan && graphAffectedEntries.size) {
 					const dirtyReasons = batchReasons.map(resolveSnapshotDirtyReason);
 					const dirtyReason = dirtyReasons.includes("direct") ? "direct" : dirtyReasons.includes("dependency") ? "dependency" : "metadata";
-					for (const entryId of graphAffectedEntries) if (ctx.runtimeState.build.hmr.resolvedEntryMap.has(entryId)) markSnapshotEntryDirty(entryId, reason, styleScriptChanges.has(entryId) ? "direct" : dirtyReason);
+					for (const entryId of graphAffectedEntries) if (ctx.runtimeState.build.hmr.resolvedEntryMap.has(entryId)) markSnapshotEntryDirty(entryId, reason, styleScriptChanges.has(entryId) ? "direct" : routeDependentEntries.has(entryId) ? "dependency" : dirtyReason);
 					const summaryCounts = /* @__PURE__ */ new Map();
 					for (const batchReason of batchReasons) {
 						if (!batchReason.file) continue;
@@ -21669,6 +22216,7 @@ function createBuildService(ctx) {
 					try {
 						devBuildWatcher?.emitEvent({ code: "START" });
 						await build(snapshotBuildOptions);
+						emittedAutoRoutesSignature = routeSignature;
 						devBuildWatcher?.emitEvent({ code: "END" });
 					} catch (error) {
 						devBuildWatcher?.emitEvent({
@@ -21695,6 +22243,7 @@ function createBuildService(ctx) {
 							emptyOutDir: shouldCleanOutputs(configService, "rebuild")
 						}
 					});
+					emittedAutoRoutesSignature = routeSignature;
 					devBuildWatcher?.emitEvent({ code: "END" });
 					return "snapshot";
 				} catch (error) {
@@ -21759,7 +22308,10 @@ function createBuildService(ctx) {
 		const watcherPromise = target === "app" ? (async () => {
 			devBuildWatcher.emitEvent({ code: "START" });
 			try {
+				await ctx.autoRoutesService?.ensureFresh();
+				const routeSignature = ctx.autoRoutesService?.getSignature();
 				await build(snapshotBuildOptions);
+				emittedAutoRoutesSignature = routeSignature;
 				devBuildWatcher.emitEvent({ code: "END" });
 				return devBuildWatcher.watcher;
 			} catch (error) {
@@ -22160,34 +22712,6 @@ function resolveBuiltinPackageAliases(options = {}) {
 	return aliases;
 }
 //#endregion
-//#region src/runtime/config/internal/alias.ts
-function normalizeAliasOptions(alias) {
-	if (!alias) return [];
-	if (Array.isArray(alias)) return alias.filter((entry) => {
-		return Boolean(entry && typeof entry === "object" && "find" in entry && "replacement" in entry);
-	});
-	return Object.entries(alias).map(([find, replacement]) => {
-		return {
-			find,
-			replacement
-		};
-	});
-}
-function createAliasManager(oxcAlias, defaultBuiltinAliases) {
-	function injectBuiltinAliases(config, builtinAliases = defaultBuiltinAliases) {
-		const resolve = config.resolve ?? (config.resolve = {});
-		const aliasArray = normalizeAliasOptions(resolve.alias);
-		if (!aliasArray.some((entry) => {
-			return entry.find instanceof RegExp && entry.find.source === oxcAlias.find.source;
-		})) aliasArray.unshift(oxcAlias);
-		for (const builtin of builtinAliases) if (!aliasArray.some((entry) => {
-			return typeof entry.find === "string" && entry.find === builtin.find;
-		})) aliasArray.unshift(builtin);
-		resolve.alias = aliasArray;
-	}
-	return { injectBuiltinAliases };
-}
-//#endregion
 //#region src/runtime/config/enhance.ts
 const enhanceKeys = [
 	"wxml",
@@ -24347,89 +24871,6 @@ function asset(ctx) {
 		buildTarget: ctx.currentBuildTarget ?? "app"
 	})];
 }
-const RESOLVED_VIRTUAL_ID = "\0weapp-vite:auto-routes";
-/**
-* 判断当前是否应按 watch 模式为 auto-routes 注册依赖文件。
-*/
-function isAutoRoutesWatchMode(configService) {
-	return Boolean(configService?.isDev || configService?.inlineConfig?.build?.watch);
-}
-/**
-* 合并 service 与 matcher 提供的监听目录，并去重保留顺序。
-*/
-function collectAutoRoutesWatchDirs(watchDirectories, matcherWatchRoots) {
-	const watchDirs = /* @__PURE__ */ new Set();
-	for (const dir of watchDirectories) watchDirs.add(dir);
-	for (const dir of matcherWatchRoots) watchDirs.add(dir);
-	return [...watchDirs];
-}
-/**
-* 过滤出真正需要交给 auto-routes watcher 处理的路由 Vue 文件。
-*/
-function isAutoRoutesWatchFile(filePath, allowedExtensions, isPagesRelatedPath) {
-	return !isAutoRoutesGeneratedFileName(path.basename(filePath)) && allowedExtensions.has(path.extname(filePath)) && isPagesRelatedPath(filePath);
-}
-/**
-* 判断是否满足 auto-routes sidecar watcher 的启动前置条件。
-*/
-function shouldStartAutoRoutesWatcher(options) {
-	if (options.routeWatcherStarted) return false;
-	if (!options.isDev) return false;
-	if (!options.autoRoutesEnabled || !options.autoRoutesWatch || !options.serviceEnabled) return false;
-	return options.watchDirsLength > 0;
-}
-/**
-* 生成 sidecar watcher map 使用的关闭句柄。
-*/
-function createAutoRoutesSidecarWatcher(watcher) {
-	return { close: async () => {
-		await watcher.close();
-	} };
-}
-/**
-* 向插件上下文注册 auto-routes 相关 watch 目标，忽略单个 addWatchFile 失败。
-*/
-function addAutoRoutesWatchTargets(pluginCtx, targets) {
-	for (const file of targets.files) try {
-		pluginCtx.addWatchFile?.(normalizeWatchPath(file));
-	} catch {}
-	for (const dir of targets.directories) try {
-		pluginCtx.addWatchFile?.(normalizeWatchPath(dir));
-	} catch {}
-}
-/**
-* 统一解析 auto-routes 虚拟模块与 alias 入口的命中关系。
-*/
-function resolveAutoRoutesVirtualId(id, aliasTargets) {
-	if (id === "weapp-vite/auto-routes" || id === "virtual:weapp-vite-auto-routes" || id === "\0weapp-vite:auto-routes") return RESOLVED_VIRTUAL_ID;
-	return aliasTargets.has(id) ? RESOLVED_VIRTUAL_ID : null;
-}
-/**
-* 将 create/delete 这类结构性变化映射为 auto-routes 的全量重扫语义。
-*/
-function resolveAutoRoutesWatchChangeEvent(event) {
-	if (event === "create" || event === "delete") return "rename";
-}
-/**
-* 判断某次热更新是否需要触发 auto-routes 虚拟模块失效。
-*/
-function resolveAutoRoutesHotUpdateAction(command, options) {
-	if (command === "serve") return options.isRouteFile ? {
-		shouldHandle: true,
-		shouldUpdateRouteFile: true
-	} : {
-		shouldHandle: false,
-		shouldUpdateRouteFile: false
-	};
-	if (options.isRouteFile || options.isPagesRelatedPath) return {
-		shouldHandle: true,
-		shouldUpdateRouteFile: false
-	};
-	return {
-		shouldHandle: false,
-		shouldUpdateRouteFile: false
-	};
-}
 //#endregion
 //#region src/plugins/core/lifecycle/autoRoutesTopology.ts
 /**
@@ -24441,31 +24882,95 @@ function markAppEntryForAutoRoutesTopology(ctx, options) {
 	invalidateFileCache("weapp-vite/auto-routes");
 	invalidateFileCache("virtual:weapp-vite-auto-routes");
 	invalidateFileCache("\0weapp-vite:auto-routes");
+	invalidateFileCache(WEVU_AUTO_ROUTES_MODULE_ID);
+	invalidateFileCache(WEVU_AUTO_ROUTES_VIRTUAL_MODULE_ID);
+	invalidateFileCache(WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID);
 	for (const target of resolveAutoRoutesAliasTargets(ctx.configService?.packageInfo?.rootPath)) invalidateFileCache(normalizeFsResolvedId(target));
-	options.loadEntry?.invalidateResolveCache?.();
+	const loadEntry = options.loadEntry;
+	if (loadEntry && typeof loadEntry === "object" && "invalidateResolveCache" in loadEntry && typeof loadEntry.invalidateResolveCache === "function") loadEntry.invalidateResolveCache();
 	ctx.runtimeState.build.hmr.appEntryAutoRoutesSignature = void 0;
 	if (!appEntryId || !options.resolvedEntryMap.has(appEntryId)) return false;
 	options.markEntryDirty(appEntryId, "direct");
 	return true;
 }
 //#endregion
+//#region src/plugins/utils/parse.ts
+function hasOwn$2(source, key) {
+	return Object.prototype.hasOwnProperty.call(source, key);
+}
+/**
+* 参考：https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-vite/src/index.ts
+* 解析请求ID，返回包含文件名和查询参数的对象。
+* 如果查询参数中包含'wxss'，则将其值设置为true。
+* @param id - 请求ID，格式为'filename?query'
+* @returns 解析后的请求响应对象
+*/
+function parseRequest(id) {
+	const [filename, rawQuery] = id.split(`?`, 2);
+	const query = {};
+	if (rawQuery) {
+		const params = new URLSearchParams(rawQuery);
+		for (const [key, value] of params.entries()) query[key] = value;
+		if (hasOwn$2(query, "wxss")) query.wxss = true;
+	}
+	return {
+		filename,
+		query
+	};
+}
+/**
+* 根据请求响应获取 CSS 文件的真实路径。
+* 如果请求中包含 wxss 查询参数，则将文件扩展名更改为 'wxss'。
+* @param res - 解析请求的响应对象，包含文件名和查询参数。
+* @returns 返回文件的真实路径。
+*/
+function getCssRealPath(res) {
+	if (typeof res.query.nativeStyle === "string" && res.query.nativeStyle) return changeFileExtension(res.filename, res.query.nativeStyle);
+	if (res.query.wxss) return changeFileExtension(res.filename, "wxss");
+	return res.filename;
+}
+//#endregion
 //#region src/plugins/autoRoutes.ts
 /**
 * 路由文件监听器的唯一标识，用于在 sidecarWatcherMap 中注册。
 */
-const ROUTE_WATCHER_KEY = "__auto-routes-vue-watcher__";
-function createAutoRoutesPlugin(ctx) {
-	const service = ctx.autoRoutesService;
+const ROUTE_WATCHER_KEY = "__auto-routes-source-watcher__";
+const AUTO_ROUTES_RESOLVED_IDS = [RESOLVED_VIRTUAL_ID, WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID$1];
+const AUTO_ROUTES_VUE_SUFFIXES = vueExtensions.map((extension) => `.${extension}`);
+function isAutoRoutesWatcherController(watcher) {
+	return Boolean(watcher && typeof watcher === "object" && "addWatchTargets" in watcher && typeof watcher.addWatchTargets === "function" && "close" in watcher && typeof watcher.close === "function" && "subscribers" in watcher && watcher.subscribers instanceof Map);
+}
+/**
+* 这里只排除非脚本 Vue 子资源；外部脚本是否属于页面声明由 service 的依赖所有权判定。
+*/
+function isPageScriptTransformRequest(id, normalizedId) {
+	const query = id.includes("?") ? parseRequest(id).query : void 0;
+	if (AUTO_ROUTES_VUE_SUFFIXES.some((suffix) => normalizedId.endsWith(suffix))) return query?.type === "script";
+	return !query || !("vue" in query) || query.type === "script";
+}
+function createAutoRoutesPlugin(ctx, service) {
 	let resolvedConfig;
 	let devServer;
+	let servedRouteSignature;
 	const autoRoutesAliasTargets = /* @__PURE__ */ new Set();
 	const autoRoutesTopologyDirtyEntries = /* @__PURE__ */ new Set();
-	let routeWatcherStarted = false;
+	const watcherSubscriber = {
+		topologyDirtyEntries: autoRoutesTopologyDirtyEntries,
+		get devServer() {
+			return devServer;
+		}
+	};
+	function registerPageDeclarationSourceResolver(pluginContext) {
+		service.setPageDeclarationSourceResolver(typeof pluginContext.resolve === "function" ? async (source, importer) => {
+			return (await pluginContext.resolve(source, importer, { skipSelf: true }))?.id;
+		} : void 0);
+	}
 	const refreshAutoRoutesAliasTargets = () => {
 		autoRoutesAliasTargets.clear();
 		for (const target of resolveAutoRoutesAliasTargets(ctx.configService?.packageInfo?.rootPath)) autoRoutesAliasTargets.add(target);
 	};
 	function isPagesRelatedPath(id) {
+		if (service.isPageDeclarationSource(id)) return true;
 		const configService = ctx.configService;
 		if (!configService) return false;
 		const { autoRoutesConfig, subPackageRoots } = resolveAutoRoutesMatcherContext(ctx);
@@ -24477,37 +24982,14 @@ function createAutoRoutesPlugin(ctx) {
 			subPackageRoots
 		});
 	}
-	/**
-	* 启动 chokidar 监听 pages 目录下的路由文件增删。
-	* Rolldown 的 watcher 不会为新建文件触发 watchChange，
-	* 因此需要独立的文件监听来补偿。
-	*
-	* 注意：chokidar v5 在 macOS 上使用 glob 模式时无法检测新建文件，
-	* 必须直接监听目录，然后在事件回调中按扩展名过滤。
-	*
-	* 生命周期：watcher 注册到 sidecarWatcherMap，由 watcherService.closeAll()
-	* 统一回收，不在 closeBundle 中销毁（build watch 模式下 closeBundle 每次
-	* 重编译都会触发，提前销毁会导致后续文件变更无法感知）。
-	*/
-	function invalidateAutoRoutesVirtualModule() {
-		const server = devServer;
-		const virtualModule = server?.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ID);
-		if (!virtualModule || !server) return;
-		const seen = /* @__PURE__ */ new Set();
-		const invalidateModuleWithImporters = (module) => {
-			if (seen.has(module)) return;
-			seen.add(module);
-			server.moduleGraph.invalidateModule(module);
-			for (const importer of module.importers) invalidateModuleWithImporters(importer);
-		};
-		invalidateModuleWithImporters(virtualModule);
-	}
-	function markAutoRoutesTopologyDirty() {
+	function markAutoRoutesTopologyDirty(controller) {
+		const appEntry = ctx.scanService?.appEntry?.path;
+		if (appEntry) controller.subscribers.get("web")?.topologyDirtyEntries.add(normalizeFsResolvedId(appEntry));
 		return markAppEntryForAutoRoutesTopology(ctx, {
 			resolvedEntryMap: ctx.runtimeState.build.hmr.resolvedEntryMap,
 			markEntryDirty(entryId) {
 				const hmr = ctx.runtimeState.build.hmr;
-				autoRoutesTopologyDirtyEntries.add(entryId);
+				for (const subscriber of controller.subscribers.values()) subscriber.topologyDirtyEntries.add(entryId);
 				hmr.dirtyEntrySet.add(entryId);
 				hmr.dirtyEntryReasons.set(entryId, "direct");
 				hmr.loadedEntrySet.delete(entryId);
@@ -24516,32 +24998,80 @@ function createAutoRoutesPlugin(ctx) {
 			}
 		});
 	}
-	function notifyAppEntryChange() {
-		const appEntryPath = ctx.scanService?.appEntry?.path;
-		if (!appEntryPath || !devServer) return;
-		devServer.watcher.emit("change", appEntryPath);
-	}
-	async function handleRouteStructureChange(filePath, event) {
-		if (await service.handleFileChange(filePath, event)) {
-			invalidateAutoRoutesVirtualModule();
-			markAutoRoutesTopologyDirty();
-			notifyAppEntryChange();
+	function reportRouteStructureChangeError(filePath, event, error, controller) {
+		const action = event === "create" ? "新增" : "删除";
+		const reason = error instanceof Error ? error.message : String(error);
+		const routeError = /* @__PURE__ */ new Error(`[auto-routes:watch] ${action}路由文件 ${ctx.configService?.relativeCwd(filePath) ?? filePath} 处理失败：${reason}`);
+		const servers = /* @__PURE__ */ new Set();
+		for (const subscriber of controller.subscribers.values()) if (subscriber.devServer) servers.add(subscriber.devServer);
+		if (servers.size === 0) {
+			logger_default.error(routeError);
+			return;
 		}
+		for (const server of servers) server.ws.send({
+			type: "error",
+			err: {
+				message: routeError.message,
+				stack: routeError.stack ?? routeError.message,
+				id: filePath,
+				plugin: "weapp-vite:auto-routes"
+			}
+		});
+	}
+	async function handleRouteStructureChange(filePath, event, controller) {
+		const changedSource = normalizeFsResolvedId(filePath);
+		const declarationOwners = new Set(service.getPageDeclarationOwners(changedSource));
+		const didChangeRoutes = await service.handleFileChange(filePath, resolveAutoRoutesWatchChangeEvent(event));
+		controller.addWatchTargets([...service.getWatchDirectories()]);
+		if (!didChangeRoutes) return;
+		for (const owner of service.getPageDeclarationOwners(changedSource)) declarationOwners.add(owner);
+		const servers = /* @__PURE__ */ new Set();
+		for (const subscriber of controller.subscribers.values()) if (subscriber.devServer) servers.add(subscriber.devServer);
+		for (const server of servers) invalidateAutoRoutesVirtualModules(server, AUTO_ROUTES_RESOLVED_IDS);
+		const appEntryPath = ctx.scanService?.appEntry?.path;
+		markAutoRoutesTopologyDirty(controller);
+		ctx.scanService?.markDirty();
+		const notificationFiles = /* @__PURE__ */ new Set();
+		for (const owner of declarationOwners) if (owner !== changedSource) notificationFiles.add(owner);
+		if (appEntryPath) notificationFiles.add(appEntryPath);
+		for (const server of servers) for (const file of notificationFiles) server.watcher.emit("change", file);
 	}
+	/**
+	* 启动 chokidar 监听页面路由源文件及其外部声明依赖所在目录的增删。
+	* Rolldown 的 watcher 不会为新建文件触发 watchChange，
+	* 因此需要独立的文件监听来补偿。
+	*
+	* 注意：chokidar v5 在 macOS 上使用 glob 模式时无法检测新建文件，
+	* 必须直接监听目录，然后在事件回调中按扩展名过滤。
+	*
+	* 生命周期：watcher 注册到 sidecarWatcherMap，由 watcherService.closeAll()
+	* 统一回收，不在 closeBundle 中销毁（build watch 模式下 closeBundle 每次
+	* 重编译都会触发，提前销毁会导致后续文件变更无法感知）。
+	*/
 	function startRouteFileWatcher() {
 		const configService = ctx.configService;
 		if (!configService) return;
 		const { autoRoutesConfig, matcher: resolvedMatcher } = resolveAutoRoutesMatcherContext(ctx);
-		const allowedExtensions = new Set(vueExtensions.map((ext) => `.${ext}`));
+		const allowedExtensions = new Set([...vueExtensions, ...scriptExtensions].map((ext) => `.${ext}`));
 		const watchDirs = collectAutoRoutesWatchDirs(service.getWatchDirectories(), resolvedMatcher.getWatchRoots(configService.absoluteSrcRoot));
 		if (!shouldStartAutoRoutesWatcher({
-			routeWatcherStarted,
+			routeWatcherStarted: false,
 			isDev: configService.isDev,
 			autoRoutesEnabled: autoRoutesConfig.enabled,
 			autoRoutesWatch: autoRoutesConfig.watch,
 			serviceEnabled: service.isEnabled(),
 			watchDirsLength: watchDirs.length
 		})) return;
+		const subscriberId = resolvedConfig?.weappVite?.runtime ?? "miniprogram";
+		const { sidecarWatcherMap } = ctx.runtimeState.watcher;
+		const activeWatcher = sidecarWatcherMap.get(ROUTE_WATCHER_KEY);
+		if (isAutoRoutesWatcherController(activeWatcher)) {
+			activeWatcher.addWatchTargets(watchDirs);
+			activeWatcher.subscribers.set(subscriberId, watcherSubscriber);
+			return;
+		}
+		if (activeWatcher) return;
+		const subscribers = /* @__PURE__ */ new Map([[subscriberId, watcherSubscriber]]);
 		const watcher = chokidar.watch(watchDirs, createSidecarWatchOptions(configService, {
 			ignoreInitial: true,
 			persistent: true,
@@ -24550,23 +25080,43 @@ function createAutoRoutesPlugin(ctx) {
 				pollInterval: 20
 			}
 		}));
+		const sidecarWatcher = createAutoRoutesSidecarWatcher(watcher);
+		const controller = {
+			addWatchTargets(paths) {
+				watcher.add(paths);
+			},
+			subscribers,
+			async close() {
+				if (sidecarWatcherMap.get(ROUTE_WATCHER_KEY) === controller) sidecarWatcherMap.delete(ROUTE_WATCHER_KEY);
+				controller.subscribers.clear();
+				await sidecarWatcher.close();
+			}
+		};
 		watcher.on("add", (filePath) => {
-			if (!isAutoRoutesWatchFile(filePath, allowedExtensions, isPagesRelatedPath)) return;
+			if (!isAutoRoutesWatchFile(filePath, allowedExtensions, isPagesRelatedPath, service.isPageDeclarationSource)) return;
 			logger_default.info(`[auto-routes:watch] 新增路由文件 ${configService.relativeCwd(filePath)}`);
-			handleRouteStructureChange(filePath, "create");
+			handleRouteStructureChange(filePath, "create", controller).catch((error) => {
+				reportRouteStructureChangeError(filePath, "create", error, controller);
+			});
 		});
 		watcher.on("unlink", (filePath) => {
-			if (!isAutoRoutesWatchFile(filePath, allowedExtensions, isPagesRelatedPath)) return;
+			if (!isAutoRoutesWatchFile(filePath, allowedExtensions, isPagesRelatedPath, service.isPageDeclarationSource)) return;
 			logger_default.info(`[auto-routes:watch] 删除路由文件 ${configService.relativeCwd(filePath)}`);
-			handleRouteStructureChange(filePath, "delete");
+			handleRouteStructureChange(filePath, "delete", controller).catch((error) => {
+				reportRouteStructureChangeError(filePath, "delete", error, controller);
+			});
 		});
-		const { sidecarWatcherMap } = ctx.runtimeState.watcher;
-		sidecarWatcherMap.set(ROUTE_WATCHER_KEY, createAutoRoutesSidecarWatcher(watcher));
-		routeWatcherStarted = true;
+		sidecarWatcherMap.set(ROUTE_WATCHER_KEY, controller);
 	}
 	return {
 		name: "weapp-vite:auto-routes",
 		enforce: "pre",
+		config() {
+			return { resolve: { alias: [{
+				find: WEVU_AUTO_ROUTES_MODULE_ID,
+				replacement: WEVU_AUTO_ROUTES_VIRTUAL_MODULE_ID
+			}] } };
+		},
 		configResolved(config) {
 			resolvedConfig = config;
 			refreshAutoRoutesAliasTargets();
@@ -24575,6 +25125,7 @@ function createAutoRoutesPlugin(ctx) {
 			devServer = server;
 		},
 		buildStart() {
+			registerPageDeclarationSourceResolver(this);
 			refreshAutoRoutesAliasTargets();
 			startRouteFileWatcher();
 		},
@@ -24589,50 +25140,111 @@ function createAutoRoutesPlugin(ctx) {
 			}
 		},
 		async load(id) {
-			if (resolveAutoRoutesVirtualId(id, autoRoutesAliasTargets) !== "\0weapp-vite:auto-routes") return null;
+			const resolvedId = resolveAutoRoutesVirtualId(id, autoRoutesAliasTargets);
+			if (!resolvedId) return null;
+			registerPageDeclarationSourceResolver(this);
+			if (resolvedId === WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID$1 && !service.isEnabled()) this.error(`${WEVU_AUTO_ROUTES_MODULE_ID} 需要启用 weapp.autoRoutes。`);
 			await service.ensureFresh();
-			if (isAutoRoutesWatchMode(ctx.configService)) addAutoRoutesWatchTargets(this, {
+			if (isAutoRoutesWatchMode(ctx.configService)) addAutoRoutesWatchTargets(resolvedConfig?.command === "serve" ? { addWatchFile: (file) => devServer?.watcher.add(file) } : this, {
 				files: service.getWatchFiles(),
-				directories: service.getWatchDirectories()
+				directories: resolvedConfig?.command === "serve" ? [] : service.getWatchDirectories()
 			});
 			startRouteFileWatcher();
+			if (resolvedConfig?.weappVite?.runtime === "web") servedRouteSignature ??= service.getSignature();
 			return {
-				code: service.getModuleCode(),
+				code: resolvedId === WEVU_AUTO_ROUTES_RESOLVED_MODULE_ID$1 ? service.getNamedModuleCode() : service.getModuleCode(),
 				map: { mappings: "" }
 			};
 		},
+		async transform(code, id) {
+			if (!mayContainPageDeclaration(code)) return null;
+			const normalizedId = normalizeFsResolvedId(id);
+			if (!isPageScriptTransformRequest(id, normalizedId)) return null;
+			registerPageDeclarationSourceResolver(this);
+			await service.ensureFresh();
+			startRouteFileWatcher();
+			if (!service.isPageDeclarationSource(normalizedId)) return null;
+			const stripped = stripPageDeclaration(code, id);
+			return stripped ? {
+				code: stripped.code,
+				map: normalizeEncodedSourceMapLike(stripped.map)
+			} : null;
+		},
 		shouldTransformCachedModule({ id }) {
 			return autoRoutesTopologyDirtyEntries.delete(id) || void 0;
 		},
 		async watchChange(id, change) {
+			registerPageDeclarationSourceResolver(this);
 			const event = change?.event;
 			if (service.isRouteFile(id)) {
 				if (resolvedConfig?.command === "serve" && event === "update") return;
-				await service.handleFileChange(id, event);
+				await service.handleFileChange(id, resolveAutoRoutesWatchChangeEvent(event) ?? event);
+				startRouteFileWatcher();
 				return;
 			}
 			if (!isPagesRelatedPath(id)) return;
 			const resolvedEvent = resolveAutoRoutesWatchChangeEvent(event);
-			if (resolvedEvent) await service.handleFileChange(id, resolvedEvent);
+			if (resolvedEvent) {
+				await service.handleFileChange(id, resolvedEvent);
+				startRouteFileWatcher();
+			}
 		},
 		async handleHotUpdate(context) {
+			const changedSource = normalizeFsResolvedId(context.file);
+			const webRuntime = resolvedConfig?.weappVite?.runtime === "web";
+			const topologyChanged = webRuntime && autoRoutesTopologyDirtyEntries.delete(changedSource);
+			const declarationOwners = new Set(service.getPageDeclarationOwners(changedSource));
 			const routeFile = service.isRouteFile(context.file);
 			const hotUpdateAction = resolveAutoRoutesHotUpdateAction(resolvedConfig?.command, {
 				isRouteFile: routeFile,
 				isPagesRelatedPath: routeFile ? false : isPagesRelatedPath(context.file)
 			});
-			if (!hotUpdateAction.shouldHandle) return;
+			if (!hotUpdateAction.shouldHandle && !topologyChanged) return;
 			let didChangeRoutes = false;
-			if (hotUpdateAction.shouldUpdateRouteFile) didChangeRoutes = await service.handleFileChange(context.file, "update");
-			if (resolvedConfig?.command === "serve" && routeFile && !didChangeRoutes) return;
-			const virtualModule = context.server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_ID);
-			if (virtualModule) return [virtualModule];
-			return context.modules.filter((module) => module.id === RESOLVED_VIRTUAL_ID);
+			if (hotUpdateAction.shouldUpdateRouteFile) {
+				didChangeRoutes = await service.handleFileChange(context.file, "update");
+				startRouteFileWatcher();
+				for (const owner of service.getPageDeclarationOwners(changedSource)) declarationOwners.add(owner);
+			}
+			declarationOwners.delete(changedSource);
+			if (resolvedConfig?.command === "serve" && routeFile && !didChangeRoutes && declarationOwners.size === 0) return;
+			const signature = webRuntime ? service.getSignature() : void 0;
+			const reloadRoutes = webRuntime && (topologyChanged || servedRouteSignature !== void 0 && signature !== servedRouteSignature);
+			const modules = new Set(!webRuntime || reloadRoutes ? AUTO_ROUTES_RESOLVED_IDS.map((id) => context.server.moduleGraph.getModuleById(id)).filter((module) => Boolean(module)) : context.modules);
+			for (const owner of declarationOwners) {
+				const ownerModules = context.server.moduleGraph.getModulesByFile(owner);
+				if (ownerModules) {
+					for (const module of ownerModules) modules.add(module);
+					continue;
+				}
+				const ownerModule = context.server.moduleGraph.getModuleById(owner);
+				if (ownerModule) modules.add(ownerModule);
+			}
+			if (topologyChanged) for (const module of context.modules) modules.add(module);
+			if (modules.size > 0) {
+				if (reloadRoutes) {
+					servedRouteSignature = signature;
+					return collectAutoRoutesReloadModules(modules);
+				}
+				return [...modules];
+			}
+			return context.modules.filter((module) => {
+				return module.id !== null && (AUTO_ROUTES_RESOLVED_IDS.includes(module.id) || declarationOwners.has(normalizeFsResolvedId(module.id)));
+			});
+		},
+		async closeBundle() {
+			if (resolvedConfig?.command !== "serve") return;
+			const watcher = ctx.runtimeState.watcher.sidecarWatcherMap.get(ROUTE_WATCHER_KEY);
+			const subscriberId = resolvedConfig.weappVite?.runtime ?? "miniprogram";
+			if (!isAutoRoutesWatcherController(watcher) || watcher.subscribers.get(subscriberId) !== watcherSubscriber) return;
+			watcher.subscribers.delete(subscriberId);
+			if (watcher.subscribers.size === 0) await watcher.close();
 		}
 	};
 }
 function autoRoutes(ctx) {
-	return [createAutoRoutesPlugin(ctx)];
+	if (!ctx.autoRoutesService || !ctx.configService) return [];
+	return [createAutoRoutesPlugin(ctx, ctx.autoRoutesService)];
 }
 //#endregion
 //#region src/plugins/hooks/useLoadEntry/autoImport.ts
@@ -25130,13 +25742,24 @@ function findNativePageOptionsObject(ast) {
 	return matched;
 }
 function stripDefinePageMetaCalls(ast) {
+	const calls = new Set(collectPageMetaCallsFromPrograms({ script: ast }));
 	let mutated = false;
-	traverse(ast, { ExpressionStatement(path) {
-		const expression = path.node.expression;
-		if (!t.isCallExpression(expression) || !t.isIdentifier(expression.callee, { name: "definePageMeta" })) return;
-		mutated = true;
-		path.remove();
-	} });
+	traverse(ast, {
+		ImportDeclaration(path) {
+			if (path.node.source.value !== "wevu" || path.node.importKind === "type") return;
+			const specifiers = path.node.specifiers.filter((specifier) => !t.isImportSpecifier(specifier) || (t.isIdentifier(specifier.imported) ? specifier.imported.name : specifier.imported.value) !== WEVU_DEFINE_PAGE_META_MACRO || specifier.importKind === "type");
+			if (specifiers.length === path.node.specifiers.length) return;
+			mutated = true;
+			path.node.specifiers = specifiers;
+			if (!path.node.specifiers.length) path.remove();
+		},
+		ExpressionStatement(path) {
+			const expression = path.node.expression;
+			if (!t.isCallExpression(expression) || !calls.has(expression)) return;
+			mutated = true;
+			path.remove();
+		}
+	});
 	return mutated;
 }
 //#endregion
@@ -25271,7 +25894,6 @@ function createCompilerPageLayoutPlanSignature(plan) {
 }
 //#endregion
 //#region src/plugins/vue/transform/pageLayout/meta.ts
-const PAGE_META_MACRO_NAME = "definePageMeta";
 const analyzedPageLayoutSourceCache = /* @__PURE__ */ new Map();
 function unwrapStaticExpression(node) {
 	if (t.isTSAsExpression(node) || t.isTSSatisfiesExpression(node) || t.isTSNonNullExpression(node) || t.isTypeCastExpression(node)) return unwrapStaticExpression(node.expression);
@@ -25353,14 +25975,10 @@ function extractLayoutValueFromObject(node, filename) {
 	}
 	return layout;
 }
-function extractLayoutFromProgram(ast, filename) {
+function extractLayoutFromPrograms(programs, filename) {
 	let layout;
-	let macroCount = 0;
-	for (const statement of ast.program.body) {
-		if (!t.isExpressionStatement(statement) || !t.isCallExpression(statement.expression)) continue;
-		const call = statement.expression;
-		if (!t.isIdentifier(call.callee, { name: PAGE_META_MACRO_NAME })) continue;
-		macroCount += 1;
+	const calls = collectPageMetaCallsFromPrograms(programs);
+	for (const call of calls) {
 		if (call.arguments.length !== 1) throw new Error(`${filename} 中 definePageMeta() 必须且只能接收一个对象参数。`);
 		const firstArg = call.arguments[0];
 		if (t.isSpreadElement(firstArg) || !t.isExpression(firstArg)) throw new Error(`${filename} 中 definePageMeta() 仅支持对象字面量参数。`);
@@ -25368,7 +25986,7 @@ function extractLayoutFromProgram(ast, filename) {
 		if (!t.isObjectExpression(normalized)) throw new Error(`${filename} 中 definePageMeta() 仅支持对象字面量参数。`);
 		layout = extractLayoutValueFromObject(normalized, filename);
 	}
-	if (macroCount > 1) throw new Error(`${filename} 中 definePageMeta() 只能声明一次。`);
+	if (calls.length > 1) throw new Error(`${filename} 中 definePageMeta() 只能声明一次。`);
 	return layout;
 }
 function hasSetPageLayoutCallInProgram(ast) {
@@ -25410,25 +26028,21 @@ function analyzeVueScriptBlocks(source, filename) {
 function analyzePageLayoutSourceUncached(source, filename) {
 	if (filename.endsWith(".vue")) {
 		const { scriptAst, scriptSetupAst } = analyzeVueScriptBlocks(source, filename);
-		let layoutMeta;
-		if (scriptAst) layoutMeta = extractLayoutFromProgram(scriptAst, filename);
-		if (scriptSetupAst) {
-			const setupLayout = extractLayoutFromProgram(scriptSetupAst, filename);
-			if (layoutMeta !== void 0 && setupLayout !== void 0) throw new Error(`${filename} 中的 <script> 与 <script setup> 不能同时声明 definePageMeta().`);
-			if (setupLayout !== void 0) layoutMeta = setupLayout;
-		}
+		const layoutMeta = extractLayoutFromPrograms({
+			script: scriptAst,
+			scriptSetup: scriptSetupAst
+		}, filename);
 		const dynamicSwitch = Boolean(scriptAst && hasSetPageLayoutCallInProgram(scriptAst) || scriptSetupAst && hasSetPageLayoutCallInProgram(scriptSetupAst));
-		const dynamicPropKeys = dynamicSwitch ? Array.from(/* @__PURE__ */ new Set([...scriptAst ? collectSetPageLayoutPropKeysFromProgram(scriptAst) : [], ...scriptSetupAst ? collectSetPageLayoutPropKeysFromProgram(scriptSetupAst) : []])) : [];
 		return {
 			layoutMeta,
 			dynamicSwitch,
-			dynamicPropKeys
+			dynamicPropKeys: dynamicSwitch ? Array.from(/* @__PURE__ */ new Set([...scriptAst ? collectSetPageLayoutPropKeysFromProgram(scriptAst) : [], ...scriptSetupAst ? collectSetPageLayoutPropKeysFromProgram(scriptSetupAst) : []])) : []
 		};
 	}
 	const ast = parseScriptAst(source);
 	const dynamicSwitch = hasSetPageLayoutCallInProgram(ast);
 	return {
-		layoutMeta: extractLayoutFromProgram(ast, filename),
+		layoutMeta: extractLayoutFromPrograms({ script: ast }, filename),
 		dynamicSwitch,
 		dynamicPropKeys: dynamicSwitch ? collectSetPageLayoutPropKeysFromProgram(ast) : []
 	};
@@ -25462,7 +26076,6 @@ const TRAILING_INDEX_RE = /\/index$/;
 const LEADING_SLASHES_RE = /^\/+/;
 const ROUTE_RULE_GLOB_TOKEN_RE = /[*?[\]{}()!+@]/g;
 const layoutFilesCache = /* @__PURE__ */ new Map();
-const PAGE_META_HINT = "definePageMeta";
 const SET_PAGE_LAYOUT_HINT = "setPageLayout";
 function normalizePageRouteCandidates(filename, configService) {
 	const fullPath = `/${toPosixPath(configService.relativeOutputPath(removeFileExtension(filename))).replace(LEADING_SLASHES_RE, "")}`;
@@ -25607,7 +26220,7 @@ function invalidateResolvedPageLayoutsCache(absoluteSrcRoot) {
 	layoutFilesCache.delete(normalizeComparablePath(absoluteSrcRoot));
 }
 async function resolvePageLayoutPlan(source, filename, configService) {
-	const hasPageMetaHint = source.includes(PAGE_META_HINT);
+	const hasPageMetaHint = mayContainPageMeta(source);
 	const hasDynamicLayoutHint = source.includes(SET_PAGE_LAYOUT_HINT);
 	const analyzedSource = hasPageMetaHint || hasDynamicLayoutHint ? analyzePageLayoutSource(source, filename) : void 0;
 	const layoutMeta = (hasPageMetaHint ? analyzedSource?.layoutMeta : void 0) ?? resolveRouteRuleLayoutMeta(filename, configService);
@@ -26612,6 +27225,7 @@ async function emitEntryOutput(options) {
 		if (error && typeof error === "object" && "code" in error && error.code === "ENOENT" && configService.isDev && !await fs$1.pathExists(id)) return;
 		throw error;
 	}
+	if (type === "page" && !NON_VUE_PAGE_RE.test(id) && mayContainPageDeclaration(code)) code = stripPageDeclaration(code, id)?.code ?? code;
 	if (type === "page" && templatePath && !NON_VUE_PAGE_RE.test(id)) {
 		const layoutStartedAt = performance$1.now();
 		try {
@@ -26734,7 +27348,7 @@ const VUE_JSON_BLOCK_RE = /<json\b[^>]*>[\s\S]*?<\/json>/gi;
 const VUE_JSON_MACRO_HINT_RE = /\bdefine(?:App|Page|Component|Sitemap|Theme)Json\s*\(/;
 const NO_VUE_CONFIG_SIGNATURE = "no-vue-config";
 function hasPageLayoutSourceHint(source) {
-	return source.includes("definePageMeta") || source.includes("setPageLayout");
+	return mayContainPageMeta(source) || source.includes("setPageLayout");
 }
 function hashText(value) {
 	return createHash("sha256").update(value).digest("hex").slice(0, 16);
@@ -27554,6 +28168,7 @@ function useLoadEntry(ctx, options) {
 		},
 		async emitDirtyEntries() {
 			entryChunkLifecycle.beginBuild();
+			ctx.runtimeState.build.hmr.forceEmitUnchangedChunks = false;
 			if (!dirtyEntrySet.size) {
 				options?.hmr?.setDidEmitAllEntries?.(false);
 				options?.hmr?.setLastEmittedEntries?.(/* @__PURE__ */ new Set());
@@ -27588,6 +28203,7 @@ function useLoadEntry(ctx, options) {
 				rootInputIds
 			});
 			const pendingEntryIds = pendingResolution.pending;
+			ctx.runtimeState.build.hmr.forceEmitUnchangedChunks = [...pendingEntryIds].some((entryId) => dirtyEntryReasons.get(entryId) !== "metadata");
 			const pending = [];
 			chunkEmitStats.chunkEmitCount = 0;
 			chunkEmitStats.emitFileMs = 0;
@@ -29630,42 +30246,6 @@ function injectSharedStyleImports(css, modulePath, fileName, sharedStyles, confi
 	return prependSharedStyleImports(css, statements);
 }
 //#endregion
-//#region src/plugins/utils/parse.ts
-function hasOwn$2(source, key) {
-	return Object.prototype.hasOwnProperty.call(source, key);
-}
-/**
-* 参考：https://github.com/tailwindlabs/tailwindcss/blob/main/packages/%40tailwindcss-vite/src/index.ts
-* 解析请求ID，返回包含文件名和查询参数的对象。
-* 如果查询参数中包含'wxss'，则将其值设置为true。
-* @param id - 请求ID，格式为'filename?query'
-* @returns 解析后的请求响应对象
-*/
-function parseRequest(id) {
-	const [filename, rawQuery] = id.split(`?`, 2);
-	const query = {};
-	if (rawQuery) {
-		const params = new URLSearchParams(rawQuery);
-		for (const [key, value] of params.entries()) query[key] = value;
-		if (hasOwn$2(query, "wxss")) query.wxss = true;
-	}
-	return {
-		filename,
-		query
-	};
-}
-/**
-* 根据请求响应获取 CSS 文件的真实路径。
-* 如果请求中包含 wxss 查询参数，则将文件扩展名更改为 'wxss'。
-* @param res - 解析请求的响应对象，包含文件名和查询参数。
-* @returns 返回文件的真实路径。
-*/
-function getCssRealPath(res) {
-	if (typeof res.query.nativeStyle === "string" && res.query.nativeStyle) return changeFileExtension(res.filename, res.query.nativeStyle);
-	if (res.query.wxss) return changeFileExtension(res.filename, "wxss");
-	return res.filename;
-}
-//#endregion
 //#region src/plugins/css/styleOwnership.ts
 /** 在样式模块上保存实际消费的源文件，避免把仅用于失效的图边当作产物所有权。 */
 function createStyleSourceMeta(sources) {
@@ -29700,6 +30280,16 @@ const LEADING_BLANK_LINES_RE = /^(?:[ \t]*\r?\n)+/;
 const TAILWIND_CONTENT_HMR_NONCE_RE = /\n\/\* weapp-vite tailwind-content [^*\n]+ \*\/$/;
 const VITE_PREPROCESS_STYLE_RE = /\.(?:acss|css|less|sass|scss|styl|stylus|pcss|postcss|sss)$/;
 const TAILWIND_GENERATOR_PLACEHOLDER = "/*! weapp-tailwindcss generator-placeholder */";
+const VITE_STYLE_ASSET_PLACEHOLDER_RE = /__VITE_ASSET__([\w$]+)__(?:\$_(.*?)__)?/g;
+function resolveViteStyleAssetPlaceholders(source, fileName, pluginCtx) {
+	if (!source.includes("__VITE_ASSET__") || typeof pluginCtx.getFileName !== "function") return source;
+	return source.replace(VITE_STYLE_ASSET_PLACEHOLDER_RE, (_placeholder, referenceId, postfix = "") => {
+		const assetFileName = toPosixPath(pluginCtx.getFileName(referenceId));
+		const relativePath = path.posix.relative(path.posix.dirname(toPosixPath(fileName)), assetFileName);
+		const assetUrl = relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+		return `${encodeURI(assetUrl)}${postfix}`;
+	});
+}
 const pendingOwnerStyleSources = /* @__PURE__ */ new WeakMap();
 function consumePendingOwnerStyleSources(ctx) {
 	const sources = pendingOwnerStyleSources.get(ctx);
@@ -29827,7 +30417,8 @@ function emitCssAssetIfChanged(ctx, pluginCtx, bundle, fileName, source, options
 	const cache = ctx.runtimeState?.css?.emittedSource;
 	const existing = bundle[fileName];
 	const forceEmit = hasTailwindContentDirtyReason(ctx) || hasManagedTailwindcssOutputMarker(source);
-	const emittedSource = appendTailwindContentHmrNonce(ctx, source);
+	const resolvedSource = resolveViteStyleAssetPlaceholders(source, fileName, pluginCtx);
+	const emittedSource = appendTailwindContentHmrNonce(ctx, resolvedSource);
 	if (existing?.type === "asset") {
 		const current = existing.source?.toString?.() ?? "";
 		if (!forceEmit && isUnchangedDevHmrStyleAsset(ctx, normalizedFileName, current, emittedSource)) {
@@ -29835,17 +30426,17 @@ function emitCssAssetIfChanged(ctx, pluginCtx, bundle, fileName, source, options
 			return false;
 		}
 		if (current !== emittedSource) existing.source = emittedSource;
-		cache?.set(normalizedFileName, source);
+		cache?.set(normalizedFileName, resolvedSource);
 		return true;
 	}
-	if (!forceEmit && cache?.get(normalizedFileName) === source) return false;
+	if (!forceEmit && cache?.get(normalizedFileName) === resolvedSource) return false;
 	pluginCtx.emitFile({
 		type: "asset",
 		fileName,
 		...options?.originalFileName ? { originalFileName: options.originalFileName } : {},
 		source: emittedSource
 	});
-	cache?.set(normalizedFileName, source);
+	cache?.set(normalizedFileName, resolvedSource);
 	return true;
 }
 function injectSharedStyleImportsCached(css, modulePath, fileName, sharedStyles, configService, cache) {
@@ -29985,7 +30576,7 @@ async function handleBundleEntry(ctx, bundle, bundleKey, asset, configService, s
 			const { css, dependencies } = await preprocessStyleSource(preprocessInput, preprocessId, resolvedConfig, { enabled: shouldPreprocess });
 			syncCssImportDependencies(ctx, preprocessId, freshHmrStyleSourcePath ? preprocessInput : graphSource, dependencies);
 			if (typeof this.addWatchFile === "function") for (const dependency of dependencies) this.addWatchFile(normalizeWatchPath(dependency));
-			const processedCss = await processCssWithCache(css, configService);
+			const processedCss = resolveViteStyleAssetPlaceholders(await processCssWithCache(css, configService), fileName, this);
 			if (fileName !== bundleKey) {
 				delete bundle[bundleKey];
 				emitCssAssetIfChanged(ctx, this, bundle, fileName, processedCss);
@@ -30683,6 +31274,74 @@ async function flushIndependentOutputs(ctx, subPackageMeta, emitAsset) {
 	for (const output of outputs) for (const bundleOutput of getBundleOutputs(output)) emitAsset(toEmittedAsset(bundleOutput));
 }
 //#endregion
+//#region src/plugins/outputFinalizer/scopedStyles.ts
+const SCOPE_ATTRIBUTE_RE = /^data-v-[\w-]+$/;
+/** 支付宝和抖音不支持 scoped 属性选择器，使用同等优先级的 class 保留作用域。 */
+function normalizeClassScopedTemplate(source) {
+	if (!source.includes("data-v-")) return source;
+	const result = new MagicString(source);
+	let scopes = [];
+	let classEnd;
+	let unquotedClass;
+	let classes = /* @__PURE__ */ new Set();
+	let tagEnd = 0;
+	const parser = new Parser({
+		onopentagname(name) {
+			scopes = [];
+			classEnd = void 0;
+			unquotedClass = void 0;
+			classes = /* @__PURE__ */ new Set();
+			tagEnd = parser.startIndex + 1 + name.length;
+		},
+		onattribute(name, value, quote) {
+			if (SCOPE_ATTRIBUTE_RE.test(name) && value === "") scopes.push(name);
+			if (name === "class") {
+				classEnd = parser.endIndex - (quote ? 1 : 0);
+				classes = new Set(value.split(/\s+/));
+				if (!quote) unquotedClass = {
+					start: parser.startIndex,
+					end: parser.endIndex,
+					value
+				};
+			}
+		},
+		onopentag() {
+			scopes = scopes.filter((scope) => !classes.has(scope));
+			if (!scopes.length) return;
+			if (unquotedClass) result.overwrite(unquotedClass.start, unquotedClass.end, `class="${unquotedClass.value} ${scopes.join(" ")}"`);
+			else if (classEnd !== void 0) result.appendLeft(classEnd, ` ${scopes.join(" ")}`);
+			else result.appendLeft(tagEnd, ` class="${scopes.join(" ")}"`);
+		}
+	}, {
+		xmlMode: true,
+		decodeEntities: false
+	});
+	parser.end(source);
+	return result.toString();
+}
+function normalizeClassScopedStyle(source) {
+	if (!source.includes("data-v-")) return source;
+	const root = postcss.parse(source);
+	root.walkRules((rule) => {
+		if (!rule.selector.includes("data-v-")) return;
+		rule.selector = selectorParser((selectors) => {
+			selectors.walkAttributes((attribute) => {
+				if (SCOPE_ATTRIBUTE_RE.test(attribute.attribute) && !attribute.operator) attribute.replaceWith(selectorParser.className({ value: attribute.attribute }));
+			});
+		}).processSync(rule.selector);
+	});
+	return root.toString();
+}
+/** 在 bundler 写盘前同时归一化模板和样式，也覆盖仅包含样式资源的 HMR。 */
+function normalizeClassScopedAssets(bundle, extensions) {
+	for (const output of Object.values(bundle)) {
+		if (output.type !== "asset") continue;
+		const source = typeof output.source === "string" ? output.source : Buffer.from(output.source).toString("utf8");
+		if (output.fileName.endsWith(`.${extensions.wxml}`)) output.source = normalizeClassScopedTemplate(source);
+		else if (output.fileName.endsWith(`.${extensions.wxss}`)) output.source = normalizeClassScopedStyle(source);
+	}
+}
+//#endregion
 //#region src/plugins/outputFinalizer.ts
 const PREPROCESSOR_STYLE_ASSET_RE = /\.(?:less|sass|scss|styl|stylus|pcss|postcss|sss)$/i;
 const TEMPLATE_ASSET_RE = /\.(?:wxml|axml|swan|ttml|jxml|qml|ksml|xhsml)$/i;
@@ -30855,8 +31514,9 @@ function pruneUnchangedDevHmrOutputs(ctx, bundle, rewriteOptions, options) {
 		stabilizeWevuRuntimeChunkAccess(bundle);
 	}
 	for (const [fileName, output] of Object.entries(bundle)) {
-		const shouldForceEmitCurrentHmrChunk = isHmrBuild && output.type === "chunk" && (emittedChunkFileNames?.has(fileName) === true || emittedChunkFileNames?.has(output.fileName) === true);
-		if (isHmrBuild && output.type === "chunk" && emittedChunkFileNames?.size && !shouldForceEmitCurrentHmrChunk) {
+		const isCurrentHmrChunk = isHmrBuild && output.type === "chunk" && (emittedChunkFileNames?.has(fileName) === true || emittedChunkFileNames?.has(output.fileName) === true);
+		const shouldForceEmitCurrentHmrChunk = isCurrentHmrChunk && ctx.runtimeState.build.hmr.forceEmitUnchangedChunks !== false;
+		if (isHmrBuild && output.type === "chunk" && emittedChunkFileNames?.size && !isCurrentHmrChunk) {
 			delete bundle[fileName];
 			continue;
 		}
@@ -30912,6 +31572,7 @@ function createOutputFinalizerPlugin(ctx, subPackageMeta) {
 				if (ctx.configService.platform === "weapp") analyzeGlassEaselBundle(ctx, outputBundle);
 				normalizePreprocessorStyleAssetEntries(outputBundle, assetEntries.preprocessorStyleAssets, ctx.configService.outputExtensions?.wxss, assets.stage);
 				normalizeTemplateAssetEntries(ctx, assetEntries.templateAssets, subPackageMeta);
+				if (ctx.configService.platform === "alipay" || ctx.configService.platform === "tt") normalizeClassScopedAssets(outputBundle, ctx.configService.outputExtensions);
 				pruneUnchangedDevHmrOutputs(ctx, outputBundle, wevuRuntimeRewriteOptions, {
 					runtimeRewriteDone: true,
 					preserveCompleteBundle
@@ -33177,7 +33838,7 @@ async function resolveAppShellForCompilation(ctx, pluginCtx) {
 	if (!configService || !scanService || configService.weappLibConfig?.enabled) return;
 	const appEntry = await scanService.loadAppEntry();
 	if (!isAppVueFile(appEntry.path)) return;
-	const { descriptor } = await readAndParseSfc(appEntry.path, createReadAndParseSfcOptions(pluginCtx, configService));
+	const { descriptor } = await readAndParseSfc$1(appEntry.path, createReadAndParseSfcOptions(pluginCtx, configService));
 	if (!descriptor.template?.content.trim()) return;
 	return resolveAppShellLayout(configService);
 }
@@ -36149,7 +36810,7 @@ async function refreshCompiledVueEntryCacheInDev(options) {
 		}
 		const currentStyleIndependentSignature = dirtyEntryId && filename.endsWith(".vue") && isVueStyleOnlyDirtyReasonSummary(ctx.runtimeState?.build?.hmr?.profile?.dirtyReasonSummary) ? resolveVueSfcStyleIndependentSignature(source, filename) : void 0;
 		if (dirtyEntryId && filename.endsWith(".vue") && cached.styleIndependentSignature && currentStyleIndependentSignature && cached.styleIndependentSignature === currentStyleIndependentSignature && transformed.signature === cached.autoRoutesSignature && cached.source !== source) {
-			const { descriptor } = await readAndParseSfc(filename, {
+			const { descriptor } = await readAndParseSfc$1(filename, {
 				source,
 				checkMtime: configService.isDev
 			});
@@ -37339,7 +38000,7 @@ function createVueTransformPlugin(ctx, options = {}) {
 				},
 				scopedSlotModules,
 				parseWeappVueStyleRequest: (id) => parseWeappVueStyleRequest(id) ?? null,
-				readAndParseSfc,
+				readAndParseSfc: readAndParseSfc$1,
 				createReadAndParseSfcOptions
 			});
 		},
@@ -37368,7 +38029,7 @@ function createVueTransformPlugin(ctx, options = {}) {
 					scopedSlotModules,
 					emittedScopedSlotChunks,
 					classStyleRuntimeWarned,
-					readAndParseSfc,
+					readAndParseSfc: readAndParseSfc$1,
 					createReadAndParseSfcOptions
 				});
 			} finally {
@@ -37948,9 +38609,13 @@ function mergeMiniprogram(options, ...configs) {
 }
 //#endregion
 //#region src/runtime/config/internal/merge/web.ts
-function mergeWebPlugins(rawPlugins, webPlugin, runtimeProviderPlugin) {
+function mergeWebPlugins(rawPlugins, webPlugin, runtimeProviderPlugin, internalPlugins = []) {
 	const remaining = [];
-	const ownedPluginNames = new Set([webPlugin, runtimeProviderPlugin].map((option) => option && typeof option === "object" && "name" in option ? option.name : void 0).filter((name) => typeof name === "string"));
+	const ownedPluginNames = new Set([
+		webPlugin,
+		runtimeProviderPlugin,
+		...internalPlugins
+	].map((option) => option && typeof option === "object" && "name" in option ? option.name : void 0).filter((name) => typeof name === "string"));
 	const collect = (option) => {
 		if (!option) return;
 		if (Array.isArray(option)) {
@@ -37965,6 +38630,7 @@ function mergeWebPlugins(rawPlugins, webPlugin, runtimeProviderPlugin) {
 	return [
 		runtimeProviderPlugin,
 		webPlugin,
+		...internalPlugins,
 		...remaining
 	].filter(Boolean);
 }
@@ -37999,7 +38665,8 @@ function mergeWeb(options, ...configs) {
 			hmrAcceptCode: resolveRuntimeProviderHmrFooter(runtimeProvider)
 		}
 	});
-	inline.plugins = mergeWebPlugins(inline.plugins, webPlugin, runtimeProviderPlugin);
+	const autoRoutesPlugins = options.ctx && !options.configService?.weappLibConfig?.enabled && resolveWeappAutoRoutesConfig(options.configService?.weappViteConfig?.autoRoutes).enabled ? autoRoutes(options.ctx) : [];
+	inline.plugins = mergeWebPlugins(inline.plugins, webPlugin, runtimeProviderPlugin, autoRoutesPlugins);
 	inline.build ??= {};
 	inline.build.outDir = web.outDir;
 	inline.build.emptyOutDir ??= !isDev;
@@ -38115,6 +38782,7 @@ function createMergeFactories(options) {
 		const subPackageRoots = Object.keys(configService.weappViteConfig?.subPackages ?? {});
 		const sharedOutput = configService.options.chunksConfigured ? createSharedBuildOutput(configService, () => subPackageRoots, { runtime: "web" }) : void 0;
 		return backend.driver.mergeConfig({ merge: (...backendConfigs) => mergeWeb({
+			ctx,
 			configService,
 			config: currentOptions.config,
 			web: currentOptions.weappWeb,
@@ -38735,7 +39403,7 @@ async function loadAppEntry(ctx, scanState) {
 	const { path: appEntryPath } = appEntry;
 	let configFromVue;
 	if (!appConfigFile && vueAppPath) {
-		const { extractConfigFromVue } = await import("./file-DxMrh1lh.mjs");
+		const { extractConfigFromVue } = await import("./file-BRwj-D25.mjs");
 		configFromVue = await extractConfigFromVue(vueAppPath);
 		if (configFromVue) appConfigFile = vueAppPath;
 	}