@weapp-vite/miniprogram-automator 1.2.21 → 1.2.23

package/dist/{launch-BNQZTcKo.mjs → launch-CSjvON-f.mjs}

@@ -12636,6 +12636,48 @@ function getParserClass(pluginsMap) {
 	return cls;
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/view/templateInterpolation.ts
+/** 按表达式词法寻找插值边界，字符串和对象内部的大括号不结束绑定。 */
+function templateInterpolations(source) {
+	const ranges = [];
+	let offset = 0;
+	while (offset < source.length) {
+		const start = source.indexOf("{{", offset);
+		if (start < 0) break;
+		let quote;
+		let depth = 0;
+		let closed = false;
+		for (let i = start + 2; i < source.length; i++) {
+			const char = source[i];
+			if (quote) {
+				if (char === "\\") i++;
+				else if (char === quote) quote = void 0;
+			} else if (char === "'" || char === "\"") quote = char;
+			else if (char === "{") depth++;
+			else if (char === "}") {
+				if (depth === 0 && source[i + 1] === "}") {
+					ranges.push({
+						start,
+						end: i + 2,
+						expression: source.slice(start + 2, i)
+					});
+					offset = i + 2;
+					closed = true;
+					break;
+				}
+				depth--;
+			}
+		}
+		if (!closed) break;
+	}
+	return ranges;
+}
+function isTemplateExpression(value) {
+	const trimmed = value.trim();
+	const ranges = templateInterpolations(trimmed);
+	return ranges.length === 1 && ranges[0].start === 0 && ranges[0].end === trimmed.length;
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/view/wxs.ts
 const wxsFunctions = /* @__PURE__ */ new WeakSet();
 function registerWxsExports(value, visited = /* @__PURE__ */ new Set()) {
@@ -12689,13 +12731,9 @@ const BLOCKED_MEMBER_KEYS = /* @__PURE__ */ new Set([
 	"prototype"
 ]);
 const NUMERIC_DOT_PATH_RE = /\.(\d+)(?=[.[\s,}\]]|$)/g;
-function isMustacheOnly$2(value) {
-	const trimmed = value.trim();
-	return trimmed.startsWith("{{") && trimmed.endsWith("}}") && !trimmed.includes("{{", 2);
-}
 function unwrapMustacheExpression(expression) {
 	const normalized = expression.trim();
-	if (isMustacheOnly$2(normalized)) return normalized.slice(2, -2).trim();
+	if (isTemplateExpression(normalized)) return normalized.slice(2, -2).trim();
 	return normalized;
 }
 function parseTemplateExpression(expression) {
@@ -12925,7 +12963,7 @@ const loadingPages = /* @__PURE__ */ new WeakSet();
 function isPageBeforeReady(page) {
 	return loadingPages.has(page);
 }
-function runInitialPageLifecycles(page, query, scheduler, isAlive, renderComponents) {
+function runInitialPageLifecycles(page, query, scheduler, isAlive, renderComponents, onReady) {
 	loadingPages.add(page);
 	try {
 		renderComponents?.();
@@ -12940,7 +12978,10 @@ function runInitialPageLifecycles(page, query, scheduler, isAlive, renderCompone
 	scheduler.setTimeout(() => {
 		if (!isAlive()) return;
 		page.onReady?.();
-		if (isAlive()) page.onRouteDone?.({});
+		if (isAlive()) {
+			page.onRouteDone?.({});
+			onReady?.();
+		}
 	}, 0);
 }
 //#endregion
@@ -13006,6 +13047,21 @@ function createPluginArtifactSource(fallback, miniprogramRootPath, plugins) {
 	};
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/view/nodeDataset.ts
+const DATASET_NAME_RE = /-([a-z])/g;
+function isDatasetAttribute(attributeName) {
+	return attributeName.startsWith("data-") && !attributeName.startsWith("data-sim-");
+}
+function toDatasetKey(attributeName) {
+	return attributeName.slice(5).replace(DATASET_NAME_RE, (_match, char) => char.toUpperCase());
+}
+function collectNodeDataset(node) {
+	if (node.dataset) return { ...node.dataset };
+	const dataset = {};
+	for (const [key, value] of Object.entries(node.attribs ?? {})) if (isDatasetAttribute(key)) dataset[toDatasetKey(key)] = value;
+	return dataset;
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/view/eventBinding.ts
 const LEGACY_EVENT_NAME_RE = /^\w+$/;
 const EVENT_BINDING_PREFIXES = [
@@ -13059,7 +13115,34 @@ function collectMiniProgramEventBindings(attributes = {}) {
 function resolveMiniProgramEventBinding(attributes, eventName) {
 	return collectMiniProgramEventBindings(attributes).get(eventName) ?? null;
 }
+/** 冒泡时保留原始 target，currentTarget 则属于当前执行绑定的节点。 */
+function createMiniProgramEventPayload(node, eventName, event, origin = node) {
+	const dataset = collectNodeDataset(node);
+	const nodeId = node.attribs?.id ?? "";
+	const isOrigin = node === origin;
+	return {
+		bubbles: false,
+		capturePhase: false,
+		composed: false,
+		currentTarget: {
+			dataset: isOrigin ? event.currentTarget?.dataset ?? event.dataset ?? dataset : dataset,
+			id: isOrigin ? event.currentTarget?.id ?? event.id ?? nodeId : nodeId
+		},
+		detail: event.detail,
+		mark: event.mark,
+		target: {
+			dataset: event.target?.dataset ?? event.dataset ?? (isOrigin ? dataset : collectNodeDataset(origin)),
+			id: event.target?.id ?? event.id ?? origin.attribs?.id ?? ""
+		},
+		timeStamp: Date.now(),
+		type: eventName
+	};
+}
 const WEVU_NATIVE_INSTANCE_KEY = "__wevuNativeInstance";
+/** 宿主值为 1 时，实现带 routeEventId 的路由阶段契约；不代表微信 SDK 版本。 */
+const WEVU_ROUTE_EVENT_CONTRACT_KEY = "__wevuRouteEventContract";
+/** 宿主负责 pageScrollTo 的实际滚动事件，框架不再合成第二份通知。 */
+const WEVU_PAGE_SCROLL_EVENT_CONTRACT_KEY = "__wevuPageScrollEventContract";
 //#endregion
 //#region ../../mpcore/packages/simulator/src/view/selectorQueryScope.ts
 const MPCORE_COMPONENT_SCOPE_ID = "__mpcoreComponentScopeId";
@@ -13168,21 +13251,6 @@ function resolveMiniProgramComponent(ownerFilePath, request, miniprogramRootPath
 	return npmPath ? relative(miniprogramRootPath, npmPath).slice(0, -3) : localPath;
 }
 //#endregion
-//#region ../../mpcore/packages/simulator/src/view/nodeDataset.ts
-const DATASET_NAME_RE = /-([a-z])/g;
-function isDatasetAttribute(attributeName) {
-	return attributeName.startsWith("data-") && !attributeName.startsWith("data-sim-");
-}
-function toDatasetKey(attributeName) {
-	return attributeName.slice(5).replace(DATASET_NAME_RE, (_match, char) => char.toUpperCase());
-}
-function collectNodeDataset(node) {
-	if (node.dataset) return { ...node.dataset };
-	const dataset = {};
-	for (const [key, value] of Object.entries(node.attribs ?? {})) if (isDatasetAttribute(key)) dataset[toDatasetKey(key)] = value;
-	return dataset;
-}
-//#endregion
 //#region ../../mpcore/packages/simulator/src/view/templateImports.ts
 function createImportedTemplateState(root, filePath, loadImport, loadWxs) {
 	const documents = /* @__PURE__ */ new Map();
@@ -13234,12 +13302,15 @@ function createImportedTemplateState(root, filePath, loadImport, loadWxs) {
 }
 //#endregion
 //#region ../../mpcore/packages/simulator/src/view/templateText.ts
-const TEMPLATE_INTERPOLATION_RE$2 = /\{\{([^{}]+)\}\}/g;
-function interpolateTemplateText(input, data) {
-	return input.replace(TEMPLATE_INTERPOLATION_RE$2, (_match, expression) => {
-		const value = resolveTemplateExpression(data, expression);
-		return value === void 0 ? "" : String(value);
-	});
+function interpolateTemplateText(input, data, emptyNull = false) {
+	let output = "";
+	let offset = 0;
+	for (const range of templateInterpolations(input)) {
+		const value = resolveTemplateExpression(data, range.expression);
+		output += input.slice(offset, range.start) + (value === void 0 || emptyNull && value === null ? "" : String(value));
+		offset = range.end;
+	}
+	return output + input.slice(offset);
 }
 //#endregion
 //#region ../../node_modules/.pnpm/entities@8.1.0/node_modules/entities/dist/decode-codepoint.js
@@ -17015,20 +17086,76 @@ function parseDocument(data, options) {
 	return handler.root;
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/view/templateAttributes.ts
+function decodeAttribute(raw, quote) {
+	const source = raw.replaceAll(`\\${quote}`, quote);
+	let value = "";
+	let offset = 0;
+	for (const range of templateInterpolations(source)) {
+		value += source.slice(offset, range.start).replace(/\\([\s\S])/g, "$1");
+		value += source.slice(range.start, range.end);
+		offset = range.end;
+	}
+	return value + source.slice(offset).replace(/\\([\s\S])/g, "$1");
+}
+/** 先保存 WXML 属性词法值，再交给 HTML parser 构建标签树，避免反斜杠引号提前截断属性。 */
+function maskTemplateAttributes(source) {
+	const attributes = /* @__PURE__ */ new Map();
+	if (!source.includes("\\")) return {
+		source,
+		attributes
+	};
+	let prefix = "__mpcore_quoted_attribute_";
+	while (source.includes(prefix)) prefix += "_";
+	let output = "";
+	let offset = 0;
+	for (let i = 0; i < source.length; i++) {
+		if (source.startsWith("<!--", i)) {
+			const end = source.indexOf("-->", i + 4);
+			i = end < 0 ? source.length : end + 2;
+			continue;
+		}
+		if (source[i] !== "<" || !/[a-z_]/i.test(source[i + 1] ?? "")) continue;
+		for (i++; i < source.length && source[i] !== ">"; i++) {
+			if (source[i] !== "\"" && source[i] !== "'") continue;
+			const quote = source[i];
+			const start = i + 1;
+			for (i++; i < source.length && source[i] !== quote; i++) if (source[i] === "\\") i++;
+			if (i >= source.length) break;
+			const raw = source.slice(start, i);
+			if (!raw.includes("\\")) continue;
+			const token = `${prefix}${attributes.size}`;
+			attributes.set(token, decodeAttribute(raw, quote));
+			output += source.slice(offset, start) + token;
+			offset = i;
+		}
+	}
+	return {
+		source: output + source.slice(offset),
+		attributes
+	};
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/view/wxsDocument.ts
 const INLINE_WXS_RE = /<wxs\b([^>]*)(?<!\/)>([\s\S]*?)<\/wxs\s*>/g;
 function parseWxsTemplateDocument(templateSource) {
 	const scripts = [];
-	const document = parseDocument(`<page>${templateSource.replace(INLINE_WXS_RE, (_match, attributes, script) => {
+	const masked = maskTemplateAttributes(templateSource.replace(INLINE_WXS_RE, (_match, attributes, script) => {
 		return `<wxs data-sim-wxs="${scripts.push(script) - 1}"${attributes}>wxs-source</wxs>`;
-	})}</page>`, {
+	}));
+	const document = parseDocument(`<page>${masked.source}</page>`, {
 		xmlMode: false,
 		decodeEntities: false,
 		lowerCaseAttributeNames: false,
 		lowerCaseTags: false,
 		recognizeSelfClosing: true
 	});
+	if (!scripts.length && !masked.attributes.size) return document;
+	const hasAttributes = masked.attributes.size > 0;
 	const restore = (node) => {
+		if (hasAttributes && node.attribs) {
+			for (const [name, token] of Object.entries(node.attribs)) if (masked.attributes.has(token)) node.attribs[name] = masked.attributes.get(token);
+		}
 		if (node.name === "wxs" && Object.hasOwn(node.attribs ?? {}, "data-sim-wxs")) {
 			node.children[0].data = scripts[Number(node.attribs["data-sim-wxs"])];
 			delete node.attribs["data-sim-wxs"];
@@ -17040,7 +17167,6 @@ function parseWxsTemplateDocument(templateSource) {
 }
 //#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/render/shared.ts
-const TEMPLATE_INTERPOLATION_RE$1 = /\{\{([^{}]+)\}\}/g;
 const LEADING_SLASH_RE$4 = /^\/+/;
 const EVENT_BINDING_ATTRS = [
 	"bindtap",
@@ -17060,8 +17186,7 @@ const STRUCTURAL_ATTRS = [
 const CLASS_SPLIT_RE = /\s+/;
 const JS_FILE_RE = /\.js$/;
 function isMustacheOnly$1(value) {
-	const trimmed = value.trim();
-	return trimmed.startsWith("{{") && trimmed.endsWith("}}") && !trimmed.includes("{{", 2);
+	return isTemplateExpression(value);
 }
 function collectDataset(node, source) {
 	if (node.dataset) return collectNodeDataset(node);
@@ -17086,17 +17211,11 @@ function cloneNode(node) {
 		children: node.children?.map((child) => cloneNode(child))
 	};
 }
-function resolveValueByPath$1(source, expression) {
-	return resolveTemplateExpression(source, expression) ?? "";
-}
 function resolveRawValueByPath$1(source, expression) {
 	return resolveTemplateExpression(source, expression);
 }
 function interpolateTemplate$1(input, data) {
-	return input.replace(TEMPLATE_INTERPOLATION_RE$1, (_match, expression) => {
-		const value = resolveValueByPath$1(data, expression);
-		return typeof value === "string" ? value : String(value);
-	});
+	return interpolateTemplateText(input, data, true);
 }
 function readTemplateSource(artifactSource, filePath) {
 	const source = artifactSource.readText(filePath);
@@ -17223,7 +17342,7 @@ function resolveUsingComponents(context, ownerJsonPath, ownerFilePath) {
 		return /* @__PURE__ */ new Map();
 	}
 }
-function resolveComponentGenerics(context, hostNode, ownerJsonPath, ownerFilePath, componentFilePath) {
+function resolveComponentGenerics(context, hostNode, ownerJsonPath, ownerFilePath, componentFilePath, ownerGenerics) {
 	const componentJsonPath = path.resolve(context.project.miniprogramRootPath, `${componentFilePath.replace(JS_FILE_RE, "")}.json`);
 	const componentGenerics = readComponentConfig(context.artifactSource, componentJsonPath).componentGenerics;
 	if (!componentGenerics || typeof componentGenerics !== "object" || Array.isArray(componentGenerics)) return;
@@ -17231,7 +17350,7 @@ function resolveComponentGenerics(context, hostNode, ownerJsonPath, ownerFilePat
 	const resolved = /* @__PURE__ */ new Map();
 	for (const [genericName, definition] of Object.entries(componentGenerics)) {
 		const selectedAlias = hostNode.attribs?.[`generic:${genericName}`];
-		const selectedPath = selectedAlias ? ownerComponents.get(selectedAlias) : void 0;
+		const selectedPath = selectedAlias ? ownerGenerics?.get(selectedAlias) ?? ownerComponents.get(selectedAlias) : void 0;
 		if (selectedPath) {
 			resolved.set(genericName, selectedPath);
 			continue;
@@ -17293,8 +17412,9 @@ function syncComponentProperties(instance, definition, nextProperties, bindingEx
 		const previousSnapshot = instance.__propertySnapshots?.[key];
 		if (hasComponentPropertyValueChanged(instance.properties[key], previousSnapshot, nextValue, bindingAffected)) {
 			previousProperties[key] = instance.properties[key];
-			instance.properties[key] = nextValue;
-			if (Object.hasOwn(definition.properties ?? {}, key)) instance.data[key] = nextValue;
+			const deliveredValue = cloneValue$1(nextValue);
+			instance.properties[key] = deliveredValue;
+			if (Object.hasOwn(definition.properties ?? {}, key)) instance.data[key] = deliveredValue;
 			changedRootKeys.push(key);
 		}
 		instance.__propertySnapshots ??= {};
@@ -17492,7 +17612,7 @@ function renderNodeTree(node, scope, context, ownerJsonPath, ownerFilePath, inst
 		const componentScopeId = `${instancePath}/${clonedNode.name}`;
 		const ownerScopeId = scope.getScopeId().includes("/") ? scope.getScopeId() : void 0;
 		const { nextProperties, bindingExpressions } = resolveComponentProperties(clonedNode, scope, componentEntry.definition);
-		const genericComponents = resolveComponentGenerics(context, clonedNode, ownerJsonPath, ownerFilePath, componentEntry.filePath);
+		const genericComponents = resolveComponentGenerics(context, clonedNode, ownerJsonPath, ownerFilePath, componentEntry.filePath, scope.genericComponents);
 		const slots = collectComponentSlots(clonedNode, scope, ownerJsonPath, ownerFilePath, componentScopeId, templateRenderState);
 		let componentInstance = context.componentCache.get(componentScopeId);
 		if (!componentInstance) componentInstance = createRuntimeComponentInstance(componentScopeId, context, clonedNode, componentEntry, nextProperties, ownerScopeId, (instance) => {
@@ -17775,7 +17895,13 @@ var StartupNavigationQueue = class {
 		}
 	}
 	run(option, operation) {
-		if (!this.collecting) return operation(option);
+		if (!this.collecting) {
+			const submitted = option && { ...option };
+			this.scheduler.queueMicrotask(() => {
+				this.scheduler.setTimeout(() => operation(submitted), 0);
+			});
+			return;
+		}
 		const defer = (callback) => callback ? (...args) => {
 			this.scheduler.setTimeout(() => callback(...args), 0);
 		} : void 0;
@@ -18034,6 +18160,14 @@ function createHeadlessWx(driver, runtimeConsole = console) {
 		navigateBack: true,
 		navigateTo: true,
 		nextTick: true,
+		offBeforeAppRoute: true,
+		offBeforePageUnload: true,
+		offAppRoute: true,
+		offAppRouteDone: true,
+		onBeforeAppRoute: true,
+		onBeforePageUnload: true,
+		onAppRoute: true,
+		onAppRouteDone: true,
 		offAppHide: true,
 		offAppShow: true,
 		offNetworkStatusChange: true,
@@ -18081,6 +18215,8 @@ function createHeadlessWx(driver, runtimeConsole = console) {
 	};
 	return {
 		...eventBus,
+		[WEVU_ROUTE_EVENT_CONTRACT_KEY]: 1,
+		[WEVU_PAGE_SCROLL_EVENT_CONTRACT_KEY]: 1,
 		canIUse: (schema) => typeof schema === "string" && schema.trim() !== "" && resolveCapabilityValue(capabilityTree, schema.trim()) != null,
 		canvasToTempFilePath: (option) => invokeWxApi(() => driver.canvasToTempFilePath(option), option),
 		chooseImage: (option) => invokeWxApi(() => driver.chooseImage(option ?? {}), option),
@@ -18208,6 +18344,14 @@ function createHeadlessWx(driver, runtimeConsole = console) {
 			driver.navigateTo(deferred);
 		}, deferred)),
 		nextTick: (callback) => driver.nextTick(callback),
+		offBeforeAppRoute: (listener) => driver.offBeforeAppRoute(listener),
+		offBeforePageUnload: (listener) => driver.offBeforePageUnload(listener),
+		offAppRoute: (listener) => driver.offAppRoute(listener),
+		offAppRouteDone: (listener) => driver.offAppRouteDone(listener),
+		onBeforeAppRoute: (listener) => driver.onBeforeAppRoute(listener),
+		onBeforePageUnload: (listener) => driver.onBeforePageUnload(listener),
+		onAppRoute: (listener) => driver.onAppRoute(listener),
+		onAppRouteDone: (listener) => driver.onAppRouteDone(listener),
 		offAppHide: (callback) => driver.offAppHide(callback),
 		offAppShow: (callback) => driver.offAppShow(callback),
 		offNetworkStatusChange: (callback) => driver.offNetworkStatusChange(callback),
@@ -18367,6 +18511,7 @@ var RuntimeScheduler = class {
 	intervals = /* @__PURE__ */ new Set();
 	timeouts = /* @__PURE__ */ new Set();
 	closed = false;
+	canceledHandle;
 	onError;
 	constructor(onError) {
 		this.onError = onError;
@@ -18388,7 +18533,7 @@ var RuntimeScheduler = class {
 		this.timeouts.clear();
 	}
 	queueMicrotask(handler) {
-		if (this.closed) throw new Error("Cannot schedule work after the runtime session has closed.");
+		if (this.closed) return;
 		queueMicrotask(() => {
 			if (this.closed) return;
 			try {
@@ -18399,7 +18544,7 @@ var RuntimeScheduler = class {
 		});
 	}
 	setInterval(handler, timeout, ...args) {
-		if (this.closed) throw new Error("Cannot schedule work after the runtime session has closed.");
+		if (this.closed) return this.getCanceledHandle();
 		const handle = setInterval(() => {
 			try {
 				handler(...args);
@@ -18411,7 +18556,7 @@ var RuntimeScheduler = class {
 		return handle;
 	}
 	setTimeout(handler, timeout, ...args) {
-		if (this.closed) throw new Error("Cannot schedule work after the runtime session has closed.");
+		if (this.closed) return this.getCanceledHandle();
 		const handle = setTimeout(() => {
 			this.timeouts.delete(handle);
 			try {
@@ -18423,6 +18568,14 @@ var RuntimeScheduler = class {
 		this.timeouts.add(handle);
 		return handle;
 	}
+	/** 已销毁 realm 的 Promise 回调不能复活任务，也不能向外泄漏异步拒绝。 */
+	getCanceledHandle() {
+		if (!this.canceledHandle) {
+			this.canceledHandle = setTimeout(() => {}, 0);
+			clearTimeout(this.canceledHandle);
+		}
+		return this.canceledHandle;
+	}
 };
 //#endregion
 //#region ../../mpcore/packages/simulator/src/kernel/runtimeKernel.ts
@@ -37922,27 +38075,6 @@ function queryXPathElements(root, expression) {
 function escapeText$1(text) {
 	return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 }
-function createEventPayload$1(node, eventName, event) {
-	const dataset = collectNodeDataset(node);
-	const nodeId = node.attribs?.id ?? "";
-	return {
-		bubbles: false,
-		capturePhase: false,
-		composed: false,
-		currentTarget: {
-			dataset: event.currentTarget?.dataset ?? event.dataset ?? dataset,
-			id: event.currentTarget?.id ?? event.id ?? nodeId
-		},
-		detail: event.detail,
-		mark: event.mark,
-		target: {
-			dataset: event.target?.dataset ?? event.dataset ?? dataset,
-			id: event.target?.id ?? event.id ?? nodeId
-		},
-		timeStamp: Date.now(),
-		type: eventName
-	};
-}
 function createValueEventDetail(value, detail) {
 	return {
 		value,
@@ -38052,9 +38184,18 @@ var HeadlessTestingNodeHandle = class HeadlessTestingNodeHandle {
 		if (!this.interactions) throw new Error("Node interactions are not available for this headless testing node.");
 		const normalizedEventName = eventName.trim();
 		if (!normalizedEventName) throw new Error("Event name must be a non-empty string in headless testing runtime.");
+		let handlerResults;
+		const nativeHandled = this.interactions.dispatchNativeEvent?.(this.node, normalizedEventName, event, normalizedEventName === "tap" ? (result) => {
+			handlerResults ??= [];
+			handlerResults.push(result);
+		} : void 0);
+		if (normalizedEventName === "tap" && nativeHandled) return handlerResults ? (await Promise.all(handlerResults))[0] : void 0;
 		const binding = resolveMiniProgramEventBinding(this.node.attribs, normalizedEventName);
-		if (!binding?.method) throw new Error(`No ${normalizedEventName} binding was found on <${this.node.name ?? "unknown"}> in headless testing runtime.`);
-		return await this.interactions.callMethod(this.node.attribs?.["data-sim-scope"] ?? null, binding.method, createEventPayload$1(this.node, normalizedEventName, event));
+		if (!binding?.method) {
+			if (nativeHandled) return;
+			throw new Error(`No ${normalizedEventName} binding was found on <${this.node.name ?? "unknown"}> in headless testing runtime.`);
+		}
+		return await this.interactions.callMethod(this.node.attribs?.["data-sim-scope"] ?? null, binding.method, createMiniProgramEventPayload(this.node, normalizedEventName, event));
 	}
 	async tap(event = {}) {
 		return await this.trigger("tap", event);
@@ -38161,35 +38302,9 @@ function renderPageTree(project, page) {
 	};
 }
 //#endregion
-//#region ../../mpcore/packages/simulator/src/view/selectorQuery.ts
-const LEADING_MARK_PREFIX_RE = /^mark[:\-]?/;
-const MARK_NAME_RE = /[:\-]([a-z])/g;
+//#region ../../mpcore/packages/simulator/src/view/nodeGeometry.ts
 const NUMERIC_LIKE_VALUE_RE$1 = /-?\d+(?:\.\d+)?/;
-function toMarkKey(attributeName) {
-	return attributeName.replace(LEADING_MARK_PREFIX_RE, "").replace(MARK_NAME_RE, (_match, char) => char.toUpperCase());
-}
-function collectMark(node) {
-	const mark = {};
-	for (const [key, value] of Object.entries(node.attribs ?? {})) {
-		if (!(key.startsWith("mark:") || key.startsWith("mark-"))) continue;
-		mark[toMarkKey(key)] = value;
-	}
-	return mark;
-}
-function createScopedRoot(node) {
-	return {
-		children: [node],
-		type: "root"
-	};
-}
-function findNodeByScopeId(root, scopeId) {
-	if (root.attribs?.["data-sim-scope"] === scopeId) return root;
-	for (const child of root.children ?? []) {
-		const match = findNodeByScopeId(child, scopeId);
-		if (match) return match;
-	}
-	return null;
-}
+const PIXEL_LENGTH_RE = /^\d+(?:\.\d+)?px$|^0$/;
 function parseStyleDeclarations$1(styleValue) {
 	const declarations = {};
 	if (!styleValue) return declarations;
@@ -38224,18 +38339,229 @@ function resolveRect$1(node, windowInfo) {
 		width
 	};
 }
+/** 仅支持显式 px 视口和单个 view 内容盒；未知样式布局不作为已测量滚动范围。 */
+function resolveNativeScrollBounds(node) {
+	const viewport = parseStyleDeclarations$1(node.attribs?.style);
+	let content;
+	const visit = (parent) => {
+		for (const child of parent.children ?? []) {
+			if (child.type === "comment" || child.type === "text" && !child.data?.trim()) continue;
+			if (child.name === "block") {
+				if (!visit(child)) return false;
+			} else {
+				if (content || child.name !== "view") return false;
+				content = child;
+			}
+		}
+		return true;
+	};
+	if (!visit(node)) return {
+		maxTop: 0,
+		maxLeft: 0
+	};
+	const box = parseStyleDeclarations$1(content?.attribs?.style);
+	const supported = content && !viewport.display && !box.display && !box.position && !box.transform;
+	const extent = (dimension) => {
+		const viewportValue = viewport[dimension];
+		const contentValue = box[dimension];
+		if (!supported || !viewportValue || !contentValue || !PIXEL_LENGTH_RE.test(viewportValue) || !PIXEL_LENGTH_RE.test(contentValue)) return 0;
+		const size = parseNumericLikeValue$1(viewportValue);
+		const contentSize = parseNumericLikeValue$1(contentValue);
+		return size > 0 && Number.isFinite(size) && Number.isFinite(contentSize) ? Math.max(0, contentSize - size) : 0;
+	};
+	return {
+		maxTop: extent("height"),
+		maxLeft: extent("width")
+	};
+}
+//#endregion
+//#region ../../mpcore/packages/simulator/src/view/nativeNode.ts
+const pageScrollViews = /* @__PURE__ */ new WeakMap();
+function coordinate(value) {
+	const number = Number(value);
+	return Number.isFinite(number) ? Math.max(0, number) : 0;
+}
+function nodeKey(node) {
+	return node.attribs?.["data-sim-node"] ?? "";
+}
+/** 原生滚动位置独立于绑定值；未改变的绑定不能覆盖用户滚动。 */
+function syncNativeScrollViews(page, root, emit) {
+	let states = pageScrollViews.get(page);
+	let present;
+	const visit = (node) => {
+		if (node.name === "scroll-view") {
+			const key = nodeKey(node);
+			present ??= /* @__PURE__ */ new Set();
+			present.add(key);
+			if (!states) {
+				states = /* @__PURE__ */ new Map();
+				pageScrollViews.set(page, states);
+			}
+			const boundTop = coordinate(node.attribs?.["scroll-top"]);
+			const boundLeft = coordinate(node.attribs?.["scroll-left"]);
+			const bounds = resolveNativeScrollBounds(node);
+			const scrollY = node.attribs?.["scroll-y"];
+			const scrollX = node.attribs?.["scroll-x"];
+			const maxTop = scrollY !== void 0 && scrollY !== "false" && scrollY !== "0" ? bounds.maxTop : 0;
+			const maxLeft = scrollX !== void 0 && scrollX !== "false" && scrollX !== "0" ? bounds.maxLeft : 0;
+			let state = states.get(key);
+			const previousTop = state?.scrollTop ?? 0;
+			const previousLeft = state?.scrollLeft ?? 0;
+			if (!state) {
+				state = {
+					boundTop,
+					boundLeft,
+					scrollTop: boundTop,
+					scrollLeft: boundLeft,
+					maxTop,
+					maxLeft
+				};
+				states.set(key, state);
+			} else {
+				if (state.boundTop !== boundTop) {
+					state.scrollTop = boundTop;
+					state.boundTop = boundTop;
+				}
+				if (state.boundLeft !== boundLeft) {
+					state.scrollLeft = boundLeft;
+					state.boundLeft = boundLeft;
+				}
+			}
+			state.maxTop = maxTop;
+			state.maxLeft = maxLeft;
+			state.scrollTop = Math.min(state.scrollTop, maxTop);
+			state.scrollLeft = Math.min(state.scrollLeft, maxLeft);
+			if (state.scrollTop !== previousTop || state.scrollLeft !== previousLeft) {
+				const binding = resolveMiniProgramEventBinding(node.attribs, "scroll");
+				if (binding?.method) {
+					const target = {
+						id: node.attribs?.id ?? "",
+						dataset: collectNodeDataset(node)
+					};
+					emit(node.attribs?.["data-sim-scope"] ?? null, binding.method, {
+						type: "scroll",
+						timeStamp: Date.now(),
+						detail: {
+							scrollTop: state.scrollTop,
+							scrollLeft: state.scrollLeft
+						},
+						target,
+						currentTarget: target
+					});
+				}
+			}
+		}
+		for (const child of node.children ?? []) visit(child);
+	};
+	visit(root);
+	if (states) {
+		for (const key of states.keys()) if (!present?.has(key)) states.delete(key);
+	}
+}
+function getNativeScrollOffset(page, node) {
+	const state = pageScrollViews.get(page)?.get(nodeKey(node));
+	return {
+		scrollTop: state?.scrollTop ?? 0,
+		scrollLeft: state?.scrollLeft ?? 0
+	};
+}
+/** 原生交互更新宿主状态，导航仍交给统一 wx 路由入口。 */
+function dispatchNativeNodeEvent(page, node, eventName, event, wx, resolveMethod, onHandlerResult) {
+	if (eventName === "scroll" && node.name === "scroll-view") {
+		const detail = event.detail;
+		const state = pageScrollViews.get(page)?.get(nodeKey(node));
+		if (state) {
+			if (detail?.scrollTop !== void 0) state.scrollTop = Math.min(coordinate(detail.scrollTop), state.maxTop);
+			if (detail?.scrollLeft !== void 0) state.scrollLeft = Math.min(coordinate(detail.scrollLeft), state.maxLeft);
+		}
+		event.detail = Object.assign(event.detail && typeof event.detail === "object" ? event.detail : {}, getNativeScrollOffset(page, node));
+		return true;
+	}
+	if (eventName !== "tap") return false;
+	let current = node;
+	let navigator;
+	let handlers;
+	let handled = false;
+	while (current) {
+		if (!navigator && current.name === "navigator") navigator = current;
+		const binding = resolveMiniProgramEventBinding(current.attribs, "tap");
+		if (binding?.method) {
+			const call = resolveMethod(current.attribs?.["data-sim-scope"] ?? null, binding.method);
+			handlers ??= [];
+			handlers.push({
+				node: current,
+				call
+			});
+			handled = true;
+		}
+		if (binding?.stopAfter) {
+			handled = true;
+			break;
+		}
+		current = current.parent;
+	}
+	if (handlers) for (const handler of handlers) {
+		const result = handler.call(createMiniProgramEventPayload(handler.node, "tap", event, node));
+		onHandlerResult?.(result);
+	}
+	if (!navigator) return handled;
+	const openType = navigator.attribs?.["open-type"] ?? "navigate";
+	const url = navigator.attribs?.url ?? "";
+	switch (openType) {
+		case "navigate":
+			wx.navigateTo({ url });
+			break;
+		case "redirect":
+			wx.redirectTo({ url });
+			break;
+		case "switchTab":
+			wx.switchTab({ url });
+			break;
+		case "reLaunch":
+			wx.reLaunch({ url });
+			break;
+		case "navigateBack":
+			wx.navigateBack({ delta: Number(navigator.attribs?.delta ?? 1) });
+			break;
+		default: return handled;
+	}
+	return true;
+}
+//#endregion
+//#region ../../mpcore/packages/simulator/src/view/selectorQuery.ts
+const LEADING_MARK_PREFIX_RE = /^mark[:\-]?/;
+const MARK_NAME_RE = /[:\-]([a-z])/g;
+function toMarkKey(attributeName) {
+	return attributeName.replace(LEADING_MARK_PREFIX_RE, "").replace(MARK_NAME_RE, (_match, char) => char.toUpperCase());
+}
+function collectMark(node) {
+	const mark = {};
+	for (const [key, value] of Object.entries(node.attribs ?? {})) {
+		if (!(key.startsWith("mark:") || key.startsWith("mark-"))) continue;
+		mark[toMarkKey(key)] = value;
+	}
+	return mark;
+}
+function createScopedRoot(node) {
+	return {
+		children: [node],
+		type: "root"
+	};
+}
+function findNodeByScopeId(root, scopeId) {
+	if (root.attribs?.["data-sim-scope"] === scopeId) return root;
+	for (const child of root.children ?? []) {
+		const match = findNodeByScopeId(child, scopeId);
+		if (match) return match;
+	}
+	return null;
+}
 function resolveSelectorScrollTop(root, selector) {
 	const normalizedSelector = selector?.trim();
 	if (!normalizedSelector) return null;
 	const match = querySelectorAll(root, normalizedSelector)[0];
 	return match ? resolveRect$1(match).top : null;
 }
-function resolveScrollOffset(node) {
-	return {
-		scrollLeft: parseNumericLikeValue$1(node.attribs?.["data-sim-scroll-left"]),
-		scrollTop: parseNumericLikeValue$1(node.attribs?.["data-sim-scroll-top"])
-	};
-}
 function resolvePropertyValue(node, propertyName) {
 	const normalizedPropertyName = propertyName.trim();
 	if (!normalizedPropertyName) return;
@@ -38268,7 +38594,7 @@ function resolveFieldsResult(node, fields, options) {
 			result.height = rect.height;
 		}
 	}
-	if (fields.scrollOffset) Object.assign(result, resolveScrollOffset(node));
+	if (fields.scrollOffset) Object.assign(result, getNativeScrollOffset(options.page, node));
 	if (Array.isArray(fields.properties) && fields.properties.length > 0) Object.assign(result, pickProperties(node, fields.properties));
 	if (Array.isArray(fields.computedStyle) && fields.computedStyle.length > 0) Object.assign(result, pickComputedStyle(node, fields.computedStyle));
 	if (fields.context) result.context = options.resolveContext?.(node) ?? { type: "unsupported-context" };
@@ -39359,6 +39685,99 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
 	return loader;
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/runtime/packageAsset.ts
+const assetExtension = /\.(?:png|jpe?g|gif|svg|cer|mp3|aac|m4a|mp4|wav|ogg|silk|wasm|br|cur|ico|skel|crt|cert|gltf|glb|bin|ktx|hdr|exr|xnet|pem)$/i;
+/** 包内静态资源只读且每次访问宿主当前产物，不缓存为用户文件，也不允许越过包根目录。 */
+function createPackageAssetReader(read) {
+	return (filePath) => {
+		if (filePath.includes("\\") || filePath.includes(":") || filePath.includes("\0")) return;
+		const relative = posix.normalize(filePath.replace(/^\/+/, ""));
+		if (relative === ".." || relative.startsWith("../") || !assetExtension.test(relative)) return;
+		return read(relative);
+	};
+}
+//#endregion
+//#region ../../mpcore/packages/simulator/src/runtime/routeEvents.ts
+/** 两种模拟器共用路由身份与监听状态，完成事件由页面就绪和宿主提交驱动。 */
+var HeadlessRouteEvents = class {
+	requestRender;
+	isCurrentPage;
+	bus = createHeadlessUniEventBus();
+	pages = /* @__PURE__ */ new WeakMap();
+	nextRouteId = 0;
+	nextWebviewId = 0;
+	activeEvent;
+	constructor(requestRender, isCurrentPage) {
+		this.requestRender = requestRender;
+		this.isCurrentPage = isCurrentPage;
+	}
+	on(name, listener) {
+		this.bus.$on(name, listener);
+	}
+	off(name, listener) {
+		this.bus.$off(name, listener);
+	}
+	begin(path, query, openType, renderer, page) {
+		const previous = page ? this.pages.get(page) : void 0;
+		const event = {
+			path,
+			query: { ...query },
+			openType: this.nextRouteId === 0 ? "appLaunch" : openType,
+			renderer: previous?.event.renderer ?? (renderer === "skyline" || renderer === "xr-frame" ? renderer : "webview"),
+			routeEventId: String(++this.nextRouteId),
+			webviewId: previous?.webviewId ?? ++this.nextWebviewId,
+			timeStamp: Date.now()
+		};
+		this.activeEvent = event;
+		this.bus.$emit("beforeAppRoute", event);
+		return event;
+	}
+	attach(page, event) {
+		const state = this.pages.get(page);
+		this.pages.set(page, {
+			webviewId: event.webviewId,
+			ready: state?.ready ?? false,
+			event,
+			committed: false
+		});
+	}
+	commit(page, event) {
+		const state = this.pages.get(page);
+		if (!state || state.event !== event || this.activeEvent !== event || !this.isCurrentPage(page)) return;
+		state.committed = true;
+		this.bus.$emit("appRoute", event);
+		if (state.ready) this.complete(page, state);
+	}
+	ready(page) {
+		const state = this.pages.get(page);
+		if (!state) return;
+		state.ready = true;
+		if (state.committed) this.complete(page, state);
+	}
+	complete(page, state) {
+		this.requestRender(() => {
+			if (this.pages.get(page) !== state || this.activeEvent !== state.event || !this.isCurrentPage(page)) return;
+			this.bus.$emit("appRouteDone", state.event);
+		});
+	}
+	beforeUnload(page, event) {
+		const state = this.pages.get(page);
+		if (event && state) this.bus.$emit("beforePageUnload", {
+			...event,
+			path: page.route,
+			query: { ...page.options },
+			renderer: state.event.renderer,
+			webviewId: state.webviewId,
+			page
+		});
+		this.pages.delete(page);
+	}
+	close() {
+		this.activeEvent = void 0;
+		this.bus.$off();
+	}
+};
+//#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/systemInfo.ts
 function createDefaultLocationResult() {
 	return {
@@ -40153,7 +40572,7 @@ function createHeadlessWxState(scheduler = nativeScheduler, options = {}) {
 	const readFile = (filePath, encoding) => {
 		normalizeEncoding(encoding);
 		const normalizedPath = normalizeFsPath(filePath);
-		const fileContent = files.get(normalizedPath);
+		const fileContent = files.get(normalizedPath) ?? options.readPackageFile?.(normalizedPath);
 		if (fileContent == null) throw new Error(`readFile:fail no such file or directory, open '${normalizedPath}'`);
 		return {
 			data: fileContent,
@@ -41201,6 +41620,7 @@ var HeadlessSession = class {
 	appInstance = null;
 	appLifecycle = new HeadlessAppLifecycle();
 	moduleLoader;
+	routeEvents = new HeadlessRouteEvents((callback) => this.requestRender(callback), (page) => this.currentPageInstance === page && !this.kernel.isClosed);
 	eventListeners = /* @__PURE__ */ new Map();
 	registries;
 	currentPageInstance = null;
@@ -41228,7 +41648,10 @@ var HeadlessSession = class {
 	constructor(options) {
 		if (!options.project && !options.projectPath) throw new Error("Headless runtime requires projectPath or project.");
 		this.project = options.project ?? loadProject(options.projectPath);
-		this.wxState = createHeadlessWxState(this.kernel.scheduler, { strictMocks: options.strictHostMocks });
+		this.wxState = createHeadlessWxState(this.kernel.scheduler, {
+			strictMocks: options.strictHostMocks,
+			readPackageFile: createPackageAssetReader((relative) => this.project.artifactSource.readText(path.join(this.project.miniprogramRootPath, relative)))
+		});
 		this.registries = createHostRegistries();
 		const rawTabBarList = Array.isArray(this.project.appConfig.tabBar?.list) ? this.project.appConfig.tabBar.list : [];
 		this.tabBarRoutes = /* @__PURE__ */ new Set();
@@ -41295,6 +41718,14 @@ var HeadlessSession = class {
 			saveImageToPhotosAlbum: (option) => this.wxState.saveImageToPhotosAlbum(option),
 			saveVideoToPhotosAlbum: (option) => this.wxState.saveVideoToPhotosAlbum(option),
 			nextTick: (callback) => this.kernel.scheduler.queueMicrotask(() => callback?.()),
+			offBeforeAppRoute: (listener) => this.routeEvents.off("beforeAppRoute", listener),
+			offBeforePageUnload: (listener) => this.routeEvents.off("beforePageUnload", listener),
+			offAppRoute: (listener) => this.routeEvents.off("appRoute", listener),
+			offAppRouteDone: (listener) => this.routeEvents.off("appRouteDone", listener),
+			onBeforeAppRoute: (listener) => this.routeEvents.on("beforeAppRoute", listener),
+			onBeforePageUnload: (listener) => this.routeEvents.on("beforePageUnload", listener),
+			onAppRoute: (listener) => this.routeEvents.on("appRoute", listener),
+			onAppRouteDone: (listener) => this.routeEvents.on("appRouteDone", listener),
 			offAppHide: (callback) => this.appLifecycle.offAppHide(callback),
 			offAppShow: (callback) => this.appLifecycle.offAppShow(callback),
 			offNetworkStatusChange: (callback) => this.wxState.offNetworkStatusChange(callback),
@@ -41347,15 +41778,28 @@ var HeadlessSession = class {
 	}
 	close() {
 		if (this.kernel.isClosed) return;
-		this.unloadAllPages();
+		let failure;
+		try {
+			this.unloadAllPages(void 0, true);
+		} catch (error) {
+			failure = { error };
+		}
 		this.canvasContexts.clear();
 		this.renderRequestCallbacks.length = 0;
 		this.renderRequestPending = false;
 		this.appLifecycle.close();
+		this.routeEvents.close();
 		this.wxState.close();
 		this.moduleLoader.close();
-		this.eventListeners.clear();
 		this.kernel.close();
+		try {
+			this.emit("close");
+		} catch (error) {
+			failure ??= { error };
+		} finally {
+			this.eventListeners.clear();
+		}
+		if (failure) throw failure.error;
 	}
 	getDiagnostics() {
 		return this.kernel.diagnostics.getEntries();
@@ -41372,7 +41816,14 @@ var HeadlessSession = class {
 		if (listeners?.size === 0) this.eventListeners.delete(eventName);
 	}
 	emit(eventName, ...args) {
-		for (const handler of [...this.eventListeners.get(eventName) ?? []]) handler(...args);
+		let failure;
+		for (const handler of [...this.eventListeners.get(eventName) ?? []]) try {
+			handler(...args);
+		} catch (error) {
+			if (eventName !== "close") throw error;
+			failure ??= { error };
+		}
+		if (failure) throw failure.error;
 	}
 	get isClosed() {
 		return this.kernel.isClosed;
@@ -41454,6 +41905,11 @@ var HeadlessSession = class {
 				selectOwnerComponent: (scopeId) => this.selectOwnerComponent(scopeId)
 			}
 		}, current);
+		syncNativeScrollViews(current, rendered.root, (scopeId, method, event) => {
+			this.kernel.scheduler.queueMicrotask(() => {
+				if (this.currentPageInstance === current) this.callScopeMethod(scopeId, method, event);
+			});
+		});
 		const componentScopePrefix = `page:${stripLeadingSlash(current.route)}`;
 		for (const [scopeId, instance] of this.componentCache.entries()) if (scopeId.startsWith(componentScopePrefix)) this.selectorQueryScopeSnapshots.set(instance, {
 			page: current,
@@ -41462,6 +41918,11 @@ var HeadlessSession = class {
 		});
 		return rendered;
 	}
+	dispatchNativeNodeEvent(node, eventName, event, onHandlerResult) {
+		const current = this.requireCurrentPage("dispatchNativeNodeEvent()");
+		if (eventName === "tap") this.renderCurrentPage();
+		return dispatchNativeNodeEvent(current, node, eventName, event, this.moduleLoader.wx, (scopeId, method) => this.resolveScopeMethod(current, scopeId, method), onHandlerResult);
+	}
 	requestRender(callback) {
 		this.assertActive();
 		if (callback) this.renderRequestCallbacks.push(callback);
@@ -41509,21 +41970,27 @@ var HeadlessSession = class {
 	callScopeMethod(scopeId, methodName, event) {
 		const current = this.requireCurrentPage(`scope method "${methodName}"`);
 		this.renderCurrentPage();
-		if (!scopeId || scopeId === `page:${stripLeadingSlash(current.route)}`) {
+		return this.resolveScopeMethod(current, scopeId, methodName)(event);
+	}
+	/** 解析本次交互的实例，后续回调不随重渲染或导航切换所有者。 */
+	resolveScopeMethod(current, scopeId, methodName) {
+		if (!scopeId || scopeId === `page:${stripLeadingSlash(current.route)}`) return (event) => {
 			const method = current[methodName];
 			if (typeof method !== "function") throw new TypeError(`Method "${methodName}" does not exist on headless page ${current.route}.`);
 			return method.call(current, event);
-		}
+		};
 		const instance = this.componentCache.get(scopeId);
 		if (!instance) throw new Error(`Unknown scope "${scopeId}" in headless runtime.`);
-		instance.__lastInteractionEvent__ = {
-			currentTarget: event.currentTarget,
-			mark: event.mark,
-			target: event.target
+		return (event) => {
+			instance.__lastInteractionEvent__ = {
+				currentTarget: event.currentTarget,
+				mark: event.mark,
+				target: event.target
+			};
+			const method = instance[methodName];
+			if (typeof method !== "function") throw new TypeError(`Method "${methodName}" does not exist on headless component scope "${scopeId}".`);
+			return method.call(instance, event);
 		};
-		const method = instance[methodName];
-		if (typeof method !== "function") throw new TypeError(`Method "${methodName}" does not exist on headless component scope "${scopeId}".`);
-		return method.call(instance, event);
 	}
 	callScopeMethodDirect(scopeId, methodName, ...args) {
 		const normalizedScopeId = scopeId.trim();
@@ -41804,11 +42271,13 @@ var HeadlessSession = class {
 		const target = this.resolveNavigationTarget(url);
 		const launchedPage = this.bootstrapNavigation(createAppLaunchOptions(target.normalizedRoute, target.query));
 		if (launchedPage) return launchedPage;
-		this.unloadAllPages();
-		const pageInstance = this.createFreshPage(target);
+		const event = this.beginRoute(target, "reLaunch");
+		this.unloadAllPages(event);
+		const pageInstance = this.createFreshPage(target, event);
 		this.pages.push(pageInstance);
 		this.currentPageInstance = pageInstance;
 		this.runInitialPageLifecycles(pageInstance, target.query);
+		this.routeEvents.commit(pageInstance, event);
 		return pageInstance;
 	}
 	navigateTo(url) {
@@ -41817,12 +42286,14 @@ var HeadlessSession = class {
 		if (launchedPage) return launchedPage;
 		if (this.pages.length >= PAGE_STACK_LIMIT) throw new Error(`Cannot navigateTo() beyond a ${PAGE_STACK_LIMIT}-page stack in headless runtime.`);
 		if (this.isTabBarRoute(target.routeRecord.route)) throw new Error(`wx.navigateTo() cannot open a tabBar page in headless runtime: ${url}`);
+		const event = this.beginRoute(target, "navigateTo");
 		this.currentPageInstance?.onHide?.();
 		if (this.currentPageInstance) this.runPageComponentLifetime(this.currentPageInstance.route, "hide");
-		const pageInstance = this.createFreshPage(target);
+		const pageInstance = this.createFreshPage(target, event);
 		this.pages.push(pageInstance);
 		this.currentPageInstance = pageInstance;
 		this.runInitialPageLifecycles(pageInstance, target.query);
+		this.routeEvents.commit(pageInstance, event);
 		return pageInstance;
 	}
 	redirectTo(url) {
@@ -41830,15 +42301,17 @@ var HeadlessSession = class {
 		const launchedPage = this.bootstrapNavigation(createAppLaunchOptions(target.normalizedRoute, target.query));
 		if (launchedPage) return launchedPage;
 		if (this.isTabBarRoute(target.routeRecord.route)) throw new Error(`wx.redirectTo() cannot open a tabBar page in headless runtime: ${url}`);
+		const event = this.beginRoute(target, "redirectTo");
 		const current = this.currentPageInstance;
 		if (current) {
+			this.unloadPage(current, event);
 			this.pages.pop();
-			this.unloadPage(current);
 		}
-		const pageInstance = this.createFreshPage(target);
+		const pageInstance = this.createFreshPage(target, event);
 		this.pages.push(pageInstance);
 		this.currentPageInstance = pageInstance;
 		this.runInitialPageLifecycles(pageInstance, target.query);
+		this.routeEvents.commit(pageInstance, event);
 		return pageInstance;
 	}
 	navigateBack(delta = 1) {
@@ -41846,12 +42319,17 @@ var HeadlessSession = class {
 		if (launchedPage) return launchedPage;
 		if (this.pages.length <= 1) return this.currentPageInstance;
 		const removableCount = Math.min(Number.isFinite(delta) ? Math.max(1, Math.trunc(delta)) : 1, this.pages.length - 1);
-		const removedPages = this.pages.splice(this.pages.length - removableCount, removableCount);
-		for (const page of removedPages.reverse()) this.unloadPage(page);
-		const nextPage = this.pages.at(-1) ?? null;
+		const nextPage = this.pages[this.pages.length - removableCount - 1];
+		const event = this.routeEvents.begin(nextPage.route, nextPage.options, "navigateBack", void 0, nextPage);
+		this.routeEvents.attach(nextPage, event);
+		for (let index = 0; index < removableCount; index++) {
+			this.unloadPage(this.pages.at(-1), event);
+			this.pages.pop();
+		}
 		this.currentPageInstance = nextPage;
 		nextPage?.onShow?.();
 		if (nextPage) this.runPageComponentLifetime(nextPage.route, "show");
+		this.routeEvents.commit(nextPage, event);
 		return nextPage;
 	}
 	switchTab(url) {
@@ -41869,6 +42347,8 @@ var HeadlessSession = class {
 		const current = this.currentPageInstance;
 		const cachedTarget = this.tabPages.get(target.routeRecord.route) ?? null;
 		if (current === cachedTarget && current) return () => {};
+		const event = this.beginRoute(target, "switchTab", cachedTarget ?? void 0);
+		if (cachedTarget) this.routeEvents.attach(cachedTarget, event);
 		if (current && current !== cachedTarget) {
 			current.onHide?.();
 			this.runPageComponentLifetime(current.route, "hide");
@@ -41878,7 +42358,7 @@ var HeadlessSession = class {
 		let nextPage = cachedTarget;
 		let shouldRunInitialLifecycles = false;
 		if (!nextPage) {
-			nextPage = this.createFreshPage(target);
+			nextPage = this.createFreshPage(target, event);
 			this.tabPages.set(target.routeRecord.route, nextPage);
 			shouldRunInitialLifecycles = true;
 		}
@@ -41891,7 +42371,8 @@ var HeadlessSession = class {
 			this.runPageComponentLifetime(nextPage.route, "show");
 		}
 		return () => {
-			for (const page of pagesToUnload) this.unloadPage(page);
+			for (const page of pagesToUnload) this.unloadPage(page, event);
+			this.routeEvents.commit(nextPage, event);
 		};
 	}
 	pageScrollTo(option) {
@@ -41986,17 +42467,20 @@ var HeadlessSession = class {
 			windowInfo: this.getWindowInfo()
 		});
 	}
-	createFreshPage(target) {
+	beginRoute(target, openType, page) {
+		return this.routeEvents.begin(target.normalizedRoute, target.query, openType, target.pageConfig?.renderer ?? this.project.appConfig.renderer, page);
+	}
+	createFreshPage(target, event) {
 		const resourcePath = target.routeRecord.resourcePath ?? target.routeRecord.route;
 		const pageModulePath = path.resolve(this.project.miniprogramRootPath, `${resourcePath}.js`);
-		const pageConfigPath = path.resolve(this.project.miniprogramRootPath, `${resourcePath}.json`);
 		const pageDefinition = this.moduleLoader.executePageModule(pageModulePath, target.routeRecord.route);
-		const pageConfig = readJsonObject(this.project, pageConfigPath);
+		const pageConfig = target.pageConfig;
 		const pageInstance = createPageInstance(`/${target.routeRecord.route}`, pageDefinition, target.query, {
 			background: resolveBackgroundSnapshot(this.project.appConfig, pageConfig),
 			navigationBar: resolveNavigationBarSnapshot(this.project.appConfig, pageConfig),
 			requestRender: (callback) => this.requestRender(callback)
 		});
+		this.routeEvents.attach(pageInstance, event);
 		pageInstance.createIntersectionObserver = (options) => this.createIntersectionObserver(pageInstance, options);
 		pageInstance.createMediaQueryObserver = () => this.createMediaQueryObserver(pageInstance);
 		pageInstance.selectComponent = (selector) => resolveNativeComponentSelection(this.selectComponent(selector));
@@ -42009,7 +42493,7 @@ var HeadlessSession = class {
 		return pageInstance;
 	}
 	runInitialPageLifecycles(pageInstance, query) {
-		runInitialPageLifecycles(pageInstance, query, this.kernel.scheduler, () => this.pages.includes(pageInstance) || this.tabPages.get(pageInstance.route) === pageInstance, () => this.renderCurrentPage());
+		runInitialPageLifecycles(pageInstance, query, this.kernel.scheduler, () => this.pages.includes(pageInstance) || this.tabPages.get(pageInstance.route) === pageInstance, () => this.renderCurrentPage(), () => this.routeEvents.ready(pageInstance));
 	}
 	isTabBarRoute(route) {
 		return this.tabBarRoutes.has(stripLeadingSlash(route));
@@ -42038,24 +42522,45 @@ var HeadlessSession = class {
 		return {
 			normalizedRoute,
 			query,
-			routeRecord
+			routeRecord,
+			pageConfig: readJsonObject(this.project, path.resolve(this.project.miniprogramRootPath, `${routeRecord.resourcePath ?? routeRecord.route}.json`))
 		};
 	}
-	unloadAllPages() {
+	unloadAllPages(event, closing = false) {
 		const pagesToUnload = /* @__PURE__ */ new Set([...this.pages, ...this.tabPages.values()]);
-		for (const page of [...pagesToUnload].reverse()) this.unloadPage(page);
+		let failure;
+		for (const page of [...pagesToUnload].reverse()) try {
+			this.unloadPage(page, event, closing);
+		} catch (error) {
+			if (!closing) throw error;
+			failure ??= { error };
+		}
 		this.pages.length = 0;
 		this.tabPages.clear();
 		this.componentCache.clear();
 		this.componentScopes.clear();
 		this.clearMediaQueryObservers();
 		this.currentPageInstance = null;
+		if (failure) throw failure.error;
 	}
-	unloadPage(page) {
-		page.onUnload?.();
+	unloadPage(page, event, closing = false) {
+		let failure;
+		try {
+			this.routeEvents.beforeUnload(page, event);
+			page.onUnload?.();
+		} catch (error) {
+			if (!closing) throw error;
+			failure = { error };
+		}
 		this.clearMediaQueryObservers(page);
-		this.detachPageComponents(page.route);
+		try {
+			this.detachPageComponents(page.route, closing);
+		} catch (error) {
+			if (!closing) throw error;
+			failure ??= { error };
+		}
 		this.tabPages.delete(stripLeadingSlash(page.route));
+		if (failure) throw failure.error;
 	}
 	requireCurrentPage(action) {
 		this.bootstrap();
@@ -42083,15 +42588,27 @@ var HeadlessSession = class {
 		const directlyOwned = rootScopeId ? matches.filter(([, scope]) => scope.ownerScopeId === rootScopeId) : [];
 		return (directlyOwned.length > 0 ? directlyOwned : matches).map(([candidateScopeId]) => this.componentCache.get(candidateScopeId)).filter(Boolean);
 	}
-	detachPageComponents(route) {
+	detachPageComponents(route, closing = false) {
 		const prefix = `page:${stripLeadingSlash(route)}`;
 		const removed = [...this.componentCache].filter(([scopeId]) => scopeId.startsWith(prefix));
-		for (const [, instance] of removed) runComponentLifecycle(instance, "detached");
-		detachComponentRelations(removed.map(([, instance]) => instance));
+		let failure;
+		for (const [, instance] of removed) try {
+			runComponentLifecycle(instance, "detached");
+		} catch (error) {
+			if (!closing) throw error;
+			failure ??= { error };
+		}
+		try {
+			detachComponentRelations(removed.map(([, instance]) => instance));
+		} catch (error) {
+			if (!closing) throw error;
+			failure ??= { error };
+		}
 		for (const [scopeId] of removed) {
 			this.componentCache.delete(scopeId);
 			this.componentScopes.delete(scopeId);
 		}
+		if (failure) throw failure.error;
 	}
 	notifyMediaQueryObservers() {
 		for (const entry of [...this.mediaQueryObservers]) {
@@ -42251,6 +42768,7 @@ function createPageRootNodeHandle(options) {
 	const tree = session?.getCurrentPages().includes(page) ? session.renderCurrentPage() : renderPageTree(project, page);
 	return new HeadlessTestingNodeHandle(tree.root.type === "root" && !options.includeHostRoots ? tree.root.children?.[0] ?? tree.root : tree.root, {
 		assertActive: options.assertActive,
+		dispatchNativeEvent: (node, eventName, event, onHandlerResult) => session?.getCurrentPages().at(-1) === page ? session.dispatchNativeNodeEvent(node, eventName, event, onHandlerResult) : false,
 		callMethod: (scopeId, methodName, event) => {
 			if (session?.getCurrentPages().includes(page)) return session.callScopeMethod(scopeId, methodName, event);
 			const method = page[methodName];
@@ -42690,9 +43208,13 @@ var HeadlessTestingScopeHandle = class HeadlessTestingScopeHandle {
 var HeadlessTestingSessionHandle = class {
 	project;
 	session;
+	pendingNavigations = /* @__PURE__ */ new Set();
 	constructor(project, session) {
 		this.project = project;
 		this.session = session;
+		this.session.on("close", () => {
+			for (const reject of this.pendingNavigations) reject(/* @__PURE__ */ new Error("The headless testing session closed before navigation completed."));
+		});
 	}
 	async close() {
 		this.session.close();
@@ -42761,23 +43283,23 @@ var HeadlessTestingSessionHandle = class {
 		}, `Timed out waiting for ${normalizedCount} component(s) matching "${normalizedSelector}" in headless testing runtime.`, options);
 	}
 	async reLaunch(route) {
-		this.invokeNavigation("reLaunch", { url: route });
+		await this.invokeNavigation("reLaunch", { url: route });
 		return await this.requireCurrentPage("reLaunch", route);
 	}
 	async navigateTo(route) {
-		this.invokeNavigation("navigateTo", { url: route });
+		await this.invokeNavigation("navigateTo", { url: route });
 		return await this.requireCurrentPage("navigateTo", route);
 	}
 	async redirectTo(route) {
-		this.invokeNavigation("redirectTo", { url: route });
+		await this.invokeNavigation("redirectTo", { url: route });
 		return await this.requireCurrentPage("redirectTo", route);
 	}
 	async navigateBack(delta = 1) {
-		this.invokeNavigation("navigateBack", { delta });
+		await this.invokeNavigation("navigateBack", { delta });
 		return await this.currentPage();
 	}
 	async switchTab(route) {
-		this.invokeNavigation("switchTab", { url: route });
+		await this.invokeNavigation("switchTab", { url: route });
 		return await this.requireCurrentPage("switchTab", route);
 	}
 	async waitForCurrentPage(route, options = {}) {
@@ -42814,21 +43336,30 @@ var HeadlessTestingSessionHandle = class {
 		this.session.triggerRouteDone(options);
 	}
 	invokeNavigation(methodName, options) {
-		const failure = { received: false };
-		this.session.callWxMethod(methodName, {
-			...options,
-			fail(error) {
-				failure.received = true;
-				failure.error = error;
+		return new Promise((resolve, reject) => {
+			const rejectNavigation = (error) => {
+				this.pendingNavigations.delete(rejectNavigation);
+				reject(error);
+			};
+			this.pendingNavigations.add(rejectNavigation);
+			try {
+				this.session.callWxMethod(methodName, {
+					...options,
+					success: () => {
+						this.pendingNavigations.delete(rejectNavigation);
+						resolve();
+					},
+					fail: (error) => {
+						const details = error && typeof error === "object" ? error : void 0;
+						const reason = typeof details?.errMsg === "string" ? details.errMsg : typeof details?.message === "string" ? details.message : String(error);
+						const target = options.url ? ` route "${options.url}"` : "";
+						rejectNavigation(new Error(`Failed to ${methodName}${target} through the headless wx runtime: ${reason}`, { cause: error }));
+					}
+				});
+			} catch (error) {
+				rejectNavigation(error);
 			}
 		});
-		if (failure.received) {
-			const error = failure.error;
-			const details = error && typeof error === "object" ? error : void 0;
-			const reason = typeof details?.errMsg === "string" ? details.errMsg : typeof details?.message === "string" ? details.message : String(error);
-			const target = options.url ? ` route "${options.url}"` : "";
-			throw new Error(`Failed to ${methodName}${target} through the headless wx runtime: ${reason}`, { cause: error });
-		}
 	}
 	async requireCurrentPage(methodName, route) {
 		const page = await this.currentPage();