@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,110 @@
1
+ ---
2
+ module: wasmArgon2
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmArgon2
11
+
12
+ > WASM-loaded Argon2id (RFC 9106): the memory-hard password-hashing / KDF accelerator. Async, `Uint8Array`, no-throw.
13
+
14
+ **Module** `wasmArgon2` | **Source** `packages/front/fw/src/crypto/wasm/argon2.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ Argon2id is the **highest-ROI** WASM target. It is **not** in WebCrypto, and pure JS is painfully slow because the algorithm is deliberately **memory-hard** — it fills and re-reads a large block matrix, which is exactly where native WASM speed pays off. This module loads the delivered [`@awacloud/fw-wasm-crypto`](https://www.npmjs.com/package/@awacloud/fw-wasm-crypto) `argon2` binary through [`wasmRuntime`](./runtime.md) and exposes an async surface that reproduces the pure-JS [`argon2`](../hash/argon2.md) module's Argon2id output, faster.
17
+
18
+ Only **Argon2id** (RFC 9106, type=2, v=0x13) is exposed — Argon2d / Argon2i are intentionally absent (the pure-JS module already refuses them: data-dependent addressing alone is cache-timing-vulnerable, and Argon2i alone is sub-optimal). The `argon2` binary is **scalar-only** (`simd:false`): the memory-hard fill dominates, so SIMD buys nothing — `wasmArgon2` therefore loads it with the variant forced to scalar.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const wasmArgon2 = runtime.resolve('wasmArgon2');
24
+ // Returns: { isAvailable, hash, verify }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
32
+ | `hash` | `(password: Uint8Array, salt: Uint8Array, opts: Argon2Options) => Promise<Uint8Array\|false>` | The Argon2id tag (`opts.hashLen` bytes), or `false` |
33
+ | `verify` | `(password: Uint8Array, salt: Uint8Array, expected: Uint8Array, opts: Argon2Options) => Promise<boolean>` | `hash(...)` then **constant-time** compare against `expected` |
34
+
35
+ ### `Argon2Options`
36
+
37
+ | Field | Type | Meaning |
38
+ |-------|------|---------|
39
+ | `timeCost` | `number` | Passes `t` (≥ 1) |
40
+ | `memoryKiB` | `number` | Memory cost `m` in KiB (≥ 8·`parallelism`) |
41
+ | `parallelism` | `number` | Lanes `p` (≥ 1) |
42
+ | `hashLen` | `number` | Output tag length in bytes (`4` .. `2^32-1`) |
43
+ | `secret` | `Uint8Array` *(optional)* | Key `K` |
44
+ | `ad` | `Uint8Array` *(optional)* | Associated data `X` |
45
+
46
+ `hash`/`verify` resolve `false` (never throw) when:
47
+
48
+ - a parameter is invalid (`[crypto] INVALID: …` logged): `timeCost < 1`, `parallelism < 1`, `memoryKiB < 8·parallelism`, `hashLen ∉ [4, 2^32-1]`, or `password`/`salt`/`secret`/`ad` not a `Uint8Array`;
49
+ - the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch (`[crypto] FAIL: …` logged by `wasmRuntime.load`);
50
+ - the WASM call returns a non-zero status (`[crypto] FAIL: wasmArgon2.hash: argon2id_hash status <n>`).
51
+
52
+ `verify` additionally returns `false` when `expected` is not a `Uint8Array`, when its length differs from the produced tag, or when the bytes differ.
53
+
54
+ ## Examples
55
+
56
+ ### Hash a password
57
+
58
+ ```js
59
+ const enc = new TextEncoder();
60
+ const tag = await wasmArgon2.hash(
61
+ enc.encode('correct horse battery staple'),
62
+ crypto.getRandomValues(new Uint8Array(16)),
63
+ { timeCost: 3, memoryKiB: 65536, parallelism: 4, hashLen: 32 },
64
+ );
65
+ if (tag === false) {
66
+ // Invalid params or WASM unavailable — fall back to the pure-JS tier.
67
+ }
68
+ ```
69
+
70
+ ### Verify a stored tag (constant-time)
71
+
72
+ ```js
73
+ const ok = await wasmArgon2.verify(
74
+ enc.encode(attempt),
75
+ storedSalt,
76
+ storedTag,
77
+ { timeCost: 3, memoryKiB: 65536, parallelism: 4, hashLen: 32 },
78
+ );
79
+ ```
80
+
81
+ ### RFC 9106 §5.3 test vector
82
+
83
+ ```js
84
+ // t=3, m=32 KiB, p=4 lanes, 32-byte tag.
85
+ const tag = await wasmArgon2.hash(
86
+ new Uint8Array(32).fill(0x01), // password
87
+ new Uint8Array(16).fill(0x02), // salt
88
+ {
89
+ timeCost: 3, memoryKiB: 32, parallelism: 4, hashLen: 32,
90
+ secret: new Uint8Array(8).fill(0x03),
91
+ ad: new Uint8Array(12).fill(0x04),
92
+ },
93
+ );
94
+ // hex(tag) === '0d640df58d78766c08c037a34a8b53c9d01ef0452d75b65eb52520e96b01e659'
95
+ ```
96
+
97
+ ## Notes
98
+
99
+ - **Memory-hard ⇒ the prime reason to reach for WASM here.** Choose `memoryKiB` as large as your environment allows (RFC 9106 §4 suggests `m = 2^21` KiB / 2 GiB for RAM-rich servers, `m = 2^16` KiB / 64 MiB when constrained; avoid `m < 2^15` / 32 MiB for password storage). The matrix is bounded by the package's WASM arena ceiling — an oversized `m'` surfaces as a non-zero status → `false`.
100
+ - **Not in WebCrypto.** `crypto.subtle` has no Argon2; this WASM tier (or the pure-JS [`argon2`](../hash/argon2.md)) is the only path.
101
+ - **Scalar-only binary.** `wasmArgon2` forces `{ variant: 'scalar' }` when loading because the `argon2` target ships no SIMD build. Other `crypto/wasm/*` modules with a SIMD variant load it automatically via `wasmRuntime`.
102
+ - **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` (never a view that could alias reused memory).
103
+ - **Constant-time `verify`.** The byte comparison scans the full tag without early exit; a length mismatch short-circuits to `false` (length is not secret).
104
+ - **No-throw contract.** Every failure path resolves to `false` after a `console.error`; nothing rejects.
105
+
106
+ ## See also
107
+
108
+ - [crypto/hash/argon2](../hash/argon2.md) — the pure-JS Argon2id reference (same algorithm, universal default)
109
+ - [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
110
+ - [crypto/wasm README](./README.md) — the WASM primitive family overview
@@ -0,0 +1,103 @@
1
+ ---
2
+ module: wasmBlake2b
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmBlake2b
11
+
12
+ > WASM-SIMD BLAKE2b (RFC 7693): fast keyed/unkeyed hash, not in WebCrypto.
13
+
14
+ **Module** `wasmBlake2b` | **Source** `packages/front/fw/src/crypto/wasm/blake2b.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ Opt-in WASM accelerator for the pure-JS [`blake2b`](../hash/blake2b.md) module. Loads `@awacloud/fw-wasm-crypto`'s `blake2b.simd.wasm` or `blake2b.scalar.wasm` (runtime auto-selection) through `wasmRuntime`. Exposes an async, `Uint8Array`, no-throw surface that supports keyed mode (MAC), variable output length, and salt / personalisation per RFC 7693 §2.8.
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const wasmBlake2b = runtime.resolve('wasmBlake2b');
22
+ // Returns: { isAvailable, hash }
23
+ ```
24
+
25
+ ## API
26
+
27
+ | Method | Signature | Returns |
28
+ |--------|-----------|---------|
29
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present |
30
+ | `hash` | `(data: Uint8Array, opts?: WasmBlake2bOpts) => Promise<Uint8Array\|false>` | Digest bytes, or `false` on invalid params or WASM failure — never rejects |
31
+
32
+ ### `WasmBlake2bOpts`
33
+
34
+ | Property | Type | Default | Constraint |
35
+ |----------|------|---------|------------|
36
+ | `outLen` | `number` | `64` | `[1, 64]` |
37
+ | `key` | `Uint8Array` | (empty) | `≤ 64` bytes — keyed/MAC mode |
38
+ | `salt` | `Uint8Array` | (null) | `≤ 16` bytes — zero-padded to 16 in the param block |
39
+ | `personal` | `Uint8Array` | (null) | `≤ 16` bytes — zero-padded to 16 in the param block |
40
+
41
+ Any parameter out of range resolves to `false` without throwing.
42
+
43
+ ## Examples
44
+
45
+ ### Unkeyed hash
46
+
47
+ ```js
48
+ const wasmBlake2b = runtime.resolve('wasmBlake2b');
49
+ const digest = await wasmBlake2b.hash(
50
+ new TextEncoder().encode('hello world'),
51
+ { outLen: 32 } // BLAKE2b-256
52
+ );
53
+ if (digest === false) {
54
+ // WebAssembly unavailable or WASM failure; fall back to pure-JS blake2b.
55
+ }
56
+ ```
57
+
58
+ ### Keyed hash (MAC)
59
+
60
+ ```js
61
+ const key = crypto.getRandomValues(new Uint8Array(32));
62
+ const mac = await wasmBlake2b.hash(message, { key });
63
+ // mac is a 64-byte Uint8Array (BLAKE2b-512 MAC)
64
+ ```
65
+
66
+ ### Variable output + salt / personalisation
67
+
68
+ ```js
69
+ const salt = new Uint8Array(16).fill(0x01);
70
+ const personal = new TextEncoder().encode('my-app-context\x00\x00'); // 16 bytes
71
+ const digest = await wasmBlake2b.hash(data, {
72
+ outLen: 32,
73
+ salt,
74
+ personal,
75
+ });
76
+ ```
77
+
78
+ ## Worker Usage
79
+
80
+ ```js
81
+ const worker = fw.createWorker(
82
+ function ({ libs }) {
83
+ const wasmBlake2b = libs.wasmBlake2b;
84
+ wasmBlake2b.hash(data).then(self.postMessage.bind(self));
85
+ },
86
+ { dependencies: ['wasmBlake2b'] }
87
+ );
88
+ ```
89
+
90
+ ## Notes
91
+
92
+ - **RFC 7693** — BLAKE2b, the 64-bit variant of BLAKE2 (compression over 128-byte blocks, 12 rounds, 64-byte digest maximum). BLAKE2s (32-bit) is a separate algorithm not covered here.
93
+ - **Keyed mode = MAC**: supplying a `key` turns BLAKE2b into a secure message authentication code, replacing HMAC-SHA-512 with a single pass. Key length ∈ [1, 64].
94
+ - **Not in WebCrypto**: `crypto.subtle` does not expose BLAKE2b. This WASM module is the primary accelerator (no hardware fallback path exists).
95
+ - **SIMD variant is auto-selected**: the package loader calls `supportsSimd()` at load time; `blake2b.simd.wasm` is fetched when the host engine validates simd128, `blake2b.scalar.wasm` otherwise.
96
+ - **No-throw contract**: `hash` always resolves to `Uint8Array | false`. Param-validation failures are logged as `[crypto] INVALID: wasmBlake2b: …` and resolve to `false`.
97
+ - **Output is a fresh copy**: `readBytes` copies the bytes out of linear WASM memory; the returned `Uint8Array` is safe to retain across multiple calls.
98
+
99
+ ## See also
100
+
101
+ - [`../hash/blake2b.md`](../hash/blake2b.md) — pure-JS BLAKE2b (universal fallback, streaming API)
102
+ - [`./sha3.md`](./sha3.md) — WASM-SIMD SHA-3 / SHAKE (similarly not in WebCrypto)
103
+ - [`./runtime.md`](./runtime.md) — `wasmRuntime` — the shared loader all `crypto/wasm/*` wrappers use
@@ -0,0 +1,120 @@
1
+ ---
2
+ module: wasmChacha20poly1305
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmChacha20poly1305
11
+
12
+ > WASM-SIMD ChaCha20-Poly1305 AEAD (RFC 8439): seal/open over Uint8Array. Async, no-throw.
13
+
14
+ **Module** `wasmChacha20poly1305` | **Source** `packages/front/fw/src/crypto/wasm/chacha20poly1305.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ ChaCha20-Poly1305 is **not** in WebCrypto, making this module the primary accelerator for the algorithm in the `crypto/wasm/*` family. The delivered [`@awacloud/fw-wasm-crypto`](https://github.com/your-org/awa) `chacha20poly1305` binary ships both `.simd.wasm` and `.scalar.wasm`; the loader auto-selects the SIMD variant when `simd128` is validated by the host engine, otherwise falls back to scalar. This provides near-native portable-SIMD software speed — **not** hardware crypto acceleration (AES-NI / SHA-NI); that is WebCrypto's domain.
17
+
18
+ The AEAD construction follows **RFC 8439 §2.8**: a 256-bit key, a 96-bit IETF nonce, and a 128-bit Poly1305 MAC over padded `AAD ‖ ciphertext` with length fields. The `seal` output layout is `ciphertext ‖ tag` (tag is always 16 bytes). The `open` path verifies the Poly1305 tag in **constant-time** (branch-free accumulator inside the binary) before releasing any plaintext.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const wasmChacha20poly1305 = runtime.resolve('wasmChacha20poly1305');
24
+ // Returns: { isAvailable, seal, open }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
32
+ | `seal` | `(key: Uint8Array, nonce: Uint8Array, plaintext: Uint8Array, aad?: Uint8Array) => Promise<Uint8Array\|false>` | `ciphertext ‖ tag` (16-byte tag), or `false` on failure |
33
+ | `open` | `(key: Uint8Array, nonce: Uint8Array, ctWithTag: Uint8Array, aad?: Uint8Array) => Promise<Uint8Array\|false>` | Plaintext, or `false` on auth failure or invalid params |
34
+
35
+ **Parameter constraints:**
36
+
37
+ | Param | Requirement |
38
+ |-------|-------------|
39
+ | `key` | `Uint8Array`, exactly 32 bytes |
40
+ | `nonce` | `Uint8Array`, exactly 12 bytes (96-bit IETF nonce, RFC 8439) |
41
+ | `plaintext` | `Uint8Array`, any length (including empty) |
42
+ | `ctWithTag` | `Uint8Array`, at least 16 bytes (tag-only AEAD is valid) |
43
+ | `aad` | `Uint8Array`, optional (default empty) |
44
+
45
+ `seal` and `open` resolve `false` (never throw) when:
46
+
47
+ - `key` is not a `Uint8Array` or `key.length !== 32`;
48
+ - `nonce` is not a `Uint8Array` or `nonce.length !== 12`;
49
+ - `ctWithTag.length < 16` (would not hold a full tag);
50
+ - `plaintext` is not a `Uint8Array` (`seal` only);
51
+ - `ctWithTag` is not a `Uint8Array` (`open` only);
52
+ - the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch;
53
+ - `open`: the Poly1305 tag comparison fails (authentication error — no plaintext is returned).
54
+
55
+ ## Examples
56
+
57
+ ### Seal a message
58
+
59
+ ```js
60
+ const key = crypto.getRandomValues(new Uint8Array(32));
61
+ const nonce = crypto.getRandomValues(new Uint8Array(12));
62
+ const pt = new TextEncoder().encode('Hello, world!');
63
+ const aad = new TextEncoder().encode('metadata');
64
+
65
+ const sealed = await wasmChacha20poly1305.seal(key, nonce, pt, aad);
66
+ if (sealed === false) {
67
+ // Invalid params or WASM unavailable — fall back to the pure-JS tier.
68
+ }
69
+ // sealed = Uint8Array: pt.length + 16 bytes (ciphertext ‖ Poly1305 tag)
70
+ ```
71
+
72
+ ### Open a sealed message
73
+
74
+ ```js
75
+ const plaintext = await wasmChacha20poly1305.open(key, nonce, sealed, aad);
76
+ if (plaintext === false) {
77
+ // Authentication failed (tampered ciphertext, tag, or AAD) — discard.
78
+ }
79
+ ```
80
+
81
+ ### RFC 8439 §2.8.2 test vector
82
+
83
+ ```js
84
+ const key = new Uint8Array([
85
+ 0x80,0x81,0x82,0x83,0x84,0x85,0x86,0x87,
86
+ 0x88,0x89,0x8a,0x8b,0x8c,0x8d,0x8e,0x8f,
87
+ 0x90,0x91,0x92,0x93,0x94,0x95,0x96,0x97,
88
+ 0x98,0x99,0x9a,0x9b,0x9c,0x9d,0x9e,0x9f,
89
+ ]);
90
+ const nonce = new Uint8Array([0x07,0x00,0x00,0x00,0x40,0x41,0x42,0x43,0x44,0x45,0x46,0x47]);
91
+ // ... pt = 'Ladies and Gentlemen ...', aad = '50515253c0c1c2c3c4c5c6c7'
92
+ const out = await wasmChacha20poly1305.seal(key, nonce, pt, aad);
93
+ // out subarray(0, pt.length) === d31a8d34... (RFC §2.8.2 ciphertext)
94
+ // out subarray(pt.length) === 1ae10b59... (RFC §2.8.2 Poly1305 tag)
95
+ ```
96
+
97
+ ## Worker Usage
98
+
99
+ ```js
100
+ const worker = fw.createWorker(() => {
101
+ const wasmChacha20poly1305 = runtime.resolve('wasmChacha20poly1305');
102
+ // seal / open available; WASM loads via import.meta.url inside the worker.
103
+ return { seal: wasmChacha20poly1305.seal, open: wasmChacha20poly1305.open };
104
+ });
105
+ ```
106
+
107
+ ## Notes
108
+
109
+ - **Not in WebCrypto.** `crypto.subtle` exposes no ChaCha20-Poly1305; this WASM module (or the pure-JS [`chacha20poly1305`](../mode/chacha20poly1305.md)) is the only path.
110
+ - **96-bit IETF nonce (RFC 8439 §2.8).** The nonce is exactly 12 bytes. XChaCha20-Poly1305 (24-byte nonce) is out of scope; use a different module for extended nonces.
111
+ - **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` on both `seal` and `open` (never a view aliasing reused memory).
112
+ - **Constant-time tag comparison.** `open` uses a branch-free accumulator (`ct_tag_diff |= ...`) inside the binary; no secret-dependent branch or early return. Partial plaintext is never released on tag mismatch.
113
+ - **No-throw contract.** Every failure path resolves to `false`; nothing rejects. Auth failures in `open` are silent (no log entry — leaking a mismatch signal is unnecessary).
114
+ - **SIMD auto-selection.** The `chacha20poly1305` binary ships both `.simd.wasm` and `.scalar.wasm`; no variant pin is needed. ChaCha20 and Poly1305 are prime simd128 beneficiaries.
115
+
116
+ ## See also
117
+
118
+ - [crypto/mode/chacha20poly1305](../mode/chacha20poly1305.md) — the pure-JS ChaCha20-Poly1305 reference (universal default)
119
+ - [crypto/cipher/chacha20](../cipher/chacha20.md) — the raw ChaCha20 keystream primitive
120
+ - [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
@@ -0,0 +1,119 @@
1
+ ---
2
+ module: wasmCmac
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmCmac
11
+
12
+ > WASM-loaded AES-CMAC (SP 800-38B / RFC 4493): MAC compute and verify over AES-128/192/256. Async, `Uint8Array`, no-throw.
13
+
14
+ **Module** `wasmCmac` | **Source** `packages/front/fw/src/crypto/wasm/cmac.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ AES-CMAC is **not** in WebCrypto; this WASM tier (or the pure-JS [`cmac`](../mode/cmac.md) module) is the only path. This wrapper loads the delivered [`@awacloud/fw-wasm-crypto`](https://www.npmjs.com/package/@awacloud/fw-wasm-crypto) `cmac` binary — own SP 800-38B framing (`csrc/cmac/cmac.c`) over the vendored constant-time BearSSL `aes_ct64` block cipher — through [`wasmRuntime`](./runtime.md) and exposes an async surface for MAC computation and constant-time verification.
17
+
18
+ The `cmac` target is **scalar-only** (`simd:false` in `targets.json` — the AES block is bitsliced ct64, not simd128). There is no `cmac.simd.wasm`; `wasmCmac` forces `{ variant: 'scalar' }` when loading.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const wasmCmac = runtime.resolve('wasmCmac');
24
+ // Returns: { isAvailable, mac, verify }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
32
+ | `mac` | `(key: Uint8Array, message: Uint8Array, tagLen?: number) => Promise<Uint8Array\|false>` | The AES-CMAC tag (`tagLen` bytes, default 16), or `false` |
33
+ | `verify` | `(key: Uint8Array, message: Uint8Array, tag: Uint8Array) => Promise<boolean>` | Recompute tag then **constant-time** compare against `tag` |
34
+
35
+ ### Parameter constraints
36
+
37
+ | Parameter | Constraint |
38
+ |-----------|-----------|
39
+ | `key` | `Uint8Array`, length `16` / `24` / `32` (AES-128 / 192 / 256) |
40
+ | `message` | `Uint8Array`, any byte length including `0` |
41
+ | `tagLen` | Integer in `[1, 16]`, default `16` |
42
+ | `tag` (verify) | `Uint8Array`, length `1..16`; verify recomputes `mac(key, message, tag.length)` |
43
+
44
+ `mac`/`verify` resolve `false` (never throw) when:
45
+
46
+ - a parameter is invalid (`[crypto] INVALID: …` logged): `key` not a `Uint8Array`, `key.length ∉ {16,24,32}`, `message` not a `Uint8Array`, `tagLen ∉ [1,16]`;
47
+ - the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch (`[crypto] FAIL: …` logged by `wasmRuntime.load`);
48
+ - the WASM call returns a non-zero status (`[crypto] FAIL: wasmCmac.mac: aes_cmac status <n>`).
49
+
50
+ `verify` additionally returns `false` when `tag` is not a `Uint8Array` or when the constant-time comparison fails.
51
+
52
+ ## Examples
53
+
54
+ ### Compute an AES-128 CMAC tag
55
+
56
+ ```js
57
+ const key = new Uint8Array(16); // fill from crypto.getRandomValues
58
+ const message = new TextEncoder().encode('authenticated payload');
59
+ const tag = await wasmCmac.mac(key, message);
60
+ if (tag === false) {
61
+ // Invalid params or WASM unavailable — fall back to the pure-JS tier.
62
+ }
63
+ // tag is a 16-byte Uint8Array.
64
+ ```
65
+
66
+ ### Truncated tag (SP 800-38B §6.4)
67
+
68
+ ```js
69
+ const tag8 = await wasmCmac.mac(key, message, 8); // 8-byte (64-bit) tag
70
+ ```
71
+
72
+ ### Constant-time verify
73
+
74
+ ```js
75
+ const ok = await wasmCmac.verify(key, message, storedTag);
76
+ // true only if the recomputed tag matches storedTag byte-for-byte.
77
+ ```
78
+
79
+ ### RFC 4493 §4 published example vectors (AES-128)
80
+
81
+ ```js
82
+ const rfcKey = Uint8Array.from('2b7e151628aed2a6abf7158809cf4f3c'.match(/../g).map(x => parseInt(x, 16)));
83
+
84
+ // Example 1: empty message → bb1d6929e95937287fa37d129b756746
85
+ const t1 = await wasmCmac.mac(rfcKey, new Uint8Array(0));
86
+
87
+ // Example 4: 64-byte message → 51f0bebf7e3b9d92fc49741779363cfe
88
+ const t4 = await wasmCmac.mac(rfcKey, msgBytes);
89
+ ```
90
+
91
+ ## Worker Usage
92
+
93
+ ```js
94
+ // wasmCmac is worker-safe: all constants are inside factory() and the
95
+ // binary is fetched by wasmRuntime's package loader via import.meta.url.
96
+ const worker = fw.createWorker(() => {
97
+ const wasmCmac = runtime.resolve('wasmCmac');
98
+ self.onmessage = async ({ data }) => {
99
+ const { key, message } = data;
100
+ const tag = await wasmCmac.mac(key, message);
101
+ self.postMessage(tag);
102
+ };
103
+ });
104
+ ```
105
+
106
+ ## Notes
107
+
108
+ - **Not in WebCrypto.** `crypto.subtle` has no AES-CMAC; this WASM tier (or the pure-JS [`cmac`](../mode/cmac.md)) is the only path.
109
+ - **Scalar-only binary.** The AES block is bitsliced constant-time ct64 (not simd128); `wasmCmac` forces `{ variant: 'scalar' }` because there is no `cmac.simd.wasm`.
110
+ - **AES-128 / 192 / 256.** Key length selects the AES variant; all three are supported by the same binary.
111
+ - **Empty message is valid.** `msgLen=0` is a well-specified SP 800-38B case and is handled correctly by the WASM implementation.
112
+ - **Constant-time verify.** The byte comparison scans the full tag without early exit; a length mismatch returns `false` immediately (length is not secret).
113
+ - **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` (never a view that could alias reused memory).
114
+ - **No-throw contract.** Every failure path resolves to `false` after a `console.error`; nothing rejects.
115
+
116
+ ## See also
117
+
118
+ - [crypto/mode/cmac](../mode/cmac.md) — the pure-JS AES-CMAC reference (same algorithm, universal default)
119
+ - [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
@@ -0,0 +1,114 @@
1
+ ---
2
+ module: wasmEcc
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmEcc
11
+
12
+ > WASM ECDSA + ECDH on NIST P-256/384/521 — Tier-2 fallback for the WebCrypto-covered prime curves.
13
+
14
+ **Module** `wasmEcc` | **Source** `packages/front/fw/src/crypto/wasm/ecc.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ WASM-backed elliptic-curve cryptography over the NIST prime curves **P-256, P-384, P-521**: keygen, ECDSA sign/verify, and ECDH shared-secret derivation. The binary frames [fiat-crypto](https://github.com/mit-plv/fiat-crypto) machine-verified field arithmetic with BearSSL's EC layer; signing is **deterministic** (RFC 6979).
17
+
18
+ This is the **Tier-2 fallback** for environments where `crypto.subtle` is unavailable (non-secure-context, locked-down workers). In secure contexts prefer [`../webcrypto/ecc.md`](../webcrypto/ecc.md), which is hardware-accelerated. The pure-JS [`../pkc/ecc.md`](../pkc/ecc.md) remains the universal default.
19
+
20
+ The binary ships **scalar-only** (`ecc.scalar.wasm`; `simd: false` in targets.json). The `{ variant: 'scalar' }` option is passed explicitly to `wasmRuntime.load` because the package's `selectVariant()` defaults to simd and has no automatic fallback.
21
+
22
+ ## Resolve
23
+
24
+ ```js
25
+ const wasmEcc = runtime.resolve('wasmEcc');
26
+ // Returns: { isAvailable, generateKey, sign, verify, deriveBits }
27
+ ```
28
+
29
+ ## API
30
+
31
+ | Method | Signature | Returns |
32
+ |--------|-----------|---------|
33
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present |
34
+ | `generateKey` | `(curve?: Curve) => Promise<{publicKey: Uint8Array, privateKey: Uint8Array}\|false>` | Fresh random key pair |
35
+ | `sign` | `(privateKey: Uint8Array, data: Uint8Array, curve?: Curve, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | Deterministic ECDSA, raw `r\|\|s` |
36
+ | `verify` | `(publicKey: Uint8Array, signature: Uint8Array, data: Uint8Array, curve?: Curve, hash?: 256\|384\|512) => Promise<boolean>` | `true` / `false` (no-throw) |
37
+ | `deriveBits` | `(privateKey: Uint8Array, publicKey: Uint8Array, curve?: Curve) => Promise<Uint8Array\|false>` | ECDH shared X-coordinate `Z` |
38
+
39
+ `Curve = 'P-256' | 'P-384' | 'P-521'` (default `'P-256'`). ECDSA `hash` defaults to `256`.
40
+
41
+ ### Encodings
42
+
43
+ | Item | Encoding | Length (`flen` = 32 / 48 / 66) |
44
+ |---|---|---|
45
+ | `privateKey` | raw big-endian scalar `d` | `flen` bytes |
46
+ | `publicKey` | SEC1 **uncompressed** point `0x04 \|\| X \|\| Y` | `1 + 2·flen` bytes |
47
+ | `signature` | raw `r \|\| s` (**not DER**) | `2·flen` bytes |
48
+ | `deriveBits` output | raw shared X-coordinate `Z = X(d·Q)` (**no KDF**) | `flen` bytes |
49
+
50
+ All methods resolve `false` (or `verify` → `false`) when:
51
+ - the `curve` or `hash` is unsupported
52
+ - a key / signature has the wrong byte length, or `data` is not a `Uint8Array`
53
+ - `WebAssembly` is unavailable, or the binary fails to load (fetch error, ABI mismatch)
54
+ - the WASM entry returns a non-zero status (`verify` also returns `false` on a non-matching signature)
55
+
56
+ None of them ever reject.
57
+
58
+ ## Examples
59
+
60
+ ```js
61
+ const wasmEcc = runtime.resolve('wasmEcc');
62
+
63
+ if (!wasmEcc.isAvailable()) {
64
+ // Fall back to webcrypto/ecc (secure contexts) or pure-JS pkc/ecc.
65
+ }
66
+
67
+ // Generate a P-256 key pair, sign, verify.
68
+ const { publicKey, privateKey } = await wasmEcc.generateKey('P-256');
69
+ const enc = new TextEncoder();
70
+ const msg = enc.encode('hello');
71
+
72
+ const sig = await wasmEcc.sign(privateKey, msg, 'P-256', 256); // raw r||s
73
+ const ok = await wasmEcc.verify(publicKey, sig, msg, 'P-256', 256);
74
+ // ok === true
75
+
76
+ // ECDH shared secret (raw Z; run through an HKDF before use as a key).
77
+ const A = await wasmEcc.generateKey('P-384');
78
+ const B = await wasmEcc.generateKey('P-384');
79
+ const zAB = await wasmEcc.deriveBits(A.privateKey, B.publicKey, 'P-384');
80
+ const zBA = await wasmEcc.deriveBits(B.privateKey, A.publicKey, 'P-384');
81
+ // zAB and zBA are byte-identical
82
+ ```
83
+
84
+ ## Worker Usage
85
+
86
+ ```js
87
+ const worker = fw.createWorker(
88
+ function ({ libs }) {
89
+ // wasmRuntime fetches the colocated .wasm by name inside the worker —
90
+ // no main-thread closure is serialized.
91
+ libs.wasmEcc.generateKey('P-256').then((kp) => {
92
+ self.postMessage(kp !== false);
93
+ });
94
+ },
95
+ { dependencies: ['wasmEcc'] }
96
+ );
97
+ ```
98
+
99
+ ## Notes
100
+
101
+ - **Prefer WebCrypto in secure contexts**: `webcrypto/ecc` is hardware-accelerated for the P-curves. Use `wasmEcc` only when `crypto.subtle` is unavailable.
102
+ - **Raw `r||s`, not DER**: signatures are the concatenation of the two `flen`-byte field elements, mirroring the pure-JS `pkc/ecc` and `webcrypto/ecc` raw form. Convert to/from DER at the protocol boundary if needed.
103
+ - **Deterministic signing**: ECDSA uses RFC 6979 deterministic `k`, so a `(privateKey, data, curve, hash)` tuple always yields the same `r||s` — this eliminates the catastrophic nonce-reuse failure class and reproduces the FIPS 186-5 DetECDSA / RFC 6979 vectors byte-for-byte.
104
+ - **`deriveBits` returns a raw secret**: the shared X-coordinate `Z` is **not** a key — run it through an HKDF (`crypto/kdf/hkdf` or `webcrypto/hkdf`) before using it as keying material.
105
+ - **Scalar-only**: `ecc.simd.wasm` is not shipped. The `{ variant: 'scalar' }` pin is mandatory; a default load would fail on the missing SIMD binary.
106
+ - **No-throw contract**: all methods resolve to a value or `false`; they never reject. Input validation (curve / hash / lengths, `instanceof Uint8Array`) happens before any WASM call.
107
+ - **Output is always a fresh copy**: `readBytes` copies out of WASM linear memory into a new `Uint8Array`. The caller owns the returned buffer.
108
+ - **Curve scope**: P-256/384/521 only. Curve25519 (Ed25519 / X25519) and secp256k1 are out of scope — see the pure-JS tier for the latter.
109
+
110
+ ## See also
111
+
112
+ - [wasmRuntime](./runtime.md) — shared WASM loader adapter
113
+ - [webcrypto/ecc](../webcrypto/ecc.md) — HW-backed P-curve ECDSA/ECDH in secure contexts (prefer this)
114
+ - [pkc/ecc](../pkc/ecc.md) — pure-JS elliptic-curve crypto (universal default)