@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,158 @@
1
+ # `rsaKeygen.js` — ACVP / NIST conformance
2
+
3
+ ## Standards
4
+
5
+ - **Primary**: **NIST FIPS 186-5** — *Digital Signature Standard
6
+ (DSS)*, **§A.1.3** *Generation of Probable Primes* (probable-prime
7
+ variant); **§A.1.1** structural invariants (n=p·q,
8
+ d=e⁻¹ mod λ(n), |p−q| > 2^(nlen/2−100), d > 2^(nlen/2)).
9
+ - **Secondary**: **FIPS 186-5 Annex B.1** — *Auxiliary Functions*
10
+ (Miller-Rabin), **Table B.1** (rounds required per bit-length class).
11
+ - **Tertiary**: **NIST SP 800-90A** — DRBG used for the randomness of
12
+ candidate primes (CTR_DRBG via [`random.drbg()`](./random.js)).
13
+ - **ACVP draft**: `references/NIST/ACVP/src/draft-celi-acvp-rsa.adoc`
14
+ - **Vectors**: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/RSA-KeyGen-FIPS186-5/`
15
+
16
+ ## Implemented algorithm
17
+
18
+ `generate({ bits, e, drbg? })` produces an RSA key pair conforming to
19
+ FIPS 186-5 §A.1.3 (probable-prime):
20
+
21
+ 1. **Validation**: `nlen ∈ {2048, 3072, 4096}`; `e` odd, `≥ 3`.
22
+ 2. **`p`**: an `nlen/2`-bit candidate via DRBG, top-2 bits forced (ensures
23
+ `p·q ∈ [2^(nlen−1), 2^nlen)`), bit 0 forced (odd); rejected if
24
+ `gcd(p−1, e) ≠ 1`; trial division by primes < 2000; Miller-Rabin
25
+ `k=5` rounds (FIPS 186-5 Table B.1, audit profile k=4 + 1
26
+ defense-in-depth).
27
+ 3. **`q`**: same, plus the Fermat constraint `|p−q| > 2^(nlen/2−100)`
28
+ (retries if not satisfied).
29
+ 4. **`n = p·q`; `λ(n) = lcm(p−1, q−1)`** (Euclidean gcd on `bn`).
30
+ 5. **`d = e⁻¹ mod λ(n)`** via `_inverseModAny` (even-modulus split via
31
+ Hensel 2-adic + CRT — `bn.inverseMod` requires an odd modulus).
32
+ 6. **CRT**: `dp = d mod (p−1)`, `dq = d mod (q−1)`,
33
+ `qInv = q⁻¹ mod p`. Checks `d > 2^(nlen/2)` (§A.1.1), retries otherwise.
34
+
35
+ API: `factory(bitArray, bn, random)` → `{ generate, generateProbablePrime,
36
+ _internal: { millerRabin, smallPrimes, divmod, lcm, inverseModAny } }`.
37
+ Output serialized as big-endian `Uint8Array` for `pkc/rsa.js` integration.
38
+
39
+ ## Test coverage
40
+
41
+ ### Integrated official vectors
42
+
43
+ | Source | Reference | Test (`describe` / `test`) | Property verified |
44
+ |---|---|---|---|
45
+ | FIPS 186-5 §A.1.3 | RSA-2048 structure | `generate — full RSA-2048 key pair` | shape + `n=p·q` + OAEP round-trip |
46
+ | Miller-Rabin small primes | knowns 5..65537 | `_millerRabin / accepts` | true positives |
47
+ | Miller-Rabin small composites | knowns 9..65535 | `_millerRabin / rejects` | true negatives |
48
+ | **RSA-KeyGen-FIPS186-5** | 5 testGroups × 3 = **15/15 vectors** | `RSA-KeyGen-FIPS186-5 ... validator-style` | §A.1.1 invariants byte-exact (CRT) |
49
+
50
+ #### Validator-style strategy (not byte-exact replay)
51
+
52
+ `RSA-KeyGen-FIPS186-5` mixes several generation methods:
53
+
54
+ - `provable` (Shawe-Taylor, FIPS 186-5 §B.6) — deterministic via a
55
+ server seed;
56
+ - `provableWithProvableAux`, `probableWithProvableAux`,
57
+ `probableWithProbableAux` — derivation via auxiliary primes
58
+ (§B.7/§B.8);
59
+ - `probable` (§B.3, equivalent to §A.1.3) — the probable-prime method,
60
+ but as `testType=GDT` (IUT-generated, no controllable seed).
61
+
62
+ `rsaKeygen.js` implements **only the probable-prime method with OS
63
+ entropy** (`random.drbg()`). Byte-exact replay of ACVP `(p, q)` is
64
+ therefore **infeasible** by construction — no seed drives our
65
+ candidates.
66
+
67
+ **Coverage retained**: validate, across each of the 15 NIST keys
68
+ (3 nlen × 5 methods), the §A.1.1 structural invariants that every IUT
69
+ *must* satisfy. The `_internal` primitives (`millerRabin`, `lcm`,
70
+ `inverseModAny`) are precisely what a CMVP validator exercises:
71
+
72
+ ```
73
+ 1. Miller-Rabin(p, k=4) ∧ Miller-Rabin(q, k=4) // §A.1.3
74
+ 2. n = p · q // byte-exact
75
+ 3. inverseModAny(e, p−1) ≠ false ∧ inverseModAny(e, q−1) ≠ false
76
+ 4. d = inverseModAny(e, lcm(p−1, q−1)) ; d.bits > nlen/2
77
+ 5. d mod (p−1) == dmp1 (byte-exact against ACVP vector)
78
+ 6. d mod (q−1) == dmq1 (byte-exact against ACVP vector)
79
+ 7. q⁻¹ mod p == iqmp (byte-exact against ACVP vector)
80
+ 8. |p − q|.bits > nlen/2 − 100 // Fermat resistance
81
+ ```
82
+
83
+ The byte-exact equalities (5)-(7) prove that `_lcm` + `_inverseModAny` +
84
+ `bn.inverseMod` produce **exactly the same value** as the NIST
85
+ reference on 15 independent keys — algorithmic conformance of the
86
+ primitives is therefore validated even without a byte-exact replay of
87
+ the generation itself.
88
+
89
+ ### Security properties tested
90
+
91
+ - [x] **Miller-Rabin acceptance/rejection** — small primes/composites
92
+ + 30 generated primes (15 ACVP × 2) accepted at `k=4`.
93
+ - [x] **`n = p·q` generation** — shape + exact multiplication verified
94
+ on 15 ACVP keys.
95
+ - [x] **Correct `λ(n)` computation** — indirect proof via the
96
+ `d mod (p−1) == dmp1` equality (any error in lcm propagates to dmp1).
97
+ - [x] **`d > 2^(nlen/2)`** — §A.1.1 invariant verified on 15 ACVP
98
+ keys (compute d via inverseModAny then `d.bitLength() > nlen/2`).
99
+ - [x] **Consistent CRT (dp, dq, qInv)** — byte-exact on 15 ACVP keys.
100
+ - [x] **Fermat resistance `|p−q| > 2^(nlen/2−100)`** — verified on 15
101
+ keys + enforced in `generate` (retry if violated).
102
+ - [x] **`_inverseModAny` on an even modulus** — tested via λ(n), which
103
+ is always even; proven by byte-exact dmp1/dmq1.
104
+ - [x] **OAEP-SHA-256 round-trip on a generated key** — RSA-2048 keygen +
105
+ `rsa.oaepEncrypt`/`oaepDecrypt`.
106
+ - [x] **`bits` bounds** — rejects 1024 / 1234.
107
+ - [x] **`e` bounds** — rejects 4 (even) / 2 (< 3).
108
+ - [x] **Top-2 bits forced** — indirect proof via `n.length === 256`
109
+ (RSA-2048) constant across all keygen calls.
110
+ - [ ] **`provable` / `auxiliary-prime` methods** — not implemented
111
+ (P3, outside `rsaKeygen.js`'s current scope: Shawe-Taylor §B.6,
112
+ auxiliary primes §B.7/B.8).
113
+ - [ ] **Strict Table B.1 conformance (round count per bit-length)** —
114
+ our `_mrRounds` returns `k=5` at 1024 bits (auditor=4 + 1 hardening);
115
+ conforms with margin.
116
+
117
+ ## FIPS 140-3 conformance
118
+
119
+ | Requirement | Status | Evidence |
120
+ |---|---|---|
121
+ | Approved algorithm | ✅ | FIPS 186-5 §A.1.3 (probable-prime) |
122
+ | Validated parameter sizes | ✅ | nlen ∈ {2048, 3072, 4096}; e odd ≥ 3 |
123
+ | Validated entropy source | ✅ | DRBG via `random.drbg()` (CTR_DRBG-AES-256, SP 800-90A — cf. [random.acvp.md](./random.acvp.md)) |
124
+ | §A.1.1 invariants verified | ✅ | `n=p·q`, `d=e⁻¹ mod λ(n)`, `\|p−q\| > 2^(nlen/2−100)`, `d > 2^(nlen/2)` — enforced in `generate` AND verified on 15 NIST vectors |
125
+ | Miller-Rabin Table B.1 | ✅ (with margin) | k=5 at 1024 bits (Table B.1 auditor=4) |
126
+ | Power-on KAT / self-test | N/A (probable-prime is non-deterministic; coverage via byte-exact CRT vectors + inherited DRBG POST) | — |
127
+ | No `throw` / timing leak | ✅ | Review: `console.warn`/`console.error` + `return false`; no `throw` |
128
+ | No prime side-channel | ⚠️ (probable) | Miller-Rabin is not constant-time (the sequence of rejected candidates is observable) — acceptable for offline key generation |
129
+
130
+ ## Known limitations
131
+
132
+ - **Alternative FIPS 186-5 methods**: `provable` (Shawe-Taylor §B.6),
133
+ `provableWithProvableAux` (§B.7), `probableWithProbableAux` (§B.8),
134
+ `provableWithProvableAux` not implemented. The module covers only the
135
+ §A.1.3 probable-prime variant, which remains **FIPS-approved** but
136
+ does not allow the `randPQ ∈ {provable, *Aux}` ACVP vectors.
137
+ - **No byte-exact replay**: no seed is controllable on the IUT
138
+ side; byte-exact coverage goes through the CRT invariants (dmp1, dmq1,
139
+ iqmp), not through (p, q) themselves. This is the standard strategy
140
+ for non-deterministic algorithms (cf. ACVP draft §6.5).
141
+ - **Pure-JS performance**: RSA-2048 keygen ≈ several seconds;
142
+ RSA-4096 ≈ 30+ seconds. Documented in `@fileoverview`; recommended
143
+ usage via a Worker.
144
+ - **Miller-Rabin not constant-time**: the number of rejections is
145
+ observable via timing, but not the candidate values — an acceptable
146
+ risk for an offline keygen operation.
147
+ - **No post-quantum path**: ML-KEM/ML-DSA are provided separately
148
+ (cf. [ml_kem.acvp.md](../pkc/ml_kem.acvp.md), [ml_dsa.acvp.md](../pkc/ml_dsa.acvp.md)).
149
+
150
+ ## Cross-references
151
+
152
+ - Module: [`utils/rsaKeygen.js`](./rsaKeygen.js)
153
+ - Tests: [`utils/rsaKeygen.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/utils/rsaKeygen.test.js) — 25 tests (was 10 before this iteration)
154
+ - ACVP draft: `references/NIST/ACVP/src/draft-celi-acvp-rsa.adoc`
155
+ - Vectors: `references/NIST/ACVP-Server-1.1.0.42/gen-val/json-files/RSA-KeyGen-FIPS186-5/`
156
+ - Underlying DRBG: [`./random.acvp.md`](./random.acvp.md)
157
+ - Consuming RSA module: [`../pkc/rsa.js`](../pkc/rsa.js)
158
+ - Global conformance: [`../NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
@@ -0,0 +1,448 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview RSA key-pair generation per FIPS 186-5 §A.1.3
7
+ * (Generation of Probable Primes).
8
+ *
9
+ * Produces an RSA key suitable for the [`rsa`](../pkc/rsa.js) module:
10
+ * `{ publicKey: { n, e }, privateKey: { n, e, d, p, q, dp, dq, qInv } }`,
11
+ * with every field encoded as a big-endian `Uint8Array`.
12
+ *
13
+ * Algorithm summary (FIPS 186-5 Appendix A.1.3 - probable-prime variant):
14
+ *
15
+ * 1. Validate `nlen ∈ {2048, 3072, 4096}` and that `e` is odd, in
16
+ * `[2^16 + 1, 2^256 - 1]` (we accept 3 ≤ e by convention with a warning).
17
+ * 2. Generate `p`:
18
+ * - random `nlen/2`-bit odd candidate with the top two bits set so
19
+ * that `p · q` always lands in `[2^(nlen-1), 2^nlen)`,
20
+ * - reject if `gcd(p − 1, e) ≠ 1` (specialised: `(p − 1) mod e ≠ 0`),
21
+ * - trial-divide by small primes < 2000,
22
+ * - confirm with Miller-Rabin (rounds per FIPS 186-5 Table B.1).
23
+ * 3. Generate `q` under the same constraints, plus
24
+ * `|p − q| > 2^(nlen/2 − 100)` to thwart Fermat factoring.
25
+ * 4. Compute `n = p · q`, `λ(n) = lcm(p − 1, q − 1)`,
26
+ * `d = e⁻¹ mod λ(n)` (require `d > 2^(nlen/2)`),
27
+ * and the CRT parameters `dp`, `dq`, `qInv`.
28
+ *
29
+ * Randomness comes from a SP 800-90A CTR_DRBG instance built via
30
+ * `random.drbg()` (or a caller-supplied DRBG).
31
+ *
32
+ * **Performance note:** RSA-2048 keygen in pure JS is slow (typically several
33
+ * seconds). For interactive use, run inside a Worker.
34
+ *
35
+ */
36
+
37
+ /**
38
+ * RSA key pair returned by `generate`. Every field is a big-endian `Uint8Array`.
39
+ * @typedef {object} RsaKeyPair
40
+ * @property {{ n: Uint8Array, e: Uint8Array }} publicKey Public modulus and exponent.
41
+ * @property {{ n: Uint8Array, e: Uint8Array, d: Uint8Array, p: Uint8Array, q: Uint8Array, dp: Uint8Array, dq: Uint8Array, qInv: Uint8Array }} privateKey Private key with CRT parameters.
42
+ */
43
+
44
+ /**
45
+ * Public shape returned by `rsaKeygen.factory()`.
46
+ * @typedef {object} RsaKeygenAPI
47
+ * @property {(options?: {bits?: number, e?: number, drbg?: object}) => (RsaKeyPair|false)} generate Generate an RSA key pair.
48
+ * @property {(nbits: number, eBn: unknown, drbg: object) => (unknown|false)} generateProbablePrime Generate a probable prime (`bn` instance) coprime with `e`.
49
+ * @property {{ millerRabin: Function, smallPrimes: number[], divmod: Function, lcm: Function, inverseModAny: Function }} _internal Internal primitives exposed for KAT tests only; not API.
50
+ */
51
+
52
+ import { bitArray } from './bitArray.js';
53
+ import { bn } from './bn.js';
54
+ import { random } from './random.js';
55
+
56
+ export const rsaKeygen = {
57
+ name: 'rsaKeygen',
58
+ version: '1.0.0',
59
+ type: 'fw.crypto.utils',
60
+ dependencies: ['bitArray', 'bn', 'random'],
61
+ deps: [bitArray, bn, random],
62
+
63
+ /** @returns {RsaKeygenAPI} */
64
+ factory(bitArray, bn, random) {
65
+
66
+ // ── small-prime sieve (primes < 2000) ───────────────────────────
67
+ const _SMALL_PRIMES = (() => {
68
+ const N = 2000;
69
+ const sieve = new Uint8Array(N).fill(1);
70
+ sieve[0] = sieve[1] = 0;
71
+ for (let i = 2; i * i < N; i++) {
72
+ if (sieve[i]) for (let j = i * i; j < N; j += i) sieve[j] = 0;
73
+ }
74
+ const out = [];
75
+ for (let i = 2; i < N; i++) if (sieve[i]) out.push(i);
76
+ return out;
77
+ })();
78
+
79
+ // ── Miller-Rabin round counts (FIPS 186-5 Table B.1) ────────────
80
+ // Auditor profile (kAuditor) is the conservative count expected by a
81
+ // FIPS validator. Actual cap (k) adds defence-in-depth headroom.
82
+ function _mrRounds(primeBits) {
83
+ if (primeBits >= 1536) return { kAuditor: 4, k: 5 }; // nlen ≥ 3072
84
+ if (primeBits >= 1024) return { kAuditor: 5, k: 7 }; // nlen 2048
85
+ if (primeBits >= 512) return { kAuditor: 7, k: 10 };
86
+ return { kAuditor: 28, k: 40 };
87
+ }
88
+
89
+ // ── byte / bn conversions ───────────────────────────────────────
90
+ function _bnToBytes(num, len) {
91
+ return bitArray.ba_to_ui8(num.toBits(len * 8));
92
+ }
93
+ function _bytesToBn(b) {
94
+ return bn.fromBits(bitArray.ui8_to_ba(b));
95
+ }
96
+ function _bnFromUint8(buf) {
97
+ return bn.fromBits(bitArray.ui8_to_ba(buf));
98
+ }
99
+
100
+ // ── small-int helpers on bn ─────────────────────────────────────
101
+ function _modSmall(num, m) {
102
+ // Returns (num mod m) as a JS number, m fitting in 24 bits.
103
+ // Uses Horner over the bn limbs in big-endian order.
104
+ const radixMod = num.placeVal % m;
105
+ let r = 0;
106
+ for (let i = num.limbs.length - 1; i >= 0; i--) {
107
+ r = (r * radixMod + num.getLimb(i)) % m;
108
+ }
109
+ return r;
110
+ }
111
+
112
+ function _isDivisibleBySmall(candidate) {
113
+ for (let i = 0; i < _SMALL_PRIMES.length; i++) {
114
+ if (_modSmall(candidate, _SMALL_PRIMES[i]) === 0) return true;
115
+ }
116
+ return false;
117
+ }
118
+
119
+ // ── Miller-Rabin (probable-prime test) ──────────────────────────
120
+ // n: bn instance, n odd and > 3.
121
+ function _millerRabin(n, k, drbg) {
122
+ const ONE = new bn.bn(1);
123
+ const TWO = new bn.bn(2);
124
+ const nMinus1 = n.sub(ONE).normalize();
125
+ const nMinus3 = n.sub(new bn.bn(3)).normalize();
126
+
127
+ // n - 1 = 2^s · d, d odd
128
+ let d = nMinus1.copy();
129
+ let s = 0;
130
+ while ((d.getLimb(0) & 1) === 0) {
131
+ d.halveM();
132
+ s++;
133
+ }
134
+ d.normalize();
135
+
136
+ const nlen = n.bitLength();
137
+ const aBytes = ((nlen + 7) >>> 3);
138
+
139
+ outer: for (let r = 0; r < k; r++) {
140
+ // Pick random a in [2, n-2]: random ∈ [0, n-3] then +2.
141
+ let a;
142
+ while (true) {
143
+ const buf = drbg.generate(aBytes);
144
+ if (buf === false) return false;
145
+ a = _bnFromUint8(buf).mod(nMinus3).normalize();
146
+ a.addM(TWO);
147
+ a.normalize();
148
+ if (a.greaterEquals(TWO) && nMinus1.greaterEquals(a)) break;
149
+ }
150
+
151
+ let x = a.powermod(d, n);
152
+ if (x.equals(ONE) || x.equals(nMinus1)) continue;
153
+ for (let i = 0; i < s - 1; i++) {
154
+ x = x.mulmod(x, n);
155
+ if (x.equals(nMinus1)) continue outer;
156
+ if (x.equals(ONE)) return false;
157
+ }
158
+ return false;
159
+ }
160
+ return true;
161
+ }
162
+
163
+ // ── prime-candidate generator ───────────────────────────────────
164
+ // Generates an `nbits`-bit odd integer with the top two bits set.
165
+ function _randCandidate(nbits, drbg) {
166
+ const nbytes = (nbits + 7) >>> 3;
167
+ const buf = drbg.generate(nbytes);
168
+ if (buf === false) return false;
169
+ // Top two bits of the most-significant byte.
170
+ const topBitInByte = ((nbits - 1) & 7);
171
+ const topMask = 1 << topBitInByte;
172
+ const next = topBitInByte === 0 ? 0x80 : (1 << (topBitInByte - 1));
173
+ // Clear bits above the desired length, then set top two and odd.
174
+ const keepMask = (topMask << 1) - 1;
175
+ buf[0] = (buf[0] & keepMask) | topMask | next;
176
+ buf[buf.length - 1] |= 1;
177
+ return _bnFromUint8(buf);
178
+ }
179
+
180
+ /**
181
+ * Generate a probable prime of the requested bit length, coprime with `e`.
182
+ *
183
+ * @param {number} nbits Bit length of the prime (e.g. 1024 for RSA-2048).
184
+ * @param {bn} eBn Public exponent as a `bn` instance.
185
+ * @param {object} drbg DRBG instance (`random.drbg()` or compatible).
186
+ * @returns {bn|false}
187
+ */
188
+ function generateProbablePrime(nbits, eBn, drbg) {
189
+ if (!Number.isInteger(nbits) || nbits < 256) {
190
+ console.warn('[crypto] INVALID: rsaKeygen: prime bit length must be ≥ 256');
191
+ return false;
192
+ }
193
+ const eIsSmall = eBn.bitLength() <= 24;
194
+ const eSmall = eIsSmall ? eBn.getLimb(0) : 0;
195
+ const ONE = new bn.bn(1);
196
+ const { k } = _mrRounds(nbits);
197
+
198
+ const MAX_ATTEMPTS = nbits * 5;
199
+ for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
200
+ const cand = _randCandidate(nbits, drbg);
201
+ if (cand === false) return false;
202
+ // gcd(cand - 1, e) == 1 - for prime e (e.g. 65537), reduces to (cand-1) mod e != 0.
203
+ const candMinus1 = cand.sub(ONE).normalize();
204
+ if (eIsSmall) {
205
+ if (_modSmall(candMinus1, eSmall) === 0) continue;
206
+ } else {
207
+ // Generic gcd via inverseMod (returns false on non-coprime).
208
+ if (eBn.inverseMod(candMinus1) === false) continue;
209
+ }
210
+ if (_isDivisibleBySmall(cand)) continue;
211
+ if (!_millerRabin(cand, k, drbg)) continue;
212
+ return cand;
213
+ }
214
+ console.error('[crypto] BUG: rsaKeygen: exceeded prime search budget');
215
+ return false;
216
+ }
217
+
218
+ // ── modular inverse for arbitrary (incl. even) modulus ──────────
219
+ // bn.inverseMod requires an odd modulus (binary-GCD halving variant).
220
+ // λ(n) is always even, so we split m = 2^k · u (u odd) and combine
221
+ // via CRT. The 2^k inverse is obtained by Hensel lifting (a odd).
222
+ function _modPow2(k) {
223
+ const out = new bn.bn(1);
224
+ for (let i = 0; i < k; i++) out.doubleM();
225
+ return out.normalize();
226
+ }
227
+ function _hensel2adic(a, k) {
228
+ // Given odd `a` and a power-of-two precision target `k`, returns
229
+ // x such that a · x ≡ 1 (mod 2^k). Doubles precision each step.
230
+ const TWO = new bn.bn(2);
231
+ let x = new bn.bn(1); // a · 1 ≡ 1 (mod 2) since a odd
232
+ let prec = 1;
233
+ while (prec < k) {
234
+ prec = Math.min(prec * 2, k);
235
+ const modP = _modPow2(prec);
236
+ const axMod = a.mul(x).mod(modP).normalize();
237
+ let twoMinus;
238
+ if (TWO.greaterEquals(axMod)) {
239
+ twoMinus = TWO.sub(axMod).normalize();
240
+ } else {
241
+ twoMinus = modP.add(TWO).sub(axMod).normalize();
242
+ }
243
+ x = x.mul(twoMinus).mod(modP).normalize();
244
+ }
245
+ return x;
246
+ }
247
+ function _inverseModAny(a, m) {
248
+ if (m.equals(0)) return false;
249
+ // Strip factors of 2 from m: m = 2^k · u.
250
+ let u = m.copy();
251
+ let k = 0;
252
+ while (u.limbs.length && (u.getLimb(0) & 1) === 0) {
253
+ u.halveM(); k++;
254
+ }
255
+ u.normalize();
256
+ if (k === 0) return a.copy().mod(m).normalize().inverseMod(m);
257
+ // Inverse mod u (odd).
258
+ let dU;
259
+ if (u.equals(1)) {
260
+ dU = new bn.bn(0);
261
+ } else {
262
+ const aModU = a.copy().mod(u).normalize();
263
+ dU = aModU.inverseMod(u);
264
+ if (dU === false) return false;
265
+ }
266
+ // Inverse mod 2^k requires a to be odd.
267
+ if ((a.getLimb(0) & 1) === 0) return false;
268
+ const modK = _modPow2(k);
269
+ const d2 = _hensel2adic(a, k).mod(modK).normalize();
270
+ // CRT: d = dU + u · (((d2 - dU) · u^(-1)) mod 2^k)
271
+ const uInv = _hensel2adic(u, k).mod(modK).normalize();
272
+ const dUmod = dU.mod(modK).normalize();
273
+ let diff;
274
+ if (d2.greaterEquals(dUmod)) diff = d2.sub(dUmod).normalize();
275
+ else diff = modK.add(d2).sub(dUmod).normalize();
276
+ const t = diff.mul(uInv).mod(modK).normalize();
277
+ const d = dU.add(u.mul(t)).normalize();
278
+ return d.mod(m).normalize();
279
+ }
280
+
281
+ // ── integer division (binary long division) ─────────────────────
282
+ // Returns { q, r } such that a = q · b + r and 0 ≤ r < b.
283
+ // Used by _lcm and by rsa CRT. b must be > 0.
284
+ function _bitAt(x, i) {
285
+ const limbIdx = (i / 24) | 0;
286
+ const off = i % 24;
287
+ return (x.getLimb(limbIdx) >>> off) & 1;
288
+ }
289
+ function _setBit(x, i) {
290
+ const limbIdx = (i / 24) | 0;
291
+ const off = i % 24;
292
+ while (x.limbs.length <= limbIdx) x.limbs.push(0);
293
+ x.limbs[limbIdx] |= (1 << off);
294
+ }
295
+ function _divmod(a, b) {
296
+ if (b.equals(0)) {
297
+ console.error('[crypto] BUG: rsaKeygen: division by zero');
298
+ return false;
299
+ }
300
+ if (!a.greaterEquals(b)) return { q: new bn.bn(0), r: a.copy().normalize() };
301
+ const aLen = a.bitLength();
302
+ const q = new bn.bn(0);
303
+ const r = new bn.bn(0);
304
+ for (let i = aLen - 1; i >= 0; i--) {
305
+ r.doubleM();
306
+ if (_bitAt(a, i)) {
307
+ if (r.limbs.length === 0) r.limbs.push(0);
308
+ r.limbs[0] |= 1;
309
+ }
310
+ r.normalize();
311
+ if (r.greaterEquals(b)) {
312
+ r.subM(b); r.normalize();
313
+ _setBit(q, i);
314
+ }
315
+ }
316
+ return { q: q.normalize(), r: r.normalize() };
317
+ }
318
+
319
+ // ── lcm via gcd (Euclidean over bn) ─────────────────────────────
320
+ function _gcd(a, b) {
321
+ a = a.copy(); b = b.copy();
322
+ while (!b.equals(0)) {
323
+ const t = a.mod(b);
324
+ a = b; b = t;
325
+ }
326
+ return a;
327
+ }
328
+ function _lcm(a, b) {
329
+ // Exact: lcm(a, b) = (a / gcd(a, b)) · b.
330
+ const g = _gcd(a, b);
331
+ if (g.equals(0)) return new bn.bn(0);
332
+ // @ts-ignore - _divmod(a,g) is safe here: g.equals(0) is guarded above, so result is always {q,r}
333
+ const { q: aOverG } = _divmod(a, g);
334
+ return aOverG.mul(b).normalize();
335
+ }
336
+
337
+ /**
338
+ * Generate an RSA key pair.
339
+ *
340
+ * @param {object} [options]
341
+ * @param {number} [options.bits=2048] Modulus length: 2048, 3072 or 4096.
342
+ * @param {number} [options.e=65537] Public exponent (must be odd, ≥ 3).
343
+ * @param {object} [options.drbg] SP 800-90A DRBG instance; defaults
344
+ * to `random.drbg()`.
345
+ * @returns {{
346
+ * publicKey: { n: Uint8Array, e: Uint8Array },
347
+ * privateKey: { n: Uint8Array, e: Uint8Array, d: Uint8Array,
348
+ * p: Uint8Array, q: Uint8Array,
349
+ * dp: Uint8Array, dq: Uint8Array, qInv: Uint8Array }
350
+ * } | false}
351
+ */
352
+ function generate(options = {}) {
353
+ const nlen = options.bits ?? 2048;
354
+ const eVal = options.e ?? 65537;
355
+ if (![2048, 3072, 4096].includes(nlen)) {
356
+ console.warn('[crypto] INVALID: rsaKeygen: bits must be 2048, 3072 or 4096');
357
+ return false;
358
+ }
359
+ if (!Number.isInteger(eVal) || eVal < 3 || (eVal & 1) === 0) {
360
+ console.warn('[crypto] INVALID: rsaKeygen: e must be an odd integer ≥ 3');
361
+ return false;
362
+ }
363
+ const drbg = options.drbg ?? random.drbg();
364
+ if (!drbg) return false;
365
+
366
+ const eBn = new bn.bn(eVal);
367
+ const ONE = new bn.bn(1);
368
+ const halfBits = nlen >>> 1;
369
+
370
+ const p = generateProbablePrime(halfBits, eBn, drbg);
371
+ if (p === false) return false;
372
+
373
+ // |p - q| > 2^(halfBits - 100) - enforce by retry.
374
+ const minDeltaBits = halfBits - 100;
375
+ let q;
376
+ for (let attempt = 0; attempt < 100; attempt++) {
377
+ q = generateProbablePrime(halfBits, eBn, drbg);
378
+ if (q === false) return false;
379
+ const diff = p.greaterEquals(q) ? p.sub(q).normalize() : q.sub(p).normalize();
380
+ if (diff.bitLength() > minDeltaBits && !p.equals(q)) break;
381
+ q = false;
382
+ }
383
+ if (q === false) {
384
+ console.error('[crypto] BUG: rsaKeygen: could not satisfy |p-q| constraint');
385
+ return false;
386
+ }
387
+
388
+ const n = p.mul(q).normalize();
389
+ const pMinus = p.sub(ONE).normalize();
390
+ const qMinus = q.sub(ONE).normalize();
391
+ const lambda = _lcm(pMinus, qMinus);
392
+
393
+ const d = _inverseModAny(eBn, lambda);
394
+ if (d === false) {
395
+ console.error('[crypto] BUG: rsaKeygen: failed to invert e mod λ(n)');
396
+ return false;
397
+ }
398
+ // FIPS 186-5 §A.1.1: require d > 2^(nlen/2).
399
+ if (d.bitLength() <= halfBits) {
400
+ console.warn('[crypto] rsaKeygen: d too small, retrying');
401
+ return generate(options);
402
+ }
403
+
404
+ const dp = d.mod(pMinus).normalize();
405
+ const dq = d.mod(qMinus).normalize();
406
+ const qInv = q.inverseMod(p);
407
+ if (qInv === false) {
408
+ console.error('[crypto] BUG: rsaKeygen: failed to compute qInv');
409
+ return false;
410
+ }
411
+
412
+ const nByteLen = nlen >>> 3;
413
+ const halfByteLen = halfBits >>> 3;
414
+ const eByteLen = (eBn.bitLength() + 7) >>> 3;
415
+
416
+ const nBytes = _bnToBytes(n, nByteLen);
417
+ const eBytes = _bnToBytes(eBn, eByteLen);
418
+ const dBytes = _bnToBytes(d, nByteLen);
419
+ const pBytes = _bnToBytes(p, halfByteLen);
420
+ const qBytes = _bnToBytes(q, halfByteLen);
421
+ const dpBytes = _bnToBytes(dp, halfByteLen);
422
+ const dqBytes = _bnToBytes(dq, halfByteLen);
423
+ const qiBytes = _bnToBytes(qInv, halfByteLen);
424
+
425
+ return {
426
+ publicKey: { n: nBytes, e: eBytes },
427
+ privateKey: {
428
+ n: nBytes, e: eBytes, d: dBytes,
429
+ p: pBytes, q: qBytes,
430
+ dp: dpBytes, dq: dqBytes, qInv: qiBytes
431
+ }
432
+ };
433
+ }
434
+
435
+ return {
436
+ generate,
437
+ generateProbablePrime,
438
+ // Internal primitives - exposed for KAT tests only. Not API.
439
+ _internal: {
440
+ millerRabin: _millerRabin,
441
+ smallPrimes: _SMALL_PRIMES,
442
+ divmod: _divmod,
443
+ lcm: _lcm,
444
+ inverseModAny: _inverseModAny
445
+ }
446
+ };
447
+ }
448
+ };