@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,118 @@
1
+ ---
2
+ module: rsaKeygen
3
+ category: crypto/utils
4
+ dependencies: [bitArray, bn, random]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # rsaKeygen
11
+
12
+ > RSA key generation (FIPS 186-5 §A.1.3) — probable primes, Miller-Rabin, CRT.
13
+
14
+ **Module** `rsaKeygen` | **Source** `packages/front/fw/src/crypto/utils/rsaKeygen.js` | **Deps** `bitArray`, `bn`, `random` | **Worker-safe** yes
15
+
16
+ Generates FIPS 186-5 §A.1.3-compliant RSA pairs (probable primes variant): sieve < 2000, Miller-Rabin (rounds per Table B.1), top-2 bits forced, constraint `|p−q| > 2^(nlen/2−100)`, requirement `d > 2^(nlen/2)`, full CRT output (`dp`, `dq`, `qInv`).
17
+
18
+ All outputs are big-endian `Uint8Array`, compatible with the [`rsa`](../pkc/rsa.md) module.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const rsaKeygen = runtime.resolve('rsaKeygen');
24
+ // Returns: { generate, generateProbablePrime, _internal }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `generate(options?)` | `({bits?, e?, drbg?}) => {publicKey, privateKey} \| false` | RSA pair or `false` on error |
32
+ | `generateProbablePrime(nbits, eBn, drbg)` | `(number, BN, DrbgInstance) => BN \| false` | Probable `nbits`-bit prime, coprime with `e` |
33
+ | `_internal.{...}` | — | `millerRabin`, `smallPrimes`, `divmod`, `lcm`, `inverseModAny` (test/KAT only) |
34
+
35
+ ### `generate` options
36
+
37
+ | Option | Type | Default | Description |
38
+ |--------|------|---------|-------------|
39
+ | `bits` | `2048 \| 3072 \| 4096` | `2048` | RSA modulus length in bits |
40
+ | `e` | `number` (odd ≥ 3) | `65537` | Public exponent |
41
+ | `drbg` | `DrbgInstance` | `random.drbg()` | SP 800-90A DRBG instance; useful for deterministic tests |
42
+
43
+ ### `publicKey` / `privateKey` shape
44
+
45
+ ```js
46
+ publicKey = { n: Uint8Array, e: Uint8Array }
47
+ privateKey = { n: Uint8Array, e: Uint8Array, d: Uint8Array,
48
+ p: Uint8Array, q: Uint8Array,
49
+ dp: Uint8Array, dq: Uint8Array, qInv: Uint8Array }
50
+ ```
51
+
52
+ All fields are big-endian `Uint8Array`. `n` and `d` have length `bits/8`; `p`, `q`, `dp`, `dq`, `qInv` have length `bits/16`.
53
+
54
+ ## Examples
55
+
56
+ ### Key generation and OAEP encryption
57
+
58
+ ```js
59
+ const { rsaKeygen, rsa } = fw.runtime.resolveAll(['rsaKeygen', 'rsa']);
60
+
61
+ const { publicKey, privateKey } = rsaKeygen.generate({ bits: 2048 });
62
+ // publicKey : { n, e }
63
+ // privateKey : { n, e, d, p, q, dp, dq, qInv }
64
+
65
+ const ct = rsa.oaepEncrypt(publicKey, new TextEncoder().encode('Hello'));
66
+ const pt = rsa.oaepDecrypt(privateKey, ct);
67
+ ```
68
+
69
+ ### RSA-4096 generation with custom exponent
70
+
71
+ ```js
72
+ const rsaKeygen = fw.runtime.resolve('rsaKeygen');
73
+
74
+ const pair = rsaKeygen.generate({ bits: 4096, e: 65537 });
75
+ if (!pair) throw new Error('keygen failed');
76
+ ```
77
+
78
+ ### Native RSA key structure
79
+
80
+ ```js
81
+ const rsaKeygen = fw.runtime.resolve('rsaKeygen');
82
+
83
+ const { publicKey, privateKey } = rsaKeygen.generate({ bits: 2048 });
84
+ // publicKey : { n, e } — big-endian Uint8Array
85
+ // privateKey : { n, e, d, p, q, dp, dq, qInv } — big-endian Uint8Array (full CRT)
86
+ ```
87
+
88
+ > **Note**: PKCS#8 / SPKI RSA serialisation is not exposed by `keyformat` (which only covers EC, Ed25519, X25519). Build ASN.1 directly via `asn1` + `pem` if external interop is required.
89
+
90
+ ## Worker Usage
91
+
92
+ ```js
93
+ // RSA keygen is slow in pure JS (2048 bits ≈ 1-5s) — execute in a Worker
94
+ const worker = fw.createWorker(
95
+ function ({ libs, args }) {
96
+ const pair = libs.rsaKeygen.generate({ bits: args[0] });
97
+ self.postMessage(pair);
98
+ },
99
+ { dependencies: ['rsaKeygen'], args: [2048] }
100
+ );
101
+ const pair = await worker.run();
102
+ ```
103
+
104
+ ## Notes
105
+
106
+ - **Minimum key size**: only 2048, 3072, and 4096-bit sizes are accepted (FIPS 186-5 rejection); any other value returns `false` with `console.warn`. Never use fewer than 2048 bits in production.
107
+ - **Public exponent**: `e = 65537` (Fermat F4) is the recommended value. A small exponent (e.g. 3) exposes to cube-root attacks when padding is imperfect; the module accepts odd `e ≥ 3` but logs a warning for `e < 65537`.
108
+ - **Entropy**: the default DRBG (`random.drbg()`) is a CTR_DRBG-AES-256 (SP 800-90A §10.2) seeded by `crypto.getRandomValues`; worker-safe because `crypto` is available in Worker contexts.
109
+ - **`provable` / `auxiliary-prime` methods** not implemented — probable primes only (FIPS 186-5 §A.1.3). Some "provable" ACVP vectors are not covered.
110
+ - **CPU cost**: RSA-2048 ≈ 1-5s, RSA-3072 ≈ 5-20s, RSA-4096 ≈ 30-120s in pure JS (variance from prime search). Always run in a Worker to avoid blocking the main thread.
111
+ - **Small `d`**: if `d ≤ 2^(nlen/2)` (Wiener) is detected, generation restarts automatically (per FIPS 186-5 §A.1.1).
112
+
113
+ ## See also
114
+
115
+ - [rsa](../pkc/rsa.md) — consumer (OAEP encrypt/decrypt, PSS sign/verify)
116
+ - [bn](./bn.md) — underlying big-integer arithmetic
117
+ - [random](./random.md) — DRBG source (CTR_DRBG-AES-256, SP 800-90A)
118
+ - [asn1](./asn1.md), [pem](./pem.md) — primitives for serialising an RSA key to PKCS#8/SPKI if required
@@ -0,0 +1,159 @@
1
+ ---
2
+ module: totp
3
+ category: crypto/utils
4
+ dependencies: [hmac, random, base32]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # totp
11
+
12
+ > TOTP RFC 6238 — time-based OTP generation, verification, and enrollment.
13
+
14
+ **Module** `totp` | **Source** `packages/front/fw/src/crypto/utils/totp.js` | **Deps** `hmac`, `random`, `base32` | **Worker-safe** yes
15
+
16
+ Strict TOTP (RFC 6238) implementation built on HOTP (RFC 4226). Algorithm: HMAC-SHA-1/256/512 of the time counter T (8 bytes big-endian), dynamic truncation, modulo 10^digits. Includes enrollment helpers (random secret generation, `otpauth://` URI) compatible with standard authenticators (Google Authenticator, Authy, etc.).
17
+
18
+ **Recommendation**: prefer `algorithm: 'SHA-256'` for new deployments. `'SHA-1'` is kept as the default for RFC 6238 compatibility and interoperability with existing authenticators.
19
+
20
+ ## Resolve
21
+
22
+ ```js
23
+ const totp = runtime.resolve('totp');
24
+ // Returns: { generate, verify, enroll, uri }
25
+ ```
26
+
27
+ ## API
28
+
29
+ | Method | Signature | Returns |
30
+ |--------|-----------|---------|
31
+ | `generate` | `(secret: Uint8Array\|string, opts?) => string` | Zero-padded OTP code |
32
+ | `verify` | `(code: string, secret: Uint8Array\|string, opts?) => {valid, delta?}` | Verification result |
33
+ | `enroll` | `(opts) => {secret, secretBytes, uri}` | Secret + otpauth:// URI |
34
+ | `uri` | `(opts) => string` | otpauth://totp/... URI |
35
+
36
+ ### `totp.generate(secret, opts?)`
37
+
38
+ Generates the current TOTP code for the given secret.
39
+
40
+ | Option | Type | Default | Description |
41
+ |--------|------|---------|-------------|
42
+ | `algorithm` | `'SHA-1'\|'SHA-256'\|'SHA-512'` | `'SHA-1'` | HMAC algorithm |
43
+ | `digits` | `6\|7\|8` | `6` | Number of digits |
44
+ | `period` | `number` | `30` | Period in seconds |
45
+ | `t` | `number` | `Date.now()/1000` | Epoch in seconds (override) |
46
+
47
+ Returns a zero-padded `string` of length `digits` (e.g. `'012345'`).
48
+
49
+ ### `totp.verify(code, secret, opts?)`
50
+
51
+ Verifies a code with a tolerance window. The comparison is **constant-time** (XOR-accumulated, no short-circuit) for the full duration of the window.
52
+
53
+ | Option | Type | Default | Description |
54
+ |--------|------|---------|-------------|
55
+ | `algorithm` | `'SHA-1'\|'SHA-256'\|'SHA-512'` | `'SHA-1'` | HMAC algorithm |
56
+ | `digits` | `6\|7\|8` | `6` | Number of digits |
57
+ | `period` | `number` | `30` | Period in seconds |
58
+ | `t` | `number` | `Date.now()/1000` | Epoch in seconds (override) |
59
+ | `window` | `number` | `1` | Tolerance ±N steps |
60
+
61
+ Returns `{ valid: true, delta: number }` on success, `{ valid: false }` on failure.
62
+
63
+ ### `totp.enroll(opts)`
64
+
65
+ Generates a random secret and enrollment URI. Uses `random.bytes(secretLen)` for CSPRNG generation.
66
+
67
+ | Option | Type | Default | Description |
68
+ |--------|------|---------|-------------|
69
+ | `issuer` | `string` | `''` | Application name |
70
+ | `account` | `string` | `''` | User identifier |
71
+ | `algorithm` | `'SHA-1'\|'SHA-256'\|'SHA-512'` | `'SHA-1'` | Algorithm |
72
+ | `digits` | `6\|7\|8` | `6` | Number of digits |
73
+ | `period` | `number` | `30` | Period |
74
+ | `secretLen` | `number` | `20` | Secret length in bytes (≥16 recommended) |
75
+
76
+ Returns `{ secret: string, secretBytes: Uint8Array, uri: string }` where `secret` is base32-encoded without padding.
77
+
78
+ ### `totp.uri(opts)`
79
+
80
+ Builds a strictly-encoded `otpauth://totp/<issuer>:<account>?...` URI. `issuer` and `account` are passed through `encodeURIComponent`.
81
+
82
+ ## Examples
83
+
84
+ ### Basic enrollment and verification
85
+
86
+ ```js
87
+ const totp = runtime.resolve('totp');
88
+
89
+ // Enrollment (new installation)
90
+ const { secret, uri } = totp.enroll({
91
+ issuer: 'MyApp',
92
+ account: 'user@example.com',
93
+ algorithm: 'SHA-256', // recommended for new installations
94
+ });
95
+
96
+ // Display the URI as a QR code (app side)
97
+ console.log(uri);
98
+ // otpauth://totp/MyApp:user%40example.com?secret=...&issuer=MyApp&algorithm=SHA-256&digits=6&period=30
99
+
100
+ // Verification (server side)
101
+ const code = '123456'; // code entered by the user
102
+ const result = totp.verify(code, secret, { algorithm: 'SHA-256' });
103
+ if (result.valid) {
104
+ console.log('MFA OK, delta=', result.delta);
105
+ }
106
+ ```
107
+
108
+ ### Direct generation (dev / tests)
109
+
110
+ ```js
111
+ const totp = runtime.resolve('totp');
112
+
113
+ // Secret as bytes or base32
114
+ const secretBytes = new Uint8Array(20); // ... shared key
115
+ const code = totp.generate(secretBytes, { algorithm: 'SHA-1', digits: 6 });
116
+ // → '012345' (zero-padded, varies with time)
117
+ ```
118
+
119
+ ### Manual URI
120
+
121
+ ```js
122
+ const totp = runtime.resolve('totp');
123
+ const u = totp.uri({
124
+ issuer: 'Foo Inc', // → Foo%20Inc in the URI
125
+ account: 'bob@foo.com',
126
+ secret: 'JBSWY3DPEHPK3PXP',
127
+ algorithm: 'SHA-1',
128
+ digits: 6,
129
+ period: 30,
130
+ });
131
+ // otpauth://totp/Foo%20Inc:bob%40foo.com?secret=JBSWY3DPEHPK3PXP&issuer=Foo%20Inc&...
132
+ ```
133
+
134
+ ## Worker Usage
135
+
136
+ ```js
137
+ const worker = fw.createWorker(
138
+ function ({ libs, args }) {
139
+ const code = libs.totp.generate(args.secret, { algorithm: 'SHA-256' });
140
+ self.postMessage(code);
141
+ },
142
+ { dependencies: ['totp'], args: { secret: secretBytes } }
143
+ );
144
+ ```
145
+
146
+ ## Notes
147
+
148
+ - `'SHA-1'` is the default for RFC 6238 compatibility, but `'SHA-256'` is recommended for all new installations (better HMAC security, growing authenticator support).
149
+ - `secretLen` default 20 bytes = 160 bits, optimal for HMAC-SHA-1. Use 32 bytes for HMAC-SHA-256, 64 bytes for HMAC-SHA-512.
150
+ - `verify` always iterates the full window without short-circuiting to resist timing attacks.
151
+ - The secret returned by `enroll` is base32-encoded without `=` padding (compatible with Google Authenticator, Authy, FreeOTP, etc.).
152
+ - `random.bytes` uses `crypto.getRandomValues` directly — no Math.random.
153
+
154
+ ## See also
155
+
156
+ - [hmac](../hash/hmac.md) — HMAC-SHA-1/256/512 (direct dependency)
157
+ - [base32](../../io/codec/base32.md) — RFC 4648 encoding of the secret
158
+ - [random](./random.md) — CSPRNG for secret generation
159
+ - [jws](./jws.md) — JSON Web Signature (another auth protocol)
@@ -0,0 +1,98 @@
1
+ ---
2
+ module: uuid
3
+ category: crypto/utils
4
+ dependencies: [hex]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # uuid
11
+
12
+ > UUID v1 (time-based) + v4 (random) — RFC 4122 / RFC 9562, compact or canonical formats.
13
+
14
+ **Module** `uuid` | **Source** `packages/front/fw/src/crypto/utils/uuid.js` | **Deps** `hex` | **Worker-safe** yes
15
+
16
+ Default randomness source: `crypto.getRandomValues` (Web Crypto `RandomSource`, SP 800-90B-grade). `'compact'` format (32 hex without dashes) is the default for back-compat; use `'rfc4122'` for the canonical dashed format.
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const uuid = runtime.resolve('uuid');
22
+ // Returns: { v1, v4 }
23
+ ```
24
+
25
+ ## API
26
+
27
+ | Method | Signature | Returns |
28
+ |--------|-----------|---------|
29
+ | `v1` | `(raw?: boolean, prng?: false \| Function, format?: 'compact'\|'rfc4122') => Uint8Array \| string` | UUID v1 time-based |
30
+ | `v4` | `(raw?: boolean, prng?: false \| Function, format?: 'compact'\|'rfc4122') => Uint8Array \| string` | UUID v4 random |
31
+
32
+ ### Common parameters
33
+
34
+ | Parameter | Type | Default | Description |
35
+ |-----------|------|---------|-------------|
36
+ | `raw` | `boolean` | `false` | `true` → returns raw `Uint8Array(16)` (version + variant patched) |
37
+ | `prng` | `false \| (buf: Uint8Array) => Uint8Array\|void` | `false` | Entropy override — **test/replay only**; production must use `false` |
38
+ | `format` | `'compact'\|'rfc4122'` | `'compact'` | String output format (ignored if `raw=true`) |
39
+
40
+ ### Output formats
41
+
42
+ | Value | Output | Example |
43
+ |-------|--------|---------|
44
+ | `'compact'` (default) | 32 hex without dashes | `91c274f29a0d4ce69d5db2c3d4e5f607` |
45
+ | `'rfc4122'` | 36-char canonical RFC 4122 §3 | `91c274f2-9a0d-4ce6-9d5d-b2c3d4e5f607` |
46
+
47
+ ## Examples
48
+
49
+ ### v4 random (production)
50
+
51
+ ```js
52
+ const uuid = runtime.resolve('uuid');
53
+
54
+ uuid.v4(); // "91c274f29a0d4ce69d5db2c3d4e5f607"
55
+ uuid.v4(false, false, 'rfc4122'); // "91c274f2-9a0d-4ce6-9d5d-b2c3d4e5f607"
56
+ uuid.v4(true); // Uint8Array(16)
57
+ ```
58
+
59
+ ### v1 time-based
60
+
61
+ ```js
62
+ uuid.v1(); // compact hex
63
+ uuid.v1(false, false, 'rfc4122'); // canonical with dashes
64
+ ```
65
+
66
+ ### Validation with valid
67
+
68
+ ```js
69
+ const valid = runtime.resolve('valid');
70
+ const id = uuid.v4(false, false, 'rfc4122');
71
+ valid.test(id, { type: 'string', format: 'uuid' }); // true
72
+ ```
73
+
74
+ ## Worker Usage
75
+
76
+ ```js
77
+ const worker = fw.createWorker(
78
+ function ({ libs }) {
79
+ self.postMessage(libs.uuid.v4(false, false, 'rfc4122'));
80
+ },
81
+ { dependencies: ['uuid'] }
82
+ );
83
+ ```
84
+
85
+ ## Notes
86
+
87
+ - **Randomness source**: `crypto.getRandomValues` (Web Crypto `RandomSource`). Custom `prng` with automatic fallback to `crypto.getRandomValues` if the callback does not modify the buffer.
88
+ - **v1 uses a random MAC** (multicast bit forced per RFC 4122 §4.5) — no hardware MAC accessible in the browser.
89
+ - **Back-compat**: default `format='compact'` returns 32 hex without dashes, identical to the historical API of this framework.
90
+ - **v3 / v5 / v6 / v7 / v8 not implemented** — RFC 9562 §5.6-5.8; v7 (timestamp-sortable) would be useful for DB IDs.
91
+ - Requires `globalThis.crypto.getRandomValues` — available in browsers, Node ≥ 19, Bun, Deno. Throws if absent.
92
+
93
+ ## See also
94
+
95
+ - [hex](../../io/codec/hex.md) — direct dependency, encodes UUID bytes to string
96
+ - [valid](../../io/utils/valid.md) — `format: 'uuid'` for validating an RFC 4122 UUID
97
+ - [random](./random.md) — underlying CSPRNG (CTR_DRBG-AES-256)
98
+ - [Conformance uuid.acvp.md](../../../../src/crypto/utils/uuid.acvp.md)
@@ -0,0 +1,76 @@
1
+ # Crypto / WASM
2
+
3
+ WASM-SIMD-backed primitive modules — fast portable **software** crypto, loaded by
4
+ name through [`wasmRuntime`](./runtime.md) from `.wasm` assets **colocated** in
5
+ `crypto/wasm/` (vendored from the `@awacloud/fw-wasm-crypto` build). fw has **no runtime
6
+ dependency** on the package. They are an **opt-in, async** accelerator tier;
7
+ pure-JS stays the universal default and WebCrypto remains the hardware path.
8
+
9
+ WASM is **not** hardware crypto acceleration (no AES-NI / SHA-NI exposure) — it
10
+ provides near-native + SIMD software speed. Two roles:
11
+
12
+ - **Group A — sole/primary accelerator** (no WebCrypto equivalent): Argon2id,
13
+ ML-KEM/ML-DSA/SLH-DSA (post-quantum), SHA-3, BLAKE2b, ChaCha20-Poly1305, CMAC.
14
+ - **Group B — Tier-2 fallback** for the WebCrypto-covered algorithms (only wins
15
+ when `crypto.subtle` is unavailable — non-secure-context, locked-down workers):
16
+ SHA-2, HMAC, PBKDF2, HKDF, AES, RSA, ECC, Ed25519, X25519.
17
+
18
+ **Contract:** every operation is `async` and resolves to `Promise<Result | false>`
19
+ over `Uint8Array` (not the pure-JS `bitArray`). No exception is ever thrown: on an
20
+ unavailable `WebAssembly`, an invalid argument, or a failed compile/run, the module
21
+ logs (`console.error`) and resolves `false`. Each module exposes
22
+ `isAvailable(): boolean`. All factories are pure and **worker-safe**.
23
+
24
+ Tier-selection / fallback chaining is intentionally **not** here — that
25
+ orchestration belongs to consumers (`sd-common`, runtimes). `fw` ships primitives.
26
+
27
+ | Module | Returns | Deps | Description |
28
+ |--------|---------|------|-------------|
29
+ | [runtime](./runtime.md) | `object` | none | Shared loader/marshalling adapter over `@awacloud/fw-wasm-crypto` (lazy compile, SIMD select, ABI handshake, no-throw, load-by-name security invariant) |
30
+ | [argon2](./argon2.md) | `object` | `wasmRuntime` | Argon2id memory-hard KDF (RFC 9106) — highest-ROI WASM-only accelerator |
31
+ | [ml_kem](./ml_kem.md) | `object` | `wasmRuntime` | ML-KEM keygen/encaps/decaps (FIPS 203), ML-KEM-512/768/1024 |
32
+ | [ml_dsa](./ml_dsa.md) | `object` | `wasmRuntime` | ML-DSA keygen/sign/verify (FIPS 204), ML-DSA-44/65/87 |
33
+ | [slh_dsa](./slh_dsa.md) | `object` | `wasmRuntime` | SLH-DSA keygen/sign/verify (FIPS 205), hash-based signatures |
34
+ | [sha3](./sha3.md) | `object` | `wasmRuntime` | SHA-3 / SHAKE (FIPS 202) |
35
+ | [blake2b](./blake2b.md) | `object` | `wasmRuntime` | BLAKE2b keyed/unkeyed, variable output (RFC 7693) |
36
+ | [chacha20poly1305](./chacha20poly1305.md) | `object` | `wasmRuntime` | ChaCha20-Poly1305 AEAD seal/open (RFC 8439) |
37
+ | [cmac](./cmac.md) | `object` | `wasmRuntime` | AES-CMAC (SP 800-38B / RFC 4493) |
38
+ | [sha2](./sha2.md) | `object` | `wasmRuntime` | SHA-2 family digests (FIPS 180-4) — Tier-2 fallback |
39
+ | [hmac](./hmac.md) | `object` | `wasmRuntime` | HMAC over SHA-2 (FIPS 198-1 / RFC 2104) — Tier-2 fallback |
40
+ | [pbkdf2](./pbkdf2.md) | `object` | `wasmRuntime` | PBKDF2 (SP 800-132 / RFC 8018) — Tier-2 fallback |
41
+ | [hkdf](./hkdf.md) | `object` | `wasmRuntime` | HKDF extract/expand (RFC 5869) — Tier-2 fallback |
42
+ | [aes](./aes.md) | `object` | `wasmRuntime` | AES-GCM/CBC/CTR (SP 800-38A / FIPS 197) software speed — Tier-2 fallback |
43
+ | [rsa](./rsa.md) | `object` | `wasmRuntime` | RSA-OAEP / RSA-PSS / RSASSA-PKCS1-v1_5 (PKCS#1) — Tier-2 fallback |
44
+ | [ecc](./ecc.md) | `object` | `wasmRuntime` | ECDSA + ECDH on P-256/384/521 (FIPS 186-5 / RFC 6979) — Tier-2 fallback |
45
+ | [ed25519](./ed25519.md) | `object` | `wasmRuntime` | Ed25519 keygen/sign/verify (RFC 8032) — Tier-2 fallback |
46
+ | [x25519](./x25519.md) | `object` | `wasmRuntime` | X25519 keygen/deriveBits key agreement (RFC 7748) — Tier-2 fallback |
47
+
48
+ ## Common pattern
49
+
50
+ ```js
51
+ const wasmArgon2 = fw.runtime.resolve('wasmArgon2');
52
+ if (wasmArgon2.isAvailable()) {
53
+ const hash = await wasmArgon2.hash(password, salt,
54
+ { timeCost: 3, memoryKiB: 65536, parallelism: 4, hashLen: 32 });
55
+ // hash is a Uint8Array, or false on failure
56
+ }
57
+ ```
58
+
59
+ ## Notes
60
+
61
+ - **Variants**: modules with a SIMD build (`sha3`, `blake2b`, `chacha20poly1305`,
62
+ `ml_kem`, `ml_dsa`) auto-select simd-vs-scalar via the loader; the scalar-only
63
+ modules are loaded with the scalar variant pinned. Both are byte-for-byte
64
+ equivalent — SIMD only changes speed.
65
+ - **Binaries**: the `.wasm` are **committed assets colocated** in `crypto/wasm/`
66
+ (`<m>.scalar.wasm` always, `<m>.simd.wasm` for the SIMD-capable targets),
67
+ vendored from the `@awacloud/fw-wasm-crypto` build (`tools/wasm-crypto build` →
68
+ `dist/`) and fetched by name like `io/compress/brotli_dict.bin`. fw has **no
69
+ runtime dependency** on the package — zero npm runtime deps unchanged.
70
+
71
+ ## See also
72
+
73
+ - [WebCrypto](../webcrypto/README.md) — opt-in async wrappers over `crypto.subtle`
74
+ (the hardware path); [Hash](../hash/README.md), [Mode](../mode/README.md),
75
+ [PKC](../pkc/README.md) — the pure-JS defaults.
76
+ - [`NIST_CONFORMANCE.md`](../../../../src/crypto/NIST_CONFORMANCE.md)
@@ -0,0 +1,128 @@
1
+ ---
2
+ module: wasmAes
3
+ category: crypto/wasm
4
+ dependencies: [wasmRuntime]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # wasmAes
11
+
12
+ > WASM-loaded AES-GCM / AES-CBC / AES-CTR (SP 800-38D / SP 800-38A) for AES-128/192/256. Async, `Uint8Array`, no-throw. Constant-time **software** fallback — WebCrypto AES-NI is faster.
13
+
14
+ **Module** `wasmAes` | **Source** `packages/front/fw/src/crypto/wasm/aes.js` | **Deps** `wasmRuntime` | **Worker-safe** yes
15
+
16
+ A WASM-backed AES surface — GCM (AEAD), CBC (PKCS#7), and CTR for 128/192/256-bit keys — that loads the delivered [`@awacloud/fw-wasm-crypto`](https://www.npmjs.com/package/@awacloud/fw-wasm-crypto) `aes` binary through [`wasmRuntime`](./runtime.md). The binary is BearSSL's 64-bit bitsliced `aes_ct64` block cipher with the carryless `ghash_ctmul64` GHASH — **constant-time software**.
17
+
18
+ > **WASM has no AES-NI.** This path does **not** use CPU AES instructions; it is portable constant-time software, slower than hardware-backed AES. In a secure context prefer [`webcrypto/aes`](../webcrypto/aes.md), which uses `crypto.subtle` (HW AES-NI / PCLMULQDQ). `wasmAes` exists as a **Tier-2 fallback** for non-secure contexts and locked-down workers where `crypto.subtle` is absent. The pure-JS [`cipher/aes`](../cipher/aes.md) + `mode/*` modules remain the universal default.
19
+
20
+ The `aes` target is **scalar-only** (`simd:false` in `targets.json` — the AES block and GHASH stay bitsliced/carryless, not simd128). There is no `aes.simd.wasm`; `wasmAes` forces `{ variant: 'scalar' }` when loading.
21
+
22
+ ## Resolve
23
+
24
+ ```js
25
+ const wasmAes = runtime.resolve('wasmAes');
26
+ // Returns: { isAvailable, encryptGcm, decryptGcm, encryptCbc, decryptCbc, encryptCtr, decryptCtr }
27
+ ```
28
+
29
+ ## API
30
+
31
+ | Method | Signature | Returns |
32
+ |--------|-----------|---------|
33
+ | `isAvailable` | `() => boolean` | `true` when `WebAssembly` is present (mirrors `wasmRuntime`) |
34
+ | `encryptGcm` | `(key, iv, plaintext, aad?) => Promise<Uint8Array\|false>` | `ciphertext ‖ tag(16)`; `iv` is **12 bytes** |
35
+ | `decryptGcm` | `(key, iv, ctWithTag, aad?) => Promise<Uint8Array\|false>` | Plaintext, or `false` on authentication failure |
36
+ | `encryptCbc` | `(key, iv, plaintext) => Promise<Uint8Array\|false>` | CBC ciphertext with **PKCS#7** padding; `iv` is 16 bytes |
37
+ | `decryptCbc` | `(key, iv, ciphertext) => Promise<Uint8Array\|false>` | Plaintext with PKCS#7 stripped; invalid padding → `false` |
38
+ | `encryptCtr` | `(key, nonce, data) => Promise<Uint8Array\|false>` | CTR keystream XOR; `nonce` is **12 bytes** |
39
+ | `decryptCtr` | `(key, nonce, data) => Promise<Uint8Array\|false>` | CTR is its own inverse; `nonce` is 12 bytes |
40
+
41
+ ### Parameter constraints
42
+
43
+ | Parameter | Constraint |
44
+ |-----------|-----------|
45
+ | `key` | `Uint8Array`, length `16` / `24` / `32` (AES-128 / 192 / 256) |
46
+ | `iv` (GCM) | `Uint8Array`, exactly `12` bytes (96-bit, SP 800-38D §8.2.1) |
47
+ | `iv` (CBC) | `Uint8Array`, exactly `16` bytes |
48
+ | `nonce` (CTR) | `Uint8Array`, exactly `12` bytes (see the counter note below) |
49
+ | `plaintext` / `data` | `Uint8Array`, any length (including `0`) |
50
+ | `aad` (GCM) | optional `Uint8Array` (default empty) |
51
+ | `ctWithTag` (GCM) | `Uint8Array`, `≥ 16` bytes (`ciphertext ‖ tag(16)`) |
52
+ | `ciphertext` (CBC) | `Uint8Array`, non-empty, whole 16-byte blocks |
53
+
54
+ All methods resolve `false` (never throw) when a parameter is invalid (`[crypto] INVALID: …` logged), the binary cannot load (`WebAssembly` unavailable, fetch/compile failure, or ABI mismatch — `[crypto] FAIL: …` logged by `wasmRuntime.load`), or the WASM call returns a non-zero status. `decryptGcm` resolves `false` on **authentication failure** without logging or releasing partial plaintext. `decryptCbc` resolves `false` on invalid PKCS#7 padding.
55
+
56
+ ### GCM tag layout
57
+
58
+ `encryptGcm` appends the full 16-byte tag after the ciphertext (`ciphertext ‖ tag`). `decryptGcm` expects the same layout. This matches WebCrypto AES-GCM with `tagLength: 128`.
59
+
60
+ ### CTR counter / nonce note
61
+
62
+ The frozen `aes_ctr` ABI consumes a **12-byte nonce**: the 16-byte counter block is `nonce(12) ‖ be32(0)` with the 32-bit block counter starting at `0` (J0-style). This matches the package KAT, which cross-checks against WebCrypto AES-CTR configured with `counter = nonce ‖ be32(0)`, `length: 32`. (The task plan's indicative ABI named a 16-byte full-width counter; the delivered binary — `targets.json` + `shims/aes.c` — is authoritative.)
63
+
64
+ ## Examples
65
+
66
+ ### AES-GCM seal / open
67
+
68
+ ```js
69
+ const key = crypto.getRandomValues(new Uint8Array(32)); // AES-256
70
+ const iv = crypto.getRandomValues(new Uint8Array(12)); // 96-bit, unique per message
71
+ const aad = new TextEncoder().encode('header');
72
+
73
+ const sealed = await wasmAes.encryptGcm(key, iv, plaintext, aad); // ct ‖ tag(16)
74
+ if (sealed === false) { /* fall back to webcrypto/aes or pure-JS */ }
75
+
76
+ const opened = await wasmAes.decryptGcm(key, iv, sealed, aad);
77
+ // opened === false on any tampering (ciphertext, tag, or AAD).
78
+ ```
79
+
80
+ ### AES-CBC with PKCS#7
81
+
82
+ ```js
83
+ const iv = crypto.getRandomValues(new Uint8Array(16));
84
+ const ct = await wasmAes.encryptCbc(key, iv, plaintext); // PKCS#7 added
85
+ const pt = await wasmAes.decryptCbc(key, iv, ct); // PKCS#7 stripped
86
+ // CBC is malleable — compose with a MAC (encrypt-then-MAC) or prefer GCM.
87
+ ```
88
+
89
+ ### AES-CTR
90
+
91
+ ```js
92
+ const nonce = crypto.getRandomValues(new Uint8Array(12));
93
+ const ct = await wasmAes.encryptCtr(key, nonce, plaintext);
94
+ const pt = await wasmAes.decryptCtr(key, nonce, ct); // CTR is its own inverse
95
+ ```
96
+
97
+ ## Worker Usage
98
+
99
+ ```js
100
+ // wasmAes is worker-safe: all constants live inside factory() and the binary
101
+ // is fetched by wasmRuntime's package loader via import.meta.url.
102
+ const worker = fw.createWorker(() => {
103
+ const wasmAes = runtime.resolve('wasmAes');
104
+ self.onmessage = async ({ data }) => {
105
+ const { key, iv, plaintext } = data;
106
+ const sealed = await wasmAes.encryptGcm(key, iv, plaintext);
107
+ self.postMessage(sealed);
108
+ };
109
+ });
110
+ ```
111
+
112
+ ## Notes
113
+
114
+ - **No AES-NI.** Constant-time bitsliced software (`aes_ct64` + carryless GHASH); slower than hardware AES. Prefer [`webcrypto/aes`](../webcrypto/aes.md) when `crypto.subtle` is available.
115
+ - **Scalar-only binary.** No `aes.simd.wasm`; `wasmAes` forces `{ variant: 'scalar' }`.
116
+ - **AES-128 / 192 / 256.** Key length selects the variant; one binary covers all three.
117
+ - **GCM auth failure → `false`.** The tag check is inside the binary; a non-zero return maps to `false` with no partial plaintext, no exception.
118
+ - **CBC padding is JS-side.** The ABI does only raw 16-byte blocks; `wasmAes` applies PKCS#7 on encrypt and strips it on decrypt (full-block pad scan, no early-exit oracle on byte position). Invalid padding → `false`.
119
+ - **CTR is its own inverse.** `encryptCtr` and `decryptCtr` call the same primitive.
120
+ - **Output is copied OUT** of WASM linear memory into a fresh `Uint8Array` (never a view aliasing reused memory).
121
+ - **No-throw contract.** Every failure path resolves to `false`; nothing rejects.
122
+
123
+ ## See also
124
+
125
+ - [crypto/webcrypto/aes](../webcrypto/aes.md) — the HW-backed `crypto.subtle` AES tier (faster, preferred in secure contexts)
126
+ - [crypto/cipher/aes](../cipher/aes.md) — the pure-JS AES block cipher (universal default)
127
+ - [crypto/mode/gcm](../mode/gcm.md) — the pure-JS AES-GCM mode
128
+ - [crypto/wasm/runtime](./runtime.md) — the shared WASM loader adapter