@open-wxa/wxa-runner-core 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 open-wxa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @open-wxa/wxa-runner-core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[wxa-runner](https://github.com/open-wxa/wxa-runner) 的开发服务器和浏览器端运行时。
+
+一般不用直接安装：命令行用 [`wxa-runner`](https://www.npmjs.com/package/wxa-runner)，在 Playwright 中测试用
+[`@open-wxa/wxa-runner-playwright`](https://www.npmjs.com/package/@open-wxa/wxa-runner-playwright)。以下情况把它加为开发依赖：
+
+- setup 文件要类型提示：`import { defineSetup } from '@open-wxa/wxa-runner-core/setup'`，见
+  [docs/setup.md](https://github.com/open-wxa/wxa-runner/blob/main/docs/setup.md)
+- 不用 fixture、直接使用测试 API：`/// <reference types="@open-wxa/wxa-runner-core/test-api" />` 为
+  `window.__wxa_test_api__` 提供类型，见 [docs/testing.md](https://github.com/open-wxa/wxa-runner/blob/main/docs/testing.md#直接使用测试-api)
+- 在 Node 里启动开发服务器：
+
+```ts
+import { DevServer } from '@open-wxa/wxa-runner-core';
+
+const server = new DevServer({ projectPath: './dist/dev/mp-weixin', port: 3000, watch: false });
+const url = await server.start();
+// …
+await server.close();
+```

package/dist/chunk-22T3D5KS.mjs

@@ -0,0 +1,11 @@
+// ../../node_modules/.pnpm/tsup@8.5.1_postcss@8.5.30_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js
+import path from "path";
+import { fileURLToPath } from "url";
+var getFilename = () => fileURLToPath(import.meta.url);
+var getDirname = () => path.dirname(getFilename());
+var __dirname = /* @__PURE__ */ getDirname();
+
+export {
+  __dirname
+};
+//# sourceMappingURL=chunk-22T3D5KS.mjs.map

package/dist/chunk-22T3D5KS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../node_modules/.pnpm/tsup@8.5.1_postcss@8.5.30_typescript@5.9.3/node_modules/tsup/assets/esm_shims.js"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n"],"mappings":";AACA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAE9B,IAAM,cAAc,MAAM,cAAc,YAAY,GAAG;AACvD,IAAM,aAAa,MAAM,KAAK,QAAQ,YAAY,CAAC;AAE5C,IAAM,YAA4B,2BAAW;","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,236 @@
+import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
+import { D as DeviceProfile } from './setup-COzZ6vzS.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-COzZ6vzS.mjs';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-D5o7hK-Z.mjs';
+
+/**
+ * 小程序项目结构解析
+ *
+ * 负责读取 app.json / 页面与组件 json，并按开发者工具的规则做预处理：
+ * - app.json 的全局 usingComponents 展开到每个页面和组件（miniprogram_npm 内除外）
+ * - 每个页面/组件 json 都保证有 usingComponents 字段
+ */
+interface AppJson {
+    pages: string[];
+    entryPagePath?: string;
+    window?: Record<string, any>;
+    tabBar?: {
+        list: Array<{
+            pagePath: string;
+            text?: string;
+            iconPath?: string;
+            selectedIconPath?: string;
+        }>;
+        [key: string]: any;
+    };
+    subPackages?: Array<{
+        root: string;
+        pages: string[];
+        independent?: boolean;
+        [key: string]: any;
+    }>;
+    subpackages?: AppJson['subPackages'];
+    usingComponents?: Record<string, string>;
+    workers?: string | {
+        path: string;
+    };
+    [key: string]: any;
+}
+interface UnitJson {
+    usingComponents: Record<string, string>;
+    componentGenerics?: Record<string, boolean | {
+        default?: string;
+    }>;
+    component?: boolean;
+    [key: string]: any;
+}
+declare class MiniProgram {
+    readonly projectPath: string;
+    /** 小程序代码根目录（已考虑 project.config.json 的 miniprogramRoot） */
+    readonly root: string;
+    readonly appid: string;
+    constructor(projectPath: string);
+    readAppJson(): AppJson;
+    subPackages(app: AppJson): {
+        [key: string]: any;
+        root: string;
+        pages: string[];
+        independent?: boolean;
+    }[];
+    /** 主包页面 + 分包页面（带 root 前缀） */
+    allPages(app: AppJson): string[];
+    /** 读取并预处理页面/组件 json，id 不带扩展名 */
+    readUnitJson(id: string, app: AppJson): UnitJson;
+    /**
+     * 解析组件引用到组件路径（不带扩展名）；插件组件或找不到时返回 null。
+     * 规则：/ 开头为根目录绝对路径；否则先按相对路径找，再沿目录向上查找 miniprogram_npm。
+     */
+    resolveComponent(fromId: string, ref: string): string | null;
+    /** 收集所有页面以及它们（递归）引用到的自定义组件 */
+    collectUnits(app: AppJson): {
+        pages: string[];
+        components: string[];
+    };
+    /** 列出代码根目录下指定扩展名的文件，返回 posix 风格的相对路径 */
+    listFiles(extensions: string[], excludeDirs?: string[]): string[];
+    exists(relPath: string): boolean;
+    readText(relPath: string): string;
+    private isInIndependentSubPackage;
+}
+
+/**
+ * 把小程序项目构建成官方基础库能直接加载的形式
+ *
+ * 逻辑层（appservice）:
+ *   1. 裁剪版 $gwx（wcc -xc），基础库用它了解组件的节点结构
+ *   2. 每个 JS 文件单独一个 define("x.js", fn) 脚本（便于在 DevTools 里按原文件调试）
+ *   3. bootstrap：注册 __wxAppCode__ 的 json/wxml（serviceTemplates，热更新时单独下发），
+ *      require("app.js")，再依次 require 组件和页面
+ *
+ * 渲染层（page-frame）:
+ *   1. 完整版 $gwx（wcc -cc）与每个页面/组件的 __wxAppCode__ json / wxml（pageTemplates）
+ *   2. wcsc 的公共样式运行时 + app.wxss，与每个页面/组件的 __wxAppCode__ wxss（pageStyles）
+ *   两部分在热更新时分别下发
+ *   样式和模板里的 env(safe-area-inset-*) 改写成 CSS 变量，见 rewriteSafeAreaInsets
+ */
+
+interface BuildResult {
+    version: number;
+    wxConfig: Record<string, any>;
+    /** 所有 JS 模块 id（如 "pages/index/index.js"），逻辑层按此顺序加载 define 脚本 */
+    modules: string[];
+    /** 逻辑层的 $gwx 与 __wxAppCode__ json/wxml，不含 require */
+    serviceTemplates: string;
+    serviceBootstrap: string;
+    pageFrame: string;
+    /** 渲染层的 $gwx 与 __wxAppCode__ json/wxml，不含样式（热更新时单独下发） */
+    pageTemplates: string;
+    /** 渲染层的样式：公共样式立即注入，页面和组件的样式注册到 __wxAppCode__（热更新时单独下发） */
+    pageStyles: string;
+    pages: string[];
+    components: string[];
+    durationMs: number;
+}
+declare class AppBuilder {
+    readonly project: MiniProgram;
+    private version;
+    /** invalidate 标记过的变化次数；每次构建记下开始时覆盖到第几次 */
+    private changes;
+    private pending;
+    private last;
+    private dirty;
+    private wxmlCache;
+    private wxssCache;
+    constructor(project: MiniProgram);
+    /** 根据变化的文件标记需要重新构建的部分；返回 true 表示需要刷新 */
+    invalidate(changedFiles?: string[]): boolean;
+    /**
+     * 返回包含调用前所有变化的构建结果。并发调用共享同一次构建；
+     * 进行中的构建开始得比最近一次变化早时（可能已读到旧文件），等它结束后再构建一次
+     */
+    build(): Promise<BuildResult>;
+    /**
+     * 单个 JS 模块的 define 包装
+     *
+     * 包装头和代码第一行写在同一行，行号与源文件一致。使用 import/export 的文件
+     * 先转换为 CommonJS（对应开发者工具的「ES6 转 ES5」），并内联 source map。
+     */
+    getModuleScript(id: string): string;
+    private doBuild;
+    private compileTemplates;
+    /** 与开发者工具一致，项目里的 wxss 全部交给 wcsc：被 @import 的文件（如 uni-app 的 common/main.wxss）也要在列表里 */
+    private compileStyles;
+    /** $gwx 加上各页面、组件的 json / wxml 注册；逻辑层用裁剪版 $gwx，渲染层用完整版 */
+    private createTemplates;
+    private createServiceBootstrap;
+}
+
+/**
+ * 开发服务器
+ *
+ *   /                          宿主页面
+ *   /__wxa__/app-info.json     构建信息（__wxConfig、页面列表、设备参数、setup）
+ *   /__wxa__/setup.js          编译后的 setup 文件
+ *   /__wxa__/appservice.html   逻辑层
+ *   /__wxa__/webview/<page>.html  渲染层（路径与页面一致，wxml 里的相对资源路径因此能正确解析）
+ *   /__wxa__/module/<file>.js  单个业务 JS 模块
+ *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
+ *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
+ *   /__baselib__/*             官方基础库
+ *   /__wxa__/proxy?url=        网络代理
+ *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址
+ *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
+ *   /__wxa__/api/*             真实登录（--real-login）：wx.login 的 code、手机号，只允许本机访问
+ *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）
+ *   其余路径                    小程序目录下的静态资源
+ */
+
+interface DevServerOptions {
+    projectPath: string;
+    /** 默认 3000，传 0 使用随机端口 */
+    port?: number;
+    host?: string;
+    /** 指定基础库版本，默认使用本机已安装的最新兼容版本 */
+    baseLibVersion?: string;
+    baseLibCacheDir?: string;
+    watch?: boolean;
+    device?: Partial<DeviceProfile>;
+    /**
+     * 小程序启动前执行的 setup 文件；默认使用项目目录下的 wxa.setup.ts / .js / .mjs，传 false 不使用
+     * 环境变量在构造时读取，只暴露 WXA_ 前缀的变量
+     */
+    setup?: string | false;
+    /** 浏览器端运行时（host.js / frame.js）所在目录，默认取构建产物 */
+    runtimeDir?: string;
+    /** 使用本机微信开发者工具登录态获取真实 code 和手机号 */
+    realLogin?: boolean;
+    logger?: Pick<Console, 'log' | 'warn' | 'error'>;
+}
+declare const DEFAULT_DEVICE: DeviceProfile;
+declare class DevServer {
+    private readonly options;
+    readonly project: MiniProgram;
+    readonly builder: AppBuilder;
+    readonly baseLib: ResolvedBaseLib;
+    /** 生效的 setup 文件绝对路径，没有时为 null */
+    readonly setupFile: string | null;
+    private readonly setupEnv;
+    private readonly device;
+    private readonly logger;
+    private readonly app;
+    private server;
+    private sockets;
+    private watcher;
+    private address;
+    /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
+    private readonly tempFiles;
+    constructor(options: DevServerOptions);
+    get url(): string;
+    start(): Promise<string>;
+    close(): Promise<void>;
+    private createApp;
+    /** 先编译一遍 setup：编译错误随 app-info 交给宿主显示，而不是让浏览器 import 失败 */
+    private setupInfo;
+    /** 需要构建结果的路由；构建失败时返回错误文本 */
+    private withBuild;
+    private runtimeDir;
+    /** 只在监听文件变化时打开基础库的热更新开关，跑测试（watch: false）时运行环境与真机一致 */
+    private get hotEnabled();
+    private startWatching;
+    private broadcast;
+}
+
+/**
+ * 生成基础库读取的 __wxConfig，字段与开发者工具保持一致
+ */
+
+interface WxConfigInput {
+    app: AppJson;
+    pages: string[];
+    unitJson: Map<string, UnitJson>;
+    appid: string;
+    subPackages: NonNullable<AppJson['subPackages']>;
+}
+declare function createWxConfig(input: WxConfigInput): Record<string, any>;
+
+export { AppBuilder, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerOptions, DeviceProfile, MiniProgram, type UnitJson, createWxConfig };

package/dist/index.d.ts

@@ -0,0 +1,236 @@
+import { ResolvedBaseLib } from '@open-wxa/wxa-runner-extractor';
+import { D as DeviceProfile } from './setup-COzZ6vzS.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-COzZ6vzS.js';
+export { F as FrameError, P as PageSnapshot, R as RecordedRequest, W as WxaTestApi } from './testApi-BTPLQvFs.js';
+
+/**
+ * 小程序项目结构解析
+ *
+ * 负责读取 app.json / 页面与组件 json，并按开发者工具的规则做预处理：
+ * - app.json 的全局 usingComponents 展开到每个页面和组件（miniprogram_npm 内除外）
+ * - 每个页面/组件 json 都保证有 usingComponents 字段
+ */
+interface AppJson {
+    pages: string[];
+    entryPagePath?: string;
+    window?: Record<string, any>;
+    tabBar?: {
+        list: Array<{
+            pagePath: string;
+            text?: string;
+            iconPath?: string;
+            selectedIconPath?: string;
+        }>;
+        [key: string]: any;
+    };
+    subPackages?: Array<{
+        root: string;
+        pages: string[];
+        independent?: boolean;
+        [key: string]: any;
+    }>;
+    subpackages?: AppJson['subPackages'];
+    usingComponents?: Record<string, string>;
+    workers?: string | {
+        path: string;
+    };
+    [key: string]: any;
+}
+interface UnitJson {
+    usingComponents: Record<string, string>;
+    componentGenerics?: Record<string, boolean | {
+        default?: string;
+    }>;
+    component?: boolean;
+    [key: string]: any;
+}
+declare class MiniProgram {
+    readonly projectPath: string;
+    /** 小程序代码根目录（已考虑 project.config.json 的 miniprogramRoot） */
+    readonly root: string;
+    readonly appid: string;
+    constructor(projectPath: string);
+    readAppJson(): AppJson;
+    subPackages(app: AppJson): {
+        [key: string]: any;
+        root: string;
+        pages: string[];
+        independent?: boolean;
+    }[];
+    /** 主包页面 + 分包页面（带 root 前缀） */
+    allPages(app: AppJson): string[];
+    /** 读取并预处理页面/组件 json，id 不带扩展名 */
+    readUnitJson(id: string, app: AppJson): UnitJson;
+    /**
+     * 解析组件引用到组件路径（不带扩展名）；插件组件或找不到时返回 null。
+     * 规则：/ 开头为根目录绝对路径；否则先按相对路径找，再沿目录向上查找 miniprogram_npm。
+     */
+    resolveComponent(fromId: string, ref: string): string | null;
+    /** 收集所有页面以及它们（递归）引用到的自定义组件 */
+    collectUnits(app: AppJson): {
+        pages: string[];
+        components: string[];
+    };
+    /** 列出代码根目录下指定扩展名的文件，返回 posix 风格的相对路径 */
+    listFiles(extensions: string[], excludeDirs?: string[]): string[];
+    exists(relPath: string): boolean;
+    readText(relPath: string): string;
+    private isInIndependentSubPackage;
+}
+
+/**
+ * 把小程序项目构建成官方基础库能直接加载的形式
+ *
+ * 逻辑层（appservice）:
+ *   1. 裁剪版 $gwx（wcc -xc），基础库用它了解组件的节点结构
+ *   2. 每个 JS 文件单独一个 define("x.js", fn) 脚本（便于在 DevTools 里按原文件调试）
+ *   3. bootstrap：注册 __wxAppCode__ 的 json/wxml（serviceTemplates，热更新时单独下发），
+ *      require("app.js")，再依次 require 组件和页面
+ *
+ * 渲染层（page-frame）:
+ *   1. 完整版 $gwx（wcc -cc）与每个页面/组件的 __wxAppCode__ json / wxml（pageTemplates）
+ *   2. wcsc 的公共样式运行时 + app.wxss，与每个页面/组件的 __wxAppCode__ wxss（pageStyles）
+ *   两部分在热更新时分别下发
+ *   样式和模板里的 env(safe-area-inset-*) 改写成 CSS 变量，见 rewriteSafeAreaInsets
+ */
+
+interface BuildResult {
+    version: number;
+    wxConfig: Record<string, any>;
+    /** 所有 JS 模块 id（如 "pages/index/index.js"），逻辑层按此顺序加载 define 脚本 */
+    modules: string[];
+    /** 逻辑层的 $gwx 与 __wxAppCode__ json/wxml，不含 require */
+    serviceTemplates: string;
+    serviceBootstrap: string;
+    pageFrame: string;
+    /** 渲染层的 $gwx 与 __wxAppCode__ json/wxml，不含样式（热更新时单独下发） */
+    pageTemplates: string;
+    /** 渲染层的样式：公共样式立即注入，页面和组件的样式注册到 __wxAppCode__（热更新时单独下发） */
+    pageStyles: string;
+    pages: string[];
+    components: string[];
+    durationMs: number;
+}
+declare class AppBuilder {
+    readonly project: MiniProgram;
+    private version;
+    /** invalidate 标记过的变化次数；每次构建记下开始时覆盖到第几次 */
+    private changes;
+    private pending;
+    private last;
+    private dirty;
+    private wxmlCache;
+    private wxssCache;
+    constructor(project: MiniProgram);
+    /** 根据变化的文件标记需要重新构建的部分；返回 true 表示需要刷新 */
+    invalidate(changedFiles?: string[]): boolean;
+    /**
+     * 返回包含调用前所有变化的构建结果。并发调用共享同一次构建；
+     * 进行中的构建开始得比最近一次变化早时（可能已读到旧文件），等它结束后再构建一次
+     */
+    build(): Promise<BuildResult>;
+    /**
+     * 单个 JS 模块的 define 包装
+     *
+     * 包装头和代码第一行写在同一行，行号与源文件一致。使用 import/export 的文件
+     * 先转换为 CommonJS（对应开发者工具的「ES6 转 ES5」），并内联 source map。
+     */
+    getModuleScript(id: string): string;
+    private doBuild;
+    private compileTemplates;
+    /** 与开发者工具一致，项目里的 wxss 全部交给 wcsc：被 @import 的文件（如 uni-app 的 common/main.wxss）也要在列表里 */
+    private compileStyles;
+    /** $gwx 加上各页面、组件的 json / wxml 注册；逻辑层用裁剪版 $gwx，渲染层用完整版 */
+    private createTemplates;
+    private createServiceBootstrap;
+}
+
+/**
+ * 开发服务器
+ *
+ *   /                          宿主页面
+ *   /__wxa__/app-info.json     构建信息（__wxConfig、页面列表、设备参数、setup）
+ *   /__wxa__/setup.js          编译后的 setup 文件
+ *   /__wxa__/appservice.html   逻辑层
+ *   /__wxa__/webview/<page>.html  渲染层（路径与页面一致，wxml 里的相对资源路径因此能正确解析）
+ *   /__wxa__/module/<file>.js  单个业务 JS 模块
+ *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
+ *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
+ *   /__baselib__/*             官方基础库
+ *   /__wxa__/proxy?url=        网络代理
+ *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址
+ *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
+ *   /__wxa__/api/*             真实登录（--real-login）：wx.login 的 code、手机号，只允许本机访问
+ *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）
+ *   其余路径                    小程序目录下的静态资源
+ */
+
+interface DevServerOptions {
+    projectPath: string;
+    /** 默认 3000，传 0 使用随机端口 */
+    port?: number;
+    host?: string;
+    /** 指定基础库版本，默认使用本机已安装的最新兼容版本 */
+    baseLibVersion?: string;
+    baseLibCacheDir?: string;
+    watch?: boolean;
+    device?: Partial<DeviceProfile>;
+    /**
+     * 小程序启动前执行的 setup 文件；默认使用项目目录下的 wxa.setup.ts / .js / .mjs，传 false 不使用
+     * 环境变量在构造时读取，只暴露 WXA_ 前缀的变量
+     */
+    setup?: string | false;
+    /** 浏览器端运行时（host.js / frame.js）所在目录，默认取构建产物 */
+    runtimeDir?: string;
+    /** 使用本机微信开发者工具登录态获取真实 code 和手机号 */
+    realLogin?: boolean;
+    logger?: Pick<Console, 'log' | 'warn' | 'error'>;
+}
+declare const DEFAULT_DEVICE: DeviceProfile;
+declare class DevServer {
+    private readonly options;
+    readonly project: MiniProgram;
+    readonly builder: AppBuilder;
+    readonly baseLib: ResolvedBaseLib;
+    /** 生效的 setup 文件绝对路径，没有时为 null */
+    readonly setupFile: string | null;
+    private readonly setupEnv;
+    private readonly device;
+    private readonly logger;
+    private readonly app;
+    private server;
+    private sockets;
+    private watcher;
+    private address;
+    /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
+    private readonly tempFiles;
+    constructor(options: DevServerOptions);
+    get url(): string;
+    start(): Promise<string>;
+    close(): Promise<void>;
+    private createApp;
+    /** 先编译一遍 setup：编译错误随 app-info 交给宿主显示，而不是让浏览器 import 失败 */
+    private setupInfo;
+    /** 需要构建结果的路由；构建失败时返回错误文本 */
+    private withBuild;
+    private runtimeDir;
+    /** 只在监听文件变化时打开基础库的热更新开关，跑测试（watch: false）时运行环境与真机一致 */
+    private get hotEnabled();
+    private startWatching;
+    private broadcast;
+}
+
+/**
+ * 生成基础库读取的 __wxConfig，字段与开发者工具保持一致
+ */
+
+interface WxConfigInput {
+    app: AppJson;
+    pages: string[];
+    unitJson: Map<string, UnitJson>;
+    appid: string;
+    subPackages: NonNullable<AppJson['subPackages']>;
+}
+declare function createWxConfig(input: WxConfigInput): Record<string, any>;
+
+export { AppBuilder, type AppJson, type BuildResult, DEFAULT_DEVICE, DevServer, type DevServerOptions, DeviceProfile, MiniProgram, type UnitJson, createWxConfig };