@stacksjs/stx 0.2.571 → 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 (382) 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-4ssg5xpq.js → chunk-fynh3bkq.js} +12 -2
  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/bundle.js +11 -1
  251. package/dist/native/compiler/headwind-to-style.d.ts +383 -359
  252. package/dist/native/compiler/icons.d.ts +249 -243
  253. package/dist/native/compiler/svg.d.ts +35 -24
  254. package/dist/native/runtime/jsc-globals.d.ts +1 -1
  255. package/dist/native/runtime/native-host.d.ts +1 -1
  256. package/dist/native/runtime/native-host.js +3 -0
  257. package/dist/offline/app-service-worker.d.ts +50 -114
  258. package/dist/offline/kept-store.d.ts +23 -37
  259. package/dist/offline/query-cache.d.ts +55 -126
  260. package/dist/owned-routes.d.ts +0 -31
  261. package/dist/page-response.d.ts +8 -39
  262. package/dist/parser/directive-parser.d.ts +45 -57
  263. package/dist/parser/expression-parser.d.ts +35 -33
  264. package/dist/parser/index.d.ts +39 -4
  265. package/dist/parser/tokenizer.d.ts +49 -61
  266. package/dist/partial-hydration.d.ts +51 -82
  267. package/dist/performance-utils.d.ts +115 -255
  268. package/dist/placeholder.d.ts +9 -18
  269. package/dist/plugin-system.d.ts +115 -264
  270. package/dist/process.d.ts +4 -9
  271. package/dist/process.js +6 -4
  272. package/dist/prop-sentinels.d.ts +11 -11
  273. package/dist/public-env.d.ts +0 -14
  274. package/dist/pwa/directives.d.ts +20 -12
  275. package/dist/pwa/inject.d.ts +0 -10
  276. package/dist/pwa/precache.d.ts +16 -22
  277. package/dist/pwa/service-worker.d.ts +0 -12
  278. package/dist/pwa.js +1 -1
  279. package/dist/reactive-bindings.d.ts +11 -34
  280. package/dist/reactive-tracking.d.ts +0 -36
  281. package/dist/reactive.d.ts +41 -58
  282. package/dist/render-memo.d.ts +5 -23
  283. package/dist/resolve-stx-targets.d.ts +6 -44
  284. package/dist/route-middleware.d.ts +35 -2
  285. package/dist/route-rules.d.ts +10 -13
  286. package/dist/router.d.ts +9 -8
  287. package/dist/routes.d.ts +3 -1
  288. package/dist/runtime-config-server.d.ts +14 -17
  289. package/dist/runtime-config.d.ts +2 -3
  290. package/dist/runtime-globals.d.ts +90 -122
  291. package/dist/runtime-injection.d.ts +0 -8
  292. package/dist/scaffolding.d.ts +30 -26
  293. package/dist/script-emit.d.ts +0 -30
  294. package/dist/script-validation.d.ts +6 -12
  295. package/dist/seo.d.ts +75 -153
  296. package/dist/server-api.d.ts +9 -12
  297. package/dist/server-bindings.d.ts +1 -26
  298. package/dist/server-data.d.ts +4 -5
  299. package/dist/sfc-template.d.ts +8 -8
  300. package/dist/signal-processing.d.ts +37 -53
  301. package/dist/signals-api.d.ts +58 -135
  302. package/dist/signals.d.ts +18 -24
  303. package/dist/site-url.d.ts +31 -28
  304. package/dist/slots.d.ts +20 -86
  305. package/dist/source-signature.d.ts +5 -28
  306. package/dist/ssg.d.ts +158 -337
  307. package/dist/ssg.js +2 -2
  308. package/dist/state-dir.d.ts +4 -4
  309. package/dist/store-loader.d.ts +0 -10
  310. package/dist/story/analytics.d.ts +60 -138
  311. package/dist/story/bookmarks.d.ts +34 -87
  312. package/dist/story/cli.d.ts +69 -123
  313. package/dist/story/collect/scanner.d.ts +0 -4
  314. package/dist/story/collect/tree.d.ts +1 -8
  315. package/dist/story/commands/build.d.ts +6 -11
  316. package/dist/story/commands/dev.d.ts +8 -15
  317. package/dist/story/commands/preview.d.ts +7 -13
  318. package/dist/story/config-watcher.d.ts +13 -20
  319. package/dist/story/config.d.ts +8 -11
  320. package/dist/story/context.d.ts +8 -14
  321. package/dist/story/hmr.d.ts +26 -24
  322. package/dist/story/hot-swap.d.ts +23 -34
  323. package/dist/story/keyboard-shortcuts.d.ts +18 -23
  324. package/dist/story/output.d.ts +44 -46
  325. package/dist/story/performance.d.ts +45 -107
  326. package/dist/story/presets.d.ts +41 -107
  327. package/dist/story/renderer.d.ts +27 -41
  328. package/dist/story/search.d.ts +12 -23
  329. package/dist/story/server.d.ts +11 -21
  330. package/dist/story/setup.d.ts +15 -23
  331. package/dist/story/testing.d.ts +40 -65
  332. package/dist/story/types.d.ts +160 -262
  333. package/dist/streaming.d.ts +57 -119
  334. package/dist/strip-literals.d.ts +1 -25
  335. package/dist/stx-module-imports.d.ts +7 -0
  336. package/dist/stx-virtual-ts.d.ts +102 -253
  337. package/dist/style-scoping.d.ts +8 -21
  338. package/dist/suspense.d.ts +52 -67
  339. package/dist/teleport.d.ts +0 -22
  340. package/dist/template-syntax-escape.d.ts +8 -8
  341. package/dist/template-tag-balance.d.ts +6 -22
  342. package/dist/testing.d.ts +26 -11
  343. package/dist/theme-tokens.d.ts +388 -134
  344. package/dist/transitions.d.ts +55 -66
  345. package/dist/ts-css-config.d.ts +12 -70
  346. package/dist/types/component-types.d.ts +122 -187
  347. package/dist/types/config-types.d.ts +341 -956
  348. package/dist/types/context-types.d.ts +24 -46
  349. package/dist/types/csp-types.d.ts +66 -70
  350. package/dist/types/directive-types.d.ts +156 -223
  351. package/dist/types/index.d.ts +110 -6
  352. package/dist/types/pwa-types.d.ts +148 -273
  353. package/dist/types.d.ts +1 -0
  354. package/dist/unresolved-identifiers.d.ts +22 -24
  355. package/dist/url-safety.d.ts +32 -32
  356. package/dist/utils.d.ts +21 -36
  357. package/dist/validator.d.ts +26 -28
  358. package/dist/variable-extractor.d.ts +19 -49
  359. package/dist/view-composers.d.ts +81 -80
  360. package/dist/virtual-scrolling.d.ts +82 -101
  361. package/dist/visual-testing.d.ts +10 -9
  362. package/dist/vue-template.d.ts +0 -23
  363. package/dist/web-components/css-scoping.d.ts +11 -21
  364. package/dist/web-components.d.ts +58 -81
  365. package/dist/x-element.d.ts +1 -0
  366. package/package.json +6 -6
  367. package/stx.d.ts +2 -2
  368. package/dist/app-service-worker.d.ts +0 -165
  369. package/dist/chunk-49gwmcrn.js +0 -2
  370. package/dist/chunk-6va5pe2m.js +0 -2
  371. package/dist/chunk-bm2q1srp.js +0 -2
  372. package/dist/signals-context-runtime.d.ts +0 -2
  373. package/dist/signals-drawer-runtime.d.ts +0 -2
  374. package/dist/signals-host-runtime.d.ts +0 -9
  375. package/dist/signals-loop-conditional-runtime.d.ts +0 -2
  376. package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
  377. package/dist/signals-notify-runtime.d.ts +0 -2
  378. package/dist/signals-optimistic-runtime.d.ts +0 -2
  379. package/dist/signals-overlay-runtime.d.ts +0 -2
  380. package/dist/signals-scope-disposal-runtime.d.ts +0 -2
  381. package/dist/signals-spa-load-control-runtime.d.ts +0 -2
  382. package/dist/signals-storage-runtime.d.ts +0 -2
@@ -1,6 +1,5 @@
1
- import type { ImageDeliveryManifest } from 'ts-images/delivery';
2
1
  import { webpHeaderHasAlpha } from './image-alpha';
3
- export { webpHeaderHasAlpha };
2
+ import type { ImageDeliveryManifest } from 'ts-images/delivery';
4
3
  /**
5
4
  * Which encoders this process writes variants with, e.g.
6
5
  * `ts-webp@0.1.6+ts-avif@0.1.4`. Resolved the way ts-images resolves them,
@@ -15,6 +14,7 @@ export { webpHeaderHasAlpha };
15
14
  */
16
15
  export declare function setImageEncoderIdentity(identity?: string): void;
17
16
  export declare function imageEncoderIdentity(): string;
17
+ declare function collectRasterImages(root: string, directory?: unknown): Promise<Array<{ absolutePath: string, relativePath: string }>>;
18
18
  /** Return build-time delivery metadata for one public image URL. */
19
19
  export declare function getImageDelivery(src: string): ImageDeliveryManifest | undefined;
20
20
  /**
@@ -32,26 +32,7 @@ export declare function isTransparentImage(src: string): boolean;
32
32
  * first supported `<source>`, so any family that costs at least as much as the
33
33
  * fallback is left out.
34
34
  */
35
- export declare function efficientDeliverySources(delivery: ImageDeliveryManifest): Array<{
36
- format: 'avif' | 'webp';
37
- srcset: string;
38
- }>;
39
- /** What a component needs to render one delivered image. */
40
- export interface DeliveredImage {
41
- /** The fallback variant's URL, for `<img src>`. */
42
- src: string;
43
- /** The fallback format at every width, for `<img srcset>`. */
44
- srcset: string;
45
- /** `<source>` elements to put ahead of the `<img>`, smallest family first. */
46
- sources: Array<{
47
- type: string;
48
- srcset: string;
49
- }>;
50
- width: number;
51
- height: number;
52
- /** A data URL of the image's own preview, absent for a transparent image. */
53
- placeholder?: string;
54
- }
35
+ export declare function efficientDeliverySources(delivery: ImageDeliveryManifest): Array<{ format: 'avif' | 'webp', srcset: string }>;
55
36
  /**
56
37
  * The optimized variants of a public image, ready for markup.
57
38
  *
@@ -64,24 +45,10 @@ export interface DeliveredImage {
64
45
  export declare function deliveredImage(src: string): DeliveredImage | undefined;
65
46
  /** Clear process-global delivery state between builds and tests. */
66
47
  export declare function clearImageDeliveryCatalog(): void;
67
- /** The catalog as plain data, for a worker to post back to the thread that serves. */
68
- export interface ImageDeliverySnapshot {
69
- entries: Array<[string, ImageDeliveryManifest]>;
70
- transparent: string[];
71
- }
72
48
  /** What this thread's catalog holds, in a form `postMessage` can carry. */
73
49
  export declare function snapshotImageDelivery(): ImageDeliverySnapshot;
74
50
  /** Swap in a catalog built elsewhere, whole, as the in-thread pass does. */
75
51
  export declare function installImageDelivery(snapshot: ImageDeliverySnapshot): void;
76
- export interface PrepareImageDeliveryOptions {
77
- /**
78
- * Decode and encode on a worker thread, and install the finished catalog
79
- * here. For a long-lived server, whose event loop has requests to answer
80
- * while a cold cache re-encodes every raster. Same files, same names, same
81
- * catalog; falls back to running in-thread where no worker can start.
82
- */
83
- offThread?: boolean;
84
- }
85
52
  /**
86
53
  * Optimize every raster in the public directory before templates render.
87
54
  *
@@ -89,7 +56,38 @@ export interface PrepareImageDeliveryOptions {
89
56
  * catalog. Its content fingerprint is folded into the SSG cache key to ensure
90
57
  * changing image bytes can never reuse HTML pointing at an older asset hash.
91
58
  */
92
- export declare function prepareImageDelivery(publicDir: string, outputDir: string, options?: PrepareImageDeliveryOptions): Promise<{
93
- count: number;
94
- fingerprint: string;
95
- }>;
59
+ export declare function prepareImageDelivery(publicDir: string, outputDir: string, options?: PrepareImageDeliveryOptions): Promise<{ count: number, fingerprint: string }>;
60
+ /**
61
+ * Rasters that could not be decoded last time, by path and stat identity.
62
+ *
63
+ * A single corrupt file makes `createImageDeliveryCatalog` reject the whole
64
+ * batch, and the recovery below costs a full decode of every file plus a
65
+ * second catalog build. Nothing about that changes on the next boot — the file
66
+ * is still corrupt — so without a record the server pays it forever. This is
67
+ * that record: the next boot filters the known-bad out before the first
68
+ * attempt and takes the single-pass path.
69
+ *
70
+ * Keyed by mtime and size like the placeholder cache, so replacing a bad file
71
+ * with a good one retries it.
72
+ */
73
+ declare interface UndecodableRecord { mtimeMs: number, size: number }
74
+ /** What a component needs to render one delivered image. */
75
+ export declare interface DeliveredImage {
76
+ src: string
77
+ srcset: string
78
+ sources: Array<{ type: string, srcset: string }>
79
+ width: number
80
+ height: number
81
+ placeholder?: string
82
+ }
83
+ /** The catalog as plain data, for a worker to post back to the thread that serves. */
84
+ export declare interface ImageDeliverySnapshot {
85
+ entries: Array<[string, ImageDeliveryManifest]>
86
+ transparent: string[]
87
+ }
88
+ export declare interface PrepareImageDeliveryOptions {
89
+ offThread?: boolean
90
+ }
91
+ declare type RasterFile = Awaited<ReturnType<typeof collectRasterImages>>[number];
92
+ declare type UndecodableCache = Record<string, UndecodableRecord>;
93
+ export { webpHeaderHasAlpha };
@@ -1,38 +1,3 @@
1
- /**
2
- * Real placeholders for `<StxImage>`, derived from the image's own pixels.
3
- *
4
- * `placeholder="blur"` used to render a flat grey rectangle — the same one for
5
- * every image on the page, because the component had no way to look at the file
6
- * it was pointing at. It renders synchronously; reading and decoding a JPEG does
7
- * not. So the work moves earlier: the build warms a cache from disk, and the
8
- * component reads it with a synchronous lookup.
9
- *
10
- * What lands in the HTML is a thumbhash (evanw/thumbhash) rendered as a blurred
11
- * SVG mesh, with the image's average colour painted underneath it. Both are
12
- * inline, so there is no second request and nothing to wait for — and no
13
- * JavaScript, which is the point. A placeholder that needs a script has already
14
- * lost to the image it was supposed to cover for.
15
- *
16
- * Size was the deciding constraint. thumbhash's own 32×32 PNG is ~4.2KB per
17
- * image; nine of those roughly doubles a page here. The mesh below carries the
18
- * same information as twelve colours and gzips against its neighbours, because
19
- * every one of them is the same markup with different hex — about 480 bytes for
20
- * nine images, against 3.3KB for the PNGs.
21
- *
22
- * @module builtins/image-placeholder
23
- */
24
- /** A placeholder ready to be dropped into markup. */
25
- export interface ImagePlaceholder {
26
- /** `data:image/svg+xml;base64,…` — the blurred mesh. */
27
- dataUrl: string;
28
- /** `#rrggbb` average, painted under the mesh and used alone as a fallback. */
29
- color: string;
30
- /**
31
- * The image has transparent pixels. A placeholder painted behind it would
32
- * show through for as long as it stayed, so the component renders none.
33
- */
34
- transparent?: boolean;
35
- }
36
1
  /**
37
2
  * The placeholder for `src`, or undefined when there is none.
38
3
  *
@@ -64,21 +29,6 @@ export declare function setImagePlaceholder(urlPath: string, placeholder: ImageP
64
29
  export declare function meshSvg(rgba: Uint8Array | Uint8ClampedArray | number[], width: number, height: number, cols?: number, rows?: number): string;
65
30
  /** Base64 rather than percent-encoding: the same SVG, roughly 400 bytes shorter. */
66
31
  export declare function svgDataUrl(svg: string): string;
67
- export interface WarmOptions {
68
- /** Where the on-disk cache lives. Omit to recompute every build. */
69
- cachePath?: string;
70
- /** Skip files larger than this. Decoding a 40MB source costs more than it returns. */
71
- maxBytes?: number;
72
- /** Stop after this many images, so an enormous asset tree cannot stall a build. */
73
- limit?: number;
74
- /**
75
- * Decode on a worker thread and merge the results here. For a long-lived
76
- * server, whose event loop has requests to answer while a cold cache
77
- * decodes every image. Same placeholders, same cache file; falls back to
78
- * running in-thread where no worker can start.
79
- */
80
- offThread?: boolean;
81
- }
82
32
  /**
83
33
  * Derive placeholders for every image under `publicDir` and hold them for
84
34
  * {@link getImagePlaceholder}.
@@ -90,3 +40,15 @@ export interface WarmOptions {
90
40
  * Returns how many placeholders are available afterwards.
91
41
  */
92
42
  export declare function warmImagePlaceholders(publicDir: string, options?: WarmOptions): Promise<number>;
43
+ /** A placeholder ready to be dropped into markup. */
44
+ export declare interface ImagePlaceholder {
45
+ dataUrl: string
46
+ color: string
47
+ transparent?: boolean
48
+ }
49
+ export declare interface WarmOptions {
50
+ cachePath?: string
51
+ maxBytes?: number
52
+ limit?: number
53
+ offThread?: boolean
54
+ }
@@ -1 +1 @@
1
-
1
+ export {};
@@ -1,33 +1,3 @@
1
- /**
2
- * Runs the image pass on a worker thread.
3
- *
4
- * Decoding and encoding (AVIF, WebP, thumbhash) is pure TypeScript and fully
5
- * synchronous per image. On the thread that also answers requests, a cold pass
6
- * over a photo-heavy `public/` held the event loop for most of its minutes:
7
- * every `await` a render made queued behind the next encode, so a first page
8
- * took 14-18s and a proxy in front of the server saw empty responses. On a
9
- * worker the same code runs to the same results, and the serving thread only
10
- * receives the finished catalog.
11
- *
12
- * The worker is the mechanism, not a requirement. Where one cannot start (no
13
- * entry file beside a bundled copy and no installed one to fall back on, or a
14
- * worker that dies before it is ready), {@link runImageTask} reports that, the
15
- * caller runs the pass in-thread exactly as before, and one warning says why.
16
- *
17
- * The thread comes from `node:worker_threads`, never the global `Worker`. The
18
- * global is whatever the app left on `globalThis`, and a Stacks app's preloader
19
- * copies `@stacksjs/queue`'s exports there, including a queue `Worker` class.
20
- * `new Worker(entry)` then built a queue worker, the first `addEventListener`
21
- * threw, and the pass failed before a single image was touched. A module
22
- * import cannot be replaced that way. In Bun both constructors start the same
23
- * thread with the same structured clone, so the results are unchanged.
24
- *
25
- * @module builtins/image-worker
26
- */
27
- /** Tasks the worker entry knows how to run. */
28
- export type ImageTask = 'delivery' | 'placeholders';
29
- /** Returned instead of a result when no worker could be started. */
30
- export declare const WORKER_UNAVAILABLE: unique symbol;
31
1
  /**
32
2
  * How many image workers may run at once.
33
3
  *
@@ -36,7 +6,7 @@ export declare const WORKER_UNAVAILABLE: unique symbol;
36
6
  * Two at most: the passes are the only callers, and a third would have
37
7
  * nothing to do.
38
8
  */
39
- export declare function imageWorkerSlots(cores?: number): number;
9
+ export declare function imageWorkerSlots(cores?: unknown): number;
40
10
  /**
41
11
  * The worker entry to start.
42
12
  *
@@ -50,7 +20,7 @@ export declare function imageWorkerSlots(cores?: number): number;
50
20
  * install the bundle was built from is still on disk, though, so the entry is
51
21
  * resolved from the app's root.
52
22
  */
53
- export declare function imageWorkerEntry(root?: string): string | undefined;
23
+ export declare function imageWorkerEntry(root?: unknown): string | undefined;
54
24
  /**
55
25
  * Whether a resolved entry is the app's own install rather than a copy in
56
26
  * Bun's global package cache.
@@ -79,3 +49,7 @@ export declare function resetImageWorkerWarning(): void;
79
49
  * mid-pass is never silently re-run on the serving thread.
80
50
  */
81
51
  export declare function runImageTask<T>(task: ImageTask, args: unknown): Promise<T | typeof WORKER_UNAVAILABLE>;
52
+ /** Returned instead of a result when no worker could be started. */
53
+ export declare const WORKER_UNAVAILABLE: unique symbol;
54
+ /** Tasks the worker entry knows how to run. */
55
+ export type ImageTask = 'delivery' | 'placeholders';
@@ -1,3 +1,19 @@
1
+ import { IconBuiltin } from './icon';
2
+ import { SafeImageBuiltin } from './safe-image';
3
+ import { StxDrawerBuiltin } from './drawer';
4
+ import { StxImageBuiltin } from './stx-image';
5
+ import { StxLinkBuiltin } from './stx-link';
6
+ import { StxLoadingIndicatorBuiltin } from './stx-loading-indicator';
7
+ import { StxModalBuiltin } from './modal';
8
+ import { StxToastBuiltin } from './toast';
9
+ import { SuspenseBuiltin } from './suspense';
10
+ import { TransitionGroupBuiltin } from './transition-group';
11
+ import type { ComponentRegistry } from '../component-registry';
12
+ /**
13
+ * Register all builtin components with the supplied registry, or with the
14
+ * package singleton when no target is supplied.
15
+ */
16
+ export declare function registerBuiltins(target?: ComponentRegistry): void;
1
17
  /**
2
18
  * Builtin Components Barrel
3
19
  *
@@ -18,9 +34,3 @@ export { IconBuiltin, preloadIconCollection } from './icon';
18
34
  export { getTooltipRuntime } from './tooltip';
19
35
  export { SuspenseBuiltin } from './suspense';
20
36
  export { TransitionGroupBuiltin } from './transition-group';
21
- import type { ComponentRegistry } from '../component-registry';
22
- /**
23
- * Register all builtin components with the supplied registry, or with the
24
- * package singleton when no target is supplied.
25
- */
26
- export declare function registerBuiltins(target?: ComponentRegistry): void;
@@ -1,26 +1,16 @@
1
+ import type { BuiltinComponentDef } from '../component-registry';
2
+ declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
1
3
  /**
2
- * StxModal Builtin Component
3
- *
4
- * Renders a hidden modal dialog with slot content. Opened/closed via
5
- * the runtime `modal.open(id)` / `modal.close(id)` globals.
6
- *
7
- * Usage:
8
- * <StxModal id="settings">
9
- * <h2>Settings</h2>
10
- * <p>Modal content here</p>
11
- * </StxModal>
12
- *
13
- * <StxModal id="delete-confirm" size="sm" closeOnBackdrop="false">
14
- * <h3>Are you sure?</h3>
15
- * </StxModal>
16
- *
17
- * Props:
18
- * - id (required) — unique modal identifier
19
- * - size — 'sm' | 'md' | 'lg' | 'xl' | 'full' (default: 'md')
20
- * - closeOnBackdrop — whether clicking backdrop closes modal (default: true)
21
- * - closeOnEscape — whether Escape key closes modal (default: true)
22
- *
23
- * @module builtins/modal
4
+ * @defaultValue
5
+ * ```ts
6
+ * {
7
+ * sm: 'max-width:24rem',
8
+ * md: 'max-width:32rem',
9
+ * lg: 'max-width:42rem',
10
+ * xl: 'max-width:56rem',
11
+ * full: 'max-width:calc(100vw - 2rem);max-height:calc(100vh - 2rem)'
12
+ * }
13
+ * ```
24
14
  */
25
- import type { BuiltinComponentDef } from '../component-registry';
15
+ declare const SIZE_WIDTHS: Record<string, string>;
26
16
  export declare const StxModalBuiltin: BuiltinComponentDef;
@@ -1,44 +1,4 @@
1
- /**
2
- * SafeImage Builtin Component
3
- *
4
- * Drop-in `<img>` replacement with a declarative broken-image fallback.
5
- * Third-party image URLs (external-CDN avatars, user content that gets
6
- * deleted, seed data pointing at links that 404) fail frequently in
7
- * production; without intervention the browser draws the alt text inside
8
- * whatever layout frame the `<img>` had — round avatar frames in
9
- * particular look broken.
10
- *
11
- * SafeImage wires an inline `onerror=` handler that swaps to a fallback
12
- * image (and optionally swaps the class string) when the primary src
13
- * fails to load.
14
- *
15
- * Usage:
16
- * <SafeImage src="/avatars/u.png" alt="User" fallback="/avatars/default.svg" />
17
- * <SafeImage :src="judge.photo" :alt="judge.name"
18
- * className="h-12 w-12 rounded-full grayscale filter"
19
- * fallbackClassName="h-12 w-12 rounded-full"
20
- * fallback="/images/avatars/default-judge.svg" />
21
- *
22
- * Why inline `onerror=` rather than a delegated capture-phase listener:
23
- * `error` events don't bubble, so a listener attached by a component's
24
- * `<script client>` IIFE runs AFTER the element's first load attempt —
25
- * cached 404s and offline first paint slip past it. The inline HTML
26
- * `onerror=` attribute is parsed-and-attached synchronously with the
27
- * element by the browser's HTML parser, before the image request fires.
28
- * That's the only race-free option for the error path.
29
- *
30
- * Why a single window-level handler rather than per-instance inline
31
- * closures: keeps rendered HTML small (a ~35-byte attribute vs. a
32
- * ~120-byte inline function body per `<img>`). The handler is emitted
33
- * once per page render (gated on a render-context flag) and registered
34
- * once per browser session (gated on the `window.__stxSafeImageHandler`
35
- * existence check, so it's also idempotent across SPA navigation).
36
- * Per-instance config travels via `data-*` attributes, so the handler
37
- * stays stateless.
38
- *
39
- * Resolves stacksjs/stx#1732.
40
- *
41
- * @module builtins/safe-image
42
- */
43
1
  import type { BuiltinComponentDef } from '../component-registry';
2
+ declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
3
+ declare const DEFAULT_FALLBACK: '/images/safe-image-default.svg';
44
4
  export declare const SafeImageBuiltin: BuiltinComponentDef;
@@ -1,29 +1,49 @@
1
+ import type { BuiltinComponentDef } from '../component-registry';
2
+ declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
3
+ declare function resolveBoolProp(props: ResolvedProps, key: string, defaultVal?: boolean): boolean;
1
4
  /**
2
- * StxImage Builtin Component
3
- *
4
- * Full-featured image component matching NuxtImage capabilities:
5
- *
6
- * - Auto `loading="lazy"` + `decoding="async"`
7
- * - Responsive `srcset` + `sizes` auto-generation from breakpoints
8
- * - Density descriptors (`1x`, `2x`, `3x`)
9
- * - `<picture>` wrapper with format negotiation (avif, webp fallback)
10
- * - Blur-up / color / empty placeholder modes
11
- * - Aspect ratio preservation (CLS prevention)
12
- * - Preload hint injection (`<link rel="preload">`)
13
- * - CDN provider support (Cloudinary, imgix, custom)
5
+ * Parse sizes prop: "sm:100vw md:50vw lg:33vw" → proper sizes attribute
6
+ * Also accepts raw sizes string: "(max-width: 768px) 100vw, 50vw"
7
+ */
8
+ declare function parseSizes(sizesStr: string): string;
9
+ /**
10
+ * Generate srcset from widths: "/img.jpg 320w, /img.jpg 640w, ..."
11
+ * For local images, just generates width descriptors.
12
+ * For CDN providers, generates resized URLs.
13
+ */
14
+ declare function generateSrcset(src: string, widths: number[], provider?: string, format?: string): string;
15
+ /**
16
+ * Generate density srcset: "/img.jpg 1x, /img@2x.jpg 2x"
17
+ */
18
+ declare function generateDensitySrcset(src: string, densities: number[], width: number | undefined, provider?: string, format?: string): string;
19
+ /**
20
+ * Transform src URL based on provider.
21
+ * For local images, returns as-is (optimization happens at build time via stx's image pipeline).
22
+ * For CDN providers, generates the appropriate URL.
23
+ */
24
+ declare function transformSrc(src: string, width?: number, height?: number, provider?: string, format?: string): string;
25
+ /**
26
+ * The `onload` handler that takes a placeholder away once the image is there.
14
27
  *
15
- * Usage:
16
- * <StxImage src="/images/hero.jpg" alt="Hero" />
17
- * <StxImage src="/images/hero.jpg" alt="Hero" width="800" height="600" />
18
- * <StxImage src="/images/hero.jpg" alt="Hero" sizes="sm:100vw md:50vw lg:33vw" />
19
- * <StxImage src="/images/hero.jpg" alt="Hero" densities="1x 2x" />
20
- * <StxImage src="/images/hero.jpg" alt="Hero" format="webp" />
21
- * <StxImage src="/images/hero.jpg" alt="Hero" placeholder="blur" />
22
- * <StxImage src="/images/hero.jpg" alt="Hero" placeholder="thumbhash" />
23
- * <StxImage src="/images/hero.jpg" alt="Hero" preload />
24
- * <StxImage src="/images/hero.jpg" alt="Hero" provider="cloudinary" />
28
+ * Only the longhands the placeholder set are cleared, so a background the
29
+ * author wrote into `style` for their own reasons survives. An inline handler
30
+ * rather than a listener for the same reason `<SafeImage>` uses one: the
31
+ * parser attaches it with the element, before the request goes out, so an
32
+ * image that is already cached (or decoded before any script runs) still
33
+ * fires it. A listener added at hydration misses exactly those.
25
34
  *
26
- * @module builtins/stx-image
35
+ * Opaque images covered their placeholder anyway, but not every image fills
36
+ * its box (`object-fit: contain`, a filter, a rounded frame), and a
37
+ * placeholder that outlives its image is simply wrong.
27
38
  */
28
- import type { BuiltinComponentDef } from '../component-registry';
39
+ declare function placeholderCleanup(properties: string[]): string;
40
+ /**
41
+ * Generate a tiny SVG placeholder for blur-up effect
42
+ */
43
+ declare function generateBlurPlaceholder(width: number, height: number, color?: string): string;
44
+ /**
45
+ * Default widths for srcset generation
46
+ * @defaultValue `[320, 640, 768, 1024, 1280, 1536, 1920]`
47
+ */
48
+ declare const DEFAULT_SRCSET_WIDTHS: number[];
29
49
  export declare const StxImageBuiltin: BuiltinComponentDef;
@@ -1,11 +1,8 @@
1
+ import type { BuiltinComponentDef } from '../component-registry';
1
2
  /**
2
- * StxLink Builtin Component
3
- *
4
- * Renders a client-side navigation-aware `<a>` element with support for
5
- * active class management, prefetching, and reactive href bindings.
6
- * Produces plain HTML — no wrapper component or custom element overhead.
7
- *
8
- * @module builtins/stx-link
3
+ * Resolve the `to` prop from any binding category.
4
+ * Returns an object indicating whether the value is a static string
5
+ * or a client-reactive expression.
9
6
  */
10
- import type { BuiltinComponentDef } from '../component-registry';
7
+ declare function resolveTo(props: ResolvedProps): { value: string, reactive: boolean };
11
8
  export declare const StxLinkBuiltin: BuiltinComponentDef;
@@ -1,13 +1,14 @@
1
+ import type { BuiltinComponentDef } from '../component-registry';
1
2
  /**
2
- * StxLoadingIndicator Builtin Component
3
- *
4
- * Renders a fixed-position progress bar at the top of the viewport that
5
- * activates on navigation. Includes shimmer animation, automatic
6
- * link-click interception, and a global `window.stxLoading` API.
7
- *
8
- * Ported from the inline implementation in component-processing.ts.
9
- *
10
- * @module builtins/stx-loading-indicator
3
+ * Sanitize a CSS value to prevent injection (strips semicolons, braces, url()).
11
4
  */
12
- import type { BuiltinComponentDef } from '../component-registry';
5
+ declare function sanitizeCss(value: string): string;
6
+ /**
7
+ * Resolve a string prop from static or server-dynamic bindings.
8
+ */
9
+ declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
10
+ /**
11
+ * Resolve a numeric prop, returning the default if not provided or not a valid number.
12
+ */
13
+ declare function resolveNumericProp(props: ResolvedProps, key: string, defaultValue: number): number;
13
14
  export declare const StxLoadingIndicatorBuiltin: BuiltinComponentDef;
@@ -1,30 +1,9 @@
1
+ import type { BuiltinComponentDef } from '../component-registry';
2
+ /** Resolve a string prop from static or server-dynamic bindings. */
3
+ declare function resolveProp(props: ResolvedProps, ...keys: string[]): string | undefined;
1
4
  /**
2
- * Suspense Builtin Component (stacksjs/stx#1742)
3
- *
4
- * A client loading boundary. Renders three regions that the signals runtime
5
- * (`bindSuspense`) toggles based on the aggregated state of descendant suspense
6
- * queries (`useQuery` / `useFetch` with `{ suspense: true }`):
7
- *
8
- * - `[data-stx-suspense-fallback]` — shown while any descendant query loads
9
- * - `[data-stx-suspense-error]` — shown when a descendant query errors
10
- * - `[data-stx-suspense-content]` — shown once all descendant queries resolve
11
- *
12
- * The default slot is the content; `fallback` / `errorFallback` come from props
13
- * or from `slot="fallback"` / `slot="error"` elements in the slot content.
14
- *
15
- * ```stx
16
- * <Suspense fallback="Loading…">
17
- * <CommentsList /> <!-- uses useQuery(url, { suspense: true }) -->
18
- * </Suspense>
19
- *
20
- * <Suspense>
21
- * <template slot="fallback"><Skeleton count="2" /></template>
22
- * <template slot="error">Couldn't load comments.</template>
23
- * <CommentsList />
24
- * </Suspense>
25
- * ```
26
- *
27
- * @module builtins/suspense
5
+ * Extract a `slot="name"` / `<template slot="name">` region from slot content,
6
+ * returning the region's inner HTML and the content with that region removed.
28
7
  */
29
- import type { BuiltinComponentDef } from '../component-registry';
8
+ declare function extractSlot(content: string, name: string): { region: string | null, rest: string };
30
9
  export declare const SuspenseBuiltin: BuiltinComponentDef;
@@ -1,19 +1,18 @@
1
+ import type { BuiltinComponentDef } from '../component-registry';
2
+ declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
3
+ declare function resolveNumericProp(props: ResolvedProps, key: string, defaultValue: number): number;
1
4
  /**
2
- * StxToast Builtin Component
3
- *
4
- * Renders a fixed-position toast notification container. The runtime
5
- * `toast()` global (success / error / info / warning / dismiss) creates
6
- * and animates individual toast elements inside this container.
7
- *
8
- * Usage:
9
- * <StxToast />
10
- * <StxToast position="top-right" max="5" />
11
- * <StxToast position="bottom-left" />
12
- *
13
- * Positions: top-right (default), top-left, top-center,
14
- * bottom-right, bottom-left, bottom-center
15
- *
16
- * @module builtins/toast
5
+ * @defaultValue
6
+ * ```ts
7
+ * {
8
+ * 'top-right': 'top:1rem;right:1rem',
9
+ * 'top-left': 'top:1rem;left:1rem',
10
+ * 'top-center': 'top:1rem;left:50%;transform:translateX(-50%)',
11
+ * 'bottom-right': 'bottom:1rem;right:1rem',
12
+ * 'bottom-left': 'bottom:1rem;left:1rem',
13
+ * 'bottom-center': 'bottom:1rem;left:50%;transform:translateX(-50%)'
14
+ * }
15
+ * ```
17
16
  */
18
- import type { BuiltinComponentDef } from '../component-registry';
17
+ declare const POSITION_STYLES: Record<string, string>;
19
18
  export declare const StxToastBuiltin: BuiltinComponentDef;
@@ -1,27 +1,3 @@
1
- /**
2
- * TransitionGroup Builtin Component (stacksjs/stx#1742)
3
- *
4
- * Class-driven enter/leave + FLIP move animations for a keyed list. Renders a
5
- * single wrapper element marked `data-stx-transition-group="<name>"`; the
6
- * signals runtime's `bindFor` animates the list items inside it when they are
7
- * added, removed, or reordered.
8
- *
9
- * The default slot must contain a single `:for` (or `x-for`) element whose
10
- * rendered items become the wrapper's direct children:
11
- *
12
- * ```stx
13
- * <TransitionGroup name="card" tag="ul" class="space-y-2">
14
- * <li :for="r in reviews()" :key="r.id" class="card">{{ r.title }}</li>
15
- * </TransitionGroup>
16
- * ```
17
- *
18
- * With `name="card"`, supply the transition classes (e.g. via css/CSS):
19
- * `card-enter-from` / `card-enter-active` / `card-enter-to`,
20
- * `card-leave-from` / `card-leave-active` / `card-leave-to`, and `card-move`
21
- * (applied to elements that shift position during a reorder). The first render
22
- * does not animate; subsequent list changes do.
23
- *
24
- * @module builtins/transition-group
25
- */
26
1
  import type { BuiltinComponentDef } from '../component-registry';
2
+ declare function resolveProp(props: ResolvedProps, ...keys: string[]): string | undefined;
27
3
  export declare const TransitionGroupBuiltin: BuiltinComponentDef;