@stacksjs/stx 0.2.572 → 0.2.573

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 (381) 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-f4jh9vrj.js → chunk-0s647d0b.js} +53 -53
  35. package/dist/{chunk-09gtbb1w.js → chunk-1bsafdnt.js} +1 -1
  36. package/dist/{chunk-m6mxqepz.js → chunk-1btr5tme.js} +1 -1
  37. package/dist/{chunk-01mxer9s.js → chunk-2g6wcnna.js} +1 -1
  38. package/dist/{chunk-rrj5m9xv.js → chunk-2hg2bqtj.js} +1 -1
  39. package/dist/{chunk-xckzvbvn.js → chunk-4f0fh2a9.js} +1 -1
  40. package/dist/chunk-557wtdps.js +2 -0
  41. package/dist/{chunk-vr36s2en.js → chunk-58vrf6kh.js} +1 -1
  42. package/dist/{chunk-qzbzn1yf.js → chunk-6tsnz28m.js} +1 -1
  43. package/dist/{chunk-cvswrbzw.js → chunk-6x8cwscv.js} +1 -1
  44. package/dist/{chunk-1n64749x.js → chunk-74ew8ajw.js} +1 -1
  45. package/dist/{chunk-jqefcghh.js → chunk-78d6yyxz.js} +2 -2
  46. package/dist/{chunk-83fdt4yj.js → chunk-824cnbac.js} +1 -1
  47. package/dist/{chunk-ntgy4e1q.js → chunk-864xm0jy.js} +1 -1
  48. package/dist/{chunk-nn174xjh.js → chunk-9fbkdrm8.js} +1 -1
  49. package/dist/{chunk-kzjrgh0b.js → chunk-a3gvw1q2.js} +1 -1
  50. package/dist/{chunk-pqcvh9pp.js → chunk-amtrg7pn.js} +1 -1
  51. package/dist/{chunk-pw9verqx.js → chunk-b5fpsp5n.js} +1 -1
  52. package/dist/{chunk-5afw7z6v.js → chunk-bcjr3fw7.js} +1 -1
  53. package/dist/{chunk-n6qp05t9.js → chunk-bkj0j5se.js} +1 -1
  54. package/dist/{chunk-mzqyv7s5.js → chunk-cf97xdqa.js} +1 -1
  55. package/dist/{chunk-cgwyd9aq.js → chunk-cr67dpx4.js} +1 -1
  56. package/dist/{chunk-f1apaqfk.js → chunk-dpqvacd1.js} +1 -1
  57. package/dist/{chunk-ghy82tsc.js → chunk-et8726at.js} +1 -1
  58. package/dist/{chunk-4bgfpkwx.js → chunk-ev8t5cxk.js} +1 -1
  59. package/dist/{chunk-s34g3awk.js → chunk-fynh3bkq.js} +1 -1
  60. package/dist/{chunk-gzgc8zk5.js → chunk-g8757f97.js} +2 -2
  61. package/dist/{chunk-3gft8zng.js → chunk-hm4j4d8q.js} +1 -1
  62. package/dist/{chunk-0bt0fbs1.js → chunk-j9qy9t3t.js} +5 -5
  63. package/dist/{chunk-2a1q5y6r.js → chunk-jhc47xzj.js} +1 -1
  64. package/dist/{chunk-79vdkvhf.js → chunk-kns5m52j.js} +1 -1
  65. package/dist/{chunk-2cqbyb8w.js → chunk-mjpewk4r.js} +1 -1
  66. package/dist/{chunk-2jjff8kv.js → chunk-nj488tj2.js} +2 -2
  67. package/dist/{chunk-dcpf6kas.js → chunk-q9chv68c.js} +1 -1
  68. package/dist/{chunk-xq2ck69k.js → chunk-qm280dp3.js} +1 -1
  69. package/dist/{chunk-ymawe0y5.js → chunk-sjcstv33.js} +1 -1
  70. package/dist/{chunk-tc5r2vmw.js → chunk-t0zdz8kd.js} +1 -1
  71. package/dist/{chunk-jwvzvapp.js → chunk-t3dnak1j.js} +1 -1
  72. package/dist/{chunk-2jsnrfc8.js → chunk-t64nnmmj.js} +1 -1
  73. package/dist/{chunk-m2a1fxpb.js → chunk-tvb8p7c0.js} +1 -1
  74. package/dist/{chunk-6f4qrd0s.js → chunk-tyhgq6rw.js} +1 -1
  75. package/dist/{chunk-4wfr074d.js → chunk-vn7tc8hm.js} +1 -1
  76. package/dist/{chunk-y4ajd836.js → chunk-xy6g8zb9.js} +1 -1
  77. package/dist/{chunk-zddzjd60.js → chunk-ya7xks9t.js} +1 -1
  78. package/dist/chunk-zpz6q2fh.js +2 -0
  79. package/dist/chunk-zxt94g45.js +2 -0
  80. package/dist/{chunk-cyg9w31a.js → chunk-zz7tw07b.js} +1 -1
  81. package/dist/{chunk-ta8bhz27.js → chunk-zzcxacjf.js} +1 -1
  82. package/dist/cli.js +7 -7
  83. package/dist/client/directive.d.ts +0 -7
  84. package/dist/client/index.d.ts +1 -0
  85. package/dist/client/signals-appearance-runtime.d.ts +1 -1
  86. package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
  87. package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
  88. package/dist/client/signals-class-runtime.d.ts +1 -1
  89. package/dist/client/signals-component-api-runtime.d.ts +1 -1
  90. package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
  91. package/dist/client/signals-component-props-runtime.d.ts +1 -1
  92. package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
  93. package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
  94. package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
  95. package/dist/client/signals-context-runtime.d.ts +1 -1
  96. package/dist/client/signals-cookie-runtime.d.ts +1 -1
  97. package/dist/client/signals-devtools-runtime.d.ts +1 -1
  98. package/dist/client/signals-dialog-runtime.d.ts +1 -1
  99. package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
  100. package/dist/client/signals-drawer-runtime.d.ts +1 -1
  101. package/dist/client/signals-effect-runtime.d.ts +1 -1
  102. package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
  103. package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
  104. package/dist/client/signals-expression-runtime.d.ts +1 -1
  105. package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
  106. package/dist/client/signals-for-runtime.d.ts +1 -1
  107. package/dist/client/signals-globals-runtime.d.ts +1 -1
  108. package/dist/client/signals-handler-runtime.d.ts +1 -1
  109. package/dist/client/signals-head-runtime.d.ts +1 -1
  110. package/dist/client/signals-helpers-runtime.d.ts +1 -1
  111. package/dist/client/signals-host-runtime.d.ts +1 -1
  112. package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
  113. package/dist/client/signals-hydration-runtime.d.ts +1 -1
  114. package/dist/client/signals-if-chain-runtime.d.ts +1 -1
  115. package/dist/client/signals-if-runtime.d.ts +1 -1
  116. package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
  117. package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
  118. package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
  119. package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
  120. package/dist/client/signals-loop-row-runtime.d.ts +1 -1
  121. package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
  122. package/dist/client/signals-model-runtime.d.ts +1 -1
  123. package/dist/client/signals-mount-runtime.d.ts +1 -1
  124. package/dist/client/signals-navigation-runtime.d.ts +1 -1
  125. package/dist/client/signals-notify-runtime.d.ts +1 -1
  126. package/dist/client/signals-optimistic-runtime.d.ts +1 -1
  127. package/dist/client/signals-overlay-runtime.d.ts +1 -1
  128. package/dist/client/signals-pipe-runtime.d.ts +1 -1
  129. package/dist/client/signals-proxy-runtime.d.ts +1 -1
  130. package/dist/client/signals-query-runtime.d.ts +1 -1
  131. package/dist/client/signals-reactive-runtime.d.ts +1 -1
  132. package/dist/client/signals-ref-runtime.d.ts +1 -1
  133. package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
  134. package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
  135. package/dist/client/signals-show-runtime.d.ts +1 -1
  136. package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
  137. package/dist/client/signals-spa-load-runtime.d.ts +1 -1
  138. package/dist/client/signals-state-runtime.d.ts +1 -1
  139. package/dist/client/signals-storage-runtime.d.ts +1 -1
  140. package/dist/client/signals-store-registry-runtime.d.ts +1 -1
  141. package/dist/client/signals-style-runtime.d.ts +1 -1
  142. package/dist/client/signals-suspense-runtime.d.ts +1 -1
  143. package/dist/client/signals-timer-runtime.d.ts +1 -1
  144. package/dist/client/signals-toast-runtime.d.ts +1 -1
  145. package/dist/client/signals-tooltip-runtime.d.ts +1 -1
  146. package/dist/client/signals-transition-group-runtime.d.ts +1 -1
  147. package/dist/client/signals-websocket-runtime.d.ts +1 -1
  148. package/dist/client-helpers.d.ts +1 -312
  149. package/dist/client-module-registry.d.ts +4 -27
  150. package/dist/client-parameter-bindings.d.ts +1 -4
  151. package/dist/client-script-bundler.d.ts +55 -103
  152. package/dist/client-script.d.ts +69 -127
  153. package/dist/color-mode-boot.d.ts +21 -58
  154. package/dist/component-client-factories.d.ts +8 -9
  155. package/dist/component-contract-checks.d.ts +15 -18
  156. package/dist/component-contract.d.ts +6 -6
  157. package/dist/component-hmr.d.ts +8 -7
  158. package/dist/component-model.d.ts +14 -20
  159. package/dist/component-processing.d.ts +51 -59
  160. package/dist/component-registry.d.ts +28 -99
  161. package/dist/component-renderer.d.ts +19 -16
  162. package/dist/component-resolution.d.ts +8 -8
  163. package/dist/component-tags.d.ts +1 -1
  164. package/dist/composable-loader.d.ts +6 -41
  165. package/dist/composables/use-fetch.d.ts +45 -114
  166. package/dist/composables/use-form.d.ts +2 -56
  167. package/dist/composables/use-intersection-observer.d.ts +1 -1
  168. package/dist/composables.d.ts +75 -74
  169. package/dist/composition-api.d.ts +19 -43
  170. package/dist/computed.d.ts +93 -86
  171. package/dist/conditionals.d.ts +0 -24
  172. package/dist/config.d.ts +30 -24
  173. package/dist/config.js +3 -0
  174. package/dist/craft-bridge.d.ts +1 -467
  175. package/dist/craft-components.d.ts +234 -680
  176. package/dist/craft-entry.js +1 -1
  177. package/dist/craft.js +1 -1
  178. package/dist/csp.d.ts +41 -107
  179. package/dist/database.d.ts +1 -1
  180. package/dist/defer.d.ts +0 -24
  181. package/dist/dev-server/terminal-colors.d.ts +32 -32
  182. package/dist/dev-server/ts-css.d.ts +26 -35
  183. package/dist/dev-server/types.d.ts +33 -29
  184. package/dist/directive-api.d.ts +42 -85
  185. package/dist/directive-arguments.d.ts +14 -39
  186. package/dist/document-shell.d.ts +49 -81
  187. package/dist/dynamic-components.d.ts +0 -9
  188. package/dist/engine-bindings.d.ts +1 -1
  189. package/dist/env.d.ts +26 -0
  190. package/dist/error-boundaries.d.ts +36 -43
  191. package/dist/error-handling.d.ts +1 -1
  192. package/dist/errors/codes.d.ts +43 -51
  193. package/dist/errors/formatter.d.ts +38 -58
  194. package/dist/errors/index.d.ts +61 -5
  195. package/dist/errors/logger.d.ts +40 -114
  196. package/dist/errors/sanitizer.d.ts +28 -53
  197. package/dist/errors/types.d.ts +31 -44
  198. package/dist/events.d.ts +32 -94
  199. package/dist/expressions.d.ts +57 -62
  200. package/dist/find-body-tag.d.ts +5 -34
  201. package/dist/first-script-tag.d.ts +0 -23
  202. package/dist/forms-validation.d.ts +117 -149
  203. package/dist/forms.d.ts +161 -120
  204. package/dist/framework-composables.d.ts +0 -32
  205. package/dist/head-injection.d.ts +30 -32
  206. package/dist/head-keys.d.ts +12 -15
  207. package/dist/head.d.ts +110 -139
  208. package/dist/heatmap.d.ts +76 -152
  209. package/dist/html-masking.d.ts +38 -62
  210. package/dist/hydration-runtime.d.ts +24 -20
  211. package/dist/hydration.d.ts +11 -10
  212. package/dist/i18n.d.ts +34 -95
  213. package/dist/image-optimization/auto-sibling.d.ts +4 -32
  214. package/dist/imported-signals.d.ts +0 -36
  215. package/dist/includes.d.ts +6 -69
  216. package/dist/index.d.ts +2 -1
  217. package/dist/init.d.ts +12 -20
  218. package/dist/internal-markdown.d.ts +8 -12
  219. package/dist/interpolation-context.d.ts +15 -15
  220. package/dist/island-chunking.d.ts +13 -30
  221. package/dist/keep-alive.d.ts +52 -72
  222. package/dist/layout-types.d.ts +2 -27
  223. package/dist/lazy-module.d.ts +0 -10
  224. package/dist/loading-indicator.d.ts +8 -5
  225. package/dist/loop-binding.d.ts +4 -7
  226. package/dist/loops.d.ts +25 -67
  227. package/dist/markdown.d.ts +1 -0
  228. package/dist/media/image/component.d.ts +9 -25
  229. package/dist/media/image/directive.d.ts +1 -15
  230. package/dist/media/image/placeholder.d.ts +9 -20
  231. package/dist/media/image/processor/cache.d.ts +18 -40
  232. package/dist/media/image/processor/index.d.ts +10 -1
  233. package/dist/media/image/processor/optimizer.d.ts +1 -12
  234. package/dist/media/image/processor/responsive.d.ts +6 -16
  235. package/dist/media/image/srcset.d.ts +49 -47
  236. package/dist/media/shared/cache.d.ts +31 -51
  237. package/dist/media/shared/hash.d.ts +0 -7
  238. package/dist/media/types.d.ts +754 -1235
  239. package/dist/media/video/directive.d.ts +1 -15
  240. package/dist/media/video/index.d.ts +17 -39
  241. package/dist/media/video/processor/cache.d.ts +19 -42
  242. package/dist/media/video/processor/index.d.ts +18 -1
  243. package/dist/media/video/processor/streaming.d.ts +10 -17
  244. package/dist/media/video/processor/thumbnail.d.ts +15 -21
  245. package/dist/media/video/processor/transcoder.d.ts +1 -11
  246. package/dist/meta-arguments.d.ts +14 -39
  247. package/dist/method-spoofing.d.ts +0 -7
  248. package/dist/middleware.d.ts +0 -60
  249. package/dist/native/bridge/protocol.d.ts +2 -1
  250. package/dist/native/compiler/headwind-to-style.d.ts +383 -359
  251. package/dist/native/compiler/icons.d.ts +249 -243
  252. package/dist/native/compiler/svg.d.ts +35 -24
  253. package/dist/native/runtime/jsc-globals.d.ts +1 -1
  254. package/dist/native/runtime/native-host.d.ts +1 -1
  255. package/dist/native/runtime/native-host.js +3 -0
  256. package/dist/offline/app-service-worker.d.ts +50 -114
  257. package/dist/offline/kept-store.d.ts +23 -37
  258. package/dist/offline/query-cache.d.ts +55 -126
  259. package/dist/owned-routes.d.ts +0 -31
  260. package/dist/page-response.d.ts +8 -39
  261. package/dist/parser/directive-parser.d.ts +45 -57
  262. package/dist/parser/expression-parser.d.ts +35 -33
  263. package/dist/parser/index.d.ts +39 -4
  264. package/dist/parser/tokenizer.d.ts +49 -61
  265. package/dist/partial-hydration.d.ts +51 -82
  266. package/dist/performance-utils.d.ts +115 -255
  267. package/dist/placeholder.d.ts +9 -18
  268. package/dist/plugin-system.d.ts +115 -264
  269. package/dist/process.d.ts +4 -9
  270. package/dist/process.js +6 -4
  271. package/dist/prop-sentinels.d.ts +11 -11
  272. package/dist/public-env.d.ts +0 -14
  273. package/dist/pwa/directives.d.ts +20 -12
  274. package/dist/pwa/inject.d.ts +0 -10
  275. package/dist/pwa/precache.d.ts +16 -22
  276. package/dist/pwa/service-worker.d.ts +0 -12
  277. package/dist/pwa.js +1 -1
  278. package/dist/reactive-bindings.d.ts +11 -34
  279. package/dist/reactive-tracking.d.ts +0 -36
  280. package/dist/reactive.d.ts +41 -58
  281. package/dist/render-memo.d.ts +5 -23
  282. package/dist/resolve-stx-targets.d.ts +6 -44
  283. package/dist/route-middleware.d.ts +35 -2
  284. package/dist/route-rules.d.ts +10 -13
  285. package/dist/router.d.ts +9 -8
  286. package/dist/routes.d.ts +3 -1
  287. package/dist/runtime-config-server.d.ts +14 -17
  288. package/dist/runtime-config.d.ts +2 -3
  289. package/dist/runtime-globals.d.ts +90 -122
  290. package/dist/runtime-injection.d.ts +0 -8
  291. package/dist/scaffolding.d.ts +30 -26
  292. package/dist/script-emit.d.ts +0 -30
  293. package/dist/script-validation.d.ts +6 -12
  294. package/dist/seo.d.ts +75 -153
  295. package/dist/server-api.d.ts +9 -12
  296. package/dist/server-bindings.d.ts +1 -26
  297. package/dist/server-data.d.ts +4 -5
  298. package/dist/sfc-template.d.ts +8 -8
  299. package/dist/signal-processing.d.ts +37 -53
  300. package/dist/signals-api.d.ts +58 -135
  301. package/dist/signals.d.ts +18 -24
  302. package/dist/site-url.d.ts +31 -28
  303. package/dist/slots.d.ts +20 -86
  304. package/dist/source-signature.d.ts +5 -28
  305. package/dist/ssg.d.ts +158 -337
  306. package/dist/ssg.js +2 -2
  307. package/dist/state-dir.d.ts +4 -4
  308. package/dist/store-loader.d.ts +0 -10
  309. package/dist/story/analytics.d.ts +60 -138
  310. package/dist/story/bookmarks.d.ts +34 -87
  311. package/dist/story/cli.d.ts +69 -123
  312. package/dist/story/collect/scanner.d.ts +0 -4
  313. package/dist/story/collect/tree.d.ts +1 -8
  314. package/dist/story/commands/build.d.ts +6 -11
  315. package/dist/story/commands/dev.d.ts +8 -15
  316. package/dist/story/commands/preview.d.ts +7 -13
  317. package/dist/story/config-watcher.d.ts +13 -20
  318. package/dist/story/config.d.ts +8 -11
  319. package/dist/story/context.d.ts +8 -14
  320. package/dist/story/hmr.d.ts +26 -24
  321. package/dist/story/hot-swap.d.ts +23 -34
  322. package/dist/story/keyboard-shortcuts.d.ts +18 -23
  323. package/dist/story/output.d.ts +44 -46
  324. package/dist/story/performance.d.ts +45 -107
  325. package/dist/story/presets.d.ts +41 -107
  326. package/dist/story/renderer.d.ts +27 -41
  327. package/dist/story/search.d.ts +12 -23
  328. package/dist/story/server.d.ts +11 -21
  329. package/dist/story/setup.d.ts +15 -23
  330. package/dist/story/testing.d.ts +40 -65
  331. package/dist/story/types.d.ts +160 -262
  332. package/dist/streaming.d.ts +57 -119
  333. package/dist/strip-literals.d.ts +1 -25
  334. package/dist/stx-module-imports.d.ts +7 -0
  335. package/dist/stx-virtual-ts.d.ts +102 -253
  336. package/dist/style-scoping.d.ts +8 -21
  337. package/dist/suspense.d.ts +52 -67
  338. package/dist/teleport.d.ts +0 -22
  339. package/dist/template-syntax-escape.d.ts +8 -8
  340. package/dist/template-tag-balance.d.ts +6 -22
  341. package/dist/testing.d.ts +26 -11
  342. package/dist/theme-tokens.d.ts +388 -134
  343. package/dist/transitions.d.ts +55 -66
  344. package/dist/ts-css-config.d.ts +12 -70
  345. package/dist/types/component-types.d.ts +122 -187
  346. package/dist/types/config-types.d.ts +341 -956
  347. package/dist/types/context-types.d.ts +24 -46
  348. package/dist/types/csp-types.d.ts +66 -70
  349. package/dist/types/directive-types.d.ts +156 -223
  350. package/dist/types/index.d.ts +110 -6
  351. package/dist/types/pwa-types.d.ts +148 -273
  352. package/dist/types.d.ts +1 -0
  353. package/dist/unresolved-identifiers.d.ts +22 -24
  354. package/dist/url-safety.d.ts +32 -32
  355. package/dist/utils.d.ts +21 -36
  356. package/dist/validator.d.ts +26 -28
  357. package/dist/variable-extractor.d.ts +19 -49
  358. package/dist/view-composers.d.ts +81 -80
  359. package/dist/virtual-scrolling.d.ts +82 -101
  360. package/dist/visual-testing.d.ts +10 -9
  361. package/dist/vue-template.d.ts +0 -23
  362. package/dist/web-components/css-scoping.d.ts +11 -21
  363. package/dist/web-components.d.ts +58 -81
  364. package/dist/x-element.d.ts +1 -0
  365. package/package.json +6 -6
  366. package/stx.d.ts +2 -2
  367. package/dist/app-service-worker.d.ts +0 -165
  368. package/dist/chunk-49gwmcrn.js +0 -2
  369. package/dist/chunk-6va5pe2m.js +0 -2
  370. package/dist/chunk-bm2q1srp.js +0 -2
  371. package/dist/signals-context-runtime.d.ts +0 -2
  372. package/dist/signals-drawer-runtime.d.ts +0 -2
  373. package/dist/signals-host-runtime.d.ts +0 -9
  374. package/dist/signals-loop-conditional-runtime.d.ts +0 -2
  375. package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
  376. package/dist/signals-notify-runtime.d.ts +0 -2
  377. package/dist/signals-optimistic-runtime.d.ts +0 -2
  378. package/dist/signals-overlay-runtime.d.ts +0 -2
  379. package/dist/signals-scope-disposal-runtime.d.ts +0 -2
  380. package/dist/signals-spa-load-control-runtime.d.ts +0 -2
  381. package/dist/signals-storage-runtime.d.ts +0 -2
@@ -1,35 +1,3 @@
1
- /**
2
- * One splice into `<head>` instead of one per thing being injected
3
- * (stacksjs/stx#1945).
4
- *
5
- * Several passes each add a small fragment to the head of a finished page: the
6
- * x-cloak style, the color-mode boot script, the build-id meta. Each was
7
- * written the obvious way -- find the anchor, return
8
- * `slice(0, i) + fragment + slice(i)` -- and each of those returns a NEW copy
9
- * of the whole document. On a 212KB page that is 212KB allocated to insert a
10
- * few hundred bytes, three times over, and the measured cost of the top-level
11
- * pipeline was dominated by exactly this shape: of 86 assignments in a render,
12
- * only ten produced a new string, and six of them were whole-document copies
13
- * made to insert something small.
14
- *
15
- * A pass that contributes a fragment instead of splicing it lets all of them
16
- * share one rebuild. Order is preserved within each anchor, which is the part
17
- * that matters: the boot script has to precede the cloak style in the head, and
18
- * both have to be live before first paint.
19
- *
20
- * Nothing here decides WHETHER a fragment applies. Each caller keeps its own
21
- * guard -- idempotence checks, config gates -- and simply contributes nothing
22
- * when it does not apply, so a page that needs no injections is not rebuilt.
23
- *
24
- * @module head-injection
25
- */
26
- /** Fragments waiting to be spliced into one document. */
27
- export interface HeadInjections {
28
- /** Inserted immediately after the `<head ...>` open tag, in push order. */
29
- afterOpen: string[];
30
- /** Inserted immediately before `</head>`, in push order. */
31
- beforeClose: string[];
32
- }
33
1
  export declare function createHeadInjections(): HeadInjections;
34
2
  /** Whether anything was contributed, so a caller can skip the rebuild entirely. */
35
3
  export declare function hasHeadInjections(injections: HeadInjections): boolean;
@@ -59,3 +27,33 @@ export declare function applyHeadInjections(html: string, injections: HeadInject
59
27
  * through here.
60
28
  */
61
29
  export declare function headInsertionPoint(html: string): number | null;
30
+ /**
31
+ * One splice into `<head>` instead of one per thing being injected
32
+ * (stacksjs/stx#1945).
33
+ *
34
+ * Several passes each add a small fragment to the head of a finished page: the
35
+ * x-cloak style, the color-mode boot script, the build-id meta. Each was
36
+ * written the obvious way -- find the anchor, return
37
+ * `slice(0, i) + fragment + slice(i)` -- and each of those returns a NEW copy
38
+ * of the whole document. On a 212KB page that is 212KB allocated to insert a
39
+ * few hundred bytes, three times over, and the measured cost of the top-level
40
+ * pipeline was dominated by exactly this shape: of 86 assignments in a render,
41
+ * only ten produced a new string, and six of them were whole-document copies
42
+ * made to insert something small.
43
+ *
44
+ * A pass that contributes a fragment instead of splicing it lets all of them
45
+ * share one rebuild. Order is preserved within each anchor, which is the part
46
+ * that matters: the boot script has to precede the cloak style in the head, and
47
+ * both have to be live before first paint.
48
+ *
49
+ * Nothing here decides WHETHER a fragment applies. Each caller keeps its own
50
+ * guard -- idempotence checks, config gates -- and simply contributes nothing
51
+ * when it does not apply, so a page that needs no injections is not rebuilt.
52
+ *
53
+ * @module head-injection
54
+ */
55
+ /** Fragments waiting to be spliced into one document. */
56
+ export declare interface HeadInjections {
57
+ afterOpen: string[]
58
+ beforeClose: string[]
59
+ }
@@ -1,3 +1,15 @@
1
+ /** Forget which warnings were printed, so a test sees them again. */
2
+ export declare function resetHeadKeyWarnings(): void;
3
+ /** The known key an unknown one most likely meant, or undefined. */
4
+ export declare function nearestHeadKey(key: string, known: readonly string[]): string | undefined;
5
+ /**
6
+ * Read a head config with the plural list keys folded into their singular,
7
+ * warning (once) about those and about any other key stx does not know.
8
+ *
9
+ * Returns the input itself when every key is known. Memoized per object, so a
10
+ * config read on every render is checked once.
11
+ */
12
+ export declare function normalizeHeadKeys<T extends Record<string, any>>(head: T | null | undefined, options: { known: readonly string[], source: string }): T;
1
13
  /**
2
14
  * Catch a head config key that stx would otherwise ignore without a word.
3
15
  *
@@ -24,18 +36,3 @@
24
36
  export declare const APP_HEAD_KEYS: readonly string[];
25
37
  /** Keys `useHead()` understands (see `HeadConfig`). */
26
38
  export declare const USE_HEAD_KEYS: readonly string[];
27
- /** Forget which warnings were printed, so a test sees them again. */
28
- export declare function resetHeadKeyWarnings(): void;
29
- /** The known key an unknown one most likely meant, or undefined. */
30
- export declare function nearestHeadKey(key: string, known: readonly string[]): string | undefined;
31
- /**
32
- * Read a head config with the plural list keys folded into their singular,
33
- * warning (once) about those and about any other key stx does not know.
34
- *
35
- * Returns the input itself when every key is known. Memoized per object, so a
36
- * config read on every render is checked once.
37
- */
38
- export declare function normalizeHeadKeys<T extends Record<string, any>>(head: T | null | undefined, options: {
39
- known: readonly string[];
40
- source: string;
41
- }): T;
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;