@open-wxa/wxa-runner-core 0.10.0 → 0.11.0

package/dist/index.d.mts

@@ -1,8 +1,9 @@
-import { IncomingMessage, ServerResponse } from 'http';
+import http, { IncomingMessage, ServerResponse } from 'http';
 import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
-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';
+import { D as DeviceProfile, F as ForwardConsole } from './setup-DhDDVlit.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-DhDDVlit.mjs';
+import { Request, Response } from 'express';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-BbK_1vhj.mjs';
 
 /**
  * 样式预处理：project.config.json 的 setting.useCompilerPlugins 开启 less / sass 时，
@@ -201,6 +202,15 @@ declare class AppBuilder {
     private createServiceBootstrap;
 }
 
+/**
+ * 小程序页面与代码的路由：逻辑层、子上下文、渲染层的 HTML，业务模块、模板、样式和插件代码
+ *
+ * 开发服务器和查看器（wxapack）的 Service Worker 共用这一份，两边生成的页面才不会走样，所以不依赖 Node。
+ * app-info、setup、静态资源、文件接口等和运行环境有关的路由各自实现。
+ */
+
+declare const DEFAULT_DEVICE: DeviceProfile;
+
 /**
  * 开发服务器扩展：检查器这类开发工具把要用的扩展点打包成一个扩展，
  * 由 DevServer 的 extensions 选项或命令行的 --extension 加载。runner 只认这个约定，不认识具体的工具。
@@ -325,7 +335,7 @@ interface DevServerOptions {
     extensions?: DevServerExtension[];
     logger?: Pick<Console, 'log' | 'warn' | 'error'>;
 }
-declare const DEFAULT_DEVICE: DeviceProfile;
+
 declare class DevServer {
     private readonly options;
     readonly project: MiniProgram;
@@ -366,6 +376,7 @@ declare class DevServer {
     /** 构建结果并入这次打开小程序时决定用的插件 */
     private currentBuild;
     /** 需要构建结果的路由；构建失败时返回错误文本 */
+    private appSource;
     private withBuild;
     private runtimeDir;
     /** 只在监听文件变化时打开基础库的热更新开关，跑测试（watch: false）时运行环境与真机一致 */
@@ -373,6 +384,35 @@ declare class DevServer {
     private startWatching;
     private broadcast;
 }
+/** 监听所有地址时，本机访问用的地址：0.0.0.0 只监听 IPv4，localhost 可能解析到 IPv6 的 ::1 */
+declare const LOCAL_HOST_OF_ANY_ADDRESS: Map<string, string>;
+/** 开始监听，返回实际的端口。没指定端口时从 3000 起往后找空闲的，换了端口在终端提示 */
+declare function listen(server: http.Server, port: number | undefined, host: string, logger: Pick<Console, 'warn'>): Promise<number>;
+/**
+ * 浏览器端运行时（host.js、frame.js 等）所在目录：给了 explicit 就用它，否则找本包的构建产物
+ * @throws 都没有 host.js 时（源码运行但还没 pnpm build）
+ */
+declare function findRuntimeDir(explicit?: string): string;
+
+/** 项目目录（project.config.json 所在目录）下约定名称的 setup 文件 */
+declare function findSetupFile(projectPath: string): string | null;
+/**
+ * 把 setup 文件连同它 import 的文件打成一个浏览器 ES 模块
+ *
+ * 用户的小程序项目里通常没装本包，对它的引用直接换成运行时自带的实现。
+ *
+ * @throws 语法错误、import 找不到等编译错误，消息里带相对 setup 文件目录的位置
+ */
+declare function bundleSetup(file: string): Promise<string>;
+
+/**
+ * 开发服务器和本机查看器的网络代理：把 express 的请求转成 Fetch 请求交给 proxyFetch.ts，再把响应流式写回
+ */
+
+/**
+ * 用 app.use 挂载，保留未解码的 originalUrl：Express 通配路由会解码 %2F，甚至拒绝单独的 %。
+ */
+declare function handleProxy(req: Request, res: Response): Promise<void>;
 
 /**
  * 生成基础库读取的 __wxConfig，字段与开发者工具保持一致
@@ -387,4 +427,4 @@ interface WxConfigInput {
 }
 declare function createWxConfig(input: WxConfigInput): Record<string, any>;
 
-export { AppBuilder, type AppBuilderOptions, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerExtension, type DevServerMiddleware, type DevServerOptions, DeviceProfile, type ExtensionContext, type ExtensionEntry, type ExtensionSetup, ForwardConsole, MiniProgram, type UnitJson, type WebviewScript, createWxConfig };
+export { AppBuilder, type AppBuilderOptions, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerExtension, type DevServerMiddleware, type DevServerOptions, DeviceProfile, type ExtensionContext, type ExtensionEntry, type ExtensionSetup, ForwardConsole, LOCAL_HOST_OF_ANY_ADDRESS, MiniProgram, type UnitJson, type WebviewScript, bundleSetup, createWxConfig, findRuntimeDir, findSetupFile, handleProxy, listen };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { IncomingMessage, ServerResponse } from 'http';
+import http, { IncomingMessage, ServerResponse } from 'http';
 import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
-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';
+import { D as DeviceProfile, F as ForwardConsole } from './setup-DhDDVlit.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-DhDDVlit.js';
+import { Request, Response } from 'express';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-DbTnccYV.js';
 
 /**
  * 样式预处理：project.config.json 的 setting.useCompilerPlugins 开启 less / sass 时，
@@ -201,6 +202,15 @@ declare class AppBuilder {
     private createServiceBootstrap;
 }
 
+/**
+ * 小程序页面与代码的路由：逻辑层、子上下文、渲染层的 HTML，业务模块、模板、样式和插件代码
+ *
+ * 开发服务器和查看器（wxapack）的 Service Worker 共用这一份，两边生成的页面才不会走样，所以不依赖 Node。
+ * app-info、setup、静态资源、文件接口等和运行环境有关的路由各自实现。
+ */
+
+declare const DEFAULT_DEVICE: DeviceProfile;
+
 /**
  * 开发服务器扩展：检查器这类开发工具把要用的扩展点打包成一个扩展，
  * 由 DevServer 的 extensions 选项或命令行的 --extension 加载。runner 只认这个约定，不认识具体的工具。
@@ -325,7 +335,7 @@ interface DevServerOptions {
     extensions?: DevServerExtension[];
     logger?: Pick<Console, 'log' | 'warn' | 'error'>;
 }
-declare const DEFAULT_DEVICE: DeviceProfile;
+
 declare class DevServer {
     private readonly options;
     readonly project: MiniProgram;
@@ -366,6 +376,7 @@ declare class DevServer {
     /** 构建结果并入这次打开小程序时决定用的插件 */
     private currentBuild;
     /** 需要构建结果的路由；构建失败时返回错误文本 */
+    private appSource;
     private withBuild;
     private runtimeDir;
     /** 只在监听文件变化时打开基础库的热更新开关，跑测试（watch: false）时运行环境与真机一致 */
@@ -373,6 +384,35 @@ declare class DevServer {
     private startWatching;
     private broadcast;
 }
+/** 监听所有地址时，本机访问用的地址：0.0.0.0 只监听 IPv4，localhost 可能解析到 IPv6 的 ::1 */
+declare const LOCAL_HOST_OF_ANY_ADDRESS: Map<string, string>;
+/** 开始监听，返回实际的端口。没指定端口时从 3000 起往后找空闲的，换了端口在终端提示 */
+declare function listen(server: http.Server, port: number | undefined, host: string, logger: Pick<Console, 'warn'>): Promise<number>;
+/**
+ * 浏览器端运行时（host.js、frame.js 等）所在目录：给了 explicit 就用它，否则找本包的构建产物
+ * @throws 都没有 host.js 时（源码运行但还没 pnpm build）
+ */
+declare function findRuntimeDir(explicit?: string): string;
+
+/** 项目目录（project.config.json 所在目录）下约定名称的 setup 文件 */
+declare function findSetupFile(projectPath: string): string | null;
+/**
+ * 把 setup 文件连同它 import 的文件打成一个浏览器 ES 模块
+ *
+ * 用户的小程序项目里通常没装本包，对它的引用直接换成运行时自带的实现。
+ *
+ * @throws 语法错误、import 找不到等编译错误，消息里带相对 setup 文件目录的位置
+ */
+declare function bundleSetup(file: string): Promise<string>;
+
+/**
+ * 开发服务器和本机查看器的网络代理：把 express 的请求转成 Fetch 请求交给 proxyFetch.ts，再把响应流式写回
+ */
+
+/**
+ * 用 app.use 挂载，保留未解码的 originalUrl：Express 通配路由会解码 %2F，甚至拒绝单独的 %。
+ */
+declare function handleProxy(req: Request, res: Response): Promise<void>;
 
 /**
  * 生成基础库读取的 __wxConfig，字段与开发者工具保持一致
@@ -387,4 +427,4 @@ interface WxConfigInput {
 }
 declare function createWxConfig(input: WxConfigInput): Record<string, any>;
 
-export { AppBuilder, type AppBuilderOptions, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerExtension, type DevServerMiddleware, type DevServerOptions, DeviceProfile, type ExtensionContext, type ExtensionEntry, type ExtensionSetup, ForwardConsole, MiniProgram, type UnitJson, type WebviewScript, createWxConfig };
+export { AppBuilder, type AppBuilderOptions, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerExtension, type DevServerMiddleware, type DevServerOptions, DeviceProfile, type ExtensionContext, type ExtensionEntry, type ExtensionSetup, ForwardConsole, LOCAL_HOST_OF_ANY_ADDRESS, MiniProgram, type UnitJson, type WebviewScript, bundleSetup, createWxConfig, findRuntimeDir, findSetupFile, handleProxy, listen };