@stacksjs/stx 0.2.572 → 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 (381) 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-s34g3awk.js → chunk-fynh3bkq.js} +1 -1
  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/headwind-to-style.d.ts +383 -359
  251. package/dist/native/compiler/icons.d.ts +249 -243
  252. package/dist/native/compiler/svg.d.ts +35 -24
  253. package/dist/native/runtime/jsc-globals.d.ts +1 -1
  254. package/dist/native/runtime/native-host.d.ts +1 -1
  255. package/dist/native/runtime/native-host.js +3 -0
  256. package/dist/offline/app-service-worker.d.ts +50 -114
  257. package/dist/offline/kept-store.d.ts +23 -37
  258. package/dist/offline/query-cache.d.ts +55 -126
  259. package/dist/owned-routes.d.ts +0 -31
  260. package/dist/page-response.d.ts +8 -39
  261. package/dist/parser/directive-parser.d.ts +45 -57
  262. package/dist/parser/expression-parser.d.ts +35 -33
  263. package/dist/parser/index.d.ts +39 -4
  264. package/dist/parser/tokenizer.d.ts +49 -61
  265. package/dist/partial-hydration.d.ts +51 -82
  266. package/dist/performance-utils.d.ts +115 -255
  267. package/dist/placeholder.d.ts +9 -18
  268. package/dist/plugin-system.d.ts +115 -264
  269. package/dist/process.d.ts +4 -9
  270. package/dist/process.js +6 -4
  271. package/dist/prop-sentinels.d.ts +11 -11
  272. package/dist/public-env.d.ts +0 -14
  273. package/dist/pwa/directives.d.ts +20 -12
  274. package/dist/pwa/inject.d.ts +0 -10
  275. package/dist/pwa/precache.d.ts +16 -22
  276. package/dist/pwa/service-worker.d.ts +0 -12
  277. package/dist/pwa.js +1 -1
  278. package/dist/reactive-bindings.d.ts +11 -34
  279. package/dist/reactive-tracking.d.ts +0 -36
  280. package/dist/reactive.d.ts +41 -58
  281. package/dist/render-memo.d.ts +5 -23
  282. package/dist/resolve-stx-targets.d.ts +6 -44
  283. package/dist/route-middleware.d.ts +35 -2
  284. package/dist/route-rules.d.ts +10 -13
  285. package/dist/router.d.ts +9 -8
  286. package/dist/routes.d.ts +3 -1
  287. package/dist/runtime-config-server.d.ts +14 -17
  288. package/dist/runtime-config.d.ts +2 -3
  289. package/dist/runtime-globals.d.ts +90 -122
  290. package/dist/runtime-injection.d.ts +0 -8
  291. package/dist/scaffolding.d.ts +30 -26
  292. package/dist/script-emit.d.ts +0 -30
  293. package/dist/script-validation.d.ts +6 -12
  294. package/dist/seo.d.ts +75 -153
  295. package/dist/server-api.d.ts +9 -12
  296. package/dist/server-bindings.d.ts +1 -26
  297. package/dist/server-data.d.ts +4 -5
  298. package/dist/sfc-template.d.ts +8 -8
  299. package/dist/signal-processing.d.ts +37 -53
  300. package/dist/signals-api.d.ts +58 -135
  301. package/dist/signals.d.ts +18 -24
  302. package/dist/site-url.d.ts +31 -28
  303. package/dist/slots.d.ts +20 -86
  304. package/dist/source-signature.d.ts +5 -28
  305. package/dist/ssg.d.ts +158 -337
  306. package/dist/ssg.js +2 -2
  307. package/dist/state-dir.d.ts +4 -4
  308. package/dist/store-loader.d.ts +0 -10
  309. package/dist/story/analytics.d.ts +60 -138
  310. package/dist/story/bookmarks.d.ts +34 -87
  311. package/dist/story/cli.d.ts +69 -123
  312. package/dist/story/collect/scanner.d.ts +0 -4
  313. package/dist/story/collect/tree.d.ts +1 -8
  314. package/dist/story/commands/build.d.ts +6 -11
  315. package/dist/story/commands/dev.d.ts +8 -15
  316. package/dist/story/commands/preview.d.ts +7 -13
  317. package/dist/story/config-watcher.d.ts +13 -20
  318. package/dist/story/config.d.ts +8 -11
  319. package/dist/story/context.d.ts +8 -14
  320. package/dist/story/hmr.d.ts +26 -24
  321. package/dist/story/hot-swap.d.ts +23 -34
  322. package/dist/story/keyboard-shortcuts.d.ts +18 -23
  323. package/dist/story/output.d.ts +44 -46
  324. package/dist/story/performance.d.ts +45 -107
  325. package/dist/story/presets.d.ts +41 -107
  326. package/dist/story/renderer.d.ts +27 -41
  327. package/dist/story/search.d.ts +12 -23
  328. package/dist/story/server.d.ts +11 -21
  329. package/dist/story/setup.d.ts +15 -23
  330. package/dist/story/testing.d.ts +40 -65
  331. package/dist/story/types.d.ts +160 -262
  332. package/dist/streaming.d.ts +57 -119
  333. package/dist/strip-literals.d.ts +1 -25
  334. package/dist/stx-module-imports.d.ts +7 -0
  335. package/dist/stx-virtual-ts.d.ts +102 -253
  336. package/dist/style-scoping.d.ts +8 -21
  337. package/dist/suspense.d.ts +52 -67
  338. package/dist/teleport.d.ts +0 -22
  339. package/dist/template-syntax-escape.d.ts +8 -8
  340. package/dist/template-tag-balance.d.ts +6 -22
  341. package/dist/testing.d.ts +26 -11
  342. package/dist/theme-tokens.d.ts +388 -134
  343. package/dist/transitions.d.ts +55 -66
  344. package/dist/ts-css-config.d.ts +12 -70
  345. package/dist/types/component-types.d.ts +122 -187
  346. package/dist/types/config-types.d.ts +341 -956
  347. package/dist/types/context-types.d.ts +24 -46
  348. package/dist/types/csp-types.d.ts +66 -70
  349. package/dist/types/directive-types.d.ts +156 -223
  350. package/dist/types/index.d.ts +110 -6
  351. package/dist/types/pwa-types.d.ts +148 -273
  352. package/dist/types.d.ts +1 -0
  353. package/dist/unresolved-identifiers.d.ts +22 -24
  354. package/dist/url-safety.d.ts +32 -32
  355. package/dist/utils.d.ts +21 -36
  356. package/dist/validator.d.ts +26 -28
  357. package/dist/variable-extractor.d.ts +19 -49
  358. package/dist/view-composers.d.ts +81 -80
  359. package/dist/virtual-scrolling.d.ts +82 -101
  360. package/dist/visual-testing.d.ts +10 -9
  361. package/dist/vue-template.d.ts +0 -23
  362. package/dist/web-components/css-scoping.d.ts +11 -21
  363. package/dist/web-components.d.ts +58 -81
  364. package/dist/x-element.d.ts +1 -0
  365. package/package.json +6 -6
  366. package/stx.d.ts +2 -2
  367. package/dist/app-service-worker.d.ts +0 -165
  368. package/dist/chunk-49gwmcrn.js +0 -2
  369. package/dist/chunk-6va5pe2m.js +0 -2
  370. package/dist/chunk-bm2q1srp.js +0 -2
  371. package/dist/signals-context-runtime.d.ts +0 -2
  372. package/dist/signals-drawer-runtime.d.ts +0 -2
  373. package/dist/signals-host-runtime.d.ts +0 -9
  374. package/dist/signals-loop-conditional-runtime.d.ts +0 -2
  375. package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
  376. package/dist/signals-notify-runtime.d.ts +0 -2
  377. package/dist/signals-optimistic-runtime.d.ts +0 -2
  378. package/dist/signals-overlay-runtime.d.ts +0 -2
  379. package/dist/signals-scope-disposal-runtime.d.ts +0 -2
  380. package/dist/signals-spa-load-control-runtime.d.ts +0 -2
  381. package/dist/signals-storage-runtime.d.ts +0 -2
@@ -1,37 +1,3 @@
1
- /**
2
- * Locate the real `<body>` open tag.
3
- *
4
- * Every consumer of this used to do `html.replace(/<body([^>]*)>/, ...)`, which
5
- * takes the FIRST match anywhere in the document — including inside a
6
- * `<style>` block, a `<script>`, or an HTML comment. Any of those can contain
7
- * the characters `<body` in prose without meaning a tag.
8
- *
9
- * When that happened the consequences were silent and total. The setup-wiring
10
- * step in process.ts stamps `data-stx="__stx_setup_…"` onto the body open tag,
11
- * and the runtime invokes a page's setup function by reading that attribute.
12
- * Stamp it into a CSS comment instead and the real `<body>` never gets it, so
13
- * the setup function ships, parses, and is never called: every `:if`,
14
- * `:hidden`, `@click` and `{{ signal() }}` on the page stays inert, with no
15
- * error anywhere. A single sentence in a CSS comment mentioning the body
16
- * element was enough to disable a whole site's interactivity.
17
- *
18
- * `runtime-injection.ts` has the same shape and a similar failure: it would
19
- * inject the signals runtime `<script>` INSIDE a `<style>` block, where it
20
- * never executes.
21
- *
22
- * This is the same class of bug as the unanchored `hasDocumentShell` check
23
- * fixed in stacksjs/stx#1792, whose reporter ended up writing a house rule
24
- * telling authors not to name the tag in prose. Authors should not need that
25
- * rule; scanning should skip regions that cannot contain markup.
26
- */
27
- export interface BodyTagMatch {
28
- /** Index of the `<` that opens the tag. */
29
- index: number;
30
- /** The full open tag, e.g. `<body class="x">`. */
31
- tag: string;
32
- /** The attribute text between `<body` and `>`, e.g. ` class="x"`. */
33
- attrs: string;
34
- }
35
1
  /**
36
2
  * Find the `<body>` open tag that is genuinely markup, skipping comments,
37
3
  * scripts and style blocks.
@@ -48,3 +14,8 @@ export declare function hasBodyOpenTag(html: string): boolean;
48
14
  * @returns the html unchanged when there is no real body tag
49
15
  */
50
16
  export declare function replaceBodyOpenTag(html: string, replacer: (tag: string, attrs: string) => string): string;
17
+ export declare interface BodyTagMatch {
18
+ index: number
19
+ tag: string
20
+ attrs: string
21
+ }
@@ -1,24 +1 @@
1
- /**
2
- * Where the first script that can run sits in a rendered document.
3
- *
4
- * The signals runtime has to execute before every other script on the page,
5
- * so both places that position it -- `injectSignalsRuntime` when it first
6
- * goes in, and the relocation at the end of `processDirectives` -- insert it
7
- * at the offset this returns.
8
- *
9
- * "First `<script`" is not the same thing as "first script that runs". A
10
- * script inside a `<template>` is inert: it is template CONTENT, and executes
11
- * only if something clones it into the document later. A runtime placed there
12
- * never runs at all, so nothing defines `window.stx` and every page script
13
- * dies on its first line. That is exactly what a bare layout produced: with no
14
- * `<head>` script to anchor to, the first `<script` in the document was the
15
- * one inside a component's `<template :if>`, and the runtime went in beside it
16
- * (the Stacks `/login` page rendered blank with "Cannot destructure property
17
- * 'navigate' of 'window.stx'").
18
- *
19
- * So a `<template>` is treated as one opaque unit. A script found inside one
20
- * resolves to the start of the OUTERMOST enclosing template: ahead of that
21
- * unit, the runtime still precedes everything in it and everything after it,
22
- * and it is in the live document where it executes.
23
- */
24
1
  export declare function findFirstScriptTag(html: string): number;
@@ -1,151 +1,4 @@
1
- /**
2
- * STX Form Validation
3
- *
4
- * A simple, chainable form validation API.
5
- *
6
- * @example
7
- * ```typescript
8
- * import { useForm, v } from 'stx'
9
- *
10
- * const form = useForm({
11
- * email: v.required().email(),
12
- * password: v.required().min(8),
13
- * age: v.number().between(18, 100)
14
- * })
15
- * ```
16
- */
17
- type ValidatorFn = (value: unknown, formValues?: Record<string, unknown>) => true | string;
18
- type AsyncValidatorFn = (value: unknown, formValues?: Record<string, unknown>) => Promise<true | string>;
19
- interface ValidatorRule {
20
- name: string;
21
- validate: ValidatorFn | AsyncValidatorFn;
22
- message: string;
23
- async?: boolean;
24
- }
25
- interface FieldState {
26
- value: unknown;
27
- errors: string[];
28
- touched: boolean;
29
- dirty: boolean;
30
- valid: boolean;
31
- validating: boolean;
32
- }
33
- interface FormState<T extends Record<string, Validator>> {
34
- values: {
35
- [K in keyof T]: unknown;
36
- };
37
- errors: {
38
- [K in keyof T]: string[];
39
- };
40
- touched: {
41
- [K in keyof T]: boolean;
42
- };
43
- dirty: {
44
- [K in keyof T]: boolean;
45
- };
46
- isValid: boolean;
47
- isValidating: boolean;
48
- isDirty: boolean;
49
- validate: () => Promise<boolean>;
50
- validateField: (field: keyof T) => Promise<boolean>;
51
- reset: () => void;
52
- setValues: (values: Partial<{
53
- [K in keyof T]: unknown;
54
- }>) => void;
55
- setFieldValue: (field: keyof T, value: unknown) => void;
56
- setFieldTouched: (field: keyof T, touched?: boolean) => void;
57
- getFieldState: (field: keyof T) => FieldState;
58
- handleSubmit: (onSubmit: (values: {
59
- [K in keyof T]: unknown;
60
- }) => void | Promise<void>) => (e?: Event) => Promise<void>;
61
- }
62
- declare class Validator {
63
- private rules;
64
- private defaultValue;
65
- private addRule;
66
- /** Field is required */
67
- required(message?: string): Validator;
68
- /** Must be a valid email */
69
- email(message?: string): Validator;
70
- /** Must be a valid URL */
71
- url(message?: string): Validator;
72
- /** Minimum length */
73
- min(length: number, message?: string): Validator;
74
- /** Maximum length */
75
- max(length: number, message?: string): Validator;
76
- /** Length between min and max */
77
- length(min: number, max: number, message?: string): Validator;
78
- /** Must match a regex pattern */
79
- pattern(regex: RegExp, message?: string): Validator;
80
- /** Must contain uppercase letter */
81
- hasUppercase(message?: string): Validator;
82
- /** Must contain lowercase letter */
83
- hasLowercase(message?: string): Validator;
84
- /** Must contain a number */
85
- hasNumber(message?: string): Validator;
86
- /** Must contain a special character */
87
- hasSpecial(message?: string): Validator;
88
- /** Only alphanumeric characters */
89
- alphanumeric(message?: string): Validator;
90
- /** Must start with a letter */
91
- startsWithLetter(message?: string): Validator;
92
- /** No spaces allowed */
93
- noSpaces(message?: string): Validator;
94
- /** Must be a number */
95
- number(message?: string): Validator;
96
- /** Must be an integer */
97
- integer(message?: string): Validator;
98
- /** Must be positive */
99
- positive(message?: string): Validator;
100
- /** Must be negative */
101
- negative(message?: string): Validator;
102
- /** Minimum value */
103
- minValue(min: number, message?: string): Validator;
104
- /** Maximum value */
105
- maxValue(max: number, message?: string): Validator;
106
- /** Value between min and max */
107
- between(min: number, max: number, message?: string): Validator;
108
- /** Must match another field's value */
109
- matches(fieldName: string, message?: string): Validator;
110
- /** Must be one of the given values */
111
- oneOf(values: unknown[], message?: string): Validator;
112
- /** Must not be one of the given values */
113
- notOneOf(values: unknown[], message?: string): Validator;
114
- /** Must be a valid date */
115
- date(message?: string): Validator;
116
- /** Must be before a date */
117
- before(date: Date | string, message?: string): Validator;
118
- /** Must be after a date */
119
- after(date: Date | string, message?: string): Validator;
120
- /** Custom validation function */
121
- custom(fn: ValidatorFn, message?: string): Validator;
122
- /** Async custom validation (e.g., API check) */
123
- async(fn: AsyncValidatorFn, message?: string): Validator;
124
- /** Conditional validation */
125
- when(condition: (value: unknown, formValues: Record<string, unknown>) => boolean, thenValidator: Validator): Validator;
126
- /** Get all rules */
127
- getRules(): ValidatorRule[];
128
- /** Get default value for this validator */
129
- getDefaultValue(): unknown;
130
- /** Set default value */
131
- default(value: unknown): Validator;
132
- /** Validate a value */
133
- validate(value: unknown, formValues?: Record<string, unknown>): Promise<string[]>;
134
- /** Validate synchronously (ignores async rules) */
135
- validateSync(value: unknown, formValues?: Record<string, unknown>): string[];
136
- }
137
- /**
138
- * Starting point for building validation rules.
139
- *
140
- * @example
141
- * ```typescript
142
- * v.required().email()
143
- * v.required().min(8).hasUppercase()
144
- * v.number().between(1, 100)
145
- * ```
146
- */
147
- export declare const v: Validator;
148
- export { defineForm, useForm } from './composables/use-form';
1
+ export type { ValidatorFn, AsyncValidatorFn, ValidatorRule, FieldState, FormState };
149
2
  /**
150
3
  * Process @error directive in templates
151
4
  *
@@ -185,5 +38,120 @@ export declare function processHasErrorsDirective(content: string, context: Reco
185
38
  * Process all form validation directives
186
39
  */
187
40
  export declare function processFormValidationDirectives(content: string, context: Record<string, unknown>, filePath?: string): string;
41
+ /**
42
+ * Starting point for building validation rules.
43
+ *
44
+ * @example
45
+ * ```typescript
46
+ * v.required().email()
47
+ * v.required().min(8).hasUppercase()
48
+ * v.number().between(1, 100)
49
+ * ```
50
+ */
51
+ export declare const v: Validator;
52
+ declare interface ValidatorRule {
53
+ name: string
54
+ validate: ValidatorFn | AsyncValidatorFn
55
+ message: string
56
+ async?: boolean
57
+ }
58
+ declare interface FieldState {
59
+ value: unknown
60
+ errors: string[]
61
+ touched: boolean
62
+ dirty: boolean
63
+ valid: boolean
64
+ validating: boolean
65
+ }
66
+ declare interface FormState<T extends Record<string, Validator>> {
67
+ values: { [K in keyof T]: unknown }
68
+ errors: { [K in keyof T]: string[] }
69
+ touched: { [K in keyof T]: boolean }
70
+ dirty: { [K in keyof T]: boolean }
71
+ isValid: boolean
72
+ isValidating: boolean
73
+ isDirty: boolean
74
+ validate: () => Promise<boolean>
75
+ validateField: (field: keyof T) => Promise<boolean>
76
+ reset: () => void
77
+ setValues: (values: Partial<{ [K in keyof T]: unknown }>) => void
78
+ setFieldValue: (field: keyof T, value: unknown) => void
79
+ setFieldTouched: (field: keyof T, touched?: boolean) => void
80
+ getFieldState: (field: keyof T) => FieldState
81
+ handleSubmit: (onSubmit: (values: { [K in keyof T]: unknown }) => void | Promise<void>) => (e?: Event) => Promise<void>
82
+ }
83
+ /**
84
+ * STX Form Validation
85
+ *
86
+ * A simple, chainable form validation API.
87
+ *
88
+ * @example
89
+ * ```typescript
90
+ * import { useForm, v } from 'stx'
91
+ *
92
+ * const form = useForm({
93
+ * email: v.required().email(),
94
+ * password: v.required().min(8),
95
+ * age: v.number().between(18, 100)
96
+ * })
97
+ * ```
98
+ */
99
+ // =============================================================================
100
+ // Types
101
+ // =============================================================================
102
+ // eslint-disable-next-line pickier/no-unused-vars
103
+ declare type ValidatorFn = (value: unknown, formValues?: Record<string, unknown>) => true | string;
104
+ // eslint-disable-next-line pickier/no-unused-vars
105
+ declare type AsyncValidatorFn = (value: unknown, formValues?: Record<string, unknown>) => Promise<true | string>;
106
+ // =============================================================================
107
+ // Validator Class
108
+ // =============================================================================
109
+ declare class Validator {
110
+ required(message?: string): Validator;
111
+ email(message?: string): Validator;
112
+ url(message?: string): Validator;
113
+ min(length: number, message?: string): Validator;
114
+ max(length: number, message?: string): Validator;
115
+ length(min: number, max: number, message?: string): Validator;
116
+ pattern(regex: RegExp, message?: string): Validator;
117
+ hasUppercase(message?: string): Validator;
118
+ hasLowercase(message?: string): Validator;
119
+ hasNumber(message?: string): Validator;
120
+ hasSpecial(message?: string): Validator;
121
+ alphanumeric(message?: string): Validator;
122
+ startsWithLetter(message?: string): Validator;
123
+ noSpaces(message?: string): Validator;
124
+ number(message?: string): Validator;
125
+ integer(message?: string): Validator;
126
+ positive(message?: string): Validator;
127
+ negative(message?: string): Validator;
128
+ minValue(min: number, message?: string): Validator;
129
+ maxValue(max: number, message?: string): Validator;
130
+ between(min: number, max: number, message?: string): Validator;
131
+ matches(fieldName: string, message?: string): Validator;
132
+ oneOf(values: unknown[], message?: string): Validator;
133
+ notOneOf(values: unknown[], message?: string): Validator;
134
+ date(message?: string): Validator;
135
+ before(date: Date | string, message?: string): Validator;
136
+ after(date: Date | string, message?: string): Validator;
137
+ custom(fn: ValidatorFn, message?: string): Validator;
138
+ when(condition: (value: unknown, formValues: Record<string, unknown>) => boolean, thenValidator: Validator): Validator;
139
+ getRules(): ValidatorRule[];
140
+ getDefaultValue(): unknown;
141
+ default(value: unknown): Validator;
142
+ validate(value: unknown, formValues?: Record<string, unknown>): Promise<string[]>;
143
+ validateSync(value: unknown, formValues?: Record<string, unknown>): string[];
144
+ }
145
+ // =============================================================================
146
+ // Form Definition
147
+ // =============================================================================
148
+ // useForm (formerly defineForm, renamed in #1843) and its signal-backed record
149
+ // now live in composables/use-form.ts,
150
+ // so the framework-composables demand-bundler can ship them to a <script client>
151
+ // block (#1846). Re-exported here because this module is the documented import
152
+ // path (`import { useForm } from 'stx'` resolves through index.ts -> here).
153
+ export { defineForm, useForm } from './composables/use-form';
154
+ // =============================================================================
155
+ // Re-exports
156
+ // =============================================================================
188
157
  export { Validator };
189
- export type { ValidatorFn, AsyncValidatorFn, ValidatorRule, FieldState, FormState };
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
  /**