@awacloud/fw 0.1.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 (1057) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/LICENSE +176 -0
  3. package/NOTICE +12 -0
  4. package/README.md +355 -0
  5. package/dist/build/fw.core.pure.meta.json +29 -0
  6. package/dist/build/fw.core.pure.min.js +26 -0
  7. package/dist/build/fw.full.pure.meta.json +224 -0
  8. package/dist/build/fw.full.pure.min.js +60 -0
  9. package/dist/build/fw.minimal.pure.meta.json +21 -0
  10. package/dist/build/fw.minimal.pure.min.js +26 -0
  11. package/dist/build/fw.pack.compress-heavy.pure.meta.json +29 -0
  12. package/dist/build/fw.pack.compress-heavy.pure.min.js +8 -0
  13. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +38 -0
  14. package/dist/build/fw.pack.crypto-advanced.pure.min.js +6 -0
  15. package/dist/build/fw.pack.crypto-basic.pure.meta.json +29 -0
  16. package/dist/build/fw.pack.crypto-basic.pure.min.js +6 -0
  17. package/dist/build/fw.pack.crypto-identity.pure.meta.json +29 -0
  18. package/dist/build/fw.pack.crypto-identity.pure.min.js +9 -0
  19. package/dist/build/fw.pack.realtime.pure.meta.json +21 -0
  20. package/dist/build/fw.pack.realtime.pure.min.js +6 -0
  21. package/dist/build/fw.pack.sensors.pure.meta.json +21 -0
  22. package/dist/build/fw.pack.sensors.pure.min.js +6 -0
  23. package/dist/build/fw.pack.structures-advanced.pure.meta.json +20 -0
  24. package/dist/build/fw.pack.structures-advanced.pure.min.js +6 -0
  25. package/dist/build/fw.pack.text-advanced.pure.meta.json +20 -0
  26. package/dist/build/fw.pack.text-advanced.pure.min.js +6 -0
  27. package/dist/build/fw.pwa.pure.meta.json +127 -0
  28. package/dist/build/fw.pwa.pure.min.js +55 -0
  29. package/dist/build/fw.site-interactive.pure.meta.json +81 -0
  30. package/dist/build/fw.site-interactive.pure.min.js +52 -0
  31. package/dist/build/fw.site.pure.meta.json +51 -0
  32. package/dist/build/fw.site.pure.min.js +35 -0
  33. package/dist/build/fw.spa.pure.meta.json +108 -0
  34. package/dist/build/fw.spa.pure.min.js +55 -0
  35. package/dist/build/io/compress/brotli_dict.bin +432 -0
  36. package/dist/build/sanity-base-classic.min.js +6 -0
  37. package/dist/build/sanity-community-classic.min.js +6 -0
  38. package/dist/build/sanity.min.js +6 -0
  39. package/dist/types/core/logger.d.ts +71 -0
  40. package/dist/types/core/logger.d.ts.map +1 -0
  41. package/dist/types/core/modules.d.ts +3962 -0
  42. package/dist/types/core/modules.d.ts.map +1 -0
  43. package/dist/types/core/readyState.d.ts +14 -0
  44. package/dist/types/core/readyState.d.ts.map +1 -0
  45. package/dist/types/core/runtime.d.ts +625 -0
  46. package/dist/types/core/runtime.d.ts.map +1 -0
  47. package/dist/types/core/worker-helper.d.ts +153 -0
  48. package/dist/types/core/worker-helper.d.ts.map +1 -0
  49. package/dist/types/crypto/cipher/aes.d.ts +55 -0
  50. package/dist/types/crypto/cipher/aes.d.ts.map +1 -0
  51. package/dist/types/crypto/cipher/chacha20.d.ts +33 -0
  52. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -0
  53. package/dist/types/crypto/hash/adf.d.ts +65 -0
  54. package/dist/types/crypto/hash/adf.d.ts.map +1 -0
  55. package/dist/types/crypto/hash/argon2.d.ts +79 -0
  56. package/dist/types/crypto/hash/argon2.d.ts.map +1 -0
  57. package/dist/types/crypto/hash/blake2b.d.ts +40 -0
  58. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -0
  59. package/dist/types/crypto/hash/hkdf.d.ts +88 -0
  60. package/dist/types/crypto/hash/hkdf.d.ts.map +1 -0
  61. package/dist/types/crypto/hash/hmac.d.ts +85 -0
  62. package/dist/types/crypto/hash/hmac.d.ts.map +1 -0
  63. package/dist/types/crypto/hash/pbkdf2.d.ts +80 -0
  64. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -0
  65. package/dist/types/crypto/hash/poly1305.d.ts +31 -0
  66. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -0
  67. package/dist/types/crypto/hash/sha224.d.ts +80 -0
  68. package/dist/types/crypto/hash/sha224.d.ts.map +1 -0
  69. package/dist/types/crypto/hash/sha256.d.ts +82 -0
  70. package/dist/types/crypto/hash/sha256.d.ts.map +1 -0
  71. package/dist/types/crypto/hash/sha3.d.ts +111 -0
  72. package/dist/types/crypto/hash/sha3.d.ts.map +1 -0
  73. package/dist/types/crypto/hash/sha384.d.ts +84 -0
  74. package/dist/types/crypto/hash/sha384.d.ts.map +1 -0
  75. package/dist/types/crypto/hash/sha512.d.ts +87 -0
  76. package/dist/types/crypto/hash/sha512.d.ts.map +1 -0
  77. package/dist/types/crypto/hash/sha512_224.d.ts +84 -0
  78. package/dist/types/crypto/hash/sha512_224.d.ts.map +1 -0
  79. package/dist/types/crypto/hash/sha512_256.d.ts +84 -0
  80. package/dist/types/crypto/hash/sha512_256.d.ts.map +1 -0
  81. package/dist/types/crypto/mode/cbc.d.ts +38 -0
  82. package/dist/types/crypto/mode/cbc.d.ts.map +1 -0
  83. package/dist/types/crypto/mode/chacha20poly1305.d.ts +71 -0
  84. package/dist/types/crypto/mode/chacha20poly1305.d.ts.map +1 -0
  85. package/dist/types/crypto/mode/cmac.d.ts +56 -0
  86. package/dist/types/crypto/mode/cmac.d.ts.map +1 -0
  87. package/dist/types/crypto/mode/ctr.d.ts +52 -0
  88. package/dist/types/crypto/mode/ctr.d.ts.map +1 -0
  89. package/dist/types/crypto/mode/gcm.d.ts +88 -0
  90. package/dist/types/crypto/mode/gcm.d.ts.map +1 -0
  91. package/dist/types/crypto/mode/kw.d.ts +60 -0
  92. package/dist/types/crypto/mode/kw.d.ts.map +1 -0
  93. package/dist/types/crypto/pkc/ecc.d.ts +284 -0
  94. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -0
  95. package/dist/types/crypto/pkc/ed25519.d.ts +107 -0
  96. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -0
  97. package/dist/types/crypto/pkc/hybridKem.d.ts +154 -0
  98. package/dist/types/crypto/pkc/hybridKem.d.ts.map +1 -0
  99. package/dist/types/crypto/pkc/hybridSign.d.ts +383 -0
  100. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -0
  101. package/dist/types/crypto/pkc/ml_dsa.d.ts +174 -0
  102. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -0
  103. package/dist/types/crypto/pkc/ml_kem.d.ts +194 -0
  104. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -0
  105. package/dist/types/crypto/pkc/rsa.d.ts +175 -0
  106. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -0
  107. package/dist/types/crypto/pkc/slh_dsa.d.ts +232 -0
  108. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -0
  109. package/dist/types/crypto/pkc/x25519.d.ts +37 -0
  110. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -0
  111. package/dist/types/crypto/utils/aes_ctr.d.ts +84 -0
  112. package/dist/types/crypto/utils/aes_ctr.d.ts.map +1 -0
  113. package/dist/types/crypto/utils/aes_modes.d.ts +128 -0
  114. package/dist/types/crypto/utils/aes_modes.d.ts.map +1 -0
  115. package/dist/types/crypto/utils/asn1-oid.d.ts +45 -0
  116. package/dist/types/crypto/utils/asn1-oid.d.ts.map +1 -0
  117. package/dist/types/crypto/utils/asn1.d.ts +115 -0
  118. package/dist/types/crypto/utils/asn1.d.ts.map +1 -0
  119. package/dist/types/crypto/utils/bitArray.d.ts +75 -0
  120. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -0
  121. package/dist/types/crypto/utils/bn.d.ts +214 -0
  122. package/dist/types/crypto/utils/bn.d.ts.map +1 -0
  123. package/dist/types/crypto/utils/jws.d.ts +159 -0
  124. package/dist/types/crypto/utils/jws.d.ts.map +1 -0
  125. package/dist/types/crypto/utils/keyformat.d.ts +100 -0
  126. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -0
  127. package/dist/types/crypto/utils/pad.d.ts +44 -0
  128. package/dist/types/crypto/utils/pad.d.ts.map +1 -0
  129. package/dist/types/crypto/utils/pem.d.ts +41 -0
  130. package/dist/types/crypto/utils/pem.d.ts.map +1 -0
  131. package/dist/types/crypto/utils/random.d.ts +203 -0
  132. package/dist/types/crypto/utils/random.d.ts.map +1 -0
  133. package/dist/types/crypto/utils/rsaKeygen.d.ts +162 -0
  134. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -0
  135. package/dist/types/crypto/utils/totp.d.ts +183 -0
  136. package/dist/types/crypto/utils/totp.d.ts.map +1 -0
  137. package/dist/types/crypto/utils/uuid.d.ts +29 -0
  138. package/dist/types/crypto/utils/uuid.d.ts.map +1 -0
  139. package/dist/types/crypto/wasm/aes.d.ts +59 -0
  140. package/dist/types/crypto/wasm/aes.d.ts.map +1 -0
  141. package/dist/types/crypto/wasm/argon2.d.ts +70 -0
  142. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -0
  143. package/dist/types/crypto/wasm/blake2b.d.ts +59 -0
  144. package/dist/types/crypto/wasm/blake2b.d.ts.map +1 -0
  145. package/dist/types/crypto/wasm/chacha20poly1305.d.ts +43 -0
  146. package/dist/types/crypto/wasm/chacha20poly1305.d.ts.map +1 -0
  147. package/dist/types/crypto/wasm/cmac.d.ts +42 -0
  148. package/dist/types/crypto/wasm/cmac.d.ts.map +1 -0
  149. package/dist/types/crypto/wasm/ecc.d.ts +56 -0
  150. package/dist/types/crypto/wasm/ecc.d.ts.map +1 -0
  151. package/dist/types/crypto/wasm/ed25519.d.ts +52 -0
  152. package/dist/types/crypto/wasm/ed25519.d.ts.map +1 -0
  153. package/dist/types/crypto/wasm/hkdf.d.ts +40 -0
  154. package/dist/types/crypto/wasm/hkdf.d.ts.map +1 -0
  155. package/dist/types/crypto/wasm/hmac.d.ts +42 -0
  156. package/dist/types/crypto/wasm/hmac.d.ts.map +1 -0
  157. package/dist/types/crypto/wasm/ml_dsa.d.ts +48 -0
  158. package/dist/types/crypto/wasm/ml_dsa.d.ts.map +1 -0
  159. package/dist/types/crypto/wasm/ml_kem.d.ts +58 -0
  160. package/dist/types/crypto/wasm/ml_kem.d.ts.map +1 -0
  161. package/dist/types/crypto/wasm/pbkdf2.d.ts +38 -0
  162. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -0
  163. package/dist/types/crypto/wasm/rsa.d.ts +56 -0
  164. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -0
  165. package/dist/types/crypto/wasm/runtime.d.ts +99 -0
  166. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -0
  167. package/dist/types/crypto/wasm/sha2.d.ts +45 -0
  168. package/dist/types/crypto/wasm/sha2.d.ts.map +1 -0
  169. package/dist/types/crypto/wasm/sha3.d.ts +57 -0
  170. package/dist/types/crypto/wasm/sha3.d.ts.map +1 -0
  171. package/dist/types/crypto/wasm/slh_dsa.d.ts +62 -0
  172. package/dist/types/crypto/wasm/slh_dsa.d.ts.map +1 -0
  173. package/dist/types/crypto/wasm/x25519.d.ts +53 -0
  174. package/dist/types/crypto/wasm/x25519.d.ts.map +1 -0
  175. package/dist/types/crypto/webcrypto/aes.d.ts +59 -0
  176. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -0
  177. package/dist/types/crypto/webcrypto/aeskw.d.ts +40 -0
  178. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -0
  179. package/dist/types/crypto/webcrypto/digest.d.ts +43 -0
  180. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -0
  181. package/dist/types/crypto/webcrypto/ecc.d.ts +51 -0
  182. package/dist/types/crypto/webcrypto/ecc.d.ts.map +1 -0
  183. package/dist/types/crypto/webcrypto/ed25519.d.ts +43 -0
  184. package/dist/types/crypto/webcrypto/ed25519.d.ts.map +1 -0
  185. package/dist/types/crypto/webcrypto/hkdf.d.ts +18 -0
  186. package/dist/types/crypto/webcrypto/hkdf.d.ts.map +1 -0
  187. package/dist/types/crypto/webcrypto/hmac.d.ts +43 -0
  188. package/dist/types/crypto/webcrypto/hmac.d.ts.map +1 -0
  189. package/dist/types/crypto/webcrypto/pbkdf2.d.ts +18 -0
  190. package/dist/types/crypto/webcrypto/pbkdf2.d.ts.map +1 -0
  191. package/dist/types/crypto/webcrypto/rsa.d.ts +51 -0
  192. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -0
  193. package/dist/types/crypto/webcrypto/x25519.d.ts +43 -0
  194. package/dist/types/crypto/webcrypto/x25519.d.ts.map +1 -0
  195. package/dist/types/dom/display/animate.d.ts +35 -0
  196. package/dist/types/dom/display/animate.d.ts.map +1 -0
  197. package/dist/types/dom/display/fullscreen.d.ts +59 -0
  198. package/dist/types/dom/display/fullscreen.d.ts.map +1 -0
  199. package/dist/types/dom/fs/download.d.ts +36 -0
  200. package/dist/types/dom/fs/download.d.ts.map +1 -0
  201. package/dist/types/dom/fs/fsAccess.d.ts +107 -0
  202. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -0
  203. package/dist/types/dom/fs/indexedDB.d.ts +62 -0
  204. package/dist/types/dom/fs/indexedDB.d.ts.map +1 -0
  205. package/dist/types/dom/fs/remoteStore.d.ts +64 -0
  206. package/dist/types/dom/fs/remoteStore.d.ts.map +1 -0
  207. package/dist/types/dom/fs/storage.d.ts +56 -0
  208. package/dist/types/dom/fs/storage.d.ts.map +1 -0
  209. package/dist/types/dom/lifecycle/idle.d.ts +91 -0
  210. package/dist/types/dom/lifecycle/idle.d.ts.map +1 -0
  211. package/dist/types/dom/lifecycle/visibility.d.ts +49 -0
  212. package/dist/types/dom/lifecycle/visibility.d.ts.map +1 -0
  213. package/dist/types/dom/lifecycle/wakeLock.d.ts +69 -0
  214. package/dist/types/dom/lifecycle/wakeLock.d.ts.map +1 -0
  215. package/dist/types/dom/net/ajax.d.ts +27 -0
  216. package/dist/types/dom/net/ajax.d.ts.map +1 -0
  217. package/dist/types/dom/net/broadcastChannel.d.ts +51 -0
  218. package/dist/types/dom/net/broadcastChannel.d.ts.map +1 -0
  219. package/dist/types/dom/net/network.d.ts +80 -0
  220. package/dist/types/dom/net/network.d.ts.map +1 -0
  221. package/dist/types/dom/net/sse.d.ts +72 -0
  222. package/dist/types/dom/net/sse.d.ts.map +1 -0
  223. package/dist/types/dom/net/webrtc.d.ts +149 -0
  224. package/dist/types/dom/net/webrtc.d.ts.map +1 -0
  225. package/dist/types/dom/net/ws.d.ts +70 -0
  226. package/dist/types/dom/net/ws.d.ts.map +1 -0
  227. package/dist/types/dom/query/dnd.d.ts +86 -0
  228. package/dist/types/dom/query/dnd.d.ts.map +1 -0
  229. package/dist/types/dom/query/dom.d.ts +194 -0
  230. package/dist/types/dom/query/dom.d.ts.map +1 -0
  231. package/dist/types/dom/query/events.d.ts +135 -0
  232. package/dist/types/dom/query/events.d.ts.map +1 -0
  233. package/dist/types/dom/query/gesture.d.ts +59 -0
  234. package/dist/types/dom/query/gesture.d.ts.map +1 -0
  235. package/dist/types/dom/query/media.d.ts +156 -0
  236. package/dist/types/dom/query/media.d.ts.map +1 -0
  237. package/dist/types/dom/rendering/chart.d.ts +143 -0
  238. package/dist/types/dom/rendering/chart.d.ts.map +1 -0
  239. package/dist/types/dom/rendering/component.d.ts +92 -0
  240. package/dist/types/dom/rendering/component.d.ts.map +1 -0
  241. package/dist/types/dom/rendering/devtools-ui.d.ts +83 -0
  242. package/dist/types/dom/rendering/devtools-ui.d.ts.map +1 -0
  243. package/dist/types/dom/rendering/devtools.d.ts +68 -0
  244. package/dist/types/dom/rendering/devtools.d.ts.map +1 -0
  245. package/dist/types/dom/rendering/parser.d.ts +216 -0
  246. package/dist/types/dom/rendering/parser.d.ts.map +1 -0
  247. package/dist/types/dom/rendering/reactiveBind.d.ts +101 -0
  248. package/dist/types/dom/rendering/reactiveBind.d.ts.map +1 -0
  249. package/dist/types/dom/rendering/render.d.ts +121 -0
  250. package/dist/types/dom/rendering/render.d.ts.map +1 -0
  251. package/dist/types/dom/rendering/sanitize.d.ts +48 -0
  252. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -0
  253. package/dist/types/dom/rendering/secPolicy.d.ts +89 -0
  254. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -0
  255. package/dist/types/dom/rendering/template.d.ts +251 -0
  256. package/dist/types/dom/rendering/template.d.ts.map +1 -0
  257. package/dist/types/dom/rendering/themeTokens.d.ts +61 -0
  258. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -0
  259. package/dist/types/dom/rendering/uiSession-core.d.ts +192 -0
  260. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -0
  261. package/dist/types/dom/rendering/uiSession-direct.d.ts +63 -0
  262. package/dist/types/dom/rendering/uiSession-direct.d.ts.map +1 -0
  263. package/dist/types/dom/rendering/uiSession-list.d.ts +205 -0
  264. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -0
  265. package/dist/types/dom/rendering/uiSession.d.ts +285 -0
  266. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -0
  267. package/dist/types/dom/rendering/virtualScroll.d.ts +80 -0
  268. package/dist/types/dom/rendering/virtualScroll.d.ts.map +1 -0
  269. package/dist/types/dom/sensors/battery.d.ts +71 -0
  270. package/dist/types/dom/sensors/battery.d.ts.map +1 -0
  271. package/dist/types/dom/sensors/geolocation.d.ts +83 -0
  272. package/dist/types/dom/sensors/geolocation.d.ts.map +1 -0
  273. package/dist/types/dom/sensors/networkInfo.d.ts +82 -0
  274. package/dist/types/dom/sensors/networkInfo.d.ts.map +1 -0
  275. package/dist/types/dom/sensors/sensors.d.ts +191 -0
  276. package/dist/types/dom/sensors/sensors.d.ts.map +1 -0
  277. package/dist/types/dom/sw/backgroundSync.d.ts +48 -0
  278. package/dist/types/dom/sw/backgroundSync.d.ts.map +1 -0
  279. package/dist/types/dom/sw/cache.d.ts +71 -0
  280. package/dist/types/dom/sw/cache.d.ts.map +1 -0
  281. package/dist/types/dom/sw/push.d.ts +77 -0
  282. package/dist/types/dom/sw/push.d.ts.map +1 -0
  283. package/dist/types/dom/sw/serviceWorker.d.ts +57 -0
  284. package/dist/types/dom/sw/serviceWorker.d.ts.map +1 -0
  285. package/dist/types/dom/sw/sharedWorker.d.ts +81 -0
  286. package/dist/types/dom/sw/sharedWorker.d.ts.map +1 -0
  287. package/dist/types/dom/utils/a11y.d.ts +53 -0
  288. package/dist/types/dom/utils/a11y.d.ts.map +1 -0
  289. package/dist/types/dom/utils/clipboard.d.ts +44 -0
  290. package/dist/types/dom/utils/clipboard.d.ts.map +1 -0
  291. package/dist/types/dom/utils/entropyCollector.d.ts +58 -0
  292. package/dist/types/dom/utils/entropyCollector.d.ts.map +1 -0
  293. package/dist/types/dom/utils/focus.d.ts +123 -0
  294. package/dist/types/dom/utils/focus.d.ts.map +1 -0
  295. package/dist/types/dom/utils/form.d.ts +227 -0
  296. package/dist/types/dom/utils/form.d.ts.map +1 -0
  297. package/dist/types/dom/utils/formKit.d.ts +206 -0
  298. package/dist/types/dom/utils/formKit.d.ts.map +1 -0
  299. package/dist/types/dom/utils/keybindings.d.ts +53 -0
  300. package/dist/types/dom/utils/keybindings.d.ts.map +1 -0
  301. package/dist/types/dom/utils/leaderElection.d.ts +70 -0
  302. package/dist/types/dom/utils/leaderElection.d.ts.map +1 -0
  303. package/dist/types/dom/utils/notifications.d.ts +164 -0
  304. package/dist/types/dom/utils/notifications.d.ts.map +1 -0
  305. package/dist/types/dom/utils/permissions.d.ts +35 -0
  306. package/dist/types/dom/utils/permissions.d.ts.map +1 -0
  307. package/dist/types/dom/utils/route.d.ts +117 -0
  308. package/dist/types/dom/utils/route.d.ts.map +1 -0
  309. package/dist/types/dom/utils/ua.d.ts +35 -0
  310. package/dist/types/dom/utils/ua.d.ts.map +1 -0
  311. package/dist/types/dom/utils/webauthn.d.ts +98 -0
  312. package/dist/types/dom/utils/webauthn.d.ts.map +1 -0
  313. package/dist/types/io/binary/reader.d.ts +59 -0
  314. package/dist/types/io/binary/reader.d.ts.map +1 -0
  315. package/dist/types/io/binary/writer.d.ts +56 -0
  316. package/dist/types/io/binary/writer.d.ts.map +1 -0
  317. package/dist/types/io/calc/adler32.d.ts +31 -0
  318. package/dist/types/io/calc/adler32.d.ts.map +1 -0
  319. package/dist/types/io/calc/bigint.d.ts +74 -0
  320. package/dist/types/io/calc/bigint.d.ts.map +1 -0
  321. package/dist/types/io/calc/crc32.d.ts +36 -0
  322. package/dist/types/io/calc/crc32.d.ts.map +1 -0
  323. package/dist/types/io/calc/easing.d.ts +60 -0
  324. package/dist/types/io/calc/easing.d.ts.map +1 -0
  325. package/dist/types/io/codec/b64.d.ts +28 -0
  326. package/dist/types/io/codec/b64.d.ts.map +1 -0
  327. package/dist/types/io/codec/base32.d.ts +28 -0
  328. package/dist/types/io/codec/base32.d.ts.map +1 -0
  329. package/dist/types/io/codec/base58.d.ts +28 -0
  330. package/dist/types/io/codec/base58.d.ts.map +1 -0
  331. package/dist/types/io/codec/buffer.d.ts +66 -0
  332. package/dist/types/io/codec/buffer.d.ts.map +1 -0
  333. package/dist/types/io/codec/cbor.d.ts +43 -0
  334. package/dist/types/io/codec/cbor.d.ts.map +1 -0
  335. package/dist/types/io/codec/csv.d.ts +35 -0
  336. package/dist/types/io/codec/csv.d.ts.map +1 -0
  337. package/dist/types/io/codec/hex.d.ts +28 -0
  338. package/dist/types/io/codec/hex.d.ts.map +1 -0
  339. package/dist/types/io/codec/mime.d.ts +100 -0
  340. package/dist/types/io/codec/mime.d.ts.map +1 -0
  341. package/dist/types/io/codec/msgpack.d.ts +36 -0
  342. package/dist/types/io/codec/msgpack.d.ts.map +1 -0
  343. package/dist/types/io/codec/url.d.ts +52 -0
  344. package/dist/types/io/codec/url.d.ts.map +1 -0
  345. package/dist/types/io/codec/utf8.d.ts +22 -0
  346. package/dist/types/io/codec/utf8.d.ts.map +1 -0
  347. package/dist/types/io/codec/xml.d.ts +91 -0
  348. package/dist/types/io/codec/xml.d.ts.map +1 -0
  349. package/dist/types/io/compress/bitstream.d.ts +51 -0
  350. package/dist/types/io/compress/bitstream.d.ts.map +1 -0
  351. package/dist/types/io/compress/brotli.d.ts +86 -0
  352. package/dist/types/io/compress/brotli.d.ts.map +1 -0
  353. package/dist/types/io/compress/brotli_dict.d.ts +76 -0
  354. package/dist/types/io/compress/brotli_dict.d.ts.map +1 -0
  355. package/dist/types/io/compress/brotli_dict_words.d.ts +43 -0
  356. package/dist/types/io/compress/brotli_dict_words.d.ts.map +1 -0
  357. package/dist/types/io/compress/brotli_frame.d.ts +166 -0
  358. package/dist/types/io/compress/brotli_frame.d.ts.map +1 -0
  359. package/dist/types/io/compress/brotli_shared.d.ts +165 -0
  360. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -0
  361. package/dist/types/io/compress/deflate.d.ts +89 -0
  362. package/dist/types/io/compress/deflate.d.ts.map +1 -0
  363. package/dist/types/io/compress/gzip.d.ts +100 -0
  364. package/dist/types/io/compress/gzip.d.ts.map +1 -0
  365. package/dist/types/io/compress/huffman.d.ts +37 -0
  366. package/dist/types/io/compress/huffman.d.ts.map +1 -0
  367. package/dist/types/io/compress/lz4.d.ts +45 -0
  368. package/dist/types/io/compress/lz4.d.ts.map +1 -0
  369. package/dist/types/io/compress/lz77.d.ts +66 -0
  370. package/dist/types/io/compress/lz77.d.ts.map +1 -0
  371. package/dist/types/io/compress/lzw.d.ts +37 -0
  372. package/dist/types/io/compress/lzw.d.ts.map +1 -0
  373. package/dist/types/io/compress/zip.d.ts +112 -0
  374. package/dist/types/io/compress/zip.d.ts.map +1 -0
  375. package/dist/types/io/compress/zlib.d.ts +97 -0
  376. package/dist/types/io/compress/zlib.d.ts.map +1 -0
  377. package/dist/types/io/i18n/i18n.d.ts +64 -0
  378. package/dist/types/io/i18n/i18n.d.ts.map +1 -0
  379. package/dist/types/io/math/fixed-point.d.ts +30 -0
  380. package/dist/types/io/math/fixed-point.d.ts.map +1 -0
  381. package/dist/types/io/math/geom.d.ts +125 -0
  382. package/dist/types/io/math/geom.d.ts.map +1 -0
  383. package/dist/types/io/math/interp.d.ts +48 -0
  384. package/dist/types/io/math/interp.d.ts.map +1 -0
  385. package/dist/types/io/math/linalg.d.ts +117 -0
  386. package/dist/types/io/math/linalg.d.ts.map +1 -0
  387. package/dist/types/io/math/stats.d.ts +45 -0
  388. package/dist/types/io/math/stats.d.ts.map +1 -0
  389. package/dist/types/io/structures/btree.d.ts +84 -0
  390. package/dist/types/io/structures/btree.d.ts.map +1 -0
  391. package/dist/types/io/structures/heap.d.ts +75 -0
  392. package/dist/types/io/structures/heap.d.ts.map +1 -0
  393. package/dist/types/io/structures/lruCache.d.ts +88 -0
  394. package/dist/types/io/structures/lruCache.d.ts.map +1 -0
  395. package/dist/types/io/structures/ringBuffer.d.ts +82 -0
  396. package/dist/types/io/structures/ringBuffer.d.ts.map +1 -0
  397. package/dist/types/io/structures/tree-walker.d.ts +95 -0
  398. package/dist/types/io/structures/tree-walker.d.ts.map +1 -0
  399. package/dist/types/io/structures/trie.d.ts +71 -0
  400. package/dist/types/io/structures/trie.d.ts.map +1 -0
  401. package/dist/types/io/sync/abort.d.ts +59 -0
  402. package/dist/types/io/sync/abort.d.ts.map +1 -0
  403. package/dist/types/io/sync/atomics.d.ts +107 -0
  404. package/dist/types/io/sync/atomics.d.ts.map +1 -0
  405. package/dist/types/io/sync/cancellable.d.ts +69 -0
  406. package/dist/types/io/sync/cancellable.d.ts.map +1 -0
  407. package/dist/types/io/sync/channel.d.ts +70 -0
  408. package/dist/types/io/sync/channel.d.ts.map +1 -0
  409. package/dist/types/io/sync/mutex.d.ts +39 -0
  410. package/dist/types/io/sync/mutex.d.ts.map +1 -0
  411. package/dist/types/io/sync/semaphore.d.ts +40 -0
  412. package/dist/types/io/sync/semaphore.d.ts.map +1 -0
  413. package/dist/types/io/sync/tokenBucket.d.ts +53 -0
  414. package/dist/types/io/sync/tokenBucket.d.ts.map +1 -0
  415. package/dist/types/io/text/ansi.d.ts +125 -0
  416. package/dist/types/io/text/ansi.d.ts.map +1 -0
  417. package/dist/types/io/text/html-entities.d.ts +35 -0
  418. package/dist/types/io/text/html-entities.d.ts.map +1 -0
  419. package/dist/types/io/text/semver.d.ts +75 -0
  420. package/dist/types/io/text/semver.d.ts.map +1 -0
  421. package/dist/types/io/text/str.d.ts +88 -0
  422. package/dist/types/io/text/str.d.ts.map +1 -0
  423. package/dist/types/io/text/unicode.d.ts +70 -0
  424. package/dist/types/io/text/unicode.d.ts.map +1 -0
  425. package/dist/types/io/time/date.d.ts +73 -0
  426. package/dist/types/io/time/date.d.ts.map +1 -0
  427. package/dist/types/io/timing/clock.d.ts +39 -0
  428. package/dist/types/io/timing/clock.d.ts.map +1 -0
  429. package/dist/types/io/timing/rateLimit.d.ts +40 -0
  430. package/dist/types/io/timing/rateLimit.d.ts.map +1 -0
  431. package/dist/types/io/timing/scheduler.d.ts +122 -0
  432. package/dist/types/io/timing/scheduler.d.ts.map +1 -0
  433. package/dist/types/io/utils/bitmap.d.ts +34 -0
  434. package/dist/types/io/utils/bitmap.d.ts.map +1 -0
  435. package/dist/types/io/utils/errors.d.ts +94 -0
  436. package/dist/types/io/utils/errors.d.ts.map +1 -0
  437. package/dist/types/io/utils/eventBus.d.ts +68 -0
  438. package/dist/types/io/utils/eventBus.d.ts.map +1 -0
  439. package/dist/types/io/utils/queue.d.ts +69 -0
  440. package/dist/types/io/utils/queue.d.ts.map +1 -0
  441. package/dist/types/io/utils/signal.d.ts +362 -0
  442. package/dist/types/io/utils/signal.d.ts.map +1 -0
  443. package/dist/types/io/utils/ui8.d.ts +34 -0
  444. package/dist/types/io/utils/ui8.d.ts.map +1 -0
  445. package/dist/types/io/utils/valid.d.ts +130 -0
  446. package/dist/types/io/utils/valid.d.ts.map +1 -0
  447. package/dist/types/main.d.ts +25 -0
  448. package/dist/types/main.d.ts.map +1 -0
  449. package/dist/types/process/message.d.ts +64 -0
  450. package/dist/types/process/message.d.ts.map +1 -0
  451. package/dist/types/process/rpc.d.ts +35 -0
  452. package/dist/types/process/rpc.d.ts.map +1 -0
  453. package/dist/types/process/workerPool.d.ts +62 -0
  454. package/dist/types/process/workerPool.d.ts.map +1 -0
  455. package/dist/types/sanity/base.d.ts +28 -0
  456. package/dist/types/sanity/base.d.ts.map +1 -0
  457. package/dist/types/sanity/community.d.ts +20 -0
  458. package/dist/types/sanity/community.d.ts.map +1 -0
  459. package/dist/types/sanity/lockdown-apply.d.ts +7 -0
  460. package/dist/types/sanity/lockdown-apply.d.ts.map +1 -0
  461. package/dist/types/sanity/lockdown.d.ts +43 -0
  462. package/dist/types/sanity/lockdown.d.ts.map +1 -0
  463. package/dist/types/sanity/wasm-gate.d.ts +128 -0
  464. package/dist/types/sanity/wasm-gate.d.ts.map +1 -0
  465. package/docs/README.md +301 -0
  466. package/docs/api/README.md +33 -0
  467. package/docs/api/core/README.md +14 -0
  468. package/docs/api/core/logger.md +151 -0
  469. package/docs/api/core/main.md +105 -0
  470. package/docs/api/core/modules.md +123 -0
  471. package/docs/api/core/readyState.md +94 -0
  472. package/docs/api/core/runtime.md +499 -0
  473. package/docs/api/core/worker-helper.md +180 -0
  474. package/docs/api/crypto/README.md +39 -0
  475. package/docs/api/crypto/cipher/README.md +24 -0
  476. package/docs/api/crypto/cipher/aes.md +101 -0
  477. package/docs/api/crypto/cipher/chacha20.md +85 -0
  478. package/docs/api/crypto/hash/README.md +49 -0
  479. package/docs/api/crypto/hash/adf.md +61 -0
  480. package/docs/api/crypto/hash/argon2.md +92 -0
  481. package/docs/api/crypto/hash/blake2b.md +88 -0
  482. package/docs/api/crypto/hash/hkdf.md +82 -0
  483. package/docs/api/crypto/hash/hmac.md +90 -0
  484. package/docs/api/crypto/hash/pbkdf2.md +93 -0
  485. package/docs/api/crypto/hash/poly1305.md +71 -0
  486. package/docs/api/crypto/hash/sha224.md +61 -0
  487. package/docs/api/crypto/hash/sha256.md +84 -0
  488. package/docs/api/crypto/hash/sha3.md +89 -0
  489. package/docs/api/crypto/hash/sha384.md +58 -0
  490. package/docs/api/crypto/hash/sha512.md +73 -0
  491. package/docs/api/crypto/hash/sha512_224.md +59 -0
  492. package/docs/api/crypto/hash/sha512_256.md +58 -0
  493. package/docs/api/crypto/mode/README.md +33 -0
  494. package/docs/api/crypto/mode/cbc.md +69 -0
  495. package/docs/api/crypto/mode/chacha20poly1305.md +77 -0
  496. package/docs/api/crypto/mode/cmac.md +79 -0
  497. package/docs/api/crypto/mode/ctr.md +66 -0
  498. package/docs/api/crypto/mode/gcm.md +93 -0
  499. package/docs/api/crypto/mode/kw.md +84 -0
  500. package/docs/api/crypto/pkc/README.md +48 -0
  501. package/docs/api/crypto/pkc/ecc.md +91 -0
  502. package/docs/api/crypto/pkc/ed25519.md +99 -0
  503. package/docs/api/crypto/pkc/hybridKem.md +178 -0
  504. package/docs/api/crypto/pkc/hybridSign.md +192 -0
  505. package/docs/api/crypto/pkc/ml_dsa.md +99 -0
  506. package/docs/api/crypto/pkc/ml_kem.md +90 -0
  507. package/docs/api/crypto/pkc/rsa.md +87 -0
  508. package/docs/api/crypto/pkc/slh_dsa.md +86 -0
  509. package/docs/api/crypto/pkc/x25519.md +84 -0
  510. package/docs/api/crypto/utils/README.md +39 -0
  511. package/docs/api/crypto/utils/aes_ctr.md +71 -0
  512. package/docs/api/crypto/utils/aes_modes.md +81 -0
  513. package/docs/api/crypto/utils/asn1-oid.md +130 -0
  514. package/docs/api/crypto/utils/asn1.md +69 -0
  515. package/docs/api/crypto/utils/bitArray.md +77 -0
  516. package/docs/api/crypto/utils/bn.md +67 -0
  517. package/docs/api/crypto/utils/jws.md +94 -0
  518. package/docs/api/crypto/utils/keyformat.md +78 -0
  519. package/docs/api/crypto/utils/pad.md +66 -0
  520. package/docs/api/crypto/utils/pem.md +63 -0
  521. package/docs/api/crypto/utils/random.md +103 -0
  522. package/docs/api/crypto/utils/rsaKeygen.md +118 -0
  523. package/docs/api/crypto/utils/totp.md +159 -0
  524. package/docs/api/crypto/utils/uuid.md +98 -0
  525. package/docs/api/crypto/wasm/README.md +76 -0
  526. package/docs/api/crypto/wasm/aes.md +128 -0
  527. package/docs/api/crypto/wasm/argon2.md +110 -0
  528. package/docs/api/crypto/wasm/blake2b.md +103 -0
  529. package/docs/api/crypto/wasm/chacha20poly1305.md +120 -0
  530. package/docs/api/crypto/wasm/cmac.md +119 -0
  531. package/docs/api/crypto/wasm/ecc.md +114 -0
  532. package/docs/api/crypto/wasm/ed25519.md +117 -0
  533. package/docs/api/crypto/wasm/hkdf.md +163 -0
  534. package/docs/api/crypto/wasm/hmac.md +129 -0
  535. package/docs/api/crypto/wasm/ml_dsa.md +99 -0
  536. package/docs/api/crypto/wasm/ml_kem.md +91 -0
  537. package/docs/api/crypto/wasm/pbkdf2.md +111 -0
  538. package/docs/api/crypto/wasm/rsa.md +113 -0
  539. package/docs/api/crypto/wasm/runtime.md +172 -0
  540. package/docs/api/crypto/wasm/sha2.md +95 -0
  541. package/docs/api/crypto/wasm/sha3.md +127 -0
  542. package/docs/api/crypto/wasm/slh_dsa.md +89 -0
  543. package/docs/api/crypto/wasm/x25519.md +116 -0
  544. package/docs/api/crypto/webcrypto/README.md +56 -0
  545. package/docs/api/crypto/webcrypto/aes.md +140 -0
  546. package/docs/api/crypto/webcrypto/aeskw.md +120 -0
  547. package/docs/api/crypto/webcrypto/digest.md +103 -0
  548. package/docs/api/crypto/webcrypto/ecc.md +122 -0
  549. package/docs/api/crypto/webcrypto/ed25519.md +121 -0
  550. package/docs/api/crypto/webcrypto/hkdf.md +141 -0
  551. package/docs/api/crypto/webcrypto/hmac.md +112 -0
  552. package/docs/api/crypto/webcrypto/pbkdf2.md +140 -0
  553. package/docs/api/crypto/webcrypto/rsa.md +149 -0
  554. package/docs/api/crypto/webcrypto/x25519.md +96 -0
  555. package/docs/api/dom/README.md +117 -0
  556. package/docs/api/dom/display/README.md +27 -0
  557. package/docs/api/dom/display/animate.md +113 -0
  558. package/docs/api/dom/display/fullscreen.md +121 -0
  559. package/docs/api/dom/fs/README.md +36 -0
  560. package/docs/api/dom/fs/download.md +108 -0
  561. package/docs/api/dom/fs/fsAccess.md +200 -0
  562. package/docs/api/dom/fs/indexedDB.md +219 -0
  563. package/docs/api/dom/fs/remoteStore.md +158 -0
  564. package/docs/api/dom/fs/storage.md +197 -0
  565. package/docs/api/dom/lifecycle/README.md +11 -0
  566. package/docs/api/dom/lifecycle/idle.md +89 -0
  567. package/docs/api/dom/lifecycle/visibility.md +73 -0
  568. package/docs/api/dom/lifecycle/wakeLock.md +94 -0
  569. package/docs/api/dom/net/README.md +31 -0
  570. package/docs/api/dom/net/ajax.md +176 -0
  571. package/docs/api/dom/net/broadcastChannel.md +110 -0
  572. package/docs/api/dom/net/network.md +137 -0
  573. package/docs/api/dom/net/sse.md +141 -0
  574. package/docs/api/dom/net/webrtc.md +158 -0
  575. package/docs/api/dom/net/ws.md +168 -0
  576. package/docs/api/dom/query/README.md +30 -0
  577. package/docs/api/dom/query/dnd.md +137 -0
  578. package/docs/api/dom/query/dom.md +275 -0
  579. package/docs/api/dom/query/events.md +211 -0
  580. package/docs/api/dom/query/gesture.md +137 -0
  581. package/docs/api/dom/query/media.md +188 -0
  582. package/docs/api/dom/rendering/README.md +41 -0
  583. package/docs/api/dom/rendering/chart.md +149 -0
  584. package/docs/api/dom/rendering/component.md +287 -0
  585. package/docs/api/dom/rendering/devtools-ui.md +129 -0
  586. package/docs/api/dom/rendering/devtools.md +157 -0
  587. package/docs/api/dom/rendering/parser.md +200 -0
  588. package/docs/api/dom/rendering/reactiveBind.md +234 -0
  589. package/docs/api/dom/rendering/render.md +219 -0
  590. package/docs/api/dom/rendering/sanitize.md +97 -0
  591. package/docs/api/dom/rendering/secPolicy.md +155 -0
  592. package/docs/api/dom/rendering/template.md +301 -0
  593. package/docs/api/dom/rendering/themeTokens.md +175 -0
  594. package/docs/api/dom/rendering/uiSession.md +546 -0
  595. package/docs/api/dom/rendering/virtualScroll.md +126 -0
  596. package/docs/api/dom/sensors/README.md +12 -0
  597. package/docs/api/dom/sensors/battery.md +70 -0
  598. package/docs/api/dom/sensors/geolocation.md +115 -0
  599. package/docs/api/dom/sensors/networkInfo.md +73 -0
  600. package/docs/api/dom/sensors/sensors.md +123 -0
  601. package/docs/api/dom/sw/README.md +31 -0
  602. package/docs/api/dom/sw/backgroundSync.md +145 -0
  603. package/docs/api/dom/sw/cache.md +116 -0
  604. package/docs/api/dom/sw/push.md +114 -0
  605. package/docs/api/dom/sw/serviceWorker.md +90 -0
  606. package/docs/api/dom/sw/sharedWorker.md +131 -0
  607. package/docs/api/dom/utils/README.md +25 -0
  608. package/docs/api/dom/utils/a11y.md +143 -0
  609. package/docs/api/dom/utils/clipboard.md +146 -0
  610. package/docs/api/dom/utils/entropyCollector.md +175 -0
  611. package/docs/api/dom/utils/focus.md +140 -0
  612. package/docs/api/dom/utils/form.md +196 -0
  613. package/docs/api/dom/utils/formKit.md +181 -0
  614. package/docs/api/dom/utils/keybindings.md +138 -0
  615. package/docs/api/dom/utils/leaderElection.md +130 -0
  616. package/docs/api/dom/utils/notifications.md +106 -0
  617. package/docs/api/dom/utils/permissions.md +82 -0
  618. package/docs/api/dom/utils/route.md +112 -0
  619. package/docs/api/dom/utils/ua.md +119 -0
  620. package/docs/api/dom/utils/webauthn.md +190 -0
  621. package/docs/api/io/README.md +20 -0
  622. package/docs/api/io/binary/README.md +29 -0
  623. package/docs/api/io/binary/reader.md +126 -0
  624. package/docs/api/io/binary/writer.md +127 -0
  625. package/docs/api/io/calc/README.md +22 -0
  626. package/docs/api/io/calc/adler32.md +75 -0
  627. package/docs/api/io/calc/bigint.md +105 -0
  628. package/docs/api/io/calc/crc32.md +74 -0
  629. package/docs/api/io/calc/easing.md +118 -0
  630. package/docs/api/io/codec/README.md +35 -0
  631. package/docs/api/io/codec/b64.md +92 -0
  632. package/docs/api/io/codec/base32.md +98 -0
  633. package/docs/api/io/codec/base58.md +104 -0
  634. package/docs/api/io/codec/buffer.md +144 -0
  635. package/docs/api/io/codec/cbor.md +179 -0
  636. package/docs/api/io/codec/csv.md +178 -0
  637. package/docs/api/io/codec/hex.md +75 -0
  638. package/docs/api/io/codec/mime.md +156 -0
  639. package/docs/api/io/codec/msgpack.md +142 -0
  640. package/docs/api/io/codec/url.md +265 -0
  641. package/docs/api/io/codec/utf8.md +84 -0
  642. package/docs/api/io/codec/xml.md +87 -0
  643. package/docs/api/io/compress/README.md +62 -0
  644. package/docs/api/io/compress/bitstream.md +131 -0
  645. package/docs/api/io/compress/brotli.md +232 -0
  646. package/docs/api/io/compress/brotli_dict.md +119 -0
  647. package/docs/api/io/compress/brotli_dict_words.md +142 -0
  648. package/docs/api/io/compress/brotli_frame.md +214 -0
  649. package/docs/api/io/compress/brotli_shared.md +144 -0
  650. package/docs/api/io/compress/deflate.md +474 -0
  651. package/docs/api/io/compress/gzip.md +130 -0
  652. package/docs/api/io/compress/huffman.md +210 -0
  653. package/docs/api/io/compress/lz4.md +278 -0
  654. package/docs/api/io/compress/lz77.md +180 -0
  655. package/docs/api/io/compress/lzw.md +121 -0
  656. package/docs/api/io/compress/zip.md +209 -0
  657. package/docs/api/io/compress/zlib.md +125 -0
  658. package/docs/api/io/i18n/README.md +23 -0
  659. package/docs/api/io/i18n/i18n.md +128 -0
  660. package/docs/api/io/math/README.md +24 -0
  661. package/docs/api/io/math/fixed-point.md +115 -0
  662. package/docs/api/io/math/geom.md +144 -0
  663. package/docs/api/io/math/interp.md +115 -0
  664. package/docs/api/io/math/linalg.md +138 -0
  665. package/docs/api/io/math/stats.md +109 -0
  666. package/docs/api/io/structures/README.md +31 -0
  667. package/docs/api/io/structures/btree.md +155 -0
  668. package/docs/api/io/structures/heap.md +166 -0
  669. package/docs/api/io/structures/lruCache.md +156 -0
  670. package/docs/api/io/structures/ringBuffer.md +188 -0
  671. package/docs/api/io/structures/tree-walker.md +132 -0
  672. package/docs/api/io/structures/trie.md +138 -0
  673. package/docs/api/io/sync/README.md +29 -0
  674. package/docs/api/io/sync/abort.md +129 -0
  675. package/docs/api/io/sync/atomics.md +159 -0
  676. package/docs/api/io/sync/cancellable.md +176 -0
  677. package/docs/api/io/sync/channel.md +125 -0
  678. package/docs/api/io/sync/mutex.md +93 -0
  679. package/docs/api/io/sync/semaphore.md +106 -0
  680. package/docs/api/io/sync/tokenBucket.md +139 -0
  681. package/docs/api/io/text/README.md +23 -0
  682. package/docs/api/io/text/ansi.md +182 -0
  683. package/docs/api/io/text/html-entities.md +79 -0
  684. package/docs/api/io/text/semver.md +158 -0
  685. package/docs/api/io/text/str.md +129 -0
  686. package/docs/api/io/text/unicode.md +89 -0
  687. package/docs/api/io/time/README.md +22 -0
  688. package/docs/api/io/time/date.md +128 -0
  689. package/docs/api/io/timing/README.md +32 -0
  690. package/docs/api/io/timing/clock.md +102 -0
  691. package/docs/api/io/timing/rateLimit.md +137 -0
  692. package/docs/api/io/timing/scheduler.md +163 -0
  693. package/docs/api/io/utils/README.md +30 -0
  694. package/docs/api/io/utils/bitmap.md +96 -0
  695. package/docs/api/io/utils/errors.md +165 -0
  696. package/docs/api/io/utils/eventBus.md +162 -0
  697. package/docs/api/io/utils/queue.md +141 -0
  698. package/docs/api/io/utils/signal.md +388 -0
  699. package/docs/api/io/utils/ui8.md +111 -0
  700. package/docs/api/io/utils/valid.md +272 -0
  701. package/docs/api/process/README.md +18 -0
  702. package/docs/api/process/message.md +166 -0
  703. package/docs/api/process/rpc.md +161 -0
  704. package/docs/api/process/workerPool.md +130 -0
  705. package/docs/api/sanity/base.md +132 -0
  706. package/docs/api/sanity/community.md +96 -0
  707. package/docs/api/sanity/lockdown.md +128 -0
  708. package/docs/api/typed.md +85 -0
  709. package/docs/dev/README.md +25 -0
  710. package/docs/dev/provenance.md +80 -0
  711. package/docs/dev/publishing.md +31 -0
  712. package/docs/dev/runtime.md +64 -0
  713. package/docs/dev/testing.md +61 -0
  714. package/docs/dev/types.md +35 -0
  715. package/docs/evidence/pqc-hybrid-evidence.md +438 -0
  716. package/docs/guide/README.md +38 -0
  717. package/docs/guide/_QUICK_REF.md +341 -0
  718. package/docs/guide/by-use-case.md +160 -0
  719. package/docs/guide/doc-format.md +306 -0
  720. package/docs/guide/gesture-dnd-side-channel.md +119 -0
  721. package/docs/guide/getting-started.md +134 -0
  722. package/docs/guide/hmr.md +187 -0
  723. package/docs/guide/integration-bundlers.md +193 -0
  724. package/docs/guide/integrations-hmr.md +103 -0
  725. package/docs/guide/module-creation-workflow.md +342 -0
  726. package/docs/guide/module-pattern.md +244 -0
  727. package/docs/guide/rendering-pipeline.md +422 -0
  728. package/docs/guide/security.md +346 -0
  729. package/docs/guide/test-format.md +190 -0
  730. package/docs/guide/tutorial-todo.md +298 -0
  731. package/docs/guide/typescript.md +215 -0
  732. package/docs/guide/worker-confinement.md +301 -0
  733. package/docs/guide/workers.md +168 -0
  734. package/docs/notes/lz77-deflate-factorization.md +96 -0
  735. package/docs/notes/worker-confinement-spike.md +302 -0
  736. package/docs/tools/README.md +56 -0
  737. package/docs/tools/aot.md +108 -0
  738. package/docs/tools/audit.md +61 -0
  739. package/docs/tools/bundler.md +215 -0
  740. package/docs/tools/codegen.md +64 -0
  741. package/docs/tools/jsx.md +236 -0
  742. package/docs/tools/precompilation.md +88 -0
  743. package/docs/tools/standalone.md +107 -0
  744. package/fw.config.json +129 -0
  745. package/integrations/README.md +52 -0
  746. package/integrations/_shared/catalog.generated.json +207 -0
  747. package/integrations/_shared/config-resolve.js +201 -0
  748. package/integrations/_shared/core.js +362 -0
  749. package/integrations/astro/README.md +96 -0
  750. package/integrations/astro/index.d.ts +42 -0
  751. package/integrations/astro/index.js +94 -0
  752. package/integrations/bun/README.md +62 -0
  753. package/integrations/bun/index.d.ts +30 -0
  754. package/integrations/bun/index.js +134 -0
  755. package/integrations/deno/README.md +55 -0
  756. package/integrations/deno/deno.json +10 -0
  757. package/integrations/esbuild/README.md +75 -0
  758. package/integrations/esbuild/backend.js +147 -0
  759. package/integrations/esbuild/index.d.ts +32 -0
  760. package/integrations/esbuild/index.js +147 -0
  761. package/integrations/eslint/README.md +27 -0
  762. package/integrations/eslint/no-factory-capture.js +99 -0
  763. package/integrations/jest/README.md +45 -0
  764. package/integrations/jest/bun-test-shim.js +43 -0
  765. package/integrations/nestjs/README.md +68 -0
  766. package/integrations/nestjs/index.d.ts +38 -0
  767. package/integrations/nestjs/index.js +99 -0
  768. package/integrations/nextjs/README.md +149 -0
  769. package/integrations/nextjs/index.d.ts +30 -0
  770. package/integrations/nextjs/index.js +98 -0
  771. package/integrations/nodejs/README.md +46 -0
  772. package/integrations/nodejs/package.node.example.json +31 -0
  773. package/integrations/rollup/README.md +65 -0
  774. package/integrations/rollup/backend.js +132 -0
  775. package/integrations/rollup/index.d.ts +32 -0
  776. package/integrations/rollup/index.js +84 -0
  777. package/integrations/turbopack/README.md +56 -0
  778. package/integrations/turbopack/index.d.ts +47 -0
  779. package/integrations/turbopack/index.js +164 -0
  780. package/integrations/typedoc/README.md +57 -0
  781. package/integrations/typedoc/categorize.js +121 -0
  782. package/integrations/typedoc/tsconfig.typedoc.json +14 -0
  783. package/integrations/typedoc/typedoc.json +19 -0
  784. package/integrations/vite/README.md +115 -0
  785. package/integrations/vite/index.d.ts +29 -0
  786. package/integrations/vite/index.js +182 -0
  787. package/integrations/vite/package.json +8 -0
  788. package/integrations/vite/vite-env.d.ts +36 -0
  789. package/integrations/vitest/README.md +77 -0
  790. package/integrations/vitest/bun-test-shim.js +92 -0
  791. package/integrations/vitest/vitest.config.js +41 -0
  792. package/integrations/webpack/README.md +53 -0
  793. package/integrations/webpack/index.d.ts +29 -0
  794. package/integrations/webpack/index.js +182 -0
  795. package/package.json +303 -0
  796. package/src/core/logger.js +373 -0
  797. package/src/core/modules.js +289 -0
  798. package/src/core/readyState.js +119 -0
  799. package/src/core/runtime.js +929 -0
  800. package/src/core/worker-helper.js +261 -0
  801. package/src/crypto/NIST_CONFORMANCE.md +249 -0
  802. package/src/crypto/cipher/aes.acvp.md +74 -0
  803. package/src/crypto/cipher/aes.js +512 -0
  804. package/src/crypto/cipher/chacha20.acvp.md +117 -0
  805. package/src/crypto/cipher/chacha20.js +147 -0
  806. package/src/crypto/hash/adf.acvp.md +144 -0
  807. package/src/crypto/hash/adf.js +127 -0
  808. package/src/crypto/hash/argon2.acvp.md +144 -0
  809. package/src/crypto/hash/argon2.js +517 -0
  810. package/src/crypto/hash/blake2b.acvp.md +122 -0
  811. package/src/crypto/hash/blake2b.js +367 -0
  812. package/src/crypto/hash/hkdf.acvp.md +128 -0
  813. package/src/crypto/hash/hkdf.js +145 -0
  814. package/src/crypto/hash/hmac.acvp.md +110 -0
  815. package/src/crypto/hash/hmac.js +177 -0
  816. package/src/crypto/hash/pbkdf2.acvp.md +122 -0
  817. package/src/crypto/hash/pbkdf2.js +120 -0
  818. package/src/crypto/hash/poly1305.acvp.md +111 -0
  819. package/src/crypto/hash/poly1305.js +126 -0
  820. package/src/crypto/hash/sha224.acvp.md +81 -0
  821. package/src/crypto/hash/sha224.js +60 -0
  822. package/src/crypto/hash/sha256.acvp.md +75 -0
  823. package/src/crypto/hash/sha256.js +217 -0
  824. package/src/crypto/hash/sha3.acvp.md +133 -0
  825. package/src/crypto/hash/sha3.js +391 -0
  826. package/src/crypto/hash/sha384.acvp.md +82 -0
  827. package/src/crypto/hash/sha384.js +61 -0
  828. package/src/crypto/hash/sha512.acvp.md +84 -0
  829. package/src/crypto/hash/sha512.js +314 -0
  830. package/src/crypto/hash/sha512_224.acvp.md +90 -0
  831. package/src/crypto/hash/sha512_224.js +66 -0
  832. package/src/crypto/hash/sha512_256.acvp.md +96 -0
  833. package/src/crypto/hash/sha512_256.js +75 -0
  834. package/src/crypto/mode/cbc.acvp.md +105 -0
  835. package/src/crypto/mode/cbc.js +136 -0
  836. package/src/crypto/mode/chacha20poly1305.acvp.md +116 -0
  837. package/src/crypto/mode/chacha20poly1305.js +190 -0
  838. package/src/crypto/mode/cmac.acvp.md +106 -0
  839. package/src/crypto/mode/cmac.js +172 -0
  840. package/src/crypto/mode/ctr.acvp.md +110 -0
  841. package/src/crypto/mode/ctr.js +174 -0
  842. package/src/crypto/mode/gcm.acvp.md +129 -0
  843. package/src/crypto/mode/gcm.js +333 -0
  844. package/src/crypto/mode/kw.acvp.md +145 -0
  845. package/src/crypto/mode/kw.js +323 -0
  846. package/src/crypto/pkc/ecc.acvp.md +181 -0
  847. package/src/crypto/pkc/ecc.js +941 -0
  848. package/src/crypto/pkc/ed25519.acvp.md +172 -0
  849. package/src/crypto/pkc/ed25519.js +582 -0
  850. package/src/crypto/pkc/hybrid-kat.provenance.md +89 -0
  851. package/src/crypto/pkc/hybridKem.js +255 -0
  852. package/src/crypto/pkc/hybridSign.js +437 -0
  853. package/src/crypto/pkc/ml_dsa.acvp.md +146 -0
  854. package/src/crypto/pkc/ml_dsa.js +984 -0
  855. package/src/crypto/pkc/ml_kem.acvp.md +117 -0
  856. package/src/crypto/pkc/ml_kem.js +596 -0
  857. package/src/crypto/pkc/rsa.acvp.md +187 -0
  858. package/src/crypto/pkc/rsa.js +470 -0
  859. package/src/crypto/pkc/slh_dsa.acvp.md +155 -0
  860. package/src/crypto/pkc/slh_dsa.js +820 -0
  861. package/src/crypto/pkc/x25519.acvp.md +113 -0
  862. package/src/crypto/pkc/x25519.js +290 -0
  863. package/src/crypto/utils/aes_ctr.acvp.md +67 -0
  864. package/src/crypto/utils/aes_ctr.js +134 -0
  865. package/src/crypto/utils/aes_modes.acvp.md +66 -0
  866. package/src/crypto/utils/aes_modes.js +241 -0
  867. package/src/crypto/utils/asn1-oid.js +369 -0
  868. package/src/crypto/utils/asn1.js +343 -0
  869. package/src/crypto/utils/bitArray.js +312 -0
  870. package/src/crypto/utils/bn.js +825 -0
  871. package/src/crypto/utils/jws.js +222 -0
  872. package/src/crypto/utils/keyformat.js +303 -0
  873. package/src/crypto/utils/pad.js +198 -0
  874. package/src/crypto/utils/pem.js +90 -0
  875. package/src/crypto/utils/random.acvp.md +167 -0
  876. package/src/crypto/utils/random.js +846 -0
  877. package/src/crypto/utils/rsaKeygen.acvp.md +158 -0
  878. package/src/crypto/utils/rsaKeygen.js +448 -0
  879. package/src/crypto/utils/totp.js +409 -0
  880. package/src/crypto/utils/uuid.acvp.md +137 -0
  881. package/src/crypto/utils/uuid.js +176 -0
  882. package/src/crypto/wasm/aes.js +494 -0
  883. package/src/crypto/wasm/argon2.js +236 -0
  884. package/src/crypto/wasm/blake2b.js +213 -0
  885. package/src/crypto/wasm/chacha20poly1305.js +238 -0
  886. package/src/crypto/wasm/cmac.js +207 -0
  887. package/src/crypto/wasm/ecc.js +437 -0
  888. package/src/crypto/wasm/ed25519.js +307 -0
  889. package/src/crypto/wasm/hkdf.js +183 -0
  890. package/src/crypto/wasm/hmac.js +215 -0
  891. package/src/crypto/wasm/ml_dsa.js +375 -0
  892. package/src/crypto/wasm/ml_kem.js +313 -0
  893. package/src/crypto/wasm/pbkdf2.js +205 -0
  894. package/src/crypto/wasm/rsa.js +674 -0
  895. package/src/crypto/wasm/runtime.js +400 -0
  896. package/src/crypto/wasm/sha2.js +183 -0
  897. package/src/crypto/wasm/sha3.js +221 -0
  898. package/src/crypto/wasm/slh_dsa.js +397 -0
  899. package/src/crypto/wasm/x25519.js +241 -0
  900. package/src/crypto/webcrypto/aes.js +370 -0
  901. package/src/crypto/webcrypto/aeskw.js +185 -0
  902. package/src/crypto/webcrypto/digest.js +136 -0
  903. package/src/crypto/webcrypto/ecc.js +371 -0
  904. package/src/crypto/webcrypto/ed25519.js +248 -0
  905. package/src/crypto/webcrypto/hkdf.js +132 -0
  906. package/src/crypto/webcrypto/hmac.js +213 -0
  907. package/src/crypto/webcrypto/pbkdf2.js +146 -0
  908. package/src/crypto/webcrypto/rsa.js +415 -0
  909. package/src/crypto/webcrypto/x25519.js +250 -0
  910. package/src/dom/display/animate.js +154 -0
  911. package/src/dom/display/fullscreen.js +305 -0
  912. package/src/dom/fs/download.js +118 -0
  913. package/src/dom/fs/fsAccess.js +307 -0
  914. package/src/dom/fs/indexedDB.js +465 -0
  915. package/src/dom/fs/remoteStore.js +484 -0
  916. package/src/dom/fs/storage.js +440 -0
  917. package/src/dom/lifecycle/idle.js +133 -0
  918. package/src/dom/lifecycle/visibility.js +140 -0
  919. package/src/dom/lifecycle/wakeLock.js +187 -0
  920. package/src/dom/net/ajax.js +303 -0
  921. package/src/dom/net/broadcastChannel.js +89 -0
  922. package/src/dom/net/network.js +260 -0
  923. package/src/dom/net/sse.js +295 -0
  924. package/src/dom/net/webrtc.js +381 -0
  925. package/src/dom/net/ws.js +290 -0
  926. package/src/dom/query/dnd.js +409 -0
  927. package/src/dom/query/dom.js +831 -0
  928. package/src/dom/query/events.js +425 -0
  929. package/src/dom/query/gesture.js +396 -0
  930. package/src/dom/query/media.js +616 -0
  931. package/src/dom/rendering/chart.js +663 -0
  932. package/src/dom/rendering/component.js +469 -0
  933. package/src/dom/rendering/devtools-ui.js +399 -0
  934. package/src/dom/rendering/devtools.js +352 -0
  935. package/src/dom/rendering/parser.js +1055 -0
  936. package/src/dom/rendering/reactiveBind.js +341 -0
  937. package/src/dom/rendering/render.js +601 -0
  938. package/src/dom/rendering/sanitize.js +364 -0
  939. package/src/dom/rendering/secPolicy.js +281 -0
  940. package/src/dom/rendering/template.js +1031 -0
  941. package/src/dom/rendering/themeTokens.js +522 -0
  942. package/src/dom/rendering/uiSession-core.js +597 -0
  943. package/src/dom/rendering/uiSession-direct.js +251 -0
  944. package/src/dom/rendering/uiSession-list.js +751 -0
  945. package/src/dom/rendering/uiSession.js +145 -0
  946. package/src/dom/rendering/virtualScroll.js +341 -0
  947. package/src/dom/sensors/battery.js +153 -0
  948. package/src/dom/sensors/geolocation.js +156 -0
  949. package/src/dom/sensors/networkInfo.js +136 -0
  950. package/src/dom/sensors/sensors.js +340 -0
  951. package/src/dom/sw/backgroundSync.js +113 -0
  952. package/src/dom/sw/cache.js +139 -0
  953. package/src/dom/sw/push.js +181 -0
  954. package/src/dom/sw/serviceWorker.js +193 -0
  955. package/src/dom/sw/sharedWorker.js +192 -0
  956. package/src/dom/utils/a11y.js +244 -0
  957. package/src/dom/utils/clipboard.js +113 -0
  958. package/src/dom/utils/entropyCollector.js +344 -0
  959. package/src/dom/utils/focus.js +421 -0
  960. package/src/dom/utils/form.js +535 -0
  961. package/src/dom/utils/formKit.js +427 -0
  962. package/src/dom/utils/keybindings.js +574 -0
  963. package/src/dom/utils/leaderElection.js +280 -0
  964. package/src/dom/utils/notifications.js +218 -0
  965. package/src/dom/utils/permissions.js +107 -0
  966. package/src/dom/utils/route.js +482 -0
  967. package/src/dom/utils/ua.js +109 -0
  968. package/src/dom/utils/webauthn.js +369 -0
  969. package/src/external/README.md +15 -0
  970. package/src/io/binary/reader.js +374 -0
  971. package/src/io/binary/writer.js +351 -0
  972. package/src/io/calc/adler32.js +94 -0
  973. package/src/io/calc/bigint.js +276 -0
  974. package/src/io/calc/crc32.js +111 -0
  975. package/src/io/calc/easing.js +514 -0
  976. package/src/io/codec/b64.js +235 -0
  977. package/src/io/codec/base32.js +147 -0
  978. package/src/io/codec/base58.js +167 -0
  979. package/src/io/codec/buffer.js +630 -0
  980. package/src/io/codec/cbor.js +550 -0
  981. package/src/io/codec/csv.js +299 -0
  982. package/src/io/codec/hex.js +129 -0
  983. package/src/io/codec/mime.js +398 -0
  984. package/src/io/codec/msgpack.js +491 -0
  985. package/src/io/codec/url.js +530 -0
  986. package/src/io/codec/utf8.js +181 -0
  987. package/src/io/codec/xml.js +428 -0
  988. package/src/io/compress/bitstream.js +199 -0
  989. package/src/io/compress/brotli.js +3073 -0
  990. package/src/io/compress/brotli_dict.bin +432 -0
  991. package/src/io/compress/brotli_dict.js +356 -0
  992. package/src/io/compress/brotli_dict_words.js +157 -0
  993. package/src/io/compress/brotli_frame.js +420 -0
  994. package/src/io/compress/brotli_shared.js +715 -0
  995. package/src/io/compress/deflate.js +1432 -0
  996. package/src/io/compress/gzip.js +406 -0
  997. package/src/io/compress/huffman.js +322 -0
  998. package/src/io/compress/lz4.js +451 -0
  999. package/src/io/compress/lz77.js +408 -0
  1000. package/src/io/compress/lzw.js +332 -0
  1001. package/src/io/compress/zip.js +815 -0
  1002. package/src/io/compress/zlib.js +340 -0
  1003. package/src/io/i18n/i18n.js +236 -0
  1004. package/src/io/math/fixed-point.js +269 -0
  1005. package/src/io/math/geom.js +350 -0
  1006. package/src/io/math/interp.js +263 -0
  1007. package/src/io/math/linalg.js +472 -0
  1008. package/src/io/math/stats.js +339 -0
  1009. package/src/io/structures/btree.js +357 -0
  1010. package/src/io/structures/heap.js +249 -0
  1011. package/src/io/structures/lruCache.js +219 -0
  1012. package/src/io/structures/ringBuffer.js +208 -0
  1013. package/src/io/structures/tree-walker.js +413 -0
  1014. package/src/io/structures/trie.js +219 -0
  1015. package/src/io/sync/abort.js +196 -0
  1016. package/src/io/sync/atomics.js +342 -0
  1017. package/src/io/sync/cancellable.js +279 -0
  1018. package/src/io/sync/channel.js +301 -0
  1019. package/src/io/sync/mutex.js +148 -0
  1020. package/src/io/sync/semaphore.js +156 -0
  1021. package/src/io/sync/tokenBucket.js +208 -0
  1022. package/src/io/text/ansi.js +536 -0
  1023. package/src/io/text/html-entities.js +143 -0
  1024. package/src/io/text/semver.js +375 -0
  1025. package/src/io/text/str.js +243 -0
  1026. package/src/io/text/unicode.js +188 -0
  1027. package/src/io/time/date.js +355 -0
  1028. package/src/io/timing/clock.js +79 -0
  1029. package/src/io/timing/rateLimit.js +264 -0
  1030. package/src/io/timing/scheduler.js +351 -0
  1031. package/src/io/utils/bitmap.js +94 -0
  1032. package/src/io/utils/errors.js +269 -0
  1033. package/src/io/utils/eventBus.js +315 -0
  1034. package/src/io/utils/queue.js +223 -0
  1035. package/src/io/utils/signal.js +858 -0
  1036. package/src/io/utils/ui8.js +99 -0
  1037. package/src/io/utils/valid.js +556 -0
  1038. package/src/main.js +41 -0
  1039. package/src/polyfill/README.md +9 -0
  1040. package/src/process/message.js +257 -0
  1041. package/src/process/rpc.js +286 -0
  1042. package/src/process/workerPool.js +392 -0
  1043. package/src/sanity/base.js +374 -0
  1044. package/src/sanity/community.js +254 -0
  1045. package/src/sanity/lockdown-apply.js +58 -0
  1046. package/src/sanity/lockdown.js +408 -0
  1047. package/src/sanity/wasm-gate.js +316 -0
  1048. package/src/typed.js +53 -0
  1049. package/third-party/NOTICE-penner-easing +88 -0
  1050. package/third-party/NOTICE-sjcl +50 -0
  1051. package/tools/_lib/cli-help.js +55 -0
  1052. package/tools/rendering/aot/index.js +148 -0
  1053. package/tools/rendering/aot/lib/dom-codegen.js +295 -0
  1054. package/tools/rendering/jsx/index.js +654 -0
  1055. package/tools/rendering/precompilation/index.js +368 -0
  1056. package/types/registry.generated.d.ts +217 -0
  1057. package/types/typed.d.ts +106 -0
@@ -0,0 +1,517 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview Argon2id - RFC 9106.
7
+ *
8
+ * Memory-hard password hashing function selected by the Password Hashing
9
+ * Competition. Argon2id (type=2) combines the data-independent addressing
10
+ * of Argon2i (resistant to side-channel timing attacks) for the first half
11
+ * of the first pass with the data-dependent addressing of Argon2d (resistant
12
+ * to GPU/ASIC tradeoffs) thereafter.
13
+ *
14
+ * Parameters per RFC 9106 §3.1:
15
+ * - p (parallelism / lanes), 1..2^24-1
16
+ * - τ (tag length), 4..2^32-1 bytes
17
+ * - m (memory in KiB), 8*p..2^32-1
18
+ * - t (iterations), 1..2^32-1
19
+ * - v (version) = 0x13 (Argon2 v1.3)
20
+ * - y (type) = 2 for Argon2id
21
+ *
22
+ * Public API:
23
+ * hash({ password, salt, time, memory, parallelism, tagLen,
24
+ * secret?, ad? }) → Uint8Array of length tagLen, or false on error.
25
+ *
26
+ * **Recommended parameters (RFC 9106 §4):**
27
+ * - First-choice profile (interactive login, RAM-rich servers):
28
+ * t=1, p=4, m=2^21 KiB (2 GiB), tagLen=32.
29
+ * - Second-choice profile (memory-constrained, embedded):
30
+ * t=3, p=4, m=2^16 KiB (64 MiB), tagLen=32.
31
+ * - Avoid `m < 2^15` (32 MiB) for password storage; below that level
32
+ * Argon2 loses its memory-hardness margin against GPU/ASIC attackers.
33
+ *
34
+ */
35
+
36
+ /**
37
+ * Options accepted by `argon2.hash`.
38
+ * @typedef {object} Argon2Options
39
+ * @property {Uint8Array} password
40
+ * @property {Uint8Array} salt Must be ≥ 8 bytes.
41
+ * @property {number} time Iterations t (≥ 1).
42
+ * @property {number} memory Memory cost m in KiB (≥ 8*p).
43
+ * @property {number} parallelism Lanes p (≥ 1).
44
+ * @property {number} tagLen Output length in bytes (≥ 4).
45
+ * @property {Uint8Array} [secret] Optional key.
46
+ * @property {Uint8Array} [ad] Optional associated data.
47
+ */
48
+
49
+ /**
50
+ * Public shape returned by `argon2.factory()`.
51
+ * @typedef {object} Argon2API
52
+ * @property {(opts: Argon2Options) => (Uint8Array|false)} hash
53
+ * Argon2id hash → tag bytes of length `tagLen`, or `false` on error.
54
+ * @property {() => false} hashD Argon2d - explicitly rejected (warns, returns `false`).
55
+ * @property {() => false} hashI Argon2i - explicitly rejected (warns, returns `false`).
56
+ * @property {{ Hp: (input: Uint8Array, outLen: number) => Uint8Array, compress: (out: Uint32Array, X: Uint32Array, Y: Uint32Array) => void }} _internal
57
+ * Internal primitives exposed for KAT tests / debug only.
58
+ */
59
+
60
+ import { blake2b } from './blake2b.js';
61
+
62
+ export const argon2 = {
63
+ name: 'argon2',
64
+ version: '1.0.0',
65
+ type: 'fw.crypto.hash',
66
+ dependencies: ['blake2b'],
67
+ deps: [blake2b],
68
+
69
+ /** @returns {Argon2API} */
70
+ factory(blake2b) {
71
+
72
+ // Argon2 type IDs (RFC 9106 §3.1): d=0, i=1 — both intentionally rejected; only Argon2id is implemented. Kept for spec reference.
73
+ const TYPE_ARGON2ID = 2;
74
+ const VERSION = 0x13;
75
+ const SYNC_POINTS = 4; // 4 segments per lane per pass.
76
+ const BLOCK_SIZE = 1024; // bytes
77
+ // QWORDS_PER_BLOCK = 128 (1024-byte block / 8, RFC 9106) — unused here, kept for spec reference.
78
+
79
+ // ── 32-bit LE writers ────────────────────────────────────────
80
+
81
+ function _u32le(out, off, v) {
82
+ out[off] = v & 0xff;
83
+ out[off + 1] = (v >>> 8) & 0xff;
84
+ out[off + 2] = (v >>> 16) & 0xff;
85
+ out[off + 3] = (v >>> 24) & 0xff;
86
+ }
87
+
88
+ // ── BLAKE2b helpers ──────────────────────────────────────────
89
+
90
+ function _blake2b(msg, outLen) {
91
+ return blake2b.hash(msg, outLen);
92
+ }
93
+
94
+ // RFC 9106 §3.3 - variable-length BLAKE2b H'.
95
+ // if T <= 64: H'_T(A) = BLAKE2b(LE32(T) || A, T)
96
+ // else:
97
+ // V_1 = BLAKE2b(LE32(T) || A, 64)
98
+ // V_{i+1} = BLAKE2b(V_i, 64) for i = 1..r-2 where r = ceil(T/32) - 2
99
+ // V_r = BLAKE2b(V_{r-1}, T - 32*r) where r = ceil(T/32) - 2 + 1
100
+ // Actually simpler: out = first 32 bytes of V_1, V_2, ..., V_{r-1}
101
+ // then V_r is full last chunk.
102
+ function _Hp(input, outLen) {
103
+ const lenBytes = new Uint8Array(4);
104
+ _u32le(lenBytes, 0, outLen);
105
+ const seed = new Uint8Array(4 + input.length);
106
+ seed.set(lenBytes, 0);
107
+ seed.set(input, 4);
108
+
109
+ if (outLen <= 64) {
110
+ return _blake2b(seed, outLen);
111
+ }
112
+ // RFC 9106 §3.3: r = ceil(T/32) - 2 hashes contribute first 32 bytes,
113
+ // then V_{r+1} of size T-32r bytes is appended in full.
114
+ const out = new Uint8Array(outLen);
115
+ const r = Math.ceil(outLen / 32) - 2;
116
+ let v = _blake2b(seed, 64);
117
+ out.set(v.subarray(0, 32), 0);
118
+ for (let i = 1; i < r; i++) {
119
+ v = _blake2b(v, 64);
120
+ out.set(v.subarray(0, 32), i * 32);
121
+ }
122
+ const lastLen = outLen - 32 * r;
123
+ const last = _blake2b(v, lastLen);
124
+ out.set(last, 32 * r);
125
+ return out;
126
+ }
127
+
128
+ // ── 64-bit (hi, lo) helpers in pairs (Uint32Array layout) ────
129
+
130
+ // Convention: arr[ai] = LOW 32 bits, arr[ai+1] = HIGH 32 bits.
131
+ // This matches the little-endian byte layout of Argon2 blocks.
132
+ function _add64Inline(arr, ai, bLo, bHi) {
133
+ const lo = (arr[ai] + bLo) >>> 0;
134
+ const carry = lo < arr[ai] ? 1 : 0;
135
+ arr[ai] = lo;
136
+ arr[ai + 1] = (arr[ai + 1] + bHi + carry) >>> 0;
137
+ }
138
+
139
+ function _ror64InPlace(arr, ai, n) {
140
+ const lo = arr[ai];
141
+ const hi = arr[ai + 1];
142
+ let nl, nh;
143
+ if (n === 32) { nl = hi; nh = lo; }
144
+ else if (n < 32) {
145
+ nl = (lo >>> n) | (hi << (32 - n));
146
+ nh = (hi >>> n) | (lo << (32 - n));
147
+ } else {
148
+ const m = n - 32;
149
+ nl = (hi >>> m) | (lo << (32 - m));
150
+ nh = (lo >>> m) | (hi << (32 - m));
151
+ }
152
+ arr[ai] = nl >>> 0;
153
+ arr[ai + 1] = nh >>> 0;
154
+ }
155
+
156
+ // Argon2 fBlaMka G mixing (RFC 9106 §3.5):
157
+ // a = a + b + 2 * trunc32(a) * trunc32(b)
158
+ // d = ROTR64(d ^ a, 32)
159
+ // c = c + d + 2 * trunc32(c) * trunc32(d)
160
+ // b = ROTR64(b ^ c, 24)
161
+ // a = a + b + 2 * trunc32(a) * trunc32(b)
162
+ // d = ROTR64(d ^ a, 16)
163
+ // c = c + d + 2 * trunc32(c) * trunc32(d)
164
+ // b = ROTR64(b ^ c, 63)
165
+ function _fBla(arr, a, b) {
166
+ // Layout: arr[i] = LO, arr[i+1] = HI.
167
+ const aLo = arr[a];
168
+ const bLo = arr[b];
169
+ const prod = BigInt(aLo) * BigInt(bLo) * 2n;
170
+ const pLo = Number(prod & 0xffffffffn);
171
+ const pHi = Number((prod >> 32n) & 0xffffffffn);
172
+ // a += b
173
+ _add64Inline(arr, a, arr[b], arr[b + 1]);
174
+ // a += prod
175
+ _add64Inline(arr, a, pLo, pHi);
176
+ }
177
+
178
+ function _GArgon(arr, a, b, c, d) {
179
+ _fBla(arr, a, b);
180
+ // d = ROTR64(d ^ a, 32)
181
+ arr[d] ^= arr[a];
182
+ arr[d + 1] ^= arr[a + 1];
183
+ _ror64InPlace(arr, d, 32);
184
+ _fBla(arr, c, d);
185
+ // b = ROTR64(b ^ c, 24)
186
+ arr[b] ^= arr[c];
187
+ arr[b + 1] ^= arr[c + 1];
188
+ _ror64InPlace(arr, b, 24);
189
+ _fBla(arr, a, b);
190
+ // d = ROTR64(d ^ a, 16)
191
+ arr[d] ^= arr[a];
192
+ arr[d + 1] ^= arr[a + 1];
193
+ _ror64InPlace(arr, d, 16);
194
+ _fBla(arr, c, d);
195
+ // b = ROTR64(b ^ c, 63)
196
+ arr[b] ^= arr[c];
197
+ arr[b + 1] ^= arr[c + 1];
198
+ _ror64InPlace(arr, b, 63);
199
+ }
200
+
201
+ // P permutation: 8 calls to G on 16 64-bit words.
202
+ // Indices in (hi,lo) pairs are: word i → arr[i*2..i*2+1].
203
+ function _P(arr, off) {
204
+ const o = off;
205
+ // Columns
206
+ _GArgon(arr, o + 0, o + 8, o + 16, o + 24);
207
+ _GArgon(arr, o + 2, o + 10, o + 18, o + 26);
208
+ _GArgon(arr, o + 4, o + 12, o + 20, o + 28);
209
+ _GArgon(arr, o + 6, o + 14, o + 22, o + 30);
210
+ // Diagonals
211
+ _GArgon(arr, o + 0, o + 10, o + 20, o + 30);
212
+ _GArgon(arr, o + 2, o + 12, o + 22, o + 24);
213
+ _GArgon(arr, o + 4, o + 14, o + 16, o + 26);
214
+ _GArgon(arr, o + 6, o + 8, o + 18, o + 28);
215
+ }
216
+
217
+ // Compression G(X, Y):
218
+ // R = X XOR Y
219
+ // Q = P over each row (8 rows × 16 words)
220
+ // Z = P over each column (8 cols × 16 words)
221
+ // out = Z XOR R
222
+ // Each block is 1024 bytes = 128 64-bit words = 256 32-bit halves.
223
+ // Layout as 8x8 matrix of 16-byte cells = 8 rows × 16 64-bit words.
224
+ function _compress(out, X, Y) {
225
+ // R = X XOR Y, in 32-bit half view.
226
+ const R = new Uint32Array(256);
227
+ for (let i = 0; i < 256; i++) R[i] = X[i] ^ Y[i];
228
+ const Q = new Uint32Array(256);
229
+ Q.set(R);
230
+ // Apply P to each of 8 rows. Each row = 16 64-bit words = 32 halves.
231
+ for (let i = 0; i < 8; i++) _P(Q, i * 32);
232
+ // Apply P to each of 8 columns. Column j = words j, j+8, j+16, ...
233
+ // We need to gather them, run P, scatter back.
234
+ const col = new Uint32Array(32);
235
+ for (let j = 0; j < 8; j++) {
236
+ // Gather: for k in 0..7, take 2 words (4 halves) from row k, columns 2j..2j+1.
237
+ // Actually: column j (in the 8-cell row) means words 2j and 2j+1 (a 16-byte cell).
238
+ for (let k = 0; k < 8; k++) {
239
+ const src = k * 32 + 2 * j * 2; // start of cell (k, j) in halves
240
+ col[k * 4] = Q[src];
241
+ col[k * 4 + 1] = Q[src + 1];
242
+ col[k * 4 + 2] = Q[src + 2];
243
+ col[k * 4 + 3] = Q[src + 3];
244
+ }
245
+ _P(col, 0);
246
+ for (let k = 0; k < 8; k++) {
247
+ const dst = k * 32 + 2 * j * 2;
248
+ Q[dst] = col[k * 4];
249
+ Q[dst + 1] = col[k * 4 + 1];
250
+ Q[dst + 2] = col[k * 4 + 2];
251
+ Q[dst + 3] = col[k * 4 + 3];
252
+ }
253
+ }
254
+ for (let i = 0; i < 256; i++) out[i] = Q[i] ^ R[i];
255
+ }
256
+
257
+ // ── block / view helpers ─────────────────────────────────────
258
+
259
+ function _blockView(B, idx) {
260
+ // Returns a Uint32Array view (256 halves) over block idx of B.
261
+ return new Uint32Array(B.buffer, B.byteOffset + idx * BLOCK_SIZE, 256);
262
+ }
263
+
264
+ function _blockBytes(B, idx) {
265
+ return new Uint8Array(B.buffer, B.byteOffset + idx * BLOCK_SIZE, BLOCK_SIZE);
266
+ }
267
+
268
+ // Argon2i index generator - produces JI1 || JI2 for 128 references in
269
+ // a single segment. RFC 9106 §3.4.1.2.
270
+ function _genIndexBlock(pass, lane, slice, m_, t_, type, segment, idxInSeg) {
271
+ // Build "input" block (1024 bytes):
272
+ // pass||lane||slice||m||t||type||counter, padded with zeros.
273
+ const inBlock = new Uint8Array(BLOCK_SIZE);
274
+ const view = new DataView(inBlock.buffer);
275
+ view.setUint32(0, pass, true);
276
+ view.setUint32(8, lane, true);
277
+ view.setUint32(16, slice, true);
278
+ view.setUint32(24, m_, true);
279
+ view.setUint32(32, t_, true);
280
+ view.setUint32(40, type, true);
281
+ view.setUint32(48, idxInSeg, true);
282
+ // Compress G(zero, G(zero, inBlock)) → addresses block.
283
+ const zero = new Uint32Array(256);
284
+ const tmp1 = new Uint32Array(256);
285
+ const tmp2 = new Uint32Array(256);
286
+ const inView = new Uint32Array(inBlock.buffer);
287
+ _compress(tmp1, zero, inView);
288
+ _compress(tmp2, zero, tmp1);
289
+ return tmp2; // Uint32Array(256) of addresses (128 64-bit pseudo-rands).
290
+ }
291
+
292
+ // ── main hash ─────────────────────────────────────────────────
293
+
294
+ /**
295
+ * @param {Object} opts
296
+ * @param {Uint8Array} opts.password
297
+ * @param {Uint8Array} opts.salt - must be ≥ 8 bytes.
298
+ * @param {number} opts.time - iterations t (≥ 1).
299
+ * @param {number} opts.memory - memory cost m in KiB (≥ 8*p).
300
+ * @param {number} opts.parallelism - lanes p (≥ 1).
301
+ * @param {number} opts.tagLen - output length in bytes (≥ 4).
302
+ * @param {Uint8Array} [opts.secret] - optional 0..2^32-1 byte key.
303
+ * @param {Uint8Array} [opts.ad] - optional associated data.
304
+ * @returns {Uint8Array|false}
305
+ */
306
+ function hash(opts) {
307
+ const password = opts.password;
308
+ const salt = opts.salt;
309
+ const t_ = opts.time;
310
+ const p = opts.parallelism;
311
+ const tagLen = opts.tagLen;
312
+ const secret = opts.secret || new Uint8Array(0);
313
+ const ad = opts.ad || new Uint8Array(0);
314
+ let m_ = opts.memory;
315
+
316
+ if (!password || !salt || salt.length < 8) {
317
+ console.warn('[crypto] INVALID: argon2: password and ≥8-byte salt required');
318
+ return false;
319
+ }
320
+ if (t_ < 1 || p < 1 || tagLen < 4) {
321
+ console.warn('[crypto] INVALID: argon2: invalid t/p/tagLen');
322
+ return false;
323
+ }
324
+ if (m_ < 8 * p) m_ = 8 * p;
325
+
326
+ // m' = floor(m / (4*p)) * (4*p)
327
+ const mPrime = Math.floor(m_ / (4 * p)) * (4 * p);
328
+ const q = mPrime / p; // blocks per lane
329
+ const segLen = q / SYNC_POINTS; // blocks per segment (must be int)
330
+
331
+ // ── H0 (RFC 9106 §3.2) ───────────────────────────────────
332
+ // H0 = BLAKE2b(LE32(p) || LE32(τ) || LE32(m) || LE32(t) ||
333
+ // LE32(v) || LE32(y) || LE32(|P|) || P ||
334
+ // LE32(|S|) || S || LE32(|K|) || K ||
335
+ // LE32(|X|) || X, 64)
336
+ const parts = [
337
+ _le32(p), _le32(tagLen), _le32(m_), _le32(t_),
338
+ _le32(VERSION), _le32(TYPE_ARGON2ID),
339
+ _le32(password.length), password,
340
+ _le32(salt.length), salt,
341
+ _le32(secret.length), secret,
342
+ _le32(ad.length), ad
343
+ ];
344
+ const cleanHeader = _concat(parts);
345
+ const H0 = _blake2b(cleanHeader, 64);
346
+
347
+ // ── allocate memory matrix B ─────────────────────────────
348
+ const B = new Uint8Array(mPrime * BLOCK_SIZE);
349
+
350
+ // Initial blocks: B[i][0] and B[i][1] for each lane i.
351
+ const seedExt = new Uint8Array(64 + 8);
352
+ seedExt.set(H0, 0);
353
+ for (let i = 0; i < p; i++) {
354
+ _u32le(seedExt, 64, 0);
355
+ _u32le(seedExt, 68, i);
356
+ _blockBytes(B, i * q + 0).set(_Hp(seedExt, BLOCK_SIZE));
357
+ _u32le(seedExt, 64, 1);
358
+ _blockBytes(B, i * q + 1).set(_Hp(seedExt, BLOCK_SIZE));
359
+ }
360
+
361
+ // ── fill remaining blocks ────────────────────────────────
362
+ const tmpOut = new Uint32Array(256);
363
+ for (let pass = 0; pass < t_; pass++) {
364
+ for (let slice = 0; slice < SYNC_POINTS; slice++) {
365
+ // Argon2id uses data-INDEPENDENT addressing in pass=0, slice=0,1.
366
+ const dataIndep = (TYPE_ARGON2ID === TYPE_ARGON2ID)
367
+ && pass === 0 && slice < 2;
368
+
369
+ for (let lane = 0; lane < p; lane++) {
370
+ // Index lookup state.
371
+ let addrBlock = null;
372
+ let addrCounter = 0;
373
+ if (dataIndep) {
374
+ addrCounter = 1;
375
+ addrBlock = _genIndexBlock(pass, lane, slice, m_, t_, TYPE_ARGON2ID, segLen, addrCounter);
376
+ }
377
+
378
+ // Starting offset within this segment.
379
+ let startOff = (pass === 0 && slice === 0) ? 2 : 0;
380
+
381
+ for (let i = startOff; i < segLen; i++) {
382
+ const curIdxInLane = slice * segLen + i;
383
+ const curIdx = lane * q + curIdxInLane;
384
+ const prevIdx = lane * q + ((curIdxInLane === 0) ? (q - 1) : (curIdxInLane - 1));
385
+
386
+ // Pseudo-random for index selection.
387
+ let pr1, pr2;
388
+ if (dataIndep) {
389
+ if (i !== startOff && (i % 128) === 0) {
390
+ addrCounter++;
391
+ addrBlock = _genIndexBlock(pass, lane, slice, m_, t_, TYPE_ARGON2ID, segLen, addrCounter);
392
+ }
393
+ const k = (i % 128) * 2; // 64-bit word index → 2 halves
394
+ pr1 = addrBlock[k] >>> 0; // low 32 = J1
395
+ pr2 = addrBlock[k + 1] >>> 0; // high 32 = J2
396
+ } else {
397
+ const prevView = _blockView(B, prevIdx);
398
+ pr1 = prevView[0] >>> 0; // low 32 of word 0
399
+ pr2 = prevView[1] >>> 0; // high 32 of word 0
400
+ }
401
+
402
+ // Determine reference set size.
403
+ const refLane = (pass === 0 && slice === 0) ? lane : (pr2 % p);
404
+
405
+ // Reference area size W (RFC 9106 §3.4.1.1).
406
+ let refAreaSize;
407
+ if (pass === 0) {
408
+ if (slice === 0) {
409
+ refAreaSize = i - 1;
410
+ } else if (refLane === lane) {
411
+ refAreaSize = slice * segLen + i - 1;
412
+ } else {
413
+ refAreaSize = slice * segLen - (i === 0 ? 1 : 0);
414
+ }
415
+ } else {
416
+ if (refLane === lane) {
417
+ refAreaSize = q - segLen + i - 1;
418
+ } else {
419
+ refAreaSize = q - segLen - (i === 0 ? 1 : 0);
420
+ }
421
+ }
422
+ // Compute relative offset (RFC 9106 §3.4.1.2.2).
423
+ // x = (J1^2) >> 32; y = (refAreaSize * x) >> 32; relPos = refAreaSize - 1 - y.
424
+ const x = Number((BigInt(pr1) * BigInt(pr1)) >> 32n);
425
+ const y = Number((BigInt(refAreaSize) * BigInt(x)) >> 32n);
426
+ const relPos = refAreaSize - 1 - y;
427
+
428
+ // Starting position of reference area.
429
+ let startPos;
430
+ if (pass !== 0) {
431
+ startPos = (slice === SYNC_POINTS - 1) ? 0 : ((slice + 1) * segLen);
432
+ } else {
433
+ startPos = 0;
434
+ }
435
+ const absPosInLane = (startPos + relPos) % q;
436
+ const refIdx = refLane * q + absPosInLane;
437
+
438
+ // Compute new block.
439
+ const prevView = _blockView(B, prevIdx);
440
+ const refView = _blockView(B, refIdx);
441
+ _compress(tmpOut, prevView, refView);
442
+
443
+ const curView = _blockView(B, curIdx);
444
+ if (pass === 0) {
445
+ curView.set(tmpOut);
446
+ } else {
447
+ // Subsequent passes XOR into existing block.
448
+ for (let k = 0; k < 256; k++) curView[k] ^= tmpOut[k];
449
+ }
450
+ }
451
+ }
452
+ }
453
+ }
454
+
455
+ // ── final tag ────────────────────────────────────────────
456
+ // C = B[0][q-1] XOR B[1][q-1] XOR ... XOR B[p-1][q-1]
457
+ const C = new Uint8Array(BLOCK_SIZE);
458
+ C.set(_blockBytes(B, 0 * q + (q - 1)));
459
+ for (let lane = 1; lane < p; lane++) {
460
+ const last = _blockBytes(B, lane * q + (q - 1));
461
+ for (let k = 0; k < BLOCK_SIZE; k++) C[k] ^= last[k];
462
+ }
463
+ return _Hp(C, tagLen);
464
+ }
465
+
466
+ function _le32(n) {
467
+ const b = new Uint8Array(4);
468
+ _u32le(b, 0, n);
469
+ return b;
470
+ }
471
+
472
+ function _concat(parts) {
473
+ let total = 0;
474
+ for (const p of parts) total += p.length;
475
+ const out = new Uint8Array(total);
476
+ let o = 0;
477
+ for (const p of parts) { out.set(p, o); o += p.length; }
478
+ return out;
479
+ }
480
+
481
+ // ── Iteration G4 - Argon2d / Argon2i explicit reject ─────────────
482
+ //
483
+ // RFC 9106 §4 distinguishes three variants:
484
+ // - Argon2d : data-dependent addressing → vulnerable to cache-timing
485
+ // (a local attacker on the same machine can recover
486
+ // the password by observing memory access patterns).
487
+ // Avoid for password hashing in multi-tenant environments
488
+ // (cloud, containers, browsers).
489
+ // - Argon2i : data-independent addressing → resists cache-timing
490
+ // but offers less GPU/ASIC resistance. Considered
491
+ // sub-optimal alone (cf. Alwen-Blocki 2016 attacks).
492
+ // - Argon2id : hybrid (pass 1 = Argon2i, passes 2+ = Argon2d).
493
+ // This is the recommended choice per RFC 9106 §4 and
494
+ // OWASP / IETF for general password hashing.
495
+ //
496
+ // This module only exposes `hash()` (Argon2id, type=2). To pre-empt
497
+ // any confusion, two exports `hashD` and `hashI` are added that
498
+ // explicitly refuse.
499
+ function hashD() {
500
+ console.warn('[crypto] UNSAFE: argon2: Argon2d is vulnerable to cache-timing attacks (data-dependent addressing). Use hash() (Argon2id) per RFC 9106 §4.');
501
+ return false;
502
+ }
503
+ function hashI() {
504
+ console.warn('[crypto] DEPRECATED: argon2: Argon2i alone is sub-optimal (Alwen-Blocki 2016 - reduced GPU/ASIC resistance). Use hash() (Argon2id) per RFC 9106 §4.');
505
+ return false;
506
+ }
507
+
508
+ return /** @type {Argon2API} */ (/** @type {any} */ ({
509
+ hash,
510
+ // Argon2d / Argon2i - explicit reject (cf. RFC 9106 §4).
511
+ hashD, hashI,
512
+ // Internal primitives - exposed for KAT tests / debug only.
513
+ // `_internal.*` convention shared with gcm/cmac/rsa/random/etc.
514
+ _internal: { Hp: _Hp, compress: _compress }
515
+ }));
516
+ }
517
+ };
@@ -0,0 +1,122 @@
1
+ # `blake2b.js` — RFC interop conformance
2
+
3
+ > **STATUS: RFC interop — outside NIST/CAVP validation.**
4
+ > BLAKE2b is not a FIPS 140-3 approved hash function (NIST/FIPS
5
+ > 180-4 retains SHA-2, FIPS 202 retains SHA-3/SHAKE). Coverage is
6
+ > exclusively RFC 7693 (IETF) — no published NIST ACVP vector.
7
+ > BLAKE2b is nonetheless deployed in Argon2 (RFC 9106), libsodium,
8
+ > WireGuard, KeePass v4, IPFS, Cardano, Zcash, and many modern
9
+ > KDF/MAC schemes for its performance and its resistance to
10
+ > length-extension.
11
+
12
+ ## Standards
13
+
14
+ - **Primary**: **RFC 7693** — *The BLAKE2 Cryptographic Hash and
15
+ Message Authentication Code (MAC)* (November 2015). §3 BLAKE2b
16
+ algorithm, §A "abc" vector, §E official *self-test*.
17
+ - **Origin**: Aumasson, Neves, Wilcox-O'Hearn, Winnerlein 2013 —
18
+ *BLAKE2: simpler, smaller, fast as MD5*.
19
+ - **Implemented variant**: BLAKE2b (64-bit words, output 1..64 bytes,
20
+ 128-byte block, 12 rounds). No BLAKE2s (32-bit words) nor
21
+ BLAKE2bp/sp (parallel).
22
+
23
+ ## Implemented algorithm
24
+
25
+ `blake2b.factory()` exposes BLAKE2b in one-shot and streaming form.
26
+ Public API (`Uint8Array`):
27
+
28
+ - `hash(msg, outLen = 64, key?)` → `Uint8Array(outLen)` or `false`.
29
+ outLen ∈ [1, 64]. key ∈ [0, 64] bytes (BLAKE2b keyed MAC mode).
30
+ - `create(outLen = 64, key?, salt?, person?)` → context `{ update, digest }`
31
+ or `false`. salt and person must be exactly 16 bytes if provided;
32
+ bound to the parameter block §3.3 / §2.5-2.8.
33
+ - `update(chunk)` accumulates a Uint8Array; rejects calls after
34
+ `digest()` (return false).
35
+ - `digest()` finalizes and returns the hash.
36
+
37
+ All lengths (outLen, keyLen) are bound into the parameter block
38
+ XOR'd into h[0..7] (§3.3) — strong domain separation.
39
+
40
+ ## Test coverage
41
+
42
+ ### Built-in official vectors
43
+
44
+ | Source | Reference | Test | Property verified |
45
+ |---|---|---|---|
46
+ | RFC 7693 §A | "abc" BLAKE2b-512 | `§A: hash of "abc"` | byte-exact KAT |
47
+ | Reference | empty BLAKE2b-512 | `hash of empty input` | byte-exact KAT |
48
+ | Reference | empty BLAKE2b-256 | `hash of empty input at outLen=32` | byte-exact KAT (see blake2b CLI) |
49
+ | **RFC 7693 §E** | **official self-test** | `§E self-test — final hash matches RFC constant` | accumulates **48 sub-tests** (4 outLens × 6 inLens × {keyed, unkeyed}); final hash == `c23a7800d98123bd...7bccd475` |
50
+ | Stream | length-binding | `shorter outLen is BLAKE2b-parameterised` | BLAKE2b-256 ≠ truncate(BLAKE2b-512) — RFC 7693 §3.3 |
51
+ | Stream | 3-chunk update | `streaming matches one-shot` | determinism |
52
+ | Stream | 128-byte block boundary | `streaming matches one-shot across exact 128-byte block boundary` | block boundary |
53
+ | Stream | byte-by-byte | `streaming matches one-shot with byte-by-byte updates` | 1-byte granularity |
54
+ | Stream | finalization | `digest is idempotent — second call after finalisation rejected` | update post-digest → false |
55
+ | MAC | keyed determinism | `keyed hash differs from unkeyed and is deterministic` | key binding + reproducibility |
56
+ | MAC | key binding | `different keys produce different outputs` | non-collision on key |
57
+ | MAC | empty msg keyed | `keyed hash with empty msg` | well defined |
58
+ | Param | salt binding | `salt parameter binds into output` | s1 ≠ s2 → hash ≠ |
59
+ | Param | person binding | `personalization parameter binds into output` | p1 ≠ p2 → hash ≠ |
60
+ | Param | salt vs person domain separation | `salt vs personalization are distinct domains` | same bytes in salt vs person → hash ≠ |
61
+ | Validation | outLen out of range | `rejects outLen out of range` | false on 0 + 65 |
62
+ | Validation | key > 64 | `rejects key > 64 bytes` | false |
63
+ | Validation | salt length | `rejects salt of wrong length` | false on 15 + 17 |
64
+ | Validation | person length | `rejects personalization of wrong length` | false on 15 + 17 |
65
+
66
+ ### Security properties tested
67
+
68
+ - [x] **RFC 7693 self-test §E conformance** — 48 sub-tests covering
69
+ 4 outLens × 6 inLens × {keyed, unkeyed}; byte-exact final hash
70
+ simultaneously validating:
71
+ - parameter block packing (outLen, keyLen, fanout, depth)
72
+ - keyed mode (first block of zero-padded key)
73
+ - outLen truncation 20/32/48/64
74
+ - block boundaries (inLen 128, 129, 255, 1024)
75
+ - Fibonacci `selftest_seq` PRG reproduced byte-exact
76
+ - [x] **Length binding** — outLen is in the parameter block;
77
+ BLAKE2b-256("abc") ≠ truncate(BLAKE2b-512("abc"), 32). Security
78
+ against cross-outLen length-extension.
79
+ - [x] **Salt + personalization binding** — 3 orthogonality tests
80
+ (salt change, person change, salt vs person same bytes).
81
+ - [x] **Keyed MAC** — keyed binding + non-collision on different keys.
82
+ - [x] **Streaming = one-shot** — 3 granularities (free chunk, 128-byte
83
+ block boundary, byte-by-byte).
84
+ - [x] **digest idempotence** — post-finalization, update → false.
85
+ - [x] **Parameter validation** — outLen, key, salt, person rejected
86
+ out of range.
87
+ - [x] **No `throw`** — `console.warn` + `return false` (reviewed
88
+ lines 209-225, 283-285).
89
+ - [ ] **BLAKE2s (32-bit words, output 1..32 bytes)** — not implemented.
90
+ **P3** — less frequently used than BLAKE2b.
91
+ - [ ] **BLAKE2bp / BLAKE2sp (parallel, multi-thread)** — not
92
+ implemented. **P3** — of no interest in single-thread JS.
93
+ - [ ] **Tree mode (RFC 7693 §2.10)** — not exposed. **P3**.
94
+
95
+ ## FIPS 140-3 conformance
96
+
97
+ | Requirement | Status | Evidence |
98
+ |---|---|---|
99
+ | NIST-approved algorithm | ❌ N/A | BLAKE2 outside FIPS 180-4 / FIPS 202 |
100
+ | RFC 7693 conformance | ✅ | §A + §E self-test (48 sub-tests + byte-exact final hash) |
101
+ | Length binding (outLen) | ✅ | BLAKE2b-256 ≠ truncate(BLAKE2b-512) |
102
+ | Keyed MAC mode | ✅ | determinism + key binding |
103
+ | Domain separation salt/person | ✅ | 3 orthogonality tests |
104
+ | Parameter validation | ✅ | early return false |
105
+ | No `throw` | ✅ | `console.warn` + return false |
106
+
107
+ ## Known limitations
108
+
109
+ - **Outside NIST scope** — no ACVP vector. Validation = RFC 7693
110
+ + official self-test (the most rigorous of the non-NIST hashes).
111
+ - **No BLAKE2s / parallel variants**: see P3 above.
112
+ - **No tree mode**: RFC 7693 §2.10, exposure not required by
113
+ current usages (Argon2, KeePass…).
114
+
115
+ ## Cross references
116
+
117
+ - Module: [`hash/blake2b.js`](./blake2b.js)
118
+ - Tests: [`hash/blake2b.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/hash/blake2b.test.js) — 20 tests (was 7 before this iteration, including **48 sub-tests accumulated in the §E self-test**)
119
+ - RFC 7693: [`https://datatracker.ietf.org/doc/html/rfc7693`](https://datatracker.ietf.org/doc/html/rfc7693)
120
+ - Reference selftest C: `https://github.com/BLAKE2/BLAKE2/blob/master/ref/blake2b-ref.c`
121
+ - Argon2 uses BLAKE2b internally: [`./argon2.js`](./argon2.js) — see [argon2.acvp.md](./argon2.acvp.md) (upcoming)
122
+ - Overall conformance: [`../NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)