@awacloud/fw 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1057) hide show
  1. package/CHANGELOG.md +79 -0
  2. package/LICENSE +176 -0
  3. package/NOTICE +12 -0
  4. package/README.md +355 -0
  5. package/dist/build/fw.core.pure.meta.json +29 -0
  6. package/dist/build/fw.core.pure.min.js +26 -0
  7. package/dist/build/fw.full.pure.meta.json +224 -0
  8. package/dist/build/fw.full.pure.min.js +60 -0
  9. package/dist/build/fw.minimal.pure.meta.json +21 -0
  10. package/dist/build/fw.minimal.pure.min.js +26 -0
  11. package/dist/build/fw.pack.compress-heavy.pure.meta.json +29 -0
  12. package/dist/build/fw.pack.compress-heavy.pure.min.js +8 -0
  13. package/dist/build/fw.pack.crypto-advanced.pure.meta.json +38 -0
  14. package/dist/build/fw.pack.crypto-advanced.pure.min.js +6 -0
  15. package/dist/build/fw.pack.crypto-basic.pure.meta.json +29 -0
  16. package/dist/build/fw.pack.crypto-basic.pure.min.js +6 -0
  17. package/dist/build/fw.pack.crypto-identity.pure.meta.json +29 -0
  18. package/dist/build/fw.pack.crypto-identity.pure.min.js +9 -0
  19. package/dist/build/fw.pack.realtime.pure.meta.json +21 -0
  20. package/dist/build/fw.pack.realtime.pure.min.js +6 -0
  21. package/dist/build/fw.pack.sensors.pure.meta.json +21 -0
  22. package/dist/build/fw.pack.sensors.pure.min.js +6 -0
  23. package/dist/build/fw.pack.structures-advanced.pure.meta.json +20 -0
  24. package/dist/build/fw.pack.structures-advanced.pure.min.js +6 -0
  25. package/dist/build/fw.pack.text-advanced.pure.meta.json +20 -0
  26. package/dist/build/fw.pack.text-advanced.pure.min.js +6 -0
  27. package/dist/build/fw.pwa.pure.meta.json +127 -0
  28. package/dist/build/fw.pwa.pure.min.js +55 -0
  29. package/dist/build/fw.site-interactive.pure.meta.json +81 -0
  30. package/dist/build/fw.site-interactive.pure.min.js +52 -0
  31. package/dist/build/fw.site.pure.meta.json +51 -0
  32. package/dist/build/fw.site.pure.min.js +35 -0
  33. package/dist/build/fw.spa.pure.meta.json +108 -0
  34. package/dist/build/fw.spa.pure.min.js +55 -0
  35. package/dist/build/io/compress/brotli_dict.bin +432 -0
  36. package/dist/build/sanity-base-classic.min.js +6 -0
  37. package/dist/build/sanity-community-classic.min.js +6 -0
  38. package/dist/build/sanity.min.js +6 -0
  39. package/dist/types/core/logger.d.ts +71 -0
  40. package/dist/types/core/logger.d.ts.map +1 -0
  41. package/dist/types/core/modules.d.ts +3962 -0
  42. package/dist/types/core/modules.d.ts.map +1 -0
  43. package/dist/types/core/readyState.d.ts +14 -0
  44. package/dist/types/core/readyState.d.ts.map +1 -0
  45. package/dist/types/core/runtime.d.ts +625 -0
  46. package/dist/types/core/runtime.d.ts.map +1 -0
  47. package/dist/types/core/worker-helper.d.ts +153 -0
  48. package/dist/types/core/worker-helper.d.ts.map +1 -0
  49. package/dist/types/crypto/cipher/aes.d.ts +55 -0
  50. package/dist/types/crypto/cipher/aes.d.ts.map +1 -0
  51. package/dist/types/crypto/cipher/chacha20.d.ts +33 -0
  52. package/dist/types/crypto/cipher/chacha20.d.ts.map +1 -0
  53. package/dist/types/crypto/hash/adf.d.ts +65 -0
  54. package/dist/types/crypto/hash/adf.d.ts.map +1 -0
  55. package/dist/types/crypto/hash/argon2.d.ts +79 -0
  56. package/dist/types/crypto/hash/argon2.d.ts.map +1 -0
  57. package/dist/types/crypto/hash/blake2b.d.ts +40 -0
  58. package/dist/types/crypto/hash/blake2b.d.ts.map +1 -0
  59. package/dist/types/crypto/hash/hkdf.d.ts +88 -0
  60. package/dist/types/crypto/hash/hkdf.d.ts.map +1 -0
  61. package/dist/types/crypto/hash/hmac.d.ts +85 -0
  62. package/dist/types/crypto/hash/hmac.d.ts.map +1 -0
  63. package/dist/types/crypto/hash/pbkdf2.d.ts +80 -0
  64. package/dist/types/crypto/hash/pbkdf2.d.ts.map +1 -0
  65. package/dist/types/crypto/hash/poly1305.d.ts +31 -0
  66. package/dist/types/crypto/hash/poly1305.d.ts.map +1 -0
  67. package/dist/types/crypto/hash/sha224.d.ts +80 -0
  68. package/dist/types/crypto/hash/sha224.d.ts.map +1 -0
  69. package/dist/types/crypto/hash/sha256.d.ts +82 -0
  70. package/dist/types/crypto/hash/sha256.d.ts.map +1 -0
  71. package/dist/types/crypto/hash/sha3.d.ts +111 -0
  72. package/dist/types/crypto/hash/sha3.d.ts.map +1 -0
  73. package/dist/types/crypto/hash/sha384.d.ts +84 -0
  74. package/dist/types/crypto/hash/sha384.d.ts.map +1 -0
  75. package/dist/types/crypto/hash/sha512.d.ts +87 -0
  76. package/dist/types/crypto/hash/sha512.d.ts.map +1 -0
  77. package/dist/types/crypto/hash/sha512_224.d.ts +84 -0
  78. package/dist/types/crypto/hash/sha512_224.d.ts.map +1 -0
  79. package/dist/types/crypto/hash/sha512_256.d.ts +84 -0
  80. package/dist/types/crypto/hash/sha512_256.d.ts.map +1 -0
  81. package/dist/types/crypto/mode/cbc.d.ts +38 -0
  82. package/dist/types/crypto/mode/cbc.d.ts.map +1 -0
  83. package/dist/types/crypto/mode/chacha20poly1305.d.ts +71 -0
  84. package/dist/types/crypto/mode/chacha20poly1305.d.ts.map +1 -0
  85. package/dist/types/crypto/mode/cmac.d.ts +56 -0
  86. package/dist/types/crypto/mode/cmac.d.ts.map +1 -0
  87. package/dist/types/crypto/mode/ctr.d.ts +52 -0
  88. package/dist/types/crypto/mode/ctr.d.ts.map +1 -0
  89. package/dist/types/crypto/mode/gcm.d.ts +88 -0
  90. package/dist/types/crypto/mode/gcm.d.ts.map +1 -0
  91. package/dist/types/crypto/mode/kw.d.ts +60 -0
  92. package/dist/types/crypto/mode/kw.d.ts.map +1 -0
  93. package/dist/types/crypto/pkc/ecc.d.ts +284 -0
  94. package/dist/types/crypto/pkc/ecc.d.ts.map +1 -0
  95. package/dist/types/crypto/pkc/ed25519.d.ts +107 -0
  96. package/dist/types/crypto/pkc/ed25519.d.ts.map +1 -0
  97. package/dist/types/crypto/pkc/hybridKem.d.ts +154 -0
  98. package/dist/types/crypto/pkc/hybridKem.d.ts.map +1 -0
  99. package/dist/types/crypto/pkc/hybridSign.d.ts +383 -0
  100. package/dist/types/crypto/pkc/hybridSign.d.ts.map +1 -0
  101. package/dist/types/crypto/pkc/ml_dsa.d.ts +174 -0
  102. package/dist/types/crypto/pkc/ml_dsa.d.ts.map +1 -0
  103. package/dist/types/crypto/pkc/ml_kem.d.ts +194 -0
  104. package/dist/types/crypto/pkc/ml_kem.d.ts.map +1 -0
  105. package/dist/types/crypto/pkc/rsa.d.ts +175 -0
  106. package/dist/types/crypto/pkc/rsa.d.ts.map +1 -0
  107. package/dist/types/crypto/pkc/slh_dsa.d.ts +232 -0
  108. package/dist/types/crypto/pkc/slh_dsa.d.ts.map +1 -0
  109. package/dist/types/crypto/pkc/x25519.d.ts +37 -0
  110. package/dist/types/crypto/pkc/x25519.d.ts.map +1 -0
  111. package/dist/types/crypto/utils/aes_ctr.d.ts +84 -0
  112. package/dist/types/crypto/utils/aes_ctr.d.ts.map +1 -0
  113. package/dist/types/crypto/utils/aes_modes.d.ts +128 -0
  114. package/dist/types/crypto/utils/aes_modes.d.ts.map +1 -0
  115. package/dist/types/crypto/utils/asn1-oid.d.ts +45 -0
  116. package/dist/types/crypto/utils/asn1-oid.d.ts.map +1 -0
  117. package/dist/types/crypto/utils/asn1.d.ts +115 -0
  118. package/dist/types/crypto/utils/asn1.d.ts.map +1 -0
  119. package/dist/types/crypto/utils/bitArray.d.ts +75 -0
  120. package/dist/types/crypto/utils/bitArray.d.ts.map +1 -0
  121. package/dist/types/crypto/utils/bn.d.ts +214 -0
  122. package/dist/types/crypto/utils/bn.d.ts.map +1 -0
  123. package/dist/types/crypto/utils/jws.d.ts +159 -0
  124. package/dist/types/crypto/utils/jws.d.ts.map +1 -0
  125. package/dist/types/crypto/utils/keyformat.d.ts +100 -0
  126. package/dist/types/crypto/utils/keyformat.d.ts.map +1 -0
  127. package/dist/types/crypto/utils/pad.d.ts +44 -0
  128. package/dist/types/crypto/utils/pad.d.ts.map +1 -0
  129. package/dist/types/crypto/utils/pem.d.ts +41 -0
  130. package/dist/types/crypto/utils/pem.d.ts.map +1 -0
  131. package/dist/types/crypto/utils/random.d.ts +203 -0
  132. package/dist/types/crypto/utils/random.d.ts.map +1 -0
  133. package/dist/types/crypto/utils/rsaKeygen.d.ts +162 -0
  134. package/dist/types/crypto/utils/rsaKeygen.d.ts.map +1 -0
  135. package/dist/types/crypto/utils/totp.d.ts +183 -0
  136. package/dist/types/crypto/utils/totp.d.ts.map +1 -0
  137. package/dist/types/crypto/utils/uuid.d.ts +29 -0
  138. package/dist/types/crypto/utils/uuid.d.ts.map +1 -0
  139. package/dist/types/crypto/wasm/aes.d.ts +59 -0
  140. package/dist/types/crypto/wasm/aes.d.ts.map +1 -0
  141. package/dist/types/crypto/wasm/argon2.d.ts +70 -0
  142. package/dist/types/crypto/wasm/argon2.d.ts.map +1 -0
  143. package/dist/types/crypto/wasm/blake2b.d.ts +59 -0
  144. package/dist/types/crypto/wasm/blake2b.d.ts.map +1 -0
  145. package/dist/types/crypto/wasm/chacha20poly1305.d.ts +43 -0
  146. package/dist/types/crypto/wasm/chacha20poly1305.d.ts.map +1 -0
  147. package/dist/types/crypto/wasm/cmac.d.ts +42 -0
  148. package/dist/types/crypto/wasm/cmac.d.ts.map +1 -0
  149. package/dist/types/crypto/wasm/ecc.d.ts +56 -0
  150. package/dist/types/crypto/wasm/ecc.d.ts.map +1 -0
  151. package/dist/types/crypto/wasm/ed25519.d.ts +52 -0
  152. package/dist/types/crypto/wasm/ed25519.d.ts.map +1 -0
  153. package/dist/types/crypto/wasm/hkdf.d.ts +40 -0
  154. package/dist/types/crypto/wasm/hkdf.d.ts.map +1 -0
  155. package/dist/types/crypto/wasm/hmac.d.ts +42 -0
  156. package/dist/types/crypto/wasm/hmac.d.ts.map +1 -0
  157. package/dist/types/crypto/wasm/ml_dsa.d.ts +48 -0
  158. package/dist/types/crypto/wasm/ml_dsa.d.ts.map +1 -0
  159. package/dist/types/crypto/wasm/ml_kem.d.ts +58 -0
  160. package/dist/types/crypto/wasm/ml_kem.d.ts.map +1 -0
  161. package/dist/types/crypto/wasm/pbkdf2.d.ts +38 -0
  162. package/dist/types/crypto/wasm/pbkdf2.d.ts.map +1 -0
  163. package/dist/types/crypto/wasm/rsa.d.ts +56 -0
  164. package/dist/types/crypto/wasm/rsa.d.ts.map +1 -0
  165. package/dist/types/crypto/wasm/runtime.d.ts +99 -0
  166. package/dist/types/crypto/wasm/runtime.d.ts.map +1 -0
  167. package/dist/types/crypto/wasm/sha2.d.ts +45 -0
  168. package/dist/types/crypto/wasm/sha2.d.ts.map +1 -0
  169. package/dist/types/crypto/wasm/sha3.d.ts +57 -0
  170. package/dist/types/crypto/wasm/sha3.d.ts.map +1 -0
  171. package/dist/types/crypto/wasm/slh_dsa.d.ts +62 -0
  172. package/dist/types/crypto/wasm/slh_dsa.d.ts.map +1 -0
  173. package/dist/types/crypto/wasm/x25519.d.ts +53 -0
  174. package/dist/types/crypto/wasm/x25519.d.ts.map +1 -0
  175. package/dist/types/crypto/webcrypto/aes.d.ts +59 -0
  176. package/dist/types/crypto/webcrypto/aes.d.ts.map +1 -0
  177. package/dist/types/crypto/webcrypto/aeskw.d.ts +40 -0
  178. package/dist/types/crypto/webcrypto/aeskw.d.ts.map +1 -0
  179. package/dist/types/crypto/webcrypto/digest.d.ts +43 -0
  180. package/dist/types/crypto/webcrypto/digest.d.ts.map +1 -0
  181. package/dist/types/crypto/webcrypto/ecc.d.ts +51 -0
  182. package/dist/types/crypto/webcrypto/ecc.d.ts.map +1 -0
  183. package/dist/types/crypto/webcrypto/ed25519.d.ts +43 -0
  184. package/dist/types/crypto/webcrypto/ed25519.d.ts.map +1 -0
  185. package/dist/types/crypto/webcrypto/hkdf.d.ts +18 -0
  186. package/dist/types/crypto/webcrypto/hkdf.d.ts.map +1 -0
  187. package/dist/types/crypto/webcrypto/hmac.d.ts +43 -0
  188. package/dist/types/crypto/webcrypto/hmac.d.ts.map +1 -0
  189. package/dist/types/crypto/webcrypto/pbkdf2.d.ts +18 -0
  190. package/dist/types/crypto/webcrypto/pbkdf2.d.ts.map +1 -0
  191. package/dist/types/crypto/webcrypto/rsa.d.ts +51 -0
  192. package/dist/types/crypto/webcrypto/rsa.d.ts.map +1 -0
  193. package/dist/types/crypto/webcrypto/x25519.d.ts +43 -0
  194. package/dist/types/crypto/webcrypto/x25519.d.ts.map +1 -0
  195. package/dist/types/dom/display/animate.d.ts +35 -0
  196. package/dist/types/dom/display/animate.d.ts.map +1 -0
  197. package/dist/types/dom/display/fullscreen.d.ts +59 -0
  198. package/dist/types/dom/display/fullscreen.d.ts.map +1 -0
  199. package/dist/types/dom/fs/download.d.ts +36 -0
  200. package/dist/types/dom/fs/download.d.ts.map +1 -0
  201. package/dist/types/dom/fs/fsAccess.d.ts +107 -0
  202. package/dist/types/dom/fs/fsAccess.d.ts.map +1 -0
  203. package/dist/types/dom/fs/indexedDB.d.ts +62 -0
  204. package/dist/types/dom/fs/indexedDB.d.ts.map +1 -0
  205. package/dist/types/dom/fs/remoteStore.d.ts +64 -0
  206. package/dist/types/dom/fs/remoteStore.d.ts.map +1 -0
  207. package/dist/types/dom/fs/storage.d.ts +56 -0
  208. package/dist/types/dom/fs/storage.d.ts.map +1 -0
  209. package/dist/types/dom/lifecycle/idle.d.ts +91 -0
  210. package/dist/types/dom/lifecycle/idle.d.ts.map +1 -0
  211. package/dist/types/dom/lifecycle/visibility.d.ts +49 -0
  212. package/dist/types/dom/lifecycle/visibility.d.ts.map +1 -0
  213. package/dist/types/dom/lifecycle/wakeLock.d.ts +69 -0
  214. package/dist/types/dom/lifecycle/wakeLock.d.ts.map +1 -0
  215. package/dist/types/dom/net/ajax.d.ts +27 -0
  216. package/dist/types/dom/net/ajax.d.ts.map +1 -0
  217. package/dist/types/dom/net/broadcastChannel.d.ts +51 -0
  218. package/dist/types/dom/net/broadcastChannel.d.ts.map +1 -0
  219. package/dist/types/dom/net/network.d.ts +80 -0
  220. package/dist/types/dom/net/network.d.ts.map +1 -0
  221. package/dist/types/dom/net/sse.d.ts +72 -0
  222. package/dist/types/dom/net/sse.d.ts.map +1 -0
  223. package/dist/types/dom/net/webrtc.d.ts +149 -0
  224. package/dist/types/dom/net/webrtc.d.ts.map +1 -0
  225. package/dist/types/dom/net/ws.d.ts +70 -0
  226. package/dist/types/dom/net/ws.d.ts.map +1 -0
  227. package/dist/types/dom/query/dnd.d.ts +86 -0
  228. package/dist/types/dom/query/dnd.d.ts.map +1 -0
  229. package/dist/types/dom/query/dom.d.ts +194 -0
  230. package/dist/types/dom/query/dom.d.ts.map +1 -0
  231. package/dist/types/dom/query/events.d.ts +135 -0
  232. package/dist/types/dom/query/events.d.ts.map +1 -0
  233. package/dist/types/dom/query/gesture.d.ts +59 -0
  234. package/dist/types/dom/query/gesture.d.ts.map +1 -0
  235. package/dist/types/dom/query/media.d.ts +156 -0
  236. package/dist/types/dom/query/media.d.ts.map +1 -0
  237. package/dist/types/dom/rendering/chart.d.ts +143 -0
  238. package/dist/types/dom/rendering/chart.d.ts.map +1 -0
  239. package/dist/types/dom/rendering/component.d.ts +92 -0
  240. package/dist/types/dom/rendering/component.d.ts.map +1 -0
  241. package/dist/types/dom/rendering/devtools-ui.d.ts +83 -0
  242. package/dist/types/dom/rendering/devtools-ui.d.ts.map +1 -0
  243. package/dist/types/dom/rendering/devtools.d.ts +68 -0
  244. package/dist/types/dom/rendering/devtools.d.ts.map +1 -0
  245. package/dist/types/dom/rendering/parser.d.ts +216 -0
  246. package/dist/types/dom/rendering/parser.d.ts.map +1 -0
  247. package/dist/types/dom/rendering/reactiveBind.d.ts +101 -0
  248. package/dist/types/dom/rendering/reactiveBind.d.ts.map +1 -0
  249. package/dist/types/dom/rendering/render.d.ts +121 -0
  250. package/dist/types/dom/rendering/render.d.ts.map +1 -0
  251. package/dist/types/dom/rendering/sanitize.d.ts +48 -0
  252. package/dist/types/dom/rendering/sanitize.d.ts.map +1 -0
  253. package/dist/types/dom/rendering/secPolicy.d.ts +89 -0
  254. package/dist/types/dom/rendering/secPolicy.d.ts.map +1 -0
  255. package/dist/types/dom/rendering/template.d.ts +251 -0
  256. package/dist/types/dom/rendering/template.d.ts.map +1 -0
  257. package/dist/types/dom/rendering/themeTokens.d.ts +61 -0
  258. package/dist/types/dom/rendering/themeTokens.d.ts.map +1 -0
  259. package/dist/types/dom/rendering/uiSession-core.d.ts +192 -0
  260. package/dist/types/dom/rendering/uiSession-core.d.ts.map +1 -0
  261. package/dist/types/dom/rendering/uiSession-direct.d.ts +63 -0
  262. package/dist/types/dom/rendering/uiSession-direct.d.ts.map +1 -0
  263. package/dist/types/dom/rendering/uiSession-list.d.ts +205 -0
  264. package/dist/types/dom/rendering/uiSession-list.d.ts.map +1 -0
  265. package/dist/types/dom/rendering/uiSession.d.ts +285 -0
  266. package/dist/types/dom/rendering/uiSession.d.ts.map +1 -0
  267. package/dist/types/dom/rendering/virtualScroll.d.ts +80 -0
  268. package/dist/types/dom/rendering/virtualScroll.d.ts.map +1 -0
  269. package/dist/types/dom/sensors/battery.d.ts +71 -0
  270. package/dist/types/dom/sensors/battery.d.ts.map +1 -0
  271. package/dist/types/dom/sensors/geolocation.d.ts +83 -0
  272. package/dist/types/dom/sensors/geolocation.d.ts.map +1 -0
  273. package/dist/types/dom/sensors/networkInfo.d.ts +82 -0
  274. package/dist/types/dom/sensors/networkInfo.d.ts.map +1 -0
  275. package/dist/types/dom/sensors/sensors.d.ts +191 -0
  276. package/dist/types/dom/sensors/sensors.d.ts.map +1 -0
  277. package/dist/types/dom/sw/backgroundSync.d.ts +48 -0
  278. package/dist/types/dom/sw/backgroundSync.d.ts.map +1 -0
  279. package/dist/types/dom/sw/cache.d.ts +71 -0
  280. package/dist/types/dom/sw/cache.d.ts.map +1 -0
  281. package/dist/types/dom/sw/push.d.ts +77 -0
  282. package/dist/types/dom/sw/push.d.ts.map +1 -0
  283. package/dist/types/dom/sw/serviceWorker.d.ts +57 -0
  284. package/dist/types/dom/sw/serviceWorker.d.ts.map +1 -0
  285. package/dist/types/dom/sw/sharedWorker.d.ts +81 -0
  286. package/dist/types/dom/sw/sharedWorker.d.ts.map +1 -0
  287. package/dist/types/dom/utils/a11y.d.ts +53 -0
  288. package/dist/types/dom/utils/a11y.d.ts.map +1 -0
  289. package/dist/types/dom/utils/clipboard.d.ts +44 -0
  290. package/dist/types/dom/utils/clipboard.d.ts.map +1 -0
  291. package/dist/types/dom/utils/entropyCollector.d.ts +58 -0
  292. package/dist/types/dom/utils/entropyCollector.d.ts.map +1 -0
  293. package/dist/types/dom/utils/focus.d.ts +123 -0
  294. package/dist/types/dom/utils/focus.d.ts.map +1 -0
  295. package/dist/types/dom/utils/form.d.ts +227 -0
  296. package/dist/types/dom/utils/form.d.ts.map +1 -0
  297. package/dist/types/dom/utils/formKit.d.ts +206 -0
  298. package/dist/types/dom/utils/formKit.d.ts.map +1 -0
  299. package/dist/types/dom/utils/keybindings.d.ts +53 -0
  300. package/dist/types/dom/utils/keybindings.d.ts.map +1 -0
  301. package/dist/types/dom/utils/leaderElection.d.ts +70 -0
  302. package/dist/types/dom/utils/leaderElection.d.ts.map +1 -0
  303. package/dist/types/dom/utils/notifications.d.ts +164 -0
  304. package/dist/types/dom/utils/notifications.d.ts.map +1 -0
  305. package/dist/types/dom/utils/permissions.d.ts +35 -0
  306. package/dist/types/dom/utils/permissions.d.ts.map +1 -0
  307. package/dist/types/dom/utils/route.d.ts +117 -0
  308. package/dist/types/dom/utils/route.d.ts.map +1 -0
  309. package/dist/types/dom/utils/ua.d.ts +35 -0
  310. package/dist/types/dom/utils/ua.d.ts.map +1 -0
  311. package/dist/types/dom/utils/webauthn.d.ts +98 -0
  312. package/dist/types/dom/utils/webauthn.d.ts.map +1 -0
  313. package/dist/types/io/binary/reader.d.ts +59 -0
  314. package/dist/types/io/binary/reader.d.ts.map +1 -0
  315. package/dist/types/io/binary/writer.d.ts +56 -0
  316. package/dist/types/io/binary/writer.d.ts.map +1 -0
  317. package/dist/types/io/calc/adler32.d.ts +31 -0
  318. package/dist/types/io/calc/adler32.d.ts.map +1 -0
  319. package/dist/types/io/calc/bigint.d.ts +74 -0
  320. package/dist/types/io/calc/bigint.d.ts.map +1 -0
  321. package/dist/types/io/calc/crc32.d.ts +36 -0
  322. package/dist/types/io/calc/crc32.d.ts.map +1 -0
  323. package/dist/types/io/calc/easing.d.ts +60 -0
  324. package/dist/types/io/calc/easing.d.ts.map +1 -0
  325. package/dist/types/io/codec/b64.d.ts +28 -0
  326. package/dist/types/io/codec/b64.d.ts.map +1 -0
  327. package/dist/types/io/codec/base32.d.ts +28 -0
  328. package/dist/types/io/codec/base32.d.ts.map +1 -0
  329. package/dist/types/io/codec/base58.d.ts +28 -0
  330. package/dist/types/io/codec/base58.d.ts.map +1 -0
  331. package/dist/types/io/codec/buffer.d.ts +66 -0
  332. package/dist/types/io/codec/buffer.d.ts.map +1 -0
  333. package/dist/types/io/codec/cbor.d.ts +43 -0
  334. package/dist/types/io/codec/cbor.d.ts.map +1 -0
  335. package/dist/types/io/codec/csv.d.ts +35 -0
  336. package/dist/types/io/codec/csv.d.ts.map +1 -0
  337. package/dist/types/io/codec/hex.d.ts +28 -0
  338. package/dist/types/io/codec/hex.d.ts.map +1 -0
  339. package/dist/types/io/codec/mime.d.ts +100 -0
  340. package/dist/types/io/codec/mime.d.ts.map +1 -0
  341. package/dist/types/io/codec/msgpack.d.ts +36 -0
  342. package/dist/types/io/codec/msgpack.d.ts.map +1 -0
  343. package/dist/types/io/codec/url.d.ts +52 -0
  344. package/dist/types/io/codec/url.d.ts.map +1 -0
  345. package/dist/types/io/codec/utf8.d.ts +22 -0
  346. package/dist/types/io/codec/utf8.d.ts.map +1 -0
  347. package/dist/types/io/codec/xml.d.ts +91 -0
  348. package/dist/types/io/codec/xml.d.ts.map +1 -0
  349. package/dist/types/io/compress/bitstream.d.ts +51 -0
  350. package/dist/types/io/compress/bitstream.d.ts.map +1 -0
  351. package/dist/types/io/compress/brotli.d.ts +86 -0
  352. package/dist/types/io/compress/brotli.d.ts.map +1 -0
  353. package/dist/types/io/compress/brotli_dict.d.ts +76 -0
  354. package/dist/types/io/compress/brotli_dict.d.ts.map +1 -0
  355. package/dist/types/io/compress/brotli_dict_words.d.ts +43 -0
  356. package/dist/types/io/compress/brotli_dict_words.d.ts.map +1 -0
  357. package/dist/types/io/compress/brotli_frame.d.ts +166 -0
  358. package/dist/types/io/compress/brotli_frame.d.ts.map +1 -0
  359. package/dist/types/io/compress/brotli_shared.d.ts +165 -0
  360. package/dist/types/io/compress/brotli_shared.d.ts.map +1 -0
  361. package/dist/types/io/compress/deflate.d.ts +89 -0
  362. package/dist/types/io/compress/deflate.d.ts.map +1 -0
  363. package/dist/types/io/compress/gzip.d.ts +100 -0
  364. package/dist/types/io/compress/gzip.d.ts.map +1 -0
  365. package/dist/types/io/compress/huffman.d.ts +37 -0
  366. package/dist/types/io/compress/huffman.d.ts.map +1 -0
  367. package/dist/types/io/compress/lz4.d.ts +45 -0
  368. package/dist/types/io/compress/lz4.d.ts.map +1 -0
  369. package/dist/types/io/compress/lz77.d.ts +66 -0
  370. package/dist/types/io/compress/lz77.d.ts.map +1 -0
  371. package/dist/types/io/compress/lzw.d.ts +37 -0
  372. package/dist/types/io/compress/lzw.d.ts.map +1 -0
  373. package/dist/types/io/compress/zip.d.ts +112 -0
  374. package/dist/types/io/compress/zip.d.ts.map +1 -0
  375. package/dist/types/io/compress/zlib.d.ts +97 -0
  376. package/dist/types/io/compress/zlib.d.ts.map +1 -0
  377. package/dist/types/io/i18n/i18n.d.ts +64 -0
  378. package/dist/types/io/i18n/i18n.d.ts.map +1 -0
  379. package/dist/types/io/math/fixed-point.d.ts +30 -0
  380. package/dist/types/io/math/fixed-point.d.ts.map +1 -0
  381. package/dist/types/io/math/geom.d.ts +125 -0
  382. package/dist/types/io/math/geom.d.ts.map +1 -0
  383. package/dist/types/io/math/interp.d.ts +48 -0
  384. package/dist/types/io/math/interp.d.ts.map +1 -0
  385. package/dist/types/io/math/linalg.d.ts +117 -0
  386. package/dist/types/io/math/linalg.d.ts.map +1 -0
  387. package/dist/types/io/math/stats.d.ts +45 -0
  388. package/dist/types/io/math/stats.d.ts.map +1 -0
  389. package/dist/types/io/structures/btree.d.ts +84 -0
  390. package/dist/types/io/structures/btree.d.ts.map +1 -0
  391. package/dist/types/io/structures/heap.d.ts +75 -0
  392. package/dist/types/io/structures/heap.d.ts.map +1 -0
  393. package/dist/types/io/structures/lruCache.d.ts +88 -0
  394. package/dist/types/io/structures/lruCache.d.ts.map +1 -0
  395. package/dist/types/io/structures/ringBuffer.d.ts +82 -0
  396. package/dist/types/io/structures/ringBuffer.d.ts.map +1 -0
  397. package/dist/types/io/structures/tree-walker.d.ts +95 -0
  398. package/dist/types/io/structures/tree-walker.d.ts.map +1 -0
  399. package/dist/types/io/structures/trie.d.ts +71 -0
  400. package/dist/types/io/structures/trie.d.ts.map +1 -0
  401. package/dist/types/io/sync/abort.d.ts +59 -0
  402. package/dist/types/io/sync/abort.d.ts.map +1 -0
  403. package/dist/types/io/sync/atomics.d.ts +107 -0
  404. package/dist/types/io/sync/atomics.d.ts.map +1 -0
  405. package/dist/types/io/sync/cancellable.d.ts +69 -0
  406. package/dist/types/io/sync/cancellable.d.ts.map +1 -0
  407. package/dist/types/io/sync/channel.d.ts +70 -0
  408. package/dist/types/io/sync/channel.d.ts.map +1 -0
  409. package/dist/types/io/sync/mutex.d.ts +39 -0
  410. package/dist/types/io/sync/mutex.d.ts.map +1 -0
  411. package/dist/types/io/sync/semaphore.d.ts +40 -0
  412. package/dist/types/io/sync/semaphore.d.ts.map +1 -0
  413. package/dist/types/io/sync/tokenBucket.d.ts +53 -0
  414. package/dist/types/io/sync/tokenBucket.d.ts.map +1 -0
  415. package/dist/types/io/text/ansi.d.ts +125 -0
  416. package/dist/types/io/text/ansi.d.ts.map +1 -0
  417. package/dist/types/io/text/html-entities.d.ts +35 -0
  418. package/dist/types/io/text/html-entities.d.ts.map +1 -0
  419. package/dist/types/io/text/semver.d.ts +75 -0
  420. package/dist/types/io/text/semver.d.ts.map +1 -0
  421. package/dist/types/io/text/str.d.ts +88 -0
  422. package/dist/types/io/text/str.d.ts.map +1 -0
  423. package/dist/types/io/text/unicode.d.ts +70 -0
  424. package/dist/types/io/text/unicode.d.ts.map +1 -0
  425. package/dist/types/io/time/date.d.ts +73 -0
  426. package/dist/types/io/time/date.d.ts.map +1 -0
  427. package/dist/types/io/timing/clock.d.ts +39 -0
  428. package/dist/types/io/timing/clock.d.ts.map +1 -0
  429. package/dist/types/io/timing/rateLimit.d.ts +40 -0
  430. package/dist/types/io/timing/rateLimit.d.ts.map +1 -0
  431. package/dist/types/io/timing/scheduler.d.ts +122 -0
  432. package/dist/types/io/timing/scheduler.d.ts.map +1 -0
  433. package/dist/types/io/utils/bitmap.d.ts +34 -0
  434. package/dist/types/io/utils/bitmap.d.ts.map +1 -0
  435. package/dist/types/io/utils/errors.d.ts +94 -0
  436. package/dist/types/io/utils/errors.d.ts.map +1 -0
  437. package/dist/types/io/utils/eventBus.d.ts +68 -0
  438. package/dist/types/io/utils/eventBus.d.ts.map +1 -0
  439. package/dist/types/io/utils/queue.d.ts +69 -0
  440. package/dist/types/io/utils/queue.d.ts.map +1 -0
  441. package/dist/types/io/utils/signal.d.ts +362 -0
  442. package/dist/types/io/utils/signal.d.ts.map +1 -0
  443. package/dist/types/io/utils/ui8.d.ts +34 -0
  444. package/dist/types/io/utils/ui8.d.ts.map +1 -0
  445. package/dist/types/io/utils/valid.d.ts +130 -0
  446. package/dist/types/io/utils/valid.d.ts.map +1 -0
  447. package/dist/types/main.d.ts +25 -0
  448. package/dist/types/main.d.ts.map +1 -0
  449. package/dist/types/process/message.d.ts +64 -0
  450. package/dist/types/process/message.d.ts.map +1 -0
  451. package/dist/types/process/rpc.d.ts +35 -0
  452. package/dist/types/process/rpc.d.ts.map +1 -0
  453. package/dist/types/process/workerPool.d.ts +62 -0
  454. package/dist/types/process/workerPool.d.ts.map +1 -0
  455. package/dist/types/sanity/base.d.ts +28 -0
  456. package/dist/types/sanity/base.d.ts.map +1 -0
  457. package/dist/types/sanity/community.d.ts +20 -0
  458. package/dist/types/sanity/community.d.ts.map +1 -0
  459. package/dist/types/sanity/lockdown-apply.d.ts +7 -0
  460. package/dist/types/sanity/lockdown-apply.d.ts.map +1 -0
  461. package/dist/types/sanity/lockdown.d.ts +43 -0
  462. package/dist/types/sanity/lockdown.d.ts.map +1 -0
  463. package/dist/types/sanity/wasm-gate.d.ts +128 -0
  464. package/dist/types/sanity/wasm-gate.d.ts.map +1 -0
  465. package/docs/README.md +301 -0
  466. package/docs/api/README.md +33 -0
  467. package/docs/api/core/README.md +14 -0
  468. package/docs/api/core/logger.md +151 -0
  469. package/docs/api/core/main.md +105 -0
  470. package/docs/api/core/modules.md +123 -0
  471. package/docs/api/core/readyState.md +94 -0
  472. package/docs/api/core/runtime.md +499 -0
  473. package/docs/api/core/worker-helper.md +180 -0
  474. package/docs/api/crypto/README.md +39 -0
  475. package/docs/api/crypto/cipher/README.md +24 -0
  476. package/docs/api/crypto/cipher/aes.md +101 -0
  477. package/docs/api/crypto/cipher/chacha20.md +85 -0
  478. package/docs/api/crypto/hash/README.md +49 -0
  479. package/docs/api/crypto/hash/adf.md +61 -0
  480. package/docs/api/crypto/hash/argon2.md +92 -0
  481. package/docs/api/crypto/hash/blake2b.md +88 -0
  482. package/docs/api/crypto/hash/hkdf.md +82 -0
  483. package/docs/api/crypto/hash/hmac.md +90 -0
  484. package/docs/api/crypto/hash/pbkdf2.md +93 -0
  485. package/docs/api/crypto/hash/poly1305.md +71 -0
  486. package/docs/api/crypto/hash/sha224.md +61 -0
  487. package/docs/api/crypto/hash/sha256.md +84 -0
  488. package/docs/api/crypto/hash/sha3.md +89 -0
  489. package/docs/api/crypto/hash/sha384.md +58 -0
  490. package/docs/api/crypto/hash/sha512.md +73 -0
  491. package/docs/api/crypto/hash/sha512_224.md +59 -0
  492. package/docs/api/crypto/hash/sha512_256.md +58 -0
  493. package/docs/api/crypto/mode/README.md +33 -0
  494. package/docs/api/crypto/mode/cbc.md +69 -0
  495. package/docs/api/crypto/mode/chacha20poly1305.md +77 -0
  496. package/docs/api/crypto/mode/cmac.md +79 -0
  497. package/docs/api/crypto/mode/ctr.md +66 -0
  498. package/docs/api/crypto/mode/gcm.md +93 -0
  499. package/docs/api/crypto/mode/kw.md +84 -0
  500. package/docs/api/crypto/pkc/README.md +48 -0
  501. package/docs/api/crypto/pkc/ecc.md +91 -0
  502. package/docs/api/crypto/pkc/ed25519.md +99 -0
  503. package/docs/api/crypto/pkc/hybridKem.md +178 -0
  504. package/docs/api/crypto/pkc/hybridSign.md +192 -0
  505. package/docs/api/crypto/pkc/ml_dsa.md +99 -0
  506. package/docs/api/crypto/pkc/ml_kem.md +90 -0
  507. package/docs/api/crypto/pkc/rsa.md +87 -0
  508. package/docs/api/crypto/pkc/slh_dsa.md +86 -0
  509. package/docs/api/crypto/pkc/x25519.md +84 -0
  510. package/docs/api/crypto/utils/README.md +39 -0
  511. package/docs/api/crypto/utils/aes_ctr.md +71 -0
  512. package/docs/api/crypto/utils/aes_modes.md +81 -0
  513. package/docs/api/crypto/utils/asn1-oid.md +130 -0
  514. package/docs/api/crypto/utils/asn1.md +69 -0
  515. package/docs/api/crypto/utils/bitArray.md +77 -0
  516. package/docs/api/crypto/utils/bn.md +67 -0
  517. package/docs/api/crypto/utils/jws.md +94 -0
  518. package/docs/api/crypto/utils/keyformat.md +78 -0
  519. package/docs/api/crypto/utils/pad.md +66 -0
  520. package/docs/api/crypto/utils/pem.md +63 -0
  521. package/docs/api/crypto/utils/random.md +103 -0
  522. package/docs/api/crypto/utils/rsaKeygen.md +118 -0
  523. package/docs/api/crypto/utils/totp.md +159 -0
  524. package/docs/api/crypto/utils/uuid.md +98 -0
  525. package/docs/api/crypto/wasm/README.md +76 -0
  526. package/docs/api/crypto/wasm/aes.md +128 -0
  527. package/docs/api/crypto/wasm/argon2.md +110 -0
  528. package/docs/api/crypto/wasm/blake2b.md +103 -0
  529. package/docs/api/crypto/wasm/chacha20poly1305.md +120 -0
  530. package/docs/api/crypto/wasm/cmac.md +119 -0
  531. package/docs/api/crypto/wasm/ecc.md +114 -0
  532. package/docs/api/crypto/wasm/ed25519.md +117 -0
  533. package/docs/api/crypto/wasm/hkdf.md +163 -0
  534. package/docs/api/crypto/wasm/hmac.md +129 -0
  535. package/docs/api/crypto/wasm/ml_dsa.md +99 -0
  536. package/docs/api/crypto/wasm/ml_kem.md +91 -0
  537. package/docs/api/crypto/wasm/pbkdf2.md +111 -0
  538. package/docs/api/crypto/wasm/rsa.md +113 -0
  539. package/docs/api/crypto/wasm/runtime.md +172 -0
  540. package/docs/api/crypto/wasm/sha2.md +95 -0
  541. package/docs/api/crypto/wasm/sha3.md +127 -0
  542. package/docs/api/crypto/wasm/slh_dsa.md +89 -0
  543. package/docs/api/crypto/wasm/x25519.md +116 -0
  544. package/docs/api/crypto/webcrypto/README.md +56 -0
  545. package/docs/api/crypto/webcrypto/aes.md +140 -0
  546. package/docs/api/crypto/webcrypto/aeskw.md +120 -0
  547. package/docs/api/crypto/webcrypto/digest.md +103 -0
  548. package/docs/api/crypto/webcrypto/ecc.md +122 -0
  549. package/docs/api/crypto/webcrypto/ed25519.md +121 -0
  550. package/docs/api/crypto/webcrypto/hkdf.md +141 -0
  551. package/docs/api/crypto/webcrypto/hmac.md +112 -0
  552. package/docs/api/crypto/webcrypto/pbkdf2.md +140 -0
  553. package/docs/api/crypto/webcrypto/rsa.md +149 -0
  554. package/docs/api/crypto/webcrypto/x25519.md +96 -0
  555. package/docs/api/dom/README.md +117 -0
  556. package/docs/api/dom/display/README.md +27 -0
  557. package/docs/api/dom/display/animate.md +113 -0
  558. package/docs/api/dom/display/fullscreen.md +121 -0
  559. package/docs/api/dom/fs/README.md +36 -0
  560. package/docs/api/dom/fs/download.md +108 -0
  561. package/docs/api/dom/fs/fsAccess.md +200 -0
  562. package/docs/api/dom/fs/indexedDB.md +219 -0
  563. package/docs/api/dom/fs/remoteStore.md +158 -0
  564. package/docs/api/dom/fs/storage.md +197 -0
  565. package/docs/api/dom/lifecycle/README.md +11 -0
  566. package/docs/api/dom/lifecycle/idle.md +89 -0
  567. package/docs/api/dom/lifecycle/visibility.md +73 -0
  568. package/docs/api/dom/lifecycle/wakeLock.md +94 -0
  569. package/docs/api/dom/net/README.md +31 -0
  570. package/docs/api/dom/net/ajax.md +176 -0
  571. package/docs/api/dom/net/broadcastChannel.md +110 -0
  572. package/docs/api/dom/net/network.md +137 -0
  573. package/docs/api/dom/net/sse.md +141 -0
  574. package/docs/api/dom/net/webrtc.md +158 -0
  575. package/docs/api/dom/net/ws.md +168 -0
  576. package/docs/api/dom/query/README.md +30 -0
  577. package/docs/api/dom/query/dnd.md +137 -0
  578. package/docs/api/dom/query/dom.md +275 -0
  579. package/docs/api/dom/query/events.md +211 -0
  580. package/docs/api/dom/query/gesture.md +137 -0
  581. package/docs/api/dom/query/media.md +188 -0
  582. package/docs/api/dom/rendering/README.md +41 -0
  583. package/docs/api/dom/rendering/chart.md +149 -0
  584. package/docs/api/dom/rendering/component.md +287 -0
  585. package/docs/api/dom/rendering/devtools-ui.md +129 -0
  586. package/docs/api/dom/rendering/devtools.md +157 -0
  587. package/docs/api/dom/rendering/parser.md +200 -0
  588. package/docs/api/dom/rendering/reactiveBind.md +234 -0
  589. package/docs/api/dom/rendering/render.md +219 -0
  590. package/docs/api/dom/rendering/sanitize.md +97 -0
  591. package/docs/api/dom/rendering/secPolicy.md +155 -0
  592. package/docs/api/dom/rendering/template.md +301 -0
  593. package/docs/api/dom/rendering/themeTokens.md +175 -0
  594. package/docs/api/dom/rendering/uiSession.md +546 -0
  595. package/docs/api/dom/rendering/virtualScroll.md +126 -0
  596. package/docs/api/dom/sensors/README.md +12 -0
  597. package/docs/api/dom/sensors/battery.md +70 -0
  598. package/docs/api/dom/sensors/geolocation.md +115 -0
  599. package/docs/api/dom/sensors/networkInfo.md +73 -0
  600. package/docs/api/dom/sensors/sensors.md +123 -0
  601. package/docs/api/dom/sw/README.md +31 -0
  602. package/docs/api/dom/sw/backgroundSync.md +145 -0
  603. package/docs/api/dom/sw/cache.md +116 -0
  604. package/docs/api/dom/sw/push.md +114 -0
  605. package/docs/api/dom/sw/serviceWorker.md +90 -0
  606. package/docs/api/dom/sw/sharedWorker.md +131 -0
  607. package/docs/api/dom/utils/README.md +25 -0
  608. package/docs/api/dom/utils/a11y.md +143 -0
  609. package/docs/api/dom/utils/clipboard.md +146 -0
  610. package/docs/api/dom/utils/entropyCollector.md +175 -0
  611. package/docs/api/dom/utils/focus.md +140 -0
  612. package/docs/api/dom/utils/form.md +196 -0
  613. package/docs/api/dom/utils/formKit.md +181 -0
  614. package/docs/api/dom/utils/keybindings.md +138 -0
  615. package/docs/api/dom/utils/leaderElection.md +130 -0
  616. package/docs/api/dom/utils/notifications.md +106 -0
  617. package/docs/api/dom/utils/permissions.md +82 -0
  618. package/docs/api/dom/utils/route.md +112 -0
  619. package/docs/api/dom/utils/ua.md +119 -0
  620. package/docs/api/dom/utils/webauthn.md +190 -0
  621. package/docs/api/io/README.md +20 -0
  622. package/docs/api/io/binary/README.md +29 -0
  623. package/docs/api/io/binary/reader.md +126 -0
  624. package/docs/api/io/binary/writer.md +127 -0
  625. package/docs/api/io/calc/README.md +22 -0
  626. package/docs/api/io/calc/adler32.md +75 -0
  627. package/docs/api/io/calc/bigint.md +105 -0
  628. package/docs/api/io/calc/crc32.md +74 -0
  629. package/docs/api/io/calc/easing.md +118 -0
  630. package/docs/api/io/codec/README.md +35 -0
  631. package/docs/api/io/codec/b64.md +92 -0
  632. package/docs/api/io/codec/base32.md +98 -0
  633. package/docs/api/io/codec/base58.md +104 -0
  634. package/docs/api/io/codec/buffer.md +144 -0
  635. package/docs/api/io/codec/cbor.md +179 -0
  636. package/docs/api/io/codec/csv.md +178 -0
  637. package/docs/api/io/codec/hex.md +75 -0
  638. package/docs/api/io/codec/mime.md +156 -0
  639. package/docs/api/io/codec/msgpack.md +142 -0
  640. package/docs/api/io/codec/url.md +265 -0
  641. package/docs/api/io/codec/utf8.md +84 -0
  642. package/docs/api/io/codec/xml.md +87 -0
  643. package/docs/api/io/compress/README.md +62 -0
  644. package/docs/api/io/compress/bitstream.md +131 -0
  645. package/docs/api/io/compress/brotli.md +232 -0
  646. package/docs/api/io/compress/brotli_dict.md +119 -0
  647. package/docs/api/io/compress/brotli_dict_words.md +142 -0
  648. package/docs/api/io/compress/brotli_frame.md +214 -0
  649. package/docs/api/io/compress/brotli_shared.md +144 -0
  650. package/docs/api/io/compress/deflate.md +474 -0
  651. package/docs/api/io/compress/gzip.md +130 -0
  652. package/docs/api/io/compress/huffman.md +210 -0
  653. package/docs/api/io/compress/lz4.md +278 -0
  654. package/docs/api/io/compress/lz77.md +180 -0
  655. package/docs/api/io/compress/lzw.md +121 -0
  656. package/docs/api/io/compress/zip.md +209 -0
  657. package/docs/api/io/compress/zlib.md +125 -0
  658. package/docs/api/io/i18n/README.md +23 -0
  659. package/docs/api/io/i18n/i18n.md +128 -0
  660. package/docs/api/io/math/README.md +24 -0
  661. package/docs/api/io/math/fixed-point.md +115 -0
  662. package/docs/api/io/math/geom.md +144 -0
  663. package/docs/api/io/math/interp.md +115 -0
  664. package/docs/api/io/math/linalg.md +138 -0
  665. package/docs/api/io/math/stats.md +109 -0
  666. package/docs/api/io/structures/README.md +31 -0
  667. package/docs/api/io/structures/btree.md +155 -0
  668. package/docs/api/io/structures/heap.md +166 -0
  669. package/docs/api/io/structures/lruCache.md +156 -0
  670. package/docs/api/io/structures/ringBuffer.md +188 -0
  671. package/docs/api/io/structures/tree-walker.md +132 -0
  672. package/docs/api/io/structures/trie.md +138 -0
  673. package/docs/api/io/sync/README.md +29 -0
  674. package/docs/api/io/sync/abort.md +129 -0
  675. package/docs/api/io/sync/atomics.md +159 -0
  676. package/docs/api/io/sync/cancellable.md +176 -0
  677. package/docs/api/io/sync/channel.md +125 -0
  678. package/docs/api/io/sync/mutex.md +93 -0
  679. package/docs/api/io/sync/semaphore.md +106 -0
  680. package/docs/api/io/sync/tokenBucket.md +139 -0
  681. package/docs/api/io/text/README.md +23 -0
  682. package/docs/api/io/text/ansi.md +182 -0
  683. package/docs/api/io/text/html-entities.md +79 -0
  684. package/docs/api/io/text/semver.md +158 -0
  685. package/docs/api/io/text/str.md +129 -0
  686. package/docs/api/io/text/unicode.md +89 -0
  687. package/docs/api/io/time/README.md +22 -0
  688. package/docs/api/io/time/date.md +128 -0
  689. package/docs/api/io/timing/README.md +32 -0
  690. package/docs/api/io/timing/clock.md +102 -0
  691. package/docs/api/io/timing/rateLimit.md +137 -0
  692. package/docs/api/io/timing/scheduler.md +163 -0
  693. package/docs/api/io/utils/README.md +30 -0
  694. package/docs/api/io/utils/bitmap.md +96 -0
  695. package/docs/api/io/utils/errors.md +165 -0
  696. package/docs/api/io/utils/eventBus.md +162 -0
  697. package/docs/api/io/utils/queue.md +141 -0
  698. package/docs/api/io/utils/signal.md +388 -0
  699. package/docs/api/io/utils/ui8.md +111 -0
  700. package/docs/api/io/utils/valid.md +272 -0
  701. package/docs/api/process/README.md +18 -0
  702. package/docs/api/process/message.md +166 -0
  703. package/docs/api/process/rpc.md +161 -0
  704. package/docs/api/process/workerPool.md +130 -0
  705. package/docs/api/sanity/base.md +132 -0
  706. package/docs/api/sanity/community.md +96 -0
  707. package/docs/api/sanity/lockdown.md +128 -0
  708. package/docs/api/typed.md +85 -0
  709. package/docs/dev/README.md +25 -0
  710. package/docs/dev/provenance.md +80 -0
  711. package/docs/dev/publishing.md +31 -0
  712. package/docs/dev/runtime.md +64 -0
  713. package/docs/dev/testing.md +61 -0
  714. package/docs/dev/types.md +35 -0
  715. package/docs/evidence/pqc-hybrid-evidence.md +438 -0
  716. package/docs/guide/README.md +38 -0
  717. package/docs/guide/_QUICK_REF.md +341 -0
  718. package/docs/guide/by-use-case.md +160 -0
  719. package/docs/guide/doc-format.md +306 -0
  720. package/docs/guide/gesture-dnd-side-channel.md +119 -0
  721. package/docs/guide/getting-started.md +134 -0
  722. package/docs/guide/hmr.md +187 -0
  723. package/docs/guide/integration-bundlers.md +193 -0
  724. package/docs/guide/integrations-hmr.md +103 -0
  725. package/docs/guide/module-creation-workflow.md +342 -0
  726. package/docs/guide/module-pattern.md +244 -0
  727. package/docs/guide/rendering-pipeline.md +422 -0
  728. package/docs/guide/security.md +346 -0
  729. package/docs/guide/test-format.md +190 -0
  730. package/docs/guide/tutorial-todo.md +298 -0
  731. package/docs/guide/typescript.md +215 -0
  732. package/docs/guide/worker-confinement.md +301 -0
  733. package/docs/guide/workers.md +168 -0
  734. package/docs/notes/lz77-deflate-factorization.md +96 -0
  735. package/docs/notes/worker-confinement-spike.md +302 -0
  736. package/docs/tools/README.md +56 -0
  737. package/docs/tools/aot.md +108 -0
  738. package/docs/tools/audit.md +61 -0
  739. package/docs/tools/bundler.md +215 -0
  740. package/docs/tools/codegen.md +64 -0
  741. package/docs/tools/jsx.md +236 -0
  742. package/docs/tools/precompilation.md +88 -0
  743. package/docs/tools/standalone.md +107 -0
  744. package/fw.config.json +129 -0
  745. package/integrations/README.md +52 -0
  746. package/integrations/_shared/catalog.generated.json +207 -0
  747. package/integrations/_shared/config-resolve.js +201 -0
  748. package/integrations/_shared/core.js +362 -0
  749. package/integrations/astro/README.md +96 -0
  750. package/integrations/astro/index.d.ts +42 -0
  751. package/integrations/astro/index.js +94 -0
  752. package/integrations/bun/README.md +62 -0
  753. package/integrations/bun/index.d.ts +30 -0
  754. package/integrations/bun/index.js +134 -0
  755. package/integrations/deno/README.md +55 -0
  756. package/integrations/deno/deno.json +10 -0
  757. package/integrations/esbuild/README.md +75 -0
  758. package/integrations/esbuild/backend.js +147 -0
  759. package/integrations/esbuild/index.d.ts +32 -0
  760. package/integrations/esbuild/index.js +147 -0
  761. package/integrations/eslint/README.md +27 -0
  762. package/integrations/eslint/no-factory-capture.js +99 -0
  763. package/integrations/jest/README.md +45 -0
  764. package/integrations/jest/bun-test-shim.js +43 -0
  765. package/integrations/nestjs/README.md +68 -0
  766. package/integrations/nestjs/index.d.ts +38 -0
  767. package/integrations/nestjs/index.js +99 -0
  768. package/integrations/nextjs/README.md +149 -0
  769. package/integrations/nextjs/index.d.ts +30 -0
  770. package/integrations/nextjs/index.js +98 -0
  771. package/integrations/nodejs/README.md +46 -0
  772. package/integrations/nodejs/package.node.example.json +31 -0
  773. package/integrations/rollup/README.md +65 -0
  774. package/integrations/rollup/backend.js +132 -0
  775. package/integrations/rollup/index.d.ts +32 -0
  776. package/integrations/rollup/index.js +84 -0
  777. package/integrations/turbopack/README.md +56 -0
  778. package/integrations/turbopack/index.d.ts +47 -0
  779. package/integrations/turbopack/index.js +164 -0
  780. package/integrations/typedoc/README.md +57 -0
  781. package/integrations/typedoc/categorize.js +121 -0
  782. package/integrations/typedoc/tsconfig.typedoc.json +14 -0
  783. package/integrations/typedoc/typedoc.json +19 -0
  784. package/integrations/vite/README.md +115 -0
  785. package/integrations/vite/index.d.ts +29 -0
  786. package/integrations/vite/index.js +182 -0
  787. package/integrations/vite/package.json +8 -0
  788. package/integrations/vite/vite-env.d.ts +36 -0
  789. package/integrations/vitest/README.md +77 -0
  790. package/integrations/vitest/bun-test-shim.js +92 -0
  791. package/integrations/vitest/vitest.config.js +41 -0
  792. package/integrations/webpack/README.md +53 -0
  793. package/integrations/webpack/index.d.ts +29 -0
  794. package/integrations/webpack/index.js +182 -0
  795. package/package.json +303 -0
  796. package/src/core/logger.js +373 -0
  797. package/src/core/modules.js +289 -0
  798. package/src/core/readyState.js +119 -0
  799. package/src/core/runtime.js +929 -0
  800. package/src/core/worker-helper.js +261 -0
  801. package/src/crypto/NIST_CONFORMANCE.md +249 -0
  802. package/src/crypto/cipher/aes.acvp.md +74 -0
  803. package/src/crypto/cipher/aes.js +512 -0
  804. package/src/crypto/cipher/chacha20.acvp.md +117 -0
  805. package/src/crypto/cipher/chacha20.js +147 -0
  806. package/src/crypto/hash/adf.acvp.md +144 -0
  807. package/src/crypto/hash/adf.js +127 -0
  808. package/src/crypto/hash/argon2.acvp.md +144 -0
  809. package/src/crypto/hash/argon2.js +517 -0
  810. package/src/crypto/hash/blake2b.acvp.md +122 -0
  811. package/src/crypto/hash/blake2b.js +367 -0
  812. package/src/crypto/hash/hkdf.acvp.md +128 -0
  813. package/src/crypto/hash/hkdf.js +145 -0
  814. package/src/crypto/hash/hmac.acvp.md +110 -0
  815. package/src/crypto/hash/hmac.js +177 -0
  816. package/src/crypto/hash/pbkdf2.acvp.md +122 -0
  817. package/src/crypto/hash/pbkdf2.js +120 -0
  818. package/src/crypto/hash/poly1305.acvp.md +111 -0
  819. package/src/crypto/hash/poly1305.js +126 -0
  820. package/src/crypto/hash/sha224.acvp.md +81 -0
  821. package/src/crypto/hash/sha224.js +60 -0
  822. package/src/crypto/hash/sha256.acvp.md +75 -0
  823. package/src/crypto/hash/sha256.js +217 -0
  824. package/src/crypto/hash/sha3.acvp.md +133 -0
  825. package/src/crypto/hash/sha3.js +391 -0
  826. package/src/crypto/hash/sha384.acvp.md +82 -0
  827. package/src/crypto/hash/sha384.js +61 -0
  828. package/src/crypto/hash/sha512.acvp.md +84 -0
  829. package/src/crypto/hash/sha512.js +314 -0
  830. package/src/crypto/hash/sha512_224.acvp.md +90 -0
  831. package/src/crypto/hash/sha512_224.js +66 -0
  832. package/src/crypto/hash/sha512_256.acvp.md +96 -0
  833. package/src/crypto/hash/sha512_256.js +75 -0
  834. package/src/crypto/mode/cbc.acvp.md +105 -0
  835. package/src/crypto/mode/cbc.js +136 -0
  836. package/src/crypto/mode/chacha20poly1305.acvp.md +116 -0
  837. package/src/crypto/mode/chacha20poly1305.js +190 -0
  838. package/src/crypto/mode/cmac.acvp.md +106 -0
  839. package/src/crypto/mode/cmac.js +172 -0
  840. package/src/crypto/mode/ctr.acvp.md +110 -0
  841. package/src/crypto/mode/ctr.js +174 -0
  842. package/src/crypto/mode/gcm.acvp.md +129 -0
  843. package/src/crypto/mode/gcm.js +333 -0
  844. package/src/crypto/mode/kw.acvp.md +145 -0
  845. package/src/crypto/mode/kw.js +323 -0
  846. package/src/crypto/pkc/ecc.acvp.md +181 -0
  847. package/src/crypto/pkc/ecc.js +941 -0
  848. package/src/crypto/pkc/ed25519.acvp.md +172 -0
  849. package/src/crypto/pkc/ed25519.js +582 -0
  850. package/src/crypto/pkc/hybrid-kat.provenance.md +89 -0
  851. package/src/crypto/pkc/hybridKem.js +255 -0
  852. package/src/crypto/pkc/hybridSign.js +437 -0
  853. package/src/crypto/pkc/ml_dsa.acvp.md +146 -0
  854. package/src/crypto/pkc/ml_dsa.js +984 -0
  855. package/src/crypto/pkc/ml_kem.acvp.md +117 -0
  856. package/src/crypto/pkc/ml_kem.js +596 -0
  857. package/src/crypto/pkc/rsa.acvp.md +187 -0
  858. package/src/crypto/pkc/rsa.js +470 -0
  859. package/src/crypto/pkc/slh_dsa.acvp.md +155 -0
  860. package/src/crypto/pkc/slh_dsa.js +820 -0
  861. package/src/crypto/pkc/x25519.acvp.md +113 -0
  862. package/src/crypto/pkc/x25519.js +290 -0
  863. package/src/crypto/utils/aes_ctr.acvp.md +67 -0
  864. package/src/crypto/utils/aes_ctr.js +134 -0
  865. package/src/crypto/utils/aes_modes.acvp.md +66 -0
  866. package/src/crypto/utils/aes_modes.js +241 -0
  867. package/src/crypto/utils/asn1-oid.js +369 -0
  868. package/src/crypto/utils/asn1.js +343 -0
  869. package/src/crypto/utils/bitArray.js +312 -0
  870. package/src/crypto/utils/bn.js +825 -0
  871. package/src/crypto/utils/jws.js +222 -0
  872. package/src/crypto/utils/keyformat.js +303 -0
  873. package/src/crypto/utils/pad.js +198 -0
  874. package/src/crypto/utils/pem.js +90 -0
  875. package/src/crypto/utils/random.acvp.md +167 -0
  876. package/src/crypto/utils/random.js +846 -0
  877. package/src/crypto/utils/rsaKeygen.acvp.md +158 -0
  878. package/src/crypto/utils/rsaKeygen.js +448 -0
  879. package/src/crypto/utils/totp.js +409 -0
  880. package/src/crypto/utils/uuid.acvp.md +137 -0
  881. package/src/crypto/utils/uuid.js +176 -0
  882. package/src/crypto/wasm/aes.js +494 -0
  883. package/src/crypto/wasm/argon2.js +236 -0
  884. package/src/crypto/wasm/blake2b.js +213 -0
  885. package/src/crypto/wasm/chacha20poly1305.js +238 -0
  886. package/src/crypto/wasm/cmac.js +207 -0
  887. package/src/crypto/wasm/ecc.js +437 -0
  888. package/src/crypto/wasm/ed25519.js +307 -0
  889. package/src/crypto/wasm/hkdf.js +183 -0
  890. package/src/crypto/wasm/hmac.js +215 -0
  891. package/src/crypto/wasm/ml_dsa.js +375 -0
  892. package/src/crypto/wasm/ml_kem.js +313 -0
  893. package/src/crypto/wasm/pbkdf2.js +205 -0
  894. package/src/crypto/wasm/rsa.js +674 -0
  895. package/src/crypto/wasm/runtime.js +400 -0
  896. package/src/crypto/wasm/sha2.js +183 -0
  897. package/src/crypto/wasm/sha3.js +221 -0
  898. package/src/crypto/wasm/slh_dsa.js +397 -0
  899. package/src/crypto/wasm/x25519.js +241 -0
  900. package/src/crypto/webcrypto/aes.js +370 -0
  901. package/src/crypto/webcrypto/aeskw.js +185 -0
  902. package/src/crypto/webcrypto/digest.js +136 -0
  903. package/src/crypto/webcrypto/ecc.js +371 -0
  904. package/src/crypto/webcrypto/ed25519.js +248 -0
  905. package/src/crypto/webcrypto/hkdf.js +132 -0
  906. package/src/crypto/webcrypto/hmac.js +213 -0
  907. package/src/crypto/webcrypto/pbkdf2.js +146 -0
  908. package/src/crypto/webcrypto/rsa.js +415 -0
  909. package/src/crypto/webcrypto/x25519.js +250 -0
  910. package/src/dom/display/animate.js +154 -0
  911. package/src/dom/display/fullscreen.js +305 -0
  912. package/src/dom/fs/download.js +118 -0
  913. package/src/dom/fs/fsAccess.js +307 -0
  914. package/src/dom/fs/indexedDB.js +465 -0
  915. package/src/dom/fs/remoteStore.js +484 -0
  916. package/src/dom/fs/storage.js +440 -0
  917. package/src/dom/lifecycle/idle.js +133 -0
  918. package/src/dom/lifecycle/visibility.js +140 -0
  919. package/src/dom/lifecycle/wakeLock.js +187 -0
  920. package/src/dom/net/ajax.js +303 -0
  921. package/src/dom/net/broadcastChannel.js +89 -0
  922. package/src/dom/net/network.js +260 -0
  923. package/src/dom/net/sse.js +295 -0
  924. package/src/dom/net/webrtc.js +381 -0
  925. package/src/dom/net/ws.js +290 -0
  926. package/src/dom/query/dnd.js +409 -0
  927. package/src/dom/query/dom.js +831 -0
  928. package/src/dom/query/events.js +425 -0
  929. package/src/dom/query/gesture.js +396 -0
  930. package/src/dom/query/media.js +616 -0
  931. package/src/dom/rendering/chart.js +663 -0
  932. package/src/dom/rendering/component.js +469 -0
  933. package/src/dom/rendering/devtools-ui.js +399 -0
  934. package/src/dom/rendering/devtools.js +352 -0
  935. package/src/dom/rendering/parser.js +1055 -0
  936. package/src/dom/rendering/reactiveBind.js +341 -0
  937. package/src/dom/rendering/render.js +601 -0
  938. package/src/dom/rendering/sanitize.js +364 -0
  939. package/src/dom/rendering/secPolicy.js +281 -0
  940. package/src/dom/rendering/template.js +1031 -0
  941. package/src/dom/rendering/themeTokens.js +522 -0
  942. package/src/dom/rendering/uiSession-core.js +597 -0
  943. package/src/dom/rendering/uiSession-direct.js +251 -0
  944. package/src/dom/rendering/uiSession-list.js +751 -0
  945. package/src/dom/rendering/uiSession.js +145 -0
  946. package/src/dom/rendering/virtualScroll.js +341 -0
  947. package/src/dom/sensors/battery.js +153 -0
  948. package/src/dom/sensors/geolocation.js +156 -0
  949. package/src/dom/sensors/networkInfo.js +136 -0
  950. package/src/dom/sensors/sensors.js +340 -0
  951. package/src/dom/sw/backgroundSync.js +113 -0
  952. package/src/dom/sw/cache.js +139 -0
  953. package/src/dom/sw/push.js +181 -0
  954. package/src/dom/sw/serviceWorker.js +193 -0
  955. package/src/dom/sw/sharedWorker.js +192 -0
  956. package/src/dom/utils/a11y.js +244 -0
  957. package/src/dom/utils/clipboard.js +113 -0
  958. package/src/dom/utils/entropyCollector.js +344 -0
  959. package/src/dom/utils/focus.js +421 -0
  960. package/src/dom/utils/form.js +535 -0
  961. package/src/dom/utils/formKit.js +427 -0
  962. package/src/dom/utils/keybindings.js +574 -0
  963. package/src/dom/utils/leaderElection.js +280 -0
  964. package/src/dom/utils/notifications.js +218 -0
  965. package/src/dom/utils/permissions.js +107 -0
  966. package/src/dom/utils/route.js +482 -0
  967. package/src/dom/utils/ua.js +109 -0
  968. package/src/dom/utils/webauthn.js +369 -0
  969. package/src/external/README.md +15 -0
  970. package/src/io/binary/reader.js +374 -0
  971. package/src/io/binary/writer.js +351 -0
  972. package/src/io/calc/adler32.js +94 -0
  973. package/src/io/calc/bigint.js +276 -0
  974. package/src/io/calc/crc32.js +111 -0
  975. package/src/io/calc/easing.js +514 -0
  976. package/src/io/codec/b64.js +235 -0
  977. package/src/io/codec/base32.js +147 -0
  978. package/src/io/codec/base58.js +167 -0
  979. package/src/io/codec/buffer.js +630 -0
  980. package/src/io/codec/cbor.js +550 -0
  981. package/src/io/codec/csv.js +299 -0
  982. package/src/io/codec/hex.js +129 -0
  983. package/src/io/codec/mime.js +398 -0
  984. package/src/io/codec/msgpack.js +491 -0
  985. package/src/io/codec/url.js +530 -0
  986. package/src/io/codec/utf8.js +181 -0
  987. package/src/io/codec/xml.js +428 -0
  988. package/src/io/compress/bitstream.js +199 -0
  989. package/src/io/compress/brotli.js +3073 -0
  990. package/src/io/compress/brotli_dict.bin +432 -0
  991. package/src/io/compress/brotli_dict.js +356 -0
  992. package/src/io/compress/brotli_dict_words.js +157 -0
  993. package/src/io/compress/brotli_frame.js +420 -0
  994. package/src/io/compress/brotli_shared.js +715 -0
  995. package/src/io/compress/deflate.js +1432 -0
  996. package/src/io/compress/gzip.js +406 -0
  997. package/src/io/compress/huffman.js +322 -0
  998. package/src/io/compress/lz4.js +451 -0
  999. package/src/io/compress/lz77.js +408 -0
  1000. package/src/io/compress/lzw.js +332 -0
  1001. package/src/io/compress/zip.js +815 -0
  1002. package/src/io/compress/zlib.js +340 -0
  1003. package/src/io/i18n/i18n.js +236 -0
  1004. package/src/io/math/fixed-point.js +269 -0
  1005. package/src/io/math/geom.js +350 -0
  1006. package/src/io/math/interp.js +263 -0
  1007. package/src/io/math/linalg.js +472 -0
  1008. package/src/io/math/stats.js +339 -0
  1009. package/src/io/structures/btree.js +357 -0
  1010. package/src/io/structures/heap.js +249 -0
  1011. package/src/io/structures/lruCache.js +219 -0
  1012. package/src/io/structures/ringBuffer.js +208 -0
  1013. package/src/io/structures/tree-walker.js +413 -0
  1014. package/src/io/structures/trie.js +219 -0
  1015. package/src/io/sync/abort.js +196 -0
  1016. package/src/io/sync/atomics.js +342 -0
  1017. package/src/io/sync/cancellable.js +279 -0
  1018. package/src/io/sync/channel.js +301 -0
  1019. package/src/io/sync/mutex.js +148 -0
  1020. package/src/io/sync/semaphore.js +156 -0
  1021. package/src/io/sync/tokenBucket.js +208 -0
  1022. package/src/io/text/ansi.js +536 -0
  1023. package/src/io/text/html-entities.js +143 -0
  1024. package/src/io/text/semver.js +375 -0
  1025. package/src/io/text/str.js +243 -0
  1026. package/src/io/text/unicode.js +188 -0
  1027. package/src/io/time/date.js +355 -0
  1028. package/src/io/timing/clock.js +79 -0
  1029. package/src/io/timing/rateLimit.js +264 -0
  1030. package/src/io/timing/scheduler.js +351 -0
  1031. package/src/io/utils/bitmap.js +94 -0
  1032. package/src/io/utils/errors.js +269 -0
  1033. package/src/io/utils/eventBus.js +315 -0
  1034. package/src/io/utils/queue.js +223 -0
  1035. package/src/io/utils/signal.js +858 -0
  1036. package/src/io/utils/ui8.js +99 -0
  1037. package/src/io/utils/valid.js +556 -0
  1038. package/src/main.js +41 -0
  1039. package/src/polyfill/README.md +9 -0
  1040. package/src/process/message.js +257 -0
  1041. package/src/process/rpc.js +286 -0
  1042. package/src/process/workerPool.js +392 -0
  1043. package/src/sanity/base.js +374 -0
  1044. package/src/sanity/community.js +254 -0
  1045. package/src/sanity/lockdown-apply.js +58 -0
  1046. package/src/sanity/lockdown.js +408 -0
  1047. package/src/sanity/wasm-gate.js +316 -0
  1048. package/src/typed.js +53 -0
  1049. package/third-party/NOTICE-penner-easing +88 -0
  1050. package/third-party/NOTICE-sjcl +50 -0
  1051. package/tools/_lib/cli-help.js +55 -0
  1052. package/tools/rendering/aot/index.js +148 -0
  1053. package/tools/rendering/aot/lib/dom-codegen.js +295 -0
  1054. package/tools/rendering/jsx/index.js +654 -0
  1055. package/tools/rendering/precompilation/index.js +368 -0
  1056. package/types/registry.generated.d.ts +217 -0
  1057. package/types/typed.d.ts +106 -0
@@ -0,0 +1,929 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ // packages/front/fw/src/core/runtime.js
6
+ /**
7
+ * @fileoverview Minimal dependency-injection runtime for the framework's module
8
+ * system, with native multi-version support.
9
+ *
10
+ * A **module** is a plain object with these fields:
11
+ * ```js
12
+ * {
13
+ * name : string, // unique identifier
14
+ * version? : string, // semver - defaults to '0.0.0' when absent
15
+ * type? : string, // taxonomy - must match /^(fw|sde|lib)\.[a-z][\w.]*$/ when present
16
+ * dependencies : string[], // names (or 'name@version' specs) of required modules
17
+ * factory : function, // called with resolved dependency instances as args
18
+ * }
19
+ * ```
20
+ *
21
+ * Multiple versions of the same module name can coexist. `resolve('foo')` returns
22
+ * the highest semver version registered ; `resolve('foo', { version: '1.2.3' })`
23
+ * or the canonical spec `resolve('foo@1.2.3')` returns an exact version.
24
+ *
25
+ * The "highest version" pointer is precomputed at register time, so version-less
26
+ * resolves remain O(1).
27
+ *
28
+ */
29
+
30
+ /**
31
+ * Strict semver core regex (major.minor.patch with optional pre-release/build).
32
+ * @private
33
+ */
34
+ const SEMVER_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[\w.-]+)?(?:\+[\w.-]+)?$/;
35
+
36
+ /**
37
+ * Type taxonomy regex : `fw.<sub>`, `sd.<sub>`, `sde.<sub>`, `sdc.<sub>`, `lib.<sub>`.
38
+ *
39
+ * - `fw.*` : framework modules (`@awacloud/fw`).
40
+ * - `sd.*` : shared SDE/SDC modules (`@awacloud/sd-common`).
41
+ * - `sde.*` : multi-app desktop specifics (`@awacloud/sde-core`).
42
+ * - `sdc.*` : mono-app container specifics (`@awacloud/sdc-core`).
43
+ * - `lib.*` : standalone libraries (e.g. `lib.video_codec`).
44
+ *
45
+ * @private
46
+ */
47
+ const TYPE_RE = /^(fw|sd|sde|sdc|lib)\.[a-z][\w.]*$/;
48
+
49
+ /**
50
+ * Default version when a module descriptor omits `version`.
51
+ * @private
52
+ */
53
+ const DEFAULT_VERSION = '0.0.0';
54
+
55
+ /**
56
+ * Compare two semver strings.
57
+ *
58
+ * Implements the ordering :
59
+ * - numeric major.minor.patch
60
+ * - any pre-release < no pre-release (1.0.0-beta < 1.0.0)
61
+ * - pre-release sorted lexicographically (1.0.0-alpha < 1.0.0-beta)
62
+ *
63
+ * Sufficient for picking the highest version at register time. For range
64
+ * matching (`^`, `~`, `>=`), use the standalone `semver` module.
65
+ *
66
+ * @param {string} a Semver string.
67
+ * @param {string} b Semver string.
68
+ * @returns {number} -1 if a < b, 0 if equal, 1 if a > b.
69
+ * @private
70
+ */
71
+ function semverCompare(a, b) {
72
+ const [coreA, preA = ''] = a.split('-', 2);
73
+ const [coreB, preB = ''] = b.split('-', 2);
74
+ const partsA = coreA.split('.');
75
+ const partsB = coreB.split('.');
76
+ for (let i = 0; i < 3; i++) {
77
+ const na = +partsA[i] || 0;
78
+ const nb = +partsB[i] || 0;
79
+ if (na !== nb) return na < nb ? -1 : 1;
80
+ }
81
+ // pre-release < release
82
+ if (preA && !preB) return -1;
83
+ if (!preA && preB) return 1;
84
+ if (preA === preB) return 0;
85
+ return preA < preB ? -1 : 1;
86
+ }
87
+
88
+ /**
89
+ * Parse a module spec string : `'name'` or `'name@version'`.
90
+ *
91
+ * Splits on the **last** `@` so module names containing `@` (rare) are handled
92
+ * correctly when the version is appended.
93
+ *
94
+ * @param {string} spec Module spec.
95
+ * @returns {{name: string, version: string|undefined}}
96
+ * @private
97
+ */
98
+ function parseSpec(spec) {
99
+ const at = spec.lastIndexOf('@');
100
+ if (at <= 0) return { name: spec, version: undefined };
101
+ return { name: spec.slice(0, at), version: spec.slice(at + 1) };
102
+ }
103
+
104
+ /**
105
+ * Build the canonical key `name@version`.
106
+ *
107
+ * @param {string} name
108
+ * @param {string} version
109
+ * @returns {string}
110
+ * @private
111
+ */
112
+ function canonical(name, version) {
113
+ return name + '@' + version;
114
+ }
115
+
116
+ /**
117
+ * A module definition object.
118
+ *
119
+ * @typedef {Object} ModuleDefinition
120
+ * @property {string} name - Unique module identifier.
121
+ * @property {string} [version] - Semver string. Defaults to '0.0.0'.
122
+ * @property {string} [type] - Hierarchical type (e.g. 'fw.io.codec').
123
+ * @property {string[]} dependencies - Ordered list of dependency specs
124
+ * ('name' or 'name@version').
125
+ * @property {ModuleDefinition[]} [deps] - Optional direct JS references to the
126
+ * dependency modules, in the same order
127
+ * as `dependencies`. Bundler-facing only :
128
+ * lets tree-shaking tools trace the graph
129
+ * through static imports. Walked by
130
+ * `registerDeep` / `registerAllDeep`.
131
+ * @property {Function} factory - Factory function invoked with resolved
132
+ * dependency instances as arguments.
133
+ */
134
+
135
+ /**
136
+ * Public instance type produced by a module's `factory` — i.e. what
137
+ * `runtime.resolve('<name>')` returns for that module. Given a module value
138
+ * `M`, `InstanceOf<typeof M>` is `ReturnType<M['factory']>`. See the typed
139
+ * runtime facade (`@awacloud/fw/typed`) and `docs/guide/typescript.md` for usage.
140
+ *
141
+ * @template {{ factory: (...args: any[]) => any }} M
142
+ * @typedef {ReturnType<M['factory']>} InstanceOf
143
+ */
144
+
145
+ /**
146
+ * Per-name registry entry holding all known versions of a module.
147
+ *
148
+ * @typedef {Object} ModuleEntry
149
+ * @property {Map<string, ModuleDefinition>} versions - Map of version → definition.
150
+ * @property {string} latest - Highest semver version present.
151
+ * @property {ModuleDefinition} latestDef - Cached pointer to the latest def.
152
+ */
153
+
154
+ /**
155
+ * Options accepted by {@link ModuleRuntime#resolve} and
156
+ * {@link ModuleRuntime#resolveAll}.
157
+ *
158
+ * @typedef {Object} ResolveOptions
159
+ * @property {boolean} [isolation] - When truthy the instance is **not** cached.
160
+ * @property {string} [version] - Explicit version. Ignored if `spec` already
161
+ * contains `@version`.
162
+ * @property {Map} [instances] - Custom instance map (flat, keyed by canonical
163
+ * `name@version`).
164
+ */
165
+
166
+ /**
167
+ * Filter passed to {@link ModuleRuntime#list}.
168
+ *
169
+ * @typedef {Object} ListFilter
170
+ * @property {string} [name] - Exact module name.
171
+ * @property {string} [version] - Exact version.
172
+ * @property {string} [type] - Exact type, or prefix when ending with `.`
173
+ * (e.g. `'fw.io.'` matches `'fw.io.codec'`).
174
+ */
175
+
176
+ /**
177
+ * One frozen registry row returned by {@link ModuleRuntime#snapshot}.
178
+ *
179
+ * Pure **metadata** — it carries no `factory`, no `deps` reference and no
180
+ * instance. Every field is a primitive or a frozen copy, so the row is inert:
181
+ * holding it grants no way to write back into the registry.
182
+ *
183
+ * @typedef {Object} RegistrySnapshotEntry
184
+ * @property {string} name - Registered module name.
185
+ * @property {string} version - Resolved version ('0.0.0' when the
186
+ * descriptor omitted `version`).
187
+ * @property {string|null} type - Declared taxonomy type, or `null`.
188
+ * @property {ReadonlyArray<string>} dependencies - Frozen copy of the declared
189
+ * dependency specs (never the live array).
190
+ * @property {boolean} latest - `true` when this version is the one a
191
+ * version-less `resolve(name)` would pick.
192
+ * @property {boolean} instantiated - `true` when an instance for this
193
+ * `(name, version)` is already in the
194
+ * default cache. Read-only observation —
195
+ * reading it never instantiates anything.
196
+ */
197
+
198
+ /**
199
+ * Options accepted by {@link ModuleRuntime#invalidate}.
200
+ *
201
+ * @typedef {Object} InvalidateOptions
202
+ * @property {boolean} [cascade] - When truthy, also invalidate every module
203
+ * that declares the target among its
204
+ * `dependencies`, transitively. Dependents,
205
+ * not dependencies: what a swapped module
206
+ * breaks is the things built on top of it.
207
+ */
208
+
209
+ /**
210
+ * Result returned by {@link ModuleRuntime#invalidate}.
211
+ *
212
+ * @typedef {Object} InvalidateResult
213
+ * @property {ReadonlyArray<string>} invalidated - Canonical `name@version` keys
214
+ * whose cached instance was actually dropped. A target that was never
215
+ * instantiated contributes nothing, so an empty array means "nothing was
216
+ * cached", never "nothing matched" — an unknown module throws instead.
217
+ * @property {Object<string, *>} state - Frozen map of canonical key → the value
218
+ * returned by the outgoing instance's `dehydrate()`, for the targets that
219
+ * opted into the convention. Keys absent from it did not implement
220
+ * `dehydrate`. The values themselves are whatever the module returned and
221
+ * are **not** deep-frozen.
222
+ */
223
+
224
+ /**
225
+ * Result returned by {@link ModuleRuntime#serialize}.
226
+ *
227
+ * @typedef {Object} SerializedGraph
228
+ * @property {string} list - JS array literal of canonical names :
229
+ * `"['hex@1.0.0','uuid@2.0.0']"`.
230
+ * @property {string} content - JS array literal of fully serialised module objects,
231
+ * ready to be evaluated and registered inside a Worker.
232
+ */
233
+
234
+ /**
235
+ * Lightweight dependency-injection runtime with native multi-version support.
236
+ *
237
+ * Modules are registered once and resolved lazily. `resolve('name')` returns the
238
+ * highest-semver version ; `resolve('name@1.2.3')` or `resolve('name', {version})`
239
+ * returns an exact one. Instances are cached by `(name, version)`.
240
+ *
241
+ * The `context` property is reserved for the Worker bootstrap : `worker-helper.js`
242
+ * assigns the worker framework's public API to it after the worker starts.
243
+ */
244
+ export class ModuleRuntime {
245
+
246
+ /**
247
+ * Pinned "never swap" set — module names {@link ModuleRuntime#invalidate}
248
+ * refuses to touch, directly or through a cascade.
249
+ *
250
+ * `signal` is on it because its effect tracking is **per-factory-instance**:
251
+ * dropping its cached instance would leave every already-created signal,
252
+ * derived and effect bound to the previous factory instance while new reads
253
+ * register against the new one, so effects silently stop firing. That is a
254
+ * whole-application breakage with no error to point at, which is exactly the
255
+ * class of failure a hot-reload seam must not be able to cause.
256
+ *
257
+ * The set is **pinned**, not configurable: a per-runtime opt-out would make
258
+ * the guarantee negotiable at the call site, which is where the mistake
259
+ * happens. Widening it is a source change, reviewed like any other.
260
+ *
261
+ * @type {ReadonlyArray<string>}
262
+ */
263
+ static NEVER_SWAP = Object.freeze(['signal']);
264
+
265
+ constructor() {
266
+ /** @type {Map<string, ModuleEntry>} Registered module entries (one per name). */
267
+ this.modules = new Map();
268
+
269
+ /** @type {Map<string, Map<string, *>>} Instance cache : name → version → instance. */
270
+ this.instances = new Map();
271
+
272
+ /**
273
+ * Reserved for the Worker bootstrap - populated by `worker-helper.js`.
274
+ * @type {Object}
275
+ */
276
+ this.context = {}; // reserved for worker
277
+ }
278
+
279
+ /**
280
+ * Register a module definition.
281
+ *
282
+ * Validates `name`, `factory`, `version` (semver, defaults to '0.0.0') and
283
+ * `type` (taxonomy regex, optional). Registering the same `(name, version)`
284
+ * pair overwrites the previous definition. Multiple versions of the same
285
+ * `name` coexist.
286
+ *
287
+ * @param {ModuleDefinition} module
288
+ * @throws {Error} On invalid name, factory, version or type.
289
+ * @returns {this} Chainable.
290
+ */
291
+ register(module) {
292
+ if (!module || !module.name || !module.factory) {
293
+ throw new Error('Invalid module definition');
294
+ }
295
+ const version = (module.version != null) ? module.version : DEFAULT_VERSION;
296
+ if (!SEMVER_RE.test(version)) {
297
+ throw new Error(`Invalid version "${version}" for module "${module.name}"`);
298
+ }
299
+ if (module.type != null && !TYPE_RE.test(module.type)) {
300
+ throw new Error(`Invalid type "${module.type}" for module "${module.name}"`);
301
+ }
302
+
303
+ let entry = this.modules.get(module.name);
304
+ if (!entry) {
305
+ entry = { versions: new Map(), latest: version, latestDef: module };
306
+ this.modules.set(module.name, entry);
307
+ }
308
+ entry.versions.set(version, module);
309
+ // Recompute latest only when the new version sorts strictly higher.
310
+ if (semverCompare(version, entry.latest) >= 0) {
311
+ entry.latest = version;
312
+ entry.latestDef = module;
313
+ }
314
+ return this;
315
+ }
316
+
317
+ /**
318
+ * Register an array of module descriptors. Equivalent to calling
319
+ * `register()` for each entry; returns `this` for chaining.
320
+ * @param {ModuleDefinition[]} modules
321
+ * @returns {ModuleRuntime}
322
+ */
323
+ registerAll(modules) {
324
+ for (const m of modules) this.register(m);
325
+ return this;
326
+ }
327
+
328
+ /**
329
+ * Register a module along with all its transitive `deps` — the optional
330
+ * bundler-friendly companion of `dependencies`.
331
+ *
332
+ * A module may carry a `deps` array of **direct JS references** to its
333
+ * dependency modules (imported statically by the module's source file).
334
+ * `registerDeep` walks that graph depth-first and registers each missing
335
+ * module on the way back up, so dependencies are always registered
336
+ * before their dependents — the correct order for `resolve`.
337
+ *
338
+ * `deps` is purely a build-time / bundler concern : it lets tree-shaking
339
+ * bundlers (Vite / Rollup / Webpack / esbuild) trace the module graph
340
+ * from JS `import` statements while keeping `dependencies` (strings,
341
+ * possibly with `name@version` specs) as the runtime resolution
342
+ * contract. Workers receive only the canonical `dependencies` form via
343
+ * {@link ModuleRuntime#serialize}, so `deps` is not transferred — that
344
+ * is fine, the worker-side closure has already been computed.
345
+ *
346
+ * Idempotent : already-registered modules are skipped. Cycle-safe via
347
+ * a per-call visited set keyed on module name.
348
+ *
349
+ * **Invariant** (validated at build time) :
350
+ * `module.deps.map(d => d.name)` === `module.dependencies.map(s => s.split('@')[0])`
351
+ *
352
+ * @param {ModuleDefinition & {deps?: ModuleDefinition[]}} module
353
+ * @returns {this} Chainable.
354
+ */
355
+ registerDeep(module) {
356
+ const seen = new Set();
357
+ const visit = (m) => {
358
+ if (!m || typeof m !== 'object' || !m.name || !m.factory) return;
359
+ if (seen.has(m.name)) return;
360
+ seen.add(m.name);
361
+ if (Array.isArray(m.deps)) {
362
+ for (const d of m.deps) visit(d);
363
+ }
364
+ const version = (m.version != null) ? m.version : DEFAULT_VERSION;
365
+ if (!this.has(m.name, version)) this.register(m);
366
+ };
367
+ visit(module);
368
+ return this;
369
+ }
370
+
371
+ /**
372
+ * Equivalent to calling {@link ModuleRuntime#registerDeep} for each entry,
373
+ * sharing a single visited set across the batch so common transitive
374
+ * dependencies are walked only once.
375
+ *
376
+ * @param {Array<ModuleDefinition & {deps?: ModuleDefinition[]}>} modules
377
+ * @returns {this} Chainable.
378
+ */
379
+ registerAllDeep(modules) {
380
+ for (const m of modules) this.registerDeep(m);
381
+ return this;
382
+ }
383
+
384
+ /**
385
+ * Unregister a module definition. **Does not touch the instance cache** -
386
+ * already-resolved instances held by callers continue to function ; only
387
+ * subsequent `resolve` calls for the removed module(s) will throw.
388
+ *
389
+ * **Spec / version semantics (mirrors `has`) :**
390
+ * - `unregister('foo')` → remove **all** versions of `foo`
391
+ * - `unregister('foo', '1.0.0')` or `unregister('foo@1.0.0')` → remove only that version
392
+ *
393
+ * When the removed version is the current `latest`, the entry's `latest`
394
+ * pointer is recomputed from the remaining versions. When the last version
395
+ * of a name is removed, the entry itself is deleted.
396
+ *
397
+ * @param {string} spec Module name, or `'name@version'`.
398
+ * @param {string} [version] Explicit version (ignored if `spec` already contains `@`).
399
+ * @returns {boolean} `true` if at least one definition was removed.
400
+ */
401
+ unregister(spec, version) {
402
+ const parsed = parseSpec(spec);
403
+ const name = parsed.name;
404
+ const ver = parsed.version || version;
405
+
406
+ const entry = this.modules.get(name);
407
+ if (!entry) return false;
408
+
409
+ if (ver === undefined) {
410
+ // Remove all versions for this name.
411
+ this.modules.delete(name);
412
+ return true;
413
+ }
414
+
415
+ if (!entry.versions.has(ver)) return false;
416
+ entry.versions.delete(ver);
417
+
418
+ if (entry.versions.size === 0) {
419
+ this.modules.delete(name);
420
+ return true;
421
+ }
422
+
423
+ // Recompute `latest` only when the removed version was the latest.
424
+ if (ver === entry.latest) {
425
+ let bestVer = null;
426
+ let bestDef = null;
427
+ for (const [v, d] of entry.versions) {
428
+ if (bestVer === null || semverCompare(v, bestVer) > 0) {
429
+ bestVer = v;
430
+ bestDef = d;
431
+ }
432
+ }
433
+ entry.latest = bestVer;
434
+ entry.latestDef = bestDef;
435
+ }
436
+
437
+ return true;
438
+ }
439
+
440
+ /**
441
+ * Check whether a module (or a specific version) is registered.
442
+ *
443
+ * @param {string} name
444
+ * @param {string} [version] When omitted, returns true if any version of `name` exists.
445
+ * @returns {boolean}
446
+ */
447
+ has(name, version) {
448
+ const entry = this.modules.get(name);
449
+ if (!entry) return false;
450
+ if (version === undefined) return true;
451
+ return entry.versions.has(version);
452
+ }
453
+
454
+ /**
455
+ * Resolve a module by spec.
456
+ *
457
+ * **Spec forms :**
458
+ * - `'foo'` → highest version registered for `foo`
459
+ * - `'foo@1.2.3'` → exact version
460
+ * - `'foo'` + `{ version: '1.2.3' }` → exact version
461
+ *
462
+ * **Caching :**
463
+ * - default : singleton per `(name, version)` in `this.instances`.
464
+ * - `{ isolation: true }` : never cache, always fresh.
465
+ * - `{ instances: customMap }` : flat map keyed by canonical `name@version`.
466
+ *
467
+ * Dependencies are resolved transitively with the same options.
468
+ *
469
+ * @param {string} spec
470
+ * @param {ResolveOptions} [options={}]
471
+ * @throws {Error} When the module (or version) is not registered.
472
+ * @returns {*}
473
+ */
474
+ resolve(spec, options = {}) {
475
+ const parsed = parseSpec(spec);
476
+ const name = parsed.name;
477
+ const explicit = parsed.version || options.version;
478
+
479
+ const entry = this.modules.get(name);
480
+ if (!entry) throw new Error(`Module not found: ${name}`);
481
+
482
+ let def, version;
483
+ if (explicit !== undefined) {
484
+ def = entry.versions.get(explicit);
485
+ if (!def) throw new Error(`Module not found: ${name}@${explicit}`);
486
+ version = explicit;
487
+ } else {
488
+ def = entry.latestDef;
489
+ version = entry.latest;
490
+ }
491
+
492
+ const isolation = !!options.isolation;
493
+ const customMap = (options.instances instanceof Map) ? options.instances : null;
494
+
495
+ // Cache lookup.
496
+ if (!isolation) {
497
+ if (customMap) {
498
+ const key = canonical(name, version);
499
+ if (customMap.has(key)) return customMap.get(key);
500
+ } else {
501
+ const versionsCache = this.instances.get(name);
502
+ if (versionsCache && versionsCache.has(version)) {
503
+ return versionsCache.get(version);
504
+ }
505
+ }
506
+ }
507
+
508
+ // Resolve dependencies (recursive).
509
+ const deps = (def.dependencies || []).map(d => this.resolve(d, options));
510
+ const instance = def.factory.apply({}, deps);
511
+
512
+ // Cache write.
513
+ if (!isolation) {
514
+ if (customMap) {
515
+ customMap.set(canonical(name, version), instance);
516
+ } else {
517
+ let versionsCache = this.instances.get(name);
518
+ if (!versionsCache) {
519
+ versionsCache = new Map();
520
+ this.instances.set(name, versionsCache);
521
+ }
522
+ versionsCache.set(version, instance);
523
+ }
524
+ }
525
+ return instance;
526
+ }
527
+
528
+ /**
529
+ * Resolve multiple module specs in a single call.
530
+ *
531
+ * Each result key is the original spec string (preserving any `@version`
532
+ * suffix), so `resolveAll(['hex', 'utf8@1.0.0'])` yields
533
+ * `{ hex: <inst>, 'utf8@1.0.0': <inst> }`.
534
+ *
535
+ * @param {string[]} specs
536
+ * @param {ResolveOptions} [options={}]
537
+ * @returns {Object<string, *>}
538
+ */
539
+ resolveAll(specs, options = {}) {
540
+ const result = {};
541
+ for (const spec of specs) {
542
+ result[spec] = this.resolve(spec, options);
543
+ }
544
+ return result;
545
+ }
546
+
547
+ /**
548
+ * List registered module definitions matching the given filter.
549
+ *
550
+ * Linear scan ; acceptable for the typical module count (≪ 1000).
551
+ *
552
+ * @param {ListFilter} [filter={}]
553
+ * @returns {ModuleDefinition[]}
554
+ */
555
+ list(filter = {}) {
556
+ const out = [];
557
+ const fName = filter.name;
558
+ const fVer = filter.version;
559
+ const fType = filter.type;
560
+ const typePrefix = (typeof fType === 'string') && fType.endsWith('.');
561
+
562
+ for (const [name, entry] of this.modules) {
563
+ if (fName && fName !== name) continue;
564
+ for (const [version, def] of entry.versions) {
565
+ if (fVer && fVer !== version) continue;
566
+ if (fType) {
567
+ if (!def.type) continue;
568
+ if (typePrefix) {
569
+ if (!def.type.startsWith(fType)) continue;
570
+ } else {
571
+ if (def.type !== fType) continue;
572
+ }
573
+ }
574
+ out.push(def);
575
+ }
576
+ }
577
+ return out;
578
+ }
579
+
580
+ /**
581
+ * Passive, read-only view of the module registry.
582
+ *
583
+ * Companion of {@link ModuleRuntime#list}, which returns the **live**
584
+ * `ModuleDefinition` objects (their `factory`, and a `dependencies` array a
585
+ * caller can splice in place). `snapshot` instead returns frozen metadata
586
+ * rows: enumeration for a devtools registry view without handing out a
587
+ * write channel into registry state, and without the side effect of
588
+ * `resolve()` — which is a full instantiate, not a peek.
589
+ *
590
+ * **Guarantees**
591
+ * - **Instantiates nothing.** No `factory` is invoked and `this.instances`
592
+ * is never written; a call on a registry where nothing has been resolved
593
+ * leaves the instance cache exactly as it was.
594
+ * - **Read-only.** The returned array is frozen, every row is frozen, and
595
+ * each row's `dependencies` is a frozen *copy* — mutating anything the
596
+ * caller receives cannot reach the registry.
597
+ * - **No live handle.** Rows expose no `factory`, no `deps` and no
598
+ * instance, so nothing reachable from a row can be called or patched.
599
+ *
600
+ * The filter is the same one {@link ModuleRuntime#list} accepts, with the
601
+ * same semantics (exact `name` / `version`; exact `type`, or prefix match
602
+ * when `type` ends with `.`).
603
+ *
604
+ * Linear scan over the registry, like `list`.
605
+ *
606
+ * @param {ListFilter} [filter={}]
607
+ * @returns {ReadonlyArray<RegistrySnapshotEntry>} Frozen rows, frozen array.
608
+ */
609
+ snapshot(filter = {}) {
610
+ const out = [];
611
+ const fName = filter.name;
612
+ const fVer = filter.version;
613
+ const fType = filter.type;
614
+ const typePrefix = (typeof fType === 'string') && fType.endsWith('.');
615
+
616
+ for (const [name, entry] of this.modules) {
617
+ if (fName && fName !== name) continue;
618
+ // Read-only peek at the instance cache: never creates the per-name
619
+ // Map (that is `resolve`'s job), so enumeration stays side-effect free.
620
+ const versionsCache = this.instances.get(name);
621
+ for (const [version, def] of entry.versions) {
622
+ if (fVer && fVer !== version) continue;
623
+ if (fType) {
624
+ if (!def.type) continue;
625
+ if (typePrefix) {
626
+ if (!def.type.startsWith(fType)) continue;
627
+ } else {
628
+ if (def.type !== fType) continue;
629
+ }
630
+ }
631
+ const declared = def.dependencies;
632
+ const deps = Array.isArray(declared) ? declared.slice() : [];
633
+ out.push(Object.freeze({
634
+ name,
635
+ version,
636
+ type: (def.type != null) ? def.type : null,
637
+ dependencies: Object.freeze(deps),
638
+ latest: version === entry.latest,
639
+ instantiated: !!(versionsCache && versionsCache.has(version)),
640
+ }));
641
+ }
642
+ }
643
+ return Object.freeze(out);
644
+ }
645
+
646
+ /**
647
+ * Drop cached instances so the next `resolve` re-runs the factory — the
648
+ * registry-side half of a hot module swap.
649
+ *
650
+ * `register()` is **descriptor-only**: re-registering a module (or
651
+ * `unregister()` then `register()`) swaps the stored definition but never
652
+ * touches {@link ModuleRuntime#instances}, so `resolve()` keeps returning
653
+ * the instance built from the *old* factory. `invalidate` is the missing
654
+ * step: register the new descriptor, invalidate, resolve again.
655
+ *
656
+ * **Spec / version semantics** (mirrors `unregister` / `has`) :
657
+ * - `invalidate('foo')` → every registered version of `foo`
658
+ * - `invalidate('foo@1.0.0')` → only that version
659
+ *
660
+ * **Cascade.** With `{ cascade: true }` the target set grows to every
661
+ * module that declares a target among its `dependencies`, transitively —
662
+ * because a dependent's factory already ran with the *old* dependency
663
+ * instance baked into its closure, and nothing would ever hand it the new
664
+ * one. A version-less dependency spec (`'foo'`) only cascades when the
665
+ * invalidated version is the one `resolve('foo')` would pick, i.e. the
666
+ * entry's `latest`; a pinned spec (`'foo@1.0.0'`) cascades only for that
667
+ * exact version.
668
+ *
669
+ * **Atomic.** The never-swap check and every `dehydrate()` call run *before*
670
+ * the first cache write, so a refused module or a throwing `dehydrate()`
671
+ * leaves the instance cache exactly as it was.
672
+ *
673
+ * **`dehydrate()` / `hydrate()` convention (opt-in).** If an outgoing
674
+ * instance exposes a `dehydrate()` function it is called once and its return
675
+ * value is carried out in the result's `state`, keyed by canonical
676
+ * `name@version`. The runtime does **not** re-inject it: `resolve()` is
677
+ * unchanged and knows nothing about the convention. The caller closes the
678
+ * loop, which keeps the state transfer explicit and inspectable :
679
+ *
680
+ * ```js
681
+ * const { invalidated, state } = runtime.invalidate('todoView', { cascade: true });
682
+ * runtime.register(nextTodoView);
683
+ * for (const key of invalidated) {
684
+ * const instance = runtime.resolve(key);
685
+ * if (key in state && typeof instance.hydrate === 'function') {
686
+ * instance.hydrate(state[key]);
687
+ * }
688
+ * }
689
+ * ```
690
+ *
691
+ * **Scope — read this before relying on it.** Three limits are structural,
692
+ * not gaps to be closed later :
693
+ * - **Handles already handed out are never upgraded.** A caller holding the
694
+ * old instance keeps it; only *subsequent* `resolve` calls see the new
695
+ * one. Hot swap works for modules resolved through the runtime on use.
696
+ * - **Factory-closure state is lost by construction.** Re-running the
697
+ * factory is exactly what clears it. The convention above is the answer,
698
+ * and it is opt-in; state that must survive belongs in a module that is
699
+ * not part of the swap.
700
+ * - **Only the default instance cache is affected.** `{ isolation: true }`
701
+ * instances are never cached and so can never be invalidated, and a
702
+ * caller-supplied `{ instances: map }` cache is the caller's to clear.
703
+ *
704
+ * @param {string} spec Module name, or `'name@version'`.
705
+ * @param {InvalidateOptions} [options={}]
706
+ * @throws {Error} When the module (or version) is not registered, or when a
707
+ * target — directly or through the cascade — is in
708
+ * {@link ModuleRuntime.NEVER_SWAP}.
709
+ * @returns {InvalidateResult} Frozen result.
710
+ */
711
+ invalidate(spec, options = {}) {
712
+ const parsed = parseSpec(spec);
713
+ const name = parsed.name;
714
+ const explicit = parsed.version;
715
+
716
+ const entry = this.modules.get(name);
717
+ if (!entry) throw new Error(`Module not found: ${name}`);
718
+ if (explicit !== undefined && !entry.versions.has(explicit)) {
719
+ throw new Error(`Module not found: ${name}@${explicit}`);
720
+ }
721
+
722
+ // 1. Target set : name → Set<version>, seeded from the spec then grown
723
+ // to the transitive dependents when `cascade` is set. Fixpoint loop;
724
+ // the registry is small (≪ 1000) so a linear re-scan is fine.
725
+ const targets = new Map();
726
+ targets.set(name, new Set(
727
+ explicit !== undefined ? [explicit] : entry.versions.keys()
728
+ ));
729
+
730
+ if (options.cascade) {
731
+ let changed = true;
732
+ while (changed) {
733
+ changed = false;
734
+ for (const [depName, depEntry] of this.modules) {
735
+ for (const [depVersion, def] of depEntry.versions) {
736
+ const known = targets.get(depName);
737
+ if (known && known.has(depVersion)) continue;
738
+ if (!this._dependsOnTarget(def, targets)) continue;
739
+ if (known) known.add(depVersion);
740
+ else targets.set(depName, new Set([depVersion]));
741
+ changed = true;
742
+ }
743
+ }
744
+ }
745
+ }
746
+
747
+ // 2. Refuse before mutating anything : a partially applied invalidation
748
+ // is worse than a refused one.
749
+ for (const targetName of targets.keys()) {
750
+ if (ModuleRuntime.NEVER_SWAP.includes(targetName)) {
751
+ throw new Error(
752
+ `Module "${targetName}" is in the never-swap set and cannot be invalidated`
753
+ );
754
+ }
755
+ }
756
+
757
+ // 3. Collect the outgoing state (opt-in `dehydrate()`), still before any
758
+ // cache write, so a throwing `dehydrate` aborts with the cache intact.
759
+ const pending = [];
760
+ const state = {};
761
+ for (const [targetName, versions] of targets) {
762
+ const versionsCache = this.instances.get(targetName);
763
+ if (!versionsCache) continue;
764
+ for (const version of versions) {
765
+ if (!versionsCache.has(version)) continue;
766
+ const instance = versionsCache.get(version);
767
+ const key = canonical(targetName, version);
768
+ pending.push({ name: targetName, version, key });
769
+ if (instance && typeof instance.dehydrate === 'function') {
770
+ state[key] = instance.dehydrate();
771
+ }
772
+ }
773
+ }
774
+
775
+ // 4. Drop.
776
+ const invalidated = [];
777
+ for (const item of pending) {
778
+ const versionsCache = this.instances.get(item.name);
779
+ versionsCache.delete(item.version);
780
+ if (versionsCache.size === 0) this.instances.delete(item.name);
781
+ invalidated.push(item.key);
782
+ }
783
+
784
+ return Object.freeze({
785
+ invalidated: Object.freeze(invalidated),
786
+ state: Object.freeze(state),
787
+ });
788
+ }
789
+
790
+ /**
791
+ * Whether `def` declares any of the `targets` among its `dependencies`.
792
+ *
793
+ * A version-less dependency spec resolves to the entry's `latest`, so it
794
+ * only counts when that exact version is a target ; a pinned `name@version`
795
+ * spec counts only for its own version.
796
+ *
797
+ * @param {ModuleDefinition} def
798
+ * @param {Map<string, Set<string>>} targets name → invalidated versions.
799
+ * @returns {boolean}
800
+ * @private
801
+ */
802
+ _dependsOnTarget(def, targets) {
803
+ const declared = def.dependencies;
804
+ if (!Array.isArray(declared)) return false;
805
+ for (const depSpec of declared) {
806
+ const dp = parseSpec(depSpec);
807
+ const versions = targets.get(dp.name);
808
+ if (!versions) continue;
809
+ if (dp.version !== undefined) {
810
+ if (versions.has(dp.version)) return true;
811
+ continue;
812
+ }
813
+ const depEntry = this.modules.get(dp.name);
814
+ if (depEntry && versions.has(depEntry.latest)) return true;
815
+ }
816
+ return false;
817
+ }
818
+
819
+ /**
820
+ * Serialise a dependency sub-graph to a self-contained code string for use
821
+ * inside a Web Worker.
822
+ *
823
+ * Each spec resolves to an exact `(name, version)` def via `parseSpec`
824
+ * (latest if no version). Dependencies of every emitted module are rewritten
825
+ * as canonical `name@version` to guarantee exact resolution worker-side.
826
+ *
827
+ * @param {string[]} specs Entry-point module specs.
828
+ * @returns {SerializedGraph}
829
+ */
830
+ serialize(specs) {
831
+ const graph = this._buildGraph(specs);
832
+ const canonicalNames = [];
833
+
834
+ const modulesStr = graph.map(node => {
835
+ const { name, version, def } = node;
836
+ const can = canonical(name, version);
837
+ canonicalNames.push(can);
838
+
839
+ const escapedName = name.replace(/'/g, "\\'");
840
+ const escapedVersion = version.replace(/'/g, "\\'");
841
+ const escapedType = def.type ? `,type:'${def.type.replace(/'/g, "\\'")}'` : '';
842
+
843
+ // Rewrite dependencies to canonical name@version to ensure exact
844
+ // resolution inside the worker (which has the same multi-version
845
+ // semantics).
846
+ const escapedDeps = (def.dependencies || []).map(depSpec => {
847
+ const dp = parseSpec(depSpec);
848
+ const depEntry = this.modules.get(dp.name);
849
+ const depVer = dp.version || (depEntry ? depEntry.latest : DEFAULT_VERSION);
850
+ return canonical(dp.name, depVer).replace(/'/g, "\\'");
851
+ });
852
+ const depsStr = escapedDeps.length > 0
853
+ ? `['${escapedDeps.join("','")}']`
854
+ : '[]';
855
+
856
+ const factoryStr = def.factory.toString().replace(/^factory/, 'function');
857
+
858
+ return `{name:'${escapedName}',version:'${escapedVersion}'${escapedType},dependencies:${depsStr},factory:${factoryStr}}`;
859
+ }).join(',');
860
+
861
+ const namesStr = canonicalNames.length > 0
862
+ ? `'${canonicalNames.map(n => n.replace(/'/g, "\\'")).join("','")}'`
863
+ : '';
864
+
865
+ return { list: `[${namesStr}]`, content: `[${modulesStr}]` };
866
+ }
867
+
868
+ /**
869
+ * Build a topologically ordered list of `(name, version, def)` triples
870
+ * covering the transitive dependency closure of the given specs.
871
+ *
872
+ * Iterative depth-first search with a visited set keyed on canonical
873
+ * `name@version` to deduplicate. Each module's dependencies are visited
874
+ * before the module itself.
875
+ *
876
+ * @param {string[]} specs Entry-point module specs.
877
+ * @returns {Array<{name: string, version: string, def: ModuleDefinition}>}
878
+ * @private
879
+ */
880
+ _buildGraph(specs) {
881
+ const visited = new Set();
882
+ const result = [];
883
+
884
+ const visit = (spec) => {
885
+ const parsed = parseSpec(spec);
886
+ const entry = this.modules.get(parsed.name);
887
+ if (!entry) throw new Error(`Module not found: ${parsed.name}`);
888
+ const version = parsed.version || entry.latest;
889
+ const def = entry.versions.get(version);
890
+ if (!def) throw new Error(`Module not found: ${parsed.name}@${version}`);
891
+
892
+ const key = canonical(parsed.name, version);
893
+ if (visited.has(key)) return;
894
+ visited.add(key);
895
+
896
+ (def.dependencies || []).forEach(visit);
897
+ result.push({ name: parsed.name, version, def });
898
+ };
899
+
900
+ specs.forEach(visit);
901
+ return result;
902
+ }
903
+ }
904
+
905
+ /**
906
+ * Self-contained source code of the entire runtime (constants +
907
+ * private helpers + `ModuleRuntime` class), ready to be inlined
908
+ * into a Worker without depending on `import`.
909
+ *
910
+ * `worker-helper.js` injects this string at worker startup so that
911
+ * the class (serialised via `.toString()`) can find `SEMVER_RE`,
912
+ * `TYPE_RE`, `DEFAULT_VERSION`, `semverCompare`, `parseSpec`, and
913
+ * `canonical` at execution time.
914
+ *
915
+ * **Order is critical**: helpers and constants must precede the class
916
+ * to satisfy the hoisting rules for `function` declarations and the
917
+ * temporal dead zone of `const`.
918
+ *
919
+ * @type {string}
920
+ */
921
+ export const runtimeSource = [
922
+ `const SEMVER_RE = ${SEMVER_RE.toString()};`,
923
+ `const TYPE_RE = ${TYPE_RE.toString()};`,
924
+ `const DEFAULT_VERSION = ${JSON.stringify(DEFAULT_VERSION)};`,
925
+ semverCompare.toString(),
926
+ parseSpec.toString(),
927
+ canonical.toString(),
928
+ ModuleRuntime.toString(),
929
+ ].join('\n\n');