@mpcore/simulator 0.7.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -25,6 +25,20 @@
25
25
 
26
26
  此入口只负责页面样式依赖和 CSS 兼容声明,不实现嵌套组件的完整样式隔离、类名前缀转换或 `rpx` 布局换算。Component 页面的 `page-isolated`、`page-strong-isolated`、`page-apply-shared`、`page-shared` 禁用隐式 `app.wxss`,页面仍可显式导入样式;最终页面 JSON 的 `styleIsolation` 优先于 JS 定义,JSON 未提供该值时才保留 JS 选项。普通 `Page` 注册不应用组件隔离选项,普通 `isolated` 也不等同于 `page-isolated`。缺失依赖、循环导入、非法 CSS 和不支持的导入会抛出明确错误。支持带媒体条件的本地导入;远程导入及 `layer` / `supports` 导入条件不受支持,也不会触发外部请求。
27
27
 
28
+ ## 挂载期属性同步
29
+
30
+ Component 页面及普通组件的 `attached` 内调用 `setData` 时,Node/browser 宿主在调用返回前同步后代属性,包括未投影插槽声明和本次 `wx:if` 新建的子组件。同步绑定阶段不提前派发 `attached`、`detached` 或 `ready`;生命周期回到外层挂载事务处理,避免卸载回调中的写入重复触发卸载。
31
+
32
+ 同一父级写入对每个实例只消费一次,属性 observer 对自身值的修正不会被重入渲染反复覆盖;修正产生的后代属性更新先于本组件对应的 observer。以上边界已用微信开发者工具 `2.02.2608060`、基础库 `3.17.2` 对照直接子组件、关闭插槽、条件插入、数值修正和卸载写入场景,不扩展为真机或其他基础库的完整兼容承诺。
33
+
34
+ Node/browser 的挂载期绑定遍历共享页面级写入修订号。子组件 observer 再次更新 owner 时,旧遍历停止消费已复制的兄弟、循环与插槽声明作用域,并按最新数据恢复;构造期间暂缓的同步也会使旧遍历失效。恢复时复用已创建实例,不重复派发挂载生命周期。
35
+
36
+ 构造期 `created` 写入不会跳过初始属性交付。私有模板独立捕获当前修订并完成稳定遍历,保证默认子树先于宿主 `created`、后代属性先于宿主属性 observer;外层过期遍历仍停止消费旧作用域。
37
+
38
+ 挂载、就绪和关系刷新引起的遍历重启使用迭代,有限兄弟批次不会按组件数量累加调用栈。
39
+
40
+ 这里只同步逻辑绑定,不在每次写入时序列化 WXML、收集样式或提交宿主视图。既有异步视图提交与 `setData` 回调完成边界保持不变。
41
+
28
42
  ## 路由完成与滚动状态
29
43
 
30
44
  Node/browser 宿主提供 `BeforeAppRoute`、`BeforePageUnload`、`AppRoute`、`AppRouteDone` 四组 `wx.on/off` 事件;同一次导航共享字符串 `routeEventId`。前置事件发生在隐藏/卸载之前,完成事件等待目标页 ready 和该次宿主提交。模拟器通过显式事件能力标记接入,`SDKVersion` 仍为 `0.0.0`,不代表真实微信基础库或 Skyline 渲染器。
@@ -39,6 +53,14 @@ Node/browser 宿主提供 `BeforeAppRoute`、`BeforePageUnload`、`AppRoute`、`
39
53
 
40
54
  测试节点与真实预览点击共用原生 tap 分发:保留原始 `target`,逐层更新 `currentTarget`,遵守 `catchtap/catch:tap`,仅在事件到达 `navigator` 时执行其默认导航。一次交互先确定原始页面/组件归属,业务回调中的销毁、重新渲染或同路由重建不将剩余冒泡发送给新实例。测试节点 `tap()` 仍等待异步业务处理并传递结果或错误;导航的原生默认动作不等待异步业务 Promise。
41
55
 
56
+ 组件 `triggerEvent` 在 Node/browser 中共用声明树分发:默认只触发宿主直接绑定;`capturePhase: true` 按外到内执行捕获,`bubbles: true` 再按内到外冒泡,`composed: true` 才允许越过声明组件边界。普通视图与组件宿主均参与;`catch` 停止后续冒泡,`capture-catch` 同时阻止后续冒泡阶段。宿主与模板根即使合并渲染,仍保留各自的绑定和声明所有者。
57
+
58
+ 事件保留原始 `detail` 与源组件宿主的 `target.id/dataset`,各监听节点提供自己的 `currentTarget`。一次分发先固定路径和实例所有者,回调中的重渲染或移除不把剩余事件发送给新实例。公开 renderer context 的 `eventBindings` 仍保存原有 `{ method, stopAfter }` 冒泡绑定,捕获绑定独立存放于可选的 `captureEventBindings`。
59
+
60
+ 包根公开的 `collectMiniProgramEventBindings` 与 `resolveMiniProgramEventBinding` 继续返回 `{ method, stopAfter }` 冒泡绑定;只有捕获绑定时,公开 resolver 仍返回 `null`。内部的分阶段解析不会改变这些既有调用者的返回类型或优先级规则。
61
+
62
+ 上述默认、仅捕获、局部冒泡、跨组件冒泡与宿主两种 catch 边界已对照微信开发者工具稳定版 `2.02.2608080`,并覆盖同一 issue runtime suite 的 headless provider 和实际浏览器预览。此对照不扩展为原生 tap、scroll、video 的捕获支持,也不表示已验证同节点 Vue 内联捕获/冒泡处理函数的编译语义。
63
+
42
64
  ## 分块请求 mock
43
65
 
44
66
  `session.mockRequest()` 支持为 `enableChunked: true` 的请求声明分块,默认仍不访问网络:
@@ -58,3 +80,9 @@ session.mockRequest({
58
80
  顶层 `delay` 控制响应头阶段,每个分块的 `delay` 相对于前一个阶段。请求提供 `onHeadersReceived` / `offHeadersReceived`、`onChunkReceived` / `offChunkReceived`;不传回调的 off 方法移除全部对应监听。取消会停止后续分块并仅触发一次 `fail → complete`。可设置 `error` 模拟已发送分块后的连接失败。
59
81
 
60
82
  分块请求的 `success.data` 按已验证的微信 DevTools 行为返回空字符串;数据只通过 chunk 交付。未设置 `chunks` 时不会将普通 `response` 自动拆分。自定义 driver 仍可只实现 abort,公开监听方法类型为可选,使用前需检测能力。此模型不提供 Streams 或传输反压保证。
83
+
84
+ ## worker
85
+
86
+ Node 与浏览器 simulator 支持从编译产物创建 worker、CommonJS 依赖、双向消息复制、终止及会话关闭清理;每个 worker 拥有独立模块缓存、全局对象与计时器。配置沿用 `app.json.workers`,worker 分包支持 `preDownloadSubpackage({ packageType: 'workers' })`。
87
+
88
+ 当前对照场景覆盖首条消息、双向通信、页面重入与关闭后不再投递。simulator 使用确定性任务调度,不模拟真实并行线程性能、系统进程回收或实验性 worker 后端。
package/dist/index.d.mts CHANGED
@@ -1021,6 +1021,28 @@ export interface HeadlessWxDriverCapabilities {
1021
1021
  };
1022
1022
  }
1023
1023
  //#endregion
1024
+ //#region src/host/wx/workers.d.ts
1025
+ export interface HeadlessWorker {
1026
+ onMessage: (listener: (message: any) => void) => void;
1027
+ offMessage: (listener?: (message: any) => void) => void;
1028
+ postMessage: (message: unknown) => void;
1029
+ onError: (listener: (error: {
1030
+ message: string;
1031
+ }) => void) => void;
1032
+ offError: (listener?: (error: {
1033
+ message: string;
1034
+ }) => void) => void;
1035
+ terminate: () => void;
1036
+ }
1037
+ export interface HeadlessWorkerApis {
1038
+ createWorker: (scriptPath: string) => HeadlessWorker;
1039
+ preDownloadSubpackage: (options: HeadlessWxCallbackOption<{
1040
+ errMsg: string;
1041
+ }> & {
1042
+ packageType: 'workers';
1043
+ }) => void;
1044
+ }
1045
+ //#endregion
1024
1046
  //#region src/host/wx/api.d.ts
1025
1047
  /** 宿主已接受的一次路由操作;同一次操作的所有阶段共用事件标识。 */
1026
1048
  export interface HeadlessWxRouteEvent {
@@ -1072,7 +1094,7 @@ export interface HeadlessWxDriver extends HeadlessWxDriverCapabilities, Headless
1072
1094
  canvasToTempFilePath: (option: HeadlessWxCanvasToTempFilePathOption) => HeadlessWxCanvasToTempFilePathSuccessResult;
1073
1095
  uploadFile: (option: HeadlessWxUploadFileOption) => HeadlessWxRequestTask;
1074
1096
  }
1075
- export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListeners {
1097
+ export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListeners, HeadlessWorkerApis {
1076
1098
  [WEVU_ROUTE_EVENT_CONTRACT_KEY]: 1;
1077
1099
  [WEVU_PAGE_SCROLL_EVENT_CONTRACT_KEY]: 1;
1078
1100
  canIUse: (schema: string) => boolean;
@@ -1214,7 +1236,7 @@ export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListener
1214
1236
  }
1215
1237
  //#endregion
1216
1238
  //#region src/host/wx/index.d.ts
1217
- export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'>): HeadlessWx;
1239
+ export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'>, workers?: HeadlessWorkerApis): HeadlessWx;
1218
1240
  //#endregion
1219
1241
  //#region src/kernel/artifactSource.d.ts
1220
1242
  export interface ArtifactSource {
@@ -1396,6 +1418,122 @@ export interface CreateBrowserProjectOptions {
1396
1418
  }
1397
1419
  export declare function createBrowserProject(files: BrowserVirtualFiles, options?: CreateBrowserProjectOptions): HeadlessProjectDescriptor;
1398
1420
  //#endregion
1421
+ //#region src/view/nodeHandle.d.ts
1422
+ interface DomNodeLike$5 {
1423
+ attribs?: Record<string, string>;
1424
+ children?: DomNodeLike$5[];
1425
+ data?: string;
1426
+ dataset?: Record<string, unknown>;
1427
+ name?: string;
1428
+ parent?: DomNodeLike$5 | null;
1429
+ type?: string;
1430
+ }
1431
+ export interface HeadlessTestingNodeEventInit {
1432
+ currentTarget?: {
1433
+ dataset?: Record<string, unknown>;
1434
+ id?: string;
1435
+ };
1436
+ dataset?: Record<string, unknown>;
1437
+ detail?: unknown;
1438
+ id?: string;
1439
+ mark?: Record<string, unknown>;
1440
+ target?: {
1441
+ dataset?: Record<string, unknown>;
1442
+ id?: string;
1443
+ };
1444
+ }
1445
+ export interface HeadlessTestingNodeValueEventInit extends HeadlessTestingNodeEventInit {
1446
+ detail?: {
1447
+ value?: string;
1448
+ [key: string]: unknown;
1449
+ };
1450
+ }
1451
+ interface HeadlessTestingNodeInteractionHandlers {
1452
+ assertActive?: () => void;
1453
+ callMethod: (scopeId: string | null, methodName: string, event: Record<string, any>) => unknown;
1454
+ dispatchNativeEvent?: (node: DomNodeLike$5, eventName: string, event: HeadlessTestingNodeEventInit, onHandlerResult?: (result: unknown) => void) => boolean;
1455
+ createScopeHandle: (scopeId: string | null) => {
1456
+ scopeId: string;
1457
+ snapshot: () => Promise<unknown>;
1458
+ } | null;
1459
+ createPageHandle: () => {
1460
+ data: (path?: string) => Promise<unknown>;
1461
+ };
1462
+ ownerScopeId: (scopeId: string | null) => string | null;
1463
+ projectionOnly?: boolean;
1464
+ }
1465
+ export declare class HeadlessTestingNodeHandle {
1466
+ private readonly node;
1467
+ private readonly interactions?;
1468
+ constructor(node: DomNodeLike$5, interactions?: HeadlessTestingNodeInteractionHandlers | undefined);
1469
+ private assertActive;
1470
+ private query;
1471
+ $(selector: string): Promise<HeadlessTestingNodeHandle | null>;
1472
+ $$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
1473
+ getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
1474
+ attr(name: string): Promise<string | undefined>;
1475
+ dataset(): Promise<Record<string, unknown>>;
1476
+ scope(): Promise<{
1477
+ scopeId: string;
1478
+ snapshot: () => Promise<unknown>;
1479
+ } | null>;
1480
+ componentScope(): Promise<{
1481
+ scopeId: string;
1482
+ snapshot: () => Promise<unknown>;
1483
+ } | null>;
1484
+ pageScope(): Promise<{
1485
+ scopeId: string;
1486
+ snapshot: () => Promise<unknown>;
1487
+ } | null>;
1488
+ page(): Promise<{
1489
+ data: (path?: string) => Promise<unknown>;
1490
+ }>;
1491
+ ownerComponentScope(): Promise<{
1492
+ scopeId: string;
1493
+ snapshot: () => Promise<unknown>;
1494
+ } | null>;
1495
+ text(): Promise<string>;
1496
+ tagName(): Promise<string | undefined>;
1497
+ trigger(eventName: string, event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1498
+ tap(event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1499
+ input(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1500
+ change(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1501
+ blur(value?: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1502
+ wxml(): Promise<string>;
1503
+ }
1504
+ //#endregion
1505
+ //#region src/view/eventBinding.d.ts
1506
+ export interface MiniProgramEventBinding {
1507
+ method: string;
1508
+ stopAfter: boolean;
1509
+ }
1510
+ export declare function collectMiniProgramEventBindings(attributes?: Record<string, string>): Map<string, MiniProgramEventBinding>;
1511
+ export declare function resolveMiniProgramEventBinding(attributes: Record<string, string> | undefined, eventName: string): MiniProgramEventBinding | null;
1512
+ /** 冒泡时保留原始 target,currentTarget 则属于当前执行绑定的节点。 */
1513
+ export declare function createMiniProgramEventPayload(node: {
1514
+ attribs?: Record<string, string>;
1515
+ dataset?: Record<string, unknown>;
1516
+ }, eventName: string, event: HeadlessTestingNodeEventInit, origin?: {
1517
+ attribs?: Record<string, string>;
1518
+ dataset?: Record<string, unknown>;
1519
+ }): {
1520
+ bubbles: boolean;
1521
+ capturePhase: boolean;
1522
+ composed: boolean;
1523
+ currentTarget: {
1524
+ dataset: Record<string, unknown>;
1525
+ id: string;
1526
+ };
1527
+ detail: unknown;
1528
+ mark: Record<string, unknown> | undefined;
1529
+ target: {
1530
+ dataset: Record<string, unknown>;
1531
+ id: string;
1532
+ };
1533
+ timeStamp: number;
1534
+ type: string;
1535
+ };
1536
+ //#endregion
1399
1537
  //#region src/view/wxs.d.ts
1400
1538
  type WxsModuleBindings = Record<string, unknown>;
1401
1539
  //#endregion
@@ -1431,13 +1569,13 @@ export declare function resolveBrowserPageStyles(files: BrowserVirtualFiles, rou
1431
1569
  }): BrowserPageStyles;
1432
1570
  //#endregion
1433
1571
  //#region src/browser/render/types.d.ts
1434
- interface DomNodeLike$5 {
1572
+ interface DomNodeLike$4 {
1435
1573
  attribs?: Record<string, string>;
1436
- children?: DomNodeLike$5[];
1574
+ children?: DomNodeLike$4[];
1437
1575
  data?: string;
1438
1576
  dataset?: Record<string, unknown>;
1439
1577
  name?: string;
1440
- parent?: DomNodeLike$5 | null;
1578
+ parent?: DomNodeLike$4 | null;
1441
1579
  type?: string;
1442
1580
  }
1443
1581
  interface BrowserRenderScope {
@@ -1446,14 +1584,13 @@ interface BrowserRenderScope {
1446
1584
  classList?: string[];
1447
1585
  data: Record<string, any>;
1448
1586
  dataset?: Record<string, unknown>;
1449
- eventBindings?: Map<string, {
1450
- method: string;
1451
- stopAfter: boolean;
1452
- }>;
1587
+ eventBindings?: Map<string, MiniProgramEventBinding>;
1588
+ captureEventBindings?: Map<string, MiniProgramEventBinding>;
1453
1589
  getMethod: (methodName: string) => ((...args: any[]) => any) | undefined;
1454
1590
  getScopeId: () => string;
1455
1591
  genericComponents?: Map<string, string>;
1456
1592
  hostId?: string;
1593
+ hostNode?: DomNodeLike$4;
1457
1594
  listenerScopeId?: string;
1458
1595
  id?: string;
1459
1596
  ownerScopeId?: string;
@@ -1461,14 +1598,14 @@ interface BrowserRenderScope {
1461
1598
  }
1462
1599
  interface BrowserSlotContent {
1463
1600
  instancePath: string;
1464
- node: DomNodeLike$5;
1601
+ node: DomNodeLike$4;
1465
1602
  ownerFilePath: string;
1466
1603
  ownerJsonPath: string;
1467
1604
  scope: BrowserRenderScope;
1468
- templateRenderState: TemplateRenderState<DomNodeLike$5>;
1605
+ templateRenderState: TemplateRenderState<DomNodeLike$4>;
1469
1606
  }
1470
1607
  interface BrowserRenderedPageTree {
1471
- root: DomNodeLike$5;
1608
+ root: DomNodeLike$4;
1472
1609
  styles: BrowserPageStyles;
1473
1610
  wxml: string;
1474
1611
  }
@@ -1509,13 +1646,13 @@ interface HeadlessModuleLoader {
1509
1646
  }
1510
1647
  //#endregion
1511
1648
  //#region src/runtime/render/types.d.ts
1512
- interface DomNodeLike$4 {
1649
+ interface DomNodeLike$3 {
1513
1650
  attribs?: Record<string, string>;
1514
- children?: DomNodeLike$4[];
1651
+ children?: DomNodeLike$3[];
1515
1652
  data?: string;
1516
1653
  dataset?: Record<string, unknown>;
1517
1654
  name?: string;
1518
- parent?: DomNodeLike$4 | null;
1655
+ parent?: DomNodeLike$3 | null;
1519
1656
  type?: string;
1520
1657
  }
1521
1658
  interface RuntimeRenderScope {
@@ -1524,14 +1661,13 @@ interface RuntimeRenderScope {
1524
1661
  classList?: string[];
1525
1662
  data: Record<string, any>;
1526
1663
  dataset?: Record<string, unknown>;
1527
- eventBindings?: Map<string, {
1528
- method: string;
1529
- stopAfter: boolean;
1530
- }>;
1664
+ eventBindings?: Map<string, MiniProgramEventBinding>;
1665
+ captureEventBindings?: Map<string, MiniProgramEventBinding>;
1531
1666
  getMethod: (methodName: string) => ((...args: any[]) => any) | undefined;
1532
1667
  getScopeId: () => string;
1533
1668
  genericComponents?: Map<string, string>;
1534
1669
  hostId?: string;
1670
+ hostNode?: DomNodeLike$3;
1535
1671
  listenerScopeId?: string;
1536
1672
  id?: string;
1537
1673
  ownerScopeId?: string;
@@ -1539,14 +1675,14 @@ interface RuntimeRenderScope {
1539
1675
  }
1540
1676
  interface RuntimeSlotContent {
1541
1677
  instancePath: string;
1542
- node: DomNodeLike$4;
1678
+ node: DomNodeLike$3;
1543
1679
  ownerFilePath: string;
1544
1680
  ownerJsonPath: string;
1545
1681
  scope: RuntimeRenderScope;
1546
- templateRenderState: TemplateRenderState<DomNodeLike$4>;
1682
+ templateRenderState: TemplateRenderState<DomNodeLike$3>;
1547
1683
  }
1548
1684
  interface RuntimeRenderedPageTree {
1549
- root: DomNodeLike$4;
1685
+ root: DomNodeLike$3;
1550
1686
  wxml: string;
1551
1687
  }
1552
1688
  interface RuntimeRendererContext {
@@ -1569,89 +1705,6 @@ interface RuntimeRendererContext {
1569
1705
  //#region src/runtime/render/index.d.ts
1570
1706
  export declare function renderRuntimePageTree(context: RuntimeRendererContext, page: HeadlessPageInstance): RuntimeRenderedPageTree;
1571
1707
  //#endregion
1572
- //#region src/view/nodeHandle.d.ts
1573
- interface DomNodeLike$3 {
1574
- attribs?: Record<string, string>;
1575
- children?: DomNodeLike$3[];
1576
- data?: string;
1577
- dataset?: Record<string, unknown>;
1578
- name?: string;
1579
- parent?: DomNodeLike$3 | null;
1580
- type?: string;
1581
- }
1582
- export interface HeadlessTestingNodeEventInit {
1583
- currentTarget?: {
1584
- dataset?: Record<string, unknown>;
1585
- id?: string;
1586
- };
1587
- dataset?: Record<string, unknown>;
1588
- detail?: unknown;
1589
- id?: string;
1590
- mark?: Record<string, unknown>;
1591
- target?: {
1592
- dataset?: Record<string, unknown>;
1593
- id?: string;
1594
- };
1595
- }
1596
- export interface HeadlessTestingNodeValueEventInit extends HeadlessTestingNodeEventInit {
1597
- detail?: {
1598
- value?: string;
1599
- [key: string]: unknown;
1600
- };
1601
- }
1602
- interface HeadlessTestingNodeInteractionHandlers {
1603
- assertActive?: () => void;
1604
- callMethod: (scopeId: string | null, methodName: string, event: Record<string, any>) => unknown;
1605
- dispatchNativeEvent?: (node: DomNodeLike$3, eventName: string, event: HeadlessTestingNodeEventInit, onHandlerResult?: (result: unknown) => void) => boolean;
1606
- createScopeHandle: (scopeId: string | null) => {
1607
- scopeId: string;
1608
- snapshot: () => Promise<unknown>;
1609
- } | null;
1610
- createPageHandle: () => {
1611
- data: (path?: string) => Promise<unknown>;
1612
- };
1613
- ownerScopeId: (scopeId: string | null) => string | null;
1614
- }
1615
- export declare class HeadlessTestingNodeHandle {
1616
- private readonly node;
1617
- private readonly interactions?;
1618
- constructor(node: DomNodeLike$3, interactions?: HeadlessTestingNodeInteractionHandlers | undefined);
1619
- private assertActive;
1620
- private query;
1621
- $(selector: string): Promise<HeadlessTestingNodeHandle | null>;
1622
- $$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
1623
- getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
1624
- attr(name: string): Promise<string | undefined>;
1625
- dataset(): Promise<Record<string, unknown>>;
1626
- scope(): Promise<{
1627
- scopeId: string;
1628
- snapshot: () => Promise<unknown>;
1629
- } | null>;
1630
- componentScope(): Promise<{
1631
- scopeId: string;
1632
- snapshot: () => Promise<unknown>;
1633
- } | null>;
1634
- pageScope(): Promise<{
1635
- scopeId: string;
1636
- snapshot: () => Promise<unknown>;
1637
- } | null>;
1638
- page(): Promise<{
1639
- data: (path?: string) => Promise<unknown>;
1640
- }>;
1641
- ownerComponentScope(): Promise<{
1642
- scopeId: string;
1643
- snapshot: () => Promise<unknown>;
1644
- } | null>;
1645
- text(): Promise<string>;
1646
- tagName(): Promise<string | undefined>;
1647
- trigger(eventName: string, event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1648
- tap(event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1649
- input(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1650
- change(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1651
- blur(value?: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1652
- wxml(): Promise<string>;
1653
- }
1654
- //#endregion
1655
1708
  //#region src/view/nativeNode.d.ts
1656
1709
  interface HeadlessNativeNode {
1657
1710
  attribs?: Record<string, string>;
@@ -2806,38 +2859,6 @@ export declare function waitForPageText<NodeHandle, ScopeHandle>(access: Headles
2806
2859
  export declare function waitForPageTextGone<NodeHandle, ScopeHandle>(access: HeadlessTestingPageWaitAccess<NodeHandle, ScopeHandle>, text: string, options?: HeadlessTestingWaitOptions): Promise<void>;
2807
2860
  export declare function waitForPageData<NodeHandle, ScopeHandle>(access: HeadlessTestingPageWaitAccess<NodeHandle, ScopeHandle>, path: string, matcher: HeadlessTestingDataMatcher, hasMatcher: boolean, options?: HeadlessTestingWaitOptions): Promise<{}>;
2808
2861
  //#endregion
2809
- //#region src/view/eventBinding.d.ts
2810
- export interface MiniProgramEventBinding {
2811
- method: string;
2812
- stopAfter: boolean;
2813
- }
2814
- export declare function collectMiniProgramEventBindings(attributes?: Record<string, string>): Map<string, MiniProgramEventBinding>;
2815
- export declare function resolveMiniProgramEventBinding(attributes: Record<string, string> | undefined, eventName: string): MiniProgramEventBinding | null;
2816
- /** 冒泡时保留原始 target,currentTarget 则属于当前执行绑定的节点。 */
2817
- export declare function createMiniProgramEventPayload(node: {
2818
- attribs?: Record<string, string>;
2819
- dataset?: Record<string, unknown>;
2820
- }, eventName: string, event: HeadlessTestingNodeEventInit, origin?: {
2821
- attribs?: Record<string, string>;
2822
- dataset?: Record<string, unknown>;
2823
- }): {
2824
- bubbles: boolean;
2825
- capturePhase: boolean;
2826
- composed: boolean;
2827
- currentTarget: {
2828
- dataset: Record<string, unknown>;
2829
- id: string;
2830
- };
2831
- detail: unknown;
2832
- mark: Record<string, unknown> | undefined;
2833
- target: {
2834
- dataset: Record<string, unknown>;
2835
- id: string;
2836
- };
2837
- timeStamp: number;
2838
- type: string;
2839
- };
2840
- //#endregion
2841
2862
  //#region src/view/render.d.ts
2842
2863
  interface DomNodeLike$2 {
2843
2864
  attribs?: Record<string, string>;
@@ -3042,6 +3063,8 @@ export declare class HeadlessTestingSessionHandle {
3042
3063
  private readonly pendingNavigations;
3043
3064
  constructor(project: HeadlessProjectDescriptor, session: HeadlessSession);
3044
3065
  close(): Promise<void>;
3066
+ /** 无头会话独占本地 runtime;同步释放与 automator 的连接清理契约一致。 */
3067
+ disconnect(): void;
3045
3068
  toolInfo(): Promise<HeadlessTestingToolInfo>;
3046
3069
  on(eventName: string, handler: (...args: any[]) => void): this;
3047
3070
  removeListener(eventName: string, handler: (...args: any[]) => void): this;
@@ -3052,6 +3075,8 @@ export declare class HeadlessTestingSessionHandle {
3052
3075
  getCurrentPages(): Promise<HeadlessTestingPageHandle[]>;
3053
3076
  callWxMethod<T = unknown>(methodName: string, ...args: any[]): Promise<T>;
3054
3077
  callWxMethodWithOptions<T = unknown>(methodName: string, options?: HeadlessTestingProtocolOptions, ...args: any[]): Promise<T>;
3078
+ /** 返回与 DevTools automator 兼容的运行时系统信息。 */
3079
+ systemInfo<T = unknown>(): Promise<T>;
3055
3080
  scopeSnapshot(scopeId: string): Promise<{
3056
3081
  data: Record<string, any>;
3057
3082
  methods: string[];