@awacloud/fw 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1057) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/LICENSE +176 -0
  3. package/NOTICE +12 -0
  4. package/README.md +355 -0
  5. package/dist/build/fw.core.pure.meta.json +29 -0
  6. package/dist/build/fw.core.pure.min.js +26 -0
  7. package/dist/build/fw.full.pure.meta.json +224 -0
  8. package/dist/build/fw.full.pure.min.js +60 -0
  9. package/dist/build/fw.minimal.pure.meta.json +21 -0
  10. package/dist/build/fw.minimal.pure.min.js +26 -0
  11. package/dist/build/fw.pack.compress-heavy.pure.meta.json +29 -0
  12. package/dist/build/fw.pack.compress-heavy.pure.min.js +8 -0
  13. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +38 -0
  14. package/dist/build/fw.pack.crypto-advanced.pure.min.js +6 -0
  15. package/dist/build/fw.pack.crypto-basic.pure.meta.json +29 -0
  16. package/dist/build/fw.pack.crypto-basic.pure.min.js +6 -0
  17. package/dist/build/fw.pack.crypto-identity.pure.meta.json +29 -0
  18. package/dist/build/fw.pack.crypto-identity.pure.min.js +9 -0
  19. package/dist/build/fw.pack.realtime.pure.meta.json +21 -0
  20. package/dist/build/fw.pack.realtime.pure.min.js +6 -0
  21. package/dist/build/fw.pack.sensors.pure.meta.json +21 -0
  22. package/dist/build/fw.pack.sensors.pure.min.js +6 -0
  23. package/dist/build/fw.pack.structures-advanced.pure.meta.json +20 -0
  24. package/dist/build/fw.pack.structures-advanced.pure.min.js +6 -0
  25. package/dist/build/fw.pack.text-advanced.pure.meta.json +20 -0
  26. package/dist/build/fw.pack.text-advanced.pure.min.js +6 -0
  27. package/dist/build/fw.pwa.pure.meta.json +127 -0
  28. package/dist/build/fw.pwa.pure.min.js +55 -0
  29. package/dist/build/fw.site-interactive.pure.meta.json +81 -0
  30. package/dist/build/fw.site-interactive.pure.min.js +52 -0
  31. package/dist/build/fw.site.pure.meta.json +51 -0
  32. package/dist/build/fw.site.pure.min.js +35 -0
  33. package/dist/build/fw.spa.pure.meta.json +108 -0
  34. package/dist/build/fw.spa.pure.min.js +55 -0
  35. package/dist/build/io/compress/brotli_dict.bin +432 -0
  36. package/dist/build/sanity-base-classic.min.js +6 -0
  37. package/dist/build/sanity-community-classic.min.js +6 -0
  38. package/dist/build/sanity.min.js +6 -0
  39. package/dist/types/core/logger.d.ts +71 -0
  40. package/dist/types/core/logger.d.ts.map +1 -0
  41. package/dist/types/core/modules.d.ts +3962 -0
  42. package/dist/types/core/modules.d.ts.map +1 -0
  43. package/dist/types/core/readyState.d.ts +14 -0
  44. package/dist/types/core/readyState.d.ts.map +1 -0
  45. package/dist/types/core/runtime.d.ts +625 -0
  46. package/dist/types/core/runtime.d.ts.map +1 -0
  47. package/dist/types/core/worker-helper.d.ts +153 -0
  48. package/dist/types/core/worker-helper.d.ts.map +1 -0
  49. package/dist/types/crypto/cipher/aes.d.ts +55 -0
  50. package/dist/types/crypto/cipher/aes.d.ts.map +1 -0
  51. package/dist/types/crypto/cipher/chacha20.d.ts +33 -0
  52. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -0
  53. package/dist/types/crypto/hash/adf.d.ts +65 -0
  54. package/dist/types/crypto/hash/adf.d.ts.map +1 -0
  55. package/dist/types/crypto/hash/argon2.d.ts +79 -0
  56. package/dist/types/crypto/hash/argon2.d.ts.map +1 -0
  57. package/dist/types/crypto/hash/blake2b.d.ts +40 -0
  58. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -0
  59. package/dist/types/crypto/hash/hkdf.d.ts +88 -0
  60. package/dist/types/crypto/hash/hkdf.d.ts.map +1 -0
  61. package/dist/types/crypto/hash/hmac.d.ts +85 -0
  62. package/dist/types/crypto/hash/hmac.d.ts.map +1 -0
  63. package/dist/types/crypto/hash/pbkdf2.d.ts +80 -0
  64. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -0
  65. package/dist/types/crypto/hash/poly1305.d.ts +31 -0
  66. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -0
  67. package/dist/types/crypto/hash/sha224.d.ts +80 -0
  68. package/dist/types/crypto/hash/sha224.d.ts.map +1 -0
  69. package/dist/types/crypto/hash/sha256.d.ts +82 -0
  70. package/dist/types/crypto/hash/sha256.d.ts.map +1 -0
  71. package/dist/types/crypto/hash/sha3.d.ts +111 -0
  72. package/dist/types/crypto/hash/sha3.d.ts.map +1 -0
  73. package/dist/types/crypto/hash/sha384.d.ts +84 -0
  74. package/dist/types/crypto/hash/sha384.d.ts.map +1 -0
  75. package/dist/types/crypto/hash/sha512.d.ts +87 -0
  76. package/dist/types/crypto/hash/sha512.d.ts.map +1 -0
  77. package/dist/types/crypto/hash/sha512_224.d.ts +84 -0
  78. package/dist/types/crypto/hash/sha512_224.d.ts.map +1 -0
  79. package/dist/types/crypto/hash/sha512_256.d.ts +84 -0
  80. package/dist/types/crypto/hash/sha512_256.d.ts.map +1 -0
  81. package/dist/types/crypto/mode/cbc.d.ts +38 -0
  82. package/dist/types/crypto/mode/cbc.d.ts.map +1 -0
  83. package/dist/types/crypto/mode/chacha20poly1305.d.ts +71 -0
  84. package/dist/types/crypto/mode/chacha20poly1305.d.ts.map +1 -0
  85. package/dist/types/crypto/mode/cmac.d.ts +56 -0
  86. package/dist/types/crypto/mode/cmac.d.ts.map +1 -0
  87. package/dist/types/crypto/mode/ctr.d.ts +52 -0
  88. package/dist/types/crypto/mode/ctr.d.ts.map +1 -0
  89. package/dist/types/crypto/mode/gcm.d.ts +88 -0
  90. package/dist/types/crypto/mode/gcm.d.ts.map +1 -0
  91. package/dist/types/crypto/mode/kw.d.ts +60 -0
  92. package/dist/types/crypto/mode/kw.d.ts.map +1 -0
  93. package/dist/types/crypto/pkc/ecc.d.ts +284 -0
  94. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -0
  95. package/dist/types/crypto/pkc/ed25519.d.ts +107 -0
  96. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -0
  97. package/dist/types/crypto/pkc/hybridKem.d.ts +154 -0
  98. package/dist/types/crypto/pkc/hybridKem.d.ts.map +1 -0
  99. package/dist/types/crypto/pkc/hybridSign.d.ts +383 -0
  100. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -0
  101. package/dist/types/crypto/pkc/ml_dsa.d.ts +174 -0
  102. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -0
  103. package/dist/types/crypto/pkc/ml_kem.d.ts +194 -0
  104. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -0
  105. package/dist/types/crypto/pkc/rsa.d.ts +175 -0
  106. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -0
  107. package/dist/types/crypto/pkc/slh_dsa.d.ts +232 -0
  108. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -0
  109. package/dist/types/crypto/pkc/x25519.d.ts +37 -0
  110. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -0
  111. package/dist/types/crypto/utils/aes_ctr.d.ts +84 -0
  112. package/dist/types/crypto/utils/aes_ctr.d.ts.map +1 -0
  113. package/dist/types/crypto/utils/aes_modes.d.ts +128 -0
  114. package/dist/types/crypto/utils/aes_modes.d.ts.map +1 -0
  115. package/dist/types/crypto/utils/asn1-oid.d.ts +45 -0
  116. package/dist/types/crypto/utils/asn1-oid.d.ts.map +1 -0
  117. package/dist/types/crypto/utils/asn1.d.ts +115 -0
  118. package/dist/types/crypto/utils/asn1.d.ts.map +1 -0
  119. package/dist/types/crypto/utils/bitArray.d.ts +75 -0
  120. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -0
  121. package/dist/types/crypto/utils/bn.d.ts +214 -0
  122. package/dist/types/crypto/utils/bn.d.ts.map +1 -0
  123. package/dist/types/crypto/utils/jws.d.ts +159 -0
  124. package/dist/types/crypto/utils/jws.d.ts.map +1 -0
  125. package/dist/types/crypto/utils/keyformat.d.ts +100 -0
  126. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -0
  127. package/dist/types/crypto/utils/pad.d.ts +44 -0
  128. package/dist/types/crypto/utils/pad.d.ts.map +1 -0
  129. package/dist/types/crypto/utils/pem.d.ts +41 -0
  130. package/dist/types/crypto/utils/pem.d.ts.map +1 -0
  131. package/dist/types/crypto/utils/random.d.ts +203 -0
  132. package/dist/types/crypto/utils/random.d.ts.map +1 -0
  133. package/dist/types/crypto/utils/rsaKeygen.d.ts +162 -0
  134. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -0
  135. package/dist/types/crypto/utils/totp.d.ts +183 -0
  136. package/dist/types/crypto/utils/totp.d.ts.map +1 -0
  137. package/dist/types/crypto/utils/uuid.d.ts +29 -0
  138. package/dist/types/crypto/utils/uuid.d.ts.map +1 -0
  139. package/dist/types/crypto/wasm/aes.d.ts +59 -0
  140. package/dist/types/crypto/wasm/aes.d.ts.map +1 -0
  141. package/dist/types/crypto/wasm/argon2.d.ts +70 -0
  142. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -0
  143. package/dist/types/crypto/wasm/blake2b.d.ts +59 -0
  144. package/dist/types/crypto/wasm/blake2b.d.ts.map +1 -0
  145. package/dist/types/crypto/wasm/chacha20poly1305.d.ts +43 -0
  146. package/dist/types/crypto/wasm/chacha20poly1305.d.ts.map +1 -0
  147. package/dist/types/crypto/wasm/cmac.d.ts +42 -0
  148. package/dist/types/crypto/wasm/cmac.d.ts.map +1 -0
  149. package/dist/types/crypto/wasm/ecc.d.ts +56 -0
  150. package/dist/types/crypto/wasm/ecc.d.ts.map +1 -0
  151. package/dist/types/crypto/wasm/ed25519.d.ts +52 -0
  152. package/dist/types/crypto/wasm/ed25519.d.ts.map +1 -0
  153. package/dist/types/crypto/wasm/hkdf.d.ts +40 -0
  154. package/dist/types/crypto/wasm/hkdf.d.ts.map +1 -0
  155. package/dist/types/crypto/wasm/hmac.d.ts +42 -0
  156. package/dist/types/crypto/wasm/hmac.d.ts.map +1 -0
  157. package/dist/types/crypto/wasm/ml_dsa.d.ts +48 -0
  158. package/dist/types/crypto/wasm/ml_dsa.d.ts.map +1 -0
  159. package/dist/types/crypto/wasm/ml_kem.d.ts +58 -0
  160. package/dist/types/crypto/wasm/ml_kem.d.ts.map +1 -0
  161. package/dist/types/crypto/wasm/pbkdf2.d.ts +38 -0
  162. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -0
  163. package/dist/types/crypto/wasm/rsa.d.ts +56 -0
  164. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -0
  165. package/dist/types/crypto/wasm/runtime.d.ts +99 -0
  166. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -0
  167. package/dist/types/crypto/wasm/sha2.d.ts +45 -0
  168. package/dist/types/crypto/wasm/sha2.d.ts.map +1 -0
  169. package/dist/types/crypto/wasm/sha3.d.ts +57 -0
  170. package/dist/types/crypto/wasm/sha3.d.ts.map +1 -0
  171. package/dist/types/crypto/wasm/slh_dsa.d.ts +62 -0
  172. package/dist/types/crypto/wasm/slh_dsa.d.ts.map +1 -0
  173. package/dist/types/crypto/wasm/x25519.d.ts +53 -0
  174. package/dist/types/crypto/wasm/x25519.d.ts.map +1 -0
  175. package/dist/types/crypto/webcrypto/aes.d.ts +59 -0
  176. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -0
  177. package/dist/types/crypto/webcrypto/aeskw.d.ts +40 -0
  178. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -0
  179. package/dist/types/crypto/webcrypto/digest.d.ts +43 -0
  180. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -0
  181. package/dist/types/crypto/webcrypto/ecc.d.ts +51 -0
  182. package/dist/types/crypto/webcrypto/ecc.d.ts.map +1 -0
  183. package/dist/types/crypto/webcrypto/ed25519.d.ts +43 -0
  184. package/dist/types/crypto/webcrypto/ed25519.d.ts.map +1 -0
  185. package/dist/types/crypto/webcrypto/hkdf.d.ts +18 -0
  186. package/dist/types/crypto/webcrypto/hkdf.d.ts.map +1 -0
  187. package/dist/types/crypto/webcrypto/hmac.d.ts +43 -0
  188. package/dist/types/crypto/webcrypto/hmac.d.ts.map +1 -0
  189. package/dist/types/crypto/webcrypto/pbkdf2.d.ts +18 -0
  190. package/dist/types/crypto/webcrypto/pbkdf2.d.ts.map +1 -0
  191. package/dist/types/crypto/webcrypto/rsa.d.ts +51 -0
  192. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -0
  193. package/dist/types/crypto/webcrypto/x25519.d.ts +43 -0
  194. package/dist/types/crypto/webcrypto/x25519.d.ts.map +1 -0
  195. package/dist/types/dom/display/animate.d.ts +35 -0
  196. package/dist/types/dom/display/animate.d.ts.map +1 -0
  197. package/dist/types/dom/display/fullscreen.d.ts +59 -0
  198. package/dist/types/dom/display/fullscreen.d.ts.map +1 -0
  199. package/dist/types/dom/fs/download.d.ts +36 -0
  200. package/dist/types/dom/fs/download.d.ts.map +1 -0
  201. package/dist/types/dom/fs/fsAccess.d.ts +107 -0
  202. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -0
  203. package/dist/types/dom/fs/indexedDB.d.ts +62 -0
  204. package/dist/types/dom/fs/indexedDB.d.ts.map +1 -0
  205. package/dist/types/dom/fs/remoteStore.d.ts +64 -0
  206. package/dist/types/dom/fs/remoteStore.d.ts.map +1 -0
  207. package/dist/types/dom/fs/storage.d.ts +56 -0
  208. package/dist/types/dom/fs/storage.d.ts.map +1 -0
  209. package/dist/types/dom/lifecycle/idle.d.ts +91 -0
  210. package/dist/types/dom/lifecycle/idle.d.ts.map +1 -0
  211. package/dist/types/dom/lifecycle/visibility.d.ts +49 -0
  212. package/dist/types/dom/lifecycle/visibility.d.ts.map +1 -0
  213. package/dist/types/dom/lifecycle/wakeLock.d.ts +69 -0
  214. package/dist/types/dom/lifecycle/wakeLock.d.ts.map +1 -0
  215. package/dist/types/dom/net/ajax.d.ts +27 -0
  216. package/dist/types/dom/net/ajax.d.ts.map +1 -0
  217. package/dist/types/dom/net/broadcastChannel.d.ts +51 -0
  218. package/dist/types/dom/net/broadcastChannel.d.ts.map +1 -0
  219. package/dist/types/dom/net/network.d.ts +80 -0
  220. package/dist/types/dom/net/network.d.ts.map +1 -0
  221. package/dist/types/dom/net/sse.d.ts +72 -0
  222. package/dist/types/dom/net/sse.d.ts.map +1 -0
  223. package/dist/types/dom/net/webrtc.d.ts +149 -0
  224. package/dist/types/dom/net/webrtc.d.ts.map +1 -0
  225. package/dist/types/dom/net/ws.d.ts +70 -0
  226. package/dist/types/dom/net/ws.d.ts.map +1 -0
  227. package/dist/types/dom/query/dnd.d.ts +86 -0
  228. package/dist/types/dom/query/dnd.d.ts.map +1 -0
  229. package/dist/types/dom/query/dom.d.ts +194 -0
  230. package/dist/types/dom/query/dom.d.ts.map +1 -0
  231. package/dist/types/dom/query/events.d.ts +135 -0
  232. package/dist/types/dom/query/events.d.ts.map +1 -0
  233. package/dist/types/dom/query/gesture.d.ts +59 -0
  234. package/dist/types/dom/query/gesture.d.ts.map +1 -0
  235. package/dist/types/dom/query/media.d.ts +156 -0
  236. package/dist/types/dom/query/media.d.ts.map +1 -0
  237. package/dist/types/dom/rendering/chart.d.ts +143 -0
  238. package/dist/types/dom/rendering/chart.d.ts.map +1 -0
  239. package/dist/types/dom/rendering/component.d.ts +92 -0
  240. package/dist/types/dom/rendering/component.d.ts.map +1 -0
  241. package/dist/types/dom/rendering/devtools-ui.d.ts +83 -0
  242. package/dist/types/dom/rendering/devtools-ui.d.ts.map +1 -0
  243. package/dist/types/dom/rendering/devtools.d.ts +68 -0
  244. package/dist/types/dom/rendering/devtools.d.ts.map +1 -0
  245. package/dist/types/dom/rendering/parser.d.ts +216 -0
  246. package/dist/types/dom/rendering/parser.d.ts.map +1 -0
  247. package/dist/types/dom/rendering/reactiveBind.d.ts +101 -0
  248. package/dist/types/dom/rendering/reactiveBind.d.ts.map +1 -0
  249. package/dist/types/dom/rendering/render.d.ts +121 -0
  250. package/dist/types/dom/rendering/render.d.ts.map +1 -0
  251. package/dist/types/dom/rendering/sanitize.d.ts +48 -0
  252. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -0
  253. package/dist/types/dom/rendering/secPolicy.d.ts +89 -0
  254. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -0
  255. package/dist/types/dom/rendering/template.d.ts +251 -0
  256. package/dist/types/dom/rendering/template.d.ts.map +1 -0
  257. package/dist/types/dom/rendering/themeTokens.d.ts +61 -0
  258. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -0
  259. package/dist/types/dom/rendering/uiSession-core.d.ts +192 -0
  260. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -0
  261. package/dist/types/dom/rendering/uiSession-direct.d.ts +63 -0
  262. package/dist/types/dom/rendering/uiSession-direct.d.ts.map +1 -0
  263. package/dist/types/dom/rendering/uiSession-list.d.ts +205 -0
  264. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -0
  265. package/dist/types/dom/rendering/uiSession.d.ts +285 -0
  266. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -0
  267. package/dist/types/dom/rendering/virtualScroll.d.ts +80 -0
  268. package/dist/types/dom/rendering/virtualScroll.d.ts.map +1 -0
  269. package/dist/types/dom/sensors/battery.d.ts +71 -0
  270. package/dist/types/dom/sensors/battery.d.ts.map +1 -0
  271. package/dist/types/dom/sensors/geolocation.d.ts +83 -0
  272. package/dist/types/dom/sensors/geolocation.d.ts.map +1 -0
  273. package/dist/types/dom/sensors/networkInfo.d.ts +82 -0
  274. package/dist/types/dom/sensors/networkInfo.d.ts.map +1 -0
  275. package/dist/types/dom/sensors/sensors.d.ts +191 -0
  276. package/dist/types/dom/sensors/sensors.d.ts.map +1 -0
  277. package/dist/types/dom/sw/backgroundSync.d.ts +48 -0
  278. package/dist/types/dom/sw/backgroundSync.d.ts.map +1 -0
  279. package/dist/types/dom/sw/cache.d.ts +71 -0
  280. package/dist/types/dom/sw/cache.d.ts.map +1 -0
  281. package/dist/types/dom/sw/push.d.ts +77 -0
  282. package/dist/types/dom/sw/push.d.ts.map +1 -0
  283. package/dist/types/dom/sw/serviceWorker.d.ts +57 -0
  284. package/dist/types/dom/sw/serviceWorker.d.ts.map +1 -0
  285. package/dist/types/dom/sw/sharedWorker.d.ts +81 -0
  286. package/dist/types/dom/sw/sharedWorker.d.ts.map +1 -0
  287. package/dist/types/dom/utils/a11y.d.ts +53 -0
  288. package/dist/types/dom/utils/a11y.d.ts.map +1 -0
  289. package/dist/types/dom/utils/clipboard.d.ts +44 -0
  290. package/dist/types/dom/utils/clipboard.d.ts.map +1 -0
  291. package/dist/types/dom/utils/entropyCollector.d.ts +58 -0
  292. package/dist/types/dom/utils/entropyCollector.d.ts.map +1 -0
  293. package/dist/types/dom/utils/focus.d.ts +123 -0
  294. package/dist/types/dom/utils/focus.d.ts.map +1 -0
  295. package/dist/types/dom/utils/form.d.ts +227 -0
  296. package/dist/types/dom/utils/form.d.ts.map +1 -0
  297. package/dist/types/dom/utils/formKit.d.ts +206 -0
  298. package/dist/types/dom/utils/formKit.d.ts.map +1 -0
  299. package/dist/types/dom/utils/keybindings.d.ts +53 -0
  300. package/dist/types/dom/utils/keybindings.d.ts.map +1 -0
  301. package/dist/types/dom/utils/leaderElection.d.ts +70 -0
  302. package/dist/types/dom/utils/leaderElection.d.ts.map +1 -0
  303. package/dist/types/dom/utils/notifications.d.ts +164 -0
  304. package/dist/types/dom/utils/notifications.d.ts.map +1 -0
  305. package/dist/types/dom/utils/permissions.d.ts +35 -0
  306. package/dist/types/dom/utils/permissions.d.ts.map +1 -0
  307. package/dist/types/dom/utils/route.d.ts +117 -0
  308. package/dist/types/dom/utils/route.d.ts.map +1 -0
  309. package/dist/types/dom/utils/ua.d.ts +35 -0
  310. package/dist/types/dom/utils/ua.d.ts.map +1 -0
  311. package/dist/types/dom/utils/webauthn.d.ts +98 -0
  312. package/dist/types/dom/utils/webauthn.d.ts.map +1 -0
  313. package/dist/types/io/binary/reader.d.ts +59 -0
  314. package/dist/types/io/binary/reader.d.ts.map +1 -0
  315. package/dist/types/io/binary/writer.d.ts +56 -0
  316. package/dist/types/io/binary/writer.d.ts.map +1 -0
  317. package/dist/types/io/calc/adler32.d.ts +31 -0
  318. package/dist/types/io/calc/adler32.d.ts.map +1 -0
  319. package/dist/types/io/calc/bigint.d.ts +74 -0
  320. package/dist/types/io/calc/bigint.d.ts.map +1 -0
  321. package/dist/types/io/calc/crc32.d.ts +36 -0
  322. package/dist/types/io/calc/crc32.d.ts.map +1 -0
  323. package/dist/types/io/calc/easing.d.ts +60 -0
  324. package/dist/types/io/calc/easing.d.ts.map +1 -0
  325. package/dist/types/io/codec/b64.d.ts +28 -0
  326. package/dist/types/io/codec/b64.d.ts.map +1 -0
  327. package/dist/types/io/codec/base32.d.ts +28 -0
  328. package/dist/types/io/codec/base32.d.ts.map +1 -0
  329. package/dist/types/io/codec/base58.d.ts +28 -0
  330. package/dist/types/io/codec/base58.d.ts.map +1 -0
  331. package/dist/types/io/codec/buffer.d.ts +66 -0
  332. package/dist/types/io/codec/buffer.d.ts.map +1 -0
  333. package/dist/types/io/codec/cbor.d.ts +43 -0
  334. package/dist/types/io/codec/cbor.d.ts.map +1 -0
  335. package/dist/types/io/codec/csv.d.ts +35 -0
  336. package/dist/types/io/codec/csv.d.ts.map +1 -0
  337. package/dist/types/io/codec/hex.d.ts +28 -0
  338. package/dist/types/io/codec/hex.d.ts.map +1 -0
  339. package/dist/types/io/codec/mime.d.ts +100 -0
  340. package/dist/types/io/codec/mime.d.ts.map +1 -0
  341. package/dist/types/io/codec/msgpack.d.ts +36 -0
  342. package/dist/types/io/codec/msgpack.d.ts.map +1 -0
  343. package/dist/types/io/codec/url.d.ts +52 -0
  344. package/dist/types/io/codec/url.d.ts.map +1 -0
  345. package/dist/types/io/codec/utf8.d.ts +22 -0
  346. package/dist/types/io/codec/utf8.d.ts.map +1 -0
  347. package/dist/types/io/codec/xml.d.ts +91 -0
  348. package/dist/types/io/codec/xml.d.ts.map +1 -0
  349. package/dist/types/io/compress/bitstream.d.ts +51 -0
  350. package/dist/types/io/compress/bitstream.d.ts.map +1 -0
  351. package/dist/types/io/compress/brotli.d.ts +86 -0
  352. package/dist/types/io/compress/brotli.d.ts.map +1 -0
  353. package/dist/types/io/compress/brotli_dict.d.ts +76 -0
  354. package/dist/types/io/compress/brotli_dict.d.ts.map +1 -0
  355. package/dist/types/io/compress/brotli_dict_words.d.ts +43 -0
  356. package/dist/types/io/compress/brotli_dict_words.d.ts.map +1 -0
  357. package/dist/types/io/compress/brotli_frame.d.ts +166 -0
  358. package/dist/types/io/compress/brotli_frame.d.ts.map +1 -0
  359. package/dist/types/io/compress/brotli_shared.d.ts +165 -0
  360. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -0
  361. package/dist/types/io/compress/deflate.d.ts +89 -0
  362. package/dist/types/io/compress/deflate.d.ts.map +1 -0
  363. package/dist/types/io/compress/gzip.d.ts +100 -0
  364. package/dist/types/io/compress/gzip.d.ts.map +1 -0
  365. package/dist/types/io/compress/huffman.d.ts +37 -0
  366. package/dist/types/io/compress/huffman.d.ts.map +1 -0
  367. package/dist/types/io/compress/lz4.d.ts +45 -0
  368. package/dist/types/io/compress/lz4.d.ts.map +1 -0
  369. package/dist/types/io/compress/lz77.d.ts +66 -0
  370. package/dist/types/io/compress/lz77.d.ts.map +1 -0
  371. package/dist/types/io/compress/lzw.d.ts +37 -0
  372. package/dist/types/io/compress/lzw.d.ts.map +1 -0
  373. package/dist/types/io/compress/zip.d.ts +112 -0
  374. package/dist/types/io/compress/zip.d.ts.map +1 -0
  375. package/dist/types/io/compress/zlib.d.ts +97 -0
  376. package/dist/types/io/compress/zlib.d.ts.map +1 -0
  377. package/dist/types/io/i18n/i18n.d.ts +64 -0
  378. package/dist/types/io/i18n/i18n.d.ts.map +1 -0
  379. package/dist/types/io/math/fixed-point.d.ts +30 -0
  380. package/dist/types/io/math/fixed-point.d.ts.map +1 -0
  381. package/dist/types/io/math/geom.d.ts +125 -0
  382. package/dist/types/io/math/geom.d.ts.map +1 -0
  383. package/dist/types/io/math/interp.d.ts +48 -0
  384. package/dist/types/io/math/interp.d.ts.map +1 -0
  385. package/dist/types/io/math/linalg.d.ts +117 -0
  386. package/dist/types/io/math/linalg.d.ts.map +1 -0
  387. package/dist/types/io/math/stats.d.ts +45 -0
  388. package/dist/types/io/math/stats.d.ts.map +1 -0
  389. package/dist/types/io/structures/btree.d.ts +84 -0
  390. package/dist/types/io/structures/btree.d.ts.map +1 -0
  391. package/dist/types/io/structures/heap.d.ts +75 -0
  392. package/dist/types/io/structures/heap.d.ts.map +1 -0
  393. package/dist/types/io/structures/lruCache.d.ts +88 -0
  394. package/dist/types/io/structures/lruCache.d.ts.map +1 -0
  395. package/dist/types/io/structures/ringBuffer.d.ts +82 -0
  396. package/dist/types/io/structures/ringBuffer.d.ts.map +1 -0
  397. package/dist/types/io/structures/tree-walker.d.ts +95 -0
  398. package/dist/types/io/structures/tree-walker.d.ts.map +1 -0
  399. package/dist/types/io/structures/trie.d.ts +71 -0
  400. package/dist/types/io/structures/trie.d.ts.map +1 -0
  401. package/dist/types/io/sync/abort.d.ts +59 -0
  402. package/dist/types/io/sync/abort.d.ts.map +1 -0
  403. package/dist/types/io/sync/atomics.d.ts +107 -0
  404. package/dist/types/io/sync/atomics.d.ts.map +1 -0
  405. package/dist/types/io/sync/cancellable.d.ts +69 -0
  406. package/dist/types/io/sync/cancellable.d.ts.map +1 -0
  407. package/dist/types/io/sync/channel.d.ts +70 -0
  408. package/dist/types/io/sync/channel.d.ts.map +1 -0
  409. package/dist/types/io/sync/mutex.d.ts +39 -0
  410. package/dist/types/io/sync/mutex.d.ts.map +1 -0
  411. package/dist/types/io/sync/semaphore.d.ts +40 -0
  412. package/dist/types/io/sync/semaphore.d.ts.map +1 -0
  413. package/dist/types/io/sync/tokenBucket.d.ts +53 -0
  414. package/dist/types/io/sync/tokenBucket.d.ts.map +1 -0
  415. package/dist/types/io/text/ansi.d.ts +125 -0
  416. package/dist/types/io/text/ansi.d.ts.map +1 -0
  417. package/dist/types/io/text/html-entities.d.ts +35 -0
  418. package/dist/types/io/text/html-entities.d.ts.map +1 -0
  419. package/dist/types/io/text/semver.d.ts +75 -0
  420. package/dist/types/io/text/semver.d.ts.map +1 -0
  421. package/dist/types/io/text/str.d.ts +88 -0
  422. package/dist/types/io/text/str.d.ts.map +1 -0
  423. package/dist/types/io/text/unicode.d.ts +70 -0
  424. package/dist/types/io/text/unicode.d.ts.map +1 -0
  425. package/dist/types/io/time/date.d.ts +73 -0
  426. package/dist/types/io/time/date.d.ts.map +1 -0
  427. package/dist/types/io/timing/clock.d.ts +39 -0
  428. package/dist/types/io/timing/clock.d.ts.map +1 -0
  429. package/dist/types/io/timing/rateLimit.d.ts +40 -0
  430. package/dist/types/io/timing/rateLimit.d.ts.map +1 -0
  431. package/dist/types/io/timing/scheduler.d.ts +122 -0
  432. package/dist/types/io/timing/scheduler.d.ts.map +1 -0
  433. package/dist/types/io/utils/bitmap.d.ts +34 -0
  434. package/dist/types/io/utils/bitmap.d.ts.map +1 -0
  435. package/dist/types/io/utils/errors.d.ts +94 -0
  436. package/dist/types/io/utils/errors.d.ts.map +1 -0
  437. package/dist/types/io/utils/eventBus.d.ts +68 -0
  438. package/dist/types/io/utils/eventBus.d.ts.map +1 -0
  439. package/dist/types/io/utils/queue.d.ts +69 -0
  440. package/dist/types/io/utils/queue.d.ts.map +1 -0
  441. package/dist/types/io/utils/signal.d.ts +362 -0
  442. package/dist/types/io/utils/signal.d.ts.map +1 -0
  443. package/dist/types/io/utils/ui8.d.ts +34 -0
  444. package/dist/types/io/utils/ui8.d.ts.map +1 -0
  445. package/dist/types/io/utils/valid.d.ts +130 -0
  446. package/dist/types/io/utils/valid.d.ts.map +1 -0
  447. package/dist/types/main.d.ts +25 -0
  448. package/dist/types/main.d.ts.map +1 -0
  449. package/dist/types/process/message.d.ts +64 -0
  450. package/dist/types/process/message.d.ts.map +1 -0
  451. package/dist/types/process/rpc.d.ts +35 -0
  452. package/dist/types/process/rpc.d.ts.map +1 -0
  453. package/dist/types/process/workerPool.d.ts +62 -0
  454. package/dist/types/process/workerPool.d.ts.map +1 -0
  455. package/dist/types/sanity/base.d.ts +28 -0
  456. package/dist/types/sanity/base.d.ts.map +1 -0
  457. package/dist/types/sanity/community.d.ts +20 -0
  458. package/dist/types/sanity/community.d.ts.map +1 -0
  459. package/dist/types/sanity/lockdown-apply.d.ts +7 -0
  460. package/dist/types/sanity/lockdown-apply.d.ts.map +1 -0
  461. package/dist/types/sanity/lockdown.d.ts +43 -0
  462. package/dist/types/sanity/lockdown.d.ts.map +1 -0
  463. package/dist/types/sanity/wasm-gate.d.ts +128 -0
  464. package/dist/types/sanity/wasm-gate.d.ts.map +1 -0
  465. package/docs/README.md +301 -0
  466. package/docs/api/README.md +33 -0
  467. package/docs/api/core/README.md +14 -0
  468. package/docs/api/core/logger.md +151 -0
  469. package/docs/api/core/main.md +105 -0
  470. package/docs/api/core/modules.md +123 -0
  471. package/docs/api/core/readyState.md +94 -0
  472. package/docs/api/core/runtime.md +499 -0
  473. package/docs/api/core/worker-helper.md +180 -0
  474. package/docs/api/crypto/README.md +39 -0
  475. package/docs/api/crypto/cipher/README.md +24 -0
  476. package/docs/api/crypto/cipher/aes.md +101 -0
  477. package/docs/api/crypto/cipher/chacha20.md +85 -0
  478. package/docs/api/crypto/hash/README.md +49 -0
  479. package/docs/api/crypto/hash/adf.md +61 -0
  480. package/docs/api/crypto/hash/argon2.md +92 -0
  481. package/docs/api/crypto/hash/blake2b.md +88 -0
  482. package/docs/api/crypto/hash/hkdf.md +82 -0
  483. package/docs/api/crypto/hash/hmac.md +90 -0
  484. package/docs/api/crypto/hash/pbkdf2.md +93 -0
  485. package/docs/api/crypto/hash/poly1305.md +71 -0
  486. package/docs/api/crypto/hash/sha224.md +61 -0
  487. package/docs/api/crypto/hash/sha256.md +84 -0
  488. package/docs/api/crypto/hash/sha3.md +89 -0
  489. package/docs/api/crypto/hash/sha384.md +58 -0
  490. package/docs/api/crypto/hash/sha512.md +73 -0
  491. package/docs/api/crypto/hash/sha512_224.md +59 -0
  492. package/docs/api/crypto/hash/sha512_256.md +58 -0
  493. package/docs/api/crypto/mode/README.md +33 -0
  494. package/docs/api/crypto/mode/cbc.md +69 -0
  495. package/docs/api/crypto/mode/chacha20poly1305.md +77 -0
  496. package/docs/api/crypto/mode/cmac.md +79 -0
  497. package/docs/api/crypto/mode/ctr.md +66 -0
  498. package/docs/api/crypto/mode/gcm.md +93 -0
  499. package/docs/api/crypto/mode/kw.md +84 -0
  500. package/docs/api/crypto/pkc/README.md +48 -0
  501. package/docs/api/crypto/pkc/ecc.md +91 -0
  502. package/docs/api/crypto/pkc/ed25519.md +99 -0
  503. package/docs/api/crypto/pkc/hybridKem.md +178 -0
  504. package/docs/api/crypto/pkc/hybridSign.md +192 -0
  505. package/docs/api/crypto/pkc/ml_dsa.md +99 -0
  506. package/docs/api/crypto/pkc/ml_kem.md +90 -0
  507. package/docs/api/crypto/pkc/rsa.md +87 -0
  508. package/docs/api/crypto/pkc/slh_dsa.md +86 -0
  509. package/docs/api/crypto/pkc/x25519.md +84 -0
  510. package/docs/api/crypto/utils/README.md +39 -0
  511. package/docs/api/crypto/utils/aes_ctr.md +71 -0
  512. package/docs/api/crypto/utils/aes_modes.md +81 -0
  513. package/docs/api/crypto/utils/asn1-oid.md +130 -0
  514. package/docs/api/crypto/utils/asn1.md +69 -0
  515. package/docs/api/crypto/utils/bitArray.md +77 -0
  516. package/docs/api/crypto/utils/bn.md +67 -0
  517. package/docs/api/crypto/utils/jws.md +94 -0
  518. package/docs/api/crypto/utils/keyformat.md +78 -0
  519. package/docs/api/crypto/utils/pad.md +66 -0
  520. package/docs/api/crypto/utils/pem.md +63 -0
  521. package/docs/api/crypto/utils/random.md +103 -0
  522. package/docs/api/crypto/utils/rsaKeygen.md +118 -0
  523. package/docs/api/crypto/utils/totp.md +159 -0
  524. package/docs/api/crypto/utils/uuid.md +98 -0
  525. package/docs/api/crypto/wasm/README.md +76 -0
  526. package/docs/api/crypto/wasm/aes.md +128 -0
  527. package/docs/api/crypto/wasm/argon2.md +110 -0
  528. package/docs/api/crypto/wasm/blake2b.md +103 -0
  529. package/docs/api/crypto/wasm/chacha20poly1305.md +120 -0
  530. package/docs/api/crypto/wasm/cmac.md +119 -0
  531. package/docs/api/crypto/wasm/ecc.md +114 -0
  532. package/docs/api/crypto/wasm/ed25519.md +117 -0
  533. package/docs/api/crypto/wasm/hkdf.md +163 -0
  534. package/docs/api/crypto/wasm/hmac.md +129 -0
  535. package/docs/api/crypto/wasm/ml_dsa.md +99 -0
  536. package/docs/api/crypto/wasm/ml_kem.md +91 -0
  537. package/docs/api/crypto/wasm/pbkdf2.md +111 -0
  538. package/docs/api/crypto/wasm/rsa.md +113 -0
  539. package/docs/api/crypto/wasm/runtime.md +172 -0
  540. package/docs/api/crypto/wasm/sha2.md +95 -0
  541. package/docs/api/crypto/wasm/sha3.md +127 -0
  542. package/docs/api/crypto/wasm/slh_dsa.md +89 -0
  543. package/docs/api/crypto/wasm/x25519.md +116 -0
  544. package/docs/api/crypto/webcrypto/README.md +56 -0
  545. package/docs/api/crypto/webcrypto/aes.md +140 -0
  546. package/docs/api/crypto/webcrypto/aeskw.md +120 -0
  547. package/docs/api/crypto/webcrypto/digest.md +103 -0
  548. package/docs/api/crypto/webcrypto/ecc.md +122 -0
  549. package/docs/api/crypto/webcrypto/ed25519.md +121 -0
  550. package/docs/api/crypto/webcrypto/hkdf.md +141 -0
  551. package/docs/api/crypto/webcrypto/hmac.md +112 -0
  552. package/docs/api/crypto/webcrypto/pbkdf2.md +140 -0
  553. package/docs/api/crypto/webcrypto/rsa.md +149 -0
  554. package/docs/api/crypto/webcrypto/x25519.md +96 -0
  555. package/docs/api/dom/README.md +117 -0
  556. package/docs/api/dom/display/README.md +27 -0
  557. package/docs/api/dom/display/animate.md +113 -0
  558. package/docs/api/dom/display/fullscreen.md +121 -0
  559. package/docs/api/dom/fs/README.md +36 -0
  560. package/docs/api/dom/fs/download.md +108 -0
  561. package/docs/api/dom/fs/fsAccess.md +200 -0
  562. package/docs/api/dom/fs/indexedDB.md +219 -0
  563. package/docs/api/dom/fs/remoteStore.md +158 -0
  564. package/docs/api/dom/fs/storage.md +197 -0
  565. package/docs/api/dom/lifecycle/README.md +11 -0
  566. package/docs/api/dom/lifecycle/idle.md +89 -0
  567. package/docs/api/dom/lifecycle/visibility.md +73 -0
  568. package/docs/api/dom/lifecycle/wakeLock.md +94 -0
  569. package/docs/api/dom/net/README.md +31 -0
  570. package/docs/api/dom/net/ajax.md +176 -0
  571. package/docs/api/dom/net/broadcastChannel.md +110 -0
  572. package/docs/api/dom/net/network.md +137 -0
  573. package/docs/api/dom/net/sse.md +141 -0
  574. package/docs/api/dom/net/webrtc.md +158 -0
  575. package/docs/api/dom/net/ws.md +168 -0
  576. package/docs/api/dom/query/README.md +30 -0
  577. package/docs/api/dom/query/dnd.md +137 -0
  578. package/docs/api/dom/query/dom.md +275 -0
  579. package/docs/api/dom/query/events.md +211 -0
  580. package/docs/api/dom/query/gesture.md +137 -0
  581. package/docs/api/dom/query/media.md +188 -0
  582. package/docs/api/dom/rendering/README.md +41 -0
  583. package/docs/api/dom/rendering/chart.md +149 -0
  584. package/docs/api/dom/rendering/component.md +287 -0
  585. package/docs/api/dom/rendering/devtools-ui.md +129 -0
  586. package/docs/api/dom/rendering/devtools.md +157 -0
  587. package/docs/api/dom/rendering/parser.md +200 -0
  588. package/docs/api/dom/rendering/reactiveBind.md +234 -0
  589. package/docs/api/dom/rendering/render.md +219 -0
  590. package/docs/api/dom/rendering/sanitize.md +97 -0
  591. package/docs/api/dom/rendering/secPolicy.md +155 -0
  592. package/docs/api/dom/rendering/template.md +301 -0
  593. package/docs/api/dom/rendering/themeTokens.md +175 -0
  594. package/docs/api/dom/rendering/uiSession.md +546 -0
  595. package/docs/api/dom/rendering/virtualScroll.md +126 -0
  596. package/docs/api/dom/sensors/README.md +12 -0
  597. package/docs/api/dom/sensors/battery.md +70 -0
  598. package/docs/api/dom/sensors/geolocation.md +115 -0
  599. package/docs/api/dom/sensors/networkInfo.md +73 -0
  600. package/docs/api/dom/sensors/sensors.md +123 -0
  601. package/docs/api/dom/sw/README.md +31 -0
  602. package/docs/api/dom/sw/backgroundSync.md +145 -0
  603. package/docs/api/dom/sw/cache.md +116 -0
  604. package/docs/api/dom/sw/push.md +114 -0
  605. package/docs/api/dom/sw/serviceWorker.md +90 -0
  606. package/docs/api/dom/sw/sharedWorker.md +131 -0
  607. package/docs/api/dom/utils/README.md +25 -0
  608. package/docs/api/dom/utils/a11y.md +143 -0
  609. package/docs/api/dom/utils/clipboard.md +146 -0
  610. package/docs/api/dom/utils/entropyCollector.md +175 -0
  611. package/docs/api/dom/utils/focus.md +140 -0
  612. package/docs/api/dom/utils/form.md +196 -0
  613. package/docs/api/dom/utils/formKit.md +181 -0
  614. package/docs/api/dom/utils/keybindings.md +138 -0
  615. package/docs/api/dom/utils/leaderElection.md +130 -0
  616. package/docs/api/dom/utils/notifications.md +106 -0
  617. package/docs/api/dom/utils/permissions.md +82 -0
  618. package/docs/api/dom/utils/route.md +112 -0
  619. package/docs/api/dom/utils/ua.md +119 -0
  620. package/docs/api/dom/utils/webauthn.md +190 -0
  621. package/docs/api/io/README.md +20 -0
  622. package/docs/api/io/binary/README.md +29 -0
  623. package/docs/api/io/binary/reader.md +126 -0
  624. package/docs/api/io/binary/writer.md +127 -0
  625. package/docs/api/io/calc/README.md +22 -0
  626. package/docs/api/io/calc/adler32.md +75 -0
  627. package/docs/api/io/calc/bigint.md +105 -0
  628. package/docs/api/io/calc/crc32.md +74 -0
  629. package/docs/api/io/calc/easing.md +118 -0
  630. package/docs/api/io/codec/README.md +35 -0
  631. package/docs/api/io/codec/b64.md +92 -0
  632. package/docs/api/io/codec/base32.md +98 -0
  633. package/docs/api/io/codec/base58.md +104 -0
  634. package/docs/api/io/codec/buffer.md +144 -0
  635. package/docs/api/io/codec/cbor.md +179 -0
  636. package/docs/api/io/codec/csv.md +178 -0
  637. package/docs/api/io/codec/hex.md +75 -0
  638. package/docs/api/io/codec/mime.md +156 -0
  639. package/docs/api/io/codec/msgpack.md +142 -0
  640. package/docs/api/io/codec/url.md +265 -0
  641. package/docs/api/io/codec/utf8.md +84 -0
  642. package/docs/api/io/codec/xml.md +87 -0
  643. package/docs/api/io/compress/README.md +62 -0
  644. package/docs/api/io/compress/bitstream.md +131 -0
  645. package/docs/api/io/compress/brotli.md +232 -0
  646. package/docs/api/io/compress/brotli_dict.md +119 -0
  647. package/docs/api/io/compress/brotli_dict_words.md +142 -0
  648. package/docs/api/io/compress/brotli_frame.md +214 -0
  649. package/docs/api/io/compress/brotli_shared.md +144 -0
  650. package/docs/api/io/compress/deflate.md +474 -0
  651. package/docs/api/io/compress/gzip.md +130 -0
  652. package/docs/api/io/compress/huffman.md +210 -0
  653. package/docs/api/io/compress/lz4.md +278 -0
  654. package/docs/api/io/compress/lz77.md +180 -0
  655. package/docs/api/io/compress/lzw.md +121 -0
  656. package/docs/api/io/compress/zip.md +209 -0
  657. package/docs/api/io/compress/zlib.md +125 -0
  658. package/docs/api/io/i18n/README.md +23 -0
  659. package/docs/api/io/i18n/i18n.md +128 -0
  660. package/docs/api/io/math/README.md +24 -0
  661. package/docs/api/io/math/fixed-point.md +115 -0
  662. package/docs/api/io/math/geom.md +144 -0
  663. package/docs/api/io/math/interp.md +115 -0
  664. package/docs/api/io/math/linalg.md +138 -0
  665. package/docs/api/io/math/stats.md +109 -0
  666. package/docs/api/io/structures/README.md +31 -0
  667. package/docs/api/io/structures/btree.md +155 -0
  668. package/docs/api/io/structures/heap.md +166 -0
  669. package/docs/api/io/structures/lruCache.md +156 -0
  670. package/docs/api/io/structures/ringBuffer.md +188 -0
  671. package/docs/api/io/structures/tree-walker.md +132 -0
  672. package/docs/api/io/structures/trie.md +138 -0
  673. package/docs/api/io/sync/README.md +29 -0
  674. package/docs/api/io/sync/abort.md +129 -0
  675. package/docs/api/io/sync/atomics.md +159 -0
  676. package/docs/api/io/sync/cancellable.md +176 -0
  677. package/docs/api/io/sync/channel.md +125 -0
  678. package/docs/api/io/sync/mutex.md +93 -0
  679. package/docs/api/io/sync/semaphore.md +106 -0
  680. package/docs/api/io/sync/tokenBucket.md +139 -0
  681. package/docs/api/io/text/README.md +23 -0
  682. package/docs/api/io/text/ansi.md +182 -0
  683. package/docs/api/io/text/html-entities.md +79 -0
  684. package/docs/api/io/text/semver.md +158 -0
  685. package/docs/api/io/text/str.md +129 -0
  686. package/docs/api/io/text/unicode.md +89 -0
  687. package/docs/api/io/time/README.md +22 -0
  688. package/docs/api/io/time/date.md +128 -0
  689. package/docs/api/io/timing/README.md +32 -0
  690. package/docs/api/io/timing/clock.md +102 -0
  691. package/docs/api/io/timing/rateLimit.md +137 -0
  692. package/docs/api/io/timing/scheduler.md +163 -0
  693. package/docs/api/io/utils/README.md +30 -0
  694. package/docs/api/io/utils/bitmap.md +96 -0
  695. package/docs/api/io/utils/errors.md +165 -0
  696. package/docs/api/io/utils/eventBus.md +162 -0
  697. package/docs/api/io/utils/queue.md +141 -0
  698. package/docs/api/io/utils/signal.md +388 -0
  699. package/docs/api/io/utils/ui8.md +111 -0
  700. package/docs/api/io/utils/valid.md +272 -0
  701. package/docs/api/process/README.md +18 -0
  702. package/docs/api/process/message.md +166 -0
  703. package/docs/api/process/rpc.md +161 -0
  704. package/docs/api/process/workerPool.md +130 -0
  705. package/docs/api/sanity/base.md +132 -0
  706. package/docs/api/sanity/community.md +96 -0
  707. package/docs/api/sanity/lockdown.md +128 -0
  708. package/docs/api/typed.md +85 -0
  709. package/docs/dev/README.md +25 -0
  710. package/docs/dev/provenance.md +80 -0
  711. package/docs/dev/publishing.md +31 -0
  712. package/docs/dev/runtime.md +64 -0
  713. package/docs/dev/testing.md +61 -0
  714. package/docs/dev/types.md +35 -0
  715. package/docs/evidence/pqc-hybrid-evidence.md +438 -0
  716. package/docs/guide/README.md +38 -0
  717. package/docs/guide/_QUICK_REF.md +341 -0
  718. package/docs/guide/by-use-case.md +160 -0
  719. package/docs/guide/doc-format.md +306 -0
  720. package/docs/guide/gesture-dnd-side-channel.md +119 -0
  721. package/docs/guide/getting-started.md +134 -0
  722. package/docs/guide/hmr.md +187 -0
  723. package/docs/guide/integration-bundlers.md +193 -0
  724. package/docs/guide/integrations-hmr.md +103 -0
  725. package/docs/guide/module-creation-workflow.md +342 -0
  726. package/docs/guide/module-pattern.md +244 -0
  727. package/docs/guide/rendering-pipeline.md +422 -0
  728. package/docs/guide/security.md +346 -0
  729. package/docs/guide/test-format.md +190 -0
  730. package/docs/guide/tutorial-todo.md +298 -0
  731. package/docs/guide/typescript.md +215 -0
  732. package/docs/guide/worker-confinement.md +301 -0
  733. package/docs/guide/workers.md +168 -0
  734. package/docs/notes/lz77-deflate-factorization.md +96 -0
  735. package/docs/notes/worker-confinement-spike.md +302 -0
  736. package/docs/tools/README.md +56 -0
  737. package/docs/tools/aot.md +108 -0
  738. package/docs/tools/audit.md +61 -0
  739. package/docs/tools/bundler.md +215 -0
  740. package/docs/tools/codegen.md +64 -0
  741. package/docs/tools/jsx.md +236 -0
  742. package/docs/tools/precompilation.md +88 -0
  743. package/docs/tools/standalone.md +107 -0
  744. package/fw.config.json +129 -0
  745. package/integrations/README.md +52 -0
  746. package/integrations/_shared/catalog.generated.json +207 -0
  747. package/integrations/_shared/config-resolve.js +201 -0
  748. package/integrations/_shared/core.js +362 -0
  749. package/integrations/astro/README.md +96 -0
  750. package/integrations/astro/index.d.ts +42 -0
  751. package/integrations/astro/index.js +94 -0
  752. package/integrations/bun/README.md +62 -0
  753. package/integrations/bun/index.d.ts +30 -0
  754. package/integrations/bun/index.js +134 -0
  755. package/integrations/deno/README.md +55 -0
  756. package/integrations/deno/deno.json +10 -0
  757. package/integrations/esbuild/README.md +75 -0
  758. package/integrations/esbuild/backend.js +147 -0
  759. package/integrations/esbuild/index.d.ts +32 -0
  760. package/integrations/esbuild/index.js +147 -0
  761. package/integrations/eslint/README.md +27 -0
  762. package/integrations/eslint/no-factory-capture.js +99 -0
  763. package/integrations/jest/README.md +45 -0
  764. package/integrations/jest/bun-test-shim.js +43 -0
  765. package/integrations/nestjs/README.md +68 -0
  766. package/integrations/nestjs/index.d.ts +38 -0
  767. package/integrations/nestjs/index.js +99 -0
  768. package/integrations/nextjs/README.md +149 -0
  769. package/integrations/nextjs/index.d.ts +30 -0
  770. package/integrations/nextjs/index.js +98 -0
  771. package/integrations/nodejs/README.md +46 -0
  772. package/integrations/nodejs/package.node.example.json +31 -0
  773. package/integrations/rollup/README.md +65 -0
  774. package/integrations/rollup/backend.js +132 -0
  775. package/integrations/rollup/index.d.ts +32 -0
  776. package/integrations/rollup/index.js +84 -0
  777. package/integrations/turbopack/README.md +56 -0
  778. package/integrations/turbopack/index.d.ts +47 -0
  779. package/integrations/turbopack/index.js +164 -0
  780. package/integrations/typedoc/README.md +57 -0
  781. package/integrations/typedoc/categorize.js +121 -0
  782. package/integrations/typedoc/tsconfig.typedoc.json +14 -0
  783. package/integrations/typedoc/typedoc.json +19 -0
  784. package/integrations/vite/README.md +115 -0
  785. package/integrations/vite/index.d.ts +29 -0
  786. package/integrations/vite/index.js +182 -0
  787. package/integrations/vite/package.json +8 -0
  788. package/integrations/vite/vite-env.d.ts +36 -0
  789. package/integrations/vitest/README.md +77 -0
  790. package/integrations/vitest/bun-test-shim.js +92 -0
  791. package/integrations/vitest/vitest.config.js +41 -0
  792. package/integrations/webpack/README.md +53 -0
  793. package/integrations/webpack/index.d.ts +29 -0
  794. package/integrations/webpack/index.js +182 -0
  795. package/package.json +303 -0
  796. package/src/core/logger.js +373 -0
  797. package/src/core/modules.js +289 -0
  798. package/src/core/readyState.js +119 -0
  799. package/src/core/runtime.js +929 -0
  800. package/src/core/worker-helper.js +261 -0
  801. package/src/crypto/NIST_CONFORMANCE.md +249 -0
  802. package/src/crypto/cipher/aes.acvp.md +74 -0
  803. package/src/crypto/cipher/aes.js +512 -0
  804. package/src/crypto/cipher/chacha20.acvp.md +117 -0
  805. package/src/crypto/cipher/chacha20.js +147 -0
  806. package/src/crypto/hash/adf.acvp.md +144 -0
  807. package/src/crypto/hash/adf.js +127 -0
  808. package/src/crypto/hash/argon2.acvp.md +144 -0
  809. package/src/crypto/hash/argon2.js +517 -0
  810. package/src/crypto/hash/blake2b.acvp.md +122 -0
  811. package/src/crypto/hash/blake2b.js +367 -0
  812. package/src/crypto/hash/hkdf.acvp.md +128 -0
  813. package/src/crypto/hash/hkdf.js +145 -0
  814. package/src/crypto/hash/hmac.acvp.md +110 -0
  815. package/src/crypto/hash/hmac.js +177 -0
  816. package/src/crypto/hash/pbkdf2.acvp.md +122 -0
  817. package/src/crypto/hash/pbkdf2.js +120 -0
  818. package/src/crypto/hash/poly1305.acvp.md +111 -0
  819. package/src/crypto/hash/poly1305.js +126 -0
  820. package/src/crypto/hash/sha224.acvp.md +81 -0
  821. package/src/crypto/hash/sha224.js +60 -0
  822. package/src/crypto/hash/sha256.acvp.md +75 -0
  823. package/src/crypto/hash/sha256.js +217 -0
  824. package/src/crypto/hash/sha3.acvp.md +133 -0
  825. package/src/crypto/hash/sha3.js +391 -0
  826. package/src/crypto/hash/sha384.acvp.md +82 -0
  827. package/src/crypto/hash/sha384.js +61 -0
  828. package/src/crypto/hash/sha512.acvp.md +84 -0
  829. package/src/crypto/hash/sha512.js +314 -0
  830. package/src/crypto/hash/sha512_224.acvp.md +90 -0
  831. package/src/crypto/hash/sha512_224.js +66 -0
  832. package/src/crypto/hash/sha512_256.acvp.md +96 -0
  833. package/src/crypto/hash/sha512_256.js +75 -0
  834. package/src/crypto/mode/cbc.acvp.md +105 -0
  835. package/src/crypto/mode/cbc.js +136 -0
  836. package/src/crypto/mode/chacha20poly1305.acvp.md +116 -0
  837. package/src/crypto/mode/chacha20poly1305.js +190 -0
  838. package/src/crypto/mode/cmac.acvp.md +106 -0
  839. package/src/crypto/mode/cmac.js +172 -0
  840. package/src/crypto/mode/ctr.acvp.md +110 -0
  841. package/src/crypto/mode/ctr.js +174 -0
  842. package/src/crypto/mode/gcm.acvp.md +129 -0
  843. package/src/crypto/mode/gcm.js +333 -0
  844. package/src/crypto/mode/kw.acvp.md +145 -0
  845. package/src/crypto/mode/kw.js +323 -0
  846. package/src/crypto/pkc/ecc.acvp.md +181 -0
  847. package/src/crypto/pkc/ecc.js +941 -0
  848. package/src/crypto/pkc/ed25519.acvp.md +172 -0
  849. package/src/crypto/pkc/ed25519.js +582 -0
  850. package/src/crypto/pkc/hybrid-kat.provenance.md +89 -0
  851. package/src/crypto/pkc/hybridKem.js +255 -0
  852. package/src/crypto/pkc/hybridSign.js +437 -0
  853. package/src/crypto/pkc/ml_dsa.acvp.md +146 -0
  854. package/src/crypto/pkc/ml_dsa.js +984 -0
  855. package/src/crypto/pkc/ml_kem.acvp.md +117 -0
  856. package/src/crypto/pkc/ml_kem.js +596 -0
  857. package/src/crypto/pkc/rsa.acvp.md +187 -0
  858. package/src/crypto/pkc/rsa.js +470 -0
  859. package/src/crypto/pkc/slh_dsa.acvp.md +155 -0
  860. package/src/crypto/pkc/slh_dsa.js +820 -0
  861. package/src/crypto/pkc/x25519.acvp.md +113 -0
  862. package/src/crypto/pkc/x25519.js +290 -0
  863. package/src/crypto/utils/aes_ctr.acvp.md +67 -0
  864. package/src/crypto/utils/aes_ctr.js +134 -0
  865. package/src/crypto/utils/aes_modes.acvp.md +66 -0
  866. package/src/crypto/utils/aes_modes.js +241 -0
  867. package/src/crypto/utils/asn1-oid.js +369 -0
  868. package/src/crypto/utils/asn1.js +343 -0
  869. package/src/crypto/utils/bitArray.js +312 -0
  870. package/src/crypto/utils/bn.js +825 -0
  871. package/src/crypto/utils/jws.js +222 -0
  872. package/src/crypto/utils/keyformat.js +303 -0
  873. package/src/crypto/utils/pad.js +198 -0
  874. package/src/crypto/utils/pem.js +90 -0
  875. package/src/crypto/utils/random.acvp.md +167 -0
  876. package/src/crypto/utils/random.js +846 -0
  877. package/src/crypto/utils/rsaKeygen.acvp.md +158 -0
  878. package/src/crypto/utils/rsaKeygen.js +448 -0
  879. package/src/crypto/utils/totp.js +409 -0
  880. package/src/crypto/utils/uuid.acvp.md +137 -0
  881. package/src/crypto/utils/uuid.js +176 -0
  882. package/src/crypto/wasm/aes.js +494 -0
  883. package/src/crypto/wasm/argon2.js +236 -0
  884. package/src/crypto/wasm/blake2b.js +213 -0
  885. package/src/crypto/wasm/chacha20poly1305.js +238 -0
  886. package/src/crypto/wasm/cmac.js +207 -0
  887. package/src/crypto/wasm/ecc.js +437 -0
  888. package/src/crypto/wasm/ed25519.js +307 -0
  889. package/src/crypto/wasm/hkdf.js +183 -0
  890. package/src/crypto/wasm/hmac.js +215 -0
  891. package/src/crypto/wasm/ml_dsa.js +375 -0
  892. package/src/crypto/wasm/ml_kem.js +313 -0
  893. package/src/crypto/wasm/pbkdf2.js +205 -0
  894. package/src/crypto/wasm/rsa.js +674 -0
  895. package/src/crypto/wasm/runtime.js +400 -0
  896. package/src/crypto/wasm/sha2.js +183 -0
  897. package/src/crypto/wasm/sha3.js +221 -0
  898. package/src/crypto/wasm/slh_dsa.js +397 -0
  899. package/src/crypto/wasm/x25519.js +241 -0
  900. package/src/crypto/webcrypto/aes.js +370 -0
  901. package/src/crypto/webcrypto/aeskw.js +185 -0
  902. package/src/crypto/webcrypto/digest.js +136 -0
  903. package/src/crypto/webcrypto/ecc.js +371 -0
  904. package/src/crypto/webcrypto/ed25519.js +248 -0
  905. package/src/crypto/webcrypto/hkdf.js +132 -0
  906. package/src/crypto/webcrypto/hmac.js +213 -0
  907. package/src/crypto/webcrypto/pbkdf2.js +146 -0
  908. package/src/crypto/webcrypto/rsa.js +415 -0
  909. package/src/crypto/webcrypto/x25519.js +250 -0
  910. package/src/dom/display/animate.js +154 -0
  911. package/src/dom/display/fullscreen.js +305 -0
  912. package/src/dom/fs/download.js +118 -0
  913. package/src/dom/fs/fsAccess.js +307 -0
  914. package/src/dom/fs/indexedDB.js +465 -0
  915. package/src/dom/fs/remoteStore.js +484 -0
  916. package/src/dom/fs/storage.js +440 -0
  917. package/src/dom/lifecycle/idle.js +133 -0
  918. package/src/dom/lifecycle/visibility.js +140 -0
  919. package/src/dom/lifecycle/wakeLock.js +187 -0
  920. package/src/dom/net/ajax.js +303 -0
  921. package/src/dom/net/broadcastChannel.js +89 -0
  922. package/src/dom/net/network.js +260 -0
  923. package/src/dom/net/sse.js +295 -0
  924. package/src/dom/net/webrtc.js +381 -0
  925. package/src/dom/net/ws.js +290 -0
  926. package/src/dom/query/dnd.js +409 -0
  927. package/src/dom/query/dom.js +831 -0
  928. package/src/dom/query/events.js +425 -0
  929. package/src/dom/query/gesture.js +396 -0
  930. package/src/dom/query/media.js +616 -0
  931. package/src/dom/rendering/chart.js +663 -0
  932. package/src/dom/rendering/component.js +469 -0
  933. package/src/dom/rendering/devtools-ui.js +399 -0
  934. package/src/dom/rendering/devtools.js +352 -0
  935. package/src/dom/rendering/parser.js +1055 -0
  936. package/src/dom/rendering/reactiveBind.js +341 -0
  937. package/src/dom/rendering/render.js +601 -0
  938. package/src/dom/rendering/sanitize.js +364 -0
  939. package/src/dom/rendering/secPolicy.js +281 -0
  940. package/src/dom/rendering/template.js +1031 -0
  941. package/src/dom/rendering/themeTokens.js +522 -0
  942. package/src/dom/rendering/uiSession-core.js +597 -0
  943. package/src/dom/rendering/uiSession-direct.js +251 -0
  944. package/src/dom/rendering/uiSession-list.js +751 -0
  945. package/src/dom/rendering/uiSession.js +145 -0
  946. package/src/dom/rendering/virtualScroll.js +341 -0
  947. package/src/dom/sensors/battery.js +153 -0
  948. package/src/dom/sensors/geolocation.js +156 -0
  949. package/src/dom/sensors/networkInfo.js +136 -0
  950. package/src/dom/sensors/sensors.js +340 -0
  951. package/src/dom/sw/backgroundSync.js +113 -0
  952. package/src/dom/sw/cache.js +139 -0
  953. package/src/dom/sw/push.js +181 -0
  954. package/src/dom/sw/serviceWorker.js +193 -0
  955. package/src/dom/sw/sharedWorker.js +192 -0
  956. package/src/dom/utils/a11y.js +244 -0
  957. package/src/dom/utils/clipboard.js +113 -0
  958. package/src/dom/utils/entropyCollector.js +344 -0
  959. package/src/dom/utils/focus.js +421 -0
  960. package/src/dom/utils/form.js +535 -0
  961. package/src/dom/utils/formKit.js +427 -0
  962. package/src/dom/utils/keybindings.js +574 -0
  963. package/src/dom/utils/leaderElection.js +280 -0
  964. package/src/dom/utils/notifications.js +218 -0
  965. package/src/dom/utils/permissions.js +107 -0
  966. package/src/dom/utils/route.js +482 -0
  967. package/src/dom/utils/ua.js +109 -0
  968. package/src/dom/utils/webauthn.js +369 -0
  969. package/src/external/README.md +15 -0
  970. package/src/io/binary/reader.js +374 -0
  971. package/src/io/binary/writer.js +351 -0
  972. package/src/io/calc/adler32.js +94 -0
  973. package/src/io/calc/bigint.js +276 -0
  974. package/src/io/calc/crc32.js +111 -0
  975. package/src/io/calc/easing.js +514 -0
  976. package/src/io/codec/b64.js +235 -0
  977. package/src/io/codec/base32.js +147 -0
  978. package/src/io/codec/base58.js +167 -0
  979. package/src/io/codec/buffer.js +630 -0
  980. package/src/io/codec/cbor.js +550 -0
  981. package/src/io/codec/csv.js +299 -0
  982. package/src/io/codec/hex.js +129 -0
  983. package/src/io/codec/mime.js +398 -0
  984. package/src/io/codec/msgpack.js +491 -0
  985. package/src/io/codec/url.js +530 -0
  986. package/src/io/codec/utf8.js +181 -0
  987. package/src/io/codec/xml.js +428 -0
  988. package/src/io/compress/bitstream.js +199 -0
  989. package/src/io/compress/brotli.js +3073 -0
  990. package/src/io/compress/brotli_dict.bin +432 -0
  991. package/src/io/compress/brotli_dict.js +356 -0
  992. package/src/io/compress/brotli_dict_words.js +157 -0
  993. package/src/io/compress/brotli_frame.js +420 -0
  994. package/src/io/compress/brotli_shared.js +715 -0
  995. package/src/io/compress/deflate.js +1432 -0
  996. package/src/io/compress/gzip.js +406 -0
  997. package/src/io/compress/huffman.js +322 -0
  998. package/src/io/compress/lz4.js +451 -0
  999. package/src/io/compress/lz77.js +408 -0
  1000. package/src/io/compress/lzw.js +332 -0
  1001. package/src/io/compress/zip.js +815 -0
  1002. package/src/io/compress/zlib.js +340 -0
  1003. package/src/io/i18n/i18n.js +236 -0
  1004. package/src/io/math/fixed-point.js +269 -0
  1005. package/src/io/math/geom.js +350 -0
  1006. package/src/io/math/interp.js +263 -0
  1007. package/src/io/math/linalg.js +472 -0
  1008. package/src/io/math/stats.js +339 -0
  1009. package/src/io/structures/btree.js +357 -0
  1010. package/src/io/structures/heap.js +249 -0
  1011. package/src/io/structures/lruCache.js +219 -0
  1012. package/src/io/structures/ringBuffer.js +208 -0
  1013. package/src/io/structures/tree-walker.js +413 -0
  1014. package/src/io/structures/trie.js +219 -0
  1015. package/src/io/sync/abort.js +196 -0
  1016. package/src/io/sync/atomics.js +342 -0
  1017. package/src/io/sync/cancellable.js +279 -0
  1018. package/src/io/sync/channel.js +301 -0
  1019. package/src/io/sync/mutex.js +148 -0
  1020. package/src/io/sync/semaphore.js +156 -0
  1021. package/src/io/sync/tokenBucket.js +208 -0
  1022. package/src/io/text/ansi.js +536 -0
  1023. package/src/io/text/html-entities.js +143 -0
  1024. package/src/io/text/semver.js +375 -0
  1025. package/src/io/text/str.js +243 -0
  1026. package/src/io/text/unicode.js +188 -0
  1027. package/src/io/time/date.js +355 -0
  1028. package/src/io/timing/clock.js +79 -0
  1029. package/src/io/timing/rateLimit.js +264 -0
  1030. package/src/io/timing/scheduler.js +351 -0
  1031. package/src/io/utils/bitmap.js +94 -0
  1032. package/src/io/utils/errors.js +269 -0
  1033. package/src/io/utils/eventBus.js +315 -0
  1034. package/src/io/utils/queue.js +223 -0
  1035. package/src/io/utils/signal.js +858 -0
  1036. package/src/io/utils/ui8.js +99 -0
  1037. package/src/io/utils/valid.js +556 -0
  1038. package/src/main.js +41 -0
  1039. package/src/polyfill/README.md +9 -0
  1040. package/src/process/message.js +257 -0
  1041. package/src/process/rpc.js +286 -0
  1042. package/src/process/workerPool.js +392 -0
  1043. package/src/sanity/base.js +374 -0
  1044. package/src/sanity/community.js +254 -0
  1045. package/src/sanity/lockdown-apply.js +58 -0
  1046. package/src/sanity/lockdown.js +408 -0
  1047. package/src/sanity/wasm-gate.js +316 -0
  1048. package/src/typed.js +53 -0
  1049. package/third-party/NOTICE-penner-easing +88 -0
  1050. package/third-party/NOTICE-sjcl +50 -0
  1051. package/tools/_lib/cli-help.js +55 -0
  1052. package/tools/rendering/aot/index.js +148 -0
  1053. package/tools/rendering/aot/lib/dom-codegen.js +295 -0
  1054. package/tools/rendering/jsx/index.js +654 -0
  1055. package/tools/rendering/precompilation/index.js +368 -0
  1056. package/types/registry.generated.d.ts +217 -0
  1057. package/types/typed.d.ts +106 -0
@@ -0,0 +1,437 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview Composite (hybrid PQ/T) signatures — `draft-ietf-lamps-pq-composite-sigs`.
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
10
+ * primitives — no novel cryptography. Two registered variants:
11
+ *
12
+ * - `mldsa65_ed25519` — ML-DSA-65 ∧ Ed25519 (OID 1.3.6.1.5.5.7.6.48)
13
+ * - `mldsa65_ecdsaP256` — ML-DSA-65 ∧ ECDSA-P-256 (OID 1.3.6.1.5.5.7.6.45)
14
+ *
15
+ * ## Construction (FROZEN, vector-verified)
16
+ *
17
+ * Both components sign the SAME representative message
18
+ *
19
+ * M' = Prefix || Label || len(ctx) || ctx || PH(M) [draft §5.3]
20
+ * Prefix = ASCII "CompositeAlgorithmSignatures2025" (32 bytes) [draft §5.2]
21
+ * Label = the per-variant ASCII label (see LABELS) [draft §11]
22
+ * len(ctx) = one byte (ctx is 0..255 bytes); ctx = caller context (default ∅)
23
+ * PH(M) = SHA-512(M)
24
+ *
25
+ * sig_ML-DSA = ML-DSA-65.Sign(M', mldsa_ctx = Label) (pure, FIPS 204 Alg 2)
26
+ * sig_trad = Ed25519.Sign(M') (its own ctx unused), OR
27
+ * ECDSA-P256.Sign(SHA-256(M')) (DER-encoded r,s)
28
+ *
29
+ * Composite verify = AND of both component verifies over the reconstructed M'
30
+ * (draft §5.4). Any stripped / swapped / tampered component ⇒ reject (no
31
+ * downgrade). The current draft (main commit 1bb9f5c6, retained by the numbered
32
+ * revision -19) has NO per-signature randomizer `r` and uses an ASCII `Label`
33
+ * (not a DER-OID Domain). This exact wiring reproduces the official LAMPS
34
+ * interop vectors — do not deviate.
35
+ *
36
+ * ## Digest domain (W1 carry-forward c)
37
+ *
38
+ * fw's pure-JS `sha512.hash()` consumes a **bitArray** (word-packed `number[]`),
39
+ * NOT a raw `Uint8Array`. This module hashes message bytes through the bitArray
40
+ * domain (`_ui8ToBa` / `_baToUi8`, the SJCL big-endian packing) before hashing.
41
+ * Feeding raw bytes yields a wrong-but-deterministic digest that passes a
42
+ * self-consistent round-trip yet fails official vectors — a green round-trip is
43
+ * NOT evidence of a correct digest, only the official vectors are.
44
+ *
45
+ * ## Encoding (§3)
46
+ *
47
+ * Wire/at-rest public and secret keys use a **length-prefixed TLV**
48
+ * (`schemeId(1) || u16(len) || component …`) so a parser cannot be tricked into
49
+ * re-slicing composite bytes (guards component-splicing). The Ed25519 composite
50
+ * signature is fixed slices `mldsaSig(3309) || edSig(64)` (identical to the
51
+ * official wire form). The ECDSA-P256 signature length-prefixes its
52
+ * variable-length DER component: `mldsaSig(3309) || u16(derLen) || DER`.
53
+ *
54
+ * ## Limits & non-claims (§6/§9)
55
+ *
56
+ * - NOT FIPS-validated as a composite; the underlying ML-DSA / Ed25519 / ECDSA
57
+ * primitives carry their own validation status.
58
+ * - Zeroization is BEST-EFFORT only: JS cannot guarantee a wipe (GC copies, no
59
+ * `mlock`, JIT-resident intermediates). Never a security guarantee.
60
+ * - Constant-time is NOT a security boundary in browser JS/WASM (JIT, GC). The
61
+ * ECDSA-P256 scalar path in fw `ecc` is windowed (cache-timing sensitive).
62
+ * - 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
+ */
66
+
67
+ import { ml_dsa } from './ml_dsa.js';
68
+ import { ed25519 } from './ed25519.js';
69
+ import { ecc } from './ecc.js';
70
+ import { sha512 } from '../hash/sha512.js';
71
+ import { sha256 } from '../hash/sha256.js';
72
+ import { random } from '../utils/random.js';
73
+ import { utf8 } from '../../io/codec/utf8.js';
74
+
75
+ /**
76
+ * One composite-signature variant.
77
+ * @typedef {object} HybridSignVariant
78
+ * @property {object} lengths Component and container byte lengths.
79
+ * @property {() => ({ publicKey: Uint8Array, secretKey: Uint8Array }|false)} keygen
80
+ * Generate a composite key pair (independent per-component seeds). TLV-encoded.
81
+ * @property {(secretKey: Uint8Array, message: Uint8Array, ctx?: Uint8Array) => (Uint8Array|false)} sign
82
+ * Composite sign; `false` on invalid input.
83
+ * @property {(publicKey: Uint8Array, message: Uint8Array, signature: Uint8Array, ctx?: Uint8Array) => boolean} verify
84
+ * Composite verify (AND of both components); `false` on any invalid input.
85
+ */
86
+
87
+ /**
88
+ * Public surface of `hybridSign.factory(...)`.
89
+ * @typedef {object} HybridSignApi
90
+ * @property {HybridSignVariant} mldsa65_ed25519 ML-DSA-65 ∧ Ed25519.
91
+ * @property {HybridSignVariant} mldsa65_ecdsaP256 ML-DSA-65 ∧ ECDSA-P-256.
92
+ * @property {object} _internal Test-only escape hatch.
93
+ */
94
+
95
+ export const hybridSign = {
96
+ name: 'hybridSign',
97
+ version: '1.0.0',
98
+ type: 'fw.crypto.pkc',
99
+ // NOTE — `sha256` and `random` extend the W0 FINDINGS §2 dependency sketch
100
+ // (`ml_dsa,ed25519,ecc,sha512,utf8`). Both are load-bearing and vector-/
101
+ // implementation-justified: the ECDSA-P256 component hashes M' with SHA-256
102
+ // (proven against the official vectors — SHA-512/384 fail), and Ed25519
103
+ // keygen needs a 32-byte seed (fw `ed25519` has no entropy source of its own,
104
+ // unlike `ml_dsa`/`ecc` which self-seed). Flagged for human ratification.
105
+ dependencies: ['ml_dsa', 'ed25519', 'ecc', 'sha512', 'sha256', 'random', 'utf8'],
106
+ deps: [ml_dsa, ed25519, ecc, sha512, sha256, random, utf8],
107
+
108
+ /**
109
+ * @param {*} ml_dsa
110
+ * @param {*} ed25519
111
+ * @param {*} ecc
112
+ * @param {*} sha512
113
+ * @param {*} sha256
114
+ * @param {*} random
115
+ * @param {*} utf8
116
+ * @returns {HybridSignApi}
117
+ */
118
+ factory(ml_dsa, ed25519, ecc, sha512, sha256, random, utf8) {
119
+
120
+ const MLDSA = ml_dsa.ml_dsa65;
121
+
122
+ // ── Sizes (bytes) ────────────────────────────────────────────
123
+ const MLDSA_PK = 1952;
124
+ const MLDSA_SK = 4032;
125
+ const MLDSA_SIG = 3309;
126
+ const ED_PK = 32;
127
+ const ED_SK = 64; // seed || pub
128
+ const ED_SIG = 64;
129
+ const EC_PK = 65; // SEC1 uncompressed 0x04 || X(32) || Y(32)
130
+ const EC_SK = 32; // raw P-256 scalar
131
+
132
+ const SCHEME_ED = 0x01;
133
+ const SCHEME_EC = 0x02;
134
+
135
+ // draft §5.2 fixed prefix (scheme-wide domain separation).
136
+ const PREFIX = utf8.toBytes('CompositeAlgorithmSignatures2025');
137
+ // draft §11 per-variant labels (ASCII → bytes). Also the inner ML-DSA ctx.
138
+ // NOTE: the ECDSA label follows algParams.md / the committed vectors, NOT
139
+ // the inconsistent labelsTable.md ("COMPSIG-MLDSA65-P256-SHA512").
140
+ const LABEL_ED = utf8.toBytes('COMPSIG-MLDSA65-Ed25519-SHA512');
141
+ const LABEL_EC = utf8.toBytes('COMPSIG-MLDSA65-ECDSA-P256-SHA512');
142
+
143
+ const HEX = '0123456789abcdef';
144
+
145
+ // ── byte-domain helpers (pure; replicate bitArray big-endian packing) ──
146
+ // Local wrappers avoid a `bitArray` dependency while still hashing through
147
+ // the correct (word-packed) domain — the fix for the W0 digest-domain bug.
148
+ function _partial(len, x, end) {
149
+ if (len === 32) return x;
150
+ return (end ? x | 0 : x << (32 - len)) + len * 0x10000000000;
151
+ }
152
+ function _ui8ToBa(u8) {
153
+ const out = [];
154
+ let tmp = 0, i;
155
+ for (i = 0; i < u8.length; i++) {
156
+ tmp = tmp << 8 | u8[i];
157
+ if ((i & 3) === 3) { out.push(tmp); tmp = 0; }
158
+ }
159
+ if (i & 3) out.push(_partial(8 * (i & 3), tmp));
160
+ return out;
161
+ }
162
+ function _baToUi8(arr) {
163
+ const out = [];
164
+ let bl = 0, tmp;
165
+ // bitLength: last element may be a partial word.
166
+ if (arr.length) {
167
+ const last = arr[arr.length - 1];
168
+ const lastBits = Math.round(last / 0x10000000000) || 32;
169
+ bl = (arr.length - 1) * 32 + lastBits;
170
+ }
171
+ for (let i = 0; i < bl / 8; i++) {
172
+ if ((i & 3) === 0) tmp = arr[i / 4];
173
+ out.push(tmp >>> 8 >>> 8 >>> 8);
174
+ tmp <<= 8;
175
+ }
176
+ return new Uint8Array(out);
177
+ }
178
+ /** SHA-512 over raw bytes (through the bitArray domain). Returns 64 bytes. */
179
+ function _sha512Bytes(u8) {
180
+ return _baToUi8(sha512.hash(_ui8ToBa(u8)));
181
+ }
182
+ function _concat(chunks) {
183
+ let n = 0;
184
+ for (const c of chunks) n += c.length;
185
+ const out = new Uint8Array(n);
186
+ let o = 0;
187
+ for (const c of chunks) { out.set(c, o); o += c.length; }
188
+ return out;
189
+ }
190
+ function _toHex(u8) {
191
+ let s = '';
192
+ for (const b of u8) s += HEX[b >> 4] + HEX[b & 15];
193
+ return s;
194
+ }
195
+ function _u16(n) { return Uint8Array.from([(n >>> 8) & 0xff, n & 0xff]); }
196
+
197
+ /** Build the composite representative M' (draft §5.3). PH = SHA-512. */
198
+ function _buildMprime(label, message, ctx) {
199
+ return _concat([PREFIX, label, Uint8Array.from([ctx.length & 0xff]), ctx, _sha512Bytes(message)]);
200
+ }
201
+
202
+ // ── TLV container (schemeId || u16 len || component …) ────────
203
+ function _encodeTlv(schemeId, parts) {
204
+ const out = [Uint8Array.from([schemeId])];
205
+ for (const p of parts) { out.push(_u16(p.length)); out.push(p); }
206
+ return _concat(out);
207
+ }
208
+ /**
209
+ * Parse `nParts` length-prefixed components after a 1-byte schemeId.
210
+ * Returns the component subarrays, or `false` on any structural error
211
+ * (wrong scheme, truncation, trailing bytes) — the anti-splice guard.
212
+ */
213
+ function _decodeTlv(bytes, schemeId, nParts) {
214
+ if (!(bytes instanceof Uint8Array) || bytes.length < 1 || bytes[0] !== schemeId) return false;
215
+ const parts = [];
216
+ let i = 1;
217
+ for (let k = 0; k < nParts; k++) {
218
+ if (i + 2 > bytes.length) return false;
219
+ const len = (bytes[i] << 8) | bytes[i + 1];
220
+ i += 2;
221
+ if (i + len > bytes.length) return false;
222
+ parts.push(bytes.subarray(i, i + len));
223
+ i += len;
224
+ }
225
+ if (i !== bytes.length) return false; // no trailing / spliced bytes
226
+ return parts;
227
+ }
228
+
229
+ // ── DER (ECDSA r,s) ──────────────────────────────────────────
230
+ function _derInt(v) {
231
+ let s = 0;
232
+ while (s < v.length - 1 && v[s] === 0) s++;
233
+ let body = v.subarray(s);
234
+ if (body[0] & 0x80) body = _concat([Uint8Array.from([0]), body]);
235
+ return _concat([Uint8Array.from([0x02, body.length]), body]);
236
+ }
237
+ function _rsToDer(rs) {
238
+ const seq = _concat([_derInt(rs.subarray(0, 32)), _derInt(rs.subarray(32, 64))]);
239
+ if (seq.length > 127) return false; // P-256 DER SEQUENCE is short-form
240
+ return _concat([Uint8Array.from([0x30, seq.length]), seq]);
241
+ }
242
+ /** DER SEQUENCE{INTEGER r, INTEGER s} → 64-byte r||s, or false. */
243
+ function _derToRs(der) {
244
+ try {
245
+ let i = 0;
246
+ if (der[i++] !== 0x30) return false;
247
+ const seqLen = der[i++];
248
+ if (seqLen & 0x80) return false; // long form unexpected for P-256
249
+ if (i + seqLen !== der.length) return false;
250
+ const readInt = () => {
251
+ if (der[i++] !== 0x02) return false;
252
+ const l = der[i++];
253
+ if (i + l > der.length) return false;
254
+ const v = der.subarray(i, i + l);
255
+ i += l;
256
+ return v;
257
+ };
258
+ const rB = readInt(); if (rB === false) return false;
259
+ const sB = readInt(); if (sB === false) return false;
260
+ const to32 = (v) => {
261
+ let s = 0;
262
+ while (s < v.length - 1 && v[s] === 0) s++;
263
+ v = v.subarray(s);
264
+ if (v.length > 32) return false;
265
+ const o = new Uint8Array(32);
266
+ o.set(v, 32 - v.length);
267
+ return o;
268
+ };
269
+ const r32 = to32(rB); if (r32 === false) return false;
270
+ const s32 = to32(sB); if (s32 === false) return false;
271
+ return _concat([r32, s32]);
272
+ } catch (_e) {
273
+ return false;
274
+ }
275
+ }
276
+
277
+ // ── ML-DSA component (shared) ────────────────────────────────
278
+ function _mldsaKeygen() {
279
+ const k = MLDSA.keygen(); // self-seeds via `random`
280
+ if (k === false) return false;
281
+ return k;
282
+ }
283
+
284
+ // ══════════════════ Ed25519 variant ══════════════════════════
285
+ const P256 = ecc.curves.c256;
286
+
287
+ function _edKeygen() {
288
+ const mk = _mldsaKeygen();
289
+ if (mk === false) return false;
290
+ const seed = random.bytes(ED_SK / 2); // 32-byte independent seed
291
+ const ek = ed25519.keyPair(seed);
292
+ if (ek === false) return false;
293
+ const publicKey = _encodeTlv(SCHEME_ED, [mk.publicKey, ek.publicKey]);
294
+ const secretKey = _encodeTlv(SCHEME_ED, [mk.secretKey, ek.privateKey]);
295
+ // best-effort zeroization of the transient seed (see §6 — not a guarantee)
296
+ seed.fill(0);
297
+ return { publicKey, secretKey };
298
+ }
299
+
300
+ function _edSign(secretKey, message, ctx) {
301
+ const parts = _decodeTlv(secretKey, SCHEME_ED, 2);
302
+ if (parts === false) return false;
303
+ const [mldsaSk, edSk] = parts;
304
+ if (mldsaSk.length !== MLDSA_SK || edSk.length !== ED_SK) return false;
305
+ const context = ctx || new Uint8Array(0);
306
+ if (context.length > 255) return false;
307
+ const mPrime = _buildMprime(LABEL_ED, message, context);
308
+ const sigMl = MLDSA.sign(mPrime, mldsaSk, LABEL_ED);
309
+ if (sigMl === false) return false;
310
+ const sigEd = ed25519.sign(edSk, mPrime);
311
+ if (sigEd === false) return false;
312
+ return _concat([sigMl, sigEd]); // fixed slices, no randomizer
313
+ }
314
+
315
+ function _edVerify(publicKey, message, signature, ctx) {
316
+ const parts = _decodeTlv(publicKey, SCHEME_ED, 2);
317
+ if (parts === false) return false;
318
+ const [mldsaPk, edPk] = parts;
319
+ if (mldsaPk.length !== MLDSA_PK || edPk.length !== ED_PK) return false;
320
+ if (!(signature instanceof Uint8Array) || signature.length !== MLDSA_SIG + ED_SIG) return false;
321
+ const context = ctx || new Uint8Array(0);
322
+ if (context.length > 255) return false;
323
+ const mPrime = _buildMprime(LABEL_ED, message, context);
324
+ const sigMl = signature.subarray(0, MLDSA_SIG);
325
+ const sigEd = signature.subarray(MLDSA_SIG);
326
+ const okMl = MLDSA.verify(sigMl, mPrime, mldsaPk, LABEL_ED);
327
+ const okEd = ed25519.verify(edPk, mPrime, sigEd);
328
+ return okMl === true && okEd === true; // AND — both MUST hold
329
+ }
330
+
331
+ // ══════════════════ ECDSA-P256 variant ═══════════════════════
332
+ function _ecKeygen() {
333
+ const mk = _mldsaKeygen();
334
+ if (mk === false) return false;
335
+ const kp = ecc.ecdsa.generateKeys(256); // self-seeds via ecc's bn.random
336
+ if (kp === false) return false;
337
+ const g = kp.pub.get();
338
+ const X = _baToUi8(g.x);
339
+ const Y = _baToUi8(g.y);
340
+ const ecPk = new Uint8Array(EC_PK);
341
+ ecPk[0] = 0x04;
342
+ ecPk.set(X.subarray(Math.max(0, X.length - 32)), 1 + Math.max(0, 32 - X.length));
343
+ ecPk.set(Y.subarray(Math.max(0, Y.length - 32)), 33 + Math.max(0, 32 - Y.length));
344
+ const scRaw = _baToUi8(kp.sec.get());
345
+ const ecSk = new Uint8Array(EC_SK);
346
+ ecSk.set(scRaw.subarray(Math.max(0, scRaw.length - 32)), Math.max(0, 32 - scRaw.length));
347
+ const publicKey = _encodeTlv(SCHEME_EC, [mk.publicKey, ecPk]);
348
+ const secretKey = _encodeTlv(SCHEME_EC, [mk.secretKey, ecSk]);
349
+ scRaw.fill(0);
350
+ return { publicKey, secretKey };
351
+ }
352
+
353
+ function _ecSign(secretKey, message, ctx) {
354
+ const parts = _decodeTlv(secretKey, SCHEME_EC, 2);
355
+ if (parts === false) return false;
356
+ const [mldsaSk, ecSk] = parts;
357
+ if (mldsaSk.length !== MLDSA_SK || ecSk.length !== EC_SK) return false;
358
+ const context = ctx || new Uint8Array(0);
359
+ if (context.length > 255) return false;
360
+ const mPrime = _buildMprime(LABEL_EC, message, context);
361
+ const sigMl = MLDSA.sign(mPrime, mldsaSk, LABEL_EC);
362
+ if (sigMl === false) return false;
363
+ const secObj = ecc.deserialize({ type: 'ecdsa', secretKey: true, curve: 'c256', exponent: _toHex(ecSk) });
364
+ if (secObj === false) return false;
365
+ const eHash = sha256.hash(_ui8ToBa(mPrime)); // ECDSA inner hash
366
+ const rsBits = secObj.sign(eHash, {}); // RFC 6979 deterministic
367
+ const der = _rsToDer(_baToUi8(rsBits));
368
+ if (der === false) return false;
369
+ return _concat([sigMl, _u16(der.length), der]); // length-prefixed DER
370
+ }
371
+
372
+ function _ecVerify(publicKey, message, signature, ctx) {
373
+ const parts = _decodeTlv(publicKey, SCHEME_EC, 2);
374
+ if (parts === false) return false;
375
+ const [mldsaPk, ecPk] = parts;
376
+ if (mldsaPk.length !== MLDSA_PK || ecPk.length !== EC_PK || ecPk[0] !== 0x04) return false;
377
+ if (!(signature instanceof Uint8Array) || signature.length < MLDSA_SIG + 2) return false;
378
+ const derLen = (signature[MLDSA_SIG] << 8) | signature[MLDSA_SIG + 1];
379
+ if (MLDSA_SIG + 2 + derLen !== signature.length) return false;
380
+ const context = ctx || new Uint8Array(0);
381
+ if (context.length > 255) return false;
382
+ const mPrime = _buildMprime(LABEL_EC, message, context);
383
+ const sigMl = signature.subarray(0, MLDSA_SIG);
384
+ const der = signature.subarray(MLDSA_SIG + 2);
385
+ const okMl = MLDSA.verify(sigMl, mPrime, mldsaPk, LABEL_EC);
386
+ if (okMl !== true) return false;
387
+ const rs = _derToRs(der);
388
+ if (rs === false) return false;
389
+ const point = P256.fromBits(_ui8ToBa(ecPk.subarray(1)));
390
+ if (point === false) return false;
391
+ const pub = new ecc.ecdsa.publicKey(P256, point);
392
+ const eHash = sha256.hash(_ui8ToBa(mPrime));
393
+ const okEc = pub.verify(eHash, _ui8ToBa(rs));
394
+ return okEc === true;
395
+ }
396
+
397
+ return {
398
+ mldsa65_ed25519: {
399
+ lengths: Object.freeze({
400
+ mldsaPk: MLDSA_PK, tradPk: ED_PK, mldsaSk: MLDSA_SK, tradSk: ED_SK,
401
+ mldsaSig: MLDSA_SIG, tradSig: ED_SIG,
402
+ publicKey: 1 + 2 + MLDSA_PK + 2 + ED_PK, // TLV container
403
+ secretKey: 1 + 2 + MLDSA_SK + 2 + ED_SK,
404
+ signature: MLDSA_SIG + ED_SIG // fixed 3373
405
+ }),
406
+ keygen: _edKeygen,
407
+ sign: _edSign,
408
+ verify: _edVerify
409
+ },
410
+ mldsa65_ecdsaP256: {
411
+ lengths: Object.freeze({
412
+ mldsaPk: MLDSA_PK, tradPk: EC_PK, mldsaSk: MLDSA_SK, tradSk: EC_SK,
413
+ mldsaSig: MLDSA_SIG,
414
+ publicKey: 1 + 2 + MLDSA_PK + 2 + EC_PK, // TLV container
415
+ secretKey: 1 + 2 + MLDSA_SK + 2 + EC_SK,
416
+ signature: 'variable' // DER component
417
+ }),
418
+ keygen: _ecKeygen,
419
+ sign: _ecSign,
420
+ verify: _ecVerify
421
+ },
422
+
423
+ // Test-only escape hatch (mirrors ecc._internal). Not a public API.
424
+ _internal: {
425
+ buildMprime: _buildMprime,
426
+ sha512Bytes: _sha512Bytes,
427
+ ui8ToBa: _ui8ToBa,
428
+ baToUi8: _baToUi8,
429
+ encodeTlv: _encodeTlv,
430
+ decodeTlv: _decodeTlv,
431
+ derToRs: _derToRs,
432
+ labels: { ed: LABEL_ED, ecdsaP256: LABEL_EC },
433
+ schemes: { ed: SCHEME_ED, ecdsaP256: SCHEME_EC }
434
+ }
435
+ };
436
+ }
437
+ };
@@ -0,0 +1,146 @@
1
+ # `ml_dsa.js` — ACVP / NIST conformance
2
+
3
+ ## Standards
4
+
5
+ - **Primary**: **NIST FIPS 204** — *Module-Lattice-Based Digital
6
+ Signature Standard* (August 2024). Implements ML-DSA-44, ML-DSA-65,
7
+ ML-DSA-87 (§5 "ML-DSA", §6 "Internal functions").
8
+ - **ACVP draft**: `references/NIST/ACVP/src/draft-celi-acvp-ml-dsa.adoc`
9
+ - **Vectors**:
10
+ - `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ML-DSA-keyGen-FIPS204/`
11
+ - `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ML-DSA-sigGen-FIPS204/`
12
+ - `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ML-DSA-sigVer-FIPS204/`
13
+
14
+ ## Implemented algorithm
15
+
16
+ `ml_dsa.factory(sha3, bitArray, random)` exposes `ml_dsa44`, `ml_dsa65`,
17
+ `ml_dsa87` (FIPS 204 Table 1 parameters: K∈{4,6,8}, L∈{4,5,7},
18
+ η∈{2,4,2}, γ₁∈{2¹⁷, 2¹⁹, 2¹⁹}, γ₂={(q−1)/88, (q−1)/32, (q−1)/32},
19
+ τ∈{39,49,60}, ω∈{80,55,75}, c̃∈{32,48,64}). FIPS 204 §5 (ML-DSA)
20
+ implementation on top of §6 (internal sign/verify) with NTT modulo
21
+ q=8380417 (root 1753, N=256). Public API (`Uint8Array`):
22
+
23
+ - `keygen(seed?)` → `{ publicKey, secretKey }`. seed = 32 bytes; sk in
24
+ the full FIPS 204 format = packed `(ρ ‖ K ‖ tr ‖ s₁ ‖ s₂ ‖ t₀)`.
25
+ - `sign(msg, secretKey, ctx?, rnd?)` → signature (`Uint8Array` or `false`).
26
+ ctx ≤ 255 bytes (§5.4 wrapper M' = `0x00 ‖ |ctx| ‖ ctx ‖ msg`). rnd =
27
+ 32 bytes; **zero by default (deterministic)**, hedged mode if supplied.
28
+ - `verify(sig, msg, publicKey, ctx?)` → `true | false`. Constant-time
29
+ comparison of the recomputed c̃ (accumulated XOR + diff===0, line 733-736).
30
+
31
+ **Iteration E3 (FIPS 140-3 upgrade plan)**: added the
32
+ **HashML-DSA** variants (FIPS 204 §5.4 algos 4+5), the **internal**
33
+ interface (§6.2 raw, without the M' wrapper), and the **externalMu**
34
+ mode (pre-computed mu):
35
+ - `signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` / `verifyPh(sig, msg, pk, hashAlg, hashMod, ctx?)`.
36
+ Supported hashes: `SHA2-{224,256,384,512}`, `SHA2-512/{224,256}`,
37
+ `SHA3-{224,256,384,512}`, `SHAKE-{128,256}` (12 algorithms; DER-encoded
38
+ OIDs conforming to FIPS 204).
39
+ - `_internal.signInternal(M, sk, rnd?)` / `_internal.verifyInternal(sig, M, pk)`:
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)`:
42
+ skips the mu = SHAKE256(tr || M, 64) derivation; the caller supplies mu.
43
+
44
+ ## Test coverage
45
+
46
+ ### Integrated official vectors
47
+
48
+ | Source | ACVP reference | Test (`describe`) | Property verified |
49
+ |---|---|---|---|
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.) |
54
+ | Pre-existing (Wycheproof) | ML-DSA-65 KAT keygen/sign/verify "Hello world" | `ML-DSA-65 KAT` | byte-exact pk + sign + verify |
55
+ | Pre-existing | round-trip 44/65/87 | `ML-DSA-{44,65,87} round-trip` | `verify(sign(msg)) == true` |
56
+ | Pre-existing | tampering signature | `ML-DSA-65 verify rejects tampered signature` | bit-flip rejection |
57
+ | Pre-existing | NTT round-trip | `NTT round-trip` | `nttInv(ntt(f)) == f` mod q |
58
+
59
+ ### Security properties tested
60
+
61
+ - [x] **Determinism + hedge** — sign(rnd=0) reproduces 9 ACVP det=true
62
+ vectors byte-exact; sign(rnd=ACVP_rnd) reproduces 9 ACVP det=false
63
+ vectors byte-exact. Covers both FIPS 204 §5.6 modes.
64
+ - [x] **Constant-time c̃ verify comparison** — accumulated XOR + `diff===0`
65
+ (lines 733-736 ml_dsa.js). No inter-byte early return.
66
+ - [x] **sk/pk/sig length validation** — early return false (§6.2/6.3
67
+ lines 549-552, 677-678).
68
+ - [x] **M' wrapper §5.4** — `0x00 ‖ |ctx| ‖ ctx ‖ msg`, ctx ≤ 255
69
+ enforced (line 534-537); covered by 18 sigGen vectors with
70
+ variable ctx + 45 sigVer vectors.
71
+ - [x] **z norm bound (γ₁−β) and r₀ (γ₂−β)** — `_polyChknorm` rejects
72
+ → retry loop (kappa+=L); 1000-iteration budget; tested
73
+ indirectly via byte-exact sigGen.
74
+ - [x] **h ≤ ω bound check** — `cnt > OMEGA` rejects in sign (line 666),
75
+ `hCount > OMEGA` rejects in verify (line 725).
76
+ - [x] **Tampering rejection** — 14+ negative ACVP sigVer vectors
77
+ (`reason ∈ {modified message, modified signature - z, commitment,
78
+ hint, response, public key bit-flip}`).
79
+ - [x] **No `throw`** — early return + `console.warn/error` (review
80
+ lines 480-557, 670-680).
81
+ - [x] **HashML-DSA (preHash variant)** ✅ **Iteration E3** — implemented.
82
+ `signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` / `verifyPh` apply
83
+ PH(msg) with the injected hash + the FIPS 204 §5.4 algo 4 wrapper
84
+ (`0x01 || |ctx| || ctx || OID(hashAlg) || PH(msg)`). 12 hashAlg
85
+ values supported (SHA2-{224,256,384,512}, SHA2-512/{224,256}, SHA3-*,
86
+ SHAKE-{128,256}). **9 SigGen + 45 SigVer ACVP vectors byte-exact**
87
+ (3/group sub-sample across 3 paramSets for SigGen, full coverage
88
+ for SigVer).
89
+ - [x] **"internal" interface** ✅ **Iteration E3** — exposed via
90
+ `_internal.signInternal(M, sk, rnd?)` and `_internal.verifyInternal`.
91
+ Bypasses the §5.4 wrapper; M is passed as-is to mu = SHAKE256(tr||M, 64).
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`.
95
+ Skips the mu derivation; the caller supplies the pre-computed mu
96
+ (typically `SHAKE256(tr || M, 64)`). **9 ACVP vectors byte-exact**.
97
+ - [ ] **Side-channel NTT/sampling** — not formally constant-time
98
+ (Int32, branches on public values only).
99
+ Acceptable for software PQC DSA; **P3** for embedded
100
+ deployment → dedicated audit.
101
+
102
+ ## FIPS 140-3 conformance
103
+
104
+ | Requirement | Status | Evidence |
105
+ |---|---|---|
106
+ | Approved algorithm | ✅ | FIPS 204 §5-6 + 3 official ACVP folders |
107
+ | Approved paramSets | ✅ | ML-DSA-{44,65,87} (FIPS 204 Table 1) |
108
+ | Deterministic generation (seed) | ✅ | byte-exact on 9 ACVP keyGen vectors |
109
+ | Deterministic signature (rnd=0) | ✅ | byte-exact on 9 sigGen det=true vectors |
110
+ | Hedged signature (rnd≠0) | ✅ | byte-exact on 9 sigGen det=false vectors |
111
+ | ML-DSA verification | ✅ | 45 sigVer vectors (documented positives + negatives) |
112
+ | Public validation (pk/sig length) | ✅ | early return false; verified by negative sigVer |
113
+ | Power-on KAT / self-test | N/A | permanent KATs via 18 sigGen vectors + Wycheproof |
114
+ | CT comparisons (c̃) | ✅ | accumulated XOR line 733-736 |
115
+ | No `throw` / timing leak | ✅ | Review: `console.warn/error` + `return false` |
116
+ | Entropy source (hedged rnd) | inherited | `random.bytes` (CTR_DRBG SP 800-90A) |
117
+
118
+ ## Known limitations
119
+
120
+ - **[first/mid/last] sub-sampling**: 9/75 keyGen, 18/270 sigGen vs.
121
+ exhaustive coverage. Rationale: signing ML-DSA-87 takes 50-100 ms ×
122
+ 270 vectors = ~25 s per group, exceeding the module's 30 s budget.
123
+ Sub-sampling preserves tcId diversity across the 6 external+pure
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
126
+ external+pure + 90/90 sigGen external+pure → 364 tests in ~4 s; the
127
+ preHash / internal / externalMu variants remain E3 sub-sampled
128
+ (already fully covered per variant).
129
+ - ~~**Out of scope**~~ ✅ **Iteration E3** — HashML-DSA + internal
130
+ interface + externalMu are now all implemented and validated ACVP
131
+ byte-exact. See the `[x]` checks above.
132
+ - **NTT not formally CT**: Int32, branches depending only on
133
+ public values (kappa, indices); the signing path uses
134
+ timing-observable rejections (attempt loop 1..1000). Acceptable
135
+ outside direct network traffic.
136
+
137
+ ## Cross-references
138
+
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)
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
+ - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-ml-dsa.adoc`
143
+ - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/ML-DSA-*-FIPS204/`
144
+ - Sibling ML-KEM module: [`./ml_kem.acvp.md`](./ml_kem.acvp.md)
145
+ - Sibling SLH-DSA module: [`./slh_dsa.acvp.md`](./slh_dsa.acvp.md) (upcoming)
146
+ - Global conformance: [`../NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)