@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,1055 @@
1
+ // Copyright (c) 2026 AwaCloud SAS
2
+ // Author: Matthieu Bouilloux
3
+ // SPDX-License-Identifier: Apache-2.0
4
+
5
+ /**
6
+ * @fileoverview HTML ↔ elm-array parser for the framework's virtual-DOM notation.
7
+ *
8
+ * Notation (see source/index.js MEMO):
9
+ * - `#{var_name}` - variable placeholder (text or attribute value)
10
+ * - `${slot_name}` - content slot (full text of a leaf element)
11
+ * - `<!-- $name --> … <!-- name$ -->` - iterate block delimited by HTML comments
12
+ *
13
+ * Rules:
14
+ * - A content slot becomes a `<span>` when it has sibling nodes, otherwise it
15
+ * is inlined as `elm.content` on the parent element.
16
+ * - An iterate block must not be used alongside sibling element nodes.
17
+ *
18
+ */
19
+
20
+ /**
21
+ * A variable-binding descriptor that maps a named placeholder to a rendered target.
22
+ *
23
+ * @typedef {Object} MapEntry
24
+ * @property {string} name - Placeholder variable name (from `#{name}`).
25
+ * @property {string} prop - Target property: an attribute name, or `'text'`.
26
+ * @property {boolean} [data] - `true` when the target is `elm.data[prop]` (attribute);
27
+ * omitted / `false` for text content.
28
+ * @property {boolean} [append] - Value is appended after the static base string.
29
+ * @property {boolean} [prepend] - Value is prepended before the static base string.
30
+ * @property {string} [tail] - Static run that immediately follows this variable in
31
+ * the source value. Appended after the resolved value so
32
+ * that interleaved static segments (e.g. the trailing run
33
+ * of `"prefix#{v}suffix"`, or the `"b"` in
34
+ * `"a#{v1}b#{v2}c"`) are preserved. Present only when a
35
+ * non-empty trailing run exists.
36
+ * @property {*} [default] - Fallback value when the variable is absent from the
37
+ * options passed to `render`.
38
+ */
39
+
40
+ /**
41
+ * A single node in the flat elm-array representation.
42
+ * Elements are stored in parent-before-child order.
43
+ *
44
+ * @typedef {Object} ElmNode
45
+ * @property {string} id - Element identifier, unique within the parsed
46
+ * document (preserves the HTML `id` attribute
47
+ * when present, otherwise auto-generated as
48
+ * `p<n>`, skipping any `p<n>` already used as
49
+ * an explicit id in the same document).
50
+ * @property {string} tag - Internal tag name.
51
+ * SVG child elements are prefixed: `svg_use`,
52
+ * `svg_rect`, … The synthetic `'text'` tag
53
+ * represents an inline bare-text node.
54
+ * @property {string} [parent] - `id` of the parent node (absent for roots).
55
+ * @property {string[]} [attrs] - Ordered list of tracked attribute names.
56
+ * @property {Object.<string,*>}[data] - Attribute values, keyed by attr name (may be string, boolean, null, etc).
57
+ * @property {string} [text] - Static text content (leaf nodes only).
58
+ * @property {string} [content]- Slot or iterate-block name.
59
+ * @property {ElmNode[]} [child] - Inline child nodes (runtime extension for nested elms).
60
+ * @property {boolean} [prepend]- When true, insert before existing children.
61
+ * @property {MapEntry[]} [map] - Variable binding descriptors.
62
+ */
63
+
64
+ /**
65
+ * Result returned by `fromHTML`.
66
+ *
67
+ * @typedef {Object} ParseResult
68
+ * @property {ElmNode[]} template - Flat, parent-ordered array of
69
+ * elm nodes for the main markup.
70
+ * @property {Object.<string, ElmNode[]>} [iterates]- Sub-templates for iterate blocks,
71
+ * keyed by block name. Present only
72
+ * when at least one iterate block was
73
+ * found in the HTML.
74
+ */
75
+
76
+ /**
77
+ * Internal tree structure built by `buildTree` for serialisation.
78
+ *
79
+ * @typedef {Object} ElmTree
80
+ * @property {Map<string, ElmNode>} byId - Nodes indexed by id.
81
+ * @property {Map<string, string[]>} kids - Children id arrays indexed by parent id.
82
+ * @property {string[]} roots - Ids of root-level nodes (no parent).
83
+ */
84
+
85
+ /**
86
+ * Manual cache controls exposed on the parser surface (test / power-user).
87
+ *
88
+ * @typedef {Object} ParserCache
89
+ * @property {() => void} clear - Clear all cached entries and reset stats.
90
+ * @property {(n: number) => void} setMax - Set the max cache size; 0 disables caching.
91
+ * @property {() => number} getMax - Current max cache size.
92
+ * @property {() => number} size - Current number of cached entries.
93
+ * @property {() => { hits: number, misses: number, evictions: number, size: number, max: number }} stats - Cache statistics snapshot.
94
+ */
95
+
96
+ /**
97
+ * Optional input of `fromHTML`.
98
+ *
99
+ * @typedef {Object} FromHTMLOptions
100
+ * @property {Iterable<string>} [reserveIds] - Explicit ids the caller knows the
101
+ * assembled document will contain, declared UP FRONT. They are reserved for
102
+ * the whole parser instance (this call and every later one), so an auto
103
+ * `p<n>` never collides with an explicit id the instance has not met yet —
104
+ * the direction per-call and per-instance accumulation cannot cover. Empty
105
+ * and non-string entries are ignored. Supplying the option BYPASSES the
106
+ * source-keyed `ParseResult` cache (read and write): the reservation changes
107
+ * which ids are minted, so a cached entry would violate the contract.
108
+ */
109
+
110
+ /**
111
+ * Public surface returned by `parser.factory()`.
112
+ *
113
+ * @typedef {Object} ParserAPI
114
+ * @property {(htmlString: string, options?: FromHTMLOptions) => ParseResult} fromHTML - Parse HTML to a (cached) {@link ParseResult}.
115
+ * @property {(input: ElmNode[]|ParseResult) => string} toHTML - Serialise an elm array / ParseResult back to HTML.
116
+ * @property {ParserCache} cache - Manual cache controls.
117
+ */
118
+
119
+ import { secPolicy } from './secPolicy.js';
120
+
121
+ export const parser = {
122
+ name: 'parser',
123
+ version: '1.0.0',
124
+ type: 'fw.dom.rendering',
125
+ dependencies: ['secPolicy'],
126
+ deps: [secPolicy],
127
+
128
+ /** @returns {ParserAPI} */
129
+ factory(secPolicy) {
130
+
131
+ // ── Server-side HTML tokenizer (DOMParser fallback) ──────────────────────
132
+ // Used by `fromHTML` when no `DOMParser` is available (Node/Bun without
133
+ // happy-dom). Produces a tree of plain JS objects exposing the subset
134
+ // of the DOM `Node` interface required by `walkElement` :
135
+ // { nodeType, tagName, attributes, childNodes, nodeValue, namespaceURI }
136
+ // - plus `getAttribute(name)` on element nodes.
137
+ //
138
+ // The tokenizer is **forgiving but minimal**. It handles well-formed
139
+ // HTML5-ish input :
140
+ // <tag>, <tag/>, </tag>, <tag a="v">, <tag a='v'>, <tag a>, <!-- … -->
141
+ // void elements (br/img/…), text with #{var} and ${slot} preserved,
142
+ // basic entities (&amp; &lt; &gt; &quot; &apos; numeric).
143
+ // It deliberately ignores DOCTYPE, CDATA, and processing instructions.
144
+ // For complex/broken HTML, a browser DOMParser polyfill (happy-dom,
145
+ // linkedom) remains a valid drop-in.
146
+
147
+ const SVG_TAG = 'svg';
148
+
149
+ const ENTITY_MAP = {
150
+ amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ',
151
+ };
152
+
153
+ function _decodeEntities(s) {
154
+ if (s.indexOf('&') === -1) return s;
155
+ return s.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z]+);/g, (m, body) => {
156
+ if (body[0] === '#') {
157
+ const cp = body[1] === 'x' || body[1] === 'X'
158
+ ? parseInt(body.slice(2), 16)
159
+ : parseInt(body.slice(1), 10);
160
+ if (Number.isFinite(cp) && cp >= 0 && cp <= 0x10FFFF) {
161
+ try { return String.fromCodePoint(cp); }
162
+ catch { return m; }
163
+ }
164
+ return m;
165
+ }
166
+ return ENTITY_MAP[body.toLowerCase()] ?? m;
167
+ });
168
+ }
169
+
170
+ function _makeElement(tagName, namespaceURI) {
171
+ const el = {
172
+ nodeType: NODE_ELEMENT,
173
+ tagName: tagName.toUpperCase(), // browsers report uppercase
174
+ namespaceURI: namespaceURI || null,
175
+ attributes: [],
176
+ childNodes: [],
177
+ _attrMap: null,
178
+ getAttribute(name) {
179
+ if (!this._attrMap) {
180
+ this._attrMap = Object.create(null);
181
+ for (const a of this.attributes) this._attrMap[a.name] = a.value;
182
+ }
183
+ return this._attrMap[name] ?? null;
184
+ },
185
+ };
186
+ return el;
187
+ }
188
+ function _makeText(value) { return { nodeType: NODE_TEXT, nodeValue: value }; }
189
+ function _makeComment(value) { return { nodeType: NODE_COMMENT, nodeValue: value }; }
190
+
191
+ // Parse an opening tag starting at `pos` (which points to '<').
192
+ // Returns { tag, attrs:[{name,value}], selfClose, end } where `end`
193
+ // is the index just past the closing '>'.
194
+ function _parseOpenTag(html, pos) {
195
+ const len = html.length;
196
+ // Expect '<' at pos already verified by caller.
197
+ let i = pos + 1;
198
+ // Tag name
199
+ const tagStart = i;
200
+ while (i < len) {
201
+ const c = html.charCodeAt(i);
202
+ // Letters, digits, '-', '_'
203
+ if ((c >= 0x30 && c <= 0x39) || (c >= 0x41 && c <= 0x5a)
204
+ || (c >= 0x61 && c <= 0x7a) || c === 0x2d || c === 0x5f) {
205
+ i++;
206
+ } else break;
207
+ }
208
+ if (i === tagStart) return null;
209
+ const tag = html.slice(tagStart, i).toLowerCase();
210
+
211
+ const attrs = [];
212
+ let selfClose = false;
213
+
214
+ while (i < len) {
215
+ // Skip whitespace.
216
+ while (i < len && /\s/.test(html[i])) i++;
217
+ if (i >= len) return null;
218
+ const c = html[i];
219
+ if (c === '>') { i++; break; }
220
+ if (c === '/' && html[i + 1] === '>') { selfClose = true; i += 2; break; }
221
+ // Attribute name.
222
+ const nStart = i;
223
+ while (i < len && !/[\s=/>]/.test(html[i])) i++;
224
+ const name = html.slice(nStart, i).toLowerCase();
225
+ if (!name) { i++; continue; }
226
+ // Optional value.
227
+ while (i < len && /\s/.test(html[i])) i++;
228
+ let value = '';
229
+ if (html[i] === '=') {
230
+ i++;
231
+ while (i < len && /\s/.test(html[i])) i++;
232
+ const q = html[i];
233
+ if (q === '"' || q === "'") {
234
+ const vStart = ++i;
235
+ while (i < len && html[i] !== q) i++;
236
+ value = _decodeEntities(html.slice(vStart, i));
237
+ if (html[i] === q) i++;
238
+ } else {
239
+ const vStart = i;
240
+ while (i < len && !/[\s>]/.test(html[i])) i++;
241
+ value = _decodeEntities(html.slice(vStart, i));
242
+ }
243
+ }
244
+ attrs.push({ name, value });
245
+ }
246
+ return { tag, attrs, selfClose, end: i };
247
+ }
248
+
249
+ // ── Constants ────────────────────────────────────────────────────────────
250
+
251
+ const SVG_NS = 'http://www.w3.org/2000/svg';
252
+
253
+ const VOID_TAGS = new Set([
254
+ 'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',
255
+ 'link', 'meta', 'param', 'source', 'track', 'wbr'
256
+ ]);
257
+
258
+ // DOM Node type constants - duplicated locally so `walkElement` runs
259
+ // identically against either a real DOM tree (browser, happy-dom) or
260
+ // the server-side tokenizer tree built below. Avoids reference to the
261
+ // global `Node` interface which is browser-only.
262
+ const NODE_ELEMENT = 1;
263
+ const NODE_TEXT = 3;
264
+ const NODE_COMMENT = 8;
265
+
266
+ // Explicit internal-tag → HTML-tag overrides
267
+ // Generic rule: svg_* → strip prefix (svg_use→use, svg_rect→rect, …)
268
+ // Exception: tag:'text' is a synthetic inline-text wrapper (→ bare text in toHTML,
269
+ // but rendered as <span> by template.js via its own tag === 'text' guard)
270
+ const INTERNAL_TO_HTML = { text: 'span' };
271
+
272
+ // Tags silently dropped during parsing - sourced from secPolicy
273
+ // (single source of truth for blocked tags across the framework).
274
+ const RE_BLOCKED_TAG = secPolicy.BLOCKED_TAGS_RE;
275
+
276
+ // ── Regex patterns ───────────────────────────────────────────────────────
277
+
278
+ const RE_SLOT = /^\s*\$\{([^}]+)\}\s*$/; // ${slot_name} – full text
279
+ const RE_VAR_SEP = /(#\{[^}]+\})/; // split token for #{var}
280
+ const RE_VAR_ONE = /^#\{([^}]+)\}$/; // single #{var} token
281
+ const RE_IT_S = /^\s*\$([a-zA-Z_]\w*)\s*$/; // comment: $name
282
+ const RE_IT_E = /^\s*([a-zA-Z_]\w*)\$\s*$/; // comment: name$
283
+ // Attribute-name shape regexes - sourced from secPolicy.
284
+ const RE_SAFE_A = secPolicy.SAFE_ATTR_NAME_RE; // attr must start with a letter
285
+ const RE_EVENT = secPolicy.EVENT_ATTR_RE; // block on* event attributes
286
+
287
+ function parseHTMLString(html) {
288
+ const root = _makeElement('root');
289
+ const stack = [{ el: root, ns: null }];
290
+ let pos = 0;
291
+ const len = html.length;
292
+
293
+ while (pos < len) {
294
+ const top = stack[stack.length - 1];
295
+ const ch = html[pos];
296
+
297
+ if (ch === '<') {
298
+ // Comment ?
299
+ if (html.startsWith('<!--', pos)) {
300
+ const end = html.indexOf('-->', pos + 4);
301
+ if (end === -1) break;
302
+ top.el.childNodes.push(_makeComment(html.slice(pos + 4, end)));
303
+ pos = end + 3;
304
+ continue;
305
+ }
306
+ // DOCTYPE / processing-instruction : skip.
307
+ if (html.charCodeAt(pos + 1) === 0x21 /* ! */
308
+ || html.charCodeAt(pos + 1) === 0x3f /* ? */) {
309
+ const end = html.indexOf('>', pos);
310
+ if (end === -1) break;
311
+ pos = end + 1;
312
+ continue;
313
+ }
314
+ // Closing tag ?
315
+ if (html[pos + 1] === '/') {
316
+ const end = html.indexOf('>', pos);
317
+ if (end === -1) break;
318
+ const closeName = html.slice(pos + 2, end).trim().toLowerCase();
319
+ // Pop the stack until we find a matching tag (forgiving).
320
+ for (let i = stack.length - 1; i > 0; --i) {
321
+ if (stack[i].el.tagName.toLowerCase() === closeName) {
322
+ stack.length = i;
323
+ break;
324
+ }
325
+ }
326
+ pos = end + 1;
327
+ continue;
328
+ }
329
+ // Opening tag.
330
+ const open = _parseOpenTag(html, pos);
331
+ if (!open) { pos++; continue; }
332
+ // SVG namespace propagation : inside <svg>, all descendants are SVG.
333
+ const parentNS = top.ns;
334
+ const ns = (open.tag === SVG_TAG) ? SVG_NS : parentNS;
335
+ const el = _makeElement(open.tag, ns);
336
+ for (const a of open.attrs) el.attributes.push(a);
337
+ top.el.childNodes.push(el);
338
+ const isVoid = VOID_TAGS.has(open.tag) || open.selfClose;
339
+ if (!isVoid) stack.push({ el, ns });
340
+ pos = open.end;
341
+ continue;
342
+ }
343
+
344
+ // Text node : up to the next '<'.
345
+ const next = html.indexOf('<', pos);
346
+ const textEnd = next === -1 ? len : next;
347
+ const raw = html.slice(pos, textEnd);
348
+ if (raw) top.el.childNodes.push(_makeText(_decodeEntities(raw)));
349
+ pos = textEnd;
350
+ }
351
+ return root;
352
+ }
353
+
354
+ // ── Notation (see source/index.js MEMO) ──────────────────────────────────
355
+ // #{var_name} → variable placeholder (text / attr)
356
+ // ${slot_name} → content slot (full text of a leaf)
357
+ // <!-- $name --> … <!-- name$ --> → iterate block (comment delimiters)
358
+
359
+ // "content slot" becomes span tag if he has neighbors
360
+ // else become part of parent tag
361
+ // "iterate block" must not be used with neighbor tag
362
+
363
+ // ── ID generator ─────────────────────────────────────────────────────────
364
+
365
+ let _seq = 0;
366
+
367
+ /**
368
+ * Explicit ids reserved for the WHOLE parser instance: every explicit id
369
+ * seen by a previous `fromHTML` call, plus every id a caller declared up
370
+ * front via {@link FromHTMLOptions}`.reserveIds`.
371
+ *
372
+ * A consumer may assemble ONE logical document from SEVERAL `fromHTML`
373
+ * calls on a shared instance (parsing each block separately). The
374
+ * per-call set alone gives no guarantee across that seam, and the harm
375
+ * is the same as within a call: `buildTree` merges by id with
376
+ * last-write-wins, so a cross-call collision DELETES a subtree from the
377
+ * assembled output.
378
+ *
379
+ * @type {Set<string>}
380
+ */
381
+ const _reservedAll = new Set();
382
+
383
+ /**
384
+ * Fold an iterable of explicit ids into the instance-wide reserved set.
385
+ *
386
+ * Empty, whitespace-only and non-string entries are ignored (the same
387
+ * shape filter `collectExplicitIds` applies to `id` attributes).
388
+ *
389
+ * @param {Iterable<string>} [ids] - Ids to reserve; nullish is a no-op.
390
+ * @param {Set<string>} [into] - Optional per-call set to mirror into.
391
+ * @returns {void}
392
+ */
393
+ function reserveInstanceIds(ids, into) {
394
+ if (!ids) return;
395
+ for (const raw of ids) {
396
+ if (typeof raw !== 'string') continue;
397
+ const id = raw.trim();
398
+ if (!id) continue;
399
+ _reservedAll.add(id);
400
+ if (into) into.add(id);
401
+ }
402
+ }
403
+
404
+ /**
405
+ * Generate a unique element ID of the form `p<n>`.
406
+ *
407
+ * The counter is scoped to the parser INSTANCE and keeps running across
408
+ * `fromHTML` calls (a site build shares one parser across every
409
+ * document, and the emitted ids are part of the hydrate-key surface —
410
+ * it must not restart per document).
411
+ *
412
+ * A value already used as an explicit `id` is skipped: `buildTree`
413
+ * indexes nodes by id with last-write-wins, so a collision between an
414
+ * auto-minted `pN` and an explicit `pN` silently drops one of the two
415
+ * nodes from the emitted HTML. Two reservation layers are consulted:
416
+ * `reserved` — every explicit id of the current document, collected up
417
+ * front by `collectExplicitIds` so ids appearing AFTER the mint point
418
+ * count too — and `_reservedAll`, the instance-wide set (earlier calls'
419
+ * explicit ids + any caller-supplied `reserveIds`).
420
+ *
421
+ * @param {Set<string>} [reserved] - Explicit ids of the document being
422
+ * parsed. Omitted / empty means "no document context".
423
+ * @returns {string} Next sequential ID string, unused in this document
424
+ * and unused anywhere this instance has reserved.
425
+ */
426
+ const nextId = (reserved) => {
427
+ let id = 'p' + (_seq++);
428
+ while ((reserved && reserved.has(id)) || _reservedAll.has(id)) {
429
+ id = 'p' + (_seq++);
430
+ }
431
+ return id;
432
+ };
433
+
434
+ /**
435
+ * Collect every explicit `id` attribute of a parsed tree.
436
+ *
437
+ * Walks the whole node tree (DOM tree or internal-tokenizer tree alike)
438
+ * so that `nextId` knows the document's full id set before the first
439
+ * auto id is minted.
440
+ *
441
+ * @param {Node|Object} node - Root node to scan (inclusive of children).
442
+ * @param {Set<string>} [into] - Accumulator set (created when omitted).
443
+ * @returns {Set<string>} Set of trimmed, non-empty explicit ids.
444
+ */
445
+ function collectExplicitIds(node, into) {
446
+ const out = into || new Set();
447
+ const kids = node.childNodes;
448
+ if (!kids) return out;
449
+ for (const c of kids) {
450
+ if (c.nodeType !== NODE_ELEMENT) continue;
451
+ const raw = c.getAttribute ? c.getAttribute('id') : null;
452
+ if (raw && raw.trim()) out.add(raw.trim());
453
+ collectExplicitIds(c, out);
454
+ }
455
+ return out;
456
+ }
457
+
458
+ // ── Tag helpers ──────────────────────────────────────────────────────────
459
+
460
+ /**
461
+ * Derive the internal tag name from a DOM element.
462
+ *
463
+ * SVG child elements (namespace = SVG_NS, tag ≠ `'svg'`) are prefixed with
464
+ * `svg_` so that `template.js` can clone them from their namespace-aware
465
+ * `<template class="svg_*">` entries.
466
+ *
467
+ * @param {Element} el - The DOM element to inspect.
468
+ * @returns {string} Internal tag name (e.g. `'div'`, `'svg_use'`).
469
+ */
470
+ function internalTag(el) {
471
+ const raw = el.tagName.toLowerCase();
472
+ if (el.namespaceURI === SVG_NS && raw !== 'svg') return 'svg_' + raw;
473
+ return raw;
474
+ }
475
+
476
+ /**
477
+ * Convert an internal tag name to its HTML serialisation form.
478
+ *
479
+ * - Looks up an explicit override in `INTERNAL_TO_HTML`.
480
+ * - Strips the `svg_` prefix for SVG child elements.
481
+ * - Falls back to the tag unchanged.
482
+ *
483
+ * @param {string} tag - Internal tag name.
484
+ * @returns {string} HTML tag name to use when serialising.
485
+ */
486
+ function htmlTagName(tag) {
487
+ if (INTERNAL_TO_HTML[tag]) return INTERNAL_TO_HTML[tag];
488
+ if (tag.startsWith('svg_')) return tag.slice(4); // svg_rect → rect
489
+ return tag;
490
+ }
491
+
492
+ // ── Shared helper: parse a raw string for #{var} placeholders ─────────────
493
+ //
494
+ // Returns { val, maps } where:
495
+ // val – static base stored in elm.data[prop] or elm.text
496
+ // maps – map-entry objects ready for elm.map
497
+ //
498
+ // Positioning rules (mirror render.js):
499
+ // "prefix#{v}" → append : true, val = "prefix"
500
+ // "#{v}suffix" → prepend : true, val = "suffix"
501
+ // "prefix#{v}suffix" → append : true, val = "prefix", tail = "suffix"
502
+ // "#{v}" → full replace, val = ""
503
+ // "a#{v1}b#{v2}c" → val = "a" (leading run); each entry appends its
504
+ // resolved value then its trailing run via `tail`
505
+ // (v1.tail = "b", v2.tail = "c").
506
+
507
+ /**
508
+ * Parse a raw string for `#{var}` placeholders and build the corresponding
509
+ * static base value and {@link MapEntry} descriptors.
510
+ *
511
+ * Positioning rules (mirrored by `render.js`):
512
+ * - `"prefix#{v}"` → `append: true`, `val = "prefix"`
513
+ * - `"#{v}suffix"` → `prepend: true`, `val = "suffix"`
514
+ * - `"prefix#{v}suffix"` → `append: true`, `val = "prefix"`, `tail = "suffix"`
515
+ * - `"#{v}"` → full replace, `val = ""`
516
+ * - `"a#{v1}b#{v2}c"` → `val = "a"` (leading run); each entry `append`s its
517
+ * resolved value then its trailing static run via `tail` (`v1.tail = "b"`,
518
+ * `v2.tail = "c"`). Empty runs are omitted.
519
+ *
520
+ * @param {string} raw - Raw string potentially containing `#{…}` tokens.
521
+ * @param {string} prop - Property name the placeholders map to.
522
+ * @param {boolean} isData - `true` when targeting an attribute (`elm.data[prop]`);
523
+ * `false` when targeting text content.
524
+ * @returns {{ val: string, maps: MapEntry[] }} Static base value and binding
525
+ * descriptors. Returns the original string and an empty array when no
526
+ * placeholders are found.
527
+ */
528
+ function parseVarString(raw, prop, isData) {
529
+ const parts = raw.split(RE_VAR_SEP);
530
+ if (parts.length === 1) return { val: raw, maps: [] };
531
+
532
+ const vars = [];
533
+ parts.forEach((p, i) => {
534
+ const m = p.match(RE_VAR_ONE);
535
+ if (m) vars.push({ name: m[1], idx: i });
536
+ });
537
+
538
+ const maps = [];
539
+
540
+ // Single var: preserve the historical prefix-only / suffix-only /
541
+ // full-replace shapes byte-for-byte; add `tail` only for the
542
+ // both-sides `"prefix#{v}suffix"` case (previously lost the suffix).
543
+ if (vars.length === 1) {
544
+ const v = vars[0];
545
+ const before = parts.slice(0, v.idx).join('');
546
+ const after = parts.slice(v.idx + 1).join('');
547
+ const entry = { name: v.name, prop };
548
+ if (isData) entry.data = true;
549
+
550
+ if (before && !after) { entry.append = true; }
551
+ else if (!before && after) { entry.prepend = true; }
552
+ else if (before && after) { entry.append = true; entry.tail = after; }
553
+ // else: #{v} alone → full replace
554
+
555
+ maps.push(entry);
556
+ const base = entry.prepend ? after : before; // '' for full replace
557
+ return { val: base, maps };
558
+ }
559
+
560
+ // Multiple vars: ordered static/var segment sequence. The value is
561
+ // base + Σ (resolve(var_i) + tail_i)
562
+ // where `base` is the leading static run (before the first var) and
563
+ // each entry appends its resolved value followed by its trailing run.
564
+ const base = parts.slice(0, vars[0].idx).join('');
565
+ vars.forEach((v, i) => {
566
+ const nextIdx = (i + 1 < vars.length) ? vars[i + 1].idx : parts.length;
567
+ const tail = parts.slice(v.idx + 1, nextIdx).join('');
568
+ const entry = { name: v.name, prop, append: true };
569
+ if (isData) entry.data = true;
570
+ if (tail) entry.tail = tail;
571
+ maps.push(entry);
572
+ });
573
+
574
+ return { val: base, maps };
575
+ }
576
+
577
+ /**
578
+ * Reconstruct a raw `#{var}` string from a static base and its
579
+ * {@link MapEntry} descriptors. Inverse of {@link parseVarString},
580
+ * used by `toHTML` to regenerate the original template notation.
581
+ *
582
+ * @param {string} base - Static base value (may be `''` or `undefined`).
583
+ * @param {MapEntry[]} maps - Full map array; entries for other props are ignored.
584
+ * @param {string} prop - Target property to reconstruct.
585
+ * @param {boolean} isData - `true` for attribute entries; `false` for text.
586
+ * @returns {string} Reconstructed raw string with `#{…}` placeholders.
587
+ */
588
+ function buildVarString(base, maps, prop, isData) {
589
+ const propMaps = (maps || []).filter(m =>
590
+ m.prop === prop && !!m.data === isData
591
+ );
592
+ if (propMaps.length === 0) return base ?? '';
593
+
594
+ if (propMaps.length === 1) {
595
+ const m = propMaps[0];
596
+ const ph = `#{${m.name}}`;
597
+ if (m.append) return (base || '') + ph + (m.tail || '');
598
+ if (m.prepend) return ph + (base || '');
599
+ return ph; // full replace
600
+ }
601
+
602
+ // Multiple vars: leading static base, then each placeholder followed
603
+ // by its trailing static run (`tail`).
604
+ let result = base || '';
605
+ propMaps.forEach(m => { result += `#{${m.name}}` + (m.tail || ''); });
606
+ return result;
607
+ }
608
+
609
+ /**
610
+ * Convert a flat, parent-ordered elm array into an {@link ElmTree} suited
611
+ * for recursive serialisation in `toHTML`.
612
+ *
613
+ * @param {ElmNode[]} elmArray - Flat elm array (parents before children).
614
+ * @returns {ElmTree} Tree representation with `byId`, `kids`, and `roots`.
615
+ */
616
+ function buildTree(elmArray) {
617
+ const byId = new Map();
618
+ const kids = new Map();
619
+ const roots = [];
620
+
621
+ elmArray.forEach(elm => {
622
+ byId.set(elm.id, elm);
623
+ kids.set(elm.id, []);
624
+ });
625
+ elmArray.forEach(elm => {
626
+ if (elm.parent && byId.has(elm.parent)) {
627
+ kids.get(elm.parent).push(elm.id);
628
+ } else {
629
+ roots.push(elm.id);
630
+ }
631
+ });
632
+
633
+ return { byId, kids, roots };
634
+ }
635
+
636
+ /**
637
+ * Recursively serialise a single elm node and its descendants to an
638
+ * indented HTML string, restoring `#{var}` / `${slot}` / iterate-block
639
+ * notation as required.
640
+ *
641
+ * @param {string} id - Id of the node to serialise.
642
+ * @param {ElmTree} tree - Tree built by `buildTree`.
643
+ * @param {Object.<string, ElmNode[]>} iteratesMap - Sub-template arrays keyed by
644
+ * iterate-block name.
645
+ * @param {string} pad - Current indentation prefix.
646
+ * @returns {string} HTML fragment string for this node and its subtree.
647
+ */
648
+ function serializeNode(id, tree, iteratesMap, pad) {
649
+ const elm = tree.byId.get(id);
650
+ if (!elm) return '';
651
+
652
+ // ── Synthetic text nodes ──────────────────────────────────────────────
653
+ // tag:'text' is a bare inline-text wrapper created by fromHTML when a
654
+ // text node has element siblings. In the HTML template notation it lives
655
+ // as plain text (no <span>), so we emit it without any wrapping tag.
656
+ if (elm.tag === 'text') {
657
+ return buildVarString(elm.text ?? '', elm.map || [], 'text', false);
658
+ }
659
+
660
+ const tag = htmlTagName(elm.tag);
661
+ const maps = elm.map || [];
662
+ const indent = pad || '';
663
+ const child0 = indent + ' '; // one level deeper (children)
664
+ const child1 = child0 + ' '; // two levels deeper (iterate content)
665
+
666
+ // ── Opening tag ──────────────────────────────────────────────────────
667
+ let attrStr = `id="${elm.id}"`;
668
+ if (elm.attrs) {
669
+ elm.attrs.forEach(attr => {
670
+ const base = elm.data?.[attr] ?? '';
671
+ attrStr += ` ${attr}="${buildVarString(base, maps, attr, true)}"`;
672
+ });
673
+ }
674
+
675
+ if (VOID_TAGS.has(tag)) {
676
+ return `${indent}<${tag} ${attrStr}>`;
677
+ }
678
+
679
+ // ── Inner content ────────────────────────────────────────────────────
680
+ let inner = '';
681
+
682
+ if (elm.content) {
683
+ const itTpl = iteratesMap && iteratesMap[elm.content];
684
+ if (itTpl) {
685
+ // Inline the iterate sub-template between comment delimiters
686
+ const subTree = buildTree(itTpl);
687
+ const subLines = subTree.roots
688
+ .map(rid => serializeNode(rid, subTree, iteratesMap, child1))
689
+ .join('\n');
690
+ inner =
691
+ `\n${child0}<!-- $${elm.content} -->\n` +
692
+ subLines +
693
+ `\n${child0}<!-- ${elm.content}$ -->\n${indent}`;
694
+ } else {
695
+ inner = `\${${elm.content}}`;
696
+ }
697
+
698
+ } else if (
699
+ Object.prototype.hasOwnProperty.call(elm, 'text') ||
700
+ maps.some(m => m.prop === 'text' && !m.data)
701
+ ) {
702
+ // Leaf node: reconstruct text with #{var} placeholders
703
+ inner = buildVarString(elm.text ?? '', maps, 'text', false);
704
+
705
+ } else {
706
+ // Container: recurse into children
707
+ const childIds = tree.kids.get(id) || [];
708
+ if (childIds.length > 0) {
709
+ // If ANY child is a synthetic 'text' node the content is mixed
710
+ // inline/block → use inline mode (no newlines) to avoid adding
711
+ // spurious whitespace-text between the elements.
712
+ const hasSyntheticText = childIds.some(cid => {
713
+ const c = tree.byId.get(cid);
714
+ return c && c.tag === 'text';
715
+ });
716
+
717
+ if (hasSyntheticText) {
718
+ // Inline mode: children concatenated, no wrapping newlines.
719
+ // 'text' nodes emit bare strings; element nodes emit their tags
720
+ // without extra indentation inside the parent.
721
+ inner = childIds
722
+ .map(cid => serializeNode(cid, tree, iteratesMap, ''))
723
+ .join('');
724
+ } else {
725
+ // Block mode: each child on its own indented line.
726
+ inner =
727
+ '\n' +
728
+ childIds
729
+ .map(cid => serializeNode(cid, tree, iteratesMap, child0))
730
+ .join('\n') +
731
+ '\n' + indent;
732
+ }
733
+ }
734
+ }
735
+
736
+ return `${indent}<${tag} ${attrStr}>${inner}</${tag}>`;
737
+ }
738
+
739
+ // ── fromHTML ─────────────────────────────────────────────────────────────
740
+
741
+ /**
742
+ * Parse an HTML string into a flat elm-array representation.
743
+ *
744
+ * **Mixed content rules:**
745
+ * - An element whose sole content is a text node is a *leaf*:
746
+ * - `${slot}` → `elm.content = 'slot'`
747
+ * - `#{var}` / plain text → `elm.text` + `elm.map`
748
+ * - An element that has element children is a *container*:
749
+ * - Bare text nodes with element siblings become synthetic children:
750
+ * - `${slot}` → `{ tag: 'span', content: 'slot' }` (has siblings → span)
751
+ * - `#{var}` / plain text → `{ tag: 'text', text: …, map: … }`
752
+ * - Document order is preserved in the flat output array.
753
+ *
754
+ * **SVG:** Child elements of `<svg>` carry `namespaceURI = SVG_NS` and are
755
+ * tagged `svg_<localname>` to match the `template.js` `svg_*` convention.
756
+ *
757
+ * **Security:** Uses `DOMParser` only - never `innerHTML` setter, `eval`,
758
+ * or `Function`.
759
+ *
760
+ * **Id uniqueness:** auto-minted `p<n>` ids skip every explicit id of
761
+ * this document, every explicit id seen by an earlier call on the same
762
+ * instance, and every id passed through `reserveIdsInput`.
763
+ *
764
+ * @param {string} htmlString - HTML markup to parse.
765
+ * @param {Iterable<string>} [reserveIdsInput] - Caller-declared explicit
766
+ * ids to reserve instance-wide before the walk.
767
+ * @returns {ParseResult} Parsed result containing `template` and optional
768
+ * `iterates` sub-templates.
769
+ */
770
+ // ── ParseResult cache ──────────────────────────────────────────────
771
+ // Keyed by the raw HTML source string. Bounded LRU-ish : on overflow
772
+ // we drop the oldest insertion (Map preserves insertion order, so the
773
+ // first key is the oldest). `_cacheStats` is exposed via getStats()
774
+ // for instrumentation.
775
+ let _cacheMax = 64; // entries; 0 disables caching
776
+ const _cacheMap = new Map();
777
+ const _cacheStats = { hits: 0, misses: 0, evictions: 0 };
778
+
779
+ function _cacheGet(key) {
780
+ if (_cacheMax === 0) return undefined;
781
+ const hit = _cacheMap.get(key);
782
+ if (hit !== undefined) {
783
+ // Bump to most-recent : delete + reinsert.
784
+ _cacheMap.delete(key);
785
+ _cacheMap.set(key, hit);
786
+ _cacheStats.hits++;
787
+ } else {
788
+ _cacheStats.misses++;
789
+ }
790
+ return hit;
791
+ }
792
+
793
+ function _cacheSet(key, value) {
794
+ if (_cacheMax === 0) return;
795
+ if (_cacheMap.size >= _cacheMax) {
796
+ // Drop oldest
797
+ const oldest = _cacheMap.keys().next().value;
798
+ _cacheMap.delete(oldest);
799
+ _cacheStats.evictions++;
800
+ }
801
+ _cacheMap.set(key, value);
802
+ }
803
+
804
+ const _fromHTMLImpl = function(htmlString, reserveIdsInput) {
805
+ // Resolve a tree root suitable for `walkElement`. In browser /
806
+ // happy-dom contexts we use DOMParser (battle-tested, fast). In
807
+ // pure-Node/Bun (SSR), we fall back to the framework's internal
808
+ // tokenizer (`parseHTMLString` below), which produces a tree
809
+ // matching the same Node-shape interface that walkElement consumes.
810
+ const rootNode = (typeof DOMParser !== 'undefined')
811
+ ? new DOMParser().parseFromString(
812
+ '<html><body>' + htmlString + '</body></html>',
813
+ 'text/html'
814
+ ).body
815
+ : parseHTMLString(htmlString);
816
+
817
+ // Every explicit id of THIS document, collected before the walk so
818
+ // that an auto-minted `pN` never collides with an explicit `pN` —
819
+ // including one that only appears further down the tree.
820
+ const reserved = collectExplicitIds(rootNode);
821
+ // Cross-call layers, both applied BEFORE the walk as well:
822
+ // - ids the caller declared up front for the whole assembled
823
+ // document (covers explicit ids this instance has not met yet);
824
+ // - this document's explicit ids, folded into the instance set so
825
+ // a LATER call never re-mints them.
826
+ reserveInstanceIds(reserveIdsInput, reserved);
827
+ for (const id of reserved) _reservedAll.add(id);
828
+
829
+ const template = [];
830
+ const iterates = {};
831
+
832
+ function walkElement(el, parentId, out) {
833
+ const rawTag = el.tagName.toLowerCase();
834
+ if (RE_BLOCKED_TAG.test(rawTag)) return;
835
+
836
+ const tag = internalTag(el);
837
+ const atId = el.getAttribute('id');
838
+ const id = (atId && atId.trim()) ? atId.trim() : nextId(reserved);
839
+
840
+ const elm = { id, tag };
841
+ if (parentId !== null && parentId !== undefined) elm.parent = parentId;
842
+
843
+ const allMaps = [];
844
+ const attrs = [];
845
+ const data = {};
846
+
847
+ // ── Attributes ───────────────────────────────────────────────────
848
+ for (const attr of el.attributes) {
849
+ if (attr.name === 'id') continue;
850
+ if (!RE_SAFE_A.test(attr.name)) continue;
851
+ if (RE_EVENT.test(attr.name)) continue;
852
+
853
+ const { val, maps } = parseVarString(attr.value, attr.name, true);
854
+ attrs.push(attr.name);
855
+ data[attr.name] = val;
856
+ allMaps.push(...maps);
857
+ }
858
+ if (attrs.length > 0) {
859
+ elm.attrs = attrs;
860
+ elm.data = { ...data };
861
+ }
862
+
863
+ // ── Children: scan for iterate comment blocks ─────────────────────
864
+ const childNodes = Array.from(el.childNodes);
865
+ let iterateName = null;
866
+ let inIter = false;
867
+ const iterKids = []; // elements inside <!-- $name -->...<!-- name$ -->
868
+ const plainKids = []; // everything else (in document order)
869
+
870
+ for (const c of childNodes) {
871
+ if (c.nodeType === NODE_COMMENT) {
872
+ const sm = c.nodeValue.match(RE_IT_S);
873
+ const em = c.nodeValue.match(RE_IT_E);
874
+ if (sm) {
875
+ iterateName = sm[1];
876
+ inIter = true;
877
+ } else if (em && inIter) {
878
+ inIter = false;
879
+ }
880
+ } else if (inIter) {
881
+ if (c.nodeType === NODE_ELEMENT) iterKids.push(c);
882
+ } else {
883
+ plainKids.push(c);
884
+ }
885
+ }
886
+
887
+ // ── Content resolution ───────────────────────────────────────────
888
+
889
+ if (iterateName) {
890
+ // This element is the slot container for an iterate block.
891
+ // Elements between the comment delimiters form a separate template.
892
+ elm.content = iterateName;
893
+ const subOut = [];
894
+ iterKids.forEach(c => walkElement(c, null, subOut));
895
+ iterates[iterateName] = subOut;
896
+
897
+ if (allMaps.length > 0) elm.map = allMaps;
898
+ out.push(elm);
899
+
900
+ } else {
901
+ const elKids = plainKids.filter(c => c.nodeType === NODE_ELEMENT);
902
+
903
+ if (elKids.length === 0) {
904
+ // ── Leaf: sole text content ───────────────────────────────
905
+ const text = plainKids
906
+ .filter(c => c.nodeType === NODE_TEXT)
907
+ .map(c => c.nodeValue)
908
+ .join('')
909
+ .trim();
910
+
911
+ if (text) {
912
+ const slotM = text.match(RE_SLOT);
913
+ if (slotM) {
914
+ elm.content = slotM[1];
915
+ } else {
916
+ const { val, maps } = parseVarString(text, 'text', false);
917
+ elm.text = val;
918
+ allMaps.push(...maps);
919
+ }
920
+ }
921
+
922
+ if (allMaps.length > 0) elm.map = allMaps;
923
+ out.push(elm);
924
+
925
+ } else {
926
+ // ── Container: has element children ───────────────────────
927
+ // Push the parent first (order invariant: parent before children).
928
+ if (allMaps.length > 0) elm.map = allMaps;
929
+ out.push(elm);
930
+
931
+ // Process children IN DOCUMENT ORDER.
932
+ // Non-empty text nodes that live alongside element siblings
933
+ // cannot be represented as elm.text; they become synthetic
934
+ // child elements instead.
935
+ plainKids.forEach(c => {
936
+ if (c.nodeType === NODE_ELEMENT) {
937
+ walkElement(c, id, out);
938
+
939
+ } else if (c.nodeType === NODE_TEXT) {
940
+ const rawText = c.nodeValue.trim();
941
+ if (!rawText) return; // whitespace-only → skip
942
+
943
+ const slotM = rawText.match(RE_SLOT);
944
+ if (slotM) {
945
+ // ${slot} text node with element siblings → <span>
946
+ // (the memo rule: "has neighbours → span tag")
947
+ out.push({ id: nextId(reserved), tag: 'span', parent: id, content: slotM[1] });
948
+ } else {
949
+ // Plain text or #{var} with element siblings →
950
+ // synthetic 'text' node (rendered as <span> by
951
+ // template.js, serialised as bare text by toHTML).
952
+ const { val, maps } = parseVarString(rawText, 'text', false);
953
+ const syn = { id: nextId(reserved), tag: 'text', parent: id, text: val };
954
+ if (maps.length > 0) syn.map = maps;
955
+ out.push(syn);
956
+ }
957
+ }
958
+ });
959
+ }
960
+ }
961
+ }
962
+
963
+ Array.from(rootNode.childNodes).forEach(c => {
964
+ if (c.nodeType === NODE_ELEMENT) walkElement(c, null, template);
965
+ });
966
+
967
+ const result = { template };
968
+ if (Object.keys(iterates).length > 0) result.iterates = iterates;
969
+ return result;
970
+ };
971
+
972
+ // ── toHTML ───────────────────────────────────────────────────────────────
973
+
974
+ /**
975
+ * Convert an elm array (or a {@link ParseResult} object) back to an HTML
976
+ * string, reconstructing `#{var}` / `${slot}` / `<!-- $name -->` notation.
977
+ *
978
+ * Accepts either form:
979
+ * ```js
980
+ * toHTML(elmArray)
981
+ * toHTML({ template: elmArray, iterates: { name: elmArray } })
982
+ * ```
983
+ *
984
+ * @param {ElmNode[] | ParseResult} input - Flat elm array or a `ParseResult`
985
+ * as returned by `fromHTML`.
986
+ * @returns {string} Indented HTML string with the original template notation
987
+ * restored.
988
+ */
989
+ const toHTML = function(input) {
990
+ const isArr = Array.isArray(input);
991
+ const tmpl = isArr ? input : (input.template || []);
992
+ const iterMap = isArr ? {} : (input.iterates || {});
993
+
994
+ const tree = buildTree(tmpl);
995
+ return tree.roots
996
+ .map(id => serializeNode(id, tree, iterMap, ''))
997
+ .join('\n');
998
+ };
999
+
1000
+ /**
1001
+ * Cached `fromHTML` : returns the same ParseResult for identical input
1002
+ * strings. The cached object is a frozen reference - callers that need
1003
+ * to mutate it should clone first. Cache is bounded; oldest entries are
1004
+ * evicted on overflow.
1005
+ *
1006
+ * Supplying `options.reserveIds` BYPASSES the cache in both directions:
1007
+ * the reservation changes which auto ids are minted, so a hit keyed on
1008
+ * the source string alone would return a stale `ParseResult` that
1009
+ * violates the reservation, and storing the reserved-set result under
1010
+ * that same key would poison later plain calls. The reservation itself
1011
+ * is still recorded on the instance, so it keeps applying to every
1012
+ * subsequent call.
1013
+ *
1014
+ * @param {string} htmlString - HTML markup to parse.
1015
+ * @param {FromHTMLOptions} [options] - Optional parse inputs.
1016
+ * @returns {ParseResult} Parsed result.
1017
+ */
1018
+ const fromHTML = function(htmlString, options) {
1019
+ const reserveIdsInput = options ? options.reserveIds : undefined;
1020
+ if (typeof htmlString !== 'string') {
1021
+ return _fromHTMLImpl(htmlString, reserveIdsInput);
1022
+ }
1023
+ if (reserveIdsInput !== undefined && reserveIdsInput !== null) {
1024
+ return _fromHTMLImpl(htmlString, reserveIdsInput);
1025
+ }
1026
+ const cached = _cacheGet(htmlString);
1027
+ if (cached !== undefined) return cached;
1028
+ const result = _fromHTMLImpl(htmlString);
1029
+ _cacheSet(htmlString, result);
1030
+ return result;
1031
+ };
1032
+
1033
+ /**
1034
+ * Manual cache controls (test / power-user).
1035
+ */
1036
+ const cache = {
1037
+ /** Clear all cached entries. */
1038
+ clear() { _cacheMap.clear(); _cacheStats.hits = 0; _cacheStats.misses = 0; _cacheStats.evictions = 0; },
1039
+ /** Get/set the max cache size; 0 disables caching. */
1040
+ setMax(n) {
1041
+ _cacheMax = Math.max(0, n | 0);
1042
+ while (_cacheMap.size > _cacheMax) {
1043
+ const oldest = _cacheMap.keys().next().value;
1044
+ _cacheMap.delete(oldest);
1045
+ _cacheStats.evictions++;
1046
+ }
1047
+ },
1048
+ getMax() { return _cacheMax; },
1049
+ size() { return _cacheMap.size; },
1050
+ stats() { return { ..._cacheStats, size: _cacheMap.size, max: _cacheMax }; },
1051
+ };
1052
+
1053
+ return { fromHTML, toHTML, cache };
1054
+ }
1055
+ };