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

package/dist/index.mjs

@@ -128,11 +128,11 @@ var FileStore = class {
 };
 
 // src/server/DevServer.ts
-import fs4 from "fs";
+import fs5 from "fs";
 import http from "http";
 import net from "net";
-import os from "os";
-import path4 from "path";
+import os2 from "os";
+import path5 from "path";
 import express2 from "express";
 import { WebSocket as WebSocket2, WebSocketServer } from "ws";
 import { readRegionData, resolveBaseLib, usesIsolatedContext } from "@open-wxa/wxa-runner-extractor";
@@ -197,6 +197,50 @@ function createWxConfig(input) {
   };
 }
 
+// src/project/WxmlMirror.ts
+import fs from "fs";
+import os from "os";
+import path from "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 ??= fs.mkdtempSync(path.join(os.tmpdir(), "wxa-runner-wxml-"));
+    const current = new Set(relPaths);
+    for (const rel of [...this.files.keys()]) {
+      if (current.has(rel)) continue;
+      fs.rmSync(path.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 = path.join(dir, rel);
+      fs.mkdirSync(path.dirname(target), { recursive: true });
+      fs.writeFileSync(target, rel.endsWith(".wxml") ? this.transform(source, rel) : source);
+      this.files.set(rel, source);
+    }
+    return dir;
+  }
+  dispose() {
+    if (this.dir) fs.rmSync(this.dir, { recursive: true, force: true });
+    this.dir = null;
+    this.files.clear();
+  }
+};
+
 // src/project/AppBuilder.ts
 var MODULE_PARAMS = [
   "require",
@@ -223,7 +267,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 标记过的变化次数；每次构建记下开始时覆盖到第几次 */
@@ -233,6 +277,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 = []) {
@@ -357,7 +410,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([
       compileWxml({ cwd, files, components, cut: false }),
       compileWxml({ cwd, files, components, cut: true })
@@ -424,22 +477,22 @@ function classifyFile(file) {
 }
 
 // src/project/MiniProgram.ts
-import fs from "fs";
-import path from "path";
+import fs2 from "fs";
+import path2 from "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(path.join(projectPath, "project.config.json")) || {};
-    this.root = path.resolve(projectPath, projectConfig.miniprogramRoot || "");
+    const projectConfig = readJsonFile(path2.join(projectPath, "project.config.json")) || {};
+    this.root = path2.resolve(projectPath, projectConfig.miniprogramRoot || "");
     this.appid = projectConfig.appid || "touristappid";
-    if (!fs.existsSync(path.join(this.root, "app.json"))) {
+    if (!fs2.existsSync(path2.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(path.join(this.root, "app.json"));
+    const app = readJsonFile(path2.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");
     }
@@ -451,14 +504,14 @@ var MiniProgram = class {
   /** Worker 代码所在目录，不带首尾的 /；没有配置 workers 时为 null */
   workersDir(app) {
     const dir = typeof app.workers === "string" ? app.workers : app.workers?.path;
-    return dir ? path.posix.normalize(dir).replace(/^\/+|\/+$/g, "") : null;
+    return dir ? path2.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 = path.posix.join(pkg.root, page);
+        const full = path2.posix.join(pkg.root, page);
         if (!pages.includes(full)) pages.push(full);
       }
     }
@@ -470,7 +523,7 @@ var MiniProgram = class {
    * 所以能解析到的引用都换成组件的绝对路径
    */
   readUnitJson(id, app) {
-    const json = { ...readJsonFile(path.join(this.root, id + ".json")) };
+    const json = { ...readJsonFile(path2.join(this.root, id + ".json")) };
     const resolve = (fromId, ref) => {
       const resolved = this.resolveComponent(fromId, ref);
       return resolved ? "/" + resolved : null;
@@ -491,7 +544,7 @@ var MiniProgram = class {
         if (resolved || ref.startsWith("/") || /^plugin(-private)?:\/\//.test(ref)) {
           json.usingComponents[tag] = resolved ?? ref;
         } else {
-          const relative = path.posix.relative(path.posix.dirname(id), ref);
+          const relative = path2.posix.relative(path2.posix.dirname(id), ref);
           json.usingComponents[tag] = relative.startsWith(".") ? relative : "./" + relative;
         }
       }
@@ -504,25 +557,25 @@ var MiniProgram = class {
    */
   resolveComponent(fromId, ref) {
     if (!ref || ref.startsWith("plugin://") || ref.startsWith("plugin-private://")) return null;
-    const fromDir = path.posix.dirname(fromId);
+    const fromDir = path2.posix.dirname(fromId);
     const candidates = [];
     if (ref.startsWith("/")) {
       candidates.push(ref.slice(1));
     } else {
-      candidates.push(path.posix.join(fromDir, ref));
+      candidates.push(path2.posix.join(fromDir, ref));
       if (!ref.startsWith(".")) {
         let dir = fromDir;
         for (; ; ) {
-          candidates.push(path.posix.join(dir === "." ? "" : dir, "miniprogram_npm", ref));
+          candidates.push(path2.posix.join(dir === "." ? "" : dir, "miniprogram_npm", ref));
           if (dir === "." || dir === "") break;
-          dir = path.posix.dirname(dir);
+          dir = path2.posix.dirname(dir);
         }
       }
     }
     for (const candidate of candidates) {
-      const normalized = path.posix.normalize(candidate);
-      for (const id of [normalized, path.posix.join(normalized, "index")]) {
-        if (fs.existsSync(path.join(this.root, id + ".json"))) return id;
+      const normalized = path2.posix.normalize(candidate);
+      for (const id of [normalized, path2.posix.join(normalized, "index")]) {
+        if (fs2.existsSync(path2.join(this.root, id + ".json"))) return id;
       }
     }
     return null;
@@ -554,11 +607,11 @@ var MiniProgram = class {
   listFiles(extensions) {
     const result = [];
     const walk = (dir, rel) => {
-      for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+      for (const entry of fs2.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(path.join(dir, entry.name), childRel);
+          walk(path2.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);
@@ -569,18 +622,18 @@ var MiniProgram = class {
     return result.sort();
   }
   exists(relPath) {
-    return fs.existsSync(path.join(this.root, relPath));
+    return fs2.existsSync(path2.join(this.root, relPath));
   }
   readText(relPath) {
-    return fs.readFileSync(path.join(this.root, relPath), "utf8");
+    return fs2.readFileSync(path2.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 (!fs.existsSync(file)) return null;
-  const text = fs.readFileSync(file, "utf8");
+  if (!fs2.existsSync(file)) return null;
+  const text = fs2.readFileSync(file, "utf8");
   try {
     return JSON.parse(text);
   } catch (error) {
@@ -646,9 +699,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),
@@ -660,8 +713,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();
   }
 };
 
@@ -857,12 +910,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']();
@@ -895,18 +948,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>`;
@@ -914,7 +967,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">
@@ -929,7 +982,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]);
@@ -1293,16 +1351,16 @@ function respond(action) {
 }
 
 // src/server/setup.ts
-import fs2 from "fs";
-import path2 from "path";
+import fs3 from "fs";
+import path3 from "path";
 import { build } from "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 = path2.join(projectPath, name);
-    if (fs2.existsSync(file)) return file;
+    const file = path3.join(projectPath, name);
+    if (fs3.existsSync(file)) return file;
   }
   return null;
 }
@@ -1314,7 +1372,7 @@ function collectSetupEnv(env) {
 async function bundleSetup(file) {
   const result = await build({
     entryPoints: [file],
-    absWorkingDir: path2.dirname(file),
+    absWorkingDir: path3.dirname(file),
     bundle: true,
     format: "esm",
     platform: "browser",
@@ -1342,8 +1400,8 @@ function builtinSetupModule() {
 
 // src/server/watcher.ts
 import { createHash } from "crypto";
-import fs3 from "fs";
-import path3 from "path";
+import fs4 from "fs";
+import path4 from "path";
 import chokidar from "chokidar";
 var DEBOUNCE = 120;
 var IGNORED = /(^|[/\\])(node_modules|\.git)([/\\]|$)/;
@@ -1371,7 +1429,7 @@ function watchProject(root, paths, onChange) {
     const unchanged = updateFingerprint(fingerprints, file, event);
     if (!scanned || unchanged) return;
     if (event !== "change") structural = true;
-    changed.add(path3.relative(root, file).split(path3.sep).join("/"));
+    changed.add(path4.relative(root, file).split(path4.sep).join("/"));
     if (timer) clearTimeout(timer);
     timer = setTimeout(flush, DEBOUNCE);
   });
@@ -1385,7 +1443,7 @@ function updateFingerprint(fingerprints, file, event) {
   if (event !== "add" && event !== "change" || !FINGERPRINTED.test(file)) return false;
   let next;
   try {
-    next = createHash("sha1").update(fs3.readFileSync(file)).digest("hex");
+    next = createHash("sha1").update(fs4.readFileSync(file)).digest("hex");
   } catch {
     return false;
   }
@@ -1394,7 +1452,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,
@@ -1416,7 +1497,12 @@ var DevServer = class {
     /** 运行时生成的临时文件（canvas 导出、拍照等），随服务器进程存在 */
     this.fileSessions = /* @__PURE__ */ new Map();
     this.logger = options.logger || console;
-    this.project = new MiniProgram(path4.resolve(options.projectPath));
+    this.project = new MiniProgram(path5.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 = 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`);
@@ -1428,7 +1514,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();
@@ -1441,7 +1527,7 @@ var DevServer = class {
   get networkUrls() {
     if (!this.lanAccess) return [];
     const { port } = new URL(this.address);
-    return Object.values(os.networkInterfaces()).flat().filter((net2) => net2 && net2.family === "IPv4" && !net2.internal).map((net2) => `http://${net2.address}:${port}`);
+    return Object.values(os2.networkInterfaces()).flat().filter((net2) => net2 && net2.family === "IPv4" && !net2.internal).map((net2) => `http://${net2.address}:${port}`);
   }
   async start() {
     try {
@@ -1484,11 +1570,15 @@ ${error.message}`);
       await new Promise((resolve) => server.close(() => resolve()));
     }
     this.fileSessions.clear();
+    this.builder.dispose();
   }
   createApp() {
     const app = express2();
     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());
@@ -1543,7 +1633,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;
@@ -1554,7 +1645,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(path4.extname(req.params[1]) || "application/octet-stream").send(file);
+      res.type(path5.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]);
@@ -1565,7 +1656,7 @@ ${error.message}`);
       res.type("js").send(this.builder.getModuleScript(id));
     }));
     app.get("/__wxa__/worker.js", this.withBuild((build2, _req, res) => {
-      const hasWorker = fs4.existsSync(path4.join(this.baseLib.dir, "WAWorker.js"));
+      const hasWorker = fs5.existsSync(path5.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) => {
@@ -1584,28 +1675,28 @@ ${error.message}`);
       res.type("js").send(build2.pageFrame);
     }));
     app.get("/__wxa__/runtime/frame.js.map", (_req, res, next) => {
-      const file = path4.join(this.runtimeDir(), "frame.js.map");
-      if (!fs4.existsSync(file)) return next();
-      res.type("json").send(ignoreConsoleHook(fs4.readFileSync(file, "utf8")));
+      const file = path5.join(this.runtimeDir(), "frame.js.map");
+      if (!fs5.existsSync(file)) return next();
+      res.type("json").send(ignoreConsoleHook(fs5.readFileSync(file, "utf8")));
     });
     app.use("/__wxa__/runtime", express2.static(this.runtimeDir(), {
       cacheControl: false,
       // Service Worker 默认只能接管自己所在目录下的页面，宿主页面在根路径
       setHeaders: (res, file) => {
-        if (path4.basename(file) === "sw.js") res.setHeader("Service-Worker-Allowed", "/");
+        if (path5.basename(file) === "sw.js") res.setHeader("Service-Worker-Allowed", "/");
       }
     }));
     const sourceMaps = /* @__PURE__ */ new Map();
     app.get(/^\/__baselib__\/(.+\.js)\.map$/, (req, res, next) => {
-      const file = path4.resolve(this.baseLib.dir, req.params[0]);
-      if (!file.startsWith(this.baseLib.dir + path4.sep) || !fs4.existsSync(file)) return next();
-      if (!sourceMaps.has(file)) sourceMaps.set(file, ignoreListSourceMap(fs4.readFileSync(file, "utf8"), `${path4.basename(file)}?original`));
+      const file = path5.resolve(this.baseLib.dir, req.params[0]);
+      if (!file.startsWith(this.baseLib.dir + path5.sep) || !fs5.existsSync(file)) return next();
+      if (!sourceMaps.has(file)) sourceMaps.set(file, ignoreListSourceMap(fs5.readFileSync(file, "utf8"), `${path5.basename(file)}?original`));
       res.type("json").send(sourceMaps.get(file));
     });
     app.use("/__baselib__", express2.static(this.baseLib.dir, {
       maxAge: "1d",
       setHeaders: (res, file) => {
-        if (file.endsWith(".js")) res.setHeader("SourceMap", `${path4.basename(file)}.map`);
+        if (file.endsWith(".js")) res.setHeader("SourceMap", `${path5.basename(file)}.map`);
       }
     }));
     app.use(PROXY_PREFIX, express2.raw({ type: () => true, limit: "100mb" }), handleProxy);
@@ -1665,7 +1756,7 @@ ${error.message}`);
         return;
       }
       const data = node.data;
-      res.type(path4.extname(req.params[0]));
+      res.type(path5.extname(req.params[0]));
       res.setHeader("ETag", `"${node.etag}"`);
       res.setHeader("Accept-Ranges", "bytes");
       const ranges = req.range(data.length);
@@ -1735,11 +1826,11 @@ ${error.message}`);
   runtimeDir() {
     const candidates = [
       this.options.runtimeDir,
-      path4.join(__dirname, "runtime"),
-      path4.join(__dirname, "../runtime"),
-      path4.join(__dirname, "../../dist/runtime")
+      path5.join(__dirname, "runtime"),
+      path5.join(__dirname, "../runtime"),
+      path5.join(__dirname, "../../dist/runtime")
     ].filter((dir) => !!dir);
-    const found = candidates.find((dir) => fs4.existsSync(path4.join(dir, "host.js")));
+    const found = candidates.find((dir) => fs5.existsSync(path5.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");
     }
@@ -1752,7 +1843,7 @@ ${error.message}`);
   startWatching() {
     let lastBuildFailed = false;
     const watched = [this.project.root];
-    if (this.setupFile && path4.relative(this.project.root, this.setupFile).startsWith("..")) watched.push(this.setupFile);
+    if (this.setupFile && path5.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);
@@ -1783,7 +1874,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}`);
@@ -1802,8 +1893,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 = net.createServer();
     const free = await bind(probe, port, address).catch(() => true);
     if (!free) return true;
@@ -1811,11 +1902,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 = path4.resolve(option);
-  if (!fs4.existsSync(file)) throw new Error(`\u627E\u4E0D\u5230 setup \u6587\u4EF6\uFF1A${file}`);
+  const file = path5.resolve(option);
+  if (!fs5.existsSync(file)) throw new Error(`\u627E\u4E0D\u5230 setup \u6587\u4EF6\uFF1A${file}`);
   return file;
 }
 export {