@awacloud/fw 0.1.0 → 1.0.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 (609) hide show
  1. package/CHANGELOG.md +125 -0
  2. package/NOTICE +8 -0
  3. package/README.md +163 -31
  4. package/dist/build/fw.core.pure.meta.json +6 -6
  5. package/dist/build/fw.core.pure.min.js +15 -12
  6. package/dist/build/fw.full.pure.meta.json +13 -7
  7. package/dist/build/fw.full.pure.min.js +45 -42
  8. package/dist/build/fw.minimal.pure.meta.json +6 -6
  9. package/dist/build/fw.minimal.pure.min.js +16 -13
  10. package/dist/build/fw.pack.compress-heavy.pure.meta.json +6 -6
  11. package/dist/build/fw.pack.compress-heavy.pure.min.js +3 -3
  12. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +6 -6
  13. package/dist/build/fw.pack.crypto-advanced.pure.min.js +1 -1
  14. package/dist/build/fw.pack.crypto-basic.pure.meta.json +6 -6
  15. package/dist/build/fw.pack.crypto-basic.pure.min.js +1 -1
  16. package/dist/build/fw.pack.crypto-identity.pure.meta.json +7 -6
  17. package/dist/build/fw.pack.crypto-identity.pure.min.js +4 -4
  18. package/dist/build/fw.pwa.pure.meta.json +7 -6
  19. package/dist/build/fw.pwa.pure.min.js +38 -35
  20. package/dist/build/fw.site-interactive.pure.meta.json +6 -6
  21. package/dist/build/fw.site-interactive.pure.min.js +37 -34
  22. package/dist/build/fw.site.pure.meta.json +6 -6
  23. package/dist/build/fw.site.pure.min.js +24 -21
  24. package/dist/build/fw.spa.pure.meta.json +8 -7
  25. package/dist/build/fw.spa.pure.min.js +41 -38
  26. package/dist/build/sanity-base-classic.min.js +1 -1
  27. package/dist/build/sanity.min.js +1 -1
  28. package/dist/types/core/internal.d.ts +29 -0
  29. package/dist/types/core/internal.d.ts.map +1 -0
  30. package/dist/types/core/logger.d.ts +23 -4
  31. package/dist/types/core/logger.d.ts.map +1 -1
  32. package/dist/types/core/modules.d.ts +374 -61
  33. package/dist/types/core/modules.d.ts.map +1 -1
  34. package/dist/types/core/runtime.d.ts +10 -6
  35. package/dist/types/core/runtime.d.ts.map +1 -1
  36. package/dist/types/core/worker-helper.d.ts +35 -0
  37. package/dist/types/core/worker-helper.d.ts.map +1 -1
  38. package/dist/types/crypto/cipher/aes.d.ts +1 -7
  39. package/dist/types/crypto/cipher/aes.d.ts.map +1 -1
  40. package/dist/types/crypto/cipher/chacha20.d.ts +0 -10
  41. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -1
  42. package/dist/types/crypto/hash/argon2.d.ts +0 -15
  43. package/dist/types/crypto/hash/argon2.d.ts.map +1 -1
  44. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -1
  45. package/dist/types/crypto/hash/hmac.d.ts.map +1 -1
  46. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -1
  47. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -1
  48. package/dist/types/crypto/hash/sha224.d.ts +1 -1
  49. package/dist/types/crypto/hash/sha256.d.ts +4 -13
  50. package/dist/types/crypto/hash/sha256.d.ts.map +1 -1
  51. package/dist/types/crypto/hash/sha3.d.ts.map +1 -1
  52. package/dist/types/crypto/hash/sha384.d.ts +1 -1
  53. package/dist/types/crypto/hash/sha512.d.ts +4 -13
  54. package/dist/types/crypto/hash/sha512.d.ts.map +1 -1
  55. package/dist/types/crypto/mode/cmac.d.ts +0 -6
  56. package/dist/types/crypto/mode/cmac.d.ts.map +1 -1
  57. package/dist/types/crypto/mode/ctr.d.ts +0 -6
  58. package/dist/types/crypto/mode/ctr.d.ts.map +1 -1
  59. package/dist/types/crypto/mode/gcm.d.ts +0 -9
  60. package/dist/types/crypto/mode/gcm.d.ts.map +1 -1
  61. package/dist/types/crypto/pkc/ecc.d.ts +0 -1
  62. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -1
  63. package/dist/types/crypto/pkc/ed25519.d.ts +4 -25
  64. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -1
  65. package/dist/types/crypto/pkc/hybridSign.d.ts +25 -5
  66. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -1
  67. package/dist/types/crypto/pkc/ml_dsa.d.ts +6 -26
  68. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -1
  69. package/dist/types/crypto/pkc/ml_kem.d.ts +0 -43
  70. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -1
  71. package/dist/types/crypto/pkc/rsa.d.ts +0 -24
  72. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -1
  73. package/dist/types/crypto/pkc/slh_dsa.d.ts +6 -16
  74. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -1
  75. package/dist/types/crypto/pkc/x25519.d.ts +0 -6
  76. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -1
  77. package/dist/types/crypto/utils/bitArray.d.ts +0 -8
  78. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -1
  79. package/dist/types/crypto/utils/jws.d.ts +6 -14
  80. package/dist/types/crypto/utils/jws.d.ts.map +1 -1
  81. package/dist/types/crypto/utils/keyformat.d.ts +52 -0
  82. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -1
  83. package/dist/types/crypto/utils/random.d.ts +1 -10
  84. package/dist/types/crypto/utils/random.d.ts.map +1 -1
  85. package/dist/types/crypto/utils/rsaKeygen.d.ts +0 -10
  86. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -1
  87. package/dist/types/crypto/utils/uuid.d.ts.map +1 -1
  88. package/dist/types/crypto/utils/x509.d.ts +397 -0
  89. package/dist/types/crypto/utils/x509.d.ts.map +1 -0
  90. package/dist/types/crypto/wasm/argon2.d.ts +2 -1
  91. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -1
  92. package/dist/types/crypto/wasm/pbkdf2.d.ts +2 -2
  93. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -1
  94. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -1
  95. package/dist/types/crypto/wasm/runtime.d.ts +13 -0
  96. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -1
  97. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -1
  98. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -1
  99. package/dist/types/crypto/webcrypto/digest.d.ts +0 -4
  100. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -1
  101. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -1
  102. package/dist/types/dom/fs/fileIntake.d.ts +59 -0
  103. package/dist/types/dom/fs/fileIntake.d.ts.map +1 -0
  104. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -1
  105. package/dist/types/dom/query/dnd.d.ts.map +1 -1
  106. package/dist/types/dom/query/sound.d.ts +89 -0
  107. package/dist/types/dom/query/sound.d.ts.map +1 -0
  108. package/dist/types/dom/rendering/chart.d.ts.map +1 -1
  109. package/dist/types/dom/rendering/component.d.ts +9 -3
  110. package/dist/types/dom/rendering/component.d.ts.map +1 -1
  111. package/dist/types/dom/rendering/parser.d.ts +39 -0
  112. package/dist/types/dom/rendering/parser.d.ts.map +1 -1
  113. package/dist/types/dom/rendering/render.d.ts.map +1 -1
  114. package/dist/types/dom/rendering/sanitize.d.ts +4 -0
  115. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -1
  116. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -1
  117. package/dist/types/dom/rendering/styleSheet.d.ts +74 -0
  118. package/dist/types/dom/rendering/styleSheet.d.ts.map +1 -0
  119. package/dist/types/dom/rendering/template.d.ts +9 -3
  120. package/dist/types/dom/rendering/template.d.ts.map +1 -1
  121. package/dist/types/dom/rendering/themeTokens.d.ts +9 -3
  122. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -1
  123. package/dist/types/dom/rendering/uiSession-core.d.ts +9 -3
  124. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -1
  125. package/dist/types/dom/rendering/uiSession-list.d.ts +9 -3
  126. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -1
  127. package/dist/types/dom/rendering/uiSession.d.ts +18 -6
  128. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -1
  129. package/dist/types/dom/sw/installPrompt.d.ts +89 -0
  130. package/dist/types/dom/sw/installPrompt.d.ts.map +1 -0
  131. package/dist/types/dom/sw/precache.d.ts +149 -0
  132. package/dist/types/dom/sw/precache.d.ts.map +1 -0
  133. package/dist/types/dom/sw/swUpdate.d.ts +129 -0
  134. package/dist/types/dom/sw/swUpdate.d.ts.map +1 -0
  135. package/dist/types/dom/utils/clipboard.d.ts +8 -0
  136. package/dist/types/dom/utils/clipboard.d.ts.map +1 -1
  137. package/dist/types/dom/utils/keybindings.d.ts.map +1 -1
  138. package/dist/types/dom/utils/route.d.ts.map +1 -1
  139. package/dist/types/dom/utils/ua.d.ts +2 -2
  140. package/dist/types/dom/utils/ua.d.ts.map +1 -1
  141. package/dist/types/io/calc/crc32.d.ts.map +1 -1
  142. package/dist/types/io/codec/b64.d.ts +24 -0
  143. package/dist/types/io/codec/b64.d.ts.map +1 -1
  144. package/dist/types/io/codec/cbor.d.ts +1 -0
  145. package/dist/types/io/codec/cbor.d.ts.map +1 -1
  146. package/dist/types/io/codec/hex.d.ts.map +1 -1
  147. package/dist/types/io/codec/msgpack.d.ts +1 -0
  148. package/dist/types/io/codec/msgpack.d.ts.map +1 -1
  149. package/dist/types/io/codec/url.d.ts +3 -1
  150. package/dist/types/io/codec/url.d.ts.map +1 -1
  151. package/dist/types/io/codec/utf8.d.ts.map +1 -1
  152. package/dist/types/io/compress/bitstream.d.ts +1 -1
  153. package/dist/types/io/compress/brotli.d.ts +0 -1
  154. package/dist/types/io/compress/brotli.d.ts.map +1 -1
  155. package/dist/types/io/compress/brotli_shared.d.ts +0 -4
  156. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -1
  157. package/dist/types/io/compress/deflate.d.ts +14 -1
  158. package/dist/types/io/compress/deflate.d.ts.map +1 -1
  159. package/dist/types/io/compress/gzip.d.ts +4 -0
  160. package/dist/types/io/compress/gzip.d.ts.map +1 -1
  161. package/dist/types/io/compress/huffman.d.ts +7 -0
  162. package/dist/types/io/compress/huffman.d.ts.map +1 -1
  163. package/dist/types/io/compress/lz4.d.ts +4 -2
  164. package/dist/types/io/compress/lz4.d.ts.map +1 -1
  165. package/dist/types/io/compress/lz77.d.ts +17 -0
  166. package/dist/types/io/compress/lz77.d.ts.map +1 -1
  167. package/dist/types/io/compress/lzw.d.ts +2 -0
  168. package/dist/types/io/compress/lzw.d.ts.map +1 -1
  169. package/dist/types/io/compress/zip.d.ts.map +1 -1
  170. package/dist/types/io/compress/zlib.d.ts +9 -2
  171. package/dist/types/io/compress/zlib.d.ts.map +1 -1
  172. package/dist/types/io/math/linalg.d.ts.map +1 -1
  173. package/dist/types/process/rpc.d.ts.map +1 -1
  174. package/dist/types/process/workerPool.d.ts.map +1 -1
  175. package/dist/types/sanity/base.d.ts +12 -2
  176. package/dist/types/sanity/base.d.ts.map +1 -1
  177. package/dist/types/sanity/lockdown.d.ts +6 -5
  178. package/dist/types/sanity/lockdown.d.ts.map +1 -1
  179. package/dist/types/sanity/wasm-gate.d.ts +1 -1
  180. package/docs/README.md +17 -10
  181. package/docs/api/README.md +5 -5
  182. package/docs/api/core/logger.md +2 -1
  183. package/docs/api/core/modules.md +3 -3
  184. package/docs/api/core/runtime.md +9 -9
  185. package/docs/api/core/worker-helper.md +12 -2
  186. package/docs/api/crypto/README.md +1 -1
  187. package/docs/api/crypto/cipher/README.md +2 -2
  188. package/docs/api/crypto/cipher/aes.md +5 -10
  189. package/docs/api/crypto/cipher/chacha20.md +3 -8
  190. package/docs/api/crypto/hash/README.md +5 -5
  191. package/docs/api/crypto/hash/adf.md +21 -11
  192. package/docs/api/crypto/hash/argon2.md +3 -12
  193. package/docs/api/crypto/hash/blake2b.md +12 -14
  194. package/docs/api/crypto/hash/pbkdf2.md +1 -1
  195. package/docs/api/crypto/hash/sha224.md +2 -2
  196. package/docs/api/crypto/hash/sha256.md +4 -4
  197. package/docs/api/crypto/hash/sha3.md +2 -2
  198. package/docs/api/crypto/hash/sha384.md +1 -1
  199. package/docs/api/crypto/hash/sha512.md +5 -5
  200. package/docs/api/crypto/hash/sha512_224.md +1 -1
  201. package/docs/api/crypto/hash/sha512_256.md +1 -1
  202. package/docs/api/crypto/mode/README.md +3 -3
  203. package/docs/api/crypto/mode/cbc.md +2 -2
  204. package/docs/api/crypto/mode/chacha20poly1305.md +1 -1
  205. package/docs/api/crypto/mode/cmac.md +4 -4
  206. package/docs/api/crypto/mode/ctr.md +2 -3
  207. package/docs/api/crypto/mode/gcm.md +5 -5
  208. package/docs/api/crypto/mode/kw.md +4 -4
  209. package/docs/api/crypto/pkc/README.md +8 -8
  210. package/docs/api/crypto/pkc/ecc.md +19 -17
  211. package/docs/api/crypto/pkc/ed25519.md +10 -15
  212. package/docs/api/crypto/pkc/hybridKem.md +8 -2
  213. package/docs/api/crypto/pkc/hybridSign.md +34 -7
  214. package/docs/api/crypto/pkc/ml_dsa.md +20 -19
  215. package/docs/api/crypto/pkc/ml_kem.md +3 -3
  216. package/docs/api/crypto/pkc/rsa.md +7 -9
  217. package/docs/api/crypto/pkc/slh_dsa.md +12 -12
  218. package/docs/api/crypto/pkc/x25519.md +5 -4
  219. package/docs/api/crypto/utils/README.md +7 -7
  220. package/docs/api/crypto/utils/aes_modes.md +2 -5
  221. package/docs/api/crypto/utils/asn1.md +25 -16
  222. package/docs/api/crypto/utils/jws.md +6 -4
  223. package/docs/api/crypto/utils/keyformat.md +24 -15
  224. package/docs/api/crypto/utils/pad.md +1 -1
  225. package/docs/api/crypto/utils/pem.md +3 -3
  226. package/docs/api/crypto/utils/random.md +3 -4
  227. package/docs/api/crypto/utils/rsaKeygen.md +2 -2
  228. package/docs/api/crypto/utils/totp.md +2 -2
  229. package/docs/api/crypto/utils/uuid.md +5 -5
  230. package/docs/api/crypto/utils/x509.md +124 -0
  231. package/docs/api/crypto/wasm/aes.md +1 -1
  232. package/docs/api/crypto/wasm/argon2.md +6 -4
  233. package/docs/api/crypto/wasm/ml_kem.md +1 -0
  234. package/docs/api/crypto/wasm/pbkdf2.md +8 -8
  235. package/docs/api/crypto/wasm/rsa.md +1 -1
  236. package/docs/api/crypto/wasm/runtime.md +27 -10
  237. package/docs/api/crypto/webcrypto/aes.md +1 -1
  238. package/docs/api/crypto/webcrypto/aeskw.md +2 -2
  239. package/docs/api/crypto/webcrypto/digest.md +3 -5
  240. package/docs/api/crypto/webcrypto/ecc.md +1 -1
  241. package/docs/api/crypto/webcrypto/ed25519.md +1 -1
  242. package/docs/api/crypto/webcrypto/rsa.md +3 -2
  243. package/docs/api/crypto/webcrypto/x25519.md +1 -1
  244. package/docs/api/dom/README.md +6 -1
  245. package/docs/api/dom/fs/README.md +1 -0
  246. package/docs/api/dom/fs/fileIntake.md +120 -0
  247. package/docs/api/dom/fs/fsAccess.md +1 -0
  248. package/docs/api/dom/fs/indexedDB.md +1 -1
  249. package/docs/api/dom/fs/storage.md +1 -1
  250. package/docs/api/dom/query/README.md +2 -1
  251. package/docs/api/dom/query/dnd.md +4 -1
  252. package/docs/api/dom/query/dom.md +5 -0
  253. package/docs/api/dom/query/sound.md +103 -0
  254. package/docs/api/dom/rendering/README.md +4 -3
  255. package/docs/api/dom/rendering/chart.md +5 -4
  256. package/docs/api/dom/rendering/component.md +25 -3
  257. package/docs/api/dom/rendering/parser.md +5 -2
  258. package/docs/api/dom/rendering/reactiveBind.md +1 -1
  259. package/docs/api/dom/rendering/render.md +2 -2
  260. package/docs/api/dom/rendering/sanitize.md +10 -2
  261. package/docs/api/dom/rendering/secPolicy.md +4 -4
  262. package/docs/api/dom/rendering/styleSheet.md +85 -0
  263. package/docs/api/dom/rendering/template.md +20 -5
  264. package/docs/api/dom/rendering/themeTokens.md +6 -3
  265. package/docs/api/dom/rendering/uiSession.md +18 -5
  266. package/docs/api/dom/rendering/virtualScroll.md +2 -2
  267. package/docs/api/dom/sensors/geolocation.md +1 -1
  268. package/docs/api/dom/sw/README.md +7 -1
  269. package/docs/api/dom/sw/cache.md +2 -1
  270. package/docs/api/dom/sw/installPrompt.md +111 -0
  271. package/docs/api/dom/sw/precache.md +124 -0
  272. package/docs/api/dom/sw/serviceWorker.md +4 -2
  273. package/docs/api/dom/sw/swUpdate.md +112 -0
  274. package/docs/api/dom/utils/clipboard.md +56 -5
  275. package/docs/api/dom/utils/entropyCollector.md +1 -1
  276. package/docs/api/dom/utils/keybindings.md +17 -2
  277. package/docs/api/dom/utils/leaderElection.md +2 -2
  278. package/docs/api/dom/utils/route.md +1 -0
  279. package/docs/api/dom/utils/ua.md +15 -10
  280. package/docs/api/io/calc/crc32.md +4 -1
  281. package/docs/api/io/codec/README.md +2 -2
  282. package/docs/api/io/codec/b64.md +31 -2
  283. package/docs/api/io/codec/buffer.md +1 -1
  284. package/docs/api/io/codec/cbor.md +6 -4
  285. package/docs/api/io/codec/csv.md +178 -178
  286. package/docs/api/io/codec/hex.md +10 -2
  287. package/docs/api/io/codec/msgpack.md +4 -3
  288. package/docs/api/io/codec/url.md +4 -3
  289. package/docs/api/io/codec/utf8.md +3 -3
  290. package/docs/api/io/compress/bitstream.md +6 -3
  291. package/docs/api/io/compress/brotli.md +36 -4
  292. package/docs/api/io/compress/brotli_shared.md +1 -1
  293. package/docs/api/io/compress/deflate.md +42 -34
  294. package/docs/api/io/compress/gzip.md +26 -6
  295. package/docs/api/io/compress/huffman.md +2 -1
  296. package/docs/api/io/compress/lz4.md +5 -3
  297. package/docs/api/io/compress/lz77.md +26 -3
  298. package/docs/api/io/compress/lzw.md +13 -8
  299. package/docs/api/io/compress/zip.md +36 -10
  300. package/docs/api/io/compress/zlib.md +21 -5
  301. package/docs/api/io/math/linalg.md +1 -1
  302. package/docs/api/io/utils/valid.md +1 -1
  303. package/docs/api/process/rpc.md +3 -2
  304. package/docs/api/process/workerPool.md +1 -1
  305. package/docs/api/sanity/base.md +9 -5
  306. package/docs/api/sanity/lockdown.md +7 -6
  307. package/docs/api/surface.json +12311 -0
  308. package/docs/api/typed.md +5 -3
  309. package/docs/dev/README.md +2 -0
  310. package/docs/dev/bench.md +76 -0
  311. package/docs/dev/crypto-references.md +54 -0
  312. package/docs/dev/provenance.md +30 -7
  313. package/docs/dev/publishing.md +7 -7
  314. package/docs/dev/runtime.md +1 -1
  315. package/docs/dev/testing.md +13 -0
  316. package/docs/evidence/l4-evidence.md +86 -0
  317. package/docs/evidence/pqc-hybrid-evidence.md +7 -6
  318. package/docs/guide/README.md +1 -0
  319. package/docs/guide/_QUICK_REF.md +5 -5
  320. package/docs/guide/doc-format.md +4 -3
  321. package/docs/guide/integrations-hmr.md +1 -1
  322. package/docs/guide/module-creation-workflow.md +8 -8
  323. package/docs/guide/rendering-pipeline.md +11 -4
  324. package/docs/guide/security.md +7 -5
  325. package/docs/guide/stability.md +123 -0
  326. package/docs/guide/tutorial-todo.md +20 -8
  327. package/docs/guide/typescript.md +9 -0
  328. package/docs/guide/worker-confinement.md +30 -17
  329. package/docs/notes/lz77-deflate-factorization.md +3 -3
  330. package/docs/tools/README.md +1 -1
  331. package/docs/tools/bundler.md +3 -3
  332. package/docs/tools/codegen.md +1 -1
  333. package/docs/tools/standalone.md +0 -1
  334. package/fw.config.json +2 -2
  335. package/integrations/_shared/catalog.generated.json +7 -1
  336. package/integrations/_shared/core.js +1 -1
  337. package/integrations/astro/index.js +1 -1
  338. package/integrations/eslint/README.md +7 -1
  339. package/integrations/nextjs/index.js +1 -1
  340. package/integrations/nodejs/README.md +3 -3
  341. package/integrations/turbopack/index.js +2 -2
  342. package/integrations/typedoc/categorize.js +1 -1
  343. package/integrations/typedoc/typedoc.json +2 -1
  344. package/integrations/vite/index.js +2 -2
  345. package/integrations/vite/vite-env.d.ts +7 -4
  346. package/integrations/webpack/index.js +3 -3
  347. package/package.json +76 -10
  348. package/src/core/internal.js +31 -0
  349. package/src/core/logger.js +95 -23
  350. package/src/core/modules.js +17 -8
  351. package/src/core/readyState.js +1 -1
  352. package/src/core/runtime.js +74 -27
  353. package/src/core/worker-helper.js +83 -4
  354. package/src/crypto/NIST_CONFORMANCE.md +47 -34
  355. package/src/crypto/cipher/aes.acvp.md +7 -8
  356. package/src/crypto/cipher/aes.js +280 -229
  357. package/src/crypto/cipher/chacha20.acvp.md +6 -7
  358. package/src/crypto/cipher/chacha20.js +91 -61
  359. package/src/crypto/hash/adf.js +1 -1
  360. package/src/crypto/hash/argon2.acvp.md +11 -15
  361. package/src/crypto/hash/argon2.js +9 -24
  362. package/src/crypto/hash/blake2b.js +157 -125
  363. package/src/crypto/hash/hkdf.acvp.md +15 -15
  364. package/src/crypto/hash/hkdf.js +1 -1
  365. package/src/crypto/hash/hmac.acvp.md +10 -12
  366. package/src/crypto/hash/hmac.js +5 -1
  367. package/src/crypto/hash/pbkdf2.acvp.md +13 -13
  368. package/src/crypto/hash/pbkdf2.js +36 -8
  369. package/src/crypto/hash/poly1305.acvp.md +10 -6
  370. package/src/crypto/hash/poly1305.js +171 -50
  371. package/src/crypto/hash/sha224.acvp.md +3 -3
  372. package/src/crypto/hash/sha224.js +4 -4
  373. package/src/crypto/hash/sha256.acvp.md +2 -2
  374. package/src/crypto/hash/sha256.js +514 -50
  375. package/src/crypto/hash/sha3.acvp.md +9 -9
  376. package/src/crypto/hash/sha3.js +127 -71
  377. package/src/crypto/hash/sha384.acvp.md +3 -3
  378. package/src/crypto/hash/sha384.js +4 -4
  379. package/src/crypto/hash/sha512.acvp.md +7 -8
  380. package/src/crypto/hash/sha512.js +107 -108
  381. package/src/crypto/hash/sha512_224.acvp.md +6 -6
  382. package/src/crypto/hash/sha512_224.js +2 -2
  383. package/src/crypto/hash/sha512_256.acvp.md +6 -6
  384. package/src/crypto/hash/sha512_256.js +2 -2
  385. package/src/crypto/mode/cbc.acvp.md +2 -2
  386. package/src/crypto/mode/cbc.js +1 -1
  387. package/src/crypto/mode/chacha20poly1305.acvp.md +6 -6
  388. package/src/crypto/mode/chacha20poly1305.js +3 -3
  389. package/src/crypto/mode/cmac.acvp.md +5 -5
  390. package/src/crypto/mode/cmac.js +8 -8
  391. package/src/crypto/mode/ctr.acvp.md +2 -2
  392. package/src/crypto/mode/ctr.js +1 -3
  393. package/src/crypto/mode/gcm.acvp.md +6 -6
  394. package/src/crypto/mode/gcm.js +7 -7
  395. package/src/crypto/mode/kw.acvp.md +4 -4
  396. package/src/crypto/mode/kw.js +5 -5
  397. package/src/crypto/pkc/ecc.acvp.md +13 -13
  398. package/src/crypto/pkc/ecc.js +9 -11
  399. package/src/crypto/pkc/ed25519.acvp.md +30 -34
  400. package/src/crypto/pkc/ed25519.js +453 -94
  401. package/src/crypto/pkc/hybrid-kat.provenance.md +4 -4
  402. package/src/crypto/pkc/hybridSign.js +103 -24
  403. package/src/crypto/pkc/ml_dsa.acvp.md +18 -18
  404. package/src/crypto/pkc/ml_dsa.js +29 -32
  405. package/src/crypto/pkc/ml_kem.acvp.md +7 -7
  406. package/src/crypto/pkc/ml_kem.js +15 -21
  407. package/src/crypto/pkc/rsa.acvp.md +11 -15
  408. package/src/crypto/pkc/rsa.js +7 -44
  409. package/src/crypto/pkc/slh_dsa.acvp.md +16 -16
  410. package/src/crypto/pkc/slh_dsa.js +16 -18
  411. package/src/crypto/pkc/x25519.acvp.md +13 -10
  412. package/src/crypto/pkc/x25519.js +273 -29
  413. package/src/crypto/utils/aes_modes.acvp.md +1 -2
  414. package/src/crypto/utils/aes_modes.js +2 -2
  415. package/src/crypto/utils/asn1-oid.js +1 -1
  416. package/src/crypto/utils/asn1.js +1 -1
  417. package/src/crypto/utils/bitArray.js +33 -48
  418. package/src/crypto/utils/bn.js +1 -1
  419. package/src/crypto/utils/jws.js +37 -41
  420. package/src/crypto/utils/keyformat.js +181 -2
  421. package/src/crypto/utils/pem.js +1 -1
  422. package/src/crypto/utils/random.acvp.md +5 -5
  423. package/src/crypto/utils/random.js +845 -846
  424. package/src/crypto/utils/rsaKeygen.acvp.md +3 -2
  425. package/src/crypto/utils/rsaKeygen.js +6 -6
  426. package/src/crypto/utils/totp.js +1 -1
  427. package/src/crypto/utils/uuid.acvp.md +5 -5
  428. package/src/crypto/utils/uuid.js +11 -10
  429. package/src/crypto/utils/x509.js +591 -0
  430. package/src/crypto/wasm/aes.js +1 -1
  431. package/src/crypto/wasm/aes.scalar.wasm +0 -0
  432. package/src/crypto/wasm/argon2.js +17 -1
  433. package/src/crypto/wasm/argon2.scalar.wasm +0 -0
  434. package/src/crypto/wasm/blake2b.scalar.wasm +0 -0
  435. package/src/crypto/wasm/blake2b.simd.wasm +0 -0
  436. package/src/crypto/wasm/chacha20poly1305.scalar.wasm +0 -0
  437. package/src/crypto/wasm/chacha20poly1305.simd.wasm +0 -0
  438. package/src/crypto/wasm/cmac.scalar.wasm +0 -0
  439. package/src/crypto/wasm/ecc.js +3 -3
  440. package/src/crypto/wasm/ecc.scalar.wasm +0 -0
  441. package/src/crypto/wasm/ed25519.js +1 -1
  442. package/src/crypto/wasm/ed25519.scalar.wasm +0 -0
  443. package/src/crypto/wasm/hkdf.scalar.wasm +0 -0
  444. package/src/crypto/wasm/hmac.scalar.wasm +0 -0
  445. package/src/crypto/wasm/ml_dsa.js +2 -2
  446. package/src/crypto/wasm/ml_dsa.scalar.wasm +0 -0
  447. package/src/crypto/wasm/ml_dsa.simd.wasm +0 -0
  448. package/src/crypto/wasm/ml_kem.js +2 -2
  449. package/src/crypto/wasm/ml_kem.scalar.wasm +0 -0
  450. package/src/crypto/wasm/ml_kem.simd.wasm +0 -0
  451. package/src/crypto/wasm/pbkdf2.js +8 -6
  452. package/src/crypto/wasm/pbkdf2.scalar.wasm +0 -0
  453. package/src/crypto/wasm/rsa.js +6 -5
  454. package/src/crypto/wasm/rsa.scalar.wasm +0 -0
  455. package/src/crypto/wasm/runtime.js +84 -17
  456. package/src/crypto/wasm/sha2.scalar.wasm +0 -0
  457. package/src/crypto/wasm/sha3.scalar.wasm +0 -0
  458. package/src/crypto/wasm/sha3.simd.wasm +0 -0
  459. package/src/crypto/wasm/slh_dsa.js +1 -1
  460. package/src/crypto/wasm/slh_dsa.scalar.wasm +0 -0
  461. package/src/crypto/wasm/x25519.js +1 -1
  462. package/src/crypto/wasm/x25519.scalar.wasm +0 -0
  463. package/src/crypto/webcrypto/aes.js +8 -2
  464. package/src/crypto/webcrypto/aeskw.js +7 -2
  465. package/src/crypto/webcrypto/digest.js +1 -15
  466. package/src/crypto/webcrypto/ecc.js +2 -2
  467. package/src/crypto/webcrypto/ed25519.js +2 -2
  468. package/src/crypto/webcrypto/hmac.js +2 -2
  469. package/src/crypto/webcrypto/rsa.js +7 -2
  470. package/src/crypto/webcrypto/x25519.js +2 -2
  471. package/src/dom/display/animate.js +1 -1
  472. package/src/dom/display/fullscreen.js +1 -1
  473. package/src/dom/fs/download.js +1 -1
  474. package/src/dom/fs/fileIntake.js +192 -0
  475. package/src/dom/fs/fsAccess.js +2 -3
  476. package/src/dom/fs/indexedDB.js +1 -1
  477. package/src/dom/fs/remoteStore.js +1 -1
  478. package/src/dom/fs/storage.js +1 -1
  479. package/src/dom/lifecycle/idle.js +1 -1
  480. package/src/dom/lifecycle/visibility.js +1 -1
  481. package/src/dom/lifecycle/wakeLock.js +1 -1
  482. package/src/dom/net/ajax.js +1 -1
  483. package/src/dom/net/network.js +1 -1
  484. package/src/dom/net/sse.js +1 -1
  485. package/src/dom/net/webrtc.js +1 -1
  486. package/src/dom/net/ws.js +1 -1
  487. package/src/dom/query/dnd.js +56 -4
  488. package/src/dom/query/dom.js +1 -1
  489. package/src/dom/query/events.js +1 -1
  490. package/src/dom/query/gesture.js +1 -1
  491. package/src/dom/query/media.js +1 -1
  492. package/src/dom/query/sound.js +333 -0
  493. package/src/dom/rendering/chart.js +736 -663
  494. package/src/dom/rendering/component.js +25 -14
  495. package/src/dom/rendering/devtools.js +2 -2
  496. package/src/dom/rendering/parser.js +155 -12
  497. package/src/dom/rendering/render.js +14 -4
  498. package/src/dom/rendering/sanitize.js +11 -4
  499. package/src/dom/rendering/secPolicy.js +6 -4
  500. package/src/dom/rendering/styleSheet.js +217 -0
  501. package/src/dom/rendering/template.js +72 -13
  502. package/src/dom/rendering/themeTokens.js +542 -522
  503. package/src/dom/rendering/uiSession-core.js +51 -6
  504. package/src/dom/rendering/uiSession-direct.js +1 -1
  505. package/src/dom/rendering/uiSession-list.js +4 -4
  506. package/src/dom/rendering/uiSession.js +1 -1
  507. package/src/dom/rendering/virtualScroll.js +341 -341
  508. package/src/dom/sensors/battery.js +1 -1
  509. package/src/dom/sensors/geolocation.js +1 -1
  510. package/src/dom/sensors/networkInfo.js +1 -1
  511. package/src/dom/sensors/sensors.js +1 -1
  512. package/src/dom/sw/backgroundSync.js +1 -1
  513. package/src/dom/sw/cache.js +1 -1
  514. package/src/dom/sw/installPrompt.js +151 -0
  515. package/src/dom/sw/precache.js +257 -0
  516. package/src/dom/sw/push.js +1 -1
  517. package/src/dom/sw/sharedWorker.js +1 -1
  518. package/src/dom/sw/swUpdate.js +239 -0
  519. package/src/dom/utils/a11y.js +1 -1
  520. package/src/dom/utils/clipboard.js +56 -6
  521. package/src/dom/utils/entropyCollector.js +1 -1
  522. package/src/dom/utils/focus.js +1 -1
  523. package/src/dom/utils/form.js +1 -1
  524. package/src/dom/utils/keybindings.js +600 -574
  525. package/src/dom/utils/leaderElection.js +1 -1
  526. package/src/dom/utils/notifications.js +1 -1
  527. package/src/dom/utils/permissions.js +107 -107
  528. package/src/dom/utils/route.js +14 -2
  529. package/src/dom/utils/ua.js +42 -28
  530. package/src/dom/utils/webauthn.js +1 -1
  531. package/src/io/binary/reader.js +1 -1
  532. package/src/io/binary/writer.js +1 -1
  533. package/src/io/calc/bigint.js +1 -1
  534. package/src/io/calc/crc32.js +28 -2
  535. package/src/io/calc/easing.js +514 -514
  536. package/src/io/codec/b64.js +189 -52
  537. package/src/io/codec/base32.js +1 -1
  538. package/src/io/codec/base58.js +1 -1
  539. package/src/io/codec/buffer.js +1 -1
  540. package/src/io/codec/cbor.js +111 -18
  541. package/src/io/codec/csv.js +1 -1
  542. package/src/io/codec/hex.js +51 -6
  543. package/src/io/codec/mime.js +1 -1
  544. package/src/io/codec/msgpack.js +47 -6
  545. package/src/io/codec/url.js +24 -7
  546. package/src/io/codec/utf8.js +5 -3
  547. package/src/io/codec/xml.js +1 -1
  548. package/src/io/compress/bitstream.js +2 -2
  549. package/src/io/compress/brotli.js +663 -163
  550. package/src/io/compress/brotli_dict.js +1 -1
  551. package/src/io/compress/brotli_dict_words.js +1 -1
  552. package/src/io/compress/brotli_frame.js +1 -1
  553. package/src/io/compress/brotli_shared.js +7 -7
  554. package/src/io/compress/deflate.js +87 -53
  555. package/src/io/compress/gzip.js +187 -74
  556. package/src/io/compress/huffman.js +24 -1
  557. package/src/io/compress/lz4.js +45 -7
  558. package/src/io/compress/lz77.js +148 -63
  559. package/src/io/compress/lzw.js +35 -19
  560. package/src/io/compress/zip.js +862 -815
  561. package/src/io/compress/zlib.js +87 -7
  562. package/src/io/i18n/i18n.js +1 -1
  563. package/src/io/math/fixed-point.js +1 -1
  564. package/src/io/math/geom.js +1 -1
  565. package/src/io/math/interp.js +1 -1
  566. package/src/io/math/linalg.js +10 -4
  567. package/src/io/math/stats.js +1 -1
  568. package/src/io/structures/btree.js +1 -1
  569. package/src/io/structures/heap.js +1 -1
  570. package/src/io/structures/lruCache.js +1 -1
  571. package/src/io/structures/ringBuffer.js +1 -1
  572. package/src/io/structures/tree-walker.js +1 -1
  573. package/src/io/structures/trie.js +1 -1
  574. package/src/io/sync/abort.js +1 -1
  575. package/src/io/sync/atomics.js +1 -1
  576. package/src/io/sync/cancellable.js +1 -1
  577. package/src/io/sync/channel.js +1 -1
  578. package/src/io/sync/mutex.js +1 -1
  579. package/src/io/sync/semaphore.js +1 -1
  580. package/src/io/sync/tokenBucket.js +1 -1
  581. package/src/io/text/ansi.js +1 -1
  582. package/src/io/text/html-entities.js +1 -1
  583. package/src/io/time/date.js +1 -1
  584. package/src/io/timing/clock.js +1 -1
  585. package/src/io/timing/rateLimit.js +1 -1
  586. package/src/io/timing/scheduler.js +1 -1
  587. package/src/io/utils/errors.js +1 -1
  588. package/src/io/utils/eventBus.js +1 -1
  589. package/src/io/utils/signal.js +1 -1
  590. package/src/io/utils/valid.js +1 -1
  591. package/src/main.js +1 -1
  592. package/src/process/message.js +1 -1
  593. package/src/process/rpc.js +7 -3
  594. package/src/process/workerPool.js +11 -4
  595. package/src/sanity/base.js +85 -39
  596. package/src/sanity/lockdown-apply.js +3 -3
  597. package/src/sanity/lockdown.js +58 -32
  598. package/src/sanity/wasm-gate.js +2 -2
  599. package/src/typed.js +7 -3
  600. package/third-party/NOTICE-brotli-dictionary.txt +69 -0
  601. package/third-party/NOTICE-fw-wasm-crypto.txt +576 -0
  602. package/third-party/NOTICE-whatwg-entities.txt +44 -0
  603. package/types/registry.generated.d.ts +7 -1
  604. package/types/typed.d.ts +7 -3
  605. package/dist/types/crypto/utils/aes_ctr.d.ts +0 -84
  606. package/dist/types/crypto/utils/aes_ctr.d.ts.map +0 -1
  607. package/docs/api/crypto/utils/aes_ctr.md +0 -71
  608. package/src/crypto/utils/aes_ctr.acvp.md +0 -67
  609. package/src/crypto/utils/aes_ctr.js +0 -134
@@ -1,341 +1,341 @@
1
- // Copyright (c) 2026 AwaCloud SAS
2
- // Author: Matthieu Bouilloux
3
- // SPDX-License-Identifier: Apache-2.0
4
-
5
- /**
6
- * @description
7
- * Virtualised list for rendering collections of 10^4 to 10^6 items without
8
- * prohibitive memory / CPU cost. Only visible items plus a configurable
9
- * overscan are materialised in the DOM.
10
- *
11
- * Two modes :
12
- * - `fixed` (MVP, default) : fixed `itemHeight` in px - O(1) range computation,
13
- * no DOM measurement.
14
- * - `variable` : heights measured on the fly and cached in a `Map<idx, height>`.
15
- * Heights are only re-measured when a previously-unseen index is rendered ;
16
- * `setTotal` invalidates the cache beyond the given index.
17
- *
18
- * DOM structure :
19
- * ```
20
- * container (overflow: auto)
21
- * ├─ spacer (height = total * itemHeight in fixed mode)
22
- * └─ layer (position: absolute; top: scrollTop-adjusted)
23
- * └─ rendered items (overscan included)
24
- * ```
25
- *
26
- * `renderItem(idx)` may return an `HTMLElement` or an elm-array compatible
27
- * with `dom` / `template`.
28
- *
29
- * Out of scope for MVP : node recycling, sticky headers, horizontal axes.
30
- *
31
- * The scroll listener is bound directly on the container via `addEventListener`
32
- * (single owner, lifecycle handled by `dispose()`) - no dependency on the
33
- * `events` registry.
34
- *
35
- * @example
36
- * const vs = runtime.resolve('virtualScroll');
37
- * const list = vs.create({
38
- * container: document.getElementById('list'),
39
- * itemHeight: 32,
40
- * total: 50000,
41
- * renderItem(idx) {
42
- * const li = document.createElement('li');
43
- * li.textContent = `Item ${idx}`;
44
- * return li;
45
- * }
46
- * });
47
- * list.scrollTo(1000);
48
- * list.dispose();
49
- */
50
- import { dom } from '../query/dom.js';
51
-
52
- /**
53
- * A virtualised-list instance returned by `create()`.
54
- * @typedef {object} VirtualScrollInstance
55
- * @property {() => void} refresh - Re-render the visible range after a data/total change.
56
- * @property {(n: number) => void} setTotal - Update the total item count and refresh.
57
- * @property {(idx: number, scrollOpts?: {align?: 'start'|'center'|'end'|'auto'}) => void} scrollTo - Programmatically scroll to an index.
58
- * @property {() => {start: number, end: number}} visibleRange - Return the currently visible index range.
59
- * @property {(idx: number) => number} measure - Return the (measured or estimated) height of an item.
60
- * @property {() => void} dispose - Detach listeners and clear the layer.
61
- */
62
-
63
- /**
64
- * Virtualised-list surface returned by `factory()`.
65
- * @typedef {object} VirtualScrollAPI
66
- * @property {(opts: {container: Element, itemHeight: number, total: number, renderItem: (idx: number) => (Element|Array), overscan?: number, mode?: 'fixed'|'variable'}) => VirtualScrollInstance} create - Create a virtualised-list instance.
67
- */
68
-
69
- export const virtualScroll = {
70
- name: 'virtualScroll',
71
- version: '1.1.0',
72
- type: 'fw.dom.rendering',
73
- dependencies: ['dom'],
74
- deps: [dom],
75
-
76
- /**
77
- * @param {Object} dom - Resolved `dom` module instance.
78
- * @returns {VirtualScrollAPI}
79
- */
80
- factory(dom) {
81
-
82
- /**
83
- * Create a virtualised-list instance.
84
- *
85
- * @param {Object} opts
86
- * @param {Element} opts.container - Scrollable element (overflow: auto).
87
- * @param {number} opts.itemHeight - Item height in px (fixed mode).
88
- * @param {number} opts.total - Total item count.
89
- * @param {Function} opts.renderItem - `(idx) → HTMLElement | ElmNode[]`
90
- * @param {number} [opts.overscan=3] - Extra items rendered above/below the viewport.
91
- * @param {'fixed'|'variable'} [opts.mode='fixed'] - Height computation mode.
92
- * @returns {{ refresh, setTotal, scrollTo, visibleRange, measure, dispose }}
93
- */
94
- function create(opts) {
95
- const {
96
- container,
97
- renderItem
98
- } = opts;
99
-
100
- let itemHeight = opts.itemHeight;
101
- let total = opts.total;
102
- const overscan = (opts.overscan !== undefined) ? opts.overscan : 3;
103
- const mode = opts.mode || 'fixed';
104
-
105
- // Per-index height cache for variable mode.
106
- const heightCache = new Map();
107
- const DEFAULT_VARIABLE_HEIGHT = itemHeight || 40;
108
-
109
- // ── DOM structure ───────────────────────────────────────────────
110
- const spacer = document.createElement('div');
111
- spacer.style.position = 'relative';
112
-
113
- const layer = document.createElement('div');
114
- layer.style.position = 'absolute';
115
- layer.style.top = '0';
116
- layer.style.left = '0';
117
- layer.style.width = '100%';
118
-
119
- // @ts-ignore - element.style exists on HTMLElement; typed as Element here
120
- container.style.position = 'relative';
121
- // @ts-ignore - element.style exists on HTMLElement; typed as Element here
122
- container.style.overflow = 'auto';
123
- container.appendChild(spacer);
124
- container.appendChild(layer);
125
-
126
- // ── Helpers ─────────────────────────────────────────────────────
127
-
128
- function _totalHeight() {
129
- if (mode === 'fixed') {
130
- return total * itemHeight;
131
- }
132
- // Variable mode : estimated sum (partial cache + default).
133
- let h = 0;
134
- for (let i = 0; i < total; i++) {
135
- h += heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
136
- }
137
- return h;
138
- }
139
-
140
- function _offsetForIndex(idx) {
141
- if (mode === 'fixed') {
142
- return idx * itemHeight;
143
- }
144
- let h = 0;
145
- for (let i = 0; i < idx; i++) {
146
- h += heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
147
- }
148
- return h;
149
- }
150
-
151
- function _indexAtOffset(offset) {
152
- if (mode === 'fixed') {
153
- return Math.floor(offset / itemHeight);
154
- }
155
- let h = 0;
156
- for (let i = 0; i < total; i++) {
157
- const ih = heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
158
- h += ih;
159
- if (h > offset) return i;
160
- }
161
- return total - 1;
162
- }
163
-
164
- function _containerHeight() {
165
- const rect = container.getBoundingClientRect();
166
- return rect.height || container.clientHeight || 0;
167
- }
168
-
169
- function _computeRange() {
170
- const scrollTop = container.scrollTop || 0;
171
- const viewportH = _containerHeight();
172
- const start = Math.max(0, _indexAtOffset(scrollTop) - overscan);
173
- const endIdx = _indexAtOffset(scrollTop + viewportH);
174
- const end = Math.min(total - 1, endIdx + overscan);
175
- return { start, end };
176
- }
177
-
178
- function _renderItem(idx) {
179
- const result = renderItem(idx);
180
- if (result instanceof Element) {
181
- return result;
182
- }
183
- // elm-array: use dom.create when available, otherwise minimal fallback
184
- if (Array.isArray(result)) {
185
- if (dom && typeof dom.create === 'function') {
186
- return dom.create(result);
187
- }
188
- // Fallback : first array element if it is already an Element.
189
- if (result.length > 0 && result[0] instanceof Element) {
190
- return result[0];
191
- }
192
- }
193
- // Generic fallback.
194
- const span = document.createElement('span');
195
- span.textContent = String(idx);
196
- return span;
197
- }
198
-
199
- // ── Render ──────────────────────────────────────────────────────
200
-
201
- let _lastStart = -1;
202
- let _lastEnd = -1;
203
-
204
- function _doRender() {
205
- const { start, end } = _computeRange();
206
- if (start === _lastStart && end === _lastEnd) return;
207
- _lastStart = start;
208
- _lastEnd = end;
209
-
210
- // Update the spacer height
211
- spacer.style.height = _totalHeight() + 'px';
212
-
213
- // Position the layer at the offset of the first visible item
214
- const layerTop = _offsetForIndex(start);
215
- layer.style.top = layerTop + 'px';
216
-
217
- // Clear + re-render
218
- layer.textContent = '';
219
- for (let i = start; i <= end; i++) {
220
- const el = _renderItem(i);
221
- layer.appendChild(el);
222
- // Variable mode : only measure when the height is not
223
- // already cached. Re-measurement on every render is the
224
- // primary perf cost of variable mode ; caching by index
225
- // keeps the steady-state scroll free of reflows.
226
- if (mode === 'variable' && !heightCache.has(i)) {
227
- const measured = el.getBoundingClientRect().height;
228
- if (measured > 0) heightCache.set(i, measured);
229
- }
230
- }
231
- }
232
-
233
- // ── Scroll listener (passive) ─────────────────────────────────
234
- // Self-contained widget - direct addEventListener is sufficient ;
235
- // the matching removal happens in `dispose()`. No `events`
236
- // registry involvement.
237
-
238
- function _onScroll() {
239
- _doRender();
240
- }
241
-
242
- container.addEventListener('scroll', _onScroll, { passive: true });
243
-
244
- // Initial render
245
- _doRender();
246
-
247
- // ── Public API ───────────────────────────────────────────────────
248
-
249
- /**
250
- * Re-render the visible range (after a change in `total` or data).
251
- */
252
- function refresh() {
253
- _lastStart = -1;
254
- _lastEnd = -1;
255
- _doRender();
256
- }
257
-
258
- /**
259
- * Update the total item count and refresh.
260
- * @param {number} n - New total.
261
- */
262
- function setTotal(n) {
263
- total = n;
264
- // Variable mode : invalidate cache entries beyond the new total.
265
- if (mode === 'variable') {
266
- for (const k of heightCache.keys()) {
267
- if (k >= n) heightCache.delete(k);
268
- }
269
- }
270
- refresh();
271
- }
272
-
273
- /**
274
- * Programmatic scroll to an index.
275
- * @param {number} idx
276
- * @param {{ align?: 'start'|'center'|'end'|'auto' }} [scrollOpts]
277
- */
278
- function scrollTo(idx, scrollOpts) {
279
- const align = (scrollOpts && scrollOpts.align) || 'start';
280
- const offset = _offsetForIndex(idx);
281
- const viewportH = _containerHeight();
282
- let targetScroll;
283
-
284
- if (align === 'start' || align === 'auto') {
285
- targetScroll = offset;
286
- } else if (align === 'end') {
287
- const ih = mode === 'fixed' ? itemHeight
288
- : (heightCache.get(idx) || DEFAULT_VARIABLE_HEIGHT);
289
- targetScroll = offset + ih - viewportH;
290
- } else if (align === 'center') {
291
- const ih = mode === 'fixed' ? itemHeight
292
- : (heightCache.get(idx) || DEFAULT_VARIABLE_HEIGHT);
293
- targetScroll = offset - (viewportH / 2) + (ih / 2);
294
- } else {
295
- targetScroll = offset;
296
- }
297
-
298
- container.scrollTop = Math.max(0, targetScroll);
299
- _doRender();
300
- }
301
-
302
- /**
303
- * Return the currently visible index range.
304
- * @returns {{ start: number, end: number }}
305
- */
306
- function visibleRange() {
307
- return _computeRange();
308
- }
309
-
310
- /**
311
- * Return the measured height of an item (variable mode).
312
- * In fixed mode returns `itemHeight`. In variable mode returns
313
- * the cached measurement when present, otherwise the default
314
- * estimate (caller cannot tell the two apart - wrap with `has`
315
- * when needed).
316
- * @param {number} idx
317
- * @returns {number}
318
- */
319
- function measure(idx) {
320
- if (mode === 'fixed') return itemHeight;
321
- return heightCache.has(idx) ? heightCache.get(idx) : DEFAULT_VARIABLE_HEIGHT;
322
- }
323
-
324
- /**
325
- * Detach listeners and clear the layer.
326
- */
327
- function dispose() {
328
- // @ts-ignore - passive option is standard; TS keyof ElementEventMap too narrow
329
- container.removeEventListener('scroll', _onScroll, { passive: true });
330
- layer.textContent = '';
331
- if (spacer.parentNode === container) container.removeChild(spacer);
332
- if (layer.parentNode === container) container.removeChild(layer);
333
- heightCache.clear();
334
- }
335
-
336
- return { refresh, setTotal, scrollTo, visibleRange, measure, dispose };
337
- }
338
-
339
- return { create };
340
- }
341
- };
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @description
7
+ * Virtualised list for rendering collections of 10^4 to 10^6 items without
8
+ * prohibitive memory / CPU cost. Only visible items plus a configurable
9
+ * overscan are materialised in the DOM.
10
+ *
11
+ * Two modes :
12
+ * - `fixed` (MVP, default) : fixed `itemHeight` in px - O(1) range computation,
13
+ * no DOM measurement.
14
+ * - `variable` : heights measured on the fly and cached in a `Map<idx, height>`.
15
+ * Heights are only re-measured when a previously-unseen index is rendered ;
16
+ * `setTotal` invalidates the cache beyond the given index.
17
+ *
18
+ * DOM structure :
19
+ * ```
20
+ * container (overflow: auto)
21
+ * ├─ spacer (height = total * itemHeight in fixed mode)
22
+ * └─ layer (position: absolute; top: scrollTop-adjusted)
23
+ * └─ rendered items (overscan included)
24
+ * ```
25
+ *
26
+ * `renderItem(idx)` may return an `HTMLElement` or an elm-array compatible
27
+ * with `dom` / `template`.
28
+ *
29
+ * Out of scope for MVP : node recycling, sticky headers, horizontal axes.
30
+ *
31
+ * The scroll listener is bound directly on the container via `addEventListener`
32
+ * (single owner, lifecycle handled by `dispose()`) - no dependency on the
33
+ * `events` registry.
34
+ *
35
+ * @example
36
+ * const vs = runtime.resolve('virtualScroll');
37
+ * const list = vs.create({
38
+ * container: document.getElementById('list'),
39
+ * itemHeight: 32,
40
+ * total: 50000,
41
+ * renderItem(idx) {
42
+ * const li = document.createElement('li');
43
+ * li.textContent = `Item ${idx}`;
44
+ * return li;
45
+ * }
46
+ * });
47
+ * list.scrollTo(1000);
48
+ * list.dispose();
49
+ */
50
+ import { dom } from '../query/dom.js';
51
+
52
+ /**
53
+ * A virtualised-list instance returned by `create()`.
54
+ * @typedef {object} VirtualScrollInstance
55
+ * @property {() => void} refresh - Re-render the visible range after a data/total change.
56
+ * @property {(n: number) => void} setTotal - Update the total item count and refresh.
57
+ * @property {(idx: number, scrollOpts?: {align?: 'start'|'center'|'end'|'auto'}) => void} scrollTo - Programmatically scroll to an index.
58
+ * @property {() => {start: number, end: number}} visibleRange - Return the currently visible index range.
59
+ * @property {(idx: number) => number} measure - Return the (measured or estimated) height of an item.
60
+ * @property {() => void} dispose - Detach listeners and clear the layer.
61
+ */
62
+
63
+ /**
64
+ * Virtualised-list surface returned by `factory()`.
65
+ * @typedef {object} VirtualScrollAPI
66
+ * @property {(opts: {container: Element, itemHeight: number, total: number, renderItem: (idx: number) => (Element|Array), overscan?: number, mode?: 'fixed'|'variable'}) => VirtualScrollInstance} create - Create a virtualised-list instance.
67
+ */
68
+
69
+ export const virtualScroll = {
70
+ name: 'virtualScroll',
71
+ version: '1.1.0',
72
+ type: 'fw.dom.rendering',
73
+ dependencies: ['dom'],
74
+ deps: [dom],
75
+
76
+ /**
77
+ * @param {Object} dom - Resolved `dom` module instance.
78
+ * @returns {VirtualScrollAPI}
79
+ */
80
+ factory(dom) {
81
+
82
+ /**
83
+ * Create a virtualised-list instance.
84
+ *
85
+ * @param {Object} opts
86
+ * @param {Element} opts.container - Scrollable element (overflow: auto).
87
+ * @param {number} opts.itemHeight - Item height in px (fixed mode).
88
+ * @param {number} opts.total - Total item count.
89
+ * @param {Function} opts.renderItem - `(idx) → HTMLElement | ElmNode[]`
90
+ * @param {number} [opts.overscan=3] - Extra items rendered above/below the viewport.
91
+ * @param {'fixed'|'variable'} [opts.mode='fixed'] - Height computation mode.
92
+ * @returns {{ refresh, setTotal, scrollTo, visibleRange, measure, dispose }}
93
+ */
94
+ function create(opts) {
95
+ const {
96
+ container,
97
+ renderItem
98
+ } = opts;
99
+
100
+ let itemHeight = opts.itemHeight;
101
+ let total = opts.total;
102
+ const overscan = (opts.overscan !== undefined) ? opts.overscan : 3;
103
+ const mode = opts.mode || 'fixed';
104
+
105
+ // Per-index height cache for variable mode.
106
+ const heightCache = new Map();
107
+ const DEFAULT_VARIABLE_HEIGHT = itemHeight || 40;
108
+
109
+ // ── DOM structure ───────────────────────────────────────────────
110
+ const spacer = document.createElement('div');
111
+ spacer.style.position = 'relative';
112
+
113
+ const layer = document.createElement('div');
114
+ layer.style.position = 'absolute';
115
+ layer.style.top = '0';
116
+ layer.style.left = '0';
117
+ layer.style.width = '100%';
118
+
119
+ // @ts-ignore - element.style exists on HTMLElement; typed as Element here
120
+ container.style.position = 'relative';
121
+ // @ts-ignore - element.style exists on HTMLElement; typed as Element here
122
+ container.style.overflow = 'auto';
123
+ container.appendChild(spacer);
124
+ container.appendChild(layer);
125
+
126
+ // ── Helpers ─────────────────────────────────────────────────────
127
+
128
+ function _totalHeight() {
129
+ if (mode === 'fixed') {
130
+ return total * itemHeight;
131
+ }
132
+ // Variable mode : estimated sum (partial cache + default).
133
+ let h = 0;
134
+ for (let i = 0; i < total; i++) {
135
+ h += heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
136
+ }
137
+ return h;
138
+ }
139
+
140
+ function _offsetForIndex(idx) {
141
+ if (mode === 'fixed') {
142
+ return idx * itemHeight;
143
+ }
144
+ let h = 0;
145
+ for (let i = 0; i < idx; i++) {
146
+ h += heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
147
+ }
148
+ return h;
149
+ }
150
+
151
+ function _indexAtOffset(offset) {
152
+ if (mode === 'fixed') {
153
+ return Math.floor(offset / itemHeight);
154
+ }
155
+ let h = 0;
156
+ for (let i = 0; i < total; i++) {
157
+ const ih = heightCache.has(i) ? heightCache.get(i) : DEFAULT_VARIABLE_HEIGHT;
158
+ h += ih;
159
+ if (h > offset) return i;
160
+ }
161
+ return total - 1;
162
+ }
163
+
164
+ function _containerHeight() {
165
+ const rect = container.getBoundingClientRect();
166
+ return rect.height || container.clientHeight || 0;
167
+ }
168
+
169
+ function _computeRange() {
170
+ const scrollTop = container.scrollTop || 0;
171
+ const viewportH = _containerHeight();
172
+ const start = Math.max(0, _indexAtOffset(scrollTop) - overscan);
173
+ const endIdx = _indexAtOffset(scrollTop + viewportH);
174
+ const end = Math.min(total - 1, endIdx + overscan);
175
+ return { start, end };
176
+ }
177
+
178
+ function _renderItem(idx) {
179
+ const result = renderItem(idx);
180
+ if (result instanceof Element) {
181
+ return result;
182
+ }
183
+ // elm-array: use dom.create when available, otherwise minimal fallback
184
+ if (Array.isArray(result)) {
185
+ if (dom && typeof dom.create === 'function') {
186
+ return dom.create(result);
187
+ }
188
+ // Fallback : first array element if it is already an Element.
189
+ if (result.length > 0 && result[0] instanceof Element) {
190
+ return result[0];
191
+ }
192
+ }
193
+ // Generic fallback.
194
+ const span = document.createElement('span');
195
+ span.textContent = String(idx);
196
+ return span;
197
+ }
198
+
199
+ // ── Render ──────────────────────────────────────────────────────
200
+
201
+ let _lastStart = -1;
202
+ let _lastEnd = -1;
203
+
204
+ function _doRender() {
205
+ const { start, end } = _computeRange();
206
+ if (start === _lastStart && end === _lastEnd) return;
207
+ _lastStart = start;
208
+ _lastEnd = end;
209
+
210
+ // Update the spacer height
211
+ spacer.style.height = _totalHeight() + 'px';
212
+
213
+ // Position the layer at the offset of the first visible item
214
+ const layerTop = _offsetForIndex(start);
215
+ layer.style.top = layerTop + 'px';
216
+
217
+ // Clear + re-render
218
+ layer.textContent = '';
219
+ for (let i = start; i <= end; i++) {
220
+ const el = _renderItem(i);
221
+ layer.appendChild(el);
222
+ // Variable mode : only measure when the height is not
223
+ // already cached. Re-measurement on every render is the
224
+ // primary perf cost of variable mode ; caching by index
225
+ // keeps the steady-state scroll free of reflows.
226
+ if (mode === 'variable' && !heightCache.has(i)) {
227
+ const measured = el.getBoundingClientRect().height;
228
+ if (measured > 0) heightCache.set(i, measured);
229
+ }
230
+ }
231
+ }
232
+
233
+ // ── Scroll listener (passive) ─────────────────────────────────
234
+ // Self-contained widget - direct addEventListener is sufficient ;
235
+ // the matching removal happens in `dispose()`. No `events`
236
+ // registry involvement.
237
+
238
+ function _onScroll() {
239
+ _doRender();
240
+ }
241
+
242
+ container.addEventListener('scroll', _onScroll, { passive: true });
243
+
244
+ // Initial render
245
+ _doRender();
246
+
247
+ // ── Public API ───────────────────────────────────────────────────
248
+
249
+ /**
250
+ * Re-render the visible range (after a change in `total` or data).
251
+ */
252
+ function refresh() {
253
+ _lastStart = -1;
254
+ _lastEnd = -1;
255
+ _doRender();
256
+ }
257
+
258
+ /**
259
+ * Update the total item count and refresh.
260
+ * @param {number} n - New total.
261
+ */
262
+ function setTotal(n) {
263
+ total = n;
264
+ // Variable mode : invalidate cache entries beyond the new total.
265
+ if (mode === 'variable') {
266
+ for (const k of heightCache.keys()) {
267
+ if (k >= n) heightCache.delete(k);
268
+ }
269
+ }
270
+ refresh();
271
+ }
272
+
273
+ /**
274
+ * Programmatic scroll to an index.
275
+ * @param {number} idx
276
+ * @param {{ align?: 'start'|'center'|'end'|'auto' }} [scrollOpts]
277
+ */
278
+ function scrollTo(idx, scrollOpts) {
279
+ const align = (scrollOpts && scrollOpts.align) || 'start';
280
+ const offset = _offsetForIndex(idx);
281
+ const viewportH = _containerHeight();
282
+ let targetScroll;
283
+
284
+ if (align === 'start' || align === 'auto') {
285
+ targetScroll = offset;
286
+ } else if (align === 'end') {
287
+ const ih = mode === 'fixed' ? itemHeight
288
+ : (heightCache.get(idx) || DEFAULT_VARIABLE_HEIGHT);
289
+ targetScroll = offset + ih - viewportH;
290
+ } else if (align === 'center') {
291
+ const ih = mode === 'fixed' ? itemHeight
292
+ : (heightCache.get(idx) || DEFAULT_VARIABLE_HEIGHT);
293
+ targetScroll = offset - (viewportH / 2) + (ih / 2);
294
+ } else {
295
+ targetScroll = offset;
296
+ }
297
+
298
+ container.scrollTop = Math.max(0, targetScroll);
299
+ _doRender();
300
+ }
301
+
302
+ /**
303
+ * Return the currently visible index range.
304
+ * @returns {{ start: number, end: number }}
305
+ */
306
+ function visibleRange() {
307
+ return _computeRange();
308
+ }
309
+
310
+ /**
311
+ * Return the measured height of an item (variable mode).
312
+ * In fixed mode returns `itemHeight`. In variable mode returns
313
+ * the cached measurement when present, otherwise the default
314
+ * estimate (caller cannot tell the two apart - wrap with `has`
315
+ * when needed).
316
+ * @param {number} idx
317
+ * @returns {number}
318
+ */
319
+ function measure(idx) {
320
+ if (mode === 'fixed') return itemHeight;
321
+ return heightCache.has(idx) ? heightCache.get(idx) : DEFAULT_VARIABLE_HEIGHT;
322
+ }
323
+
324
+ /**
325
+ * Detach listeners and clear the layer.
326
+ */
327
+ function dispose() {
328
+ // @ts-ignore - passive option is standard; TS keyof ElementEventMap too narrow
329
+ container.removeEventListener('scroll', _onScroll, { passive: true });
330
+ layer.textContent = '';
331
+ if (spacer.parentNode === container) container.removeChild(spacer);
332
+ if (layer.parentNode === container) container.removeChild(layer);
333
+ heightCache.clear();
334
+ }
335
+
336
+ return { refresh, setTotal, scrollTo, visibleRange, measure, dispose };
337
+ }
338
+
339
+ return { create };
340
+ }
341
+ };