@open-wxa/wxa-runner-core 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -32,8 +32,10 @@ interface AppJson {
     }>;
     subpackages?: AppJson['subPackages'];
     usingComponents?: Record<string, string>;
+    /** isSubpackage：Worker 代码作为分包，业务先调 wx.preDownloadSubpackage({ packageType: 'workers' }) 再创建 Worker */
     workers?: string | {
         path: string;
+        isSubpackage?: boolean;
     };
     [key: string]: any;
 }
@@ -58,6 +60,8 @@ declare class MiniProgram {
         pages: string[];
         independent?: boolean;
     }[];
+    /** Worker 代码所在目录，不带首尾的 /；没有配置 workers 时为 null */
+    workersDir(app: AppJson): string | null;
     /** 主包页面 + 分包页面（带 root 前缀） */
     allPages(app: AppJson): string[];
     /** 读取并预处理页面/组件 json，id 不带扩展名 */
@@ -73,7 +77,7 @@ declare class MiniProgram {
         components: string[];
     };
     /** 列出代码根目录下指定扩展名的文件，返回 posix 风格的相对路径 */
-    listFiles(extensions: string[], excludeDirs?: string[]): string[];
+    listFiles(extensions: string[]): string[];
     exists(relPath: string): boolean;
     readText(relPath: string): string;
     private isInIndependentSubPackage;
@@ -93,6 +97,8 @@ declare class MiniProgram {
  *   2. wcsc 的公共样式运行时 + app.wxss，与每个页面/组件的 __wxAppCode__ wxss（pageStyles）
  *   两部分在热更新时分别下发
  *   样式和模板里的 env(safe-area-inset-*) 改写成 CSS 变量，见 rewriteSafeAreaInsets
+ *
+ * Worker：workers 目录下的 JS 不进逻辑层，同样包装成 define 脚本，由 Worker 入口（server/html.ts 的 workerScript）加载
  */
 
 interface BuildResult {
@@ -100,6 +106,8 @@ interface BuildResult {
     wxConfig: Record<string, any>;
     /** 所有 JS 模块 id（如 "pages/index/index.js"），逻辑层按此顺序加载 define 脚本 */
     modules: string[];
+    /** workers 目录下的 JS 模块 id，Worker 按此顺序加载 define 脚本 */
+    workerModules: string[];
     /** 逻辑层的 $gwx 与 __wxAppCode__ json/wxml，不含 require */
     serviceTemplates: string;
     serviceBootstrap: string;
@@ -154,7 +162,8 @@ declare class AppBuilder {
  *   /__wxa__/setup.js          编译后的 setup 文件
  *   /__wxa__/appservice.html   逻辑层
  *   /__wxa__/webview/<page>.html  渲染层（路径与页面一致，wxml 里的相对资源路径因此能正确解析）
- *   /__wxa__/module/<file>.js  单个业务 JS 模块
+ *   /__wxa__/module/<file>.js  单个业务 JS 模块（含 workers 目录下的）
+ *   /__wxa__/worker.js?id=     Worker 的入口
  *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
  *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
  *   /__baselib__/*             官方基础库

package/dist/index.d.ts

@@ -32,8 +32,10 @@ interface AppJson {
     }>;
     subpackages?: AppJson['subPackages'];
     usingComponents?: Record<string, string>;
+    /** isSubpackage：Worker 代码作为分包，业务先调 wx.preDownloadSubpackage({ packageType: 'workers' }) 再创建 Worker */
     workers?: string | {
         path: string;
+        isSubpackage?: boolean;
     };
     [key: string]: any;
 }
@@ -58,6 +60,8 @@ declare class MiniProgram {
         pages: string[];
         independent?: boolean;
     }[];
+    /** Worker 代码所在目录，不带首尾的 /；没有配置 workers 时为 null */
+    workersDir(app: AppJson): string | null;
     /** 主包页面 + 分包页面（带 root 前缀） */
     allPages(app: AppJson): string[];
     /** 读取并预处理页面/组件 json，id 不带扩展名 */
@@ -73,7 +77,7 @@ declare class MiniProgram {
         components: string[];
     };
     /** 列出代码根目录下指定扩展名的文件，返回 posix 风格的相对路径 */
-    listFiles(extensions: string[], excludeDirs?: string[]): string[];
+    listFiles(extensions: string[]): string[];
     exists(relPath: string): boolean;
     readText(relPath: string): string;
     private isInIndependentSubPackage;
@@ -93,6 +97,8 @@ declare class MiniProgram {
  *   2. wcsc 的公共样式运行时 + app.wxss，与每个页面/组件的 __wxAppCode__ wxss（pageStyles）
  *   两部分在热更新时分别下发
  *   样式和模板里的 env(safe-area-inset-*) 改写成 CSS 变量，见 rewriteSafeAreaInsets
+ *
+ * Worker：workers 目录下的 JS 不进逻辑层，同样包装成 define 脚本，由 Worker 入口（server/html.ts 的 workerScript）加载
  */
 
 interface BuildResult {
@@ -100,6 +106,8 @@ interface BuildResult {
     wxConfig: Record<string, any>;
     /** 所有 JS 模块 id（如 "pages/index/index.js"），逻辑层按此顺序加载 define 脚本 */
     modules: string[];
+    /** workers 目录下的 JS 模块 id，Worker 按此顺序加载 define 脚本 */
+    workerModules: string[];
     /** 逻辑层的 $gwx 与 __wxAppCode__ json/wxml，不含 require */
     serviceTemplates: string;
     serviceBootstrap: string;
@@ -154,7 +162,8 @@ declare class AppBuilder {
  *   /__wxa__/setup.js          编译后的 setup 文件
  *   /__wxa__/appservice.html   逻辑层
  *   /__wxa__/webview/<page>.html  渲染层（路径与页面一致，wxml 里的相对资源路径因此能正确解析）
- *   /__wxa__/module/<file>.js  单个业务 JS 模块
+ *   /__wxa__/module/<file>.js  单个业务 JS 模块（含 workers 目录下的）
+ *   /__wxa__/worker.js?id=     Worker 的入口
  *   /__wxa__/service-templates.js、page-templates.js  两层的模板（热更新时重新下发）
  *   /__wxa__/page-styles.js    渲染层的样式（热更新时重新下发）
  *   /__baselib__/*             官方基础库

package/dist/index.js

@@ -226,8 +226,10 @@ var AppBuilder = class {
       ]);
       this.wxmlCache = wxml;
       this.wxssCache = wxss;
-      const workersDir = typeof app.workers === "string" ? app.workers : app.workers?.path;
-      const modules = this.project.listFiles([".js"], workersDir ? [workersDir] : []);
+      const workersDir = this.project.workersDir(app);
+      const inWorkers = (file) => workersDir !== null && file.startsWith(workersDir + "/");
+      const scripts = this.project.listFiles([".js"]);
+      const modules = scripts.filter((file) => !inWorkers(file));
       const serviceTemplates = this.createTemplates(app, units, unitJson, wxml.cut);
       const pageTemplates = this.createTemplates(app, units, unitJson, wxml.full);
       const pageStyles = createStyles(units, wxss);
@@ -241,6 +243,7 @@ var AppBuilder = class {
           subPackages: this.project.subPackages(app)
         }),
         modules,
+        workerModules: scripts.filter(inWorkers),
         serviceTemplates,
         serviceBootstrap: this.createServiceBootstrap(serviceTemplates, units, modules),
         pageFrame: `${pageTemplates}
@@ -262,7 +265,7 @@ ${pageStyles}`,
     const files = this.project.listFiles([".wxml", ".wxs"]).map((f) => "./" + f);
     const components = units.filter((id) => this.project.exists(id + ".wxml")).map((id) => {
       const json = unitJson.get(id);
-      return { path: id, tags: Object.keys({ ...json.usingComponents, ...json.componentGenerics || {} }) };
+      return { path: id, tags: Object.keys({ ...json.usingComponents, ...json.componentGenerics }) };
     });
     const cwd = this.project.root;
     const [full, cut] = await Promise.all([
@@ -355,6 +358,11 @@ var MiniProgram = class {
   subPackages(app) {
     return app.subPackages || app.subpackages || [];
   }
+  /** 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;
+  }
   /** 主包页面 + 分包页面（带 root 前缀） */
   allPages(app) {
     const pages = [...app.pages];
@@ -368,8 +376,8 @@ var MiniProgram = class {
   }
   /** 读取并预处理页面/组件 json，id 不带扩展名 */
   readUnitJson(id, app) {
-    const json = { ...readJsonFile(import_path.default.join(this.root, id + ".json")) || {} };
-    json.usingComponents = { ...json.usingComponents || {} };
+    const json = { ...readJsonFile(import_path.default.join(this.root, id + ".json")) };
+    json.usingComponents = { ...json.usingComponents };
     if (!id.startsWith("miniprogram_npm/") && !this.isInIndependentSubPackage(id, app)) {
       for (const [tag, ref] of Object.entries(app.usingComponents || {})) {
         if (json.usingComponents[tag]) continue;
@@ -436,15 +444,14 @@ var MiniProgram = class {
     return { pages, components };
   }
   /** 列出代码根目录下指定扩展名的文件，返回 posix 风格的相对路径 */
-  listFiles(extensions, excludeDirs = []) {
+  listFiles(extensions) {
     const result = [];
-    const excluded = new Set(excludeDirs.map((dir) => dir.replace(/^\/|\/$/g, "")));
     const walk = (dir, rel) => {
       for (const entry of import_fs.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()) {
-          if (!excluded.has(childRel)) walk(import_path.default.join(dir, entry.name), childRel);
+          walk(import_path.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);
@@ -592,6 +599,22 @@ ${window.disableScroll ? "<style>body{overflow-y:hidden}</style>" : ""}
 </body>
 </html>`;
 }
+function workerScript(build2, baseLib) {
+  const modules = build2.workerModules.map((id) => `/__wxa__/module/${encodeURI(id)}?v=${build2.version}`);
+  const prelude = `var __wxConfig = ${toJs(build2.wxConfig)};
+importScripts('/__wxa__/runtime/worker.js');
+`;
+  if (!baseLib.hasWorker) {
+    const message = `[wxa-runner] \u57FA\u7840\u5E93 ${baseLib.version} \u91CC\u6CA1\u6709 WAWorker.js\uFF0CWorker \u4E0D\u80FD\u8FD0\u884C\u3002\u6362\u7528\u5F00\u53D1\u8005\u5DE5\u5177\u4E0B\u8F7D\u7684\u57FA\u7840\u5E93\uFF0C\u6216\u5347\u7EA7 wxa-runner \u5E26\u4E0A\u65B0\u7684\u5185\u7F6E\u57FA\u7840\u5E93`;
+    return `${prelude}throw new Error(${toJs(message)});
+`;
+  }
+  return `${prelude}var __wxaConsole = self.console;
+importScripts('/__baselib__/WAWorker.js');
+self.console = __wxaConsole;
+importScripts(${modules.map((url) => toJs(url)).join(", ")});
+`;
+}
 function escapeHtml(text) {
   return text.replace(/[&<>"]/g, (ch) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[ch]);
 }
@@ -1133,12 +1156,16 @@ ${error.message}`);
     }));
     app.get(/^\/__wxa__\/module\/(.+\.js)$/, this.withBuild((build2, req, res) => {
       const id = decodeURIComponent(req.params[0]);
-      if (!build2.modules.includes(id)) {
+      if (!build2.modules.includes(id) && !build2.workerModules.includes(id)) {
         res.status(404).type("js").send(`console.error(${JSON.stringify(`[wxa-runner] \u6A21\u5757 ${id} \u4E0D\u5B58\u5728`)})`);
         return;
       }
       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"));
+      res.type("js").send(workerScript(build2, { version: this.baseLib.version, hasWorker }));
+    }));
     app.get("/__wxa__/service-bootstrap.js", this.withBuild((build2, _req, res) => {
       res.type("js").send(build2.serviceBootstrap);
     }));