@open-wxa/wxa-runner-core 0.5.0 → 0.7.0

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
-import { D as DeviceProfile } from './setup-Cv340Lvj.mjs';
-export { A as ApiContext, a as ApiHandler, b as ApiResult, c as AppInfo, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition } from './setup-Cv340Lvj.mjs';
-export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-DO2FyR78.mjs';
+import { D as DeviceProfile } from './setup-DZ5FeKay.mjs';
+export { A as ApiContext, a as ApiHandler, b as ApiResult, c as AppInfo, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition } from './setup-DZ5FeKay.mjs';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-CnZOLyWw.mjs';
 
 /**
  * 小程序项目结构解析
@@ -32,8 +32,10 @@ interface AppJson {
     }>;
     subpackages?: AppJson['subPackages'];
     usingComponents?: Record<string, string>;
+    /** isSubpackage：Worker 代码作为分包，业务先调 wx.preDownloadSubpackage({ packageType: 'workers' }) 再创建 Worker */
     workers?: string | {
         path: string;
+        isSubpackage?: boolean;
     };
     [key: string]: any;
 }
@@ -58,6 +60,8 @@ declare class MiniProgram {
         pages: string[];
         independent?: boolean;
     }[];
+    /** Worker 代码所在目录，不带首尾的 /；没有配置 workers 时为 null */
+    workersDir(app: AppJson): string | null;
     /** 主包页面 + 分包页面（带 root 前缀） */
     allPages(app: AppJson): string[];
     /** 读取并预处理页面/组件 json，id 不带扩展名 */
@@ -73,7 +77,7 @@ declare class MiniProgram {
         components: string[];
     };
     /** 列出代码根目录下指定扩展名的文件，返回 posix 风格的相对路径 */
-    listFiles(extensions: string[], excludeDirs?: string[]): string[];
+    listFiles(extensions: string[]): string[];
     exists(relPath: string): boolean;
     readText(relPath: string): string;
     private isInIndependentSubPackage;
@@ -93,6 +97,8 @@ declare class MiniProgram {
  *   2. wcsc 的公共样式运行时 + app.wxss，与每个页面/组件的 __wxAppCode__ wxss（pageStyles）
  *   两部分在热更新时分别下发
  *   样式和模板里的 env(safe-area-inset-*) 改写成 CSS 变量，见 rewriteSafeAreaInsets
+ *
+ * Worker：workers 目录下的 JS 不进逻辑层，同样包装成 define 脚本，由 Worker 入口（server/html.ts 的 workerScript）加载
  */
 
 interface BuildResult {
@@ -100,6 +106,8 @@ interface BuildResult {
     wxConfig: Record<string, any>;
     /** 所有 JS 模块 id（如 "pages/index/index.js"），逻辑层按此顺序加载 define 脚本 */
     modules: string[];
+    /** workers 目录下的 JS 模块 id，Worker 按此顺序加载 define 脚本 */
+    workerModules: string[];
     /** 逻辑层的 $gwx 与 __wxAppCode__ json/wxml，不含 require */
     serviceTemplates: string;
     serviceBootstrap: string;
@@ -154,14 +162,15 @@ declare class AppBuilder {
  *   /__wxa__/setup.js          编译后的 setup 文件
  *   /__wxa__/appservice.html   逻辑层
  *   /__wxa__/webview/<page>.html  渲染层（路径与页面一致，wxml 里的相对资源路径因此能正确解析）
- *   /__wxa__/module/<file>.js  单个业务 JS 模块
+ *   /__wxa__/module/<file>.js  单个业务 JS 模块（含 workers 目录下的）
+ *   /__wxa__/worker.js?id=     Worker 的入口
  *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
  *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
  *   /__baselib__/*             官方基础库
  *   /__wxa__/proxy?url=        网络代理
  *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
  *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
- *   /__wxa__/api/*             真实登录（--real-login）：wx.login 的 code、手机号，只允许本机访问
+ *   /__wxa__/api/*             --devtools-login：wx.login 的 code、手机号，服务市场、插件的请求转发，只允许本机访问
  *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）
  *   其余路径                    小程序目录下的静态资源
  */
@@ -183,7 +192,12 @@ interface DevServerOptions {
     setup?: string | false;
     /** 浏览器端运行时（host.js / frame.js）所在目录，默认取构建产物 */
     runtimeDir?: string;
-    /** 使用本机微信开发者工具登录态获取真实 code 和手机号 */
+    /**
+     * 借本机微信开发者工具的登录态访问微信后台：真实的 wx.login code 和手机号、服务市场、插件。
+     * 要先登录开发者工具，会真实请求微信
+     */
+    devtoolsLogin?: boolean;
+    /** @deprecated 改名为 devtoolsLogin */
     realLogin?: boolean;
     logger?: Pick<Console, 'log' | 'warn' | 'error'>;
 }
@@ -205,8 +219,10 @@ declare class DevServer {
     private address;
     /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
     private readonly tempFiles;
-    /** 开启 --real-login 时才有 */
+    private readonly devtoolsLogin;
+    /** 开启 --devtools-login 时才有 */
     private readonly ticketSource;
+    private readonly plugins;
     constructor(options: DevServerOptions);
     get url(): string;
     start(): Promise<string>;
@@ -214,6 +230,8 @@ declare class DevServer {
     private createApp;
     /** 先编译一遍 setup：编译错误随 app-info 交给宿主显示，而不是让浏览器 import 失败 */
     private setupInfo;
+    /** 构建结果并入这次打开小程序时决定用的插件 */
+    private currentBuild;
     /** 需要构建结果的路由；构建失败时返回错误文本 */
     private withBuild;
     private runtimeDir;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
-import { D as DeviceProfile } from './setup-Cv340Lvj.js';
-export { A as ApiContext, a as ApiHandler, b as ApiResult, c as AppInfo, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition } from './setup-Cv340Lvj.js';
-export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-nKsjjEhz.js';
+import { D as DeviceProfile } from './setup-DZ5FeKay.js';
+export { A as ApiContext, a as ApiHandler, b as ApiResult, c as AppInfo, M as MockConfig, d as MockRequest, e as MockResponse, f as MockValue, N as NetworkConfig, R as RouteHandler, S as SetupApi, g as SetupConfig, h as SetupContext, i as SetupDefinition } from './setup-DZ5FeKay.js';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-BLozOgCt.js';
 
 /**
  * 小程序项目结构解析
@@ -32,8 +32,10 @@ interface AppJson {
     }>;
     subpackages?: AppJson['subPackages'];
     usingComponents?: Record<string, string>;
+    /** isSubpackage：Worker 代码作为分包，业务先调 wx.preDownloadSubpackage({ packageType: 'workers' }) 再创建 Worker */
     workers?: string | {
         path: string;
+        isSubpackage?: boolean;
     };
     [key: string]: any;
 }
@@ -58,6 +60,8 @@ declare class MiniProgram {
         pages: string[];
         independent?: boolean;
     }[];
+    /** Worker 代码所在目录，不带首尾的 /；没有配置 workers 时为 null */
+    workersDir(app: AppJson): string | null;
     /** 主包页面 + 分包页面（带 root 前缀） */
     allPages(app: AppJson): string[];
     /** 读取并预处理页面/组件 json，id 不带扩展名 */
@@ -73,7 +77,7 @@ declare class MiniProgram {
         components: string[];
     };
     /** 列出代码根目录下指定扩展名的文件，返回 posix 风格的相对路径 */
-    listFiles(extensions: string[], excludeDirs?: string[]): string[];
+    listFiles(extensions: string[]): string[];
     exists(relPath: string): boolean;
     readText(relPath: string): string;
     private isInIndependentSubPackage;
@@ -93,6 +97,8 @@ declare class MiniProgram {
  *   2. wcsc 的公共样式运行时 + app.wxss，与每个页面/组件的 __wxAppCode__ wxss（pageStyles）
  *   两部分在热更新时分别下发
  *   样式和模板里的 env(safe-area-inset-*) 改写成 CSS 变量，见 rewriteSafeAreaInsets
+ *
+ * Worker：workers 目录下的 JS 不进逻辑层，同样包装成 define 脚本，由 Worker 入口（server/html.ts 的 workerScript）加载
  */
 
 interface BuildResult {
@@ -100,6 +106,8 @@ interface BuildResult {
     wxConfig: Record<string, any>;
     /** 所有 JS 模块 id（如 "pages/index/index.js"），逻辑层按此顺序加载 define 脚本 */
     modules: string[];
+    /** workers 目录下的 JS 模块 id，Worker 按此顺序加载 define 脚本 */
+    workerModules: string[];
     /** 逻辑层的 $gwx 与 __wxAppCode__ json/wxml，不含 require */
     serviceTemplates: string;
     serviceBootstrap: string;
@@ -154,14 +162,15 @@ declare class AppBuilder {
  *   /__wxa__/setup.js          编译后的 setup 文件
  *   /__wxa__/appservice.html   逻辑层
  *   /__wxa__/webview/<page>.html  渲染层（路径与页面一致，wxml 里的相对资源路径因此能正确解析）
- *   /__wxa__/module/<file>.js  单个业务 JS 模块
+ *   /__wxa__/module/<file>.js  单个业务 JS 模块（含 workers 目录下的）
+ *   /__wxa__/worker.js?id=     Worker 的入口
  *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
  *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
  *   /__baselib__/*             官方基础库
  *   /__wxa__/proxy?url=        网络代理
  *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
  *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
- *   /__wxa__/api/*             真实登录（--real-login）：wx.login 的 code、手机号，只允许本机访问
+ *   /__wxa__/api/*             --devtools-login：wx.login 的 code、手机号，服务市场、插件的请求转发，只允许本机访问
  *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）
  *   其余路径                    小程序目录下的静态资源
  */
@@ -183,7 +192,12 @@ interface DevServerOptions {
     setup?: string | false;
     /** 浏览器端运行时（host.js / frame.js）所在目录，默认取构建产物 */
     runtimeDir?: string;
-    /** 使用本机微信开发者工具登录态获取真实 code 和手机号 */
+    /**
+     * 借本机微信开发者工具的登录态访问微信后台：真实的 wx.login code 和手机号、服务市场、插件。
+     * 要先登录开发者工具，会真实请求微信
+     */
+    devtoolsLogin?: boolean;
+    /** @deprecated 改名为 devtoolsLogin */
     realLogin?: boolean;
     logger?: Pick<Console, 'log' | 'warn' | 'error'>;
 }
@@ -205,8 +219,10 @@ declare class DevServer {
     private address;
     /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
     private readonly tempFiles;
-    /** 开启 --real-login 时才有 */
+    private readonly devtoolsLogin;
+    /** 开启 --devtools-login 时才有 */
     private readonly ticketSource;
+    private readonly plugins;
     constructor(options: DevServerOptions);
     get url(): string;
     start(): Promise<string>;
@@ -214,6 +230,8 @@ declare class DevServer {
     private createApp;
     /** 先编译一遍 setup：编译错误随 app-info 交给宿主显示，而不是让浏览器 import 失败 */
     private setupInfo;
+    /** 构建结果并入这次打开小程序时决定用的插件 */
+    private currentBuild;
     /** 需要构建结果的路由；构建失败时返回错误文本 */
     private withBuild;
     private runtimeDir;