@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
@@ -3,315 +3,4 @@
3
3
  * Client-side helper utilities for stx applications.
4
4
  * Injected as a <script> tag to provide common UI patterns.
5
5
  */
6
- export declare const stxClientHelpers: `
7
- <script data-stx-helpers>
8
- (function() {
9
- 'use strict'
10
-
11
- if (window.__stxHelpers) return
12
- window.__stxHelpers = true
13
-
14
- window.stx = window.stx || {}
15
-
16
- // ===== FORMATTERS =====
17
-
18
- stx.formatCurrency = function(val, currency, locale) {
19
- return new Intl.NumberFormat(locale || 'en-US', {
20
- style: 'currency',
21
- currency: currency || 'USD',
22
- }).format(val)
23
- }
24
-
25
- stx.formatNumber = function(val, decimals, locale) {
26
- var opts = {}
27
- if (typeof decimals === 'number') {
28
- opts.minimumFractionDigits = decimals
29
- opts.maximumFractionDigits = decimals
30
- }
31
- return new Intl.NumberFormat(locale || 'en-US', opts).format(val)
32
- }
33
-
34
- stx.formatDate = function(val, format, locale) {
35
- locale = locale || 'en-US'
36
- var d = val instanceof Date ? val : new Date(val)
37
- if (isNaN(d.getTime())) return String(val)
38
-
39
- if (format === 'long') return d.toLocaleDateString(locale, { year: 'numeric', month: 'long', day: 'numeric' })
40
- if (format === 'relative') {
41
- var diff = Date.now() - d.getTime()
42
- var mins = Math.floor(diff / 60000)
43
- if (mins < 1) return 'just now'
44
- if (mins < 60) return mins + 'm ago'
45
- var hrs = Math.floor(mins / 60)
46
- if (hrs < 24) return hrs + 'h ago'
47
- var days = Math.floor(hrs / 24)
48
- if (days < 7) return days + 'd ago'
49
- return d.toLocaleDateString(locale)
50
- }
51
- return d.toLocaleDateString(locale)
52
- }
53
-
54
- stx.formatPhone = function(phone) {
55
- var n = String(phone).replace(/\\D/g, '')
56
- if (n.length === 10) return \`(\${n.slice(0,3)}) \${n.slice(3,6)}-\${n.slice(6)}\`
57
- if (n.length === 11 && n[0] === '1') return \`+1 (\${n.slice(1,4)}) \${n.slice(4,7)}-\${n.slice(7)}\`
58
- return phone
59
- }
60
-
61
- stx.renderStars = function(rating, max) {
62
- max = max || 5
63
- var full = Math.floor(rating)
64
- var half = rating - full >= 0.5
65
- var h = ''
66
- for (var i = 0; i < max; i++) {
67
- if (i < full || (i === full && half))
68
- h += '<span style="color: var(--badge-amber-text, #f59e0b)">\\u2605</span>'
69
- else
70
- h += '<span style="color: var(--text-muted, #6b7280)">\\u2606</span>'
71
- }
72
- return h
73
- }
74
-
75
- // ===== BADGE SYSTEM =====
76
-
77
- var badgeMaps = {
78
- status: {
79
- 'Active Repair': 'badge-amber', 'Completed': 'badge-emerald',
80
- 'Pending Pickup': 'badge-blue', 'Pending Estimate': 'badge-slate',
81
- 'Approved': 'badge-emerald', 'In Review': 'badge-blue',
82
- 'Supplement': 'badge-amber', 'Draft': 'badge-slate', 'Rejected': 'badge-red',
83
- 'Delivered': 'badge-emerald', 'Shipped': 'badge-blue', 'Processing': 'badge-amber',
84
- 'In Stock': 'badge-emerald', 'Backordered': 'badge-red', 'Low Stock': 'badge-amber',
85
- },
86
- priority: { 'Rush': 'badge-red', 'High': 'badge-amber', 'Normal': 'badge-blue', 'Low': 'badge-slate' },
87
- severity: { 'light': 'severity-light', 'moderate': 'severity-moderate', 'heavy': 'severity-heavy' },
88
- type: { 'OEM': 'badge-blue', 'Aftermarket': 'badge-amber', 'Recycled': 'badge-emerald', 'Reman': 'badge-slate' },
89
- drp: { 'Active DRP': 'badge-emerald', 'Preferred': 'badge-blue', 'Standard': 'badge-slate' },
90
- }
91
-
92
- stx.registerBadgeMap = function(name, map) {
93
- badgeMaps[name] = Object.assign(badgeMaps[name] || {}, map)
94
- }
95
-
96
- stx.badgeClass = function(value, mapName) {
97
- var map = badgeMaps[mapName || 'status'] || badgeMaps.status
98
- return map[value] || 'badge-slate'
99
- }
100
-
101
- stx.badge = function(value, mapName) {
102
- return \`<span class="inline-flex px-2.5 py-1 rounded-full text-xs font-medium \${stx.badgeClass(value, mapName)}">\${value}</span>\`
103
- }
104
-
105
- // ===== DETAIL PANEL BUILDER =====
106
-
107
- function esc(v) { return v != null ? v : '\\u2014' }
108
-
109
- stx.detail = {
110
- panel: function(opts) {
111
- if (!opts || !opts.title) return ''
112
- var badges = ''
113
- if (opts.badges) {
114
- opts.badges.forEach(function(b) { badges += stx.badge(b.text, b.map) })
115
- }
116
- return \`
117
- <div style="display:flex;align-items:center;justify-content:space-between;padding:1.25rem 1.5rem;border-bottom:1px solid var(--border-main)">
118
- <div>
119
- <h2 style="font-size:1.25rem;font-weight:700;color:var(--text-primary)">\${opts.title}</h2>
120
- \${opts.subtitle ? \`<p style="font-size:0.75rem;color:var(--text-muted);margin-top:0.25rem">\${opts.subtitle}</p>\` : ''}
121
- </div>
122
- <div style="display:flex;align-items:center;gap:0.75rem">
123
- \${badges}
124
- <button onclick="closeSlideOver()" style="padding:0.5rem;border-radius:0.5rem;color:var(--text-muted);background:none;border:none;cursor:pointer;font-size:1.5rem;line-height:1" aria-label="Close">&times;</button>
125
- </div>
126
- </div>\`
127
- },
128
-
129
- section: function(label, rows) {
130
- var inner = ''
131
- if (rows) {
132
- if (!Array.isArray(rows) && typeof rows === 'object') {
133
- Object.keys(rows).forEach(function(k) { inner += stx.detail.row(k, rows[k]) })
134
- }
135
- else {
136
- rows.forEach(function(r) {
137
- if (Array.isArray(r)) inner += stx.detail.row(r[0], r[1])
138
- else inner += stx.detail.row(r.label, r.value)
139
- })
140
- }
141
- }
142
- return \`
143
- <div class="detail-section">
144
- <div class="detail-label">\${label}</div>
145
- \${inner}
146
- </div>\`
147
- },
148
-
149
- row: function(label, value) {
150
- return \`
151
- <div class="detail-row">
152
- <span class="detail-row-label">\${label}</span>
153
- <span class="detail-row-value">\${esc(value)}</span>
154
- </div>\`
155
- },
156
-
157
- stats: function(items) {
158
- var list = Array.isArray(items)
159
- ? items
160
- : Object.keys(items).map(function(k) { return { label: k, value: items[k] } })
161
-
162
- var cards = list.map(function(item) {
163
- return \`
164
- <div style="padding:0.75rem;border-radius:0.5rem;background:var(--bg-subtle);text-align:center">
165
- <div style="font-size:1.25rem;font-weight:700;color:var(--text-primary)">\${item.value}</div>
166
- <div style="font-size:0.6875rem;color:var(--text-muted);margin-top:0.25rem">\${item.label}</div>
167
- </div>\`
168
- }).join('')
169
-
170
- return \`<div style="display:grid;grid-template-columns:repeat(auto-fit,minmax(120px,1fr));gap:0.75rem;padding:0 1.5rem 1rem">\${cards}</div>\`
171
- },
172
-
173
- timeline: function(items) {
174
- var entries = items.map(function(item, i) {
175
- var color = item.color || 'var(--text-accent)'
176
- var isLast = i === items.length - 1
177
-
178
- return \`
179
- <div style="display:flex;gap:0.75rem">
180
- <div style="display:flex;flex-direction:column;align-items:center;flex-shrink:0">
181
- <div style="width:10px;height:10px;border-radius:50%;background:\${color};flex-shrink:0"></div>
182
- \${!isLast ? '<div style="width:2px;flex:1;background:var(--bar-track);min-height:24px"></div>' : ''}
183
- </div>
184
- <div style="padding-bottom:\${isLast ? '0' : '1rem'};flex:1">
185
- <div style="font-size:0.8125rem;font-weight:500;color:var(--text-primary)">\${item.title}</div>
186
- \${item.description ? \`<div style="font-size:0.75rem;color:var(--text-muted);margin-top:0.125rem">\${item.description}</div>\` : ''}
187
- \${item.meta ? \`<div style="font-size:0.6875rem;color:var(--text-tertiary);margin-top:0.25rem">\${item.meta}</div>\` : ''}
188
- </div>
189
- </div>\`
190
- }).join('')
191
-
192
- return \`<div style="padding:0 1.5rem 1rem">\${entries}</div>\`
193
- },
194
-
195
- open: function(html) {
196
- if (typeof openSlideOver === 'function') openSlideOver(html)
197
- },
198
- }
199
-
200
- // ===== DATA TABLE HELPERS =====
201
-
202
- stx.table = {
203
- filter: function(opts) {
204
- var searchEl = document.getElementById(opts.searchId)
205
- var search = searchEl ? searchEl.value.toLowerCase() : ''
206
- var rows = document.querySelectorAll(opts.rowSelector || 'tbody tr')
207
- var filters = opts.filters || []
208
- var matched = []
209
-
210
- rows.forEach(function(row) {
211
- var text = row.textContent.toLowerCase()
212
- var matchSearch = !search || text.indexOf(search) !== -1
213
- var matchFilters = filters.every(function(f) {
214
- var el = document.getElementById(f.id)
215
- if (!el) return true
216
- var val = el.value
217
- if (!val || val === f.allValue) return true
218
- return row.getAttribute(\`data-\${f.attr}\`) === val
219
- })
220
-
221
- if (matchSearch && matchFilters) matched.push(row)
222
- else row.style.display = 'none'
223
- })
224
-
225
- return matched
226
- },
227
-
228
- sort: function(rows, sortBy, direction) {
229
- direction = direction || 'asc'
230
- return rows.slice().sort(function(a, b) {
231
- var aVal = a.getAttribute(\`data-\${sortBy}\`) || a.textContent
232
- var bVal = b.getAttribute(\`data-\${sortBy}\`) || b.textContent
233
- var aNum = parseFloat(aVal.replace(/[^0-9.-]/g, ''))
234
- var bNum = parseFloat(bVal.replace(/[^0-9.-]/g, ''))
235
- if (!isNaN(aNum) && !isNaN(bNum)) return direction === 'asc' ? aNum - bNum : bNum - aNum
236
- return direction === 'asc' ? aVal.localeCompare(bVal) : bVal.localeCompare(aVal)
237
- })
238
- },
239
- }
240
-
241
- // ===== PAGINATION =====
242
-
243
- stx.pagination = function(opts) {
244
- var page = opts.page || 1
245
- var perPage = opts.perPage || 10
246
- var items = opts.items || []
247
- var total = items.length
248
- var totalPages = Math.max(1, Math.ceil(total / perPage))
249
- if (page > totalPages) page = totalPages
250
-
251
- var start = (page - 1) * perPage
252
- var end = Math.min(start + perPage, total)
253
-
254
- items.forEach(function(el, i) { el.style.display = (i >= start && i < end) ? '' : 'none' })
255
-
256
- var ids = { count: opts.countId, total: opts.totalId, empty: opts.emptyId, bar: opts.barId }
257
- if (ids.count) { var el = document.getElementById(ids.count); if (el) el.textContent = total === 0 ? '0' : \`\${start + 1}\\u2013\${end}\` }
258
- if (ids.total) { var el = document.getElementById(ids.total); if (el) el.textContent = total }
259
- if (ids.empty) { var el = document.getElementById(ids.empty); if (el) el.style.display = total === 0 ? 'block' : 'none' }
260
- if (ids.bar) { var el = document.getElementById(ids.bar); if (el) el.style.display = total === 0 ? 'none' : '' }
261
-
262
- if (opts.buttonsId) {
263
- var wrap = document.getElementById(opts.buttonsId)
264
- if (wrap) {
265
- var go = opts.goToPage
266
- var pages = stx.pagination.getPages(page, totalPages)
267
-
268
- var btn = function(label, target, disabled) {
269
- return \`<button onclick="\${go}(\${target})" \${disabled ? 'disabled' : ''}
270
- class="px-3 py-1.5 rounded-lg text-sm cursor-pointer"
271
- style="background:var(--bg-subtle);border:1px solid var(--border-input);color:\${disabled ? 'var(--text-muted)' : 'var(--text-primary)'};opacity:\${disabled ? '0.5' : '1'}">\${label}</button>\`
272
- }
273
-
274
- var h = btn('Previous', page - 1, page === 1)
275
- pages.forEach(function(p) {
276
- if (p === '...') {
277
- h += '<span class="px-2 text-sm" style="color:var(--text-muted)">\\u2026</span>'
278
- }
279
- else if (p === page) {
280
- h += \`<button class="w-9 h-9 rounded-lg text-sm font-medium" style="background:var(--btn-primary-bg, var(--text-accent));color:#fff">\${p}</button>\`
281
- }
282
- else {
283
- h += btn(p, p, false)
284
- }
285
- })
286
- h += btn('Next', page + 1, page === totalPages)
287
- wrap.innerHTML = h
288
- }
289
- }
290
-
291
- return { page: page, totalPages: totalPages, total: total, start: start, end: end }
292
- }
293
-
294
- stx.pagination.getPages = function(current, total) {
295
- if (total <= 7) return Array.from({ length: total }, function(_, i) { return i + 1 })
296
- var pages = [1]
297
- if (current > 3) pages.push('...')
298
- for (var i = Math.max(2, current - 1); i <= Math.min(total - 1, current + 1); i++) pages.push(i)
299
- if (current < total - 2) pages.push('...')
300
- pages.push(total)
301
- return pages
302
- }
303
-
304
- // ===== UTILITIES =====
305
-
306
- stx.debounce = function(fn, delay) {
307
- var timer
308
- return function() {
309
- var args = arguments, ctx = this
310
- clearTimeout(timer)
311
- timer = setTimeout(function() { fn.apply(ctx, args) }, delay || 250)
312
- }
313
- }
314
-
315
- })()
316
- </script>
317
- `;
6
+ export declare const stxClientHelpers: string;
@@ -1,21 +1,3 @@
1
- /**
2
- * Page-level module registry (stacksjs/stx#1957).
3
- *
4
- * A component's `<script client>` bundle no longer inlines the modules it
5
- * imports. Its direct imports become reads of `globalThis.__stxModules[id]`
6
- * (see `rewriteRegistryImports` in client-script-bundler.ts), and this module
7
- * builds the ONE bundle per page that fills that registry. Every imported
8
- * module is therefore bundled once and evaluated once, so module state -- a
9
- * cache, a session, a list of registered hooks -- is page-wide, the way
10
- * `@stores` and `@composables` already are.
11
- *
12
- * Which modules a page needs is read from the page's own output, not tracked
13
- * while it renders. Component bundles are cached per script, and a cache hit
14
- * never runs the build that would have reported its imports; the reads it
15
- * emitted are in the HTML either way.
16
- *
17
- * @module client-module-registry
18
- */
19
1
  /** Module ids read anywhere in `sources`, sorted so the bundle key is stable. */
20
2
  export declare function registeredModuleIdsIn(...sources: Array<string | null | undefined>): string[];
21
3
  /**
@@ -32,12 +14,7 @@ export declare function registeredModuleIdsIn(...sources: Array<string | null |
32
14
  * developer can act on, rather than the page silently losing its bundles.
33
15
  */
34
16
  export declare function buildModuleRegistryScript(ids: string[], options?: {
35
- minify?: boolean;
36
- /**
37
- * Receives the files the registry was built from - the modules' own
38
- * sources, `node_modules` included. The registry is inlined into the
39
- * page, so the page depends on them; a caller caching the page has to
40
- * know, or upgrading a package leaves the page serving the old one.
41
- */
42
- collectInputs?: string[];
43
- }): Promise<string | null>;
17
+ minify?: boolean
18
+
19
+ collectInputs?: string[]
20
+ }): Promise<string | null>;
@@ -1,7 +1,4 @@
1
- export declare function parameterAnalysis(source: string): {
2
- code: string;
3
- shadows: (name: string, offset: number) => boolean;
4
- };
1
+ export declare function parameterAnalysis(source: string): { code: string, shadows: (name: string, offset: number) => boolean };
5
2
  /**
6
3
  * Every name the script declares: each declarator of a `const`/`let`/`var`
7
4
  * list (destructuring included), function and class names, and default or
@@ -1,49 +1,12 @@
1
- /**
2
- * Client Script Bundler
3
- *
4
- * Uses Bun.build to resolve and bundle imports in `<script client>` blocks.
5
- * Only activates when real user imports are detected (local files, npm packages).
6
- * stx runtime, @stores, and @composables are marked as external — handled
7
- * by existing auto-import and store-import transforms.
8
- *
9
- * @module client-script-bundler
10
- */
11
1
  import type { BuildFailureDetail } from './build-message';
12
2
  export declare function clientBundleDependencies(filePath: string): string[];
13
- export declare function shouldLogBundlerDiagnostics(environment?: {
14
- STX_DEBUG?: string;
15
- }): boolean;
16
- /**
17
- * Client-script bundle failures recorded during the current process.
18
- *
19
- * When a `<script client>` block fails to bundle, the bundler falls back to
20
- * shipping the ORIGINAL, unbundled source so the page still renders. That is a
21
- * reasonable dev-server behaviour and a terrible build behaviour: imports never
22
- * resolve, bindings silently do nothing, and `stx build` still exited 0, so CI
23
- * published a broken page as a success.
24
- *
25
- * Nothing was counting these. `ssg.failedCount` only ever saw render-time throws,
26
- * never a bundle failure, because the fallback swallowed it and returned a
27
- * string. The registry gives the build a way to ask, without the bundler having
28
- * to know whether it is running under a dev server or a build. See #1884.
29
- */
30
- export interface BundleFailure {
31
- filePath: string;
32
- message: string;
33
- /**
34
- * The same failure with its position intact, for a dev-server overlay to
35
- * draw a code frame from. Absent only when the thrower gave no position.
36
- */
37
- details?: BuildFailureDetail[];
38
- }
3
+ export declare function shouldLogBundlerDiagnostics(environment?: { STX_DEBUG?: string }): boolean;
39
4
  /** Record a bundle failure. Called from the bundler's fallback path. */
40
5
  export declare function recordBundleFailure(filePath: string, message: string, details?: BuildFailureDetail[]): void;
41
6
  /** Every bundle failure since the last reset. */
42
7
  export declare function getBundleFailures(): BundleFailure[];
43
8
  /** Drop recorded failures — call at the start of a build, and in tests. */
44
9
  export declare function clearBundleFailures(): void;
45
- /** What to do when a client script will not bundle. */
46
- export type BundlerFallbackMode = 'warn' | 'error';
47
10
  /**
48
11
  * Override the configured fallback mode, for tests and embedders.
49
12
  *
@@ -69,27 +32,6 @@ export declare function resolveBundlerFallback(): BundlerFallbackMode;
69
32
  * - `import { ... } from '@composables'` (handled by transformStoreImports)
70
33
  */
71
34
  export declare function hasUserImports(code: string): boolean;
72
- /**
73
- * Specifier prefix for an import the PAGE serves rather than the bundle
74
- * inlines (stacksjs/stx#1957).
75
- *
76
- * Every component's `<script client>` used to be bundled with its imports
77
- * inlined, one Bun.build per script. Two components importing one module each
78
- * carried their own copy of it, so module state -- a cache, a registry, an
79
- * in-flight promise -- existed once per component instead of once per page,
80
- * and the page shipped the same code several times. A real page made five
81
- * `GET /api/me` calls on load because its auth module had five copies.
82
- *
83
- * A component's direct imports are now externalised to `stx-module:<id>` and
84
- * rewritten into reads of `globalThis.__stxModules`, which one page-level
85
- * bundle populates (see client-module-registry.ts): each imported module is
86
- * bundled once and evaluated once per page.
87
- *
88
- * The id is the path relative to the project root, or `npm:<specifier>` for a
89
- * package. Never an absolute path: that would put the server's filesystem
90
- * layout into every page's HTML.
91
- */
92
- export declare const MODULE_SPECIFIER_PREFIX = "stx-module:";
93
35
  export declare function registryIdForPath(projectRoot: string, resolved: string): string;
94
36
  /**
95
37
  * Put the `stx-module:` specifier back on imports Bun printed with the one the
@@ -135,53 +77,63 @@ export declare function rewriteRegistryImports(code: string, reads: string[]): s
135
77
  */
136
78
  export declare function queueClientBundleBuild<T>(task: () => Promise<T>): Promise<T>;
137
79
  export declare function bundleClientScript(code: string, filePath: string, options?: {
138
- projectRoot?: string;
139
- minify?: boolean;
140
- cacheDir?: string;
141
- /**
142
- * Receives the files this bundle was built from, for a caller that needs
143
- * them for its own cache key.
144
- *
145
- * `clientBundleDependencies()` answers the same question from a map keyed
146
- * by host file path, which is only correct while calls for one host are
147
- * serialized. They are not: a component with two bundling `<script client>`
148
- * blocks builds them under one `Promise.all`, so the second call's
149
- * `recordBundleInputs` can land between the first's await and its read, and
150
- * the first caller gets the second's file list. That map is a
151
- * process-global keyed on the host, so it cannot distinguish them; this
152
- * hands each caller its own answer.
153
- */
154
- collectInputs?: string[];
155
- /**
156
- * Serve the script's own imports from the page registry instead of
157
- * inlining them (#1957). Default true; the registry's own build turns it
158
- * off, since that bundle is where the modules are actually inlined.
159
- */
160
- externalizeUserModules?: boolean;
161
- /**
162
- * Re-expose only these names outside the bundle's closure. By default every
163
- * top-level binding of the script comes back, imports included, because a
164
- * page's template reads whatever its script declared. A composable is
165
- * concatenated with the others into one scope instead, and publishes only
166
- * its exports: re-declaring a name it merely imported collided with the
167
- * composable that owns it (`var X` here, `const X` there, a SyntaxError
168
- * that took every composable on the page down).
169
- */
170
- expose?: readonly string[];
171
- /**
172
- * Throw on a failed build instead of returning the script unbundled.
173
- *
174
- * The unbundled fallback keeps a dev server usable for a page's own
175
- * script. It is no use to a caller whose source is nothing BUT imports -
176
- * the page registry's entry is `import * as m from '...'` lines that only
177
- * mean something once bundled, so falling back shipped them inside an IIFE,
178
- * a SyntaxError, and the build error never reached the browser.
179
- */
180
- throwOnFailure?: boolean;
181
- }): Promise<string>;
80
+ projectRoot?: string
81
+ minify?: boolean
82
+ cacheDir?: string
83
+
84
+ collectInputs?: string[]
85
+
86
+ externalizeUserModules?: boolean
87
+
88
+ expose?: readonly string[]
89
+
90
+ throwOnFailure?: boolean
91
+ }): Promise<string>;
182
92
  /**
183
93
  * The name one build's temp entry and output directory go by: the script's
184
94
  * hash, this process and a count, so no other build — here or in another dev
185
95
  * server on the same checkout — shares them. See where they are made.
186
96
  */
187
97
  export declare function tempBuildName(hash: string): string;
98
+ /**
99
+ * Specifier prefix for an import the PAGE serves rather than the bundle
100
+ * inlines (stacksjs/stx#1957).
101
+ *
102
+ * Every component's `<script client>` used to be bundled with its imports
103
+ * inlined, one Bun.build per script. Two components importing one module each
104
+ * carried their own copy of it, so module state -- a cache, a registry, an
105
+ * in-flight promise -- existed once per component instead of once per page,
106
+ * and the page shipped the same code several times. A real page made five
107
+ * `GET /api/me` calls on load because its auth module had five copies.
108
+ *
109
+ * A component's direct imports are now externalised to `stx-module:<id>` and
110
+ * rewritten into reads of `globalThis.__stxModules`, which one page-level
111
+ * bundle populates (see client-module-registry.ts): each imported module is
112
+ * bundled once and evaluated once per page.
113
+ *
114
+ * The id is the path relative to the project root, or `npm:<specifier>` for a
115
+ * package. Never an absolute path: that would put the server's filesystem
116
+ * layout into every page's HTML.
117
+ */
118
+ export declare const MODULE_SPECIFIER_PREFIX: 'stx-module:';
119
+ /**
120
+ * Client-script bundle failures recorded during the current process.
121
+ *
122
+ * When a `<script client>` block fails to bundle, the bundler falls back to
123
+ * shipping the ORIGINAL, unbundled source so the page still renders. That is a
124
+ * reasonable dev-server behaviour and a terrible build behaviour: imports never
125
+ * resolve, bindings silently do nothing, and `stx build` still exited 0, so CI
126
+ * published a broken page as a success.
127
+ *
128
+ * Nothing was counting these. `ssg.failedCount` only ever saw render-time throws,
129
+ * never a bundle failure, because the fallback swallowed it and returned a
130
+ * string. The registry gives the build a way to ask, without the bundler having
131
+ * to know whether it is running under a dev server or a build. See #1884.
132
+ */
133
+ export declare interface BundleFailure {
134
+ filePath: string
135
+ message: string
136
+ details?: BuildFailureDetail[]
137
+ }
138
+ /** What to do when a client script will not bundle. */
139
+ export type BundlerFallbackMode = 'warn' | 'error';