@open-wxa/wxa-runner-core 0.8.2 → 0.9.0

package/dist/index.js

@@ -164,11 +164,11 @@ var FileStore = class {
 };
 
 // src/server/DevServer.ts
-var import_fs4 = __toESM(require("fs"));
+var import_fs5 = __toESM(require("fs"));
 var import_http = __toESM(require("http"));
 var import_net = __toESM(require("net"));
-var import_os = __toESM(require("os"));
-var import_path4 = __toESM(require("path"));
+var import_os2 = __toESM(require("os"));
+var import_path5 = __toESM(require("path"));
 var import_express2 = __toESM(require("express"));
 var import_ws2 = require("ws");
 var import_wxa_runner_extractor5 = require("@open-wxa/wxa-runner-extractor");
@@ -233,6 +233,50 @@ function createWxConfig(input) {
   };
 }
 
+// src/project/WxmlMirror.ts
+var import_fs = __toESM(require("fs"));
+var import_os = __toESM(require("os"));
+var import_path = __toESM(require("path"));
+var WxmlMirror = class {
+  constructor(transform) {
+    this.transform = transform;
+    this.dir = null;
+    /** 已写入的文件：源内容（判断要不要重新转换）与写入的内容 */
+    this.files = /* @__PURE__ */ new Map();
+  }
+  /** 镜像目录；还没同步过时为 null */
+  get directory() {
+    return this.dir;
+  }
+  /**
+   * 让镜像目录与项目里的 wxml / wxs 一致，返回镜像目录。
+   * 只重写源内容变化的文件；项目里已删除的文件同时从镜像目录删除，被引用时 wcc 照常报错
+   */
+  sync(project, relPaths) {
+    const dir = this.dir ??= import_fs.default.mkdtempSync(import_path.default.join(import_os.default.tmpdir(), "wxa-runner-wxml-"));
+    const current = new Set(relPaths);
+    for (const rel of [...this.files.keys()]) {
+      if (current.has(rel)) continue;
+      import_fs.default.rmSync(import_path.default.join(dir, rel), { force: true });
+      this.files.delete(rel);
+    }
+    for (const rel of relPaths) {
+      const source = project.readText(rel);
+      if (this.files.get(rel) === source) continue;
+      const target = import_path.default.join(dir, rel);
+      import_fs.default.mkdirSync(import_path.default.dirname(target), { recursive: true });
+      import_fs.default.writeFileSync(target, rel.endsWith(".wxml") ? this.transform(source, rel) : source);
+      this.files.set(rel, source);
+    }
+    return dir;
+  }
+  dispose() {
+    if (this.dir) import_fs.default.rmSync(this.dir, { recursive: true, force: true });
+    this.dir = null;
+    this.files.clear();
+  }
+};
+
 // src/project/AppBuilder.ts
 var MODULE_PARAMS = [
   "require",
@@ -259,7 +303,7 @@ var MODULE_PARAMS = [
 ].join(", ");
 var ESM_SYNTAX = /(?:^|[;}])\s*(?:import\s*[{*'"]|import\s+[\w$]|export\s*[{*]|export\s+(?:default|const|let|var|function|class|async)\b)/m;
 var AppBuilder = class {
-  constructor(project) {
+  constructor(project, options = {}) {
     this.project = project;
     this.version = 0;
     /** invalidate 标记过的变化次数；每次构建记下开始时覆盖到第几次 */
@@ -269,6 +313,15 @@ var AppBuilder = class {
     this.dirty = /* @__PURE__ */ new Set(["config", "wxml", "wxss", "js"]);
     this.wxmlCache = null;
     this.wxssCache = null;
+    this.wxmlMirror = options.wxmlTransform ? new WxmlMirror(options.wxmlTransform) : null;
+  }
+  /** wxmlTransform 的镜像目录；没有设置转换或还没编译过时为 null */
+  get wxmlMirrorDir() {
+    return this.wxmlMirror?.directory ?? null;
+  }
+  /** 删除 wxmlTransform 的镜像目录，开发服务器关闭时调用 */
+  dispose() {
+    this.wxmlMirror?.dispose();
   }
   /** 根据变化的文件标记需要重新构建的部分；返回 true 表示需要刷新 */
   invalidate(changedFiles = []) {
@@ -393,7 +446,7 @@ ${pageStyles}`,
       const json = unitJson.get(id);
       return { path: id, tags: Object.keys({ ...json.usingComponents, ...json.componentGenerics }) };
     });
-    const cwd = this.project.root;
+    const cwd = this.wxmlMirror ? this.wxmlMirror.sync(this.project, files.map((file) => file.slice(2))) : this.project.root;
     const [full, cut] = await Promise.all([
       (0, import_wxa_runner_compiler.compileWxml)({ cwd, files, components, cut: false }),
       (0, import_wxa_runner_compiler.compileWxml)({ cwd, files, components, cut: true })
@@ -460,22 +513,22 @@ function classifyFile(file) {
 }
 
 // src/project/MiniProgram.ts
-var import_fs = __toESM(require("fs"));
-var import_path = __toESM(require("path"));
+var import_fs2 = __toESM(require("fs"));
+var import_path2 = __toESM(require("path"));
 var IGNORED_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".idea", ".vscode"]);
 var PROJECT_FILES = /* @__PURE__ */ new Set(["project.config.json", "project.private.config.json", "sitemap.json", "app.json", "wxa.setup.js"]);
 var MiniProgram = class {
   constructor(projectPath) {
     this.projectPath = projectPath;
-    const projectConfig = readJsonFile(import_path.default.join(projectPath, "project.config.json")) || {};
-    this.root = import_path.default.resolve(projectPath, projectConfig.miniprogramRoot || "");
+    const projectConfig = readJsonFile(import_path2.default.join(projectPath, "project.config.json")) || {};
+    this.root = import_path2.default.resolve(projectPath, projectConfig.miniprogramRoot || "");
     this.appid = projectConfig.appid || "touristappid";
-    if (!import_fs.default.existsSync(import_path.default.join(this.root, "app.json"))) {
+    if (!import_fs2.default.existsSync(import_path2.default.join(this.root, "app.json"))) {
       throw new Error(`${this.root} \u4E0B\u6CA1\u6709 app.json\uFF0C\u4E0D\u662F\u6709\u6548\u7684\u5C0F\u7A0B\u5E8F\u76EE\u5F55`);
     }
   }
   readAppJson() {
-    const app = readJsonFile(import_path.default.join(this.root, "app.json"));
+    const app = readJsonFile(import_path2.default.join(this.root, "app.json"));
     if (!app || !Array.isArray(app.pages) || app.pages.length === 0) {
       throw new Error("app.json \u7F3A\u5C11 pages \u914D\u7F6E");
     }
@@ -487,14 +540,14 @@ var MiniProgram = class {
   /** Worker 代码所在目录，不带首尾的 /；没有配置 workers 时为 null */
   workersDir(app) {
     const dir = typeof app.workers === "string" ? app.workers : app.workers?.path;
-    return dir ? import_path.default.posix.normalize(dir).replace(/^\/+|\/+$/g, "") : null;
+    return dir ? import_path2.default.posix.normalize(dir).replace(/^\/+|\/+$/g, "") : null;
   }
   /** 主包页面 + 分包页面（带 root 前缀） */
   allPages(app) {
     const pages = [...app.pages];
     for (const pkg of this.subPackages(app)) {
       for (const page of pkg.pages) {
-        const full = import_path.default.posix.join(pkg.root, page);
+        const full = import_path2.default.posix.join(pkg.root, page);
         if (!pages.includes(full)) pages.push(full);
       }
     }
@@ -506,7 +559,7 @@ var MiniProgram = class {
    * 所以能解析到的引用都换成组件的绝对路径
    */
   readUnitJson(id, app) {
-    const json = { ...readJsonFile(import_path.default.join(this.root, id + ".json")) };
+    const json = { ...readJsonFile(import_path2.default.join(this.root, id + ".json")) };
     const resolve = (fromId, ref) => {
       const resolved = this.resolveComponent(fromId, ref);
       return resolved ? "/" + resolved : null;
@@ -527,7 +580,7 @@ var MiniProgram = class {
         if (resolved || ref.startsWith("/") || /^plugin(-private)?:\/\//.test(ref)) {
           json.usingComponents[tag] = resolved ?? ref;
         } else {
-          const relative = import_path.default.posix.relative(import_path.default.posix.dirname(id), ref);
+          const relative = import_path2.default.posix.relative(import_path2.default.posix.dirname(id), ref);
           json.usingComponents[tag] = relative.startsWith(".") ? relative : "./" + relative;
         }
       }
@@ -540,25 +593,25 @@ var MiniProgram = class {
    */
   resolveComponent(fromId, ref) {
     if (!ref || ref.startsWith("plugin://") || ref.startsWith("plugin-private://")) return null;
-    const fromDir = import_path.default.posix.dirname(fromId);
+    const fromDir = import_path2.default.posix.dirname(fromId);
     const candidates = [];
     if (ref.startsWith("/")) {
       candidates.push(ref.slice(1));
     } else {
-      candidates.push(import_path.default.posix.join(fromDir, ref));
+      candidates.push(import_path2.default.posix.join(fromDir, ref));
       if (!ref.startsWith(".")) {
         let dir = fromDir;
         for (; ; ) {
-          candidates.push(import_path.default.posix.join(dir === "." ? "" : dir, "miniprogram_npm", ref));
+          candidates.push(import_path2.default.posix.join(dir === "." ? "" : dir, "miniprogram_npm", ref));
           if (dir === "." || dir === "") break;
-          dir = import_path.default.posix.dirname(dir);
+          dir = import_path2.default.posix.dirname(dir);
         }
       }
     }
     for (const candidate of candidates) {
-      const normalized = import_path.default.posix.normalize(candidate);
-      for (const id of [normalized, import_path.default.posix.join(normalized, "index")]) {
-        if (import_fs.default.existsSync(import_path.default.join(this.root, id + ".json"))) return id;
+      const normalized = import_path2.default.posix.normalize(candidate);
+      for (const id of [normalized, import_path2.default.posix.join(normalized, "index")]) {
+        if (import_fs2.default.existsSync(import_path2.default.join(this.root, id + ".json"))) return id;
       }
     }
     return null;
@@ -590,11 +643,11 @@ var MiniProgram = class {
   listFiles(extensions) {
     const result = [];
     const walk = (dir, rel) => {
-      for (const entry of import_fs.default.readdirSync(dir, { withFileTypes: true })) {
+      for (const entry of import_fs2.default.readdirSync(dir, { withFileTypes: true })) {
         if (entry.name.startsWith(".") || IGNORED_DIRS.has(entry.name)) continue;
         const childRel = rel ? `${rel}/${entry.name}` : entry.name;
         if (entry.isDirectory()) {
-          walk(import_path.default.join(dir, entry.name), childRel);
+          walk(import_path2.default.join(dir, entry.name), childRel);
         } else if (extensions.some((ext) => entry.name.endsWith(ext))) {
           if (!rel && PROJECT_FILES.has(entry.name)) continue;
           result.push(childRel);
@@ -605,18 +658,18 @@ var MiniProgram = class {
     return result.sort();
   }
   exists(relPath) {
-    return import_fs.default.existsSync(import_path.default.join(this.root, relPath));
+    return import_fs2.default.existsSync(import_path2.default.join(this.root, relPath));
   }
   readText(relPath) {
-    return import_fs.default.readFileSync(import_path.default.join(this.root, relPath), "utf8");
+    return import_fs2.default.readFileSync(import_path2.default.join(this.root, relPath), "utf8");
   }
   isInIndependentSubPackage(id, app) {
     return this.subPackages(app).some((pkg) => pkg.independent && id.startsWith(pkg.root.replace(/\/?$/, "/")));
   }
 };
 function readJsonFile(file) {
-  if (!import_fs.default.existsSync(file)) return null;
-  const text = import_fs.default.readFileSync(file, "utf8");
+  if (!import_fs2.default.existsSync(file)) return null;
+  const text = import_fs2.default.readFileSync(file, "utf8");
   try {
     return JSON.parse(text);
   } catch (error) {
@@ -682,9 +735,9 @@ var WechatDevClient = class {
    *
    * @throws 没有可用的登录态、超时、连不上、HTTP 状态不是 2xx 时，消息是给用户看的原因
    */
-  async post(path5, body, timeout = DEFAULT_TIMEOUT) {
+  async post(path6, body, timeout = DEFAULT_TIMEOUT) {
     const query = new URLSearchParams({ appid: this.appid, newticket: requireUsableTicket(await this.findTicket()), clientversion: CLIENT_VERSION });
-    const response = await fetch(`${BASE_URL}/${path5}?${query}`, {
+    const response = await fetch(`${BASE_URL}/${path6}?${query}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(body),
@@ -696,8 +749,8 @@ var WechatDevClient = class {
     return response;
   }
   /** 同 post，返回解析后的 JSON */
-  async postJson(path5, body) {
-    return (await this.post(path5, body)).json();
+  async postJson(path6, body) {
+    return (await this.post(path6, body)).json();
   }
 };
 
@@ -893,12 +946,12 @@ function webviewHtml(build2, pagePath, webviewId, options) {
   return `<!DOCTYPE html>
 <html>
 <head>
-${webviewHead(build2, pagePath, id)}
+${webviewHead(build2, pagePath, id, options.scripts)}
 ${enableHotUpdate(options.hot)}<script src="/__wxa__/page-frame.js?v=${build2.version}"></script>
 ${pageWindow(build2, pagePath).disableScroll ? "<style>body{overflow-y:hidden}</style>" : ""}
 </head>
 <body>
-<script>
+${scriptTags(options.scripts, "body")}<script>
 (function () {
   var path = ${toJs(pagePath)};
   if (typeof __wxAppCode__[path + '.wxss'] === 'function') __wxAppCode__[path + '.wxss']();
@@ -931,18 +984,18 @@ self.console = __wxaConsole;
 importScripts(${modules.map((url) => toJs(url)).join(", ")});
 `;
 }
-function pluginWebviewHtml(build2, plugin, innerPath, pagePath, webviewId) {
+function pluginWebviewHtml(build2, plugin, innerPath, pagePath, webviewId, options = {}) {
   const id = Number(webviewId) || 0;
   const page = plugin.files.get(`/${innerPath}.html`)?.toString("utf8") ?? `<script>console.error(${JSON.stringify(`[wxa-runner] \u63D2\u4EF6 ${plugin.alias} \u91CC\u6CA1\u6709\u9875\u9762 ${innerPath}`)})</script>`;
   return `<!DOCTYPE html>
 <html>
 <head>
-${webviewHead(build2, pagePath, id)}
+${webviewHead(build2, pagePath, id, options.scripts)}
 <script src="${pluginScriptUrl(plugin, "pageframe.js")}"></script>
 ${pageWindow(build2, pagePath).disableScroll ? "<style>body{overflow-y:hidden}</style>" : ""}
 </head>
 <body>
-${page}
+${scriptTags(options.scripts, "body")}${page}
 <script>parent.__wxaHost.frameLoaded('webview', ${id});</script>
 </body>
 </html>`;
@@ -950,7 +1003,7 @@ ${page}
 function pageWindow(build2, pagePath) {
   return { ...build2.wxConfig.global?.window, ...build2.wxConfig.page?.[pagePath + ".html"]?.window };
 }
-function webviewHead(build2, pagePath, id) {
+function webviewHead(build2, pagePath, id, scripts) {
   const wxConfig = { ...build2.wxConfig, window: pageWindow(build2, pagePath) };
   return `<meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no">
@@ -965,7 +1018,12 @@ function webviewHead(build2, pagePath, id) {
 <style>.wxa-service-canvas{position:absolute!important;left:0!important;top:0!important;width:100%!important;height:100%!important;visibility:inherit!important;pointer-events:none}</style>
 <script>var __wxConfig = ${toJs(wxConfig)};</script>
 <script src="/__wxa__/runtime/frame.js" data-kind="webview" data-webview-id="${id}"></script>
-<script src="/__baselib__/WAWebview.js"></script>`;
+${scriptTags(scripts, "head")}<script src="/__baselib__/WAWebview.js"></script>`;
+}
+function scriptTags(scripts, position) {
+  return (scripts ?? []).filter((script) => (script.position ?? "body") === position).map((script) => script.src !== void 0 ? `<script src="${escapeHtml(script.src)}"></script>
+` : `<script>${script.content.replace(/<\/script/gi, "<\\/script")}</script>
+`).join("");
 }
 function escapeHtml(text) {
   return text.replace(/[&<>"]/g, (ch) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[ch]);
@@ -1329,16 +1387,16 @@ function respond(action) {
 }
 
 // src/server/setup.ts
-var import_fs2 = __toESM(require("fs"));
-var import_path2 = __toESM(require("path"));
+var import_fs3 = __toESM(require("fs"));
+var import_path3 = __toESM(require("path"));
 var import_esbuild2 = require("esbuild");
 var SETUP_FILE_NAMES = ["wxa.setup.ts", "wxa.setup.js", "wxa.setup.mjs"];
 var SETUP_MODULE = "@open-wxa/wxa-runner-core/setup";
 var ENV_PREFIX = "WXA_";
 function findSetupFile(projectPath) {
   for (const name of SETUP_FILE_NAMES) {
-    const file = import_path2.default.join(projectPath, name);
-    if (import_fs2.default.existsSync(file)) return file;
+    const file = import_path3.default.join(projectPath, name);
+    if (import_fs3.default.existsSync(file)) return file;
   }
   return null;
 }
@@ -1350,7 +1408,7 @@ function collectSetupEnv(env) {
 async function bundleSetup(file) {
   const result = await (0, import_esbuild2.build)({
     entryPoints: [file],
-    absWorkingDir: import_path2.default.dirname(file),
+    absWorkingDir: import_path3.default.dirname(file),
     bundle: true,
     format: "esm",
     platform: "browser",
@@ -1378,8 +1436,8 @@ function builtinSetupModule() {
 
 // src/server/watcher.ts
 var import_crypto3 = require("crypto");
-var import_fs3 = __toESM(require("fs"));
-var import_path3 = __toESM(require("path"));
+var import_fs4 = __toESM(require("fs"));
+var import_path4 = __toESM(require("path"));
 var import_chokidar = __toESM(require("chokidar"));
 var DEBOUNCE = 120;
 var IGNORED = /(^|[/\\])(node_modules|\.git)([/\\]|$)/;
@@ -1407,7 +1465,7 @@ function watchProject(root, paths, onChange) {
     const unchanged = updateFingerprint(fingerprints, file, event);
     if (!scanned || unchanged) return;
     if (event !== "change") structural = true;
-    changed.add(import_path3.default.relative(root, file).split(import_path3.default.sep).join("/"));
+    changed.add(import_path4.default.relative(root, file).split(import_path4.default.sep).join("/"));
     if (timer) clearTimeout(timer);
     timer = setTimeout(flush, DEBOUNCE);
   });
@@ -1421,7 +1479,7 @@ function updateFingerprint(fingerprints, file, event) {
   if (event !== "add" && event !== "change" || !FINGERPRINTED.test(file)) return false;
   let next;
   try {
-    next = (0, import_crypto3.createHash)("sha1").update(import_fs3.default.readFileSync(file)).digest("hex");
+    next = (0, import_crypto3.createHash)("sha1").update(import_fs4.default.readFileSync(file)).digest("hex");
   } catch {
     return false;
   }
@@ -1430,7 +1488,30 @@ function updateFingerprint(fingerprints, file, event) {
   return previous === next;
 }
 
+// src/server/extensions.ts
+function applyExtensions(base, extensions, context) {
+  const webviewScripts = [...base.webviewScripts ?? []];
+  const middlewares = [...base.middlewares ?? []];
+  const transforms = base.wxmlTransform ? [base.wxmlTransform] : [];
+  const entries = [];
+  for (const extension of extensions) {
+    let setup;
+    try {
+      setup = extension.setup(context);
+    } catch (error) {
+      throw new Error(`\u6269\u5C55 ${extension.name} \u521D\u59CB\u5316\u5931\u8D25\uFF1A${error.message}`);
+    }
+    webviewScripts.push(...setup.webviewScripts ?? []);
+    middlewares.push(...setup.middlewares ?? []);
+    if (setup.wxmlTransform) transforms.push(setup.wxmlTransform);
+    if (setup.entry) entries.push({ name: extension.name, ...setup.entry });
+  }
+  const wxmlTransform = transforms.length === 0 ? void 0 : (code, file) => transforms.reduce((result, transform) => transform(result, file), code);
+  return { webviewScripts, middlewares, wxmlTransform, entries };
+}
+
 // src/server/DevServer.ts
+var RESERVED_PREFIXES = ["/__wxa__", "/__baselib__", "/__plugin__"];
 var DEFAULT_DEVICE = {
   model: "iPhone X",
   screenWidth: 375,
@@ -1452,7 +1533,12 @@ var DevServer = class {
     /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
     this.fileSessions = /* @__PURE__ */ new Map();
     this.logger = options.logger || console;
-    this.project = new MiniProgram(import_path4.default.resolve(options.projectPath));
+    this.project = new MiniProgram(import_path5.default.resolve(options.projectPath));
+    const extended = applyExtensions(options, options.extensions ?? [], { projectPath: this.project.projectPath, root: this.project.root });
+    extended.middlewares.forEach(({ path: mountPath }) => assertMountPath(mountPath));
+    this.webviewScripts = extended.webviewScripts;
+    this.middlewares = extended.middlewares;
+    this.extensionEntries = extended.entries;
     this.baseLib = (0, import_wxa_runner_extractor5.resolveBaseLib)({ version: options.baseLibVersion, cacheDir: options.baseLibCacheDir });
     if (!this.baseLib.compatible) {
       this.logger.warn(`[wxa-runner] \u57FA\u7840\u5E93 ${this.baseLib.version} \u9AD8\u4E8E\u5DF2\u9A8C\u8BC1\u7684\u7248\u672C\u8303\u56F4\uFF0C\u53EF\u80FD\u65E0\u6CD5\u6B63\u5E38\u8FD0\u884C`);
@@ -1464,7 +1550,7 @@ var DevServer = class {
     this.ticketSource = this.devtoolsLogin ? developerTicketSource(this.project.projectPath, this.logger) : null;
     this.plugins = new PluginStore(this.ticketSource && new WechatDevClient(this.project.appid, this.ticketSource), this.logger);
     this.device = { ...DEFAULT_DEVICE, ...options.device };
-    this.builder = new AppBuilder(this.project);
+    this.builder = new AppBuilder(this.project, { wxmlTransform: extended.wxmlTransform });
     this.setupFile = resolveSetupFile(options.setup, this.project.projectPath);
     this.setupEnv = collectSetupEnv(process.env);
     this.app = this.createApp();
@@ -1477,7 +1563,7 @@ var DevServer = class {
   get networkUrls() {
     if (!this.lanAccess) return [];
     const { port } = new URL(this.address);
-    return Object.values(import_os.default.networkInterfaces()).flat().filter((net2) => net2 && net2.family === "IPv4" && !net2.internal).map((net2) => `http://${net2.address}:${port}`);
+    return Object.values(import_os2.default.networkInterfaces()).flat().filter((net2) => net2 && net2.family === "IPv4" && !net2.internal).map((net2) => `http://${net2.address}:${port}`);
   }
   async start() {
     try {
@@ -1520,11 +1606,15 @@ ${error.message}`);
       await new Promise((resolve) => server.close(() => resolve()));
     }
     this.fileSessions.clear();
+    this.builder.dispose();
   }
   createApp() {
     const app = (0, import_express2.default)();
     const root = this.project.root;
     const noStore = (res) => res.setHeader("Cache-Control", "no-store");
+    for (const { path: mountPath, handler } of this.middlewares) {
+      app.use(mountPath, (req, res, next) => handler(req, res, next));
+    }
     app.get("/", (_req, res) => {
       noStore(res);
       res.type("html").send(hostHtml());
@@ -1579,7 +1669,8 @@ ${error.message}`);
       const pagePath = decodeURIComponent(req.params[0]);
       if (!build2.pages.includes(pagePath)) return next();
       const pluginPage = findPluginPage(build2, pagePath);
-      res.type("html").send(pluginPage ? pluginWebviewHtml(build2, pluginPage.plugin, pluginPage.innerPath, pagePath, Number(req.query.id)) : webviewHtml(build2, pagePath, Number(req.query.id), { hot: this.hotEnabled }));
+      const scripts = this.webviewScripts;
+      res.type("html").send(pluginPage ? pluginWebviewHtml(build2, pluginPage.plugin, pluginPage.innerPath, pagePath, Number(req.query.id), { scripts }) : webviewHtml(build2, pagePath, Number(req.query.id), { hot: this.hotEnabled, scripts }));
     }));
     app.get("/__wxa__/plugin/:provider/:version/:file(appservice.js|pageframe.js)", this.withBuild((build2, req, res, next) => {
       const { provider, version, file } = req.params;
@@ -1590,7 +1681,7 @@ ${error.message}`);
     app.get(/^\/__plugin__\/([^/]+)(\/.+)$/, this.withBuild((build2, req, res, next) => {
       const file = build2.plugins.find((plugin) => plugin.provider === req.params[0])?.files.get(decodeURIComponent(req.params[1]));
       if (!file) return next();
-      res.type(import_path4.default.extname(req.params[1]) || "application/octet-stream").send(file);
+      res.type(import_path5.default.extname(req.params[1]) || "application/octet-stream").send(file);
     }));
     app.get(/^\/__wxa__\/module\/(.+\.js)$/, this.withBuild((build2, req, res) => {
       const id = decodeURIComponent(req.params[0]);
@@ -1601,7 +1692,7 @@ ${error.message}`);
       res.type("js").send(this.builder.getModuleScript(id));
     }));
     app.get("/__wxa__/worker.js", this.withBuild((build2, _req, res) => {
-      const hasWorker = import_fs4.default.existsSync(import_path4.default.join(this.baseLib.dir, "WAWorker.js"));
+      const hasWorker = import_fs5.default.existsSync(import_path5.default.join(this.baseLib.dir, "WAWorker.js"));
       res.type("js").send(workerScript(build2, { version: this.baseLib.version, hasWorker }));
     }));
     app.get("/__wxa__/service-bootstrap.js", this.withBuild((build2, _req, res) => {
@@ -1620,28 +1711,28 @@ ${error.message}`);
       res.type("js").send(build2.pageFrame);
     }));
     app.get("/__wxa__/runtime/frame.js.map", (_req, res, next) => {
-      const file = import_path4.default.join(this.runtimeDir(), "frame.js.map");
-      if (!import_fs4.default.existsSync(file)) return next();
-      res.type("json").send(ignoreConsoleHook(import_fs4.default.readFileSync(file, "utf8")));
+      const file = import_path5.default.join(this.runtimeDir(), "frame.js.map");
+      if (!import_fs5.default.existsSync(file)) return next();
+      res.type("json").send(ignoreConsoleHook(import_fs5.default.readFileSync(file, "utf8")));
     });
     app.use("/__wxa__/runtime", import_express2.default.static(this.runtimeDir(), {
       cacheControl: false,
       // Service Worker 默认只能接管自己所在目录下的页面，宿主页面在根路径
       setHeaders: (res, file) => {
-        if (import_path4.default.basename(file) === "sw.js") res.setHeader("Service-Worker-Allowed", "/");
+        if (import_path5.default.basename(file) === "sw.js") res.setHeader("Service-Worker-Allowed", "/");
       }
     }));
     const sourceMaps = /* @__PURE__ */ new Map();
     app.get(/^\/__baselib__\/(.+\.js)\.map$/, (req, res, next) => {
-      const file = import_path4.default.resolve(this.baseLib.dir, req.params[0]);
-      if (!file.startsWith(this.baseLib.dir + import_path4.default.sep) || !import_fs4.default.existsSync(file)) return next();
-      if (!sourceMaps.has(file)) sourceMaps.set(file, ignoreListSourceMap(import_fs4.default.readFileSync(file, "utf8"), `${import_path4.default.basename(file)}?original`));
+      const file = import_path5.default.resolve(this.baseLib.dir, req.params[0]);
+      if (!file.startsWith(this.baseLib.dir + import_path5.default.sep) || !import_fs5.default.existsSync(file)) return next();
+      if (!sourceMaps.has(file)) sourceMaps.set(file, ignoreListSourceMap(import_fs5.default.readFileSync(file, "utf8"), `${import_path5.default.basename(file)}?original`));
       res.type("json").send(sourceMaps.get(file));
     });
     app.use("/__baselib__", import_express2.default.static(this.baseLib.dir, {
       maxAge: "1d",
       setHeaders: (res, file) => {
-        if (file.endsWith(".js")) res.setHeader("SourceMap", `${import_path4.default.basename(file)}.map`);
+        if (file.endsWith(".js")) res.setHeader("SourceMap", `${import_path5.default.basename(file)}.map`);
       }
     }));
     app.use(PROXY_PREFIX, import_express2.default.raw({ type: () => true, limit: "100mb" }), handleProxy);
@@ -1701,7 +1792,7 @@ ${error.message}`);
         return;
       }
       const data = node.data;
-      res.type(import_path4.default.extname(req.params[0]));
+      res.type(import_path5.default.extname(req.params[0]));
       res.setHeader("ETag", `"${node.etag}"`);
       res.setHeader("Accept-Ranges", "bytes");
       const ranges = req.range(data.length);
@@ -1771,11 +1862,11 @@ ${error.message}`);
   runtimeDir() {
     const candidates = [
       this.options.runtimeDir,
-      import_path4.default.join(__dirname, "runtime"),
-      import_path4.default.join(__dirname, "../runtime"),
-      import_path4.default.join(__dirname, "../../dist/runtime")
+      import_path5.default.join(__dirname, "runtime"),
+      import_path5.default.join(__dirname, "../runtime"),
+      import_path5.default.join(__dirname, "../../dist/runtime")
     ].filter((dir) => !!dir);
-    const found = candidates.find((dir) => import_fs4.default.existsSync(import_path4.default.join(dir, "host.js")));
+    const found = candidates.find((dir) => import_fs5.default.existsSync(import_path5.default.join(dir, "host.js")));
     if (!found) {
       throw new Error("\u627E\u4E0D\u5230\u6D4F\u89C8\u5668\u7AEF\u8FD0\u884C\u65F6\uFF08host.js\uFF09\uFF0C\u8BF7\u5148\u6267\u884C pnpm build");
     }
@@ -1788,7 +1879,7 @@ ${error.message}`);
   startWatching() {
     let lastBuildFailed = false;
     const watched = [this.project.root];
-    if (this.setupFile && import_path4.default.relative(this.project.root, this.setupFile).startsWith("..")) watched.push(this.setupFile);
+    if (this.setupFile && import_path5.default.relative(this.project.root, this.setupFile).startsWith("..")) watched.push(this.setupFile);
     this.watcher = watchProject(this.project.root, watched, async ({ files, structural }) => {
       const reloadOnly = structural || lastBuildFailed;
       this.builder.invalidate(files);
@@ -1819,7 +1910,7 @@ var DEFAULT_PORT = 3e3;
 var LOCAL_HOST_OF_ANY_ADDRESS = /* @__PURE__ */ new Map([["0.0.0.0", "127.0.0.1"], ["::", "localhost"]]);
 async function listen(server, port, host, logger) {
   for (let candidate = port ?? DEFAULT_PORT; ; candidate++) {
-    const taken = LOCAL_HOST_OF_ANY_ADDRESS.has(host) && await takenOnLoopback(candidate) || !await bind(server, candidate, host);
+    const taken = await takenOnLocalAddresses(candidate) || !await bind(server, candidate, host);
     if (!taken) {
       const actual = server.address().port;
       if (port === void 0 && actual !== DEFAULT_PORT) logger.warn(`[wxa-runner] \u7AEF\u53E3 ${DEFAULT_PORT} \u5DF2\u88AB\u5360\u7528\uFF0C\u6539\u7528 ${actual}`);
@@ -1838,8 +1929,8 @@ function bind(server, port, host) {
     });
   });
 }
-async function takenOnLoopback(port) {
-  for (const address of ["127.0.0.1", "::1"]) {
+async function takenOnLocalAddresses(port) {
+  for (const address of ["127.0.0.1", "::1", "0.0.0.0", "::"]) {
     const probe = import_net.default.createServer();
     const free = await bind(probe, port, address).catch(() => true);
     if (!free) return true;
@@ -1847,11 +1938,21 @@ async function takenOnLoopback(port) {
   }
   return false;
 }
+function assertMountPath(mountPath) {
+  const literal = typeof mountPath === "string" && /^(\/[\w.~-]+)+$/.test(mountPath);
+  const lower = literal ? mountPath.toLowerCase() : "";
+  const reserved = RESERVED_PREFIXES.some((prefix) => lower === prefix || lower.startsWith(prefix + "/"));
+  if (!literal || reserved) {
+    throw new Error(
+      `\u4E2D\u95F4\u4EF6\u8DEF\u5F84 ${String(mountPath)} \u4E0D\u53EF\u7528\uFF1A\u8981\u4EE5 / \u5F00\u5934\uFF0C\u53EA\u542B\u5B57\u6BCD\u3001\u6570\u5B57\u548C _ . ~ -\uFF08\u4E0D\u652F\u6301\u901A\u914D\u7B26\u548C\u53C2\u6570\uFF09\uFF0C\u4E0D\u80FD\u662F /\uFF0C\u4E5F\u4E0D\u80FD\u7528 wxa-runner \u4FDD\u7559\u7684\u524D\u7F00 ${RESERVED_PREFIXES.join("\u3001")}\uFF08\u4E0D\u533A\u5206\u5927\u5C0F\u5199\uFF09`
+    );
+  }
+}
 function resolveSetupFile(option, projectPath) {
   if (option === false) return null;
   if (!option) return findSetupFile(projectPath);
-  const file = import_path4.default.resolve(option);
-  if (!import_fs4.default.existsSync(file)) throw new Error(`\u627E\u4E0D\u5230 setup \u6587\u4EF6\uFF1A${file}`);
+  const file = import_path5.default.resolve(option);
+  if (!import_fs5.default.existsSync(file)) throw new Error(`\u627E\u4E0D\u5230 setup \u6587\u4EF6\uFF1A${file}`);
   return file;
 }
 // Annotate the CommonJS export names for ESM import in node: