@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
@@ -21,7 +21,7 @@ bun packages/front/fw/tools/hybrid-kat-regen.js # exit 0 = byte-identica
21
21
  | Role | Official IETF X-Wing KAT (tv0..tv2) — conformance oracle for `hybridKem` |
22
22
  | Standard | `draft-connolly-cfrg-xwing-kem` **rev -06**, Appendix C |
23
23
  | Upstream source | Official IETF/libsodium reference KAT `crypto_kem/xwing/kem_xwing.c` |
24
- | Retrieval | Byte-extracted 2026-07-06 during the hybrid design spike; the reference `.c` is UNTRACKED / absent from fresh worktrees, so these transcribed bytes are the tracked source of truth |
24
+ | Retrieval | Byte-extracted 2026-07-06 during the hybrid design; the reference `.c` is UNTRACKED / absent from fresh worktrees, so these transcribed bytes are the tracked source of truth |
25
25
  | SHA-256 | `ed610bc7ac6d7f5cb664662d220d977f2c5851cb494c3c83517ecf587f10335e` |
26
26
  | Regen | `tools/hybrid-kat-regen.js` recomputes `ekPrefix` / `ctPrefix` / full `ss` from each `seed` + `randomness` and asserts byte-identity |
27
27
 
@@ -54,9 +54,9 @@ bun packages/front/fw/tools/hybrid-kat-regen.js # exit 0 = byte-identica
54
54
  | Field | Value |
55
55
  |---|---|
56
56
  | Role | Reproducibility lock (self-KAT) for the FROZEN `hybridSign` construction — NOT an external vendor |
57
- | Origin | Generated by `tools/hybrid-kat-regen.js` from a fixed per-variant DRBG seed (SHAKE-256) driving the frozen keygen + deterministic sign path |
58
- | Retrieval | Generated 2026-07-09 from the frozen fw implementations |
59
- | SHA-256 | `f51d7d130c7ba12362e4d799e18992b06d4274c4c49629b6d6132c2b04d8045f` |
57
+ | Origin | Generated by `tools/hybrid-kat-regen.js` from a fixed per-variant DRBG seed (SHAKE-256) driving the frozen keygen + the sign path (ML-DSA hedged, its rnd drawn from the same DRBG) |
58
+ | Retrieval | Generated 2026-07-09 from the frozen fw implementations; `sig` regenerated 2026-11-10 when `ml_dsa.sign` became hedged by default (`pk` unchanged) |
59
+ | SHA-256 | `9965ba10a865c5af59b5a66b5480365a572faf0c3641f786c3720f5f1cd603a5` |
60
60
  | Regen | `tools/hybrid-kat-regen.js` re-derives `pk` + `sig` per case and asserts byte-identity + `verify() === true` |
61
61
 
62
62
  ## -19 re-vendor outcome (cf-a residual)
@@ -5,8 +5,7 @@
5
5
  /**
6
6
  * @fileoverview Composite (hybrid PQ/T) signatures — `draft-ietf-lamps-pq-composite-sigs`.
7
7
  *
8
- * Productises the W0 spike (`ai/plans/pqc-hybrid/spikes/w0-combiners/FINDINGS.md`,
9
- * verdict GO) into an `@awacloud/fw` DI-factory module composing ONLY vetted fw
8
+ * An `@awacloud/fw` DI-factory module composing ONLY vetted fw
10
9
  * primitives — no novel cryptography. Two registered variants:
11
10
  *
12
11
  * - `mldsa65_ed25519` — ML-DSA-65 ∧ Ed25519 (OID 1.3.6.1.5.5.7.6.48)
@@ -33,7 +32,7 @@
33
32
  * (not a DER-OID Domain). This exact wiring reproduces the official LAMPS
34
33
  * interop vectors — do not deviate.
35
34
  *
36
- * ## Digest domain (W1 carry-forward c)
35
+ * ## Digest domain
37
36
  *
38
37
  * fw's pure-JS `sha512.hash()` consumes a **bitArray** (word-packed `number[]`),
39
38
  * NOT a raw `Uint8Array`. This module hashes message bytes through the bitArray
@@ -60,8 +59,6 @@
60
59
  * - Constant-time is NOT a security boundary in browser JS/WASM (JIT, GC). The
61
60
  * ECDSA-P256 scalar path in fw `ecc` is windowed (cache-timing sensitive).
62
61
  * - Vectors are pinned to `main` commit 1bb9f5c6 (see the vendored vector files).
63
- *
64
- * @see ai/plans/pqc-hybrid/spikes/w0-combiners/FINDINGS.md
65
62
  */
66
63
 
67
64
  import { ml_dsa } from './ml_dsa.js';
@@ -80,8 +77,29 @@ import { utf8 } from '../../io/codec/utf8.js';
80
77
  * Generate a composite key pair (independent per-component seeds). TLV-encoded.
81
78
  * @property {(secretKey: Uint8Array, message: Uint8Array, ctx?: Uint8Array) => (Uint8Array|false)} sign
82
79
  * Composite sign; `false` on invalid input.
83
- * @property {(publicKey: Uint8Array, message: Uint8Array, signature: Uint8Array, ctx?: Uint8Array) => boolean} verify
80
+ * @property {(publicKey: Uint8Array, signature: Uint8Array, message: Uint8Array, ctx?: Uint8Array) => boolean} verify
84
81
  * Composite verify (AND of both components); `false` on any invalid input.
82
+ * @property {(kind: CompositeKind, parts: CompositeParts) => (Uint8Array|false)} fromComponents
83
+ * Build this variant's public key, secret key or signature container from
84
+ * its two components; `false` on a wrong length or form.
85
+ * @property {(kind: CompositeKind, bytes: Uint8Array) => (CompositeParts|false)} toComponents
86
+ * Split a container into its two components (copies); `false` when it does
87
+ * not decode.
88
+ */
89
+
90
+ /**
91
+ * Which container `fromComponents` / `toComponents` handle.
92
+ * @typedef {'publicKey' | 'secretKey' | 'signature'} CompositeKind
93
+ */
94
+
95
+ /**
96
+ * The two components of a composite container: `pq` = the ML-DSA-65 bytes,
97
+ * `trad` = the traditional component — Ed25519 (public key 32, secret key 64 =
98
+ * seed || public key, signature 64) or ECDSA-P256 (public key SEC1
99
+ * uncompressed 65 bytes, secret key the 32-byte scalar, signature DER).
100
+ * @typedef {object} CompositeParts
101
+ * @property {Uint8Array} pq
102
+ * @property {Uint8Array} trad
85
103
  */
86
104
 
87
105
  /**
@@ -89,14 +107,13 @@ import { utf8 } from '../../io/codec/utf8.js';
89
107
  * @typedef {object} HybridSignApi
90
108
  * @property {HybridSignVariant} mldsa65_ed25519 ML-DSA-65 ∧ Ed25519.
91
109
  * @property {HybridSignVariant} mldsa65_ecdsaP256 ML-DSA-65 ∧ ECDSA-P-256.
92
- * @property {object} _internal Test-only escape hatch.
93
110
  */
94
111
 
95
112
  export const hybridSign = {
96
113
  name: 'hybridSign',
97
114
  version: '1.0.0',
98
115
  type: 'fw.crypto.pkc',
99
- // NOTE — `sha256` and `random` extend the W0 FINDINGS §2 dependency sketch
116
+ // NOTE — `sha256` and `random` extend the minimal dependency set
100
117
  // (`ml_dsa,ed25519,ecc,sha512,utf8`). Both are load-bearing and vector-/
101
118
  // implementation-justified: the ECDSA-P256 component hashes M' with SHA-256
102
119
  // (proven against the official vectors — SHA-512/384 fail), and Ed25519
@@ -144,7 +161,7 @@ export const hybridSign = {
144
161
 
145
162
  // ── byte-domain helpers (pure; replicate bitArray big-endian packing) ──
146
163
  // Local wrappers avoid a `bitArray` dependency while still hashing through
147
- // the correct (word-packed) domain — the fix for the W0 digest-domain bug.
164
+ // the correct (word-packed) domain — hashing raw bytes there would give the wrong digest.
148
165
  function _partial(len, x, end) {
149
166
  if (len === 32) return x;
150
167
  return (end ? x | 0 : x << (32 - len)) + len * 0x10000000000;
@@ -305,14 +322,14 @@ export const hybridSign = {
305
322
  const context = ctx || new Uint8Array(0);
306
323
  if (context.length > 255) return false;
307
324
  const mPrime = _buildMprime(LABEL_ED, message, context);
308
- const sigMl = MLDSA.sign(mPrime, mldsaSk, LABEL_ED);
325
+ const sigMl = MLDSA.sign(mldsaSk, mPrime, LABEL_ED);
309
326
  if (sigMl === false) return false;
310
327
  const sigEd = ed25519.sign(edSk, mPrime);
311
328
  if (sigEd === false) return false;
312
329
  return _concat([sigMl, sigEd]); // fixed slices, no randomizer
313
330
  }
314
331
 
315
- function _edVerify(publicKey, message, signature, ctx) {
332
+ function _edVerify(publicKey, signature, message, ctx) {
316
333
  const parts = _decodeTlv(publicKey, SCHEME_ED, 2);
317
334
  if (parts === false) return false;
318
335
  const [mldsaPk, edPk] = parts;
@@ -323,8 +340,8 @@ export const hybridSign = {
323
340
  const mPrime = _buildMprime(LABEL_ED, message, context);
324
341
  const sigMl = signature.subarray(0, MLDSA_SIG);
325
342
  const sigEd = signature.subarray(MLDSA_SIG);
326
- const okMl = MLDSA.verify(sigMl, mPrime, mldsaPk, LABEL_ED);
327
- const okEd = ed25519.verify(edPk, mPrime, sigEd);
343
+ const okMl = MLDSA.verify(mldsaPk, sigMl, mPrime, LABEL_ED);
344
+ const okEd = ed25519.verify(edPk, sigEd, mPrime);
328
345
  return okMl === true && okEd === true; // AND — both MUST hold
329
346
  }
330
347
 
@@ -358,7 +375,7 @@ export const hybridSign = {
358
375
  const context = ctx || new Uint8Array(0);
359
376
  if (context.length > 255) return false;
360
377
  const mPrime = _buildMprime(LABEL_EC, message, context);
361
- const sigMl = MLDSA.sign(mPrime, mldsaSk, LABEL_EC);
378
+ const sigMl = MLDSA.sign(mldsaSk, mPrime, LABEL_EC);
362
379
  if (sigMl === false) return false;
363
380
  const secObj = ecc.deserialize({ type: 'ecdsa', secretKey: true, curve: 'c256', exponent: _toHex(ecSk) });
364
381
  if (secObj === false) return false;
@@ -369,7 +386,7 @@ export const hybridSign = {
369
386
  return _concat([sigMl, _u16(der.length), der]); // length-prefixed DER
370
387
  }
371
388
 
372
- function _ecVerify(publicKey, message, signature, ctx) {
389
+ function _ecVerify(publicKey, signature, message, ctx) {
373
390
  const parts = _decodeTlv(publicKey, SCHEME_EC, 2);
374
391
  if (parts === false) return false;
375
392
  const [mldsaPk, ecPk] = parts;
@@ -382,7 +399,7 @@ export const hybridSign = {
382
399
  const mPrime = _buildMprime(LABEL_EC, message, context);
383
400
  const sigMl = signature.subarray(0, MLDSA_SIG);
384
401
  const der = signature.subarray(MLDSA_SIG + 2);
385
- const okMl = MLDSA.verify(sigMl, mPrime, mldsaPk, LABEL_EC);
402
+ const okMl = MLDSA.verify(mldsaPk, sigMl, mPrime, LABEL_EC);
386
403
  if (okMl !== true) return false;
387
404
  const rs = _derToRs(der);
388
405
  if (rs === false) return false;
@@ -394,7 +411,65 @@ export const hybridSign = {
394
411
  return okEc === true;
395
412
  }
396
413
 
397
- return {
414
+ // ══════════════════ Composite seam (§3) ══════════════════════
415
+ /**
416
+ * `fromComponents` / `toComponents` for one variant. The containers are
417
+ * the ones `keygen` / `sign` produce: the TLV keys, and the signature
418
+ * as fixed slices (Ed25519) or a length-prefixed DER component (ECDSA).
419
+ * Results are copies; malformed input is `false`, never a throw.
420
+ * @param {number} scheme
421
+ * @param {number} tradPk
422
+ * @param {number} tradSk
423
+ * @param {boolean} isEc
424
+ */
425
+ function _seam(scheme, tradPk, tradSk, isEc) {
426
+ const isBytes = (x) => x instanceof Uint8Array;
427
+ const pkOk = (pq, trad) => pq.length === MLDSA_PK && trad.length === tradPk && (!isEc || trad[0] === 0x04);
428
+ const skOk = (pq, trad) => pq.length === MLDSA_SK && trad.length === tradSk;
429
+ const derOk = (der) => der.length <= 0xffff && _derToRs(der) !== false;
430
+
431
+ function fromComponents(kind, parts) {
432
+ if (!parts || !isBytes(parts.pq) || !isBytes(parts.trad)) return false;
433
+ const { pq, trad } = parts;
434
+ if (kind === 'publicKey') return pkOk(pq, trad) ? _encodeTlv(scheme, [pq, trad]) : false;
435
+ if (kind === 'secretKey') return skOk(pq, trad) ? _encodeTlv(scheme, [pq, trad]) : false;
436
+ if (kind === 'signature') {
437
+ if (pq.length !== MLDSA_SIG) return false;
438
+ if (!isEc) return trad.length === ED_SIG ? _concat([pq, trad]) : false;
439
+ return derOk(trad) ? _concat([pq, _u16(trad.length), trad]) : false;
440
+ }
441
+ return false;
442
+ }
443
+
444
+ function toComponents(kind, bytes) {
445
+ if (!isBytes(bytes)) return false;
446
+ if (kind === 'publicKey' || kind === 'secretKey') {
447
+ const p = _decodeTlv(bytes, scheme, 2);
448
+ if (p === false) return false;
449
+ if (!(kind === 'publicKey' ? pkOk : skOk)(p[0], p[1])) return false;
450
+ return { pq: new Uint8Array(p[0]), trad: new Uint8Array(p[1]) };
451
+ }
452
+ if (kind === 'signature') {
453
+ if (!isEc) {
454
+ if (bytes.length !== MLDSA_SIG + ED_SIG) return false;
455
+ return { pq: bytes.slice(0, MLDSA_SIG), trad: bytes.slice(MLDSA_SIG) };
456
+ }
457
+ if (bytes.length < MLDSA_SIG + 2) return false;
458
+ const derLen = (bytes[MLDSA_SIG] << 8) | bytes[MLDSA_SIG + 1];
459
+ if (MLDSA_SIG + 2 + derLen !== bytes.length) return false;
460
+ const der = bytes.slice(MLDSA_SIG + 2);
461
+ return derOk(der) ? { pq: bytes.slice(0, MLDSA_SIG), trad: der } : false;
462
+ }
463
+ return false;
464
+ }
465
+
466
+ return { fromComponents, toComponents };
467
+ }
468
+
469
+ const SEAM_ED = _seam(SCHEME_ED, ED_PK, ED_SK, false);
470
+ const SEAM_EC = _seam(SCHEME_EC, EC_PK, EC_SK, true);
471
+
472
+ return Object.defineProperty({
398
473
  mldsa65_ed25519: {
399
474
  lengths: Object.freeze({
400
475
  mldsaPk: MLDSA_PK, tradPk: ED_PK, mldsaSk: MLDSA_SK, tradSk: ED_SK,
@@ -405,7 +480,9 @@ export const hybridSign = {
405
480
  }),
406
481
  keygen: _edKeygen,
407
482
  sign: _edSign,
408
- verify: _edVerify
483
+ verify: _edVerify,
484
+ fromComponents: SEAM_ED.fromComponents,
485
+ toComponents: SEAM_ED.toComponents
409
486
  },
410
487
  mldsa65_ecdsaP256: {
411
488
  lengths: Object.freeze({
@@ -417,11 +494,13 @@ export const hybridSign = {
417
494
  }),
418
495
  keygen: _ecKeygen,
419
496
  sign: _ecSign,
420
- verify: _ecVerify
421
- },
422
-
423
- // Test-only escape hatch (mirrors ecc._internal). Not a public API.
424
- _internal: {
497
+ verify: _ecVerify,
498
+ fromComponents: SEAM_EC.fromComponents,
499
+ toComponents: SEAM_EC.toComponents
500
+ }
501
+ }, Symbol.for('@awacloud/fw/internal'), {
502
+ // Test-only internals, in the internal slot (core/internal.js): not API.
503
+ value: {
425
504
  buildMprime: _buildMprime,
426
505
  sha512Bytes: _sha512Bytes,
427
506
  ui8ToBa: _ui8ToBa,
@@ -432,6 +511,6 @@ export const hybridSign = {
432
511
  labels: { ed: LABEL_ED, ecdsaP256: LABEL_EC },
433
512
  schemes: { ed: SCHEME_ED, ecdsaP256: SCHEME_EC }
434
513
  }
435
- };
514
+ });
436
515
  }
437
516
  };
@@ -22,23 +22,23 @@ q=8380417 (root 1753, N=256). Public API (`Uint8Array`):
22
22
 
23
23
  - `keygen(seed?)` → `{ publicKey, secretKey }`. seed = 32 bytes; sk in
24
24
  the full FIPS 204 format = packed `(ρ ‖ K ‖ tr ‖ s₁ ‖ s₂ ‖ t₀)`.
25
- - `sign(msg, secretKey, ctx?, rnd?)` → signature (`Uint8Array` or `false`).
25
+ - `sign(secretKey, msg, ctx?, rnd?)` → signature (`Uint8Array` or `false`).
26
26
  ctx ≤ 255 bytes (§5.4 wrapper M' = `0x00 ‖ |ctx| ‖ ctx ‖ msg`). rnd =
27
27
  32 bytes; **zero by default (deterministic)**, hedged mode if supplied.
28
- - `verify(sig, msg, publicKey, ctx?)` → `true | false`. Constant-time
28
+ - `verify(publicKey, sig, msg, ctx?)` → `true | false`. Constant-time
29
29
  comparison of the recomputed c̃ (accumulated XOR + diff===0, line 733-736).
30
30
 
31
- **Iteration E3 (FIPS 140-3 upgrade plan)**: added the
31
+ Added the
32
32
  **HashML-DSA** variants (FIPS 204 §5.4 algos 4+5), the **internal**
33
33
  interface (§6.2 raw, without the M' wrapper), and the **externalMu**
34
34
  mode (pre-computed mu):
35
- - `signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` / `verifyPh(sig, msg, pk, hashAlg, hashMod, ctx?)`.
35
+ - `signPh(sk, msg, hashAlg, hashMod, ctx?, rnd?)` / `verifyPh(pk, sig, msg, hashAlg, hashMod, ctx?)`.
36
36
  Supported hashes: `SHA2-{224,256,384,512}`, `SHA2-512/{224,256}`,
37
37
  `SHA3-{224,256,384,512}`, `SHAKE-{128,256}` (12 algorithms; DER-encoded
38
38
  OIDs conforming to FIPS 204).
39
- - `_internal.signInternal(M, sk, rnd?)` / `_internal.verifyInternal(sig, M, pk)`:
39
+ - `internalOf(ml_dsa).signInternal(M, sk, rnd?)` / `internalOf(ml_dsa).verifyInternal(sig, M, pk)`:
40
40
  bypasses the §5.4 M' wrapper (M is used as the raw message bytes).
41
- - `_internal.signWithMu(mu, sk, rnd?)` / `_internal.verifyWithMu(sig, mu, pk)`:
41
+ - `internalOf(ml_dsa).signWithMu(mu, sk, rnd?)` / `internalOf(ml_dsa).verifyWithMu(sig, mu, pk)`:
42
42
  skips the mu = SHAKE256(tr || M, 64) derivation; the caller supplies mu.
43
43
 
44
44
  ## Test coverage
@@ -48,9 +48,9 @@ mode (pre-computed mu):
48
48
  | Source | ACVP reference | Test (`describe`) | Property verified |
49
49
  |---|---|---|---|
50
50
  | NIST CAVP / ACVP | `ML-DSA-keyGen-FIPS204` (9/75 sub-samples) | `ML-DSA-keyGen-FIPS204 (...9 sub-samples)` | `keygen(seed) == (pk, sk)` byte-exact |
51
- | NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=true (9/45) | `.../external+pure (deterministic=$det)` | `sign(msg, sk, ctx, 0) == sig` byte-exact (rnd=zeros) |
52
- | NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=false (9/45) | `.../external+pure (deterministic=$det)` | `sign(msg, sk, ctx, rnd) == sig` byte-exact (ACVP rnd) |
53
- | NIST CAVP / ACVP | `ML-DSA-sigVer-FIPS204` external+pure (45/45) | `.../external+pure (45/45 vectors)` | `verify(sig, msg, pk, ctx)` ↔ `testPassed` (mix of valid + 14 failure reasons: modified message/signature/z/commitment/etc.) |
51
+ | NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=true (9/45) | `.../external+pure (deterministic=$det)` | `sign(sk, msg, ctx, 0) == sig` byte-exact (rnd=zeros) |
52
+ | NIST CAVP / ACVP | `ML-DSA-sigGen-FIPS204` external+pure deterministic=false (9/45) | `.../external+pure (deterministic=$det)` | `sign(sk, msg, ctx, rnd) == sig` byte-exact (ACVP rnd) |
53
+ | NIST CAVP / ACVP | `ML-DSA-sigVer-FIPS204` external+pure (45/45) | `.../external+pure (45/45 vectors)` | `verify(pk, sig, msg, ctx)` ↔ `testPassed` (mix of valid + 14 failure reasons: modified message/signature/z/commitment/etc.) |
54
54
  | Pre-existing (Wycheproof) | ML-DSA-65 KAT keygen/sign/verify "Hello world" | `ML-DSA-65 KAT` | byte-exact pk + sign + verify |
55
55
  | Pre-existing | round-trip 44/65/87 | `ML-DSA-{44,65,87} round-trip` | `verify(sign(msg)) == true` |
56
56
  | Pre-existing | tampering signature | `ML-DSA-65 verify rejects tampered signature` | bit-flip rejection |
@@ -78,7 +78,7 @@ mode (pre-computed mu):
78
78
  hint, response, public key bit-flip}`).
79
79
  - [x] **No `throw`** — early return + `console.warn/error` (review
80
80
  lines 480-557, 670-680).
81
- - [x] **HashML-DSA (preHash variant)** ✅ **Iteration E3** — implemented.
81
+ - [x] **HashML-DSA (preHash variant)** ✅ implemented.
82
82
  `signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` / `verifyPh` apply
83
83
  PH(msg) with the injected hash + the FIPS 204 §5.4 algo 4 wrapper
84
84
  (`0x01 || |ctx| || ctx || OID(hashAlg) || PH(msg)`). 12 hashAlg
@@ -86,12 +86,12 @@ mode (pre-computed mu):
86
86
  SHAKE-{128,256}). **9 SigGen + 45 SigVer ACVP vectors byte-exact**
87
87
  (3/group sub-sample across 3 paramSets for SigGen, full coverage
88
88
  for SigVer).
89
- - [x] **"internal" interface** ✅ **Iteration E3** — exposed via
90
- `_internal.signInternal(M, sk, rnd?)` and `_internal.verifyInternal`.
89
+ - [x] **"internal" interface** ✅ exposed via
90
+ `internalOf(ml_dsa).signInternal(M, sk, rnd?)` and `internalOf(ml_dsa).verifyInternal`.
91
91
  Bypasses the §5.4 wrapper; M is passed as-is to mu = SHAKE256(tr||M, 64).
92
92
  **9 ACVP vectors byte-exact** (3/paramSet sub-sample).
93
- - [x] **externalMu** ✅ **Iteration E3** — exposed via
94
- `_internal.signWithMu(mu, sk, rnd?)` and `_internal.verifyWithMu`.
93
+ - [x] **externalMu** ✅ exposed via
94
+ `internalOf(ml_dsa).signWithMu(mu, sk, rnd?)` and `internalOf(ml_dsa).verifyWithMu`.
95
95
  Skips the mu derivation; the caller supplies the pre-computed mu
96
96
  (typically `SHAKE256(tr || M, 64)`). **9 ACVP vectors byte-exact**.
97
97
  - [ ] **Side-channel NTT/sampling** — not formally constant-time
@@ -122,11 +122,11 @@ mode (pre-computed mu):
122
122
  270 vectors = ~25 s per group, exceeding the module's 30 s budget.
123
123
  Sub-sampling preserves tcId diversity across the 6 external+pure
124
124
  groups. sigVer is exhaustive (45/45 in-scope, ~3-4 ms/op).
125
- **Iteration H3**: `CRYPTO_FULL=1` enables 75/75 keyGen + 45/45 sigVer
125
+ `CRYPTO_FULL=1` enables 75/75 keyGen + 45/45 sigVer
126
126
  external+pure + 90/90 sigGen external+pure → 364 tests in ~4 s; the
127
- preHash / internal / externalMu variants remain E3 sub-sampled
127
+ preHash / internal / externalMu variants remain sub-sampled
128
128
  (already fully covered per variant).
129
- - ~~**Out of scope**~~ ✅ **Iteration E3** — HashML-DSA + internal
129
+ - ~~**Out of scope**~~ ✅ HashML-DSA + internal
130
130
  interface + externalMu are now all implemented and validated ACVP
131
131
  byte-exact. See the `[x]` checks above.
132
132
  - **NTT not formally CT**: Int32, branches depending only on
@@ -137,7 +137,7 @@ mode (pre-computed mu):
137
137
  ## Cross-references
138
138
 
139
139
  - Module: [`pkc/ml_dsa.js`](./ml_dsa.js)
140
- - Tests: [`pkc/ml_dsa.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ml_dsa.test.js) — 154 tests (82 baseline + 72 iteration E3: 9 sigGen-ph + 9 internal + 9 externalMu + 45 sigVer-ph)
140
+ - Tests: [`pkc/ml_dsa.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ml_dsa.test.js) — 154 tests (82 baseline + 72 more: 9 sigGen-ph + 9 internal + 9 externalMu + 45 sigVer-ph)
141
141
  - Pre-existing KAT: [`pkc/ml_dsa.kat.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/ml_dsa.kat.js) (Wycheproof "Hello world" ML-DSA-65)
142
142
  - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-ml-dsa.adoc`
143
143
  - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ML-DSA-*-FIPS204/`
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -10,14 +10,15 @@
10
10
  *
11
11
  * Public API per parameter set:
12
12
  * keygen(seed32?) → { publicKey, secretKey }
13
- * sign(msg, sk, ctx?, rnd?) → signature (or false on internal failure)
14
- * verify(sig, msg, pk, ctx?) → boolean
13
+ * sign(sk, msg, ctx?, rnd?) → signature (or false on internal failure)
14
+ * verify(pk, sig, msg, ctx?) → boolean
15
15
  *
16
16
  * Determinism:
17
17
  * - keygen(seed) is deterministic.
18
- * - sign(msg, sk, ctx, rnd=zeros) is deterministic ("ML-DSA hedged with
19
- * zero entropy", aka the FIPS 204 deterministic mode).
20
- * - With no rnd, 32 random bytes are drawn from the CSPRNG.
18
+ * - With no rnd, sign draws 32 random bytes: the hedged variant FIPS 204
19
+ * §3.4 recommends (fault and side-channel resistance), so two signatures
20
+ * of one message differ. Pass 32 zero bytes as rnd for the FIPS 204
21
+ * deterministic mode (KAT vectors, reproducible signatures).
21
22
  *
22
23
  * Hash bindings (FIPS 204 §3.7):
23
24
  * H_eta uses SHAKE256 (CRH 64 bytes for tr / mu / rhoprime).
@@ -49,11 +50,10 @@ import { random } from '../utils/random.js';
49
50
  * @typedef {object} MlDsaInstance
50
51
  * @property {MlDsaLengths} lengths Byte sizes of every artefact.
51
52
  * @property {(seed?: Uint8Array) => ({ publicKey: Uint8Array, secretKey: Uint8Array }|false)} keygen Generate a key pair (deterministic for a 32-byte seed).
52
- * @property {(msg: Uint8Array, secretKey: Uint8Array, ctx?: Uint8Array, rnd?: Uint8Array) => (Uint8Array|false)} sign Pure ML-DSA sign.
53
- * @property {(sig: Uint8Array, msg: Uint8Array, publicKey: Uint8Array, ctx?: Uint8Array) => boolean} verify Pure ML-DSA verify.
54
- * @property {(msg: Uint8Array, secretKey: Uint8Array, hashAlg: string, hashMod: ({hash: Function, shake?: Function}|Function|null), ctx?: Uint8Array, rnd?: Uint8Array) => (Uint8Array|false)} signPh HashML-DSA sign.
55
- * @property {(sig: Uint8Array, msg: Uint8Array, publicKey: Uint8Array, hashAlg: string, hashMod: ({hash: Function, shake?: Function}|Function|null), ctx?: Uint8Array) => boolean} verifyPh HashML-DSA verify.
56
- * @property {{ signInternal: Function, verifyInternal: Function, signWithMu: Function, verifyWithMu: Function, wrapMessage: Function, wrapMessageHash: Function, computePh: Function }} _internal Test-only escape hatches.
53
+ * @property {(secretKey: Uint8Array, msg: Uint8Array, ctx?: Uint8Array, rnd?: Uint8Array) => (Uint8Array|false)} sign Pure ML-DSA sign (the fw order: key, message).
54
+ * @property {(publicKey: Uint8Array, sig: Uint8Array, msg: Uint8Array, ctx?: Uint8Array) => boolean} verify Pure ML-DSA verify (the fw order: key, signature, message).
55
+ * @property {(secretKey: Uint8Array, msg: Uint8Array, hashAlg: string, hashMod: ({hash: Function, shake?: Function}|Function|null), ctx?: Uint8Array, rnd?: Uint8Array) => (Uint8Array|false)} signPh HashML-DSA sign.
56
+ * @property {(publicKey: Uint8Array, sig: Uint8Array, msg: Uint8Array, hashAlg: string, hashMod: ({hash: Function, shake?: Function}|Function|null), ctx?: Uint8Array) => boolean} verifyPh HashML-DSA verify.
57
57
  */
58
58
 
59
59
  /**
@@ -62,8 +62,6 @@ import { random } from '../utils/random.js';
62
62
  * @property {MlDsaInstance} ml_dsa44 ML-DSA-44 instance.
63
63
  * @property {MlDsaInstance} ml_dsa65 ML-DSA-65 instance.
64
64
  * @property {MlDsaInstance} ml_dsa87 ML-DSA-87 instance.
65
- * @property {(f: Int32Array) => Int32Array} _ntt Test-only NTT.
66
- * @property {(f: Int32Array) => Int32Array} _nttInv Test-only inverse NTT.
67
65
  */
68
66
 
69
67
  export const ml_dsa = {
@@ -578,8 +576,6 @@ export const ml_dsa = {
578
576
  }
579
577
 
580
578
  // ── HashML-DSA wrapper (FIPS 204 §5.4 Algorithm 4) ──────────
581
- // Iteration E3 of the FIPS 140-3 upgrade plan.
582
- //
583
579
  // M' = 0x01 || OctetEncode(|ctx|, 1) || ctx || OID(hashAlg) || PH(message)
584
580
  //
585
581
  // OID is the DER-encoded ASN.1 OBJECT IDENTIFIER of the hash
@@ -630,8 +626,7 @@ export const ml_dsa = {
630
626
 
631
627
  // ── sign (FIPS 204 Algorithm 2 / §6.2) ──────────────────
632
628
 
633
- // Iteration E3 of the FIPS 140-3 upgrade plan - sign refactor:
634
- // extract `_signFromMu(mu, sk, rnd)` so callers may bypass the
629
+ // `_signFromMu(mu, sk, rnd)` is extracted so callers may bypass the
635
630
  // §5.4 wrapping (internal interface) or supply a pre-computed mu
636
631
  // (externalMu, useful when the same key signs many messages with
637
632
  // a shared `tr`-based prefix).
@@ -659,7 +654,7 @@ export const ml_dsa = {
659
654
  console.warn('[crypto] INVALID: ml_dsa: wrong secretKey length');
660
655
  return false;
661
656
  }
662
- const _rnd = rnd || new Uint8Array(32);
657
+ const _rnd = rnd || random.bytes(32);
663
658
  if (_rnd.length !== 32) {
664
659
  console.warn('[crypto] INVALID: ml_dsa: rnd must be 32 bytes');
665
660
  return false;
@@ -793,7 +788,7 @@ export const ml_dsa = {
793
788
  * Wraps the message with the §5.4 prefix `0x00 || |ctx| || ctx ||
794
789
  * msg` then calls the internal signing path.
795
790
  */
796
- function sign(msg, secretKey, ctx, rnd) {
791
+ function sign(secretKey, msg, ctx, rnd) {
797
792
  const M = _wrapMessage(msg, ctx);
798
793
  if (M === false) return false;
799
794
  return _signInternal(M, secretKey, rnd);
@@ -813,7 +808,7 @@ export const ml_dsa = {
813
808
  * @param {Uint8Array} [ctx]
814
809
  * @param {Uint8Array} [rnd]
815
810
  */
816
- function signPh(msg, secretKey, hashAlg, hashMod, ctx, rnd) {
811
+ function signPh(secretKey, msg, hashAlg, hashMod, ctx, rnd) {
817
812
  const ph = _computePh(msg, hashAlg, hashMod);
818
813
  if (ph === false) return false;
819
814
  const M = _wrapMessageHash(ph, ctx, hashAlg);
@@ -928,14 +923,14 @@ export const ml_dsa = {
928
923
  }
929
924
 
930
925
  /** Pure ML-DSA verify (FIPS 204 §5.4 PureML-DSA + §6.3). */
931
- function verify(sig, msg, publicKey, ctx) {
926
+ function verify(publicKey, sig, msg, ctx) {
932
927
  const M = _wrapMessage(msg, ctx);
933
928
  if (M === false) return false;
934
929
  return _verifyInternal(sig, M, publicKey);
935
930
  }
936
931
 
937
932
  /** HashML-DSA verify (FIPS 204 §5.4 Algorithm 5). */
938
- function verifyPh(sig, msg, publicKey, hashAlg, hashMod, ctx) {
933
+ function verifyPh(publicKey, sig, msg, hashAlg, hashMod, ctx) {
939
934
  const ph = _computePh(msg, hashAlg, hashMod);
940
935
  if (ph === false) return false;
941
936
  const M = _wrapMessageHash(ph, ctx, hashAlg);
@@ -943,19 +938,20 @@ export const ml_dsa = {
943
938
  return _verifyInternal(sig, M, publicKey);
944
939
  }
945
940
 
946
- return {
941
+ return Object.defineProperty({
947
942
  lengths: Object.freeze({
948
943
  publicKey: PK_LEN, secretKey: SK_LEN, signature: SIG_LEN, seed: 32
949
944
  }),
950
945
  keygen, sign, verify,
951
- // Iteration E3 of the FIPS 140-3 upgrade plan - HashML-DSA
946
+ // HashML-DSA
952
947
  // (FIPS 204 §5.4 Algorithms 4 + 5).
953
- signPh, verifyPh,
948
+ signPh, verifyPh
949
+ }, Symbol.for('@awacloud/fw/internal'), {
954
950
  // Internal escape hatches (test-only). signInternal and
955
951
  // verifyInternal expose the §6.2/§6.3 raw paths (no §5.4
956
952
  // wrapping). signWithMu / verifyWithMu accept a pre-computed
957
953
  // mu for the externalMu API mode.
958
- _internal: {
954
+ value: {
959
955
  signInternal: _signInternal,
960
956
  verifyInternal: _verifyInternal,
961
957
  signWithMu: _signFromMu,
@@ -964,7 +960,7 @@ export const ml_dsa = {
964
960
  wrapMessageHash: _wrapMessageHash,
965
961
  computePh: _computePh
966
962
  }
967
- };
963
+ });
968
964
  }
969
965
 
970
966
  const PARAMS = {
@@ -973,12 +969,13 @@ export const ml_dsa = {
973
969
  87: { K: 8, L: 7, GAMMA1: 1 << 19, GAMMA2: GAMMA2_2, TAU: 60, ETA: 2, OMEGA: 75, C_TILDE_BYTES: 64 }
974
970
  };
975
971
 
976
- return {
972
+ return Object.defineProperty({
977
973
  ml_dsa44: _make(PARAMS[44]),
978
974
  ml_dsa65: _make(PARAMS[65]),
979
- ml_dsa87: _make(PARAMS[87]),
980
- // exposed for testing
981
- _ntt, _nttInv
982
- };
975
+ ml_dsa87: _make(PARAMS[87])
976
+ }, Symbol.for('@awacloud/fw/internal'), {
977
+ // Internal (test-only, outside the API).
978
+ value: { ntt: _ntt, nttInv: _nttInv }
979
+ });
983
980
  }
984
981
  };
@@ -29,9 +29,9 @@ on top of K-PKE (§5) with NTT modulo q=3329 (ζ=17). Public API (`Uint8Array`):
29
29
 
30
30
  Internal API (test-only, added for ACVP `*KeyCheck`):
31
31
 
32
- - `<variant>._internal.isValidEncapsulationKey(ek)` — §7.2 input
32
+ - `internalOf(<variant>).isValidEncapsulationKey(ek)` — §7.2 input
33
33
  validation: length + modulus-q (ByteEncode∘ByteDecode round-trip).
34
- - `<variant>._internal.isValidDecapsulationKey(dk)` — §7.3 input
34
+ - `internalOf(<variant>).isValidDecapsulationKey(dk)` — §7.3 input
35
35
  validation: length + consistency H(ek_embedded) == ek_hash_embedded.
36
36
 
37
37
  ## Test coverage
@@ -43,8 +43,8 @@ Internal API (test-only, added for ACVP `*KeyCheck`):
43
43
  | NIST CAVP / ACVP | `ML-KEM-keyGen-FIPS203` (9/75 sub-samples) | `ML-KEM-keyGen-FIPS203 (...9 sub-samples)` | `keygen(d‖z) == (ek, dk)` byte-exact (3 paramSets × first/mid/last) |
44
44
  | NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=encapsulation` (9/75 sub-samples, AFT) | `.../encapsulation` | `encapsulate(ek, m) == (c, k)` byte-exact |
45
45
  | NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=decapsulation` (9/30 sub-samples, VAL) | `.../decapsulation` | `decapsulate(c, dk) == k` (covers the implicit-reject branch on corrupted ct) |
46
- | NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=decapsulationKeyCheck` (30/30 VAL) | `.../decapsulationKeyCheck` | `_internal.isValidDecapsulationKey(dk)` ↔ `testPassed` (5 pass + 5 fail / paramSet) |
47
- | NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=encapsulationKeyCheck` (30/30 VAL) | `.../encapsulationKeyCheck` | `_internal.isValidEncapsulationKey(ek)` ↔ `testPassed` (5 pass + 5 fail / paramSet) |
46
+ | NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=decapsulationKeyCheck` (30/30 VAL) | `.../decapsulationKeyCheck` | `internalOf(ml_kem).isValidDecapsulationKey(dk)` ↔ `testPassed` (5 pass + 5 fail / paramSet) |
47
+ | NIST CAVP / ACVP | `ML-KEM-encapDecap` `function=encapsulationKeyCheck` (30/30 VAL) | `.../encapsulationKeyCheck` | `internalOf(ml_kem).isValidEncapsulationKey(ek)` ↔ `testPassed` (5 pass + 5 fail / paramSet) |
48
48
  | Pre-existing (noble-post-quantum) | ML-KEM-768 KAT keygen+encaps | `ML-KEM-768 KAT` | byte-exact ek/sk + ss=K |
49
49
  | Pre-existing | round-trip 512/768/1024 | `ML-KEM-{512,768,1024} round-trip` | `decapsulate(encapsulate(ek), sk) == K` |
50
50
  | Pre-existing | implicit reject | `ML-KEM-768 implicit reject on tampered ciphertext` | different ss but still 32 bytes |
@@ -87,8 +87,8 @@ and decapsulation (10/group) are sub-sampled as `[first, mid, last]`
87
87
  | Deterministic generation (seed) | ✅ | byte-exact on 9 ACVP keyGen vectors |
88
88
  | Deterministic encapsulation (fixed m) | ✅ | byte-exact on 9 ACVP encap vectors |
89
89
  | Decapsulation + implicit reject | ✅ | 9 ACVP decap vectors + tampering test |
90
- | Public validation (§7.2 ek) | ✅ | `_internal.isValidEncapsulationKey` + 30 vectors |
91
- | Private validation (§7.3 dk) | ✅ | `_internal.isValidDecapsulationKey` + 30 vectors |
90
+ | Public validation (§7.2 ek) | ✅ | `internalOf(ml_kem).isValidEncapsulationKey` + 30 vectors |
91
+ | Private validation (§7.3 dk) | ✅ | `internalOf(ml_kem).isValidDecapsulationKey` + 30 vectors |
92
92
  | Power-on KAT / self-test | N/A | permanent KATs via 18 deterministic vectors |
93
93
  | CT comparisons (secret) | ✅ | `_ctEqual` throughout (modulus, hash, reject mask) |
94
94
  | No `throw` / timing leak | ✅ | Review: `console.warn/error` + `return false` |
@@ -97,7 +97,7 @@ and decapsulation (10/group) are sub-sampled as `[first, mid, last]`
97
97
  ## Known limitations
98
98
 
99
99
  - **[first/mid/last] sub-sampling** by default: 9/75 keyGen, 9/75 encap,
100
- 9/30 decap (CI budget < 1 s). **Iteration H3**: `CRYPTO_FULL=1` enables
100
+ 9/30 decap (CI budget < 1 s). `CRYPTO_FULL=1` enables
101
101
  the full 75 keyGen + 165 encapDecap (encapsulation, decapsulation,
102
102
  encapsulationKeyCheck, decapsulationKeyCheck) → 336 tests in ~0.5 s via
103
103
  direct loading of the `internalProjection.json` + `expectedResults.json`.
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -55,7 +55,6 @@ import { random } from '../utils/random.js';
55
55
  * @property {(seed?: Uint8Array) => ({ publicKey: Uint8Array, secretKey: Uint8Array }|false)} keygen Generate a key pair (deterministic for a 64-byte seed).
56
56
  * @property {(publicKey: Uint8Array, msg?: Uint8Array) => ({ cipherText: Uint8Array, sharedSecret: Uint8Array }|false)} encapsulate Encapsulate to a public key.
57
57
  * @property {(cipherText: Uint8Array, secretKey: Uint8Array) => (Uint8Array|false)} decapsulate Decapsulate; 32-byte shared secret.
58
- * @property {{ isValidEncapsulationKey: (ek: Uint8Array) => boolean, isValidDecapsulationKey: (dk: Uint8Array) => boolean }} _internal Validation helpers.
59
58
  */
60
59
 
61
60
  /**
@@ -64,15 +63,6 @@ import { random } from '../utils/random.js';
64
63
  * @property {MlKemInstance} ml_kem512 ML-KEM-512 instance.
65
64
  * @property {MlKemInstance} ml_kem768 ML-KEM-768 instance.
66
65
  * @property {MlKemInstance} ml_kem1024 ML-KEM-1024 instance.
67
- * @property {(f: Uint16Array) => Uint16Array} _ntt Test-only NTT.
68
- * @property {(f: Uint16Array) => Uint16Array} _nttInv Test-only inverse NTT.
69
- * @property {(out: Uint16Array, a: Uint16Array, b: Uint16Array) => Uint16Array} _multiplyNTTs Test-only pointwise product.
70
- * @property {(prfBytes: Uint8Array, eta: number) => Uint16Array} _sampleCBD Test-only CBD sampler.
71
- * @property {(rho: Uint8Array, j: number, i: number) => Uint16Array} _sampleNTT Test-only NTT sampler.
72
- * @property {(poly: Uint16Array, d: number) => Uint8Array} _byteEncode Test-only encoder.
73
- * @property {(bytes: Uint8Array, d: number) => Uint16Array} _byteDecode Test-only decoder.
74
- * @property {(x: number, d: number) => number} _compress Test-only compress.
75
- * @property {(y: number, d: number) => number} _decompress Test-only decompress.
76
66
  */
77
67
 
78
68
  export const ml_kem = {
@@ -572,10 +562,11 @@ export const ml_kem = {
572
562
  return _ctEqual(h, ekHash);
573
563
  }
574
564
 
575
- return {
576
- lengths, keygen, encapsulate, decapsulate,
577
- _internal: { isValidEncapsulationKey, isValidDecapsulationKey }
578
- };
565
+ return Object.defineProperty({
566
+ lengths, keygen, encapsulate, decapsulate
567
+ }, Symbol.for('@awacloud/fw/internal'), {
568
+ value: { isValidEncapsulationKey, isValidDecapsulationKey }
569
+ });
579
570
  }
580
571
 
581
572
  const PARAMS = {
@@ -584,13 +575,16 @@ export const ml_kem = {
584
575
  1024: { K: 4, ETA1: 2, ETA2: 2, du: 11, dv: 5 }
585
576
  };
586
577
 
587
- return {
578
+ return Object.defineProperty({
588
579
  ml_kem512: _make(PARAMS[512]),
589
580
  ml_kem768: _make(PARAMS[768]),
590
- ml_kem1024: _make(PARAMS[1024]),
591
- // exposed for testing
592
- _ntt, _nttInv, _multiplyNTTs, _sampleCBD, _sampleNTT,
593
- _byteEncode, _byteDecode, _compress, _decompress
594
- };
581
+ ml_kem1024: _make(PARAMS[1024])
582
+ }, Symbol.for('@awacloud/fw/internal'), {
583
+ // Internal (test-only, outside the API).
584
+ value: {
585
+ ntt: _ntt, nttInv: _nttInv, multiplyNTTs: _multiplyNTTs, sampleCBD: _sampleCBD, sampleNTT: _sampleNTT,
586
+ byteEncode: _byteEncode, byteDecode: _byteDecode, compress: _compress, decompress: _decompress
587
+ }
588
+ });
595
589
  }
596
590
  };