@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
package/dist/assets.d.ts CHANGED
@@ -1,21 +1,19 @@
1
1
  import type { StxOptions } from './types';
2
- export declare const markdownCache: Map<string, {
3
- content: string;
4
- data: Record<string, any>;
5
- updatedAt: number;
6
- }>;
7
2
  /**
8
3
  * Read and parse a markdown file with frontmatter
9
4
  * @param filePath Path to the markdown file
10
5
  * @param options stx options
11
6
  * @returns Object containing parsed content and frontmatter data
12
7
  */
13
- export declare function readMarkdownFile(filePath: string, options?: StxOptions): Promise<{
14
- content: string;
15
- data: Record<string, any>;
16
- }>;
8
+ export declare function readMarkdownFile(filePath: string, options?: StxOptions): Promise<{ content: string, data: Record<string, any> }>;
17
9
  /**
18
10
  * Process @markdown-file directive
19
11
  * This directive includes markdown files in templates
20
12
  */
21
13
  export declare function processMarkdownFileDirectives(template: string, context: Record<string, any>, filePath?: string, options?: StxOptions): Promise<string>;
14
+ // Define a cache for markdown files to avoid repeated file reads
15
+ export declare const markdownCache: Map<string, {
16
+ content: string
17
+ data: Record<string, any>
18
+ updatedAt: number
19
+ }>;
@@ -1,3 +1,30 @@
1
+ /**
2
+ * Process @async directives in templates.
3
+ *
4
+ * Syntax:
5
+ * @async(component: 'ComponentName', timeout: 5000)
6
+ * <loading content>
7
+ * @error
8
+ * <error content>
9
+ * @endasync
10
+ */
11
+ export declare function processAsyncDirectives(template: string, _context?: Record<string, unknown>, _filePath?: string): string;
12
+ /**
13
+ * Define an async component.
14
+ */
15
+ export declare function defineAsyncComponent(options: DefineAsyncComponentOptions | (() => Promise<{ default: string } | string>)): AsyncComponentDefinition;
16
+ /**
17
+ * Check if a value is an async component definition.
18
+ */
19
+ export declare function isAsyncComponent(value: unknown): value is AsyncComponentDefinition;
20
+ /**
21
+ * Generate CSS for async component styling.
22
+ */
23
+ export declare function generateAsyncComponentCSS(): string;
24
+ /**
25
+ * Generate client-side runtime for async components.
26
+ */
27
+ export declare function generateAsyncComponentRuntime(): string;
1
28
  /**
2
29
  * STX Async Components
3
30
  *
@@ -25,45 +52,25 @@
25
52
  * </AsyncComponent>
26
53
  * ```
27
54
  */
28
- export interface AsyncComponentOptions {
29
- /** Component path or name to load */
30
- component: string;
31
- /** Timeout in milliseconds (default: 30000) */
32
- timeout?: number;
33
- /** Delay before showing loading state in ms (default: 200) */
34
- delay?: number;
35
- /** Whether to suspend parent Suspense boundary */
36
- suspensible?: boolean;
37
- /** Custom loading component */
38
- loadingComponent?: string;
39
- /** Custom error component */
40
- errorComponent?: string;
41
- /** Retry attempts on failure (default: 0) */
42
- retries?: number;
43
- /** Props to pass to the loaded component */
44
- props?: Record<string, unknown>;
55
+ // =============================================================================
56
+ // Types
57
+ // =============================================================================
58
+ export declare interface AsyncComponentOptions {
59
+ component: string
60
+ timeout?: number
61
+ delay?: number
62
+ suspensible?: boolean
63
+ loadingComponent?: string
64
+ errorComponent?: string
65
+ retries?: number
66
+ props?: Record<string, unknown>
45
67
  }
46
- export interface AsyncComponentState {
47
- /** Current loading state */
48
- status: 'pending' | 'loading' | 'resolved' | 'rejected';
49
- /** The loaded component content */
50
- component: string | null;
51
- /** Error if loading failed */
52
- error: Error | null;
53
- /** Number of retry attempts made */
54
- attempts: number;
68
+ export declare interface AsyncComponentState {
69
+ status: 'pending' | 'loading' | 'resolved' | 'rejected'
70
+ component: string | null
71
+ error: Error | null
72
+ attempts: number
55
73
  }
56
- /**
57
- * Process @async directives in templates.
58
- *
59
- * Syntax:
60
- * @async(component: 'ComponentName', timeout: 5000)
61
- * <loading content>
62
- * @error
63
- * <error content>
64
- * @endasync
65
- */
66
- export declare function processAsyncDirectives(template: string, _context?: Record<string, unknown>, _filePath?: string): string;
67
74
  /**
68
75
  * Define an async component for programmatic use.
69
76
  *
@@ -78,46 +85,17 @@ export declare function processAsyncDirectives(template: string, _context?: Reco
78
85
  * })
79
86
  * ```
80
87
  */
81
- export interface DefineAsyncComponentOptions {
82
- /** Function that returns a Promise resolving to the component */
83
- loader: () => Promise<{
84
- default: string;
85
- } | string>;
86
- /** Component to show while loading */
87
- loadingComponent?: string;
88
- /** Component to show on error */
89
- errorComponent?: string;
90
- /** Delay before showing loading component (ms) */
91
- delay?: number;
92
- /** Timeout before showing error (ms) */
93
- timeout?: number;
94
- /** Whether to suspend parent Suspense */
95
- suspensible?: boolean;
96
- /** Called when loading starts */
97
- onLoadStart?: () => void;
98
- /** Called when component is loaded */
99
- onLoadEnd?: () => void;
100
- /** Called on error */
101
- onError?: (error: Error, retry: () => void, fail: () => void, attempts: number) => void;
88
+ export declare interface DefineAsyncComponentOptions {
89
+ loader: () => Promise<{ default: string } | string>
90
+ loadingComponent?: string
91
+ errorComponent?: string
92
+ delay?: number
93
+ timeout?: number
94
+ suspensible?: boolean
95
+ onLoadStart?: () => void
96
+ onLoadEnd?: () => void
97
+ onError?: (error: Error, retry: () => void, fail: () => void, attempts: number) => void
102
98
  }
103
- /**
104
- * Define an async component.
105
- */
106
- export declare function defineAsyncComponent(options: DefineAsyncComponentOptions | (() => Promise<{
107
- default: string;
108
- } | string>)): AsyncComponentDefinition;
109
- export interface AsyncComponentDefinition extends DefineAsyncComponentOptions {
110
- __asyncComponent: true;
99
+ export declare interface AsyncComponentDefinition extends DefineAsyncComponentOptions {
100
+ __asyncComponent: true
111
101
  }
112
- /**
113
- * Check if a value is an async component definition.
114
- */
115
- export declare function isAsyncComponent(value: unknown): value is AsyncComponentDefinition;
116
- /**
117
- * Generate CSS for async component styling.
118
- */
119
- export declare function generateAsyncComponentCSS(): string;
120
- /**
121
- * Generate client-side runtime for async components.
122
- */
123
- export declare function generateAsyncComponentRuntime(): string;
package/dist/auth.d.ts CHANGED
@@ -1,6 +1,3 @@
1
- /**
2
- * Module for handling authentication and authorization in templates
3
- */
4
1
  /**
5
2
  * Safely evaluates an auth expression within the given context
6
3
  * Similar to evaluateExpression but specialized for auth conditionals
@@ -1,3 +1,5 @@
1
+ /** The shipped ambient declarations for the same browser auto-import manifest. */
2
+ export declare function generateBrowserAutoImportsDts(): string;
1
3
  /**
2
4
  * The names stx auto-imports into a client script from `@stacksjs/browser`.
3
5
  *
@@ -10,5 +12,3 @@
10
12
  * wrong.
11
13
  */
12
14
  export declare const BROWSER_CORE_IMPORTS: readonly string[];
13
- /** The shipped ambient declarations for the same browser auto-import manifest. */
14
- export declare function generateBrowserAutoImportsDts(): string;
@@ -1,28 +1,3 @@
1
- /**
2
- * Lift inline blobs that repeat across pages, whatever they are.
3
- *
4
- * `build-externalize` handles the three blobs stx knows by name — the signals
5
- * runtime, the router, and the generated stylesheet. Everything else it emits
6
- * inline stays inline, and on a real multi-page site that is where the bytes
7
- * actually are: the ts-cloud dashboard ships 54 pages at 12.5MB, of which
8
- * 10.3MB is byte-identical `<script data-stx-scoped>` and unattributed
9
- * `<style>` blocks repeated page after page. None of it is cacheable across a
10
- * navigation, and it is 4x the size of the three named blobs combined.
11
- *
12
- * The rule here needs no allowlist: a blob that appears byte-for-byte on two
13
- * or more pages is shared by construction, so hoisting it into one
14
- * content-addressed file is a pure win — every page that referenced it now
15
- * downloads it once for the whole site instead of once per page. A blob that
16
- * appears on exactly one page is left alone, because turning it into a second
17
- * request would make that page slower, not smaller.
18
- *
19
- * Requires the whole output directory, which is why it is a separate pass from
20
- * the pure per-document `externalizeHtml`: "does this appear elsewhere" is not
21
- * a question one document can answer, and SSR (which shares that function) has
22
- * no elsewhere to look at.
23
- *
24
- * @module build-externalize-repeated
25
- */
26
1
  import { type ExternalizeResult } from './build-externalize';
27
2
  /**
28
3
  * Hoist every inline script/style body that appears on more than one page.
@@ -1,56 +1,3 @@
1
- /**
2
- * Lift shared inline blobs out of built HTML into content-hashed assets.
3
- *
4
- * The static build inlines the whole signals runtime and the whole generated
5
- * stylesheet into every page. On a 35-page site that is ~118KB of
6
- * byte-identical runtime per page and a separate copy of the reset in each one,
7
- * none of it cacheable across a navigation, and `find dist -name '*.js'`
8
- * returns nothing at all (stacksjs/stx#1865, #1878).
9
- *
10
- * Done as a post-pass over the emitted HTML rather than by threading
11
- * `buildMode` through the renderer, deliberately. The existing `compile` branch
12
- * emits `/__stx/runtime.__STX_HASH__.js`, a placeholder only the production
13
- * builder knows how to rewrite, and setting that mode also suppresses the
14
- * document shell — so reusing it on the SSG path produces pages that reference
15
- * a 404 and lose their `<html>` wrapper. A post-pass needs neither.
16
- *
17
- * Content-addressed, so identical blobs across pages collapse to one file: the
18
- * runtime is byte-identical everywhere and becomes a single asset, while
19
- * per-page CSS dedupes only where pages genuinely share a stylesheet.
20
- *
21
- * The rewrite itself is `externalizeHtml`, which touches no filesystem. SSR has
22
- * the same problem in a worse form — a static build inlines the runtime once
23
- * per page, a server inlines it once per *request* — and it cannot use a
24
- * post-pass over a directory because there are no files. Sharing the pure
25
- * function means the two paths cannot drift into rewriting HTML differently.
26
- *
27
- * @module build-externalize
28
- */
29
- /** Where externalized assets are written, relative to the output directory. */
30
- export declare const EXTERNALIZED_ASSET_DIR = "_stx";
31
- export interface ExternalizeResult {
32
- /** HTML files rewritten. */
33
- pages: number;
34
- /** Distinct asset files written. */
35
- assets: number;
36
- /** Bytes removed from HTML (before any compression). */
37
- bytesInlined: number;
38
- }
39
- /** A blob lifted out of the HTML, ready to be written or served. */
40
- export interface ExternalizedAsset {
41
- /** Content-addressed filename, e.g. `runtime.1a2b3c4d.js`. */
42
- filename: string;
43
- contents: string;
44
- /** MIME type, so a server can respond without re-deriving it from the name. */
45
- contentType: string;
46
- }
47
- export interface ExternalizeHtmlResult {
48
- html: string;
49
- /** Distinct assets this page referenced. Deduped within the page. */
50
- assets: ExternalizedAsset[];
51
- /** Bytes removed from the HTML, before any compression. */
52
- bytesInlined: number;
53
- }
54
1
  /**
55
2
  * Lift the shared blobs out of one HTML document.
56
3
  *
@@ -71,3 +18,21 @@ export declare function externalizeHtml(html: string, basePath?: string): Extern
71
18
  * inline body to match, so a second pass is a no-op.
72
19
  */
73
20
  export declare function externalizeSharedAssets(outDir: string): ExternalizeResult;
21
+ /** Where externalized assets are written, relative to the output directory. */
22
+ export declare const EXTERNALIZED_ASSET_DIR: '_stx';
23
+ export declare interface ExternalizeResult {
24
+ pages: number
25
+ assets: number
26
+ bytesInlined: number
27
+ }
28
+ /** A blob lifted out of the HTML, ready to be written or served. */
29
+ export declare interface ExternalizedAsset {
30
+ filename: string
31
+ contents: string
32
+ contentType: string
33
+ }
34
+ export declare interface ExternalizeHtmlResult {
35
+ html: string
36
+ assets: ExternalizedAsset[]
37
+ bytesInlined: number
38
+ }
@@ -1,3 +1,32 @@
1
+ /**
2
+ * The current process's build id.
3
+ *
4
+ * Stable for the lifetime of the process, which is the unit that matters: a
5
+ * `bun --watch` restart produces a new process and therefore a new id, while a
6
+ * production build stamps every page it renders with one value. Every copy of
7
+ * this module loaded into the process returns the same id.
8
+ *
9
+ * `STX_BUILD_ID` overrides it, for deployments that render across several
10
+ * processes and need them to agree.
11
+ */
12
+ export declare function getBuildId(): string;
13
+ /** @internal test-only — force the id, or with `null` restore generation. */
14
+ export declare function __setBuildIdForTest(id: string | null): void;
15
+ /**
16
+ * Add `<meta name="stx-build">` to `<head>` if it isn't already there.
17
+ *
18
+ * Idempotent, and a no-op for output with no `<head>` — SPA fragments carry the
19
+ * id in a response header instead, since they have nowhere to put a meta.
20
+ */
21
+ export declare function injectBuildId(html: string, buildId?: string): string;
22
+ /**
23
+ * The same decision as `injectBuildId`, without the splice (stacksjs/stx#1945).
24
+ *
25
+ * Returns what belongs immediately after the `<head>` open tag, or null when
26
+ * the id is already stamped or the document has no head -- an SPA fragment
27
+ * carries it in a response header instead, having nowhere to put a meta.
28
+ */
29
+ export declare function buildIdFragment(html: string, buildId?: string): string | null;
1
30
  /**
2
31
  * Per-process build identity, used to detect runtime/fragment skew
3
32
  * (stacksjs/stx#1772).
@@ -24,35 +53,18 @@
24
53
  * @module build-id
25
54
  */
26
55
  /** `<meta name="stx-build">` on every rendered page. */
27
- export declare const BUILD_ID_META = "stx-build";
56
+ export declare const BUILD_ID_META: 'stx-build';
28
57
  /** Response header carrying the id that rendered an SPA fragment. */
29
- export declare const BUILD_ID_HEADER = "X-STX-Build";
58
+ export declare const BUILD_ID_HEADER: 'X-STX-Build';
30
59
  /**
31
- * The current process's build id.
32
- *
33
- * Stable for the lifetime of the process, which is the unit that matters: a
34
- * `bun --watch` restart produces a new process and therefore a new id, while a
35
- * production build stamps every page it renders with one value. Every copy of
36
- * this module loaded into the process returns the same id.
60
+ * Where the id lives: one slot per process, not one per module instance.
37
61
  *
38
- * `STX_BUILD_ID` overrides it, for deployments that render across several
39
- * processes and need them to agree.
62
+ * An app can load stx twice. chrisbreuer.me had @stacksjs/stx 0.2.302 at the
63
+ * top level, rendering pages and stamping the meta, and 0.2.307 nested under
64
+ * bun-plugin-stx, answering SPA fragments with the header. A module-level
65
+ * variable gave each copy its own random id, so the router saw every fragment
66
+ * as coming from another build and turned every navigation into a full page
67
+ * load. A registered symbol on globalThis is shared by every copy.
40
68
  */
41
- export declare function getBuildId(): string;
42
- /** @internal test-only — force the id, or with `null` restore generation. */
43
- export declare function __setBuildIdForTest(id: string | null): void;
44
- /**
45
- * Add `<meta name="stx-build">` to `<head>` if it isn't already there.
46
- *
47
- * Idempotent, and a no-op for output with no `<head>` — SPA fragments carry the
48
- * id in a response header instead, since they have nowhere to put a meta.
49
- */
50
- export declare function injectBuildId(html: string, buildId?: string): string;
51
- /**
52
- * The same decision as `injectBuildId`, without the splice (stacksjs/stx#1945).
53
- *
54
- * Returns what belongs immediately after the `<head>` open tag, or null when
55
- * the id is already stamped or the document has no head -- an SPA fragment
56
- * carries it in a response header instead, having nowhere to put a meta.
57
- */
58
- export declare function buildIdFragment(html: string, buildId?: string): string | null;
69
+ declare const BUILD_ID_SLOT: symbol;
70
+ declare type BuildIdHolder = { [BUILD_ID_SLOT]?: string }
@@ -1,40 +1,3 @@
1
- /**
2
- * Make a Bun build failure say where it happened (stacksjs/stx#1810).
3
- *
4
- * A single unparseable view produced `BuildMessage: Unexpected ===` and nothing
5
- * else — no path, no line — leaving the reporter to binary-search the scanned
6
- * views by hand.
7
- *
8
- * The location was never missing. Bun computes it and puts it on
9
- * `BuildMessage.position`; it is `.message` and `.toString()` that omit it. And
10
- * because `BuildMessage` is not an `instanceof Error` and carries no `.stack`,
11
- * the usual `error instanceof Error ? error.message : String(error)` idiom —
12
- * which this codebase uses in a dozen places — reduces it to exactly that bare
13
- * string.
14
- *
15
- * Two further wrinkles this handles:
16
- *
17
- * - `Bun.build()` does not throw a BuildMessage. It throws an AggregateError
18
- * whose `.errors` holds them, so the useful detail is one level down.
19
- * - `Bun.Transpiler.transformSync()` reports `position.file` as its synthetic
20
- * entry name, never the real path. The caller knows the real one, so it is
21
- * threaded in rather than trusted from the message.
22
- */
23
- /**
24
- * One failure, with its position kept separate rather than baked into a string.
25
- *
26
- * A terminal wants `path:line:col: message`; a dev-server overlay wants to draw
27
- * a code frame and put a caret under the column. Both are rendered from this,
28
- * so the two cannot drift into disagreeing about where the error is (#1884).
29
- */
30
- export interface BuildFailureDetail {
31
- file?: string;
32
- line?: number;
33
- column?: number;
34
- message: string;
35
- /** The offending source line, when Bun reported one. */
36
- lineText?: string;
37
- }
38
1
  /**
39
2
  * Pull every failure out of whatever was thrown, with positions intact.
40
3
  *
@@ -64,13 +27,6 @@ export declare function formatBuildFailure(error: unknown, sourcePath?: string):
64
27
  * caller renders as a message with no frame.
65
28
  */
66
29
  export declare function locateFailureLine(source: string, lineText?: string): number | undefined;
67
- /** One line of a code frame. */
68
- export interface CodeFrameLine {
69
- number: number;
70
- text: string;
71
- /** The line the error is on. */
72
- isError: boolean;
73
- }
74
30
  /**
75
31
  * The lines around a failure, for an overlay to draw.
76
32
  *
@@ -79,3 +35,23 @@ export interface CodeFrameLine {
79
35
  * the file. Empty when there is no line to centre on.
80
36
  */
81
37
  export declare function buildCodeFrame(source: string, line?: number, context?: number): CodeFrameLine[];
38
+ /**
39
+ * One failure, with its position kept separate rather than baked into a string.
40
+ *
41
+ * A terminal wants `path:line:col: message`; a dev-server overlay wants to draw
42
+ * a code frame and put a caret under the column. Both are rendered from this,
43
+ * so the two cannot drift into disagreeing about where the error is (#1884).
44
+ */
45
+ export declare interface BuildFailureDetail {
46
+ file?: string
47
+ line?: number
48
+ column?: number
49
+ message: string
50
+ lineText?: string
51
+ }
52
+ /** One line of a code frame. */
53
+ export declare interface CodeFrameLine {
54
+ number: number
55
+ text: string
56
+ isError: boolean
57
+ }
@@ -1,17 +1,3 @@
1
- /**
2
- * Attribute pass-through for builtin components.
3
- *
4
- * `<StxLink>`, `<StxImage>` and `<SafeImage>` all consume the props they know
5
- * about and forward whatever is left onto the element they render, so an author
6
- * can write `<StxLink to="/x" aria-label="Shop" data-testid="nav">` and have the
7
- * last two land on the `<a>`. Each of them grew its own copy of that loop, which
8
- * meant each of them independently forwarded the *camelized* prop key — emitting
9
- * `ariaLabel="Shop"`, an attribute no browser knows.
10
- *
11
- * One implementation, so the naming round-trip is right in one place.
12
- *
13
- * @module builtins/attrs
14
- */
15
1
  import type { ResolvedProps } from '../component-registry';
16
2
  /** Whether an attribute should be visible on a component's DOM root. */
17
3
  export declare function isFallthroughAttribute(name: string): boolean;
@@ -1,24 +1,5 @@
1
- /**
2
- * StxDrawer Builtin Component
3
- *
4
- * Renders a hidden slide-in panel with slot content. Opened/closed via
5
- * the runtime `drawer.open(id)` / `drawer.close(id)` / `drawer.toggle(id)` globals.
6
- *
7
- * Usage:
8
- * <StxDrawer id="settings" side="right" size="md">
9
- * <h2>Settings</h2>
10
- * <p>Drawer content here</p>
11
- * </StxDrawer>
12
- *
13
- * Props:
14
- * - id (required) — unique drawer identifier
15
- * - side — 'left' | 'right' (default: 'right')
16
- * - size — 'sm' | 'md' | 'lg' | 'xl' (default: 'md')
17
- * - closeOnBackdrop — whether clicking backdrop closes drawer (default: true)
18
- * - closeOnEscape — whether Escape key closes drawer (default: true)
19
- * - overlay — whether to show backdrop overlay (default: true)
20
- *
21
- * @module builtins/drawer
22
- */
23
1
  import type { BuiltinComponentDef } from '../component-registry';
2
+ declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
3
+ /** @defaultValue `{ sm: '16rem', md: '24rem', lg: '32rem', xl: '40rem' }` */
4
+ declare const SIZE_WIDTHS: Record<string, string>;
24
5
  export declare const StxDrawerBuiltin: BuiltinComponentDef;
@@ -1,18 +1,3 @@
1
- /**
2
- * Icon Builtin Component
3
- *
4
- * Renders an inline SVG from the Iconify icon library at template processing
5
- * time. No client-side runtime needed — the SVG is baked into the HTML.
6
- *
7
- * Usage:
8
- * <Icon name="house" />
9
- * <Icon name="lucide:house" size="20" class="text-gray-500" />
10
- * <Icon name="chevron-right" size="16" color="red" />
11
- *
12
- * Default collection: lucide. Override with prefix: <Icon name="heroicons:home" />
13
- *
14
- * @module builtins/icon
15
- */
16
1
  import type { BuiltinComponentDef } from '../component-registry';
17
2
  /**
18
3
  * Resolve the on-disk path of an icon collection JSON.
@@ -29,7 +14,18 @@ import type { BuiltinComponentDef } from '../component-registry';
29
14
  * node_modules in apps that vendor there).
30
15
  */
31
16
  export declare function resolveCollectionPath(prefix: string): string | null;
32
- export declare const IconBuiltin: BuiltinComponentDef;
17
+ /**
18
+ * Load an icon collection synchronously. Used inside `render()` so the
19
+ * first hit for a collection doesn't return a placeholder comment that
20
+ * the user then sees as a missing icon — the JSON is small enough
21
+ * (~550KB for lucide, parses in <10ms) that a blocking read on cache
22
+ * miss is the right trade-off for correct SSR output.
23
+ */
24
+ declare function loadCollectionSync(prefix: string): IconCollection | null;
25
+ /**
26
+ * Resolve a prop value from any binding category.
27
+ */
28
+ declare function resolveProp(props: ResolvedProps, key: string): string | undefined;
33
29
  /**
34
30
  * Pre-load icon collections so they're available synchronously during render.
35
31
  * Call this before template processing starts.
@@ -40,6 +36,8 @@ export declare const IconBuiltin: BuiltinComponentDef;
40
36
  * asks for one that is missing. Pass `speculative: false` when the caller knows
41
37
  * the collection is required.
42
38
  */
43
- export declare function preloadIconCollection(prefix?: string, options?: {
44
- speculative?: boolean;
45
- }): Promise<void>;
39
+ export declare function preloadIconCollection(prefix?: string, options?: { speculative?: boolean }): Promise<void>;
40
+ // Cache loaded icon collections to avoid re-reading JSON files
41
+ declare const collectionCache: Map<string, IconCollection>;
42
+ export declare const IconBuiltin: BuiltinComponentDef;
43
+ declare type IconCollection = Record<string, { body: string, width?: number, height?: number }>;
@@ -1,11 +1,3 @@
1
- /**
2
- * - `none`: the format or header rules transparency out entirely (JPEG, a PNG
3
- * with no alpha channel and no `tRNS`, a WebP that declares no alpha).
4
- * - `possible`: the header declares an alpha channel. Every pixel may still be
5
- * opaque; only a decode can say.
6
- * - `unknown`: the header does not settle it (AVIF, anything unrecognised).
7
- */
8
- export type SourceAlpha = 'none' | 'possible' | 'unknown';
9
1
  export declare function readAt(fd: number, position: number, length: number): Buffer;
10
2
  /**
11
3
  * Whether a WebP header declares an alpha channel.
@@ -24,3 +16,11 @@ export declare function webpHeaderHasAlpha(header: Uint8Array): boolean;
24
16
  * stays `unknown`. JPEG cannot carry alpha at all.
25
17
  */
26
18
  export declare function sourceAlpha(file: string): SourceAlpha;
19
+ /**
20
+ * - `none`: the format or header rules transparency out entirely (JPEG, a PNG
21
+ * with no alpha channel and no `tRNS`, a WebP that declares no alpha).
22
+ * - `possible`: the header declares an alpha channel. Every pixel may still be
23
+ * opaque; only a decode can say.
24
+ * - `unknown`: the header does not settle it (AVIF, anything unrecognised).
25
+ */
26
+ export type SourceAlpha = 'none' | 'possible' | 'unknown';