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

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
-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';
+import { D as DeviceProfile, F as ForwardConsole } from './setup-Bac8XdhR.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-Bac8XdhR.mjs';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-DHuEW5Cl.mjs';
 
 /**
  * 小程序项目结构解析
@@ -64,7 +64,11 @@ declare class MiniProgram {
     workersDir(app: AppJson): string | null;
     /** 主包页面 + 分包页面（带 root 前缀） */
     allPages(app: AppJson): string[];
-    /** 读取并预处理页面/组件 json，id 不带扩展名 */
+    /**
+     * 读取并预处理页面/组件 json，id 不带扩展名。
+     * 基础库运行时只把组件引用和当前路径拼在一起，不查找 miniprogram_npm、不补 /index（开发者工具编译时已解析好），
+     * 所以能解析到的引用都换成组件的绝对路径
+     */
     readUnitJson(id: string, app: AppJson): UnitJson;
     /**
      * 解析组件引用到组件路径（不带扩展名）；插件组件或找不到时返回 null。
@@ -167,18 +171,22 @@ declare class AppBuilder {
  *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
  *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
  *   /__baselib__/*             官方基础库
- *   /__wxa__/proxy?url=        网络代理
- *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
+ *   /__wxa__/proxy/<协议>/<域名><路径>  网络代理，如 /__wxa__/proxy/https/api.example.com/a?b=1
+ *   /__wxa__/mock/<协议>/<域名><路径>   被拦截的请求在 Network 面板里的地址，由 Service Worker（runtime/sw.js）返回响应
+ *   /__wxa__/fs/<会话>          文件系统接口（FileSystemManager），每个浏览器会话一份文件，会话标识见 runtime/fileSession.ts
+ *   /__wxa__/tmp/<会话>         临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
+ *   /__wxa__/usr/<会话>/<路径>   用户目录（USER_DATA_PATH）下的文件，image 等组件和 uploadFile 按地址读取
  *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
  *   /__wxa__/api/*             --devtools-login：wx.login 的 code、手机号，服务市场、插件的请求转发，只允许本机访问
- *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）
+ *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）；开启 forwardConsole 时浏览器从这里发来报错
  *   其余路径                    小程序目录下的静态资源
  */
 
 interface DevServerOptions {
     projectPath: string;
-    /** 默认 3000，传 0 使用随机端口 */
+    /** 不传时从 3000 起找空闲的端口；指定的端口被占用时启动失败；传 0 使用随机端口 */
     port?: number;
+    /** 监听地址，默认 localhost；0.0.0.0 或 :: 时局域网也能访问 */
     host?: string;
     /** 指定基础库版本，默认使用本机已安装的最新兼容版本 */
     baseLibVersion?: string;
@@ -199,6 +207,11 @@ interface DevServerOptions {
     devtoolsLogin?: boolean;
     /** @deprecated 改名为 devtoolsLogin */
     realLogin?: boolean;
+    /**
+     * 把浏览器里的报错打印到终端：'errors' 转发运行时错误和未实现 API 的提醒，'all' 再加上 console.warn / console.error。
+     * 默认不转发；命令行默认 'errors'，检测到编程助手时 'all'
+     */
+    forwardConsole?: ForwardConsole;
     logger?: Pick<Console, 'log' | 'warn' | 'error'>;
 }
 declare const DEFAULT_DEVICE: DeviceProfile;
@@ -217,14 +230,18 @@ declare class DevServer {
     private sockets;
     private watcher;
     private address;
+    private lanAccess;
     /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
-    private readonly tempFiles;
+    private readonly fileSessions;
     private readonly devtoolsLogin;
     /** 开启 --devtools-login 时才有 */
     private readonly ticketSource;
     private readonly plugins;
     constructor(options: DevServerOptions);
+    /** 本机访问的地址 */
     get url(): string;
+    /** 局域网里其他设备访问的地址，每块网卡一个；只监听本机时为空 */
+    get networkUrls(): string[];
     start(): Promise<string>;
     close(): Promise<void>;
     private createApp;
@@ -254,4 +271,4 @@ interface WxConfigInput {
 }
 declare function createWxConfig(input: WxConfigInput): Record<string, any>;
 
-export { AppBuilder, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerOptions, DeviceProfile, MiniProgram, type UnitJson, createWxConfig };
+export { AppBuilder, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerOptions, DeviceProfile, ForwardConsole, MiniProgram, type UnitJson, createWxConfig };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
-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';
+import { D as DeviceProfile, F as ForwardConsole } from './setup-Bac8XdhR.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-Bac8XdhR.js';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-BOZSXSnV.js';
 
 /**
  * 小程序项目结构解析
@@ -64,7 +64,11 @@ declare class MiniProgram {
     workersDir(app: AppJson): string | null;
     /** 主包页面 + 分包页面（带 root 前缀） */
     allPages(app: AppJson): string[];
-    /** 读取并预处理页面/组件 json，id 不带扩展名 */
+    /**
+     * 读取并预处理页面/组件 json，id 不带扩展名。
+     * 基础库运行时只把组件引用和当前路径拼在一起，不查找 miniprogram_npm、不补 /index（开发者工具编译时已解析好），
+     * 所以能解析到的引用都换成组件的绝对路径
+     */
     readUnitJson(id: string, app: AppJson): UnitJson;
     /**
      * 解析组件引用到组件路径（不带扩展名）；插件组件或找不到时返回 null。
@@ -167,18 +171,22 @@ declare class AppBuilder {
  *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
  *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
  *   /__baselib__/*             官方基础库
- *   /__wxa__/proxy?url=        网络代理
- *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
+ *   /__wxa__/proxy/<协议>/<域名><路径>  网络代理，如 /__wxa__/proxy/https/api.example.com/a?b=1
+ *   /__wxa__/mock/<协议>/<域名><路径>   被拦截的请求在 Network 面板里的地址，由 Service Worker（runtime/sw.js）返回响应
+ *   /__wxa__/fs/<会话>          文件系统接口（FileSystemManager），每个浏览器会话一份文件，会话标识见 runtime/fileSession.ts
+ *   /__wxa__/tmp/<会话>         临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
+ *   /__wxa__/usr/<会话>/<路径>   用户目录（USER_DATA_PATH）下的文件，image 等组件和 uploadFile 按地址读取
  *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
  *   /__wxa__/api/*             --devtools-login：wx.login 的 code、手机号，服务市场、插件的请求转发，只允许本机访问
- *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）
+ *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）；开启 forwardConsole 时浏览器从这里发来报错
  *   其余路径                    小程序目录下的静态资源
  */
 
 interface DevServerOptions {
     projectPath: string;
-    /** 默认 3000，传 0 使用随机端口 */
+    /** 不传时从 3000 起找空闲的端口；指定的端口被占用时启动失败；传 0 使用随机端口 */
     port?: number;
+    /** 监听地址，默认 localhost；0.0.0.0 或 :: 时局域网也能访问 */
     host?: string;
     /** 指定基础库版本，默认使用本机已安装的最新兼容版本 */
     baseLibVersion?: string;
@@ -199,6 +207,11 @@ interface DevServerOptions {
     devtoolsLogin?: boolean;
     /** @deprecated 改名为 devtoolsLogin */
     realLogin?: boolean;
+    /**
+     * 把浏览器里的报错打印到终端：'errors' 转发运行时错误和未实现 API 的提醒，'all' 再加上 console.warn / console.error。
+     * 默认不转发；命令行默认 'errors'，检测到编程助手时 'all'
+     */
+    forwardConsole?: ForwardConsole;
     logger?: Pick<Console, 'log' | 'warn' | 'error'>;
 }
 declare const DEFAULT_DEVICE: DeviceProfile;
@@ -217,14 +230,18 @@ declare class DevServer {
     private sockets;
     private watcher;
     private address;
+    private lanAccess;
     /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
-    private readonly tempFiles;
+    private readonly fileSessions;
     private readonly devtoolsLogin;
     /** 开启 --devtools-login 时才有 */
     private readonly ticketSource;
     private readonly plugins;
     constructor(options: DevServerOptions);
+    /** 本机访问的地址 */
     get url(): string;
+    /** 局域网里其他设备访问的地址，每块网卡一个；只监听本机时为空 */
+    get networkUrls(): string[];
     start(): Promise<string>;
     close(): Promise<void>;
     private createApp;
@@ -254,4 +271,4 @@ interface WxConfigInput {
 }
 declare function createWxConfig(input: WxConfigInput): Record<string, any>;
 
-export { AppBuilder, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerOptions, DeviceProfile, MiniProgram, type UnitJson, createWxConfig };
+export { AppBuilder, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerOptions, DeviceProfile, ForwardConsole, MiniProgram, type UnitJson, createWxConfig };