@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
@@ -19,19 +19,22 @@ FIPS 186-5 + RFC 6979 compliant ECDSA (deterministic k via HMAC-DRBG, eliminates
19
19
 
20
20
  ```js
21
21
  const ecc = runtime.resolve('ecc');
22
- // Returns: { curves, publicKey, secretKey, sign, verify, deserialize, _internal }
22
+ // Returns: { ecdsa, elGamal, curves, curveName, deserialize, basicKey, curve, point, pointJac }
23
23
  ```
24
24
 
25
25
  ## API
26
26
 
27
- | Method | Signature | Returns |
27
+ | Member | Signature | Returns |
28
28
  |--------|-----------|---------|
29
- | `curves` | `{c192, c224, c256, c384, c521, k192, k224, k256, k283, k409, k571}` | Available curves |
30
- | `secretKey(curve, exponent)` | — | `{exponent, publicKey, sign, verify}` |
31
- | `publicKey(curve, point)` | — | `{point, verify}` |
32
- | `sign(hash, opts?)` | `(bitArray, {strict?, hashForK?, deterministic?}) => Object` | `{r, s}` (deterministic by default) |
33
- | `verify(hash, rs, opts?)` | `(bitArray, {r,s}, {strict?, fakeLegacyVersion?}) => boolean` | Constant-time |
34
- | `deserialize(bits, curveName)` | — | Public key (subgroup-checked) |
29
+ | `curves` | `{c192, c224, c256, c384, c521, k192, k224, k256}` | The registered curves: P-192 … P-521 and secp192k1 / secp224k1 / secp256k1 |
30
+ | `curveName(curve)` | `(curve) => string \| false` | The registry key of a curve instance (`'c256'`) |
31
+ | `ecdsa.generateKeys(curve, paranoia?, sec?)` | `(number \| curve, number?, bn?) => {pub, sec} \| false` | A key pair; a number is a curve size (`256` → `curves.c256`) |
32
+ | `ecdsa.secretKey` / `ecdsa.publicKey` | constructors `(curve, exponent)` / `(curve, point)` | Key objects (prefer `generateKeys` / `deserialize`) |
33
+ | `sec.sign(hash, opts?)` | `(bitArray, {strict?, hashForK?, deterministic?}) => bitArray` | `r ‖ s` (deterministic RFC 6979 by default) |
34
+ | `pub.verify(hash, rs, opts?)` | `(bitArray, bitArray, {strict?, fakeLegacyVersion?}) => boolean` | `true`, or `false` on any invalid input |
35
+ | `elGamal.generateKeys(curve, paranoia?, sec?)` | as `ecdsa` | ECDH key pair: `sec.dh(pub)`, `pub.kem()` → `{key, tag}`, `sec.unkem(tag)` |
36
+ | `deserialize(key)` | `({type: 'ecdsa'\|'elGamal', curve, point \| exponent, secretKey?}) => key \| false` | A public key (subgroup-checked) or a secret key; `point` is the hex of `x ‖ y`, `exponent` hex, `curve` a `curves` key |
37
+ | `basicKey`, `curve`, `point`, `pointJac` | constructors | The low-level key, curve and point classes the keys are built on |
35
38
 
36
39
  ### Options
37
40
 
@@ -46,22 +49,21 @@ const ecc = runtime.resolve('ecc');
46
49
  ```js
47
50
  const { ecc, sha256 } = fw.runtime.resolveAll(['ecc', 'sha256']);
48
51
 
49
- const sk = ecc.secretKey(ecc.curves.c256);
50
- const pk = sk.publicKey;
52
+ const { pub, sec } = ecc.ecdsa.generateKeys(256);
51
53
 
52
54
  const hashBa = sha256.hash('message');
53
- const sig = sk.sign(hashBa); // deterministic RFC 6979
54
- const ok = pk.verify(hashBa, sig); // true
55
+ const sig = sec.sign(hashBa); // deterministic RFC 6979
56
+ const ok = pub.verify(hashBa, sig); // true
55
57
 
56
58
  // Strict mode (low-s)
57
- const sigStrict = sk.sign(hashBa, { strict: true });
58
- const okStrict = pk.verify(hashBa, sigStrict, { strict: true });
59
+ const sigStrict = sec.sign(hashBa, { strict: true });
60
+ const okStrict = pub.verify(hashBa, sigStrict, { strict: true });
59
61
  ```
60
62
 
61
63
  ### Subgroup check (deserialize)
62
64
 
63
65
  ```js
64
- const pkPoint = ecc.deserialize(rawBytes, 'c256'); // false if point is outside the subgroup
66
+ const pk = ecc.deserialize({ type: 'ecdsa', curve: 'c256', point: hexPoint }); // false if the point is outside the subgroup
65
67
  ```
66
68
 
67
69
  ## Worker Usage
@@ -69,7 +71,7 @@ const pkPoint = ecc.deserialize(rawBytes, 'c256'); // false if point is outsid
69
71
  ```js
70
72
  const worker = fw.createWorker(
71
73
  function ({ libs, args }) {
72
- const sk = libs.ecc.secretKey(libs.ecc.curves.c256, args[0]);
74
+ const sk = libs.ecc.deserialize({ type: 'ecdsa', secretKey: true, curve: 'c256', exponent: args[0] });
73
75
  self.postMessage(sk.sign(args[1]));
74
76
  },
75
77
  { dependencies: ['ecc'], args: [exponent, hashBa] }
@@ -82,7 +84,7 @@ const worker = fw.createWorker(
82
84
  - **Scalar mult NOT constant-time**: 4-bit windowed method with pre-computed multiple table — the index is the scalar nibble, observable via cache-timing (Bernstein 2005). Acceptable in a browser without a co-resident adversary; for multi-tenant servers prefer WebCrypto `subtle.*` or X25519/Ed25519.
83
85
  - **Subgroup check FIPS 186-5 §A.4.2**: `deserialize` rejects points outside the subgroup of order `n` (~1-3 ms per P-256).
84
86
  - **P-521 RFC 6979** byte-exact (fixes the `bn.bitLength() = 528` rounding bug via the `_trueBitLength` helper).
85
- - **K-curves (Koblitz)**: covered (k192, k224, k256, k283, k409, k571) but deprecated by NIST SP 800-186 — prefer P-curves.
87
+ - **K-curves (Koblitz)**: k192, k224 and k256 (secp192k1 / secp224k1 / secp256k1) — prefer the P-curves.
86
88
 
87
89
  ## See also
88
90
 
@@ -19,7 +19,7 @@ EdDSA over Curve25519 (cofactor 8). Faster than ECDSA, deterministic by construc
19
19
 
20
20
  ```js
21
21
  const ed25519 = runtime.resolve('ed25519');
22
- // Returns: { keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx, ed448 }
22
+ // Returns: { keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx }
23
23
  ```
24
24
 
25
25
  ## API
@@ -28,12 +28,11 @@ const ed25519 = runtime.resolve('ed25519');
28
28
  |--------|-----------|---------|
29
29
  | `keyPair(seed)` | `(Uint8Array(32)) => {publicKey, privateKey} \| false` | Derives the pair from the seed; `false` if seed absent or ≠ 32 bytes |
30
30
  | `sign(privateKey, msg)` | `(Uint8Array(64), Uint8Array) => Uint8Array(64) \| false` | Pure Ed25519 signature (`privateKey` = seed ‖ pubKey, 64 bytes) |
31
- | `verify(publicKey, msg, sig)` | `(Uint8Array(32), Uint8Array, Uint8Array(64)) => boolean` | Verifies + rejects s≥L constant-time |
31
+ | `verify(publicKey, sig, msg)` | `(Uint8Array(32), Uint8Array(64), Uint8Array) => boolean` | Verifies + rejects s≥L constant-time |
32
32
  | `signPh(privateKey, msg, ctx?)` | `(Uint8Array(64), Uint8Array, Uint8Array?) => Uint8Array(64) \| false` | Ed25519ph — pass the **raw message** (SHA-512 applied internally) |
33
- | `verifyPh(publicKey, msg, sig, ctx?)` | — | `boolean` |
33
+ | `verifyPh(publicKey, sig, msg, ctx?)` | — | `boolean` |
34
34
  | `signCtx(privateKey, msg, ctx)` | `(Uint8Array(64), Uint8Array, Uint8Array(1..255)) => Uint8Array(64) \| false` | Ed25519ctx (context required, 1..255 bytes) |
35
- | `verifyCtx(publicKey, msg, sig, ctx)` | — | `boolean` |
36
- | `ed448.{keyPair,sign,verify,signPh,verifyPh}` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
35
+ | `verifyCtx(publicKey, sig, msg, ctx)` | — | `boolean` |
37
36
 
38
37
  ## Examples
39
38
 
@@ -45,7 +44,7 @@ const { privateKey, publicKey } = ed25519.keyPair(random.bytes(32));
45
44
 
46
45
  const msg = new TextEncoder().encode('Hello, EdDSA!');
47
46
  const sig = ed25519.sign(privateKey, msg);
48
- const ok = ed25519.verify(publicKey, msg, sig); // true
47
+ const ok = ed25519.verify(publicKey, sig, msg); // true
49
48
  ```
50
49
 
51
50
  ### Ed25519ph (prehash + dom2)
@@ -53,7 +52,7 @@ const ok = ed25519.verify(publicKey, msg, sig); // true
53
52
  ```js
54
53
  // signPh takes the raw message — SHA-512 is applied internally
55
54
  const sig = ed25519.signPh(privateKey, msg);
56
- const ok = ed25519.verifyPh(publicKey, msg, sig);
55
+ const ok = ed25519.verifyPh(publicKey, sig, msg);
57
56
  ```
58
57
 
59
58
  ### Ed25519ctx (context separation)
@@ -61,14 +60,8 @@ const ok = ed25519.verifyPh(publicKey, msg, sig);
61
60
  ```js
62
61
  const ctx = new TextEncoder().encode('app-v1'); // 1..255 bytes required
63
62
  const sig = ed25519.signCtx(privateKey, msg, ctx);
64
- const ok = ed25519.verifyCtx(publicKey, msg, sig, ctx);
65
- const bad = ed25519.verifyCtx(publicKey, msg, sig, otherCtx); // false
66
- ```
67
-
68
- ### Ed448 rejected
69
-
70
- ```js
71
- ed25519.ed448.keyPair(); // false + console.warn('NOT-IMPLEMENTED: ed25519: Ed448 ...')
63
+ const ok = ed25519.verifyCtx(publicKey, sig, msg, ctx);
64
+ const bad = ed25519.verifyCtx(publicKey, sig, msg, otherCtx); // false
72
65
  ```
73
66
 
74
67
  ## Worker Usage
@@ -90,6 +83,8 @@ const worker = fw.createWorker(
90
83
  - **`keyPair(seed)` — seed required**: `keyPair()` without argument returns `false` + warn. Use `random.bytes(32)` for generation.
91
84
  - **Ed25519ph**: pass the **raw message** — `signPh` applies SHA-512 internally. Do not pre-hash before the call.
92
85
  - **Ed448 not implemented** — edwards448 curve + SHAKE-256; create a separate `ed448.js` module if required for CMVP.
86
+ - **Speed**: `sign` about 0.3-0.5 ms, `verify` about 1.0-1.2 ms (Bun / Node; 46x / 10x and 42x / 13x `node:crypto`). The first `keyPair` / `sign` of a factory also builds the base-point table (256 points, about 4 ms); every later one uses it.
87
+ - **Timing**: secret data never selects a branch, a loop bound or a table index: the base table is read by a full scan merged by mask, the signed digits are recoded with arithmetic only, swaps and negations go through masks. What JavaScript cannot promise — that the engine executes the same arithmetic in the same time for every value — no JS implementation can. `verify` works on public data and uses a variable-time window.
93
88
 
94
89
  ## See also
95
90
 
@@ -124,7 +124,7 @@ const kp = await worker.call('hybridKem.xwing.keygen');
124
124
 
125
125
  ## Positioning & liability
126
126
 
127
- awa ships X-Wing as a **certifiable cryptographic component**, not a certified
127
+ AWA ships X-Wing as a **certifiable cryptographic component**, not a certified
128
128
  product: no ANSSI/FIPS certification of the composite scheme is claimed here. The
129
129
  underlying ML-KEM-768 is ACVP-green (`src/crypto/pkc/ml_kem.acvp.md`); X25519 is
130
130
  RFC 7748 vector-green. Correctness is anchored to the **official IETF X-Wing KAT**
@@ -168,7 +168,13 @@ deterministic, network-free regeneration proof.
168
168
  or key derivation breaks interop — re-pin and re-verify against fresh vectors.
169
169
  - Deterministic for fixed inputs (32-byte seed, 64-byte encaps randomness), which
170
170
  is exactly what the KAT exercises; production callers omit them to draw the
171
- platform CSPRNG.
171
+ platform CSPRNG — `crypto.getRandomValues` directly, not the fw `random`
172
+ module (no DRBG, no SP 800-90B health tests on that path).
173
+ - The standalone `xwing` export (`import { xwing } from '@awacloud/fw/crypto/pkc/hybridKem.js'`)
174
+ builds its default primitives on first use and keeps that one instance at
175
+ module scope: nothing runs at import, and the DI factory stays pure and
176
+ worker-serializable. It is the package's one convenience cache outside a
177
+ factory; resolve `hybridKem` through the runtime for an instance you own.
172
178
 
173
179
  ## See also
174
180
 
@@ -19,7 +19,7 @@ Composes vetted fw primitives into `draft-ietf-lamps-pq-composite-sigs` composit
19
19
 
20
20
  ```js
21
21
  const hybridSign = runtime.resolve('hybridSign');
22
- // Returns: { mldsa65_ed25519, mldsa65_ecdsaP256, _internal }
22
+ // Returns: { mldsa65_ed25519, mldsa65_ecdsaP256 }
23
23
  ```
24
24
 
25
25
  ## Construction (frozen, vector-verified)
@@ -54,7 +54,9 @@ interop vectors.
54
54
  | `<variant>.lengths` | object | Component + container byte lengths |
55
55
  | `<variant>.keygen()` | `() => {publicKey, secretKey}` | TLV-encoded key pair (independent seeds) |
56
56
  | `<variant>.sign(sk, msg, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array?) => Uint8Array \| false` | Composite signature |
57
- | `<variant>.verify(pk, msg, sig, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array, Uint8Array?) => boolean` | AND of both components |
57
+ | `<variant>.verify(pk, sig, msg, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array, Uint8Array?) => boolean` | AND of both components |
58
+ | `<variant>.fromComponents(kind, { pq, trad })` | `('publicKey' \| 'secretKey' \| 'signature', {pq: Uint8Array, trad: Uint8Array}) => Uint8Array \| false` | The container built from its two components (see [Components](#components)) |
59
+ | `<variant>.toComponents(kind, bytes)` | `('publicKey' \| 'secretKey' \| 'signature', Uint8Array) => {pq, trad} \| false` | The two components of a container (copies) |
58
60
 
59
61
  Inputs/outputs are `Uint8Array`; any invalid input returns `false` (sign) or
60
62
  `false` (verify). `ctx` is an optional 0..255-byte application context bound
@@ -73,8 +75,33 @@ into `M'`.
73
75
  `mldsaSig(3309) || u16(derLen) || DER`.
74
76
 
75
77
  The official LAMPS vectors use a plain component concat; the vendored conformance
76
- tests re-frame the exact official component bytes into this container and verify
77
- through the real `verify()` path.
78
+ tests build this container from the exact official component bytes with
79
+ `fromComponents` and verify through the real `verify()` path.
80
+
81
+ ## Components
82
+
83
+ `fromComponents(kind, { pq, trad })` builds a container from components made
84
+ elsewhere — a key from a hardware or external ML-DSA key, the official wire form
85
+ (plain concatenation) of a peer — and `toComponents(kind, bytes)` splits one.
86
+ `pq` is the ML-DSA-65 component; `trad` the traditional one:
87
+
88
+ | `kind` | `pq` | `trad` — Ed25519 | `trad` — ECDSA-P256 |
89
+ |---|---|---|---|
90
+ | `'publicKey'` | 1952 B | 32 B | 65 B, SEC1 uncompressed (`0x04` …) |
91
+ | `'secretKey'` | 4032 B | 64 B (seed ‖ public key) | 32 B scalar |
92
+ | `'signature'` | 3309 B | 64 B | DER `SEQUENCE { r, s }` |
93
+
94
+ A wrong length or form, an unknown `kind` or a container that does not decode is
95
+ `false`. Both return fresh arrays, never views of their input. The structural
96
+ checks are not a key validation: a point off the curve still builds a public key
97
+ that `verify` then rejects.
98
+
99
+ ```js
100
+ const v = hybridSign.mldsa65_ed25519;
101
+ // the official LAMPS wire form: mldsaPk(1952) || ed25519Pk(32)
102
+ const publicKey = v.fromComponents('publicKey', { pq: wire.subarray(0, 1952), trad: wire.subarray(1952) });
103
+ const { pq, trad } = v.toComponents('publicKey', publicKey);
104
+ ```
78
105
 
79
106
  ## Examples
80
107
 
@@ -85,13 +112,13 @@ const v = hybridSign.mldsa65_ed25519;
85
112
  const { publicKey, secretKey } = v.keygen();
86
113
  const msg = new TextEncoder().encode('hello');
87
114
  const sig = v.sign(secretKey, msg);
88
- v.verify(publicKey, msg, sig); // true
115
+ v.verify(publicKey, sig, msg); // true
89
116
 
90
117
  // bind an application context
91
118
  const ctx = new TextEncoder().encode('app:v1');
92
119
  const sigCtx = v.sign(secretKey, msg, ctx);
93
- v.verify(publicKey, msg, sigCtx, ctx); // true
94
- v.verify(publicKey, msg, sigCtx); // false — ctx mismatch
120
+ v.verify(publicKey, sigCtx, msg, ctx); // true
121
+ v.verify(publicKey, sigCtx, msg); // false — ctx mismatch
95
122
  ```
96
123
 
97
124
  ## Worker Usage
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: ml_dsa
3
3
  category: crypto/pkc
4
- dependencies: [sha3, bitArray, random, sha256, sha384, sha512, sha512_224, sha512_256]
4
+ dependencies: [sha3, bitArray, random]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > ML-DSA (FIPS 204, August 2024) — CRYSTALS-Dilithium post-quantum signatures + HashML-DSA + internal interface.
13
13
 
14
- **Module** `ml_dsa` | **Source** `packages/front/fw/src/crypto/pkc/ml_dsa.js` | **Deps** `sha3`, `bitArray`, `random`, `sha256`, `sha384`, `sha512`, `sha512_224`, `sha512_256` | **Worker-safe** yes
14
+ **Module** `ml_dsa` | **Source** `packages/front/fw/src/crypto/pkc/ml_dsa.js` | **Deps** `sha3`, `bitArray`, `random` | **Worker-safe** yes
15
15
 
16
16
  NIST post-quantum signatures. 3 paramSets. Variants: pure (default), preHash (HashML-DSA, FIPS 204 §5.4), internal (raw §6.2), externalMu (pre-computed mu).
17
17
 
@@ -19,7 +19,7 @@ NIST post-quantum signatures. 3 paramSets. Variants: pure (default), preHash (Ha
19
19
 
20
20
  ```js
21
21
  const ml_dsa = runtime.resolve('ml_dsa');
22
- // Returns: { ml_dsa44, ml_dsa65, ml_dsa87, _internal }
22
+ // Returns: { ml_dsa44, ml_dsa65, ml_dsa87 }
23
23
  ```
24
24
 
25
25
  ## API
@@ -33,14 +33,14 @@ const ml_dsa = runtime.resolve('ml_dsa');
33
33
  | Method | Signature | Returns |
34
34
  |--------|-----------|---------|
35
35
  | `ml_dsa<N>.keygen(seed?)` | `(Uint8Array(32)?) => {publicKey, secretKey}` | Keypair |
36
- | `ml_dsa<N>.sign(msg, sk, ctx?, rnd?)` | `(Uint8Array, Uint8Array, Uint8Array?, Uint8Array(32)?) => Uint8Array` | Sign external+pure |
37
- | `ml_dsa<N>.verify(sig, msg, pk, ctx?)` | — | `boolean` |
38
- | `ml_dsa<N>.signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` | — | HashML-DSA (preHash + OID) |
39
- | `ml_dsa<N>.verifyPh(sig, msg, pk, hashAlg, hashMod, ctx?)` | — | `boolean` |
40
- | `_internal.signInternal(M, sk, rnd?)` | — | Raw §6.2 (no M' wrapper) |
41
- | `_internal.verifyInternal(sig, M, pk)` | — | `boolean` raw |
42
- | `_internal.signWithMu(mu, sk, rnd?)` | — | externalMu (pre-computed mu) |
43
- | `_internal.verifyWithMu(sig, mu, pk)` | — | `boolean` |
36
+ | `ml_dsa<N>.sign(sk, msg, ctx?, rnd?)` | `(Uint8Array, Uint8Array, Uint8Array?, Uint8Array(32)?) => Uint8Array` | Sign external+pure |
37
+ | `ml_dsa<N>.verify(pk, sig, msg, ctx?)` | — | `boolean` |
38
+ | `ml_dsa<N>.signPh(sk, msg, hashAlg, hashMod, ctx?, rnd?)` | — | HashML-DSA (preHash + OID) |
39
+ | `ml_dsa<N>.verifyPh(pk, sig, msg, hashAlg, hashMod, ctx?)` | — | `boolean` |
40
+ | `internalOf(ml_dsa).signInternal(M, sk, rnd?)` | — | Raw §6.2 (no M' wrapper) |
41
+ | `internalOf(ml_dsa).verifyInternal(sig, M, pk)` | — | `boolean` raw |
42
+ | `internalOf(ml_dsa).signWithMu(mu, sk, rnd?)` | — | externalMu (pre-computed mu) |
43
+ | `internalOf(ml_dsa).verifyWithMu(sig, mu, pk)` | — | `boolean` |
44
44
 
45
45
  ### Supported `hashAlg` values (HashML-DSA)
46
46
 
@@ -55,22 +55,22 @@ const { ml_dsa } = fw.runtime.resolveAll(['ml_dsa']);
55
55
  const { publicKey, secretKey } = ml_dsa.ml_dsa65.keygen();
56
56
 
57
57
  const msg = new TextEncoder().encode('Hello, ML-DSA!');
58
- const sig = ml_dsa.ml_dsa65.sign(msg, secretKey); // deterministic per default
59
- const ok = ml_dsa.ml_dsa65.verify(sig, msg, publicKey); // true
58
+ const sig = ml_dsa.ml_dsa65.sign(secretKey, msg); // hedged: 32 fresh random bytes
59
+ const ok = ml_dsa.ml_dsa65.verify(publicKey, sig, msg); // true
60
60
  ```
61
61
 
62
62
  ### HashML-DSA (preHash variant)
63
63
 
64
64
  ```js
65
65
  const sha256 = fw.runtime.resolve('sha256');
66
- const sig = ml_dsa.ml_dsa65.signPh(msg, secretKey, 'SHA2-256', sha256, ctx);
67
- const ok = ml_dsa.ml_dsa65.verifyPh(sig, msg, publicKey, 'SHA2-256', sha256, ctx);
66
+ const sig = ml_dsa.ml_dsa65.signPh(secretKey, msg, 'SHA2-256', sha256, ctx);
67
+ const ok = ml_dsa.ml_dsa65.verifyPh(publicKey, sig, msg, 'SHA2-256', sha256, ctx);
68
68
  ```
69
69
 
70
70
  ### Internal interface (raw §6.2)
71
71
 
72
72
  ```js
73
- const sig = ml_dsa.ml_dsa65._internal.signInternal(M, secretKey); // no M' wrapper
73
+ const sig = internalOf(ml_dsa.ml_dsa65).signInternal(M, secretKey); // no M' wrapper
74
74
  ```
75
75
 
76
76
  ## Worker Usage
@@ -81,15 +81,16 @@ const worker = fw.createWorker(
81
81
  function ({ libs, args }) {
82
82
  self.postMessage(libs.ml_dsa.ml_dsa65.sign(args[0], args[1]));
83
83
  },
84
- { dependencies: ['ml_dsa'], args: [msg, secretKey] }
84
+ { dependencies: ['ml_dsa'], args: [secretKey, msg] }
85
85
  );
86
86
  ```
87
87
 
88
88
  ## Notes
89
89
 
90
- - **Deterministic by default**: `rnd=null` → byte-exact reproducible signature.
90
+ - **Argument order**: `sign(sk, msg, …)`, `verify(pk, sig, msg, …)`, as the wasm and WebCrypto tiers. The fw order for every signature scheme and tier: `sign(key, message, …)`, `verify(key, signature, message, …)`.
91
+ - **Hedged by default** (FIPS 204 §3.4): without `rnd`, `sign` draws 32 random bytes, so two signatures of one message differ. Pass `new Uint8Array(32)` as `rnd` for the deterministic mode (KAT vectors, reproducible signatures).
91
92
  - **HashML-DSA OID**: DER prefix embedded in the M' wrapper (FIPS 204 Algorithm 4).
92
- - **`_internal.*`** test-only — bypasses §5.4 wrappers; do NOT expose to end users (risk of secret sk leakage).
93
+ - **`internalOf(ml_dsa).*`** test-only — bypasses §5.4 wrappers; do NOT expose to end users (risk of secret sk leakage).
93
94
  - **Full ACVP** under `CRYPTO_FULL=1`: 75 keyGen + 45 sigVer + 90 sigGen ext+pure.
94
95
 
95
96
  ## See also
@@ -19,7 +19,7 @@ NIST-standardised post-quantum KEM (Key Encapsulation Mechanism). Replaces ECDH
19
19
 
20
20
  ```js
21
21
  const ml_kem = runtime.resolve('ml_kem');
22
- // Returns: { ml_kem512, ml_kem768, ml_kem1024, _internal }
22
+ // Returns: { ml_kem512, ml_kem768, ml_kem1024 }
23
23
  ```
24
24
 
25
25
  ## API
@@ -35,7 +35,7 @@ const ml_kem = runtime.resolve('ml_kem');
35
35
  | `ml_kem<N>.keygen(seed?)` | `(Uint8Array(64)?) => {publicKey, secretKey}` | Keypair (random if seed absent) |
36
36
  | `ml_kem<N>.encapsulate(publicKey, m?)` | `(Uint8Array, Uint8Array(32)?) => {cipherText, sharedSecret}` | Encapsulate; m random if absent |
37
37
  | `ml_kem<N>.decapsulate(cipherText, secretKey)` | `(Uint8Array, Uint8Array) => Uint8Array(32)` | Shared secret (constant-time, implicit reject) |
38
- | `_internal.{ntt, nttInv, isValidEncapsulationKey, isValidDecapsulationKey}` | — | Primitives + key check FIPS 203 §7.2/§7.3 |
38
+ | `internalOf(ml_kem).{ntt, nttInv, isValidEncapsulationKey, isValidDecapsulationKey}` | — | Primitives + key check FIPS 203 §7.2/§7.3 |
39
39
 
40
40
  ## Examples
41
41
 
@@ -80,7 +80,7 @@ const worker = fw.createWorker(
80
80
 
81
81
  - **Implicit reject** on invalid ciphertext: `decapsulate` returns a pseudo-random sharedSecret (not `false`) per FIPS 203 §6.3 — the caller must NOT distinguish.
82
82
  - **Constant-time**: final Khat/Kbar selection by mask, no short-circuit.
83
- - **Key check** opt-in: `_internal.isValidEncapsulationKey(ek)` (modulus q check) + `isValidDecapsulationKey(dk)` (hash consistency).
83
+ - **Key check** opt-in: `internalOf(ml_kem).isValidEncapsulationKey(ek)` (modulus q check) + `isValidDecapsulationKey(dk)` (hash consistency).
84
84
 
85
85
  ## See also
86
86
 
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  module: rsa
3
3
  category: crypto/pkc
4
- dependencies: [sha256, bitArray, utf8, hex]
4
+ dependencies: [bitArray, bn, random]
5
5
  returns: object
6
6
  worker-safe: true
7
7
  status: complete
@@ -11,7 +11,7 @@ status: complete
11
11
 
12
12
  > RSA-OAEP + RSA-PSS (FIPS 186-5 §5.4 / RFC 8017) — asymmetric encryption + signatures. PKCS#1 v1.5 explicit reject.
13
13
 
14
- **Module** `rsa` | **Source** `packages/front/fw/src/crypto/pkc/rsa.js` | **Deps** `sha256`, `bitArray`, `utf8`, `hex` | **Worker-safe** yes
14
+ **Module** `rsa` | **Source** `packages/front/fw/src/crypto/pkc/rsa.js` | **Deps** `bitArray`, `bn`, `random` | **Worker-safe** yes
15
15
 
16
16
  CRT auto-enabled for decrypt/sign (4× speedup). Chaum/Pollard RSA blinding enabled by default (anti-Boneh-Brumley 2003 timing attack).
17
17
 
@@ -19,7 +19,7 @@ CRT auto-enabled for decrypt/sign (4× speedup). Chaum/Pollard RSA blinding enab
19
19
 
20
20
  ```js
21
21
  const rsa = runtime.resolve('rsa');
22
- // Returns: { oaepEncrypt, oaepDecrypt, pssSign, pssVerify, pkcs1v15*, _internal }
22
+ // Returns: { oaepEncrypt, oaepDecrypt, pssSign, pssVerify }
23
23
  ```
24
24
 
25
25
  ## API
@@ -30,9 +30,7 @@ const rsa = runtime.resolve('rsa');
30
30
  | `oaepDecrypt(priv, ct, hashMod?)` | — | Plaintext or `false` (constant-time anti-Manger) |
31
31
  | `pssSign(priv, msg, hashMod?, sLen?, salt?)` | — | Signature |
32
32
  | `pssVerify(pub, msg, sig, hashMod?, sLen?)` | — | `boolean` |
33
- | `pkcs1v15Sign/Verify` | `() => false` | **DEPRECATED** explicit reject |
34
- | `pkcs1v15Encrypt/Decrypt` | `() => false` | **DEPRECATED\|UNSAFE** (Bleichenbacher) |
35
- | `_internal.{rsaep, rsadp, mgf1}` | — | Primitives + RSA blinding control |
33
+ | `internalOf(rsa).{rsaep, rsadp, mgf1}` | — | Primitives + RSA blinding control |
36
34
 
37
35
  ## Examples
38
36
 
@@ -59,7 +57,7 @@ const ok = rsa.pssVerify(publicKey, msg, sig); // true
59
57
  ### Disable blinding (benchmark)
60
58
 
61
59
  ```js
62
- const pt = rsa._internal.rsadp(secretKey, ct, { blinding: false });
60
+ const pt = internalOf(rsa).rsadp(secretKey, ct, { blinding: false });
63
61
  ```
64
62
 
65
63
  ## Worker Usage
@@ -76,8 +74,8 @@ const worker = fw.createWorker(
76
74
 
77
75
  ## Notes
78
76
 
79
- - **PKCS #1 v1.5 rejected**: `pkcs1v15Sign/Verify/Encrypt/Decrypt` return `false` + `DEPRECATED|UNSAFE` warn (SP 800-131A Rev.2 + Bleichenbacher 2006).
80
- - **RSA blinding default ON**: opt-out via `_internal.rsadp(p, c, {blinding:false})` for benchmarks; covers Boneh-Brumley 2003 anti-timing.
77
+ - **No PKCS #1 v1.5** (signature or encryption): SP 800-131A Rev.2 deprecates v1.5 signatures, and v1.5 encryption carries the Bleichenbacher padding oracle. Use PSS and OAEP.
78
+ - **RSA blinding default ON**: opt-out via `internalOf(rsa).rsadp(p, c, {blinding:false})` for benchmarks; covers Boneh-Brumley 2003 anti-timing.
81
79
  - **OAEP decrypt constant-time** anti-Manger: separator scanned without early-exit.
82
80
 
83
81
  ## See also
@@ -19,7 +19,7 @@ Purely hash-based signatures (conservative quantum resistance). 12 variants: 2 h
19
19
 
20
20
  ```js
21
21
  const slh_dsa = runtime.resolve('slh_dsa');
22
- // Returns: { slh_dsa_sha2_128f, ..., slh_dsa_shake_256s, _internal }
22
+ // Returns: { slh_dsa_sha2_128f, ..., slh_dsa_shake_256s }
23
23
  ```
24
24
 
25
25
  ## API (12 paramSets)
@@ -33,12 +33,12 @@ const slh_dsa = runtime.resolve('slh_dsa');
33
33
  | Method | Signature | Returns |
34
34
  |--------|-----------|---------|
35
35
  | `slh_dsa_*.keygen(seed?)` | — | `{publicKey, secretKey}` |
36
- | `slh_dsa_*.sign(msg, sk, opts?)` | `(Uint8Array, Uint8Array, {context?, extraEntropy?}) => Uint8Array` | Signature |
37
- | `slh_dsa_*.verify(sig, msg, pk, opts?)` | — | `boolean` |
38
- | `slh_dsa_*.signPh(msg, sk, hashAlg, hashMod, opts?)` | — | HashSLH-DSA (preHash + OID) |
39
- | `slh_dsa_*.verifyPh(sig, msg, pk, hashAlg, hashMod, opts?)` | — | `boolean` |
40
- | `_internal.signInternal(M, sk, opts?)` | — | Raw §6 (no M' wrapper) |
41
- | `_internal.verifyInternal(sig, M, pk)` | — | `boolean` raw |
36
+ | `slh_dsa_*.sign(sk, msg, opts?)` | `(Uint8Array, Uint8Array, {context?, extraEntropy?}) => Uint8Array` | Signature |
37
+ | `slh_dsa_*.verify(pk, sig, msg, opts?)` | — | `boolean` |
38
+ | `slh_dsa_*.signPh(sk, msg, hashAlg, hashMod, opts?)` | — | HashSLH-DSA (preHash + OID) |
39
+ | `slh_dsa_*.verifyPh(pk, sig, msg, hashAlg, hashMod, opts?)` | — | `boolean` |
40
+ | `internalOf(slh_dsa).signInternal(M, sk, opts?)` | — | Raw §6 (no M' wrapper) |
41
+ | `internalOf(slh_dsa).verifyInternal(sig, M, pk)` | — | `boolean` raw |
42
42
 
43
43
  ## Examples
44
44
 
@@ -49,15 +49,15 @@ const { slh_dsa } = fw.runtime.resolveAll(['slh_dsa']);
49
49
 
50
50
  // SHAKE-128f : fastest sign, large sig (17 KB)
51
51
  const { publicKey, secretKey } = slh_dsa.slh_dsa_shake_128f.keygen();
52
- const sig = slh_dsa.slh_dsa_shake_128f.sign(msg, secretKey);
53
- const ok = slh_dsa.slh_dsa_shake_128f.verify(sig, msg, publicKey);
52
+ const sig = slh_dsa.slh_dsa_shake_128f.sign(secretKey, msg);
53
+ const ok = slh_dsa.slh_dsa_shake_128f.verify(publicKey, sig, msg);
54
54
  ```
55
55
 
56
56
  ### HashSLH-DSA preHash
57
57
 
58
58
  ```js
59
59
  const sha256 = fw.runtime.resolve('sha256');
60
- const sig = slh_dsa.slh_dsa_sha2_128f.signPh(msg, secretKey, 'SHA2-256', sha256);
60
+ const sig = slh_dsa.slh_dsa_sha2_128f.signPh(secretKey, msg, 'SHA2-256', sha256);
61
61
  ```
62
62
 
63
63
  ## Worker Usage
@@ -68,7 +68,7 @@ const worker = fw.createWorker(
68
68
  function ({ libs, args }) {
69
69
  self.postMessage(libs.slh_dsa.slh_dsa_sha2_128f.sign(args[0], args[1]));
70
70
  },
71
- { dependencies: ['slh_dsa'], args: [msg, secretKey] }
71
+ { dependencies: ['slh_dsa'], args: [secretKey, msg] }
72
72
  );
73
73
  ```
74
74
 
@@ -76,7 +76,7 @@ const worker = fw.createWorker(
76
76
 
77
77
  - **Variant choice**: `f` (fast sign, large sig) for interactive use; `s` (small sig, slow sign) for infrequent long-term artefacts.
78
78
  - **256s sign costs minutes** — never block the UI.
79
- - **`_internal.*`** test-only — `_internal` convention to bypass the §5.4 wrapper.
79
+ - **`internalOf(slh_dsa).*`** test-only, the internal slot (not API) — bypasses the §5.4 wrapper.
80
80
  - **Full ACVP keyGen + sigVer ext+pure** under `CRYPTO_FULL=1` (~135 s). Full sigGen (624) deliberately not wired (would take hours).
81
81
 
82
82
  ## See also
@@ -9,7 +9,7 @@ status: complete
9
9
 
10
10
  # x25519
11
11
 
12
- > X25519 (RFC 7748) — Diffie-Hellman over Curve25519, primitive ECDH minimaliste.
12
+ > X25519 (RFC 7748) — Diffie-Hellman over Curve25519, a minimal ECDH primitive.
13
13
 
14
14
  **Module** `x25519` | **Source** `packages/front/fw/src/crypto/pkc/x25519.js` | **Deps** none | **Worker-safe** yes
15
15
 
@@ -19,7 +19,7 @@ Outside NIST but a de facto standard (TLS 1.3, Signal, WireGuard). TweetNaCl-der
19
19
 
20
20
  ```js
21
21
  const x25519 = runtime.resolve('x25519');
22
- // Returns: { scalarMult, scalarMultBase, isLowOrderPoint, _internal }
22
+ // Returns: { scalarMult, scalarMultBase, isLowOrderPoint }
23
23
  ```
24
24
 
25
25
  ## API
@@ -29,7 +29,7 @@ const x25519 = runtime.resolve('x25519');
29
29
  | `scalarMult(scalar, u)` | `(Uint8Array(32), Uint8Array(32)) => Uint8Array(32) \| false` | Shared secret (clamping auto per RFC 7748 §5) |
30
30
  | `scalarMultBase(scalar)` | `(Uint8Array(32)) => Uint8Array(32)` | `scalarMult(scalar, basePoint=9)` (public key) |
31
31
  | `isLowOrderPoint(u)` | `(Uint8Array(32)) => boolean` | true if `u` is low-order (cofactor 8) |
32
- | `_internal.lowOrderPoints` | `Uint8Array[7]` | Table of the 7 documented LOPs |
32
+ | `internalOf(x25519).lowOrderPoints` | `Uint8Array[7]` | Table of the 7 documented LOPs |
33
33
 
34
34
  ## Examples
35
35
 
@@ -75,7 +75,8 @@ const worker = fw.createWorker(
75
75
 
76
76
  - **Automatic clamping** per RFC 7748 §5 (clear low 3 bits, clear high bit, set bit 254).
77
77
  - **Low-order points**: `scalarMult(scalar, lowOrderU) === 0...0`. RFC 7748 §6.1 allows this (non-rejected by design); `isLowOrderPoint` enables explicit caller-side rejection (constant-time vs 7 documented LOPs).
78
- - **`scalarMult` not formally constant-time**: `_M`/`_S` Float64 + carry. Acceptable per RFC 7748 §A.1 in an interactive ECDH context.
78
+ - **Timing**: the ladder is algorithmically constant-time (255 fixed steps, swaps by mask, a fixed inversion chain); the engine-level timing of Float64 arithmetic cannot be guaranteed from JavaScript. Acceptable per RFC 7748 §A.1 in an interactive ECDH context.
79
+ - **Speed**: `scalarMult` about 0.65-0.8 ms (Bun / Node), the field multiply and square unrolled.
79
80
  - **RFC 7748 1M iterations** validation gated on `CRYPTO_FULL=1`.
80
81
 
81
82
  ## See also
@@ -4,18 +4,18 @@ Utilities: DRBG, key generation, algebraic primitives (BN, bitArray), formats (P
4
4
 
5
5
  | Module | Returns | Deps | Description |
6
6
  |--------|----------|------|-------------|
7
- | [random](./random.md) | `{fill, float, int, bytes, words, bits, range, drbg, health, isReady, selfTest, _internal}` | `bitArray`, `aes`, `sha256` | CTR_DRBG-AES-256 (SP 800-90A) + RCT/APT (SP 800-90B); AES-128/192 + df via `_internal.makeDrbg` |
8
- | [rsaKeygen](./rsaKeygen.md) | `{generate, generateProbablePrime, _internal}` | `bn`, `random` | RSA 2048+ generation (FIPS 186-5 §A.1.3, probable primes) |
7
+ | [random](./random.md) | `{fill, float, int, bytes, words, bits, drbg, health, isReady, selfTest}` | `bitArray`, `aes`, `sha256` | CTR_DRBG-AES-256 (SP 800-90A) + RCT/APT (SP 800-90B); AES-128/192 + df via `internalOf(random).makeDrbg` (internal slot) |
8
+ | [rsaKeygen](./rsaKeygen.md) | `{generate, generateProbablePrime}` | `bn`, `random` | RSA 2048+ generation (FIPS 186-5 §A.1.3, probable primes) |
9
9
  | [bn](./bn.md) | constructor `BN` + statics | `bitArray`, `random` | Big integer (SJCL-derived, BSD-2-Clause; see [provenance](../../../dev/provenance.md)) — ECDSA / RSA arithmetic |
10
10
  | [bitArray](./bitArray.md) | `{...}` | none | Bit-precise representation (SJCL convention, see [provenance](../../../dev/provenance.md); 32-bit words + partial last word) |
11
11
  | [pad](./pad.md) | `{pad, strip}` | none | PKCS#7 padding (RFC 5652 §6.3) |
12
12
  | [pem](./pem.md) | `{encode, decode}` | none | PEM (RFC 7468) — Base64 encoding + BEGIN/END headers |
13
- | [asn1](./asn1.md) | `{encode, decode, oid, ...}` | none | ASN.1 DER (X.690) — primitive tag serialisation |
13
+ | [asn1](./asn1.md) | `{TAG, encode*, parseOne, parseChildren, read*}` | none | ASN.1 DER (X.690) — primitive tag serialisation |
14
14
  | [asn1Oid](./asn1-oid.md) | `{lookup, byName, findByCategory, OID_DATABASE}` | none | ASN.1 OID database — bidirectional name ↔ OID resolution (≥ 180 OIDs, 12 categories) |
15
- | [keyformat](./keyformat.md) | `{encodePkcs8Edwards, decodePkcs8Edwards, encodeSpkiEdwards, decodeSpkiEdwards, encodeSec1, decodeSec1, encodePkcs8Ec, decodePkcs8Ec, encodeSpkiEc, decodeSpkiEc, OID}` | `asn1`, `pem`, `bitArray` | EC (P-256/384/521) / Ed25519 / X25519 key serialisation — PKCS#8 + SPKI + SEC1 (RFC 5915 / RFC 8410) |
16
- | [jws](./jws.md) | `{sign, verify, decode}` | `bitArray`, `utf8`, `b64`, `hmac`, `sha256`, `sha512`, `ed25519` | JSON Web Signature (RFC 7515) HS*/EdDSA |
17
- | [aes_modes](./aes_modes.md) | `{cbc, ctr, gcm, kw, kwp}` | `bitArray`, `aes`, `cbc`, `ctr`, `gcm`, `kw`, `pad` | Uniform Uint8Array wrapper over all AES modes |
18
- | [aes_ctr](./aes_ctr.md) | `{ui8}` | `bitArray`, `aes`, `ctr`, `pad` | **`@deprecated`** legacy CTR wrapper — prefer `aes_modes.ctr` |
15
+ | [keyformat](./keyformat.md) | `{encodePkcs8Edwards, decodePkcs8Edwards, encodeSpkiEdwards, decodeSpkiEdwards, encodeSec1, decodeSec1, encodePkcs8Ec, decodePkcs8Ec, encodeSpkiEc, decodeSpkiEc, encodeRsaPublicKey, decodeRsaPublicKey, encodeRsaPrivateKey, decodeRsaPrivateKey, encodeSpkiRsa, decodeSpkiRsa, encodePkcs8Rsa, decodePkcs8Rsa, OID}` | `asn1` | RSA / EC (P-256/384/521) / Ed25519 / X25519 key serialisation — PKCS#8, SPKI, SEC1, PKCS#1 |
16
+ | [x509](./x509.md) | `{create, parse, verify, toPem, fromPem}` | `asn1`, `keyformat`, `pem`, `ed25519`, `ecc`, `sha256`, `bitArray` | X.509 v3 certificates (RFC 5280) for Ed25519 / ECDSA P-256 keys — create, parse, verify |
17
+ | [jws](./jws.md) | `{sign, verify, signJwt, verifyJwt}` | `bitArray`, `utf8`, `b64`, `hmac`, `sha256`, `sha512`, `ed25519` | JSON Web Signature (RFC 7515) HS*/EdDSA |
18
+ | [aes_modes](./aes_modes.md) | `{cbc, ctr, gcm, kw}` | `bitArray`, `aes`, `cbc`, `ctr`, `gcm`, `kw`, `pad` | Uniform Uint8Array wrapper over all AES modes |
19
19
  | [totp](./totp.md) | `{generate, verify, enroll, uri}` | `hmac`, `random`, `base32` | TOTP RFC 6238 + HOTP RFC 4226 — time-based OTP codes |
20
20
  | [uuid](./uuid.md) | `{v1, v4}` | `hex` | UUID v1 (time-based) + v4 (random) — RFC 4122 / RFC 9562 |
21
21
 
@@ -19,7 +19,7 @@ Fully Uint8Array API (no bitArray on the caller side). Recommended for external
19
19
 
20
20
  ```js
21
21
  const am = runtime.resolve('aes_modes');
22
- // Returns: { cbc, ctr, gcm, kw, kwp }
22
+ // Returns: { cbc, ctr, gcm, kw }
23
23
  ```
24
24
 
25
25
  ## API
@@ -29,8 +29,7 @@ const am = runtime.resolve('aes_modes');
29
29
  | `am.cbc` | `encrypt(key, iv, pt) → ct` (PKCS#7 included), `decrypt(key, iv, ct) → pt` |
30
30
  | `am.ctr` | `encrypt(key, iv, data) → out` (involution) |
31
31
  | `am.gcm` | `encrypt(key, iv, pt, aad?, tagLen?) → {ct, tag}`, `decrypt(key, iv, ct, tag, aad?) → pt \| false` |
32
- | `am.kw` | `wrap(kek, key) → ct`, `unwrap(kek, ct) → key \| false` |
33
- | `am.kwp` | `wrapPad(kek, key) → ct`, `unwrapPad(kek, ct) → key \| false` |
32
+ | `am.kw` | `wrap(kek, key) → ct`, `unwrap(kek, ct) → key \| false`; KWP (padded, RFC 5649): `wrapPad(kek, key) → ct`, `unwrapPad(kek, ct) → key \| false` |
34
33
 
35
34
  All inputs/outputs = `Uint8Array`.
36
35
 
@@ -72,10 +71,8 @@ const worker = fw.createWorker(
72
71
  ## Notes
73
72
 
74
73
  - **Convenience wrapper**: 100% of FIPS / SP 800 conformance is delegated to `cipher/aes` + `mode/{cbc,ctr,gcm,kw}`.
75
- - **Recommended for new code** over `aes_ctr.js` (legacy, deprecated).
76
74
  - **No `nonceTracker`**: use `mode/gcm.js` directly if required.
77
75
 
78
76
  ## See also
79
77
 
80
78
  - [cbc](../mode/cbc.md), [ctr](../mode/ctr.md), [gcm](../mode/gcm.md), [kw](../mode/kw.md) — underlying algorithms
81
- - [aes_ctr](./aes_ctr.md) — legacy CTR-only wrapper (deprecated)