@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,87 @@
1
+ ---
2
+ module: xml
3
+ category: io/codec
4
+ dependencies: []
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # xml
11
+
12
+ > Minimal tolerant XML parser/serializer, sufficient for 90% of cases (OOXML/ODF parts, XMP metadata, inline SVG, RSS, MathML, configs).
13
+
14
+ **Module** `xml` | **Source** `packages/front/fw/src/io/codec/xml.js` | **Deps** none | **Worker-safe** yes
15
+
16
+ ## Resolve
17
+
18
+ ```js
19
+ const xml = runtime.resolve('xml');
20
+ // Returns: { el, text, parse, serialize, serializeNode,
21
+ // findChild, findAll, textContent,
22
+ // encodeText, encodeAttr, decodeEntities }
23
+ ```
24
+
25
+ ## API
26
+
27
+ | Method | Signature | Returns |
28
+ |--------|-----------|---------|
29
+ | `parse` | `(text: string) => ElementNode` | Node tree — root element. Throws `XmlParseError` if invalid. |
30
+ | `serialize` | `(root: ElementNode) => string` | Full XML with `UTF-8 standalone="yes"` prolog. |
31
+ | `serializeNode` | `(node: Node) => string` | XML without prolog. |
32
+ | `el` | `(name: string, attrs?: Object, children?: Node[]) => ElementNode` | Element constructor. |
33
+ | `text` | `(value: string) => TextNode` | Text node constructor. |
34
+ | `findChild` | `(node: ElementNode, name: string) => ElementNode \| null` | First named child. |
35
+ | `findAll` | `(node: ElementNode, name: string) => ElementNode[]` | All named children. |
36
+ | `textContent` | `(node: Node) => string` | Recursive text concatenation. |
37
+ | `encodeText` | `(s: string) => string` | Escapes `&`, `<`, `>`. |
38
+ | `encodeAttr` | `(s: string) => string` | Escapes `&`, `<`, `>`, `"`. |
39
+ | `decodeEntities` | `(s: string) => string` | Decodes `&amp;`, `&lt;`, `&#NNN;`, `&#xHHH;` etc. |
40
+
41
+ ## Node model
42
+
43
+ ```js
44
+ { type: 'element', name: 'w:p', attrs: { 'xml:lang': 'fr' }, children: [...] }
45
+ { type: 'text', value: 'hello' }
46
+ ```
47
+
48
+ ## Examples
49
+
50
+ ```js
51
+ const xml = runtime.resolve('xml');
52
+
53
+ // Construction
54
+ const node = xml.el('root', { version: '1' }, [xml.text('hello')]);
55
+
56
+ // Parsing
57
+ const root = xml.parse('<a xmlns:w="urn:w"><w:p>hello</w:p></a>');
58
+ xml.textContent(xml.findChild(root, 'w:p')); // 'hello'
59
+
60
+ // Serialization
61
+ xml.serialize(node);
62
+ // '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\r\n<root version="1">hello</root>'
63
+
64
+ xml.serializeNode(xml.el('br')); // '<br/>'
65
+ ```
66
+
67
+ ## Worker Usage
68
+
69
+ ```js
70
+ // xml is worker-safe: all functions are pure closures,
71
+ // no DOM access, no global state.
72
+ const worker = fw.createWorker(workerScript);
73
+ // Transfer serialized nodes via serializeNode / parse on each side.
74
+ ```
75
+
76
+ ## Notes
77
+
78
+ - No DTD, no external entities — only predefined entities (`amp`, `lt`, `gt`, `quot`, `apos`) and numeric references (`&#NNN;`, `&#xHHH;`) are handled.
79
+ - No XSD validation; no strict namespace resolution — prefixes are preserved as-is in `name` (e.g. `w:p`).
80
+ - `XmlParseError` (code `xml/parse-error`) thrown on structural errors — the parser is tolerant for common OOXML/ODF cases but strict on basic structure.
81
+ - Oriented towards office documents and feeds (OOXML, ODF, XMP, SVG, RSS) — not a replacement for DOMParser with HTML5.
82
+
83
+ ## See also
84
+
85
+ - [`utf8`](./utf8.md) — encoding content to bytes
86
+ - [`buffer`](./buffer.md) — binary object serialization
87
+ - [`csv`](./csv.md) — tabular text format parsing
@@ -0,0 +1,62 @@
1
+ # IO / Compress — Compression
2
+
3
+ Binary compression modules. All worker-safe (pure factories, no DOM).
4
+
5
+ ## Modules
6
+
7
+ | Module | Returns | Deps | Description |
8
+ |--------|----------|------|-------------|
9
+ | [lz4](./lz4.md) | `object` | none | LZ4 compression (fast, streaming) |
10
+ | [bitstream](./bitstream.md) | `object` | none | LSB-first bit read/write + reverse table |
11
+ | [huffman](./huffman.md) | `object` | bitstream | Canonical Huffman codes (encode + decode) |
12
+ | [lz77](./lz77.md) | `object` | none | LZ77 hash-chain matching (literal + match callbacks) |
13
+ | [lzw](./lzw.md) | `object` | none | LZW dynamic dictionary, variable codes (GIF/TIFF/.Z) |
14
+ | [deflate](./deflate.md) | `object` | bitstream, huffman, lz77 | Deflate (internal engine, RFC 1951) |
15
+ | [gzip](./gzip.md) | `object` | deflate, crc32 | Gzip sync/async/streaming (RFC 1952) |
16
+ | [zlib](./zlib.md) | `object` | deflate, adler32 | Zlib sync/async/streaming (RFC 1950) |
17
+ | [zip](./zip.md) | `object` | deflate, crc32 | ZIP sync/async/streaming archive |
18
+ | [brotliDict](./brotli_dict.md) | `object` | none | Brotli — tables + 121 transforms (RFC 7932 Appendix B) |
19
+ | [brotliDictWords](./brotli_dict_words.md) | `object` | none | Brotli — static dictionary blob (RFC 7932 Appendix A, lazy-loadable) |
20
+ | [brotli](./brotli.md) | `object` | bitstream, huffman, lz77, brotliDict, brotliDictWords | Brotli RFC 7932 — full decoder, dynamic encoder |
21
+ | [brotliShared](./brotli_shared.md) | `object` | brotli, brotliDict, brotliDictWords | RFC 9841 extensions (large window, shared dictionary §3.1/§3.2, `parseSharedDictionary` §5) |
22
+ | [brotliFrame](./brotli_frame.md) | `object` | none | RFC 9841 §8 Shared Brotli Framing Format parser |
23
+
24
+ ## Common pattern
25
+
26
+ ```js
27
+ const lz4 = runtime.resolve('lz4');
28
+ const gzip = runtime.resolve('gzip');
29
+ const zip = runtime.resolve('zip');
30
+ const br = runtime.resolve('brotli');
31
+
32
+ // LZ4 — ultra-fast, ideal for temporary data
33
+ const [size, compressed] = lz4.compress(data, data.length);
34
+ const [origSize, original] = lz4.decompress(compressed);
35
+
36
+ // Gzip — web standard (Accept-Encoding, fetch)
37
+ const gz = gzip.gzipSync(data);
38
+ const raw = gzip.gunzipSync(gz);
39
+
40
+ // ZIP — multi-file archiving
41
+ const archive = zip.zipSync({ 'file.txt': textBytes, 'data.bin': binBytes });
42
+ const files = zip.unzipSync(archive);
43
+
44
+ // Brotli — RFC 7932, superior ratio on text
45
+ const enc = br.brotliCompressSync(data, { quality: 11 });
46
+ const dec = br.brotliDecompressSync(enc);
47
+ ```
48
+
49
+ ## Choosing the right module
50
+
51
+ | Use case | Module |
52
+ |-------------|--------|
53
+ | Fast compression without standard | `lz4` |
54
+ | HTTP/browser compatibility (gzip Content-Encoding) | `gzip` |
55
+ | System tool compatibility (Unix `zlib`) | `zlib` |
56
+ | Multi-file archiving | `zip` |
57
+ | Compression only (base for gzip/zlib/zip) | `deflate` |
58
+ | Superior ratio on text (Brotli RFC 7932 core) | `brotli` |
59
+ | Shared dictionary / large window / §5 parser (RFC 9841) | `brotliShared` |
60
+ | Multi-resource framing container (RFC 9841 §8) | `brotliFrame` |
61
+ | Text compression with small dictionary | `lzw` (GIF/TIFF/.Z) |
62
+ | Low-level primitives for building a codec | `bitstream`, `huffman`, `lz77` |
@@ -0,0 +1,131 @@
1
+ ---
2
+ module: bitstream
3
+ category: io/compress
4
+ dependencies: []
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # bitstream
11
+
12
+ > LSB-first bit-stream reader/writer over `Uint8Array` + 15-bit reverse table.
13
+
14
+ **Module** `bitstream` | **Source** `packages/front/fw/src/io/compress/bitstream.js` | **Deps** none | **Worker-safe** yes
15
+
16
+ Primitive shared by codecs whose bit layout follows DEFLATE/Brotli
17
+ conventions: little-endian packing within each byte, least-significant bit
18
+ first. Also exposes the `rev` 15-bit bit-reversal table used by canonical
19
+ Huffman decoding.
20
+
21
+ ## Resolve
22
+
23
+ ```js
24
+ const bs = runtime.resolve('bitstream');
25
+ // { readBits, readBits16, writeBits, writeBits16, byteOffset, slice, max, rev }
26
+ ```
27
+
28
+ ## API
29
+
30
+ | Method | Signature | Returns |
31
+ |--------|-----------|---------|
32
+ | `readBits` | `(buf: Uint8Array, bitPos: number, mask: number) => number` | up to 16 bits at `bitPos`, masked |
33
+ | `readBits16` | `(buf: Uint8Array, bitPos: number) => number` | up to 24 bits at `bitPos`, **not** masked |
34
+ | `writeBits` | `(buf: Uint8Array, bitPos: number, v: number) => void` | writes up to 16 bits (OR-into) |
35
+ | `writeBits16` | `(buf: Uint8Array, bitPos: number, v: number) => void` | writes up to 24 bits (OR-into) |
36
+ | `byteOffset` | `(bitPos: number) => number` | `ceil(bitPos / 8)` |
37
+ | `slice` | `(buf: Uint8Array, start?, end?) => Uint8Array` | copied sub-array (not a view) |
38
+ | `max` | `(arr: ArrayLike<number>) => number` | maximum |
39
+ | `rev` | `Uint16Array(32768)` | `rev[i]` = bit-reverse of `i` in 15 bits |
40
+
41
+ ### `readBits(buf, bitPos, mask)`
42
+
43
+ Reads up to 16 bits starting at bit position `bitPos` (absolute index from
44
+ the beginning of `buf`). The `mask` must be pre-computed by the caller as
45
+ `(1 << nbits) - 1`. The explicit pattern allows the mask to be hoisted out
46
+ of hot loops.
47
+
48
+ ### `writeBits(buf, bitPos, v)`
49
+
50
+ OR-into: destination bits must be zero before the call. This is the default
51
+ for a freshly allocated `Uint8Array`, which is the expected pattern
52
+ (pre-allocated output buffer, sequential writes).
53
+
54
+ ### `rev`
55
+
56
+ 15-bit bit-reversal table: `rev[i]` is `i` read in mirror over 15 bits,
57
+ the result right-shifted by one bit to fit in 15 useful bits. Used by
58
+ canonical Huffman decoders to index a table by the `maxBits` low-order
59
+ bits of the stream.
60
+
61
+ ## Examples
62
+
63
+ ### Write/read a 9-bit code
64
+
65
+ ```js
66
+ const bs = runtime.resolve('bitstream');
67
+ const out = new Uint8Array(4);
68
+
69
+ bs.writeBits(out, 5, 0x1A5); // 9 bits at position 5
70
+ const v = bs.readBits(out, 5, (1 << 9) - 1); // 0x1A5
71
+ ```
72
+
73
+ ### Build a mask from a bit count
74
+
75
+ ```js
76
+ const nbits = 11;
77
+ const mask = (1 << nbits) - 1;
78
+ bs.readBits(buf, p, mask); // reads 11 bits
79
+ ```
80
+
81
+ ## Worker Usage
82
+
83
+ ```js
84
+ const worker = fw.createWorker(
85
+ function ({ libs, args }) {
86
+ const bs = libs.bitstream;
87
+ const buf = args[0];
88
+ self.postMessage(bs.readBits(buf, 0, 0xFFFF));
89
+ },
90
+ { dependencies: ['bitstream'], args: [new Uint8Array([0xCD, 0xAB])] }
91
+ );
92
+ ```
93
+
94
+ ## Notes
95
+
96
+ - `readBits` always reads **2 consecutive bytes** starting at byte `floor(bitPos / 8)` (not `byteOffset(bitPos)`, which rounds up); an index past the end of the buffer reads as zero, never throws.
97
+ - `readBits16` reads **3 consecutive bytes** and does not mask — the caller must apply its own mask.
98
+ - `writeBits` / `writeBits16` are `OR-into`, **not** destructive writes: a second call on the same bits produces corrupt data.
99
+ - The `rev` table is built **once per factory instance** (~64 KB) — share the instance across consumer modules.
100
+
101
+ ## Benchmark
102
+
103
+ Micro-cell `bitstream.rw`, `tools/bench/codec-levels.js` (one pass writing
104
+ `1 << 20` values of widths 1-16 then reading them back, corpus-independent),
105
+ `--reps 7 --warmup 3`, baseline sha `d47f8fc7a68809f519fe7d36ff2b0ba88bcacdbd`.
106
+ Host `win32` / `13th Gen Intel(R) Core(TM) i7-13700KF` / Bun `1.3.13`.
107
+ Generated `2026-09-24T20:50:02.210Z` (gitignored bench artifact). Rule:
108
+ `Δenc < +5 %`; gated on time only (no dec split, no bytes cell —
109
+ `bitstream.js` is byte-for-byte unchanged by the clean-room rewrite, see
110
+ [huffman](./huffman.md) § Design).
111
+
112
+ | Cell | Old enc ms | New enc ms | Δenc % | Verdict |
113
+ |---|---|---|---|---|
114
+ | bitstream.rw | 7.79 | 8.55 | 9.8 | FAIL (enc) |
115
+
116
+ **0/1 PASS.** `bitstream.js` did not change in the clean-room rewrite
117
+ (confirmed byte-for-byte by the module's own perf-pass diff), so this is
118
+ measurement noise, not a regression: a later measurement ruling recorded
119
+ that an A/A run of two byte-identical copies of the module measures the
120
+ same `rw` path at ±10-15 % between copies in the shared-process harness,
121
+ while running one engine per process the same path measures 3.25 vs 3.25
122
+ ms (equal). The cell is accepted as the harness's own noise floor.
123
+
124
+ ## Provenance
125
+
126
+ In-house implementation written from RFC 1951 §3.1.1 (bit packing) and RFC 7932 §1.5; the earlier fflate-derived implementation was replaced by a clean-room rewrite (2026-09).
127
+
128
+ ## See also
129
+
130
+ - [huffman](./huffman.md) — builds on `rev` and the slice/max helpers
131
+ - [deflate](./deflate.md) — first consumer (RFC 1951)
@@ -0,0 +1,232 @@
1
+ ---
2
+ module: brotli
3
+ category: io/compress
4
+ dependencies: [bitstream, huffman, lz77, brotliDict, brotliDictWords]
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # brotli
11
+
12
+ > Brotli RFC 7932 codec — decoder + dynamic encoder with dict refs.
13
+
14
+ **Module** `brotli` | **Source** `packages/front/fw/src/io/compress/brotli.js` | **Deps** `bitstream`, `huffman`, `lz77`, `brotliDict`, `brotliDictWords` | **Worker-safe** yes
15
+
16
+ Base **RFC 7932-only** codec. Complete decoder (100% spec), dynamic encoder with LZ77 + Huffman + adaptive context modeling + block splitting + static-dict refs (121/121 transforms) + quality levels 0..11. For RFC 9841 extensions (large window, shared dictionary, §5 parser), use the companion module [`brotliShared`](./brotli_shared.md) which depends on this one.
17
+
18
+ ## Resolve
19
+
20
+ ```js
21
+ const br = runtime.resolve('brotli');
22
+ // Returns: { brotliCompressSync, brotliDecompressSync, brotliCompress,
23
+ // brotliDecompress, BrotliCompressStream, BrotliDecompressStream }
24
+ ```
25
+
26
+ ## API
27
+
28
+ | Method | Signature | Returns |
29
+ |--------|-----------|---------|
30
+ | `brotliCompressSync` | `(data: Uint8Array, opts?) => Uint8Array` | Compression — dynamic LZ77 + Huffman (≥ 32 bytes), trivial otherwise |
31
+ | `brotliDecompressSync` | `(data: Uint8Array, opts?) => Uint8Array` | Synchronous decompression |
32
+ | `brotliCompress` | `(data, opts?) => Promise<Uint8Array>` | Async compression (microtask wrap) |
33
+ | `brotliDecompress` | `(data, opts?) => Promise<Uint8Array>` | Async decompression (microtask wrap) |
34
+ | `BrotliCompressStream` | `new (opts?, ondata) => instance` | Streaming compressor (buffered) |
35
+ | `BrotliDecompressStream` | `new (opts?, ondata) => instance` | Streaming decompressor (EAGAIN-incremental) |
36
+
37
+ ### Compression options
38
+
39
+ | Option | Type | Default | Description |
40
+ |--------|------|---------|-------------|
41
+ | `quality` | `0..11` | `6` | Speed/ratio profile. `0` = trivial uncompressed. `1..3` = `chainDepth 2..4`, lazy off. `4..7` = `chainDepth 6..10`, lazy on. `8..11` = `chainDepth 16..32`, lazy + block splitting. |
42
+
43
+ The encoder automatically selects, per block, the best `CMODE` (LSB6/MSB6/UTF8/Signed) via entropy, the best `(NPOSTFIX, NDIRECT)` among 7 candidates by bit-cost, and enables block splitting `NBLTYPES_L = 2` on heterogeneous inputs ≥ 32 KiB (trigger: KL-divergence > 0.3).
44
+
45
+ ### Error codes
46
+
47
+ | Code | Cause |
48
+ |------|-------|
49
+ | `EBADARG` | Argument not `Uint8Array`, `quality` outside `[0, 11]` |
50
+ | `EBADSTREAM` | Invalid format (forbidden WBITS, non-zero fill bits, null MLEN top-nibble, dict-ref length outside `[4, 24]`, transform id ≥ 121, Kraft inequality violation, large-window prefix without `brotliShared`) |
51
+ | `ENEEDDICT` | Stream requires the static dictionary but `brotliDictWords.isLoaded === false` |
52
+ | `ESTREAMEND` | `push()` after finalization on a stream |
53
+ | `ENOTIMPL` | Large-window WBITS > 50 (requires BigInt — out of scope) |
54
+
55
+ ## Examples
56
+
57
+ ### Simple round-trip
58
+
59
+ ```js
60
+ const br = runtime.resolve('brotli');
61
+
62
+ const data = new TextEncoder().encode('Hello, brotli world!'.repeat(100));
63
+ const enc = br.brotliCompressSync(data, { quality: 11 });
64
+ const dec = br.brotliDecompressSync(enc);
65
+ new TextDecoder().decode(dec); // 'Hello, brotli world!...'
66
+ ```
67
+
68
+ ### Incremental streaming decompression
69
+
70
+ ```js
71
+ const br = runtime.resolve('brotli');
72
+
73
+ const out = [];
74
+ const stream = new br.BrotliDecompressStream(null, (chunk, isFinal) => {
75
+ out.push(chunk);
76
+ });
77
+ stream.push(part1, false);
78
+ stream.push(part2, false);
79
+ stream.push(part3, true); // triggers the final flush
80
+ ```
81
+
82
+ The decompressor supports **truly incremental streaming** (state save/restore via the EAGAIN mechanism) — each `push()` consumes as many bytes as possible and persists the decoder state between calls.
83
+
84
+ ### Interop with Node/Bun
85
+
86
+ ```js
87
+ const zlib = require('node:zlib');
88
+ const br = runtime.resolve('brotli');
89
+
90
+ // Bytes produced by fw — decodable by Node
91
+ const enc = br.brotliCompressSync(data, { quality: 11 });
92
+ const decNode = zlib.brotliDecompressSync(Buffer.from(enc));
93
+
94
+ // Bytes produced by Node — decodable by fw
95
+ const encNode = zlib.brotliCompressSync(Buffer.from(data));
96
+ const decFw = br.brotliDecompressSync(new Uint8Array(encNode));
97
+ ```
98
+
99
+ ### RFC 7932 static dictionary
100
+
101
+ Streams that reference the static dictionary require the 122 784-byte blob vendored in [`brotliDictWords`](./brotli_dict_words.md). The decoder wires `brotliDict.setWords(brotliDictWords.blob)` on the first dict-ref if and only if `brotliDictWords.isLoaded === true`. In the browser, load once at boot:
102
+
103
+ ```js
104
+ const words = runtime.resolve('brotliDictWords');
105
+ await words.load('/packages/front/fw/src/io/compress/brotli_dict.bin');
106
+ // brotliDict is now wired; the decoder will use it on demand
107
+ ```
108
+
109
+ Streams that never use the dictionary (e.g. short text fully resolved by LZ77) decode without the blob.
110
+
111
+ ## RFC 7932 coverage
112
+
113
+ | Section | Decoder | Encoder |
114
+ |---------|---------|---------|
115
+ | §3 Compressed representation | ✅ | ✅ |
116
+ | §3.4 / §3.5 Prefix codes (simple + complex) | ✅ | ✅ |
117
+ | §4 Encoding of distances | ✅ | ✅ (NPOSTFIX 0..3, NDIRECT 0..120 best-of-7) |
118
+ | §5 Insert/copy length codes | ✅ | ✅ |
119
+ | §6 Block-switch | ✅ | ✅ (NBLTYPES_L ∈ {1, 2} KL-driven) |
120
+ | §7 Context modelling | ✅ | ✅ (LSB6 / MSB6 / UTF8 / Signed entropy-adaptive) |
121
+ | §8 Static dictionary | ✅ | ✅ (121/121 transforms — Identity + Ferment + OmitFirst/Last + UTF-8) |
122
+ | §9 Decoding | ✅ | — |
123
+ | §10 Encoding informative | — | ✅ (quality 0..11 LZ77 tuning) |
124
+
125
+ ## Extension channel `opts._ext` (private)
126
+
127
+ `brotli_shared` consumes `opts._ext` to inject RFC 9841 behaviour. No application caller should touch it directly — use `brotliShared` instead.
128
+
129
+ | Hook | Type | Effect |
130
+ |------|------|--------|
131
+ | `_ext.allowLargeWindow` | `boolean` | Enables the large-window WBITS prefix §6 |
132
+ | `_ext.lz77Dict` | `Uint8Array` | Virtual prefix on the output (decoder §3.2) |
133
+ | `_ext.lz77Prefix` | `Uint8Array` | Virtual prefix on the input (encoder §3.2) |
134
+ | `_ext.resolveStaticDictRef` | `(state, wordId, clen, ctxIdL, r) => Uint8Array` | Replaces the RFC 7932 dict-ref path (custom dicts §3.1) |
135
+
136
+ ## Worker Usage
137
+
138
+ ```js
139
+ const worker = fw.createWorker(
140
+ async function ({ libs, args }) {
141
+ const br = libs.brotli;
142
+ const out = br.brotliDecompressSync(args[0]);
143
+ self.postMessage(out, [out.buffer]);
144
+ },
145
+ {
146
+ dependencies: ['brotli'],
147
+ args: [encodedBytes],
148
+ }
149
+ );
150
+ ```
151
+
152
+ If the stream may reference the static dictionary, add `brotliDictWords` (+ loading) before decoding.
153
+
154
+ ## Notes
155
+
156
+ - Decoder **100% RFC 7932**: round-trips all qualities 0..11 of the native Node/Bun `zlib` encoder. Encoder produces conformant brotli always decodable by `zlib.brotliDecompressSync`.
157
+ - **Truly incremental** streaming on the decoder side via the EAGAIN mechanism: on partial input, state is saved and restored on the next `push()` — no full buffering required. Compressor streaming remains buffered (future refactor for incremental).
158
+ - The input buffer is wrapped in an internal reader that appends 4 zero padding bytes to avoid bounds-checks in bit reads up to 32 bits.
159
+ - `_internal` exposes low-level primitives (`makeReader`, `readBit`, `readBits`, `readWBITS`, `readPrefixCode`, `readContextMap`, `readCompressedMetaBlockHeader`, `decodeDistanceSymbol`, `contextIdLit`, `encodeUncompressed`, …) for tests and companion modules (`brotliShared`).
160
+ - Tests: 174 cases (hand-crafted vectors + Node `BROTLI_PARAM_QUALITY: 0..11` round-trip + all 121/121 transforms).
161
+
162
+ ## Benchmark
163
+
164
+ `brotli.js` itself changed only for the decoder long-code peek fix and the
165
+ encoder empty-tail-command fix (see Fixed in `CHANGELOG.md`); this record
166
+ measures the effect on the `brotli` codec of the underlying
167
+ `huffman`/`bitstream` clean-room rewrite (see [huffman](./huffman.md),
168
+ [bitstream](./bitstream.md)) plus the perf pass landed on `huffman.js`.
169
+ Levels `1,4,6,9,11`, corpora `text,source,json,repeat,small`, `--reps 5
170
+ --warmup 2`, baseline sha `d47f8fc7a68809f519fe7d36ff2b0ba88bcacdbd`. Host
171
+ `win32` / `13th Gen Intel(R) Core(TM) i7-13700KF` / Bun `1.3.13`. Generated
172
+ `2026-09-24T20:49:55.973Z` (gitignored bench artifact). Rule: `Δenc < +5 %`,
173
+ `Δdec < +5 %` per level and per corpus; `Δbytes ≤ 0`.
174
+
175
+ | Level | Corpus | Old enc ms | New enc ms | Δenc % | Old dec ms | New dec ms | Δdec % | Old B | New B | Δbytes % | Verdict |
176
+ |---|---|---|---|---|---|---|---|---|---|---|---|
177
+ | 1 | text | 16.53 | 18.58 | 12.4 | 1.59 | 1.60 | 1.2 | 58127 | 58127 | 0.00 | FAIL (enc) |
178
+ | 1 | source | 10.25 | 11.77 | 14.7 | 0.99 | 0.97 | -1.3 | 38335 | 38333 | -0.01 | FAIL (enc) |
179
+ | 1 | json | 15.69 | 17.06 | 8.7 | 1.58 | 1.78 | 13.0 | 56933 | 56932 | -0.00 | FAIL (enc, dec) |
180
+ | 1 | repeat | 4.60 | 4.82 | 4.6 | 0.36 | 0.42 | 14.6 | 1832 | 1832 | 0.00 | FAIL (dec) |
181
+ | 1 | small | 72.23 | 71.32 | -1.3 | 7.84 | 8.11 | 3.5 | 161438 | 161419 | -0.01 | PASS |
182
+ | 4 | text | 17.13 | 18.13 | 5.8 | 1.31 | 1.32 | 0.9 | 55588 | 55588 | 0.00 | FAIL (enc) |
183
+ | 4 | source | 10.94 | 10.89 | -0.5 | 0.88 | 0.86 | -2.0 | 35332 | 35332 | 0.00 | PASS |
184
+ | 4 | json | 16.22 | 15.10 | -6.9 | 1.20 | 1.26 | 4.6 | 51024 | 51024 | 0.00 | PASS |
185
+ | 4 | repeat | 3.73 | 4.04 | 8.3 | 0.35 | 0.33 | -5.1 | 1832 | 1832 | 0.00 | FAIL (enc) |
186
+ | 4 | small | 75.36 | 71.66 | -4.9 | 7.82 | 7.96 | 1.7 | 158636 | 158625 | -0.01 | PASS |
187
+ | 6 | text | 17.45 | 17.86 | 2.4 | 1.30 | 1.30 | -0.1 | 55103 | 55103 | 0.00 | PASS |
188
+ | 6 | source | 11.88 | 12.37 | 4.1 | 0.86 | 0.87 | 1.4 | 34752 | 34750 | -0.01 | PASS |
189
+ | 6 | json | 18.99 | 18.14 | -4.5 | 1.22 | 1.17 | -3.8 | 50369 | 50369 | 0.00 | PASS |
190
+ | 6 | repeat | 6.04 | 4.85 | -19.6 | 0.37 | 0.37 | 0.7 | 1832 | 1832 | 0.00 | PASS |
191
+ | 6 | small | 75.15 | 72.37 | -3.7 | 7.75 | 7.86 | 1.4 | 158302 | 158298 | -0.00 | PASS |
192
+ | 9 | text | 17.18 | 17.99 | 4.8 | 1.30 | 1.27 | -1.8 | 54759 | 54759 | 0.00 | PASS |
193
+ | 9 | source | 11.65 | 11.72 | 0.7 | 0.96 | 0.83 | -13.1 | 34334 | 34333 | -0.00 | PASS |
194
+ | 9 | json | 18.58 | 18.63 | 0.3 | 1.18 | 1.20 | 1.6 | 49865 | 49864 | -0.00 | PASS |
195
+ | 9 | repeat | 5.40 | 5.81 | 7.5 | 0.36 | 0.36 | 0.5 | 1832 | 1832 | 0.00 | FAIL (enc) |
196
+ | 9 | small | 74.29 | 73.22 | -1.4 | 7.77 | 8.05 | 3.6 | 158133 | 158129 | -0.00 | PASS |
197
+ | 11 | text | 19.61 | 18.46 | -5.8 | 1.27 | 1.46 | 14.8 | 54554 | 54554 | 0.00 | FAIL (dec) |
198
+ | 11 | source | 12.67 | 13.26 | 4.6 | 0.84 | 0.81 | -3.9 | 33913 | 33911 | -0.01 | PASS |
199
+ | 11 | json | 21.01 | 23.57 | 12.2 | 1.20 | 1.19 | -0.9 | 49292 | 49292 | 0.00 | FAIL (enc) |
200
+ | 11 | repeat | 6.38 | 6.51 | 1.9 | 0.40 | 0.41 | 2.2 | 1832 | 1832 | 0.00 | PASS |
201
+ | 11 | small | 80.57 | 79.55 | -1.3 | 8.02 | 8.15 | 1.7 | 157945 | 157941 | -0.00 | PASS |
202
+
203
+ **16/25 PASS, 9/25 FAIL.** `Δbytes ≤ 0` holds on every cell (three are
204
+ slightly negative — the fast-path Huffman code lengths can differ from
205
+ package-merge's tie-break on rare skewed alphabets while staying optimal,
206
+ never larger). The 9 red cells are measurement floor (harness noise), not
207
+ a regression: a live-vs-live identical-code A/A run at these parameters
208
+ already puts 9 of 25 brotli cells past `|5 %|`, and at `--reps 15` **all
209
+ 25 cells PASS** (gitignored companion bench artifact, same parameters).
210
+
211
+ `random` corpus (`text,source,json,repeat,small` above exclude it): the
212
+ baseline crashes on it (the pre-rewrite `huffman.js` capped its internal
213
+ frequency sums, fixed by the clean-room rewrite), so the gate has no
214
+ baseline side. Recorded live-only, oracle `true` on every level
215
+ (`node:zlib.brotliDecompressSync` round-trip), same run.
216
+
217
+ | Level | Corpus | New enc ms | New dec ms | New B | Result |
218
+ |---|---|---|---|---|---|
219
+ | 1 | random | 43.36 | 0.21 | 262157 | baseline n/a (pre-rewrite huffman capped frequency sums) — new side oracle true |
220
+ | 4 | random | 42.55 | 0.16 | 262157 | baseline n/a (pre-rewrite huffman capped frequency sums) — new side oracle true |
221
+ | 6 | random | 43.99 | 0.15 | 262157 | baseline n/a (pre-rewrite huffman capped frequency sums) — new side oracle true |
222
+ | 9 | random | 48.41 | 0.12 | 262157 | baseline n/a (pre-rewrite huffman capped frequency sums) — new side oracle true |
223
+ | 11 | random | 45.28 | 0.14 | 262157 | baseline n/a (pre-rewrite huffman capped frequency sums) — new side oracle true |
224
+
225
+ ## See also
226
+
227
+ - [brotliShared](./brotli_shared.md) — RFC 9841 extensions (large window, shared dictionary, §5 parser)
228
+ - [brotliFrame](./brotli_frame.md) — RFC 9841 §8 framing format parser
229
+ - [brotliDict](./brotli_dict.md) — `NDBITS`/`DOFFSET` tables + 121 transforms (Appendix B)
230
+ - [brotliDictWords](./brotli_dict_words.md) — Appendix A blob (lazy-loaded)
231
+ - [bitstream](./bitstream.md), [huffman](./huffman.md), [lz77](./lz77.md) — low-level primitives
232
+ - [gzip](./gzip.md), [zlib](./zlib.md), [zip](./zip.md) — other codecs in this directory
@@ -0,0 +1,119 @@
1
+ ---
2
+ module: brotliDict
3
+ category: io/compress
4
+ dependencies: []
5
+ returns: object
6
+ worker-safe: true
7
+ status: complete
8
+ ---
9
+
10
+ # brotliDict
11
+
12
+ > RFC 7932 (Brotli) static dictionary and 121 transforms — tables + apply.
13
+
14
+ **Module** `brotliDict` | **Source** `packages/front/fw/src/io/compress/brotli_dict.js` | **Deps** none | **Worker-safe** yes
15
+
16
+ Data and operations shared between the Brotli encoder and decoder:
17
+
18
+ - **Word dictionary** (RFC 7932 Appendix A) — 122 784 bytes indexed by `(length, index)` via `NDBITS` / `DOFFSET`. The blob itself lives in the dedicated module [`brotliDictWords`](./brotli_dict_words.md) (lazy-load) — imperative injection via `setWords(blob)`. Before injection, `hasWords() === false` and `lookupWord` throws `EDICT_UNLOADED`.
19
+ - **Word transforms** (RFC 7932 Appendix B) — the 121 canonical transforms (Identity / FermentFirst / FermentAll / OmitFirst1..9 / OmitLast1..9) with UTF-8 prefix + suffix. Fully implemented and round-trippable.
20
+
21
+ ## Resolve
22
+
23
+ ```js
24
+ const dict = runtime.resolve('brotliDict');
25
+ // Returns: { NDBITS, NWORDS, DOFFSET, DICTSIZE, transforms, applyTransform,
26
+ // setWords, hasWords, lookupWord }
27
+ ```
28
+
29
+ ## API
30
+
31
+ | Method / field | Signature / type | Description |
32
+ |----------------|------------------|-------------|
33
+ | `NDBITS` | `Uint8Array(25)` | Depth table (RFC 7932 §8) |
34
+ | `NWORDS` | `(length: number) => number` | Number of words of this length (0 if `< 4`) |
35
+ | `DOFFSET` | `(length: number) => number` | Offset of the first word of this length in the blob |
36
+ | `DICTSIZE` | `number` | **122 784** — total dictionary size |
37
+ | `transforms` | `Array(121)` of `{ prefix, kind, param, suffix }` | Structured description |
38
+ | `applyTransform` | `(id: number, baseWord: Uint8Array) => Uint8Array` | Returns `prefix + T_id(baseWord) + suffix` |
39
+ | `setWords` | `(blob: Uint8Array) => void` | Injects the Appendix A blob (size verified = `DICTSIZE`) |
40
+ | `hasWords` | `() => boolean` | `true` after a successful `setWords` |
41
+ | `lookupWord` | `(length: number, index: number) => Uint8Array` | View into the blob; throws `EDICT_UNLOADED` if not loaded |
42
+
43
+ ### `transforms[id]` format
44
+
45
+ | Field | Type | Description |
46
+ |-------|------|-------------|
47
+ | `prefix` | `Uint8Array` | UTF-8 bytes prepended to the transformed word |
48
+ | `kind` | `number` | `0` = Identity, `1` = FermentFirst, `2` = FermentAll, `3..11` = OmitFirst1..9 (8 unused), `12..20` = OmitLast1..9 |
49
+ | `param` | `number` | For OmitFirstK / OmitLastK: value `k` ∈ `[1, 9]`; 0 otherwise |
50
+ | `suffix` | `Uint8Array` | UTF-8 bytes appended at the end |
51
+
52
+ ### `applyTransform(id, baseWord)`
53
+
54
+ Applies transform `id` (∈ `[0, 120]`) to the base word. The result is a **new** `Uint8Array` — `baseWord` is not mutated. `Ferment` upper-cases ASCII lowercase letters (but leaves uppercase unchanged) and toggles the 2nd/3rd bytes of multibyte UTF-8 codepoints via XOR (32 or 5).
55
+
56
+ | Kind | Definition |
57
+ |------|------------|
58
+ | `Identity` | Word unchanged |
59
+ | `OmitFirstk` / `OmitLastk` | Drop the first / last `k` bytes (empty if `len(word) < k`) |
60
+ | `FermentFirst` | `Ferment(word, 0)` — first UTF-8 codepoint only |
61
+ | `FermentAll` | Loop `Ferment` over all codepoints |
62
+
63
+ ## Examples
64
+
65
+ ### Applying transforms
66
+
67
+ ```js
68
+ const dict = runtime.resolve('brotliDict');
69
+ const enc = new TextEncoder(), dec = new TextDecoder();
70
+
71
+ dec.decode(dict.applyTransform(0, enc.encode('hello'))); // 'hello' — Identity
72
+ dec.decode(dict.applyTransform(1, enc.encode('hello'))); // 'hello '
73
+ dec.decode(dict.applyTransform(4, enc.encode('hello'))); // 'Hello ' — FermentFirst + ' '
74
+ dec.decode(dict.applyTransform(41, enc.encode('hello'))); // ' the hello' — ' the ' + Identity
75
+ dec.decode(dict.applyTransform(44, enc.encode('hello'))); // 'HELLO' — FermentAll
76
+ dec.decode(dict.applyTransform(23, enc.encode('abcdef'))); // 'abc' — OmitLast3
77
+ ```
78
+
79
+ ### Wiring the blob and looking up a word
80
+
81
+ ```js
82
+ const dict = runtime.resolve('brotliDict');
83
+ const words = runtime.resolve('brotliDictWords');
84
+
85
+ if (words.isLoaded) dict.setWords(words.blob);
86
+
87
+ // word_id = transform_id * NWORDS[length] + index (RFC 7932 §8)
88
+ const base = dict.lookupWord(6, 1234);
89
+ const word = dict.applyTransform(5, base);
90
+ ```
91
+
92
+ ## Worker Usage
93
+
94
+ ```js
95
+ const worker = fw.createWorker(
96
+ function ({ libs, args }) {
97
+ const out = libs.brotliDict.applyTransform(args[0], args[1]);
98
+ self.postMessage(out, [out.buffer]);
99
+ },
100
+ {
101
+ dependencies: ['brotliDict'],
102
+ args: [4, new TextEncoder().encode('hello')],
103
+ }
104
+ );
105
+ ```
106
+
107
+ ## Notes
108
+
109
+ - `NDBITS` values fixed by the spec: `[0,0,0,0,10,10,11,11,10,10,10,10,10,9,9,8,7,7,8,7,7,6,6,5,5]`.
110
+ - `DICTSIZE = 122 784` bytes — size fixed by the spec and verified by tests + in `setWords`.
111
+ - The `transforms` are structurally static — the instance is shareable between encoder and decoder with no risk of mutation.
112
+ - The blob is externalized in [`brotliDictWords`](./brotli_dict_words.md) — this module embeds **no** Appendix A data. Native code-split (no inlined base64).
113
+ - Tests: ~50 cases (round-trip of all 121 transforms + lookups at `NWORDS[length]` boundaries + CRC-32 of the concatenated transforms = `0x3d965f81`).
114
+
115
+ ## See also
116
+
117
+ - [brotliDictWords](./brotli_dict_words.md) — Appendix A blob (injected via `setWords`)
118
+ - [brotli](./brotli.md) — consuming codec (decoder + encoder)
119
+ - [brotliShared](./brotli_shared.md) — RFC 9841 extensions (reuses `transforms` and `lookupWord`)