@stacksjs/stx 0.2.571 → 0.2.573

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (382) hide show
  1. package/dist/a11y.d.ts +51 -111
  2. package/dist/animation.d.ts +131 -74
  3. package/dist/api-client.d.ts +11 -21
  4. package/dist/api-handler.d.ts +4 -4
  5. package/dist/appearance-bootstrap.d.ts +16 -77
  6. package/dist/application-layers.d.ts +11 -20
  7. package/dist/asset-roots.d.ts +7 -27
  8. package/dist/assets.d.ts +7 -9
  9. package/dist/async-components.d.ts +56 -78
  10. package/dist/auth.d.ts +0 -3
  11. package/dist/browser-core-imports.d.ts +2 -2
  12. package/dist/build-externalize-repeated.d.ts +0 -25
  13. package/dist/build-externalize.d.ts +18 -53
  14. package/dist/build-id.d.ts +40 -28
  15. package/dist/build-message.d.ts +20 -44
  16. package/dist/builtins/attrs.d.ts +0 -14
  17. package/dist/builtins/drawer.d.ts +3 -22
  18. package/dist/builtins/icon.d.ts +17 -19
  19. package/dist/builtins/image-alpha.d.ts +8 -8
  20. package/dist/builtins/image-delivery.d.ts +38 -40
  21. package/dist/builtins/image-placeholder.d.ts +12 -50
  22. package/dist/builtins/image-warmup-worker.d.ts +1 -1
  23. package/dist/builtins/image-worker.d.ts +6 -32
  24. package/dist/builtins/index.d.ts +16 -6
  25. package/dist/builtins/modal.d.ts +13 -23
  26. package/dist/builtins/safe-image.d.ts +2 -42
  27. package/dist/builtins/stx-image.d.ts +44 -24
  28. package/dist/builtins/stx-link.d.ts +5 -8
  29. package/dist/builtins/stx-loading-indicator.d.ts +11 -10
  30. package/dist/builtins/suspense.d.ts +6 -27
  31. package/dist/builtins/toast.d.ts +15 -16
  32. package/dist/builtins/transition-group.d.ts +1 -25
  33. package/dist/caching.d.ts +24 -21
  34. package/dist/{chunk-f4jh9vrj.js → chunk-0s647d0b.js} +53 -53
  35. package/dist/{chunk-09gtbb1w.js → chunk-1bsafdnt.js} +1 -1
  36. package/dist/{chunk-m6mxqepz.js → chunk-1btr5tme.js} +1 -1
  37. package/dist/{chunk-01mxer9s.js → chunk-2g6wcnna.js} +1 -1
  38. package/dist/{chunk-rrj5m9xv.js → chunk-2hg2bqtj.js} +1 -1
  39. package/dist/{chunk-xckzvbvn.js → chunk-4f0fh2a9.js} +1 -1
  40. package/dist/chunk-557wtdps.js +2 -0
  41. package/dist/{chunk-vr36s2en.js → chunk-58vrf6kh.js} +1 -1
  42. package/dist/{chunk-qzbzn1yf.js → chunk-6tsnz28m.js} +1 -1
  43. package/dist/{chunk-cvswrbzw.js → chunk-6x8cwscv.js} +1 -1
  44. package/dist/{chunk-1n64749x.js → chunk-74ew8ajw.js} +1 -1
  45. package/dist/{chunk-jqefcghh.js → chunk-78d6yyxz.js} +2 -2
  46. package/dist/{chunk-83fdt4yj.js → chunk-824cnbac.js} +1 -1
  47. package/dist/{chunk-ntgy4e1q.js → chunk-864xm0jy.js} +1 -1
  48. package/dist/{chunk-nn174xjh.js → chunk-9fbkdrm8.js} +1 -1
  49. package/dist/{chunk-kzjrgh0b.js → chunk-a3gvw1q2.js} +1 -1
  50. package/dist/{chunk-pqcvh9pp.js → chunk-amtrg7pn.js} +1 -1
  51. package/dist/{chunk-pw9verqx.js → chunk-b5fpsp5n.js} +1 -1
  52. package/dist/{chunk-5afw7z6v.js → chunk-bcjr3fw7.js} +1 -1
  53. package/dist/{chunk-n6qp05t9.js → chunk-bkj0j5se.js} +1 -1
  54. package/dist/{chunk-mzqyv7s5.js → chunk-cf97xdqa.js} +1 -1
  55. package/dist/{chunk-cgwyd9aq.js → chunk-cr67dpx4.js} +1 -1
  56. package/dist/{chunk-f1apaqfk.js → chunk-dpqvacd1.js} +1 -1
  57. package/dist/{chunk-ghy82tsc.js → chunk-et8726at.js} +1 -1
  58. package/dist/{chunk-4bgfpkwx.js → chunk-ev8t5cxk.js} +1 -1
  59. package/dist/{chunk-4ssg5xpq.js → chunk-fynh3bkq.js} +12 -2
  60. package/dist/{chunk-gzgc8zk5.js → chunk-g8757f97.js} +2 -2
  61. package/dist/{chunk-3gft8zng.js → chunk-hm4j4d8q.js} +1 -1
  62. package/dist/{chunk-0bt0fbs1.js → chunk-j9qy9t3t.js} +5 -5
  63. package/dist/{chunk-2a1q5y6r.js → chunk-jhc47xzj.js} +1 -1
  64. package/dist/{chunk-79vdkvhf.js → chunk-kns5m52j.js} +1 -1
  65. package/dist/{chunk-2cqbyb8w.js → chunk-mjpewk4r.js} +1 -1
  66. package/dist/{chunk-2jjff8kv.js → chunk-nj488tj2.js} +2 -2
  67. package/dist/{chunk-dcpf6kas.js → chunk-q9chv68c.js} +1 -1
  68. package/dist/{chunk-xq2ck69k.js → chunk-qm280dp3.js} +1 -1
  69. package/dist/{chunk-ymawe0y5.js → chunk-sjcstv33.js} +1 -1
  70. package/dist/{chunk-tc5r2vmw.js → chunk-t0zdz8kd.js} +1 -1
  71. package/dist/{chunk-jwvzvapp.js → chunk-t3dnak1j.js} +1 -1
  72. package/dist/{chunk-2jsnrfc8.js → chunk-t64nnmmj.js} +1 -1
  73. package/dist/{chunk-m2a1fxpb.js → chunk-tvb8p7c0.js} +1 -1
  74. package/dist/{chunk-6f4qrd0s.js → chunk-tyhgq6rw.js} +1 -1
  75. package/dist/{chunk-4wfr074d.js → chunk-vn7tc8hm.js} +1 -1
  76. package/dist/{chunk-y4ajd836.js → chunk-xy6g8zb9.js} +1 -1
  77. package/dist/{chunk-zddzjd60.js → chunk-ya7xks9t.js} +1 -1
  78. package/dist/chunk-zpz6q2fh.js +2 -0
  79. package/dist/chunk-zxt94g45.js +2 -0
  80. package/dist/{chunk-cyg9w31a.js → chunk-zz7tw07b.js} +1 -1
  81. package/dist/{chunk-ta8bhz27.js → chunk-zzcxacjf.js} +1 -1
  82. package/dist/cli.js +7 -7
  83. package/dist/client/directive.d.ts +0 -7
  84. package/dist/client/index.d.ts +1 -0
  85. package/dist/client/signals-appearance-runtime.d.ts +1 -1
  86. package/dist/client/signals-binding-utils-runtime.d.ts +1 -1
  87. package/dist/client/signals-bootstrap-runtime.d.ts +2 -2
  88. package/dist/client/signals-class-runtime.d.ts +1 -1
  89. package/dist/client/signals-component-api-runtime.d.ts +1 -1
  90. package/dist/client/signals-component-hydration-runtime.d.ts +1 -1
  91. package/dist/client/signals-component-props-runtime.d.ts +1 -1
  92. package/dist/client/signals-conditional-chain-runtime.d.ts +1 -1
  93. package/dist/client/signals-conditional-component-runtime.d.ts +1 -1
  94. package/dist/client/signals-container-cleanup-runtime.d.ts +1 -1
  95. package/dist/client/signals-context-runtime.d.ts +1 -1
  96. package/dist/client/signals-cookie-runtime.d.ts +1 -1
  97. package/dist/client/signals-devtools-runtime.d.ts +1 -1
  98. package/dist/client/signals-dialog-runtime.d.ts +1 -1
  99. package/dist/client/signals-dom-ready-runtime.d.ts +1 -1
  100. package/dist/client/signals-drawer-runtime.d.ts +1 -1
  101. package/dist/client/signals-effect-runtime.d.ts +1 -1
  102. package/dist/client/signals-event-shorthand-runtime.d.ts +1 -1
  103. package/dist/client/signals-expression-compiler-runtime.d.ts +1 -1
  104. package/dist/client/signals-expression-runtime.d.ts +1 -1
  105. package/dist/client/signals-fetch-transport-runtime.d.ts +1 -1
  106. package/dist/client/signals-for-runtime.d.ts +1 -1
  107. package/dist/client/signals-globals-runtime.d.ts +1 -1
  108. package/dist/client/signals-handler-runtime.d.ts +1 -1
  109. package/dist/client/signals-head-runtime.d.ts +1 -1
  110. package/dist/client/signals-helpers-runtime.d.ts +1 -1
  111. package/dist/client/signals-host-runtime.d.ts +1 -1
  112. package/dist/client/signals-hydration-audit-runtime.d.ts +1 -1
  113. package/dist/client/signals-hydration-runtime.d.ts +1 -1
  114. package/dist/client/signals-if-chain-runtime.d.ts +1 -1
  115. package/dist/client/signals-if-runtime.d.ts +1 -1
  116. package/dist/client/signals-lazy-hydration-runtime.d.ts +1 -1
  117. package/dist/client/signals-lifecycle-runtime.d.ts +1 -1
  118. package/dist/client/signals-loop-component-remap-runtime.d.ts +1 -1
  119. package/dist/client/signals-loop-conditional-runtime.d.ts +1 -1
  120. package/dist/client/signals-loop-row-runtime.d.ts +1 -1
  121. package/dist/client/signals-manifest-hydration-runtime.d.ts +1 -1
  122. package/dist/client/signals-model-runtime.d.ts +1 -1
  123. package/dist/client/signals-mount-runtime.d.ts +1 -1
  124. package/dist/client/signals-navigation-runtime.d.ts +1 -1
  125. package/dist/client/signals-notify-runtime.d.ts +1 -1
  126. package/dist/client/signals-optimistic-runtime.d.ts +1 -1
  127. package/dist/client/signals-overlay-runtime.d.ts +1 -1
  128. package/dist/client/signals-pipe-runtime.d.ts +1 -1
  129. package/dist/client/signals-proxy-runtime.d.ts +1 -1
  130. package/dist/client/signals-query-runtime.d.ts +1 -1
  131. package/dist/client/signals-reactive-runtime.d.ts +1 -1
  132. package/dist/client/signals-ref-runtime.d.ts +1 -1
  133. package/dist/client/signals-scope-disposal-runtime.d.ts +1 -1
  134. package/dist/client/signals-scope-traversal-runtime.d.ts +1 -1
  135. package/dist/client/signals-show-runtime.d.ts +1 -1
  136. package/dist/client/signals-spa-load-control-runtime.d.ts +1 -1
  137. package/dist/client/signals-spa-load-runtime.d.ts +1 -1
  138. package/dist/client/signals-state-runtime.d.ts +1 -1
  139. package/dist/client/signals-storage-runtime.d.ts +1 -1
  140. package/dist/client/signals-store-registry-runtime.d.ts +1 -1
  141. package/dist/client/signals-style-runtime.d.ts +1 -1
  142. package/dist/client/signals-suspense-runtime.d.ts +1 -1
  143. package/dist/client/signals-timer-runtime.d.ts +1 -1
  144. package/dist/client/signals-toast-runtime.d.ts +1 -1
  145. package/dist/client/signals-tooltip-runtime.d.ts +1 -1
  146. package/dist/client/signals-transition-group-runtime.d.ts +1 -1
  147. package/dist/client/signals-websocket-runtime.d.ts +1 -1
  148. package/dist/client-helpers.d.ts +1 -312
  149. package/dist/client-module-registry.d.ts +4 -27
  150. package/dist/client-parameter-bindings.d.ts +1 -4
  151. package/dist/client-script-bundler.d.ts +55 -103
  152. package/dist/client-script.d.ts +69 -127
  153. package/dist/color-mode-boot.d.ts +21 -58
  154. package/dist/component-client-factories.d.ts +8 -9
  155. package/dist/component-contract-checks.d.ts +15 -18
  156. package/dist/component-contract.d.ts +6 -6
  157. package/dist/component-hmr.d.ts +8 -7
  158. package/dist/component-model.d.ts +14 -20
  159. package/dist/component-processing.d.ts +51 -59
  160. package/dist/component-registry.d.ts +28 -99
  161. package/dist/component-renderer.d.ts +19 -16
  162. package/dist/component-resolution.d.ts +8 -8
  163. package/dist/component-tags.d.ts +1 -1
  164. package/dist/composable-loader.d.ts +6 -41
  165. package/dist/composables/use-fetch.d.ts +45 -114
  166. package/dist/composables/use-form.d.ts +2 -56
  167. package/dist/composables/use-intersection-observer.d.ts +1 -1
  168. package/dist/composables.d.ts +75 -74
  169. package/dist/composition-api.d.ts +19 -43
  170. package/dist/computed.d.ts +93 -86
  171. package/dist/conditionals.d.ts +0 -24
  172. package/dist/config.d.ts +30 -24
  173. package/dist/config.js +3 -0
  174. package/dist/craft-bridge.d.ts +1 -467
  175. package/dist/craft-components.d.ts +234 -680
  176. package/dist/craft-entry.js +1 -1
  177. package/dist/craft.js +1 -1
  178. package/dist/csp.d.ts +41 -107
  179. package/dist/database.d.ts +1 -1
  180. package/dist/defer.d.ts +0 -24
  181. package/dist/dev-server/terminal-colors.d.ts +32 -32
  182. package/dist/dev-server/ts-css.d.ts +26 -35
  183. package/dist/dev-server/types.d.ts +33 -29
  184. package/dist/directive-api.d.ts +42 -85
  185. package/dist/directive-arguments.d.ts +14 -39
  186. package/dist/document-shell.d.ts +49 -81
  187. package/dist/dynamic-components.d.ts +0 -9
  188. package/dist/engine-bindings.d.ts +1 -1
  189. package/dist/env.d.ts +26 -0
  190. package/dist/error-boundaries.d.ts +36 -43
  191. package/dist/error-handling.d.ts +1 -1
  192. package/dist/errors/codes.d.ts +43 -51
  193. package/dist/errors/formatter.d.ts +38 -58
  194. package/dist/errors/index.d.ts +61 -5
  195. package/dist/errors/logger.d.ts +40 -114
  196. package/dist/errors/sanitizer.d.ts +28 -53
  197. package/dist/errors/types.d.ts +31 -44
  198. package/dist/events.d.ts +32 -94
  199. package/dist/expressions.d.ts +57 -62
  200. package/dist/find-body-tag.d.ts +5 -34
  201. package/dist/first-script-tag.d.ts +0 -23
  202. package/dist/forms-validation.d.ts +117 -149
  203. package/dist/forms.d.ts +161 -120
  204. package/dist/framework-composables.d.ts +0 -32
  205. package/dist/head-injection.d.ts +30 -32
  206. package/dist/head-keys.d.ts +12 -15
  207. package/dist/head.d.ts +110 -139
  208. package/dist/heatmap.d.ts +76 -152
  209. package/dist/html-masking.d.ts +38 -62
  210. package/dist/hydration-runtime.d.ts +24 -20
  211. package/dist/hydration.d.ts +11 -10
  212. package/dist/i18n.d.ts +34 -95
  213. package/dist/image-optimization/auto-sibling.d.ts +4 -32
  214. package/dist/imported-signals.d.ts +0 -36
  215. package/dist/includes.d.ts +6 -69
  216. package/dist/index.d.ts +2 -1
  217. package/dist/init.d.ts +12 -20
  218. package/dist/internal-markdown.d.ts +8 -12
  219. package/dist/interpolation-context.d.ts +15 -15
  220. package/dist/island-chunking.d.ts +13 -30
  221. package/dist/keep-alive.d.ts +52 -72
  222. package/dist/layout-types.d.ts +2 -27
  223. package/dist/lazy-module.d.ts +0 -10
  224. package/dist/loading-indicator.d.ts +8 -5
  225. package/dist/loop-binding.d.ts +4 -7
  226. package/dist/loops.d.ts +25 -67
  227. package/dist/markdown.d.ts +1 -0
  228. package/dist/media/image/component.d.ts +9 -25
  229. package/dist/media/image/directive.d.ts +1 -15
  230. package/dist/media/image/placeholder.d.ts +9 -20
  231. package/dist/media/image/processor/cache.d.ts +18 -40
  232. package/dist/media/image/processor/index.d.ts +10 -1
  233. package/dist/media/image/processor/optimizer.d.ts +1 -12
  234. package/dist/media/image/processor/responsive.d.ts +6 -16
  235. package/dist/media/image/srcset.d.ts +49 -47
  236. package/dist/media/shared/cache.d.ts +31 -51
  237. package/dist/media/shared/hash.d.ts +0 -7
  238. package/dist/media/types.d.ts +754 -1235
  239. package/dist/media/video/directive.d.ts +1 -15
  240. package/dist/media/video/index.d.ts +17 -39
  241. package/dist/media/video/processor/cache.d.ts +19 -42
  242. package/dist/media/video/processor/index.d.ts +18 -1
  243. package/dist/media/video/processor/streaming.d.ts +10 -17
  244. package/dist/media/video/processor/thumbnail.d.ts +15 -21
  245. package/dist/media/video/processor/transcoder.d.ts +1 -11
  246. package/dist/meta-arguments.d.ts +14 -39
  247. package/dist/method-spoofing.d.ts +0 -7
  248. package/dist/middleware.d.ts +0 -60
  249. package/dist/native/bridge/protocol.d.ts +2 -1
  250. package/dist/native/compiler/bundle.js +11 -1
  251. package/dist/native/compiler/headwind-to-style.d.ts +383 -359
  252. package/dist/native/compiler/icons.d.ts +249 -243
  253. package/dist/native/compiler/svg.d.ts +35 -24
  254. package/dist/native/runtime/jsc-globals.d.ts +1 -1
  255. package/dist/native/runtime/native-host.d.ts +1 -1
  256. package/dist/native/runtime/native-host.js +3 -0
  257. package/dist/offline/app-service-worker.d.ts +50 -114
  258. package/dist/offline/kept-store.d.ts +23 -37
  259. package/dist/offline/query-cache.d.ts +55 -126
  260. package/dist/owned-routes.d.ts +0 -31
  261. package/dist/page-response.d.ts +8 -39
  262. package/dist/parser/directive-parser.d.ts +45 -57
  263. package/dist/parser/expression-parser.d.ts +35 -33
  264. package/dist/parser/index.d.ts +39 -4
  265. package/dist/parser/tokenizer.d.ts +49 -61
  266. package/dist/partial-hydration.d.ts +51 -82
  267. package/dist/performance-utils.d.ts +115 -255
  268. package/dist/placeholder.d.ts +9 -18
  269. package/dist/plugin-system.d.ts +115 -264
  270. package/dist/process.d.ts +4 -9
  271. package/dist/process.js +6 -4
  272. package/dist/prop-sentinels.d.ts +11 -11
  273. package/dist/public-env.d.ts +0 -14
  274. package/dist/pwa/directives.d.ts +20 -12
  275. package/dist/pwa/inject.d.ts +0 -10
  276. package/dist/pwa/precache.d.ts +16 -22
  277. package/dist/pwa/service-worker.d.ts +0 -12
  278. package/dist/pwa.js +1 -1
  279. package/dist/reactive-bindings.d.ts +11 -34
  280. package/dist/reactive-tracking.d.ts +0 -36
  281. package/dist/reactive.d.ts +41 -58
  282. package/dist/render-memo.d.ts +5 -23
  283. package/dist/resolve-stx-targets.d.ts +6 -44
  284. package/dist/route-middleware.d.ts +35 -2
  285. package/dist/route-rules.d.ts +10 -13
  286. package/dist/router.d.ts +9 -8
  287. package/dist/routes.d.ts +3 -1
  288. package/dist/runtime-config-server.d.ts +14 -17
  289. package/dist/runtime-config.d.ts +2 -3
  290. package/dist/runtime-globals.d.ts +90 -122
  291. package/dist/runtime-injection.d.ts +0 -8
  292. package/dist/scaffolding.d.ts +30 -26
  293. package/dist/script-emit.d.ts +0 -30
  294. package/dist/script-validation.d.ts +6 -12
  295. package/dist/seo.d.ts +75 -153
  296. package/dist/server-api.d.ts +9 -12
  297. package/dist/server-bindings.d.ts +1 -26
  298. package/dist/server-data.d.ts +4 -5
  299. package/dist/sfc-template.d.ts +8 -8
  300. package/dist/signal-processing.d.ts +37 -53
  301. package/dist/signals-api.d.ts +58 -135
  302. package/dist/signals.d.ts +18 -24
  303. package/dist/site-url.d.ts +31 -28
  304. package/dist/slots.d.ts +20 -86
  305. package/dist/source-signature.d.ts +5 -28
  306. package/dist/ssg.d.ts +158 -337
  307. package/dist/ssg.js +2 -2
  308. package/dist/state-dir.d.ts +4 -4
  309. package/dist/store-loader.d.ts +0 -10
  310. package/dist/story/analytics.d.ts +60 -138
  311. package/dist/story/bookmarks.d.ts +34 -87
  312. package/dist/story/cli.d.ts +69 -123
  313. package/dist/story/collect/scanner.d.ts +0 -4
  314. package/dist/story/collect/tree.d.ts +1 -8
  315. package/dist/story/commands/build.d.ts +6 -11
  316. package/dist/story/commands/dev.d.ts +8 -15
  317. package/dist/story/commands/preview.d.ts +7 -13
  318. package/dist/story/config-watcher.d.ts +13 -20
  319. package/dist/story/config.d.ts +8 -11
  320. package/dist/story/context.d.ts +8 -14
  321. package/dist/story/hmr.d.ts +26 -24
  322. package/dist/story/hot-swap.d.ts +23 -34
  323. package/dist/story/keyboard-shortcuts.d.ts +18 -23
  324. package/dist/story/output.d.ts +44 -46
  325. package/dist/story/performance.d.ts +45 -107
  326. package/dist/story/presets.d.ts +41 -107
  327. package/dist/story/renderer.d.ts +27 -41
  328. package/dist/story/search.d.ts +12 -23
  329. package/dist/story/server.d.ts +11 -21
  330. package/dist/story/setup.d.ts +15 -23
  331. package/dist/story/testing.d.ts +40 -65
  332. package/dist/story/types.d.ts +160 -262
  333. package/dist/streaming.d.ts +57 -119
  334. package/dist/strip-literals.d.ts +1 -25
  335. package/dist/stx-module-imports.d.ts +7 -0
  336. package/dist/stx-virtual-ts.d.ts +102 -253
  337. package/dist/style-scoping.d.ts +8 -21
  338. package/dist/suspense.d.ts +52 -67
  339. package/dist/teleport.d.ts +0 -22
  340. package/dist/template-syntax-escape.d.ts +8 -8
  341. package/dist/template-tag-balance.d.ts +6 -22
  342. package/dist/testing.d.ts +26 -11
  343. package/dist/theme-tokens.d.ts +388 -134
  344. package/dist/transitions.d.ts +55 -66
  345. package/dist/ts-css-config.d.ts +12 -70
  346. package/dist/types/component-types.d.ts +122 -187
  347. package/dist/types/config-types.d.ts +341 -956
  348. package/dist/types/context-types.d.ts +24 -46
  349. package/dist/types/csp-types.d.ts +66 -70
  350. package/dist/types/directive-types.d.ts +156 -223
  351. package/dist/types/index.d.ts +110 -6
  352. package/dist/types/pwa-types.d.ts +148 -273
  353. package/dist/types.d.ts +1 -0
  354. package/dist/unresolved-identifiers.d.ts +22 -24
  355. package/dist/url-safety.d.ts +32 -32
  356. package/dist/utils.d.ts +21 -36
  357. package/dist/validator.d.ts +26 -28
  358. package/dist/variable-extractor.d.ts +19 -49
  359. package/dist/view-composers.d.ts +81 -80
  360. package/dist/virtual-scrolling.d.ts +82 -101
  361. package/dist/visual-testing.d.ts +10 -9
  362. package/dist/vue-template.d.ts +0 -23
  363. package/dist/web-components/css-scoping.d.ts +11 -21
  364. package/dist/web-components.d.ts +58 -81
  365. package/dist/x-element.d.ts +1 -0
  366. package/package.json +6 -6
  367. package/stx.d.ts +2 -2
  368. package/dist/app-service-worker.d.ts +0 -165
  369. package/dist/chunk-49gwmcrn.js +0 -2
  370. package/dist/chunk-6va5pe2m.js +0 -2
  371. package/dist/chunk-bm2q1srp.js +0 -2
  372. package/dist/signals-context-runtime.d.ts +0 -2
  373. package/dist/signals-drawer-runtime.d.ts +0 -2
  374. package/dist/signals-host-runtime.d.ts +0 -9
  375. package/dist/signals-loop-conditional-runtime.d.ts +0 -2
  376. package/dist/signals-manifest-hydration-runtime.d.ts +0 -2
  377. package/dist/signals-notify-runtime.d.ts +0 -2
  378. package/dist/signals-optimistic-runtime.d.ts +0 -2
  379. package/dist/signals-overlay-runtime.d.ts +0 -2
  380. package/dist/signals-scope-disposal-runtime.d.ts +0 -2
  381. package/dist/signals-spa-load-control-runtime.d.ts +0 -2
  382. package/dist/signals-storage-runtime.d.ts +0 -2
@@ -1,86 +1,5 @@
1
- /**
2
- * Role-named colours, so a component can say what a colour is FOR.
3
- *
4
- * `@stacksjs/components` named palette shades directly — `bg-gray-100`,
5
- * `text-gray-600`, `ring-indigo-600` — with a `dark:` variant beside each. That
6
- * renders correctly and is impossible for a host app to redirect by meaning: you
7
- * can remap `gray`, but you cannot say "every border in the library comes from
8
- * `--stx-line`", because nothing distinguishes a gray that is a border from a
9
- * gray that is muted text (stacksjs/stx#1930).
10
- *
11
- * These tokens are added to the BASE theme rather than shipped as an opt-in
12
- * preset. That matters for one reason: a component that says `text-fg-muted`
13
- * must resolve in every app, or adopting the component library would silently
14
- * require a config change and render unstyled without it. Adding names is purely
15
- * additive — no existing utility changes, and no opacity modifier on an existing
16
- * palette colour turns into `color-mix()`.
17
- *
18
- * ## Where the values come from
19
- *
20
- * Each token names a shade in css's own palette rather than carrying a hex
21
- * value, and the light/dark pairs are the ones the component library already
22
- * used most — measured, not invented:
23
- *
24
- * text-gray-900 dark:text-gray-100 ×70 -> text-fg
25
- * text-gray-500 dark:text-gray-400 ×24 -> text-fg-soft
26
- * border-gray-200 dark:border-gray-700 ×21 -> border-line
27
- *
28
- * So migrating a component to a token is appearance-preserving wherever its
29
- * pairing was the dominant one, and the defaults stay in step with the palette
30
- * because they are resolved from it rather than copied.
31
- *
32
- * ## Why `neutral` and not `gray`
33
- *
34
- * The STEP each neutral role names was measured from the library; the FAMILY
35
- * is a house decision. `neutral` is achromatic (chroma 0 at every step) while
36
- * `gray` carries a blue tint (chroma 0.027–0.034 through the mid range), and
37
- * the two agree on lightness to within about 1% at every step. So the choice
38
- * is a pure saturation one and changes no contrast ratio.
39
- *
40
- * These were gray-backed, which left the library mixing both: 103 `neutral-*`
41
- * uses in components against gray-backed roles. Everything is `neutral` now -
42
- * the roles, and the 35 literal shades that could not move onto a role - so
43
- * there is one neutral in the library rather than two that differ only by a
44
- * tint nobody chose (stacksjs/stx#1993).
45
- *
46
- * Flipping this back is a one-line edit per role, and the rest of the
47
- * vocabulary is unaffected: the status hues are their own families.
48
- *
49
- * ## How dark mode works
50
- *
51
- * Each token resolves to `var(--stx-<name>, <light value>)`, and
52
- * {@link semanticTokenCSS} emits `:root` and `.dark` blocks that set the
53
- * variable. So `text-fg-muted` is one class that is correct in both modes, and
54
- * an app overrides a role by setting the variable — at runtime, with no rebuild.
55
- *
56
- * The fallback is deliberately the LIGHT value. If the variable block ever fails
57
- * to reach a page, light mode is still correct and dark mode falls back to the
58
- * light colour: degraded, but readable. The alternative — no fallback — would
59
- * render the token as an invalid colour and take the whole component's styling
60
- * with it.
61
- *
62
- * @module theme-tokens
63
- */
64
- /** A role, and the palette shades that back it in each mode. */
65
- export interface SemanticToken {
66
- /** Shade reference, e.g. `gray-900`. Resolved against the live palette. */
67
- light: string;
68
- dark: string;
69
- /** What the role means, for the generated docs and for anyone reading here. */
70
- description: string;
71
- }
72
- /**
73
- * The role vocabulary.
74
- *
75
- * Five text roles rather than the usual three because the library genuinely
76
- * distinguishes five: 900, 700, 600, 500 and 400 all appear as body-ish text
77
- * with different dark partners. Collapsing them here would have been a redesign
78
- * rather than a migration.
79
- */
80
- export declare const SEMANTIC_TOKENS: Record<string, SemanticToken>;
81
1
  /** The CSS custom property that backs a role. */
82
2
  export declare function tokenVariable(name: string): string;
83
- type Palette = Record<string, unknown>;
84
3
  /**
85
4
  * The palette entries to merge into `theme.colors`.
86
5
  *
@@ -102,28 +21,6 @@ export declare function semanticColors(palette: Palette): Record<string, string>
102
21
  export declare function semanticTokenCSS(palette: Palette): string;
103
22
  /** Every variable a role token reads, for documentation and tooling. */
104
23
  export declare function semanticTokenNames(): string[];
105
- /**
106
- * Shape roles — the radius a thing has because of what it IS.
107
- *
108
- * Colour was only half of what made the library unadoptable. An app whose
109
- * buttons are pills got `rounded-md`, and `className` is no escape hatch for a
110
- * radius for exactly the reason it was not one for a colour: `rounded-md` and
111
- * `rounded-full` are single-class selectors of equal specificity, so the winner
112
- * is whichever lands later in the generated stylesheet, which a call site
113
- * cannot control (stacksjs/stx#1993).
114
- *
115
- * Three roles, from what the library actually uses: `rounded-md` on controls
116
- * (54 uses), `rounded-lg` on panels (24), and `rounded-full` where something is
117
- * genuinely a pill (34, of which the circular ones - avatars, dots, spinners -
118
- * keep `rounded-full`, because a circle is not a theming decision).
119
- *
120
- * So `--stx-radius-control: 9999px` turns every button, input and select in the
121
- * library into a pill, and nothing else moves.
122
- */
123
- export declare const SHAPE_TOKENS: Record<string, {
124
- value: string;
125
- description: string;
126
- }>;
127
24
  /** The CSS custom property that backs a shape role. */
128
25
  export declare function shapeVariable(name: string): string;
129
26
  /**
@@ -144,6 +41,289 @@ export declare function shapeRadii(): Record<string, string>;
144
41
  export declare function shapeTokenCSS(): string;
145
42
  /** Every variable a shape role reads, for documentation and tooling. */
146
43
  export declare function shapeTokenNames(): string[];
44
+ /** The CSS custom property that backs a density role. */
45
+ export declare function densityVariable(name: string): string;
46
+ /**
47
+ * The `theme.spacing` entries to merge in.
48
+ *
49
+ * Same shape as {@link shapeRadii}: new names whose value is the variable with
50
+ * today's value as the fallback, so `px-control-x` is an ordinary utility and
51
+ * an app moves it by setting `--stx-control-px`.
52
+ */
53
+ export declare function densitySpacing(): Record<string, string>;
54
+ /**
55
+ * The `theme.fontSize` entries to merge in, in the engine's own
56
+ * `[size, { lineHeight }]` form so a `text-*` utility sets both.
57
+ */
58
+ export declare function densityFontSizes(): Record<string, [string, { lineHeight: string }]>;
59
+ /**
60
+ * The `:root` block for the density roles.
61
+ *
62
+ * No `.dark` counterpart, for the reason the shape roles have none: room does
63
+ * not change with the colour scheme.
64
+ */
65
+ export declare function densityTokenCSS(): string;
66
+ /** Every variable a density role reads, for documentation and tooling. */
67
+ export declare function densityTokenNames(): string[];
68
+ /**
69
+ * The role vocabulary.
70
+ *
71
+ * Five text roles rather than the usual three because the library genuinely
72
+ * distinguishes five: 900, 700, 600, 500 and 400 all appear as body-ish text
73
+ * with different dark partners. Collapsing them here would have been a redesign
74
+ * rather than a migration.
75
+ * @defaultValue
76
+ * ```ts
77
+ * {
78
+ * 'fg': { light: 'neutral-900', dark: 'neutral-100', description: 'Primary text' },
79
+ * 'fg-strong': {
80
+ * light: 'neutral-700',
81
+ * dark: 'neutral-300',
82
+ * description: 'Labels, secondary headings'
83
+ * },
84
+ * 'fg-muted': { light: 'neutral-600', dark: 'neutral-400', description: 'Supporting text' },
85
+ * 'fg-soft': { light: 'neutral-500', dark: 'neutral-400', description: 'De-emphasised text' },
86
+ * 'fg-subtle': {
87
+ * light: 'neutral-400',
88
+ * dark: 'neutral-500',
89
+ * description: 'Recessive, non-essential text'
90
+ * },
91
+ * 'surface': {
92
+ * light: 'neutral-50',
93
+ * dark: 'neutral-800',
94
+ * description: 'Page and panel background'
95
+ * },
96
+ * 'surface-raised': { light: 'neutral-100', dark: 'neutral-700', description: 'Cards, popovers' },
97
+ * 'surface-sunken': {
98
+ * light: 'neutral-200',
99
+ * dark: 'neutral-700',
100
+ * description: 'Wells, track backgrounds'
101
+ * },
102
+ * 'panel': {
103
+ * light: 'white',
104
+ * dark: 'neutral-800',
105
+ * description: 'Card, menu, dialog surface'
106
+ * },
107
+ * 'field': { light: 'white', dark: 'neutral-700', description: 'Form control surface' },
108
+ * 'page': {
109
+ * light: 'neutral-50',
110
+ * dark: 'neutral-900',
111
+ * description: 'Page background, behind panels'
112
+ * },
113
+ * 'content': {
114
+ * light: 'white',
115
+ * dark: 'neutral-900',
116
+ * description: 'Content area under a chrome header - a table or list body'
117
+ * },
118
+ * 'surface-hover': {
119
+ * light: 'neutral-100',
120
+ * dark: 'neutral-700',
121
+ * description: 'Row or item highlight on a page or panel'
122
+ * },
123
+ * 'surface-raised-hover': {
124
+ * light: 'neutral-200',
125
+ * dark: 'neutral-600',
126
+ * description: 'Raised surface, hovered'
127
+ * },
128
+ * 'surface-sunken-hover': {
129
+ * light: 'neutral-300',
130
+ * dark: 'neutral-600',
131
+ * description: 'Sunken surface, hovered'
132
+ * },
133
+ * 'field-hover': {
134
+ * light: 'neutral-50',
135
+ * dark: 'neutral-600',
136
+ * description: 'Form control surface, hovered'
137
+ * },
138
+ * 'link': { light: 'blue-500', dark: 'blue-400', description: 'Hyperlink' },
139
+ * 'link-hover': { light: 'blue-600', dark: 'blue-300', description: 'Hyperlink, hovered' },
140
+ * 'inverse': {
141
+ * light: 'neutral-900',
142
+ * dark: 'neutral-700',
143
+ * description: 'Tooltip bubble, inverted surface'
144
+ * },
145
+ * 'inverse-ink': { light: 'white', dark: 'white', description: 'Text on an inverted surface' },
146
+ * 'line': {
147
+ * light: 'neutral-200',
148
+ * dark: 'neutral-700',
149
+ * description: 'Default border, divider'
150
+ * },
151
+ * 'line-strong': {
152
+ * light: 'neutral-300',
153
+ * dark: 'neutral-600',
154
+ * description: 'Input border, focus ring track'
155
+ * },
156
+ * 'line-hover': {
157
+ * light: 'neutral-400',
158
+ * dark: 'neutral-500',
159
+ * description: 'Border of a hovered control'
160
+ * },
161
+ * 'accent': {
162
+ * light: 'blue-600',
163
+ * dark: 'blue-400',
164
+ * description: 'Primary action, selected state'
165
+ * },
166
+ * 'info': { light: 'cyan-600', dark: 'cyan-400', description: 'Informational emphasis' },
167
+ * 'danger': {
168
+ * light: 'red-600',
169
+ * dark: 'red-400',
170
+ * description: 'Errors, destructive actions'
171
+ * },
172
+ * 'success': { light: 'green-600', dark: 'green-400', description: 'Confirmation' },
173
+ * 'warning': { light: 'yellow-600', dark: 'yellow-400', description: 'Caution' },
174
+ * 'accent-solid': { light: 'blue-500', dark: 'blue-600', description: 'Primary button fill' },
175
+ * 'info-solid': { light: 'cyan-500', dark: 'cyan-600', description: 'Informational fill' },
176
+ * 'danger-solid': { light: 'red-500', dark: 'red-600', description: 'Destructive button fill' },
177
+ * 'success-solid': { light: 'green-500', dark: 'green-600', description: 'Confirmation fill' },
178
+ * 'warning-solid': { light: 'yellow-500', dark: 'yellow-600', description: 'Caution fill' },
179
+ * 'accent-solid-hover': {
180
+ * light: 'blue-600',
181
+ * dark: 'blue-700',
182
+ * description: 'Primary button fill, hovered'
183
+ * },
184
+ * 'info-solid-hover': {
185
+ * light: 'cyan-600',
186
+ * dark: 'cyan-700',
187
+ * description: 'Informational fill, hovered'
188
+ * },
189
+ * 'danger-solid-hover': { light: 'red-600', dark: 'red-700', description: 'Destructive fill, hovered' },
190
+ * 'success-solid-hover': {
191
+ * light: 'green-600',
192
+ * dark: 'green-700',
193
+ * description: 'Confirmation fill, hovered'
194
+ * },
195
+ * 'warning-solid-hover': {
196
+ * light: 'yellow-600',
197
+ * dark: 'yellow-700',
198
+ * description: 'Caution fill, hovered'
199
+ * },
200
+ * 'accent-ink': { light: 'white', dark: 'white', description: 'Text on a primary fill' },
201
+ * 'info-ink': {
202
+ * light: 'neutral-900',
203
+ * dark: 'neutral-900',
204
+ * description: 'Text on an informational fill'
205
+ * },
206
+ * 'danger-ink': { light: 'white', dark: 'white', description: 'Text on a destructive fill' },
207
+ * 'success-ink': {
208
+ * light: 'neutral-900',
209
+ * dark: 'neutral-900',
210
+ * description: 'Text on a confirmation fill'
211
+ * },
212
+ * 'warning-ink': {
213
+ * light: 'neutral-900',
214
+ * dark: 'neutral-900',
215
+ * description: 'Text on a caution fill'
216
+ * },
217
+ * 'accent-soft': { light: 'blue-100', dark: 'blue-900', description: 'Tinted primary fill' },
218
+ * 'accent-soft-ink': {
219
+ * light: 'blue-800',
220
+ * dark: 'blue-200',
221
+ * description: 'Text on a tinted primary fill'
222
+ * },
223
+ * 'info-soft': {
224
+ * light: 'cyan-100',
225
+ * dark: 'cyan-900',
226
+ * description: 'Tinted informational fill'
227
+ * },
228
+ * 'info-soft-ink': {
229
+ * light: 'cyan-800',
230
+ * dark: 'cyan-200',
231
+ * description: 'Text on a tinted informational fill'
232
+ * },
233
+ * 'danger-soft': { light: 'red-100', dark: 'red-900', description: 'Tinted destructive fill' },
234
+ * 'danger-soft-ink': {
235
+ * light: 'red-800',
236
+ * dark: 'red-200',
237
+ * description: 'Text on a tinted destructive fill'
238
+ * },
239
+ * 'success-soft': {
240
+ * light: 'green-100',
241
+ * dark: 'green-900',
242
+ * description: 'Tinted confirmation fill'
243
+ * },
244
+ * 'success-soft-ink': {
245
+ * light: 'green-800',
246
+ * dark: 'green-200',
247
+ * description: 'Text on a tinted confirmation fill'
248
+ * },
249
+ * 'warning-soft': { light: 'yellow-100', dark: 'yellow-900', description: 'Tinted caution fill' },
250
+ * 'warning-soft-ink': {
251
+ * light: 'yellow-800',
252
+ * dark: 'yellow-200',
253
+ * description: 'Text on a tinted caution fill'
254
+ * },
255
+ * 'secondary': { light: 'purple-600', dark: 'purple-400', description: 'Secondary emphasis' },
256
+ * 'secondary-solid': { light: 'purple-500', dark: 'purple-600', description: 'Secondary fill' },
257
+ * 'secondary-solid-hover': {
258
+ * light: 'purple-600',
259
+ * dark: 'purple-700',
260
+ * description: 'Secondary fill, hovered'
261
+ * },
262
+ * 'secondary-ink': { light: 'white', dark: 'white', description: 'Text on a secondary fill' },
263
+ * 'secondary-soft': {
264
+ * light: 'purple-100',
265
+ * dark: 'purple-900',
266
+ * description: 'Tinted secondary fill'
267
+ * },
268
+ * 'secondary-soft-ink': {
269
+ * light: 'purple-800',
270
+ * dark: 'purple-200',
271
+ * description: 'Text on a tinted secondary fill'
272
+ * },
273
+ * 'danger-fg': {
274
+ * light: 'red-900',
275
+ * dark: 'red-300',
276
+ * description: 'Text in a field with an error'
277
+ * },
278
+ * 'danger-fg-subtle': {
279
+ * light: 'red-300',
280
+ * dark: 'red-500',
281
+ * description: 'Recessive text in a field with an error'
282
+ * },
283
+ * 'danger-line': {
284
+ * light: 'red-300',
285
+ * dark: 'red-600',
286
+ * description: 'Border of a field with an error'
287
+ * },
288
+ * 'danger-focus': {
289
+ * light: 'red-500',
290
+ * dark: 'red-400',
291
+ * description: 'Focus ring of a field with an error'
292
+ * }
293
+ * }
294
+ * ```
295
+ */
296
+ export declare const SEMANTIC_TOKENS: Record<string, SemanticToken>;
297
+ /**
298
+ * Shape roles — the radius a thing has because of what it IS.
299
+ *
300
+ * Colour was only half of what made the library unadoptable. An app whose
301
+ * buttons are pills got `rounded-md`, and `className` is no escape hatch for a
302
+ * radius for exactly the reason it was not one for a colour: `rounded-md` and
303
+ * `rounded-full` are single-class selectors of equal specificity, so the winner
304
+ * is whichever lands later in the generated stylesheet, which a call site
305
+ * cannot control (stacksjs/stx#1993).
306
+ *
307
+ * Three roles, from what the library actually uses: `rounded-md` on controls
308
+ * (54 uses), `rounded-lg` on panels (24), and `rounded-full` where something is
309
+ * genuinely a pill (34, of which the circular ones - avatars, dots, spinners -
310
+ * keep `rounded-full`, because a circle is not a theming decision).
311
+ *
312
+ * So `--stx-radius-control: 9999px` turns every button, input and select in the
313
+ * library into a pill, and nothing else moves.
314
+ * @defaultValue
315
+ * ```ts
316
+ * {
317
+ * control: { value: '0.375rem', description: 'Buttons, inputs, selects — rounded-md' },
318
+ * panel: { value: '0.5rem', description: 'Cards, dialogs, menus — rounded-lg' },
319
+ * pill: {
320
+ * value: '9999px',
321
+ * description: 'Chips and badges, which are pill-shaped by intent'
322
+ * }
323
+ * }
324
+ * ```
325
+ */
326
+ export declare const SHAPE_TOKENS: Record<string, { value: string, description: string }>;
147
327
  /**
148
328
  * Density roles — how much room a control or a table cell takes.
149
329
  *
@@ -179,16 +359,42 @@ export declare function shapeTokenNames(): string[];
179
359
  * second inline token to decide except misalignment. The block padding and
180
360
  * the type do differ — a header row is `py-3 text-xs`, a body row
181
361
  * `py-4 text-sm` — so those have a header token each.
362
+ * @defaultValue
363
+ * ```ts
364
+ * {
365
+ * 'control-px': { value: '1rem', description: 'Inline padding of a md text control — px-4' },
366
+ * 'control-py': { value: '0.5rem', description: 'Block padding of a md text control — py-2' },
367
+ * 'control-text': { value: '1rem', description: 'Font size of a md text control — text-base' },
368
+ * 'control-leading': { value: '1.5rem', description: 'Line height of a md text control — text-base' },
369
+ * 'cell-px': {
370
+ * value: '1.5rem',
371
+ * description: 'Inline padding of every table cell, header or body — px-6'
372
+ * },
373
+ * 'cell-py': { value: '1rem', description: 'Block padding of a body cell — py-4' },
374
+ * 'cell-text': { value: '0.875rem', description: 'Font size of a body cell — text-sm' },
375
+ * 'cell-leading': { value: '1.25rem', description: 'Line height of a body cell — text-sm' },
376
+ * 'cell-head-py': { value: '0.75rem', description: 'Block padding of a header cell — py-3' },
377
+ * 'cell-head-text': { value: '0.75rem', description: 'Font size of a header cell — text-xs' },
378
+ * 'cell-head-leading': { value: '1rem', description: 'Line height of a header cell — text-xs' }
379
+ * }
380
+ * ```
182
381
  */
183
- export declare const DENSITY_TOKENS: Record<string, {
184
- value: string;
185
- description: string;
186
- }>;
382
+ export declare const DENSITY_TOKENS: Record<string, { value: string, description: string }>;
187
383
  /**
188
384
  * The `theme.spacing` names, each backed by one density token.
189
385
  *
190
386
  * `px-control-x`, `py-control-y`, `px-cell-x`, `py-cell-y`, `py-cell-head-y` —
191
387
  * and, because they are ordinary spacing, `pl-control-x` and the rest too.
388
+ * @defaultValue
389
+ * ```ts
390
+ * {
391
+ * 'control-x': 'control-px',
392
+ * 'control-y': 'control-py',
393
+ * 'cell-x': 'cell-px',
394
+ * 'cell-y': 'cell-py',
395
+ * 'cell-head-y': 'cell-head-py'
396
+ * }
397
+ * ```
192
398
  */
193
399
  export declare const DENSITY_SPACING: Record<string, string>;
194
400
  /**
@@ -196,35 +402,83 @@ export declare const DENSITY_SPACING: Record<string, string>;
196
402
  *
197
403
  * `text-control`, `text-cell`, `text-cell-head`. A fontSize entry and not a
198
404
  * colour, so `text-control` sets the type and leaves the colour to `text-fg`.
405
+ * @defaultValue
406
+ * ```ts
407
+ * {
408
+ * 'control': { size: 'control-text', leading: 'control-leading' },
409
+ * 'cell': { size: 'cell-text', leading: 'cell-leading' },
410
+ * 'cell-head': { size: 'cell-head-text', leading: 'cell-head-leading' }
411
+ * }
412
+ * ```
199
413
  */
200
- export declare const DENSITY_FONT_SIZES: Record<string, {
201
- size: string;
202
- leading: string;
203
- }>;
204
- /** The CSS custom property that backs a density role. */
205
- export declare function densityVariable(name: string): string;
414
+ export declare const DENSITY_FONT_SIZES: Record<string, { size: string, leading: string }>;
206
415
  /**
207
- * The `theme.spacing` entries to merge in.
416
+ * Role-named colours, so a component can say what a colour is FOR.
208
417
  *
209
- * Same shape as {@link shapeRadii}: new names whose value is the variable with
210
- * today's value as the fallback, so `px-control-x` is an ordinary utility and
211
- * an app moves it by setting `--stx-control-px`.
212
- */
213
- export declare function densitySpacing(): Record<string, string>;
214
- /**
215
- * The `theme.fontSize` entries to merge in, in the engine's own
216
- * `[size, { lineHeight }]` form so a `text-*` utility sets both.
217
- */
218
- export declare function densityFontSizes(): Record<string, [string, {
219
- lineHeight: string;
220
- }]>;
221
- /**
222
- * The `:root` block for the density roles.
418
+ * `@stacksjs/components` named palette shades directly — `bg-gray-100`,
419
+ * `text-gray-600`, `ring-indigo-600` — with a `dark:` variant beside each. That
420
+ * renders correctly and is impossible for a host app to redirect by meaning: you
421
+ * can remap `gray`, but you cannot say "every border in the library comes from
422
+ * `--stx-line`", because nothing distinguishes a gray that is a border from a
423
+ * gray that is muted text (stacksjs/stx#1930).
223
424
  *
224
- * No `.dark` counterpart, for the reason the shape roles have none: room does
225
- * not change with the colour scheme.
425
+ * These tokens are added to the BASE theme rather than shipped as an opt-in
426
+ * preset. That matters for one reason: a component that says `text-fg-muted`
427
+ * must resolve in every app, or adopting the component library would silently
428
+ * require a config change and render unstyled without it. Adding names is purely
429
+ * additive — no existing utility changes, and no opacity modifier on an existing
430
+ * palette colour turns into `color-mix()`.
431
+ *
432
+ * ## Where the values come from
433
+ *
434
+ * Each token names a shade in css's own palette rather than carrying a hex
435
+ * value, and the light/dark pairs are the ones the component library already
436
+ * used most — measured, not invented:
437
+ *
438
+ * text-gray-900 dark:text-gray-100 ×70 -> text-fg
439
+ * text-gray-500 dark:text-gray-400 ×24 -> text-fg-soft
440
+ * border-gray-200 dark:border-gray-700 ×21 -> border-line
441
+ *
442
+ * So migrating a component to a token is appearance-preserving wherever its
443
+ * pairing was the dominant one, and the defaults stay in step with the palette
444
+ * because they are resolved from it rather than copied.
445
+ *
446
+ * ## Why `neutral` and not `gray`
447
+ *
448
+ * The STEP each neutral role names was measured from the library; the FAMILY
449
+ * is a house decision. `neutral` is achromatic (chroma 0 at every step) while
450
+ * `gray` carries a blue tint (chroma 0.027–0.034 through the mid range), and
451
+ * the two agree on lightness to within about 1% at every step. So the choice
452
+ * is a pure saturation one and changes no contrast ratio.
453
+ *
454
+ * These were gray-backed, which left the library mixing both: 103 `neutral-*`
455
+ * uses in components against gray-backed roles. Everything is `neutral` now -
456
+ * the roles, and the 35 literal shades that could not move onto a role - so
457
+ * there is one neutral in the library rather than two that differ only by a
458
+ * tint nobody chose (stacksjs/stx#1993).
459
+ *
460
+ * Flipping this back is a one-line edit per role, and the rest of the
461
+ * vocabulary is unaffected: the status hues are their own families.
462
+ *
463
+ * ## How dark mode works
464
+ *
465
+ * Each token resolves to `var(--stx-<name>, <light value>)`, and
466
+ * {@link semanticTokenCSS} emits `:root` and `.dark` blocks that set the
467
+ * variable. So `text-fg-muted` is one class that is correct in both modes, and
468
+ * an app overrides a role by setting the variable — at runtime, with no rebuild.
469
+ *
470
+ * The fallback is deliberately the LIGHT value. If the variable block ever fails
471
+ * to reach a page, light mode is still correct and dark mode falls back to the
472
+ * light colour: degraded, but readable. The alternative — no fallback — would
473
+ * render the token as an invalid colour and take the whole component's styling
474
+ * with it.
475
+ *
476
+ * @module theme-tokens
226
477
  */
227
- export declare function densityTokenCSS(): string;
228
- /** Every variable a density role reads, for documentation and tooling. */
229
- export declare function densityTokenNames(): string[];
230
- export {};
478
+ /** A role, and the palette shades that back it in each mode. */
479
+ export declare interface SemanticToken {
480
+ light: string
481
+ dark: string
482
+ description: string
483
+ }
484
+ declare type Palette = Record<string, unknown>;
@@ -1,69 +1,3 @@
1
- /**
2
- * STX Transitions
3
- *
4
- * Vue-inspired transition system for enter/leave animations.
5
- * Supports CSS transitions, CSS animations, and JavaScript hooks.
6
- *
7
- * @module transitions
8
- *
9
- * @example
10
- * ```html
11
- * @transition(name: 'fade')
12
- * @if (visible)
13
- * <div class="modal">Content</div>
14
- * @endif
15
- * @endtransition
16
- * ```
17
- *
18
- * CSS classes applied:
19
- * - `.fade-enter-from` - Starting state for enter
20
- * - `.fade-enter-active` - Active state during enter
21
- * - `.fade-enter-to` - Ending state for enter
22
- * - `.fade-leave-from` - Starting state for leave
23
- * - `.fade-leave-active` - Active state during leave
24
- * - `.fade-leave-to` - Ending state for leave
25
- */
26
- export interface TransitionOptions {
27
- /** Transition name (used for CSS class prefix) */
28
- name?: string;
29
- /** Duration in milliseconds */
30
- duration?: number | {
31
- enter: number;
32
- leave: number;
33
- };
34
- /** CSS transition timing function */
35
- easing?: string;
36
- /** Transition mode: 'in-out' or 'out-in' */
37
- mode?: 'in-out' | 'out-in' | 'default';
38
- /** Use CSS animations instead of transitions */
39
- css?: boolean;
40
- /** Custom enter class */
41
- enterClass?: string;
42
- /** Custom enter-active class */
43
- enterActiveClass?: string;
44
- /** Custom enter-to class */
45
- enterToClass?: string;
46
- /** Custom leave class */
47
- leaveClass?: string;
48
- /** Custom leave-active class */
49
- leaveActiveClass?: string;
50
- /** Custom leave-to class */
51
- leaveToClass?: string;
52
- /** JavaScript hooks */
53
- onBeforeEnter?: (el: Element) => void;
54
- onEnter?: (el: Element, done: () => void) => void;
55
- onAfterEnter?: (el: Element) => void;
56
- onEnterCancelled?: (el: Element) => void;
57
- onBeforeLeave?: (el: Element) => void;
58
- onLeave?: (el: Element, done: () => void) => void;
59
- onAfterLeave?: (el: Element) => void;
60
- onLeaveCancelled?: (el: Element) => void;
61
- }
62
- export interface TransitionState {
63
- isEntering: boolean;
64
- isLeaving: boolean;
65
- isCancelled: boolean;
66
- }
67
1
  /**
68
2
  * Perform an enter transition on an element.
69
3
  */
@@ -97,3 +31,58 @@ export declare function generateTransitionRuntime(): string;
97
31
  * <div @transition.slide-up.300="isOpen">Content</div>
98
32
  */
99
33
  export declare function processTransitionAttributes(template: string): string;
34
+ /* eslint-disable prefer-const, style/max-statements-per-line, no-super-linear-backtracking, regexp/no-unused-capturing-group */
35
+ /**
36
+ * STX Transitions
37
+ *
38
+ * Vue-inspired transition system for enter/leave animations.
39
+ * Supports CSS transitions, CSS animations, and JavaScript hooks.
40
+ *
41
+ * @module transitions
42
+ *
43
+ * @example
44
+ * ```html
45
+ * @transition(name: 'fade')
46
+ * @if (visible)
47
+ * <div class="modal">Content</div>
48
+ * @endif
49
+ * @endtransition
50
+ * ```
51
+ *
52
+ * CSS classes applied:
53
+ * - `.fade-enter-from` - Starting state for enter
54
+ * - `.fade-enter-active` - Active state during enter
55
+ * - `.fade-enter-to` - Ending state for enter
56
+ * - `.fade-leave-from` - Starting state for leave
57
+ * - `.fade-leave-active` - Active state during leave
58
+ * - `.fade-leave-to` - Ending state for leave
59
+ */
60
+ // =============================================================================
61
+ // Types
62
+ // =============================================================================
63
+ export declare interface TransitionOptions {
64
+ name?: string
65
+ duration?: number | { enter: number; leave: number }
66
+ easing?: string
67
+ mode?: 'in-out' | 'out-in' | 'default'
68
+ css?: boolean
69
+ enterClass?: string
70
+ enterActiveClass?: string
71
+ enterToClass?: string
72
+ leaveClass?: string
73
+ leaveActiveClass?: string
74
+ leaveToClass?: string
75
+ onBeforeEnter?: (el: Element) => void
76
+ onEnter?: (el: Element, done: () => void) => void
77
+ onAfterEnter?: (el: Element) => void
78
+ onEnterCancelled?: (el: Element) => void
79
+ onBeforeLeave?: (el: Element) => void
80
+ onLeave?: (el: Element, done: () => void) => void
81
+ onAfterLeave?: (el: Element) => void
82
+ onLeaveCancelled?: (el: Element) => void
83
+ }
84
+ export declare interface TransitionState {
85
+ isEntering: boolean
86
+ isLeaving: boolean
87
+ isCancelled: boolean
88
+ }