@stacksjs/stx 0.2.852 → 0.2.853

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 (511) hide show
  1. package/dist/a11y.d.ts +1 -1
  2. package/dist/analytics.d.ts +1 -1
  3. package/dist/animation.d.ts +1 -44
  4. package/dist/api-client.d.ts +1 -0
  5. package/dist/app-shell.d.ts +2 -2
  6. package/dist/app.d.ts +1 -1
  7. package/dist/application-layers.d.ts +1 -1
  8. package/dist/assets.d.ts +1 -1
  9. package/dist/ast.d.ts +23 -1
  10. package/dist/broadcasting.d.ts +1 -1
  11. package/dist/browser-composables.d.ts +1 -0
  12. package/dist/build-externalize-repeated.d.ts +1 -1
  13. package/dist/build-id.d.ts +1 -0
  14. package/dist/build-views.d.ts +1 -1
  15. package/dist/build.d.ts +3 -3
  16. package/dist/builtins/attrs.d.ts +1 -1
  17. package/dist/builtins/drawer.d.ts +2 -2
  18. package/dist/builtins/icon.d.ts +2 -13
  19. package/dist/builtins/image-delivery.d.ts +1 -1
  20. package/dist/builtins/image-worker.d.ts +2 -2
  21. package/dist/builtins/index.d.ts +22 -22
  22. package/dist/builtins/modal.d.ts +2 -2
  23. package/dist/builtins/safe-image.d.ts +2 -2
  24. package/dist/builtins/stx-image.d.ts +2 -43
  25. package/dist/builtins/stx-link.d.ts +1 -10
  26. package/dist/builtins/stx-loading-indicator.d.ts +1 -13
  27. package/dist/builtins/suspense.d.ts +1 -8
  28. package/dist/builtins/toast.d.ts +2 -3
  29. package/dist/builtins/transition-group.d.ts +1 -2
  30. package/dist/bundle-analyzer/index.d.ts +6 -6
  31. package/dist/bundle-analyzer/report.d.ts +1 -1
  32. package/dist/bundle-analyzer/treemap.d.ts +1 -1
  33. package/dist/caching.d.ts +4 -4
  34. package/dist/chunk-05f4tjsq.js +2 -0
  35. package/dist/{chunk-422r7zkx.js → chunk-0hegjagg.js} +2 -2
  36. package/dist/{chunk-6tns3zet.js → chunk-0wxmmvj0.js} +3 -3
  37. package/dist/chunk-0xwmweqm.js +2 -0
  38. package/dist/chunk-0yc4p3y2.js +2 -0
  39. package/dist/chunk-161p0zcy.js +2 -0
  40. package/dist/chunk-28r4jyvj.js +2 -0
  41. package/dist/{chunk-gwdffrz6.js → chunk-2rxr5cj6.js} +3 -3
  42. package/dist/{chunk-s0pnyd2f.js → chunk-33ph9zb2.js} +4 -4
  43. package/dist/chunk-3b9950gz.js +2 -0
  44. package/dist/chunk-46mw2r3k.js +2 -0
  45. package/dist/chunk-48z6w533.js +3 -0
  46. package/dist/{chunk-88392kaj.js → chunk-4nhbbcr9.js} +5 -5
  47. package/dist/{chunk-f5n871gp.js → chunk-4wx7refk.js} +4 -4
  48. package/dist/chunk-4zkk63v3.js +2 -0
  49. package/dist/{chunk-kp2g6sj6.js → chunk-52szcd15.js} +1 -1
  50. package/dist/chunk-5758n8sm.js +2 -0
  51. package/dist/{chunk-fffjjgnt.js → chunk-5erremft.js} +2 -2
  52. package/dist/{chunk-r0k5jbvk.js → chunk-5fdpg861.js} +1 -1
  53. package/dist/{chunk-k47addf7.js → chunk-5g1jwxny.js} +9 -9
  54. package/dist/{chunk-fkrf2099.js → chunk-5pft38qa.js} +2 -2
  55. package/dist/chunk-5t8xpkwc.js +2 -0
  56. package/dist/{chunk-aas25pac.js → chunk-63rvsnt2.js} +3 -3
  57. package/dist/chunk-6bm19d4k.js +2 -0
  58. package/dist/chunk-6c45vx1e.js +2 -0
  59. package/dist/chunk-6vc1dwqt.js +2 -0
  60. package/dist/chunk-76b6m6n0.js +2 -0
  61. package/dist/{chunk-qev14f76.js → chunk-7kc9xwht.js} +3 -3
  62. package/dist/{chunk-42hj9jnj.js → chunk-7rtvravz.js} +7 -7
  63. package/dist/{chunk-hh9hnx1a.js → chunk-7wwq1btb.js} +1 -1
  64. package/dist/{chunk-pbq1gn94.js → chunk-83d468me.js} +4 -4
  65. package/dist/{chunk-r53tqxmq.js → chunk-8cg88x7m.js} +39 -39
  66. package/dist/chunk-8fprfzcn.js +2 -0
  67. package/dist/{chunk-tn9h4prj.js → chunk-8g0243g1.js} +3 -3
  68. package/dist/chunk-9h1w4py6.js +2 -0
  69. package/dist/{chunk-tt3jxdy5.js → chunk-9mzskb69.js} +3 -3
  70. package/dist/{chunk-8cvgm13s.js → chunk-9r999ees.js} +2 -2
  71. package/dist/{chunk-2d7e5g92.js → chunk-9z7fnv33.js} +1 -1
  72. package/dist/{chunk-818kkhb8.js → chunk-a0ahcd1g.js} +2 -2
  73. package/dist/chunk-aajezypd.js +2 -0
  74. package/dist/{chunk-714p8awg.js → chunk-agvm20mz.js} +3 -3
  75. package/dist/{chunk-3bp76dx5.js → chunk-baxrx1rz.js} +9 -9
  76. package/dist/{chunk-xndr2dx9.js → chunk-bkefg64w.js} +5 -5
  77. package/dist/{chunk-n2z4kyba.js → chunk-bqxrfagh.js} +1 -1
  78. package/dist/chunk-bz4bskx3.js +2 -0
  79. package/dist/chunk-bze3ksvb.js +2 -0
  80. package/dist/chunk-c2et7w0g.js +2 -0
  81. package/dist/{chunk-c1dkvqr5.js → chunk-c54bhqrg.js} +39 -39
  82. package/dist/{chunk-keeetray.js → chunk-c9k0yhyq.js} +2 -2
  83. package/dist/{chunk-g34tj6ny.js → chunk-cabdpgxg.js} +3 -3
  84. package/dist/{chunk-e0dgx3ev.js → chunk-cf7dk9ev.js} +10 -10
  85. package/dist/chunk-cfmjtyzm.js +2 -0
  86. package/dist/{chunk-h9gjt73q.js → chunk-csgfws3j.js} +2 -2
  87. package/dist/{chunk-scaawv2r.js → chunk-csksn1kg.js} +2 -2
  88. package/dist/{chunk-t23jn83r.js → chunk-ctb1bj28.js} +2 -2
  89. package/dist/chunk-cxf0rzv6.js +2 -0
  90. package/dist/{chunk-axga9ebe.js → chunk-d4gy4yz0.js} +2 -2
  91. package/dist/chunk-dee5mtdv.js +2 -0
  92. package/dist/chunk-dm10y06z.js +2 -0
  93. package/dist/chunk-dw9vnhc4.js +2 -0
  94. package/dist/chunk-e5vbwsty.js +2 -0
  95. package/dist/chunk-e64m5ayt.js +2 -0
  96. package/dist/{chunk-z33esms3.js → chunk-ehp792dy.js} +2 -2
  97. package/dist/{chunk-tm1ec751.js → chunk-f9thwm8c.js} +4 -4
  98. package/dist/chunk-faf3gh3j.js +2 -0
  99. package/dist/chunk-fbakngjt.js +2 -0
  100. package/dist/{chunk-amerebya.js → chunk-fhrvxfq9.js} +2 -2
  101. package/dist/{chunk-pkq96sqk.js → chunk-fj5jw2jd.js} +6 -6
  102. package/dist/chunk-fn2cjkp0.js +2 -0
  103. package/dist/{chunk-m05pqmcj.js → chunk-fphnst8a.js} +5 -5
  104. package/dist/chunk-fsg958xx.js +2 -0
  105. package/dist/{chunk-1pavg6q5.js → chunk-fxt9vwdw.js} +38 -38
  106. package/dist/chunk-g976n4r1.js +2 -0
  107. package/dist/chunk-gn1dmfdv.js +2 -0
  108. package/dist/chunk-gsn5vvw4.js +2 -0
  109. package/dist/chunk-hmys6w75.js +2 -0
  110. package/dist/chunk-hqtj4ngq.js +2 -0
  111. package/dist/chunk-hwq24mwt.js +2 -0
  112. package/dist/{chunk-0rszcb0m.js → chunk-j1yjbykm.js} +6 -6
  113. package/dist/{chunk-frhdk0p9.js → chunk-j2wcawmf.js} +2 -2
  114. package/dist/{chunk-k7dvn2r8.js → chunk-jr346anv.js} +2 -2
  115. package/dist/{chunk-d5m6xy9p.js → chunk-jtpqqxzb.js} +6 -6
  116. package/dist/chunk-jy5fezyr.js +2 -0
  117. package/dist/chunk-kfq4mwem.js +2 -0
  118. package/dist/chunk-kgrvvtcy.js +3 -0
  119. package/dist/chunk-kkk1dtq6.js +2 -0
  120. package/dist/chunk-knd3m4t4.js +2 -0
  121. package/dist/{chunk-jtccqpwa.js → chunk-kvafq9gy.js} +2 -2
  122. package/dist/chunk-m3kc2a3v.js +2 -0
  123. package/dist/{chunk-7x6aqvfe.js → chunk-m9n3ahsy.js} +2 -2
  124. package/dist/{chunk-1sedjgmj.js → chunk-mdsc3rz1.js} +2 -2
  125. package/dist/chunk-mjp2sp74.js +2 -0
  126. package/dist/{chunk-g046t3hb.js → chunk-mmdqdkbd.js} +1 -1
  127. package/dist/{chunk-caehra7e.js → chunk-mpmnbvy4.js} +5 -5
  128. package/dist/chunk-mx79sfyr.js +2 -0
  129. package/dist/chunk-n6w82yf2.js +2 -0
  130. package/dist/{chunk-qjc3qjyf.js → chunk-n77xrpv9.js} +2 -2
  131. package/dist/{chunk-2stgv8kd.js → chunk-n8qd1n8w.js} +3 -3
  132. package/dist/{chunk-agbkv9ab.js → chunk-ngnvyqk3.js} +2 -2
  133. package/dist/{chunk-9gzgfj19.js → chunk-nyqvtca1.js} +4 -4
  134. package/dist/{chunk-te090fxv.js → chunk-nz202f97.js} +4 -4
  135. package/dist/chunk-pd3wzh2x.js +2 -0
  136. package/dist/chunk-pj3xwwtg.js +2 -0
  137. package/dist/{chunk-gsrdjmw9.js → chunk-pm241ehv.js} +2 -2
  138. package/dist/{chunk-8vjr3atq.js → chunk-prfrqfae.js} +2 -2
  139. package/dist/chunk-q1z8edtn.js +2 -0
  140. package/dist/{chunk-3wkgd883.js → chunk-qkcn0exq.js} +6 -6
  141. package/dist/{chunk-m710wkr4.js → chunk-qnyh0m22.js} +1 -1
  142. package/dist/{chunk-e85wsz8y.js → chunk-r69en2jg.js} +1 -1
  143. package/dist/{chunk-833y1ndd.js → chunk-rbxbgvkf.js} +1 -1
  144. package/dist/{chunk-tgk6bst6.js → chunk-rmeey2xa.js} +4 -4
  145. package/dist/{chunk-0kaph5qq.js → chunk-rrppkyv0.js} +42 -42
  146. package/dist/{chunk-whdy7r35.js → chunk-rw7q2a3c.js} +9 -9
  147. package/dist/chunk-s4c1mq0r.js +2 -0
  148. package/dist/chunk-sx1prttb.js +2 -0
  149. package/dist/chunk-syww37qd.js +2 -0
  150. package/dist/{chunk-6p62jjzm.js → chunk-t3a3wbjk.js} +2 -2
  151. package/dist/{chunk-0dnetjh8.js → chunk-te82sjhy.js} +48 -48
  152. package/dist/{chunk-2rg9pqmh.js → chunk-tm8a2b69.js} +4 -4
  153. package/dist/{chunk-w7dks1ev.js → chunk-trxha300.js} +5 -5
  154. package/dist/{chunk-tbms7m44.js → chunk-txdxfjbj.js} +3 -3
  155. package/dist/{chunk-m150nmez.js → chunk-vpqgg04q.js} +1 -1
  156. package/dist/{chunk-02w7kaas.js → chunk-vtzkqsq1.js} +17 -17
  157. package/dist/chunk-vw9h1x2m.js +2 -0
  158. package/dist/{chunk-e105xsee.js → chunk-w7p34cr3.js} +1 -1
  159. package/dist/{chunk-sb8vn22f.js → chunk-x1w19y3w.js} +4 -4
  160. package/dist/chunk-x2vybq9n.js +2 -0
  161. package/dist/chunk-x8jsmwhg.js +2 -0
  162. package/dist/chunk-xa9mkdn7.js +2 -0
  163. package/dist/{chunk-gn6yqcz2.js → chunk-xzdjhjz4.js} +4 -4
  164. package/dist/{chunk-kd06c90f.js → chunk-ya6f7mt5.js} +4 -4
  165. package/dist/{chunk-0b7knfwk.js → chunk-zjfp64v7.js} +1 -1
  166. package/dist/{chunk-cm5kpn54.js → chunk-zqpjqcm8.js} +5 -5
  167. package/dist/chunk-zzzqnf9k.js +2 -0
  168. package/dist/cli.js +41 -41
  169. package/dist/client/directive.d.ts +1 -1
  170. package/dist/client/index.d.ts +1 -1
  171. package/dist/client-script-bundler.d.ts +1 -1
  172. package/dist/client-script.d.ts +5 -5
  173. package/dist/client.d.ts +1 -0
  174. package/dist/component-client-factories.d.ts +1 -0
  175. package/dist/component-contract-checks.d.ts +1 -1
  176. package/dist/component-hmr.d.ts +17 -0
  177. package/dist/component-library.d.ts +1 -1
  178. package/dist/component-model.d.ts +1 -1
  179. package/dist/component-processing.d.ts +4 -4
  180. package/dist/component-registry.d.ts +2 -2
  181. package/dist/component-renderer.d.ts +3 -3
  182. package/dist/components.d.ts +1 -1
  183. package/dist/composables/index.d.ts +47 -47
  184. package/dist/composables/use-ambient-sound.d.ts +38 -1
  185. package/dist/composables/use-broadcast-channel.d.ts +1 -0
  186. package/dist/composables/use-cached-query.d.ts +3 -3
  187. package/dist/composables/use-completion.d.ts +1 -1
  188. package/dist/composables/use-cookie.d.ts +1 -1
  189. package/dist/composables/use-eye-dropper.d.ts +1 -0
  190. package/dist/composables/use-fetch.d.ts +2 -2
  191. package/dist/composables/use-form.d.ts +2 -2
  192. package/dist/composables/use-intersection-observer.d.ts +1 -0
  193. package/dist/composables/use-keyboard.d.ts +21 -20
  194. package/dist/composables/use-media-query.d.ts +5 -5
  195. package/dist/composables/use-notification.d.ts +0 -9
  196. package/dist/composables/use-permissions.d.ts +0 -10
  197. package/dist/composables/use-scroll-lock.d.ts +2 -1
  198. package/dist/composables/use-share.d.ts +0 -4
  199. package/dist/composables/use-speech.d.ts +1 -0
  200. package/dist/composables/use-storage.d.ts +1 -1
  201. package/dist/composables/use-timer.d.ts +4 -4
  202. package/dist/composables/use-virtual-list.d.ts +1 -1
  203. package/dist/composables/use-websocket.d.ts +1 -0
  204. package/dist/composables.d.ts +3 -3
  205. package/dist/config.d.ts +18 -1
  206. package/dist/config.js +9 -2
  207. package/dist/craft-compiler.d.ts +1 -5
  208. package/dist/craft-components.d.ts +2 -6
  209. package/dist/craft-entry.d.ts +5 -5
  210. package/dist/craft-entry.js +2 -2
  211. package/dist/craft-ssr.d.ts +1 -1
  212. package/dist/craft.js +2 -2
  213. package/dist/csp.d.ts +1 -1
  214. package/dist/custom-directives.d.ts +1 -1
  215. package/dist/database.d.ts +21 -1
  216. package/dist/deploy/index.d.ts +6 -6
  217. package/dist/dev-server/index.d.ts +7 -7
  218. package/dist/dev-server/serve-app.d.ts +1 -1
  219. package/dist/dev-server/serve-file.d.ts +1 -1
  220. package/dist/dev-server/serve-markdown.d.ts +1 -1
  221. package/dist/dev-server/serve-multi.d.ts +1 -1
  222. package/dist/dev-server/terminal-colors.d.ts +25 -25
  223. package/dist/dev-server/ts-css.d.ts +1 -1
  224. package/dist/dev-server/types.d.ts +1 -1
  225. package/dist/dev-server.d.ts +5 -5
  226. package/dist/directive-api.d.ts +1 -1
  227. package/dist/directive-arguments.d.ts +1 -1
  228. package/dist/docs.d.ts +2 -2
  229. package/dist/document-shell.d.ts +2 -2
  230. package/dist/dynamic-components.d.ts +1 -1
  231. package/dist/edge-runtime.d.ts +1 -1
  232. package/dist/engine-bindings.d.ts +1 -1
  233. package/dist/error-handling.d.ts +1 -1
  234. package/dist/errors/codes.d.ts +28 -28
  235. package/dist/errors/formatter.d.ts +2 -2
  236. package/dist/errors/index.d.ts +5 -5
  237. package/dist/errors/logger.d.ts +14 -1
  238. package/dist/errors/sanitizer.d.ts +13 -2
  239. package/dist/errors/types.d.ts +1 -1
  240. package/dist/expressions.d.ts +3 -36
  241. package/dist/forms-validation.d.ts +5 -1
  242. package/dist/forms.d.ts +21 -21
  243. package/dist/fragment-container.d.ts +1 -0
  244. package/dist/heatmap.d.ts +2 -5
  245. package/dist/hot-reload.d.ts +3 -0
  246. package/dist/hydration.d.ts +28 -0
  247. package/dist/i18n.d.ts +2 -1
  248. package/dist/image-optimization/build-plugin.d.ts +2 -2
  249. package/dist/image-optimization/component.d.ts +1 -1
  250. package/dist/image-optimization/directive.d.ts +3 -3
  251. package/dist/image-optimization/index.d.ts +6 -6
  252. package/dist/image-optimization/processor.d.ts +1 -0
  253. package/dist/image-optimization/serve.d.ts +2 -1
  254. package/dist/includes.d.ts +2 -2
  255. package/dist/index.d.ts +171 -171
  256. package/dist/init.d.ts +1 -0
  257. package/dist/installed-entry.d.ts +1 -1
  258. package/dist/jsx-runtime.d.ts +2 -2
  259. package/dist/lazy-loader.d.ts +5 -0
  260. package/dist/loading-indicator.d.ts +0 -2
  261. package/dist/loops.d.ts +3 -3
  262. package/dist/manifest.d.ts +2 -2
  263. package/dist/media/client/index.d.ts +6 -6
  264. package/dist/media/image/component.d.ts +1 -1
  265. package/dist/media/image/directive.d.ts +2 -2
  266. package/dist/media/image/editing.d.ts +35 -35
  267. package/dist/media/image/index.d.ts +6 -6
  268. package/dist/media/image/placeholder.d.ts +1 -1
  269. package/dist/media/image/processor/cache.d.ts +3 -2
  270. package/dist/media/image/processor/index.d.ts +4 -4
  271. package/dist/media/image/processor/optimizer.d.ts +1 -1
  272. package/dist/media/image/processor/responsive.d.ts +1 -1
  273. package/dist/media/image/srcset.d.ts +6 -6
  274. package/dist/media/index.d.ts +13 -13
  275. package/dist/media/manager/embed.d.ts +1 -1
  276. package/dist/media/protected/component.d.ts +1 -1
  277. package/dist/media/protected/index.d.ts +2 -2
  278. package/dist/media/protected/signature.d.ts +1 -1
  279. package/dist/media/shared/index.d.ts +2 -2
  280. package/dist/media/upload/component.d.ts +1 -1
  281. package/dist/media/upload/index.d.ts +1 -1
  282. package/dist/media/video/directive.d.ts +2 -2
  283. package/dist/media/video/index.d.ts +2 -2
  284. package/dist/media/video/processor/cache.d.ts +3 -2
  285. package/dist/media/video/processor/index.d.ts +5 -5
  286. package/dist/media/video/processor/streaming.d.ts +1 -1
  287. package/dist/media/video/processor/thumbnail.d.ts +1 -1
  288. package/dist/media/video/processor/transcoder.d.ts +1 -1
  289. package/dist/meta-arguments.d.ts +1 -1
  290. package/dist/middleware.d.ts +1 -1
  291. package/dist/native/bridge/protocol.d.ts +15 -14
  292. package/dist/native/cli.d.ts +1 -1
  293. package/dist/native/compiler/browser.d.ts +1 -1
  294. package/dist/native/compiler/bundle.d.ts +3 -3
  295. package/dist/native/compiler/class-table.d.ts +4 -4
  296. package/dist/native/compiler/client-script.d.ts +1 -1
  297. package/dist/native/compiler/component-mapping.d.ts +1 -1
  298. package/dist/native/compiler/design-tokens.d.ts +1 -1
  299. package/dist/native/compiler/headwind-to-style.d.ts +3 -3
  300. package/dist/native/compiler/html-to-ir.d.ts +1 -1
  301. package/dist/native/compiler/inline-style.d.ts +2 -2
  302. package/dist/native/compiler/ir.d.ts +3 -3
  303. package/dist/native/compiler/layout-chrome.d.ts +1 -1
  304. package/dist/native/compiler/render-screen.d.ts +5 -5
  305. package/dist/native/compiler/shared-scripts.d.ts +1 -1
  306. package/dist/native/compiler/svg.d.ts +1 -1
  307. package/dist/native/components/primitives.d.ts +32 -32
  308. package/dist/native/floating-actions.d.ts +1 -1
  309. package/dist/native/hot-reload/client.d.ts +26 -1
  310. package/dist/native/index.d.ts +19 -19
  311. package/dist/native/runtime/binding-tree.d.ts +8 -3
  312. package/dist/native/runtime/browser-renderer.d.ts +33 -3
  313. package/dist/native/runtime/browser-screen.d.ts +2 -2
  314. package/dist/native/runtime/compact-document.d.ts +3 -5
  315. package/dist/native/runtime/craft-bridge.d.ts +4 -3
  316. package/dist/native/runtime/craft.d.ts +1 -1
  317. package/dist/native/runtime/event-stream.d.ts +1 -0
  318. package/dist/native/runtime/initial-media-mutations.d.ts +1 -1
  319. package/dist/native/runtime/jsc-globals.d.ts +18 -32
  320. package/dist/native/runtime/native-host.d.ts +8 -8
  321. package/dist/native/runtime/navigation-chrome.d.ts +1 -1
  322. package/dist/native/runtime/overlay-presenter.d.ts +3 -2
  323. package/dist/native/runtime/shared-screen.d.ts +7 -6
  324. package/dist/native/runtime/view-operations.d.ts +1 -1
  325. package/dist/native/runtime/web-navigation.d.ts +1 -0
  326. package/dist/native/runtime/web-storage.d.ts +4 -2
  327. package/dist/native/testing-mutations.d.ts +1 -1
  328. package/dist/native/testing.d.ts +4 -3
  329. package/dist/native/testing.js +21 -2
  330. package/dist/native/ui.d.ts +37 -36
  331. package/dist/native-build.d.ts +3 -3
  332. package/dist/offline/app-service-worker.d.ts +1 -0
  333. package/dist/offline/query-cache.d.ts +2 -2
  334. package/dist/page-action.d.ts +1 -1
  335. package/dist/parser/expression-parser.d.ts +1 -1
  336. package/dist/parser/index.d.ts +4 -4
  337. package/dist/parser/tokenizer.d.ts +16 -0
  338. package/dist/performance-utils.d.ts +136 -256
  339. package/dist/plugin-system.d.ts +7 -1
  340. package/dist/precompiler.d.ts +32 -1
  341. package/dist/process.d.ts +6 -6
  342. package/dist/production-build.d.ts +36 -0
  343. package/dist/production-builder.d.ts +3 -3
  344. package/dist/production-server.d.ts +1 -1
  345. package/dist/pwa/audit.d.ts +1 -1
  346. package/dist/pwa/directives.d.ts +1 -18
  347. package/dist/pwa/icons.d.ts +1 -1
  348. package/dist/pwa/index.d.ts +10 -10
  349. package/dist/pwa/inject.d.ts +1 -1
  350. package/dist/pwa/manifest.d.ts +1 -1
  351. package/dist/pwa/offline.d.ts +1 -1
  352. package/dist/pwa/precache.d.ts +1 -1
  353. package/dist/pwa/service-worker.d.ts +1 -1
  354. package/dist/pwa/workbox-strategies.d.ts +1 -1
  355. package/dist/pwa/workbox.d.ts +1 -1
  356. package/dist/pwa.d.ts +9 -9
  357. package/dist/pwa.js +3 -3
  358. package/dist/reactive-bindings.d.ts +1 -0
  359. package/dist/render-memo.d.ts +1 -1
  360. package/dist/render.d.ts +1 -1
  361. package/dist/route-response-cache.d.ts +5 -1
  362. package/dist/route-types.d.ts +1 -0
  363. package/dist/runtime-config-loader.d.ts +1 -1
  364. package/dist/runtime-config-server.d.ts +1 -4
  365. package/dist/runtime-config-types.d.ts +2 -2
  366. package/dist/runtime-injection.d.ts +1 -1
  367. package/dist/safe-evaluator.d.ts +38 -55
  368. package/dist/script-validation.d.ts +1 -1
  369. package/dist/seo.d.ts +1 -9
  370. package/dist/serve.d.ts +1 -1
  371. package/dist/server-api.d.ts +3 -2
  372. package/dist/server-components.d.ts +2 -1
  373. package/dist/server-data.d.ts +1 -0
  374. package/dist/signal-processing.d.ts +3 -3
  375. package/dist/signals.d.ts +2 -2
  376. package/dist/site-builder/build.d.ts +1 -1
  377. package/dist/site-builder/i18n.d.ts +1 -1
  378. package/dist/site-builder/index.d.ts +9 -9
  379. package/dist/site-builder/robots.d.ts +1 -1
  380. package/dist/site-builder/router.d.ts +1 -1
  381. package/dist/site-builder/seo.d.ts +1 -1
  382. package/dist/site-builder/sitemap.d.ts +1 -1
  383. package/dist/site-builder/theme.d.ts +1 -1
  384. package/dist/source-maps.d.ts +14 -0
  385. package/dist/ssg-static-paths.d.ts +1 -1
  386. package/dist/ssg.d.ts +3 -22
  387. package/dist/ssg.js +3 -3
  388. package/dist/ssr.d.ts +2 -1
  389. package/dist/state-management.d.ts +1 -0
  390. package/dist/story/addons.d.ts +1 -1
  391. package/dist/story/analytics.d.ts +7 -0
  392. package/dist/story/auto-stories.d.ts +1 -1
  393. package/dist/story/bookmarks.d.ts +4 -0
  394. package/dist/story/collect/analyzer.d.ts +1 -1
  395. package/dist/story/collect/index.d.ts +4 -4
  396. package/dist/story/collect/parser.d.ts +1 -1
  397. package/dist/story/collect/scanner.d.ts +1 -1
  398. package/dist/story/collect/tree.d.ts +1 -1
  399. package/dist/story/commands/index.d.ts +6 -6
  400. package/dist/story/compiled-output.d.ts +1 -1
  401. package/dist/story/composition.d.ts +1 -1
  402. package/dist/story/config-watcher.d.ts +1 -1
  403. package/dist/story/config.d.ts +1 -1
  404. package/dist/story/context.d.ts +1 -1
  405. package/dist/story/controls/index.d.ts +2 -1
  406. package/dist/story/desktop-preview.d.ts +1 -1
  407. package/dist/story/docs-generator.d.ts +1 -1
  408. package/dist/story/figma-export.d.ts +1 -1
  409. package/dist/story/generator.d.ts +1 -1
  410. package/dist/story/index.d.ts +41 -41
  411. package/dist/story/interactions.d.ts +1 -1
  412. package/dist/story/output.d.ts +1 -0
  413. package/dist/story/performance.d.ts +9 -0
  414. package/dist/story/presets.d.ts +5 -0
  415. package/dist/story/props-validation.d.ts +1 -1
  416. package/dist/story/renderer.d.ts +1 -1
  417. package/dist/story/search-index.d.ts +1 -1
  418. package/dist/story/search.d.ts +1 -1
  419. package/dist/story/server.d.ts +1 -1
  420. package/dist/story/setup.d.ts +1 -1
  421. package/dist/story/snapshots.d.ts +1 -1
  422. package/dist/story/testing.d.ts +1 -1
  423. package/dist/story/theme.d.ts +1 -1
  424. package/dist/story/ts-css.d.ts +1 -1
  425. package/dist/story/ui/code-panel.d.ts +1 -1
  426. package/dist/story/ui/controls-panel.d.ts +1 -1
  427. package/dist/story/ui/index.d.ts +4 -4
  428. package/dist/story/ui/preview.d.ts +1 -1
  429. package/dist/story/visual-testing.d.ts +1 -1
  430. package/dist/streaming.d.ts +1 -1
  431. package/dist/stx-module-imports.d.ts +2 -1
  432. package/dist/stx-virtual-ts.d.ts +3 -2
  433. package/dist/temp-dir.d.ts +1 -0
  434. package/dist/template-compiler.d.ts +1 -1
  435. package/dist/template-hydrator.d.ts +1 -1
  436. package/dist/testing.d.ts +35 -66
  437. package/dist/theme-tokens.d.ts +5 -1
  438. package/dist/ts-css-config.d.ts +1 -0
  439. package/dist/type-checker.d.ts +24 -0
  440. package/dist/typecheck.d.ts +4 -4
  441. package/dist/types/config-types.d.ts +17 -17
  442. package/dist/types/context-types.d.ts +1 -1
  443. package/dist/types/directive-types.d.ts +2 -1
  444. package/dist/types/index.d.ts +7 -7
  445. package/dist/types.d.ts +1 -1
  446. package/dist/utils.d.ts +5 -5
  447. package/dist/variable-extractor.d.ts +1 -1
  448. package/dist/visual-editor.d.ts +0 -4
  449. package/dist/web-components/index.d.ts +4 -4
  450. package/dist/web-components/reactive-generator.d.ts +1 -1
  451. package/dist/web-components.d.ts +1 -1
  452. package/package.json +11 -7
  453. package/stx.d.ts +6 -5
  454. package/dist/chunk-0dve54ne.js +0 -3
  455. package/dist/chunk-0g05v7m1.js +0 -2
  456. package/dist/chunk-14vv64pw.js +0 -2
  457. package/dist/chunk-1mqyt33c.js +0 -2
  458. package/dist/chunk-1qdhwjs4.js +0 -2
  459. package/dist/chunk-332qk8tm.js +0 -3
  460. package/dist/chunk-3gyq9rjx.js +0 -2
  461. package/dist/chunk-3w9xhs7k.js +0 -2
  462. package/dist/chunk-47z5w330.js +0 -2
  463. package/dist/chunk-4e5wynb4.js +0 -2
  464. package/dist/chunk-4e6wkjtx.js +0 -2
  465. package/dist/chunk-4hfh5ety.js +0 -2
  466. package/dist/chunk-67bn31a3.js +0 -2
  467. package/dist/chunk-6amqskpv.js +0 -2
  468. package/dist/chunk-6ra9dqs2.js +0 -2
  469. package/dist/chunk-7hnt9a2e.js +0 -2
  470. package/dist/chunk-80bb89fh.js +0 -2
  471. package/dist/chunk-8f5dy08a.js +0 -2
  472. package/dist/chunk-8k6cd1e0.js +0 -2
  473. package/dist/chunk-a69v31q8.js +0 -2
  474. package/dist/chunk-a7v1j7td.js +0 -2
  475. package/dist/chunk-acbx3jn5.js +0 -2
  476. package/dist/chunk-apq33h4w.js +0 -2
  477. package/dist/chunk-c90qz5w0.js +0 -2
  478. package/dist/chunk-dqrkteav.js +0 -2
  479. package/dist/chunk-dx31vsyf.js +0 -2
  480. package/dist/chunk-epqp6mmn.js +0 -2
  481. package/dist/chunk-et9fyzf6.js +0 -2
  482. package/dist/chunk-f4x21pqx.js +0 -2
  483. package/dist/chunk-fhd8e4mq.js +0 -2
  484. package/dist/chunk-frhh6jd3.js +0 -2
  485. package/dist/chunk-ft43rx62.js +0 -2
  486. package/dist/chunk-g1gqysb4.js +0 -2
  487. package/dist/chunk-h7rcb74n.js +0 -2
  488. package/dist/chunk-j3x3e353.js +0 -2
  489. package/dist/chunk-j415w6dm.js +0 -2
  490. package/dist/chunk-ja5ghh0f.js +0 -2
  491. package/dist/chunk-jmjz23rf.js +0 -2
  492. package/dist/chunk-k1pyzf9e.js +0 -2
  493. package/dist/chunk-m276y4f3.js +0 -2
  494. package/dist/chunk-p9sbpbhg.js +0 -2
  495. package/dist/chunk-pd0wdjqd.js +0 -2
  496. package/dist/chunk-ptppavv8.js +0 -2
  497. package/dist/chunk-q2d8x7p1.js +0 -2
  498. package/dist/chunk-s922rk4n.js +0 -2
  499. package/dist/chunk-tdtwqydq.js +0 -2
  500. package/dist/chunk-v4kqxe8a.js +0 -2
  501. package/dist/chunk-vffwkmt4.js +0 -2
  502. package/dist/chunk-vqr3hn16.js +0 -2
  503. package/dist/chunk-x1c1aggq.js +0 -2
  504. package/dist/chunk-xkvzg640.js +0 -2
  505. package/dist/chunk-xt7qsgk4.js +0 -2
  506. package/dist/chunk-ydjy26ch.js +0 -2
  507. package/dist/chunk-yq12dhnt.js +0 -2
  508. package/dist/chunk-yx37mvy7.js +0 -2
  509. package/dist/chunk-z278w3cb.js +0 -2
  510. package/dist/chunk-z5z6442j.js +0 -2
  511. package/dist/chunk-znfzh6fm.js +0 -2
@@ -1,4 +1,5 @@
1
- var {require}=import.meta;import path from "node:path";
1
+ var {require}=import.meta;import { existsSync, symlinkSync } from "node:fs";
2
+ import path from "node:path";
2
3
  import vm from "node:vm";
3
4
  import { compileSharedScreenBundle } from "./compiler/bundle.js";
4
5
  import { NativeFormData } from "./runtime/jsc-globals.js";
@@ -35,8 +36,26 @@ export async function waitFor(check, description, timeoutMs = 5000) {
35
36
  await Bun.sleep(5);
36
37
  }
37
38
  }
39
+ function linkProjectPackages(root, project) {
40
+ let dir = path.resolve(project);
41
+ for (;; ) {
42
+ const modules = path.join(dir, "node_modules");
43
+ if (existsSync(modules)) {
44
+ try {
45
+ symlinkSync(modules, path.join(root, "node_modules"), "dir");
46
+ } catch {}
47
+ return;
48
+ }
49
+ const parent = path.dirname(dir);
50
+ if (parent === dir)
51
+ return;
52
+ dir = parent;
53
+ }
54
+ }
38
55
  export async function compileNativeScreen(source, options = {}) {
39
- const root = createTempDir("stx-native-testing-"), file = path.join(root, `${options.name || "Screen"}.stx`);
56
+ const root = createTempDir("stx-native-testing-");
57
+ linkProjectPackages(root, options.project ?? process.cwd());
58
+ const file = path.join(root, `${options.name || "Screen"}.stx`);
40
59
  await Bun.write(file, source);
41
60
  const result = await compileSharedScreenBundle(file, { root, minify: options.minify });
42
61
  return { code: result.code, diagnostics: result.diagnostics };
@@ -35,74 +35,74 @@ export declare function nativeTextStyle<T extends NativeTextMetrics>(style: T, t
35
35
  */
36
36
  export declare const nativeUi: {
37
37
  /** The whole screen: the grouped page behind every group. */
38
- screen: 'flex-1 bg-page';
38
+ readonly screen: 'flex-1 bg-page';
39
39
  /** A section's header, above a group. */
40
- header: 'mx-8 mt-7 mb-1.5 text-[13px] uppercase text-fg-soft';
40
+ readonly header: 'mx-8 mt-7 mb-1.5 text-[13px] uppercase text-fg-soft';
41
41
  /** A note under a group. */
42
- footer: 'mx-8 mt-1.5 text-[13px] text-fg-soft';
42
+ readonly footer: 'mx-8 mt-1.5 text-[13px] text-fg-soft';
43
43
  /** An inset grouped section holding rows. */
44
- group: 'mx-4 overflow-hidden rounded-panel bg-panel';
44
+ readonly group: 'mx-4 overflow-hidden rounded-panel bg-panel';
45
45
  /** A group holding a drawing or a block of content rather than rows. */
46
- card: 'mx-4 p-4 rounded-panel bg-panel';
46
+ readonly card: 'mx-4 p-4 rounded-panel bg-panel';
47
47
  /** A row in a group. */
48
- row: 'flex-row items-center gap-3 px-4 py-2.5 min-h-[44px]';
48
+ readonly row: 'flex-row items-center gap-3 px-4 py-2.5 min-h-[44px]';
49
49
  /** The hairline between rows, inset to where their text starts. */
50
- separator: 'ml-4 h-[0.5px] bg-line';
50
+ readonly separator: 'ml-4 h-[0.5px] bg-line';
51
51
  /** The same, past a 29pt icon tile. */
52
- separatorIcon: 'ml-[57px] h-[0.5px] bg-line';
52
+ readonly separatorIcon: 'ml-[57px] h-[0.5px] bg-line';
53
53
  /** A screen's own heading, where the navigation bar does not carry one. */
54
- heading: 'text-[30px] font-bold text-fg';
54
+ readonly heading: 'text-[30px] font-bold text-fg';
55
55
  /** A row's main words. */
56
- title: 'text-[17px] text-fg';
56
+ readonly title: 'text-[17px] text-fg';
57
57
  /** A row's main words, emphasised. */
58
- titleStrong: 'text-[17px] font-semibold text-fg';
58
+ readonly titleStrong: 'text-[17px] font-semibold text-fg';
59
59
  /** Running text. */
60
- body: 'text-[17px] text-fg-strong';
60
+ readonly body: 'text-[17px] text-fg-strong';
61
61
  /** A line under a title. */
62
- subtitle: 'text-[15px] text-fg-soft';
62
+ readonly subtitle: 'text-[15px] text-fg-soft';
63
63
  /** Small print: a caption, a date, a unit. */
64
- caption: 'text-[13px] text-fg-soft';
64
+ readonly caption: 'text-[13px] text-fg-soft';
65
65
  /** A value at a row's end. */
66
- value: 'text-[17px] text-fg-soft';
66
+ readonly value: 'text-[17px] text-fg-soft';
67
67
  /** A big number in a stat. */
68
- figure: 'text-[22px] font-semibold text-fg';
68
+ readonly figure: 'text-[22px] font-semibold text-fg';
69
69
  /** The disclosure chevron: it says the row opens something, so it stays legible. */
70
- chevron: 'h-3.5 w-3.5 text-fg-soft';
70
+ readonly chevron: 'h-3.5 w-3.5 text-fg-soft';
71
71
  /** Something to tap, as words. */
72
- tint: 'text-accent';
72
+ readonly tint: 'text-accent';
73
73
  /** Something that cannot be undone, as words. */
74
- destructive: 'text-danger';
74
+ readonly destructive: 'text-danger';
75
75
  /** A status that needs attention but is not an error. */
76
- warning: 'text-warning';
76
+ readonly warning: 'text-warning';
77
77
  /** A form field. */
78
- input: 'min-h-[44px] px-3 rounded-control bg-surface-sunken text-[17px] text-fg';
78
+ readonly input: 'min-h-[44px] px-3 rounded-control bg-surface-sunken text-[17px] text-fg';
79
79
  /**
80
80
  * A field of several lines. Panel corners, not the control's: an app whose
81
81
  * controls are pills would otherwise round a paragraph into a capsule and
82
82
  * clip its first and last letters at the ends.
83
83
  */
84
- textarea: 'min-h-[96px] px-3 py-2.5 rounded-panel bg-surface-sunken text-[17px] text-fg';
84
+ readonly textarea: 'min-h-[96px] px-3 py-2.5 rounded-panel bg-surface-sunken text-[17px] text-fg';
85
85
  /** The search field at the top of a list. */
86
- search: 'flex-row items-center gap-2 mx-4 px-2.5 h-9 rounded-control bg-surface-sunken';
86
+ readonly search: 'flex-row items-center gap-2 mx-4 px-2.5 h-9 rounded-control bg-surface-sunken';
87
87
  /** The filled button at the end of a flow, and its words. */
88
- primaryButton: 'items-center justify-center min-h-[50px] px-4 rounded-control bg-accent-solid';
89
- primaryButtonText: 'text-[17px] font-semibold text-accent-ink';
88
+ readonly primaryButton: 'items-center justify-center min-h-[50px] px-4 rounded-control bg-accent-solid';
89
+ readonly primaryButtonText: 'text-[17px] font-semibold text-accent-ink';
90
90
  /** A quieter button beside it, and its words. */
91
- secondaryButton: 'items-center justify-center min-h-[44px] px-3 rounded-control bg-surface-sunken';
92
- secondaryButtonText: 'text-[15px] font-semibold text-fg-strong';
91
+ readonly secondaryButton: 'items-center justify-center min-h-[44px] px-3 rounded-control bg-surface-sunken';
92
+ readonly secondaryButtonText: 'text-[15px] font-semibold text-fg-strong';
93
93
  /** A button floating over a map or a photograph. */
94
- floatingButton: 'items-center justify-center min-h-[44px] px-3 rounded-pill bg-panel shadow-md';
94
+ readonly floatingButton: 'items-center justify-center min-h-[44px] px-3 rounded-pill bg-panel shadow-md';
95
95
  /** A filled destructive button, and its words. */
96
- destructiveButton: 'items-center justify-center min-h-[50px] px-4 rounded-control bg-danger-solid';
97
- destructiveButtonText: 'text-[17px] font-semibold text-danger-ink';
96
+ readonly destructiveButton: 'items-center justify-center min-h-[50px] px-4 rounded-control bg-danger-solid';
97
+ readonly destructiveButtonText: 'text-[17px] font-semibold text-danger-ink';
98
98
  /** A rounded-square icon tile leading a row; its glyph is white. */
99
- iconTile: 'items-center justify-center h-[29px] w-[29px] rounded-[7px] bg-accent-solid';
100
- iconGlyph: 'h-[18px] w-[18px] text-white';
99
+ readonly iconTile: 'items-center justify-center h-[29px] w-[29px] rounded-[7px] bg-accent-solid';
100
+ readonly iconGlyph: 'h-[18px] w-[18px] text-white';
101
101
  /** A tinted note: a notice, a threat, a status that is good news. */
102
- noticeAccent: 'p-3 rounded-panel bg-accent-soft';
103
- noticeAccentText: 'text-[15px] text-accent-soft-ink';
104
- noticeDanger: 'p-3 rounded-panel bg-danger-soft';
105
- noticeDangerText: 'text-[15px] text-danger-soft-ink'
102
+ readonly noticeAccent: 'p-3 rounded-panel bg-accent-soft';
103
+ readonly noticeAccentText: 'text-[15px] text-accent-soft-ink';
104
+ readonly noticeDanger: 'p-3 rounded-panel bg-danger-soft';
105
+ readonly noticeDangerText: 'text-[15px] text-danger-soft-ink'
106
106
  };
107
107
  /** Typography authored in native points, shared with an ordinary browser view. */
108
108
  export declare interface NativeTextMetrics {
@@ -118,3 +118,4 @@ declare type WebTextMetric<Value> = Value extends number ? string : Value;
118
118
  export type WebTextStyle<T> = {
119
119
  [K in keyof T]: K extends 'fontSize' | 'lineHeight' | 'letterSpacing' ? WebTextMetric<T[K]> : T[K]
120
120
  }
121
+ export {};
@@ -1,6 +1,6 @@
1
- import { type MacOSSigningOptions } from './native-signing';
2
- import { type PlistValue } from './info-plist';
3
- export type { PlistValue } from './info-plist';
1
+ import { type MacOSSigningOptions } from './native-signing.js';
2
+ import { type PlistValue } from './info-plist.js';
3
+ export type { PlistValue } from './info-plist.js';
4
4
  /**
5
5
  * Build an stx template into a native application
6
6
  */
@@ -99,3 +99,4 @@ declare interface OfflineRoute {
99
99
  names: string[]
100
100
  sample: string
101
101
  }
102
+ export {};
@@ -1,5 +1,5 @@
1
- import type { KeptStore } from './kept-store';
2
- import type { SharedRequest, SharedRequestOptions } from '../shared-request';
1
+ import type { KeptStore } from './kept-store.js';
2
+ import type { SharedRequest, SharedRequestOptions } from '../shared-request.js';
3
3
  /**
4
4
  * Whether an outbox entry's `affects` item, or a URL the worker refreshed,
5
5
  * names this query: its key, or its URL (an item without a query string
@@ -1,4 +1,4 @@
1
- import { type SetCookieOptions } from './cookie-serialize';
1
+ import { type SetCookieOptions } from './cookie-serialize.js';
2
2
  /**
3
3
  * Parse a form submission body into a plain object.
4
4
  *
@@ -1,4 +1,4 @@
1
- import { extractBalancedExpression, findMatchingDelimiter, splitByPipe, Tokenizer } from './tokenizer';
1
+ import { extractBalancedExpression, findMatchingDelimiter, splitByPipe, Tokenizer } from './tokenizer.js';
2
2
  /**
3
3
  * Find all template expressions in source ({{ }} and {!! !!})
4
4
  */
@@ -20,7 +20,7 @@ export {
20
20
  type ParsedSwitch,
21
21
  parseSwitchBlock,
22
22
  type SwitchCase,
23
- } from './directive-parser';
23
+ } from './directive-parser.js';
24
24
  // Expression parser
25
25
  export {
26
26
  type ExpressionMatch,
@@ -32,17 +32,17 @@ export {
32
32
  parseExpressionWithFilters,
33
33
  parseScriptDeclarations,
34
34
  type ScriptDeclaration,
35
- } from './expression-parser';
35
+ } from './expression-parser.js';
36
36
  // Tokenizer
37
37
  export {
38
38
  type Token,
39
39
  Tokenizer,
40
40
  type TokenizerState,
41
41
  type TokenType,
42
- } from './tokenizer';
42
+ } from './tokenizer.js';
43
43
  // Expression parsing utilities
44
44
  export {
45
45
  extractBalancedExpression,
46
46
  findMatchingDelimiter,
47
47
  splitByPipe,
48
- } from './tokenizer';
48
+ } from './tokenizer.js';
@@ -58,8 +58,24 @@ export type TokenType = | 'STRING' // 'string' or "string"
58
58
  * Tokenizer for template expressions
59
59
  */
60
60
  export declare class Tokenizer {
61
+ private source;
62
+ private pos;
63
+ private line;
64
+ private column;
65
+ private tokens;
61
66
  constructor(source: string);
62
67
  tokenize(): Token[];
68
+ private nextToken;
69
+ private readWhitespace;
70
+ private readLineComment;
71
+ private readBlockComment;
72
+ private readString;
73
+ private readTemplateString;
74
+ private readNumber;
75
+ private readIdentifier;
76
+ private readDirective;
77
+ private advance;
78
+ private peek;
63
79
  saveState(): TokenizerState;
64
80
  restoreState(state: TokenizerState): void;
65
81
  }
@@ -1,82 +1,3 @@
1
- /**
2
- * Performance optimization utilities for stx
3
- */
4
- /**
5
- * Generic LRU (Least Recently Used) cache implementation
6
- * Automatically evicts least recently used items when capacity is reached
7
- */
8
- /**
9
- * How a cache measures what it is holding, when entry count is not enough.
10
- *
11
- * A count-bounded cache assumes entries are roughly one size. That holds for
12
- * the caches here that store paths or small fragments, and stops holding as
13
- * soon as the values are rendered output: one entry can be tens of kilobytes
14
- * and another a few bytes, so `maxSize` stops describing the footprint at all
15
- * (stacksjs/stx#1945). Passing `sizeOf` and `maxBytes` bounds the bytes as
16
- * well, which is the number a memory-constrained host actually has to budget.
17
- */
18
- export interface LRUCacheOptions<V> {
19
- /** Bytes this cache may retain across all entries. */
20
- maxBytes: number;
21
- /** What one value costs. Called once per `set`, so keep it cheap. */
22
- sizeOf: (value: V) => number;
23
- }
24
- export declare class LRUCache<K, V> {
25
- private cache;
26
- private readonly maxSize;
27
- private options;
28
- private sizes;
29
- private bytes;
30
- constructor(maxSize?: number, options?: LRUCacheOptions<V>);
31
- /** Bytes currently retained. Zero unless the cache is byte-bounded. */
32
- get byteSize(): number;
33
- /**
34
- * Change the byte budget, evicting immediately down to the new one.
35
- *
36
- * The caches here are module state, built when the module loads and so before
37
- * any config has been read. A host that wants a different ceiling -- or none
38
- * at all -- can only say so afterwards, and it should take effect on what is
39
- * already held rather than only on what arrives next: a container that has
40
- * just told stx to keep 4MB is not helped by a cache that keeps its current
41
- * 32MB until the entries happen to age out.
42
- *
43
- * A no-op on a cache built without a budget: giving one bytes it never
44
- * measured would evict against a total that is always zero.
45
- */
46
- setMaxBytes(maxBytes: number): void;
47
- /**
48
- * Get a value from the cache, moving it to most recently used
49
- */
50
- get(key: K): V | undefined;
51
- /**
52
- * Set a value in the cache
53
- */
54
- set(key: K, value: V): void;
55
- /**
56
- * Check if key exists in cache
57
- */
58
- has(key: K): boolean;
59
- /**
60
- * Delete a key from the cache
61
- */
62
- delete(key: K): boolean;
63
- /**
64
- * Clear all entries from the cache
65
- */
66
- clear(): void;
67
- /**
68
- * Get the current size of the cache
69
- */
70
- get size(): number;
71
- /**
72
- * Get all keys in the cache (oldest to newest)
73
- */
74
- keys(): IterableIterator<K>;
75
- /**
76
- * Get all values in the cache (oldest to newest)
77
- */
78
- values(): IterableIterator<V>;
79
- }
80
1
  /**
81
2
  * Get a cached regex pattern or compile and cache it.
82
3
  *
@@ -102,39 +23,6 @@ export declare function getCachedRegex(pattern: string, flags?: string): RegExp;
102
23
  * Clear the regex cache (useful for testing)
103
24
  */
104
25
  export declare function clearRegexCache(): void;
105
- /**
106
- * Cache for template processing results
107
- */
108
- export declare class TemplateCache {
109
- private cache;
110
- private maxSize;
111
- private ttl;
112
- constructor(maxSize?: number, ttl?: number);
113
- /**
114
- * Get cached result if available and not expired
115
- */
116
- get(key: string): string | null;
117
- /**
118
- * Store result in cache
119
- */
120
- set(key: string, result: string, dependencies?: Set<string>): void;
121
- /**
122
- * Invalidate cache entries that depend on a specific file
123
- */
124
- invalidateDependency(filePath: string): number;
125
- /**
126
- * Clear all cached entries
127
- */
128
- clear(): void;
129
- /**
130
- * Get cache statistics
131
- */
132
- getStats(): {
133
- size: number;
134
- maxSize: number;
135
- hitRate?: number;
136
- };
137
- }
138
26
  /**
139
27
  * Debounce function calls to avoid excessive processing
140
28
  */
@@ -152,169 +40,161 @@ export declare function memoize<T extends (...args: any[]) => any>(func: T, maxC
152
40
  */
153
41
  export declare function optimizedReplace(text: string, pattern: string | RegExp, replacement: string | ((match: string, ...args: any[]) => string), flags?: string): string;
154
42
  /**
155
- * Pool of worker contexts to avoid creating new Function instances
43
+ * Get the global performance monitor instance (lazy-loaded)
44
+ * This avoids instantiating the monitor until it's actually needed
156
45
  */
157
- declare class ExpressionEvaluatorPool {
158
- private pool;
159
- private maxPoolSize;
160
- private fnCache;
161
- private fnCacheMaxSize;
162
- getEvaluator(contextKeys: string[]): (...args: any[]) => any;
163
- clear(): void;
164
- }
46
+ export declare function getPerformanceMonitor(): PerformanceMonitor;
47
+ /**
48
+ * Apply default performance budgets to the monitor
49
+ */
50
+ export declare function applyDefaultBudgets(monitor?: PerformanceMonitor): void;
51
+ /**
52
+ * Reset the performance monitor instance (useful for testing)
53
+ */
54
+ export declare function resetPerformanceMonitor(): void;
55
+ /** Bound consecutive render work across components, stages and collection rows. */
56
+ export declare function yieldDuringRendering(): Promise<void>;
57
+ // Global expression evaluator pool
165
58
  export declare const expressionEvaluatorPool: ExpressionEvaluatorPool;
166
59
  /**
167
- * Performance budget configuration
60
+ * Default performance budgets for common operations
61
+ * @defaultValue
62
+ * ```ts
63
+ * {
64
+ * processDirectives: { maxTime: 500, warnThreshold: 0.8, action: 'warn' },
65
+ * processTemplate: { maxTime: 200, warnThreshold: 0.8, action: 'warn' },
66
+ * processIncludes: { maxTime: 100, warnThreshold: 0.8, action: 'warn' },
67
+ * processLoops: { maxTime: 50, warnThreshold: 0.8, action: 'warn' },
68
+ * processConditionals: { maxTime: 50, warnThreshold: 0.8, action: 'warn' },
69
+ * processExpressions: { maxTime: 100, warnThreshold: 0.8, action: 'warn' },
70
+ * renderComponent: { maxTime: 150, warnThreshold: 0.8, action: 'warn' },
71
+ * buildWebComponents: { maxTime: 1000, warnThreshold: 0.8, action: 'warn' }
72
+ * }
73
+ * ```
168
74
  */
169
- export interface PerformanceBudget {
170
- /** Maximum allowed time in milliseconds */
171
- maxTime: number;
172
- /** Warning threshold (percentage of maxTime, e.g., 0.8 = 80%) */
173
- warnThreshold?: number;
174
- /** Action to take on budget violation: 'log', 'warn', 'error', 'throw' */
175
- action?: 'log' | 'warn' | 'error' | 'throw';
176
- }
75
+ export declare const defaultPerformanceBudgets: Record<string, PerformanceBudget>;
177
76
  /**
178
- * Performance budget violation event
77
+ * Global performance monitor instance
78
+ * @deprecated Use getPerformanceMonitor() for lazy loading
179
79
  */
180
- export interface BudgetViolation {
181
- label: string;
182
- actualTime: number;
183
- budgetTime: number;
184
- exceedancePercent: number;
185
- timestamp: Date;
186
- isWarning: boolean;
187
- }
80
+ export declare const performanceMonitor: PerformanceMonitor;
81
+ /* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group, pickier/no-unused-vars */
188
82
  /**
189
- * Performance budget violation handler type
83
+ * Performance optimization utilities for stx
190
84
  */
191
- export type BudgetViolationHandler = (violation: BudgetViolation) => void;
192
85
  /**
193
- * Performance monitor for tracking processing times with budget support
86
+ * Generic LRU (Least Recently Used) cache implementation
87
+ * Automatically evicts least recently used items when capacity is reached
194
88
  */
195
- export declare class PerformanceMonitor {
196
- private metrics;
197
- private budgets;
198
- private violations;
199
- private maxViolations;
200
- private violationHandlers;
201
- private enabled;
202
- /**
203
- * Enable or disable performance monitoring
204
- */
205
- setEnabled(enabled: boolean): void;
206
- /**
207
- * Check if monitoring is enabled
208
- */
209
- isEnabled(): boolean;
210
- /**
211
- * Set a performance budget for a specific operation
212
- *
213
- * @param label - Operation label
214
- * @param budget - Budget configuration
215
- *
216
- * @example
217
- * ```typescript
218
- * performanceMonitor.setBudget('processDirectives', {
219
- * maxTime: 100, // 100ms max
220
- * warnThreshold: 0.8, // warn at 80ms
221
- * action: 'warn'
222
- * })
223
- * ```
224
- */
225
- setBudget(label: string, budget: PerformanceBudget): void;
226
- /**
227
- * Set multiple performance budgets at once
228
- */
229
- setBudgets(budgets: Record<string, PerformanceBudget>): void;
230
- /**
231
- * Remove a performance budget
232
- */
233
- removeBudget(label: string): void;
234
- /**
235
- * Get all configured budgets
236
- */
237
- getBudgets(): Record<string, PerformanceBudget>;
238
- /**
239
- * Add a handler for budget violations
240
- */
241
- onViolation(handler: BudgetViolationHandler): void;
242
- /**
243
- * Remove a violation handler
244
- */
245
- offViolation(handler: BudgetViolationHandler): void;
246
- /**
247
- * Time a function execution
248
- */
249
- time<T>(label: string, fn: () => T): T;
250
- /**
251
- * Time an async function execution
252
- */
253
- timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
254
- /**
255
- * Check if a duration violates the budget
256
- */
257
- private checkBudget;
258
- /**
259
- * Record a timing measurement
260
- */
261
- recordTime(label: string, duration: number): void;
262
- /**
263
- * Get performance statistics
264
- */
265
- getStats(label?: string): Record<string, any>;
266
- /**
267
- * Get all budget violations
268
- */
269
- getViolations(label?: string): BudgetViolation[];
270
- /**
271
- * Get violation statistics
272
- */
273
- getViolationStats(): {
274
- total: number;
275
- byLabel: Record<string, number>;
276
- warnings: number;
277
- errors: number;
278
- };
279
- /**
280
- * Clear all metrics
281
- */
282
- clear(): void;
283
- /**
284
- * Clear all violations
285
- */
286
- clearViolations(): void;
287
- /**
288
- * Clear budgets
289
- */
290
- clearBudgets(): void;
291
- /**
292
- * Reset everything (metrics, violations, budgets)
293
- */
294
- reset(): void;
89
+ /**
90
+ * How a cache measures what it is holding, when entry count is not enough.
91
+ *
92
+ * A count-bounded cache assumes entries are roughly one size. That holds for
93
+ * the caches here that store paths or small fragments, and stops holding as
94
+ * soon as the values are rendered output: one entry can be tens of kilobytes
95
+ * and another a few bytes, so `maxSize` stops describing the footprint at all
96
+ * (stacksjs/stx#1945). Passing `sizeOf` and `maxBytes` bounds the bytes as
97
+ * well, which is the number a memory-constrained host actually has to budget.
98
+ */
99
+ export declare interface LRUCacheOptions<V> {
100
+ maxBytes: number
101
+ sizeOf: (value: V) => number
295
102
  }
296
103
  /**
297
- * Default performance budgets for common operations
104
+ * Performance budget configuration
298
105
  */
299
- export declare const defaultPerformanceBudgets: Record<string, PerformanceBudget>;
106
+ export declare interface PerformanceBudget {
107
+ maxTime: number
108
+ warnThreshold?: number
109
+ action?: 'log' | 'warn' | 'error' | 'throw'
110
+ }
300
111
  /**
301
- * Get the global performance monitor instance (lazy-loaded)
302
- * This avoids instantiating the monitor until it's actually needed
112
+ * Performance budget violation event
303
113
  */
304
- export declare function getPerformanceMonitor(): PerformanceMonitor;
114
+ export declare interface BudgetViolation {
115
+ label: string
116
+ actualTime: number
117
+ budgetTime: number
118
+ exceedancePercent: number
119
+ timestamp: Date
120
+ isWarning: boolean
121
+ }
305
122
  /**
306
- * Global performance monitor instance
307
- * @deprecated Use getPerformanceMonitor() for lazy loading
123
+ * Performance budget violation handler type
308
124
  */
309
- export declare const performanceMonitor: PerformanceMonitor;
125
+ // eslint-disable-next-line pickier/no-unused-vars
126
+ export type BudgetViolationHandler = (violation: BudgetViolation) => void;
127
+ export declare class LRUCache<K, V> {
128
+ private cache;
129
+ private maxSize;
130
+ private options;
131
+ private sizes;
132
+ private bytes;
133
+ constructor(maxSize?: number, options?: LRUCacheOptions<V>);
134
+ get byteSize(): number;
135
+ setMaxBytes(maxBytes: number): void;
136
+ get(key: K): V | undefined;
137
+ set(key: K, value: V): void;
138
+ has(key: K): boolean;
139
+ delete(key: K): boolean;
140
+ clear(): void;
141
+ get size(): number;
142
+ keys(): IterableIterator<K>;
143
+ values(): IterableIterator<V>;
144
+ }
310
145
  /**
311
- * Apply default performance budgets to the monitor
146
+ * Cache for template processing results
312
147
  */
313
- export declare function applyDefaultBudgets(monitor?: PerformanceMonitor): void;
148
+ export declare class TemplateCache {
149
+ private cache;
150
+ private maxSize;
151
+ private ttl;
152
+ constructor(maxSize?: number, ttl?: number);
153
+ get(key: string): string | null;
154
+ set(key: string, result: string, dependencies?: Set<string>): void;
155
+ invalidateDependency(filePath: string): number;
156
+ clear(): void;
157
+ getStats(): { size: number, maxSize: number, hitRate?: number };
158
+ }
314
159
  /**
315
- * Reset the performance monitor instance (useful for testing)
160
+ * Pool of worker contexts to avoid creating new Function instances
316
161
  */
317
- export declare function resetPerformanceMonitor(): void;
318
- /** Bound consecutive render work across components, stages and collection rows. */
319
- export declare function yieldDuringRendering(): Promise<void>;
162
+ declare class ExpressionEvaluatorPool {
163
+ private pool;
164
+ private maxPoolSize;
165
+ private fnCache;
166
+ private fnCacheMaxSize;
167
+ getEvaluator(contextKeys: string[]): (...args: any[]) => any;
168
+ clear(): void;
169
+ }
170
+ /**
171
+ * Performance monitor for tracking processing times with budget support
172
+ */
173
+ export declare class PerformanceMonitor {
174
+ private metrics;
175
+ private budgets;
176
+ private violations;
177
+ private maxViolations;
178
+ private violationHandlers;
179
+ private enabled;
180
+ setEnabled(enabled: boolean): void;
181
+ isEnabled(): boolean;
182
+ setBudget(label: string, budget: PerformanceBudget): void;
183
+ setBudgets(budgets: Record<string, PerformanceBudget>): void;
184
+ removeBudget(label: string): void;
185
+ getBudgets(): Record<string, PerformanceBudget>;
186
+ onViolation(handler: BudgetViolationHandler): void;
187
+ offViolation(handler: BudgetViolationHandler): void;
188
+ time<T>(label: string, fn: () => T): T;
189
+ timeAsync<T>(label: string, fn: () => Promise<T>): Promise<T>;
190
+ private checkBudget;
191
+ recordTime(label: string, duration: number): void;
192
+ getStats(label?: string): Record<string, any>;
193
+ getViolations(label?: string): BudgetViolation[];
194
+ getViolationStats(): { total: number, byLabel: Record<string, number>, warnings: number, errors: number };
195
+ clear(): void;
196
+ clearViolations(): void;
197
+ clearBudgets(): void;
198
+ reset(): void;
199
+ }
320
200
  export {};