@mpcore/simulator 0.7.0 → 1.1.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/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 {
@@ -1032,6 +1054,8 @@ export interface HeadlessWxRouteEvent {
1032
1054
  routeEventId: string;
1033
1055
  timeStamp: number;
1034
1056
  }
1057
+ /** 路由动画完成只提供路由身份,不携带接受路由时的渲染引擎字段。 */
1058
+ export type HeadlessWxRouteDoneEvent = Omit<HeadlessWxRouteEvent, 'renderer'>;
1035
1059
  /** 页面销毁前的原生实例,仍可同步读取页面数据。 */
1036
1060
  export interface HeadlessWxBeforePageUnloadEvent extends HeadlessWxRouteEvent {
1037
1061
  page: HeadlessPageInstance;
@@ -1043,8 +1067,8 @@ export interface HeadlessWxRouteListeners {
1043
1067
  offBeforePageUnload: (listener?: (event: HeadlessWxBeforePageUnloadEvent) => void) => void;
1044
1068
  onAppRoute: (listener: (event: HeadlessWxRouteEvent) => void) => void;
1045
1069
  offAppRoute: (listener?: (event: HeadlessWxRouteEvent) => void) => void;
1046
- onAppRouteDone: (listener: (event: HeadlessWxRouteEvent) => void) => void;
1047
- offAppRouteDone: (listener?: (event: HeadlessWxRouteEvent) => void) => void;
1070
+ onAppRouteDone: (listener: (event: HeadlessWxRouteDoneEvent) => void) => void;
1071
+ offAppRouteDone: (listener?: (event: HeadlessWxRouteDoneEvent) => void) => void;
1048
1072
  }
1049
1073
  export interface HeadlessWxDriver extends HeadlessWxDriverCapabilities, HeadlessWxRouteListeners {
1050
1074
  chooseImage: (option: HeadlessWxChooseImageOption) => HeadlessWxChooseImageResult;
@@ -1072,7 +1096,7 @@ export interface HeadlessWxDriver extends HeadlessWxDriverCapabilities, Headless
1072
1096
  canvasToTempFilePath: (option: HeadlessWxCanvasToTempFilePathOption) => HeadlessWxCanvasToTempFilePathSuccessResult;
1073
1097
  uploadFile: (option: HeadlessWxUploadFileOption) => HeadlessWxRequestTask;
1074
1098
  }
1075
- export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListeners {
1099
+ export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListeners, HeadlessWorkerApis {
1076
1100
  [WEVU_ROUTE_EVENT_CONTRACT_KEY]: 1;
1077
1101
  [WEVU_PAGE_SCROLL_EVENT_CONTRACT_KEY]: 1;
1078
1102
  canIUse: (schema: string) => boolean;
@@ -1214,10 +1238,11 @@ export interface HeadlessWx extends HeadlessUniEventBus, HeadlessWxRouteListener
1214
1238
  }
1215
1239
  //#endregion
1216
1240
  //#region src/host/wx/index.d.ts
1217
- export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'>): HeadlessWx;
1241
+ export declare function createHeadlessWx(driver: HeadlessWxDriver, runtimeConsole?: Pick<Console, 'debug' | 'info' | 'log' | 'warn'>, workers?: HeadlessWorkerApis): HeadlessWx;
1218
1242
  //#endregion
1219
1243
  //#region src/kernel/artifactSource.d.ts
1220
1244
  export interface ArtifactSource {
1245
+ /** 判断产物文件是否存在,目录不属于产物。 */
1221
1246
  has: (filePath: string) => boolean;
1222
1247
  readText: (filePath: string) => string | undefined;
1223
1248
  }
@@ -1377,6 +1402,7 @@ export interface BrowserModuleLoader {
1377
1402
  executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
1378
1403
  executeAppModule: (filePath: string) => HeadlessAppDefinition;
1379
1404
  executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
1405
+ reloadPageModule: (filePath: string, route: string) => boolean;
1380
1406
  wx: HeadlessWx;
1381
1407
  }
1382
1408
  export declare function createBrowserModuleLoader(files: BrowserVirtualFiles, registries: HeadlessHostRegistries, getCurrentPages: () => any[], getApp: () => any, wxDriver: Parameters<typeof createHeadlessWx>[0], options: {
@@ -1396,6 +1422,159 @@ export interface CreateBrowserProjectOptions {
1396
1422
  }
1397
1423
  export declare function createBrowserProject(files: BrowserVirtualFiles, options?: CreateBrowserProjectOptions): HeadlessProjectDescriptor;
1398
1424
  //#endregion
1425
+ //#region src/view/nodeEvents.d.ts
1426
+ interface HeadlessTestingTouch {
1427
+ identifier?: number;
1428
+ pageX?: number;
1429
+ pageY?: number;
1430
+ clientX?: number;
1431
+ clientY?: number;
1432
+ }
1433
+ interface HeadlessTestingTouchEventInit {
1434
+ touches?: HeadlessTestingTouch[];
1435
+ changedTouches?: HeadlessTestingTouch[];
1436
+ /** @deprecated 请改用与微信事件一致的 changedTouches。 */
1437
+ changeTouches?: HeadlessTestingTouch[];
1438
+ }
1439
+ interface HeadlessTestingNodeEventInit extends HeadlessTestingTouchEventInit {
1440
+ currentTarget?: {
1441
+ dataset?: Record<string, unknown>;
1442
+ id?: string;
1443
+ };
1444
+ dataset?: Record<string, unknown>;
1445
+ detail?: unknown;
1446
+ id?: string;
1447
+ mark?: Record<string, unknown>;
1448
+ target?: {
1449
+ dataset?: Record<string, unknown>;
1450
+ id?: string;
1451
+ };
1452
+ }
1453
+ interface HeadlessTestingNodeValueEventInit extends HeadlessTestingNodeEventInit {
1454
+ detail?: {
1455
+ value?: string;
1456
+ [key: string]: unknown;
1457
+ };
1458
+ }
1459
+ interface HeadlessTestingDispatchEventInit extends HeadlessTestingNodeEventInit {
1460
+ eventName: string;
1461
+ $?: string;
1462
+ }
1463
+ //#endregion
1464
+ //#region src/view/nodeHandle.d.ts
1465
+ interface DomNodeLike$5 {
1466
+ attribs?: Record<string, string>;
1467
+ children?: DomNodeLike$5[];
1468
+ data?: string;
1469
+ dataset?: Record<string, unknown>;
1470
+ name?: string;
1471
+ parent?: DomNodeLike$5 | null;
1472
+ type?: string;
1473
+ }
1474
+ interface HeadlessTestingNodeInteractionHandlers {
1475
+ assertActive?: () => void;
1476
+ callMethod: (scopeId: string | null, methodName: string, event: Record<string, any>) => unknown;
1477
+ dispatchNativeEvent?: (node: DomNodeLike$5, eventName: string, event: HeadlessTestingNodeEventInit, onHandlerResult?: (result: unknown) => void) => boolean;
1478
+ createScopeHandle: (scopeId: string | null) => {
1479
+ scopeId: string;
1480
+ snapshot: () => Promise<unknown>;
1481
+ } | null;
1482
+ createPageHandle: () => {
1483
+ data: (path?: string) => Promise<unknown>;
1484
+ };
1485
+ ownerScopeId: (scopeId: string | null) => string | null;
1486
+ projectionOnly?: boolean;
1487
+ }
1488
+ export declare class HeadlessTestingNodeHandle {
1489
+ private readonly node;
1490
+ private readonly interactions?;
1491
+ constructor(node: DomNodeLike$5, interactions?: HeadlessTestingNodeInteractionHandlers | undefined);
1492
+ private assertActive;
1493
+ private query;
1494
+ $(selector: string): Promise<HeadlessTestingNodeHandle | null>;
1495
+ $$(selector: string): Promise<HeadlessTestingNodeHandle[]>;
1496
+ getElementsByXpath(expression: string): Promise<HeadlessTestingNodeHandle[]>;
1497
+ attr(name: string): Promise<string | undefined>;
1498
+ dataset(): Promise<Record<string, unknown>>;
1499
+ scope(): Promise<{
1500
+ scopeId: string;
1501
+ snapshot: () => Promise<unknown>;
1502
+ } | null>;
1503
+ componentScope(): Promise<{
1504
+ scopeId: string;
1505
+ snapshot: () => Promise<unknown>;
1506
+ } | null>;
1507
+ pageScope(): Promise<{
1508
+ scopeId: string;
1509
+ snapshot: () => Promise<unknown>;
1510
+ } | null>;
1511
+ page(): Promise<{
1512
+ data: (path?: string) => Promise<unknown>;
1513
+ }>;
1514
+ ownerComponentScope(): Promise<{
1515
+ scopeId: string;
1516
+ snapshot: () => Promise<unknown>;
1517
+ } | null>;
1518
+ text(): Promise<string>;
1519
+ tagName(): Promise<string | undefined>;
1520
+ trigger(eventName: string, event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1521
+ tap(event?: HeadlessTestingNodeEventInit): Promise<unknown>;
1522
+ touchstart(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
1523
+ touchmove(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
1524
+ touchend(event?: HeadlessTestingTouchEventInit): Promise<unknown>;
1525
+ dispatchEvent({ eventName, $: selector, ...event }: HeadlessTestingDispatchEventInit): Promise<unknown>;
1526
+ input(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1527
+ change(value: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1528
+ blur(value?: string, event?: HeadlessTestingNodeValueEventInit): Promise<unknown>;
1529
+ wxml(): Promise<string>;
1530
+ }
1531
+ //#endregion
1532
+ //#region src/view/eventBinding.d.ts
1533
+ export interface MiniProgramEventBinding {
1534
+ method: string;
1535
+ stopAfter: boolean;
1536
+ }
1537
+ export declare function collectMiniProgramEventBindings(attributes?: Record<string, string>): Map<string, MiniProgramEventBinding>;
1538
+ export declare function resolveMiniProgramEventBinding(attributes: Record<string, string> | undefined, eventName: string): MiniProgramEventBinding | null;
1539
+ /** 冒泡时保留原始 target,currentTarget 则属于当前执行绑定的节点。 */
1540
+ export declare function createMiniProgramEventPayload(node: {
1541
+ attribs?: Record<string, string>;
1542
+ dataset?: Record<string, unknown>;
1543
+ }, eventName: string, event: HeadlessTestingNodeEventInit, origin?: {
1544
+ attribs?: Record<string, string>;
1545
+ dataset?: Record<string, unknown>;
1546
+ }): {
1547
+ bubbles: boolean;
1548
+ capturePhase: boolean;
1549
+ composed: boolean;
1550
+ currentTarget: {
1551
+ dataset: Record<string, unknown>;
1552
+ id: string;
1553
+ };
1554
+ detail: unknown;
1555
+ mark: Record<string, unknown> | undefined;
1556
+ target: {
1557
+ dataset: Record<string, unknown>;
1558
+ id: string;
1559
+ };
1560
+ timeStamp: number;
1561
+ type: string;
1562
+ changedTouches?: {
1563
+ identifier?: number;
1564
+ pageX?: number;
1565
+ pageY?: number;
1566
+ clientX?: number;
1567
+ clientY?: number;
1568
+ }[] | undefined;
1569
+ touches?: {
1570
+ identifier?: number;
1571
+ pageX?: number;
1572
+ pageY?: number;
1573
+ clientX?: number;
1574
+ clientY?: number;
1575
+ }[] | undefined;
1576
+ };
1577
+ //#endregion
1399
1578
  //#region src/view/wxs.d.ts
1400
1579
  type WxsModuleBindings = Record<string, unknown>;
1401
1580
  //#endregion
@@ -1431,13 +1610,13 @@ export declare function resolveBrowserPageStyles(files: BrowserVirtualFiles, rou
1431
1610
  }): BrowserPageStyles;
1432
1611
  //#endregion
1433
1612
  //#region src/browser/render/types.d.ts
1434
- interface DomNodeLike$5 {
1613
+ interface DomNodeLike$4 {
1435
1614
  attribs?: Record<string, string>;
1436
- children?: DomNodeLike$5[];
1615
+ children?: DomNodeLike$4[];
1437
1616
  data?: string;
1438
1617
  dataset?: Record<string, unknown>;
1439
1618
  name?: string;
1440
- parent?: DomNodeLike$5 | null;
1619
+ parent?: DomNodeLike$4 | null;
1441
1620
  type?: string;
1442
1621
  }
1443
1622
  interface BrowserRenderScope {
@@ -1446,14 +1625,13 @@ interface BrowserRenderScope {
1446
1625
  classList?: string[];
1447
1626
  data: Record<string, any>;
1448
1627
  dataset?: Record<string, unknown>;
1449
- eventBindings?: Map<string, {
1450
- method: string;
1451
- stopAfter: boolean;
1452
- }>;
1628
+ eventBindings?: Map<string, MiniProgramEventBinding>;
1629
+ captureEventBindings?: Map<string, MiniProgramEventBinding>;
1453
1630
  getMethod: (methodName: string) => ((...args: any[]) => any) | undefined;
1454
1631
  getScopeId: () => string;
1455
1632
  genericComponents?: Map<string, string>;
1456
1633
  hostId?: string;
1634
+ hostNode?: DomNodeLike$4;
1457
1635
  listenerScopeId?: string;
1458
1636
  id?: string;
1459
1637
  ownerScopeId?: string;
@@ -1461,14 +1639,14 @@ interface BrowserRenderScope {
1461
1639
  }
1462
1640
  interface BrowserSlotContent {
1463
1641
  instancePath: string;
1464
- node: DomNodeLike$5;
1642
+ node: DomNodeLike$4;
1465
1643
  ownerFilePath: string;
1466
1644
  ownerJsonPath: string;
1467
1645
  scope: BrowserRenderScope;
1468
- templateRenderState: TemplateRenderState<DomNodeLike$5>;
1646
+ templateRenderState: TemplateRenderState<DomNodeLike$4>;
1469
1647
  }
1470
1648
  interface BrowserRenderedPageTree {
1471
- root: DomNodeLike$5;
1649
+ root: DomNodeLike$4;
1472
1650
  styles: BrowserPageStyles;
1473
1651
  wxml: string;
1474
1652
  }
@@ -1477,6 +1655,7 @@ interface BrowserRendererContext {
1477
1655
  componentCache: Map<string, HeadlessComponentInstance>;
1478
1656
  componentScopes: Map<string, BrowserRenderScope>;
1479
1657
  files: BrowserVirtualFiles;
1658
+ templateSource?: Pick<ArtifactSource, 'readText'>;
1480
1659
  moduleLoader: BrowserModuleLoader;
1481
1660
  project: HeadlessProjectDescriptor;
1482
1661
  session: {
@@ -1505,17 +1684,18 @@ interface HeadlessModuleLoader {
1505
1684
  executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
1506
1685
  executeAppModule: (filePath: string) => HeadlessAppDefinition;
1507
1686
  executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
1687
+ reloadPageModule: (filePath: string, route: string) => boolean;
1508
1688
  wx: HeadlessWx;
1509
1689
  }
1510
1690
  //#endregion
1511
1691
  //#region src/runtime/render/types.d.ts
1512
- interface DomNodeLike$4 {
1692
+ interface DomNodeLike$3 {
1513
1693
  attribs?: Record<string, string>;
1514
- children?: DomNodeLike$4[];
1694
+ children?: DomNodeLike$3[];
1515
1695
  data?: string;
1516
1696
  dataset?: Record<string, unknown>;
1517
1697
  name?: string;
1518
- parent?: DomNodeLike$4 | null;
1698
+ parent?: DomNodeLike$3 | null;
1519
1699
  type?: string;
1520
1700
  }
1521
1701
  interface RuntimeRenderScope {
@@ -1524,14 +1704,13 @@ interface RuntimeRenderScope {
1524
1704
  classList?: string[];
1525
1705
  data: Record<string, any>;
1526
1706
  dataset?: Record<string, unknown>;
1527
- eventBindings?: Map<string, {
1528
- method: string;
1529
- stopAfter: boolean;
1530
- }>;
1707
+ eventBindings?: Map<string, MiniProgramEventBinding>;
1708
+ captureEventBindings?: Map<string, MiniProgramEventBinding>;
1531
1709
  getMethod: (methodName: string) => ((...args: any[]) => any) | undefined;
1532
1710
  getScopeId: () => string;
1533
1711
  genericComponents?: Map<string, string>;
1534
1712
  hostId?: string;
1713
+ hostNode?: DomNodeLike$3;
1535
1714
  listenerScopeId?: string;
1536
1715
  id?: string;
1537
1716
  ownerScopeId?: string;
@@ -1539,14 +1718,14 @@ interface RuntimeRenderScope {
1539
1718
  }
1540
1719
  interface RuntimeSlotContent {
1541
1720
  instancePath: string;
1542
- node: DomNodeLike$4;
1721
+ node: DomNodeLike$3;
1543
1722
  ownerFilePath: string;
1544
1723
  ownerJsonPath: string;
1545
1724
  scope: RuntimeRenderScope;
1546
- templateRenderState: TemplateRenderState<DomNodeLike$4>;
1725
+ templateRenderState: TemplateRenderState<DomNodeLike$3>;
1547
1726
  }
1548
1727
  interface RuntimeRenderedPageTree {
1549
- root: DomNodeLike$4;
1728
+ root: DomNodeLike$3;
1550
1729
  wxml: string;
1551
1730
  }
1552
1731
  interface RuntimeRendererContext {
@@ -1569,89 +1748,6 @@ interface RuntimeRendererContext {
1569
1748
  //#region src/runtime/render/index.d.ts
1570
1749
  export declare function renderRuntimePageTree(context: RuntimeRendererContext, page: HeadlessPageInstance): RuntimeRenderedPageTree;
1571
1750
  //#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
1751
  //#region src/view/nativeNode.d.ts
1656
1752
  interface HeadlessNativeNode {
1657
1753
  attribs?: Record<string, string>;
@@ -2053,6 +2149,8 @@ export declare function createHeadlessWxState(scheduler?: Pick<RuntimeScheduler,
2053
2149
  //#endregion
2054
2150
  //#region src/runtime/session.d.ts
2055
2151
  export interface HeadlessSessionOptions {
2152
+ /** 相对小程序根目录的编译模板路径;仅在显式宿主重载时提交新版本。 */
2153
+ compiledTemplatePaths?: readonly string[];
2056
2154
  globals?: Record<string, unknown>;
2057
2155
  project?: HeadlessProjectDescriptor;
2058
2156
  projectPath?: string;
@@ -2066,6 +2164,7 @@ export declare class HeadlessSession {
2066
2164
  private appInstance;
2067
2165
  private readonly appLifecycle;
2068
2166
  private readonly moduleLoader;
2167
+ private readonly templateRegistration;
2069
2168
  private readonly routeEvents;
2070
2169
  private readonly eventListeners;
2071
2170
  private readonly registries;
@@ -2074,8 +2173,7 @@ export declare class HeadlessSession {
2074
2173
  private readonly componentCache;
2075
2174
  private readonly componentScopes;
2076
2175
  private readonly selectorQueryScopeSnapshots;
2077
- private renderRequestPending;
2078
- private readonly renderRequestCallbacks;
2176
+ private readonly renderQueue;
2079
2177
  private readonly tabBarRoutes;
2080
2178
  private readonly tabPages;
2081
2179
  private readonly tabBarItems;
@@ -2098,6 +2196,10 @@ export declare class HeadlessSession {
2098
2196
  get isClosed(): boolean;
2099
2197
  getApp(): HeadlessAppInstance | null;
2100
2198
  getCurrentPages(): HeadlessPageInstance[];
2199
+ /** 显式重载已变更的页面 entry,保留 App 与依赖缓存;调用者随后自行导航。 */
2200
+ reloadPageDefinition(route: string): boolean;
2201
+ /** 显式提交编译模板及其 import/include 依赖;不重载脚本、不导航或替换实例。 */
2202
+ reloadTemplates(): boolean;
2101
2203
  getWx(): HeadlessWx;
2102
2204
  /** 在当前小程序实例的上下文执行测试函数,复用应用全局对象与调度器。 */
2103
2205
  evaluateRuntime<T = unknown>(source: string, args?: any[]): T;
@@ -2415,6 +2517,8 @@ export declare function createHeadlessSession(options: HeadlessSessionOptions):
2415
2517
  //#endregion
2416
2518
  //#region src/browser/session.d.ts
2417
2519
  export interface BrowserHeadlessSessionOptions {
2520
+ /** 相对小程序根目录的编译模板路径;仅在显式宿主重载时提交新版本。 */
2521
+ compiledTemplatePaths?: readonly string[];
2418
2522
  files: BrowserVirtualFiles;
2419
2523
  globals?: Record<string, unknown>;
2420
2524
  /** 返回的 Promise 表示宿主 DOM 已提交;普通返回值按同步渲染处理。 */
@@ -2429,6 +2533,7 @@ export declare class BrowserHeadlessSession {
2429
2533
  private appInstance;
2430
2534
  private readonly appLifecycle;
2431
2535
  private readonly moduleLoader;
2536
+ private readonly templateRegistration;
2432
2537
  private readonly onRender?;
2433
2538
  private readonly registries;
2434
2539
  private currentPageInstance;
@@ -2436,9 +2541,7 @@ export declare class BrowserHeadlessSession {
2436
2541
  private readonly componentCache;
2437
2542
  private readonly componentScopes;
2438
2543
  private readonly selectorQueryScopeSnapshots;
2439
- private renderRequestPending;
2440
- private renderInProgress;
2441
- private readonly renderRequestCallbacks;
2544
+ private readonly renderQueue;
2442
2545
  private readonly tabBarRoutes;
2443
2546
  private readonly tabPages;
2444
2547
  private readonly tabBarItems;
@@ -2461,6 +2564,10 @@ export declare class BrowserHeadlessSession {
2461
2564
  get isClosed(): boolean;
2462
2565
  getApp(): HeadlessAppInstance | null;
2463
2566
  getCurrentPages(): HeadlessPageInstance[];
2567
+ /** 显式重载已变更的页面 entry,保留 App 与依赖缓存;调用者随后自行导航。 */
2568
+ reloadPageDefinition(route: string): boolean;
2569
+ /** 显式提交编译模板及其 import/include 依赖;不重载脚本、不导航或替换实例。 */
2570
+ reloadTemplates(): boolean;
2464
2571
  getCurrentPageNavigationBarTitle(): string | null;
2465
2572
  getCurrentPageNavigationBar(): {
2466
2573
  animation: {
@@ -2806,38 +2913,6 @@ export declare function waitForPageText<NodeHandle, ScopeHandle>(access: Headles
2806
2913
  export declare function waitForPageTextGone<NodeHandle, ScopeHandle>(access: HeadlessTestingPageWaitAccess<NodeHandle, ScopeHandle>, text: string, options?: HeadlessTestingWaitOptions): Promise<void>;
2807
2914
  export declare function waitForPageData<NodeHandle, ScopeHandle>(access: HeadlessTestingPageWaitAccess<NodeHandle, ScopeHandle>, path: string, matcher: HeadlessTestingDataMatcher, hasMatcher: boolean, options?: HeadlessTestingWaitOptions): Promise<{}>;
2808
2915
  //#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
2916
  //#region src/view/render.d.ts
2842
2917
  interface DomNodeLike$2 {
2843
2918
  attribs?: Record<string, string>;
@@ -2982,6 +3057,30 @@ export declare class HeadlessTestingPageHandle {
2982
3057
  private waitAccess;
2983
3058
  }
2984
3059
  //#endregion
3060
+ //#region src/testing/sessionHandle/protocol.d.ts
3061
+ interface HeadlessTestingProtocolOptions {
3062
+ timeout?: number;
3063
+ }
3064
+ type HeadlessTestingEvaluator<T = unknown> = ((...args: any[]) => T | PromiseLike<T>) | string;
3065
+ interface HeadlessTestingToolInfo {
3066
+ version: 'mpcore-simulator';
3067
+ }
3068
+ /** 无头协议只公布已有运行时语义;不把宿主缺失能力伪装为调试器结果。 */
3069
+ export declare class HeadlessTestingProtocolUnsupportedError extends Error {
3070
+ readonly method: string;
3071
+ readonly code = "HEADLESS_PROTOCOL_UNSUPPORTED";
3072
+ constructor(method: string);
3073
+ }
3074
+ //#endregion
3075
+ //#region src/testing/sessionHandle/cdp.d.ts
3076
+ type HeadlessTestingCDPEventListener = (domain: string, event: string, params: unknown) => void;
3077
+ interface HeadlessTestingCDP {
3078
+ enable: (options?: HeadlessTestingProtocolOptions) => Promise<unknown>;
3079
+ sendCommand: <T = unknown>(domain: string, method: string, params?: Record<string, unknown>, options?: HeadlessTestingProtocolOptions) => Promise<T>;
3080
+ listProtocol: <T = unknown>(options?: HeadlessTestingProtocolOptions) => Promise<T>;
3081
+ onEvent: (listener: HeadlessTestingCDPEventListener) => () => void;
3082
+ }
3083
+ //#endregion
2985
3084
  //#region src/testing/sessionHandle/scope.d.ts
2986
3085
  export declare class HeadlessTestingScopeHandle {
2987
3086
  readonly scopeId: string;
@@ -3029,19 +3128,18 @@ export declare class HeadlessTestingScopeHandle {
3029
3128
  }
3030
3129
  //#endregion
3031
3130
  //#region src/testing/sessionHandle/index.d.ts
3032
- interface HeadlessTestingProtocolOptions {
3033
- timeout?: number;
3034
- }
3035
- type HeadlessTestingEvaluator<T = unknown> = ((...args: any[]) => T | PromiseLike<T>) | string;
3036
- interface HeadlessTestingToolInfo {
3037
- version: 'mpcore-simulator';
3038
- }
3039
3131
  export declare class HeadlessTestingSessionHandle {
3040
3132
  private readonly project;
3041
3133
  private readonly session;
3042
- private readonly pendingNavigations;
3134
+ private readonly navigation;
3135
+ private disconnection?;
3136
+ private cdp?;
3043
3137
  constructor(project: HeadlessProjectDescriptor, session: HeadlessSession);
3044
3138
  close(): Promise<void>;
3139
+ /** 先保存共享结果,再同步开始关闭,覆盖关闭监听器内的重入调用。 */
3140
+ disconnect(): Promise<void>;
3141
+ send<T = unknown>(method: string, params?: Record<string, unknown>, options?: HeadlessTestingProtocolOptions): Promise<T>;
3142
+ CDP(): HeadlessTestingCDP;
3045
3143
  toolInfo(): Promise<HeadlessTestingToolInfo>;
3046
3144
  on(eventName: string, handler: (...args: any[]) => void): this;
3047
3145
  removeListener(eventName: string, handler: (...args: any[]) => void): this;
@@ -3052,6 +3150,8 @@ export declare class HeadlessTestingSessionHandle {
3052
3150
  getCurrentPages(): Promise<HeadlessTestingPageHandle[]>;
3053
3151
  callWxMethod<T = unknown>(methodName: string, ...args: any[]): Promise<T>;
3054
3152
  callWxMethodWithOptions<T = unknown>(methodName: string, options?: HeadlessTestingProtocolOptions, ...args: any[]): Promise<T>;
3153
+ /** 返回与 DevTools automator 兼容的运行时系统信息。 */
3154
+ systemInfo<T = unknown>(): Promise<T>;
3055
3155
  scopeSnapshot(scopeId: string): Promise<{
3056
3156
  data: Record<string, any>;
3057
3157
  methods: string[];
@@ -3076,6 +3176,10 @@ export declare class HeadlessTestingSessionHandle {
3076
3176
  waitForComponent(selector: string, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingScopeHandle>;
3077
3177
  waitForComponents(selector: string, count?: number, options?: HeadlessTestingWaitOptions): Promise<HeadlessTestingScopeHandle[]>;
3078
3178
  reLaunch(route: string): Promise<HeadlessTestingPageHandle>;
3179
+ /** 只更新页面定义;不隐式导航,也不替换当前页面或应用实例。 */
3180
+ reloadPageDefinition(route: string): Promise<boolean>;
3181
+ /** 显式提交宿主编译模板;不隐式重载脚本或导航。 */
3182
+ reloadTemplates(): Promise<boolean>;
3079
3183
  navigateTo(route: string): Promise<HeadlessTestingPageHandle>;
3080
3184
  redirectTo(route: string): Promise<HeadlessTestingPageHandle>;
3081
3185
  navigateBack(delta?: number): Promise<HeadlessTestingPageHandle | null>;
@@ -3088,17 +3192,18 @@ export declare class HeadlessTestingSessionHandle {
3088
3192
  triggerReachBottom(): Promise<void>;
3089
3193
  triggerResize(options: Record<string, any>): Promise<void>;
3090
3194
  triggerRouteDone(options?: Record<string, any>): Promise<void>;
3091
- private invokeNavigation;
3092
3195
  private requireCurrentPage;
3093
3196
  private evaluateInRuntime;
3094
3197
  }
3095
3198
  //#endregion
3096
3199
  //#region src/testing/launch.d.ts
3097
3200
  export interface HeadlessTestingLaunchOptions {
3201
+ /** 相对小程序根目录的编译模板路径;普通查询不得提交尚未注册的模板。 */
3202
+ compiledTemplatePaths?: readonly string[];
3098
3203
  projectPath: string;
3099
3204
  configureSession?: (session: HeadlessSession) => void | Promise<void>;
3100
3205
  onSessionCreated?: (session: HeadlessTestingSessionHandle) => void | Promise<void>;
3101
3206
  }
3102
3207
  export declare function launch(options: HeadlessTestingLaunchOptions): Promise<HeadlessTestingSessionHandle>;
3103
3208
  //#endregion
3104
- export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingToolInfo, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };
3209
+ export type { BrowserRenderedPageTree, BrowserRendererContext, CreateComponentInstanceOptions, HeadlessComponentInstance, HeadlessTestingCDP, HeadlessTestingCDPEventListener, HeadlessTestingDispatchEventInit, HeadlessTestingEvaluator, HeadlessTestingNodeEventInit, HeadlessTestingNodeValueEventInit, HeadlessTestingProtocolOptions, HeadlessTestingToolInfo, HeadlessTestingTouch, HeadlessTestingTouchEventInit, HeadlessWxGetLogManagerOption, HeadlessWxLogManager, RuntimeRenderedPageTree, RuntimeRendererContext };