@weapp-vite/miniprogram-automator 1.2.13 → 1.2.14

package/README.md

@@ -107,6 +107,25 @@ await button?.tap()
 await page.waitFor(500)
 ```
 
+### 4.5 App-Service 降级（route fallback）能力边界
+
+部分 DevTools 版本（如 `2.01.2510290`）的 page-frame 定向协议失效，表现为 `Page.*` RPC 全部超时。此时本库自动切换到 App-Service 降级通道（`App.callFunction` + `wx.createSelectorQuery`），无需任何配置。
+
+降级模式下各能力可用性：
+
+| 能力                                                      | 状态        | 说明                                                                                           |
+| --------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------- |
+| `page.$` / `page.$$`                                      | ✅          | 经 route 查询返回降级元素                                                                      |
+| `page.data()` / `page.setData()` / `page.callMethod()`    | ✅          | 经 App-Service 读写页面数据、调用页面方法                                                      |
+| `element.offset()` / `element.size()` / `element.style()` | ✅          | 实时经 `createSelectorQuery` 读取 rect 与 computedStyle（每次读取都重新查询，不缓存）          |
+| `element.attribute('id')` / `element.attribute('data-*')` | ✅          | 经快照读取 id 与 dataset                                                                       |
+| `element.$()` / `element.$$()`                            | ❌ 明确报错 | 元素级查询依赖 page-frame 协议；请改用 `page.$()` / `page.$$()`                                |
+| `element.text()`                                          | ❌ 明确报错 | `SelectorQuery` 无法读取 `innerText`；请改用 `page.data()` 或 `page.callMethod()` 断言文案来源 |
+| `element.tap()` / `trigger()` 等真实交互                  | ❌ 明确报错 | AppService 无法合成真实触摸事件；请改用 `page.callMethod()` 或 `evaluate` 间接触发页面逻辑     |
+| `scroll-view` 容器滚动                                    | ❌          | 需 page-frame 协议支持，降级模式不可用                                                         |
+
+> 降级元素上的不支持操作会**立即抛出带替代建议的错误**，不会再像旧版那样挂起 30s 才超时。
+
 ## 5. 主要导出
 
 | 导出                      | 说明                                     |

package/dist/index.d.mts

@@ -94,6 +94,12 @@ interface IElementOptions {
   videoId?: string;
   pageId: number;
   routeFallback?: boolean;
+  /** route 降级元素的定位信息:用于只读方法经 App-service 实时重查快照。 */
+  routeFallbackSelector?: string;
+  routeFallbackIndex?: number;
+  routeFallbackRoute?: string;
+  routeFallbackQuery?: Record<string, any>;
+  routeFallbackScopeSelectors?: string[];
   tagName: string;
 }
 /** ITouch 的类型定义。 */
@@ -123,7 +129,7 @@ interface ElementQueryOptions {
 }
 /** Element 的实现。 */
 declare class Element {
-  private connection;
+  protected readonly connection: Connection;
   private elementMap;
   tagName: string;
   protected nodeId: string | null;

package/dist/index.mjs

@@ -222,6 +222,223 @@ function toStr(value) {
 	return value == null ? "" : String(value);
 }
 //#endregion
+//#region src/pageRouteSnapshot.ts
+const ROUTE_ELEMENT_SNAPSHOT_TIMEOUT = 5e3;
+const ROUTE_ELEMENT_SNAPSHOT_EMPTY_RETRIES = 2;
+const ROUTE_ELEMENT_SNAPSHOT_RETRY_DELAY = 220;
+/**
+* 页面定位 + 组件作用域遍历逻辑与 Page.renderedNodes 保持一致:
+* 先按 route/query 找到目标页面,再逐层进入自定义组件作用域查询,
+* 返回首个命中作用域里 selectAll(selector)[index] 的快照;未命中返回 null。
+*/
+const ROUTE_ELEMENT_SNAPSHOT_FUNCTION_DECLARATION = `function (route, query, selector, index, scopeSelectors, styleNames) {
+  function normalizeRoute(value) {
+    return String(value || '').replace(/^\\/+/, '').replace(/\\/+$/g, '');
+  }
+  function matchesQuery(page, expectedQuery) {
+    if (!expectedQuery || !Object.keys(expectedQuery).length) {
+      return true;
+    }
+    var actualQuery = page && (page.options || page.query || {});
+    return Object.keys(expectedQuery).every(function (key) {
+      var actualValue = String(actualQuery[key] == null ? '' : actualQuery[key]);
+      var expectedValue = String(expectedQuery[key]);
+      var decodedActualValue = actualValue;
+      try {
+        decodedActualValue = decodeURIComponent(actualValue);
+      }
+      catch (_) {
+      }
+      return actualValue === expectedValue
+        || decodedActualValue === expectedValue
+        || actualValue === encodeURIComponent(expectedValue);
+    });
+  }
+  var pages = typeof getCurrentPages === 'function' ? getCurrentPages() : [];
+  var expectedRoute = normalizeRoute(route);
+  var page = null;
+  for (var pageIndex = pages.length - 1; pageIndex >= 0; pageIndex -= 1) {
+    var candidate = pages[pageIndex];
+    var candidateRoute = normalizeRoute(candidate && (candidate.path || candidate.route || candidate.__route__));
+    if ((!expectedRoute || candidateRoute === expectedRoute) && matchesQuery(candidate, query)) {
+      page = candidate;
+      break;
+    }
+  }
+  if (!page) {
+    return null;
+  }
+  function createSelectorQuery(scope) {
+    var selectorQuery = null;
+    var createdFromScope = false;
+    if (scope && typeof scope.createSelectorQuery === 'function') {
+      selectorQuery = scope.createSelectorQuery();
+      createdFromScope = true;
+    }
+    else if (typeof wx !== 'undefined' && wx && typeof wx.createSelectorQuery === 'function') {
+      selectorQuery = wx.createSelectorQuery();
+    }
+    else if (typeof page.createSelectorQuery === 'function') {
+      selectorQuery = page.createSelectorQuery();
+    }
+    if (!selectorQuery) {
+      return null;
+    }
+    if (!createdFromScope && typeof selectorQuery.in === 'function') {
+      try {
+        selectorQuery = selectorQuery.in(scope || page);
+      }
+      catch (_) {
+      }
+    }
+    return selectorQuery;
+  }
+  function pushUnique(list, seen, item) {
+    if (!item) {
+      return;
+    }
+    var id = item.is || item.id || item.__wxWebviewId__ || item.__wxExparserNodeId__ || String(list.length);
+    if (seen[id]) {
+      return;
+    }
+    seen[id] = true;
+    list.push(item);
+  }
+  function collectScopes(root, scopeSelectors) {
+    var scopes = [];
+    var seen = {};
+    var queue = [];
+    pushUnique(scopes, seen, root);
+    queue.push(root);
+    for (var queueIndex = 0; queueIndex < queue.length && queueIndex < 60; queueIndex += 1) {
+      var scope = queue[queueIndex];
+      if (!scope || typeof scope.selectAllComponents !== 'function') {
+        continue;
+      }
+      var children = [];
+      var componentSelectors = Array.isArray(scopeSelectors) ? scopeSelectors.slice() : [];
+      componentSelectors.push(selector, '*', 'weapp-app-shell', 'weapp-layout-default');
+      for (var selectorIndex = 0; selectorIndex < componentSelectors.length; selectorIndex += 1) {
+        if (!componentSelectors[selectorIndex]) {
+          continue;
+        }
+        try {
+          var selected = scope.selectAllComponents(componentSelectors[selectorIndex]);
+          if (Array.isArray(selected)) {
+            children = children.concat(selected);
+          }
+        }
+        catch (_) {
+        }
+      }
+      for (var childIndex = 0; childIndex < children.length; childIndex += 1) {
+        var child = children[childIndex];
+        var previousLength = scopes.length;
+        pushUnique(scopes, seen, child);
+        if (scopes.length > previousLength) {
+          queue.push(child);
+        }
+      }
+    }
+    return scopes;
+  }
+  function queryScope(scope) {
+    return new Promise(function (resolve) {
+      var settled = false;
+      var timer = setTimeout(function () {
+        if (settled) {
+          return;
+        }
+        settled = true;
+        resolve([]);
+      }, 800);
+      function finish(nodes) {
+        if (settled) {
+          return;
+        }
+        settled = true;
+        clearTimeout(timer);
+        resolve(Array.isArray(nodes) ? nodes : nodes ? [nodes] : []);
+      }
+      try {
+        var selectorQuery = createSelectorQuery(scope);
+        if (!selectorQuery) {
+          finish([]);
+          return;
+        }
+        selectorQuery
+          .selectAll(selector)
+          .fields({
+            id: true,
+            dataset: true,
+            rect: true,
+            size: true,
+            computedStyle: Array.isArray(styleNames) ? styleNames : []
+          }, function (nodes) {
+            finish(nodes);
+          })
+          .exec();
+      }
+      catch (_) {
+        finish([]);
+      }
+    });
+  }
+  return new Promise(function (resolve) {
+    try {
+      var scopes = collectScopes(page, scopeSelectors);
+      var scopeIndex = 0;
+      function next() {
+        if (scopeIndex >= scopes.length) {
+          resolve(null);
+          return;
+        }
+        var scope = scopes[scopeIndex];
+        scopeIndex += 1;
+        queryScope(scope).then(function (nodes) {
+          if (nodes.length > 0) {
+            resolve(nodes[index] || null);
+            return;
+          }
+          next();
+        }, function () {
+          next();
+        });
+      }
+      next();
+    }
+    catch (_) {
+      resolve(null);
+    }
+  });
+}`;
+/**
+* 读取降级元素快照。未找到(页面不在/选择器无命中/索引越界)返回 null,
+* 由调用方决定抛错文案;永不因为协议失效而长时间挂起。
+*/
+async function readRouteElementSnapshot(connection, route, query, selector, index, scopeSelectors = [], styleNames = [], timeout = ROUTE_ELEMENT_SNAPSHOT_TIMEOUT) {
+	const startedAt = Date.now();
+	for (let attempt = 0; attempt <= ROUTE_ELEMENT_SNAPSHOT_EMPTY_RETRIES; attempt += 1) {
+		const remaining = attempt === 0 ? timeout : Math.max(1, timeout - (Date.now() - startedAt));
+		const { result } = await connection.send("App.callFunction", {
+			functionDeclaration: ROUTE_ELEMENT_SNAPSHOT_FUNCTION_DECLARATION,
+			args: [
+				route,
+				query,
+				selector,
+				index,
+				scopeSelectors,
+				styleNames
+			]
+		}, { timeout: remaining });
+		if (result != null || attempt === ROUTE_ELEMENT_SNAPSHOT_EMPTY_RETRIES) return result ?? null;
+		const retryRemaining = timeout - (Date.now() - startedAt);
+		if (retryRemaining <= 0) break;
+		await sleep$1(Math.min(ROUTE_ELEMENT_SNAPSHOT_RETRY_DELAY, retryRemaining));
+	}
+	return null;
+}
+//#endregion
 //#region src/Element.ts
 const ELEMENT_QUERY_TIMEOUT = 2500;
 const ELEMENT_WXML_TIMEOUT = 8e3;
@@ -272,7 +489,17 @@ var Element = class Element {
 		};
 	}
 	async offset() {
-		return await this.send("Element.getOffset");
+		const offset = await this.send("Element.getOffset");
+		if (offset?.width !== void 0 && offset.height !== void 0) return offset;
+		try {
+			const dimensions = await this.size();
+			return {
+				...offset,
+				...dimensions
+			};
+		} catch {
+			return offset;
+		}
 	}
 	async text() {
 		return await this.domProperty("innerText");
@@ -394,8 +621,87 @@ var Element = class Element {
 };
 /** App-Service 路由降级元素仅用于只读查询，不能伪装成交互协议元素。 */
 var RouteFallbackElement = class extends Element {
+	routeSelector;
+	routeIndex;
+	routeRoute;
+	routeQuery;
+	routeScopeSelectors;
+	constructor(connection, options, elementMap) {
+		super(connection, options, elementMap);
+		this.routeSelector = options.routeFallbackSelector;
+		this.routeIndex = options.routeFallbackIndex;
+		this.routeRoute = options.routeFallbackRoute;
+		this.routeQuery = options.routeFallbackQuery;
+		this.routeScopeSelectors = options.routeFallbackScopeSelectors ?? [];
+	}
+	/**
+	* 经 App-service SelectorQuery 实时重查元素快照(rect/size/dataset/computedStyle)。
+	* 每次读取都重新查询,保证滚动/重渲染后拿到的是当前值;未命中返回 null。
+	*/
+	async readSnapshot(styleNames = []) {
+		if (!this.routeSelector || this.routeIndex === void 0 || !this.routeRoute) return null;
+		return await readRouteElementSnapshot(this.connection, this.routeRoute, this.routeQuery ?? {}, this.routeSelector, this.routeIndex, this.routeScopeSelectors, styleNames);
+	}
+	missingSnapshot(what) {
+		return /* @__PURE__ */ new Error(`route fallback 元素未取到${what}: ${this.routeSelector ?? "(未知选择器)"}(页面已切换或元素已卸载)`);
+	}
+	async $(selector, _options = {}) {
+		return this.unsupported(`Element.$(${selector})`);
+	}
+	async $$(selector, _options = {}) {
+		return this.unsupported(`Element.$$(${selector})`);
+	}
+	async offset() {
+		const snapshot = await this.readSnapshot();
+		if (snapshot?.left === void 0 || snapshot.top === void 0) throw this.missingSnapshot("坐标");
+		return {
+			left: snapshot.left,
+			top: snapshot.top,
+			width: snapshot.width,
+			height: snapshot.height
+		};
+	}
+	async size() {
+		const snapshot = await this.readSnapshot();
+		if (snapshot?.width === void 0 || snapshot.height === void 0) throw this.missingSnapshot("尺寸");
+		return {
+			width: snapshot.width,
+			height: snapshot.height
+		};
+	}
+	async style(name) {
+		if (!isStr(name)) throw new Error("name must be a string");
+		const value = (await this.readSnapshot([name]))?.[name];
+		if (value === void 0) throw this.missingSnapshot(`样式 ${name}`);
+		return value;
+	}
+	async attribute(name) {
+		if (!isStr(name)) throw new Error("name must be a string");
+		const snapshot = await this.readSnapshot();
+		if (name === "id") return snapshot?.id;
+		if (name.startsWith("data-")) {
+			const key = name.slice(5).replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+			return snapshot?.dataset?.[key];
+		}
+		throw new Error(`route fallback 元素仅支持读取 id 与 data-* 属性,不支持 attribute(${name})`);
+	}
 	unsupported(method) {
-		throw new Error(`App-Service route fallback 元素不支持 ${method}`);
+		throw new Error(`App-Service route fallback 元素不支持 ${method}(真实交互依赖已失效的 page-frame 协议);可改用 page.callMethod()/evaluate 间接触发页面逻辑`);
+	}
+	async text() {
+		throw new Error("App-Service route fallback 元素不支持 text(SelectorQuery 无法读取 innerText);请改用 page.data() 断言数据源,或 page.callMethod()/evaluate 读取");
+	}
+	async value() {
+		this.unsupported("Element.value");
+	}
+	async property(name) {
+		this.unsupported(`Element.property(${name})`);
+	}
+	async wxml() {
+		this.unsupported("Element.wxml");
+	}
+	async outerWxml() {
+		this.unsupported("Element.outerWxml");
 	}
 	async tap() {
 		this.unsupported("Element.tap");
@@ -640,7 +946,7 @@ var Connection = class Connection extends EventEmitter {
 //#endregion
 //#region src/headless.ts
 async function launchHeadlessAutomator(options) {
-	return await (await import("./launch-yIGimB0F.mjs")).launch({ projectPath: options.projectPath });
+	return await (await import("./launch-DKcPk1N2.mjs")).launch({ projectPath: options.projectPath });
 }
 //#endregion
 //#region src/launcher/portLease.ts
@@ -739,7 +1045,7 @@ async function acquireAutomatorPortLease(preferredPort) {
 }
 //#endregion
 //#region package.json
-var version = "1.2.13";
+var version = "1.2.14";
 //#endregion
 //#region src/Native.ts
 /** Native 的实现。 */
@@ -800,14 +1106,19 @@ function resolveFallbackTagName(selector) {
 	return "view";
 }
 /** 将 App-Service 查询到的渲染节点包装为 Element 兼容对象。 */
-function createRouteFallbackElement(connection, elementMap, pageId, selector, node, index) {
+function createRouteFallbackElement(connection, elementMap, pageId, selector, node, index, route, query, scopeSelectors = []) {
 	const nodeId = typeof node.id === "string" && node.id ? normalizeFallbackIdPart(node.id) : String(index);
 	const elementId = `__weapp_vite_route_fallback_${pageId}_${normalizeFallbackIdPart(selector)}_${nodeId}_${index}`;
 	return Element.create(connection, {
 		elementId,
 		pageId,
 		routeFallback: true,
-		tagName: resolveFallbackTagName(selector)
+		tagName: resolveFallbackTagName(selector),
+		routeFallbackSelector: selector,
+		routeFallbackIndex: index,
+		routeFallbackRoute: route,
+		routeFallbackQuery: query,
+		routeFallbackScopeSelectors: [...scopeSelectors]
 	}, elementMap);
 }
 //#endregion
@@ -976,6 +1287,7 @@ const PAGE_CALL_METHOD_FALLBACK_RETRY_DELAY = 300;
 const PAGE_RENDERED_TIMEOUT = 15e3;
 const PAGE_RENDERED_POLL_DELAY = 220;
 const PAGE_RENDERED_QUERY_TIMEOUT = 5e3;
+const PAGE_RENDERED_EMPTY_RETRIES = 2;
 const PAGE_ROOT_SELECTORS = [
 	"page",
 	"body",
@@ -1723,10 +2035,21 @@ var Page = class Page {
 		return (await this.queryRouteElements(selector, options))[0] ?? null;
 	}
 	async queryRouteElements(selector, options) {
-		return (await this.renderedNodes(selector, {
-			componentSelectors: options.componentSelectors,
-			timeout: options.timeout ?? PAGE_QUERY_TIMEOUT
-		})).map((node, index) => createRouteFallbackElement(this.connection, this.elementMap, this.id, selector, node, index));
+		const timeout = options.timeout ?? PAGE_QUERY_TIMEOUT;
+		const startedAt = Date.now();
+		let nodes = [];
+		for (let attempt = 0; attempt <= PAGE_RENDERED_EMPTY_RETRIES; attempt += 1) {
+			const requestTimeout = attempt === 0 ? timeout : Math.max(1, timeout - (Date.now() - startedAt));
+			nodes = await this.renderedNodes(selector, {
+				componentSelectors: options.componentSelectors,
+				timeout: requestTimeout
+			});
+			if (nodes.length > 0 || attempt === PAGE_RENDERED_EMPTY_RETRIES) break;
+			const remaining = timeout - (Date.now() - startedAt);
+			if (remaining <= 0) break;
+			await sleep$1(Math.min(PAGE_RENDERED_POLL_DELAY, remaining));
+		}
+		return nodes.map((node, index) => createRouteFallbackElement(this.connection, this.elementMap, this.id, selector, node, index, this.path, this.query, options.componentSelectors));
 	}
 	async callRouteMethod(method, args, timeout = PAGE_CALL_METHOD_TIMEOUT) {
 		return await callRouteMethodViaAppService(this.connection, this.path, this.query, method, args, timeout);

package/dist/{launch-yIGimB0F.mjs → launch-DKcPk1N2.mjs}

@@ -14854,9 +14854,10 @@ function resolveComponentProperties(clonedNode, scope, definition) {
 	};
 }
 function createRuntimeComponentInstance(componentScopeId, context, clonedNode, componentEntry, nextProperties, ownerScopeId) {
+	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({
 		definition: componentEntry.definition,
-		properties: nextProperties,
+		properties: componentProperties,
 		requestRender: (callback) => context.session.requestRender(callback),
 		triggerEvent: buildComponentTrigger(componentScopeId, context, clonedNode)
 	});
@@ -14869,7 +14870,7 @@ function createRuntimeComponentInstance(componentScopeId, context, clonedNode, c
 	componentInstance.selectOwnerComponent = () => ownerScopeId ? context.componentCache.get(ownerScopeId) ?? null : null;
 	context.componentCache.set(componentScopeId, componentInstance);
 	runComponentLifecycle(componentInstance, "created");
-	runComponentObservers(componentInstance.__definition__ ?? componentEntry.definition, componentInstance, Object.keys(nextProperties), {});
+	runComponentObservers(componentInstance.__definition__ ?? componentEntry.definition, componentInstance, Object.keys(componentProperties), {});
 	componentInstance.__propertySnapshots = Object.fromEntries(Object.entries(componentInstance.properties).map(([key, propertyValue]) => [key, cloneValue$1(propertyValue)]));
 	runComponentLifecycle(componentInstance, "attached");
 	return componentInstance;
@@ -15138,15 +15139,21 @@ function registerAppDefinition(registries, definition) {
 	registries.appDefinition = definition;
 	return definition;
 }
-function registerPageDefinition(registries, definition) {
-	const route = registries.currentLoadContext?.route;
+function registerPageDefinition(registries, definition, explicitRoute) {
+	const route = explicitRoute ?? registries.currentLoadContext?.route;
 	if (!route) throw new Error("Cannot register Page() without an active page load context in headless runtime.");
 	if (registries.pages.has(route)) throw createDuplicateRegistrationError("page", route);
 	registries.pages.set(route, definition);
 	return definition;
 }
 function registerComponentDefinition(registries, definition) {
-	if (registries.currentLoadContext?.kind === "page") return registerPageDefinition(registries, normalizeComponentPageDefinition(definition));
+	if (registries.currentLoadContext?.kind === "page") {
+		if (registries.currentLoadContext.componentDefinitions) {
+			registries.currentLoadContext.componentDefinitions.push(definition);
+			return definition;
+		}
+		return registerPageDefinition(registries, normalizeComponentPageDefinition(definition));
+	}
 	const id = registries.currentLoadContext?.route ?? `anonymous:${registries.components.size}`;
 	if (registries.components.has(id)) throw createDuplicateRegistrationError("component", id);
 	registries.components.set(id, definition);
@@ -15694,15 +15701,24 @@ var RuntimeDiagnostics = class {
 			timestamp: Date.now()
 		});
 	}
-	createConsole(baseConsole = console) {
+	createConsole(baseConsole = console, onConsole) {
 		const runtimeConsole = Object.create(baseConsole);
+		const wrap = (level, method) => (...args) => {
+			if (level === "error" || level === "warn") this.record(level, args);
+			onConsole?.({
+				args: [...args],
+				level
+			});
+			method(...args);
+		};
+		runtimeConsole.debug = wrap("debug", baseConsole.debug.bind(baseConsole));
+		runtimeConsole.info = wrap("info", baseConsole.info.bind(baseConsole));
+		runtimeConsole.log = wrap("log", baseConsole.log.bind(baseConsole));
 		runtimeConsole.error = (...args) => {
-			this.record("error", args);
-			baseConsole.error(...args);
+			wrap("error", baseConsole.error.bind(baseConsole))(...args);
 		};
 		runtimeConsole.warn = (...args) => {
-			this.record("warn", args);
-			baseConsole.warn(...args);
+			wrap("warn", baseConsole.warn.bind(baseConsole))(...args);
 		};
 		return runtimeConsole;
 	}
@@ -16321,12 +16337,15 @@ function parseNumericLikeValue$1(value) {
 	const match = value.match(NUMERIC_LIKE_VALUE_RE$1);
 	return match ? Number(match[0]) : 0;
 }
-function resolveRect$1(node) {
+function resolveRect$1(node, windowInfo) {
 	const style = parseStyleDeclarations$1(node.attribs?.style);
 	const left = parseNumericLikeValue$1(node.attribs?.["data-sim-left"] ?? style.left);
 	const top = parseNumericLikeValue$1(node.attribs?.["data-sim-top"] ?? style.top);
-	const width = parseNumericLikeValue$1(node.attribs?.["data-sim-width"] ?? style.width);
-	const height = parseNumericLikeValue$1(node.attribs?.["data-sim-height"] ?? style.height);
+	const rawWidth = node.attribs?.["data-sim-width"] ?? style.width;
+	const rawHeight = node.attribs?.["data-sim-height"] ?? style.height;
+	const isTopLevelView = node.name === "view" && node.parent?.name === "page" && windowInfo?.windowWidth != null;
+	const width = rawWidth != null ? parseNumericLikeValue$1(rawWidth) : isTopLevelView && windowInfo ? windowInfo.windowWidth : 0;
+	const height = rawHeight != null ? parseNumericLikeValue$1(rawHeight) : isTopLevelView && windowInfo ? windowInfo.windowHeight : 0;
 	return {
 		bottom: top + height,
 		height,
@@ -16373,7 +16392,7 @@ function resolveFieldsResult(node, fields, options) {
 	if (fields.dataset) result.dataset = collectDataset$1(node);
 	if (fields.mark) result.mark = collectMark(node);
 	if (fields.rect || fields.size) {
-		const rect = resolveRect$1(node);
+		const rect = resolveRect$1(node, options.root.name === "page" ? options.windowInfo : void 0);
 		if (fields.rect) Object.assign(result, rect);
 		if (fields.size) {
 			result.width = rect.width;
@@ -17161,6 +17180,102 @@ function createHeadlessVideoContext(driver, videoId, scope) {
 }
 //#endregion
 //#region ../../mpcore/packages/simulator/src/runtime/moduleLoader.ts
+const ESM_IMPORT_LINE_RE = /^[ \t]*import[^\n]*$/gm;
+const ESM_EXPORT_LIST_RE = /^[ \t]*export[ \t]*\{([^}\n]+)\}[ \t]*;?$/gm;
+const ESM_EXPORT_DECLARATION_RE = /\bexport\s+(const|let|var|function|class)\s+([A-Za-z_$][\w$]*)/g;
+const ESM_EXPORT_DEFAULT_DECLARATION_RE = /\bexport\s+default\s+(function|class)\s+([A-Za-z_$][\w$]*)/g;
+function isImportWhitespace(value) {
+	return value === " " || value === "	";
+}
+function parseEsmImportLine(line) {
+	let statement = line.trim().slice(6).trim();
+	if (statement.endsWith(";")) statement = statement.slice(0, -1).trimEnd();
+	if (statement.startsWith("\"") || statement.startsWith("'")) {
+		const quote = statement[0];
+		if (statement.endsWith(quote) && statement.length > 1) return {
+			request: statement.slice(1, -1),
+			sideEffect: true
+		};
+		return;
+	}
+	let fromIndex = statement.indexOf("from");
+	while (fromIndex >= 0) {
+		if (isImportWhitespace(statement[fromIndex - 1]) && isImportWhitespace(statement[fromIndex + 4])) break;
+		fromIndex = statement.indexOf("from", fromIndex + 4);
+	}
+	if (fromIndex < 0) return;
+	const specifier = statement.slice(0, fromIndex).trim();
+	const requestLiteral = statement.slice(fromIndex + 4).trim();
+	const quote = requestLiteral[0];
+	if (!specifier || quote !== "\"" && quote !== "'" || requestLiteral.length < 2 || !requestLiteral.endsWith(quote)) return;
+	return {
+		request: requestLiteral.slice(1, -1),
+		sideEffect: false,
+		specifier
+	};
+}
+function createEsmImportBindings(specifier, request, index) {
+	const namespaceName = `__headlessEsmImport${index}`;
+	const statements = [`const ${namespaceName} = require(${JSON.stringify(request)});`];
+	const normalizedSpecifier = specifier.trim();
+	if (normalizedSpecifier.startsWith("{") && normalizedSpecifier.endsWith("}")) {
+		const entries = normalizedSpecifier.slice(1, -1).split(",");
+		for (const entry of entries) {
+			const [importedName, localName] = entry.trim().split(/\s+as\s+/);
+			if (!importedName) continue;
+			const bindingName = localName || importedName;
+			statements.push(`const ${bindingName} = ${namespaceName}[${JSON.stringify(importedName)}];`);
+		}
+		return statements.join("\n");
+	}
+	if (normalizedSpecifier.startsWith("* as ")) {
+		const bindingName = normalizedSpecifier.slice(5).trim();
+		statements.push(`const ${bindingName} = ${namespaceName};`);
+		return statements.join("\n");
+	}
+	const [defaultName, namedPart] = normalizedSpecifier.split(/\s*,\s*/, 2);
+	if (defaultName) statements.push(`const ${defaultName.trim()} = ${namespaceName}.default ?? ${namespaceName};`);
+	if (namedPart?.startsWith("{") && namedPart.endsWith("}")) statements.push(createEsmImportBindings(namedPart, request, index).split("\n").slice(1).join("\n"));
+	return statements.join("\n");
+}
+function transformEsmToCommonJs(source) {
+	if (!/^\s*(?:import|export)\b/m.test(source)) return source;
+	let importIndex = 0;
+	const exportedNames = [];
+	let transformed = source.replace(ESM_IMPORT_LINE_RE, (line) => {
+		const parsed = parseEsmImportLine(line);
+		if (!parsed) return line;
+		if (parsed.sideEffect) return `require(${JSON.stringify(parsed.request)});`;
+		return createEsmImportBindings(parsed.specifier, parsed.request, importIndex++);
+	});
+	transformed = transformed.replace(ESM_EXPORT_LIST_RE, (_match, entries) => {
+		for (const entry of entries.split(",")) {
+			const [local, exported] = entry.trim().split(/\s+as\s+/);
+			if (local) exportedNames.push({
+				exported: exported || local,
+				local
+			});
+		}
+		return "";
+	});
+	transformed = transformed.replace(ESM_EXPORT_DEFAULT_DECLARATION_RE, (_match, kind, local) => {
+		exportedNames.push({
+			exported: "default",
+			local
+		});
+		return `${kind} ${local}`;
+	});
+	transformed = transformed.replace(ESM_EXPORT_DECLARATION_RE, (_match, kind, local) => {
+		exportedNames.push({
+			exported: local,
+			local
+		});
+		return `${kind} ${local}`;
+	});
+	transformed = transformed.replace(/\bexport\s+default\s+/g, "module.exports.default = ");
+	if (exportedNames.length > 0) transformed += `\n${exportedNames.map(({ exported, local }) => `module.exports[${JSON.stringify(exported)}] = ${local};`).join("\n")}`;
+	return transformed;
+}
 function createRequireNotFoundError(request, importer) {
 	return /* @__PURE__ */ new Error(`Cannot resolve require("${request}") from ${normalize(importer)} in headless runtime.`);
 }
@@ -17176,7 +17291,7 @@ function resolveRequiredModulePath(artifactSource, importer, request) {
 	for (const candidate of candidates) if (artifactSource.has(candidate)) return candidate;
 	throw createRequireNotFoundError(request, importer);
 }
-function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, kernel, globals) {
+function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, kernel, globals, onConsole) {
 	const wx = createHeadlessWx(wxDriver);
 	return {
 		App(definition) {
@@ -17194,7 +17309,7 @@ function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, k
 		Page(definition) {
 			return registerPageDefinition(registries, definition);
 		},
-		console: kernel.diagnostics.createConsole(),
+		console: kernel.diagnostics.createConsole(console, onConsole),
 		clearInterval: (handle) => kernel.scheduler.clearInterval(handle),
 		clearTimeout: (handle) => kernel.scheduler.clearTimeout(handle),
 		getApp,
@@ -17204,13 +17319,17 @@ function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, k
 		require: void 0,
 		setInterval: kernel.scheduler.setInterval.bind(kernel.scheduler),
 		setTimeout: kernel.scheduler.setTimeout.bind(kernel.scheduler),
+		TextDecoder: globalThis.TextDecoder,
+		TextEncoder: globalThis.TextEncoder,
+		URL: globalThis.URL,
+		URLSearchParams: globalThis.URLSearchParams,
 		wx,
 		...globals
 	};
 }
 function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, options) {
 	const moduleCache = /* @__PURE__ */ new Map();
-	const executionContext = createExecutionContext(registries, getCurrentPages, getApp, wxDriver, options.kernel, options.globals ?? {});
+	const executionContext = createExecutionContext(registries, getCurrentPages, getApp, wxDriver, options.kernel, options.globals ?? {}, options.onConsole);
 	executionContext.globalThis = executionContext;
 	function executeModule(filePath, loadContext) {
 		const resolvedPath = path.resolve(filePath);
@@ -17240,9 +17359,13 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
 		});
 		localRequire.async = (request) => Promise.resolve().then(() => localRequire(request));
 		try {
-			new vm.Script(`(function (exports, module, require, __filename, __dirname) { ${source}\n})`, { filename: resolvedPath }).runInNewContext(executionContext)(module.exports, module, localRequire, resolvedPath, path.dirname(resolvedPath));
+			new vm.Script(`(function (exports, module, require, __filename, __dirname) { ${transformEsmToCommonJs(source)}\n})`, { filename: resolvedPath }).runInNewContext(executionContext)(module.exports, module, localRequire, resolvedPath, path.dirname(resolvedPath));
 			const registeredDefinitions = [...registries.components.values()].filter((definition) => !registeredDefinitionsBefore.has(definition));
-			module.componentDefinitions = [.../* @__PURE__ */ new Set([...requiredComponentDefinitions, ...registeredDefinitions])];
+			module.componentDefinitions = [.../* @__PURE__ */ new Set([
+				...requiredComponentDefinitions,
+				...loadContext?.componentDefinitions ?? [],
+				...registeredDefinitions
+			])];
 			return module;
 		} finally {
 			registries.currentLoadContext = previousLoadContext;
@@ -17258,11 +17381,13 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
 			return registries.appDefinition;
 		},
 		executePageModule(filePath, route) {
-			executeModule(filePath, {
+			const fallbackDefinition = executeModule(filePath, {
 				kind: "page",
-				route
-			});
-			const definition = registries.pages.get(route);
+				route,
+				componentDefinitions: []
+			}).componentDefinitions.at(-1);
+			const definition = registries.pages.get(route) ?? (fallbackDefinition ? normalizeComponentPageDefinition(fallbackDefinition) : void 0);
+			if (!registries.pages.has(route) && definition) registerPageDefinition(registries, definition, route);
 			if (!definition) throw new Error(`Page() was not registered for route "${route}" while executing ${normalize(filePath)}.`);
 			return definition;
 		},
@@ -19015,6 +19140,7 @@ var HeadlessSession = class {
 	appDefinition = null;
 	appInstance = null;
 	moduleLoader;
+	eventListeners = /* @__PURE__ */ new Map();
 	registries;
 	currentPageInstance = null;
 	pages = [];
@@ -19156,7 +19282,8 @@ var HeadlessSession = class {
 		}, {
 			artifactSource: this.project.artifactSource,
 			globals: options.globals,
-			kernel: this.kernel
+			kernel: this.kernel,
+			onConsole: (entry) => this.emit("console", entry)
 		});
 	}
 	assertActive() {
@@ -19170,11 +19297,26 @@ var HeadlessSession = class {
 		this.renderRequestPending = false;
 		this.wxState.close();
 		this.moduleLoader.close();
+		this.eventListeners.clear();
 		this.kernel.close();
 	}
 	getDiagnostics() {
 		return this.kernel.diagnostics.getEntries();
 	}
+	on(eventName, handler) {
+		if (!eventName || typeof handler !== "function") return;
+		const listeners = this.eventListeners.get(eventName) ?? /* @__PURE__ */ new Set();
+		listeners.add(handler);
+		this.eventListeners.set(eventName, listeners);
+	}
+	removeListener(eventName, handler) {
+		const listeners = this.eventListeners.get(eventName);
+		listeners?.delete(handler);
+		if (listeners?.size === 0) this.eventListeners.delete(eventName);
+	}
+	emit(eventName, ...args) {
+		for (const handler of [...this.eventListeners.get(eventName) ?? []]) handler(...args);
+	}
 	get isClosed() {
 		return this.kernel.isClosed;
 	}
@@ -19186,6 +19328,10 @@ var HeadlessSession = class {
 		this.assertActive();
 		return this.pages.slice();
 	}
+	getWx() {
+		this.assertActive();
+		return this.moduleLoader.wx;
+	}
 	callWxMethod(methodName, ...args) {
 		this.assertActive();
 		const method = this.moduleLoader.wx[methodName];
@@ -19581,9 +19727,19 @@ var HeadlessSession = class {
 		this.appDefinition = this.moduleLoader.executeAppModule(appModulePath);
 		this.appInstance = createAppInstance(this.appDefinition);
 		this.appInstance.onLaunch?.(launchOptions);
+		this.syncRuntimeAppState();
 		this.appInstance.onShow?.(launchOptions);
 		return this.appInstance;
 	}
+	syncRuntimeAppState() {
+		const runtimeApp = this.appInstance?.__wevuRuntimeApp;
+		if (!runtimeApp || typeof runtimeApp !== "object" || !this.appInstance) return;
+		if (runtimeApp.globalData && typeof runtimeApp.globalData === "object") this.appInstance.globalData = {
+			...this.appInstance.globalData,
+			...runtimeApp.globalData
+		};
+		if (Object.hasOwn(runtimeApp, "routes")) this.appInstance.routes = runtimeApp.routes;
+	}
 	reLaunch(url) {
 		const target = this.resolveNavigationTarget(url);
 		this.bootstrap(createAppLaunchOptions(target.normalizedRoute, target.query));
@@ -20231,7 +20387,10 @@ var HeadlessTestingPageHandle = class {
 		return await runWithTimeout(async () => {
 			this.session?.renderCurrentPage();
 			const method = this.page[normalizedMethodName];
-			if (typeof method !== "function") throw new TypeError(`Method "${normalizedMethodName}" does not exist on headless page ${this.page.route}.`);
+			if (typeof method !== "function") {
+				if (options.routeOnly) return;
+				throw new TypeError(`Method "${normalizedMethodName}" does not exist on headless page ${this.page.route}.`);
+			}
 			return cloneProtocolValue(await method.apply(this.page, args));
 		}, options.timeout, `Timed out calling page method "${normalizedMethodName}" in headless testing runtime.`);
 	}
@@ -20406,6 +20565,24 @@ var HeadlessTestingSessionHandle = class {
 	async close() {
 		this.session.close();
 	}
+	on(eventName, handler) {
+		this.session.on(eventName, handler);
+		return this;
+	}
+	removeListener(eventName, handler) {
+		this.session.removeListener(eventName, handler);
+		return this;
+	}
+	off(eventName, handler) {
+		return this.removeListener(eventName, handler);
+	}
+	async evaluate(evaluator, ...args) {
+		return await this.evaluateWithOptions(evaluator, {}, ...args);
+	}
+	async evaluateWithOptions(evaluator, options = {}, ...args) {
+		this.session.assertActive();
+		return await runWithTimeout(() => this.evaluateInRuntime(evaluator, args), options.timeout, "Timed out evaluating code in headless testing runtime.");
+	}
 	async currentPage() {
 		this.session.assertActive();
 		const current = this.session.getCurrentPages().at(-1);
@@ -20502,12 +20679,45 @@ var HeadlessTestingSessionHandle = class {
 		if (!page) throw new Error(`Failed to ${methodName} route "${route}" through the headless wx runtime.`);
 		return page;
 	}
+	async evaluateInRuntime(evaluator, args) {
+		const runtimeGlobals = {
+			getApp: () => this.session.getApp(),
+			getCurrentPages: () => this.session.getCurrentPages(),
+			wx: this.session.getWx()
+		};
+		const host = globalThis;
+		const previous = /* @__PURE__ */ new Map();
+		for (const [name, value] of Object.entries(runtimeGlobals)) {
+			previous.set(name, Object.getOwnPropertyDescriptor(host, name));
+			Object.defineProperty(host, name, {
+				configurable: true,
+				enumerable: false,
+				value,
+				writable: true
+			});
+		}
+		try {
+			const fn = typeof evaluator === "string" ? new vm.Script(`(${evaluator})`).runInThisContext() : evaluator;
+			if (typeof fn !== "function") throw new TypeError("Headless evaluator must be a function or function source string.");
+			return await fn(...args);
+		} finally {
+			for (const [name, descriptor] of previous) if (descriptor) Object.defineProperty(host, name, descriptor);
+			else delete host[name];
+		}
+	}
 };
 //#endregion
 //#region ../../mpcore/packages/simulator/src/testing/launch.ts
+function resolveInitialRoute(session) {
+	const entryPagePath = typeof session.project.appConfig.entryPagePath === "string" ? session.project.appConfig.entryPagePath.trim().replace(/^\/+/, "") : "";
+	if (entryPagePath && session.project.routes.some((route) => route.route === entryPagePath)) return entryPagePath;
+	return session.project.routes[0]?.route ?? null;
+}
 async function launch(options) {
 	const session = createHeadlessSession({ projectPath: options.projectPath });
 	session.bootstrap();
+	const initialRoute = resolveInitialRoute(session);
+	if (initialRoute) session.reLaunch(`/${initialRoute}`);
 	return new HeadlessTestingSessionHandle(session.project, session);
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@weapp-vite/miniprogram-automator",
   "type": "module",
-  "version": "1.2.13",
+  "version": "1.2.14",
   "description": "完全兼容微信 miniprogram-automator 的现代化替代实现",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",