@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,522 +1,542 @@
1
- // Copyright (c) 2026 AwaCloud SAS
2
- // Author: Matthieu Bouilloux
3
- // SPDX-License-Identifier: Apache-2.0
4
-
5
- /**
6
- * @description
7
- * Design-token manager built on CSS Custom Properties. Lets the caller
8
- * define tokens as scalar values or variants
9
- * (`{light, dark, highContrast, reducedMotion}`), apply the resolved CSS
10
- * variables to a chosen scope (`:root` by default), watch the system media
11
- * queries (`prefers-color-scheme`, `prefers-contrast`,
12
- * `prefers-reduced-motion`, `forced-colors`), and switch modes with change
13
- * notification to observers.
14
- *
15
- * Out of scope : inheritance / `extends` (handled by the cnf loader
16
- * `sde_lib_style`).
17
- * Worker-safe : no - depends on `document`, `matchMedia`, `window`.
18
- *
19
- * Each `create()` call returns an isolated instance with its own dedicated
20
- * `<style>` element (unique id per instance - multiple instances can coexist
21
- * without clobbering each other). Calling `dispose()` removes the element
22
- * and detaches all listeners ; subsequent method calls become safe no-ops.
23
- *
24
- * @example
25
- * const themeTokens = runtime.resolve('themeTokens');
26
- * const theme = themeTokens.create({ prefix: 'fw-' });
27
- * theme.define({ color: { light: '#fff', dark: '#000' } });
28
- * theme.mode('dark');
29
- * theme.onChange(({ resolved }) => console.log('mode:', resolved));
30
- */
31
-
32
- /**
33
- * @typedef {Object} ThemeInstance
34
- * @property {function(Record<string, string|number|Object>): void} define
35
- * @property {function(string): void} mode
36
- * @property {function(): {mode: string, resolved: string, reducedMotion: boolean}} current
37
- * @property {function(string): string} get
38
- * @property {function(function): function} onChange
39
- * @property {function(): void} dispose
40
- * @property {function(Object): void} [applyPreset]
41
- */
42
-
43
- /**
44
- * Design-token manager surface returned by `factory()`.
45
- * @typedef {object} ThemeTokensAPI
46
- * @property {(opts?: {scope?: string|Element, prefix?: string}) => ThemeInstance} create - Create an isolated token-manager instance.
47
- * @property {Object<string, Object>} presets - Ready-to-use token presets (`neutral`, `material`, `tailwind`).
48
- */
49
-
50
- import { dom } from '../query/dom.js';
51
-
52
- export const themeTokens = {
53
- name: 'themeTokens',
54
- version: '1.1.0',
55
- type: 'fw.dom.rendering',
56
- dependencies: ['dom'],
57
- deps: [dom],
58
-
59
- /**
60
- * @param {Object} dom - The fw `dom` module instance.
61
- * @returns {ThemeTokensAPI}
62
- */
63
- factory(dom) {
64
-
65
- // Monotonic counter used to mint unique <style> ids per instance.
66
- let _instanceSeq = 0;
67
-
68
- // ── Ready-to-use presets ────────────────────────────────────────────
69
- // Each preset is a `{ tokens }` object ready to feed `define()`.
70
- // Exposed variants : default / light / dark / highContrast / reducedMotion.
71
- // Naming convention : `<family>-<variant>`, kebab-case.
72
-
73
- const PRESET_NEUTRAL = {
74
- 'color-bg': { light: '#ffffff', dark: '#0b0b0d', highContrast: '#000000' },
75
- 'color-fg': { light: '#1a1a1a', dark: '#f2f2f2', highContrast: '#ffffff' },
76
- 'color-muted': { light: '#6b7280', dark: '#9ca3af', highContrast: '#cccccc' },
77
- 'color-accent': { light: '#2563eb', dark: '#60a5fa', highContrast: '#ffff00' },
78
- 'color-danger': { light: '#dc2626', dark: '#f87171', highContrast: '#ff6b6b' },
79
- 'color-success': { light: '#16a34a', dark: '#4ade80', highContrast: '#00ff7f' },
80
- 'color-border': { light: '#e5e7eb', dark: '#27272a', highContrast: '#ffffff' },
81
- 'space-1': '4px',
82
- 'space-2': '8px',
83
- 'space-3': '12px',
84
- 'space-4': '16px',
85
- 'space-6': '24px',
86
- 'space-8': '32px',
87
- 'radius-sm': '4px',
88
- 'radius-md': '8px',
89
- 'radius-lg': '16px',
90
- 'font-sans': 'system-ui, -apple-system, sans-serif',
91
- 'font-mono': 'ui-monospace, Menlo, Consolas, monospace',
92
- 'duration-fast': { default: '120ms', reducedMotion: '0ms' },
93
- 'duration-base': { default: '240ms', reducedMotion: '0ms' },
94
- 'duration-slow': { default: '480ms', reducedMotion: '0ms' },
95
- 'easing-standard': 'cubic-bezier(.2,0,0,1)',
96
- };
97
-
98
- const PRESET_MATERIAL = {
99
- // Material 3 baseline (simplified colours, no dynamic tone mapping)
100
- 'color-bg': { light: '#fffbfe', dark: '#1c1b1f', highContrast: '#000000' },
101
- 'color-fg': { light: '#1c1b1f', dark: '#e6e1e5', highContrast: '#ffffff' },
102
- 'color-surface': { light: '#f7f2fa', dark: '#2b292d' },
103
- 'color-primary': { light: '#6750a4', dark: '#d0bcff', highContrast: '#ffff00' },
104
- 'color-on-primary': { light: '#ffffff', dark: '#371e73' },
105
- 'color-secondary': { light: '#625b71', dark: '#ccc2dc' },
106
- 'color-error': { light: '#b3261e', dark: '#f2b8b5' },
107
- 'color-outline': { light: '#79747e', dark: '#938f99' },
108
- 'space-1': '4px',
109
- 'space-2': '8px',
110
- 'space-3': '12px',
111
- 'space-4': '16px',
112
- 'space-6': '24px',
113
- 'radius-sm': '4px',
114
- 'radius-md': '12px',
115
- 'radius-lg': '28px', // Material full container
116
- 'font-sans': 'Roboto, system-ui, sans-serif',
117
- 'font-mono': 'Roboto Mono, ui-monospace, monospace',
118
- 'elevation-1': '0 1px 2px rgba(0,0,0,.30), 0 1px 3px 1px rgba(0,0,0,.15)',
119
- 'elevation-2': '0 1px 2px rgba(0,0,0,.30), 0 2px 6px 2px rgba(0,0,0,.15)',
120
- 'duration-fast': { default: '150ms', reducedMotion: '0ms' },
121
- 'duration-base': { default: '250ms', reducedMotion: '0ms' },
122
- 'duration-slow': { default: '400ms', reducedMotion: '0ms' },
123
- 'easing-standard': 'cubic-bezier(.2,0,0,1)',
124
- 'easing-emphasized':'cubic-bezier(.2,0,0,1)',
125
- };
126
-
127
- const PRESET_TAILWIND = {
128
- // Distilled Tailwind "slate/blue" palette
129
- 'color-bg': { light: '#ffffff', dark: '#0f172a', highContrast: '#000000' }, // slate-50/900
130
- 'color-fg': { light: '#0f172a', dark: '#f1f5f9', highContrast: '#ffffff' }, // slate-900/100
131
- 'color-muted': { light: '#64748b', dark: '#94a3b8', highContrast: '#cccccc' }, // slate-500/400
132
- 'color-accent': { light: '#3b82f6', dark: '#60a5fa', highContrast: '#ffff00' }, // blue-500/400
133
- 'color-danger': { light: '#ef4444', dark: '#f87171' }, // red-500/400
134
- 'color-success': { light: '#22c55e', dark: '#4ade80' }, // green-500/400
135
- 'color-warning': { light: '#eab308', dark: '#facc15' }, // yellow-500/400
136
- 'color-border': { light: '#e2e8f0', dark: '#1e293b', highContrast: '#ffffff' }, // slate-200/800
137
- 'space-1': '0.25rem',
138
- 'space-2': '0.5rem',
139
- 'space-3': '0.75rem',
140
- 'space-4': '1rem',
141
- 'space-6': '1.5rem',
142
- 'space-8': '2rem',
143
- 'radius-sm': '0.125rem',
144
- 'radius-md': '0.375rem',
145
- 'radius-lg': '0.5rem',
146
- 'radius-xl': '0.75rem',
147
- 'font-sans': 'ui-sans-serif, system-ui, sans-serif',
148
- 'font-mono': 'ui-monospace, SFMono-Regular, Menlo, monospace',
149
- 'shadow-sm': '0 1px 2px 0 rgb(0 0 0 / .05)',
150
- 'shadow-md': '0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1)',
151
- 'duration-fast': { default: '150ms', reducedMotion: '0ms' },
152
- 'duration-base': { default: '200ms', reducedMotion: '0ms' },
153
- 'duration-slow': { default: '300ms', reducedMotion: '0ms' },
154
- 'easing-standard': 'cubic-bezier(.4,0,.2,1)',
155
- };
156
-
157
- const presets = {
158
- neutral: PRESET_NEUTRAL,
159
- material: PRESET_MATERIAL,
160
- tailwind: PRESET_TAILWIND,
161
- };
162
-
163
- /**
164
- * Create a token-manager instance.
165
- *
166
- * @param {Object} [opts={}]
167
- * @param {string|Element} [opts.scope=':root'] CSS selector string or target HTMLElement.
168
- * @param {string} [opts.prefix=''] Prefix applied to every CSS-var name.
169
- * @returns {ThemeInstance}
170
- */
171
- function create(opts = {}) {
172
- const prefix = opts.prefix ?? '';
173
- const scopeArg = opts.scope ?? ':root';
174
-
175
- // Unique id for this instance's <style> element. Prevents two
176
- // instances from clobbering each other through a shared global id
177
- // (was a real bug ; see `tmp/audit/themeTokens.md`).
178
- const _styleId = `data-fw-theme-tokens-${++_instanceSeq}`;
179
-
180
- // Set to true by dispose() ; subsequent method calls become no-ops.
181
- let _disposed = false;
182
-
183
- // ── Internal state ────────────────────────────────────────────────
184
-
185
- /** @type {Record<string, {default?:string, light?:string, dark?:string, highContrast?:string, reducedMotion?:string} | string>} */
186
- const _tokens = {};
187
-
188
- /** 'light' | 'dark' | 'auto' | 'high-contrast' */
189
- let _mode = 'auto';
190
-
191
- /** Current resolved state. */
192
- let _resolved = 'light';
193
- let _reducedMotion = false;
194
-
195
- /** onChange listeners. */
196
- const _listeners = new Set();
197
-
198
- // ── Media-query stubs / handles ───────────────────────────────────
199
-
200
- let _mqDark = null;
201
- let _mqContrast = null;
202
- let _mqMotion = null;
203
- let _mqForced = null;
204
-
205
- let _mqDarkHandler = null;
206
- let _mqContrastHandler = null;
207
- let _mqMotionHandler = null;
208
- let _mqForcedHandler = null;
209
-
210
- // ── Helpers ───────────────────────────────────────────────────────
211
-
212
- /**
213
- * Resolve the effective mode from the current media-query state.
214
- * @returns {'light'|'dark'|'high-contrast'}
215
- */
216
- function _resolveMode() {
217
- if (_mode === 'high-contrast') return 'high-contrast';
218
-
219
- const forcedActive = _mqForced ? _mqForced.matches : false;
220
- const contrastMore = _mqContrast ? _mqContrast.matches : false;
221
- const prefersDark = _mqDark ? _mqDark.matches : false;
222
-
223
- if (forcedActive || contrastMore) return 'high-contrast';
224
-
225
- if (_mode === 'dark') return 'dark';
226
- if (_mode === 'light') return 'light';
227
-
228
- // auto : follow the system media queries.
229
- return prefersDark ? 'dark' : 'light';
230
- }
231
-
232
- /**
233
- * Read the value of a token for the currently-resolved mode.
234
- * @param {string|Object} tokenDef
235
- * @param {'light'|'dark'|'high-contrast'} resolved
236
- * @param {boolean} reducedMotion
237
- * @returns {string|undefined}
238
- */
239
- function _pick(tokenDef, resolved, reducedMotion) {
240
- if (typeof tokenDef === 'string' || typeof tokenDef === 'number') {
241
- return String(tokenDef);
242
- }
243
- if (reducedMotion && tokenDef.reducedMotion !== undefined) {
244
- return String(tokenDef.reducedMotion);
245
- }
246
- if (resolved === 'high-contrast' && tokenDef.highContrast !== undefined) {
247
- return String(tokenDef.highContrast);
248
- }
249
- if (resolved === 'dark' && tokenDef.dark !== undefined) return String(tokenDef.dark);
250
- if (resolved === 'light' && tokenDef.light !== undefined) return String(tokenDef.light);
251
- if (tokenDef.default !== undefined) return String(tokenDef.default);
252
- // Fallback cascade : dark → light when high-contrast is not defined.
253
- if (resolved === 'high-contrast') {
254
- if (tokenDef.dark !== undefined) return String(tokenDef.dark);
255
- if (tokenDef.light !== undefined) return String(tokenDef.light);
256
- }
257
- return undefined;
258
- }
259
-
260
- /**
261
- * Resolve the scope to (a) a CSS selector string for the rule and
262
- * (b) the matching DOM Element used by `get()` to read computed
263
- * values. Both stay aligned : a custom selector is honoured for
264
- * the rule AND queried back via `document.querySelector` so that
265
- * `get()` returns the correct value (was a bug : `get()` always
266
- * read from `documentElement` regardless of scope).
267
- * @returns {{ selector: string, element: Element|null }}
268
- */
269
- function _resolveScope() {
270
- if (scopeArg instanceof Element) {
271
- // Use a temporary :where-class binding via the element id ;
272
- // simpler : we still emit a `:root` rule and apply the
273
- // value via inline style on the element. But to keep the
274
- // simple `<style>`-based application, when caller passes
275
- // an Element we attach a unique data attribute and target
276
- // that. This keeps `get()` reading the same element.
277
- return { selector: ':root', element: document.documentElement };
278
- }
279
- const sel = scopeArg || ':root';
280
- let el;
281
- try { el = document.querySelector(sel); } catch { el = null; }
282
- // Fallback : if the selector does not match anything, read
283
- // from documentElement (matches the `:root` default case).
284
- if (!el) el = document.documentElement;
285
- return { selector: sel, element: el };
286
- }
287
-
288
- /**
289
- * Generate the complete CSS rule for the scope.
290
- * @returns {string}
291
- */
292
- function _buildCSS() {
293
- const lines = [];
294
- for (const [name, def] of Object.entries(_tokens)) {
295
- // @ts-ignore - _resolved is string at runtime; _pick narrows correctly
296
- const val = _pick(def, _resolved, _reducedMotion);
297
- if (val !== undefined) {
298
- lines.push(` --${prefix}${name}: ${val};`);
299
- }
300
- }
301
- const { selector } = _resolveScope();
302
- return lines.length ? `${selector} {\n${lines.join('\n')}\n}` : '';
303
- }
304
-
305
- /**
306
- * Get (or create) the dedicated `<style>` element for this instance.
307
- * Unique per instance - no global id collision.
308
- * @returns {HTMLStyleElement}
309
- */
310
- function _getStyleEl() {
311
- let el = document.getElementById(_styleId);
312
- if (!el) {
313
- el = document.createElement('style');
314
- el.id = _styleId;
315
- document.head.appendChild(el);
316
- }
317
- // @ts-ignore - document.getElementById returns HTMLElement; cast to HTMLStyleElement is safe
318
- return el;
319
- }
320
-
321
- /**
322
- * Apply CSS vars by rewriting the dedicated `<style>` element.
323
- */
324
- function _apply() {
325
- const css = _buildCSS();
326
- const el = _getStyleEl();
327
- el.textContent = css;
328
- }
329
-
330
- /**
331
- * Update the resolved state and notify listeners on change.
332
- */
333
- function _update() {
334
- const newResolved = _resolveMode();
335
- const newReducedMotion = _mqMotion ? _mqMotion.matches : false;
336
-
337
- const changed = newResolved !== _resolved || newReducedMotion !== _reducedMotion;
338
- _resolved = newResolved;
339
- _reducedMotion = newReducedMotion;
340
-
341
- _apply();
342
-
343
- if (changed) {
344
- const state = { mode: _mode, resolved: _resolved, reducedMotion: _reducedMotion };
345
- for (const fn of _listeners) fn(state);
346
- }
347
- }
348
-
349
- // ── Setup media queries ───────────────────────────────────────────
350
-
351
- function _setupMediaQueries() {
352
- // Detach previous handlers when re-setting up.
353
- if (_mqDark && _mqDarkHandler) {
354
- _mqDark.removeEventListener('change', _mqDarkHandler);
355
- }
356
- if (_mqContrast && _mqContrastHandler) {
357
- _mqContrast.removeEventListener('change', _mqContrastHandler);
358
- }
359
- if (_mqMotion && _mqMotionHandler) {
360
- _mqMotion.removeEventListener('change', _mqMotionHandler);
361
- }
362
- if (_mqForced && _mqForcedHandler) {
363
- _mqForced.removeEventListener('change', _mqForcedHandler);
364
- }
365
-
366
- _mqDark = window.matchMedia('(prefers-color-scheme: dark)');
367
- _mqContrast = window.matchMedia('(prefers-contrast: more)');
368
- _mqMotion = window.matchMedia('(prefers-reduced-motion: reduce)');
369
- _mqForced = window.matchMedia('(forced-colors: active)');
370
-
371
- _mqDarkHandler = () => _update();
372
- _mqContrastHandler = () => _update();
373
- _mqMotionHandler = () => _update();
374
- _mqForcedHandler = () => _update();
375
-
376
- _mqDark.addEventListener ('change', _mqDarkHandler);
377
- _mqContrast.addEventListener('change', _mqContrastHandler);
378
- _mqMotion.addEventListener ('change', _mqMotionHandler);
379
- _mqForced.addEventListener ('change', _mqForcedHandler);
380
- }
381
-
382
- _setupMediaQueries();
383
- // Initial resolution.
384
- _resolved = _resolveMode();
385
- // @ts-ignore - _mqMotion is MediaQueryList at runtime; TS infers never from conditional assignment
386
- _reducedMotion = _mqMotion ? _mqMotion.matches : false;
387
-
388
- // ── Public API ────────────────────────────────────────────────────
389
-
390
- /**
391
- * Define a token set. Each value can be a scalar or a variant
392
- * object `{default?, light?, dark?, highContrast?, reducedMotion?}`.
393
- *
394
- * After `dispose()` this is a no-op.
395
- *
396
- * @param {Record<string, string|number|Object>} map
397
- */
398
- function define(map) {
399
- if (_disposed) return;
400
- for (const [name, def] of Object.entries(map)) {
401
- _tokens[name] = def;
402
- }
403
- _apply();
404
- }
405
-
406
- /**
407
- * Switch the active display mode.
408
- *
409
- * After `dispose()` this is a no-op.
410
- *
411
- * @param {'light'|'dark'|'auto'|'high-contrast'} name
412
- */
413
- function mode(name) {
414
- if (!['light', 'dark', 'auto', 'high-contrast'].includes(name)) {
415
- throw new Error(`themeTokens: invalid mode "${name}"`);
416
- }
417
- if (_disposed) return;
418
- _mode = name;
419
- _resolved = _resolveMode();
420
- _reducedMotion = _mqMotion ? _mqMotion.matches : false;
421
- _apply();
422
- // Always notify on explicit mode() calls.
423
- const state = { mode: _mode, resolved: _resolved, reducedMotion: _reducedMotion };
424
- for (const fn of _listeners) fn(state);
425
- }
426
-
427
- /**
428
- * Return the current resolved state.
429
- * @returns {{ mode: string, resolved: 'light'|'dark'|'high-contrast', reducedMotion: boolean }}
430
- */
431
- function current() {
432
- return {
433
- mode: _mode,
434
- // @ts-ignore - _resolved is string constrained by _resolveMode()
435
- resolved: _resolved,
436
- reducedMotion: _reducedMotion
437
- };
438
- }
439
-
440
- /**
441
- * Read the active value of a token via `getComputedStyle`. Reads
442
- * from the scope element resolved at instance-creation time -
443
- * matches the scope used by `_buildCSS()`, so custom scopes
444
- * return the right value (was a bug : the previous implementation
445
- * always read from `documentElement`).
446
- *
447
- * After `dispose()` returns an empty string.
448
- *
449
- * @param {string} name - Token name (no prefix, no `--`).
450
- * @returns {string}
451
- */
452
- function get(name) {
453
- if (_disposed) return '';
454
- const { element } = _resolveScope();
455
- const target = (scopeArg instanceof Element) ? scopeArg : element;
456
- return getComputedStyle(target).getPropertyValue(`--${prefix}${name}`).trim();
457
- }
458
-
459
- /**
460
- * Register a listener invoked on every mode / media-query change.
461
- *
462
- * After `dispose()`, registration is a no-op and returns a no-op
463
- * unsubscribe function.
464
- *
465
- * @param {function} fn
466
- * @returns {function} Unsubscribe function.
467
- */
468
- function onChange(fn) {
469
- if (_disposed) return () => {};
470
- _listeners.add(fn);
471
- return () => _listeners.delete(fn);
472
- }
473
-
474
- /**
475
- * Detach all media-query listeners, drop the dedicated `<style>`
476
- * element, clear all observers, and mark the instance terminal.
477
- * Subsequent calls to `define`, `mode`, `applyPreset`, `onChange`
478
- * are safe no-ops ; `get()` returns `''` ; `current()` still
479
- * reflects the last-known state.
480
- */
481
- function dispose() {
482
- if (_disposed) return;
483
- _disposed = true;
484
- if (_mqDark && _mqDarkHandler)
485
- _mqDark.removeEventListener('change', _mqDarkHandler);
486
- if (_mqContrast && _mqContrastHandler)
487
- _mqContrast.removeEventListener('change', _mqContrastHandler);
488
- if (_mqMotion && _mqMotionHandler)
489
- _mqMotion.removeEventListener('change', _mqMotionHandler);
490
- if (_mqForced && _mqForcedHandler)
491
- _mqForced.removeEventListener('change', _mqForcedHandler);
492
- _mqDark = _mqContrast = _mqMotion = _mqForced = null;
493
- _mqDarkHandler = _mqContrastHandler = _mqMotionHandler = _mqForcedHandler = null;
494
- _listeners.clear();
495
- const el = document.getElementById(_styleId);
496
- if (el) el.remove();
497
- }
498
-
499
- /**
500
- * Apply a preset by name (`'neutral' | 'material' | 'tailwind'`)
501
- * or directly by token-map object. Existing tokens are not wiped -
502
- * only the preset entries are overlaid (top-level merge).
503
- *
504
- * After `dispose()` this is a no-op.
505
- *
506
- * @param {string|Object} nameOrMap
507
- */
508
- function applyPreset(nameOrMap) {
509
- if (_disposed) return;
510
- const map = typeof nameOrMap === 'string'
511
- ? presets[nameOrMap]
512
- : nameOrMap;
513
- if (!map) throw new Error(`themeTokens.applyPreset: unknown preset '${nameOrMap}'`);
514
- define(map);
515
- }
516
-
517
- return { define, mode, current, get, onChange, dispose, applyPreset };
518
- }
519
-
520
- return { create, presets };
521
- }
522
- };
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @description
7
+ * Design-token manager built on CSS Custom Properties. Lets the caller
8
+ * define tokens as scalar values or variants
9
+ * (`{light, dark, highContrast, reducedMotion}`), apply the resolved CSS
10
+ * variables to a chosen scope (`:root` by default), watch the system media
11
+ * queries (`prefers-color-scheme`, `prefers-contrast`,
12
+ * `prefers-reduced-motion`, `forced-colors`), and switch modes with change
13
+ * notification to observers.
14
+ *
15
+ * Out of scope : inheritance / `extends` (handled by the cnf loader
16
+ * `sde_lib_style`).
17
+ * Worker-safe : no - depends on `document`, `matchMedia`, `window`.
18
+ *
19
+ * Each `create()` call returns an isolated instance with its own dedicated
20
+ * `<style id="data-fw-theme-tokens-N">` element (unique id per instance -
21
+ * multiple instances can coexist without clobbering each other), attached
22
+ * through the `styleSheet` module (the element carries the page's
23
+ * `<meta name="csp-nonce">` nonce when there is one; under
24
+ * `styleSheet.mode('adopted')` there is no element, a constructable
25
+ * stylesheet is used). Calling `dispose()` removes the style and detaches all
26
+ * listeners ; subsequent method calls become safe no-ops.
27
+ *
28
+ * @example
29
+ * const themeTokens = runtime.resolve('themeTokens');
30
+ * const theme = themeTokens.create({ prefix: 'fw-' });
31
+ * theme.define({ color: { light: '#fff', dark: '#000' } });
32
+ * theme.mode('dark');
33
+ * theme.onChange(({ resolved }) => console.log('mode:', resolved));
34
+ */
35
+
36
+ /**
37
+ * @typedef {Object} ThemeInstance
38
+ * @property {function(Record<string, string|number|Object>): void} define
39
+ * @property {function(string): void} mode
40
+ * @property {function(): {mode: string, resolved: string, reducedMotion: boolean}} current
41
+ * @property {function(string): string} get
42
+ * @property {function(function): function} onChange
43
+ * @property {function(): void} dispose
44
+ * @property {function(Object): void} [applyPreset]
45
+ */
46
+
47
+ /**
48
+ * Design-token manager surface returned by `factory()`.
49
+ * @typedef {object} ThemeTokensAPI
50
+ * @property {(opts?: {scope?: string|Element, prefix?: string}) => ThemeInstance} create - Create an isolated token-manager instance.
51
+ * @property {Object<string, Object>} presets - Ready-to-use token presets (`neutral`, `material`, `tailwind`).
52
+ */
53
+
54
+ import { dom } from '../query/dom.js';
55
+ import { styleSheet } from './styleSheet.js';
56
+
57
+ export const themeTokens = {
58
+ name: 'themeTokens',
59
+ version: '1.1.0',
60
+ type: 'fw.dom.rendering',
61
+ dependencies: ['dom', 'styleSheet'],
62
+ deps: [dom, styleSheet],
63
+
64
+ /**
65
+ * @param {Object} dom - The fw `dom` module instance.
66
+ * @returns {ThemeTokensAPI}
67
+ */
68
+ factory(dom, styleSheet) {
69
+
70
+ // Monotonic counter used to mint unique <style> ids per instance.
71
+ let _instanceSeq = 0;
72
+
73
+ // ── Ready-to-use presets ────────────────────────────────────────────
74
+ // Each preset is a `{ tokens }` object ready to feed `define()`.
75
+ // Exposed variants : default / light / dark / highContrast / reducedMotion.
76
+ // Naming convention : `<family>-<variant>`, kebab-case.
77
+
78
+ const PRESET_NEUTRAL = {
79
+ 'color-bg': { light: '#ffffff', dark: '#0b0b0d', highContrast: '#000000' },
80
+ 'color-fg': { light: '#1a1a1a', dark: '#f2f2f2', highContrast: '#ffffff' },
81
+ 'color-muted': { light: '#6b7280', dark: '#9ca3af', highContrast: '#cccccc' },
82
+ 'color-accent': { light: '#2563eb', dark: '#60a5fa', highContrast: '#ffff00' },
83
+ 'color-danger': { light: '#dc2626', dark: '#f87171', highContrast: '#ff6b6b' },
84
+ 'color-success': { light: '#16a34a', dark: '#4ade80', highContrast: '#00ff7f' },
85
+ 'color-border': { light: '#e5e7eb', dark: '#27272a', highContrast: '#ffffff' },
86
+ 'space-1': '4px',
87
+ 'space-2': '8px',
88
+ 'space-3': '12px',
89
+ 'space-4': '16px',
90
+ 'space-6': '24px',
91
+ 'space-8': '32px',
92
+ 'radius-sm': '4px',
93
+ 'radius-md': '8px',
94
+ 'radius-lg': '16px',
95
+ 'font-sans': 'system-ui, -apple-system, sans-serif',
96
+ 'font-mono': 'ui-monospace, Menlo, Consolas, monospace',
97
+ 'duration-fast': { default: '120ms', reducedMotion: '0ms' },
98
+ 'duration-base': { default: '240ms', reducedMotion: '0ms' },
99
+ 'duration-slow': { default: '480ms', reducedMotion: '0ms' },
100
+ 'easing-standard': 'cubic-bezier(.2,0,0,1)',
101
+ };
102
+
103
+ const PRESET_MATERIAL = {
104
+ // Material 3 baseline (simplified colours, no dynamic tone mapping)
105
+ 'color-bg': { light: '#fffbfe', dark: '#1c1b1f', highContrast: '#000000' },
106
+ 'color-fg': { light: '#1c1b1f', dark: '#e6e1e5', highContrast: '#ffffff' },
107
+ 'color-surface': { light: '#f7f2fa', dark: '#2b292d' },
108
+ 'color-primary': { light: '#6750a4', dark: '#d0bcff', highContrast: '#ffff00' },
109
+ 'color-on-primary': { light: '#ffffff', dark: '#371e73' },
110
+ 'color-secondary': { light: '#625b71', dark: '#ccc2dc' },
111
+ 'color-error': { light: '#b3261e', dark: '#f2b8b5' },
112
+ 'color-outline': { light: '#79747e', dark: '#938f99' },
113
+ 'space-1': '4px',
114
+ 'space-2': '8px',
115
+ 'space-3': '12px',
116
+ 'space-4': '16px',
117
+ 'space-6': '24px',
118
+ 'radius-sm': '4px',
119
+ 'radius-md': '12px',
120
+ 'radius-lg': '28px', // Material full container
121
+ 'font-sans': 'Roboto, system-ui, sans-serif',
122
+ 'font-mono': 'Roboto Mono, ui-monospace, monospace',
123
+ 'elevation-1': '0 1px 2px rgba(0,0,0,.30), 0 1px 3px 1px rgba(0,0,0,.15)',
124
+ 'elevation-2': '0 1px 2px rgba(0,0,0,.30), 0 2px 6px 2px rgba(0,0,0,.15)',
125
+ 'duration-fast': { default: '150ms', reducedMotion: '0ms' },
126
+ 'duration-base': { default: '250ms', reducedMotion: '0ms' },
127
+ 'duration-slow': { default: '400ms', reducedMotion: '0ms' },
128
+ 'easing-standard': 'cubic-bezier(.2,0,0,1)',
129
+ 'easing-emphasized':'cubic-bezier(.2,0,0,1)',
130
+ };
131
+
132
+ const PRESET_TAILWIND = {
133
+ // Distilled Tailwind "slate/blue" palette
134
+ 'color-bg': { light: '#ffffff', dark: '#0f172a', highContrast: '#000000' }, // slate-50/900
135
+ 'color-fg': { light: '#0f172a', dark: '#f1f5f9', highContrast: '#ffffff' }, // slate-900/100
136
+ 'color-muted': { light: '#64748b', dark: '#94a3b8', highContrast: '#cccccc' }, // slate-500/400
137
+ 'color-accent': { light: '#3b82f6', dark: '#60a5fa', highContrast: '#ffff00' }, // blue-500/400
138
+ 'color-danger': { light: '#ef4444', dark: '#f87171' }, // red-500/400
139
+ 'color-success': { light: '#22c55e', dark: '#4ade80' }, // green-500/400
140
+ 'color-warning': { light: '#eab308', dark: '#facc15' }, // yellow-500/400
141
+ 'color-border': { light: '#e2e8f0', dark: '#1e293b', highContrast: '#ffffff' }, // slate-200/800
142
+ 'space-1': '0.25rem',
143
+ 'space-2': '0.5rem',
144
+ 'space-3': '0.75rem',
145
+ 'space-4': '1rem',
146
+ 'space-6': '1.5rem',
147
+ 'space-8': '2rem',
148
+ 'radius-sm': '0.125rem',
149
+ 'radius-md': '0.375rem',
150
+ 'radius-lg': '0.5rem',
151
+ 'radius-xl': '0.75rem',
152
+ 'font-sans': 'ui-sans-serif, system-ui, sans-serif',
153
+ 'font-mono': 'ui-monospace, SFMono-Regular, Menlo, monospace',
154
+ 'shadow-sm': '0 1px 2px 0 rgb(0 0 0 / .05)',
155
+ 'shadow-md': '0 4px 6px -1px rgb(0 0 0 / .1), 0 2px 4px -2px rgb(0 0 0 / .1)',
156
+ 'duration-fast': { default: '150ms', reducedMotion: '0ms' },
157
+ 'duration-base': { default: '200ms', reducedMotion: '0ms' },
158
+ 'duration-slow': { default: '300ms', reducedMotion: '0ms' },
159
+ 'easing-standard': 'cubic-bezier(.4,0,.2,1)',
160
+ };
161
+
162
+ const presets = {
163
+ neutral: PRESET_NEUTRAL,
164
+ material: PRESET_MATERIAL,
165
+ tailwind: PRESET_TAILWIND,
166
+ };
167
+
168
+ /**
169
+ * Create a token-manager instance.
170
+ *
171
+ * @param {Object} [opts={}]
172
+ * @param {string|Element} [opts.scope=':root'] CSS selector string or target HTMLElement.
173
+ * @param {string} [opts.prefix=''] Prefix applied to every CSS-var name.
174
+ * @returns {ThemeInstance}
175
+ */
176
+ function create(opts = {}) {
177
+ const prefix = opts.prefix ?? '';
178
+ const scopeArg = opts.scope ?? ':root';
179
+
180
+ // Unique id for this instance's <style> element. Prevents two
181
+ // instances from clobbering each other through a shared global id
182
+ // (was a real bug ; see `tmp/audit/themeTokens.md`).
183
+ const _styleId = `data-fw-theme-tokens-${++_instanceSeq}`;
184
+
185
+ // Set to true by dispose() ; subsequent method calls become no-ops.
186
+ let _disposed = false;
187
+
188
+ // Lazily created styleSheet handle (null without styleSheet or before the first apply).
189
+ /** @type {{set: function(string): void, detach: function(): void}|null} */
190
+ let _handle = null;
191
+
192
+ // ── Internal state ────────────────────────────────────────────────
193
+
194
+ /** @type {Record<string, {default?:string, light?:string, dark?:string, highContrast?:string, reducedMotion?:string} | string>} */
195
+ const _tokens = {};
196
+
197
+ /** 'light' | 'dark' | 'auto' | 'high-contrast' */
198
+ let _mode = 'auto';
199
+
200
+ /** Current resolved state. */
201
+ let _resolved = 'light';
202
+ let _reducedMotion = false;
203
+
204
+ /** onChange listeners. */
205
+ const _listeners = new Set();
206
+
207
+ // ── Media-query stubs / handles ───────────────────────────────────
208
+
209
+ let _mqDark = null;
210
+ let _mqContrast = null;
211
+ let _mqMotion = null;
212
+ let _mqForced = null;
213
+
214
+ let _mqDarkHandler = null;
215
+ let _mqContrastHandler = null;
216
+ let _mqMotionHandler = null;
217
+ let _mqForcedHandler = null;
218
+
219
+ // ── Helpers ───────────────────────────────────────────────────────
220
+
221
+ /**
222
+ * Resolve the effective mode from the current media-query state.
223
+ * @returns {'light'|'dark'|'high-contrast'}
224
+ */
225
+ function _resolveMode() {
226
+ if (_mode === 'high-contrast') return 'high-contrast';
227
+
228
+ const forcedActive = _mqForced ? _mqForced.matches : false;
229
+ const contrastMore = _mqContrast ? _mqContrast.matches : false;
230
+ const prefersDark = _mqDark ? _mqDark.matches : false;
231
+
232
+ if (forcedActive || contrastMore) return 'high-contrast';
233
+
234
+ if (_mode === 'dark') return 'dark';
235
+ if (_mode === 'light') return 'light';
236
+
237
+ // auto : follow the system media queries.
238
+ return prefersDark ? 'dark' : 'light';
239
+ }
240
+
241
+ /**
242
+ * Read the value of a token for the currently-resolved mode.
243
+ * @param {string|Object} tokenDef
244
+ * @param {'light'|'dark'|'high-contrast'} resolved
245
+ * @param {boolean} reducedMotion
246
+ * @returns {string|undefined}
247
+ */
248
+ function _pick(tokenDef, resolved, reducedMotion) {
249
+ if (typeof tokenDef === 'string' || typeof tokenDef === 'number') {
250
+ return String(tokenDef);
251
+ }
252
+ if (reducedMotion && tokenDef.reducedMotion !== undefined) {
253
+ return String(tokenDef.reducedMotion);
254
+ }
255
+ if (resolved === 'high-contrast' && tokenDef.highContrast !== undefined) {
256
+ return String(tokenDef.highContrast);
257
+ }
258
+ if (resolved === 'dark' && tokenDef.dark !== undefined) return String(tokenDef.dark);
259
+ if (resolved === 'light' && tokenDef.light !== undefined) return String(tokenDef.light);
260
+ if (tokenDef.default !== undefined) return String(tokenDef.default);
261
+ // Fallback cascade : dark → light when high-contrast is not defined.
262
+ if (resolved === 'high-contrast') {
263
+ if (tokenDef.dark !== undefined) return String(tokenDef.dark);
264
+ if (tokenDef.light !== undefined) return String(tokenDef.light);
265
+ }
266
+ return undefined;
267
+ }
268
+
269
+ /**
270
+ * Resolve the scope to (a) a CSS selector string for the rule and
271
+ * (b) the matching DOM Element used by `get()` to read computed
272
+ * values. Both stay aligned : a custom selector is honoured for
273
+ * the rule AND queried back via `document.querySelector` so that
274
+ * `get()` returns the correct value (was a bug : `get()` always
275
+ * read from `documentElement` regardless of scope).
276
+ * @returns {{ selector: string, element: Element|null }}
277
+ */
278
+ function _resolveScope() {
279
+ if (scopeArg instanceof Element) {
280
+ // Use a temporary :where-class binding via the element id ;
281
+ // simpler : we still emit a `:root` rule and apply the
282
+ // value via inline style on the element. But to keep the
283
+ // simple `<style>`-based application, when caller passes
284
+ // an Element we attach a unique data attribute and target
285
+ // that. This keeps `get()` reading the same element.
286
+ return { selector: ':root', element: document.documentElement };
287
+ }
288
+ const sel = scopeArg || ':root';
289
+ let el;
290
+ try { el = document.querySelector(sel); } catch { el = null; }
291
+ // Fallback : if the selector does not match anything, read
292
+ // from documentElement (matches the `:root` default case).
293
+ if (!el) el = document.documentElement;
294
+ return { selector: sel, element: el };
295
+ }
296
+
297
+ /**
298
+ * Generate the complete CSS rule for the scope.
299
+ * @returns {string}
300
+ */
301
+ function _buildCSS() {
302
+ const lines = [];
303
+ for (const [name, def] of Object.entries(_tokens)) {
304
+ // @ts-ignore - _resolved is string at runtime; _pick narrows correctly
305
+ const val = _pick(def, _resolved, _reducedMotion);
306
+ if (val !== undefined) {
307
+ lines.push(` --${prefix}${name}: ${val};`);
308
+ }
309
+ }
310
+ const { selector } = _resolveScope();
311
+ return lines.length ? `${selector} {\n${lines.join('\n')}\n}` : '';
312
+ }
313
+
314
+ /**
315
+ * Get (or create) the dedicated `<style>` element for this instance.
316
+ * Unique per instance - no global id collision.
317
+ * @returns {HTMLStyleElement}
318
+ */
319
+ function _getStyleEl() {
320
+ let el = document.getElementById(_styleId);
321
+ if (!el) {
322
+ el = document.createElement('style');
323
+ el.id = _styleId;
324
+ document.head.appendChild(el);
325
+ }
326
+ // @ts-ignore - document.getElementById returns HTMLElement; cast to HTMLStyleElement is safe
327
+ return el;
328
+ }
329
+
330
+ /**
331
+ * Apply CSS vars by rewriting the dedicated `<style>` element.
332
+ */
333
+ function _apply() {
334
+ const css = _buildCSS();
335
+ if (styleSheet) {
336
+ if (_handle) _handle.set(css);
337
+ else _handle = styleSheet.attach(css, { id: _styleId });
338
+ return;
339
+ }
340
+ // hand-wired without styleSheet: the element path, as before
341
+ const el = _getStyleEl();
342
+ el.textContent = css;
343
+ }
344
+
345
+ /**
346
+ * Update the resolved state and notify listeners on change.
347
+ */
348
+ function _update() {
349
+ const newResolved = _resolveMode();
350
+ const newReducedMotion = _mqMotion ? _mqMotion.matches : false;
351
+
352
+ const changed = newResolved !== _resolved || newReducedMotion !== _reducedMotion;
353
+ _resolved = newResolved;
354
+ _reducedMotion = newReducedMotion;
355
+
356
+ _apply();
357
+
358
+ if (changed) {
359
+ const state = { mode: _mode, resolved: _resolved, reducedMotion: _reducedMotion };
360
+ for (const fn of _listeners) fn(state);
361
+ }
362
+ }
363
+
364
+ // ── Setup media queries ───────────────────────────────────────────
365
+
366
+ function _setupMediaQueries() {
367
+ // Detach previous handlers when re-setting up.
368
+ if (_mqDark && _mqDarkHandler) {
369
+ _mqDark.removeEventListener('change', _mqDarkHandler);
370
+ }
371
+ if (_mqContrast && _mqContrastHandler) {
372
+ _mqContrast.removeEventListener('change', _mqContrastHandler);
373
+ }
374
+ if (_mqMotion && _mqMotionHandler) {
375
+ _mqMotion.removeEventListener('change', _mqMotionHandler);
376
+ }
377
+ if (_mqForced && _mqForcedHandler) {
378
+ _mqForced.removeEventListener('change', _mqForcedHandler);
379
+ }
380
+
381
+ _mqDark = window.matchMedia('(prefers-color-scheme: dark)');
382
+ _mqContrast = window.matchMedia('(prefers-contrast: more)');
383
+ _mqMotion = window.matchMedia('(prefers-reduced-motion: reduce)');
384
+ _mqForced = window.matchMedia('(forced-colors: active)');
385
+
386
+ _mqDarkHandler = () => _update();
387
+ _mqContrastHandler = () => _update();
388
+ _mqMotionHandler = () => _update();
389
+ _mqForcedHandler = () => _update();
390
+
391
+ _mqDark.addEventListener ('change', _mqDarkHandler);
392
+ _mqContrast.addEventListener('change', _mqContrastHandler);
393
+ _mqMotion.addEventListener ('change', _mqMotionHandler);
394
+ _mqForced.addEventListener ('change', _mqForcedHandler);
395
+ }
396
+
397
+ _setupMediaQueries();
398
+ // Initial resolution.
399
+ _resolved = _resolveMode();
400
+ // @ts-ignore - _mqMotion is MediaQueryList at runtime; TS infers never from conditional assignment
401
+ _reducedMotion = _mqMotion ? _mqMotion.matches : false;
402
+
403
+ // ── Public API ────────────────────────────────────────────────────
404
+
405
+ /**
406
+ * Define a token set. Each value can be a scalar or a variant
407
+ * object `{default?, light?, dark?, highContrast?, reducedMotion?}`.
408
+ *
409
+ * After `dispose()` this is a no-op.
410
+ *
411
+ * @param {Record<string, string|number|Object>} map
412
+ */
413
+ function define(map) {
414
+ if (_disposed) return;
415
+ for (const [name, def] of Object.entries(map)) {
416
+ _tokens[name] = def;
417
+ }
418
+ _apply();
419
+ }
420
+
421
+ /**
422
+ * Switch the active display mode.
423
+ *
424
+ * After `dispose()` this is a no-op.
425
+ *
426
+ * @param {'light'|'dark'|'auto'|'high-contrast'} name
427
+ */
428
+ function mode(name) {
429
+ if (!['light', 'dark', 'auto', 'high-contrast'].includes(name)) {
430
+ throw new Error(`themeTokens: invalid mode "${name}"`);
431
+ }
432
+ if (_disposed) return;
433
+ _mode = name;
434
+ _resolved = _resolveMode();
435
+ _reducedMotion = _mqMotion ? _mqMotion.matches : false;
436
+ _apply();
437
+ // Always notify on explicit mode() calls.
438
+ const state = { mode: _mode, resolved: _resolved, reducedMotion: _reducedMotion };
439
+ for (const fn of _listeners) fn(state);
440
+ }
441
+
442
+ /**
443
+ * Return the current resolved state.
444
+ * @returns {{ mode: string, resolved: 'light'|'dark'|'high-contrast', reducedMotion: boolean }}
445
+ */
446
+ function current() {
447
+ return {
448
+ mode: _mode,
449
+ // @ts-ignore - _resolved is string constrained by _resolveMode()
450
+ resolved: _resolved,
451
+ reducedMotion: _reducedMotion
452
+ };
453
+ }
454
+
455
+ /**
456
+ * Read the active value of a token via `getComputedStyle`. Reads
457
+ * from the scope element resolved at instance-creation time -
458
+ * matches the scope used by `_buildCSS()`, so custom scopes
459
+ * return the right value (was a bug : the previous implementation
460
+ * always read from `documentElement`).
461
+ *
462
+ * After `dispose()` returns an empty string.
463
+ *
464
+ * @param {string} name - Token name (no prefix, no `--`).
465
+ * @returns {string}
466
+ */
467
+ function get(name) {
468
+ if (_disposed) return '';
469
+ const { element } = _resolveScope();
470
+ const target = (scopeArg instanceof Element) ? scopeArg : element;
471
+ return getComputedStyle(target).getPropertyValue(`--${prefix}${name}`).trim();
472
+ }
473
+
474
+ /**
475
+ * Register a listener invoked on every mode / media-query change.
476
+ *
477
+ * After `dispose()`, registration is a no-op and returns a no-op
478
+ * unsubscribe function.
479
+ *
480
+ * @param {function} fn
481
+ * @returns {function} Unsubscribe function.
482
+ */
483
+ function onChange(fn) {
484
+ if (_disposed) return () => {};
485
+ _listeners.add(fn);
486
+ return () => _listeners.delete(fn);
487
+ }
488
+
489
+ /**
490
+ * Detach all media-query listeners, drop the dedicated `<style>`
491
+ * element, clear all observers, and mark the instance terminal.
492
+ * Subsequent calls to `define`, `mode`, `applyPreset`, `onChange`
493
+ * are safe no-ops ; `get()` returns `''` ; `current()` still
494
+ * reflects the last-known state.
495
+ */
496
+ function dispose() {
497
+ if (_disposed) return;
498
+ _disposed = true;
499
+ if (_mqDark && _mqDarkHandler)
500
+ _mqDark.removeEventListener('change', _mqDarkHandler);
501
+ if (_mqContrast && _mqContrastHandler)
502
+ _mqContrast.removeEventListener('change', _mqContrastHandler);
503
+ if (_mqMotion && _mqMotionHandler)
504
+ _mqMotion.removeEventListener('change', _mqMotionHandler);
505
+ if (_mqForced && _mqForcedHandler)
506
+ _mqForced.removeEventListener('change', _mqForcedHandler);
507
+ _mqDark = _mqContrast = _mqMotion = _mqForced = null;
508
+ _mqDarkHandler = _mqContrastHandler = _mqMotionHandler = _mqForcedHandler = null;
509
+ _listeners.clear();
510
+ if (_handle) {
511
+ _handle.detach();
512
+ _handle = null;
513
+ return;
514
+ }
515
+ const el = document.getElementById(_styleId);
516
+ if (el) el.remove();
517
+ }
518
+
519
+ /**
520
+ * Apply a preset by name (`'neutral' | 'material' | 'tailwind'`)
521
+ * or directly by token-map object. Existing tokens are not wiped -
522
+ * only the preset entries are overlaid (top-level merge).
523
+ *
524
+ * After `dispose()` this is a no-op.
525
+ *
526
+ * @param {string|Object} nameOrMap
527
+ */
528
+ function applyPreset(nameOrMap) {
529
+ if (_disposed) return;
530
+ const map = typeof nameOrMap === 'string'
531
+ ? presets[nameOrMap]
532
+ : nameOrMap;
533
+ if (!map) throw new Error(`themeTokens.applyPreset: unknown preset '${nameOrMap}'`);
534
+ define(map);
535
+ }
536
+
537
+ return { define, mode, current, get, onChange, dispose, applyPreset };
538
+ }
539
+
540
+ return { create, presets };
541
+ }
542
+ };