@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,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -49,8 +49,12 @@
49
49
  * Scoped CSS : `spec.css` is injected **once per define()** into the page's
50
50
  * `<head>`. Inside the CSS, `&` is rewritten to the unique scope class
51
51
  * generated for the blueprint (`.fw-comp-N`). The scope class is added to
52
- * every instance's root element automatically. CSP nonce is auto-detected
53
- * from `<meta name="csp-nonce">` and applied to the injected `<style>`.
52
+ * every instance's root element automatically. The CSS goes through the
53
+ * `styleSheet` module: in its default mode a `<style data-fw-component>`
54
+ * element is added to `<head>` (CSP nonce auto-detected from
55
+ * `<meta name="csp-nonce">` and applied to it); under
56
+ * `styleSheet.mode('adopted')` no `<style>` element is created, the CSS is
57
+ * attached as a constructable stylesheet.
54
58
  *
55
59
  * Props shape : `self.props` always holds the **transformed** shape (the
56
60
  * exact data the DOM template was bound against). The original validated
@@ -63,9 +67,8 @@
63
67
  * automatically re-write the DOM from the new props — re-binding is left to the
64
68
  * hook. Wire the changed fields explicitly in `update(self, prev)` via
65
69
  * `self.text(...)` / `self.attr(...)` (or a `reactiveBind` set up in `mount`).
66
- * (Clarified 2026-06-30 from the `@awacloud/ui-templates` W0 dual-form spike, which
67
- * measured this behaviour; `component.js` is not yet field-tested — see
68
- * `ai/plans/ui-templates`.)
70
+ * (Measured 2026-06-30 while building `@awacloud/ui-templates`' dual-form
71
+ * components.)
69
72
  *
70
73
  */
71
74
 
@@ -96,16 +99,17 @@
96
99
  */
97
100
 
98
101
  import { reactiveBind } from './reactiveBind.js';
102
+ import { styleSheet } from './styleSheet.js';
99
103
 
100
104
  export const component = {
101
105
  name: 'component',
102
106
  version: '1.3.0',
103
107
  type: 'fw.dom.rendering',
104
- dependencies: ['reactiveBind'],
105
- deps: [reactiveBind],
108
+ dependencies: ['reactiveBind', 'styleSheet'],
109
+ deps: [reactiveBind, styleSheet],
106
110
 
107
111
  /** @returns {ComponentAPI} */
108
- factory(reactiveBind) {
112
+ factory(reactiveBind, styleSheet) {
109
113
 
110
114
  // Shared counter for scope class names across all `define()` calls.
111
115
  let _scopeSeq = 0;
@@ -198,7 +202,7 @@ export const component = {
198
202
  * are resolved iteratively until no `&` remains.
199
203
  *
200
204
  * The function does NOT parse full CSS — it operates with targeted
201
- * regexes that cover the patterns documented in the plan. Corner-cases
205
+ * regexes that cover the documented patterns. Corner-cases
202
206
  * involving `&` inside attribute selectors or string values are
203
207
  * intentionally out-of-scope.
204
208
  *
@@ -270,10 +274,12 @@ export const component = {
270
274
  }
271
275
 
272
276
  /**
273
- * Inject a `<style>` block scoped to `scopeClass`. User CSS uses `&`
274
- * to refer to the scope ; we rewrite to `.<scopeClass>` so the result
275
- * is plain CSS understood by all browsers (no nesting requirement).
276
- * Extended to handle nested `&`, `:global(sel)` and `@keyframes`.
277
+ * Inject the CSS scoped to `scopeClass` through `styleSheet`. User CSS
278
+ * uses `&` to refer to the scope ; we rewrite to `.<scopeClass>` so the
279
+ * result is plain CSS understood by all browsers (no nesting
280
+ * requirement). Extended to handle nested `&`, `:global(sel)` and
281
+ * `@keyframes`. Under `styleSheet.mode('adopted')` no `<style>` element
282
+ * is created (a constructable stylesheet is attached instead).
277
283
  */
278
284
  function _injectScopedCss(cssSource, scopeClass) {
279
285
  if (typeof document === 'undefined') return;
@@ -283,6 +289,11 @@ export const component = {
283
289
  if (_injectedScopes.has(scopeClass)) return;
284
290
  _injectedScopes.add(scopeClass);
285
291
  const scoped = _rewriteCss(cssSource, scopeClass);
292
+ if (styleSheet) {
293
+ styleSheet.attach(scoped, { attrs: { 'data-fw-component': scopeClass }, nonce: _cspNonce });
294
+ return;
295
+ }
296
+ // hand-wired without styleSheet: the element path, as before
286
297
  const styleEl = document.createElement('style');
287
298
  styleEl.textContent = scoped;
288
299
  styleEl.setAttribute('data-fw-component', scopeClass);
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -251,7 +251,7 @@ export const devtools = {
251
251
  // descriptors (`src/core/runtime.js`) — so `_clock` here already IS
252
252
  // the `ClockAPI` object (`{ now, monotonic, since, iso, format }`),
253
253
  // not `clock` the module. Call `monotonic()` on it directly; no
254
- // `.factory()` hop (BL-466 — that hop TypeError'd on the canonical
254
+ // `.factory()` hop (that hop threw a TypeError on the canonical
255
255
  // `runtime.resolve('devtools')` path, e.g. sde-core's taskmgr).
256
256
 
257
257
  /**
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -105,6 +105,22 @@
105
105
  * and non-string entries are ignored. Supplying the option BYPASSES the
106
106
  * source-keyed `ParseResult` cache (read and write): the reservation changes
107
107
  * which ids are minted, so a cached entry would violate the contract.
108
+ * @property {SharedParseCache} [cache] - A cache from `createCache`, shared
109
+ * by any number of parser instances, used INSTEAD of this instance's own.
110
+ * It is transparent: a hit returns exactly what a fresh parse on this
111
+ * instance would, auto ids re-minted by this instance's counter.
112
+ */
113
+
114
+ /**
115
+ * A parse cache shared across parser instances (`parser.createCache`). The
116
+ * underscored members are the parser's internal protocol.
117
+ *
118
+ * @typedef {Object} SharedParseCache
119
+ * @property {() => number} size - Entries held.
120
+ * @property {() => void} clear - Drop every entry and reset the counters.
121
+ * @property {() => {hits: number, misses: number, evictions: number, size: number, max: number}} stats - Counters.
122
+ * @property {(key: string) => (object|undefined)} _get
123
+ * @property {(key: string, entry: object) => void} _set
108
124
  */
109
125
 
110
126
  /**
@@ -114,6 +130,7 @@
114
130
  * @property {(htmlString: string, options?: FromHTMLOptions) => ParseResult} fromHTML - Parse HTML to a (cached) {@link ParseResult}.
115
131
  * @property {(input: ElmNode[]|ParseResult) => string} toHTML - Serialise an elm array / ParseResult back to HTML.
116
132
  * @property {ParserCache} cache - Manual cache controls.
133
+ * @property {(opts?: {max?: number}) => SharedParseCache} createCache - A cache several instances share through `fromHTML(html, { cache })`.
117
134
  */
118
135
 
119
136
  import { secPolicy } from './secPolicy.js';
@@ -186,6 +203,14 @@ export const parser = {
186
203
  return el;
187
204
  }
188
205
  function _makeText(value) { return { nodeType: NODE_TEXT, nodeValue: value }; }
206
+
207
+ /** Phrasing elements whose neighbouring whitespace renders as a space. */
208
+ const INLINE_TAGS = new Set(['a', 'abbr', 'b', 'bdi', 'bdo', 'br', 'cite', 'code', 'data', 'dfn', 'em', 'i',
209
+ 'img', 'kbd', 'label', 'mark', 'q', 's', 'samp', 'small', 'span', 'strong', 'sub', 'sup', 'time', 'u',
210
+ 'var', 'wbr', 'button', 'input', 'select', 'textarea', 'output', 'svg']);
211
+ function _isInlineElement(n) {
212
+ return !!n && n.nodeType === NODE_ELEMENT && INLINE_TAGS.has(String(n.tagName).toLowerCase());
213
+ }
189
214
  function _makeComment(value) { return { nodeType: NODE_COMMENT, nodeValue: value }; }
190
215
 
191
216
  // Parse an opening tag starting at `pos` (which points to '<').
@@ -364,6 +389,11 @@ export const parser = {
364
389
 
365
390
  let _seq = 0;
366
391
 
392
+ /** Ids `nextId` mints while a recorded parse runs (shared cache), else null. @type {string[]|null} */
393
+ let _mintLog = null;
394
+ /** The explicit ids of the document `_fromHTMLImpl` parsed last. @type {Set<string>} */
395
+ let _lastExplicit = new Set();
396
+
367
397
  /**
368
398
  * Explicit ids reserved for the WHOLE parser instance: every explicit id
369
399
  * seen by a previous `fromHTML` call, plus every id a caller declared up
@@ -428,6 +458,7 @@ export const parser = {
428
458
  while ((reserved && reserved.has(id)) || _reservedAll.has(id)) {
429
459
  id = 'p' + (_seq++);
430
460
  }
461
+ if (_mintLog) _mintLog.push(id);
431
462
  return id;
432
463
  };
433
464
 
@@ -818,6 +849,7 @@ export const parser = {
818
849
  // that an auto-minted `pN` never collides with an explicit `pN` —
819
850
  // including one that only appears further down the tree.
820
851
  const reserved = collectExplicitIds(rootNode);
852
+ _lastExplicit = new Set(reserved);
821
853
  // Cross-call layers, both applied BEFORE the walk as well:
822
854
  // - ids the caller declared up front for the whole assembled
823
855
  // document (covers explicit ids this instance has not met yet);
@@ -932,15 +964,30 @@ export const parser = {
932
964
  // Non-empty text nodes that live alongside element siblings
933
965
  // cannot be represented as elm.text; they become synthetic
934
966
  // child elements instead.
935
- plainKids.forEach(c => {
967
+ plainKids.forEach((c, k) => {
936
968
  if (c.nodeType === NODE_ELEMENT) {
937
969
  walkElement(c, id, out);
938
970
 
939
971
  } else if (c.nodeType === NODE_TEXT) {
940
- const rawText = c.nodeValue.trim();
941
- if (!rawText) return; // whitespace-only → skip
972
+ // A text node keeps the boundary space an inline
973
+ // sibling renders (BL-2374, D9 G7): `or <b>this</b>`
974
+ // keeps "or ". A whitespace-only node is still
975
+ // skipped — a synthetic text node renders as a
976
+ // <span>, so keeping it would add an element to the
977
+ // DOM; beside block elements and at the parent's
978
+ // edges whitespace is dropped, as rendering does.
979
+ const raw = c.nodeValue;
980
+ const trimmed = raw.trim();
981
+ if (!trimmed) return; // whitespace-only → skip
982
+ const prevInline = _isInlineElement(plainKids[k - 1]);
983
+ const nextInline = _isInlineElement(plainKids[k + 1]);
984
+ let rawText = trimmed;
985
+ {
986
+ if (prevInline && /^\s/.test(raw)) rawText = ' ' + rawText;
987
+ if (nextInline && /\s$/.test(raw)) rawText = rawText + ' ';
988
+ }
942
989
 
943
- const slotM = rawText.match(RE_SLOT);
990
+ const slotM = trimmed.match(RE_SLOT);
944
991
  if (slotM) {
945
992
  // ${slot} text node with element siblings → <span>
946
993
  // (the memo rule: "has neighbours → span tag")
@@ -998,10 +1045,11 @@ export const parser = {
998
1045
  };
999
1046
 
1000
1047
  /**
1001
- * Cached `fromHTML` : returns the same ParseResult for identical input
1002
- * strings. The cached object is a frozen reference - callers that need
1003
- * to mutate it should clone first. Cache is bounded; oldest entries are
1004
- * evicted on overflow.
1048
+ * Cached `fromHTML` : identical input strings are parsed once. Every
1049
+ * call returns its own deep copy of the cached ParseResult (hit or
1050
+ * miss), so a caller may mutate what it gets without reaching the cache
1051
+ * or any other caller. Cache is bounded; oldest entries are evicted on
1052
+ * overflow.
1005
1053
  *
1006
1054
  * Supplying `options.reserveIds` BYPASSES the cache in both directions:
1007
1055
  * the reservation changes which auto ids are minted, so a hit keyed on
@@ -1023,13 +1071,108 @@ export const parser = {
1023
1071
  if (reserveIdsInput !== undefined && reserveIdsInput !== null) {
1024
1072
  return _fromHTMLImpl(htmlString, reserveIdsInput);
1025
1073
  }
1074
+ const shared = options ? options.cache : undefined;
1075
+ if (shared && typeof shared._get === 'function') return _fromShared(htmlString, shared);
1026
1076
  const cached = _cacheGet(htmlString);
1027
- if (cached !== undefined) return cached;
1077
+ if (cached !== undefined) return _cloneResult(cached);
1028
1078
  const result = _fromHTMLImpl(htmlString);
1029
1079
  _cacheSet(htmlString, result);
1030
- return result;
1080
+ return _cloneResult(result);
1031
1081
  };
1032
1082
 
1083
+ /**
1084
+ * `fromHTML` through a shared cache. An entry keeps the result, the
1085
+ * auto ids in mint order and the document's explicit ids. A hit does
1086
+ * what a parse does to this instance — the explicit ids join the
1087
+ * instance set, then every auto id is minted by this instance's own
1088
+ * `nextId` in the original order — and rewrites `id` / `parent` in a
1089
+ * copy, so it returns exactly what a fresh parse would. The key carries
1090
+ * the parse path: DOMParser and the internal tokenizer may build
1091
+ * different trees from one source.
1092
+ *
1093
+ * @param {string} htmlString
1094
+ * @param {SharedParseCache} shared
1095
+ * @returns {ParseResult}
1096
+ */
1097
+ function _fromShared(htmlString, shared) {
1098
+ const key = (typeof DOMParser !== 'undefined' ? 'd:' : 't:') + htmlString;
1099
+ const entry = shared._get(key);
1100
+ if (entry === undefined) {
1101
+ _mintLog = [];
1102
+ let result;
1103
+ try {
1104
+ result = _fromHTMLImpl(htmlString);
1105
+ shared._set(key, { result, minted: _mintLog, explicit: Array.from(_lastExplicit) });
1106
+ } finally {
1107
+ _mintLog = null;
1108
+ }
1109
+ return _cloneResult(result);
1110
+ }
1111
+ for (const id of entry.explicit) _reservedAll.add(id);
1112
+ const reserved = new Set(entry.explicit);
1113
+ const remap = new Map();
1114
+ for (const old of entry.minted) remap.set(old, nextId(reserved));
1115
+ const copy = _cloneResult(entry.result);
1116
+ const rewrite = (elms) => {
1117
+ for (const elm of elms) {
1118
+ if (remap.has(elm.id)) elm.id = remap.get(elm.id);
1119
+ if (elm.parent !== undefined && remap.has(elm.parent)) elm.parent = remap.get(elm.parent);
1120
+ }
1121
+ };
1122
+ rewrite(copy.template);
1123
+ if (copy.iterates) for (const name of Object.keys(copy.iterates)) rewrite(copy.iterates[name]);
1124
+ return copy;
1125
+ }
1126
+
1127
+ /**
1128
+ * A parse cache several parser instances share (`fromHTML(html, { cache })`).
1129
+ * Bounded like the instance cache: the oldest entry goes on overflow.
1130
+ *
1131
+ * @param {{max?: number}} [opts] - `max` entries (default 64; 0 disables).
1132
+ * @returns {SharedParseCache}
1133
+ */
1134
+ function createCache(opts) {
1135
+ const max = Math.max(0, (opts && opts.max !== undefined ? opts.max : 64) | 0);
1136
+ const map = new Map();
1137
+ const st = { hits: 0, misses: 0, evictions: 0 };
1138
+ return {
1139
+ size() { return map.size; },
1140
+ clear() { map.clear(); st.hits = 0; st.misses = 0; st.evictions = 0; },
1141
+ stats() { return { ...st, size: map.size, max }; },
1142
+ _get(key) {
1143
+ if (max === 0) return undefined;
1144
+ const hit = map.get(key);
1145
+ if (hit === undefined) { st.misses++; return undefined; }
1146
+ map.delete(key); map.set(key, hit);
1147
+ st.hits++;
1148
+ return hit;
1149
+ },
1150
+ _set(key, entry) {
1151
+ if (max === 0) return;
1152
+ if (map.size >= max) { map.delete(map.keys().next().value); st.evictions++; }
1153
+ map.set(key, entry);
1154
+ },
1155
+ };
1156
+ }
1157
+
1158
+ /**
1159
+ * Deep copy of a ParseResult: plain objects, arrays and primitives only
1160
+ * (what the parser produces). About an order of magnitude cheaper than
1161
+ * the parse it replaces on a hit.
1162
+ *
1163
+ * @param {*} v
1164
+ * @returns {*}
1165
+ */
1166
+ function _cloneResult(v) {
1167
+ if (Array.isArray(v)) return v.map(_cloneResult);
1168
+ if (v !== null && typeof v === 'object') {
1169
+ const out = {};
1170
+ for (const k of Object.keys(v)) out[k] = _cloneResult(v[k]);
1171
+ return out;
1172
+ }
1173
+ return v;
1174
+ }
1175
+
1033
1176
  /**
1034
1177
  * Manual cache controls (test / power-user).
1035
1178
  */
@@ -1050,6 +1193,6 @@ export const parser = {
1050
1193
  stats() { return { ..._cacheStats, size: _cacheMap.size, max: _cacheMax }; },
1051
1194
  };
1052
1195
 
1053
- return { fromHTML, toHTML, cache };
1196
+ return { fromHTML, toHTML, cache, createCache };
1054
1197
  }
1055
1198
  };
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -478,8 +478,10 @@ export const render = {
478
478
  * @param {ElmNode} elm - Bound elm node (data/text already applied).
479
479
  * @param {Map} kidsByParent - Map<parentId, ElmNode[]>.
480
480
  * @param {Object} opts - SSR options (slots, iterates, hydrate, idPrefix).
481
+ * @param {number} [rowIndex] - Set on the root(s) of an iterate row:
482
+ * its 0-based index, emitted as `data-fw-row` when hydrating.
481
483
  */
482
- function _ssrNode(elm, kidsByParent, opts) {
484
+ function _ssrNode(elm, kidsByParent, opts, rowIndex) {
483
485
  const outTag = _ssrTagFor(elm.tag);
484
486
  const isVoid = VOID_TAGS_SSR.has(outTag);
485
487
 
@@ -504,6 +506,12 @@ export const render = {
504
506
  const id = opts.idPrefix ? opts.idPrefix + ':' + elm.id : elm.id;
505
507
  parts.push(' data-fw-id="' + _ssrEscape(id) + '"');
506
508
  }
509
+ // Rows of an iterate block share their parser ids (UIList.adopt
510
+ // finds each node inside its own row); the index makes a row
511
+ // addressable on its own.
512
+ if (opts.hydrate && rowIndex !== undefined) {
513
+ parts.push(' data-fw-row="' + rowIndex + '"');
514
+ }
507
515
 
508
516
  const openTag = '<' + outTag + parts.join('');
509
517
 
@@ -529,7 +537,7 @@ export const render = {
529
537
  const bound = elms(subTpl, rowData);
530
538
  const bIdx = _ssrIndex(bound);
531
539
  for (const root of bIdx.roots) {
532
- lines.push(_ssrNode(root, bIdx.kids, opts));
540
+ lines.push(_ssrNode(root, bIdx.kids, opts, i));
533
541
  }
534
542
  }
535
543
  body = lines.join('');
@@ -564,7 +572,9 @@ export const render = {
564
572
  * optional `iterates`) or a raw elm-array.
565
573
  * @param {Object} [data] - Variable bindings for `#{var}`.
566
574
  * @param {Object} [opts]
567
- * @param {boolean} [opts.hydrate=true] - Emit `data-fw-id` markers.
575
+ * @param {boolean} [opts.hydrate=true] - Emit `data-fw-id` markers, and
576
+ * `data-fw-row="<i>"` on the root(s) of each iterate row (the rows
577
+ * share their `data-fw-id` values; the index addresses one row).
568
578
  * @param {string} [opts.idPrefix] - Namespace prefix for `data-fw-id`,
569
579
  * useful when multiple SSR blocks coexist on one page.
570
580
  * @param {Object<string,string|Function>} [opts.slots] - Map of
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -38,6 +38,7 @@
38
38
  * @property {Record<string, Set<string>>} [allowedAttributes]
39
39
  * @property {string[]} [urlSchemes]
40
40
  * @property {boolean} [dropDangerousContent=true]
41
+ * @property {boolean} [allowDataImage=false] - keep `data:image/*` on `<img src>` only.
41
42
  */
42
43
 
43
44
  import { secPolicy } from './secPolicy.js';
@@ -212,9 +213,11 @@ export const sanitize = {
212
213
  if (!isAttrAllowed(name, tag, al)) continue;
213
214
  let value = attrs[name];
214
215
  // URL attributes: enforce scheme allowlist.
215
- // data: image URLs are blocked by default; caller can opt-in via opts.allowDataImage.
216
+ // A data:image/* URL passes only on <img src> under opts.allowDataImage
217
+ // (an image element runs no script); href and any other src never take data:.
216
218
  if (name === 'href' || name === 'src') {
217
- if (!isSafeUrl(value, schemes, false)) continue;
219
+ const dataImage = al.allowDataImage && tag === 'img' && name === 'src';
220
+ if (!isSafeUrl(value, schemes, dataImage)) continue;
218
221
  }
219
222
  // Sanitize value: strip angle brackets and quotes to prevent injection.
220
223
  value = String(value).replace(/[<>"]/g, '').replace(/\s+/g, ' ').trim();
@@ -268,6 +271,9 @@ export const sanitize = {
268
271
  * @param {string[]} [opts.urlSchemes] - override allowed URL schemes.
269
272
  * @param {boolean} [opts.dropDangerousContent=true] - strip inner content of
270
273
  * dangerous tags (script, iframe, style…).
274
+ * @param {boolean} [opts.allowDataImage=false] - keep a `data:image/*` URL
275
+ * (`secPolicy.DATA_IMAGE_RE` types) on `<img src>` only; `href` and
276
+ * every other element's `src` still drop any `data:` URL.
271
277
  * @returns {string}
272
278
  */
273
279
  function sanitizeHtml(html, opts) {
@@ -290,7 +296,8 @@ export const sanitize = {
290
296
  attributes: (opts && opts.allowedAttributes !== undefined)
291
297
  ? opts.allowedAttributes
292
298
  : DEFAULT_ATTRIBUTES,
293
- urlSchemes: (opts && opts.urlSchemes) ? opts.urlSchemes : DEFAULT_URL_SCHEMES
299
+ urlSchemes: (opts && opts.urlSchemes) ? opts.urlSchemes : DEFAULT_URL_SCHEMES,
300
+ allowDataImage: opts ? opts.allowDataImage === true : false
294
301
  };
295
302
  const dropDangerous = !(opts && opts.dropDangerousContent === false);
296
303
 
@@ -1,4 +1,4 @@
1
- // Copyright (c) 2026 AwaCloud SAS
1
+ // Copyright (c) 2026 AwaCloud SAS
2
2
  // Author: Matthieu Bouilloux
3
3
  // SPDX-License-Identifier: Apache-2.0
4
4
 
@@ -93,9 +93,11 @@ export const secPolicy = {
93
93
 
94
94
  /**
95
95
  * Accepted `data:image/*` MIME types ; consulted by {@link isSafeUrl}
96
- * when `allowDataImage` is true.
96
+ * when `allowDataImage` is true. The MIME type is followed by a
97
+ * parameter (`;base64`, `;utf8`) or directly by the data (`,`): both
98
+ * are RFC 2397 forms.
97
99
  */
98
- const DATA_IMAGE_RE = /^data:image\/(png|jpe?g|gif|webp|svg\+xml|bmp|ico|avif|apng);/;
100
+ const DATA_IMAGE_RE = /^data:image\/(png|jpe?g|gif|webp|svg\+xml|bmp|ico|avif|apng)[;,]/;
99
101
 
100
102
  /**
101
103
  * Decide whether `url` may be safely set on a URL-bearing attribute.
@@ -137,7 +139,7 @@ export const secPolicy = {
137
139
  if (colon === -1) return true;
138
140
  const slash = trimmed.indexOf('/');
139
141
  if (slash !== -1 && slash < colon) return true;
140
- const allowed = Array.isArray(schemes) ? schemes : SAFE_SCHEMES;
142
+ const allowed = (Array.isArray(schemes) || schemes instanceof Set) ? schemes : SAFE_SCHEMES;
141
143
  const scheme = trimmed.slice(0, colon);
142
144
  return allowed instanceof Set ? allowed.has(scheme) : allowed.includes(scheme);
143
145
  }