@mpcore/simulator 0.3.3 → 0.4.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
@@ -8,6 +8,7 @@
8
8
  - 提供 `App/Page/Component/getApp/getCurrentPages/wx` 的最小宿主模拟
9
9
  - 已支持部分常用宿主 API,如导航、request mock(含 delay / abort)、sync/async storage 与 storage info、toast、loading、showModal(含默认确认与可编程 mock 返回)、showActionSheet(含默认选择与可编程取消/选项返回)、`showShareMenu/updateShareMenu/hideShareMenu`、`showTabBar/hideTabBar/showTabBarRedDot/hideTabBarRedDot/setTabBarBadge/removeTabBarBadge`、`setBackgroundTextStyle/setBackgroundColor`、getNetworkType/onNetworkStatusChange/offNetworkStatusChange、`setNavigationBarTitle/setNavigationBarColor/showNavigationBarLoading/hideNavigationBarLoading`、launch/enter options、system info、window/app base info、menu button rect、`wx.canIUse`、`wx.nextTick`
10
10
  - 提供面向 e2e/runtime 断言的页面启动、重启与 WXML 查询能力
11
+ - 支持本地 `pluginRoot` 的 `requirePlugin`、`plugin://` 公开组件与插件页面导航
11
12
  - 提供测试节点句柄上的 `tap()`、`trigger()`、`input()`、`change()`、`blur()` 交互辅助方法
12
13
  - 提供测试页面/会话句柄上的 `waitForSelector()`、`waitForText()`、`waitForTextGone()`、`waitForData()`、`waitForCurrentPage()` 等轮询等待方法
13
14
  - 通过共享 `RuntimeKernel` 管理 artifact、独立执行 realm、timer、diagnostics 与平台适配边界
package/dist/index.d.mts CHANGED
@@ -1122,40 +1122,32 @@ declare class RuntimeKernel {
1122
1122
  get isClosed(): boolean;
1123
1123
  }
1124
1124
  //#endregion
1125
- //#region src/browser/virtualFiles.d.ts
1126
- interface BrowserDirectoryFileLike {
1127
- name: string;
1128
- text: () => Promise<string>;
1129
- webkitRelativePath?: string;
1130
- }
1131
- type BrowserVirtualFiles = Map<string, string>;
1132
- declare function normalizeBrowserFilePath(filePath: string): string;
1133
- declare function createBrowserVirtualFiles(entries: Iterable<[string, string]>): BrowserVirtualFiles;
1134
- declare function createBrowserVirtualFilesFromDirectory(files: BrowserDirectoryFileLike[]): Promise<BrowserVirtualFiles>;
1135
- declare function readBrowserVirtualFile(files: BrowserVirtualFiles, filePath: string): string | undefined;
1136
- declare function hasBrowserVirtualFile(files: BrowserVirtualFiles, filePath: string): boolean;
1137
- //#endregion
1138
- //#region src/browser/moduleLoader.d.ts
1139
- interface BrowserModuleLoader {
1140
- close: () => void;
1141
- executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
1142
- executeAppModule: (filePath: string) => HeadlessAppDefinition;
1143
- executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
1144
- wx: HeadlessWx;
1145
- }
1146
- declare function createBrowserModuleLoader(files: BrowserVirtualFiles, registries: HeadlessHostRegistries, getCurrentPages: () => any[], getApp: () => any, wxDriver: Parameters<typeof createHeadlessWx>[0], options: {
1147
- globals?: Record<string, unknown>;
1148
- kernel: RuntimeKernel;
1149
- }): BrowserModuleLoader;
1125
+ //#region src/project/plugins.d.ts
1126
+ declare const HEADLESS_PLUGIN_VIRTUAL_ROOT = "__plugins__";
1127
+ interface HeadlessPluginDescriptor {
1128
+ alias: string;
1129
+ config: Record<string, any>;
1130
+ provider: string;
1131
+ rootPath: string;
1132
+ virtualRoot: string;
1133
+ }
1134
+ declare function createPluginVirtualRoot(alias: string): string;
1135
+ declare function resolvePluginRequest(plugins: HeadlessPluginDescriptor[], request: string, kind: 'page' | 'publicComponent'): {
1136
+ plugin: HeadlessPluginDescriptor;
1137
+ publicName: string;
1138
+ resourcePath: string;
1139
+ } | undefined;
1140
+ declare function createPluginArtifactSource(fallback: ArtifactSource, miniprogramRootPath: string, plugins: HeadlessPluginDescriptor[]): ArtifactSource;
1150
1141
  //#endregion
1151
1142
  //#region src/project/resolveRoutes.d.ts
1152
1143
  interface HeadlessRouteRecord {
1153
1144
  kind: 'page';
1154
1145
  route: string;
1155
- source: 'pages' | 'subPackages';
1146
+ source: 'pages' | 'plugin' | 'subPackages';
1147
+ resourcePath?: string;
1156
1148
  subpackageRoot?: string;
1157
1149
  }
1158
- declare function resolveRoutesFromAppConfig(config: Record<string, any>): HeadlessRouteRecord[];
1150
+ declare function resolveRoutesFromAppConfig(config: Record<string, any>, plugins?: HeadlessPluginDescriptor[]): HeadlessRouteRecord[];
1159
1151
  //#endregion
1160
1152
  //#region src/project/createProjectDescriptor.d.ts
1161
1153
  interface HeadlessProjectConfigFile {
@@ -1168,6 +1160,7 @@ interface HeadlessProjectDescriptor {
1168
1160
  appConfigPath: string;
1169
1161
  miniprogramRoot: string;
1170
1162
  miniprogramRootPath: string;
1163
+ plugins: HeadlessPluginDescriptor[];
1171
1164
  projectPath: string;
1172
1165
  projectConfigFiles: HeadlessProjectConfigFile[];
1173
1166
  routes: HeadlessRouteRecord[];
@@ -1178,16 +1171,58 @@ interface CreateProjectDescriptorOptions {
1178
1171
  appConfigPath: string;
1179
1172
  miniprogramRoot: string;
1180
1173
  miniprogramRootPath: string;
1174
+ plugins?: HeadlessPluginDescriptor[];
1181
1175
  projectPath: string;
1182
1176
  projectConfigFiles?: HeadlessProjectConfigFile[];
1183
1177
  }
1184
1178
  declare function createProjectDescriptor(options: CreateProjectDescriptorOptions): HeadlessProjectDescriptor;
1185
1179
  //#endregion
1180
+ //#region src/project/createArtifactProject.d.ts
1181
+ interface CreateArtifactProjectOptions {
1182
+ appConfigPath?: string;
1183
+ artifactSource?: ArtifactSource;
1184
+ miniprogramRootPath: string;
1185
+ projectPath?: string;
1186
+ }
1187
+ declare function createArtifactProject(options: CreateArtifactProjectOptions): HeadlessProjectDescriptor;
1188
+ //#endregion
1189
+ //#region src/project/loadProject.d.ts
1190
+ declare function loadProject(projectPath: string): HeadlessProjectDescriptor;
1191
+ //#endregion
1192
+ //#region src/browser/virtualFiles.d.ts
1193
+ interface BrowserDirectoryFileLike {
1194
+ name: string;
1195
+ text: () => Promise<string>;
1196
+ webkitRelativePath?: string;
1197
+ }
1198
+ type BrowserVirtualFiles = Map<string, string>;
1199
+ declare function normalizeBrowserFilePath(filePath: string): string;
1200
+ declare function createBrowserVirtualFiles(entries: Iterable<[string, string]>): BrowserVirtualFiles;
1201
+ declare function createBrowserVirtualFilesFromDirectory(files: BrowserDirectoryFileLike[]): Promise<BrowserVirtualFiles>;
1202
+ declare function readBrowserVirtualFile(files: BrowserVirtualFiles, filePath: string): string | undefined;
1203
+ declare function hasBrowserVirtualFile(files: BrowserVirtualFiles, filePath: string): boolean;
1204
+ //#endregion
1205
+ //#region src/browser/moduleLoader.d.ts
1206
+ interface BrowserModuleLoader {
1207
+ close: () => void;
1208
+ executeComponentModule: (filePath: string, id: string) => HeadlessComponentDefinition;
1209
+ executeAppModule: (filePath: string) => HeadlessAppDefinition;
1210
+ executePageModule: (filePath: string, route: string) => HeadlessPageDefinition;
1211
+ wx: HeadlessWx;
1212
+ }
1213
+ declare function createBrowserModuleLoader(files: BrowserVirtualFiles, registries: HeadlessHostRegistries, getCurrentPages: () => any[], getApp: () => any, wxDriver: Parameters<typeof createHeadlessWx>[0], options: {
1214
+ globals?: Record<string, unknown>;
1215
+ kernel: RuntimeKernel;
1216
+ miniprogramRootPath: string;
1217
+ plugins: HeadlessPluginDescriptor[];
1218
+ }): BrowserModuleLoader;
1219
+ //#endregion
1186
1220
  //#region src/browser/project.d.ts
1187
1221
  interface CreateBrowserProjectOptions {
1188
1222
  appConfigPath?: string;
1189
1223
  miniprogramRoot?: string;
1190
1224
  miniprogramRootPath?: string;
1225
+ plugins?: HeadlessPluginDescriptor[];
1191
1226
  projectPath?: string;
1192
1227
  }
1193
1228
  declare function createBrowserProject(files: BrowserVirtualFiles, options?: CreateBrowserProjectOptions): HeadlessProjectDescriptor;
@@ -1351,18 +1386,6 @@ interface HeadlessAppInstance extends Record<string, any> {
1351
1386
  }
1352
1387
  declare function createAppInstance(definition: HeadlessAppDefinition): HeadlessAppInstance;
1353
1388
  //#endregion
1354
- //#region src/project/createArtifactProject.d.ts
1355
- interface CreateArtifactProjectOptions {
1356
- appConfigPath?: string;
1357
- artifactSource?: ArtifactSource;
1358
- miniprogramRootPath: string;
1359
- projectPath?: string;
1360
- }
1361
- declare function createArtifactProject(options: CreateArtifactProjectOptions): HeadlessProjectDescriptor;
1362
- //#endregion
1363
- //#region src/project/loadProject.d.ts
1364
- declare function loadProject(projectPath: string): HeadlessProjectDescriptor;
1365
- //#endregion
1366
1389
  //#region src/runtime/moduleLoader.d.ts
1367
1390
  interface HeadlessModuleLoader {
1368
1391
  close: () => void;
@@ -2916,4 +2939,4 @@ interface HeadlessTestingLaunchOptions {
2916
2939
  }
2917
2940
  declare function launch(options: HeadlessTestingLaunchOptions): Promise<HeadlessTestingSessionHandle>;
2918
2941
  //#endregion
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 };
2942
+ export { ArtifactSource, BrowserDirectoryFileLike, BrowserHeadlessSession, BrowserHeadlessSessionOptions, BrowserModuleLoader, type BrowserRenderedPageTree, type BrowserRendererContext, BrowserVirtualFiles, CreateArtifactProjectOptions, CreateBrowserProjectOptions, type CreateComponentInstanceOptions, CreateProjectDescriptorOptions, HEADLESS_PLUGIN_VIRTUAL_ROOT, HeadlessAppDefinition, HeadlessAppInstance, HeadlessBehaviorDefinition, HeadlessComponentDefinition, type HeadlessComponentInstance, HeadlessHostLoadContext, HeadlessHostRegistries, HeadlessPageDefinition, HeadlessPageInstance, HeadlessPluginDescriptor, 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, createPluginArtifactSource, createPluginVirtualRoot, createProjectDescriptor, executeSelectorQueryRequests, hasBrowserVirtualFile, hasComponentPropertyValueChanged, launch, loadProject, normalizeBrowserFilePath, normalizeComponentPageDefinition, normalizeComponentPropertyValue, querySelectorAll, readBrowserVirtualFile, readRenderedNodes, readRenderedSelectorNodes, registerAppDefinition, registerComponentDefinition, registerExportedComponentDefinition, registerPageDefinition, renderBrowserPageTree, renderPageTree, renderRuntimePageTree, resolveMiniProgramEventBinding, resolvePluginRequest, resolveRoutesFromAppConfig, resolveSelectorQueryScopeRoot, resolveSelectorScrollTop, runComponentLifecycle, runComponentObservers, runComponentPageLifetime, waitForPageComponent, waitForPageComponents, waitForPageData, waitForPageSelector, waitForPageText, waitForPageTextGone, waitForRenderedPage, wechat };
package/dist/index.mjs CHANGED
@@ -708,6 +708,12 @@ function createBrowserModuleLoader(files, registries, getCurrentPages, getApp, w
708
708
  registries.currentLoadContext = previousLoadContext;
709
709
  }
710
710
  }
711
+ executionContext.requirePlugin = (alias) => {
712
+ const plugin = options.plugins.find((item) => item.alias === alias);
713
+ if (!plugin) throw new Error(`Unknown local plugin "${alias}" in browser simulator runtime.`);
714
+ const main = typeof plugin.config.main === "string" && plugin.config.main ? plugin.config.main : "index.js";
715
+ return executeModule(normalize(join(options.miniprogramRootPath, plugin.virtualRoot, main)), null).exports;
716
+ };
711
717
  return {
712
718
  close() {
713
719
  moduleCache.clear();
@@ -916,7 +922,7 @@ function pushRoute(records, seen, record) {
916
922
  seen.add(record.route);
917
923
  records.push(record);
918
924
  }
919
- function resolveRoutesFromAppConfig(config) {
925
+ function resolveRoutesFromAppConfig(config, plugins = []) {
920
926
  const records = [];
921
927
  const seen = /* @__PURE__ */ new Set();
922
928
  if (Array.isArray(config.pages)) for (const page of config.pages) {
@@ -946,6 +952,19 @@ function resolveRoutesFromAppConfig(config) {
946
952
  });
947
953
  }
948
954
  }
955
+ for (const plugin of plugins) {
956
+ const pages = plugin.config.pages;
957
+ if (!pages || typeof pages !== "object" || Array.isArray(pages)) continue;
958
+ for (const resourcePath of Object.values(pages)) {
959
+ if (typeof resourcePath !== "string" || !resourcePath) continue;
960
+ pushRoute(records, seen, {
961
+ kind: "page",
962
+ resourcePath: `${plugin.virtualRoot}/${resourcePath}`,
963
+ route: `plugin-private://${plugin.provider}/${resourcePath}`,
964
+ source: "plugin"
965
+ });
966
+ }
967
+ }
949
968
  return records;
950
969
  }
951
970
  //#endregion
@@ -957,9 +976,46 @@ function createProjectDescriptor(options) {
957
976
  appConfigPath: options.appConfigPath,
958
977
  miniprogramRoot: options.miniprogramRoot,
959
978
  miniprogramRootPath: options.miniprogramRootPath,
979
+ plugins: options.plugins ?? [],
960
980
  projectPath: options.projectPath,
961
981
  projectConfigFiles: options.projectConfigFiles ?? [],
962
- routes: resolveRoutesFromAppConfig(options.appConfig)
982
+ routes: resolveRoutesFromAppConfig(options.appConfig, options.plugins ?? [])
983
+ };
984
+ }
985
+ //#endregion
986
+ //#region src/project/plugins.ts
987
+ const HEADLESS_PLUGIN_VIRTUAL_ROOT = "__plugins__";
988
+ const PLUGIN_URL_RE = /^plugin:\/\/([^/]+)\/(.+)$/;
989
+ function createPluginVirtualRoot(alias) {
990
+ return `${HEADLESS_PLUGIN_VIRTUAL_ROOT}/${alias}`;
991
+ }
992
+ function resolvePluginRequest(plugins, request, kind) {
993
+ const match = PLUGIN_URL_RE.exec(request);
994
+ if (!match) return;
995
+ const [, alias, publicName] = match;
996
+ const plugin = plugins.find((item) => item.alias === alias);
997
+ const registry = kind === "page" ? plugin?.config.pages : plugin?.config.publicComponents;
998
+ const resourcePath = registry && typeof registry === "object" && !Array.isArray(registry) ? registry[publicName] : void 0;
999
+ if (!plugin || typeof resourcePath !== "string" || !resourcePath) return;
1000
+ return {
1001
+ plugin,
1002
+ publicName,
1003
+ resourcePath: `${plugin.virtualRoot}/${resourcePath}`
1004
+ };
1005
+ }
1006
+ function createPluginArtifactSource(fallback, miniprogramRootPath, plugins) {
1007
+ function resolvePhysicalPath(filePath) {
1008
+ const normalizedPath = path.resolve(filePath);
1009
+ for (const plugin of plugins) {
1010
+ const virtualRootPath = path.resolve(miniprogramRootPath, plugin.virtualRoot);
1011
+ const relativePath = path.relative(virtualRootPath, normalizedPath);
1012
+ if (!relativePath.startsWith("..") && !path.isAbsolute(relativePath)) return path.resolve(plugin.rootPath, relativePath);
1013
+ }
1014
+ return normalizedPath;
1015
+ }
1016
+ return {
1017
+ has: (filePath) => fallback.has(resolvePhysicalPath(filePath)),
1018
+ readText: (filePath) => fallback.readText(resolvePhysicalPath(filePath))
963
1019
  };
964
1020
  }
965
1021
  //#endregion
@@ -974,11 +1030,33 @@ function readJsonObject$3(files, filePath) {
974
1030
  return;
975
1031
  }
976
1032
  }
1033
+ function resolveBrowserPlugins(files, appConfig) {
1034
+ const configuredPlugins = appConfig.plugins;
1035
+ if (!configuredPlugins || typeof configuredPlugins !== "object" || Array.isArray(configuredPlugins)) return [];
1036
+ const plugins = [];
1037
+ for (const [alias, definition] of Object.entries(configuredPlugins)) {
1038
+ if (!definition || typeof definition !== "object" || Array.isArray(definition)) continue;
1039
+ const provider = definition.provider;
1040
+ const version = definition.version;
1041
+ const virtualRoot = createPluginVirtualRoot(alias);
1042
+ const config = readJsonObject$3(files, `${virtualRoot}/plugin.json`);
1043
+ if (typeof provider !== "string" || !provider || version !== "dev" || !config) continue;
1044
+ plugins.push({
1045
+ alias,
1046
+ config,
1047
+ provider,
1048
+ rootPath: virtualRoot,
1049
+ virtualRoot
1050
+ });
1051
+ }
1052
+ return plugins;
1053
+ }
977
1054
  function createBrowserProject(files, options = {}) {
978
1055
  const appConfigPath = options.appConfigPath ?? "app.json";
979
1056
  if (!hasBrowserVirtualFile(files, appConfigPath)) throw new Error(`Missing built app.json for browser simulator project: ${appConfigPath}`);
980
1057
  const appConfig = readJsonObject$3(files, appConfigPath);
981
1058
  if (!appConfig) throw new Error(`Failed to read built app.json for browser simulator project: ${appConfigPath}`);
1059
+ const plugins = options.plugins ?? resolveBrowserPlugins(files, appConfig);
982
1060
  return createProjectDescriptor({
983
1061
  appConfig,
984
1062
  appConfigPath,
@@ -988,6 +1066,7 @@ function createBrowserProject(files, options = {}) {
988
1066
  },
989
1067
  miniprogramRoot: options.miniprogramRoot ?? ".",
990
1068
  miniprogramRootPath: options.miniprogramRootPath ?? "/",
1069
+ plugins,
991
1070
  projectPath: options.projectPath ?? "browser://simulator",
992
1071
  projectConfigFiles: []
993
1072
  });
@@ -1627,11 +1706,12 @@ function isMustacheOnly$1(value) {
1627
1706
  function toDatasetKey$4(attributeName) {
1628
1707
  return attributeName.slice(5).replace(DATASET_NAME_RE$4, (_match, char) => char.toUpperCase());
1629
1708
  }
1630
- function collectDataset$4(node) {
1709
+ function collectDataset$4(node, source) {
1631
1710
  const dataset = {};
1632
1711
  for (const [key, value] of Object.entries(node.attribs ?? {})) {
1633
1712
  if (!key.startsWith("data-") || key === "data-sim-scope" || key === "data-sim-tap" || key === "data-sim-component") continue;
1634
- dataset[toDatasetKey$4(key)] = String(value);
1713
+ const resolvedValue = source && isMustacheOnly$1(value) ? resolveTemplateExpression(source, value) : value;
1714
+ dataset[toDatasetKey$4(key)] = String(resolvedValue ?? "");
1635
1715
  }
1636
1716
  return dataset;
1637
1717
  }
@@ -1742,7 +1822,7 @@ function createLoopScope$1(scope, itemName, indexName, item, index) {
1742
1822
  //#endregion
1743
1823
  //#region src/browser/render/component.ts
1744
1824
  function resolveComponentRegistryEntry$1(context, ownerJsonPath, ownerFilePath, alias, genericComponentBasePath) {
1745
- const usingComponents = resolveUsingComponents$1(context.files, ownerJsonPath, ownerFilePath);
1825
+ const usingComponents = resolveUsingComponents$1(context, ownerJsonPath, ownerFilePath);
1746
1826
  const componentBasePath = genericComponentBasePath ?? usingComponents.get(alias);
1747
1827
  if (!componentBasePath) return null;
1748
1828
  const filePath = `${componentBasePath}.js`;
@@ -1762,14 +1842,14 @@ function readComponentConfig$1(files, jsonPath) {
1762
1842
  return {};
1763
1843
  }
1764
1844
  }
1765
- function resolveUsingComponents$1(files, ownerJsonPath, ownerFilePath) {
1845
+ function resolveUsingComponents$1(context, ownerJsonPath, ownerFilePath) {
1766
1846
  try {
1767
- const usingComponents = readComponentConfig$1(files, ownerJsonPath).usingComponents;
1847
+ const usingComponents = readComponentConfig$1(context.files, ownerJsonPath).usingComponents;
1768
1848
  if (!usingComponents || typeof usingComponents !== "object" || Array.isArray(usingComponents)) return /* @__PURE__ */ new Map();
1769
1849
  const resolved = /* @__PURE__ */ new Map();
1770
1850
  for (const [alias, rawPath] of Object.entries(usingComponents)) {
1771
1851
  if (typeof rawPath !== "string") continue;
1772
- const basePath = rawPath.startsWith("/") ? rawPath.replace(LEADING_SLASH_RE$5, "") : normalize(join(dirname(ownerFilePath), rawPath));
1852
+ const basePath = resolvePluginRequest(context.project.plugins, rawPath, "publicComponent")?.resourcePath ?? (rawPath.startsWith("/") ? rawPath.replace(LEADING_SLASH_RE$5, "") : normalize(join(dirname(ownerFilePath), rawPath)));
1773
1853
  resolved.set(alias, basePath.replace(LEADING_SLASH_RE$5, ""));
1774
1854
  }
1775
1855
  return resolved;
@@ -1781,7 +1861,7 @@ function resolveComponentGenerics$1(context, hostNode, ownerJsonPath, ownerFileP
1781
1861
  const componentJsonPath = `${componentFilePath.replace(JS_FILE_RE$1, "")}.json`;
1782
1862
  const componentGenerics = readComponentConfig$1(context.files, componentJsonPath).componentGenerics;
1783
1863
  if (!componentGenerics || typeof componentGenerics !== "object" || Array.isArray(componentGenerics)) return;
1784
- const ownerComponents = resolveUsingComponents$1(context.files, ownerJsonPath, ownerFilePath);
1864
+ const ownerComponents = resolveUsingComponents$1(context, ownerJsonPath, ownerFilePath);
1785
1865
  const resolved = /* @__PURE__ */ new Map();
1786
1866
  for (const [genericName, definition] of Object.entries(componentGenerics)) {
1787
1867
  const selectedAlias = hostNode.attribs?.[`generic:${genericName}`];
@@ -1806,9 +1886,10 @@ function buildComponentTrigger$1(componentScopeId, context, hostNode) {
1806
1886
  return (instance, eventName, detail, triggerOptions) => {
1807
1887
  const interactionTarget = instance.__lastInteractionEvent__?.target;
1808
1888
  const interactionCurrentTarget = instance.__lastInteractionEvent__?.currentTarget;
1889
+ const componentDataset = context.componentScopes.get(componentScopeId)?.dataset ?? hostDataset;
1809
1890
  const interactionMark = instance.__lastInteractionEvent__?.mark;
1810
1891
  const target = {
1811
- dataset: interactionTarget?.dataset ?? hostDataset,
1892
+ dataset: interactionTarget?.dataset ?? componentDataset,
1812
1893
  id: interactionTarget?.id ?? hostId
1813
1894
  };
1814
1895
  let currentScopeId = componentScopeId;
@@ -1864,7 +1945,7 @@ function createComponentScope$1(clonedNode, scope, componentScopeId, componentIn
1864
1945
  alias: clonedNode.name,
1865
1946
  classList: String(clonedNode.attribs?.class ?? "").split(CLASS_SPLIT_RE$1).map((item) => item.trim()).filter(Boolean),
1866
1947
  data: createMergedScopeData$1(scope.data, componentInstance.properties, componentInstance.data),
1867
- dataset: collectDataset$4(clonedNode),
1948
+ dataset: collectDataset$4(clonedNode, scope.data),
1868
1949
  eventBindings: collectComponentEventBindings$1(clonedNode),
1869
1950
  getMethod: (methodName) => {
1870
1951
  const method = componentInstance?.[methodName];
@@ -2088,7 +2169,8 @@ function renderNodeTree$1(node, scope, context, ownerJsonPath, ownerFilePath, in
2088
2169
  }
2089
2170
  function renderBrowserPageTree(context, page) {
2090
2171
  const route = page.route.replace(LEADING_SLASH_RE$5, "");
2091
- const templatePath = join(context.project.miniprogramRootPath, `${route}.wxml`);
2172
+ const resourcePath = context.project.routes.find((item) => item.route === route)?.resourcePath ?? route;
2173
+ const templatePath = join(context.project.miniprogramRootPath, `${resourcePath}.wxml`);
2092
2174
  const document = parseTemplateDocument$1(readTemplateSource$1(context.files, templatePath));
2093
2175
  const pageScopeId = `page:${route}`;
2094
2176
  const pageScope = {
@@ -2105,7 +2187,7 @@ function renderBrowserPageTree(context, page) {
2105
2187
  const seenComponentScopes = /* @__PURE__ */ new Set();
2106
2188
  const root = (document.children ?? [])[0] ?? document;
2107
2189
  const templateRenderState = createTemplateRenderState(root);
2108
- const renderedRoot = renderNodeTree$1(root, pageScope, context, `${route}.json`, `${route}.js`, pageScopeId, seenComponentScopes, templateRenderState);
2190
+ const renderedRoot = renderNodeTree$1(root, pageScope, context, `${resourcePath}.json`, `${resourcePath}.js`, pageScopeId, seenComponentScopes, templateRenderState);
2109
2191
  for (const [scopeId, instance] of [...context.componentCache.entries()]) if (!seenComponentScopes.has(scopeId)) {
2110
2192
  runComponentLifecycle(instance, "detached");
2111
2193
  context.componentCache.delete(scopeId);
@@ -5331,7 +5413,9 @@ var BrowserHeadlessSession = class {
5331
5413
  updateShareMenu: (option) => this.wxState.updateShareMenu(option)
5332
5414
  }, {
5333
5415
  globals: options.globals,
5334
- kernel: this.kernel
5416
+ kernel: this.kernel,
5417
+ miniprogramRootPath: this.project.miniprogramRootPath,
5418
+ plugins: this.project.plugins
5335
5419
  });
5336
5420
  }
5337
5421
  assertActive() {
@@ -6007,8 +6091,9 @@ var BrowserHeadlessSession = class {
6007
6091
  });
6008
6092
  }
6009
6093
  createFreshPage(target) {
6010
- const pageModulePath = join(this.project.miniprogramRootPath, `${target.routeRecord.route}.js`);
6011
- const pageConfigPath = join(this.project.miniprogramRootPath, `${target.routeRecord.route}.json`);
6094
+ const resourcePath = target.routeRecord.resourcePath ?? target.routeRecord.route;
6095
+ const pageModulePath = join(this.project.miniprogramRootPath, `${resourcePath}.js`);
6096
+ const pageConfigPath = join(this.project.miniprogramRootPath, `${resourcePath}.json`);
6012
6097
  const pageDefinition = this.moduleLoader.executePageModule(pageModulePath, target.routeRecord.route);
6013
6098
  const pageConfig = readJsonObject$2(this.files, pageConfigPath);
6014
6099
  const pageInstance = createPageInstance(target.routeRecord.route, pageDefinition, target.query, {
@@ -6037,7 +6122,9 @@ var BrowserHeadlessSession = class {
6037
6122
  }
6038
6123
  resolveNavigationTarget(url) {
6039
6124
  const { pathname, query } = parseNavigationUrl$1(url);
6040
- const normalizedRoute = resolveNavigationPath$1(pathname, this.currentPageInstance ? stripLeadingSlash$1(this.currentPageInstance.route) : void 0);
6125
+ const baseRoute = this.currentPageInstance ? stripLeadingSlash$1(this.currentPageInstance.route) : void 0;
6126
+ const pluginRequest = resolvePluginRequest(this.project.plugins, pathname, "page");
6127
+ const normalizedRoute = pluginRequest ? `plugin-private://${pluginRequest.plugin.provider}/${pluginRequest.resourcePath.slice(pluginRequest.plugin.virtualRoot.length + 1)}` : resolveNavigationPath$1(pathname, baseRoute);
6041
6128
  const routeRecord = this.project.routes.find((item) => item.route === normalizedRoute);
6042
6129
  if (!routeRecord) {
6043
6130
  this.bootstrap(createAppLaunchOptions$1(normalizedRoute, query));
@@ -6266,6 +6353,36 @@ function resolveMiniprogramRoot(projectPath, configFiles) {
6266
6353
  }
6267
6354
  throw new Error(`Failed to resolve miniprogramRoot for headless runtime project: ${projectPath}. Expected project.config.json or project.private.config.json to define miniprogramRoot.`);
6268
6355
  }
6356
+ function resolveConfiguredRoot(configFiles, key) {
6357
+ for (const configFile of [...configFiles].reverse()) {
6358
+ const value = configFile.value[key];
6359
+ if (typeof value === "string" && value.trim()) return value.trim();
6360
+ }
6361
+ }
6362
+ function resolveLocalPlugins(projectPath, projectConfigFiles, appConfig) {
6363
+ const pluginRoot = resolveConfiguredRoot(projectConfigFiles, "pluginRoot");
6364
+ const configuredPlugins = appConfig.plugins;
6365
+ if (!pluginRoot || !configuredPlugins || typeof configuredPlugins !== "object" || Array.isArray(configuredPlugins)) return [];
6366
+ const rootPath = path.resolve(projectPath, pluginRoot);
6367
+ const pluginConfig = readJsonObject$1(path.resolve(rootPath, "plugin.json"));
6368
+ if (!pluginConfig) return [];
6369
+ const plugins = [];
6370
+ const projectAppId = resolveConfiguredRoot(projectConfigFiles, "appid");
6371
+ for (const [alias, definition] of Object.entries(configuredPlugins)) {
6372
+ if (!definition || typeof definition !== "object" || Array.isArray(definition)) continue;
6373
+ const provider = definition.provider;
6374
+ const isLocalPlugin = definition.version === "dev" || projectAppId && provider === projectAppId;
6375
+ if (typeof provider !== "string" || !provider || !isLocalPlugin) continue;
6376
+ plugins.push({
6377
+ alias,
6378
+ config: pluginConfig,
6379
+ provider,
6380
+ rootPath,
6381
+ virtualRoot: createPluginVirtualRoot(alias)
6382
+ });
6383
+ }
6384
+ return plugins;
6385
+ }
6269
6386
  function ensureFileExists(filePath, label) {
6270
6387
  if (fs.existsSync(filePath)) return;
6271
6388
  throw new Error(`Missing ${label} for headless runtime project: ${normalize(filePath)}`);
@@ -6284,11 +6401,15 @@ function loadProject(projectPath) {
6284
6401
  ensureFileExists(miniprogramRootPath, "miniprogramRoot directory");
6285
6402
  const appConfigPath = path.resolve(miniprogramRootPath, "app.json");
6286
6403
  ensureFileExists(appConfigPath, "built app.json");
6404
+ const appConfig = loadAppConfig(appConfigPath);
6405
+ const plugins = resolveLocalPlugins(normalizedProjectPath, projectConfigFiles, appConfig);
6287
6406
  return createProjectDescriptor({
6288
- appConfig: loadAppConfig(appConfigPath),
6407
+ appConfig,
6289
6408
  appConfigPath,
6409
+ artifactSource: createPluginArtifactSource(createFileSystemArtifactSource(), miniprogramRootPath, plugins),
6290
6410
  miniprogramRoot,
6291
6411
  miniprogramRootPath,
6412
+ plugins,
6292
6413
  projectPath: normalizedProjectPath,
6293
6414
  projectConfigFiles
6294
6415
  });
@@ -6323,11 +6444,12 @@ function isMustacheOnly(value) {
6323
6444
  function toDatasetKey(attributeName) {
6324
6445
  return attributeName.slice(5).replace(DATASET_NAME_RE, (_match, char) => char.toUpperCase());
6325
6446
  }
6326
- function collectDataset(node) {
6447
+ function collectDataset(node, source) {
6327
6448
  const dataset = {};
6328
6449
  for (const [key, value] of Object.entries(node.attribs ?? {})) {
6329
6450
  if (!key.startsWith("data-") || key === "data-sim-scope" || key === "data-sim-tap" || key === "data-sim-component") continue;
6330
- dataset[toDatasetKey(key)] = String(value);
6451
+ const resolvedValue = source && isMustacheOnly(value) ? resolveTemplateExpression(source, value) : value;
6452
+ dataset[toDatasetKey(key)] = String(resolvedValue ?? "");
6331
6453
  }
6332
6454
  return dataset;
6333
6455
  }
@@ -6438,7 +6560,7 @@ function createLoopScope(scope, itemName, indexName, item, index) {
6438
6560
  //#endregion
6439
6561
  //#region src/runtime/render/component.ts
6440
6562
  function resolveComponentRegistryEntry(context, ownerJsonPath, ownerFilePath, alias, genericComponentBasePath) {
6441
- const usingComponents = resolveUsingComponents(context.artifactSource, ownerJsonPath, ownerFilePath);
6563
+ const usingComponents = resolveUsingComponents(context, ownerJsonPath, ownerFilePath);
6442
6564
  const componentBasePath = genericComponentBasePath ?? usingComponents.get(alias);
6443
6565
  if (!componentBasePath) return null;
6444
6566
  const filePath = `${componentBasePath}.js`;
@@ -6460,14 +6582,14 @@ function readComponentConfig(artifactSource, jsonPath) {
6460
6582
  return {};
6461
6583
  }
6462
6584
  }
6463
- function resolveUsingComponents(artifactSource, ownerJsonPath, ownerFilePath) {
6585
+ function resolveUsingComponents(context, ownerJsonPath, ownerFilePath) {
6464
6586
  try {
6465
- const usingComponents = readComponentConfig(artifactSource, ownerJsonPath).usingComponents;
6587
+ const usingComponents = readComponentConfig(context.artifactSource, ownerJsonPath).usingComponents;
6466
6588
  if (!usingComponents || typeof usingComponents !== "object" || Array.isArray(usingComponents)) return /* @__PURE__ */ new Map();
6467
6589
  const resolved = /* @__PURE__ */ new Map();
6468
6590
  for (const [alias, rawPath] of Object.entries(usingComponents)) {
6469
6591
  if (typeof rawPath !== "string") continue;
6470
- const basePath = rawPath.startsWith("/") ? rawPath.replace(LEADING_SLASH_RE$2, "") : path.posix.normalize(path.posix.join(path.posix.dirname(ownerFilePath), rawPath));
6592
+ const basePath = resolvePluginRequest(context.project.plugins, rawPath, "publicComponent")?.resourcePath ?? (rawPath.startsWith("/") ? rawPath.replace(LEADING_SLASH_RE$2, "") : path.posix.normalize(path.posix.join(path.posix.dirname(ownerFilePath), rawPath)));
6471
6593
  resolved.set(alias, basePath.replace(LEADING_SLASH_RE$2, ""));
6472
6594
  }
6473
6595
  return resolved;
@@ -6479,7 +6601,7 @@ function resolveComponentGenerics(context, hostNode, ownerJsonPath, ownerFilePat
6479
6601
  const componentJsonPath = path.resolve(context.project.miniprogramRootPath, `${componentFilePath.replace(JS_FILE_RE, "")}.json`);
6480
6602
  const componentGenerics = readComponentConfig(context.artifactSource, componentJsonPath).componentGenerics;
6481
6603
  if (!componentGenerics || typeof componentGenerics !== "object" || Array.isArray(componentGenerics)) return;
6482
- const ownerComponents = resolveUsingComponents(context.artifactSource, ownerJsonPath, ownerFilePath);
6604
+ const ownerComponents = resolveUsingComponents(context, ownerJsonPath, ownerFilePath);
6483
6605
  const resolved = /* @__PURE__ */ new Map();
6484
6606
  for (const [genericName, definition] of Object.entries(componentGenerics)) {
6485
6607
  const selectedAlias = hostNode.attribs?.[`generic:${genericName}`];
@@ -6504,9 +6626,10 @@ function buildComponentTrigger(componentScopeId, context, hostNode) {
6504
6626
  return (instance, eventName, detail, triggerOptions) => {
6505
6627
  const interactionTarget = instance.__lastInteractionEvent__?.target;
6506
6628
  const interactionCurrentTarget = instance.__lastInteractionEvent__?.currentTarget;
6629
+ const componentDataset = context.componentScopes.get(componentScopeId)?.dataset ?? hostDataset;
6507
6630
  const interactionMark = instance.__lastInteractionEvent__?.mark;
6508
6631
  const target = {
6509
- dataset: interactionTarget?.dataset ?? hostDataset,
6632
+ dataset: interactionTarget?.dataset ?? componentDataset,
6510
6633
  id: interactionTarget?.id ?? hostId
6511
6634
  };
6512
6635
  let currentScopeId = componentScopeId;
@@ -6562,7 +6685,7 @@ function createComponentScope(clonedNode, scope, componentScopeId, componentInst
6562
6685
  alias: clonedNode.name,
6563
6686
  classList: String(clonedNode.attribs?.class ?? "").split(CLASS_SPLIT_RE).map((item) => item.trim()).filter(Boolean),
6564
6687
  data: createMergedScopeData(scope.data, componentInstance.properties, componentInstance.data),
6565
- dataset: collectDataset(clonedNode),
6688
+ dataset: collectDataset(clonedNode, scope.data),
6566
6689
  eventBindings: collectComponentEventBindings(clonedNode),
6567
6690
  getMethod: (methodName) => {
6568
6691
  const method = componentInstance?.[methodName];
@@ -6791,7 +6914,8 @@ function renderNodeTree(node, scope, context, ownerJsonPath, ownerFilePath, inst
6791
6914
  }
6792
6915
  function renderRuntimePageTree(context, page) {
6793
6916
  const route = page.route.replace(LEADING_SLASH_RE$2, "");
6794
- const templatePath = path.resolve(context.project.miniprogramRootPath, `${route}.wxml`);
6917
+ const resourcePath = context.project.routes.find((item) => item.route === route)?.resourcePath ?? route;
6918
+ const templatePath = path.resolve(context.project.miniprogramRootPath, `${resourcePath}.wxml`);
6795
6919
  const document = parseTemplateDocument(readTemplateSource(context.artifactSource, templatePath));
6796
6920
  const pageScopeId = `page:${route}`;
6797
6921
  const pageScope = {
@@ -6808,7 +6932,7 @@ function renderRuntimePageTree(context, page) {
6808
6932
  const seenComponentScopes = /* @__PURE__ */ new Set();
6809
6933
  const root = (document.children ?? [])[0] ?? document;
6810
6934
  const templateRenderState = createTemplateRenderState(root);
6811
- const renderedRoot = renderNodeTree(root, pageScope, context, path.resolve(context.project.miniprogramRootPath, `${route}.json`), `${route}.js`, pageScopeId, seenComponentScopes, templateRenderState);
6935
+ const renderedRoot = renderNodeTree(root, pageScope, context, path.resolve(context.project.miniprogramRootPath, `${resourcePath}.json`), `${resourcePath}.js`, pageScopeId, seenComponentScopes, templateRenderState);
6812
6936
  for (const [scopeId, instance] of [...context.componentCache.entries()]) if (!seenComponentScopes.has(scopeId)) {
6813
6937
  runComponentLifecycle(instance, "detached");
6814
6938
  context.componentCache.delete(scopeId);
@@ -7012,6 +7136,12 @@ function createModuleLoader(registries, getCurrentPages, getApp, wxDriver, optio
7012
7136
  registries.currentLoadContext = previousLoadContext;
7013
7137
  }
7014
7138
  }
7139
+ executionContext.requirePlugin = (alias) => {
7140
+ const plugin = options.plugins.find((item) => item.alias === alias);
7141
+ if (!plugin) throw new Error(`Unknown local plugin "${alias}" in headless runtime.`);
7142
+ const main = typeof plugin.config.main === "string" && plugin.config.main ? plugin.config.main : "index.js";
7143
+ return executeModule(path.resolve(options.miniprogramRootPath, plugin.virtualRoot, main), null).exports;
7144
+ };
7015
7145
  return {
7016
7146
  close() {
7017
7147
  moduleCache.clear();
@@ -7268,7 +7398,9 @@ var HeadlessSession = class {
7268
7398
  artifactSource: this.project.artifactSource,
7269
7399
  globals: options.globals,
7270
7400
  kernel: this.kernel,
7271
- onConsole: (entry) => this.emit("console", entry)
7401
+ miniprogramRootPath: this.project.miniprogramRootPath,
7402
+ onConsole: (entry) => this.emit("console", entry),
7403
+ plugins: this.project.plugins
7272
7404
  });
7273
7405
  }
7274
7406
  assertActive() {
@@ -7887,8 +8019,9 @@ var HeadlessSession = class {
7887
8019
  });
7888
8020
  }
7889
8021
  createFreshPage(target) {
7890
- const pageModulePath = path.resolve(this.project.miniprogramRootPath, `${target.routeRecord.route}.js`);
7891
- const pageConfigPath = path.resolve(this.project.miniprogramRootPath, `${target.routeRecord.route}.json`);
8022
+ const resourcePath = target.routeRecord.resourcePath ?? target.routeRecord.route;
8023
+ const pageModulePath = path.resolve(this.project.miniprogramRootPath, `${resourcePath}.js`);
8024
+ const pageConfigPath = path.resolve(this.project.miniprogramRootPath, `${resourcePath}.json`);
7892
8025
  const pageDefinition = this.moduleLoader.executePageModule(pageModulePath, target.routeRecord.route);
7893
8026
  const pageConfig = readJsonObject(this.project, pageConfigPath);
7894
8027
  const pageInstance = createPageInstance(`/${target.routeRecord.route}`, pageDefinition, target.query, {
@@ -7923,7 +8056,9 @@ var HeadlessSession = class {
7923
8056
  }
7924
8057
  resolveNavigationTarget(url) {
7925
8058
  const { pathname, query } = parseNavigationUrl(url);
7926
- const normalizedRoute = resolveNavigationPath(pathname, this.currentPageInstance ? stripLeadingSlash(this.currentPageInstance.route) : void 0);
8059
+ const baseRoute = this.currentPageInstance ? stripLeadingSlash(this.currentPageInstance.route) : void 0;
8060
+ const pluginRequest = resolvePluginRequest(this.project.plugins, pathname, "page");
8061
+ const normalizedRoute = pluginRequest ? `plugin-private://${pluginRequest.plugin.provider}/${pluginRequest.resourcePath.slice(pluginRequest.plugin.virtualRoot.length + 1)}` : resolveNavigationPath(pathname, baseRoute);
7927
8062
  const routeRecord = this.project.routes.find((item) => item.route === normalizedRoute);
7928
8063
  if (!routeRecord) {
7929
8064
  this.bootstrap(createAppLaunchOptions(normalizedRoute, query));
@@ -8706,4 +8841,4 @@ async function launch(options) {
8706
8841
  return new HeadlessTestingSessionHandle(session.project, session);
8707
8842
  }
8708
8843
  //#endregion
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 };
8844
+ export { BrowserHeadlessSession, HEADLESS_PLUGIN_VIRTUAL_ROOT, 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, createPluginArtifactSource, createPluginVirtualRoot, createProjectDescriptor, executeSelectorQueryRequests, hasBrowserVirtualFile, hasComponentPropertyValueChanged, launch, loadProject, normalizeBrowserFilePath, normalizeComponentPageDefinition, normalizeComponentPropertyValue, querySelectorAll, readBrowserVirtualFile, readRenderedNodes, readRenderedSelectorNodes, registerAppDefinition, registerComponentDefinition, registerExportedComponentDefinition, registerPageDefinition, renderBrowserPageTree, renderPageTree, renderRuntimePageTree, resolveMiniProgramEventBinding, resolvePluginRequest, 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.3",
4
+ "version": "0.4.0",
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",