@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,178 +1,178 @@
1
- ---
2
- module: csv
3
- category: io/codec
4
- dependencies: []
5
- returns: object
6
- worker-safe: true
7
- status: complete
8
- ---
9
-
10
- # csv
11
-
12
- > CSV import/export (RFC 4180) for tabular data. Text API — compose with `utf8` for byte I/O.
13
-
14
- **Module** `csv` | **Source** `packages/front/fw/src/io/codec/csv.js` | **Deps** none | **Worker-safe** yes
15
-
16
- **Default dialect**: `,` delimiter, quote-doubling for escaping, `\r\n` line separator on output. The parser is tolerant: accepts LF, CR, CRLF, optional UTF-8 BOM, optional trailing newline. Custom dialects (TSV, semicolon-CSV, etc.) via `delimiter`/`quote`/`newline`.
17
-
18
- ## Resolve
19
-
20
- ```js
21
- const csv = runtime.resolve('csv');
22
- // Returns: { parse, stringify }
23
- ```
24
-
25
- ## API
26
-
27
- | Method | Signature | Returns |
28
- |--------|-----------|---------|
29
- | `parse` | `(text: string, options?) => any[][] \| Object[]` | Array of rows (array mode) or objects (header mode) |
30
- | `stringify` | `(data: Array<Array\|Object>, options?) => string` | CSV text terminated by `newline` |
31
-
32
- ### `parse` options
33
-
34
- | Option | Type | Default | Description |
35
- |--------|------|---------|-------------|
36
- | `delimiter` | `string` (1 char) | `','` | Field separator (`'\t'` for TSV, `';'` for EU-CSV). |
37
- | `quote` | `string` (1 char) | `'"'` | Quote character (RFC 4180 doubling rule). |
38
- | `header` | `boolean \| string[]` | `false` | `true`: consumes the first row as field names → `Object[]`. `string[]`: uses those names and keeps all rows. |
39
- | `skipEmpty` | `boolean` | `true` | Skip empty rows. |
40
- | `trim` | `boolean` | `false` | Trim whitespace around **unquoted** fields. |
41
- | `cast` | `boolean` | `false` | Auto-detect numeric / boolean / `null`. |
42
- | `comment` | `string \| null` | `null` | Comment-line start character to skip. |
43
- | `skipLines` | `number` | `0` | Skip the first N lines (after blank/comment). |
44
-
45
- ### `stringify` options
46
-
47
- | Option | Type | Default | Description |
48
- |--------|------|---------|-------------|
49
- | `delimiter` | `string` | `','` | Field separator. |
50
- | `quote` | `string` | `'"'` | Quote character. |
51
- | `newline` | `string` | `'\r\n'` | Line separator. |
52
- | `header` | `boolean \| string[]` | auto | Object mode: `false` suppresses the header, `string[]` forces column order. Array mode: `string[]` emits that header before the rows. |
53
-
54
- ## JS ↔ CSV mapping (stringify)
55
-
56
- | JS value | Output |
57
- |----------|--------|
58
- | `string` | as-is (quoted if contains delimiter/quote/`\r`/`\n`) |
59
- | `number`, `boolean`, `bigint` | decimal representation |
60
- | `null`, `undefined` | empty field |
61
- | `Date` | ISO 8601 (`toISOString`) |
62
-
63
- ## Examples
64
-
65
- ### Array mode (default)
66
-
67
- ```js
68
- const csv = runtime.resolve('csv');
69
-
70
- csv.parse('a,b,c\n1,2,3');
71
- // [['a','b','c'], ['1','2','3']]
72
-
73
- csv.stringify([['a','b'], [1, 2]]);
74
- // 'a,b\r\n1,2\r\n'
75
- ```
76
-
77
- ### Header mode (objects)
78
-
79
- ```js
80
- csv.parse('name,age\nAlice,30\nBob,25', { header: true, cast: true });
81
- // [{ name: 'Alice', age: 30 }, { name: 'Bob', age: 25 }]
82
-
83
- csv.stringify([
84
- { name: 'Alice', age: 30 },
85
- { name: 'Bob', age: 25 }
86
- ]);
87
- // 'name,age\r\nAlice,30\r\nBob,25\r\n'
88
-
89
- // Explicit column order
90
- csv.stringify(data, { header: ['age', 'name'] });
91
-
92
- // Suppress header
93
- csv.stringify(data, { header: false });
94
- ```
95
-
96
- ### Quoted fields and special characters
97
-
98
- ```js
99
- // Delimiter, quote, or line break in a field → automatic quoting
100
- csv.stringify([['a,b', 'say "hi"', 'line\nbreak']]);
101
- // '"a,b","say ""hi""","line\nbreak"\r\n'
102
-
103
- // Symmetric parse
104
- csv.parse('"a,b","say ""hi""","line\nbreak"');
105
- // [['a,b', 'say "hi"', 'line\nbreak']]
106
- ```
107
-
108
- ### Automatic casting
109
-
110
- ```js
111
- csv.parse('1,2.5,true,false,null,foo', { cast: true });
112
- // [[1, 2.5, true, false, null, 'foo']]
113
-
114
- // Integers outside the safe range remain as strings (no precision loss)
115
- csv.parse('12345678901234567890', { cast: true });
116
- // [['12345678901234567890']]
117
- ```
118
-
119
- ### Dialectes custom
120
-
121
- ```js
122
- // TSV
123
- csv.parse('a\tb\n1\t2', { delimiter: '\t' });
124
-
125
- // EU-CSV (semicolon)
126
- csv.parse('a;b;c\n1;2;3', { delimiter: ';' });
127
-
128
- // Sortie LF-only (Unix)
129
- csv.stringify(data, { newline: '\n' });
130
- ```
131
-
132
- ### File with preamble / comments
133
-
134
- ```js
135
- const text = `# exported 2024-01-01
136
- # version 2
137
- name,age
138
- Alice,30`;
139
-
140
- csv.parse(text, { header: true, comment: '#' });
141
- // [{ name: 'Alice', age: '30' }]
142
- ```
143
-
144
- ### Pre-supplied header (no header row in the file)
145
-
146
- ```js
147
- csv.parse('1,2\n3,4', { header: ['x', 'y'] });
148
- // [{ x: '1', y: '2' }, { x: '3', y: '4' }]
149
- ```
150
-
151
- ## Worker Usage
152
-
153
- ```js
154
- const worker = fw.createWorker(
155
- function ({ libs, args }) {
156
- const [text] = args;
157
- const rows = libs.csv.parse(text, { header: true, cast: true });
158
- self.postMessage(rows);
159
- },
160
- { dependencies: ['csv'], args: [csvText] }
161
- );
162
- ```
163
-
164
- ## Notes
165
-
166
- - **Text** API — to read/write files, compose with `utf8` (`utf8.fromBytes` / `utf8.toBytes`) or the browser Blob API.
167
- - The parser tolerates all three line-ending variants (LF, CR, CRLF) mixed within the same file; the encoder always uses `\r\n` by default (RFC 4180).
168
- - UTF-8 BOM (`\uFEFF`) at the start is automatically stripped during parsing.
169
- - `trim: true` **never** modifies a quoted field: trimming is only applied to unquoted fields to preserve the semantics of the original data.
170
- - Unterminated quoted field at end of stream → **throw** (`csv: unterminated quoted field`).
171
- - `delimiter` and `quote` must be exactly 1 character (RFC constraint) — otherwise throws.
172
- - `cast` does not coerce very large integers to `Number` (loss of precision): they remain as strings. For financial parsing / identifiers, use `cast: false` and convert explicitly to `BigInt`.
173
- - In object mode, `stringify` reads the keys of the **first** object to determine the header; subsequent objects missing a key receive an empty field. For deterministic ordering, pass `header: string[]`.
174
-
175
- ## See also
176
-
177
- - [utf8](./utf8.md) — to convert CSV text to bytes (`utf8.toBytes(csv.stringify(data))`)
178
- - [cbor](./cbor.md), [msgpack](./msgpack.md) — binary alternatives for structured data
1
+ ---
2
+ module: csv
3
+ category: io/codec
4
+ dependencies: []
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # csv
11
+
12
+ > CSV import/export (RFC 4180) for tabular data. Text API — compose with `utf8` for byte I/O.
13
+
14
+ **Module** `csv` | **Source** `packages/front/fw/src/io/codec/csv.js` | **Deps** none | **Worker-safe** yes
15
+
16
+ **Default dialect**: `,` delimiter, quote-doubling for escaping, `\r\n` line separator on output. The parser is tolerant: accepts LF, CR, CRLF, optional UTF-8 BOM, optional trailing newline. Custom dialects (TSV, semicolon-CSV, etc.) via `delimiter`/`quote`/`newline`.
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const csv = runtime.resolve('csv');
22
+ // Returns: { parse, stringify }
23
+ ```
24
+
25
+ ## API
26
+
27
+ | Method | Signature | Returns |
28
+ |--------|-----------|---------|
29
+ | `parse` | `(text: string, options?) => any[][] \| Object[]` | Array of rows (array mode) or objects (header mode) |
30
+ | `stringify` | `(data: Array<Array\|Object>, options?) => string` | CSV text terminated by `newline` |
31
+
32
+ ### `parse` options
33
+
34
+ | Option | Type | Default | Description |
35
+ |--------|------|---------|-------------|
36
+ | `delimiter` | `string` (1 char) | `','` | Field separator (`'\t'` for TSV, `';'` for EU-CSV). |
37
+ | `quote` | `string` (1 char) | `'"'` | Quote character (RFC 4180 doubling rule). |
38
+ | `header` | `boolean \| string[]` | `false` | `true`: consumes the first row as field names → `Object[]`. `string[]`: uses those names and keeps all rows. |
39
+ | `skipEmpty` | `boolean` | `true` | Skip empty rows. |
40
+ | `trim` | `boolean` | `false` | Trim whitespace around **unquoted** fields. |
41
+ | `cast` | `boolean` | `false` | Auto-detect numeric / boolean / `null`. |
42
+ | `comment` | `string \| null` | `null` | Comment-line start character to skip. |
43
+ | `skipLines` | `number` | `0` | Skip the first N lines (after blank/comment). |
44
+
45
+ ### `stringify` options
46
+
47
+ | Option | Type | Default | Description |
48
+ |--------|------|---------|-------------|
49
+ | `delimiter` | `string` | `','` | Field separator. |
50
+ | `quote` | `string` | `'"'` | Quote character. |
51
+ | `newline` | `string` | `'\r\n'` | Line separator. |
52
+ | `header` | `boolean \| string[]` | auto | Object mode: `false` suppresses the header, `string[]` forces column order. Array mode: `string[]` emits that header before the rows. |
53
+
54
+ ## JS ↔ CSV mapping (stringify)
55
+
56
+ | JS value | Output |
57
+ |----------|--------|
58
+ | `string` | as-is (quoted if contains delimiter/quote/`\r`/`\n`) |
59
+ | `number`, `boolean`, `bigint` | decimal representation |
60
+ | `null`, `undefined` | empty field |
61
+ | `Date` | ISO 8601 (`toISOString`) |
62
+
63
+ ## Examples
64
+
65
+ ### Array mode (default)
66
+
67
+ ```js
68
+ const csv = runtime.resolve('csv');
69
+
70
+ csv.parse('a,b,c\n1,2,3');
71
+ // [['a','b','c'], ['1','2','3']]
72
+
73
+ csv.stringify([['a','b'], [1, 2]]);
74
+ // 'a,b\r\n1,2\r\n'
75
+ ```
76
+
77
+ ### Header mode (objects)
78
+
79
+ ```js
80
+ csv.parse('name,age\nAlice,30\nBob,25', { header: true, cast: true });
81
+ // [{ name: 'Alice', age: 30 }, { name: 'Bob', age: 25 }]
82
+
83
+ csv.stringify([
84
+ { name: 'Alice', age: 30 },
85
+ { name: 'Bob', age: 25 }
86
+ ]);
87
+ // 'name,age\r\nAlice,30\r\nBob,25\r\n'
88
+
89
+ // Explicit column order
90
+ csv.stringify(data, { header: ['age', 'name'] });
91
+
92
+ // Suppress header
93
+ csv.stringify(data, { header: false });
94
+ ```
95
+
96
+ ### Quoted fields and special characters
97
+
98
+ ```js
99
+ // Delimiter, quote, or line break in a field → automatic quoting
100
+ csv.stringify([['a,b', 'say "hi"', 'line\nbreak']]);
101
+ // '"a,b","say ""hi""","line\nbreak"\r\n'
102
+
103
+ // Symmetric parse
104
+ csv.parse('"a,b","say ""hi""","line\nbreak"');
105
+ // [['a,b', 'say "hi"', 'line\nbreak']]
106
+ ```
107
+
108
+ ### Automatic casting
109
+
110
+ ```js
111
+ csv.parse('1,2.5,true,false,null,foo', { cast: true });
112
+ // [[1, 2.5, true, false, null, 'foo']]
113
+
114
+ // Integers outside the safe range remain as strings (no precision loss)
115
+ csv.parse('12345678901234567890', { cast: true });
116
+ // [['12345678901234567890']]
117
+ ```
118
+
119
+ ### Dialectes custom
120
+
121
+ ```js
122
+ // TSV
123
+ csv.parse('a\tb\n1\t2', { delimiter: '\t' });
124
+
125
+ // EU-CSV (semicolon)
126
+ csv.parse('a;b;c\n1;2;3', { delimiter: ';' });
127
+
128
+ // Sortie LF-only (Unix)
129
+ csv.stringify(data, { newline: '\n' });
130
+ ```
131
+
132
+ ### File with preamble / comments
133
+
134
+ ```js
135
+ const text = `# exported 2024-01-01
136
+ # version 2
137
+ name,age
138
+ Alice,30`;
139
+
140
+ csv.parse(text, { header: true, comment: '#' });
141
+ // [{ name: 'Alice', age: '30' }]
142
+ ```
143
+
144
+ ### Pre-supplied header (no header row in the file)
145
+
146
+ ```js
147
+ csv.parse('1,2\n3,4', { header: ['x', 'y'] });
148
+ // [{ x: '1', y: '2' }, { x: '3', y: '4' }]
149
+ ```
150
+
151
+ ## Worker Usage
152
+
153
+ ```js
154
+ const worker = fw.createWorker(
155
+ function ({ libs, args }) {
156
+ const [text] = args;
157
+ const rows = libs.csv.parse(text, { header: true, cast: true });
158
+ self.postMessage(rows);
159
+ },
160
+ { dependencies: ['csv'], args: [csvText] }
161
+ );
162
+ ```
163
+
164
+ ## Notes
165
+
166
+ - **Text** API — to read/write files, compose with `utf8` (`utf8.fromBytes` / `utf8.toBytes`) or the browser Blob API.
167
+ - The parser tolerates all three line-ending variants (LF, CR, CRLF) mixed within the same file; the encoder always uses `\r\n` by default (RFC 4180).
168
+ - UTF-8 BOM (`\uFEFF`) at the start is automatically stripped during parsing.
169
+ - `trim: true` **never** modifies a quoted field: trimming is only applied to unquoted fields to preserve the semantics of the original data.
170
+ - Unterminated quoted field at end of stream → **throw** (`csv: unterminated quoted field`).
171
+ - `delimiter` and `quote` must be exactly 1 character (RFC constraint) — otherwise throws.
172
+ - `cast` does not coerce very large integers to `Number` (loss of precision): they remain as strings. For financial parsing / identifiers, use `cast: false` and convert explicitly to `BigInt`.
173
+ - In object mode, `stringify` reads the keys of the **first** object to determine the header; subsequent objects missing a key receive an empty field. For deterministic ordering, pass `header: string[]`.
174
+
175
+ ## See also
176
+
177
+ - [utf8](./utf8.md) — to convert CSV text to bytes (`utf8.toBytes(csv.stringify(data))`)
178
+ - [cbor](./cbor.md), [msgpack](./msgpack.md) — binary alternatives for structured data
@@ -67,8 +67,16 @@ const worker = fw.createWorker(
67
67
  ## Notes
68
68
 
69
69
  - Output is always **lowercase** (`0-9a-f`).
70
- - `toBytes`: hex input parsed 2 characters at a time. Odd length → last character ignored.
71
- - No validation: invalid hex characters produce `NaN` bytes silently.
70
+ - `toBytes` is strict: an odd-length input throws `hex: odd-length input`,
71
+ a character outside `0-9a-fA-F` throws `hex: invalid character at index N`.
72
+ - `fromBytes` on a `Uint8Array` uses the platform's
73
+ `Uint8Array.prototype.toHex` where the realm has it (JavaScriptCore —
74
+ Safari, Bun — and Firefox); elsewhere (V8: Chrome, Node) a JS path writes
75
+ the digit pairs into a buffer and decodes it with `TextDecoder`
76
+ (`String.fromCharCode` in a realm without one). Same string either way;
77
+ 1 MiB encodes in about 0.6 ms (Bun) / 1.2 ms (Node).
78
+ - An array of numbers encodes each element's low 8 bits (`NaN` and holes
79
+ as `00`).
72
80
 
73
81
  ## See also
74
82
 
@@ -27,7 +27,7 @@ const msgpack = runtime.resolve('msgpack');
27
27
  | Method | Signature | Returns |
28
28
  |--------|-----------|---------|
29
29
  | `encode` | `(value: any) => Uint8Array` | MessagePack representation |
30
- | `decode` | `(bytes: Uint8Array, options?: {useMap?: boolean}) => any` | Reconstructed JS value |
30
+ | `decode` | `(bytes: Uint8Array, options?: {useMap?: boolean, maxDepth?: number}) => any` | Reconstructed JS value; nesting deeper than `maxDepth` (default 512) throws |
31
31
  | `Ext` | `class Ext(type, data)` | Ext wrapper (type ∈ [-128, 127], data: `Uint8Array`). Type -1 reserved for the standard timestamp (handled automatically via `Date`) |
32
32
 
33
33
  ## JS ↔ MessagePack mapping
@@ -124,6 +124,7 @@ const worker = fw.createWorker(
124
124
 
125
125
  ## Notes
126
126
 
127
+ - A map decoded to a plain object never takes its prototype from the payload: the object has a `null` prototype (`Object.create(null)`: no inherited key such as `toString` or `hasOwnProperty`; use `Object.hasOwn`), and a `"__proto__"` key is an own enumerable property holding the decoded value.
127
128
  - Integers and strings encoded in shortest form (fixint before int8/16/32, fixstr before str8/16/32, etc.).
128
129
  - Floats are emitted as `float32` if the value is exactly representable, otherwise `float64` — symmetric interop with msgpack-c, msgpack-python, msgpack-go.
129
130
  - `undefined` is encoded as `nil` (`0xc0`) and read back as `null` (information loss, consistent with reference implementations).
@@ -132,11 +133,11 @@ const worker = fw.createWorker(
132
133
  - Directly unsupported JS types: `Symbol`, `Function`, `Promise`.
133
134
  - Comparison:
134
135
  - [cbor](./cbor.md): richer (float16, typed tags, bignum, deterministic encoding for crypto), IETF standard.
135
- - [buffer](./buffer.md): awa internal format, most compact for small integers, non-interop.
136
+ - [buffer](./buffer.md): AWA internal format, most compact for small integers, non-interop.
136
137
  - `msgpack`: most widely used in the Redis / MongoDB / ZeroMQ / Fluentd ecosystem.
137
138
 
138
139
  ## See also
139
140
 
140
141
  - [cbor](./cbor.md) — IETF standard alternative
141
- - [buffer](./buffer.md) — awa internal binary format
142
+ - [buffer](./buffer.md) — AWA internal binary format
142
143
  - [utf8](./utf8.md) — dependency
@@ -19,7 +19,7 @@ status: complete
19
19
  - No nested parsing `user[name]=Alice`.
20
20
  - No `sort` or `skipNull` option.
21
21
 
22
- `url.parseURL` / `url.buildURL` use the native `URL` under the hood — they are simple wrappers that add the decomposed query and a symmetric API for building URLs.
22
+ `url.parseURL` uses the native `URL` under the hood and adds the decomposed query; `url.buildURL` is fw's own builder, the symmetric API. `buildURL(parseURL(x))` gives back `new URL(x).href`, except that a `+` in the query is written `%20`: `parseURL`'s `query` reads `+` as a space, as `URLSearchParams` and HTML forms do (`?q=fw+examples` → `{ q: 'fw examples' }`), so the round trip keeps the meaning; `parseURL(x, base, { space: 'percent' })` keeps a literal `+`, and a `%2B` is a `+` either way.
23
23
 
24
24
  ## Resolve
25
25
 
@@ -34,7 +34,7 @@ const url = runtime.resolve('url');
34
34
  |--------|-----------|---------|
35
35
  | `parseQuery` | `(str: string, options?) => Object` | Object from querystring |
36
36
  | `stringifyQuery` | `(obj: Object, options?) => string` | Querystring (without leading `?`) |
37
- | `parseURL` | `(str: string, base?: string) => URLParts` | Decomposed URL + parsed `.query` |
37
+ | `parseURL` | `(str: string, base?: string, options?: {space?: 'plus'\|'percent'}) => URLParts` | Decomposed URL + parsed `.query` (`+` = space by default) |
38
38
  | `buildURL` | `(parts: Object) => string` | Reconstructed URL |
39
39
  | `encodeSafe` | `(s: string, options?) => string` | URI encoded CommonMark / mdurl@2 style |
40
40
  | `decodeSafe` | `(s: string) => string` | Best-effort percent decoding (fail-soft) |
@@ -252,8 +252,9 @@ const worker = fw.createWorker(
252
252
  - Keys and values are percent-decoded/encoded via native `encodeURIComponent` / `decodeURIComponent`. An invalid decode (`%ZZ`) returns the raw string (fail-soft).
253
253
  - `arrayFormat: 'comma'` does **not** encode the `,` separator (common practice, compatible with OpenAPI `form` style). If values contain literal commas, use a different format.
254
254
  - `nested` is additive to `arrayFormat: brackets/indices` — both rely on the `[...]` notation in the key.
255
- - `parseURL` delegates to the native `URL` when available (browsers + workers + modern bun/node); a regex fallback exists for ultra-minimal environments.
255
+ - `parseURL` delegates to the native `URL` when available (browsers + workers + modern bun/node); a regex fallback exists for ultra-minimal environments. The fallback splits an already-normalised URL like `URL` does (IPv6 hosts included) but normalises nothing: no host case-folding, no default-port removal, no `.` / `..` path segments resolved, no percent-encoding of spaces or non-ASCII.
256
256
  - `buildURL` accepts `query` as an object **or** a string (e.g. an already-serialized query).
257
+ - `buildURL` writes `//` after the scheme when there is a host, or for a special scheme (`http`, `https`, `ws`, `wss`, `ftp`, `file`): `mailto:`, `urn:` and `data:` URLs rebuild without it.
257
258
  - Duplicate keys in `'none'` mode: the last one wins. In array modes, all occurrences are collected.
258
259
  - `encodeSafe` faithfully reproduces the `mdurl@2` (CommonMark) algorithm: default safe-set `";/?:@&=+$,-_.!~*'()#"`, pass-through of valid `%HH`, re-encoding of invalid `%`, surrogates → U+FFFD. Worker-safe (no DOM or side-effects).
259
260
  - `decodeSafe` is a fail-soft wrapper on `decodeURIComponent`: invalid sequences are returned as-is rather than throwing an exception.
@@ -75,9 +75,9 @@ const worker = fw.createWorker(
75
75
 
76
76
  ## Notes
77
77
 
78
- - Implemented via `encodeURI` (encoding) and manual decoding (decoding).
79
- - Supports 1, 2 and 3-byte sequences — covers the Unicode BMP (U+0000 to U+FFFF).
80
- - Non-BMP characters (emoji, etc.): represented as surrogate pairs via `encodeURI`.
78
+ - Implemented with the platform `TextEncoder` / `TextDecoder` (`fatal: false`) when present, and a manual encoder / decoder otherwise.
79
+ - 1- to 4-byte sequences: a surrogate pair (emoji and every non-BMP character) encodes to its 4-byte sequence.
80
+ - Malformed input never throws: an unpaired surrogate (high or low, at any position) encodes to U+FFFD (`EF BF BD`), as `TextEncoder` does; an invalid or truncated byte sequence decodes to U+FFFD.
81
81
 
82
82
  ## See also
83
83
 
@@ -29,7 +29,7 @@ const bs = runtime.resolve('bitstream');
29
29
 
30
30
  | Method | Signature | Returns |
31
31
  |--------|-----------|---------|
32
- | `readBits` | `(buf: Uint8Array, bitPos: number, mask: number) => number` | up to 16 bits at `bitPos`, masked |
32
+ | `readBits` | `(buf: Uint8Array, bitPos: number, mask: number) => number` | `width` bits at `bitPos`, masked, while `width + (bitPos & 7) <= 16` |
33
33
  | `readBits16` | `(buf: Uint8Array, bitPos: number) => number` | up to 24 bits at `bitPos`, **not** masked |
34
34
  | `writeBits` | `(buf: Uint8Array, bitPos: number, v: number) => void` | writes up to 16 bits (OR-into) |
35
35
  | `writeBits16` | `(buf: Uint8Array, bitPos: number, v: number) => void` | writes up to 24 bits (OR-into) |
@@ -40,8 +40,11 @@ const bs = runtime.resolve('bitstream');
40
40
 
41
41
  ### `readBits(buf, bitPos, mask)`
42
42
 
43
- Reads up to 16 bits starting at bit position `bitPos` (absolute index from
44
- the beginning of `buf`). The `mask` must be pre-computed by the caller as
43
+ Reads `width` bits starting at bit position `bitPos` (absolute index from
44
+ the beginning of `buf`) through a two-byte window: the result is exact while
45
+ `width + (bitPos & 7) <= 16` — 16 bits at a byte boundary, 9 at the worst
46
+ offset. Wider reads take `readBits16`. A guard test pins every offset and
47
+ width, and brotli's 4-bit code-length peek relies on it. The `mask` must be pre-computed by the caller as
45
48
  `(1 << nbits) - 1`. The explicit pattern allows the mask to be hoisted out
46
49
  of hot loops.
47
50
 
@@ -38,16 +38,23 @@ const br = runtime.resolve('brotli');
38
38
 
39
39
  | Option | Type | Default | Description |
40
40
  |--------|------|---------|-------------|
41
- | `quality` | `0..11` | `6` | Speed/ratio profile. `0` = trivial uncompressed. `1..3` = `chainDepth 2..4`, lazy off. `4..7` = `chainDepth 6..10`, lazy on. `8..11` = `chainDepth 16..32`, lazy + block splitting. |
41
+ | `quality` | `0..11` | `6` | Speed/ratio profile. `0` = trivial uncompressed. `1..3` = `chainDepth 2..4`, lazy off. `4..5` = `chainDepth 6`, lazy on. `6` = `chainDepth 10`, lazy, one literal block split. `7` = `chainDepth 64`, the search ended by a 32-byte match (20-50 % slower than `6`, JSON 2 % smaller). `8..9` = `chainDepth 64`, ended at 64 bytes. `10..11` = `chainDepth 128`, ended at 128 bytes. |
42
42
 
43
43
  The encoder automatically selects, per block, the best `CMODE` (LSB6/MSB6/UTF8/Signed) via entropy, the best `(NPOSTFIX, NDIRECT)` among 7 candidates by bit-cost, and enables block splitting `NBLTYPES_L = 2` on heterogeneous inputs ≥ 32 KiB (trigger: KL-divergence > 0.3).
44
44
 
45
+ ### Decompression options
46
+
47
+ | Option | Type | Default | Description |
48
+ |--------|------|---------|-------------|
49
+ | `maxOutput` | `number` | none | Cap, in bytes, on the decoded output (a non-negative integer). One byte more throws `EMAXOUT` before the buffer grows past the cap. On `BrotliDecompressStream` it caps the stream's total |
50
+
45
51
  ### Error codes
46
52
 
47
53
  | Code | Cause |
48
54
  |------|-------|
49
55
  | `EBADARG` | Argument not `Uint8Array`, `quality` outside `[0, 11]` |
50
56
  | `EBADSTREAM` | Invalid format (forbidden WBITS, non-zero fill bits, null MLEN top-nibble, dict-ref length outside `[4, 24]`, transform id ≥ 121, Kraft inequality violation, large-window prefix without `brotliShared`) |
57
+ | `EMAXOUT` | The decoded output would pass `maxOutput` |
51
58
  | `ENEEDDICT` | Stream requires the static dictionary but `brotliDictWords.isLoaded === false` |
52
59
  | `ESTREAMEND` | `push()` after finalization on a stream |
53
60
  | `ENOTIMPL` | Large-window WBITS > 50 (requires BigInt — out of scope) |
@@ -114,7 +121,7 @@ Streams that never use the dictionary (e.g. short text fully resolved by LZ77) d
114
121
  |---------|---------|---------|
115
122
  | §3 Compressed representation | ✅ | ✅ |
116
123
  | §3.4 / §3.5 Prefix codes (simple + complex) | ✅ | ✅ |
117
- | §4 Encoding of distances | ✅ | ✅ (NPOSTFIX 0..3, NDIRECT 0..120 best-of-7) |
124
+ | §4 Encoding of distances | ✅ | ✅ (NPOSTFIX 0..3, NDIRECT 0..120 best-of-7; distance cache codes 0..15, code 0 on implicit-distance symbols) |
118
125
  | §5 Insert/copy length codes | ✅ | ✅ |
119
126
  | §6 Block-switch | ✅ | ✅ (NBLTYPES_L ∈ {1, 2} KL-driven) |
120
127
  | §7 Context modelling | ✅ | ✅ (LSB6 / MSB6 / UTF8 / Signed entropy-adaptive) |
@@ -156,11 +163,36 @@ If the stream may reference the static dictionary, add `brotliDictWords` (+ load
156
163
  - Decoder **100% RFC 7932**: round-trips all qualities 0..11 of the native Node/Bun `zlib` encoder. Encoder produces conformant brotli always decodable by `zlib.brotliDecompressSync`.
157
164
  - **Truly incremental** streaming on the decoder side via the EAGAIN mechanism: on partial input, state is saved and restored on the next `push()` — no full buffering required. Compressor streaming remains buffered (future refactor for incremental).
158
165
  - The input buffer is wrapped in an internal reader that appends 4 zero padding bytes to avoid bounds-checks in bit reads up to 32 bits.
159
- - `_internal` exposes low-level primitives (`makeReader`, `readBit`, `readBits`, `readWBITS`, `readPrefixCode`, `readContextMap`, `readCompressedMetaBlockHeader`, `decodeDistanceSymbol`, `contextIdLit`, `encodeUncompressed`, …) for tests and companion modules (`brotliShared`).
160
- - Tests: 174 cases (hand-crafted vectors + Node `BROTLI_PARAM_QUALITY: 0..11` round-trip + all 121/121 transforms).
166
+ - The internal slot (`internalOf(brotli)`, tests only, not API) holds low-level primitives (`makeReader`, `readBit`, `readBits`, `readWBITS`, `readPrefixCode`, `readContextMap`, `readCompressedMetaBlockHeader`, `decodeDistanceSymbol`, `contextIdLit`, `encodeUncompressed`, …) for tests and companion modules (`brotliShared`).
167
+ - Tests: 176 cases (hand-crafted vectors + Node `BROTLI_PARAM_QUALITY: 0..11` round-trip + all 121/121 transforms).
168
+ - **Incompressible input** is stored (uncompressed meta-blocks, RFC 7932 §9.2) before LZ77 and the dictionary scan run: an order-0 entropy of at least 7.9 bits a byte over every 16th byte, then a repeat probe over content-defined anchors that finds repeats of a few hundred bytes up to about 1 MiB back. 256 KiB of uniform bytes encode in about 0.6 ms (Bun) / 1.1 ms (Node) at q6, with or without the dictionary blob.
169
+ - **Distance cache**: a copy whose distance is one of the last four (or the last two ±1..3) is coded with a cache code, without extra bits; a code is used only where its uses save at least 128 bits over full coding, so prose, whose distances rarely repeat, is coded as before. JSON-like input is 2-4 % smaller for it.
170
+ - **Ratio**: against the reference encoder at the same quality, on 256 KiB of English Markdown (this package's docs) with the dictionary blob loaded, the output is 4 % larger at q6 and 1.5 % at q7. Against its q6 on the bench's corpora, q6 output is 12 % larger on JSON and 4-5 % on source, q7's 10 % and 1-2 %; on the bench's text corpus (the dictionary's own word list, where every word is a dictionary hit) 15 % without the blob and 8 % with it at q6, 13 % and 7 % at q7. The built-in dictionary is used from 4-byte words. A copy whose bytes repeat at a cached distance takes that distance. Measured and left out: more literal trees (16 or 64: under 0.5 %) and block splitting of commands and distances (an upper bound of 1.2 %). The rest of the gap is the reference encoder's cost-aware parse, which prefers a cached distance to a slightly longer match.
171
+ - The encoder's output at every quality from 1 changed with that: smaller on every bench corpus, still decoded by every Brotli decoder.
172
+ - Two encoder defects were fixed: a literal run longer than 22 593 bytes followed by a match got a 2-byte copy that was never in the input, and fields wider than 17 bits (distance extras past about 512 KiB, insert code 23's 24 extra bits, MLEN past 2 MiB) lost their top bits. Both made streams that decode to other bytes; see `CHANGELOG.md`.
173
+ - The encoder's output at quality ≥ 4 changed once, when an `lz77` defect was fixed (a lazy match never entered its start into the hash chains): fewer tokens, smaller output (quality 6 text 40 986 → 40 952 bytes, quality 11 JSON 25 415 → 25 326), still decoded by every Brotli decoder. A consumer that pins encoder bytes, not just round-trips, sees the change.
161
174
 
162
175
  ## Benchmark
163
176
 
177
+ Current figures (`tools/bench/perf.js`, each cell in its own process,
178
+ median of the per-process medians; `brotli-q6d-*` load the dictionary
179
+ blob), 256 KiB corpora, `i7-13700KF`, Bun 1.3.13 / Node 24.16:
180
+
181
+ | Cell | Bun ms | Node ms | × native (Bun / Node) |
182
+ |---|---|---|---|
183
+ | encode q6 text | 9.1 | 9.1 | 3.6 / 2.9 |
184
+ | encode q6 json | 12.8 | 11.9 | 3.6 / 2.8 |
185
+ | encode q6 random | 0.62 | 1.09 | 1.4 / 0.7 |
186
+ | encode q6 text, dictionary loaded | 14.2 | 12.3 | 5.4 / 3.9 |
187
+ | encode q6 json, dictionary loaded | 12.9 | 13.4 | 3.7 / 3.3 |
188
+ | encode q6 random, dictionary loaded | 0.60 | 1.11 | 1.3 / 0.9 |
189
+ | decode q6 text (a `node:zlib` stream) | 1.67 | 1.56 | 4.8 / 4.1 |
190
+ | decode q6 json | 1.21 | 1.35 | 2.8 / 3.2 |
191
+ | decode q6 random | 0.15 | 0.19 | 1.3 / 1.0 |
192
+
193
+ The record below is the earlier gate of the `huffman` / `bitstream`
194
+ rewrite, kept for its method.
195
+
164
196
  `brotli.js` itself changed only for the decoder long-code peek fix and the
165
197
  encoder empty-tail-command fix (see Fixed in `CHANGELOG.md`); this record
166
198
  measures the effect on the `brotli` codec of the underlying
@@ -133,7 +133,7 @@ const worker = fw.createWorker(
133
133
  - The `opts._ext` channel consumed by `brotli` is internal — `brotliShared` is the only site that constructs it (`_buildExt(opts)`). Do not manipulate it directly from application code.
134
134
  - `_makeResolveStaticDictRef(customDict)` captures the multi-dict + contextMap configuration in a closure passed as a hook to the decoder. Resolution iterates in the order `[contextMap[cidL], 0, 1, ...]` (the context-pointed dict comes first).
135
135
  - WBITS 51..62 requires BigInt for distance arithmetic and a chunked buffer (Uint8Array caps at 4 GiB) — remains out of scope.
136
- - `_internal` exposes the helpers `ferment`, `shiftStep`, `shiftAddend`, `shiftFirst`, `shiftAll`, `applyCustomTransform`, `customLookupWord` for tests and tooling. Same conventions as `brotli._internal`.
136
+ - The internal slot (`internalOf(brotliShared)`, tests only, not API) holds the helpers `ferment`, `shiftStep`, `shiftAddend`, `shiftFirst`, `shiftAll`, `applyCustomTransform`, `customLookupWord` for tests and tooling. Same convention as `brotli`.
137
137
  - Tests: 14 cases (`parseSharedDictionary` happy/error paths + codec wrappers + `sharedDictionary` integration + large-window round-trips).
138
138
 
139
139
  ## See also