@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
@@ -32,7 +32,7 @@ export declare interface NativeHost {
32
32
  remove: (node: NativeNode) => void
33
33
  descendants: (node: NativeNode) => NativeNode[]
34
34
  scopesIn: (node: NativeNode) => string[]
35
- adopt: (node: NativeNode, type: string, owner?: NativeNode | null, descriptor?: Pick<STXNode, 'props' | 'style' | 'events' | 'children' | '_classes' | '_inlineStyle'>) => NativeNode
35
+ adopt: (node: NativeNode, type: string, owner?: NativeNode | null, descriptor?: Pick<STXNode, 'key' | 'props' | 'style' | 'events' | 'children' | '_classes' | '_inlineStyle'>) => NativeNode
36
36
  flush: () => void
37
37
  dispatch: (handlerId: string, payload?: unknown) => void
38
38
  pending: () => number
@@ -126,6 +126,7 @@ export function createNativeHost(options) {
126
126
  id: node.__stxId,
127
127
  node: {
128
128
  type: record.type,
129
+ ...record.key === void 0 ? {} : { key: record.key },
129
130
  props: { ...record.props },
130
131
  style: { ...record.style },
131
132
  ...Object.keys(record.events).length ? { events: { ...record.events } } : {},
@@ -235,6 +236,7 @@ export function createNativeHost(options) {
235
236
  counter = Math.max(counter, Number(suffix));
236
237
  const classes = descriptor?._classes ?? "", classStyle = compileClassStyles(classes).style, baseStyle = descriptor?._inlineStyle ? { ...descriptor._inlineStyle } : Object.fromEntries(Object.entries(descriptor?.style ?? {}).filter(([key, value]) => classStyle[key] !== value)), record = {
237
238
  type,
239
+ key: descriptor?.key,
238
240
  props: { ...descriptor?.props ?? {} },
239
241
  style: { ...descriptor?.style ?? {} },
240
242
  baseStyle,
@@ -437,6 +439,7 @@ export function createNativeHost(options) {
437
439
  };
438
440
  records.set(copy.__stxId, {
439
441
  type: descriptor.type,
442
+ key: descriptor.key,
440
443
  props: { ...descriptor.props, __stxId: copy.__stxId },
441
444
  style: { ...descriptor.style },
442
445
  baseStyle: { ...descriptor.baseStyle },
@@ -1,3 +1,33 @@
1
+ /** `/m/workout/:id` and `/m/workout/[id]` as a matcher the worker can carry. */
2
+ export declare function offlineRoute(path: string): OfflineRoute | null;
3
+ /**
4
+ * What the register tag runs on every page. Closure-free: it is shipped as its
5
+ * own source (`OFFLINE_REGISTER_SCRIPT`), and exported so it can be tested.
6
+ *
7
+ * - Registers the worker after the first frame on a return visit (a cheap
8
+ * update check), and only after `load` on the first one, whose install
9
+ * fetches every kept screen and would compete with the page's own files.
10
+ * It never sits in front of first paint either way.
11
+ * - Turns the worker's `stx:updated` messages into a window event of the same
12
+ * name, { url, kind, fragment }, for the router and for queries to redraw.
13
+ * - A new build waits (see the worker). The page says when it is safe to take
14
+ * over: when it is hidden, or when it loaded with nothing else of the app
15
+ * open; the worker checks that no page of the app is on screen. When one is
16
+ * waiting, `window.stxOffline.updateReady` turns true and the window hears
17
+ * `stx:offline-update-ready`, so an app can offer "Update" and call
18
+ * `window.stxOffline.applyUpdate()`, which takes over now and reloads.
19
+ */
20
+ export declare function registerOfflineWorker(path: string): void;
21
+ /**
22
+ * The section a fallback screen stands in for: `scope` when given, else the
23
+ * fallback's first path segment (`/m/today` → `/m`, `/` → `/`).
24
+ */
25
+ export declare function offlineFallbackScope(fallback: string | null, scope?: string): string | null;
26
+ /** The worker itself, for one build. */
27
+ export declare function generateOfflineWorker(config: OfflineAppConfig, buildId: string): string;
28
+ export declare const OFFLINE_WORKER_PATH: '/_stx/sw.js';
29
+ /** The tag every page carries so the worker is installed. */
30
+ export declare const OFFLINE_REGISTER_SCRIPT: string;
1
31
  /**
2
32
  * An app that keeps working without a network, and opens like a native one.
3
33
  *
@@ -47,119 +77,25 @@
47
77
  * a person mid-task; the page can ask for it sooner (`applyOfflineUpdate()`).
48
78
  * The running build's kept screens stay until then.
49
79
  */
50
- export interface OfflineAppConfig {
51
- /** Turn the worker on. */
52
- enabled: boolean;
53
- /** Screens fetched when the worker installs, so they open offline before they were visited. */
54
- pages?: string[];
55
- /**
56
- * Listed pages whose HTML is an account-independent shell. These may be
57
- * retained despite the server's default no-store header. Never list pages
58
- * containing server-rendered personal data; API no-store remains enforced.
59
- *
60
- * A route of `routes` may be listed too (`/m/go/:id`, as written there):
61
- * its kept page, the one every value of it stands in with offline, is then
62
- * refreshed by each visit despite no-store. Without that, a server that
63
- * marks every page no-store left a route only the copy fetched when the
64
- * worker installed, and a page in `pages` none at all after its first visit.
65
- */
66
- staticPages?: string[];
67
- /** Path prefix of the app's API, whose GET answers are kept for offline. Default '/api/'. */
68
- apiPrefix?: string;
69
- /**
70
- * How long a screen or API read that was never kept (or one asked for
71
- * network first) waits for the network before a kept stand-in is used, ms.
72
- * Default 1500. A kept copy is answered at once and does not wait at all.
73
- */
74
- networkTimeoutMs?: number;
75
- /** Deadline for each background precache request and response body, ms. Default 10000. Does not abort foreground reads. */
76
- precacheTimeoutMs?: number;
77
- /**
78
- * Paths (prefixes) answered network first rather than from the kept copy:
79
- * the kept copy is used only when the network does not answer in
80
- * `networkTimeoutMs`. For a read whose stale copy would mislead, such as a
81
- * balance or a live score.
82
- */
83
- networkFirst?: string[];
84
- /**
85
- * Whether an app started cold while a new build waits opens on the new
86
- * build, going to the network for its first screen, rather than on the kept
87
- * one. Off by default: the app opens at once on the build it has, the way a
88
- * native app keeps running the version it has while the next downloads,
89
- * and the new build takes over the next time the app is not on screen. On
90
- * costs a round trip on the first launch after every deploy.
91
- */
92
- updateOnColdStart?: boolean;
93
- /** Where a page that was never cached goes offline (one of `pages`). Default: the first of `pages`. */
94
- fallback?: string;
95
- /**
96
- * The paths the fallback stands in for (a prefix). Default: the fallback's
97
- * own section, its first path segment, so a `/m` fallback answers only for
98
- * `/m/...`. Outside it a page that was never kept fails as it would without
99
- * the worker. A phone app's screen is no answer for a page of the website
100
- * beside it, and a dev server restarting looks offline for a moment.
101
- */
102
- fallbackScope?: string;
103
- /**
104
- * Dynamic screens whose page is the same for every value, drawn on the
105
- * device from the API: `/m/workout/:id` or `/m/workout/[id]`. One that was
106
- * never opened is answered offline with the route's kept page, its route
107
- * params replaced by the ones asked for. The route's page is fetched when
108
- * the worker installs (each param as `0`) and refreshed by every visit.
109
- * Leave out a route whose server renders the value's own data.
110
- */
111
- routes?: string[];
112
- /** Paths the worker leaves alone entirely (prefixes). */
113
- exclude?: string[];
114
- /**
115
- * Most bytes of media (videos, audio) the page may ask to keep for offline
116
- * with `cacheMedia()`. The oldest are dropped past it. Default 600 MB.
117
- */
118
- mediaMaxBytes?: number;
119
- /**
120
- * Most files other than stylesheets and scripts (images, fonts) kept in the
121
- * asset cache. The least recently fetched go first when a new build takes
122
- * over. Default 500.
123
- */
124
- assetsMaxEntries?: number;
80
+ export declare interface OfflineAppConfig {
81
+ enabled: boolean
82
+ pages?: string[]
83
+ staticPages?: string[]
84
+ apiPrefix?: string
85
+ networkTimeoutMs?: number
86
+ precacheTimeoutMs?: number
87
+ networkFirst?: string[]
88
+ updateOnColdStart?: boolean
89
+ fallback?: string
90
+ fallbackScope?: string
91
+ routes?: string[]
92
+ exclude?: string[]
93
+ mediaMaxBytes?: number
94
+ assetsMaxEntries?: number
125
95
  }
126
- export declare const OFFLINE_WORKER_PATH = "/_stx/sw.js";
127
- interface OfflineRoute {
128
- /** The route as configured, which names its kept page. */
129
- path: string;
130
- /** Matches a path of this route, one group per param. */
131
- re: string;
132
- names: string[];
133
- /** The path fetched when the worker installs. */
134
- sample: string;
96
+ declare interface OfflineRoute {
97
+ path: string
98
+ re: string
99
+ names: string[]
100
+ sample: string
135
101
  }
136
- /** `/m/workout/:id` and `/m/workout/[id]` as a matcher the worker can carry. */
137
- export declare function offlineRoute(path: string): OfflineRoute | null;
138
- /**
139
- * What the register tag runs on every page. Closure-free: it is shipped as its
140
- * own source (`OFFLINE_REGISTER_SCRIPT`), and exported so it can be tested.
141
- *
142
- * - Registers the worker after the first frame on a return visit (a cheap
143
- * update check), and only after `load` on the first one, whose install
144
- * fetches every kept screen and would compete with the page's own files.
145
- * It never sits in front of first paint either way.
146
- * - Turns the worker's `stx:updated` messages into a window event of the same
147
- * name, { url, kind, fragment }, for the router and for queries to redraw.
148
- * - A new build waits (see the worker). The page says when it is safe to take
149
- * over: when it is hidden, or when it loaded with nothing else of the app
150
- * open; the worker checks that no page of the app is on screen. When one is
151
- * waiting, `window.stxOffline.updateReady` turns true and the window hears
152
- * `stx:offline-update-ready`, so an app can offer "Update" and call
153
- * `window.stxOffline.applyUpdate()`, which takes over now and reloads.
154
- */
155
- export declare function registerOfflineWorker(path: string): void;
156
- /**
157
- * The section a fallback screen stands in for: `scope` when given, else the
158
- * fallback's first path segment (`/m/today` → `/m`, `/` → `/`).
159
- */
160
- export declare function offlineFallbackScope(fallback: string | null, scope?: string): string | null;
161
- /** The tag every page carries so the worker is installed. */
162
- export declare const OFFLINE_REGISTER_SCRIPT: string;
163
- /** The worker itself, for one build. */
164
- export declare function generateOfflineWorker(config: OfflineAppConfig, buildId: string): string;
165
- export {};
@@ -1,3 +1,10 @@
1
+ /** IndexedDB as a KeptBackend, or null where there is none. Closure-free. */
2
+ export declare function indexedDbBackend(name?: string): KeptBackend | null;
3
+ /**
4
+ * A kept store. Closure-free: embedded in the browser runtime by source, with
5
+ * `indexedDbBackend` passed in rather than referenced.
6
+ */
7
+ export declare function createKeptStore(options?: KeptStoreOptions, openBackend?: () => KeptBackend | null): KeptStore;
1
8
  /**
2
9
  * Where kept values live: `keptState` and persisted queries.
3
10
  *
@@ -25,43 +32,22 @@
25
32
  * (signals.ts), so it may use nothing from this module's scope.
26
33
  */
27
34
  /** An asynchronous key-value store behind localStorage, for large values. */
28
- export interface KeptBackend {
29
- get: (key: string) => Promise<unknown>;
30
- set: (key: string, value: unknown) => Promise<void>;
31
- remove: (key: string) => Promise<void>;
32
- /** Remove every key starting with this prefix. */
33
- removePrefix: (prefix: string) => Promise<void>;
35
+ export declare interface KeptBackend {
36
+ get: (key: string) => Promise<unknown>
37
+ set: (key: string, value: unknown) => Promise<void>
38
+ remove: (key: string) => Promise<void>
39
+ removePrefix: (prefix: string) => Promise<void>
34
40
  }
35
- export interface KeptStoreOptions {
36
- /** Synchronous storage for small values. Default localStorage; null for none. */
37
- storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem' | 'key' | 'length'> | null;
38
- /** Asynchronous storage for large values. Default IndexedDB where there is one; null for none. */
39
- backend?: KeptBackend | null;
40
- /** Characters of JSON past which a value goes to the backend rather than localStorage. Default 32768. */
41
- limit?: number;
42
- /** Defer a backend write (default: when idle, or 200 ms at the latest). */
43
- defer?: (fn: () => void) => void;
41
+ export declare interface KeptStoreOptions {
42
+ storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem' | 'key' | 'length'> | null
43
+ backend?: KeptBackend | null
44
+ limit?: number
45
+ defer?: (fn: () => void) => void
44
46
  }
45
- export interface KeptStore {
46
- /** The value kept under `key`, synchronously: from memory, or localStorage. */
47
- peek: (key: string) => {
48
- value: unknown;
49
- } | undefined;
50
- /** The value kept under `key`, wherever it is, IndexedDB included. */
51
- load: (key: string) => Promise<{
52
- value: unknown;
53
- } | undefined>;
54
- /** Keep a value. Readable from memory at once; stored behind. */
55
- set: (key: string, value: unknown) => void;
56
- /** Forget every key that starts with `prefix`. */
57
- forget: (prefix: string) => Promise<void>;
58
- /** Finish every write that is waiting. */
59
- flush: () => Promise<void>;
47
+ export declare interface KeptStore {
48
+ peek: (key: string) => { value: unknown } | undefined
49
+ load: (key: string) => Promise<{ value: unknown } | undefined>
50
+ set: (key: string, value: unknown) => void
51
+ forget: (prefix: string) => Promise<void>
52
+ flush: () => Promise<void>
60
53
  }
61
- /** IndexedDB as a KeptBackend, or null where there is none. Closure-free. */
62
- export declare function indexedDbBackend(name?: string): KeptBackend | null;
63
- /**
64
- * A kept store. Closure-free: embedded in the browser runtime by source, with
65
- * `indexedDbBackend` passed in rather than referenced.
66
- */
67
- export declare function createKeptStore(options?: KeptStoreOptions, openBackend?: () => KeptBackend | null): KeptStore;
@@ -1,137 +1,66 @@
1
+ import type { KeptStore } from './kept-store';
1
2
  /**
2
- * Persisted queries: data a screen shows at once from last time, refreshed
3
- * behind, kept per signed-in account.
4
- *
5
- * The phone app's stores each did this by hand: a `keptState` for the data,
6
- * a `loadedAt` to decide whether to fetch again, a flag against two screens
7
- * fetching at once, and nothing to tell them when the offline worker had a
8
- * newer answer or when a write waiting in the outbox should still show. A
9
- * cached query is that, once:
10
- *
11
- * - seeded synchronously from the kept store (`keptState`'s storage, per
12
- * account scope), so the first draw has data;
13
- * - fetched again behind when older than `staleTime` (a copy kept from an
14
- * earlier launch is always revalidated once), one request for every caller;
15
- * - kept again after every answer;
16
- * - refreshed when the offline worker says the API answer changed
17
- * (`stx:updated` { kind: 'api', url });
18
- * - shown with the outbox's waiting writes applied on top (`affects` /
19
- * `apply` on an outbox entry), so a change made offline never disappears
20
- * when the data is fetched again before it synced.
21
- *
22
- * Closure-free: the browser runtime embeds `createQueryCache` and
23
- * `queryTargetMatches` by source (signals.ts), so neither may use anything
24
- * from this module's scope. The signal implementation and the kept store are
25
- * passed in.
3
+ * Whether an outbox entry's `affects` item, or a URL the worker refreshed,
4
+ * names this query: its key, or its URL (an item without a query string
5
+ * matches the URL's path with any). Closure-free.
26
6
  */
27
- import type { KeptStore } from './kept-store';
7
+ export declare function queryTargetMatches(item: string, target: QueryTarget): boolean;
8
+ /** The query layer, for one page. Closure-free. */
9
+ export declare function createQueryCache(env: QueryCacheEnv): QueryCache;
28
10
  /** The part of a signal this needs. */
29
- export interface QuerySignal<T> {
30
- (): T;
31
- set: (value: T) => void;
11
+ export declare interface QuerySignal<T> {
12
+ (): T
13
+ set: (value: T) => void
32
14
  }
33
- export type KeptScope = string | number | false | null | undefined;
34
15
  /** What a query is known by: its key, and the URL it reads, when it has one. */
35
- export interface QueryTarget {
36
- key: string;
37
- url?: string | null;
16
+ export declare interface QueryTarget {
17
+ key: string
18
+ url?: string | null
38
19
  }
39
- export interface CachedQueryOptions<T> {
40
- /** The URL to GET (or a function giving it). Answered as JSON. */
41
- url?: string | (() => string | null | undefined);
42
- /** Load the data some other way than a GET of `url`. */
43
- load?: (context: {
44
- force: boolean;
45
- url: string | null;
46
- signal?: AbortSignal;
47
- }) => Promise<T>;
48
- /** How to send the GET: give it current credentials here (default `fetch`). */
49
- fetch?: (url: string, init: RequestInit) => Promise<Response>;
50
- /**
51
- * Whose data this is, as for `keptState`: the signed-in account's id, or a
52
- * function returning it (read at every load, so signing in as someone else
53
- * swaps the data). `false`, `null` or `''` keeps nothing on the device.
54
- * Default: the scope given to `setKeptScope`.
55
- */
56
- scope?: KeptScope | (() => KeptScope);
57
- /** How long an answer counts as fresh, ms: `load()` within it does not fetch. Default 0. */
58
- staleTime?: number;
59
- /** The value before anything was kept or fetched. Default null. */
60
- initial?: T;
61
- /** Shape the answer before it is kept and shown. */
62
- transform?: (raw: any) => T;
63
- /** Give up on a request after this long, ms (the data stays). Default 15000. */
64
- timeoutMs?: number;
65
- /** Fetch when created, rather than at the first `load()`. */
66
- immediate?: boolean;
20
+ export declare interface CachedQueryOptions<T> {
21
+ url?: string | (() => string | null | undefined)
22
+ load?: (context: { force: boolean, url: string | null, signal?: AbortSignal }) => Promise<T>
23
+ fetch?: (url: string, init: RequestInit) => Promise<Response>
24
+ scope?: KeptScope | (() => KeptScope)
25
+ staleTime?: number
26
+ initial?: T
27
+ transform?: (raw: any) => T
28
+ timeoutMs?: number
29
+ immediate?: boolean
67
30
  }
68
- export interface CachedQuery<T> {
69
- /** What to show: the last answer, with writes still waiting in the outbox applied. */
70
- data: QuerySignal<T>;
71
- /** True while fetching with nothing to show yet. */
72
- loading: QuerySignal<boolean>;
73
- /** True while any request is out, a background one included. */
74
- isFetching: QuerySignal<boolean>;
75
- /** The last request's error message, cleared by the next answer. */
76
- error: QuerySignal<string | null>;
77
- /** When the data shown was fetched (ms), from this launch or a kept one; 0 for none. */
78
- updatedAt: QuerySignal<number>;
79
- /** Fetch when older than `staleTime` (or always, with `force`). Every caller shares one request. */
80
- load: (force?: boolean) => Promise<T>;
81
- /** Fetch now, past any cache: a pull to refresh. */
82
- refresh: () => Promise<T>;
83
- /** Replace the data here (an edit made on this device), kept like an answer. */
84
- set: (value: T | ((current: T) => T)) => void;
85
- /** Count the data as stale, so the next `load()` fetches. */
86
- invalidate: () => void;
87
- readonly key: string;
31
+ export declare interface CachedQuery<T> {
32
+ data: QuerySignal<T>
33
+ loading: QuerySignal<boolean>
34
+ isFetching: QuerySignal<boolean>
35
+ error: QuerySignal<string | null>
36
+ updatedAt: QuerySignal<number>
37
+ load: (force?: boolean) => Promise<T>
38
+ refresh: () => Promise<T>
39
+ set: (value: T | ((current: T) => T)) => void
40
+ invalidate: () => void
41
+ readonly key: string
88
42
  }
89
- export interface QueryCacheEnv {
90
- state: <T>(value: T) => QuerySignal<T>;
91
- kept: KeptStore;
92
- /** Where kept values live, as `keptState` names them. Default 'stx:kept:'. */
93
- prefix?: string;
94
- /** Listen for `stx:updated` and `stx:outbox` on window. Default true. */
95
- listen?: boolean;
96
- matches?: (item: string, target: QueryTarget) => boolean;
43
+ export declare interface QueryCacheEnv {
44
+ state: <T>(value: T) => QuerySignal<T>
45
+ kept: KeptStore
46
+ prefix?: string
47
+ listen?: boolean
48
+ matches?: (item: string, target: QueryTarget) => boolean
97
49
  }
98
- export interface QueryWatcher {
99
- target: () => QueryTarget;
100
- /** The worker has a newer answer for this query's URL. */
101
- updated: () => void;
102
- /** The outbox changed. `sent` is an entry that just reached the server. */
103
- outbox: (sent: {
104
- id: string;
105
- affects?: string[];
106
- } | null) => void;
50
+ export declare interface QueryWatcher {
51
+ target: () => QueryTarget
52
+ updated: () => void
53
+ outbox: (sent: { id: string, affects?: string[] } | null) => void
107
54
  }
108
- export interface QueryCache {
109
- cachedQuery: <T>(key: string, options?: CachedQueryOptions<T>) => CachedQuery<T>;
110
- /** The account scope queries (and kept state) use when given none. */
111
- setScope: (scope: KeptScope) => void;
112
- scope: () => KeptScope;
113
- /** The kept-store key of a query's data in a scope, or null when that scope keeps nothing. */
114
- keyFor: (key: string, scope?: KeptScope) => string | null;
115
- /** A kept answer, synchronously, or undefined. */
116
- seed: (key: string, scope?: KeptScope) => {
117
- data: unknown;
118
- at: number;
119
- } | undefined;
120
- /** A kept answer, from anywhere it is kept. */
121
- restore: (key: string, scope?: KeptScope) => Promise<{
122
- data: unknown;
123
- at: number;
124
- } | undefined>;
125
- persist: (key: string, data: unknown, scope?: KeptScope) => void;
126
- /** `data` with the outbox's waiting writes for this target applied (only entry `onlyId`, when given). */
127
- overlay: <T>(target: QueryTarget, data: T, onlyId?: string) => T;
128
- watch: (watcher: QueryWatcher) => () => void;
55
+ export declare interface QueryCache {
56
+ cachedQuery: <T>(key: string, options?: CachedQueryOptions<T>) => CachedQuery<T>
57
+ setScope: (scope: KeptScope) => void
58
+ scope: () => KeptScope
59
+ keyFor: (key: string, scope?: KeptScope) => string | null
60
+ seed: (key: string, scope?: KeptScope) => { data: unknown, at: number } | undefined
61
+ restore: (key: string, scope?: KeptScope) => Promise<{ data: unknown, at: number } | undefined>
62
+ persist: (key: string, data: unknown, scope?: KeptScope) => void
63
+ overlay: <T>(target: QueryTarget, data: T, onlyId?: string) => T
64
+ watch: (watcher: QueryWatcher) => () => void
129
65
  }
130
- /**
131
- * Whether an outbox entry's `affects` item, or a URL the worker refreshed,
132
- * names this query: its key, or its URL (an item without a query string
133
- * matches the URL's path with any). Closure-free.
134
- */
135
- export declare function queryTargetMatches(item: string, target: QueryTarget): boolean;
136
- /** The query layer, for one page. Closure-free. */
137
- export declare function createQueryCache(env: QueryCacheEnv): QueryCache;
66
+ export type KeptScope = string | number | false | null | undefined;
@@ -1,34 +1,3 @@
1
- /**
2
- * Which same-origin paths the SPA router actually owns (stacksjs/stx#1864).
3
- *
4
- * With `interceptAllLinks` — hardcoded as the base default on the serve path —
5
- * the router claimed EVERY same-origin relative anchor. `shouldIntercept()`
6
- * filtered on protocol, target and a few opt-out attributes and had no notion
7
- * of a route table, so a link to a non-page endpoint got fetched, failed to
8
- * swap, and then fell back to a real navigation. The endpoint was hit twice:
9
- *
10
- * Fetch 503 /api/auth/github/redirect
11
- * Document 503 /api/auth/github/redirect
12
- *
13
- * on an endpoint whose whole job is minting OAuth state. Worse, when such an
14
- * endpoint returns a successful cross-origin redirect, `fetch` follows it and
15
- * the router swaps a third-party document into the container.
16
- *
17
- * The only escape was `data-no-router`, which removes the anchor from routing
18
- * entirely — one reporting app carries 17 of them, and every new link has to
19
- * remember whether it needs one.
20
- *
21
- * The missing concept is a manifest of owned paths, which the file router
22
- * already has. This ships the compiled matchers to the client so interception
23
- * asks "is this a page I can render?" instead of "is this same-origin?".
24
- *
25
- * Regex SOURCES are shipped rather than patterns because the client runtime is
26
- * a template literal (see CLAUDE.md item 41) — re-implementing the pattern
27
- * compiler in there would mean maintaining a second matcher, in a file where
28
- * every backslash has to be doubled, that must agree with this one forever.
29
- *
30
- * @module owned-routes
31
- */
32
1
  /**
33
2
  * Serialised matchers for every route the router can render.
34
3
  *
@@ -1,35 +1,3 @@
1
- /**
2
- * The HTTP status and headers a page decides for its own response.
3
- *
4
- * Three shapes reach the same place, so a host reads one key and gets all
5
- * three:
6
- *
7
- * - `definePageMeta({ status })` — read statically out of the source, before
8
- * anything runs. Right for a page that is *always* an error page.
9
- * - `@status(expr)` — a template directive, evaluated where the rest of the
10
- * template is. It sits inside the branch it belongs to, so a page says
11
- * `@if (!feature) @status(404) @endif` next to the markup that explains it.
12
- * - `setResponseStatus(code)` / `notFound()` / `setResponseHeader(n, v)` —
13
- * callable from `<script server>`, for a decision that needs the lookup's
14
- * result.
15
- *
16
- * The last two record on the render context under `__stxResponseStatus` and
17
- * `__stxResponseHeaders`. Every host that renders a view — the dev/production
18
- * serve in `bun-plugin`, `stx`'s own `serve`, the app dev server, the
19
- * precompiled production server — reads them back with `readResponseStatus`
20
- * and answers with what it finds.
21
- *
22
- * That read-back is the whole point. Recording without it is the failure this
23
- * module exists to prevent: a page that says 404 renders its not-found body
24
- * under a 200, which tells a crawler, a cache and an uptime check that the URL
25
- * is a real page.
26
- *
27
- * @module page-response
28
- */
29
- /** Context key holding the status a render asked for. */
30
- export declare const RESPONSE_STATUS_KEY = "__stxResponseStatus";
31
- /** Context key holding the headers a render asked for. */
32
- export declare const RESPONSE_HEADERS_KEY = "__stxResponseHeaders";
33
1
  /**
34
2
  * Is this a status a response can actually carry?
35
3
  *
@@ -90,9 +58,9 @@ export declare function syncRecordedResponse(from: Record<string, any> | undefin
90
58
  * them through the render context, which is appended after these and wins.
91
59
  */
92
60
  export declare function responseBindings(context: Record<string, any>): {
93
- setResponseStatus: (status: number) => void;
94
- setResponseHeader: (name: string, value: string) => void;
95
- notFound: (status?: number) => void;
61
+ setResponseStatus: (status: number) => void
62
+ setResponseHeader: (name: string, value: string) => void
63
+ notFound: (status?: number) => void
96
64
  };
97
65
  /**
98
66
  * `@status(expr)` — the template-side spelling.
@@ -114,7 +82,8 @@ export declare function responseBindings(context: Record<string, any>): {
114
82
  * runtime call this one was typed out in the template and a silent no-op there
115
83
  * reads as the feature not existing.
116
84
  */
117
- export declare function processStatusDirective(template: string, context: Record<string, any>, options?: {
118
- filePath?: string;
119
- buildMode?: string;
120
- }): string;
85
+ export declare function processStatusDirective(template: string, context: Record<string, any>, options?: { filePath?: string, buildMode?: string }): string;
86
+ /** Context key holding the status a render asked for. */
87
+ export declare const RESPONSE_STATUS_KEY: '__stxResponseStatus';
88
+ /** Context key holding the headers a render asked for. */
89
+ export declare const RESPONSE_HEADERS_KEY: '__stxResponseHeaders';