@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,113 @@
1
+ # `x25519.js` — RFC interop conformance
2
+
3
+ > **STATUS: RFC interop — outside NIST/CAVP validation.**
4
+ > X25519 is not a FIPS 140-3 approved algorithm (NIST/SP 800-186
5
+ > retains ECDH P-{224,256,384,521}; Curve25519 / X25519 remains
6
+ > outside the scope of FIPS-validated modules despite being widely
7
+ > deployed in TLS 1.3, Noise, Signal, OpenSSH, WireGuard). No ACVP
8
+ > vector published by NIST. Coverage is exclusively RFC 7748 + Wycheproof.
9
+
10
+ ## Standards
11
+
12
+ - **Primary**: **RFC 7748** — *Elliptic Curves for Security* (January
13
+ 2016), §5 Curve25519 / §5.2 test vectors, §6 Diffie-Hellman, §7
14
+ security considerations.
15
+ - **Secondary**: Bernstein 2006 — *Curve25519: new Diffie-Hellman
16
+ speed records*. Wycheproof X25519 (Project Wycheproof, Google).
17
+ - **No NIST ACVP vector** — Curve25519/X25519 is not among the
18
+ curves approved by SP 800-186.
19
+
20
+ ## Implemented algorithm
21
+
22
+ `x25519.factory()` exposes Curve25519 ECDH (variable-base and fixed-base).
23
+ Montgomery-ladder implementation (TweetNaCl-derived, 16 limbs of Float64
24
+ with carry propagation). Public API (`Uint8Array`):
25
+
26
+ - `scalarMult(scalar, u)` → 32 bytes (shared secret) or `false` if
27
+ size ≠ 32 bytes. Performs the RFC 7748 §5 clamping
28
+ (`scalar[0] &= 248; scalar[31] &= 127; scalar[31] |= 64`) and masks
29
+ the MSB of `u` (§5 last paragraph).
30
+ - `scalarMultBase(scalar)` → `scalarMult(scalar, [9, 0, ..., 0])`.
31
+
32
+ No explicit validation of low-order points: the product
33
+ `scalarMult(scalar, low_order_u)` returns `0...0`. The caller must
34
+ check for an all-zero tag if a contributory property is
35
+ required (cf. RFC 7748 §6.1, §7).
36
+
37
+ ## Test coverage
38
+
39
+ ### Integrated official vectors
40
+
41
+ | Source | Reference | Test (`describe` / `test`) | Property verified |
42
+ |---|---|---|---|
43
+ | RFC 7748 §5.2 | Test vector 1 | `§5.2 test vector 1` | `scalarMult(k, u) == k×u` byte-exact |
44
+ | RFC 7748 §5.2 | Test vector 2 | `§5.2 test vector 2` | same |
45
+ | RFC 7748 §5.2 | Iterative — 1 iteration | `§5.2 iterative — after 1 iteration` | K₁ == 422c8e7a... |
46
+ | RFC 7748 §5.2 | Iterative — 1000 iterations | `§5.2 iterative — after 1000 iterations` | K₁₀₀₀ == 684cf59b... |
47
+ | RFC 7748 §5.2 | Iterative — 1,000,000 (`CRYPTO_FULL`-gated) | `§5.2 iterative — after 1,000,000 iterations` | K₁ₘ == 7c3911e0... (skipped by default, ~10 min) |
48
+ | RFC 7748 §6.1 | Alice/Bob DH agreement | `§6.1 ECDH agreement matches` | pubA, pubB, shared byte-exact + symmetry |
49
+ | RFC 7748 §5 | clamping (low-3 + high-2 bits) | `clamping — bit-flips ... are absorbed` | 4 mutations within the clamped bits produce the same output |
50
+ | RFC 7748 §5 | high-bit u-coord ignored | `§5 high bit of u is ignored on input` | identical output with/without MSB(u) set |
51
+ | Curve25519 spec / Wycheproof | u=0 | `low-order point u=0 → 0` | all-zero shared secret |
52
+ | Curve25519 spec / Wycheproof | u=1 (order-2) | `low-order point u=1 → 0` | all-zero shared secret |
53
+ | Curve25519 spec / Wycheproof | u=p-1 (order-2) | `low-order point u=p-1 → 0` | all-zero shared secret |
54
+ | Stress | 5 random DH pairs | `ECDH symmetry on 5 random scalar pairs` | DH symmetry + non-triviality |
55
+ | Pre-existing | size rejection | `rejects non-32-byte scalar` | `false` on a 31-byte scalar |
56
+ | Added | u size rejection | `rejects non-32-byte u` | `false` on a 31-byte u |
57
+
58
+ ### Security properties tested
59
+
60
+ - [x] **RFC 7748 §5.1.5 clamping** — 4 bit-flip vectors absorbed
61
+ (low-3 of byte 0, high-2 of byte 31).
62
+ - [x] **MSB masking of u** — identical output with MSB(u)=1 or 0.
63
+ - [x] **Deterministic propagation** — iterative 1 and 1000 byte-exact;
64
+ iterative 1M gated by CRYPTO_FULL.
65
+ - [x] **Low-order u detection** — 3 vectors (u=0, u=1, u=p-1); all
66
+ return an all-zero shared secret (the caller must check).
67
+ - [x] **ECDH symmetry** — 5 random pairs `aB == bA`.
68
+ - [x] **Length validation** — early return false on scalar/u ≠ 32 bytes.
69
+ - [x] **No `throw`** — `console.warn` + `return false` (review
70
+ lines 154-162 x25519.js).
71
+ - [x] **Explicit rejection of low-order pk** — **Iteration G5**: helper
72
+ `isLowOrderPoint(u)` exposed. Compares `u` (canonicalized via `& 0x7f`
73
+ on byte 31 per RFC 7748 §5) constant-time against 7 documented
74
+ low-order u-coords (Bernstein 2006 + Wycheproof + libsodium). Lets
75
+ the caller filter *before* `scalarMult` instead of testing `output
76
+ === 0…0` afterwards. 13 new tests (7 LOPs detected + high-bit
77
+ variant + 2 valid pk + base point + cross-check `scalarMult(scalar, lop) === 0`
78
+ across the 7 + length edge cases).
79
+ - [ ] **Strict constant-time** — `_M`/`_S` Float64 + carry, `_sel25519`
80
+ is CT but `_pow2523` uses a fixed addition chain. Acceptable for
81
+ RFC 7748 §A.1's interactive ECDH context; **P3** for CMVP-like
82
+ SCA audit.
83
+
84
+ ## FIPS 140-3 conformance
85
+
86
+ | Requirement | Status | Evidence |
87
+ |---|---|---|
88
+ | Approved algorithm | ❌ N/A | Curve25519 / X25519 outside SP 800-186 |
89
+ | RFC 7748 conformance | ✅ | 5 §5.2 vectors + §6.1 + §5 clamping/masking byte-exact |
90
+ | Iterative RFC 7748 | ✅ partial | 1 + 1000 iterations covered; 1M under CRYPTO_FULL |
91
+ | Low-order pk detection | ✅ (opt-in helper) | **Iteration G5**: `isLowOrderPoint(u)` constant-time against 7 documented LOPs; caller-side rejection before `scalarMult` |
92
+ | No `throw` | ✅ | `console.warn` + return false |
93
+
94
+ ## Known limitations
95
+
96
+ - **Outside NIST scope** — no ACVP equivalent. Validation = RFC
97
+ 7748 + Wycheproof + the Curve25519 spec (Bernstein).
98
+ - **1,000,000 iter**: the RFC 7748 §5.2 checkpoint only runs under
99
+ `CRYPTO_FULL=1` (~10 min).
100
+ - ~~**No automatic rejection of low-order u**~~ — partially resolved in
101
+ G5: `isLowOrderPoint(u)` is available caller-side. `scalarMult` still
102
+ accepts LOPs (RFC 7748 backward compatibility); the caller decides
103
+ whether to reject. Preferable on the authenticated side (TLS 1.3
104
+ (EC)DHE + signature also covers the risk).
105
+ - **TweetNaCl-derived, not formally CT**: see P3 above.
106
+
107
+ ## Cross-references
108
+
109
+ - Module: [`pkc/x25519.js`](./x25519.js)
110
+ - Tests: [`pkc/x25519.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/x25519.test.js) — **27 tests** (26 pass + 1 skip CRYPTO_FULL — RFC 7748 §5.2 1M iterations; including the 13 added in G5: `isLowOrderPoint` detection of 7 LOPs + high-bit variant + 2 valid pk + base point + cross-check `scalarMult(scalar, lop) === 0` + edge cases; was 5 before the upgrade)
111
+ - RFC 7748: [`https://datatracker.ietf.org/doc/html/rfc7748`](https://datatracker.ietf.org/doc/html/rfc7748)
112
+ - Sibling Ed25519 module: [`./ed25519.acvp.md`](./ed25519.acvp.md)
113
+ - Global conformance: [`../NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)
@@ -0,0 +1,290 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview X25519 - Diffie-Hellman over Curve25519 (RFC 7748).
7
+ *
8
+ * Implements the Montgomery ladder for the curve y² = x³ + 486662x² + x
9
+ * over the prime field GF(2^255 − 19). Field elements are represented as
10
+ * Float64Array(16) of 16-bit limbs (TweetNaCl-derived (public domain; see
11
+ * docs/dev/provenance.md)) which gives exact 32-bit products in JS doubles
12
+ * and avoids 53-bit precision pitfalls during reduction.
13
+ *
14
+ * Public API takes raw Uint8Array (32 bytes for both scalar and u-coord)
15
+ * matching the wire format defined by RFC 7748 §5. The standard scalar
16
+ * clamping (clear low 3 bits, clear high bit, set bit 254) is applied
17
+ * automatically per §5 step 2.
18
+ *
19
+ */
20
+
21
+ /**
22
+ * Public API returned by `x25519.factory()`.
23
+ * @typedef {object} X25519API
24
+ * @property {(scalar: Uint8Array, u: Uint8Array) => (Uint8Array|false)} scalarMult Compute scalarmult(scalar, u); 32-byte output or false.
25
+ * @property {(scalar: Uint8Array) => (Uint8Array|false)} scalarMultBase scalarmult against the base point u=9.
26
+ * @property {(u: Uint8Array) => boolean} isLowOrderPoint True iff `u` is a documented low-order point (or malformed length).
27
+ * @property {{ lowOrderPoints: Uint8Array[] }} _internal Embedded low-order point table.
28
+ */
29
+
30
+ export const x25519 = {
31
+ name: 'x25519',
32
+ version: '1.0.0',
33
+ type: 'fw.crypto.pkc',
34
+ dependencies: [],
35
+
36
+ /** @returns {X25519API} */
37
+ factory() {
38
+
39
+ // Standard curve constant a24 = (486662 - 2) / 4 = 121665.
40
+ const _121665 = new Float64Array(16);
41
+ _121665[0] = 0xDB41; _121665[1] = 1;
42
+
43
+ function _gf(init) {
44
+ const r = new Float64Array(16);
45
+ if (init) for (let i = 0; i < init.length; i++) r[i] = init[i];
46
+ return r;
47
+ }
48
+
49
+ function _car25519(o) {
50
+ for (let i = 0; i < 16; i++) {
51
+ o[i] += 65536;
52
+ const c = Math.floor(o[i] / 65536);
53
+ o[(i + 1) * (i < 15 ? 1 : 0)] += c - 1 + 37 * (c - 1) * (i === 15 ? 1 : 0);
54
+ o[i] -= c * 65536;
55
+ }
56
+ }
57
+
58
+ // Constant-time conditional swap (TweetNaCl `sel25519`). The mask `c`
59
+ // is derived from `b` via bitwise arithmetic only - no data-dependent
60
+ // branch - so every iteration performs identical memory writes
61
+ // regardless of whether the swap actually happens. This is the
62
+ // primitive that keeps the Montgomery ladder side-channel free.
63
+ function _sel25519(p, q, b) {
64
+ const c = ~(b - 1);
65
+ for (let i = 0; i < 16; i++) {
66
+ const t = c & (p[i] ^ q[i]);
67
+ p[i] ^= t;
68
+ q[i] ^= t;
69
+ }
70
+ }
71
+
72
+ function _pack25519(o, n) {
73
+ const m = _gf(), t = _gf();
74
+ for (let i = 0; i < 16; i++) t[i] = n[i];
75
+ _car25519(t); _car25519(t); _car25519(t);
76
+ for (let j = 0; j < 2; j++) {
77
+ m[0] = t[0] - 0xffed;
78
+ for (let i = 1; i < 15; i++) {
79
+ m[i] = t[i] - 0xffff - ((m[i - 1] >> 16) & 1);
80
+ m[i - 1] &= 0xffff;
81
+ }
82
+ m[15] = t[15] - 0x7fff - ((m[14] >> 16) & 1);
83
+ const b = (m[15] >> 16) & 1;
84
+ m[14] &= 0xffff;
85
+ _sel25519(t, m, 1 - b);
86
+ }
87
+ for (let i = 0; i < 16; i++) {
88
+ o[2 * i] = t[i] & 0xff;
89
+ o[2 * i + 1] = t[i] >> 8;
90
+ }
91
+ }
92
+
93
+ function _unpack25519(o, n) {
94
+ for (let i = 0; i < 16; i++) o[i] = n[2 * i] + (n[2 * i + 1] << 8);
95
+ o[15] &= 0x7fff;
96
+ }
97
+
98
+ function _A(o, a, b) { for (let i = 0; i < 16; i++) o[i] = a[i] + b[i]; }
99
+ function _Z(o, a, b) { for (let i = 0; i < 16; i++) o[i] = a[i] - b[i]; }
100
+
101
+ function _M(o, a, b) {
102
+ const t = new Float64Array(31);
103
+ for (let i = 0; i < 16; i++) {
104
+ for (let j = 0; j < 16; j++) {
105
+ t[i + j] += a[i] * b[j];
106
+ }
107
+ }
108
+ for (let i = 0; i < 15; i++) t[i] += 38 * t[i + 16];
109
+ for (let i = 0; i < 16; i++) o[i] = t[i];
110
+ _car25519(o); _car25519(o);
111
+ }
112
+
113
+ function _S(o, a) { _M(o, a, a); }
114
+
115
+ function _inv25519(o, i) {
116
+ const c = _gf();
117
+ for (let a = 0; a < 16; a++) c[a] = i[a];
118
+ for (let a = 253; a >= 0; a--) {
119
+ _S(c, c);
120
+ if (a !== 2 && a !== 4) _M(c, c, i);
121
+ }
122
+ for (let a = 0; a < 16; a++) o[a] = c[a];
123
+ }
124
+
125
+ function _scalarmult(q, n, p) {
126
+ const z = new Uint8Array(32);
127
+ const x = _gf(), a = _gf(), b = _gf(), c = _gf(), d = _gf(), e = _gf(), f = _gf();
128
+ for (let i = 0; i < 31; i++) z[i] = n[i];
129
+ z[31] = (n[31] & 127) | 64;
130
+ z[0] &= 248;
131
+ _unpack25519(x, p);
132
+ for (let i = 0; i < 16; i++) { b[i] = x[i]; d[i] = a[i] = c[i] = 0; }
133
+ a[0] = d[0] = 1;
134
+ for (let i = 254; i >= 0; --i) {
135
+ const r = (z[i >>> 3] >>> (i & 7)) & 1;
136
+ _sel25519(a, b, r);
137
+ _sel25519(c, d, r);
138
+ _A(e, a, c);
139
+ _Z(a, a, c);
140
+ _A(c, b, d);
141
+ _Z(b, b, d);
142
+ _S(d, e);
143
+ _S(f, a);
144
+ _M(a, c, a);
145
+ _M(c, b, e);
146
+ _A(e, a, c);
147
+ _Z(a, a, c);
148
+ _S(b, a);
149
+ _Z(c, d, f);
150
+ _M(a, c, _121665);
151
+ _A(a, a, d);
152
+ _M(c, c, a);
153
+ _M(a, d, f);
154
+ _M(d, b, x);
155
+ _S(b, e);
156
+ _sel25519(a, b, r);
157
+ _sel25519(c, d, r);
158
+ }
159
+ _inv25519(c, c);
160
+ _M(a, a, c);
161
+ _pack25519(q, a);
162
+ return 0;
163
+ }
164
+
165
+ const _BASE = new Uint8Array(32);
166
+ _BASE[0] = 9;
167
+
168
+ /**
169
+ * Compute scalarmult(scalar, u).
170
+ * @param {Uint8Array} scalar 32-byte scalar (will be clamped).
171
+ * @param {Uint8Array} u 32-byte u-coordinate.
172
+ * @returns {Uint8Array|false} 32-byte shared secret / output u-coordinate, or false on invalid input.
173
+ */
174
+ function scalarMult(scalar, u) {
175
+ if (!(scalar instanceof Uint8Array) || scalar.length !== 32) {
176
+ console.warn('[crypto] INVALID: x25519: scalar must be 32 bytes');
177
+ return false;
178
+ }
179
+ if (!(u instanceof Uint8Array) || u.length !== 32) {
180
+ console.warn('[crypto] INVALID: x25519: u must be 32 bytes');
181
+ return false;
182
+ }
183
+ const out = new Uint8Array(32);
184
+ _scalarmult(out, scalar, u);
185
+ return out;
186
+ }
187
+
188
+ /** scalarmult of `scalar` against the standard base point u=9. */
189
+ function scalarMultBase(scalar) {
190
+ return scalarMult(scalar, _BASE);
191
+ }
192
+
193
+ // ── Iteration G5 - Low-order point detection helper ──────────────
194
+ //
195
+ // Curve25519 has cofactor 8; some u-coords generate a subgroup
196
+ // of small order (1, 2, 4, 8). If Alice uses such a u
197
+ // as Bob's public key, the product `scalarMult(scalar, u)` is
198
+ // **always zero** or takes one of a few predictable values -
199
+ // which allows an active attacker (substituting the public key
200
+ // in a Diffie-Hellman exchange) to force a known shared secret.
201
+ //
202
+ // RFC 7748 §6.1 recommends either (a) accepting small-order
203
+ // points and letting the `result === 00…00` check filter downstream,
204
+ // or (b) explicitly rejecting before `scalarMult`. This helper offers
205
+ // option (b), explicit on the caller side.
206
+ //
207
+ // List: 7 unique u-coordinates documented (Bernstein 2006,
208
+ // Wycheproof project, libsodium `crypto_scalarmult_curve25519_ref10`
209
+ // table `crypto_scalarmult_curve25519_ref10_is_canonical`).
210
+ //
211
+ // - 0x00…00 : order-4 point (≈ point at infinity)
212
+ // - 0x01…00 : order-1 point (trivial generator)
213
+ // - 0xe0eb7a…85a800 : order 8 (on the main curve)
214
+ // - 0x5f9c95…1f1157 : order 8 (on the twist)
215
+ // - 0xec…7f, 0xed…7f, 0xee…7f : equivalents mod p of the three above.
216
+ //
217
+ // Constant-time comparison to avoid timing leak on `u` (even
218
+ // if `u` is public, the pattern remains best practice).
219
+ const _LOW_ORDER_POINTS = [
220
+ // 7 unique low-order u-coordinates on Curve25519 (cofactor 8).
221
+ new Uint8Array([
222
+ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
223
+ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
224
+ ]),
225
+ new Uint8Array([
226
+ 0x01,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
227
+ 0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,0x00,
228
+ ]),
229
+ new Uint8Array([
230
+ 0xe0,0xeb,0x7a,0x7c,0x3b,0x41,0xb8,0xae,0x16,0x56,0xe3,0xfa,0xf1,0x9f,0xc4,0x6a,
231
+ 0xda,0x09,0x8d,0xeb,0x9c,0x32,0xb1,0xfd,0x86,0x62,0x05,0x16,0x5f,0x49,0xb8,0x00,
232
+ ]),
233
+ new Uint8Array([
234
+ 0x5f,0x9c,0x95,0xbc,0xa3,0x50,0x8c,0x24,0xb1,0xd0,0xb1,0x55,0x9c,0x83,0xef,0x5b,
235
+ 0x04,0x44,0x5c,0xc4,0x58,0x1c,0x8e,0x86,0xd8,0x22,0x4e,0xdd,0xd0,0x9f,0x11,0x57,
236
+ ]),
237
+ new Uint8Array([
238
+ 0xec,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,
239
+ 0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0x7f,
240
+ ]),
241
+ new Uint8Array([
242
+ 0xed,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,
243
+ 0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0x7f,
244
+ ]),
245
+ new Uint8Array([
246
+ 0xee,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,
247
+ 0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0xff,0x7f,
248
+ ]),
249
+ ];
250
+
251
+ /**
252
+ * Test whether `u` is one of the documented low-order u-coordinates
253
+ * on Curve25519 (cofactor-8 subgroup elements). RFC 7748 §6.1.
254
+ *
255
+ * Constant-time comparison vs the embedded table.
256
+ *
257
+ * @param {Uint8Array} u 32-byte u-coordinate.
258
+ * @returns {boolean} true iff `u` is low-order (or a malformed length).
259
+ */
260
+ function isLowOrderPoint(u) {
261
+ if (!(u instanceof Uint8Array) || u.length !== 32) {
262
+ console.warn('[crypto] INVALID: x25519: u must be 32 bytes');
263
+ return false;
264
+ }
265
+ // Mask the high bit per RFC 7748 §5 (`u_255 = 0`) to canonicalise.
266
+ const norm = new Uint8Array(u);
267
+ norm[31] &= 0x7f;
268
+ // Constant-time : OR-accumulate `(norm == lop)` over all entries.
269
+ // We aggregate `equal_i` into a flag then return `flag !== 0`.
270
+ let anyMatch = 0;
271
+ for (let p = 0; p < _LOW_ORDER_POINTS.length; p++) {
272
+ const lop = _LOW_ORDER_POINTS[p];
273
+ let diff = 0;
274
+ for (let i = 0; i < 32; i++) diff |= (norm[i] ^ lop[i]);
275
+ // diff === 0 ⇒ match. Convert to {0, 1} branchless :
276
+ // ((diff - 1) >>> 31) returns 1 only when diff === 0.
277
+ anyMatch |= ((diff - 1) >>> 31) & 1;
278
+ }
279
+ return anyMatch === 1;
280
+ }
281
+
282
+ return {
283
+ scalarMult,
284
+ scalarMultBase,
285
+ // Iteration G5 - opt-in defensive helper.
286
+ isLowOrderPoint,
287
+ _internal: { lowOrderPoints: _LOW_ORDER_POINTS }
288
+ };
289
+ }
290
+ };
@@ -0,0 +1,67 @@
1
+ # `aes_ctr.js` — ACVP / NIST conformance
2
+
3
+ > **Legacy convenience wrapper** for Uint8Array ↔ AES-CTR with PKCS#7 padding
4
+ > handled internally. Keeps a historical object API (`new _Encrypt(key, iv)` →
5
+ > `pad/strip/raw/ba_*` methods). **All FIPS / SP
6
+ > 800-38A conformance is delegated to `mode/ctr.js`.** Prefer
7
+ > [`utils/aes_modes.js`](aes_modes.js) (`aes_modes.ctr.{encrypt,decrypt}`) for
8
+ > any new code.
9
+
10
+ ## Status (Iteration I1)
11
+
12
+ **`@deprecated` (soft)** — no export removed, no runtime warn added
13
+ so as not to break existing consumers. The doc header of
14
+ `aes_ctr.js` redirects to `aes_modes.ctr`.
15
+
16
+ ## Standards (delegated)
17
+
18
+ - **FIPS 197** — AES block (cf. [`cipher/aes.acvp.md`](../cipher/aes.acvp.md)).
19
+ - **SP 800-38A §6.5** (CTR) — cf. [`mode/ctr.acvp.md`](../mode/ctr.acvp.md).
20
+ - **PKCS #7 padding** — cf. [`utils/pad.js`](pad.js) (PKCS#7 RFC 5652 §6.3).
21
+
22
+ ## Implemented algorithm
23
+
24
+ `aes_ctr.factory(bitArray, aes, ctr, pad)` exposes:
25
+
26
+ - `ui8(key, iv)` → instance with:
27
+ - `pad(plaintext)` — encrypt + PKCS#7 pad → CT
28
+ - `strip(ciphertext)` — decrypt + PKCS#7 strip → PT
29
+ - `raw(data)` — XOR keystream without padding (CTR is an involution)
30
+ - `update(iv)` — change the initial counter (rare)
31
+ - `ba_raw / ba_update` — bitArray variants (internal, avoids
32
+ Uint8Array→bitArray marshalling on the hot path)
33
+
34
+ ## Test coverage
35
+
36
+ `aes_ctr.test.js` covers round-trip + cross-check against raw
37
+ `mode/ctr.js`. No KAT re-validation — fully delegated to
38
+ [`mode/ctr.acvp.md`](../mode/ctr.acvp.md) (ACVP-AES-CTR-1.0).
39
+
40
+ ## FIPS 140-3 conformance (delegated)
41
+
42
+ | Requirement | Status | Reference |
43
+ |---|---|---|
44
+ | Approved algorithm | ✅ | cipher/aes + mode/ctr |
45
+ | Byte-exact ACVP vectors | ✅ | delegated |
46
+ | No `throw` | ✅ | delegated (consumes `false` returns without propagating) |
47
+ | AEAD authenticity | ❌ N/A | **CTR is malleable** — no authentication; requires encrypt-then-MAC or switching to `aes_modes.gcm` |
48
+
49
+ ## Known limitations
50
+
51
+ - **Non-uniform legacy API** vs. `aes_modes` (3 separate calls instead
52
+ of a simple `encrypt(key, iv, pt)`). Kept for back-compat.
53
+ - **PKCS #7 padding in CTR**: semantically odd (CTR does not need
54
+ padding) — a usage holdover where padding signaled the message
55
+ length. For new code, prefer `aes_modes.ctr.encrypt` (no
56
+ padding, length transmitted out-of-band) or `aes_modes.gcm` (AEAD).
57
+ - **No nonce-uniqueness protection**: see `mode/ctr.acvp.md` —
58
+ a (key, IV) collision → keystream recovery → plaintext leak.
59
+ The caller must guarantee uniqueness.
60
+
61
+ ## Cross-references
62
+
63
+ - [`mode/ctr.acvp.md`](../mode/ctr.acvp.md) — algorithm + ACVP vectors.
64
+ - [`utils/aes_modes.acvp.md`](aes_modes.acvp.md) — recommended wrapper for
65
+ new code (uniform API across all modes).
66
+ - **I1** iteration of the FIPS 140-3 upgrade plan: legacy status
67
+ clarification + redirection to `aes_modes`.
@@ -0,0 +1,134 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview AES-CTR convenience wrapper that combines `aes`, `ctr` and
7
+ * PKCS#7 padding for byte-array (Uint8Array) input/output.
8
+ *
9
+ * @deprecated Iteration I1 of the FIPS 140-3 upgrade plan: this module is
10
+ * kept for back-compat only; new code MUST use `utils/aes_modes.js`
11
+ * (`aes_modes.ctr.{encrypt,decrypt}`) which provides a uniform Uint8Array
12
+ * API across every mode (CBC/CTR/GCM/KW/KWP). See `aes_ctr.acvp.md` for
13
+ * details. Planned removal once consumers have migrated.
14
+ *
15
+ * Note: AES-CTR is malleable; this wrapper provides confidentiality only.
16
+ * If you need authenticated encryption, layer an HMAC over the ciphertext
17
+ * (encrypt-then-MAC) or switch to an AEAD construction (`aes_modes.gcm`).
18
+ *
19
+ */
20
+
21
+ /**
22
+ * Public shape of an AES-CTR instance returned by `ui8()`.
23
+ * @typedef {object} AesCtrInstance
24
+ * @property {(iv: Uint8Array) => void} update Replace the IV (Uint8Array form).
25
+ * @property {(arr: Uint8Array) => (Uint8Array|false)} pad PKCS#7-pad then CTR-encrypt.
26
+ * @property {(arr: Uint8Array) => (Uint8Array|false)} strip CTR-decrypt then strip PKCS#7 padding.
27
+ * @property {(arr: Uint8Array) => (Uint8Array|false)} raw Raw CTR encrypt/decrypt (no padding).
28
+ * @property {(ba_iv: number[]) => void} ba_update Replace the IV (bitArray form).
29
+ * @property {(b_arr: number[]) => (number[]|false)} ba_raw Raw CTR over bitArray input/output.
30
+ */
31
+
32
+ /**
33
+ * Public surface of `aes_ctr.factory(...)`.
34
+ * @typedef {object} AesCtrApi
35
+ * @property {(key: Uint8Array, iv: Uint8Array) => AesCtrInstance} ui8 Build an instance from Uint8Array key/IV.
36
+ */
37
+
38
+ import { bitArray } from './bitArray.js';
39
+ import { aes } from '../cipher/aes.js';
40
+ import { ctr } from '../mode/ctr.js';
41
+ import { pad } from './pad.js';
42
+
43
+ export const aes_ctr = {
44
+ name: 'aes_ctr',
45
+ version: '1.0.0',
46
+ type: 'fw.crypto.utils',
47
+ dependencies: ['bitArray', 'aes', 'ctr', 'pad'],
48
+ deps: [bitArray, aes, ctr, pad],
49
+
50
+ /** @returns {AesCtrApi} */
51
+ factory(bitArray, aes, ctr, pad) {
52
+
53
+ const _Encrypt = function (k, iv) {
54
+ this.k = bitArray.ui8_to_ba(k);
55
+ this.iv = bitArray.ui8_to_ba(iv);
56
+ this.cipher = aes.fn(this.k, false);
57
+ if (this.cipher === false) {
58
+ console.warn('[crypto] INVALID: aes_ctr: invalid key - cipher init failed');
59
+ this._dead = true;
60
+ }
61
+ };
62
+
63
+ /**
64
+ * Replace the counter / IV used by this instance (Uint8Array form).
65
+ * @param {Uint8Array} iv
66
+ */
67
+ _Encrypt.prototype.update = function (iv) {
68
+ this.iv = bitArray.ui8_to_ba(iv);
69
+ };
70
+
71
+ /**
72
+ * Encrypt arbitrary-length plaintext with PKCS#7 padding applied
73
+ * before CTR-mode encryption.
74
+ * @param {Uint8Array} arr
75
+ * @returns {Uint8Array|false}
76
+ */
77
+ _Encrypt.prototype.pad = function (arr) {
78
+ if (this._dead) return false;
79
+ const padded = pad.pad(arr);
80
+ if (padded === false) return false;
81
+ return bitArray.ba_to_ui8(
82
+ ctr.encrypt(this.cipher, bitArray.ui8_to_ba(padded), this.iv, '')
83
+ );
84
+ };
85
+
86
+ /**
87
+ * Decrypt CTR-ciphertext and strip PKCS#7 padding.
88
+ * @param {Uint8Array} arr
89
+ * @returns {Uint8Array|false}
90
+ */
91
+ _Encrypt.prototype.strip = function (arr) {
92
+ if (this._dead) return false;
93
+ return pad.strip(bitArray.ba_to_ui8(
94
+ ctr.encrypt(this.cipher, bitArray.ui8_to_ba(arr), this.iv, '')
95
+ ));
96
+ };
97
+
98
+ /**
99
+ * Raw CTR encrypt/decrypt with no padding (CTR is its own inverse).
100
+ * @param {Uint8Array} arr
101
+ * @returns {Uint8Array|false}
102
+ */
103
+ _Encrypt.prototype.raw = function (arr) {
104
+ if (this._dead) return false;
105
+ return bitArray.ba_to_ui8(
106
+ ctr.encrypt(this.cipher, bitArray.ui8_to_ba(arr), this.iv, '')
107
+ );
108
+ };
109
+
110
+ /**
111
+ * Replace the counter / IV used by this instance (bitArray form).
112
+ * @param {number[]} ba_iv
113
+ */
114
+ _Encrypt.prototype.ba_update = function (ba_iv) {
115
+ this.iv = ba_iv;
116
+ };
117
+
118
+ /**
119
+ * Raw CTR encrypt/decrypt on bitArray-form input/output.
120
+ * @param {number[]} b_arr
121
+ * @returns {number[]|false}
122
+ */
123
+ _Encrypt.prototype.ba_raw = function (b_arr) {
124
+ if (this._dead) return false;
125
+ return ctr.encrypt(this.cipher, b_arr, this.iv, '');
126
+ };
127
+
128
+ return {
129
+ ui8(key, iv) {
130
+ return new _Encrypt(key, iv);
131
+ }
132
+ };
133
+ }
134
+ };
@@ -0,0 +1,66 @@
1
+ # `aes_modes.js` — ACVP / NIST conformance
2
+
3
+ > **Convenience wrapper** Uint8Array → Uint8Array aggregating the standard
4
+ > AES modes (CBC / CTR / GCM / KW / KWP). **All FIPS / SP 800
5
+ > conformance is delegated to the underlying modules**; this file contains
6
+ > no algorithmic logic of its own.
7
+
8
+ ## Standards (delegated)
9
+
10
+ - **FIPS 197** — AES block (cf. [`cipher/aes.acvp.md`](../cipher/aes.acvp.md)).
11
+ - **SP 800-38A** §6.2 (CBC) + §6.5 (CTR) — cf. [`mode/cbc.acvp.md`](../mode/cbc.acvp.md), [`mode/ctr.acvp.md`](../mode/ctr.acvp.md).
12
+ - **SP 800-38D** (GCM) — cf. [`mode/gcm.acvp.md`](../mode/gcm.acvp.md).
13
+ - **SP 800-38F** (KW, KWP) — cf. [`mode/kw.acvp.md`](../mode/kw.acvp.md).
14
+
15
+ ## Implemented algorithm
16
+
17
+ `aes_modes.factory(bitArray, aes, cbc, ctr, gcm, kw, pad)` exposes a
18
+ namespace per mode (`cbc`, `ctr`, `gcm`, `kw`, `kwp`) with a
19
+ Uint8Array-only API:
20
+
21
+ - `cbc.encrypt(key, iv, plaintext)` → PKCS#7-padded CT / `false`
22
+ - `cbc.decrypt(key, iv, ciphertext)` → unpadded PT / `false`
23
+ - `ctr.encrypt/decrypt(key, iv, data)` → stream XOR, no padding
24
+ - `gcm.encrypt(key, iv, plaintext, aad?, tagLen?)` → `{ct, tag}`
25
+ - `gcm.decrypt(key, iv, ciphertext, tag, aad?)` → PT / `false`
26
+ - `kw.wrap/unwrap(kek, key)` → SP 800-38F §6.2
27
+ - `kwp.wrap/unwrap(kek, key)` → SP 800-38F §6.3
28
+
29
+ The goal is to spare external framework consumers (workers, business
30
+ modules) from having to handle the internal SJCL `bitArray`
31
+ representation. This layer only does
32
+ `Uint8Array ↔ bitArray` marshalling before calling the modes.
33
+
34
+ ## Test coverage
35
+
36
+ `aes_modes.test.js` covers:
37
+
38
+ - Round-trip encrypt/decrypt across the 5 namespaces × {AES-128, AES-192, AES-256}.
39
+ - Verifies warning propagation on invalid key/IV.
40
+ - No KAT re-validation — already fully covered by the
41
+ `mode/*.test.js` suites (1,600+ ACVP vectors).
42
+
43
+ ## FIPS 140-3 conformance (delegated)
44
+
45
+ | Requirement | Status | Reference |
46
+ |---|---|---|
47
+ | Approved algorithm | ✅ | cipher/aes + mode/{cbc,ctr,gcm,kw} |
48
+ | Byte-exact ACVP vectors | ✅ | delegated |
49
+ | No `throw` | ✅ | `console.warn` + `return false` |
50
+ | Stable Uint8Array API | ✅ | in scope for this module |
51
+
52
+ ## Known limitations
53
+
54
+ - **No mechanism of its own**: everything relies on the modes. If a
55
+ mode has a bug, this wrapper inherits it.
56
+ - **No GCM nonce-uniqueness protection**: delegated — the caller
57
+ must use `gcm.nonceTracker(prf)` to enable in-process
58
+ detection (cf. [mode/gcm.acvp.md](../mode/gcm.acvp.md)).
59
+
60
+ ## Cross-references
61
+
62
+ - [`cipher/aes.acvp.md`](../cipher/aes.acvp.md), [`mode/cbc.acvp.md`](../mode/cbc.acvp.md),
63
+ [`mode/ctr.acvp.md`](../mode/ctr.acvp.md), [`mode/gcm.acvp.md`](../mode/gcm.acvp.md),
64
+ [`mode/kw.acvp.md`](../mode/kw.acvp.md).
65
+ - **I1** iteration of the FIPS 140-3 upgrade plan: clarifies the
66
+ *convenience wrapper, FIPS coverage delegated* status.