@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,831 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview Low-level DOM utility API providing a safe, consistent interface
7
+ * for querying, mutating, and reading DOM elements.
8
+ *
9
+ * All mutating methods accept either a single `Element`, a `NodeList`, or an
10
+ * `Array` of elements as their first argument (`target`), and apply the
11
+ * operation to every node in the collection. Read-only methods always operate
12
+ * on a single `Element` and return `null` / `false` for invalid inputs rather
13
+ * than throwing.
14
+ *
15
+ */
16
+
17
+ import { secPolicy } from '../rendering/secPolicy.js';
18
+
19
+ /**
20
+ * Public API returned by `dom.factory()`.
21
+ *
22
+ * Mutating methods accept a single `HTMLElement`, a `NodeList`, or an array of
23
+ * elements as `target` and apply to every node. Read-only methods take a single
24
+ * `Element` and return `null` / `false` for invalid inputs.
25
+ *
26
+ * @typedef {object} DomAPI
27
+ * @property {(node: HTMLElement|SVGElement, selector: string) => (NodeList|never[])} queryAll All matching descendants, or an empty array on invalid input.
28
+ * @property {(node: HTMLElement|SVGElement, selector: string) => (Element|null)} query First matching descendant, or `null`.
29
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], name: string, value: string) => void} attr Set an attribute on the target(s).
30
+ * @property {(element: Element, name: string) => (string|null)} attrGet Get an attribute value, or `null`.
31
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], name: string) => void} attrRemove Remove an attribute from the target(s).
32
+ * @property {(element: Element, name: string) => boolean} attrHas Whether the element has the attribute.
33
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], key: string, value: string) => void} data Set a `data-*` attribute (camelCase key).
34
+ * @property {(element: Element, key: string) => (string|null)} dataGet Get a `data-*` value, or `null`.
35
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], key: string) => void} dataRemove Remove a `data-*` attribute.
36
+ * @property {(element: Element, key: string) => boolean} dataHas Whether the element has the `data-*` key.
37
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], name: string) => void} classAdd Add space-separated class name(s).
38
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], name: string) => void} classRemove Remove space-separated class name(s).
39
+ * @property {(element: Element, name: string) => boolean} classHas Whether the element has the class.
40
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], name: string) => void} classToggle Toggle a class on the target(s).
41
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], oldName: string, newName: string) => void} classReplace Replace one class with another.
42
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], prop: string, val: string) => void} style Set an inline CSS property.
43
+ * @property {(element: Element, prop: string) => (string|null)} styleGet Get a computed CSS property value, or `null`.
44
+ * @property {(element: Element) => (CSSStyleDeclaration|null)} styleGetAll Get the full computed style declaration, or `null`.
45
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], prop: string) => void} styleRemove Remove an inline CSS property.
46
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[]) => void} hide Hide the target(s) via inline `display:none`.
47
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], displayVal?: string) => void} show Show the target(s); optional explicit display value.
48
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[]) => void} toggleVisibility Toggle inline `display:none`.
49
+ * @property {(element: Element) => (DOMRect|null)} rect Bounding box relative to the viewport, or `null`.
50
+ * @property {(element: Element) => ({top: number, left: number}|null)} scrollPos Current scroll position, or `null`.
51
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], top: number|undefined, left: number|undefined) => void} scrollTo Set scroll position (undefined axis skipped).
52
+ * @property {(parent: Element, orderedChildren: Element[]) => void} reorder Reorder existing direct children of `parent` with minimal DOM moves.
53
+ * @property {(nodes: Iterable<Node>) => DocumentFragment} fragment Wrap nodes in a new `DocumentFragment`.
54
+ * @property {(name: string, element: HTMLInputElement, getter: () => *, setter: (v: *) => void, opts?: {event?: string, checked?: boolean}) => {refresh: () => void, destroy: () => void}} bind Two-way bind an input to a getter/setter pair.
55
+ * @property {(element: HTMLElement) => void} focus Move keyboard focus to the element.
56
+ * @property {(element: HTMLElement) => void} blur Remove keyboard focus from the element.
57
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], value: string|Array<{text: string, lang?: string, dir?: string}>) => void} text Set text content (string or multi-fragment array).
58
+ * @property {(element: Element) => (string|null)} textGet Get `textContent`, or `null`.
59
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], value: string) => void} val Set `value` on form element(s).
60
+ * @property {(element: Element) => (string|null)} valGet Get `value`, or `null`.
61
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], state: boolean) => void} checked Set `checked` on checkbox/radio input(s).
62
+ * @property {(element: Element) => (boolean|null)} checkedGet Get `checked`, or `null`.
63
+ * @property {(target: HTMLElement|NodeListOf<HTMLElement>|HTMLElement[], state: boolean) => void} disabled Set `disabled` on form element(s).
64
+ * @property {(element: Element) => (boolean|null)} disabledGet Get `disabled`, or `null`.
65
+ */
66
+
67
+ export const dom = {
68
+ name: 'dom',
69
+ type: 'fw.dom.query',
70
+ dependencies: ['secPolicy'],
71
+ deps: [secPolicy],
72
+
73
+ /** @returns {DomAPI} */
74
+ factory(secPolicy) {
75
+
76
+ // --- Internal helpers ---
77
+
78
+ // CSS safety primitives are centralised in `secPolicy` (single source
79
+ // of truth, also used by `template.applyAttributes` and `render.toHTML`
80
+ // for URL / clobber filtering). `secPolicy.isSafeCss` covers both the
81
+ // value-side checks (`expression(...)`, `url(javascript:...)`) and
82
+ // the property-name blocklist (`behavior`, `-ms-behavior`).
83
+ const styleApply = function(element, prop, val) {
84
+ if (!secPolicy.isSafeCss(prop, val)) return;
85
+ element.style.setProperty(prop, val);
86
+ };
87
+
88
+ /**
89
+ * Normalise a single `Element`, a `NodeList`, or an `Array` to a value
90
+ * that supports `length` and index access so iteration loops are uniform.
91
+ *
92
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Input to normalise.
93
+ * @returns {NodeListOf<HTMLElement> | HTMLElement[]} Iterable with numeric index access.
94
+ */
95
+ // Normalize Element, NodeList, or Array to an iterable with .length and index access.
96
+ const toNodes = function(target) {
97
+ // @ts-ignore - return target is NodeList|HTMLElement[]; TS can't narrow the union properly
98
+ if (Array.isArray(target) || target instanceof NodeList) return target;
99
+ // @ts-ignore - wrapping non-list target in array; TS union type too wide
100
+ return [target];
101
+ };
102
+
103
+ // --- API ---
104
+ const api = {
105
+
106
+ // ── Query ────────────────────────────────────────────────────────────
107
+
108
+ /**
109
+ * Return all descendants of `node` matching `selector`.
110
+ *
111
+ * @param {HTMLElement | SVGElement} node - Root element to search within.
112
+ * @param {string} selector - CSS selector string.
113
+ * @returns {NodeList | []} Matching elements, or an empty array when
114
+ * `node` is not an element or `selector` is not a string.
115
+ */
116
+ // All matching descendants → NodeList (empty if invalid)
117
+ queryAll(node, selector) {
118
+ if ((node instanceof HTMLElement || node instanceof SVGElement) && typeof selector === 'string') {
119
+ return node.querySelectorAll(selector);
120
+ }
121
+ return [];
122
+ },
123
+
124
+ /**
125
+ * Return the first descendant of `node` matching `selector`.
126
+ *
127
+ * @param {HTMLElement | SVGElement} node - Root element to search within.
128
+ * @param {string} selector - CSS selector string.
129
+ * @returns {Element | null} First matching element, or `null` when not
130
+ * found or when inputs are invalid.
131
+ */
132
+ // First matching descendant → Element | null
133
+ query(node, selector) {
134
+ if ((node instanceof HTMLElement || node instanceof SVGElement) && typeof selector === 'string') {
135
+ return node.querySelector(selector);
136
+ }
137
+ return null;
138
+ },
139
+
140
+ // ── Attributes ───────────────────────────────────────────────────────
141
+
142
+ /**
143
+ * Set an attribute to `value` on one or multiple elements.
144
+ *
145
+ * Note : `null`, `false`, and `undefined` are coerced to strings
146
+ * (e.g. `"null"`) by the underlying `setAttribute` - they do NOT
147
+ * remove the attribute. Use `attrRemove()` to actually remove.
148
+ *
149
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
150
+ * @param {string} name - Attribute name.
151
+ * @param {string} value - Attribute value.
152
+ */
153
+ // Set an attribute on one or multiple elements
154
+ attr(target, name, value) {
155
+ const nodes = toNodes(target);
156
+ for (let i = 0; i < nodes.length; i++) {
157
+ nodes[i].setAttribute(name, value);
158
+ }
159
+ },
160
+
161
+ /**
162
+ * Get an attribute value from a single element.
163
+ *
164
+ * @param {Element} element - Source element.
165
+ * @param {string} name - Attribute name.
166
+ * @returns {string | null} Attribute value, or `null` when the attribute
167
+ * is absent or the input is not an `Element`.
168
+ */
169
+ // Get an attribute value from a single element → string | null
170
+ attrGet(element, name) {
171
+ if (element instanceof Element) return element.getAttribute(name);
172
+ return null;
173
+ },
174
+
175
+ /**
176
+ * Remove an attribute from one or multiple elements.
177
+ *
178
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
179
+ * @param {string} name - Attribute name to remove.
180
+ */
181
+ // Remove an attribute from one or multiple elements
182
+ attrRemove(target, name) {
183
+ const nodes = toNodes(target);
184
+ for (let i = 0; i < nodes.length; i++) {
185
+ nodes[i].removeAttribute(name);
186
+ }
187
+ },
188
+
189
+ /**
190
+ * Check whether a single element has the given attribute.
191
+ *
192
+ * @param {Element} element - Element to check.
193
+ * @param {string} name - Attribute name.
194
+ * @returns {boolean} `true` when the attribute is present; `false` when
195
+ * absent or the input is not an `Element`.
196
+ */
197
+ // Does a single element have an attribute? → boolean
198
+ attrHas(element, name) {
199
+ if (element instanceof Element) return element.hasAttribute(name);
200
+ return false;
201
+ },
202
+
203
+ // ── Dataset (data-*) ─────────────────────────────────────────────────
204
+ // key is camelCase (e.g. 'myKey' ↔ data-my-key)
205
+
206
+ /**
207
+ * Set a `data-*` attribute on one or multiple elements.
208
+ * `key` must be provided in camelCase (e.g. `'myKey'` → `data-my-key`).
209
+ *
210
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
211
+ * @param {string} key - camelCase dataset key.
212
+ * @param {string} value - Value to assign.
213
+ */
214
+ // Set a data-* attribute on one or multiple elements
215
+ data(target, key, value) {
216
+ const nodes = toNodes(target);
217
+ for (let i = 0; i < nodes.length; i++) {
218
+ if ('dataset' in nodes[i]) nodes[i].dataset[key] = value;
219
+ }
220
+ },
221
+
222
+ /**
223
+ * Get a `data-*` value from a single element.
224
+ * `key` must be in camelCase.
225
+ *
226
+ * @param {Element} element - Source element.
227
+ * @param {string} key - camelCase dataset key.
228
+ * @returns {string | null} The dataset value, or `null` when absent or
229
+ * the element has no `dataset`.
230
+ */
231
+ // Get a data-* value from a single element → string | undefined
232
+ dataGet(element, key) {
233
+ if ('dataset' in element) return element.dataset[key] ?? null;
234
+ return null;
235
+ },
236
+
237
+ /**
238
+ * Remove a `data-*` attribute from one or multiple elements.
239
+ * `key` must be in camelCase.
240
+ *
241
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
242
+ * @param {string} key - camelCase dataset key to remove.
243
+ */
244
+ // Remove a data-* attribute from one or multiple elements
245
+ dataRemove(target, key) {
246
+ const nodes = toNodes(target);
247
+ for (let i = 0; i < nodes.length; i++) {
248
+ if ('dataset' in nodes[i]) delete nodes[i].dataset[key];
249
+ }
250
+ },
251
+
252
+ /**
253
+ * Check whether a single element has a `data-*` key.
254
+ * `key` must be in camelCase.
255
+ *
256
+ * @param {Element} element - Element to check.
257
+ * @param {string} key - camelCase dataset key.
258
+ * @returns {boolean} `true` when the key exists in the element's dataset.
259
+ */
260
+ // Does a single element have a data-* key? → boolean
261
+ dataHas(element, key) {
262
+ // @ts-ignore - element narrowed by "dataset" in element check at runtime
263
+ if ('dataset' in element) return key in element.dataset;
264
+ return false;
265
+ },
266
+
267
+ // ── Classes ──────────────────────────────────────────────────────────
268
+
269
+ /**
270
+ * Add one or more space-separated class names to one or multiple elements.
271
+ *
272
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
273
+ * @param {string} name - Space-separated class name(s) to add.
274
+ */
275
+ // Add one or more (space-separated) classes to one or multiple elements
276
+ classAdd(target, name) {
277
+ const names = name.trim().split(/\s+/);
278
+ const nodes = toNodes(target);
279
+ for (let i = 0; i < nodes.length; i++) {
280
+ nodes[i].classList.add(...names);
281
+ }
282
+ },
283
+
284
+ /**
285
+ * Remove one or more space-separated class names from one or multiple
286
+ * elements.
287
+ *
288
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
289
+ * @param {string} name - Space-separated class name(s) to remove.
290
+ */
291
+ // Remove one or more (space-separated) classes from one or multiple elements
292
+ classRemove(target, name) {
293
+ const names = name.trim().split(/\s+/);
294
+ const nodes = toNodes(target);
295
+ for (let i = 0; i < nodes.length; i++) {
296
+ nodes[i].classList.remove(...names);
297
+ }
298
+ },
299
+
300
+ /**
301
+ * Check whether a single element has a specific class.
302
+ *
303
+ * @param {Element} element - Element to check.
304
+ * @param {string} name - Class name to look for.
305
+ * @returns {boolean} `true` when the class is present; `false` when
306
+ * absent or the input is not an `Element`.
307
+ */
308
+ // Does a single element have a class? → boolean
309
+ classHas(element, name) {
310
+ if (element instanceof Element) return element.classList.contains(name);
311
+ return false;
312
+ },
313
+
314
+ /**
315
+ * Toggle a class on one or multiple elements (adds if absent, removes
316
+ * if present).
317
+ *
318
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
319
+ * @param {string} name - Class name to toggle.
320
+ */
321
+ // Toggle a class on one or multiple elements
322
+ classToggle(target, name) {
323
+ const nodes = toNodes(target);
324
+ for (let i = 0; i < nodes.length; i++) {
325
+ nodes[i].classList.toggle(name);
326
+ }
327
+ },
328
+
329
+ /**
330
+ * Replace `oldName` with `newName` on one or multiple elements.
331
+ * No-op per element when `oldName` is not present.
332
+ *
333
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
334
+ * @param {string} oldName - Class to replace.
335
+ * @param {string} newName - Replacement class.
336
+ */
337
+ // Replace a class with another on one or multiple elements
338
+ classReplace(target, oldName, newName) {
339
+ const nodes = toNodes(target);
340
+ for (let i = 0; i < nodes.length; i++) {
341
+ nodes[i].classList.replace(oldName, newName);
342
+ }
343
+ },
344
+
345
+ // ── Style ────────────────────────────────────────────────────────────
346
+
347
+ /**
348
+ * Set an inline CSS property on one or multiple elements via
349
+ * `style.setProperty`.
350
+ *
351
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
352
+ * @param {string} prop - CSS property name (supports custom properties).
353
+ * @param {string} val - Property value.
354
+ */
355
+ // Set an inline CSS property on one or multiple elements
356
+ style(target, prop, val) {
357
+ const nodes = toNodes(target);
358
+ for (let i = 0; i < nodes.length; i++) {
359
+ styleApply(nodes[i], prop, val);
360
+ }
361
+ },
362
+
363
+ /**
364
+ * Get the computed (resolved) value of a CSS property from a single
365
+ * element via `getComputedStyle`.
366
+ *
367
+ * @param {Element} element - Source element.
368
+ * @param {string} prop - CSS property name.
369
+ * @returns {string | null} Computed value string, or `null` when the
370
+ * input is not an `Element`.
371
+ */
372
+ // Get the computed (resolved) value of a CSS property from a single element → string
373
+ styleGet(element, prop) {
374
+ if (element instanceof Element) {
375
+ return getComputedStyle(element).getPropertyValue(prop);
376
+ }
377
+ return null;
378
+ },
379
+
380
+ /**
381
+ * Get the full computed style object of a single element.
382
+ *
383
+ * @param {Element} element - Source element.
384
+ * @returns {CSSStyleDeclaration | null} The computed style declaration,
385
+ * or `null` when the input is not an `Element`.
386
+ */
387
+ styleGetAll(element){
388
+ if (element instanceof Element) {
389
+ return getComputedStyle(element);
390
+ }
391
+ return null;
392
+ },
393
+
394
+ /**
395
+ * Remove an inline CSS property from one or multiple elements via
396
+ * `style.removeProperty`.
397
+ *
398
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
399
+ * @param {string} prop - CSS property name to remove.
400
+ */
401
+ // Remove an inline CSS property from one or multiple elements
402
+ styleRemove(target, prop) {
403
+ const nodes = toNodes(target);
404
+ for (let i = 0; i < nodes.length; i++) {
405
+ nodes[i].style.removeProperty(prop);
406
+ }
407
+ },
408
+
409
+ // ── Visibility ───────────────────────────────────────────────────────
410
+
411
+ /**
412
+ * Hide one or multiple elements by setting `display: none` as an inline
413
+ * style.
414
+ *
415
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s) to hide.
416
+ */
417
+ // Hide one or multiple elements via inline display:none
418
+ hide(target) {
419
+ const nodes = toNodes(target);
420
+ for (let i = 0; i < nodes.length; i++) {
421
+ styleApply(nodes[i], 'display', 'none');
422
+ }
423
+ },
424
+
425
+ /**
426
+ * Show one or multiple elements by removing the inline `display` property
427
+ * (letting the CSS cascade determine the display mode) or by setting it
428
+ * to a specific value when `displayVal` is provided.
429
+ *
430
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s) to show.
431
+ * @param {string} [displayVal] - Explicit display
432
+ * value to set (e.g. `'flex'`). When omitted the inline property is
433
+ * removed, restoring stylesheet-defined display.
434
+ */
435
+ // Show one or multiple elements - removes inline display (default '')
436
+ // letting CSS cascade take over; pass a display value to force a specific mode.
437
+ show(target, displayVal) {
438
+ const val = displayVal !== undefined ? displayVal : '';
439
+ const nodes = toNodes(target);
440
+ for (let i = 0; i < nodes.length; i++) {
441
+ if (val === '') {
442
+ nodes[i].style.removeProperty('display');
443
+ } else {
444
+ styleApply(nodes[i], 'display', val);
445
+ }
446
+ }
447
+ },
448
+
449
+ /**
450
+ * Toggle the `display: none` inline style on one or multiple elements.
451
+ * Operates solely on the inline style - does not read computed styles.
452
+ *
453
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s) to toggle.
454
+ */
455
+ // Toggle display:none on one or multiple elements (inline style only)
456
+ toggleVisibility(target) {
457
+ const nodes = toNodes(target);
458
+ for (let i = 0; i < nodes.length; i++) {
459
+ if (nodes[i].style.display === 'none') {
460
+ nodes[i].style.removeProperty('display');
461
+ } else {
462
+ styleApply(nodes[i], 'display', 'none');
463
+ }
464
+ }
465
+ },
466
+
467
+ // ── Geometry ─────────────────────────────────────────────────────────
468
+
469
+ /**
470
+ * Get the bounding box of a single element relative to the viewport.
471
+ *
472
+ * @param {Element} element - Source element.
473
+ * @returns {DOMRect | null} Bounding rectangle, or `null` when the input
474
+ * is not an `Element`.
475
+ */
476
+ // Bounding box relative to the viewport → DOMRect | null
477
+ rect(element) {
478
+ if (element instanceof Element) return element.getBoundingClientRect();
479
+ return null;
480
+ },
481
+
482
+ /**
483
+ * Get the current scroll position of a single element.
484
+ *
485
+ * @param {Element} element - Scrollable element.
486
+ * @returns {{ top: number, left: number } | null} Current scroll offsets,
487
+ * or `null` when the input is not an `Element`.
488
+ */
489
+ // Current scroll position of a single element → { top, left } | null
490
+ scrollPos(element) {
491
+ if (element instanceof Element) {
492
+ return { top: element.scrollTop, left: element.scrollLeft };
493
+ }
494
+ return null;
495
+ },
496
+
497
+ /**
498
+ * Set the scroll position on one or multiple elements using synchronous
499
+ * property assignment (not `scrollTo()`).
500
+ *
501
+ * Pass `undefined` for an axis to leave it unchanged.
502
+ *
503
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
504
+ * @param {number | undefined} top - New `scrollTop` value.
505
+ * @param {number | undefined} left - New `scrollLeft` value.
506
+ */
507
+ // Set scroll position on one or multiple elements (synchronous property assignment)
508
+ // top and left are optional - pass undefined to skip that axis
509
+ scrollTo(target, top, left) {
510
+ const nodes = toNodes(target);
511
+ for (let i = 0; i < nodes.length; i++) {
512
+ if (top !== undefined) nodes[i].scrollTop = top;
513
+ if (left !== undefined) nodes[i].scrollLeft = left;
514
+ }
515
+ },
516
+
517
+ // ── Children reorder ─────────────────────────────────────────────────
518
+
519
+ /**
520
+ * Reorder the direct children of `parent` to match the sequence of
521
+ * `orderedChildren` via a **minimal-move** cursor walk: a child that is
522
+ * already in its target position is left completely untouched (no
523
+ * `insertBefore`/`moveBefore` call at all). An already-ordered list
524
+ * therefore costs zero DOM operations, and a node that doesn't need to
525
+ * move - including one holding keyboard focus or a text selection -
526
+ * is never detached, so focus/selection/scroll/CSS-transition state
527
+ * survives the reorder.
528
+ *
529
+ * Uses `Element.moveBefore` when the browser supports it (state-preserving
530
+ * move - no disconnect/reconnect step for the moved node either); falls
531
+ * back to `insertBefore` otherwise. Both are only invoked for nodes that
532
+ * actually need to move.
533
+ *
534
+ * Only nodes that are **already direct children** of `parent` are moved;
535
+ * no new nodes are inserted and no existing nodes are removed.
536
+ *
537
+ * @param {Element} parent - Container whose children to reorder.
538
+ * @param {Element[]} orderedChildren - Desired child order.
539
+ */
540
+ // Reorder existing direct children of parent to match orderedChildren, with
541
+ // minimal DOM moves (cursor walk) - no tree change, no-op for non-Element parent.
542
+ reorder(parent, orderedChildren) {
543
+ if (!(parent instanceof Element)) return;
544
+ // moveBefore (state-preserving move) is newly standardised and absent
545
+ // from the TS DOM lib - cast locally rather than widen the signature.
546
+ const mover = /** @type {Element & { moveBefore?: (node: Node, ref: Node|null) => void }} */ (parent);
547
+ const move = typeof mover.moveBefore === 'function'
548
+ ? (child, ref) => mover.moveBefore(child, ref)
549
+ : (child, ref) => parent.insertBefore(child, ref);
550
+
551
+ let cursor = parent.firstChild;
552
+ for (let i = 0; i < orderedChildren.length; i++) {
553
+ const child = orderedChildren[i];
554
+ if (!(child instanceof Element) || child.parentNode !== parent) continue;
555
+ if (child === cursor) {
556
+ cursor = cursor.nextSibling;
557
+ continue;
558
+ }
559
+ move(child, cursor);
560
+ }
561
+ },
562
+
563
+ /**
564
+ * Wrap an iterable of nodes in a detached `DocumentFragment`. Useful
565
+ * for composing a sub-tree off-screen before a single batched insertion.
566
+ *
567
+ * @param {Iterable<Node>} nodes - Sequence of DOM nodes (Elements,
568
+ * text nodes, comments, …). Non-Node items are silently skipped.
569
+ * @returns {DocumentFragment} A new fragment containing the nodes.
570
+ */
571
+ fragment(nodes) {
572
+ const frag = document.createDocumentFragment();
573
+ if (nodes && typeof nodes[Symbol.iterator] === 'function') {
574
+ for (const n of nodes) {
575
+ if (n instanceof Node) frag.appendChild(n);
576
+ }
577
+ }
578
+ return frag;
579
+ },
580
+
581
+ /**
582
+ * Two-way bind a DOM input to a getter/setter pair. Returns a handle
583
+ * `{ refresh, destroy }` that re-syncs the element from the getter
584
+ * or detaches the listener. Idempotent destroy.
585
+ *
586
+ * Low-level primitive used by `form.create(...)` and friends. For a
587
+ * full form state machine (touched/dirty/errors), use `form` directly.
588
+ *
589
+ * @param {string} name - Listener name (cf. cmd.on registry).
590
+ * The implementation uses a stable name derived from this so that
591
+ * the handle's `destroy()` can detach via `eventTarget.removeEventListener`.
592
+ * @param {HTMLInputElement} element - input/select/textarea element.
593
+ * @param {()=>*} getter - Initial value source ; also used by refresh().
594
+ * @param {(v:*)=>void} setter - Called on each input event.
595
+ * @param {Object} [opts]
596
+ * @param {string} [opts.event='input'] - DOM event source. Default
597
+ * `'input'` suits text inputs ; for checkboxes pass
598
+ * `{ event: 'change', checked: true }`.
599
+ * @param {boolean} [opts.checked=false] - Sync `.checked` instead of `.value`.
600
+ * @returns {{refresh: ()=>void, destroy: ()=>void}}
601
+ */
602
+ bind(name, element, getter, setter, opts) {
603
+ if (!(element instanceof Element)) {
604
+ throw new Error('dom.bind: element must be an Element');
605
+ }
606
+ if (typeof getter !== 'function' || typeof setter !== 'function') {
607
+ throw new Error('dom.bind: getter and setter must be functions');
608
+ }
609
+ const ev = (opts && opts.event) || 'input';
610
+ const checked = !!(opts && opts.checked);
611
+ const apply = checked
612
+ ? () => { const v = getter(); element.checked = !!v; }
613
+ : () => { const v = getter(); element.value = v == null ? '' : String(v); };
614
+ apply();
615
+ const handler = () => {
616
+ setter(checked ? element.checked : element.value);
617
+ };
618
+ element.addEventListener(ev, handler);
619
+ let destroyed = false;
620
+ return {
621
+ refresh: apply,
622
+ destroy() {
623
+ if (destroyed) return;
624
+ destroyed = true;
625
+ element.removeEventListener(ev, handler);
626
+ },
627
+ };
628
+ },
629
+
630
+ // ── Focus ────────────────────────────────────────────────────────────
631
+
632
+ /**
633
+ * Move keyboard focus to the element.
634
+ *
635
+ * @param {HTMLElement} element - Element to focus.
636
+ */
637
+ focus(element) {
638
+ if (element instanceof Element) element.focus();
639
+ },
640
+
641
+ /**
642
+ * Remove keyboard focus from the element.
643
+ *
644
+ * @param {HTMLElement} element - Element to blur.
645
+ */
646
+ blur(element) {
647
+ if (element instanceof Element) element.blur();
648
+ },
649
+
650
+ // ── Text content ─────────────────────────────────────────────────────
651
+
652
+ /**
653
+ * Set the text content on one or multiple elements.
654
+ *
655
+ * Two forms :
656
+ *
657
+ * `text(node, 'hello world')` → simple string
658
+ * `text(node, [{text:'Bonjour ',lang:'fr'}, {text:'Hi',lang:'en'}])`
659
+ * → multi-fragment
660
+ *
661
+ * **Multi-fragment mode** : pass an array of `{ text, lang? }`
662
+ * descriptors. Each fragment becomes either a bare text node
663
+ * (when `lang` is absent) or a `<span lang="…">` wrapping the
664
+ * text. Useful for multilingual / accessibility-aware content
665
+ * without resorting to HTML strings.
666
+ *
667
+ * The element's existing content is replaced atomically - the
668
+ * single-string form keeps its O(1) behaviour, the array form
669
+ * builds the new children then replaces in one shot.
670
+ *
671
+ * **Security** : every value is set via `textContent` /
672
+ * `setAttribute`. No HTML parsing, no script execution surface.
673
+ *
674
+ * Note : when `part.lang` is present but `part.text` is null or
675
+ * undefined, a `<span lang="…">` with empty text content is still
676
+ * created - intentional, useful for screen-reader language context.
677
+ *
678
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
679
+ * @param {string | Array<{text:string, lang?:string, dir?:string}>} value
680
+ */
681
+ text(target, value) {
682
+ const nodes = toNodes(target);
683
+
684
+ if (Array.isArray(value)) {
685
+ // Multi-fragment mode. Build the new children once,
686
+ // then clone them per target (cheap : small DOM,
687
+ // structural cloneNode preserves attributes).
688
+ const buildFragments = (doc) => {
689
+ const frag = doc.createDocumentFragment();
690
+ for (const part of value) {
691
+ if (part == null) continue;
692
+ const t = String(part.text == null ? '' : part.text);
693
+ if (part.lang) {
694
+ const span = doc.createElement('span');
695
+ span.setAttribute('lang', String(part.lang));
696
+ if (part.dir) span.setAttribute('dir', String(part.dir));
697
+ span.textContent = t;
698
+ frag.appendChild(span);
699
+ } else {
700
+ frag.appendChild(doc.createTextNode(t));
701
+ }
702
+ }
703
+ return frag;
704
+ };
705
+
706
+ for (let i = 0; i < nodes.length; i++) {
707
+ const n = nodes[i];
708
+ if (!(n instanceof Element)) continue;
709
+ // Wipe in one go, then append fresh fragments.
710
+ n.textContent = '';
711
+ n.appendChild(buildFragments(n.ownerDocument || document));
712
+ }
713
+ return;
714
+ }
715
+
716
+ // Single-string fast path.
717
+ const str = value == null ? '' : String(value);
718
+ for (let i = 0; i < nodes.length; i++) {
719
+ if (nodes[i] instanceof Node) nodes[i].textContent = str;
720
+ }
721
+ },
722
+
723
+ /**
724
+ * Get the `textContent` of a single element.
725
+ *
726
+ * @param {Element} element - Source element.
727
+ * @returns {string | null} Current text content, or `null` when the
728
+ * element is not a `Node`.
729
+ */
730
+ // Get textContent from a single element → string | null
731
+ textGet(element) {
732
+ if (element instanceof Node) return element.textContent;
733
+ return null;
734
+ },
735
+
736
+ // ── Form values ──────────────────────────────────────────────────────
737
+
738
+ /**
739
+ * Set the `value` property on one or multiple form elements
740
+ * (`input`, `select`, `textarea`, etc.).
741
+ *
742
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
743
+ * @param {string} value - Value to assign.
744
+ */
745
+ // Set value on one or multiple input/select/textarea elements
746
+ val(target, value) {
747
+ const nodes = toNodes(target);
748
+ for (let i = 0; i < nodes.length; i++) {
749
+ // @ts-ignore - 'value' guard ensures the property exists; HTMLElement lacks it in TS types
750
+ if ('value' in nodes[i]) nodes[i].value = value;
751
+ }
752
+ },
753
+
754
+ /**
755
+ * Get the `value` property of a single form element.
756
+ *
757
+ * @param {Element} element - Source form element.
758
+ * @returns {string | null} Current value, or `null` when the element
759
+ * does not have a `value` property or is not an `Element`.
760
+ */
761
+ // Get value from a single input/select/textarea → string | null
762
+ valGet(element) {
763
+ // @ts-ignore - 'value' guard ensures property exists; Element lacks it in TS types
764
+ if (element instanceof Element && 'value' in element) return /** @type {string} */ (element.value);
765
+ return null;
766
+ },
767
+
768
+ /**
769
+ * Set the `checked` state on one or multiple checkbox or radio inputs.
770
+ * The `state` value is coerced to boolean.
771
+ *
772
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
773
+ * @param {boolean} state - Desired checked state.
774
+ */
775
+ // Set checked state on one or multiple checkbox/radio inputs
776
+ checked(target, state) {
777
+ const nodes = toNodes(target);
778
+ for (let i = 0; i < nodes.length; i++) {
779
+ // @ts-ignore - 'checked' guard ensures the property exists; HTMLElement lacks it in TS types
780
+ if ('checked' in nodes[i]) nodes[i].checked = !!state;
781
+ }
782
+ },
783
+
784
+ /**
785
+ * Get the `checked` state of a single checkbox or radio input.
786
+ *
787
+ * @param {Element} element - Source input element.
788
+ * @returns {boolean | null} Checked state, or `null` when the element
789
+ * does not have a `checked` property or is not an `Element`.
790
+ */
791
+ // Get checked state from a single input → boolean | null
792
+ checkedGet(element) {
793
+ // @ts-ignore - 'checked' guard ensures property exists; Element lacks it in TS types
794
+ if (element instanceof Element && 'checked' in element) return /** @type {boolean} */ (element.checked);
795
+ return null;
796
+ },
797
+
798
+ /**
799
+ * Set the `disabled` state on one or multiple form elements.
800
+ * The `state` value is coerced to boolean.
801
+ *
802
+ * @param {HTMLElement | NodeListOf<HTMLElement> | HTMLElement[]} target - Target(s).
803
+ * @param {boolean} state - Desired disabled state.
804
+ */
805
+ // Set disabled state on one or multiple form elements
806
+ disabled(target, state) {
807
+ const nodes = toNodes(target);
808
+ for (let i = 0; i < nodes.length; i++) {
809
+ // @ts-ignore - 'disabled' guard ensures the property exists; HTMLElement lacks it in TS types
810
+ if ('disabled' in nodes[i]) nodes[i].disabled = !!state;
811
+ }
812
+ },
813
+
814
+ /**
815
+ * Get the `disabled` state of a single form element.
816
+ *
817
+ * @param {Element} element - Source form element.
818
+ * @returns {boolean | null} Disabled state, or `null` when the element
819
+ * does not have a `disabled` property or is not an `Element`.
820
+ */
821
+ // Get disabled state from a single element → boolean | null
822
+ disabledGet(element) {
823
+ // @ts-ignore - 'disabled' guard ensures property exists; Element lacks it in TS types
824
+ if (element instanceof Element && 'disabled' in element) return /** @type {boolean} */ (element.disabled);
825
+ return null;
826
+ }
827
+ };
828
+
829
+ return api;
830
+ }
831
+ };