@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/head.d.ts CHANGED
@@ -1,137 +1,3 @@
1
- export interface MetaTag {
2
- name?: string;
3
- property?: string;
4
- content: string;
5
- httpEquiv?: string;
6
- charset?: string;
7
- }
8
- export interface LinkTag {
9
- rel: string;
10
- href: string;
11
- type?: string;
12
- sizes?: string;
13
- crossorigin?: string;
14
- as?: string;
15
- media?: string;
16
- }
17
- export interface ScriptTag {
18
- src?: string;
19
- type?: string;
20
- async?: boolean;
21
- defer?: boolean;
22
- content?: string;
23
- id?: string;
24
- }
25
- export interface HeadConfig {
26
- title?: string;
27
- titleTemplate?: string | ((title: string) => string);
28
- base?: {
29
- href?: string;
30
- target?: string;
31
- };
32
- meta?: MetaTag[];
33
- link?: LinkTag[];
34
- script?: ScriptTag[];
35
- style?: {
36
- content: string;
37
- type?: string;
38
- }[];
39
- htmlAttrs?: Record<string, string>;
40
- bodyAttrs?: Record<string, string>;
41
- }
42
- export interface SeoMeta {
43
- title?: string;
44
- titleTemplate?: string;
45
- description?: string;
46
- keywords?: string | string[];
47
- author?: string;
48
- robots?: string;
49
- canonical?: string;
50
- ogTitle?: string;
51
- ogDescription?: string;
52
- ogImage?: string;
53
- /** Describes the image for people who cannot see it. Also the card's alt. */
54
- ogImageAlt?: string;
55
- /** Pixel size, so a scraper can lay the card out before fetching the image. */
56
- ogImageWidth?: number;
57
- ogImageHeight?: number;
58
- /** MIME type, `image/jpeg` */
59
- ogImageType?: string;
60
- ogUrl?: string;
61
- ogType?: string;
62
- ogSiteName?: string;
63
- ogLocale?: string;
64
- profileFirstName?: string;
65
- profileLastName?: string;
66
- profileUsername?: string;
67
- twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player';
68
- twitterTitle?: string;
69
- twitterDescription?: string;
70
- twitterImage?: string;
71
- /** Defaults to `ogImageAlt` when the card falls back to `ogImage`. */
72
- twitterImageAlt?: string;
73
- twitterSite?: string;
74
- twitterCreator?: string;
75
- articleAuthor?: string;
76
- articlePublishedTime?: string;
77
- articleModifiedTime?: string;
78
- articleSection?: string;
79
- articleTags?: string[];
80
- }
81
- /**
82
- * Layouts that exist on disk, augmented by the generated
83
- * `<state-dir>/layout-types.d.ts` (stacksjs/stx#1879).
84
- *
85
- * Empty here on purpose. A project that has not generated the declaration —
86
- * or has not added the state directory to its tsconfig — keeps `layout` typed
87
- * as `string`, so nothing breaks; a project that has gets a type error for a
88
- * name with no layout behind it.
89
- */
90
- export interface KnownLayouts {
91
- }
92
- /**
93
- * A layout name: the generated union when one is available, otherwise any
94
- * string.
95
- *
96
- * `keyof KnownLayouts` is `never` while the interface is empty, which is what
97
- * makes the fallback work.
98
- */
99
- export type LayoutName = keyof KnownLayouts extends never ? string : keyof KnownLayouts;
100
- export interface PageMeta {
101
- title?: string;
102
- description?: string;
103
- /** Static HTTP response status for this page. */
104
- status?: number;
105
- /**
106
- * Layout for this page, by name (`'app'` → `<layoutsDir>/app.stx`), or
107
- * `false` for none — the same as `@nolayout`.
108
- *
109
- * Precedence: `@extends`/`@layout` in the template wins, then this, then an
110
- * auto-discovered `_layout.stx`, then `defaultLayout`.
111
- *
112
- * Do NOT hand-write `<meta name="stx-layout" content="…">` instead. That tag
113
- * is stx *output*: the router reads it to decide between a fragment swap and
114
- * a full-document swap, and a page asserting a group it does not belong to
115
- * mis-routes rather than mis-styles. This field is the authoring surface; the
116
- * meta tag is derived from the layout that actually resolved (#1879).
117
- *
118
- * Typed as the union of layouts on disk when the generated
119
- * `<state-dir>/layout-types.d.ts` is in scope, so a typo is a type error
120
- * rather than an unlayouted page.
121
- */
122
- layout?: LayoutName | false;
123
- middleware?: string | string[];
124
- transition?: string | {
125
- name: string;
126
- mode?: string;
127
- };
128
- keepAlive?: boolean;
129
- key?: string | ((route: unknown) => string);
130
- validate?: (route: {
131
- params: Record<string, string>;
132
- }) => boolean | Promise<boolean>;
133
- [key: string]: unknown;
134
- }
135
1
  /**
136
2
  * Get the current accumulated head config.
137
3
  */
@@ -238,10 +104,7 @@ export declare function applyHead(config?: HeadConfig): void;
238
104
  * @endhead
239
105
  * ```
240
106
  */
241
- export declare function processHeadDirective(content: string): {
242
- content: string;
243
- headContent: string;
244
- };
107
+ export declare function processHeadDirective(content: string): { content: string; headContent: string };
245
108
  /**
246
109
  * Process @title directive.
247
110
  *
@@ -268,4 +131,112 @@ export declare function processTitleDirective(content: string, context: Record<s
268
131
  * ```
269
132
  */
270
133
  export declare function processMetaDirective(content: string, context: Record<string, unknown>, filePath?: string): string;
271
- export { usePageTitle as useTitle };
134
+ // =============================================================================
135
+ // Types
136
+ // =============================================================================
137
+ export declare interface MetaTag {
138
+ name?: string
139
+ property?: string
140
+ content: string
141
+ httpEquiv?: string
142
+ charset?: string
143
+ }
144
+ export declare interface LinkTag {
145
+ rel: string
146
+ href: string
147
+ type?: string
148
+ sizes?: string
149
+ crossorigin?: string
150
+ as?: string
151
+ media?: string
152
+ }
153
+ export declare interface ScriptTag {
154
+ src?: string
155
+ type?: string
156
+ async?: boolean
157
+ defer?: boolean
158
+ content?: string
159
+ id?: string
160
+ }
161
+ export declare interface HeadConfig {
162
+ title?: string
163
+ titleTemplate?: string | ((title: string) => string)
164
+ base?: { href?: string; target?: string }
165
+ meta?: MetaTag[]
166
+ link?: LinkTag[]
167
+ script?: ScriptTag[]
168
+ style?: { content: string; type?: string }[]
169
+ htmlAttrs?: Record<string, string>
170
+ bodyAttrs?: Record<string, string>
171
+ }
172
+ export declare interface SeoMeta {
173
+ title?: string
174
+ titleTemplate?: string
175
+ description?: string
176
+ keywords?: string | string[]
177
+ author?: string
178
+ robots?: string
179
+ canonical?: string
180
+ ogTitle?: string
181
+ ogDescription?: string
182
+ ogImage?: string
183
+ ogImageAlt?: string
184
+ ogImageWidth?: number
185
+ ogImageHeight?: number
186
+ ogImageType?: string
187
+ ogUrl?: string
188
+ ogType?: string
189
+ ogSiteName?: string
190
+ ogLocale?: string
191
+ profileFirstName?: string
192
+ profileLastName?: string
193
+ profileUsername?: string
194
+ twitterCard?: 'summary' | 'summary_large_image' | 'app' | 'player'
195
+ twitterTitle?: string
196
+ twitterDescription?: string
197
+ twitterImage?: string
198
+ twitterImageAlt?: string
199
+ twitterSite?: string
200
+ twitterCreator?: string
201
+ articleAuthor?: string
202
+ articlePublishedTime?: string
203
+ articleModifiedTime?: string
204
+ articleSection?: string
205
+ articleTags?: string[]
206
+ }
207
+ /**
208
+ * Layouts that exist on disk, augmented by the generated
209
+ * `<state-dir>/layout-types.d.ts` (stacksjs/stx#1879).
210
+ *
211
+ * Empty here on purpose. A project that has not generated the declaration —
212
+ * or has not added the state directory to its tsconfig — keeps `layout` typed
213
+ * as `string`, so nothing breaks; a project that has gets a type error for a
214
+ * name with no layout behind it.
215
+ */
216
+ export declare interface KnownLayouts {}
217
+ export declare interface PageMeta {
218
+ title?: string
219
+ description?: string
220
+ status?: number
221
+ layout?: LayoutName | false
222
+ middleware?: string | string[]
223
+ transition?: string | { name: string; mode?: string }
224
+ keepAlive?: boolean
225
+ key?: string | ((route: unknown) => string)
226
+ validate?: (route: { params: Record<string, string> }) => boolean | Promise<boolean>
227
+ [key: string]: unknown
228
+ }
229
+ /**
230
+ * A layout name: the generated union when one is available, otherwise any
231
+ * string.
232
+ *
233
+ * `keyof KnownLayouts` is `never` while the interface is empty, which is what
234
+ * makes the fallback work.
235
+ */
236
+ export type LayoutName = keyof KnownLayouts extends never ? string : keyof KnownLayouts;
237
+ // =============================================================================
238
+ // Exports
239
+ // =============================================================================
240
+ export {
241
+ usePageTitle as useTitle
242
+ };
package/dist/heatmap.d.ts CHANGED
@@ -1,4 +1,29 @@
1
1
  import type { CustomDirective, StxOptions } from './types';
2
+ /**
3
+ * Generate heatmap tracking script based on configuration
4
+ */
5
+ export declare function generateHeatmapScript(options: StxOptions): string;
6
+ /**
7
+ * Inject heatmap script into HTML
8
+ * Scripts are injected just before </body> for optimal loading
9
+ */
10
+ export declare function injectHeatmap(html: string, options: StxOptions): string;
11
+ /**
12
+ * Parse inline heatmap configuration from directive parameters
13
+ */
14
+ declare function parseInlineConfig(paramsStr: string): Partial<HeatmapConfig>;
15
+ /**
16
+ * Create a heatmap aggregator instance
17
+ */
18
+ export declare function createHeatmapAggregator(): HeatmapAggregator;
19
+ /**
20
+ * Default heatmap configuration
21
+ */
22
+ export declare const defaultHeatmapConfig: HeatmapConfig;
23
+ /**
24
+ * Custom @heatmap directive for explicit placement
25
+ */
26
+ export declare const heatmapDirective: CustomDirective;
2
27
  /**
3
28
  * Heatmap Module
4
29
  *
@@ -33,174 +58,73 @@ import type { CustomDirective, StxOptions } from './types';
33
58
  /**
34
59
  * Heatmap tracking configuration
35
60
  */
36
- export interface HeatmapConfig {
37
- /** Enable heatmap tracking */
38
- enabled: boolean;
39
- /** Track mouse movements */
40
- trackMouse?: boolean;
41
- /** Track click events */
42
- trackClicks?: boolean;
43
- /** Track scroll depth */
44
- trackScroll?: boolean;
45
- /** Sampling rate in milliseconds for mouse tracking (default: 100ms) */
46
- samplingRate?: number;
47
- /** Honor Do Not Track browser setting */
48
- honorDnt?: boolean;
49
- /** API endpoint for sending heatmap data */
50
- endpoint?: string;
51
- /** Batch size before sending data (default: 50) */
52
- batchSize?: number;
53
- /** Maximum data points to store locally (default: 1000) */
54
- maxDataPoints?: number;
55
- /** Session timeout in minutes (default: 30) */
56
- sessionTimeout?: number;
57
- /** Enable local storage for offline data */
58
- persistData?: boolean;
59
- /** Storage key prefix (default: 'stx_heatmap') */
60
- storagePrefix?: string;
61
- /** Custom data attributes to capture on clicks */
62
- captureAttributes?: string[];
63
- /** Element selectors to ignore */
64
- ignoreSelectors?: string[];
65
- /** Zone definitions for grouped tracking */
66
- zones?: HeatmapZone[];
67
- /** Enable visual overlay for development */
68
- debugOverlay?: boolean;
69
- /** Minimum viewport width to track (mobile optimization) */
70
- minViewportWidth?: number;
71
- /** Maximum viewport width to track */
72
- maxViewportWidth?: number;
61
+ export declare interface HeatmapConfig {
62
+ enabled: boolean
63
+ trackMouse?: boolean
64
+ trackClicks?: boolean
65
+ trackScroll?: boolean
66
+ samplingRate?: number
67
+ honorDnt?: boolean
68
+ endpoint?: string
69
+ batchSize?: number
70
+ maxDataPoints?: number
71
+ sessionTimeout?: number
72
+ persistData?: boolean
73
+ storagePrefix?: string
74
+ captureAttributes?: string[]
75
+ ignoreSelectors?: string[]
76
+ zones?: HeatmapZone[]
77
+ debugOverlay?: boolean
78
+ minViewportWidth?: number
79
+ maxViewportWidth?: number
73
80
  }
74
81
  /**
75
82
  * Zone definition for grouped tracking
76
83
  */
77
- export interface HeatmapZone {
78
- /** Zone identifier */
79
- id: string;
80
- /** CSS selector for the zone */
81
- selector: string;
82
- /** Zone label for reports */
83
- label?: string;
84
+ export declare interface HeatmapZone {
85
+ id: string
86
+ selector: string
87
+ label?: string
84
88
  }
85
89
  /**
86
90
  * Heatmap data point
87
91
  */
88
- export interface HeatmapDataPoint {
89
- /** X coordinate (percentage of viewport) */
90
- x: number;
91
- /** Y coordinate (percentage of viewport) */
92
- y: number;
93
- /** Type of interaction */
94
- type: 'move' | 'click' | 'scroll';
95
- /** Timestamp */
96
- t: number;
97
- /** Element selector (for clicks) */
98
- el?: string;
99
- /** Zone ID if within a defined zone */
100
- zone?: string;
101
- /** Scroll depth percentage (for scroll events) */
102
- depth?: number;
103
- /** Custom attributes captured */
104
- attrs?: Record<string, string>;
92
+ export declare interface HeatmapDataPoint {
93
+ x: number
94
+ y: number
95
+ type: 'move' | 'click' | 'scroll'
96
+ t: number
97
+ el?: string
98
+ zone?: string
99
+ depth?: number
100
+ attrs?: Record<string, string>
105
101
  }
106
102
  /**
107
103
  * Heatmap session data
108
104
  */
109
- export interface HeatmapSession {
110
- /** Anonymous session ID */
111
- sid: string;
112
- /** Page URL (path only, no query params for privacy) */
113
- page: string;
114
- /** Viewport width */
115
- vw: number;
116
- /** Viewport height */
117
- vh: number;
118
- /** Data points */
119
- points: HeatmapDataPoint[];
120
- /** Session start time */
121
- started: number;
122
- /** Last activity time */
123
- lastActivity: number;
105
+ export declare interface HeatmapSession {
106
+ sid: string
107
+ page: string
108
+ vw: number
109
+ vh: number
110
+ points: HeatmapDataPoint[]
111
+ started: number
112
+ lastActivity: number
124
113
  }
125
- /**
126
- * Default heatmap configuration
127
- */
128
- export declare const defaultHeatmapConfig: HeatmapConfig;
129
- /**
130
- * Generate heatmap tracking script based on configuration
131
- */
132
- export declare function generateHeatmapScript(options: StxOptions): string;
133
- /**
134
- * Inject heatmap script into HTML
135
- * Scripts are injected just before </body> for optimal loading
136
- */
137
- export declare function injectHeatmap(html: string, options: StxOptions): string;
138
- /**
139
- * Custom @heatmap directive for explicit placement
140
- */
141
- export declare const heatmapDirective: CustomDirective;
142
114
  /**
143
115
  * Server-side heatmap data aggregator
144
116
  * For processing collected heatmap data into visualizations
145
117
  */
146
118
  export declare class HeatmapAggregator {
147
- private sessions;
148
- /**
149
- * Add session data
150
- */
151
- addSession(data: HeatmapSession): void;
152
- /**
153
- * Get aggregated data for a page
154
- */
155
- getPageData(page: string): HeatmapDataPoint[];
156
- /**
157
- * Get click heatmap data
158
- */
159
- getClickData(page: string): HeatmapDataPoint[];
160
- /**
161
- * Get movement heatmap data
162
- */
163
- getMovementData(page: string): HeatmapDataPoint[];
164
- /**
165
- * Get scroll depth data
166
- */
167
- getScrollData(page: string): {
168
- depth: number;
169
- count: number;
170
- }[];
171
- /**
172
- * Get zone interaction statistics
173
- */
174
- getZoneStats(page: string): Map<string, {
175
- clicks: number;
176
- hovers: number;
177
- }>;
178
- /**
179
- * Generate heatmap grid data (for server-side rendering)
180
- */
181
- generateGridData(page: string, gridSize?: number): {
182
- x: number;
183
- y: number;
184
- intensity: number;
185
- }[][];
186
- /**
187
- * Export all data as JSON
188
- */
189
- exportJSON(): string;
190
- /**
191
- * Clear all data
192
- */
193
- clear(): void;
194
- /**
195
- * Get session count
196
- */
197
- get sessionCount(): number;
198
- /**
199
- * Get total data points
200
- */
201
- get totalPoints(): number;
119
+ addSession(data: HeatmapSession): void;
120
+ getPageData(page: string): HeatmapDataPoint[];
121
+ getClickData(page: string): HeatmapDataPoint[];
122
+ getMovementData(page: string): HeatmapDataPoint[];
123
+ getScrollData(page: string): { depth: number, count: number }[];
124
+ getZoneStats(page: string): Map<string, { clicks: number, hovers: number }>;
125
+ generateGridData(page: string, gridSize?: number): { x: number, y: number, intensity: number }[][];
126
+ exportJSON(): string;
127
+ clear(): void;
128
+ get sessionCount(): number;
129
+ get totalPoints(): number;
202
130
  }
203
- /**
204
- * Create a heatmap aggregator instance
205
- */
206
- export declare function createHeatmapAggregator(): HeatmapAggregator;
@@ -1,35 +1,3 @@
1
- /**
2
- * Element-position-aware masking.
3
- *
4
- * Several pipeline stages temporarily replace `<script>…</script>` bodies or
5
- * `<!-- … -->` comments with sentinel placeholders so later passes don't process
6
- * their contents, then restore them at the end. A naive global regex
7
- * (`/<script…>…<\/script>/g`, `/<!--…-->/g`) also matches such a token when it
8
- * appears INSIDE a quoted attribute value — e.g. `aria-label="<script>x</script>"`
9
- * or `title="<!-- "><img onerror=alert(1)> -->"`. The renderer's HTML-escaping
10
- * then runs against the harmless placeholder, and the raw token is restored into
11
- * the attribute afterward, breaking out of it — an XSS.
12
- *
13
- * `maskAtElementPosition` walks the string tracking tag/attribute/quote state and
14
- * only masks tokens that begin at *element position* (not within an open tag, not
15
- * inside a quoted attribute value). A token embedded in an attribute is left in
16
- * place to be escaped normally.
17
- *
18
- * This is a leaf module (no stx imports) so any stage can use it without risking
19
- * an import cycle.
20
- *
21
- * @module html-masking
22
- */
23
- /**
24
- * Locate a maskable token starting at `html[i]`.
25
- * @returns the end index (exclusive) of the token, or -1 if none starts here.
26
- */
27
- export type TokenMatcher = (html: string, i: number) => number;
28
- export interface ElementPositionToken {
29
- start: number;
30
- end: number;
31
- token: string;
32
- }
33
1
  /** Matches a real `<script…>…</script>` element (through the first `</script>`). */
34
2
  export declare function matchScriptElement(html: string, i: number): number;
35
3
  /** Matches a real `<style…>…</style>` element (through the first `</style>`). */
@@ -81,36 +49,7 @@ export declare function clearMaskCache(): void;
81
49
  * Note: HTML attributes do not use backslash escaping, so a `"`/`'` always
82
50
  * toggles the surrounding quote — matching how browsers parse attribute values.
83
51
  */
84
- export declare function maskAtElementPosition(html: string, match: TokenMatcher, placeholder: (token: string, index: number) => string,
85
- /**
86
- * Opt in to memoisation. Must fully determine what `placeholder` returns for
87
- * a given index — two calls sharing a key MUST be interchangeable.
88
- */
89
- cacheKey?: string): {
90
- output: string;
91
- tokens: string[];
92
- };
93
- export interface StashedScripts {
94
- /** The document with each `<script>` element replaced by a NUL sentinel. */
95
- output: string;
96
- /** The removed script elements, in placeholder order. */
97
- scripts: string[];
98
- /**
99
- * Put the scripts back.
100
- *
101
- * Returns the pre-stash document unchanged when `html` is still the masked
102
- * output. Stashing replaces each script with a sentinel and restoring puts
103
- * exactly those scripts back at exactly those sentinels, so when nothing
104
- * edited the masked document in between, the replace pass can only rebuild,
105
- * character by character, a string the caller already handed us.
106
- *
107
- * That is the common case, not a corner: one render of the #1945 fixture
108
- * reaches this having changed nothing in FOUR of five passes, rebuilding
109
- * 445,208 bytes to arrive back where it started. The component loop stashes
110
- * on every pass but only the first pass resolves anything.
111
- */
112
- restore: (html: string) => string;
113
- }
52
+ export declare function maskAtElementPosition(html: string, match: TokenMatcher, placeholder: (token: string, index: number) => string, cacheKey?: string): { output: string, tokens: string[] };
114
53
  export declare function stashScriptElements(html: string): StashedScripts;
115
54
  /**
116
55
  * Drop cached stash results.
@@ -123,3 +62,40 @@ export declare function stashScriptElements(html: string): StashedScripts;
123
62
  export declare function clearStashCache(): void;
124
63
  /** Restore scripts stashed by {@link stashScriptElements}. */
125
64
  export declare function restoreStashedScripts(html: string, scripts: string[]): string;
65
+ export declare interface ElementPositionToken {
66
+ start: number
67
+ end: number
68
+ token: string
69
+ }
70
+ export declare interface StashedScripts {
71
+ output: string
72
+ scripts: string[]
73
+ restore: (html: string) => string
74
+ }
75
+ /**
76
+ * Element-position-aware masking.
77
+ *
78
+ * Several pipeline stages temporarily replace `<script>…</script>` bodies or
79
+ * `<!-- … -->` comments with sentinel placeholders so later passes don't process
80
+ * their contents, then restore them at the end. A naive global regex
81
+ * (`/<script…>…<\/script>/g`, `/<!--…-->/g`) also matches such a token when it
82
+ * appears INSIDE a quoted attribute value — e.g. `aria-label="<script>x</script>"`
83
+ * or `title="<!-- "><img onerror=alert(1)> -->"`. The renderer's HTML-escaping
84
+ * then runs against the harmless placeholder, and the raw token is restored into
85
+ * the attribute afterward, breaking out of it — an XSS.
86
+ *
87
+ * `maskAtElementPosition` walks the string tracking tag/attribute/quote state and
88
+ * only masks tokens that begin at *element position* (not within an open tag, not
89
+ * inside a quoted attribute value). A token embedded in an attribute is left in
90
+ * place to be escaped normally.
91
+ *
92
+ * This is a leaf module (no stx imports) so any stage can use it without risking
93
+ * an import cycle.
94
+ *
95
+ * @module html-masking
96
+ */
97
+ /**
98
+ * Locate a maskable token starting at `html[i]`.
99
+ * @returns the end index (exclusive) of the token, or -1 if none starts here.
100
+ */
101
+ export type TokenMatcher = (html: string, i: number) => number;
@@ -1,23 +1,3 @@
1
- /**
2
- * Unified Hydration Runtime for Islands Architecture
3
- *
4
- * Replaces the per-strategy inline scripts with a single runtime that handles
5
- * all hydration strategies. Injected once per page when islands are present.
6
- *
7
- * The runtime:
8
- * 1. Component registry — maps names to dynamic imports
9
- * 2. hydrateIsland(element) — loads component, reads props, calls hydrate/mount
10
- * 3. Strategy dispatcher — sets up triggers per data-strategy attribute
11
- * 4. initIslands() — processes all .stx-island:not(.hydrated) on DOMContentLoaded
12
- *
13
- * @module hydration-runtime
14
- */
15
- export interface IslandMeta {
16
- id: string;
17
- component: string;
18
- strategy: string;
19
- props: Record<string, unknown>;
20
- }
21
1
  /**
22
2
  * Generate the unified hydration bootstrap script.
23
3
  *
@@ -42,3 +22,27 @@ export declare function extractComponentName(content: string): string | null;
42
22
  * Parses :prop="value" bindings.
43
23
  */
44
24
  export declare function extractBoundProps(content: string, context: Record<string, unknown>): Record<string, unknown>;
25
+ /* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
26
+ /**
27
+ * Unified Hydration Runtime for Islands Architecture
28
+ *
29
+ * Replaces the per-strategy inline scripts with a single runtime that handles
30
+ * all hydration strategies. Injected once per page when islands are present.
31
+ *
32
+ * The runtime:
33
+ * 1. Component registry — maps names to dynamic imports
34
+ * 2. hydrateIsland(element) — loads component, reads props, calls hydrate/mount
35
+ * 3. Strategy dispatcher — sets up triggers per data-strategy attribute
36
+ * 4. initIslands() — processes all .stx-island:not(.hydrated) on DOMContentLoaded
37
+ *
38
+ * @module hydration-runtime
39
+ */
40
+ // ============================================================================
41
+ // Types
42
+ // ============================================================================
43
+ export declare interface IslandMeta {
44
+ id: string
45
+ component: string
46
+ strategy: string
47
+ props: Record<string, unknown>
48
+ }