@awacloud/fw 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (609) hide show
  1. package/CHANGELOG.md +125 -0
  2. package/NOTICE +8 -0
  3. package/README.md +163 -31
  4. package/dist/build/fw.core.pure.meta.json +6 -6
  5. package/dist/build/fw.core.pure.min.js +15 -12
  6. package/dist/build/fw.full.pure.meta.json +13 -7
  7. package/dist/build/fw.full.pure.min.js +45 -42
  8. package/dist/build/fw.minimal.pure.meta.json +6 -6
  9. package/dist/build/fw.minimal.pure.min.js +16 -13
  10. package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
  11. package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
  12. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
  13. package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
  14. package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
  15. package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
  16. package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
  17. package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
  18. package/dist/build/fw.pwa.pure.meta.json +7 -6
  19. package/dist/build/fw.pwa.pure.min.js +38 -35
  20. package/dist/build/fw.site-interactive.pure.meta.json +6 -6
  21. package/dist/build/fw.site-interactive.pure.min.js +37 -34
  22. package/dist/build/fw.site.pure.meta.json +6 -6
  23. package/dist/build/fw.site.pure.min.js +24 -21
  24. package/dist/build/fw.spa.pure.meta.json +8 -7
  25. package/dist/build/fw.spa.pure.min.js +41 -38
  26. package/dist/build/sanity-base-classic.min.js +1 -1
  27. package/dist/build/sanity.min.js +1 -1
  28. package/dist/types/core/internal.d.ts +29 -0
  29. package/dist/types/core/internal.d.ts.map +1 -0
  30. package/dist/types/core/logger.d.ts +23 -4
  31. package/dist/types/core/logger.d.ts.map +1 -1
  32. package/dist/types/core/modules.d.ts +374 -61
  33. package/dist/types/core/modules.d.ts.map +1 -1
  34. package/dist/types/core/runtime.d.ts +10 -6
  35. package/dist/types/core/runtime.d.ts.map +1 -1
  36. package/dist/types/core/worker-helper.d.ts +35 -0
  37. package/dist/types/core/worker-helper.d.ts.map +1 -1
  38. package/dist/types/crypto/cipher/aes.d.ts +1 -7
  39. package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
  40. package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
  41. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
  42. package/dist/types/crypto/hash/argon2.d.ts +0 -15
  43. package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
  44. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
  45. package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
  46. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
  47. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
  48. package/dist/types/crypto/hash/sha224.d.ts +1 -1
  49. package/dist/types/crypto/hash/sha256.d.ts +4 -13
  50. package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
  51. package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
  52. package/dist/types/crypto/hash/sha384.d.ts +1 -1
  53. package/dist/types/crypto/hash/sha512.d.ts +4 -13
  54. package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
  55. package/dist/types/crypto/mode/cmac.d.ts +0 -6
  56. package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
  57. package/dist/types/crypto/mode/ctr.d.ts +0 -6
  58. package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
  59. package/dist/types/crypto/mode/gcm.d.ts +0 -9
  60. package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
  61. package/dist/types/crypto/pkc/ecc.d.ts +0 -1
  62. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
  63. package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
  64. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
  65. package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
  66. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
  67. package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
  68. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
  69. package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
  70. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
  71. package/dist/types/crypto/pkc/rsa.d.ts +0 -24
  72. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
  73. package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
  74. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
  75. package/dist/types/crypto/pkc/x25519.d.ts +0 -6
  76. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
  77. package/dist/types/crypto/utils/bitArray.d.ts +0 -8
  78. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
  79. package/dist/types/crypto/utils/jws.d.ts +6 -14
  80. package/dist/types/crypto/utils/jws.d.ts.map +1 -1
  81. package/dist/types/crypto/utils/keyformat.d.ts +52 -0
  82. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
  83. package/dist/types/crypto/utils/random.d.ts +1 -10
  84. package/dist/types/crypto/utils/random.d.ts.map +1 -1
  85. package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
  86. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
  87. package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
  88. package/dist/types/crypto/utils/x509.d.ts +397 -0
  89. package/dist/types/crypto/utils/x509.d.ts.map +1 -0
  90. package/dist/types/crypto/wasm/argon2.d.ts +2 -1
  91. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
  92. package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
  93. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
  94. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
  95. package/dist/types/crypto/wasm/runtime.d.ts +13 -0
  96. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
  97. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
  98. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
  99. package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
  100. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
  101. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
  102. package/dist/types/dom/fs/fileIntake.d.ts +59 -0
  103. package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
  104. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
  105. package/dist/types/dom/query/dnd.d.ts.map +1 -1
  106. package/dist/types/dom/query/sound.d.ts +89 -0
  107. package/dist/types/dom/query/sound.d.ts.map +1 -0
  108. package/dist/types/dom/rendering/chart.d.ts.map +1 -1
  109. package/dist/types/dom/rendering/component.d.ts +9 -3
  110. package/dist/types/dom/rendering/component.d.ts.map +1 -1
  111. package/dist/types/dom/rendering/parser.d.ts +39 -0
  112. package/dist/types/dom/rendering/parser.d.ts.map +1 -1
  113. package/dist/types/dom/rendering/render.d.ts.map +1 -1
  114. package/dist/types/dom/rendering/sanitize.d.ts +4 -0
  115. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
  116. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
  117. package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
  118. package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
  119. package/dist/types/dom/rendering/template.d.ts +9 -3
  120. package/dist/types/dom/rendering/template.d.ts.map +1 -1
  121. package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
  122. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
  123. package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
  124. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
  125. package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
  126. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
  127. package/dist/types/dom/rendering/uiSession.d.ts +18 -6
  128. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
  129. package/dist/types/dom/sw/installPrompt.d.ts +89 -0
  130. package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
  131. package/dist/types/dom/sw/precache.d.ts +149 -0
  132. package/dist/types/dom/sw/precache.d.ts.map +1 -0
  133. package/dist/types/dom/sw/swUpdate.d.ts +129 -0
  134. package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
  135. package/dist/types/dom/utils/clipboard.d.ts +8 -0
  136. package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
  137. package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
  138. package/dist/types/dom/utils/route.d.ts.map +1 -1
  139. package/dist/types/dom/utils/ua.d.ts +2 -2
  140. package/dist/types/dom/utils/ua.d.ts.map +1 -1
  141. package/dist/types/io/calc/crc32.d.ts.map +1 -1
  142. package/dist/types/io/codec/b64.d.ts +24 -0
  143. package/dist/types/io/codec/b64.d.ts.map +1 -1
  144. package/dist/types/io/codec/cbor.d.ts +1 -0
  145. package/dist/types/io/codec/cbor.d.ts.map +1 -1
  146. package/dist/types/io/codec/hex.d.ts.map +1 -1
  147. package/dist/types/io/codec/msgpack.d.ts +1 -0
  148. package/dist/types/io/codec/msgpack.d.ts.map +1 -1
  149. package/dist/types/io/codec/url.d.ts +3 -1
  150. package/dist/types/io/codec/url.d.ts.map +1 -1
  151. package/dist/types/io/codec/utf8.d.ts.map +1 -1
  152. package/dist/types/io/compress/bitstream.d.ts +1 -1
  153. package/dist/types/io/compress/brotli.d.ts +0 -1
  154. package/dist/types/io/compress/brotli.d.ts.map +1 -1
  155. package/dist/types/io/compress/brotli_shared.d.ts +0 -4
  156. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
  157. package/dist/types/io/compress/deflate.d.ts +14 -1
  158. package/dist/types/io/compress/deflate.d.ts.map +1 -1
  159. package/dist/types/io/compress/gzip.d.ts +4 -0
  160. package/dist/types/io/compress/gzip.d.ts.map +1 -1
  161. package/dist/types/io/compress/huffman.d.ts +7 -0
  162. package/dist/types/io/compress/huffman.d.ts.map +1 -1
  163. package/dist/types/io/compress/lz4.d.ts +4 -2
  164. package/dist/types/io/compress/lz4.d.ts.map +1 -1
  165. package/dist/types/io/compress/lz77.d.ts +17 -0
  166. package/dist/types/io/compress/lz77.d.ts.map +1 -1
  167. package/dist/types/io/compress/lzw.d.ts +2 -0
  168. package/dist/types/io/compress/lzw.d.ts.map +1 -1
  169. package/dist/types/io/compress/zip.d.ts.map +1 -1
  170. package/dist/types/io/compress/zlib.d.ts +9 -2
  171. package/dist/types/io/compress/zlib.d.ts.map +1 -1
  172. package/dist/types/io/math/linalg.d.ts.map +1 -1
  173. package/dist/types/process/rpc.d.ts.map +1 -1
  174. package/dist/types/process/workerPool.d.ts.map +1 -1
  175. package/dist/types/sanity/base.d.ts +12 -2
  176. package/dist/types/sanity/base.d.ts.map +1 -1
  177. package/dist/types/sanity/lockdown.d.ts +6 -5
  178. package/dist/types/sanity/lockdown.d.ts.map +1 -1
  179. package/dist/types/sanity/wasm-gate.d.ts +1 -1
  180. package/docs/README.md +17 -10
  181. package/docs/api/README.md +5 -5
  182. package/docs/api/core/logger.md +2 -1
  183. package/docs/api/core/modules.md +3 -3
  184. package/docs/api/core/runtime.md +9 -9
  185. package/docs/api/core/worker-helper.md +12 -2
  186. package/docs/api/crypto/README.md +1 -1
  187. package/docs/api/crypto/cipher/README.md +2 -2
  188. package/docs/api/crypto/cipher/aes.md +5 -10
  189. package/docs/api/crypto/cipher/chacha20.md +3 -8
  190. package/docs/api/crypto/hash/README.md +5 -5
  191. package/docs/api/crypto/hash/adf.md +21 -11
  192. package/docs/api/crypto/hash/argon2.md +3 -12
  193. package/docs/api/crypto/hash/blake2b.md +12 -14
  194. package/docs/api/crypto/hash/pbkdf2.md +1 -1
  195. package/docs/api/crypto/hash/sha224.md +2 -2
  196. package/docs/api/crypto/hash/sha256.md +4 -4
  197. package/docs/api/crypto/hash/sha3.md +2 -2
  198. package/docs/api/crypto/hash/sha384.md +1 -1
  199. package/docs/api/crypto/hash/sha512.md +5 -5
  200. package/docs/api/crypto/hash/sha512_224.md +1 -1
  201. package/docs/api/crypto/hash/sha512_256.md +1 -1
  202. package/docs/api/crypto/mode/README.md +3 -3
  203. package/docs/api/crypto/mode/cbc.md +2 -2
  204. package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
  205. package/docs/api/crypto/mode/cmac.md +4 -4
  206. package/docs/api/crypto/mode/ctr.md +2 -3
  207. package/docs/api/crypto/mode/gcm.md +5 -5
  208. package/docs/api/crypto/mode/kw.md +4 -4
  209. package/docs/api/crypto/pkc/README.md +8 -8
  210. package/docs/api/crypto/pkc/ecc.md +19 -17
  211. package/docs/api/crypto/pkc/ed25519.md +10 -15
  212. package/docs/api/crypto/pkc/hybridKem.md +8 -2
  213. package/docs/api/crypto/pkc/hybridSign.md +34 -7
  214. package/docs/api/crypto/pkc/ml_dsa.md +20 -19
  215. package/docs/api/crypto/pkc/ml_kem.md +3 -3
  216. package/docs/api/crypto/pkc/rsa.md +7 -9
  217. package/docs/api/crypto/pkc/slh_dsa.md +12 -12
  218. package/docs/api/crypto/pkc/x25519.md +5 -4
  219. package/docs/api/crypto/utils/README.md +7 -7
  220. package/docs/api/crypto/utils/aes_modes.md +2 -5
  221. package/docs/api/crypto/utils/asn1.md +25 -16
  222. package/docs/api/crypto/utils/jws.md +6 -4
  223. package/docs/api/crypto/utils/keyformat.md +24 -15
  224. package/docs/api/crypto/utils/pad.md +1 -1
  225. package/docs/api/crypto/utils/pem.md +3 -3
  226. package/docs/api/crypto/utils/random.md +3 -4
  227. package/docs/api/crypto/utils/rsaKeygen.md +2 -2
  228. package/docs/api/crypto/utils/totp.md +2 -2
  229. package/docs/api/crypto/utils/uuid.md +5 -5
  230. package/docs/api/crypto/utils/x509.md +124 -0
  231. package/docs/api/crypto/wasm/aes.md +1 -1
  232. package/docs/api/crypto/wasm/argon2.md +6 -4
  233. package/docs/api/crypto/wasm/ml_kem.md +1 -0
  234. package/docs/api/crypto/wasm/pbkdf2.md +8 -8
  235. package/docs/api/crypto/wasm/rsa.md +1 -1
  236. package/docs/api/crypto/wasm/runtime.md +27 -10
  237. package/docs/api/crypto/webcrypto/aes.md +1 -1
  238. package/docs/api/crypto/webcrypto/aeskw.md +2 -2
  239. package/docs/api/crypto/webcrypto/digest.md +3 -5
  240. package/docs/api/crypto/webcrypto/ecc.md +1 -1
  241. package/docs/api/crypto/webcrypto/ed25519.md +1 -1
  242. package/docs/api/crypto/webcrypto/rsa.md +3 -2
  243. package/docs/api/crypto/webcrypto/x25519.md +1 -1
  244. package/docs/api/dom/README.md +6 -1
  245. package/docs/api/dom/fs/README.md +1 -0
  246. package/docs/api/dom/fs/fileIntake.md +120 -0
  247. package/docs/api/dom/fs/fsAccess.md +1 -0
  248. package/docs/api/dom/fs/indexedDB.md +1 -1
  249. package/docs/api/dom/fs/storage.md +1 -1
  250. package/docs/api/dom/query/README.md +2 -1
  251. package/docs/api/dom/query/dnd.md +4 -1
  252. package/docs/api/dom/query/dom.md +5 -0
  253. package/docs/api/dom/query/sound.md +103 -0
  254. package/docs/api/dom/rendering/README.md +4 -3
  255. package/docs/api/dom/rendering/chart.md +5 -4
  256. package/docs/api/dom/rendering/component.md +25 -3
  257. package/docs/api/dom/rendering/parser.md +5 -2
  258. package/docs/api/dom/rendering/reactiveBind.md +1 -1
  259. package/docs/api/dom/rendering/render.md +2 -2
  260. package/docs/api/dom/rendering/sanitize.md +10 -2
  261. package/docs/api/dom/rendering/secPolicy.md +4 -4
  262. package/docs/api/dom/rendering/styleSheet.md +85 -0
  263. package/docs/api/dom/rendering/template.md +20 -5
  264. package/docs/api/dom/rendering/themeTokens.md +6 -3
  265. package/docs/api/dom/rendering/uiSession.md +18 -5
  266. package/docs/api/dom/rendering/virtualScroll.md +2 -2
  267. package/docs/api/dom/sensors/geolocation.md +1 -1
  268. package/docs/api/dom/sw/README.md +7 -1
  269. package/docs/api/dom/sw/cache.md +2 -1
  270. package/docs/api/dom/sw/installPrompt.md +111 -0
  271. package/docs/api/dom/sw/precache.md +124 -0
  272. package/docs/api/dom/sw/serviceWorker.md +4 -2
  273. package/docs/api/dom/sw/swUpdate.md +112 -0
  274. package/docs/api/dom/utils/clipboard.md +56 -5
  275. package/docs/api/dom/utils/entropyCollector.md +1 -1
  276. package/docs/api/dom/utils/keybindings.md +17 -2
  277. package/docs/api/dom/utils/leaderElection.md +2 -2
  278. package/docs/api/dom/utils/route.md +1 -0
  279. package/docs/api/dom/utils/ua.md +15 -10
  280. package/docs/api/io/calc/crc32.md +4 -1
  281. package/docs/api/io/codec/README.md +2 -2
  282. package/docs/api/io/codec/b64.md +31 -2
  283. package/docs/api/io/codec/buffer.md +1 -1
  284. package/docs/api/io/codec/cbor.md +6 -4
  285. package/docs/api/io/codec/csv.md +178 -178
  286. package/docs/api/io/codec/hex.md +10 -2
  287. package/docs/api/io/codec/msgpack.md +4 -3
  288. package/docs/api/io/codec/url.md +4 -3
  289. package/docs/api/io/codec/utf8.md +3 -3
  290. package/docs/api/io/compress/bitstream.md +6 -3
  291. package/docs/api/io/compress/brotli.md +36 -4
  292. package/docs/api/io/compress/brotli_shared.md +1 -1
  293. package/docs/api/io/compress/deflate.md +42 -34
  294. package/docs/api/io/compress/gzip.md +26 -6
  295. package/docs/api/io/compress/huffman.md +2 -1
  296. package/docs/api/io/compress/lz4.md +5 -3
  297. package/docs/api/io/compress/lz77.md +26 -3
  298. package/docs/api/io/compress/lzw.md +13 -8
  299. package/docs/api/io/compress/zip.md +36 -10
  300. package/docs/api/io/compress/zlib.md +21 -5
  301. package/docs/api/io/math/linalg.md +1 -1
  302. package/docs/api/io/utils/valid.md +1 -1
  303. package/docs/api/process/rpc.md +3 -2
  304. package/docs/api/process/workerPool.md +1 -1
  305. package/docs/api/sanity/base.md +9 -5
  306. package/docs/api/sanity/lockdown.md +7 -6
  307. package/docs/api/surface.json +12311 -0
  308. package/docs/api/typed.md +5 -3
  309. package/docs/dev/README.md +2 -0
  310. package/docs/dev/bench.md +76 -0
  311. package/docs/dev/crypto-references.md +54 -0
  312. package/docs/dev/provenance.md +30 -7
  313. package/docs/dev/publishing.md +7 -7
  314. package/docs/dev/runtime.md +1 -1
  315. package/docs/dev/testing.md +13 -0
  316. package/docs/evidence/l4-evidence.md +86 -0
  317. package/docs/evidence/pqc-hybrid-evidence.md +7 -6
  318. package/docs/guide/README.md +1 -0
  319. package/docs/guide/_QUICK_REF.md +5 -5
  320. package/docs/guide/doc-format.md +4 -3
  321. package/docs/guide/integrations-hmr.md +1 -1
  322. package/docs/guide/module-creation-workflow.md +8 -8
  323. package/docs/guide/rendering-pipeline.md +11 -4
  324. package/docs/guide/security.md +7 -5
  325. package/docs/guide/stability.md +123 -0
  326. package/docs/guide/tutorial-todo.md +20 -8
  327. package/docs/guide/typescript.md +9 -0
  328. package/docs/guide/worker-confinement.md +30 -17
  329. package/docs/notes/lz77-deflate-factorization.md +3 -3
  330. package/docs/tools/README.md +1 -1
  331. package/docs/tools/bundler.md +3 -3
  332. package/docs/tools/codegen.md +1 -1
  333. package/docs/tools/standalone.md +0 -1
  334. package/fw.config.json +2 -2
  335. package/integrations/_shared/catalog.generated.json +7 -1
  336. package/integrations/_shared/core.js +1 -1
  337. package/integrations/astro/index.js +1 -1
  338. package/integrations/eslint/README.md +7 -1
  339. package/integrations/nextjs/index.js +1 -1
  340. package/integrations/nodejs/README.md +3 -3
  341. package/integrations/turbopack/index.js +2 -2
  342. package/integrations/typedoc/categorize.js +1 -1
  343. package/integrations/typedoc/typedoc.json +2 -1
  344. package/integrations/vite/index.js +2 -2
  345. package/integrations/vite/vite-env.d.ts +7 -4
  346. package/integrations/webpack/index.js +3 -3
  347. package/package.json +76 -10
  348. package/src/core/internal.js +31 -0
  349. package/src/core/logger.js +95 -23
  350. package/src/core/modules.js +17 -8
  351. package/src/core/readyState.js +1 -1
  352. package/src/core/runtime.js +74 -27
  353. package/src/core/worker-helper.js +83 -4
  354. package/src/crypto/NIST_CONFORMANCE.md +47 -34
  355. package/src/crypto/cipher/aes.acvp.md +7 -8
  356. package/src/crypto/cipher/aes.js +280 -229
  357. package/src/crypto/cipher/chacha20.acvp.md +6 -7
  358. package/src/crypto/cipher/chacha20.js +91 -61
  359. package/src/crypto/hash/adf.js +1 -1
  360. package/src/crypto/hash/argon2.acvp.md +11 -15
  361. package/src/crypto/hash/argon2.js +9 -24
  362. package/src/crypto/hash/blake2b.js +157 -125
  363. package/src/crypto/hash/hkdf.acvp.md +15 -15
  364. package/src/crypto/hash/hkdf.js +1 -1
  365. package/src/crypto/hash/hmac.acvp.md +10 -12
  366. package/src/crypto/hash/hmac.js +5 -1
  367. package/src/crypto/hash/pbkdf2.acvp.md +13 -13
  368. package/src/crypto/hash/pbkdf2.js +36 -8
  369. package/src/crypto/hash/poly1305.acvp.md +10 -6
  370. package/src/crypto/hash/poly1305.js +171 -50
  371. package/src/crypto/hash/sha224.acvp.md +3 -3
  372. package/src/crypto/hash/sha224.js +4 -4
  373. package/src/crypto/hash/sha256.acvp.md +2 -2
  374. package/src/crypto/hash/sha256.js +514 -50
  375. package/src/crypto/hash/sha3.acvp.md +9 -9
  376. package/src/crypto/hash/sha3.js +127 -71
  377. package/src/crypto/hash/sha384.acvp.md +3 -3
  378. package/src/crypto/hash/sha384.js +4 -4
  379. package/src/crypto/hash/sha512.acvp.md +7 -8
  380. package/src/crypto/hash/sha512.js +107 -108
  381. package/src/crypto/hash/sha512_224.acvp.md +6 -6
  382. package/src/crypto/hash/sha512_224.js +2 -2
  383. package/src/crypto/hash/sha512_256.acvp.md +6 -6
  384. package/src/crypto/hash/sha512_256.js +2 -2
  385. package/src/crypto/mode/cbc.acvp.md +2 -2
  386. package/src/crypto/mode/cbc.js +1 -1
  387. package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
  388. package/src/crypto/mode/chacha20poly1305.js +3 -3
  389. package/src/crypto/mode/cmac.acvp.md +5 -5
  390. package/src/crypto/mode/cmac.js +8 -8
  391. package/src/crypto/mode/ctr.acvp.md +2 -2
  392. package/src/crypto/mode/ctr.js +1 -3
  393. package/src/crypto/mode/gcm.acvp.md +6 -6
  394. package/src/crypto/mode/gcm.js +7 -7
  395. package/src/crypto/mode/kw.acvp.md +4 -4
  396. package/src/crypto/mode/kw.js +5 -5
  397. package/src/crypto/pkc/ecc.acvp.md +13 -13
  398. package/src/crypto/pkc/ecc.js +9 -11
  399. package/src/crypto/pkc/ed25519.acvp.md +30 -34
  400. package/src/crypto/pkc/ed25519.js +453 -94
  401. package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
  402. package/src/crypto/pkc/hybridSign.js +103 -24
  403. package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
  404. package/src/crypto/pkc/ml_dsa.js +29 -32
  405. package/src/crypto/pkc/ml_kem.acvp.md +7 -7
  406. package/src/crypto/pkc/ml_kem.js +15 -21
  407. package/src/crypto/pkc/rsa.acvp.md +11 -15
  408. package/src/crypto/pkc/rsa.js +7 -44
  409. package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
  410. package/src/crypto/pkc/slh_dsa.js +16 -18
  411. package/src/crypto/pkc/x25519.acvp.md +13 -10
  412. package/src/crypto/pkc/x25519.js +273 -29
  413. package/src/crypto/utils/aes_modes.acvp.md +1 -2
  414. package/src/crypto/utils/aes_modes.js +2 -2
  415. package/src/crypto/utils/asn1-oid.js +1 -1
  416. package/src/crypto/utils/asn1.js +1 -1
  417. package/src/crypto/utils/bitArray.js +33 -48
  418. package/src/crypto/utils/bn.js +1 -1
  419. package/src/crypto/utils/jws.js +37 -41
  420. package/src/crypto/utils/keyformat.js +181 -2
  421. package/src/crypto/utils/pem.js +1 -1
  422. package/src/crypto/utils/random.acvp.md +5 -5
  423. package/src/crypto/utils/random.js +845 -846
  424. package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
  425. package/src/crypto/utils/rsaKeygen.js +6 -6
  426. package/src/crypto/utils/totp.js +1 -1
  427. package/src/crypto/utils/uuid.acvp.md +5 -5
  428. package/src/crypto/utils/uuid.js +11 -10
  429. package/src/crypto/utils/x509.js +591 -0
  430. package/src/crypto/wasm/aes.js +1 -1
  431. package/src/crypto/wasm/aes.scalar.wasm +0 -0
  432. package/src/crypto/wasm/argon2.js +17 -1
  433. package/src/crypto/wasm/argon2.scalar.wasm +0 -0
  434. package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
  435. package/src/crypto/wasm/blake2b.simd.wasm +0 -0
  436. package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
  437. package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
  438. package/src/crypto/wasm/cmac.scalar.wasm +0 -0
  439. package/src/crypto/wasm/ecc.js +3 -3
  440. package/src/crypto/wasm/ecc.scalar.wasm +0 -0
  441. package/src/crypto/wasm/ed25519.js +1 -1
  442. package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
  443. package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
  444. package/src/crypto/wasm/hmac.scalar.wasm +0 -0
  445. package/src/crypto/wasm/ml_dsa.js +2 -2
  446. package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
  447. package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
  448. package/src/crypto/wasm/ml_kem.js +2 -2
  449. package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
  450. package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
  451. package/src/crypto/wasm/pbkdf2.js +8 -6
  452. package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
  453. package/src/crypto/wasm/rsa.js +6 -5
  454. package/src/crypto/wasm/rsa.scalar.wasm +0 -0
  455. package/src/crypto/wasm/runtime.js +84 -17
  456. package/src/crypto/wasm/sha2.scalar.wasm +0 -0
  457. package/src/crypto/wasm/sha3.scalar.wasm +0 -0
  458. package/src/crypto/wasm/sha3.simd.wasm +0 -0
  459. package/src/crypto/wasm/slh_dsa.js +1 -1
  460. package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
  461. package/src/crypto/wasm/x25519.js +1 -1
  462. package/src/crypto/wasm/x25519.scalar.wasm +0 -0
  463. package/src/crypto/webcrypto/aes.js +8 -2
  464. package/src/crypto/webcrypto/aeskw.js +7 -2
  465. package/src/crypto/webcrypto/digest.js +1 -15
  466. package/src/crypto/webcrypto/ecc.js +2 -2
  467. package/src/crypto/webcrypto/ed25519.js +2 -2
  468. package/src/crypto/webcrypto/hmac.js +2 -2
  469. package/src/crypto/webcrypto/rsa.js +7 -2
  470. package/src/crypto/webcrypto/x25519.js +2 -2
  471. package/src/dom/display/animate.js +1 -1
  472. package/src/dom/display/fullscreen.js +1 -1
  473. package/src/dom/fs/download.js +1 -1
  474. package/src/dom/fs/fileIntake.js +192 -0
  475. package/src/dom/fs/fsAccess.js +2 -3
  476. package/src/dom/fs/indexedDB.js +1 -1
  477. package/src/dom/fs/remoteStore.js +1 -1
  478. package/src/dom/fs/storage.js +1 -1
  479. package/src/dom/lifecycle/idle.js +1 -1
  480. package/src/dom/lifecycle/visibility.js +1 -1
  481. package/src/dom/lifecycle/wakeLock.js +1 -1
  482. package/src/dom/net/ajax.js +1 -1
  483. package/src/dom/net/network.js +1 -1
  484. package/src/dom/net/sse.js +1 -1
  485. package/src/dom/net/webrtc.js +1 -1
  486. package/src/dom/net/ws.js +1 -1
  487. package/src/dom/query/dnd.js +56 -4
  488. package/src/dom/query/dom.js +1 -1
  489. package/src/dom/query/events.js +1 -1
  490. package/src/dom/query/gesture.js +1 -1
  491. package/src/dom/query/media.js +1 -1
  492. package/src/dom/query/sound.js +333 -0
  493. package/src/dom/rendering/chart.js +736 -663
  494. package/src/dom/rendering/component.js +25 -14
  495. package/src/dom/rendering/devtools.js +2 -2
  496. package/src/dom/rendering/parser.js +155 -12
  497. package/src/dom/rendering/render.js +14 -4
  498. package/src/dom/rendering/sanitize.js +11 -4
  499. package/src/dom/rendering/secPolicy.js +6 -4
  500. package/src/dom/rendering/styleSheet.js +217 -0
  501. package/src/dom/rendering/template.js +72 -13
  502. package/src/dom/rendering/themeTokens.js +542 -522
  503. package/src/dom/rendering/uiSession-core.js +51 -6
  504. package/src/dom/rendering/uiSession-direct.js +1 -1
  505. package/src/dom/rendering/uiSession-list.js +4 -4
  506. package/src/dom/rendering/uiSession.js +1 -1
  507. package/src/dom/rendering/virtualScroll.js +341 -341
  508. package/src/dom/sensors/battery.js +1 -1
  509. package/src/dom/sensors/geolocation.js +1 -1
  510. package/src/dom/sensors/networkInfo.js +1 -1
  511. package/src/dom/sensors/sensors.js +1 -1
  512. package/src/dom/sw/backgroundSync.js +1 -1
  513. package/src/dom/sw/cache.js +1 -1
  514. package/src/dom/sw/installPrompt.js +151 -0
  515. package/src/dom/sw/precache.js +257 -0
  516. package/src/dom/sw/push.js +1 -1
  517. package/src/dom/sw/sharedWorker.js +1 -1
  518. package/src/dom/sw/swUpdate.js +239 -0
  519. package/src/dom/utils/a11y.js +1 -1
  520. package/src/dom/utils/clipboard.js +56 -6
  521. package/src/dom/utils/entropyCollector.js +1 -1
  522. package/src/dom/utils/focus.js +1 -1
  523. package/src/dom/utils/form.js +1 -1
  524. package/src/dom/utils/keybindings.js +600 -574
  525. package/src/dom/utils/leaderElection.js +1 -1
  526. package/src/dom/utils/notifications.js +1 -1
  527. package/src/dom/utils/permissions.js +107 -107
  528. package/src/dom/utils/route.js +14 -2
  529. package/src/dom/utils/ua.js +42 -28
  530. package/src/dom/utils/webauthn.js +1 -1
  531. package/src/io/binary/reader.js +1 -1
  532. package/src/io/binary/writer.js +1 -1
  533. package/src/io/calc/bigint.js +1 -1
  534. package/src/io/calc/crc32.js +28 -2
  535. package/src/io/calc/easing.js +514 -514
  536. package/src/io/codec/b64.js +189 -52
  537. package/src/io/codec/base32.js +1 -1
  538. package/src/io/codec/base58.js +1 -1
  539. package/src/io/codec/buffer.js +1 -1
  540. package/src/io/codec/cbor.js +111 -18
  541. package/src/io/codec/csv.js +1 -1
  542. package/src/io/codec/hex.js +51 -6
  543. package/src/io/codec/mime.js +1 -1
  544. package/src/io/codec/msgpack.js +47 -6
  545. package/src/io/codec/url.js +24 -7
  546. package/src/io/codec/utf8.js +5 -3
  547. package/src/io/codec/xml.js +1 -1
  548. package/src/io/compress/bitstream.js +2 -2
  549. package/src/io/compress/brotli.js +663 -163
  550. package/src/io/compress/brotli_dict.js +1 -1
  551. package/src/io/compress/brotli_dict_words.js +1 -1
  552. package/src/io/compress/brotli_frame.js +1 -1
  553. package/src/io/compress/brotli_shared.js +7 -7
  554. package/src/io/compress/deflate.js +87 -53
  555. package/src/io/compress/gzip.js +187 -74
  556. package/src/io/compress/huffman.js +24 -1
  557. package/src/io/compress/lz4.js +45 -7
  558. package/src/io/compress/lz77.js +148 -63
  559. package/src/io/compress/lzw.js +35 -19
  560. package/src/io/compress/zip.js +862 -815
  561. package/src/io/compress/zlib.js +87 -7
  562. package/src/io/i18n/i18n.js +1 -1
  563. package/src/io/math/fixed-point.js +1 -1
  564. package/src/io/math/geom.js +1 -1
  565. package/src/io/math/interp.js +1 -1
  566. package/src/io/math/linalg.js +10 -4
  567. package/src/io/math/stats.js +1 -1
  568. package/src/io/structures/btree.js +1 -1
  569. package/src/io/structures/heap.js +1 -1
  570. package/src/io/structures/lruCache.js +1 -1
  571. package/src/io/structures/ringBuffer.js +1 -1
  572. package/src/io/structures/tree-walker.js +1 -1
  573. package/src/io/structures/trie.js +1 -1
  574. package/src/io/sync/abort.js +1 -1
  575. package/src/io/sync/atomics.js +1 -1
  576. package/src/io/sync/cancellable.js +1 -1
  577. package/src/io/sync/channel.js +1 -1
  578. package/src/io/sync/mutex.js +1 -1
  579. package/src/io/sync/semaphore.js +1 -1
  580. package/src/io/sync/tokenBucket.js +1 -1
  581. package/src/io/text/ansi.js +1 -1
  582. package/src/io/text/html-entities.js +1 -1
  583. package/src/io/time/date.js +1 -1
  584. package/src/io/timing/clock.js +1 -1
  585. package/src/io/timing/rateLimit.js +1 -1
  586. package/src/io/timing/scheduler.js +1 -1
  587. package/src/io/utils/errors.js +1 -1
  588. package/src/io/utils/eventBus.js +1 -1
  589. package/src/io/utils/signal.js +1 -1
  590. package/src/io/utils/valid.js +1 -1
  591. package/src/main.js +1 -1
  592. package/src/process/message.js +1 -1
  593. package/src/process/rpc.js +7 -3
  594. package/src/process/workerPool.js +11 -4
  595. package/src/sanity/base.js +85 -39
  596. package/src/sanity/lockdown-apply.js +3 -3
  597. package/src/sanity/lockdown.js +58 -32
  598. package/src/sanity/wasm-gate.js +2 -2
  599. package/src/typed.js +7 -3
  600. package/third-party/NOTICE-brotli-dictionary.txt +69 -0
  601. package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
  602. package/third-party/NOTICE-whatwg-entities.txt +44 -0
  603. package/types/registry.generated.d.ts +7 -1
  604. package/types/typed.d.ts +7 -3
  605. package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
  606. package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
  607. package/docs/api/crypto/utils/aes_ctr.md +0 -71
  608. package/src/crypto/utils/aes_ctr.acvp.md +0 -67
  609. package/src/crypto/utils/aes_ctr.js +0 -134
@@ -10,19 +10,19 @@ Hashes, MAC, KDF (RFC + FIPS / SP NIST). Four families:
10
10
  | Module | Returns | Deps | Description |
11
11
  |--------|----------|------|-------------|
12
12
  | [sha224](./sha224.md) | `{fn, hash}` | `sha256` | SHA-224 (FIPS 180-4 §6.3) — sha256 wrapper |
13
- | [sha256](./sha256.md) | `{fn, hash, _internal}` | `bitArray`, `utf8` | SHA-256 (FIPS 180-4 §6.2) |
13
+ | [sha256](./sha256.md) | `{fn, hash}` | `bitArray`, `utf8` | SHA-256 (FIPS 180-4 §6.2) |
14
14
  | [sha384](./sha384.md) | `{fn, hash}` | `sha512` | SHA-384 (FIPS 180-4 §6.5) — sha512 wrapper |
15
- | [sha512](./sha512.md) | `{fn, hash, _internal}` | `bitArray`, `utf8` | SHA-512 (FIPS 180-4 §6.4) + parametric builder |
15
+ | [sha512](./sha512.md) | `{fn, hash}` | `bitArray`, `utf8` | SHA-512 (FIPS 180-4 §6.4) + parametric builder |
16
16
  | [sha512_224](./sha512_224.md) | `{fn, hash}` | `sha512` | SHA-512/224 (FIPS 180-4 §5.3.6.1) |
17
17
  | [sha512_256](./sha512_256.md) | `{fn, hash}` | `sha512` | SHA-512/256 (FIPS 180-4 §5.3.6.2) |
18
18
  | [sha3](./sha3.md) | `{sha3_*, shake*, sha3_*_hash}` | `bitArray`, `utf8` | SHA-3 + SHAKE (FIPS 202) one-shot + streaming |
19
19
  | [hmac](./hmac.md) | `{fn, verify}` | `bitArray`, `utf8`, `sha256` | Polymorphic HMAC (RFC 2104 / FIPS 198-1) over any hash |
20
20
  | [hkdf](./hkdf.md) | `{extract, expand, derive}` | `bitArray`, `utf8`, `hmac` | HKDF (RFC 5869 / SP 800-56C Rev. 2) |
21
21
  | [pbkdf2](./pbkdf2.md) | callable + `.derive`, `.MIN_RECOMMENDED_COUNT` | `bitArray`, `utf8`, `hmac` | PBKDF2 (RFC 2898 / SP 800-132), default 600,000 iter |
22
- | [blake2b](./blake2b.md) | `{hash, fn}` | none | BLAKE2b (RFC 7693); salt/person; keyed mode |
22
+ | [blake2b](./blake2b.md) | `{hash, create}` | none | BLAKE2b (RFC 7693); salt/person; keyed mode |
23
23
  | [poly1305](./poly1305.md) | `{mac, verify}` | none | Poly1305 (RFC 8439 §2.5) — 128-bit one-shot MAC |
24
- | [argon2](./argon2.md) | `{hash, hashD, hashI, _internal}` | `blake2b` | Argon2id (RFC 9106); Argon2d/i explicit reject |
25
- | [adf](./adf.md) | `{transform}` | `aes`, `sha256` | KeePass AES-DF (KDBX 3.x) — legacy interop |
24
+ | [argon2](./argon2.md) | `{hash}` | `blake2b` | Argon2id (RFC 9106) |
25
+ | [adf](./adf.md) | `{fn, partial, MIN_RECOMMENDED_ROUNDS, MAX_ROUNDS}` | `aes`, `sha256` | KeePass AES-DF (KDBX 3.x) — legacy interop |
26
26
 
27
27
  ## Common pattern (one-shot)
28
28
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: adf
3
3
  category: crypto/hash
4
- dependencies: [aes, sha256]
4
+ dependencies: [sha256, aes]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > AES-DF (KeePass KDBX 3.x) — KDF interop legacy, NOT RECOMMENDED for new code.
13
13
 
14
- **Module** `adf` | **Source** `packages/front/fw/src/crypto/hash/adf.js` | **Deps** `aes`, `sha256` | **Worker-safe** yes
14
+ **Module** `adf` | **Source** `packages/front/fw/src/crypto/hash/adf.js` | **Deps** `sha256`, `aes` | **Worker-safe** yes
15
15
 
16
16
  Format-spec interop for KeePass v1 / KDBX 3.x databases. For new password hashing, use [`argon2`](./argon2.md) (RFC 9106). For generic KDF, use [`hkdf`](./hkdf.md) or [`pbkdf2`](./pbkdf2.md).
17
17
 
@@ -19,23 +19,33 @@ Format-spec interop for KeePass v1 / KDBX 3.x databases. For new password hashin
19
19
 
20
20
  ```js
21
21
  const adf = runtime.resolve('adf');
22
- // Returns: { transform }
22
+ // Returns: { fn, partial, MIN_RECOMMENDED_ROUNDS, MAX_ROUNDS }
23
23
  ```
24
24
 
25
25
  ## API
26
26
 
27
- | Method | Signature | Returns |
27
+ Inputs and outputs are bitArrays (`number[]` words, see [bitArray](../utils/bitArray.md)).
28
+
29
+ | Member | Signature | Returns |
28
30
  |---------|-----------|---------|
29
- | `transform(masterKey, transformSeed, rounds)` | `(Uint8Array(32), Uint8Array(32), number) => Uint8Array(32)` | Composite key |
31
+ | `fn(master, transform, rounds, composite)` | `(number[], number[], number, number[]) => number[] \| false` | The KDBX 3.x final key: `SHA-256(partial(…))` |
32
+ | `partial(master, transform, rounds, composite)` | `(number[], number[], number, number[]) => number[] \| false` | `master ‖ SHA-256(transformed)`, the key before the last hash |
33
+ | `MIN_RECOMMENDED_ROUNDS` | `number` | KeePass's recommended minimum round count |
34
+ | `MAX_ROUNDS` | `number` | The largest accepted round count |
35
+
36
+ `master` is the master seed (32 bytes), `transform` the transform seed (32 bytes, the AES-256 key), `composite` the composite key (the hash of the credentials). Any invalid input returns `false` with a warning.
30
37
 
31
38
  ## Examples
32
39
 
33
40
  ```js
34
- const { adf, hex } = fw.runtime.resolveAll(['adf', 'hex']);
41
+ const { adf, bitArray } = fw.runtime.resolveAll(['adf', 'bitArray']);
35
42
 
36
- const masterKey = hex.toBytes('...32 bytes...');
37
- const transformSeed = hex.toBytes('...32 bytes...');
38
- const out = adf.transform(masterKey, transformSeed, 600000);
43
+ const key = adf.fn(
44
+ bitArray.ui8_to_ba(masterSeed),
45
+ bitArray.ui8_to_ba(transformSeed),
46
+ 600000,
47
+ bitArray.ui8_to_ba(compositeKey),
48
+ );
39
49
  ```
40
50
 
41
51
  ## Worker Usage
@@ -43,9 +53,9 @@ const out = adf.transform(masterKey, transformSeed, 600000);
43
53
  ```js
44
54
  const worker = fw.createWorker(
45
55
  function ({ libs, args }) {
46
- self.postMessage(libs.adf.transform(args[0], args[1], args[2]));
56
+ self.postMessage(libs.adf.fn(args[0], args[1], args[2], args[3]));
47
57
  },
48
- { dependencies: ['adf'], args: [masterKey, transformSeed, 600000] }
58
+ { dependencies: ['adf'], args: [master, transform, 600000, composite] }
49
59
  );
50
60
  ```
51
61
 
@@ -13,13 +13,13 @@ status: complete
13
13
 
14
14
  **Module** `argon2` | **Source** `packages/front/fw/src/crypto/hash/argon2.js` | **Deps** `blake2b` | **Worker-safe** yes
15
15
 
16
- NIST/IETF/OWASP selection for password storage. RFC 9106 §4 mandates Argon2id (d/i hybrid). `hashD` (Argon2d) and `hashI` (Argon2i) are exposed but return `false` + typed warning.
16
+ NIST/IETF/OWASP selection for password storage. RFC 9106 §4 mandates Argon2id (d/i hybrid); Argon2d and Argon2i are not offered.
17
17
 
18
18
  ## Resolve
19
19
 
20
20
  ```js
21
21
  const argon2 = runtime.resolve('argon2');
22
- // Returns: { hash, hashD, hashI, _internal }
22
+ // Returns: { hash }
23
23
  ```
24
24
 
25
25
  ## API
@@ -27,9 +27,7 @@ const argon2 = runtime.resolve('argon2');
27
27
  | Method | Signature | Returns |
28
28
  |---------|-----------|---------|
29
29
  | `hash(opts)` | `({password, salt, time, memory, parallelism, tagLen, secret?, ad?}) => Uint8Array \| false` | Argon2id tag |
30
- | `hashD()` | `() => false` | **UNSAFE reject** (cache-timing) |
31
- | `hashI()` | `() => false` | **DEPRECATED reject** (Alwen-Blocki 2016) |
32
- | `_internal.{Hp, compress}` | — | Test/debug primitives |
30
+ | `internalOf(argon2).{Hp, compress}` | — | Test/debug primitives |
33
31
 
34
32
  ### Options `hash`
35
33
 
@@ -59,13 +57,6 @@ const tag = argon2.hash({
59
57
  // Store (tag, salt) in the database; rehash at login to verify.
60
58
  ```
61
59
 
62
- ### Argon2d / Argon2i rejected
63
-
64
- ```js
65
- argon2.hashD(); // false + console.warn('UNSAFE: Argon2d cache-timing')
66
- argon2.hashI(); // false + console.warn('DEPRECATED: Argon2i Alwen-Blocki 2016')
67
- ```
68
-
69
60
  ## Worker Usage
70
61
 
71
62
  ```js
@@ -19,25 +19,23 @@ Extremely fast hash (1× faster than MD5, ~2× SHA-256) with security margins
19
19
 
20
20
  ```js
21
21
  const blake2b = runtime.resolve('blake2b');
22
- // Returns: { hash, fn }
22
+ // Returns: { hash, create }
23
23
  ```
24
24
 
25
25
  ## API
26
26
 
27
27
  | Method | Signature | Returns |
28
28
  |---------|-----------|---------|
29
- | `hash(msg, outLen=64, opts?)` | `(Uint8Array, number, {key?, salt?, person?}) => Uint8Array` | One-shot digest, outLen ∈ [1, 64] bytes |
30
- | `fn(outLen?, opts?)` | constructor | Streaming `update`/`finalize` |
31
- | `fn.prototype.update(data)` | `(Uint8Array) => this` | Absorbs input |
32
- | `fn.prototype.finalize()` | `() => Uint8Array` | Emits the digest |
29
+ | `hash(msg, outLen = 64, key?)` | `(Uint8Array, number?, Uint8Array?) => Uint8Array \| false` | One-shot digest, `outLen` ∈ [1, 64] bytes, keyed when `key` is given |
30
+ | `create(outLen = 64, key?, salt?, person?)` | `(number?, Uint8Array?, Uint8Array?, Uint8Array?) => ctx \| false` | A streaming context: `ctx.update(chunk)` (`false` once finalised), `ctx.digest()` |
33
31
 
34
- ### Options
32
+ ### Parameters
35
33
 
36
- | Option | Type | Description |
34
+ | Parameter | Type | Description |
37
35
  |--------|------|-------------|
38
- | `key` | `Uint8Array(0..64)` | Keyed mode (HMAC alternative, faster) |
39
- | `salt` | `Uint8Array(16)` | Per-instance domain separation |
40
- | `person` | `Uint8Array(16)` | Per-application domain separation |
36
+ | `key` | `Uint8Array(0..64)` | Keyed mode (a MAC, an HMAC alternative) |
37
+ | `salt` | `Uint8Array(16)` | Per-instance domain separation (`create` only) |
38
+ | `person` | `Uint8Array(16)` | Per-application domain separation (`create` only) |
41
39
 
42
40
  ## Examples
43
41
 
@@ -52,16 +50,16 @@ hex.fromBytes(out);
52
50
  ### Keyed (HMAC alternative)
53
51
 
54
52
  ```js
55
- const tag = blake2b.hash(msg, 32, { key: secretKey });
53
+ const tag = blake2b.hash(msg, 32, secretKey);
56
54
  ```
57
55
 
58
- ### Streaming
56
+ ### Streaming, with salt and personalisation
59
57
 
60
58
  ```js
61
- const h = new blake2b.fn(64);
59
+ const h = blake2b.create(64, undefined, salt16, person16);
62
60
  h.update(chunk1);
63
61
  h.update(chunk2);
64
- const out = h.finalize();
62
+ const out = h.digest();
65
63
  ```
66
64
 
67
65
  ## Worker Usage
@@ -84,7 +84,7 @@ const worker = fw.createWorker(
84
84
 
85
85
  - **Default 600 000 iter** (OWASP 2023). `count < 100000` emits `console.warn('WEAK')` but does not abort (compat with KAT vectors).
86
86
  - **`length=0`** returns `[]` (audit post-upgrade Finding 4 — previously returned a phantom block).
87
- - **SP 800-132 limits**: `count ≥ 1000` + `length ≤ (2³² - 1) × hashLen`. No explicit validation beyond the `WEAK` warning.
87
+ - **SP 800-132 limits**: `count ≥ 1000` + `length ≤ (2³² - 1) × hashLen`. A count below 1 (or `NaN`) returns `false` (RFC 8018 §5.2: a positive integer); below 100 000 only the `WEAK` warning.
88
88
 
89
89
  ## See also
90
90
 
@@ -13,7 +13,7 @@ status: complete
13
13
 
14
14
  **Module** `sha224` | **Source** `packages/front/fw/src/crypto/hash/sha224.js` | **Deps** `sha256` | **Worker-safe** yes
15
15
 
16
- 14-LOC wrapper over `sha256._internal.makeSha(_INIT_224, 7)`. Previously this module duplicated ~80 LOC of the compression function — refactored in the post-upgrade audit.
16
+ 14-LOC wrapper over `internalOf(sha256).makeSha(_INIT_224, 7)`. Previously this module duplicated ~80 LOC of the compression function — refactored in the post-upgrade audit.
17
17
 
18
18
  ## Resolve
19
19
 
@@ -52,7 +52,7 @@ const worker = fw.createWorker(
52
52
 
53
53
  - **HMAC-compatible**: `blockSize = 512` bits (identical to SHA-256, required by RFC 2104).
54
54
  - **LDT 1 GiB** validation gated behind `CRYPTO_FULL=1` — see [Conformance](../../../../src/crypto/hash/sha224.acvp.md).
55
- - **No own API**: everything is delegated to `sha256._internal.makeSha`.
55
+ - **No own API**: everything is delegated to `internalOf(sha256).makeSha`.
56
56
 
57
57
  ## See also
58
58
 
@@ -13,13 +13,13 @@ status: complete
13
13
 
14
14
  **Module** `sha256` | **Source** `packages/front/fw/src/crypto/hash/sha256.js` | **Deps** `bitArray`, `utf8` | **Worker-safe** yes
15
15
 
16
- Streaming `fn` API + one-shot `hash`. The parametric factory `_internal.makeSha(init, outWords)` is used by [`sha224`](./sha224.md) (mirrors the [`sha512`](./sha512.md) ↔ [`sha512_224`](./sha512_224.md) / [`sha512_256`](./sha512_256.md) pattern).
16
+ Streaming `fn` API + one-shot `hash`. The parametric factory `internalOf(sha256).makeSha(init, outWords)` is used by [`sha224`](./sha224.md) (mirrors the [`sha512`](./sha512.md) ↔ [`sha512_224`](./sha512_224.md) / [`sha512_256`](./sha512_256.md) pattern).
17
17
 
18
18
  ## Resolve
19
19
 
20
20
  ```js
21
21
  const sha256 = runtime.resolve('sha256');
22
- // Returns: { fn, hash, _internal }
22
+ // Returns: { fn, hash }
23
23
  ```
24
24
 
25
25
  ## API
@@ -31,7 +31,7 @@ const sha256 = runtime.resolve('sha256');
31
31
  | `fn.prototype.update` | `(data: string \| bitArray) => this` | Absorbs; chainable |
32
32
  | `fn.prototype.finalize` | `() => bitArray` | Emits the digest and resets |
33
33
  | `fn.prototype.reset` | `() => this` | Reinitializes state |
34
- | `_internal.makeSha` | `(init: number[], outWords: number) => {fn, hash}` | Parametric builder (used by sha224) |
34
+ | `internalOf(sha256).makeSha` | `(init: number[], outWords: number) => {fn, hash}` | Parametric builder (used by sha224) |
35
35
 
36
36
  ## Examples
37
37
 
@@ -75,7 +75,7 @@ const worker = fw.createWorker(
75
75
 
76
76
  - **Max limit**: `update` rejects via `false` + `console.warn('INVALID')` beyond 2⁵³−1 bits (IEEE-754 limit of the `_length` counter).
77
77
  - **`update` after `finalize`**: `finalize()` resets state → the instance is reusable. To clone without reset: `new sha256.fn(other)`.
78
- - **LDT (Large Data Test) 1 GiB** validation gated behind `CRYPTO_FULL=1` (Iteration H1).
78
+ - **LDT (Large Data Test) 1 GiB** validation gated behind `CRYPTO_FULL=1`.
79
79
 
80
80
  ## See also
81
81
 
@@ -19,7 +19,7 @@ One-shot API for SHA-3 and SHAKE + 4 streaming `sha3_*_hash` sub-modules consuma
19
19
 
20
20
  ```js
21
21
  const sha3 = runtime.resolve('sha3');
22
- // Returns: { name, sha3_224, sha3_256, sha3_384, sha3_512, shake128, shake256,
22
+ // Returns: { sha3_224, sha3_256, sha3_384, sha3_512, shake128, shake256,
23
23
  // sha3_224_hash, sha3_256_hash, sha3_384_hash, sha3_512_hash }
24
24
  ```
25
25
 
@@ -80,7 +80,7 @@ const worker = fw.createWorker(
80
80
 
81
81
  - **One-shot only on `sha3_*` / `shake*`** — no direct streaming API (use `sha3_*_hash.fn` which exposes update/finalize).
82
82
  - **SHAKE outBits**: must be a multiple of 8 (byte alignment); otherwise `false` + `console.warn('INVALID')`.
83
- - **MCT byte-exact**: all SHA3-{224,256,384,512} variants tested 100/100 iterations × 1000 inner (Iteration H2).
83
+ - **MCT byte-exact**: all SHA3-{224,256,384,512} variants tested 100/100 iterations × 1000 inner.
84
84
 
85
85
  ## See also
86
86
 
@@ -13,7 +13,7 @@ status: complete
13
13
 
14
14
  **Module** `sha384` | **Source** `packages/front/fw/src/crypto/hash/sha384.js` | **Deps** `sha512` | **Worker-safe** yes
15
15
 
16
- 14-LOC wrapper over `sha512._internal.makeSha(_INIT_384, 12)`. Previously this module duplicated ~120 LOC of the compression function — refactored in the post-upgrade audit.
16
+ 14-LOC wrapper over `internalOf(sha512).makeSha(_INIT_384, 12)`. Previously this module duplicated ~120 LOC of the compression function — refactored in the post-upgrade audit.
17
17
 
18
18
  ## Resolve
19
19
 
@@ -13,13 +13,13 @@ status: complete
13
13
 
14
14
  **Module** `sha512` | **Source** `packages/front/fw/src/crypto/hash/sha512.js` | **Deps** `bitArray`, `utf8` | **Worker-safe** yes
15
15
 
16
- Streaming `fn` API + one-shot `hash`. The parametric factory `_internal.makeSha(init, outWords)` is used by [`sha384`](./sha384.md), [`sha512_224`](./sha512_224.md), [`sha512_256`](./sha512_256.md).
16
+ Streaming `fn` API + one-shot `hash`. The parametric factory `internalOf(sha512).makeSha(init, outWords)` is used by [`sha384`](./sha384.md), [`sha512_224`](./sha512_224.md), [`sha512_256`](./sha512_256.md).
17
17
 
18
18
  ## Resolve
19
19
 
20
20
  ```js
21
21
  const sha512 = runtime.resolve('sha512');
22
- // Returns: { fn, hash, _internal }
22
+ // Returns: { fn, hash }
23
23
  ```
24
24
 
25
25
  ## API
@@ -30,7 +30,7 @@ const sha512 = runtime.resolve('sha512');
30
30
  | `fn` | `constructor()` or `constructor(other)` | Streaming instance + copy constructor |
31
31
  | `fn.prototype.update` | `(data) => this` | Absorbs; chainable |
32
32
  | `fn.prototype.finalize` | `() => bitArray` | Emits the digest and resets |
33
- | `_internal.makeSha` | `(init: number[], outWords: number) => {fn, hash}` | Builder for truncated variants |
33
+ | `internalOf(sha512).makeSha` | `(init: number[], outWords: number) => {fn, hash}` | Builder for truncated variants |
34
34
 
35
35
  ## Examples
36
36
 
@@ -46,7 +46,7 @@ hex.fromBytes(bitArray.ba_to_ui8(digestBa));
46
46
 
47
47
  ```js
48
48
  // Used by sha384.js / sha512_224.js / sha512_256.js
49
- const sha384Like = sha512._internal.makeSha(_INIT_384, 12);
49
+ const sha384Like = internalOf(sha512).makeSha(_INIT_384, 12);
50
50
  const digest = sha384Like.hash('abc'); // 12 words × 32 = 384 bits
51
51
  ```
52
52
 
@@ -64,7 +64,7 @@ const worker = fw.createWorker(
64
64
  - **Input domain is a `bitArray`, not raw bytes.** `hash(data)` accepts a UTF-8 string or a `bitArray`. Passing a `Uint8Array` does **not** throw — it is consumed as a word array and yields a wrong-but-deterministic digest that still round-trips self-consistently and only fails against official vectors. Convert first: `sha512.hash(bitArray.ui8_to_ba(bytes))`. The same domain applies to the `pkc` hash helper; the WASM `sha2` / `sha3` wrappers, by contrast, consume raw bytes directly. A green round-trip is not evidence of a correct digest.
65
65
  - **Block size**: 1024 bits (vs 512 for SHA-256). 64-bit `_length` counter FIPS 180-4 §5.1.2 limited to 2⁵³−1 by IEEE-754.
66
66
  - **64-bit operations emulated** as 32-bit pairs (high/low) — no BigInt.
67
- - **LDT 1 GiB** validation gated behind `CRYPTO_FULL=1` (Iteration H1).
67
+ - **LDT 1 GiB** validation gated behind `CRYPTO_FULL=1`.
68
68
 
69
69
  ## See also
70
70
 
@@ -19,7 +19,7 @@ Truncated SHA-512 variant. Faster than SHA-256 on 64-bit platforms (in C/asm); i
19
19
 
20
20
  ```js
21
21
  const sha512_224 = runtime.resolve('sha512_224');
22
- // Returns: { name, fn, hash }
22
+ // Returns: { fn, hash }
23
23
  ```
24
24
 
25
25
  ## API
@@ -19,7 +19,7 @@ status: complete
19
19
 
20
20
  ```js
21
21
  const sha512_256 = runtime.resolve('sha512_256');
22
- // Returns: { name, fn, hash }
22
+ // Returns: { fn, hash }
23
23
  ```
24
24
 
25
25
  ## API
@@ -6,9 +6,9 @@ AES operating modes + ChaCha20 AEAD. Each module takes a pre-scheduled block/str
6
6
  |--------|----------|------|-------------|
7
7
  | [cbc](./cbc.md) | `{encrypt, decrypt}` | `bitArray`, `aes` | AES-CBC (SP 800-38A §6.2) — confidentiality, caller-provided padding |
8
8
  | [ctr](./ctr.md) | `{encrypt}` | `bitArray`, `aes` | AES-CTR (SP 800-38A §6.5) — stream, no padding |
9
- | [gcm](./gcm.md) | `{encrypt, decrypt, gmac, gmacVerify, nonceTracker, _internal}` | `bitArray`, `aes` | AES-GCM (SP 800-38D) — AEAD, GMAC included |
10
- | [cmac](./cmac.md) | `{mac, verify, truncatedMac, truncatedVerify, _internal}` | `bitArray`, `aes` | AES-CMAC (SP 800-38B / RFC 4493); TDES rejected |
11
- | [kw](./kw.md) | `{wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher, _internal}` | `bitArray`, `aes` | AES-KW + KWP (SP 800-38F / RFC 3394 / RFC 5649) |
9
+ | [gcm](./gcm.md) | `{encrypt, decrypt, gmac, gmacVerify, nonceTracker}` | `bitArray`, `aes` | AES-GCM (SP 800-38D) — AEAD, GMAC included |
10
+ | [cmac](./cmac.md) | `{mac, verify, truncatedMac, truncatedVerify}` | `bitArray`, `aes` | AES-CMAC (SP 800-38B / RFC 4493); TDES rejected |
11
+ | [kw](./kw.md) | `{wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher}` | `bitArray`, `aes` | AES-KW + KWP (SP 800-38F / RFC 3394 / RFC 5649) |
12
12
  | [chacha20poly1305](./chacha20poly1305.md) | `{encrypt, decrypt, nonceTracker}` | `chacha20`, `poly1305` | AEAD ChaCha20-Poly1305 (RFC 8439) |
13
13
 
14
14
  ## Common pattern (AEAD)
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: cbc
3
3
  category: crypto/mode
4
- dependencies: [bitArray, aes]
4
+ dependencies: [bitArray]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > AES-CBC (SP 800-38A §6.2) — confidentiality, padding is the caller's responsibility.
13
13
 
14
- **Module** `cbc` | **Source** `packages/front/fw/src/crypto/mode/cbc.js` | **Deps** `bitArray`, `aes` | **Worker-safe** yes
14
+ **Module** `cbc` | **Source** `packages/front/fw/src/crypto/mode/cbc.js` | **Deps** `bitArray` | **Worker-safe** yes
15
15
 
16
16
  CBC is **unauthenticated**: use [`gcm`](./gcm.md) or [`chacha20poly1305`](./chacha20poly1305.md) for AEAD. If CBC is required, layer an explicit MAC (encrypt-then-MAC).
17
17
 
@@ -67,7 +67,7 @@ const worker = fw.createWorker(
67
67
  ## Notes
68
68
 
69
69
  - **12-byte nonce** (RFC 8439 §2.3). **Nonce reuse** does not degrade Poly1305 cryptographically but **leaks the XOR of plaintexts** + enables forgery → use `nonceTracker` for in-process detection.
70
- - **Tag mismatch → `false`** + `console.error('CORRUPT')`. Plaintext is never released on an invalid tag.
70
+ - **Tag mismatch → `false`** + `console.warn('CORRUPT')` (an expected outcome; nonce reuse stays at `console.error`). Plaintext is never released on an invalid tag.
71
71
  - **No AES-NI required**: better performance than GCM on ARM / mobile / without AES hardware.
72
72
 
73
73
  ## See also
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: cmac
3
3
  category: crypto/mode
4
- dependencies: [bitArray, aes]
4
+ dependencies: [bitArray]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > AES-CMAC (SP 800-38B / RFC 4493) — deterministic MAC based on AES, TDES rejected.
13
13
 
14
- **Module** `cmac` | **Source** `packages/front/fw/src/crypto/mode/cmac.js` | **Deps** `bitArray`, `aes` | **Worker-safe** yes
14
+ **Module** `cmac` | **Source** `packages/front/fw/src/crypto/mode/cmac.js` | **Deps** `bitArray` | **Worker-safe** yes
15
15
 
16
16
  Default 128-bit tag, truncatable to 32-128 via `truncatedMac` (SP 800-38B §6.4 minimum 32 bits).
17
17
 
@@ -19,7 +19,7 @@ Default 128-bit tag, truncatable to 32-128 via `truncatedMac` (SP 800-38B §6.4
19
19
 
20
20
  ```js
21
21
  const cmac = runtime.resolve('cmac');
22
- // Returns: { mac, verify, truncatedMac, truncatedVerify, _internal }
22
+ // Returns: { mac, verify, truncatedMac, truncatedVerify }
23
23
  ```
24
24
 
25
25
  ## API
@@ -30,7 +30,7 @@ const cmac = runtime.resolve('cmac');
30
30
  | `verify(prf, msgBa, tagBa)` | — | `boolean` (constant-time) |
31
31
  | `truncatedMac(prf, msgBa, tagLen)` | — | Truncated tag `tagLen ∈ [32, 128]` |
32
32
  | `truncatedVerify(prf, msgBa, tagBa, tagLen)` | — | `boolean` |
33
- | `_internal.{subkeys}` | — | Debug primitives |
33
+ | `internalOf(cmac).{subkeys}` | — | Debug primitives |
34
34
 
35
35
  ## Examples
36
36
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: ctr
3
3
  category: crypto/mode
4
- dependencies: [bitArray, aes]
4
+ dependencies: [bitArray]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > AES-CTR (SP 800-38A §6.5) — stream mode, no padding, encrypt/decrypt involution.
13
13
 
14
- **Module** `ctr` | **Source** `packages/front/fw/src/crypto/mode/ctr.js` | **Deps** `bitArray`, `aes` | **Worker-safe** yes
14
+ **Module** `ctr` | **Source** `packages/front/fw/src/crypto/mode/ctr.js` | **Deps** `bitArray` | **Worker-safe** yes
15
15
 
16
16
  CTR = stream cipher derived from a block cipher. **Unauthenticated**: use GCM for AEAD. **Nonce reuse is catastrophic**: 2 messages under an identical (key, IV) → keystream recovery.
17
17
 
@@ -61,6 +61,5 @@ const worker = fw.createWorker(
61
61
  ## See also
62
62
 
63
63
  - [aes](../cipher/aes.md), [aes_modes](../utils/aes_modes.md) — Uint8Array wrapper
64
- - [aes_ctr](../utils/aes_ctr.md) — legacy wrapper with PKCS#7 (deprecated)
65
64
  - [gcm](./gcm.md) — recommended AEAD
66
65
  - [Conformance ctr.acvp.md](../../../../src/crypto/mode/ctr.acvp.md)
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: gcm
3
3
  category: crypto/mode
4
- dependencies: [bitArray, aes]
4
+ dependencies: [bitArray]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > AES-GCM (SP 800-38D) — authenticated AEAD + GMAC, IV-reuse catastrophic.
13
13
 
14
- **Module** `gcm` | **Source** `packages/front/fw/src/crypto/mode/gcm.js` | **Deps** `bitArray`, `aes` | **Worker-safe** yes
14
+ **Module** `gcm` | **Source** `packages/front/fw/src/crypto/mode/gcm.js` | **Deps** `bitArray` | **Worker-safe** yes
15
15
 
16
16
  Recommended AEAD mode for TLS / file encryption. **IV reuse under the same key is catastrophic**: loss of the GHASH authentication key + leak of the XOR of plaintexts.
17
17
 
@@ -19,7 +19,7 @@ Recommended AEAD mode for TLS / file encryption. **IV reuse under the same key i
19
19
 
20
20
  ```js
21
21
  const gcm = runtime.resolve('gcm');
22
- // Returns: { encrypt, decrypt, gmac, gmacVerify, nonceTracker, _internal }
22
+ // Returns: { encrypt, decrypt, gmac, gmacVerify, nonceTracker }
23
23
  ```
24
24
 
25
25
  ## API
@@ -31,7 +31,7 @@ const gcm = runtime.resolve('gcm');
31
31
  | `gmac(prf, aadBa, ivBa, tagLenBits)` | — | Tag (no PT) |
32
32
  | `gmacVerify(prf, aadBa, ivBa, tagBa, tagLenBits)` | — | `boolean` |
33
33
  | `nonceTracker(prf)` | `({encrypt}) => {encrypt, decrypt, seenNonces}` | Anti-IV-reuse wrapper (in-process) |
34
- | `_internal.{ghash, gctr}` | — | Debug primitives |
34
+ | `internalOf(gcm).{ghash, gctr}` | — | Debug primitives |
35
35
 
36
36
  ### `tagLenBits`
37
37
 
@@ -83,7 +83,7 @@ const worker = fw.createWorker(
83
83
  ## Notes
84
84
 
85
85
  - **Unique IV** per (key, message): use `random.bytes(12)` or a monotonic counter. `nonceTracker` detects reuse in-process.
86
- - **Tag mismatch → `false`** + `console.error('CORRUPT: gcm: authentication tag mismatch')`. Plaintext is **never** released on an invalid tag.
86
+ - **Tag mismatch → `false`** + `console.warn('CORRUPT: gcm: authentication tag mismatch')` (an expected outcome; nonce reuse stays at `console.error`). Plaintext is **never** released on an invalid tag.
87
87
  - **AES-128/192/256**: `cipher` can be scheduled on any of the 3 key sizes (key-size-agnostic via `aes.fn`).
88
88
 
89
89
  ## See also
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: kw
3
3
  category: crypto/mode
4
- dependencies: [bitArray, aes]
4
+ dependencies: [bitArray]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > AES-KW + KWP (SP 800-38F / RFC 3394 / RFC 5649) — symmetric key wrapping.
13
13
 
14
- **Module** `kw` | **Source** `packages/front/fw/src/crypto/mode/kw.js` | **Deps** `bitArray`, `aes` | **Worker-safe** yes
14
+ **Module** `kw` | **Source** `packages/front/fw/src/crypto/mode/kw.js` | **Deps** `bitArray` | **Worker-safe** yes
15
15
 
16
16
  KW (RFC 3394) wraps payloads that are multiples of 64 bits. KWP (RFC 5649) adds padding for arbitrary-length payloads. Inverse-cipher variant (SP 800-38F §6.3) explicitly rejected.
17
17
 
@@ -19,7 +19,7 @@ KW (RFC 3394) wraps payloads that are multiples of 64 bits. KWP (RFC 5649) adds
19
19
 
20
20
  ```js
21
21
  const kw = runtime.resolve('kw');
22
- // Returns: { wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher, _internal }
22
+ // Returns: { wrap, unwrap, wrapPad, unwrapPad, wrapInverseCipher, unwrapInverseCipher }
23
23
  ```
24
24
 
25
25
  ## API
@@ -32,7 +32,7 @@ const kw = runtime.resolve('kw');
32
32
  | `unwrapPad(prf, ctBa)` | — | PT or `false` |
33
33
  | `wrapInverseCipher()` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
34
34
  | `unwrapInverseCipher()` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
35
- | `_internal.{...}` | — | Debug primitives |
35
+ | `internalOf(kw).{...}` | — | Debug primitives |
36
36
 
37
37
  ## Examples
38
38
 
@@ -8,13 +8,13 @@ Asymmetric cryptography: signatures, key exchange, KEM. Four families:
8
8
 
9
9
  | Module | Returns | Deps | Description |
10
10
  |--------|----------|------|-------------|
11
- | [rsa](./rsa.md) | `{oaepEncrypt, oaepDecrypt, pssSign, pssVerify, pkcs1v15*, _internal}` | `sha256`, `bitArray`, `utf8`, `hex` | RSA-OAEP + RSA-PSS (FIPS 186-5 §5.4 / RFC 8017); v1.5 explicit reject |
12
- | [ecc](./ecc.md) | `{curves, publicKey, secretKey, sign, verify, deserialize, _internal}` | `bitArray`, `hex`, `bn`, `sha256`, `sha384`, `sha512`, `hmac` | ECDSA FIPS 186-5 + RFC 6979 + subgroup check |
13
- | [ed25519](./ed25519.md) | `{keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx, ed448}` | `sha512`, `bitArray` | Ed25519 PureEdDSA + ph + ctx (RFC 8032 / FIPS 186-5 §7.6) |
14
- | [x25519](./x25519.md) | `{scalarMult, scalarMultBase, isLowOrderPoint, _internal}` | none | X25519 DH (RFC 7748) — TweetNaCl-derived (public domain; see [provenance](../../../dev/provenance.md)) |
15
- | [ml_kem](./ml_kem.md) | `{ml_kem512, ml_kem768, ml_kem1024, _internal}` | `sha3`, `bitArray`, `random` | ML-KEM CRYSTALS-Kyber (FIPS 203, August 2024) |
16
- | [ml_dsa](./ml_dsa.md) | `{ml_dsa44, ml_dsa65, ml_dsa87, _internal}` | `sha3`, `bitArray`, `random`, `sha256`, `sha384`, ... | ML-DSA Dilithium + HashML-DSA (FIPS 204) |
17
- | [slh_dsa](./slh_dsa.md) | `{slh_dsa_*_*, _internal}` | `sha3`, `sha256`, `sha512`, `hmac`, `bitArray`, `random` | SLH-DSA SPHINCS+ + HashSLH-DSA (FIPS 205, 12 variants) |
11
+ | [rsa](./rsa.md) | `{oaepEncrypt, oaepDecrypt, pssSign, pssVerify}` | `sha256`, `bitArray`, `utf8`, `hex` | RSA-OAEP + RSA-PSS (FIPS 186-5 §5.4 / RFC 8017); v1.5 explicit reject |
12
+ | [ecc](./ecc.md) | `{ecdsa, elGamal, curves, curveName, deserialize, basicKey, curve, point, pointJac}` | `bitArray`, `hex`, `bn`, `sha256`, `sha384`, `sha512`, `hmac` | ECDSA FIPS 186-5 + RFC 6979 + subgroup check |
13
+ | [ed25519](./ed25519.md) | `{keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx}` | `sha512`, `bitArray` | Ed25519 PureEdDSA + ph + ctx (RFC 8032 / FIPS 186-5 §7.6) |
14
+ | [x25519](./x25519.md) | `{scalarMult, scalarMultBase, isLowOrderPoint}` | none | X25519 DH (RFC 7748) — TweetNaCl-derived (public domain; see [provenance](../../../dev/provenance.md)) |
15
+ | [ml_kem](./ml_kem.md) | `{ml_kem512, ml_kem768, ml_kem1024}` | `sha3`, `bitArray`, `random` | ML-KEM CRYSTALS-Kyber (FIPS 203, August 2024) |
16
+ | [ml_dsa](./ml_dsa.md) | `{ml_dsa44, ml_dsa65, ml_dsa87}` | `sha3`, `bitArray`, `random`, `sha256`, `sha384`, ... | ML-DSA Dilithium + HashML-DSA (FIPS 204) |
17
+ | [slh_dsa](./slh_dsa.md) | `{slh_dsa_*_*}` | `sha3`, `sha256`, `sha512`, `hmac`, `bitArray`, `random` | SLH-DSA SPHINCS+ + HashSLH-DSA (FIPS 205, 12 variants) |
18
18
  | [hybridKem](./hybridKem.md) | `{xwing}` | `x25519`, `ml_kem`, `sha3` | X-Wing hybrid KEM (X25519+ML-KEM-768, draft-connolly-cfrg-xwing-kem -06; official IETF KAT) |
19
19
  | [hybridSign](./hybridSign.md) | `{mldsa65_ed25519, mldsa65_ecdsaP256}` | `ml_dsa`, `ed25519`, `ecc`, `sha512`, `sha256`, `random`, `utf8` | Composite signatures (draft-ietf-lamps-pq-composite-sigs, AND-verify): MLDSA65-Ed25519 + MLDSA65-ECDSA-P256 |
20
20
 
@@ -24,7 +24,7 @@ Asymmetric cryptography: signatures, key exchange, KEM. Four families:
24
24
  const { ed25519, random } = fw.runtime.resolveAll(['ed25519', 'random']);
25
25
  const { privateKey, publicKey } = ed25519.keyPair(random.bytes(32));
26
26
  const sig = ed25519.sign(privateKey, msg);
27
- const ok = ed25519.verify(publicKey, msg, sig); // true / false
27
+ const ok = ed25519.verify(publicKey, sig, msg); // true / false
28
28
  ```
29
29
 
30
30
  ## Common pattern (PQC KEM)