@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,261 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ // packages/front/fw/src/core/worker-helper.js
6
+ /**
7
+ * @fileoverview Factory that creates a `workerRuntime` function for spawning
8
+ * framework-aware Web Workers from inline code.
9
+ *
10
+ * **How it works:**
11
+ * 1. The requested dependency modules are serialised by `runtime.serialize` into
12
+ * a self-contained JS string.
13
+ * 2. An optional logger bootstrap (`logFn`) is prepended when `ENV.LOG` is active.
14
+ * 3. The code string is turned into a Blob URL and passed to `new Worker(...)`.
15
+ * 4. Framework-internal messages (flagged with `__fw: true`) are intercepted on
16
+ * the main-thread `message` event and never reach user handlers.
17
+ * 5. `worker.terminate` is patched to perform cleanup (revoke the Blob URL,
18
+ * run the user-supplied `terminate` callback) before delegating to the native
19
+ * `terminate`.
20
+ *
21
+ */
22
+
23
+ /**
24
+ * Options accepted by the `workerRuntime` function returned by
25
+ * {@link createWorkerRuntime}.
26
+ *
27
+ * @typedef {Object} WorkerOptions
28
+ * @property {string[]} [dependencies=[]] - Module names to serialise and register
29
+ * inside the worker. The transitive dependency graph is resolved automatically.
30
+ * @property {Function} [workerFw] - Worker-side framework bootstrap function.
31
+ * Signature: `(runtime, modules, args) => context`. Called inside the worker
32
+ * after all modules are registered; its return value is assigned to
33
+ * `runtime.context` and passed as the sole argument to `workerFn`.
34
+ * Defaults to a function that resolves all modules into `libs` and returns
35
+ * `{ libs, process, args }`.
36
+ * @property {*[]} [args=[]] - Serialisable arguments forwarded to
37
+ * `workerFw` as its third parameter. Must be JSON-serialisable.
38
+ * @property {Function} [terminate] - Callback invoked during cleanup, just
39
+ * before the native `Worker.terminate()` call. Defaults to a no-op.
40
+ */
41
+
42
+ /**
43
+ * @typedef {Object} ModuleRuntime
44
+ * @property {function(string[]): Object} resolveAll - Resolve a list of module names.
45
+ * @property {function(string[]): {content: string, list: string[]}} serialize - Serialize module(s) by name array.
46
+ * @property {*} [context] - Worker-side resolved context.
47
+ */
48
+
49
+ /**
50
+ * @typedef {function(Function, WorkerOptions=): Worker} workerRuntime
51
+ */
52
+
53
+ /**
54
+ * A framework-internal message sent from the worker to the main thread.
55
+ * These messages are intercepted and never forwarded to user listeners.
56
+ *
57
+ * @typedef {Object} FwMessage
58
+ * @property {true} __fw - Framework flag; always `true`.
59
+ * @property {string} __type - Message sub-type (e.g. `'log'`).
60
+ * @property {*} [msg] - Payload (type-dependent).
61
+ */
62
+
63
+ /**
64
+ * Create a `workerRuntime` function bound to the given environment and runtime.
65
+ *
66
+ * Separating construction from invocation allows `createWorkerRuntime` to be
67
+ * called once at application startup while `workerRuntime` is called each time
68
+ * a new Worker is needed.
69
+ *
70
+ * @param {Object} ENV - Environment configuration object.
71
+ * @param {boolean} ENV.LOG - When `true`, the log-forwarding handler is
72
+ * installed and the logger bootstrap is prepended to the worker code.
73
+ * @param {boolean} [ENV.DEV] - Passed to the logger bootstrap when `ENV.LOG`
74
+ * is active.
75
+ * @param {ModuleRuntime} runtime - The main-thread runtime instance used to
76
+ * serialise modules for the worker.
77
+ * @param {string} runtimeSource - Self-contained source code of the runtime
78
+ * (constants + private helpers + `ModuleRuntime` class), exported by
79
+ * `runtime.js` as `runtimeSource`. Embedded as-is at the top of the worker
80
+ * code so the class can reference its private helpers (`semverCompare`,
81
+ * `parseSpec`, `canonical`, etc.) once instantiated worker-side.
82
+ * @param {Object} log - Main-thread log service. Must expose a
83
+ * `__push(msg)` method when `ENV.LOG` is `true`.
84
+ * @param {Function} logFn - Logger initialisation function; its source is
85
+ * stringified and prepended to the worker code when `ENV.LOG` is `true`.
86
+ * @returns {workerRuntime} A configured worker-spawn function.
87
+ */
88
+ export function createWorkerRuntime(ENV, runtime, runtimeSource, log, logFn) {
89
+
90
+ const FW_FLAG = '__fw';
91
+ const FW_TYPE_LOG = 'log';
92
+
93
+ const DEFAULT_WORKER_MODULES = [];
94
+
95
+ /**
96
+ * Default worker-side framework bootstrap.
97
+ *
98
+ * Resolves all requested modules via `runtime.resolveAll` and returns a
99
+ * context object `{ libs, process, args }` that is assigned to
100
+ * `runtime.context` inside the worker.
101
+ *
102
+ * @param {ModuleRuntime} runtime - The worker's own runtime instance.
103
+ * @param {string[]} modules - Module names to resolve.
104
+ * @param {*[]} args - Arguments forwarded from the main thread.
105
+ * @returns {{ libs: Object.<string,*>, process: Object, args: *[] }}
106
+ */
107
+ const DEFAULT_WORKER_FRAMEWORK = function(runtime, modules, args) {
108
+ const libs = runtime.resolveAll(modules);
109
+ const process = {};
110
+ return {libs, process, args};
111
+ };
112
+
113
+ /**
114
+ * Determine whether a worker `MessageEvent` carries a framework-internal
115
+ * message (flagged with `__fw: true`).
116
+ *
117
+ * @param {*} data - The `event.data` value from a `MessageEvent`.
118
+ * @returns {boolean} `true` when the message is framework-internal.
119
+ */
120
+ const isFwMessage = function (data) {
121
+ return !!(data && data[FW_FLAG] === true);
122
+ };
123
+
124
+ /**
125
+ * Build the main-thread `message` event handler for a worker.
126
+ *
127
+ * When `ENV.LOG` is active, the handler additionally pushes `'log'`-typed
128
+ * framework messages to the main-thread log service via `log.__push`.
129
+ * In all cases, framework-internal messages are stopped from propagating
130
+ * further with `stopImmediatePropagation`.
131
+ *
132
+ * @returns {function(MessageEvent): void} The `message` event handler.
133
+ */
134
+ const messageHandlerBuilder = function() {
135
+ if (ENV.LOG) {
136
+ return function (event) {
137
+ if (isFwMessage(event.data)) {
138
+ event.stopImmediatePropagation();
139
+
140
+ if (event.data.__type === FW_TYPE_LOG) {
141
+ log.__push(event.data.msg);
142
+ }
143
+
144
+ }
145
+ }
146
+ } else {
147
+ return function (event) {
148
+ if (isFwMessage(event.data)) {
149
+ event.stopImmediatePropagation();
150
+ }
151
+ }
152
+ }
153
+ };
154
+
155
+ /**
156
+ * Spawn a framework-aware Web Worker from an inline function.
157
+ *
158
+ * The worker is built as follows:
159
+ * 1. An optional logger bootstrap is prepended (`ENV.LOG` only).
160
+ * 2. A new `ModuleRuntime` instance is created inside the worker.
161
+ * 3. All serialised modules are registered on it.
162
+ * 4. `workerFw` is called to build `runtime.context`.
163
+ * 5. `workerFn` is called with `runtime.context`.
164
+ *
165
+ * The Blob URL is revoked and `options.terminate` is called when
166
+ * `worker.terminate()` is invoked. Subsequent calls to the patched
167
+ * `terminate` are no-ops.
168
+ *
169
+ * @param {Function} workerFn - Entry-point function executed inside
170
+ * the worker. Receives `runtime.context` as its sole argument.
171
+ * Its source is stringified, so it must be self-contained (no closures
172
+ * over main-thread variables).
173
+ * @param {WorkerOptions} [options={}] - Worker configuration options.
174
+ * @throws {Error} When `new Worker(blobUrl)` fails (re-throws after revoking
175
+ * the Blob URL to prevent leaks).
176
+ * @returns {Worker} The live `Worker` instance with a patched `terminate`
177
+ * method that performs cleanup before calling the native terminate.
178
+ */
179
+ return function workerRuntime(workerFn, options = {}) {
180
+ const safeOptions = (options && typeof options === 'object') ? options : {};
181
+ const normalizedOptions = {
182
+ dependencies: Array.isArray(safeOptions.dependencies) ? safeOptions.dependencies : DEFAULT_WORKER_MODULES,
183
+ workerFw: typeof safeOptions.workerFw === 'function' ? safeOptions.workerFw : DEFAULT_WORKER_FRAMEWORK,
184
+ args: Array.isArray(safeOptions.args) ? safeOptions.args : [],
185
+ terminate: typeof safeOptions.terminate === 'function' ? safeOptions.terminate : function(){},
186
+ };
187
+
188
+ const serialized = runtime.serialize(normalizedOptions.dependencies);
189
+ const argsRaw = JSON.stringify(normalizedOptions.args);
190
+ const logger = ENV.LOG ? `(${logFn})(${ENV.DEV.toString()}, self);` : ``;
191
+
192
+ // Specs exposed to workerFw: use the user's **original** specs
193
+ // (`normalizedOptions.dependencies`) rather than `serialized.list`,
194
+ // which contains the canonical names of the ENTIRE graph (entry + transitives).
195
+ // This aligns worker behaviour with the main thread:
196
+ // `resolveAll(['hex'])` → `{ hex: <hex> }` (not `{ 'hex@0.0.0': ... }`).
197
+ // `serialized.content` remains the source of modules to register (full
198
+ // graph, including transitive dependencies) so that resolution
199
+ // on the worker side works correctly.
200
+ const exposedSpecsLiteral = JSON.stringify(normalizedOptions.dependencies);
201
+
202
+ const code = logger + `
203
+ ${runtimeSource}
204
+
205
+ const runtime = new ModuleRuntime();
206
+
207
+ ${serialized.content}.forEach(m => {
208
+ runtime.register(m);
209
+ });
210
+
211
+ runtime.context = (${normalizedOptions.workerFw.toString()})(runtime, ${exposedSpecsLiteral}, ${argsRaw});
212
+
213
+ (${workerFn.toString()})( runtime.context );
214
+ `;
215
+
216
+ const blobUrl = URL.createObjectURL(new Blob([code], {type: 'text/javascript'}));
217
+ let worker;
218
+ try {
219
+ worker = new Worker(blobUrl);
220
+ } catch (err) {
221
+ URL.revokeObjectURL(blobUrl);
222
+ throw err;
223
+ }
224
+
225
+ const messageHandler = messageHandlerBuilder();
226
+ worker.addEventListener('message', messageHandler);
227
+
228
+ const terminateBase = worker.terminate.bind(worker);
229
+ let isTerminated = false;
230
+
231
+ /**
232
+ * Release all resources associated with this worker instance:
233
+ * removes the `message` handler, revokes the Blob URL, and calls
234
+ * `options.terminate`. Idempotent - returns `false` on subsequent calls.
235
+ *
236
+ * @returns {boolean} `true` on the first (effective) cleanup; `false`
237
+ * when the worker was already terminated.
238
+ */
239
+ const cleanup = function () {
240
+ if (isTerminated) {
241
+ return false;
242
+ }
243
+ isTerminated = true;
244
+ worker.removeEventListener('message', messageHandler);
245
+ URL.revokeObjectURL(blobUrl);
246
+ normalizedOptions.terminate();
247
+ return true;
248
+ };
249
+
250
+ /**
251
+ * Patched `terminate`: runs {@link cleanup} then delegates to the native
252
+ * `Worker.terminate`.
253
+ */
254
+ worker.terminate = function () {
255
+ cleanup();
256
+ terminateBase();
257
+ };
258
+
259
+ return worker;
260
+ };
261
+ }
@@ -0,0 +1,249 @@
1
+ # NIST conformance — `fw/core/crypto` module
2
+
3
+ State as of the current commit. Test vectors are executed on every
4
+ build via `bun test src/crypto/` (**3 853 tests + 7 skip
5
+ gated `CRYPTO_FULL`**, 0 failures, 41 files; ~180 s).
6
+
7
+
8
+ ## Legend
9
+
10
+ - ✅ — implemented + official vectors validated
11
+ - ⚠️ — implemented but outside NIST scope (defense in depth)
12
+ - ❌ — not implemented in this module
13
+
14
+ ---
15
+
16
+ ## FIPS — validated primitives
17
+
18
+ | Standard | Algorithm | Module | Status | Vectors |
19
+ |---|---|---|---|---|
20
+ | FIPS 197 | AES-128/192/256 | [aes.js](cipher/aes.js) | ✅ | FIPS-197 App. B/C + **ACVP-AES-ECB-1.0** (254 AFT/2138 sub-sample, 6 MCT chains × 100 outer × 1000 inner — iter0 + iter99 byte-exact); **`api.fn` constant-time by default** (masked-lookup S-box anti-cache-timing); fast T-table opt-in via `api.ttable.fn`; `api.bitsliced.fn` deprecated alias of `api.fn` — see [aes.acvp.md](cipher/aes.acvp.md) |
21
+ | FIPS 180-4 | SHA-224 | [sha224.js](hash/sha224.js) | ✅ | FIPS-180 + **ACVP-SHA2-224-1.0** (24 AFT/512 incl. bit-level non-byte-aligned + 1 MCT standard × 100 outer × 1000 inner byte-exact) — see [sha224.acvp.md](hash/sha224.acvp.md) |
22
+ | FIPS 180-4 | SHA-256 | [sha256.js](hash/sha256.js) | ✅ | FIPS-180 App. B 1-3 (incl. 1M×"a") + **ACVP-SHA2-256-1.0** (67 AFT/512 sub-sample over lengths 1720..12144 bits + 1 MCT alternate × 100 outer × 1000 inner byte-exact) — see [sha256.acvp.md](hash/sha256.acvp.md) |
23
+ | FIPS 180-4 | SHA-384 | [sha384.js](hash/sha384.js) | ✅ | FIPS-180 + **ACVP-SHA2-384-1.0** (24 AFT/1024 incl. bit-level + 1 MCT standard × 100 outer × 1000 inner byte-exact) — see [sha384.acvp.md](hash/sha384.acvp.md) |
24
+ | FIPS 180-4 | SHA-512 | [sha512.js](hash/sha512.js) | ✅ | FIPS-180 + **ACVP-SHA2-512-1.0** (67 AFT/1024 + 1 MCT alternate × 100 outer × 1000 inner byte-exact); iteration A2 exposes `_internal.makeSha(init, outWords)` builder for the truncated variants — see [sha512.acvp.md](hash/sha512.acvp.md) |
25
+ | FIPS 180-4 §5.3.6.1 | SHA-512/224 | [sha512_224.js](hash/sha512_224.js) | ✅ | **ACVP-SHA2-512-224-1.0** (74/146 byte-aligned AFT sub-sample + 1 MCT standard × 100 outer × 1000 inner byte-exact); IV derived by independent computation (FIPS §5.3.6); HMAC-compatible — see [sha512_224.acvp.md](hash/sha512_224.acvp.md) |
26
+ | FIPS 180-4 §5.3.6.2 | SHA-512/256 | [sha512_256.js](hash/sha512_256.js) | ✅ | **ACVP-SHA2-512-256-1.0** (53/1024 byte-aligned AFT sub-sample + 1 MCT alternate × 100 outer × 1000 inner byte-exact); IV derived then cross-checked against OpenSSL (the widely circulated incorrect IV `c84d6b74` corrected to `c84c64c2`); HMAC-compatible — see [sha512_256.acvp.md](hash/sha512_256.acvp.md) |
27
+ | FIPS 202 | SHA3-224/256/384/512 | [sha3.js](hash/sha3.js) | ✅ | FIPS 202 + NIST KAT 200×0xa3 + **ACVP-SHA3-{224,256,384,512}-2.0** (AFT byte-aligned sub-sample 15+16+13+13 + 4 MCT standard × 100 outer × 1000 inner — SHA3-256 100/100 byte-exact, others iter0+iter99) — see [sha3.acvp.md](hash/sha3.acvp.md) |
28
+ | FIPS 202 | SHAKE128 / SHAKE256 | [sha3.js](hash/sha3.js) | ✅ | NIST CAVP + **ACVP-SHAKE-{128,256}-FIPS202** (AFT byte-aligned in/out 29 + 6, outLen variable, multi-block squeeze validated) — see [sha3.acvp.md](hash/sha3.acvp.md) |
29
+ | FIPS 198-1 | HMAC-SHA-2 + HMAC-SHA-3 + HMAC-SHA-512/{224,256} | [hmac.js](hash/hmac.js) | ✅ | RFC 4231 + **ACVP-HMAC-SHA2-{224,256,384,512}-2.0** (4 × 35 AFT/150) + **ACVP-HMAC-SHA3-{224,256,384,512}-2.0** (4 × 31 AFT/150, **iteration B1**) + **ACVP-HMAC-SHA2-512-{224,256}-2.0** (2 × 31 AFT/150, **iteration B2**) — see [hmac.acvp.md](hash/hmac.acvp.md) |
30
+ | FIPS 186-5 §6 | ECDSA (P-{224,256,384,521} + K-curves) | [ecc.js](pkc/ecc.js) | ✅ | round-trip + CAVP P-256/SHA-256 SigVer; **deterministic k RFC 6979** by default + **ACVP**: KeyGen-FIPS186-5 (24/72 validator `Q==d·G`), **KeyVer-FIPS186-5 (12/12 full §A.4.2 validation, C1)**, SigVer-FIPS186-5 (8 sub-samples), **DetECDSA-SigGen-FIPS186-5 (16 byte-exact RFC 6979 over 4 NIST pairs incl. P-521+SHA-512, C2)**; **strict mode `verify({strict:true})` + low-s canonicalization `sign({strict:true})` + RFC 6979 hash-decoupling `sign({hashForK})` (C3)** — see [ecc.acvp.md](pkc/ecc.acvp.md) |
31
+ | FIPS 186-5 §A.1.3 | RSA keygen (probable primes) | [rsaKeygen.js](utils/rsaKeygen.js) | ✅ | sieve < 2000 + Miller-Rabin (k=5 at 1024 bits, Table B.1), top-2 bits forced, `\|p−q\| > 2^(nlen/2−100)`, `d > 2^(nlen/2)`, CRT output (dp, dq, qInv); round-trip OAEP-SHA-256 on a 2048-bit key + **RSA-KeyGen-FIPS186-5** (15/15 validator-style vectors: MR on p,q, byte-exact dmp1/dmq1/iqmp via `_inverseModAny(e, lcm(p−1,q−1))` over 3 nlen × 5 ACVP methods); `provable`/auxiliary methods not implemented (P3) — see [rsaKeygen.acvp.md](utils/rsaKeygen.acvp.md) |
32
+ | FIPS 203 | ML-KEM-512/768/1024 | [ml_kem.js](pkc/ml_kem.js) | ✅ | KAT Wycheproof (keygen + encaps byte-exact) + round-trip 512/768/1024 + implicit reject + **ACVP**: ML-KEM-keyGen-FIPS203 (9/75 sub-samples first/mid/last × 3 paramSets), ML-KEM-encapDecap-FIPS203 (9 encap + 9 decap sub-samples + 30/30 decapKeyCheck §7.3 hash-consistency + 30/30 encapKeyCheck §7.2 modulus-q) — see [ml_kem.acvp.md](pkc/ml_kem.acvp.md) |
33
+ | FIPS 204 | ML-DSA-44/65/87 | [ml_dsa.js](pkc/ml_dsa.js) | ✅ | Wycheproof KAT byte-exact (keygen ML-DSA-65 + sign deterministic + verify) + **ACVP**: ML-DSA-keyGen-FIPS204 (9/75 sub-samples × 3 paramSets), ML-DSA-sigGen-FIPS204 external+pure (18 byte-exact), ML-DSA-sigVer-FIPS204 external+pure (45/45 mix valid/invalid) + **HashML-DSA iteration E3**: `signPh/verifyPh` 12 hashAlg supported (9 SigGen + 45 SigVer ACVP byte-exact) + **internal interface** (`_internal.signInternal/verifyInternal` 9 ACVP) + **externalMu** (`_internal.signWithMu/verifyWithMu` 9 ACVP) — see [ml_dsa.acvp.md](pkc/ml_dsa.acvp.md) |
34
+ | FIPS 205 | SLH-DSA-{SHAKE,SHA2}-{128,192,256}{f,s} | [slh_dsa.js](pkc/slh_dsa.js) | ✅ | 12 variants byte-exact against @noble/post-quantum 0.6.1 — §11.1 (SHAKE) + §11.2 (SHA-2); **ACVP**: SLH-DSA-keyGen-FIPS205 (36/120), SLH-DSA-sigGen-FIPS205 external+pure 128f (2 byte-exact), SLH-DSA-sigVer-FIPS205 external+pure 'f' variants (15/84) + **HashSLH-DSA iteration E4**: `signPh/verifyPh` 12 hashAlg supported (2 SigGen + 12 SigVer ACVP byte-exact over 'f' variants) + **internal interface** (`_internal.signInternal/verifyInternal` 2 SigGen + 12 SigVer ACVP); externalMu not applicable to SLH-DSA (no intermediate mu in FIPS 205 §6) — see [slh_dsa.acvp.md](pkc/slh_dsa.acvp.md) |
35
+
36
+ ## NIST SP — modes & derivation
37
+
38
+ | Standard | Algorithm | Module | Status | Vectors |
39
+ |---|---|---|---|---|
40
+ | SP 800-38A | AES-CTR | [ctr.js](mode/ctr.js) | ✅ | F.5.1 + **ACVP-AES-CTR-1.0** (78 AFT/150 sub-sample: 3 testGroups encrypt + 3 decrypt × AES-128/192/256, payloadLen 1..1920 bits incl. non-byte/non-block-aligned via `bitArray.clamp`) — see [ctr.acvp.md](mode/ctr.acvp.md) |
41
+ | SP 800-38A | AES-CBC | [cbc.js](mode/cbc.js) | ✅ | RFC 3602 §4 (1-4) + **ACVP-AES-CBC-1.0** (144 AFT/2156 sub-sample: 12 testGroups encrypt + 12 decrypt × AES-128/192/256, multi-block tgId 25-30 full 10×ptLen) + **MCT 6/6 byte-exact** (FIPS 140-2 Annex C: tgId 37-42 × 100 outer × 1000 inner with ACVP-spec key/IV/PT transitions, **iteration D4**) — see [cbc.acvp.md](mode/cbc.acvp.md) |
42
+ | SP 800-38B | AES-CMAC | [cmac.js](mode/cmac.js) | ✅ | RFC 4493 §4 + **CMAC-AES-1.0** (81 gen + 108 ver / 756 sub-sample: AES-128/192/256 × msgLen ∈ {0, 4256, 65536} × macLen ∈ {64, 88, 128}); **iteration D3**: TDES rejection (`blockSize !== 16` → DEPRECATED warning per SP 800-131A §2.4) + `truncatedMac/Verify` API that enforces `tagLen ∈ [32, 128]` (SP 800-38B §6.4) — see [cmac.acvp.md](mode/cmac.acvp.md) |
43
+ | SP 800-38D | AES-GCM (128/192/256) | [gcm.js](mode/gcm.js) | ✅ | McGrew-Viega §B **TC 1-18 complete** (TC 1-6 AES-128, TC 7-12 AES-192 [D1], TC 13-18 AES-256 [TC 13/14 baseline + TC 15-18 D1] cross-checked against Node libcrypto) + **ACVP-AES-GCM-1.0** (60/60 AFT 100% AES-128); all 3 keyLen × {empty, AAD, multi-block, 96/64/480-bit IV} byte-exact — see [gcm.acvp.md](mode/gcm.acvp.md) |
44
+ | SP 800-38D | GMAC | [gcm.js](mode/gcm.js#L212) | ✅ | round-trip vs GCM + **ACVP-AES-GMAC-1.0** (60/60 AFT 100%: AES-128 × ivLen ∈ {96, 120} × aadLen ∈ {0, 120} × tagLen ∈ {32, 128}; decrypt includes 7 `testPassed=false` cases) — see [gcm.acvp.md](mode/gcm.acvp.md) |
45
+ | SP 800-38F | KW (RFC 3394) | [kw.js](mode/kw.js) | ✅ | RFC 3394 §4.1-4.6 + **ACVP-AES-KW-1.0** (108/3600 cipher-direction sub-sample: AES-128/192/256 × 6 payloadLen); **iteration D2**: `wrapInverseCipher`/`unwrapInverseCipher` explicit reject (NOT-IMPLEMENTED, SP 800-38F §6.3) + TDES rejection (`blockSize !== 16` → DEPRECATED warning per SP 800-131A §2.4) — see [kw.acvp.md](mode/kw.acvp.md) |
46
+ | SP 800-38F | KWP (RFC 5649) | [kw.js](mode/kw.js) | ✅ | RFC 5649 §6 + **ACVP-AES-KWP-1.0** (108/3600 cipher-direction sub-sample 3/group: AES-128/192/256 × 6 payloadLen ∈ {8, 1280, 2152, 2176, 3040, 4096} bits; single-semi-block fast path via payloadLen=8; decrypt includes 10 `testPassed=false` cases rejected by the constant-time IV+length+padding check) — see [kw.acvp.md](mode/kw.acvp.md) |
47
+ | SP 800-132 | PBKDF2 (10 PRF families) | [pbkdf2.js](hash/pbkdf2.js) | ✅ | RFC 7914 (HMAC-SHA-256) + **PBKDF-1.0** (25/50 sub-sample: HMAC-SHA-224) + **B4 cross-check Python `hashlib`** (9 families × 5 vectors = 45 vectors: SHA-2-{256,384,512}, SHA-512/{224,256}, SHA-3-{224,256,384,512}); **default count = 600 000** (OWASP 2023), warn if < 100 000 — see [pbkdf2.acvp.md](hash/pbkdf2.acvp.md) |
48
+ | SP 800-56C Rev. 2 | HKDF (RFC 5869) | [hkdf.js](hash/hkdf.js) | ✅ | RFC 5869 App. A.1-A.3 + **KDA-HKDF-Sp800-56Cr1** (240 SHA-2 + 180 SHA-3/SHA-512-truncated **B3**) + **KDA-HKDF-Sp800-56Cr2 hybrid single** (40 vectors `IKM=Z‖T` **B3**) + **KDA-HKDF-Sp800-56Cr2 hybrid multi-expansion** (20 vectors / 56 expand iterations **B3**); **10 HMAC families** validated byte-exact — see [hkdf.acvp.md](hash/hkdf.acvp.md) |
49
+ | SP 800-90A | CTR_DRBG-AES-256 (no df) | [random.js](utils/random.js) | ✅ | strict §10.2 implementation + **KAT power-on** (NIST CAVP `drbgvectors_pr_false` COUNT=0) + **ctrDRBG-1.0** (30/240 sub-sample 100% of the supported variant: tg7 predRes=True + tg15 predRes=False, AES-256 no-df, returnedBitsLen=4096 bits, instantiate→{reSeed\|generate ± predRes-reseed} sequence byte-exact); auto-reseed at 2^32 < 2^48; AES-128/192, TDES, derFunc=true not implemented (P3) — see [random.acvp.md](utils/random.acvp.md) |
50
+ | SP 800-90B | RCT + APT (continuous health tests) | [random.js](utils/random.js) | ✅ | RCT (C=4, α=2^-20, H=8) §4.4.1 + APT (W=512, C=13) §4.4.2; state persisted across calls; "dead source" latch §4.5; applied to every buffer drawn from `crypto.getRandomValues` |
51
+ | SP 800-90C | RBG construction | [random.js](utils/random.js) | ⚠️ | entropy source = `crypto.getRandomValues` (validated OS NRBG); CTR_DRBG df not implemented (no-df only — full-entropy source assumed); KAT power-on against the official NIST CAVP vector (see SP 800-90A row) — FIPS 140-3 validation remains the responsibility of a CMVP lab |
52
+
53
+ ## Complementary RFCs (interop / outside NIST)
54
+
55
+ | Standard | Algorithm | Module | Status | Vectors |
56
+ |---|---|---|---|---|
57
+ | RFC 7748 | X25519 | [x25519.js](pkc/x25519.js) | ⚠️ | RFC 7748 §5.2 (test vectors 1+2 + iterative 1/1000 + 1M under CRYPTO_FULL) + §5 clamping/MSB-mask + §6.1 ECDH + low-order u (u=0/1/p-1 → 0) + DH symmetry stress — see [x25519.acvp.md](pkc/x25519.acvp.md) |
58
+ | FIPS 186-5 §7 + RFC 8032 | Ed25519 (PureEdDSA + ph + ctx) | [ed25519.js](pkc/ed25519.js) | ✅ | RFC 8032 §7.1 (1-3) + **ACVP** EDDSA-{KeyGen, KeyVer, SigGen, SigVer}-1.0 pure (3+4+3+5) + **preHash iteration E1** (SigGen 3 sub-samples ph + SigVer 5 ph) + **Ed25519ctx iteration E1** (`signCtx/verifyCtx` round-trip + dom2 binding tests) + **Ed448 explicit reject iteration E2** (`ed25519.ed448.{keyPair,sign,verify,signPh,verifyPh}` returns false + warn NOT-IMPLEMENTED, 6 stubs tested); native Ed448 implementation not implemented (edwards448 curve + SHAKE-256, create a separate ed448.js if required) — see [ed25519.acvp.md](pkc/ed25519.acvp.md) |
59
+ | FIPS 186-5 §5.4 + SP 800-56B §6.4 + RFC 8017 | RSA-OAEP / RSA-PSS / RSADP | [rsa.js](pkc/rsa.js) | ✅ | RFC 8017 Ex. 1 + **RSA-DecryptionPrimitive-Sp800-56Br2** (90/90: 3 modulo × 2 keyMode; 66 byte-exact `pt` + 24 domain-check) + **RSA-SigVer-FIPS186-4** (36/72 PSS-SHA224 sub-sample); **CRT** auto-enabled; OAEP decrypt constant-time (anti-Manger) + **RSA blinding Chaum/Pollard iteration F1** (anti-timing, enabled by default on `_rsadp`; `c → c · r^e mod n` then `m → m · r^-1`; covers Boneh-Brumley 2003; opt-out via `_internal.rsadp(p, c, {blinding:false})`); PKCS#1 v1.5 and PSS-SHA3/SHAKE not implemented (P3) — see [rsa.acvp.md](pkc/rsa.acvp.md) |
60
+ | RFC 5915 | EC private key (PKCS#8 / SEC1) | [keyformat.js](utils/keyformat.js) | ⚠️ | round-trip P-256/384/521 |
61
+ | RFC 8410 | Ed25519/X25519 PKCS#8 + SPKI | [keyformat.js](utils/keyformat.js) | ⚠️ | RFC 8410 §10.1/§10.3 |
62
+ | RFC 8439 | ChaCha20 | [chacha20.js](cipher/chacha20.js) | ⚠️ | RFC 8439 §2.3.2 + §2.4.2 + §A.1 (5 KAT block) + §A.2 (3 KAT encrypt) + multi-block/concat + 513-byte involution — see [chacha20.acvp.md](cipher/chacha20.acvp.md) |
63
+ | RFC 8439 | Poly1305 | [poly1305.js](hash/poly1305.js) | ⚠️ | RFC 8439 §2.5.2 + §A.3 (11/11 vectors: single/multi-block carry + crossing 2¹³⁰ + degenerate r=0/s=0) + verify CT (16 XOR mutations rejected) + edge cases (empty/1-byte/16-byte boundary) — see [poly1305.acvp.md](hash/poly1305.acvp.md) |
64
+ | RFC 8439 | ChaCha20-Poly1305 AEAD | [chacha20poly1305.js](mode/chacha20poly1305.js) | ⚠️ | RFC 8439 §2.6.2 (polyKey derivation) + §2.8.2 (AEAD encrypt+decrypt KAT) + §A.5 (decrypt fixture) + exhaustive tampering (ct/tag/aad per-byte + nonce + length-encoding) + counter binding (counter=0 polyKey vs counter=1 keystream) — see [chacha20poly1305.acvp.md](mode/chacha20poly1305.acvp.md) |
65
+ | RFC 7693 | BLAKE2b | [blake2b.js](hash/blake2b.js) | ⚠️ | RFC 7693 §A ("abc") + empty 256/512 + **§E official self-test** (48 sub-tests: 4 outLens × 6 inLens × keyed/unkeyed → final hash byte-exact `c23a7800...7bccd475`) + length binding (256 ≠ truncate 512) + salt/person domain separation + streaming at 3 granularities + digest idempotence — see [blake2b.acvp.md](hash/blake2b.acvp.md) |
66
+ | RFC 9106 | Argon2id | [argon2.js](hash/argon2.js) | ✅ | RFC 9106 §5.3 byte-exact (t=3, m=32, p=4, full P/S/K/X) + 8 bindings (P/S/K/X/t/m/p/τ each changes the tag) + parametric τ no-truncation + memory clamp 8·p + `_Hp` multi-block (outLen 100/200/1024) + 6 negative validations; Argon2d/Argon2i out of scope (P3, RFC §4 mandates Argon2id) — see [argon2.acvp.md](hash/argon2.acvp.md) |
67
+ | X.690 | ASN.1 DER | [asn1.js](utils/asn1.js) | ⚠️ | round-trip |
68
+ | RFC 7468 | PEM | [pem.js](utils/pem.js) | ⚠️ | round-trip |
69
+ | RFC 4122 + RFC 9562 | UUID v1 (time-based) + v4 (random) | [uuid.js](utils/uuid.js) | ⚠️ | RFC 9562 §A.4-style byte-exact (deterministic prng) + bit-mask version + variant + canonical format with dashes (`format='rfc4122'`) + cross-check 100 samples vs `valid.js:uuid` regex; v3/v5/v6/v7/v8 not implemented (P3) — see [uuid.acvp.md](utils/uuid.acvp.md) |
70
+ | KeePass v1 / KDBX 3.x | AES-DF | [adf.js](hash/adf.js) | ⚠️ | Format-spec interop (neither RFC nor NIST) — exhaustive bindings (M/T/C/R) + channel independence (T-only ≠ tail vs M-only = tail) + rounds=0 semantics + invariant `fn = SHA256 ∘ partial` + 3 byte-exact regression KAT (algorithmic canary); underlying SHA-256 + AES-256-ECB primitives ACVP-validated — see [adf.acvp.md](hash/adf.acvp.md) |
71
+
72
+ ---
73
+
74
+ ## Operational vigilance points
75
+
76
+ 1. **Entropy source** — `random.js` exclusively uses `crypto.getRandomValues`.
77
+ `Math.random` and `crypto.randomUUID` are blocked by [sanity/base.js](../sanity/base.js).
78
+ 2. **Constant-time comparisons** — `bitArray.equal`, `cmac.verify`,
79
+ `gcm.decrypt`, `chacha20poly1305.decrypt`, `poly1305.verify`,
80
+ `ed25519.verify` (accumulated XOR), `hmac.verify`, `rsa.oaepDecrypt`
81
+ (separator scanned with no early-exit, anti-Manger), `kw.unwrapPad`
82
+ (accumulated IV/length/padding validation), `ml_kem.decapsulate`
83
+ (final Khat/Kbar selection via mask) — all security-critical
84
+ comparisons are short-circuit-free.
85
+ 3. **Authentication failure** — the AEAD modes (`gcm`, `chacha20poly1305`,
86
+ `kw`) **never** release the plaintext on an invalid tag:
87
+ they return `false` after `console.error('CORRUPT:')`.
88
+ 6. **GCM — nonce reuse** — reusing an IV for two distinct
89
+ encryptions under the same key is **catastrophic** (loss of
90
+ the GHASH authentication key + XOR leak of the plaintexts). The
91
+ `gcm.encrypt` API documents this risk and `gcm.nonceTracker(prf)` provides
92
+ an in-process safeguard (Set of seen IVs) refusing any duplicate.
93
+ 7. **ECDSA — deterministic k** — `ecdsa.sign` produces `k` via RFC 6979
94
+ (HMAC-DRBG) by default, eliminating any risk of key leakage through
95
+ reuse/bias of `k`. Random mode opt-in via
96
+ `sign(msg, { deterministic:false })`.
97
+ 8. **PBKDF2 — iterations** — default raised to 600 000 (OWASP 2023). Any
98
+ call with a `count` < 100 000 emits `WEAK:` to the console.
99
+ 4. **No exception thrown** — by convention, every cryptographic error
100
+ logs via `console.warn`/`console.error` then returns `false`.
101
+ 5. **Worker serialization** — every `factory()` is pure and
102
+ `factory.toString()` remains valid for transport to a Worker.
103
+
104
+ ---
105
+
106
+ ## Security by default (Iteration I2)
107
+
108
+ Module policy: **fail-closed** on every deprecated, unimplemented,
109
+ or intrinsically unsafe path. Rather than silently offering
110
+ obsolete primitives (which would end up being adopted by default),
111
+ the module **explicitly refuses** via `console.warn(...)` + `return false`.
112
+ Warnings are typed: `DEPRECATED`, `UNSAFE`, `NOT-IMPLEMENTED`,
113
+ `LIMIT-EXCEEDED`, `WEAK`, `CORRUPT`, `INVALID`, `BUG`.
114
+
115
+ ### Explicitly rejected algorithms (`return false` + typed warning)
116
+
117
+ | Family | Export | Type | Justification |
118
+ |---|---|---|---|
119
+ | RSA | `pkcs1v15Sign` / `pkcs1v15Verify` | `DEPRECATED` | SP 800-131A Rev.2 Table 5 (Nov. 2019) — deprecates v1.5 sign |
120
+ | RSA | `pkcs1v15Encrypt` / `pkcs1v15Decrypt` | `DEPRECATED|UNSAFE` | Bleichenbacher 2006 padding oracle |
121
+ | Argon2 | `hashD` (Argon2d) | `UNSAFE` | RFC 9106 §4 — vulnerable to cache-timing (data-dependent addressing) |
122
+ | Argon2 | `hashI` (Argon2i) | `DEPRECATED` | Alwen-Blocki 2016 — reduced GPU/ASIC resistance |
123
+ | ChaCha20 | `xchacha20()` | `NOT-IMPLEMENTED` | Draft-irtf-cfrg-xchacha not finalized; specialized use (libsodium) |
124
+ | KW | `wrapInverseCipher` / `unwrapInverseCipher` | `NOT-IMPLEMENTED` | SP 800-38F §6.3 inverse-cipher out of scope (rare TPM usage) |
125
+ | HMAC-SHA-1 | (not exposed) | — | SP 800-131A §5 — not implemented; factory does not expose `sha1` |
126
+ | MD-5 | (not exposed) | — | SP 800-131A §5 — not implemented |
127
+ | Ed448 | (not exposed) | — | out of scope — separate module required (SHAKE-256 + edwards448 curve); documented in `ed25519.acvp.md` |
128
+
129
+ ### Active runtime guards (malformed or out-of-spec inputs)
130
+
131
+ | Module | Guard | Type | Justification |
132
+ |---|---|---|---|
133
+ | `cipher/chacha20.js` | Counter overflow > 2³² blocks | `LIMIT-EXCEEDED` | RFC 8439 §2.3 — silent counter wrap would reuse the keystream |
134
+ | `pkc/ecc.js` | `_coordsInRange(bits, curve)` (x/y < p) | `INVALID` | FIPS 186-5 §A.4 — point outside the field of definition |
135
+ | `pkc/ecc.js` | `_isInSubgroup(point, curve)` | `INVALID` | FIPS 186-5 §A.4.2 / SP 800-56A §5.6.2.3.3 — public key outside the main subgroup |
136
+ | `mode/cmac.js` | `prf.blockSize !== 16` | `DEPRECATED` | SP 800-131A §2.4 — TDES deprecated, SP 800-38B §5.1 requires AES |
137
+ | `mode/kw.js` | `prf.blockSize !== 16` | `DEPRECATED` | SP 800-131A §2.4 + SP 800-38F §6.2 |
138
+ | `mode/cmac.js` | `tagLen < 32 bits` | `WEAK` | SP 800-38B §6.4 recommended minimum |
139
+ | `mode/gcm.js` | `gcm.nonceTracker(prf)` (opt-in) | `CORRUPT` | refuses in-process IV reuse (`Set` of seen nonces) |
140
+ | `mode/chacha20poly1305.js` | `nonceTracker(key)` (opt-in) | `CORRUPT` | same as GCM; Poly1305 does not cryptographically detect reuse |
141
+ | `pkc/x25519.js` | `isLowOrderPoint(u)` (opt-in helper) | — | RFC 7748 §6.1 — 7 documented LOPs, constant-time comparison |
142
+ | `pkc/rsa.js` | `_rsadp` blinding Chaum/Pollard (default true) | — | Boneh-Brumley 2003 anti-timing ; opt-out `_internal.rsadp(p, c, {blinding:false})` |
143
+ | `cipher/aes.js` | `fn(key)` constant-time **by default**; T-table opt-in via `ttable.fn(key)` | — | constant-time-by-default masked-lookup S-box, anti-cache-timing (Bernstein 2005); fast T-table reserved for trusted hosts |
144
+ | `hash/argon2.js` | salt < 8 bytes | `INVALID` | RFC 9106 §3.1 — salt minimum |
145
+ | `hash/pbkdf2.js` | `count < 100 000` | `WEAK` | OWASP 2023 |
146
+ | `utils/random.js` | RCT + APT continuous health-tests SP 800-90B | `CORRUPT` | latched-dead flag stops all generation if entropy is suspect |
147
+ | `mode/{kw,cmac,gcm}` | tag mismatch | `CORRUPT` | no plaintext release; AEAD authentication |
148
+
149
+ ### `CRYPTO_FULL` policy
150
+
151
+ The `process.env.CRYPTO_FULL === '1'` flag unlocks the high-cost
152
+ test vectors. Default suite < 200 s; `CRYPTO_FULL` suite ~5-10 min
153
+ depending on the machine.
154
+
155
+ | Module | Tests gated behind `CRYPTO_FULL=1` |
156
+ |---|---|
157
+ | `hash/sha224.test.js` | LDT 1 GiB (ACVP-SHA2-224-1.0 tcId=514) |
158
+ | `hash/sha256.test.js` | LDT 1 GiB (ACVP-SHA2-256-1.0 tcId=514) |
159
+ | `hash/sha384.test.js` | LDT 1 GiB (ACVP-SHA2-384-1.0 tcId=1026) |
160
+ | `hash/sha512.test.js` | LDT 1 GiB (ACVP-SHA2-512-1.0 tcId=1027) |
161
+ | `hash/sha512_224.test.js` | LDT 1 GiB (ACVP-SHA2-512-224-1.0 tcId=1028) — **gap-fix audit post-upgrade** |
162
+ | `hash/sha512_256.test.js` | LDT 1 GiB (ACVP-SHA2-512-256-1.0 tcId=1026) — **gap-fix audit post-upgrade** |
163
+ | `pkc/ml_kem.test.js` | Full ACVP: 75/75 keyGen + 165/165 encapDecap (~0.5 s) |
164
+ | `pkc/ml_dsa.test.js` | Full ACVP: 75/75 keyGen + 45/45 sigVer ext+pure + 90/90 sigGen ext+pure (~4 s) |
165
+ | `pkc/slh_dsa.test.js` | Full ACVP: 120/120 keyGen + 180 sigVer ext+pure full (~135 s) |
166
+ | `utils/random.test.js` | Full ACVP: 5 CTR_DRBG modes (AES-128/192/256 × df) full predRes=false (~100 ms) |
167
+ | `pkc/x25519.test.js` | RFC 7748 §5.2 1 000 000 iterations (~10 min, outside the current `CRYPTO_FULL` — prepared) |
168
+
169
+ **Deliberately not wired**:
170
+
171
+ *Special cases (prohibitive cost vs. value)*:
172
+ - **SLH-DSA sigGen full (624 vectors)** — signing costs minutes/op for the
173
+ `s` variants, estimated total in hours. Sub-sample E4 validates the path.
174
+ - **LDT SHA-2 ≥ 2 GiB** (tcId 515-517 and 384/512 equivalents) — extra
175
+ cost with no additional information vs 1 GiB (64-bit counter already validated).
176
+
177
+ *Frozen ACVP sub-samples (no "full" mode even under `CRYPTO_FULL`)* — the
178
+ sub-sampling strategy captures the systematic patterns of each ACVP
179
+ suite (anchors `min/max(len)` + representatives for each structural bucket
180
+ GFSbox/KeySbox/VarKey/VarTxt/etc.); extending to full would mostly add
181
+ non-pathological intermediate lengths/positions with no cryptographic
182
+ coverage gain:
183
+
184
+ - **`cipher/aes`**: 254/2138 AFT — full small groups (GFSbox/
185
+ KeySbox/VarKey/VarTxt 217 vectors) + 3 tcId [first/mid/last] over the
186
+ 12 large structural groups (37 vectors) + full variable-message
187
+ buckets (tg 25-30). Full cost ~10× × **2 paths**
188
+ (CT default `api.fn` + T-table `api.ttable.fn`) → ~3-5 min under CRYPTO_FULL.
189
+ - **`mode/cbc`**: 144/2156 AFT — 12 testGroups × 12 AFT [encrypt+decrypt]
190
+ + full multi-block buckets. MCT 6/6 already full. Full cost ~15×.
191
+ - **`mode/ctr`**: 78/150 AFT — 6 testGroups × 13 AFT [encrypt+decrypt],
192
+ non-byte/non-block-aligned payloadLen retained in full. Cost ~2×.
193
+ - **`mode/cmac`**: 189/756 — 3 keyLen × 9 macLen × 7 msgLen sub-sampled
194
+ via anchors. Full cost ~5×.
195
+ - **`mode/kw` + `mode/kwp`**: 108/3600 each (3% coverage) —
196
+ payloadLen sub-sample [first/mid/last]. Full cost ~33× each
197
+ (~5 min cumulative).
198
+ - **`mode/gcm`**: ACVP-AES-GCM-1.0 = 60/60 AFT **full** on AES-128 (already
199
+ wired); AES-192/256 covered via McGrew-Viega TC 7-18 byte-exact
200
+ (cross-checked against OpenSSL). No residual sub-sample to activate.
201
+ - **`hash/hmac`**: 35/150 AFT × 10 HMAC families (SHA-2 + SHA-3 +
202
+ SHA-512-truncated) = 350/1500. Structural sub-sample by
203
+ keyLen/msgLen/macLen. Full cost ~4× per family.
204
+ - **`hash/hkdf`**: Cr1 sub-sample over 10 HMAC families (240+180 vectors).
205
+ Cr2 hybrid single + multi-expansion **already full** (40 + 20). Full
206
+ Cr1 cost ~3× (same algorithms, other lengths).
207
+ - **`hash/pbkdf2`**: 25/50 SHA-224 ACVP (only published family) + 45
208
+ cross-check Python `hashlib` over 9 HMAC families. Cryptographic
209
+ coverage already broad via cross-check.
210
+ - **`hash/sha3`**: 110/600+ AFT per variant. MCT already **100/100
211
+ byte-exact full** (Iteration H2). Full AFT would only add intermediate
212
+ lengths.
213
+ - **`hash/sha2*` (224/256/384/512/512_224/512_256)**: 24-73 / 146-1024
214
+ AFT per variant (regular-stride sub-sample + min/max anchors). LDT
215
+ 1 GiB already gated behind CRYPTO_FULL. MCT 1/1 byte-exact (100×1000) already full.
216
+ - **`pkc/ecc`**: KeyVer 12/12 **full**; SigVer 8 sub-sample, DetECDSA
217
+ 16 (RFC 6979). Full SigVer = ~50×: covers other triplets
218
+ (curve, hash, msg) with no specific gain.
219
+ - **`pkc/rsa`**: RSA-DecryptionPrimitive 90/90 **full** + PSS-SigVer
220
+ 36/72 SHA-224 sub-sample. Full PSS-SigVer = ~2× over the same family.
221
+ - **`pkc/ed25519`**: EDDSA-{KeyGen 3, KeyVer 4, SigGen 3, SigVer 5} +
222
+ preHash {SigGen 3, SigVer 5} sub-samples per category (mix
223
+ valid/invalid). Full = ~3-5× per category.
224
+ - **`utils/rsaKeygen`**: 15/15 **full**.
225
+
226
+ Enabling full coverage of all this under `CRYPTO_FULL=1` is
227
+ technically feasible (follow the H3 PQC pattern: synchronous `readFileSync`
228
+ of the ACVP JSON) but would not yield any new cryptographic
229
+ discovery for an estimated CI cost of +10-20 min.
230
+
231
+ ### Typed warning index
232
+
233
+ The warning types emitted by the module follow a strict convention
234
+ (grep-friendly for audit / CI logs):
235
+
236
+ - `DEPRECATED` — algorithm deprecated by NIST/IETF, to be replaced.
237
+ - `UNSAFE` — known vulnerability, do not use.
238
+ - `NOT-IMPLEMENTED` — deliberately unwired path (redirect to a
239
+ documented alternative).
240
+ - `LIMIT-EXCEEDED` — intrinsic limit reached (counter overflow,
241
+ message > 2⁶⁴ bits, etc.).
242
+ - `WEAK` — parameter below the recommended minimum (tagLen < 32,
243
+ PBKDF2 iter < 100k, etc.).
244
+ - `INVALID` — malformed input (size, structure, range).
245
+ - `CORRUPT` — runtime tampering detection (tag mismatch, RCT
246
+ fail, nonce reuse).
247
+ - `BUG` — internal inconsistency (should not happen, signals an
248
+ invocation bug).
249
+ - `NOT READY` — expected state not initialized (DRBG not instantiated).
@@ -0,0 +1,74 @@
1
+ # `aes.js` — ACVP / NIST conformance
2
+
3
+ ## Standards
4
+
5
+ - **Primary**: **FIPS 197** — *Advanced Encryption Standard (AES)*, §5.1 (encryption), §5.3 (decryption), §5.2 (key expansion).
6
+ - **Secondary**: ACVP — *Automated Cryptographic Validation Protocol*, draft-celi-acvp-symmetric.
7
+ - **ACVP draft**: `references/NIST/ACVP/src/draft-celi-acvp-symmetric.adoc`
8
+ - **Vectors**: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ACVP-AES-ECB-1.0/`
9
+
10
+ ## Implemented algorithm
11
+
12
+ Block cipher AES-128 / AES-192 / AES-256 (single-block primitive). API: `aes.factory().fn(key, full=true)` → `{encrypt(block), decrypt(block)?}`. **`api.fn` is the constant-time default** (masked-lookup S-box); the fast T-table path is **opt-in** via `api.ttable.fn`. `api.bitsliced.fn` is a deprecated alias of `api.fn`. The key is passed as 32-bit words (4 / 6 / 8 integers). `full=false` only computes the encryption schedule (memory savings for one-way modes such as CTR/GCM). Error (invalid `key size`/`block size`) → `false` + `console.warn`. S-box/MixCols tables are precomputed at factory time; `factory().toString()` remains Worker-serializable.
13
+
14
+ This module provides the **block primitive**; ECB, CBC, CTR, GCM, KW, etc. are implemented in `mode/`.
15
+
16
+ ## Test coverage
17
+
18
+ ### Integrated official vectors
19
+
20
+ > **All vectors below are executed 2× via `describe.each`** — once on the
21
+ > **constant-time default** path `api.fn` and once on the **T-table opt-in**
22
+ > path `api.ttable.fn`. Both produce byte-identical output
23
+ > (`api.bitsliced.fn` is a deprecated alias of `api.fn`).
24
+
25
+ | Source | Reference | Test (`describe` / `test`) | Property verified |
26
+ |---|---|---|---|
27
+ | FIPS 197 App. B | AES-128 single block (P=3243f6a8…, K=2b7e1516…, C=3925841d…) | `FIPS-197 Appendix B [$name]` | KAT byte-exact + round-trip (CT default + T-table) |
28
+ | FIPS 197 App. C | AES-192 (K=000102…1617, P=0011…eeff, C=dda97c…) | `FIPS-197 Appendix C — AES-192 [$name]` | KAT + round-trip (CT default + T-table) |
29
+ | FIPS 197 App. C | AES-256 (K=000102…1f, P=0011…eeff, C=8ea2b7…) | `FIPS-197 Appendix C — AES-256 [$name]` | KAT + round-trip (CT default + T-table) |
30
+ | ACVP-AES-ECB-1.0 | `expectedResults.json` tcId 1-2138 (sub-sample 254) | `ACVP-AES-ECB-1.0 / AFT vectors [$name]` | KAT byte-exact (encrypt + decrypt, AES-128/192/256, GFSbox/KeySbox/VarKey/VarTxt + variable-message buckets tg 25-30) **× 2 paths** |
31
+ | ACVP-AES-ECB-1.0 | `expectedResults.json` tcId 2139-2144 (6 MCT) | `ACVP-AES-ECB-1.0 / Monte Carlo Tests [$name]` | Monte Carlo loop AESAVS §6.4 (100 outer × 1000 inner block-ops) — byte-exact assertions on the key/pt/ct of **iter0** and **iter99** for the 6 chains (enc/dec × 128/192/256) **× 2 paths** |
32
+
33
+ #### AFT sub-sampling strategy (see audit plan, *Risks & safeguards*)
34
+
35
+ The ACVP AES-ECB suite enumerates 36 testGroups (24 structural AFT + 6 PT-variable + 6 MCT) for a total of 2138 AFT + 6 MCT. Strategy:
36
+
37
+ - **Small groups (≤ 24 tests)**: covered in full — tg 1, 2, 5, 6, 9, 10, 13, 14, 17, 18, 21, 22, 25-30 (217 vectors).
38
+ - **Large groups (128-256 tests)**: 3 representative tcId (first / middle / last) — tg 3, 4, 7, 8, 11, 12, 15, 16, 19, 20, 23, 24 (37 vectors). These groups enumerate the systematic GFSbox / KeySbox / VarKey / VarTxt patterns (one bit position per tcId); the three tcId capture the extremes and the middle of each enumeration.
39
+ - Total integrated: **254 AFT + 6 MCT** out of 2144 available, **executed 2× via `describe.each` on the constant-time default path (`api.fn`) and the T-table opt-in path (`api.ttable.fn`)** — i.e. 542 conformance tests (+ 2 `api.bitsliced.fn` alias tests = 544 total). The `CRYPTO_FULL=1` mode is not wired for this module; suite ~22 s (mostly spent on the constant-time MCT × 6 chains, the default path being ~50× slower by design).
40
+
41
+ ### Security properties tested
42
+
43
+ - [x] **Correct key schedule** — all 128/192/256 sizes validated against AESAVS KeySbox + VarKey.
44
+ - [x] **Round transformation** — SubBytes / ShiftRows / MixColumns / AddRoundKey are implicitly validated via the systematic GFSbox vectors (PT/CT bit-position).
45
+ - [x] **Inverse cipher** — InvSubBytes / InvShiftRows / InvMixColumns validated by the entire decrypt half (tg 13-24, 28-30, 34-36).
46
+ - [x] **Long-chain stability** — MCT guarantees no arithmetic degradation appears over 100,000 consecutive ops per chain (× 6 chains).
47
+ - [x] **Edge cases** — invalid key (3 words), invalid block (3 words) → `false` + `console.warn`.
48
+ - [x] **`full=false`**: `decrypt` not exposed.
49
+ - [x] **Side-channel resistance (timing)** — **the default path `api.fn` is now constant-time**: SubBytes via masked-lookup S-box (256 uniform reads per byte, branchless mask `((diff-1)>>>8) & 1`), MixColumns via branchless `xtime`; the memory access pattern is independent of the key/state (neutralizes Bernstein 2005). The fast T-table path (vulnerable to cache-timing) is **opt-in** via `api.ttable.fn`. `api.bitsliced.fn` is a **deprecated alias** of `api.fn`. Implementation: ~22 LOC `api.fn` (key schedule straight from FIPS 197 §5.2 with no pre-processed `decKey`; `_cryptCT` derives `Nr` from `keys[0]`). **Validated across the whole set of FIPS-197 App. B/C + ACVP-AES-ECB-1.0 vectors (254 AFT + 6 MCT × 100×1000) byte-exact** via `describe.each` factoring over the 2 paths (CT default + T-table). Cost of the default ~50-100× the T-table path — that's the price of security-by-default; opt into `api.ttable.fn` on a trusted, non-shared host. Byte-exact cross-consistency of `api.fn` vs `api.ttable.fn` on FIPS-197 KAT (AES-128/192/256) + 16 random blocks. **WebCrypto delegate** not wired: `globalThis.crypto.subtle` is asynchronous and does not expose a bare block primitive (only high-level AEAD `AES-GCM`/`AES-CTR`/`AES-CBC`) — the `mode/{cbc,ctr,gcm}.js` modes could eventually delegate directly to WebCrypto, out of scope for `cipher/aes.js`.
50
+
51
+ ## FIPS 140-3 conformance
52
+
53
+ | Requirement | Status | Evidence |
54
+ |---|---|---|
55
+ | Approved algorithm | ✅ | FIPS 197 + ACVP-AES-ECB-1.0 |
56
+ | Validated key sizes | ✅ | 128 / 192 / 256 — all covered by AFT + MCT |
57
+ | KAT power-on / self-test | ✅ | FIPS-197 App. B/C vectors executed on every `bun test`; no dedicated `selfTest()` — module init is purely table precomputation (deterministic) |
58
+ | CT comparisons (if secret) | N/A | Low-level block module; CT comparisons are the responsibility of the modes (see `gcm.js`, `cmac.js`, `kw.js`) |
59
+ | No `throw` / timing leak | ✅ | No `throw` (reviewed OK); **default path `api.fn` is constant-time** (masked-lookup S-box). The opt-in T-table path `api.ttable.fn` remains non-constant-time with respect to cache (see limitation below) |
60
+
61
+ ## Known limitations
62
+
63
+ - **Cache-timing on the opt-in path `api.ttable.fn`**: classic T-table implementation (inherited from SJCL) — not safe against an attacker able to observe cache access patterns (co-tenant, browser). **The default is now safe**: `api.fn` provides a constant-time path validated byte-exact on the same FIPS-197 + ACVP-AES-ECB-1.0 vectors. Choice left to the caller: security by default (constant-time `api.fn`) or performance on a trusted host (T-table `api.ttable.fn`, ~50-100× faster). `crypto.subtle` delegation remains out of scope for `cipher/aes.js` (asynchronous API, no bare block primitive exposed by WebCrypto).
64
+ - **MCT sub-sampling**: `iter0` and `iter99` validated byte-exact; the 98 intermediate iterations are not asserted byte-by-byte. Residual risk = a bug *specific to iterations 1-98* going undetected; judged negligible because (1) the chain is cumulative — a local bug would deviate `iter99`; (2) each outer iteration tests a different (key, pt) state.
65
+ - **No Crypto Officer test**: the ACVP does not expose Crypto Officer ECB tests either; the modes (CBC, GCM…) will carry them.
66
+
67
+ ## Cross-references
68
+
69
+ - Module: [`cipher/aes.js`](./aes.js)
70
+ - Tests: [`cipher/aes.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/cipher/aes.test.js) — **544 tests** (542 conformance tests via `describe.each` over 2 paths: CT default `api.fn` + T-table opt-in `api.ttable.fn`, same FIPS-197 + ACVP-AES-ECB-1.0 vectors byte-exact; + 2 `api.bitsliced.fn` alias tests)
71
+ - Uint8Array wrappers (outside `.acvp.md` scope): [`utils/aes_ctr.js`](../utils/aes_ctr.js), [`utils/aes_modes.js`](../utils/aes_modes.js) — cover ECB+CTR / multi-mode and will be validated via the `mode/*` iterations.
72
+ - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-symmetric.adoc`
73
+ - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ACVP-AES-ECB-1.0/`
74
+ - Overall conformance: [`NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)