@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,111 @@
1
+ ---
2
+ module: wasmPbkdf2
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmPbkdf2
11
+
12
+ > WASM PBKDF2-HMAC-SHA-{256|384|512} (RFC 8018 §5.2): async key derivation over `Uint8Array`, no-throw.
13
+
14
+ **Module** `wasmPbkdf2` | **Source** `packages/front/fw/src/crypto/wasm/pbkdf2.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ PBKDF2 is available in WebCrypto (`crypto.subtle.deriveBits`); this WASM tier is the **Tier-2 fallback** for non-secure-context environments (locked-down workers, `http://` pages) where `crypto.subtle` is absent. At large iteration counts (≥ 600 000) the C23 WASM inner loop also out-performs a pure-JS HMAC chain. For password hashing in new code, prefer [`wasmArgon2`](./argon2.md) (memory-hard, quantum-resistant). For general PBKDF2 in secure contexts, prefer [`webcrypto/pbkdf2`](../webcrypto/pbkdf2.md).
17
+
18
+ The `pbkdf2` target is **scalar-only** (`simd:false` in `targets.json` — PBKDF2's sequential HMAC compression loop has no SIMD parallelism). There is no `pbkdf2.simd.wasm`; `wasmPbkdf2` forces `{ variant: 'scalar' }` to avoid the runtime fetching a non-existent file.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
24
+ // Returns: { isAvailable, deriveBits }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
32
+ | `deriveBits` | `(password: Uint8Array, salt: Uint8Array, dkLen: number, iterations?: number, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | `dkLen`-byte derived key, or `false` on any failure |
33
+
34
+ ### Parameter constraints
35
+
36
+ | Parameter | Default | Constraint |
37
+ |-----------|---------|-----------|
38
+ | `password` | — | `Uint8Array`; any byte length including `0` (empty password is valid per RFC 8018) |
39
+ | `salt` | — | `Uint8Array`; any byte length (≥ 16 bytes recommended by SP 800-132) |
40
+ | `dkLen` | — | Integer ≥ 1 (bytes) |
41
+ | `iterations` | `600000` | Integer ≥ 1 (OWASP 2023 default for PBKDF2-HMAC-SHA-256) |
42
+ | `hash` | `256` | One of `256` / `384` / `512` (selects HMAC-SHA-2 PRF) |
43
+
44
+ `deriveBits` resolves `false` (never rejects) when:
45
+
46
+ - a parameter is invalid: `password` or `salt` not a `Uint8Array`; `iterations < 1` or non-integer; `dkLen < 1` or non-integer; `hash ∉ {256, 384, 512}` — logged as `[crypto] INVALID: …`;
47
+ - the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch — logged as `[crypto] FAIL: …` by `wasmRuntime.load`;
48
+ - the WASM call returns a non-zero status (`WC_EBADPARAM = -1`).
49
+
50
+ ## Examples
51
+
52
+ ### Basic key derivation (PBKDF2-HMAC-SHA-256)
53
+
54
+ ```js
55
+ const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
56
+
57
+ const password = new TextEncoder().encode('my-passphrase');
58
+ const salt = crypto.getRandomValues(new Uint8Array(16));
59
+ const dk = await wasmPbkdf2.deriveBits(password, salt, 32);
60
+ // dk is a 32-byte Uint8Array, or false on failure.
61
+ if (dk === false) {
62
+ // WASM unavailable — fall back to webcrypto/pbkdf2 or hash/pbkdf2.
63
+ }
64
+ ```
65
+
66
+ ### Explicit iteration count and PRF
67
+
68
+ ```js
69
+ // 100 000 iterations, HMAC-SHA-512, 64-byte output.
70
+ const dk = await wasmPbkdf2.deriveBits(password, salt, 64, 100_000, 512);
71
+ ```
72
+
73
+ ### RFC 7914 §11 published vector (c=1, SHA-256)
74
+
75
+ ```js
76
+ const pw = new TextEncoder().encode('password');
77
+ const salt = new TextEncoder().encode('salt');
78
+ const dk = await wasmPbkdf2.deriveBits(pw, salt, 32, 1, 256);
79
+ // hex(dk) === '120fb6cffcf8b32c43e7225256c4f837a86548c92ccc35480805987cb70be17b'
80
+ ```
81
+
82
+ ## Worker Usage
83
+
84
+ ```js
85
+ // wasmPbkdf2 is worker-safe: all constants are inside factory() and the
86
+ // binary is fetched by wasmRuntime's package loader via import.meta.url.
87
+ const worker = fw.createWorker(() => {
88
+ const wasmPbkdf2 = runtime.resolve('wasmPbkdf2');
89
+ self.onmessage = async ({ data }) => {
90
+ const { password, salt, dkLen } = data;
91
+ const dk = await wasmPbkdf2.deriveBits(password, salt, dkLen);
92
+ self.postMessage(dk);
93
+ };
94
+ });
95
+ ```
96
+
97
+ ## Notes
98
+
99
+ - **Default 600 000 iterations** (OWASP 2023 recommendation for PBKDF2-HMAC-SHA-256 password storage). SP 800-132 §5.3 sets the minimum at 1 000.
100
+ - **Scalar-only binary.** PBKDF2's inner loop is sequential HMAC passes — no block-level SIMD parallelism is possible. The scalar WASM binary is still faster than pure-JS at high iteration counts due to the compiled C23 HMAC inner loop.
101
+ - **Supports SHA-256, SHA-384, and SHA-512 PRFs.** SHA-1 and SHA-3 variants are out of scope for this binary (`hash ∉ {256, 384, 512}` → `false`).
102
+ - **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` (never a view aliasing reused WASM memory).
103
+ - **No-throw contract.** Every failure path resolves to `false` after a `console.error`; the promise never rejects.
104
+ - **Prefer `wasmArgon2` for new password hashing.** Argon2id (memory-hard) provides better resistance to brute-force and GPU attacks than PBKDF2 at equivalent wall-clock cost.
105
+
106
+ ## See also
107
+
108
+ - [crypto/webcrypto/pbkdf2](../webcrypto/pbkdf2.md) — the primary WebCrypto PBKDF2 path (prefer in secure contexts)
109
+ - [crypto/hash/pbkdf2](../hash/pbkdf2.md) — the pure-JS PBKDF2 reference (universal default, no WASM)
110
+ - [crypto/wasm/argon2](./argon2.md) — memory-hard password hashing (recommended for new code)
111
+ - [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
@@ -0,0 +1,113 @@
1
+ ---
2
+ module: wasmRsa
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmRsa
11
+
12
+ > WASM RSA Tier-2 fallback: OAEP encrypt/decrypt, PSS & PKCS#1-v1.5 sign/verify, keygen. Async, `Uint8Array`, no-throw.
13
+
14
+ **Module** `wasmRsa` | **Source** `packages/front/fw/src/crypto/wasm/rsa.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ RSA over WASM, as an **opt-in Tier-2 fallback** for environments where `crypto.subtle` is unavailable (non-secure context, locked-down workers). In a secure context, prefer [`webcrypto/rsa`](../webcrypto/rsa.md) — the browser runs RSA in hardware-backed native code. This module loads the delivered [`@awacloud/fw-wasm-crypto`](https://www.npmjs.com/package/@awacloud/fw-wasm-crypto) `rsa` binary (vendored BearSSL i31 big-integer core + an EMSA-PSS padding layer) through [`wasmRuntime`](./runtime.md). The `rsa` target ships **scalar only**; the wrapper forces the scalar variant on load.
17
+
18
+ Three schemes are exposed: **RSA-OAEP** (`encrypt`/`decrypt`), **RSA-PSS** and **RSASSA-PKCS#1-v1.5** (`sign`/`verify`). Supported digests are SHA-256/384/512 (default 256); moduli are 2048/3072/4096 bits (default 2048); the public exponent is fixed at 65537. PKCS#1-v1.5 **encryption** is intentionally not exposed (insecure). PEM/DER conversion is out of scope (use the pure-JS asn1/`pem` modules).
19
+
20
+ ## Key encoding
21
+
22
+ Keys cross the ABI as the **BearSSL big-integer wire format** — there is no DER parser in the delivered binary:
23
+
24
+ - **public key**: `u16be nLen | n | u16be eLen | e` (minimal big-endian)
25
+ - **private key**: `u32be nBitLen | u16be pLen | p | u16be qLen | q | u16be dpLen | dp | u16be dqLen | dq | u16be iqLen | iq` (CRT parameters; `iq = q⁻¹ mod p`)
26
+
27
+ `generateKey` returns this form; `encrypt`/`decrypt`/`sign`/`verify` consume it. The surface is self-consistent: a key pair from `generateKey` is directly usable by the other members.
28
+
29
+ ## Resolve
30
+
31
+ ```js
32
+ const wasmRsa = runtime.resolve('wasmRsa');
33
+ // Returns: { isAvailable, generateKey, encrypt, decrypt, sign, verify }
34
+ ```
35
+
36
+ ## API
37
+
38
+ | Method | Signature | Returns |
39
+ |--------|-----------|---------|
40
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
41
+ | `generateKey` | `(scheme: 'OAEP'\|'PSS'\|'PKCS1', modulusBits?: 2048\|3072\|4096, hash?: 256\|384\|512) => Promise<{publicKey: Uint8Array, privateKey: Uint8Array}\|false>` | A key pair (wire format), or `false` |
42
+ | `encrypt` | `(publicKey: Uint8Array, data: Uint8Array, label?: Uint8Array, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | RSA-OAEP ciphertext (`k` bytes), or `false` |
43
+ | `decrypt` | `(privateKey: Uint8Array, ct: Uint8Array, label?: Uint8Array, hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | The recovered plaintext, or `false` |
44
+ | `sign` | `(privateKey: Uint8Array, data: Uint8Array, scheme: 'PSS'\|'PKCS1', hash?: 256\|384\|512) => Promise<Uint8Array\|false>` | The signature (`k` bytes), or `false` |
45
+ | `verify` | `(publicKey: Uint8Array, signature: Uint8Array, data: Uint8Array, scheme: 'PSS'\|'PKCS1', hash?: 256\|384\|512) => Promise<boolean>` | `true` iff the signature is valid |
46
+
47
+ `sign`/`verify` take the **raw message**: the wrapper digests it with `crypto.subtle` (SHA-256/384/512) before the WASM call. `encrypt` and PSS `sign` are **randomized** (OAEP seed / PSS salt drawn from `crypto.getRandomValues`), so repeated calls produce different outputs that all verify/decrypt correctly.
48
+
49
+ Members resolve `false` (never throw) when:
50
+
51
+ - `scheme`, `hash`, or `modulusBits` is outside the supported set (`[crypto] INVALID: …` logged);
52
+ - a key/ciphertext/signature/data argument has the wrong type or an obviously bad length;
53
+ - the binary cannot load — `WebAssembly` unavailable, fetch/compile failure, or ABI mismatch (`[crypto] FAIL: …` logged by `wasmRuntime.load`);
54
+ - the WASM call returns a non-zero status (bad padding, invalid signature, OAEP unpad failure).
55
+
56
+ `verify` additionally resolves `false` whenever the signature does not validate (tampered signature, tampered message, wrong scheme, wrong hash, or wrong key).
57
+
58
+ ## Examples
59
+
60
+ ### Generate a key pair, sign with PSS, verify
61
+
62
+ ```js
63
+ const enc = new TextEncoder();
64
+ const kp = await wasmRsa.generateKey('PSS', 2048, 256);
65
+ if (kp === false) { /* WASM unavailable — fall back to pure-JS rsa */ }
66
+
67
+ const msg = enc.encode('hello rsa');
68
+ const sig = await wasmRsa.sign(kp.privateKey, msg, 'PSS', 256); // randomized salt
69
+ const ok = await wasmRsa.verify(kp.publicKey, sig, msg, 'PSS', 256); // → true
70
+ ```
71
+
72
+ ### RSA-OAEP encrypt / decrypt
73
+
74
+ ```js
75
+ const ct = await wasmRsa.encrypt(kp.publicKey, msg, undefined, 256); // k bytes
76
+ const pt = await wasmRsa.decrypt(kp.privateKey, ct, undefined, 256); // → msg
77
+ ```
78
+
79
+ ### Legacy PKCS#1-v1.5 signatures (interop only)
80
+
81
+ ```js
82
+ // Emits "[crypto] DEPRECATED: … prefer PSS". Use only for interop with
83
+ // systems that mandate RSASSA-PKCS1-v1_5.
84
+ const sig = await wasmRsa.sign(kp.privateKey, msg, 'PKCS1', 256);
85
+ const ok = await wasmRsa.verify(kp.publicKey, sig, msg, 'PKCS1', 256);
86
+ ```
87
+
88
+ ### Tamper detection
89
+
90
+ ```js
91
+ const bad = Uint8Array.from(sig);
92
+ bad[0] ^= 0xff;
93
+ await wasmRsa.verify(kp.publicKey, bad, msg, 'PSS', 256); // → false
94
+ ```
95
+
96
+ ## Notes
97
+
98
+ - **Prefer WebCrypto in secure contexts.** `crypto.subtle` runs RSA in hardware-backed native code; this WASM tier only wins where `crypto.subtle` is absent. Pure-JS [`rsa`](../pkc/rsa.md) remains the universal default.
99
+ - **Keys are BearSSL wire format, not DER.** See *Key encoding* above. The delivered ABI has no DER/PEM parser; conversion is a separate concern.
100
+ - **PKCS#1-v1.5 signatures are legacy.** `sign(... 'PKCS1' ...)` warns DEPRECATED; prefer PSS for new signatures. PKCS#1-v1.5 **encryption** is not exposed at all (insecure).
101
+ - **Randomized by design.** OAEP encryption and PSS signing draw fresh randomness per call from `crypto.getRandomValues`; outputs are non-deterministic but always verify/decrypt. PKCS#1-v1.5 signatures are deterministic.
102
+ - **NIST-anchored.** The test suite verifies a genuine NIST RSA-SigGen-FIPS186-5 PKCS#1-v1.5 signature byte-for-byte against the delivered binary, plus OAEP/PSS/PKCS1 round-trips on a fixed NIST DecryptionPrimitive key.
103
+ - **Scalar only.** The `rsa` target ships `rsa.scalar.wasm` (no SIMD build); the wrapper passes `{ variant: 'scalar' }` to `wasmRuntime.load`.
104
+ - **Output is copied OUT** of WASM linear memory into fresh `Uint8Array`s (never a view that could alias reused memory).
105
+ - **No-throw contract.** Every failure path resolves to `false` after a `console.error`; nothing rejects.
106
+
107
+ ## See also
108
+
109
+ - [crypto/webcrypto/rsa](../webcrypto/rsa.md) — the hardware-backed WebCrypto RSA (preferred in secure contexts)
110
+ - [crypto/pkc/rsa](../pkc/rsa.md) — the pure-JS RSA reference (universal default)
111
+ - [crypto/wasm/ecc](./ecc.md) — WASM elliptic-curve signatures/ECDH, the other classical PKC accelerator
112
+ - [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter
113
+ - [crypto/wasm README](./README.md) — the WASM primitive family overview
@@ -0,0 +1,172 @@
1
+ ---
2
+ module: wasmRuntime
3
+ category: crypto/wasm
4
+ dependencies: []
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmRuntime
11
+
12
+ > Self-contained WASM loader: colocated-asset fetch, SIMD-selecting compile, linear-memory marshalling, the no-throw ABI handshake.
13
+
14
+ **Module** `wasmRuntime` | **Source** `packages/front/fw/src/crypto/wasm/runtime.js` | **Deps** none | **Worker-safe** yes
15
+
16
+ The keystone every `crypto/wasm/*` wrapper loads its binary through. It is a **self-contained loader** over **colocated `.wasm` assets** committed next to the module (`<wasmModule>.{simd,scalar}.wasm`) — fetched by name exactly like [`io/compress/brotli_dict_words.js`](../../io/compress/brotli_dict_words.md) fetches `brotli_dict.bin`. fw has **no runtime dependency** on any other package: `wasmRuntime` owns the lazy async `WebAssembly.compile`, the runtime simd-vs-scalar variant selection, the zero-import invariant, the `memory`/`alloc`/`free` + `expectedExports` ABI assertions, the no-throw async contract, the linear-memory marshalling helpers, module metadata, and the security invariant.
17
+
18
+ WASM here is portable-**SIMD software** speed, **not** hardware crypto acceleration — there is no AES-NI / SHA-NI exposure. That is WebCrypto's domain (see [`../webcrypto/README.md`](../webcrypto/README.md)). The WASM tier accelerates the algorithms WebCrypto does not cover (SHA-3, BLAKE2b, ChaCha20-Poly1305, CMAC, Argon2, ML-KEM/ML-DSA/SLH-DSA) and serves as a Tier-2 fallback when `crypto.subtle` is absent.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const wasmRuntime = runtime.resolve('wasmRuntime');
24
+ // Returns: { isAvailable, hasSimd, load, withBytes, readBytes, run }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present |
32
+ | `hasSimd` | `() => Promise<boolean>` | Whether the host validates a minimal simd128 module (memoized) |
33
+ | `load` | `(wasmModule: string, expectedExports?: string[], opts?: object) => Promise<Handle\|false>` | A handle or `false` — never rejects |
34
+ | `withBytes` | `(loaded: Handle, input: Uint8Array) => { ptr, len, free }` | Copies `input` INTO linear memory; returns ptr/len + a `free()` thunk |
35
+ | `readBytes` | `(loaded: Handle, ptr: number, len: number) => Uint8Array` | Copies `len` bytes OUT of linear memory into a fresh `Uint8Array` |
36
+ | `run` | `(loaded: Handle, fnName: string, args: number[]) => number` | Calls an export, returns its `i32` status; a trap throws to the caller's try/catch |
37
+
38
+ `load` options (`opts`): `variant` (`'simd' | 'scalar'`) forces a variant (default = runtime selection); `fetchBytes(wasmModule, variant) => Promise<Uint8Array>` is a documented **test seam** overriding the colocated fetch. The success handle exposes: `instance`, `memory` (and a `mem` alias), `alloc`, `free`, `exports`, and `variant`.
39
+
40
+ `load` resolves `false` when:
41
+ - `WebAssembly` is unavailable (`[crypto] NOT READY: WebAssembly unavailable` logged)
42
+ - the fetch/compile/instantiate fails, or the zero-import invariant or a `memory`/`alloc`/`free`/`expectedExports` entry is missing (`[crypto] FAIL: wasmRuntime.load: <message>` logged)
43
+
44
+ ## Canonical WASM ABI
45
+
46
+ Every colocated `<wasmModule>.<variant>.wasm` is a freestanding wasm32 reactor with **zero imports** that MUST export the ABI triple:
47
+
48
+ - `memory` — exported `WebAssembly.Memory` (linear memory, bump-allocated).
49
+ - `alloc(size: i32) -> i32` — pointer into `memory`, or `0` on allocation failure.
50
+ - `free(ptr: i32) -> void` — release boundary (the shim's bump allocator may no-op; the export MUST still exist).
51
+
52
+ …plus the per-algorithm functions named in the caller's `expectedExports`. Algorithm functions operate on `(ptr, len)` pairs into `memory` and write results to caller-provided output pointers; they return an `i32` status (`0` = OK, non-zero = failure). `load` asserts the triple + `expectedExports` at load time, so ABI drift fails fast as a `load(...) === false`.
53
+
54
+ ## Colocated assets & provenance
55
+
56
+ The binaries are **committed assets** next to this module:
57
+ `packages/front/fw/src/crypto/wasm/<wasmModule>.scalar.wasm` (always) and
58
+ `<wasmModule>.simd.wasm` (for the SIMD-capable targets: `sha3`, `blake2b`,
59
+ `chacha20poly1305`, `ml_kem`, `ml_dsa`). They are raw `.wasm` (not base64-embedded)
60
+ so the browser/worker cache can share the asset across page loads — the same
61
+ rationale as `brotli_dict.bin`.
62
+
63
+ `load` resolves `new URL('./<wasmModule>.<variant>.wasm', import.meta.url)` and
64
+ `fetch`es it. The **SIMD win** comes from `load` fetching `<wasmModule>.simd.wasm`
65
+ when `hasSimd()` is true; scalar-only targets (no `.simd.wasm` colocated) must be
66
+ loaded with `{ variant: 'scalar' }`. Wrappers always **load by name** — they never
67
+ import a binary directly.
68
+
69
+ ### Variant matrix
70
+
71
+ | Targets | Colocated builds | How to call `load` |
72
+ |---|---|---|
73
+ | `blake2b`, `chacha20poly1305`, `ml_dsa`, `ml_kem`, `sha3` | `.scalar.wasm` + `.simd.wasm` | default — let the runtime select |
74
+ | `aes`, `argon2`, `cmac`, `ecc`, `ed25519`, `hkdf`, `hmac`, `pbkdf2`, `rsa`, `sha2`, `slh_dsa`, `x25519` | `.scalar.wasm` only | **must** pass `{ variant: 'scalar' }` |
75
+
76
+ Variant selection has **no fallback**. With no `variant` option it returns
77
+ `'simd'` whenever the host validates a simd128 module, and the colocated fetch
78
+ for a scalar-only target then fails — `load` resolves `false` per its no-throw
79
+ contract rather than retrying scalar. Passing `{ variant: 'scalar' }` is part of
80
+ a scalar-only wrapper's contract, not an optimisation.
81
+
82
+ ### Asset resolution binds to this module's own URL
83
+
84
+ The colocated fetch is `new URL('./<wasmModule>.<variant>.wasm',
85
+ import.meta.url)` evaluated **inside `factory()`**, so the base is wherever
86
+ `runtime.js` itself was loaded from. A build step that inlines a descriptor by
87
+ stringifying its factory (`factory.toString()`) re-binds `import.meta.url` to
88
+ the *generated* file, and every wasm-tier path in that artifact then fails to
89
+ fetch its binary while a tier-audit surface may still report the tier as
90
+ effective. Ship `wasmRuntime` as a real module file, or supply
91
+ `opts.fetchBytes`, when a bundler re-hosts factory source.
92
+
93
+ **Provenance.** The bytes are build artifacts of the `@awacloud/fw-wasm-crypto` package
94
+ (`dist/<wasmModule>.{simd,scalar}.wasm`, emitted by `tools/wasm-crypto build`),
95
+ copied here as vendored source. To refresh: run `wasm-crypto build`
96
+ against `packages/front/fw-wasm-crypto`, then copy the produced `dist/*.wasm` next
97
+ to this module. The matching ABI (export names per target) is recorded in that
98
+ package's `targets.json`.
99
+
100
+ ## Security invariant
101
+
102
+ `load` selects a binary by its **module name** — one of the colocated,
103
+ build-vendored binaries. There is **no** public API that accepts caller-supplied
104
+ bytes to compile or instantiate; such an overload would be an `eval`-class
105
+ injection vector. (`opts.fetchBytes` is a documented test seam, not a public
106
+ method.) A module instantiates only the bytes vendored at build time.
107
+
108
+ ## Examples
109
+
110
+ ### Load a module and round-trip bytes
111
+
112
+ ```js
113
+ // expectedExports declares the algo functions this caller binds to.
114
+ const h = await wasmRuntime.load('sha3', ['sha3_256']);
115
+ if (h === false) {
116
+ // WebAssembly unavailable, fetch/compile failure, or ABI mismatch.
117
+ return false;
118
+ }
119
+
120
+ const buf = wasmRuntime.withBytes(h, message); // copy IN
121
+ try {
122
+ const outPtr = h.alloc(32);
123
+ const status = wasmRuntime.run(h, 'sha3_256', [buf.ptr, buf.len, outPtr]);
124
+ if (status !== 0) {
125
+ return false;
126
+ }
127
+ const digest = wasmRuntime.readBytes(h, outPtr, 32); // copy OUT (fresh array)
128
+ h.free(outPtr);
129
+ return digest;
130
+ } finally {
131
+ buf.free(); // always release the input buffer
132
+ }
133
+ ```
134
+
135
+ ### Feature detection
136
+
137
+ ```js
138
+ if (!wasmRuntime.isAvailable()) {
139
+ // Fall back to the pure-JS or WebCrypto tier.
140
+ }
141
+ const fast = await wasmRuntime.hasSimd(); // true ⇒ load() picks the SIMD variant
142
+ ```
143
+
144
+ ### Worker usage
145
+
146
+ ```js
147
+ const worker = fw.createWorker(
148
+ function ({ libs }) {
149
+ // The colocated .wasm is fetched by name (resolved from import.meta.url)
150
+ // inside the worker — no main-thread closure is serialized.
151
+ libs.wasmRuntime.load('blake2b', ['blake2b']).then((h) => {
152
+ self.postMessage(h !== false);
153
+ });
154
+ },
155
+ { dependencies: ['wasmRuntime'] }
156
+ );
157
+ ```
158
+
159
+ ## Notes
160
+
161
+ - **No-throw contract**: `load` and `hasSimd` are `async` and resolve to a value or `false`; they never reject. `run` deliberately lets an export trap propagate so the calling wrapper's `try/catch` is the single no-throw boundary.
162
+ - **`readBytes` never aliases**: it copies out of linear memory into a fresh `Uint8Array`. WASM memory may be reused or grow (detaching the buffer) on the next call, so returning a view would be unsound.
163
+ - **`withBytes` ownership**: the caller MUST invoke the returned `free()` (typically in a `finally`). `withBytes` throws `TypeError` on a non-`Uint8Array` input.
164
+ - **Async compile only**: `load` uses `WebAssembly.compile` / `instantiate`; the synchronous `new WebAssembly.Module()` constructor (banned for bodies > 4 KB on the main thread) is never used.
165
+ - **Worker-safe**: pure factory; `WebAssembly` exists in Web Workers; binary bytes are fetched by name (resolved from `import.meta.url`), so `factory.toString()` carries no captured binding.
166
+ - **Software, not hardware**: portable SIMD speeds the software implementations; it exposes no CPU crypto instructions. For HW-backed AES/SHA/ECDSA prefer the WebCrypto tier when `crypto.subtle` is available.
167
+
168
+ ## See also
169
+
170
+ - [crypto/wasm README](./README.md) — the WASM primitive family overview
171
+ - [crypto/webcrypto README](../webcrypto/README.md) — the HW-backed `crypto.subtle` tier
172
+ - [crypto README](../README.md) — all three crypto tiers (pure-JS, WebCrypto, WASM)
@@ -0,0 +1,95 @@
1
+ ---
2
+ module: wasmSha2
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmSha2
11
+
12
+ > WASM SHA-256/384/512 (FIPS 180-4) — Tier-2 fallback for non-secure contexts.
13
+
14
+ **Module** `wasmSha2` | **Source** `packages/front/fw/src/crypto/wasm/sha2.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ WASM-backed SHA-2 one-shot digests: SHA-256, SHA-384, SHA-512. This is the **Tier-2 fallback** for environments where `crypto.subtle` is unavailable (non-secure-context, locked-down workers). In secure contexts, prefer [`../webcrypto/digest.md`](../webcrypto/digest.md) which is hardware-accelerated. The pure-JS [`../hash/sha256.md`](../hash/sha256.md) / `sha384` / `sha512` modules remain the universal default.
17
+
18
+ The binary ships **scalar-only** (`sha2.scalar.wasm`; `simd: false` in targets.json — SHA-2 SIMD gain is marginal). The `{ variant: 'scalar' }` option is passed explicitly to `wasmRuntime.load` because the package's `selectVariant()` defaults to simd and has no automatic fallback.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const wasmSha2 = runtime.resolve('wasmSha2');
24
+ // Returns: { isAvailable, sha256, sha384, sha512 }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present |
32
+ | `sha256` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 32-byte digest (FIPS 180-4 SHA-256) |
33
+ | `sha384` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 48-byte digest (FIPS 180-4 SHA-384) |
34
+ | `sha512` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 64-byte digest (FIPS 180-4 SHA-512) |
35
+
36
+ All digest methods resolve `false` when:
37
+ - `data` is not a `Uint8Array`
38
+ - `WebAssembly` is unavailable
39
+ - The binary fails to load (fetch error, ABI mismatch)
40
+ - The WASM entry returns a non-zero status
41
+
42
+ None of them ever reject.
43
+
44
+ ## Examples
45
+
46
+ ```js
47
+ const wasmSha2 = runtime.resolve('wasmSha2');
48
+
49
+ // Guard: check availability before use
50
+ if (!wasmSha2.isAvailable()) {
51
+ // Fall back to pure-JS sha256 / sha384 / sha512
52
+ }
53
+
54
+ // One-shot SHA-256 digest
55
+ const enc = new TextEncoder();
56
+ const digest = await wasmSha2.sha256(enc.encode('hello'));
57
+ if (digest === false) {
58
+ // WebAssembly unavailable or binary load failure
59
+ } else {
60
+ console.log(digest); // Uint8Array (32 bytes)
61
+ }
62
+
63
+ // SHA-512
64
+ const digest512 = await wasmSha2.sha512(enc.encode('hello'));
65
+ ```
66
+
67
+ ## Worker Usage
68
+
69
+ ```js
70
+ const worker = fw.createWorker(
71
+ function ({ libs }) {
72
+ // wasmRuntime fetches the colocated .wasm by name inside the worker —
73
+ // no main-thread closure is serialized.
74
+ const enc = new TextEncoder();
75
+ libs.wasmSha2.sha256(enc.encode('hello')).then((d) => {
76
+ self.postMessage(d);
77
+ });
78
+ },
79
+ { dependencies: ['wasmSha2'] }
80
+ );
81
+ ```
82
+
83
+ ## Notes
84
+
85
+ - **Prefer WebCrypto in secure contexts**: `webcrypto/digest` is hardware-accelerated for SHA-256/384/512. Use `wasmSha2` only when `crypto.subtle` is unavailable (non-secure-context, locked-down workers, test environments).
86
+ - **Scalar-only**: `sha2.simd.wasm` is not shipped — SHA-2 SIMD gains are marginal. The `{ variant: 'scalar' }` pin is mandatory; a default load would fail on the missing SIMD binary.
87
+ - **No-throw contract**: all methods resolve to `Uint8Array | false`; they never reject. Input validation (`instanceof Uint8Array`) happens before any WASM call.
88
+ - **Output is always a fresh copy**: `readBytes` copies out of WASM linear memory into a new `Uint8Array`. The caller owns the returned buffer.
89
+ - **Implements FIPS 180-4**: SHA-256 (§6.2), SHA-384 (§6.5), SHA-512 (§6.4). SHA-224, SHA-512/224, SHA-512/256 are out of scope — use the pure-JS tier.
90
+
91
+ ## See also
92
+
93
+ - [wasmRuntime](./runtime.md) — shared WASM loader adapter
94
+ - [webcrypto/digest](../webcrypto/digest.md) — HW-backed SHA-2 in secure contexts (prefer this)
95
+ - [hash/sha256](../hash/sha256.md) — pure-JS SHA-256 (universal default)
@@ -0,0 +1,127 @@
1
+ ---
2
+ module: wasmSha3
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmSha3
11
+
12
+ > WASM-SIMD-accelerated SHA-3 / SHAKE (FIPS 202), async, Uint8Array.
13
+
14
+ **Module** `wasmSha3` | **Source** `packages/front/fw/src/crypto/wasm/sha3.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ WASM-backed wrapper over the `@awacloud/fw-wasm-crypto` `sha3` binary. Exposes
17
+ SHA3-224/256/384/512 (fixed-length digests) and SHAKE128/256 (XOF) as
18
+ async, no-throw primitives over `Uint8Array`. The Keccak permutation is
19
+ **not** in WebCrypto; this module is the WASM-tier primary accelerator for it
20
+ (alongside the pure-JS [`../hash/sha3.md`](../hash/sha3.md) universal default).
21
+
22
+ The binary ships as both `sha3.simd.wasm` and `sha3.scalar.wasm`
23
+ (`"simd": true` in targets.json). `wasmRuntime.load` auto-selects the SIMD
24
+ variant when the host engine validates simd128, otherwise the scalar variant
25
+ — no explicit pin needed.
26
+
27
+ ## Resolve
28
+
29
+ ```js
30
+ const wasmSha3 = runtime.resolve('wasmSha3');
31
+ // Returns: { isAvailable, sha3_224, sha3_256, sha3_384, sha3_512, shake128, shake256 }
32
+ ```
33
+
34
+ ## API
35
+
36
+ | Method | Signature | Returns |
37
+ |--------|-----------|---------|
38
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present in this environment |
39
+ | `sha3_224` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 28-byte SHA3-224 digest, or `false` on failure |
40
+ | `sha3_256` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 32-byte SHA3-256 digest, or `false` on failure |
41
+ | `sha3_384` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 48-byte SHA3-384 digest, or `false` on failure |
42
+ | `sha3_512` | `(data: Uint8Array) => Promise<Uint8Array\|false>` | 64-byte SHA3-512 digest, or `false` on failure |
43
+ | `shake128` | `(data: Uint8Array, outLen: number) => Promise<Uint8Array\|false>` | XOF, exactly `outLen` bytes, or `false` on failure |
44
+ | `shake256` | `(data: Uint8Array, outLen: number) => Promise<Uint8Array\|false>` | XOF, exactly `outLen` bytes, or `false` on failure |
45
+
46
+ All operations resolve `false` (never reject) when:
47
+ - `data` is not a `Uint8Array`
48
+ - `outLen ≤ 0` for SHAKE variants
49
+ - the WASM binary fails to load (WebAssembly unavailable, fetch/compile error, or ABI mismatch)
50
+ - the binary returns a non-zero status (invalid `variantId` — an internal guard)
51
+
52
+ ### WASM ABI
53
+
54
+ The binary exports a single entry point used for all six variants:
55
+
56
+ ```
57
+ sha3(variantId: i32, inPtr: i32, inLen: i32, outPtr: i32, outLen: i32) -> i32
58
+ ```
59
+
60
+ `variantId` maps to: `0`=SHA3-224, `1`=SHA3-256, `2`=SHA3-384, `3`=SHA3-512,
61
+ `4`=SHAKE128, `5`=SHAKE256. Return value `0` = OK; `-1` = unknown variantId.
62
+ For fixed-digest SHA3 variants, the shim ignores `outLen` and writes the implied
63
+ digest size. For SHAKE, the caller supplies `outLen` and the shim squeezes exactly
64
+ that many bytes.
65
+
66
+ ## Examples
67
+
68
+ ### One-shot SHA3-256 digest
69
+
70
+ ```js
71
+ const wasmSha3 = runtime.resolve('wasmSha3');
72
+
73
+ const data = new TextEncoder().encode('Hello, world!');
74
+ const digest = await wasmSha3.sha3_256(data);
75
+ if (digest === false) {
76
+ // WebAssembly unavailable or binary load failure — fall back to pure-JS sha3.
77
+ return;
78
+ }
79
+ console.log(digest); // Uint8Array(32)
80
+ ```
81
+
82
+ ### SHAKE128 XOF (variable output length)
83
+
84
+ ```js
85
+ const key = await wasmSha3.shake128(seed, 32); // 32-byte key
86
+ const iv = await wasmSha3.shake128(seed, 16); // 16-byte IV (prefix of the 32-byte output)
87
+ ```
88
+
89
+ ### Feature detection + SIMD reporting
90
+
91
+ ```js
92
+ if (!wasmSha3.isAvailable()) {
93
+ // No WebAssembly — use pure-JS sha3.
94
+ }
95
+ const fast = await runtime.resolve('wasmRuntime').hasSimd();
96
+ // fast === true → sha3.simd.wasm loaded (Keccak SIMD permutation)
97
+ // fast === false → sha3.scalar.wasm loaded (identical correctness, less throughput)
98
+ ```
99
+
100
+ ## Worker Usage
101
+
102
+ ```js
103
+ const worker = fw.createWorker(
104
+ function ({ libs }) {
105
+ const data = new Uint8Array(32);
106
+ libs.wasmSha3.sha3_256(data).then((digest) => {
107
+ self.postMessage(digest !== false ? Array.from(digest) : null);
108
+ });
109
+ },
110
+ { dependencies: ['wasmSha3'] }
111
+ );
112
+ ```
113
+
114
+ ## Notes
115
+
116
+ - **FIPS 202**: all six variants (SHA3-224/256/384/512, SHAKE128/256) implement FIPS 202 exactly — same domain suffix (SHA3: `0x06`, SHAKE: `0x1F`) and pad10*1 as the pure-JS module.
117
+ - **Not in WebCrypto**: `crypto.subtle` does not expose SHA-3 or Keccak; this module is the framework's primary accelerator for the Keccak family. When WebAssembly is unavailable, fall back to [`../hash/sha3.md`](../hash/sha3.md).
118
+ - **SIMD auto-selection**: the loader fetches `sha3.simd.wasm` when `supportsSimd()` is true (no explicit `{ variant }` pin needed); scalar fallback is automatic.
119
+ - **No-throw contract**: all methods are `async` and resolve to a result or `false`; they never reject. Validation errors are logged to `console.error` with the `[crypto]` prefix.
120
+ - **Output is a fresh copy**: `wasmRuntime.readBytes` copies bytes OUT of linear memory into a new `Uint8Array` — the returned buffer never aliases WASM memory.
121
+ - **Parity with pure-JS**: the WASM and pure-JS modules produce identical byte-for-byte output on the same input (verified by the test suite for all six variants).
122
+
123
+ ## See also
124
+
125
+ - [`../hash/sha3.md`](../hash/sha3.md) — pure-JS SHA-3 / SHAKE module (universal default, no async)
126
+ - [`./blake2b.md`](./blake2b.md) — WASM-accelerated BLAKE2b (another non-WebCrypto hash)
127
+ - [`./runtime.md`](./runtime.md) — the shared WASM loader adapter all `crypto/wasm/*` wrappers use