@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,858 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview Lightweight reactive signals.
7
+ *
8
+ * A `signal` is a mutable cell of value that notifies subscribers whenever
9
+ * its value changes. A `derived` signal recomputes from one or more source
10
+ * signals automatically. An `effect` runs a side-effect whenever any signal
11
+ * read inside it changes (auto-tracking). A `resource` wraps an async
12
+ * fetcher into a signal carrying `{status, value, error}`.
13
+ * `computed` is an auto-tracked, memoized, lazy read-only derived signal.
14
+ * `scheduleNotify` / `flushSync` provide opt-in async coalescing.
15
+ *
16
+ * Design goals :
17
+ * - **Tiny** : ~350 lines, dependencies-explicit by default ; auto-tracking
18
+ * only inside `effect` / `computed` (never inside `derived` to keep that
19
+ * primitive predictable).
20
+ * - **Sync notifications** : `set()` fires subscribers synchronously by
21
+ * default. Opt-in async coalescing via `scheduleNotify(mode)`.
22
+ * - **No memory leaks** : every subscription returns an unsubscribe.
23
+ * - **No DOM coupling** : usable in workers ; `raf` mode degrades to
24
+ * microtask when `requestAnimationFrame` is absent.
25
+ *
26
+ * @example
27
+ * const sig = runtime.resolve('signal');
28
+ * const count = sig.create(0);
29
+ * const double = sig.derived([count], (n) => n * 2);
30
+ * const triple = sig.computed(() => count.get() * 3);
31
+ *
32
+ * const stop = sig.effect(() => console.log('count =', count.get()));
33
+ * count.set(3); // logs: count = 3
34
+ * stop(); // detaches the effect
35
+ *
36
+ * const users = sig.resource(() => fetch('/api/users').then(r => r.json()));
37
+ * users.subscribe(s => console.log(s.status, s.value));
38
+ *
39
+ */
40
+
41
+ /**
42
+ * A writable reactive cell holding a value of type `T`.
43
+ * @template T
44
+ * @typedef {object} Signal
45
+ * @property {() => T} get Read the value, registering as a dependency of any active effect.
46
+ * @property {() => T} peek Read the value without registering a dependency.
47
+ * @property {(next: T) => void} set Replace the value and notify subscribers (unless equal per `eq`).
48
+ * @property {(fn: (current: T) => T) => void} update Set the value from a function of the current value.
49
+ * @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
50
+ * @property {number} size Current subscriber count.
51
+ * @property {boolean} _isSignal Internal marker.
52
+ * @property {Set<Function>} _subs Internal subscriber set.
53
+ * @property {string} _graphId Internal dependency-graph node id (`s<n>`).
54
+ */
55
+
56
+ /**
57
+ * A read-only reactive cell of type `T` (e.g. from `resource`).
58
+ * @template T
59
+ * @typedef {object} ReadonlySignal
60
+ * @property {() => T} get Read the value, registering as a dependency of any active effect.
61
+ * @property {() => T} peek Read the value without registering a dependency.
62
+ * @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
63
+ * @property {number} size Current subscriber count.
64
+ * @property {boolean} _isSignal Internal marker.
65
+ * @property {Set<Function>} _subs Internal subscriber set.
66
+ */
67
+
68
+ /**
69
+ * A read-only reactive cell of type `T` returned by `derived`, additionally
70
+ * disposable to detach its dependency subscriptions.
71
+ * @template T
72
+ * @typedef {object} DisposableReadonlySignal
73
+ * @property {() => T} get Read the value, registering as a dependency of any active effect.
74
+ * @property {() => T} peek Read the value without registering a dependency.
75
+ * @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
76
+ * @property {() => void} dispose Detach all dependency subscriptions (idempotent). After
77
+ * `dispose()`, `get()`/`peek()` keep returning the last computed value and a dep write
78
+ * never recomputes it again.
79
+ * @property {number} size Current subscriber count.
80
+ * @property {boolean} _isSignal Internal marker.
81
+ * @property {Set<Function>} _subs Internal subscriber set.
82
+ */
83
+
84
+ /**
85
+ * State carried by a `resource` / `derivedAsync` signal.
86
+ * @template T
87
+ * @typedef {object} ResourceState
88
+ * @property {'idle'|'pending'|'resolved'|'rejected'} status Current fetch status.
89
+ * @property {T|null} value Last resolved value (preserved while pending/rejected).
90
+ * @property {Error|null} error Error from the latest rejected fetch, else null.
91
+ */
92
+
93
+ /**
94
+ * Read-only resource signal returned by `resource`.
95
+ * @template T
96
+ * @typedef {object} ResourceSignal
97
+ * @property {() => ResourceState<T>} get Read the resource state, registering as a dependency.
98
+ * @property {() => ResourceState<T>} peek Read the resource state without registering.
99
+ * @property {(fn: (state: ResourceState<T>) => void) => (() => void)} subscribe Subscribe to state changes.
100
+ * @property {() => void} refresh Trigger a new fetch (re-using this signal).
101
+ * @property {number} size Current subscriber count.
102
+ * @property {boolean} _isSignal Internal marker.
103
+ * @property {Set<Function>} _subs Internal subscriber set.
104
+ */
105
+
106
+ /**
107
+ * Read-only async-derived resource signal returned by `derivedAsync`.
108
+ * @template T
109
+ * @typedef {object} DerivedAsyncSignal
110
+ * @property {() => ResourceState<T>} get Read the resource state, registering as a dependency.
111
+ * @property {() => ResourceState<T>} peek Read the resource state without registering.
112
+ * @property {(fn: (state: ResourceState<T>) => void) => (() => void)} subscribe Subscribe to state changes.
113
+ * @property {() => void} refresh Trigger a new fetch.
114
+ * @property {() => void} dispose Detach all dependency subscriptions (idempotent).
115
+ * @property {number} size Current subscriber count.
116
+ * @property {boolean} _isSignal Internal marker.
117
+ * @property {Set<Function>} _subs Internal subscriber set.
118
+ */
119
+
120
+ /**
121
+ * A read-only auto-tracked memoized derived signal returned by `computed`.
122
+ * @template T
123
+ * @typedef {object} ComputedSignal
124
+ * @property {() => T} get Read the computed value, registering as a dependency of any active effect.
125
+ * @property {() => T} peek Read the computed value without registering a dependency.
126
+ * @property {(fn: (value: T) => void) => (() => void)} subscribe Subscribe to changes; returns an unsubscribe.
127
+ * @property {() => void} dispose Detach all tracked-source subscriptions (idempotent). After
128
+ * `dispose()`, `get()`/`peek()` keep returning the last computed value and a source write
129
+ * never recomputes it again.
130
+ * @property {number} size Current subscriber count.
131
+ * @property {boolean} _isSignal Internal marker.
132
+ * @property {Set<Function>} _subs Internal subscriber set.
133
+ * @property {string} _graphId Internal dependency-graph node id (`c<n>`).
134
+ */
135
+
136
+ /**
137
+ * A signal node of the snapshot returned by `inspectGraph()`.
138
+ * @typedef {object} GraphSignalNode
139
+ * @property {string} id Stable per-factory node id — `s<n>` (`create`) or `c<n>` (`computed`).
140
+ * @property {'signal'|'computed'} kind Which primitive minted the node.
141
+ */
142
+
143
+ /**
144
+ * An effect node of the snapshot returned by `inspectGraph()`.
145
+ * @typedef {object} GraphEffectNode
146
+ * @property {string} id Stable per-factory effect id (`e<n>`).
147
+ * @property {number} deps Number of signals this effect currently depends on.
148
+ */
149
+
150
+ /**
151
+ * A directed dependency edge: the effect re-runs when the signal changes.
152
+ * @typedef {object} GraphEdge
153
+ * @property {string} effect Effect node id.
154
+ * @property {string} signal Signal node id.
155
+ */
156
+
157
+ /**
158
+ * Frozen, defensively-copied view of one factory instance's dependency graph.
159
+ * @typedef {object} SignalGraphSnapshot
160
+ * @property {ReadonlyArray<GraphSignalNode>} signals Signals at least one live effect depends on.
161
+ * @property {ReadonlyArray<GraphEffectNode>} effects Live (non-stopped) effects.
162
+ * @property {ReadonlyArray<GraphEdge>} edges Effect → signal dependency edges.
163
+ */
164
+
165
+ /**
166
+ * Public shape returned by `signal.factory()` — the reactivity core.
167
+ * @typedef {object} SignalAPI
168
+ * @property {<T>(initial: T, opts?: { eq?: (a: T, b: T) => boolean }) => Signal<T>} create Create a writable signal.
169
+ * @property {<T>(deps: Array<Signal<any>|ReadonlySignal<any>>, fn: (...values: any[]) => T, opts?: { eq?: (a: T, b: T) => boolean }) => DisposableReadonlySignal<T>} derived Create a read-only signal derived from explicit deps.
170
+ * @property {(fn: () => void) => void} batch Batch multiple `set()` calls so subscribers fire once at the end.
171
+ * @property {<T>(fn: () => T) => T} untrack Read signals without registering in the active effect.
172
+ * @property {(fn: () => void) => (() => void)} effect Run `fn`, auto-tracking reads; returns a `stop()`.
173
+ * @property {<T>(fetcher: () => Promise<T>, opts?: { autoStart?: boolean, eq?: (a: ResourceState<T>, b: ResourceState<T>) => boolean }) => ResourceSignal<T>} resource Wrap an async fetcher into a resource signal.
174
+ * @property {<T>(deps: Array<Signal<any>|ReadonlySignal<any>>, fn: (...values: any[]) => T | Promise<T>, opts?: { autoStart?: boolean }) => DerivedAsyncSignal<T>} derivedAsync Async-derived resource signal.
175
+ * @property {<T>(fn: () => T, opts?: { eq?: (a: T, b: T) => boolean }) => ComputedSignal<T>} computed Auto-tracked memoized read-only derived signal.
176
+ * @property {(mode: 'sync'|'microtask'|'raf') => (() => void)} scheduleNotify Enable opt-in async coalescing; returns a disposer restoring the previous mode.
177
+ * @property {() => void} flushSync Force immediate flush of any pending coalesced notifications.
178
+ * @property {() => SignalGraphSnapshot} inspectGraph Read-only snapshot of this instance's dependency graph.
179
+ */
180
+
181
+ export const signal = {
182
+ name: 'signal',
183
+ version: '1.2.0',
184
+ type: 'fw.io.utils',
185
+ dependencies: [],
186
+
187
+ /** @returns {SignalAPI} */
188
+ factory() {
189
+
190
+ // ── Batch state (per-factory closure) ───────────────────────────────
191
+ let _batchDepth = 0;
192
+ let _batchPending = null; // Map<signal, latestValue>
193
+
194
+ // ── Auto-tracking state (per-factory closure) ───────────────────────
195
+ // When an effect runs, the currently-active tracker collects every
196
+ // signal whose `get()` is called. `derived` is intentionally NOT
197
+ // auto-tracking - its deps are explicit (predictable, no surprise
198
+ // re-runs).
199
+ let _currentTracker = null; // Set<signal> | null
200
+
201
+ // ── Async coalescing state (per-factory closure) ─────────────────────
202
+ // Default mode is 'sync' (no coalescing). When changed via
203
+ // `scheduleNotify(mode)`, set() records pending signals instead of
204
+ // firing immediately. A single flush is scheduled per tick.
205
+ let _notifyMode = 'sync'; // 'sync' | 'microtask' | 'raf'
206
+ let _coalescePending = null; // Map<signal, latestValue> | null
207
+ let _flushScheduled = false; // guard: only one scheduled flush per tick
208
+
209
+ // ── Dependency-graph state (per-factory closure) ────────────────────
210
+ // Node identity is minted at creation (`_graphId`, a plain string) and
211
+ // the graph itself is kept ONLY on the live effects, as sets of those
212
+ // strings — never as references to signal objects. That is deliberate:
213
+ // an effect already retains its deps' subscriber sets, and holding the
214
+ // signal objects too would extend their lifetime for the sake of
215
+ // introspection. Stopped effects are removed, so this state is bounded
216
+ // by the same lifecycle contract `effect()` already has.
217
+ let _nodeSeq = 0; // shared by create() and computed()
218
+ let _effectSeq = 0;
219
+ const _liveEffects = new Set(); // Set<{ id: string, deps: Set<string> }>
220
+
221
+ /**
222
+ * Drain the coalesce-pending map: notify each signal's subscribers
223
+ * exactly once with its latest value. Called by the scheduled flush
224
+ * or imperatively via `flushSync()`.
225
+ */
226
+ function drainCoalesced() {
227
+ _flushScheduled = false;
228
+ const queue = _coalescePending;
229
+ _coalescePending = null;
230
+ if (!queue) return;
231
+ for (const [sig, v] of queue) {
232
+ for (const sub of [...sig._subs]) {
233
+ try { sub(v); } catch { /* subscriber error never breaks others */ }
234
+ }
235
+ }
236
+ }
237
+
238
+ /**
239
+ * Schedule a single async drain according to the current `_notifyMode`.
240
+ * 'raf' falls back to microtask when `requestAnimationFrame` is absent
241
+ * (e.g. workers).
242
+ */
243
+ function scheduleFlush() {
244
+ if (_notifyMode === 'raf' && typeof requestAnimationFrame === 'function') {
245
+ requestAnimationFrame(drainCoalesced);
246
+ } else {
247
+ Promise.resolve().then(drainCoalesced);
248
+ }
249
+ }
250
+
251
+ /**
252
+ * Create a writable signal.
253
+ *
254
+ * @template T
255
+ * @param {T} initial - Initial value.
256
+ * @param {Object} [opts]
257
+ * @param {(a:T,b:T)=>boolean} [opts.eq=Object.is]
258
+ * @returns {object} signal
259
+ */
260
+ function create(initial, opts) {
261
+ let value = initial;
262
+ const eq = (opts && typeof opts.eq === 'function') ? opts.eq : Object.is;
263
+ const subs = new Set();
264
+
265
+ const api = {
266
+ get() {
267
+ // Auto-tracking : if an effect is currently running, register
268
+ // this signal as one of its dependencies.
269
+ if (_currentTracker !== null) _currentTracker.add(api);
270
+ return value;
271
+ },
272
+ /** Read without registering a subscription in an active effect. */
273
+ peek() { return value; },
274
+ set(next) {
275
+ if (eq(value, next)) return;
276
+ value = next;
277
+ if (_batchDepth > 0) {
278
+ _batchPending.set(api, value);
279
+ return;
280
+ }
281
+ // Opt-in async coalescing: record pending; schedule one flush.
282
+ if (_notifyMode !== 'sync') {
283
+ if (_coalescePending === null) _coalescePending = new Map();
284
+ _coalescePending.set(api, value);
285
+ if (!_flushScheduled) {
286
+ _flushScheduled = true;
287
+ scheduleFlush();
288
+ }
289
+ return;
290
+ }
291
+ for (const fn of [...subs]) {
292
+ try { fn(value); }
293
+ catch { /* subscriber error never breaks others */ }
294
+ }
295
+ },
296
+ update(fn) { api.set(fn(value)); },
297
+ subscribe(fn) {
298
+ if (typeof fn !== 'function') return () => {};
299
+ subs.add(fn);
300
+ return () => subs.delete(fn);
301
+ },
302
+ get size() { return subs.size; },
303
+ _isSignal: true,
304
+ _subs: subs,
305
+ _graphId: 's' + (++_nodeSeq),
306
+ };
307
+ return api;
308
+ }
309
+
310
+ /**
311
+ * Create a read-only signal derived from explicit deps. Recomputes
312
+ * whenever any dep changes ; subscribers fire when the result differs
313
+ * (per `opts.eq`).
314
+ *
315
+ * The returned signal exposes `dispose()` to detach the dep
316
+ * subscriptions it holds internally (mirrors `derivedAsync`) — call it
317
+ * when the derived signal is discarded (e.g. component unmount,
318
+ * list-row churn) to avoid it recomputing forever on every dep write.
319
+ * After `dispose()`, `get()`/`peek()` keep returning the last computed
320
+ * value and never resubscribe.
321
+ */
322
+ function derived(deps, fn, opts) {
323
+ if (!Array.isArray(deps) || deps.some(d => !d || !d._isSignal))
324
+ throw new Error('signal.derived: deps must be an array of signals');
325
+ if (typeof fn !== 'function')
326
+ throw new Error('signal.derived: fn must be a function');
327
+
328
+ const compute = () => fn(...deps.map(d => d.peek()));
329
+ const inner = create(compute(), opts);
330
+
331
+ let _disposed = false;
332
+ const _unsubs = deps.map(d => d.subscribe(() => {
333
+ if (_disposed) return;
334
+ inner.set(compute());
335
+ }));
336
+
337
+ /**
338
+ * Detach all dep subscriptions so the derived signal can be
339
+ * garbage-collected. Idempotent.
340
+ */
341
+ function dispose() {
342
+ if (_disposed) return;
343
+ _disposed = true;
344
+ for (const off of _unsubs) {
345
+ try { off(); } catch { /* swallow */ }
346
+ }
347
+ _unsubs.length = 0;
348
+ }
349
+
350
+ return {
351
+ get: inner.get,
352
+ peek: inner.peek,
353
+ subscribe: inner.subscribe,
354
+ dispose,
355
+ get size() { return inner.size; },
356
+ _isSignal: true,
357
+ _subs: inner._subs,
358
+ };
359
+ }
360
+
361
+ /**
362
+ * Batch multiple `set()` calls so subscribers fire **once** at the end.
363
+ */
364
+ function batch(fn) {
365
+ if (typeof fn !== 'function') return;
366
+ if (_batchDepth === 0) _batchPending = new Map();
367
+ _batchDepth++;
368
+ try { fn(); }
369
+ finally {
370
+ _batchDepth--;
371
+ if (_batchDepth === 0) {
372
+ const queue = _batchPending;
373
+ _batchPending = null;
374
+ for (const [sig, v] of queue) {
375
+ for (const sub of [...sig._subs]) {
376
+ try { sub(v); } catch { /* swallow */ }
377
+ }
378
+ }
379
+ }
380
+ }
381
+ }
382
+
383
+ /**
384
+ * Read a signal **without** registering as a dependency in the
385
+ * currently-active effect. The wrapper temporarily nulls the tracker,
386
+ * runs `fn`, then restores it.
387
+ *
388
+ * @template T
389
+ * @param {() => T} fn
390
+ * @returns {T}
391
+ */
392
+ function untrack(fn) {
393
+ const prev = _currentTracker;
394
+ _currentTracker = null;
395
+ try { return fn(); }
396
+ finally { _currentTracker = prev; }
397
+ }
398
+
399
+ /**
400
+ * Run `fn` once, tracking every signal it reads. Re-run `fn` whenever
401
+ * any of those signals change. Returns a `stop()` function that
402
+ * unsubscribes from all tracked signals.
403
+ *
404
+ * Dependencies are **re-collected** on each run, so conditional reads
405
+ * work correctly :
406
+ *
407
+ * effect(() => {
408
+ * if (showName.get()) console.log(name.get());
409
+ * // ↑ `name` is only tracked while `showName` is true.
410
+ * });
411
+ *
412
+ * Reads done inside `untrack(...)` do NOT register.
413
+ *
414
+ * Errors thrown by `fn` are caught and printed via `console.error`
415
+ * so a faulty effect cannot break unrelated effects.
416
+ *
417
+ * **Recursion contract.** Subscriptions to freshly-collected deps are
418
+ * wired only AFTER `fn` returns, so a synchronous `signal.set(...)`
419
+ * inside `fn` that targets a tracked signal does NOT re-enter the
420
+ * effect immediately ; the value change is visible to the next read
421
+ * via `get()`. Indirect recursion (a microtask scheduled by `fn` that
422
+ * later mutates a tracked dep) is supported and re-runs the effect.
423
+ * If a write must mutate a tracked signal without scheduling a
424
+ * re-run, wrap it in `untrack(() => sig.set(v))`. There is no
425
+ * runtime recursion guard ; consumers are responsible for avoiding
426
+ * unbounded loops between effects and the signals they mutate.
427
+ *
428
+ * @param {() => void} fn
429
+ * @returns {() => void} stop
430
+ */
431
+ function effect(fn) {
432
+ if (typeof fn !== 'function')
433
+ throw new Error('signal.effect: fn must be a function');
434
+
435
+ const unsubscribers = new Set();
436
+ let stopped = false;
437
+ // Graph record for this effect: id + the ids of its current deps.
438
+ // Registered up front so an effect is visible while its first run
439
+ // is still in flight; removed by `stop()`.
440
+ const record = { id: 'e' + (++_effectSeq), deps: new Set() };
441
+ _liveEffects.add(record);
442
+
443
+ function detach() {
444
+ for (const off of unsubscribers) {
445
+ try { off(); } catch { /* swallow */ }
446
+ }
447
+ unsubscribers.clear();
448
+ }
449
+
450
+ function run() {
451
+ if (stopped) return;
452
+ detach();
453
+ const deps = new Set();
454
+ const prev = _currentTracker;
455
+ _currentTracker = deps;
456
+ try { fn(); }
457
+ catch (e) {
458
+ try { console.error('signal.effect: handler threw', e); }
459
+ catch { /* swallow */ }
460
+ }
461
+ finally { _currentTracker = prev; }
462
+ // Subscribe to each dep ; on any change, re-run. The graph
463
+ // record is rebuilt from the same freshly-collected set, so
464
+ // conditional reads are reflected edge-for-edge.
465
+ record.deps.clear();
466
+ for (const sig of deps) {
467
+ record.deps.add(sig._graphId);
468
+ const off = sig.subscribe(run);
469
+ unsubscribers.add(off);
470
+ }
471
+ }
472
+
473
+ run();
474
+
475
+ return function stop() {
476
+ stopped = true;
477
+ detach();
478
+ record.deps.clear();
479
+ _liveEffects.delete(record);
480
+ };
481
+ }
482
+
483
+ /**
484
+ * Wrap an async `fetcher` into a read-only signal carrying
485
+ * `{ status: 'idle' | 'pending' | 'resolved' | 'rejected',
486
+ * value: T | null, error: Error | null }`.
487
+ *
488
+ * Starts in `'idle'`, calls `refresh()` to fetch. The returned signal
489
+ * also exposes `refresh()` which triggers a new fetch (re-using the
490
+ * same signal, so subscribers see the transition `pending → resolved`).
491
+ *
492
+ * Use case : SSR `<initialData>`, list refresh button, polling.
493
+ *
494
+ * @template T
495
+ * @param {() => Promise<T>} fetcher
496
+ * @param {Object} [opts]
497
+ * @param {boolean} [opts.autoStart=true] - Trigger the first fetch
498
+ * immediately on creation.
499
+ * @param {(prev:any, next:any)=>boolean} [opts.eq] - Equality on the
500
+ * wrapped state (default : reference compare on `value`).
501
+ * @returns {object} `{ get, peek, subscribe, refresh, _isSignal }`
502
+ */
503
+ function resource(fetcher, opts) {
504
+ if (typeof fetcher !== 'function')
505
+ throw new Error('signal.resource: fetcher must be a function');
506
+
507
+ const autoStart = !(opts && opts.autoStart === false);
508
+ // Custom eq : compare on { status, value, error } shape - a
509
+ // setState that produces the same triple is a no-op.
510
+ const eq = (opts && typeof opts.eq === 'function')
511
+ ? opts.eq
512
+ : (a, b) => a.status === b.status && a.value === b.value && a.error === b.error;
513
+
514
+ const inner = create(
515
+ { status: 'idle', value: null, error: null },
516
+ { eq }
517
+ );
518
+
519
+ // Token to invalidate in-flight fetches when `refresh()` is called
520
+ // again before the previous one resolves.
521
+ let _token = 0;
522
+
523
+ function refresh() {
524
+ const token = ++_token;
525
+ inner.set({
526
+ status: 'pending',
527
+ value: inner.peek().value, // preserve last value during loading
528
+ error: null,
529
+ });
530
+ Promise.resolve()
531
+ .then(() => fetcher())
532
+ .then(
533
+ (v) => {
534
+ if (token !== _token) return; // superseded
535
+ inner.set({ status: 'resolved', value: v, error: null });
536
+ },
537
+ (err) => {
538
+ if (token !== _token) return;
539
+ inner.set({
540
+ status: 'rejected',
541
+ value: inner.peek().value,
542
+ error: err instanceof Error ? err : new Error(String(err)),
543
+ });
544
+ }
545
+ );
546
+ }
547
+
548
+ if (autoStart) refresh();
549
+
550
+ return {
551
+ get: inner.get,
552
+ peek: inner.peek,
553
+ subscribe: inner.subscribe,
554
+ refresh,
555
+ get size() { return inner.size; },
556
+ _isSignal: true,
557
+ _subs: inner._subs,
558
+ };
559
+ }
560
+
561
+ /**
562
+ * Async-derived resource - like `derived` but the compute function
563
+ * may return a Promise. Returns a resource-shaped signal carrying
564
+ * `{ status, value, error }`. Re-runs `fn(...deps)` whenever any dep
565
+ * changes, with the same stale-token guard as `resource`.
566
+ *
567
+ * Use case : a list `query` signal + a `page` signal → a derived
568
+ * resource that fetches the matching page.
569
+ *
570
+ * const query = signal.create('foo');
571
+ * const page = signal.create(1);
572
+ * const data = signal.derivedAsync([query, page], (q, p) =>
573
+ * fetch(`/api/search?q=${q}&p=${p}`).then(r => r.json())
574
+ * );
575
+ * data.subscribe(s => console.log(s.status, s.value));
576
+ *
577
+ * @template T
578
+ * @param {Array} deps - Source signals (explicit, like `derived`).
579
+ * @param {(...values:any[]) => T | Promise<T>} fn
580
+ * @param {Object} [opts]
581
+ * @param {boolean} [opts.autoStart=true]
582
+ * @returns {object} resource-shaped read-only signal with `refresh()`.
583
+ */
584
+ function derivedAsync(deps, fn, opts) {
585
+ if (!Array.isArray(deps) || deps.some(d => !d || !d._isSignal))
586
+ throw new Error('signal.derivedAsync: deps must be an array of signals');
587
+ if (typeof fn !== 'function')
588
+ throw new Error('signal.derivedAsync: fn must be a function');
589
+
590
+ const r = resource(
591
+ () => Promise.resolve().then(() => fn(...deps.map(d => d.peek()))),
592
+ opts,
593
+ );
594
+
595
+ // Track every dep subscription so we can release them on dispose,
596
+ // avoiding the leak when the resource is discarded by the caller
597
+ // (e.g. component unmount, list-row churn).
598
+ const _unsubs = [];
599
+ let _disposed = false;
600
+
601
+ for (const d of deps) {
602
+ const off = d.subscribe(() => {
603
+ if (_disposed) return;
604
+ r.refresh();
605
+ });
606
+ _unsubs.push(off);
607
+ }
608
+
609
+ /**
610
+ * Detach all dep subscriptions so the resource can be garbage-
611
+ * collected. Subsequent `refresh()` calls become no-ops via the
612
+ * `_disposed` guard. Idempotent.
613
+ */
614
+ function dispose() {
615
+ if (_disposed) return;
616
+ _disposed = true;
617
+ for (const off of _unsubs) {
618
+ try { off(); } catch { /* swallow */ }
619
+ }
620
+ _unsubs.length = 0;
621
+ }
622
+
623
+ return {
624
+ get: r.get,
625
+ peek: r.peek,
626
+ subscribe: r.subscribe,
627
+ refresh: r.refresh,
628
+ dispose,
629
+ get size() { return r.size; },
630
+ _isSignal: true,
631
+ _subs: r._subs,
632
+ };
633
+ }
634
+
635
+ /**
636
+ * Auto-tracked, memoized, read-only derived signal.
637
+ *
638
+ * Dependencies are collected automatically (like `effect`) on each run —
639
+ * no explicit deps array (contrast `derived`, which keeps explicit deps).
640
+ * Lazy: recomputes on read after any tracked source changed.
641
+ * Reading a `computed` inside an `effect` or another `computed` registers
642
+ * it as a dependency (composable). `untrack(fn)` suppresses tracking
643
+ * inside the compute function.
644
+ *
645
+ * @template T
646
+ * @param {() => T} fn
647
+ * @param {{ eq?: (a: T, b: T) => boolean }} [opts]
648
+ * @returns {ComputedSignal<T>}
649
+ */
650
+ function computed(fn, opts) {
651
+ if (typeof fn !== 'function')
652
+ throw new Error('signal.computed: fn must be a function');
653
+
654
+ const eq = (opts && typeof opts.eq === 'function') ? opts.eq : Object.is;
655
+ /** Subscribers of this computed signal (effects / other computeds). */
656
+ const subs = new Set();
657
+
658
+ let _dirty = true; // always recompute on the first read
659
+ let _value; // last memoized value (undefined before first run)
660
+ let _unsubs = []; // unsubscribers for currently-tracked deps
661
+ let _disposed = false;
662
+
663
+ /** Release all dep subscriptions; called before each recompute. */
664
+ function detachDeps() {
665
+ for (const off of _unsubs) {
666
+ try { off(); } catch { /* swallow */ }
667
+ }
668
+ _unsubs = [];
669
+ }
670
+
671
+ /**
672
+ * Called by any tracked dep when it changes.
673
+ * Eagerly recomputes so subscribers receive the fresh value, and
674
+ * re-collects deps (supporting conditional reads).
675
+ */
676
+ function onDepChanged() {
677
+ if (_disposed) return;
678
+ if (!_dirty) _dirty = true; // guard: avoid re-entry below
679
+ detachDeps();
680
+
681
+ // Re-collect deps.
682
+ const deps = new Set();
683
+ const prevTracker = _currentTracker;
684
+ _currentTracker = deps;
685
+ let next;
686
+ try { next = fn(); }
687
+ finally { _currentTracker = prevTracker; }
688
+
689
+ const prevVal = _value;
690
+ _value = next;
691
+ _dirty = false;
692
+
693
+ // Re-subscribe with fresh dep set.
694
+ for (const sig of deps) {
695
+ _unsubs.push(sig.subscribe(onDepChanged));
696
+ }
697
+
698
+ // Propagate to this computed's subscribers only if value changed.
699
+ if (!eq(prevVal, next)) {
700
+ for (const sub of [...subs]) {
701
+ try { sub(next); } catch { /* swallow */ }
702
+ }
703
+ }
704
+ }
705
+
706
+ /**
707
+ * Perform the initial (lazy) computation: collect deps, compute value,
708
+ * subscribe to each dep with `onDepChanged`.
709
+ * Must be called only when `_dirty === true`.
710
+ */
711
+ function initialCompute() {
712
+ detachDeps();
713
+ const deps = new Set();
714
+ const prevTracker = _currentTracker;
715
+ _currentTracker = deps;
716
+ try { _value = fn(); }
717
+ finally { _currentTracker = prevTracker; }
718
+ _dirty = false;
719
+ for (const sig of deps) {
720
+ _unsubs.push(sig.subscribe(onDepChanged));
721
+ }
722
+ }
723
+
724
+ const api = {
725
+ get() {
726
+ // Register this computed as a dep of any active outer tracker.
727
+ if (_currentTracker !== null) _currentTracker.add(api);
728
+ // Post-dispose: never recompute, keep returning the last value.
729
+ if (_dirty && !_disposed) initialCompute();
730
+ return _value;
731
+ },
732
+ peek() {
733
+ // Compute without registering in any outer tracker.
734
+ if (_dirty && !_disposed) {
735
+ const prevTracker = _currentTracker;
736
+ _currentTracker = null;
737
+ initialCompute();
738
+ _currentTracker = prevTracker;
739
+ }
740
+ return _value;
741
+ },
742
+ subscribe(cb) {
743
+ if (typeof cb !== 'function') return () => {};
744
+ subs.add(cb);
745
+ return () => subs.delete(cb);
746
+ },
747
+ /**
748
+ * Detach all tracked-source subscriptions so this computed can
749
+ * be garbage-collected instead of recomputing forever on every
750
+ * source write. Idempotent. After `dispose()`, `get()`/`peek()`
751
+ * keep returning the last computed value and never resubscribe.
752
+ */
753
+ dispose() {
754
+ if (_disposed) return;
755
+ _disposed = true;
756
+ detachDeps();
757
+ },
758
+ get size() { return subs.size; },
759
+ _isSignal: true,
760
+ _subs: subs,
761
+ _graphId: 'c' + (++_nodeSeq),
762
+ };
763
+
764
+ return Object.freeze(api);
765
+ }
766
+
767
+ /**
768
+ * Enable opt-in async coalescing for subsequent notifications.
769
+ * `'microtask'` → flush via `Promise.resolve().then(…)`;
770
+ * `'raf'` → `requestAnimationFrame` (falls back to microtask when rAF
771
+ * is absent, e.g. workers);
772
+ * `'sync'` → restore default synchronous notifications.
773
+ *
774
+ * Returns a disposer that restores the previous mode.
775
+ *
776
+ * @param {'sync'|'microtask'|'raf'} mode
777
+ * @returns {() => void}
778
+ */
779
+ function scheduleNotify(mode) {
780
+ const prev = _notifyMode;
781
+ _notifyMode = mode;
782
+ // If switching back to sync, flush anything pending immediately.
783
+ if (mode === 'sync' && _coalescePending !== null) {
784
+ drainCoalesced();
785
+ }
786
+ return function disposer() {
787
+ _notifyMode = prev;
788
+ // If restoring sync, flush pending notifications immediately.
789
+ if (prev === 'sync' && _coalescePending !== null) {
790
+ drainCoalesced();
791
+ }
792
+ };
793
+ }
794
+
795
+ /**
796
+ * Force an immediate flush of any pending coalesced notifications.
797
+ * No-op when coalescing is not active or there is nothing pending.
798
+ */
799
+ function flushSync() {
800
+ drainCoalesced();
801
+ }
802
+
803
+ /**
804
+ * Read-only snapshot of **this factory instance's** effect dependency
805
+ * graph: the live effects, the signals they currently depend on, and
806
+ * the edges between them.
807
+ *
808
+ * Reading the graph is **not** a reactive read. The snapshot is built
809
+ * from the private tracking records only — no signal value is read
810
+ * through `get()` — and the whole build additionally runs inside
811
+ * `untrack`, so calling this from within an active `effect` or
812
+ * `computed` can never register a dependency. An accessor that reported
813
+ * the graph by walking it through the normal read path would change the
814
+ * graph it reports; this one does not.
815
+ *
816
+ * The returned object, its arrays and every node/edge are frozen copies:
817
+ * mutating them throws and never reaches the real tracking state.
818
+ *
819
+ * Scope, stated rather than implied: the graph is the **effect**
820
+ * dependency graph. A signal appears once at least one live effect
821
+ * depends on it, and disappears when the last one drops it or stops.
822
+ * Signals nobody observes, and the internal deps of a `computed` (which
823
+ * has no `stop()` handle, so registering it would outlive its usefulness
824
+ * and retain state), are deliberately not nodes; a `computed` read by an
825
+ * effect does appear, as a node of kind `'computed'`.
826
+ *
827
+ * @returns {SignalGraphSnapshot} Frozen snapshot; never a live handle.
828
+ */
829
+ function inspectGraph() {
830
+ return untrack(() => {
831
+ const signals = [];
832
+ const effects = [];
833
+ const edges = [];
834
+ const seen = new Set();
835
+ for (const rec of _liveEffects) {
836
+ effects.push(Object.freeze({ id: rec.id, deps: rec.deps.size }));
837
+ for (const sid of rec.deps) {
838
+ if (!seen.has(sid)) {
839
+ seen.add(sid);
840
+ signals.push(Object.freeze({
841
+ id: sid,
842
+ kind: sid[0] === 'c' ? 'computed' : 'signal',
843
+ }));
844
+ }
845
+ edges.push(Object.freeze({ effect: rec.id, signal: sid }));
846
+ }
847
+ }
848
+ return Object.freeze({
849
+ signals: Object.freeze(signals),
850
+ effects: Object.freeze(effects),
851
+ edges: Object.freeze(edges),
852
+ });
853
+ });
854
+ }
855
+
856
+ return { create, derived, batch, untrack, effect, resource, derivedAsync, computed, scheduleNotify, flushSync, inspectGraph };
857
+ },
858
+ };