@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,133 @@
1
+ # `sha3.js` — ACVP / NIST conformance
2
+
3
+ ## Standards
4
+
5
+ - **Primary**: **FIPS 202** — *SHA-3 Standard: Permutation-Based Hash and
6
+ Extendable-Output Functions*, §6 (SHA-3 family) + §6.2 (SHAKE).
7
+ - **Secondary**: ACVP — draft-celi-acvp-sha3.
8
+ - **ACVP draft**: `references/NIST/ACVP/src/sha3/`
9
+ - **Vectors**:
10
+ - `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA3-{224,256,384,512}-2.0/`
11
+ - `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHAKE-{128,256}-FIPS202/`
12
+
13
+ ## Implemented algorithm
14
+
15
+ **Keccak-f[1600]** permutation + sponge construction (FIPS 202 §3.4 / §4).
16
+ Internal state: `Uint32Array(50)` (25 64-bit lanes emulated as `(lo, hi)`
17
+ pairs). Domain separation byte `0x06` (SHA-3) or `0x1F` (SHAKE), `pad10*1`
18
+ padding. Capacity = 2 × security level (448, 512, 768, 1024 bits). Worker-
19
+ serializable factory API. Six one-shot functions exposed: `sha3_{224,256,384,512}`
20
+ (fixed digest) and `shake{128,256}(data, outBits)` (XOF, `outBits` must be a multiple of 8).
21
+
22
+ **Iteration A1 (FIPS 140-3 upgrade)**: added four streaming sub-modules
23
+ `sha3_{224,256,384,512}_hash` exposing the `{ name, fn, hash }` contract with
24
+ `fn.prototype.{blockSize, update, finalize}` and clone constructor `new fn(other)`.
25
+ This unlocks HMAC-SHA-3, HKDF-SHA-3, and PBKDF2-HMAC-SHA-3 composition (Phase B
26
+ of the upgrade plan) without breaking the existing one-shot API.
27
+
28
+ ## Test coverage
29
+
30
+ ### Built-in official vectors
31
+
32
+ | Source | Reference | Test (`describe` / `test`) | Property verified |
33
+ |---|---|---|---|
34
+ | FIPS 202 | digest empty (4 SHA-3 variants) | `empty input` / `SHA3-XXX("")` | byte-exact KAT |
35
+ | FIPS 202 | digest "abc" (4 SHA-3 variants) | `"abc" input` / `SHA3-XXX("abc")` | byte-exact KAT |
36
+ | NIST CAVP | 200 × 0xa3 (1600-bit) | `200 bytes of 0xa3` | byte-exact KAT (covers 1 full absorption + tail) |
37
+ | FIPS 202 | SHAKE empty input (256-bit / 512-bit out) | `SHAKE empty input` | byte-exact XOF |
38
+ | **ACVP-SHA3-224-2.0** | AFT sub-sample (15/163 byte-aligned, 1258 total) | `ACVP SHA3-224-2.0 / AFT vectors` | byte-exact KAT |
39
+ | **ACVP-SHA3-224-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** (Iteration H2) |
40
+ | **ACVP-SHA3-256-2.0** | AFT sub-sample (16/151 byte-aligned, 1194 total) | `ACVP SHA3-256-2.0 / AFT vectors` | byte-exact KAT |
41
+ | **ACVP-SHA3-256-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** |
42
+ | **ACVP-SHA3-384-2.0** | AFT sub-sample (13/118 byte-aligned, 938 total) | `ACVP SHA3-384-2.0 / AFT vectors` | byte-exact KAT |
43
+ | **ACVP-SHA3-384-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** (Iteration H2) |
44
+ | **ACVP-SHA3-512-2.0** | AFT sub-sample (13/86 byte-aligned, 682 total) | `ACVP SHA3-512-2.0 / AFT vectors` | byte-exact KAT |
45
+ | **ACVP-SHA3-512-2.0** | MCT standard (100 outer × 1000 inner) | `MCT (standard)` | **100/100 byte-exact results** (Iteration H2) |
46
+ | **ACVP-SHAKE-128-FIPS202** | AFT sub-sample (29/269 byte-aligned in/out) | `ACVP SHAKE128-FIPS202 / AFT vectors` | byte-exact XOF, variable outLen |
47
+ | **ACVP-SHAKE-256-FIPS202** | AFT sub-sample (6/41 byte-aligned in/out, 237 total) | `ACVP SHAKE256-FIPS202 / AFT vectors` | byte-exact XOF, variable outLen |
48
+
49
+ #### Sub-sampling strategy
50
+
51
+ - **SHA-3 AFT**: one byte-aligned tcId in 32, plus anchors `len ∈ {0, 8, 16,
52
+ 24, 56, 96, 256, 512, 1024, 2048, 8192}` when available, plus
53
+ `min(len)` and `max(len)`. Individual cap 32000 bits (except the max-anchor).
54
+ - **SHA-3 MCT**: **standard** FIPS202 algorithm (`MD[0]=SEED ; MSG=MD[i-1]
55
+ ; MD[i]=SHA3(MSG)`). 100 outer × 1000 inner. For SHA3-256, **all 100
56
+ results** are verified byte-exact (full path validated); for
57
+ 224/384/512, iter 0 and iter 99 are checked (CI cost saving; identical algorithm).
58
+ - **SHAKE AFT**: one tcId in 8 (both input AND outLen byte-aligned), plus
59
+ `min/max(outLen)` and `min(len)`. Input cap 16000 bits.
60
+ - **SHAKE MCT**: **not specified in the FIPS 202 ACVP revision** (see the
61
+ draft-celi-acvp-sha3 spec). Therefore not tested.
62
+ - **LDT (testGroup 3)**: not integrated (`fullLength` up to ~8.5 GiB).
63
+
64
+ ### Security properties tested
65
+
66
+ - [x] **Keccak-f[1600] permutation (24 rounds)** — covered by all vectors.
67
+ - [x] **Domain separation 0x06 / 0x1F** — indirect proof: SHA3 and SHAKE
68
+ share the same `_sponge`, only outputs diverge byte-for-byte
69
+ (validated by their respective empty KATs).
70
+ - [x] **`pad10*1` padding** — exercised by the AFT length variations
71
+ (cases where `remaining + 1 < rateBytes` and `remaining = rateBytes - 1`).
72
+ - [x] **Multi-block absorption** — 200×0xa3 KAT (1600 bits = 9 SHA3-256 blocks).
73
+ - [x] **Multi-round squeeze (XOF)** — SHAKE128 vectors with `outLen > rate`
74
+ (SHAKE128 rate = 1344 bits; SHAKE AFT `outLen` spans several blocks).
75
+ - [x] **Long-chain stability** — standard MCT for SHA3-{224,256,384,512}:
76
+ 100,000 consecutive hashes per variant validated **byte-exact across all 100
77
+ iters** (Iteration H2; previously only SHA3-256 was fully byte-exact,
78
+ SHA3-{224,384,512} tested only iter0 + iter99). Any drift deviates
79
+ `resultsArray[j]` at any iteration.
80
+ - [x] **XOF outLen guard** — `SHAKE rejects non-byte-aligned output`:
81
+ `console.warn` + `return false`.
82
+ - [ ] **Side-channel resistance** — N/A (hash module with no secret by default;
83
+ HMAC-SHA-3 usage handled by `hmac.js`).
84
+ - [ ] **Bit-level inputs (non-byte-aligned)** — **NOT SUPPORTED** by
85
+ the current implementation (see *Known limitations*).
86
+ - [x] **Streaming API for HMAC/HKDF/PBKDF2** (upgrade plan iteration A1) —
87
+ 4 sub-modules `sha3_{224,256,384,512}_hash` exposing `{ name, fn, hash }`
88
+ with `fn.prototype.{blockSize, update, finalize}` and clone constructor
89
+ `new fn(other)`. **40 dedicated tests**: streaming = one-shot (3-chunk,
90
+ byte-by-byte, exact rate boundary), clone independence, idempotent finalize
91
+ (2nd call rejected), update rejected after finalize, empty input, bitArray accepted
92
+ for the HMAC ex-key path.
93
+
94
+ ## FIPS 140-3 conformance
95
+
96
+ | Requirement | Status | Evidence |
97
+ |---|---|---|
98
+ | Approved algorithm | ✅ | FIPS 202 §6 + ACVP-SHA3-{224,256,384,512}-2.0 |
99
+ | Validated parameter sizes | ✅ | 4 digestSize + 2 SHAKE variants; variable outLen covered by AFT SHAKE |
100
+ | Power-on KAT / self-test | ✅ | FIPS 202 vectors (empty + "abc" + 200×0xa3) + ACVP AFT executed on every `bun test` |
101
+ | CT comparisons (if secret) | N/A | Hash module with no secret |
102
+ | No `throw` / timing leak | ✅ | Review: `console.warn` + `return false` on the XOF guard |
103
+
104
+ ## Known limitations
105
+
106
+ - **Bit-level inputs not supported**: sha3.js does not implement the FIPS
107
+ 202 Annex B bit-alignment extension (the ACVP suites enumerate ~85% of
108
+ non-byte-aligned vectors; they are **filtered out** at sub-sampling). If a
109
+ consumer needs to absorb a number of bits not a multiple of 8, the
110
+ module must be extended to adjust the domain padding bits.
111
+ - **Aggressive AFT sub-sampling on the 224/384/512 variants**: low
112
+ percentages (15/163, 13/118, 13/86) because the ACVP suite is dominated by
113
+ non-byte-aligned lengths. The remaining byte-aligned vectors cover the
114
+ critical lengths `[0, 8, 16, 24, 56, 96, 256, 512, 1024, 2048, 8192, max]`.
115
+ - **MCT 224/384/512: iter0 + iter99 assertions only** — the algorithm
116
+ is strictly the same (single MD chain, no seed truncation); a
117
+ drift at any intermediate iter would deviate iter 99. All 100
118
+ outer iters are **executed** in all cases (iter 100 depends on the 99
119
+ preceding ones), only the assertion checkpoints are reduced.
120
+ - **SHAKE MCT not tested**: the FIPS 202 ACVP revision spec does not expose an
121
+ MCT for SHAKE.
122
+ - **LDT not integrated**: multi-GB per tcId, out of CI budget.
123
+ - **SHAKE128: very few tcIds with both input AND outLen byte-aligned**
124
+ in the AFT (29/269; 41/237 for SHAKE256). The multi-block squeeze
125
+ code path remains exercised by these 35 vectors.
126
+
127
+ ## Cross references
128
+
129
+ - Module: [`hash/sha3.js`](./sha3.js)
130
+ - Tests: [`hash/sha3.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/hash/sha3.test.js) — 150 tests (110 ACVP/FIPS 202 + 40 streaming API since upgrade plan iteration A1)
131
+ - ACVP draft: `references/NIST/ACVP/src/sha3/`
132
+ - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA3-*-2.0/` + `SHAKE-{128,256}-FIPS202/`
133
+ - Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
@@ -0,0 +1,391 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview SHA-3 family and SHAKE XOFs (FIPS 202).
7
+ *
8
+ * Implements the Keccak-f[1600] permutation and exposes the four SHA-3 fixed-
9
+ * length variants (SHA3-224/256/384/512) plus the two SHAKE extendable-output
10
+ * functions (SHAKE128, SHAKE256) as a single sponge module.
11
+ *
12
+ * The state is held as a Uint32Array(50) of (lo, hi) pairs - Keccak operates
13
+ * on 64-bit lanes but JS lacks native 64-bit integers, so each lane is split
14
+ * into two 32-bit halves and the round transformations are unrolled
15
+ * accordingly. Inputs are absorbed lane-by-lane (rate r = 1600 - capacity)
16
+ * and the squeezing phase emits any number of bytes.
17
+ *
18
+ * Domain separation per FIPS 202 §6.1: SHA-3 appends the byte 0x06 before
19
+ * pad10*1, SHAKE appends 0x1F. Capacity is 2× the security level (e.g. 256
20
+ * bits for SHA3-128-equivalent, 512 bits for SHA3-256).
21
+ *
22
+ */
23
+
24
+ /**
25
+ * Streaming SHA-3 / SHAKE hash instance - HMAC/HKDF/PBKDF2 compatible.
26
+ * @typedef {object} Sha3HashInstance
27
+ * @property {number} blockSize Block size in bits.
28
+ * @property {(data: (string|Uint8Array|number[])) => Sha3HashInstance} update
29
+ * @property {() => (number[]|false)} finalize Returns the digest as bitArray, or `false` on misuse.
30
+ */
31
+
32
+ /**
33
+ * Streaming SHA-3 / SHAKE constructor. The copy form (`new Ctor(other)`) clones
34
+ * inner state for HMAC inner/outer caching.
35
+ * @typedef {{ new (other?: Sha3HashInstance): Sha3HashInstance }} Sha3HashCtor
36
+ */
37
+
38
+ /**
39
+ * Submodule shape exposed by `sha3_*_hash` keys, compatible with
40
+ * `hmac.js` / `hkdf.js` / `pbkdf2.js` dependency injection.
41
+ * @typedef {object} Sha3StreamingModule
42
+ * @property {string} name
43
+ * @property {Sha3HashCtor} fn
44
+ * @property {(data: (string|Uint8Array|number[])) => (number[]|false)} hash
45
+ */
46
+
47
+ /**
48
+ * One-shot SHA-3 hash function: data in, digest bitArray out.
49
+ * @typedef {(data: (string|Uint8Array|number[])) => number[]} Sha3OneShot
50
+ */
51
+
52
+ /**
53
+ * SHAKE extendable-output function: data + requested output bit-length.
54
+ * Returns the digest bitArray, or `false` when `outBits` is invalid.
55
+ * @typedef {(data: (string|Uint8Array|number[]), outBits: number) => (number[]|false)} ShakeXof
56
+ */
57
+
58
+ /**
59
+ * Public shape returned by `sha3.factory()`.
60
+ * @typedef {object} Sha3API
61
+ * @property {Sha3OneShot} sha3_224 One-shot SHA3-224 (digest as bitArray).
62
+ * @property {Sha3OneShot} sha3_256 One-shot SHA3-256 (digest as bitArray).
63
+ * @property {Sha3OneShot} sha3_384 One-shot SHA3-384 (digest as bitArray).
64
+ * @property {Sha3OneShot} sha3_512 One-shot SHA3-512 (digest as bitArray).
65
+ * @property {ShakeXof} shake128 SHAKE128 XOF (variable-length output).
66
+ * @property {ShakeXof} shake256 SHAKE256 XOF (variable-length output).
67
+ * @property {Sha3StreamingModule} sha3_224_hash HMAC/HKDF/PBKDF2-compatible module.
68
+ * @property {Sha3StreamingModule} sha3_256_hash HMAC/HKDF/PBKDF2-compatible module.
69
+ * @property {Sha3StreamingModule} sha3_384_hash HMAC/HKDF/PBKDF2-compatible module.
70
+ * @property {Sha3StreamingModule} sha3_512_hash HMAC/HKDF/PBKDF2-compatible module.
71
+ */
72
+
73
+ import { bitArray } from '../utils/bitArray.js';
74
+ import { utf8 } from '../../io/codec/utf8.js';
75
+
76
+ export const sha3 = {
77
+ name: 'sha3',
78
+ version: '1.0.0',
79
+ type: 'fw.crypto.hash',
80
+ dependencies: ['bitArray', 'utf8'],
81
+ deps: [bitArray, utf8],
82
+
83
+ /** @returns {Sha3API} */
84
+ factory(bitArray, utf8) {
85
+
86
+ // Round constants (split into lo, hi 32-bit halves).
87
+ const _RC_LO = new Uint32Array([
88
+ 0x00000001, 0x00008082, 0x0000808a, 0x80008000,
89
+ 0x0000808b, 0x80000001, 0x80008081, 0x00008009,
90
+ 0x0000008a, 0x00000088, 0x80008009, 0x8000000a,
91
+ 0x8000808b, 0x0000008b, 0x00008089, 0x00008003,
92
+ 0x00008002, 0x00000080, 0x0000800a, 0x8000000a,
93
+ 0x80008081, 0x00008080, 0x80000001, 0x80008008
94
+ ]);
95
+ const _RC_HI = new Uint32Array([
96
+ 0x00000000, 0x00000000, 0x80000000, 0x80000000,
97
+ 0x00000000, 0x00000000, 0x80000000, 0x80000000,
98
+ 0x00000000, 0x00000000, 0x00000000, 0x00000000,
99
+ 0x00000000, 0x80000000, 0x80000000, 0x80000000,
100
+ 0x80000000, 0x80000000, 0x00000000, 0x80000000,
101
+ 0x80000000, 0x80000000, 0x00000000, 0x80000000
102
+ ]);
103
+
104
+ // ρ rotation offsets (in bits) for each lane, flattened as i = x + 5*y
105
+ // (row-major, x ∈ rows of 5). Values per FIPS 202 Table 2.
106
+ const _R = [
107
+ 0, 1, 62, 28, 27,
108
+ 36, 44, 6, 55, 20,
109
+ 3, 10, 43, 25, 39,
110
+ 41, 45, 15, 21, 8,
111
+ 18, 2, 61, 56, 14
112
+ ];
113
+
114
+ function _keccakF1600(s) {
115
+ const C = new Uint32Array(10);
116
+ const D = new Uint32Array(10);
117
+ const B = new Uint32Array(50);
118
+
119
+ for (let round = 0; round < 24; round++) {
120
+ // θ
121
+ for (let x = 0; x < 5; x++) {
122
+ C[2*x] = s[2*x] ^ s[2*x + 10] ^ s[2*x + 20] ^ s[2*x + 30] ^ s[2*x + 40];
123
+ C[2*x+1] = s[2*x+1] ^ s[2*x + 11] ^ s[2*x + 21] ^ s[2*x + 31] ^ s[2*x + 41];
124
+ }
125
+ for (let x = 0; x < 5; x++) {
126
+ const xm1 = (x + 4) % 5;
127
+ const xp1 = (x + 1) % 5;
128
+ // D[x] = C[x-1] xor rot(C[x+1], 1)
129
+ const lo = C[2*xp1];
130
+ const hi = C[2*xp1 + 1];
131
+ D[2*x] = C[2*xm1] ^ ((lo << 1) | (hi >>> 31));
132
+ D[2*x+1] = C[2*xm1 + 1] ^ ((hi << 1) | (lo >>> 31));
133
+ }
134
+ for (let i = 0; i < 25; i++) {
135
+ const x = i % 5;
136
+ s[2*i] ^= D[2*x];
137
+ s[2*i + 1] ^= D[2*x + 1];
138
+ }
139
+
140
+ // ρ + π
141
+ for (let x = 0; x < 5; x++) {
142
+ for (let y = 0; y < 5; y++) {
143
+ const i = x + 5 * y;
144
+ const ni = y + 5 * ((2 * x + 3 * y) % 5);
145
+ const r = _R[i];
146
+ const lo = s[2*i];
147
+ const hi = s[2*i + 1];
148
+ let nlo, nhi;
149
+ if (r === 0) {
150
+ nlo = lo; nhi = hi;
151
+ } else if (r < 32) {
152
+ nlo = (lo << r) | (hi >>> (32 - r));
153
+ nhi = (hi << r) | (lo >>> (32 - r));
154
+ } else if (r === 32) {
155
+ nlo = hi; nhi = lo;
156
+ } else {
157
+ const r2 = r - 32;
158
+ nlo = (hi << r2) | (lo >>> (32 - r2));
159
+ nhi = (lo << r2) | (hi >>> (32 - r2));
160
+ }
161
+ B[2*ni] = nlo;
162
+ B[2*ni + 1] = nhi;
163
+ }
164
+ }
165
+
166
+ // χ
167
+ for (let y = 0; y < 5; y++) {
168
+ for (let x = 0; x < 5; x++) {
169
+ const i = x + 5 * y;
170
+ const i1 = ((x + 1) % 5) + 5 * y;
171
+ const i2 = ((x + 2) % 5) + 5 * y;
172
+ s[2*i] = B[2*i] ^ ((~B[2*i1]) & B[2*i2]);
173
+ s[2*i + 1] = B[2*i + 1] ^ ((~B[2*i1 + 1]) & B[2*i2 + 1]);
174
+ }
175
+ }
176
+
177
+ // ι
178
+ s[0] ^= _RC_LO[round];
179
+ s[1] ^= _RC_HI[round];
180
+ }
181
+ }
182
+
183
+ function _toBytes(data) {
184
+ if (typeof data === 'string') return utf8.toBytes(data);
185
+ if (data instanceof Uint8Array) return data;
186
+ // assume bitArray
187
+ return bitArray.ba_to_ui8(data);
188
+ }
189
+
190
+ /**
191
+ * XOR a full rate-sized block of bytes into the sponge state and apply
192
+ * Keccak-f[1600]. Helper shared by `_sponge` (one-shot) and the streaming
193
+ * `_absorbInto` (incremental).
194
+ */
195
+ function _absorbFullBlock(s, block, rateBytes) {
196
+ for (let i = 0; i < rateBytes; i++) {
197
+ const lane = i >>> 3;
198
+ const byteInLane = i & 7;
199
+ const wordIdx = 2 * lane + (byteInLane < 4 ? 0 : 1);
200
+ const shift = (byteInLane & 3) * 8;
201
+ s[wordIdx] ^= (block[i] & 0xff) << shift;
202
+ }
203
+ _keccakF1600(s);
204
+ }
205
+
206
+ /**
207
+ * Sponge construction.
208
+ * @param {Uint8Array} input
209
+ * @param {number} rateBytes Bitrate in bytes (200 - capacity/8).
210
+ * @param {number} domain Domain-separation byte (0x06 SHA-3, 0x1F SHAKE).
211
+ * @param {number} outBytes Desired output length in bytes.
212
+ * @returns {Uint8Array}
213
+ */
214
+ function _sponge(input, rateBytes, domain, outBytes) {
215
+ const s = new Uint32Array(50);
216
+ const blocks = Math.floor(input.length / rateBytes);
217
+
218
+ // Absorb full blocks.
219
+ for (let b = 0; b < blocks; b++) {
220
+ _absorbFullBlock(s, input.subarray(b * rateBytes, (b + 1) * rateBytes), rateBytes);
221
+ }
222
+
223
+ // Absorb final (possibly partial) block + pad10*1.
224
+ const tail = new Uint8Array(rateBytes);
225
+ const remaining = input.length - blocks * rateBytes;
226
+ tail.set(input.subarray(blocks * rateBytes), 0);
227
+ tail[remaining] = domain;
228
+ tail[rateBytes - 1] |= 0x80;
229
+ _absorbFullBlock(s, tail, rateBytes);
230
+
231
+ // Squeeze.
232
+ const out = new Uint8Array(outBytes);
233
+ let produced = 0;
234
+ while (produced < outBytes) {
235
+ const take = Math.min(rateBytes, outBytes - produced);
236
+ for (let i = 0; i < take; i++) {
237
+ const lane = i >>> 3;
238
+ const byteInLane = i & 7;
239
+ const wordIdx = 2 * lane + (byteInLane < 4 ? 0 : 1);
240
+ const shift = (byteInLane & 3) * 8;
241
+ out[produced + i] = (s[wordIdx] >>> shift) & 0xff;
242
+ }
243
+ produced += take;
244
+ if (produced < outBytes) _keccakF1600(s);
245
+ }
246
+ return out;
247
+ }
248
+
249
+ function _make(outBits, capacityBits, domain) {
250
+ const rateBytes = (1600 - capacityBits) / 8;
251
+ const outBytes = outBits / 8;
252
+ return function (data) {
253
+ return bitArray.ui8_to_ba(_sponge(_toBytes(data), rateBytes, domain, outBytes));
254
+ };
255
+ }
256
+
257
+ function _makeXof(capacityBits, domain) {
258
+ const rateBytes = (1600 - capacityBits) / 8;
259
+ return function (data, outBits) {
260
+ if (outBits < 0 || (outBits & 7) !== 0) {
261
+ console.warn('[crypto] INVALID: sha3: SHAKE output must be a non-negative multiple of 8 bits');
262
+ return false;
263
+ }
264
+ return bitArray.ui8_to_ba(_sponge(_toBytes(data), rateBytes, domain, outBits / 8));
265
+ };
266
+ }
267
+
268
+ // ── Streaming sponge constructor (HMAC/HKDF/PBKDF2-compatible) ─────
269
+ //
270
+ // Exposes the `{ fn, hash, fn.prototype.{blockSize, update, finalize} }`
271
+ // contract that `hash/hmac.js` requires (cf. hmac.js:22-45). One module
272
+ // per SHA-3 variant + per SHAKE rate. Output length is fixed at the
273
+ // standard digest size (FIPS 202) for SHA-3; for SHAKE the streaming
274
+ // wrapper takes `outBits` at construction time.
275
+ //
276
+ // State is fully cloneable via the copy constructor `new H(other)`,
277
+ // which HMAC uses to cache the inner/outer hash state after key
278
+ // absorption (hmac.js:31, 44, 59, 71).
279
+
280
+ /**
281
+ * @returns {Sha3HashCtor}
282
+ */
283
+ function _makeStreamingHash(outBits, capacityBits, domain) {
284
+ const rateBytes = (1600 - capacityBits) / 8;
285
+ const outBytes = outBits / 8;
286
+
287
+ function H(other) {
288
+ if (other) {
289
+ // Clone constructor - used by HMAC for inner/outer state caching.
290
+ this._state = new Uint32Array(other._state);
291
+ this._buf = new Uint8Array(other._buf);
292
+ this._bufLen = other._bufLen;
293
+ this._finalized = other._finalized;
294
+ } else {
295
+ this._state = new Uint32Array(50);
296
+ this._buf = new Uint8Array(rateBytes);
297
+ this._bufLen = 0;
298
+ this._finalized = false;
299
+ }
300
+ }
301
+
302
+ // Block size in **bits** - `hmac.js:30` reads this as `blockSize / 32`.
303
+ H.prototype.blockSize = rateBytes * 8;
304
+
305
+ H.prototype.update = function (data) {
306
+ if (this._finalized) {
307
+ console.warn('[crypto] INVALID: sha3: update after finalize');
308
+ return this;
309
+ }
310
+ const bytes = _toBytes(data);
311
+ let off = 0;
312
+ while (off < bytes.length) {
313
+ const take = Math.min(rateBytes - this._bufLen, bytes.length - off);
314
+ this._buf.set(bytes.subarray(off, off + take), this._bufLen);
315
+ this._bufLen += take;
316
+ off += take;
317
+ if (this._bufLen === rateBytes) {
318
+ _absorbFullBlock(this._state, this._buf, rateBytes);
319
+ this._bufLen = 0;
320
+ }
321
+ }
322
+ return this;
323
+ };
324
+
325
+ H.prototype.finalize = function () {
326
+ if (this._finalized) {
327
+ console.warn('[crypto] INVALID: sha3: finalize called twice');
328
+ return false;
329
+ }
330
+ // Pad10*1 + domain
331
+ for (let i = this._bufLen; i < rateBytes; i++) this._buf[i] = 0;
332
+ this._buf[this._bufLen] = domain;
333
+ this._buf[rateBytes - 1] |= 0x80;
334
+ _absorbFullBlock(this._state, this._buf, rateBytes);
335
+ this._finalized = true;
336
+
337
+ // Squeeze
338
+ const out = new Uint8Array(outBytes);
339
+ let produced = 0;
340
+ while (produced < outBytes) {
341
+ const take = Math.min(rateBytes, outBytes - produced);
342
+ for (let i = 0; i < take; i++) {
343
+ const lane = i >>> 3;
344
+ const byteInLane = i & 7;
345
+ const wordIdx = 2 * lane + (byteInLane < 4 ? 0 : 1);
346
+ const shift = (byteInLane & 3) * 8;
347
+ out[produced + i] = (this._state[wordIdx] >>> shift) & 0xff;
348
+ }
349
+ produced += take;
350
+ if (produced < outBytes) _keccakF1600(this._state);
351
+ }
352
+ return bitArray.ui8_to_ba(out);
353
+ };
354
+
355
+ return H;
356
+ }
357
+
358
+ // Submodule wrappers exposing `{ name, fn, hash }` shape compatible
359
+ // with hmac.js / hkdf.js / pbkdf2.js dependency injection.
360
+ /** @returns {Sha3StreamingModule} */
361
+ function _streamingModule(name, outBits, capacityBits, domain, oneShot) {
362
+ const fn = _makeStreamingHash(outBits, capacityBits, domain);
363
+ return { name, fn, hash: oneShot };
364
+ }
365
+
366
+ const _sha3_224 = _make(224, 448, 0x06);
367
+ const _sha3_256 = _make(256, 512, 0x06);
368
+ const _sha3_384 = _make(384, 768, 0x06);
369
+ const _sha3_512 = _make(512, 1024, 0x06);
370
+ const _shake128 = _makeXof(256, 0x1F);
371
+ const _shake256 = _makeXof(512, 0x1F);
372
+
373
+ return {
374
+ // Existing one-shot callable API (unchanged).
375
+ sha3_224: _sha3_224,
376
+ sha3_256: _sha3_256,
377
+ sha3_384: _sha3_384,
378
+ sha3_512: _sha3_512,
379
+ shake128: _shake128,
380
+ shake256: _shake256,
381
+
382
+ // NEW: HMAC/HKDF/PBKDF2-compatible Hash modules with `{ fn, hash }`.
383
+ // Each `fn` is a constructor exposing prototype.{blockSize, update, finalize}
384
+ // and a copy constructor `new fn(other)`.
385
+ sha3_224_hash: _streamingModule('sha3_224', 224, 448, 0x06, _sha3_224),
386
+ sha3_256_hash: _streamingModule('sha3_256', 256, 512, 0x06, _sha3_256),
387
+ sha3_384_hash: _streamingModule('sha3_384', 384, 768, 0x06, _sha3_384),
388
+ sha3_512_hash: _streamingModule('sha3_512', 512, 1024, 0x06, _sha3_512)
389
+ };
390
+ }
391
+ };
@@ -0,0 +1,82 @@
1
+ # `sha384.js` — ACVP / NIST conformance
2
+
3
+ ## Standards
4
+
5
+ - **Primary**: **FIPS 180-4** — *Secure Hash Standard (SHS)*, §6.5 (SHA-384).
6
+ - **Secondary**: ACVP — draft-celi-acvp-sha.
7
+ - **ACVP draft**: `references/NIST/ACVP/src/draft-celi-acvp-sha.adoc`
8
+ - **Vectors**: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA2-384-1.0/`
9
+
10
+ ## Implemented algorithm
11
+
12
+ SHA-384 hash (FIPS 180-4 §6.5). Identical to SHA-512 except for the IV (FIPS 180-4
13
+ §5.3.4) and the final truncation (`h.slice(0, 12)` → 384 bits = 12 32-bit
14
+ words representing 6 64-bit words).
15
+
16
+ **Architecture (post-upgrade audit Finding 1 resolved)**: `factory(sha512)` →
17
+ `{ fn, hash }`. Thin wrapper (~14 useful LOC) over
18
+ `sha512._internal.makeSha(_INIT_384, 12)`. **Previously**: this module
19
+ duplicated the ~120 LOC of the 64-bit compression function "to
20
+ preserve streaming-state independence" — inconsistent with
21
+ sha512_224/256, which already apply this reuse pattern. Compression
22
+ over 1024-bit blocks, 64-bit operations emulated as 32-bit (high/low)
23
+ pairs, inherited from sha512.js.
24
+
25
+ ## Test coverage
26
+
27
+ ### Built-in official vectors
28
+
29
+ | Source | Reference | Test (`describe` / `test`) | Property verified |
30
+ |---|---|---|---|
31
+ | FIPS 180-4 | digest empty | `FIPS-180 vectors` / `empty string` | byte-exact KAT |
32
+ | FIPS 180-4 App. D | "abc" | `FIPS-180 vectors` / `"abc"` | byte-exact KAT |
33
+ | ACVP-SHA2-384-1.0 | `expectedResults.json` tcId 1-1024 (sub-sample 24) | `ACVP SHA2-384-1.0 / AFT vectors` | byte-exact KAT (lengths 0..65535 bits, INCLUDING non-byte-aligned bit-level) |
34
+ | ACVP-SHA2-384-1.0 | `expectedResults.json` tcId 1025 (standard MCT) | `ACVP SHA2-384-1.0 / MCT (standard)` | 100 outer × 1000 inner — 100 byte-exact `resultsArray` results |
35
+
36
+ #### AFT sub-sampling strategy
37
+
38
+ The SHA2-384 AFT enumerates 1024 messages at lengths `[0..65535]` bits — **892/1024 tests are non-byte-aligned**. Strategy:
39
+
40
+ - **Regular stride**: tcId 1, 33, 65, …, 993, 1024 (one in 32).
41
+ - **Anchors**: `len=0`, `min(len)`, `max(len)=65535`, and the first tcId for each critical short length (1, 7, 9, 13, 100, 511, 1023, 2047 bits).
42
+ - **Volume cap**: tests > 32000 bits filtered out (except the `max(len)` anchor).
43
+ - **Total integrated**: **24 / 1024 AFT + 1 MCT** out of 1025 tests + **1 LDT (1 GiB) gated behind `CRYPTO_FULL=1`** (see LDT line below).
44
+ - **LDT (testGroup 3)**: **Iteration H1** — tcId=1026 (1 GiB of repeated `3d04a3d3c6a52e47`) integrated behind `CRYPTO_FULL=1`.
45
+
46
+ Non-byte-aligned vectors are decoded via `bitArray.clamp(ui8_to_ba(bytes), bitLen)`.
47
+
48
+ ### Security properties tested
49
+
50
+ - [x] **80 rounds / 64-bit message schedule** — covered by 24 AFT spread across the length range (the SHA-384 `_block` runs 80 rounds over emulated 64-bit words).
51
+ - [x] **Bit-level inputs (non-byte-aligned)** — covered by the anchors at lengths 1, 7, 9, 13, 100, 511, 1023, 2047 bits.
52
+ - [x] **FIPS 180-4 §5.1.2 padding** — implicitly validated by the varied lengths (`≥ 896 mod 1024` cases forcing an extra block).
53
+ - [x] **Long-chain stability** — standard MCT: 100,000 consecutive hashes (MSG = 1152 bits); any drift deviates `resultsArray[j]`.
54
+ - [x] **Streaming = one-shot** — `chunked update matches one-shot`.
55
+ - [x] **512→384 truncation** — `digest is 384 bits (12 x 32-bit words)` validates the `slice(0, 12)`.
56
+ - [x] **2^53−1-bit limit** — `update` returns `false` + `console.warn` beyond it.
57
+ - [ ] **Side-channel resistance** — N/A (no secret input by default; HMAC usage handled by `hmac.js`).
58
+
59
+ ## FIPS 140-3 conformance
60
+
61
+ | Requirement | Status | Evidence |
62
+ |---|---|---|
63
+ | Approved algorithm | ✅ | FIPS 180-4 §6.5 + ACVP-SHA2-384-1.0 |
64
+ | Validated parameter sizes | ✅ | single 384-bit digest; 0..65535-bit input covered by AFT |
65
+ | Power-on KAT / self-test | ✅ | FIPS-180 vectors + 24 AFT executed on every `bun test` |
66
+ | CT comparisons (if secret) | N/A | Hash module with no secret |
67
+ | No `throw` / timing leak | ✅ | Review: `console.warn` + `return false` |
68
+
69
+ ## Known limitations
70
+
71
+ - ~~**LDT not integrated**~~ — resolved in **H1**: tcId=1026 (1 GiB) runs under `CRYPTO_FULL=1` byte-exact.
72
+ - **AFT sub-sampling**: 24/1024 (≈ 2.3%). Choice driven by message size (cap 32000 bits + anchor 65535).
73
+ - **"alternate" MCT version** not tested (ACVP provides `"standard"`).
74
+ - **64-bit emulation as 32-bit pairs**: inherited SJCL implementation; the bit-rotation operations are purely deterministic (no data-dependent path on the arithmetic side).
75
+
76
+ ## Cross references
77
+
78
+ - Module: [`hash/sha384.js`](./sha384.js)
79
+ - Tests: [`hash/sha384.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/hash/sha384.test.js) — **31 tests** (30 pass + 1 skip LDT — `CRYPTO_FULL=1` to enable; was 5 before the upgrade)
80
+ - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-sha.adoc`
81
+ - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/SHA2-384-1.0/`
82
+ - Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
@@ -0,0 +1,61 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview SHA-384 hash function (FIPS 180-4 §5.3.4 + §6.5).
7
+ *
8
+ * Truncated SHA-512 variant: same compression function as SHA-512
9
+ * (cf. sha512.js) but with a distinct IV and a 384-bit digest taken
10
+ * from the first 12 × 32-bit words of the final SHA-512 state.
11
+ *
12
+ * Block size: 1024 bits (identical to SHA-512, required for HMAC-SHA-384).
13
+ *
14
+ * **Architecture (post-upgrade audit)**: this module is now a thin wrapper
15
+ * over `sha512._internal.makeSha(_INIT_384, 12)` - previously it duplicated
16
+ * the 120 LOC of the compression function. Mirrors the
17
+ * `sha512_224.js` / `sha512_256.js` pattern.
18
+ *
19
+ */
20
+
21
+ import { sha512 } from './sha512.js';
22
+
23
+ /**
24
+ * Streaming SHA-384 hasher instance (truncated SHA-512; bitArray = `number[]` of 32-bit words).
25
+ * @typedef {object} Sha384Hasher
26
+ * @property {number} blockSize Block size in bits (1024).
27
+ * @property {number[]} _init IV (16 × 32-bit halves = 8 × 64-bit lanes).
28
+ * @property {number} _outWords Number of 32-bit words retained in the digest (12).
29
+ * @property {number[]} _key Round constants.
30
+ * @property {() => Sha384Hasher} reset Reset internal state; returns `this`.
31
+ * @property {(data: number[]|string) => (Sha384Hasher|false)} update Absorb a bitArray or UTF-8 string; returns `this`, or `false` on > 2^53-1 bit overflow.
32
+ * @property {() => number[]} finalize Pad and emit the 384-bit digest as a bitArray (12 words).
33
+ * @property {(words: ArrayLike<number>) => void} _block Compress one 32-word (1024-bit) block.
34
+ */
35
+
36
+ /**
37
+ * Object returned by `sha384.factory()` (delegates to `sha512._internal.makeSha`).
38
+ * @typedef {object} Sha384API
39
+ * @property {new (hash?: Sha384Hasher) => Sha384Hasher} fn Streaming hasher constructor (optional arg clones an existing instance).
40
+ * @property {(data: number[]|string) => number[]} hash One-shot hash; returns the 384-bit digest as a bitArray.
41
+ */
42
+
43
+ export const sha384 = {
44
+ name: 'sha384',
45
+ version: '1.0.0',
46
+ type: 'fw.crypto.hash',
47
+ dependencies: ['sha512'],
48
+ deps: [sha512],
49
+
50
+ /** @returns {Sha384API} */
51
+ factory(sha512) {
52
+ // FIPS 180-4 §5.3.4 - IV for SHA-384 (8 × 64-bit, 16 × 32-bit halves).
53
+ const _INIT_384 = [
54
+ 0xcbbb9d5d, 0xc1059ed8, 0x629a292a, 0x367cd507, 0x9159015a, 0x3070dd17, 0x152fecd8, 0xf70e5939,
55
+ 0x67332667, 0xffc00b31, 0x8eb44a87, 0x68581511, 0xdb0c2e0d, 0x64f98fa7, 0x47b5481d, 0xbefa4fa4
56
+ ];
57
+
58
+ // outWords = 12 → 12 × 32-bit = 384 bits (FIPS 180-4 §6.5 truncation).
59
+ return sha512._internal.makeSha(_INIT_384, 12);
60
+ }
61
+ };