@stacksjs/stx 0.2.572 → 0.2.574

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 (499) hide show
  1. package/dist/a11y.d.ts +51 -111
  2. package/dist/animation.d.ts +131 -74
  3. package/dist/api-client.d.ts +11 -21
  4. package/dist/api-handler.d.ts +4 -4
  5. package/dist/appearance-bootstrap.d.ts +16 -77
  6. package/dist/application-layers.d.ts +11 -20
  7. package/dist/asset-roots.d.ts +7 -27
  8. package/dist/assets.d.ts +7 -9
  9. package/dist/async-components.d.ts +56 -78
  10. package/dist/auth.d.ts +0 -3
  11. package/dist/browser-core-imports.d.ts +2 -2
  12. package/dist/build-externalize-repeated.d.ts +0 -25
  13. package/dist/build-externalize.d.ts +18 -53
  14. package/dist/build-id.d.ts +40 -28
  15. package/dist/build-message.d.ts +20 -44
  16. package/dist/builtins/attrs.d.ts +0 -14
  17. package/dist/builtins/drawer.d.ts +3 -22
  18. package/dist/builtins/icon.d.ts +17 -19
  19. package/dist/builtins/image-alpha.d.ts +8 -8
  20. package/dist/builtins/image-delivery.d.ts +38 -40
  21. package/dist/builtins/image-placeholder.d.ts +12 -50
  22. package/dist/builtins/image-warmup-worker.d.ts +1 -1
  23. package/dist/builtins/image-worker.d.ts +6 -32
  24. package/dist/builtins/index.d.ts +16 -6
  25. package/dist/builtins/modal.d.ts +13 -23
  26. package/dist/builtins/safe-image.d.ts +2 -42
  27. package/dist/builtins/stx-image.d.ts +44 -24
  28. package/dist/builtins/stx-link.d.ts +5 -8
  29. package/dist/builtins/stx-loading-indicator.d.ts +11 -10
  30. package/dist/builtins/suspense.d.ts +6 -27
  31. package/dist/builtins/toast.d.ts +15 -16
  32. package/dist/builtins/transition-group.d.ts +1 -25
  33. package/dist/caching.d.ts +24 -21
  34. package/dist/{chunk-a6jq7hex.js → chunk-06hx32h4.js} +3 -3
  35. package/dist/{chunk-cyg9w31a.js → chunk-0gt7e1ns.js} +1 -1
  36. package/dist/{chunk-15g5sc0p.js → chunk-0ppzstqj.js} +2 -2
  37. package/dist/{chunk-qcymqscj.js → chunk-0px2ab3m.js} +9 -9
  38. package/dist/chunk-0q5s55km.js +2 -0
  39. package/dist/{chunk-7t3ykgsm.js → chunk-1c8sdf9a.js} +3 -3
  40. package/dist/chunk-1m5pagp3.js +2 -0
  41. package/dist/{chunk-mzqyv7s5.js → chunk-1n9bxdnh.js} +3 -3
  42. package/dist/{chunk-58tz7tmf.js → chunk-1swmxkdt.js} +2 -2
  43. package/dist/{chunk-4easd8da.js → chunk-1x2x3xgc.js} +4 -4
  44. package/dist/chunk-27ja2rpd.js +2 -0
  45. package/dist/chunk-2b0p7am3.js +2 -0
  46. package/dist/{chunk-qj4j547f.js → chunk-30acme5g.js} +2 -2
  47. package/dist/{chunk-1n64749x.js → chunk-32pxa1r0.js} +1 -1
  48. package/dist/{chunk-g66m3g2r.js → chunk-37d52q0d.js} +1 -1
  49. package/dist/{chunk-sfwprq8q.js → chunk-3dr757vb.js} +9 -9
  50. package/dist/chunk-3k6q1481.js +2 -0
  51. package/dist/{chunk-2z0trbbm.js → chunk-3kc7af8c.js} +2 -2
  52. package/dist/chunk-3pr388w5.js +2 -0
  53. package/dist/chunk-42h0kvng.js +2 -0
  54. package/dist/chunk-4eff1v2p.js +2 -0
  55. package/dist/{chunk-gzgc8zk5.js → chunk-4k6cb5fg.js} +5 -5
  56. package/dist/{chunk-s12b57m9.js → chunk-4xvbc0mb.js} +2 -2
  57. package/dist/{chunk-83fdt4yj.js → chunk-501h1mer.js} +4 -4
  58. package/dist/{chunk-tv784gv0.js → chunk-550q827h.js} +2 -2
  59. package/dist/chunk-5n2v9g2c.js +2 -0
  60. package/dist/{chunk-q79kmad5.js → chunk-5xwmkxkk.js} +1 -1
  61. package/dist/chunk-68ygpbta.js +2 -0
  62. package/dist/{chunk-0bt0fbs1.js → chunk-69k5t6pj.js} +52 -52
  63. package/dist/{chunk-232jswfm.js → chunk-6c2y9h5h.js} +1 -1
  64. package/dist/chunk-6gjfres0.js +2 -0
  65. package/dist/chunk-6z57saf5.js +2 -0
  66. package/dist/chunk-71zwgxws.js +2 -0
  67. package/dist/{chunk-b9r88ysg.js → chunk-76437eb4.js} +2 -2
  68. package/dist/{chunk-beqkrwt1.js → chunk-7a0ewpz0.js} +2 -2
  69. package/dist/chunk-7debnvz9.js +2 -0
  70. package/dist/{chunk-jwvzvapp.js → chunk-7gxn7mvd.js} +2 -2
  71. package/dist/{chunk-vp31ff54.js → chunk-7hr63cp5.js} +2 -2
  72. package/dist/{chunk-5t1whxxt.js → chunk-825m59jr.js} +5 -5
  73. package/dist/{chunk-74xwzxwz.js → chunk-8efe5vpm.js} +2 -2
  74. package/dist/{chunk-jqefcghh.js → chunk-8hp6722y.js} +5 -5
  75. package/dist/{chunk-kgj852hx.js → chunk-9yht5n7g.js} +2 -2
  76. package/dist/{chunk-kzjrgh0b.js → chunk-a3w3jc0t.js} +6 -6
  77. package/dist/chunk-a77gbp9x.js +2 -0
  78. package/dist/chunk-ampr3fpv.js +2 -0
  79. package/dist/{chunk-2ads8rw5.js → chunk-b10n7cpe.js} +2 -2
  80. package/dist/{chunk-0q6n3by0.js → chunk-bb5a8adb.js} +3 -3
  81. package/dist/chunk-bgbz0wzq.js +2 -0
  82. package/dist/chunk-bgr7fqhs.js +2 -0
  83. package/dist/chunk-bjfrwcfh.js +2 -0
  84. package/dist/{chunk-9k7bq97t.js → chunk-byhsfnkc.js} +1 -1
  85. package/dist/{chunk-zyk12484.js → chunk-c0ewddb3.js} +2 -2
  86. package/dist/{chunk-b2q8bk8p.js → chunk-c6jyp7ss.js} +2 -2
  87. package/dist/chunk-cdt5pg28.js +2 -0
  88. package/dist/chunk-cfh798k7.js +2 -0
  89. package/dist/{chunk-pnag11c4.js → chunk-cp5903cg.js} +2 -2
  90. package/dist/{chunk-4bgfpkwx.js → chunk-crj0yqc6.js} +1 -1
  91. package/dist/chunk-dax3zkmm.js +2 -0
  92. package/dist/chunk-dn676tdp.js +2 -0
  93. package/dist/chunk-dtbj816p.js +2 -0
  94. package/dist/chunk-e23cg45k.js +2 -0
  95. package/dist/{chunk-qzbzn1yf.js → chunk-e27njk86.js} +12 -12
  96. package/dist/{chunk-vr36s2en.js → chunk-e40qpeg5.js} +2 -2
  97. package/dist/{chunk-q83w8edy.js → chunk-e7pjsrfc.js} +2 -2
  98. package/dist/chunk-ecwpsjpd.js +2 -0
  99. package/dist/{chunk-pqcvh9pp.js → chunk-f0mbj8w9.js} +1 -1
  100. package/dist/chunk-f1zyc84x.js +2 -0
  101. package/dist/{chunk-f4jh9vrj.js → chunk-g8dx2jew.js} +246 -243
  102. package/dist/{chunk-phzs239m.js → chunk-gdxhe7ae.js} +4 -4
  103. package/dist/{chunk-5dmkkvs7.js → chunk-gh0q6jrm.js} +2 -2
  104. package/dist/chunk-h8vk3q9n.js +2 -0
  105. package/dist/{chunk-k7ht6tqe.js → chunk-hq8vxds5.js} +2 -2
  106. package/dist/{chunk-zd01r00t.js → chunk-hqda3vcw.js} +1 -1
  107. package/dist/chunk-j8pamkbh.js +2 -0
  108. package/dist/{chunk-2jjff8kv.js → chunk-jwe7yq8m.js} +5 -5
  109. package/dist/chunk-k5rrp1bt.js +2 -0
  110. package/dist/{chunk-yk3wh2xv.js → chunk-kcq2ed1d.js} +2 -2
  111. package/dist/{chunk-9yar9rfq.js → chunk-ktc1ecsm.js} +1 -1
  112. package/dist/chunk-mfm7ezh6.js +2 -0
  113. package/dist/chunk-mp16jxcg.js +2 -0
  114. package/dist/chunk-myhh1zsm.js +2 -0
  115. package/dist/chunk-n1c9j5qv.js +2 -0
  116. package/dist/{chunk-dcpf6kas.js → chunk-n8hnrgen.js} +6 -6
  117. package/dist/{chunk-36agnyhe.js → chunk-nc0ba89b.js} +6 -6
  118. package/dist/chunk-nf63pk4s.js +2 -0
  119. package/dist/{chunk-1edvsndv.js → chunk-nxw03sy9.js} +2 -2
  120. package/dist/{chunk-jze68d0z.js → chunk-p3xkj7pm.js} +2 -2
  121. package/dist/chunk-p5cry5s7.js +2 -0
  122. package/dist/{chunk-0dz1b6a1.js → chunk-pxk0tpw2.js} +3 -3
  123. package/dist/chunk-qd4snptd.js +2 -0
  124. package/dist/{chunk-h4k3hyny.js → chunk-r5ce7mkg.js} +2 -2
  125. package/dist/chunk-r8qhex33.js +2 -0
  126. package/dist/chunk-rqvn1s52.js +2 -0
  127. package/dist/{chunk-79vdkvhf.js → chunk-sej3ng5k.js} +5 -5
  128. package/dist/chunk-sjsant53.js +2 -0
  129. package/dist/chunk-snzh9z3g.js +3 -0
  130. package/dist/{chunk-ymawe0y5.js → chunk-ss4h5ch3.js} +1 -1
  131. package/dist/{chunk-2crxkm7j.js → chunk-svvavwp2.js} +4 -4
  132. package/dist/{chunk-qt3x1sh3.js → chunk-t79xnvzr.js} +3 -3
  133. package/dist/{chunk-rrj5m9xv.js → chunk-ta50ym5j.js} +2 -2
  134. package/dist/chunk-ty8g61y9.js +2 -0
  135. package/dist/chunk-v1k6w4z5.js +2 -0
  136. package/dist/{chunk-rfnr4xz6.js → chunk-vde4mtfr.js} +2 -2
  137. package/dist/chunk-vm7zv0gc.js +2 -0
  138. package/dist/{chunk-xckzvbvn.js → chunk-vnh550b5.js} +1 -1
  139. package/dist/chunk-vnxc48en.js +2 -0
  140. package/dist/chunk-y7vbwhh7.js +2 -0
  141. package/dist/{chunk-ydx3mfpp.js → chunk-yf90vn5t.js} +6 -6
  142. package/dist/{chunk-6wc2t6cd.js → chunk-yhqhv8mp.js} +13 -13
  143. package/dist/{chunk-s34g3awk.js → chunk-ytf3qkaw.js} +3 -3
  144. package/dist/chunk-yvyypd92.js +2 -0
  145. package/dist/{chunk-c4zpzxex.js → chunk-z33z3rr4.js} +4 -4
  146. package/dist/chunk-zfw39q56.js +2 -0
  147. package/dist/chunk-zpm02e15.js +2 -0
  148. package/dist/chunk-zzr0p4bb.js +2 -0
  149. package/dist/cli.js +18 -18
  150. package/dist/client/directive.d.ts +0 -7
  151. package/dist/client/index.d.ts +1 -0
  152. package/dist/client/signals-appearance-runtime.d.ts +1 -1
  153. package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
  154. package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
  155. package/dist/client/signals-class-runtime.d.ts +1 -1
  156. package/dist/client/signals-component-api-runtime.d.ts +1 -1
  157. package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
  158. package/dist/client/signals-component-props-runtime.d.ts +1 -1
  159. package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
  160. package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
  161. package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
  162. package/dist/client/signals-context-runtime.d.ts +1 -1
  163. package/dist/client/signals-cookie-runtime.d.ts +1 -1
  164. package/dist/client/signals-devtools-runtime.d.ts +1 -1
  165. package/dist/client/signals-dialog-runtime.d.ts +1 -1
  166. package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
  167. package/dist/client/signals-drawer-runtime.d.ts +1 -1
  168. package/dist/client/signals-effect-runtime.d.ts +1 -1
  169. package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
  170. package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
  171. package/dist/client/signals-expression-runtime.d.ts +1 -1
  172. package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
  173. package/dist/client/signals-for-runtime.d.ts +1 -1
  174. package/dist/client/signals-globals-runtime.d.ts +1 -1
  175. package/dist/client/signals-handler-runtime.d.ts +1 -1
  176. package/dist/client/signals-head-runtime.d.ts +1 -1
  177. package/dist/client/signals-helpers-runtime.d.ts +1 -1
  178. package/dist/client/signals-host-runtime.d.ts +1 -1
  179. package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
  180. package/dist/client/signals-hydration-runtime.d.ts +1 -1
  181. package/dist/client/signals-if-chain-runtime.d.ts +1 -1
  182. package/dist/client/signals-if-runtime.d.ts +1 -1
  183. package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
  184. package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
  185. package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
  186. package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
  187. package/dist/client/signals-loop-row-runtime.d.ts +1 -1
  188. package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
  189. package/dist/client/signals-model-runtime.d.ts +1 -1
  190. package/dist/client/signals-mount-runtime.d.ts +1 -1
  191. package/dist/client/signals-navigation-runtime.d.ts +1 -1
  192. package/dist/client/signals-notify-runtime.d.ts +1 -1
  193. package/dist/client/signals-optimistic-runtime.d.ts +1 -1
  194. package/dist/client/signals-overlay-runtime.d.ts +1 -1
  195. package/dist/client/signals-pipe-runtime.d.ts +1 -1
  196. package/dist/client/signals-proxy-runtime.d.ts +1 -1
  197. package/dist/client/signals-query-runtime.d.ts +1 -1
  198. package/dist/client/signals-reactive-runtime.d.ts +1 -1
  199. package/dist/client/signals-ref-runtime.d.ts +1 -1
  200. package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
  201. package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
  202. package/dist/client/signals-show-runtime.d.ts +1 -1
  203. package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
  204. package/dist/client/signals-spa-load-runtime.d.ts +1 -1
  205. package/dist/client/signals-state-runtime.d.ts +1 -1
  206. package/dist/client/signals-storage-runtime.d.ts +1 -1
  207. package/dist/client/signals-store-registry-runtime.d.ts +1 -1
  208. package/dist/client/signals-style-runtime.d.ts +1 -1
  209. package/dist/client/signals-suspense-runtime.d.ts +1 -1
  210. package/dist/client/signals-timer-runtime.d.ts +1 -1
  211. package/dist/client/signals-toast-runtime.d.ts +1 -1
  212. package/dist/client/signals-tooltip-runtime.d.ts +1 -1
  213. package/dist/client/signals-transition-group-runtime.d.ts +1 -1
  214. package/dist/client/signals-websocket-runtime.d.ts +1 -1
  215. package/dist/client-helpers.d.ts +1 -312
  216. package/dist/client-module-registry.d.ts +4 -27
  217. package/dist/client-parameter-bindings.d.ts +4 -9
  218. package/dist/client-parameter-bindings.js +30 -10
  219. package/dist/client-script-bundler.d.ts +55 -103
  220. package/dist/client-script.d.ts +69 -127
  221. package/dist/client-script.js +4 -7
  222. package/dist/color-mode-boot.d.ts +21 -58
  223. package/dist/component-client-factories.d.ts +8 -9
  224. package/dist/component-contract-checks.d.ts +15 -18
  225. package/dist/component-contract.d.ts +6 -6
  226. package/dist/component-hmr.d.ts +8 -7
  227. package/dist/component-model.d.ts +14 -20
  228. package/dist/component-processing.d.ts +51 -59
  229. package/dist/component-registry.d.ts +28 -99
  230. package/dist/component-renderer.d.ts +19 -16
  231. package/dist/component-resolution.d.ts +8 -8
  232. package/dist/component-tags.d.ts +1 -1
  233. package/dist/composable-loader.d.ts +6 -41
  234. package/dist/composables/use-fetch.d.ts +45 -114
  235. package/dist/composables/use-form.d.ts +2 -56
  236. package/dist/composables/use-intersection-observer.d.ts +1 -1
  237. package/dist/composables.d.ts +75 -74
  238. package/dist/composition-api.d.ts +19 -43
  239. package/dist/computed.d.ts +93 -86
  240. package/dist/conditionals.d.ts +0 -24
  241. package/dist/config.d.ts +30 -24
  242. package/dist/config.js +3 -0
  243. package/dist/craft-bridge.d.ts +1 -467
  244. package/dist/craft-components.d.ts +234 -680
  245. package/dist/craft-entry.js +2 -2
  246. package/dist/craft.js +2 -2
  247. package/dist/csp.d.ts +41 -107
  248. package/dist/database.d.ts +1 -1
  249. package/dist/defer.d.ts +0 -24
  250. package/dist/dev-server/terminal-colors.d.ts +32 -32
  251. package/dist/dev-server/ts-css.d.ts +26 -35
  252. package/dist/dev-server/types.d.ts +33 -29
  253. package/dist/directive-api.d.ts +42 -85
  254. package/dist/directive-arguments.d.ts +14 -39
  255. package/dist/document-shell.d.ts +49 -81
  256. package/dist/dynamic-components.d.ts +0 -9
  257. package/dist/engine-bindings.d.ts +1 -1
  258. package/dist/env.d.ts +26 -0
  259. package/dist/error-boundaries.d.ts +36 -43
  260. package/dist/error-handling.d.ts +1 -1
  261. package/dist/errors/codes.d.ts +43 -51
  262. package/dist/errors/formatter.d.ts +38 -58
  263. package/dist/errors/index.d.ts +61 -5
  264. package/dist/errors/logger.d.ts +40 -114
  265. package/dist/errors/sanitizer.d.ts +28 -53
  266. package/dist/errors/types.d.ts +31 -44
  267. package/dist/events.d.ts +32 -94
  268. package/dist/expressions.d.ts +57 -62
  269. package/dist/find-body-tag.d.ts +5 -34
  270. package/dist/first-script-tag.d.ts +0 -23
  271. package/dist/forms-validation.d.ts +117 -149
  272. package/dist/forms.d.ts +161 -120
  273. package/dist/framework-composables.d.ts +0 -32
  274. package/dist/head-injection.d.ts +30 -32
  275. package/dist/head-keys.d.ts +12 -15
  276. package/dist/head.d.ts +110 -139
  277. package/dist/heatmap.d.ts +76 -152
  278. package/dist/html-masking.d.ts +38 -62
  279. package/dist/hydration-runtime.d.ts +24 -20
  280. package/dist/hydration.d.ts +11 -10
  281. package/dist/i18n.d.ts +34 -95
  282. package/dist/image-optimization/auto-sibling.d.ts +4 -32
  283. package/dist/imported-signals.d.ts +0 -36
  284. package/dist/includes.d.ts +6 -69
  285. package/dist/index.d.ts +2 -1
  286. package/dist/init.d.ts +12 -20
  287. package/dist/internal-markdown.d.ts +8 -12
  288. package/dist/interpolation-context.d.ts +15 -15
  289. package/dist/island-chunking.d.ts +13 -30
  290. package/dist/keep-alive.d.ts +52 -72
  291. package/dist/layout-types.d.ts +2 -27
  292. package/dist/lazy-module.d.ts +0 -10
  293. package/dist/loading-indicator.d.ts +8 -5
  294. package/dist/loop-binding.d.ts +4 -7
  295. package/dist/loops.d.ts +25 -67
  296. package/dist/markdown.d.ts +1 -0
  297. package/dist/media/image/component.d.ts +9 -25
  298. package/dist/media/image/directive.d.ts +1 -15
  299. package/dist/media/image/placeholder.d.ts +9 -20
  300. package/dist/media/image/processor/cache.d.ts +18 -40
  301. package/dist/media/image/processor/index.d.ts +10 -1
  302. package/dist/media/image/processor/optimizer.d.ts +1 -12
  303. package/dist/media/image/processor/responsive.d.ts +6 -16
  304. package/dist/media/image/srcset.d.ts +49 -47
  305. package/dist/media/shared/cache.d.ts +31 -51
  306. package/dist/media/shared/hash.d.ts +0 -7
  307. package/dist/media/types.d.ts +754 -1235
  308. package/dist/media/video/directive.d.ts +1 -15
  309. package/dist/media/video/index.d.ts +17 -39
  310. package/dist/media/video/processor/cache.d.ts +19 -42
  311. package/dist/media/video/processor/index.d.ts +18 -1
  312. package/dist/media/video/processor/streaming.d.ts +10 -17
  313. package/dist/media/video/processor/thumbnail.d.ts +15 -21
  314. package/dist/media/video/processor/transcoder.d.ts +1 -11
  315. package/dist/meta-arguments.d.ts +14 -39
  316. package/dist/method-spoofing.d.ts +0 -7
  317. package/dist/middleware.d.ts +0 -60
  318. package/dist/native/bridge/protocol.d.ts +2 -1
  319. package/dist/native/compiler/headwind-to-style.d.ts +383 -359
  320. package/dist/native/compiler/icons.d.ts +249 -243
  321. package/dist/native/compiler/svg.d.ts +35 -24
  322. package/dist/native/runtime/jsc-globals.d.ts +1 -1
  323. package/dist/native/runtime/native-host.d.ts +1 -1
  324. package/dist/native/runtime/native-host.js +3 -0
  325. package/dist/offline/app-service-worker.d.ts +50 -114
  326. package/dist/offline/kept-store.d.ts +23 -37
  327. package/dist/offline/query-cache.d.ts +55 -126
  328. package/dist/owned-routes.d.ts +0 -31
  329. package/dist/page-response.d.ts +8 -39
  330. package/dist/parser/directive-parser.d.ts +45 -57
  331. package/dist/parser/expression-parser.d.ts +35 -33
  332. package/dist/parser/index.d.ts +39 -4
  333. package/dist/parser/tokenizer.d.ts +49 -61
  334. package/dist/partial-hydration.d.ts +51 -82
  335. package/dist/performance-utils.d.ts +115 -255
  336. package/dist/placeholder.d.ts +9 -18
  337. package/dist/plugin-system.d.ts +115 -264
  338. package/dist/process.d.ts +4 -9
  339. package/dist/process.js +6 -4
  340. package/dist/prop-sentinels.d.ts +11 -11
  341. package/dist/public-env.d.ts +0 -14
  342. package/dist/pwa/directives.d.ts +20 -12
  343. package/dist/pwa/inject.d.ts +0 -10
  344. package/dist/pwa/precache.d.ts +16 -22
  345. package/dist/pwa/service-worker.d.ts +0 -12
  346. package/dist/pwa.js +3 -3
  347. package/dist/reactive-bindings.d.ts +11 -34
  348. package/dist/reactive-tracking.d.ts +0 -36
  349. package/dist/reactive.d.ts +41 -58
  350. package/dist/render-memo.d.ts +5 -23
  351. package/dist/resolve-stx-targets.d.ts +6 -44
  352. package/dist/route-middleware.d.ts +35 -2
  353. package/dist/route-rules.d.ts +10 -13
  354. package/dist/router.d.ts +9 -8
  355. package/dist/routes.d.ts +3 -1
  356. package/dist/runtime-config-server.d.ts +14 -17
  357. package/dist/runtime-config.d.ts +2 -3
  358. package/dist/runtime-globals.d.ts +90 -122
  359. package/dist/runtime-injection.d.ts +0 -8
  360. package/dist/scaffolding.d.ts +30 -26
  361. package/dist/script-emit.d.ts +0 -30
  362. package/dist/script-validation.d.ts +6 -12
  363. package/dist/seo.d.ts +75 -153
  364. package/dist/server-api.d.ts +9 -12
  365. package/dist/server-bindings.d.ts +1 -26
  366. package/dist/server-data.d.ts +4 -5
  367. package/dist/sfc-template.d.ts +8 -8
  368. package/dist/signal-processing.d.ts +37 -53
  369. package/dist/signals-api.d.ts +58 -135
  370. package/dist/signals.d.ts +18 -24
  371. package/dist/site-url.d.ts +31 -28
  372. package/dist/slots.d.ts +20 -86
  373. package/dist/source-signature.d.ts +5 -28
  374. package/dist/ssg.d.ts +158 -337
  375. package/dist/ssg.js +4 -4
  376. package/dist/state-dir.d.ts +4 -4
  377. package/dist/store-loader.d.ts +0 -10
  378. package/dist/story/analytics.d.ts +60 -138
  379. package/dist/story/bookmarks.d.ts +34 -87
  380. package/dist/story/cli.d.ts +69 -123
  381. package/dist/story/collect/scanner.d.ts +0 -4
  382. package/dist/story/collect/tree.d.ts +1 -8
  383. package/dist/story/commands/build.d.ts +6 -11
  384. package/dist/story/commands/dev.d.ts +8 -15
  385. package/dist/story/commands/preview.d.ts +7 -13
  386. package/dist/story/config-watcher.d.ts +13 -20
  387. package/dist/story/config.d.ts +8 -11
  388. package/dist/story/context.d.ts +8 -14
  389. package/dist/story/hmr.d.ts +26 -24
  390. package/dist/story/hot-swap.d.ts +23 -34
  391. package/dist/story/keyboard-shortcuts.d.ts +18 -23
  392. package/dist/story/output.d.ts +44 -46
  393. package/dist/story/performance.d.ts +45 -107
  394. package/dist/story/presets.d.ts +41 -107
  395. package/dist/story/renderer.d.ts +27 -41
  396. package/dist/story/search.d.ts +12 -23
  397. package/dist/story/server.d.ts +11 -21
  398. package/dist/story/setup.d.ts +15 -23
  399. package/dist/story/testing.d.ts +40 -65
  400. package/dist/story/types.d.ts +160 -262
  401. package/dist/streaming.d.ts +57 -119
  402. package/dist/strip-literals.d.ts +1 -25
  403. package/dist/stx-module-imports.d.ts +7 -0
  404. package/dist/stx-virtual-ts.d.ts +102 -253
  405. package/dist/stx-virtual-ts.js +5 -4
  406. package/dist/style-scoping.d.ts +8 -21
  407. package/dist/suspense.d.ts +52 -67
  408. package/dist/teleport.d.ts +0 -22
  409. package/dist/template-syntax-escape.d.ts +8 -8
  410. package/dist/template-tag-balance.d.ts +6 -22
  411. package/dist/testing.d.ts +26 -11
  412. package/dist/theme-tokens.d.ts +388 -134
  413. package/dist/transitions.d.ts +55 -66
  414. package/dist/ts-css-config.d.ts +12 -70
  415. package/dist/types/component-types.d.ts +122 -187
  416. package/dist/types/config-types.d.ts +341 -956
  417. package/dist/types/context-types.d.ts +24 -46
  418. package/dist/types/csp-types.d.ts +66 -70
  419. package/dist/types/directive-types.d.ts +156 -223
  420. package/dist/types/index.d.ts +110 -6
  421. package/dist/types/pwa-types.d.ts +148 -273
  422. package/dist/types.d.ts +1 -0
  423. package/dist/unresolved-identifiers.d.ts +22 -24
  424. package/dist/url-safety.d.ts +32 -32
  425. package/dist/utils.d.ts +21 -36
  426. package/dist/utils.js +6 -2
  427. package/dist/validator.d.ts +26 -28
  428. package/dist/variable-extractor.d.ts +19 -49
  429. package/dist/view-composers.d.ts +81 -80
  430. package/dist/virtual-scrolling.d.ts +82 -101
  431. package/dist/visual-testing.d.ts +10 -9
  432. package/dist/vue-template.d.ts +0 -23
  433. package/dist/web-components/css-scoping.d.ts +11 -21
  434. package/dist/web-components.d.ts +58 -81
  435. package/dist/x-element.d.ts +1 -0
  436. package/package.json +6 -6
  437. package/stx.d.ts +2 -2
  438. package/dist/app-service-worker.d.ts +0 -165
  439. package/dist/chunk-01mxer9s.js +0 -2
  440. package/dist/chunk-09gtbb1w.js +0 -2
  441. package/dist/chunk-0g2ybnht.js +0 -3
  442. package/dist/chunk-15erabm6.js +0 -2
  443. package/dist/chunk-1z6c6dyk.js +0 -2
  444. package/dist/chunk-1zfg1kd5.js +0 -2
  445. package/dist/chunk-279jv0yf.js +0 -2
  446. package/dist/chunk-2a1q5y6r.js +0 -2
  447. package/dist/chunk-2cqbyb8w.js +0 -2
  448. package/dist/chunk-2jsnrfc8.js +0 -2
  449. package/dist/chunk-3gft8zng.js +0 -2
  450. package/dist/chunk-49gwmcrn.js +0 -2
  451. package/dist/chunk-4wfr074d.js +0 -2
  452. package/dist/chunk-5afw7z6v.js +0 -2
  453. package/dist/chunk-5fv4g4et.js +0 -2
  454. package/dist/chunk-604rs9sq.js +0 -2
  455. package/dist/chunk-636sfxyj.js +0 -2
  456. package/dist/chunk-6f4qrd0s.js +0 -2
  457. package/dist/chunk-6va5pe2m.js +0 -2
  458. package/dist/chunk-8k61b4ae.js +0 -2
  459. package/dist/chunk-asbq9cgs.js +0 -2
  460. package/dist/chunk-b7t8jejd.js +0 -2
  461. package/dist/chunk-b894fxfc.js +0 -2
  462. package/dist/chunk-bm2q1srp.js +0 -2
  463. package/dist/chunk-cgwyd9aq.js +0 -2
  464. package/dist/chunk-cvswrbzw.js +0 -2
  465. package/dist/chunk-d8206zbp.js +0 -2
  466. package/dist/chunk-f10299sf.js +0 -2
  467. package/dist/chunk-f1apaqfk.js +0 -2
  468. package/dist/chunk-g6zeqvvb.js +0 -2
  469. package/dist/chunk-ghy82tsc.js +0 -2
  470. package/dist/chunk-jw33eys8.js +0 -2
  471. package/dist/chunk-k6wgh598.js +0 -2
  472. package/dist/chunk-m2a1fxpb.js +0 -2
  473. package/dist/chunk-m6mxqepz.js +0 -2
  474. package/dist/chunk-n6qp05t9.js +0 -2
  475. package/dist/chunk-nn174xjh.js +0 -2
  476. package/dist/chunk-ntgy4e1q.js +0 -2
  477. package/dist/chunk-nw4axkpx.js +0 -2
  478. package/dist/chunk-p5chk3s9.js +0 -2
  479. package/dist/chunk-pw9verqx.js +0 -2
  480. package/dist/chunk-ta8bhz27.js +0 -2
  481. package/dist/chunk-tc5r2vmw.js +0 -2
  482. package/dist/chunk-ts80ktq7.js +0 -2
  483. package/dist/chunk-vyg8bvkt.js +0 -2
  484. package/dist/chunk-xq2ck69k.js +0 -2
  485. package/dist/chunk-y4ajd836.js +0 -2
  486. package/dist/chunk-zddzjd60.js +0 -2
  487. package/dist/chunk-zgxj1q7w.js +0 -2
  488. package/dist/chunk-zs7qhh40.js +0 -2
  489. package/dist/signals-context-runtime.d.ts +0 -2
  490. package/dist/signals-drawer-runtime.d.ts +0 -2
  491. package/dist/signals-host-runtime.d.ts +0 -9
  492. package/dist/signals-loop-conditional-runtime.d.ts +0 -2
  493. package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
  494. package/dist/signals-notify-runtime.d.ts +0 -2
  495. package/dist/signals-optimistic-runtime.d.ts +0 -2
  496. package/dist/signals-overlay-runtime.d.ts +0 -2
  497. package/dist/signals-scope-disposal-runtime.d.ts +0 -2
  498. package/dist/signals-spa-load-control-runtime.d.ts +0 -2
  499. package/dist/signals-storage-runtime.d.ts +0 -2
package/dist/utils.d.ts CHANGED
@@ -1,18 +1,8 @@
1
- /**
2
- * Utility functions for the stx compiler
3
- *
4
- * This module provides core utilities for template processing.
5
- * Some functionality has been extracted to dedicated modules:
6
- *
7
- * - validator.ts - Template validation utilities
8
- * - variable-extractor.ts - Script variable extraction
9
- *
10
- * @module utils
11
- */
12
1
  import type { StxOptions } from './types';
13
- export { extractDirectiveNames, getPositionInfo, hasDirectives, validateDirective, validateTemplate, } from './validator';
14
- export type { TemplateValidationError, TemplateValidationResult, } from './validator';
15
- export { convertToCommonJS, extractScriptFromTemplate, extractVariables, hasVariables, } from './variable-extractor';
2
+ export type {
3
+ TemplateValidationError,
4
+ TemplateValidationResult,
5
+ } from './validator';
16
6
  /**
17
7
  * Check if script should be treated as plain JavaScript (opt-out from TypeScript)
18
8
  * By default ALL scripts are TypeScript. Use <script js> or <script lang="js"> to opt-out.
@@ -75,19 +65,7 @@ export declare function slotContentHasExpressions(slotContent: string): boolean;
75
65
  * named `title` also exists in the server context.
76
66
  */
77
67
  export declare function componentClientSignalNames(scripts: string[]): string[];
78
- export declare function renderComponentWithSlot(componentPath: string, props: Record<string, unknown>, slotContent: string, componentsDir: string, parentContext: Record<string, unknown>, parentFilePath: string, options: StxOptions, processedComponents: Set<string> | undefined, dependencies: Set<string>,
79
- /**
80
- * The client loop variables in scope where the tag stands: those of any
81
- * `:for` around it and of a `:for` on the tag itself. The slot is the
82
- * caller's markup inside that loop, but it is rendered here, away from the
83
- * loop, so the names have to be handed over. Defaults to the ones the
84
- * caller's context already carries.
85
- */
86
- clientLoopNames?: readonly string[], renderMetadata?: {
87
- declaredProps: Set<string>;
88
- },
89
- /** Original tag spelling for case-sensitive file lookup; identity stays canonical. */
90
- lookupName?: string): Promise<string>;
68
+ export declare function renderComponentWithSlot(componentPath: string, props: Record<string, unknown>, slotContent: string, componentsDir: string, parentContext: Record<string, unknown>, parentFilePath: string, options: StxOptions, processedComponents?: Set<string> | undefined, dependencies: Set<string>, clientLoopNames?: readonly string[], renderMetadata?: { declaredProps: Set<string> }, lookupName?: string): Promise<string>;
91
69
  /**
92
70
  * Check if a file exists
93
71
  */
@@ -104,11 +82,7 @@ export declare function resolveTemplatePath(templatePath: string, currentFilePat
104
82
  * @param errorPattern The pattern to locate in the template (fallback if position not available)
105
83
  * @returns Line number and context information
106
84
  */
107
- export declare function getSourceLineInfo(template: string, errorPosition?: number, errorPattern?: string): {
108
- lineNumber: number;
109
- lineContent: string;
110
- context: string;
111
- };
85
+ export declare function getSourceLineInfo(template: string, errorPosition?: number, errorPattern?: string): { lineNumber: number, lineContent: string, context: string };
112
86
  /**
113
87
  * Create a descriptive error message with line information
114
88
  * @param errorType Type of error (e.g., "Expression", "Directive")
@@ -128,7 +102,18 @@ export declare function clearComponentCache(): void;
128
102
  /**
129
103
  * Get component cache statistics
130
104
  */
131
- export declare function getComponentCacheStats(): {
132
- size: number;
133
- maxSize: number;
134
- };
105
+ export declare function getComponentCacheStats(): { size: number, maxSize: number };
106
+ // Re-export from extracted modules for backward compatibility
107
+ export {
108
+ extractDirectiveNames,
109
+ getPositionInfo,
110
+ hasDirectives,
111
+ validateDirective,
112
+ validateTemplate,
113
+ } from './validator';
114
+ export {
115
+ convertToCommonJS,
116
+ extractScriptFromTemplate,
117
+ extractVariables,
118
+ hasVariables,
119
+ } from './variable-extractor';
package/dist/utils.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { pascalToKebab } from "./component-resolution.js";
2
2
  import fs from "node:fs";
3
3
  import path from "node:path";
4
- import { extractAndStripCssImports, extractBridgeData, injectBrowserCoreAutoImports, processClientScript, renderVendorStyleTags } from "./client-script.js";
4
+ import { extractAndStripCssImports, extractBridgeData, generateServerDataBridge, injectBrowserCoreAutoImports, processClientScript, renderVendorStyleTags } from "./client-script.js";
5
5
  import {
6
6
  COMPONENT_CLIENT_FACTORIES_CONTEXT_KEY,
7
7
  componentClientFactoriesRegisteredSince,
@@ -946,7 +946,10 @@ export async function renderComponentWithSlot(componentPath, props, slotContent,
946
946
  const scriptMatch = script.match(/<script([^>]*)>([\s\S]*)<\/script>/i);
947
947
  if (!scriptMatch)
948
948
  return script;
949
- const [, attrs, rawContent] = scriptMatch, { vendorStyleTags, factoryBody } = await buildComponentIsland(rawContent, componentFilePath, options.buildMode === "compile"), factoryId = hydrateTrigger ? null : registerComponentClientFactory(parentContext, factoryBody), wrappedContent = factoryId ? `window.__stxComponentFactories[${JSON.stringify(factoryId)}](${JSON.stringify(scopeId)});` : `(${factoryBody})(${JSON.stringify(scopeId)});`;
949
+ const [, attrs, rawContent] = scriptMatch, island = await buildComponentIsland(rawContent, componentFilePath, options.buildMode === "compile"), bridge = generateServerDataBridge(island.clientCode, extractBridgeData(componentContext)), { vendorStyleTags } = island, factoryBody = bridge ? `function(__scopeId) {
950
+ ${bridge}
951
+ return (${island.factoryBody})(__scopeId);
952
+ }` : island.factoryBody, factoryId = hydrateTrigger ? null : registerComponentClientFactory(parentContext, factoryBody), wrappedContent = factoryId ? `window.__stxComponentFactories[${JSON.stringify(factoryId)}](${JSON.stringify(scopeId)});` : `(${factoryBody})(${JSON.stringify(scopeId)});`;
950
953
  if (hydrateTrigger)
951
954
  return `${vendorStyleTags}<script type="stx/island" data-stx-island="${scopeId}" data-stx-scoped data-stx-owner="${scopeId}"${attrs}>${wrappedContent}</script>`;
952
955
  return `${vendorStyleTags}<script data-stx-scoped data-stx-run="always" data-stx-owner="${scopeId}"${attrs}>${wrappedContent}</script>`;
@@ -1373,6 +1376,7 @@ finally {
1373
1376
  }`, island = {
1374
1377
  vendorStyleTags,
1375
1378
  factoryBody,
1379
+ clientCode: content,
1376
1380
  deps: snapshotDeps([...bundleInputs, ...cssExtraction.styles.map((style) => style.resolvedPath)])
1377
1381
  };
1378
1382
  if (!bundleFellBack && cssExtraction.unresolved.length === 0)
@@ -1,27 +1,3 @@
1
- /**
2
- * Template Validation
3
- *
4
- * Provides validation utilities for stx templates before processing.
5
- * Checks for common syntax errors, structural issues, and potential security problems.
6
- */
7
- /**
8
- * Template validation error
9
- */
10
- export interface TemplateValidationError {
11
- type: 'syntax' | 'directive' | 'expression' | 'structure';
12
- message: string;
13
- line?: number;
14
- column?: number;
15
- suggestion?: string;
16
- }
17
- /**
18
- * Template validation result
19
- */
20
- export interface TemplateValidationResult {
21
- valid: boolean;
22
- errors: TemplateValidationError[];
23
- warnings: TemplateValidationError[];
24
- }
25
1
  /**
26
2
  * Validate a template before processing
27
3
  *
@@ -51,10 +27,7 @@ export declare function validateTemplate(template: string): TemplateValidationRe
51
27
  * @param position - Character position
52
28
  * @returns Line and column numbers (1-indexed)
53
29
  */
54
- export declare function getPositionInfo(template: string, position: number): {
55
- line: number;
56
- column: number;
57
- };
30
+ export declare function getPositionInfo(template: string, position: number): { line: number, column: number };
58
31
  /**
59
32
  * Validate a specific directive's syntax
60
33
  *
@@ -63,6 +36,7 @@ export declare function getPositionInfo(template: string, position: number): {
63
36
  * @param params - Parameters passed to the directive
64
37
  * @returns Validation errors, if any
65
38
  */
39
+ // eslint-disable-next-line pickier/no-unused-vars
66
40
  export declare function validateDirective(directiveName: string, content: string, params: string[]): TemplateValidationError[];
67
41
  /**
68
42
  * Check if a template has any directives
@@ -78,3 +52,27 @@ export declare function hasDirectives(template: string): boolean;
78
52
  * @returns Array of directive names (without @ prefix)
79
53
  */
80
54
  export declare function extractDirectiveNames(template: string): string[];
55
+ /**
56
+ * Template Validation
57
+ *
58
+ * Provides validation utilities for stx templates before processing.
59
+ * Checks for common syntax errors, structural issues, and potential security problems.
60
+ */
61
+ /**
62
+ * Template validation error
63
+ */
64
+ export declare interface TemplateValidationError {
65
+ type: 'syntax' | 'directive' | 'expression' | 'structure'
66
+ message: string
67
+ line?: number
68
+ column?: number
69
+ suggestion?: string
70
+ }
71
+ /**
72
+ * Template validation result
73
+ */
74
+ export declare interface TemplateValidationResult {
75
+ valid: boolean
76
+ errors: TemplateValidationError[]
77
+ warnings: TemplateValidationError[]
78
+ }
@@ -1,5 +1,4 @@
1
1
  import { STX_ENGINE_BINDING_NAMES } from './engine-bindings';
2
- export { STX_ENGINE_BINDING_NAMES };
3
2
  /**
4
3
  * Strip TypeScript-specific syntax to make it executable as JavaScript
5
4
  *
@@ -69,47 +68,6 @@ export declare function isModuleResolutionFailure(message: string): boolean;
69
68
  */
70
69
  export declare function isSyntaxFailure(error: unknown): boolean;
71
70
  export declare function isMissingBindingFailure(message: string): boolean;
72
- /**
73
- * Extract variables from script content and add them to context
74
- *
75
- * @param scriptContent - The JavaScript/TypeScript code from a <script> tag
76
- * @param context - The context object to populate with extracted variables
77
- * @param filePath - Path to the file (for error messages)
78
- */
79
- export interface ExtractVariablesOptions {
80
- /**
81
- * Don't overwrite a context key that already has a value. Use this
82
- * when extracting from a LAYOUT or PARTIAL `<script server>` so the
83
- * child page's identifier wins — layouts can declare stubs/defaults
84
- * (`const user = { avatarInitials: 'JD' }`) without clobbering the
85
- * full object the page set on the same name.
86
- *
87
- * Off by default: page-level extraction (in render.ts) still
88
- * overrides caller-supplied context values, matching pre-flag
89
- * behaviour. Only the layout/partial extraction path in process.ts
90
- * passes this flag on.
91
- */
92
- preserveExisting?: boolean;
93
- /**
94
- * Called when the script failed, so every variable it declared is undefined
95
- * and anything reading one renders empty (stacksjs/stx#1991).
96
- *
97
- * `kind` says how certain that is a bug. The first three always are.
98
- * `unknown` is not: a server script reaching for `window` or constructing a
99
- * Chart lands there, which is the case the quiet fallback exists for, so a
100
- * caller showing the developer something should leave that one alone.
101
- *
102
- * Reported rather than thrown, because one failed script must not take the
103
- * page down with it. Before this a caller could not find out at all: the
104
- * extractor warned and returned normally, which is why the component became
105
- * a hole that nothing could put a boundary around.
106
- */
107
- onFailure?: (failure: {
108
- kind: 'module-resolution' | 'syntax' | 'missing-binding' | 'unknown';
109
- message: string;
110
- error: unknown;
111
- }) => void;
112
- }
113
71
  export declare function extractVariables(scriptContent: string, context: Record<string, unknown>, filePath: string, options?: ExtractVariablesOptions): Promise<void>;
114
72
  /**
115
73
  * Convert ES module syntax to CommonJS
@@ -152,11 +110,7 @@ export declare function convertToCommonJS(scriptContent: string, filePath?: stri
152
110
  * Returns null when the line is not a simple declaration, which leaves the
153
111
  * destructuring and multi-line paths below to handle it as before.
154
112
  */
155
- export declare function splitDeclaration(line: string): {
156
- type: string;
157
- name: string;
158
- value: string;
159
- } | null;
113
+ export declare function splitDeclaration(line: string): { type: string, name: string, value: string } | null;
160
114
  /**
161
115
  * Extract script content from an HTML template
162
116
  *
@@ -164,8 +118,8 @@ export declare function splitDeclaration(line: string): {
164
118
  * @returns Object with script content and template without script tags
165
119
  */
166
120
  export declare function extractScriptFromTemplate(template: string): {
167
- scriptContent: string;
168
- templateWithoutScript: string;
121
+ scriptContent: string
122
+ templateWithoutScript: string
169
123
  };
170
124
  /**
171
125
  * Check if script content has any variables to extract
@@ -174,3 +128,19 @@ export declare function extractScriptFromTemplate(template: string): {
174
128
  * @returns Whether variables are present
175
129
  */
176
130
  export declare function hasVariables(scriptContent: string): boolean;
131
+ /**
132
+ * Extract variables from script content and add them to context
133
+ *
134
+ * @param scriptContent - The JavaScript/TypeScript code from a <script> tag
135
+ * @param context - The context object to populate with extracted variables
136
+ * @param filePath - Path to the file (for error messages)
137
+ */
138
+ export declare interface ExtractVariablesOptions {
139
+ preserveExisting?: boolean
140
+ onFailure?: (failure: {
141
+ kind: 'module-resolution' | 'syntax' | 'missing-binding' | 'unknown'
142
+ message: string
143
+ error: unknown
144
+ }) => void
145
+ }
146
+ export { STX_ENGINE_BINDING_NAMES };
@@ -1,83 +1,3 @@
1
- /**
2
- * View Composers Module
3
- *
4
- * Similar to Laravel's View Composers, this module allows registering callbacks
5
- * that automatically run whenever a specific view (or views matching a pattern)
6
- * is rendered. Use this to inject data into templates without manually passing
7
- * it every time.
8
- *
9
- * ## Use Cases
10
- *
11
- * - Inject user data into all views
12
- * - Add navigation data to layout templates
13
- * - Load settings for specific page types
14
- * - Populate dropdown options across forms
15
- *
16
- * ## Registration Methods
17
- *
18
- * ### Exact Match
19
- * ```typescript
20
- * import { composer } from 'stx'
21
- *
22
- * // Match by exact view name
23
- * composer('dashboard', async (context) => {
24
- * context.stats = await fetchDashboardStats()
25
- * })
26
- *
27
- * // Match by full file path
28
- * composer('/views/admin/users.stx', (context) => {
29
- * context.roles = ['admin', 'editor', 'viewer']
30
- * })
31
- * ```
32
- *
33
- * ### Pattern Match
34
- * ```typescript
35
- * import { composerPattern } from 'stx'
36
- *
37
- * // Match all admin views
38
- * composerPattern(/^admin/, (context) => {
39
- * context.isAdmin = true
40
- * })
41
- *
42
- * // Match with string pattern (converted to RegExp)
43
- * composerPattern('.*\\.settings\\.', (context) => {
44
- * context.settingsMenu = loadSettingsMenu()
45
- * })
46
- * ```
47
- *
48
- * ## Execution Order
49
- *
50
- * 1. Exact match composers (by full file path)
51
- * 2. Exact match composers (by view name only)
52
- * 3. Pattern match composers (in registration order)
53
- *
54
- * All composers for a matching view run in sequence.
55
- * Async composers are awaited before the next runs.
56
- *
57
- * ## Important Notes
58
- *
59
- * - Composers modify the context object directly (no return value needed)
60
- * - Composers are global and persist for the application lifetime
61
- * - Use `clearComposers()` to reset in tests
62
- *
63
- * @module view-composers
64
- */
65
- /**
66
- * Callback function type for view composers.
67
- *
68
- * @param context - The template context object (modify this directly)
69
- * @param filePath - Full path to the template file being rendered
70
- * @returns void or a Promise that resolves to void
71
- *
72
- * @example
73
- * ```typescript
74
- * const myComposer: ViewComposerCallback = async (context, filePath) => {
75
- * context.user = await getCurrentUser()
76
- * context.viewPath = filePath
77
- * }
78
- * ```
79
- */
80
- export type ViewComposerCallback = (context: Record<string, any>, filePath: string) => void | Promise<void>;
81
1
  /**
82
2
  * Register a composer for a specific view.
83
3
  *
@@ -169,3 +89,84 @@ export declare function runComposers(filePath: string, context: Record<string, a
169
89
  * ```
170
90
  */
171
91
  export declare function clearComposers(): void;
92
+ /**
93
+ * View Composers Module
94
+ *
95
+ * Similar to Laravel's View Composers, this module allows registering callbacks
96
+ * that automatically run whenever a specific view (or views matching a pattern)
97
+ * is rendered. Use this to inject data into templates without manually passing
98
+ * it every time.
99
+ *
100
+ * ## Use Cases
101
+ *
102
+ * - Inject user data into all views
103
+ * - Add navigation data to layout templates
104
+ * - Load settings for specific page types
105
+ * - Populate dropdown options across forms
106
+ *
107
+ * ## Registration Methods
108
+ *
109
+ * ### Exact Match
110
+ * ```typescript
111
+ * import { composer } from 'stx'
112
+ *
113
+ * // Match by exact view name
114
+ * composer('dashboard', async (context) => {
115
+ * context.stats = await fetchDashboardStats()
116
+ * })
117
+ *
118
+ * // Match by full file path
119
+ * composer('/views/admin/users.stx', (context) => {
120
+ * context.roles = ['admin', 'editor', 'viewer']
121
+ * })
122
+ * ```
123
+ *
124
+ * ### Pattern Match
125
+ * ```typescript
126
+ * import { composerPattern } from 'stx'
127
+ *
128
+ * // Match all admin views
129
+ * composerPattern(/^admin/, (context) => {
130
+ * context.isAdmin = true
131
+ * })
132
+ *
133
+ * // Match with string pattern (converted to RegExp)
134
+ * composerPattern('.*\\.settings\\.', (context) => {
135
+ * context.settingsMenu = loadSettingsMenu()
136
+ * })
137
+ * ```
138
+ *
139
+ * ## Execution Order
140
+ *
141
+ * 1. Exact match composers (by full file path)
142
+ * 2. Exact match composers (by view name only)
143
+ * 3. Pattern match composers (in registration order)
144
+ *
145
+ * All composers for a matching view run in sequence.
146
+ * Async composers are awaited before the next runs.
147
+ *
148
+ * ## Important Notes
149
+ *
150
+ * - Composers modify the context object directly (no return value needed)
151
+ * - Composers are global and persist for the application lifetime
152
+ * - Use `clearComposers()` to reset in tests
153
+ *
154
+ * @module view-composers
155
+ */
156
+ /**
157
+ * Callback function type for view composers.
158
+ *
159
+ * @param context - The template context object (modify this directly)
160
+ * @param filePath - Full path to the template file being rendered
161
+ * @returns void or a Promise that resolves to void
162
+ *
163
+ * @example
164
+ * ```typescript
165
+ * const myComposer: ViewComposerCallback = async (context, filePath) => {
166
+ * context.user = await getCurrentUser()
167
+ * context.viewPath = filePath
168
+ * }
169
+ * ```
170
+ */
171
+ // eslint-disable-next-line pickier/no-unused-vars
172
+ export type ViewComposerCallback = (context: Record<string, any>, filePath: string) => void | Promise<void>;
@@ -1,69 +1,3 @@
1
- /**
2
- * Virtual Scrolling Module
3
- *
4
- * Provides efficient rendering of large lists using windowing/virtualization.
5
- * Only renders items that are visible in the viewport, dramatically improving
6
- * performance for lists with thousands of items.
7
- *
8
- * @example
9
- * ```html
10
- * @virtualList(items, { itemHeight: 50, containerHeight: 400 })
11
- * <div class="item">{{ item.name }}</div>
12
- * @endvirtualList
13
- * ```
14
- */
15
- export interface VirtualListOptions {
16
- /** Height of each item in pixels */
17
- itemHeight: number;
18
- /** Height of the container in pixels */
19
- containerHeight: number;
20
- /** Number of items to render outside the visible area (buffer) */
21
- overscan?: number;
22
- /** Unique key property for items */
23
- keyProperty?: string;
24
- /** Enable dynamic item heights */
25
- dynamicHeight?: boolean;
26
- /** Estimated item height for dynamic heights */
27
- estimatedItemHeight?: number;
28
- /** Scroll behavior: 'auto' | 'smooth' */
29
- scrollBehavior?: 'auto' | 'smooth';
30
- /** Direction: 'vertical' | 'horizontal' */
31
- direction?: 'vertical' | 'horizontal';
32
- /** CSS class for the container */
33
- containerClass?: string;
34
- /** CSS class for the viewport */
35
- viewportClass?: string;
36
- /** CSS class for each item wrapper */
37
- itemClass?: string;
38
- }
39
- export interface VirtualListState {
40
- /** Start index of visible items */
41
- startIndex: number;
42
- /** End index of visible items */
43
- endIndex: number;
44
- /** Current scroll position */
45
- scrollTop: number;
46
- /** Total height of all items */
47
- totalHeight: number;
48
- /** Visible items */
49
- visibleItems: unknown[];
50
- /** Item heights cache for dynamic heights */
51
- itemHeights: Map<number, number>;
52
- }
53
- export interface VirtualScrollInstance {
54
- /** Scroll to a specific index */
55
- scrollToIndex: (index: number, behavior?: ScrollBehavior) => void;
56
- /** Scroll to a specific offset */
57
- scrollToOffset: (offset: number, behavior?: ScrollBehavior) => void;
58
- /** Get current scroll state */
59
- getState: () => VirtualListState;
60
- /** Force recalculation of visible items */
61
- refresh: () => void;
62
- /** Update items */
63
- setItems: (items: unknown[]) => void;
64
- /** Destroy the instance */
65
- destroy: () => void;
66
- }
67
1
  /**
68
2
  * Creates a virtual scroll instance for a list of items
69
3
  */
@@ -80,48 +14,95 @@ export declare function generateVirtualListCSS(): string;
80
14
  * Hook to create a reactive virtual list
81
15
  */
82
16
  export declare function useVirtualList<T>(items: () => T[], options: VirtualListOptions): {
83
- visibleItems: () => T[];
84
- totalHeight: () => number;
85
- containerProps: () => Record<string, unknown>;
86
- itemProps: (index: number) => Record<string, unknown>;
87
- scrollToIndex: (index: number) => void;
17
+ visibleItems: () => T[]
18
+ totalHeight: () => number
19
+ containerProps: () => Record<string, unknown>
20
+ itemProps: (index: number) => Record<string, unknown>
21
+ scrollToIndex: (index: number) => void
88
22
  };
89
- export interface InfiniteScrollOptions extends VirtualListOptions {
90
- /** Threshold in pixels before end to trigger load more */
91
- threshold?: number;
92
- /** Callback when more items should be loaded */
93
- onLoadMore?: () => Promise<void>;
94
- /** Whether more items are available */
95
- hasMore?: boolean;
96
- /** Loading state */
97
- isLoading?: boolean;
98
- }
99
23
  /**
100
24
  * Process @infiniteList directives for infinite scrolling
101
25
  */
102
26
  export declare function processInfiniteListDirectives(template: string, context?: Record<string, unknown>, _filePath?: string): string;
103
- export interface VirtualGridOptions {
104
- /** Number of columns */
105
- columns: number;
106
- /** Row height in pixels */
107
- rowHeight: number;
108
- /** Container height in pixels */
109
- containerHeight: number;
110
- /** Gap between items */
111
- gap?: number;
112
- /** Overscan rows */
113
- overscan?: number;
114
- }
115
27
  /**
116
28
  * Process @virtualGrid directives for grid virtualization
117
29
  */
118
30
  export declare function processVirtualGridDirectives(template: string, context?: Record<string, unknown>, _filePath?: string): string;
119
- declare const _default: {
120
- createVirtualList: typeof createVirtualList;
121
- processVirtualListDirectives: typeof processVirtualListDirectives;
122
- processInfiniteListDirectives: typeof processInfiniteListDirectives;
123
- processVirtualGridDirectives: typeof processVirtualGridDirectives;
124
- generateVirtualListCSS: typeof generateVirtualListCSS;
125
- useVirtualList: typeof useVirtualList;
31
+ declare const __dtsx_default_export__: {
32
+ createVirtualList: typeof createVirtualList;
33
+ processVirtualListDirectives: typeof processVirtualListDirectives;
34
+ processInfiniteListDirectives: typeof processInfiniteListDirectives;
35
+ processVirtualGridDirectives: typeof processVirtualGridDirectives;
36
+ generateVirtualListCSS: typeof generateVirtualListCSS;
37
+ useVirtualList: typeof useVirtualList
126
38
  };
127
- export default _default;
39
+ /* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
40
+ /**
41
+ * Virtual Scrolling Module
42
+ *
43
+ * Provides efficient rendering of large lists using windowing/virtualization.
44
+ * Only renders items that are visible in the viewport, dramatically improving
45
+ * performance for lists with thousands of items.
46
+ *
47
+ * @example
48
+ * ```html
49
+ * @virtualList(items, { itemHeight: 50, containerHeight: 400 })
50
+ * <div class="item">{{ item.name }}</div>
51
+ * @endvirtualList
52
+ * ```
53
+ */
54
+ // ============================================================================
55
+ // Types
56
+ // ============================================================================
57
+ export declare interface VirtualListOptions {
58
+ itemHeight: number
59
+ containerHeight: number
60
+ overscan?: number
61
+ keyProperty?: string
62
+ dynamicHeight?: boolean
63
+ estimatedItemHeight?: number
64
+ scrollBehavior?: 'auto' | 'smooth'
65
+ direction?: 'vertical' | 'horizontal'
66
+ containerClass?: string
67
+ viewportClass?: string
68
+ itemClass?: string
69
+ }
70
+ export declare interface VirtualListState {
71
+ startIndex: number
72
+ endIndex: number
73
+ scrollTop: number
74
+ totalHeight: number
75
+ visibleItems: unknown[]
76
+ itemHeights: Map<number, number>
77
+ }
78
+ export declare interface VirtualScrollInstance {
79
+ scrollToIndex: (index: number, behavior?: ScrollBehavior) => void
80
+ scrollToOffset: (offset: number, behavior?: ScrollBehavior) => void
81
+ getState: () => VirtualListState
82
+ refresh: () => void
83
+ setItems: (items: unknown[]) => void
84
+ destroy: () => void
85
+ }
86
+ // ============================================================================
87
+ // Infinite Scroll Support
88
+ // ============================================================================
89
+ export declare interface InfiniteScrollOptions extends VirtualListOptions {
90
+ threshold?: number
91
+ onLoadMore?: () => Promise<void>
92
+ hasMore?: boolean
93
+ isLoading?: boolean
94
+ }
95
+ // ============================================================================
96
+ // Grid Virtualization
97
+ // ============================================================================
98
+ export declare interface VirtualGridOptions {
99
+ columns: number
100
+ rowHeight: number
101
+ containerHeight: number
102
+ gap?: number
103
+ overscan?: number
104
+ }
105
+ // ============================================================================
106
+ // Exports
107
+ // ============================================================================
108
+ export default __dtsx_default_export__;
@@ -30,6 +30,15 @@ export declare function resetDefaultTester(): void;
30
30
  // Default Viewports
31
31
  // =============================================================================
32
32
  export declare const defaultViewports: Viewport[];
33
+ declare const __dtsx_default_export__: {
34
+ createSnapshotTester: typeof createSnapshotTester;
35
+ createVisualRegressionTester: typeof createVisualRegressionTester;
36
+ createStoryTester: typeof createStoryTester;
37
+ generateReport: typeof generateReport;
38
+ snapshot: typeof snapshot;
39
+ snapshotJson: typeof snapshotJson;
40
+ defaultViewports: typeof defaultViewports
41
+ };
33
42
  // =============================================================================
34
43
  // Types
35
44
  // =============================================================================
@@ -124,12 +133,4 @@ export declare interface ReportConfig {
124
133
  // =============================================================================
125
134
  // Exports
126
135
  // =============================================================================
127
- export default {
128
- createSnapshotTester,
129
- createVisualRegressionTester,
130
- createStoryTester,
131
- generateReport,
132
- snapshot,
133
- snapshotJson,
134
- defaultViewports,
135
- };
136
+ export default __dtsx_default_export__;