@mpcore/simulator 0.3.2 → 0.3.4

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
@@ -7,6 +7,7 @@ interface HeadlessBehaviorDefinition extends Record<string, any> {
7
7
  }
8
8
  interface HeadlessHostLoadContext {
9
9
  kind: 'app' | 'page' | 'component';
10
+ componentDefinitions?: HeadlessComponentDefinition[];
10
11
  route?: string;
11
12
  }
12
13
  interface HeadlessHostRegistries {
@@ -15,9 +16,10 @@ interface HeadlessHostRegistries {
15
16
  currentLoadContext: HeadlessHostLoadContext | null;
16
17
  pages: Map<string, HeadlessPageDefinition>;
17
18
  }
19
+ declare function normalizeComponentPageDefinition(definition: HeadlessComponentDefinition): HeadlessPageDefinition;
18
20
  declare function createHostRegistries(): HeadlessHostRegistries;
19
21
  declare function registerAppDefinition(registries: HeadlessHostRegistries, definition: HeadlessAppDefinition): HeadlessAppDefinition;
20
- declare function registerPageDefinition(registries: HeadlessHostRegistries, definition: HeadlessPageDefinition): HeadlessPageDefinition;
22
+ declare function registerPageDefinition(registries: HeadlessHostRegistries, definition: HeadlessPageDefinition, explicitRoute?: string): HeadlessPageDefinition;
21
23
  declare function registerComponentDefinition(registries: HeadlessHostRegistries, definition: HeadlessComponentDefinition): HeadlessPageDefinition;
22
24
  declare function registerExportedComponentDefinition(registries: HeadlessHostRegistries, id: string, moduleExports: Record<string, any>, registeredDefinition?: HeadlessComponentDefinition): HeadlessComponentDefinition | null;
23
25
  //#endregion
@@ -1071,6 +1073,10 @@ interface RuntimeDiagnosticEntry {
1071
1073
  level: RuntimeDiagnosticLevel;
1072
1074
  timestamp: number;
1073
1075
  }
1076
+ interface RuntimeConsoleEntry {
1077
+ args: unknown[];
1078
+ level: 'debug' | 'error' | 'info' | 'log' | 'warn';
1079
+ }
1074
1080
  declare class RuntimeDiagnostics {
1075
1081
  private readonly entries;
1076
1082
  clear(): void;
@@ -1080,7 +1086,7 @@ declare class RuntimeDiagnostics {
1080
1086
  timestamp: number;
1081
1087
  }[];
1082
1088
  record(level: RuntimeDiagnosticLevel, args: unknown[]): void;
1083
- createConsole(baseConsole?: Console): Console;
1089
+ createConsole(baseConsole?: Console, onConsole?: (entry: RuntimeConsoleEntry) => void): Console;
1084
1090
  }
1085
1091
  //#endregion
1086
1092
  //#region src/kernel/platform.d.ts
@@ -1818,6 +1824,7 @@ declare class HeadlessSession {
1818
1824
  private appDefinition;
1819
1825
  private appInstance;
1820
1826
  private readonly moduleLoader;
1827
+ private readonly eventListeners;
1821
1828
  private readonly registries;
1822
1829
  private currentPageInstance;
1823
1830
  private readonly pages;
@@ -1842,9 +1849,13 @@ declare class HeadlessSession {
1842
1849
  assertActive(): void;
1843
1850
  close(): void;
1844
1851
  getDiagnostics(): RuntimeDiagnosticEntry[];
1852
+ on(eventName: string, handler: (...args: any[]) => void): void;
1853
+ removeListener(eventName: string, handler: (...args: any[]) => void): void;
1854
+ private emit;
1845
1855
  get isClosed(): boolean;
1846
1856
  getApp(): HeadlessAppInstance | null;
1847
1857
  getCurrentPages(): HeadlessPageInstance[];
1858
+ getWx(): HeadlessWx;
1848
1859
  callWxMethod(methodName: string, ...args: any[]): any;
1849
1860
  getCurrentPageNavigationBarTitle(): string | null;
1850
1861
  getCurrentPageNavigationBar(): {
@@ -2122,6 +2133,7 @@ declare class HeadlessSession {
2122
2133
  errMsg: string;
2123
2134
  };
2124
2135
  bootstrap(launchOptions?: HeadlessWxLaunchOptions): HeadlessAppInstance;
2136
+ private syncRuntimeAppState;
2125
2137
  reLaunch(url: string): HeadlessPageInstance;
2126
2138
  navigateTo(url: string): HeadlessPageInstance;
2127
2139
  redirectTo(url: string): HeadlessPageInstance;
@@ -2845,11 +2857,17 @@ declare class HeadlessTestingScopeHandle {
2845
2857
  interface HeadlessTestingProtocolOptions {
2846
2858
  timeout?: number;
2847
2859
  }
2860
+ type HeadlessTestingEvaluator<T = unknown> = ((...args: any[]) => T | PromiseLike<T>) | string;
2848
2861
  declare class HeadlessTestingSessionHandle {
2849
2862
  private readonly project;
2850
2863
  private readonly session;
2851
2864
  constructor(project: HeadlessProjectDescriptor, session: HeadlessSession);
2852
2865
  close(): Promise<void>;
2866
+ on(eventName: string, handler: (...args: any[]) => void): this;
2867
+ removeListener(eventName: string, handler: (...args: any[]) => void): this;
2868
+ off(eventName: string, handler: (...args: any[]) => void): this;
2869
+ evaluate<T = unknown>(evaluator: HeadlessTestingEvaluator<T>, ...args: any[]): Promise<T>;
2870
+ evaluateWithOptions<T = unknown>(evaluator: HeadlessTestingEvaluator<T>, options?: HeadlessTestingProtocolOptions, ...args: any[]): Promise<T>;
2853
2871
  currentPage(): Promise<HeadlessTestingPageHandle | null>;
2854
2872
  getCurrentPages(): Promise<HeadlessTestingPageHandle[]>;
2855
2873
  callWxMethod<T = unknown>(methodName: string, ...args: any[]): Promise<T>;
@@ -2889,6 +2907,7 @@ declare class HeadlessTestingSessionHandle {
2889
2907
  triggerResize(options: Record<string, any>): Promise<void>;
2890
2908
  triggerRouteDone(options?: Record<string, any>): Promise<void>;
2891
2909
  private requireCurrentPage;
2910
+ private evaluateInRuntime;
2892
2911
  }
2893
2912
  //#endregion
2894
2913
  //#region src/testing/launch.d.ts
@@ -2897,4 +2916,4 @@ interface HeadlessTestingLaunchOptions {
2897
2916
  }
2898
2917
  declare function launch(options: HeadlessTestingLaunchOptions): Promise<HeadlessTestingSessionHandle>;
2899
2918
  //#endregion
2900
- export { ArtifactSource, BrowserDirectoryFileLike, BrowserHeadlessSession, BrowserHeadlessSessionOptions, BrowserModuleLoader, type BrowserRenderedPageTree, type BrowserRendererContext, BrowserVirtualFiles, CreateArtifactProjectOptions, CreateBrowserProjectOptions, type CreateComponentInstanceOptions, CreateProjectDescriptorOptions, HeadlessAppDefinition, HeadlessAppInstance, HeadlessBehaviorDefinition, HeadlessComponentDefinition, type HeadlessComponentInstance, HeadlessHostLoadContext, HeadlessHostRegistries, HeadlessPageDefinition, HeadlessPageInstance, HeadlessProjectConfigFile, HeadlessProjectDescriptor, HeadlessRouteRecord, HeadlessSelectorQueryResolverOptions, HeadlessSession, HeadlessSessionOptions, HeadlessTestingDataMatcher, HeadlessTestingLaunchOptions, HeadlessTestingLogicalNode, HeadlessTestingNodeHandle, HeadlessTestingPageCallMethodOptions, HeadlessTestingPageHandle, HeadlessTestingPageQueryOptions, HeadlessTestingPageSnapshot, HeadlessTestingPageWaitAccess, HeadlessTestingRenderedNodeSnapshot, HeadlessTestingRenderedOptions, HeadlessTestingRenderedPageAccess, HeadlessTestingRenderedSelectorNodesSnapshot, HeadlessTestingScopeHandle, HeadlessTestingSessionHandle, HeadlessTestingWaitForSelectorOptions, HeadlessTestingWaitOptions, HeadlessUniEventBus, HeadlessUniEventHandler, HeadlessWx, HeadlessWxAccessFileOption, HeadlessWxActionSheetLogEntry, HeadlessWxActionSheetMockDefinition, HeadlessWxAnimation, HeadlessWxAnimationAction, HeadlessWxAnimationExportResult, HeadlessWxAnimationStepOption, HeadlessWxAppBaseInfoResult, HeadlessWxAppendFileOption, HeadlessWxCallbackOption, HeadlessWxCanvasContext, HeadlessWxCanvasDrawCall, HeadlessWxCanvasSnapshot, HeadlessWxCanvasToTempFilePathOption, HeadlessWxCanvasToTempFilePathSuccessResult, HeadlessWxChooseImageOption, HeadlessWxChooseImageResult, HeadlessWxChooseImageTempFile, HeadlessWxChooseMediaOption, HeadlessWxChooseMediaResult, HeadlessWxChooseMediaTempFile, HeadlessWxChooseMessageFileOption, HeadlessWxChooseMessageFileResult, HeadlessWxChooseMessageFileTempFile, HeadlessWxChooseVideoOption, HeadlessWxChooseVideoResult, HeadlessWxClearStorageOption, HeadlessWxClipboardSnapshot, HeadlessWxCompressImageOption, HeadlessWxCompressImageResult, HeadlessWxCopyFileOption, HeadlessWxCreateIntersectionObserverOption, HeadlessWxDeviceInfoResult, HeadlessWxDownloadFileLogEntry, HeadlessWxDownloadFileMockDefinition, HeadlessWxDownloadFileOption, HeadlessWxDownloadFileSuccessResult, HeadlessWxDriver, HeadlessWxDriverCapabilities, HeadlessWxFileSystemManager, HeadlessWxFileSystemResult, HeadlessWxGetAppBaseInfoOption, HeadlessWxGetClipboardDataOption, HeadlessWxGetClipboardDataResult, HeadlessWxGetFileInfoOption, HeadlessWxGetFileInfoResult, HeadlessWxGetImageInfoOption, HeadlessWxGetImageInfoResult, HeadlessWxGetLocationOption, HeadlessWxGetLocationResult, HeadlessWxGetNetworkTypeOption, HeadlessWxGetNetworkTypeResult, HeadlessWxGetSavedFileInfoOption, HeadlessWxGetSavedFileInfoSuccessResult, HeadlessWxGetSavedFileListOption, HeadlessWxGetSavedFileListSuccessResult, HeadlessWxGetStorageInfoOption, HeadlessWxGetStorageOption, HeadlessWxGetStorageResult, HeadlessWxGetSystemInfoOption, HeadlessWxGetVideoInfoOption, HeadlessWxGetVideoInfoResult, HeadlessWxGetWindowInfoOption, HeadlessWxHideLoadingOption, HeadlessWxHideNavigationBarLoadingOption, HeadlessWxIntersectionObserver, HeadlessWxIntersectionObserverMargins, HeadlessWxIntersectionObserverObserveAllResult, HeadlessWxLaunchOptions, HeadlessWxLoadFontFaceOption, HeadlessWxLoadFontFaceResult, HeadlessWxLoadingSnapshot, HeadlessWxMediaQueryObserver, HeadlessWxMediaQueryObserverObserveCallbackResult, HeadlessWxMenuButtonBoundingClientRectResult, HeadlessWxMkdirOption, HeadlessWxModalLogEntry, HeadlessWxModalMockDefinition, HeadlessWxNavigateBackOption, HeadlessWxNavigateOption, HeadlessWxNetworkSnapshot, HeadlessWxNetworkStatusChangeCallback, HeadlessWxNetworkStatusChangeResult, HeadlessWxNetworkType, HeadlessWxObserveDescriptor, HeadlessWxOpenDocumentOption, HeadlessWxOpenDocumentResult, HeadlessWxOpenDocumentSnapshot, HeadlessWxPageScrollToOption, HeadlessWxPreviewImageOption, HeadlessWxPreviewImageResult, HeadlessWxPreviewImageSnapshot, HeadlessWxReadDirOption, HeadlessWxReadDirSuccessResult, HeadlessWxReadFileOption, HeadlessWxReadFileSuccessResult, HeadlessWxRemoveSavedFileOption, HeadlessWxRemoveStorageOption, HeadlessWxRenameOption, HeadlessWxRequestLogEntry, HeadlessWxRequestMockDefinition, HeadlessWxRequestOption, HeadlessWxRequestSuccessResult, HeadlessWxRequestTask, HeadlessWxRmdirOption, HeadlessWxSafeArea, HeadlessWxSafeAreaInsets, HeadlessWxSaveFileOption, HeadlessWxSaveFileSuccessResult, HeadlessWxSaveImageToPhotosAlbumOption, HeadlessWxSaveImageToPhotosAlbumResult, HeadlessWxSaveVideoToPhotosAlbumOption, HeadlessWxSaveVideoToPhotosAlbumResult, HeadlessWxSavedFileInfo, HeadlessWxSelectorQuery, HeadlessWxSelectorQueryBoundingClientRectResult, HeadlessWxSelectorQueryFieldsOption, HeadlessWxSelectorQueryNode, HeadlessWxSelectorQueryRequest, HeadlessWxSelectorQueryScrollOffsetResult, HeadlessWxSetBackgroundColorOption, HeadlessWxSetBackgroundTextStyleOption, HeadlessWxSetClipboardDataOption, HeadlessWxSetClipboardDataResult, HeadlessWxSetNavigationBarColorOption, HeadlessWxSetNavigationBarTitleOption, HeadlessWxSetStorageOption, HeadlessWxSetTabBarBadgeOption, HeadlessWxShareMenuOption, HeadlessWxShareMenuSnapshot, HeadlessWxShowActionSheetOption, HeadlessWxShowActionSheetResult, HeadlessWxShowLoadingOption, HeadlessWxShowModalOption, HeadlessWxShowModalResult, HeadlessWxShowNavigationBarLoadingOption, HeadlessWxShowToastOption, HeadlessWxStartPullDownRefreshOption, HeadlessWxStatOption, HeadlessWxStatSuccessResult, HeadlessWxStateOptions, HeadlessWxStats, HeadlessWxStorageInfoResult, HeadlessWxStorageResult, HeadlessWxSystemInfoResult, HeadlessWxTabBarItemOption, HeadlessWxTabBarOption, HeadlessWxToastSnapshot, HeadlessWxUnlinkOption, HeadlessWxUploadFileLogEntry, HeadlessWxUploadFileMockDefinition, HeadlessWxUploadFileOption, HeadlessWxUploadFileSuccessResult, HeadlessWxVideoContext, HeadlessWxWindowInfoResult, HeadlessWxWriteFileOption, MiniProgramEventBinding, PlatformAdapter, RenderedPageTree, RuntimeDiagnosticEntry, RuntimeDiagnosticLevel, RuntimeDiagnostics, RuntimeKernel, type RuntimeRenderedPageTree, type RuntimeRendererContext, RuntimeScheduler, cloneValue, coerceComponentPropertyValue, collectMiniProgramEventBindings, createAppInstance, createArtifactProject, createBrowserHeadlessSession, createBrowserModuleLoader, createBrowserProject, createBrowserVirtualFiles, createBrowserVirtualFilesFromDirectory, createComponentInstance, createFileSystemArtifactSource, createHeadlessSession, createHeadlessUniEventBus, createHeadlessWx, createHeadlessWxState, createHostRegistries, createLogicalNode, createMemoryArtifactSource, createOverlayArtifactSource, createPageInstance, createProjectDescriptor, executeSelectorQueryRequests, hasBrowserVirtualFile, hasComponentPropertyValueChanged, launch, loadProject, normalizeBrowserFilePath, normalizeComponentPropertyValue, querySelectorAll, readBrowserVirtualFile, readRenderedNodes, readRenderedSelectorNodes, registerAppDefinition, registerComponentDefinition, registerExportedComponentDefinition, registerPageDefinition, renderBrowserPageTree, renderPageTree, renderRuntimePageTree, resolveMiniProgramEventBinding, resolveRoutesFromAppConfig, resolveSelectorQueryScopeRoot, resolveSelectorScrollTop, runComponentLifecycle, runComponentObservers, runComponentPageLifetime, waitForPageComponent, waitForPageComponents, waitForPageData, waitForPageSelector, waitForPageText, waitForPageTextGone, waitForRenderedPage, wechat };
2919
+ export { ArtifactSource, BrowserDirectoryFileLike, BrowserHeadlessSession, BrowserHeadlessSessionOptions, BrowserModuleLoader, type BrowserRenderedPageTree, type BrowserRendererContext, BrowserVirtualFiles, CreateArtifactProjectOptions, CreateBrowserProjectOptions, type CreateComponentInstanceOptions, CreateProjectDescriptorOptions, HeadlessAppDefinition, HeadlessAppInstance, HeadlessBehaviorDefinition, HeadlessComponentDefinition, type HeadlessComponentInstance, HeadlessHostLoadContext, HeadlessHostRegistries, HeadlessPageDefinition, HeadlessPageInstance, HeadlessProjectConfigFile, HeadlessProjectDescriptor, HeadlessRouteRecord, HeadlessSelectorQueryResolverOptions, HeadlessSession, HeadlessSessionOptions, HeadlessTestingDataMatcher, HeadlessTestingLaunchOptions, HeadlessTestingLogicalNode, HeadlessTestingNodeHandle, HeadlessTestingPageCallMethodOptions, HeadlessTestingPageHandle, HeadlessTestingPageQueryOptions, HeadlessTestingPageSnapshot, HeadlessTestingPageWaitAccess, HeadlessTestingRenderedNodeSnapshot, HeadlessTestingRenderedOptions, HeadlessTestingRenderedPageAccess, HeadlessTestingRenderedSelectorNodesSnapshot, HeadlessTestingScopeHandle, HeadlessTestingSessionHandle, HeadlessTestingWaitForSelectorOptions, HeadlessTestingWaitOptions, HeadlessUniEventBus, HeadlessUniEventHandler, HeadlessWx, HeadlessWxAccessFileOption, HeadlessWxActionSheetLogEntry, HeadlessWxActionSheetMockDefinition, HeadlessWxAnimation, HeadlessWxAnimationAction, HeadlessWxAnimationExportResult, HeadlessWxAnimationStepOption, HeadlessWxAppBaseInfoResult, HeadlessWxAppendFileOption, HeadlessWxCallbackOption, HeadlessWxCanvasContext, HeadlessWxCanvasDrawCall, HeadlessWxCanvasSnapshot, HeadlessWxCanvasToTempFilePathOption, HeadlessWxCanvasToTempFilePathSuccessResult, HeadlessWxChooseImageOption, HeadlessWxChooseImageResult, HeadlessWxChooseImageTempFile, HeadlessWxChooseMediaOption, HeadlessWxChooseMediaResult, HeadlessWxChooseMediaTempFile, HeadlessWxChooseMessageFileOption, HeadlessWxChooseMessageFileResult, HeadlessWxChooseMessageFileTempFile, HeadlessWxChooseVideoOption, HeadlessWxChooseVideoResult, HeadlessWxClearStorageOption, HeadlessWxClipboardSnapshot, HeadlessWxCompressImageOption, HeadlessWxCompressImageResult, HeadlessWxCopyFileOption, HeadlessWxCreateIntersectionObserverOption, HeadlessWxDeviceInfoResult, HeadlessWxDownloadFileLogEntry, HeadlessWxDownloadFileMockDefinition, HeadlessWxDownloadFileOption, HeadlessWxDownloadFileSuccessResult, HeadlessWxDriver, HeadlessWxDriverCapabilities, HeadlessWxFileSystemManager, HeadlessWxFileSystemResult, HeadlessWxGetAppBaseInfoOption, HeadlessWxGetClipboardDataOption, HeadlessWxGetClipboardDataResult, HeadlessWxGetFileInfoOption, HeadlessWxGetFileInfoResult, HeadlessWxGetImageInfoOption, HeadlessWxGetImageInfoResult, HeadlessWxGetLocationOption, HeadlessWxGetLocationResult, HeadlessWxGetNetworkTypeOption, HeadlessWxGetNetworkTypeResult, HeadlessWxGetSavedFileInfoOption, HeadlessWxGetSavedFileInfoSuccessResult, HeadlessWxGetSavedFileListOption, HeadlessWxGetSavedFileListSuccessResult, HeadlessWxGetStorageInfoOption, HeadlessWxGetStorageOption, HeadlessWxGetStorageResult, HeadlessWxGetSystemInfoOption, HeadlessWxGetVideoInfoOption, HeadlessWxGetVideoInfoResult, HeadlessWxGetWindowInfoOption, HeadlessWxHideLoadingOption, HeadlessWxHideNavigationBarLoadingOption, HeadlessWxIntersectionObserver, HeadlessWxIntersectionObserverMargins, HeadlessWxIntersectionObserverObserveAllResult, HeadlessWxLaunchOptions, HeadlessWxLoadFontFaceOption, HeadlessWxLoadFontFaceResult, HeadlessWxLoadingSnapshot, HeadlessWxMediaQueryObserver, HeadlessWxMediaQueryObserverObserveCallbackResult, HeadlessWxMenuButtonBoundingClientRectResult, HeadlessWxMkdirOption, HeadlessWxModalLogEntry, HeadlessWxModalMockDefinition, HeadlessWxNavigateBackOption, HeadlessWxNavigateOption, HeadlessWxNetworkSnapshot, HeadlessWxNetworkStatusChangeCallback, HeadlessWxNetworkStatusChangeResult, HeadlessWxNetworkType, HeadlessWxObserveDescriptor, HeadlessWxOpenDocumentOption, HeadlessWxOpenDocumentResult, HeadlessWxOpenDocumentSnapshot, HeadlessWxPageScrollToOption, HeadlessWxPreviewImageOption, HeadlessWxPreviewImageResult, HeadlessWxPreviewImageSnapshot, HeadlessWxReadDirOption, HeadlessWxReadDirSuccessResult, HeadlessWxReadFileOption, HeadlessWxReadFileSuccessResult, HeadlessWxRemoveSavedFileOption, HeadlessWxRemoveStorageOption, HeadlessWxRenameOption, HeadlessWxRequestLogEntry, HeadlessWxRequestMockDefinition, HeadlessWxRequestOption, HeadlessWxRequestSuccessResult, HeadlessWxRequestTask, HeadlessWxRmdirOption, HeadlessWxSafeArea, HeadlessWxSafeAreaInsets, HeadlessWxSaveFileOption, HeadlessWxSaveFileSuccessResult, HeadlessWxSaveImageToPhotosAlbumOption, HeadlessWxSaveImageToPhotosAlbumResult, HeadlessWxSaveVideoToPhotosAlbumOption, HeadlessWxSaveVideoToPhotosAlbumResult, HeadlessWxSavedFileInfo, HeadlessWxSelectorQuery, HeadlessWxSelectorQueryBoundingClientRectResult, HeadlessWxSelectorQueryFieldsOption, HeadlessWxSelectorQueryNode, HeadlessWxSelectorQueryRequest, HeadlessWxSelectorQueryScrollOffsetResult, HeadlessWxSetBackgroundColorOption, HeadlessWxSetBackgroundTextStyleOption, HeadlessWxSetClipboardDataOption, HeadlessWxSetClipboardDataResult, HeadlessWxSetNavigationBarColorOption, HeadlessWxSetNavigationBarTitleOption, HeadlessWxSetStorageOption, HeadlessWxSetTabBarBadgeOption, HeadlessWxShareMenuOption, HeadlessWxShareMenuSnapshot, HeadlessWxShowActionSheetOption, HeadlessWxShowActionSheetResult, HeadlessWxShowLoadingOption, HeadlessWxShowModalOption, HeadlessWxShowModalResult, HeadlessWxShowNavigationBarLoadingOption, HeadlessWxShowToastOption, HeadlessWxStartPullDownRefreshOption, HeadlessWxStatOption, HeadlessWxStatSuccessResult, HeadlessWxStateOptions, HeadlessWxStats, HeadlessWxStorageInfoResult, HeadlessWxStorageResult, HeadlessWxSystemInfoResult, HeadlessWxTabBarItemOption, HeadlessWxTabBarOption, HeadlessWxToastSnapshot, HeadlessWxUnlinkOption, HeadlessWxUploadFileLogEntry, HeadlessWxUploadFileMockDefinition, HeadlessWxUploadFileOption, HeadlessWxUploadFileSuccessResult, HeadlessWxVideoContext, HeadlessWxWindowInfoResult, HeadlessWxWriteFileOption, MiniProgramEventBinding, PlatformAdapter, RenderedPageTree, RuntimeConsoleEntry, RuntimeDiagnosticEntry, RuntimeDiagnosticLevel, RuntimeDiagnostics, RuntimeKernel, type RuntimeRenderedPageTree, type RuntimeRendererContext, RuntimeScheduler, cloneValue, coerceComponentPropertyValue, collectMiniProgramEventBindings, createAppInstance, createArtifactProject, createBrowserHeadlessSession, createBrowserModuleLoader, createBrowserProject, createBrowserVirtualFiles, createBrowserVirtualFilesFromDirectory, createComponentInstance, createFileSystemArtifactSource, createHeadlessSession, createHeadlessUniEventBus, createHeadlessWx, createHeadlessWxState, createHostRegistries, createLogicalNode, createMemoryArtifactSource, createOverlayArtifactSource, createPageInstance, createProjectDescriptor, executeSelectorQueryRequests, hasBrowserVirtualFile, hasComponentPropertyValueChanged, launch, loadProject, normalizeBrowserFilePath, normalizeComponentPageDefinition, normalizeComponentPropertyValue, querySelectorAll, readBrowserVirtualFile, readRenderedNodes, readRenderedSelectorNodes, registerAppDefinition, registerComponentDefinition, registerExportedComponentDefinition, registerPageDefinition, renderBrowserPageTree, renderPageTree, renderRuntimePageTree, resolveMiniProgramEventBinding, resolveRoutesFromAppConfig, resolveSelectorQueryScopeRoot, resolveSelectorScrollTop, runComponentLifecycle, runComponentObservers, runComponentPageLifetime, waitForPageComponent, waitForPageComponents, waitForPageData, waitForPageSelector, waitForPageText, waitForPageTextGone, waitForRenderedPage, wechat };
package/dist/index.mjs CHANGED
@@ -65,15 +65,21 @@ function registerAppDefinition(registries, definition) {
65
65
  registries.appDefinition = definition;
66
66
  return definition;
67
67
  }
68
- function registerPageDefinition(registries, definition) {
69
- const route = registries.currentLoadContext?.route;
68
+ function registerPageDefinition(registries, definition, explicitRoute) {
69
+ const route = explicitRoute ?? registries.currentLoadContext?.route;
70
70
  if (!route) throw new Error("Cannot register Page() without an active page load context in headless runtime.");
71
71
  if (registries.pages.has(route)) throw createDuplicateRegistrationError("page", route);
72
72
  registries.pages.set(route, definition);
73
73
  return definition;
74
74
  }
75
75
  function registerComponentDefinition(registries, definition) {
76
- if (registries.currentLoadContext?.kind === "page") return registerPageDefinition(registries, normalizeComponentPageDefinition(definition));
76
+ if (registries.currentLoadContext?.kind === "page") {
77
+ if (registries.currentLoadContext.componentDefinitions) {
78
+ registries.currentLoadContext.componentDefinitions.push(definition);
79
+ return definition;
80
+ }
81
+ return registerPageDefinition(registries, normalizeComponentPageDefinition(definition));
82
+ }
77
83
  const id = registries.currentLoadContext?.route ?? `anonymous:${registries.components.size}`;
78
84
  if (registries.components.has(id)) throw createDuplicateRegistrationError("component", id);
79
85
  registries.components.set(id, definition);
@@ -692,7 +698,11 @@ function createBrowserModuleLoader(files, registries, getCurrentPages, getApp, w
692
698
  const contextEntries = Object.entries(executionContext);
693
699
  new Function(...contextEntries.map(([key]) => key), "exports", "module", "require", "__filename", "__dirname", source)(...contextEntries.map(([, value]) => value), module.exports, module, localRequire, resolvedPath, dirname(resolvedPath));
694
700
  const registeredDefinitions = [...registries.components.values()].filter((definition) => !registeredDefinitionsBefore.has(definition));
695
- module.componentDefinitions = [.../* @__PURE__ */ new Set([...requiredComponentDefinitions, ...registeredDefinitions])];
701
+ module.componentDefinitions = [.../* @__PURE__ */ new Set([
702
+ ...requiredComponentDefinitions,
703
+ ...loadContext?.componentDefinitions ?? [],
704
+ ...registeredDefinitions
705
+ ])];
696
706
  return module;
697
707
  } finally {
698
708
  registries.currentLoadContext = previousLoadContext;
@@ -708,11 +718,13 @@ function createBrowserModuleLoader(files, registries, getCurrentPages, getApp, w
708
718
  return registries.appDefinition;
709
719
  },
710
720
  executePageModule(filePath, route) {
711
- executeModule(filePath, {
721
+ const fallbackDefinition = executeModule(filePath, {
712
722
  kind: "page",
713
- route
714
- });
715
- const definition = registries.pages.get(route);
723
+ route,
724
+ componentDefinitions: []
725
+ }).componentDefinitions.at(-1);
726
+ const definition = registries.pages.get(route) ?? (fallbackDefinition ? normalizeComponentPageDefinition(fallbackDefinition) : void 0);
727
+ if (!registries.pages.has(route) && definition) registerPageDefinition(registries, definition, route);
716
728
  if (!definition) throw new Error(`Page() was not registered for route "${route}" while executing ${normalize(filePath)}.`);
717
729
  return definition;
718
730
  },
@@ -781,15 +793,24 @@ var RuntimeDiagnostics = class {
781
793
  timestamp: Date.now()
782
794
  });
783
795
  }
784
- createConsole(baseConsole = console) {
796
+ createConsole(baseConsole = console, onConsole) {
785
797
  const runtimeConsole = Object.create(baseConsole);
798
+ const wrap = (level, method) => (...args) => {
799
+ if (level === "error" || level === "warn") this.record(level, args);
800
+ onConsole?.({
801
+ args: [...args],
802
+ level
803
+ });
804
+ method(...args);
805
+ };
806
+ runtimeConsole.debug = wrap("debug", baseConsole.debug.bind(baseConsole));
807
+ runtimeConsole.info = wrap("info", baseConsole.info.bind(baseConsole));
808
+ runtimeConsole.log = wrap("log", baseConsole.log.bind(baseConsole));
786
809
  runtimeConsole.error = (...args) => {
787
- this.record("error", args);
788
- baseConsole.error(...args);
810
+ wrap("error", baseConsole.error.bind(baseConsole))(...args);
789
811
  };
790
812
  runtimeConsole.warn = (...args) => {
791
- this.record("warn", args);
792
- baseConsole.warn(...args);
813
+ wrap("warn", baseConsole.warn.bind(baseConsole))(...args);
793
814
  };
794
815
  return runtimeConsole;
795
816
  }
@@ -1875,9 +1896,10 @@ function resolveComponentProperties$1(clonedNode, scope, definition) {
1875
1896
  };
1876
1897
  }
1877
1898
  function createBrowserComponentInstance(componentScopeId, context, clonedNode, componentEntry, nextProperties, ownerScopeId) {
1899
+ 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;
1878
1900
  const componentInstance = createComponentInstance({
1879
1901
  definition: componentEntry.definition,
1880
- properties: nextProperties,
1902
+ properties: componentProperties,
1881
1903
  requestRender: (callback) => context.session.requestRender(callback),
1882
1904
  triggerEvent: buildComponentTrigger$1(componentScopeId, context, clonedNode)
1883
1905
  });
@@ -1890,7 +1912,7 @@ function createBrowserComponentInstance(componentScopeId, context, clonedNode, c
1890
1912
  componentInstance.selectOwnerComponent = () => ownerScopeId ? context.componentCache.get(ownerScopeId) ?? null : null;
1891
1913
  context.componentCache.set(componentScopeId, componentInstance);
1892
1914
  runComponentLifecycle(componentInstance, "created");
1893
- runComponentObservers(componentInstance.__definition__ ?? componentEntry.definition, componentInstance, Object.keys(nextProperties), {});
1915
+ runComponentObservers(componentInstance.__definition__ ?? componentEntry.definition, componentInstance, Object.keys(componentProperties), {});
1894
1916
  componentInstance.__propertySnapshots = Object.fromEntries(Object.entries(componentInstance.properties).map(([key, propertyValue]) => [key, cloneValue(propertyValue)]));
1895
1917
  runComponentLifecycle(componentInstance, "attached");
1896
1918
  runComponentPageLifetime(componentInstance, "show");
@@ -4243,12 +4265,15 @@ function parseNumericLikeValue$1(value) {
4243
4265
  const match = value.match(NUMERIC_LIKE_VALUE_RE$1);
4244
4266
  return match ? Number(match[0]) : 0;
4245
4267
  }
4246
- function resolveRect$1(node) {
4268
+ function resolveRect$1(node, windowInfo) {
4247
4269
  const style = parseStyleDeclarations$1(node.attribs?.style);
4248
4270
  const left = parseNumericLikeValue$1(node.attribs?.["data-sim-left"] ?? style.left);
4249
4271
  const top = parseNumericLikeValue$1(node.attribs?.["data-sim-top"] ?? style.top);
4250
- const width = parseNumericLikeValue$1(node.attribs?.["data-sim-width"] ?? style.width);
4251
- const height = parseNumericLikeValue$1(node.attribs?.["data-sim-height"] ?? style.height);
4272
+ const rawWidth = node.attribs?.["data-sim-width"] ?? style.width;
4273
+ const rawHeight = node.attribs?.["data-sim-height"] ?? style.height;
4274
+ const isTopLevelView = node.name === "view" && node.parent?.name === "page" && windowInfo?.windowWidth != null;
4275
+ const width = rawWidth != null ? parseNumericLikeValue$1(rawWidth) : isTopLevelView && windowInfo ? windowInfo.windowWidth : 0;
4276
+ const height = rawHeight != null ? parseNumericLikeValue$1(rawHeight) : isTopLevelView && windowInfo ? windowInfo.windowHeight : 0;
4252
4277
  return {
4253
4278
  bottom: top + height,
4254
4279
  height,
@@ -4295,7 +4320,7 @@ function resolveFieldsResult(node, fields, options) {
4295
4320
  if (fields.dataset) result.dataset = collectDataset$2(node);
4296
4321
  if (fields.mark) result.mark = collectMark(node);
4297
4322
  if (fields.rect || fields.size) {
4298
- const rect = resolveRect$1(node);
4323
+ const rect = resolveRect$1(node, options.root.name === "page" ? options.windowInfo : void 0);
4299
4324
  if (fields.rect) Object.assign(result, rect);
4300
4325
  if (fields.size) {
4301
4326
  result.width = rect.width;
@@ -6569,9 +6594,10 @@ function resolveComponentProperties(clonedNode, scope, definition) {
6569
6594
  };
6570
6595
  }
6571
6596
  function createRuntimeComponentInstance(componentScopeId, context, clonedNode, componentEntry, nextProperties, ownerScopeId) {
6597
+ 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;
6572
6598
  const componentInstance = createComponentInstance({
6573
6599
  definition: componentEntry.definition,
6574
- properties: nextProperties,
6600
+ properties: componentProperties,
6575
6601
  requestRender: (callback) => context.session.requestRender(callback),
6576
6602
  triggerEvent: buildComponentTrigger(componentScopeId, context, clonedNode)
6577
6603
  });
@@ -6584,7 +6610,7 @@ function createRuntimeComponentInstance(componentScopeId, context, clonedNode, c
6584
6610
  componentInstance.selectOwnerComponent = () => ownerScopeId ? context.componentCache.get(ownerScopeId) ?? null : null;
6585
6611
  context.componentCache.set(componentScopeId, componentInstance);
6586
6612
  runComponentLifecycle(componentInstance, "created");
6587
- runComponentObservers(componentInstance.__definition__ ?? componentEntry.definition, componentInstance, Object.keys(nextProperties), {});
6613
+ runComponentObservers(componentInstance.__definition__ ?? componentEntry.definition, componentInstance, Object.keys(componentProperties), {});
6588
6614
  componentInstance.__propertySnapshots = Object.fromEntries(Object.entries(componentInstance.properties).map(([key, propertyValue]) => [key, cloneValue(propertyValue)]));
6589
6615
  runComponentLifecycle(componentInstance, "attached");
6590
6616
  return componentInstance;
@@ -6795,6 +6821,102 @@ function renderRuntimePageTree(context, page) {
6795
6821
  }
6796
6822
  //#endregion
6797
6823
  //#region src/runtime/moduleLoader.ts
6824
+ const ESM_IMPORT_LINE_RE = /^[ \t]*import[^\n]*$/gm;
6825
+ const ESM_EXPORT_LIST_RE = /^[ \t]*export[ \t]*\{([^}\n]+)\}[ \t]*;?$/gm;
6826
+ const ESM_EXPORT_DECLARATION_RE = /\bexport\s+(const|let|var|function|class)\s+([A-Za-z_$][\w$]*)/g;
6827
+ const ESM_EXPORT_DEFAULT_DECLARATION_RE = /\bexport\s+default\s+(function|class)\s+([A-Za-z_$][\w$]*)/g;
6828
+ function isImportWhitespace(value) {
6829
+ return value === " " || value === " ";
6830
+ }
6831
+ function parseEsmImportLine(line) {
6832
+ let statement = line.trim().slice(6).trim();
6833
+ if (statement.endsWith(";")) statement = statement.slice(0, -1).trimEnd();
6834
+ if (statement.startsWith("\"") || statement.startsWith("'")) {
6835
+ const quote = statement[0];
6836
+ if (statement.endsWith(quote) && statement.length > 1) return {
6837
+ request: statement.slice(1, -1),
6838
+ sideEffect: true
6839
+ };
6840
+ return;
6841
+ }
6842
+ let fromIndex = statement.indexOf("from");
6843
+ while (fromIndex >= 0) {
6844
+ if (isImportWhitespace(statement[fromIndex - 1]) && isImportWhitespace(statement[fromIndex + 4])) break;
6845
+ fromIndex = statement.indexOf("from", fromIndex + 4);
6846
+ }
6847
+ if (fromIndex < 0) return;
6848
+ const specifier = statement.slice(0, fromIndex).trim();
6849
+ const requestLiteral = statement.slice(fromIndex + 4).trim();
6850
+ const quote = requestLiteral[0];
6851
+ if (!specifier || quote !== "\"" && quote !== "'" || requestLiteral.length < 2 || !requestLiteral.endsWith(quote)) return;
6852
+ return {
6853
+ request: requestLiteral.slice(1, -1),
6854
+ sideEffect: false,
6855
+ specifier
6856
+ };
6857
+ }
6858
+ function createEsmImportBindings(specifier, request, index) {
6859
+ const namespaceName = `__headlessEsmImport${index}`;
6860
+ const statements = [`const ${namespaceName} = require(${JSON.stringify(request)});`];
6861
+ const normalizedSpecifier = specifier.trim();
6862
+ if (normalizedSpecifier.startsWith("{") && normalizedSpecifier.endsWith("}")) {
6863
+ const entries = normalizedSpecifier.slice(1, -1).split(",");
6864
+ for (const entry of entries) {
6865
+ const [importedName, localName] = entry.trim().split(/\s+as\s+/);
6866
+ if (!importedName) continue;
6867
+ const bindingName = localName || importedName;
6868
+ statements.push(`const ${bindingName} = ${namespaceName}[${JSON.stringify(importedName)}];`);
6869
+ }
6870
+ return statements.join("\n");
6871
+ }
6872
+ if (normalizedSpecifier.startsWith("* as ")) {
6873
+ const bindingName = normalizedSpecifier.slice(5).trim();
6874
+ statements.push(`const ${bindingName} = ${namespaceName};`);
6875
+ return statements.join("\n");
6876
+ }
6877
+ const [defaultName, namedPart] = normalizedSpecifier.split(/\s*,\s*/, 2);
6878
+ if (defaultName) statements.push(`const ${defaultName.trim()} = ${namespaceName}.default ?? ${namespaceName};`);
6879
+ if (namedPart?.startsWith("{") && namedPart.endsWith("}")) statements.push(createEsmImportBindings(namedPart, request, index).split("\n").slice(1).join("\n"));
6880
+ return statements.join("\n");
6881
+ }
6882
+ function transformEsmToCommonJs(source) {
6883
+ if (!/^\s*(?:import|export)\b/m.test(source)) return source;
6884
+ let importIndex = 0;
6885
+ const exportedNames = [];
6886
+ let transformed = source.replace(ESM_IMPORT_LINE_RE, (line) => {
6887
+ const parsed = parseEsmImportLine(line);
6888
+ if (!parsed) return line;
6889
+ if (parsed.sideEffect) return `require(${JSON.stringify(parsed.request)});`;
6890
+ return createEsmImportBindings(parsed.specifier, parsed.request, importIndex++);
6891
+ });
6892
+ transformed = transformed.replace(ESM_EXPORT_LIST_RE, (_match, entries) => {
6893
+ for (const entry of entries.split(",")) {
6894
+ const [local, exported] = entry.trim().split(/\s+as\s+/);
6895
+ if (local) exportedNames.push({
6896
+ exported: exported || local,
6897
+ local
6898
+ });
6899
+ }
6900
+ return "";
6901
+ });
6902
+ transformed = transformed.replace(ESM_EXPORT_DEFAULT_DECLARATION_RE, (_match, kind, local) => {
6903
+ exportedNames.push({
6904
+ exported: "default",
6905
+ local
6906
+ });
6907
+ return `${kind} ${local}`;
6908
+ });
6909
+ transformed = transformed.replace(ESM_EXPORT_DECLARATION_RE, (_match, kind, local) => {
6910
+ exportedNames.push({
6911
+ exported: local,
6912
+ local
6913
+ });
6914
+ return `${kind} ${local}`;
6915
+ });
6916
+ transformed = transformed.replace(/\bexport\s+default\s+/g, "module.exports.default = ");
6917
+ if (exportedNames.length > 0) transformed += `\n${exportedNames.map(({ exported, local }) => `module.exports[${JSON.stringify(exported)}] = ${local};`).join("\n")}`;
6918
+ return transformed;
6919
+ }
6798
6920
  function createRequireNotFoundError(request, importer) {
6799
6921
  return /* @__PURE__ */ new Error(`Cannot resolve require("${request}") from ${normalize(importer)} in headless runtime.`);
6800
6922
  }
@@ -6810,7 +6932,7 @@ function resolveRequiredModulePath(artifactSource, importer, request) {
6810
6932
  for (const candidate of candidates) if (artifactSource.has(candidate)) return candidate;
6811
6933
  throw createRequireNotFoundError(request, importer);
6812
6934
  }
6813
- function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, kernel, globals) {
6935
+ function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, kernel, globals, onConsole) {
6814
6936
  const wx = createHeadlessWx(wxDriver);
6815
6937
  return {
6816
6938
  App(definition) {
@@ -6828,7 +6950,7 @@ function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, k
6828
6950
  Page(definition) {
6829
6951
  return registerPageDefinition(registries, definition);
6830
6952
  },
6831
- console: kernel.diagnostics.createConsole(),
6953
+ console: kernel.diagnostics.createConsole(console, onConsole),
6832
6954
  clearInterval: (handle) => kernel.scheduler.clearInterval(handle),
6833
6955
  clearTimeout: (handle) => kernel.scheduler.clearTimeout(handle),
6834
6956
  getApp,
@@ -6838,13 +6960,17 @@ function createExecutionContext(registries, getCurrentPages, getApp, wxDriver, k
6838
6960
  require: void 0,
6839
6961
  setInterval: kernel.scheduler.setInterval.bind(kernel.scheduler),
6840
6962
  setTimeout: kernel.scheduler.setTimeout.bind(kernel.scheduler),
6963
+ TextDecoder: globalThis.TextDecoder,
6964
+ TextEncoder: globalThis.TextEncoder,
6965
+ URL: globalThis.URL,
6966
+ URLSearchParams: globalThis.URLSearchParams,
6841
6967
  wx,
6842
6968
  ...globals
6843
6969
  };
6844
6970
  }
6845
6971
  function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, options) {
6846
6972
  const moduleCache = /* @__PURE__ */ new Map();
6847
- const executionContext = createExecutionContext(registries, getCurrentPages, getApp, wxDriver, options.kernel, options.globals ?? {});
6973
+ const executionContext = createExecutionContext(registries, getCurrentPages, getApp, wxDriver, options.kernel, options.globals ?? {}, options.onConsole);
6848
6974
  executionContext.globalThis = executionContext;
6849
6975
  function executeModule(filePath, loadContext) {
6850
6976
  const resolvedPath = path.resolve(filePath);
@@ -6874,9 +7000,13 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
6874
7000
  });
6875
7001
  localRequire.async = (request) => Promise.resolve().then(() => localRequire(request));
6876
7002
  try {
6877
- new vm.Script(`(function (exports, module, require, __filename, __dirname) { ${source}\n})`, { filename: resolvedPath }).runInNewContext(executionContext)(module.exports, module, localRequire, resolvedPath, path.dirname(resolvedPath));
7003
+ new vm.Script(`(function (exports, module, require, __filename, __dirname) { ${transformEsmToCommonJs(source)}\n})`, { filename: resolvedPath }).runInNewContext(executionContext)(module.exports, module, localRequire, resolvedPath, path.dirname(resolvedPath));
6878
7004
  const registeredDefinitions = [...registries.components.values()].filter((definition) => !registeredDefinitionsBefore.has(definition));
6879
- module.componentDefinitions = [.../* @__PURE__ */ new Set([...requiredComponentDefinitions, ...registeredDefinitions])];
7005
+ module.componentDefinitions = [.../* @__PURE__ */ new Set([
7006
+ ...requiredComponentDefinitions,
7007
+ ...loadContext?.componentDefinitions ?? [],
7008
+ ...registeredDefinitions
7009
+ ])];
6880
7010
  return module;
6881
7011
  } finally {
6882
7012
  registries.currentLoadContext = previousLoadContext;
@@ -6892,11 +7022,13 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
6892
7022
  return registries.appDefinition;
6893
7023
  },
6894
7024
  executePageModule(filePath, route) {
6895
- executeModule(filePath, {
7025
+ const fallbackDefinition = executeModule(filePath, {
6896
7026
  kind: "page",
6897
- route
6898
- });
6899
- const definition = registries.pages.get(route);
7027
+ route,
7028
+ componentDefinitions: []
7029
+ }).componentDefinitions.at(-1);
7030
+ const definition = registries.pages.get(route) ?? (fallbackDefinition ? normalizeComponentPageDefinition(fallbackDefinition) : void 0);
7031
+ if (!registries.pages.has(route) && definition) registerPageDefinition(registries, definition, route);
6900
7032
  if (!definition) throw new Error(`Page() was not registered for route "${route}" while executing ${normalize(filePath)}.`);
6901
7033
  return definition;
6902
7034
  },
@@ -6993,6 +7125,7 @@ var HeadlessSession = class {
6993
7125
  appDefinition = null;
6994
7126
  appInstance = null;
6995
7127
  moduleLoader;
7128
+ eventListeners = /* @__PURE__ */ new Map();
6996
7129
  registries;
6997
7130
  currentPageInstance = null;
6998
7131
  pages = [];
@@ -7134,7 +7267,8 @@ var HeadlessSession = class {
7134
7267
  }, {
7135
7268
  artifactSource: this.project.artifactSource,
7136
7269
  globals: options.globals,
7137
- kernel: this.kernel
7270
+ kernel: this.kernel,
7271
+ onConsole: (entry) => this.emit("console", entry)
7138
7272
  });
7139
7273
  }
7140
7274
  assertActive() {
@@ -7148,11 +7282,26 @@ var HeadlessSession = class {
7148
7282
  this.renderRequestPending = false;
7149
7283
  this.wxState.close();
7150
7284
  this.moduleLoader.close();
7285
+ this.eventListeners.clear();
7151
7286
  this.kernel.close();
7152
7287
  }
7153
7288
  getDiagnostics() {
7154
7289
  return this.kernel.diagnostics.getEntries();
7155
7290
  }
7291
+ on(eventName, handler) {
7292
+ if (!eventName || typeof handler !== "function") return;
7293
+ const listeners = this.eventListeners.get(eventName) ?? /* @__PURE__ */ new Set();
7294
+ listeners.add(handler);
7295
+ this.eventListeners.set(eventName, listeners);
7296
+ }
7297
+ removeListener(eventName, handler) {
7298
+ const listeners = this.eventListeners.get(eventName);
7299
+ listeners?.delete(handler);
7300
+ if (listeners?.size === 0) this.eventListeners.delete(eventName);
7301
+ }
7302
+ emit(eventName, ...args) {
7303
+ for (const handler of [...this.eventListeners.get(eventName) ?? []]) handler(...args);
7304
+ }
7156
7305
  get isClosed() {
7157
7306
  return this.kernel.isClosed;
7158
7307
  }
@@ -7164,6 +7313,10 @@ var HeadlessSession = class {
7164
7313
  this.assertActive();
7165
7314
  return this.pages.slice();
7166
7315
  }
7316
+ getWx() {
7317
+ this.assertActive();
7318
+ return this.moduleLoader.wx;
7319
+ }
7167
7320
  callWxMethod(methodName, ...args) {
7168
7321
  this.assertActive();
7169
7322
  const method = this.moduleLoader.wx[methodName];
@@ -7559,9 +7712,19 @@ var HeadlessSession = class {
7559
7712
  this.appDefinition = this.moduleLoader.executeAppModule(appModulePath);
7560
7713
  this.appInstance = createAppInstance(this.appDefinition);
7561
7714
  this.appInstance.onLaunch?.(launchOptions);
7715
+ this.syncRuntimeAppState();
7562
7716
  this.appInstance.onShow?.(launchOptions);
7563
7717
  return this.appInstance;
7564
7718
  }
7719
+ syncRuntimeAppState() {
7720
+ const runtimeApp = this.appInstance?.__wevuRuntimeApp;
7721
+ if (!runtimeApp || typeof runtimeApp !== "object" || !this.appInstance) return;
7722
+ if (runtimeApp.globalData && typeof runtimeApp.globalData === "object") this.appInstance.globalData = {
7723
+ ...this.appInstance.globalData,
7724
+ ...runtimeApp.globalData
7725
+ };
7726
+ if (Object.hasOwn(runtimeApp, "routes")) this.appInstance.routes = runtimeApp.routes;
7727
+ }
7565
7728
  reLaunch(url) {
7566
7729
  const target = this.resolveNavigationTarget(url);
7567
7730
  this.bootstrap(createAppLaunchOptions(target.normalizedRoute, target.query));
@@ -8209,7 +8372,10 @@ var HeadlessTestingPageHandle = class {
8209
8372
  return await runWithTimeout(async () => {
8210
8373
  this.session?.renderCurrentPage();
8211
8374
  const method = this.page[normalizedMethodName];
8212
- if (typeof method !== "function") throw new TypeError(`Method "${normalizedMethodName}" does not exist on headless page ${this.page.route}.`);
8375
+ if (typeof method !== "function") {
8376
+ if (options.routeOnly) return;
8377
+ throw new TypeError(`Method "${normalizedMethodName}" does not exist on headless page ${this.page.route}.`);
8378
+ }
8213
8379
  return cloneProtocolValue(await method.apply(this.page, args));
8214
8380
  }, options.timeout, `Timed out calling page method "${normalizedMethodName}" in headless testing runtime.`);
8215
8381
  }
@@ -8384,6 +8550,24 @@ var HeadlessTestingSessionHandle = class {
8384
8550
  async close() {
8385
8551
  this.session.close();
8386
8552
  }
8553
+ on(eventName, handler) {
8554
+ this.session.on(eventName, handler);
8555
+ return this;
8556
+ }
8557
+ removeListener(eventName, handler) {
8558
+ this.session.removeListener(eventName, handler);
8559
+ return this;
8560
+ }
8561
+ off(eventName, handler) {
8562
+ return this.removeListener(eventName, handler);
8563
+ }
8564
+ async evaluate(evaluator, ...args) {
8565
+ return await this.evaluateWithOptions(evaluator, {}, ...args);
8566
+ }
8567
+ async evaluateWithOptions(evaluator, options = {}, ...args) {
8568
+ this.session.assertActive();
8569
+ return await runWithTimeout(() => this.evaluateInRuntime(evaluator, args), options.timeout, "Timed out evaluating code in headless testing runtime.");
8570
+ }
8387
8571
  async currentPage() {
8388
8572
  this.session.assertActive();
8389
8573
  const current = this.session.getCurrentPages().at(-1);
@@ -8480,13 +8664,46 @@ var HeadlessTestingSessionHandle = class {
8480
8664
  if (!page) throw new Error(`Failed to ${methodName} route "${route}" through the headless wx runtime.`);
8481
8665
  return page;
8482
8666
  }
8667
+ async evaluateInRuntime(evaluator, args) {
8668
+ const runtimeGlobals = {
8669
+ getApp: () => this.session.getApp(),
8670
+ getCurrentPages: () => this.session.getCurrentPages(),
8671
+ wx: this.session.getWx()
8672
+ };
8673
+ const host = globalThis;
8674
+ const previous = /* @__PURE__ */ new Map();
8675
+ for (const [name, value] of Object.entries(runtimeGlobals)) {
8676
+ previous.set(name, Object.getOwnPropertyDescriptor(host, name));
8677
+ Object.defineProperty(host, name, {
8678
+ configurable: true,
8679
+ enumerable: false,
8680
+ value,
8681
+ writable: true
8682
+ });
8683
+ }
8684
+ try {
8685
+ const fn = typeof evaluator === "string" ? new vm.Script(`(${evaluator})`).runInThisContext() : evaluator;
8686
+ if (typeof fn !== "function") throw new TypeError("Headless evaluator must be a function or function source string.");
8687
+ return await fn(...args);
8688
+ } finally {
8689
+ for (const [name, descriptor] of previous) if (descriptor) Object.defineProperty(host, name, descriptor);
8690
+ else delete host[name];
8691
+ }
8692
+ }
8483
8693
  };
8484
8694
  //#endregion
8485
8695
  //#region src/testing/launch.ts
8696
+ function resolveInitialRoute(session) {
8697
+ const entryPagePath = typeof session.project.appConfig.entryPagePath === "string" ? session.project.appConfig.entryPagePath.trim().replace(/^\/+/, "") : "";
8698
+ if (entryPagePath && session.project.routes.some((route) => route.route === entryPagePath)) return entryPagePath;
8699
+ return session.project.routes[0]?.route ?? null;
8700
+ }
8486
8701
  async function launch(options) {
8487
8702
  const session = createHeadlessSession({ projectPath: options.projectPath });
8488
8703
  session.bootstrap();
8704
+ const initialRoute = resolveInitialRoute(session);
8705
+ if (initialRoute) session.reLaunch(`/${initialRoute}`);
8489
8706
  return new HeadlessTestingSessionHandle(session.project, session);
8490
8707
  }
8491
8708
  //#endregion
8492
- export { BrowserHeadlessSession, HeadlessSession, HeadlessTestingNodeHandle, HeadlessTestingPageHandle, HeadlessTestingScopeHandle, HeadlessTestingSessionHandle, RuntimeDiagnostics, RuntimeKernel, RuntimeScheduler, cloneValue, coerceComponentPropertyValue, collectMiniProgramEventBindings, createAppInstance, createArtifactProject, createBrowserHeadlessSession, createBrowserModuleLoader, createBrowserProject, createBrowserVirtualFiles, createBrowserVirtualFilesFromDirectory, createComponentInstance, createFileSystemArtifactSource, createHeadlessSession, createHeadlessUniEventBus, createHeadlessWx, createHeadlessWxState, createHostRegistries, createLogicalNode, createMemoryArtifactSource, createOverlayArtifactSource, createPageInstance, createProjectDescriptor, executeSelectorQueryRequests, hasBrowserVirtualFile, hasComponentPropertyValueChanged, launch, loadProject, normalizeBrowserFilePath, normalizeComponentPropertyValue, querySelectorAll, readBrowserVirtualFile, readRenderedNodes, readRenderedSelectorNodes, registerAppDefinition, registerComponentDefinition, registerExportedComponentDefinition, registerPageDefinition, renderBrowserPageTree, renderPageTree, renderRuntimePageTree, resolveMiniProgramEventBinding, resolveRoutesFromAppConfig, resolveSelectorQueryScopeRoot, resolveSelectorScrollTop, runComponentLifecycle, runComponentObservers, runComponentPageLifetime, waitForPageComponent, waitForPageComponents, waitForPageData, waitForPageSelector, waitForPageText, waitForPageTextGone, waitForRenderedPage, wechat };
8709
+ export { BrowserHeadlessSession, HeadlessSession, HeadlessTestingNodeHandle, HeadlessTestingPageHandle, HeadlessTestingScopeHandle, HeadlessTestingSessionHandle, RuntimeDiagnostics, RuntimeKernel, RuntimeScheduler, cloneValue, coerceComponentPropertyValue, collectMiniProgramEventBindings, createAppInstance, createArtifactProject, createBrowserHeadlessSession, createBrowserModuleLoader, createBrowserProject, createBrowserVirtualFiles, createBrowserVirtualFilesFromDirectory, createComponentInstance, createFileSystemArtifactSource, createHeadlessSession, createHeadlessUniEventBus, createHeadlessWx, createHeadlessWxState, createHostRegistries, createLogicalNode, createMemoryArtifactSource, createOverlayArtifactSource, createPageInstance, createProjectDescriptor, executeSelectorQueryRequests, hasBrowserVirtualFile, hasComponentPropertyValueChanged, launch, loadProject, normalizeBrowserFilePath, normalizeComponentPageDefinition, normalizeComponentPropertyValue, querySelectorAll, readBrowserVirtualFile, readRenderedNodes, readRenderedSelectorNodes, registerAppDefinition, registerComponentDefinition, registerExportedComponentDefinition, registerPageDefinition, renderBrowserPageTree, renderPageTree, renderRuntimePageTree, resolveMiniProgramEventBinding, resolveRoutesFromAppConfig, resolveSelectorQueryScopeRoot, resolveSelectorScrollTop, runComponentLifecycle, runComponentObservers, runComponentPageLifetime, waitForPageComponent, waitForPageComponents, waitForPageData, waitForPageSelector, waitForPageText, waitForPageTextGone, waitForRenderedPage, wechat };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mpcore/simulator",
3
3
  "type": "module",
4
- "version": "0.3.2",
4
+ "version": "0.3.4",
5
5
  "description": "Headless mini-program runtime and testing kernel for the weapp-vite ecosystem",
6
6
  "author": "ice breaker <1324318532@qq.com>",
7
7
  "license": "MIT",
@@ -41,7 +41,7 @@
41
41
  "@babel/parser": "^8.0.4",
42
42
  "htmlparser2": "^12.0.0",
43
43
  "pathe": "^2.0.3",
44
- "@weapp-core/constants": "0.1.17"
44
+ "@weapp-core/constants": "0.2.0"
45
45
  },
46
46
  "publishConfig": {
47
47
  "access": "public",