@stacksjs/stx 0.2.572 → 0.2.574

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (499) hide show
  1. package/dist/a11y.d.ts +51 -111
  2. package/dist/animation.d.ts +131 -74
  3. package/dist/api-client.d.ts +11 -21
  4. package/dist/api-handler.d.ts +4 -4
  5. package/dist/appearance-bootstrap.d.ts +16 -77
  6. package/dist/application-layers.d.ts +11 -20
  7. package/dist/asset-roots.d.ts +7 -27
  8. package/dist/assets.d.ts +7 -9
  9. package/dist/async-components.d.ts +56 -78
  10. package/dist/auth.d.ts +0 -3
  11. package/dist/browser-core-imports.d.ts +2 -2
  12. package/dist/build-externalize-repeated.d.ts +0 -25
  13. package/dist/build-externalize.d.ts +18 -53
  14. package/dist/build-id.d.ts +40 -28
  15. package/dist/build-message.d.ts +20 -44
  16. package/dist/builtins/attrs.d.ts +0 -14
  17. package/dist/builtins/drawer.d.ts +3 -22
  18. package/dist/builtins/icon.d.ts +17 -19
  19. package/dist/builtins/image-alpha.d.ts +8 -8
  20. package/dist/builtins/image-delivery.d.ts +38 -40
  21. package/dist/builtins/image-placeholder.d.ts +12 -50
  22. package/dist/builtins/image-warmup-worker.d.ts +1 -1
  23. package/dist/builtins/image-worker.d.ts +6 -32
  24. package/dist/builtins/index.d.ts +16 -6
  25. package/dist/builtins/modal.d.ts +13 -23
  26. package/dist/builtins/safe-image.d.ts +2 -42
  27. package/dist/builtins/stx-image.d.ts +44 -24
  28. package/dist/builtins/stx-link.d.ts +5 -8
  29. package/dist/builtins/stx-loading-indicator.d.ts +11 -10
  30. package/dist/builtins/suspense.d.ts +6 -27
  31. package/dist/builtins/toast.d.ts +15 -16
  32. package/dist/builtins/transition-group.d.ts +1 -25
  33. package/dist/caching.d.ts +24 -21
  34. package/dist/{chunk-a6jq7hex.js → chunk-06hx32h4.js} +3 -3
  35. package/dist/{chunk-cyg9w31a.js → chunk-0gt7e1ns.js} +1 -1
  36. package/dist/{chunk-15g5sc0p.js → chunk-0ppzstqj.js} +2 -2
  37. package/dist/{chunk-qcymqscj.js → chunk-0px2ab3m.js} +9 -9
  38. package/dist/chunk-0q5s55km.js +2 -0
  39. package/dist/{chunk-7t3ykgsm.js → chunk-1c8sdf9a.js} +3 -3
  40. package/dist/chunk-1m5pagp3.js +2 -0
  41. package/dist/{chunk-mzqyv7s5.js → chunk-1n9bxdnh.js} +3 -3
  42. package/dist/{chunk-58tz7tmf.js → chunk-1swmxkdt.js} +2 -2
  43. package/dist/{chunk-4easd8da.js → chunk-1x2x3xgc.js} +4 -4
  44. package/dist/chunk-27ja2rpd.js +2 -0
  45. package/dist/chunk-2b0p7am3.js +2 -0
  46. package/dist/{chunk-qj4j547f.js → chunk-30acme5g.js} +2 -2
  47. package/dist/{chunk-1n64749x.js → chunk-32pxa1r0.js} +1 -1
  48. package/dist/{chunk-g66m3g2r.js → chunk-37d52q0d.js} +1 -1
  49. package/dist/{chunk-sfwprq8q.js → chunk-3dr757vb.js} +9 -9
  50. package/dist/chunk-3k6q1481.js +2 -0
  51. package/dist/{chunk-2z0trbbm.js → chunk-3kc7af8c.js} +2 -2
  52. package/dist/chunk-3pr388w5.js +2 -0
  53. package/dist/chunk-42h0kvng.js +2 -0
  54. package/dist/chunk-4eff1v2p.js +2 -0
  55. package/dist/{chunk-gzgc8zk5.js → chunk-4k6cb5fg.js} +5 -5
  56. package/dist/{chunk-s12b57m9.js → chunk-4xvbc0mb.js} +2 -2
  57. package/dist/{chunk-83fdt4yj.js → chunk-501h1mer.js} +4 -4
  58. package/dist/{chunk-tv784gv0.js → chunk-550q827h.js} +2 -2
  59. package/dist/chunk-5n2v9g2c.js +2 -0
  60. package/dist/{chunk-q79kmad5.js → chunk-5xwmkxkk.js} +1 -1
  61. package/dist/chunk-68ygpbta.js +2 -0
  62. package/dist/{chunk-0bt0fbs1.js → chunk-69k5t6pj.js} +52 -52
  63. package/dist/{chunk-232jswfm.js → chunk-6c2y9h5h.js} +1 -1
  64. package/dist/chunk-6gjfres0.js +2 -0
  65. package/dist/chunk-6z57saf5.js +2 -0
  66. package/dist/chunk-71zwgxws.js +2 -0
  67. package/dist/{chunk-b9r88ysg.js → chunk-76437eb4.js} +2 -2
  68. package/dist/{chunk-beqkrwt1.js → chunk-7a0ewpz0.js} +2 -2
  69. package/dist/chunk-7debnvz9.js +2 -0
  70. package/dist/{chunk-jwvzvapp.js → chunk-7gxn7mvd.js} +2 -2
  71. package/dist/{chunk-vp31ff54.js → chunk-7hr63cp5.js} +2 -2
  72. package/dist/{chunk-5t1whxxt.js → chunk-825m59jr.js} +5 -5
  73. package/dist/{chunk-74xwzxwz.js → chunk-8efe5vpm.js} +2 -2
  74. package/dist/{chunk-jqefcghh.js → chunk-8hp6722y.js} +5 -5
  75. package/dist/{chunk-kgj852hx.js → chunk-9yht5n7g.js} +2 -2
  76. package/dist/{chunk-kzjrgh0b.js → chunk-a3w3jc0t.js} +6 -6
  77. package/dist/chunk-a77gbp9x.js +2 -0
  78. package/dist/chunk-ampr3fpv.js +2 -0
  79. package/dist/{chunk-2ads8rw5.js → chunk-b10n7cpe.js} +2 -2
  80. package/dist/{chunk-0q6n3by0.js → chunk-bb5a8adb.js} +3 -3
  81. package/dist/chunk-bgbz0wzq.js +2 -0
  82. package/dist/chunk-bgr7fqhs.js +2 -0
  83. package/dist/chunk-bjfrwcfh.js +2 -0
  84. package/dist/{chunk-9k7bq97t.js → chunk-byhsfnkc.js} +1 -1
  85. package/dist/{chunk-zyk12484.js → chunk-c0ewddb3.js} +2 -2
  86. package/dist/{chunk-b2q8bk8p.js → chunk-c6jyp7ss.js} +2 -2
  87. package/dist/chunk-cdt5pg28.js +2 -0
  88. package/dist/chunk-cfh798k7.js +2 -0
  89. package/dist/{chunk-pnag11c4.js → chunk-cp5903cg.js} +2 -2
  90. package/dist/{chunk-4bgfpkwx.js → chunk-crj0yqc6.js} +1 -1
  91. package/dist/chunk-dax3zkmm.js +2 -0
  92. package/dist/chunk-dn676tdp.js +2 -0
  93. package/dist/chunk-dtbj816p.js +2 -0
  94. package/dist/chunk-e23cg45k.js +2 -0
  95. package/dist/{chunk-qzbzn1yf.js → chunk-e27njk86.js} +12 -12
  96. package/dist/{chunk-vr36s2en.js → chunk-e40qpeg5.js} +2 -2
  97. package/dist/{chunk-q83w8edy.js → chunk-e7pjsrfc.js} +2 -2
  98. package/dist/chunk-ecwpsjpd.js +2 -0
  99. package/dist/{chunk-pqcvh9pp.js → chunk-f0mbj8w9.js} +1 -1
  100. package/dist/chunk-f1zyc84x.js +2 -0
  101. package/dist/{chunk-f4jh9vrj.js → chunk-g8dx2jew.js} +246 -243
  102. package/dist/{chunk-phzs239m.js → chunk-gdxhe7ae.js} +4 -4
  103. package/dist/{chunk-5dmkkvs7.js → chunk-gh0q6jrm.js} +2 -2
  104. package/dist/chunk-h8vk3q9n.js +2 -0
  105. package/dist/{chunk-k7ht6tqe.js → chunk-hq8vxds5.js} +2 -2
  106. package/dist/{chunk-zd01r00t.js → chunk-hqda3vcw.js} +1 -1
  107. package/dist/chunk-j8pamkbh.js +2 -0
  108. package/dist/{chunk-2jjff8kv.js → chunk-jwe7yq8m.js} +5 -5
  109. package/dist/chunk-k5rrp1bt.js +2 -0
  110. package/dist/{chunk-yk3wh2xv.js → chunk-kcq2ed1d.js} +2 -2
  111. package/dist/{chunk-9yar9rfq.js → chunk-ktc1ecsm.js} +1 -1
  112. package/dist/chunk-mfm7ezh6.js +2 -0
  113. package/dist/chunk-mp16jxcg.js +2 -0
  114. package/dist/chunk-myhh1zsm.js +2 -0
  115. package/dist/chunk-n1c9j5qv.js +2 -0
  116. package/dist/{chunk-dcpf6kas.js → chunk-n8hnrgen.js} +6 -6
  117. package/dist/{chunk-36agnyhe.js → chunk-nc0ba89b.js} +6 -6
  118. package/dist/chunk-nf63pk4s.js +2 -0
  119. package/dist/{chunk-1edvsndv.js → chunk-nxw03sy9.js} +2 -2
  120. package/dist/{chunk-jze68d0z.js → chunk-p3xkj7pm.js} +2 -2
  121. package/dist/chunk-p5cry5s7.js +2 -0
  122. package/dist/{chunk-0dz1b6a1.js → chunk-pxk0tpw2.js} +3 -3
  123. package/dist/chunk-qd4snptd.js +2 -0
  124. package/dist/{chunk-h4k3hyny.js → chunk-r5ce7mkg.js} +2 -2
  125. package/dist/chunk-r8qhex33.js +2 -0
  126. package/dist/chunk-rqvn1s52.js +2 -0
  127. package/dist/{chunk-79vdkvhf.js → chunk-sej3ng5k.js} +5 -5
  128. package/dist/chunk-sjsant53.js +2 -0
  129. package/dist/chunk-snzh9z3g.js +3 -0
  130. package/dist/{chunk-ymawe0y5.js → chunk-ss4h5ch3.js} +1 -1
  131. package/dist/{chunk-2crxkm7j.js → chunk-svvavwp2.js} +4 -4
  132. package/dist/{chunk-qt3x1sh3.js → chunk-t79xnvzr.js} +3 -3
  133. package/dist/{chunk-rrj5m9xv.js → chunk-ta50ym5j.js} +2 -2
  134. package/dist/chunk-ty8g61y9.js +2 -0
  135. package/dist/chunk-v1k6w4z5.js +2 -0
  136. package/dist/{chunk-rfnr4xz6.js → chunk-vde4mtfr.js} +2 -2
  137. package/dist/chunk-vm7zv0gc.js +2 -0
  138. package/dist/{chunk-xckzvbvn.js → chunk-vnh550b5.js} +1 -1
  139. package/dist/chunk-vnxc48en.js +2 -0
  140. package/dist/chunk-y7vbwhh7.js +2 -0
  141. package/dist/{chunk-ydx3mfpp.js → chunk-yf90vn5t.js} +6 -6
  142. package/dist/{chunk-6wc2t6cd.js → chunk-yhqhv8mp.js} +13 -13
  143. package/dist/{chunk-s34g3awk.js → chunk-ytf3qkaw.js} +3 -3
  144. package/dist/chunk-yvyypd92.js +2 -0
  145. package/dist/{chunk-c4zpzxex.js → chunk-z33z3rr4.js} +4 -4
  146. package/dist/chunk-zfw39q56.js +2 -0
  147. package/dist/chunk-zpm02e15.js +2 -0
  148. package/dist/chunk-zzr0p4bb.js +2 -0
  149. package/dist/cli.js +18 -18
  150. package/dist/client/directive.d.ts +0 -7
  151. package/dist/client/index.d.ts +1 -0
  152. package/dist/client/signals-appearance-runtime.d.ts +1 -1
  153. package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
  154. package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
  155. package/dist/client/signals-class-runtime.d.ts +1 -1
  156. package/dist/client/signals-component-api-runtime.d.ts +1 -1
  157. package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
  158. package/dist/client/signals-component-props-runtime.d.ts +1 -1
  159. package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
  160. package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
  161. package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
  162. package/dist/client/signals-context-runtime.d.ts +1 -1
  163. package/dist/client/signals-cookie-runtime.d.ts +1 -1
  164. package/dist/client/signals-devtools-runtime.d.ts +1 -1
  165. package/dist/client/signals-dialog-runtime.d.ts +1 -1
  166. package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
  167. package/dist/client/signals-drawer-runtime.d.ts +1 -1
  168. package/dist/client/signals-effect-runtime.d.ts +1 -1
  169. package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
  170. package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
  171. package/dist/client/signals-expression-runtime.d.ts +1 -1
  172. package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
  173. package/dist/client/signals-for-runtime.d.ts +1 -1
  174. package/dist/client/signals-globals-runtime.d.ts +1 -1
  175. package/dist/client/signals-handler-runtime.d.ts +1 -1
  176. package/dist/client/signals-head-runtime.d.ts +1 -1
  177. package/dist/client/signals-helpers-runtime.d.ts +1 -1
  178. package/dist/client/signals-host-runtime.d.ts +1 -1
  179. package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
  180. package/dist/client/signals-hydration-runtime.d.ts +1 -1
  181. package/dist/client/signals-if-chain-runtime.d.ts +1 -1
  182. package/dist/client/signals-if-runtime.d.ts +1 -1
  183. package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
  184. package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
  185. package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
  186. package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
  187. package/dist/client/signals-loop-row-runtime.d.ts +1 -1
  188. package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
  189. package/dist/client/signals-model-runtime.d.ts +1 -1
  190. package/dist/client/signals-mount-runtime.d.ts +1 -1
  191. package/dist/client/signals-navigation-runtime.d.ts +1 -1
  192. package/dist/client/signals-notify-runtime.d.ts +1 -1
  193. package/dist/client/signals-optimistic-runtime.d.ts +1 -1
  194. package/dist/client/signals-overlay-runtime.d.ts +1 -1
  195. package/dist/client/signals-pipe-runtime.d.ts +1 -1
  196. package/dist/client/signals-proxy-runtime.d.ts +1 -1
  197. package/dist/client/signals-query-runtime.d.ts +1 -1
  198. package/dist/client/signals-reactive-runtime.d.ts +1 -1
  199. package/dist/client/signals-ref-runtime.d.ts +1 -1
  200. package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
  201. package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
  202. package/dist/client/signals-show-runtime.d.ts +1 -1
  203. package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
  204. package/dist/client/signals-spa-load-runtime.d.ts +1 -1
  205. package/dist/client/signals-state-runtime.d.ts +1 -1
  206. package/dist/client/signals-storage-runtime.d.ts +1 -1
  207. package/dist/client/signals-store-registry-runtime.d.ts +1 -1
  208. package/dist/client/signals-style-runtime.d.ts +1 -1
  209. package/dist/client/signals-suspense-runtime.d.ts +1 -1
  210. package/dist/client/signals-timer-runtime.d.ts +1 -1
  211. package/dist/client/signals-toast-runtime.d.ts +1 -1
  212. package/dist/client/signals-tooltip-runtime.d.ts +1 -1
  213. package/dist/client/signals-transition-group-runtime.d.ts +1 -1
  214. package/dist/client/signals-websocket-runtime.d.ts +1 -1
  215. package/dist/client-helpers.d.ts +1 -312
  216. package/dist/client-module-registry.d.ts +4 -27
  217. package/dist/client-parameter-bindings.d.ts +4 -9
  218. package/dist/client-parameter-bindings.js +30 -10
  219. package/dist/client-script-bundler.d.ts +55 -103
  220. package/dist/client-script.d.ts +69 -127
  221. package/dist/client-script.js +4 -7
  222. package/dist/color-mode-boot.d.ts +21 -58
  223. package/dist/component-client-factories.d.ts +8 -9
  224. package/dist/component-contract-checks.d.ts +15 -18
  225. package/dist/component-contract.d.ts +6 -6
  226. package/dist/component-hmr.d.ts +8 -7
  227. package/dist/component-model.d.ts +14 -20
  228. package/dist/component-processing.d.ts +51 -59
  229. package/dist/component-registry.d.ts +28 -99
  230. package/dist/component-renderer.d.ts +19 -16
  231. package/dist/component-resolution.d.ts +8 -8
  232. package/dist/component-tags.d.ts +1 -1
  233. package/dist/composable-loader.d.ts +6 -41
  234. package/dist/composables/use-fetch.d.ts +45 -114
  235. package/dist/composables/use-form.d.ts +2 -56
  236. package/dist/composables/use-intersection-observer.d.ts +1 -1
  237. package/dist/composables.d.ts +75 -74
  238. package/dist/composition-api.d.ts +19 -43
  239. package/dist/computed.d.ts +93 -86
  240. package/dist/conditionals.d.ts +0 -24
  241. package/dist/config.d.ts +30 -24
  242. package/dist/config.js +3 -0
  243. package/dist/craft-bridge.d.ts +1 -467
  244. package/dist/craft-components.d.ts +234 -680
  245. package/dist/craft-entry.js +2 -2
  246. package/dist/craft.js +2 -2
  247. package/dist/csp.d.ts +41 -107
  248. package/dist/database.d.ts +1 -1
  249. package/dist/defer.d.ts +0 -24
  250. package/dist/dev-server/terminal-colors.d.ts +32 -32
  251. package/dist/dev-server/ts-css.d.ts +26 -35
  252. package/dist/dev-server/types.d.ts +33 -29
  253. package/dist/directive-api.d.ts +42 -85
  254. package/dist/directive-arguments.d.ts +14 -39
  255. package/dist/document-shell.d.ts +49 -81
  256. package/dist/dynamic-components.d.ts +0 -9
  257. package/dist/engine-bindings.d.ts +1 -1
  258. package/dist/env.d.ts +26 -0
  259. package/dist/error-boundaries.d.ts +36 -43
  260. package/dist/error-handling.d.ts +1 -1
  261. package/dist/errors/codes.d.ts +43 -51
  262. package/dist/errors/formatter.d.ts +38 -58
  263. package/dist/errors/index.d.ts +61 -5
  264. package/dist/errors/logger.d.ts +40 -114
  265. package/dist/errors/sanitizer.d.ts +28 -53
  266. package/dist/errors/types.d.ts +31 -44
  267. package/dist/events.d.ts +32 -94
  268. package/dist/expressions.d.ts +57 -62
  269. package/dist/find-body-tag.d.ts +5 -34
  270. package/dist/first-script-tag.d.ts +0 -23
  271. package/dist/forms-validation.d.ts +117 -149
  272. package/dist/forms.d.ts +161 -120
  273. package/dist/framework-composables.d.ts +0 -32
  274. package/dist/head-injection.d.ts +30 -32
  275. package/dist/head-keys.d.ts +12 -15
  276. package/dist/head.d.ts +110 -139
  277. package/dist/heatmap.d.ts +76 -152
  278. package/dist/html-masking.d.ts +38 -62
  279. package/dist/hydration-runtime.d.ts +24 -20
  280. package/dist/hydration.d.ts +11 -10
  281. package/dist/i18n.d.ts +34 -95
  282. package/dist/image-optimization/auto-sibling.d.ts +4 -32
  283. package/dist/imported-signals.d.ts +0 -36
  284. package/dist/includes.d.ts +6 -69
  285. package/dist/index.d.ts +2 -1
  286. package/dist/init.d.ts +12 -20
  287. package/dist/internal-markdown.d.ts +8 -12
  288. package/dist/interpolation-context.d.ts +15 -15
  289. package/dist/island-chunking.d.ts +13 -30
  290. package/dist/keep-alive.d.ts +52 -72
  291. package/dist/layout-types.d.ts +2 -27
  292. package/dist/lazy-module.d.ts +0 -10
  293. package/dist/loading-indicator.d.ts +8 -5
  294. package/dist/loop-binding.d.ts +4 -7
  295. package/dist/loops.d.ts +25 -67
  296. package/dist/markdown.d.ts +1 -0
  297. package/dist/media/image/component.d.ts +9 -25
  298. package/dist/media/image/directive.d.ts +1 -15
  299. package/dist/media/image/placeholder.d.ts +9 -20
  300. package/dist/media/image/processor/cache.d.ts +18 -40
  301. package/dist/media/image/processor/index.d.ts +10 -1
  302. package/dist/media/image/processor/optimizer.d.ts +1 -12
  303. package/dist/media/image/processor/responsive.d.ts +6 -16
  304. package/dist/media/image/srcset.d.ts +49 -47
  305. package/dist/media/shared/cache.d.ts +31 -51
  306. package/dist/media/shared/hash.d.ts +0 -7
  307. package/dist/media/types.d.ts +754 -1235
  308. package/dist/media/video/directive.d.ts +1 -15
  309. package/dist/media/video/index.d.ts +17 -39
  310. package/dist/media/video/processor/cache.d.ts +19 -42
  311. package/dist/media/video/processor/index.d.ts +18 -1
  312. package/dist/media/video/processor/streaming.d.ts +10 -17
  313. package/dist/media/video/processor/thumbnail.d.ts +15 -21
  314. package/dist/media/video/processor/transcoder.d.ts +1 -11
  315. package/dist/meta-arguments.d.ts +14 -39
  316. package/dist/method-spoofing.d.ts +0 -7
  317. package/dist/middleware.d.ts +0 -60
  318. package/dist/native/bridge/protocol.d.ts +2 -1
  319. package/dist/native/compiler/headwind-to-style.d.ts +383 -359
  320. package/dist/native/compiler/icons.d.ts +249 -243
  321. package/dist/native/compiler/svg.d.ts +35 -24
  322. package/dist/native/runtime/jsc-globals.d.ts +1 -1
  323. package/dist/native/runtime/native-host.d.ts +1 -1
  324. package/dist/native/runtime/native-host.js +3 -0
  325. package/dist/offline/app-service-worker.d.ts +50 -114
  326. package/dist/offline/kept-store.d.ts +23 -37
  327. package/dist/offline/query-cache.d.ts +55 -126
  328. package/dist/owned-routes.d.ts +0 -31
  329. package/dist/page-response.d.ts +8 -39
  330. package/dist/parser/directive-parser.d.ts +45 -57
  331. package/dist/parser/expression-parser.d.ts +35 -33
  332. package/dist/parser/index.d.ts +39 -4
  333. package/dist/parser/tokenizer.d.ts +49 -61
  334. package/dist/partial-hydration.d.ts +51 -82
  335. package/dist/performance-utils.d.ts +115 -255
  336. package/dist/placeholder.d.ts +9 -18
  337. package/dist/plugin-system.d.ts +115 -264
  338. package/dist/process.d.ts +4 -9
  339. package/dist/process.js +6 -4
  340. package/dist/prop-sentinels.d.ts +11 -11
  341. package/dist/public-env.d.ts +0 -14
  342. package/dist/pwa/directives.d.ts +20 -12
  343. package/dist/pwa/inject.d.ts +0 -10
  344. package/dist/pwa/precache.d.ts +16 -22
  345. package/dist/pwa/service-worker.d.ts +0 -12
  346. package/dist/pwa.js +3 -3
  347. package/dist/reactive-bindings.d.ts +11 -34
  348. package/dist/reactive-tracking.d.ts +0 -36
  349. package/dist/reactive.d.ts +41 -58
  350. package/dist/render-memo.d.ts +5 -23
  351. package/dist/resolve-stx-targets.d.ts +6 -44
  352. package/dist/route-middleware.d.ts +35 -2
  353. package/dist/route-rules.d.ts +10 -13
  354. package/dist/router.d.ts +9 -8
  355. package/dist/routes.d.ts +3 -1
  356. package/dist/runtime-config-server.d.ts +14 -17
  357. package/dist/runtime-config.d.ts +2 -3
  358. package/dist/runtime-globals.d.ts +90 -122
  359. package/dist/runtime-injection.d.ts +0 -8
  360. package/dist/scaffolding.d.ts +30 -26
  361. package/dist/script-emit.d.ts +0 -30
  362. package/dist/script-validation.d.ts +6 -12
  363. package/dist/seo.d.ts +75 -153
  364. package/dist/server-api.d.ts +9 -12
  365. package/dist/server-bindings.d.ts +1 -26
  366. package/dist/server-data.d.ts +4 -5
  367. package/dist/sfc-template.d.ts +8 -8
  368. package/dist/signal-processing.d.ts +37 -53
  369. package/dist/signals-api.d.ts +58 -135
  370. package/dist/signals.d.ts +18 -24
  371. package/dist/site-url.d.ts +31 -28
  372. package/dist/slots.d.ts +20 -86
  373. package/dist/source-signature.d.ts +5 -28
  374. package/dist/ssg.d.ts +158 -337
  375. package/dist/ssg.js +4 -4
  376. package/dist/state-dir.d.ts +4 -4
  377. package/dist/store-loader.d.ts +0 -10
  378. package/dist/story/analytics.d.ts +60 -138
  379. package/dist/story/bookmarks.d.ts +34 -87
  380. package/dist/story/cli.d.ts +69 -123
  381. package/dist/story/collect/scanner.d.ts +0 -4
  382. package/dist/story/collect/tree.d.ts +1 -8
  383. package/dist/story/commands/build.d.ts +6 -11
  384. package/dist/story/commands/dev.d.ts +8 -15
  385. package/dist/story/commands/preview.d.ts +7 -13
  386. package/dist/story/config-watcher.d.ts +13 -20
  387. package/dist/story/config.d.ts +8 -11
  388. package/dist/story/context.d.ts +8 -14
  389. package/dist/story/hmr.d.ts +26 -24
  390. package/dist/story/hot-swap.d.ts +23 -34
  391. package/dist/story/keyboard-shortcuts.d.ts +18 -23
  392. package/dist/story/output.d.ts +44 -46
  393. package/dist/story/performance.d.ts +45 -107
  394. package/dist/story/presets.d.ts +41 -107
  395. package/dist/story/renderer.d.ts +27 -41
  396. package/dist/story/search.d.ts +12 -23
  397. package/dist/story/server.d.ts +11 -21
  398. package/dist/story/setup.d.ts +15 -23
  399. package/dist/story/testing.d.ts +40 -65
  400. package/dist/story/types.d.ts +160 -262
  401. package/dist/streaming.d.ts +57 -119
  402. package/dist/strip-literals.d.ts +1 -25
  403. package/dist/stx-module-imports.d.ts +7 -0
  404. package/dist/stx-virtual-ts.d.ts +102 -253
  405. package/dist/stx-virtual-ts.js +5 -4
  406. package/dist/style-scoping.d.ts +8 -21
  407. package/dist/suspense.d.ts +52 -67
  408. package/dist/teleport.d.ts +0 -22
  409. package/dist/template-syntax-escape.d.ts +8 -8
  410. package/dist/template-tag-balance.d.ts +6 -22
  411. package/dist/testing.d.ts +26 -11
  412. package/dist/theme-tokens.d.ts +388 -134
  413. package/dist/transitions.d.ts +55 -66
  414. package/dist/ts-css-config.d.ts +12 -70
  415. package/dist/types/component-types.d.ts +122 -187
  416. package/dist/types/config-types.d.ts +341 -956
  417. package/dist/types/context-types.d.ts +24 -46
  418. package/dist/types/csp-types.d.ts +66 -70
  419. package/dist/types/directive-types.d.ts +156 -223
  420. package/dist/types/index.d.ts +110 -6
  421. package/dist/types/pwa-types.d.ts +148 -273
  422. package/dist/types.d.ts +1 -0
  423. package/dist/unresolved-identifiers.d.ts +22 -24
  424. package/dist/url-safety.d.ts +32 -32
  425. package/dist/utils.d.ts +21 -36
  426. package/dist/utils.js +6 -2
  427. package/dist/validator.d.ts +26 -28
  428. package/dist/variable-extractor.d.ts +19 -49
  429. package/dist/view-composers.d.ts +81 -80
  430. package/dist/virtual-scrolling.d.ts +82 -101
  431. package/dist/visual-testing.d.ts +10 -9
  432. package/dist/vue-template.d.ts +0 -23
  433. package/dist/web-components/css-scoping.d.ts +11 -21
  434. package/dist/web-components.d.ts +58 -81
  435. package/dist/x-element.d.ts +1 -0
  436. package/package.json +6 -6
  437. package/stx.d.ts +2 -2
  438. package/dist/app-service-worker.d.ts +0 -165
  439. package/dist/chunk-01mxer9s.js +0 -2
  440. package/dist/chunk-09gtbb1w.js +0 -2
  441. package/dist/chunk-0g2ybnht.js +0 -3
  442. package/dist/chunk-15erabm6.js +0 -2
  443. package/dist/chunk-1z6c6dyk.js +0 -2
  444. package/dist/chunk-1zfg1kd5.js +0 -2
  445. package/dist/chunk-279jv0yf.js +0 -2
  446. package/dist/chunk-2a1q5y6r.js +0 -2
  447. package/dist/chunk-2cqbyb8w.js +0 -2
  448. package/dist/chunk-2jsnrfc8.js +0 -2
  449. package/dist/chunk-3gft8zng.js +0 -2
  450. package/dist/chunk-49gwmcrn.js +0 -2
  451. package/dist/chunk-4wfr074d.js +0 -2
  452. package/dist/chunk-5afw7z6v.js +0 -2
  453. package/dist/chunk-5fv4g4et.js +0 -2
  454. package/dist/chunk-604rs9sq.js +0 -2
  455. package/dist/chunk-636sfxyj.js +0 -2
  456. package/dist/chunk-6f4qrd0s.js +0 -2
  457. package/dist/chunk-6va5pe2m.js +0 -2
  458. package/dist/chunk-8k61b4ae.js +0 -2
  459. package/dist/chunk-asbq9cgs.js +0 -2
  460. package/dist/chunk-b7t8jejd.js +0 -2
  461. package/dist/chunk-b894fxfc.js +0 -2
  462. package/dist/chunk-bm2q1srp.js +0 -2
  463. package/dist/chunk-cgwyd9aq.js +0 -2
  464. package/dist/chunk-cvswrbzw.js +0 -2
  465. package/dist/chunk-d8206zbp.js +0 -2
  466. package/dist/chunk-f10299sf.js +0 -2
  467. package/dist/chunk-f1apaqfk.js +0 -2
  468. package/dist/chunk-g6zeqvvb.js +0 -2
  469. package/dist/chunk-ghy82tsc.js +0 -2
  470. package/dist/chunk-jw33eys8.js +0 -2
  471. package/dist/chunk-k6wgh598.js +0 -2
  472. package/dist/chunk-m2a1fxpb.js +0 -2
  473. package/dist/chunk-m6mxqepz.js +0 -2
  474. package/dist/chunk-n6qp05t9.js +0 -2
  475. package/dist/chunk-nn174xjh.js +0 -2
  476. package/dist/chunk-ntgy4e1q.js +0 -2
  477. package/dist/chunk-nw4axkpx.js +0 -2
  478. package/dist/chunk-p5chk3s9.js +0 -2
  479. package/dist/chunk-pw9verqx.js +0 -2
  480. package/dist/chunk-ta8bhz27.js +0 -2
  481. package/dist/chunk-tc5r2vmw.js +0 -2
  482. package/dist/chunk-ts80ktq7.js +0 -2
  483. package/dist/chunk-vyg8bvkt.js +0 -2
  484. package/dist/chunk-xq2ck69k.js +0 -2
  485. package/dist/chunk-y4ajd836.js +0 -2
  486. package/dist/chunk-zddzjd60.js +0 -2
  487. package/dist/chunk-zgxj1q7w.js +0 -2
  488. package/dist/chunk-zs7qhh40.js +0 -2
  489. package/dist/signals-context-runtime.d.ts +0 -2
  490. package/dist/signals-drawer-runtime.d.ts +0 -2
  491. package/dist/signals-host-runtime.d.ts +0 -9
  492. package/dist/signals-loop-conditional-runtime.d.ts +0 -2
  493. package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
  494. package/dist/signals-notify-runtime.d.ts +0 -2
  495. package/dist/signals-optimistic-runtime.d.ts +0 -2
  496. package/dist/signals-overlay-runtime.d.ts +0 -2
  497. package/dist/signals-scope-disposal-runtime.d.ts +0 -2
  498. package/dist/signals-spa-load-control-runtime.d.ts +0 -2
  499. package/dist/signals-storage-runtime.d.ts +0 -2
package/dist/forms.d.ts CHANGED
@@ -1,80 +1,4 @@
1
- /**
2
- * Module for processing form-related directives.
3
- *
4
- * Provides directives for building accessible, validated forms:
5
- * - `@csrf` - CSRF token hidden input
6
- * - `@method('PUT')` - HTTP method spoofing
7
- * - `@form` / `@endform` - Form wrapper with auto CSRF
8
- * - `@input`, `@textarea`, `@select` - Form controls with validation
9
- * - `@checkbox`, `@radio` - Check inputs with state binding
10
- * - `@file` - File upload input with accept and multiple support
11
- * - `@label` - Associated labels
12
- * - `@error` / `@enderror` - Validation error display
13
- * - `@validate` - Add validation rules with HTML5 attributes
14
- *
15
- * ## File Upload Example
16
- *
17
- * ```html
18
- * @file('avatar', { accept: 'image/*' })
19
- * @file('documents', { accept: '.pdf,.doc,.docx', multiple: true })
20
- * ```
21
- *
22
- * ## Validation Rules
23
- *
24
- * Built-in validation rules:
25
- * - `required` - Field must have a value
26
- * - `email` - Must be valid email format
27
- * - `url` - Must be valid URL
28
- * - `numeric` - Must be a number
29
- * - `integer` - Must be an integer
30
- * - `alpha` - Letters only
31
- * - `alphanumeric` - Letters and numbers only
32
- * - `min:n` - Minimum length/value
33
- * - `max:n` - Maximum length/value
34
- * - `confirmed` - Must match `{field}_confirmation`
35
- * - `in:a,b,c` - Must be one of the values
36
- * - `notIn:a,b,c` - Must not be one of the values
37
- * - `regex:pattern` - Must match regex
38
- * - `date` - Must be valid date
39
- * - `before:date` - Must be before date
40
- * - `after:date` - Must be after date
41
- *
42
- * ## Configuration
43
- *
44
- * CSS class names can be customized via `stx.config.ts`:
45
- * ```typescript
46
- * export default {
47
- * forms: {
48
- * classes: {
49
- * input: 'my-input',
50
- * inputError: 'my-input--error',
51
- * // ...
52
- * }
53
- * }
54
- * }
55
- * ```
56
- */
57
1
  import type { StxOptions } from './types';
58
- /**
59
- * Default CSS class names for form elements.
60
- * Based on Bootstrap conventions but fully customizable.
61
- */
62
- export interface FormClassConfig {
63
- /** Class for text inputs, textareas, and selects (default: 'form-control') */
64
- input: string;
65
- /** Class added to inputs with validation errors (default: 'is-invalid') */
66
- inputError: string;
67
- /** Class for checkboxes and radios (default: 'form-check-input') */
68
- checkInput: string;
69
- /** Class for labels (default: 'form-label') */
70
- label: string;
71
- /** Class for error message containers (default: 'invalid-feedback') */
72
- errorFeedback: string;
73
- }
74
- /**
75
- * Default form class configuration (Bootstrap-compatible)
76
- */
77
- export declare const defaultFormClasses: FormClassConfig;
78
2
  /**
79
3
  * Process all form-related directives.
80
4
  *
@@ -106,25 +30,6 @@ export declare function processFormInputDirectives(template: string, context: Re
106
30
  * ```
107
31
  */
108
32
  export declare function processErrorDirective(template: string, context: Record<string, any>, _classes?: FormClassConfig): string;
109
- /**
110
- * Validation rule definition
111
- */
112
- export interface ValidationRule {
113
- /** Rule name (e.g., 'required', 'email', 'min') */
114
- name: string;
115
- /** Rule parameters (e.g., min:5 → params = ['5']) */
116
- params?: string[];
117
- /** Custom error message */
118
- message?: string;
119
- }
120
- /**
121
- * Validation result for a single field
122
- */
123
- export interface FieldValidationResult {
124
- field: string;
125
- valid: boolean;
126
- errors: string[];
127
- }
128
33
  /**
129
34
  * Register a custom validation rule.
130
35
  *
@@ -183,23 +88,6 @@ export declare function validateFields(data: Record<string, any>, rules: Record<
183
88
  * ```
184
89
  */
185
90
  export declare function processValidateDirective(template: string, _context: Record<string, any>): string;
186
- /**
187
- * Enhanced validation rule definition with HTML5 support
188
- */
189
- export interface EnhancedValidationRule {
190
- /** Rule name */
191
- name: string;
192
- /** Validation function - returns true if valid, error message if invalid */
193
- validate: (value: unknown, params: string[], allValues: Record<string, unknown>) => true | string;
194
- /** HTML5 attribute generator */
195
- toHtml5?: (params: string[]) => string[];
196
- /** Default error message with {{param}} placeholders */
197
- message: string;
198
- }
199
- /**
200
- * Enhanced validation rules registry with full validation support
201
- */
202
- export declare const enhancedValidationRules: Record<string, EnhancedValidationRule>;
203
91
  /**
204
92
  * Register a custom enhanced validation rule
205
93
  */
@@ -207,18 +95,171 @@ export declare function registerEnhancedValidationRule(rule: EnhancedValidationR
207
95
  /**
208
96
  * Validate a single value against enhanced rules
209
97
  */
210
- export declare function validateValueEnhanced(value: unknown, rules: string, allValues?: Record<string, unknown>): {
211
- valid: boolean;
212
- errors: string[];
213
- };
98
+ export declare function validateValueEnhanced(value: unknown, rules: string, allValues?: Record<string, unknown>): { valid: boolean, errors: string[] };
214
99
  /**
215
100
  * Validate multiple values with enhanced validation
216
101
  */
217
- export declare function validateFormEnhanced(values: Record<string, unknown>, rules: Record<string, string>): {
218
- valid: boolean;
219
- errors: Record<string, string[]>;
220
- };
102
+ export declare function validateFormEnhanced(values: Record<string, unknown>, rules: Record<string, string>): { valid: boolean, errors: Record<string, string[]> };
221
103
  /**
222
104
  * Generate client-side validation script for a form
223
105
  */
224
106
  export declare function generateValidationScript(formId: string, rules: Record<string, string>): string;
107
+ /**
108
+ * Default form class configuration (Bootstrap-compatible)
109
+ */
110
+ export declare const defaultFormClasses: FormClassConfig;
111
+ /**
112
+ * Enhanced validation rules registry with full validation support
113
+ * @defaultValue
114
+ * ```ts
115
+ * {
116
+ * required: {
117
+ * name: 'required',
118
+ * validate: (value) => unknown,
119
+ * toHtml5: () => string[],
120
+ * message: 'This field is required'
121
+ * },
122
+ * email: {
123
+ * name: 'email',
124
+ * validate: (value) => unknown,
125
+ * toHtml5: () => string[],
126
+ * message: 'Please enter a valid email address'
127
+ * },
128
+ * url: {
129
+ * name: 'url',
130
+ * validate: (value) => unknown,
131
+ * toHtml5: () => string[],
132
+ * message: 'Please enter a valid URL'
133
+ * },
134
+ * numeric: {
135
+ * name: 'numeric',
136
+ * validate: (value) => boolean,
137
+ * toHtml5: () => string[],
138
+ * message: 'Please enter a number'
139
+ * },
140
+ * integer: {
141
+ * name: 'integer',
142
+ * validate: (value) => unknown,
143
+ * toHtml5: () => string[],
144
+ * message: 'Please enter a whole number'
145
+ * },
146
+ * alpha: {
147
+ * name: 'alpha',
148
+ * validate: (value) => unknown,
149
+ * toHtml5: () => string[],
150
+ * message: 'Please enter only letters'
151
+ * },
152
+ * alphanumeric: {
153
+ * name: 'alphanumeric',
154
+ * validate: (value) => unknown,
155
+ * toHtml5: () => string[],
156
+ * message: 'Please enter only letters and numbers'
157
+ * },
158
+ * min: {
159
+ * name: 'min',
160
+ * validate: (value, params) => unknown,
161
+ * toHtml5: (params) => string[],
162
+ * message: 'Must be at least {{param}} characters'
163
+ * },
164
+ * max: {
165
+ * name: 'max',
166
+ * validate: (value, params) => unknown,
167
+ * toHtml5: (params) => string[],
168
+ * message: 'Must be no more than {{param}} characters'
169
+ * },
170
+ * between: {
171
+ * name: 'between',
172
+ * validate: (value, params) => unknown,
173
+ * toHtml5: (params) => string[],
174
+ * message: 'Must be between {{min}} and {{max}}'
175
+ * },
176
+ * confirmed: {
177
+ * name: 'confirmed',
178
+ * validate: (value, _params, allValues) => boolean | string,
179
+ * message: 'Confirmation does not match'
180
+ * },
181
+ * in: {
182
+ * name: 'in',
183
+ * validate: (value, params) => unknown,
184
+ * message: 'Must be one of: {{values}}'
185
+ * },
186
+ * notIn: {
187
+ * name: 'notIn',
188
+ * validate: (value, params) => boolean,
189
+ * message: 'Must not be: {{values}}'
190
+ * },
191
+ * regex: {
192
+ * name: 'regex',
193
+ * validate: (value, params) => unknown,
194
+ * toHtml5: (params) => string[],
195
+ * message: 'Invalid format'
196
+ * },
197
+ * date: {
198
+ * name: 'date',
199
+ * validate: (value) => unknown,
200
+ * toHtml5: () => string[],
201
+ * message: 'Please enter a valid date'
202
+ * },
203
+ * before: {
204
+ * name: 'before',
205
+ * validate: (value, params) => unknown,
206
+ * toHtml5: (params) => string[],
207
+ * message: 'Must be before {{date}}'
208
+ * },
209
+ * after: {
210
+ * name: 'after',
211
+ * validate: (value, params) => unknown,
212
+ * toHtml5: (params) => string[],
213
+ * message: 'Must be after {{date}}'
214
+ * },
215
+ * size: {
216
+ * name: 'size',
217
+ * validate: (value, params) => unknown,
218
+ * message: 'Must be exactly {{size}}'
219
+ * },
220
+ * phone: {
221
+ * name: 'phone',
222
+ * validate: (value) => unknown,
223
+ * toHtml5: () => string[],
224
+ * message: 'Please enter a valid phone number'
225
+ * }
226
+ * }
227
+ * ```
228
+ */
229
+ export declare const enhancedValidationRules: Record<string, EnhancedValidationRule>;
230
+ /**
231
+ * Default CSS class names for form elements.
232
+ * Based on Bootstrap conventions but fully customizable.
233
+ */
234
+ export declare interface FormClassConfig {
235
+ input: string
236
+ inputError: string
237
+ checkInput: string
238
+ label: string
239
+ errorFeedback: string
240
+ }
241
+ /**
242
+ * Validation rule definition
243
+ */
244
+ export declare interface ValidationRule {
245
+ name: string
246
+ params?: string[]
247
+ message?: string
248
+ }
249
+ /**
250
+ * Validation result for a single field
251
+ */
252
+ export declare interface FieldValidationResult {
253
+ field: string
254
+ valid: boolean
255
+ errors: string[]
256
+ }
257
+ /**
258
+ * Enhanced validation rule definition with HTML5 support
259
+ */
260
+ export declare interface EnhancedValidationRule {
261
+ name: string
262
+ validate: (value: unknown, params: string[], allValues: Record<string, unknown>) => true | string
263
+ toHtml5?: (params: string[]) => string[]
264
+ message: string
265
+ }
@@ -1,35 +1,3 @@
1
- /**
2
- * Ship the framework's own browser-only composables to the client
3
- * (stacksjs/stx#1805).
4
- *
5
- * `src/composables/` exports 149 functions; 120 of them have no counterpart in
6
- * the client runtime. They are exported from the package, they type-check, they
7
- * autocomplete — and they are unreachable from the only environment where their
8
- * underlying API exists. `useClipboard`, `useGeolocation`, `useFullscreen`,
9
- * `useBattery` and the observer family all wrap browser APIs and all threw
10
- * `ReferenceError` when called from a `<script client>` block.
11
- *
12
- * There are two ways to close that gap. Hand-porting each one into the runtime's
13
- * template literal duplicates 120 implementations that already exist and would
14
- * drift the same way the auto-import list did (#1804). Instead this bundles the
15
- * real modules — one source of truth — and merges them onto `window.stx`.
16
- *
17
- * DEMAND-DRIVEN: only composables the page actually references are emitted, so
18
- * a page calling `useClipboard` ships a couple of KB rather than the whole tree.
19
- *
20
- * SKIP, NEVER CLOBBER: a name the runtime already provides wins. The runtime
21
- * versions are the signal-based ones that #1710/#1726/#1797 unified; replacing
22
- * them with the module versions would be a regression, not a fix.
23
- *
24
- * KNOWN LIMITATION, and it is why this is a bridge rather than the end state:
25
- * these are pre-unification shapes — a getter plus `subscribe()` plus a manual
26
- * `stop()`, not signals. So `useClipboard().copy(text)` works, `subscribe()`
27
- * works, and imperative use is correct; but reading `.copied` in a template does
28
- * not re-render on its own. Converting them to the Signal contract is the real
29
- * fix and is tracked separately.
30
- *
31
- * @module framework-composables
32
- */
33
1
  /** Clear the cache. Dev HMR calls this when composables change on disk. */
34
2
  export declare function clearFrameworkComposableCache(): void;
35
3
  /**
@@ -1,35 +1,3 @@
1
- /**
2
- * One splice into `<head>` instead of one per thing being injected
3
- * (stacksjs/stx#1945).
4
- *
5
- * Several passes each add a small fragment to the head of a finished page: the
6
- * x-cloak style, the color-mode boot script, the build-id meta. Each was
7
- * written the obvious way -- find the anchor, return
8
- * `slice(0, i) + fragment + slice(i)` -- and each of those returns a NEW copy
9
- * of the whole document. On a 212KB page that is 212KB allocated to insert a
10
- * few hundred bytes, three times over, and the measured cost of the top-level
11
- * pipeline was dominated by exactly this shape: of 86 assignments in a render,
12
- * only ten produced a new string, and six of them were whole-document copies
13
- * made to insert something small.
14
- *
15
- * A pass that contributes a fragment instead of splicing it lets all of them
16
- * share one rebuild. Order is preserved within each anchor, which is the part
17
- * that matters: the boot script has to precede the cloak style in the head, and
18
- * both have to be live before first paint.
19
- *
20
- * Nothing here decides WHETHER a fragment applies. Each caller keeps its own
21
- * guard -- idempotence checks, config gates -- and simply contributes nothing
22
- * when it does not apply, so a page that needs no injections is not rebuilt.
23
- *
24
- * @module head-injection
25
- */
26
- /** Fragments waiting to be spliced into one document. */
27
- export interface HeadInjections {
28
- /** Inserted immediately after the `<head ...>` open tag, in push order. */
29
- afterOpen: string[];
30
- /** Inserted immediately before `</head>`, in push order. */
31
- beforeClose: string[];
32
- }
33
1
  export declare function createHeadInjections(): HeadInjections;
34
2
  /** Whether anything was contributed, so a caller can skip the rebuild entirely. */
35
3
  export declare function hasHeadInjections(injections: HeadInjections): boolean;
@@ -59,3 +27,33 @@ export declare function applyHeadInjections(html: string, injections: HeadInject
59
27
  * through here.
60
28
  */
61
29
  export declare function headInsertionPoint(html: string): number | null;
30
+ /**
31
+ * One splice into `<head>` instead of one per thing being injected
32
+ * (stacksjs/stx#1945).
33
+ *
34
+ * Several passes each add a small fragment to the head of a finished page: the
35
+ * x-cloak style, the color-mode boot script, the build-id meta. Each was
36
+ * written the obvious way -- find the anchor, return
37
+ * `slice(0, i) + fragment + slice(i)` -- and each of those returns a NEW copy
38
+ * of the whole document. On a 212KB page that is 212KB allocated to insert a
39
+ * few hundred bytes, three times over, and the measured cost of the top-level
40
+ * pipeline was dominated by exactly this shape: of 86 assignments in a render,
41
+ * only ten produced a new string, and six of them were whole-document copies
42
+ * made to insert something small.
43
+ *
44
+ * A pass that contributes a fragment instead of splicing it lets all of them
45
+ * share one rebuild. Order is preserved within each anchor, which is the part
46
+ * that matters: the boot script has to precede the cloak style in the head, and
47
+ * both have to be live before first paint.
48
+ *
49
+ * Nothing here decides WHETHER a fragment applies. Each caller keeps its own
50
+ * guard -- idempotence checks, config gates -- and simply contributes nothing
51
+ * when it does not apply, so a page that needs no injections is not rebuilt.
52
+ *
53
+ * @module head-injection
54
+ */
55
+ /** Fragments waiting to be spliced into one document. */
56
+ export declare interface HeadInjections {
57
+ afterOpen: string[]
58
+ beforeClose: string[]
59
+ }
@@ -1,3 +1,15 @@
1
+ /** Forget which warnings were printed, so a test sees them again. */
2
+ export declare function resetHeadKeyWarnings(): void;
3
+ /** The known key an unknown one most likely meant, or undefined. */
4
+ export declare function nearestHeadKey(key: string, known: readonly string[]): string | undefined;
5
+ /**
6
+ * Read a head config with the plural list keys folded into their singular,
7
+ * warning (once) about those and about any other key stx does not know.
8
+ *
9
+ * Returns the input itself when every key is known. Memoized per object, so a
10
+ * config read on every render is checked once.
11
+ */
12
+ export declare function normalizeHeadKeys<T extends Record<string, any>>(head: T | null | undefined, options: { known: readonly string[], source: string }): T;
1
13
  /**
2
14
  * Catch a head config key that stx would otherwise ignore without a word.
3
15
  *
@@ -24,18 +36,3 @@
24
36
  export declare const APP_HEAD_KEYS: readonly string[];
25
37
  /** Keys `useHead()` understands (see `HeadConfig`). */
26
38
  export declare const USE_HEAD_KEYS: readonly string[];
27
- /** Forget which warnings were printed, so a test sees them again. */
28
- export declare function resetHeadKeyWarnings(): void;
29
- /** The known key an unknown one most likely meant, or undefined. */
30
- export declare function nearestHeadKey(key: string, known: readonly string[]): string | undefined;
31
- /**
32
- * Read a head config with the plural list keys folded into their singular,
33
- * warning (once) about those and about any other key stx does not know.
34
- *
35
- * Returns the input itself when every key is known. Memoized per object, so a
36
- * config read on every render is checked once.
37
- */
38
- export declare function normalizeHeadKeys<T extends Record<string, any>>(head: T | null | undefined, options: {
39
- known: readonly string[];
40
- source: string;
41
- }): T;