@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
@@ -1,88 +1,4 @@
1
- /**
2
- * STX Directive API
3
- *
4
- * Enhanced API for creating custom directives with lifecycle hooks,
5
- * client-side support, and built-in utilities.
6
- *
7
- * @module directive-api
8
- *
9
- * @example
10
- * ```typescript
11
- * import { defineDirective } from 'stx'
12
- *
13
- * // Simple directive
14
- * const uppercase = defineDirective({
15
- * name: 'uppercase',
16
- * transform: (content) => content.toUpperCase()
17
- * })
18
- *
19
- * // Directive with parameters
20
- * const highlight = defineDirective({
21
- * name: 'highlight',
22
- * transform: (content, { color = 'yellow' }) =>
23
- * `<mark style="background: ${color}">${content}</mark>`
24
- * })
25
- * ```
26
- */
27
1
  import type { CustomDirective } from './types';
28
- /** Directive parameter types */
29
- export type DirectiveParams = Record<string, unknown>;
30
- /** Directive binding for client-side directives */
31
- export interface DirectiveBinding<T = unknown> {
32
- /** The value passed to the directive */
33
- value: T;
34
- /** Previous value (for updates) */
35
- oldValue?: T;
36
- /** Argument passed after colon (v-directive:arg) */
37
- arg?: string;
38
- /** Modifiers passed after dots (v-directive.mod1.mod2) */
39
- modifiers: Record<string, boolean>;
40
- /** The directive instance */
41
- instance: unknown;
42
- /** The directive definition */
43
- dir: ClientDirectiveDefinition<T>;
44
- }
45
- /** Server-side directive definition */
46
- export interface DirectiveDefinition<P extends DirectiveParams = DirectiveParams> {
47
- /** Directive name (without @) */
48
- name: string;
49
- /** Whether directive has end tag (@name...@endname) */
50
- hasEndTag?: boolean;
51
- /** Description for documentation */
52
- description?: string;
53
- /** Transform content (server-side) */
54
- transform?: (content: string, params: P, context: Record<string, unknown>, filePath: string) => string | Promise<string>;
55
- /** Validate parameters */
56
- validate?: (params: P) => boolean | string;
57
- /** Default parameter values */
58
- defaults?: Partial<P>;
59
- /** Generate client-side code */
60
- clientScript?: (params: P) => string;
61
- /** Generate CSS */
62
- css?: (params: P) => string;
63
- }
64
- /** Client-side directive hooks */
65
- export interface ClientDirectiveDefinition<T = unknown> {
66
- /** Called when directive is first bound to element */
67
- created?: (el: HTMLElement, binding: DirectiveBinding<T>) => void;
68
- /** Called before element is inserted into DOM */
69
- beforeMount?: (el: HTMLElement, binding: DirectiveBinding<T>) => void;
70
- /** Called when element is inserted into DOM */
71
- mounted?: (el: HTMLElement, binding: DirectiveBinding<T>) => void;
72
- /** Called before the component is updated */
73
- beforeUpdate?: (el: HTMLElement, binding: DirectiveBinding<T>) => void;
74
- /** Called after the component has updated */
75
- updated?: (el: HTMLElement, binding: DirectiveBinding<T>) => void;
76
- /** Called before element is unmounted */
77
- beforeUnmount?: (el: HTMLElement, binding: DirectiveBinding<T>) => void;
78
- /** Called when element is unmounted */
79
- unmounted?: (el: HTMLElement, binding: DirectiveBinding<T>) => void;
80
- }
81
- /** Combined directive (server + client) */
82
- export interface FullDirectiveDefinition<P extends DirectiveParams = DirectiveParams, T = unknown> extends DirectiveDefinition<P> {
83
- /** Client-side hooks */
84
- client?: ClientDirectiveDefinition<T>;
85
- }
86
2
  /**
87
3
  * Register a directive globally.
88
4
  */
@@ -134,7 +50,7 @@ export declare function unregisterDirective(name: string): boolean;
134
50
  * })
135
51
  * ```
136
52
  */
137
- export declare function defineDirective<P extends DirectiveParams = DirectiveParams, T = unknown>(definition: FullDirectiveDefinition<P, T>): CustomDirective;
53
+ export declare function defineDirective<P extends DirectiveParams = DirectiveParams, T = unknown,>(definition: FullDirectiveDefinition<P, T>): CustomDirective;
138
54
  /**
139
55
  * Define a client-only directive.
140
56
  */
@@ -152,3 +68,44 @@ export declare function generateDirectiveRuntime(): string;
152
68
  * Converts v-directive:arg.mod="value" to data attributes and client setup.
153
69
  */
154
70
  export declare function processDirectiveAttributes(template: string): string;
71
+ /** Directive binding for client-side directives */
72
+ export declare interface DirectiveBinding<T = unknown> {
73
+ value: T
74
+ oldValue?: T
75
+ arg?: string
76
+ modifiers: Record<string, boolean>
77
+ instance: unknown
78
+ dir: ClientDirectiveDefinition<T>
79
+ }
80
+ /** Server-side directive definition */
81
+ export declare interface DirectiveDefinition<P extends DirectiveParams = DirectiveParams> {
82
+ name: string
83
+ hasEndTag?: boolean
84
+ description?: string
85
+ transform?: (
86
+ content: string,
87
+ params: P,
88
+ context: Record<string, unknown>,
89
+ filePath: string,
90
+ ) => string | Promise<string>
91
+ validate?: (params: P) => boolean | string
92
+ defaults?: Partial<P>
93
+ clientScript?: (params: P) => string
94
+ css?: (params: P) => string
95
+ }
96
+ /** Client-side directive hooks */
97
+ export declare interface ClientDirectiveDefinition<T = unknown> {
98
+ created?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
99
+ beforeMount?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
100
+ mounted?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
101
+ beforeUpdate?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
102
+ updated?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
103
+ beforeUnmount?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
104
+ unmounted?: (el: HTMLElement, binding: DirectiveBinding<T>) => void
105
+ }
106
+ /** Combined directive (server + client) */
107
+ export declare interface FullDirectiveDefinition<P extends DirectiveParams = DirectiveParams, T = unknown,> extends DirectiveDefinition<P> {
108
+ client?: ClientDirectiveDefinition<T>
109
+ }
110
+ /** Directive parameter types */
111
+ export type DirectiveParams = Record<string, unknown>;
@@ -1,35 +1,4 @@
1
- /**
2
- * Argument handling for directives whose arguments are expressions.
3
- *
4
- * Written for the SEO directives (`@seo`, `@meta`, `@metaTag`,
5
- * `@structuredData`), and kept free of anything SEO-specific so a custom
6
- * directive can use it too (`CustomDirective.rawParams`).
7
- *
8
- * Every one of these used to fail the same way: an argument that was not the
9
- * one shape its regex expected was either left in the page as literal text or
10
- * replaced with nothing, and no one was told. `@seo(seo)` never matched a
11
- * pattern that insisted on `{`; `@meta('author', post.author)` sent the words
12
- * "post.author" as the author; `@structuredData(prodcut)` emitted a JSON-LD
13
- * block holding nothing but `@context`. Each page looked fine and was wrong
14
- * where it counts, in a link preview or a search result.
15
- *
16
- * So the directives share one way to find their call (balanced and quote-aware,
17
- * so `'Smile :)'` does not end the call early), one way to tell a string literal
18
- * from an expression, one evaluator that can say WHY a value is missing, and one
19
- * way to report a failure: an inline comment where the tag would have been, plus
20
- * a console warning naming the file.
21
- */
22
1
  import type { ErrorCode } from './errors/codes';
23
- export interface DirectiveCall {
24
- /** Index of the `@`. */
25
- start: number;
26
- /** Index one past the closing paren, or -1 when the call is never closed. */
27
- end: number;
28
- /** The text between the parens, as written. */
29
- args: string;
30
- /** The whole call, `@name(...)`, or its first 80 characters when unclosed. */
31
- call: string;
32
- }
33
2
  /**
34
3
  * Every `@name(...)` call in `template` matched by `pattern`, in order.
35
4
  *
@@ -65,14 +34,6 @@ export declare function splitTopLevelArgs(args: string): string[];
65
34
  * description is allowed to say "eval".
66
35
  */
67
36
  export declare function parseStringLiteral(raw: string): string | null;
68
- export type EvaluatedArgument = {
69
- ok: true;
70
- value: unknown;
71
- } | {
72
- ok: false;
73
- message: string;
74
- code: ErrorCode;
75
- };
76
37
  /**
77
38
  * Evaluate a directive argument against the template's context.
78
39
  *
@@ -105,3 +66,17 @@ export declare function shortCall(call: string): string;
105
66
  export declare function reportDirectiveFailure(label: string, call: string, message: string, filePath: string, code?: ErrorCode): string;
106
67
  /** Warn without replacing anything: the directive rendered, but not all of it. */
107
68
  export declare function warnDirective(call: string, message: string, filePath: string): void;
69
+ // =============================================================================
70
+ // Finding calls
71
+ // =============================================================================
72
+ export declare interface DirectiveCall {
73
+ start: number
74
+ end: number
75
+ args: string
76
+ call: string
77
+ }
78
+ // =============================================================================
79
+ // Evaluating
80
+ // =============================================================================
81
+ export type EvaluatedArgument = | { ok: true, value: unknown }
82
+ | { ok: false, message: string, code: ErrorCode }
@@ -1,45 +1,5 @@
1
- /**
2
- * Document Shell Generator
3
- *
4
- * Auto-generates the HTML document wrapper around page content.
5
- * No .stx file needs to write <!DOCTYPE>, <html>, <head>, or <body>.
6
- * The shell is configured via stx.config.ts `app.head` and enhanced
7
- * at build/serve time with runtime scripts, CSS, and meta tags.
8
- *
9
- * @module document-shell
10
- */
11
- import type { ColorModeBootConfig } from './color-mode-boot';
12
1
  import type { AppHeadConfig } from './types/config-types';
13
- /**
14
- * Inline x-cloak rule shipped in the SSR <head> (stacksjs/stx#1736).
15
- *
16
- * Must be parsed by the browser BEFORE first paint — so it goes in the head
17
- * as static markup, not injected by the runtime script (which runs after the
18
- * body has already painted, the window where false `:if` branches / hidden
19
- * `:show` elements flash). The `data-stx-cloak` marker makes injection
20
- * idempotent. The runtime's own late injection (signals.ts) is retained as a
21
- * belt-and-suspenders for SPA-nav fragments that arrive without SSR head
22
- * emission.
23
- */
24
- export declare const CLOAK_STYLE = "<style data-stx-cloak>[x-cloak]{display:none !important}</style>";
25
- /**
26
- * Markers recording which `<html>` attributes stx itself wrote from `htmlAttrs`
27
- * (stacksjs/stx#1798).
28
- *
29
- * The router needs them to reconcile the root element across an SPA layout
30
- * change. It cannot just diff `<html>` against the incoming document: by then
31
- * the color-mode boot script has added its own `dark` class / `data-theme`, and
32
- * `animation.ts` has added `data-reduced-motion`, none of which exist in the
33
- * server response — a blind diff would strip them on every navigation and
34
- * flash the wrong theme. These say exactly what stx put there, so the router
35
- * can remove precisely that much and leave runtime state alone.
36
- *
37
- * `class` is tracked separately because it is the one attribute that gets
38
- * *merged* into at runtime, so it has to be reconciled token-by-token rather
39
- * than replaced wholesale.
40
- */
41
- export declare const HTML_ATTRS_MARKER = "data-stx-html-attrs";
42
- export declare const HTML_CLASS_MARKER = "data-stx-html-class";
2
+ import type { ColorModeBootConfig } from './color-mode-boot';
43
3
  /** Emit `k="v"` pairs with every value attribute-escaped. */
44
4
  /**
45
5
  * The identity of a `<meta>` tag, for deduplication.
@@ -61,10 +21,7 @@ export declare function metaDedupKey(m: Record<string, string>): string;
61
21
  * and open markup of its own. JavaScript is left alone: `<\/` is only
62
22
  * equivalent inside a string literal.
63
23
  */
64
- export declare function inlineScriptContent(s: {
65
- content?: unknown;
66
- type?: unknown;
67
- }): string;
24
+ export declare function inlineScriptContent(s: { content?: unknown, type?: unknown }): string;
68
25
  /**
69
26
  * Build the attribute string for the shell's `<html>` open tag.
70
27
  *
@@ -135,10 +92,7 @@ export declare function cloakStyleFragment(html: string): string | null;
135
92
  * comments and `<script>` blocks are stepped over, never moved), so a `<style>`
136
93
  * sitting next to the markup it styles further down the page is left alone.
137
94
  */
138
- export declare function hoistLeadingHeadTags(content: string): {
139
- body: string;
140
- hoisted: string[];
141
- };
95
+ export declare function hoistLeadingHeadTags(content: string): { body: string, hoisted: string[] };
142
96
  /**
143
97
  * Generate the full HTML document shell wrapping page content.
144
98
  *
@@ -148,38 +102,22 @@ export declare function hoistLeadingHeadTags(content: string): {
148
102
  * @returns Complete HTML document
149
103
  */
150
104
  export declare function generateDocumentShell(content: string, headConfig?: AppHeadConfig, options?: {
151
- /** Page-specific title (overrides config) */
152
- title?: string;
153
- /**
154
- * The title is already HTML and must NOT be escaped again.
155
- *
156
- * Set when the title was lifted out of author-written markup — an
157
- * `@head <title>` block or `@section('title')` — where entities are already
158
- * in their final form and any interpolation has already been escaped by
159
- * `{{ }}`. Escaping it a second time renders `Caf&eacute; &amp; Bar` as
160
- * `Caf&amp;eacute; &amp;amp; Bar`.
161
- *
162
- * A title from `useHead({ title })` is a plain JS string and must stay
163
- * escaped — that is the XSS path (#1792 item 4).
164
- */
165
- titleIsHtml?: boolean;
166
- /** Extra styles to inject in <head> (e.g. Css CSS, scoped styles) */
167
- styles?: string[];
168
- /** Extra scripts to inject before </body> (e.g. signals runtime, router) */
169
- bodyScripts?: string[];
170
- /** Extra scripts/tags for <head> */
171
- headScripts?: string[];
172
- /** Stacks to inject (from @push directives) */
173
- headStack?: string;
174
- bodyStack?: string;
175
- /**
176
- * Pre-paint color-mode config (stacksjs/stx#1794). When present, the boot
177
- * script is emitted at the very top of <head> — above the stylesheets,
178
- * because a stylesheet link ahead of it would block its execution and
179
- * delay the one thing it exists to do early.
180
- */
181
- colorMode?: ColorModeBootConfig;
182
- }): string;
105
+
106
+ title?: string
107
+
108
+ titleIsHtml?: boolean
109
+
110
+ styles?: string[]
111
+
112
+ bodyScripts?: string[]
113
+
114
+ headScripts?: string[]
115
+
116
+ headStack?: string
117
+ bodyStack?: string
118
+
119
+ colorMode?: ColorModeBootConfig
120
+ }): string;
183
121
  export declare function startsDocument(html: string): boolean;
184
122
  /**
185
123
  * Does this output already carry a document wrapper?
@@ -227,3 +165,33 @@ export declare function injectConfigHeadTags(html: string, headConfig?: AppHeadC
227
165
  * so runtime `useHead` tags aren't double-emitted).
228
166
  */
229
167
  export declare function ensureDocumentShell(html: string, headConfig?: AppHeadConfig, options?: Parameters<typeof generateDocumentShell>[2], alreadyHasShell?: boolean): string;
168
+ /**
169
+ * Inline x-cloak rule shipped in the SSR <head> (stacksjs/stx#1736).
170
+ *
171
+ * Must be parsed by the browser BEFORE first paint — so it goes in the head
172
+ * as static markup, not injected by the runtime script (which runs after the
173
+ * body has already painted, the window where false `:if` branches / hidden
174
+ * `:show` elements flash). The `data-stx-cloak` marker makes injection
175
+ * idempotent. The runtime's own late injection (signals.ts) is retained as a
176
+ * belt-and-suspenders for SPA-nav fragments that arrive without SSR head
177
+ * emission.
178
+ */
179
+ export declare const CLOAK_STYLE: '<style data-stx-cloak>[x-cloak]{display:none !important}</style>';
180
+ /**
181
+ * Markers recording which `<html>` attributes stx itself wrote from `htmlAttrs`
182
+ * (stacksjs/stx#1798).
183
+ *
184
+ * The router needs them to reconcile the root element across an SPA layout
185
+ * change. It cannot just diff `<html>` against the incoming document: by then
186
+ * the color-mode boot script has added its own `dark` class / `data-theme`, and
187
+ * `animation.ts` has added `data-reduced-motion`, none of which exist in the
188
+ * server response — a blind diff would strip them on every navigation and
189
+ * flash the wrong theme. These say exactly what stx put there, so the router
190
+ * can remove precisely that much and leave runtime state alone.
191
+ *
192
+ * `class` is tracked separately because it is the one attribute that gets
193
+ * *merged* into at runtime, so it has to be reconciled token-by-token rather
194
+ * than replaced wholesale.
195
+ */
196
+ export declare const HTML_ATTRS_MARKER: 'data-stx-html-attrs';
197
+ export declare const HTML_CLASS_MARKER: 'data-stx-html-class';
@@ -1,12 +1,3 @@
1
- /**
2
- * Dynamic Component Support
3
- *
4
- * Handles `<component :is="expr">` syntax for runtime component switching.
5
- * Server-side: evaluates the expression and resolves the component.
6
- * Client-side: signals runtime watches :is binding and swaps content.
7
- *
8
- * @module dynamic-components
9
- */
10
1
  import type { StxOptions } from './types';
11
2
  /**
12
3
  * Process `<component :is="expr">` tags in the template.
@@ -32,4 +32,4 @@
32
32
  * generated `await import('stx')` rejected and the shadowing binding was never
33
33
  * created. The failure needed a real install to appear.
34
34
  */
35
- export declare const STX_ENGINE_BINDING_NAMES: readonly ['module', 'exports', 'require', 'props', '$props', '$bool', '$num', 'defineProps', 'withDefaults', 'defineClientPayload', 'useServerData', 'useRuntimeConfig', 'useServerRuntimeConfig', 'state', 'derived', 'effect', 'batch', 'onMount', 'onDestroy', 'definePageMeta', 'useRoute', 'useRouter', 'useHead', 'useSeoMeta', 'setResponseStatus', 'setResponseHeader', 'notFound', 'ref', 'reactive', 'computed', 'watch', 'onMounted', 'onUnmounted', 'nextTick', 'defineEmits', 'defineExpose', 'defineSlots', 'provide', 'inject', 'useColorMode', 'useDark', 'useMediaQuery', 'useScrollLock', 'usePreferredDark', 'usePreferredLight', 'usePreferredReducedMotion', 'usePreferredContrast', 'window', 'document', 'console', 'confirm', 'alert', 'fetch', 'params'];
35
+ export declare const STX_ENGINE_BINDING_NAMES: readonly ['module', 'exports', 'require', 'props', '$props', '$bool', '$num', 'defineProps', 'withDefaults', 'defineClientPayload', 'useServerData', 'useRuntimeConfig', 'useServerRuntimeConfig', 'state', 'derived', 'effect', 'batch', 'onMount', 'onDestroy', 'definePageMeta', 'useRoute', 'useRouter', 'useHead', 'useSeoMeta', unknown];
package/dist/env.d.ts CHANGED
@@ -1,3 +1,29 @@
1
+ /*
2
+ * The environment gates, read through a destructure rather than directly off
3
+ * `process.env.NODE_ENV`.
4
+ *
5
+ * This package is built by transforming each source file with `Bun.Transpiler`
6
+ * (see `build.ts`), and the transpiler CONSTANT-FOLDS
7
+ * `process.env.NODE_ENV === 'production'` against the environment it is itself
8
+ * running in. The release machine does not set NODE_ENV, so all three of these
9
+ * shipped as `return !1`: in every installed copy of stx, `isProduction()` and
10
+ * `isTest()` were permanently false and `isDevelopment()` permanently true,
11
+ * whatever the consuming app's NODE_ENV said.
12
+ *
13
+ * Which quietly put every app's renderer in development mode. The visible
14
+ * consequence was the error boundaries: `showBoundaries` in `process.ts` is
15
+ * `!isProduction() && !isTest()`, so a failed `<script server>` or `@include`
16
+ * rendered its red diagnostic -- absolute build-machine paths included -- to
17
+ * end users on a production deploy, which is how it was reported
18
+ * (stacksjs/stx#2035). `app-shell.ts` also always chose its `dev` variant and
19
+ * the error logger always used development verbosity.
20
+ *
21
+ * `process.env['NODE_ENV']` folds in exactly the same way. Destructuring does
22
+ * not, and nor does a computed key; this is the readable one. Pinned by
23
+ * `test/env-gates-survive-the-build.test.ts`, which runs the build's own
24
+ * transpiler over this file -- the source is correct either way, so nothing
25
+ * that reads the source can see the bug.
26
+ */
1
27
  export declare function isProduction(): boolean;
2
28
  export declare function isDevelopment(): boolean;
3
29
  export declare function isTest(): boolean;
@@ -1,3 +1,23 @@
1
+ /** Every marker removed, for output no boundary claimed. */
2
+ export declare function stripRenderFailedMarkers(html: string): string;
3
+ export declare function processErrorBoundaryDirectives(template: string, context?: Record<string, unknown>, _filePath?: string): string;
4
+ /**
5
+ * Wrap content in a try/catch for SSR error handling.
6
+ * Returns the fallback if an error occurs during rendering.
7
+ */
8
+ export declare function withErrorBoundary<T>(render: () => T | Promise<T>, fallback: T, onError?: (error: Error) => void): Promise<T>;
9
+ /**
10
+ * Create an error boundary wrapper function.
11
+ */
12
+ export declare function createErrorBoundary<T>(fallback: T, options?: ErrorBoundaryOptions): (render: () => T | Promise<T>) => Promise<T>;
13
+ /**
14
+ * Generate CSS for error boundary styling.
15
+ */
16
+ export declare function generateErrorBoundaryCSS(): string;
17
+ /**
18
+ * Generate client-side runtime for error boundaries.
19
+ */
20
+ export declare function generateErrorBoundaryRuntime(): string;
1
21
  /**
2
22
  * STX Error Boundaries
3
23
  *
@@ -19,49 +39,22 @@
19
39
  * @enderrorBoundary
20
40
  * ```
21
41
  */
22
- export interface ErrorBoundaryOptions {
23
- /** Custom error handler */
24
- onError?: (error: Error, info: ErrorInfo) => void;
25
- /** Whether to log errors to console (default: true) */
26
- logErrors?: boolean;
27
- /** Custom error ID for tracking */
28
- id?: string;
42
+ // =============================================================================
43
+ // Types
44
+ // =============================================================================
45
+ export declare interface ErrorBoundaryOptions {
46
+ onError?: (error: Error, info: ErrorInfo) => void
47
+ logErrors?: boolean
48
+ id?: string
29
49
  }
30
- export interface ErrorInfo {
31
- /** Component name where error occurred */
32
- componentName?: string;
33
- /** Stack trace */
34
- stack?: string;
35
- /** Timestamp */
36
- timestamp: number;
37
- /** Boundary ID */
38
- boundaryId: string;
50
+ export declare interface ErrorInfo {
51
+ componentName?: string
52
+ stack?: string
53
+ timestamp: number
54
+ boundaryId: string
39
55
  }
40
- export interface ErrorBoundaryState {
41
- /** Whether an error has occurred */
42
- hasError: boolean;
43
- /** The captured error */
44
- error: Error | null;
45
- /** Error info */
46
- info: ErrorInfo | null;
56
+ export declare interface ErrorBoundaryState {
57
+ hasError: boolean
58
+ error: Error | null
59
+ info: ErrorInfo | null
47
60
  }
48
- /** Every marker removed, for output no boundary claimed. */
49
- export declare function stripRenderFailedMarkers(html: string): string;
50
- export declare function processErrorBoundaryDirectives(template: string, context?: Record<string, unknown>, _filePath?: string): string;
51
- /**
52
- * Wrap content in a try/catch for SSR error handling.
53
- * Returns the fallback if an error occurs during rendering.
54
- */
55
- export declare function withErrorBoundary<T>(render: () => T | Promise<T>, fallback: T, onError?: (error: Error) => void): Promise<T>;
56
- /**
57
- * Create an error boundary wrapper function.
58
- */
59
- export declare function createErrorBoundary<T>(fallback: T, options?: ErrorBoundaryOptions): (render: () => T | Promise<T>) => Promise<T>;
60
- /**
61
- * Generate CSS for error boundary styling.
62
- */
63
- export declare function generateErrorBoundaryCSS(): string;
64
- /**
65
- * Generate client-side runtime for error boundaries.
66
- */
67
- export declare function generateErrorBoundaryRuntime(): string;
@@ -11,4 +11,4 @@
11
11
  * @see ./errors/sanitizer.ts - Parameter sanitization
12
12
  * @see ./errors/logger.ts - Error logging and recovery
13
13
  */
14
- export * from './errors';
14
+ export * from './errors/index';
@@ -1,23 +1,3 @@
1
- /**
2
- * Error Codes and Localized Messages
3
- *
4
- * Provides numeric error codes for programmatic error handling
5
- * and localized error message templates.
6
- *
7
- * @module errors/codes
8
- */
9
- /**
10
- * Error message template with placeholder support
11
- * Placeholders use {{name}} syntax
12
- */
13
- export interface ErrorMessageTemplate {
14
- message: string;
15
- help?: string;
16
- }
17
- /**
18
- * Localized error messages by error code
19
- */
20
- export type ErrorMessages = Record<number, ErrorMessageTemplate>;
21
1
  /**
22
2
  * Set the locale for error messages
23
3
  */
@@ -43,6 +23,10 @@ export declare function getErrorMessage(code: number, params?: Record<string, st
43
23
  * Format an error with localized message
44
24
  */
45
25
  export declare function formatLocalizedError(code: number, params?: Record<string, string>): string;
26
+ /**
27
+ * Get error code name from numeric code
28
+ */
29
+ export declare function getErrorCodeName(code: number): string | undefined;
46
30
  /**
47
31
  * Numeric error codes for programmatic error handling
48
32
  *
@@ -56,37 +40,45 @@ export declare function formatLocalizedError(code: number, params?: Record<strin
56
40
  * - 1600-1699: Expression errors
57
41
  */
58
42
  export declare const ErrorCodes: {
59
- readonly UNCLOSED_DIRECTIVE: 1001;
60
- readonly UNCLOSED_EXPRESSION: 1002;
61
- readonly INVALID_DIRECTIVE_SYNTAX: 1003;
62
- readonly MALFORMED_EXPRESSION: 1004;
63
- readonly UNEXPECTED_TOKEN: 1005;
64
- readonly UNDEFINED_VARIABLE: 1101;
65
- readonly TYPE_ERROR: 1102;
66
- readonly EVALUATION_ERROR: 1103;
67
- readonly INFINITE_LOOP: 1104;
68
- readonly CIRCULAR_REFERENCE: 1105;
69
- readonly UNSAFE_EXPRESSION: 1201;
70
- readonly PATH_TRAVERSAL: 1202;
71
- readonly XSS_ATTEMPT: 1203;
72
- readonly CODE_INJECTION: 1204;
73
- readonly DOM_API_VIOLATION: 1205;
74
- readonly FILE_NOT_FOUND: 1301;
75
- readonly FILE_READ_ERROR: 1302;
76
- readonly INVALID_FILE_PATH: 1303;
77
- readonly PERMISSION_DENIED: 1304;
78
- readonly INVALID_CONFIG: 1401;
79
- readonly MISSING_REQUIRED_CONFIG: 1402;
80
- readonly DEPRECATED_CONFIG: 1403;
81
- readonly COMPONENT_NOT_FOUND: 1501;
82
- readonly INVALID_PROPS: 1502;
83
- readonly COMPONENT_RENDER_ERROR: 1503;
84
- readonly FILTER_NOT_FOUND: 1601;
85
- readonly INVALID_FILTER_ARGS: 1602;
86
- readonly EXPRESSION_TIMEOUT: 1603;
43
+ UNCLOSED_DIRECTIVE: 1001;
44
+ UNCLOSED_EXPRESSION: 1002;
45
+ INVALID_DIRECTIVE_SYNTAX: 1003;
46
+ MALFORMED_EXPRESSION: 1004;
47
+ UNEXPECTED_TOKEN: 1005;
48
+ UNDEFINED_VARIABLE: 1101;
49
+ TYPE_ERROR: 1102;
50
+ EVALUATION_ERROR: 1103;
51
+ INFINITE_LOOP: 1104;
52
+ CIRCULAR_REFERENCE: 1105;
53
+ UNSAFE_EXPRESSION: 1201;
54
+ PATH_TRAVERSAL: 1202;
55
+ XSS_ATTEMPT: 1203;
56
+ CODE_INJECTION: 1204;
57
+ DOM_API_VIOLATION: 1205;
58
+ FILE_NOT_FOUND: 1301;
59
+ FILE_READ_ERROR: 1302;
60
+ INVALID_FILE_PATH: 1303;
61
+ PERMISSION_DENIED: 1304;
62
+ INVALID_CONFIG: 1401;
63
+ MISSING_REQUIRED_CONFIG: 1402;
64
+ DEPRECATED_CONFIG: 1403;
65
+ COMPONENT_NOT_FOUND: 1501;
66
+ INVALID_PROPS: 1502;
67
+ COMPONENT_RENDER_ERROR: 1503;
68
+ FILTER_NOT_FOUND: 1601;
69
+ INVALID_FILTER_ARGS: 1602;
70
+ EXPRESSION_TIMEOUT: 1603
87
71
  };
88
- export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
89
72
  /**
90
- * Get error code name from numeric code
73
+ * Error message template with placeholder support
74
+ * Placeholders use {{name}} syntax
91
75
  */
92
- export declare function getErrorCodeName(code: number): string | undefined;
76
+ export declare interface ErrorMessageTemplate {
77
+ message: string
78
+ help?: string
79
+ }
80
+ /**
81
+ * Localized error messages by error code
82
+ */
83
+ export type ErrorMessages = Record<number, ErrorMessageTemplate>;
84
+ export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];