@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,512 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview AES (FIPS-197) low-level block cipher.
7
+ *
8
+ * Schedules a key for AES-128/192/256 encryption (and optionally decryption)
9
+ * and exposes a single-block primitive. Use a cipher mode (e.g. CTR) for
10
+ * bulk data - this module never handles padding or IVs.
11
+ *
12
+ * Origin: the T-table precomputation, key schedule and T-table block path are
13
+ * adapted from the Stanford JavaScript Crypto Library (SJCL), BSD-2-Clause
14
+ * (SJCL is dual-licensed BSD-2-Clause OR GPL-2.0-or-later; the BSD-2-Clause
15
+ * terms are retained, see third-party/NOTICE-sjcl); the constant-time path,
16
+ * the ESM factory, JSDoc, tests and every later change are this project's own
17
+ * work. See docs/dev/provenance.md.
18
+ *
19
+ * S-box and MixColumns tables are precomputed once at factory time.
20
+ *
21
+ * ⚠️ **Cache-timing caveat** - the **default** `api.fn` path is now the
22
+ * constant-time implementation: SubBytes runs through a masked-lookup S-box
23
+ * (256 uniform reads per byte) so the memory access pattern is independent of
24
+ * the AES key/state. This is secure-by-default against Bernstein-style
25
+ * cache-timing attacks (Bernstein 2005, « Cache-timing attacks on AES ») at
26
+ * a cost of ~50-100× the throughput of the T-table path.
27
+ *
28
+ * The fast T-table scheduler (5 T-tables, ~5 KB, one indexed lookup per
29
+ * SubBytes ∘ MixColumns) is **opt-in** via `aes.ttable.fn(...)`. It is
30
+ * **NOT constant-time**: an attacker observing cache-miss latencies in a
31
+ * shared cache (cloud VM, serverless, hyper-thread) can recover the AES key.
32
+ * Use it only when the execution environment is not shared/hostile, or prefer
33
+ * WebCrypto (`crypto.subtle` - hardware AES-NI when available) for bulk work.
34
+ *
35
+ * `aes.bitsliced.fn(...)` is retained as a **deprecated alias** of `aes.fn`
36
+ * (both are constant-time now) for back-compat; prefer `aes.fn` directly.
37
+ *
38
+ * Block primitive returns `false` on invalid block length - every caller
39
+ * mode (CBC/CTR/GCM/CMAC/KW) treats a `false` result as failure (early
40
+ * return). Do not chain raw `crypt()` output without checking.
41
+ *
42
+ */
43
+
44
+ /**
45
+ * A scheduled AES cipher instance: single-block encrypt (and optionally
46
+ * decrypt) over a 4-word (128-bit) block. Returns `false` on invalid block
47
+ * length.
48
+ * @typedef {object} AesCipher
49
+ * @property {(data: number[]) => (number[]|false)} encrypt Encrypt one 4-word block.
50
+ * @property {(data: number[]) => (number[]|false)} [decrypt] Decrypt one 4-word block (present only when scheduled with `full=true`).
51
+ */
52
+
53
+ /**
54
+ * Key-schedule function producing an {@link AesCipher} (or `false` on invalid
55
+ * key size: must be 4/6/8 32-bit words for AES-128/192/256).
56
+ * @typedef {(input_key: number[], full?: boolean) => (AesCipher|false)} AesKeyScheduler
57
+ */
58
+
59
+ /**
60
+ * Object returned by `aes.factory()`.
61
+ * @typedef {object} AesAPI
62
+ * @property {AesKeyScheduler} fn Constant-time (masked-lookup) key scheduler — **default**.
63
+ * @property {{ fn: AesKeyScheduler }} ttable T-table key scheduler (fast, NOT constant-time, opt-in).
64
+ * @property {{ fn: AesKeyScheduler }} bitsliced Deprecated alias of `fn`.
65
+ */
66
+
67
+ export const aes = {
68
+ name: 'aes',
69
+ version: '1.0.0',
70
+ type: 'fw.crypto.cipher',
71
+ dependencies: [],
72
+
73
+ /** @returns {AesAPI} */
74
+ factory() {
75
+
76
+ const tables = [[[], [], [], [], []], [[], [], [], [], []]];
77
+
78
+ (function precompute() {
79
+ const encTable = tables[0];
80
+ const decTable = tables[1];
81
+ const sbox = encTable[4];
82
+ const sboxInv = decTable[4];
83
+ const d = [];
84
+ const th = [];
85
+ let x, xInv, x2, x4, x8, s, tEnc, tDec, i;
86
+
87
+ for (i = 0; i < 256; i++) {
88
+ th[(d[i] = i << 1 ^ (i >> 7) * 283) ^ i] = i;
89
+ }
90
+
91
+ for (x = xInv = 0; !sbox[x]; x ^= x2 || 1, xInv = th[xInv] || 1) {
92
+ s = xInv ^ xInv << 1 ^ xInv << 2 ^ xInv << 3 ^ xInv << 4;
93
+ s = s >> 8 ^ s & 255 ^ 99;
94
+ sbox[x] = s;
95
+ sboxInv[s] = x;
96
+
97
+ x8 = d[x4 = d[x2 = d[x]]];
98
+ tDec = x8 * 0x1010101 ^ x4 * 0x10001 ^ x2 * 0x101 ^ x * 0x1010100;
99
+ tEnc = d[s] * 0x101 ^ s * 0x1010100;
100
+
101
+ for (i = 0; i < 4; i++) {
102
+ encTable[i][x] = tEnc = tEnc << 24 ^ tEnc >>> 8;
103
+ decTable[i][s] = tDec = tDec << 24 ^ tDec >>> 8;
104
+ }
105
+ }
106
+
107
+ for (i = 0; i < 5; i++) {
108
+ encTable[i] = encTable[i].slice(0);
109
+ decTable[i] = decTable[i].slice(0);
110
+ }
111
+ })();
112
+
113
+ /**
114
+ * Single-block AES encrypt/decrypt (T-table path).
115
+ *
116
+ * ⚠️ NOT constant-time - see module-level cache-timing caveat. Callers
117
+ * MUST check for `false` (invalid block length) before using the
118
+ * result.
119
+ *
120
+ * @param {number[]} input 4 × 32-bit words (16 bytes).
121
+ * @param {0|1} dir 0 = encrypt, 1 = decrypt.
122
+ * @param {Array} keys [encKey, decKey] schedule pair.
123
+ * @param {Array} _tables Precomputed T-tables (encTable, decTable).
124
+ * @returns {number[]|false} 4-word block or `false` on bad input length.
125
+ */
126
+ function crypt(input, dir, keys, _tables) {
127
+ if (input.length !== 4) {
128
+ console.warn('[crypto] INVALID: aes: invalid block size');
129
+ return false;
130
+ }
131
+
132
+ const key = keys[dir];
133
+ let a = input[0] ^ key[0];
134
+ let b = input[dir ? 3 : 1] ^ key[1];
135
+ let c = input[2] ^ key[2];
136
+ let d = input[dir ? 1 : 3] ^ key[3];
137
+ let a2, b2, c2;
138
+
139
+ const nInnerRounds = key.length / 4 - 2;
140
+ let kIndex = 4;
141
+ const out = [0, 0, 0, 0];
142
+ const table = _tables[dir];
143
+
144
+ const t0 = table[0];
145
+ const t1 = table[1];
146
+ const t2 = table[2];
147
+ const t3 = table[3];
148
+ const sbox = table[4];
149
+
150
+ for (let i = 0; i < nInnerRounds; i++) {
151
+ a2 = t0[a >>> 24] ^ t1[b >> 16 & 255] ^ t2[c >> 8 & 255] ^ t3[d & 255] ^ key[kIndex];
152
+ b2 = t0[b >>> 24] ^ t1[c >> 16 & 255] ^ t2[d >> 8 & 255] ^ t3[a & 255] ^ key[kIndex + 1];
153
+ c2 = t0[c >>> 24] ^ t1[d >> 16 & 255] ^ t2[a >> 8 & 255] ^ t3[b & 255] ^ key[kIndex + 2];
154
+ d = t0[d >>> 24] ^ t1[a >> 16 & 255] ^ t2[b >> 8 & 255] ^ t3[c & 255] ^ key[kIndex + 3];
155
+ kIndex += 4;
156
+ a = a2;
157
+ b = b2;
158
+ c = c2;
159
+ }
160
+
161
+ for (let i = 0; i < 4; i++) {
162
+ out[dir ? 3 & -i : i] =
163
+ sbox[a >>> 24] << 24 ^
164
+ sbox[b >> 16 & 255] << 16 ^
165
+ sbox[c >> 8 & 255] << 8 ^
166
+ sbox[d & 255] ^
167
+ key[kIndex++];
168
+ a2 = a;
169
+ a = b;
170
+ b = c;
171
+ c = d;
172
+ d = a2;
173
+ }
174
+
175
+ return out;
176
+ }
177
+
178
+ // ── Constant-time S-box (Iteration F2 of the FIPS 140-3 upgrade plan) ──
179
+ //
180
+ // The opt-in `crypt` (T-table) path uses 5 T-tables (~5 KB) for
181
+ // SubBytes ∘ MixColumns. T-table lookups leak the AES state via
182
+ // cache-timing : an attacker observing cache-miss latencies can
183
+ // recover the key (cf. Bernstein 2005 « Cache-timing attacks on AES »).
184
+ //
185
+ // `_sboxCT(b, sbox)` performs a *constant-time* table read by scanning
186
+ // all 256 entries and masking them with `b == i ? 0xFF : 0x00`. The
187
+ // mask is derived without branching : `diff = i XOR b`, then
188
+ // `isZero = ((diff - 1) >>> 8) & 1` returns 1 iff `diff === 0`
189
+ // (since `diff ∈ [0, 255]` ; only `diff === 0` borrows into bit 8 of
190
+ // `diff - 1`). Yields a uniform memory access pattern independent of `b`.
191
+ //
192
+ // Cost : ~1024 ops per S-box (vs 1 T-table lookup) → AES-128 block ~50×
193
+ // slower, AES-256 block ~70× slower. Acceptable for opt-in use cases :
194
+ // long-lived secret keys in shared-cache environments (cloud VMs,
195
+ // serverless), low-volume cryptographic operations (key wrapping,
196
+ // signature scheme inner blocks). This is the **default** `aes.fn`
197
+ // path; the fast T-table path is opt-in via `aes.ttable.fn(key)`.
198
+ function _sboxCT(b, sbox) {
199
+ let result = 0;
200
+ const bx = b & 0xff;
201
+ for (let i = 0; i < 256; i++) {
202
+ // mask = 0xFF if i == bx, else 0x00 - branchless.
203
+ // ((diff - 1) >>> 8) & 1 == 1 iff diff == 0 (since diff in [0, 255]).
204
+ const diff = (i ^ bx) >>> 0;
205
+ const isZero = ((diff - 1) >>> 8) & 1;
206
+ const mask = (-isZero) & 0xff;
207
+ result |= sbox[i] & mask;
208
+ }
209
+ return result & 0xff;
210
+ }
211
+
212
+ // GF(2^8) multiplication-by-2 (xtime) - already constant-time
213
+ // (bitwise ops only ; `(b >> 7) * 283` produces 0 or 283 without
214
+ // branching since `b >> 7` is 0 or 1).
215
+ function _xtime(b) {
216
+ return ((b << 1) ^ ((b >> 7) * 0x1b)) & 0xff;
217
+ }
218
+
219
+ // MixColumns on a single column (4 bytes), constant-time.
220
+ function _mixColumnCT(c0, c1, c2, c3) {
221
+ const t = c0 ^ c1 ^ c2 ^ c3;
222
+ const r0 = c0 ^ t ^ _xtime(c0 ^ c1);
223
+ const r1 = c1 ^ t ^ _xtime(c1 ^ c2);
224
+ const r2 = c2 ^ t ^ _xtime(c2 ^ c3);
225
+ const r3 = c3 ^ t ^ _xtime(c3 ^ c0);
226
+ return [r0, r1, r2, r3];
227
+ }
228
+
229
+ // Inverse MixColumns column.
230
+ function _invMixColumnCT(c0, c1, c2, c3) {
231
+ // First apply Mixcolumns once, then forward MixColumns 3 more
232
+ // times - equivalent to the inverse via tower-field expansion :
233
+ // InvMixCol(c) = MixCol(c) ⊕ xtime²(c⊕c²) ⊕ xtime(...).
234
+ // We implement directly via the standard 0x0e/0x0b/0x0d/0x09 GF
235
+ // multiplications.
236
+ const m02 = _xtime;
237
+ const m04 = (b) => m02(m02(b));
238
+ const m08 = (b) => m02(m04(b));
239
+ const m09 = (b) => m08(b) ^ b;
240
+ const m0b = (b) => m08(b) ^ m02(b) ^ b;
241
+ const m0d = (b) => m08(b) ^ m04(b) ^ b;
242
+ const m0e = (b) => m08(b) ^ m04(b) ^ m02(b);
243
+ return [
244
+ (m0e(c0) ^ m0b(c1) ^ m0d(c2) ^ m09(c3)) & 0xff,
245
+ (m09(c0) ^ m0e(c1) ^ m0b(c2) ^ m0d(c3)) & 0xff,
246
+ (m0d(c0) ^ m09(c1) ^ m0e(c2) ^ m0b(c3)) & 0xff,
247
+ (m0b(c0) ^ m0d(c1) ^ m09(c2) ^ m0e(c3)) & 0xff,
248
+ ];
249
+ }
250
+
251
+ // Constant-time AES encrypt/decrypt over a 4-word (16-byte) block.
252
+ // Operates byte-per-byte through the standard FIPS 197 algorithm using
253
+ // `_sboxCT` for SubBytes ; ShiftRows is a permutation, MixColumns uses
254
+ // `_xtime` (branchless), AddRoundKey is XOR.
255
+ function _cryptCT(input, dir, keys) {
256
+ if (input.length !== 4) {
257
+ console.warn('[crypto] INVALID: aes: invalid block size');
258
+ return false;
259
+ }
260
+ const sbox = tables[0][4];
261
+ const sboxInv = tables[1][4];
262
+ const sb = dir ? sboxInv : sbox;
263
+ const enc = !dir;
264
+
265
+ // Unpack input (4 × 32-bit big-endian words) → 16 bytes (column-major).
266
+ // Per FIPS 197 §3.4 : state[i, j] = input[i + 4*j].
267
+ const state = new Uint8Array(16);
268
+ for (let j = 0; j < 4; j++) {
269
+ const w = input[j];
270
+ state[j * 4 ] = (w >>> 24) & 0xff;
271
+ state[j * 4 + 1] = (w >>> 16) & 0xff;
272
+ state[j * 4 + 2] = (w >>> 8) & 0xff;
273
+ state[j * 4 + 3] = w & 0xff;
274
+ }
275
+
276
+ // Build a byte-level **straight** FIPS 197 §5.3 key schedule from
277
+ // `keys[0]` (the encryption schedule). The decrypt path uses the
278
+ // standard straight-inverse algorithm (InvShiftRows / InvSubBytes
279
+ // / AddRoundKey / InvMixColumns) per FIPS 197 §5.3 - no need for
280
+ // the `decKey` pre-processed by InvMixColumns⁻¹ via T-tables.
281
+ // `dir` only branches encrypt vs decrypt (cf. `if (enc)`
282
+ // below) ; the same schedule is used for both.
283
+ const encWords = keys[0];
284
+ const Nr = encWords.length / 4 - 1; // 10/12/14 for AES-128/192/256
285
+ const ks = new Uint8Array(encWords.length * 4);
286
+ for (let i = 0; i < encWords.length; i++) {
287
+ ks[i * 4 ] = (encWords[i] >>> 24) & 0xff;
288
+ ks[i * 4 + 1] = (encWords[i] >>> 16) & 0xff;
289
+ ks[i * 4 + 2] = (encWords[i] >>> 8) & 0xff;
290
+ ks[i * 4 + 3] = encWords[i] & 0xff;
291
+ }
292
+
293
+ if (enc) {
294
+ // AddRoundKey(0)
295
+ for (let i = 0; i < 16; i++) state[i] ^= ks[i];
296
+ // Rounds 1..Nr-1
297
+ for (let r = 1; r < Nr; r++) {
298
+ // SubBytes
299
+ for (let i = 0; i < 16; i++) state[i] = _sboxCT(state[i], sb);
300
+ // ShiftRows : row k cyclic-shift by k positions.
301
+ const tmp = new Uint8Array(state);
302
+ for (let row = 0; row < 4; row++) {
303
+ for (let col = 0; col < 4; col++) {
304
+ state[col * 4 + row] = tmp[((col + row) & 3) * 4 + row];
305
+ }
306
+ }
307
+ // MixColumns
308
+ for (let col = 0; col < 4; col++) {
309
+ const o = col * 4;
310
+ const m = _mixColumnCT(state[o], state[o + 1], state[o + 2], state[o + 3]);
311
+ state[o ] = m[0];
312
+ state[o + 1] = m[1];
313
+ state[o + 2] = m[2];
314
+ state[o + 3] = m[3];
315
+ }
316
+ // AddRoundKey(r)
317
+ for (let i = 0; i < 16; i++) state[i] ^= ks[r * 16 + i];
318
+ }
319
+ // Final round (no MixColumns)
320
+ for (let i = 0; i < 16; i++) state[i] = _sboxCT(state[i], sb);
321
+ {
322
+ const tmp = new Uint8Array(state);
323
+ for (let row = 0; row < 4; row++) {
324
+ for (let col = 0; col < 4; col++) {
325
+ state[col * 4 + row] = tmp[((col + row) & 3) * 4 + row];
326
+ }
327
+ }
328
+ }
329
+ for (let i = 0; i < 16; i++) state[i] ^= ks[Nr * 16 + i];
330
+ } else {
331
+ // AddRoundKey(Nr)
332
+ for (let i = 0; i < 16; i++) state[i] ^= ks[Nr * 16 + i];
333
+ // Rounds Nr-1..1
334
+ for (let r = Nr - 1; r >= 1; r--) {
335
+ // InvShiftRows : row k cyclic-shift by -k positions.
336
+ const tmp = new Uint8Array(state);
337
+ for (let row = 0; row < 4; row++) {
338
+ for (let col = 0; col < 4; col++) {
339
+ state[col * 4 + row] = tmp[((col - row + 4) & 3) * 4 + row];
340
+ }
341
+ }
342
+ // InvSubBytes
343
+ for (let i = 0; i < 16; i++) state[i] = _sboxCT(state[i], sb);
344
+ // AddRoundKey(r)
345
+ for (let i = 0; i < 16; i++) state[i] ^= ks[r * 16 + i];
346
+ // InvMixColumns
347
+ for (let col = 0; col < 4; col++) {
348
+ const o = col * 4;
349
+ const m = _invMixColumnCT(state[o], state[o + 1], state[o + 2], state[o + 3]);
350
+ state[o ] = m[0];
351
+ state[o + 1] = m[1];
352
+ state[o + 2] = m[2];
353
+ state[o + 3] = m[3];
354
+ }
355
+ }
356
+ // Final inverse round (no InvMixColumns)
357
+ {
358
+ const tmp = new Uint8Array(state);
359
+ for (let row = 0; row < 4; row++) {
360
+ for (let col = 0; col < 4; col++) {
361
+ state[col * 4 + row] = tmp[((col - row + 4) & 3) * 4 + row];
362
+ }
363
+ }
364
+ }
365
+ for (let i = 0; i < 16; i++) state[i] = _sboxCT(state[i], sb);
366
+ for (let i = 0; i < 16; i++) state[i] ^= ks[i];
367
+ }
368
+
369
+ // Pack 16 bytes back to 4 × 32-bit words.
370
+ const out = [0, 0, 0, 0];
371
+ for (let j = 0; j < 4; j++) {
372
+ out[j] = (state[j * 4] << 24) | (state[j * 4 + 1] << 16) |
373
+ (state[j * 4 + 2] << 8) | state[j * 4 + 3];
374
+ }
375
+ return out;
376
+ }
377
+
378
+ const api = {};
379
+
380
+ /**
381
+ * Schedule an AES key — **constant-time default**.
382
+ *
383
+ * Block encrypt/decrypt are routed through `_cryptCT`, which performs
384
+ * SubBytes via a **masked-lookup** S-box (256 uniform reads per byte)
385
+ * instead of T-table indexed lookups. This neutralises Bernstein-style
386
+ * cache-timing leaks on the AES key, making this path secure by
387
+ * default in shared-cache environments (cloud VM, serverless,
388
+ * hyper-thread).
389
+ *
390
+ * Cost : ~50-100× slower than the opt-in `api.ttable.fn`. NOT a
391
+ * substitute for AES-NI (use WebCrypto when available - see
392
+ * aes.acvp.md F2). For high-throughput work on a trusted host, opt in
393
+ * to the fast T-table path via `api.ttable.fn`.
394
+ *
395
+ * The key schedule itself uses the T-table SubBytes during expansion :
396
+ * acceptable because key expansion runs once per session, not per
397
+ * block, so per-block cache-timing on the schedule is irrelevant.
398
+ *
399
+ * @param {Array} input_key 4/6/8 32-bit words (AES-128/192/256).
400
+ * @param {boolean} [full=true] If false, only the encryption schedule is built.
401
+ * @returns {{encrypt:Function, decrypt?:Function}|false}
402
+ */
403
+ api.fn = function (input_key, full = true) {
404
+ const keyLen = input_key.length;
405
+ if (keyLen !== 4 && keyLen !== 6 && keyLen !== 8) {
406
+ console.warn('[crypto] INVALID: aes: invalid key size');
407
+ return false;
408
+ }
409
+ // Build the standard FIPS 197 §5.2 key schedule. `_cryptCT`
410
+ // only reads `keys[0]` (straight encKey) - no `decKey`
411
+ // pre-processed by InvMixColumns⁻¹, so the inverse T-table
412
+ // step present in `api.ttable.fn` is not needed.
413
+ const sbox = tables[0][4];
414
+ const encKey = input_key.slice(0);
415
+ let rcon = 1, i, tmp;
416
+ for (i = keyLen; i < 4 * keyLen + 28; i++) {
417
+ tmp = encKey[i - 1];
418
+ if (i % keyLen === 0 || (keyLen === 8 && i % keyLen === 4)) {
419
+ tmp = sbox[tmp >>> 24] << 24 ^ sbox[tmp >> 16 & 255] << 16
420
+ ^ sbox[tmp >> 8 & 255] << 8 ^ sbox[tmp & 255];
421
+ if (i % keyLen === 0) {
422
+ tmp = tmp << 8 ^ tmp >>> 24 ^ rcon << 24;
423
+ rcon = rcon << 1 ^ (rcon >> 7) * 283;
424
+ }
425
+ }
426
+ encKey[i] = encKey[i - keyLen] ^ tmp;
427
+ }
428
+ const key = [encKey];
429
+ const ret = { encrypt(data) { return _cryptCT(data, 0, key); } };
430
+ if (full) ret.decrypt = (data) => _cryptCT(data, 1, key);
431
+ return ret;
432
+ };
433
+
434
+ /**
435
+ * Schedule an AES key — **opt-in fast T-table path**.
436
+ *
437
+ * ⚠️ NOT constant-time. Block ops are routed through `crypt(...)` with
438
+ * the precomputed 5 T-tables: one indexed lookup per SubBytes ∘
439
+ * MixColumns. T-table lookups leak the AES state via cache-timing
440
+ * (Bernstein 2005); use this only on a trusted, non-shared host or for
441
+ * bulk work where WebCrypto is unavailable. Output is byte-identical to
442
+ * `api.fn` on all vectors.
443
+ *
444
+ * @param {Array} input_key Key as 4, 6 or 8 32-bit words (AES-128/192/256).
445
+ * @param {boolean} [full=true] If false, only the encryption schedule is built.
446
+ * @returns {{encrypt:Function, decrypt?:Function}|false}
447
+ */
448
+ api.ttable = {
449
+ fn(input_key, full = true) {
450
+ const _tables = tables.slice();
451
+
452
+ const sbox = _tables[0][4];
453
+ const decTable = _tables[1];
454
+ const keyLen = input_key.length;
455
+ let rcon = 1;
456
+ let i, j, tmp;
457
+
458
+ if (keyLen !== 4 && keyLen !== 6 && keyLen !== 8) {
459
+ console.warn('[crypto] INVALID: aes: invalid key size');
460
+ return false;
461
+ }
462
+
463
+ const encKey = input_key.slice(0);
464
+ const decKey = [];
465
+ const key = [encKey, decKey];
466
+
467
+ for (i = keyLen; i < 4 * keyLen + 28; i++) {
468
+ tmp = encKey[i - 1];
469
+
470
+ if (i % keyLen === 0 || (keyLen === 8 && i % keyLen === 4)) {
471
+ tmp = sbox[tmp >>> 24] << 24 ^ sbox[tmp >> 16 & 255] << 16 ^ sbox[tmp >> 8 & 255] << 8 ^ sbox[tmp & 255];
472
+
473
+ if (i % keyLen === 0) {
474
+ tmp = tmp << 8 ^ tmp >>> 24 ^ rcon << 24;
475
+ rcon = rcon << 1 ^ (rcon >> 7) * 283;
476
+ }
477
+ }
478
+
479
+ encKey[i] = encKey[i - keyLen] ^ tmp;
480
+ }
481
+
482
+ if (full) {
483
+ for (j = 0; i; j++, i--) {
484
+ tmp = encKey[j & 3 ? i : i - 4];
485
+ if (i <= 4 || j < 4) {
486
+ decKey[j] = tmp;
487
+ } else {
488
+ decKey[j] = decTable[0][sbox[tmp >>> 24]] ^
489
+ decTable[1][sbox[tmp >> 16 & 255]] ^
490
+ decTable[2][sbox[tmp >> 8 & 255]] ^
491
+ decTable[3][sbox[tmp & 255]];
492
+ }
493
+ }
494
+ }
495
+
496
+ const ret = {
497
+ encrypt(data) { return crypt(data, 0, key, _tables); }
498
+ };
499
+ if (full) {
500
+ ret.decrypt = function (data) { return crypt(data, 1, key, _tables); };
501
+ }
502
+ return ret;
503
+ }
504
+ };
505
+
506
+ // Deprecated alias of `api.fn` (both are constant-time now). Kept one
507
+ // cycle for back-compat; prefer `aes.fn` directly.
508
+ api.bitsliced = { fn: api.fn };
509
+
510
+ return /** @type {AesAPI} */ (/** @type {any} */ (api));
511
+ }
512
+ };
@@ -0,0 +1,117 @@
1
+ # `chacha20.js` — RFC interop conformance
2
+
3
+ > **STATUS: RFC interop — outside NIST/CAVP validation.**
4
+ > ChaCha20 is not a FIPS 140-3 approved algorithm (NIST/SP 800-38
5
+ > covers only AES modes). Coverage exclusively RFC 8439
6
+ > (IETF) — no published NIST ACVP vector. ChaCha20 is nevertheless
7
+ > mandated by TLS 1.3 (RFC 8446 §B.4), QUIC (RFC 9001), Noise, WireGuard.
8
+
9
+ ## Standards
10
+
11
+ - **Primary**: **RFC 8439** — *ChaCha20 and Poly1305 for IETF
12
+ Protocols* (June 2018, obsoletes RFC 7539). §2.3 *ChaCha20 Block
13
+ Function*, §2.4 *ChaCha20 Encryption Algorithm*, §2.5 *Poly1305*
14
+ (covered separately by poly1305.js).
15
+ - **Origin**: Bernstein 2008 — *ChaCha, a variant of Salsa20*.
16
+ - **Implemented variant**: IETF ChaCha20 (256-bit key, 96-bit nonce,
17
+ 32-bit counter). Not the original Bernstein variant (64-bit nonce +
18
+ 64-bit counter) nor XChaCha20 (192-bit nonce).
19
+
20
+ ## Implemented algorithm
21
+
22
+ `chacha20.factory()` exposes the IETF ChaCha20 cipher (RFC 8439 §2.4).
23
+ Public API (`Uint8Array`):
24
+
25
+ - `xor(key, nonce, data, initialCounter = 0)` → `Uint8Array` of the same
26
+ length as `data`, or `false` if key ≠ 32 bytes or nonce ≠ 12 bytes.
27
+ Implements the stream involution (encrypt = decrypt).
28
+ - `_internal.block(key32, counter, nonce32, out32)` — exposed under the `_internal.*` convention (post-upgrade Finding 2 audit) for debug / introspection. Public tests exercise it indirectly via `xor(zero, …)`. Generates a
29
+ 64-byte block (16 u32 words) of keystream.
30
+
31
+ No `seek` variant; the initial counter is explicit (`initialCounter`
32
+ parameter).
33
+
34
+ ## Test coverage
35
+
36
+ ### Integrated official vectors
37
+
38
+ | Source | Reference | Test (`describe` / `test`) | Property verified |
39
+ |---|---|---|---|
40
+ | RFC 8439 §2.3.2 | block function | `§2.3.2 block keystream (counter=1)` | KAT 64-byte keystream byte-exact |
41
+ | RFC 8439 §2.4.2 | encryption "Sunscreen" | `§2.4.2 encrypt "Ladies and Gentlemen..."` | KAT byte-exact + round-trip decrypt |
42
+ | RFC 8439 §A.1.1 | block — zero key/nonce, counter=0 | `§A.1.1 zero key, zero nonce, counter=0` | KAT |
43
+ | RFC 8439 §A.1.2 | block — zero key/nonce, counter=1 | `§A.1.2 zero key, zero nonce, counter=1` | KAT |
44
+ | RFC 8439 §A.1.3 | block — key=0..01, counter=1 | `§A.1.3 key=0..00 01, zero nonce, counter=1` | KAT |
45
+ | RFC 8439 §A.1.4 | block — key=00ff.., counter=2 | `§A.1.4 key=00ff..00, zero nonce, counter=2` | KAT |
46
+ | RFC 8439 §A.1.5 | block — nonce=0..02, counter=0 | `§A.1.5 zero key, nonce=0..02, counter=0` | KAT |
47
+ | RFC 8439 §A.2.1 | encrypt 64 zero bytes | `§A.2.1 encrypt 64 zero bytes` | KAT |
48
+ | RFC 8439 §A.2.2 | encrypt "Any submission..." (375 bytes) | `§A.2.2 encrypt "Any submission..."` | KAT multi-block |
49
+ | RFC 8439 §A.2.3 | encrypt "'Twas brillig..." (counter=42) | `§A.2.3 encrypt long para` | KAT non-trivial counter |
50
+ | Stress | counter advance vs concat | `multi-block encryption equals concatenation of single blocks` | stream/block equivalence |
51
+ | Stress | involution | `keystream is involution` | xor(xor(pt))=pt over 513 bytes |
52
+ | Pre-existing | reject key size | `rejects non-32-byte key` | `false` |
53
+ | Pre-existing | reject nonce size | `rejects non-12-byte nonce` | `false` |
54
+ | Added | empty plaintext | `accepts empty plaintext` | zero-length output |
55
+
56
+ ### Security properties tested
57
+
58
+ - [x] **RFC 8439 conformance** — 9 byte-exact KAT vectors (1× §2.3.2,
59
+ 1× §2.4.2, 5× §A.1, 3× §A.2). Covers keystream, encryption,
60
+ counters 0/1/2/42, variable nonces.
61
+ - [x] **Multi-block** — RFC 8439 §A.2.2 encrypts 375 bytes (6 full
62
+ blocks + 1 partial); cross-check `multi-block == concat(single-block)`.
63
+ - [x] **Involution** — `xor(xor(pt))=pt` over 513 bytes (8 blocks + 1).
64
+ - [x] **32-bit counter** — covered by §A.2.3 (explicit counter=42)
65
+ + counter-advance cross-check.
66
+ - [x] **key/nonce length validation** — early return false; negative
67
+ tests.
68
+ - [x] **Empty input** — empty output (stream cipher edge case).
69
+ - [x] **No `throw`** — `console.warn` + `return false` (reviewed
70
+ lines 61-69).
71
+ - [x] **XChaCha20 (192-bit nonce)** — **Iteration G3**: `xchacha20()`
72
+ exposed but returns `false` + `console.warn('NOT-IMPLEMENTED: XChaCha20
73
+ (draft-irtf-cfrg-xchacha)')`. Prevents silent use; callers must
74
+ go through a dedicated implementation (e.g. libsodium-wasm) if needed.
75
+ - [x] **32-bit counter overflow guard** — **Iteration G3**: `xor()` rejects
76
+ any call that would push the counter ≥ 2^32 under a (key, nonce)
77
+ pair → `false` + `console.warn('LIMIT-EXCEEDED: counter overflow (>256 GiB)')`.
78
+ Prevents silent counter wraparound (which would reuse keystream
79
+ blocks → catastrophic).
80
+ - [ ] **Original Bernstein ChaCha20 (64-bit nonce + 64-bit counter)** —
81
+ not implemented. **P3** — IETF retains the 96/32 variant.
82
+ - [ ] **Strict constant-time** — `_qr`, `_block` operate only on
83
+ u32 words (rotations, XOR, modular additions). No data-dependent
84
+ branch in the hot path. ✅ implicit by construction
85
+ (algorithm design).
86
+
87
+ ## FIPS 140-3 conformance
88
+
89
+ | Requirement | Status | Evidence |
90
+ |---|---|---|
91
+ | NIST-approved algorithm | ❌ N/A | ChaCha20 outside SP 800-38 |
92
+ | RFC 8439 conformance | ✅ | 9 byte-exact KAT vectors |
93
+ | Multi-block + counter | ✅ | §A.2.2 (375 bytes) + §A.2.3 (counter=42) |
94
+ | Stream involution | ✅ | xor(xor(pt))=pt verified |
95
+ | Parameter validation | ✅ | early return false |
96
+ | No `throw` | ✅ | `console.warn` + return false |
97
+
98
+ ## Known limitations
99
+
100
+ - **Outside NIST scope** — no ACVP vector. Validation = RFC 8439.
101
+ - **No XChaCha20 or original-Bernstein variants**: see P3
102
+ above.
103
+ - **32-bit counter → 256 GiB / (key, nonce) limit**: documented in
104
+ RFC 8439 §2.4; no runtime protection against wraparound (caller's
105
+ or the chacha20poly1305 AEAD wrapper's responsibility).
106
+ - **No SIMD**: scalar JS implementation; adequate performance for
107
+ application-level protocols, suboptimal for massive throughput (TLS
108
+ bulk).
109
+
110
+ ## Cross-references
111
+
112
+ - Module: [`cipher/chacha20.js`](./chacha20.js)
113
+ - Tests: [`cipher/chacha20.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/cipher/chacha20.test.js) — **20 tests** (including the 4 added in Iteration G3: counter overflow guard + XChaCha20 reject)
114
+ - RFC 8439: [`https://datatracker.ietf.org/doc/html/rfc8439`](https://datatracker.ietf.org/doc/html/rfc8439)
115
+ - AEAD wrapper: [`../mode/chacha20poly1305.js`](../mode/chacha20poly1305.js) — see [chacha20poly1305.acvp.md](../mode/chacha20poly1305.acvp.md) (forthcoming)
116
+ - Tag MAC: [`../hash/poly1305.js`](../hash/poly1305.js) — see [poly1305.acvp.md](../hash/poly1305.acvp.md) (forthcoming)
117
+ - Overall conformance: [`../NIST_CONFORMANCE.md`](../NIST_CONFORMANCE.md)