@awacloud/fw 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (609) hide show
  1. package/CHANGELOG.md +125 -0
  2. package/NOTICE +8 -0
  3. package/README.md +163 -31
  4. package/dist/build/fw.core.pure.meta.json +6 -6
  5. package/dist/build/fw.core.pure.min.js +15 -12
  6. package/dist/build/fw.full.pure.meta.json +13 -7
  7. package/dist/build/fw.full.pure.min.js +45 -42
  8. package/dist/build/fw.minimal.pure.meta.json +6 -6
  9. package/dist/build/fw.minimal.pure.min.js +16 -13
  10. package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
  11. package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
  12. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
  13. package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
  14. package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
  15. package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
  16. package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
  17. package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
  18. package/dist/build/fw.pwa.pure.meta.json +7 -6
  19. package/dist/build/fw.pwa.pure.min.js +38 -35
  20. package/dist/build/fw.site-interactive.pure.meta.json +6 -6
  21. package/dist/build/fw.site-interactive.pure.min.js +37 -34
  22. package/dist/build/fw.site.pure.meta.json +6 -6
  23. package/dist/build/fw.site.pure.min.js +24 -21
  24. package/dist/build/fw.spa.pure.meta.json +8 -7
  25. package/dist/build/fw.spa.pure.min.js +41 -38
  26. package/dist/build/sanity-base-classic.min.js +1 -1
  27. package/dist/build/sanity.min.js +1 -1
  28. package/dist/types/core/internal.d.ts +29 -0
  29. package/dist/types/core/internal.d.ts.map +1 -0
  30. package/dist/types/core/logger.d.ts +23 -4
  31. package/dist/types/core/logger.d.ts.map +1 -1
  32. package/dist/types/core/modules.d.ts +374 -61
  33. package/dist/types/core/modules.d.ts.map +1 -1
  34. package/dist/types/core/runtime.d.ts +10 -6
  35. package/dist/types/core/runtime.d.ts.map +1 -1
  36. package/dist/types/core/worker-helper.d.ts +35 -0
  37. package/dist/types/core/worker-helper.d.ts.map +1 -1
  38. package/dist/types/crypto/cipher/aes.d.ts +1 -7
  39. package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
  40. package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
  41. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
  42. package/dist/types/crypto/hash/argon2.d.ts +0 -15
  43. package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
  44. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
  45. package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
  46. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
  47. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
  48. package/dist/types/crypto/hash/sha224.d.ts +1 -1
  49. package/dist/types/crypto/hash/sha256.d.ts +4 -13
  50. package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
  51. package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
  52. package/dist/types/crypto/hash/sha384.d.ts +1 -1
  53. package/dist/types/crypto/hash/sha512.d.ts +4 -13
  54. package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
  55. package/dist/types/crypto/mode/cmac.d.ts +0 -6
  56. package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
  57. package/dist/types/crypto/mode/ctr.d.ts +0 -6
  58. package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
  59. package/dist/types/crypto/mode/gcm.d.ts +0 -9
  60. package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
  61. package/dist/types/crypto/pkc/ecc.d.ts +0 -1
  62. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
  63. package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
  64. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
  65. package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
  66. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
  67. package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
  68. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
  69. package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
  70. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
  71. package/dist/types/crypto/pkc/rsa.d.ts +0 -24
  72. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
  73. package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
  74. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
  75. package/dist/types/crypto/pkc/x25519.d.ts +0 -6
  76. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
  77. package/dist/types/crypto/utils/bitArray.d.ts +0 -8
  78. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
  79. package/dist/types/crypto/utils/jws.d.ts +6 -14
  80. package/dist/types/crypto/utils/jws.d.ts.map +1 -1
  81. package/dist/types/crypto/utils/keyformat.d.ts +52 -0
  82. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
  83. package/dist/types/crypto/utils/random.d.ts +1 -10
  84. package/dist/types/crypto/utils/random.d.ts.map +1 -1
  85. package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
  86. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
  87. package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
  88. package/dist/types/crypto/utils/x509.d.ts +397 -0
  89. package/dist/types/crypto/utils/x509.d.ts.map +1 -0
  90. package/dist/types/crypto/wasm/argon2.d.ts +2 -1
  91. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
  92. package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
  93. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
  94. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
  95. package/dist/types/crypto/wasm/runtime.d.ts +13 -0
  96. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
  97. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
  98. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
  99. package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
  100. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
  101. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
  102. package/dist/types/dom/fs/fileIntake.d.ts +59 -0
  103. package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
  104. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
  105. package/dist/types/dom/query/dnd.d.ts.map +1 -1
  106. package/dist/types/dom/query/sound.d.ts +89 -0
  107. package/dist/types/dom/query/sound.d.ts.map +1 -0
  108. package/dist/types/dom/rendering/chart.d.ts.map +1 -1
  109. package/dist/types/dom/rendering/component.d.ts +9 -3
  110. package/dist/types/dom/rendering/component.d.ts.map +1 -1
  111. package/dist/types/dom/rendering/parser.d.ts +39 -0
  112. package/dist/types/dom/rendering/parser.d.ts.map +1 -1
  113. package/dist/types/dom/rendering/render.d.ts.map +1 -1
  114. package/dist/types/dom/rendering/sanitize.d.ts +4 -0
  115. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
  116. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
  117. package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
  118. package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
  119. package/dist/types/dom/rendering/template.d.ts +9 -3
  120. package/dist/types/dom/rendering/template.d.ts.map +1 -1
  121. package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
  122. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
  123. package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
  124. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
  125. package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
  126. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
  127. package/dist/types/dom/rendering/uiSession.d.ts +18 -6
  128. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
  129. package/dist/types/dom/sw/installPrompt.d.ts +89 -0
  130. package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
  131. package/dist/types/dom/sw/precache.d.ts +149 -0
  132. package/dist/types/dom/sw/precache.d.ts.map +1 -0
  133. package/dist/types/dom/sw/swUpdate.d.ts +129 -0
  134. package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
  135. package/dist/types/dom/utils/clipboard.d.ts +8 -0
  136. package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
  137. package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
  138. package/dist/types/dom/utils/route.d.ts.map +1 -1
  139. package/dist/types/dom/utils/ua.d.ts +2 -2
  140. package/dist/types/dom/utils/ua.d.ts.map +1 -1
  141. package/dist/types/io/calc/crc32.d.ts.map +1 -1
  142. package/dist/types/io/codec/b64.d.ts +24 -0
  143. package/dist/types/io/codec/b64.d.ts.map +1 -1
  144. package/dist/types/io/codec/cbor.d.ts +1 -0
  145. package/dist/types/io/codec/cbor.d.ts.map +1 -1
  146. package/dist/types/io/codec/hex.d.ts.map +1 -1
  147. package/dist/types/io/codec/msgpack.d.ts +1 -0
  148. package/dist/types/io/codec/msgpack.d.ts.map +1 -1
  149. package/dist/types/io/codec/url.d.ts +3 -1
  150. package/dist/types/io/codec/url.d.ts.map +1 -1
  151. package/dist/types/io/codec/utf8.d.ts.map +1 -1
  152. package/dist/types/io/compress/bitstream.d.ts +1 -1
  153. package/dist/types/io/compress/brotli.d.ts +0 -1
  154. package/dist/types/io/compress/brotli.d.ts.map +1 -1
  155. package/dist/types/io/compress/brotli_shared.d.ts +0 -4
  156. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
  157. package/dist/types/io/compress/deflate.d.ts +14 -1
  158. package/dist/types/io/compress/deflate.d.ts.map +1 -1
  159. package/dist/types/io/compress/gzip.d.ts +4 -0
  160. package/dist/types/io/compress/gzip.d.ts.map +1 -1
  161. package/dist/types/io/compress/huffman.d.ts +7 -0
  162. package/dist/types/io/compress/huffman.d.ts.map +1 -1
  163. package/dist/types/io/compress/lz4.d.ts +4 -2
  164. package/dist/types/io/compress/lz4.d.ts.map +1 -1
  165. package/dist/types/io/compress/lz77.d.ts +17 -0
  166. package/dist/types/io/compress/lz77.d.ts.map +1 -1
  167. package/dist/types/io/compress/lzw.d.ts +2 -0
  168. package/dist/types/io/compress/lzw.d.ts.map +1 -1
  169. package/dist/types/io/compress/zip.d.ts.map +1 -1
  170. package/dist/types/io/compress/zlib.d.ts +9 -2
  171. package/dist/types/io/compress/zlib.d.ts.map +1 -1
  172. package/dist/types/io/math/linalg.d.ts.map +1 -1
  173. package/dist/types/process/rpc.d.ts.map +1 -1
  174. package/dist/types/process/workerPool.d.ts.map +1 -1
  175. package/dist/types/sanity/base.d.ts +12 -2
  176. package/dist/types/sanity/base.d.ts.map +1 -1
  177. package/dist/types/sanity/lockdown.d.ts +6 -5
  178. package/dist/types/sanity/lockdown.d.ts.map +1 -1
  179. package/dist/types/sanity/wasm-gate.d.ts +1 -1
  180. package/docs/README.md +17 -10
  181. package/docs/api/README.md +5 -5
  182. package/docs/api/core/logger.md +2 -1
  183. package/docs/api/core/modules.md +3 -3
  184. package/docs/api/core/runtime.md +9 -9
  185. package/docs/api/core/worker-helper.md +12 -2
  186. package/docs/api/crypto/README.md +1 -1
  187. package/docs/api/crypto/cipher/README.md +2 -2
  188. package/docs/api/crypto/cipher/aes.md +5 -10
  189. package/docs/api/crypto/cipher/chacha20.md +3 -8
  190. package/docs/api/crypto/hash/README.md +5 -5
  191. package/docs/api/crypto/hash/adf.md +21 -11
  192. package/docs/api/crypto/hash/argon2.md +3 -12
  193. package/docs/api/crypto/hash/blake2b.md +12 -14
  194. package/docs/api/crypto/hash/pbkdf2.md +1 -1
  195. package/docs/api/crypto/hash/sha224.md +2 -2
  196. package/docs/api/crypto/hash/sha256.md +4 -4
  197. package/docs/api/crypto/hash/sha3.md +2 -2
  198. package/docs/api/crypto/hash/sha384.md +1 -1
  199. package/docs/api/crypto/hash/sha512.md +5 -5
  200. package/docs/api/crypto/hash/sha512_224.md +1 -1
  201. package/docs/api/crypto/hash/sha512_256.md +1 -1
  202. package/docs/api/crypto/mode/README.md +3 -3
  203. package/docs/api/crypto/mode/cbc.md +2 -2
  204. package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
  205. package/docs/api/crypto/mode/cmac.md +4 -4
  206. package/docs/api/crypto/mode/ctr.md +2 -3
  207. package/docs/api/crypto/mode/gcm.md +5 -5
  208. package/docs/api/crypto/mode/kw.md +4 -4
  209. package/docs/api/crypto/pkc/README.md +8 -8
  210. package/docs/api/crypto/pkc/ecc.md +19 -17
  211. package/docs/api/crypto/pkc/ed25519.md +10 -15
  212. package/docs/api/crypto/pkc/hybridKem.md +8 -2
  213. package/docs/api/crypto/pkc/hybridSign.md +34 -7
  214. package/docs/api/crypto/pkc/ml_dsa.md +20 -19
  215. package/docs/api/crypto/pkc/ml_kem.md +3 -3
  216. package/docs/api/crypto/pkc/rsa.md +7 -9
  217. package/docs/api/crypto/pkc/slh_dsa.md +12 -12
  218. package/docs/api/crypto/pkc/x25519.md +5 -4
  219. package/docs/api/crypto/utils/README.md +7 -7
  220. package/docs/api/crypto/utils/aes_modes.md +2 -5
  221. package/docs/api/crypto/utils/asn1.md +25 -16
  222. package/docs/api/crypto/utils/jws.md +6 -4
  223. package/docs/api/crypto/utils/keyformat.md +24 -15
  224. package/docs/api/crypto/utils/pad.md +1 -1
  225. package/docs/api/crypto/utils/pem.md +3 -3
  226. package/docs/api/crypto/utils/random.md +3 -4
  227. package/docs/api/crypto/utils/rsaKeygen.md +2 -2
  228. package/docs/api/crypto/utils/totp.md +2 -2
  229. package/docs/api/crypto/utils/uuid.md +5 -5
  230. package/docs/api/crypto/utils/x509.md +124 -0
  231. package/docs/api/crypto/wasm/aes.md +1 -1
  232. package/docs/api/crypto/wasm/argon2.md +6 -4
  233. package/docs/api/crypto/wasm/ml_kem.md +1 -0
  234. package/docs/api/crypto/wasm/pbkdf2.md +8 -8
  235. package/docs/api/crypto/wasm/rsa.md +1 -1
  236. package/docs/api/crypto/wasm/runtime.md +27 -10
  237. package/docs/api/crypto/webcrypto/aes.md +1 -1
  238. package/docs/api/crypto/webcrypto/aeskw.md +2 -2
  239. package/docs/api/crypto/webcrypto/digest.md +3 -5
  240. package/docs/api/crypto/webcrypto/ecc.md +1 -1
  241. package/docs/api/crypto/webcrypto/ed25519.md +1 -1
  242. package/docs/api/crypto/webcrypto/rsa.md +3 -2
  243. package/docs/api/crypto/webcrypto/x25519.md +1 -1
  244. package/docs/api/dom/README.md +6 -1
  245. package/docs/api/dom/fs/README.md +1 -0
  246. package/docs/api/dom/fs/fileIntake.md +120 -0
  247. package/docs/api/dom/fs/fsAccess.md +1 -0
  248. package/docs/api/dom/fs/indexedDB.md +1 -1
  249. package/docs/api/dom/fs/storage.md +1 -1
  250. package/docs/api/dom/query/README.md +2 -1
  251. package/docs/api/dom/query/dnd.md +4 -1
  252. package/docs/api/dom/query/dom.md +5 -0
  253. package/docs/api/dom/query/sound.md +103 -0
  254. package/docs/api/dom/rendering/README.md +4 -3
  255. package/docs/api/dom/rendering/chart.md +5 -4
  256. package/docs/api/dom/rendering/component.md +25 -3
  257. package/docs/api/dom/rendering/parser.md +5 -2
  258. package/docs/api/dom/rendering/reactiveBind.md +1 -1
  259. package/docs/api/dom/rendering/render.md +2 -2
  260. package/docs/api/dom/rendering/sanitize.md +10 -2
  261. package/docs/api/dom/rendering/secPolicy.md +4 -4
  262. package/docs/api/dom/rendering/styleSheet.md +85 -0
  263. package/docs/api/dom/rendering/template.md +20 -5
  264. package/docs/api/dom/rendering/themeTokens.md +6 -3
  265. package/docs/api/dom/rendering/uiSession.md +18 -5
  266. package/docs/api/dom/rendering/virtualScroll.md +2 -2
  267. package/docs/api/dom/sensors/geolocation.md +1 -1
  268. package/docs/api/dom/sw/README.md +7 -1
  269. package/docs/api/dom/sw/cache.md +2 -1
  270. package/docs/api/dom/sw/installPrompt.md +111 -0
  271. package/docs/api/dom/sw/precache.md +124 -0
  272. package/docs/api/dom/sw/serviceWorker.md +4 -2
  273. package/docs/api/dom/sw/swUpdate.md +112 -0
  274. package/docs/api/dom/utils/clipboard.md +56 -5
  275. package/docs/api/dom/utils/entropyCollector.md +1 -1
  276. package/docs/api/dom/utils/keybindings.md +17 -2
  277. package/docs/api/dom/utils/leaderElection.md +2 -2
  278. package/docs/api/dom/utils/route.md +1 -0
  279. package/docs/api/dom/utils/ua.md +15 -10
  280. package/docs/api/io/calc/crc32.md +4 -1
  281. package/docs/api/io/codec/README.md +2 -2
  282. package/docs/api/io/codec/b64.md +31 -2
  283. package/docs/api/io/codec/buffer.md +1 -1
  284. package/docs/api/io/codec/cbor.md +6 -4
  285. package/docs/api/io/codec/csv.md +178 -178
  286. package/docs/api/io/codec/hex.md +10 -2
  287. package/docs/api/io/codec/msgpack.md +4 -3
  288. package/docs/api/io/codec/url.md +4 -3
  289. package/docs/api/io/codec/utf8.md +3 -3
  290. package/docs/api/io/compress/bitstream.md +6 -3
  291. package/docs/api/io/compress/brotli.md +36 -4
  292. package/docs/api/io/compress/brotli_shared.md +1 -1
  293. package/docs/api/io/compress/deflate.md +42 -34
  294. package/docs/api/io/compress/gzip.md +26 -6
  295. package/docs/api/io/compress/huffman.md +2 -1
  296. package/docs/api/io/compress/lz4.md +5 -3
  297. package/docs/api/io/compress/lz77.md +26 -3
  298. package/docs/api/io/compress/lzw.md +13 -8
  299. package/docs/api/io/compress/zip.md +36 -10
  300. package/docs/api/io/compress/zlib.md +21 -5
  301. package/docs/api/io/math/linalg.md +1 -1
  302. package/docs/api/io/utils/valid.md +1 -1
  303. package/docs/api/process/rpc.md +3 -2
  304. package/docs/api/process/workerPool.md +1 -1
  305. package/docs/api/sanity/base.md +9 -5
  306. package/docs/api/sanity/lockdown.md +7 -6
  307. package/docs/api/surface.json +12311 -0
  308. package/docs/api/typed.md +5 -3
  309. package/docs/dev/README.md +2 -0
  310. package/docs/dev/bench.md +76 -0
  311. package/docs/dev/crypto-references.md +54 -0
  312. package/docs/dev/provenance.md +30 -7
  313. package/docs/dev/publishing.md +7 -7
  314. package/docs/dev/runtime.md +1 -1
  315. package/docs/dev/testing.md +13 -0
  316. package/docs/evidence/l4-evidence.md +86 -0
  317. package/docs/evidence/pqc-hybrid-evidence.md +7 -6
  318. package/docs/guide/README.md +1 -0
  319. package/docs/guide/_QUICK_REF.md +5 -5
  320. package/docs/guide/doc-format.md +4 -3
  321. package/docs/guide/integrations-hmr.md +1 -1
  322. package/docs/guide/module-creation-workflow.md +8 -8
  323. package/docs/guide/rendering-pipeline.md +11 -4
  324. package/docs/guide/security.md +7 -5
  325. package/docs/guide/stability.md +123 -0
  326. package/docs/guide/tutorial-todo.md +20 -8
  327. package/docs/guide/typescript.md +9 -0
  328. package/docs/guide/worker-confinement.md +30 -17
  329. package/docs/notes/lz77-deflate-factorization.md +3 -3
  330. package/docs/tools/README.md +1 -1
  331. package/docs/tools/bundler.md +3 -3
  332. package/docs/tools/codegen.md +1 -1
  333. package/docs/tools/standalone.md +0 -1
  334. package/fw.config.json +2 -2
  335. package/integrations/_shared/catalog.generated.json +7 -1
  336. package/integrations/_shared/core.js +1 -1
  337. package/integrations/astro/index.js +1 -1
  338. package/integrations/eslint/README.md +7 -1
  339. package/integrations/nextjs/index.js +1 -1
  340. package/integrations/nodejs/README.md +3 -3
  341. package/integrations/turbopack/index.js +2 -2
  342. package/integrations/typedoc/categorize.js +1 -1
  343. package/integrations/typedoc/typedoc.json +2 -1
  344. package/integrations/vite/index.js +2 -2
  345. package/integrations/vite/vite-env.d.ts +7 -4
  346. package/integrations/webpack/index.js +3 -3
  347. package/package.json +76 -10
  348. package/src/core/internal.js +31 -0
  349. package/src/core/logger.js +95 -23
  350. package/src/core/modules.js +17 -8
  351. package/src/core/readyState.js +1 -1
  352. package/src/core/runtime.js +74 -27
  353. package/src/core/worker-helper.js +83 -4
  354. package/src/crypto/NIST_CONFORMANCE.md +47 -34
  355. package/src/crypto/cipher/aes.acvp.md +7 -8
  356. package/src/crypto/cipher/aes.js +280 -229
  357. package/src/crypto/cipher/chacha20.acvp.md +6 -7
  358. package/src/crypto/cipher/chacha20.js +91 -61
  359. package/src/crypto/hash/adf.js +1 -1
  360. package/src/crypto/hash/argon2.acvp.md +11 -15
  361. package/src/crypto/hash/argon2.js +9 -24
  362. package/src/crypto/hash/blake2b.js +157 -125
  363. package/src/crypto/hash/hkdf.acvp.md +15 -15
  364. package/src/crypto/hash/hkdf.js +1 -1
  365. package/src/crypto/hash/hmac.acvp.md +10 -12
  366. package/src/crypto/hash/hmac.js +5 -1
  367. package/src/crypto/hash/pbkdf2.acvp.md +13 -13
  368. package/src/crypto/hash/pbkdf2.js +36 -8
  369. package/src/crypto/hash/poly1305.acvp.md +10 -6
  370. package/src/crypto/hash/poly1305.js +171 -50
  371. package/src/crypto/hash/sha224.acvp.md +3 -3
  372. package/src/crypto/hash/sha224.js +4 -4
  373. package/src/crypto/hash/sha256.acvp.md +2 -2
  374. package/src/crypto/hash/sha256.js +514 -50
  375. package/src/crypto/hash/sha3.acvp.md +9 -9
  376. package/src/crypto/hash/sha3.js +127 -71
  377. package/src/crypto/hash/sha384.acvp.md +3 -3
  378. package/src/crypto/hash/sha384.js +4 -4
  379. package/src/crypto/hash/sha512.acvp.md +7 -8
  380. package/src/crypto/hash/sha512.js +107 -108
  381. package/src/crypto/hash/sha512_224.acvp.md +6 -6
  382. package/src/crypto/hash/sha512_224.js +2 -2
  383. package/src/crypto/hash/sha512_256.acvp.md +6 -6
  384. package/src/crypto/hash/sha512_256.js +2 -2
  385. package/src/crypto/mode/cbc.acvp.md +2 -2
  386. package/src/crypto/mode/cbc.js +1 -1
  387. package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
  388. package/src/crypto/mode/chacha20poly1305.js +3 -3
  389. package/src/crypto/mode/cmac.acvp.md +5 -5
  390. package/src/crypto/mode/cmac.js +8 -8
  391. package/src/crypto/mode/ctr.acvp.md +2 -2
  392. package/src/crypto/mode/ctr.js +1 -3
  393. package/src/crypto/mode/gcm.acvp.md +6 -6
  394. package/src/crypto/mode/gcm.js +7 -7
  395. package/src/crypto/mode/kw.acvp.md +4 -4
  396. package/src/crypto/mode/kw.js +5 -5
  397. package/src/crypto/pkc/ecc.acvp.md +13 -13
  398. package/src/crypto/pkc/ecc.js +9 -11
  399. package/src/crypto/pkc/ed25519.acvp.md +30 -34
  400. package/src/crypto/pkc/ed25519.js +453 -94
  401. package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
  402. package/src/crypto/pkc/hybridSign.js +103 -24
  403. package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
  404. package/src/crypto/pkc/ml_dsa.js +29 -32
  405. package/src/crypto/pkc/ml_kem.acvp.md +7 -7
  406. package/src/crypto/pkc/ml_kem.js +15 -21
  407. package/src/crypto/pkc/rsa.acvp.md +11 -15
  408. package/src/crypto/pkc/rsa.js +7 -44
  409. package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
  410. package/src/crypto/pkc/slh_dsa.js +16 -18
  411. package/src/crypto/pkc/x25519.acvp.md +13 -10
  412. package/src/crypto/pkc/x25519.js +273 -29
  413. package/src/crypto/utils/aes_modes.acvp.md +1 -2
  414. package/src/crypto/utils/aes_modes.js +2 -2
  415. package/src/crypto/utils/asn1-oid.js +1 -1
  416. package/src/crypto/utils/asn1.js +1 -1
  417. package/src/crypto/utils/bitArray.js +33 -48
  418. package/src/crypto/utils/bn.js +1 -1
  419. package/src/crypto/utils/jws.js +37 -41
  420. package/src/crypto/utils/keyformat.js +181 -2
  421. package/src/crypto/utils/pem.js +1 -1
  422. package/src/crypto/utils/random.acvp.md +5 -5
  423. package/src/crypto/utils/random.js +845 -846
  424. package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
  425. package/src/crypto/utils/rsaKeygen.js +6 -6
  426. package/src/crypto/utils/totp.js +1 -1
  427. package/src/crypto/utils/uuid.acvp.md +5 -5
  428. package/src/crypto/utils/uuid.js +11 -10
  429. package/src/crypto/utils/x509.js +591 -0
  430. package/src/crypto/wasm/aes.js +1 -1
  431. package/src/crypto/wasm/aes.scalar.wasm +0 -0
  432. package/src/crypto/wasm/argon2.js +17 -1
  433. package/src/crypto/wasm/argon2.scalar.wasm +0 -0
  434. package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
  435. package/src/crypto/wasm/blake2b.simd.wasm +0 -0
  436. package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
  437. package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
  438. package/src/crypto/wasm/cmac.scalar.wasm +0 -0
  439. package/src/crypto/wasm/ecc.js +3 -3
  440. package/src/crypto/wasm/ecc.scalar.wasm +0 -0
  441. package/src/crypto/wasm/ed25519.js +1 -1
  442. package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
  443. package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
  444. package/src/crypto/wasm/hmac.scalar.wasm +0 -0
  445. package/src/crypto/wasm/ml_dsa.js +2 -2
  446. package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
  447. package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
  448. package/src/crypto/wasm/ml_kem.js +2 -2
  449. package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
  450. package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
  451. package/src/crypto/wasm/pbkdf2.js +8 -6
  452. package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
  453. package/src/crypto/wasm/rsa.js +6 -5
  454. package/src/crypto/wasm/rsa.scalar.wasm +0 -0
  455. package/src/crypto/wasm/runtime.js +84 -17
  456. package/src/crypto/wasm/sha2.scalar.wasm +0 -0
  457. package/src/crypto/wasm/sha3.scalar.wasm +0 -0
  458. package/src/crypto/wasm/sha3.simd.wasm +0 -0
  459. package/src/crypto/wasm/slh_dsa.js +1 -1
  460. package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
  461. package/src/crypto/wasm/x25519.js +1 -1
  462. package/src/crypto/wasm/x25519.scalar.wasm +0 -0
  463. package/src/crypto/webcrypto/aes.js +8 -2
  464. package/src/crypto/webcrypto/aeskw.js +7 -2
  465. package/src/crypto/webcrypto/digest.js +1 -15
  466. package/src/crypto/webcrypto/ecc.js +2 -2
  467. package/src/crypto/webcrypto/ed25519.js +2 -2
  468. package/src/crypto/webcrypto/hmac.js +2 -2
  469. package/src/crypto/webcrypto/rsa.js +7 -2
  470. package/src/crypto/webcrypto/x25519.js +2 -2
  471. package/src/dom/display/animate.js +1 -1
  472. package/src/dom/display/fullscreen.js +1 -1
  473. package/src/dom/fs/download.js +1 -1
  474. package/src/dom/fs/fileIntake.js +192 -0
  475. package/src/dom/fs/fsAccess.js +2 -3
  476. package/src/dom/fs/indexedDB.js +1 -1
  477. package/src/dom/fs/remoteStore.js +1 -1
  478. package/src/dom/fs/storage.js +1 -1
  479. package/src/dom/lifecycle/idle.js +1 -1
  480. package/src/dom/lifecycle/visibility.js +1 -1
  481. package/src/dom/lifecycle/wakeLock.js +1 -1
  482. package/src/dom/net/ajax.js +1 -1
  483. package/src/dom/net/network.js +1 -1
  484. package/src/dom/net/sse.js +1 -1
  485. package/src/dom/net/webrtc.js +1 -1
  486. package/src/dom/net/ws.js +1 -1
  487. package/src/dom/query/dnd.js +56 -4
  488. package/src/dom/query/dom.js +1 -1
  489. package/src/dom/query/events.js +1 -1
  490. package/src/dom/query/gesture.js +1 -1
  491. package/src/dom/query/media.js +1 -1
  492. package/src/dom/query/sound.js +333 -0
  493. package/src/dom/rendering/chart.js +736 -663
  494. package/src/dom/rendering/component.js +25 -14
  495. package/src/dom/rendering/devtools.js +2 -2
  496. package/src/dom/rendering/parser.js +155 -12
  497. package/src/dom/rendering/render.js +14 -4
  498. package/src/dom/rendering/sanitize.js +11 -4
  499. package/src/dom/rendering/secPolicy.js +6 -4
  500. package/src/dom/rendering/styleSheet.js +217 -0
  501. package/src/dom/rendering/template.js +72 -13
  502. package/src/dom/rendering/themeTokens.js +542 -522
  503. package/src/dom/rendering/uiSession-core.js +51 -6
  504. package/src/dom/rendering/uiSession-direct.js +1 -1
  505. package/src/dom/rendering/uiSession-list.js +4 -4
  506. package/src/dom/rendering/uiSession.js +1 -1
  507. package/src/dom/rendering/virtualScroll.js +341 -341
  508. package/src/dom/sensors/battery.js +1 -1
  509. package/src/dom/sensors/geolocation.js +1 -1
  510. package/src/dom/sensors/networkInfo.js +1 -1
  511. package/src/dom/sensors/sensors.js +1 -1
  512. package/src/dom/sw/backgroundSync.js +1 -1
  513. package/src/dom/sw/cache.js +1 -1
  514. package/src/dom/sw/installPrompt.js +151 -0
  515. package/src/dom/sw/precache.js +257 -0
  516. package/src/dom/sw/push.js +1 -1
  517. package/src/dom/sw/sharedWorker.js +1 -1
  518. package/src/dom/sw/swUpdate.js +239 -0
  519. package/src/dom/utils/a11y.js +1 -1
  520. package/src/dom/utils/clipboard.js +56 -6
  521. package/src/dom/utils/entropyCollector.js +1 -1
  522. package/src/dom/utils/focus.js +1 -1
  523. package/src/dom/utils/form.js +1 -1
  524. package/src/dom/utils/keybindings.js +600 -574
  525. package/src/dom/utils/leaderElection.js +1 -1
  526. package/src/dom/utils/notifications.js +1 -1
  527. package/src/dom/utils/permissions.js +107 -107
  528. package/src/dom/utils/route.js +14 -2
  529. package/src/dom/utils/ua.js +42 -28
  530. package/src/dom/utils/webauthn.js +1 -1
  531. package/src/io/binary/reader.js +1 -1
  532. package/src/io/binary/writer.js +1 -1
  533. package/src/io/calc/bigint.js +1 -1
  534. package/src/io/calc/crc32.js +28 -2
  535. package/src/io/calc/easing.js +514 -514
  536. package/src/io/codec/b64.js +189 -52
  537. package/src/io/codec/base32.js +1 -1
  538. package/src/io/codec/base58.js +1 -1
  539. package/src/io/codec/buffer.js +1 -1
  540. package/src/io/codec/cbor.js +111 -18
  541. package/src/io/codec/csv.js +1 -1
  542. package/src/io/codec/hex.js +51 -6
  543. package/src/io/codec/mime.js +1 -1
  544. package/src/io/codec/msgpack.js +47 -6
  545. package/src/io/codec/url.js +24 -7
  546. package/src/io/codec/utf8.js +5 -3
  547. package/src/io/codec/xml.js +1 -1
  548. package/src/io/compress/bitstream.js +2 -2
  549. package/src/io/compress/brotli.js +663 -163
  550. package/src/io/compress/brotli_dict.js +1 -1
  551. package/src/io/compress/brotli_dict_words.js +1 -1
  552. package/src/io/compress/brotli_frame.js +1 -1
  553. package/src/io/compress/brotli_shared.js +7 -7
  554. package/src/io/compress/deflate.js +87 -53
  555. package/src/io/compress/gzip.js +187 -74
  556. package/src/io/compress/huffman.js +24 -1
  557. package/src/io/compress/lz4.js +45 -7
  558. package/src/io/compress/lz77.js +148 -63
  559. package/src/io/compress/lzw.js +35 -19
  560. package/src/io/compress/zip.js +862 -815
  561. package/src/io/compress/zlib.js +87 -7
  562. package/src/io/i18n/i18n.js +1 -1
  563. package/src/io/math/fixed-point.js +1 -1
  564. package/src/io/math/geom.js +1 -1
  565. package/src/io/math/interp.js +1 -1
  566. package/src/io/math/linalg.js +10 -4
  567. package/src/io/math/stats.js +1 -1
  568. package/src/io/structures/btree.js +1 -1
  569. package/src/io/structures/heap.js +1 -1
  570. package/src/io/structures/lruCache.js +1 -1
  571. package/src/io/structures/ringBuffer.js +1 -1
  572. package/src/io/structures/tree-walker.js +1 -1
  573. package/src/io/structures/trie.js +1 -1
  574. package/src/io/sync/abort.js +1 -1
  575. package/src/io/sync/atomics.js +1 -1
  576. package/src/io/sync/cancellable.js +1 -1
  577. package/src/io/sync/channel.js +1 -1
  578. package/src/io/sync/mutex.js +1 -1
  579. package/src/io/sync/semaphore.js +1 -1
  580. package/src/io/sync/tokenBucket.js +1 -1
  581. package/src/io/text/ansi.js +1 -1
  582. package/src/io/text/html-entities.js +1 -1
  583. package/src/io/time/date.js +1 -1
  584. package/src/io/timing/clock.js +1 -1
  585. package/src/io/timing/rateLimit.js +1 -1
  586. package/src/io/timing/scheduler.js +1 -1
  587. package/src/io/utils/errors.js +1 -1
  588. package/src/io/utils/eventBus.js +1 -1
  589. package/src/io/utils/signal.js +1 -1
  590. package/src/io/utils/valid.js +1 -1
  591. package/src/main.js +1 -1
  592. package/src/process/message.js +1 -1
  593. package/src/process/rpc.js +7 -3
  594. package/src/process/workerPool.js +11 -4
  595. package/src/sanity/base.js +85 -39
  596. package/src/sanity/lockdown-apply.js +3 -3
  597. package/src/sanity/lockdown.js +58 -32
  598. package/src/sanity/wasm-gate.js +2 -2
  599. package/src/typed.js +7 -3
  600. package/third-party/NOTICE-brotli-dictionary.txt +69 -0
  601. package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
  602. package/third-party/NOTICE-whatwg-entities.txt +44 -0
  603. package/types/registry.generated.d.ts +7 -1
  604. package/types/typed.d.ts +7 -3
  605. package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
  606. package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
  607. package/docs/api/crypto/utils/aes_ctr.md +0 -71
  608. package/src/crypto/utils/aes_ctr.acvp.md +0 -67
  609. package/src/crypto/utils/aes_ctr.js +0 -134
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -44,6 +44,7 @@
44
44
  * @typedef {object} GunzipStreamInstance
45
45
  * @property {((chunk: Uint8Array, isFinal: boolean) => void)|null} ondata
46
46
  * @property {(chunk: Uint8Array, final?: boolean) => void} push
47
+ * @property {() => void} flush End the stream without a trailer: decode and emit the held-back bytes.
47
48
  */
48
49
 
49
50
  /**
@@ -100,7 +101,7 @@ export const gzip = {
100
101
  if (c > 0x7F) {
101
102
  const e = new Error('gzip filename contains non-ASCII characters but TextEncoder is unavailable');
102
103
  // @ts-ignore - Error.code is a non-standard but widely-used extension
103
- e.code = 12;
104
+ e.code = 'ENOENCODER'; e.errno = 12;
104
105
  throw e;
105
106
  }
106
107
  out[i] = c;
@@ -112,7 +113,7 @@ export const gzip = {
112
113
  if (bytes.length > 65535) {
113
114
  const e = new Error('gzip filename too long');
114
115
  // @ts-ignore - Error.code is a non-standard but widely-used extension
115
- e.code = 12;
116
+ e.code = 'ENOENCODER'; e.errno = 12;
116
117
  throw e;
117
118
  }
118
119
  // The encoded bytes themselves must not contain NUL (would short-
@@ -121,7 +122,7 @@ export const gzip = {
121
122
  if (bytes[i] === 0) {
122
123
  const e = new Error('gzip filename contains NUL byte');
123
124
  // @ts-ignore - Error.code is a non-standard but widely-used extension
124
- e.code = 12;
125
+ e.code = 'ENOENCODER'; e.errno = 12;
125
126
  throw e;
126
127
  }
127
128
  }
@@ -169,25 +170,36 @@ export const gzip = {
169
170
  if (d[0] !== 0x1F || d[1] !== 0x8B || d[2] !== 0x08) {
170
171
  const e = new Error('invalid gzip data');
171
172
  // @ts-ignore - Error.code is a non-standard but widely-used extension
172
- e.code = 6;
173
+ e.code = 'EBADFORMAT'; e.errno = 6;
173
174
  throw e;
174
175
  }
175
176
  const flg = d[3];
177
+ // A header that runs past the bytes at hand is reported, never
178
+ // guessed: a stream waits for more bytes, a one-shot call fails.
179
+ const truncated = () => {
180
+ const e = new Error('invalid gzip data: truncated header');
181
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
182
+ e.code = 'EBADFORMAT'; e.errno = 6;
183
+ return e;
184
+ };
185
+ if (d.length < 10) throw truncated();
176
186
  let st = 10;
177
- if (flg & 0x04) st += (d[10] | (d[11] << 8)) + 2; // FEXTRA
178
- // Skip FNAME (bit 3) and FCOMMENT (bit 4) - both are null-terminated
179
- // @ts-ignore - boolean !d[st++] is coerced to 0/1 in arithmetic: intentional compact idiom
180
- for (let zs = ((flg >> 3) & 1) + ((flg >> 4) & 1); zs > 0; zs -= /** @type {number} */ (/** @type {*} */ (!d[st++])));
181
- if (flg & 0x02) st += 2; // FHCRC
187
+ if (flg & 0x04) { // FEXTRA
188
+ if (d.length < 12) throw truncated();
189
+ st += (d[10] | (d[11] << 8)) + 2;
190
+ }
191
+ // FNAME (bit 3) then FCOMMENT (bit 4), each null-terminated.
192
+ for (const bit of [0x08, 0x10]) {
193
+ if (!(flg & bit)) continue;
194
+ while (st < d.length && d[st] !== 0) st++;
195
+ if (st >= d.length) throw truncated();
196
+ st++;
197
+ }
198
+ if (flg & 0x02) st += 2; // FHCRC
199
+ if (st > d.length) throw truncated();
182
200
  return st;
183
201
  }
184
202
 
185
- // Read original (uncompressed) size from the gzip footer
186
- function _originalSize(d) {
187
- const l = d.length;
188
- return (d[l - 4] | (d[l - 3] << 8) | (d[l - 2] << 16) | (d[l - 1] << 24)) >>> 0;
189
- }
190
-
191
203
  // --- Public API ---
192
204
 
193
205
  /**
@@ -219,18 +231,86 @@ export const gzip = {
219
231
  * @param {object} [opts] - `{ out?: Uint8Array }`
220
232
  * @returns {Uint8Array}
221
233
  */
234
+ // The typed string `code` of the compressor family (D9 G6); the
235
+ // number of the earlier convention stays in `errno`.
236
+ const CODE_NAMES = { 0: 'EEOF', 1: 'EBADBLOCK', 2: 'EBADSYMBOL', 3: 'EBADDISTANCE', 4: 'ESTREAMEND', 5: 'ENOHANDLER', 6: 'EBADFORMAT', 7: 'EMAXOUT', 8: 'EBADSTREAM', 9: 'EEXTRATOOLONG', 10: 'EBADDATE', 11: 'ENAMETOOLONG', 12: 'ENOENCODER', 13: 'EBADFORMAT', 14: 'EBADMETHOD', 15: 'EUNSAFEPATH', 16: 'ECHECKSUM' };
237
+ /** An `Error` carrying the family's string `code` and numeric `errno`. */
238
+ function _codeErr(code, message) {
239
+ const e = new Error(message);
240
+ // @ts-ignore - Error.code / errno are non-standard but widely-used extensions
241
+ e.code = CODE_NAMES[code]; e.errno = code;
242
+ return e;
243
+ }
244
+
245
+ /** Are all bytes of `d` from `at` on zero (padding after the last member)? */
246
+ function _zerosFrom(d, at) {
247
+ for (let k = at; k < d.length; k++) if (d[k] !== 0) return false;
248
+ return true;
249
+ }
250
+
251
+ /**
252
+ * Decompress Gzip data: every member (RFC 1952 § 2.2), concatenated.
253
+ * Trailing zero bytes after the last member are ignored. Each
254
+ * member's CRC-32 and ISIZE are checked (code 16 on a mismatch);
255
+ * `verify: false` skips the check.
256
+ *
257
+ * @param {Uint8Array} data
258
+ * @param {object} [opts] - `{ out?: Uint8Array, dictionary?: Uint8Array, verify?: boolean, maxOutput?: number }`
259
+ * (`maxOutput`: cap on the bytes decoded over every member, code 7 past it)
260
+ * @returns {Uint8Array}
261
+ */
222
262
  function gunzipSync(data, opts = {}) {
223
- const st = _payloadStart(data);
224
- if (st + 8 > data.length) {
225
- const e = new Error('invalid gzip data');
263
+ const st0 = _payloadStart(data);
264
+ if (st0 + 8 > data.length) throw _codeErr(6, 'invalid gzip data');
265
+ const parts = [];
266
+ let total = 0;
267
+ let off = 0;
268
+ let first = true;
269
+ while (first || (off < data.length && !_zerosFrom(data, off))) {
270
+ const st = first ? st0 : off + _payloadStart(data.subarray(off));
271
+ let used = -1;
272
+ const out = inflateSync(data.subarray(st), {
273
+ // a caller buffer receives the members one after the other
274
+ out: opts.out ? opts.out.subarray(total) : undefined,
275
+ dictionary: opts.dictionary,
276
+ // the cap holds over the members: each gets what is left
277
+ maxOutput: opts.maxOutput === undefined || opts.maxOutput === null ? undefined : opts.maxOutput - total,
278
+ onEnd: (n) => { used = n; },
279
+ });
280
+ const trailer = st + used;
281
+ if (used < 0 || trailer + 8 > data.length) throw _codeErr(0, 'gzip: unexpected EOF (member without its trailer)');
282
+ if (opts.verify !== false) _checkTrailer(out, out.length, data, trailer);
283
+ parts.push(out);
284
+ total += out.length;
285
+ off = trailer + 8;
286
+ first = false;
287
+ }
288
+ if (opts.out) return opts.out.subarray(0, total);
289
+ if (parts.length === 1) return parts[0];
290
+ const all = new Uint8Array(total);
291
+ let o = 0;
292
+ for (const part of parts) { all.set(part, o); o += part.length; }
293
+ return all;
294
+ }
295
+
296
+ /** Read a little-endian 32-bit trailer field at `at`. */
297
+ function _r32le(d, at) {
298
+ return (d[at] | (d[at + 1] << 8) | (d[at + 2] << 16) | (d[at + 3] << 24)) >>> 0;
299
+ }
300
+
301
+ /**
302
+ * Unless `verify: false`: throw code 16 unless the 8-byte trailer at `at`
303
+ * holds the CRC-32 of `out` and its size mod 2^32 (`size`).
304
+ */
305
+ function _checkTrailer(out, size, d, at, crc) {
306
+ let sum = crc;
307
+ if (sum === undefined) { const c = new Crc32(); c.append(out); sum = c.get(); }
308
+ if (sum !== _r32le(d, at) || (size >>> 0) !== _r32le(d, at + 4)) {
309
+ const e = new Error('gzip: incorrect data check (CRC-32 or ISIZE mismatch)');
226
310
  // @ts-ignore - Error.code is a non-standard but widely-used extension
227
- e.code = 6;
311
+ e.code = 'ECHECKSUM'; e.errno = 16;
228
312
  throw e;
229
313
  }
230
- return inflateSync(data.subarray(st, -8), {
231
- out: opts.out ?? new Uint8Array(_originalSize(data)),
232
- dictionary: opts.dictionary,
233
- });
234
314
  }
235
315
 
236
316
  // Concatenate two Uint8Arrays
@@ -294,71 +374,104 @@ export const gzip = {
294
374
  /**
295
375
  * Streaming Gzip decompressor.
296
376
  *
297
- * Buffers input until the Gzip header is parsed, then feeds the DEFLATE
298
- * payload to `InflateStream` while holding back the 8-byte footer.
377
+ * Reads every member (RFC 1952 § 2.2): a header (which may arrive in
378
+ * pieces), the DEFLATE payload — fed to `InflateStream`, which knows
379
+ * where the final block ends — then the 8-byte trailer, and so on.
380
+ * Trailing zero bytes after the last member are ignored.
299
381
  *
300
- * @param {object|function} [opts]
382
+ * @param {object|function} [opts] - `{ dictionary?, verify? }` or `ondata`
301
383
  * @param {function} [ondata] - callback(chunk: Uint8Array, isFinal: boolean)
302
384
  */
303
385
  function GunzipStream(opts, ondata) {
304
386
  if (typeof opts === 'function') { ondata = opts; opts = {}; }
305
387
  this.ondata = ondata || null;
306
388
  this._opts = opts || {};
307
- this._buf = []; // input chunks before header is resolved
308
- this._bufLen = 0;
309
- this._hdr = -1; // payload start offset (-1 = not yet parsed)
389
+ this._phase = 'header'; // 'header' | 'body' | 'trailer'
390
+ this._pending = new Uint8Array(0); // header or trailer bytes so far
310
391
  this._inf = null;
311
- this._tail = new Uint8Array(8); // held-back footer bytes
312
- this._tailLen = 0;
392
+ this._members = 0;
393
+ // Unless `verify: false`: CRC-32 and size of the current member, checked
394
+ // against its trailer.
395
+ this._crc = null;
396
+ this._size = 0;
397
+ this._ended = false;
398
+ // `maxOutput` holds over every member: bytes emitted so far.
399
+ this._produced = 0;
313
400
  }
314
401
 
402
+ /** Append `b` to the pending header / trailer bytes. */
403
+ GunzipStream.prototype._take = function(b) {
404
+ if (!this._pending.length) { this._pending = b; return; }
405
+ const m = new Uint8Array(this._pending.length + b.length);
406
+ m.set(this._pending);
407
+ m.set(b, this._pending.length);
408
+ this._pending = m;
409
+ };
410
+
315
411
  GunzipStream.prototype.push = function(chunk, final) {
316
- if (this._hdr === -1) {
317
- this._buf.push(chunk);
318
- this._bufLen += chunk.length;
319
-
320
- // Reconstruct buffer to attempt header parse
321
- const combined = new Uint8Array(this._bufLen);
322
- let off = 0;
323
- for (const c of this._buf) { combined.set(c, off); off += c.length; }
324
-
325
- let hdrEnd;
326
- try { hdrEnd = _payloadStart(combined); } catch (e) {
327
- if (final) throw e;
328
- return; // need more bytes
412
+ if (this._ended) throw _codeErr(4, 'stream finished');
413
+ if (final) this._ended = true;
414
+ let data = chunk;
415
+ for (;;) {
416
+ if (this._phase === 'header') {
417
+ this._take(data);
418
+ if (this._members > 0 && _zerosFrom(this._pending, 0)) break; // padding
419
+ let hdrEnd;
420
+ try { hdrEnd = _payloadStart(this._pending); } catch (e) {
421
+ if (final) throw e;
422
+ return; // need more bytes
423
+ }
424
+ const self = this;
425
+ this._crc = this._opts.verify !== false ? new Crc32() : null;
426
+ this._size = 0;
427
+ const cap = this._opts.maxOutput;
428
+ const memberOpts = cap === undefined || cap === null
429
+ ? this._opts
430
+ : Object.assign({}, this._opts, { maxOutput: cap - this._produced });
431
+ this._inf = new InflateStream(memberOpts, function(out) {
432
+ self._produced += out.length;
433
+ if (self._crc) { self._crc.append(out); self._size += out.length; }
434
+ if (self.ondata && out.length) self.ondata(out, false);
435
+ });
436
+ data = this._pending.subarray(hdrEnd);
437
+ this._pending = new Uint8Array(0);
438
+ this._phase = 'body';
329
439
  }
330
-
331
- this._hdr = hdrEnd;
332
- this._buf = null;
333
- const self = this;
334
- this._inf = new InflateStream(this._opts, function(data, fin) {
335
- if (self.ondata) self.ondata(data, fin);
336
- });
337
- this._feedPayload(combined.subarray(hdrEnd), !!final);
338
- } else {
339
- this._feedPayload(chunk, !!final);
440
+ if (this._phase === 'body') {
441
+ this._inf.push(data, false);
442
+ if (!this._inf.ended) {
443
+ if (final) throw _codeErr(0, 'gzip: unexpected EOF (inside a member)');
444
+ return;
445
+ }
446
+ data = this._inf.rest();
447
+ this._phase = 'trailer';
448
+ }
449
+ // trailer
450
+ this._take(data);
451
+ if (this._pending.length < 8) {
452
+ if (final) throw _codeErr(0, 'gzip: unexpected EOF (member without its trailer)');
453
+ return;
454
+ }
455
+ if (this._crc) _checkTrailer(null, this._size, this._pending, 0, this._crc.get());
456
+ data = this._pending.subarray(8);
457
+ this._pending = new Uint8Array(0);
458
+ this._members++;
459
+ this._phase = 'header';
460
+ if (!data.length) break;
340
461
  }
462
+ if (final && this.ondata) this.ondata(new Uint8Array(0), true);
341
463
  };
342
464
 
343
- GunzipStream.prototype._feedPayload = function(chunk, final) {
344
- const FOOTER = 8;
345
- // Merge currently held tail bytes with the new chunk
346
- const total = new Uint8Array(this._tailLen + chunk.length);
347
- total.set(this._tail.subarray(0, this._tailLen));
348
- total.set(chunk, this._tailLen);
349
-
350
- if (!final) {
351
- // Feed everything except the last FOOTER bytes to inflate
352
- const feedLen = total.length > FOOTER ? total.length - FOOTER : 0;
353
- if (feedLen > 0) this._inf.push(total.subarray(0, feedLen), false);
354
- const newTailLen = total.length - feedLen;
355
- this._tailLen = newTailLen;
356
- this._tail.set(total.subarray(feedLen));
357
- } else {
358
- // Strip the 8-byte footer and close the inflate stream
359
- const feedLen = Math.max(0, total.length - FOOTER);
360
- this._inf.push(total.subarray(0, feedLen), true);
361
- }
465
+ /**
466
+ * End the stream WITHOUT a trailer: for a source that may be truncated.
467
+ * Every byte pushed so far has been decoded and emitted; this marks
468
+ * the end (`ondata(empty, true)`) without requiring a trailer. A later
469
+ * `push` throws code 4.
470
+ */
471
+ GunzipStream.prototype.flush = function() {
472
+ if (this._ended) throw _codeErr(4, 'stream finished');
473
+ this._ended = true;
474
+ if (this.ondata) this.ondata(new Uint8Array(0), true);
362
475
  };
363
476
 
364
477
  // Async wrappers (microtask-deferred)
@@ -52,6 +52,7 @@ import { bitstream } from './bitstream.js';
52
52
  * @typedef {object} HuffmanAPI
53
53
  * @property {(codeLengths: Uint8Array|number[], maxBits: number, reversed: 0|1|number) => Uint16Array} buildMap Build the encode map (`reversed=0`) or reversed-code decode table (`reversed=1`) from canonical code lengths.
54
54
  * @property {(freqs: Uint16Array|number[], maxBits: number) => { t: Uint8Array, l: number }} buildTree Derive a length-limited canonical code; `t` = per-symbol code lengths, `l` = max bits used.
55
+ * @property {(codeLengths: Uint8Array|number[]) => { oversubscribed: boolean, incomplete: boolean }} kraft Kraft check of a code-length set (`buildMap` does not check).
55
56
  */
56
57
 
57
58
  export const huffman = {
@@ -317,6 +318,28 @@ export const huffman = {
317
318
  return { t, l: lengths[0] };
318
319
  }
319
320
 
320
- return { buildTree, buildMap };
321
+ /**
322
+ * Kraft check of a code-length set (RFC 1951 § 3.2.2): does it use
323
+ * more codes than exist (`oversubscribed` — `buildMap` would overwrite
324
+ * slots), or leave codes unused (`incomplete` — `buildMap` leaves
325
+ * holes)? RFC 1951 § 3.2.7 allows one incomplete case, a single
326
+ * distance code of length 1; the caller decides what to reject.
327
+ * `buildMap` itself does not check.
328
+ *
329
+ * @param {Uint8Array|number[]} codeLengths Per-symbol length, 0 = unused.
330
+ * @returns {{ oversubscribed: boolean, incomplete: boolean }}
331
+ */
332
+ function kraft(codeLengths) {
333
+ const perLength = new Int32Array(LENGTH_SLOTS);
334
+ for (let s = 0; s < codeLengths.length; ++s) perLength[codeLengths[s]]++;
335
+ let left = 1;
336
+ for (let len = 1; len < LENGTH_SLOTS; ++len) {
337
+ left = left * 2 - perLength[len];
338
+ if (left < 0) return { oversubscribed: true, incomplete: false };
339
+ }
340
+ return { oversubscribed: false, incomplete: left > 0 };
341
+ }
342
+
343
+ return { buildTree, buildMap, kraft };
321
344
  },
322
345
  };
@@ -42,7 +42,7 @@
42
42
  /**
43
43
  * LZ4 compression/decompression surface returned by `factory()`.
44
44
  * @typedef {object} Lz4API
45
- * @property {(src: Uint8Array, len: number, opts?: { mode?: 'speed'|'ratio' }) => [number, Uint8Array]} compress - Compress data; returns `[compressed_size, compressed_data]` (`[0, original]` if incompressible, `[-1, original]` on size-limit error). `opts.mode`: 'speed' (default) or 'ratio' (smaller blocks, slower encode); any other value throws a RangeError.
45
+ * @property {(src: Uint8Array, len?: number|{ mode?: 'speed'|'ratio' }, opts?: { mode?: 'speed'|'ratio' }) => [number, Uint8Array]} compress - Compress `src[0, len)` (all of `src` when `len` is omitted or is the options object); returns `[compressed_size, compressed_data]` (`[0, original]` if incompressible, `[-1, original]` on size-limit error). `opts.mode`: 'speed' (default) or 'ratio' (smaller blocks, slower encode); any other value throws a RangeError.
46
46
  * @property {(src: Uint8Array) => [number, Uint8Array]} decompress - Decompress data; returns `[decompressed_size, decompressed_data]` (`[-1, compressed]` on error).
47
47
  * @property {new (ondata: (chunk: Uint8Array, isFinal: boolean) => void, opts?: { mode?: 'speed'|'ratio' }) => {ondata: ((chunk: Uint8Array, isFinal: boolean) => void)|null, push: (chunk: Uint8Array, final?: boolean) => void}} Lz4CompressStream - Streaming LZ4 compressor constructor; `opts` as for `compress`.
48
48
  * @property {new (ondata: (chunk: Uint8Array, isFinal: boolean) => void) => {ondata: ((chunk: Uint8Array, isFinal: boolean) => void)|null, push: (chunk: Uint8Array, final?: boolean) => void}} Lz4DecompressStream - Streaming LZ4 decompressor constructor.
@@ -56,6 +56,14 @@ export const lz4 = {
56
56
 
57
57
  /** @returns {Lz4API} */
58
58
  factory() {
59
+ /** An `Error` with the compressor family's string `code` (D9 G6). */
60
+ function _codedError(code, message) {
61
+ const e = new Error(message);
62
+ // @ts-ignore - Error.code is a non-standard but widely-used extension
63
+ e.code = code;
64
+ return e;
65
+ }
66
+
59
67
 
60
68
  // --- Limits ---
61
69
  /** Largest input `compress` accepts and largest output `decompress` produces (~1 GB). */
@@ -164,6 +172,9 @@ export const lz4 = {
164
172
  * @throws {RangeError} when `opts.mode` is neither 'speed' nor 'ratio'.
165
173
  */
166
174
  function compress(src, len, opts) {
175
+ // `compress(src)` and `compress(src, opts)`: the whole of `src`.
176
+ if (len !== null && typeof len === 'object') { opts = len; len = undefined; }
177
+ if (len === undefined) len = src.length;
167
178
  const { probes, covered, skipShift } = settingsOf(opts);
168
179
  return encodeBlock(src, len, probes, covered, skipShift);
169
180
  }
@@ -339,7 +350,7 @@ export const lz4 = {
339
350
  if (lit > n - ip) return [-1, src];
340
351
  ip += lit;
341
352
  total += lit;
342
- if (total > MAX_INPUT) throw new Error('Decompression exceeds maximum size limit');
353
+ if (total > MAX_INPUT) throw _codedError('EMAXOUT', 'Decompression exceeds maximum size limit');
343
354
  if (ip === n) break; // literal-only final sequence
344
355
 
345
356
  if (n - ip < 2) return [-1, src];
@@ -356,7 +367,7 @@ export const lz4 = {
356
367
  } while (b === EXT_MAX);
357
368
  }
358
369
  total += ml + MIN_MATCH;
359
- if (total > MAX_INPUT) throw new Error('Decompression exceeds maximum size limit');
370
+ if (total > MAX_INPUT) throw _codedError('EMAXOUT', 'Decompression exceeds maximum size limit');
360
371
  }
361
372
 
362
373
  // Pass 2: the block is known valid; copy into an exact-size buffer.
@@ -415,15 +426,42 @@ export const lz4 = {
415
426
  }
416
427
 
417
428
  /**
418
- * Compress `chunk` and forward the block (or the raw chunk when the
419
- * result is not a block) to `ondata`.
429
+ * Compress `chunk` and forward one LZ4 block to `ondata`: the
430
+ * compressed block, or, when `chunk` does not compress (or is 12
431
+ * bytes or less), a block of its bytes as literals — never the
432
+ * raw chunk, which `Lz4DecompressStream` would decode as a block
433
+ * (BL-1703, D9 G7).
420
434
  * @param {Uint8Array} chunk
421
435
  * @param {boolean} [final]
436
+ * @throws {Error} code `'EMAXOUT'` past the block size limit.
422
437
  */
423
438
  push(chunk, final) {
424
439
  const [size, data] = compress(chunk, chunk.length, this.#opts);
425
- if (this.ondata) this.ondata(size > 0 ? data : chunk, !!final);
440
+ if (size < 0) throw _codedError('EMAXOUT', 'lz4: chunk exceeds maximum size limit');
441
+ if (this.ondata) this.ondata(size > 0 ? data : _literalBlock(chunk), !!final);
442
+ }
443
+ }
444
+
445
+ /**
446
+ * One LZ4 block holding `src` as a single literal run (the last
447
+ * sequence of a block carries no match): the token, the length
448
+ * extension bytes past 15, the bytes.
449
+ * @param {Uint8Array} src
450
+ * @returns {Uint8Array}
451
+ */
452
+ function _literalBlock(src) {
453
+ const n = src.length;
454
+ const ext = n >= 15 ? Math.floor((n - 15) / 255) + 1 : 0;
455
+ const out = new Uint8Array(1 + ext + n);
456
+ out[0] = (n >= 15 ? 15 : n) << 4;
457
+ let o = 1;
458
+ if (n >= 15) {
459
+ let r = n - 15;
460
+ while (r >= 255) { out[o++] = 255; r -= 255; }
461
+ out[o++] = r;
426
462
  }
463
+ out.set(src, o);
464
+ return out;
427
465
  }
428
466
 
429
467
  /** Streaming decompressor: each `push` is decoded as one independent block. */
@@ -441,7 +479,7 @@ export const lz4 = {
441
479
  */
442
480
  push(chunk, final) {
443
481
  const [size, data] = decompress(chunk);
444
- if (size < 0) throw new Error('lz4 decompression error');
482
+ if (size < 0) throw _codedError('EBADSTREAM', 'lz4 decompression error');
445
483
  if (this.ondata) this.ondata(data, !!final);
446
484
  }
447
485
  }