@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,52 +1,3 @@
1
- /**
2
- * Streaming and Hydration Module
3
- *
4
- * This module provides:
5
- * - Template streaming for progressive rendering
6
- * - Island-based partial hydration support
7
- * - Section-based template composition
8
- *
9
- * ## Section Pattern
10
- *
11
- * Sections use HTML comments for markers:
12
- * ```html
13
- * <!-- @section:name -->
14
- * Content here
15
- * <!-- @endsection:name -->
16
- * ```
17
- *
18
- * **Note**: HTML comments are used because:
19
- * - They're valid in any position in HTML
20
- * - They don't affect the DOM structure
21
- * - They're stripped during minification
22
- *
23
- * Alternative using data attributes (for JS-based extraction):
24
- * ```html
25
- * <template data-section="name">Content</template>
26
- * ```
27
- *
28
- * ## Island Hydration
29
- *
30
- * Islands are client-side interactive regions in server-rendered content:
31
- * ```html
32
- * @island('counter', 'eager')
33
- * <div>Count: {{ count }}</div>
34
- * @endisland
35
- * ```
36
- *
37
- * Priority levels:
38
- * - `eager` - Hydrate immediately on page load
39
- * - `lazy` (default) - Hydrate when visible (IntersectionObserver)
40
- * - `idle` - Hydrate during browser idle time (requestIdleCallback)
41
- *
42
- * ## Streaming
43
- *
44
- * Current implementation returns full content in a single chunk.
45
- * True chunked streaming requires:
46
- * 1. HTTP/2 or chunked transfer encoding
47
- * 2. Identifying suspense boundaries
48
- * 3. Streaming each section as it completes
49
- */
50
1
  import type { CustomDirective, StreamRenderer, StxOptions } from './types';
51
2
  /**
52
3
  * Stream a template with data using chunked transfer encoding.
@@ -79,44 +30,6 @@ export declare function streamTemplate(templatePath: string, data?: Record<strin
79
30
  * cluster). See stacksjs/stx#1711.
80
31
  */
81
32
  export declare function buildSuspenseResolveScript(name: string, promise: Promise<string>): Promise<string>;
82
- /**
83
- * Client receiver for streamed boundaries. Emitted once, right after the shell:
84
- * defines `window.__stxSuspense.resolve(id, html)`, which swaps the boundary's
85
- * fallback placeholder (`[data-suspense="id"]`) for the streamed content.
86
- * Idempotent (`|| { … }`) so multiple streamed renders on one document — or a
87
- * re-run after SPA nav — don't clobber an in-flight receiver.
88
- */
89
- export declare const SUSPENSE_RESOLVER_RUNTIME: string;
90
- /** A deferred streaming boundary: its `render` does the server-side async work. */
91
- export interface StreamBoundary {
92
- /** Boundary id — matches the `data-suspense="<id>"` placeholder in the shell. */
93
- id: string;
94
- /**
95
- * Server-side async render for this boundary: fetch + render, resolving to the
96
- * final HTML. Runs AFTER the shell has been flushed, so the slow data work
97
- * here doesn't block first paint.
98
- */
99
- render: () => Promise<string>;
100
- }
101
- /**
102
- * Render a streaming-SSR page (#1746 Phase 3). Flushes the shell — which carries
103
- * each boundary's fallback in a `[data-suspense="<id>"]` placeholder — to the
104
- * browser immediately, then streams each boundary's HTML as its server-side
105
- * async `render()` resolves, in completion order. The browser paints the shell
106
- * at once and each slow region swaps in when its data is ready.
107
- *
108
- * Per-boundary errors are isolated (`buildSuspenseResolveScript` emits an error
109
- * UI into that boundary instead of failing the whole stream). Pair with
110
- * `streamToResponse` to get a chunked HTTP `Response`.
111
- */
112
- export interface RenderStreamingOptions {
113
- /**
114
- * Per-boundary timeout in ms. A boundary whose `render()` doesn't resolve in
115
- * time is rejected (→ an error UI in its placeholder) so a hung data source
116
- * can't keep the stream open forever. `0` (default) = no timeout.
117
- */
118
- timeoutMs?: number;
119
- }
120
33
  export declare function renderStreamingPage(shellHtml: string, boundaries?: StreamBoundary[], options?: RenderStreamingOptions): ReadableStream<string>;
121
34
  /**
122
35
  * Declarative streaming-SSR sugar (#1746 Phase 3). Extracts each
@@ -153,27 +66,6 @@ export declare function streamTemplateSimple(templatePath: string, data?: Record
153
66
  * @param options stx options
154
67
  */
155
68
  export declare function createStreamRenderer(templatePath: string, options?: StxOptions): Promise<StreamRenderer>;
156
- /**
157
- * Custom directive for marking suspense boundaries in streaming templates.
158
- *
159
- * Usage:
160
- * ```html
161
- * @suspense('heavy-content')
162
- * <div>This content will stream after the shell</div>
163
- * @endsuspense
164
- * ```
165
- *
166
- * The content inside suspense boundaries will be:
167
- * 1. Replaced with a placeholder in the initial shell
168
- * 2. Processed in parallel with other suspense boundaries
169
- * 3. Streamed to the client as it resolves
170
- * 4. Injected into the placeholder via client-side JavaScript
171
- */
172
- export declare const streamingSuspenseDirective: CustomDirective;
173
- /**
174
- * Custom directive for creating islands (for partial hydration)
175
- */
176
- export declare const islandDirective: CustomDirective;
177
69
  /**
178
70
  * Register streaming and hydration directives
179
71
  */
@@ -185,6 +77,7 @@ export declare function registerStreamingDirectives(options?: StxOptions): Custo
185
77
  * @param filePath Template file path
186
78
  * @param _options stx options
187
79
  */
80
+ // eslint-disable-next-line pickier/no-unused-vars
188
81
  export declare function processSectionDirectives(content: string, context: Record<string, any>, filePath: string, _options?: StxOptions): Promise<string>;
189
82
  /**
190
83
  * Wrap a ReadableStream<string> in a proper Response with chunked transfer encoding headers.
@@ -206,17 +99,6 @@ export declare function processSectionDirectives(content: string, context: Recor
206
99
  * @returns A Response with proper streaming headers
207
100
  */
208
101
  export declare function streamToResponse(stream: ReadableStream<string>, init?: ResponseInit): Response;
209
- /**
210
- * Configuration for hydration runtime generation
211
- */
212
- export interface HydrationRuntimeConfig {
213
- /** Include full runtime or just the loader */
214
- mode: 'full' | 'loader';
215
- /** Component registry mapping island names to component paths */
216
- components?: Record<string, string>;
217
- /** Whether to use dynamic imports */
218
- dynamicImports?: boolean;
219
- }
220
102
  /**
221
103
  * Generate client-side hydration runtime script.
222
104
  *
@@ -236,3 +118,59 @@ export interface HydrationRuntimeConfig {
236
118
  * ```
237
119
  */
238
120
  export declare function generateHydrationRuntime(config?: HydrationRuntimeConfig): string;
121
+ /**
122
+ * Client receiver for streamed boundaries. Emitted once, right after the shell:
123
+ * defines `window.__stxSuspense.resolve(id, html)`, which swaps the boundary's
124
+ * fallback placeholder (`[data-suspense="id"]`) for the streamed content.
125
+ * Idempotent (`|| { … }`) so multiple streamed renders on one document — or a
126
+ * re-run after SPA nav — don't clobber an in-flight receiver.
127
+ */
128
+ export declare const SUSPENSE_RESOLVER_RUNTIME: string;
129
+ /**
130
+ * Custom directive for marking suspense boundaries in streaming templates.
131
+ *
132
+ * Usage:
133
+ * ```html
134
+ * @suspense('heavy-content')
135
+ * <div>This content will stream after the shell</div>
136
+ * @endsuspense
137
+ * ```
138
+ *
139
+ * The content inside suspense boundaries will be:
140
+ * 1. Replaced with a placeholder in the initial shell
141
+ * 2. Processed in parallel with other suspense boundaries
142
+ * 3. Streamed to the client as it resolves
143
+ * 4. Injected into the placeholder via client-side JavaScript
144
+ */
145
+ export declare const streamingSuspenseDirective: CustomDirective;
146
+ /**
147
+ * Custom directive for creating islands (for partial hydration)
148
+ */
149
+ export declare const islandDirective: CustomDirective;
150
+ /** A deferred streaming boundary: its `render` does the server-side async work. */
151
+ export declare interface StreamBoundary {
152
+ id: string
153
+ render: () => Promise<string>
154
+ }
155
+ /**
156
+ * Render a streaming-SSR page (#1746 Phase 3). Flushes the shell — which carries
157
+ * each boundary's fallback in a `[data-suspense="<id>"]` placeholder — to the
158
+ * browser immediately, then streams each boundary's HTML as its server-side
159
+ * async `render()` resolves, in completion order. The browser paints the shell
160
+ * at once and each slow region swaps in when its data is ready.
161
+ *
162
+ * Per-boundary errors are isolated (`buildSuspenseResolveScript` emits an error
163
+ * UI into that boundary instead of failing the whole stream). Pair with
164
+ * `streamToResponse` to get a chunked HTTP `Response`.
165
+ */
166
+ export declare interface RenderStreamingOptions {
167
+ timeoutMs?: number
168
+ }
169
+ /**
170
+ * Configuration for hydration runtime generation
171
+ */
172
+ export declare interface HydrationRuntimeConfig {
173
+ mode: 'full' | 'loader'
174
+ components?: Record<string, string>
175
+ dynamicImports?: boolean
176
+ }
@@ -1,24 +1,3 @@
1
- /**
2
- * Blank out comments and string literals, keeping every other character where
3
- * it was.
4
- *
5
- * A name mentioned in a comment or inside a string is not a reference to it.
6
- * The server-to-client bridge applies this before deciding what a client block
7
- * mentions, and `stx typecheck` has to apply exactly the same rule before
8
- * reporting what still crosses implicitly — a second copy that disagreed would
9
- * make the warning and the runtime describe different sets (#1868 ask 4).
10
- *
11
- * Lives in its own module for that reason. It was defined inside
12
- * `client-script.ts`, and the editor-facing `stx-virtual-ts.ts` cannot import
13
- * that without pulling the bundler in behind it; the alternative was a
14
- * second implementation, which is the failure this repo keeps repeating.
15
- *
16
- * Positions are preserved: every blanked character becomes a space and every
17
- * newline stays a newline, so an offset into the result is an offset into the
18
- * source.
19
- *
20
- * @module strip-literals
21
- */
22
1
  /**
23
2
  * Index of the `}` closing an interpolation whose body starts at `start`.
24
3
  *
@@ -63,7 +42,4 @@ export declare function stripCommentsAndLiterals(code: string): string;
63
42
  * Shared by the payload bridge (#1953) and the bundler's export scan (#1959),
64
43
  * which asked the same question with the same blind spot.
65
44
  */
66
- export declare function bracketDepths(stripped: string): {
67
- depths: Uint16Array;
68
- balanced: boolean;
69
- };
45
+ export declare function bracketDepths(stripped: string): { depths: Uint16Array, balanced: boolean };
@@ -6,6 +6,13 @@ import type { ScriptBlock, ScriptKind } from './stx-virtual-ts';
6
6
  * reports it (TS2305), and saying it twice helps nobody.
7
7
  */
8
8
  export declare function stxImportDiagnostics(source: string, blocks: readonly ScriptBlock[]): StxImportDiagnostic[];
9
+ /**
10
+ * Engine bindings that are the JavaScript environment, or engine plumbing,
11
+ * rather than stx API. They are parameters of a server script like the rest,
12
+ * but importing the console or `window` from `stx` is not something to bless,
13
+ * so the module does not declare them.
14
+ */
15
+ declare const ENVIRONMENT_BINDINGS: Set<any>;
9
16
  /** Names `import { … } from 'stx'` binds in a `<script server>` block. */
10
17
  export declare const STX_SERVER_MODULE_EXPORTS: readonly string[];
11
18
  /** Names `import { … } from 'stx'` binds in a client block. */
@@ -1,126 +1,3 @@
1
- /**
2
- * Turn a `.stx` file into TypeScript that a real compiler can check
3
- * (stacksjs/stx#1852, asks 4 and 5).
4
- *
5
- * `stx typecheck` and the VS Code tsserver plugin both need the same answer to
6
- * "what TypeScript is in this file, and where did it come from". They used to
7
- * answer it differently, and the editor's answer was wrong in three ways at
8
- * once: it concatenated every script block into one buffer, which made two
9
- * blocks that legitimately declare the same name collide; it dropped the HTML
10
- * while doing so, so **every diagnostic landed on the wrong line**; and it then
11
- * suppressed every "Cannot find name" mentioning a hardcoded list of runtime
12
- * globals, which also suppressed genuine typos.
13
- *
14
- * This module is the single extractor, so the editor and CI cannot disagree
15
- * about what a file contains or where a diagnostic belongs.
16
- *
17
- * ## Positions survive by construction
18
- *
19
- * The virtual source is built as an array of lines the same length as the
20
- * source, with each block's body written at the index it already occupies. A
21
- * diagnostic's line number therefore *is* the line number in the `.stx` file —
22
- * no offset table, and nothing to get wrong when a file has several blocks.
23
- *
24
- * Only synthetic lines appended past the end of the file need a map, and
25
- * {@link VirtualFile.lineMap} carries it.
26
- *
27
- * ## What is deliberately not attempted
28
- *
29
- * Template expressions are checked for syntax and for names that resolve, not
30
- * for deep types. Two things stand in the way, and pretending otherwise would
31
- * produce false positives in a CI gate:
32
- *
33
- * - The runtime globals are typed `any` (see `runtime-globals.ts`), so a
34
- * signal's value type is unknown to begin with.
35
- * - Templates auto-unwrap signals — `:if="flag"` reads the value while
36
- * `@click="flag.set(true)"` reads the signal object — so the same name has
37
- * two types depending on the attribute it appears in.
38
- *
39
- * Server-block bindings do have real types, and those are checked: see
40
- * {@link buildTemplateScopeSource}, which inlines server bodies so
41
- * `{{ row.total_vists }}` fails against a typed row.
42
- *
43
- * @module stx-virtual-ts
44
- */
45
- export type ScriptKind = 'server' | 'client' | 'plain';
46
- export interface ScriptBlock {
47
- kind: ScriptKind;
48
- /** Block body, without the surrounding tags. */
49
- code: string;
50
- /** 1-based line in the source file where the body's first character sits. */
51
- startLine: number;
52
- /**
53
- * 1-based column of the body's first character. Greater than 1 when the
54
- * code starts on the line the opening tag is on (`<script client>const a`),
55
- * which a buffer has to pad for or every diagnostic on that line lands
56
- * left of the code it is about.
57
- */
58
- startColumn?: number;
59
- /** Offset of the body's first character in the source. */
60
- offset?: number;
61
- /** The opening tag's attributes, trimmed. */
62
- attrs: string;
63
- }
64
- /** A `{{ }}` interpolation or a directive attribute value. */
65
- export interface TemplateExpression {
66
- /** A generated contract check anchors at its source value, not its TS wrapper. */
67
- anchor?: boolean;
68
- /** The expression text, with any filter chain already removed. */
69
- code: string;
70
- /** 1-based line of the expression's first character. */
71
- line: number;
72
- /** 1-based column of the expression's first character. */
73
- column: number;
74
- kind: 'interpolation' | 'directive' | 'condition';
75
- /** For directives, the attribute name (`:if`, `@click`, `x-text`). */
76
- attribute?: string;
77
- /**
78
- * 0-based offset of the expression's first character, used to work out which
79
- * `@if` / `@unless` blocks enclose it. Not part of a diagnostic; `line` and
80
- * `column` carry that.
81
- */
82
- offset?: number;
83
- }
84
- /** A synthetic line's origin, for diagnostics that land outside the source. */
85
- export interface MappedLine {
86
- line: number;
87
- column: number;
88
- /** Present when the line came from a template expression. */
89
- expression?: TemplateExpression;
90
- /**
91
- * Characters of wrapper before the expression starts on the synthetic line.
92
- *
93
- * Subtracting it turns a column in the virtual line into a column inside the
94
- * expression, so a squiggle lands on the offending identifier rather than at
95
- * the start of the attribute.
96
- */
97
- prefixLength?: number;
98
- /**
99
- * Characters of `if (…) {` wrapper before the expression's own statement.
100
- *
101
- * A diagnostic inside this span is about the enclosing CONDITION, not about
102
- * the expression this line carries - and the condition is checked on a line
103
- * of its own, so reporting it here too would name innocent markup twice
104
- * (stacksjs/stx#2013).
105
- */
106
- guardPrefixLength?: number;
107
- }
108
- export interface VirtualFile {
109
- text: string;
110
- componentDependencies?: Map<string, string>;
111
- /** Whether the `reference` option's directive was written (line 1 was free). */
112
- referenced?: boolean;
113
- /**
114
- * Virtual 1-based line → where it came from.
115
- *
116
- * Only holds entries for lines the source does not already account for.
117
- * Anything absent is at its own line number, because the body was written at
118
- * the index it occupies in the file.
119
- */
120
- lineMap: Map<number, MappedLine>;
121
- /** Lines after this are synthetic. */
122
- sourceLineCount: number;
123
- }
124
1
  /**
125
2
  * Pull the script blocks out of a `.stx` source, with the line each body starts on.
126
3
  *
@@ -146,19 +23,6 @@ export declare function maskNonTemplateRegions(source: string): string;
146
23
  * is TypeScript, and `||` is a real operator that must survive.
147
24
  */
148
25
  export declare function stripFilterChain(expression: string): string;
149
- /**
150
- * Placeholder for a server interpolation spliced into a client expression.
151
- *
152
- * `:show="photos()[{{ idx }}]"` is real stx — the server fills `{{ idx }}` in
153
- * before the client ever parses the attribute. Left in place it is a syntax
154
- * error, so it is replaced with a declared `any`; the interpolation itself is
155
- * still extracted and checked on its own.
156
- */
157
- export declare const INTERPOLATION_PLACEHOLDER = "__stx_interpolated";
158
- /** Name of the generated helper that reads an iterable's element type. */
159
- export declare const ELEMENT_HELPER = "__StxElement";
160
- /** Name of the generated helper that models a template's signal auto-unwrap. */
161
- export declare const UNWRAP_HELPER = "__StxTemplateValue";
162
26
  export declare function substituteInterpolations(value: string): string;
163
27
  /**
164
28
  * The same substitution, but the result occupies the same space as the source.
@@ -212,27 +76,6 @@ export declare function blankScriptDirectives(code: string): string;
212
76
  * the braces literally.
213
77
  */
214
78
  export declare function extractTemplateExpressions(source: string): TemplateExpression[];
215
- /**
216
- * Names a template introduces that no script block declares.
217
- *
218
- * Loop bindings are collected for the whole file rather than tracked per
219
- * subtree. That is deliberately over-permissive: using a loop variable outside
220
- * its loop goes unreported, which is a missing error, whereas scoping it
221
- * precisely without an HTML parser would invent errors that are not there.
222
- */
223
- export interface TemplateBinding {
224
- name: string;
225
- /**
226
- * The iterable it was drawn from, when that is a plain identifier.
227
- *
228
- * `@foreach(rows as row)` can then type `row` as `rows`' element type, which
229
- * is what turns a renamed column into a compile error rather than a silent
230
- * `undefined`. Anything more complex than an identifier stays `any` — a call
231
- * or a member chain would need the whole expression to resolve, and being
232
- * wrong there invents errors.
233
- */
234
- iterable?: string;
235
- }
236
79
  export declare function collectTemplateBindings(source: string): TemplateBinding[];
237
80
  /**
238
81
  * Top-level names a script block declares.
@@ -243,13 +86,6 @@ export declare function collectTemplateBindings(source: string): TemplateBinding
243
86
  export declare function collectBlockDeclarations(code: string): string[];
244
87
  /** Ambient declarations for the globals the stx runtime injects. */
245
88
  export declare function runtimeGlobalDeclarations(): string;
246
- /**
247
- * Context the server injects into a `<script server>` block.
248
- *
249
- * Mirrors what `serve.ts` puts in scope. Declaring these is what lets the
250
- * checker report a genuine typo instead of suppressing every unresolved name.
251
- */
252
- export declare const STX_SERVER_CONTEXT: readonly ['params', 'query', 'cookies', 'host', 'ip', 'setResponseStatus', 'setResponseHeader', 'notFound', 'request', 'url', 'definePageMeta', 'defineClientPayload', 'defineStore', 'props', '$props'];
253
89
  export declare function serverContextDeclarations(typed?: ReadonlySet<string>): string;
254
90
  /**
255
91
  * Names a global declaration file declares as values: `declare function`,
@@ -275,10 +111,7 @@ export declare function declaredGlobalNames(declarations: string): Set<string>;
275
111
  */
276
112
  export declare function extractClientPayloadNames(serverCode: string): string[] | null;
277
113
  /** Top-level `import` statements, and everything else, separated. */
278
- export declare function splitTopLevelImports(code: string): {
279
- imports: string;
280
- body: string;
281
- };
114
+ export declare function splitTopLevelImports(code: string): { imports: string, body: string };
282
115
  /**
283
116
  * Declarations that give a client block the server values it is actually given.
284
117
  *
@@ -323,10 +156,7 @@ export declare function splitTopLevelImports(code: string): {
323
156
  * than a blanked copy, because the declaration's BODY is what has to be carried
324
157
  * across, not just its name.
325
158
  */
326
- export declare function extractTypeDeclarations(code: string): Array<{
327
- name: string;
328
- text: string;
329
- }>;
159
+ export declare function extractTypeDeclarations(code: string): Array<{ name: string, text: string }>;
330
160
  export declare function clientPayloadDeclarations(serverCode: string, clientCode?: string): string;
331
161
  /**
332
162
  * Declarations at the TOP LEVEL of a block, ignoring anything nested.
@@ -360,19 +190,6 @@ export declare function collectTopLevelDeclarations(code: string): string[];
360
190
  * not actually mention any server name.
361
191
  */
362
192
  export declare function scrapedBridgeNames(serverCode: string, clientCode: string): string[];
363
- /** Marker comment so a generated preamble is recognisable in a dumped buffer. */
364
- export declare const PAYLOAD_COMMENT = "stx: types for the declared client payload (#1868)";
365
- /** The same, for a page still relying on the name-scraping bridge. */
366
- export declare const SCRAPED_COMMENT = "stx: untyped bridge names \u2014 declare a defineClientPayload to check these (#1868)";
367
- /**
368
- * Names the template engine puts in scope for every page.
369
- *
370
- * Declared rather than suppressed. The editor plugin used to drop every
371
- * "Cannot find name" whose message mentioned one of a hardcoded list, which
372
- * also dropped genuine typos; giving the names a declaration means an
373
- * unrecognised one is still an error (#1852 ask 3).
374
- */
375
- export declare const STX_TEMPLATE_GLOBALS: readonly ['$env', '$user', '$slot', '$slots', '$attrs', '$props', '$page', '$route', '$loop', 'loop', '$errors', '$csrf', 'props', 'slot'];
376
193
  /**
377
194
  * Names declared by both a server block and a client/plain block.
378
195
  *
@@ -438,10 +255,7 @@ export declare function collectConditionAliases(codes: readonly string[]): Map<s
438
255
  */
439
256
  export declare function expandConditionAliases(condition: string, aliases: ReadonlyMap<string, string>, depth?: number, seen?: ReadonlySet<string>): string;
440
257
  export declare function guardChainAt(source: string, offset: number): string[];
441
- export declare function expressionStatement(expression: TemplateExpression): {
442
- text: string;
443
- prefixLength: number;
444
- } | null;
258
+ export declare function expressionStatement(expression: TemplateExpression): { text: string, prefixLength: number } | null;
445
259
  /**
446
260
  * Rewrite relative module specifiers to absolute paths against the real file.
447
261
  *
@@ -482,53 +296,6 @@ export declare function firstLinePadding(block: ScriptBlock): string;
482
296
  * `import a, { b as c, type D } from 'x'` and `import * as ns from 'x'`.
483
297
  */
484
298
  export declare function collectImportedNames(code: string): string[];
485
- export interface BuildVirtualOptions {
486
- /** Enables component call-site checks using the renderer's file lookup. */
487
- filePath?: string;
488
- componentsDir?: string;
489
- projectRoot?: string;
490
- readComponent?: (file: string) => string | undefined;
491
- /** Append `{{ }}` and directive expressions. Default true. */
492
- templateExpressions?: boolean;
493
- /**
494
- * Directory the `.stx` file really lives in.
495
- *
496
- * Relative imports in its script blocks are resolved against it, since the
497
- * buffer this builds is written somewhere else entirely (#1928).
498
- */
499
- originDir?: string;
500
- /** Append ambient declarations at all. Default true. */
501
- globals?: boolean;
502
- /**
503
- * Where the server context, the `@stacksjs/browser` auto-imports and the
504
- * template globals are declared. Default `'module'`.
505
- *
506
- * `'global'` wraps them in `declare global { … }`. Declared in the module
507
- * they share a scope with the author's own bindings, so a block's
508
- * `const { query } = defineProps()` is a redeclaration of the context's
509
- * `query`; declared globally, the block's binding shadows it instead, as it
510
- * does in `stx typecheck`, whose context is a global file. The editor, which
511
- * has one buffer per file, needs the global form.
512
- */
513
- contextScope?: 'module' | 'global';
514
- /**
515
- * A declaration file to pull into the program with a triple-slash
516
- * reference, written on the buffer's first line.
517
- *
518
- * That line is always blank when the file opens with markup or with a
519
- * `<script>` tag on a line of its own, which is how every real file starts,
520
- * so nothing moves. When code sits on line 1 the reference is left out and
521
- * {@link VirtualFile.referenced} says so, so the caller can fall back.
522
- */
523
- reference?: string;
524
- /**
525
- * Declare the stx runtime globals as `any`. Default true.
526
- *
527
- * Pass `false` when the program already includes the package's `stx.d.ts`,
528
- * which types them properly — these would shadow it.
529
- */
530
- runtimeGlobals?: boolean;
531
- }
532
299
  /**
533
300
  * Build one line-aligned TypeScript buffer for a whole `.stx` file.
534
301
  *
@@ -543,25 +310,9 @@ export declare function buildVirtualTypeScript(source: string, options?: BuildVi
543
310
  /** Offsets at which each 1-based line starts. */
544
311
  export declare function lineStarts(text: string): number[];
545
312
  /** Offset → 1-based line and column. */
546
- export declare function offsetToPosition(starts: readonly number[], offset: number): {
547
- line: number;
548
- column: number;
549
- };
313
+ export declare function offsetToPosition(starts: readonly number[], offset: number): { line: number, column: number };
550
314
  /** 1-based line and column → offset, clamped to the line. */
551
315
  export declare function positionToOffset(starts: readonly number[], line: number, column: number): number;
552
- /** Where a diagnostic in a virtual buffer belongs in the `.stx` file. */
553
- export interface ResolvedPosition {
554
- line: number;
555
- column: number;
556
- /** Set when the diagnostic came from a template expression. */
557
- expression?: TemplateExpression;
558
- /**
559
- * The hit landed in the `if (…) {` wrapper that markup guards put around an
560
- * expression, so it is about the CONDITION rather than this expression. The
561
- * condition has a line of its own (stacksjs/stx#2013).
562
- */
563
- inGuard?: boolean;
564
- }
565
316
  /**
566
317
  * Whether a diagnostic on a template-expression line is an artefact of how the
567
318
  * expression was wrapped rather than a fault in it. Both checkers drop these,
@@ -587,3 +338,101 @@ export declare function isTemplateArtefact(position: ResolvedPosition, code: num
587
338
  * must be dropped rather than pointed at an arbitrary line.
588
339
  */
589
340
  export declare function resolvePosition(virtual: VirtualFile, line: number, column: number): ResolvedPosition | null;
341
+ /**
342
+ * Placeholder for a server interpolation spliced into a client expression.
343
+ *
344
+ * `:show="photos()[{{ idx }}]"` is real stx — the server fills `{{ idx }}` in
345
+ * before the client ever parses the attribute. Left in place it is a syntax
346
+ * error, so it is replaced with a declared `any`; the interpolation itself is
347
+ * still extracted and checked on its own.
348
+ */
349
+ export declare const INTERPOLATION_PLACEHOLDER: '__stx_interpolated';
350
+ /** Name of the generated helper that reads an iterable's element type. */
351
+ export declare const ELEMENT_HELPER: '__StxElement';
352
+ /** Name of the generated helper that models a template's signal auto-unwrap. */
353
+ export declare const UNWRAP_HELPER: '__StxTemplateValue';
354
+ /**
355
+ * Context the server injects into a `<script server>` block.
356
+ *
357
+ * Mirrors what `serve.ts` puts in scope. Declaring these is what lets the
358
+ * checker report a genuine typo instead of suppressing every unresolved name.
359
+ */
360
+ export declare const STX_SERVER_CONTEXT: readonly ['params', 'query', 'cookies', 'host', 'ip', 'setResponseStatus', 'setResponseHeader', 'notFound', 'request', 'url', 'definePageMeta', unknown, unknown, 'defineStore', unknown, unknown, unknown, unknown, unknown, '$props'];
361
+ /** Marker comment so a generated preamble is recognisable in a dumped buffer. */
362
+ export declare const PAYLOAD_COMMENT: 'stx: types for the declared client payload (#1868)';
363
+ /** The same, for a page still relying on the name-scraping bridge. */
364
+ export declare const SCRAPED_COMMENT: 'stx: untyped bridge names — declare a defineClientPayload to check these (#1868)';
365
+ /**
366
+ * Names the template engine puts in scope for every page.
367
+ *
368
+ * Declared rather than suppressed. The editor plugin used to drop every
369
+ * "Cannot find name" whose message mentioned one of a hardcoded list, which
370
+ * also dropped genuine typos; giving the names a declaration means an
371
+ * unrecognised one is still an error (#1852 ask 3).
372
+ */
373
+ export declare const STX_TEMPLATE_GLOBALS: readonly ['$env', '$user', '$slot', '$slots', '$attrs', '$props', '$page', '$route', '$loop', unknown, unknown, '$errors', '$csrf', 'props', 'slot'];
374
+ export declare interface ScriptBlock {
375
+ kind: ScriptKind
376
+ code: string
377
+ startLine: number
378
+ startColumn?: number
379
+ offset?: number
380
+ attrs: string
381
+ }
382
+ /** A `{{ }}` interpolation or a directive attribute value. */
383
+ export declare interface TemplateExpression {
384
+ anchor?: boolean
385
+ code: string
386
+ line: number
387
+ column: number
388
+ kind: 'interpolation' | 'directive' | 'condition'
389
+ attribute?: string
390
+ offset?: number
391
+ }
392
+ /** A synthetic line's origin, for diagnostics that land outside the source. */
393
+ export declare interface MappedLine {
394
+ line: number
395
+ column: number
396
+ expression?: TemplateExpression
397
+ prefixLength?: number
398
+ guardPrefixLength?: number
399
+ }
400
+ export declare interface VirtualFile {
401
+ text: string
402
+ componentDependencies?: Map<string, string>
403
+ referenced?: boolean
404
+ lineMap: Map<number, MappedLine>
405
+ sourceLineCount: number
406
+ }
407
+ /**
408
+ * Names a template introduces that no script block declares.
409
+ *
410
+ * Loop bindings are collected for the whole file rather than tracked per
411
+ * subtree. That is deliberately over-permissive: using a loop variable outside
412
+ * its loop goes unreported, which is a missing error, whereas scoping it
413
+ * precisely without an HTML parser would invent errors that are not there.
414
+ */
415
+ export declare interface TemplateBinding {
416
+ name: string
417
+ iterable?: string
418
+ }
419
+ export declare interface BuildVirtualOptions {
420
+ filePath?: string
421
+ componentsDir?: string
422
+ projectRoot?: string
423
+ readComponent?: (file: string) => string | undefined
424
+ templateExpressions?: boolean
425
+ originDir?: string
426
+ globals?: boolean
427
+ contextScope?: 'module' | 'global'
428
+ reference?: string
429
+ runtimeGlobals?: boolean
430
+ }
431
+ /** Where a diagnostic in a virtual buffer belongs in the `.stx` file. */
432
+ export declare interface ResolvedPosition {
433
+ line: number
434
+ column: number
435
+ expression?: TemplateExpression
436
+ inGuard?: boolean
437
+ }
438
+ export type ScriptKind = 'server' | 'client' | 'plain';