@open-wxa/wxa-runner-core 0.4.1 → 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,12 +162,13 @@ 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__/*             官方基础库
  *   /__wxa__/proxy?url=        网络代理
- *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址；对该地址 HEAD 查大小、DELETE 删除
+ *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
  *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
  *   /__wxa__/api/*             真实登录（--real-login）：wx.login 的 code、手机号，只允许本机访问
  *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）

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,12 +162,13 @@ 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__/*             官方基础库
  *   /__wxa__/proxy?url=        网络代理
- *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址；对该地址 HEAD 查大小、DELETE 删除
+ *   /__wxa__/tmp               临时文件：POST ?type=png 保存，返回可直接访问的地址（GET 支持分段请求）；对该地址 HEAD 查大小、DELETE 删除
  *   /__wxa__/region/<kind>     地区选择器用的行政区划数据（districts / streets），取自本机开发者工具
  *   /__wxa__/api/*             真实登录（--real-login）：wx.login 的 code、手机号，只允许本机访问
  *   /__wxa__/ws                文件变化通知：热更新（hot）或整页刷新（reload）

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);
@@ -565,6 +572,9 @@ function webviewHtml(build2, pagePath, webviewId, options) {
 <!-- \u771F\u673A\u7684\u6EDA\u52A8\u6761\u662F\u4E0D\u5360\u5E03\u5C40\u7684\u6D6E\u5C42\uFF1B\u684C\u9762\u6D4F\u89C8\u5668\u7684\u5E38\u89C4\u6EDA\u52A8\u6761\u548C\u81EA\u5B9A\u4E49 ::-webkit-scrollbar \u4F1A\u6324\u7A84\u9875\u9762\uFF0C\u4E00\u5F8B\u9690\u85CF\u3002
      scrollbar-width \u4F18\u5148\u4E8E ::-webkit-scrollbar\uFF0C\u9875\u9762\u6837\u5F0F\u4E0D\u4F1A\u518D\u628A\u6EDA\u52A8\u6761\u52A0\u56DE\u6765 -->
 <style>*{scrollbar-width:none}::-webkit-scrollbar{display:none}</style>
+<!-- \u903B\u8F91\u5C42\u5EFA\u7684 2d\u3001webgl \u753B\u5E03\u642C\u8FDB wx-canvas \u540E\u94FA\u6EE1\u5B83\uFF08\u89C1 frame.ts \u7684 moveCanvasesIntoPages\uFF09\u3002
+     \u57FA\u7840\u5E93\u8FD8\u4F1A\u6309\u903B\u8F91\u5C42\u91CC\u7684\u5E03\u5C40\u6539\u5B83\u7684\u4F4D\u7F6E\u548C\u663E\u9690\uFF0C\u8FD9\u91CC\u4E00\u5F8B\u538B\u4F4F\uFF1B\u89E6\u6478\u7167\u5E38\u4EA4\u7ED9 wx-canvas \u81EA\u5DF1\u7684 canvas -->
+<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>
@@ -589,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]);
 }
@@ -1130,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);
     }));
@@ -1191,7 +1221,22 @@ ${error.message}`);
         res.status(404).end();
         return;
       }
-      res.type(import_path4.default.extname(req.params.name)).send(data);
+      res.type(import_path4.default.extname(req.params.name));
+      res.setHeader("ETag", `"${req.params.name}"`);
+      res.setHeader("Accept-Ranges", "bytes");
+      const ranges = req.range(data.length);
+      if (ranges === -1) {
+        res.status(416).setHeader("Content-Range", `bytes */${data.length}`);
+        res.end();
+        return;
+      }
+      if (Array.isArray(ranges) && ranges.type === "bytes" && ranges.length === 1) {
+        const { start, end } = ranges[0];
+        res.status(206).setHeader("Content-Range", `bytes ${start}-${end}/${data.length}`);
+        res.send(data.subarray(start, end + 1));
+        return;
+      }
+      res.send(data);
     });
     app.delete("/__wxa__/tmp/:name", (req, res) => {
       res.status(this.tempFiles.delete(req.params.name) ? 204 : 404).end();