@weapp-vite/miniprogram-automator 1.2.22 → 1.3.0

package/dist/{launch-BNQZTcKo.mjs → launch-anJvfi-6.mjs}

@@ -58,6 +58,41 @@ function createAppInstance(definition) {
 	return instance;
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/host/attachmentBindingUpdates.ts
+const bindingUpdates = /* @__PURE__ */ new WeakMap();
+const instanceScopes = /* @__PURE__ */ new WeakMap();
+/** 实例经渲染上下文归属页面，不扩展公开 renderer context 的参数契约。 */
+function bindAttachmentBindingScope(instance, scope) {
+	instanceScopes.set(instance, instanceScopes.get(scope) ?? scope);
+}
+/** 仅在挂载回调内同步逻辑绑定，不接管视图提交和 setData 回调。 */
+function runWithAttachmentBindingUpdates(scope, update, callback, value) {
+	const previous = bindingUpdates.get(scope);
+	const state = previous ?? {
+		revision: 0,
+		update
+	};
+	const previousUpdate = state.update;
+	state.update = update;
+	bindingUpdates.set(scope, state);
+	try {
+		return callback(value);
+	} finally {
+		if (previous) state.update = previousUpdate;
+		else bindingUpdates.delete(scope);
+	}
+}
+function getAttachmentBindingRevision(instance) {
+	return bindingUpdates.get(instanceScopes.get(instance) ?? instance);
+}
+function synchronizeAttachmentBindings(instance) {
+	const state = bindingUpdates.get(instanceScopes.get(instance) ?? instance);
+	if (state) {
+		state.revision++;
+		state.update();
+	}
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/componentInstance/shared.ts
 const ARRAY_INDEX_PATH_RE$1 = /\[(\d+)\]/g;
 const ARRAY_INDEX_SEGMENT_RE$1 = /^\d+$/;
@@ -905,6 +940,7 @@ function createComponentInstance(options) {
 			const previousProperties = Object.fromEntries(propertyKeys.map((key) => [key, cloneValue$1(instance.properties[key])]));
 			for (const [key, value] of Object.entries(patch)) assignByPath$1(instance.data, key, value);
 			for (const key of dataKeys) instance.properties[key] = instance.data[key];
+			synchronizeAttachmentBindings(instance);
 			runComponentObservers(definition, instance, changedKeys, previousProperties);
 			if (options.requestRender) options.requestRender(callback);
 			else callback?.();
@@ -946,8 +982,11 @@ const componentPageInstances = /* @__PURE__ */ new WeakSet();
 function isComponentPageAttaching(instance) {
 	return attachingInstances.has(instance);
 }
-function registerComponentPageAttachment(definition, attach) {
-	definitionAttachments.set(definition, attach);
+function registerComponentPageAttachment(definition, created, attached) {
+	definitionAttachments.set(definition, {
+		created,
+		attached
+	});
 }
 function bindComponentPageAttachment(instance, definition) {
 	const attach = definitionAttachments.get(definition);
@@ -958,13 +997,14 @@ function bindComponentPageAttachment(instance, definition) {
 		if (typeof options?.styleIsolation === "string") instanceStyleIsolation.set(instance, options.styleIsolation);
 	}
 }
-function attachComponentPage(instance) {
+function attachComponentPage(instance, updateBindings) {
 	const attach = instanceAttachments.get(instance);
 	if (!attach) return false;
 	instanceAttachments.delete(instance);
 	attachingInstances.add(instance);
 	try {
-		attach.call(instance);
+		attach.created(instance);
+		runWithAttachmentBindingUpdates(instance, updateBindings, attach.attached, instance);
 	} finally {
 		attachingInstances.delete(instance);
 	}
@@ -1114,6 +1154,7 @@ function createPageInstance(route, definition, options = {}, pageState = {}) {
 				const rootKey = parseDataPath(key)[0];
 				if (rootKey) instance.properties[rootKey] = instance.data[rootKey];
 			}
+			synchronizeAttachmentBindings(instance);
 			if (pageState.requestRender) pageState.requestRender(callback);
 			else callback?.();
 		}
@@ -1126,6 +1167,262 @@ function createPageInstance(route, definition, options = {}, pageState = {}) {
 	return instance;
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/view/eventBindingParser.ts
+const LEGACY_EVENT_NAME_RE = /^\w+$/;
+const EVENT_BINDING_PREFIXES = [
+	{
+		prefix: "capture-bind:",
+		priority: 0,
+		stopAfter: false,
+		phase: "capture"
+	},
+	{
+		prefix: "capture-catch:",
+		priority: 0,
+		stopAfter: true,
+		phase: "capture"
+	},
+	{
+		prefix: "capture-bind",
+		priority: 1,
+		stopAfter: false,
+		phase: "capture"
+	},
+	{
+		prefix: "capture-catch",
+		priority: 1,
+		stopAfter: true,
+		phase: "capture"
+	},
+	{
+		prefix: "bind:",
+		priority: 0,
+		stopAfter: false,
+		phase: "bubble"
+	},
+	{
+		prefix: "catch:",
+		priority: 0,
+		stopAfter: true,
+		phase: "bubble"
+	},
+	{
+		prefix: "bind",
+		priority: 1,
+		stopAfter: false,
+		phase: "bubble"
+	},
+	{
+		prefix: "catch",
+		priority: 1,
+		stopAfter: true,
+		phase: "bubble"
+	}
+];
+function parseEventBinding(attributeName, method) {
+	const definition = EVENT_BINDING_PREFIXES.find((item) => attributeName.startsWith(item.prefix));
+	if (!definition) return null;
+	const eventName = attributeName.slice(definition.prefix.length);
+	if (!eventName || !definition.prefix.endsWith(":") && !LEGACY_EVENT_NAME_RE.test(eventName)) return null;
+	return {
+		eventName,
+		method,
+		phase: definition.phase,
+		priority: definition.priority,
+		stopAfter: definition.stopAfter
+	};
+}
+function collectEventBindings(attributes = {}, includeCapture = true) {
+	const eventBindings = /* @__PURE__ */ new Map();
+	let captureEventBindings;
+	const priorities = /* @__PURE__ */ new Map();
+	for (const [attributeName, method] of Object.entries(attributes)) {
+		const candidate = parseEventBinding(attributeName, method);
+		if (!candidate || !includeCapture && candidate.phase === "capture") continue;
+		const eventPriorities = priorities.get(candidate.eventName) ?? {};
+		if (candidate.priority < (eventPriorities[candidate.phase] ?? -1)) continue;
+		(candidate.phase === "bubble" ? eventBindings : captureEventBindings ??= /* @__PURE__ */ new Map()).set(candidate.eventName, {
+			method: candidate.method,
+			stopAfter: candidate.stopAfter
+		});
+		eventPriorities[candidate.phase] = candidate.priority;
+		priorities.set(candidate.eventName, eventPriorities);
+	}
+	return {
+		eventBindings,
+		captureEventBindings
+	};
+}
+/** 单事件查询只保留命中的绑定，原生交互不构造整张事件表。 */
+function resolveEventBindingPhases(attributes, eventName, includeCapture = true) {
+	if (!attributes) return null;
+	let bindings = null;
+	let bubblePriority = -1;
+	let capturePriority = -1;
+	for (const [attributeName, method] of Object.entries(attributes)) {
+		const candidate = parseEventBinding(attributeName, method);
+		if (!candidate || candidate.eventName !== eventName || !includeCapture && candidate.phase === "capture") continue;
+		const priority = candidate.phase === "bubble" ? bubblePriority : capturePriority;
+		if (candidate.priority < priority) continue;
+		bindings ??= {};
+		bindings[candidate.phase] = {
+			method: candidate.method,
+			stopAfter: candidate.stopAfter
+		};
+		if (candidate.phase === "bubble") bubblePriority = candidate.priority;
+		else capturePriority = candidate.priority;
+	}
+	return bindings;
+}
+//#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/componentEvent.ts
+const eventNodes = /* @__PURE__ */ new WeakMap();
+/** 在构造子树之前建立父链，created/observer 中的事件也能访问声明树。 */
+function registerComponentEventNode(node, scope, parent) {
+	node.parent = parent ?? null;
+	eventNodes.set(node, {
+		scope,
+		target: node
+	});
+}
+/** 宿主与作用域共享同一份分阶段绑定，eventBindings 仍是原有的冒泡存储。 */
+function bindComponentEventHost(node) {
+	const bindings = collectEventBindings(node.attribs);
+	eventNodes.get(node).bindings = bindings;
+	return bindings;
+}
+/** 渲染会把宿主折叠进模板根；事件仍保留两层独立的绑定和声明所有者。 */
+function mergeComponentEventRoot(root, host) {
+	const entry = eventNodes.get(root);
+	if (entry.target === root) entry.target = {
+		attribs: root.attribs,
+		dataset: root.dataset
+	};
+	entry.hosts ??= [];
+	entry.hosts.push(host);
+	root.parent = host.parent;
+}
+/** 按渲染完成后的实际宿主父链排序；输入只包含本轮存活的组件作用域。 */
+function orderComponentAttachmentScopes(scopeIds, componentScopes) {
+	const hostScopes = /* @__PURE__ */ new Map();
+	for (const scopeId of scopeIds) hostScopes.set(componentScopes.get(scopeId).hostNode, scopeId);
+	const ordered = [];
+	const visited = /* @__PURE__ */ new Set();
+	const visit = (node) => {
+		if (!node || visited.has(node)) return;
+		visited.add(node);
+		visit(node.parent);
+		const hosts = eventNodes.get(node)?.hosts;
+		if (hosts) for (let index = hosts.length - 1; index >= 0; index--) visit(hosts[index]);
+		const scopeId = hostScopes.get(node);
+		if (scopeId !== void 0) ordered.push(scopeId);
+	};
+	for (const host of hostScopes.keys()) visit(host);
+	return ordered;
+}
+function buildComponentTrigger(componentScopeId, context) {
+	return (instance, eventName, detail, triggerOptions) => {
+		const originScope = context.componentScopes.get(componentScopeId);
+		const origin = originScope?.hostNode;
+		if (!originScope || !origin) return;
+		const bubbles = triggerOptions?.bubbles ?? false;
+		const capturePhase = triggerOptions?.capturePhase ?? false;
+		const composed = triggerOptions?.composed ?? false;
+		const target = {
+			dataset: originScope.dataset ?? collectNodeDataset(origin),
+			id: originScope.hostId ?? ""
+		};
+		const mark = instance.__lastInteractionEvent__?.mark;
+		const listeners = [];
+		const collect = (entry, isOrigin) => {
+			if (!composed && entry.scope.getScopeId() !== originScope.listenerScopeId) return false;
+			const bindings = entry.bindings ? {
+				bubble: entry.bindings.eventBindings?.get(eventName),
+				capture: entry.bindings.captureEventBindings?.get(eventName)
+			} : resolveEventBindingPhases(entry.target.attribs, eventName);
+			if (bindings?.bubble || bindings?.capture) listeners.push({
+				scope: entry.scope,
+				bindings,
+				currentTarget: isOrigin ? target : {
+					dataset: collectNodeDataset(entry.target),
+					id: entry.target.attribs?.id ?? ""
+				},
+				origin: isOrigin
+			});
+			return true;
+		};
+		let current = origin;
+		while (current) {
+			const entry = eventNodes.get(current);
+			if (entry) {
+				if (!collect(entry, current === origin)) break;
+				let crossedBoundary = false;
+				for (const host of entry.hosts ?? []) if (!collect(eventNodes.get(host), false)) {
+					crossedBoundary = true;
+					break;
+				}
+				if (crossedBoundary) break;
+			}
+			if (!bubbles && !capturePhase) break;
+			current = current.parent;
+		}
+		const handlers = [];
+		let stopped = false;
+		if (capturePhase) for (let index = listeners.length - 1; index >= 0; index--) {
+			const listener = listeners[index];
+			const binding = listener.bindings.capture;
+			if (binding) {
+				handlers.push({
+					scope: listener.scope,
+					binding,
+					currentTarget: listener.currentTarget
+				});
+				if (binding.stopAfter) {
+					stopped = true;
+					break;
+				}
+			}
+		}
+		if (!stopped) for (const listener of listeners) {
+			if (!bubbles && !listener.origin) continue;
+			const binding = listener.bindings.bubble;
+			if (binding) {
+				handlers.push({
+					scope: listener.scope,
+					binding,
+					currentTarget: listener.currentTarget
+				});
+				if (binding.stopAfter) break;
+			}
+		}
+		for (const { scope, binding, currentTarget } of handlers) scope.getMethod(binding.method)?.({
+			bubbles,
+			capturePhase,
+			composed,
+			currentTarget,
+			detail,
+			mark,
+			target,
+			type: eventName
+		});
+	};
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/view/conditionalChildren.ts
 function selectConditionalChildren(children, evaluate) {
 	const selected = [];
@@ -1181,11 +1478,77 @@ function customTabBarHostScope() {
 	};
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/view/inspectionTree.ts
+const inspectionChildren = /* @__PURE__ */ new WeakMap();
+const inspectionParents = /* @__PURE__ */ new WeakMap();
+const emptyChildren = [];
+function getInspectionChildren(node) {
+	return inspectionChildren.get(node) ?? node.children ?? emptyChildren;
+}
+function getInspectionParent(node) {
+	return inspectionParents.get(node) ?? node.parent ?? null;
+}
+function collectRenderedNodes(node, nodes) {
+	if (nodes.has(node)) return;
+	nodes.add(node);
+	for (const child of node.children ?? emptyChildren) collectRenderedNodes(child, nodes);
+}
+/** 原生检查器保留未投影声明；可见 DOM、WXML 和事件父链不因此增加节点。 */
+function registerInspectionTrees(root, pass, scopes) {
+	if (!pass.hasUnprojectedSlots) return;
+	const rendered = /* @__PURE__ */ new Set();
+	collectRenderedNodes(root, rendered);
+	const candidates = /* @__PURE__ */ new Map();
+	for (const [entries, group] of pass.slotDeclarations) {
+		if (scopes.get(group.scopeId)?.hostNode !== group.parent) continue;
+		const host = pass.componentRoots.get(group.scopeId);
+		if (!host) continue;
+		for (const entry of entries) for (const node of pass.renderedSlots.get(entry) ?? emptyChildren) candidates.set(node, host);
+	}
+	const nested = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	const indexChildren = (node) => {
+		if (visited.has(node)) return;
+		visited.add(node);
+		for (const child of node.children ?? emptyChildren) {
+			nested.add(child);
+			if (!rendered.has(child)) inspectionParents.set(child, node);
+			indexChildren(child);
+		}
+	};
+	for (const node of candidates.keys()) indexChildren(node);
+	for (const [node, host] of candidates) {
+		if (rendered.has(node) || nested.has(node) || node === host) continue;
+		let children = inspectionChildren.get(host);
+		if (!children) {
+			children = [...host.children ?? emptyChildren];
+			inspectionChildren.set(host, children);
+		}
+		children.push(node);
+		inspectionParents.set(node, host);
+	}
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/view/loopEntries.ts
+const LOOP_SCOPE_ESCAPE_RE = /[^\w-]/g;
+function escapeScopeCodeUnit(character) {
+	return `~${character.charCodeAt(0).toString(16).padStart(4, "0")}`;
+}
+function encodeLoopCoordinate(value) {
+	return value.replace(LOOP_SCOPE_ESCAPE_RE, escapeScopeCodeUnit);
+}
 function resolveLoopEntries(value) {
 	if (Array.isArray(value)) return value.map((item, index) => [index, item]);
 	return value !== null && typeof value === "object" ? Object.entries(value) : [];
 }
+function resolveLoopInstanceSuffix(item, index, key, occurrences) {
+	if (!key || !occurrences) return `:for-${encodeLoopCoordinate(String(index))}`;
+	const value = key === "*this" ? item : item?.[key];
+	const normalized = encodeLoopCoordinate(String(value ?? ""));
+	const occurrence = occurrences.get(normalized) ?? 0;
+	occurrences.set(normalized, occurrence + 1);
+	return `:key-${normalized}${occurrence ? `:duplicate-${occurrence}` : ""}`;
+}
 //#endregion
 //#region ../../mpcore/packages/simulator/src/view/renderedTree.ts
 /** 在循环展开和组件替换完成后，让父节点关系指向本次渲染树。 */
@@ -1194,7 +1557,45 @@ function linkRenderedParents(root, parent = null) {
 	for (const child of root.children ?? []) linkRenderedParents(child, root);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@babel+parser@8.0.6/node_modules/@babel/parser/lib/index.js
+//#region ../../mpcore/packages/simulator/src/view/renderPass.ts
+const initializedPages = /* @__PURE__ */ new WeakMap();
+function createRenderPass(propertyUpdate = false, parent) {
+	return {
+		seenComponentScopes: /* @__PURE__ */ new Set(),
+		componentRoots: /* @__PURE__ */ new Map(),
+		slotDeclarations: /* @__PURE__ */ new Map(),
+		renderedSlots: /* @__PURE__ */ new Map(),
+		hasUnprojectedSlots: false,
+		propertyUpdate,
+		bindingUpdate: parent?.bindingUpdate,
+		bindingRevision: parent?.bindingUpdate?.revision ?? 0
+	};
+}
+function createPageRenderPass(page, cache) {
+	const pass = createRenderPass(initializedPages.get(cache)?.has(page) ?? false);
+	pass.bindingUpdate = getAttachmentBindingRevision(page);
+	pass.bindingRevision = pass.bindingUpdate?.revision ?? 0;
+	return pass;
+}
+function isRenderPassStale(pass) {
+	return pass.bindingUpdate !== void 0 && pass.bindingUpdate.revision !== pass.bindingRevision;
+}
+function markPageTreeConstructed(page, cache) {
+	let pages = initializedPages.get(cache);
+	if (!pages) {
+		pages = /* @__PURE__ */ new WeakSet();
+		initializedPages.set(cache, pages);
+	}
+	pages.add(page);
+}
+function registerSlotDeclarations(pass, slots, parent, scopeId) {
+	for (const entries of slots.values()) if (!pass.slotDeclarations.has(entries)) pass.slotDeclarations.set(entries, {
+		parent,
+		scopeId
+	});
+}
+//#endregion
+//#region ../../node_modules/.pnpm/@babel+parser@8.0.7/node_modules/@babel/parser/lib/index.js
 var Position = class {
 	constructor(line, col, index) {
 		this.line = void 0;
@@ -9263,7 +9664,11 @@ var StatementParser = class extends ExpressionParser {
 		if (isDeclaration) node.id = this.parseFunctionId(requireId);
 		this.scope.enter(514);
 		this.prodParam.enter(functionFlags(isAsync, node.generator));
-		if (!isDeclaration) node.id = this.parseFunctionId();
+		if (!isDeclaration && tokenIsIdentifier(this.state.type)) {
+			this.expressionScope.enter(newExpressionScope());
+			node.id = this.parseFunctionId();
+			this.expressionScope.exit();
+		}
 		this.parseFunctionParams(node, false);
 		this.parseFunctionBodyAndFinish(node, isDeclaration ? "FunctionDeclaration" : "FunctionExpression");
 		this.prodParam.exit();
@@ -12636,6 +13041,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 +13136,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) {
@@ -12875,7 +13318,8 @@ function isComponentAttached(instance) {
 	return attachmentStates.get(instance) === "attached";
 }
 function hasPendingComponentAttachments(instances) {
-	return [...instances].some((instance) => attachmentStates.get(instance) === "attaching");
+	for (const instance of instances) if (attachmentStates.get(instance) === "attaching") return true;
+	return false;
 }
 function flushComponentReady(instances, ready) {
 	const all = [...instances];
@@ -12885,19 +13329,71 @@ function flushComponentReady(instances, ready) {
 	for (const instance of pending) ready(instance);
 	return pending.length > 0;
 }
-function flushComponentAttachments(instances, attach) {
-	const pending = [...instances].filter((instance) => !attachmentStates.has(instance));
-	for (const instance of pending) attachmentStates.set(instance, "attaching");
+function flushComponentAttachments(componentCache, scopeIds, attach) {
+	const pending = /* @__PURE__ */ new Map();
+	for (const scopeId of scopeIds) {
+		const instance = componentCache.get(scopeId);
+		if (!instance) continue;
+		const state = attachmentStates.get(instance);
+		if (state === "attaching") return false;
+		if (!state) pending.set(scopeId, instance);
+	}
+	for (const instance of pending.values()) attachmentStates.set(instance, "attaching");
 	try {
-		for (const instance of pending) try {
-			attach(instance);
-		} finally {
-			attachmentStates.set(instance, "attached");
+		for (const [scopeId, instance] of pending) {
+			if (componentCache.get(scopeId) !== instance) return "restart";
+			let restart;
+			try {
+				restart = attach(instance);
+			} finally {
+				attachmentStates.set(instance, "attached");
+			}
+			if (restart) return "restart";
 		}
 	} finally {
-		for (const instance of pending) if (attachmentStates.get(instance) === "attaching") attachmentStates.delete(instance);
+		for (const instance of pending.values()) if (attachmentStates.get(instance) === "attaching") attachmentStates.delete(instance);
 	}
-	return pending.length > 0;
+	return pending.size > 0 ? "attached" : false;
+}
+//#endregion
+//#region ../../mpcore/packages/simulator/src/runtime/componentInstance/construction.ts
+const constructionStates = /* @__PURE__ */ new WeakMap();
+const constructingInstances = /* @__PURE__ */ new WeakSet();
+function isComponentConstructing(instance) {
+	return instance !== void 0 && constructingInstances.has(instance);
+}
+function hasPendingComponentConstruction(componentCache) {
+	return constructionStates.has(componentCache);
+}
+function beginComponentConstruction(componentCache, scopeId, instance) {
+	let state = constructionStates.get(componentCache);
+	if (!state) {
+		state = {
+			depth: 0,
+			created: /* @__PURE__ */ new Map()
+		};
+		constructionStates.set(componentCache, state);
+	}
+	state.depth++;
+	state.created.set(scopeId, instance);
+	constructingInstances.add(instance);
+}
+function discardComponentConstruction(componentCache, componentScopes, scopeId) {
+	const state = constructionStates.get(componentCache);
+	const prefix = `${scopeId}/`;
+	for (const [createdScopeId, instance] of state.created) {
+		if (createdScopeId !== scopeId && !createdScopeId.startsWith(prefix)) continue;
+		if (componentCache.get(createdScopeId) === instance) {
+			componentCache.delete(createdScopeId);
+			componentScopes.delete(createdScopeId);
+		}
+		state.created.delete(createdScopeId);
+	}
+}
+function finishComponentConstruction(componentCache, instance) {
+	constructingInstances.delete(instance);
+	const state = constructionStates.get(componentCache);
+	if (--state.depth === 0) constructionStates.delete(componentCache);
 }
 //#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/componentInstance/discardedReady.ts
@@ -12920,12 +13416,41 @@ function flushDiscardedComponentReady(cache, pageScopeId, ready) {
 	if (!pending.size) discardedReady.delete(cache);
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/runtime/componentInstance/propertyBindings.ts
+const consumedPageChanges = /* @__PURE__ */ new WeakMap();
+function syncComponentProperties(instance, definition, nextProperties, bindingExpressions, changedPageKeys, beforeObservers) {
+	const freshPageChanges = changedPageKeys.length > 0 && consumedPageChanges.get(instance) !== changedPageKeys;
+	if (freshPageChanges) consumedPageChanges.set(instance, changedPageKeys);
+	const changedRootKeys = [];
+	const previousProperties = {};
+	for (const [key, value] of Object.entries(nextProperties)) {
+		const nextValue = normalizeComponentPropertyValue(definition, key, value);
+		const bindingExpression = bindingExpressions[key];
+		const bindingAffected = freshPageChanges && !!bindingExpression && changedPageKeys.some((changedKey) => {
+			return changedKey === bindingExpression || changedKey.startsWith(`${bindingExpression}.`) || changedKey.startsWith(`${bindingExpression}[`);
+		});
+		const previousSnapshot = instance.__propertySnapshots?.[key];
+		if (hasComponentPropertyValueChanged(instance.properties[key], previousSnapshot, nextValue, bindingAffected)) {
+			previousProperties[key] = instance.properties[key];
+			const deliveredValue = cloneValue$1(nextValue);
+			instance.properties[key] = deliveredValue;
+			if (Object.hasOwn(definition.properties ?? {}, key)) instance.data[key] = deliveredValue;
+			changedRootKeys.push(key);
+		}
+		instance.__propertySnapshots ??= {};
+		instance.__propertySnapshots[key] = cloneValue$1(nextValue);
+	}
+	if (changedRootKeys.length === 0) return;
+	beforeObservers?.(instance, "properties");
+	runComponentObservers(definition, instance, changedRootKeys, previousProperties);
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/pageLifecycle.ts
 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 +13465,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
@@ -13005,61 +13533,11 @@ function createPluginArtifactSource(fallback, miniprogramRootPath, plugins) {
 		readText: (filePath) => fallback.readText(resolvePhysicalPath(filePath))
 	};
 }
-//#endregion
-//#region ../../mpcore/packages/simulator/src/view/eventBinding.ts
-const LEGACY_EVENT_NAME_RE = /^\w+$/;
-const EVENT_BINDING_PREFIXES = [
-	{
-		prefix: "bind:",
-		priority: 0,
-		stopAfter: false
-	},
-	{
-		prefix: "catch:",
-		priority: 0,
-		stopAfter: true
-	},
-	{
-		prefix: "bind",
-		priority: 1,
-		stopAfter: false
-	},
-	{
-		prefix: "catch",
-		priority: 1,
-		stopAfter: true
-	}
-];
-function parseEventBinding(attributeName, method) {
-	const definition = EVENT_BINDING_PREFIXES.find((item) => attributeName.startsWith(item.prefix));
-	if (!definition) return null;
-	const eventName = attributeName.slice(definition.prefix.length);
-	if (!eventName || !definition.prefix.endsWith(":") && !LEGACY_EVENT_NAME_RE.test(eventName)) return null;
-	return {
-		eventName,
-		method,
-		priority: definition.priority,
-		stopAfter: definition.stopAfter
-	};
-}
-function collectMiniProgramEventBindings(attributes = {}) {
-	const bindings = /* @__PURE__ */ new Map();
-	const priorities = /* @__PURE__ */ new Map();
-	for (const [attributeName, method] of Object.entries(attributes)) {
-		const candidate = parseEventBinding(attributeName, method);
-		if (!candidate || candidate.priority < (priorities.get(candidate.eventName) ?? -1)) continue;
-		bindings.set(candidate.eventName, {
-			method: candidate.method,
-			stopAfter: candidate.stopAfter
-		});
-		priorities.set(candidate.eventName, candidate.priority);
-	}
-	return bindings;
-}
-function resolveMiniProgramEventBinding(attributes, eventName) {
-	return collectMiniProgramEventBindings(attributes).get(eventName) ?? null;
-}
 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 +13646,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 +13697,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,24 +17481,83 @@ 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 source = templateSource.replace(INLINE_WXS_RE, (_match, attributes, script) => {
 		return `<wxs data-sim-wxs="${scripts.push(script) - 1}"${attributes}>wxs-source</wxs>`;
-	})}</page>`, {
+	});
+	const masked = maskTemplateAttributes(source);
+	const document = parseDocument(`<page>${masked.source}</page>`, {
 		xmlMode: false,
 		decodeEntities: false,
 		lowerCaseAttributeNames: false,
 		lowerCaseTags: false,
 		recognizeSelfClosing: true
 	});
+	if (!scripts.length && !masked.attributes.size && !/[\r\n]/.test(source)) 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"];
+			return;
 		}
+		if (node.children) node.children = node.children.filter((child) => child.type !== "text" || !/^[\t\r\n ]+$/.test(child.data ?? "") || !/[\r\n]/.test(child.data ?? ""));
 		for (const child of node.children ?? []) restore(child);
 	};
 	restore(document);
@@ -17040,7 +17565,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 +17584,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 +17609,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 +17740,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 +17748,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;
@@ -17243,66 +17760,6 @@ function resolveComponentGenerics(context, hostNode, ownerJsonPath, ownerFilePat
 	}
 	return resolved.size > 0 ? resolved : void 0;
 }
-function collectComponentEventBindings(hostNode) {
-	return collectMiniProgramEventBindings(hostNode.attribs);
-}
-function buildComponentTrigger(componentScopeId, context, hostNode) {
-	const hostDataset = collectDataset(hostNode);
-	const hostId = hostNode.attribs?.id ?? "";
-	return (instance, eventName, detail, triggerOptions) => {
-		const originScope = context.componentScopes.get(componentScopeId);
-		const interactionMark = instance.__lastInteractionEvent__?.mark;
-		const target = {
-			dataset: originScope?.dataset ?? hostDataset,
-			id: originScope?.hostId ?? hostId
-		};
-		let currentScopeId = componentScopeId;
-		while (currentScopeId) {
-			const currentScope = context.componentScopes.get(currentScopeId);
-			const binding = currentScope?.eventBindings?.get(eventName);
-			const listenerScope = currentScope?.listenerScopeId ? context.componentScopes.get(currentScope.listenerScopeId) : null;
-			const handler = binding && listenerScope ? listenerScope.getMethod(binding.method) : void 0;
-			if (handler) handler({
-				bubbles: triggerOptions?.bubbles ?? false,
-				capturePhase: false,
-				composed: triggerOptions?.composed ?? false,
-				currentTarget: {
-					dataset: currentScope?.dataset ?? hostDataset,
-					id: currentScope?.hostId ?? hostId
-				},
-				detail,
-				mark: interactionMark,
-				target,
-				type: eventName
-			});
-			if (binding?.stopAfter) break;
-			if (!triggerOptions?.bubbles || !triggerOptions?.composed) break;
-			currentScopeId = currentScope?.ownerScopeId;
-		}
-	};
-}
-function syncComponentProperties(instance, definition, nextProperties, bindingExpressions, changedPageKeys) {
-	const changedRootKeys = [];
-	const previousProperties = {};
-	for (const [key, value] of Object.entries(nextProperties)) {
-		const nextValue = normalizeComponentPropertyValue(definition, key, value);
-		const bindingExpression = bindingExpressions[key];
-		const bindingAffected = !!bindingExpression && changedPageKeys.some((changedKey) => {
-			return changedKey === bindingExpression || changedKey.startsWith(`${bindingExpression}.`) || changedKey.startsWith(`${bindingExpression}[`);
-		});
-		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;
-			changedRootKeys.push(key);
-		}
-		instance.__propertySnapshots ??= {};
-		instance.__propertySnapshots[key] = cloneValue$1(nextValue);
-	}
-	if (changedRootKeys.length === 0) return;
-	runComponentObservers(definition, instance, changedRootKeys, previousProperties);
-}
 function createComponentScope(clonedNode, scope, componentScopeId, componentInstance, genericComponents, slots) {
 	const ownerScopeId = scope.getScopeId().includes("/") ? scope.getScopeId() : void 0;
 	return {
@@ -17310,7 +17767,7 @@ function createComponentScope(clonedNode, scope, componentScopeId, componentInst
 		classList: String(clonedNode.attribs?.class ?? "").split(CLASS_SPLIT_RE).map((item) => item.trim()).filter(Boolean),
 		data: { ...componentInstance.data },
 		dataset: collectDataset(clonedNode, wxsScopeData(scope)),
-		eventBindings: collectComponentEventBindings(clonedNode),
+		...bindComponentEventHost(clonedNode),
 		getMethod: (methodName) => {
 			const method = componentInstance?.[methodName];
 			return typeof method === "function" ? method.bind(componentInstance) : void 0;
@@ -17318,6 +17775,7 @@ function createComponentScope(clonedNode, scope, componentScopeId, componentInst
 		getScopeId: () => componentScopeId,
 		genericComponents,
 		hostId: typeof clonedNode.attribs?.id === "string" ? clonedNode.attribs.id : void 0,
+		hostNode: clonedNode,
 		id: typeof clonedNode.attribs?.id === "string" ? clonedNode.attribs.id : void 0,
 		listenerScopeId: scope.getScopeId(),
 		ownerScopeId,
@@ -17340,13 +17798,14 @@ function resolveComponentProperties(clonedNode, scope, definition) {
 		bindingExpressions
 	};
 }
-function createRuntimeComponentInstance(componentScopeId, context, clonedNode, componentEntry, nextProperties, ownerScopeId, beforeCreated) {
+function createRuntimeComponentInstance(componentScopeId, context, componentEntry, nextProperties, ownerScopeId, renderTemplate, bindEventsBeforeProperties = false) {
 	const componentProperties = Object.keys(componentEntry.definition.methods ?? {}).some((key) => key.startsWith("__weapp_vite_")) || Object.hasOwn(componentEntry.definition.properties ?? {}, "__wvSlotOwnerId") ? Object.fromEntries(Object.keys(componentEntry.definition.properties ?? {}).filter((key) => Object.hasOwn(nextProperties, key)).map((key) => [key, nextProperties[key]])) : nextProperties;
-	const componentInstance = createComponentInstance({
+	const instanceOptions = {
 		definition: componentEntry.definition,
-		requestRender: (callback) => context.session.requestRender(callback),
-		triggerEvent: buildComponentTrigger(componentScopeId, context, clonedNode)
-	});
+		requestRender: (callback) => context.session.requestRender(callback)
+	};
+	const componentInstance = createComponentInstance(instanceOptions);
+	bindAttachmentBindingScope(componentInstance, context);
 	setSelectorQueryScopeId(componentInstance, componentScopeId);
 	componentInstance.is = componentEntry.filePath.replace(JS_FILE_RE, "");
 	componentInstance.createIntersectionObserver = (options) => context.session.createIntersectionObserver(componentInstance, options);
@@ -17354,19 +17813,29 @@ function createRuntimeComponentInstance(componentScopeId, context, clonedNode, c
 	componentInstance.createSelectorQuery = () => context.moduleLoader.wx.createSelectorQuery().in(componentInstance);
 	componentInstance.selectComponent = (selector) => resolveNativeComponentSelection(context.session.selectComponentWithin(componentScopeId, selector));
 	componentInstance.selectAllComponents = (selector) => context.session.selectAllComponentsWithin(componentScopeId, selector).map(resolveNativeComponentSelection);
-	componentInstance.selectOwnerComponent = () => ownerScopeId ? context.componentCache.get(ownerScopeId) ?? null : null;
+	componentInstance.selectOwnerComponent = () => ownerScopeId ? resolveNativeComponentSelection(context.componentCache.get(ownerScopeId)) : null;
+	beginComponentConstruction(context.componentCache, componentScopeId, componentInstance);
 	context.componentCache.set(componentScopeId, componentInstance);
-	beforeCreated?.(componentInstance);
-	runComponentLifecycle(componentInstance, "created");
-	componentInstance.__propertySnapshots = Object.fromEntries(Object.entries(componentInstance.properties).map(([key, propertyValue]) => [key, cloneValue$1(propertyValue)]));
-	syncComponentProperties(componentInstance, componentInstance.__definition__ ?? componentEntry.definition, componentProperties, {}, []);
-	return componentInstance;
+	try {
+		renderTemplate?.(componentInstance, "defaults");
+		runComponentLifecycle(componentInstance, "created");
+		if (bindEventsBeforeProperties) instanceOptions.triggerEvent = buildComponentTrigger(componentScopeId, context);
+		componentInstance.__propertySnapshots = Object.fromEntries(Object.entries(componentInstance.properties).map(([key, propertyValue]) => [key, cloneValue$1(propertyValue)]));
+		syncComponentProperties(componentInstance, componentInstance.__definition__ ?? componentEntry.definition, componentProperties, {}, [], renderTemplate);
+		if (!bindEventsBeforeProperties) instanceOptions.triggerEvent = buildComponentTrigger(componentScopeId, context);
+		return componentInstance;
+	} catch (error) {
+		discardComponentConstruction(context.componentCache, context.componentScopes, componentScopeId);
+		throw error;
+	} finally {
+		finishComponentConstruction(context.componentCache, componentInstance);
+	}
 }
-function renderRuntimeComponentTemplate(context, componentEntry, renderNodeTree, componentScope, componentScopeId, seenComponentScopes) {
+function renderRuntimeComponentTemplate(context, componentEntry, renderNodeTree, componentScope, componentScopeId, renderPass) {
 	const componentDocument = parseTemplateDocument(readTemplateSource(context.artifactSource, componentEntry.absoluteTemplatePath));
 	const componentRoot = (componentDocument.children ?? [])[0] ?? componentDocument;
 	const templateRenderState = prepareTemplateRenderState(context.artifactSource, componentRoot, componentEntry.absoluteTemplatePath, context.project.miniprogramRootPath, getRuntimeWxsLoader(context.moduleLoader, context.artifactSource));
-	return renderNodeTree(componentRoot, componentScope, context, path.resolve(context.project.miniprogramRootPath, `${componentEntry.filePath.replace(JS_FILE_RE, "")}.json`), componentEntry.filePath, componentScopeId, seenComponentScopes, templateRenderState);
+	return renderNodeTree(componentRoot, componentScope, context, path.resolve(context.project.miniprogramRootPath, `${componentEntry.filePath.replace(JS_FILE_RE, "")}.json`), componentEntry.filePath, componentScopeId, renderPass, templateRenderState, componentScope.hostNode);
 }
 //#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/render/index.ts
@@ -17380,24 +17849,33 @@ function expandNodeByFor(node, scope) {
 	const items = resolveLoopEntries(resolveRawValueByPath$1(wxsScopeData(scope), forExpression));
 	const itemName = node.attribs?.["wx:for-item"]?.trim() || "item";
 	const indexName = node.attribs?.["wx:for-index"]?.trim() || "index";
+	const key = node.attribs?.["wx:key"]?.trim();
+	const keyOccurrences = key ? /* @__PURE__ */ new Map() : void 0;
 	return items.map(([index, item]) => ({
 		node: cloneNode(node),
 		scope: createLoopScope(scope, itemName, indexName, item, index),
-		instanceSuffix: `:for-${index}`
+		instanceSuffix: resolveLoopInstanceSuffix(item, index, key, keyOccurrences)
 	}));
 }
-function renderNodeVariants(node, scope, context, ownerJsonPath, ownerFilePath, instancePath, seenComponentScopes, templateRenderState) {
-	return expandNodeByFor(node, scope).map(({ node: expandedNode, scope: expandedScope, instanceSuffix }) => renderNodeTree(expandedNode, expandedScope, context, ownerJsonPath, ownerFilePath, `${instancePath}${instanceSuffix}`, seenComponentScopes, templateRenderState));
+function renderNodeVariants(node, scope, context, ownerJsonPath, ownerFilePath, instancePath, renderPass, templateRenderState, parent) {
+	const nodes = [];
+	if (isRenderPassStale(renderPass)) return nodes;
+	for (const { node: expandedNode, scope: expandedScope, instanceSuffix } of expandNodeByFor(node, scope)) {
+		if (isRenderPassStale(renderPass)) break;
+		nodes.push(renderNodeTree(expandedNode, expandedScope, context, ownerJsonPath, ownerFilePath, `${instancePath}${instanceSuffix}`, renderPass, templateRenderState, parent));
+	}
+	return nodes;
 }
-function renderChildren(children, scope, context, ownerJsonPath, ownerFilePath, instancePath, seenComponentScopes, templateRenderState) {
+function renderChildren(children, scope, context, ownerJsonPath, ownerFilePath, instancePath, renderPass, templateRenderState, parent) {
 	const renderedChildren = [];
 	for (const { node: child, index } of selectConditionalChildren(children, (node) => evaluateConditionalBranch(node, scope))) {
+		if (isRenderPassStale(renderPass)) break;
 		if (!isTagNode(child)) {
-			renderedChildren.push(...renderNodeVariants(child, scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/node-${index}`, seenComponentScopes, templateRenderState));
+			renderedChildren.push(...renderNodeVariants(child, scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/node-${index}`, renderPass, templateRenderState, parent));
 			continue;
 		}
 		if (isTemplateDefinition(child) || child.name === "import" || child.name === "wxs") continue;
-		renderedChildren.push(...renderNodeVariants(child, scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/node-${index}`, seenComponentScopes, templateRenderState));
+		renderedChildren.push(...renderNodeVariants(child, scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/node-${index}`, renderPass, templateRenderState, parent));
 	}
 	return renderedChildren;
 }
@@ -17429,22 +17907,38 @@ function collectComponentSlots(componentNode, scope, ownerJsonPath, ownerFilePat
 	}
 	return slots;
 }
-function renderNodeTree(node, scope, context, ownerJsonPath, ownerFilePath, instancePath, seenComponentScopes, templateRenderState) {
+function reconcileSlotDeclarations(context, renderPass) {
+	for (const [entries, { parent, scopeId }] of renderPass.slotDeclarations) {
+		if (isRenderPassStale(renderPass)) return;
+		if (isComponentConstructing(context.componentCache.get(scopeId))) continue;
+		for (const { index } of selectConditionalChildren(entries.map((entry) => entry.node), (node, index) => evaluateConditionalBranch(node, entries[index].scope))) {
+			if (isRenderPassStale(renderPass)) return;
+			const entry = entries[index];
+			if (renderPass.renderedSlots.has(entry)) continue;
+			const nodes = renderNodeVariants(entry.node, entry.scope, context, entry.ownerJsonPath, entry.ownerFilePath, entry.instancePath, renderPass, entry.templateRenderState, parent);
+			renderPass.renderedSlots.set(entry, nodes);
+			renderPass.hasUnprojectedSlots ||= nodes.length > 0;
+		}
+	}
+}
+function renderNodeTree(node, scope, context, ownerJsonPath, ownerFilePath, instancePath, renderPass, templateRenderState, parent) {
+	if (isRenderPassStale(renderPass)) return node;
 	if (scope.wxs !== templateRenderState.wxsModules) scope = {
 		...scope,
 		wxs: templateRenderState.wxsModules
 	};
 	const clonedNode = cloneNode(node);
+	registerComponentEventNode(clonedNode, scope, parent);
 	if (!isTagNode(clonedNode)) {
 		applyNodeBindings(clonedNode, scope);
 		return clonedNode;
 	}
-	if (isTemplateDefinition(clonedNode)) return {
-		type: "tag",
-		name: "block",
-		attribs: {},
-		children: []
-	};
+	if (isTemplateDefinition(clonedNode)) {
+		clonedNode.name = "block";
+		clonedNode.attribs = {};
+		clonedNode.children = [];
+		return clonedNode;
+	}
 	const templateName = resolveTemplateCall(clonedNode, wxsScopeData(scope));
 	if (templateName) {
 		const definition = templateRenderState.definitions.get(templateName);
@@ -17453,60 +17947,75 @@ function renderNodeTree(node, scope, context, ownerJsonPath, ownerFilePath, inst
 			data: resolveTemplateData(clonedNode, wxsScopeData(scope)),
 			wxs: definition && templateRenderState.definitionWxsScopes?.get(definition)
 		};
-		const children = definition && !templateRenderState.stack.includes(templateName) ? renderChildren(definition.children ?? [], templateScope, context, ownerJsonPath, ownerFilePath, `${instancePath}/template-${templateName}`, seenComponentScopes, {
+		clonedNode.name = "block";
+		clonedNode.attribs = {
+			"data-sim-node": instancePath,
+			"data-sim-scope": scope.getScopeId()
+		};
+		clonedNode.children = definition && !templateRenderState.stack.includes(templateName) ? renderChildren(definition.children ?? [], templateScope, context, ownerJsonPath, ownerFilePath, `${instancePath}/template-${templateName}`, renderPass, {
 			definitions: templateRenderState.definitionScopes?.get(definition) ?? templateRenderState.definitions,
 			definitionScopes: templateRenderState.definitionScopes,
 			definitionWxsScopes: templateRenderState.definitionWxsScopes,
 			wxsModules: templateScope.wxs,
 			stack: [...templateRenderState.stack, templateName]
-		}) : [];
-		return {
-			type: "tag",
-			name: "block",
-			attribs: {
-				"data-sim-node": instancePath,
-				"data-sim-scope": scope.getScopeId()
-			},
-			children
-		};
+		}, clonedNode) : [];
+		return clonedNode;
 	}
 	if (clonedNode.name === "slot") {
 		const slotName = clonedNode.attribs?.name?.trim() || "default";
 		const projected = scope.slots?.get(slotName) ?? [];
-		const children = projected.length ? selectConditionalChildren(projected.map((entry) => entry.node), (node, index) => evaluateConditionalBranch(node, projected[index].scope)).flatMap(({ index }) => {
-			const entry = projected[index];
-			return renderNodeVariants(entry.node, entry.scope, context, entry.ownerJsonPath, entry.ownerFilePath, entry.instancePath, seenComponentScopes, entry.templateRenderState);
-		}) : renderChildren(clonedNode.children ?? [], scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/slot-fallback-${slotName}`, seenComponentScopes, templateRenderState);
-		return {
-			type: "tag",
-			name: "block",
-			attribs: {
-				"data-sim-node": instancePath,
-				"data-sim-scope": scope.getScopeId()
-			},
-			children
+		const fallbackChildren = clonedNode.children ?? [];
+		bindComponentEventHost(clonedNode);
+		clonedNode.name = "block";
+		clonedNode.attribs = {
+			"data-sim-node": instancePath,
+			"data-sim-scope": scope.getScopeId()
 		};
+		const slotOwner = scope.getScopeId();
+		if (projected.length && slotOwner && isComponentConstructing(context.componentCache.get(slotOwner))) {
+			clonedNode.children = [];
+			return clonedNode;
+		}
+		clonedNode.children = projected.length ? selectConditionalChildren(projected.map((entry) => entry.node), (node, index) => evaluateConditionalBranch(node, projected[index].scope)).flatMap(({ index }) => {
+			const entry = projected[index];
+			const nodes = renderNodeVariants(entry.node, entry.scope, context, entry.ownerJsonPath, entry.ownerFilePath, entry.instancePath, renderPass, entry.templateRenderState, clonedNode);
+			renderPass.renderedSlots.set(entry, nodes);
+			return nodes;
+		}) : renderChildren(fallbackChildren, scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/slot-fallback-${slotName}`, renderPass, templateRenderState, clonedNode);
+		return clonedNode;
 	}
 	const componentEntry = resolveComponentRegistryEntry(context, ownerJsonPath, ownerFilePath, clonedNode.name, scope.genericComponents?.get(clonedNode.name));
 	if (componentEntry) {
 		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);
+		registerSlotDeclarations(renderPass, slots, clonedNode, componentScopeId);
+		applyNodeBindings(clonedNode, scope);
+		const reconcilePrivateTemplate = (instance, phase) => {
+			let bindingPass;
+			do {
+				const bindingScope = createComponentScope(clonedNode, scope, componentScopeId, instance, genericComponents, slots);
+				context.componentScopes.set(componentScopeId, bindingScope);
+				bindingPass = createRenderPass(phase === "properties", renderPass);
+				renderRuntimeComponentTemplate(context, componentEntry, renderNodeTree, bindingScope, componentScopeId, bindingPass);
+				reconcileSlotDeclarations(context, bindingPass);
+			} while (isRenderPassStale(bindingPass));
+		};
 		let componentInstance = context.componentCache.get(componentScopeId);
-		if (!componentInstance) componentInstance = createRuntimeComponentInstance(componentScopeId, context, clonedNode, componentEntry, nextProperties, ownerScopeId, (instance) => {
-			const initialScope = createComponentScope(clonedNode, scope, componentScopeId, instance, genericComponents, slots);
-			context.componentScopes.set(componentScopeId, initialScope);
-			renderRuntimeComponentTemplate(context, componentEntry, renderNodeTree, initialScope, componentScopeId, /* @__PURE__ */ new Set());
-		});
-		else syncComponentProperties(componentInstance, componentInstance.__definition__ ?? componentEntry.definition, nextProperties, bindingExpressions, context.changedPageKeys);
-		seenComponentScopes.add(componentScopeId);
+		if (!componentInstance) componentInstance = createRuntimeComponentInstance(componentScopeId, context, componentEntry, nextProperties, ownerScopeId, reconcilePrivateTemplate, renderPass.propertyUpdate);
+		else {
+			context.componentScopes.set(componentScopeId, createComponentScope(clonedNode, scope, componentScopeId, componentInstance, genericComponents, slots));
+			syncComponentProperties(componentInstance, componentInstance.__definition__ ?? componentEntry.definition, nextProperties, bindingExpressions, context.changedPageKeys, reconcilePrivateTemplate);
+		}
+		if (isRenderPassStale(renderPass)) return clonedNode;
+		renderPass.seenComponentScopes.add(componentScopeId);
 		const componentScope = createComponentScope(clonedNode, scope, componentScopeId, componentInstance, genericComponents, slots);
 		context.componentScopes.set(componentScopeId, componentScope);
-		const renderedComponentRoot = renderRuntimeComponentTemplate(context, componentEntry, renderNodeTree, componentScope, componentScopeId, seenComponentScopes);
+		const renderedComponentRoot = renderRuntimeComponentTemplate(context, componentEntry, renderNodeTree, componentScope, componentScopeId, renderPass);
+		mergeComponentEventRoot(renderedComponentRoot, clonedNode);
 		if (renderedComponentRoot.attribs) {
-			applyNodeBindings(clonedNode, scope);
 			renderedComponentRoot.attribs = {
 				...clonedNode.attribs,
 				...renderedComponentRoot.attribs
@@ -17519,66 +18028,99 @@ function renderNodeTree(node, scope, context, ownerJsonPath, ownerFilePath, inst
 			renderedComponentRoot.attribs["data-sim-node"] = instancePath;
 			renderedComponentRoot.attribs["data-sim-scope"] = componentScopeId;
 		}
+		renderPass.componentRoots.set(componentScopeId, renderedComponentRoot);
 		return renderedComponentRoot;
 	}
 	applyNodeBindings(clonedNode, scope);
 	clonedNode.attribs["data-sim-node"] = instancePath;
-	clonedNode.children = renderChildren(clonedNode.children ?? [], scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/${clonedNode.name}`, seenComponentScopes, templateRenderState);
+	clonedNode.children = renderChildren(clonedNode.children ?? [], scope, context, ownerJsonPath, ownerFilePath, `${instancePath}/${clonedNode.name}`, renderPass, templateRenderState, clonedNode);
 	return clonedNode;
 }
+function reconcileRuntimePageTree(context, page, bindingsOnly = false) {
+	for (;;) {
+		bindAttachmentBindingScope(context, page);
+		if (page.__lastChangedKeys__) context.changedPageKeys = page.__lastChangedKeys__;
+		const route = page.route.replace(LEADING_SLASH_RE$4, "");
+		const resourcePath = context.project.routes.find((item) => item.route === route)?.resourcePath ?? route;
+		const templatePath = path.resolve(context.project.miniprogramRootPath, `${resourcePath}.wxml`);
+		const document = parseTemplateDocument(readTemplateSource(context.artifactSource, templatePath));
+		const pageScopeId = `page:${route}`;
+		const pageScope = {
+			data: page.data,
+			getMethod: (methodName) => {
+				const method = page[methodName];
+				return typeof method === "function" ? method.bind(page) : void 0;
+			},
+			getScopeId: () => pageScopeId,
+			id: "page-root"
+		};
+		for (const scopeId of context.componentScopes.keys()) if (scopeId === pageScopeId || scopeId.startsWith(`${pageScopeId}/`)) context.componentScopes.delete(scopeId);
+		context.componentScopes.set(pageScopeId, pageScope);
+		const renderPass = createPageRenderPass(page, context.componentCache);
+		const root = (document.children ?? [])[0] ?? document;
+		const templateRenderState = prepareTemplateRenderState(context.artifactSource, root, templatePath, context.project.miniprogramRootPath, getRuntimeWxsLoader(context.moduleLoader, context.artifactSource));
+		const renderedRoot = renderNodeTree(root, pageScope, context, path.resolve(context.project.miniprogramRootPath, `${resourcePath}.json`), `${resourcePath}.js`, pageScopeId, renderPass, templateRenderState);
+		const roots = [renderedRoot];
+		if (hasCustomTabBar(context.project.appConfig, route)) roots.push(renderNodeTree({
+			type: "tag",
+			name: "custom-tab-bar",
+			attribs: {},
+			children: []
+		}, customTabBarHostScope(), context, path.resolve(context.project.miniprogramRootPath, "app.json"), "app.js", pageScopeId, renderPass, templateRenderState));
+		reconcileSlotDeclarations(context, renderPass);
+		if (isRenderPassStale(renderPass)) continue;
+		markPageTreeConstructed(page, context.componentCache);
+		const treeRoot = roots.length > 1 ? {
+			type: "root",
+			children: roots
+		} : renderedRoot;
+		linkRenderedParents(treeRoot);
+		registerInspectionTrees(treeRoot, renderPass, context.componentScopes);
+		if (bindingsOnly) return {
+			root: treeRoot,
+			roots
+		};
+		let bindingsRefreshed = false;
+		const updateBindings = () => {
+			bindingsRefreshed = true;
+			if (hasPendingComponentConstruction(context.componentCache)) return;
+			reconcileRuntimePageTree(context, page, true);
+		};
+		const pageAttached = attachComponentPage(page, updateBindings);
+		if (bindingsRefreshed) continue;
+		const pageAttaching = isComponentPageAttaching(page);
+		const scopeIds = orderComponentAttachmentScopes(renderPass.seenComponentScopes, context.componentScopes);
+		const instances = scopeIds.map((scopeId) => context.componentCache.get(scopeId));
+		const attached = !pageAttaching && runWithAttachmentBindingUpdates(page, updateBindings, (scopes) => flushComponentAttachments(context.componentCache, scopes, (instance) => {
+			runComponentLifecycle(instance, "attached");
+			return bindingsRefreshed;
+		}), scopeIds);
+		if (attached === "restart") continue;
+		const canFinalize = !pageAttaching && !hasPendingComponentAttachments(instances);
+		const removed = canFinalize ? [...context.componentCache].filter(([scopeId]) => scopeId.startsWith(`${pageScopeId}/`) && !renderPass.seenComponentScopes.has(scopeId)) : [];
+		for (const [scopeId, instance] of removed) if (isComponentAttached(instance)) runComponentLifecycle(instance, "detached");
+		else scheduleDiscardedComponentReady(context.componentCache, scopeId, instance);
+		const relationsChanged = canFinalize && syncComponentRelations(context.componentCache, renderPass.seenComponentScopes, pageScopeId);
+		for (const [scopeId] of removed) {
+			context.componentCache.delete(scopeId);
+			context.componentScopes.delete(scopeId);
+		}
+		if (pageAttached || attached || relationsChanged) continue;
+		if (canFinalize && !isPageBeforeReady(page)) flushDiscardedComponentReady(context.componentCache, pageScopeId, (instance) => runComponentLifecycle(instance, "ready"));
+		if (canFinalize && !isPageBeforeReady(page) && flushComponentReady(instances, (instance) => {
+			runComponentLifecycle(instance, "ready");
+			if (instance !== context.componentCache.get(customTabBarScopeId(route))) instance.__definition__?.pageLifetimes?.show?.call(instance);
+		})) continue;
+		return {
+			root: treeRoot,
+			roots
+		};
+	}
+}
 function renderRuntimePageTree(context, page) {
-	const route = page.route.replace(LEADING_SLASH_RE$4, "");
-	const resourcePath = context.project.routes.find((item) => item.route === route)?.resourcePath ?? route;
-	const templatePath = path.resolve(context.project.miniprogramRootPath, `${resourcePath}.wxml`);
-	const document = parseTemplateDocument(readTemplateSource(context.artifactSource, templatePath));
-	const pageScopeId = `page:${route}`;
-	const pageScope = {
-		data: page.data,
-		getMethod: (methodName) => {
-			const method = page[methodName];
-			return typeof method === "function" ? method.bind(page) : void 0;
-		},
-		getScopeId: () => pageScopeId,
-		id: "page-root"
-	};
-	for (const scopeId of context.componentScopes.keys()) if (scopeId === pageScopeId || scopeId.startsWith(`${pageScopeId}/`)) context.componentScopes.delete(scopeId);
-	context.componentScopes.set(pageScopeId, pageScope);
-	const seenComponentScopes = /* @__PURE__ */ new Set();
-	const root = (document.children ?? [])[0] ?? document;
-	const templateRenderState = prepareTemplateRenderState(context.artifactSource, root, templatePath, context.project.miniprogramRootPath, getRuntimeWxsLoader(context.moduleLoader, context.artifactSource));
-	const renderedRoot = renderNodeTree(root, pageScope, context, path.resolve(context.project.miniprogramRootPath, `${resourcePath}.json`), `${resourcePath}.js`, pageScopeId, seenComponentScopes, templateRenderState);
-	const roots = [renderedRoot];
-	if (hasCustomTabBar(context.project.appConfig, route)) roots.push(renderNodeTree({
-		type: "tag",
-		name: "custom-tab-bar",
-		attribs: {},
-		children: []
-	}, customTabBarHostScope(), context, path.resolve(context.project.miniprogramRootPath, "app.json"), "app.js", pageScopeId, seenComponentScopes, templateRenderState));
-	const pageAttached = attachComponentPage(page);
-	const pageAttaching = isComponentPageAttaching(page);
-	const attached = !pageAttaching && flushComponentAttachments([...seenComponentScopes].map((scopeId) => context.componentCache.get(scopeId)), (instance) => runComponentLifecycle(instance, "attached"));
-	const removed = [...context.componentCache].filter(([scopeId]) => scopeId.startsWith(`${pageScopeId}/`) && !seenComponentScopes.has(scopeId));
-	for (const [scopeId, instance] of removed) if (isComponentAttached(instance)) runComponentLifecycle(instance, "detached");
-	else scheduleDiscardedComponentReady(context.componentCache, scopeId, instance);
-	const instances = [...seenComponentScopes].map((scopeId) => context.componentCache.get(scopeId));
-	const relationsChanged = !pageAttaching && !hasPendingComponentAttachments(instances) && syncComponentRelations(context.componentCache, seenComponentScopes, pageScopeId);
-	for (const [scopeId] of removed) {
-		context.componentCache.delete(scopeId);
-		context.componentScopes.delete(scopeId);
-	}
-	if (pageAttached || attached || relationsChanged) return renderRuntimePageTree(context, page);
-	if (!isPageBeforeReady(page)) flushDiscardedComponentReady(context.componentCache, pageScopeId, (instance) => runComponentLifecycle(instance, "ready"));
-	if (!isPageBeforeReady(page) && flushComponentReady(instances, (instance) => {
-		runComponentLifecycle(instance, "ready");
-		if (instance !== context.componentCache.get(customTabBarScopeId(route))) instance.__definition__?.pageLifetimes?.show?.call(instance);
-	})) return renderRuntimePageTree(context, page);
-	const treeRoot = roots.length > 1 ? {
-		type: "root",
-		children: roots
-	} : renderedRoot;
-	linkRenderedParents(treeRoot);
+	const { root, roots } = reconcileRuntimePageTree(context, page);
 	return {
-		root: treeRoot,
+		root,
 		wxml: roots.map(serializeDomNode$1).join("")
 	};
 }
@@ -17602,15 +18144,23 @@ function createDuplicateRegistrationError(kind, id) {
 function callDefinitionMethod(instance, method, args) {
 	if (typeof method === "function") return method.apply(instance, args);
 }
+function composeDefinitionMethods(primary, secondary) {
+	if (typeof primary !== "function" || typeof secondary !== "function" || primary === secondary) return primary ?? secondary;
+	return function composedDefinitionMethod(...args) {
+		const result = primary.apply(this, args);
+		secondary.apply(this, args);
+		return result;
+	};
+}
 function normalizeComponentPageDefinition(definition) {
 	const { lifetimes = {}, methods = {}, pageLifetimes = {}, ...rest } = definition;
 	const created = lifetimes.created ?? rest.created;
 	const attached = lifetimes.attached ?? rest.attached;
-	const ready = lifetimes.ready ?? rest.ready ?? methods.onReady ?? rest.onReady;
+	const ready = composeDefinitionMethods(lifetimes.ready ?? rest.ready, methods.onReady ?? rest.onReady);
 	const detached = lifetimes.detached ?? rest.detached ?? methods.onUnload ?? rest.onUnload;
 	const load = methods.onLoad ?? rest.onLoad;
-	const show = pageLifetimes.show ?? methods.onShow ?? rest.onShow;
-	const hide = pageLifetimes.hide ?? methods.onHide ?? rest.onHide;
+	const show = typeof pageLifetimes.show === "function" ? composeDefinitionMethods(pageLifetimes.show, methods.onShow) : methods.onShow ?? rest.onShow;
+	const hide = typeof pageLifetimes.hide === "function" ? composeDefinitionMethods(pageLifetimes.hide, methods.onHide) : methods.onHide ?? rest.onHide;
 	const resize = pageLifetimes.resize ?? methods.onResize ?? rest.onResize;
 	const routeDone = pageLifetimes.routeDone ?? methods.onRouteDone ?? rest.onRouteDone;
 	const pageDefinition = {
@@ -17638,10 +18188,7 @@ function normalizeComponentPageDefinition(definition) {
 			return callDefinitionMethod(this, routeDone, args);
 		}
 	};
-	registerComponentPageAttachment(pageDefinition, function() {
-		callDefinitionMethod(this, created, []);
-		callDefinitionMethod(this, attached, []);
-	});
+	registerComponentPageAttachment(pageDefinition, (instance) => callDefinitionMethod(instance, created, []), (instance) => callDefinitionMethod(instance, attached, []));
 	return pageDefinition;
 }
 function createHostRegistries() {
@@ -17775,7 +18322,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;
@@ -17826,7 +18379,7 @@ function resolveCapabilityValue(source, schema) {
 	}
 	return current;
 }
-function createHeadlessWx(driver, runtimeConsole = console) {
+function createHeadlessWx(driver, runtimeConsole = console, workers) {
 	const eventBus = createHeadlessUniEventBus();
 	const rpx2px = (value) => {
 		const width = driver.getWindowInfoSync().windowWidth;
@@ -17834,6 +18387,10 @@ function createHeadlessWx(driver, runtimeConsole = console) {
 	};
 	const capabilityTree = {
 		canIUse: true,
+		...workers ? {
+			createWorker: true,
+			preDownloadSubpackage: true
+		} : {},
 		canvasToTempFilePath: true,
 		chooseImage: { return: {
 			errMsg: true,
@@ -18034,6 +18591,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 +18646,16 @@ function createHeadlessWx(driver, runtimeConsole = console) {
 	};
 	return {
 		...eventBus,
+		[WEVU_ROUTE_EVENT_CONTRACT_KEY]: 1,
+		[WEVU_PAGE_SCROLL_EVENT_CONTRACT_KEY]: 1,
+		createWorker: (script) => {
+			if (!workers) throw new Error("Worker host is unavailable");
+			return workers.createWorker(script);
+		},
+		preDownloadSubpackage: (option) => {
+			if (!workers) throw new Error("Worker host is unavailable");
+			workers.preDownloadSubpackage(option);
+		},
 		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),
@@ -18204,10 +18779,16 @@ function createHeadlessWx(driver, runtimeConsole = console) {
 		navigateBack: (option) => runNavigationApi(driver, option, (deferred) => invokeWxApi(() => {
 			driver.navigateBack(deferred);
 		}, deferred)),
-		navigateTo: (option) => runNavigationApi(driver, option, (deferred) => invokeWxApi(() => {
-			driver.navigateTo(deferred);
-		}, deferred)),
+		navigateTo: (option) => runNavigationApi(driver, option, (deferred) => driver.navigateTo(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 +18948,7 @@ var RuntimeScheduler = class {
 	intervals = /* @__PURE__ */ new Set();
 	timeouts = /* @__PURE__ */ new Set();
 	closed = false;
+	canceledHandle;
 	onError;
 	constructor(onError) {
 		this.onError = onError;
@@ -18388,7 +18970,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 +18981,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 +18993,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 +19005,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
@@ -18645,6 +19235,34 @@ function loadProject(projectPath) {
 	});
 }
 //#endregion
+//#region ../../mpcore/packages/simulator/src/view/eventBinding.ts
+function resolveMiniProgramEventBinding(attributes, eventName) {
+	return resolveEventBindingPhases(attributes, eventName, false)?.bubble ?? 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
+	};
+}
+//#endregion
 //#region ../../node_modules/.pnpm/boolbase@2.0.0/node_modules/boolbase/dist/index.js
 function trueFunc() {
 	return true;
@@ -20071,23 +20689,31 @@ function appendNextSiblings(element, adapter) {
 const selectAll = getSelectorFunction((query, elements, options) => query === falseFunc || !elements || elements.length === 0 ? [] : findAll(query, elements, options));
 //#endregion
 //#region ../../mpcore/packages/simulator/src/view/selectors.ts
-const adapter = {
-	isTag: (node) => node.type === "tag",
-	getAttributeValue: (node, name) => node.attribs?.[name],
-	getChildren: (node) => node.children ?? [],
-	getName: (node) => node.name ?? "",
-	getParent: (node) => node.parent ?? null,
-	getSiblings: (node) => node.parent?.children ?? [node],
-	getText: (node) => node.type === "text" ? node.data ?? "" : (node.children ?? []).map((child) => adapter.getText(child)).join(""),
-	hasAttrib: (node, name) => Object.hasOwn(node.attribs ?? {}, name),
-	removeSubsets: (nodes) => {
-		const unique = new Set(nodes);
-		return [...unique].filter((node) => {
-			for (let parent = node.parent; parent; parent = parent.parent) if (unique.has(parent)) return false;
-			return true;
-		});
-	}
-};
+function createAdapter(getChildren, getParent) {
+	const adapter = {
+		isTag: (node) => node.type === "tag",
+		getAttributeValue: (node, name) => node.attribs?.[name],
+		getChildren,
+		getName: (node) => node.name ?? "",
+		getParent,
+		getSiblings: (node) => {
+			const parent = getParent(node);
+			return parent ? getChildren(parent) : [node];
+		},
+		getText: (node) => node.type === "text" ? node.data ?? "" : getChildren(node).map((child) => adapter.getText(child)).join(""),
+		hasAttrib: (node, name) => Object.hasOwn(node.attribs ?? {}, name),
+		removeSubsets: (nodes) => {
+			const unique = new Set(nodes);
+			return [...unique].filter((node) => {
+				for (let parent = getParent(node); parent; parent = getParent(parent)) if (unique.has(parent)) return false;
+				return true;
+			});
+		}
+	};
+	return adapter;
+}
+const renderedAdapter = createAdapter((node) => node.children ?? [], (node) => node.parent ?? null);
+const inspectionAdapter = createAdapter(getInspectionChildren, getInspectionParent);
 function resolveComponentTags(selectors) {
 	return selectors.map((group) => group.map((token) => {
 		if (token.type === SelectorType.Pseudo && Array.isArray(token.data)) return {
@@ -20110,7 +20736,7 @@ function resolveComponentTags(selectors) {
 		};
 	}));
 }
-function querySelectorAll(root, selector) {
+function queryWithAdapter(root, selector, adapter) {
 	const parsed = parse$1(selector);
 	const query = resolveComponentTags(parsed);
 	const includesPageRoot = root.type === "tag" && root.name === "page" && parsed.some((group) => group.some((token) => token.type === SelectorType.Tag && token.name === "page"));
@@ -20119,6 +20745,12 @@ function querySelectorAll(root, selector) {
 		cacheResults: false
 	});
 }
+function querySelectorAll(root, selector) {
+	return queryWithAdapter(root, selector, renderedAdapter);
+}
+function queryInspectionSelectorAll(root, selector) {
+	return queryWithAdapter(root, selector, inspectionAdapter);
+}
 //#endregion
 //#region ../../node_modules/.pnpm/whynot@5.0.0/node_modules/whynot/dist/whynot.umd.cjs
 var require_whynot_umd = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -37866,7 +38498,10 @@ var import_fontoxpath = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin((
 	});
 })))(), 1);
 const xpathEngine = Reflect.get(import_fontoxpath, "default") ?? import_fontoxpath;
-function wrapNode(source, parent = null) {
+function getRenderedChildren(node) {
+	return node.children ?? [];
+}
+function wrapNode(source, getChildren, parent = null) {
 	const node = {
 		attributes: [],
 		children: [],
@@ -37889,7 +38524,7 @@ function wrapNode(source, parent = null) {
 		prefix: null,
 		value
 	}));
-	node.children = (source.children ?? []).map((child) => wrapNode(child, node));
+	node.children = getChildren(source).map((child) => wrapNode(child, getChildren, node));
 	return node;
 }
 function sibling(node, offset) {
@@ -37909,40 +38544,25 @@ const domFacade = {
 	getParentNode: (node) => node.parent,
 	getPreviousSibling: (node) => sibling(node, -1)
 };
-function queryXPathElements(root, expression) {
+function queryElements(root, expression, getChildren) {
 	if (!expression.trim()) throw new Error("XPath must be a non-empty expression in headless testing runtime.");
 	const document = wrapNode(root.type === "root" ? root : {
 		type: "root",
 		children: [root]
-	});
+	}, getChildren);
 	return xpathEngine.evaluateXPathToNodes(expression, document, domFacade).filter((node) => node.nodeType === 1).map((node) => node.source);
 }
+function queryXPathElements(root, expression) {
+	return queryElements(root, expression, getRenderedChildren);
+}
+function queryInspectionXPathElements(root, expression) {
+	return queryElements(root, expression, getInspectionChildren);
+}
 //#endregion
 //#region ../../mpcore/packages/simulator/src/view/nodeHandle.ts
 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,
@@ -37984,7 +38604,7 @@ var HeadlessTestingNodeHandle = class HeadlessTestingNodeHandle {
 		this.interactions?.assertActive?.();
 	}
 	query(selector) {
-		const nodes = querySelectorAll(this.node, selector);
+		const nodes = (this.interactions?.projectionOnly ? querySelectorAll : queryInspectionSelectorAll)(this.node, selector);
 		const scope = this.node.attribs?.["data-sim-scope"];
 		if (!scope || !this.interactions) return nodes;
 		return nodes.filter((node) => {
@@ -38003,7 +38623,7 @@ var HeadlessTestingNodeHandle = class HeadlessTestingNodeHandle {
 	}
 	async getElementsByXpath(expression) {
 		this.assertActive();
-		return queryXPathElements(this.node, expression).map((node) => new HeadlessTestingNodeHandle(node, this.interactions));
+		return (this.interactions?.projectionOnly ? queryXPathElements : queryInspectionXPathElements)(this.node, expression).map((node) => new HeadlessTestingNodeHandle(node, this.interactions));
 	}
 	async attr(name) {
 		this.assertActive();
@@ -38052,9 +38672,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 +38790,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 +38827,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 +39082,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" };
@@ -39090,6 +39904,136 @@ var HeadlessAppLifecycle = class {
 	}
 };
 //#endregion
+//#region ../../mpcore/packages/simulator/src/runtime/workerHost.ts
+/** 两种 simulator 共用消息与生命周期；每个 worker 独立模块缓存、全局对象及计时器。 */
+function createWorkerHost(options) {
+	const active = /* @__PURE__ */ new Set();
+	let closed = false;
+	const configuredRoot = () => {
+		return JSON.parse(options.read(join(options.root, "app.json")) ?? "{}").workers;
+	};
+	return {
+		apis: {
+			preDownloadSubpackage(option) {
+				const config = configuredRoot();
+				if (option.packageType !== "workers" || typeof config !== "object" || !config.isSubpackage) {
+					const error = /* @__PURE__ */ new Error("preDownloadSubpackage:fail workers subpackage is not configured");
+					option.fail?.(error);
+					option.complete?.();
+					return;
+				}
+				const result = { errMsg: "preDownloadSubpackage:ok" };
+				option.success?.(result);
+				option.complete?.(result);
+			},
+			createWorker(scriptPath) {
+				if (closed) throw new Error("createWorker:fail runtime has closed");
+				const config = configuredRoot();
+				const directory = typeof config === "string" ? config : config?.path;
+				if (!directory || typeof scriptPath !== "string" || !scriptPath.endsWith(".js")) throw new Error("createWorker:fail invalid worker path");
+				const root = normalize(join(options.root, directory));
+				const entry = normalize(join(options.root, scriptPath));
+				const inside = (file) => file.startsWith(`${root}/`);
+				if (!inside(entry) || options.read(entry) === void 0) throw new Error("createWorker:fail worker entry is outside the configured directory or missing");
+				const messages = /* @__PURE__ */ new Set();
+				const incoming = /* @__PURE__ */ new Set();
+				const errors = /* @__PURE__ */ new Set();
+				const cache = /* @__PURE__ */ new Map();
+				let terminated = false;
+				const scheduler = new RuntimeScheduler((error) => {
+					const value = { message: error instanceof Error ? error.message : String(error) };
+					if (errors.size) for (const listener of errors) listener(value);
+					else options.console.error(value.message);
+				});
+				const post = (listeners, message) => {
+					if (terminated) return;
+					const copy = structuredClone(message);
+					scheduler.setTimeout(() => {
+						for (const listener of [...listeners]) {
+							if (terminated) break;
+							listener(copy);
+						}
+					}, 0);
+				};
+				const globals = {
+					wx: void 0,
+					App: void 0,
+					Page: void 0,
+					Component: void 0,
+					getApp: void 0,
+					console: options.console,
+					worker: {
+						onMessage: (listener) => incoming.add(listener),
+						postMessage: (message) => post(messages, message)
+					},
+					setTimeout: scheduler.setTimeout.bind(scheduler),
+					clearTimeout: scheduler.clearTimeout.bind(scheduler),
+					setInterval: scheduler.setInterval.bind(scheduler),
+					clearInterval: scheduler.clearInterval.bind(scheduler)
+				};
+				globals.globalThis = globals;
+				const execute = options.createExecutor(globals);
+				const load = (file) => {
+					if (terminated) return;
+					if (!inside(file)) throw new Error("Worker require cannot leave its configured directory");
+					if (cache.has(file)) return cache.get(file).exports;
+					const source = options.read(file);
+					if (source === void 0) throw new Error(`Missing worker module: ${file}`);
+					if (file.endsWith(".json")) return JSON.parse(source);
+					const module = { exports: {} };
+					cache.set(file, module);
+					const require = Object.assign((request) => {
+						const target = resolveMiniProgramModule(file, request, root, (candidate) => options.read(candidate) !== void 0);
+						if (!target) throw new Error(`Cannot resolve worker module: ${request}`);
+						return load(target);
+					}, { async: (request) => Promise.resolve().then(() => require(request)) });
+					try {
+						execute(source, file, module, require);
+					} catch (error) {
+						cache.delete(file);
+						throw error;
+					}
+					return module.exports;
+				};
+				const worker = {
+					onMessage: (listener) => {
+						messages.add(listener);
+					},
+					offMessage: (listener) => {
+						if (listener) messages.delete(listener);
+						else messages.clear();
+					},
+					postMessage: (message) => post(incoming, message),
+					onError: (listener) => {
+						errors.add(listener);
+					},
+					offError: (listener) => {
+						if (listener) errors.delete(listener);
+						else errors.clear();
+					},
+					terminate() {
+						if (terminated) return;
+						terminated = true;
+						scheduler.close();
+						messages.clear();
+						incoming.clear();
+						errors.clear();
+						cache.clear();
+						active.delete(worker);
+					}
+				};
+				active.add(worker);
+				scheduler.setTimeout(() => load(entry), 0);
+				return worker;
+			}
+		},
+		close() {
+			closed = true;
+			for (const worker of active) worker.terminate();
+		}
+	};
+}
+//#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/runtimeGlobals.ts
 const MINI_PROGRAM_UNAVAILABLE_GLOBAL_NAMES = [
 	"window",
@@ -39232,9 +40176,9 @@ function transformEsmToCommonJs(source) {
 function createRequireNotFoundError(request, importer) {
 	return /* @__PURE__ */ new Error(`Cannot resolve require("${request}") from ${normalize(importer)} in headless runtime.`);
 }
-function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, kernel, globals, onConsole) {
+function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, kernel, globals, onConsole, workers) {
 	const runtimeConsole = kernel.diagnostics.createConsole(console, onConsole);
-	const wx = createHeadlessWx(wxDriver, runtimeConsole);
+	const wx = createHeadlessWx(wxDriver, runtimeConsole, workers);
 	return createMiniProgramRuntimeGlobals({
 		App(definition) {
 			return registerAppDefinition(registries, definition);
@@ -39267,8 +40211,19 @@ function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, k
 	}, globals);
 }
 function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, options) {
+	const workers = createWorkerHost({
+		root: options.miniprogramRootPath,
+		read: (file) => options.artifactSource.readText(file),
+		console: options.kernel.diagnostics.createConsole(console, options.onConsole),
+		createExecutor(globals) {
+			const realm = vm.createContext(globals);
+			return (source, file, module, require) => {
+				new vm.Script(`(function(module, exports, require) {${source}\n})`, { filename: file }).runInContext(realm)(module, module.exports, require);
+			};
+		}
+	});
 	const moduleCache = /* @__PURE__ */ new Map();
-	const executionContext = createExecutionContext(registries, getCurrentPages, getApp, wxDriver, options.kernel, options.globals ?? {}, options.onConsole);
+	const executionContext = createExecutionContext(registries, getCurrentPages, getApp, wxDriver, options.kernel, options.globals ?? {}, options.onConsole, workers.apis);
 	executionContext.globalThis = executionContext;
 	function executeModule(filePath, loadContext) {
 		const resolvedPath = path.resolve(filePath);
@@ -39327,6 +40282,7 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
 			return callback(...args);
 		},
 		close() {
+			workers.close();
 			moduleCache.clear();
 			closeRuntimeWxsLoader(loader);
 		},
@@ -39359,6 +40315,142 @@ 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;
+	activeState;
+	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) {
+		this.cancel(this.activeState, /* @__PURE__ */ new Error("navigateTo:fail navigation was superseded"));
+		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);
+		const next = {
+			webviewId: event.webviewId,
+			ready: state?.ready ?? false,
+			event,
+			committed: false,
+			completed: false
+		};
+		this.pages.set(page, next);
+		if (this.activeEvent === event) this.activeState = next;
+	}
+	/** 原生 navigateTo 的回调属于本次路由记录，不能以当前页面或提交栈代替完成。 */
+	navigateTo(operation, callbacks) {
+		let state;
+		try {
+			state = this.pages.get(operation());
+		} catch (error) {
+			this.settle(callbacks, error);
+			return;
+		}
+		if (!state || state.canceled) this.settle(callbacks, state?.canceled ?? /* @__PURE__ */ new Error("navigateTo:fail target page was unloaded"));
+		else if (state.completed) this.settle(callbacks);
+		else state.callbacks = callbacks;
+	}
+	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 (state.completed || state.canceled || this.pages.get(page) !== state || this.activeEvent !== state.event || !this.isCurrentPage(page)) return;
+			state.completed = true;
+			const callbacks = state.callbacks;
+			state.callbacks = void 0;
+			try {
+				this.bus.$emit("appRouteDone", state.event);
+			} finally {
+				this.settle(callbacks);
+			}
+		});
+	}
+	settle(callbacks, error) {
+		try {
+			if (error) callbacks?.fail?.(error);
+			else callbacks?.success?.();
+		} finally {
+			callbacks?.complete?.();
+		}
+	}
+	cancel(state, error) {
+		if (!state || state.completed || state.canceled) return;
+		state.canceled = error;
+		const callbacks = state.callbacks;
+		state.callbacks = void 0;
+		this.settle(callbacks, error);
+	}
+	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.cancel(state, /* @__PURE__ */ new Error("navigateTo:fail target page was unloaded"));
+		this.pages.delete(page);
+	}
+	close() {
+		this.cancel(this.activeState, /* @__PURE__ */ new Error("navigateTo:fail runtime session closed"));
+		this.activeState = void 0;
+		this.activeEvent = void 0;
+		this.bus.$off();
+	}
+};
+//#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/systemInfo.ts
 function createDefaultLocationResult() {
 	return {
@@ -40153,7 +41245,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 +42293,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 +42321,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();
@@ -41278,7 +42374,7 @@ var HeadlessSession = class {
 			getMenuButtonBoundingClientRect: () => deriveMenuButtonBoundingClientRect(this.systemInfo),
 			getNetworkType: () => this.wxState.getNetworkType(),
 			navigateBack: (option) => this.navigateBack(option?.delta),
-			navigateTo: (option) => this.navigateTo(option.url),
+			navigateTo: (option) => this.routeEvents.navigateTo(() => this.navigateTo(option.url), option),
 			pageScrollTo: (option) => this.pageScrollTo(option),
 			openDocument: (option) => this.wxState.openDocument(option),
 			clearStorageSync: () => this.wxState.clearStorageSync(),
@@ -41295,6 +42391,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 +42451,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 +42489,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 +42578,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 +42591,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 +42643,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();
@@ -41549,19 +42689,19 @@ var HeadlessSession = class {
 		return this.wxState.getShareMenu();
 	}
 	selectComponent(selector) {
-		this.renderCurrentPage();
+		if (!hasPendingComponentConstruction(this.componentCache)) this.renderCurrentPage();
 		return this.selectComponentsWithin(null, selector)[0] ?? null;
 	}
 	selectAllComponents(selector) {
-		this.renderCurrentPage();
+		if (!hasPendingComponentConstruction(this.componentCache)) this.renderCurrentPage();
 		return this.selectComponentsWithin(null, selector);
 	}
 	selectComponentWithin(scopeId, selector) {
-		this.renderCurrentPage();
+		if (!hasPendingComponentConstruction(this.componentCache)) this.renderCurrentPage();
 		return this.selectComponentsWithin(scopeId, selector)[0] ?? null;
 	}
 	selectAllComponentsWithin(scopeId, selector) {
-		this.renderCurrentPage();
+		if (!hasPendingComponentConstruction(this.componentCache)) this.renderCurrentPage();
 		return this.selectComponentsWithin(scopeId, selector);
 	}
 	selectOwnerComponent(scopeId) {
@@ -41804,11 +42944,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 +42959,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 +42974,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 +42992,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 +43020,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 +43031,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 +43044,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 +43140,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 +43166,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 +43195,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 +43261,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 +43441,8 @@ 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,
+		projectionOnly: options.projectionOnly,
+		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];
@@ -42612,7 +43804,18 @@ var HeadlessTestingPageHandle = class {
 	renderedAccess() {
 		return {
 			assertActive: () => this.assertActive(),
-			findAll: async (selector) => await this.$$(selector),
+			findAll: async (selector) => {
+				this.assertActive();
+				const root = createPageRootNodeHandle({
+					assertActive: () => this.assertActive(),
+					createPageHandle: () => this,
+					page: this.page,
+					project: this.project,
+					projectionOnly: true,
+					session: this.session
+				});
+				return selector === "page" ? [root] : await root.$$(selector);
+			},
 			waitFor: async (ms) => await this.waitFor(ms),
 			wxml: async () => await this.wxml()
 		};
@@ -42690,11 +43893,19 @@ 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.disconnect();
+	}
+	/** 无头会话独占本地 runtime；同步释放与 automator 的连接清理契约一致。 */
+	disconnect() {
 		this.session.close();
 	}
 	async toolInfo() {
@@ -42734,6 +43945,10 @@ var HeadlessTestingSessionHandle = class {
 		const normalizedMethodName = normalizeNonEmptyInput(methodName, "wx method name");
 		return await runWithTimeout(() => this.session.callWxMethod(normalizedMethodName, ...args), options.timeout, `Timed out calling wx.${normalizedMethodName} in headless testing runtime.`);
 	}
+	/** 返回与 DevTools automator 兼容的运行时系统信息。 */
+	async systemInfo() {
+		return await this.callWxMethod("getSystemInfoSync");
+	}
 	async scopeSnapshot(scopeId) {
 		const normalizedScopeId = normalizeNonEmptyInput(scopeId, "Scope id");
 		return this.session.getScopeSnapshot(normalizedScopeId);
@@ -42761,23 +43976,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 +44029,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();