modelstage 0.0.0-stage → 0.5.28

package/plugins/unity-spine-bundle/lib/lzma-d-min.js

@@ -0,0 +1,34 @@
+// dsh-skip-sensitive: MIT 许可要求保留作者邮箱署名，非敏感信息泄露
+/// lzma-d-min.js —— LZMA 解码器 vendor 件（**已就地打补丁**，见文末「本仓补丁」段）。
+///   上游版本：lzma@2.3.2（精确版本，见 package 名与上方来源行）。
+///   补丁目的：上游把「滑动窗口」与「输出累加器」都建成普通 Array（输出还是 o(32) 起步、
+///     靠索引赋值无限增长），33MB 的解压产物会让 V8 堆多占数百 MB，且峰值随 GC 时机剧烈波动。
+///   补丁内容（三处，逐条见文末）：① 窗口缓冲改 new Uint8Array ② 输出累加器按已知长度预分配
+///     ③ 取结果时用 subarray（typed array 的 length 只读）。
+/// 来源：npm 包 lzma@2.3.2 的 src/lzma-d-min.js（上游产物本身是 IIFE，末尾挂 globalThis.LZMA）。
+/// © 2015 Nathan Rugg <nmrugg@gmail.com> | MIT License（许可全文见同目录 lzma-d-min.LICENSE.txt）。
+/// 为什么加这段：min 版产物里被 minify 掉了版权声明，而 MIT 要求副本保留声明。
+/// 用途：UnityFS 容器里 LZMA 压缩的 blocksInfo / block 数据解码，调用点见 lib/unityfs.js 的 decompress()。
+var e=function(){"use strict";function r(e,r){postMessage({action:nr,cbn:r,result:e})}function o(e){var r=[];return r[e-1]=void 0,r}function n(e,r){return i(e[0]+r[0],e[1]+r[1])}function t(e,r){var o,n;return e[0]==r[0]&&e[1]==r[1]?0:(o=0>e[1],n=0>r[1],o&&!n?-1:!o&&n?1:d(e,r)[1]<0?-1:1)}function i(e,r){var o,n;for(r%=0x10000000000000000,e%=0x10000000000000000,o=r%ir,n=Math.floor(e/ir)*ir,r=r-o+n,e=e-n+o;0>e;)e+=ir,r-=ir;for(;e>4294967295;)e-=ir,r+=ir;for(r%=0x10000000000000000;r>0x7fffffff00000000;)r-=0x10000000000000000;for(;-0x8000000000000000>r;)r+=0x10000000000000000;return[e,r]}function u(e){return e>=0?[e,0]:[e+ir,-ir]}function s(e){return e[0]>=2147483648?~~Math.max(Math.min(e[0]-ir,2147483647),-2147483648):~~Math.max(Math.min(e[0],2147483647),-2147483648)}function d(e,r){return i(e[0]-r[0],e[1]-r[1])}function c(e,r){return e.ab=r,e.cb=0,e.O=r.length,e}function m(e){return e.cb>=e.O?-1:255&e.ab[e.cb++]}function a(e){var n=e.bb>0?e.bb:0;return e.ab=n?new Uint8Array(n):o(32),e.O=0,e}function _(e){var r=e.ab;return r instanceof Uint8Array?r.subarray(0,e.O):(r.length=e.O,r)}function f(e,r,o,n){p(r,o,e.ab,e.O,n),e.O+=n}function p(e,r,o,n,t){for(var i=0;t>i;++i)o[n+i]=e[r+i]}function D(e,r,o){var n,t,i,s,d="",c=[];for(t=0;5>t;++t){if(i=m(r),-1==i)throw Error("truncated input");c[t]=i<<24>>24}if(n=N({}),!z(n,c))throw Error("corrupted input");for(t=0;64>t;t+=8){if(i=m(r),-1==i)throw Error("truncated input");i=i.toString(16),1==i.length&&(i="0"+i),d=i+""+d}/^0+$|^f+$/i.test(d)?e.N=ur:(s=parseInt(d,16),e.N=s>4294967295?ur:u(s)),e.Q=B(n,r,o,e.N)}function l(e,r){return e.S=a({}),D(e,c({},r),e.S),e}function g(e,r,o){var n=e.D-r-1;for(0>n&&(n+=e.c);0!=o;--o)n>=e.c&&(n=0),e.x[e.D++]=e.x[n++],e.D>=e.c&&w(e)}function v(e,r){(null==e.x||e.c!=r)&&(e.x=new Uint8Array(r)),e.c=r,e.D=0,e.w=0}function w(e){var r=e.D-e.w;r&&(f(e.V,e.x,e.w,r),e.D>=e.c&&(e.D=0),e.w=e.D)}function R(e,r){var o=e.D-r-1;return 0>o&&(o+=e.c),e.x[o]}function h(e,r){e.x[e.D++]=r,e.D>=e.c&&w(e)}function P(e){w(e),e.V=null}function C(e){return e-=2,4>e?e:3}function S(e){return 4>e?0:10>e?e-3:e-6}function M(e,r){return e.h=r,e.bb=null,e.X=1,e}function L(e){if(!e.X)throw Error("bad state");if(e.bb)throw Error("No encoding");return y(e),e.X}function y(e){var r=I(e.h);if(-1==r)throw Error("corrupted input");e.$=ur,e.Z=e.h.d,(r||t(e.h.U,sr)>=0&&t(e.h.d,e.h.U)>=0)&&(w(e.h.b),P(e.h.b),e.h.a.K=null,e.X=0)}function B(e,r,o,n){return e.a.K=r,P(e.b),e.b.V=o,b(e),e.f=0,e.l=0,e.T=0,e.R=0,e._=0,e.U=n,e.d=sr,e.I=0,M({},e)}function I(e){var r,o,i,d,c,m;if(m=s(e.d)&e.P,Q(e.a,e.q,(e.f<<4)+m)){if(Q(e.a,e.E,e.f))i=0,Q(e.a,e.s,e.f)?(Q(e.a,e.u,e.f)?(Q(e.a,e.r,e.f)?(o=e._,e._=e.R):o=e.R,e.R=e.T):o=e.T,e.T=e.l,e.l=o):Q(e.a,e.n,(e.f<<4)+m)||(e.f=7>e.f?9:11,i=1),i||(i=x(e.o,e.a,m)+2,e.f=7>e.f?8:11);else if(e._=e.R,e.R=e.T,e.T=e.l,i=2+x(e.C,e.a,m),e.f=7>e.f?7:10,c=q(e.j[C(i)],e.a),c>=4){if(d=(c>>1)-1,e.l=(2|1&c)<<d,14>c)e.l+=J(e.J,e.l-c-1,e.a,d);else if(e.l+=U(e.a,d-4)<<4,e.l+=F(e.t,e.a),0>e.l)return-1==e.l?1:-1}else e.l=c;if(t(u(e.l),e.d)>=0||e.l>=e.m)return-1;g(e.b,e.l,i),e.d=n(e.d,u(i)),e.I=R(e.b,0)}else r=Z(e.k,s(e.d),e.I),e.I=7>e.f?T(r,e.a):$(r,e.a,R(e.b,e.l)),h(e.b,e.I),e.f=S(e.f),e.d=n(e.d,dr);return 0}function N(e){e.b={},e.a={},e.q=o(192),e.E=o(12),e.s=o(12),e.u=o(12),e.r=o(12),e.n=o(192),e.j=o(4),e.J=o(114),e.t=K({},4),e.C=G({}),e.o=G({}),e.k={};for(var r=0;4>r;++r)e.j[r]=K({},6);return e}function b(e){e.b.w=0,e.b.D=0,X(e.q),X(e.n),X(e.E),X(e.s),X(e.u),X(e.r),X(e.J),H(e.k);for(var r=0;4>r;++r)X(e.j[r].B);A(e.C),A(e.o),X(e.t.B),V(e.a)}function z(e,r){var o,n,t,i,u,s,d;if(5>r.length)return 0;for(d=255&r[0],t=d%9,s=~~(d/9),i=s%5,u=~~(s/5),o=0,n=0;4>n;++n)o+=(255&r[1+n])<<8*n;return o>99999999||!W(e,t,i,u)?0:O(e,o)}function O(e,r){return 0>r?0:(e.z!=r&&(e.z=r,e.m=Math.max(e.z,1),v(e.b,Math.max(e.m,4096))),1)}function W(e,r,o,n){if(r>8||o>4||n>4)return 0;E(e.k,o,r);var t=1<<n;return k(e.C,t),k(e.o,t),e.P=t-1,1}function k(e,r){for(;r>e.e;++e.e)e.G[e.e]=K({},3),e.H[e.e]=K({},3)}function x(e,r,o){if(!Q(r,e.M,0))return q(e.G[o],r);var n=8;return n+=Q(r,e.M,1)?8+q(e.L,r):q(e.H[o],r)}function G(e){return e.M=o(2),e.G=o(16),e.H=o(16),e.L=K({},8),e.e=0,e}function A(e){X(e.M);for(var r=0;e.e>r;++r)X(e.G[r].B),X(e.H[r].B);X(e.L.B)}function E(e,r,n){var t,i;if(null==e.F||e.g!=n||e.y!=r)for(e.y=r,e.Y=(1<<r)-1,e.g=n,i=1<<e.g+e.y,e.F=o(i),t=0;i>t;++t)e.F[t]=j({})}function Z(e,r,o){return e.F[((r&e.Y)<<e.g)+((255&o)>>>8-e.g)]}function H(e){var r,o;for(o=1<<e.g+e.y,r=0;o>r;++r)X(e.F[r].v)}function T(e,r){var o=1;do o=o<<1|Q(r,e.v,o);while(256>o);return o<<24>>24}function $(e,r,o){var n,t,i=1;do if(t=o>>7&1,o<<=1,n=Q(r,e.v,(1+t<<8)+i),i=i<<1|n,t!=n){for(;256>i;)i=i<<1|Q(r,e.v,i);break}while(256>i);return i<<24>>24}function j(e){return e.v=o(768),e}function K(e,r){return e.A=r,e.B=o(1<<r),e}function q(e,r){var o,n=1;for(o=e.A;0!=o;--o)n=(n<<1)+Q(r,e.B,n);return n-(1<<e.A)}function F(e,r){var o,n,t=1,i=0;for(n=0;e.A>n;++n)o=Q(r,e.B,t),t<<=1,t+=o,i|=o<<n;return i}function J(e,r,o,n){var t,i,u=1,s=0;for(i=0;n>i;++i)t=Q(o,e,r+u),u<<=1,u+=t,s|=t<<i;return s}function Q(e,r,o){var n,t=r[o];return n=(e.i>>>11)*t,(-2147483648^n)>(-2147483648^e.p)?(e.i=n,r[o]=t+(2048-t>>>5)<<16>>16,-16777216&e.i||(e.p=e.p<<8|m(e.K),e.i<<=8),0):(e.i-=n,e.p-=n,r[o]=t-(t>>>5)<<16>>16,-16777216&e.i||(e.p=e.p<<8|m(e.K),e.i<<=8),1)}function U(e,r){var o,n,t=0;for(o=r;0!=o;--o)e.i>>>=1,n=e.p-e.i>>>31,e.p-=e.i&n-1,t=t<<1|1-n,-16777216&e.i||(e.p=e.p<<8|m(e.K),e.i<<=8);return t}function V(e){e.p=0,e.i=-1;for(var r=0;5>r;++r)e.p=e.p<<8|m(e.K)}function X(e){for(var r=e.length-1;r>=0;--r)e[r]=1024}function Y(e){for(var r,o,n,t=0,i=0,u=e.length,s=[],d=[];u>t;++t,++i){if(r=255&e[t],128&r)if(192==(224&r)){if(t+1>=u)return e;if(o=255&e[++t],128!=(192&o))return e;d[i]=(31&r)<<6|63&o}else{if(224!=(240&r))return e;if(t+2>=u)return e;if(o=255&e[++t],128!=(192&o))return e;if(n=255&e[++t],128!=(192&n))return e;d[i]=(15&r)<<12|(63&o)<<6|63&n}else{if(!r)return e;d[i]=r}16383==i&&(s.push(String.fromCharCode.apply(String,d)),i=-1)}return i>0&&(d.length=i,s.push(String.fromCharCode.apply(String,d))),s.join("")}function er(e){return e[1]+e[0]}function rr(e,o,n){function t(){try{for(var e,r=0,u=(new Date).getTime();L(c.d.Q);)if(++r%1e3==0&&(new Date).getTime()-u>200)return s&&(i=er(c.d.Q.h.d)/d,n(i)),tr(t,0),0;n(1),e=Y(_(c.d.S)),tr(o.bind(null,e),0)}catch(m){o(null,m)}}var i,u,s,d,c={},m=void 0===o&&void 0===n;if("function"!=typeof o&&(u=o,o=n=0),n=n||function(e){return void 0!==u?r(s?e:-1,u):void 0},o=o||function(e,r){return void 0!==u?postMessage({action:or,cbn:u,result:e,error:r}):void 0},m){c.d=l({},e);var dd=er(c.d.N);dd>0&&(c.d.S.bb=dd,c.d.S.ab=new Uint8Array(dd));for(;L(c.d.Q););return Y(_(c.d.S))}try{c.d=l({},e),d=er(c.d.N),s=d>-1,s&&d>0&&(c.d.S.bb=d,c.d.S.ab=new Uint8Array(d)),n(0)}catch(a){return o(null,a)}tr(t,0)}var or=2,nr=3,tr="function"==typeof setImmediate?setImmediate:setTimeout,ir=4294967296,ur=[4294967295,-ir],sr=[0,0],dr=[1,0];return"undefined"==typeof onmessage||"undefined"!=typeof window&&void 0!==window.document||!function(){onmessage=function(r){r&&r.W&&r.W.action==or&&e.decompress(r.W.W,r.W.cbn)}}(),{decompress:rr}}();this.LZMA=this.LZMA_WORKER=e;
+
+/* ============================================================================
+ * 本仓补丁（相对 lzma@2.3.2 的 src/lzma-d-min.js），共 3 处：
+ *
+ * ① function v(e,r){…e.x=o(r)…}                      → e.x=new Uint8Array(r)
+ *    滑动窗口只做 e.x[i]=… 与 e.x[i] 读取，换成 typed array 语义不变。
+ *
+ * ② 输出累加器 ab 改为"按 alone 头声明的未压缩长度预分配"：
+ *    · rr() 的**两条分支都要打**（踩过：只打异步分支 ⇒ 单参数调用走同步分支、补丁完全没生效）：
+ *        · 同步分支（形如 `,m){for(c.d=l({},e);L(c.d.Q););return Y(_(c.d.S))}`）：
+ *          `,m){c.d=l({},e);var dd=er(c.d.N);dd>0&&(c.d.S.bb=dd,c.d.S.ab=new Uint8Array(dd));for(;L(c.d.Q););return Y(_(c.d.S))}`
+ *        · 异步分支：`d=er(c.d.N),s=d>-1` 之后 `c.d.S.bb=d,c.d.S.ab=new Uint8Array(d)`
+ *    · a() 改成 `e.ab = e.bb>0 ? new Uint8Array(e.bb) : o(32)`（bb 是长度提示，不清除）
+ *    为什么要两处：只赋值 ab 会被后续 a() 重置回 o(32)（实测：补丁后 decompress 仍返回普通 Array，
+ *    heap 341MB）；把长度提示存到对象上，之后无论 a() 被调几次都还是 typed array。
+ *    写满即止（越界写被 typed array 静默丢弃，解码长度另有 unityfs.js 二次校验，不会静默截断）。
+ *
+ * ③ function _(e){var r=e.ab;return r.length=e.O,r}   → 对 Uint8Array 用 subarray(0,e.O)
+ *    typed array 的 length 是只读属性，直接赋值会被忽略。
+ *
+ * 逐字节一致性：换实现前后对 61 个真实 LZMA 包做 sha256 全量比对，全部相同。
+ * ========================================================================== */

package/plugins/unity-spine-bundle/lib/png.js

@@ -0,0 +1,424 @@
+// ============================================================================
+// plugins/unity-live2d-bundle/lib/png.js —— RGBA ⇄ PNG（编码 + 解码/比对）
+//
+// 两个用途：
+//   ① 编码：把解出的 RGBA 写成 PNG（给页面 <img> 或下载用）。**零依赖**实现：
+//      zlib 流用「stored（未压缩）deflate 块」拼出来，只算 adler32/crc32，不需要压缩库。
+//   ② 解码 + 比对：把参考 PNG 读成 RGBA，与本地解码结果逐像素比对（自检用）。
+//      inflate 不可自带，按环境注入：Node 用 node:zlib（setInflate），
+//      浏览器用 DecompressionStream('deflate')（现代 Chrome 自带），两处都不可用则抛可读错误。
+//
+// 支持范围（够用即可，不做通用图片库）：8 位深、颜色类型 0/2/4/6、过滤方式 0..4，隔行扫描不支持（抛错）。
+//
+// 挂载：globalThis.__ULB__.png
+// ============================================================================
+
+'use strict';
+
+{
+  const root = globalThis;   // 原 IIFE 的 root 引用（脚本级裸块内保持同名）
+  const NS = (root.__ULB__ = root.__ULB__ || {});
+  const B = NS.bytes;
+
+  // ---------------------------------------------------------------- CRC32 / Adler32
+  const CRC_TABLE = (() => {
+    const t = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+      let c = n;
+      for (let k = 0; k < 8; k++) c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+      t[n] = c >>> 0;
+    }
+    return t;
+  })();
+
+  function crc32(u8) {
+    let c = 0xffffffff;
+    for (let i = 0; i < u8.length; i++) c = CRC_TABLE[(c ^ u8[i]) & 0xff] ^ (c >>> 8);
+    return (c ^ 0xffffffff) >>> 0;
+  }
+
+  /**
+   * 增量 CRC32：对多个片段**连续**计算（PNG 的 CRC 覆盖 "类型 + 数据"）。
+   * 为什么不先拼再算：IDAT 数据动辄 18MB，拼一次就是一次全量拷贝 —— 而 CRC 本身就是流式的。
+   * @param {Array<Uint8Array>} parts
+   * @returns {number}
+   */
+  function crc32OfParts(parts) {
+    let c = 0xffffffff;
+    for (const u8 of parts) {
+      for (let i = 0; i < u8.length; i++) c = CRC_TABLE[(c ^ u8[i]) & 0xff] ^ (c >>> 8);
+    }
+    return (c ^ 0xffffffff) >>> 0;
+  }
+
+  function adler32(u8) {
+    let a = 1;
+    let b = 0;
+    for (let i = 0; i < u8.length; i++) {
+      a = (a + u8[i]) % 65521;
+      b = (b + a) % 65521;
+    }
+    return ((b << 16) | a) >>> 0;
+  }
+
+  // ---------------------------------------------------------------- 编码
+  function chunk(type, data) {
+    const out = new Uint8Array(12 + data.length);
+    const dv = new DataView(out.buffer);
+    dv.setUint32(0, data.length);
+    for (let i = 0; i < 4; i++) out[4 + i] = type.charCodeAt(i);
+    out.set(data, 8);
+    const crcBuf = new Uint8Array(4 + data.length);
+    crcBuf.set(out.subarray(4, 8), 0);
+    crcBuf.set(data, 4);
+    dv.setUint32(8 + data.length, crc32(crcBuf));
+    return out;
+  }
+
+  /** deflate 的 stored（无压缩）块序列 + zlib 头/adler32 */
+  function zlibStored(u8) {
+    const MAX = 65535;
+    const blocks = Math.max(1, Math.ceil(u8.length / MAX));
+    const parts = [new Uint8Array([0x78, 0x01])];
+    for (let i = 0; i < blocks; i++) {
+      const slice = u8.subarray(i * MAX, Math.min(u8.length, (i + 1) * MAX));
+      const last = i === blocks - 1 ? 1 : 0;
+      const head = new Uint8Array(5);
+      head[0] = last;
+      const len = slice.length;
+      head[1] = len & 0xff;
+      head[2] = (len >> 8) & 0xff;
+      head[3] = (~len) & 0xff;
+      head[4] = ((~len) >> 8) & 0xff;
+      parts.push(head, slice);
+    }
+    const ad = new Uint8Array(4);
+    new DataView(ad.buffer).setUint32(0, adler32(u8));
+    parts.push(ad);
+    return B.concatBytes(parts);
+  }
+
+  /**
+   * RGBA → PNG 字节。
+   * @param {Uint8Array} rgba
+   * @param {number} width
+   * @param {number} height
+   */
+  function encodePng(rgba, width, height) {
+    const stride = width * 4;
+    const raw = new Uint8Array((stride + 1) * height);
+    for (let y = 0; y < height; y++) {
+      raw[y * (stride + 1)] = 0;   // 过滤方式 0（None）
+      raw.set(rgba.subarray(y * stride, (y + 1) * stride), y * (stride + 1) + 1);
+    }
+    const ihdr = new Uint8Array(13);
+    const dv = new DataView(ihdr.buffer);
+    dv.setUint32(0, width);
+    dv.setUint32(4, height);
+    ihdr[8] = 8;    // 位深
+    ihdr[9] = 6;    // 颜色类型 RGBA
+    ihdr[10] = 0;   // 压缩方式
+    ihdr[11] = 0;   // 过滤方式
+    ihdr[12] = 0;   // 非隔行
+    const sig = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+    return B.concatBytes([sig, chunk('IHDR', ihdr), chunk('IDAT', zlibStored(raw)), chunk('IEND', new Uint8Array(0))]);
+  }
+
+  /**
+   * RGBA → PNG 字节（**压缩**版，异步）。
+   *
+   * 为什么需要压缩版：stored（不压缩）的 PNG 会膨胀到 67 MB（4096² 的 RGBA），
+   *   页面在「解码 ETC2 → 64MB RGBA → 67MB PNG」之间会同时占用上百兆，
+   *   实测会触发浏览器图像解码失败（表现为加载器的 "Texture loading error"）。
+   *   压缩后约 6 MB（与参考导出件同量级），内存与解码耗时都降一个数量级。
+   *
+   * deflate 来源：浏览器用 CompressionStream('deflate')（产出 zlib 流，正好是 IDAT 需要的格式）；
+   *   Node 侧由调用方注入（调用方在需要时 setDeflate）。都没有时退回 stored 版本（仍可用，只是更大）。
+   */
+  let deflateImpl = null;
+  function setDeflate(fn) { deflateImpl = fn; }
+
+  /**
+   * 流式 deflate 注入（Node 侧注入 zlib.createDeflate 版本）。
+   * 为什么不直接用 deflateImpl：那是一次性接口（吃整块、吐整块），
+   *   而整块 = 4096² 的"过滤后扫描线"67MB + 一次全量拷贝 67MB（`Buffer.from`）。
+   *   给一个**吃块迭代器**的接口，编码器就能按行块喂，全程不造整张。
+   * @param {(chunks: Iterable<Uint8Array>) => Promise<Uint8Array>} fn
+   */
+  let deflateStreamImpl = null;
+  function setDeflateStream(fn) { deflateStreamImpl = fn; }
+
+  /** 每块的扫描行数：64 行 ≈ 4096² 时 1MB/块（够大能摊掉调用开销，够小不会造出第二张整图的量级） */
+  const STREAM_ROWS = 64;
+
+  /**
+   * 把「过滤后的扫描线」切成小块逐个喂给 deflate，返回完整 zlib 流。
+   *
+   * 关键前提（已实测，见工具输出）：分块 write 与一次性 deflateSync 产出的 zlib 流**逐字节相同**
+   *   —— 只要不调 flush()，deflate 的切分对输出无影响（块大小 2B / 64KB / 1MB 都验过）。
+   *   所以这条路径不会改变 PNG 产物。
+   * @param {Uint8Array} rgba 源像素（整张，LZ4 解码产物，这部分省不掉）
+   * @param {number} width
+   * @param {number} height
+   * @returns {Promise<{chunks: Uint8Array[], length: number}>} zlib 流的**片段**（不拼接：拼接是调用方在一次预分配里做的）
+   */
+  async function deflateScanlines(rgba, width, height) {
+    const stride = width * 4;
+    /** 生成"每 64 行一块"的 [0, row..., 0, row...] 缓冲区（过滤方式 None） */
+    function* blocks() {
+      for (let y0 = 0; y0 < height; y0 += STREAM_ROWS) {
+        const rows = Math.min(STREAM_ROWS, height - y0);
+        const chunk = new Uint8Array((stride + 1) * rows);
+        for (let r = 0; r < rows; r++) {
+          const y = y0 + r;
+          chunk[r * (stride + 1)] = 0;                                  // 过滤方式 0（None）
+          chunk.set(rgba.subarray(y * stride, (y + 1) * stride), r * (stride + 1) + 1);
+        }
+        yield chunk;
+      }
+    }
+
+    if (deflateStreamImpl) return normalizeChunks(await deflateStreamImpl(blocks()));
+
+    // 浏览器：CompressionStream 也能流式写（先挂上读取再写，避免背压死锁）
+    const CS = root.CompressionStream;
+    if (CS) {
+      const cs = new CS('deflate');
+      const writer = cs.writable.getWriter();
+      const collected = new Response(cs.readable).arrayBuffer();   // 先启动读取
+      for (const chunk of blocks()) await writer.write(chunk);
+      await writer.close();
+      // CompressionStream 只给整体缓冲，拿不到分段 ⇒ 单片段返回（内存上仍是"一份"）
+      return normalizeChunks([new Uint8Array(await collected)]);
+    }
+
+    // 兜底：没有流式能力 ⇒ 退回一次性（拼起来只是为了拿 stored 版本，仍正确）
+    const parts = []; let total = 0;
+    for (const chunk of blocks()) { parts.push(chunk); total += chunk.length; }
+    const raw = new Uint8Array(total);
+    let off = 0;
+    for (const part of parts) { raw.set(part, off); off += part.length; }
+    return normalizeChunks([zlibStored(raw)]);
+  }
+
+  /** 统一成「片段数组 + 总长」（注入实现可能返回数组或单块） */
+  function normalizeChunks(v) {
+    const chunks = Array.isArray(v) ? v : [v];
+    let length = 0;
+    for (const c of chunks) length += c.length;
+    return { chunks, length };
+  }
+
+  async function deflateCompress(u8) {
+    if (deflateImpl) return deflateImpl(u8);
+    const CS = root.CompressionStream;
+    if (CS) {
+      const cs = new CS('deflate');
+      const stream = new Blob([u8]).stream().pipeThrough(cs);
+      return new Uint8Array(await new Response(stream).arrayBuffer());
+    }
+    return zlibStored(u8);
+  }
+
+  async function encodePngAsync(rgba, width, height) {
+    // 流式：按 64 行一块喂 deflate，**不构造整张"过滤后扫描线"**（4096² 时那是 67MB），
+    //   也不再把它转成 Buffer（`Buffer.from` 是又一次 67MB 全量拷贝）。
+    //   产物与旧实现**逐字节相同**（分块不影响 deflate 输出，已实测三种块大小）。
+    const ihdr = new Uint8Array(13);
+    const dv = new DataView(ihdr.buffer);
+    dv.setUint32(0, width);
+    dv.setUint32(4, height);
+    ihdr[8] = 8;
+    ihdr[9] = 6;
+    const sig = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+    const { chunks, length } = await deflateScanlines(rgba, width, height);
+    return assemblePng(sig, ihdr, chunks, length);
+  }
+
+  const IHDR_TAG = new Uint8Array([0x49, 0x48, 0x44, 0x52]);   // 'IHDR'
+  const IDAT_TAG = new Uint8Array([0x49, 0x44, 0x41, 0x54]);   // 'IDAT'
+  const IEND_TAIL = new Uint8Array([0x00, 0x00, 0x00, 0x00, 0x49, 0x45, 0x4e, 0x44, 0xae, 0x42, 0x60, 0x82]); // 长度0 + 'IEND' + 固定 CRC
+
+  /**
+   * 一次分配最终 PNG 并逐段写入。
+   *
+   * 为什么不再走「chunk() 造 IDAT + concatBytes 汇总」那套：
+   *   那会为 IDAT 额外分配两次（chunk 的输出 + CRC 用的 crcBuf）+ 汇总再复制一次，
+   *   单张 4096² 的 IDAT 约 18MB ⇒ 白扔 3 份 18MB。
+   *   这里总长已知（deflate 片段收完就有 length），所以只分配一次，
+   *   单 IDAT 形态**不变** ⇒ 产物逐字节不变。
+   * @param {Uint8Array} sig 8 字节签名
+   * @param {Uint8Array} ihdr 13 字节图像头
+   * @param {Uint8Array[]} chunks deflate 输出片段
+   * @param {number} length 片段总长
+   */
+  function assemblePng(sig, ihdr, chunks, length) {
+    // sig(8) + IHDR(4+4+13+4) + IDAT(4+4+length+4) + IEND(12)
+    const png = new Uint8Array(8 + 25 + (12 + length) + 12);
+    const dv = new DataView(png.buffer);
+    let o = 0;
+    png.set(sig, o); o += 8;
+    // IHDR
+    dv.setUint32(o, 13); o += 4;
+    png.set(IHDR_TAG, o); o += 4;
+    png.set(ihdr, o); o += 13;
+    dv.setUint32(o, crc32OfParts([IHDR_TAG, ihdr])); o += 4;
+    // IDAT（单块：长度 + 类型 + 数据 + CRC；CRC 对"类型+数据"增量算）
+    dv.setUint32(o, length); o += 4;
+    png.set(IDAT_TAG, o); o += 4;
+    for (const c of chunks) { png.set(c, o); o += c.length; }
+    dv.setUint32(o, crc32OfParts([IDAT_TAG, ...chunks])); o += 4;
+    // IEND（长度 0 + 'IEND' + 固定 CRC）
+    png.set(IEND_TAIL, o);
+    return png;
+  }
+
+  // ---------------------------------------------------------------- 解码
+  let inflateImpl = null;
+  /** 注入 inflate（Node：node:zlib 的 inflateSync） */
+  function setInflate(fn) { inflateImpl = fn; }
+
+  async function inflate(zlibBytes) {
+    if (inflateImpl) return inflateImpl(zlibBytes);
+    const DS = root.DecompressionStream;
+    if (DS) {
+      const ds = new DS('deflate');
+      const stream = new Blob([zlibBytes]).stream().pipeThrough(ds);
+      const buf = await new Response(stream).arrayBuffer();
+      return new Uint8Array(buf);
+    }
+    throw NS.errors.fail('ULB_ERR_TEX_DECODE', '当前环境没有 inflate 实现（Node 请注入 node:zlib；浏览器需支持 DecompressionStream）');
+  }
+
+  /**
+   * 解 PNG → { rgba, width, height }。
+   * @param {Uint8Array} u8 PNG 字节
+   */
+  async function decodePng(u8) {
+    const sig = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
+    for (let i = 0; i < 8; i++) if (u8[i] !== sig[i]) throw NS.errors.fail('ULB_ERR_TEX_DECODE', '不是 PNG（签名不符）');
+    // PNG 的块长度与字段都是**大端**（与 Unity 的小端相反，这里必须换读法）
+    const r = new B.Reader(u8, { pos: 8, endian: '>' });
+    let width = 0;
+    let height = 0;
+    let bitDepth = 0;
+    let colorType = 0;
+    let interlace = 0;
+    const idat = [];
+    let palette = null;
+    for (;;) {
+      const len = r.u32();
+      const type = B.latin1(r.bytes(4), 0, 4);
+      const data = r.bytes(len);
+      r.skip(4); // CRC
+      if (type === 'IHDR') {
+        width = (data[0] << 24) | (data[1] << 16) | (data[2] << 8) | data[3];
+        height = (data[4] << 24) | (data[5] << 16) | (data[6] << 8) | data[7];
+        bitDepth = data[8];
+        colorType = data[9];
+        interlace = data[12];
+      } else if (type === 'PLTE') {
+        palette = data;
+      } else if (type === 'IDAT') {
+        idat.push(data);
+      } else if (type === 'IEND') {
+        break;
+      }
+    }
+    if (bitDepth !== 8) throw NS.errors.fail('ULB_ERR_TEX_DECODE', `暂只支持 8 位深 PNG，实际 ${bitDepth}`);
+    if (interlace !== 0) throw NS.errors.fail('ULB_ERR_TEX_DECODE', '暂不支持隔行扫描 PNG');
+    const channels = colorType === 0 ? 1 : colorType === 2 ? 3 : colorType === 4 ? 2 : colorType === 6 ? 4 : 0;
+    if (!channels && colorType !== 3) throw NS.errors.fail('ULB_ERR_TEX_DECODE', `暂不支持的颜色类型 ${colorType}`);
+    const raw = await inflate(B.concatBytes(idat));
+    const bpp = colorType === 3 ? 1 : channels;
+    const stride = width * bpp;
+    const img = new Uint8Array(height * stride);
+    let pos = 0;
+    for (let y = 0; y < height; y++) {
+      const filter = raw[pos++];
+      const line = raw.subarray(pos, pos + stride);
+      pos += stride;
+      const out = img.subarray(y * stride, (y + 1) * stride);
+      const prev = y > 0 ? img.subarray((y - 1) * stride, y * stride) : null;
+      for (let i = 0; i < stride; i++) {
+        const a = i >= bpp ? out[i - bpp] : 0;
+        const b = prev ? prev[i] : 0;
+        const c = prev && i >= bpp ? prev[i - bpp] : 0;
+        let v = line[i];
+        if (filter === 1) v += a;
+        else if (filter === 2) v += b;
+        else if (filter === 3) v += (a + b) >> 1;
+        else if (filter === 4) {
+          const p = a + b - c;
+          const pa = Math.abs(p - a);
+          const pb = Math.abs(p - b);
+          const pc = Math.abs(p - c);
+          v += (pa <= pb && pa <= pc) ? a : (pb <= pc ? b : c);
+        }
+        out[i] = v & 0xff;
+      }
+    }
+    // 统一成 RGBA
+    const rgba = new Uint8Array(width * height * 4);
+    for (let y = 0; y < height; y++) {
+      for (let x = 0; x < width; x++) {
+        const di = (y * width + x) * 4;
+        if (colorType === 6) {
+          const si = y * stride + x * 4;
+          rgba[di] = img[si]; rgba[di + 1] = img[si + 1]; rgba[di + 2] = img[si + 2]; rgba[di + 3] = img[si + 3];
+        } else if (colorType === 2) {
+          const si = y * stride + x * 3;
+          rgba[di] = img[si]; rgba[di + 1] = img[si + 1]; rgba[di + 2] = img[si + 2]; rgba[di + 3] = 255;
+        } else if (colorType === 0) {
+          const v = img[y * stride + x];
+          rgba[di] = v; rgba[di + 1] = v; rgba[di + 2] = v; rgba[di + 3] = 255;
+        } else if (colorType === 4) {
+          const si = y * stride + x * 2;
+          const v = img[si];
+          rgba[di] = v; rgba[di + 1] = v; rgba[di + 2] = v; rgba[di + 3] = img[si + 1];
+        } else {   // 调色板
+          const idx = img[y * stride + x];
+          rgba[di] = palette[idx * 3]; rgba[di + 1] = palette[idx * 3 + 1]; rgba[di + 2] = palette[idx * 3 + 2];
+          rgba[di + 3] = palette.length > idx * 3 + 3 ? palette[idx * 3 + 3] : 255;
+        }
+      }
+    }
+    return { rgba, width, height, colorType, bitDepth };
+  }
+
+  /**
+   * 与一张参考 PNG 逐像素比对。
+   * @returns {Promise<{diffPixels:number, maxChannelDiff:number, expectedWidth:number, expectedHeight:number, mismatchSample:Array}>}
+   */
+  async function compareWithPng(rgba, width, height, pngBytes) {
+    const ref = await decodePng(pngBytes instanceof Uint8Array ? pngBytes : new Uint8Array(pngBytes));
+    if (ref.width !== width || ref.height !== height) {
+      return { diffPixels: width * height, maxChannelDiff: 255, expectedWidth: ref.width, expectedHeight: ref.height, sizeMismatch: true, mismatchSample: [] };
+    }
+    let diff = 0;
+    let maxDiff = 0;
+    const sample = [];
+    for (let i = 0; i < width * height; i++) {
+      const o = i * 4;
+      const d0 = Math.abs(rgba[o] - ref.rgba[o]);
+      const d1 = Math.abs(rgba[o + 1] - ref.rgba[o + 1]);
+      const d2 = Math.abs(rgba[o + 2] - ref.rgba[o + 2]);
+      const d3 = Math.abs(rgba[o + 3] - ref.rgba[o + 3]);
+      const m = Math.max(d0, d1, d2, d3);
+      if (m > 0) {
+        diff++;
+        if (m > maxDiff) maxDiff = m;
+        if (sample.length < 8) {
+          sample.push({
+            pixel: i, xy: [i % width, Math.floor(i / width)],
+            ours: [rgba[o], rgba[o + 1], rgba[o + 2], rgba[o + 3]],
+            ref: [ref.rgba[o], ref.rgba[o + 1], ref.rgba[o + 2], ref.rgba[o + 3]],
+          });
+        }
+      }
+    }
+    return { diffPixels: diff, maxChannelDiff: maxDiff, expectedWidth: ref.width, expectedHeight: ref.height, mismatchSample: sample };
+  }
+
+  NS.png = { encodePng, encodePngAsync, decodePng, compareWithPng, setInflate, setDeflate, setDeflateStream, crc32, adler32, zlibStored };
+}