@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,91 @@
1
+ ---
2
+ module: ecc
3
+ category: crypto/pkc
4
+ dependencies: [bitArray, hex, bn, sha256, sha384, sha512, hmac]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # ecc
11
+
12
+ > ECDSA (FIPS 186-5 §6) on P-{224,256,384,521} + K-curves. RFC 6979 deterministic by default.
13
+
14
+ **Module** `ecc` | **Source** `packages/front/fw/src/crypto/pkc/ecc.js` | **Deps** `bitArray`, `hex`, `bn`, `sha256`, `sha384`, `sha512`, `hmac` | **Worker-safe** yes
15
+
16
+ FIPS 186-5 + RFC 6979 compliant ECDSA (deterministic k via HMAC-DRBG, eliminates leakage from a biased random k). Subgroup check `n·Q == O` active on all `deserialize` calls.
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const ecc = runtime.resolve('ecc');
22
+ // Returns: { curves, publicKey, secretKey, sign, verify, deserialize, _internal }
23
+ ```
24
+
25
+ ## API
26
+
27
+ | Method | Signature | Returns |
28
+ |--------|-----------|---------|
29
+ | `curves` | `{c192, c224, c256, c384, c521, k192, k224, k256, k283, k409, k571}` | Available curves |
30
+ | `secretKey(curve, exponent)` | — | `{exponent, publicKey, sign, verify}` |
31
+ | `publicKey(curve, point)` | — | `{point, verify}` |
32
+ | `sign(hash, opts?)` | `(bitArray, {strict?, hashForK?, deterministic?}) => Object` | `{r, s}` (deterministic by default) |
33
+ | `verify(hash, rs, opts?)` | `(bitArray, {r,s}, {strict?, fakeLegacyVersion?}) => boolean` | Constant-time |
34
+ | `deserialize(bits, curveName)` | — | Public key (subgroup-checked) |
35
+
36
+ ### Options
37
+
38
+ - **`strict: true`** (sign / verify): canonicalises low-s + rejects `s > n/2` (SP 800-131A "NIST strict").
39
+ - **`hashForK: hashMod`** (sign): explicitly sets the hash for K derivation (RFC 6979 strict: H_K = H_msg).
40
+ - **`deterministic: false`** (sign): reverts to random k (NOT RECOMMENDED).
41
+
42
+ ## Examples
43
+
44
+ ### Sign + verify P-256 / SHA-256
45
+
46
+ ```js
47
+ const { ecc, sha256 } = fw.runtime.resolveAll(['ecc', 'sha256']);
48
+
49
+ const sk = ecc.secretKey(ecc.curves.c256);
50
+ const pk = sk.publicKey;
51
+
52
+ const hashBa = sha256.hash('message');
53
+ const sig = sk.sign(hashBa); // deterministic RFC 6979
54
+ const ok = pk.verify(hashBa, sig); // true
55
+
56
+ // Strict mode (low-s)
57
+ const sigStrict = sk.sign(hashBa, { strict: true });
58
+ const okStrict = pk.verify(hashBa, sigStrict, { strict: true });
59
+ ```
60
+
61
+ ### Subgroup check (deserialize)
62
+
63
+ ```js
64
+ const pkPoint = ecc.deserialize(rawBytes, 'c256'); // false if point is outside the subgroup
65
+ ```
66
+
67
+ ## Worker Usage
68
+
69
+ ```js
70
+ const worker = fw.createWorker(
71
+ function ({ libs, args }) {
72
+ const sk = libs.ecc.secretKey(libs.ecc.curves.c256, args[0]);
73
+ self.postMessage(sk.sign(args[1]));
74
+ },
75
+ { dependencies: ['ecc'], args: [exponent, hashBa] }
76
+ );
77
+ ```
78
+
79
+ ## Notes
80
+
81
+ - **Deterministic k RFC 6979**: by default, eliminates any risk of leakage from a reused or biased k.
82
+ - **Scalar mult NOT constant-time**: 4-bit windowed method with pre-computed multiple table — the index is the scalar nibble, observable via cache-timing (Bernstein 2005). Acceptable in a browser without a co-resident adversary; for multi-tenant servers prefer WebCrypto `subtle.*` or X25519/Ed25519.
83
+ - **Subgroup check FIPS 186-5 §A.4.2**: `deserialize` rejects points outside the subgroup of order `n` (~1-3 ms per P-256).
84
+ - **P-521 RFC 6979** byte-exact (fixes the `bn.bitLength() = 528` rounding bug via the `_trueBitLength` helper).
85
+ - **K-curves (Koblitz)**: covered (k192, k224, k256, k283, k409, k571) but deprecated by NIST SP 800-186 — prefer P-curves.
86
+
87
+ ## See also
88
+
89
+ - [bn](../utils/bn.md), [hmac](../hash/hmac.md) — underlying primitives
90
+ - [ed25519](./ed25519.md) — faster EdDSA alternative
91
+ - [Conformance ecc.acvp.md](../../../../src/crypto/pkc/ecc.acvp.md)
@@ -0,0 +1,99 @@
1
+ ---
2
+ module: ed25519
3
+ category: crypto/pkc
4
+ dependencies: [sha512, bitArray]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # ed25519
11
+
12
+ > Ed25519 (RFC 8032 / FIPS 186-5 §7.6) — EdDSA pure + ph (preHash) + ctx (context).
13
+
14
+ **Module** `ed25519` | **Source** `packages/front/fw/src/crypto/pkc/ed25519.js` | **Deps** `sha512`, `bitArray` | **Worker-safe** yes
15
+
16
+ EdDSA over Curve25519 (cofactor 8). Faster than ECDSA, deterministic by construction (no RNG required to sign). Ed448 explicit reject (FIPS 186-5 §7.7 out of scope).
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const ed25519 = runtime.resolve('ed25519');
22
+ // Returns: { keyPair, sign, verify, signPh, verifyPh, signCtx, verifyCtx, ed448 }
23
+ ```
24
+
25
+ ## API
26
+
27
+ | Method | Signature | Returns |
28
+ |--------|-----------|---------|
29
+ | `keyPair(seed)` | `(Uint8Array(32)) => {publicKey, privateKey} \| false` | Derives the pair from the seed; `false` if seed absent or ≠ 32 bytes |
30
+ | `sign(privateKey, msg)` | `(Uint8Array(64), Uint8Array) => Uint8Array(64) \| false` | Pure Ed25519 signature (`privateKey` = seed ‖ pubKey, 64 bytes) |
31
+ | `verify(publicKey, msg, sig)` | `(Uint8Array(32), Uint8Array, Uint8Array(64)) => boolean` | Verifies + rejects s≥L constant-time |
32
+ | `signPh(privateKey, msg, ctx?)` | `(Uint8Array(64), Uint8Array, Uint8Array?) => Uint8Array(64) \| false` | Ed25519ph — pass the **raw message** (SHA-512 applied internally) |
33
+ | `verifyPh(publicKey, msg, sig, ctx?)` | — | `boolean` |
34
+ | `signCtx(privateKey, msg, ctx)` | `(Uint8Array(64), Uint8Array, Uint8Array(1..255)) => Uint8Array(64) \| false` | Ed25519ctx (context required, 1..255 bytes) |
35
+ | `verifyCtx(publicKey, msg, sig, ctx)` | — | `boolean` |
36
+ | `ed448.{keyPair,sign,verify,signPh,verifyPh}` | `() => false` | **NOT-IMPLEMENTED** explicit reject |
37
+
38
+ ## Examples
39
+
40
+ ### Pure EdDSA
41
+
42
+ ```js
43
+ const { ed25519, random } = fw.runtime.resolveAll(['ed25519', 'random']);
44
+ const { privateKey, publicKey } = ed25519.keyPair(random.bytes(32));
45
+
46
+ const msg = new TextEncoder().encode('Hello, EdDSA!');
47
+ const sig = ed25519.sign(privateKey, msg);
48
+ const ok = ed25519.verify(publicKey, msg, sig); // true
49
+ ```
50
+
51
+ ### Ed25519ph (prehash + dom2)
52
+
53
+ ```js
54
+ // signPh takes the raw message — SHA-512 is applied internally
55
+ const sig = ed25519.signPh(privateKey, msg);
56
+ const ok = ed25519.verifyPh(publicKey, msg, sig);
57
+ ```
58
+
59
+ ### Ed25519ctx (context separation)
60
+
61
+ ```js
62
+ const ctx = new TextEncoder().encode('app-v1'); // 1..255 bytes required
63
+ const sig = ed25519.signCtx(privateKey, msg, ctx);
64
+ const ok = ed25519.verifyCtx(publicKey, msg, sig, ctx);
65
+ const bad = ed25519.verifyCtx(publicKey, msg, sig, otherCtx); // false
66
+ ```
67
+
68
+ ### Ed448 rejected
69
+
70
+ ```js
71
+ ed25519.ed448.keyPair(); // false + console.warn('NOT-IMPLEMENTED: ed25519: Ed448 ...')
72
+ ```
73
+
74
+ ## Worker Usage
75
+
76
+ ```js
77
+ const worker = fw.createWorker(
78
+ function ({ libs, args }) {
79
+ const sig = libs.ed25519.sign(args[0], args[1]);
80
+ self.postMessage(sig);
81
+ },
82
+ { dependencies: ['ed25519'], args: [privateKey, msg] }
83
+ );
84
+ ```
85
+
86
+ ## Notes
87
+
88
+ - **Deterministic**: `sign(sk, msg)` does NOT consume any RNG (k derived from sk + msg via SHA-512). Byte-exact reproducible.
89
+ - **s < L check**: `verify` rejects signatures where `s ≥ L` (constant-time, RFC 8032 §5.1.7 step 2) — prevents malleability (s + k·L would otherwise be valid).
90
+ - **`keyPair(seed)` — seed required**: `keyPair()` without argument returns `false` + warn. Use `random.bytes(32)` for generation.
91
+ - **Ed25519ph**: pass the **raw message** — `signPh` applies SHA-512 internally. Do not pre-hash before the call.
92
+ - **Ed448 not implemented** — edwards448 curve + SHAKE-256; create a separate `ed448.js` module if required for CMVP.
93
+
94
+ ## See also
95
+
96
+ - [sha512](../hash/sha512.md) — mandatory Ed25519 primitive
97
+ - [x25519](./x25519.md) — companion DH (same curve)
98
+ - [ecc](./ecc.md) — alternative ECDSA
99
+ - [Conformance ed25519.acvp.md](../../../../src/crypto/pkc/ed25519.acvp.md)
@@ -0,0 +1,178 @@
1
+ ---
2
+ module: hybridKem
3
+ category: crypto/pkc
4
+ dependencies: [x25519, ml_kem, sha3]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # hybridKem
11
+
12
+ > X-Wing hybrid KEM — X25519 + ML-KEM-768, IETF KAT-verified (draft rev -06).
13
+
14
+ **Module** `hybridKem` | **Source** `packages/front/fw/src/crypto/pkc/hybridKem.js` | **Deps** `x25519`, `ml_kem`, `sha3` | **Worker-safe** yes
15
+
16
+ X-Wing is a general-purpose **hybrid** Key Encapsulation Mechanism combining the
17
+ classical X25519 Diffie–Hellman KEM with the NIST post-quantum KEM ML-KEM-768, so
18
+ that the shared secret stays secure as long as **either** component resists
19
+ attack (harvest-now-decrypt-later hedge). It is a pure composition over the vetted
20
+ fw primitives [`x25519`](./x25519.md), [`ml_kem`](./ml_kem.md) and
21
+ [`sha3`](../hash/sha3.md) — no novel cryptography.
22
+
23
+ ## Resolve
24
+
25
+ ```js
26
+ const hybridKem = runtime.resolve('hybridKem');
27
+ // Returns: { xwing }
28
+ ```
29
+
30
+ Direct ESM (a ready-to-use `xwing` over default fw primitives, lazily wired):
31
+
32
+ ```js
33
+ import { xwing } from '@awacloud/fw/crypto/pkc/hybridKem.js';
34
+ ```
35
+
36
+ ## Construction (FROZEN)
37
+
38
+ X-Wing per `draft-connolly-cfrg-xwing-kem` **revision -06** (CFRG) — the revision
39
+ whose Appendix C KAT the in-repo libsodium reference
40
+ (`references/CRYPTO-SRC/libsodium/test/default/kem_xwing.c`, tv0..tv2) encodes.
41
+
42
+ - **Combiner** (draft §5.3, fixed-label variant):
43
+ `ss = SHA3-256( ss_ML-KEM || ss_X25519 || ct_X25519 || pk_X25519 || label )`,
44
+ `label = 5c 2e 2f 2f 5e 5c` (ASCII `\.//^\`). The fixed label pins the scheme
45
+ and binds `ct_X25519 || pk_X25519`, so a component key cannot be reused in
46
+ another combiner without changing the label domain.
47
+ - **Key derivation** (draft §5.1): the secret key is a **32-byte seed**;
48
+ `expanded = SHAKE256(seed, 96)` splits into `mlkem_seed = expanded[0..64)`
49
+ (`d || z` for ML-KEM keygen) and `sk_X25519 = expanded[64..96)`.
50
+
51
+ ## Key encoding
52
+
53
+ Fixed-length concatenation — component sizes **are** the scheme identifier, so no
54
+ length prefix is used.
55
+
56
+ | Artefact | Encoding | Size |
57
+ |----------|----------|------|
58
+ | `pk` | `pk_ML-KEM(1184) \| pk_X25519(32)` | 1216 B |
59
+ | `sk` | the X-Wing seed (expand-on-use) | 32 B |
60
+ | `ct` | `ct_ML-KEM(1088) \| ct_X25519(32)` | 1120 B |
61
+ | `ss` | shared secret | 32 B |
62
+
63
+ ## API
64
+
65
+ `xwing` — the single X-Wing hybrid KEM instance.
66
+
67
+ | Method | Signature | Returns |
68
+ |--------|-----------|---------|
69
+ | `xwing.lengths` | `{ pk: 1216, sk: 32, ct: 1120, ss: 32 }` | Byte sizes |
70
+ | `xwing.keygen(seed?)` | `(Uint8Array(32)?) => {publicKey, secretKey} \| false` | Keypair; deterministic for a 32-byte seed, random otherwise |
71
+ | `xwing.encapsulate(publicKey, rnd?)` | `(Uint8Array(1216), Uint8Array(64)?) => {cipherText, sharedSecret} \| false` | Encapsulate; `rnd = msg32 \| eskX32`, deterministic when supplied |
72
+ | `xwing.decapsulate(cipherText, secretKey)` | `(Uint8Array(1120), Uint8Array(32)) => Uint8Array(32) \| false` | Shared secret; implicit-reject on a tampered ct, `false` on malformed length |
73
+
74
+ Returns `Uint8Array` everywhere; `false` on invalid input (fw crypto idiom).
75
+
76
+ ## Examples
77
+
78
+ ### KEM end-to-end
79
+
80
+ ```js
81
+ const hybridKem = runtime.resolve('hybridKem');
82
+ const { xwing } = hybridKem;
83
+
84
+ // Receiver
85
+ const { publicKey, secretKey } = xwing.keygen();
86
+
87
+ // Sender (receives publicKey)
88
+ const { cipherText, sharedSecret } = xwing.encapsulate(publicKey);
89
+
90
+ // Receiver (receives cipherText)
91
+ const sharedSecret2 = xwing.decapsulate(cipherText, secretKey);
92
+ // sharedSecret === sharedSecret2 (32 bytes)
93
+ ```
94
+
95
+ ### Deterministic (KAT) form
96
+
97
+ ```js
98
+ import { xwing } from '@awacloud/fw/crypto/pkc/hybridKem.js';
99
+
100
+ const { publicKey, secretKey } = xwing.keygen(seed32); // fixed 32-byte seed
101
+ const { cipherText, sharedSecret } = xwing.encapsulate(publicKey, rnd64); // msg32||eskX32
102
+ ```
103
+
104
+ ## Worker Usage
105
+
106
+ The descriptor factory is a self-contained pure composition (concat +
107
+ SHAKE256/SHA3-256 KDF), so the whole hybrid operation runs inside one Worker call
108
+ with no main-thread round-trips.
109
+
110
+ ```js
111
+ const worker = fw.createWorker(['hybridKem']);
112
+ const kp = await worker.call('hybridKem.xwing.keygen');
113
+ ```
114
+
115
+ ## Constant-time & zeroization posture (honest)
116
+
117
+ - **Timing is NOT a security boundary.** The X25519 ladder and ML-KEM FO selection
118
+ are written branch-lean, but browser JS/WASM cannot guarantee constant time (JIT,
119
+ GC, no `mlock`). Do not rely on this module for side-channel resistance.
120
+ - **Zeroization is best-effort only, never a guarantee.** Transient key expansions
121
+ and component secrets are `.fill(0)`'d after use, but the runtime may retain GC
122
+ copies or JIT-resident intermediates. Treat at-rest secret handling as the
123
+ caller's responsibility.
124
+
125
+ ## Positioning & liability
126
+
127
+ awa ships X-Wing as a **certifiable cryptographic component**, not a certified
128
+ product: no ANSSI/FIPS certification of the composite scheme is claimed here. The
129
+ underlying ML-KEM-768 is ACVP-green (`src/crypto/pkc/ml_kem.acvp.md`); X25519 is
130
+ RFC 7748 vector-green. Correctness is anchored to the **official IETF X-Wing KAT**
131
+ (tv0..tv2, full 32-byte shared-secret match), not merely a self-consistent
132
+ round-trip. Rejected-but-noted alternatives (X25519MLKEM768 TLS-concat combiner;
133
+ generic HKDF `Z||T` combiner) are intentionally NOT shipped — X-Wing's fixed label
134
+ is the safer general-purpose default.
135
+
136
+ ## Evidence & vectors
137
+
138
+ Correctness is anchored to the **official IETF X-Wing KAT** and locked by a
139
+ deterministic, network-free regeneration proof.
140
+
141
+ | Vector set | Id | Source | What it proves |
142
+ |---|---|---|---|
143
+ | X-Wing IETF KAT | `tv0..tv2` | `src/crypto/pkc/__fixtures__/xwing-ietf-kat.js` (test fixture — repository only, not shipped) — `draft-connolly-cfrg-xwing-kem` rev -06 App. C | Full 32-byte `ss` byte-match + `ek`/`ct` prefixes (not a mere round-trip) |
144
+
145
+ - **Regeneration proof** — `bun packages/front/fw/tools/hybrid-kat-regen.js`
146
+ recomputes `ekPrefix` / `ctPrefix` / full `ss` for tv0..tv2 from the published
147
+ `seed` + `randomness` through the frozen `xwing`, and asserts byte-identity
148
+ (exit 0/1). Wired as a test in
149
+ [`hybrid-kat-regen.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/hybrid-kat-regen.test.js)
150
+ so CI exercises it every run.
151
+ - **Provenance** — per-file source / revision / SHA-256 in
152
+ [`hybrid-kat.provenance.md`](../../../../src/crypto/pkc/hybrid-kat.provenance.md).
153
+
154
+ ### Coverage gaps
155
+
156
+ - **Covered**: X-Wing tv0..tv2 full shared-secret KAT; implicit-reject on a
157
+ tampered ciphertext; malformed-length rejection. The underlying **ML-KEM-768**
158
+ is ACVP-green ([`ml_kem.acvp.md`](../../../../src/crypto/pkc/ml_kem.acvp.md)) and **X25519** is RFC 7748
159
+ vector-green — those greens are **cited, not re-run** here.
160
+ - **Not covered**: there is **no ACVP / CAVP program for X-Wing** (it is a
161
+ draft-stage composite KEM, not a NIST-approved algorithm), so no certified
162
+ test harness exists for the composite; the KAT above is the authoritative
163
+ oracle. Side-channel / constant-time behaviour is out of scope (see below).
164
+
165
+ ## Notes
166
+
167
+ - Pinned draft revision **-06**; a future draft that changes the combiner, label,
168
+ or key derivation breaks interop — re-pin and re-verify against fresh vectors.
169
+ - Deterministic for fixed inputs (32-byte seed, 64-byte encaps randomness), which
170
+ is exactly what the KAT exercises; production callers omit them to draw the
171
+ platform CSPRNG.
172
+
173
+ ## See also
174
+
175
+ - [`ml_kem`](./ml_kem.md) — the post-quantum KEM leg (ML-KEM-768).
176
+ - [`x25519`](./x25519.md) — the classical Diffie–Hellman leg.
177
+ - [`hybridSign`](./hybridSign.md) — companion composite-signature hybrid (shares
178
+ the positioning & zeroization posture).
@@ -0,0 +1,192 @@
1
+ ---
2
+ module: hybridSign
3
+ category: crypto/pkc
4
+ dependencies: [ml_dsa, ed25519, ecc, sha512, sha256, random, utf8]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # hybridSign
11
+
12
+ > Composite PQ/T signatures (LAMPS draft) — ML-DSA-65 ∧ Ed25519 / ECDSA-P-256, AND-verify.
13
+
14
+ **Module** `hybridSign` | **Source** `packages/front/fw/src/crypto/pkc/hybridSign.js` | **Deps** `ml_dsa`, `ed25519`, `ecc`, `sha512`, `sha256`, `random`, `utf8` | **Worker-safe** yes
15
+
16
+ Composes vetted fw primitives into `draft-ietf-lamps-pq-composite-sigs` composite signatures — no novel cryptography. Both components sign one representative `M'`; verify is the logical AND of both, so no component can be stripped or downgraded.
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const hybridSign = runtime.resolve('hybridSign');
22
+ // Returns: { mldsa65_ed25519, mldsa65_ecdsaP256, _internal }
23
+ ```
24
+
25
+ ## Construction (frozen, vector-verified)
26
+
27
+ ```
28
+ M' = Prefix || Label || len(ctx) || ctx || SHA-512(M) [draft §5.3]
29
+ Prefix = ASCII "CompositeAlgorithmSignatures2025" (32 B) [draft §5.2]
30
+ Label = the per-variant ASCII label (see table) [draft §11]
31
+ len(ctx) = 1 byte (ctx is 0..255 bytes; default empty)
32
+
33
+ sig_ML-DSA = ML-DSA-65.Sign(M', mldsa_ctx = Label) (FIPS 204 Alg 2)
34
+ sig_trad = Ed25519.Sign(M') (its own ctx unused)
35
+ | ECDSA-P256.Sign(SHA-256(M')) (DER-encoded r,s)
36
+ verify = ML-DSA verify AND trad verify over the reconstructed M'
37
+ ```
38
+
39
+ The current draft has **no** per-signature randomizer `r` and uses an ASCII
40
+ `Label` (not a DER-OID Domain). This exact wiring reproduces the official LAMPS
41
+ interop vectors.
42
+
43
+ ## Variants
44
+
45
+ | Variant | OID | Label (ASCII) | Composite pk | Composite sig |
46
+ |---------|-----|---------------|--------------|---------------|
47
+ | `mldsa65_ed25519` | `1.3.6.1.5.5.7.6.48` | `COMPSIG-MLDSA65-Ed25519-SHA512` | 1952 + 32 B | 3309 + 64 = 3373 B |
48
+ | `mldsa65_ecdsaP256` | `1.3.6.1.5.5.7.6.45` | `COMPSIG-MLDSA65-ECDSA-P256-SHA512` | 1952 + 65 B | 3309 + DER (variable) |
49
+
50
+ ## API
51
+
52
+ | Method | Signature | Returns |
53
+ |--------|-----------|---------|
54
+ | `<variant>.lengths` | object | Component + container byte lengths |
55
+ | `<variant>.keygen()` | `() => {publicKey, secretKey}` | TLV-encoded key pair (independent seeds) |
56
+ | `<variant>.sign(sk, msg, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array?) => Uint8Array \| false` | Composite signature |
57
+ | `<variant>.verify(pk, msg, sig, ctx?)` | `(Uint8Array, Uint8Array, Uint8Array, Uint8Array?) => boolean` | AND of both components |
58
+
59
+ Inputs/outputs are `Uint8Array`; any invalid input returns `false` (sign) or
60
+ `false` (verify). `ctx` is an optional 0..255-byte application context bound
61
+ into `M'`.
62
+
63
+ ## Encoding
64
+
65
+ - **Public / secret keys** use a length-prefixed TLV container
66
+ `schemeId(1) || u16(len) || component …` so a parser cannot be tricked into
67
+ re-slicing composite bytes (guards component-splicing). `schemeId` = `0x01`
68
+ (Ed25519) / `0x02` (ECDSA-P256); a wrong id, truncation, or trailing byte is
69
+ rejected.
70
+ - **Ed25519 signature** is fixed slices `mldsaSig(3309) || edSig(64)` — identical
71
+ to the official wire form (no randomizer).
72
+ - **ECDSA-P256 signature** length-prefixes its variable DER component:
73
+ `mldsaSig(3309) || u16(derLen) || DER`.
74
+
75
+ The official LAMPS vectors use a plain component concat; the vendored conformance
76
+ tests re-frame the exact official component bytes into this container and verify
77
+ through the real `verify()` path.
78
+
79
+ ## Examples
80
+
81
+ ```js
82
+ const hybridSign = runtime.resolve('hybridSign');
83
+ const v = hybridSign.mldsa65_ed25519;
84
+
85
+ const { publicKey, secretKey } = v.keygen();
86
+ const msg = new TextEncoder().encode('hello');
87
+ const sig = v.sign(secretKey, msg);
88
+ v.verify(publicKey, msg, sig); // true
89
+
90
+ // bind an application context
91
+ const ctx = new TextEncoder().encode('app:v1');
92
+ const sigCtx = v.sign(secretKey, msg, ctx);
93
+ v.verify(publicKey, msg, sigCtx, ctx); // true
94
+ v.verify(publicKey, msg, sigCtx); // false — ctx mismatch
95
+ ```
96
+
97
+ ## Worker Usage
98
+
99
+ The whole composite operation is pure composition (SHA-512 pre-hash, component
100
+ sign/verify, AND) and runs in a single Worker call; the PQ primitive loads as it
101
+ does on the main thread.
102
+
103
+ ```js
104
+ const worker = fw.createWorker(['hybridSign']);
105
+ const sig = await worker.call('hybridSign', 'mldsa65_ecdsaP256', 'sign', [sk, msg]);
106
+ ```
107
+
108
+ ## §6 — Constant-time posture (honest)
109
+
110
+ - Browser JS/WASM **cannot guarantee constant-time**: JIT, GC, and the absence of
111
+ `mlock` mean timing is **not a security boundary**. Treat it as best-effort.
112
+ - The fw `ecc` P-256 scalar path is a 4-bit windowed method (cache-timing
113
+ sensitive on a co-resident adversary). ML-DSA and Ed25519 are written
114
+ branch-lean but are still pure-JS. For adversarial co-tenancy prefer a
115
+ platform constant-time backend.
116
+ - **Zeroization is best-effort only.** `keygen()` `.fill(0)`s transient seeds and
117
+ intermediate scalars, but JS cannot guarantee a wipe (GC copies, JIT-resident
118
+ values). Never rely on it as a security guarantee.
119
+
120
+ ## §9 — Limits & non-claims
121
+
122
+ - **Not FIPS-validated as a composite.** The underlying ML-DSA / Ed25519 / ECDSA
123
+ primitives carry their own validation status; the composite wrapper is not
124
+ independently validated.
125
+ - **Vector revision pin.** Conformance is byte-exact against the official
126
+ `draft-ietf-lamps-pq-composite-sigs` interop vectors, now **re-pinned to the
127
+ numbered IETF revision -19** (tag `draft-ietf-lamps-pq-composite-sigs-19`,
128
+ commit `6df63fdc`, re-vendored 2026-07-09). The -19 bytes were fetched and
129
+ confirmed **byte-identical** to the original `main @1bb9f5c6` vendoring for
130
+ every field (PK, both signatures, message, context) of both variants — the WG
131
+ numbered revision **retains** this construction (ASCII `Label`, no `r`). A
132
+ future draft that re-introduces `r` or changes `Label`/`PH` would break interop
133
+ (construction drift → escalate, do not silently re-vendor).
134
+ - **Draft table inconsistency (ECDSA-P256).** The draft's own `labelsTable.md`
135
+ lists the label as `COMPSIG-MLDSA65-P256-SHA512` while `algParams.md` lists
136
+ `COMPSIG-MLDSA65-ECDSA-P256-SHA512`. The committed vectors are authoritative and
137
+ verify **only** with the latter; the module uses the vector-proven label.
138
+ - **Dependency note.** The module depends on `sha256` (ECDSA-P256 inner hash,
139
+ vector-proven) and `random` (Ed25519 keygen seed) in addition to the original design
140
+ sketch — both are load-bearing.
141
+
142
+ ## Evidence & vectors
143
+
144
+ Correctness is anchored to the **official LAMPS interop vectors** (byte-exact,
145
+ both variants, empty-ctx + with-ctx) and locked by a deterministic regeneration
146
+ proof.
147
+
148
+ | Vector set | Id | Source | What it proves |
149
+ |---|---|---|---|
150
+ | LAMPS composite (Ed25519) | empty-ctx + with-ctx | `src/crypto/pkc/__fixtures__/composite-mldsa65-ed25519.js` (test fixture — repository only, not shipped) — draft rev **-19** (`6df63fdc`) | ML-DSA sig, Ed25519 sig and composite PK all byte-exact official material through `verify()` |
151
+ | LAMPS composite (ECDSA-P256) | empty-ctx + with-ctx | `src/crypto/pkc/__fixtures__/composite-mldsa65-ecdsaP256.js` (test fixture — repository only, not shipped) — draft rev **-19** (`6df63fdc`) | DER-framed ECDSA composite verifies byte-exact; negative (strip/swap/tamper) rejects |
152
+ | Combiner reproducibility self-KAT | `mldsa65_ed25519`, `mldsa65_ecdsaP256` | `src/crypto/pkc/__fixtures__/composite-kat-regen.js` (test fixture — repository only, not shipped) — generated by the frozen impl | Frozen keygen + deterministic sign reproduce the committed `pk`/`sig` byte-for-byte (drift lock) |
153
+
154
+ - **Regeneration proof** — `bun packages/front/fw/tools/hybrid-kat-regen.js`
155
+ re-derives each composite `pk` + `sig` from a fixed per-variant SHAKE-256 DRBG
156
+ seed through the frozen construction, asserts byte-identity and re-verifies
157
+ each signature (exit 0/1). Wired as a test in
158
+ [`hybrid-kat-regen.test.js`](https://github.com/awacloud/awa/blob/main/packages/front/fw/src/crypto/pkc/hybrid-kat-regen.test.js).
159
+ - **Provenance** — per-file source / revision / SHA-256 in
160
+ [`hybrid-kat.provenance.md`](../../../../src/crypto/pkc/hybrid-kat.provenance.md).
161
+
162
+ ### Coverage gaps
163
+
164
+ - **Covered**: both variants' official empty-ctx + with-ctx signatures
165
+ (byte-exact); negative cases (wrong message, ctx-binding mismatch, tampered
166
+ ML-DSA byte, tampered/stripped/swapped trad component, TLV splice-reject,
167
+ malformed DER); the SHA-512 byte-domain KAT; deterministic self-KAT
168
+ reproduction of both variants.
169
+ - **Not covered**: there is **no ACVP / CAVP program for the composite
170
+ constructions** — no certified test harness exists, so the LAMPS interop
171
+ vectors are the authoritative oracle. The underlying **ML-DSA-65** is ACVP-green
172
+ ([`ml_dsa.acvp.md`](../../../../src/crypto/pkc/ml_dsa.acvp.md)), **Ed25519** / **ECDSA-P256** carry their
173
+ own RFC/FIPS vector greens — those are **cited, not re-run** here. Side-channel
174
+ / constant-time resistance is explicitly out of scope (§6).
175
+
176
+ ## Notes
177
+
178
+ - Verify is a strict AND (`okMl === true && okTrad === true`); a stripped,
179
+ swapped, or tampered component is rejected — the anti-downgrade property.
180
+ - `keygen()` draws **independent** per-component seeds (ML-DSA and `ecc` self-seed
181
+ via `random`; the Ed25519 32-byte seed comes from `random.bytes`). No component
182
+ key is reused across schemes.
183
+ - Message bytes are hashed through the bitArray domain before `sha512.hash()`
184
+ (SJCL big-endian packing). A raw-byte digest silently passes a round-trip but
185
+ fails the official vectors — only the vectors are evidence of correctness.
186
+
187
+ ## See also
188
+
189
+ - [ml_dsa](./ml_dsa.md) — ML-DSA-65 post-quantum component.
190
+ - [ed25519](./ed25519.md) — Ed25519 classical component.
191
+ - [ecc](./ecc.md) — ECDSA-P-256 classical component.
192
+ - [hybridKem](./hybridKem.md) — companion hybrid KEM (X-Wing).
@@ -0,0 +1,99 @@
1
+ ---
2
+ module: ml_dsa
3
+ category: crypto/pkc
4
+ dependencies: [sha3, bitArray, random, sha256, sha384, sha512, sha512_224, sha512_256]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # ml_dsa
11
+
12
+ > ML-DSA (FIPS 204, August 2024) — CRYSTALS-Dilithium post-quantum signatures + HashML-DSA + internal interface.
13
+
14
+ **Module** `ml_dsa` | **Source** `packages/front/fw/src/crypto/pkc/ml_dsa.js` | **Deps** `sha3`, `bitArray`, `random`, `sha256`, `sha384`, `sha512`, `sha512_224`, `sha512_256` | **Worker-safe** yes
15
+
16
+ NIST post-quantum signatures. 3 paramSets. Variants: pure (default), preHash (HashML-DSA, FIPS 204 §5.4), internal (raw §6.2), externalMu (pre-computed mu).
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const ml_dsa = runtime.resolve('ml_dsa');
22
+ // Returns: { ml_dsa44, ml_dsa65, ml_dsa87, _internal }
23
+ ```
24
+
25
+ ## API
26
+
27
+ | ParamSet | Security | publicKey | secretKey | signature |
28
+ |----------|----------|-----------|-----------|-----------|
29
+ | `ml_dsa44` | NIST PQC Level 2 | 1312 B | 2560 B | 2420 B |
30
+ | `ml_dsa65` | NIST PQC Level 3 | 1952 B | 4032 B | 3309 B |
31
+ | `ml_dsa87` | NIST PQC Level 5 | 2592 B | 4896 B | 4627 B |
32
+
33
+ | Method | Signature | Returns |
34
+ |--------|-----------|---------|
35
+ | `ml_dsa<N>.keygen(seed?)` | `(Uint8Array(32)?) => {publicKey, secretKey}` | Keypair |
36
+ | `ml_dsa<N>.sign(msg, sk, ctx?, rnd?)` | `(Uint8Array, Uint8Array, Uint8Array?, Uint8Array(32)?) => Uint8Array` | Sign external+pure |
37
+ | `ml_dsa<N>.verify(sig, msg, pk, ctx?)` | — | `boolean` |
38
+ | `ml_dsa<N>.signPh(msg, sk, hashAlg, hashMod, ctx?, rnd?)` | — | HashML-DSA (preHash + OID) |
39
+ | `ml_dsa<N>.verifyPh(sig, msg, pk, hashAlg, hashMod, ctx?)` | — | `boolean` |
40
+ | `_internal.signInternal(M, sk, rnd?)` | — | Raw §6.2 (no M' wrapper) |
41
+ | `_internal.verifyInternal(sig, M, pk)` | — | `boolean` raw |
42
+ | `_internal.signWithMu(mu, sk, rnd?)` | — | externalMu (pre-computed mu) |
43
+ | `_internal.verifyWithMu(sig, mu, pk)` | — | `boolean` |
44
+
45
+ ### Supported `hashAlg` values (HashML-DSA)
46
+
47
+ 12 OIDs: SHA2-{224,256,384,512,512/224,512/256}, SHA3-{224,256,384,512}, SHAKE-128, SHAKE-256.
48
+
49
+ ## Examples
50
+
51
+ ### Sign + verify (pure, default)
52
+
53
+ ```js
54
+ const { ml_dsa } = fw.runtime.resolveAll(['ml_dsa']);
55
+ const { publicKey, secretKey } = ml_dsa.ml_dsa65.keygen();
56
+
57
+ const msg = new TextEncoder().encode('Hello, ML-DSA!');
58
+ const sig = ml_dsa.ml_dsa65.sign(msg, secretKey); // deterministic per default
59
+ const ok = ml_dsa.ml_dsa65.verify(sig, msg, publicKey); // true
60
+ ```
61
+
62
+ ### HashML-DSA (preHash variant)
63
+
64
+ ```js
65
+ const sha256 = fw.runtime.resolve('sha256');
66
+ const sig = ml_dsa.ml_dsa65.signPh(msg, secretKey, 'SHA2-256', sha256, ctx);
67
+ const ok = ml_dsa.ml_dsa65.verifyPh(sig, msg, publicKey, 'SHA2-256', sha256, ctx);
68
+ ```
69
+
70
+ ### Internal interface (raw §6.2)
71
+
72
+ ```js
73
+ const sig = ml_dsa.ml_dsa65._internal.signInternal(M, secretKey); // no M' wrapper
74
+ ```
75
+
76
+ ## Worker Usage
77
+
78
+ ```js
79
+ // ml_dsa65 sign ≈ 30-100ms ; verify ≈ 5-15ms — delegate sign to a Worker
80
+ const worker = fw.createWorker(
81
+ function ({ libs, args }) {
82
+ self.postMessage(libs.ml_dsa.ml_dsa65.sign(args[0], args[1]));
83
+ },
84
+ { dependencies: ['ml_dsa'], args: [msg, secretKey] }
85
+ );
86
+ ```
87
+
88
+ ## Notes
89
+
90
+ - **Deterministic by default**: `rnd=null` → byte-exact reproducible signature.
91
+ - **HashML-DSA OID**: DER prefix embedded in the M' wrapper (FIPS 204 Algorithm 4).
92
+ - **`_internal.*`** test-only — bypasses §5.4 wrappers; do NOT expose to end users (risk of secret sk leakage).
93
+ - **Full ACVP** under `CRYPTO_FULL=1`: 75 keyGen + 45 sigVer + 90 sigGen ext+pure.
94
+
95
+ ## See also
96
+
97
+ - [ml_kem](./ml_kem.md), [slh_dsa](./slh_dsa.md) — other PQC modules
98
+ - [sha3](../hash/sha3.md) — mandatory primitive (SHAKE)
99
+ - [Conformance ml_dsa.acvp.md](../../../../src/crypto/pkc/ml_dsa.acvp.md)