Initial commit

assets/js/README.md

@@ -0,0 +1,29 @@
+# assets/js
+
+## cheerio.min.js
+
+打包好的 [cheerio](https://github.com/cheeriojs/cheerio)（含 parse5 解析器），注入到
+fjs（QuickJS）脚本组件运行环境，作为 `Widget.html.load` / `Widget.dom.*` 的实现。
+上游 ForwardWidgets 宿主的约定就是 "Widget has built-in cheerio"，脚本以同步
+cheerio API 消费 DOM——fjs 的 Dart 桥（`fjs.bridge_call`）只有异步 Promise 形态，
+因此 DOM 解析必须完整运行在 JS 侧，不能走宿主桥。
+
+全局导出名：`__fjsCheerio`（`__fjsCheerio.load(html)`）。bundle 头部带一个 `atob`
+polyfill（`entities` 包解码实体表需要，QuickJS 没有内置 atob/Buffer）。
+
+### 重新构建
+
+```bash
+mkdir /tmp/cheerio-bundle && cd /tmp/cheerio-bundle
+npm install cheerio@1.1.2 esbuild
+echo "export { load } from 'cheerio';" > entry.js
+npx esbuild entry.js --bundle --format=iife --global-name=__fjsCheerio \
+  --platform=browser --minify --banner:js="$(cat banner.js)" \
+  --outfile=cheerio.min.js
+```
+
+`banner.js` 为 atob polyfill，内容见当前 bundle 文件头部（第 1 段
+`if (typeof globalThis.atob === 'undefined')`）。`--platform=browser` 会选择
+cheerio 的 browser 入口（只含 load/parse，不含依赖 Buffer/undici 的
+loadBuffer/fromURL）。构建后用一个无 Node 全局的裸 `vm` 沙箱冒烟验证
+`load/text/attr/closest/Array.from` 再提交。